greprag 5.73.1 → 5.73.2

package/dist/doc-mirror-client.js

@@ -0,0 +1,285 @@
+"use strict";
+/** Client-side project document mirror helpers.
+ *
+ * One rule set feeds:
+ * - `greprag doc mirror sync` / `greprag doc update`
+ * - Stop-hook touched-doc upserts
+ * - `greprag load` / `greprag status` freshness warnings
+ */
+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.MAX_DOC_CHARS = void 0;
+exports.normalizeDocRel = normalizeDocRel;
+exports.isDocMirrorEligible = isDocMirrorEligible;
+exports.titleFromMarkdown = titleFromMarkdown;
+exports.tagsFromPath = tagsFromPath;
+exports.docContentHash = docContentHash;
+exports.collectDocMirrorInventory = collectDocMirrorInventory;
+exports.collectTouchedDocMirrorDocs = collectTouchedDocMirrorDocs;
+exports.computeDocMirrorFreshness = computeDocMirrorFreshness;
+exports.fetchDocMirrorSummaries = fetchDocMirrorSummaries;
+exports.formatDocMirrorFreshness = formatDocMirrorFreshness;
+const crypto = __importStar(require("node:crypto"));
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const docptr_refs_1 = require("./docptr-refs");
+const proc_1 = require("./proc");
+exports.MAX_DOC_CHARS = 600_000;
+const MAX_FILESYSTEM_DOCS = 2_000;
+const REF_SCAN_CHARS = 4_000;
+function normalizeDocRel(input) {
+    return (input || '')
+        .replace(/\\/g, '/')
+        .replace(/^\.\//, '')
+        .replace(/^\/+/, '')
+        .replace(/\/+/g, '/')
+        .trim();
+}
+function isDocMirrorEligible(relPath) {
+    const p = normalizeDocRel(relPath);
+    if (!p.toLowerCase().endsWith('.md'))
+        return false;
+    const segments = p.split('/');
+    const base = segments[segments.length - 1] || '';
+    const lowerBase = base.toLowerCase();
+    if (lowerBase === 'claude.md' || lowerBase === 'memory.md')
+        return false;
+    for (const seg of segments.slice(0, -1)) {
+        if (!seg)
+            return false;
+        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 = normalizeDocRel(relPath).split('/').pop() || relPath;
+    return base.replace(/\.md$/i, '').replace(/[-_]+/g, ' ').trim() || relPath;
+}
+function tagsFromPath(relPath) {
+    const stop = new Set(['docs', 'doc', 'adr', 'readme', 'md', 'index']);
+    const tokens = normalizeDocRel(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 docContentHash(content) {
+    return crypto.createHash('sha256').update(content).digest('hex');
+}
+function gitLsFiles(cwd) {
+    try {
+        const out = (0, proc_1.safeExecFileSync)('git', ['ls-files'], {
+            cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        return out.split(/\r?\n/).map(normalizeDocRel).filter(Boolean);
+    }
+    catch {
+        return null;
+    }
+}
+function walkMarkdownFiles(cwd, maxDocs = MAX_FILESYSTEM_DOCS) {
+    const files = [];
+    let truncated = false;
+    const visit = (dir) => {
+        if (truncated)
+            return;
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (truncated)
+                return;
+            const abs = path.join(dir, entry.name);
+            const rel = normalizeDocRel(path.relative(cwd, abs));
+            if (entry.isDirectory()) {
+                if (entry.name.startsWith('.'))
+                    continue;
+                if (entry.name === 'node_modules' || entry.name === 'dist'
+                    || entry.name === 'build' || entry.name === 'vendor')
+                    continue;
+                visit(abs);
+            }
+            else if (entry.isFile() && isDocMirrorEligible(rel)) {
+                files.push(rel);
+                if (files.length >= maxDocs)
+                    truncated = true;
+            }
+        }
+    };
+    visit(cwd);
+    return { files, truncated };
+}
+function touchedToRel(cwd, filePath) {
+    const abs = path.isAbsolute(filePath) ? filePath : path.resolve(cwd, filePath);
+    const rel = normalizeDocRel(path.relative(cwd, abs));
+    if (!rel || rel.startsWith('../') || path.isAbsolute(rel))
+        return null;
+    return rel;
+}
+function buildCollection(cwd, relPaths, source, presentForRefs, gitAvailable, truncated = false) {
+    const docs = [];
+    const skipped = [];
+    const seen = new Set();
+    for (const raw of relPaths) {
+        const rel = normalizeDocRel(raw);
+        if (!isDocMirrorEligible(rel) || seen.has(rel))
+            continue;
+        seen.add(rel);
+        try {
+            const content = fs.readFileSync(path.join(cwd, rel), 'utf-8');
+            if (!content.trim()) {
+                skipped.push({ path: rel, reason: 'empty' });
+                continue;
+            }
+            if (content.length > exports.MAX_DOC_CHARS) {
+                skipped.push({ path: rel, reason: 'too large' });
+                continue;
+            }
+            docs.push({
+                path: rel,
+                content,
+                title: titleFromMarkdown(content, rel),
+                tags: tagsFromPath(rel),
+                refs: presentForRefs.size ? (0, docptr_refs_1.extractDocRefs)(content.slice(0, REF_SCAN_CHARS), rel, cwd, presentForRefs) : [],
+                contentHash: docContentHash(content),
+            });
+        }
+        catch {
+            skipped.push({ path: rel, reason: 'unreadable' });
+        }
+    }
+    return {
+        source,
+        docs: docs.sort((a, b) => a.path.localeCompare(b.path)),
+        presentPaths: Array.from(seen).sort(),
+        skipped,
+        gitAvailable,
+        truncated,
+    };
+}
+function collectDocMirrorInventory(cwd) {
+    const tracked = gitLsFiles(cwd);
+    if (tracked) {
+        return buildCollection(cwd, tracked.filter(isDocMirrorEligible), 'git', new Set(tracked), true);
+    }
+    const walked = walkMarkdownFiles(cwd);
+    return buildCollection(cwd, walked.files, 'filesystem', new Set(), false, walked.truncated);
+}
+function collectTouchedDocMirrorDocs(filesTouched, cwd) {
+    const tracked = gitLsFiles(cwd);
+    const presentForRefs = tracked ? new Set(tracked) : new Set();
+    const rels = filesTouched
+        .map((f) => touchedToRel(cwd, f))
+        .filter((f) => !!f && isDocMirrorEligible(f));
+    return buildCollection(cwd, rels, tracked ? 'git' : 'filesystem', presentForRefs, !!tracked);
+}
+function computeDocMirrorFreshness(local, remoteDocs) {
+    const remote = new Map();
+    for (const doc of remoteDocs) {
+        const rel = normalizeDocRel(doc.path);
+        if (rel)
+            remote.set(rel, doc.contentHash || '');
+    }
+    const localMap = new Map(local.docs.map((doc) => [doc.path, doc.contentHash]));
+    const changed = [];
+    const missing = [];
+    for (const doc of local.docs) {
+        if (!remote.has(doc.path))
+            missing.push(doc.path);
+        else if (remote.get(doc.path) && remote.get(doc.path) !== doc.contentHash)
+            changed.push(doc.path);
+    }
+    const removed = Array.from(remote.keys()).filter((rel) => !localMap.has(rel)).sort();
+    const stale = changed.length + missing.length + removed.length;
+    return {
+        status: remote.size === 0 && local.docs.length > 0 ? 'empty' : stale > 0 ? 'stale' : 'fresh',
+        source: local.source,
+        localCount: local.docs.length,
+        remoteCount: remote.size,
+        changed,
+        missing,
+        removed,
+        skipped: local.skipped,
+        truncated: local.truncated,
+        ...(!local.gitAvailable ? { note: 'using filesystem fallback; git is unavailable' } : {}),
+    };
+}
+async function fetchDocMirrorSummaries(apiUrl, apiKey, projectId, timeoutMs = 4_000) {
+    try {
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), timeoutMs);
+        const res = await fetch(`${apiUrl}/v1/doc/${projectId}/list`, {
+            headers: { 'Authorization': `Bearer ${apiKey}` },
+            signal: ctrl.signal,
+        });
+        clearTimeout(timer);
+        if (!res.ok)
+            return null;
+        const data = await res.json();
+        return Array.isArray(data.docs) ? data.docs : [];
+    }
+    catch {
+        return null;
+    }
+}
+function formatDocMirrorFreshness(report) {
+    const source = report.source === 'filesystem' ? 'filesystem fallback' : report.source;
+    if (report.status === 'unknown')
+        return 'Doc mirror: unknown — could not check the remote mirror.';
+    if (report.status === 'empty') {
+        return `Doc mirror: empty — ${report.localCount} local doc(s) found via ${source}. Run: greprag doc update`;
+    }
+    if (report.status === 'fresh') {
+        return `Doc mirror: fresh — ${report.localCount} doc(s) mirrored via ${source}.`;
+    }
+    const parts = [
+        report.changed.length ? `${report.changed.length} changed` : '',
+        report.missing.length ? `${report.missing.length} new` : '',
+        report.removed.length ? `${report.removed.length} removed` : '',
+    ].filter(Boolean).join(', ');
+    return `Doc mirror: stale — ${parts || 'local and remote differ'}. Run: greprag doc update`;
+}
+//# sourceMappingURL=doc-mirror-client.js.map

package/dist/doc-mirror-client.js.map

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

package/dist/hook.js

@@ -132,6 +132,7 @@ const procedure_watch_1 = require("./procedure-watch");
 const inline_atom_hook_1 = require("./inline-atom-hook");
 const skill_landing_1 = require("./skill-landing");
 const skill_mirror_client_1 = require("./skill-mirror-client");
+const doc_mirror_client_1 = require("./doc-mirror-client");
 const equipped_loadouts_cache_1 = require("./equipped-loadouts-cache");
 const codex_chip_hooks_1 = require("./codex-chip-hooks");
 const API_URL_DEFAULT = 'https://api.greprag.com';
@@ -1215,6 +1216,20 @@ async function store(input, source = 'claude-code') {
         }
         catch { /* best-effort — a docptr outage never fails the Stop hook */ }
     }
+    // Doc Mirror sibling: exact touched Markdown bodies shadow into the project
+    // docs store. Uses API upsert mode so one touched doc cannot prune the rest
+    // of the mirror. Full deletion/reconciliation remains `greprag doc update`.
+    try {
+        const mirror = (0, doc_mirror_client_1.collectTouchedDocMirrorDocs)(turn.filesTouched, cwd);
+        if (mirror.docs.length > 0) {
+            await apiCall(`${cfg.apiUrl}/v1/doc/${anchor.projectId}/mirror`, cfg.apiKey, {
+                projectName: anchor.projectName,
+                docs: mirror.docs.map(({ contentHash: _contentHash, ...doc }) => doc),
+                mode: 'upsert',
+            });
+        }
+    }
+    catch { /* best-effort — a doc mirror miss never fails the Stop hook */ }
     // Procedure System episode observer (docs/procedure-system.md V1 LEARN leg):
     // gated on "a watch file exists" — zero cost when no watch is open. One
     // synchronous flash-lite continuity call per observed turn; close/watchdog