Files
awoooi/docs/schemas/ai_agent_report_status_board_v1.schema.json
Your Name 4013c6a1ad
Some checks failed
Code Review / ai-code-review (push) Successful in 20s
CD Pipeline / tests (push) Successful in 1m36s
CD Pipeline / build-and-deploy (push) Successful in 5m46s
CD Pipeline / post-deploy-checks (push) Successful in 1m29s
Ansible / Reboot Recovery Contract / validate (push) Has been cancelled
fix(agents): align reports with controlled autonomy
2026-06-26 23:40:41 +08:00

286 lines
11 KiB
JSON

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://awoooi.wooo.work/schemas/ai_agent_report_status_board_v1.schema.json",
"title": "AI Agent Report Status Board v1",
"type": "object",
"required": [
"schema_version",
"generated_at",
"program_status",
"source_refs",
"report_completion_truth",
"report_status_cards",
"agent_status_reports",
"visible_charts",
"operator_answer_cards",
"activation_boundaries",
"display_redaction_contract",
"rollups"
],
"properties": {
"schema_version": { "const": "ai_agent_report_status_board_v1" },
"generated_at": { "type": "string" },
"program_status": {
"type": "object",
"required": [
"overall_completion_percent",
"current_priority",
"current_task_id",
"next_task_id",
"read_only_mode",
"runtime_authority",
"status_note"
],
"properties": {
"overall_completion_percent": { "const": 100 },
"current_priority": { "enum": ["P0", "P1", "P2", "P3"] },
"current_task_id": { "const": "P2-108" },
"next_task_id": { "type": "string" },
"read_only_mode": { "const": true },
"runtime_authority": { "const": "report_status_board_only_no_live_send_or_write" },
"status_note": { "type": "string" }
},
"additionalProperties": false
},
"source_refs": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
"report_completion_truth": {
"type": "object",
"required": [
"daily_report_visible",
"weekly_report_visible",
"monthly_report_visible",
"per_agent_status_visible",
"workload_metrics_visible",
"chart_package_visible",
"telegram_digest_draft_visible",
"live_report_delivery_enabled",
"live_telegram_send_count_24h",
"ai_post_report_analysis_enabled",
"medium_low_auto_optimization_enabled",
"low_medium_high_controlled_apply_allowed",
"high_risk_human_approval_required",
"critical_break_glass_required",
"live_auto_optimization_count_24h",
"truth_note"
],
"properties": {
"daily_report_visible": { "const": true },
"weekly_report_visible": { "const": true },
"monthly_report_visible": { "const": true },
"per_agent_status_visible": { "const": true },
"workload_metrics_visible": { "const": true },
"chart_package_visible": { "const": true },
"telegram_digest_draft_visible": { "const": true },
"live_report_delivery_enabled": { "const": false },
"live_telegram_send_count_24h": { "const": 0 },
"ai_post_report_analysis_enabled": { "const": false },
"medium_low_auto_optimization_enabled": { "const": true },
"low_medium_high_controlled_apply_allowed": { "const": true },
"high_risk_human_approval_required": { "const": false },
"critical_break_glass_required": { "const": true },
"live_auto_optimization_count_24h": { "const": 0 },
"truth_note": { "type": "string" }
},
"additionalProperties": false
},
"report_status_cards": {
"type": "array",
"minItems": 3,
"items": {
"type": "object",
"required": [
"cadence_id",
"display_name",
"owner_agent",
"completion_percent",
"contract_state",
"delivery_state",
"sections_count",
"chart_count",
"work_units_total",
"live_delivery_count",
"next_gate"
],
"properties": {
"cadence_id": { "enum": ["daily", "weekly", "monthly"] },
"display_name": { "type": "string" },
"owner_agent": { "enum": ["openclaw", "hermes", "nemotron"] },
"completion_percent": { "const": 100 },
"contract_state": { "const": "visible_contract_ready" },
"delivery_state": { "const": "draft_only" },
"sections_count": { "type": "integer", "minimum": 1 },
"chart_count": { "type": "integer", "minimum": 1 },
"work_units_total": { "type": "integer", "minimum": 0 },
"live_delivery_count": { "const": 0 },
"next_gate": { "type": "string" }
},
"additionalProperties": false
}
},
"agent_status_reports": {
"type": "array",
"minItems": 3,
"items": {
"type": "object",
"required": [
"agent_id",
"display_name",
"primary_role",
"current_state",
"work_units_total",
"work_units_done",
"work_units_waiting_approval",
"work_units_in_controlled_queue",
"report_sections_owned",
"analysis_recommendations_owned",
"live_runtime_work_units_24h",
"communication_state",
"learning_state",
"telegram_policy",
"status_note"
],
"properties": {
"agent_id": { "enum": ["openclaw", "hermes", "nemotron"] },
"display_name": { "type": "string" },
"primary_role": { "type": "string" },
"current_state": { "type": "string" },
"work_units_total": { "type": "integer", "minimum": 0 },
"work_units_done": { "type": "integer", "minimum": 0 },
"work_units_waiting_approval": { "type": "integer", "minimum": 0 },
"work_units_in_controlled_queue": { "type": "integer", "minimum": 0 },
"report_sections_owned": { "type": "integer", "minimum": 0 },
"analysis_recommendations_owned": { "type": "integer", "minimum": 0 },
"live_runtime_work_units_24h": { "const": 0 },
"communication_state": { "type": "string" },
"learning_state": { "type": "string" },
"telegram_policy": { "type": "string" },
"status_note": { "type": "string" }
},
"additionalProperties": false
}
},
"visible_charts": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": ["chart_id", "display_name", "chart_type", "unit", "series"],
"properties": {
"chart_id": { "type": "string" },
"display_name": { "type": "string" },
"chart_type": { "type": "string" },
"unit": { "type": "string" },
"series": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": ["label", "value", "tone"],
"properties": {
"label": { "type": "string" },
"value": { "type": "integer", "minimum": 0 },
"tone": { "enum": ["ok", "warn", "danger", "neutral"] }
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"operator_answer_cards": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": ["answer_id", "question", "answer", "status"],
"properties": {
"answer_id": { "type": "string" },
"question": { "type": "string" },
"answer": { "type": "string" },
"status": { "enum": ["complete", "guarded", "next_gate"] }
},
"additionalProperties": false
}
},
"activation_boundaries": {
"type": "object",
"required": [
"scheduler_enabled",
"gateway_queue_write_enabled",
"telegram_send_enabled",
"report_receipt_write_enabled",
"ai_analysis_run_enabled",
"medium_low_auto_execution_enabled",
"high_risk_auto_execution_enabled",
"low_medium_high_controlled_apply_allowed",
"production_optimization_write_enabled",
"high_risk_requires_human_approval",
"critical_break_glass_required"
],
"properties": {
"scheduler_enabled": { "const": false },
"gateway_queue_write_enabled": { "const": false },
"telegram_send_enabled": { "const": false },
"report_receipt_write_enabled": { "const": false },
"ai_analysis_run_enabled": { "const": false },
"medium_low_auto_execution_enabled": { "const": true },
"high_risk_auto_execution_enabled": { "const": true },
"low_medium_high_controlled_apply_allowed": { "const": true },
"production_optimization_write_enabled": { "const": false },
"high_risk_requires_human_approval": { "const": false },
"critical_break_glass_required": { "const": true }
},
"additionalProperties": false
},
"display_redaction_contract": {
"type": "object",
"required": [
"redaction_required",
"raw_prompt_display_allowed",
"private_reasoning_display_allowed",
"secret_value_display_allowed",
"internal_transcript_display_allowed"
],
"properties": {
"redaction_required": { "const": true },
"raw_prompt_display_allowed": { "const": false },
"private_reasoning_display_allowed": { "const": false },
"secret_value_display_allowed": { "const": false },
"internal_transcript_display_allowed": { "const": false }
},
"additionalProperties": false
},
"rollups": {
"type": "object",
"required": [
"workload_waiting_approval_total",
"workload_controlled_queue_total",
"high_risk_requires_human_approval",
"low_medium_high_controlled_apply_allowed",
"critical_break_glass_required"
],
"properties": {
"report_card_count": { "type": "integer", "minimum": 0 },
"agent_status_count": { "type": "integer", "minimum": 0 },
"visible_chart_count": { "type": "integer", "minimum": 0 },
"operator_answer_count": { "type": "integer", "minimum": 0 },
"completed_report_count": { "type": "integer", "minimum": 0 },
"workload_unit_total": { "type": "integer", "minimum": 0 },
"workload_done_total": { "type": "integer", "minimum": 0 },
"workload_waiting_approval_total": { "const": 0 },
"workload_controlled_queue_total": { "type": "integer", "minimum": 0 },
"live_delivery_count": { "const": 0 },
"live_telegram_send_count": { "const": 0 },
"live_runtime_work_units": { "type": "integer", "minimum": 0 },
"live_auto_optimization_count": { "const": 0 },
"high_risk_requires_human_approval": { "const": false },
"low_medium_high_controlled_apply_allowed": { "const": true },
"critical_break_glass_required": { "const": true }
},
"additionalProperties": false
}
},
"additionalProperties": false
}