0xray 4.1.0 → 4.1.1

package/dist/nucleus/work-freshness.mjs

@@ -135,11 +135,21 @@ function freshnessFile(projectRoot) {
   return join(projectRoot, '.xray', 'state', 'freshness.json');
 }
 
+export const FRESHNESS_MAX_AGE_MS = 60 * 60 * 1000;
+
 export function readSavedFreshness(projectRoot) {
   const saved = readJson(freshnessFile(projectRoot));
   return saved ? describeFreshness(saved) : null;
 }
 
+/** A missing stamp or a stamp older than an hour is due. */
+export function freshnessNeedsRefresh(projectRoot, now = Date.now()) {
+  const saved = readJson(freshnessFile(projectRoot));
+  const at = saved && saved.checkedAt ? Date.parse(String(saved.checkedAt)) : NaN;
+  if (!Number.isFinite(at)) return true;
+  return now - at >= FRESHNESS_MAX_AGE_MS;
+}
+
 export function probeFreshness(projectRoot) {
   const saved = readJson(freshnessFile(projectRoot));
   if (saved && saved.behind != null) return decideFreshness(saved);

package/dist/plugin/xray-codex-injection.js

@@ -124,9 +124,11 @@ export default async function xrayCodexPlugin(input) {
             if (speak) {
                 const spoken = `${tool} ${JSON.stringify(args ?? {})}`.slice(0, 500);
                 const lens = speak.lensDecision(directory, tool, spoken);
-                if (lens) {
+                if (lens?.decision === "deny") {
                     throw new Error(`DELEGATION GATE: ${lens.reason ?? "lens"}`);
                 }
+                if (lens?.reason)
+                    logger.log(lens.reason);
                 const additional = speak.repertoireRoute(spoken)?.hookSpecificOutput?.additionalContext;
                 if (additional) {
                     logger.log(additional);

package/dist/skills/orchestrator/SKILL.md

@@ -57,13 +57,7 @@ When `multi_agent_orchestration.lead_dev_mode` is true in `features.json` (defau
 
 The command is `0xray look`. `0xray goggles` is the same organ. A pipe keeps the line card. A terminal shows that card as a pane. Chat seats without hooks use the `goggles` MCP tools `look` and `status_lens`. Same organ.
 
-Kind 0 is actuality. It compares the list in the file to the same six names in the code. It speaks only when those lists differ. A match is quiet.
-
-Kind 1 names one plane: dichotomy, syncopate, synthesis, or loop. The lens holds that plane. An action on that plane is quiet. An action on another plane, or on a pipeline drawing, is stopped. A pipeline drawing is not a scope stop. Ground is not a scope stop. Scope, when named, is ecosystem, part, one flow, or one artifact, and an action wider than that scope is stopped. One kind and one scope level at a time. Two planes, calling, ground, and a pipeline name do not arm the lens. `outer` without one plane is `Name one plane.` After 1 is empty. Nothing is picked.
-
-Naming a plane, `digest`, or `triage` returns that plane's view. The fields are from, digest, plate, entry, exit, files, skills, setup, teardown, and worn. Each field has a pipe. The pipe writes what it can see from the plate or the tree, and the view keeps that field. A field the pipe cannot see yet stays on the view for the next look. The rows are ground, routing, house, boot, governance, memory-recall, orchestration, processor, and reporting. Those nine are not Kind 0. The mill path is `scripts/foundry`. `triage` names the fields still open and whether the row holds. Zoom after the card is the same ladder: ecosystem, part, one flow, one artifact.
-
-The hold lasts for the work that named the plane. A sentence that does not say look or name does not arm it and does not drop it. Work that says goggles clears the hold and stays quiet. When a tool names one card plane, the suit adds that plane's file as a hint.
+A session starts on dev. The boot payload includes that card from `.xray/state/LENS.md`. The planes are dev, integration, domain, and ecosystem. A search inside the current card runs. Any other search returns the current card and does not run. Opening a file on the current card adds nothing. Opening a file on another plane switches to that card and the open proceeds. A file on no card stays on the current plane and returns that card. Compact writes that same card back. A thing on that plane has its own card. One card has its own plate and can name more. A missing plate names the stamp-plate skill. Stamp one plate for that card. The cards and plates that stay are what the next agent reads. Saying goggles clears a stale card line on the station.
 
 ## Hooks (rewired, not new MCPs)
 

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

@@ -0,0 +1,35 @@
+---
+title: Asides
+sidebar_label: Asides
+---
+
+# Asides
+
+A user aside is one parallel track.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ a named track                                      │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ read the aside file                                │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ that track, or the main line                       │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+State is `.xray/state/asides/{id}.json` and `_active.json`. A todo id looks like `{asideId}.a.1.1`. The code is `src/nucleus/user-aside.ts`. The guides aside-context, user-asides, and parallel-work-tracks describe this one thing.
+
+stamped · 0xray 4.1.0

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

@@ -0,0 +1,35 @@
+---
+title: Confer
+sidebar_label: Confer
+---
+
+# Confer
+
+Confer stays off unless it is enabled.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ a synthesis checkpoint                             │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ stay off                                           │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ skipped, unless it is enabled                      │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+`src/nucleus/confer.ts` defaults to enabled false and on_synthesis false. A missing key stays off. A confer todo completes only on a real model PASS.
+
+stamped · 0xray 4.1.0

package/docs-site/docs/plates/consumer-mcp.md

@@ -0,0 +1,35 @@
+---
+title: Consumer MCP
+sidebar_label: Consumer MCP
+---
+
+# Consumer MCP
+
+The worn checkout lists seven MCP servers.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ a worn checkout                                    │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ read .mcp.json                                     │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the seven servers                                  │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+The card owns `src/mcps`. A longer card still wins. The seven servers are xray-governance, xray-skills, xray-enforcer, xray-orchestrator, xray-researcher, xray-code-review, and xray-architect-tools. Repertoire and goggles sit beside them in `.mcp.json`. `src/mcps/registry.json` is the community catalog. Orchestrator and governance keep their own cards.
+
+stamped · 0xray 4.1.0

package/docs-site/docs/plates/delegation-gate.md

@@ -0,0 +1,35 @@
+---
+title: Delegation gate
+sidebar_label: Delegation gate
+---
+
+# Delegation gate
+
+The pre-tool gate for every host.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ a tool call                                        │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ constitution, then the spawn plan                  │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ allow, or deny                                     │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+Hosts call `evaluatePreToolGate` through `src/integrations/hooks/delegation-gate-runtime.cjs`. Codex 11, 29, 69, and 70 live in `src/nucleus/delegation-gate.ts`. A spawn with no plan follows the host temperament.
+
+stamped · 0xray 4.1.0

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

@@ -0,0 +1,35 @@
+---
+title: Dynamo
+sidebar_label: Dynamo
+---
+
+# Dynamo
+
+Dynamo is the external governance service.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ a proposal                                         │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the codex and the solar vote                       │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ pass, revision, or reject                          │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+The guide is `docs-site/docs/guides/self-hosting-dynamo.md`. The service code stays on the governance card. This drawing is the guide.
+
+stamped · 0xray 4.1.0

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

@@ -0,0 +1,35 @@
+---
+title: Foundry
+sidebar_label: Foundry
+---
+
+# Foundry
+
+The mill builds and ships a suit.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ a version bump                                     │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ gate, then publish, then tag                       │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the registry lists that version                    │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+The card owns `scripts/foundry`. The release script is `scripts/foundry/release.mjs`. That script is the only stamp. A longer card still wins. A live publish needs `--i-mean-it`. The OTP link is the `npm-publish` lens.
+
+stamped · 0xray 4.1.0

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

@@ -6,7 +6,7 @@ plate_type: domain model
 
 # Goggles
 
-It views one plane. The lens check is the one look that spans planes.
+It views one plane.
 
 ```
   ┌────────────────────────────────────────────────────────────┐
@@ -14,19 +14,19 @@ It views one plane. The lens check is the one look that spans planes.
   ├────────────────────────────────────────────────────────────┤
   │ · it views one plane                                       │
   │ · not every plane at once                                  │
-  │ · the lens check sweeps every card plane for shipped files │
-  │ · it names the first drift, or stays quiet on a match      │
+  │ · a session starts on dev                                  │
+  │ · the card is in LENS.md                                   │
   ├────────────────────────────────────────────────────────────┤
   │ REFUSED                                                    │
-  │ · an empty look                                            │
-  │ · kind and outer together                                  │
-  │ · a plane on an outer that has no card                     │
+  │ · a search outside the card does not run                   │
   └────────────────────────────────────────────────────────────┘
 ```
 
-A card views one plane. The lens check reads every card plane, but only the files the package ships (`package.json` `files`), so a packed install and the repo read the same. A file that does not ship is triage's job, one plane at a time.
+A session starts on dev. The card is in `.xray/state/LENS.md`. The planes are dev, integration, domain, and ecosystem. A search inside the current card runs. Any other search returns the card and does not run. Opening a file on another plane switches to that card.
 
-The refusals read: `Name a kind, one outer, or one plane.` · `Send kind or outer, not both.` · `plane goes with digest or triage only.`
+A thing on that plane has its own card. A card with no plate names the stamp-plate skill. Stamp one plate for that card.
+
+A name that is not a plane or a card says `Name one plane.`
 
 A checkout named `0xray` records `scripts/mjs/run-goggles-mcp.mjs`. Any other project records `node_modules/0xray/scripts/mjs/run-goggles-mcp.mjs`.
 

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

@@ -0,0 +1,35 @@
+---
+title: Ground
+sidebar_label: Ground
+---
+
+# Ground
+
+Home. The dev plane.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ this checkout                                      │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ read the dev card                                  │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ a change that stays in this repo                   │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+The card lists src, grok-bot/OP-PROC.md, grok-bot/LEXICON.md, src/opencode/agents, AGENTS.md, src/integrations, and package.json. The session starts on the dev plane.
+
+stamped · 0xray 4.1.0

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

@@ -0,0 +1,35 @@
+---
+title: Hermes
+sidebar_label: Hermes
+---
+
+# Hermes
+
+Hermes wears the suit through its bridge.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ a Hermes session                                   │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the bridge                                         │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the suit on that host                              │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+The host pack names Hermes. This card is `src/integrations/hermes-agent`. The bridge is `bridge.mjs`.
+
+stamped · 0xray 4.1.0

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

@@ -27,21 +27,21 @@ Plates have a type. A domain model plate shows how named parts fit. A state flow
 
 ## Pipeline
 
-[Routing](./routing.md) · [Governance](./governance.md) · [Boot](./boot.md) · [Orchestration](./orchestration.md) · [Processor](./processor.md) · [Reporting](./reporting.md) · [Memory recall](./memory-recall.md) · [Stamp plate](./stamp-plate.md)
+[Routing](./routing.md) · [Governance](./governance.md) · [Boot](./boot.md) · [Orchestration](./orchestration.md) · [Processor](./processor.md) · [Reporting](./reporting.md) · [Memory recall](./memory-recall.md) · [Stamp plate](./stamp-plate.md) · [Ground](./ground.md) · [Synthesis](./synthesis.md)
 
-Each of these is a lens plane. Each drawing is an input layer, a processing layer, and an output layer. Ground has no plate file.
+The planes are dev, integration, domain, and ecosystem. Each drawing above is a card on one of those planes. A plate id is not a plane.
 
 ## Write home
 
 [Record map](./record-map.md) · [Write home](./write-home.md) · [Activity log](./activity-log.md) · [Session capture](./session-capture.md) · [Suit wear](./suit-wear.md) · [Suit organs](./suit-organs.md)
 
-These six are the file ref. Each one is a search lens. The pipeline drawings above stay the lens planes for those machines.
+These six are the file ref. Each one is a card. The planes stay dev, integration, domain, and ecosystem.
 
 ## Hands
 
 [Station card](./station-card.md) · [Notes page](./notes-page.md) · [Reflection page](./reflection-page.md) · [Site manual](./site-manual.md) · [Package face](./package-face.md) · [Suit settings](./suit-settings.md) · [Trail state](./trail-state.md) · [Inference files](./inference-files.md)
 
-These eight are the pages the file ref names. Each one is a search lens. Each lens lists one skill and the plates that belong with it.
+These eight are the pages the file ref names. Each one is a card. Each card lists one skill.
 
 ## Compact path
 
@@ -51,6 +51,13 @@ These eight are the pages the file ref names. Each one is a search lens. Each le
 
 [Work fresh](./work-fresh.md) · [Kept line](./kept-line.md) · [Lens gate](./lens-gate.md) · [Pre tool](./pre-tool.md) · [Lens page](./lens-page.md)
 
-These five are the compact path that was opened. Each one is a search lens. Each lens lists one skill and the plates that belong with it.
+These five are the compact path that was opened. Each one is a card. Each card lists one skill.
+
+
+## Spectra
+
+[Repertoire](./repertoire.md) · [Dynamo](./dynamo.md) · [Foundry](./foundry.md) · [Delegation gate](./delegation-gate.md) · [Temperament](./temperament.md) · [Asides](./asides.md) · [Inference cycle](./inference-cycle.md) · [Hermes](./hermes.md) · [OpenClaw](./openclaw.md) · [OpenCode](./opencode.md) · [Consumer MCP](./consumer-mcp.md) · [Confer](./confer.md)
+
+Each one is a card. One top file. The planes stay dev, integration, domain, and ecosystem.
 
 stamped · 0xray 4.1.0

package/docs-site/docs/plates/inference-cycle.md

@@ -0,0 +1,35 @@
+---
+title: Inference cycle
+sidebar_label: Inference cycle
+---
+
+# Inference cycle
+
+The inference cycle turns a corpus into a proposal.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ a session corpus                                   │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ propose, then the codex votes                      │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ a governed proposal, or no change                  │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+The class is `InferenceCycle` in `src/inference/inference-cycle.ts`. The phases are collect, propose, govern, apply, deploy, and verify. Nearby files keep their own cards.
+
+stamped · 0xray 4.1.0

package/docs-site/docs/plates/lens-gate.md

@@ -5,33 +5,33 @@ sidebar_label: Lens gate
 
 # Lens gate
 
-A search names one plane or it stops.
+A search inside the current card runs.
 
 ```
 ┌────────────────────────────────────────────────────────────┐
 │ INPUT LAYER                                                │
 │   ┌────────────────────────────────────────────────────┐   │
-│   │ the tool name and the spoken text                     │   │
+│   │ the tool call and the file path                       │   │
 │   └──────────────────────────┬─────────────────────────┘   │
 └──────────────────────────────┼─────────────────────────────┘
              v
 ┌────────────┼───────────────────────────────────────────────┐
 │ PROCESSING LAYER                                            │
 │   ┌────────────────────────────────────────────────────┐   │
-│   │ count card-plane names                                │   │
+│   │ which plane the path is on                           │   │
 │   └──────────────────────────┬─────────────────────────┘   │
 └──────────────────────────────┼─────────────────────────────┘
                                v
 ┌──────────────────────────────┼─────────────────────────────┐
 │ OUTPUT LAYER                 v                             │
 │   ┌────────────────────────────────────────────────────┐   │
-│   │ allow on one name, otherwise stop                     │   │
+│   │ the card for the plane you are on                    │   │
 │   └────────────────────────────────────────────────────┘   │
 └────────────────────────────────────────────────────────────┘
 ```
 
-lensBeforeResearch in src/integrations/hooks/goggles-pipeline.mjs returns null when the call is not research, and when the spoken text names exactly one card plane. Zero names, or more than one, deny with Name one plane. A shell that reads a project source file is research. The first open of a source file that no lens lists is allowed and remembered. The next search stops until that file is on a lens and the plate is on disk. The hook does not author the plate. The plate that belongs here is pre-tool.
+lensBeforeResearch in src/integrations/hooks/goggles-pipeline.mjs looks at the path. A search inside the current card runs. Any other search returns the current card and does not run. Opening a file on the current plane adds nothing. Opening a file on another plane switches and returns that card. A file on no plane stays and returns the current card. The hook does not search the repo.
 
-Only the lens check spans planes. It reads, it does not search, so this gate does not stop it. Every other look and every search names one plane.
+A session starts on dev. Compact writes that same card back.
 
 stamped · 0xray 4.1.0

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

@@ -0,0 +1,35 @@
+---
+title: OpenClaw
+sidebar_label: OpenClaw
+---
+
+# OpenClaw
+
+OpenClaw wears the suit through its plugin.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ an OpenClaw session                                │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the plugin                                         │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the suit on that host                              │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+The host pack names OpenClaw. This card is `src/integrations/openclaw`.
+
+stamped · 0xray 4.1.0

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

@@ -0,0 +1,35 @@
+---
+title: OpenCode
+sidebar_label: OpenCode
+---
+
+# OpenCode
+
+OpenCode install writes the plugin.
+
+```
+┌────────────────────────────────────────────────────────────┐
+│ INPUT LAYER                                                │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ an install                                         │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+             v
+┌────────────┼───────────────────────────────────────────────┐
+│ PROCESSING LAYER                                            │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ copy the bridge and keep local edits               │   │
+│   └──────────────────────────┬─────────────────────────┘   │
+└──────────────────────────────┼─────────────────────────────┘
+                               v
+┌──────────────────────────────┼─────────────────────────────┐
+│ OUTPUT LAYER                 v                             │
+│   ┌────────────────────────────────────────────────────┐   │
+│   │ the OpenCode plugin on disk                        │   │
+│   └────────────────────────────────────────────────────┘   │
+└────────────────────────────────────────────────────────────┘
+```
+
+The command is `src/cli/commands/opencode-install.ts`. Existing `.yml`, `.yaml`, and `.md` files stay. `xray/features.json` is merged.
+
+stamped · 0xray 4.1.0