greprag 5.49.8 → 5.49.10

package/dist/commands/collision-reminder.d.ts

@@ -0,0 +1,14 @@
+/** collision-reminder — the coordinate gate as a registry MATCH(command) module
+ *  (docs/reminder-interrupt.md — the landed map). The first `source: 'command'`
+ *  reminder: it reads `env.toolCommand` (the Bash command about to run, populated
+ *  only at PreToolUse), matches it against the risky shared-state signatures, and
+ *  fires the coordinate directive IF a same-repo peer is live.
+ *
+ *  PURE, like every module: the hot-path I/O (the fresh watcher read → live peers)
+ *  stays in the hook, which passes the result as `env.collisionPeers`. This module
+ *  only classifies the command (pure) + formats the directive — reusing the proven
+ *  `classifyRiskyCommand` / `buildCoordinateDirective` from coordinate-gate.ts. So
+ *  the standalone PreToolUse coordinate-gate control point is folded into the one
+ *  registry `detect(env)` path. */
+import { ReminderModule } from './reminder-types';
+export declare const collisionMatchModule: ReminderModule;

package/dist/commands/collision-reminder.js

@@ -0,0 +1,40 @@
+"use strict";
+/** collision-reminder — the coordinate gate as a registry MATCH(command) module
+ *  (docs/reminder-interrupt.md — the landed map). The first `source: 'command'`
+ *  reminder: it reads `env.toolCommand` (the Bash command about to run, populated
+ *  only at PreToolUse), matches it against the risky shared-state signatures, and
+ *  fires the coordinate directive IF a same-repo peer is live.
+ *
+ *  PURE, like every module: the hot-path I/O (the fresh watcher read → live peers)
+ *  stays in the hook, which passes the result as `env.collisionPeers`. This module
+ *  only classifies the command (pure) + formats the directive — reusing the proven
+ *  `classifyRiskyCommand` / `buildCoordinateDirective` from coordinate-gate.ts. So
+ *  the standalone PreToolUse coordinate-gate control point is folded into the one
+ *  registry `detect(env)` path. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collisionMatchModule = void 0;
+const coordinate_gate_1 = require("./coordinate-gate");
+exports.collisionMatchModule = {
+    id: 'collision',
+    source: 'command',
+    // Fire only when: there is a command, it is a risky shared-state action, AND a
+    // same-repo peer is live. Any miss → silent (the action proceeds ungated).
+    detect: (env) => {
+        if (!env.toolCommand)
+            return { tier: 'silent' };
+        if (!(0, coordinate_gate_1.classifyRiskyCommand)(env.toolCommand))
+            return { tier: 'silent' };
+        if (!env.collisionPeers || env.collisionPeers.length === 0)
+            return { tier: 'silent' };
+        return { tier: 'nag' };
+    },
+    announce: () => null,
+    reminder: (_d, env) => {
+        const trigger = env.toolCommand ? (0, coordinate_gate_1.classifyRiskyCommand)(env.toolCommand) : null;
+        const peers = env.collisionPeers ?? [];
+        if (!trigger || peers.length === 0)
+            return null;
+        return (0, coordinate_gate_1.buildCoordinateDirective)(trigger, peers, env.short, env.alias ?? null);
+    },
+};
+//# sourceMappingURL=collision-reminder.js.map

package/dist/commands/collision-reminder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collision-reminder.js","sourceRoot":"","sources":["../../src/commands/collision-reminder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;mCAWmC;;;AAGnC,uDAAmF;AAEtE,QAAA,oBAAoB,GAAmB;IAClD,EAAE,EAAE,WAAW;IACf,MAAM,EAAE,SAAS;IACjB,+EAA+E;IAC/E,2EAA2E;IAC3E,MAAM,EAAE,CAAC,GAAgB,EAAa,EAAE;QACtC,IAAI,CAAC,GAAG,CAAC,WAAW;YAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAChD,IAAI,CAAC,IAAA,sCAAoB,EAAC,GAAG,CAAC,WAAW,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACtE,IAAI,CAAC,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACtF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACzB,CAAC;IACD,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI;IACpB,QAAQ,EAAE,CAAC,EAAE,EAAE,GAAgB,EAAiB,EAAE;QAChD,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAA,sCAAoB,EAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/E,MAAM,KAAK,GAAG,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAChD,OAAO,IAAA,0CAAwB,EAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;IAChF,CAAC;CACF,CAAC"}

package/dist/commands/coordinate-gate.d.ts

@@ -56,7 +56,9 @@ export declare function triggerFromPreToolUse(toolName: string, toolInput: Recor
 /** The LOUD coordinate directive — names the action + the live same-repo peers
  *  and tells the agent to message them BEFORE proceeding. PURE, source-agnostic
  *  (takes a CoordinateTrigger, not a PreToolUse event). */
-export declare function buildCoordinateDirective(trigger: CoordinateTrigger, peers: CollisionPeer[], myShort: string, alias: string | null): string;
+export declare function buildCoordinateDirective(trigger: CoordinateTrigger, peers: Array<{
+    short: string;
+}>, myShort: string, alias: string | null): string;
 export interface CoordinateGateOptions {
     short: string;
     projectId: string | null;
@@ -65,9 +67,13 @@ export interface CoordinateGateOptions {
     apiKey: string;
     alias: string | null;
 }
-/** Source-agnostic eval+message. Given a trigger from ANY source, do a FRESH
- *  watcher read, detect same-repo peers, and return the LOUD directive — or null
- *  if no peer is live in this repo. NO dedup, NO local state: a fresh read every
- *  call. Best-effort: any failure (network, unanchored) → null (fail-open, the
- *  action proceeds ungated). */
+/** FRESH watcher read → the same-repo peers live right now (the I/O half, kept out
+ *  of the pure module). NO dedup, NO local state: a fresh read every call. Empty on
+ *  any failure / no peer (fail-open). The collision Match-on-command module
+ *  (collision-reminder.ts) calls this in the hook, then detects purely on the result. */
+export declare function resolveCollisionPeers(opts: CoordinateGateOptions): Promise<CollisionPeer[]>;
+/** Source-agnostic eval+message. Given a trigger from ANY source, resolve live
+ *  same-repo peers and return the LOUD directive — or null if none. Retained for
+ *  the existing PreToolUse path + tests; the registry now reaches the same result
+ *  via resolveCollisionPeers + the collision module. */
 export declare function runCoordinateGate(trigger: CoordinateTrigger, opts: CoordinateGateOptions): Promise<string | null>;

package/dist/commands/coordinate-gate.js

@@ -40,13 +40,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.classifyRiskyCommand = classifyRiskyCommand;
 exports.triggerFromPreToolUse = triggerFromPreToolUse;
 exports.buildCoordinateDirective = buildCoordinateDirective;
+exports.resolveCollisionPeers = resolveCollisionPeers;
 exports.runCoordinateGate = runCoordinateGate;
 const collision_check_1 = require("./collision-check");
 /** Risky shared-state command signatures. Each segment of a (possibly chained)
  *  Bash command is tested against these. SPECIFIC to the Bash/PreToolUse source. */
 const RISKY_PATTERNS = [
     { kind: 'merge', label: 'git merge', re: /^git\s+merge\b/ },
-    { kind: 'push', label: 'git push', re: /^git\s+push\b/ },
+    { kind: 'merge', label: 'git rebase', re: /^git\s+rebase\b/ }, // rewrites shared history
+    { kind: 'merge', label: 'gh pr merge', re: /^gh\s+pr\s+merge\b/ },
+    { kind: 'push', label: 'git push', re: /^git\s+push\b/ }, // incl. --force
     { kind: 'deploy', label: 'wrangler deploy', re: /^(?:npx\s+)?wrangler\s+deploy\b/ },
     { kind: 'deploy', label: 'npm run deploy', re: /^npm\s+run\s+deploy\b/ },
     { kind: 'deploy', label: 'npm publish', re: /^npm\s+publish\b/ },
@@ -91,16 +94,27 @@ function buildCoordinateDirective(trigger, peers, myShort, alias) {
         + `Ping before proceeding — greprag send "heads up, about to ${trigger.label}" `
         + `--to ${handle}@greprag.com/<8hex> --from-session ${myShort}`);
 }
-/** Source-agnostic eval+message. Given a trigger from ANY source, do a FRESH
- *  watcher read, detect same-repo peers, and return the LOUD directive — or null
- *  if no peer is live in this repo. NO dedup, NO local state: a fresh read every
- *  call. Best-effort: any failure (network, unanchored) → null (fail-open, the
- *  action proceeds ungated). */
+/** FRESH watcher read → the same-repo peers live right now (the I/O half, kept out
+ *  of the pure module). NO dedup, NO local state: a fresh read every call. Empty on
+ *  any failure / no peer (fail-open). The collision Match-on-command module
+ *  (collision-reminder.ts) calls this in the hook, then detects purely on the result. */
+async function resolveCollisionPeers(opts) {
+    try {
+        const watchers = await (0, collision_check_1.fetchTenantWatchers)(opts.apiUrl, opts.apiKey);
+        if (watchers.length === 0)
+            return [];
+        return (0, collision_check_1.detectCollisions)(opts.short, opts.projectId, opts.projectName, watchers);
+    }
+    catch {
+        return [];
+    }
+}
+/** Source-agnostic eval+message. Given a trigger from ANY source, resolve live
+ *  same-repo peers and return the LOUD directive — or null if none. Retained for
+ *  the existing PreToolUse path + tests; the registry now reaches the same result
+ *  via resolveCollisionPeers + the collision module. */
 async function runCoordinateGate(trigger, opts) {
-    const watchers = await (0, collision_check_1.fetchTenantWatchers)(opts.apiUrl, opts.apiKey);
-    if (watchers.length === 0)
-        return null;
-    const peers = (0, collision_check_1.detectCollisions)(opts.short, opts.projectId, opts.projectName, watchers);
+    const peers = await resolveCollisionPeers(opts);
     if (peers.length === 0)
         return null;
     return buildCoordinateDirective(trigger, peers, opts.short, opts.alias);

package/dist/commands/coordinate-gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"coordinate-gate.js","sourceRoot":"","sources":["../../src/commands/coordinate-gate.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iFAoCiF;;AAkCjF,oDAQC;AAMD,sDAMC;AAKD,4DAWC;AAgBD,8CAQC;AA5FD,uDAE2B;AAW3B;oFACoF;AACpF,MAAM,cAAc,GAA0E;IAC5F,EAAE,IAAI,EAAE,OAAO,EAAG,KAAK,EAAE,WAAW,EAAU,EAAE,EAAE,gBAAgB,EAAE;IACpE,EAAE,IAAI,EAAE,MAAM,EAAI,KAAK,EAAE,UAAU,EAAW,EAAE,EAAE,eAAe,EAAE;IACnE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,iBAAiB,EAAI,EAAE,EAAE,iCAAiC,EAAE;IACrF,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,gBAAgB,EAAK,EAAE,EAAE,uBAAuB,EAAE;IAC3E,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAQ,EAAE,EAAE,kBAAkB,EAAE;IACtE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,EAAE,0BAA0B,EAAE;CAC/E,CAAC;AAEF,2EAA2E;AAC3E,SAAS,eAAe,CAAC,OAAe;IACtC,OAAO,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC7E,CAAC;AAED;;sBAEsB;AACtB,SAAgB,oBAAoB,CAAC,OAAe;IAClD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC;YAC/B,IAAI,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QAC9D,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;4DAG4D;AAC5D,SAAgB,qBAAqB,CACnC,QAAgB,EAAE,SAAkC;IAEpD,IAAI,QAAQ,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,OAAO,GAAG,OAAO,SAAS,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;2DAE2D;AAC3D,SAAgB,wBAAwB,CACtC,OAA0B,EAAE,KAAsB,EAAE,OAAe,EAAE,KAAoB;IAEzF,MAAM,MAAM,GAAG,KAAK,IAAI,UAAU,CAAC;IACnC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,CACL,qBAAqB,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,QAAQ,MAAM,uBAAuB,IAAI,KAAK;UAC/F,6DAA6D,OAAO,CAAC,KAAK,IAAI;UAC9E,QAAQ,MAAM,sCAAsC,OAAO,EAAE,CAChE,CAAC;AACJ,CAAC;AAWD;;;;gCAIgC;AACzB,KAAK,UAAU,iBAAiB,CACrC,OAA0B,EAAE,IAA2B;IAEvD,MAAM,QAAQ,GAAG,MAAM,IAAA,qCAAmB,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACrE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,KAAK,GAAG,IAAA,kCAAgB,EAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACvF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,wBAAwB,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC"}
+{"version":3,"file":"coordinate-gate.js","sourceRoot":"","sources":["../../src/commands/coordinate-gate.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iFAoCiF;;AAoCjF,oDAQC;AAMD,sDAMC;AAKD,4DAWC;AAeD,sDAQC;AAMD,8CAMC;AAzGD,uDAE2B;AAW3B;oFACoF;AACpF,MAAM,cAAc,GAA0E;IAC5F,EAAE,IAAI,EAAE,OAAO,EAAG,KAAK,EAAE,WAAW,EAAU,EAAE,EAAE,gBAAgB,EAAE;IACpE,EAAE,IAAI,EAAE,OAAO,EAAG,KAAK,EAAE,YAAY,EAAS,EAAE,EAAE,iBAAiB,EAAE,EAAe,0BAA0B;IAC9G,EAAE,IAAI,EAAE,OAAO,EAAG,KAAK,EAAE,aAAa,EAAQ,EAAE,EAAE,oBAAoB,EAAE;IACxE,EAAE,IAAI,EAAE,MAAM,EAAI,KAAK,EAAE,UAAU,EAAW,EAAE,EAAE,eAAe,EAAE,EAAiB,gBAAgB;IACpG,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,iBAAiB,EAAI,EAAE,EAAE,iCAAiC,EAAE;IACrF,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,gBAAgB,EAAK,EAAE,EAAE,uBAAuB,EAAE;IAC3E,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAQ,EAAE,EAAE,kBAAkB,EAAE;IACtE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,EAAE,0BAA0B,EAAE;CAC/E,CAAC;AAEF,2EAA2E;AAC3E,SAAS,eAAe,CAAC,OAAe;IACtC,OAAO,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC7E,CAAC;AAED;;sBAEsB;AACtB,SAAgB,oBAAoB,CAAC,OAAe;IAClD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC;YAC/B,IAAI,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QAC9D,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;4DAG4D;AAC5D,SAAgB,qBAAqB,CACnC,QAAgB,EAAE,SAAkC;IAEpD,IAAI,QAAQ,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,OAAO,GAAG,OAAO,SAAS,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;2DAE2D;AAC3D,SAAgB,wBAAwB,CACtC,OAA0B,EAAE,KAA+B,EAAE,OAAe,EAAE,KAAoB;IAElG,MAAM,MAAM,GAAG,KAAK,IAAI,UAAU,CAAC;IACnC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,CACL,qBAAqB,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,QAAQ,MAAM,uBAAuB,IAAI,KAAK;UAC/F,6DAA6D,OAAO,CAAC,KAAK,IAAI;UAC9E,QAAQ,MAAM,sCAAsC,OAAO,EAAE,CAChE,CAAC;AACJ,CAAC;AAWD;;;yFAGyF;AAClF,KAAK,UAAU,qBAAqB,CAAC,IAA2B;IACrE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,IAAA,qCAAmB,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACrE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACrC,OAAO,IAAA,kCAAgB,EAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAClF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;wDAGwD;AACjD,KAAK,UAAU,iBAAiB,CACrC,OAA0B,EAAE,IAA2B;IAEvD,MAAM,KAAK,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,wBAAwB,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC"}

package/dist/commands/friction-reminder.d.ts

@@ -13,46 +13,26 @@
  *  network, no clock — the hook does ALL I/O. Keeping detect/tier a pure function is what
  *  makes the detect→silent transition (the auto-stop) unit-testable (the regression-lock). */
 import { Tier, ReminderModule } from './reminder-types';
-/** The firing-tier ladder (docs/reminder-interrupt.md §Firing tiers). `silent`
- *  is the off rung; the other three escalate wording intensity with the cost of
- *  inaction: ambient = soft pointer, nudge = imperative + reason, nag = LOUD
- *  forced-decision. */
 export type FrictionTier = Tier;
-/** Ambient (calm-state) cadence: one soft pointer every N turns. The low-rate
- *  trickle for a capability with no live bad-state to gate on. */
-export declare const AMBIENT_EVERY_N = 5;
-/** Decide the friction reminder's firing tier from the live state bag — PURE so
- *  the ladder is unit-testable (the regression-lock rung). DYNAMIC: urgency tracks
- *  the live stress level (docs/stress-trigger.md), not a hand-set knob.
- *
- *    stress HIGH (2)     → nag    — LOUD forced-decision; fires while the live bad
- *                                   state holds and goes silent the instant it flips.
- *    stress ELEVATED (1) → nudge  — imperative + reason, while elevated.
- *    stress CALM (0)     → ambient every Nth turn (turnCount % AMBIENT_EVERY_N),
- *                                   else silent.
- *
- *  Defensive: non-finite inputs collapse to 0 (calm / turn 0 → silent), so a
- *  missing or corrupt state bag can never escalate — fail-quiet by construction. */
-export declare function frictionReminderTier(turnCount: number, stress: number): FrictionTier;
-/** SessionStart announce — the mechanic-launch schema, loaded ONCE. The heavy
- *  half of the pair: it (1) TEACHES the method the per-turn reminder triggers, so
- *  the reminder stays a thin pointer, and (2) PRIMES adherence — the agent acts on
- *  a reminder for a capability it was *taught*, not a cold mid-session imperative
- *  (the no-orphan invariant, docs/reminder-interrupt.md). Written for an AGENT under
- *  token pressure per the doc's authoring rules: action-first, reason+method
- *  bundled, directive-framed, token-minimal. ~150 tokens; amortized over the
- *  session. */
-export declare function buildMechanicAnnounce(): string;
-/** Per-turn reminder line for a given tier — the thin pointer back at the announce
- *  schema; null on `silent`. Wording intensity scales with the tier (the doc):
- *  ambient = soft pointer, nudge = imperative + reason, nag = LOUD forced-decision.
- *  Every non-silent line is action-first, bundles reason+method, and ends on a
- *  forced binary (act → spawn / clear → continue) so it CONVERTS instead of becoming
- *  wallpaper (the fix-`16a29a8b` banner-blindness failure mode). Grounded to the
- *  live signal where there is one (nudge/nag name the stress). The act-now directive
- *  envelope (authoring rule #4) is applied by the hook, not here — this module owns
- *  the wording, the caller owns the framing. */
+/** The friction reminder fires ONLY on DETECTED STRESS (docs/stress-trigger.md) —
+ *  no turn-cadence ambient nagging (that was the wallpaper removed 2026-06-22).
+ *  `computeStress` (the validated AUC-0.835 composite: repetition · retry ·
+ *  seq-trigram · errors · churn) emits the level; this maps it to a tier:
+ *    HIGH (2)     → nag   (LOUD)
+ *    ELEVATED (1) → nudge (the detector fires pre-error at this band)
+ *    CALM (0)     → silent — the reminder NEVER fires at rest.
+ *  Defensive: a non-finite stress collapses to calm (fail-quiet). */
+export declare function frictionReminderTier(stress: number): FrictionTier;
+/** The per-turn reminder line — fires only on detected stress, points back at the
+ *  primer's repair vehicles, ends on a forced binary so it converts. null = calm. */
 export declare function buildFrictionReminder(tier: FrictionTier): string | null;
+/** SessionStart primer — the active-Mechanic schema, loaded ONCE. Full doctrine
+ *  inline (a PRIMER, not a pointer): it teaches WHEN friction is a fix-now signal,
+ *  the two repair vehicles (reflex vs workshop, by friction tier), and the modes.
+ *  Depends on the chip concept being loaded first (chip-spawn-pointer) — it names
+ *  chip vehicles. Written for an agent under token pressure: action-first,
+ *  reason+method bundled, no per-turn nag to lean on. */
+export declare function buildMechanicAnnounce(): string;
 /** Persisted fire-counter (docs/reminder-interrupt.md §Measurement). The
  *  DENOMINATOR of the adherence ratio: how many friction reminders were shown, by
  *  tier. The numerator (reflex chips actually spawned after a reminder) is the next
@@ -83,10 +63,8 @@ export declare function tallyFrictionFire(prior: FrictionStats | null, tier: Fri
  *  path calls this when it sees a chip preloaded from the reflex-chip template land
  *  after a reminder. Never decrements; idempotency is the caller's concern. */
 export declare function tallyReflexSpawn(prior: FrictionStats | null): FrictionStats;
-/** The active Mechanic, recast onto the detector model (docs/reminder-interrupt.md
- *  §Registry spec). `detect` is stress-gated — the friction signal IS the live
- *  deficiency; `announce` teaches the reflex-chip schema once; `reminder` is the thin
- *  per-turn line. Wired through the container (reminder-registry.ts). Unlike the
- *  watcher-arm reference module (binary, auto-silences when armed), this one is
- *  GRADED — silent at calm, escalating with the live stress level. */
+/** The active Mechanic — a PRIMER-ONLY module (docs/load-system.md): one strong
+ *  SessionStart announce, no per-turn reminder (the friction nag was removed
+ *  2026-06-22 as wallpaper). `dependsOn` the chip-spawn pointer so the chip concept
+ *  it references is already loaded — the boot sequence places it AFTER chips. */
 export declare const mechanicFrictionModule: ReminderModule;

package/dist/commands/friction-reminder.js

@@ -14,82 +14,64 @@
  *  network, no clock — the hook does ALL I/O. Keeping detect/tier a pure function is what
  *  makes the detect→silent transition (the auto-stop) unit-testable (the regression-lock). */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mechanicFrictionModule = exports.AMBIENT_EVERY_N = void 0;
+exports.mechanicFrictionModule = void 0;
 exports.frictionReminderTier = frictionReminderTier;
-exports.buildMechanicAnnounce = buildMechanicAnnounce;
 exports.buildFrictionReminder = buildFrictionReminder;
+exports.buildMechanicAnnounce = buildMechanicAnnounce;
 exports.tallyFrictionFire = tallyFrictionFire;
 exports.tallyReflexSpawn = tallyReflexSpawn;
 const state_trigger_1 = require("./state-trigger");
-/** Ambient (calm-state) cadence: one soft pointer every N turns. The low-rate
- *  trickle for a capability with no live bad-state to gate on. */
-exports.AMBIENT_EVERY_N = 5;
-/** Decide the friction reminder's firing tier from the live state bag — PURE so
- *  the ladder is unit-testable (the regression-lock rung). DYNAMIC: urgency tracks
- *  the live stress level (docs/stress-trigger.md), not a hand-set knob.
- *
- *    stress HIGH (2)     → nag    — LOUD forced-decision; fires while the live bad
- *                                   state holds and goes silent the instant it flips.
- *    stress ELEVATED (1) → nudge  — imperative + reason, while elevated.
- *    stress CALM (0)     → ambient every Nth turn (turnCount % AMBIENT_EVERY_N),
- *                                   else silent.
- *
- *  Defensive: non-finite inputs collapse to 0 (calm / turn 0 → silent), so a
- *  missing or corrupt state bag can never escalate — fail-quiet by construction. */
-function frictionReminderTier(turnCount, stress) {
+/** The friction reminder fires ONLY on DETECTED STRESS (docs/stress-trigger.md) —
+ *  no turn-cadence ambient nagging (that was the wallpaper removed 2026-06-22).
+ *  `computeStress` (the validated AUC-0.835 composite: repetition · retry ·
+ *  seq-trigram · errors · churn) emits the level; this maps it to a tier:
+ *    HIGH (2)     → nag   (LOUD)
+ *    ELEVATED (1) → nudge (the detector fires pre-error at this band)
+ *    CALM (0)     → silent — the reminder NEVER fires at rest.
+ *  Defensive: a non-finite stress collapses to calm (fail-quiet). */
+function frictionReminderTier(stress) {
     const s = Number.isFinite(stress) ? stress : 0;
-    const t = Number.isFinite(turnCount) ? turnCount : 0;
     if (s >= state_trigger_1.STRESS_HIGH)
         return 'nag';
     if (s >= state_trigger_1.STRESS_ELEVATED)
         return 'nudge';
-    if (t >= 1 && t % exports.AMBIENT_EVERY_N === 0)
-        return 'ambient';
     return 'silent';
 }
-// ---------- Authored text (announce + per-turn reminder) ---------------------
-/** The HOW string — the method every tier points at. Kept in one place so the
- *  announce and the per-turn line can never drift on the spawn mechanic. */
-const SPAWN_METHOD = 'spawn a fire-and-forget reflex chip (spawn_task → packages/cli/skill/templates/reflex-chip.md)';
-/** SessionStart announce — the mechanic-launch schema, loaded ONCE. The heavy
- *  half of the pair: it (1) TEACHES the method the per-turn reminder triggers, so
- *  the reminder stays a thin pointer, and (2) PRIMES adherence — the agent acts on
- *  a reminder for a capability it was *taught*, not a cold mid-session imperative
- *  (the no-orphan invariant, docs/reminder-interrupt.md). Written for an AGENT under
- *  token pressure per the doc's authoring rules: action-first, reason+method
- *  bundled, directive-framed, token-minimal. ~150 tokens; amortized over the
- *  session. */
-function buildMechanicAnnounce() {
-    return [
-        '[Active Mechanic — keep the harness healthy IN-SESSION. Friction is a signal to fix now, not to defer.]',
-        'WHEN you hit friction this session — repeated yourself, fought a tool, got corrected ≥2× on the same thing, or rediscovered something already known — fix the PATTERN now; do not push through.',
-        `HOW: ${SPAWN_METHOD}. The chip is preloaded with the mechanic tools + live \`greprag mechanic status\`, so it orients instantly, lands a Tier-0 born-shadow repair, and ends — no gate to wait at.`,
-        'MODES: fix (land the repair) · log (`greprag fix log "<obs>"` when it is a mechanism for /mechanic later) · ask-human (the operator must decide).',
-        'WHY now: immediate-fix beats the backlog — the moment that produced the friction still holds the context the fix needs; deferred, that context is gone.',
-        'A per-turn reminder fires LOUD when live friction is detected — act on it, or say "clear" and continue.',
-    ].join('\n');
-}
-/** Per-turn reminder line for a given tier — the thin pointer back at the announce
- *  schema; null on `silent`. Wording intensity scales with the tier (the doc):
- *  ambient = soft pointer, nudge = imperative + reason, nag = LOUD forced-decision.
- *  Every non-silent line is action-first, bundles reason+method, and ends on a
- *  forced binary (act → spawn / clear → continue) so it CONVERTS instead of becoming
- *  wallpaper (the fix-`16a29a8b` banner-blindness failure mode). Grounded to the
- *  live signal where there is one (nudge/nag name the stress). The act-now directive
- *  envelope (authoring rule #4) is applied by the hook, not here — this module owns
- *  the wording, the caller owns the framing. */
+/** The per-turn reminder line — fires only on detected stress, points back at the
+ *  primer's repair vehicles, ends on a forced binary so it converts. null = calm. */
 function buildFrictionReminder(tier) {
     switch (tier) {
         case 'nag':
-            return `⚠ FRICTION HIGH (live signal: repetition / errors / churn) — STOP pushing through; fix the PATTERN now → ${SPAWN_METHOD}. No friction? say "clear" + continue.`;
+            return '⚠ FRICTION HIGH (live signal: repetition / errors / churn) — STOP pushing through; fix the PATTERN now → `greprag load reflex-chip` (sentence-tier) or `greprag load workshop-chip` (machinery), then spawn_task. No friction? say "clear" + continue.';
         case 'nudge':
-            return `⚠ Friction rising — if you have repeated yourself or fought a tool, fix it now → ${SPAWN_METHOD}. Otherwise say "clear" + continue.`;
-        case 'ambient':
-            return `💡 Hit friction since the last check (repeated yourself, fought a tool, corrected ≥2×)? → ${SPAWN_METHOD}. If not, say "clear" + continue.`;
+            return '⚠ Friction detected (live signal) — if you have repeated yourself, fought a tool, or hit a wall, fix the PATTERN now → `greprag load reflex-chip` (sentence-tier) or `greprag load workshop-chip` (machinery), then spawn_task. Otherwise say "clear" + continue.';
         default:
             return null;
     }
 }
+// ---------- The Mechanic primer (announce-only) ------------------------------
+/** The method the primer points at. `greprag load reflex-chip` carries the full
+ *  in-the-moment repair-chip schema; `greprag load workshop-chip` the heavier
+ *  mechanism-tier one. Kept in one place so the two branches never drift. */
+const REFLEX_METHOD = 'spawn a fire-and-forget reflex chip — `greprag load reflex-chip` for the method, then `spawn_task`';
+const WORKSHOP_METHOD = 'spawn a workshop chip — `greprag load workshop-chip` (investigates + drafts the repair, parks at your merge gate)';
+/** SessionStart primer — the active-Mechanic schema, loaded ONCE. Full doctrine
+ *  inline (a PRIMER, not a pointer): it teaches WHEN friction is a fix-now signal,
+ *  the two repair vehicles (reflex vs workshop, by friction tier), and the modes.
+ *  Depends on the chip concept being loaded first (chip-spawn-pointer) — it names
+ *  chip vehicles. Written for an agent under token pressure: action-first,
+ *  reason+method bundled, no per-turn nag to lean on. */
+function buildMechanicAnnounce() {
+    return [
+        '[Active Mechanic — keep the harness healthy IN-SESSION. Friction is a signal to fix NOW, not to defer; the moment that produced it still holds the context the fix needs.]',
+        'WHEN you hit friction this session — repeated yourself, fought a tool, got corrected ≥2× on the same thing, or rediscovered something already known — fix the PATTERN now; do not push through.',
+        `SENTENCE-TIER friction (the fix is words in a file you own — a skill / doc / CLAUDE.md): ${REFLEX_METHOD}. The chip is preloaded with the mechanic tools + live \`greprag mechanic status\`, lands a Tier-0 born-shadow repair, and ends — no gate to wait at.`,
+        `MECHANISM-TIER friction (the fix is machinery — a hook / gate / trigger / code, anything you can't fix in words): ${WORKSHOP_METHOD}.`,
+        'MODES (when unsure which, or when it is not a chip): fix (land the repair inline) · log (`greprag fix log "<obs>"` to queue it for /mechanic) · ask-human (the operator must decide).',
+        'Every repair is ROOT-CAUSE — fix the pattern that makes the friction class possible, never a guard on today\'s trigger.',
+        'A per-turn reminder fires ONLY when live friction is DETECTED (the stress signal — repetition / errors / churn), never on a timer — act on it, or say "clear" and continue.',
+    ].join('\n');
+}
 /** Normalize any prior-stats blob (possibly missing/partial/corrupt) into a fully
  *  populated FrictionStats. Pure, total. */
 function normalizeStats(prior) {
@@ -132,15 +114,15 @@ function tallyReflexSpawn(prior) {
     return s;
 }
 // ---------- Registry module --------------------------------------------------
-/** The active Mechanic, recast onto the detector model (docs/reminder-interrupt.md
- *  §Registry spec). `detect` is stress-gated — the friction signal IS the live
- *  deficiency; `announce` teaches the reflex-chip schema once; `reminder` is the thin
- *  per-turn line. Wired through the container (reminder-registry.ts). Unlike the
- *  watcher-arm reference module (binary, auto-silences when armed), this one is
- *  GRADED — silent at calm, escalating with the live stress level. */
+/** The active Mechanic — a PRIMER-ONLY module (docs/load-system.md): one strong
+ *  SessionStart announce, no per-turn reminder (the friction nag was removed
+ *  2026-06-22 as wallpaper). `dependsOn` the chip-spawn pointer so the chip concept
+ *  it references is already loaded — the boot sequence places it AFTER chips. */
 exports.mechanicFrictionModule = {
     id: 'mechanic-friction',
-    detect: (env) => ({ tier: frictionReminderTier(env.turnCount, env.stress) }),
+    dependsOn: ['chip-spawn-pointer'],
+    // Fires ONLY on detected stress (elevated/high) — no turn-cadence nag.
+    detect: (env) => ({ tier: frictionReminderTier(env.stress) }),
     announce: () => buildMechanicAnnounce(),
     reminder: (d) => buildFrictionReminder(d.tier),
 };

package/dist/commands/friction-reminder.js.map

@@ -1 +1 @@
-{"version":3,"file":"friction-reminder.js","sourceRoot":"","sources":["../../src/commands/friction-reminder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"friction-reminder.js","sourceRoot":"","sources":["../../src/commands/friction-reminder.ts"],"names":[],"mappings":"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"}

package/dist/commands/init.js

@@ -300,20 +300,13 @@ async function runInit(opts) {
                 optionalSkills.push(entry.name);
         }
     }
-    // Step 6b: Install the chip-spawn doc to ~/.claude/docs/chip-spawn.md. The
-    // global CLAUDE.md (Step 3b of the skill) carries only a single loud pointer
-    // to this file; the actual chip-spawn protocol lives here, read on demand
-    // by the agent when about to call spawn_task. Keeping the protocol out of
-    // CLAUDE.md saves tokens on every session that doesn't spawn a chip.
-    const docsDir = path.join(os.homedir(), '.claude', 'docs');
-    const chipSpawnSrc = path.join(__dirname, '../../skill/templates/chip-spawn.md');
-    if (fs.existsSync(chipSpawnSrc)) {
-        if (!fs.existsSync(docsDir))
-            fs.mkdirSync(docsDir, { recursive: true });
-        const chipSpawnDest = path.join(docsDir, 'chip-spawn.md');
-        fs.copyFileSync(chipSpawnSrc, chipSpawnDest);
-        changes.push(`Installed chip-spawn doc → ${chipSpawnDest}`);
-    }
+    // Step 6b RETIRED 2026-06-22 (docs/load-system.md): the chip-spawn protocol is
+    // no longer copied to ~/.claude/docs/chip-spawn.md. greprag function never
+    // depends on a `.md` file on disk — the doctrine ships in the binary and is
+    // loaded on demand via `greprag load chip-spawn` (the Interrupt System's
+    // chip-spawn POINTER announce names the trigger + the command). One less
+    // install-time file write, and it works in every project, not just where the
+    // file happened to be installed.
     // Step 7: Patch ~/.claude/CLAUDE.md greprag CLI section (migrates legacy ## Inbox).
     const claudeMdPatched = patchGlobalClaudeMd();
     changes.push(claudeMdPatched ? 'Patched ~/.claude/CLAUDE.md greprag CLI section' : '~/.claude/CLAUDE.md greprag CLI section already up to date');