@timmeck/brain-core 2.36.106 → 2.36.108

package/dist/self-model/stage3-run-log.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Stage-3 Run Log — Observability for Self-Model execution stages.
+ *
+ * Every Stage-3 sub-step (operationalize, diagnose, improve, evolve)
+ * gets individually tracked with timing, success/failure, and error details.
+ *
+ * P0 fix: no more swallowed errors in catch blocks.
+ */
+import type Database from 'better-sqlite3';
+export declare function runStage3RunLogMigration(db: Database.Database): void;
+export type Stage3StageName = 'operationalize' | 'diagnose' | 'improve' | 'evolve';
+export interface Stage3RunEntry {
+    cycle: number;
+    stage: Stage3StageName;
+    status: 'success' | 'failure' | 'skipped';
+    duration_ms: number;
+    result?: Record<string, unknown>;
+    error_message?: string;
+    error_stack?: string;
+}
+export interface Stage3Summary {
+    total_runs: number;
+    successes: number;
+    failures: number;
+    by_stage: Record<string, {
+        runs: number;
+        failures: number;
+        avg_duration_ms: number;
+    }>;
+    recent_failures: Array<{
+        cycle: number;
+        stage: string;
+        error_message: string;
+        created_at: string;
+    }>;
+}
+export declare class Stage3RunLog {
+    private db;
+    constructor(db: Database.Database);
+    /** Record a stage execution result. */
+    record(entry: Stage3RunEntry): void;
+    /**
+     * Run a stage with full instrumentation.
+     * Returns the result or undefined on failure. Never throws.
+     */
+    runStage<T>(cycle: number, stage: Stage3StageName, fn: () => T, log: {
+        warn: (msg: string) => void;
+        info: (msg: string) => void;
+    }): T | undefined;
+    /** Get summary of all Stage-3 runs. */
+    getSummary(): Stage3Summary;
+}

package/dist/self-model/stage3-run-log.js

@@ -0,0 +1,88 @@
+// ── Migration ────────────────────────────────────────
+export function runStage3RunLogMigration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS stage3_run_log (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      cycle INTEGER NOT NULL,
+      stage TEXT NOT NULL,
+      status TEXT NOT NULL,
+      duration_ms INTEGER NOT NULL,
+      result_json TEXT,
+      error_message TEXT,
+      error_stack TEXT,
+      created_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+    CREATE INDEX IF NOT EXISTS idx_s3rl_cycle ON stage3_run_log(cycle);
+    CREATE INDEX IF NOT EXISTS idx_s3rl_stage ON stage3_run_log(stage);
+    CREATE INDEX IF NOT EXISTS idx_s3rl_status ON stage3_run_log(status);
+  `);
+}
+// ── Engine ───────────────────────────────────────────
+export class Stage3RunLog {
+    db;
+    constructor(db) {
+        this.db = db;
+        runStage3RunLogMigration(db);
+    }
+    /** Record a stage execution result. */
+    record(entry) {
+        this.db.prepare(`
+      INSERT INTO stage3_run_log (cycle, stage, status, duration_ms, result_json, error_message, error_stack)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `).run(entry.cycle, entry.stage, entry.status, entry.duration_ms, entry.result ? JSON.stringify(entry.result) : null, entry.error_message ?? null, entry.error_stack ?? null);
+    }
+    /**
+     * Run a stage with full instrumentation.
+     * Returns the result or undefined on failure. Never throws.
+     */
+    runStage(cycle, stage, fn, log) {
+        const start = Date.now();
+        try {
+            const result = fn();
+            const duration = Date.now() - start;
+            this.record({
+                cycle, stage, status: 'success', duration_ms: duration,
+                result: typeof result === 'object' && result !== null ? result : { value: result },
+            });
+            return result;
+        }
+        catch (err) {
+            const duration = Date.now() - start;
+            const error = err;
+            const message = error.message || String(err);
+            const stack = error.stack?.substring(0, 500) || '';
+            // Log at WARN level — never silently swallow
+            log.warn(`[stage3] ${stage} FAILED in cycle ${cycle} (${duration}ms): ${message}`);
+            this.record({
+                cycle, stage, status: 'failure', duration_ms: duration,
+                error_message: message, error_stack: stack,
+            });
+            return undefined;
+        }
+    }
+    /** Get summary of all Stage-3 runs. */
+    getSummary() {
+        const total = this.db.prepare('SELECT count(*) as c FROM stage3_run_log').get().c;
+        const successes = this.db.prepare("SELECT count(*) as c FROM stage3_run_log WHERE status = 'success'").get().c;
+        const failures = total - successes;
+        const byStageRows = this.db.prepare(`
+      SELECT stage,
+             count(*) as runs,
+             sum(case when status = 'failure' then 1 else 0 end) as failures,
+             avg(duration_ms) as avg_duration_ms
+      FROM stage3_run_log
+      GROUP BY stage
+    `).all();
+        const by_stage = {};
+        for (const row of byStageRows) {
+            by_stage[row.stage] = { runs: row.runs, failures: row.failures, avg_duration_ms: Math.round(row.avg_duration_ms) };
+        }
+        const recent_failures = this.db.prepare(`
+      SELECT cycle, stage, error_message, created_at
+      FROM stage3_run_log WHERE status = 'failure'
+      ORDER BY created_at DESC LIMIT 10
+    `).all();
+        return { total_runs: total, successes, failures, by_stage, recent_failures };
+    }
+}
+//# sourceMappingURL=stage3-run-log.js.map

package/dist/self-model/stage3-run-log.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timmeck/brain-core",
-  "version": "2.36.106",
+  "version": "2.36.108",
   "description": "Shared core infrastructure for the Brain ecosystem — IPC, MCP, CLI, DB connection, and utilities",
   "type": "module",
   "main": "dist/index.js",