@mneme-ai/correlator 0.8.3

package/README.md

@@ -0,0 +1,42 @@
+# @mneme-ai/correlator
+
+Phase 3 — error/incident correlation engine for [Mneme](https://github.com/patsa2561-art/mneme-ai).
+
+The differentiator. Joins commits + incidents + time into one graph, so you can ask:
+
+> *"Every time PaymentService.charge is touched, a Stripe webhook 500 spikes within 48h."*
+>
+> *"This PR touches code that has caused 3 of the last 5 incidents in OrderQueue."*
+>
+> *"Incident INC-1287 was likely introduced by commit a1b2c3d (87% confidence — same file, 14h before the spike)."*
+
+## What's in here
+
+- `temporal.ts` — `TemporalCorrelationEngine` (temporal proximity + file overlap)
+- `adapters/sentry.ts` — first pager adapter (REST API; live)
+- `adapters/datadog.ts` — Datadog adapter (stub, in progress)
+- `adapters/manual.ts` — JSON file input (works today, useful for testing)
+
+## Usage
+
+```ts
+import { TemporalCorrelationEngine, SentryAdapter } from "@mneme-ai/correlator";
+
+const sentry = new SentryAdapter({
+  orgSlug: "my-org",
+  projectSlug: "web",
+  apiToken: process.env.SENTRY_TOKEN!,
+});
+
+const incidents = await sentry.fetch({ since: "2025-01-01T00:00:00Z" });
+const engine = new TemporalCorrelationEngine();
+const correlations = await engine.correlate({
+  commits,
+  incidents,
+  windowMs: 7 * 24 * 60 * 60 * 1000,
+});
+```
+
+## License
+
+MIT.

package/dist/adapters/datadog.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Datadog Events / Incidents adapter — pulls error-class events from the
+ * Datadog Events API v2 and maps them onto the Mneme `Incident` shape so
+ * the temporal correlation engine can rank them against commits.
+ *
+ *   Endpoint: POST https://api.{site}/api/v2/events/search
+ *   Auth:    DD-API-KEY + DD-APPLICATION-KEY headers
+ *
+ * "Site" is one of: datadoghq.com (US1), us3.datadoghq.com, us5.datadoghq.com,
+ * datadoghq.eu, ap1.datadoghq.com, ddog-gov.com — passed via the `site` option.
+ *
+ * Mneme stays brand-neutral in user-facing copy ("the pager"); the adapter
+ * class name is technically accurate because that's the API it speaks.
+ */
+import type { Incident, correlate as CorrelateNS } from "@mneme-ai/core";
+export interface DatadogAdapterOptions {
+    apiKey: string;
+    appKey: string;
+    /** "datadoghq.com" (default), "us5.datadoghq.com", "datadoghq.eu", etc. */
+    site?: string;
+    /** Filter expression, e.g. `source:error,exception` (default) */
+    filterQuery?: string;
+    /** Cap on events fetched. Default 1000. */
+    maxEvents?: number;
+    /** Per-request timeout (ms). */
+    timeoutMs?: number;
+}
+export declare class DatadogAdapter implements CorrelateNS.IncidentAdapter {
+    readonly source: "datadog";
+    private readonly apiKey;
+    private readonly appKey;
+    private readonly site;
+    private readonly filterQuery;
+    private readonly maxEvents;
+    private readonly timeoutMs;
+    constructor(opts: DatadogAdapterOptions);
+    fetch(opts: CorrelateNS.FetchIncidentOptions): Promise<Incident[]>;
+    private fetchPage;
+    private mapEvent;
+}
+//# sourceMappingURL=datadog.d.ts.map

package/dist/adapters/datadog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datadog.d.ts","sourceRoot":"","sources":["../../src/adapters/datadog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEzE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,qBAAa,cAAe,YAAW,WAAW,CAAC,eAAe;IAChE,QAAQ,CAAC,MAAM,EAAG,SAAS,CAAU;IAErC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,IAAI,EAAE,qBAAqB;IAWjC,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,oBAAoB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;YAgB1D,SAAS;IA0DvB,OAAO,CAAC,QAAQ;CAwBjB"}

package/dist/adapters/datadog.js

@@ -0,0 +1,136 @@
+const DEFAULT_SITE = "datadoghq.com";
+export class DatadogAdapter {
+    source = "datadog";
+    apiKey;
+    appKey;
+    site;
+    filterQuery;
+    maxEvents;
+    timeoutMs;
+    constructor(opts) {
+        if (!opts.apiKey)
+            throw new Error("DatadogAdapter requires apiKey");
+        if (!opts.appKey)
+            throw new Error("DatadogAdapter requires appKey");
+        this.apiKey = opts.apiKey;
+        this.appKey = opts.appKey;
+        this.site = opts.site ?? DEFAULT_SITE;
+        this.filterQuery = opts.filterQuery ?? "source:error,exception status:error";
+        this.maxEvents = Math.max(1, opts.maxEvents ?? 1000);
+        this.timeoutMs = opts.timeoutMs ?? 15_000;
+    }
+    async fetch(opts) {
+        const out = [];
+        let cursor = null;
+        while (out.length < this.maxEvents) {
+            const remaining = this.maxEvents - out.length;
+            const pageSize = Math.min(100, remaining);
+            const result = await this.fetchPage(opts, cursor, pageSize);
+            if (!result || result.events.length === 0)
+                break;
+            out.push(...result.events.map((e) => this.mapEvent(e)));
+            if (!result.nextCursor)
+                break;
+            cursor = result.nextCursor;
+        }
+        return out;
+    }
+    async fetchPage(opts, cursor, pageSize, attempt = 0) {
+        const url = `https://api.${this.site}/api/v2/events/search`;
+        const body = {
+            filter: {
+                query: this.filterQuery,
+                ...(opts.since ? { from: opts.since } : { from: "now-30d" }),
+                ...(opts.until ? { to: opts.until } : { to: "now" }),
+            },
+            sort: "timestamp",
+            page: { limit: pageSize, ...(cursor ? { cursor } : {}) },
+        };
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);
+        try {
+            const res = await fetch(url, {
+                method: "POST",
+                headers: {
+                    "DD-API-KEY": this.apiKey,
+                    "DD-APPLICATION-KEY": this.appKey,
+                    "content-type": "application/json",
+                    accept: "application/json",
+                    "user-agent": "mneme/0.1",
+                },
+                body: JSON.stringify(body),
+                signal: ctrl.signal,
+            });
+            if (res.status === 404)
+                return null;
+            if (res.status === 429 || res.status >= 500) {
+                if (attempt >= 4) {
+                    throw new Error(`Datadog API ${res.status} after ${attempt} retries: ${url}`);
+                }
+                const retryAfter = Number(res.headers.get("retry-after") ?? 0);
+                const backoff = retryAfter > 0 ? retryAfter * 1000 : 2 ** attempt * 500;
+                await new Promise((r) => setTimeout(r, backoff));
+                return this.fetchPage(opts, cursor, pageSize, attempt + 1);
+            }
+            if (!res.ok) {
+                const txt = await res.text();
+                throw new Error(`Datadog API ${res.status}: ${txt.slice(0, 200)}`);
+            }
+            const json = (await res.json());
+            return {
+                events: json.data ?? [],
+                nextCursor: json.meta?.page?.after ?? null,
+            };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    mapEvent(e) {
+        const id = `datadog:${e.id ?? e.attributes?.attributes?.evt?.id ?? "unknown"}`;
+        const attrs = e.attributes?.attributes ?? {};
+        const title = String(attrs.message ?? attrs.title ?? "Datadog event");
+        const occurredAt = String(attrs.timestamp ?? new Date().toISOString());
+        const severity = mapStatus(String(attrs.status ?? "error"));
+        const service = attrs.service ? String(attrs.service) : undefined;
+        const host = attrs.host ? String(attrs.host) : undefined;
+        const affectedFiles = [];
+        if (typeof attrs.error?.stack === "string") {
+            affectedFiles.push(...extractFiles(attrs.error.stack));
+        }
+        return {
+            id,
+            source: "datadog",
+            externalId: e.id,
+            title: title.slice(0, 240),
+            occurredAt,
+            severity,
+            affectedFiles: affectedFiles.length ? Array.from(new Set(affectedFiles)) : undefined,
+            url: attrs.url ? String(attrs.url) : undefined,
+            metadata: { service, host, tags: attrs.tags ?? [] },
+        };
+    }
+}
+function mapStatus(status) {
+    switch (status.toLowerCase()) {
+        case "critical":
+        case "fatal":
+            return "critical";
+        case "error":
+            return "error";
+        case "warn":
+        case "warning":
+            return "warning";
+        case "info":
+        case "debug":
+        case "ok":
+            return "info";
+        default:
+            return "error";
+    }
+}
+function extractFiles(stack) {
+    const matches = stack.match(/[\w./\\-]+\.(?:ts|tsx|js|jsx|py|go|rs|java|kt|cs|rb|php)/g);
+    return matches ?? [];
+}
+//# sourceMappingURL=datadog.js.map

package/dist/adapters/datadog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datadog.js","sourceRoot":"","sources":["../../src/adapters/datadog.ts"],"names":[],"mappings":"AA6BA,MAAM,YAAY,GAAG,eAAe,CAAC;AAErC,MAAM,OAAO,cAAc;IAChB,MAAM,GAAG,SAAkB,CAAC;IAEpB,MAAM,CAAS;IACf,MAAM,CAAS;IACf,IAAI,CAAS;IACb,WAAW,CAAS;IACpB,SAAS,CAAS;IAClB,SAAS,CAAS;IAEnC,YAAY,IAA2B;QACrC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,YAAY,CAAC;QACtC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,qCAAqC,CAAC;QAC7E,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAsC;QAChD,MAAM,GAAG,GAAe,EAAE,CAAC;QAC3B,IAAI,MAAM,GAAkB,IAAI,CAAC;QAEjC,OAAO,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YACnC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC;YAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC5D,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM;YACjD,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxD,IAAI,CAAC,MAAM,CAAC,UAAU;gBAAE,MAAM;YAC9B,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC;QAC7B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,KAAK,CAAC,SAAS,CACrB,IAAsC,EACtC,MAAqB,EACrB,QAAgB,EAChB,OAAO,GAAG,CAAC;QAEX,MAAM,GAAG,GAAG,eAAe,IAAI,CAAC,IAAI,uBAAuB,CAAC;QAC5D,MAAM,IAAI,GAA4B;YACpC,MAAM,EAAE;gBACN,KAAK,EAAE,IAAI,CAAC,WAAW;gBACvB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;gBAC5D,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;aACrD;YACD,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;SACzD,CAAC;QAEF,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7D,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC3B,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,YAAY,EAAE,IAAI,CAAC,MAAM;oBACzB,oBAAoB,EAAE,IAAI,CAAC,MAAM;oBACjC,cAAc,EAAE,kBAAkB;oBAClC,MAAM,EAAE,kBAAkB;oBAC1B,YAAY,EAAE,WAAW;iBAC1B;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YACH,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,CACb,eAAe,GAAG,CAAC,MAAM,UAAU,OAAO,aAAa,GAAG,EAAE,CAC7D,CAAC;gBACJ,CAAC;gBACD,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC/D,MAAM,OAAO,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,GAAG,CAAC;gBACxE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;gBACjD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;YAC7D,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,eAAe,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAoB,CAAC;YACnD,OAAO;gBACL,MAAM,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;gBACvB,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,IAAI,IAAI;aAC3C,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAEO,QAAQ,CAAC,CAAe;QAC9B,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,IAAI,SAAS,EAAE,CAAC;QAC/E,MAAM,KAAK,GAAG,CAAC,CAAC,UAAU,EAAE,UAAU,IAAI,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,IAAI,eAAe,CAAC,CAAC;QACtE,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QACvE,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAClE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACzD,MAAM,aAAa,GAAa,EAAE,CAAC;QACnC,IAAI,OAAO,KAAK,CAAC,KAAK,EAAE,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC3C,aAAa,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO;YACL,EAAE;YACF,MAAM,EAAE,SAAS;YACjB,UAAU,EAAE,CAAC,CAAC,EAAE;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;YAC1B,UAAU;YACV,QAAQ;YACR,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;YACpF,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;YAC9C,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE;SACpD,CAAC;IACJ,CAAC;CACF;AAyBD,SAAS,SAAS,CAAC,MAAc;IAC/B,QAAQ,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;QAC7B,KAAK,UAAU,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,UAAU,CAAC;QACpB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,MAAM,CAAC;QACZ,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO,CAAC;QACb,KAAK,IAAI;YACP,OAAO,MAAM,CAAC;QAChB;YACE,OAAO,OAAO,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;IACzF,OAAO,OAAO,IAAI,EAAE,CAAC;AACvB,CAAC"}

package/dist/adapters/github-actions.d.ts

@@ -0,0 +1,44 @@
+/**
+ * GitHub Actions failure adapter.
+ *
+ *   GET /repos/{owner}/{repo}/actions/runs?status=failure&per_page=100
+ *
+ * Maps each failed workflow run to an `Incident`. Useful for repos that don't
+ * have a paid observability stack but DO have CI: a failed deploy or test run
+ * IS an incident.
+ *
+ *   • title:      workflow name + run number + head commit subject
+ *   • occurredAt: run.run_started_at
+ *   • severity:   "error" (always — these are red CI runs)
+ *   • affectedFiles: pulled from the run's commit if available
+ *   • url:        run.html_url
+ */
+import type { Incident, correlate as CorrelateNS } from "@mneme-ai/core";
+export interface GitHubActionsAdapterOptions {
+    owner: string;
+    repo: string;
+    /** Token with `actions:read` and `contents:read`. Use a fine-grained PAT or installation token. */
+    token: string;
+    baseUrl?: string;
+    /** Cap on runs fetched. Default 1000. */
+    maxRuns?: number;
+    /** Per-request timeout (ms). */
+    timeoutMs?: number;
+    /** Filter to a single workflow file (e.g. "deploy.yml"). */
+    workflow?: string;
+}
+export declare class GitHubActionsAdapter implements CorrelateNS.IncidentAdapter {
+    readonly source: "github";
+    private readonly base;
+    private readonly token;
+    private readonly owner;
+    private readonly repo;
+    private readonly maxRuns;
+    private readonly timeoutMs;
+    private readonly workflow?;
+    constructor(opts: GitHubActionsAdapterOptions);
+    fetch(opts: CorrelateNS.FetchIncidentOptions): Promise<Incident[]>;
+    private request;
+    private mapRun;
+}
+//# sourceMappingURL=github-actions.d.ts.map

package/dist/adapters/github-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-actions.d.ts","sourceRoot":"","sources":["../../src/adapters/github-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEzE,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,qBAAa,oBAAqB,YAAW,WAAW,CAAC,eAAe;IACtE,QAAQ,CAAC,MAAM,EAAG,QAAQ,CAAU;IAEpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;gBAEvB,IAAI,EAAE,2BAA2B;IAavC,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,oBAAoB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;YA2B1D,OAAO;IA6BrB,OAAO,CAAC,MAAM;CA2Bf"}

package/dist/adapters/github-actions.js

@@ -0,0 +1,114 @@
+const DEFAULT_BASE = "https://api.github.com";
+export class GitHubActionsAdapter {
+    source = "github";
+    base;
+    token;
+    owner;
+    repo;
+    maxRuns;
+    timeoutMs;
+    workflow;
+    constructor(opts) {
+        if (!opts.owner)
+            throw new Error("GitHubActionsAdapter requires owner");
+        if (!opts.repo)
+            throw new Error("GitHubActionsAdapter requires repo");
+        if (!opts.token)
+            throw new Error("GitHubActionsAdapter requires token");
+        this.base = (opts.baseUrl ?? DEFAULT_BASE).replace(/\/$/, "");
+        this.token = opts.token;
+        this.owner = opts.owner;
+        this.repo = opts.repo;
+        this.maxRuns = Math.max(1, opts.maxRuns ?? 1000);
+        this.timeoutMs = opts.timeoutMs ?? 15_000;
+        this.workflow = opts.workflow;
+    }
+    async fetch(opts) {
+        const params = new URLSearchParams({
+            status: "failure",
+            per_page: "100",
+        });
+        if (opts.since)
+            params.set("created", `>=${opts.since}`);
+        const path = this.workflow
+            ? `/repos/${this.owner}/${this.repo}/actions/workflows/${encodeURIComponent(this.workflow)}/runs`
+            : `/repos/${this.owner}/${this.repo}/actions/runs`;
+        const out = [];
+        let page = 1;
+        while (out.length < this.maxRuns) {
+            const url = `${this.base}${path}?${params.toString()}&page=${page}`;
+            const json = await this.request(url);
+            if (!json || !json.workflow_runs?.length)
+                break;
+            for (const run of json.workflow_runs) {
+                out.push(this.mapRun(run));
+                if (out.length >= this.maxRuns)
+                    break;
+            }
+            if (json.workflow_runs.length < 100)
+                break;
+            page++;
+        }
+        return out;
+    }
+    async request(url, attempt = 0) {
+        const headers = {
+            authorization: `Bearer ${this.token}`,
+            accept: "application/vnd.github+json",
+            "x-github-api-version": "2022-11-28",
+            "user-agent": "mneme/0.1",
+        };
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);
+        try {
+            const res = await fetch(url, { headers, signal: ctrl.signal });
+            if (res.status === 404)
+                return null;
+            if (res.status === 429 || res.status >= 500) {
+                if (attempt >= 4)
+                    throw new Error(`GitHub API ${res.status} after ${attempt} retries`);
+                const retryAfter = Number(res.headers.get("retry-after") ?? 0);
+                const backoff = retryAfter > 0 ? retryAfter * 1000 : 2 ** attempt * 500;
+                await new Promise((r) => setTimeout(r, backoff));
+                return this.request(url, attempt + 1);
+            }
+            if (!res.ok) {
+                const txt = await res.text();
+                throw new Error(`GitHub API ${res.status}: ${txt.slice(0, 200)}`);
+            }
+            return (await res.json());
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    mapRun(run) {
+        const id = `github-actions:${run.id}`;
+        const title = `${run.name} #${run.run_number}: ${run.display_title ?? "(no title)"}`;
+        const affectedFiles = [];
+        if (run.head_commit?.message) {
+            // Heuristic: if the commit message references files, pull them out.
+            const m = run.head_commit.message.match(/[\w./\\-]+\.(?:ts|tsx|js|jsx|py|go|rs|java|kt|cs|rb|php)/g);
+            if (m)
+                affectedFiles.push(...m);
+        }
+        return {
+            id,
+            source: "github",
+            externalId: String(run.id),
+            title: title.slice(0, 240),
+            occurredAt: run.run_started_at ?? run.created_at,
+            severity: "error",
+            affectedFiles: affectedFiles.length ? Array.from(new Set(affectedFiles)) : undefined,
+            url: run.html_url,
+            metadata: {
+                workflow: run.name,
+                runNumber: run.run_number,
+                headBranch: run.head_branch,
+                headSha: run.head_sha,
+                event: run.event,
+            },
+        };
+    }
+}
+//# sourceMappingURL=github-actions.js.map

package/dist/adapters/github-actions.js.map

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

package/dist/adapters/manual.d.ts

@@ -0,0 +1,20 @@
+import type { Incident, correlate as CorrelateNS } from "@mneme-ai/core";
+/**
+ * Manual JSON incident adapter — works today.
+ *
+ * Reads a JSON file shaped like:
+ *   [
+ *     { "id": "INC-1", "title": "Stripe webhook 500s", "occurredAt": "2025-09-01T10:00:00Z",
+ *       "severity": "error", "affectedFiles": ["src/payment.ts"], "url": "https://..." }
+ *   ]
+ *
+ * Useful for: bootstrapping a customer that doesn't have an observability platform yet, or
+ * importing from CSV/spreadsheet exports.
+ */
+export declare class ManualJsonAdapter implements CorrelateNS.IncidentAdapter {
+    private readonly path;
+    readonly source: "manual";
+    constructor(path: string);
+    fetch(_opts: CorrelateNS.FetchIncidentOptions): Promise<Incident[]>;
+}
+//# sourceMappingURL=manual.d.ts.map

package/dist/adapters/manual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual.d.ts","sourceRoot":"","sources":["../../src/adapters/manual.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEzE;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAkB,YAAW,WAAW,CAAC,eAAe;IAGvD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,MAAM,EAAG,QAAQ,CAAU;gBAEP,IAAI,EAAE,MAAM;IAEnC,KAAK,CAAC,KAAK,EAAE,WAAW,CAAC,oBAAoB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAM1E"}

package/dist/adapters/manual.js

@@ -0,0 +1,47 @@
+import { readFileSync } from "node:fs";
+/**
+ * Manual JSON incident adapter — works today.
+ *
+ * Reads a JSON file shaped like:
+ *   [
+ *     { "id": "INC-1", "title": "Stripe webhook 500s", "occurredAt": "2025-09-01T10:00:00Z",
+ *       "severity": "error", "affectedFiles": ["src/payment.ts"], "url": "https://..." }
+ *   ]
+ *
+ * Useful for: bootstrapping a customer that doesn't have an observability platform yet, or
+ * importing from CSV/spreadsheet exports.
+ */
+export class ManualJsonAdapter {
+    path;
+    source = "manual";
+    constructor(path) {
+        this.path = path;
+    }
+    async fetch(_opts) {
+        const raw = readFileSync(this.path, "utf8");
+        const arr = JSON.parse(raw);
+        if (!Array.isArray(arr))
+            throw new Error(`${this.path} did not contain a JSON array`);
+        return arr.map((row, i) => normalize(row, i));
+    }
+}
+function normalize(row, idx) {
+    if (!row.title)
+        throw new Error(`incident at index ${idx} is missing 'title'`);
+    if (!row.occurredAt)
+        throw new Error(`incident at index ${idx} is missing 'occurredAt'`);
+    return {
+        id: String(row.id ?? `manual-${idx}`),
+        source: "manual",
+        externalId: row.externalId,
+        title: String(row.title),
+        occurredAt: String(row.occurredAt),
+        resolvedAt: row.resolvedAt,
+        severity: (row.severity ?? "error"),
+        affectedFiles: row.affectedFiles,
+        stackFrames: row.stackFrames,
+        url: row.url,
+        metadata: row.metadata,
+    };
+}
+//# sourceMappingURL=manual.js.map

package/dist/adapters/manual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual.js","sourceRoot":"","sources":["../../src/adapters/manual.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,iBAAiB;IAGC;IAFpB,MAAM,GAAG,QAAiB,CAAC;IAEpC,YAA6B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAE7C,KAAK,CAAC,KAAK,CAAC,KAAuC;QACjD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,+BAA+B,CAAC,CAAC;QACtF,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;CACF;AAED,SAAS,SAAS,CAAC,GAAQ,EAAE,GAAW;IACtC,IAAI,CAAC,GAAG,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,qBAAqB,CAAC,CAAC;IAC/E,IAAI,CAAC,GAAG,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,0BAA0B,CAAC,CAAC;IACzF,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,UAAU,GAAG,EAAE,CAAC;QACrC,MAAM,EAAE,QAAQ;QAChB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;QAClC,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,QAAQ,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAyB;QAC3D,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,QAAQ,EAAE,GAAG,CAAC,QAAQ;KACvB,CAAC;AACJ,CAAC"}

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

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

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

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

package/dist/adapters/manual.test.js

@@ -0,0 +1,54 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { ManualJsonAdapter } from "./manual.js";
+let tmpDir;
+let path;
+beforeEach(() => {
+    tmpDir = mkdtempSync(join(tmpdir(), "mneme-manual-"));
+    path = join(tmpDir, "incidents.json");
+});
+afterEach(() => {
+    rmSync(tmpDir, { recursive: true, force: true });
+});
+describe("ManualJsonAdapter", () => {
+    it("loads valid incidents", async () => {
+        writeFileSync(path, JSON.stringify([
+            {
+                id: "INC-1",
+                title: "Stripe webhook 500",
+                occurredAt: "2025-01-15T10:00:00Z",
+                severity: "error",
+            },
+        ]));
+        const adapter = new ManualJsonAdapter(path);
+        const incidents = await adapter.fetch({});
+        expect(incidents).toHaveLength(1);
+        expect(incidents[0].title).toBe("Stripe webhook 500");
+        expect(incidents[0].source).toBe("manual");
+    });
+    it("auto-fills id when missing", async () => {
+        writeFileSync(path, JSON.stringify([{ title: "x", occurredAt: "2025-01-01T00:00:00Z" }]));
+        const adapter = new ManualJsonAdapter(path);
+        const incidents = await adapter.fetch({});
+        expect(incidents[0].id).toBe("manual-0");
+    });
+    it("defaults severity to 'error'", async () => {
+        writeFileSync(path, JSON.stringify([{ title: "x", occurredAt: "2025-01-01T00:00:00Z" }]));
+        const adapter = new ManualJsonAdapter(path);
+        const [inc] = await adapter.fetch({});
+        expect(inc.severity).toBe("error");
+    });
+    it("throws if file is not a JSON array", async () => {
+        writeFileSync(path, JSON.stringify({ not: "array" }));
+        const adapter = new ManualJsonAdapter(path);
+        await expect(adapter.fetch({})).rejects.toThrow(/JSON array/);
+    });
+    it("throws on missing required fields", async () => {
+        writeFileSync(path, JSON.stringify([{ id: "x" }]));
+        const adapter = new ManualJsonAdapter(path);
+        await expect(adapter.fetch({})).rejects.toThrow(/title/);
+    });
+});
+//# sourceMappingURL=manual.test.js.map

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

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

package/dist/adapters/sentry.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Sentry incident adapter — real implementation.
+ *
+ * The Sentry REST API gives us issues with first/last seen timestamps and
+ * culprit/frames. We fetch the issue list, optionally fetch the latest event
+ * for each to get stack frames, and map every result onto the Mneme `Incident`
+ * shape so the temporal correlation engine can rank against commits.
+ *
+ *   Endpoint reference:
+ *     GET /api/0/projects/{org}/{project}/issues/?statsPeriod=...
+ *     GET /api/0/issues/{id}/events/latest/
+ *
+ *   Auth: Bearer <token>. Token must have `event:read` and `project:read`.
+ *
+ * This adapter is opt-in. The token never touches disk. Rate-limit handling
+ * matches the GitHub adapter (Retry-After + exponential backoff on 429/5xx).
+ */
+import type { Incident, correlate as CorrelateNS } from "@mneme-ai/core";
+export interface SentryAdapterOptions {
+    orgSlug: string;
+    projectSlug: string;
+    apiToken: string;
+    /** https://sentry.io for SaaS, https://sentry.your-co.com for self-hosted. */
+    baseUrl?: string;
+    /** Concurrent event-detail requests. Default 4. */
+    concurrency?: number;
+    /** Per-request timeout (ms). */
+    timeoutMs?: number;
+    /** Pull stack frames from the most recent event of each issue. Default true. */
+    fetchStackFrames?: boolean;
+    /** Cap on issues fetched. Default 1000. */
+    maxIssues?: number;
+}
+export declare class SentryAdapter implements CorrelateNS.IncidentAdapter {
+    readonly source: "sentry";
+    private readonly base;
+    private readonly token;
+    private readonly orgSlug;
+    private readonly projectSlug;
+    private readonly concurrency;
+    private readonly timeoutMs;
+    private readonly fetchStackFrames;
+    private readonly maxIssues;
+    constructor(opts: SentryAdapterOptions);
+    fetch(opts: CorrelateNS.FetchIncidentOptions): Promise<Incident[]>;
+    private listIssues;
+    private mapIssue;
+    private fetchLatestEventFrames;
+    private requestWithLink;
+}
+//# sourceMappingURL=sentry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sentry.d.ts","sourceRoot":"","sources":["../../src/adapters/sentry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAc,SAAS,IAAI,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAErF,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,qBAAa,aAAc,YAAW,WAAW,CAAC,eAAe;IAC/D,QAAQ,CAAC,MAAM,EAAG,QAAQ,CAAU;IAEpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,IAAI,EAAE,oBAAoB;IAchC,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,oBAAoB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;YA2B1D,UAAU;IA0BxB,OAAO,CAAC,QAAQ,CAoBb;YAEW,sBAAsB;YA0BtB,eAAe;CAkC9B"}