sneakoscope 0.6.3 → 0.6.7

package/README.md

@@ -16,8 +16,26 @@ Sneakoscope Codex is an update-aware, zero-runtime-dependency Node.js harness fo
 
 ```bash
 npm i -g sneakoscope
+sks
 ```
 
+`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.
+
+Default non-interactive setup:
+
+```bash
+sks setup
+sks doctor --fix
+```
+
+Use local-only setup when the generated SKS files must never appear in git status:
+
+```bash
+sks setup --local-only
+```
+
+This writes repo-local excludes to `.git/info/exclude` for `.sneakoscope/`, `.codex/`, `.agents/`, and `AGENTS.md`. If `AGENTS.md` already exists, local-only setup does not modify it.
+
 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.
 Global installation is the default and recommended setup. During `sks setup` or `sks init`, SKS resolves the global binary when possible and writes that absolute path into `.codex/hooks.json`, which avoids PATH issues in GUI or hook execution environments. For a project-only install, use `npm i -D sneakoscope` and initialize hooks with `npx sks setup --install-scope project`; this writes hook commands that call the local `node_modules/sneakoscope` binary.
 
@@ -25,22 +43,20 @@ Global installation is the default and recommended setup. During `sks setup` or
 
 ## One-Prompt LLM Install
 
-If you are using Codex App, ChatGPT, Claude Code, Cursor, or another coding agent, copy the whole block below into the agent from your target project directory. The agent should install SKS, initialize the project, verify the setup, and show the available commands in one pass.
+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.
 
 ````text
-Install Sneakoscope Codex in the current project end to end. Do not ask follow-up questions unless a command requires user approval.
-
-Repository:
-https://github.com/mandarange/Sneakoscope-Codex.git
+Install Sneakoscope Codex in this project.
 
-Requirements:
-- Node.js must be >=20.11.
-- Codex CLI is installed separately. If it is missing, report that `@openai/codex` must be installed or `SKS_CODEX_BIN` must be set.
-- Use the published npm package for normal installs.
-- Do not modify application source files unless needed for SKS setup.
+Rules:
+- Do not modify application source files.
+- Ask only when a command requires user approval.
+- If Node.js is below 20.11, stop and report it.
+- If Codex CLI is missing, report: install @openai/codex or set SKS_CODEX_BIN.
 
-Run:
+Run exactly:
 ```bash
+node -v
 npm i -g sneakoscope
 sks setup
 sks update-check
@@ -50,68 +66,16 @@ sks commands
 sks dollar-commands
 ```
 
-If npm reports `ENOTEMPTY`, `EEXIST`, or a broken old global package:
-```bash
-npm uninstall -g sneakoscope
-npm i -g sneakoscope
-sks setup
-sks doctor --fix
-```
-
-If `sks` is not on PATH:
-```bash
-npx -y -p sneakoscope sks setup
-npx -y -p sneakoscope sks doctor --fix
-npx -y -p sneakoscope sks selftest --mock
-npx -y -p sneakoscope sks commands
-npx -y -p sneakoscope sks dollar-commands
-```
-
-For project-only install:
-```bash
-npm i -D sneakoscope
-npx sks setup --install-scope project
-npx sks update-check
-npx sks doctor --fix --install-scope project
-npx sks selftest --mock
-npx sks commands
-npx sks dollar-commands
-```
-
-Finish by reporting pass/fail and explaining only these generated outputs:
-- `.sneakoscope/` mission state and policy
-- `.codex/config.toml` Codex App profiles
-- `.codex/hooks.json` SKS hook integration
-- `.codex/skills/` local Codex App skills
-- `.codex/agents/` local Codex App multi-agent roles
-- `.codex/SNEAKOSCOPE.md` Codex App quick reference
-- `AGENTS.md` repository rules
-
-Show command discovery:
-```bash
-sks help
-sks update-check
-sks commands
-sks usage team
-sks usage ralph
-sks quickstart
-sks codex-app
-sks dollar-commands
-```
+If `sks` is unavailable after install, replace `sks` with `npx -y -p sneakoscope sks` and continue.
 
-Tell the user they can use these prompt commands inside Codex App:
-```text
-$DF 글자 색 바꿔줘
-$DF 내용을 영어로 바꿔줘
-$SKS show me available workflows
-$Team agree on the best plan and implement with specialists
-$Ralph implement this with mandatory clarification
-$Research investigate this idea
-$AutoResearch improve this workflow with experiments
-$DB check this migration safely
-```
+Finish with only:
+- setup passed/failed
+- Codex CLI present/missing
+- generated files: `.sneakoscope/`, `.codex/config.toml`, `.codex/hooks.json`, `.codex/skills/`, `.codex/agents/`, `.codex/SNEAKOSCOPE.md`, `AGENTS.md`
 ````
 
+Run `sks install-prompt --project` for a project-only prompt, or `sks install-prompt --full` for the longer recovery-oriented installer prompt.
+
 ## Repository
 
 ```bash
@@ -409,10 +373,11 @@ All terminal examples below use `sks`, but the same commands can be run with the
 ```bash
 sks help [topic]
 sks update-check [--json]
+sks wizard
 sks commands [--json]
-sks usage [install|setup|team|ralph|research|db|codex-app|df|dollar|eval|gx]
+sks usage [install|setup|team|ralph|research|db|codex-app|df|dollar|eval|gx|wiki]
 sks quickstart
-sks install-prompt [--project]
+sks install-prompt [--project] [--full]
 sks codex-app
 sks dollar-commands [--json]
 sks df
@@ -421,10 +386,10 @@ sks aliases
 sks --help
 sneakoscope --help
 
-sks setup [--install-scope global|project] [--force] [--json]
+sks setup [--install-scope global|project] [--local-only] [--force] [--json]
 sks fix-path [--install-scope global|project] [--json]
-sks doctor [--fix] [--json] [--install-scope global|project]
-sks init [--force] [--install-scope global|project]
+sks doctor [--fix] [--local-only] [--json] [--install-scope global|project]
+sks init [--force] [--local-only] [--install-scope global|project]
 sks selftest [--mock]
 
 sks ralph prepare "task"
@@ -449,6 +414,10 @@ sks eval run [--json] [--out report.json] [--iterations N]
 sks eval compare --baseline old.json --candidate new.json [--json]
 sks eval thresholds
 
+sks wiki coords --rgba 12,34,56,255
+sks wiki pack [--json] [--role worker|verifier] [--max-anchors N]
+sks wiki validate [context-pack.json]
+
 sks hproof check [mission-id|latest]
 sks team "task" [--json]
 sks gx init [name]
@@ -622,7 +591,7 @@ sks hproof check latest
 `sks init` creates the local control surface:
 
 ```text
-.sneakoscope/              mission state, policy, retention, logs, GX cartridges
+.sneakoscope/              mission state, policy, retention, logs, wiki packs, GX cartridges
 .codex/config.toml    Codex profiles used by Sneakoscope Codex
 .codex/hooks.json     hook entrypoints
 .codex/skills/        Codex App local project skills
@@ -684,7 +653,28 @@ vgraph.json
 
 ## TriWiki Context Compression
 
-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.
+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.
+
+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.
+
+RGBA wiki coordinates use four channels:
+
+```text
+R -> domain angle
+G -> layer radius through sin()
+B -> phase angle
+A -> concentration/confidence
+```
+
+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.
+
+Useful commands:
+
+```bash
+sks wiki coords --rgba 12,34,56,255
+sks wiki pack
+sks wiki validate
+```
 
 Default context layers:
 

package/docs/PERFORMANCE.md

@@ -6,8 +6,8 @@ Sneakoscope Codex v0.6 is designed to keep runtime, package size, RAM, and stora
 
 - `codex exec` output is streamed to files and only a bounded tail is retained in memory.
 - Ralph cycles run under a timeout and bounded max cycles.
-- TriWiki claim selection uses bounded top-K selection instead of sorting unbounded context into prompts.
-- GX visual context renders deterministic SVG/HTML from JSON sources, avoiding external image-generation latency, cost, and nondeterminism.
+- TriWiki claim selection uses bounded top-K selection plus RGBA/trig wiki anchors instead of sorting unbounded context into prompts.
+- 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.
 - `sks gc` runs after Ralph cycles by default.
 
 ## Evaluation metrics
@@ -30,6 +30,19 @@ Default meaningful-improvement thresholds are intentionally explicit: at least 2
 
 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.
 
+## LLM Wiki coordinate continuity
+
+TriWiki does not treat compression as permanent deletion. The visible context pack includes selected claim text plus a compact LLM Wiki coordinate index:
+
+```text
+R channel -> domain angle
+G channel -> layer radius via sin()
+B channel -> phase angle
+A channel -> concentration/confidence
+```
+
+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.
+
 ## Package size
 
 - The npm package has zero runtime dependencies.
@@ -66,3 +79,5 @@ Blocked classes include destructive SQL, direct remote SQL mutation, `supabase d
 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.
 
 This keeps visual context cheap to regenerate, diffable in normal tooling, and safe to validate during npm packaging without network calls or model access.
+
+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

@@ -1,7 +1,7 @@
 {
   "name": "sneakoscope",
   "displayName": "Sneakoscope Codex",
-  "version": "0.6.3",
+  "version": "0.6.7",
   "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.",
   "type": "module",
   "homepage": "https://github.com/mandarange/Sneakoscope-Codex#readme",
@@ -32,6 +32,7 @@
   },
   "scripts": {
     "repo-audit": "node ./scripts/repo-audit.mjs",
+    "postinstall": "node ./bin/sks.mjs postinstall",
     "selftest": "node ./bin/sks.mjs selftest --mock",
     "doctor": "node ./bin/sks.mjs doctor",
     "packcheck": "find bin src scripts -name '*.mjs' -print0 | xargs -0 -n1 node --check",
@@ -63,6 +64,8 @@
     "hypothesis",
     "discovery",
     "llm-wiki",
+    "wiki-coordinate",
+    "context-compression",
     "gx",
     "svg",
     "deterministic",