feat(gitea): add feature utilization source contracts

2026-07-10 12:45:33 +08:00
parent 7d90d6383f
commit 7291b2956a
5 changed files with 339 additions and 15 deletions
--- a/docs/operations/gitea-feature-utilization-source-contract.snapshot.json
+++ b/docs/operations/gitea-feature-utilization-source-contract.snapshot.json
@@ -0,0 +1,155 @@
+{
+  "schema_version": "gitea_feature_utilization_source_contract_v1",
+  "source_control_authority": "gitea",
+  "scope": "awoooi_gitea_collaboration_knowledge_admin_feature_source_contract",
+  "feature_contracts": {
+    "pull_request_code_review": {
+      "status": "source_ready",
+      "source_refs": [
+        ".gitea/PULL_REQUEST_TEMPLATE.md",
+        ".gitea/workflows/code-review.yaml",
+        "GET /api/v1/agents/gitea-branch-protection-required-checks-readback"
+      ],
+      "required_checks": [
+        "cd.yaml",
+        "code-review.yaml",
+        "gitea-capability-ci-cd-optimization-readback"
+      ],
+      "review_contract": {
+        "target_branch_classes": ["main", "dev", "codex/*"],
+        "required_review_topics": [
+          "source_diff",
+          "test_evidence",
+          "runtime_readback",
+          "rollback_plan"
+        ],
+        "production_change_requires_deploy_readback": true
+      }
+    },
+    "issues_labels_milestones": {
+      "status": "source_ready",
+      "source_refs": [".gitea/ISSUE_TEMPLATE/operation_task.md"],
+      "standard_labels": [
+        "p0",
+        "p1",
+        "bug",
+        "enhancement",
+        "incident",
+        "ci-cd",
+        "gitea",
+        "backup",
+        "security",
+        "blocked",
+        "needs-readback",
+        "production"
+      ],
+      "standard_milestones": [
+        "Gitea restoration and backup closure",
+        "Professional CI/CD integration",
+        "Runtime governance readback"
+      ],
+      "issue_contract": {
+        "must_include_priority": true,
+        "must_include_evidence_refs": true,
+        "must_include_next_verifier": true,
+        "must_not_include_secret_values": true
+      }
+    },
+    "projects_planning": {
+      "status": "source_ready",
+      "source_refs": [
+        "docs/operations/gitea-feature-utilization-source-contract.snapshot.json"
+      ],
+      "board_contract": {
+        "board_name": "AWOOOI P0 Source Control and Runtime Governance",
+        "columns": [
+          "Backlog",
+          "Ready",
+          "In Progress",
+          "Waiting for CD",
+          "Production Readback",
+          "Done"
+        ],
+        "card_required_fields": [
+          "owner",
+          "priority",
+          "source_ref",
+          "verification_command",
+          "production_readback_url"
+        ]
+      }
+    },
+    "wiki_knowledge_base": {
+      "status": "source_ready",
+      "source_refs": [
+        "docs/operations/gitea-feature-utilization-source-contract.snapshot.json",
+        "docs/operations"
+      ],
+      "wiki_contract": {
+        "wiki_space": "awoooi-runbooks",
+        "required_pages": [
+          "Gitea source-control truth",
+          "CI/CD release and rollback",
+          "Backup and restore receipts",
+          "Production readback playbook"
+        ],
+        "km_writeback_required": true,
+        "playbook_receipt_required": true
+      }
+    },
+    "api_admin_audit": {
+      "status": "source_ready",
+      "source_refs": [
+        "GET /api/v1/agents/gitea-private-inventory-p0-scorecard",
+        "GET /api/v1/agents/gitea-workflow-runner-health",
+        "GET /api/v1/agents/gitea-capability-ci-cd-optimization-readback"
+      ],
+      "redacted_inventory_contract": {
+        "repo_units": [
+          "code",
+          "issues",
+          "pull_requests",
+          "releases",
+          "wiki",
+          "projects",
+          "packages",
+          "actions"
+        ],
+        "admin_surfaces": [
+          "branch_protection",
+          "runner_labels",
+          "workflow_state",
+          "webhook_delivery_metadata",
+          "backup_receipts"
+        ],
+        "allowed_fields": [
+          "enabled",
+          "status",
+          "count",
+          "last_seen_at",
+          "source_ref",
+          "redacted_evidence_hash"
+        ],
+        "forbidden_fields": [
+          "token",
+          "password",
+          "cookie",
+          "private_key",
+          "runner_registration_value",
+          "raw_chat_or_codex_payload"
+        ]
+      }
+    }
+  },
+  "operation_boundaries": {
+    "gitea_api_write_performed": false,
+    "live_issue_created": false,
+    "live_project_created": false,
+    "live_wiki_write_performed": false,
+    "admin_setting_write_performed": false,
+    "secret_values_collected": false,
+    "github_api_used": false,
+    "raw_session_or_sqlite_read_allowed": false
+  },
+  "ready": true
+}