@saleem11kh/repomem 0.3.1 → 0.5.0

package/dist/store/adr.js

@@ -0,0 +1,201 @@
+"use strict";
+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.findAdrs = findAdrs;
+exports.importAdrs = importAdrs;
+/**
+ * Import Architecture Decision Records that a repo already has.
+ *
+ * A project with docs/adr/0001-use-postgres.md is not a project without
+ * decisions — it is a project whose decisions repomem cannot see. These are
+ * already structured and already authored, so they are copied in directly. No
+ * model, no distillation, no judgement required.
+ *
+ * Prose docs (README, ARCHITECTURE) still need an agent to distil — that is what
+ * mem_prime is for. This handles only the part that is already decision-shaped.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const file_store_js_1 = require("./file-store.js");
+// Where ADRs conventionally live. Checked in order; all matches are imported.
+const ADR_DIRS = [
+    "docs/adr",
+    "docs/adrs",
+    "docs/decisions",
+    "docs/architecture/decisions",
+    "adr",
+    "adrs",
+    "decisions",
+    "rfcs",
+    "docs/rfcs",
+];
+const MAX_ADRS = 50;
+const MAX_BODY_CHARS = 8000;
+/** First markdown H1, else a title derived from the filename. */
+function titleOf(raw, filename) {
+    const h1 = raw.match(/^#\s+(.+)$/m);
+    if (h1)
+        return h1[1].trim();
+    return filename
+        .replace(/\.md$/i, "")
+        .replace(/^\d+[-_]/, "")
+        .replace(/[-_]+/g, " ")
+        .trim();
+}
+/** MADR and Nygard both record a status line; missing is fine. */
+function statusOf(raw) {
+    const fm = raw.match(/^status:\s*(.+)$/im);
+    if (fm)
+        return fm[1].trim().replace(/^["']|["']$/g, "");
+    const heading = raw.match(/^##\s*Status\s*\n+([^\n#]+)/im);
+    return heading ? heading[1].trim() : "";
+}
+function dateOf(raw, filePath) {
+    const fm = raw.match(/^date:\s*(\d{4}-\d{2}-\d{2})/im);
+    if (fm)
+        return fm[1];
+    const inText = raw.match(/\b(\d{4}-\d{2}-\d{2})\b/);
+    if (inText)
+        return inText[1];
+    try {
+        return new Date(fs.statSync(filePath).mtime).toISOString().slice(0, 10);
+    }
+    catch {
+        return "1970-01-01";
+    }
+}
+/** Strip YAML front matter so the imported body starts at real content. */
+function stripFrontMatter(raw) {
+    if (!raw.startsWith("---"))
+        return raw;
+    const end = raw.indexOf("\n---", 3);
+    if (end === -1)
+        return raw;
+    const after = raw.indexOf("\n", end + 1);
+    return after === -1 ? "" : raw.slice(after + 1);
+}
+/** Find ADR-shaped markdown files anywhere the ecosystem conventionally puts them. */
+function findAdrs(projectRoot) {
+    const found = [];
+    const seen = new Set();
+    for (const dir of ADR_DIRS) {
+        const abs = path.join(projectRoot, dir);
+        let entries;
+        try {
+            entries = fs.readdirSync(abs);
+        }
+        catch {
+            continue;
+        }
+        for (const name of entries.sort()) {
+            if (found.length >= MAX_ADRS)
+                return found;
+            if (!/\.md$/i.test(name))
+                continue;
+            // Index and template files are scaffolding, not decisions.
+            if (/^(readme|index|template|_template|0000)/i.test(name))
+                continue;
+            const filePath = path.join(abs, name);
+            const raw = fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf8") : "";
+            if (!raw.trim())
+                continue;
+            const rel = path.join(dir, name).replace(/\\/g, "/");
+            if (seen.has(rel))
+                continue;
+            seen.add(rel);
+            found.push({
+                rel,
+                title: titleOf(raw, name),
+                status: statusOf(raw),
+                date: dateOf(raw, filePath),
+                body: stripFrontMatter(raw).trim().slice(0, MAX_BODY_CHARS),
+            });
+        }
+    }
+    return found;
+}
+function slugify(title) {
+    return (title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 60) || "adr");
+}
+/** Source paths already imported, read back from `source:` front matter. */
+function importedSources(projectRoot) {
+    const sources = new Set();
+    for (const filename of (0, file_store_js_1.listFiles)("decisions", projectRoot)) {
+        const raw = (0, file_store_js_1.readFile)("decisions", filename, projectRoot) ?? "";
+        const m = raw.match(/^source:\s*(.+)$/m);
+        if (m)
+            sources.add(m[1].trim());
+    }
+    return sources;
+}
+/**
+ * Copy discovered ADRs into decisions/. Each imported entry records `source:`,
+ * so re-running is safe: an ADR already imported is skipped rather than
+ * duplicated. Entries are marked `generated: true` — they are derived, and a
+ * human editing them would lose the edit on the next import.
+ */
+function importAdrs(projectRoot) {
+    const already = importedSources(projectRoot);
+    const imported = [];
+    let skipped = 0;
+    for (const adr of findAdrs(projectRoot)) {
+        if (already.has(adr.rel)) {
+            skipped += 1;
+            continue;
+        }
+        const filename = `${adr.date}-${slugify(adr.title)}.md`;
+        const summary = adr.status
+            ? `${adr.status} — imported from ${adr.rel}`
+            : `Imported from ${adr.rel}`;
+        const front = [
+            "---",
+            `date: ${adr.date}`,
+            `summary: ${summary}`,
+            "tags: [adr, imported]",
+            `source: ${adr.rel}`,
+            "generated: true",
+            "---",
+            "",
+        ].join("\n");
+        (0, file_store_js_1.writeFile)("decisions", filename, `${front}# ${adr.title}\n\n${adr.body}\n`, {}, projectRoot);
+        imported.push(`decisions/${filename}`);
+    }
+    return { imported, skipped };
+}
+//# sourceMappingURL=adr.js.map

package/dist/store/adr.js.map

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

package/dist/store/capture.d.ts

@@ -0,0 +1,39 @@
+export interface CaptureMarker {
+    at: string;
+    /** Digest of the uncommitted file set at the last capture. */
+    fingerprint: string;
+    /**
+     * HEAD at the last capture. Commits are counted as `head..HEAD`, which is
+     * exact — `--since` only resolves to the minute, so a commit made in the same
+     * minute as the marker looks new on every later run.
+     */
+    head?: string;
+}
+export declare function readMarker(projectRoot: string): CaptureMarker;
+/**
+ * Record that capture ran. The cache is gitignored — a marker is local state
+ * about this machine, not memory to share with the team.
+ */
+export declare function writeMarker(projectRoot: string, marker: CaptureMarker): void;
+export interface CapturePlan {
+    since: string;
+    summary: string;
+    /** False when there is nothing new — capture must then write nothing at all. */
+    worthWriting: boolean;
+    /** Marker to persist once the capture has been written. */
+    marker: CaptureMarker;
+}
+/**
+ * What an unattended capture would record.
+ *
+ * Commits are events: anything inside the window is new by definition. Uncommitted
+ * files are *state* — they survive from one capture to the next, so writing a
+ * session every time any exist would fill sessions/ with near-identical files.
+ * They therefore only justify a capture when the set has actually changed, which
+ * is what the fingerprint tracks.
+ *
+ * A summary assembled from git facts is a poor substitute for one written with
+ * judgement, so it says so plainly rather than pretending to understand the work.
+ */
+export declare function planCapture(projectRoot: string, now?: Date): CapturePlan;
+//# sourceMappingURL=capture.d.ts.map

package/dist/store/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/store/capture.ts"],"names":[],"mappings":"AAoCA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAc7D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAQ5E;AAOD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,YAAY,EAAE,OAAO,CAAC;IACtB,2DAA2D;IAC3D,MAAM,EAAE,aAAa,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,WAAW,CAqCpF"}

package/dist/store/capture.js

@@ -0,0 +1,148 @@
+"use strict";
+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.readMarker = readMarker;
+exports.writeMarker = writeMarker;
+exports.planCapture = planCapture;
+/**
+ * Unattended session capture.
+ *
+ * repomem's oldest gap is that nothing is recorded unless someone remembers to
+ * ask. MCP servers are passive, so the fix cannot live in the server — it has to
+ * be something the harness fires. `repomem capture` is that something: a
+ * standalone command an agent hook (or a cron, or a shell alias) can run to
+ * record what happened, with no model in the loop.
+ *
+ * It runs in its own process, so it has no session to measure from. A marker
+ * under .repomem/.cache/ records when it last ran, and that becomes the window.
+ */
+const crypto = __importStar(require("crypto"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const file_store_js_1 = require("./file-store.js");
+const git_js_1 = require("./git.js");
+const MARKER = "last-capture.json";
+/** First run has no marker. Look back far enough to catch a day's work. */
+const COLD_START_HOURS = 12;
+function cacheDir(projectRoot) {
+    return path.join((0, file_store_js_1.getRepomemRoot)(projectRoot), ".cache");
+}
+/** Format for git's --since and our own front matter: "YYYY-MM-DD HH:MM". */
+function stamp(d) {
+    const pad = (n) => String(n).padStart(2, "0");
+    return (`${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ` +
+        `${pad(d.getHours())}:${pad(d.getMinutes())}`);
+}
+function readMarker(projectRoot) {
+    try {
+        const raw = fs.readFileSync(path.join(cacheDir(projectRoot), MARKER), "utf8");
+        const parsed = JSON.parse(raw);
+        if (parsed.at) {
+            return { at: parsed.at, fingerprint: parsed.fingerprint ?? "", head: parsed.head };
+        }
+    }
+    catch {
+        /* never captured here, or the marker is unreadable */
+    }
+    return {
+        at: stamp(new Date(Date.now() - COLD_START_HOURS * 60 * 60 * 1000)),
+        fingerprint: "",
+    };
+}
+/**
+ * Record that capture ran. The cache is gitignored — a marker is local state
+ * about this machine, not memory to share with the team.
+ */
+function writeMarker(projectRoot, marker) {
+    const dir = cacheDir(projectRoot);
+    fs.mkdirSync(dir, { recursive: true });
+    const gitignore = path.join(dir, ".gitignore");
+    if (!fs.existsSync(gitignore)) {
+        fs.writeFileSync(gitignore, "# repomem local cache — do not commit\n*\n", "utf8");
+    }
+    fs.writeFileSync(path.join(dir, MARKER), JSON.stringify(marker, null, 2) + "\n", "utf8");
+}
+function fingerprintOf(changed) {
+    if (!changed.length)
+        return "";
+    return crypto.createHash("sha1").update([...changed].sort().join("\n")).digest("hex");
+}
+/**
+ * What an unattended capture would record.
+ *
+ * Commits are events: anything inside the window is new by definition. Uncommitted
+ * files are *state* — they survive from one capture to the next, so writing a
+ * session every time any exist would fill sessions/ with near-identical files.
+ * They therefore only justify a capture when the set has actually changed, which
+ * is what the fingerprint tracks.
+ *
+ * A summary assembled from git facts is a poor substitute for one written with
+ * judgement, so it says so plainly rather than pretending to understand the work.
+ */
+function planCapture(projectRoot, now = new Date()) {
+    const previous = readMarker(projectRoot);
+    const activity = (0, git_js_1.activitySince)(previous.at, projectRoot, previous.head);
+    const fingerprint = fingerprintOf(activity?.changed ?? []);
+    const marker = {
+        at: stamp(now),
+        fingerprint,
+        head: (0, git_js_1.headHash)(projectRoot) ?? undefined,
+    };
+    if (!activity)
+        return { since: previous.at, summary: "", worthWriting: false, marker };
+    const newCommits = activity.commits.length > 0;
+    const changedSet = activity.changed.length > 0 && fingerprint !== previous.fingerprint;
+    if (!newCommits && !changedSet) {
+        return { since: previous.at, summary: "", worthWriting: false, marker };
+    }
+    const parts = [];
+    if (activity.commits.length) {
+        const n = activity.commits.length + activity.moreCommits;
+        parts.push(`${n} commit${n === 1 ? "" : "s"}`);
+    }
+    if (activity.changed.length) {
+        const n = activity.changed.length + activity.moreChanged;
+        parts.push(`${n} file${n === 1 ? "" : "s"} left uncommitted`);
+    }
+    return {
+        since: previous.at,
+        summary: `Auto-captured from git — ${parts.join(", ")}` +
+            `${activity.branch ? ` on ${activity.branch}` : ""}. ` +
+            "No summary was written by hand, so the intent behind this work is not recorded.",
+        worthWriting: true,
+        marker,
+    };
+}
+//# sourceMappingURL=capture.js.map

package/dist/store/capture.js.map

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

package/dist/store/embeddings.d.ts

@@ -0,0 +1,34 @@
+import { SemanticConfig } from "../config/config.js";
+export interface EmbeddingCache {
+    /** Which provider and model produced these vectors; a change invalidates all. */
+    signature: string;
+    entries: Record<string, {
+        hash: string;
+        vector: number[];
+    }>;
+}
+export declare function readCache(projectRoot: string): EmbeddingCache | null;
+export declare function embed(text: string, config: SemanticConfig): Promise<number[]>;
+export declare function cosine(a: number[], b: number[]): number;
+export interface IndexResult {
+    embedded: number;
+    reused: number;
+    removed: number;
+    failed: string[];
+}
+/**
+ * Bring the vector cache up to date. Only entries whose content hash changed are
+ * re-embedded, so a second run over an unchanged repo makes no provider calls.
+ */
+export declare function buildIndex(projectRoot: string, config: SemanticConfig): Promise<IndexResult>;
+/**
+ * Cosine similarity of every cached entry against the query, keyed "type/filename".
+ *
+ * Returns an empty map — never throws — when semantic search is off, the cache is
+ * missing or stale, or the provider is unreachable. Search degrading to BM25 is
+ * always better than search failing.
+ */
+export declare function semanticScores(query: string, projectRoot: string, config: SemanticConfig): Promise<Map<string, number>>;
+/** Scale scores to 0–1 so lexical and semantic ranks can be blended fairly. */
+export declare function normalise(scores: Map<string, number>): Map<string, number>;
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/store/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/store/embeddings.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAQrD,MAAM,WAAW,cAAc;IAC7B,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC7D;AAcD,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAQpE;AAiED,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAInF;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAYvD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,WAAW,CAAC,CAyCtB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAiB9B;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAO1E"}