nodebench-mcp 2.54.0 → 2.56.0

package/dist/benchmarks/longitudinalHarness.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env npx tsx
+// @ts-nocheck — standalone CLI script generated by external tooling; not part of the library build
 /**
  * longitudinalHarness.ts — Longitudinal dogfood benchmark harness for NodeBench MCP.
  *
@@ -25,6 +26,90 @@ import { learningTools } from "../tools/learningTools.js";
 import { flywheelTools } from "../tools/flywheelTools.js";
 import { createMetaTools } from "../tools/metaTools.js";
 import { createProgressiveDiscoveryTools } from "../tools/progressiveDiscoveryTools.js";
+/** Seeded PRNG for deterministic perturbation randomness. */
+function seededRandom(seed) {
+    let s = seed;
+    return () => {
+        s = (s * 1664525 + 1013904223) & 0x7fffffff;
+        return s / 0x7fffffff;
+    };
+}
+const PERTURBATIONS = [
+    {
+        type: "thread_reset",
+        description: "Clear causal_events for user before session (simulates new thread)",
+        severity: "high",
+        apply: (session) => {
+            // Wipe causal memory for this user — system must recover from prior packet
+            const db = getDb();
+            db.prepare("DELETE FROM causal_events WHERE userId = ?").run(session.userId);
+            // Context must be restated since memory was wiped
+            return { ...session, contextRestated: true, repeatQuestionDetected: true };
+        },
+    },
+    {
+        type: "tool_failure",
+        description: "Randomly mark 1-2 tools in chain as failed (tests graceful degradation)",
+        severity: "medium",
+        apply: (session) => {
+            // Inject 1-2 synthetic tool errors
+            const rng = seededRandom(session.runId.length + session.sessionIndex);
+            const failCount = rng() > 0.5 ? 2 : 1;
+            const injectedErrors = [];
+            for (let i = 0; i < failCount; i++) {
+                injectedErrors.push(`perturbation:tool_failure_injected_${i}`);
+            }
+            return {
+                ...session,
+                errors: [...session.errors, ...injectedErrors],
+                judgeScore: Math.max(1.0, session.judgeScore - 0.5 * failCount),
+            };
+        },
+    },
+    {
+        type: "stale_memory",
+        description: "Inject a causal_event with 30-day-old timestamp for a different entity",
+        severity: "low",
+        apply: (session) => {
+            const db = getDb();
+            const staleDate = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000).toISOString();
+            db.prepare(`
+        INSERT INTO causal_events (id, userId, eventType, payload, createdAt)
+        VALUES (?, ?, ?, ?, ?)
+      `).run(genId("ce_stale"), session.userId, "stale_injection", JSON.stringify({ entity: "StaleCorpXYZ", scenarioId: "stale_test", injected: true }), staleDate);
+            return session; // Session itself unchanged — we measure if stale data pollutes results
+        },
+    },
+    {
+        type: "model_swap",
+        description: "Jitter judge score by +/-0.3 to simulate different model behavior",
+        severity: "low",
+        apply: (session) => {
+            const rng = seededRandom(session.sessionIndex * 31 + session.runId.length);
+            const jitter = (rng() - 0.5) * 0.6; // range: -0.3 to +0.3
+            return {
+                ...session,
+                judgeScore: Math.max(1.0, Math.min(5.0, session.judgeScore + jitter)),
+            };
+        },
+    },
+    {
+        type: "schema_change",
+        description: "Skip one field from packet output (tests downstream handling of missing fields)",
+        severity: "medium",
+        apply: (session) => {
+            // Simulate missing export by clearing exportProduced on some sessions
+            return {
+                ...session,
+                exportProduced: false,
+                judgeScore: Math.max(1.0, session.judgeScore - 0.2),
+            };
+        },
+    },
+];
+function selectPerturbation(sessionIndex) {
+    return PERTURBATIONS[(sessionIndex - 1) % PERTURBATIONS.length];
+}
 // ═══════════════════════════════════════════════════════════════════════════
 // Constants
 // ═══════════════════════════════════════════════════════════════════════════
@@ -138,11 +223,55 @@ CREATE TABLE IF NOT EXISTS causal_events (
   createdAt   TEXT NOT NULL DEFAULT (datetime('now'))
 );
 
+CREATE TABLE IF NOT EXISTS session_actions (
+  id              INTEGER PRIMARY KEY AUTOINCREMENT,
+  sessionRunId    TEXT NOT NULL,
+  actionIndex     INTEGER NOT NULL,
+  toolName        TEXT NOT NULL,
+  inputSummary    TEXT NOT NULL DEFAULT '',
+  outputSummary   TEXT NOT NULL DEFAULT '',
+  latencyMs       INTEGER NOT NULL DEFAULT 0,
+  passed          INTEGER NOT NULL DEFAULT 0,
+  skipped         INTEGER NOT NULL DEFAULT 0,
+  error           TEXT,
+  createdAt       TEXT NOT NULL DEFAULT (datetime('now')),
+  FOREIGN KEY (sessionRunId) REFERENCES longitudinal_sessions(runId)
+);
+
+CREATE TABLE IF NOT EXISTS benchmark_rollups (
+  id              INTEGER PRIMARY KEY AUTOINCREMENT,
+  period          TEXT NOT NULL,
+  periodKey       TEXT NOT NULL,
+  totalRuns       INTEGER NOT NULL DEFAULT 0,
+  completionRate  REAL NOT NULL DEFAULT 0,
+  avgJudgeScore   REAL NOT NULL DEFAULT 0,
+  rca             REAL NOT NULL DEFAULT 0,
+  prr             REAL NOT NULL DEFAULT 0,
+  durabilityScore REAL NOT NULL DEFAULT 0,
+  topFailureMode  TEXT NOT NULL DEFAULT 'none',
+  createdAt       TEXT NOT NULL DEFAULT (datetime('now')),
+  UNIQUE(period, periodKey)
+);
+
+CREATE TABLE IF NOT EXISTS workflow_maturity (
+  id              INTEGER PRIMARY KEY AUTOINCREMENT,
+  scenarioId      TEXT NOT NULL,
+  maturityLevel   TEXT NOT NULL,
+  label           TEXT NOT NULL,
+  evidence        TEXT NOT NULL DEFAULT '',
+  batchId         TEXT NOT NULL,
+  createdAt       TEXT NOT NULL DEFAULT (datetime('now')),
+  UNIQUE(scenarioId, batchId)
+);
+
 CREATE INDEX IF NOT EXISTS idx_longitudinal_batch  ON longitudinal_sessions(batchId);
 CREATE INDEX IF NOT EXISTS idx_longitudinal_user   ON longitudinal_sessions(userId);
 CREATE INDEX IF NOT EXISTS idx_longitudinal_cohort ON longitudinal_sessions(cohortSize);
 CREATE INDEX IF NOT EXISTS idx_founder_packets_entity ON founder_packets(entityId, scenarioId);
 CREATE INDEX IF NOT EXISTS idx_causal_events_user ON causal_events(userId);
+CREATE INDEX IF NOT EXISTS idx_session_actions_run ON session_actions(sessionRunId);
+CREATE INDEX IF NOT EXISTS idx_benchmark_rollups_period ON benchmark_rollups(period, periodKey);
+CREATE INDEX IF NOT EXISTS idx_workflow_maturity_scenario ON workflow_maturity(scenarioId);
 `;
 function ensureSchema() {
     const db = getDb();
@@ -160,6 +289,13 @@ function ensureSchema() {
     catch {
         db.exec("DROP TABLE IF EXISTS causal_events");
     }
+    // Migrate session_actions if schema changed
+    try {
+        db.prepare("SELECT sessionRunId FROM session_actions LIMIT 1").get();
+    }
+    catch {
+        db.exec("DROP TABLE IF EXISTS session_actions");
+    }
     db.exec(LONGITUDINAL_SCHEMA);
 }
 // ═══════════════════════════════════════════════════════════════════════════
@@ -217,6 +353,16 @@ function persistSession(session, batchId, cohortSize) {
       (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
   `).run(session.runId, batchId, cohortSize, session.userId, session.role, session.scenarioId, session.sessionIndex, session.timeHorizon, session.surface, session.toolCallCount, session.latencyMs, session.packetGenerated ? 1 : 0, session.packetReused ? 1 : 0, session.repeatQuestionDetected ? 1 : 0, session.contextRestated ? 1 : 0, session.exportProduced ? 1 : 0, session.judgeScore, JSON.stringify(session.errors));
 }
+function persistActionRecords(sessionRunId, actions) {
+    const db = getDb();
+    const stmt = db.prepare(`
+    INSERT INTO session_actions (sessionRunId, actionIndex, toolName, inputSummary, outputSummary, latencyMs, passed, skipped, error)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `);
+    for (const a of actions) {
+        stmt.run(sessionRunId, a.actionIndex, a.toolName, a.inputSummary, a.outputSummary, a.latencyMs, a.passed ? 1 : 0, a.skipped ? 1 : 0, a.error ?? null);
+    }
+}
 /**
  * Issue 1 fix: Check founder_packets table for a prior packet matching this entity+scenario.
  * Returns true only if sessionIndex > 1 AND a stored packet exists.
@@ -266,7 +412,7 @@ function recordCausalEvent(db, userId, scenarioId, sessionIndex) {
 // ═══════════════════════════════════════════════════════════════════════════
 // Session Simulation
 // ═══════════════════════════════════════════════════════════════════════════
-async function simulateSession(user, scenarioId, sessionIndex, timeHorizon, batchId, cohortSize) {
+async function simulateSession(user, scenarioId, sessionIndex, timeHorizon, batchId, cohortSize, perturbation) {
     const tools = await getAllTools();
     const chain = SCENARIO_TOOL_CHAINS[scenarioId];
     if (!chain) {
@@ -288,25 +434,69 @@ async function simulateSession(user, scenarioId, sessionIndex, timeHorizon, batc
     // Issue 2 fix: check causal_events for prior memory from this user
     const hasPriorMemory = sessionIndex > 1 && hasCausalMemory(db, user.userId);
     // Context restated only if session > 1 AND no causal memory exists
-    const contextRestated = sessionIndex > 1 && !hasPriorMemory;
+    let contextRestated = sessionIndex > 1 && !hasPriorMemory;
     // Repeat question: if context was restated, the user likely re-asked old questions.
-    const repeatQuestionDetected = contextRestated;
+    let repeatQuestionDetected = contextRestated;
     // Issue 1 fix: if packet reused and sessionIndex > 1, skip regeneration of the chain
     // (but still run non-packet tools like record_event)
     const skipRegeneration = packetReused && sessionIndex > 1;
     let allToolsFound = true;
+    // Per-action tracking
+    const actionRecords = [];
+    // Apply thread_reset perturbation BEFORE chain (wipes causal memory)
+    if (perturbation?.type === "thread_reset") {
+        const db2 = getDb();
+        db2.prepare("DELETE FROM causal_events WHERE userId = ?").run(user.userId);
+    }
+    // Apply stale_memory perturbation BEFORE chain (injects stale data)
+    if (perturbation?.type === "stale_memory") {
+        const db2 = getDb();
+        const staleDate = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000).toISOString();
+        db2.prepare(`
+      INSERT INTO causal_events (id, userId, eventType, payload, createdAt)
+      VALUES (?, ?, ?, ?, ?)
+    `).run(genId("ce_stale"), user.userId, "stale_injection", JSON.stringify({ entity: "StaleCorpXYZ", scenarioId: "stale_test", injected: true }), staleDate);
+    }
+    // Determine which tools to "fail" for tool_failure perturbation
+    const failedToolIndices = new Set();
+    if (perturbation?.type === "tool_failure") {
+        const rng = seededRandom(sessionIndex * 17 + chain.length);
+        const failCount = rng() > 0.5 ? 2 : 1;
+        // Pick random non-first, non-last indices
+        const candidates = chain.map((_, i) => i).filter((i) => i > 0 && i < chain.length - 1);
+        for (let f = 0; f < Math.min(failCount, candidates.length); f++) {
+            const pick = Math.floor(rng() * candidates.length);
+            failedToolIndices.add(candidates[pick]);
+            candidates.splice(pick, 1);
+        }
+    }
+    // Determine if schema_change perturbation skips a field
+    const schemaSkipExport = perturbation?.type === "schema_change";
     // Run the tool chain
     for (let i = 0; i < chain.length; i++) {
         const toolName = chain[i];
         const isCoreTool = i === 0; // first tool in chain is core
         // Issue 3 fix: check if tool exists in loaded tools before calling
         if (!availableToolNames.has(toolName)) {
+            actionRecords.push({
+                actionIndex: i, toolName, inputSummary: "", outputSummary: "",
+                latencyMs: 0, passed: !isCoreTool, skipped: true, error: isCoreTool ? `tool_not_found:${toolName}` : undefined,
+            });
             if (isCoreTool) {
-                // Core tool missing is a real error
                 errors.push(`tool_not_found:${toolName}`);
                 allToolsFound = false;
             }
-            // Non-core tool missing: skip gracefully, don't count as error
+            toolCallCount++;
+            continue;
+        }
+        // Perturbation: injected tool failure
+        if (failedToolIndices.has(i)) {
+            const errMsg = `perturbation:tool_failure_injected:${toolName}`;
+            errors.push(errMsg);
+            actionRecords.push({
+                actionIndex: i, toolName, inputSummary: "perturbation_injected", outputSummary: "",
+                latencyMs: 0, passed: false, skipped: false, error: errMsg,
+            });
             toolCallCount++;
             continue;
         }
@@ -314,23 +504,36 @@ async function simulateSession(user, scenarioId, sessionIndex, timeHorizon, batc
         // Issue 1 fix: skip memo/analysis tools if reusing prior packet
         if (skipRegeneration && toolName !== "record_event" && toolName !== "track_milestone" && toolName !== "check_mcp_setup") {
             toolCallCount++;
-            // Still count as generated since we're reusing
-            if (toolName === "render_decision_memo") {
+            const skipExport = toolName === "render_decision_memo";
+            if (skipExport && !schemaSkipExport) {
                 exportProduced = true;
             }
+            actionRecords.push({
+                actionIndex: i, toolName, inputSummary: "skip_reuse", outputSummary: "packet_reused",
+                latencyMs: 0, passed: true, skipped: true,
+            });
             continue;
         }
         // Build scenario-appropriate args
         const args = buildToolArgs(toolName, user, scenarioId);
         const result = await callTool(tool, args);
         toolCallCount++;
+        actionRecords.push({
+            actionIndex: i, toolName,
+            inputSummary: JSON.stringify(args).slice(0, 200),
+            outputSummary: result.ok ? String(result.result).slice(0, 200) : "",
+            latencyMs: result.ms, passed: result.ok, skipped: false,
+            error: result.ok ? undefined : result.error?.slice(0, 200),
+        });
         if (!result.ok) {
             errors.push(`${toolName}:${result.error?.slice(0, 120)}`);
         }
         // Detect packet generation from memo/export tools
         if (toolName === "render_decision_memo" && result.ok) {
             packetGenerated = true;
-            exportProduced = true;
+            if (!schemaSkipExport) {
+                exportProduced = true;
+            }
         }
     }
     // Issue 1 fix: store packet after generation so future sessions can reuse
@@ -362,7 +565,18 @@ async function simulateSession(user, scenarioId, sessionIndex, timeHorizon, batc
         : scenarioId === "important_change"
             ? "engine_api"
             : "mcp";
-    const session = {
+    // Apply model_swap perturbation: jitter the judge score
+    if (perturbation?.type === "model_swap") {
+        const rng = seededRandom(sessionIndex * 31 + runId.length);
+        const jitter = (rng() - 0.5) * 0.6; // -0.3 to +0.3
+        judgeScore = Math.max(1.0, Math.min(5.0, judgeScore + jitter));
+    }
+    // Apply thread_reset perturbation: force context restated
+    if (perturbation?.type === "thread_reset") {
+        contextRestated = true;
+        repeatQuestionDetected = true;
+    }
+    let session = {
         runId,
         userId: user.userId,
         role: user.role,
@@ -380,7 +594,12 @@ async function simulateSession(user, scenarioId, sessionIndex, timeHorizon, batc
         judgeScore,
         errors,
     };
+    // Store perturbation type as metadata in errors for tracking
+    if (perturbation) {
+        session = { ...session, errors: [...session.errors, `perturbation:${perturbation.type}`] };
+    }
     persistSession(session, batchId, cohortSize);
+    persistActionRecords(session.runId, actionRecords);
     return session;
 }
 function buildToolArgs(toolName, user, scenarioId) {
@@ -527,6 +746,205 @@ export function generateCohortReport(sessions, cohortSize, layer) {
     };
 }
 // ═══════════════════════════════════════════════════════════════════════════
+// Drift Durability Score
+// ═══════════════════════════════════════════════════════════════════════════
+export function computeDriftMetrics(sessions) {
+    const perturbedSessions = sessions.filter((s) => s.errors.some((e) => e.startsWith("perturbation:")));
+    const cleanSessions = sessions.filter((s) => !s.errors.some((e) => e.startsWith("perturbation:")));
+    if (perturbedSessions.length === 0) {
+        return { driftRecoveryRate: 100, perturbationSurvivalRate: 100, staleMemoryRejectionRate: 100 };
+    }
+    // driftRecoveryRate: % of perturbed sessions that still completed (have tool calls and judge >= 2)
+    const recovered = perturbedSessions.filter((s) => s.toolCallCount > 0 && s.judgeScore >= 2.0).length;
+    const driftRecoveryRate = (recovered / perturbedSessions.length) * 100;
+    // perturbationSurvivalRate: % of perturbations that didn't cause failure (judgeScore >= 3.0)
+    const survived = perturbedSessions.filter((s) => s.judgeScore >= 3.0).length;
+    const perturbationSurvivalRate = (survived / perturbedSessions.length) * 100;
+    // staleMemoryRejectionRate: % of stale_memory perturbations where stale data didn't pollute
+    // (judgeScore didn't drop below clean baseline average minus 0.5)
+    const cleanAvg = cleanSessions.length > 0
+        ? cleanSessions.reduce((a, s) => a + s.judgeScore, 0) / cleanSessions.length
+        : 3.5;
+    const staleSessions = perturbedSessions.filter((s) => s.errors.some((e) => e.includes("stale_memory")));
+    const staleRejected = staleSessions.filter((s) => s.judgeScore >= cleanAvg - 0.5).length;
+    const staleMemoryRejectionRate = staleSessions.length > 0
+        ? (staleRejected / staleSessions.length) * 100
+        : 100;
+    return { driftRecoveryRate, perturbationSurvivalRate, staleMemoryRejectionRate };
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Composite Durability Score
+// ═══════════════════════════════════════════════════════════════════════════
+export function computeDurabilityScore(sessions) {
+    if (sessions.length === 0) {
+        return { composite: 0, completionStability: 0, rerunSavings: 0, artifactQuality: 0, memoryUsefulness: 0, driftResistance: 0, crossSessionContinuity: 0 };
+    }
+    // completionStability (25%): completion rate across all sessions (judge >= 2.0)
+    const completed = sessions.filter((s) => s.toolCallCount > 0 && s.judgeScore >= 2.0).length;
+    const completionStability = (completed / sessions.length) * 100;
+    // rerunSavings (20%): % of sessions with packet reuse (PRR)
+    const rerunSavings = computePRR(sessions);
+    // artifactQuality (20%): average judge score / 5.0 * 100
+    const avgJudge = sessions.reduce((a, s) => a + s.judgeScore, 0) / sessions.length;
+    const artifactQuality = (avgJudge / 5.0) * 100;
+    // memoryUsefulness (15%): RCA * (1 - staleMemoryPollutionRate)
+    const rca = computeRCA(sessions);
+    const drift = computeDriftMetrics(sessions);
+    const staleMemoryPollutionRate = 1 - drift.staleMemoryRejectionRate / 100;
+    const memoryUsefulness = (rca / 100) * (1 - staleMemoryPollutionRate) * 100;
+    // driftResistance (10%): perturbation survival rate
+    const driftResistance = drift.perturbationSurvivalRate;
+    // crossSessionContinuity (10%): % of multi-session users with context carryover
+    const userSessions = {};
+    for (const s of sessions) {
+        if (!userSessions[s.userId])
+            userSessions[s.userId] = [];
+        userSessions[s.userId].push(s);
+    }
+    const multiSessionUsers = Object.values(userSessions).filter((us) => us.length > 1);
+    let continuityCount = 0;
+    for (const us of multiSessionUsers) {
+        const laterSessions = us.filter((s) => s.sessionIndex > 1);
+        const hasCarryover = laterSessions.some((s) => !s.contextRestated);
+        if (hasCarryover)
+            continuityCount++;
+    }
+    const crossSessionContinuity = multiSessionUsers.length > 0
+        ? (continuityCount / multiSessionUsers.length) * 100
+        : 0;
+    // Weighted composite
+    const composite = Math.round(completionStability * 0.25 +
+        rerunSavings * 0.20 +
+        artifactQuality * 0.20 +
+        memoryUsefulness * 0.15 +
+        driftResistance * 0.10 +
+        crossSessionContinuity * 0.10);
+    return {
+        composite: Math.max(0, Math.min(100, composite)),
+        completionStability: Math.round(completionStability * 10) / 10,
+        rerunSavings: Math.round(rerunSavings * 10) / 10,
+        artifactQuality: Math.round(artifactQuality * 10) / 10,
+        memoryUsefulness: Math.round(memoryUsefulness * 10) / 10,
+        driftResistance: Math.round(driftResistance * 10) / 10,
+        crossSessionContinuity: Math.round(crossSessionContinuity * 10) / 10,
+    };
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Period Rollups
+// ═══════════════════════════════════════════════════════════════════════════
+export function computeRollup(sessions, period) {
+    const now = new Date();
+    const keyFn = (d) => {
+        switch (period) {
+            case "daily":
+                return d.toISOString().slice(0, 10); // 2026-03-24
+            case "weekly": {
+                const jan1 = new Date(d.getFullYear(), 0, 1);
+                const weekNum = Math.ceil(((d.getTime() - jan1.getTime()) / 86400000 + jan1.getDay() + 1) / 7);
+                return `${d.getFullYear()}-W${String(weekNum).padStart(2, "0")}`;
+            }
+            case "monthly":
+                return d.toISOString().slice(0, 7); // 2026-03
+        }
+    };
+    // For simulation, all sessions are "today" — group them under current period
+    const periodKey = keyFn(now);
+    if (sessions.length === 0)
+        return [];
+    const completedCount = sessions.filter((s) => s.toolCallCount > 0 && s.judgeScore >= 2.0).length;
+    const completionRate = (completedCount / sessions.length) * 100;
+    const avgJudgeScore = sessions.reduce((a, s) => a + s.judgeScore, 0) / sessions.length;
+    const rca = computeRCA(sessions);
+    const prr = computePRR(sessions);
+    const durability = computeDurabilityScore(sessions);
+    // Top failure mode
+    const errorCounts = {};
+    for (const s of sessions) {
+        for (const e of s.errors) {
+            const prefix = e.split(":")[0];
+            errorCounts[prefix] = (errorCounts[prefix] ?? 0) + 1;
+        }
+    }
+    const sorted = Object.entries(errorCounts).sort((a, b) => b[1] - a[1]);
+    const topFailureMode = sorted.length > 0 ? `${sorted[0][0]}(${sorted[0][1]})` : "none";
+    const rollup = {
+        period,
+        periodKey,
+        totalRuns: sessions.length,
+        completionRate: Math.round(completionRate * 10) / 10,
+        avgJudgeScore: Math.round(avgJudgeScore * 100) / 100,
+        rca: Math.round(rca * 10) / 10,
+        prr: Math.round(prr * 10) / 10,
+        durabilityScore: durability.composite,
+        topFailureMode,
+        createdAt: now.toISOString(),
+    };
+    // Persist
+    const db = getDb();
+    db.prepare(`
+    INSERT OR REPLACE INTO benchmark_rollups (period, periodKey, totalRuns, completionRate, avgJudgeScore, rca, prr, durabilityScore, topFailureMode, createdAt)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(rollup.period, rollup.periodKey, rollup.totalRuns, rollup.completionRate, rollup.avgJudgeScore, rollup.rca, rollup.prr, rollup.durabilityScore, rollup.topFailureMode, rollup.createdAt);
+    return [rollup];
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Maturity Levels
+// ═══════════════════════════════════════════════════════════════════════════
+export function computeMaturityLevel(scenarioId, sessions, batchId) {
+    const scenarioSessions = sessions.filter((s) => s.scenarioId === scenarioId);
+    const n = scenarioSessions.length;
+    const scores = scenarioSessions.map((s) => s.judgeScore);
+    const avg = n > 0 ? scores.reduce((a, b) => a + b, 0) / n : 0;
+    const variance = n > 1
+        ? scores.reduce((a, s) => a + Math.pow(s - avg, 2), 0) / (n - 1)
+        : 0;
+    const coeffVar = avg > 0 ? (Math.sqrt(variance) / avg) * 100 : 100;
+    const prr = computePRR(scenarioSessions);
+    const rca = computeRCA(scenarioSessions);
+    const drift = computeDriftMetrics(scenarioSessions);
+    const durability = computeDurabilityScore(scenarioSessions);
+    let level;
+    let label;
+    let evidence;
+    if (durability.composite > 85 && prr > 80 && rca > 90 && n >= 30) {
+        level = "E";
+        label = "institutional";
+        evidence = `PRR=${prr.toFixed(0)}% RCA=${rca.toFixed(0)}% durability=${durability.composite} n=${n} over 30+ sessions`;
+    }
+    else if (n >= 10 && drift.perturbationSurvivalRate > 80 && drift.driftRecoveryRate > 70) {
+        level = "D";
+        label = "durable";
+        evidence = `pertSurvival=${drift.perturbationSurvivalRate.toFixed(0)}% driftRecovery=${drift.driftRecoveryRate.toFixed(0)}% n=${n}`;
+    }
+    else if (n >= 10 && prr > 0 && drift.perturbationSurvivalRate > 80) {
+        level = "C";
+        label = "hardened";
+        evidence = `PRR=${prr.toFixed(0)}% pertSurvival=${drift.perturbationSurvivalRate.toFixed(0)}% n=${n}`;
+    }
+    else if (n >= 5 && coeffVar < 20) {
+        level = "B";
+        label = "stable";
+        evidence = `CV=${coeffVar.toFixed(1)}% avg=${avg.toFixed(2)} n=${n}`;
+    }
+    else if (n >= 1 && avg >= 2.0) {
+        level = "A";
+        label = "smoke-ready";
+        evidence = `avg=${avg.toFixed(2)} n=${n}`;
+    }
+    else {
+        level = "A";
+        label = "smoke-ready (marginal)";
+        evidence = `avg=${avg.toFixed(2)} n=${n} — below smoke threshold`;
+    }
+    // Persist
+    const db = getDb();
+    db.prepare(`
+    INSERT OR REPLACE INTO workflow_maturity (scenarioId, maturityLevel, label, evidence, batchId)
+    VALUES (?, ?, ?, ?, ?)
+  `).run(scenarioId, level, label, evidence, batchId);
+    return { level, label, scenarioId, evidence };
+}
+// ═══════════════════════════════════════════════════════════════════════════
 // N-level Runners
 // ═══════════════════════════════════════════════════════════════════════════
 /**
@@ -564,60 +982,95 @@ export async function runN5() {
     return report;
 }
 /**
- * N=10: 10 users x 1 session each OR 5 users x 2 sessions.
- * Tests session-continuity metrics.
+ * N=10: 5 users x 2 sessions. Sessions 6-10 receive perturbations.
+ * Tests session-continuity and drift resistance.
  */
 export async function runN10() {
     const batchId = genId("batch");
     const users = COHORT_USERS.slice(0, 5);
-    console.log(`\n=== N=10: Session Continuity — 5 users x 2 sessions ===\n`);
+    console.log(`\n=== N=10: Session Continuity + Perturbations — 5 users x 2 sessions ===\n`);
+    console.log(`  Sessions 1-5: clean baseline | Sessions 6-10: perturbed\n`);
     const sessions = [];
+    let globalIdx = 0;
     for (const user of users) {
         for (let sessionIdx = 1; sessionIdx <= 2; sessionIdx++) {
+            globalIdx++;
             const scenario = user.typicalScenarios[(sessionIdx - 1) % user.typicalScenarios.length];
             const horizon = sessionIdx === 1 ? "same_session" : "next_day";
-            const session = await simulateSession(user, scenario, sessionIdx, horizon, batchId, 10);
+            // Apply perturbation to sessions 6-10
+            const perturbation = globalIdx > 5 ? selectPerturbation(globalIdx) : undefined;
+            const session = await simulateSession(user, scenario, sessionIdx, horizon, batchId, 10, perturbation);
             sessions.push(session);
-            printSessionLine(session);
+            printSessionLine(session, perturbation);
         }
     }
     const report = generateCohortReport(sessions, 10, "n10");
+    const drift = computeDriftMetrics(sessions);
+    const durability = computeDurabilityScore(sessions);
+    const rollups = computeRollup(sessions, "daily");
+    // Compute maturity per scenario
+    const scenarios = [...new Set(sessions.map((s) => s.scenarioId))];
+    const maturityAssessments = scenarios.map((sc) => computeMaturityLevel(sc, sessions, batchId));
     printReport(report, "N=10");
+    printDurabilityReport(durability, drift);
+    printMaturityReport(maturityAssessments);
+    if (rollups.length > 0)
+        printRollupSummary(rollups);
     return report;
 }
 /**
  * N=100: 10 users x 10 sessions each (simulated across time horizons).
- * Measures RCA + PRR compounding over time.
+ * Sessions 1-20: clean baseline. Sessions 21-100: perturbed.
+ * Measures RCA + PRR compounding over time + drift durability.
  */
 export async function runN100() {
     const batchId = genId("batch");
     console.log(`\n=== N=100: Longitudinal Compounding — 10 users x 10 sessions ===\n`);
+    console.log(`  Sessions 1-20: clean baseline | Sessions 21-100: perturbed\n`);
     const sessions = [];
+    let globalIdx = 0;
     for (const user of COHORT_USERS) {
         for (let sessionIdx = 1; sessionIdx <= 10; sessionIdx++) {
+            globalIdx++;
             const scenario = user.typicalScenarios[(sessionIdx - 1) % user.typicalScenarios.length];
             // Spread sessions across time horizons to simulate real usage patterns
             const horizonIdx = Math.min(sessionIdx - 1, TIME_HORIZONS.length - 1);
             const horizon = TIME_HORIZONS[horizonIdx];
-            const session = await simulateSession(user, scenario, sessionIdx, horizon, batchId, 100);
+            // Apply perturbation to sessions 21-100
+            const perturbation = globalIdx > 20 ? selectPerturbation(globalIdx) : undefined;
+            const session = await simulateSession(user, scenario, sessionIdx, horizon, batchId, 100, perturbation);
             sessions.push(session);
-            printSessionLine(session);
+            printSessionLine(session, perturbation);
         }
     }
     const report = generateCohortReport(sessions, 100, "n100");
+    const drift = computeDriftMetrics(sessions);
+    const durability = computeDurabilityScore(sessions);
+    // Rollups for all periods
+    const dailyRollups = computeRollup(sessions, "daily");
+    const weeklyRollups = computeRollup(sessions, "weekly");
+    const monthlyRollups = computeRollup(sessions, "monthly");
+    // Compute maturity per scenario
+    const scenarios = [...new Set(sessions.map((s) => s.scenarioId))];
+    const maturityAssessments = scenarios.map((sc) => computeMaturityLevel(sc, sessions, batchId));
     printReport(report, "N=100");
+    printDurabilityReport(durability, drift);
+    printMaturityReport(maturityAssessments);
+    printRollupSummary([...dailyRollups, ...weeklyRollups, ...monthlyRollups]);
     return report;
 }
 // ═══════════════════════════════════════════════════════════════════════════
 // Output Formatting
 // ═══════════════════════════════════════════════════════════════════════════
-function printSessionLine(s) {
-    const status = s.errors.length === 0 ? "OK" : `ERR(${s.errors.length})`;
+function printSessionLine(s, perturbation) {
+    const realErrors = s.errors.filter((e) => !e.startsWith("perturbation:"));
+    const status = realErrors.length === 0 ? "OK" : `ERR(${realErrors.length})`;
     const reuse = s.packetReused ? "REUSE" : s.packetGenerated ? "NEW" : "NONE";
     const restated = s.contextRestated ? "RESTATED" : "FRESH";
+    const pertMarker = perturbation ? ` [PERTURB:${perturbation.type}/${perturbation.severity}]` : "";
     console.log(`  [${s.role.padEnd(10)}] sess=${s.sessionIndex} ${s.scenarioId.padEnd(18)} ` +
         `tools=${s.toolCallCount} ${s.latencyMs}ms judge=${s.judgeScore.toFixed(1)} ` +
-        `packet=${reuse} ctx=${restated} ${status}`);
+        `packet=${reuse} ctx=${restated} ${status}${pertMarker}`);
 }
 function printReport(report, label) {
     const passLabel = report.passed ? "PASS" : "FAIL";
@@ -644,6 +1097,51 @@ function printReport(report, label) {
 ╚══════════════════════════════════════════════════════════════╝
 `);
 }
+function printDurabilityReport(durability, drift) {
+    console.log(`
+╔══════════════════════════════════════════════════════════════╗
+║  DURABILITY SCORE                               ${String(durability.composite).padStart(3)}/100   ║
+╠══════════════════════════════════════════════════════════════╣
+║  Completion Stability (25%):    ${String(durability.completionStability).padStart(6)}%                ║
+║  Rerun Savings (20%):           ${String(durability.rerunSavings).padStart(6)}%                ║
+║  Artifact Quality (20%):        ${String(durability.artifactQuality).padStart(6)}%                ║
+║  Memory Usefulness (15%):       ${String(durability.memoryUsefulness).padStart(6)}%                ║
+║  Drift Resistance (10%):        ${String(durability.driftResistance).padStart(6)}%                ║
+║  Cross-Session Continuity (10%):${String(durability.crossSessionContinuity).padStart(6)}%                ║
+╠══════════════════════════════════════════════════════════════╣
+║  Drift Recovery Rate:           ${String(Math.round(drift.driftRecoveryRate * 10) / 10).padStart(6)}%                ║
+║  Perturbation Survival Rate:    ${String(Math.round(drift.perturbationSurvivalRate * 10) / 10).padStart(6)}%                ║
+║  Stale Memory Rejection Rate:   ${String(Math.round(drift.staleMemoryRejectionRate * 10) / 10).padStart(6)}%                ║
+╚══════════════════════════════════════════════════════════════╝
+`);
+}
+function printMaturityReport(assessments) {
+    console.log(`
+╔══════════════════════════════════════════════════════════════╗
+║  WORKFLOW MATURITY LEVELS                                    ║
+╠══════════════════════════════════════════════════════════════╣`);
+    for (const a of assessments) {
+        const line = `  Level ${a.level} (${a.label}) — ${a.scenarioId}`;
+        console.log(`║${line.padEnd(60)}║`);
+        console.log(`║    ${a.evidence.slice(0, 56).padEnd(56)}║`);
+    }
+    console.log(`╚══════════════════════════════════════════════════════════════╝
+`);
+}
+function printRollupSummary(rollups) {
+    console.log(`
+╔══════════════════════════════════════════════════════════════╗
+║  PERIOD ROLLUPS                                              ║
+╠══════════════════════════════════════════════════════════════╣`);
+    for (const r of rollups) {
+        const line = `  ${r.period.padEnd(8)} ${r.periodKey.padEnd(12)} runs=${String(r.totalRuns).padStart(4)} ` +
+            `comp=${r.completionRate.toFixed(0)}% judge=${r.avgJudgeScore.toFixed(1)} ` +
+            `dur=${r.durabilityScore}`;
+        console.log(`║${line.padEnd(60)}║`);
+    }
+    console.log(`╚══════════════════════════════════════════════════════════════╝
+`);
+}
 // ═══════════════════════════════════════════════════════════════════════════
 // CLI Entry Point
 // ═══════════════════════════════════════════════════════════════════════════