greprag 5.45.0 → 5.47.0

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

@@ -1,56 +1,13 @@
-/** 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.
+/** Inbox cursor store — the per-session `~/.greprag/polls/<short>.cursor` file.
  *
- *  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. */
-/** 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). */
-export declare const DEFAULT_POLL_CAP = 2;
-export interface PollRecord {
-    short: string;
-    pid: number;
-    startedAt: number;
-}
-/** APPEND this poll's entry (pruning dead entries as it goes). Best-effort. */
-export declare function registerPoll(short: string, pid: number): void;
-/** Remove THIS poll's entry (on the poll's own exit — message-wake or ceiling). */
-export declare function deregisterPoll(short: string, pid: number): void;
-/** 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. */
-export declare function isPollArmed(short: string): boolean;
-/** Every live poll on this machine, freshest first. */
-export declare function listLivePolls(): PollRecord[];
-/** Last message id this session's polls have seen, or null (first poll → live
- *  tail only; no replay of pre-existing history). */
+ *  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. */
+/** Last message id this session has seen, or null (first read → live tail only). */
 export declare function readPollCursor(short: string): string | null;
 export declare function writePollCursor(short: string, id: string): void;
-/** 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. */
+/** Drop the cursor (→ next read resumes from the live tail). */
 export declare function clearPollCursor(short: string): void;
-export interface PollCapResult {
-    scanned: number;
-    surplus: number;
-    killed: number[];
-}
-/** 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 */
-export declare function reapSurplusPolls(K?: number): PollCapResult;

package/dist/commands/poll-registry.js

@@ -1,20 +1,12 @@
 "use strict";
-/** 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.
+/** Inbox cursor store — the per-session `~/.greprag/polls/<short>.cursor` file.
  *
- *  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. */
+ *  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. */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -49,23 +41,12 @@ 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;
@@ -74,105 +55,11 @@ 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's polls have seen, or null (first poll → live
- *  tail only; no replay of pre-existing history). */
+/** Last message id this session has seen, or null (first read → live tail only). */
 function readPollCursor(short) {
     try {
         const p = cursorPath(short);
@@ -195,10 +82,7 @@ function writePollCursor(short, id) {
     }
     catch { /* best-effort — at worst one message is re-delivered */ }
 }
-/** 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. */
+/** Drop the cursor (→ next read resumes from the live tail). */
 function clearPollCursor(short) {
     try {
         const p = cursorPath(short);
@@ -207,55 +91,4 @@ 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":"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"}
+{"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"}

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

@@ -0,0 +1,20 @@
+/** The reminder-interrupt registry CONTAINER (docs/reminder-interrupt.md §Registry
+ *  spec). One loop over all modules: per turn, fire each module's thin reminder while
+ *  its detector says deficient; at SessionStart, emit each announce. Stacking welcome.
+ *  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). */
+import { ReminderEnv, ReminderModule, Detection } from './reminder-types';
+/** Registry order = display order. Detector-gated modules first (watcher-arm is the
+ *  reference), graded/ambient after. Add a module here to wire it everywhere. */
+export declare const REGISTRY: ReminderModule[];
+export interface FiredReminder {
+    id: string;
+    tier: Detection['tier'];
+    line: string;
+}
+/** 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. */
+export declare function collectReminders(env: ReminderEnv, registry?: ReminderModule[]): FiredReminder[];
+/** SessionStart: every module's announce (skipping null), in registry order. */
+export declare function collectAnnounces(env: ReminderEnv, registry?: ReminderModule[]): string[];

package/dist/commands/reminder-registry.js

@@ -0,0 +1,59 @@
+"use strict";
+/** The reminder-interrupt registry CONTAINER (docs/reminder-interrupt.md §Registry
+ *  spec). One loop over all modules: per turn, fire each module's thin reminder while
+ *  its detector says deficient; at SessionStart, emit each announce. Stacking welcome.
+ *  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.REGISTRY = void 0;
+exports.collectReminders = collectReminders;
+exports.collectAnnounces = collectAnnounces;
+const arm_reminder_1 = require("./arm-reminder");
+const friction_reminder_1 = require("./friction-reminder");
+/** Registry order = display order. Detector-gated modules first (watcher-arm is the
+ *  reference), graded/ambient after. Add a module here to wire it everywhere. */
+exports.REGISTRY = [arm_reminder_1.watcherArmModule, friction_reminder_1.mechanicFrictionModule];
+/** 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. */
+function collectReminders(env, registry = exports.REGISTRY) {
+    const out = [];
+    for (const m of registry) {
+        let d;
+        try {
+            d = m.detect(env);
+        }
+        catch {
+            continue;
+        }
+        if (!d || d.tier === 'silent')
+            continue;
+        let line = null;
+        try {
+            line = m.reminder(d, env);
+        }
+        catch {
+            continue;
+        }
+        if (line)
+            out.push({ id: m.id, tier: d.tier, line });
+    }
+    return out;
+}
+/** SessionStart: every module's announce (skipping null), in registry order. */
+function collectAnnounces(env, registry = exports.REGISTRY) {
+    const out = [];
+    for (const m of registry) {
+        let a = null;
+        try {
+            a = m.announce(env);
+        }
+        catch {
+            continue;
+        }
+        if (a)
+            out.push(a);
+    }
+    return out;
+}
+//# sourceMappingURL=reminder-registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reminder-registry.js","sourceRoot":"","sources":["../../src/commands/reminder-registry.ts"],"names":[],"mappings":";AAAA;;;;kEAIkE;;;AAmBlE,4CAaC;AAGD,4CAUC;AA1CD,iDAAkD;AAClD,2DAA6D;AAE7D;iFACiF;AACpE,QAAA,QAAQ,GAAqB,CAAC,+BAAgB,EAAE,0CAAsB,CAAC,CAAC;AAQrF;;mEAEmE;AACnE,SAAgB,gBAAgB,CAC9B,GAAgB,EAAE,WAA6B,gBAAQ;IAEvD,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAY,CAAC;QACjB,IAAI,CAAC;YAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,SAAS;QAAC,CAAC;QAC9C,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;YAAE,SAAS;QACxC,IAAI,IAAI,GAAkB,IAAI,CAAC;QAC/B,IAAI,CAAC;YAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,SAAS;QAAC,CAAC;QACtD,IAAI,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,gFAAgF;AAChF,SAAgB,gBAAgB,CAC9B,GAAgB,EAAE,WAA6B,gBAAQ;IAEvD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,GAAkB,IAAI,CAAC;QAC5B,IAAI,CAAC;YAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,SAAS;QAAC,CAAC;QAChD,IAAI,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -0,0 +1,49 @@
+/** Shared types for the reminder-interrupt registry (docs/reminder-interrupt.md
+ *  §Registry spec — the detector model). Modeled on the WORKING arm-check loop:
+ *  detect a live external deficiency → fire while it holds → auto-silence the
+ *  instant it resolves. `detect(env)` is the primitive (the arm-check's
+ *  `isLocallyArmed`, generalized); a turn counter is not. */
+/** Firing-tier ladder. `silent` = the deficiency is resolved (the auto-stop); the
+ *  rest escalate wording intensity with the cost of inaction (ambient = soft
+ *  pointer, nudge = imperative + reason, nag = LOUD forced-decision). */
+export type Tier = 'silent' | 'ambient' | 'nudge' | 'nag';
+/** The live-state bag the hook assembles ONCE per turn — ALL i/o lives in the hook
+ *  so modules stay pure (and their detect→silent transition stays unit-testable).
+ *  Grows as modules need new signals. */
+export interface ReminderEnv {
+    /** 8-hex session id. */
+    short: string;
+    /** Turns elapsed this session (for any ambient-cadence module). */
+    turnCount: number;
+    /** Live behavioral stress (docs/stress-trigger.md): 0 calm / 1 elevated / 2 high. */
+    stress: number;
+    /** Live local watcher present? (isLocallyArmed) — the arm-check's signal. */
+    armed: boolean;
+    /** Unread messages addressed to THIS session (own mail — NOT the project-wide
+     *  v5.6.1 eavesdrop count). */
+    sessionUnread: number;
+    /** Owning claude.exe PID — baked into the arm command. */
+    ownerPid?: number | null;
+    /** Identity handle (alias before @) for reply-address templating. */
+    alias?: string | null;
+    /** Assistant project → elevated watcher arm. */
+    assistant?: boolean;
+}
+/** A module's per-turn read of its deficiency. `tier:'silent'` = resolved → no fire. */
+export interface Detection {
+    tier: Tier;
+    /** Optional grounding data the reminder line interpolates (e.g. unread count). */
+    detail?: Record<string, unknown>;
+}
+/** A reminder-interrupt registry module (docs/reminder-interrupt.md §Registry spec).
+ *  PURE over ReminderEnv — the container/hook owns all i/o, so detect→silent is the
+ *  unit-testable regression-lock. */
+export interface ReminderModule {
+    id: string;
+    /** Read the live deficiency. The gate: `silent` ⇒ the module is quiet this turn. */
+    detect: (env: ReminderEnv) => Detection;
+    /** SessionStart schema, loaded once (teach method + why). null = nothing to announce. */
+    announce: (env: ReminderEnv) => string | null;
+    /** Per-turn thin line for a live detection; null when silent. */
+    reminder: (d: Detection, env: ReminderEnv) => string | null;
+}

package/dist/commands/reminder-types.js

@@ -0,0 +1,8 @@
+"use strict";
+/** Shared types for the reminder-interrupt registry (docs/reminder-interrupt.md
+ *  §Registry spec — the detector model). Modeled on the WORKING arm-check loop:
+ *  detect a live external deficiency → fire while it holds → auto-silence the
+ *  instant it resolves. `detect(env)` is the primitive (the arm-check's
+ *  `isLocallyArmed`, generalized); a turn counter is not. */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=reminder-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reminder-types.js","sourceRoot":"","sources":["../../src/commands/reminder-types.ts"],"names":[],"mappings":";AAAA;;;;6DAI6D"}