sneakoscope 0.6.70 → 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 +20 -11
- package/package.json +6 -3
- package/src/cli/main.mjs +162 -1576
- package/src/cli/maintenance-commands.mjs +1592 -0
- package/src/core/artifact-schemas.mjs +244 -0
- package/src/core/cmux-ui.mjs +172 -15
- 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 +104 -11
- 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,12 @@ 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`, `$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
|
+
| From-Chat-IMG | Turns chat screenshots plus original attachments into source-bound work orders, then requires scoped QA evidence before completion. |
|
|
49
50
|
| QA loop | Dogfoods UI/API behavior with safety gates, Browser/Computer evidence, safe fixes, and rechecks. |
|
|
50
|
-
|
|
|
51
|
-
| TriWiki | Maintains `.sneakoscope/wiki/context-pack.json` as the context SSOT with `attention.use_first
|
|
51
|
+
| Goal | Bridges SKS pipeline state to Codex native persisted `/goal` create, pause, resume, and clear workflows. |
|
|
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`. |
|
|
52
53
|
| Context7 | Requires current docs for external packages, APIs, MCPs, SDKs, and framework/runtime behavior when correctness depends on current guidance. |
|
|
53
54
|
| DB safety | Treats SQL, migrations, Supabase, RLS, and destructive operations as high risk. |
|
|
54
55
|
| Release hygiene | Checks versioning, changelog, package contents, tarball size, syntax, selftests, and dry-run publishing. |
|
|
@@ -166,7 +167,7 @@ sks cmux check
|
|
|
166
167
|
sks cmux status --once
|
|
167
168
|
```
|
|
168
169
|
|
|
169
|
-
`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.
|
|
170
171
|
|
|
171
172
|
### MAD cmux Workspace
|
|
172
173
|
|
|
@@ -194,23 +195,28 @@ sks team "implement this feature" executor:3 reviewer:1
|
|
|
194
195
|
sks team watch latest
|
|
195
196
|
sks team lane latest --agent analysis_scout_1 --follow
|
|
196
197
|
sks team status latest
|
|
198
|
+
sks team dashboard latest
|
|
197
199
|
sks team log latest
|
|
198
200
|
```
|
|
199
201
|
|
|
200
|
-
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.
|
|
201
203
|
|
|
202
|
-
### QA,
|
|
204
|
+
### QA, Goal, Research, DB, Wiki, GX
|
|
203
205
|
|
|
204
206
|
```sh
|
|
205
207
|
sks qa-loop prepare "http://localhost:3000"
|
|
206
208
|
sks qa-loop run latest --max-cycles 2
|
|
207
|
-
sks
|
|
209
|
+
sks goal create "persist this migration workflow"
|
|
208
210
|
sks research prepare "evaluate this approach"
|
|
209
211
|
sks db scan --json
|
|
210
212
|
sks wiki refresh
|
|
213
|
+
sks wiki sweep latest --json
|
|
211
214
|
sks wiki validate .sneakoscope/wiki/context-pack.json
|
|
212
215
|
sks gx init homepage
|
|
213
216
|
sks gx render homepage --format html
|
|
217
|
+
sks validate-artifacts latest --json
|
|
218
|
+
sks perf run --json
|
|
219
|
+
sks code-structure scan --json
|
|
214
220
|
```
|
|
215
221
|
|
|
216
222
|
## Codex App Usage
|
|
@@ -234,7 +240,7 @@ Then open Codex App and use prompt commands directly in the chat. Examples:
|
|
|
234
240
|
$Team implement the checkout fix and verify it
|
|
235
241
|
$DFix change this label and spacing only
|
|
236
242
|
$QA-LOOP dogfood localhost:3000 and fix safe issues
|
|
237
|
-
$
|
|
243
|
+
$Goal persist this migration workflow with native /goal continuation
|
|
238
244
|
$Wiki refresh and validate the context pack
|
|
239
245
|
$DB inspect this migration for destructive risk
|
|
240
246
|
```
|
|
@@ -251,6 +257,8 @@ Generated app files include:
|
|
|
251
257
|
|
|
252
258
|
Use `sks dollar-commands` to confirm that terminal discovery and Codex App prompt commands agree.
|
|
253
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
|
+
|
|
254
262
|
## Prompt `$` Commands
|
|
255
263
|
|
|
256
264
|
Use these inside Codex App or another agent prompt. They are prompt commands, not terminal commands.
|
|
@@ -263,7 +271,7 @@ Use these inside Codex App or another agent prompt. They are prompt commands, no
|
|
|
263
271
|
| `$Answer` | You want an answer only and no implementation should start. |
|
|
264
272
|
| `$SKS` | You need setup, status, usage, or workflow help. |
|
|
265
273
|
| `$QA-LOOP` | You want UI/API dogfooding, safe fixes, and rechecks. |
|
|
266
|
-
| `$
|
|
274
|
+
| `$Goal` | You want Codex native persisted `/goal` continuation for a workflow. |
|
|
267
275
|
| `$Research` | You need frontier-style research with hypotheses and falsification. |
|
|
268
276
|
| `$AutoResearch` | You want iterative improve/test/keep-or-discard optimization. |
|
|
269
277
|
| `$DB` | You need database, Supabase, migration, SQL, or MCP safety checks. |
|
|
@@ -305,6 +313,7 @@ $Team implement the requested change, update docs if needed, and verify with the
|
|
|
305
313
|
```
|
|
306
314
|
|
|
307
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.
|
|
308
317
|
|
|
309
318
|
### Dogfood A UI Or API
|
|
310
319
|
|
|
@@ -357,7 +366,7 @@ sks deps install cmux
|
|
|
357
366
|
sks cmux check
|
|
358
367
|
```
|
|
359
368
|
|
|
360
|
-
`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.
|
|
361
370
|
|
|
362
371
|
### Codex App tools are missing
|
|
363
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",
|