0xray 4.1.0 → 4.1.1

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.
Files changed (76) hide show
  1. package/.gitignore.default +4 -1
  2. package/.grok-plugin/plugin.json +1 -1
  3. package/.opencode/skills/orchestrator/SKILL.md +1 -7
  4. package/.xray/features.json +4 -1
  5. package/.xray/features.schema.json +8 -0
  6. package/AGENTS-consumer.md +1 -1
  7. package/AGENTS.md +2 -2
  8. package/README.md +2 -2
  9. package/dist/.gitignore.default +4 -1
  10. package/dist/AGENTS.md +2 -2
  11. package/dist/CHANGELOG.md +27 -1
  12. package/dist/README.md +2 -2
  13. package/dist/cli/commands/opencode-install.js +3 -9
  14. package/dist/cli/commands/skill-install.js +10 -5
  15. package/dist/cli/goggles-status.d.ts +2 -5
  16. package/dist/cli/goggles-status.js +5 -53
  17. package/dist/cli/index.js +2 -2
  18. package/dist/enforcement/enforcer-tools.d.ts +1 -1
  19. package/dist/enforcement/enforcer-tools.js +1 -1
  20. package/dist/integrations/cursor/README.md +1 -1
  21. package/dist/integrations/cursor/hooks/pre-tool-use.js +4 -0
  22. package/dist/integrations/grok/grok-cli.js +5 -7
  23. package/dist/integrations/grok/hooks/grok-hook-utils.js +4 -1
  24. package/dist/integrations/grok/hooks/pre-tool-use.js +4 -18
  25. package/dist/integrations/grok/hooks/session-start.js +4 -2
  26. package/dist/integrations/hermes-agent/bridge.mjs +4 -1
  27. package/dist/integrations/hooks/goggles-mcp.mjs +20 -196
  28. package/dist/integrations/hooks/goggles-pipeline.mjs +606 -616
  29. package/dist/integrations/hooks/goggles-planes.json +88 -40
  30. package/dist/integrations/hooks/plates.cjs +84 -0
  31. package/dist/integrations/hooks/pre-tool-speak.mjs +2 -4
  32. package/dist/integrations/hooks/skill-seek.mjs +115 -0
  33. package/dist/integrations/hooks/station-hook-runtime.cjs +4 -1
  34. package/dist/integrations/openclaw/hooks/pre-tool-gate-runtime.mjs +4 -4
  35. package/dist/integrations/openclaw/plugin/xray-pre-tool/index.js +10 -1
  36. package/dist/integrations/openclaw/plugin/xray-pre-tool/package.json +1 -1
  37. package/dist/memory-routing/plates.d.ts +1 -1
  38. package/dist/memory-routing/plates.js +14 -0
  39. package/dist/nucleus/thin-dispatch.d.ts +1 -1
  40. package/dist/nucleus/thin-dispatch.js +1 -1
  41. package/dist/nucleus/work-freshness.mjs +10 -0
  42. package/dist/plugin/xray-codex-injection.js +3 -1
  43. package/dist/skills/orchestrator/SKILL.md +1 -7
  44. package/docs-site/docs/plates/asides.md +35 -0
  45. package/docs-site/docs/plates/confer.md +35 -0
  46. package/docs-site/docs/plates/consumer-mcp.md +35 -0
  47. package/docs-site/docs/plates/delegation-gate.md +35 -0
  48. package/docs-site/docs/plates/dynamo.md +35 -0
  49. package/docs-site/docs/plates/foundry.md +35 -0
  50. package/docs-site/docs/plates/goggles.md +8 -8
  51. package/docs-site/docs/plates/ground.md +35 -0
  52. package/docs-site/docs/plates/hermes.md +35 -0
  53. package/docs-site/docs/plates/index.md +12 -5
  54. package/docs-site/docs/plates/inference-cycle.md +35 -0
  55. package/docs-site/docs/plates/lens-gate.md +6 -6
  56. package/docs-site/docs/plates/openclaw.md +35 -0
  57. package/docs-site/docs/plates/opencode.md +35 -0
  58. package/docs-site/docs/plates/repertoire.md +35 -0
  59. package/docs-site/docs/plates/synthesis.md +35 -0
  60. package/docs-site/docs/plates/temperament.md +35 -0
  61. package/docs-site/docs/plates/trail-state.md +1 -1
  62. package/package.json +1 -1
  63. package/scripts/foundry/README.md +3 -1
  64. package/scripts/foundry/mint-suit.cjs +120 -2
  65. package/scripts/foundry/plant/skills/mill/SKILL.md +1 -1
  66. package/scripts/foundry/reconcile-version.mjs +10 -3
  67. package/scripts/foundry/release.mjs +1 -1
  68. package/scripts/foundry/validate-release-docs.mjs +2 -2
  69. package/scripts/foundry/version-manager.mjs +12 -4
  70. package/scripts/node/install-bridges.cjs +63 -34
  71. package/scripts/node/pack-tmp-suit-proof.mjs +23 -4
  72. package/src/integrations/openclaw/plugin/xray-pre-tool/index.js +10 -1
  73. package/src/integrations/openclaw/plugin/xray-pre-tool/package.json +1 -1
  74. package/src/skills/orchestrator/SKILL.md +1 -7
  75. package/xray/features.json +4 -1
  76. package/xray/features.schema.json +8 -0
@@ -100,7 +100,25 @@ export function wornSkillNames(consumerRoot) {
100
100
  );
101
101
  }
102
102
 
103
- export function assertFastenedMillPlant(consumerRoot) {
103
+ function catalogSkillNamesNear(millRoot) {
104
+ let dir = millRoot;
105
+ for (let i = 0; i < 4 && dir; i += 1) {
106
+ for (const rel of ["dist/skills", "src/skills"]) {
107
+ const skills = path.join(dir, rel);
108
+ if (!fs.existsSync(skills)) continue;
109
+ const names = fs.readdirSync(skills).filter((name) =>
110
+ fs.existsSync(path.join(skills, name, "SKILL.md")),
111
+ );
112
+ if (names.length > 0) return names;
113
+ }
114
+ const parent = path.dirname(dir);
115
+ if (parent === dir) break;
116
+ dir = parent;
117
+ }
118
+ return [];
119
+ }
120
+
121
+ export function assertFastenedMillPlant(consumerRoot, millRoot = consumerRoot) {
104
122
  const inventoryPath = path.join(consumerRoot, ".xray", "foundry-inventory.json");
105
123
  if (!fs.existsSync(inventoryPath)) {
106
124
  throw new Error("foundry-inventory.json missing — mill did not fasten");
@@ -126,8 +144,9 @@ export function assertFastenedMillPlant(consumerRoot) {
126
144
  }
127
145
  }
128
146
  const worn = wornSkillNames(consumerRoot);
147
+ const catalog = catalogSkillNamesNear(millRoot);
129
148
  const extras = worn.filter(
130
- (name) => !MILL_PLANT_SKILLS.includes(name) && !FACTORY_SHOP_SKILLS.includes(name),
149
+ (name) => !MILL_PLANT_SKILLS.includes(name) && !FACTORY_SHOP_SKILLS.includes(name) && !catalog.includes(name),
131
150
  );
132
151
  if (extras.length > 0) {
133
152
  throw new Error(`costume dump extras before hangar plant: ${extras.join(",")}`);
@@ -145,7 +164,7 @@ export function proveSuitAfterInstall(consumerRoot, millRoot) {
145
164
  if (mint.status !== 0) {
146
165
  throw new Error(`foundry mint --skip-live failed:\n${mint.stdout}\n${mint.stderr}`);
147
166
  }
148
- const inventory = assertFastenedMillPlant(consumerRoot);
167
+ const inventory = assertFastenedMillPlant(consumerRoot, millRoot);
149
168
  if (inventory.suit !== "fastened" && inventory.suit !== "overlay") {
150
169
  throw new Error(`expected fastened/overlay suit, got ${inventory.suit}`);
151
170
  }
@@ -180,7 +199,7 @@ export function proveSuitAfterInstall(consumerRoot, millRoot) {
180
199
  if (Array.isArray(plantVsWorn.extraSkills) && plantVsWorn.extraSkills.length > 0) {
181
200
  throw new Error(`inspect extraSkills after hangar plant: ${plantVsWorn.extraSkills.join(",")}`);
182
201
  }
183
- const after = assertFastenedMillPlant(consumerRoot);
202
+ const after = assertFastenedMillPlant(consumerRoot, millRoot);
184
203
  if (after.costume === true) {
185
204
  throw new Error("costume flipped true after hangar plant");
186
205
  }
@@ -69,9 +69,18 @@ export default definePluginEntry({
69
69
  if (!speakPath) return undefined;
70
70
  const speak = await import(pathToFileURL(speakPath).href);
71
71
  const lens = speak.lensDecision(projectRoot, event.toolName, spoken);
72
- if (lens) {
72
+ if (lens?.decision === 'deny') {
73
73
  return { block: true, blockReason: lens.reason };
74
74
  }
75
+ if (lens?.reason) {
76
+ return {
77
+ block: false,
78
+ hookSpecificOutput: {
79
+ hookEventName: 'PreToolUse',
80
+ additionalContext: lens.reason,
81
+ },
82
+ };
83
+ }
75
84
  const route = speak.repertoireRoute(spoken);
76
85
  if (route?.hookSpecificOutput) {
77
86
  return { block: false, hookSpecificOutput: route.hookSpecificOutput };
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "xray-pre-tool",
3
- "version": "4.1.0",
3
+ "version": "4.1.1",
4
4
  "private": true,
5
5
  "type": "module",
6
6
  "description": "0xRay constitution + temperament PreToolUse for OpenClaw",
@@ -57,13 +57,7 @@ When `multi_agent_orchestration.lead_dev_mode` is true in `features.json` (defau
57
57
 
58
58
  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.
59
59
 
60
- 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.
61
-
62
- 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.
63
-
64
- 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.
65
-
66
- 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.
60
+ 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.
67
61
 
68
62
  ## Hooks (rewired, not new MCPs)
69
63
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "./features.schema.json",
3
- "version": "4.1.0",
3
+ "version": "4.1.1",
4
4
  "description": "0xRay Framework - Unified Feature Configuration",
5
5
  "suit_temperament": {
6
6
  "profile": "auto",
@@ -12,6 +12,9 @@
12
12
  "generic": "guided"
13
13
  }
14
14
  },
15
+ "goggles": {
16
+ "enabled": true
17
+ },
15
18
  "token_optimization": {
16
19
  "enabled": true,
17
20
  "max_context_tokens": 20000,
@@ -132,6 +132,14 @@
132
132
  }
133
133
  }
134
134
  },
135
+ "goggles": {
136
+ "type": "object",
137
+ "description": "The suit keeps goggles on. enabled false fails wear and doctor.",
138
+ "properties": {
139
+ "enabled": { "type": "boolean" }
140
+ },
141
+ "required": ["enabled"]
142
+ },
135
143
  "synthesis": {
136
144
  "type": "object",
137
145
  "properties": {