sneakoscope 0.6.72 → 0.6.76
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 +18 -10
- package/package.json +6 -3
- package/src/cli/main.mjs +154 -1576
- package/src/cli/maintenance-commands.mjs +1592 -0
- package/src/core/artifact-schemas.mjs +244 -0
- package/src/core/cmux-ui.mjs +91 -13
- package/src/core/code-structure.mjs +102 -0
- package/src/core/db-safety.mjs +5 -4
- package/src/core/decision-contract.mjs +3 -3
- package/src/core/dogfood-loop.mjs +40 -0
- package/src/core/effort-orchestrator.mjs +99 -0
- package/src/core/evaluation.mjs +2 -2
- package/src/core/from-chat-img-forensics.mjs +108 -0
- package/src/core/fsx.mjs +1 -1
- package/src/core/goal-workflow.mjs +87 -0
- package/src/core/hooks-runtime.mjs +21 -6
- package/src/core/init.mjs +17 -10
- package/src/core/memory-governor.mjs +156 -0
- package/src/core/mission.mjs +2 -2
- package/src/core/mistake-memory.mjs +82 -0
- package/src/core/no-question-guard.mjs +3 -3
- package/src/core/perf-bench.mjs +60 -0
- package/src/core/pipeline.mjs +54 -53
- package/src/core/prompt-context-builder.mjs +38 -0
- package/src/core/qa-loop.mjs +1 -1
- package/src/core/questions.mjs +8 -8
- package/src/core/retention.mjs +4 -4
- package/src/core/routes.mjs +31 -19
- package/src/core/skill-forge.mjs +114 -0
- package/src/core/team-dashboard-renderer.mjs +98 -0
- package/src/core/work-order-ledger.mjs +57 -0
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|

|
|
4
4
|
|
|
5
|
-
Sneakoscope Codex (`sks`, displayed as `ㅅㅋㅅ`) is a Codex CLI/App harness for repeatable agent workflows. It adds terminal commands, Codex App `$` prompt commands, cmux-native CLI workspaces, Team/
|
|
5
|
+
Sneakoscope Codex (`sks`, displayed as `ㅅㅋㅅ`) is a Codex CLI/App harness for repeatable agent workflows. It adds terminal commands, Codex App `$` prompt commands, cmux-native CLI workspaces, Team/Goal/QA/Research routes, Context7 evidence checks, DB safety, TriWiki context tracking, Honest Mode, and release-readiness gates.
|
|
6
6
|
|
|
7
7
|
## Quick Start
|
|
8
8
|
|
|
@@ -44,11 +44,11 @@ sks selftest --mock
|
|
|
44
44
|
| Area | What it does |
|
|
45
45
|
| --- | --- |
|
|
46
46
|
| CLI runtime | `sks`, `sks cmux`, and `sks --mad` open Codex CLI in a cmux workspace. |
|
|
47
|
-
| Codex App commands | Installs generated skills so `$Team`, `$From-Chat-IMG`, `$DFix`, `$QA-LOOP`, `$
|
|
47
|
+
| Codex App commands | Installs generated skills so `$Team`, `$From-Chat-IMG`, `$DFix`, `$QA-LOOP`, `$Goal`, `$DB`, `$Wiki`, `$Help`, and related routes are visible in prompt workflows. |
|
|
48
48
|
| Team orchestration | Runs substantial work through ambiguity handling, scouts, TriWiki refresh, debate, runtime task graphs, worker inboxes, implementation, review, cleanup, reflection, and Honest Mode. |
|
|
49
49
|
| From-Chat-IMG | Turns chat screenshots plus original attachments into source-bound work orders, then requires scoped QA evidence before completion. |
|
|
50
50
|
| QA loop | Dogfoods UI/API behavior with safety gates, Browser/Computer evidence, safe fixes, and rechecks. |
|
|
51
|
-
|
|
|
51
|
+
| Goal | Bridges SKS pipeline state to Codex native persisted `/goal` create, pause, resume, and clear workflows. |
|
|
52
52
|
| TriWiki voxels | Maintains `.sneakoscope/wiki/context-pack.json` as the context SSOT with coordinate anchors, voxel metadata, `attention.use_first`, and `attention.hydrate_first`. |
|
|
53
53
|
| Context7 | Requires current docs for external packages, APIs, MCPs, SDKs, and framework/runtime behavior when correctness depends on current guidance. |
|
|
54
54
|
| DB safety | Treats SQL, migrations, Supabase, RLS, and destructive operations as high risk. |
|
|
@@ -167,7 +167,7 @@ sks cmux check
|
|
|
167
167
|
sks cmux status --once
|
|
168
168
|
```
|
|
169
169
|
|
|
170
|
-
`sks` opens a cmux workspace for Codex CLI when running in an interactive terminal. `sks cmux check` is diagnostic and prints readiness without starting a workspace.
|
|
170
|
+
`sks` opens a cmux workspace for Codex CLI when running in an interactive terminal. `sks cmux check` is diagnostic and prints readiness without starting a workspace. It checks both the cmux executable and the workspace socket so a stale app/socket is reported before launch.
|
|
171
171
|
|
|
172
172
|
### MAD cmux Workspace
|
|
173
173
|
|
|
@@ -195,23 +195,28 @@ sks team "implement this feature" executor:3 reviewer:1
|
|
|
195
195
|
sks team watch latest
|
|
196
196
|
sks team lane latest --agent analysis_scout_1 --follow
|
|
197
197
|
sks team status latest
|
|
198
|
+
sks team dashboard latest
|
|
198
199
|
sks team log latest
|
|
199
200
|
```
|
|
200
201
|
|
|
201
|
-
Team mode prepares the mission, records live events, compiles runtime tasks and worker inboxes, and opens cmux live lanes when cmux is available. `sks team
|
|
202
|
+
Team mode prepares the mission, records live events, compiles runtime tasks and worker inboxes, writes schema-backed effort/work-order/dashboard artifacts, and opens a named cmux Team workspace with split live lanes when cmux is available. `sks team dashboard` renders the cockpit panes for mission overview, agent lanes, task DAG, QA/dogfood, artifacts/evidence, and performance.
|
|
202
203
|
|
|
203
|
-
### QA,
|
|
204
|
+
### QA, Goal, Research, DB, Wiki, GX
|
|
204
205
|
|
|
205
206
|
```sh
|
|
206
207
|
sks qa-loop prepare "http://localhost:3000"
|
|
207
208
|
sks qa-loop run latest --max-cycles 2
|
|
208
|
-
sks
|
|
209
|
+
sks goal create "persist this migration workflow"
|
|
209
210
|
sks research prepare "evaluate this approach"
|
|
210
211
|
sks db scan --json
|
|
211
212
|
sks wiki refresh
|
|
213
|
+
sks wiki sweep latest --json
|
|
212
214
|
sks wiki validate .sneakoscope/wiki/context-pack.json
|
|
213
215
|
sks gx init homepage
|
|
214
216
|
sks gx render homepage --format html
|
|
217
|
+
sks validate-artifacts latest --json
|
|
218
|
+
sks perf run --json
|
|
219
|
+
sks code-structure scan --json
|
|
215
220
|
```
|
|
216
221
|
|
|
217
222
|
## Codex App Usage
|
|
@@ -235,7 +240,7 @@ Then open Codex App and use prompt commands directly in the chat. Examples:
|
|
|
235
240
|
$Team implement the checkout fix and verify it
|
|
236
241
|
$DFix change this label and spacing only
|
|
237
242
|
$QA-LOOP dogfood localhost:3000 and fix safe issues
|
|
238
|
-
$
|
|
243
|
+
$Goal persist this migration workflow with native /goal continuation
|
|
239
244
|
$Wiki refresh and validate the context pack
|
|
240
245
|
$DB inspect this migration for destructive risk
|
|
241
246
|
```
|
|
@@ -252,6 +257,8 @@ Generated app files include:
|
|
|
252
257
|
|
|
253
258
|
Use `sks dollar-commands` to confirm that terminal discovery and Codex App prompt commands agree.
|
|
254
259
|
|
|
260
|
+
TriWiki is intentionally sparse: `sks wiki sweep` records demote, soft-forget, archive, delete, promote-to-skill, and promote-to-rule candidates instead of injecting every old claim into future prompts. `sks code-structure scan` flags handwritten files above 1000/2000/3000-line thresholds so new logic can be extracted before command files become harder to maintain.
|
|
261
|
+
|
|
255
262
|
## Prompt `$` Commands
|
|
256
263
|
|
|
257
264
|
Use these inside Codex App or another agent prompt. They are prompt commands, not terminal commands.
|
|
@@ -264,7 +271,7 @@ Use these inside Codex App or another agent prompt. They are prompt commands, no
|
|
|
264
271
|
| `$Answer` | You want an answer only and no implementation should start. |
|
|
265
272
|
| `$SKS` | You need setup, status, usage, or workflow help. |
|
|
266
273
|
| `$QA-LOOP` | You want UI/API dogfooding, safe fixes, and rechecks. |
|
|
267
|
-
| `$
|
|
274
|
+
| `$Goal` | You want Codex native persisted `/goal` continuation for a workflow. |
|
|
268
275
|
| `$Research` | You need frontier-style research with hypotheses and falsification. |
|
|
269
276
|
| `$AutoResearch` | You want iterative improve/test/keep-or-discard optimization. |
|
|
270
277
|
| `$DB` | You need database, Supabase, migration, SQL, or MCP safety checks. |
|
|
@@ -306,6 +313,7 @@ $Team implement the requested change, update docs if needed, and verify with the
|
|
|
306
313
|
```
|
|
307
314
|
|
|
308
315
|
Team mode records a mission under `.sneakoscope/missions/`, keeps a live transcript, uses TriWiki context, and finishes with evidence and Honest Mode.
|
|
316
|
+
Every new Team mission now also writes `work-order-ledger.json`, `effort-decision.json`, and `team-dashboard-state.json`. Run `sks validate-artifacts latest` to check the schema gates before treating mission artifacts as completion evidence.
|
|
309
317
|
|
|
310
318
|
### Dogfood A UI Or API
|
|
311
319
|
|
|
@@ -358,7 +366,7 @@ sks deps install cmux
|
|
|
358
366
|
sks cmux check
|
|
359
367
|
```
|
|
360
368
|
|
|
361
|
-
`sks --mad` also attempts Homebrew installation or upgrade automatically on macOS when cmux is missing. If Homebrew reports the cask installed but the CLI still is not reachable, SKS checks the cmux app bundle paths directly, wakes the app,
|
|
369
|
+
`sks --mad` also attempts Homebrew installation or upgrade automatically on macOS when cmux is missing. If Homebrew reports the cask installed but the CLI still is not reachable, SKS checks the cmux app bundle paths directly, wakes the app, retries the socket, and reports `unhealthy` rather than `missing` when the executable exists but the app/socket is still broken.
|
|
362
370
|
|
|
363
371
|
### Codex App tools are missing
|
|
364
372
|
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "sneakoscope",
|
|
3
3
|
"displayName": "ㅅㅋㅅ",
|
|
4
|
-
"version": "0.6.
|
|
5
|
-
"description": "Sneakoscope Codex: database-safe Codex CLI/App harness with Team,
|
|
4
|
+
"version": "0.6.76",
|
|
5
|
+
"description": "Sneakoscope Codex: database-safe Codex CLI/App harness with Team, Goal, AutoResearch, TriWiki, and Honest Mode.",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"homepage": "https://github.com/mandarange/Sneakoscope-Codex#readme",
|
|
8
8
|
"repository": {
|
|
@@ -66,7 +66,7 @@
|
|
|
66
66
|
"subagents",
|
|
67
67
|
"agent-orchestration",
|
|
68
68
|
"prompt-router",
|
|
69
|
-
"
|
|
69
|
+
"goal",
|
|
70
70
|
"research",
|
|
71
71
|
"autoresearch",
|
|
72
72
|
"honest-mode",
|
|
@@ -78,6 +78,9 @@
|
|
|
78
78
|
"database-safe",
|
|
79
79
|
"supabase-mcp",
|
|
80
80
|
"bounded-memory",
|
|
81
|
+
"intentional-forgetting",
|
|
82
|
+
"skill-forge",
|
|
83
|
+
"code-structure",
|
|
81
84
|
"storage-safe",
|
|
82
85
|
"rust-optional",
|
|
83
86
|
"supabase",
|