@rune-kit/rune 2.26.1 → 2.26.2

package/README.md

@@ -103,11 +103,15 @@ Plus **9 domain packs** (product, sales, data-science, support, growth, media, p
 
 ---
 
-## What's New (v2.26.1 — Codex Wiring)
+## What's New (v2.26.2 — Hook Output Contract)
+
+> **v2.26.2 (2026-07-22):** The other half of the Codex wiring fix — v2.26.1 made the hook matchers fire, this makes the hooks **succeed**. Codex parses hook stdout as JSON and reports anything else as `hook: <Event> Failed`, discarding the output; Rune's hooks printed bare `[Rune: ...]` lines, so every hook that loaded on Codex ran, exited 0, and had its output thrown away. Hooks now emit the envelope both runtimes accept — `hookSpecificOutput.additionalContext` for context events, `systemMessage` otherwise — which is Claude Code's documented contract too, not a Codex branch. Verified live against codex-cli 0.145: the same hook goes `SessionStart Failed` → `SessionStart Completed`.
+
+### Previous (v2.26.1 — Codex Wiring)
 
 > **v2.26.1 (2026-07-22):** Rune's runtime hooks were silently inert on **Codex CLI**. `hooks/hooks.json` is loaded by both Claude Code and Codex — Codex reads `<plugin>/hooks/hooks.json`, the same path, and maps the event names — but every tool matcher named only Claude's tools. Codex has no `Read`, `Write`, `Edit` or `Bash` tool; it issues `shell_command`, `exec`, `apply_patch`, `view_image`, `spawn_agent`. So the privacy gate and the secret scanner matched nothing and never fired. Matchers now name both platforms' tools (plain alternation — Claude behaviour is byte-for-byte unchanged), and `pre-tool-guard` reads the target path out of a Codex `apply_patch` payload (`*** Update File: <path>`), which is what makes it an actual gate there instead of a no-op. Note that Codex does not support `async` hooks yet and skips them, so Rune's six background hooks stay inactive on Codex — `async` is kept because Claude Code honours it.
 
-### Previous (v2.26.0 — Motion Craft)
+#### Earlier (v2.26.0 — Motion Craft)
 
 > **v2.26.0 (2026-07-18):** Rune's UI mesh gains a deep **motion authority**. New reference `skills/design/MOTION-CRAFT.md` is the canonical source for animation decisions: the *should-it-animate* frequency gate (never animate keyboard/100+-per-day actions), easing decision tree with strong custom curves, per-element duration budgets (UI under 300ms, modals/drawers exempt to 500ms), physicality rules (never `scale(0)`, origin-aware popovers, press feedback), spring physics (damping/response, velocity handoff, momentum projection, rubber-banding), interruptibility (transitions vs keyframes, `@starting-style`), motion performance, reduced-motion, and a reverse-lookup vocabulary glossary. `design` (v0.8.0) loads it whenever a domain involves motion and gains an advisory motion-audit mode. `review` (v1.5.0) adds **Motion Craft Checks** — an advisory lens that fires only on motion diffs, flagging `ease-in` on UI, `scale(0)` entrances, animation on high-frequency actions, layout-property animation, and more, citing MOTION-CRAFT for exact fixes. `perf` (v0.6.0) adds **Step 5.5 Motion Performance** — GPU-property, Framer-Motion-shorthand, and recalc-storm detection ranked in the Cost Impact Hierarchy. Advisory-first throughout (no new HARD-GATEs) — enrichment only, mesh unchanged at 66 skills.
 

package/hooks/lib/hook-output.cjs

@@ -0,0 +1,102 @@
+'use strict';
+
+// Hook stdout envelope — the one format both runtimes accept.
+//
+// Claude Code tolerates bare text on a hook's stdout. Codex CLI does not: it
+// parses stdout as its `HookUniversalOutputWire` JSON and reports anything else
+// as `hook: <Event> Failed`, discarding the output. Every Rune hook that printed
+// a plain `[Rune: ...]` line was therefore failing on Codex — the hooks loaded,
+// ran, exited 0, and had their output thrown away.
+//
+// Both runtimes accept the same envelope, so emitting it is not a Codex-specific
+// branch — it is simply the correct output contract:
+//
+//   {"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"…"}}
+//   {"systemMessage":"…"}
+//
+// Verified against codex-cli 0.145 (schema read from the binary: decision,
+// reason, continue, stopReason, suppressOutput, systemMessage, and
+// hookSpecificOutput.{hookEventName,additionalContext,permissionDecision,…};
+// unknown keys are rejected) and Claude Code's documented hook output.
+//
+// Buffer-then-emit, because the envelope is ONE JSON object: a hook that prints
+// three lines must accumulate them and emit once at exit, not three times.
+
+/** Events where the model-facing payload is `additionalContext`. */
+const CONTEXT_EVENTS = new Set(['SessionStart', 'UserPromptSubmit']);
+
+/**
+ * Collects a hook's output and emits a single valid envelope.
+ *
+ * @param {string} hookEventName  Claude/Codex event name, e.g. 'SessionStart'
+ * @returns {{line: (text: string) => void, emit: () => void, isEmpty: () => boolean}}
+ */
+function outputBuffer(hookEventName) {
+  const parts = [];
+  return {
+    /** Queue one line of output. Empty/blank input is ignored. */
+    line(text) {
+      if (typeof text !== 'string') return;
+      const trimmed = text.replace(/\s+$/, '');
+      if (trimmed.trim()) parts.push(trimmed);
+    },
+    isEmpty() {
+      return parts.length === 0;
+    },
+    /** Write the envelope. Emits nothing at all when there is nothing to say. */
+    emit() {
+      if (parts.length === 0) return;
+      const text = parts.join('\n');
+      const payload = CONTEXT_EVENTS.has(hookEventName)
+        ? { hookSpecificOutput: { hookEventName, additionalContext: text } }
+        : { systemMessage: text };
+      process.stdout.write(`${JSON.stringify(payload)}\n`);
+    },
+  };
+}
+
+/**
+ * One-shot form for hooks with a single message.
+ *
+ * @param {string} hookEventName
+ * @param {string} text
+ */
+function emit(hookEventName, text) {
+  const buf = outputBuffer(hookEventName);
+  buf.line(text);
+  buf.emit();
+}
+
+/**
+ * Route a hook's existing `console.log` calls into one envelope.
+ *
+ * Hooks build their message across many prints and several early `process.exit`
+ * paths. Rewriting each print site into an explicit buffer would mean touching
+ * every branch — and missing one silently reintroduces the bare-text bug. So
+ * capture at the boundary instead: the message logic stays exactly as written,
+ * and the envelope is emitted once on exit no matter which branch got there.
+ *
+ * `console.error` is untouched — stderr is not parsed as the output contract.
+ *
+ * @param {string} hookEventName
+ * @returns {{buffer: ReturnType<typeof outputBuffer>, restore: () => void}}
+ */
+function captureConsole(hookEventName) {
+  const buffer = outputBuffer(hookEventName);
+  const original = console.log;
+  console.log = (...args) => {
+    buffer.line(args.map((a) => (typeof a === 'string' ? a : String(a))).join(' '));
+  };
+  const restore = () => {
+    console.log = original;
+  };
+  // Fires for a natural end AND for process.exit(), which is how the BLOCK
+  // paths leave — those messages must survive too.
+  process.on('exit', () => {
+    restore();
+    buffer.emit();
+  });
+  return { buffer, restore };
+}
+
+module.exports = { outputBuffer, emit, captureConsole, CONTEXT_EVENTS };

package/hooks/post-session-reflect/index.cjs

@@ -5,6 +5,11 @@
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
+const { captureConsole } = require('../lib/hook-output.cjs');
+// Hook stdout is a JSON contract, not free text (Codex rejects bare lines and
+// discards the output). Capture the prints below and emit one envelope on exit.
+captureConsole('Stop');
+
 
 const cwd = process.cwd();
 const hash = Buffer.from(cwd).toString('base64url').slice(0, 16);

package/hooks/pre-compact/index.cjs

@@ -9,6 +9,12 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
+const { captureConsole } = require('../lib/hook-output.cjs');
+// Hook stdout is a JSON contract, not free text (Codex rejects bare lines and
+// discards the output). Capture the prints below and emit one envelope on exit.
+captureConsole('PreCompact');
+
+
 const cwd = process.cwd();
 const runeDir = path.join(cwd, '.rune');
 

package/hooks/pre-tool-guard/index.cjs

@@ -15,6 +15,12 @@
 const fs = require('fs');
 const path = require('path');
 
+const { captureConsole } = require('../lib/hook-output.cjs');
+// Hook stdout is a JSON contract, not free text (Codex rejects bare lines and
+// discards the output). Capture the prints below and emit one envelope on exit.
+captureConsole('PreToolUse');
+
+
 /**
  * Append a structured gate-outcome record to .rune/metrics/gate-outcomes.jsonl
  * relative to process.cwd(). Best-effort: any error is silently swallowed so

package/hooks/session-start/index.cjs

@@ -4,6 +4,11 @@
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
+const { captureConsole } = require('../lib/hook-output.cjs');
+// Hook stdout is a JSON contract, not free text (Codex rejects bare lines and
+// discards the output). Capture the prints below and emit one envelope on exit.
+captureConsole('SessionStart');
+
 
 const cwd = process.cwd();
 const runeDir = path.join(cwd, '.rune');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rune-kit/rune",
-  "version": "2.26.1",
+  "version": "2.26.2",
   "description": "65-skill mesh for AI coding assistants — runtime auto-discipline via native hooks (Claude/Cursor/Windsurf/Antigravity), 5-layer architecture, 204 connections + 43 signals, multi-platform compiler. converge (L3) scans spec vs code so dead-button/frontend-only implementations can't ship.",
   "type": "module",
   "bin": {