@jungjaehoon/mama-core 2.0.0 → 2.1.1

package/db/migrations/061-add-tool-trace-failure-code.sql

@@ -0,0 +1,19 @@
+-- Migration 061: tool_traces.failure_code — carry the thrower's closed cause.
+--
+-- WHY 061, NOT 043: live DBs carry schema_version rows 44-60 from a RETIRED
+-- 2026-05/06 migration chain that shared this ledger table. The runner skips
+-- any file numbered at or below MAX(version), so this migration shipped as
+-- 043 in core 2.1.0 and silently never applied anywhere the retired chain
+-- had run. New core migrations must number ABOVE that ceiling (60) - the
+-- migration-chain test pins the jump so nobody "fixes" the gap back into
+-- the dead zone.
+--
+-- The failure choke already emits a structured code (envelope_missing,
+-- context_compile_scope_denied, ...) and the sanitizer explicitly preserves
+-- it; the trace INSERT was the one place that dropped it, leaving only
+-- `gateway_tool_failed;sha256=...` digests (measured 2026-07-30: the dominant
+-- digest covered 52% of 2,460 context_compile failures with no name).
+-- Nullable on purpose: a failure without a code stays NULL — labels are
+-- carried, never invented.
+
+ALTER TABLE tool_traces ADD COLUMN failure_code TEXT;

package/dist/model-runs/tool-trace-store.js

@@ -58,6 +58,7 @@ function mapToolTraceRow(row) {
         execution_status: nullableString(row.execution_status),
         duration_ms: requiredNonNegativeInteger(row.duration_ms, 'duration_ms'),
         envelope_hash: nullableString(row.envelope_hash),
+        failure_code: nullableString(row.failure_code),
         created_at: requiredInteger(row.created_at, 'created_at'),
     };
 }
@@ -70,7 +71,8 @@ function selectToolTrace(adapter, id) {
         .prepare(`
         SELECT
           trace_id, model_run_id, gateway_call_id, tool_name, input_summary,
-          output_summary, execution_status, duration_ms, envelope_hash, created_at
+          output_summary, execution_status, duration_ms, envelope_hash, failure_code,
+          created_at
         FROM tool_traces
         WHERE trace_id = ?
       `)
@@ -89,11 +91,12 @@ async function appendToolTrace(input) {
         .prepare(`
         INSERT INTO tool_traces (
           trace_id, model_run_id, gateway_call_id, tool_name, input_summary,
-          output_summary, execution_status, duration_ms, envelope_hash, created_at
+          output_summary, execution_status, duration_ms, envelope_hash, failure_code,
+          created_at
         )
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
       `)
-        .run(id, modelRunId, nullableString(input.gateway_call_id), toolName, nullableString(input.input_summary), nullableString(input.output_summary), nullableString(input.execution_status), normalizeDuration(input.duration_ms), nullableString(input.envelope_hash), normalizeTimestamp(input.created_at));
+        .run(id, modelRunId, nullableString(input.gateway_call_id), toolName, nullableString(input.input_summary), nullableString(input.output_summary), nullableString(input.execution_status), normalizeDuration(input.duration_ms), nullableString(input.envelope_hash), nullableString(input.failure_code), normalizeTimestamp(input.created_at));
     return selectToolTrace(adapter, id);
 }
 async function listToolTracesForRun(modelRunId) {
@@ -103,7 +106,8 @@ async function listToolTracesForRun(modelRunId) {
         .prepare(`
         SELECT
           trace_id, model_run_id, gateway_call_id, tool_name, input_summary,
-          output_summary, execution_status, duration_ms, envelope_hash, created_at
+          output_summary, execution_status, duration_ms, envelope_hash, failure_code,
+          created_at
         FROM tool_traces
         WHERE model_run_id = ?
         ORDER BY created_at DESC, rowid DESC

package/dist/model-runs/types.d.ts

@@ -52,6 +52,8 @@ export interface AppendToolTraceInput {
     execution_status?: string | null;
     duration_ms?: number | null;
     envelope_hash?: string | null;
+    /** Thrower's closed cause (e.g. envelope_missing). Carried, never invented. */
+    failure_code?: string | null;
     created_at?: number;
 }
 export interface ToolTraceRecord {
@@ -64,6 +66,7 @@ export interface ToolTraceRecord {
     execution_status: string | null;
     duration_ms: number;
     envelope_hash: string | null;
+    failure_code: string | null;
     created_at: number;
 }
 //# sourceMappingURL=types.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jungjaehoon/mama-core",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "description": "MAMA Core - Shared modules for Memory-Augmented MCP Assistant",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",