greprag 5.59.4 → 5.60.1

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

@@ -19,6 +19,11 @@ export declare function armDetect(env: ReminderEnv): Detection;
  *  + the forced-decision are the reminder-interrupt doctrine's two missing rules
  *  (docs/reminder-interrupt.md: reason · live-grounding · forced-decision · loud). */
 export declare function buildArmReminder(d: Detection, env?: ReminderEnv): string | null;
+/** Compatibility formatter for integrations that still request the original
+ *  SessionStart announce. The live registry now uses buildInboxPrimer, but
+ *  retaining this pure export keeps older hook callers from crashing while
+ *  preserving the same copyable Monitor command. */
+export declare function buildArmAnnounce(short: string, ownerPid?: number | null, alias?: string | null): string;
 /** The reference module — now REMINDER-ONLY. No SessionStart announce: arming is taught
  *  once by the inbox-primer (the single announce line). This stays the per-turn poke that
  *  fires while unarmed and auto-silences when armed. Wired into reminder-registry.ts. */

package/dist/commands/arm-reminder.js

@@ -9,6 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.watcherArmModule = void 0;
 exports.armDetect = armDetect;
 exports.buildArmReminder = buildArmReminder;
+exports.buildArmAnnounce = buildArmAnnounce;
 const session_id_1 = require("../session-id");
 // SessionStart arming guidance lives in the inbox-primer now (the ONE announce line,
 // carrying the Monitor how-to). This module is REMINDER-ONLY — the per-turn poke when
@@ -47,6 +48,16 @@ function buildArmReminder(d, env) {
     }
     return `⚠ UNARMED — ${grounded}. You're invisible; messages pile up silently. Re-arm now, or state why you're choosing to stay dark: ${arm}.`;
 }
+/** Compatibility formatter for integrations that still request the original
+ *  SessionStart announce. The live registry now uses buildInboxPrimer, but
+ *  retaining this pure export keeps older hook callers from crashing while
+ *  preserving the same copyable Monitor command. */
+function buildArmAnnounce(short, ownerPid, alias) {
+    const command = (0, session_id_1.armMonitorCommand)(short, ownerPid);
+    return `ARM YOUR INBOX WATCHER NOW — peers are reaching this session. DROP ANYTIME means you MUST re-arm. `
+        + `ToolSearch query "select:Monitor"; call Monitor with persistent:true, timeout_ms:3600000, description:"greprag inbox ${short}", command: \`${command}\`. `
+        + `Reply address: ${(alias || '<handle>')}@greprag.com/${short}.`;
+}
 /** The reference module — now REMINDER-ONLY. No SessionStart announce: arming is taught
  *  once by the inbox-primer (the single announce line). This stays the per-turn poke that
  *  fires while unarmed and auto-silences when armed. Wired into reminder-registry.ts. */

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

@@ -1 +1 @@
-{"version":3,"file":"arm-reminder.js","sourceRoot":"","sources":["../../src/commands/arm-reminder.ts"],"names":[],"mappings":";AAAA;;;;;uCAKuC;;;AAavC,8BAMC;AAWD,4CAWC;AAtCD,8CAAkD;AAElD,qFAAqF;AACrF,sFAAsF;AACtF,oFAAoF;AACpF,uFAAuF;AAEvF;;iFAEiF;AACjF,SAAgB,SAAS,CAAC,GAAgB;IACxC,IAAI,GAAG,CAAC,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO,MAAM,GAAG,CAAC;QACf,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE;QACrC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;;;sFAQsF;AACtF,SAAgB,gBAAgB,CAAC,CAAY,EAAE,GAAiB;IAC9D,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,IAAK,CAAC,CAAC,MAA8B,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACnF,MAAM,GAAG,GAAG,GAAG;QACb,CAAC,CAAC,kFAAkF,IAAA,8BAAiB,EAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI;QAC/J,CAAC,CAAC,gCAAgC,CAAC;IACrC,MAAM,QAAQ,GAAG,8IAA8I,CAAC;IAChK,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,OAAO,0BAA0B,MAAM,eAAe,QAAQ,mEAAmE,GAAG,2BAA2B,CAAC;IAClK,CAAC;IACD,OAAO,eAAe,QAAQ,yGAAyG,GAAG,GAAG,CAAC;AAChJ,CAAC;AAED;;yFAEyF;AAC5E,QAAA,gBAAgB,GAAmB;IAC9C,EAAE,EAAE,aAAa;IACjB,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI;IACpB,QAAQ,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,GAAG,CAAC;CAC/C,CAAC"}
+{"version":3,"file":"arm-reminder.js","sourceRoot":"","sources":["../../src/commands/arm-reminder.ts"],"names":[],"mappings":";AAAA;;;;;uCAKuC;;;AAavC,8BAMC;AAWD,4CAWC;AAMD,4CAKC;AAjDD,8CAAkD;AAElD,qFAAqF;AACrF,sFAAsF;AACtF,oFAAoF;AACpF,uFAAuF;AAEvF;;iFAEiF;AACjF,SAAgB,SAAS,CAAC,GAAgB;IACxC,IAAI,GAAG,CAAC,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO,MAAM,GAAG,CAAC;QACf,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE;QACrC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;;;sFAQsF;AACtF,SAAgB,gBAAgB,CAAC,CAAY,EAAE,GAAiB;IAC9D,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,IAAK,CAAC,CAAC,MAA8B,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACnF,MAAM,GAAG,GAAG,GAAG;QACb,CAAC,CAAC,kFAAkF,IAAA,8BAAiB,EAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI;QAC/J,CAAC,CAAC,gCAAgC,CAAC;IACrC,MAAM,QAAQ,GAAG,8IAA8I,CAAC;IAChK,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,OAAO,0BAA0B,MAAM,eAAe,QAAQ,mEAAmE,GAAG,2BAA2B,CAAC;IAClK,CAAC;IACD,OAAO,eAAe,QAAQ,yGAAyG,GAAG,GAAG,CAAC;AAChJ,CAAC;AAED;;;oDAGoD;AACpD,SAAgB,gBAAgB,CAAC,KAAa,EAAE,QAAwB,EAAE,KAAqB;IAC7F,MAAM,OAAO,GAAG,IAAA,8BAAiB,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACnD,OAAO,oGAAoG;UACvG,wHAAwH,KAAK,iBAAiB,OAAO,MAAM;UAC3J,kBAAkB,CAAC,KAAK,IAAI,UAAU,CAAC,gBAAgB,KAAK,GAAG,CAAC;AACtE,CAAC;AAED;;yFAEyF;AAC5E,QAAA,gBAAgB,GAAmB;IAC9C,EAAE,EAAE,aAAa;IACjB,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI;IACpB,QAAQ,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,GAAG,CAAC;CAC/C,CAAC"}

package/dist/commands/codex-chip/breakthrough-ack-command.d.ts

@@ -0,0 +1 @@
+export declare function runBreakthroughAckCommand(args: string[]): Promise<void>;

package/dist/commands/codex-chip/breakthrough-ack-command.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runBreakthroughAckCommand = runBreakthroughAckCommand;
+const breakthrough_1 = require("./breakthrough");
+const inbox_1 = require("./inbox");
+function flag(args, name) {
+    const index = args.indexOf(name);
+    return index >= 0 ? args[index + 1] : undefined;
+}
+async function runBreakthroughAckCommand(args) {
+    const id = args[0];
+    const nonce = flag(args, '--nonce');
+    const action = flag(args, '--action');
+    const actor = flag(args, '--actor-session') || process.env.CODEX_THREAD_ID;
+    if (!id || !nonce || !action || !actor)
+        throw new Error('breakthrough-ack requires <chip-id> --nonce <nonce> --action "<action>" and a target session.');
+    let manifest = (0, breakthrough_1.readBreakthroughChip)(id);
+    manifest = (0, breakthrough_1.acknowledgeBreakthrough)(manifest, nonce, actor, action);
+    manifest = (0, breakthrough_1.actBreakthrough)(manifest, nonce);
+    await (0, inbox_1.sendChipEvent)(manifest, manifest.codex.threadId, {
+        kind: 'breakthrough-ack', summary: `BREAKTHROUGH_ACK:${nonce} action=${action.trim()}`,
+    }, actor);
+    console.log(`BREAKTHROUGH_ACK:${nonce} acted for chip ${id.slice(0, 8)}.`);
+}
+//# sourceMappingURL=breakthrough-ack-command.js.map

package/dist/commands/codex-chip/breakthrough-ack-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breakthrough-ack-command.js","sourceRoot":"","sources":["../../../src/commands/codex-chip/breakthrough-ack-command.ts"],"names":[],"mappings":";;AAOA,8DAWC;AAlBD,iDAAgG;AAChG,mCAAwC;AAExC,SAAS,IAAI,CAAC,IAAc,EAAE,IAAY;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACpF,CAAC;AAEM,KAAK,UAAU,yBAAyB,CAAC,IAAc;IAC5D,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAAC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAAC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/F,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC3E,IAAI,CAAC,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,+FAA+F,CAAC,CAAC;IACzJ,IAAI,QAAQ,GAAG,IAAA,mCAAoB,EAAC,EAAE,CAAC,CAAC;IACxC,QAAQ,GAAG,IAAA,sCAAuB,EAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACnE,QAAQ,GAAG,IAAA,8BAAe,EAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC5C,MAAM,IAAA,qBAAa,EAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE;QACrD,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,oBAAoB,KAAK,WAAW,MAAM,CAAC,IAAI,EAAE,EAAE;KACvF,EAAE,KAAK,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,mBAAmB,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;AAC7E,CAAC"}

package/dist/commands/codex-chip/breakthrough-command.d.ts

@@ -0,0 +1,5 @@
+import { findManifest } from './store';
+export declare function runBreakthroughCommand(args: string[]): Promise<void>;
+export declare function routeBreakthrough(manifest: NonNullable<ReturnType<typeof findManifest>>, reason: string, targetSession?: string): Promise<{
+    nonce: string;
+}>;

package/dist/commands/codex-chip/breakthrough-command.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runBreakthroughCommand = runBreakthroughCommand;
+exports.routeBreakthrough = routeBreakthrough;
+const inbox_1 = require("./inbox");
+const git_1 = require("./git");
+const store_1 = require("./store");
+const breakthrough_1 = require("./breakthrough");
+const mechanic_lifecycle_1 = require("./mechanic-lifecycle");
+const store_2 = require("./store");
+function flag(args, name) {
+    const index = args.indexOf(name);
+    return index >= 0 ? args[index + 1] : undefined;
+}
+async function runBreakthroughCommand(args) {
+    const id = args[0];
+    const reason = flag(args, '--reason') || args[1];
+    if (!id)
+        throw new Error('Chip id is required.');
+    if (!reason || reason.trim().length < 12) {
+        throw new Error('--reason must document the boundary or blocker (at least 12 characters).');
+    }
+    const marker = (0, git_1.readChipMarker)(process.cwd());
+    if (!marker || marker.id !== id)
+        throw new Error('Breakthrough must run from the matching managed chip checkout.');
+    const found = (0, store_1.findManifest)(id);
+    if (!found)
+        throw new Error(`Unknown chip: ${id}`);
+    const routed = await routeBreakthrough(found, reason.trim(), found.parent.sessionId);
+    console.log(`BREAKTHROUGH:${routed.nonce}`);
+    console.log(`Breakthrough routed for chip ${id.slice(0, 8)}.`);
+}
+async function routeBreakthrough(manifest, reason, targetSession) {
+    if (manifest.codex.role === 'mechanic' && manifest.codex.mechanic?.state === 'dormant') {
+        manifest = (0, store_2.updateManifest)(manifest.id, { codex: {
+                ...manifest.codex, mechanic: (0, mechanic_lifecycle_1.reopenMechanicIncident)(manifest.codex.mechanic),
+            } });
+    }
+    const queued = (0, breakthrough_1.queueBreakthrough)(manifest, reason, targetSession);
+    await (0, inbox_1.sendChipEvent)(queued.manifest, queued.delivery.targetSession, {
+        kind: 'breakthrough', summary: `BREAKTHROUGH:${queued.delivery.nonce} ${reason}`,
+    }, queued.manifest.codex.threadId || queued.manifest.parent.sessionId);
+    (0, breakthrough_1.markBreakthroughInjected)(queued.manifest, queued.delivery.nonce, 'live');
+    return { nonce: queued.delivery.nonce };
+}
+//# sourceMappingURL=breakthrough-command.js.map

package/dist/commands/codex-chip/breakthrough-command.js.map

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

package/dist/commands/codex-chip/breakthrough.d.ts

@@ -0,0 +1,15 @@
+import { BreakthroughDelivery, BreakthroughState, ChipManifest } from './model';
+export declare const BREAKTHROUGH_TERMINAL_STATES: Set<BreakthroughState>;
+export declare function queueBreakthrough(manifest: ChipManifest, summary: string, targetSession?: string | undefined, nonce?: string): {
+    manifest: ChipManifest;
+    delivery: BreakthroughDelivery;
+};
+export declare function markBreakthroughInjected(manifest: ChipManifest, nonce: string, transport?: 'live' | 'native-fallback'): ChipManifest;
+export declare function markBreakthroughDegraded(manifest: ChipManifest, nonce: string, error: string): ChipManifest;
+export declare function acknowledgeBreakthrough(manifest: ChipManifest, nonce: string, actorSession: string, action: string): ChipManifest;
+export declare function actBreakthrough(manifest: ChipManifest, nonce: string): ChipManifest;
+export declare function markBreakthroughTerminal(manifest: ChipManifest, nonce: string): ChipManifest;
+export declare function pendingBreakthroughs(manifest: ChipManifest): BreakthroughDelivery[];
+export declare function assertNoPendingBreakthroughs(manifest: ChipManifest): void;
+export declare function breakthroughState(manifest: ChipManifest, nonce: string): BreakthroughDelivery;
+export declare function readBreakthroughChip(id: string): ChipManifest;

package/dist/commands/codex-chip/breakthrough.js

@@ -0,0 +1,147 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BREAKTHROUGH_TERMINAL_STATES = void 0;
+exports.queueBreakthrough = queueBreakthrough;
+exports.markBreakthroughInjected = markBreakthroughInjected;
+exports.markBreakthroughDegraded = markBreakthroughDegraded;
+exports.acknowledgeBreakthrough = acknowledgeBreakthrough;
+exports.actBreakthrough = actBreakthrough;
+exports.markBreakthroughTerminal = markBreakthroughTerminal;
+exports.pendingBreakthroughs = pendingBreakthroughs;
+exports.assertNoPendingBreakthroughs = assertNoPendingBreakthroughs;
+exports.breakthroughState = breakthroughState;
+exports.readBreakthroughChip = readBreakthroughChip;
+const crypto = __importStar(require("crypto"));
+const store_1 = require("./store");
+exports.BREAKTHROUGH_TERMINAL_STATES = new Set(['acted', 'terminal']);
+function now() { return new Date().toISOString(); }
+function sameSession(left, right) {
+    return Boolean(left && right && left.slice(0, 8).toLowerCase() === right.slice(0, 8).toLowerCase());
+}
+function withBreakthrough(manifest, nonce, mutate) {
+    // A send/ACK event may update the manifest between queueing and the state
+    // transition. Always merge against the latest durable record so transport
+    // receipts and prior attempts cannot be clobbered by a stale caller copy.
+    const authoritative = (0, store_1.readManifest)(manifest.id) || manifest;
+    const current = authoritative.codex.breakthroughs?.[nonce];
+    if (!current)
+        throw new Error(`Unknown breakthrough nonce ${nonce}.`);
+    return (0, store_1.updateManifest)(authoritative.id, { codex: {
+            ...authoritative.codex,
+            breakthroughs: { ...(authoritative.codex.breakthroughs || {}), [nonce]: mutate(current) },
+        } });
+}
+function queueBreakthrough(manifest, summary, targetSession = manifest.parent.sessionId, nonce = crypto.randomBytes(16).toString('hex')) {
+    if (!targetSession)
+        throw new Error('Breakthrough has no target parent session.');
+    const delivery = {
+        nonce, summary: summary.trim(), targetSession, state: 'queued', required: true,
+        requestedAt: now(), attempts: 0,
+    };
+    const next = (0, store_1.updateManifest)(manifest.id, { codex: {
+            ...manifest.codex, breakthroughs: { ...(manifest.codex.breakthroughs || {}), [nonce]: delivery },
+        } });
+    return { manifest: next, delivery };
+}
+function markBreakthroughInjected(manifest, nonce, transport = 'live') {
+    return withBreakthrough(manifest, nonce, current => {
+        if (current.state !== 'queued' && current.state !== 'degraded') {
+            throw new Error(`Breakthrough ${nonce.slice(0, 8)} is ${current.state}; it is not injectable.`);
+        }
+        return { ...current, state: 'injected', injectedAt: now(), attempts: current.attempts + 1, lastTransport: transport, lastError: undefined };
+    });
+}
+function markBreakthroughDegraded(manifest, nonce, error) {
+    return withBreakthrough(manifest, nonce, current => {
+        if (exports.BREAKTHROUGH_TERMINAL_STATES.has(current.state)) {
+            throw new Error(`Breakthrough ${nonce.slice(0, 8)} is ${current.state}; terminal delivery cannot degrade.`);
+        }
+        return {
+            ...current, state: 'degraded', attempts: current.attempts + 1,
+            emptyTurnCount: /empty|unacknowledged/i.test(error) ? (current.emptyTurnCount || 0) + 1 : current.emptyTurnCount,
+            lastTransport: 'native-fallback', lastError: error,
+        };
+    });
+}
+function acknowledgeBreakthrough(manifest, nonce, actorSession, action) {
+    const current = manifest.codex.breakthroughs?.[nonce];
+    if (!current)
+        throw new Error(`Unknown breakthrough nonce ${nonce}.`);
+    if (!sameSession(current.targetSession, actorSession))
+        throw new Error('Breakthrough ACK must come from its recorded target session.');
+    if (!['injected', 'acknowledged', 'degraded'].includes(current.state)) {
+        throw new Error(`Breakthrough ${nonce.slice(0, 8)} is ${current.state}; ACK is no longer valid.`);
+    }
+    return withBreakthrough(manifest, nonce, item => ({
+        ...item, state: 'acknowledged', acknowledgedAt: item.acknowledgedAt || now(), action: action.trim(), lastError: undefined,
+    }));
+}
+function actBreakthrough(manifest, nonce) {
+    return withBreakthrough(manifest, nonce, current => {
+        if (current.state !== 'acknowledged')
+            throw new Error(`Breakthrough ${nonce.slice(0, 8)} requires an acknowledged action.`);
+        return { ...current, state: 'acted', actedAt: now() };
+    });
+}
+function markBreakthroughTerminal(manifest, nonce) {
+    return withBreakthrough(manifest, nonce, current => {
+        if (current.state !== 'acted')
+            throw new Error(`Breakthrough ${nonce.slice(0, 8)} requires ACK and action before terminal closeout.`);
+        return { ...current, state: 'terminal', terminalAt: now() };
+    });
+}
+function pendingBreakthroughs(manifest) {
+    return Object.values(manifest.codex.breakthroughs || {}).filter(item => item.required && !exports.BREAKTHROUGH_TERMINAL_STATES.has(item.state));
+}
+function assertNoPendingBreakthroughs(manifest) {
+    const pending = pendingBreakthroughs(manifest);
+    if (pending.length) {
+        throw new Error(`Required BREAKTHROUGH ACK/action remains pending: ${pending.map(item => item.nonce.slice(0, 8)).join(', ')}.`);
+    }
+}
+function breakthroughState(manifest, nonce) {
+    const delivery = manifest.codex.breakthroughs?.[nonce];
+    if (!delivery)
+        throw new Error(`Unknown breakthrough nonce ${nonce}.`);
+    return delivery;
+}
+function readBreakthroughChip(id) {
+    const manifest = (0, store_1.readManifest)(id);
+    if (!manifest)
+        throw new Error(`Unknown chip: ${id}`);
+    return manifest;
+}
+//# sourceMappingURL=breakthrough.js.map

package/dist/commands/codex-chip/breakthrough.js.map

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

package/dist/commands/codex-chip/cleanup-command.js

@@ -41,6 +41,7 @@ const model_1 = require("./model");
 const store_1 = require("./store");
 const lifecycle_1 = require("./lifecycle");
 const goals_1 = require("./goals");
+const mechanic_lifecycle_1 = require("./mechanic-lifecycle");
 function alive(pid) { try {
     process.kill(pid, 0);
     return true;
@@ -57,10 +58,15 @@ function runCleanupCommand(args) {
         throw new Error(`Unknown chip: ${ref}`);
     const force = args.includes('--force');
     (0, goals_1.assertGoalAcceptedForCleanup)(manifest);
+    if (manifest.codex.role === 'mechanic' && !args.includes('--mechanic-final')) {
+        throw new Error('MECHANIC remains OPEN+DORMANT after incident repair; only final LEAD mission teardown may pass --mechanic-final.');
+    }
     manifest = (0, lifecycle_1.prepareCleanup)(manifest, args.includes('--integrated'));
     if (manifest.codex.runtime === 'native' && manifest.codex.threadId && !args.includes('--native-archived')) {
         throw new Error(`Archive native Codex task ${manifest.codex.threadId} first, then rerun cleanup with --native-archived.`);
     }
+    const nativeArchiveAt = manifest.codex.runtime === 'native' && manifest.codex.threadId && args.includes('--native-archived')
+        ? new Date().toISOString() : undefined;
     if ((0, model_1.isActiveChip)(manifest))
         throw new Error(`Chip is ${manifest.state}; stop it before cleanup.`);
     if (!manifest.worker?.settledAt && manifest.worker?.pid && alive(manifest.worker.pid)) {
@@ -86,7 +92,11 @@ function runCleanupCommand(args) {
     }
     if (branchExists)
         (0, git_1.deleteBranch)(manifest.parent.root, manifest.worktree.branch);
-    manifest = (0, store_1.updateManifest)(manifest.id, { state: 'cleaned' });
+    manifest = (0, store_1.updateManifest)(manifest.id, nativeArchiveAt
+        ? { state: 'cleaned', codex: { ...manifest.codex, nativeArchivedAt: nativeArchiveAt,
+                mechanic: manifest.codex.role === 'mechanic' && manifest.codex.mechanic
+                    ? (0, mechanic_lifecycle_1.terminalMechanic)(manifest.codex.mechanic) : manifest.codex.mechanic } }
+        : { state: 'cleaned' });
     if (args.includes('--json'))
         return void console.log(JSON.stringify({
             protocol: 'greprag-codex-chip-closeout-v1', manifest,

package/dist/commands/codex-chip/cleanup-command.js.map

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

package/dist/commands/codex-chip/command.d.ts

@@ -1,3 +1,3 @@
-export { resolveChipModel } from './selection';
+export { resolveChipModel, resolveChipRole } from './selection';
 export declare function reconcile(): Promise<void>;
 export declare function runCodexChip(args: string[]): Promise<void>;

package/dist/commands/codex-chip/command.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveChipModel = void 0;
+exports.resolveChipRole = exports.resolveChipModel = void 0;
 exports.reconcile = reconcile;
 exports.runCodexChip = runCodexChip;
 const crypto = __importStar(require("crypto"));
@@ -55,23 +55,16 @@ const naming_1 = require("./naming");
 const goals_1 = require("./goals");
 const goal_command_1 = require("./goal-command");
 const cleanup_command_1 = require("./cleanup-command");
+const breakthrough_command_1 = require("./breakthrough-command");
+const breakthrough_command_2 = require("./breakthrough-command");
+const breakthrough_ack_command_1 = require("./breakthrough-ack-command");
+const breakthrough_1 = require("./breakthrough");
+const mechanic_lifecycle_1 = require("./mechanic-lifecycle");
 const resume_command_1 = require("./resume-command");
+const help_1 = require("./help");
 var selection_2 = require("./selection");
 Object.defineProperty(exports, "resolveChipModel", { enumerable: true, get: function () { return selection_2.resolveChipModel; } });
-const HELP = `greprag codex chip — collision-safe Codex task orchestration
-
-  spawn "<task>" --name <slug> [--title <purview>] [--multi-chip --label A] (--owns <glob> | --read-only)
-  greprag codex chip handoff <id|name> [--json]
-  greprag codex chip verify-title <id|name> <attestation flags from handoff>
-  greprag codex chip attach|status|stop|cleanup <id|name>
-  greprag codex chip steer <id|name> "<message>" | report <id|name> --summary "<result>"
-  greprag codex chip block <id|name> --reason "<blocker>" | list | reconcile
-  greprag codex chip resume <id|name> | resume-ack <id> --nonce <nonce>
-  greprag codex chip goal create|status|accept|exclude|cancel ...
-
-Spawn prepares a native Codex Desktop project/worktree handoff and reserves its
-starting branch. Write chips must declare non-overlapping ownership paths. Use
---runtime cli only for a model exposed by the installed PATH Codex app-server.`;
+Object.defineProperty(exports, "resolveChipRole", { enumerable: true, get: function () { return selection_2.resolveChipRole; } });
 function flag(args, name) {
     const index = args.indexOf(name);
     return index >= 0 ? args[index + 1] : undefined;
@@ -145,19 +138,23 @@ async function spawnChip(args) {
     if (!parentSession) {
         throw new Error('No parent Codex session detected. Run inside Codex or pass --parent-session <thread-id>.');
     }
-    const role = args.includes('--leader') ? 'leader' : 'worker';
+    const role = (0, selection_1.resolveChipRole)(args);
+    if (role === 'planner' && !args.includes('--read-only')) {
+        throw new Error('PLANNER tasks are control-plane/read-only; pass --read-only.');
+    }
+    if ((role === 'advisor' || role === 'mechanic') && !args.includes('--read-only')) {
+        throw new Error(`${role.toUpperCase()} tasks are read-only; pass --read-only.`);
+    }
     const naming = (0, naming_1.resolveChipNaming)(name, flag(args, '--title'), flag(args, '--label'), role, args.includes('--multi-chip'));
     const goalId = flag(args, '--goal-id');
     if (!goalId)
         throw new Error('Every new chip requires a parent-owned --goal-id. Create one with `greprag codex chip goal create`.');
     const covers = flags(args, '--covers');
-    (0, goals_1.requireGoalForSpawn)(goalId, anchor.projectId, parentSession, covers);
-    const selectionArgs = role === 'leader' && !args.includes('--complex') && !flag(args, '--profile') &&
-        !flag(args, '--model') && !flag(args, '--effort')
-        ? [...args, '--complex', '--model-reason', 'Multi-chip orchestration and integration',
-            '--complexity-signal', 'orchestration']
-        : args;
-    const selection = (0, selection_1.resolveChipSelection)(selectionArgs, parentSession);
+    (0, goals_1.requireGoalForSpawn)(goalId, anchor.projectId, parentSession, covers, role);
+    if (role === 'worker' || role === 'advisor' || role === 'mechanic') {
+        (0, goals_1.requireLeaderMissionGoalForDispatch)(goalId, anchor.projectId, parentSession);
+    }
+    const selection = (0, selection_1.resolveChipSelection)(args, parentSession, role, mode);
     const nativeModelVerified = args.includes('--native-model-verified');
     const timeoutMinutes = (0, selection_1.resolveNativeTimeout)(args);
     if (runtime === 'native')
@@ -185,6 +182,7 @@ async function spawnChip(args) {
         codex: {
             projectId: codexProjectId,
             role,
+            mechanic: role === 'mechanic' ? (0, mechanic_lifecycle_1.newMechanicLifecycle)(now) : undefined,
             label: naming.label, displayName: naming.displayName,
             bindingNonce: runtime === 'native' ? crypto.randomBytes(16).toString('hex') : undefined,
             nativeModelVerified,
@@ -202,7 +200,10 @@ async function spawnChip(args) {
         updatedAt: now,
     };
     (0, store_1.withProjectChipLock)(anchor.projectId, () => {
-        (0, goals_1.requireGoalForSpawn)(goalId, anchor.projectId, parentSession, covers);
+        (0, goals_1.requireGoalForSpawn)(goalId, anchor.projectId, parentSession, covers, role);
+        if (role === 'worker' || role === 'advisor' || role === 'mechanic') {
+            (0, goals_1.requireLeaderMissionGoalForDispatch)(goalId, anchor.projectId, parentSession);
+        }
         const active = (0, store_1.activeManifests)(anchor.projectId);
         (0, naming_1.assertNoNamingConflicts)(manifest, active);
         (0, git_1.assertNoLeaseConflicts)(owns, active);
@@ -281,6 +282,8 @@ function startNativeMonitorProcess(manifest) {
 }
 async function attachNativeChip(args) {
     let manifest = requireManifest(args[0]);
+    if (manifest.codex.role === 'leader')
+        (0, goals_1.requireLeaderMissionGoal)(manifest);
     manifest = (0, native_1.attachNativeCheckout)(manifest);
     try {
         await (0, inbox_1.sendChipEvent)(manifest, manifest.parent.sessionId, {
@@ -326,6 +329,12 @@ async function reportChip(args) {
     const marker = (0, git_1.readChipMarker)(process.cwd());
     if (!marker || marker.id !== id)
         throw new Error('Report must run from the matching managed chip checkout.');
+    const reportManifest = (0, store_1.findManifest)(id);
+    if (reportManifest?.codex.role === 'leader') {
+        const goal = (0, goals_1.requireLeaderMissionGoal)(reportManifest, true);
+        if (goal.state !== 'accepted')
+            throw new Error(`LEAD report is blocked until mission goal ${goal.id} is accepted.`);
+    }
     const reportBranch = (0, git_1.branchName)(process.cwd());
     if ((!reportBranch && !marker.detachedAllowed) || (reportBranch && reportBranch !== marker.branch)) {
         throw new Error('Chip branch does not match its marker.');
@@ -347,6 +356,7 @@ async function reportChip(args) {
         throw new Error(`Changed files outside the chip lease: ${escaped.join(', ')}`);
     }
     const manifest = requireManifest(id);
+    (0, breakthrough_1.assertNoPendingBreakthroughs)(manifest);
     const evidence = (0, goals_1.parseReportEvidence)(flags(args, '--evidence'), manifest.covers || []);
     (0, lifecycle_1.writeChipReceipt)({ type: 'report', id, commit, summary, checks: flags(args, '--check'), evidence, at: new Date().toISOString() });
     console.log(`Report submitted for chip ${id.slice(0, 8)}; host validation pending.`);
@@ -356,68 +366,18 @@ async function steerChip(args) {
     const message = args[1];
     if (!message)
         throw new Error('Steer requires a message.');
+    if (!['running', 'blocked'].includes(manifest.state))
+        throw new Error(`Chip is ${manifest.state}; only running or blocked chips can receive a breakthrough.`);
     if (!manifest.codex.threadId)
         throw new Error('Chip has not acquired a Codex thread yet.');
-    if (!['running', 'blocked'].includes(manifest.state)) {
-        throw new Error(`Chip is ${manifest.state}; only running or blocked chips can be steered.`);
-    }
-    if (manifest.codex.runtime === 'native') {
-        if (manifest.state === 'blocked') {
-            (0, native_1.assertNoLiveNativeMonitor)(manifest);
-            manifest = (0, store_1.updateManifest)(manifest.id, { state: 'running', error: undefined });
-            startNativeMonitorProcess(manifest);
-        }
-        console.log(JSON.stringify({
-            protocol: 'greprag-codex-native-steer-v1',
-            threadId: manifest.codex.threadId,
-            message,
-            instruction: 'Deliver message with the Codex Desktop native send_message_to_thread surface.',
-        }, null, 2));
-        return;
-    }
     if (manifest.state === 'blocked') {
-        manifest = (0, store_1.updateManifest)(manifest.id, {
-            state: 'running', error: undefined,
-            codex: { ...manifest.codex, turnId: undefined },
-            worker: { pid: process.pid, heartbeatAt: new Date().toISOString() },
-        });
-        await (0, worker_1.runChipWorker)(manifest.id, undefined, 2_000, message);
-        console.log(`Restarted chip ${manifest.id.slice(0, 8)} (${manifest.name}) with steering.`);
-        return;
-    }
-    const client = new codex_app_server_client_1.CodexAppServerClient({ timeoutMs: 15_000, transport: manifest.codex.transport });
-    let needsContinuation = false;
-    try {
-        await client.initialize();
-        await client.request('thread/resume', { threadId: manifest.codex.threadId });
-        const turns = await client.request('thread/turns/list', {
-            threadId: manifest.codex.threadId, limit: 5, sortDirection: 'desc', itemsView: 'notLoaded',
-        });
-        const active = turns.data?.find(turn => ['inProgress', 'in_progress', 'running'].includes(turn.status || ''));
-        const input = [{ type: 'text', text: message }];
-        let turnId;
-        if (active?.id) {
-            await client.request('turn/steer', { threadId: manifest.codex.threadId, input, expectedTurnId: active.id });
-            turnId = active.id;
-        }
-        else
-            needsContinuation = true;
-        if (turnId)
-            await waitForTurn(client, manifest.codex.threadId, turnId);
-    }
-    finally {
-        client.close();
-    }
-    if (needsContinuation) {
-        (0, store_1.updateManifest)(manifest.id, {
-            codex: { ...manifest.codex, turnId: undefined },
-            worker: { pid: process.pid, heartbeatAt: new Date().toISOString() },
-        });
-        await (0, worker_1.runChipWorker)(manifest.id, undefined, 2_000, message);
-        console.log(`Continued chip ${manifest.id.slice(0, 8)} (${manifest.name}) with steering.`);
-        return;
+        (0, native_1.assertNoLiveNativeMonitor)(manifest);
+        manifest = (0, store_1.updateManifest)(manifest.id, { state: 'running', error: undefined });
+        if (manifest.codex.runtime === 'native')
+            startNativeMonitorProcess(manifest);
     }
-    console.log(`Steered chip ${manifest.id.slice(0, 8)} (${manifest.name}).`);
+    const routed = await (0, breakthrough_command_2.routeBreakthrough)(manifest, message, manifest.codex.threadId);
+    console.log(JSON.stringify({ protocol: 'greprag-breakthrough-v1', nonce: routed.nonce, targetSession: manifest.codex.threadId }, null, 2));
 }
 async function stopChip(args) {
     let manifest = requireManifest(args[0]);
@@ -526,7 +486,7 @@ async function runCodexChip(args) {
     const sub = args[0];
     const rest = args.slice(1);
     if (!sub || ['help', '--help', '-h'].includes(sub))
-        return void console.log(HELP);
+        return void console.log(help_1.CODEX_CHIP_HELP);
     if (sub === 'goal')
         return (0, goal_command_1.runGoalCommand)(rest);
     if (sub === 'spawn')
@@ -551,6 +511,10 @@ async function runCodexChip(args) {
     }
     if (sub === 'report')
         return reportChip(rest);
+    if (sub === 'breakthrough')
+        return (0, breakthrough_command_1.runBreakthroughCommand)(rest);
+    if (sub === 'breakthrough-ack')
+        return (0, breakthrough_ack_command_1.runBreakthroughAckCommand)(rest);
     if (sub === 'resume-ack')
         return (0, resume_command_1.acknowledgeResume)(rest);
     if (sub === 'resume') {
@@ -586,6 +550,6 @@ async function runCodexChip(args) {
     }
     if (sub === 'status')
         return printManifest(requireManifest(rest[0]), rest.includes('--json'));
-    throw new Error(`Unknown codex chip command: ${sub}\n\n${HELP}`);
+    throw new Error(`Unknown codex chip command: ${sub}\n\n${help_1.CODEX_CHIP_HELP}`);
 }
 //# sourceMappingURL=command.js.map