0xray 4.0.35 → 4.0.37

package/docs-site/docs/plates/pre-tool.md

@@ -0,0 +1,35 @@
+---
+title: Pre tool
+sidebar_label: Pre tool
+---
+
+# Pre tool
+
+The tool hook is where the lens gate runs.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the tool name and its arguments                       │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ join the command, the content, and the paths          │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ deny when the lens gate denies                        │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+pre-tool-use.js joins the command, the written content, and the paths, then calls lensBeforeResearch. A deny ends the hook. The plate that belongs here is lens-gate.
+
+stamped · 0xray 4.0.36

package/docs-site/docs/plates/record-map.md

@@ -0,0 +1,41 @@
+---
+title: Record map
+sidebar_label: Record map
+---
+
+# Record map
+
+Five pages are what an agent writes, the package face is what a release writes, and the trail is what the suit writes under .xray.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌──────────────────┐                                     │
+│   │ which file       │                                     │
+│   └────────┬─────────┘                                     │
+└────────────┼───────────────────────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ five pages · package face · trail under .xray      │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌──────────────────────────┐                             │
+│   │ the one path to open     │                             │
+│   └──────────────────────────┘                             │
+└────────────────────────────────────────────────────────────┘
+```
+
+Five pages: station card `.xray/state/STATION.md`, notes `.xray/state/NOTES.md`, a plate `docs-site/docs/plates/<id>.md`, the lens page for one plane, a reflection `docs/reflections/`.
+
+Package face: `README.md`, `package.json`, `AGENTS.md`, `llms.txt`, `CHANGELOG.md`, `SKILLS.md`, and each `SKILL.md`.
+
+Trail: state and logs under `.xray`. Codex is already loaded. This plate is the file ref.
+
+The published manual is `docs-site/docs/`. The rule sheet is `grok-bot/OP-PROC.md`. Neither is one of the five pages.
+
+stamped · 0xray 4.0.36

package/docs-site/docs/plates/reflection-page.md

@@ -0,0 +1,35 @@
+---
+title: Reflection page
+sidebar_label: Reflection page
+---
+
+# Reflection page
+
+A reflection is one episode written under docs/reflections.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ a session ends                                     │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ write what the session learned                     │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ one reflection file                                │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+The loader is `loadReflectionInferences` in `src/inference/inference-accumulator.ts`. A reflection is not a repertoire law.
+
+stamped · 0xray 4.0.36

package/docs-site/docs/plates/review.md

@@ -0,0 +1,57 @@
+---
+title: Review
+sidebar_label: Review
+plate_type: state flow
+---
+
+# Review
+
+A state flow plate: one critic pass, one fix, one re-review, then stop.
+
+```
+  ┌──────────────────────────────┐
+  │ DIFF                         │
+  ├──────────────────────────────┤
+  │ · one head on a branch       │
+  │ · the test claims the change │
+  └──────────────────────────────┘
+                  │
+                  v
+  ┌──────────────────────────────┐
+  │ CRITIC                       │
+  ├──────────────────────────────┤
+  │ · one pass on that head      │
+  │ · FAIL names the file and a  │
+  │   test that fails on the old │
+  │   code                       │
+  │ · a note is not a FAIL       │
+  └──────────────┬───────────────┘
+                 │
+       ┌─────────┴──────────┐
+       │ PASS               │ FAIL
+       v                    v
+  ┌─────────┐      ┌──────────────────────────┐
+  │ STOP    │      │ ONE FIX                  │
+  ├─────────┤      ├──────────────────────────┤
+  │ · notes │      │ · that hole, one author  │
+  │   stay  │      │ · a second session waits │
+  └─────────┘      └────────────┬─────────────┘
+                                │
+                                v
+                   ┌──────────────────────────┐
+                   │ RE-REVIEW                │
+                   ├──────────────────────────┤
+                   │ · one pass on the new    │
+                   │   head                   │
+                   │ · a missed hole returns  │
+                   │   to ONE FIX             │
+                   └────────────┬─────────────┘
+                                │
+                           PASS │
+                                v
+                              STOP
+```
+
+A FAIL names the file and a test that fails on the old code. One author fixes that hole. A second session waits while the verdict is open. Re-review that new head. A hole the new test did not lock returns to ONE FIX. A PASS ends the plate. A note stays a note and does not open another lap.
+
+stamped · 0xray 4.0.36

package/docs-site/docs/plates/session-capture.md

@@ -0,0 +1,38 @@
+---
+title: Session capture
+sidebar_label: Session capture
+---
+
+# Session capture
+
+Station writes latest-session.json when HEAD moves, and saveSessionInference writes the same kind of file for a graded session.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────┐    ┌──────────────────────────┐  │
+│   │ station HEAD move  │    │ saveSessionInference     │  │
+│   └─────────┬──────────┘    └────────────┬─────────────┘  │
+│             └──────────────┬─────────────┘                │
+└────────────────────────────┼──────────────────────────────┘
+                             v
+┌────────────────────────────┼──────────────────────────────┐
+│ PROCESSING LAYER           v                              │
+│   ┌────────────────────────────────────────────────────┐  │
+│   │ one JSON · span · problems · approaches            │  │
+│   └──────────────────────────┬─────────────────────────┘  │
+└──────────────────────────────┼────────────────────────────┘
+                               v
+┌──────────────────────────────┼────────────────────────────┐
+│ OUTPUT LAYER                 v                            │
+│   ┌──────────────────────────────────────────────────┐   │
+│   │ .xray/inference/latest-session.json              │   │
+│   └──────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+Today that file is `docs/inference/latest-session.json`. The home is `.xray/inference/latest-session.json`. Cycle state is already `.xray/inference/inference-cycle-state.json`.
+
+Station reads the file for heat. The inference accumulator reads `session-*.json` beside it. Do not mint a `session-<date>-<sha>` file for the station note.
+
+stamped · 0xray 4.0.36

package/docs-site/docs/plates/site-manual.md

@@ -0,0 +1,35 @@
+---
+title: Site manual
+sidebar_label: Site manual
+---
+
+# Site manual
+
+The published manual is docs-site/docs.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the product changed                                │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ edit the guide that says the old thing             │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the manual matches the product                     │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+Guides, architecture, and introduction live here. Factory notes under `docs/` are a different set. Reflections stay in `docs/reflections/`.
+
+stamped · 0xray 4.0.36

package/docs-site/docs/plates/stamp-plate.md

@@ -0,0 +1,35 @@
+---
+title: Stamp plate
+sidebar_label: Stamp plate
+---
+
+# Stamp plate
+
+A stamped plate is one drawing for one plane.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ one plane that was opened                          │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ write the drawing and list one skill               │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the plate the lens can open                        │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+The file is `docs-site/docs/plates/<id>.md`. Each opened segue gets its own plate. The hook does not author this file. The plate that belongs here is review.
+
+stamped · 0xray 4.0.36

package/docs-site/docs/plates/station-card.md

@@ -0,0 +1,35 @@
+---
+title: Station card
+sidebar_label: Station card
+---
+
+# Station card
+
+The station card is the one-line ticket at .xray/state/STATION.md.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the card on disk                                   │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ keep the intent · put the body in notes            │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the same job continues                             │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+Read it after a compact. Leave Intent alone. The plan is the next cut. The long body belongs in notes.
+
+stamped · 0xray 4.0.36

package/docs-site/docs/plates/station-heat.md

@@ -0,0 +1,35 @@
+---
+title: Station heat
+sidebar_label: Station heat
+---
+
+# Station heat
+
+On a compact event applyStationHeat stamps the notes pickup line.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the compact hook                                   │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ stamp the pickup line                              │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the pickup matches intent                          │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+`isCompactHook` is true when the hook name contains compact. The body of NOTES.md is left alone. The plates that belong here are pickup-stamp and notes-page.
+
+stamped · 0xray 4.0.36

package/docs-site/docs/plates/suit-organs.md

@@ -0,0 +1,38 @@
+---
+title: Suit organs
+sidebar_label: Suit organs
+---
+
+# Suit organs
+
+Reporting, station, and the inference cycle are the organs that read or write the activity log and the session file.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌──────────────────┐    ┌────────────────────────────┐  │
+│   │ activity log     │    │ latest-session.json        │  │
+│   └────────┬─────────┘    └─────────────┬──────────────┘  │
+│            └──────────────┬─────────────┘                 │
+└───────────────────────────┼───────────────────────────────┘
+                            v
+┌───────────────────────────┼───────────────────────────────┐
+│ PROCESSING LAYER          v                               │
+│   ┌────────────┐ ┌────────────┐ ┌──────────────────────┐ │
+│   │ reporting  │ │ station    │ │ inference cycle      │ │
+│   └─────┬──────┘ └─────┬──────┘ └──────────┬───────────┘ │
+└─────────┴──────────────┴───────────────────┴─────────────┘
+                          v
+┌────────────────────────────────────────────────────────────┐
+│ OUTPUT LAYER                                               │
+│   ┌────────────┐ ┌────────────┐ ┌──────────────────────┐  │
+│   │ report     │ │ heat line  │ │ cycle state          │  │
+│   └────────────┘ └────────────┘ └──────────────────────┘  │
+└────────────────────────────────────────────────────────────┘
+```
+
+Reporting reads the activity log and may write a report. Station reads `latest-session.json` and writes the next one. The inference cycle writes `.xray/inference/inference-cycle-state.json` and the history beside it.
+
+Repertoire already keeps `inference-state.json` and the day log under `.xray/state/repertoire/`. Goggles does not write these files. It reads a plate when one plane is named.
+
+stamped · 0xray 4.0.36

package/docs-site/docs/plates/suit-settings.md

@@ -0,0 +1,35 @@
+---
+title: Suit settings
+sidebar_label: Suit settings
+---
+
+# Suit settings
+
+Suit settings are features, config, and codex.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the suit is worn                                   │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ wear writes the consumer copies                    │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the agent reads settings                           │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+There is no settings.json. The files are `.xray/features.json`, `.xray/config.json`, and `.xray/codex.json`. The package copies live under `xray/`.
+
+stamped · 0xray 4.0.36

package/docs-site/docs/plates/suit-wear.md

@@ -0,0 +1,37 @@
+---
+title: Suit wear
+sidebar_label: Suit wear
+---
+
+# Suit wear
+
+Wear copies hooks, features.json, and the consumer gitignore into the project, and those copies still name the old log folder.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌──────────────────────┐                                 │
+│   │ wear / postinstall   │                                 │
+│   └──────────┬───────────┘                                 │
+└──────────────┼─────────────────────────────────────────────┘
+               v
+┌──────────────┼─────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ hooks · features.json · consumer gitignore         │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌──────────────────────────────────────────────────┐    │
+│   │ consumer .xray/logs and .xray/inference          │    │
+│   └──────────────────────────────────────────────────┘    │
+└────────────────────────────────────────────────────────────┘
+```
+
+`xray/features.json` sets `activity_logging.log_path` to `.opencode/logs`. `scripts/node/consumer-gitignore.cjs` ignores `logs/framework/`. The installed hooks append that old path.
+
+A worn project is a consumer. Its writes go to its own `.xray/logs` and `.xray/inference`, not into `docs/` and not into `.opencode/logs`.
+
+stamped · 0xray 4.0.36

package/docs-site/docs/plates/trail-state.md

@@ -0,0 +1,35 @@
+---
+title: Trail state
+sidebar_label: Trail state
+---
+
+# Trail state
+
+The suit writes its trail under .xray.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ a wake starts                                      │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the suit writes state                              │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ state under .xray                                  │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+Session boot, the lens match line, and the station card are state. The agent reads them. Do not commit `.xray/state`.
+
+stamped · 0xray 4.0.36

package/docs-site/docs/plates/work-fresh.md

@@ -0,0 +1,35 @@
+---
+title: Work fresh
+sidebar_label: Work fresh
+---
+
+# Work fresh
+
+Refresh writes one Fresh line from git and the published package.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the repo and the published version                    │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ describe one Fresh line                               │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ one line on the station card                          │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+refreshFreshness in src/nucleus/work-freshness.mjs fetches origin, reads npm view 0xray version, and returns that one line. A compact hook does not call it. The plate that belongs here is station-card.
+
+stamped · 0xray 4.0.36

package/docs-site/docs/plates/write-home.md

@@ -0,0 +1,38 @@
+---
+title: Write home
+sidebar_label: Write home
+---
+
+# Write home
+
+Every runtime write belongs under .xray, and the consumers and organs that still name logs/framework, docs/inference, or .opencode/logs have to be pointed at that home.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌──────────────┐ ┌─────────────────┐ ┌───────────────┐  │
+│   │ activity log │ │ inference files │ │ cycle state   │  │
+│   └──────┬───────┘ └────────┬────────┘ └───────┬───────┘  │
+│          └──────────────────┴─────────┬────────┘          │
+└────────────────────────────────────────┼──────────────────┘
+                                         v
+┌────────────────────────────────────────┼──────────────────┐
+│ PROCESSING LAYER                       v                  │
+│   ┌────────────────────────────────────────────────────┐  │
+│   │ write-home.cjs · one path for every writer        │  │
+│   └──────────────────────────┬─────────────────────────┘  │
+└──────────────────────────────┼────────────────────────────┘
+                               v
+┌──────────────────────────────┼────────────────────────────┐
+│ OUTPUT LAYER                 v                            │
+│   ┌──────────────────────────┐   ┌─────────────────────┐ │
+│   │ .xray/logs/activity.log  │   │ .xray/inference     │ │
+│   └──────────────────────────┘   └─────────────────────┘ │
+└────────────────────────────────────────────────────────────┘
+```
+
+The path table is `src/integrations/hooks/write-home.cjs`. Writers use it. Readers open the new file, and the old file only when the new one is not there yet.
+
+Still on the old path until each caller is rewired: the activity logger, the framework logger, the pipeline hook, the Grok hook, the Hermes bridge, station capture, `saveSessionInference`, reporting, pulse, monitor, and `features.json` `log_path`.
+
+stamped · 0xray 4.0.36

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "0xray",
-  "version": "4.0.35",
+  "version": "4.0.37",
   "description": "Multi-agent orchestration and Codex governance for OpenCode, Hermes, Grok Build, and OpenClaw",
   "readme": "README.md",
   "license": "MIT",
@@ -171,6 +171,7 @@
     "scripts/mjs/verify-four-floor-compact.mjs",
     "scripts/mjs/run-repertoire-mcp.mjs",
     "scripts/mjs/run-goggles-mcp.mjs",
+    "scripts/mjs/run-grok-hook.mjs",
     "scripts/mjs/verify-delegation-gate-core.mjs",
     "scripts/mjs/delegation-gate-fixture.mjs",
     "src/opencode/",
@@ -212,7 +213,8 @@
     ".xray/config.json",
     ".gitignore.default",
     "LICENSE",
-    "vendor/@0xray/repertoire/"
+    "vendor/@0xray/repertoire/",
+    "!vendor/**/*.map"
   ],
   "dependencies": {
     "@0xray/blip": "^0.1.2",