@mneme-ai/correlator 0.8.3

package/dist/adapters/sentry.js

@@ -0,0 +1,206 @@
+const DEFAULT_BASE = "https://sentry.io";
+export class SentryAdapter {
+    source = "sentry";
+    base;
+    token;
+    orgSlug;
+    projectSlug;
+    concurrency;
+    timeoutMs;
+    fetchStackFrames;
+    maxIssues;
+    constructor(opts) {
+        if (!opts.orgSlug)
+            throw new Error("SentryAdapter requires orgSlug");
+        if (!opts.projectSlug)
+            throw new Error("SentryAdapter requires projectSlug");
+        if (!opts.apiToken)
+            throw new Error("SentryAdapter requires apiToken");
+        this.base = (opts.baseUrl ?? DEFAULT_BASE).replace(/\/$/, "");
+        this.token = opts.apiToken;
+        this.orgSlug = opts.orgSlug;
+        this.projectSlug = opts.projectSlug;
+        this.concurrency = Math.max(1, opts.concurrency ?? 4);
+        this.timeoutMs = opts.timeoutMs ?? 15_000;
+        this.fetchStackFrames = opts.fetchStackFrames ?? true;
+        this.maxIssues = Math.max(1, opts.maxIssues ?? 1000);
+    }
+    async fetch(opts) {
+        const issues = await this.listIssues(opts);
+        const capped = issues.slice(0, this.maxIssues);
+        if (!this.fetchStackFrames)
+            return capped.map((i) => this.mapIssue(i));
+        // Hydrate stack frames concurrently.
+        const out = [];
+        const queue = [...capped];
+        const workers = [];
+        for (let w = 0; w < this.concurrency; w++) {
+            workers.push((async () => {
+                while (queue.length) {
+                    const issue = queue.shift();
+                    if (!issue)
+                        break;
+                    const frames = await this.fetchLatestEventFrames(issue.id);
+                    out.push(this.mapIssue(issue, frames));
+                }
+            })());
+        }
+        await Promise.all(workers);
+        // Restore deterministic order.
+        out.sort((a, b) => Date.parse(a.occurredAt) - Date.parse(b.occurredAt));
+        return out;
+    }
+    async listIssues(opts) {
+        const params = new URLSearchParams();
+        if (opts.since && opts.until) {
+            params.set("start", opts.since);
+            params.set("end", opts.until);
+        }
+        else if (opts.since) {
+            params.set("statsPeriod", computeStatsPeriod(opts.since));
+        }
+        else {
+            params.set("statsPeriod", "30d");
+        }
+        params.set("limit", "100");
+        params.set("query", "is:unresolved is:resolved is:ignored sort:created");
+        const out = [];
+        let url = `${this.base}/api/0/projects/${this.orgSlug}/${this.projectSlug}/issues/?${params.toString()}`;
+        while (url && out.length < this.maxIssues) {
+            const result = await this.requestWithLink(url);
+            if (Array.isArray(result.json))
+                out.push(...result.json);
+            url = result.nextUrl;
+        }
+        return out;
+    }
+    mapIssue = (i, stackFrames = []) => ({
+        id: `sentry:${i.id}`,
+        source: "sentry",
+        externalId: i.id,
+        title: i.title || i.metadata?.value || i.metadata?.type || `Sentry issue ${i.id}`,
+        occurredAt: i.firstSeen,
+        resolvedAt: i.status === "resolved" ? i.lastSeen : undefined,
+        severity: mapLevel(i.level),
+        affectedFiles: dedupe([
+            ...(i.culprit ? extractPathFromCulprit(i.culprit) : []),
+            ...stackFrames.map((f) => f.file).filter(Boolean),
+        ]),
+        stackFrames: stackFrames.length ? stackFrames : undefined,
+        url: i.permalink,
+        metadata: {
+            project: i.project?.slug,
+            events: i.count,
+            users: i.userCount,
+            ...(i.metadata ?? {}),
+        },
+    });
+    async fetchLatestEventFrames(issueId) {
+        try {
+            const { json } = await this.requestWithLink(`${this.base}/api/0/issues/${issueId}/events/latest/`);
+            if (!json)
+                return [];
+            const exception = (json.entries ?? []).find((e) => e.type === "exception");
+            const values = exception?.data?.values ?? [];
+            const frames = [];
+            for (const v of values) {
+                for (const f of v.stacktrace?.frames ?? []) {
+                    if (!f.filename)
+                        continue;
+                    frames.push({
+                        file: f.filename,
+                        line: typeof f.lineno === "number" ? f.lineno : 0,
+                        function: f.function,
+                        module: f.module,
+                    });
+                }
+            }
+            return frames.slice(-20); // most recent frames are most informative
+        }
+        catch {
+            return [];
+        }
+    }
+    async requestWithLink(url, attempt = 0) {
+        const headers = {
+            authorization: `Bearer ${this.token}`,
+            accept: "application/json",
+            "user-agent": "mneme/0.1",
+        };
+        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 { json: null, nextUrl: null };
+            if (res.status === 429 || res.status >= 500) {
+                if (attempt >= 4) {
+                    throw new Error(`Sentry API ${res.status} after ${attempt} retries: ${url}`);
+                }
+                const retryAfter = Number(res.headers.get("retry-after") ?? 0);
+                const backoffMs = retryAfter > 0 ? retryAfter * 1000 : 2 ** attempt * 500;
+                await sleep(backoffMs);
+                return this.requestWithLink(url, attempt + 1);
+            }
+            if (!res.ok) {
+                const body = await res.text();
+                throw new Error(`Sentry API ${res.status}: ${body.slice(0, 200)}`);
+            }
+            const json = (await res.json());
+            const nextUrl = parseNextLink(res.headers.get("link"));
+            return { json, nextUrl };
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+function mapLevel(level) {
+    switch ((level ?? "").toLowerCase()) {
+        case "fatal":
+            return "critical";
+        case "error":
+            return "error";
+        case "warning":
+            return "warning";
+        case "info":
+        case "debug":
+            return "info";
+        default:
+            return "error";
+    }
+}
+/**
+ * Sentry's `culprit` is usually `module in function` or a path-like string.
+ * Pull anything that looks like a filename out of it.
+ */
+function extractPathFromCulprit(culprit) {
+    const matches = culprit.match(/[\w./\\-]+\.(?:ts|tsx|js|jsx|py|go|rs|java|kt|cs|rb|php|cpp|c|h)/g);
+    return matches ? Array.from(new Set(matches)) : [];
+}
+function dedupe(arr) {
+    return Array.from(new Set(arr));
+}
+/** Parse RFC 5988 Link header for cursor-based pagination (Sentry uses this). */
+function parseNextLink(header) {
+    if (!header)
+        return null;
+    for (const part of header.split(",")) {
+        const m = part.match(/<([^>]+)>;\s*rel="next";\s*results="true"/);
+        if (m)
+            return m[1];
+    }
+    return null;
+}
+/** "2025-09-01T00:00:00Z" → "60d" (rounded up) for Sentry's statsPeriod. */
+function computeStatsPeriod(sinceIso) {
+    const since = Date.parse(sinceIso);
+    if (!Number.isFinite(since))
+        return "30d";
+    const days = Math.max(1, Math.ceil((Date.now() - since) / (24 * 60 * 60 * 1000)));
+    return `${days}d`;
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=sentry.js.map

package/dist/adapters/sentry.js.map

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

package/dist/adapters/sentry.test.d.ts

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

package/dist/adapters/sentry.test.d.ts.map

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

package/dist/adapters/sentry.test.js

@@ -0,0 +1,241 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import { SentryAdapter } from "./sentry.js";
+const headers = (link) => {
+    const h = { "content-type": "application/json" };
+    if (link)
+        h.link = link;
+    return h;
+};
+describe("SentryAdapter — construction", () => {
+    it("requires orgSlug, projectSlug, apiToken", () => {
+        expect(() => new SentryAdapter({ orgSlug: "", projectSlug: "p", apiToken: "t" })).toThrow();
+        expect(() => new SentryAdapter({ orgSlug: "o", projectSlug: "", apiToken: "t" })).toThrow();
+        expect(() => new SentryAdapter({ orgSlug: "o", projectSlug: "p", apiToken: "" })).toThrow();
+    });
+    it("normalizes baseUrl trailing slash", () => {
+        const a = new SentryAdapter({
+            orgSlug: "o",
+            projectSlug: "p",
+            apiToken: "t",
+            baseUrl: "https://sentry.internal/",
+        });
+        expect(a).toBeDefined();
+    });
+});
+describe("SentryAdapter.fetch", () => {
+    beforeEach(() => {
+        vi.spyOn(globalThis, "fetch");
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("maps issues to Mneme Incident shape", async () => {
+        globalThis.fetch.mockImplementation((url) => {
+            if (url.includes("/issues/")) {
+                return Promise.resolve(new Response(JSON.stringify([
+                    {
+                        id: "12345",
+                        title: "Stripe webhook 500",
+                        level: "error",
+                        status: "unresolved",
+                        firstSeen: "2025-09-01T10:00:00Z",
+                        lastSeen: "2025-09-01T11:00:00Z",
+                        count: 47,
+                        userCount: 12,
+                        permalink: "https://sentry.io/organizations/foo/issues/12345/",
+                        culprit: "handleWebhook in src/payment.ts",
+                        project: { slug: "web" },
+                        metadata: { type: "TypeError", value: "Cannot read property" },
+                    },
+                ]), { status: 200, headers: headers() }));
+            }
+            return Promise.resolve(new Response("[]", { status: 200, headers: headers() }));
+        });
+        const a = new SentryAdapter({
+            orgSlug: "foo",
+            projectSlug: "web",
+            apiToken: "tok",
+            fetchStackFrames: false,
+        });
+        const incidents = await a.fetch({});
+        expect(incidents).toHaveLength(1);
+        const inc = incidents[0];
+        expect(inc.id).toBe("sentry:12345");
+        expect(inc.source).toBe("sentry");
+        expect(inc.title).toBe("Stripe webhook 500");
+        expect(inc.severity).toBe("error");
+        expect(inc.occurredAt).toBe("2025-09-01T10:00:00Z");
+        expect(inc.affectedFiles).toContain("src/payment.ts");
+        expect(inc.url).toContain("sentry.io");
+    });
+    it("maps level → severity correctly", async () => {
+        const issues = ["fatal", "error", "warning", "info", "unknown"].map((level, i) => ({
+            id: String(i),
+            title: `t${i}`,
+            level,
+            firstSeen: "2025-01-01T00:00:00Z",
+        }));
+        globalThis.fetch.mockResolvedValue(new Response(JSON.stringify(issues), { status: 200, headers: headers() }));
+        const a = new SentryAdapter({
+            orgSlug: "o",
+            projectSlug: "p",
+            apiToken: "t",
+            fetchStackFrames: false,
+        });
+        const out = await a.fetch({});
+        const sevById = Object.fromEntries(out.map((i) => [i.id, i.severity]));
+        expect(sevById["sentry:0"]).toBe("critical");
+        expect(sevById["sentry:1"]).toBe("error");
+        expect(sevById["sentry:2"]).toBe("warning");
+        expect(sevById["sentry:3"]).toBe("info");
+        expect(sevById["sentry:4"]).toBe("error"); // default
+    });
+    it("hydrates stack frames from latest event when enabled", async () => {
+        let callCount = 0;
+        globalThis.fetch.mockImplementation((url) => {
+            callCount++;
+            if (url.includes("/projects/")) {
+                return Promise.resolve(new Response(JSON.stringify([
+                    {
+                        id: "1",
+                        title: "Crash",
+                        level: "error",
+                        firstSeen: "2025-01-01T00:00:00Z",
+                    },
+                ]), { status: 200, headers: headers() }));
+            }
+            if (url.includes("/events/latest/")) {
+                return Promise.resolve(new Response(JSON.stringify({
+                    entries: [
+                        {
+                            type: "exception",
+                            data: {
+                                values: [
+                                    {
+                                        stacktrace: {
+                                            frames: [
+                                                { filename: "src/payment.ts", lineno: 42, function: "charge" },
+                                                { filename: "src/webhook.ts", lineno: 7, function: "handle" },
+                                            ],
+                                        },
+                                    },
+                                ],
+                            },
+                        },
+                    ],
+                }), { status: 200, headers: headers() }));
+            }
+            return Promise.resolve(new Response("{}", { status: 200, headers: headers() }));
+        });
+        const a = new SentryAdapter({
+            orgSlug: "o",
+            projectSlug: "p",
+            apiToken: "t",
+            fetchStackFrames: true,
+        });
+        const [inc] = await a.fetch({});
+        expect(inc).toBeDefined();
+        expect(inc.stackFrames).toHaveLength(2);
+        expect(inc.stackFrames[0].file).toBe("src/payment.ts");
+        expect(inc.affectedFiles).toContain("src/payment.ts");
+        expect(callCount).toBeGreaterThanOrEqual(2);
+    });
+    it("does not call /events/latest/ when fetchStackFrames=false", async () => {
+        globalThis.fetch.mockImplementation((url) => {
+            if (url.includes("/projects/")) {
+                return Promise.resolve(new Response(JSON.stringify([
+                    { id: "1", title: "x", level: "error", firstSeen: "2025-01-01T00:00:00Z" },
+                ]), { status: 200, headers: headers() }));
+            }
+            throw new Error("should not be called");
+        });
+        const a = new SentryAdapter({
+            orgSlug: "o",
+            projectSlug: "p",
+            apiToken: "t",
+            fetchStackFrames: false,
+        });
+        await a.fetch({});
+        const calledUrls = globalThis.fetch.mock.calls.map((c) => c[0]);
+        expect(calledUrls.some((u) => u.includes("/events/latest/"))).toBe(false);
+    });
+    it("follows pagination via Link header rel=next", async () => {
+        let page = 0;
+        globalThis.fetch.mockImplementation((url) => {
+            page++;
+            if (page === 1) {
+                return Promise.resolve(new Response(JSON.stringify([{ id: "1", title: "a", firstSeen: "2025-01-01T00:00:00Z" }]), {
+                    status: 200,
+                    headers: headers('<https://sentry.io/api/0/projects/o/p/issues/?cursor=abc>; rel="next"; results="true"'),
+                }));
+            }
+            if (page === 2) {
+                return Promise.resolve(new Response(JSON.stringify([{ id: "2", title: "b", firstSeen: "2025-01-02T00:00:00Z" }]), { status: 200, headers: headers() }));
+            }
+            return Promise.resolve(new Response("[]", { status: 200, headers: headers() }));
+        });
+        const a = new SentryAdapter({
+            orgSlug: "o",
+            projectSlug: "p",
+            apiToken: "t",
+            fetchStackFrames: false,
+        });
+        const out = await a.fetch({});
+        expect(out.length).toBe(2);
+        expect(page).toBe(2);
+    });
+    it("respects since/until via start/end params", async () => {
+        globalThis.fetch.mockResolvedValue(new Response("[]", { status: 200, headers: headers() }));
+        const a = new SentryAdapter({
+            orgSlug: "o",
+            projectSlug: "p",
+            apiToken: "t",
+            fetchStackFrames: false,
+        });
+        await a.fetch({ since: "2025-01-01T00:00:00Z", until: "2025-02-01T00:00:00Z" });
+        const url = globalThis.fetch.mock.calls[0][0];
+        expect(url).toContain("start=");
+        expect(url).toContain("end=");
+    });
+    it("sends Authorization header", async () => {
+        globalThis.fetch.mockResolvedValue(new Response("[]", { status: 200, headers: headers() }));
+        const a = new SentryAdapter({
+            orgSlug: "o",
+            projectSlug: "p",
+            apiToken: "secret-token",
+            fetchStackFrames: false,
+        });
+        await a.fetch({});
+        const init = globalThis.fetch.mock.calls[0][1];
+        expect(init.headers.authorization).toBe("Bearer secret-token");
+    });
+    it("returns empty array on 404 (project not found)", async () => {
+        globalThis.fetch.mockResolvedValue(new Response("", { status: 404 }));
+        const a = new SentryAdapter({
+            orgSlug: "o",
+            projectSlug: "p",
+            apiToken: "t",
+            fetchStackFrames: false,
+        });
+        const out = await a.fetch({});
+        expect(out).toEqual([]);
+    });
+    it("caps to maxIssues", async () => {
+        const big = Array.from({ length: 50 }, (_, i) => ({
+            id: String(i),
+            title: `t${i}`,
+            firstSeen: "2025-01-01T00:00:00Z",
+        }));
+        globalThis.fetch.mockResolvedValue(new Response(JSON.stringify(big), { status: 200, headers: headers() }));
+        const a = new SentryAdapter({
+            orgSlug: "o",
+            projectSlug: "p",
+            apiToken: "t",
+            maxIssues: 5,
+            fetchStackFrames: false,
+        });
+        const out = await a.fetch({});
+        expect(out).toHaveLength(5);
+    });
+});
+//# sourceMappingURL=sentry.test.js.map

package/dist/adapters/sentry.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./temporal.js";
+export * from "./adapters/sentry.js";
+export * from "./adapters/datadog.js";
+export * from "./adapters/github-actions.js";
+export * from "./adapters/manual.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./temporal.js";
+export * from "./adapters/sentry.js";
+export * from "./adapters/datadog.js";
+export * from "./adapters/github-actions.js";
+export * from "./adapters/manual.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC"}

package/dist/temporal.d.ts

@@ -0,0 +1,24 @@
+import type { Correlation, correlate as CorrelateNS } from "@mneme-ai/core";
+/**
+ * Temporal + structural correlation engine.
+ *
+ * For each (commit, incident) pair where the incident occurred within `windowMs`
+ * after the commit, score by:
+ *   1. temporal proximity (closer = stronger)
+ *   2. file overlap (commit's files vs incident.affectedFiles ∪ stack frames)
+ *
+ * Semantic correlation (commit message vs stack trace embeddings) is layered on
+ * top by future versions — it requires an embedder, which this engine does not.
+ */
+export declare class TemporalCorrelationEngine implements CorrelateNS.CorrelationEngine {
+    private readonly defaults;
+    readonly name = "temporal-structural-v1";
+    constructor(defaults?: {
+        windowMs?: number;
+        minWeight?: number;
+        /** Fraction of weight assigned to file-overlap (rest goes to temporal). 0..1. */
+        fileOverlapWeight?: number;
+    });
+    correlate(input: CorrelateNS.CorrelateInput): Promise<Correlation[]>;
+}
+//# sourceMappingURL=temporal.d.ts.map

package/dist/temporal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.d.ts","sourceRoot":"","sources":["../src/temporal.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,WAAW,EAEX,SAAS,IAAI,WAAW,EACzB,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;;;GAUG;AACH,qBAAa,yBAA0B,YAAW,WAAW,CAAC,iBAAiB;IAI3E,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAH3B,QAAQ,CAAC,IAAI,4BAA4B;gBAGtB,QAAQ,GAAE;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,iFAAiF;QACjF,iBAAiB,CAAC,EAAE,MAAM,CAAC;KACvB;IAGF,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAkD3E"}

package/dist/temporal.js

@@ -0,0 +1,121 @@
+import { createHash } from "node:crypto";
+/**
+ * Temporal + structural correlation engine.
+ *
+ * For each (commit, incident) pair where the incident occurred within `windowMs`
+ * after the commit, score by:
+ *   1. temporal proximity (closer = stronger)
+ *   2. file overlap (commit's files vs incident.affectedFiles ∪ stack frames)
+ *
+ * Semantic correlation (commit message vs stack trace embeddings) is layered on
+ * top by future versions — it requires an embedder, which this engine does not.
+ */
+export class TemporalCorrelationEngine {
+    defaults;
+    name = "temporal-structural-v1";
+    constructor(defaults = {}) {
+        this.defaults = defaults;
+    }
+    async correlate(input) {
+        const windowMs = input.windowMs ??
+            this.defaults.windowMs ??
+            // 7 days
+            7 * 24 * 60 * 60 * 1000;
+        const minWeight = this.defaults.minWeight ?? 0.15;
+        const overlapWeight = clamp01(this.defaults.fileOverlapWeight ?? 0.4);
+        const temporalWeight = 1 - overlapWeight;
+        const out = [];
+        const sortedCommits = [...input.commits].sort(byDate);
+        for (const inc of input.incidents) {
+            const incidentTime = parseTime(inc.occurredAt);
+            if (!Number.isFinite(incidentTime))
+                continue;
+            const windowStart = incidentTime - windowMs;
+            const incidentFiles = new Set([
+                ...(inc.affectedFiles ?? []),
+                ...(inc.stackFrames?.map((f) => normalizePath(f.file)) ?? []),
+            ]);
+            for (const c of sortedCommits) {
+                const ct = parseTime(c.authorDate);
+                if (!Number.isFinite(ct))
+                    continue;
+                if (ct > incidentTime)
+                    break;
+                if (ct < windowStart)
+                    continue;
+                const temporal = 1 - (incidentTime - ct) / windowMs;
+                const overlap = computeFileOverlap(c.files, incidentFiles);
+                // Convex combination: weight ∈ [0, 1], no saturation, monotonic in both inputs.
+                const weight = clamp01(temporal * temporalWeight + overlap * overlapWeight);
+                if (weight < minWeight)
+                    continue;
+                const reason = buildReason(temporal, overlap, c, inc);
+                out.push({
+                    id: hashId([c.hash, inc.id]),
+                    fromKind: "commit",
+                    fromId: c.hash,
+                    toKind: "incident",
+                    toId: inc.id,
+                    weight: round3(weight),
+                    reason,
+                    evidence: [c.hash, inc.id],
+                });
+            }
+        }
+        return out;
+    }
+}
+function buildReason(temporal, overlap, c, inc) {
+    const parts = [];
+    parts.push(`Incident "${inc.title}" occurred ${humanDelta(c.authorDate, inc.occurredAt)} after commit ${c.shortHash || c.hash.slice(0, 7)}.`);
+    if (overlap > 0) {
+        parts.push(`File overlap score: ${round2(overlap)}.`);
+    }
+    else {
+        parts.push("No direct file overlap; correlation is purely temporal.");
+    }
+    parts.push(`Temporal score: ${round2(temporal)}.`);
+    return parts.join(" ");
+}
+function computeFileOverlap(commitFiles, incidentFiles) {
+    if (!commitFiles.length || !incidentFiles.size)
+        return 0;
+    const cset = new Set(commitFiles.map(normalizePath));
+    let hits = 0;
+    for (const f of cset)
+        if (incidentFiles.has(f))
+            hits++;
+    return hits / Math.min(cset.size, incidentFiles.size);
+}
+function normalizePath(p) {
+    return p.replace(/\\/g, "/").replace(/^\.\//, "").toLowerCase();
+}
+function parseTime(iso) {
+    const t = Date.parse(iso);
+    return Number.isFinite(t) ? t : NaN;
+}
+function humanDelta(fromIso, toIso) {
+    const ms = Math.max(0, Date.parse(toIso) - Date.parse(fromIso));
+    const h = ms / 3_600_000;
+    if (h < 1)
+        return `${Math.round(ms / 60_000)}m`;
+    if (h < 48)
+        return `${h.toFixed(1)}h`;
+    return `${(h / 24).toFixed(1)}d`;
+}
+function clamp01(n) {
+    return Math.min(1, Math.max(0, n));
+}
+function round3(n) {
+    return Math.round(n * 1000) / 1000;
+}
+function round2(n) {
+    return Math.round(n * 100) / 100;
+}
+function hashId(parts) {
+    return createHash("sha1").update(parts.join("|")).digest("hex").slice(0, 16);
+}
+function byDate(a, b) {
+    return Date.parse(a.authorDate) - Date.parse(b.authorDate);
+}
+//# sourceMappingURL=temporal.js.map