greprag 5.49.10 → 5.49.12

package/dist/commands/poll-registry.js

@@ -1,12 +1,20 @@
 "use strict";
-/** Inbox cursor store — the per-session `~/.greprag/polls/<short>.cursor` file.
+/** Poll registry — local pidfile tracking for the asyncRewake idle-liveness
+ *  polls (`greprag inbox poll`), kept in its OWN namespace `~/.greprag/polls/`
+ *  so it NEVER touches the Monitor watcher's `~/.greprag/watchers/` registry.
  *
- *  HISTORY: this module WAS the asyncRewake idle-liveness POLL registry (pidfiles,
- *  count-cap, liveness probes). The poll was REMOVED — it cost ~1 long-lived node
- *  process per session (~1.1 GB across the operator's concurrent sessions); the
- *  Monitor watcher + the SessionStart drain are the delivery path. See
- *  adr/monitor-resilience.md. Only the cursor helpers survive, still used by the
- *  `drain` hook to track a stable last-seen id. */
+ *  WHY SEPARATE: `notify`'s `isLocallyArmed` reads the watcher registry to decide
+ *  whether to inject the Monitor arm directive. If a poll registered there, the
+ *  Monitor arm would go silent and the poll would REPLACE Monitor instead of
+ *  running ALONGSIDE it. The two liveness mechanisms must be independent until a
+ *  deliberate cutover. adr: adr/monitor-resilience.md
+ *
+ *  The cleanup model mirrors the SHIPPED watcher count-cap (and reuses its pure
+ *  `capSurplusVerdict`): per session, keep the K freshest LIVE polls, reap only
+ *  the surplus, never below K. No death-judgment — a count + a floor — so it can
+ *  never false-kill the live poll. Reload-orphans (if asyncRewake does not adopt
+ *  a process across reload) are bounded here AND self-clean via the poll's own
+ *  max-lifetime ceiling. */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -41,12 +49,23 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_POLL_CAP = void 0;
+exports.registerPoll = registerPoll;
+exports.deregisterPoll = deregisterPoll;
+exports.isPollArmed = isPollArmed;
+exports.listLivePolls = listLivePolls;
 exports.readPollCursor = readPollCursor;
 exports.writePollCursor = writePollCursor;
 exports.clearPollCursor = clearPollCursor;
+exports.reapSurplusPolls = reapSurplusPolls;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const watcher_registry_1 = require("./watcher-registry");
 const POLL_DIRNAME = 'polls';
+/** Default per-session poll floor: keep this many freshest live polls, reap the
+ *  surplus, never below it. K=2 = the live one + one margin (a reload overlap). */
+exports.DEFAULT_POLL_CAP = 2;
 function grepragHome() {
     const home = process.env.HOME || process.env.USERPROFILE || '';
     return home ? path.join(home, '.greprag') : null;
@@ -55,11 +74,105 @@ function pollsDir() {
     const h = grepragHome();
     return h ? path.join(h, POLL_DIRNAME) : null;
 }
+function pollfilePath(short) {
+    const dir = pollsDir();
+    return dir ? path.join(dir, `${short}.json`) : null;
+}
+/** True iff `pid` is a live process. `process.kill(pid, 0)` probes existence
+ *  without signalling; EPERM = exists (another user), ESRCH = gone. */
+function pidAlive(pid) {
+    if (!Number.isFinite(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        return e?.code === 'EPERM';
+    }
+}
+function readPollEntries(short) {
+    try {
+        const p = pollfilePath(short);
+        if (!p)
+            return [];
+        const parsed = JSON.parse(fs.readFileSync(p, 'utf-8'));
+        const arr = Array.isArray(parsed) ? parsed : [parsed];
+        return arr.filter((r) => !!r && typeof r.pid === 'number');
+    }
+    catch {
+        return [];
+    }
+}
+function writePollEntries(short, entries) {
+    try {
+        const dir = pollsDir();
+        if (!dir)
+            return;
+        fs.mkdirSync(dir, { recursive: true });
+        const p = path.join(dir, `${short}.json`);
+        if (entries.length === 0) {
+            fs.rmSync(p, { force: true });
+            return;
+        }
+        fs.writeFileSync(p, JSON.stringify(entries));
+    }
+    catch { /* best-effort — a failed write only means a re-arm, never a crash */ }
+}
+function allShorts() {
+    try {
+        const dir = pollsDir();
+        if (!dir || !fs.existsSync(dir))
+            return [];
+        return fs.readdirSync(dir).filter(f => f.endsWith('.json')).map(f => f.slice(0, -5));
+    }
+    catch {
+        return [];
+    }
+}
+/** APPEND this poll's entry (pruning dead entries as it goes). Best-effort. */
+function registerPoll(short, pid) {
+    const entries = readPollEntries(short).filter(r => r.pid !== pid && pidAlive(r.pid));
+    entries.push({ short, pid, startedAt: Date.now() });
+    writePollEntries(short, entries);
+}
+/** Remove THIS poll's entry (on the poll's own exit — message-wake or ceiling). */
+function deregisterPoll(short, pid) {
+    writePollEntries(short, readPollEntries(short).filter(r => r.pid !== pid));
+}
+/** Does this session have ANY live poll right now? The re-arm gate: a gated arm
+ *  (PostToolUse / UserPromptSubmit) skips when true so per-tool fires don't pile
+ *  up; SessionStart never gates (it always arms a fresh, reload-adopted poll).
+ *  Sweeps dead entries as it reads. */
+function isPollArmed(short) {
+    const entries = readPollEntries(short);
+    const alive = entries.filter(r => pidAlive(r.pid));
+    if (alive.length !== entries.length)
+        writePollEntries(short, alive);
+    return alive.length > 0;
+}
+/** Every live poll on this machine, freshest first. */
+function listLivePolls() {
+    const out = [];
+    for (const short of allShorts()) {
+        const entries = readPollEntries(short);
+        const alive = entries.filter(r => pidAlive(r.pid));
+        if (alive.length !== entries.length)
+            writePollEntries(short, alive);
+        out.push(...alive);
+    }
+    return out.sort((a, b) => (b.startedAt || 0) - (a.startedAt || 0));
+}
+// ---- Cursor (gap-recovery so the long-poll never loses a message) ----------
+// Each poll resumes the SSE stream from the last id it persisted (`?since=`),
+// so a message that arrives between one poll exiting and the next arming is
+// REPLAYED, not lost. The cursor is per-session, shared across poll invocations.
 function cursorPath(short) {
     const dir = pollsDir();
     return dir ? path.join(dir, `${short}.cursor`) : null;
 }
-/** Last message id this session has seen, or null (first read → live tail only). */
+/** Last message id this session's polls have seen, or null (first poll → live
+ *  tail only; no replay of pre-existing history). */
 function readPollCursor(short) {
     try {
         const p = cursorPath(short);
@@ -82,7 +195,10 @@ function writePollCursor(short, id) {
     }
     catch { /* best-effort — at worst one message is re-delivered */ }
 }
-/** Drop the cursor (→ next read resumes from the live tail). */
+/** Drop the cursor (→ next poll live-tails from now). Called when the server
+ *  rejects the stored `since` (the message it points to was pruned/deleted): a
+ *  stale cursor would otherwise 4xx forever, permanently wedging delivery for
+ *  this session. Clearing it trades replay of the gap for restored liveness. */
 function clearPollCursor(short) {
     try {
         const p = cursorPath(short);
@@ -91,4 +207,55 @@ function clearPollCursor(short) {
     }
     catch { /* best-effort */ }
 }
+/** Count-cap every session's polls: keep the K freshest LIVE polls, kill only the
+ *  surplus, never below K. Snapshot-free (per-session file reads + pidAlive); a
+ *  `taskkill` only on genuine surplus. Run at SessionStart (recap hook) and via
+ *  `greprag inbox poll-reap`. Reuses the watcher's pure `capSurplusVerdict` — the
+ *  same liveness-safety guarantee, applied to the poll namespace.
+ *  adr: adr/monitor-resilience.md */
+function reapSurplusPolls(K = exports.DEFAULT_POLL_CAP) {
+    let scanned = 0;
+    let surplus = 0;
+    const killed = [];
+    for (const short of allShorts()) {
+        const alive = readPollEntries(short).filter(r => pidAlive(r.pid));
+        scanned += alive.length;
+        const { keep, kill } = (0, watcher_registry_1.capSurplusVerdict)(alive, K);
+        if (kill.length === 0) {
+            writePollEntries(short, alive);
+            continue;
+        }
+        surplus += kill.length;
+        const survivors = keep.slice();
+        for (const w of kill) {
+            if (killProcess(w.pid))
+                killed.push(w.pid);
+            else
+                survivors.push(w); // kill failed → keep tracking, retry next pass
+        }
+        writePollEntries(short, survivors);
+    }
+    return { scanned, surplus, killed };
+}
+/** Force-kill a poll process. A poll has no children (single SSE process), so a
+ *  plain kill suffices — but `taskkill /T` is used on Windows for symmetry with
+ *  the watcher and to catch any incidental child. */
+function killProcess(pid) {
+    try {
+        if (process.platform === 'win32') {
+            (0, child_process_1.execFileSync)('taskkill.exe', ['/PID', String(pid), '/T', '/F'], // proc-allow: poll count-cap surplus kill, mirrors watcher-registry
+            { timeout: 5_000, stdio: 'ignore', windowsHide: true });
+        }
+        else {
+            try {
+                process.kill(pid, 'SIGKILL');
+            }
+            catch { /* already gone */ }
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 //# sourceMappingURL=poll-registry.js.map

package/dist/commands/poll-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"poll-registry.js","sourceRoot":"","sources":["../../src/commands/poll-registry.ts"],"names":[],"mappings":";AAAA;;;;;;;mDAOmD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBnD,wCAOC;AAED,0CAOC;AAGD,0CAKC;AA7CD,uCAAyB;AACzB,2CAA6B;AAE7B,MAAM,YAAY,GAAG,OAAO,CAAC;AAE7B,SAAS,WAAW;IAClB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;IAC/D,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACnD,CAAC;AAED,SAAS,QAAQ;IACf,MAAM,CAAC,GAAG,WAAW,EAAE,CAAC;IACxB,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,MAAM,GAAG,GAAG,QAAQ,EAAE,CAAC;IACvB,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACxD,CAAC;AAED,oFAAoF;AACpF,SAAgB,cAAc,CAAC,KAAa;IAC1C,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACpB,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,OAAO,CAAC,IAAI,IAAI,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;AAC1B,CAAC;AAED,SAAgB,eAAe,CAAC,KAAa,EAAE,EAAU;IACvD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,QAAQ,EAAE,CAAC;QACvB,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE;YAAE,OAAO;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC,CAAC,wDAAwD,CAAC,CAAC;AACtE,CAAC;AAED,gEAAgE;AAChE,SAAgB,eAAe,CAAC,KAAa;IAC3C,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC;YAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"poll-registry.js","sourceRoot":"","sources":["../../src/commands/poll-registry.ts"],"names":[],"mappings":"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"}

package/dist/commands/procedure.d.ts

@@ -0,0 +1,15 @@
+/** `greprag procedure` — manage the project's operational recipes
+ *  (docs/procedure-system.md). PROOF slice: seed + inspect + dry-run match.
+ *
+ *  Subcommands:
+ *    list                     — show this project's procedures
+ *    show <verb>              — print one procedure + its injection text
+ *    seed [--git]             — write the git-ecosystem seed set (commit/merge/push/deploy/release)
+ *    register --verb V --steps "..." [--caveats "..."] [--endpoint "..."] [--trigger T ...] [--destructive]
+ *    rm <verb>                — remove a procedure
+ *    match "<text>"           — dry-run: what would inject for this prompt
+ *
+ *  Identity comes from the project anchor (git-root-derived), same key the
+ *  hot-path hook uses. Zero network — the store is the local file beside the
+ *  matchset cache. */
+export declare function runProcedure(args: string[]): Promise<void>;

package/dist/commands/procedure.js

@@ -0,0 +1,167 @@
+"use strict";
+/** `greprag procedure` — manage the project's operational recipes
+ *  (docs/procedure-system.md). PROOF slice: seed + inspect + dry-run match.
+ *
+ *  Subcommands:
+ *    list                     — show this project's procedures
+ *    show <verb>              — print one procedure + its injection text
+ *    seed [--git]             — write the git-ecosystem seed set (commit/merge/push/deploy/release)
+ *    register --verb V --steps "..." [--caveats "..."] [--endpoint "..."] [--trigger T ...] [--destructive]
+ *    rm <verb>                — remove a procedure
+ *    match "<text>"           — dry-run: what would inject for this prompt
+ *
+ *  Identity comes from the project anchor (git-root-derived), same key the
+ *  hot-path hook uses. Zero network — the store is the local file beside the
+ *  matchset cache. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runProcedure = runProcedure;
+const procedure_1 = require("../procedure");
+const project_anchor_1 = require("../project-anchor");
+function getFlag(args, flag) {
+    const idx = args.indexOf(flag);
+    if (idx === -1 || idx + 1 >= args.length)
+        return undefined;
+    return args[idx + 1];
+}
+/** Collect every `--trigger X` occurrence (repeatable flag). */
+function collectFlags(args, flag) {
+    const out = [];
+    for (let i = 0; i < args.length - 1; i++) {
+        if (args[i] === flag)
+            out.push(args[i + 1]);
+    }
+    return out;
+}
+function resolveProjectId() {
+    const anchor = (0, project_anchor_1.readAnchor)(process.cwd());
+    return { projectId: anchor.projectId, projectName: anchor.projectName };
+}
+function printProcedure(p) {
+    const tag = p.destructive ? ' [DESTRUCTIVE — seed-only]' : '';
+    console.log(`  ${p.verb}  (${p.status})${tag}`);
+    console.log(`    triggers: ${p.triggers.join(', ')}`);
+    console.log(`    steps:    ${p.steps}`);
+    if (p.caveats)
+        console.log(`    gate:     ${p.caveats}`);
+    if (p.endpoint)
+        console.log(`    endpoint: ${p.endpoint}`);
+}
+async function runProcedure(args) {
+    const sub = args[0];
+    const rest = args.slice(1);
+    const { projectId, projectName } = resolveProjectId();
+    switch (sub) {
+        case 'list': {
+            const store = (0, procedure_1.readProcedureStore)(projectId);
+            if (store.procedures.length === 0) {
+                console.log(`No procedures for ${projectName}. Seed the git set: greprag procedure seed --git`);
+                return;
+            }
+            console.log(`Procedures for ${projectName} (${store.procedures.length}):`);
+            for (const p of store.procedures)
+                printProcedure(p);
+            console.log(`\n  store: ${(0, procedure_1.procedureStorePath)(projectId)}`);
+            return;
+        }
+        case 'show': {
+            const verb = rest[0];
+            if (!verb) {
+                console.error('Usage: greprag procedure show <verb>');
+                process.exit(1);
+            }
+            const store = (0, procedure_1.readProcedureStore)(projectId);
+            const p = store.procedures.find(x => x.verb === verb);
+            if (!p) {
+                console.error(`No procedure "${verb}" for ${projectName}.`);
+                process.exit(1);
+            }
+            printProcedure(p);
+            console.log(`\n  --- injection text (what the agent sees) ---`);
+            console.log((0, procedure_1.buildProcedureInjection)(p));
+            return;
+        }
+        case 'seed': {
+            // --git is the only seed set today; default to it so bare `seed` works.
+            const store = (0, procedure_1.readProcedureStore)(projectId);
+            let next = store;
+            for (const p of procedure_1.GIT_SEED_SET) {
+                next = (0, procedure_1.upsertProcedure)(next, p, /* force */ true);
+            }
+            (0, procedure_1.writeProcedureStore)(projectId, next);
+            console.log(`Seeded ${procedure_1.GIT_SEED_SET.length} git-ecosystem procedures for ${projectName}:`);
+            for (const p of procedure_1.GIT_SEED_SET)
+                console.log(`  • ${p.verb}${p.destructive ? ' (destructive — seed-only)' : ''}`);
+            console.log(`\n  store: ${(0, procedure_1.procedureStorePath)(projectId)}`);
+            return;
+        }
+        case 'register': {
+            const verb = getFlag(rest, '--verb');
+            const steps = getFlag(rest, '--steps');
+            if (!verb || !steps) {
+                console.error('Usage: greprag procedure register --verb <v> --steps "<...>" [--caveats "<...>"] [--endpoint "<...>"] [--trigger <t> ...] [--destructive]');
+                process.exit(1);
+            }
+            const triggers = collectFlags(rest, '--trigger');
+            const proc = {
+                verb,
+                triggers: triggers.length ? triggers : [verb],
+                steps,
+                caveats: getFlag(rest, '--caveats'),
+                endpoint: getFlag(rest, '--endpoint'),
+                status: 'seeded',
+                destructive: rest.includes('--destructive') || undefined,
+            };
+            const store = (0, procedure_1.readProcedureStore)(projectId);
+            (0, procedure_1.writeProcedureStore)(projectId, (0, procedure_1.upsertProcedure)(store, proc, /* force */ true));
+            console.log(`Registered procedure "${verb}" for ${projectName}.`);
+            printProcedure(proc);
+            return;
+        }
+        case 'rm': {
+            const verb = rest[0];
+            if (!verb) {
+                console.error('Usage: greprag procedure rm <verb>');
+                process.exit(1);
+            }
+            const store = (0, procedure_1.readProcedureStore)(projectId);
+            if (!store.procedures.some(p => p.verb === verb)) {
+                console.error(`No procedure "${verb}" for ${projectName}.`);
+                process.exit(1);
+            }
+            (0, procedure_1.writeProcedureStore)(projectId, (0, procedure_1.removeProcedure)(store, verb));
+            console.log(`Removed procedure "${verb}".`);
+            return;
+        }
+        case 'match': {
+            const text = rest.join(' ').trim();
+            if (!text) {
+                console.error('Usage: greprag procedure match "<prompt text>"');
+                process.exit(1);
+            }
+            const store = (0, procedure_1.readProcedureStore)(projectId);
+            const m = (0, procedure_1.matchProcedure)(text, store);
+            if (!m) {
+                const raw = (0, procedure_1.matchProcedure)(text, store, { ignoreIntentGuard: true });
+                if (raw) {
+                    console.log(`No injection — "${raw.procedure.verb}" matched on "${raw.trigger}" but the intent guard suppressed it (reads as a mention, not a request).`);
+                    return;
+                }
+                console.log(`No procedure matches: "${text}"`);
+                return;
+            }
+            console.log(`Matched "${m.procedure.verb}" via trigger "${m.trigger}". Would inject:\n`);
+            console.log((0, procedure_1.buildProcedureInjection)(m.procedure));
+            return;
+        }
+        default:
+            console.log('greprag procedure — operational recipes for this repo (docs/procedure-system.md)');
+            console.log('  list                 list this project\'s procedures');
+            console.log('  show <verb>          print one + its injection text');
+            console.log('  seed --git           write the git-ecosystem seed set');
+            console.log('  register --verb ...  hand-roll a procedure');
+            console.log('  rm <verb>            remove a procedure');
+            console.log('  match "<text>"       dry-run: what would inject for this prompt');
+            return;
+    }
+}
+//# sourceMappingURL=procedure.js.map

package/dist/commands/procedure.js.map

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

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

@@ -16,6 +16,11 @@ export declare const REGISTRY: ReminderModule[];
  *  modules (they read env.toolCommand). Announces are always prompt-side (SessionStart). */
 export declare const promptModules: (registry?: ReminderModule[]) => ReminderModule[];
 export declare const commandModules: (registry?: ReminderModule[]) => ReminderModule[];
+/** PostCompact re-announce set (docs/reminder-interrupt.md). A compaction wipes the
+ *  SessionStart announces from context, so the announce modules re-present afterward —
+ *  by DEFAULT all of them; a module opts out with `reannounceOnCompact: false`. The
+ *  hook renders these (announce-only — no memory recap body) on the PostCompact event. */
+export declare const compactReannounceModules: (registry?: ReminderModule[]) => ReminderModule[];
 export interface FiredReminder {
     id: string;
     tier: Detection['tier'];

package/dist/commands/reminder-registry.js

@@ -5,7 +5,7 @@
  *  PURE over ReminderEnv — the hook assembles env (i/o) and emits the returned lines;
  *  a broken module never blocks a turn (fail-open per module). */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.commandModules = exports.promptModules = exports.REGISTRY = void 0;
+exports.compactReannounceModules = exports.commandModules = exports.promptModules = exports.REGISTRY = void 0;
 exports.collectReminders = collectReminders;
 exports.bootOrder = bootOrder;
 exports.collectAnnounces = collectAnnounces;
@@ -13,7 +13,6 @@ const inbox_primer_reminder_1 = require("./inbox-primer-reminder");
 const load_primer_reminder_1 = require("./load-primer-reminder");
 const corpus_reminder_1 = require("./corpus-reminder");
 const setup_reminder_1 = require("./setup-reminder");
-const frontdesk_reminder_1 = require("./frontdesk-reminder");
 const assistant_reminder_1 = require("./assistant-reminder");
 const memory_reflex_1 = require("./memory-reflex");
 const arm_reminder_1 = require("./arm-reminder");
@@ -33,7 +32,6 @@ exports.REGISTRY = [
     corpus_reminder_1.corpusAnnounceModule,
     setup_reminder_1.setupWarningModule,
     version_reminder_1.versionUpgradeModule, // Deficiency-gated announce — silent unless a newer release exists
-    frontdesk_reminder_1.frontDeskModule,
     assistant_reminder_1.assistantDoctrineModule,
     memory_reflex_1.memoryPrimerModule,
     arm_reminder_1.watcherArmModule,
@@ -47,6 +45,12 @@ const promptModules = (registry = exports.REGISTRY) => registry.filter((m) => (m
 exports.promptModules = promptModules;
 const commandModules = (registry = exports.REGISTRY) => registry.filter((m) => m.source === 'command');
 exports.commandModules = commandModules;
+/** PostCompact re-announce set (docs/reminder-interrupt.md). A compaction wipes the
+ *  SessionStart announces from context, so the announce modules re-present afterward —
+ *  by DEFAULT all of them; a module opts out with `reannounceOnCompact: false`. The
+ *  hook renders these (announce-only — no memory recap body) on the PostCompact event. */
+const compactReannounceModules = (registry = exports.REGISTRY) => registry.filter((m) => m.reannounceOnCompact !== false);
+exports.compactReannounceModules = compactReannounceModules;
 /** Per-turn: every module's live reminder line (skipping silent), in registry order.
  *  Stacking — a turn may carry several. A detector or reminder that throws drops that
  *  module for the turn; it never blocks the others or the turn. */

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

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

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

@@ -33,8 +33,6 @@ export interface ReminderEnv {
     /** Precomputed identity setup/drift warning — the hook owns the anchor logic AND its
      *  rate-limit stamp (a side-effect), so this module half is a pass-through. */
     setupWarning?: string | null;
-    /** Front-desk unread count (the SessionStart count announce). */
-    frontDeskUnread?: number;
     /** Precomputed assistant-doctrine context — the hook owns the doctrine-file read, so
      *  this module half is a pass-through. Null for any non-assistant project. */
     assistantDoctrine?: string | null;
@@ -51,9 +49,6 @@ export interface ReminderEnv {
      *  searches them before answering from training data. Empty/undefined → the
      *  corpus announce stays silent. adr: adr/corpus-tags.md */
     corpusApiDocs?: string[];
-    /** Envelope-only "you've got mail" front-desk notice — the hook owns the network +
-     *  per-machine dedup; the front-desk module routes it as its per-turn reminder. */
-    frontDeskNotice?: string | null;
     /** Auto-surfaced episodic-memory injection — the hook owns the recall-intent gate +
      *  the search + the confidence gate + framing; the memory-reflex module routes the
      *  framed string as its per-turn reminder. Null = nothing cleared the gate this turn. */
@@ -94,6 +89,13 @@ export interface ReminderModule {
     detect: (env: ReminderEnv) => Detection;
     /** SessionStart schema, loaded once (teach method + why). null = nothing to announce. */
     announce: (env: ReminderEnv) => string | null;
+    /** Re-present this announce after a PostCompact (compaction wipes the SessionStart
+     *  announces from context, so by DEFAULT every announce re-fires post-compact). Set
+     *  `false` to opt a module out — e.g. a one-shot/noisy startup-only announce that should
+     *  NOT repeat every compaction. Default (undefined) = re-announce. The PostCompact pass
+     *  emits announces only; the heavy memory recap body stays startup-only.
+     *  docs/reminder-interrupt.md, adr: adr/monitor-resilience.md */
+    reannounceOnCompact?: boolean;
     /** Per-turn thin line for a live detection; null when silent. */
     reminder: (d: Detection, env: ReminderEnv) => string | null;
 }