feat(governance): 新增 Agent 報告狀態總覽

apps/web/src/lib/api-client.ts

@@ -380,6 +380,11 @@ export const apiClient = {
     return handleResponse<AiAgentReportAutomationReviewSnapshot>(res)
   },
 
+  async getAiAgentReportStatusBoard() {
+    const res = await fetch(`${API_BASE_URL}/agents/agent-report-status-board`)
+    return handleResponse<AiAgentReportStatusBoardSnapshot>(res)
+  },
+
   async getAiAgentReportRuntimeReadiness() {
     const res = await fetch(`${API_BASE_URL}/agents/agent-report-runtime-readiness`)
     return handleResponse<AiAgentReportRuntimeReadinessSnapshot>(res)
@@ -2182,6 +2187,115 @@ export interface AiAgentReportAutomationReviewSnapshot {
   }
 }
 
+export interface AiAgentReportStatusBoardSnapshot {
+  schema_version: 'ai_agent_report_status_board_v1'
+  generated_at: string
+  program_status: {
+    overall_completion_percent: 100
+    current_priority: 'P0' | 'P1' | 'P2' | 'P3'
+    current_task_id: 'P2-108'
+    next_task_id: string
+    read_only_mode: true
+    runtime_authority: 'report_status_board_only_no_live_send_or_write'
+    status_note: string
+  }
+  source_refs: string[]
+  report_completion_truth: {
+    daily_report_visible: true
+    weekly_report_visible: true
+    monthly_report_visible: true
+    per_agent_status_visible: true
+    workload_metrics_visible: true
+    chart_package_visible: true
+    telegram_digest_draft_visible: true
+    live_report_delivery_enabled: false
+    live_telegram_send_count_24h: number
+    ai_post_report_analysis_enabled: false
+    medium_low_auto_optimization_enabled: false
+    high_risk_human_approval_required: true
+    live_auto_optimization_count_24h: number
+    truth_note: string
+  }
+  report_status_cards: Array<{
+    cadence_id: 'daily' | 'weekly' | 'monthly'
+    display_name: string
+    owner_agent: 'openclaw' | 'hermes' | 'nemotron'
+    completion_percent: 100
+    contract_state: 'visible_contract_ready'
+    delivery_state: 'draft_only'
+    sections_count: number
+    chart_count: number
+    work_units_total: number
+    live_delivery_count: number
+    next_gate: string
+  }>
+  agent_status_reports: Array<{
+    agent_id: 'openclaw' | 'hermes' | 'nemotron'
+    display_name: string
+    primary_role: string
+    current_state: string
+    work_units_total: number
+    work_units_done: number
+    work_units_waiting_approval: number
+    report_sections_owned: number
+    analysis_recommendations_owned: number
+    live_runtime_work_units_24h: number
+    communication_state: string
+    learning_state: string
+    telegram_policy: string
+    status_note: string
+  }>
+  visible_charts: Array<{
+    chart_id: string
+    display_name: string
+    chart_type: string
+    unit: string
+    series: Array<{
+      label: string
+      value: number
+      tone: 'ok' | 'warn' | 'danger' | 'neutral'
+    }>
+  }>
+  operator_answer_cards: Array<{
+    answer_id: string
+    question: string
+    answer: string
+    status: 'complete' | 'guarded' | 'next_gate'
+  }>
+  activation_boundaries: {
+    scheduler_enabled: false
+    gateway_queue_write_enabled: false
+    telegram_send_enabled: false
+    report_receipt_write_enabled: false
+    ai_analysis_run_enabled: false
+    medium_low_auto_execution_enabled: false
+    production_optimization_write_enabled: false
+    high_risk_requires_human_approval: true
+  }
+  display_redaction_contract: {
+    redaction_required: true
+    raw_prompt_display_allowed: false
+    private_reasoning_display_allowed: false
+    secret_value_display_allowed: false
+    internal_transcript_display_allowed: false
+  }
+  rollups: {
+    report_card_count: number
+    agent_status_count: number
+    visible_chart_count: number
+    operator_answer_count: number
+    completed_report_count: number
+    workload_unit_total: number
+    workload_done_total: number
+    workload_waiting_approval_total: number
+    live_delivery_count: number
+    live_telegram_send_count: number
+    live_runtime_work_units: number
+    live_auto_optimization_count: number
+    high_risk_requires_human_approval: true
+  }
+}
+
 export interface AiAgentReportRuntimeReadinessSnapshot {
   schema_version: 'ai_agent_report_runtime_readiness_v1'
   generated_at: string