@gracker/smartperfetto 1.0.13

package/dist/agentv3/selfImprove/feedbackPipeline.js

@@ -0,0 +1,239 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeedbackPipeline = void 0;
+/**
+ * FeedbackPipeline — state machine for the feedback → case → skill
+ * draft → review flow (Plan 44 M1, Spark #95).
+ *
+ * Each `FeedbackPipelineEntry` rides this machine:
+ *
+ *     feedback → case_draft → skill_draft → reviewed → merged
+ *                                                   ↘  rejected
+ *
+ * The transitions are intentionally linear with one branch at the
+ * `reviewed` stage. No back-edges (a rejected entry stays rejected;
+ * resurrecting it means a fresh feedback intake). The reviewer field
+ * is required at any stage advance from `reviewed` onward.
+ *
+ * Storage: independent JSON file at
+ * `backend/logs/feedback_pipeline.json`. Same atomic temp+rename
+ * pattern as the other Plan 44 stores.
+ *
+ * Out of scope:
+ * - Case draft generation (the actual case is created by the caller
+ *   and referenced via the shared `CaseRef` shape; this module only
+ *   tracks the pipeline state, not the case content).
+ * - Skill draft generation (caller-driven).
+ * - MCP tool surface — feedback pipeline is operator-side, not
+ *   agent-callable.
+ *
+ * @module feedbackPipeline
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/** Allowed forward transitions. The graph is intentionally narrow —
+ * any other transition throws so operator scripts cannot accidentally
+ * advance entries past review without the right inputs. */
+const ALLOWED_TRANSITIONS = {
+    feedback: ['case_draft', 'rejected'],
+    case_draft: ['skill_draft', 'rejected'],
+    skill_draft: ['reviewed', 'rejected'],
+    reviewed: ['merged', 'rejected'],
+    merged: [], // terminal
+    rejected: [], // terminal
+};
+/** Stages that require a reviewer name on advance. */
+const REQUIRES_REVIEWER = new Set([
+    'reviewed',
+    'merged',
+    'rejected',
+]);
+class FeedbackPipeline {
+    constructor(storagePath) {
+        this.entries = new Map();
+        this.loaded = false;
+        /** High-water mark of stamped `updatedAt` values. Subsequent stamps
+         * are guaranteed strictly greater so sorting by `updatedAt` desc
+         * stays deterministic even when many ops land in the same ms — a
+         * real concern for rapid-fire pipelines. The mark is reseeded from
+         * the loaded entries so persisted ordering survives across
+         * instances. */
+        this.updatedAtFloor = 0;
+        this.storagePath = storagePath;
+    }
+    load() {
+        if (this.loaded)
+            return;
+        this.loaded = true;
+        if (!fs.existsSync(this.storagePath))
+            return;
+        try {
+            const raw = fs.readFileSync(this.storagePath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (parsed.schemaVersion !== 1 || !Array.isArray(parsed.entries))
+                return;
+            for (const e of parsed.entries) {
+                this.entries.set(e.entryId, e);
+                if (e.updatedAt > this.updatedAtFloor)
+                    this.updatedAtFloor = e.updatedAt;
+            }
+        }
+        catch {
+            // Corrupted JSON: file preserved, in-memory cache stays empty.
+        }
+    }
+    /** Monotonic stamp — strictly greater than every previously
+     * returned value, even when wall clock has not advanced. */
+    nextUpdatedAt() {
+        const wall = Date.now();
+        const next = Math.max(wall, this.updatedAtFloor + 1);
+        this.updatedAtFloor = next;
+        return next;
+    }
+    /** Create a new entry at the `feedback` stage. Throws when an entry
+     * with the same id already exists — the operator should resolve the
+     * existing one (advance or reject) before creating a new one. */
+    createEntry(opts) {
+        this.load();
+        if (this.entries.has(opts.entryId)) {
+            throw new Error(`FeedbackPipelineEntry '${opts.entryId}' already exists; advance or reject first`);
+        }
+        const entry = {
+            entryId: opts.entryId,
+            feedbackId: opts.feedbackId,
+            stage: 'feedback',
+            updatedAt: this.nextUpdatedAt(),
+        };
+        this.entries.set(opts.entryId, entry);
+        this.persist();
+        return entry;
+    }
+    /**
+     * Advance an existing entry to the next stage. Throws on:
+     * - Entry not found
+     * - Target stage not in `ALLOWED_TRANSITIONS[currentStage]`
+     * - Target stage requires a reviewer and `opts.reviewer` is missing
+     *   or whitespace
+     */
+    advance(entryId, opts) {
+        this.load();
+        const existing = this.entries.get(entryId);
+        if (!existing) {
+            throw new Error(`FeedbackPipelineEntry '${entryId}' not found`);
+        }
+        const allowed = ALLOWED_TRANSITIONS[existing.stage];
+        if (!allowed.includes(opts.stage)) {
+            throw new Error(`Illegal transition from '${existing.stage}' to '${opts.stage}'; allowed: [${allowed.join(', ')}]`);
+        }
+        const trimmedReviewer = opts.reviewer?.trim();
+        if (REQUIRES_REVIEWER.has(opts.stage) && !trimmedReviewer) {
+            throw new Error(`Advancing to '${opts.stage}' requires a reviewer name`);
+        }
+        const advanced = {
+            ...existing,
+            stage: opts.stage,
+            updatedAt: this.nextUpdatedAt(),
+            ...(trimmedReviewer ? { reviewer: trimmedReviewer } : {}),
+            // Preserve existing fields; allow per-call updates of case + skillDraftId.
+            ...(opts.case !== undefined ? { case: opts.case } : {}),
+            ...(opts.skillDraftId !== undefined
+                ? { skillDraftId: opts.skillDraftId }
+                : {}),
+        };
+        this.entries.set(entryId, advanced);
+        this.persist();
+        return advanced;
+    }
+    /** Read an entry by id. */
+    getEntry(entryId) {
+        this.load();
+        return this.entries.get(entryId);
+    }
+    /**
+     * List entries optionally filtered by stage. Default sort is by
+     * `updatedAt` descending so the most-recently-touched entries
+     * surface first in operator UIs.
+     */
+    listEntries(opts = {}) {
+        this.load();
+        let out = Array.from(this.entries.values());
+        if (opts.stage)
+            out = out.filter(e => e.stage === opts.stage);
+        out.sort((a, b) => b.updatedAt - a.updatedAt);
+        return out;
+    }
+    /** Remove an entry. Returns whether anything was removed. */
+    removeEntry(entryId) {
+        this.load();
+        const had = this.entries.delete(entryId);
+        if (had)
+            this.persist();
+        return had;
+    }
+    /** Per-stage counts for dashboards. */
+    getStats() {
+        this.load();
+        const out = {
+            feedback: 0,
+            case_draft: 0,
+            skill_draft: 0,
+            reviewed: 0,
+            merged: 0,
+            rejected: 0,
+        };
+        for (const e of this.entries.values())
+            out[e.stage]++;
+        return out;
+    }
+    persist() {
+        const dir = path.dirname(this.storagePath);
+        if (!fs.existsSync(dir))
+            fs.mkdirSync(dir, { recursive: true });
+        // Per-process unique tmp suffix — Codex round E P1#5.
+        const tmp = `${this.storagePath}.tmp.${process.pid}.${Math.random().toString(36).slice(2)}`;
+        const envelope = {
+            schemaVersion: 1,
+            entries: Array.from(this.entries.values()),
+        };
+        fs.writeFileSync(tmp, JSON.stringify(envelope, null, 2), 'utf-8');
+        fs.renameSync(tmp, this.storagePath);
+    }
+}
+exports.FeedbackPipeline = FeedbackPipeline;
+//# sourceMappingURL=feedbackPipeline.js.map

package/dist/agentv3/selfImprove/feedbackPipeline.js.map

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

package/dist/agentv3/selfImprove/hintFingerprint.d.ts

@@ -0,0 +1,14 @@
+export interface CanonicalHintInput {
+    keywords: ReadonlyArray<string>;
+    constraints: string;
+    criticalTools: ReadonlyArray<string>;
+    critical: boolean;
+}
+/**
+ * Compute a 16-char hex fingerprint of a phase_hint's canonical form.
+ * Used by both `phaseHintsRenderer` (input identity / dedup) and
+ * `strategyFingerprint` (drift detection of stored hints) so the two
+ * sides agree on what "the same hint" means.
+ */
+export declare function computeHintFingerprint(input: CanonicalHintInput): string;
+//# sourceMappingURL=hintFingerprint.d.ts.map

package/dist/agentv3/selfImprove/hintFingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hintFingerprint.d.ts","sourceRoot":"","sources":["../../../src/agentv3/selfImprove/hintFingerprint.ts"],"names":[],"mappings":"AA+BA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAQxE"}

package/dist/agentv3/selfImprove/hintFingerprint.js

@@ -0,0 +1,47 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeHintFingerprint = computeHintFingerprint;
+/**
+ * Shared canonical-form fingerprint for `phase_hints` entries.
+ *
+ * Before Phase 0.1 of v2.1, two modules computed `patchFingerprint`
+ * with different canonical forms:
+ *
+ *  - `phaseHintsRenderer.computePatchFingerprint` hashed
+ *    `{category, keywords, constraints, criticalTools}` — no `id`,
+ *    no `critical`.
+ *  - `strategyFingerprint.computePatchFingerprint` hashed
+ *    `{id, keywords, constraints, criticalTools, critical}` — with both.
+ *
+ * Result: a freshly-rendered auto-patch's stored fingerprint never
+ * matched the drift-detection hash for the same hint, so every newly-
+ * landed `auto_*` hint was reported as `patch_changed` immediately
+ * after merge, defeating the supersede pipeline.
+ *
+ * The shared canonical here intentionally excludes `id` (it is derived
+ * from the fingerprint, so including it would be circular) and the
+ * renderer-specific `category` (which is folded into other fields like
+ * keywords/constraints anyway). It keeps `critical` because that *is*
+ * a semantic property of the hint that should differentiate two hints
+ * with otherwise identical content.
+ */
+const crypto_1 = require("crypto");
+/**
+ * Compute a 16-char hex fingerprint of a phase_hint's canonical form.
+ * Used by both `phaseHintsRenderer` (input identity / dedup) and
+ * `strategyFingerprint` (drift detection of stored hints) so the two
+ * sides agree on what "the same hint" means.
+ */
+function computeHintFingerprint(input) {
+    const canonical = {
+        keywords: [...input.keywords].map(s => s.trim().toLowerCase()).sort(),
+        constraints: (input.constraints || '').trim(),
+        criticalTools: [...input.criticalTools].map(s => s.trim().toLowerCase()).sort(),
+        critical: input.critical === true,
+    };
+    return (0, crypto_1.createHash)('sha256').update(JSON.stringify(canonical)).digest('hex').substring(0, 16);
+}
+//# sourceMappingURL=hintFingerprint.js.map

package/dist/agentv3/selfImprove/hintFingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hintFingerprint.js","sourceRoot":"","sources":["../../../src/agentv3/selfImprove/hintFingerprint.ts"],"names":[],"mappings":";AAAA,6CAA6C;AAC7C,0CAA0C;AAC1C,+DAA+D;;AA0C/D,wDAQC;AAhDD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,mCAAoC;AASpC;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAC,KAAyB;IAC9D,MAAM,SAAS,GAAG;QAChB,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE;QACrE,WAAW,EAAE,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QAC7C,aAAa,EAAE,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE;QAC/E,QAAQ,EAAE,KAAK,CAAC,QAAQ,KAAK,IAAI;KAClC,CAAC;IACF,OAAO,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC/F,CAAC"}

package/dist/agentv3/selfImprove/metricsAggregator.d.ts

@@ -0,0 +1,46 @@
+import { type SupersedeState } from './supersedeStore';
+import type { JobState } from './reviewOutbox';
+import type { PatternStatus } from '../types';
+export interface PatternMetrics {
+    total: number;
+    byStatus: Record<PatternStatus | 'legacy', number>;
+}
+export interface SkillNotesMetrics {
+    runtimeFiles: number;
+    runtimeNotes: number;
+    curatedFiles: number;
+    curatedNotes: number;
+}
+export interface FeedbackMetrics {
+    total: number;
+    positive: number;
+    negative: number;
+}
+export interface SelfImproveMetrics {
+    collectedAt: number;
+    patterns: {
+        positive: PatternMetrics;
+        negative: PatternMetrics;
+        quick: PatternMetrics;
+    };
+    outbox: {
+        byState: Record<JobState, number>;
+        dailyJobs: number;
+    };
+    supersede: Record<SupersedeState, number>;
+    skillNotes: SkillNotesMetrics;
+    feedback: FeedbackMetrics;
+    /** Active analyze() snapshots — surfaced so memory leaks are visible. */
+    activeRunSnapshots: number;
+    /** Errors that happened during aggregation. Empty array on a clean run. */
+    warnings: string[];
+}
+export declare function collectSelfImproveMetrics(opts?: {
+    patternsFile?: string;
+    negativePatternsFile?: string;
+    quickPatternsFile?: string;
+    feedbackFile?: string;
+    skillNotesDir?: string;
+    curatedSkillNotesDir?: string;
+}): SelfImproveMetrics;
+//# sourceMappingURL=metricsAggregator.d.ts.map

package/dist/agentv3/selfImprove/metricsAggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricsAggregator.d.ts","sourceRoot":"","sources":["../../../src/agentv3/selfImprove/metricsAggregator.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAA8C,aAAa,EAAE,MAAM,UAAU,CAAC;AAU1F,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC,aAAa,GAAG,QAAQ,EAAE,MAAM,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE;QACR,QAAQ,EAAE,cAAc,CAAC;QACzB,QAAQ,EAAE,cAAc,CAAC;QACzB,KAAK,EAAE,cAAc,CAAC;KACvB,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClC,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC1C,UAAU,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,EAAE,eAAe,CAAC;IAC1B,yEAAyE;IACzE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,yBAAyB,CAAC,IAAI,GAAE;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,kBAAkB,CAwC1B"}

package/dist/agentv3/selfImprove/metricsAggregator.js

@@ -0,0 +1,195 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectSelfImproveMetrics = collectSelfImproveMetrics;
+/**
+ * Self-Improving observability dashboard aggregator.
+ *
+ * Pulls counts from each persisted store (pattern memory, supersede markers,
+ * review outbox, skill notes, feedback log) into a single JSON snapshot the
+ * admin dashboard can poll at `GET /api/admin/self-improve/metrics`.
+ *
+ * Every data source is opened lazily and failures are logged-and-swallowed
+ * so a single corrupt file doesn't take the dashboard down. The endpoint is
+ * intentionally read-only — no side effects, no implicit migrations.
+ *
+ * See docs/architecture/self-improving-design.md §16 (testing strategy) — these counts
+ * power both the dashboard and the trend regression suite.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const reviewOutbox_1 = require("./reviewOutbox");
+const supersedeStore_1 = require("./supersedeStore");
+const strategyFingerprint_1 = require("./strategyFingerprint");
+const runtimePaths_1 = require("../../runtimePaths");
+const PATTERNS_FILE = (0, runtimePaths_1.backendLogPath)('analysis_patterns.json');
+const NEGATIVE_PATTERNS_FILE = (0, runtimePaths_1.backendLogPath)('analysis_negative_patterns.json');
+const QUICK_PATTERNS_FILE = (0, runtimePaths_1.backendLogPath)('analysis_quick_patterns.json');
+const FEEDBACK_FILE = (0, runtimePaths_1.backendLogPath)('feedback', 'feedback.jsonl');
+const SKILL_NOTES_DIR = (0, runtimePaths_1.backendLogPath)('skill_notes');
+const CURATED_SKILL_NOTES_DIR = path.resolve(__dirname, '..', '..', '..', 'skills', 'curated_skill_notes');
+function collectSelfImproveMetrics(opts = {}) {
+    const warnings = [];
+    const positives = readJson(opts.patternsFile ?? PATTERNS_FILE, warnings);
+    const negatives = readJson(opts.negativePatternsFile ?? NEGATIVE_PATTERNS_FILE, warnings);
+    const quicks = readJson(opts.quickPatternsFile ?? QUICK_PATTERNS_FILE, warnings);
+    const outbox = safeOpen(() => (0, reviewOutbox_1.openReviewOutbox)(), warnings, 'outbox');
+    const outboxByState = outbox?.countByState() ?? { pending: 0, leased: 0, done: 0, failed: 0 };
+    const outboxDaily = outbox?.dailyJobCount() ?? 0;
+    outbox?.close();
+    const supersede = safeOpen(() => (0, supersedeStore_1.openSupersedeStore)(), warnings, 'supersede');
+    const supersedeCounts = supersede?.countByState() ?? {
+        pending_review: 0, active_canary: 0, active: 0,
+        failed: 0, rejected: 0, drifted: 0, reverted: 0,
+    };
+    supersede?.close();
+    const skillNotes = countSkillNotes(opts.skillNotesDir ?? SKILL_NOTES_DIR, opts.curatedSkillNotesDir ?? CURATED_SKILL_NOTES_DIR, warnings);
+    const feedback = countFeedback(opts.feedbackFile ?? FEEDBACK_FILE, warnings);
+    return {
+        collectedAt: Date.now(),
+        patterns: {
+            positive: bucketByStatus(positives),
+            negative: bucketByStatus(negatives),
+            quick: bucketByStatus(quicks),
+        },
+        outbox: { byState: outboxByState, dailyJobs: outboxDaily },
+        supersede: supersedeCounts,
+        skillNotes,
+        feedback,
+        activeRunSnapshots: strategyFingerprint_1.runSnapshots.size(),
+        warnings,
+    };
+}
+function readJson(file, warnings) {
+    if (!fs.existsSync(file))
+        return [];
+    try {
+        const parsed = JSON.parse(fs.readFileSync(file, 'utf-8'));
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch (err) {
+        warnings.push(`failed to parse ${file}: ${err.message}`);
+        return [];
+    }
+}
+function safeOpen(fn, warnings, label) {
+    try {
+        return fn();
+    }
+    catch (err) {
+        warnings.push(`failed to open ${label}: ${err.message}`);
+        return null;
+    }
+}
+function bucketByStatus(entries) {
+    const result = {
+        total: entries.length,
+        byStatus: {
+            provisional: 0,
+            confirmed: 0,
+            rejected: 0,
+            disputed: 0,
+            disputed_late: 0,
+            legacy: 0,
+        },
+    };
+    for (const e of entries) {
+        if (e.status)
+            result.byStatus[e.status] += 1;
+        else
+            result.byStatus.legacy += 1;
+    }
+    return result;
+}
+function countSkillNotes(runtimeDir, curatedDir, warnings) {
+    return {
+        runtimeFiles: countNotesFiles(runtimeDir, warnings).files,
+        runtimeNotes: countNotesFiles(runtimeDir, warnings).notes,
+        curatedFiles: countNotesFiles(curatedDir, warnings).files,
+        curatedNotes: countNotesFiles(curatedDir, warnings).notes,
+    };
+}
+function countNotesFiles(dir, warnings) {
+    if (!fs.existsSync(dir))
+        return { files: 0, notes: 0 };
+    try {
+        const entries = fs.readdirSync(dir).filter(f => f.endsWith('.notes.json'));
+        let notes = 0;
+        for (const f of entries) {
+            try {
+                const parsed = JSON.parse(fs.readFileSync(path.join(dir, f), 'utf-8'));
+                if (Array.isArray(parsed.notes))
+                    notes += parsed.notes.length;
+            }
+            catch {
+                warnings.push(`failed to parse ${path.join(dir, f)}`);
+            }
+        }
+        return { files: entries.length, notes };
+    }
+    catch (err) {
+        warnings.push(`failed to list ${dir}: ${err.message}`);
+        return { files: 0, notes: 0 };
+    }
+}
+function countFeedback(file, warnings) {
+    const result = { total: 0, positive: 0, negative: 0 };
+    if (!fs.existsSync(file))
+        return result;
+    try {
+        const lines = fs.readFileSync(file, 'utf-8').split('\n').filter(line => line.trim().length > 0);
+        for (const line of lines) {
+            try {
+                const entry = JSON.parse(line);
+                result.total += 1;
+                if (entry.rating === 'positive')
+                    result.positive += 1;
+                else if (entry.rating === 'negative')
+                    result.negative += 1;
+            }
+            catch {
+                // Skip bad line; surface a single warning per file rather than per line.
+            }
+        }
+    }
+    catch (err) {
+        warnings.push(`failed to read ${file}: ${err.message}`);
+    }
+    return result;
+}
+//# sourceMappingURL=metricsAggregator.js.map

package/dist/agentv3/selfImprove/metricsAggregator.js.map

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

package/dist/agentv3/selfImprove/migrateFailureModeHash.d.ts

@@ -0,0 +1,31 @@
+import type { AnalysisPatternEntry, NegativePatternEntry } from '../types';
+import { type FailureCategory } from './failureTaxonomy';
+export interface MigrationReport {
+    total: number;
+    alreadyHashed: number;
+    newlyHashed: number;
+    byCategory: Record<FailureCategory, number>;
+    samples: Record<FailureCategory, string[]>;
+}
+/**
+ * Backfill `failureModeHash` on positive analysis-pattern entries.
+ *
+ * Positive patterns track successful insights, so historical entries usually
+ * carry no failure signal. Without an inferred category we still emit a hash
+ * keyed on `unknown` so cross-artifact dedupe works on the (sceneType, archType)
+ * dimensions; this never trips supersede because the category is `unknown`.
+ */
+export declare function backfillPatternEntries(entries: ReadonlyArray<AnalysisPatternEntry>): {
+    entries: AnalysisPatternEntry[];
+    report: MigrationReport;
+};
+/**
+ * Backfill negative-pattern entries. Each entry can carry multiple
+ * `failedApproaches`; we hash both the entry-level and per-approach to
+ * cover supersede dedupe at either granularity.
+ */
+export declare function backfillNegativeEntries(entries: ReadonlyArray<NegativePatternEntry>): {
+    entries: NegativePatternEntry[];
+    report: MigrationReport;
+};
+//# sourceMappingURL=migrateFailureModeHash.d.ts.map

package/dist/agentv3/selfImprove/migrateFailureModeHash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrateFailureModeHash.d.ts","sourceRoot":"","sources":["../../../src/agentv3/selfImprove/migrateFailureModeHash.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAkB,MAAM,UAAU,CAAC;AAE3F,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,mBAAmB,CAAC;AAK3B,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC,CAAC;CAC5C;AAoBD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,CAAC,oBAAoB,CAAC,GAC3C;IAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAuB9D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,aAAa,CAAC,oBAAoB,CAAC,GAC3C;IAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAuC9D"}