diff --git a/docs/project-configuration.md b/docs/project-configuration.md index 7db58f06cc..d614334f5b 100644 --- a/docs/project-configuration.md +++ b/docs/project-configuration.md @@ -419,6 +419,17 @@ values, insert defaults, or discard unknown wrapper keys. Completion inside existing checks. CLI `scan --schema --json` and result artifact schemas remain separate contracts. +### Deep Scan sandbox qualification + +The CLI dry run and SDK `preflight()` are configuration checks, not sandbox +qualification. They do not start a Deep Scan worker or execute a command under +its generated permissions, so they cannot establish that the worker enforces +filesystem, credential-store, or network restrictions. The documented CLI and +SDK preflight surfaces do not export that generated policy or run a synthetic +command under it. Do not use either preflight result as evidence of worker +isolation. See the [security policy](../SECURITY.md) for the limits of read-only +worker execution and inherited tools. + ## Saved reruns New recipes retain resolved native configuration, scope, auth choice, finding diff --git a/sdk/typescript/docs/sdk.md b/sdk/typescript/docs/sdk.md index f41aec97e8..43e8fe790a 100644 --- a/sdk/typescript/docs/sdk.md +++ b/sdk/typescript/docs/sdk.md @@ -308,6 +308,10 @@ console.log(plan); `preflight()` checks local inputs without starting Codex or using the network. The returned `stateDirectory` identifies the checked storage root, including when the final scan directory will be allocated automatically. It does not verify credentials, model access, Python, or the plugin. The CLI equivalent is `scan --dry-run`. +Neither preflight starts a Deep Scan worker or executes a command under its +generated permissions, so neither qualifies the worker sandbox. See [Deep Scan +sandbox qualification](../../../docs/project-configuration.md#deep-scan-sandbox-qualification) +for the boundary and the limits of what these checks establish. ### Set investigation time