instar 1.3.4 → 1.3.5

package/dist/monitoring/FrameworkIssueLedger.d.ts

@@ -0,0 +1,139 @@
+export declare const ISSUE_BUCKETS: readonly ["framework-limitation", "instar-integration-gap", "generic-agent-mistake"];
+export type IssueBucket = (typeof ISSUE_BUCKETS)[number];
+export declare const ISSUE_SEVERITIES: readonly ["low", "medium", "high"];
+export type IssueSeverity = (typeof ISSUE_SEVERITIES)[number];
+export declare const ISSUE_STATUSES: readonly ["open", "spec'd", "fixed", "wont-fix"];
+export type IssueStatus = (typeof ISSUE_STATUSES)[number];
+export declare const PLAYBOOK_STATUSES: readonly ["none", "candidate", "extracted", "superseded"];
+export type PlaybookStatus = (typeof PLAYBOOK_STATUSES)[number];
+export interface FrameworkIssueLedgerOptions {
+    dbPath: string;
+    /** Override clock for deterministic tests. */
+    now?: () => number;
+}
+/** What Stage B emits per observation (spec §5). */
+export interface RecordObservationInput {
+    framework: string;
+    bucket: IssueBucket;
+    title: string;
+    severity?: IssueSeverity;
+    /** Conservative auto-merge key (spec §13.3). Required — identifies the canonical issue. */
+    dedupKey: string;
+    /** Richer fingerprint for probable-dup review (spec §13.3). */
+    signature?: string;
+    /** OPAQUE reference only — path+line, log ref, PR#, sentinel-event id (spec §13.2/§17). */
+    evidence?: string;
+    observedVersion?: string;
+    tickId?: string;
+    /**
+     * Collapses repeated observations of the same open issue within a fix-window
+     * to one episode (spec §13.4). Defaults to the observed version so an unfixed
+     * issue accrues at most one episode per version span.
+     */
+    episodeKey?: string;
+    /** Forced primary when dual-tagged (spec §6). */
+    bucketPrimary?: IssueBucket;
+    relatedSpec?: string;
+}
+export interface RecordObservationResult {
+    issueId: string;
+    created: boolean;
+    episodeRecorded: boolean;
+    recurrenceCount: number;
+    probableLoop: boolean;
+}
+export interface IssueRow {
+    id: string;
+    framework: string;
+    bucket: IssueBucket;
+    bucketPrimary: IssueBucket | null;
+    title: string;
+    severity: IssueSeverity;
+    status: IssueStatus;
+    dedupKey: string;
+    signature: string | null;
+    recurrenceCount: number;
+    firstSeenVersion: string | null;
+    lastSeenVersion: string | null;
+    fixedInVersion: string | null;
+    regressedFromIssueId: string | null;
+    playbookStatus: PlaybookStatus;
+    wontFixReason: string | null;
+    relatedSpec: string | null;
+    probableLoop: boolean;
+    createdAt: number;
+    updatedAt: number;
+    /** Derived at read (spec §13.4) — never stored, so a re-classification can't stale it. */
+    generalizable: boolean;
+    /** Derived at read: severityWeight × recurrenceCount × recency decay (spec §13.4). */
+    impactScore: number;
+}
+export interface ListIssuesQuery {
+    framework?: string;
+    bucket?: IssueBucket;
+    status?: IssueStatus;
+    limit?: number;
+}
+export interface PlaybookQuery {
+    targetFramework: string;
+    limit?: number;
+}
+export declare function scanForSecret(s: string): boolean;
+export declare class FrameworkIssueLedger {
+    private db;
+    private now;
+    constructor(opts: FrameworkIssueLedgerOptions);
+    /** Stable list of frameworks the ledger has seen — for the route allowlist (spec §5/§17). */
+    knownFrameworks(): string[];
+    /**
+     * Record one Stage-B observation. Finds-or-creates the canonical issue via
+     * (framework, dedupKey); collapses the observation into a distinct episode via
+     * episodeKey; increments the materialized recurrence_count only on a new
+     * episode (spec §13.4). All writes run in a single transaction (CAS-safe: the
+     * UNIQUE(issue_id, episode_key) index is the concurrency guard — a racing
+     * duplicate episode insert fails and is counted as already-recorded).
+     */
+    recordObservation(input: RecordObservationInput): RecordObservationResult;
+    /** Retention pruning — keep first N + last M observations per issue (spec §13.2). */
+    private pruneObservations;
+    /**
+     * Single-writer CAS mutate of an issue's mutable fields (status, bucket,
+     * playbookStatus, regression link, etc.). Follows CommitmentTracker's
+     * read-modify-write-with-version-check pattern; enum fields are validated.
+     * `wont-fix` requires a reason (spec §13.7).
+     */
+    updateIssue(issueId: string, patch: Partial<{
+        status: IssueStatus;
+        bucket: IssueBucket;
+        bucketPrimary: IssueBucket | null;
+        playbookStatus: PlaybookStatus;
+        fixedInVersion: string | null;
+        regressedFromIssueId: string | null;
+        wontFixReason: string | null;
+        relatedSpec: string | null;
+    }>): IssueRow | null;
+    /**
+     * Suggest a regression link: a new issue whose signature/dedupKey matches a
+     * previously-`fixed` issue is a candidate regression (spec §13.5). Returns the
+     * matching fixed issues (does NOT auto-link — review decides).
+     */
+    suggestRegressions(input: {
+        framework: string;
+        dedupKey: string;
+        signature?: string | null;
+    }): IssueRow[];
+    getIssue(id: string): IssueRow | null;
+    listIssues(q?: ListIssuesQuery): IssueRow[];
+    /**
+     * The onboarding playbook for `targetFramework`: generalizable lessons from
+     * PRIOR (other) frameworks, ranked by impactScore (spec §13.6). The playbook
+     * for X is sourced from frameworks != X — never X's own issues.
+     */
+    playbook(q: PlaybookQuery): IssueRow[];
+    observationCount(issueId: string): number;
+    private rowToIssue;
+    close(): void;
+}
+/** Clamp a list limit to 1..500 (spec §5/§17). */
+export declare function clampLimit(raw: unknown): number;
+//# sourceMappingURL=FrameworkIssueLedger.d.ts.map

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

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

package/dist/monitoring/FrameworkIssueLedger.js

@@ -0,0 +1,441 @@
+/**
+ * FrameworkIssueLedger — durable record of behavioral issues observed while
+ * onboarding an agent framework onto Instar (the Framework-Onboarding Mentor
+ * System, docs/specs/FRAMEWORK-ONBOARDING-MENTOR-SPEC.md).
+ *
+ * Two tables, by design (spec §13):
+ *   - `framework_issues`       — canonical root-cause records (one per distinct problem)
+ *   - `framework_observations` — per-occurrence evidence (one per time it happened)
+ *
+ * The split exists because "false merges are worse than false splits" — a
+ * single-row model would bury distinct root causes. Recurrence is counted in
+ * distinct *episodes* (not raw ticks) via `episode_key`, materialized into
+ * `recurrence_count` on the canonical row so the playbook ranking never pays a
+ * read-time COUNT (spec §13.4).
+ *
+ * Signal-only: this ledger never gates a job, blocks a message, or constrains a
+ * session. Stage B of the mentor loop writes observations; the read-only HTTP
+ * routes (`/framework-issues`, `/framework-issues/playbook`) serve them. All
+ * authority to act on an entry rests with the human (spec §6).
+ *
+ * Security (spec §17): `evidence` is an OPAQUE reference only — never inlined
+ * log text or diff hunks — and is secret-scanned at capture. All captured
+ * free-text is length-capped + sanitized on write. Every query uses a prepared
+ * statement with bound parameters; enum columns are validated against fixed
+ * allowlists on write.
+ */
+import Database from 'better-sqlite3';
+import fs from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { NativeModuleHealer } from '../memory/NativeModuleHealer.js';
+// ── Enums / allowlists (validated on write — spec §13.8, §17) ───────────────
+export const ISSUE_BUCKETS = [
+    'framework-limitation',
+    'instar-integration-gap',
+    'generic-agent-mistake',
+];
+export const ISSUE_SEVERITIES = ['low', 'medium', 'high'];
+export const ISSUE_STATUSES = ['open', "spec'd", 'fixed', 'wont-fix'];
+export const PLAYBOOK_STATUSES = ['none', 'candidate', 'extracted', 'superseded'];
+/** Buckets that generalize to the next framework feed the playbook (spec §13.4). */
+const GENERALIZABLE_BUCKETS = new Set([
+    'framework-limitation',
+    'instar-integration-gap',
+]);
+const SEVERITY_WEIGHT = { low: 1, medium: 3, high: 9 };
+// ── Tunables (spec §13.2 retention, §13.4 caps) ─────────────────────────────
+const MAX_FREE_TEXT = 500; // length-cap for title / signature / rationale (§17)
+const MAX_EVIDENCE = 1024; // evidence pointer cap (§13.2 — pointer, not content)
+const RETENTION_KEEP_FIRST = 5; // keep first N observations per issue (§13.2)
+const RETENTION_KEEP_LAST = 20; // + last M
+const PROBABLE_LOOP_PER_HOUR = 12; // obs/hr above which an issue is flagged probable-loop (§13.4)
+const RECENCY_HALF_LIFE_MS = 30 * 24 * 60 * 60 * 1000; // 30d decay on impactScore (§13.4)
+// ── Schema (spec §13.1 / §13.2) ─────────────────────────────────────────────
+const SCHEMA = [
+    `CREATE TABLE IF NOT EXISTS framework_issues (
+     id                     TEXT PRIMARY KEY,
+     framework              TEXT NOT NULL,
+     bucket                 TEXT NOT NULL,
+     bucket_primary         TEXT,
+     title                  TEXT NOT NULL,
+     severity               TEXT NOT NULL DEFAULT 'medium',
+     status                 TEXT NOT NULL DEFAULT 'open',
+     dedup_key              TEXT NOT NULL,
+     signature              TEXT,
+     recurrence_count       INTEGER NOT NULL DEFAULT 0,
+     first_seen_version     TEXT,
+     last_seen_version      TEXT,
+     fixed_in_version       TEXT,
+     regressed_from_issue_id TEXT,
+     playbook_status        TEXT NOT NULL DEFAULT 'none',
+     wont_fix_reason        TEXT,
+     related_spec           TEXT,
+     probable_loop          INTEGER NOT NULL DEFAULT 0,
+     created_at             INTEGER NOT NULL,
+     updated_at             INTEGER NOT NULL
+   )`,
+    `CREATE UNIQUE INDEX IF NOT EXISTS idx_fwissues_dedup ON framework_issues(framework, dedup_key)`,
+    `CREATE INDEX IF NOT EXISTS idx_fwissues_framework_pb ON framework_issues(framework, playbook_status)`,
+    `CREATE INDEX IF NOT EXISTS idx_fwissues_bucket ON framework_issues(bucket)`,
+    `CREATE INDEX IF NOT EXISTS idx_fwissues_status ON framework_issues(status)`,
+    `CREATE TABLE IF NOT EXISTS framework_observations (
+     id              TEXT PRIMARY KEY,
+     issue_id        TEXT NOT NULL,
+     framework       TEXT NOT NULL,
+     evidence        TEXT,
+     observed_version TEXT,
+     observed_at     INTEGER NOT NULL,
+     tick_id         TEXT,
+     episode_key     TEXT NOT NULL
+   )`,
+    `CREATE INDEX IF NOT EXISTS idx_fwobs_issue ON framework_observations(issue_id)`,
+    `CREATE UNIQUE INDEX IF NOT EXISTS idx_fwobs_episode ON framework_observations(issue_id, episode_key)`,
+    `CREATE INDEX IF NOT EXISTS idx_fwobs_observed_at ON framework_observations(observed_at)`,
+];
+// ── Helpers ─────────────────────────────────────────────────────────────────
+/**
+ * Reject anything that looks like an inlined secret/log-body rather than an
+ * opaque pointer (spec §17). Returns a sanitized, length-capped string. We do
+ * NOT silently store a suspected secret — we redact it and tag the evidence so
+ * the capture is visibly degraded rather than leaking.
+ */
+const SECRET_PATTERNS = [
+    /\b(sk|pk|rk)-[A-Za-z0-9]{16,}\b/, // api-key-shaped
+    /\bBearer\s+[A-Za-z0-9._-]{12,}\b/i,
+    /\bxox[baprs]-[A-Za-z0-9-]{10,}\b/, // slack
+    /\bgh[pousr]_[A-Za-z0-9]{20,}\b/, // github
+    /-----BEGIN [A-Z ]*PRIVATE KEY-----/,
+    /\beyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\b/, // jwt
+];
+export function scanForSecret(s) {
+    return SECRET_PATTERNS.some((re) => re.test(s));
+}
+function sanitizeFreeText(s, cap) {
+    if (!s)
+        return '';
+    // Strip control chars; collapse whitespace; cap length.
+    // eslint-disable-next-line no-control-regex
+    const cleaned = s.replace(/[\x00-\x1f\x7f]/g, " ").replace(/\s+/g, " ").trim();
+    return cleaned.length > cap ? cleaned.slice(0, cap) : cleaned;
+}
+function sanitizeEvidence(s) {
+    if (!s)
+        return null;
+    const capped = sanitizeFreeText(s, MAX_EVIDENCE);
+    if (scanForSecret(capped)) {
+        // Redact the body; keep a marker so the capture is visibly degraded (§17).
+        return '[redacted: evidence matched a secret pattern — store an opaque reference, not log content]';
+    }
+    return capped;
+}
+function assertEnum(value, allowed, field) {
+    if (!allowed.includes(value)) {
+        throw new Error(`FrameworkIssueLedger: invalid ${field} '${value}' (allowed: ${allowed.join(', ')})`);
+    }
+    return value;
+}
+// ── Ledger ──────────────────────────────────────────────────────────────────
+export class FrameworkIssueLedger {
+    db;
+    now;
+    constructor(opts) {
+        this.now = opts.now ?? (() => Date.now());
+        if (opts.dbPath !== ':memory:') {
+            fs.mkdirSync(path.dirname(opts.dbPath), { recursive: true });
+        }
+        this.db = NativeModuleHealer.openWithHealSync('FrameworkIssueLedger', () => new Database(opts.dbPath));
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('synchronous = NORMAL');
+        this.db.pragma('busy_timeout = 5000');
+        for (const ddl of SCHEMA)
+            this.db.exec(ddl);
+    }
+    /** Stable list of frameworks the ledger has seen — for the route allowlist (spec §5/§17). */
+    knownFrameworks() {
+        const rows = this.db
+            .prepare(`SELECT DISTINCT framework FROM framework_issues ORDER BY framework`)
+            .all();
+        return rows.map((r) => r.framework);
+    }
+    /**
+     * Record one Stage-B observation. Finds-or-creates the canonical issue via
+     * (framework, dedupKey); collapses the observation into a distinct episode via
+     * episodeKey; increments the materialized recurrence_count only on a new
+     * episode (spec §13.4). All writes run in a single transaction (CAS-safe: the
+     * UNIQUE(issue_id, episode_key) index is the concurrency guard — a racing
+     * duplicate episode insert fails and is counted as already-recorded).
+     */
+    recordObservation(input) {
+        const framework = sanitizeFreeText(input.framework, 120);
+        if (!framework)
+            throw new Error('FrameworkIssueLedger: framework is required');
+        const bucket = assertEnum(input.bucket, ISSUE_BUCKETS, 'bucket');
+        const severity = assertEnum(input.severity ?? 'medium', ISSUE_SEVERITIES, 'severity');
+        const dedupKey = sanitizeFreeText(input.dedupKey, 200);
+        if (!dedupKey)
+            throw new Error('FrameworkIssueLedger: dedupKey is required');
+        const title = sanitizeFreeText(input.title, MAX_FREE_TEXT) || '(untitled)';
+        const signature = input.signature ? sanitizeFreeText(input.signature, MAX_FREE_TEXT) : null;
+        const evidence = sanitizeEvidence(input.evidence);
+        const observedVersion = input.observedVersion ? sanitizeFreeText(input.observedVersion, 60) : null;
+        const tickId = input.tickId ? sanitizeFreeText(input.tickId, 120) : null;
+        const episodeKey = sanitizeFreeText(input.episodeKey ?? observedVersion ?? 'default', 200);
+        const bucketPrimary = input.bucketPrimary
+            ? assertEnum(input.bucketPrimary, ISSUE_BUCKETS, 'bucketPrimary')
+            : null;
+        const relatedSpec = input.relatedSpec ? sanitizeFreeText(input.relatedSpec, 200) : null;
+        const ts = this.now();
+        const txn = this.db.transaction(() => {
+            // Find-or-create canonical issue.
+            let issue = this.db
+                .prepare(`SELECT * FROM framework_issues WHERE framework = ? AND dedup_key = ?`)
+                .get(framework, dedupKey);
+            let created = false;
+            let issueId;
+            if (!issue) {
+                issueId = crypto.randomUUID();
+                this.db
+                    .prepare(`INSERT INTO framework_issues
+               (id, framework, bucket, bucket_primary, title, severity, status, dedup_key,
+                signature, recurrence_count, first_seen_version, last_seen_version,
+                playbook_status, probable_loop, created_at, updated_at)
+             VALUES (@id, @framework, @bucket, @bucketPrimary, @title, @severity, 'open', @dedupKey,
+                @signature, 0, @observedVersion, @observedVersion, 'none', 0, @ts, @ts)`)
+                    .run({ id: issueId, framework, bucket, bucketPrimary, title, severity, dedupKey, signature, observedVersion, ts });
+                created = true;
+                issue = { id: issueId };
+            }
+            else {
+                issueId = issue.id;
+                // Refresh last-seen + (non-destructively) escalate severity if higher.
+                this.db
+                    .prepare(`UPDATE framework_issues
+               SET last_seen_version = COALESCE(@observedVersion, last_seen_version),
+                   severity = CASE WHEN @newWeight > @oldWeight THEN @severity ELSE severity END,
+                   updated_at = @ts
+             WHERE id = @id`)
+                    .run({
+                    id: issueId,
+                    observedVersion,
+                    severity,
+                    newWeight: SEVERITY_WEIGHT[severity],
+                    oldWeight: SEVERITY_WEIGHT[issue.severity ?? 'medium'],
+                    ts,
+                });
+            }
+            // Insert the observation as a distinct episode. UNIQUE(issue_id, episode_key)
+            // collapses repeats within a fix-window to one episode (spec §13.4).
+            let episodeRecorded = false;
+            const obsId = crypto.randomUUID();
+            const insert = this.db
+                .prepare(`INSERT OR IGNORE INTO framework_observations
+             (id, issue_id, framework, evidence, observed_version, observed_at, tick_id, episode_key)
+           VALUES (@obsId, @issueId, @framework, @evidence, @observedVersion, @ts, @tickId, @episodeKey)`)
+                .run({ obsId, issueId, framework, evidence, observedVersion, ts, tickId, episodeKey });
+            episodeRecorded = insert.changes > 0;
+            if (episodeRecorded) {
+                this.db
+                    .prepare(`UPDATE framework_issues SET recurrence_count = recurrence_count + 1, updated_at = ? WHERE id = ?`)
+                    .run(ts, issueId);
+            }
+            // Apply retention: keep first N + last M observations for this issue (§13.2).
+            this.pruneObservations(issueId);
+            // Probable-loop flag: too many observations in the trailing hour (§13.4).
+            const recentCount = this.db
+                .prepare(`SELECT COUNT(*) AS c FROM framework_observations WHERE issue_id = ? AND observed_at >= ?`)
+                .get(issueId, ts - 60 * 60 * 1000);
+            const probableLoop = recentCount.c >= PROBABLE_LOOP_PER_HOUR;
+            this.db
+                .prepare(`UPDATE framework_issues SET probable_loop = ? WHERE id = ?`)
+                .run(probableLoop ? 1 : 0, issueId);
+            const after = this.db
+                .prepare(`SELECT recurrence_count FROM framework_issues WHERE id = ?`)
+                .get(issueId);
+            return { issueId, created, episodeRecorded, recurrenceCount: after.recurrence_count, probableLoop };
+        });
+        return txn();
+    }
+    /** Retention pruning — keep first N + last M observations per issue (spec §13.2). */
+    pruneObservations(issueId) {
+        const total = this.db
+            .prepare(`SELECT COUNT(*) AS c FROM framework_observations WHERE issue_id = ?`)
+            .get(issueId);
+        if (total.c <= RETENTION_KEEP_FIRST + RETENTION_KEEP_LAST)
+            return;
+        // Delete the middle band: everything not in the first-N or last-M by observed_at.
+        this.db
+            .prepare(`DELETE FROM framework_observations
+           WHERE issue_id = @issueId
+             AND id NOT IN (
+               SELECT id FROM framework_observations WHERE issue_id = @issueId ORDER BY observed_at ASC LIMIT @first
+             )
+             AND id NOT IN (
+               SELECT id FROM framework_observations WHERE issue_id = @issueId ORDER BY observed_at DESC LIMIT @last
+             )`)
+            .run({ issueId, first: RETENTION_KEEP_FIRST, last: RETENTION_KEEP_LAST });
+    }
+    /**
+     * Single-writer CAS mutate of an issue's mutable fields (status, bucket,
+     * playbookStatus, regression link, etc.). Follows CommitmentTracker's
+     * read-modify-write-with-version-check pattern; enum fields are validated.
+     * `wont-fix` requires a reason (spec §13.7).
+     */
+    updateIssue(issueId, patch) {
+        const txn = this.db.transaction(() => {
+            const cur = this.db.prepare(`SELECT * FROM framework_issues WHERE id = ?`).get(issueId);
+            if (!cur)
+                return null;
+            const status = patch.status ? assertEnum(patch.status, ISSUE_STATUSES, 'status') : cur.status;
+            const bucket = patch.bucket ? assertEnum(patch.bucket, ISSUE_BUCKETS, 'bucket') : cur.bucket;
+            const playbookStatus = patch.playbookStatus
+                ? assertEnum(patch.playbookStatus, PLAYBOOK_STATUSES, 'playbookStatus')
+                : cur.playbook_status;
+            const bucketPrimary = patch.bucketPrimary !== undefined
+                ? patch.bucketPrimary
+                    ? assertEnum(patch.bucketPrimary, ISSUE_BUCKETS, 'bucketPrimary')
+                    : null
+                : cur.bucket_primary;
+            const wontFixReason = patch.wontFixReason !== undefined ? sanitizeFreeText(patch.wontFixReason ?? '', MAX_FREE_TEXT) || null : cur.wont_fix_reason;
+            if (status === 'wont-fix' && !wontFixReason) {
+                throw new Error('FrameworkIssueLedger: wont-fix requires a wontFixReason (spec §13.7)');
+            }
+            this.db
+                .prepare(`UPDATE framework_issues SET
+             status = @status, bucket = @bucket, bucket_primary = @bucketPrimary,
+             playbook_status = @playbookStatus,
+             fixed_in_version = @fixedInVersion, regressed_from_issue_id = @regressedFromIssueId,
+             wont_fix_reason = @wontFixReason, related_spec = @relatedSpec, updated_at = @ts
+           WHERE id = @id`)
+                .run({
+                id: issueId,
+                status,
+                bucket,
+                bucketPrimary,
+                playbookStatus,
+                fixedInVersion: patch.fixedInVersion !== undefined ? patch.fixedInVersion : cur.fixed_in_version,
+                regressedFromIssueId: patch.regressedFromIssueId !== undefined
+                    ? patch.regressedFromIssueId
+                    : cur.regressed_from_issue_id,
+                wontFixReason,
+                relatedSpec: patch.relatedSpec !== undefined ? patch.relatedSpec : cur.related_spec,
+                ts: this.now(),
+            });
+            return this.getIssue(issueId);
+        });
+        return txn();
+    }
+    /**
+     * Suggest a regression link: a new issue whose signature/dedupKey matches a
+     * previously-`fixed` issue is a candidate regression (spec §13.5). Returns the
+     * matching fixed issues (does NOT auto-link — review decides).
+     */
+    suggestRegressions(input) {
+        const rows = this.db
+            .prepare(`SELECT * FROM framework_issues
+           WHERE framework = ? AND status = 'fixed'
+             AND (dedup_key = ? OR (signature IS NOT NULL AND signature = ?))`)
+            .all(input.framework, input.dedupKey, input.signature ?? '__none__');
+        return rows.map((r) => this.rowToIssue(r));
+    }
+    getIssue(id) {
+        const r = this.db.prepare(`SELECT * FROM framework_issues WHERE id = ?`).get(id);
+        return r ? this.rowToIssue(r) : null;
+    }
+    listIssues(q = {}) {
+        const clauses = [];
+        const params = {};
+        if (q.framework) {
+            clauses.push(`framework = @framework`);
+            params.framework = q.framework;
+        }
+        if (q.bucket) {
+            clauses.push(`bucket = @bucket`);
+            params.bucket = assertEnum(q.bucket, ISSUE_BUCKETS, 'bucket');
+        }
+        if (q.status) {
+            clauses.push(`status = @status`);
+            params.status = assertEnum(q.status, ISSUE_STATUSES, 'status');
+        }
+        const where = clauses.length ? `WHERE ${clauses.join(' AND ')}` : '';
+        const limit = clampLimit(q.limit);
+        const rows = this.db
+            .prepare(`SELECT * FROM framework_issues ${where} ORDER BY updated_at DESC LIMIT @limit`)
+            .all({ ...params, limit });
+        return rows.map((r) => this.rowToIssue(r));
+    }
+    /**
+     * The onboarding playbook for `targetFramework`: generalizable lessons from
+     * PRIOR (other) frameworks, ranked by impactScore (spec §13.6). The playbook
+     * for X is sourced from frameworks != X — never X's own issues.
+     */
+    playbook(q) {
+        const limit = clampLimit(q.limit);
+        const rows = this.db
+            .prepare(`SELECT * FROM framework_issues
+           WHERE framework != @targetFramework
+             AND bucket IN ('framework-limitation', 'instar-integration-gap')
+             AND playbook_status IN ('candidate', 'extracted')`)
+            .all({ targetFramework: q.targetFramework });
+        return rows
+            .map((r) => this.rowToIssue(r))
+            .sort((a, b) => b.impactScore - a.impactScore)
+            .slice(0, limit);
+    }
+    observationCount(issueId) {
+        const r = this.db
+            .prepare(`SELECT COUNT(*) AS c FROM framework_observations WHERE issue_id = ?`)
+            .get(issueId);
+        return r.c;
+    }
+    rowToIssue(r) {
+        const bucket = r.bucket;
+        const severity = r.severity ?? 'medium';
+        const recurrenceCount = r.recurrence_count ?? 0;
+        const updatedAt = r.updated_at ?? 0;
+        // Recency decay (spec §13.4): a long-stale issue doesn't permanently dominate.
+        const ageMs = Math.max(0, this.now() - updatedAt);
+        const decay = Math.pow(0.5, ageMs / RECENCY_HALF_LIFE_MS);
+        const impactScore = SEVERITY_WEIGHT[severity] * recurrenceCount * decay;
+        return {
+            id: r.id,
+            framework: r.framework,
+            bucket,
+            bucketPrimary: r.bucket_primary ?? null,
+            title: r.title,
+            severity,
+            status: r.status,
+            dedupKey: r.dedup_key,
+            signature: r.signature ?? null,
+            recurrenceCount,
+            firstSeenVersion: r.first_seen_version ?? null,
+            lastSeenVersion: r.last_seen_version ?? null,
+            fixedInVersion: r.fixed_in_version ?? null,
+            regressedFromIssueId: r.regressed_from_issue_id ?? null,
+            playbookStatus: r.playbook_status,
+            wontFixReason: r.wont_fix_reason ?? null,
+            relatedSpec: r.related_spec ?? null,
+            probableLoop: !!r.probable_loop,
+            createdAt: r.created_at ?? 0,
+            updatedAt,
+            generalizable: GENERALIZABLE_BUCKETS.has(bucket),
+            impactScore: Math.round(impactScore * 1000) / 1000,
+        };
+    }
+    close() {
+        try {
+            this.db.close();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+/** Clamp a list limit to 1..500 (spec §5/§17). */
+export function clampLimit(raw) {
+    const n = typeof raw === 'number' ? raw : typeof raw === 'string' ? parseInt(raw, 10) : NaN;
+    if (!Number.isFinite(n))
+        return 100;
+    return Math.max(1, Math.min(500, Math.floor(n)));
+}
+//# sourceMappingURL=FrameworkIssueLedger.js.map

package/dist/monitoring/FrameworkIssueLedger.js.map

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

package/dist/scaffold/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/scaffold/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAgG/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA2E/F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiBvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA2B1D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,OAAO,EACpB,WAAW,GAAE,OAAe,EAC5B,WAAW,GAAE,OAAe,GAC3B,MAAM,CA0nCR;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,OAAO,EACpB,WAAW,GAAE,OAAe,GAC3B,MAAM,CAuSR"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/scaffold/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAgG/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA2E/F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiBvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA2B1D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,OAAO,EACpB,WAAW,GAAE,OAAe,EAC5B,WAAW,GAAE,OAAe,GAC3B,MAAM,CA2nCR;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,OAAO,EACpB,WAAW,GAAE,OAAe,GAC3B,MAAM,CAuSR"}

package/dist/scaffold/templates.js

@@ -662,6 +662,7 @@ I maintain registries that are the source of truth for specific categories. Thes
 | My backup history? | \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/backups\` |
 | My state change history? | \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/git/log\` |
 | Other agents on this machine? | \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/agents\` |
+| Behavioral issues logged while onboarding a framework? / the onboarding playbook? | \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/framework-issues\` (read-only) + \`/framework-issues/playbook?targetFramework=X\` — the Framework-Onboarding Mentor System's issue ledger (observability only; never gates) |
 | Project architecture? | This file (CLAUDE.md), then project docs |
 
 **Why this matters:** Searching 1000 files to answer a question that a single state file could answer is slower AND less reliable. Broad searches find stale narratives. State files are current. This applies at EVERY level — including sub-agents I spawn. When spawning a research agent, include the relevant state file reference in its prompt so it searches WITH context, not blind.

package/dist/scaffold/templates.js.map

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