@lcv-ideas-software/cross-review 4.2.4 → 4.3.0

package/dist/src/core/reports.js

@@ -3,9 +3,107 @@ function valueOrDash(value) {
         return "-";
     return String(value);
 }
-function costText(session) {
-    const total = session.totals.cost.total_cost;
-    return total == null ? "unknown" : `$${total.toFixed(6)} ${session.totals.cost.currency}`;
+function moneyText(value, currency = "USD") {
+    return value == null ? "unknown" : `$${value.toFixed(6)} ${currency}`;
+}
+function moneyAmountText(value) {
+    return `$${value.toFixed(6)}`;
+}
+export function sessionCostBreakdown(session) {
+    const currency = session.totals.cost.currency ?? "USD";
+    let peerTotal = 0;
+    let peerSeen = false;
+    for (const round of session.rounds) {
+        for (const peer of round.peers) {
+            const value = peer.cost?.total_cost;
+            if (value == null || !Number.isFinite(value))
+                continue;
+            peerSeen = true;
+            peerTotal += value;
+        }
+    }
+    let generationTotal = 0;
+    let generationSeen = false;
+    for (const generation of session.generation_files ?? []) {
+        const value = generation.cost?.total_cost;
+        if (value == null || !Number.isFinite(value))
+            continue;
+        generationSeen = true;
+        generationTotal += value;
+    }
+    const total = session.totals.cost.total_cost ?? null;
+    return {
+        currency,
+        total,
+        peer_total: peerSeen ? peerTotal : null,
+        generation_total: generationSeen ? generationTotal : null,
+    };
+}
+function costSummaryLines(session) {
+    const breakdown = sessionCostBreakdown(session);
+    const lines = [
+        `- Cost: ${moneyText(breakdown.total, breakdown.currency)}`,
+        `- Peer call cost: ${moneyText(breakdown.peer_total, breakdown.currency)}`,
+        `- Generation cost: ${moneyText(breakdown.generation_total, breakdown.currency)}`,
+    ];
+    if (breakdown.total != null &&
+        breakdown.peer_total != null &&
+        breakdown.generation_total != null) {
+        lines.push(`- Cost reconciliation: ${moneyText(breakdown.total, breakdown.currency)} = ${moneyAmountText(breakdown.peer_total)} peer + ${moneyAmountText(breakdown.generation_total)} generation`);
+    }
+    return lines;
+}
+function evidenceChecklistLines(session) {
+    const checklist = session.evidence_checklist ?? [];
+    if (!checklist.length)
+        return [];
+    const counts = new Map();
+    for (const item of checklist) {
+        const status = item.status ?? "open";
+        counts.set(status, (counts.get(status) ?? 0) + 1);
+    }
+    const lines = ["## Evidence Checklist", ""];
+    for (const [status, count] of [...counts.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
+        lines.push(`- ${status}: ${count}`);
+    }
+    const notResurfaced = checklist.filter((item) => item.status === "not_resurfaced");
+    if (notResurfaced.length) {
+        lines.push("- not_resurfaced means the ask was not repeated; it is not proof that evidence was satisfied.");
+        for (const item of notResurfaced.slice(0, 10)) {
+            lines.push(`  - ${item.peer}/${item.id}: ${item.ask}`);
+        }
+    }
+    lines.push("");
+    return lines;
+}
+export function unresolvedEvidenceItems(session) {
+    return (session.evidence_checklist ?? []).filter((item) => {
+        const status = item.status ?? "open";
+        return status === "open" || status === "not_resurfaced";
+    });
+}
+function unresolvedEvidenceDispositionLines(session) {
+    const unresolved = unresolvedEvidenceItems(session);
+    if (!unresolved.length)
+        return [];
+    const lines = [
+        "## Unresolved Evidence Disposition",
+        "",
+        "- These items are not terminally satisfied, deferred, or rejected.",
+        "- `open` still requires a concrete response; `not_resurfaced` only means the peer did not repeat the ask in a later round.",
+        "- To close them explicitly, attach the requested evidence or use `session_evidence_checklist_update` with `satisfied`, `deferred`, or `rejected`.",
+        "",
+    ];
+    for (const item of unresolved.slice(0, 20)) {
+        const status = item.status ?? "open";
+        const chronic = item.round_count >= 3 ? " chronic" : "";
+        lines.push(`- ${status}${chronic} ${item.peer}/${item.id}: ${item.ask}`);
+    }
+    if (unresolved.length > 20) {
+        lines.push(`- ... ${unresolved.length - 20} additional unresolved item(s) omitted.`);
+    }
+    lines.push("");
+    return lines;
 }
 export function sessionReportMarkdown(session, events = []) {
     const latestRound = session.rounds.at(-1);
@@ -22,7 +120,7 @@ export function sessionReportMarkdown(session, events = []) {
         `- Outcome reason: ${valueOrDash(session.outcome_reason)}`,
         `- Health: ${valueOrDash(session.convergence_health?.state)} - ${valueOrDash(session.convergence_health?.detail)}`,
         `- Rounds: ${session.rounds.length}`,
-        `- Cost: ${costText(session)}`,
+        ...costSummaryLines(session),
         `- Total tokens: ${valueOrDash(session.totals.usage.total_tokens)}`,
         "",
         "## Task",
@@ -46,6 +144,8 @@ export function sessionReportMarkdown(session, events = []) {
         "## Peer Decisions",
         "",
     ];
+    lines.push(...evidenceChecklistLines(session));
+    lines.push(...unresolvedEvidenceDispositionLines(session));
     if (session.generation_files?.length) {
         lines.push("## Generations", "");
         for (const generation of session.generation_files) {

package/dist/src/core/reports.js.map

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

package/dist/src/core/session-store.d.ts

@@ -1,4 +1,4 @@
-import type { AppConfig, ConvergenceResult, ConvergenceScope, EvidenceChecklistItem, EvidenceChecklistStatus, EvidenceStatusHistoryEntry, GenerationResult, JudgmentPrecisionReport, PeerFailure, PeerId, PeerProbeResult, PeerResult, ReviewRound, ReviewStatus, RuntimeEvent, RuntimeMetrics, SessionDoctorReport, SessionEvent, SessionMeta, ShadowJudgmentRollup } from "./types.js";
+import type { AppConfig, ConvergenceResult, ConvergenceScope, EvidenceChecklistItem, EvidenceChecklistStatus, EvidenceStatusHistoryEntry, GenerationResult, JudgmentPrecisionReport, PeerFailure, PeerId, PeerProbeResult, PeerReliabilityReport, PeerResult, ReviewRound, ReviewStatus, RuntimeEvent, RuntimeMetrics, SessionDoctorReport, SessionEvent, SessionMeta, ShadowJudgmentRollup } from "./types.js";
 export declare const SWEEP_MIN_IDLE_MS: number;
 export declare class SessionStore {
     private readonly config;
@@ -25,6 +25,7 @@ export declare class SessionStore {
     readTextArtifact(sessionId: string, relativePath: string, maxChars: number): string;
     private peekNextSeq;
     private commitSeq;
+    private appendEventRecord;
     appendEvent(event: RuntimeEvent): Promise<void>;
     flushPendingEvents(): Promise<void>;
     readEvents(sessionId: string, sinceSeq?: number): SessionEvent[];
@@ -94,6 +95,7 @@ export declare class SessionStore {
     recoverInterruptedSessions(activeSessionIds?: Set<string>): Promise<SessionMeta[]>;
     aggregateShadowJudgments(sessionId?: string): ShadowJudgmentRollup;
     metrics(sessionId?: string): RuntimeMetrics;
+    peerReliabilityReport(sessionId?: string): PeerReliabilityReport;
     sessionDoctor(limit?: number, includeLegacy?: boolean, repair?: boolean): Promise<SessionDoctorReport>;
     computeJudgmentPrecisionReport(opts?: {
         peer?: PeerId | undefined;

package/dist/src/core/session-store.js

@@ -9,6 +9,45 @@ export const SWEEP_MIN_IDLE_MS = 24 * 60 * 60 * 1000;
 function now() {
     return new Date().toISOString();
 }
+function isStubSession(session) {
+    const peerCosts = session.rounds.flatMap((round) => round.peers.map((peer) => peer.cost));
+    const generationCosts = (session.generation_files ?? []).map((generation) => generation.cost);
+    const costs = [...peerCosts, ...generationCosts].filter(Boolean);
+    if (costs.length > 0)
+        return costs.every((cost) => cost?.source === "stub");
+    return session.capability_snapshot.some((probe) => probe.provider.startsWith("stub-") || probe.model.startsWith("stub-"));
+}
+function sessionPeerCostTotal(session) {
+    let total = 0;
+    let seen = false;
+    for (const round of session.rounds) {
+        for (const peer of round.peers) {
+            const value = peer.cost?.total_cost;
+            if (value == null || !Number.isFinite(value))
+                continue;
+            seen = true;
+            total += value;
+        }
+    }
+    return seen ? total : null;
+}
+function sessionGenerationCostTotal(session) {
+    let total = 0;
+    let seen = false;
+    for (const generation of session.generation_files ?? []) {
+        const value = generation.cost?.total_cost;
+        if (value == null || !Number.isFinite(value))
+            continue;
+        seen = true;
+        total += value;
+    }
+    return seen ? total : null;
+}
+function addNullableCost(a, b) {
+    if (a == null && b == null)
+        return null;
+    return (a ?? 0) + (b ?? 0);
+}
 // v2.4.0 / audit closure (P1.3): atomicWriteFile retry on Windows.
 // `fs.renameSync` in Win32 fails with EPERM/EACCES/EBUSY when the
 // destination is briefly held by another handle (AV scan, indexing,
@@ -392,6 +431,16 @@ export class SessionStore {
     commitSeq(sessionId, committed) {
         this.seqCache.set(sessionId, committed);
     }
+    appendEventRecord(event) {
+        const sessionId = event.session_id;
+        if (!sessionId)
+            return;
+        const file = this.eventsPath(sessionId);
+        fs.mkdirSync(path.dirname(file), { recursive: true });
+        const seq = this.peekNextSeq(sessionId, file);
+        fs.appendFileSync(file, `${JSON.stringify({ ...event, seq, ts: event.ts ?? now() })}\n`, "utf8");
+        this.commitSeq(sessionId, seq);
+    }
     // v4.1.0: durable event persistence. withSessionLock became async
     // with the proper-lockfile refactor; appendEvent awaits the lock so
     // callers that read events after persisting get the expected
@@ -405,13 +454,11 @@ export class SessionStore {
         const write = (async () => {
             try {
                 await this.withSessionLock(sessionId, () => {
-                    const file = this.eventsPath(sessionId);
-                    const seq = this.peekNextSeq(sessionId, file);
-                    fs.appendFileSync(file, `${JSON.stringify({ ...event, seq, ts: event.ts ?? now() })}\n`, "utf8");
                     // Only commit the cache AFTER the durable append succeeded.
-                    // If appendFileSync threw above, the cache still reflects the
-                    // last persisted seq and the next call reuses this seq number.
-                    this.commitSeq(sessionId, seq);
+                    // If appendFileSync threw inside appendEventRecord, the cache
+                    // still reflects the last persisted seq and the next call
+                    // reuses this seq number.
+                    this.appendEventRecord(event);
                 });
             }
             catch {
@@ -730,13 +777,26 @@ export class SessionStore {
             if (reason)
                 meta.outcome_reason = reason;
             delete meta.in_flight;
+            const ts = now();
             meta.convergence_health = {
                 state: outcome === "converged" ? "converged" : outcome === "max-rounds" ? "blocked" : "stale",
-                last_event_at: now(),
+                last_event_at: ts,
                 detail: reason ?? outcome,
             };
-            meta.updated_at = now();
+            meta.updated_at = ts;
             await writeJson(this.metaPath(sessionId), meta);
+            try {
+                this.appendEventRecord({
+                    type: "session.finalized",
+                    session_id: sessionId,
+                    ts,
+                    message: `Session finalized as ${outcome}${reason ? `: ${reason}` : ""}`,
+                    data: { outcome, reason: reason ?? null },
+                });
+            }
+            catch {
+                /* event persistence is best-effort; session_doctor will flag gaps */
+            }
             return meta;
         });
     }
@@ -763,6 +823,7 @@ export class SessionStore {
     async markCancelled(sessionId, reason = "cancelled") {
         return this.withSessionLock(sessionId, async () => {
             const meta = this.read(sessionId);
+            const ts = now();
             meta.outcome = "aborted";
             meta.outcome_reason = reason;
             delete meta.in_flight;
@@ -771,15 +832,27 @@ export class SessionStore {
                 reason,
                 job_id: meta.control?.job_id,
                 requested_at: meta.control?.requested_at,
-                updated_at: now(),
+                updated_at: ts,
             };
             meta.convergence_health = {
                 state: "stale",
-                last_event_at: now(),
+                last_event_at: ts,
                 detail: reason,
             };
-            meta.updated_at = now();
+            meta.updated_at = ts;
             await writeJson(this.metaPath(sessionId), meta);
+            try {
+                this.appendEventRecord({
+                    type: "session.cancelled",
+                    session_id: sessionId,
+                    ts,
+                    message: `Session cancelled: ${reason}`,
+                    data: { outcome: "aborted", reason },
+                });
+            }
+            catch {
+                /* event persistence is best-effort; session_doctor will flag gaps */
+            }
             return meta;
         });
     }
@@ -1274,6 +1347,147 @@ export class SessionStore {
             shadow_judgment: this.aggregateShadowJudgments(sessionId),
         };
     }
+    peerReliabilityReport(sessionId) {
+        const sessions = sessionId ? [this.read(sessionId)] : this.list();
+        const peerSet = new Set(PEERS);
+        const byPeer = {};
+        const acc = (peer) => {
+            let entry = byPeer[peer];
+            if (!entry) {
+                entry = {
+                    peer,
+                    session_ids: new Set(),
+                    results_total: 0,
+                    ready: 0,
+                    not_ready: 0,
+                    needs_evidence: 0,
+                    unresolved_status: 0,
+                    parser_warnings_total: 0,
+                    parser_warnings_by_type: {},
+                    decision_quality: {},
+                    rejected_total: 0,
+                    provider_errors: 0,
+                    failures_by_class: {},
+                    open_asks: 0,
+                    not_resurfaced_asks: 0,
+                    addressed_asks: 0,
+                    satisfied_asks: 0,
+                    deferred_asks: 0,
+                    rejected_asks: 0,
+                    fabrication_events: 0,
+                    latency_sum: 0,
+                    latency_count: 0,
+                    cost_sum: 0,
+                    cost_count: 0,
+                };
+                byPeer[peer] = entry;
+            }
+            return entry;
+        };
+        for (const session of sessions) {
+            for (const round of session.rounds) {
+                for (const peerResult of round.peers) {
+                    const entry = acc(peerResult.peer);
+                    entry.session_ids.add(session.session_id);
+                    entry.results_total += 1;
+                    if (peerResult.status === "READY")
+                        entry.ready += 1;
+                    else if (peerResult.status === "NOT_READY")
+                        entry.not_ready += 1;
+                    else if (peerResult.status === "NEEDS_EVIDENCE")
+                        entry.needs_evidence += 1;
+                    else
+                        entry.unresolved_status += 1;
+                    const quality = peerResult.decision_quality ?? "failed";
+                    entry.decision_quality[quality] = (entry.decision_quality[quality] ?? 0) + 1;
+                    for (const warning of peerResult.parser_warnings) {
+                        entry.parser_warnings_total += 1;
+                        entry.parser_warnings_by_type[warning] =
+                            (entry.parser_warnings_by_type[warning] ?? 0) + 1;
+                    }
+                    if (Number.isFinite(peerResult.latency_ms)) {
+                        entry.latency_sum += peerResult.latency_ms;
+                        entry.latency_count += 1;
+                    }
+                    if (peerResult.cost?.total_cost != null &&
+                        Number.isFinite(peerResult.cost.total_cost) &&
+                        peerResult.cost.source !== "stub") {
+                        entry.cost_sum += peerResult.cost.total_cost;
+                        entry.cost_count += 1;
+                    }
+                }
+                for (const failure of round.rejected) {
+                    const entry = acc(failure.peer);
+                    entry.session_ids.add(session.session_id);
+                    entry.rejected_total += 1;
+                    if (failure.failure_class === "provider_error")
+                        entry.provider_errors += 1;
+                    entry.failures_by_class[failure.failure_class] =
+                        (entry.failures_by_class[failure.failure_class] ?? 0) + 1;
+                }
+            }
+            for (const item of session.evidence_checklist ?? []) {
+                const entry = acc(item.peer);
+                entry.session_ids.add(session.session_id);
+                const status = item.status ?? "open";
+                if (status === "open")
+                    entry.open_asks += 1;
+                else if (status === "not_resurfaced")
+                    entry.not_resurfaced_asks += 1;
+                else if (status === "addressed")
+                    entry.addressed_asks += 1;
+                else if (status === "satisfied")
+                    entry.satisfied_asks += 1;
+                else if (status === "deferred")
+                    entry.deferred_asks += 1;
+                else if (status === "rejected")
+                    entry.rejected_asks += 1;
+            }
+            for (const event of this.readEvents(session.session_id)) {
+                if (!event.type.includes("fabrication"))
+                    continue;
+                const dataPeer = (event.data?.peer ?? event.peer);
+                if (!dataPeer || !peerSet.has(dataPeer))
+                    continue;
+                const entry = acc(dataPeer);
+                entry.session_ids.add(session.session_id);
+                entry.fabrication_events += 1;
+            }
+        }
+        const reportByPeer = {};
+        for (const [peer, entry] of Object.entries(byPeer)) {
+            reportByPeer[peer] = {
+                peer,
+                sessions_seen: entry.session_ids.size,
+                results_total: entry.results_total,
+                ready: entry.ready,
+                not_ready: entry.not_ready,
+                needs_evidence: entry.needs_evidence,
+                unresolved_status: entry.unresolved_status,
+                parser_warnings_total: entry.parser_warnings_total,
+                parser_warnings_by_type: entry.parser_warnings_by_type,
+                decision_quality: entry.decision_quality,
+                rejected_total: entry.rejected_total,
+                provider_errors: entry.provider_errors,
+                failures_by_class: entry.failures_by_class,
+                open_asks: entry.open_asks,
+                not_resurfaced_asks: entry.not_resurfaced_asks,
+                addressed_asks: entry.addressed_asks,
+                satisfied_asks: entry.satisfied_asks,
+                deferred_asks: entry.deferred_asks,
+                rejected_asks: entry.rejected_asks,
+                fabrication_events: entry.fabrication_events,
+                avg_latency_ms: entry.latency_count > 0 ? entry.latency_sum / entry.latency_count : null,
+                total_cost_usd: entry.cost_count > 0 ? entry.cost_sum : null,
+            };
+        }
+        return {
+            generated_at: now(),
+            scope: sessionId ? "session" : "all",
+            session_id: sessionId,
+            by_peer: reportByPeer,
+        };
+    }
     // v2.16.0: read-only operational doctor. This is intentionally a
     // reporting surface, not a cleanup tool: it never finalizes, rewrites
     // or deletes sessions. Operators use it after audits to see which
@@ -1349,11 +1563,19 @@ export class SessionStore {
         const maxRoundsSessions = [];
         const selfLeadMetadata = [];
         const openEvidenceSessions = [];
+        const notResurfacedEvidenceSessions = [];
         const grokProviderErrorSessions = [];
         const eventReadErrorSessions = [];
+        const terminalEventMissingSessions = [];
         let eventsTotal = 0;
         let tokenDeltaEvents = 0;
         let tokenCompletedEvents = 0;
+        let realSessions = 0;
+        let stubSessions = 0;
+        let peerCallCostUsd = null;
+        let generationCostUsd = null;
+        let totalCostUsd = null;
+        let terminalEventMissingCount = 0;
         const pushLimited = (target, entry) => {
             if (target.length < cappedLimit)
                 target.push(entry);
@@ -1365,7 +1587,18 @@ export class SessionStore {
             const evidenceList = session.evidence_checklist ?? [];
             const openEvidenceItemsList = evidenceList.filter((item) => (item.status ?? "open") === "open");
             const openEvidenceItems = openEvidenceItemsList.length;
+            const notResurfacedEvidenceItems = evidenceList.filter((item) => item.status === "not_resurfaced").length;
             const grokProviderErrors = (session.failed_attempts ?? []).filter((failure) => failure.peer === "grok" && failure.failure_class === "provider_error").length;
+            if (isStubSession(session))
+                stubSessions += 1;
+            else
+                realSessions += 1;
+            peerCallCostUsd = addNullableCost(peerCallCostUsd, sessionPeerCostTotal(session));
+            generationCostUsd = addNullableCost(generationCostUsd, sessionGenerationCostTotal(session));
+            const sessionTotalCost = session.totals.cost.total_cost;
+            if (sessionTotalCost != null && Number.isFinite(sessionTotalCost)) {
+                totalCostUsd = addNullableCost(totalCostUsd, sessionTotalCost);
+            }
             const entry = {
                 session_id: session.session_id,
                 version: session.version,
@@ -1379,6 +1612,9 @@ export class SessionStore {
                 rounds: session.rounds.length,
                 updated_at: session.updated_at,
                 ...(openEvidenceItems > 0 ? { open_evidence_items: openEvidenceItems } : {}),
+                ...(notResurfacedEvidenceItems > 0
+                    ? { not_resurfaced_evidence_items: notResurfacedEvidenceItems }
+                    : {}),
                 ...(grokProviderErrors > 0 ? { grok_provider_errors: grokProviderErrors } : {}),
             };
             // v2.22.0 (B.P2): drill-down for open-evidence entries. Aggregate
@@ -1419,6 +1655,8 @@ export class SessionStore {
                 pushLimited(selfLeadMetadata, entry);
             if (openEvidenceItems > 0)
                 pushLimited(openEvidenceSessions, entry);
+            if (notResurfacedEvidenceItems > 0)
+                pushLimited(notResurfacedEvidenceSessions, entry);
             if (grokProviderErrors > 0)
                 pushLimited(grokProviderErrorSessions, entry);
             let sessionEvents = [];
@@ -1429,6 +1667,18 @@ export class SessionStore {
                 entry.event_read_error = redact(error instanceof Error ? error.message : String(error));
                 pushLimited(eventReadErrorSessions, entry);
             }
+            if (session.outcome) {
+                const expectedTerminalEvent = session.control?.status === "cancelled" || session.outcome_reason === "session_cancelled"
+                    ? "session.cancelled"
+                    : "session.finalized";
+                const hasExpectedTerminalEvent = sessionEvents.some((event) => event.type === expectedTerminalEvent);
+                if (!hasExpectedTerminalEvent) {
+                    terminalEventMissingCount += 1;
+                    entry.terminal_event_missing = true;
+                    entry.terminal_event_expected = expectedTerminalEvent;
+                    pushLimited(terminalEventMissingSessions, entry);
+                }
+            }
             for (const event of sessionEvents) {
                 eventsTotal += 1;
                 if (event.type === "peer.token.delta")
@@ -1464,6 +1714,9 @@ export class SessionStore {
         if (openEvidenceSessions.length > 0) {
             recommendations.push("Address or explicitly terminal-mark open evidence checklist items before expecting convergence.");
         }
+        if (notResurfacedEvidenceSessions.length > 0) {
+            recommendations.push("`not_resurfaced` evidence items are inference-only; review them separately from satisfied/deferred/rejected items.");
+        }
         if (grokProviderErrorSessions.length > 0) {
             recommendations.push("Run a Grok-specific smoke/probe for sessions with grok provider errors before relying on Grok in release gates.");
         }
@@ -1473,21 +1726,32 @@ export class SessionStore {
         if (eventsTotal > 0 && tokenDeltaEvents / eventsTotal > 0.5) {
             recommendations.push("Token delta events dominate this corpus; increase CROSS_REVIEW_TOKEN_DELTA_CHARS_THRESHOLD or disable token streaming for low-noise audits.");
         }
+        if (terminalEventMissingCount > 0) {
+            recommendations.push("Terminal outcome metadata exists without matching terminal events; treat as legacy/event-gap evidence and inspect before relying on event-only analytics.");
+        }
         return {
             generated_at: now(),
             scope: "all",
             limit: cappedLimit,
             totals: {
                 sessions: sessions.length,
+                real_sessions: realSessions,
+                stub_sessions: stubSessions,
                 open: sessions.filter((session) => !session.outcome).length,
-                stale: sessions.filter((session) => session.convergence_health?.state === "stale").length,
-                blocked: sessions.filter((session) => session.convergence_health?.state === "blocked")
-                    .length,
+                stale: sessions.filter((session) => !session.outcome && session.convergence_health?.state === "stale").length,
+                blocked: sessions.filter((session) => !session.outcome && session.convergence_health?.state === "blocked").length,
                 max_rounds: sessions.filter((session) => session.outcome === "max-rounds").length,
                 self_lead_metadata: selfLeadCount,
                 open_evidence_sessions: sessions.filter((session) => (session.evidence_checklist ?? []).some((item) => (item.status ?? "open") === "open")).length,
+                not_resurfaced_evidence_sessions: sessions.filter((session) => (session.evidence_checklist ?? []).some((item) => item.status === "not_resurfaced")).length,
                 grok_provider_error_sessions: sessions.filter((session) => (session.failed_attempts ?? []).some((failure) => failure.peer === "grok" && failure.failure_class === "provider_error")).length,
                 event_read_error_sessions: eventReadErrorSessions.length,
+                terminal_event_missing_sessions: terminalEventMissingCount,
+            },
+            cost_breakdown: {
+                total_cost_usd: totalCostUsd,
+                peer_call_cost_usd: peerCallCostUsd,
+                generation_cost_usd: generationCostUsd,
             },
             findings: {
                 open_sessions: openSessions,
@@ -1499,8 +1763,10 @@ export class SessionStore {
                 // in `totals.self_lead_metadata`.
                 self_lead_metadata: includeLegacy ? selfLeadMetadata : [],
                 open_evidence_sessions: openEvidenceSessions,
+                not_resurfaced_evidence_sessions: notResurfacedEvidenceSessions,
                 grok_provider_error_sessions: grokProviderErrorSessions,
                 event_read_error_sessions: eventReadErrorSessions,
+                terminal_event_missing_sessions: terminalEventMissingSessions,
             },
             event_noise: {
                 events_total: eventsTotal,
@@ -1793,17 +2059,30 @@ export class SessionStore {
                 continue;
             const finalized = await this.withSessionLock(session.session_id, async () => {
                 const current = this.read(session.session_id);
+                const ts = now();
                 current.outcome = outcome;
                 current.outcome_reason = reason;
                 delete current.in_flight;
                 current.convergence_health = {
                     state: "stale",
-                    last_event_at: now(),
+                    last_event_at: ts,
                     detail: reason,
                     idle_ms: idleFor,
                 };
-                current.updated_at = now();
+                current.updated_at = ts;
                 await writeJson(this.metaPath(session.session_id), current);
+                try {
+                    this.appendEventRecord({
+                        type: "session.finalized",
+                        session_id: session.session_id,
+                        ts,
+                        message: `Session finalized as ${outcome}${reason ? `: ${reason}` : ""}`,
+                        data: { outcome, reason, idle_ms: idleFor },
+                    });
+                }
+                catch {
+                    /* event persistence is best-effort; session_doctor will flag gaps */
+                }
                 return current;
             });
             swept.push(finalized);