The preview command is read-only. It renders the manifest dependency graph, per-flow/per-artifact intent diagrams, an ATF/catalog intent summary, and a complexity report, then writes them all under .sn-preview/<manifest>/ with a README index. No network calls, no instance mutation — safe to run in CI and safe to share as a review artifact.
preview
Emit the human-review artifact bundle — manifest graph, per-flow intent, README.
sn preview <manifest.ts> [--out <dir>] [--open] [--json] [--no-preflight] [--threshold <n>] [--force-gate] Emit a reviewable artifact bundle for a manifest.
Arguments
| Name | Required | Description |
|---|---|---|
| manifest.ts | Yes | Path to the manifest. |
Flags
| Flag | Default | Description |
|---|---|---|
| --out <dir> | <manifest-dir>/.sn-preview/<basename> | Output directory. |
| --open | — | Open the generated README via `open` after writing. |
| --json | — | Print `{outDir, report, artifacts, preflightErrors}` and skip the human summary. |
| --no-preflight | — | Skip the static preflight pass that would otherwise annotate the README with errors. |
| --threshold <n> | — | Override the complexity threshold. Non-numeric values exit 1. |
| --force-gate | — | Force the decision to `gate` regardless of score — useful when CI should always require human review. |
Examples
sn preview manifests/payroll/manifest.ts --open✓ Preview written to manifests/payroll/.sn-preview/manifest
Complexity: 12 / 20 — ✓ ARTIFACT
Artifacts: 2 flow intents, 1 ATF artifact, 1 catalog intent
Index: manifests/payroll/.sn-preview/manifest/README.md
Preview is what sn execute gates on in TTY mode. If the complexity score tips over the threshold, execute refuses to proceed without --yes — preview shows the user why.