greprag 5.41.0 → 5.42.1

package/dist/archive/transcript-extract.js

@@ -0,0 +1,187 @@
+"use strict";
+// adr: adr/governed-compact.md
+/** Transcript extraction for the PNG archive — JSONL -> flat conversation
+ *  text with turn-numbered section headers.
+ *
+ *  Main chain only: sidechain (subagent) entries are skipped — the archive
+ *  is the record of THIS conversation, which is what compaction is about to
+ *  summarize away. A "turn" increments on each real user message (one with
+ *  text content, not a tool_result carrier), matching the turn notion used
+ *  across the hook layer.
+ *
+ *  Section headers (`=== T<n> USER ===` etc.) give the vision model anchors
+ *  to scan for, and give the indexer the char offsets it needs to stamp a
+ *  turn range onto every rendered page.
+ */
+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.extractConversation = extractConversation;
+exports.extractTranscriptFile = extractTranscriptFile;
+exports.turnRangeForWindow = turnRangeForWindow;
+const fs = __importStar(require("fs"));
+function textBlocks(content) {
+    if (typeof content === 'string')
+        return content.trim();
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .filter((b) => b?.type === 'text' && typeof b.text === 'string')
+        .map((b) => b.text)
+        .join('\n')
+        .trim();
+}
+function toolResultText(content) {
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .filter((b) => typeof b === 'string' || b?.type === 'text')
+        .map((b) => typeof b === 'string' ? b : (b.text || ''))
+        .join('\n');
+}
+/** One-line summary of a tool_use block: name + its most identifying input. */
+function toolUseLine(block) {
+    const name = block.name || 'unknown';
+    const input = (block.input || {});
+    const target = input.file_path ||
+        input.command ||
+        input.pattern ||
+        input.url ||
+        input.query ||
+        input.description ||
+        '';
+    const brief = target.length > 200 ? target.slice(0, 200) + '…' : target;
+    return brief ? `>> ${name}: ${brief}` : `>> ${name}`;
+}
+/** Extract the main-chain conversation from a transcript JSONL string. */
+function extractConversation(jsonl) {
+    const sections = [];
+    const turnMarks = [];
+    let turn = 0;
+    let offset = 0;
+    const push = (header, body) => {
+        const section = `=== ${header} ===\n${body}\n`;
+        sections.push(section);
+        offset += section.length;
+    };
+    for (const line of jsonl.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let entry;
+        try {
+            entry = JSON.parse(trimmed);
+        }
+        catch {
+            continue;
+        }
+        if (entry.isSidechain === true)
+            continue;
+        const msg = (entry.message || entry);
+        const role = (msg.role || entry.type || '');
+        if (role === 'user') {
+            const content = msg.content;
+            // Tool results ride user-role entries — archive them under the turn.
+            if (Array.isArray(content)) {
+                for (const b of content) {
+                    if (b?.type === 'tool_result') {
+                        const out = toolResultText(b.content).trim();
+                        if (out)
+                            push(`T${turn} TOOL RESULT`, out);
+                    }
+                }
+            }
+            const text = textBlocks(content);
+            if (text) {
+                turn += 1;
+                turnMarks.push({ turn, charStart: offset });
+                push(`T${turn} USER`, text);
+            }
+        }
+        else if (role === 'assistant') {
+            const content = msg.content;
+            const text = textBlocks(content);
+            const toolLines = [];
+            if (Array.isArray(content)) {
+                for (const b of content) {
+                    if (b?.type === 'tool_use')
+                        toolLines.push(toolUseLine(b));
+                }
+            }
+            const body = [text, toolLines.join('\n')].filter(Boolean).join('\n');
+            if (body)
+                push(`T${turn} ASSISTANT`, body);
+        }
+    }
+    return { text: sections.join(''), turnMarks, turns: turn };
+}
+/** File wrapper. Returns null when the transcript can't be read. */
+function extractTranscriptFile(transcriptPath) {
+    try {
+        return extractConversation(fs.readFileSync(transcriptPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** Turn range [first, last] overlapping a char window. turnMarks must be
+ *  ascending and in the SAME offset space as the window (callers re-map
+ *  marks through sanitizeWithMarks before paginating). A turn spans from
+ *  its mark to the next mark (the last turn runs to infinity). Content
+ *  before the first mark (rare T0 preamble) reports as turn 0. */
+function turnRangeForWindow(marks, charStart, charEnd) {
+    let turnStart = null;
+    let turnEnd = null;
+    for (let i = 0; i < marks.length; i++) {
+        const begin = marks[i].charStart;
+        const end = i + 1 < marks.length ? marks[i + 1].charStart : Number.MAX_SAFE_INTEGER;
+        if (begin < charEnd && end > charStart) {
+            if (turnStart === null)
+                turnStart = marks[i].turn;
+            turnEnd = marks[i].turn;
+        }
+        if (begin >= charEnd)
+            break;
+    }
+    if (turnStart === null || turnEnd === null)
+        return { turnStart: 0, turnEnd: 0 };
+    // Window opens before the first overlapping mark -> preamble included.
+    if (marks.length && charStart < marks[0].charStart && turnStart === marks[0].turn) {
+        turnStart = Math.min(turnStart, marks[0].turn);
+    }
+    return { turnStart, turnEnd };
+}
+//# sourceMappingURL=transcript-extract.js.map

package/dist/archive/transcript-extract.js.map

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

package/dist/ccr-store.d.ts

@@ -0,0 +1,49 @@
+/**
+ * CCR (Cached Content Retrieval) store — local sqlite stash for tool
+ * output the crush engine elided. `greprag crush --ccr` puts the
+ * original here and appends a `<<ccr:HASH>>` marker; `greprag retrieve
+ * <hash>` reads it back. Chip D's PNG-archive indexing consumes the
+ * same API — keep it stable.
+ *
+ * Backed by sql.js (the CLI's existing sqlite dep — WASM, no native
+ * build). The DB lives at ~/.greprag/ccr.db; override with
+ * GREPRAG_CCR_DB (tests point it at a temp file).
+ *
+ * Keys are sha256: the full 64-hex digest is stored; lookups accept any
+ * unique prefix >= 16 hex chars (the marker carries the first 16).
+ */
+/** Marker appended to crushed output: first 16 hex of the sha256. */
+export declare const CCR_MARKER_HASH_LEN = 16;
+export declare function defaultCcrDbPath(): string;
+export declare function ccrMarker(hash: string): string;
+export declare class CcrStore {
+    private db;
+    private dbPath;
+    private constructor();
+    /** Open (creating file + schema as needed). */
+    static open(dbPath?: string): Promise<CcrStore>;
+    /**
+     * Store an original. Returns the first 16 hex chars of its sha256 —
+     * the marker-friendly key. Idempotent (same content -> same hash).
+     */
+    put(original: string, sourceType?: string): string;
+    /**
+     * Retrieve an original by hash (full digest or any prefix >= 8 hex).
+     * Returns null when not found or ambiguous-by-prefix.
+     */
+    get(hash: string): string | null;
+    /** All entries of one source_type, newest first. Additive for Chip D:
+     *  'png-archive' rows hold JSON metadata (file path + char/turn ranges)
+     *  pointing at rendered archive pages — `greprag archive list` reads
+     *  them back out. */
+    listBySourceType(sourceType: string): Array<{
+        hash: string;
+        content: string;
+        createdAt: string;
+    }>;
+    /** Number of stored entries. */
+    count(): number;
+    /** Flush to disk (atomic: temp file + rename). */
+    private persist;
+    close(): void;
+}

package/dist/ccr-store.js

@@ -0,0 +1,171 @@
+"use strict";
+// adr: adr/crush-engine.md
+/**
+ * CCR (Cached Content Retrieval) store — local sqlite stash for tool
+ * output the crush engine elided. `greprag crush --ccr` puts the
+ * original here and appends a `<<ccr:HASH>>` marker; `greprag retrieve
+ * <hash>` reads it back. Chip D's PNG-archive indexing consumes the
+ * same API — keep it stable.
+ *
+ * Backed by sql.js (the CLI's existing sqlite dep — WASM, no native
+ * build). The DB lives at ~/.greprag/ccr.db; override with
+ * GREPRAG_CCR_DB (tests point it at a temp file).
+ *
+ * Keys are sha256: the full 64-hex digest is stored; lookups accept any
+ * unique prefix >= 16 hex chars (the marker carries the first 16).
+ */
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CcrStore = exports.CCR_MARKER_HASH_LEN = void 0;
+exports.defaultCcrDbPath = defaultCcrDbPath;
+exports.ccrMarker = ccrMarker;
+const crypto = __importStar(require("crypto"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const sql_js_1 = __importDefault(require("sql.js"));
+/** Marker appended to crushed output: first 16 hex of the sha256. */
+exports.CCR_MARKER_HASH_LEN = 16;
+function defaultCcrDbPath() {
+    return process.env.GREPRAG_CCR_DB || path.join(os.homedir(), '.greprag', 'ccr.db');
+}
+function ccrMarker(hash) {
+    return `<<ccr:${hash.slice(0, exports.CCR_MARKER_HASH_LEN)}>>`;
+}
+let sqlJs = null;
+async function loadSqlJs() {
+    if (!sqlJs) {
+        sqlJs = await (0, sql_js_1.default)({
+            locateFile: (f) => path.join(path.dirname(require.resolve('sql.js')), f),
+        });
+    }
+    return sqlJs;
+}
+class CcrStore {
+    constructor(db, dbPath) {
+        this.db = db;
+        this.dbPath = dbPath;
+    }
+    /** Open (creating file + schema as needed). */
+    static async open(dbPath) {
+        const resolved = dbPath || defaultCcrDbPath();
+        const SQL = await loadSqlJs();
+        let db;
+        if (fs.existsSync(resolved)) {
+            db = new SQL.Database(fs.readFileSync(resolved));
+        }
+        else {
+            db = new SQL.Database();
+        }
+        db.run(`CREATE TABLE IF NOT EXISTS ccr_entries (
+      hash TEXT PRIMARY KEY,
+      content TEXT NOT NULL,
+      source_type TEXT,
+      created_at TEXT NOT NULL
+    )`);
+        return new CcrStore(db, resolved);
+    }
+    /**
+     * Store an original. Returns the first 16 hex chars of its sha256 —
+     * the marker-friendly key. Idempotent (same content -> same hash).
+     */
+    put(original, sourceType) {
+        const fullHash = crypto.createHash('sha256').update(original, 'utf8').digest('hex');
+        this.db.run('INSERT OR IGNORE INTO ccr_entries (hash, content, source_type, created_at) VALUES (?, ?, ?, ?)', [fullHash, original, sourceType ?? null, new Date().toISOString()]);
+        this.persist();
+        return fullHash.slice(0, exports.CCR_MARKER_HASH_LEN);
+    }
+    /**
+     * Retrieve an original by hash (full digest or any prefix >= 8 hex).
+     * Returns null when not found or ambiguous-by-prefix.
+     */
+    get(hash) {
+        const needle = hash.trim().toLowerCase().replace(/^<<ccr:/, '').replace(/>>$/, '');
+        if (!/^[0-9a-f]{8,64}$/.test(needle))
+            return null;
+        const stmt = this.db.prepare("SELECT content FROM ccr_entries WHERE hash LIKE ? || '%' LIMIT 2");
+        const rows = [];
+        try {
+            stmt.bind([needle]);
+            while (stmt.step()) {
+                rows.push(stmt.get()[0]);
+            }
+        }
+        finally {
+            stmt.free();
+        }
+        return rows.length === 1 ? rows[0] : null;
+    }
+    /** All entries of one source_type, newest first. Additive for Chip D:
+     *  'png-archive' rows hold JSON metadata (file path + char/turn ranges)
+     *  pointing at rendered archive pages — `greprag archive list` reads
+     *  them back out. */
+    listBySourceType(sourceType) {
+        const stmt = this.db.prepare('SELECT hash, content, created_at FROM ccr_entries WHERE source_type = ? ORDER BY created_at DESC');
+        const rows = [];
+        try {
+            stmt.bind([sourceType]);
+            while (stmt.step()) {
+                const [hash, content, createdAt] = stmt.get();
+                rows.push({ hash, content, createdAt });
+            }
+        }
+        finally {
+            stmt.free();
+        }
+        return rows;
+    }
+    /** Number of stored entries. */
+    count() {
+        const res = this.db.exec('SELECT COUNT(*) FROM ccr_entries');
+        return Number(res[0]?.values?.[0]?.[0] ?? 0);
+    }
+    /** Flush to disk (atomic: temp file + rename). */
+    persist() {
+        const dir = path.dirname(this.dbPath);
+        fs.mkdirSync(dir, { recursive: true });
+        const tmp = this.dbPath + '.tmp.' + process.pid;
+        fs.writeFileSync(tmp, Buffer.from(this.db.export()));
+        fs.renameSync(tmp, this.dbPath);
+    }
+    close() {
+        this.db.close();
+    }
+}
+exports.CcrStore = CcrStore;
+//# sourceMappingURL=ccr-store.js.map

package/dist/ccr-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ccr-store.js","sourceRoot":"","sources":["../src/ccr-store.ts"],"names":[],"mappings":";AAAA,2BAA2B;AAC3B;;;;;;;;;;;;;GAaG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWH,4CAEC;AAED,8BAEC;AAfD,+CAAiC;AACjC,uCAAyB;AACzB,uCAAyB;AACzB,2CAA6B;AAC7B,oDAA0D;AAE1D,qEAAqE;AACxD,QAAA,mBAAmB,GAAG,EAAE,CAAC;AAEtC,SAAgB,gBAAgB;IAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AACrF,CAAC;AAED,SAAgB,SAAS,CAAC,IAAY;IACpC,OAAO,SAAS,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,2BAAmB,CAAC,IAAI,CAAC;AACzD,CAAC;AAED,IAAI,KAAK,GAAuB,IAAI,CAAC;AAErC,KAAK,UAAU,SAAS;IACtB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,GAAG,MAAM,IAAA,gBAAS,EAAC;YACtB,UAAU,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;SACjF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAa,QAAQ;IACnB,YACU,EAAY,EACZ,MAAc;QADd,OAAE,GAAF,EAAE,CAAU;QACZ,WAAM,GAAN,MAAM,CAAQ;IACrB,CAAC;IAEJ,+CAA+C;IAC/C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAe;QAC/B,MAAM,QAAQ,GAAG,MAAM,IAAI,gBAAgB,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,MAAM,SAAS,EAAE,CAAC;QAC9B,IAAI,EAAY,CAAC;QACjB,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,EAAE,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,EAAE,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC1B,CAAC;QACD,EAAE,CAAC,GAAG,CAAC;;;;;MAKL,CAAC,CAAC;QACJ,OAAO,IAAI,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,QAAgB,EAAE,UAAmB;QACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpF,IAAI,CAAC,EAAE,CAAC,GAAG,CACT,gGAAgG,EAChG,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,IAAI,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CACnE,CAAC;QACF,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,2BAAmB,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,IAAY;QACd,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,kEAAkE,CAAC,CAAC;QACjG,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YACpB,OAAO,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBACnB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAW,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5C,CAAC;IAED;;;yBAGqB;IACrB,gBAAgB,CAAC,UAAkB;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,kGAAkG,CACnG,CAAC;QACF,MAAM,IAAI,GAAgE,EAAE,CAAC;QAC7E,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;YACxB,OAAO,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBACnB,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC,GAAG,EAA8B,CAAC;gBAC1E,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gCAAgC;IAChC,KAAK;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAC7D,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,kDAAkD;IAC1C,OAAO;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;QAChD,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACrD,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF;AAlGD,4BAkGC"}

package/dist/commands/archive.d.ts

@@ -0,0 +1,81 @@
+/** greprag archive — the governed compact's PNG archive.
+ *
+ *  Before compaction summarizes history away, the PreCompact hook renders
+ *  the transcript's main chain to dense pixel-font PNGs (Snapcompact
+ *  pattern: ~3x token density via the vision path) and indexes every page
+ *  in the CCR store. After compaction, a SessionStart(matcher=compact)
+ *  hook injects a pointer so the post-compact model knows the verbatim
+ *  record exists and can Read the pages back.
+ *
+ *  Verified hook contract (2026-06-12, code.claude.com/docs/en/hooks):
+ *  PreCompact CANNOT inject or modify compaction instructions — so the
+ *  instructions ship as a documented `/compact <snippet>` block
+ *  (`greprag archive snippet`) referenced by the context governor's
+ *  advisory, and the post-compact pointer rides SessionStart(compact),
+ *  whose stdout/additionalContext IS added to context.
+ *
+ *  Surfaces:
+ *    greprag archive render --transcript <path> [--out-dir <dir>] [--session <8hex>]
+ *    greprag archive list [--session <8hex>]
+ *    greprag archive snippet [--session <8hex>]
+ *    hook: runPreCompactArchive (PreCompact), buildArchivePointer (SessionStart)
+ */
+export declare const SOURCE_TYPE = "png-archive";
+export declare const ARCHIVE_HELP: string;
+export declare function archiveEnabled(cwd: string): boolean;
+export declare function defaultArchiveDir(session: string): string;
+/** Page metadata stored as the CCR row's content. Deliberately contains no
+ *  timestamp: identical content -> identical JSON -> identical sha256 key,
+ *  so re-rendering the same transcript state never duplicates rows. */
+export interface PageMeta {
+    kind: typeof SOURCE_TYPE;
+    session: string;
+    renderId: string;
+    file: string;
+    page: number;
+    pages: number;
+    charStart: number;
+    charEnd: number;
+    chars: number;
+    turnStart: number;
+    turnEnd: number;
+}
+export interface RenderSummary {
+    session: string;
+    outDir: string;
+    renderId: string;
+    pages: number;
+    chars: number;
+    turns: number;
+    files: string[];
+    /** null = every page passed the pixel round-trip self-test. */
+    selfTestError: string | null;
+}
+/** Render a transcript to PNG pages, self-test, write, and index. */
+export declare function renderArchive(opts: {
+    transcriptPath: string;
+    outDir?: string;
+    session?: string;
+}): Promise<RenderSummary | null>;
+interface ArchiveGroup {
+    session: string;
+    renderId: string;
+    createdAt: string;
+    pages: PageMeta[];
+}
+export declare function listArchives(session?: string | null): Promise<ArchiveGroup[]>;
+export declare function buildCompactSnippet(session: string): string;
+export interface ArchiveHookInput {
+    session_id?: string;
+    transcript_path?: string;
+    trigger?: string;
+    cwd?: string;
+}
+/** PreCompact — render + index, return a user-facing systemMessage (or null
+ *  when disabled/empty/failed). NEVER throws; never blocks compaction. */
+export declare function runPreCompactArchive(input: ArchiveHookInput): Promise<string | null>;
+/** SessionStart(matcher=compact) — pointer for the post-compact model.
+ *  Returns additionalContext text, or null when no archive exists. */
+export declare function buildArchivePointer(input: ArchiveHookInput): Promise<string | null>;
+export declare function runArchive(args: string[]): Promise<void>;
+export {};