sneakoscope 0.6.0 → 0.6.6

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
@@ -1,13 +1,31 @@
1
1
  <p align="center">
2
- <img src="docs/assets/sneakoscope-codex-logo.svg" alt="Sneakoscope Codex logo" width="180">
2
+ <img src="https://raw.githubusercontent.com/mandarange/Sneakoscope-Codex/main/docs/assets/sneakoscope-codex-logo.svg" alt="Sneakoscope Codex logo" width="180">
3
3
  </p>
4
4
 
5
5
  <h1 align="center">Sneakoscope Codex</h1>
6
6
 
7
- Sneakoscope Codex is a zero-runtime-dependency Node.js harness for running Codex CLI in a more controlled project workflow. It adds mandatory clarification before autonomous work, a Ralph no-question execution loop, H-Proof completion gates, conservative database safety checks, bounded logs/storage, and deterministic GX visual context cartridges.
7
+ <p align="center">
8
+ <a href="https://www.npmjs.com/package/sneakoscope"><img alt="npm version" src="https://img.shields.io/npm/v/sneakoscope.svg"></a>
9
+ <a href="https://www.npmjs.com/package/sneakoscope"><img alt="weekly downloads" src="https://img.shields.io/npm/dw/sneakoscope.svg"></a>
10
+ <a href="https://github.com/mandarange/Sneakoscope-Codex"><img alt="GitHub stars" src="https://img.shields.io/github/stars/mandarange/Sneakoscope-Codex?style=flat"></a>
11
+ <a href="https://www.npmjs.com/package/sneakoscope"><img alt="license" src="https://img.shields.io/npm/l/sneakoscope.svg"></a>
12
+ <img alt="node >=20.11" src="https://img.shields.io/badge/node-%3E%3D20.11-339933.svg">
13
+ </p>
14
+
15
+ Sneakoscope Codex is an update-aware, zero-runtime-dependency Node.js harness for running Codex CLI in a more controlled project workflow. It adds mandatory clarification before autonomous work, a Ralph no-question execution loop, Codex multi-agent Team orchestration, AutoResearch-style experiment loops, H-Proof completion gates, conservative database safety checks, bounded logs/storage, and deterministic GX visual context cartridges.
8
16
 
9
17
  ```bash
10
18
  npm i -g sneakoscope
19
+ sks
20
+ ```
21
+
22
+ `npm i -g sneakoscope` prints the next command without opening an interactive prompt, so CI and agent installs do not hang. Run `sks` in a real terminal to open the setup UI. The UI asks whether this project should use the global install or a project-only install, then offers to run setup, doctor, and selftest.
23
+
24
+ Default non-interactive setup:
25
+
26
+ ```bash
27
+ sks setup
28
+ sks doctor --fix
11
29
  ```
12
30
 
13
31
  The npm package name is `sneakoscope`; the command is branded as SKS and exposed as lowercase `sks` for shell portability. The package also exposes a `sneakoscope` command alias, so `sks setup` and `sneakoscope setup` are equivalent.
@@ -17,69 +35,38 @@ Global installation is the default and recommended setup. During `sks setup` or
17
35
 
18
36
  ## One-Prompt LLM Install
19
37
 
20
- If you are using Codex App, ChatGPT, Claude Code, Cursor, or another coding agent, copy this prompt into the agent from your target project directory:
38
+ If you are using Codex App, ChatGPT, Claude Code, Cursor, or another coding agent, copy this short prompt from your target project directory. It intentionally avoids recovery branches and broad instructions so the agent does only the install and verification work.
21
39
 
22
40
  ````text
23
- You are installing Sneakoscope Codex in the current project. Do the setup end to end without asking follow-up questions unless a command needs user approval.
24
-
25
- Repository:
26
- https://github.com/mandarange/Sneakoscope-Codex.git
41
+ Install Sneakoscope Codex in this project.
27
42
 
28
- Requirements:
29
- - Node.js must be >=20.11.
30
- - Codex CLI is installed separately; if missing, report that @openai/codex must be installed or SKS_CODEX_BIN must be set.
31
- - Prefer safe, local verification. Do not modify application source files unless needed for SKS setup.
43
+ Rules:
44
+ - Do not modify application source files.
45
+ - Ask only when a command requires user approval.
46
+ - If Node.js is below 20.11, stop and report it.
47
+ - If Codex CLI is missing, report: install @openai/codex or set SKS_CODEX_BIN.
32
48
 
33
- Run:
49
+ Run exactly:
34
50
  ```bash
35
- npm i -g git+https://github.com/mandarange/Sneakoscope-Codex.git
51
+ node -v
52
+ npm i -g sneakoscope
36
53
  sks setup
54
+ sks update-check
37
55
  sks doctor --fix
38
56
  sks selftest --mock
39
57
  sks commands
40
- ```
41
-
42
- If the global command is not on PATH, use:
43
- ```bash
44
- npx -y -p git+https://github.com/mandarange/Sneakoscope-Codex.git sks setup
45
- npx -y -p git+https://github.com/mandarange/Sneakoscope-Codex.git sks doctor --fix
46
- ```
47
-
48
- After setup, explain these outputs to the user:
49
- - `.sneakoscope/` mission state and policy
50
- - `.codex/config.toml` Codex App profiles
51
- - `.codex/hooks.json` SKS hook integration
52
- - `.codex/skills/` local Codex App skills
53
- - `.codex/SNEAKOSCOPE.md` Codex App quick reference
54
- - `AGENTS.md` repository rules
55
-
56
- Show the user how to discover commands:
57
- ```bash
58
- sks help
59
- sks commands
60
- sks usage ralph
61
- sks quickstart
62
- sks codex-app
63
58
  sks dollar-commands
64
59
  ```
65
60
 
66
- Tell the user they can use these prompt commands inside Codex App:
67
- ```text
68
- $DF 글자 색 바꿔줘
69
- $DF 내용을 영어로 바꿔줘
70
- $SKS show me available workflows
71
- $Ralph implement this with mandatory clarification
72
- $Research investigate this idea
73
- $DB check this migration safely
74
- ```
75
- ````
61
+ If `sks` is unavailable after install, replace `sks` with `npx -y -p sneakoscope sks` and continue.
76
62
 
77
- After SKS is installed, you can print this prompt again from the CLI:
63
+ Finish with only:
64
+ - setup passed/failed
65
+ - Codex CLI present/missing
66
+ - generated files: `.sneakoscope/`, `.codex/config.toml`, `.codex/hooks.json`, `.codex/skills/`, `.codex/agents/`, `.codex/SNEAKOSCOPE.md`, `AGENTS.md`
67
+ ````
78
68
 
79
- ```bash
80
- sks install-prompt
81
- sks install-prompt --project
82
- ```
69
+ Run `sks install-prompt --project` for a project-only prompt, or `sks install-prompt --full` for the longer recovery-oriented installer prompt.
83
70
 
84
71
  ## Repository
85
72
 
@@ -89,6 +76,8 @@ npm i -g git+https://github.com/mandarange/Sneakoscope-Codex.git
89
76
 
90
77
  Source repository: <https://github.com/mandarange/Sneakoscope-Codex.git>
91
78
 
79
+ Use the registry install (`npm i -g sneakoscope`) for normal users. The GitHub install path is intended for testing an unreleased commit.
80
+
92
81
  Local development checkout:
93
82
 
94
83
  ```bash
@@ -131,8 +120,10 @@ Use `$` prompt commands inside Codex App or another coding agent when you want t
131
120
  ```text
132
121
  $DF fast design/content fix
133
122
  $SKS general Sneakoscope workflow/help
123
+ $Team multi-agent team orchestration
134
124
  $Ralph clarification-gated Ralph mission
135
125
  $Research frontier research mission
126
+ $AutoResearch iterative experiment loop
136
127
  $DB database/Supabase safety check
137
128
  $GX deterministic visual context
138
129
  $Help command and workflow help
@@ -162,6 +153,7 @@ This creates the app-facing control surface:
162
153
  .codex/config.toml Codex App profiles for SKS Ralph, research, and default work
163
154
  .codex/hooks.json Codex App hook entrypoints routed through SKS guards
164
155
  .codex/skills/ local project skills for Ralph, DB safety, GX, research, and design work
156
+ .codex/agents/ local Codex subagent roles for Team consensus, implementation, DB safety, and QA
165
157
  .codex/SNEAKOSCOPE.md quick reference for using SKS inside Codex App
166
158
  AGENTS.md repository rules loaded by Codex agents
167
159
  .sneakoscope/ mission state, gates, logs, policy, GX cartridges, and reports
@@ -172,6 +164,7 @@ Inside Codex App, you can ask the agent to use the local SKS control surface, fo
172
164
  ```text
173
165
  $DF 글자 색 바꿔줘
174
166
  $DF 내용을 영어로 바꿔줘
167
+ $Team agree on the plan, then implement it with a fresh specialist team.
175
168
  Use Sneakoscope Ralph mode to prepare this task.
176
169
  Run the latest Ralph mission with the sealed decision contract.
177
170
  Use SKS DB safety before touching database or Supabase files.
@@ -259,7 +252,11 @@ sks research run latest --max-cycles 3
259
252
  - **Sealed decision contract**: `ralph answer` validates answers and writes `decision-contract.json`.
260
253
  - **No-question Ralph loop**: after `ralph run` starts, Ralph must resolve ambiguity with the sealed contract instead of asking the user.
261
254
  - **Research mode**: `research` runs a frontier-discovery loop for non-obvious hypotheses, falsification, novelty ledgers, and testable experiments.
262
- - **Prompt pipeline and `$` routes**: user prompts are lightly optimized by default, and Codex App users can force routes such as `$DF`, `$Ralph`, `$Research`, `$DB`, and `$GX`.
255
+ - **Prompt pipeline and `$` routes**: user prompts are lightly optimized by default, and Codex App users can force routes such as `$DF`, `$Team`, `$Ralph`, `$Research`, `$AutoResearch`, `$DB`, and `$GX`.
256
+ - **Team orchestration**: `sks team` and `$Team` prepare a Codex multi-agent flow where planning agents debate options, the parent agent seals one objective, planning agents are closed, and a fresh implementation team handles disjoint work in parallel.
257
+ - **AutoResearch loop**: open-ended improvement tasks use a small experiment cycle: program, hypothesis, experiment, metric, keep/discard, falsification, and honest conclusion.
258
+ - **Update-aware hooks**: before work, SKS checks for a newer published package and asks whether to update now or skip for the current conversation only.
259
+ - **Honest Mode finish**: final answers must include an evidence-aware verification pass before claiming the goal is complete.
263
260
  - **Fast DF mode**: `$DF` handles small design/content edits like color, copy, labels, spacing, and translation without unnecessary Ralph, Research, or evaluation loops.
264
261
  - **Database guard**: destructive DB operations, production writes, unsafe Supabase MCP configuration, and direct live SQL mutations are blocked or warned on.
265
262
  - **H-Proof done gate**: completion requires supported critical claims, reviewed DB safety state, acceptable visual/wiki drift, and required test evidence.
@@ -268,6 +265,64 @@ sks research run latest --max-cycles 3
268
265
  - **Visual cartridges**: `gx` creates deterministic SVG/HTML visual context from `vgraph.json` and `beta.json`; no generated-image service is required.
269
266
  - **Design artifact skill**: `sks init` installs a local skill for high-fidelity HTML/UI/prototype work with design-context gathering and rendered verification.
270
267
 
268
+ ## FAQ For Search And AI Answers
269
+
270
+ ### What is Sneakoscope Codex?
271
+
272
+ Sneakoscope Codex is a Codex CLI harness for safer autonomous software work. It combines update checks, Codex App hooks, multi-agent Team orchestration, Ralph no-question execution, database safety guards, H-Proof completion gates, and bounded runtime state.
273
+
274
+ ### Does Sneakoscope Codex support Codex multi-agent teams?
275
+
276
+ Yes. `sks setup` enables Codex `multi_agent`, creates `.codex/agents/*.toml` custom agents, and installs a `$Team` workflow for planning debate, consensus, fresh implementation workers, review, and final integration.
277
+
278
+ ### Does Sneakoscope Codex replace Codex CLI?
279
+
280
+ No. `@openai/codex` is installed separately. Sneakoscope Codex supervises project workflow, hooks, safety policy, state, and local skills around Codex CLI and Codex App.
281
+
282
+ ### Why star the GitHub repository?
283
+
284
+ Stars help developers discover a lightweight Codex workflow harness focused on database safety, multi-agent orchestration, update hygiene, honest completion checks, and practical autonomous coding loops.
285
+
286
+ ## Team Workflow
287
+
288
+ Team mode uses Codex subagents/custom agents as an orchestration protocol rather than a single long-running worker. `sks setup` enables `multi_agent`, sets agent concurrency limits, and installs local agent role files under `.codex/agents/`.
289
+
290
+ ```text
291
+ team planning
292
+ -> spawn read-only/explorer specialists for code paths, risks, DB safety, tests, and options
293
+ -> synthesize one agreed objective with constraints and acceptance criteria
294
+ -> close planning agents
295
+
296
+ fresh implementation team
297
+ -> assign disjoint write scopes to implementation workers
298
+ -> run work in parallel only when ownership does not overlap
299
+ -> review with QA and DB safety specialists
300
+ -> parent orchestrator integrates, verifies, and reports evidence
301
+ ```
302
+
303
+ Create a Team mission:
304
+
305
+ ```bash
306
+ sks team "implement this feature safely"
307
+ ```
308
+
309
+ Inside Codex App, use:
310
+
311
+ ```text
312
+ $Team agree on the best plan, then implement with specialists
313
+ ```
314
+
315
+ The generated Team artifacts are:
316
+
317
+ ```text
318
+ .sneakoscope/missions/<MISSION_ID>/team-plan.json
319
+ .sneakoscope/missions/<MISSION_ID>/team-workflow.md
320
+ .codex/agents/team-consensus.toml
321
+ .codex/agents/implementation-worker.toml
322
+ .codex/agents/db-safety-reviewer.toml
323
+ .codex/agents/qa-reviewer.toml
324
+ ```
325
+
271
326
  ## Ralph Workflow
272
327
 
273
328
  ```text
@@ -298,14 +353,23 @@ Core invariants:
298
353
 
299
354
  ## Commands
300
355
 
301
- All examples below use `sks`, but the same commands can be run with the `sneakoscope` alias.
356
+ There are two command surfaces:
357
+
358
+ - **Terminal CLI commands**: run in a shell as `sks ...` or `sneakoscope ...`.
359
+ - **Prompt `$` commands**: type inside Codex App or another coding agent prompt, not in a shell.
360
+
361
+ All terminal examples below use `sks`, but the same commands can be run with the `sneakoscope` alias.
362
+
363
+ ### Terminal CLI
302
364
 
303
365
  ```bash
304
366
  sks help [topic]
367
+ sks update-check [--json]
368
+ sks wizard
305
369
  sks commands [--json]
306
- sks usage [install|setup|ralph|research|db|codex-app|df|dollar|eval|gx]
370
+ sks usage [install|setup|team|ralph|research|db|codex-app|df|dollar|eval|gx|wiki]
307
371
  sks quickstart
308
- sks install-prompt [--project]
372
+ sks install-prompt [--project] [--full]
309
373
  sks codex-app
310
374
  sks dollar-commands [--json]
311
375
  sks df
@@ -342,8 +406,12 @@ sks eval run [--json] [--out report.json] [--iterations N]
342
406
  sks eval compare --baseline old.json --candidate new.json [--json]
343
407
  sks eval thresholds
344
408
 
409
+ sks wiki coords --rgba 12,34,56,255
410
+ sks wiki pack [--json] [--role worker|verifier] [--max-anchors N]
411
+ sks wiki validate [context-pack.json]
412
+
345
413
  sks hproof check [mission-id|latest]
346
- sks team "task"
414
+ sks team "task" [--json]
347
415
  sks gx init [name]
348
416
  sks gx render [name] [--format svg|html|all]
349
417
  sks gx validate [name]
@@ -358,6 +426,45 @@ sks stats [--json]
358
426
 
359
427
  `sks memory` is currently an alias for garbage collection/retention handling.
360
428
 
429
+ ### Prompt $ Commands
430
+
431
+ Use these by typing them at the start of a prompt in Codex App or another coding agent:
432
+
433
+ ```text
434
+ $DF <small design/content request>
435
+ $SKS <general Sneakoscope request>
436
+ $Team <multi-agent team request>
437
+ $Ralph <clarification-gated mission request>
438
+ $Research <research/discovery request>
439
+ $AutoResearch <iterative experiment request>
440
+ $DB <database or Supabase safety request>
441
+ $GX <visual context request>
442
+ $Help <command/help request>
443
+ ```
444
+
445
+ Examples:
446
+
447
+ ```text
448
+ $DF 글자 색 파란색으로 바꿔줘
449
+ $DF 내용을 영어로 바꿔줘
450
+ $DF Change the CTA label to "Start"
451
+ $Ralph 결제 실패 재시도 로직 개선
452
+ $Research LLM 에이전트 평가 방법론 조사
453
+ $DB 이 migration 안전한지 검사해줘
454
+ $GX 현재 아키텍처를 시각 컨텍스트로 만들어줘
455
+ $Help 사용 가능한 명령어 알려줘
456
+ ```
457
+
458
+ `$DF` is the fast path for simple design/content edits. It is intentionally scoped to the requested change and should not run Ralph, Research, eval, or broad redesign loops unless you explicitly ask.
459
+
460
+ To inspect these routes from the terminal:
461
+
462
+ ```bash
463
+ sks dollar-commands
464
+ sks df
465
+ sks usage dollar
466
+ ```
467
+
361
468
  ## Research Mode
362
469
 
363
470
  Research mode is for exploratory work where the desired output is a possible new insight, mechanism, prediction, or experiment, not a summary. It uses a frontier-discovery loop:
@@ -476,10 +583,11 @@ sks hproof check latest
476
583
  `sks init` creates the local control surface:
477
584
 
478
585
  ```text
479
- .sneakoscope/ mission state, policy, retention, logs, GX cartridges
586
+ .sneakoscope/ mission state, policy, retention, logs, wiki packs, GX cartridges
480
587
  .codex/config.toml Codex profiles used by Sneakoscope Codex
481
588
  .codex/hooks.json hook entrypoints
482
589
  .codex/skills/ Codex App local project skills
590
+ .codex/agents/ Codex App custom agents for Team mode
483
591
  .codex/SNEAKOSCOPE.md Codex App quick reference
484
592
  .agents/skills/ Sneakoscope Codex helper skills
485
593
  AGENTS.md managed repository rules block
@@ -537,7 +645,28 @@ vgraph.json
537
645
 
538
646
  ## TriWiki Context Compression
539
647
 
540
- TriWiki is a harness-level context selection strategy, not a model-internal modification. It scores claims and memory entries by geometric distance, authority, freshness, risk, and token cost, then builds small context capsules for the current mission.
648
+ TriWiki is a harness-level context selection strategy, not a model-internal modification. It scores claims and memory entries by geometric distance, authority, freshness, risk, and token cost, then builds context capsules for the current mission.
649
+
650
+ The default model is anchor-first rather than lossy-summary-first. Selected claims are included as text, while non-selected claims are preserved as LLM Wiki anchors with id, source path, hash, RGBA key, and a compact coordinate tuple. Later turns can hydrate the missing context from the project wiki instead of depending on a one-way summary.
651
+
652
+ RGBA wiki coordinates use four channels:
653
+
654
+ ```text
655
+ R -> domain angle
656
+ G -> layer radius through sin()
657
+ B -> phase angle
658
+ A -> concentration/confidence
659
+ ```
660
+
661
+ The derived coordinate is `[domain, layer, phase, concentration]`, with an internal `xyzw` vector computed through sine/cosine. GX renders expose the same anchors through SVG data attributes and an RGBA coordinate strip, so visual context and text claims share one retrieval space.
662
+
663
+ Useful commands:
664
+
665
+ ```bash
666
+ sks wiki coords --rgba 12,34,56,255
667
+ sks wiki pack
668
+ sks wiki validate
669
+ ```
541
670
 
542
671
  Default context layers:
543
672
 
@@ -575,12 +704,13 @@ npm run repo-audit
575
704
  npm run packcheck
576
705
  npm run selftest
577
706
  npm run sizecheck
707
+ npm run release:check
578
708
  npm run doctor
579
709
  ```
580
710
 
581
- `npm run repo-audit` checks tracked files for risky local paths and high-confidence secret material such as private keys, npm/GitHub/OpenAI-style tokens, local MCP configs, DB dumps, and credential files. It is included in `prepack` and `prepublishOnly`.
711
+ `npm run repo-audit` checks tracked files for risky local paths and high-confidence secret material such as private keys, npm/GitHub/OpenAI-style tokens, local MCP configs, DB dumps, and credential files. It is included in `release:check` and `prepublishOnly`. The package intentionally does not define `prepack`; GitHub installs should not trigger npm's heavier git-dependency preparation path for normal users.
582
712
 
583
- `npm run sizecheck` blocks accidental package bloat before `npm pack` or `npm publish`. Defaults: packed tarball `<=96 KiB`, unpacked package `<=320 KiB`, package files `<=40`, and each tracked file `<=256 KiB`. Override only for an intentional release with `SKS_MAX_PACK_BYTES`, `SKS_MAX_UNPACKED_BYTES`, `SKS_MAX_PACK_FILES`, or `SKS_MAX_TRACKED_FILE_BYTES`.
713
+ `npm run sizecheck` blocks accidental package bloat during `release:check`, `publish:dry`, and `npm publish`. Defaults: packed tarball `<=96 KiB`, unpacked package `<=320 KiB`, package files `<=40`, and each tracked file `<=256 KiB`. Override only for an intentional release with `SKS_MAX_PACK_BYTES`, `SKS_MAX_UNPACKED_BYTES`, `SKS_MAX_PACK_FILES`, or `SKS_MAX_TRACKED_FILE_BYTES`.
584
714
 
585
715
  `npm run selftest` uses the mock path and does not call a model. Live Ralph runs require a working Codex CLI installation and authentication.
586
716
 
@@ -6,8 +6,8 @@ Sneakoscope Codex v0.6 is designed to keep runtime, package size, RAM, and stora
6
6
 
7
7
  - `codex exec` output is streamed to files and only a bounded tail is retained in memory.
8
8
  - Ralph cycles run under a timeout and bounded max cycles.
9
- - TriWiki claim selection uses bounded top-K selection instead of sorting unbounded context into prompts.
10
- - GX visual context renders deterministic SVG/HTML from JSON sources, avoiding external image-generation latency, cost, and nondeterminism.
9
+ - TriWiki claim selection uses bounded top-K selection plus RGBA/trig wiki anchors instead of sorting unbounded context into prompts.
10
+ - GX visual context renders deterministic SVG/HTML from JSON sources, avoiding external image-generation latency, cost, and nondeterminism. Rendered nodes expose the same RGBA wiki-coordinate anchors used by TriWiki.
11
11
  - `sks gc` runs after Ralph cycles by default.
12
12
 
13
13
  ## Evaluation metrics
@@ -30,13 +30,26 @@ Default meaningful-improvement thresholds are intentionally explicit: at least 2
30
30
 
31
31
  The accuracy metric is not a live model task score. It is a deterministic proxy for whether the context handed to a model is smaller, better supported, and less contaminated by unsupported critical claims.
32
32
 
33
+ ## LLM Wiki coordinate continuity
34
+
35
+ TriWiki does not treat compression as permanent deletion. The visible context pack includes selected claim text plus a compact LLM Wiki coordinate index:
36
+
37
+ ```text
38
+ R channel -> domain angle
39
+ G channel -> layer radius via sin()
40
+ B channel -> phase angle
41
+ A channel -> concentration/confidence
42
+ ```
43
+
44
+ Each anchor stores id, RGBA key, `[domain, layer, phase, concentration]`, source path, status/risk, and a text hash. This keeps non-selected claims hydratable across turns while keeping raw Q0 logs and large Q1 evidence out of the prompt until verification needs them.
45
+
33
46
  ## Package size
34
47
 
35
48
  - The npm package has zero runtime dependencies.
36
49
  - `@openai/codex` is no longer bundled. Users install Codex separately or set `SKS_CODEX_BIN`.
37
50
  - Optional Rust source is in `crates/` for the Git repo, but is excluded from the npm package by the `files` allowlist.
38
51
  - GX rendering uses only built-in Node.js APIs and ships as source in the npm package.
39
- - `npm run sizecheck` enforces package limits before pack/publish: `<=96 KiB` packed, `<=320 KiB` unpacked, `<=40` package files, and `<=256 KiB` per tracked file by default.
52
+ - `npm run sizecheck` enforces package limits during `release:check`, `publish:dry`, and publish: `<=96 KiB` packed, `<=320 KiB` unpacked, `<=40` package files, and `<=256 KiB` per tracked file by default.
40
53
 
41
54
  ## Memory leaks
42
55
 
@@ -66,3 +79,5 @@ Blocked classes include destructive SQL, direct remote SQL mutation, `supabase d
66
79
  Sneakoscope Codex v0.4 replaces model-rendered visual cartridges with deterministic code-rendered context sheets. `vgraph.json` and `beta.json` are the inputs, `render.svg` and `render.html` are reproducible outputs, and `drift.json` records whether the rendered source hash still matches the current graph.
67
80
 
68
81
  This keeps visual context cheap to regenerate, diffable in normal tooling, and safe to validate during npm packaging without network calls or model access.
82
+
83
+ GX snapshots include `wiki_coordinates`, and `render.svg` nodes include `data-wiki-rgba` and `data-wiki-coord` attributes. This makes the visual context sheet and LLM Wiki pack share one deterministic coordinate system.
package/package.json CHANGED
@@ -1,9 +1,17 @@
1
1
  {
2
2
  "name": "sneakoscope",
3
3
  "displayName": "Sneakoscope Codex",
4
- "version": "0.6.0",
5
- "description": "Sneakoscope Codex: database-safe, performance-bounded Codex CLI harness with Ralph no-question loop, H-Proof gates, deterministic GX visual context, and TriWiki compression.",
4
+ "version": "0.6.6",
5
+ "description": "Sneakoscope Codex: update-aware, database-safe Codex CLI harness with multi-agent Team orchestration, Ralph no-question execution, autoresearch-style loops, and H-Proof gates.",
6
6
  "type": "module",
7
+ "homepage": "https://github.com/mandarange/Sneakoscope-Codex#readme",
8
+ "repository": {
9
+ "type": "git",
10
+ "url": "git+https://github.com/mandarange/Sneakoscope-Codex.git"
11
+ },
12
+ "bugs": {
13
+ "url": "https://github.com/mandarange/Sneakoscope-Codex/issues"
14
+ },
7
15
  "bin": {
8
16
  "sks": "bin/sks.mjs",
9
17
  "sneakoscope": "bin/sks.mjs"
@@ -24,14 +32,15 @@
24
32
  },
25
33
  "scripts": {
26
34
  "repo-audit": "node ./scripts/repo-audit.mjs",
35
+ "postinstall": "node ./bin/sks.mjs postinstall",
27
36
  "selftest": "node ./bin/sks.mjs selftest --mock",
28
37
  "doctor": "node ./bin/sks.mjs doctor",
29
38
  "packcheck": "find bin src scripts -name '*.mjs' -print0 | xargs -0 -n1 node --check",
30
39
  "sizecheck": "node ./scripts/sizecheck.mjs",
31
- "publish:dry": "npm --cache /tmp/sks-npm-cache pack --dry-run",
40
+ "release:check": "npm run repo-audit && npm run packcheck && npm run selftest && npm run sizecheck",
41
+ "publish:dry": "npm run release:check && npm --cache /tmp/sks-npm-cache pack --dry-run",
32
42
  "publish:npm": "npm --cache /tmp/sks-npm-cache publish --access public",
33
- "prepack": "npm run repo-audit && npm run packcheck && npm run selftest && npm run sizecheck",
34
- "prepublishOnly": "npm run repo-audit && npm run packcheck && npm run selftest && npm run sizecheck"
43
+ "prepublishOnly": "npm run release:check"
35
44
  },
36
45
  "keywords": [
37
46
  "sneakoscope",
@@ -39,12 +48,24 @@
39
48
  "sks",
40
49
  "cli",
41
50
  "ai-agent",
51
+ "ai-agents",
42
52
  "harness",
53
+ "codex-cli",
54
+ "codex-app",
55
+ "multi-agent",
56
+ "subagents",
57
+ "agent-orchestration",
58
+ "agent-team",
43
59
  "ralph",
44
60
  "research",
61
+ "autoresearch",
62
+ "honest-mode",
63
+ "update-check",
45
64
  "hypothesis",
46
65
  "discovery",
47
66
  "llm-wiki",
67
+ "wiki-coordinate",
68
+ "context-compression",
48
69
  "gx",
49
70
  "svg",
50
71
  "deterministic",