sneakoscope 0.9.16 → 0.9.18

package/README.md

@@ -2,11 +2,24 @@
 
 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.16` 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.18` makes route execution hermetic and evidence-strict: Five-Scout intake can use real Codex/tmux engines when available, route E2E runs in temp project roots, feature fixtures no longer receive implicit static-pass fallback, and pipeline planning is exposed through split policy modules with a facade compatibility layer.
 
-## 0.9.16 Current Release
+![Sneakoscope Codex architecture and pipeline](https://raw.githubusercontent.com/mandarange/Sneakoscope-Codex/dev/docs/assets/sneakoscope-architecture-pipeline.jpg)
 
-`0.9.16` preserves the 0.9.14 legacy-free trust layer, keeps the 0.9.15 postinstall bootstrap fix, and installs the Codex App `$Commit` / `$Commit-And-Push` skills during setup and doctor repair.
+## 0.9.18 Current Release
+
+0.9.18 makes SKS route execution hermetic and evidence-strict. Five-Scout intake can run through real Codex/tmux engines when available, falls back honestly when not, and never claims speedup from mock/static evidence. E2E route tests run in isolated temp project roots. Feature fixtures no longer receive implicit static-pass fallback; every feature declares an explicit fixture. Pipeline architecture is split into stage policy, scout policy, prompt context, active context, and stop-gate modules.
+
+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.
+- `sks scouts engines --json` reports Codex exec, tmux, Codex App subagent, local static, and sequential fallback availability with blockers.
+- Scout read-only guards snapshot source state and allow only mission-local `scout-*` artifacts plus scout reports.
+- E2E route tests run actual route commands inside isolated temp roots instead of sharing the source checkout `.sneakoscope`.
+- Feature fixtures execute deterministic allowlisted commands in hermetic temp roots and validate artifacts generated by those commands, including mission-local proof, visual ledgers, DB reports, and GX/Wiki evidence.
+- `npm run release:check` includes `pipeline-budget:check`, `scout-engines:check`, strict scout validation, and hermetic fixture execution.
+- `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 +34,14 @@ 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)
+- Scout engines: [docs/scout-engines.md](docs/scout-engines.md)
+- Hermetic E2E: [docs/testing-hermetic-e2e.md](docs/testing-hermetic-e2e.md)
+- Pipeline architecture: [docs/pipeline-architecture.md](docs/pipeline-architecture.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 +53,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.16"
+version = "0.9.18"
 dependencies = [
  "serde_json",
 ]

package/crates/sks-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "sks-core"
-version = "0.9.16"
+version = "0.9.18"
 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.16"),
+        Some("--version") => println!("sks-rs 0.9.18"),
         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.16",
+  "version": "0.9.18",
   "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,21 +41,29 @@
     "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",
+    "pipeline-budget:check": "node ./scripts/check-pipeline-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 --hermetic --json",
+    "scout-engines:check": "node ./bin/sks.mjs scouts engines --json",
+    "scouts:selftest": "node ./bin/sks.mjs scouts run latest --engine local-static --mock --json",
+    "scouts:check": "node ./bin/sks.mjs scouts validate latest --strict --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\"",
     "test:unit": "node --test \"test/unit/**/*.test.mjs\"",
     "test:integration:mock": "node --test \"test/integration/**/*.test.mjs\"",
     "test:e2e:mock": "node --test \"test/e2e/**/*.test.mjs\"",
+    "test:real-scouts": "node --test \"test/real/**/*.test.mjs\"",
     "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 route-modularity:check && npm run command-budget:check && npm run pipeline-budget:check && npm run packcheck && npm run feature:check && npm run all-features:selftest && npm run scout-engines:check && 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

@@ -51,7 +51,7 @@ 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'}`);

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/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); }

package/src/commands/wiki.mjs

@@ -1,95 +1,6 @@
-import path from 'node:path';
-import { projectRoot } from '../core/fsx.mjs';
-import { flag, readOption } from '../cli/args.mjs';
-import { printJson } from '../cli/output.mjs';
-import { addImageRelation, addVisualAnchor, ingestImage, imageVoxelSummary, readImageVoxelLedger } from '../core/wiki-image/image-voxel-ledger.mjs';
-import { imageVoxelProofEvidence } from '../core/wiki-image/proof-linker.mjs';
-import { validateImageVoxelLedger } from '../core/wiki-image/validation.mjs';
+import { wikiCommand } from '../core/commands/wiki-command.mjs';
 
 export async function run(_command, args = []) {
-  const root = await projectRoot();
-  const action = args[0] || 'help';
-  if (action === 'image-ingest') {
-    const imagePath = args.find((arg, i) => i > 0 && !String(arg).startsWith('--'));
-    const result = await ingestImage(root, imagePath, {
-      source: readOption(args, '--source', 'manual'),
-      missionId: readOption(args, '--mission-id', null)
-    });
-    if (flag(args, '--json')) return printJson(result);
-    console.log(`Image ingested: ${result.image.id}`);
-    console.log(`Ledger: ${path.relative(root, path.join(root, '.sneakoscope', 'wiki', 'image-voxel-ledger.json'))}`);
-    if (!result.ok) process.exitCode = 1;
-    return;
-  }
-  if (action === 'image-validate') {
-    const ledgerPath = args.find((arg, i) => i > 0 && !String(arg).startsWith('--'));
-    const ledger = await readImageVoxelLedger(root, ledgerPath ? path.resolve(root, ledgerPath) : undefined);
-    const result = { schema: 'sks.image-voxel-validation.v1', ...validateImageVoxelLedger(ledger, {
-      requireAnchors: flag(args, '--require-anchors'),
-      requireRelations: flag(args, '--require-relations'),
-      route: readOption(args, '--route', '$Wiki')
-    }) };
-    if (flag(args, '--json')) return printJson(result);
-    console.log(`Image voxel ledger: ${result.ok ? 'pass' : 'blocked'}`);
-    for (const issue of result.issues) console.log(`- ${issue}`);
-    if (!result.ok) process.exitCode = 1;
-    return;
-  }
-  if (action === 'image-summary') {
-    const result = await imageVoxelSummary(root);
-    if (flag(args, '--json')) return printJson(result);
-    console.log(`Images: ${result.images}`);
-    console.log(`Anchors: ${result.anchors}`);
-    console.log(`Relations: ${result.relations}`);
-    if (!result.ok) process.exitCode = 1;
-    return;
-  }
-  if (action === 'anchor-add') {
-    const result = await addVisualAnchor(root, {
-      imageId: readOption(args, '--image-id', null),
-      bbox: parseBbox(readOption(args, '--bbox', '')),
-      label: readOption(args, '--label', 'Visual anchor'),
-      source: readOption(args, '--source', 'manual'),
-      evidencePath: readOption(args, '--evidence', null),
-      route: readOption(args, '--route', '$Wiki'),
-      claimId: readOption(args, '--claim-id', null),
-      missionId: readOption(args, '--mission-id', null)
-    });
-    if (flag(args, '--json')) return printJson(result);
-    console.log(`Visual anchor: ${result.ok ? 'added' : 'blocked'} ${result.anchor.id}`);
-    for (const issue of result.validation.issues) console.log(`- ${issue}`);
-    if (!result.ok) process.exitCode = 1;
-    return;
-  }
-  if (action === 'relation-add') {
-    const result = await addImageRelation(root, {
-      type: readOption(args, '--type', 'before_after'),
-      beforeImageId: readOption(args, '--before', null),
-      afterImageId: readOption(args, '--after', null),
-      anchors: String(readOption(args, '--anchors', '') || '').split(',').map((x) => x.trim()).filter(Boolean),
-      verification: readOption(args, '--verification', 'changed-screen-recheck'),
-      status: readOption(args, '--status', 'verified_partial'),
-      route: readOption(args, '--route', '$Wiki'),
-      missionId: readOption(args, '--mission-id', null)
-    });
-    if (flag(args, '--json')) return printJson(result);
-    console.log(`Image relation: ${result.ok ? 'added' : 'blocked'} ${result.relation.type}`);
-    for (const issue of result.validation.issues) console.log(`- ${issue}`);
-    if (!result.ok) process.exitCode = 1;
-    return;
-  }
-  if (action === 'image-link-proof') {
-    const result = await imageVoxelProofEvidence(root);
-    if (flag(args, '--json')) return printJson(result);
-    console.log(`Image voxel proof link: ${result.ok ? 'ok' : 'blocked'}`);
-    if (!result.ok) process.exitCode = 1;
-    return;
-  }
-  const { wikiCommand } = await import('../core/commands/route-cli.mjs');
-  return wikiCommand(action, args.slice(1));
-}
-
-function parseBbox(raw) {
-  const parts = String(raw || '').split(',').map((part) => Number(part.trim()));
-  return parts.length === 4 && parts.every(Number.isFinite) ? parts : null;
+  const [sub = 'help', ...rest] = args;
+  return wikiCommand(sub, rest);
 }

package/src/core/commands/autoresearch-command.mjs

@@ -0,0 +1,5 @@
+import { researchCommand } from './research-command.mjs';
+
+export async function autoresearchCommand(sub, args = []) {
+  return researchCommand(sub || 'status', args);
+}