agentxchain 2.45.0 → 2.46.2

package/src/lib/report.js

@@ -78,6 +78,10 @@ function extractHistoryTimeline(artifact) {
       phase: e.phase || null,
       phase_transition: e.phase_transition_request || null,
       files_changed_count: Array.isArray(e.files_changed) ? e.files_changed.length : 0,
+      concurrent_with: Array.isArray(e.concurrent_with) && e.concurrent_with.length > 0 ? e.concurrent_with : undefined,
+      sibling_attributed_files: Array.isArray(e.observed_artifact?.attributed_to_concurrent_siblings) && e.observed_artifact.attributed_to_concurrent_siblings.length > 0
+        ? e.observed_artifact.attributed_to_concurrent_siblings
+        : undefined,
       decisions: Array.isArray(e.decisions) ? e.decisions.map((d) => d?.id || d).filter(Boolean) : [],
       objections: Array.isArray(e.objections) ? e.objections.map((o) => o?.id || o).filter(Boolean) : [],
       cost_usd: typeof e.cost?.total_usd === 'number' ? e.cost.total_usd : null,
@@ -99,6 +103,61 @@ function extractDecisionDigest(artifact) {
     }));
 }
 
+function extractApprovalPolicyDigest(artifact) {
+  const data = extractFileData(artifact, '.agentxchain/decision-ledger.jsonl');
+  if (!Array.isArray(data) || data.length === 0) return [];
+  return data
+    .filter((d) => d?.type === 'approval_policy')
+    .map((d) => ({
+      gate_type: d.gate_type || null,
+      action: d.action || null,
+      matched_rule: d.matched_rule || null,
+      from_phase: d.from_phase || null,
+      to_phase: d.to_phase || null,
+      reason: d.reason || '',
+      gate_id: d.gate_id || null,
+      timestamp: d.timestamp || null,
+    }));
+}
+
+function extractGateFailureDigest(artifact) {
+  const data = extractFileData(artifact, '.agentxchain/decision-ledger.jsonl');
+  if (!Array.isArray(data) || data.length === 0) return [];
+  return data
+    .filter((d) => d?.type === 'gate_failure')
+    .map((d) => ({
+      gate_type: d.gate_type || null,
+      gate_id: d.gate_id || null,
+      phase: d.phase || null,
+      from_phase: d.from_phase || null,
+      to_phase: d.to_phase || null,
+      requested_by_turn: d.requested_by_turn || null,
+      failed_at: d.failed_at || null,
+      queued_request: d.queued_request === true,
+      reasons: Array.isArray(d.reasons) ? d.reasons : [],
+      missing_files: Array.isArray(d.missing_files) ? d.missing_files : [],
+      missing_verification: d.missing_verification === true,
+    }));
+}
+
+function extractTimeoutEventDigest(artifact, relPath = '.agentxchain/decision-ledger.jsonl') {
+  const data = extractFileData(artifact, relPath);
+  if (!Array.isArray(data) || data.length === 0) return [];
+  return data
+    .filter((d) => typeof d?.type === 'string' && d.type.startsWith('timeout'))
+    .map((d) => ({
+      type: d.type,
+      scope: d.scope || null,
+      phase: d.phase || null,
+      turn_id: d.turn_id || null,
+      limit_minutes: typeof d.limit_minutes === 'number' ? d.limit_minutes : null,
+      elapsed_minutes: typeof d.elapsed_minutes === 'number' ? d.elapsed_minutes : null,
+      exceeded_by_minutes: typeof d.exceeded_by_minutes === 'number' ? d.exceeded_by_minutes : null,
+      action: d.action || null,
+      timestamp: d.timestamp || null,
+    }));
+}
+
 function extractHookSummary(artifact) {
   const data = extractFileData(artifact, '.agentxchain/hook-audit.jsonl');
   if (!Array.isArray(data) || data.length === 0) return null;
@@ -408,6 +467,23 @@ function extractCoordinatorDecisionDigest(artifact) {
     }));
 }
 
+function extractCoordinatorApprovalPolicyDigest(artifact) {
+  const data = extractFileData(artifact, '.agentxchain/multirepo/decision-ledger.jsonl');
+  if (!Array.isArray(data) || data.length === 0) return [];
+  return data
+    .filter((d) => d?.type === 'approval_policy')
+    .map((d) => ({
+      gate_type: d.gate_type || null,
+      action: d.action || null,
+      matched_rule: d.matched_rule || null,
+      from_phase: d.from_phase || null,
+      to_phase: d.to_phase || null,
+      reason: d.reason || '',
+      gate_id: d.gate_id || null,
+      timestamp: d.timestamp || null,
+    }));
+}
+
 function extractBarrierSummary(artifact) {
   const data = extractFileData(artifact, '.agentxchain/multirepo/barriers.json');
   if (!data || typeof data !== 'object' || Array.isArray(data)) return [];
@@ -538,6 +614,9 @@ function buildRunSubject(artifact) {
 
   const turns = extractHistoryTimeline(artifact);
   const decisions = extractDecisionDigest(artifact);
+  const approvalPolicyEvents = extractApprovalPolicyDigest(artifact);
+  const gateFailures = extractGateFailureDigest(artifact);
+  const timeoutEvents = extractTimeoutEventDigest(artifact);
   const hookSummary = extractHookSummary(artifact);
   const timing = computeTiming(artifact, turns);
   const gateSummary = extractGateSummary(artifact);
@@ -571,6 +650,9 @@ function buildRunSubject(artifact) {
       duration_seconds: timing.duration_seconds,
       turns,
       decisions,
+      approval_policy_events: approvalPolicyEvents,
+      gate_failures: gateFailures,
+      timeout_events: timeoutEvents,
       hook_summary: hookSummary,
       gate_summary: gateSummary,
       intake_links: intakeLinks,
@@ -643,6 +725,9 @@ function buildCoordinatorSubject(artifact) {
       const childExport = repoEntry.export;
       base.turns = extractHistoryTimeline(childExport);
       base.decisions = extractDecisionDigest(childExport);
+      base.approval_policy_events = extractApprovalPolicyDigest(childExport);
+      base.gate_failures = extractGateFailureDigest(childExport);
+      base.timeout_events = extractTimeoutEventDigest(childExport);
       base.hook_summary = extractHookSummary(childExport);
       base.gate_summary = extractGateSummary(childExport);
       base.recovery_summary = extractRecoverySummary(childExport);
@@ -656,6 +741,8 @@ function buildCoordinatorSubject(artifact) {
   const barrierSummary = extractBarrierSummary(artifact);
   const barrierLedgerTimeline = extractBarrierLedgerTimeline(artifact);
   const decisionDigest = extractCoordinatorDecisionDigest(artifact);
+  const coordinatorApprovalPolicyEvents = extractCoordinatorApprovalPolicyDigest(artifact);
+  const coordinatorTimeoutEvents = extractTimeoutEventDigest(artifact, '.agentxchain/multirepo/decision-ledger.jsonl');
   const timing = computeCoordinatorTiming(artifact, coordinatorTimeline);
   const blockedReason = normalizeCoordinatorBlockedReason(coordinatorState.blocked_reason);
   const pendingGate = normalizePendingGate(coordinatorState.pending_gate);
@@ -698,6 +785,8 @@ function buildCoordinatorSubject(artifact) {
     barrier_summary: barrierSummary,
     barrier_ledger_timeline: barrierLedgerTimeline,
     decision_digest: decisionDigest,
+    approval_policy_events: coordinatorApprovalPolicyEvents,
+    timeout_events: coordinatorTimeoutEvents,
     recovery_report: extractRecoveryReportSummary(artifact),
     repos,
     artifacts: {
@@ -828,7 +917,8 @@ export function formatGovernanceReportText(report) {
         const t = run.turns[i];
         const cost = t.cost_usd != null ? formatUsd(t.cost_usd) : 'n/a';
         const phase = t.phase_transition ? `${t.phase || '?'} -> ${t.phase_transition}` : (t.phase || '?');
-        lines.push(`  ${i + 1}. [${t.role}] ${t.summary || '(no summary)'} | phase: ${phase} | files: ${t.files_changed_count} | cost: ${cost} | ${t.accepted_at || 'n/a'}`);
+        const siblingNote = Array.isArray(t.sibling_attributed_files) ? ` (${t.sibling_attributed_files.length} sibling-attributed)` : '';
+        lines.push(`  ${i + 1}. [${t.role}] ${t.summary || '(no summary)'} | phase: ${phase} | files: ${t.files_changed_count}${siblingNote} | cost: ${cost} | ${t.accepted_at || 'n/a'}`);
       }
     }
 
@@ -846,6 +936,46 @@ export function formatGovernanceReportText(report) {
       }
     }
 
+    if (run.gate_failures && run.gate_failures.length > 0) {
+      lines.push('', 'Gate Failures:');
+      for (const failure of run.gate_failures) {
+        const request = failure.gate_type === 'run_completion'
+          ? 'run completion'
+          : `${failure.from_phase || failure.phase || '?'} -> ${failure.to_phase || '?'}`;
+        const source = failure.queued_request ? 'queued drain' : 'direct';
+        lines.push(`  - ${failure.gate_id || 'unknown'} | ${failure.gate_type || 'unknown'} | request: ${request} | source: ${source} | at: ${failure.failed_at || 'n/a'}`);
+        for (const reason of failure.reasons || []) {
+          lines.push(`      reason: ${reason}`);
+        }
+      }
+    }
+
+    if (run.approval_policy_events && run.approval_policy_events.length > 0) {
+      lines.push('', 'Approval Policy:');
+      for (const evt of run.approval_policy_events) {
+        const transition = evt.gate_type === 'run_completion'
+          ? 'run completion'
+          : `${evt.from_phase || '?'} -> ${evt.to_phase || '?'}`;
+        const rule = evt.matched_rule ? ` | rule: ${typeof evt.matched_rule === 'object' ? JSON.stringify(evt.matched_rule) : evt.matched_rule}` : '';
+        lines.push(`  - ${evt.action || 'unknown'} | ${evt.gate_type || 'unknown'} | ${transition}${rule} | at: ${evt.timestamp || 'n/a'}`);
+        if (evt.reason) lines.push(`      reason: ${evt.reason}`);
+      }
+    }
+
+    if (run.timeout_events && run.timeout_events.length > 0) {
+      lines.push('', 'Timeout Events:');
+      for (const evt of run.timeout_events) {
+        const label = evt.type === 'timeout_warning' ? 'warning'
+          : evt.type === 'timeout_skip' ? 'skip'
+          : evt.type === 'timeout_skip_failed' ? 'skip failed'
+          : 'escalation';
+        const elapsed = evt.elapsed_minutes != null ? `${evt.elapsed_minutes}m` : '?';
+        const limit = evt.limit_minutes != null ? `${evt.limit_minutes}m` : '?';
+        const exceeded = evt.exceeded_by_minutes != null ? `+${evt.exceeded_by_minutes}m` : '';
+        lines.push(`  - ${label} | ${evt.scope || '?'} scope | ${elapsed}/${limit}${exceeded ? ` (${exceeded})` : ''} | action: ${evt.action || 'n/a'} | phase: ${evt.phase || 'n/a'} | at: ${evt.timestamp || 'n/a'}`);
+      }
+    }
+
     if (run.intake_links && run.intake_links.length > 0) {
       lines.push('', 'Intake Linkage:');
       for (const intake of run.intake_links) {
@@ -896,7 +1026,19 @@ export function formatGovernanceReportText(report) {
     return lines.join('\n');
   }
 
-  const { coordinator, run, artifacts, repos, coordinator_timeline, barrier_summary, barrier_ledger_timeline, decision_digest, recovery_report } = report.subject;
+  const {
+    coordinator,
+    run,
+    artifacts,
+    repos,
+    coordinator_timeline,
+    barrier_summary,
+    barrier_ledger_timeline,
+    decision_digest,
+    approval_policy_events,
+    timeout_events,
+    recovery_report,
+  } = report.subject;
   const lines = [
     'AgentXchain Governance Report',
     `Input: ${report.input}`,
@@ -979,6 +1121,32 @@ export function formatGovernanceReportText(report) {
     }
   }
 
+  if (approval_policy_events && approval_policy_events.length > 0) {
+    lines.push('', 'Approval Policy:');
+    for (const evt of approval_policy_events) {
+      const transition = evt.gate_type === 'run_completion'
+        ? 'run completion'
+        : `${evt.from_phase || '?'} -> ${evt.to_phase || '?'}`;
+      const rule = evt.matched_rule ? ` | rule: ${typeof evt.matched_rule === 'object' ? JSON.stringify(evt.matched_rule) : evt.matched_rule}` : '';
+      lines.push(`  - ${evt.action || 'unknown'} | ${evt.gate_type || 'unknown'} | ${transition}${rule} | at: ${evt.timestamp || 'n/a'}`);
+      if (evt.reason) lines.push(`      reason: ${evt.reason}`);
+    }
+  }
+
+  if (timeout_events && timeout_events.length > 0) {
+    lines.push('', 'Timeout Events:');
+    for (const evt of timeout_events) {
+      const label = evt.type === 'timeout_warning' ? 'warning'
+        : evt.type === 'timeout_skip' ? 'skip'
+        : evt.type === 'timeout_skip_failed' ? 'skip failed'
+        : 'escalation';
+      const elapsed = evt.elapsed_minutes != null ? `${evt.elapsed_minutes}m` : '?';
+      const limit = evt.limit_minutes != null ? `${evt.limit_minutes}m` : '?';
+      const exceeded = evt.exceeded_by_minutes != null ? `+${evt.exceeded_by_minutes}m` : '';
+      lines.push(`  - ${label} | ${evt.scope || '?'} scope | ${elapsed}/${limit}${exceeded ? ` (${exceeded})` : ''} | action: ${evt.action || 'n/a'} | phase: ${evt.phase || 'n/a'} | at: ${evt.timestamp || 'n/a'}`);
+    }
+  }
+
   if (recovery_report) {
     lines.push('', 'Recovery Report:');
     lines.push(`  Trigger: ${recovery_report.trigger || 'n/a'}`);
@@ -1003,7 +1171,8 @@ export function formatGovernanceReportText(report) {
           const t = repo.turns[i];
           const cost = t.cost_usd != null ? formatUsd(t.cost_usd) : 'n/a';
           const phase = t.phase_transition ? `${t.phase || '?'} -> ${t.phase_transition}` : (t.phase || '?');
-          repoLines.push(`    ${i + 1}. [${t.role}] ${t.summary || '(no summary)'} | phase: ${phase} | files: ${t.files_changed_count} | cost: ${cost} | ${t.accepted_at || 'n/a'}`);
+          const siblingNote = Array.isArray(t.sibling_attributed_files) ? ` (${t.sibling_attributed_files.length} sibling-attributed)` : '';
+          repoLines.push(`    ${i + 1}. [${t.role}] ${t.summary || '(no summary)'} | phase: ${phase} | files: ${t.files_changed_count}${siblingNote} | cost: ${cost} | ${t.accepted_at || 'n/a'}`);
         }
       }
       if (repo.decisions && repo.decisions.length > 0) {
@@ -1018,6 +1187,39 @@ export function formatGovernanceReportText(report) {
           repoLines.push(`    - ${gate.gate_id}: ${gate.status}`);
         }
       }
+      if (repo.gate_failures && repo.gate_failures.length > 0) {
+        repoLines.push('  Gate Failures:');
+        for (const failure of repo.gate_failures) {
+          const request = failure.gate_type === 'run_completion'
+            ? 'run completion'
+            : `${failure.from_phase || failure.phase || '?'} -> ${failure.to_phase || '?'}`;
+          repoLines.push(`    - ${failure.gate_id || 'unknown'}: ${failure.gate_type || 'unknown'} | ${request} | ${failure.queued_request ? 'queued drain' : 'direct'} | ${failure.failed_at || 'n/a'}`);
+          for (const reason of failure.reasons || []) {
+            repoLines.push(`      reason: ${reason}`);
+          }
+        }
+      }
+      if (repo.approval_policy_events && repo.approval_policy_events.length > 0) {
+        repoLines.push('  Approval Policy:');
+        for (const evt of repo.approval_policy_events) {
+          const transition = evt.gate_type === 'run_completion'
+            ? 'run completion'
+            : `${evt.from_phase || '?'} -> ${evt.to_phase || '?'}`;
+          repoLines.push(`    - ${evt.action || 'unknown'}: ${evt.gate_type || 'unknown'} | ${transition} | ${evt.timestamp || 'n/a'}`);
+        }
+      }
+      if (repo.timeout_events && repo.timeout_events.length > 0) {
+        repoLines.push('  Timeout Events:');
+        for (const evt of repo.timeout_events) {
+          const label = evt.type === 'timeout_warning' ? 'warning'
+            : evt.type === 'timeout_skip' ? 'skip'
+            : evt.type === 'timeout_skip_failed' ? 'skip failed'
+            : 'escalation';
+          const elapsed = evt.elapsed_minutes != null ? `${evt.elapsed_minutes}m` : '?';
+          const limit = evt.limit_minutes != null ? `${evt.limit_minutes}m` : '?';
+          repoLines.push(`    - ${label}: ${evt.scope || '?'} scope | ${elapsed}/${limit} | action: ${evt.action || 'n/a'} | ${evt.timestamp || 'n/a'}`);
+        }
+      }
       if (repo.hook_summary) {
         repoLines.push(`  Hook Activity: ${repo.hook_summary.total} total, ${repo.hook_summary.blocked} blocked`);
       }
@@ -1117,7 +1319,8 @@ export function formatGovernanceReportMarkdown(report) {
         const cost = t.cost_usd != null ? formatUsd(t.cost_usd) : 'n/a';
         const phase = t.phase_transition ? `${t.phase || '?'} → ${t.phase_transition}` : (t.phase || '?');
         const summary = (t.summary || '(no summary)').replace(/\|/g, '\\|');
-        lines.push(`| ${i + 1} | ${t.role} | ${phase} | ${summary} | ${t.files_changed_count} | ${cost} | ${t.accepted_at || 'n/a'} |`);
+        const siblingNote = Array.isArray(t.sibling_attributed_files) ? ` (${t.sibling_attributed_files.length} sibling)` : '';
+        lines.push(`| ${i + 1} | ${t.role} | ${phase} | ${summary} | ${t.files_changed_count}${siblingNote} | ${cost} | ${t.accepted_at || 'n/a'} |`);
       }
     }
 
@@ -1135,6 +1338,45 @@ export function formatGovernanceReportMarkdown(report) {
       }
     }
 
+    if (run.gate_failures && run.gate_failures.length > 0) {
+      lines.push('', '## Gate Failures', '');
+      for (const failure of run.gate_failures) {
+        const request = failure.gate_type === 'run_completion'
+          ? 'run completion'
+          : `${failure.from_phase || failure.phase || '?'} → ${failure.to_phase || '?'}`;
+        lines.push(`- \`${failure.gate_id || 'unknown'}\` (${failure.gate_type || 'unknown'}) at \`${failure.failed_at || 'n/a'}\` via ${failure.queued_request ? 'queued drain' : 'direct'} request: ${request}`);
+        for (const reason of failure.reasons || []) {
+          lines.push(`  - ${reason}`);
+        }
+      }
+    }
+
+    if (run.approval_policy_events && run.approval_policy_events.length > 0) {
+      lines.push('', '## Approval Policy', '');
+      for (const evt of run.approval_policy_events) {
+        const transition = evt.gate_type === 'run_completion'
+          ? 'run completion'
+          : `${evt.from_phase || '?'} → ${evt.to_phase || '?'}`;
+        const rule = evt.matched_rule ? ` — rule: \`${typeof evt.matched_rule === 'object' ? JSON.stringify(evt.matched_rule) : evt.matched_rule}\`` : '';
+        lines.push(`- **${evt.action || 'unknown'}** (${evt.gate_type || 'unknown'}) ${transition}${rule} at \`${evt.timestamp || 'n/a'}\``);
+        if (evt.reason) lines.push(`  - ${evt.reason}`);
+      }
+    }
+
+    if (run.timeout_events && run.timeout_events.length > 0) {
+      lines.push('', '## Timeout Events', '');
+      for (const evt of run.timeout_events) {
+        const label = evt.type === 'timeout_warning' ? 'Warning'
+          : evt.type === 'timeout_skip' ? 'Skip'
+          : evt.type === 'timeout_skip_failed' ? 'Skip Failed'
+          : 'Escalation';
+        const elapsed = evt.elapsed_minutes != null ? `${evt.elapsed_minutes}m` : '?';
+        const limit = evt.limit_minutes != null ? `${evt.limit_minutes}m` : '?';
+        const exceeded = evt.exceeded_by_minutes != null ? ` (+${evt.exceeded_by_minutes}m)` : '';
+        lines.push(`- **${label}** (\`${evt.scope || '?'}\` scope) — ${elapsed}/${limit}${exceeded}, action: \`${evt.action || 'n/a'}\`, phase: \`${evt.phase || 'n/a'}\` at \`${evt.timestamp || 'n/a'}\``);
+      }
+    }
+
     if (run.intake_links && run.intake_links.length > 0) {
       lines.push('', '## Intake Linkage', '');
       for (const intake of run.intake_links) {
@@ -1188,7 +1430,19 @@ export function formatGovernanceReportMarkdown(report) {
     return lines.join('\n');
   }
 
-  const { coordinator, run, artifacts, repos, coordinator_timeline, barrier_summary, barrier_ledger_timeline, decision_digest, recovery_report: coordRecoveryReport } = report.subject;
+  const {
+    coordinator,
+    run,
+    artifacts,
+    repos,
+    coordinator_timeline,
+    barrier_summary,
+    barrier_ledger_timeline,
+    decision_digest,
+    approval_policy_events,
+    timeout_events,
+    recovery_report: coordRecoveryReport,
+  } = report.subject;
   const mdLines = [
     '# AgentXchain Governance Report',
     '',
@@ -1272,6 +1526,32 @@ export function formatGovernanceReportMarkdown(report) {
     }
   }
 
+  if (approval_policy_events && approval_policy_events.length > 0) {
+    mdLines.push('', '## Approval Policy', '');
+    for (const evt of approval_policy_events) {
+      const transition = evt.gate_type === 'run_completion'
+        ? 'run completion'
+        : `${evt.from_phase || '?'} → ${evt.to_phase || '?'}`;
+      const rule = evt.matched_rule ? ` — rule: \`${typeof evt.matched_rule === 'object' ? JSON.stringify(evt.matched_rule) : evt.matched_rule}\`` : '';
+      mdLines.push(`- **${evt.action || 'unknown'}** (${evt.gate_type || 'unknown'}) ${transition}${rule} at \`${evt.timestamp || 'n/a'}\``);
+      if (evt.reason) mdLines.push(`  - ${evt.reason}`);
+    }
+  }
+
+  if (timeout_events && timeout_events.length > 0) {
+    mdLines.push('', '## Timeout Events', '');
+    for (const evt of timeout_events) {
+      const label = evt.type === 'timeout_warning' ? 'Warning'
+        : evt.type === 'timeout_skip' ? 'Skip'
+        : evt.type === 'timeout_skip_failed' ? 'Skip Failed'
+        : 'Escalation';
+      const elapsed = evt.elapsed_minutes != null ? `${evt.elapsed_minutes}m` : '?';
+      const limit = evt.limit_minutes != null ? `${evt.limit_minutes}m` : '?';
+      const exceeded = evt.exceeded_by_minutes != null ? ` (+${evt.exceeded_by_minutes}m)` : '';
+      mdLines.push(`- **${label}** (\`${evt.scope || '?'}\` scope) — ${elapsed}/${limit}${exceeded}, action: \`${evt.action || 'n/a'}\`, phase: \`${evt.phase || 'n/a'}\` at \`${evt.timestamp || 'n/a'}\``);
+    }
+  }
+
   if (coordRecoveryReport) {
     mdLines.push('', '## Recovery Report', '');
     mdLines.push(`- **Trigger:** ${coordRecoveryReport.trigger || 'n/a'}`);
@@ -1297,7 +1577,8 @@ export function formatGovernanceReportMarkdown(report) {
         const cost = t.cost_usd != null ? formatUsd(t.cost_usd) : 'n/a';
         const phase = t.phase_transition ? `${t.phase || '?'} → ${t.phase_transition}` : (t.phase || '?');
         const summary = (t.summary || '(no summary)').replace(/\|/g, '\\|');
-        repoLines.push(`| ${i + 1} | ${t.role} | ${phase} | ${summary} | ${t.files_changed_count} | ${cost} | ${t.accepted_at || 'n/a'} |`);
+        const siblingNote = Array.isArray(t.sibling_attributed_files) ? ` (${t.sibling_attributed_files.length} sibling)` : '';
+        repoLines.push(`| ${i + 1} | ${t.role} | ${phase} | ${summary} | ${t.files_changed_count}${siblingNote} | ${cost} | ${t.accepted_at || 'n/a'} |`);
       }
     }
     if (repo.decisions && repo.decisions.length > 0) {
@@ -1312,6 +1593,42 @@ export function formatGovernanceReportMarkdown(report) {
         repoLines.push(`- \`${gate.gate_id}\`: \`${gate.status}\``);
       }
     }
+    if (repo.gate_failures && repo.gate_failures.length > 0) {
+      repoLines.push('', '#### Gate Failures', '');
+      for (const failure of repo.gate_failures) {
+        const request = failure.gate_type === 'run_completion'
+          ? 'run completion'
+          : `${failure.from_phase || failure.phase || '?'} → ${failure.to_phase || '?'}`;
+        repoLines.push(`- \`${failure.gate_id || 'unknown'}\` (${failure.gate_type || 'unknown'}) at \`${failure.failed_at || 'n/a'}\` via ${failure.queued_request ? 'queued drain' : 'direct'} request: ${request}`);
+        for (const reason of failure.reasons || []) {
+          repoLines.push(`  - ${reason}`);
+        }
+      }
+    }
+    if (repo.approval_policy_events && repo.approval_policy_events.length > 0) {
+      repoLines.push('', '#### Approval Policy', '');
+      for (const evt of repo.approval_policy_events) {
+        const transition = evt.gate_type === 'run_completion'
+          ? 'run completion'
+          : `${evt.from_phase || '?'} → ${evt.to_phase || '?'}`;
+        const rule = evt.matched_rule ? ` — rule: \`${typeof evt.matched_rule === 'object' ? JSON.stringify(evt.matched_rule) : evt.matched_rule}\`` : '';
+        repoLines.push(`- **${evt.action || 'unknown'}** (${evt.gate_type || 'unknown'}) ${transition}${rule} at \`${evt.timestamp || 'n/a'}\``);
+        if (evt.reason) repoLines.push(`  - ${evt.reason}`);
+      }
+    }
+    if (repo.timeout_events && repo.timeout_events.length > 0) {
+      repoLines.push('', '#### Timeout Events', '');
+      for (const evt of repo.timeout_events) {
+        const label = evt.type === 'timeout_warning' ? 'Warning'
+          : evt.type === 'timeout_skip' ? 'Skip'
+          : evt.type === 'timeout_skip_failed' ? 'Skip Failed'
+          : 'Escalation';
+        const elapsed = evt.elapsed_minutes != null ? `${evt.elapsed_minutes}m` : '?';
+        const limit = evt.limit_minutes != null ? `${evt.limit_minutes}m` : '?';
+        const exceeded = evt.exceeded_by_minutes != null ? ` (+${evt.exceeded_by_minutes}m)` : '';
+        repoLines.push(`- **${label}** (\`${evt.scope || '?'}\` scope) — ${elapsed}/${limit}${exceeded}, action: \`${evt.action || 'n/a'}\`, phase: \`${evt.phase || 'n/a'}\` at \`${evt.timestamp || 'n/a'}\``);
+      }
+    }
     if (repo.hook_summary) {
       repoLines.push('', '#### Hook Activity', '', `- Total: ${repo.hook_summary.total}`, `- Blocked: ${repo.hook_summary.blocked}`);
       const eventList = Object.entries(repo.hook_summary.events).sort(([a], [b]) => a.localeCompare(b, 'en')).map(([e, c]) => `${e}(${c})`).join(', ');

package/src/lib/schema.js

@@ -74,6 +74,12 @@ export function validateGovernedStateSchema(data) {
     errors.push(`status must be one of: ${VALID_RUN_STATUSES.join(', ')}`);
   }
   if (typeof data.phase !== 'string' || !data.phase.trim()) errors.push('phase must be a non-empty string');
+  if ('created_at' in data && data.created_at !== null && (typeof data.created_at !== 'string' || !data.created_at.trim())) {
+    errors.push('created_at must be a non-empty string or null');
+  }
+  if ('phase_entered_at' in data && data.phase_entered_at !== null && (typeof data.phase_entered_at !== 'string' || !data.phase_entered_at.trim())) {
+    errors.push('phase_entered_at must be a non-empty string or null');
+  }
 
   if (isV1_1) {
     if (hasLegacyCurrentTurn) {
@@ -96,6 +102,47 @@ export function validateGovernedStateSchema(data) {
   if ('phase_gate_status' in data && data.phase_gate_status !== null && typeof data.phase_gate_status !== 'object') {
     errors.push('phase_gate_status must be an object');
   }
+  if ('last_gate_failure' in data && data.last_gate_failure !== null) {
+    if (typeof data.last_gate_failure !== 'object' || Array.isArray(data.last_gate_failure)) {
+      errors.push('last_gate_failure must be an object or null');
+    } else {
+      const failure = data.last_gate_failure;
+      const validGateTypes = ['phase_transition', 'run_completion'];
+      if (typeof failure.gate_type !== 'string' || !validGateTypes.includes(failure.gate_type)) {
+        errors.push(`last_gate_failure.gate_type must be one of: ${validGateTypes.join(', ')}`);
+      }
+      if (failure.gate_id !== null && failure.gate_id !== undefined && typeof failure.gate_id !== 'string') {
+        errors.push('last_gate_failure.gate_id must be a string or null');
+      }
+      if (typeof failure.phase !== 'string' || !failure.phase.trim()) {
+        errors.push('last_gate_failure.phase must be a non-empty string');
+      }
+      if (failure.from_phase !== null && failure.from_phase !== undefined && typeof failure.from_phase !== 'string') {
+        errors.push('last_gate_failure.from_phase must be a string or null');
+      }
+      if (failure.to_phase !== null && failure.to_phase !== undefined && typeof failure.to_phase !== 'string') {
+        errors.push('last_gate_failure.to_phase must be a string or null');
+      }
+      if (failure.requested_by_turn !== null && failure.requested_by_turn !== undefined && typeof failure.requested_by_turn !== 'string') {
+        errors.push('last_gate_failure.requested_by_turn must be a string or null');
+      }
+      if (typeof failure.failed_at !== 'string' || !failure.failed_at.trim()) {
+        errors.push('last_gate_failure.failed_at must be a non-empty string');
+      }
+      if (typeof failure.queued_request !== 'boolean') {
+        errors.push('last_gate_failure.queued_request must be a boolean');
+      }
+      if (!Array.isArray(failure.reasons) || failure.reasons.some((reason) => typeof reason !== 'string')) {
+        errors.push('last_gate_failure.reasons must be an array of strings');
+      }
+      if (!Array.isArray(failure.missing_files) || failure.missing_files.some((file) => typeof file !== 'string')) {
+        errors.push('last_gate_failure.missing_files must be an array of strings');
+      }
+      if (typeof failure.missing_verification !== 'boolean') {
+        errors.push('last_gate_failure.missing_verification must be a boolean');
+      }
+    }
+  }
   if ('budget_status' in data && data.budget_status !== null && typeof data.budget_status !== 'object') {
     errors.push('budget_status must be an object');
   }