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 CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  ![](https://github.com/mandarange/Sneakoscope-Codex/raw/dev/docs/assets/sneakoscope-codex-logo.png)
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/Ralph/QA/Research routes, Context7 evidence checks, DB safety, TriWiki context tracking, Honest Mode, and release-readiness gates.
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`, `$Ralph`, `$DB`, `$Wiki`, `$Help`, and related routes are visible in prompt workflows. |
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
- | Ralph | Clarifies once, seals a decision contract, then continues without repeatedly asking the user. |
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 lane` renders one agent's status, assigned runtime tasks, recent events, and a fallback global tail for multi-pane monitoring.
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, Ralph, Research, DB, Wiki, GX
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 ralph prepare "migrate this workflow without asking after prepare"
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
- $Ralph clarify once, then finish the migration without more questions
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
- | `$Ralph` | You want one prepare-time clarification pass, then no more user questions. |
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, and retries the socket before reporting a remaining cmux app/socket issue.
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.72",
5
- "description": "Sneakoscope Codex: database-safe Codex CLI/App harness with Team, Ralph, AutoResearch, TriWiki, and Honest Mode.",
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
- "ralph",
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",