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 +190 -60
- package/docs/PERFORMANCE.md +18 -3
- package/package.json +26 -5
- package/src/cli/main.mjs +572 -32
- package/src/core/evaluation.mjs +11 -0
- package/src/core/fsx.mjs +25 -7
- package/src/core/gx-renderer.mjs +40 -1
- package/src/core/hooks-runtime.mjs +110 -4
- package/src/core/init.mjs +89 -11
- package/src/core/triwiki-attention.mjs +44 -11
- package/src/core/wiki-coordinate.mjs +228 -0
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
|
-
|
|
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
|
|
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
|
-
|
|
24
|
-
|
|
25
|
-
Repository:
|
|
26
|
-
https://github.com/mandarange/Sneakoscope-Codex.git
|
|
41
|
+
Install Sneakoscope Codex in this project.
|
|
27
42
|
|
|
28
|
-
|
|
29
|
-
-
|
|
30
|
-
-
|
|
31
|
-
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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 `
|
|
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
|
|
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
|
|
package/docs/PERFORMANCE.md
CHANGED
|
@@ -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
|
|
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.
|
|
5
|
-
"description": "Sneakoscope Codex:
|
|
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
|
-
"
|
|
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
|
-
"
|
|
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",
|