Execute & Reconcile

Run, validate, detect drift, query state

sn execute in v0.6 is the v0.5 runner wrapped in two new gates — preflight (validation) and preview (complexity + human review). In TTY mode both are default-on so you can't ship a half-checked manifest. --ci or a non-TTY context turns them off for deterministic automation; --yes explicitly accepts the preview gate without TTY interaction. Everything downstream — validate, drift, state — reads from the execute snapshot, so the loop never leaves your local .sn-*/ directories unless you ask it to.

What happened	Where to look
Step succeeded / failed	`.sn-results/<manifest>.json` (run snapshot)
Complexity score + report	`.sn-preview/<manifest>/README.md`
Offline reference data	`.sn-pulls/<manifest>.pull.json`
Drift overlay (accept decisions)	`.sn-pulls/<manifest>.overlay.json`
Fleet ownership index	`sn state list` (reads `.sn-customizations/`)
Execution history (append-only)	`sn state log` (reads `.sn-executions/`)

sn state archive --before 2026-03 rotates old execution log partitions into .sn-archive/. Good hygiene at the end of every quarter.

Tasks

Run the manifest. Preflight and preview gates run automatically in a real TTY.

sn execute manifests/example-business-rule/manifest.ts

▸ Preflight: ✓ 2 step(s) validated

▸ Preview: ✓ Complexity 4 / 20 — ARTIFACT (auto-approved)

Executing manifest: 2 steps

Scope: global (global)

Update set: [DEMO] Example Business Rule (911cc74a83500b10d3cfe5d0deaad373)

✓ br_create (business-rule.create) → 651cc74a83500b10d3cfe5d0deaad3b9

✓ br_update (business-rule.update) → 651cc74a83500b10d3cfe5d0deaad3b9

✓ All steps succeeded

Validate the result and emit a reality diagram.

sn validate manifests/example-business-rule/manifest.ts

Skill validation:

✓ business-rule: 0 issues

Update set validation:

1/1 records tracked in update set

child 1/1 [DEMO] Example Business Rule

Reality:

0 flows captured · 0 show diffs

All validations passed.

Check for drift against last execute's snapshot.

sn drift manifests/example-business-rule/manifest.ts

Summary: 0 drifted, 0 deleted, 0 unchanged, 1 untracked, 0 skipped

✓ No drift

Query the fleet-level ownership index for your new record.

sn state list --manifest manifests/example-business-rule

Track Complete!

You've finished all levels in Pre-Execute Pipeline.

← Back to home