sneakoscope 0.9.15 → 0.9.17

package/README.md

@@ -2,11 +2,22 @@
 
 Fast legacy-free proof-first Codex trust layer with image-based Voxel TriWiki.
 
-Sneakoscope Codex (`sks`) is a Codex CLI/App harness that makes repeatable Codex work auditable. `0.9.15` runs through split command modules, automatically seals serious routes with Completion Proof, binds visual/UI claims to Image Voxel TriWiki anchors and relations, and release-gates hooks, codex-lb, executable fixtures, Rust parity, and DB safety evidence.
+Sneakoscope Codex (`sks`) is a Codex CLI/App harness that makes repeatable Codex work auditable. `0.9.17` removes the old route command monolith, adds a read-only five-scout intake before serious route implementation, automatically seals serious route fixture paths with Completion Proof, binds visual/UI claims to Image Voxel TriWiki anchors and relations, and release-gates real command fixtures, route modularity, Rust fallback parity, and DB safety evidence.
 
-## 0.9.15 Current Release
+![Sneakoscope Codex architecture and pipeline](https://raw.githubusercontent.com/mandarange/Sneakoscope-Codex/dev/docs/assets/sneakoscope-architecture-pipeline.jpg)
 
-`0.9.15` preserves the 0.9.14 legacy-free trust layer and fixes global npm postinstall auto-bootstrap.
+## 0.9.17 Current Release
+
+`0.9.17` completes the route modularity cleanup that started in 0.9.14. `src/core/commands/route-cli.mjs` is gone; every serious route now owns a focused command module, and release checks fail if the monolith returns or if command modules drift past their budget.
+
+Highlights:
+
+- Serious route mock/fixture commands call `maybeFinalizeRoute`, so Team, QA-LOOP, Research, PPT, Image UX Review, Computer Use, DB, Wiki, and GX fixtures produce route-local `completion-proof.json` without a separate repair/finalize step.
+- Serious routes run or validate five read-only scouts for code surface, verification, safety/DB, visual/Voxel evidence, and simplification/integration before proof is written.
+- E2E route tests run actual route commands such as `sks team fixture --mock --json`, `sks qa-loop run <mission> --mock --json`, and `sks wiki image-ingest ... --json`.
+- Feature fixtures execute deterministic allowlisted commands and validate artifacts generated by those commands, including mission-local proof, visual ledgers, DB reports, and GX/Wiki evidence.
+- `sks rust status|smoke --json` reports optional Rust availability, detects stale native binaries, and proves JS fallback parity when native Rust is missing or version-mismatched.
+- `npm run release:check` includes `route-modularity:check`, `command-budget:check`, and `feature-fixtures:strict`.
 
 `0.9.14` turned SKS into a legacy-free proof-first trust layer for Codex work:
 
@@ -21,7 +32,11 @@ Sneakoscope Codex (`sks`) is a Codex CLI/App harness that makes repeatable Codex
 
 Learn more:
 - Completion Proof: [docs/completion-proof.md](docs/completion-proof.md)
+- Five-Scout Pipeline: [docs/five-scout-pipeline.md](docs/five-scout-pipeline.md)
 - Image Voxel TriWiki: [docs/image-voxel-ledger.md](docs/image-voxel-ledger.md)
+- Route finalization: [docs/route-finalization.md](docs/route-finalization.md)
+- Feature fixtures: [docs/feature-fixtures.md](docs/feature-fixtures.md)
+- Rust accelerator: [docs/rust-accelerator.md](docs/rust-accelerator.md)
 - Codex App Hooks/PAT: [docs/hooks-pat.md](docs/hooks-pat.md)
 - codex-lb: [docs/codex-lb.md](docs/codex-lb.md)
 
@@ -33,13 +48,14 @@ sks root
 sks doctor
 sks codex-app check
 sks selftest --mock
+sks rust smoke --json
 ```
 
 ## Three core promises
 
 1. Completion Proof for every serious route
 2. Image Voxel TriWiki anchors and relations for every visual route
-3. Codex App, codex-lb, hooks, Rust, DB, and fixtures verified by release gates
+3. Codex App, codex-lb, hooks, Rust fallback parity, DB, route modularity, and generated fixtures verified by release gates
 
 ## Install Options
 

package/crates/sks-core/Cargo.lock

@@ -76,7 +76,7 @@ dependencies = [
 
 [[package]]
 name = "sks-core"
-version = "0.9.15"
+version = "0.9.17"
 dependencies = [
  "serde_json",
 ]

package/crates/sks-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "sks-core"
-version = "0.9.15"
+version = "0.9.17"
 edition = "2021"
 
 [dependencies]

package/crates/sks-core/src/main.rs

@@ -4,7 +4,7 @@ use std::io::{self, Read, Seek, SeekFrom};
 fn main() {
     let mut args = std::env::args().skip(1);
     match args.next().as_deref() {
-        Some("--version") => println!("sks-rs 0.9.15"),
+        Some("--version") => println!("sks-rs 0.9.17"),
         Some("compact-info") => {
             let mut input = String::new();
             let _ = io::stdin().read_to_string(&mut input);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sneakoscope",
   "displayName": "ㅅㅋㅅ",
-  "version": "0.9.15",
+  "version": "0.9.17",
   "description": "Sneakoscope Codex: fast proof-first Codex trust layer with image-based Voxel TriWiki.",
   "type": "module",
   "homepage": "https://github.com/mandarange/Sneakoscope-Codex#readme",
@@ -41,11 +41,16 @@
     "changelog:check": "node ./scripts/changelog-check.mjs",
     "cli-entrypoint:check": "node ./scripts/check-cli-entrypoint.mjs",
     "legacy-free:check": "node ./scripts/check-legacy-free.mjs",
+    "route-modularity:check": "node ./scripts/check-route-modularity.mjs",
+    "command-budget:check": "node ./scripts/check-command-module-budget.mjs",
     "sizecheck": "node ./scripts/sizecheck.mjs",
     "registry:check": "node ./scripts/release-registry-check.mjs",
     "feature:check": "node ./bin/sks.mjs features check --json",
     "all-features:selftest": "node ./bin/sks.mjs all-features selftest --mock --json",
     "all-features:execute-fixtures": "node ./bin/sks.mjs all-features selftest --mock --execute-fixtures --strict-artifacts --json",
+    "feature-fixtures:strict": "node ./bin/sks.mjs all-features selftest --mock --execute-fixtures --strict-artifacts --json",
+    "scouts:selftest": "node ./bin/sks.mjs scouts run latest --mock --json",
+    "scouts:check": "node ./bin/sks.mjs scouts validate latest --json",
     "perf:cold-start": "node ./bin/sks.mjs perf cold-start --json",
     "perf:gate": "node ./scripts/perf-gate.mjs",
     "test": "node --test \"test/**/*.test.mjs\"",
@@ -55,7 +60,7 @@
     "rust:check": "cargo check --manifest-path crates/sks-core/Cargo.toml",
     "rust:smoke": "node ./scripts/rust-smoke.mjs",
     "coverage": "node --experimental-test-coverage --test \"test/**/*.test.mjs\"",
-    "release:check": "npm run repo-audit && npm run changelog:check && npm run cli-entrypoint:check && npm run legacy-free:check && npm run packcheck && npm run feature:check && npm run all-features:selftest && npm run all-features:execute-fixtures && npm run selftest && npm run test:unit && npm run test:integration:mock && npm run test:e2e:mock && npm run rust:check && npm run rust:smoke && npm run perf:gate && npm run sizecheck && npm run registry:check",
+    "release:check": "npm run repo-audit && npm run changelog:check && npm run cli-entrypoint:check && npm run legacy-free:check && npm run packcheck && npm run route-modularity:check && npm run command-budget:check && npm run feature:check && npm run all-features:selftest && npm run scouts:selftest && npm run scouts:check && npm run feature-fixtures:strict && npm run selftest && npm run test:unit && npm run test:integration:mock && npm run test:e2e:mock && npm run rust:check && npm run rust:smoke && npm run perf:gate && npm run sizecheck && npm run registry:check",
     "publish:dry": "npm run release:check && npm --cache /tmp/sks-npm-cache publish --dry-run --registry https://registry.npmjs.org/ --access public",
     "publish:npm": "npm --cache /tmp/sks-npm-cache publish --registry https://registry.npmjs.org/ --access public",
     "prepublishOnly": "npm run release:check && node ./scripts/release-registry-check.mjs --require-unpublished"

package/src/cli/command-registry.mjs

@@ -44,6 +44,8 @@ export const COMMANDS = {
   context7: { maturity: 'beta', summary: 'Context7 checks and docs', lazy: () => import('../commands/context7.mjs') },
   recallpulse: { maturity: 'labs', summary: 'RecallPulse evidence route', lazy: () => import('../commands/recallpulse.mjs') },
   pipeline: { maturity: 'beta', summary: 'Inspect pipeline missions', lazy: () => import('../commands/pipeline.mjs') },
+  scouts: { maturity: 'beta', summary: 'Run the default read-only 5-scout intake phase', lazy: () => import('../commands/scouts.mjs') },
+  scout: { maturity: 'beta', summary: 'Alias for scouts', lazy: () => import('../commands/scouts.mjs') },
   guard: { maturity: 'beta', summary: 'Check harness guard', lazy: () => import('../commands/guard.mjs') },
   conflicts: { maturity: 'beta', summary: 'Check harness conflicts', lazy: () => import('../commands/conflicts.mjs') },
   versioning: { maturity: 'stable', summary: 'Manage release version metadata', lazy: () => import('../commands/versioning.mjs') },
@@ -59,6 +61,7 @@ export const COMMANDS = {
   'proof-field': { maturity: 'beta', summary: 'Scan proof field', lazy: () => import('../commands/proof-field.mjs') },
   'skill-dream': { maturity: 'labs', summary: 'Track skill dream counters', lazy: () => import('../commands/skill-dream.mjs') },
   'code-structure': { maturity: 'labs', summary: 'Scan source structure', lazy: () => import('../commands/code-structure.mjs') },
+  rust: { maturity: 'beta', summary: 'Inspect optional Rust accelerator status and smoke parity', lazy: () => import('../commands/rust.mjs') },
   memory: { maturity: 'labs', summary: 'Run retention checks', lazy: () => import('../commands/memory.mjs') },
   gx: { maturity: 'labs', summary: 'Render/validate GX cartridges', lazy: () => import('../commands/gx.mjs') },
   db: { maturity: 'beta', summary: 'Inspect DB safety policy', lazy: () => import('../commands/db.mjs') },

package/src/cli/install-helpers.mjs

@@ -2349,7 +2349,7 @@ export async function selftestCodexLb(tmp) {
   if (!codexLbLaunch.includes('sks-codex-lb.env')) throw new Error('selftest: tmux launch command does not source codex-lb env file');
   if (!codexLbLaunch.includes("'--model' 'gpt-5.5'")) throw new Error('selftest: tmux launch command without args did not force GPT-5.5');
   if (!codexLbLaunch.includes('SKS_TMUX_LOGO_ANIMATION') || !codexLbLaunch.includes('SNEAKOSCOPE CODEX')) throw new Error('selftest: tmux launch command does not include the animated SKS logo intro');
-  const madLaunchSource = await safeReadText(path.join(packageRoot(), 'src', 'core', 'commands', 'route-cli.mjs'));
+  const madLaunchSource = await safeReadText(path.join(packageRoot(), 'src', 'core', 'commands', 'mad-sks-command.mjs'));
   if (!madLaunchSource.includes('const lb = await deps.maybePromptCodexLbSetupForLaunch(args)') || !madLaunchSource.includes("const launchLb = lb.status === 'present'") || !madLaunchSource.includes('codexLbImmediateLaunchOpts(cleanArgs, launchLb') || !madLaunchSource.includes('bypass_codex_lb') || !madLaunchSource.includes('model_provider="openai"') || !madLaunchSource.includes('codexLbFreshSession: true')) throw new Error('selftest: MAD launch does not sync codex-lb auth and fresh-session launch options');
 
 }

package/src/commands/autoresearch.mjs

@@ -1,5 +1,5 @@
-import { researchCommand } from '../core/commands/route-cli.mjs';
+import { autoresearchCommand } from '../core/commands/autoresearch-command.mjs';
 export async function run(_command, args = []) {
   const [sub = 'status', ...rest] = args;
-  return researchCommand(sub, rest);
+  return autoresearchCommand(sub, rest);
 }

package/src/commands/code-structure.mjs

@@ -1,4 +1,4 @@
-import { codeStructureCommand } from '../core/commands/route-cli.mjs';
+import { codeStructureCommand } from '../core/commands/code-structure-command.mjs';
 export async function run(_command, args = []) {
   const [sub = 'scan', ...rest] = args;
   return codeStructureCommand(sub, rest);

package/src/commands/computer-use.mjs

@@ -1,31 +1,5 @@
-import { projectRoot } from '../core/fsx.mjs';
-import { findLatestMission } from '../core/mission.mjs';
-import { flag } from '../cli/args.mjs';
-import { printJson } from '../cli/output.mjs';
-import { finalizeRouteWithProof } from '../core/proof/route-finalizer.mjs';
+import { computerUseCommand } from '../core/commands/computer-use-command.mjs';
 
 export async function run(command, args = []) {
-  const root = await projectRoot();
-  const missionArg = args.find((arg) => !String(arg).startsWith('--')) || 'latest';
-  const missionId = missionArg === 'latest' ? await findLatestMission(root) : missionArg;
-  if (!missionId) {
-    const result = { schema: 'sks.computer-use-evidence.v1', ok: false, status: 'missing_mission' };
-    if (flag(args, '--json')) return printJson(result);
-    console.error('No mission found.');
-    process.exitCode = 1;
-    return;
-  }
-  const route = command === 'cu' ? '$CU' : '$Computer-Use';
-  const proof = await finalizeRouteWithProof(root, {
-    missionId,
-    route,
-    mock: flag(args, '--mock'),
-    requireRelation: flag(args, '--fix-claim') || flag(args, '--require-relation'),
-    artifacts: ['computer-use-evidence-ledger.json', 'screen-capture-ledger.json', 'image-voxel-ledger.json', 'visual-anchors.json'],
-    claims: [{ id: 'computer-use-evidence', status: flag(args, '--mock') ? 'verified_partial' : 'supported' }]
-  });
-  const result = { schema: 'sks.computer-use-evidence.v1', ok: proof.ok, mission_id: missionId, route, proof: proof.validation };
-  if (flag(args, '--json')) return printJson(result);
-  console.log(`Computer Use evidence: ${proof.ok ? 'ok' : 'blocked'} ${missionId}`);
-  if (!proof.ok) process.exitCode = 1;
+  return computerUseCommand(command, args);
 }

package/src/commands/db.mjs

@@ -1,4 +1,4 @@
-import { dbCommand } from '../core/commands/route-cli.mjs';
+import { dbCommand } from '../core/commands/db-command.mjs';
 
 export async function run(_command, args = []) {
   const [sub = 'policy', ...rest] = args;

package/src/commands/doctor.mjs

@@ -5,11 +5,23 @@ import { getCodexInfo } from '../core/codex-adapter.mjs';
 import { rustInfo } from '../core/rust-accelerator.mjs';
 import { codexAppIntegrationStatus } from '../core/codex-app.mjs';
 import { codexLbMetrics, readCodexLbCircuit } from '../core/codex-lb-circuit.mjs';
+import { ensureGlobalCodexSkillsDuringInstall } from '../cli/install-helpers.mjs';
+import { normalizeInstallScope } from '../core/init.mjs';
 
 export async function run(_command, args = []) {
+  let repair = null;
   if (flag(args, '--fix')) {
     const { setupCommand } = await import('../core/commands/basic-cli.mjs');
-    await setupCommand(['--force', '--local-only']);
+    const installScope = installScopeFromArgs(args);
+    const setupArgs = ['--force', '--install-scope', installScope];
+    if (flag(args, '--local-only')) setupArgs.push('--local-only');
+    await setupCommand(setupArgs);
+    repair = {
+      install_scope: installScope,
+      global_skills: installScope === 'global' && !flag(args, '--local-only')
+        ? await ensureGlobalCodexSkillsDuringInstall({ force: true })
+        : { status: 'skipped', reason: 'project or local-only repair' }
+    };
   }
   const root = await projectRoot();
   const codex = await getCodexInfo().catch((err) => ({ available: false, error: err.message }));
@@ -27,7 +39,8 @@ export async function run(_command, args = []) {
     codex_app: codexApp,
     codex_lb: codexLb,
     sneakoscope: { ok: await exists(`${root}/.sneakoscope`) },
-    package: { bytes: pkgBytes, human: formatBytes(pkgBytes) }
+    package: { bytes: pkgBytes, human: formatBytes(pkgBytes) },
+    repair
   };
   if (flag(args, '--json')) {
     printJson(result);
@@ -38,9 +51,16 @@ export async function run(_command, args = []) {
   console.log(`Root:      ${root}`);
   console.log(`Node:      ${result.node.ok ? 'ok' : 'fail'} ${result.node.version}`);
   console.log(`Codex:     ${codex.bin ? 'ok' : 'missing'} ${codex.version || ''}`);
-  console.log(`Rust acc.: ${rust.available ? rust.version : 'optional-missing'}`);
+  console.log(`Rust acc.: ${rust.mode || (rust.available ? 'rust_accelerated' : 'js_fallback')} ${rust.version || rust.status || ''}`);
   console.log(`Codex App: ${codexApp.ok ? 'ok' : 'needs setup'}`);
   console.log(`codex-lb:  ${codexLb.ok ? 'ok' : `blocked ${codexLb.circuit?.state || 'unknown'}`}`);
   console.log(`Ready:     ${result.ok ? 'yes' : 'no'}`);
   if (!result.ok) process.exitCode = 1;
 }
+
+function installScopeFromArgs(args = []) {
+  if (flag(args, '--project')) return 'project';
+  if (flag(args, '--global')) return 'global';
+  const index = args.indexOf('--install-scope');
+  return normalizeInstallScope(index >= 0 && args[index + 1] ? args[index + 1] : 'global');
+}

package/src/commands/eval.mjs

@@ -1,4 +1,4 @@
-import { evalCommand } from '../core/commands/route-cli.mjs';
+import { evalCommand } from '../core/commands/eval-command.mjs';
 export async function run(_command, args = []) {
   const [sub = 'run', ...rest] = args;
   return evalCommand(sub, rest);

package/src/commands/gc.mjs

@@ -1,2 +1,2 @@
-import { gcCommand } from '../core/commands/route-cli.mjs';
+import { gcCommand } from '../core/commands/gc-command.mjs';
 export async function run(_command, args = []) { return gcCommand(args); }

package/src/commands/goal.mjs

@@ -1,4 +1,4 @@
-import { goalCommand } from '../core/commands/route-cli.mjs';
+import { goalCommand } from '../core/commands/goal-command.mjs';
 export async function run(_command, args = []) {
   const [sub, ...rest] = args;
   return goalCommand(sub, rest);

package/src/commands/gx.mjs

@@ -1,4 +1,4 @@
-import { gxCommand } from '../core/commands/route-cli.mjs';
+import { gxCommand } from '../core/commands/gx-command.mjs';
 export async function run(_command, args = []) {
   const [sub = 'validate', ...rest] = args;
   return gxCommand(sub, rest);

package/src/commands/harness.mjs

@@ -1,4 +1,4 @@
-import { harnessCommand } from '../core/commands/route-cli.mjs';
+import { harnessCommand } from '../core/commands/harness-command.mjs';
 export async function run(_command, args = []) {
   const [sub = 'fixture', ...rest] = args;
   return harnessCommand(sub, rest);

package/src/commands/hook.mjs

@@ -1,8 +1,6 @@
-import { hookMain } from '../core/hooks-runtime.mjs';
-import { printJson } from '../cli/output.mjs';
+import { emitHook } from '../core/hooks-runtime.mjs';
 
 export async function run(_command, args = []) {
   const [name = 'user-prompt-submit'] = args;
-  const result = await hookMain(name);
-  return printJson(result);
+  return emitHook(name);
 }

package/src/commands/hproof.mjs

@@ -1,4 +1,4 @@
-import { hproofCommand } from '../core/commands/route-cli.mjs';
+import { hproofCommand } from '../core/commands/hproof-command.mjs';
 export async function run(_command, args = []) {
   const [sub = 'check', ...rest] = args;
   return hproofCommand(sub, rest);

package/src/commands/image-ux-review.mjs

@@ -1,38 +1,5 @@
-import path from 'node:path';
-import { projectRoot, readJson } from '../core/fsx.mjs';
-import { findLatestMission, loadMission } from '../core/mission.mjs';
-import { flag } from '../cli/args.mjs';
-import { printJson } from '../cli/output.mjs';
-import { writeImageUxReviewRouteArtifacts } from '../core/image-ux-review.mjs';
-import { finalizeRouteWithProof } from '../core/proof/route-finalizer.mjs';
+import { imageUxReviewCommand } from '../core/commands/image-ux-review-command.mjs';
 
 export async function run(command, args = []) {
-  const root = await projectRoot();
-  const action = args[0] || 'status';
-  const missionArg = args[1] && !String(args[1]).startsWith('--') ? args[1] : 'latest';
-  const missionId = missionArg === 'latest' ? await findLatestMission(root) : missionArg;
-  if (!missionId) {
-    const result = { schema: 'sks.image-ux-review-status.v1', ok: false, status: 'missing_mission' };
-    if (flag(args, '--json')) return printJson(result);
-    console.error('No mission found.');
-    process.exitCode = 1;
-    return;
-  }
-  const { dir, mission } = await loadMission(root, missionId);
-  const contract = await readJson(path.join(dir, 'decision-contract.json'), { prompt: mission.prompt, answers: {}, sealed_hash: null });
-  if (action === 'build' || action === 'run' || (action === 'status' && flag(args, '--mock'))) {
-    const artifacts = await writeImageUxReviewRouteArtifacts(dir, contract);
-    const route = command === 'ux-review' ? '$UX-Review' : command === 'visual-review' ? '$Visual-Review' : command === 'ui-ux-review' ? '$UI-UX-Review' : '$Image-UX-Review';
-    const proof = await finalizeRouteWithProof(root, { missionId, route, mock: flag(args, '--mock'), artifacts: Object.keys(artifacts), claims: [{ id: 'image-ux-review-fixture', status: 'verified_partial' }] });
-    const result = { schema: 'sks.image-ux-review-build.v1', ok: proof.ok, mission_id: missionId, artifacts, proof: proof.validation };
-    if (flag(args, '--json')) return printJson(result);
-    console.log(`Image UX review: ${proof.ok ? 'ok' : 'blocked'} ${missionId}`);
-    if (!proof.ok) process.exitCode = 1;
-    return;
-  }
-  const gate = await readJson(path.join(dir, 'image-ux-review-gate.json'), null);
-  const result = { schema: 'sks.image-ux-review-status.v1', ok: true, mission_id: missionId, gate };
-  if (flag(args, '--json')) return printJson(result);
-  console.log(`Image UX Review mission: ${missionId}`);
-  console.log(`Gate: ${gate?.passed ? 'passed' : gate ? 'present' : 'missing'}`);
+  return imageUxReviewCommand(command, args);
 }

package/src/commands/mad-sks.mjs

@@ -1,4 +1,4 @@
-import { madHighCommand } from '../core/commands/route-cli.mjs';
+import { madHighCommand } from '../core/commands/mad-sks-command.mjs';
 import { maybePromptCodexUpdateForLaunch, maybePromptCodexLbSetupForLaunch } from '../cli/install-helpers.mjs';
 import { PACKAGE_VERSION } from '../core/fsx.mjs';
 

package/src/commands/memory.mjs

@@ -1,4 +1,4 @@
-import { memoryCommand } from '../core/commands/route-cli.mjs';
+import { memoryCommand } from '../core/commands/gc-command.mjs';
 export async function run(_command, args = []) {
   const [sub, ...rest] = args;
   return memoryCommand(sub, rest);

package/src/commands/perf.mjs

@@ -25,7 +25,7 @@ export async function run(_command, args = []) {
     if (!result.ok) process.exitCode = 1;
     return;
   }
-  const { perfCommand } = await import('../core/commands/route-cli.mjs');
+  const { perfCommand } = await import('../core/commands/perf-command.mjs');
   return perfCommand(action, args.slice(1));
 }
 

package/src/commands/pipeline.mjs

@@ -1,25 +1,5 @@
-import { projectRoot, readJson } from '../core/fsx.mjs';
-import { stateFile } from '../core/mission.mjs';
-import { flag } from '../cli/args.mjs';
-import { printJson } from '../cli/output.mjs';
-import { projectGateStatus } from '../core/pipeline.mjs';
+import { pipelineCommand } from '../core/commands/pipeline-command.mjs';
 
 export async function run(_command, args = []) {
-  const root = await projectRoot();
-  const action = args[0] || 'status';
-  const state = await readJson(stateFile(root), {});
-  if (action === 'status') {
-    const result = { schema: 'sks.pipeline-status.v1', ok: true, state };
-    if (flag(args, '--json')) return printJson(result);
-    console.log(`Pipeline: ${state.mission_id || 'none'} ${state.route_command || state.mode || ''}`.trim());
-    return;
-  }
-  if (action === 'plan') {
-    const result = await projectGateStatus(root, state);
-    if (flag(args, '--json')) return printJson(result);
-    console.log(`Pipeline gate: ${result.ok ? 'pass' : 'blocked'}`);
-    return;
-  }
-  console.error('Usage: sks pipeline status|plan [--json]');
-  process.exitCode = 1;
+  return pipelineCommand(args);
 }

package/src/commands/ppt.mjs

@@ -1,44 +1,5 @@
-import path from 'node:path';
-import { projectRoot, readJson, writeJsonAtomic } from '../core/fsx.mjs';
-import { findLatestMission, loadMission } from '../core/mission.mjs';
-import { flag } from '../cli/args.mjs';
-import { printJson } from '../cli/output.mjs';
-import { writePptBuildArtifacts, writePptRouteArtifacts } from '../core/ppt.mjs';
-import { finalizeRouteWithProof } from '../core/proof/route-finalizer.mjs';
+import { pptCommand } from '../core/commands/ppt-command.mjs';
 
-export async function run(_command, args = []) {
-  const root = await projectRoot();
-  const action = args[0] || 'status';
-  const missionArg = args[1] && !String(args[1]).startsWith('--') ? args[1] : 'latest';
-  const missionId = missionArg === 'latest' ? await findLatestMission(root) : missionArg;
-  if (!missionId) {
-    const result = { schema: 'sks.ppt-status.v1', ok: false, status: 'missing_mission' };
-    if (flag(args, '--json')) return printJson(result);
-    console.error('No mission found.');
-    process.exitCode = 1;
-    return;
-  }
-  const { dir, mission } = await loadMission(root, missionId);
-  const contract = await readJson(path.join(dir, 'decision-contract.json'), { prompt: mission.prompt, answers: {}, sealed_hash: null });
-  if (action === 'build') {
-    await writePptRouteArtifacts(dir, contract);
-    const build = await writePptBuildArtifacts(dir, contract);
-    const proof = await finalizeRouteWithProof(root, { missionId, route: '$PPT', mock: flag(args, '--mock'), artifacts: build.files || [], claims: [{ id: 'ppt-build-fixture', status: 'verified_partial' }] });
-    const result = { schema: 'sks.ppt-build.v1', ok: proof.ok, mission_id: missionId, build, proof: proof.validation };
-    if (flag(args, '--json')) return printJson(result);
-    console.log(`PPT build: ${proof.ok ? 'ok' : 'blocked'} ${missionId}`);
-    if (!proof.ok) process.exitCode = 1;
-    return;
-  }
-  if (action === 'status') {
-    const gate = await readJson(path.join(dir, 'ppt-gate.json'), null);
-    const result = { schema: 'sks.ppt-status.v1', ok: true, mission_id: missionId, gate };
-    if (flag(args, '--json')) return printJson(result);
-    console.log(`PPT mission: ${missionId}`);
-    console.log(`Gate: ${gate?.passed ? 'passed' : gate ? 'present' : 'missing'}`);
-    return;
-  }
-  await writeJsonAtomic(path.join(dir, 'ppt-command-error.json'), { action, args });
-  console.error('Usage: sks ppt build|status <mission-id|latest> [--json] [--mock]');
-  process.exitCode = 1;
+export async function run(command, args = []) {
+  return pptCommand(command, args);
 }

package/src/commands/profile.mjs

@@ -1,4 +1,4 @@
-import { profileCommand } from '../core/commands/route-cli.mjs';
+import { profileCommand } from '../core/commands/profile-command.mjs';
 export async function run(_command, args = []) {
   const [sub = 'show', ...rest] = args;
   return profileCommand(sub, rest);

package/src/commands/proof-field.mjs

@@ -1,4 +1,4 @@
-import { proofFieldCommand } from '../core/commands/route-cli.mjs';
+import { proofFieldCommand } from '../core/commands/proof-field-command.mjs';
 export async function run(_command, args = []) {
   const [sub = 'scan', ...rest] = args;
   return proofFieldCommand(sub, rest);

package/src/commands/qa-loop.mjs

@@ -1,4 +1,4 @@
-import { qaLoopCommand } from '../core/commands/route-cli.mjs';
+import { qaLoopCommand } from '../core/commands/qa-loop-command.mjs';
 export async function run(_command, args = []) {
   const [sub, ...rest] = args;
   return qaLoopCommand(sub, rest);

package/src/commands/recallpulse.mjs

@@ -1,5 +1,6 @@
-import { recallPulseCommand } from '../cli/recallpulse-command.mjs';
+import { recallpulseCommand } from '../core/commands/recallpulse-command.mjs';
+
 export async function run(_command, args = []) {
   const [sub = 'status', ...rest] = args;
-  return recallPulseCommand(sub, rest);
+  return recallpulseCommand(sub, rest);
 }

package/src/commands/research.mjs

@@ -1,4 +1,4 @@
-import { researchCommand } from '../core/commands/route-cli.mjs';
+import { researchCommand } from '../core/commands/research-command.mjs';
 export async function run(_command, args = []) {
   const [sub, ...rest] = args;
   return researchCommand(sub, rest);

package/src/commands/rust.mjs

@@ -0,0 +1,5 @@
+import { rustCommand } from '../core/commands/rust-command.mjs';
+
+export async function run(_command, args = []) {
+  return rustCommand(args);
+}

package/src/commands/scouts.mjs

@@ -0,0 +1,5 @@
+import { scoutsCommand } from '../core/commands/scouts-command.mjs';
+
+export async function run(_command, args = []) {
+  return scoutsCommand(args);
+}

package/src/commands/skill-dream.mjs

@@ -1,4 +1,4 @@
-import { skillDreamCommand } from '../core/commands/route-cli.mjs';
+import { skillDreamCommand } from '../core/commands/skill-dream-command.mjs';
 export async function run(_command, args = []) {
   const [sub = 'status', ...rest] = args;
   return skillDreamCommand(sub, rest);

package/src/commands/stats.mjs

@@ -1,2 +1,2 @@
-import { statsCommand } from '../core/commands/route-cli.mjs';
+import { statsCommand } from '../core/commands/gc-command.mjs';
 export async function run(_command, args = []) { return statsCommand(args); }

package/src/commands/team.mjs

@@ -1,2 +1,2 @@
-import { team } from '../core/commands/route-cli.mjs';
+import { team } from '../core/commands/team-command.mjs';
 export async function run(_command, args = []) { return team(args); }

package/src/commands/validate-artifacts.mjs

@@ -1,2 +1,2 @@
-import { validateArtifactsCommand } from '../core/commands/route-cli.mjs';
+import { validateArtifactsCommand } from '../core/commands/validate-artifacts-command.mjs';
 export async function run(_command, args = []) { return validateArtifactsCommand(args); }