instar 1.3.26 → 1.3.28

package/dist/monitoring/FailureLedger.js

@@ -0,0 +1,524 @@
+/**
+ * FailureLedger — dev-process failure forensics for instar self-hosting.
+ *
+ * Records failures that trace back to something we built, attributes each to
+ * the spec / initiative / project AND the dev toolchain that produced it, and
+ * exposes the data to the analyzer + dashboard. Part of the Failure-Learning
+ * Loop (docs/specs/FAILURE-LEARNING-LOOP-SPEC.md, converged + approved
+ * 2026-05-26).
+ *
+ * Storage (spec §4.2, round-3 decision): a DEDICATED SQLite table with
+ * first-class indexed columns (build_skill, category, initiative_id,
+ * detected_at, attribution, provenance) — explicitly NOT the TaskFlow `flows`
+ * blob, so the analyzer's group-by queries are indexed rather than a
+ * cache-rebuild + JS filter. Append/upsert-only, no flow lifecycle.
+ *
+ * Key invariants:
+ *  - dedupeKey upsert (spec §4.2 M5): a repeat of the same
+ *    (source, causeCommitOid, category) increments occurrenceCount instead of
+ *    duplicating, so a flapping/flaky source can never manufacture support.
+ *  - mandatory ifMatch OCC (spec §4.2 M4): every mutation supplies the prior
+ *    version; a stale write loses (conflict) — no last-writer-win.
+ *  - COUNT(DISTINCT) diversity (spec §4.4): distinct sessions / cause-commits
+ *    for the source-diversity gate are computed over a bounded occurrences
+ *    table, never an unbounded set stored on the record.
+ *  - redaction (spec §4.8 C7): detail.full is internal-only — toApiView() and
+ *    every route serve detail.redacted ONLY. full never leaves over HTTP.
+ *  - fail-open (spec §4.2 m9): a write error logs and drops; it never throws
+ *    back into the commit / reconciler / route that observed the failure.
+ */
+import Database from 'better-sqlite3';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { NativeModuleHealer } from '../memory/NativeModuleHealer.js';
+// ── Schema ────────────────────────────────────────────────────────────
+const SCHEMA = [
+    `CREATE TABLE IF NOT EXISTS failure_records (
+     id                     TEXT PRIMARY KEY,
+     dedupe_key             TEXT NOT NULL UNIQUE,
+     occurrence_count       INTEGER NOT NULL DEFAULT 1,
+     detected_at            TEXT NOT NULL,
+     filed_by               TEXT NOT NULL,
+     source                 TEXT NOT NULL,
+     severity               TEXT NOT NULL,
+     summary                TEXT NOT NULL,
+     detail_redacted        TEXT NOT NULL DEFAULT '',
+     detail_full            TEXT NOT NULL DEFAULT '',
+     category               TEXT NOT NULL DEFAULT 'unknown',
+     initiative_id          TEXT,
+     project_id             TEXT,
+     spec_path              TEXT,
+     cause_commit_oid       TEXT,
+     fix_commit_oid         TEXT,
+     pr_number              INTEGER,
+     toolchain_ref          TEXT,
+     build_skill            TEXT,
+     provenance             TEXT NOT NULL DEFAULT 'unknown',
+     attribution            TEXT NOT NULL DEFAULT 'inferred',
+     attribution_confidence REAL NOT NULL DEFAULT 0,
+     status                 TEXT NOT NULL DEFAULT 'open',
+     learning_id            TEXT,
+     created_at             TEXT NOT NULL,
+     updated_at             TEXT NOT NULL,
+     version                INTEGER NOT NULL DEFAULT 1
+   )`,
+    // First-class indexes for the analyzer's group-by query path (spec §4.4):
+    `CREATE INDEX IF NOT EXISTS idx_failure_detected ON failure_records(detected_at)`,
+    `CREATE INDEX IF NOT EXISTS idx_failure_category ON failure_records(category)`,
+    `CREATE INDEX IF NOT EXISTS idx_failure_initiative ON failure_records(initiative_id)`,
+    `CREATE INDEX IF NOT EXISTS idx_failure_buildskill ON failure_records(build_skill)`,
+    `CREATE INDEX IF NOT EXISTS idx_failure_attribution ON failure_records(attribution, provenance)`,
+    // Bounded occurrence log — feeds COUNT(DISTINCT) for the diversity gate
+    // (spec §4.4) without growing an unbounded set on the deduped record.
+    `CREATE TABLE IF NOT EXISTS failure_occurrences (
+     id           INTEGER PRIMARY KEY AUTOINCREMENT,
+     dedupe_key   TEXT NOT NULL,
+     filed_by     TEXT NOT NULL,
+     cause_commit TEXT,
+     detected_at  TEXT NOT NULL
+   )`,
+    `CREATE INDEX IF NOT EXISTS idx_occ_dedupe ON failure_occurrences(dedupe_key)`,
+    // Per-machine monotonic sequence for machine-scoped IDs.
+    `CREATE TABLE IF NOT EXISTS failure_seq (
+     machine_id TEXT PRIMARY KEY,
+     next_seq   INTEGER NOT NULL DEFAULT 1
+   )`,
+    // Discovered process-gap insights (spec §4.4/§4.6.1). identity_key is
+    // content-stable across analyzer runs so the same pattern is updated, never
+    // re-announced (the tunnel-spam stable-key lesson).
+    `CREATE TABLE IF NOT EXISTS failure_insights (
+     id                     TEXT PRIMARY KEY,
+     identity_key           TEXT NOT NULL UNIQUE,
+     discovered_at          TEXT NOT NULL,
+     summary                TEXT NOT NULL,
+     recommendation         TEXT NOT NULL DEFAULT '',
+     supporting_failure_ids TEXT NOT NULL DEFAULT '[]',
+     distinct_sessions      INTEGER NOT NULL DEFAULT 0,
+     distinct_cause_commits INTEGER NOT NULL DEFAULT 0,
+     status                 TEXT NOT NULL DEFAULT 'discovered',
+     acted_on_via           TEXT,
+     verify_window_start    TEXT,
+     verify_window_end      TEXT,
+     target_category        TEXT,
+     baseline_rate          REAL,
+     reopen_count           INTEGER NOT NULL DEFAULT 0,
+     verified_outcome       TEXT NOT NULL DEFAULT 'pending',
+     announced              INTEGER NOT NULL DEFAULT 0,
+     created_at             TEXT NOT NULL,
+     updated_at             TEXT NOT NULL,
+     version                INTEGER NOT NULL DEFAULT 1
+   )`,
+];
+// ── FailureLedger ─────────────────────────────────────────────────────
+export class FailureLedger {
+    db;
+    machineId;
+    onError;
+    constructor(opts) {
+        this.machineId = (opts.machineId || os.hostname() || 'local')
+            .replace(/[^a-zA-Z0-9]+/g, '-')
+            .replace(/^-+|-+$/g, '')
+            .slice(0, 24) || 'local';
+        this.onError =
+            opts.onError ?? ((where, err) => console.error(`[FailureLedger] ${where}:`, err));
+        if (opts.dbPath !== ':memory:') {
+            fs.mkdirSync(path.dirname(opts.dbPath), { recursive: true });
+        }
+        this.db = NativeModuleHealer.openWithHealSync('FailureLedger', () => new Database(opts.dbPath));
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('synchronous = NORMAL');
+        for (const ddl of SCHEMA)
+            this.db.exec(ddl);
+    }
+    /** Deterministic dedupe key (spec §4.2 M5). */
+    static dedupeKey(source, causeCommitOid, category) {
+        return `${source}:${causeCommitOid || 'null'}:${category}`;
+    }
+    nextId() {
+        const row = this.db
+            .prepare(`SELECT next_seq FROM failure_seq WHERE machine_id = ?`)
+            .get(this.machineId);
+        const seq = row?.next_seq ?? 1;
+        this.db
+            .prepare(`INSERT INTO failure_seq (machine_id, next_seq) VALUES (?, ?)
+         ON CONFLICT(machine_id) DO UPDATE SET next_seq = ?`)
+            .run(this.machineId, seq + 1, seq + 1);
+        return `FAIL-${this.machineId}-${String(seq).padStart(3, '0')}`;
+    }
+    /**
+     * Open (or upsert) a failure record. A repeat on the same dedupeKey
+     * increments occurrenceCount and logs a distinct occurrence rather than
+     * duplicating. Fail-open: returns null on any storage error.
+     */
+    open(input) {
+        try {
+            const category = input.category ?? 'unknown';
+            const dedupeKey = FailureLedger.dedupeKey(input.source, input.causeCommitOid, category);
+            const now = new Date().toISOString();
+            const detectedAt = input.detectedAt ?? now;
+            const txn = this.db.transaction(() => {
+                // Always log the occurrence (feeds COUNT(DISTINCT) diversity gate).
+                this.db
+                    .prepare(`INSERT INTO failure_occurrences (dedupe_key, filed_by, cause_commit, detected_at)
+             VALUES (?, ?, ?, ?)`)
+                    .run(dedupeKey, input.filedBy, input.causeCommitOid ?? null, detectedAt);
+                const existing = this.db
+                    .prepare(`SELECT id FROM failure_records WHERE dedupe_key = ?`)
+                    .get(dedupeKey);
+                if (existing) {
+                    this.db
+                        .prepare(`UPDATE failure_records
+                 SET occurrence_count = occurrence_count + 1, updated_at = ?, version = version + 1
+               WHERE id = ?`)
+                        .run(now, existing.id);
+                    return existing.id;
+                }
+                const id = this.nextId();
+                this.db
+                    .prepare(`INSERT INTO failure_records
+               (id, dedupe_key, occurrence_count, detected_at, filed_by, source, severity,
+                summary, detail_redacted, detail_full, category, initiative_id, project_id,
+                spec_path, cause_commit_oid, pr_number, toolchain_ref, build_skill, provenance,
+                attribution, attribution_confidence, status, created_at, updated_at, version)
+             VALUES
+               (@id, @dedupeKey, 1, @detectedAt, @filedBy, @source, @severity,
+                @summary, @detailRedacted, @detailFull, @category, @initiativeId, @projectId,
+                @specPath, @causeCommitOid, @prNumber, @toolchainRef, @buildSkill, @provenance,
+                @attribution, @attributionConfidence, 'open', @createdAt, @updatedAt, 1)`)
+                    .run({
+                    id,
+                    dedupeKey,
+                    detectedAt,
+                    filedBy: input.filedBy,
+                    source: input.source,
+                    severity: input.severity,
+                    summary: input.summary,
+                    detailRedacted: input.detail.redacted,
+                    detailFull: input.detail.full,
+                    category,
+                    initiativeId: input.initiativeId ?? null,
+                    projectId: input.projectId ?? null,
+                    specPath: input.specPath ?? null,
+                    causeCommitOid: input.causeCommitOid ?? null,
+                    prNumber: input.prNumber ?? null,
+                    toolchainRef: input.toolchainRef ?? null,
+                    buildSkill: input.buildSkill ?? null,
+                    provenance: input.provenance ?? 'unknown',
+                    attribution: input.attribution,
+                    attributionConfidence: input.attributionConfidence ?? 0,
+                    createdAt: now,
+                    updatedAt: now,
+                });
+                return id;
+            });
+            const id = txn();
+            return this.get(id);
+        }
+        catch (err) {
+            this.onError('open', err);
+            return null;
+        }
+    }
+    get(id) {
+        const row = this.db.prepare(`SELECT * FROM failure_records WHERE id = ?`).get(id);
+        return row ? this.rowToRecord(row) : null;
+    }
+    getByDedupeKey(dedupeKey) {
+        const row = this.db
+            .prepare(`SELECT * FROM failure_records WHERE dedupe_key = ?`)
+            .get(dedupeKey);
+        return row ? this.rowToRecord(row) : null;
+    }
+    list(filter = {}) {
+        const where = [];
+        const params = {};
+        if (filter.source) {
+            where.push('source = @source');
+            params.source = filter.source;
+        }
+        if (filter.category) {
+            where.push('category = @category');
+            params.category = filter.category;
+        }
+        if (filter.initiativeId) {
+            where.push('initiative_id = @initiativeId');
+            params.initiativeId = filter.initiativeId;
+        }
+        if (filter.attribution) {
+            where.push('attribution = @attribution');
+            params.attribution = filter.attribution;
+        }
+        if (filter.status) {
+            where.push('status = @status');
+            params.status = filter.status;
+        }
+        if (filter.sinceMs) {
+            where.push('detected_at >= @since');
+            params.since = new Date(filter.sinceMs).toISOString();
+        }
+        const limit = filter.limit && filter.limit > 0 ? Math.min(filter.limit, 1000) : 200;
+        const sql = `SELECT * FROM failure_records` +
+            (where.length ? ` WHERE ${where.join(' AND ')}` : '') +
+            ` ORDER BY detected_at DESC LIMIT ${limit}`;
+        return this.db.prepare(sql).all(params).map((r) => this.rowToRecord(r));
+    }
+    /**
+     * Mutate a record. `ifMatch` is MANDATORY (spec §4.2 M4) — a stale version
+     * loses with {ok:false, conflict:true}. Caller retries (bounded).
+     */
+    update(id, patch, ifMatch) {
+        try {
+            const current = this.get(id);
+            if (!current)
+                return { ok: false, conflict: false, reason: 'not-found' };
+            if (current.version !== ifMatch)
+                return { ok: false, conflict: true, current };
+            const cols = [];
+            const params = { id, ifMatch };
+            const map = {
+                status: 'status', category: 'category', fixCommitOid: 'fix_commit_oid',
+                learningId: 'learning_id', attribution: 'attribution',
+                attributionConfidence: 'attribution_confidence', provenance: 'provenance',
+                buildSkill: 'build_skill', initiativeId: 'initiative_id',
+                projectId: 'project_id', specPath: 'spec_path', toolchainRef: 'toolchain_ref',
+            };
+            for (const [k, v] of Object.entries(patch)) {
+                const col = map[k];
+                if (!col)
+                    continue;
+                cols.push(`${col} = @${k}`);
+                params[k] = v ?? null;
+            }
+            if (cols.length === 0)
+                return { ok: true, record: current };
+            const now = new Date().toISOString();
+            const res = this.db
+                .prepare(`UPDATE failure_records SET ${cols.join(', ')}, updated_at = @now, version = version + 1
+           WHERE id = @id AND version = @ifMatch`)
+                .run({ ...params, now });
+            if (res.changes === 0)
+                return { ok: false, conflict: true, current: this.get(id) ?? undefined };
+            return { ok: true, record: this.get(id) };
+        }
+        catch (err) {
+            this.onError('update', err);
+            return { ok: false, conflict: false, reason: 'storage-error' };
+        }
+    }
+    /** Distinct sessions + cause-commits for the diversity gate (spec §4.4). */
+    distinctCounts(dedupeKey) {
+        const row = this.db
+            .prepare(`SELECT COUNT(DISTINCT filed_by) AS sessions,
+                COUNT(DISTINCT cause_commit) AS commits
+           FROM failure_occurrences WHERE dedupe_key = ?`)
+            .get(dedupeKey);
+        return { sessions: row?.sessions ?? 0, causeCommits: row?.commits ?? 0 };
+    }
+    /**
+     * Analyzer query path (spec §4.4): indexed group-bys directly in SQL, never a
+     * full cache-rebuild + JS filter. Toolchain-blame counts are restricted to
+     * `verified`-provenance, `automatic`-attribution records (claimed / one-tap /
+     * inferred are excluded from blame aggregates). Also reports coverage so a
+     * low-attribution rate reads as low-confidence, not as the rate.
+     */
+    analyze(opts = {}) {
+        const sinceClause = opts.sinceMs ? ` AND detected_at >= @since` : '';
+        const params = opts.sinceMs ? { since: new Date(opts.sinceMs).toISOString() } : {};
+        const total = this.db.prepare(`SELECT COUNT(*) c FROM failure_records WHERE 1=1${sinceClause}`).get(params).c;
+        const attributed = this.db.prepare(`SELECT COUNT(*) c FROM failure_records WHERE attribution = 'automatic'${sinceClause}`).get(params).c;
+        const byCategory = {};
+        for (const r of this.db.prepare(`SELECT category, COUNT(*) c FROM failure_records WHERE 1=1${sinceClause} GROUP BY category`).all(params)) {
+            byCategory[r.category] = r.c;
+        }
+        // Toolchain-blame: verified provenance + automatic attribution only.
+        const byBuildSkill = {};
+        for (const r of this.db.prepare(`SELECT build_skill bs, COUNT(*) c FROM failure_records WHERE provenance = 'verified' AND attribution = 'automatic' AND build_skill IS NOT NULL${sinceClause} GROUP BY build_skill`).all(params)) {
+            byBuildSkill[r.bs] = r.c;
+        }
+        // Coverage-integrity (spec §4.4, round-3 R2-sec-omit): unknown-toolchain by author.
+        const unknownToolchainByAuthor = {};
+        for (const r of this.db.prepare(`SELECT filed_by fb, COUNT(*) c FROM failure_records WHERE provenance = 'unknown'${sinceClause} GROUP BY filed_by`).all(params)) {
+            unknownToolchainByAuthor[r.fb] = r.c;
+        }
+        const noFeatureLink = this.db.prepare(`SELECT COUNT(*) c FROM failure_records WHERE initiative_id IS NULL${sinceClause}`).get(params).c;
+        return { total, attributed, byCategory, byBuildSkill, unknownToolchainByAuthor, noFeatureLink };
+    }
+    // ── Insights (spec §4.4 / §4.6.1) ────────────────────────────────────
+    /**
+     * Upsert an insight keyed on its content-stable identityKey. A re-discovery
+     * UPDATES the existing record (refreshes evidence + counts) but PRESERVES its
+     * lifecycle (status/actedOnVia/verify window/announced) — so a pattern is
+     * never re-announced and an in-flight loop is never reset (spec §4.5 stable-key).
+     * Returns the resulting insight (fail-open: null on storage error).
+     */
+    upsertInsight(input) {
+        try {
+            const now = new Date().toISOString();
+            const existing = this.getInsightByIdentity(input.identityKey);
+            if (existing) {
+                this.db
+                    .prepare(`UPDATE failure_insights
+               SET summary=@summary, recommendation=@recommendation,
+                   supporting_failure_ids=@ids, distinct_sessions=@ds,
+                   distinct_cause_commits=@dc, target_category=@tc,
+                   baseline_rate=@br, updated_at=@now, version=version+1
+             WHERE id=@id`)
+                    .run({
+                    id: existing.id, summary: input.summary, recommendation: input.recommendation,
+                    ids: JSON.stringify(input.supportingFailureIds), ds: input.distinctSessions,
+                    dc: input.distinctCauseCommits, tc: input.targetCategory ?? null,
+                    br: input.baselineRate ?? null, now,
+                });
+                return this.getInsight(existing.id);
+            }
+            const id = `INS-${this.machineId}-${this.nextInsightSeq()}`;
+            this.db
+                .prepare(`INSERT INTO failure_insights
+             (id, identity_key, discovered_at, summary, recommendation,
+              supporting_failure_ids, distinct_sessions, distinct_cause_commits,
+              target_category, baseline_rate,
+              status, reopen_count, verified_outcome, announced, created_at, updated_at, version)
+           VALUES (@id,@ik,@now,@summary,@rec,@ids,@ds,@dc,@tc,@br,'discovered',0,'pending',0,@now,@now,1)`)
+                .run({
+                id, ik: input.identityKey, now, summary: input.summary, rec: input.recommendation,
+                ids: JSON.stringify(input.supportingFailureIds), ds: input.distinctSessions, dc: input.distinctCauseCommits,
+                tc: input.targetCategory ?? null, br: input.baselineRate ?? null,
+            });
+            return this.getInsight(id);
+        }
+        catch (err) {
+            this.onError('upsertInsight', err);
+            return null;
+        }
+    }
+    nextInsightSeq() {
+        const key = `insight:${this.machineId}`;
+        const row = this.db.prepare(`SELECT next_seq FROM failure_seq WHERE machine_id = ?`).get(key);
+        const seq = row?.next_seq ?? 1;
+        this.db.prepare(`INSERT INTO failure_seq (machine_id, next_seq) VALUES (?, ?) ON CONFLICT(machine_id) DO UPDATE SET next_seq = ?`).run(key, seq + 1, seq + 1);
+        return String(seq).padStart(3, '0');
+    }
+    getInsight(id) {
+        const row = this.db.prepare(`SELECT * FROM failure_insights WHERE id = ?`).get(id);
+        return row ? this.rowToInsight(row) : null;
+    }
+    getInsightByIdentity(identityKey) {
+        const row = this.db.prepare(`SELECT * FROM failure_insights WHERE identity_key = ?`).get(identityKey);
+        return row ? this.rowToInsight(row) : null;
+    }
+    listInsights(filter = {}) {
+        const sql = filter.status
+            ? `SELECT * FROM failure_insights WHERE status = ? ORDER BY discovered_at DESC`
+            : `SELECT * FROM failure_insights ORDER BY discovered_at DESC`;
+        const rows = (filter.status ? this.db.prepare(sql).all(filter.status) : this.db.prepare(sql).all());
+        return rows.map((r) => this.rowToInsight(r));
+    }
+    updateInsight(id, patch, ifMatch) {
+        try {
+            const current = this.getInsight(id);
+            if (!current)
+                return { ok: false, conflict: false, reason: 'not-found' };
+            if (current.version !== ifMatch)
+                return { ok: false, conflict: true, current };
+            const map = {
+                status: 'status', actedOnVia: 'acted_on_via', verifyWindowStart: 'verify_window_start',
+                verifyWindowEnd: 'verify_window_end', targetCategory: 'target_category', baselineRate: 'baseline_rate',
+                reopenCount: 'reopen_count', verifiedOutcome: 'verified_outcome', announced: 'announced',
+            };
+            const cols = [];
+            const params = { id, ifMatch };
+            for (const [k, v] of Object.entries(patch)) {
+                const col = map[k];
+                if (!col)
+                    continue;
+                cols.push(`${col} = @${k}`);
+                params[k] = k === 'announced' ? (v ? 1 : 0) : (v ?? null);
+            }
+            if (cols.length === 0)
+                return { ok: true, record: current };
+            const now = new Date().toISOString();
+            const res = this.db.prepare(`UPDATE failure_insights SET ${cols.join(', ')}, updated_at=@now, version=version+1 WHERE id=@id AND version=@ifMatch`).run({ ...params, now });
+            if (res.changes === 0)
+                return { ok: false, conflict: true, current: this.getInsight(id) ?? undefined };
+            return { ok: true, record: this.getInsight(id) };
+        }
+        catch (err) {
+            this.onError('updateInsight', err);
+            return { ok: false, conflict: false, reason: 'storage-error' };
+        }
+    }
+    rowToInsight(r) {
+        let ids = [];
+        try {
+            ids = JSON.parse(r.supporting_failure_ids || '[]');
+        }
+        catch {
+            ids = [];
+        }
+        return {
+            id: r.id,
+            identityKey: r.identity_key,
+            discoveredAt: r.discovered_at,
+            summary: r.summary,
+            recommendation: r.recommendation ?? '',
+            supportingFailureIds: ids,
+            distinctSessions: r.distinct_sessions,
+            distinctCauseCommits: r.distinct_cause_commits,
+            status: r.status,
+            actedOnVia: r.acted_on_via ?? undefined,
+            verifyWindowStart: r.verify_window_start ?? undefined,
+            verifyWindowEnd: r.verify_window_end ?? undefined,
+            targetCategory: r.target_category ?? undefined,
+            baselineRate: r.baseline_rate ?? undefined,
+            reopenCount: r.reopen_count,
+            verifiedOutcome: r.verified_outcome,
+            announced: !!r.announced,
+            createdAt: r.created_at,
+            updatedAt: r.updated_at,
+            version: r.version,
+        };
+    }
+    /** Strip detail.full — the ONLY shape that may cross an HTTP boundary (spec §4.8). */
+    static toApiView(record) {
+        const { detail, ...rest } = record;
+        return { ...rest, detail: { redacted: detail.redacted } };
+    }
+    close() {
+        try {
+            this.db.close();
+        }
+        catch { /* ignore */ }
+    }
+    rowToRecord(r) {
+        return {
+            id: r.id,
+            dedupeKey: r.dedupe_key,
+            occurrenceCount: r.occurrence_count,
+            detectedAt: r.detected_at,
+            filedBy: r.filed_by,
+            source: r.source,
+            severity: r.severity,
+            summary: r.summary,
+            detail: { redacted: r.detail_redacted ?? '', full: r.detail_full ?? '' },
+            category: r.category,
+            initiativeId: r.initiative_id ?? undefined,
+            projectId: r.project_id ?? undefined,
+            specPath: r.spec_path ?? undefined,
+            causeCommitOid: r.cause_commit_oid ?? undefined,
+            fixCommitOid: r.fix_commit_oid ?? undefined,
+            prNumber: r.pr_number ?? undefined,
+            toolchainRef: r.toolchain_ref ?? undefined,
+            buildSkill: r.build_skill ?? undefined,
+            provenance: r.provenance ?? 'unknown',
+            attribution: r.attribution,
+            attributionConfidence: r.attribution_confidence,
+            status: r.status,
+            learningId: r.learning_id ?? undefined,
+            createdAt: r.created_at,
+            updatedAt: r.updated_at,
+            version: r.version,
+        };
+    }
+}
+//# sourceMappingURL=FailureLedger.js.map

package/dist/monitoring/FailureLedger.js.map

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

package/dist/monitoring/FailureLoopDriver.d.ts

@@ -0,0 +1,92 @@
+/**
+ * FailureLoopDriver — the closed self-improvement loop (spec §4.6.1).
+ *
+ *   discover (FailureAnalyzer) → IMPLEMENT (this: open a tracked item) →
+ *   deploy (normal spec→build→rollout, human-driven) → VERIFY (this).
+ *
+ * The headline safety property — "the loop can never change the process on its
+ * own" — is enforced BY CONSTRUCTION (spec §4.6.1 step 3, round-2 BL-2):
+ *
+ *   The driver's injected capabilities are ONLY `addAction` (an Evolution
+ *   Action) and `createInitiative` (a draft Initiative in `needs-user`). It is
+ *   given NO ability to create an EvolutionProposal — and a proposal is the
+ *   ONLY thing the autonomous auto-implement evaluator acts on. So an
+ *   auto-implemented process change is unreachable for anything this loop
+ *   produces, regardless of `evolutionApprovalMode`. There is no field to forge
+ *   and no layer to misplace: the capability simply isn't wired in.
+ *
+ * Verify (step 5): on an `acted-on` insight past its verification window, the
+ * driver computes the post-change rate of the targeted failure category and
+ * sets the outcome — labeled CORRELATIONAL, never causal. It requires a minimum
+ * post-window exposure before concluding (else `insufficient-exposure` → extend
+ * once → `inconclusive`), and caps reopens so a non-droppable class can never
+ * churn forever (spec §4.6.1 M3).
+ *
+ * NOTE (v1 simplification, tracked): "exposure normalization" here is the raw
+ * post-window category count vs. baseline. The full features-of-category-shipped
+ * denominator is a later refinement — it can only make the outcome MORE
+ * conservative, never auto-implement anything (the authority guard is unaffected).
+ */
+import type { FailureLedger, InsightRecord } from './FailureLedger.js';
+/** The ONLY mutation capabilities the loop is given. Deliberately excludes any
+ *  proposal-creation path (that's the by-construction authority guard). */
+export interface LoopDeps {
+    /** Open an Evolution Action (tracked self-improvement to-do). */
+    addAction: (opts: {
+        title: string;
+        description: string;
+        priority?: 'critical' | 'high' | 'medium' | 'low';
+        source?: string;
+        tags?: string[];
+    }) => {
+        id: string;
+    };
+    /** Open a draft Initiative in needs-user (a human approves turning it real). */
+    createInitiative: (input: {
+        id: string;
+        title: string;
+        description: string;
+        phases: {
+            name: string;
+            status: string;
+        }[];
+        needsUser: boolean;
+        needsUserReason?: string;
+    }) => Promise<{
+        id: string;
+    }>;
+    now?: () => number;
+    /** Days to watch the targeted failure class after the fix ships (default 42 = 6 weeks). */
+    verifyWindowDays?: number;
+    /** Max reopens before terminal `inconclusive` (default 2). */
+    maxReopens?: number;
+    /** Minimum post-window category activity required to conclude (default 1). */
+    minPostExposure?: number;
+}
+export interface ActResult {
+    actedOn: InsightRecord[];
+}
+export interface VerifyResult {
+    evaluated: InsightRecord[];
+}
+export declare class FailureLoopDriver {
+    private readonly ledger;
+    private readonly deps;
+    constructor(ledger: FailureLedger, deps: LoopDeps);
+    private now;
+    /**
+     * IMPLEMENT step: for each newly-`discovered` insight, open a tracked Action +
+     * a draft Initiative (needs-user) and move it to `acted-on` with a verification
+     * window. Never mints a proposal (see class docs). Idempotent: an insight
+     * already past `discovered` is skipped.
+     */
+    actOnNewInsights(): Promise<ActResult>;
+    /**
+     * VERIFY step: for each `acted-on` insight whose window has elapsed, decide
+     * the (correlational) outcome. Drop below baseline → verified-effective;
+     * no drop → verified-ineffective + reopen (capped → inconclusive); too little
+     * post-window activity → insufficient-exposure (extend once → inconclusive).
+     */
+    runVerification(): VerifyResult;
+}
+//# sourceMappingURL=FailureLoopDriver.d.ts.map

package/dist/monitoring/FailureLoopDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FailureLoopDriver.d.ts","sourceRoot":"","sources":["../../src/monitoring/FailureLoopDriver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAmB,MAAM,oBAAoB,CAAC;AAExF;2EAC2E;AAC3E,MAAM,WAAW,QAAQ;IACvB,iEAAiE;IACjE,SAAS,EAAE,CAAC,IAAI,EAAE;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;QAClD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,KAAK;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACrB,gFAAgF;IAChF,gBAAgB,EAAE,CAAC,KAAK,EAAE;QACxB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC3C,SAAS,EAAE,OAAO,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IAAG,OAAO,EAAE,aAAa,EAAE,CAAC;CAAE;AACxD,MAAM,WAAW,YAAY;IAAG,SAAS,EAAE,aAAa,EAAE,CAAC;CAAE;AAE7D,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAiB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAA5C,MAAM,EAAE,aAAa,EAAmB,IAAI,EAAE,QAAQ;IAEnF,OAAO,CAAC,GAAG;IAEX;;;;;OAKG;IACG,gBAAgB,IAAI,OAAO,CAAC,SAAS,CAAC;IAoC5C;;;;;OAKG;IACH,eAAe,IAAI,YAAY;CA0ChC"}