greprag 5.32.0 → 5.34.0

package/dist/commands/corpus/refresh.js

@@ -11,6 +11,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.refreshCmd = refreshCmd;
 exports.sourcesCmd = sourcesCmd;
+exports.auditCmd = auditCmd;
 const client_1 = require("./client");
 async function refreshCmd(args) {
     const cfg = (0, client_1.getConfig)();
@@ -89,6 +90,65 @@ async function sourcesCmd(args) {
         console.log(`Manual policy — re-check on demand: greprag corpus refresh ${JSON.stringify(store.name)}\n`);
     }
 }
+async function auditCmd(args) {
+    const cfg = (0, client_1.getConfig)();
+    if (!cfg.apiKey)
+        (0, client_1.abortNotConfigured)();
+    const ref = args[0];
+    if (!ref) {
+        console.error('Usage: greprag corpus audit <storeIdOrName> [--limit N]\n  Show immutable evidence from recent source refreshes.');
+        process.exit(1);
+    }
+    const store = await (0, client_1.resolveStore)(ref, cfg.apiUrl, cfg.apiKey);
+    const limit = numFlag(args, '--limit', 3);
+    const res = await (0, client_1.apiGet)(`${cfg.apiUrl}/v1/stores/${store.id}/refresh/audits?limit=${limit}`, cfg.apiKey);
+    if (!res.ok)
+        throw new Error(res.error || 'audit failed');
+    console.log(`\n${store.name} · refresh audits`);
+    const audits = res.audits || [];
+    if (audits.length === 0) {
+        console.log('  No refresh audits recorded yet. Run a refresh after deploying migration 055.');
+        return;
+    }
+    for (const a of audits) {
+        const fresh = a.details?.freshNodes || [];
+        const removed = a.details?.removedNodes || [];
+        console.log(`\n  ${a.createdAt} · ${a.status}`);
+        if (a.changeSignal)
+            console.log(`    Signal:    ${a.changeSignal}`);
+        console.log(`    Nodes:     ${a.oldNodeCount} → ${a.newNodeCount} (${a.preservedCount} preserved, ${a.freshCount} fresh, ${a.removedCount} removed)`);
+        console.log(`    Hashes:    old ${shortHash(a.oldContentHash)} → new ${shortHash(a.newContentHash)}`);
+        if (a.sourceContentHash)
+            console.log(`    Source:    ${shortHash(a.sourceContentHash)}`);
+        console.log(`    Enrich:    ${a.enriched ? `${a.enrichmentQueued} queued` : 'raw corpus; skipped'}`);
+        if (a.reason)
+            console.log(`    Reason:    ${a.reason}`);
+        renderNodes('Fresh', fresh);
+        renderNodes('Removed', removed);
+    }
+    console.log('');
+}
+function numFlag(args, flag, fallback) {
+    const idx = args.indexOf(flag);
+    if (idx < 0 || idx + 1 >= args.length)
+        return fallback;
+    const n = Number(args[idx + 1]);
+    return Number.isFinite(n) && n > 0 ? Math.floor(n) : fallback;
+}
+function shortHash(h) {
+    return h ? h.slice(0, 12) : '(none)';
+}
+function renderNodes(label, nodes) {
+    if (nodes.length === 0)
+        return;
+    const shown = nodes.slice(0, 5);
+    console.log(`    ${label}:`);
+    for (const n of shown) {
+        console.log(`      ${n.nodeId} pos=${n.position} ${n.blockType} ${shortHash(n.contentHash)} ${JSON.stringify(n.preview)}`);
+    }
+    if (nodes.length > shown.length)
+        console.log(`      … ${nodes.length - shown.length} more`);
+}
 /** Render an ISO timestamp as "ISO (Nh ago)"; em-dash when never. Uses only
  *  Date math available in the CLI runtime (no extra deps). */
 function fmtTime(iso) {

package/dist/commands/corpus/refresh.js.map

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

package/dist/commands/desk-line.d.ts

@@ -0,0 +1,36 @@
+/** greprag desk — the machine's desk-line.
+ *
+ *  One process per machine that holds a line open to the cloud and answers, from
+ *  LOCAL ground truth, the only questions the cloud can't answer for itself:
+ *  "what sessions are truly live?" and (later) "deliver this to session X".
+ *
+ *  Why it exists: the operator's machine is behind NAT — the cloud can't dial it.
+ *  So the machine dials out and long-polls GET /v1/desk/poll; the cloud parks the
+ *  request until it has a job, then the desk-line answers and POSTs the result to
+ *  /v1/desk/reply. The cloud holds NO session registry; a machine that's down
+ *  simply stops polling, and that silence is the offline signal. This replaces
+ *  the stale cloud whiteboard (InboxDO /attached) as the source of the
+ *  live-session list. adr: adr/desk-line-relay.md, docs/registry-freshness-design.md
+ *
+ *  Singleton per machine via a pidfile lock (~/.greprag/desk-line.json) — a second
+ *  `desk run` exits if a live one already holds the lock.
+ */
+interface DeskLock {
+    pid: number;
+    startedAt: number;
+}
+/** Is a live desk-line already running on this machine? */
+export declare function deskLineRunning(): DeskLock | null;
+/** The long-poll loop. Runs until the AbortSignal fires (or forever). */
+export declare function runDeskLine(opts?: {
+    signal?: AbortSignal;
+    once?: boolean;
+}): Promise<void>;
+/** Idempotently ensure a desk-line is running, spawning a detached one if not.
+ *  Safe to call on every SessionStart — the singleton lock makes extra calls a
+ *  no-op. Returns true if a desk-line is (now) running. */
+export declare function ensureDeskLine(): boolean;
+/** `greprag desk status` — is a desk-line up, and what's the local truth it would
+ *  report right now? */
+export declare function deskLineStatus(): void;
+export {};

package/dist/commands/desk-line.js

@@ -0,0 +1,230 @@
+"use strict";
+/** greprag desk — the machine's desk-line.
+ *
+ *  One process per machine that holds a line open to the cloud and answers, from
+ *  LOCAL ground truth, the only questions the cloud can't answer for itself:
+ *  "what sessions are truly live?" and (later) "deliver this to session X".
+ *
+ *  Why it exists: the operator's machine is behind NAT — the cloud can't dial it.
+ *  So the machine dials out and long-polls GET /v1/desk/poll; the cloud parks the
+ *  request until it has a job, then the desk-line answers and POSTs the result to
+ *  /v1/desk/reply. The cloud holds NO session registry; a machine that's down
+ *  simply stops polling, and that silence is the offline signal. This replaces
+ *  the stale cloud whiteboard (InboxDO /attached) as the source of the
+ *  live-session list. adr: adr/desk-line-relay.md, docs/registry-freshness-design.md
+ *
+ *  Singleton per machine via a pidfile lock (~/.greprag/desk-line.json) — a second
+ *  `desk run` exits if a live one already holds the lock.
+ */
+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.deskLineRunning = deskLineRunning;
+exports.runDeskLine = runDeskLine;
+exports.ensureDeskLine = ensureDeskLine;
+exports.deskLineStatus = deskLineStatus;
+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 API_URL_DEFAULT = 'https://api.greprag.com';
+const LOG = '[greprag desk]';
+const BACKOFF_INITIAL_MS = 1_000;
+const BACKOFF_MAX_MS = 30_000;
+function grepragHome() {
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    return path.join(home, '.greprag');
+}
+function lockPath() { return path.join(grepragHome(), 'desk-line.json'); }
+function pidAlive(pid) {
+    if (!Number.isFinite(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        return e?.code === 'EPERM';
+    }
+}
+/** Is a live desk-line already running on this machine? */
+function deskLineRunning() {
+    try {
+        const rec = JSON.parse(fs.readFileSync(lockPath(), 'utf-8'));
+        if (rec && typeof rec.pid === 'number' && pidAlive(rec.pid))
+            return rec;
+        fs.rmSync(lockPath(), { force: true }); // stale lock → sweep
+    }
+    catch { /* no lock */ }
+    return null;
+}
+function writeLock() {
+    try {
+        fs.mkdirSync(grepragHome(), { recursive: true });
+        fs.writeFileSync(lockPath(), JSON.stringify({ pid: process.pid, startedAt: Date.now() }));
+    }
+    catch { /* best-effort */ }
+}
+function removeLock() { try {
+    fs.rmSync(lockPath(), { force: true });
+}
+catch { /* noop */ } }
+function getConfig() {
+    return {
+        apiUrl: process.env.GREPRAG_API_URL || API_URL_DEFAULT,
+        apiKey: process.env.GREPRAG_API_KEY || '',
+    };
+}
+/** Compute the answer to a job from local ground truth. */
+function answerJob(job) {
+    if (job.kind === 'list') {
+        const live = (0, watcher_registry_1.listLocalLiveWatchers)();
+        return {
+            watchers: live.map(w => ({
+                session_id: w.short, pid: w.pid, owner_pid: w.ownerPid ?? null, started_at: w.startedAt,
+            })),
+        };
+    }
+    // 'deliver' is reserved for the delivery-cutover phase — until then, inbound
+    // still flows via the existing cloud broadcast path, so the desk-line declines.
+    return { ok: false, reason: 'deliver-not-implemented' };
+}
+/** The long-poll loop. Runs until the AbortSignal fires (or forever). */
+async function runDeskLine(opts = {}) {
+    const { apiUrl, apiKey } = getConfig();
+    if (!apiKey) {
+        console.error(`${LOG} not configured (GREPRAG_API_KEY unset). Run: greprag init`);
+        process.exitCode = 64;
+        return;
+    }
+    const existing = deskLineRunning();
+    if (existing && existing.pid !== process.pid) {
+        console.error(`${LOG} already running (pid ${existing.pid}) — exiting (singleton).`);
+        return;
+    }
+    writeLock();
+    const cleanup = () => { removeLock(); };
+    process.on('exit', cleanup);
+    for (const sig of ['SIGINT', 'SIGTERM']) {
+        process.on(sig, () => { cleanup(); process.exit(0); });
+    }
+    console.error(`${LOG} up — holding the line to ${apiUrl} (pid ${process.pid})`);
+    let backoff = BACKOFF_INITIAL_MS;
+    while (!opts.signal?.aborted) {
+        try {
+            const res = await fetch(`${apiUrl}/v1/desk/poll`, {
+                headers: { Authorization: `Bearer ${apiKey}` },
+                signal: opts.signal,
+            });
+            backoff = BACKOFF_INITIAL_MS; // a successful poll resets backoff
+            if (res.status === 204) {
+                if (opts.once)
+                    break;
+                continue;
+            } // idle hold elapsed → re-poll
+            if (!res.ok) {
+                await sleep(backoff, opts.signal);
+                backoff = Math.min(backoff * 2, BACKOFF_MAX_MS);
+                continue;
+            }
+            const { job } = (await res.json());
+            if (!job) {
+                if (opts.once)
+                    break;
+                continue;
+            }
+            const answer = answerJob(job);
+            await fetch(`${apiUrl}/v1/desk/reply`, {
+                method: 'POST',
+                headers: { Authorization: `Bearer ${apiKey}`, 'content-type': 'application/json' },
+                body: JSON.stringify({ jobId: job.id, answer }),
+                signal: opts.signal,
+            }).catch(() => { });
+            console.error(`${LOG} answered ${job.kind} ${job.id}`);
+            if (opts.once)
+                break;
+        }
+        catch (e) {
+            if (opts.signal?.aborted)
+                break;
+            console.error(`${LOG} poll error: ${e?.message ?? e} — backing off ${backoff}ms`);
+            await sleep(backoff, opts.signal);
+            backoff = Math.min(backoff * 2, BACKOFF_MAX_MS);
+        }
+    }
+    cleanup();
+}
+function sleep(ms, signal) {
+    return new Promise(resolve => {
+        const t = setTimeout(resolve, ms);
+        signal?.addEventListener('abort', () => { clearTimeout(t); resolve(); }, { once: true });
+    });
+}
+/** Idempotently ensure a desk-line is running, spawning a detached one if not.
+ *  Safe to call on every SessionStart — the singleton lock makes extra calls a
+ *  no-op. Returns true if a desk-line is (now) running. */
+function ensureDeskLine() {
+    if (deskLineRunning())
+        return true;
+    try {
+        const child = (0, child_process_1.spawn)(process.execPath, [path.join(__dirname, '..', 'index.js'), 'desk', 'run'], {
+            detached: true,
+            stdio: 'ignore',
+            env: process.env,
+        });
+        child.unref();
+        return true;
+    }
+    catch (e) {
+        console.error(`${LOG} failed to spawn desk-line: ${e?.message ?? e}`);
+        return false;
+    }
+}
+/** `greprag desk status` — is a desk-line up, and what's the local truth it would
+ *  report right now? */
+function deskLineStatus() {
+    const lock = deskLineRunning();
+    if (lock) {
+        const ageMs = Date.now() - (lock.startedAt || Date.now());
+        console.log(`desk-line: UP (pid ${lock.pid}, ${Math.floor(ageMs / 1000)}s)`);
+    }
+    else {
+        console.log('desk-line: DOWN');
+    }
+    const live = (0, watcher_registry_1.listLocalLiveWatchers)();
+    console.log(`local live sessions: ${live.length}`);
+    for (const w of live)
+        console.log(`  ${w.short}  (pid ${w.pid})`);
+}
+//# sourceMappingURL=desk-line.js.map

package/dist/commands/desk-line.js.map

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

package/dist/commands/init.js

@@ -428,15 +428,55 @@ async function runOpenCodeInit(opts) {
         console.warn('  Inbox registration skipped (network)');
     }
     // Step 7: Install plugin to ~/.config/opencode/plugins/greprag-memory.js
+    // adr: adr/opencode-monitor-relay.md (2026-06-06 (f))
+    // The helpers file does NOT live in the opencode plugins dir — opencode
+    // auto-loads every `.js` file in `~/.config/opencode/plugins/` as a
+    // plugin, and the helpers file (a barrel of named function exports with
+    // `__esModule: true` tsc marker) would trip the same `getLegacyPlugins`
+    // shape check the main file used to. Helpers go to `~/.greprag/` and the
+    // main plugin requires them by absolute path. Only the main file is
+    // registered with opencode.
+    //
+    // The main plugin source uses `export = { id, server }` which tsc
+    // compiles to `module.exports = { id, server }` with no `__esModule: true`
+    // marker — so the legacy plugin loader's `Object.values(mod)` sees
+    // exactly one entry and registers the plugin. See ADR entry 2026-06-06
+    // (f) for the full diagnosis.
     const pluginDir = path.join(os.homedir(), '.config', 'opencode', 'plugins');
-    const pluginDest = path.join(pluginDir, 'greprag-memory.js');
-    const pluginSrc = path.join(__dirname, '../opencode-plugin.js');
+    const grepragHome = path.join(os.homedir(), '.greprag');
+    const pluginMain = path.join(pluginDir, 'greprag-memory.js');
+    const helpersDest = path.join(grepragHome, 'opencode-plugin-helpers.js');
+    const pluginMainSrc = path.join(__dirname, '../opencode-plugin.js');
+    const helpersSrc = path.join(__dirname, '../opencode-plugin-helpers.js');
     let pluginInstalled = false;
-    if (fs.existsSync(pluginSrc)) {
+    if (fs.existsSync(pluginMainSrc)) {
         if (!fs.existsSync(pluginDir))
             fs.mkdirSync(pluginDir, { recursive: true });
-        fs.copyFileSync(pluginSrc, pluginDest);
-        console.log(`  Plugin installed: ${pluginDest}`);
+        if (!fs.existsSync(grepragHome))
+            fs.mkdirSync(grepragHome, { recursive: true });
+        if (!fs.existsSync(helpersSrc)) {
+            console.warn(`  Helpers artifact missing: ${helpersSrc} — run \`npm run build\` in packages/cli and retry`);
+        }
+        else {
+            fs.copyFileSync(helpersSrc, helpersDest);
+        }
+        fs.copyFileSync(pluginMainSrc, pluginMain);
+        // Stale cleanup: prior deploys (commit 5d1a384, 2026-06-06) installed
+        // the helpers as `opencode-plugin-helpers.js` INSIDE the plugins dir.
+        // opencode auto-loads every `.js` there as a plugin, and the helpers
+        // file is a barrel of function exports with `__esModule: true` — it
+        // trips the loader's shape check and logs "Plugin export is not a
+        // function". It's stale now that the helpers live in ~/.greprag/.
+        const staleHelpers = path.join(pluginDir, 'opencode-plugin-helpers.js');
+        if (fs.existsSync(staleHelpers)) {
+            try {
+                fs.unlinkSync(staleHelpers);
+                console.log(`  Removed stale plugin: ${staleHelpers}`);
+            }
+            catch { }
+        }
+        console.log(`  Plugin installed: ${pluginMain}`);
+        console.log(`  Helpers installed: ${helpersDest}`);
         pluginInstalled = true;
     }
     else {
@@ -448,7 +488,7 @@ async function runOpenCodeInit(opts) {
         console.log(`    - ${c}`);
     console.log(`    - Project anchor: ${anchor.anchorPath} (source: ${anchor.source})`);
     if (pluginInstalled)
-        console.log(`    - Plugin: ${pluginDest}`);
+        console.log(`    - Plugin: ${pluginMain}`);
     console.log(`    - Shared env: ${getGrepragEnvPath()}`);
     console.log('  OpenCode will load the plugin automatically on next session start.');
     console.log('  The /greprag skill is also available for on-demand briefings.\n');
@@ -547,7 +587,7 @@ async function runCodexInit(opts) {
     }
     console.log(`\n  Codex hooks file: ${hooksPath}`);
     console.log(`  Project anchor: ${anchor.anchorPath}`);
-    console.log('  Start a fresh Codex session, then open Settings -> Settings -> Hooks and trust the 6 GrepRAG hook definitions.');
+    console.log('  Start a fresh Codex session, then open Settings -> Settings -> Hooks and trust the 8 GrepRAG hook definitions.');
     console.log('  For live inbox push, run: greprag codex startup install');
     console.log('  Memory hooks will activate on your next Codex session.\n');
 }
@@ -994,6 +1034,32 @@ function applyCodexHooks(config) {
     else {
         changes.push('Codex PostToolUse inbox hook already configured (skipped)');
     }
+    const permissionHook = {
+        matcher: '',
+        hooks: [commandHook('codex-permission-context', 3, 'Loading GrepRAG approval context')],
+    };
+    if (!hasGrepragHook(config.hooks.PermissionRequest, 'codex-permission-context')) {
+        if (!config.hooks.PermissionRequest)
+            config.hooks.PermissionRequest = [];
+        config.hooks.PermissionRequest.push(permissionHook);
+        changes.push('Added Codex PermissionRequest hook (approval context)');
+    }
+    else {
+        changes.push('Codex PermissionRequest context hook already configured (skipped)');
+    }
+    const subagentStartHook = {
+        matcher: '',
+        hooks: [commandHook('codex-subagent-start', 3, 'Recording GrepRAG subagent metadata')],
+    };
+    if (!hasGrepragHook(config.hooks.SubagentStart, 'codex-subagent-start')) {
+        if (!config.hooks.SubagentStart)
+            config.hooks.SubagentStart = [];
+        config.hooks.SubagentStart.push(subagentStartHook);
+        changes.push('Added Codex SubagentStart hook (subagent metadata)');
+    }
+    else {
+        changes.push('Codex SubagentStart metadata hook already configured (skipped)');
+    }
     const storeHook = {
         matcher: '',
         hooks: [commandHook('codex-store', 10, 'Storing GrepRAG turn')],
@@ -1034,6 +1100,8 @@ function normalizeCodexHookCommands(hooks) {
         'session-id': { timeout: 3, statusMessage: 'Loading GrepRAG session id' },
         'codex-notify': { timeout: 5, statusMessage: 'Checking GrepRAG inbox' },
         'codex-inbox': { timeout: 5, statusMessage: 'Checking GrepRAG inbox' },
+        'codex-permission-context': { timeout: 3, statusMessage: 'Loading GrepRAG approval context' },
+        'codex-subagent-start': { timeout: 3, statusMessage: 'Recording GrepRAG subagent metadata' },
         'codex-store': { timeout: 10, statusMessage: 'Storing GrepRAG turn' },
     };
     let count = 0;