greprag 5.49.10 → 5.49.11

package/dist/commands/checkpoint-reminder.js

@@ -1,50 +0,0 @@
-"use strict";
-/** checkpoint — the open-checkpoints SessionStart landmark as a reminder-interrupt
- *  module (docs/reminder-interrupt.md §Registry spec). announce-ONLY: checkpoints are
- *  operator-triggered landmarks surfaced once at session start, never per-turn traffic
- *  (reminder → null). `detect` gates on the hook-supplied list so the announce auto-
- *  silences when nothing is open. The PURE render (list → hint block) lives here — the
- *  hook owns only the fetch (I/O), keeping the module unit-testable. */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkpointModule = void 0;
-exports.renderCheckpointHint = renderCheckpointHint;
-exports.checkpointDetect = checkpointDetect;
-/** Render a YYYY-MM-DD date in UTC for the session-start hint. */
-function fmtCheckpointDate(iso) {
-    return iso.slice(0, 10);
-}
-/** Format the open-checkpoints hint block: 3-most-recent rows + a single overflow line
- *  when there are more. Returns null on zero (the announce is then skipped). */
-function renderCheckpointHint(open, projectName) {
-    if (open.length === 0)
-        return null;
-    // Server returns DESC by created_at; take the 3 most recent.
-    const top = open.slice(0, 3);
-    const overflow = open.length - top.length;
-    const lines = [];
-    lines.push(`[${open.length} checkpoint${open.length === 1 ? '' : 's'} open in ${projectName}:`);
-    for (const cp of top) {
-        lines.push(`  · ${cp.nodeId}  ${cp.title} (since ${fmtCheckpointDate(cp.createdAt)})`);
-    }
-    if (overflow > 0) {
-        lines.push(`  · ${overflow} more — greprag checkpoint list]`);
-    }
-    else {
-        lines.push(` View one: greprag checkpoint show <id>]`);
-    }
-    return lines.join('\n');
-}
-/** Open checkpoints present → ambient announce; none (or per-turn, where the list is
- *  absent) → silent. */
-function checkpointDetect(env) {
-    return (env.openCheckpoints && env.openCheckpoints.length > 0)
-        ? { tier: 'ambient' }
-        : { tier: 'silent' };
-}
-exports.checkpointModule = {
-    id: 'checkpoint',
-    detect: checkpointDetect,
-    announce: (env) => renderCheckpointHint(env.openCheckpoints ?? [], env.projectName ?? ''),
-    reminder: () => null,
-};
-//# sourceMappingURL=checkpoint-reminder.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"checkpoint-reminder.js","sourceRoot":"","sources":["../../src/commands/checkpoint-reminder.ts"],"names":[],"mappings":";AAAA;;;;;wEAKwE;;;AAWxE,oDAgBC;AAID,4CAIC;AA/BD,kEAAkE;AAClE,SAAS,iBAAiB,CAAC,GAAW;IACpC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1B,CAAC;AAED;gFACgF;AAChF,SAAgB,oBAAoB,CAAC,IAA0B,EAAE,WAAmB;IAClF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,6DAA6D;IAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,cAAc,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,YAAY,WAAW,GAAG,CAAC,CAAC;IAChG,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,KAAK,WAAW,iBAAiB,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,kCAAkC,CAAC,CAAC;IAChE,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;wBACwB;AACxB,SAAgB,gBAAgB,CAAC,GAAgB;IAC/C,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5D,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;QACrB,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AACzB,CAAC;AAEY,QAAA,gBAAgB,GAAmB;IAC9C,EAAE,EAAE,YAAY;IAChB,MAAM,EAAE,gBAAgB;IACxB,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;IACzF,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI;CACrB,CAAC"}

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

@@ -1,23 +0,0 @@
-/** front-desk — the shared tenant front-desk mailbox as a reminder-interrupt module
- *  (docs/reminder-interrupt.md §Registry spec). The module that uses BOTH halves of the
- *  pair: a SessionStart `announce` (discreet count of cold opens + inbound email waiting
- *  at the shared desk) AND a per-turn `reminder` (envelope-only "you've got mail from X"
- *  notice). This is the "announce + reminder often utilize each other" case the registry
- *  was consolidated for — one module, one mailbox, two surfaces.
- *
- *  PURE: the hook owns the count fetch (frontDeskUnread) AND the notice's network + per-
- *  machine dedup (frontDeskNotice), passing both via env; the module only formats the
- *  count and routes the precomputed notice.
- *
- *  Privacy — front-desk is the SHARED tenant mailbox (cold opens + inbound email addressed
- *  to nobody's session), so its count leaks nothing private. This is NOT the v5.6.1
- *  project-wide eavesdrop vector that betrayed a sibling session's session-targeted DMs.
- *  adr: adr/address-grammar.md (2026-06-10), docs/front-desk-switchboard.md §5 */
-import { ReminderEnv, Detection, ReminderModule } from './reminder-types';
-/** SessionStart count hint — the discreet door (count + how to read), never content.
- *  Null at zero so the announce is skipped. */
-export declare function buildFrontDeskAnnounce(unread: number): string | null;
-/** Either surface has something → ambient (soft, never a forced-decision directive); else
- *  silent. SessionStart sets frontDeskUnread; per-turn sets frontDeskNotice. */
-export declare function frontDeskDetect(env: ReminderEnv): Detection;
-export declare const frontDeskModule: ReminderModule;

package/dist/commands/frontdesk-reminder.js

@@ -1,43 +0,0 @@
-"use strict";
-/** front-desk — the shared tenant front-desk mailbox as a reminder-interrupt module
- *  (docs/reminder-interrupt.md §Registry spec). The module that uses BOTH halves of the
- *  pair: a SessionStart `announce` (discreet count of cold opens + inbound email waiting
- *  at the shared desk) AND a per-turn `reminder` (envelope-only "you've got mail from X"
- *  notice). This is the "announce + reminder often utilize each other" case the registry
- *  was consolidated for — one module, one mailbox, two surfaces.
- *
- *  PURE: the hook owns the count fetch (frontDeskUnread) AND the notice's network + per-
- *  machine dedup (frontDeskNotice), passing both via env; the module only formats the
- *  count and routes the precomputed notice.
- *
- *  Privacy — front-desk is the SHARED tenant mailbox (cold opens + inbound email addressed
- *  to nobody's session), so its count leaks nothing private. This is NOT the v5.6.1
- *  project-wide eavesdrop vector that betrayed a sibling session's session-targeted DMs.
- *  adr: adr/address-grammar.md (2026-06-10), docs/front-desk-switchboard.md §5 */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.frontDeskModule = void 0;
-exports.buildFrontDeskAnnounce = buildFrontDeskAnnounce;
-exports.frontDeskDetect = frontDeskDetect;
-/** SessionStart count hint — the discreet door (count + how to read), never content.
- *  Null at zero so the announce is skipped. */
-function buildFrontDeskAnnounce(unread) {
-    if (!unread || unread <= 0)
-        return null;
-    return `[📬 ${unread} message${unread === 1 ? '' : 's'} at the front desk — \`greprag inbox --front-desk\` to read]`;
-}
-/** Either surface has something → ambient (soft, never a forced-decision directive); else
- *  silent. SessionStart sets frontDeskUnread; per-turn sets frontDeskNotice. */
-function frontDeskDetect(env) {
-    const unread = env.frontDeskUnread ?? 0;
-    return (unread > 0 || env.frontDeskNotice) ? { tier: 'ambient' } : { tier: 'silent' };
-}
-exports.frontDeskModule = {
-    id: 'front-desk',
-    detect: frontDeskDetect,
-    // No SessionStart announce: the bare "N at the front desk" count was the wrong
-    // schema (a number with no model). The inbox-primer teaches the front desk +
-    // `greprag inbox --front-desk` instead. The per-turn envelope notice stays.
-    announce: () => null,
-    reminder: (_d, env) => env.frontDeskNotice ?? null,
-};
-//# sourceMappingURL=frontdesk-reminder.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"frontdesk-reminder.js","sourceRoot":"","sources":["../../src/commands/frontdesk-reminder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;kFAckF;;;AAMlF,wDAGC;AAID,0CAGC;AAZD;+CAC+C;AAC/C,SAAgB,sBAAsB,CAAC,MAAc;IACnD,IAAI,CAAC,MAAM,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,OAAO,MAAM,WAAW,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,8DAA8D,CAAC;AACvH,CAAC;AAED;gFACgF;AAChF,SAAgB,eAAe,CAAC,GAAgB;IAC9C,MAAM,MAAM,GAAG,GAAG,CAAC,eAAe,IAAI,CAAC,CAAC;IACxC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AACxF,CAAC;AAEY,QAAA,eAAe,GAAmB;IAC7C,EAAE,EAAE,YAAY;IAChB,MAAM,EAAE,eAAe;IACvB,+EAA+E;IAC/E,6EAA6E;IAC7E,4EAA4E;IAC5E,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI;IACpB,QAAQ,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI;CACnD,CAAC"}

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

@@ -1,47 +0,0 @@
-/** greprag inbox poll — asyncRewake idle-liveness probe (the deep fix).
- *
- *  THE GAP IT CLOSES: the Monitor watcher delivers + crash-respawns fine, but it
- *  DIES on session reload / `/compact` and needs an AGENT TURN to re-arm — the
- *  structural idle-death gap no version (incl. June 8) ever closed. asyncRewake
- *  breaks that wall: a command hook with `async:true, asyncRewake:true` runs
- *  DETACHED, SURVIVES TURN-END, and on `exit 2` the harness injects its stderr as
- *  a system reminder — WAKING A FULLY IDLE SESSION with no turn. SessionStart
- *  fires on resume/compact (the exact events that kill Monitor), so wiring this as
- *  a SessionStart async+asyncRewake hook RE-ARMS the poll after every reload,
- *  turn-free. adr: adr/monitor-resilience.md (2026-06-19 entry).
- *
- *  HOW IT BEHAVES: a session-scoped SSE long-poll. It stays connected while idle
- *  (that connected wait IS the idle-liveness). On the FIRST inbox message it
- *  writes the message to STDERR and returns POLL_DELIVERED_EXIT (2) → the wake.
- *  On a bounded max-lifetime ceiling, a 4xx, or abort it returns POLL_CLEAN_EXIT
- *  (0) → no wake. A persisted cursor (`~/.greprag/polls/<short>.cursor`) makes
- *  the next poll resume after the last seen id, so a message arriving between one
- *  poll exiting and the next arming is REPLAYED, not lost.
- *
- *  ALONGSIDE MONITOR, not instead of it: it registers in its OWN namespace
- *  (`~/.greprag/polls/`, see poll-registry.ts) so it never gates Monitor arming.
- *  When both are live a message may be delivered twice (Monitor event + poll
- *  wake) — the accepted cost of a parallel safety net until a deliberate cutover.
- *
- *  MUST be wired ASYNC. As a synchronous hook this would block the turn for the
- *  whole ceiling. The arming hooks set `async:true, asyncRewake:true`. */
-/** Exit code that triggers the asyncRewake idle-session wake (stderr → reminder). */
-export declare const POLL_DELIVERED_EXIT = 2;
-/** Exit code for every non-wake terminal (ceiling / gate-skip / no key / 4xx). */
-export declare const POLL_CLEAN_EXIT = 0;
-export interface PollOptions {
-    session: string;
-    apiUrl: string;
-    apiKey: string;
-    maxMs?: number;
-    gate?: boolean;
-    json?: boolean;
-    register?: boolean;
-    signal?: AbortSignal;
-    projectId?: string;
-}
-/** Run one idle-liveness poll. Returns the exit code the hook wrapper exits with:
- *  POLL_DELIVERED_EXIT (2) on a message (→ asyncRewake wake) or POLL_CLEAN_EXIT
- *  (0) on every other terminal. Returns (does NOT call process.exit) so it is
- *  unit-testable; the `greprag-hook poll` wrapper exits with the returned code. */
-export declare function runInboxPoll(opts: PollOptions): Promise<number>;

package/dist/commands/inbox-poll.js

@@ -1,261 +0,0 @@
-"use strict";
-/** greprag inbox poll — asyncRewake idle-liveness probe (the deep fix).
- *
- *  THE GAP IT CLOSES: the Monitor watcher delivers + crash-respawns fine, but it
- *  DIES on session reload / `/compact` and needs an AGENT TURN to re-arm — the
- *  structural idle-death gap no version (incl. June 8) ever closed. asyncRewake
- *  breaks that wall: a command hook with `async:true, asyncRewake:true` runs
- *  DETACHED, SURVIVES TURN-END, and on `exit 2` the harness injects its stderr as
- *  a system reminder — WAKING A FULLY IDLE SESSION with no turn. SessionStart
- *  fires on resume/compact (the exact events that kill Monitor), so wiring this as
- *  a SessionStart async+asyncRewake hook RE-ARMS the poll after every reload,
- *  turn-free. adr: adr/monitor-resilience.md (2026-06-19 entry).
- *
- *  HOW IT BEHAVES: a session-scoped SSE long-poll. It stays connected while idle
- *  (that connected wait IS the idle-liveness). On the FIRST inbox message it
- *  writes the message to STDERR and returns POLL_DELIVERED_EXIT (2) → the wake.
- *  On a bounded max-lifetime ceiling, a 4xx, or abort it returns POLL_CLEAN_EXIT
- *  (0) → no wake. A persisted cursor (`~/.greprag/polls/<short>.cursor`) makes
- *  the next poll resume after the last seen id, so a message arriving between one
- *  poll exiting and the next arming is REPLAYED, not lost.
- *
- *  ALONGSIDE MONITOR, not instead of it: it registers in its OWN namespace
- *  (`~/.greprag/polls/`, see poll-registry.ts) so it never gates Monitor arming.
- *  When both are live a message may be delivered twice (Monitor event + poll
- *  wake) — the accepted cost of a parallel safety net until a deliberate cutover.
- *
- *  MUST be wired ASYNC. As a synchronous hook this would block the turn for the
- *  whole ceiling. The arming hooks set `async:true, asyncRewake:true`. */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.POLL_CLEAN_EXIT = exports.POLL_DELIVERED_EXIT = void 0;
-exports.runInboxPoll = runInboxPoll;
-const inbox_watch_1 = require("./inbox-watch");
-const session_id_1 = require("../session-id");
-const poll_registry_1 = require("./poll-registry");
-// Ingress-trigger bridge, Adapter B (ASYNC half) — an arrived message is the
-// canonical ingress event. On a message wake we run the shared eval over any
-// registered `source:"ingress"` rule (peer-C's auto-reply directive) and append
-// its inject ALONGSIDE the hand-wired peerHumanTag. MIGRATION DISCIPLINE: the
-// hand-wired tag stays until the registered rule is field-green, then it cuts
-// over. Off the hot path → a local cache read is fine. docs/ingress-trigger-bridge.md
-const ingress_trigger_1 = require("./ingress-trigger");
-/** Exit code that triggers the asyncRewake idle-session wake (stderr → reminder). */
-exports.POLL_DELIVERED_EXIT = 2;
-/** Exit code for every non-wake terminal (ceiling / gate-skip / no key / 4xx). */
-exports.POLL_CLEAN_EXIT = 0;
-const POLL_MAX_MS_DEFAULT = Number(process.env.GREPRAG_POLL_MAX_MS) || 20 * 60 * 1000;
-const IDLE_TIMEOUT_MS = 60_000; // 4 missed 15s heartbeats → reconnect
-const IDLE_CHECK_MS = 5_000;
-const RECONNECT_MS = 1_000;
-const LOG_PREFIX = '[greprag inbox poll]';
-/** Format the woken-session reminder. Self-contained + actionable: the agent
- *  reads this as a system reminder, so it carries the sender, the body, and how
- *  to reply / see more. */
-function formatWake(msg, short, json, projectId) {
-    if (json)
-        return `${LOG_PREFIX} ` + JSON.stringify(msg);
-    const sender = msg.from.email || `${msg.from.tenant}@greprag.com`;
-    const replyTo = msg.references?.reply_to || sender;
-    const body = msg.body.length > 600 ? msg.body.slice(0, 600) + '…' : msg.body;
-    const fromSess = (0, session_id_1.truncateSessionId)(msg.from.session_id ?? null);
-    const origin = fromSess ? ` (session ${fromSess})` : '';
-    // Classification tag (server-authoritative): from.session_id SET ⇒ PEER agent
-    // session → reply directly, no human confirm; null ⇒ HUMAN (cold-open / email)
-    // → summarize + confirm. Reply, NOT obey — peer-requested destructive actions
-    // still pass the normal gates. adr: adr/monitor-resilience.md
-    const tag = (0, session_id_1.peerHumanTag)(msg.from.session_id);
-    // Adapter B: append any registered ingress directive (best-effort, fail-open).
-    // Sits ALONGSIDE the hand-wired tag during migration; a registered peer-C rule
-    // can refine/replace it without a code change. docs/ingress-trigger-bridge.md
-    let ingress = '';
-    if (projectId) {
-        try {
-            const res = (0, ingress_trigger_1.runIngressGate)((0, ingress_trigger_1.triggerFromMessage)(msg), projectId);
-            if (res.directive)
-                ingress = `${res.directive}\n`;
-        }
-        catch { /* ingress eval is best-effort — never block the wake */ }
-    }
-    return (`${LOG_PREFIX} 📬 inbox message for ${short} from ${sender}${origin}:\n`
-        + `${tag}\n`
-        + ingress
-        + `${body}\n`
-        + `— reply now (even mid-task): greprag send "…" --to ${replyTo} --from-session ${short}`
-        + `  ·  see all: greprag inbox --session ${short}`);
-}
-function buildPollUrl(apiUrl, session, since) {
-    const u = new URL(apiUrl.replace(/\/+$/, '') + '/v1/inbox/stream');
-    u.searchParams.set('session', session);
-    if (since)
-        u.searchParams.set('since', since);
-    return u.toString();
-}
-function sleep(ms, signal) {
-    return new Promise((resolve) => {
-        const t = setTimeout(resolve, ms);
-        const onAbort = () => { clearTimeout(t); resolve(); };
-        if (signal.aborted) {
-            onAbort();
-            return;
-        }
-        signal.addEventListener('abort', onAbort, { once: true });
-    });
-}
-/** Read the SSE stream until the FIRST message (→ write stderr, persist cursor,
- *  delivered:true), the stream ends/idles (delivered:false), a 4xx (fatal:true),
- *  or abort. Composes the outer signal with an idle-timeout so a half-open socket
- *  can't hang past IDLE_TIMEOUT_MS. */
-async function readUntilMessage(url, apiKey, outer, json, session, initialId, projectId) {
-    const inner = new AbortController();
-    const onOuter = () => inner.abort();
-    if (outer.aborted)
-        inner.abort();
-    else
-        outer.addEventListener('abort', onOuter, { once: true });
-    let lastByteAt = Date.now();
-    const idleTimer = setInterval(() => {
-        if (Date.now() - lastByteAt > IDLE_TIMEOUT_MS)
-            inner.abort();
-    }, IDLE_CHECK_MS);
-    let lastId = initialId;
-    try {
-        const res = await fetch(url, {
-            headers: { Authorization: `Bearer ${apiKey}`, Accept: 'text/event-stream' },
-            signal: inner.signal,
-        });
-        if (!res.ok) {
-            const text = await res.text().catch(() => '');
-            if (res.status >= 400 && res.status < 500) {
-                process.stderr.write(`${LOG_PREFIX} HTTP ${res.status}: ${text.slice(0, 160)}\n`);
-                return { delivered: false, lastId, fatal: true };
-            }
-            throw new Error(`HTTP ${res.status}`);
-        }
-        if (!res.body)
-            throw new Error('no response body');
-        const reader = res.body.getReader();
-        const decoder = new TextDecoder();
-        let buffer = '';
-        try {
-            while (true) {
-                const { done, value } = await reader.read();
-                if (done)
-                    return { delivered: false, lastId };
-                lastByteAt = Date.now();
-                buffer += decoder.decode(value, { stream: true });
-                buffer = buffer.replace(/\r\n/g, '\n');
-                let sep;
-                while ((sep = buffer.indexOf('\n\n')) >= 0) {
-                    const block = buffer.slice(0, sep);
-                    buffer = buffer.slice(sep + 2);
-                    const ev = (0, inbox_watch_1.parseEventBlock)(block);
-                    if (!ev)
-                        continue;
-                    if (ev.id)
-                        lastId = ev.id;
-                    if (ev.event !== 'message')
-                        continue; // ignore open / replay-complete / error markers
-                    let msg;
-                    try {
-                        msg = JSON.parse(ev.data);
-                    }
-                    catch {
-                        continue;
-                    }
-                    // FIRST real message → wake. Persist the cursor BEFORE we exit so the
-                    // next poll resumes AFTER this id (no re-deliver); the agent reads any
-                    // burst remainder via `greprag inbox`, which the next poll also catches.
-                    if (ev.id)
-                        (0, poll_registry_1.writePollCursor)(session, ev.id);
-                    process.stderr.write(formatWake(msg, session, json, projectId) + '\n');
-                    return { delivered: true, lastId };
-                }
-            }
-        }
-        finally {
-            try {
-                reader.releaseLock();
-            }
-            catch { /* already released */ }
-        }
-    }
-    finally {
-        clearInterval(idleTimer);
-        outer.removeEventListener('abort', onOuter);
-    }
-}
-/** Run one idle-liveness poll. Returns the exit code the hook wrapper exits with:
- *  POLL_DELIVERED_EXIT (2) on a message (→ asyncRewake wake) or POLL_CLEAN_EXIT
- *  (0) on every other terminal. Returns (does NOT call process.exit) so it is
- *  unit-testable; the `greprag-hook poll` wrapper exits with the returned code. */
-async function runInboxPoll(opts) {
-    if (!opts.apiKey || !opts.session)
-        return exports.POLL_CLEAN_EXIT; // unconfigured → silent clean
-    if (opts.gate && (0, poll_registry_1.isPollArmed)(opts.session))
-        return exports.POLL_CLEAN_EXIT; // re-arm gate: one live poll
-    const register = opts.register !== false;
-    if (register)
-        (0, poll_registry_1.registerPoll)(opts.session, process.pid);
-    const maxMs = opts.maxMs ?? POLL_MAX_MS_DEFAULT;
-    const ac = new AbortController();
-    const ceiling = setTimeout(() => ac.abort(), maxMs);
-    if (typeof ceiling.unref === 'function')
-        ceiling.unref();
-    const onSignal = () => ac.abort();
-    process.on('SIGINT', onSignal);
-    process.on('SIGTERM', onSignal);
-    if (opts.signal) {
-        if (opts.signal.aborted)
-            ac.abort();
-        else
-            opts.signal.addEventListener('abort', onSignal, { once: true });
-    }
-    let code = exports.POLL_CLEAN_EXIT;
-    try {
-        let cursor = (0, poll_registry_1.readPollCursor)(opts.session);
-        while (!ac.signal.aborted) {
-            const url = buildPollUrl(opts.apiUrl, opts.session, cursor);
-            try {
-                const r = await readUntilMessage(url, opts.apiKey, ac.signal, !!opts.json, opts.session, cursor, opts.projectId);
-                if (r.delivered) {
-                    code = exports.POLL_DELIVERED_EXIT;
-                    break;
-                }
-                if (r.fatal) {
-                    // 4xx WITH a cursor = the stored `since` points to a pruned/deleted
-                    // message the server now rejects. Drop the cursor and retry live-tail
-                    // ONCE so a dead cursor can't permanently wedge this session's delivery.
-                    // A 4xx with NO cursor is a genuine fatal (bad key/session) → clean exit.
-                    if (cursor) {
-                        (0, poll_registry_1.clearPollCursor)(opts.session);
-                        cursor = null;
-                        if (ac.signal.aborted)
-                            break;
-                        await sleep(RECONNECT_MS, ac.signal);
-                        continue;
-                    }
-                    code = exports.POLL_CLEAN_EXIT;
-                    break; // genuine 4xx → clean, do not re-arm-spin
-                }
-                if (r.lastId)
-                    cursor = r.lastId;
-            }
-            catch (err) {
-                const msg = err?.message || String(err);
-                process.stderr.write(`${LOG_PREFIX} disconnect: ${msg} — reconnecting\n`);
-            }
-            if (ac.signal.aborted)
-                break;
-            await sleep(RECONNECT_MS, ac.signal);
-        }
-    }
-    finally {
-        clearTimeout(ceiling);
-        process.off('SIGINT', onSignal);
-        process.off('SIGTERM', onSignal);
-        if (register)
-            (0, poll_registry_1.deregisterPoll)(opts.session, process.pid);
-    }
-    return code;
-}
-//# sourceMappingURL=inbox-poll.js.map

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

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

package/dist/commands/inbox-spool.d.ts

@@ -1,27 +0,0 @@
-/** Local inbox spool — the delivery channel between the machine's desk-line and
- *  a session's watcher.
- *
- *  The delivery-cutover counterpart to the live-list relay: instead of each
- *  session's watcher holding a cloud SSE socket to receive inbound (the path that
- *  keeps the stale InboxDO whiteboard alive), the desk-line APPENDS each inbound
- *  message to a per-session spool file here, and the watcher TAILS it locally. No
- *  NAT crossing on the delivery hot path, no per-session cloud socket — the
- *  watcher reads a file the desk-line wrote.
- *
- *  Format: newline-delimited JSON (one message per line) at
- *  ~/.greprag/inbox/<short>.ndjson. Bounded to the last SPOOL_MAX lines so a
- *  long-lived session can't grow it without bound; the watcher dedups by message
- *  id, so the bound never drops an unseen message under normal cadence.
- *
- *  adr: adr/desk-line-relay.md */
-export declare function spoolPath(short: string): string;
-/** Append a message to a session's spool (desk-line write side). Trims to the
- *  last SPOOL_MAX lines. Best-effort: a failed write is logged by the caller's
- *  catch, never throws into the relay loop. */
-export declare function appendToSpool(short: string, message: unknown): void;
-/** Tail a session's spool, invoking `onMessage` for each appended JSON line.
- *  Polls by byte offset (survives the file not existing yet). Fully
- *  error-isolated: every parse/read failure is swallowed so a malformed spool
- *  line can never crash the watcher's live SSE path. Returns when `signal`
- *  aborts. adr: adr/desk-line-relay.md */
-export declare function tailSpool(short: string, onMessage: (msg: unknown) => void, signal: AbortSignal): Promise<void>;

package/dist/commands/inbox-spool.js

@@ -1,151 +0,0 @@
-"use strict";
-/** Local inbox spool — the delivery channel between the machine's desk-line and
- *  a session's watcher.
- *
- *  The delivery-cutover counterpart to the live-list relay: instead of each
- *  session's watcher holding a cloud SSE socket to receive inbound (the path that
- *  keeps the stale InboxDO whiteboard alive), the desk-line APPENDS each inbound
- *  message to a per-session spool file here, and the watcher TAILS it locally. No
- *  NAT crossing on the delivery hot path, no per-session cloud socket — the
- *  watcher reads a file the desk-line wrote.
- *
- *  Format: newline-delimited JSON (one message per line) at
- *  ~/.greprag/inbox/<short>.ndjson. Bounded to the last SPOOL_MAX lines so a
- *  long-lived session can't grow it without bound; the watcher dedups by message
- *  id, so the bound never drops an unseen message under normal cadence.
- *
- *  adr: adr/desk-line-relay.md */
-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.spoolPath = spoolPath;
-exports.appendToSpool = appendToSpool;
-exports.tailSpool = tailSpool;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const SPOOL_DIRNAME = 'inbox';
-const SPOOL_MAX = 200; // keep the last N messages per session
-const TAIL_POLL_MS = 400; // how often the watcher checks for appends
-function grepragHome() {
-    const home = process.env.HOME || process.env.USERPROFILE || '';
-    return path.join(home, '.greprag');
-}
-function spoolDir() { return path.join(grepragHome(), SPOOL_DIRNAME); }
-function spoolPath(short) { return path.join(spoolDir(), `${short}.ndjson`); }
-/** Append a message to a session's spool (desk-line write side). Trims to the
- *  last SPOOL_MAX lines. Best-effort: a failed write is logged by the caller's
- *  catch, never throws into the relay loop. */
-function appendToSpool(short, message) {
-    const dir = spoolDir();
-    fs.mkdirSync(dir, { recursive: true });
-    const file = spoolPath(short);
-    fs.appendFileSync(file, JSON.stringify(message) + '\n');
-    // Trim if it grew past the cap (cheap: only re-read when the file is large).
-    try {
-        const stat = fs.statSync(file);
-        if (stat.size > SPOOL_MAX * 4096) {
-            const lines = fs.readFileSync(file, 'utf-8').split('\n').filter(Boolean);
-            if (lines.length > SPOOL_MAX) {
-                fs.writeFileSync(file, lines.slice(-SPOOL_MAX).join('\n') + '\n');
-            }
-        }
-    }
-    catch { /* trim is best-effort */ }
-}
-/** Tail a session's spool, invoking `onMessage` for each appended JSON line.
- *  Polls by byte offset (survives the file not existing yet). Fully
- *  error-isolated: every parse/read failure is swallowed so a malformed spool
- *  line can never crash the watcher's live SSE path. Returns when `signal`
- *  aborts. adr: adr/desk-line-relay.md */
-async function tailSpool(short, onMessage, signal) {
-    const file = spoolPath(short);
-    // Start at the current end of file — the desk-line only writes NEW inbound, and
-    // the watcher already got history via the SSE replay / `greprag inbox`. (When
-    // the SSE path is eventually removed, switch this to 0 to replay the spool.)
-    let offset = 0;
-    try {
-        offset = fs.statSync(file).size;
-    }
-    catch {
-        offset = 0;
-    }
-    let carry = '';
-    while (!signal.aborted) {
-        try {
-            let size = 0;
-            try {
-                size = fs.statSync(file).size;
-            }
-            catch {
-                size = 0;
-            }
-            if (size < offset) {
-                offset = 0;
-                carry = '';
-            } // file was rotated/trimmed
-            if (size > offset) {
-                const fd = fs.openSync(file, 'r');
-                try {
-                    const buf = Buffer.alloc(size - offset);
-                    fs.readSync(fd, buf, 0, buf.length, offset);
-                    offset = size;
-                    carry += buf.toString('utf-8');
-                    let nl;
-                    while ((nl = carry.indexOf('\n')) >= 0) {
-                        const line = carry.slice(0, nl).trim();
-                        carry = carry.slice(nl + 1);
-                        if (!line)
-                            continue;
-                        try {
-                            onMessage(JSON.parse(line));
-                        }
-                        catch { /* skip bad line */ }
-                    }
-                }
-                finally {
-                    fs.closeSync(fd);
-                }
-            }
-        }
-        catch { /* read cycle best-effort — never throw into the watcher */ }
-        await sleep(TAIL_POLL_MS, signal);
-    }
-}
-function sleep(ms, signal) {
-    return new Promise(resolve => {
-        const t = setTimeout(resolve, ms);
-        signal.addEventListener('abort', () => { clearTimeout(t); resolve(); }, { once: true });
-    });
-}
-//# sourceMappingURL=inbox-spool.js.map

package/dist/commands/inbox-spool.js.map

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