Files
awoooi/docs/schemas/ai_agent_runtime_readback_promotion_gate_v1.schema.json
Your Name ea1c825b16
All checks were successful
Code Review / ai-code-review (push) Successful in 13s
CD Pipeline / tests (push) Successful in 1m27s
CD Pipeline / build-and-deploy (push) Successful in 3m43s
CD Pipeline / post-deploy-checks (push) Successful in 1m29s
feat(governance): 新增 runtime readback promotion gate
2026-06-13 18:01:34 +08:00

451 lines
9.8 KiB
JSON

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://awoooi.wooo.work/schemas/ai_agent_runtime_readback_promotion_gate_v1.schema.json",
"title": "AI Agent Runtime Readback Promotion Gate v1",
"type": "object",
"additionalProperties": false,
"required": [
"schema_version",
"generated_at",
"program_status",
"source_refs",
"prior_fixture_approval",
"promotion_truth",
"promotion_lanes",
"receipt_contracts",
"reviewer_queue_previews",
"result_capture_previews",
"no_write_verifier_checks",
"blocker_mappings",
"operator_actions",
"display_redaction_contract",
"rollups"
],
"properties": {
"schema_version": {
"const": "ai_agent_runtime_readback_promotion_gate_v1"
},
"generated_at": {
"type": "string",
"minLength": 1
},
"program_status": {
"type": "object",
"additionalProperties": false,
"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": {
"const": "P2"
},
"current_task_id": {
"const": "P2-113"
},
"next_task_id": {
"const": "P2-114"
},
"read_only_mode": {
"const": true
},
"runtime_authority": {
"const": "runtime_readback_promotion_gate_only_no_live_queue_or_result_write"
},
"status_note": {
"type": "string",
"minLength": 1
}
}
},
"source_refs": {
"$ref": "#/$defs/string_array"
},
"prior_fixture_approval": {
"type": "object"
},
"promotion_truth": {
"type": "object"
},
"promotion_lanes": {
"type": "array",
"minItems": 5,
"items": {
"$ref": "#/$defs/promotion_lane"
}
},
"receipt_contracts": {
"type": "array",
"minItems": 4,
"items": {
"$ref": "#/$defs/receipt_contract"
}
},
"reviewer_queue_previews": {
"type": "array",
"minItems": 4,
"items": {
"$ref": "#/$defs/queue_preview"
}
},
"result_capture_previews": {
"type": "array",
"minItems": 4,
"items": {
"$ref": "#/$defs/result_preview"
}
},
"no_write_verifier_checks": {
"type": "array",
"minItems": 5,
"items": {
"$ref": "#/$defs/verifier_check"
}
},
"blocker_mappings": {
"type": "array",
"minItems": 5,
"items": {
"$ref": "#/$defs/blocker"
}
},
"operator_actions": {
"type": "array",
"minItems": 5,
"items": {
"$ref": "#/$defs/operator_action"
}
},
"display_redaction_contract": {
"type": "object"
},
"rollups": {
"type": "object"
}
},
"$defs": {
"string_array": {
"type": "array",
"minItems": 1,
"items": {
"type": "string",
"minLength": 1
}
},
"hash": {
"type": "string",
"pattern": "^sha256:[0-9a-f]{64}$"
},
"owner_agent": {
"enum": [
"openclaw",
"hermes",
"nemotron"
]
},
"status": {
"enum": [
"ready",
"ready_for_owner_review",
"approval_required",
"blocked_by_policy"
]
},
"risk_tier": {
"enum": [
"medium",
"high",
"critical"
]
},
"promotion_lane": {
"type": "object",
"required": [
"lane_id",
"display_name",
"owner_agent",
"source_task_id",
"status",
"risk_tier",
"allowed_artifact",
"blocked_runtime_actions",
"operator_guidance",
"owner_approval_required",
"promotion_only",
"evidence_hash"
],
"properties": {
"lane_id": {
"type": "string"
},
"display_name": {
"type": "string"
},
"owner_agent": {
"$ref": "#/$defs/owner_agent"
},
"source_task_id": {
"type": "string"
},
"status": {
"$ref": "#/$defs/status"
},
"risk_tier": {
"$ref": "#/$defs/risk_tier"
},
"allowed_artifact": {
"type": "string"
},
"blocked_runtime_actions": {
"$ref": "#/$defs/string_array"
},
"operator_guidance": {
"type": "string"
},
"owner_approval_required": {
"const": true
},
"promotion_only": {
"const": true
},
"evidence_hash": {
"$ref": "#/$defs/hash"
}
},
"additionalProperties": false
},
"receipt_contract": {
"type": "object",
"required": [
"contract_id",
"display_name",
"status",
"source_schema",
"output_artifact",
"required_evidence",
"live_send_enabled",
"receipt_write_enabled",
"evidence_hash"
],
"properties": {
"contract_id": {
"type": "string"
},
"display_name": {
"type": "string"
},
"status": {
"$ref": "#/$defs/status"
},
"source_schema": {
"type": "string"
},
"output_artifact": {
"type": "string"
},
"required_evidence": {
"$ref": "#/$defs/string_array"
},
"live_send_enabled": {
"const": false
},
"receipt_write_enabled": {
"const": false
},
"evidence_hash": {
"$ref": "#/$defs/hash"
}
},
"additionalProperties": false
},
"queue_preview": {
"type": "object",
"required": [
"preview_id",
"display_name",
"status",
"required_fields",
"queue_write_enabled",
"audit_write_enabled",
"evidence_hash"
],
"properties": {
"preview_id": {
"type": "string"
},
"display_name": {
"type": "string"
},
"status": {
"$ref": "#/$defs/status"
},
"required_fields": {
"$ref": "#/$defs/string_array"
},
"queue_write_enabled": {
"const": false
},
"audit_write_enabled": {
"const": false
},
"evidence_hash": {
"$ref": "#/$defs/hash"
}
},
"additionalProperties": false
},
"result_preview": {
"type": "object",
"required": [
"preview_id",
"display_name",
"status",
"required_fields",
"result_capture_write_enabled",
"learning_write_enabled",
"evidence_hash"
],
"properties": {
"preview_id": {
"type": "string"
},
"display_name": {
"type": "string"
},
"status": {
"$ref": "#/$defs/status"
},
"required_fields": {
"$ref": "#/$defs/string_array"
},
"result_capture_write_enabled": {
"const": false
},
"learning_write_enabled": {
"const": false
},
"evidence_hash": {
"$ref": "#/$defs/hash"
}
},
"additionalProperties": false
},
"verifier_check": {
"type": "object",
"required": [
"check_id",
"display_name",
"status",
"required_fixture",
"failure_if_missing",
"live_verifier_enabled",
"evidence_hash"
],
"properties": {
"check_id": {
"type": "string"
},
"display_name": {
"type": "string"
},
"status": {
"$ref": "#/$defs/status"
},
"required_fixture": {
"type": "string"
},
"failure_if_missing": {
"type": "string"
},
"live_verifier_enabled": {
"const": false
},
"evidence_hash": {
"$ref": "#/$defs/hash"
}
},
"additionalProperties": false
},
"blocker": {
"type": "object",
"required": [
"blocker_id",
"display_name",
"severity",
"status",
"source_blocker",
"blocked_action",
"blocked_until",
"evidence_hash"
],
"properties": {
"blocker_id": {
"type": "string"
},
"display_name": {
"type": "string"
},
"severity": {
"$ref": "#/$defs/risk_tier"
},
"status": {
"$ref": "#/$defs/status"
},
"source_blocker": {
"type": "string"
},
"blocked_action": {
"type": "string"
},
"blocked_until": {
"type": "string"
},
"evidence_hash": {
"$ref": "#/$defs/hash"
}
},
"additionalProperties": false
},
"operator_action": {
"type": "object",
"required": [
"action_id",
"display_name",
"owner_agent",
"action_type",
"operator_instruction",
"runtime_promotion_allowed"
],
"properties": {
"action_id": {
"type": "string"
},
"display_name": {
"type": "string"
},
"owner_agent": {
"$ref": "#/$defs/owner_agent"
},
"action_type": {
"type": "string"
},
"operator_instruction": {
"type": "string"
},
"runtime_promotion_allowed": {
"const": false
}
},
"additionalProperties": false
}
}
}