@mneme-ai/core 0.8.3

package/dist/git/blame.js

@@ -0,0 +1,56 @@
+import { execGit } from "./exec.js";
+export async function blame(cwd, filePath, startLine, endLine) {
+    const args = ["blame", "--porcelain"];
+    if (startLine && endLine)
+        args.push("-L", `${startLine},${endLine}`);
+    args.push(filePath);
+    const r = await execGit(args, { cwd });
+    if (r.code !== 0)
+        return [];
+    return parseBlamePorcelain(r.stdout);
+}
+function parseBlamePorcelain(raw) {
+    const lines = raw.split("\n");
+    const commitMeta = new Map();
+    const result = [];
+    let i = 0;
+    while (i < lines.length) {
+        const header = lines[i];
+        if (!header) {
+            i++;
+            continue;
+        }
+        const m = header.match(/^([0-9a-f]{40}) \d+ (\d+)(?: \d+)?$/);
+        if (!m) {
+            i++;
+            continue;
+        }
+        const hash = m[1];
+        const lineNum = Number(m[2]);
+        let meta = commitMeta.get(hash);
+        if (!meta) {
+            meta = {};
+            commitMeta.set(hash, meta);
+        }
+        i++;
+        while (i < lines.length && !lines[i].startsWith("\t")) {
+            const ln = lines[i];
+            if (ln.startsWith("author "))
+                meta.author = ln.slice(7);
+            else if (ln.startsWith("author-time "))
+                meta.authorTime = Number(ln.slice(12));
+            i++;
+        }
+        const content = lines[i]?.slice(1) ?? "";
+        result.push({
+            commitHash: hash,
+            authorName: meta.author ?? "",
+            authorTime: meta.authorTime ?? 0,
+            lineNumber: lineNum,
+            content,
+        });
+        i++;
+    }
+    return result;
+}
+//# sourceMappingURL=blame.js.map

package/dist/git/blame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blame.js","sourceRoot":"","sources":["../../src/git/blame.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,GAAW,EACX,QAAgB,EAChB,SAAkB,EAClB,OAAgB;IAEhB,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACtC,IAAI,SAAS,IAAI,OAAO;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,SAAS,IAAI,OAAO,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEpB,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACvC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5B,OAAO,mBAAmB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAW;IACtC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAoD,CAAC;IAC/E,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QACD,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC9D,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACnB,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,EAAE,CAAC;YACV,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,CAAC,EAAE,CAAC;QACJ,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACvD,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;YACrB,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;gBAAE,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;iBACnD,IAAI,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC;gBAAE,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/E,CAAC,EAAE,CAAC;QACN,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC;YACV,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,CAAC;YAChC,UAAU,EAAE,OAAO;YACnB,OAAO;SACR,CAAC,CAAC;QACH,CAAC,EAAE,CAAC;IACN,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/git/exec.d.ts

@@ -0,0 +1,13 @@
+export interface ExecOptions {
+    cwd: string;
+    maxBuffer?: number;
+    env?: NodeJS.ProcessEnv;
+}
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    code: number;
+}
+export declare function execGit(args: string[], opts: ExecOptions): Promise<ExecResult>;
+export declare function execGitOk(args: string[], opts: ExecOptions): Promise<string>;
+//# sourceMappingURL=exec.d.ts.map

package/dist/git/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/git/exec.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAgCpF;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAMlF"}

package/dist/git/exec.js

@@ -0,0 +1,40 @@
+import { spawn } from "node:child_process";
+export async function execGit(args, opts) {
+    return new Promise((resolve, reject) => {
+        const child = spawn("git", args, {
+            cwd: opts.cwd,
+            env: opts.env ?? process.env,
+            windowsHide: true,
+        });
+        const stdout = [];
+        const stderr = [];
+        let stdoutSize = 0;
+        const maxBuffer = opts.maxBuffer ?? 256 * 1024 * 1024;
+        child.stdout.on("data", (chunk) => {
+            stdoutSize += chunk.length;
+            if (stdoutSize > maxBuffer) {
+                child.kill();
+                reject(new Error(`git ${args[0]} exceeded max buffer (${maxBuffer} bytes)`));
+                return;
+            }
+            stdout.push(chunk);
+        });
+        child.stderr.on("data", (chunk) => stderr.push(chunk));
+        child.on("error", reject);
+        child.on("close", (code) => {
+            resolve({
+                stdout: Buffer.concat(stdout).toString("utf8"),
+                stderr: Buffer.concat(stderr).toString("utf8"),
+                code: code ?? 0,
+            });
+        });
+    });
+}
+export async function execGitOk(args, opts) {
+    const r = await execGit(args, opts);
+    if (r.code !== 0) {
+        throw new Error(`git ${args.join(" ")} failed (exit ${r.code}): ${r.stderr.trim()}`);
+    }
+    return r.stdout;
+}
+//# sourceMappingURL=exec.js.map

package/dist/git/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/git/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAc3C,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAc,EAAE,IAAiB;IAC7D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE;YAC/B,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG;YAC5B,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;QAEtD,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC;YAC3B,IAAI,UAAU,GAAG,SAAS,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,yBAAyB,SAAS,SAAS,CAAC,CAAC,CAAC;gBAC7E,OAAO;YACT,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,OAAO,CAAC;gBACN,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC9C,IAAI,EAAE,IAAI,IAAI,CAAC;aAChB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAc,EAAE,IAAiB;IAC/D,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,CAAC,CAAC,MAAM,CAAC;AAClB,CAAC"}

package/dist/git/github.d.ts

@@ -0,0 +1,62 @@
+/**
+ * GitHub PR + issue body fetcher.
+ *
+ * The single biggest accuracy improvement for archeology questions: most of
+ * the WHY behind a commit lives in the PR description, not the commit message.
+ * This module hydrates each commit's pr_title / pr_body / issue_body fields
+ * by calling the GitHub REST API.
+ *
+ * Auth: read GITHUB_TOKEN from env, or accept it via opts.token. The token
+ * is never persisted; it lives in process memory only.
+ *
+ * Rate limiting: GitHub allows 5,000 req/hr authenticated, 60/hr anonymous.
+ * We respect Retry-After + use exponential backoff on 429/5xx.
+ */
+import type { Commit } from "../types.js";
+export interface GitHubFetchOptions {
+    owner: string;
+    repo: string;
+    /** Personal access token. If absent, uses anonymous (60 req/hr cap). */
+    token?: string;
+    /** Override base URL for GitHub Enterprise. Default https://api.github.com. */
+    baseUrl?: string;
+    /** Concurrent request cap. Default 4. */
+    concurrency?: number;
+    /** Per-request timeout (ms). Default 15000. */
+    timeoutMs?: number;
+    /** Optional progress callback. */
+    onProgress?: (done: number, total: number) => void;
+}
+export interface PullRequestInfo {
+    number: number;
+    title: string;
+    body: string;
+    url: string;
+    state: string;
+    mergedAt?: string;
+}
+export interface IssueInfo {
+    number: number;
+    title: string;
+    body: string;
+    url: string;
+    state: string;
+}
+export declare class GitHubAdapter {
+    private readonly base;
+    private readonly token?;
+    private readonly concurrency;
+    private readonly timeoutMs;
+    constructor(opts: GitHubFetchOptions);
+    private readonly owner;
+    private readonly repo;
+    fetchPullRequest(num: number): Promise<PullRequestInfo | null>;
+    fetchIssue(num: number): Promise<IssueInfo | null>;
+    /**
+     * Hydrate an array of commits with PR title/body in place.
+     * Skips commits that already have prBody, or have no prNumber.
+     */
+    hydrateCommits(commits: Commit[], onProgress?: (done: number, total: number) => void): Promise<void>;
+    private request;
+}
+//# sourceMappingURL=github.d.ts.map

package/dist/git/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/git/github.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAID,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,IAAI,EAAE,kBAAkB;IAYpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAExB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAa9D,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAYxD;;;OAGG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YA6B5F,OAAO;CAgCtB"}

package/dist/git/github.js

@@ -0,0 +1,115 @@
+const DEFAULT_BASE = "https://api.github.com";
+export class GitHubAdapter {
+    base;
+    token;
+    concurrency;
+    timeoutMs;
+    constructor(opts) {
+        this.base = (opts.baseUrl ?? DEFAULT_BASE).replace(/\/$/, "");
+        this.token = opts.token ?? process.env["GITHUB_TOKEN"];
+        this.concurrency = Math.max(1, opts.concurrency ?? 4);
+        this.timeoutMs = opts.timeoutMs ?? 15_000;
+        if (!opts.owner || !opts.repo) {
+            throw new Error("GitHubAdapter requires { owner, repo }");
+        }
+        this.owner = opts.owner;
+        this.repo = opts.repo;
+    }
+    owner;
+    repo;
+    async fetchPullRequest(num) {
+        const json = await this.request(`/repos/${this.owner}/${this.repo}/pulls/${num}`);
+        if (!json || json.message === "Not Found")
+            return null;
+        return {
+            number: json.number,
+            title: json.title ?? "",
+            body: json.body ?? "",
+            url: json.html_url ?? "",
+            state: json.state ?? "",
+            mergedAt: json.merged_at ?? undefined,
+        };
+    }
+    async fetchIssue(num) {
+        const json = await this.request(`/repos/${this.owner}/${this.repo}/issues/${num}`);
+        if (!json || json.message === "Not Found")
+            return null;
+        return {
+            number: json.number,
+            title: json.title ?? "",
+            body: json.body ?? "",
+            url: json.html_url ?? "",
+            state: json.state ?? "",
+        };
+    }
+    /**
+     * Hydrate an array of commits with PR title/body in place.
+     * Skips commits that already have prBody, or have no prNumber.
+     */
+    async hydrateCommits(commits, onProgress) {
+        const targets = commits.filter((c) => c.prNumber && !c.prBody);
+        let done = 0;
+        const queue = [...targets];
+        const workers = [];
+        for (let w = 0; w < this.concurrency; w++) {
+            workers.push((async () => {
+                while (queue.length) {
+                    const c = queue.shift();
+                    if (!c)
+                        break;
+                    try {
+                        const pr = await this.fetchPullRequest(c.prNumber);
+                        if (pr) {
+                            c.prTitle = pr.title;
+                            c.prBody = pr.body;
+                        }
+                    }
+                    catch {
+                        // best-effort hydration; skip failures, keep going
+                    }
+                    done++;
+                    onProgress?.(done, targets.length);
+                }
+            })());
+        }
+        await Promise.all(workers);
+    }
+    async request(path, attempt = 0) {
+        const url = `${this.base}${path}`;
+        const headers = {
+            accept: "application/vnd.github+json",
+            "x-github-api-version": "2022-11-28",
+            "user-agent": "mneme/0.1",
+        };
+        if (this.token)
+            headers.authorization = `Bearer ${this.token}`;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const res = await fetch(url, { headers, signal: controller.signal });
+            if (res.status === 404)
+                return null;
+            if (res.status === 429 || res.status >= 500) {
+                if (attempt >= 4) {
+                    throw new Error(`GitHub API ${res.status} on ${path} after ${attempt} retries`);
+                }
+                const retryAfter = Number(res.headers.get("retry-after") ?? 0);
+                const backoffMs = retryAfter > 0 ? retryAfter * 1000 : 2 ** attempt * 500;
+                await sleep(backoffMs);
+                return this.request(path, attempt + 1);
+            }
+            if (!res.ok) {
+                const body = await res.text();
+                throw new Error(`GitHub API ${res.status}: ${body.slice(0, 200)}`);
+            }
+            return (await res.json());
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=github.js.map

package/dist/git/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/git/github.ts"],"names":[],"mappings":"AAgDA,MAAM,YAAY,GAAG,wBAAwB,CAAC;AAE9C,MAAM,OAAO,aAAa;IACP,IAAI,CAAS;IACb,KAAK,CAAU;IACf,WAAW,CAAS;IACpB,SAAS,CAAS;IAEnC,YAAY,IAAwB;QAClC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,YAAY,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACvD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAEgB,KAAK,CAAS;IACd,IAAI,CAAS;IAE9B,KAAK,CAAC,gBAAgB,CAAC,GAAW;QAChC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAM,UAAU,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,UAAU,GAAG,EAAE,CAAC,CAAC;QACvF,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,WAAW;YAAE,OAAO,IAAI,CAAC;QACvD,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;YACrB,GAAG,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;YACxB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;YACvB,QAAQ,EAAE,IAAI,CAAC,SAAS,IAAI,SAAS;SACtC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAW;QAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAM,UAAU,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,WAAW,GAAG,EAAE,CAAC,CAAC;QACxF,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,WAAW;YAAE,OAAO,IAAI,CAAC;QACvD,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;YACrB,GAAG,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;YACxB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;SACxB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,OAAiB,EAAE,UAAkD;QACxF,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC/D,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;QAC3B,MAAM,OAAO,GAAoB,EAAE,CAAC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI,CACV,CAAC,KAAK,IAAI,EAAE;gBACV,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;oBACpB,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;oBACxB,IAAI,CAAC,CAAC;wBAAE,MAAM;oBACd,IAAI,CAAC;wBACH,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAS,CAAC,CAAC;wBACpD,IAAI,EAAE,EAAE,CAAC;4BACP,CAAC,CAAC,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC;4BACrB,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC;wBACrB,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,mDAAmD;oBACrD,CAAC;oBACD,IAAI,EAAE,CAAC;oBACP,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC,CAAC,EAAE,CACL,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAEO,KAAK,CAAC,OAAO,CAAI,IAAY,EAAE,OAAO,GAAG,CAAC;QAChD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC;QAClC,MAAM,OAAO,GAA2B;YACtC,MAAM,EAAE,6BAA6B;YACrC,sBAAsB,EAAE,YAAY;YACpC,YAAY,EAAE,WAAW;SAC1B,CAAC;QACF,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,aAAa,GAAG,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;QAE/D,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACrE,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YACrE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;YACpC,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;gBAC5C,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;oBACjB,MAAM,IAAI,KAAK,CAAC,cAAc,GAAG,CAAC,MAAM,OAAO,IAAI,UAAU,OAAO,UAAU,CAAC,CAAC;gBAClF,CAAC;gBACD,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC/D,MAAM,SAAS,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,GAAG,CAAC;gBAC1E,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;gBACvB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;YACzC,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,cAAc,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACrE,CAAC;YACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;QACjC,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;CACF;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/git/github.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=github.test.d.ts.map

package/dist/git/github.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.test.d.ts","sourceRoot":"","sources":["../../src/git/github.test.ts"],"names":[],"mappings":""}

package/dist/git/github.test.js

@@ -0,0 +1,86 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import { GitHubAdapter } from "./github.js";
+describe("GitHubAdapter", () => {
+    beforeEach(() => {
+        vi.spyOn(globalThis, "fetch");
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("requires owner + repo", () => {
+        expect(() => new GitHubAdapter({ owner: "", repo: "x" })).toThrow();
+        expect(() => new GitHubAdapter({ owner: "x", repo: "" })).toThrow();
+    });
+    it("fetchPullRequest returns parsed PR info", async () => {
+        globalThis.fetch.mockResolvedValue(new Response(JSON.stringify({
+            number: 42,
+            title: "Fix BigInt",
+            body: "Stripe sometimes sends bigint",
+            html_url: "https://github.com/foo/bar/pull/42",
+            state: "merged",
+            merged_at: "2025-01-15T10:00:00Z",
+        }), { status: 200, headers: { "content-type": "application/json" } }));
+        const a = new GitHubAdapter({ owner: "foo", repo: "bar", token: "tok" });
+        const pr = await a.fetchPullRequest(42);
+        expect(pr).not.toBeNull();
+        expect(pr.number).toBe(42);
+        expect(pr.title).toBe("Fix BigInt");
+        expect(pr.mergedAt).toBe("2025-01-15T10:00:00Z");
+    });
+    it("returns null on 404", async () => {
+        globalThis.fetch.mockResolvedValue(new Response("", { status: 404 }));
+        const a = new GitHubAdapter({ owner: "foo", repo: "bar" });
+        expect(await a.fetchPullRequest(999)).toBeNull();
+    });
+    it("hydrateCommits fills prTitle/prBody for commits with prNumber", async () => {
+        globalThis.fetch.mockResolvedValue(new Response(JSON.stringify({ number: 42, title: "T", body: "B", html_url: "", state: "merged" }), { status: 200, headers: { "content-type": "application/json" } }));
+        const a = new GitHubAdapter({ owner: "foo", repo: "bar" });
+        const commits = [
+            {
+                hash: "h",
+                shortHash: "h",
+                authorName: "x",
+                authorEmail: "x@x",
+                authorDate: "2025-01-01T00:00:00Z",
+                committerDate: "2025-01-01T00:00:00Z",
+                subject: "fix (#42)",
+                body: "",
+                parents: [],
+                files: [],
+                prNumber: 42,
+            },
+        ];
+        await a.hydrateCommits(commits);
+        expect(commits[0].prTitle).toBe("T");
+        expect(commits[0].prBody).toBe("B");
+    });
+    it("does not refetch commits that already have a PR body", async () => {
+        const a = new GitHubAdapter({ owner: "foo", repo: "bar" });
+        const commits = [
+            {
+                hash: "h",
+                shortHash: "h",
+                authorName: "x",
+                authorEmail: "x@x",
+                authorDate: "2025-01-01T00:00:00Z",
+                committerDate: "2025-01-01T00:00:00Z",
+                subject: "S",
+                body: "",
+                parents: [],
+                files: [],
+                prNumber: 1,
+                prBody: "already there",
+            },
+        ];
+        await a.hydrateCommits(commits);
+        expect(globalThis.fetch).not.toHaveBeenCalled();
+    });
+    it("sends Authorization header when token present", async () => {
+        globalThis.fetch.mockResolvedValue(new Response("{}", { status: 200, headers: { "content-type": "application/json" } }));
+        const a = new GitHubAdapter({ owner: "foo", repo: "bar", token: "secret" });
+        await a.fetchPullRequest(1);
+        const init = globalThis.fetch.mock.calls[0][1];
+        expect(init.headers.authorization).toBe("Bearer secret");
+    });
+});
+//# sourceMappingURL=github.test.js.map

package/dist/git/github.test.js.map

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

package/dist/git/gitlab.d.ts

@@ -0,0 +1,66 @@
+/**
+ * GitLab MR + issue body fetcher.
+ *
+ * Mirrors GitHubAdapter but speaks the GitLab REST v4 API. Same job: hydrate
+ * commits with rich PR/issue text so retrieval has real "why" to chew on.
+ *
+ * Auth: read GITLAB_TOKEN from env, or accept it via opts.token. The token
+ * never touches disk — process memory only.
+ *
+ * Rate limiting: GitLab.com allows 2,000 req/min authenticated. Self-hosted
+ * varies. We respect Retry-After + exponential backoff on 429/5xx.
+ *
+ * Notes:
+ *   - GitLab calls them "Merge Requests" (MR), not "Pull Requests".
+ *   - Project ID can be a numeric id OR a URL-encoded path "owner%2Frepo".
+ *   - GitLab subgroups are common (e.g. `group/sub/repo`) — we URL-encode the
+ *     full path so they work without configuration.
+ */
+import type { Commit } from "../types.js";
+export interface GitLabFetchOptions {
+    /** owner/repo or owner/group/repo (will be URL-encoded). */
+    projectPath: string;
+    /** Personal access token (api scope). Read from GITLAB_TOKEN if absent. */
+    token?: string;
+    /** Override base URL for self-hosted. Default https://gitlab.com. */
+    baseUrl?: string;
+    /** Concurrent request cap. Default 4. */
+    concurrency?: number;
+    /** Per-request timeout (ms). Default 15_000. */
+    timeoutMs?: number;
+    onProgress?: (done: number, total: number) => void;
+}
+export interface MergeRequestInfo {
+    iid: number;
+    title: string;
+    description: string;
+    url: string;
+    state: string;
+    mergedAt?: string;
+}
+export interface GitLabIssueInfo {
+    iid: number;
+    title: string;
+    description: string;
+    url: string;
+    state: string;
+}
+export declare class GitLabAdapter {
+    readonly source: "gitlab";
+    private readonly base;
+    private readonly token?;
+    private readonly concurrency;
+    private readonly timeoutMs;
+    private readonly projectPath;
+    private readonly encodedPath;
+    constructor(opts: GitLabFetchOptions);
+    fetchMergeRequest(iid: number): Promise<MergeRequestInfo | null>;
+    fetchIssue(iid: number): Promise<GitLabIssueInfo | null>;
+    /**
+     * Hydrate commits in place. Skips commits without `prNumber` or with `prBody`.
+     * In GitLab terminology `prNumber` actually means MR `iid`.
+     */
+    hydrateCommits(commits: Commit[], onProgress?: (done: number, total: number) => void): Promise<void>;
+    private request;
+}
+//# sourceMappingURL=gitlab.d.ts.map

package/dist/git/gitlab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab.d.ts","sourceRoot":"","sources":["../../src/git/gitlab.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAID,qBAAa,aAAa;IACxB,QAAQ,CAAC,MAAM,EAAG,QAAQ,CAAU;IAEpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,IAAI,EAAE,kBAAkB;IAY9B,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAehE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAc9D;;;OAGG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EAAE,EACjB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GACjD,OAAO,CAAC,IAAI,CAAC;YA6BF,OAAO;CA+BtB"}

package/dist/git/gitlab.js

@@ -0,0 +1,121 @@
+const DEFAULT_BASE = "https://gitlab.com";
+export class GitLabAdapter {
+    source = "gitlab";
+    base;
+    token;
+    concurrency;
+    timeoutMs;
+    projectPath;
+    encodedPath;
+    constructor(opts) {
+        if (!opts.projectPath) {
+            throw new Error("GitLabAdapter requires { projectPath } (e.g. 'group/repo')");
+        }
+        this.base = (opts.baseUrl ?? DEFAULT_BASE).replace(/\/$/, "");
+        this.token = opts.token ?? process.env["GITLAB_TOKEN"];
+        this.concurrency = Math.max(1, opts.concurrency ?? 4);
+        this.timeoutMs = opts.timeoutMs ?? 15_000;
+        this.projectPath = opts.projectPath.replace(/^\//, "").replace(/\.git$/, "");
+        this.encodedPath = encodeURIComponent(this.projectPath);
+    }
+    async fetchMergeRequest(iid) {
+        const json = await this.request(`/api/v4/projects/${this.encodedPath}/merge_requests/${iid}`);
+        if (!json || isNotFound(json))
+            return null;
+        return {
+            iid: Number(json.iid),
+            title: String(json.title ?? ""),
+            description: String(json.description ?? ""),
+            url: String(json.web_url ?? ""),
+            state: String(json.state ?? ""),
+            mergedAt: json.merged_at ?? undefined,
+        };
+    }
+    async fetchIssue(iid) {
+        const json = await this.request(`/api/v4/projects/${this.encodedPath}/issues/${iid}`);
+        if (!json || isNotFound(json))
+            return null;
+        return {
+            iid: Number(json.iid),
+            title: String(json.title ?? ""),
+            description: String(json.description ?? ""),
+            url: String(json.web_url ?? ""),
+            state: String(json.state ?? ""),
+        };
+    }
+    /**
+     * Hydrate commits in place. Skips commits without `prNumber` or with `prBody`.
+     * In GitLab terminology `prNumber` actually means MR `iid`.
+     */
+    async hydrateCommits(commits, onProgress) {
+        const targets = commits.filter((c) => c.prNumber && !c.prBody);
+        let done = 0;
+        const queue = [...targets];
+        const workers = [];
+        for (let w = 0; w < this.concurrency; w++) {
+            workers.push((async () => {
+                while (queue.length) {
+                    const c = queue.shift();
+                    if (!c)
+                        break;
+                    try {
+                        const mr = await this.fetchMergeRequest(c.prNumber);
+                        if (mr) {
+                            c.prTitle = mr.title;
+                            c.prBody = mr.description;
+                        }
+                    }
+                    catch {
+                        // best-effort hydration
+                    }
+                    done++;
+                    onProgress?.(done, targets.length);
+                }
+            })());
+        }
+        await Promise.all(workers);
+    }
+    async request(path, attempt = 0) {
+        const url = `${this.base}${path}`;
+        const headers = {
+            accept: "application/json",
+            "user-agent": "mneme/0.1",
+        };
+        if (this.token)
+            headers["private-token"] = this.token;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const res = await fetch(url, { headers, signal: controller.signal });
+            if (res.status === 404)
+                return null;
+            if (res.status === 429 || res.status >= 500) {
+                if (attempt >= 4) {
+                    throw new Error(`GitLab API ${res.status} on ${path} after ${attempt} retries`);
+                }
+                const retryAfter = Number(res.headers.get("retry-after") ?? 0);
+                const backoffMs = retryAfter > 0 ? retryAfter * 1000 : 2 ** attempt * 500;
+                await sleep(backoffMs);
+                return this.request(path, attempt + 1);
+            }
+            if (!res.ok) {
+                const body = await res.text();
+                throw new Error(`GitLab API ${res.status}: ${body.slice(0, 200)}`);
+            }
+            return (await res.json());
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+function isNotFound(json) {
+    if (!json || typeof json !== "object")
+        return false;
+    const msg = String(json.message ?? "").toLowerCase();
+    return msg.includes("not found") || msg === "404";
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=gitlab.js.map

package/dist/git/gitlab.js.map

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

package/dist/git/gitlab.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gitlab.test.d.ts.map

package/dist/git/gitlab.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab.test.d.ts","sourceRoot":"","sources":["../../src/git/gitlab.test.ts"],"names":[],"mappings":""}