sneakoscope 6.1.0 → 6.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +28 -11
- package/crates/sks-core/Cargo.lock +1 -1
- package/crates/sks-core/Cargo.toml +1 -1
- package/dist/bin/fast-inline.js +18 -9
- package/dist/bin/sks-dispatch.js +2 -2
- package/dist/cli/args.js +2 -0
- package/dist/cli/command-manifest-lite.js +2 -3
- package/dist/cli/command-registry.js +3 -4
- package/dist/cli/help-fast.js +1 -1
- package/dist/cli/install-helpers.js +108 -303
- package/dist/cli/install-tool-helpers.js +287 -0
- package/dist/cli/router.js +40 -4
- package/dist/commands/codex-lb.js +51 -20
- package/dist/commands/codex.js +39 -1
- package/dist/commands/doctor.js +242 -20
- package/dist/commands/tmux.js +5 -1
- package/dist/commands/zellij-monitor-pane.js +2 -0
- package/dist/commands/zellij-viewport-pane.js +3 -1
- package/dist/commands/zellij.js +1 -1
- package/dist/config/skills-manifest.json +59 -59
- package/dist/core/agent-bridge/agent-manifest.js +48 -0
- package/dist/core/agents/agent-command-surface.js +2 -1
- package/dist/core/agents/agent-effort-policy.js +30 -38
- package/dist/core/agents/agent-plan.js +100 -21
- package/dist/core/agents/agent-role-config.js +43 -46
- package/dist/core/agents/agent-runner-codex-exec.js +16 -3
- package/dist/core/agents/agent-schema.js +3 -2
- package/dist/core/agents/native-cli-session-swarm.js +1 -1
- package/dist/core/agents/zellij-right-lane-cockpit.js +2 -2
- package/dist/core/codex/agent-config-file-repair.js +94 -193
- package/dist/core/codex/codex-cli-update.js +723 -0
- package/dist/core/codex/codex-config-guard.js +7 -2
- package/dist/core/codex/codex-project-config-policy.js +3 -6
- package/dist/core/codex/codex-startup-config-postcheck.js +52 -42
- package/dist/core/codex-adapter.js +35 -22
- package/dist/core/codex-app/codex-agent-role-sync.js +13 -54
- package/dist/core/codex-app/codex-app-launcher.js +48 -17
- package/dist/core/codex-app/codex-app-restart.js +23 -2
- package/dist/core/codex-app/sks-menubar.js +128 -2
- package/dist/core/codex-control/codex-0139-image-path-real-probe.js +15 -4
- package/dist/core/codex-control/codex-0139-web-search-probe.js +17 -6
- package/dist/core/codex-control/codex-lb-launch-recovery.js +278 -0
- package/dist/core/codex-control/codex-reliability-shield.js +89 -29
- package/dist/core/codex-control/codex-sdk-adapter.js +44 -8
- package/dist/core/codex-control/codex-task-runner.js +62 -9
- package/dist/core/codex-control/python-codex-sdk-adapter.js +30 -3
- package/dist/core/codex-exec-output-schema.js +35 -6
- package/dist/core/codex-lb/codex-lb-env.js +1 -1
- package/dist/core/codex-lb/codex-lb-tool-output-recovery.js +291 -0
- package/dist/core/codex-native/codex-native-feature-broker.js +9 -16
- package/dist/core/codex-native/codex-native-repair-transaction.js +1 -1
- package/dist/core/codex-native/core-skill-manifest.js +8 -4
- package/dist/core/codex-runtime/codex-desktop-config-policy.js +2 -3
- package/dist/core/commands/agent-bridge-command.js +23 -2
- package/dist/core/commands/agent-command.js +19 -5
- package/dist/core/commands/basic-cli.js +47 -6
- package/dist/core/commands/command-utils.js +1 -1
- package/dist/core/commands/mad-sks-command.js +33 -8
- package/dist/core/commands/naruto-command.js +643 -1156
- package/dist/core/commands/research-command.js +293 -231
- package/dist/core/commands/run-command.js +100 -23
- package/dist/core/commands/team-command.js +2 -3
- package/dist/core/commands/team-legacy-observe-command.js +94 -359
- package/dist/core/db-safety.js +2 -2
- package/dist/core/decision-lattice.js +6 -6
- package/dist/core/doctor/codex-startup-config-repair.js +8 -3
- package/dist/core/doctor/doctor-codex-startup-repair.js +6 -141
- package/dist/core/feature-fixture-executor.js +71 -7
- package/dist/core/feature-fixture-runner.js +53 -12
- package/dist/core/feature-fixtures.js +47 -14
- package/dist/core/feature-registry.js +28 -27
- package/dist/core/harness-conflicts.js +18 -9
- package/dist/core/hooks-runtime/hook-io.js +8 -4
- package/dist/core/hooks-runtime/light-turn.js +70 -0
- package/dist/core/hooks-runtime/payload-signals.js +270 -0
- package/dist/core/hooks-runtime/team-digest.js +0 -1
- package/dist/core/hooks-runtime/tool-output-quarantine.js +93 -0
- package/dist/core/hooks-runtime.js +411 -258
- package/dist/core/init/skills.js +16 -30
- package/dist/core/init.js +144 -36
- package/dist/core/managed-assets/managed-assets-manifest.js +417 -10
- package/dist/core/mission.js +24 -1
- package/dist/core/pipeline-internals/runtime-core.js +570 -177
- package/dist/core/pipeline-internals/runtime-gates.js +174 -48
- package/dist/core/preflight/parallel-preflight-engine.js +50 -1
- package/dist/core/proof/route-proof-gate.js +7 -2
- package/dist/core/proof-field.js +1 -1
- package/dist/core/provider/model-router.js +33 -31
- package/dist/core/recallpulse/policy.js +12 -28
- package/dist/core/recallpulse.js +11 -6
- package/dist/core/release/npm-pack-proof.js +247 -0
- package/dist/core/release/package-dist-snapshot.js +151 -0
- package/dist/core/release/package-size-budget.js +5 -0
- package/dist/core/release/release-authorization-snapshot.js +115 -0
- package/dist/core/release/release-gate-affected-selector.js +14 -2
- package/dist/core/release/release-gate-cache-v2.js +30 -0
- package/dist/core/release/release-gate-contract.js +161 -0
- package/dist/core/release/release-gate-dag.js +1 -0
- package/dist/core/release/release-real-contract.js +90 -10
- package/dist/core/release-parallel-full-coverage.js +31 -143
- package/dist/core/research/claim-evidence-matrix.js +41 -6
- package/dist/core/research/experiment-plan.js +14 -10
- package/dist/core/research/falsification.js +9 -2
- package/dist/core/research/implementation-blueprint-densifier.js +82 -60
- package/dist/core/research/implementation-blueprint.js +32 -26
- package/dist/core/research/mock-result.js +122 -11
- package/dist/core/research/replication-pack.js +15 -8
- package/dist/core/research/research-adversarial-review.js +1068 -0
- package/dist/core/research/research-claim-builder.js +69 -17
- package/dist/core/research/research-claim-synthesizer.js +343 -0
- package/dist/core/research/research-cycle-runner.js +53 -3
- package/dist/core/research/research-falsification-runner.js +176 -0
- package/dist/core/research/research-final-reviewer.js +44 -125
- package/dist/core/research/research-realistic-report.js +14 -6
- package/dist/core/research/research-review-artifact-digest.js +66 -0
- package/dist/core/research/research-source-evidence.js +144 -0
- package/dist/core/research/research-source-layer-catalog.js +68 -0
- package/dist/core/research/research-source-ledger-merge.js +250 -12
- package/dist/core/research/research-source-shards.js +26 -70
- package/dist/core/research/research-stage-runner.js +237 -247
- package/dist/core/research/research-super-search.js +184 -0
- package/dist/core/research/research-synthesis-prompt.js +20 -1
- package/dist/core/research/research-synthesis-writer.js +86 -5
- package/dist/core/research/research-work-graph.js +25 -18
- package/dist/core/research/source-quality-report.js +21 -0
- package/dist/core/research.js +429 -280
- package/dist/core/routes/constants.js +1 -1
- package/dist/core/routes/dollar-manifest-lite.js +11 -11
- package/dist/core/routes.js +90 -63
- package/dist/core/runtime/task-profile.js +66 -0
- package/dist/core/runtime/verification-budget.js +12 -0
- package/dist/core/security/high-risk-contracts.js +6 -6
- package/dist/core/stop-gate/stop-gate-check.js +49 -12
- package/dist/core/subagents/agent-catalog.js +215 -0
- package/dist/core/subagents/model-policy.js +118 -0
- package/dist/core/subagents/naruto-help-contract.js +40 -0
- package/dist/core/subagents/official-subagent-config.js +488 -0
- package/dist/core/subagents/official-subagent-preparation.js +251 -0
- package/dist/core/subagents/official-subagent-prompt.js +137 -0
- package/dist/core/subagents/official-subagent-runner.js +129 -0
- package/dist/core/subagents/subagent-evidence.js +663 -0
- package/dist/core/subagents/terminology.js +16 -0
- package/dist/core/subagents/thread-budget.js +21 -0
- package/dist/core/subagents/triwiki-attention.js +65 -0
- package/dist/core/super-search/runtime-helpers.js +173 -19
- package/dist/core/super-search/runtime.js +140 -15
- package/dist/core/super-search/source-records.js +49 -8
- package/dist/core/team-review-policy.js +15 -0
- package/dist/core/triwiki/triwiki-module-card.js +1 -1
- package/dist/core/triwiki-wrongness/wrongness-ledger.js +9 -2
- package/dist/core/version-manager.js +51 -1
- package/dist/core/version.js +1 -1
- package/dist/core/work-order-ledger.js +40 -1
- package/dist/core/zellij/zellij-fake-adapter.js +3 -1
- package/dist/core/zellij/zellij-launcher.js +37 -8
- package/dist/core/zellij/zellij-layout-builder.js +14 -5
- package/dist/core/zellij/zellij-official-subagent-activity.js +477 -0
- package/dist/core/zellij/zellij-official-subagent-telemetry.js +264 -0
- package/dist/core/zellij/zellij-slot-pane-renderer.js +17 -5
- package/dist/core/zellij/zellij-slot-telemetry.js +15 -3
- package/dist/core/zellij/zellij-ui-mode.js +1 -1
- package/dist/core/zellij/zellij-viewport-binder.js +3 -0
- package/dist/scripts/agent-role-config-repair-check.js +14 -16
- package/dist/scripts/architecture-guard-check.js +8 -1
- package/dist/scripts/check-route-modularity.js +0 -1
- package/dist/scripts/check-ts-contracts.js +1 -1
- package/dist/scripts/codex-control-all-pipelines-check.js +7 -3
- package/dist/scripts/codex-control-tool-output-continuity-audit-check.js +27 -0
- package/dist/scripts/codex-native-agent-role-content-check.js +15 -7
- package/dist/scripts/codex-native-repair-transaction-check.js +3 -1
- package/dist/scripts/codex-sdk-all-pipelines-check.js +7 -4
- package/dist/scripts/codex-sdk-research-pipeline-check.js +30 -8
- package/dist/scripts/db-route-materialization-check.js +33 -0
- package/dist/scripts/docs-truthfulness-check.js +3 -1
- package/dist/scripts/doctor-codex-startup-repair-check.js +12 -15
- package/dist/scripts/doctor-fix-production-blackbox.js +12 -2
- package/dist/scripts/doctor-startup-config-repair-blackbox.js +8 -2
- package/dist/scripts/doctor-startup-config-repair-check.js +12 -2
- package/dist/scripts/install-update-preserves-config-check.js +6 -1
- package/dist/scripts/mad-sks-app-ui-no-mutation-check.js +0 -1
- package/dist/scripts/managed-role-manifest-parity-check.js +5 -4
- package/dist/scripts/naruto-codex-e2e-check.js +14 -7
- package/dist/scripts/naruto-shadow-clone-swarm-check.js +4 -201
- package/dist/scripts/npm-publish-performance-check.js +20 -12
- package/dist/scripts/official-subagent-workflow-check.js +145 -0
- package/dist/scripts/package-published-contract-check.js +6 -29
- package/dist/scripts/packlist-performance-check.js +17 -3
- package/dist/scripts/parallel-verification-engine-check.js +2 -2
- package/dist/scripts/prepublish-release-check-or-fast.js +23 -86
- package/dist/scripts/release-affected-selector-check.js +74 -1
- package/dist/scripts/release-check-stamp.js +153 -248
- package/dist/scripts/release-dag-full-coverage-check.js +7 -15
- package/dist/scripts/release-dynamic-presets-check.js +2 -1
- package/dist/scripts/release-gate-dag-runner-check.js +0 -1
- package/dist/scripts/release-gate-dag-runner.js +12 -1
- package/dist/scripts/release-gate-existence-audit.js +1 -2
- package/dist/scripts/release-parallel-full-coverage-check.js +12 -6
- package/dist/scripts/release-parallel-speed-budget-check.js +18 -2
- package/dist/scripts/release-real-check.js +26 -4
- package/dist/scripts/release-registry-check.js +61 -16
- package/dist/scripts/research-blueprint-densifier-check.js +2 -2
- package/dist/scripts/research-real-cycle-no-legacy-final-md-check.js +11 -7
- package/dist/scripts/sizecheck.js +2 -2
- package/dist/scripts/sks-3-1-4-directive-check-lib.js +8 -2
- package/dist/scripts/sks-3-1-5-directive-check-lib.js +3 -2
- package/dist/scripts/sks-3-1-6-directive-check-lib.js +5 -3
- package/dist/scripts/sks-menubar-install-check.js +8 -0
- package/dist/scripts/trust-fixture-check.js +32 -10
- package/dist/scripts/wrongness-fixture-check.js +1 -1
- package/dist/scripts/zellij-layout-valid-check.js +5 -5
- package/dist/scripts/zellij-spawn-on-demand-layout-check.js +3 -3
- package/docs/demo.tape +1 -1
- package/infra-harness-gates.json +1486 -0
- package/package.json +13 -10
- package/release-gates.v2.json +4060 -0
- package/runtime-required-scripts.json +9 -0
- package/dist/commands/db.js +0 -6
- package/dist/core/commands/db-command.js +0 -146
- package/dist/core/research/prompt.js +0 -15
- package/dist/scripts/codex-control-tool-call-sequence-repair-check.js +0 -14
package/README.md
CHANGED
|
@@ -13,7 +13,7 @@ sneakoscope is a proof-first Codex trust layer for bounded agent workflows, sear
|
|
|
13
13
|
|
|
14
14
|
# Sneakoscope Codex
|
|
15
15
|
|
|
16
|
-
**The proof-first
|
|
16
|
+
**The proof-first workflow harness for Codex. Machine-verified completion, not vibes.**
|
|
17
17
|
|
|
18
18
|
[](https://www.npmjs.com/package/sneakoscope)
|
|
19
19
|
[](#requirements)
|
|
@@ -23,9 +23,9 @@ sneakoscope is a proof-first Codex trust layer for bounded agent workflows, sear
|
|
|
23
23
|
|
|
24
24
|
</div>
|
|
25
25
|
|
|
26
|
-
Sneakoscope Codex (`sks`) is a Codex CLI and Codex App harness for people who want parallel AI coding without losing proof. It gives Codex a simple front door,
|
|
26
|
+
Sneakoscope Codex (`sks`) is a Codex CLI and Codex App harness for people who want parallel AI coding without losing proof. It gives Codex a simple front door, an official subagent workflow, a local dashboard, TriWiki project memory, and release gates that separate machine evidence from LLM opinion.
|
|
27
27
|
|
|
28
|
-
Current release: SKS **6.1.
|
|
28
|
+
Current release: SKS **6.1.2**. `$Naruto` is the SKS alias for the Codex official subagent workflow. The parent runs on GPT-5.6 Sol Max, clear bounded subagents use GPT-5.6 Luna Max, and reasoning-sensitive work such as UI, review, debugging, planning, integration, security, database, and release judgment uses GPT-5.6 Sol Max. Official `SubagentStart`/`SubagentStop` events prove lifecycle only; successful completion additionally requires a structured parent summary with an explicit outcome for every thread. Preparation context alone is never completion proof. Normal non-Naruto Codex sessions continue to preserve explicit user model choices. See [CHANGELOG.md](CHANGELOG.md).
|
|
29
29
|
|
|
30
30
|
## Install
|
|
31
31
|
|
|
@@ -42,19 +42,33 @@ npm i -g sneakoscope
|
|
|
42
42
|
sks doctor --fix
|
|
43
43
|
```
|
|
44
44
|
|
|
45
|
+
The SKS menu bar shows the installed Codex CLI version and latest known version. An `⬆` marker appears when an update is available; **Update Codex CLI Now** uses native `codex update` when the selected CLI advertises it, otherwise it verifies the installation provenance and invokes the matching official standalone-installer, npm-global, or Homebrew-cask update method. If the method cannot be verified, it fails closed instead of guessing. This is an explicit global tool mutation. **Run sks doctor --fix** performs the global-only menu repair flow without treating the user's home directory as a project.
|
|
46
|
+
|
|
45
47
|
## The Front Door
|
|
46
48
|
|
|
47
49
|
| Command | What it does |
|
|
48
50
|
| --- | --- |
|
|
49
51
|
| `$Plan "task"` | Planning only. Writes `.sneakoscope/plans/<slug>.md`; no code edits. |
|
|
50
|
-
| `$Work` | Executes the latest plan through evidence-gated SKS work. |
|
|
51
|
-
| `$Swarm "task"` |
|
|
52
|
+
| Explicit `$Work` | Executes the latest plan through evidence-gated SKS work. Ordinary prose containing “work” is not treated as this alias. |
|
|
53
|
+
| `$Swarm "task"` | Compatibility alias for the Naruto Codex official subagent workflow. |
|
|
52
54
|
| `$Team "task"` | Deprecated v5 compatibility alias. New execution redirects to `$Naruto`; legacy Team observe/watch commands remain available for old missions. |
|
|
53
55
|
| `$MAD-SKS` / `sks mad-sks` | Single high-risk MAD route for scoped permission widening plus SQL-plane execution, including read-back proof and profile closure. |
|
|
54
56
|
| `$MAD-DB` / `sks mad-db` | Deprecated compatibility alias. Translates to `$MAD-SKS` sql-plane commands for one release. |
|
|
55
57
|
| `$Review` / `sks review --staged` | Reviews diffs with `evidence: machine` findings sorted above `evidence: llm`. |
|
|
56
58
|
| `sks ui` | Opens the local live dashboard at `http://127.0.0.1:4477`. |
|
|
57
59
|
|
|
60
|
+
## Naruto In 6.1.2
|
|
61
|
+
|
|
62
|
+
`$Naruto` and `sks naruto run "task" --agents 8 --max-threads 12` use Codex official subagents. The parent is GPT-5.6 Sol Max; clear bounded `worker`/exploration slices use GPT-5.6 Luna Max; UI, testing, debugging, architecture, integration, security, database, research, release, and other judgment-sensitive work use narrow GPT-5.6 Sol Max custom specialists.
|
|
63
|
+
|
|
64
|
+
Fresh SKS-owned project config uses `max_threads = 12`, `max_depth = 1`, `job_max_runtime_seconds = 1200`, and `interrupt_message = true`. `max_depth = 1` means subagents cannot spawn nested subagents. Explicit user limits are preserved, and larger requests run in waves.
|
|
65
|
+
|
|
66
|
+
Gates are task-profile aware: greetings and answer-only turns create no mission gate; tiny work gets minimal verification; parallel work gets scoped ownership and verification; high-risk work keeps the full safety gates. `SubagentStart`/`SubagentStop` prove lifecycle only. Completion also requires `subagent-parent-summary.json` with one trustworthy structured outcome per thread, correlated with `subagent-events.jsonl` and `subagent-evidence.json`.
|
|
67
|
+
|
|
68
|
+
SKS installs sixteen narrow project custom agents and recommends only the roles relevant to the task. Automatic fan-out is one child by default, two for explicit parallel work or independent risk domains, and three only for critical multi-domain work; explicit `--agents N` is still supported. In CLI Zellij mode, the right side is a live observability surface rather than a static lane reservation: one monitor plus one viewport by default (maximum three) shows official thread role/model, redacted live phase/task/file updates from exact-agent Codex 0.144.1+ rollouts, `running`, `verifying`, and trustworthy parent-verdict completion/failure states. Rollout activity is display-only and never completion proof.
|
|
69
|
+
|
|
70
|
+
`--clones` and `workers` remain one-release spelling aliases for official subagent behavior. The historical Naruto process swarm and its environment opt-in are removed; legacy backend, scheduler, pool, and model flags fail closed.
|
|
71
|
+
|
|
58
72
|
## Why Not Just An LLM Reviewer?
|
|
59
73
|
|
|
60
74
|
| Question | Oracle-style LLM review | SKS gate/review |
|
|
@@ -62,14 +76,14 @@ sks doctor --fix
|
|
|
62
76
|
| Did tests/typecheck fail? | Another model may say so. | Machine check output is tagged `evidence: machine`. |
|
|
63
77
|
| Are findings ranked? | Usually one blended opinion. | Machine evidence sorts before LLM findings. |
|
|
64
78
|
| Can work stop? | The model decides. | Stop gates, Completion Proof, and Honest Mode decide. |
|
|
65
|
-
| Can I
|
|
79
|
+
| Can I inspect agent-thread progress? | Usually no runtime UI. | `sks ui` plus the official Codex subagent/thread surfaces. |
|
|
66
80
|
|
|
67
81
|
## Dashboard
|
|
68
82
|
|
|
69
83
|
`sks ui` serves a dependency-free localhost dashboard with:
|
|
70
84
|
|
|
71
85
|
- mission, route, elapsed time, and gate badge
|
|
72
|
-
- live
|
|
86
|
+
- live official subagent thread grid with role/model badge, progress, and current task
|
|
73
87
|
- run/verify/queue/done/fail counters
|
|
74
88
|
- recent mission events
|
|
75
89
|
- current gate checklist
|
|
@@ -84,19 +98,20 @@ The reproducible VHS script lives at [docs/demo.tape](docs/demo.tape).
|
|
|
84
98
|
vhs docs/demo.tape
|
|
85
99
|
```
|
|
86
100
|
|
|
87
|
-
It shows the
|
|
101
|
+
It shows the current quickstart flow: one-line install, `$Plan`, `sks review`, `sks ui`, and an official `$Naruto` subagent run.
|
|
88
102
|
|
|
89
103
|
## Proof Surfaces
|
|
90
104
|
|
|
91
|
-
-
|
|
105
|
+
- Official subagents: `sks naruto run "task" --agents 14 --max-threads 12 --json`
|
|
92
106
|
- Review report: `.sneakoscope/reports/review-report.json`
|
|
93
107
|
- Harness benchmark: `.sneakoscope/reports/harness-benchmark.json`
|
|
94
108
|
- Project memory: `sks memory build`
|
|
95
109
|
- Codebase index/pack for LLM context: `sks wiki refresh --code`, `sks wiki validate --json` (code-pack freshness)
|
|
96
110
|
- Native capability repair: `sks doctor --fix` (imagegen/Computer Use/Browser Use), `.sneakoscope/reports/native-capability-readiness.json`
|
|
111
|
+
- codex-lb continuity: `sks codex-lb status --json` verifies the selected proxy's unauthenticated `/health` `X-App-Version`. Tool-heavy continuation requires codex-lb `1.21.0-beta.3` or later; older or unverified deployments block setup, doctor, and launch instead of silently falling back.
|
|
97
112
|
- Agent bridge for any agent system: `sks mcp-server`, `sks agent-bridge setup`, `SKS_AGENT_MODE=1` — see [docs/AGENT-BRIDGE.md](docs/AGENT-BRIDGE.md)
|
|
98
|
-
- Release gates: `
|
|
99
|
-
-
|
|
113
|
+
- Release gates: `npm run release:check:affected` for ordinary change-aware verification and `npm run release:check:confidence` for the final local confidence pass.
|
|
114
|
+
- Release preparation handoff: run `npm run typecheck --silent`, one `npm run build:clean --silent`, focused tests for the changed surfaces, `npm run release:check:affected`, `npm run release:check:confidence`, and finally `npm pack --dry-run --ignore-scripts --json`. Publish authorization and publication remain a distinct repository-maintainer workflow.
|
|
100
115
|
- Release readiness notes: [docs/release-readiness.md](docs/release-readiness.md) and [CHANGELOG.md](CHANGELOG.md)
|
|
101
116
|
- Image generation review routes require Codex App `$imagegen`/`gpt-image-2` evidence with recorded output hashes; direct API fallback and mock fixtures do not satisfy full route gates.
|
|
102
117
|
|
|
@@ -111,6 +126,8 @@ It shows the v5 flow: one-line install, `$Plan`, `$Work`/`$Swarm`, `sks review`,
|
|
|
111
126
|
- Update installs always rebuild the companion with the newly installed SKS package, preventing a previous-version updater from restoring a stale menu binary.
|
|
112
127
|
- The menubar dropdown's `View Last Log` item opens the most recent background action's log file, so you don't need to keep a Terminal window open to see command output.
|
|
113
128
|
- `sks menubar status --json` reports a `codex_sync` object with `bundle_id`, `codex_running`, and `icon_visible_expected` to show Codex-lifecycle detection state.
|
|
129
|
+
- The menu displays the installed Codex CLI version, adds an `⬆` status icon when `sks codex update-status` sees a newer release, runs the official self-updater through `Update Codex CLI Now`, and exposes `Run sks doctor --fix` as a background repair action.
|
|
130
|
+
- If Codex shows `[No tool output found for custom tool call ...]`, SKS blocks reuse of that structurally ambiguous thread. Upgrade codex-lb (or explicitly run `sks codex-lb use-oauth`), inspect possible side effects, then continue the persisted mission in a fresh Codex task. SKS never rewrites session JSONL or fabricates a successful tool output.
|
|
114
131
|
- Zellij optional but recommended for terminal worker panes
|
|
115
132
|
|
|
116
133
|
## License
|
package/dist/bin/fast-inline.js
CHANGED
|
@@ -32,6 +32,21 @@ function doctorJsonFastInline() {
|
|
|
32
32
|
hook_evidence_policy: 'unknown-do-not-count',
|
|
33
33
|
agent_role_strategy: 'message-role'
|
|
34
34
|
},
|
|
35
|
+
zellij_readiness: {
|
|
36
|
+
schema: 'sks.zellij-readiness.v1',
|
|
37
|
+
binary: 'zellij',
|
|
38
|
+
status: 'skipped',
|
|
39
|
+
min_version: '0.41.0',
|
|
40
|
+
version: null,
|
|
41
|
+
required_for: ['sks --mad', 'interactive lane UI'],
|
|
42
|
+
layout_proof: 'unavailable',
|
|
43
|
+
pane_proof: 'unavailable',
|
|
44
|
+
screen_proof: 'unavailable',
|
|
45
|
+
tmux_removed_runtime: true,
|
|
46
|
+
mad_ready: false,
|
|
47
|
+
cli_ready: false,
|
|
48
|
+
ready_for_interactive_runtime: false
|
|
49
|
+
},
|
|
35
50
|
codex: { bin: null, version: null, available: null, skipped: true, reason: 'fast_readonly_json' },
|
|
36
51
|
repair: {
|
|
37
52
|
setup: null,
|
|
@@ -42,15 +57,9 @@ function doctorJsonFastInline() {
|
|
|
42
57
|
warnings: ['fast_readonly_doctor_skipped_optional_deep_diagnostics']
|
|
43
58
|
}, null, 2)}\n`);
|
|
44
59
|
}
|
|
45
|
-
function narutoHelpJsonFastInline() {
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
ok: true,
|
|
49
|
-
action: 'help',
|
|
50
|
-
fast_path: true,
|
|
51
|
-
usage: 'sks naruto run "<prompt>" [--json] [--mock] [--readonly] [--clones N]',
|
|
52
|
-
commands: ['help', 'status', 'dashboard', 'workers', 'proof', 'run']
|
|
53
|
-
}, null, 2)}\n`);
|
|
60
|
+
async function narutoHelpJsonFastInline() {
|
|
61
|
+
const { buildNarutoHelpResult } = await import('../core/subagents/naruto-help-contract.js');
|
|
62
|
+
process.stdout.write(`${JSON.stringify(buildNarutoHelpResult(), null, 2)}\n`);
|
|
54
63
|
}
|
|
55
64
|
async function hookUserPromptSubmitPerfInline() {
|
|
56
65
|
const raw = await readStdinInline();
|
package/dist/bin/sks-dispatch.js
CHANGED
|
@@ -39,9 +39,9 @@ async function runSks(args) {
|
|
|
39
39
|
const { hookDaemonInline } = await import('../core/daemon/sksd-hook-dispatch.js');
|
|
40
40
|
await hookDaemonInline(args[1]);
|
|
41
41
|
}
|
|
42
|
-
else if (args[0] === 'naruto' &&
|
|
42
|
+
else if (args.length === 3 && args[0] === 'naruto' && args[1] === 'help' && args[2] === '--json') {
|
|
43
43
|
const { narutoHelpJsonFastInline } = await import('./fast-inline.js');
|
|
44
|
-
narutoHelpJsonFastInline();
|
|
44
|
+
await narutoHelpJsonFastInline();
|
|
45
45
|
}
|
|
46
46
|
else if (args[0] === 'help' || args[0] === '--help' || args[0] === '-h') {
|
|
47
47
|
if (args.length > 1) {
|
package/dist/cli/args.js
CHANGED
|
@@ -20,7 +20,7 @@ export const COMMAND_MANIFEST_LITE = [
|
|
|
20
20
|
{ name: 'wizard', summary: 'Open setup wizard help', maturity: 'stable' },
|
|
21
21
|
{ name: 'usage', summary: 'Show focused usage topic', maturity: 'stable', readonly: true, allowedDuringActiveRoute: true, diagnostic: true },
|
|
22
22
|
{ name: 'quickstart', summary: 'Show quickstart flow', maturity: 'stable' },
|
|
23
|
-
{ name: 'setup', summary: 'Initialize SKS state', maturity: 'stable' },
|
|
23
|
+
{ name: 'setup', summary: 'Initialize SKS state', maturity: 'stable', skipMigrationGate: true },
|
|
24
24
|
{ name: 'bootstrap', summary: 'Initialize SKS project files', maturity: 'stable' },
|
|
25
25
|
{ name: 'init', summary: 'Initialize local control surface', maturity: 'stable' },
|
|
26
26
|
{ name: 'deps', summary: 'Check local dependencies', maturity: 'stable' },
|
|
@@ -55,7 +55,7 @@ export const COMMAND_MANIFEST_LITE = [
|
|
|
55
55
|
{ name: 'team', summary: 'Deprecated alias. New execution redirects to Naruto; legacy observe/watch remains.', maturity: 'beta', mutatesRouteState: true, deprecated: true },
|
|
56
56
|
{ name: 'agent', summary: 'Run native multi-session agent missions', maturity: 'beta', mutatesRouteState: true },
|
|
57
57
|
{ name: 'with-local-llm', summary: 'Enable or inspect local Ollama worker backend', maturity: 'beta' },
|
|
58
|
-
{ name: 'naruto', summary: 'Run $Naruto
|
|
58
|
+
{ name: 'naruto', summary: 'Run the $Naruto Codex official subagent workflow', maturity: 'labs', mutatesRouteState: true },
|
|
59
59
|
{ name: 'stop-gate', summary: 'Check canonical stop-gate resolution for a route/mission', maturity: 'beta', readonly: true, skipMigrationGate: true, allowedDuringActiveRoute: true, diagnostic: true },
|
|
60
60
|
{ name: 'route', summary: 'Inspect or close active route state', maturity: 'beta', skipMigrationGate: true, allowedDuringActiveRoute: true, diagnostic: true },
|
|
61
61
|
{ name: 'loop', summary: 'Dynamic Loop Runtime: plan/run/status/proof loop graphs.', maturity: 'labs', mutatesRouteState: true },
|
|
@@ -90,7 +90,6 @@ export const COMMAND_MANIFEST_LITE = [
|
|
|
90
90
|
{ name: 'code-structure', summary: 'Scan source structure', maturity: 'labs' },
|
|
91
91
|
{ name: 'rust', summary: 'Inspect optional Rust accelerator status and smoke parity', maturity: 'beta' },
|
|
92
92
|
{ name: 'gx', summary: 'Render/validate GX cartridges', maturity: 'labs' },
|
|
93
|
-
{ name: 'db', summary: 'Inspect DB safety policy', maturity: 'beta' },
|
|
94
93
|
{ name: 'eval', summary: 'Run eval reports', maturity: 'labs' },
|
|
95
94
|
{ name: 'harness', summary: 'Run harness fixtures', maturity: 'labs' },
|
|
96
95
|
{ name: 'wiki', summary: 'Manage TriWiki and image voxel ledgers', maturity: 'beta', skipMigrationGate: true, allowedDuringActiveRoute: true, diagnostic: true },
|
|
@@ -115,7 +115,7 @@ export const COMMANDS = {
|
|
|
115
115
|
wizard: entry('stable', 'Open setup wizard help', 'dist/core/commands/basic-cli.js', basicNoArgs('quickstartCommand')),
|
|
116
116
|
usage: readOnly(entry('stable', 'Show focused usage topic', 'dist/core/commands/basic-cli.js', basicArgs('usageCommand'))),
|
|
117
117
|
quickstart: entry('stable', 'Show quickstart flow', 'dist/core/commands/basic-cli.js', basicNoArgs('quickstartCommand')),
|
|
118
|
-
setup: entry('stable', 'Initialize SKS state', 'dist/core/commands/basic-cli.js', basicArgs('setupCommand')),
|
|
118
|
+
setup: skipMigrationGate(entry('stable', 'Initialize SKS state', 'dist/core/commands/basic-cli.js', basicArgs('setupCommand'))),
|
|
119
119
|
bootstrap: entry('stable', 'Initialize SKS project files', 'dist/core/commands/basic-cli.js', basicArgs('bootstrapCommand')),
|
|
120
120
|
init: entry('stable', 'Initialize local control surface', 'dist/core/commands/basic-cli.js', basicArgs('initCommand')),
|
|
121
121
|
deps: entry('stable', 'Check local dependencies', 'dist/core/commands/basic-cli.js', subcommand(() => import(basicModule), 'depsCommand', 'dist/core/commands/basic-cli.js', 'check')),
|
|
@@ -150,7 +150,7 @@ export const COMMANDS = {
|
|
|
150
150
|
team: routeStateMutator(entry('beta', 'Deprecated alias. New execution redirects to Naruto; legacy observe/watch remains.', 'dist/core/commands/team-command.js', argsCommand(() => import('../core/commands/team-command.js'), 'team', 'dist/core/commands/team-command.js')), ['team-gate.json', 'naruto-gate.json']),
|
|
151
151
|
agent: routeStateMutator(entry('beta', 'Run native multi-session agent missions', 'dist/core/commands/agent-command.js', argsCommand(() => import('../core/commands/agent-command.js'), 'agentCommand', 'dist/core/commands/agent-command.js')), ['agent-gate.json']),
|
|
152
152
|
'with-local-llm': entry('beta', 'Enable or inspect local Ollama worker backend', 'dist/core/commands/local-model-command.js', argsCommand(() => import('../core/commands/local-model-command.js'), 'localModelCommand', 'dist/core/commands/local-model-command.js')),
|
|
153
|
-
naruto: routeStateMutator(entry('labs', 'Run $Naruto
|
|
153
|
+
naruto: routeStateMutator(entry('labs', 'Run the $Naruto Codex official subagent workflow', 'dist/core/commands/naruto-command.js', argsCommand(() => import('../core/commands/naruto-command.js'), 'narutoCommand', 'dist/core/commands/naruto-command.js')), ['naruto-gate.json', 'stop-gate.json']),
|
|
154
154
|
'stop-gate': readOnly(entry('beta', 'Check canonical stop-gate resolution for a route/mission', 'dist/core/commands/stop-gate-command.js', commandArgsCommand(() => import('../core/commands/stop-gate-command.js'), 'stopGateCommand', 'dist/core/commands/stop-gate-command.js'))),
|
|
155
155
|
route: activeRouteDiagnostic(entry('beta', 'Inspect or close active route state', 'dist/core/commands/route-command.js', subcommand(() => import('../core/commands/route-command.js'), 'routeCommand', 'dist/core/commands/route-command.js', 'status'))),
|
|
156
156
|
loop: routeStateMutator(entry('labs', 'Dynamic Loop Runtime: plan/run/status/proof loop graphs.', 'dist/core/commands/loop-command.js', subcommand(() => import('../core/commands/loop-command.js'), 'loopCommand', 'dist/core/commands/loop-command.js', 'help')), ['loop-graph-proof.json']),
|
|
@@ -185,7 +185,6 @@ export const COMMANDS = {
|
|
|
185
185
|
'code-structure': entry('labs', 'Scan source structure', 'dist/core/commands/code-structure-command.js', subcommand(() => import('../core/commands/code-structure-command.js'), 'codeStructureCommand', 'dist/core/commands/code-structure-command.js', 'scan')),
|
|
186
186
|
rust: entry('beta', 'Inspect optional Rust accelerator status and smoke parity', 'dist/commands/rust.js', directCommand(() => import('../commands/rust.js'), 'dist/commands/rust.js')),
|
|
187
187
|
gx: entry('labs', 'Render/validate GX cartridges', 'dist/core/commands/gx-command.js', subcommand(() => import('../core/commands/gx-command.js'), 'gxCommand', 'dist/core/commands/gx-command.js', 'validate')),
|
|
188
|
-
db: entry('beta', 'Inspect DB safety policy', 'dist/core/commands/db-command.js', subcommand(() => import('../core/commands/db-command.js'), 'dbCommand', 'dist/core/commands/db-command.js', 'policy')),
|
|
189
188
|
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')),
|
|
190
189
|
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')),
|
|
191
190
|
wiki: activeRouteDiagnostic(entry('beta', 'Manage TriWiki and image voxel ledgers', 'dist/commands/wiki.js', directCommand(() => import('../commands/wiki.js'), 'dist/commands/wiki.js'))),
|
|
@@ -196,7 +195,7 @@ export const COMMANDS = {
|
|
|
196
195
|
'all-features': entry('beta', 'Run all-features selftest', 'dist/commands/all-features.js', directCommand(() => import('../commands/all-features.js'), 'dist/commands/all-features.js')),
|
|
197
196
|
perf: entry('beta', 'Run performance checks', 'dist/commands/perf.js', directCommand(() => import('../commands/perf.js'), 'dist/commands/perf.js')),
|
|
198
197
|
bench: entry('beta', 'Run core trust-kernel benchmark budgets', 'dist/core/commands/bench-command.js', argsCommand(() => import('../core/commands/bench-command.js'), 'benchCommand', 'dist/core/commands/bench-command.js')),
|
|
199
|
-
'mcp-server': entry('beta', 'Run a stdio MCP server exposing SKS commands as tools for
|
|
198
|
+
'mcp-server': entry('beta', 'Run a stdio MCP server exposing SKS commands as tools for MCP-capable agent hosts', 'dist/core/commands/mcp-server-command.js', argsCommand(() => import('../core/commands/mcp-server-command.js'), 'mcpServerCommand', 'dist/core/commands/mcp-server-command.js'), {
|
|
200
199
|
skipMigrationGate: true,
|
|
201
200
|
allowedDuringActiveRoute: true,
|
|
202
201
|
activeRoutePolicy: 'always'
|
package/dist/cli/help-fast.js
CHANGED
|
@@ -8,7 +8,7 @@ SNEAKOSCOPE CODEX v${PACKAGE_VERSION}
|
|
|
8
8
|
|
|
9
9
|
$Plan "task" plan only; writes .sneakoscope/plans, no code edits
|
|
10
10
|
$Work execute the latest plan with evidence gates
|
|
11
|
-
$Swarm "task"
|
|
11
|
+
$Swarm "task" Naruto alias for the Codex official subagent workflow
|
|
12
12
|
|
|
13
13
|
Local surfaces
|
|
14
14
|
|