greprag 5.40.1 → 5.42.0

package/dist/crush/search-compressor.js

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * MIRRORED FILE — canonical source: packages/core/src/crush/search-compressor.ts.
+ * Byte-identical copy lives at packages/cli/src/crush/search-compressor.ts (the CLI is a
+ * zero-dep artifact and cannot import @greprag/core). KEEP IN SYNC —
+ * the sync guard in tests/test-crush.cjs fails the build on drift.
+ *
+ * Search-results compressor — TypeScript port of Headroom's
+ * transforms/search_compressor.rs. Compresses grep/ripgrep output
+ * (`file:line:content`, plus rg's `file-line-content` context lines).
+ * Typical compression: 5-10x.
+ *
+ * Pipeline: parse -> score (query-word overlap + error-keyword boosts)
+ * -> select (top-N per adaptive budget; always keep first/last per
+ * file) -> emit survivors in line order + `[... and N more matches in
+ * <file>]` summaries.
+ *
+ * Carries Headroom's documented parser fixes:
+ * - Windows drive paths (`C:\...`): the drive colon is not the
+ *   line-number marker; the scan starts after it.
+ * - Filenames containing `-` (rg context lines): the parser anchors on
+ *   the leftmost `<sep><digits><sep>` marker, not on a path charset.
+ * - Adjacent-separator collapse: `file.py:-1:x` is rejected (negative
+ *   line numbers are content, not markers).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SEARCH_CONFIG = void 0;
+exports.parseMatchLine = parseMatchLine;
+exports.crushSearch = crushSearch;
+const adaptive_sizer_1 = require("./adaptive-sizer");
+const crush_keywords_1 = require("./crush-keywords");
+const crush_types_1 = require("./crush-types");
+exports.DEFAULT_SEARCH_CONFIG = {
+    maxMatchesPerFile: 5,
+    alwaysKeepFirst: true,
+    alwaysKeepLast: true,
+    maxTotalMatches: 30,
+    maxFiles: 15,
+    contextKeywords: [],
+    boostErrors: true,
+    bias: 1.0,
+};
+/**
+ * Parse one grep/ripgrep-style line into a match, or null.
+ *
+ * Finds the leftmost `<sep><digits><sep>` triplet (sep = `:` or `-`);
+ * path is everything before, content everything after. A Windows drive
+ * prefix (`C:\` / `C:/`) shifts the scan start past the drive colon.
+ */
+function parseMatchLine(line) {
+    const isDrivePrefixed = line.length >= 3 && /[A-Za-z]/.test(line[0]) && line[1] === ':' && (line[2] === '\\' || line[2] === '/');
+    let i = isDrivePrefixed ? 2 : 0;
+    for (; i < line.length; i++) {
+        const ch = line[i];
+        if (ch !== ':' && ch !== '-')
+            continue;
+        // Collapse adjacent-separator runs: a separator immediately after
+        // another separator can't open the marker (rejects `file.py:-1:x`).
+        const prev = line[i - 1];
+        if (i > 0 && (prev === ':' || prev === '-'))
+            continue;
+        const digitsStart = i + 1;
+        let j = digitsStart;
+        while (j < line.length && line[j] >= '0' && line[j] <= '9')
+            j++;
+        if (j > digitsStart && j < line.length && (line[j] === ':' || line[j] === '-')) {
+            if (i === 0)
+                return null; // zero-length path
+            const lineNumber = parseInt(line.slice(digitsStart, j), 10);
+            if (!Number.isFinite(lineNumber))
+                return null;
+            return { file: line.slice(0, i), lineNumber, content: line.slice(j + 1) };
+        }
+    }
+    return null;
+}
+function parseSearchResults(content) {
+    const out = new Map();
+    for (const raw of content.split('\n')) {
+        const line = raw.trim();
+        if (!line)
+            continue;
+        const parsed = parseMatchLine(line);
+        if (!parsed)
+            continue;
+        let fm = out.get(parsed.file);
+        if (!fm) {
+            fm = { file: parsed.file, matches: [] };
+            out.set(parsed.file, fm);
+        }
+        fm.matches.push({ ...parsed, score: 0 });
+    }
+    return out;
+}
+function scoreMatches(files, query, config) {
+    const queryWords = query
+        .toLowerCase()
+        .split(/\s+/)
+        .filter((w) => w.length > 2);
+    for (const fm of files.values()) {
+        for (const m of fm.matches) {
+            let score = 0;
+            const lower = m.content.toLowerCase();
+            for (const w of queryWords) {
+                if (lower.includes(w))
+                    score += 0.3;
+            }
+            if (config.boostErrors) {
+                const cat = (0, crush_keywords_1.classifyImportance)(m.content);
+                if (cat === 'error')
+                    score += 0.5;
+                else if (cat === 'warning')
+                    score += 0.4;
+                else if (cat === 'importance')
+                    score += 0.3;
+            }
+            for (const kw of config.contextKeywords) {
+                if (lower.includes(kw.toLowerCase()))
+                    score += 0.4;
+            }
+            m.score = Math.min(score, 1.0);
+        }
+    }
+}
+function totalScore(fm) {
+    return fm.matches.reduce((s, m) => s + m.score, 0);
+}
+function selectMatches(files, config) {
+    // Files by total score descending; cap to maxFiles.
+    let byScore = [...files.values()].sort((a, b) => totalScore(b) - totalScore(a));
+    if (byScore.length > config.maxFiles)
+        byScore = byScore.slice(0, config.maxFiles);
+    const allMatchStrings = byScore.flatMap((fm) => fm.matches.map((m) => `${m.file}:${m.lineNumber}:${m.content}`));
+    const adaptiveTotal = (0, adaptive_sizer_1.computeOptimalK)(allMatchStrings, config.bias, 5, config.maxTotalMatches);
+    const selected = new Map();
+    let totalSelected = 0;
+    for (const fm of byScore) {
+        if (totalSelected >= adaptiveTotal)
+            continue;
+        // Score desc, line asc on ties.
+        const sorted = [...fm.matches].sort((a, b) => b.score - a.score || a.lineNumber - b.lineNumber);
+        const fileSelected = [];
+        const seen = new Set();
+        const remainingCap = Math.min(config.maxMatchesPerFile, adaptiveTotal - totalSelected);
+        const pushUnique = (m) => {
+            const key = `${m.lineNumber}
${m.content}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                fileSelected.push(m);
+            }
+        };
+        if (config.alwaysKeepFirst && fm.matches.length > 0 && fileSelected.length < remainingCap) {
+            pushUnique(fm.matches[0]);
+        }
+        if (config.alwaysKeepLast && fm.matches.length > 1 && fileSelected.length < remainingCap) {
+            pushUnique(fm.matches[fm.matches.length - 1]);
+        }
+        for (const m of sorted) {
+            if (fileSelected.length >= remainingCap)
+                break;
+            pushUnique(m);
+        }
+        fileSelected.sort((a, b) => a.lineNumber - b.lineNumber);
+        totalSelected += fileSelected.length;
+        selected.set(fm.file, { file: fm.file, matches: fileSelected });
+    }
+    return selected;
+}
+function formatOutput(selected, original) {
+    const lines = [];
+    for (const [file, fm] of selected) {
+        for (const m of fm.matches) {
+            lines.push(`${m.file}:${m.lineNumber}:${m.content}`);
+        }
+        const orig = original.get(file);
+        if (orig && orig.matches.length > fm.matches.length) {
+            lines.push(`[... and ${orig.matches.length - fm.matches.length} more matches in ${file}]`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Compress grep/rg output. `query` (optional) boosts matches containing
+ * its words. Unparseable input passes through unchanged.
+ */
+function crushSearch(content, query = '', config = {}) {
+    const cfg = { ...exports.DEFAULT_SEARCH_CONFIG, ...config };
+    const parsed = parseSearchResults(content);
+    const originalCount = [...parsed.values()].reduce((s, fm) => s + fm.matches.length, 0);
+    if (originalCount === 0) {
+        return (0, crush_types_1.makePassthrough)(content, 'search', 'no parseable matches');
+    }
+    scoreMatches(parsed, query, cfg);
+    const selected = selectMatches(parsed, cfg);
+    const output = formatOutput(selected, parsed);
+    const keptCount = [...selected.values()].reduce((s, fm) => s + fm.matches.length, 0);
+    return {
+        output,
+        stats: {
+            sourceType: 'search',
+            originalChars: content.length,
+            compressedChars: output.length,
+            compressionRatio: output.length / Math.max(content.length, 1),
+            originalUnits: originalCount,
+            keptUnits: keptCount,
+            passthrough: false,
+        },
+    };
+}
+//# sourceMappingURL=search-compressor.js.map

package/dist/crush/search-compressor.js.map

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

package/dist/email-pull.d.ts

@@ -40,6 +40,9 @@ export interface PendingRow {
     subject: string | null;
     trust_verdict: string | null;
     attachment_count: number;
+    /** The address this mail arrived on (custom-domain mailboxes). NULL on
+     *  legacy rows that predate the stamp — the tenant's default box. */
+    mailbox: string | null;
     created_at: string;
 }
 /** One attachment's outcome from a pull. `skipped` = already on disk. */
@@ -68,14 +71,33 @@ export declare function resolveEmailDir(opts: {
     anchorDir?: string | null;
     projectName?: string | null;
 }): string;
-export declare function fetchPending(apiUrl: string, apiKey: string, limit?: number): Promise<PendingRow[]>;
+/** Build the /pending URL — pure, exported for unit tests. `box` narrows to
+ *  one mailbox (address), a whole domain, or the literal `default`. */
+export declare function pendingUrl(apiUrl: string, limit: number, box?: string | null): string;
+export declare function fetchPending(apiUrl: string, apiKey: string, limit?: number, box?: string | null): Promise<PendingRow[]>;
+export interface BoxRow {
+    mailbox: string;
+    pending: number;
+    is_default: boolean;
+}
+/** GET /v1/email/boxes — distinct mailboxes with pending counts. */
+export declare function fetchBoxes(apiUrl: string, apiKey: string): Promise<BoxRow[]>;
+export interface DomainRow {
+    domain: string;
+    verified: boolean;
+    forward_to: string | null;
+    created_at: string;
+}
+/** GET /v1/email/domains — the tenant's custom domains + verified status. */
+export declare function fetchDomains(apiUrl: string, apiKey: string): Promise<DomainRow[]>;
 export declare function fetchManifest(apiUrl: string, apiKey: string, recordId: string): Promise<RecordManifest>;
 /** Pull one record's attachments into `dir`. Idempotent: already-saved
  *  attachments are reported `skipped`, never re-downloaded. Non-downloadable
  *  (dropped / no original) attachments are omitted from the result. */
 export declare function pullRecord(apiUrl: string, apiKey: string, recordId: string, dir: string): Promise<SavedFile[]>;
-/** Pull every pending record that carries attachments. */
-export declare function pullAllPending(apiUrl: string, apiKey: string, dir: string): Promise<{
+/** Pull every pending record that carries attachments — optionally only one
+ *  mailbox/domain (`box`, same grammar as fetchPending). */
+export declare function pullAllPending(apiUrl: string, apiKey: string, dir: string, box?: string | null): Promise<{
     records: number;
     saved: SavedFile[];
 }>;

package/dist/email-pull.js

@@ -50,7 +50,10 @@ exports.slugifySubject = slugifySubject;
 exports.attachmentFilename = attachmentFilename;
 exports.shouldPull = shouldPull;
 exports.resolveEmailDir = resolveEmailDir;
+exports.pendingUrl = pendingUrl;
 exports.fetchPending = fetchPending;
+exports.fetchBoxes = fetchBoxes;
+exports.fetchDomains = fetchDomains;
 exports.fetchManifest = fetchManifest;
 exports.pullRecord = pullRecord;
 exports.pullAllPending = pullAllPending;
@@ -110,10 +113,26 @@ async function getJson(url, apiKey) {
 function base(apiUrl) {
     return apiUrl.replace(/\/+$/, '');
 }
-async function fetchPending(apiUrl, apiKey, limit = 50) {
-    const data = await getJson(`${base(apiUrl)}/v1/email/pending?limit=${limit}`, apiKey);
+/** Build the /pending URL — pure, exported for unit tests. `box` narrows to
+ *  one mailbox (address), a whole domain, or the literal `default`. */
+function pendingUrl(apiUrl, limit, box) {
+    const boxParam = box && box.trim() ? `&box=${encodeURIComponent(box.trim())}` : '';
+    return `${base(apiUrl)}/v1/email/pending?limit=${limit}${boxParam}`;
+}
+async function fetchPending(apiUrl, apiKey, limit = 50, box) {
+    const data = await getJson(pendingUrl(apiUrl, limit, box), apiKey);
     return data.pending || [];
 }
+/** GET /v1/email/boxes — distinct mailboxes with pending counts. */
+async function fetchBoxes(apiUrl, apiKey) {
+    const data = await getJson(`${base(apiUrl)}/v1/email/boxes`, apiKey);
+    return data.boxes || [];
+}
+/** GET /v1/email/domains — the tenant's custom domains + verified status. */
+async function fetchDomains(apiUrl, apiKey) {
+    const data = await getJson(`${base(apiUrl)}/v1/email/domains`, apiKey);
+    return data.domains || [];
+}
 async function fetchManifest(apiUrl, apiKey, recordId) {
     const data = await getJson(`${base(apiUrl)}/v1/email/${encodeURIComponent(recordId)}/manifest`, apiKey);
     return { id: data.id, subject: data.subject ?? null, attachments: data.attachments || [] };
@@ -176,9 +195,10 @@ async function pullRecord(apiUrl, apiKey, recordId, dir) {
     }
     return out;
 }
-/** Pull every pending record that carries attachments. */
-async function pullAllPending(apiUrl, apiKey, dir) {
-    const pending = (await fetchPending(apiUrl, apiKey)).filter(r => r.attachment_count > 0);
+/** Pull every pending record that carries attachments — optionally only one
+ *  mailbox/domain (`box`, same grammar as fetchPending). */
+async function pullAllPending(apiUrl, apiKey, dir, box) {
+    const pending = (await fetchPending(apiUrl, apiKey, 50, box)).filter(r => r.attachment_count > 0);
     const saved = [];
     for (const row of pending) {
         try {

package/dist/email-pull.js.map

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

package/dist/email-send.d.ts

@@ -25,6 +25,7 @@ export interface SendPayload {
     bcc?: string[];
     reply_to?: string;
     from?: string;
+    from_name?: string;
     attachments?: SendAttachmentInput[];
 }
 export interface SendOptions {
@@ -36,6 +37,9 @@ export interface SendOptions {
     bcc?: string[];
     replyTo?: string | null;
     from?: string | null;
+    /** Display name for the From header ("Travis Steward"). Overrides the
+     *  domain default; null falls back to it server-side. */
+    fromName?: string | null;
     /** Local file paths to attach — read + base64'd by buildSendPayload. */
     attachPaths?: string[];
 }

package/dist/email-send.js

@@ -98,6 +98,8 @@ function buildSendPayload(opts) {
         payload.reply_to = opts.replyTo;
     if (opts.from)
         payload.from = opts.from;
+    if (opts.fromName)
+        payload.from_name = opts.fromName;
     const atts = (opts.attachPaths || []).map(fileToAttachment);
     if (atts.length)
         payload.attachments = atts;

package/dist/email-send.js.map

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

package/dist/hook.js

@@ -70,6 +70,19 @@ const opencode_plugin_helpers_1 = require("./opencode-plugin-helpers");
 // Mechanic dispatcher (Chip B) — PreToolUse guard + matchset boot pull/refresh.
 // docs/mechanic-repairs.md D1/D2/D5/D8; docs/mechanic-engine-contracts.md.
 const guard_1 = require("./guard");
+// Context governor (Chip C) — Stop probe measures live context size from the
+// transcript tail; UserPromptSubmit check injects the crossover advisory.
+// All real logic lives in ./commands/context-governor. docs/pre-llm-compression.md
+const context_governor_1 = require("./commands/context-governor");
+// Pipe-wrap (Chip B) — PreToolUse[Bash] rewrite: noisy commands get piped
+// through `greprag crush` via hookSpecificOutput.updatedInput. All real logic
+// lives in ./commands/pipe-wrap. docs/pre-llm-compression.md, adr/pipe-wrap-hook.md
+const pipe_wrap_1 = require("./commands/pipe-wrap");
+// Governed compact (Chip D) — PreCompact renders the transcript to pixel-font
+// PNG pages (lossless ~3x-density archive, CCR-indexed); SessionStart(compact)
+// injects the pointer so the post-compact model can Read the verbatim record.
+// All real logic lives in ./commands/archive. adr: adr/governed-compact.md
+const archive_1 = require("./commands/archive");
 const API_URL_DEFAULT = 'https://api.greprag.com';
 const MAX_FIELD_CHARS = 500_000; // safety cap per text field
 // ---------- Env + config ---------------------------------------------------
@@ -1358,11 +1371,13 @@ async function main() {
     const validSubs = new Set([
         'store', 'recap', 'notify', 'mail', 'session-id', 'pre-spawn-check', 'armcheck',
         'guard', 'guard-refresh', 'guard-flush',
+        'context-probe', 'context-check', 'crush-wrap',
+        'pre-compact', 'archive-pointer',
         'codex-store', 'codex-notify', 'codex-inbox', 'codex-recap',
         'codex-permission-context', 'codex-subagent-start',
     ]);
     if (!validSubs.has(subcommand)) {
-        process.stderr.write(`Usage: greprag-hook <store|recap|notify|mail|session-id|pre-spawn-check|armcheck|guard|guard-refresh|guard-flush|codex-store|codex-notify|codex-inbox|codex-recap|codex-permission-context|codex-subagent-start>\n`);
+        process.stderr.write(`Usage: greprag-hook <store|recap|notify|mail|session-id|pre-spawn-check|armcheck|guard|guard-refresh|guard-flush|context-probe|context-check|crush-wrap|pre-compact|archive-pointer|codex-store|codex-notify|codex-inbox|codex-recap|codex-permission-context|codex-subagent-start>\n`);
         process.exit(1);
     }
     let input = {};
@@ -1425,6 +1440,39 @@ async function main() {
     else if (subcommand === 'armcheck') {
         await armCheck(input);
     }
+    else if (subcommand === 'context-probe') {
+        // Stop probe — transcript-tail context-size measurement, local state only.
+        (0, context_governor_1.runContextProbe)(input);
+    }
+    else if (subcommand === 'context-check') {
+        // UserPromptSubmit — one-line crossover advisory, once per 25-turn window.
+        const advisory = (0, context_governor_1.runContextCheck)(input);
+        if (advisory)
+            writeAdditionalContext('UserPromptSubmit', advisory);
+    }
+    else if (subcommand === 'crush-wrap') {
+        // PreToolUse[Bash] — rewrite noisy commands to pipe through greprag crush.
+        // Emits updatedInput only (no permissionDecision — permission flow intact);
+        // silence on any non-qualifying command. adr: adr/pipe-wrap-hook.md
+        const out = (0, pipe_wrap_1.runPipeWrap)(input);
+        if (out)
+            process.stdout.write(JSON.stringify(out) + '\n');
+    }
+    else if (subcommand === 'pre-compact') {
+        // PreCompact — render the PNG archive before compaction proceeds. The
+        // verified contract (adr/governed-compact.md) allows no instruction
+        // injection here; we archive + surface a user-facing systemMessage.
+        const message = await (0, archive_1.runPreCompactArchive)(input);
+        if (message)
+            process.stdout.write(JSON.stringify({ systemMessage: message }) + '\n');
+    }
+    else if (subcommand === 'archive-pointer') {
+        // SessionStart(matcher=compact) — the one documented post-compact channel
+        // whose output reaches the model. Points at the PNG archive.
+        const pointer = await (0, archive_1.buildArchivePointer)(input);
+        if (pointer)
+            writeAdditionalContext('SessionStart', pointer);
+    }
     else if (subcommand === 'codex-store') {
         await store(input, 'codex');
     }