@rune-kit/rune 2.22.0 → 2.22.1

package/README.md

@@ -83,9 +83,9 @@ _Methodology: Claude Code CLI headless mode (`claude -p --output-format json`),
 
 ---
 
-## What's New (v2.22.0 — Convergence, Dogfooded)
+## What's New (v2.22.1 — Convergence, Dogfooded)
 
-> **v2.22.0 (2026-07-03):** The v2.21.0 gates went through a live-fire dogfood: fresh executor agents (zero author context) ran `converge` and `verification` Level 3.5 against a fixture with a dead Submit button, a handler-less Export button, a navigation-anchor decoy, and a declared placeholder. **Both gates caught the dead button with file:line evidence and zero false positives** — and the 16 ambiguities the executors reported became spec fixes: converge v0.2.0 adds a `deferred-debt` class (declared design debt can no longer force a false escalation), a `Plan Claims vs Reality` section (tasks marked `[x]` whose code doesn't exist — surfaced first-class), and derived story verdicts; verification v0.7.0 gets FAIL-dominates precedence, per-route reverse checks, and server/static entry-point exemptions. The dogfood fixture itself shipped as the seed of **`npm run eval`** — a behavioral eval harness that runs a fresh headless agent against fixture repos and asserts outcomes, because structural validation can't prove a skill makes an agent behave. Pro `autopilot` v1.6.0 now explicitly runs Phase 6.5 CONVERGE in autonomous mode.
+> **v2.22.1 (2026-07-03):** Patch: tier-hook loader accepts PreCompact + SessionStart lifecycle events — required by Pro hooks v1.2.0 (context-reset). **v2.22.0:** The v2.21.0 gates went through a live-fire dogfood: fresh executor agents (zero author context) ran `converge` and `verification` Level 3.5 against a fixture with a dead Submit button, a handler-less Export button, a navigation-anchor decoy, and a declared placeholder. **Both gates caught the dead button with file:line evidence and zero false positives** — and the 16 ambiguities the executors reported became spec fixes: converge v0.2.0 adds a `deferred-debt` class (declared design debt can no longer force a false escalation), a `Plan Claims vs Reality` section (tasks marked `[x]` whose code doesn't exist — surfaced first-class), and derived story verdicts; verification v0.7.0 gets FAIL-dominates precedence, per-route reverse checks, and server/static entry-point exemptions. The dogfood fixture itself shipped as the seed of **`npm run eval`** — a behavioral eval harness that runs a fresh headless agent against fixture repos and asserts outcomes, because structural validation can't prove a skill makes an agent behave. Pro `autopilot` v1.6.0 now explicitly runs Phase 6.5 CONVERGE in autonomous mode.
 
 ### Previous (v2.21.0 — Convergence)
 

package/compiler/__tests__/hooks-tiers.test.js

@@ -161,6 +161,21 @@ describe('validateManifest', () => {
     });
     assert.strictEqual(m.entries[0].matcher, null);
   });
+
+  test('accepts PreCompact and SessionStart lifecycle events without matcher', () => {
+    // Pro hooks manifest v1.2.0 wires context-reset on both — Free must load it (was rejected pre-v2.22.1)
+    const m = validateManifest({
+      tier: 'pro',
+      entries: [
+        { id: 'context-reset-precompact', event: 'PreCompact', command: 'node context-reset.cjs' },
+        { id: 'context-reset-sessionstart', event: 'SessionStart', command: 'node context-reset.cjs' },
+      ],
+    });
+    assert.strictEqual(m.entries.length, 2);
+    assert.strictEqual(m.entries[0].event, 'PreCompact');
+    assert.strictEqual(m.entries[0].matcher, null);
+    assert.strictEqual(m.entries[1].event, 'SessionStart');
+  });
 });
 
 describe('loadTierManifest + locateTierManifest', () => {

package/compiler/commands/hooks/tiers.js

@@ -78,7 +78,18 @@ export function compareSemver(a, b) {
 }
 
 /** Valid event names a manifest entry may declare. */
-const VALID_EVENTS = new Set(['UserPromptSubmit', 'PreToolUse', 'PostToolUse', 'Stop', 'statusLine']);
+const VALID_EVENTS = new Set([
+  'UserPromptSubmit',
+  'PreToolUse',
+  'PostToolUse',
+  'Stop',
+  'statusLine',
+  'PreCompact',
+  'SessionStart',
+]);
+
+/** Lifecycle events where `matcher` is optional (PreCompact matches manual|auto, SessionStart matches startup|resume — both default to all when omitted). */
+const MATCHER_OPTIONAL_EVENTS = new Set(['statusLine', 'Stop', 'PreCompact', 'SessionStart']);
 
 /** Tier names must be simple lowercase identifiers. Blocks `../../etc` and similar traversal. */
 const TIER_NAME_RE = /^[a-z][a-z0-9-]{0,31}$/;
@@ -178,7 +189,7 @@ export function validateManifest(manifest, source = '<memory>') {
     if (raw.matcher !== undefined && typeof raw.matcher !== 'string') {
       throw new Error(`${where}: 'matcher' must be a string if present`);
     }
-    if (raw.event !== 'statusLine' && raw.event !== 'Stop' && !raw.matcher) {
+    if (!MATCHER_OPTIONAL_EVENTS.has(raw.event) && !raw.matcher) {
       throw new Error(`${where}: '${raw.event}' requires a 'matcher' string (e.g. 'Edit|Write' or '.*')`);
     }
     if (raw.globs !== undefined && !Array.isArray(raw.globs)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rune-kit/rune",
-  "version": "2.22.0",
+  "version": "2.22.1",
   "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": {