@jungjaehoon/mama-os 0.53.1 → 0.58.0

package/dist/observability/metrics-store.d.ts

@@ -1,52 +0,0 @@
-/**
- * MetricsStore — SQLite-backed metrics storage (STORY-019)
- *
- * Provides record()/query()/cleanup() for operational metrics.
- * Singleton per database path; uses WAL mode for concurrent reads.
- */
-export interface MetricRecord {
-    name: string;
-    value: number;
-    labels?: Record<string, string>;
-    timestamp?: number;
-}
-export interface MetricRow {
-    id: number;
-    name: string;
-    value: number;
-    labels: string | null;
-    timestamp: number;
-}
-export interface MetricQueryOptions {
-    name: string;
-    startTs?: number;
-    endTs?: number;
-    labels?: Record<string, string>;
-    limit?: number;
-}
-export interface MetricAggregation {
-    name: string;
-    count: number;
-    sum: number;
-    avg: number;
-    min: number;
-    max: number;
-}
-export declare class MetricsStore {
-    private static instances;
-    private db;
-    private insertStmt;
-    private constructor();
-    static getInstance(dbPath: string): MetricsStore;
-    /** For testing: reset all singleton instances */
-    static resetInstances(): void;
-    record(metric: MetricRecord): void;
-    recordBatch(metrics: MetricRecord[]): void;
-    query(options: MetricQueryOptions): MetricRow[];
-    aggregate(name: string, startTs?: number, endTs?: number): MetricAggregation | null;
-    cleanup(olderThanMs: number): number;
-    count(name?: string): number;
-    countSince(startTs: number): number;
-    close(): void;
-}
-//# sourceMappingURL=metrics-store.d.ts.map

package/dist/observability/metrics-store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"metrics-store.d.ts","sourceRoot":"","sources":["../../src/observability/metrics-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,SAAS,CAA8D;IACtF,OAAO,CAAC,EAAE,CAAiB;IAC3B,OAAO,CAAC,UAAU,CAAkB;IAEpC,OAAO;IAwBP,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAShD,iDAAiD;IACjD,MAAM,CAAC,cAAc,IAAI,IAAI;IAW7B,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAUlC,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI;IAe1C,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,EAAE;IA4C/C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAoCnF,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAMpC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAW5B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAOnC,KAAK,IAAI,IAAI;CAcd"}

package/dist/observability/metrics-store.js

@@ -1,186 +0,0 @@
-"use strict";
-/**
- * MetricsStore — SQLite-backed metrics storage (STORY-019)
- *
- * Provides record()/query()/cleanup() for operational metrics.
- * Singleton per database path; uses WAL mode for concurrent reads.
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MetricsStore = void 0;
-const fs_1 = require("fs");
-const path_1 = require("path");
-const sqlite_js_1 = __importDefault(require("../sqlite.js"));
-class MetricsStore {
-    static instances = new Map();
-    db;
-    insertStmt;
-    constructor(dbPath) {
-        (0, fs_1.mkdirSync)((0, path_1.dirname)(dbPath), { recursive: true });
-        this.db = new sqlite_js_1.default(dbPath);
-        this.db.pragma('journal_mode = WAL');
-        this.db.pragma('busy_timeout = 3000');
-        this.db.exec(`
-      CREATE TABLE IF NOT EXISTS metrics (
-        id INTEGER PRIMARY KEY AUTOINCREMENT,
-        name TEXT NOT NULL,
-        value REAL NOT NULL,
-        labels TEXT,
-        timestamp INTEGER NOT NULL
-      )
-    `);
-        this.db.exec(`
-      CREATE INDEX IF NOT EXISTS idx_metrics_name_ts ON metrics(name, timestamp)
-    `);
-        this.insertStmt = this.db.prepare('INSERT INTO metrics (name, value, labels, timestamp) VALUES (?, ?, ?, ?)');
-    }
-    static getInstance(dbPath) {
-        let instance = MetricsStore.instances.get(dbPath);
-        if (!instance) {
-            instance = new MetricsStore(dbPath);
-            MetricsStore.instances.set(dbPath, instance);
-        }
-        return instance;
-    }
-    /** For testing: reset all singleton instances */
-    static resetInstances() {
-        for (const instance of MetricsStore.instances.values()) {
-            try {
-                instance.db.close();
-            }
-            catch {
-                /* ignore */
-            }
-        }
-        MetricsStore.instances.clear();
-    }
-    record(metric) {
-        try {
-            const ts = metric.timestamp ?? Date.now();
-            const labelsJson = metric.labels ? JSON.stringify(metric.labels) : null;
-            this.insertStmt.run(metric.name, metric.value, labelsJson, ts);
-        }
-        catch {
-            // Fire-and-forget: never throw from metrics recording
-        }
-    }
-    recordBatch(metrics) {
-        try {
-            const tx = this.db.transaction((items) => {
-                for (const m of items) {
-                    const ts = m.timestamp ?? Date.now();
-                    const labelsJson = m.labels ? JSON.stringify(m.labels) : null;
-                    this.insertStmt.run(m.name, m.value, labelsJson, ts);
-                }
-            });
-            tx(metrics);
-        }
-        catch {
-            // Fire-and-forget: never throw from metrics recording
-        }
-    }
-    query(options) {
-        const conditions = ['name = ?'];
-        const params = [options.name];
-        if (options.startTs !== undefined) {
-            conditions.push('timestamp >= ?');
-            params.push(options.startTs);
-        }
-        if (options.endTs !== undefined) {
-            conditions.push('timestamp <= ?');
-            params.push(options.endTs);
-        }
-        let sql = `SELECT id, name, value, labels, timestamp FROM metrics WHERE ${conditions.join(' AND ')} ORDER BY timestamp DESC`;
-        // Only apply SQL LIMIT when there's no post-filter, otherwise limit after filtering
-        if (options.limit !== undefined && !options.labels) {
-            sql += ' LIMIT ?';
-            params.push(options.limit);
-        }
-        let rows = this.db.prepare(sql).all(...params);
-        // Post-filter by labels if specified
-        if (options.labels) {
-            const filterEntries = Object.entries(options.labels);
-            rows = rows.filter((row) => {
-                if (!row.labels) {
-                    return false;
-                }
-                try {
-                    const parsed = JSON.parse(row.labels);
-                    return filterEntries.every(([k, v]) => parsed[k] === v);
-                }
-                catch {
-                    return false;
-                }
-            });
-            if (options.limit !== undefined) {
-                rows = rows.slice(0, options.limit);
-            }
-        }
-        return rows;
-    }
-    aggregate(name, startTs, endTs) {
-        const conditions = ['name = ?'];
-        const params = [name];
-        if (startTs !== undefined) {
-            conditions.push('timestamp >= ?');
-            params.push(startTs);
-        }
-        if (endTs !== undefined) {
-            conditions.push('timestamp <= ?');
-            params.push(endTs);
-        }
-        const sql = `SELECT COUNT(*) as count, SUM(value) as sum, AVG(value) as avg, MIN(value) as min, MAX(value) as max FROM metrics WHERE ${conditions.join(' AND ')}`;
-        const row = this.db.prepare(sql).get(...params);
-        if (!row || row.count === 0) {
-            return null;
-        }
-        return {
-            name,
-            count: row.count,
-            sum: row.sum ?? 0,
-            avg: row.avg ?? 0,
-            min: row.min ?? 0,
-            max: row.max ?? 0,
-        };
-    }
-    cleanup(olderThanMs) {
-        const cutoff = Date.now() - olderThanMs;
-        const result = this.db.prepare('DELETE FROM metrics WHERE timestamp < ?').run(cutoff);
-        return result.changes;
-    }
-    count(name) {
-        if (name) {
-            const row = this.db
-                .prepare('SELECT COUNT(*) as cnt FROM metrics WHERE name = ?')
-                .get(name);
-            return row.cnt;
-        }
-        const row = this.db.prepare('SELECT COUNT(*) as cnt FROM metrics').get();
-        return row.cnt;
-    }
-    countSince(startTs) {
-        const row = this.db
-            .prepare('SELECT COUNT(*) as cnt FROM metrics WHERE timestamp >= ?')
-            .get(startTs);
-        return row.cnt;
-    }
-    close() {
-        try {
-            this.db.close();
-        }
-        catch {
-            /* already closed */
-        }
-        // Remove from instances map
-        for (const [path, inst] of MetricsStore.instances) {
-            if (inst === this) {
-                MetricsStore.instances.delete(path);
-                break;
-            }
-        }
-    }
-}
-exports.MetricsStore = MetricsStore;
-//# sourceMappingURL=metrics-store.js.map

package/dist/observability/metrics-store.js.map

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

package/dist/observability/operational-issues.d.ts

@@ -1,55 +0,0 @@
-export type IssueSurface = 'gateway' | 'envelope' | 'inbox' | 'ledger' | 'budget' | 'delivery';
-export type IssueSeverity = 'info' | 'warn' | 'error';
-export type IssueStatus = 'open' | 'repair_requested' | 'closed';
-export interface RecordIssueInput {
-    surface: IssueSurface;
-    /** Stable, low-cardinality. NEVER free error text: that is what makes dedupe work. */
-    signature: string;
-    severity: IssueSeverity;
-    /** Raw text; redacted and bounded before storage. */
-    error: string;
-    /** Digested before storage. */
-    sourceRef?: string;
-    ownerAgent?: string;
-    nowMs?: number;
-}
-export interface OperationalIssue {
-    issueId: string;
-    surface: IssueSurface;
-    severity: IssueSeverity;
-    status: IssueStatus;
-    signature: string;
-    lastError: string | null;
-    occurrences: number;
-    firstSeenAt: number;
-    lastSeenAt: number;
-}
-export interface IssueAdapter {
-    prepare(sql: string): {
-        run(...params: unknown[]): unknown;
-        all(...params: unknown[]): unknown[];
-        get?(...params: unknown[]): unknown;
-    };
-}
-export declare const MAX_ISSUE_ERROR_CHARS = 2000;
-/** Idempotent: creates the table on a bare DB, adds `occurrences` to an installed one. */
-export declare function ensureOperationalIssuesTable(db: IssueAdapter): void;
-/** Redaction gate, fail closed: a non-clean scan stores none of the original characters. */
-export declare function redactIssueError(raw: string): string;
-export declare function issueDedupeKey(surface: string, signature: string): string;
-export declare function recordOperationalIssue(db: IssueAdapter, input: RecordIssueInput): {
-    issueId: string;
-    occurrences: number;
-};
-/**
- * Open issues: error before warn before info, then most recent, capped - ordered in SQL so an
- * old error is never hidden behind newer info rows. `minSeverity` lets packets and the
- * self-check turn skip designed refusals (info) while the table keeps counting them.
- */
-export declare function listOpenOperationalIssues(db: IssueAdapter, limit?: number, minSeverity?: IssueSeverity): OperationalIssue[];
-/** One issue by id, or null; the repair path checks existence before writing a bundle. */
-export declare function getOperationalIssue(db: IssueAdapter, issueId: string): OperationalIssue | null;
-export declare function setOperationalIssueStatus(db: IssueAdapter, issueId: string, status: IssueStatus): void;
-/** Closing is a claim that the signature went quiet; an unknown id is an error, not a no-op. */
-export declare function closeOperationalIssue(db: IssueAdapter, issueId: string, reason: string): void;
-//# sourceMappingURL=operational-issues.d.ts.map

package/dist/observability/operational-issues.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"operational-issues.d.ts","sourceRoot":"","sources":["../../src/observability/operational-issues.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAC/F,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACtD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,kBAAkB,GAAG,QAAQ,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,YAAY,CAAC;IACtB,sFAAsF;IACtF,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC;IACxB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG;QACpB,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QACnC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;QACrC,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;KACrC,CAAC;CACH;AAYD,eAAO,MAAM,qBAAqB,OAAQ,CAAC;AAmB3C,0FAA0F;AAC1F,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAcnE;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMpD;AAMD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,gBAAgB,GACtB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CA0D1C;AAkBD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,YAAY,EAChB,KAAK,SAAK,EACV,WAAW,GAAE,aAAsB,GAClC,gBAAgB,EAAE,CAapB;AAED,0FAA0F;AAC1F,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAK9F;AAED,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,YAAY,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,GAClB,IAAI,CAON;AAED,gGAAgG;AAChG,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAK7F"}

package/dist/observability/operational-issues.js

@@ -1,170 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_ISSUE_ERROR_CHARS = void 0;
-exports.ensureOperationalIssuesTable = ensureOperationalIssuesTable;
-exports.redactIssueError = redactIssueError;
-exports.issueDedupeKey = issueDedupeKey;
-exports.recordOperationalIssue = recordOperationalIssue;
-exports.listOpenOperationalIssues = listOpenOperationalIssues;
-exports.getOperationalIssue = getOperationalIssue;
-exports.setOperationalIssueStatus = setOperationalIssueStatus;
-exports.closeOperationalIssue = closeOperationalIssue;
-/**
- * Operational issues: the system's own failures as first-class evidence.
- *
- * Every place a failure already passes through (gateway tool failure, envelope scope
- * mismatch, dead owner-event batch, ledger stagnation) records one row here, aggregated
- * by (surface, signature). Every packet carries the open rows, so the agent sees what is
- * broken before it judges anything; the daily self-check turn triages them.
- *
- * Stored error text passes the secret scan first and FAILS CLOSED: a non-clean scan stores
- * no original characters. This table is read into every prompt, which makes it a new place
- * for credentials to land.
- *
- * Table: awareness_operational_issues in the mama-core database (migration 066 creates it
- * on a fresh install; an installed table without `occurrences` gets the column here).
- */
-const node_crypto_1 = require("node:crypto");
-const secret_filter_js_1 = require("../memory/secret-filter.js");
-const SURFACES = new Set([
-    'gateway',
-    'envelope',
-    'inbox',
-    'ledger',
-    'budget',
-    'delivery',
-]);
-const SEVERITIES = new Set(['info', 'warn', 'error']);
-const SEVERITY_RANK = { error: 0, warn: 1, info: 2 };
-exports.MAX_ISSUE_ERROR_CHARS = 2_000;
-const MAX_SIGNATURE_CHARS = 120;
-const TABLE_DDL = `
-  CREATE TABLE IF NOT EXISTS awareness_operational_issues (
-    issue_id TEXT PRIMARY KEY,
-    dedupe_key TEXT UNIQUE NOT NULL,
-    surface TEXT NOT NULL,
-    severity TEXT NOT NULL,
-    status TEXT NOT NULL,
-    source_delta_id TEXT,
-    first_seen_at INTEGER NOT NULL CHECK (first_seen_at >= 0),
-    last_seen_at INTEGER NOT NULL CHECK (last_seen_at >= first_seen_at),
-    next_retry_at INTEGER,
-    last_error TEXT,
-    owner_agent TEXT,
-    occurrences INTEGER NOT NULL DEFAULT 1
-  )`;
-/** Idempotent: creates the table on a bare DB, adds `occurrences` to an installed one. */
-function ensureOperationalIssuesTable(db) {
-    db.prepare(TABLE_DDL).run();
-    const columns = db.prepare('PRAGMA table_info(awareness_operational_issues)').all();
-    if (!columns.some((column) => column.name === 'occurrences')) {
-        db.prepare('ALTER TABLE awareness_operational_issues ADD COLUMN occurrences INTEGER NOT NULL DEFAULT 1').run();
-    }
-    db.prepare(`CREATE INDEX IF NOT EXISTS idx_awareness_operational_issues_status_seen
-       ON awareness_operational_issues(status, last_seen_at DESC)`).run();
-}
-/** Redaction gate, fail closed: a non-clean scan stores none of the original characters. */
-function redactIssueError(raw) {
-    const scan = (0, secret_filter_js_1.scanForSecrets)(raw);
-    if (!scan.clean) {
-        return `[redacted: ${scan.matches.join(',')}]`;
-    }
-    return raw.replace(/\s+/g, ' ').trim().slice(0, exports.MAX_ISSUE_ERROR_CHARS);
-}
-function digest(value) {
-    return `sha256:${(0, node_crypto_1.createHash)('sha256').update(value).digest('hex').slice(0, 24)}`;
-}
-function issueDedupeKey(surface, signature) {
-    return (0, node_crypto_1.createHash)('sha256').update(`${surface}\0${signature}`).digest('hex');
-}
-function recordOperationalIssue(db, input) {
-    if (!SURFACES.has(input.surface)) {
-        throw new Error(`operational issue: unknown surface ${String(input.surface)}`);
-    }
-    if (!SEVERITIES.has(input.severity)) {
-        throw new Error(`operational issue: unknown severity ${String(input.severity)}`);
-    }
-    const signature = input.signature.replace(/\s+/g, ' ').trim().slice(0, MAX_SIGNATURE_CHARS);
-    if (!signature) {
-        throw new Error('operational issue: signature is required');
-    }
-    const now = input.nowMs ?? Date.now();
-    const dedupeKey = issueDedupeKey(input.surface, signature);
-    const lastError = redactIssueError(input.error);
-    const sourceRef = input.sourceRef ? digest(input.sourceRef) : null;
-    const existing = db
-        .prepare(`SELECT issue_id, occurrences, status FROM awareness_operational_issues WHERE dedupe_key = ?`)
-        .all(dedupeKey);
-    if (existing.length > 0) {
-        const row = existing[0];
-        // A closed issue that recurs reopens: closure was a claim about the signature going quiet.
-        db.prepare(`UPDATE awareness_operational_issues
-          SET last_seen_at = MAX(last_seen_at, ?), occurrences = occurrences + 1,
-              last_error = ?, severity = ?, source_delta_id = COALESCE(?, source_delta_id),
-              owner_agent = COALESCE(?, owner_agent),
-              status = CASE WHEN status = 'closed' THEN 'open' ELSE status END
-        WHERE dedupe_key = ?`).run(now, `${signature} | ${lastError}`, input.severity, sourceRef, input.ownerAgent ?? null, dedupeKey);
-        return { issueId: row.issue_id, occurrences: row.occurrences + 1 };
-    }
-    const issueId = `iss_${dedupeKey.slice(0, 16)}`;
-    db.prepare(`INSERT INTO awareness_operational_issues
-       (issue_id, dedupe_key, surface, severity, status, source_delta_id, first_seen_at,
-        last_seen_at, next_retry_at, last_error, owner_agent, occurrences)
-     VALUES (?, ?, ?, ?, 'open', ?, ?, ?, NULL, ?, ?, 1)`).run(issueId, dedupeKey, input.surface, input.severity, sourceRef, now, now, `${signature} | ${lastError}`, input.ownerAgent ?? null);
-    return { issueId, occurrences: 1 };
-}
-function rowToIssue(row) {
-    const stored = typeof row.last_error === 'string' ? row.last_error : '';
-    const separator = stored.indexOf(' | ');
-    return {
-        issueId: String(row.issue_id),
-        surface: String(row.surface),
-        severity: String(row.severity),
-        status: String(row.status),
-        signature: separator > 0 ? stored.slice(0, separator) : stored,
-        lastError: separator > 0 ? stored.slice(separator + 3) : stored || null,
-        occurrences: Number(row.occurrences ?? 1),
-        firstSeenAt: Number(row.first_seen_at),
-        lastSeenAt: Number(row.last_seen_at),
-    };
-}
-/**
- * Open issues: error before warn before info, then most recent, capped - ordered in SQL so an
- * old error is never hidden behind newer info rows. `minSeverity` lets packets and the
- * self-check turn skip designed refusals (info) while the table keeps counting them.
- */
-function listOpenOperationalIssues(db, limit = 20, minSeverity = 'info') {
-    const maxRank = SEVERITY_RANK[minSeverity] ?? 2;
-    const rows = db
-        .prepare(`SELECT * FROM awareness_operational_issues
-        WHERE status <> 'closed'
-          AND (CASE severity WHEN 'error' THEN 0 WHEN 'warn' THEN 1 ELSE 2 END) <= ?
-        ORDER BY (CASE severity WHEN 'error' THEN 0 WHEN 'warn' THEN 1 ELSE 2 END) ASC,
-                 last_seen_at DESC
-        LIMIT ?`)
-        .all(maxRank, Math.min(Math.max(limit, 1), 200));
-    return rows.map(rowToIssue);
-}
-/** One issue by id, or null; the repair path checks existence before writing a bundle. */
-function getOperationalIssue(db, issueId) {
-    const rows = db
-        .prepare(`SELECT * FROM awareness_operational_issues WHERE issue_id = ?`)
-        .all(issueId);
-    return rows.length > 0 ? rowToIssue(rows[0]) : null;
-}
-function setOperationalIssueStatus(db, issueId, status) {
-    const result = db
-        .prepare(`UPDATE awareness_operational_issues SET status = ? WHERE issue_id = ?`)
-        .run(status, issueId);
-    if (!result || result.changes !== 1) {
-        throw new Error(`operational issue not found: ${issueId}`);
-    }
-}
-/** Closing is a claim that the signature went quiet; an unknown id is an error, not a no-op. */
-function closeOperationalIssue(db, issueId, reason) {
-    if (!reason.trim()) {
-        throw new Error('operational issue: a close reason is required');
-    }
-    setOperationalIssueStatus(db, issueId, 'closed');
-}
-//# sourceMappingURL=operational-issues.js.map

package/dist/observability/operational-issues.js.map

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

package/dist/onboarding/agent-contract.d.ts

@@ -1,42 +0,0 @@
-/**
- * The onboarding contract - the single source of onboarding truth.
- *
- * `mama --help` renders the static half (what the journey is), `mama status`
- * renders the dynamic half (where this install stands and the exact next
- * action per missing item). Everything else - plugin skill, README, the agent
- * driving a conversation - is a thin pointer to these two renders. Guidance
- * strings live ONLY here; duplicating them elsewhere reintroduces the drift
- * this module exists to kill.
- *
- * Pure evaluation: no I/O. Observation lives in assess-live.ts; this module
- * owns judgment and wording. The journey endpoint is deliberately not
- * "setup complete" but the first evidenced report arriving.
- */
-export type OnboardingItemId = 'config' | 'gateway' | 'trust_anchor' | 'daemon' | 'sources' | 'first_report';
-export interface OnboardingItemState {
-    id: OnboardingItemId;
-    done: boolean;
-    guidance: string;
-}
-export interface OnboardingState {
-    complete: boolean;
-    missing: OnboardingItemId[];
-    items: OnboardingItemState[];
-}
-export interface AssessDeps {
-    configLoadable: boolean;
-    daemonRunning: boolean;
-    telegramConfigured: boolean;
-    allowedChats: boolean;
-    enabledConnectors: number;
-    readyConnectors: number;
-    firstReportAt: string | null;
-}
-/** Journey order is fixed: `missing` reports in this order, always. */
-export declare const ONBOARDING_ITEMS: readonly OnboardingItemId[];
-export declare function assessOnboarding(deps: AssessDeps): OnboardingState;
-/** Static contract block for `mama --help` and the README pointer. */
-export declare function renderContractIntro(): string;
-/** Dynamic contract block for `mama status` when onboarding is incomplete. */
-export declare function renderContractStatus(state: OnboardingState): string;
-//# sourceMappingURL=agent-contract.d.ts.map

package/dist/onboarding/agent-contract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-contract.d.ts","sourceRoot":"","sources":["../../src/onboarding/agent-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,SAAS,GACT,cAAc,GACd,QAAQ,GACR,SAAS,GACT,cAAc,CAAC;AAEnB,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,gBAAgB,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,EAAE,SAAS,gBAAgB,EAO9C,CAAC;AAuDX,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,CAQlE;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,IAAI,MAAM,CAU5C;AAED,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CA8BnE"}