sneakoscope 4.8.7 → 5.1.2

package/bench/tasks/t01-off-by-one/repo/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "bench-t01-off-by-one",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "test": "node test.js"
+  }
+}

package/bench/tasks/t01-off-by-one/repo/src/pagination.js

@@ -0,0 +1,5 @@
+export function paginate(items, page, pageSize) {
+  const start = Math.max(0, (page - 1) * pageSize);
+  const end = Math.min(items.length - 1, start + pageSize);
+  return items.slice(start, end);
+}

package/bench/tasks/t01-off-by-one/repo/test.js

@@ -0,0 +1,5 @@
+import assert from 'node:assert/strict';
+import { paginate } from './src/pagination.js';
+
+assert.deepEqual(paginate([1, 2, 3, 4, 5], 3, 2), [5]);
+assert.deepEqual(paginate([1, 2, 3, 4], 2, 2), [3, 4]);

package/bench/tasks/t01-off-by-one/task.json

@@ -0,0 +1,13 @@
+{
+  "schema": "sks.bench-task.v1",
+  "id": "t01-off-by-one",
+  "kind": "bugfix",
+  "prompt": "pagination이 마지막 페이지 항목 1개를 누락한다. 재현 테스트를 먼저 추가하고 고쳐라.",
+  "success": {
+    "command": "npm test --silent",
+    "must_pass": true,
+    "must_contain_new_test": true,
+    "max_diff_lines": 60,
+    "forbidden_patterns": ["catch \\{\\s*\\}"]
+  }
+}

package/bench/tasks/t02-signature-cochange/repo/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "bench-t02-signature-cochange",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "test": "node test.js"
+  }
+}

package/bench/tasks/t02-signature-cochange/repo/src/admin.js

@@ -0,0 +1,5 @@
+import { formatUserLabel } from './labels.js';
+
+export function adminLabel(user) {
+  return formatUserLabel(user.name);
+}

package/bench/tasks/t02-signature-cochange/repo/src/audit.js

@@ -0,0 +1,5 @@
+import { formatUserLabel } from './labels.js';
+
+export function auditLabel(user) {
+  return formatUserLabel(user.name);
+}

package/bench/tasks/t02-signature-cochange/repo/src/labels.js

@@ -0,0 +1,3 @@
+export function formatUserLabel(name) {
+  return name.trim();
+}

package/bench/tasks/t02-signature-cochange/repo/src/profile.js

@@ -0,0 +1,5 @@
+import { formatUserLabel } from './labels.js';
+
+export function profileLabel(user) {
+  return formatUserLabel(user.name);
+}

package/bench/tasks/t02-signature-cochange/repo/test.js

@@ -0,0 +1,9 @@
+import assert from 'node:assert/strict';
+import { adminLabel } from './src/admin.js';
+import { auditLabel } from './src/audit.js';
+import { profileLabel } from './src/profile.js';
+
+const user = { name: ' Mina ', role: 'admin' };
+assert.equal(adminLabel(user), 'Mina (admin)');
+assert.equal(auditLabel(user), 'Mina (admin)');
+assert.equal(profileLabel(user), 'Mina (admin)');

package/bench/tasks/t02-signature-cochange/task.json

@@ -0,0 +1,12 @@
+{
+  "schema": "sks.bench-task.v1",
+  "id": "t02-signature-cochange",
+  "kind": "feature",
+  "prompt": "formatUserLabel이 role을 받도록 시그니처를 바꾸고 참조 3곳을 함께 수정하라.",
+  "success": {
+    "command": "npm test --silent",
+    "must_pass": true,
+    "max_diff_lines": 90,
+    "forbidden_patterns": ["catch \\{\\s*\\}"]
+  }
+}

package/bench/tasks/t03-type-puzzle/repo/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "bench-t03-type-puzzle",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "test": "node test.js"
+  }
+}

package/bench/tasks/t03-type-puzzle/repo/src/config.js

@@ -0,0 +1,4 @@
+export function parsePort(value, fallback = 3000) {
+  const parsed = Number(value);
+  return parsed || fallback;
+}

package/bench/tasks/t03-type-puzzle/repo/test.js

@@ -0,0 +1,6 @@
+import assert from 'node:assert/strict';
+import { parsePort } from './src/config.js';
+
+assert.equal(parsePort('0'), 0);
+assert.equal(parsePort('8080'), 8080);
+assert.equal(parsePort(''), 3000);

package/bench/tasks/t03-type-puzzle/task.json

@@ -0,0 +1,13 @@
+{
+  "schema": "sks.bench-task.v1",
+  "id": "t03-type-puzzle",
+  "kind": "bugfix",
+  "prompt": "parsePort가 숫자 0을 유효한 값으로 처리하지 못한다. 회귀 테스트를 추가하고 고쳐라.",
+  "success": {
+    "command": "npm test --silent",
+    "must_pass": true,
+    "must_contain_new_test": true,
+    "max_diff_lines": 60,
+    "forbidden_patterns": ["Number\\([^)]*\\) \\|\\|"]
+  }
+}

package/bench/tasks/t04-refactor-preserve/repo/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "bench-t04-refactor-preserve",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "test": "node test.js"
+  }
+}

package/bench/tasks/t04-refactor-preserve/repo/src/cart.js

@@ -0,0 +1,8 @@
+export function totalCart(lines) {
+  let total = 0;
+  for (const line of lines) {
+    total += line.price * line.qty;
+    if (line.discount) total -= line.price * line.qty * line.discount;
+  }
+  return Math.round(total * 100) / 100;
+}

package/bench/tasks/t04-refactor-preserve/repo/test.js

@@ -0,0 +1,4 @@
+import assert from 'node:assert/strict';
+import { totalCart } from './src/cart.js';
+
+assert.equal(totalCart([{ price: 10, qty: 2 }, { price: 5, qty: 1, discount: 0.2 }]), 24);

package/bench/tasks/t04-refactor-preserve/task.json

@@ -0,0 +1,12 @@
+{
+  "schema": "sks.bench-task.v1",
+  "id": "t04-refactor-preserve",
+  "kind": "refactor",
+  "prompt": "cart total 계산을 더 읽기 쉽게 리팩터하되 동작은 보존하라.",
+  "success": {
+    "command": "npm test --silent",
+    "must_pass": true,
+    "max_diff_lines": 80,
+    "forbidden_patterns": ["TODO", "console\\.log"]
+  }
+}

package/bench/tasks/t05-performance/repo/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "bench-t05-performance",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "test": "node test.js"
+  }
+}

package/bench/tasks/t05-performance/repo/src/pairs.js

@@ -0,0 +1,9 @@
+export function countPairs(values, target) {
+  let count = 0;
+  for (let i = 0; i < values.length; i += 1) {
+    for (let j = i + 1; j < values.length; j += 1) {
+      if (values[i] + values[j] === target) count += 1;
+    }
+  }
+  return count;
+}

package/bench/tasks/t05-performance/repo/test.js

@@ -0,0 +1,11 @@
+import assert from 'node:assert/strict';
+import { performance } from 'node:perf_hooks';
+import { countPairs } from './src/pairs.js';
+
+assert.equal(countPairs([1, 2, 3, 4], 5), 2);
+const values = Array.from({ length: 6000 }, (_, index) => index % 200);
+const started = performance.now();
+const count = countPairs(values, 199);
+const elapsed = performance.now() - started;
+assert.equal(count, 90000);
+assert.ok(elapsed < 250, `too slow: ${elapsed}ms`);

package/bench/tasks/t05-performance/task.json

@@ -0,0 +1,12 @@
+{
+  "schema": "sks.bench-task.v1",
+  "id": "t05-performance",
+  "kind": "bugfix",
+  "prompt": "countPairs가 큰 입력에서 시간 초과된다. 동작을 유지하면서 기준 시간 안에 들어오게 고쳐라.",
+  "success": {
+    "command": "npm test --silent",
+    "must_pass": true,
+    "max_diff_lines": 80,
+    "forbidden_patterns": ["setTimeout", "catch \\{\\s*\\}"]
+  }
+}

package/bench/tasks/t06-mistake-rule/repo/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "bench-t06-mistake-rule",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "test": "node test.js"
+  }
+}

package/bench/tasks/t06-mistake-rule/repo/src/loader.js

@@ -0,0 +1,6 @@
+export async function loadJson(readText) {
+  try {
+    return JSON.parse(await readText());
+  } catch (err) {}
+  return null;
+}

package/bench/tasks/t06-mistake-rule/repo/test.js

@@ -0,0 +1,7 @@
+import assert from 'node:assert/strict';
+import fs from 'node:fs/promises';
+import { loadJson } from './src/loader.js';
+
+const source = await fs.readFile(new URL('./src/loader.js', import.meta.url), 'utf8');
+assert.ok(!/catch\s*\([^)]*\)\s*\{\s*\}/.test(source), 'empty catch must be removed');
+await assert.rejects(() => loadJson(async () => '{bad json'));

package/bench/tasks/t06-mistake-rule/task.json

@@ -0,0 +1,12 @@
+{
+  "schema": "sks.bench-task.v1",
+  "id": "t06-mistake-rule",
+  "kind": "bugfix",
+  "prompt": "빈 catch로 오류가 삼켜진다. 과거 실수 규칙에 걸리지 않도록 명시적 처리를 추가하라.",
+  "success": {
+    "command": "npm test --silent",
+    "must_pass": true,
+    "max_diff_lines": 50,
+    "forbidden_patterns": ["catch \\([^)]*\\) \\{\\s*\\}"]
+  }
+}

package/config/bench-baseline.json

@@ -0,0 +1,7 @@
+{
+  "schema": "sks.coding-bench-baseline.v1",
+  "baseline_version": "5.0.0",
+  "pass_rate": 0,
+  "min_pass_rate": 0,
+  "notes": "Real model coding bench is skipped with no_backend unless SKS_RUN_CODING_BENCH_REAL=1 and a backend credential is present."
+}

package/crates/sks-core/Cargo.lock

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

package/crates/sks-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "sks-core"
-version = "4.8.7"
+version = "5.1.2"
 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 4.8.7"),
+        Some("--version") => println!("sks-rs 5.1.2"),
         Some("compact-info") => {
             let mut input = String::new();
             let _ = io::stdin().read_to_string(&mut input);

package/dist/bin/install.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+const args = process.argv.slice(2);
+const command = args.find((arg) => !arg.startsWith('-')) || 'install';
+const autonomous = args.includes('--no-tui') || args.includes('--yes') || args.includes('-y');
+function run(cmd, cmdArgs) {
+    const result = spawnSync(cmd, cmdArgs, { stdio: 'inherit' });
+    return result.status ?? 1;
+}
+if (!['install', 'setup', 'bootstrap'].includes(command)) {
+    console.error('Usage: npx sneakoscope install [--yes|--no-tui]');
+    process.exit(2);
+}
+console.log('SKS installer - proof-first Codex harness');
+const already = spawnSync('sks', ['--version'], { encoding: 'utf8' });
+if (already.status !== 0) {
+    console.log('> installing global package (npm i -g sneakoscope)...');
+    if (run('npm', ['install', '-g', 'sneakoscope']) !== 0) {
+        console.error('global install failed - check npm permissions');
+        process.exit(1);
+    }
+}
+console.log('> repairing/validating environment (sks doctor --fix)...');
+if (run('sks', ['doctor', '--fix', ...(autonomous ? ['--yes'] : [])]) !== 0) {
+    console.error('doctor reported blockers - see report above');
+    process.exit(1);
+}
+console.log(`
+SKS ready. 다음 3개만 기억하세요 (Codex 입력창에서):
+   $Plan "무엇을 만들지"     - 계획만 세움 (코드 안 건드림)
+   $Work                     - 계획을 증거 기반으로 실행
+   $Swarm "task"             - 동적 병렬 스웜 + 기계 검증 루프
+   실시간 화면: sks ui  (웹 대시보드) / zellij 세션은 자동
+`);
+//# sourceMappingURL=install.js.map

package/dist/bin/sks.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const FAST_PACKAGE_VERSION = '4.8.7';
+const FAST_PACKAGE_VERSION = '5.1.2';
 const args = process.argv.slice(2);
 try {
     if (args[0] === '--agent' && args[1] === 'worker') {

package/dist/cli/cli-theme.js

@@ -0,0 +1,51 @@
+import { PACKAGE_VERSION } from '../core/version.js';
+import { ANSI_CODES, paint, resolveZellijTheme } from '../core/zellij/zellij-theme.js';
+const theme = resolveZellijTheme();
+export const ui = {
+    banner(cmd) {
+        console.log(paint(theme, ANSI_CODES.dim, `SKS ${PACKAGE_VERSION} · ${cmd}`));
+    },
+    ok(msg) {
+        console.log(`${paint(theme, ANSI_CODES.green, '✔')} ${msg}`);
+    },
+    warn(msg) {
+        console.log(`${paint(theme, ANSI_CODES.yellow, '▲')} ${msg}`);
+    },
+    fail(msg) {
+        console.log(`${paint(theme, ANSI_CODES.red, '✖')} ${msg}`);
+    },
+    step(msg) {
+        console.log(`${paint(theme, ANSI_CODES.dim, '>')} ${msg}`);
+    },
+    kv(k, v) {
+        console.log(`  ${paint(theme, ANSI_CODES.dim, k.padEnd(18))} ${v}`);
+    },
+    table(rows) {
+        if (!rows.length)
+            return;
+        const widths = rows[0]?.map((_cell, index) => Math.max(...rows.map((row) => String(row[index] || '').length))) || [];
+        for (const [rowIndex, row] of rows.entries()) {
+            const line = row.map((cell, index) => String(cell || '').padEnd(widths[index] || 0)).join('  ').trimEnd();
+            console.log(rowIndex === 0 ? paint(theme, ANSI_CODES.dim, line) : line);
+        }
+    }
+};
+export function withHeartbeat(label, work, opts = {}) {
+    if (process.env.SKS_UPDATE_QUIET || !process.stderr.isTTY)
+        return work;
+    const started = Date.now();
+    let index = 0;
+    const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    const timer = setInterval(() => {
+        const elapsed = Date.now() - started;
+        const seconds = Math.floor(elapsed / 1000);
+        const warn = opts.warnAfterMs && elapsed > opts.warnAfterMs ? '  (still working; this can be normal)' : '';
+        process.stderr.write(`\r  ${frames[index++ % frames.length]} ${label} ... ${seconds}s${warn}   `);
+    }, 120);
+    timer.unref?.();
+    return work.finally(() => {
+        clearInterval(timer);
+        process.stderr.write(`\r${' '.repeat(80)}\r`);
+    });
+}
+//# sourceMappingURL=cli-theme.js.map

package/dist/cli/command-registry.js

@@ -96,7 +96,13 @@ export const COMMANDS = {
     triwiki: skipMigrationGate(entry('stable', 'Inspect TriWiki index, affected graph, and proof bank', 'dist/core/commands/triwiki-command.js', argsCommand(() => import('../core/commands/triwiki-command.js'), 'triwikiCommand', 'dist/core/commands/triwiki-command.js'))),
     daemon: skipMigrationGate(entry('stable', 'Inspect or warm the local SKS daemon cache', 'dist/core/commands/daemon-command.js', argsCommand(() => import('../core/commands/daemon-command.js'), 'daemonCommand', 'dist/core/commands/daemon-command.js'))),
     run: entry('beta', 'Classify and execute a task through the SKS trust kernel', 'dist/core/commands/run-command.js', argsCommand(() => import('../core/commands/run-command.js'), 'runCommand', 'dist/core/commands/run-command.js')),
+    plan: entry('stable', 'Write a planning-only SKS plan artifact without code edits', 'dist/core/commands/plan-command.js', argsCommand(() => import('../core/commands/plan-command.js'), 'planCommand', 'dist/core/commands/plan-command.js')),
     status: readOnly(entry('stable', 'Show concise active mission and trust status', 'dist/core/commands/status-command.js', argsCommand(() => import('../core/commands/status-command.js'), 'statusCommand', 'dist/core/commands/status-command.js'))),
+    review: entry('stable', 'Review a git diff with machine evidence first', 'dist/core/commands/review-command.js', argsCommand(() => import('../core/commands/review-command.js'), 'reviewCommand', 'dist/core/commands/review-command.js'), {
+        allowedDuringActiveRoute: true,
+        activeRoutePolicy: 'always'
+    }),
+    ui: readOnly(entry('stable', 'Open the localhost SKS swarm dashboard', 'dist/core/commands/ui-command.js', argsCommand(() => import('../core/commands/ui-command.js'), 'uiCommand', 'dist/core/commands/ui-command.js'))),
     root: readOnly(entry('stable', 'Show active SKS root', 'dist/commands/root.js', directCommand(() => import('../commands/root.js'), 'dist/commands/root.js'))),
     update: skipMigrationGate(entry('stable', 'Update the global SKS npm package', 'dist/core/commands/basic-cli.js', subcommand(() => import(basicModule), 'updateCommand', 'dist/core/commands/basic-cli.js', 'now'))),
     uninstall: entry('stable', 'Uninstall SKS global skills, hooks, config, menu bar, and optional project residue', 'dist/core/commands/uninstall-command.js', argsCommand(() => import('../core/commands/uninstall-command.js'), 'uninstallCommand', 'dist/core/commands/uninstall-command.js'), {
@@ -132,9 +138,9 @@ export const COMMANDS = {
     'zellij-viewport-pane': skipMigrationGate(readOnly(entry('beta', 'Render a dynamically bound Zellij worker viewport pane', 'dist/commands/zellij-viewport-pane.js', directCommand(() => import('../commands/zellij-viewport-pane.js'), 'dist/commands/zellij-viewport-pane.js')))),
     'zellij-slot-column-anchor': entry('beta', 'Render the compact SLOTS anchor pane for first-slot-down Zellij stacks', 'dist/commands/zellij-slot-column-anchor.js', directCommand(() => import('../commands/zellij-slot-column-anchor.js'), 'dist/commands/zellij-slot-column-anchor.js')),
     zellij: activeRouteDiagnostic(entry('beta', 'Inspect Zellij runtime status and explain repair (no auto-install)', 'dist/commands/zellij.js', directCommand(() => import('../commands/zellij.js'), 'dist/commands/zellij.js'))),
-    'mad-sks': routeStateMutator(entry('beta', 'MAD-SKS scoped permission modifier', 'dist/commands/mad-sks.js', directCommand(() => import('../commands/mad-sks.js'), 'dist/commands/mad-sks.js')), ['mad-sks-gate.json']),
+    'mad-sks': routeStateMutator(entry('beta', 'MAD-SKS scoped permission modifier + SQL-plane execution (merged MAD-DB)', 'dist/commands/mad-sks.js', directCommand(() => import('../commands/mad-sks.js'), 'dist/commands/mad-sks.js')), ['mad-sks-gate.json']),
     glm: entry('beta', 'Run GLM 5.2 MAD mode through OpenRouter', 'dist/core/commands/glm-command.js', argsCommand(() => import('../core/commands/glm-command.js'), 'glmCommand', 'dist/core/commands/glm-command.js')),
-    'mad-db': routeStateMutator(entry('beta', 'Run first-class MadDB SQL-plane execution cycles with mission-local Supabase write transport', 'dist/commands/mad-db.js', directCommand(() => import('../commands/mad-db.js'), 'dist/commands/mad-db.js')), ['mad-db-gate.json']),
+    'mad-db': routeStateMutator(entry('beta', 'Deprecated alias for MAD-SKS SQL-plane execution; redirects to sks mad-sks sql|apply-migration', 'dist/commands/mad-db.js', directCommand(() => import('../commands/mad-db.js'), 'dist/commands/mad-db.js')), ['mad-sks-gate.json']),
     'auto-review': entry('beta', 'Manage auto-review profile', 'dist/commands/auto-review.js', directCommand(() => import('../commands/auto-review.js'), 'dist/commands/auto-review.js')),
     'dollar-commands': entry('stable', 'List Codex App dollar commands', 'dist/core/commands/basic-cli.js', basicArgs('dollarCommandsCommand')),
     'fast-mode': entry('stable', 'Toggle SKS Fast mode default for dollar-command routes', 'dist/core/commands/fast-mode-command.js', argsCommand(() => import('../core/commands/fast-mode-command.js'), 'fastModeCommand', 'dist/core/commands/fast-mode-command.js')),
@@ -166,7 +172,7 @@ export const COMMANDS = {
     reasoning: entry('labs', 'Show reasoning route', 'dist/core/commands/basic-cli.js', basicArgs('reasoningCommand')),
     aliases: entry('stable', 'Show command aliases', 'dist/core/commands/basic-cli.js', basicNoArgs('aliasesCommand')),
     selftest: entry('stable', 'Run local mock selftest', 'dist/core/commands/basic-cli.js', basicArgs('selftestCommand')),
-    goal: routeStateMutator(entry('beta', 'Manage Goal bridge workflow', 'dist/core/commands/goal-command.js', subcommand(() => import('../core/commands/goal-command.js'), 'goalCommand', 'dist/core/commands/goal-command.js')), ['goal-gate.json']),
+    goal: routeStateMutator(entry('beta', 'Manage Goal bridge workflow', 'dist/core/commands/goal-command.js', subcommand(() => import('../core/commands/goal-command.js'), 'goalCommand', 'dist/core/commands/goal-command.js')), ['loop-graph-proof.json']),
     'seo-geo-optimizer': entry('beta', 'Run unified SEO/GEO optimizer audit/plan/apply/verify on the search-visibility kernel', 'dist/core/commands/seo-command.js', argsCommand(() => import('../core/commands/seo-command.js'), 'seoGeoOptimizerCommand', 'dist/core/commands/seo-command.js')),
     hook: entry('beta', 'Codex hook entrypoint', 'dist/commands/hook.js', directCommand(() => import('../commands/hook.js'), 'dist/commands/hook.js')),
     profile: entry('labs', 'Inspect/set profile', 'dist/commands/profile.js', directCommand(() => import('../commands/profile.js'), 'dist/commands/profile.js')),
@@ -184,6 +190,7 @@ export const COMMANDS = {
     eval: entry('labs', 'Run eval reports', 'dist/core/commands/eval-command.js', subcommand(() => import('../core/commands/eval-command.js'), 'evalCommand', 'dist/core/commands/eval-command.js', 'run')),
     harness: entry('labs', 'Run harness fixtures', 'dist/core/commands/harness-command.js', subcommand(() => import('../core/commands/harness-command.js'), 'harnessCommand', 'dist/core/commands/harness-command.js', 'fixture')),
     wiki: activeRouteDiagnostic(entry('beta', 'Manage TriWiki and image voxel ledgers', 'dist/commands/wiki.js', directCommand(() => import('../commands/wiki.js'), 'dist/commands/wiki.js'))),
+    memory: entry('beta', 'Project TriWiki memory into managed AGENTS.md blocks or run memory GC', 'dist/commands/memory.js', directCommand(() => import('../commands/memory.js'), 'dist/commands/memory.js')),
     gc: activeRouteDiagnostic(entry('labs', 'Compact/prune runtime state', 'dist/core/commands/gc-command.js', gcArgs('gcCommand'))),
     stats: readOnly(entry('labs', 'Show storage stats', 'dist/core/commands/gc-command.js', gcArgs('statsCommand'))),
     features: entry('beta', 'Validate feature registry', 'dist/commands/features.js', directCommand(() => import('../commands/features.js'), 'dist/commands/features.js')),
@@ -202,8 +209,12 @@ export const COMMAND_ALIASES = {
     '--mad': 'mad-sks',
     '--MAD': 'mad-sks',
     '--mad-sks': 'mad-sks',
+    'ux-review': 'image-ux-review',
+    'visual-review': 'image-ux-review',
+    'ui-ux-review': 'image-ux-review',
     '--agent': 'agent',
-    '--naruto': 'naruto'
+    '--naruto': 'naruto',
+    swarm: 'naruto'
 };
 export function commandNames() {
     return Object.keys(COMMANDS).sort();

package/dist/cli/help-fast.js

@@ -5,18 +5,28 @@ export function helpFast() {
     console.log(`SKS
 SNEAKOSCOPE CODEX v${PACKAGE_VERSION}
 
-Usage
+3-pillar frontdoor
 
-  sks
-  sks help [topic]
-  sks commands [--json]
-  sks dollar-commands [--json]
-  sks proof show --json
+  $Plan "task"              plan only; writes .sneakoscope/plans, no code edits
+  $Work                     execute the latest plan with evidence gates
+  $Swarm "task"             dynamic Naruto swarm with machine verification
+
+Local surfaces
+
+  sks ui                    localhost live dashboard
+  sks review --staged       machine-first diff review
+  sks doctor --fix          repair/validate the harness
+
+Discovery
+
+  sks commands [--json]     all commands
+  sks dollar-commands       all Codex App $ routes
+  sks help [topic]          focused help
 `);
-    for (const row of commandRows().filter((entry) => entry.maturity !== 'labs')) {
+    for (const row of commandRows().filter((entry) => entry.maturity !== 'labs').slice(0, 18)) {
         console.log(`  ${row.usage.padEnd(58)} ${row.description}`);
     }
-    console.log('\nThree core promises: Completion Proof for serious routes, Image Voxel TriWiki for visual routes, and release-gated Codex App/codex-lb/hooks/Rust evidence.');
+    console.log('\nRun `sks commands` for the full catalog. Core promise: machine-verified completion, not vibes.');
 }
 function commandRows() {
     const registry = new Map(Object.entries(COMMANDS).map(([name, meta]) => [name, meta]));

package/dist/cli/insane-search-command.js

@@ -2,6 +2,7 @@ import fs from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
 import { runUltraSearch } from '../core/ultra-search/index.js';
+import { evaluateLocalGate } from '../core/commands/route-success-helpers.js';
 export async function insaneSearchCommand(sub = 'help', args = []) {
     const action = sub || 'help';
     if (action === 'run')
@@ -35,16 +36,25 @@ async function runCommand(args) {
         query,
         ...(mode ? { mode } : {})
     });
+    const gate = await evaluateUltraSearchGate(missionDir);
+    const finalResult = {
+        ...result,
+        ok: result.ok === true && gate.ok === true,
+        blockers: [...new Set([...(result.blockers || []), ...gate.blockers])],
+        gate_evaluation: gate
+    };
     if (json)
-        console.log(JSON.stringify(result, null, 2));
+        console.log(JSON.stringify(finalResult, null, 2));
     else {
-        console.log(`InsaneSearch ${result.ok ? 'completed' : 'partial/blocked'}: ${result.mode}`);
+        console.log(`InsaneSearch ${finalResult.ok ? 'completed' : 'partial/blocked'}: ${result.mode}`);
         console.log(`Mission: ${missionDir}`);
         console.log(`Sources: ${result.sources.length}, verified: ${result.proof.verified_source_count}`);
-        if (result.blockers.length)
-            console.log(`Blockers: ${result.blockers.join(', ')}`);
+        if (finalResult.blockers.length)
+            console.log(`Blockers: ${finalResult.blockers.join(', ')}`);
     }
-    return result;
+    if (!finalResult.ok)
+        process.exitCode = 1;
+    return finalResult;
 }
 async function doctorCommand(args) {
     const json = args.includes('--json');
@@ -74,11 +84,16 @@ async function inspectCommand(action, args) {
     const target = mission === 'latest' ? await latestMissionDir() : mission;
     const file = path.join(target, 'ultra-search', action === 'sources' ? 'source-ledger.json' : action === 'claims' ? 'claim-ledger.json' : 'ultra-search-result.json');
     const text = await fs.readFile(file, 'utf8');
+    const parsed = JSON.parse(text);
+    const gate = await evaluateUltraSearchGate(target);
+    const result = { ...parsed, ok: parsed.ok === true && gate.ok === true, gate_evaluation: gate, blockers: [...new Set([...(parsed.blockers || []), ...gate.blockers])] };
+    if (!result.ok)
+        process.exitCode = 1;
     if (json)
-        console.log(text.trim());
+        console.log(JSON.stringify(result, null, 2));
     else
-        console.log(text);
-    return JSON.parse(text);
+        console.log(JSON.stringify(result, null, 2));
+    return result;
 }
 async function cacheCommand(args) {
     const sub = positional(args)[0] || 'status';
@@ -164,4 +179,17 @@ async function latestMissionDir() {
 function asyncDirLikelyUltra(dir) {
     return Boolean(dir);
 }
+async function evaluateUltraSearchGate(missionDir) {
+    return evaluateLocalGate({
+        root: process.cwd(),
+        dir: missionDir,
+        gateFile: path.join('ultra-search', 'ultra-search-gate.json'),
+        requiredArtifacts: [
+            path.join('ultra-search', 'source-ledger.json'),
+            path.join('ultra-search', 'claim-ledger.json'),
+            path.join('ultra-search', 'ultra-search-proof.json'),
+            path.join('ultra-search', 'ultra-search-result.json')
+        ]
+    });
+}
 //# sourceMappingURL=insane-search-command.js.map