sneakoscope 0.9.13 → 0.9.15

package/src/commands/help.mjs

@@ -1,77 +1,6 @@
-import { COMMANDS } from '../cli/command-registry.mjs';
-import { flag } from '../cli/args.mjs';
-import { printJson, sksTextLogo } from '../cli/output.mjs';
-
-const FALLBACK_CATALOG = [
-  { name: 'help', usage: 'sks help [stable|beta|labs|all]', description: 'Show concise SKS help.' },
-  { name: 'version', usage: 'sks version | sks --version', description: 'Print the installed version.' },
-  { name: 'commands', usage: 'sks commands [--json]', description: 'List the command registry.' },
-  { name: 'root', usage: 'sks root [--json]', description: 'Show the active SKS root.' },
-  { name: 'doctor', usage: 'sks doctor [--json]', description: 'Check local SKS readiness.' },
-  { name: 'features', usage: 'sks features check --json', description: 'Validate feature coverage and fixtures.' },
-  { name: 'all-features', usage: 'sks all-features selftest --mock --json', description: 'Run mock feature fixture checks.' },
-  { name: 'proof', usage: 'sks proof show|validate|latest|export [--json|--md]', description: 'Inspect completion proof.' },
-  { name: 'wiki', usage: 'sks wiki image-ingest|image-validate|image-summary ...', description: 'Manage TriWiki and image voxel ledgers.' },
-  { name: 'hooks', usage: 'sks hooks explain|status|trust-report|replay ...', description: 'Inspect Codex hook policy and trust evidence.' },
-  { name: 'codex-lb', usage: 'sks codex-lb status|metrics|doctor|circuit ...', description: 'Inspect codex-lb readiness and circuit state.' },
-  { name: 'perf', usage: 'sks perf cold-start --json', description: 'Measure CLI cold-start budgets.' },
-  { name: 'team', usage: 'sks team "task"', description: 'Create and observe Team missions.' },
-  { name: 'qa-loop', usage: 'sks qa-loop prepare|run|status ...', description: 'Run QA loop missions.' },
-  { name: 'research', usage: 'sks research prepare|run|status ...', description: 'Run research missions.' },
-  { name: 'ppt', usage: 'sks ppt build|status ...', description: 'Build or inspect PPT route artifacts.' },
-  { name: 'image-ux-review', usage: 'sks image-ux-review status ...', description: 'Inspect image UX review artifacts.' },
-  { name: 'db', usage: 'sks db policy|scan|check ...', description: 'Inspect database safety policy.' },
-  { name: 'gx', usage: 'sks gx init|render|validate|drift|snapshot ...', description: 'Create and verify visual context cartridges.' },
-  { name: 'goal', usage: 'sks goal create|status|pause|resume|clear ...', description: 'Manage the Goal bridge.' }
-];
+import { commandsCommand, helpCommand } from '../core/commands/basic-cli.mjs';
 
 export async function run(command, args = []) {
-  if (command === 'commands') return commands(args);
-  const topic = args[0];
-  if (topic === 'all') return printHelp('all');
-  if (['stable', 'beta', 'labs'].includes(topic)) return printHelp(topic);
-  if (topic) return printTopic(topic);
-  return printHelp('default');
-}
-
-function commands(args = []) {
-  const commands = commandRows('all');
-  if (flag(args, '--json')) {
-    return printJson({
-      schema: 'sks.command-registry.v1',
-      aliases: ['sks', 'sneakoscope'],
-      commands
-    });
-  }
-  console.log(`${sksTextLogo()}\n\nCommands\n`);
-  const width = Math.max(...commands.map((entry) => entry.usage.length));
-  for (const entry of commands) console.log(`${entry.usage.padEnd(width)}  ${entry.description}`);
-}
-
-function printHelp(filter) {
-  const rows = commandRows(filter === 'default' ? 'stable-beta' : filter);
-  console.log(`${sksTextLogo()}\n\nUsage\n`);
-  console.log('  sks help [stable|beta|labs|all]');
-  console.log('  sks commands [--json]');
-  console.log('  sks root [--json]');
-  console.log('  sks proof show --json');
-  console.log('');
-  for (const row of rows) console.log(`  ${row.usage.padEnd(54)} ${row.description}`);
-  console.log('\nCore promises: image-based Voxel TriWiki, Codex App/codex-lb readiness, and completion proof for serious routes.');
-}
-
-function printTopic(topic) {
-  const row = commandRows('all').find((entry) => entry.name === topic);
-  if (!row) return printHelp('default');
-  console.log(`${sksTextLogo()}\n\n${row.name}\n`);
-  console.log(`Usage: ${row.usage}`);
-  console.log(row.description);
-}
-
-function commandRows(filter) {
-  const maturityByName = new Map(Object.entries(COMMANDS).map(([name, meta]) => [name, meta.maturity || 'labs']));
-  const rows = FALLBACK_CATALOG.map((entry) => ({ ...entry, maturity: maturityByName.get(entry.name) || 'labs' }));
-  if (filter === 'all') return rows;
-  if (filter === 'stable-beta') return rows.filter((row) => row.maturity === 'stable' || row.maturity === 'beta');
-  return rows.filter((row) => row.maturity === filter);
+  if (command === 'commands') return commandsCommand(args);
+  return helpCommand(args);
 }

package/src/commands/hook.mjs

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

package/src/commands/hproof.mjs

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

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

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

package/src/commands/init.mjs

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

package/src/commands/mad-sks.mjs

@@ -0,0 +1,14 @@
+import { madHighCommand } from '../core/commands/route-cli.mjs';
+import { maybePromptCodexUpdateForLaunch, maybePromptCodexLbSetupForLaunch } from '../cli/install-helpers.mjs';
+import { PACKAGE_VERSION } from '../core/fsx.mjs';
+
+export async function run(_command, args = []) {
+  return madHighCommand(['--mad-sks', ...args], {
+    maybePromptSksUpdateForLaunch: async () => ({ status: 'skipped' }),
+    maybePromptCodexUpdateForLaunch,
+    ensureMadLaunchDependencies: async () => ({ ready: true, actions: [], status: {} }),
+    printDepsInstallAction: (action) => console.log(JSON.stringify(action)),
+    maybePromptCodexLbSetupForLaunch,
+    packageVersion: PACKAGE_VERSION
+  });
+}

package/src/commands/memory.mjs

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

package/src/commands/openclaw.mjs

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

package/src/commands/perf.mjs

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

package/src/commands/pipeline.mjs

@@ -0,0 +1,25 @@
+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';
+
+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;
+}

package/src/commands/postinstall.mjs

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

package/src/commands/ppt.mjs

@@ -0,0 +1,44 @@
+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';
+
+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;
+}

package/src/commands/profile.mjs

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

package/src/commands/proof-field.mjs

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

package/src/commands/proof.mjs

@@ -5,6 +5,7 @@ import { collectProofEvidence } from '../core/proof/evidence-collector.mjs';
 import { findLatestMission } from '../core/mission.mjs';
 import { readLatestProof, readLatestProofMarkdown, readRouteProof } from '../core/proof/proof-reader.mjs';
 import { writeRouteCompletionProof } from '../core/proof/route-adapter.mjs';
+import { finalizeRouteWithProof } from '../core/proof/route-finalizer.mjs';
 import { renderProofMarkdown, writeCompletionProof } from '../core/proof/proof-writer.mjs';
 import { validateCompletionProof } from '../core/proof/validation.mjs';
 
@@ -41,6 +42,26 @@ export async function run(_command, args = []) {
     if (!result.ok) process.exitCode = 1;
     return;
   }
+  if (action === 'finalize') {
+    const missionArg = rest.find((arg) => !String(arg).startsWith('--')) || 'latest';
+    const missionId = missionArg === 'latest' ? await findLatestMission(root) : missionArg;
+    const routeIndex = args.indexOf('--route');
+    const route = routeIndex >= 0 && args[routeIndex + 1] ? args[routeIndex + 1] : '$SKS';
+    const result = await finalizeRouteWithProof(root, {
+      missionId,
+      route,
+      strict: flag(args, '--strict'),
+      mock: flag(args, '--mock'),
+      requireRelation: flag(args, '--require-relation'),
+      statusHint: flag(args, '--strict') ? 'verified_partial' : 'verified_partial',
+      claims: [{ id: 'proof-finalize', status: 'supported', evidence: `.sneakoscope/missions/${missionId}/completion-proof.json` }],
+      unverified: flag(args, '--mock') ? ['Finalizer ran in mock fixture mode.'] : []
+    });
+    if (flag(args, '--json')) return printJson({ schema: 'sks.completion-proof-finalize.v1', ok: result.ok, mission_id: missionId, validation: result.validation, files: result.files, proof: result.proof });
+    console.log(`Completion proof finalized: ${result.files.latest_json}`);
+    if (!result.ok) process.exitCode = 1;
+    return;
+  }
   if (action === 'export' && (flag(rest, '--md') || flag(args, '--md'))) {
     process.stdout.write(await readLatestProofMarkdown(root));
     return;
@@ -86,7 +107,7 @@ export async function run(_command, args = []) {
     console.log(`Completion proof written: ${result.files.latest_json}`);
     return;
   }
-  console.error('Usage: sks proof show|latest|validate|route <mission-id|latest>|export --md|repair latest|smoke [--json]');
+  console.error('Usage: sks proof show|latest|validate|route <mission-id|latest>|finalize <mission-id|latest> [--route route] [--strict] [--mock] [--json]|export --md|repair latest|smoke [--json]');
   process.exitCode = 1;
 }
 

package/src/commands/qa-loop.mjs

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

package/src/commands/quickstart.mjs

@@ -0,0 +1,2 @@
+import { quickstartCommand } from '../core/commands/basic-cli.mjs';
+export async function run() { return quickstartCommand(); }

package/src/commands/reasoning.mjs

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

package/src/commands/recallpulse.mjs

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

package/src/commands/research.mjs

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

package/src/commands/selftest.mjs

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

package/src/commands/setup.mjs

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

package/src/commands/skill-dream.mjs

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

package/src/commands/stats.mjs

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

package/src/commands/team.mjs

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

package/src/commands/tmux.mjs

@@ -0,0 +1,5 @@
+import { tmuxCommand } from '../core/commands/basic-cli.mjs';
+export async function run(_command, args = []) {
+  const [sub = 'check', ...rest] = args;
+  return tmuxCommand(sub, rest);
+}

package/src/commands/update-check.mjs

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

package/src/commands/usage.mjs

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

package/src/commands/validate-artifacts.mjs

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

package/src/commands/versioning.mjs

@@ -0,0 +1,16 @@
+import { projectRoot } from '../core/fsx.mjs';
+import { bumpProjectVersion, disableVersionGitHook, versioningStatus } from '../core/version-manager.mjs';
+import { flag } from '../cli/args.mjs';
+import { printJson } from '../cli/output.mjs';
+export async function run(_command, args = []) {
+  const root = await projectRoot();
+  const action = args[0] || 'status';
+  const result = action === 'bump'
+    ? await bumpProjectVersion(root, { force: true })
+    : ['disable', 'off', 'remove-hook', 'unhook'].includes(action)
+      ? await disableVersionGitHook(root)
+      : await versioningStatus(root);
+  if (flag(args, '--json')) return printJson(result);
+  console.log(JSON.stringify(result, null, 2));
+  if (result.ok === false) process.exitCode = 1;
+}

package/src/commands/wiki.mjs

@@ -85,8 +85,8 @@ export async function run(_command, args = []) {
     if (!result.ok) process.exitCode = 1;
     return;
   }
-  const legacy = await import('../cli/legacy-main.mjs');
-  return legacy.main(['wiki', ...args]);
+  const { wikiCommand } = await import('../core/commands/route-cli.mjs');
+  return wikiCommand(action, args.slice(1));
 }
 
 function parseBbox(raw) {

package/src/core/codex-lb-circuit.mjs

@@ -99,6 +99,24 @@ export function codexLbMetrics(circuit = emptyCircuit()) {
   };
 }
 
+export async function codexLbProofEvidence(root = packageRoot()) {
+  const circuit = await readCodexLbCircuit(root);
+  const metrics = codexLbMetrics(circuit);
+  return {
+    schema: 'sks.codex-lb-proof-evidence.v1',
+    ok: metrics.ok,
+    status: circuit.state === 'open' ? 'blocked' : 'verified_partial',
+    circuit_state: circuit.state,
+    report_path: codexLbReportPath(root),
+    last_ok_at: circuit.last_ok_at,
+    last_failure_at: circuit.last_failure_at,
+    last_warning_at: circuit.last_warning_at,
+    recent_failures: circuit.recent_failures?.length || 0,
+    recent_warnings: circuit.recent_warnings?.length || 0,
+    policy: metrics.policy
+  };
+}
+
 function emptyCircuit() {
   return {
     schema: CODEX_LB_CIRCUIT_SCHEMA,