greprag 5.72.4 → 5.73.1

package/dist/commands/doc.js

@@ -0,0 +1,286 @@
+"use strict";
+/** greprag doc — mirror/search/read project Markdown through the CLI.
+ *
+ * This is the state-doc sibling of `greprag load`: skills/doctrine load from
+ * GrepRAG, while project docs can be mirrored there and read back by path.
+ */
+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.runDoc = runDoc;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const proc_1 = require("../proc");
+const project_anchor_1 = require("../project-anchor");
+const docptr_refs_1 = require("../docptr-refs");
+const API_URL_DEFAULT = 'https://api.greprag.com';
+const MAX_DOC_CHARS = 600_000;
+const HELP = `greprag doc — mirrored project Markdown docs
+
+USAGE
+  greprag doc mirror sync        Mirror tracked eligible .md files for this repo
+  greprag doc list [--json]      List mirrored docs for this project
+  greprag doc search "<query>"   Search mirrored docs
+    [--limit N=5] [--json]
+  greprag doc read <path>        Print one mirrored doc exactly
+    [--out <file>]`;
+function getConfig() {
+    return {
+        apiUrl: process.env.GREPRAG_API_URL || API_URL_DEFAULT,
+        apiKey: process.env.GREPRAG_API_KEY || '',
+    };
+}
+function normalizeRel(input) {
+    return (input || '').replace(/\\/g, '/').replace(/^\.\//, '').replace(/^\/+/, '').trim();
+}
+/** Mirror of docptr's pre-filter: .md only, no dot/build/vendor dirs, no harness
+ *  instruction followers. */
+function isDocPathEligible(relPath) {
+    const p = normalizeRel(relPath);
+    if (!p.toLowerCase().endsWith('.md'))
+        return false;
+    const segments = p.split('/');
+    const base = segments[segments.length - 1];
+    if (base === 'CLAUDE.md' || base === 'MEMORY.md')
+        return false;
+    for (const seg of segments.slice(0, -1)) {
+        if (seg.startsWith('.'))
+            return false;
+        if (seg === 'node_modules' || seg === 'dist' || seg === 'build' || seg === 'vendor')
+            return false;
+    }
+    return true;
+}
+function titleFromMarkdown(markdown, relPath) {
+    const heading = (markdown || '').split(/\r?\n/).find((line) => /^#{1,3}\s+\S/.test(line));
+    if (heading)
+        return heading.replace(/^#{1,3}\s+/, '').trim().slice(0, 140);
+    const base = normalizeRel(relPath).split('/').pop() || relPath;
+    return base.replace(/\.md$/i, '').replace(/[-_]+/g, ' ').trim() || relPath;
+}
+function tagsFromPath(relPath) {
+    const stop = new Set(['docs', 'doc', 'adr', 'readme', 'index']);
+    const tokens = normalizeRel(relPath)
+        .replace(/\.md$/i, '')
+        .split(/[\/._\s-]+/)
+        .map((t) => t.toLowerCase().trim())
+        .filter((t) => t.length >= 3 && !stop.has(t));
+    return Array.from(new Set(tokens)).slice(0, 12);
+}
+function getFlag(args, name) {
+    const i = args.indexOf(name);
+    return i >= 0 ? args[i + 1] : undefined;
+}
+async function apiPost(url, apiKey, body) {
+    const res = await fetch(url, {
+        method: 'POST',
+        headers: { 'Authorization': `Bearer ${apiKey}`, 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok)
+        throw new Error(`API ${res.status}: ${await res.text()}`);
+    return await res.json();
+}
+async function apiGet(url, apiKey) {
+    const res = await fetch(url, { headers: { 'Authorization': `Bearer ${apiKey}` } });
+    if (!res.ok)
+        throw new Error(`API ${res.status}: ${await res.text()}`);
+    return await res.json();
+}
+function trackedFiles(cwd, pattern) {
+    const args = pattern ? ['ls-files', '--', pattern] : ['ls-files'];
+    const out = (0, proc_1.safeExecFileSync)('git', args, { cwd, encoding: 'utf-8' });
+    return out.split('\n').map((s) => normalizeRel(s)).filter(Boolean);
+}
+async function mirrorSync(args) {
+    const cfg = getConfig();
+    if (!cfg.apiKey) {
+        console.error('GREPRAG_API_KEY not set — run `greprag init` first.');
+        process.exit(1);
+    }
+    const json = args.includes('--json');
+    const cwd = process.cwd();
+    const anchor = (0, project_anchor_1.readAnchor)(cwd);
+    let tracked;
+    let present;
+    try {
+        tracked = trackedFiles(cwd, '*.md').filter(isDocPathEligible);
+        present = new Set(trackedFiles(cwd));
+    }
+    catch {
+        console.error('Not a git repo (or git unavailable) — doc mirror needs `git ls-files`.');
+        process.exit(1);
+        return;
+    }
+    const presentDocs = new Set(tracked);
+    const docs = [];
+    const skipped = [];
+    for (const rel of tracked) {
+        try {
+            const content = fs.readFileSync(path.join(cwd, rel), 'utf-8');
+            if (!content.trim()) {
+                skipped.push({ path: rel, reason: 'empty' });
+                continue;
+            }
+            if (content.length > MAX_DOC_CHARS) {
+                skipped.push({ path: rel, reason: 'too large' });
+                continue;
+            }
+            docs.push({
+                path: rel,
+                content,
+                title: titleFromMarkdown(content, rel),
+                tags: tagsFromPath(rel),
+                refs: (0, docptr_refs_1.extractDocRefs)(content.slice(0, 4_000), rel, cwd, present),
+            });
+        }
+        catch {
+            skipped.push({ path: rel, reason: 'unreadable' });
+        }
+    }
+    const result = await apiPost(`${cfg.apiUrl}/v1/doc/${anchor.projectId}/mirror`, cfg.apiKey, {
+        projectName: anchor.projectName,
+        docs,
+        presentPaths: Array.from(presentDocs),
+    });
+    if (json) {
+        console.log(JSON.stringify({ ...result, skipped }, null, 2));
+        return;
+    }
+    const skipText = skipped.length ? ` (${skipped.length} skipped)` : '';
+    console.log(`Mirrored ${result.mirrored} doc(s) for ${anchor.projectName}${skipText}. Pruned ${result.pruned}.`);
+}
+async function listDocs(args) {
+    const cfg = getConfig();
+    if (!cfg.apiKey) {
+        console.error('GREPRAG_API_KEY not set — run `greprag init` first.');
+        process.exit(1);
+    }
+    const anchor = (0, project_anchor_1.readAnchor)(process.cwd());
+    const data = await apiGet(`${cfg.apiUrl}/v1/doc/${anchor.projectId}/list`, cfg.apiKey);
+    if (args.includes('--json')) {
+        console.log(JSON.stringify(data.docs || [], null, 2));
+        return;
+    }
+    const docs = data.docs || [];
+    if (docs.length === 0) {
+        console.log('No mirrored docs yet. Run: greprag doc mirror sync');
+        return;
+    }
+    for (const doc of docs) {
+        const title = doc.title && doc.title !== doc.path ? ` — ${doc.title}` : '';
+        const words = Number.isFinite(doc.wordCount) ? ` (${doc.wordCount}w)` : '';
+        console.log(`${doc.path}${title}${words}`);
+    }
+}
+async function searchDocs(args) {
+    const cfg = getConfig();
+    if (!cfg.apiKey) {
+        console.error('GREPRAG_API_KEY not set — run `greprag init` first.');
+        process.exit(1);
+    }
+    const query = args.find((a) => !a.startsWith('--'));
+    if (!query) {
+        console.log(HELP);
+        return;
+    }
+    const limitRaw = parseInt(getFlag(args, '--limit') || '5', 10);
+    const limit = Number.isFinite(limitRaw) ? limitRaw : 5;
+    const anchor = (0, project_anchor_1.readAnchor)(process.cwd());
+    const data = await apiPost(`${cfg.apiUrl}/v1/doc/${anchor.projectId}/search`, cfg.apiKey, { query, limit });
+    if (args.includes('--json')) {
+        console.log(JSON.stringify(data.docs || [], null, 2));
+        return;
+    }
+    if (data.storeMissing) {
+        console.log('No mirrored docs yet. Run: greprag doc mirror sync');
+        return;
+    }
+    const docs = data.docs || [];
+    if (docs.length === 0) {
+        console.log('No matching mirrored docs.');
+        return;
+    }
+    for (const doc of docs) {
+        const title = doc.title && doc.title !== doc.path ? ` — ${doc.title}` : '';
+        const score = Number.isFinite(doc.score) ? ` [${doc.score.toFixed(3)}]` : '';
+        console.log(`${doc.path}${title}${score}`);
+        if (doc.preview)
+            console.log(`  ${doc.preview}`);
+        console.log(`  greprag doc read ${doc.path}`);
+    }
+}
+async function readDoc(args) {
+    const cfg = getConfig();
+    if (!cfg.apiKey) {
+        console.error('GREPRAG_API_KEY not set — run `greprag init` first.');
+        process.exit(1);
+    }
+    const key = args.find((a, i) => !a.startsWith('--') && args[i - 1] !== '--out');
+    if (!key) {
+        console.log(HELP);
+        return;
+    }
+    const anchor = (0, project_anchor_1.readAnchor)(process.cwd());
+    const params = new URLSearchParams({ key });
+    const data = await apiGet(`${cfg.apiUrl}/v1/doc/${anchor.projectId}/read?${params.toString()}`, cfg.apiKey);
+    const out = getFlag(args, '--out');
+    const content = data.doc.content.endsWith('\n') ? data.doc.content : data.doc.content + '\n';
+    if (out) {
+        fs.writeFileSync(path.resolve(process.cwd(), out), content, 'utf-8');
+        console.log(`Wrote ${out}`);
+        return;
+    }
+    process.stdout.write(content);
+}
+async function runDoc(args) {
+    const sub = args[0];
+    if (!sub || sub === '--help' || sub === '-h' || sub === 'help') {
+        console.log(HELP);
+        return;
+    }
+    if (sub === 'mirror' && args[1] === 'sync')
+        return mirrorSync(args.slice(2));
+    if (sub === 'sync')
+        return mirrorSync(args.slice(1));
+    if (sub === 'list')
+        return listDocs(args.slice(1));
+    if (sub === 'search')
+        return searchDocs(args.slice(1));
+    if (sub === 'read')
+        return readDoc(args.slice(1));
+    console.error(`Unknown "doc ${sub}". Run \`greprag doc --help\`.`);
+    process.exit(1);
+}
+//# sourceMappingURL=doc.js.map

package/dist/commands/doc.js.map

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

package/dist/commands/inbox-primer-reminder.js

@@ -45,7 +45,7 @@ function buildInboxPrimer(env) {
                 ? '[OPENCODE INBOX — greprag is your agent-to-agent mesh. Inbound delivery is AUTOMATIC here: the greprag plugin arms a relay for this session (nothing to arm or re-arm) and inbound peer messages arrive as injected turns.]'
                 : '[⚠ ARM YOUR INBOX WATCHER NOW — you are UNREACHABLE until you do. Peers are live in your mesh trying to coordinate with this session, and the operator can DM you — but they reach you ONLY while armed. Unarmed, you are invisible and their messages silently pile up. The watcher can DROP ANYTIME (crash / reload / OOM) — EVERY turn you are flagged unarmed you MUST re-arm, or coordination breaks.]',
         codex
-            ? 'CODEX: Native Codex tools are the source of truth: `codex_app.list_threads` discovers tasks plus their repo/workspace, and `codex_app.send_message_to_thread` handles Codex-to-Codex coordination. GrepRAG inbox rows for Codex surface through turn hooks only: SessionStart `drain`, UserPromptSubmit `codex-notify`, and PostToolUse `codex-inbox`. There is no Codex startup watcher to install. If hooks do not fire, open Codex Desktop Settings -> Settings -> Hooks, trust the GrepRAG commands, start a fresh Codex session, then drain what is waiting: `greprag inbox`.'
+            ? 'CODEX: Native Codex tools are the source of truth: `codex_app.list_threads` discovers tasks plus their repo/workspace, and `codex_app.send_message_to_thread` handles Codex-to-Codex coordination. GrepRAG inbox rows for Codex surface through turn hooks only: SessionStart `drain` and UserPromptSubmit `codex-notify`. There is no Codex startup watcher to install. If hooks do not fire, open Codex Desktop Settings -> Settings -> Hooks, trust the GrepRAG commands, start a fresh Codex session, then drain what is waiting: `greprag inbox`.'
             : opencode
                 ? 'DELIVERY: the relay arms itself on this session\'s first turn and injects inbound messages as they land — treat an injected `Message from <handle> (session <8hex>):` turn as async peer mail, not the operator typing. Drain anything already waiting: `greprag inbox`.'
                 : `ARM: Monitor is a deferred tool — \`ToolSearch select:Monitor\`, then call Monitor with persistent:true, timeout_ms:3600000, description:"greprag inbox ${env.short}", command: \`${arm}\`. The \`--session ${env.short}\` is REQUIRED — a bare \`greprag inbox watch\` writes no pidfile, so the arm-check reads you unarmed forever. NEVER run it bare also because it is a foreground stream and hangs the turn. Then drain what is waiting: \`greprag inbox\`.`,

package/dist/commands/inbox-primer-reminder.js.map

@@ -1 +1 @@
-{"version":3,"file":"inbox-primer-reminder.js","sourceRoot":"","sources":["../../src/commands/inbox-primer-reminder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;8DAe8D;;;AAa9D,4CAwCC;AAlDD,8CAAkD;AAElD;;;;;;;uDAOuD;AACvD,SAAgB,gBAAgB,CAAC,GAAoF;IACnH,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,KAAK,OAAO,CAAC;IACvC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,KAAK,UAAU,CAAC;IAC7C,MAAM,GAAG,GAAG,IAAA,8BAAiB,EAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpF,OAAO;QACL,qFAAqF;QACrF,qFAAqF;QACrF,uFAAuF;QACvF,6EAA6E;QAC7E,kFAAkF;QAClF,iFAAiF;QACjF,gFAAgF;QAChF,KAAK;YACH,CAAC,CAAC,0WAA0W;YAC5W,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,6NAA6N;gBAC/N,CAAC,CAAC,6YAA6Y;QACjZ,KAAK;YACH,CAAC,CAAC,ojBAAojB;YACtjB,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,0QAA0Q;gBAC5Q,CAAC,CAAC,2JAA2J,GAAG,CAAC,KAAK,iBAAiB,GAAG,uBAAuB,GAAG,CAAC,KAAK,4OAA4O;QACxc,EAAE;QACF,oFAAoF;QACpF,wFAAwF;QACxF,iFAAiF;QACjF,8CAA8C;QAC9C,+UAA+U;QAC/U,KAAK;YACH,CAAC,CAAC,kGAAkG,GAAG,CAAC,KAAK,uRAAuR;YACpY,CAAC,CAAC,0FAA0F,GAAG,CAAC,KAAK,6MAA6M;QACpT,6RAA6R;QAC7R,KAAK;YACH,CAAC,CAAC,+OAA+O;YACjP,CAAC,CAAC,gQAAgQ;QACpQ,kYAAkY;QAClY,uOAAuO;QACvO,2LAA2L;QAC3L,uGAAuG;KACxG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAEY,QAAA,iBAAiB,GAAmB;IAC/C,EAAE,EAAE,cAAc;IAClB,MAAM,EAAE,CAAC,IAAiB,EAAa,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,uBAAuB;IACvF,QAAQ,EAAE,CAAC,GAAgB,EAAiB,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC;IACpE,QAAQ,EAAE,GAAkB,EAAE,CAAC,IAAI;CACpC,CAAC"}
+{"version":3,"file":"inbox-primer-reminder.js","sourceRoot":"","sources":["../../src/commands/inbox-primer-reminder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;8DAe8D;;;AAa9D,4CAwCC;AAlDD,8CAAkD;AAElD;;;;;;;uDAOuD;AACvD,SAAgB,gBAAgB,CAAC,GAAoF;IACnH,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,KAAK,OAAO,CAAC;IACvC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,KAAK,UAAU,CAAC;IAC7C,MAAM,GAAG,GAAG,IAAA,8BAAiB,EAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpF,OAAO;QACL,qFAAqF;QACrF,qFAAqF;QACrF,uFAAuF;QACvF,6EAA6E;QAC7E,kFAAkF;QAClF,iFAAiF;QACjF,gFAAgF;QAChF,KAAK;YACH,CAAC,CAAC,0WAA0W;YAC5W,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,6NAA6N;gBAC/N,CAAC,CAAC,6YAA6Y;QACjZ,KAAK;YACH,CAAC,CAAC,whBAAwhB;YAC1hB,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,0QAA0Q;gBAC5Q,CAAC,CAAC,2JAA2J,GAAG,CAAC,KAAK,iBAAiB,GAAG,uBAAuB,GAAG,CAAC,KAAK,4OAA4O;QACxc,EAAE;QACF,oFAAoF;QACpF,wFAAwF;QACxF,iFAAiF;QACjF,8CAA8C;QAC9C,+UAA+U;QAC/U,KAAK;YACH,CAAC,CAAC,kGAAkG,GAAG,CAAC,KAAK,uRAAuR;YACpY,CAAC,CAAC,0FAA0F,GAAG,CAAC,KAAK,6MAA6M;QACpT,6RAA6R;QAC7R,KAAK;YACH,CAAC,CAAC,+OAA+O;YACjP,CAAC,CAAC,gQAAgQ;QACpQ,kYAAkY;QAClY,uOAAuO;QACvO,2LAA2L;QAC3L,uGAAuG;KACxG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAEY,QAAA,iBAAiB,GAAmB;IAC/C,EAAE,EAAE,cAAc;IAClB,MAAM,EAAE,CAAC,IAAiB,EAAa,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,uBAAuB;IACvF,QAAQ,EAAE,CAAC,GAAgB,EAAiB,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC;IACpE,QAAQ,EAAE,GAAkB,EAAE,CAAC,IAAI;CACpC,CAAC"}

package/dist/commands/init.js

@@ -563,7 +563,7 @@ async function runCodexInit(opts) {
     console.log('\n  greprag init — Setting up agent memory for Codex\n');
     if (opts.installWatcher) {
         console.error('  Error: Codex startup watcher install is retired. Run: greprag init --codex --tenant-id <handle>');
-        console.error('  Codex inbox rows surface through SessionStart drain, UserPromptSubmit codex-notify, and PostToolUse codex-inbox.');
+        console.error('  Codex inbox rows surface through SessionStart drain and UserPromptSubmit codex-notify.');
         process.exit(1);
     }
     let apiKey = opts.apiKey || readSharedApiKey();
@@ -629,15 +629,15 @@ async function runCodexInit(opts) {
     const hookChanges = applyCodexHooks(hooks);
     writeCodexHooks(hooksPath, hooks);
     changes.push(...hookChanges);
-    changes.push('Codex inbox delivery: turn hooks only (SessionStart drain, UserPromptSubmit codex-notify, PostToolUse codex-inbox)');
+    changes.push('Codex inbox delivery: turn hooks only (SessionStart drain, UserPromptSubmit codex-notify)');
     console.log('\n  Setup complete!\n');
     for (const change of changes) {
         console.log(`    - ${change}`);
     }
     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 8 GrepRAG hook definitions.');
-    console.log('  Inbox messages for Codex surface on SessionStart, UserPromptSubmit, and PostToolUse hook boundaries.');
+    console.log('  Start a fresh Codex session, then open Settings -> Settings -> Hooks and trust the GrepRAG hook definitions.');
+    console.log('  Inbox messages for Codex surface on SessionStart and UserPromptSubmit hook boundaries.');
     console.log('  Memory hooks will activate on your next Codex session.\n');
 }
 /** greprag init --global
@@ -1009,6 +1009,36 @@ function writeCodexHooks(hooksPath, hooks) {
         fs.mkdirSync(dir, { recursive: true });
     fs.writeFileSync(hooksPath, JSON.stringify(hooks, null, 2) + '\n');
 }
+function commandOnPath(command) {
+    const paths = (process.env.PATH || '').split(path.delimiter).filter(Boolean);
+    const hasExt = !!path.extname(command);
+    const exts = process.platform === 'win32' && !hasExt
+        ? (process.env.PATHEXT || '.COM;.EXE;.BAT;.CMD').split(';').filter(Boolean)
+        : [''];
+    for (const dir of paths) {
+        for (const ext of exts) {
+            if (fs.existsSync(path.join(dir, `${command}${ext}`)))
+                return true;
+        }
+    }
+    return false;
+}
+function shellQuote(value) {
+    return `"${value.replace(/"/g, '\\"')}"`;
+}
+function codexFastHookWindowsCommand(subcommand) {
+    if (commandOnPath('greprag-codex-hook'))
+        return `greprag-codex-hook.cmd ${subcommand}`;
+    const script = path.resolve(__dirname, '..', 'codex-fast-hook.js');
+    if (fs.existsSync(script))
+        return `node ${shellQuote(script)} ${subcommand}`;
+    return `greprag-codex-hook.cmd ${subcommand}`;
+}
+function windowsCommandForRunner(runner, subcommand) {
+    if (runner === 'greprag-codex-hook')
+        return codexFastHookWindowsCommand(subcommand);
+    return `${runner}.cmd ${subcommand}`;
+}
 function applyCodexHooks(config) {
     const changes = [];
     if (!config.hooks)
@@ -1019,15 +1049,15 @@ function applyCodexHooks(config) {
     const deduped = dedupeCodexHooks(config.hooks);
     if (deduped > 0)
         changes.push(`Removed ${deduped} duplicate Codex hook registration(s)`);
-    const commandHook = (subcommand, timeout, statusMessage) => {
+    const commandHook = (subcommand, timeout, statusMessage, runner = 'greprag-hook') => {
         const hook = {
             type: 'command',
-            command: `greprag-hook ${subcommand}`,
+            command: `${runner} ${subcommand}`,
             timeout,
             statusMessage,
         };
         if (process.platform === 'win32')
-            hook.commandWindows = `greprag-hook.cmd ${subcommand}`;
+            hook.commandWindows = windowsCommandForRunner(runner, subcommand);
         return hook;
     };
     const recapHook = {
@@ -1085,18 +1115,9 @@ function applyCodexHooks(config) {
     else {
         changes.push('Codex UserPromptSubmit hook already configured (skipped)');
     }
-    const inboxHook = {
-        matcher: '',
-        hooks: [commandHook('codex-inbox', 5, 'Checking GrepRAG inbox')],
-    };
-    if (!hasGrepragHook(config.hooks.PostToolUse, 'codex-inbox')) {
-        if (!config.hooks.PostToolUse)
-            config.hooks.PostToolUse = [];
-        config.hooks.PostToolUse.push(inboxHook);
-        changes.push('Added Codex PostToolUse hook (inbox steering)');
-    }
-    else {
-        changes.push('Codex PostToolUse inbox hook already configured (skipped)');
+    const removedPostToolInbox = removeGrepragHook(config.hooks, 'PostToolUse', 'codex-inbox');
+    if (removedPostToolInbox) {
+        changes.push(`Removed ${removedPostToolInbox} Codex PostToolUse inbox hook(s); UserPromptSubmit now owns inbox steering`);
     }
     const permissionHook = {
         matcher: '',
@@ -1149,11 +1170,35 @@ function applyCodexHooks(config) {
     }
     const chipHooks = [
         { event: 'SessionStart', matcher: 'startup|resume|clear|compact', label: 'chip context' },
-        { event: 'PreToolUse', matcher: '', label: 'chip boundary guard' },
         { event: 'SubagentStart', matcher: '', label: 'nested-agent chip context' },
         { event: 'SubagentStop', matcher: '', label: 'nested-agent completion context' },
-        { event: 'Stop', matcher: '', label: 'chip completion gate' },
     ];
+    // adr: adr/codex-hook-latency.md
+    // Collapse the hot PreToolUse safety pair into one fast command process. It
+    // runs the chip/apply_patch guard first, then lazy-loads coordination only for
+    // Bash calls.
+    const removedPreToolChip = removeGrepragHook(config.hooks, 'PreToolUse', 'codex-chip-hook');
+    const removedPreToolCoord = removeGrepragHook(config.hooks, 'PreToolUse', 'codex-coordinate-gate');
+    if (removedPreToolChip || removedPreToolCoord) {
+        changes.push(`Removed ${removedPreToolChip + removedPreToolCoord} split Codex PreToolUse hook(s); codex-pretooluse now multiplexes safety`);
+    }
+    const preToolUseHook = {
+        matcher: '',
+        hooks: [commandHook('codex-pretooluse', 10, 'Checking GrepRAG Codex safety', 'greprag-codex-hook')],
+    };
+    if (!hasGrepragHookWithMatcher(config.hooks.PreToolUse, 'codex-pretooluse', preToolUseHook.matcher)) {
+        if (!config.hooks.PreToolUse)
+            config.hooks.PreToolUse = [];
+        config.hooks.PreToolUse.push(preToolUseHook);
+        changes.push('Added Codex PreToolUse hook (multiplexed chip + coordination safety)');
+    }
+    else {
+        changes.push('Codex PreToolUse multiplexed safety hook already configured (skipped)');
+    }
+    const removedStopChip = removeGrepragHook(config.hooks, 'Stop', 'codex-chip-hook');
+    if (removedStopChip) {
+        changes.push(`Removed ${removedStopChip} Codex Stop chip hook(s); Stop chip hook was a no-op`);
+    }
     for (const spec of chipHooks) {
         const eventHooks = config.hooks[spec.event];
         if (hasGrepragHookWithMatcher(eventHooks, 'codex-chip-hook', spec.matcher)) {
@@ -1162,30 +1207,13 @@ function applyCodexHooks(config) {
         }
         const entry = {
             matcher: spec.matcher,
-            hooks: [commandHook('codex-chip-hook', 3, 'Enforcing Codex chip contract')],
+            hooks: [commandHook('codex-chip-hook', 3, 'Enforcing Codex chip contract', 'greprag-codex-hook')],
         };
         if (!config.hooks[spec.event])
             config.hooks[spec.event] = [];
         config.hooks[spec.event].push(entry);
         changes.push(`Added Codex ${spec.event} hook (${spec.label})`);
     }
-    // Codex shipping coordination — risky Bash actions are denied until the
-    // current committed artifact has fresh native-task + cross-harness conferral
-    // evidence. This is separate from codex-chip-hook because it applies to every
-    // Codex task, not only managed chips. adr: adr/codex-coordinate-gate.md
-    const coordinateGateHook = {
-        matcher: 'Bash',
-        hooks: [commandHook('codex-coordinate-gate', 10, 'Checking peer coordination')],
-    };
-    if (!hasGrepragHookWithMatcher(config.hooks.PreToolUse, 'codex-coordinate-gate', coordinateGateHook.matcher)) {
-        if (!config.hooks.PreToolUse)
-            config.hooks.PreToolUse = [];
-        config.hooks.PreToolUse.push(coordinateGateHook);
-        changes.push('Added Codex PreToolUse hook (shipping coordination gate)');
-    }
-    else {
-        changes.push('Codex PreToolUse shipping coordination hook already configured (skipped)');
-    }
     const storeHook = {
         matcher: '',
         hooks: [commandHook('codex-store', 10, 'Storing GrepRAG turn')],
@@ -1226,10 +1254,10 @@ function normalizeCodexHookCommands(hooks) {
         'session-id': { timeout: 3, statusMessage: 'Loading GrepRAG session id' },
         drain: { timeout: 5, statusMessage: 'Draining GrepRAG inbox' },
         'codex-notify': { timeout: 300, 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-chip-hook': { timeout: 3, statusMessage: 'Enforcing Codex chip contract' },
+        'codex-chip-hook': { timeout: 3, statusMessage: 'Enforcing Codex chip contract', runner: 'greprag-codex-hook' },
+        'codex-pretooluse': { timeout: 10, statusMessage: 'Checking GrepRAG Codex safety', runner: 'greprag-codex-hook' },
         'codex-coordinate-gate': { timeout: 10, statusMessage: 'Checking peer coordination' },
         'codex-store': { timeout: 10, statusMessage: 'Storing GrepRAG turn' },
     };
@@ -1239,7 +1267,7 @@ function normalizeCodexHookCommands(hooks) {
             for (const hook of entry.hooks || []) {
                 if (!hook.command)
                     continue;
-                const match = hook.command.match(/^greprag-hook(?:\.cmd)*\s+([a-z-]+)/);
+                const match = hook.command.match(/^greprag(?:-codex)?-hook(?:\.cmd)*\s+([a-z-]+)/);
                 if (!match)
                     continue;
                 const baseSpec = desired[match[1]];
@@ -1250,13 +1278,14 @@ function normalizeCodexHookCommands(hooks) {
                     spec.statusMessage = 'Restoring GrepRAG session id';
                 }
                 const subcommand = match[1] === 'recap' ? 'codex-recap' : match[1];
-                const next = `greprag-hook ${subcommand}`;
+                const runner = spec.runner || 'greprag-hook';
+                const next = `${runner} ${subcommand}`;
                 if (next !== hook.command) {
                     hook.command = next;
                     count++;
                 }
                 if (process.platform === 'win32') {
-                    const windows = `greprag-hook.cmd ${subcommand}`;
+                    const windows = windowsCommandForRunner(runner, subcommand);
                     if (hook.commandWindows !== windows) {
                         hook.commandWindows = windows;
                         count++;
@@ -1620,9 +1649,15 @@ function applySettings(settings, apiKey) {
  *  `hasCodexHook`. adr: adr/codex-hook-idempotency.md */
 function commandInvokesSub(h, subcommand) {
     const hay = `${h.command || ''}\n${h.commandWindows || ''}`;
+    const escaped = subcommand.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const directNodeHook = new RegExp(`(?:hook|codex-fast-hook)\\.js"?\\s+${escaped}`);
     return hay.includes(`greprag-hook ${subcommand}`)
         || hay.includes(`greprag-hook.cmd ${subcommand}`)
-        || hay.includes(`hook.js ${subcommand}`);
+        || hay.includes(`greprag-codex-hook ${subcommand}`)
+        || hay.includes(`greprag-codex-hook.cmd ${subcommand}`)
+        || hay.includes(`hook.js ${subcommand}`)
+        || hay.includes(`codex-fast-hook.js ${subcommand}`)
+        || directNodeHook.test(hay);
 }
 function hasGrepragHook(hookConfigs, subcommand) {
     if (!hookConfigs)
@@ -1644,12 +1679,33 @@ function hasGrepragHookWithMatcher(hookConfigs, subcommand, matcher) {
 function grepragSubOf(cfg) {
     for (const h of cfg.hooks || []) {
         const m = `${h.command || ''}\n${h.commandWindows || ''}`
-            .match(/greprag-hook(?:\.cmd)?\s+([a-z-]+)/);
+            .match(/greprag(?:-codex)?-hook(?:\.cmd)?\s+([a-z-]+)/);
         if (m)
             return m[1];
     }
     return null;
 }
+function removeGrepragHook(hooks, eventName, subcommand) {
+    const entries = hooks?.[eventName];
+    if (!Array.isArray(entries))
+        return 0;
+    let removed = 0;
+    const keptEntries = [];
+    for (const entry of entries) {
+        const keptHooks = (entry.hooks || []).filter(hook => {
+            if (commandInvokesSub(hook, subcommand)) {
+                removed++;
+                return false;
+            }
+            return true;
+        });
+        if (keptHooks.length)
+            keptEntries.push({ ...entry, hooks: keptHooks });
+    }
+    entries.length = 0;
+    entries.push(...keptEntries);
+    return removed;
+}
 /** Collapse duplicate greprag hook registrations so a repeated `init` converges
  *  to exactly ONE set instead of stacking copies. The Windows `.cmd`-detection
  *  bug let re-init append dupes; this also SELF-HEALS files already broken that