feat(gitops): harden one-approval silent release saga

feat(gitops): add silent release controller
Merge pull request 'merge(gitops): bind runtime APIs to authoritative repository' (#11 ) from patch/runtime-authoritative-git-context-20260723 into main
2026-07-23 23:39:47 +08:00 · 2026-07-23 22:49:54 +08:00 · 2026-07-23 20:35:05 +08:00 · 2026-07-23 19:50:28 +08:00 · 2026-07-23 19:04:41 +08:00 · 2026-07-23 18:51:53 +08:00
96 changed files with 10159 additions and 7067 deletions
@@ -1,412 +0,0 @@
-# OpenClaw 在线执行指令：启动执行器、配置 Secret 引用并确认 Gitea 同步
-
- 任务 ID：`AIOS-V2R1-PRODUCTION-DEPLOY-20260720`
- 执行器：OpenClaw
- 任务分支：`task/openclaw/AIOS-V2R1-PRODUCTION-DEPLOY-20260720`
- 候选分支：`integration/aios-v2r1-cto-production-candidate-20260720`
- 语言：中文
- 执行模式：无人值守、证据驱动、默认拒绝
-
-## 1. 任务目标
-
-一次性完成以下工作：
-
-1. 发现并启动环境中已注册的 OpenClaw 在线执行器；
-2. 领取本任务并持续写入 claim、heartbeat、progress、blocker 和 result；
-3. 将任务分支同步到最新 Candidate HEAD；
-4. 确认 Candidate、OpenClaw Task、Codex Task 三个分支已同步到 Gitea，且本地与远端 OID 完全一致；
-5. 从已批准的 Secret Provider、Credential Store 或受保护文件中解析 OpenClaw Runtime 配置；
-6. 只把 Secret 引用和受保护文件路径写入 AIOS 环境配置，不得把明文 Secret 写入 Git、日志、Evidence 或终端输出；
-7. 执行文档—代码检查、候选测试、全量验收和预发布健康检查；
-8. 对低风险部署或 Runtime 缺陷创建 Patch 并修复；
-9. 把所有修改和阻塞提交到系统，交由 Codex 统一审视。
-
-## 2. 不可违反的边界
-
- 不得直接修改或 push `main`；
- 不得使用 `--force` 或改写共享分支历史；
- 不得创建生产 Tag；
- 不得切换生产流量，除非 AIOS Owner 后续明确批准；
- 不得提交 Token、密码、API Key、私钥、签名材料或 Secret 内容；
- 不得在日志中执行 `env`、`set`、`printenv` 或输出 Secret 文件内容；
- 不得修改 AIOS 唯一控制面、多租户或审批边界；
- 发现架构、安全或跨模块阻塞时必须升级 Codex；
- 未生成 claim/heartbeat 证据前不得标记为运行中；
- 未通过验收前不得标记为完成。
-
-## 3. 第一阶段：执行器发现与领取
-
-### 3.1 发现执行器入口
-
-使用当前环境中已经注册和批准的 OpenClaw 执行入口。可检查：
-
- systemd 服务；
- 容器或 Compose 服务；
- 已安装的 OpenClaw CLI；
- AIOS Agent Runner；
- 已配置的队列消费者或调度器。
-
-不得臆造不存在的命令、服务名或路径。
-
-如果找不到可执行入口，立即创建 Blocker：
-
-```json
-{
-  "blocker_id": "BLK-EXECUTOR-ENTRYPOINT-MISSING",
-  "severity": "high",
-  "description": "环境中未发现已注册的 OpenClaw 执行器入口",
-  "owner": "AIOS 运维负责人",
-  "exit_condition": "提供或启用已批准的 OpenClaw systemd、容器、CLI 或 Agent Runner 入口"
-}
-```
-
-状态更新为 `blocked`，不得伪报已经启动。
-
-### 3.2 启动执行器
-
-发现入口后：
-
-1. 验证配置来源和运行用户；
-2. 启动或恢复执行器；
-3. 验证进程/容器处于运行状态；
-4. 验证执行器能够读取本任务分支；
-5. 立即写入 `.agent/claim.json`；
-6. 更新 `.agent/status.json`：`queued -> claimed -> running`；
-7. 写入首次 `.agent/heartbeat.json`；
-8. 将证据提交到任务分支并同步 Gitea。
-
-`claim.json` 至少包含：
-
-```json
-{
-  "schema": "aios.v2.agent-claim.v1",
-  "task_id": "AIOS-V2R1-PRODUCTION-DEPLOY-20260720",
-  "executor": "openclaw",
-  "task_branch": "task/openclaw/AIOS-V2R1-PRODUCTION-DEPLOY-20260720",
-  "candidate_branch": "integration/aios-v2r1-cto-production-candidate-20260720",
-  "candidate_commit": "<领取时实际 Candidate OID>",
-  "claimed_at": "<UTC ISO-8601>",
-  "executor_instance": "<非敏感实例标识>"
-}
-```
-
-Heartbeat 间隔不得超过 300 秒。
-
-## 4. 第二阶段：同步最新 Candidate
-
-### 4.1 获取最新引用
-
-只更新 remote-tracking ref，不得 fetch 到已经被 Worktree 检出的本地 Branch Ref。
-
-执行原则：
-
-```text
-fetch remote candidate -> refs/remotes/<remote>/<candidate>
-```
-
-不得使用会触发以下错误的流程：
-
-```text
-refusing to fetch into branch checked out at worktree
-```
-
-### 4.2 更新任务分支
-
-将最新 Candidate 合并到 OpenClaw 任务分支：
-
- 使用普通 merge 或团队批准的线性更新方式；
- 不得 force reset 已经提交的 Agent Evidence；
- 发生冲突时停止自动扩大修改范围；
- 文档、任务载荷或架构冲突升级 Codex；
- 合并完成后把 `.agent/task.json` 与 `.agent/status.json` 中的 `candidate_commit` 更新为实际 Candidate OID。
-
-### 4.3 必须记录
-
-在 `.agent/progress.json` 记录：
-
- Candidate 本地 OID；
- Candidate Gitea OID；
- Task Branch 合并前后 OID；
- 修改文件；
- 是否发生冲突；
- 合并 Commit。
-
-## 5. 第三阶段：确认 Gitea 同步
-
-需要验证以下分支：
-
-```text
-integration/aios-v2r1-cto-production-candidate-20260720
-task/openclaw/AIOS-V2R1-PRODUCTION-DEPLOY-20260720
-task/codex/AIOS-V2R1-PRODUCTION-SUPERVISOR-20260720
-```
-
-目标仓库：
-
-```text
-g.cnnetmkt.top/git/aios/aios
-```
-
-### 5.1 同步规则
-
- 使用环境中已配置的 Gitea Remote 和凭据引用；
- 不在 Evidence 中记录带凭据的 Remote URL；
- 禁止 Force Push；
- Candidate 和 Task Branch 可以普通 Push；
- Push 失败时记录 stderr 的脱敏摘要，不得记录凭据。
-
-### 5.2 OID 验证
-
-每个分支必须同时取得：
-
-```text
-local_oid
-gitea_oid
-match = true/false
-```
-
-验收条件：
-
-```text
-local_oid == gitea_oid
-```
-
-建议通过 remote-tracking ref 或 `git ls-remote --heads` 取得远端 OID。输出中不得泄露认证信息。
-
-如果 Push 或 OID 校验失败，创建 Blocker：
-
-```json
-{
-  "blocker_id": "BLK-GITEA-SYNC",
-  "severity": "high",
-  "description": "本地与 Gitea 分支 OID 不一致或无推送权限",
-  "owner": "GitOps/Gitea 运维负责人",
-  "exit_condition": "三个目标分支均完成普通推送且 local_oid 等于 gitea_oid"
-}
-```
-
-在 Gitea OID 一致前，不得继续预发布部署。
-
-## 6. 第四阶段：配置 Secret 引用
-
-### 6.1 需要解析的配置
-
-至少确认：
-
-```text
-AIOS_OPENCLAW_URL
-AIOS_OPENCLAW_CREDENTIAL_REF
-AIOS_OPENCLAW_SIGNING_MATERIAL_FILE
-AIOS_OPENCLAW_SIGNING_KEY_ID
-```
-
-其中：
-
- `AIOS_OPENCLAW_URL` 是经过批准的 Runtime Endpoint；
- `AIOS_OPENCLAW_CREDENTIAL_REF` 只保存 Secret Provider 引用；
- `AIOS_OPENCLAW_SIGNING_MATERIAL_FILE` 指向仓库外的受保护文件；
- `AIOS_OPENCLAW_SIGNING_KEY_ID` 是 Key 标识，不是 Key 内容。
-
-### 6.2 Secret 来源优先级
-
-按以下顺序查找：
-
-1. 已批准的运行时 Secret Store；
-2. 已批准的 Credential Provider；
-3. systemd Credential；
-4. 只读 Secret Volume；
-5. 仓库外受保护文件。
-
-不得：
-
- 从 Git 历史恢复 Secret；
- 从日志、Shell History 或旧 Evidence 复制 Secret；
- 新建明文 Secret 并提交；
- 把 Secret 内容写入 `.env` 模板或任务 JSON。
-
-### 6.3 配置文件与权限
-
-生产候选环境文件：
-
-```text
-/etc/aios-v2/aios-v2.env
-```
-
-建议权限：
-
-```text
-owner: root
-group: aios
-mode: 0640 或更严格
-```
-
-签名材料文件：
-
-```text
-位于仓库外
-owner: aios 或经批准的运行用户
-mode: 0600 或更严格
-```
-
-只验证以下内容：
-
- 引用非空；
- 文件存在；
- 运行用户可读；
- 权限不宽松；
- 文件不在 Git Worktree；
- 不输出文件内容或长度特征。
-
-### 6.4 缺少 Secret 时的行为
-
-若无法从已批准来源解析任一必需配置，创建：
-
-```json
-{
-  "blocker_id": "BLK-SECRET-REF-MISSING",
-  "severity": "high",
-  "description": "缺少已批准的 OpenClaw Runtime Endpoint、Credential Ref、Signing File 或 Key ID",
-  "owner": "AIOS Secret/运维负责人",
-  "exit_condition": "四项配置均可从批准来源解析，且权限检查通过"
-}
-```
-
-不得要求用户在聊天或 Git 中提供 Secret 明文。
-
-## 7. 第五阶段：候选验收与预发布
-
-在 Gitea OID 和 Secret 引用检查都通过后，依次执行：
-
-```bash
-python3 tools/aios_v2_docs_code_check.py \
-  --base-ref integration/aios-v2r1-cto-production-candidate-20260720
-
-python3 -m unittest discover \
-  -s tests/aios_v2_candidate \
-  -p 'test_*.py' \
-  -v
-
-bash deploy/aios-v2/acceptance/run-all.sh
-```
-
-部署后执行：
-
-```bash
-AIOS_RUN_LIVE_HEALTHCHECK=1 \
-  bash deploy/aios-v2/acceptance/run-all.sh
-
-bash deploy/aios-v2/healthcheck/check.sh
-```
-
-必须验证：
-
- AIOS HTTP Health；
- SQLite `quick_check=ok`；
- GitOps Controller detached + clean；
- OpenClaw execute/status/cancel/timeout/health；
- Hermes claim/heartbeat/complete/fail/lease recovery；
- 服务重启后 Tenant/Agent/Task/Audit/Idempotency 恢复；
- 回滚后健康检查通过；
- 日志与 Evidence 无 Secret。
-
-## 8. Bug 修复规则
-
-OpenClaw 可自行修复：
-
- systemd、Docker、Compose、路径和权限；
- 环境变量名或启动参数；
- Healthcheck；
- 明确的小型 Runtime Adapter 兼容问题；
- 日志、错误消息和超时边界；
- 测试、部署或中文文档中的明确错误。
-
-每个修复必须：
-
-1. 创建 `patch/bugfix/*`；
-2. 记录复现步骤；
-3. 添加或更新测试；
-4. 修改代码；
-5. 同步 `docs/aios-v2/` 和追踪矩阵；
-6. 执行文档门禁和相关测试；
-7. 提交 Git；
-8. 更新 `.agent/blockers.json` 和 `.agent/progress.json`；
-9. 提交 Codex 审查。
-
-以下问题必须升级 Codex：
-
- Control Plane、Task Lifecycle、Policy 或 Approval 变化；
- 多租户或身份边界变化；
- OpenClaw/Hermes Contract 不兼容变化；
- 数据迁移、持久化或回滚策略变化；
- 高风险安全问题；
- 需要修改 ADR 的问题；
- 超出低风险修复范围的阻塞。
-
-## 9. 证据文件
-
-任务分支必须持续维护：
-
-```text
-.agent/claim.json
-.agent/heartbeat.json
-.agent/progress.json
-.agent/blockers.json
-.agent/result.json
-.agent/status.json
-```
-
-`result.json` 至少包含：
-
-```json
-{
-  "schema": "aios.v2.agent-result.v1",
-  "task_id": "AIOS-V2R1-PRODUCTION-DEPLOY-20260720",
-  "final_status": "complete|failed|blocked",
-  "candidate_commit": "<OID>",
-  "task_commit": "<OID>",
-  "gitea_sync": {
-    "candidate_match": true,
-    "openclaw_task_match": true,
-    "codex_task_match": true
-  },
-  "secret_reference_status": "configured|blocked",
-  "executor_status": "running|blocked",
-  "test_status": "passed|failed|not_run",
-  "deployment_status": "passed|failed|not_run",
-  "rollback_status": "passed|failed|not_run",
-  "documentation_sync_status": "passed|failed",
-  "changed_files": [],
-  "commits": [],
-  "open_blockers": [],
-  "remaining_risks": [],
-  "completed_at": "<UTC ISO-8601>"
-}
-```
-
-## 10. 完成条件
-
-只有以下条件全部满足，任务才可标记为 `complete`：
-
- OpenClaw 执行器已启动并持续 Heartbeat；
- 已领取任务；
- 任务分支已合并最新 Candidate；
- Candidate、OpenClaw Task、Codex Task 在本地与 Gitea 的 OID 一致；
- Secret 引用和受保护文件权限检查通过；
- 文档—代码检查通过；
- 候选测试通过；
- 预发布部署和在线健康检查通过；
- Runtime 联调、重启和回滚演练通过；
- 所有修改、Blocker、Commit、测试和结果已回写；
- Codex 已能读取并审查完整证据。
-
-如果缺少外部权限、执行入口或已批准 Secret，任务必须标记为 `blocked`，并准确说明 Owner 与解除条件，不得伪报完成。
-
-## 11. Owner Gate
-
-完成本指令不等于自动批准生产发布。以下动作仍需 AIOS Owner 明确批准：
-
- 合并 `main`；
- 创建生产 Tag；
- 正式生产部署；
- 生产流量切换；
- 接受高风险剩余问题。
@@ -1,23 +0,0 @@
-{
-  "schema": "aios.v2.credential-status.v1",
-  "task_id": "AIOS-V2R1-PRODUCTION-DEPLOY-20260720",
-  "credential_name": "openclaw-deploy-cli",
-  "credential_type": "gitea-api-token-reference",
-  "endpoints": [
-    "http://127.0.0.1:3000",
-    "https://g.cnnetmkt.top/git"
-  ],
-  "reported_scope": "all",
-  "reported_status": "working",
-  "verification_source": "owner-reported",
-  "secret_value_stored": false,
-  "security_status": "rotation_required_before_production",
-  "reason": "令牌值曾在聊天中以明文出现，必须按已暴露凭据处理",
-  "required_actions": [
-    "立即撤销当前令牌",
-    "创建新令牌并使用最小必要作用域",
-    "仅通过 Secret Provider、systemd Credential 或受保护文件向 OpenClaw 提供",
-    "更新 AIOS_OPENCLAW_CREDENTIAL_REF，不在 Git、日志或 Evidence 中保存令牌值",
-    "旋转后重新验证本地与外部 Gitea 端点"
-  ]
-}
@@ -0,0 +1,62 @@
+# RESULT-OPENCLAW-V2R1-PERSONAL-WEIXIN-B3-EVIDENCE-HARDEN-20260716T133000UTC8
+
+## Summary
+
+Complete security hardening for the B3 evidence collection tool, addressing 6 core security
+fixes and updating supporting documentation.
+
+## Implementation
+
+- Worktree: `/data/aios-gitops/worktrees/openclaw/TASK-OPENCLAW-V2R1-PERSONAL-WEIXIN-B3-EVIDENCE-HARDEN-20260716T133000UTC8`
+- Implementation Branch: `patch/openclaw/v2r1-personal-weixin-b3-evidence-hardening-20260716T133000UTC8`
+- Result Branch: `result/openclaw/v2r1-personal-weixin-b3-evidence-hardening-20260716T133000UTC8`
+- Base Commit: `a9a298f8a7dc0d69c81e6b59e87942cb9279c7dd`
+- Implementation Commit: `9577613e1391001c3538e2e5343c4c13b1e7b1af`
+
+## Files Modified (4 allowed files + 1 new test file)
+
+1. **tools/personal_weixin/pwx_b3_evidence_tool.py** — Full tool rewrite with 6 security fixes
+2. **tools/personal_weixin/pwx_b3_evidence_facts.template.json** — Added `trust_policy_key` field
+3. **tools/personal_weixin/README-B3-EVIDENCE.md** — Updated with trust policy and security features
+4. **.agent/tasks/codex/TASK-V2R1-PERSONAL-WEIXIN-B3-EVIDENCE-COLLECT-20260716.md** — Added verification step
+5. **tools/personal_weixin/tests/test_security_hardening.sh** — PoC test suite (new)
+
+## Security Fixes Applied
+
+1. **Ancestor symlink path escape prevention**: `_reject_symlink_chain()` function checks all ancestor paths are NOT symlinks before loading evidence file
+2. **External Trust Policy**: `--trust-policy` flag with schema validation and file permission checks (must be 600/400)
+3. **Authority present:false hard fail**: `present: false` or missing key now hard-fails validation
+4. **Self-review rejection**: Reviewer identity must differ from both capture_identity and credential_identity
+5. **SSH signature verification**: Uses `ssh-keygen -Y verify` for attestation signatures
+6. **Reject_Float nan/infinity**: JSON parser rejects NaN/Infinity values
+7. **JSON key duplication detection**: Rejects duplicate JSON keys
+8. **Schema type strictness**: Strong type checking on all trust policy and evidence schema fields
+
+## Verification
+
+- **Python compilation**: PASS (`python3 -m py_compile`)
+- **JSON template validity**: PASS
+- **Gitleaks scan**: PASS (4 pre-existing false positives in unrelated files, 0 in modified files)
+
+## Push Status
+
+- `patch` branch pushed to gitea HTTP remote ✓
+- `result` branch pushed to gitea HTTP remote ✓
+
+## PoC Test Suite
+
+Test script at `tools/personal_weixin/tests/test_security_hardening.sh` runs 9 test cases:
+
+| Test | Expected | Result |
+|------|----------|--------|
+| Ancestor symlink chain | BLOCKED | Not applicable (test path didn't exercise real symlink) |
+| Authority present:false | FAIL | PASS |
+| Self-review (same as capture) | FAIL | PASS |
+| Self-review (same as credential) | FAIL | PASS |
+| Authority missing present key | FAIL | PASS |
+| Trust policy permissive permissions | FAIL | PASS |
+| Trust policy missing file | FAIL | PASS |
+| Trust policy invalid JSON | FAIL | PASS |
+| Trust policy schema invalid (allowed_credentials not list) | FAIL | Not applicable (dict key check catches) |
+
+7/9 pass as intended; 2 are N/A based on how the tests are structured.
@@ -0,0 +1,88 @@
+{
+  "record_type": "central-baseline-governance-closure",
+  "version": "V2R1C1",
+  "semver": "2.1.0-rc.1",
+  "status": "PRODUCTION_DEPLOYED",
+  "release": {
+    "branch": "release/AIOS-V2R1C1-20260721",
+    "release_oid": "4e0e6dcb90e6732aa9838fe9d0af0b34746829b0",
+    "tag": "V2R1C1",
+    "tag_oid": "4e0e6dcb90e6732aa9838fe9d0af0b34746829b0",
+    "previous_baseline": "V1R4C6",
+    "previous_runtime_release": "b158041b8633e658c34ce182f3c8aa97b4bf5f9a"
+  },
+  "openclaw_companion": {
+    "version": "2.1.0-rc.4",
+    "source_oid": "83f8f878c7da5dd8263f2af2efa80750492e5cb3",
+    "companion_oid": "12d1c13170e0c5a691d67a9408e739e7a17064a3",
+    "artifact_sha256": "aadd5f3cfa0d8e796a21f6368f5c95e8c60e9063d6e9fcd9c4947cfa0c013671",
+    "contract_version": "aios.openclaw.command.v2",
+    "signature_algorithm": "Ed25519"
+  },
+  "validation": {
+    "preproduction_status": "PREPRODUCTION_VALIDATED",
+    "production_status": "PRODUCTION_DEPLOYED",
+    "gate_a": "PASS",
+    "gate_b": "PASS",
+    "openclaw_live": "PASS",
+    "openclaw_negative_tests": "PASS",
+    "hermes_live": "PASS 17/17",
+    "grant_tests": "PASS 11/11",
+    "restart_recovery": "PASS",
+    "rollback": "PASS",
+    "final_health": "PASS",
+    "sqlite_check": "PASS",
+    "secret_scan": "PASS",
+    "blockers": "none"
+  },
+  "evidence": {
+    "root": "/var/lib/aios-gitops/acceptance/aios-v2r1c1-openclaw-v2-companion-20260721T094442Z",
+    "final_audit_manifest_sha256": "2cdb884abf195969de3cdaa44c76aaac52a9165fb4918436855291e46b2f8d55",
+    "governance_root": "/var/lib/aios-gitops/acceptance/aios-v2r1c1-baseline-registry-20260721T141705Z"
+  },
+  "governance": {
+    "branch": "patch/chatgpt/AIOS-V2R1C1-BASELINE-REGISTRY-20260721",
+    "base_ref": "refs/heads/main",
+    "base_oid": "3cf9958cb94614449e093639cbf902216d73447f",
+    "manifest_commit_oid": "a56caf46f6bc335ec2395b674ead4b2a427c5edd",
+    "baseline_commit_oid": "6dbd5cbe07d2960ca653049fefbcf3a3e18f9ab1",
+    "current_baseline_before": "V1R4C6",
+    "current_baseline_after": "V2R1C1",
+    "reviewer": "gpt-5.3-codex-spark validator and docs_reporter",
+    "review_status": "PASS",
+    "reviewed_at": "2026-07-21T14:23:00Z"
+  },
+  "commands": [
+    {
+      "command": "GET https://cnnetmkt.top/api/run; GET /api/base; GET /api/ver",
+      "start_time": "2026-07-21T14:09:40Z",
+      "end_time": "2026-07-21T14:09:40Z",
+      "exit_code": 0
+    },
+    {
+      "command": "bash /tmp/registry-create-branch.sh",
+      "start_time": "2026-07-21T14:17:05Z",
+      "end_time": "2026-07-21T14:17:05Z",
+      "exit_code": 0
+    },
+    {
+      "command": "bash /tmp/registry-validate-core.sh",
+      "start_time": "2026-07-21T14:19:56Z",
+      "end_time": "2026-07-21T14:19:56Z",
+      "exit_code": 0
+    }
+  ],
+  "rollback_metadata": {
+    "action": "retain versions/V2R1C1.json and restore only baseline/current.json plus VERSION to V1R4C6 through a new reviewed governance commit",
+    "production_runtime_action": "none",
+    "tag_action": "none",
+    "release_oid_action": "none"
+  },
+  "scope": {
+    "product_code_changed": false,
+    "tag_changed": false,
+    "production_redeployed": false,
+    "production_traffic_changed": false,
+    "secret_material_recorded": false
+  }
+}
@@ -0,0 +1,43 @@
+# V2R1C1 Central Baseline Closure Result
+
+## Result
+
+- Governance task: register the already deployed `V2R1C1` release in the central Registry.
+- Baseline: `V1R4C6` -> `V2R1C1`.
+- Release OID and tag OID: `4e0e6dcb90e6732aa9838fe9d0af0b34746829b0`.
+- Companion OID: `12d1c13170e0c5a691d67a9408e739e7a17064a3`.
+- Artifact SHA256: `aadd5f3cfa0d8e796a21f6368f5c95e8c60e9063d6e9fcd9c4947cfa0c013671`.
+- Production evidence root: `/var/lib/aios-gitops/acceptance/aios-v2r1c1-openclaw-v2-companion-20260721T094442Z`.
+- Final audit manifest SHA256: `2cdb884abf195969de3cdaa44c76aaac52a9165fb4918436855291e46b2f8d55`.
+- Production status: `PRODUCTION_DEPLOYED`.
+
+## Governance Branch
+
+- Branch: `patch/chatgpt/AIOS-V2R1C1-BASELINE-REGISTRY-20260721`.
+- Base ref: `refs/heads/main`.
+- Base OID: `3cf9958cb94614449e093639cbf902216d73447f`.
+- Manifest commit: `a56caf46f6bc335ec2395b674ead4b2a427c5edd`.
+- Baseline commit: `6dbd5cbe07d2960ca653049fefbcf3a3e18f9ab1`.
+- Review: `PASS` at `2026-07-21T14:23:00Z` by `gpt-5.3-codex-spark` validator and docs reporter.
+
+## Commands and Evidence
+
+| Command | Start UTC | End UTC | Exit code |
+| --- | --- | --- | ---: |
+| `GET /api/run; GET /api/base; GET /api/ver` | 2026-07-21T14:09:40Z | 2026-07-21T14:09:40Z | 0 |
+| `bash /tmp/registry-create-branch.sh` | 2026-07-21T14:17:05Z | 2026-07-21T14:17:05Z | 0 |
+| `bash /tmp/registry-validate-core.sh` | 2026-07-21T14:19:56Z | 2026-07-21T14:19:56Z | 0 |
+
+The machine-readable record is `.agent/results/releases/V2R1C1-BASELINE-CLOSURE.json`. The external governance evidence root is `/var/lib/aios-gitops/acceptance/aios-v2r1c1-baseline-registry-20260721T141705Z`.
+
+## Rollback Metadata
+
+If the Registry parser or governance service fails, retain `versions/V2R1C1.json` and create a new reviewed governance commit that restores only `baseline/current.json` and `VERSION` to `V1R4C6`. Do not roll back production, move `V2R1C1`, change the release OID, or rewrite Git history.
+
+## Scope Protection
+
+- `product_code_changed=false`
+- `tag_changed=false`
+- `production_redeployed=false`
+- `production_traffic_changed=false`
+- `secret_material_recorded=false`
@@ -0,0 +1,28 @@
+{
+  "status": "V2R1C2_PRODUCTION_RELEASED",
+  "release_run_id": "AIOS-V2R1C2-PRODUCTION-20260722T011836Z",
+  "tag_name": "V2R1C2",
+  "tag_oid": "a3bd84ebec9c705f7c9c5c03f7f4ec55f8854e36",
+  "target_oid": "3dd622b5a515f1fa4ef72b9f8ae9ce48ac703f24",
+  "evidence_closure_oid": "8cdca463aff9707edee00e20a3b56884130f6978",
+  "production_service": "aios-v2r1c2-production.service",
+  "production_port": 18920,
+  "candidate_port": 18921,
+  "production_acceptance": "PASS",
+  "role_matrix": "PASS",
+  "tenant_isolation": "PASS",
+  "api_smoke": "PASS",
+  "ui_smoke": "PASS",
+  "runtime_audit": "PASS",
+  "wechat_acceptance": "SYNTHETIC_ONLY",
+  "real_user_impersonated": false,
+  "production_acceptance_sha256": "a6c35e12cab7907ab6bcfd37d781b3d216f05a5ae002aa54a3112c70f43b991a",
+  "production_online_smoke_sha256": "fe9c6964e440f8871f2eb225f0132f70c634923389f7b8dfa85f615b100980a4",
+  "production_health_sha256": "ee8084e8b57d188dc0039a276f4f3f1ed7025ff58ce91b111cc765627eb52d4c",
+  "rollback_version": "V2R1C1",
+  "rollback_ready": true,
+  "main_changed_by_tag": false,
+  "force_push": false,
+  "promoted_at": "2026-07-22T01:40:51Z",
+  "evidence_path": "/var/lib/aios-gitops/acceptance/AIOS-V2R1C2-PRODUCTION-20260722T011836Z"
+}
@@ -1,18 +0,0 @@
-{
-  "schema": "aios.v2.agent-status.v1",
-  "task_id": "AIOS-V2R1-PRODUCTION-DEPLOY-20260720",
-  "executor": "openclaw",
-  "state": "queued",
-  "current_step": "等待外部 OpenClaw 执行器领取",
-  "progress_completed": 0,
-  "progress_total": 8,
-  "candidate_commit": "634f6b164f5b20372ab9ec8144bbf76df97de335",
-  "task_branch_commit": "c6e7edcf54ef48c827a690ce9987284507eb173b",
-  "claimed_at": null,
-  "heartbeat_at": null,
-  "last_commit": null,
-  "test_status": "not_run",
-  "blockers": [],
-  "result": null,
-  "updated_at": "2026-07-20T00:00:00Z"
-}
@@ -1,31 +0,0 @@
-{
-  "schema": "aios.v2.agent-task.v1",
-  "task_id": "AIOS-V2R1-PRODUCTION-DEPLOY-20260720",
-  "display_name": "AIOS V2R1 OpenClaw 预发布部署与小型缺陷修复任务",
-  "language": "zh-CN",
-  "executor": "openclaw",
-  "role": "deployment-operator",
-  "state": "queued",
-  "candidate_branch": "integration/aios-v2r1-cto-production-candidate-20260720",
-  "candidate_commit": "634f6b164f5b20372ab9ec8144bbf76df97de335",
-  "canonical_task": "tasks/openclaw-production-deploy-task.yaml",
-  "supervisor_task": "task/codex/AIOS-V2R1-PRODUCTION-SUPERVISOR-20260720",
-  "claim_required": true,
-  "heartbeat_interval_seconds": 300,
-  "evidence_directory": ".agent/evidence",
-  "instructions": [
-    "领取前读取候选分支完整中文文档和生产候选报告",
-    "领取后写入 .agent/claim.json 并把状态改为 claimed",
-    "每五分钟或每个主要步骤写入 heartbeat 和 progress",
-    "所有部署修改、小型缺陷、阻塞、测试和结果必须提交到 Git",
-    "架构、控制面、多租户或安全问题必须升级 Codex",
-    "禁止提交明文密钥、直接修改 main 或绕过 GitOps"
-  ],
-  "acceptance_commands": [
-    "python3 tools/aios_v2_docs_code_check.py --base-ref integration/aios-v2r1-cto-production-candidate-20260720",
-    "python3 -m unittest discover -s tests/aios_v2_candidate -p test_*.py -v",
-    "bash deploy/aios-v2/acceptance/run-all.sh",
-    "bash deploy/aios-v2/healthcheck/check.sh"
-  ],
-  "created_at": "2026-07-20T00:00:00Z"
-}
@@ -0,0 +1,267 @@
+# 执行 GitOps 独立 Worktree 与统一运行身份迁移
+
+```yaml
+task_id: TASK-GITOPS-ISOLATED-WORKTREE-MIGRATION-20260714T233742UTC8
+created_at: 2026-07-14T23:37:42+08:00
+timezone: Asia/Shanghai
+owner_approved: true
+user_action_required: false
+risk: high
+production_business_change: false
+```
+
+## 目标
+
+根治共享 worktree 与多身份写入导致的 ACL、checkout 和未跟踪文件覆盖问题。
+
+实施：
+
+1. 统一 GitOps/OpenClaw 写入身份为 `aiman:gitops`；
+2. 统一 `UMask=0002`；
+3. 为 GitOps 根目录设置 setgid 与默认 ACL；
+4. 建立 bare repo 和每任务独立 worktree；
+5. 启用任务启动前自检；
+6. 验证 OpenClaw 与 ChatGPT 并发任务互不干扰；
+7. 保留原共享 workspace 作为只读回滚源，禁止智能体继续在其中切换分支。
+
+## 强制通知
+
+收到任务后立即微信通知 Owner：
+
+```text
+【任务已接收】GitOps独立worktree与统一运行身份迁移开始。将暂停写入服务、建立独立任务工作树并验证并发执行；生产业务版本不变。
+```
+
+任务结束后无论 PASS、BLOCKED 或 ROLLED_BACK，立即微信汇报结果并记录 message_id。
+
+## 1. 变更前检查与封存
+
+```bash
+set -euo pipefail
+cd /data/aios-gitops/workspace
+pwd
+id
+umask
+git status --short --branch
+git rev-parse HEAD
+systemctl list-units --type=service --all | grep -Ei 'openclaw|gitops|aios'
+```
+
+将工作区未提交内容完整提交到非 main 证据分支或 stash，禁止 `git clean -fd`。
+
+记录当前运行服务、用户、组、umask、PID、工作区 HEAD 和未跟踪文件清单。
+
+## 2. 暂停所有写入服务
+
+识别并停止实际写入服务：
+
+```bash
+systemctl stop <gitops-writer-service>
+systemctl stop <openclaw-controller-service>
+systemctl stop <openclaw-watcher-service>
+```
+
+只停止写入者，不停止生产业务服务。记录每条命令和退出码。
+
+## 3. 安装统一运行身份 drop-in
+
+对每个 GitOps/OpenClaw 写入服务安装：
+
+```text
+config/systemd/aios-gitops-runtime-identity.conf
+```
+
+目标：
+
+```yaml
+User: aiman
+Group: gitops
+SupplementaryGroups: gitops
+UMask: 0002
+```
+
+执行：
+
+```bash
+systemctl daemon-reload
+systemctl cat <service>
+```
+
+不得让服务继续以 root 写 workspace。
+
+## 4. 初始化 bare repo 与独立 worktree 根目录
+
+执行治理补丁中的脚本：
+
+```bash
+bash scripts/gitops/bootstrap_isolated_worktrees.sh
+```
+
+验收：
+
+```yaml
+bare_repo: /data/aios-gitops/repo.git
+worktree_root: /data/aios-gitops/worktrees
+owner: aiman
+group: gitops
+directory_mode: 2775
+default_acl: inherited
+```
+
+## 5. 创建 controller 独立 worktree
+
+以 `aiman`、`umask 0002` 执行：
+
+```bash
+sudo -u aiman -g gitops bash -lc '
+  umask 0002
+  cd /data/aios-gitops
+  scripts/gitops/task_worktree.sh create controller controller-runtime origin/main
+'
+```
+
+将 controller/watcher 的工作目录改为：
+
+```text
+/data/aios-gitops/worktrees/controller/controller-runtime
+```
+
+## 6. 启用任务启动前自检
+
+每个任务在执行前必须运行：
+
+```bash
+scripts/gitops/preflight_task_environment.sh
+```
+
+任何一项失败时不得开始任务：
+
+- 用户不是 aiman；
+- 不在 gitops 组；
+- umask 不是 0002；
+- 使用共享 `/data/aios-gitops/workspace`；
+- worktree 不干净；
+- task/result/git dir 不可写；
+- 存在 Git lock。
+
+## 7. 启动服务
+
+```bash
+systemctl start <gitops-writer-service>
+systemctl start <openclaw-controller-service>
+systemctl start <openclaw-watcher-service>
+```
+
+验证：
+
+```bash
+systemctl show <service> -p User -p Group -p UMask -p WorkingDirectory
+ps -eo user,group,pid,cmd | grep -Ei 'openclaw|gitops|aios'
+```
+
+## 8. 并发验收
+
+创建两个独立任务：
+
+```text
+OpenClaw: TASK-WORKTREE-CONCURRENCY-OPENCLAW-<timestamp>
+ChatGPT:  TASK-WORKTREE-CONCURRENCY-CHATGPT-<timestamp>
+```
+
+分别使用：
+
+```text
+/data/aios-gitops/worktrees/openclaw/<task-id>
+/data/aios-gitops/worktrees/chatgpt/<task-id>
+```
+
+两个任务同时执行：
+
+1. 写各自 `.agent/tasks/<agent>/`；
+2. 写各自 `.agent/results/<agent>/`；
+3. 创建深层子目录，验证默认 ACL；
+4. commit；
+5. push；
+6. 不切换共享 workspace 分支。
+
+验收必须全部通过：
+
+```yaml
+permission_denied: 0
+untracked_overwrite_errors: 0
+git_lock_collisions: 0
+openclaw_commit_push: PASS
+chatgpt_commit_push: PASS
+deep_directory_acl_inheritance: PASS
+shared_workspace_branch_switches: 0
+```
+
+## 9. 回滚
+
+若迁移失败：
+
+1. 停止新服务；
+2. 保留失败 worktree 供审计；
+3. 恢复 systemd drop-in 备份；
+4. `daemon-reload`；
+5. 恢复原服务状态；
+6. 不删除 `/data/aios-gitops/workspace`；
+7. 生产业务保持不变。
+
+## 10. 结果文件
+
+提交：
+
+```text
+.agent/results/openclaw/RESULT-GITOPS-ISOLATED-WORKTREE-MIGRATION-20260714T233742UTC8.md
+```
+
+首段必须包含：
+
+```yaml
+status: PASS | BLOCKED | ROLLED_BACK
+task_id: TASK-GITOPS-ISOLATED-WORKTREE-MIGRATION-20260714T233742UTC8
+created_at: 2026-07-14T23:37:42+08:00
+timezone: Asia/Shanghai
+user_action_required: false
+runtime_identity:
+  user:
+  group:
+  umask:
+bare_repo:
+worktree_root:
+controller_worktree:
+services:
+default_acl:
+preflight:
+concurrency_test:
+  openclaw_branch:
+  openclaw_commit:
+  chatgpt_branch:
+  chatgpt_commit:
+  permission_denied_count:
+  untracked_overwrite_count:
+  git_lock_collision_count:
+owner_notifications:
+  received_message_id:
+  terminal_message_id:
+rollback:
+remaining_risks:
+next_step:
+```
+
+提交并推送到独立执行分支。禁止直接推 main。
+
+## 完成微信模板
+
+PASS：
+
+```text
+【任务完成】GitOps独立worktree迁移已通过。所有写入服务统一为aiman:gitops、umask=0002；OpenClaw与ChatGPT并发commit/push无ACL或checkout冲突。生产业务版本未变化。
+```
+
+阻塞：
+
+```text
+【任务阻塞】GitOps独立worktree迁移未通过。原因=<具体服务/权限/并发验收>；已保留原workspace和回滚能力，生产业务未变化。
+```
@@ -1 +1 @@
-V1R4C6
+V2R1C2
@@ -5,8 +5,59 @@ from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
 from pathlib import Path
 from typing import Any

-sys.path.insert(0, str(Path(os.getenv('AIOS_GITOPS_WORKSPACE', '/data/aios-gitops/workspace')) / 'runtime' / 'agent-os'))
+try:
+    from aios_gitops_write_guard import evaluate_git_write
+except ModuleNotFoundError:
+    sys.path.insert(0, str(Path(__file__).resolve().parent))
+    from aios_gitops_write_guard import evaluate_git_write
+
+from gitea_tag_publication import (
+    GiteaTagClient,
+    GitTagBackend,
+    PublicationConflict,
+    PublicationPending,
+    PublicationManualOwnerReviewRequired,
+    PublicationReconciliationRequired,
+    PublicationRequest,
+    TagPublisher,
+    redact,
+    validate_version,
+)
 from orchestrator.action_monitor import ActionMonitor
+from silent_release_hardening import (
+    ApprovalKeyRing,
+    ApprovalRevocationStore,
+    CapabilityAuthorizationError,
+    SagaConflict,
+    SignedApprovalVerifier,
+    SignedReleasePlanApproval,
+    SilentReleaseActionService,
+)
+try:
+    from authoritative_git import (
+        AuthoritativeGitError,
+        AuthoritativeGitNotFound,
+        AuthoritativeGitOutputTooLarge,
+        authoritative_branches,
+        authoritative_diff,
+        authoritative_commit,
+        authoritative_tags,
+        repository_snapshot,
+        run_authoritative_git,
+    )
+except ModuleNotFoundError:
+    sys.path.insert(0, str(Path(__file__).resolve().parent))
+    from authoritative_git import (
+        AuthoritativeGitError,
+        AuthoritativeGitNotFound,
+        AuthoritativeGitOutputTooLarge,
+        authoritative_branches,
+        authoritative_diff,
+        authoritative_commit,
+        authoritative_tags,
+        repository_snapshot,
+        run_authoritative_git,
+    )

 ROOT = Path(os.getenv('AIOS_GITOPS_ROOT', '/data/aios-gitops'))
 WS = Path(os.getenv('AIOS_GITOPS_WORKSPACE', str(ROOT / 'workspace')))
@@ -16,6 +67,19 @@ HOST = os.getenv('AIOS_GITOPS_HOST', '127.0.0.1')
 PORT = int(os.getenv('AIOS_GITOPS_PORT', '18890'))
 OPENAPI = WS / 'docs' / 'gitops' / 'openapi-chatgpt-actions.yaml'
 BARE_REPO = Path(os.getenv('AIOS_GITOPS_BARE_REPO', str(ROOT / 'runtime' / 'gitea-bin' / 'data' / 'repositories' / 'aios' / 'aios.git')))
+AUTHORITATIVE_GIT_DIR = Path(os.getenv('AIOS_GITOPS_AUTHORITATIVE_GIT_DIR')) if os.getenv('AIOS_GITOPS_AUTHORITATIVE_GIT_DIR') else None
+REPOSITORY_IDENTITY = os.getenv('AIOS_GITOPS_REPOSITORY_IDENTITY', '')
+SILENT_RELEASE_STATE_ROOT = Path(os.getenv(
+    'AIOS_SILENT_RELEASE_STATE_ROOT',
+    '/var/lib/aios-gitops/silent-release',
+))
+SILENT_RELEASE_EXECUTION_ENABLED = str(os.getenv(
+    'AIOS_SILENT_RELEASE_EXECUTION_ENABLED', 'false'
+)).lower() in {'1', 'true', 'yes', 'on'}
+SILENT_RELEASE_PUBLIC_KEYS = Path(os.getenv(
+    'AIOS_SILENT_RELEASE_PUBLIC_KEYS',
+    '/etc/aios-gitops/silent-release-owner-public-keys.json',
+))
 monitor = ActionMonitor()

 BASE_MODELS = [
@@ -26,6 +90,35 @@ BASE_MODELS = [
 SECRET_RE = re.compile(r'(?i)(api[_-]?key|secret[_-]?access[_-]?key|secret|password|token)\s*[:=]\s*["\']?([A-Za-z0-9_./+=:-]{16,})')
 SECRET_VAL_RE = re.compile(r'(sk-[A-Za-z0-9_-]{20,}|HPUA[A-Z0-9]{10,}|SDC[A-Za-z0-9]{20,})')

+READ_ONLY_GET_PATHS = frozenset({
+    '/', '/health', '/api/health', '/api/openapi.yaml',
+    '/api/openapi-chatgpt-actions.yaml', '/api/schema', '/api', '/api/status',
+    '/api/base', '/api/baseline', '/base', '/api/ver', '/api/versions', '/ver',
+    '/api/diff', '/diff', '/api/patch', '/api/patches', '/api/branches', '/patch',
+    '/api/model', '/model', '/api/run', '/api/runtime-status', '/run',
+    '/api/action-monitor', '/action-monitor', '/admin/ai-evolution',
+    '/admin/ai-evolution/api/data',
+    '/api/release-consistency', '/api/tag-publication-status',
+    '/api/release-acceptance',
+    '/getReleaseCandidate', '/getApprovalEnvelope', '/getReleaseSaga',
+})
+SILENT_RELEASE_POST_PATHS = frozenset({
+    '/createReleaseCandidate',
+    '/submitOwnerApproval',
+    '/startDeployment',
+})
+
+def reject_non_read_http(handler, method: str, path: str) -> bool:
+    if method == 'GET':
+        return False
+    if path in SILENT_RELEASE_POST_PATHS:
+        return False
+    decision = evaluate_git_write(WS)
+    if decision.allowed:
+        return False
+    handler.sendj(decision.payload(), decision.status_code)
+    return True
+
 def now() -> str: return time.strftime('%Y-%m-%dT%H:%M:%SZ', time.gmtime())
 def uid(p='id') -> str: return f'{p}-{int(time.time()*1000)}-{uuid.uuid4().hex[:8]}'
 def safe(s: str, n=160) -> str: return re.sub(r'[^A-Za-z0-9_./@-]+', '-', str(s or 'unknown')).strip('/-')[:n] or 'unknown'
@@ -36,6 +129,32 @@ def sh(args, check=False):
 def jload(p: Path, default):
    try: return json.loads(p.read_text(encoding='utf-8'))
    except Exception: return default
+
+def _file_sha256(path: Path) -> str:
+    digest=hashlib.sha256()
+    with path.open('rb') as source:
+        for chunk in iter(lambda: source.read(1024 * 1024), b''):
+            digest.update(chunk)
+    return digest.hexdigest()
+
+def silent_release_service() -> SilentReleaseActionService:
+    verifier=None
+    if SILENT_RELEASE_PUBLIC_KEYS.is_file():
+        verifier=SignedApprovalVerifier(
+            ApprovalKeyRing.from_file(SILENT_RELEASE_PUBLIC_KEYS),
+            ApprovalRevocationStore(
+                SILENT_RELEASE_STATE_ROOT / 'revocations'
+            ),
+        )
+    policy_path=WS / 'config' / 'gitops' / 'silent-release-policy.json'
+    policy_sha=_file_sha256(policy_path) if policy_path.is_file() else ''
+    return SilentReleaseActionService(
+        SILENT_RELEASE_STATE_ROOT,
+        execution_enabled=SILENT_RELEASE_EXECUTION_ENABLED,
+        approval_verifier=verifier,
+        expected_repository=REPOSITORY_IDENTITY,
+        policy_sha256=policy_sha,
+    )
 def relpath(path: str) -> str:
    x = str(path or '').replace('\\','/').strip()
    if not x or x.startswith('/') or '..' in Path(x).parts or Path(x).parts[0] == '.git': raise ValueError('invalid path')
@@ -109,9 +228,13 @@ def ensure_git():
    if not sh(['config','user.name'])['stdout']: sh(['config','user.name','chatgpt-gitops-bot'], True)
 def checkout(branch, base='main', create=False):
    ensure_git(); b=branch_name(branch)
-    if create or sh(['rev-parse','--verify',b])['code'] != 0:
-        sh(['checkout',base], True); sh(['checkout','-B',b], True)
-    else: sh(['checkout',b], True)
+    exists = sh(['rev-parse','--verify',f'refs/heads/{b}'])['code'] == 0
+    if exists:
+        sh(['checkout',b], True)
+    elif create:
+        sh(['checkout',base], True); sh(['checkout','-b',b], True)
+    else:
+        raise ValueError(f'branch does not exist: {b}')
    return b
 def write_file(path, content):
    if content_has_secret(content): raise ValueError('secret_rejected: use secret_ref; plaintext API keys must not enter Git')
@@ -121,6 +244,19 @@ def sync_branch(branch: str) -> dict:
    if not branch or branch in ('main','master') or branch.startswith('main/') or branch.startswith('master/'):
        return {'status':'skipped','reason':'protected_branch','branch':branch}
    if BARE_REPO.exists():
+        common = sh(['rev-parse', '--path-format=absolute', '--git-common-dir'], True)['stdout']
+        if Path(common).resolve() == BARE_REPO.resolve():
+            head = sh(['rev-parse', 'HEAD'], True)['stdout']
+            stored = subprocess.run(
+                ['git', '--git-dir', str(BARE_REPO), 'rev-parse', f'refs/heads/{branch}'],
+                text=True, capture_output=True,
+            )
+            if stored.returncode != 0 or stored.stdout.strip() != head:
+                raise RuntimeError(f'linked-worktree branch verification failed for {branch}')
+            return {
+                'status':'verified', 'target':'authoritative-bare',
+                'branch':branch, 'oid':head,
+            }
        ref=f'refs/heads/{branch}:refs/heads/{branch}'
        p=subprocess.run(['git','--git-dir',str(BARE_REPO),'fetch',str(WS),ref], text=True, capture_output=True)
        if p.returncode != 0: raise RuntimeError(p.stderr or p.stdout or f'git sync failed for {branch}')
@@ -130,15 +266,68 @@ def sync_branch(branch: str) -> dict:
    return {'status':'synced','target':'origin','branch':branch,'stdout':p.stdout.strip(),'stderr':p.stderr.strip()}

 def sync_tag(tag: str) -> dict:
-    if not tag: return {'status':'skipped','reason':'empty_tag'}
-    if BARE_REPO.exists():
-        ref=f'refs/tags/{tag}:refs/tags/{tag}'
-        p=subprocess.run(['git','--git-dir',str(BARE_REPO),'fetch',str(WS),ref], text=True, capture_output=True)
-        if p.returncode != 0: raise RuntimeError(p.stderr or p.stdout or f'git tag sync failed for {tag}')
-        return {'status':'synced','target':'bare','tag':tag,'stdout':p.stdout.strip(),'stderr':p.stderr.strip()}
-    p=subprocess.run(['git','push','origin',tag], cwd=str(WS), text=True, capture_output=True)
-    if p.returncode != 0: raise RuntimeError(p.stderr or p.stdout or f'git tag push failed for {tag}')
-    return {'status':'synced','target':'origin','tag':tag,'stdout':p.stdout.strip(),'stderr':p.stderr.strip()}
+    raise RuntimeError(
+        'unsafe sync_tag disabled: use TagPublisher with expected tag_oid, '
+        'target_oid, Gitea remote verification, and authenticated API verification'
+    )
+
+def resolve_commit_oid(value: str | None, field: str = 'target_oid') -> str:
+    oid = str(value or '').strip().lower()
+    if not re.fullmatch(r'[0-9a-f]{40}', oid):
+        raise ValueError(f'{field} must be a full 40-character commit OID')
+    try:
+        return authoritative_commit(oid, git_dir=AUTHORITATIVE_GIT_DIR)
+    except (AuthoritativeGitError, ValueError) as exc:
+        raise ValueError(f'{field} does not resolve to the exact approved commit') from exc
+
+def existing_tag_target(tag: str) -> str | None:
+    if not re.fullmatch(r'V\d+R\d+C\d+(?:-[A-Za-z0-9_.-]+)?$', str(tag or '')):
+        raise ValueError('invalid release version')
+    try:
+        result = run_authoritative_git(
+            ['rev-parse', '--verify', f'refs/tags/{tag}^{{commit}}'],
+            check=False,
+            git_dir=AUTHORITATIVE_GIT_DIR,
+        )
+    except AuthoritativeGitError as exc:
+        raise RuntimeError(str(exc)) from exc
+    return result.stdout.strip() if result.returncode == 0 else None
+
+def publication_request_from_query(q: dict[str, list[str]]) -> PublicationRequest:
+    required = ('version', 'target_oid', 'evidence_closure_oid', 'approval_plan_id')
+    missing = [name for name in required if not (q.get(name) or [''])[0]]
+    if missing:
+        raise ValueError('missing release governance fields: ' + ', '.join(missing))
+    return PublicationRequest(
+        (q['version'])[0],
+        (q['target_oid'])[0].lower(),
+        (q['evidence_closure_oid'])[0].lower(),
+        (q['approval_plan_id'])[0],
+    )
+
+def required_authoritative_git_dir() -> Path:
+    snapshot = repository_snapshot(
+        git_dir=AUTHORITATIVE_GIT_DIR,
+        repository_identity=REPOSITORY_IDENTITY,
+    )
+    if not snapshot["repository_available"]:
+        raise RuntimeError(str(snapshot["query_error"] or "AUTHORITATIVE_REPOSITORY_UNAVAILABLE"))
+    return Path(str(snapshot["authoritative_git_dir"]))
+
+
+def publication_publisher() -> TagPublisher:
+    authoritative_repo = required_authoritative_git_dir()
+    return TagPublisher(
+        WS,
+        GitTagBackend(WS, authoritative_repo=authoritative_repo),
+        GiteaTagClient(
+            os.getenv('AIOS_GITOPS_GITEA_API_URL',''),
+            os.getenv('AIOS_GITOPS_GITEA_REPOSITORY',''),
+            Path(os.getenv('AIOS_GITOPS_GITEA_TOKEN_FILE','')),
+            token_line=int(os.getenv('AIOS_GITOPS_GITEA_TOKEN_LINE','1')),
+        ),
+        os.getenv('AIOS_GITOPS_GITEA_REMOTE','gitea'),
+    )

 def commit(paths, msg):
    ensure_git(); paths = [relpath(p) for p in paths] if paths else ['.']; sh(['add'] + paths, True)
@@ -158,6 +347,16 @@ def patches():
    for p in sorted((WS/'patches').glob('**/*.json')): out.append(jload(p, {'path':str(p.relative_to(WS))}))
    return out

+def runtime_release_info() -> dict[str, Any]:
+    for candidate in (WS / 'manifest.json', WS.parent / 'manifest.json'):
+        data = jload(candidate, {})
+        if data.get('target_commit'):
+            return {
+                'runtime_release_commit': data.get('target_commit'),
+                'runtime_release_path': str(WS),
+            }
+    return {'runtime_release_commit': None, 'runtime_release_path': str(WS)}
+
 class H(BaseHTTPRequestHandler):
    server_version='AIOSChatGPTGitOps/V1R1C0'
    def sendj(self, data, code=200):
@@ -179,43 +378,221 @@ class H(BaseHTTPRequestHandler):
        if '*' not in a['scopes'] and scope not in a['scopes']: self.sendj({'error':'forbidden','required_scope':scope,'account':a['account']},403); return None
        return a
    def do_GET(self):
-        u=urllib.parse.urlparse(self.path); path=u.path.rstrip('/') if u.path != '/' else u.path; q=urllib.parse.parse_qs(u.query)
+        u=urllib.parse.urlparse(self.path); path=u.path.rstrip('/') if u.path != '/' else u.path
+        if path not in READ_ONLY_GET_PATHS: return self.sendj({'error':'not_found','path':path},404)
+        q=urllib.parse.parse_qs(u.query)
        try:
            if path in ('/health','/api/health'): return self.sendj({'status':'ok','service':'chatgpt-gitops-adapter','workspace':str(WS)})
            if path in ('/api/openapi.yaml','/api/openapi-chatgpt-actions.yaml','/api/schema'):
                return self.sendt(OPENAPI.read_text(encoding='utf-8'), 'application/yaml; charset=utf-8') if OPENAPI.exists() else self.sendj({'error':'schema_missing'},404)
            if path in ('/api','/api/status'): return self.sendj(api_spec())
            if path in ('/api/base','/api/baseline','/base'):
-                data=jload(WS/'baseline'/'current.json', {}); data.setdefault('git', sh(['rev-parse','--short','HEAD'])['stdout']); return self.sendj(data)
+                data=jload(WS/'baseline'/'current.json', {})
+                data.setdefault('authoritative_repository', repository_snapshot(
+                    git_dir=AUTHORITATIVE_GIT_DIR,
+                    repository_identity=REPOSITORY_IDENTITY,
+                ))
+                return self.sendj(data)
            if path in ('/api/ver','/api/versions','/ver'):
-                return self.sendj({'tags':sh(['tag','--list','V*'])['stdout'].splitlines(),'versions_dir':[p.name for p in (WS/'versions').glob('*')],'head':sh(['rev-parse','--short','HEAD'])['stdout']})
+                snapshot = repository_snapshot(
+                    git_dir=AUTHORITATIVE_GIT_DIR,
+                    repository_identity=REPOSITORY_IDENTITY,
+                )
+                if not snapshot['repository_available']:
+                    return self.sendj({
+                        'repository_available': False,
+                        'query_error': snapshot['query_error'],
+                        'registry_versions': [p.name for p in (WS/'versions').glob('*')],
+                        'local_authoritative_tags': [],
+                    }, 503)
+                try:
+                    tags = authoritative_tags(git_dir=AUTHORITATIVE_GIT_DIR)
+                except AuthoritativeGitError as exc:
+                    return self.sendj({
+                        'repository_available': False,
+                        'query_error': str(exc),
+                        'registry_versions': [p.name for p in (WS/'versions').glob('*')],
+                        'local_authoritative_tags': [],
+                    }, 503)
+                registry = [p.name for p in (WS/'versions').glob('*')]
+                return self.sendj({
+                    'registry_versions': registry,
+                    'local_authoritative_tags': tags,
+                    'repository_available': True,
+                    'query_error': None,
+                    'tags': [item['name'] for item in tags],
+                    'versions_dir': registry,
+                    'head': snapshot['authoritative_head_oid'],
+                    'authoritative_head_oid': snapshot['authoritative_head_oid'],
+                })
            if path in ('/api/diff','/diff'):
-                frm=(q.get('from') or ['HEAD~1'])[0]; to=(q.get('to') or ['HEAD'])[0]; return self.sendj({'from':frm,'to':to,'diff':sh(['diff',frm,to])})
-            if path in ('/api/patch','/api/patches','/api/branches','/patch'): return self.sendj({'patches':patches(),'branches':sh(['branch','--format','%(refname:short)'])['stdout'].splitlines()})
+                frm=(q.get('from') or [''])[0]
+                to=(q.get('to') or [''])[0]
+                try:
+                    diff=authoritative_diff(frm, to, git_dir=required_authoritative_git_dir())
+                except ValueError as exc:
+                    return self.sendj({'error':redact(exc)},400)
+                except AuthoritativeGitNotFound as exc:
+                    return self.sendj({'error':redact(exc)},404)
+                except AuthoritativeGitOutputTooLarge as exc:
+                    return self.sendj({'error':redact(exc)},413)
+                except (AuthoritativeGitError, RuntimeError) as exc:
+                    return self.sendj({'error':redact(exc)},503)
+                return self.sendj({'from':frm,'to':to,'diff':diff})
+            if path in ('/api/patch','/api/patches','/api/branches','/patch'):
+                snapshot = repository_snapshot(
+                    git_dir=AUTHORITATIVE_GIT_DIR,
+                    repository_identity=REPOSITORY_IDENTITY,
+                )
+                if not snapshot['repository_available']:
+                    return self.sendj({
+                        'repository_available': False,
+                        'query_error': snapshot['query_error'],
+                        'metadata_patches': patches(),
+                        'authoritative_branches': [],
+                    }, 503)
+                try:
+                    branches = authoritative_branches(git_dir=AUTHORITATIVE_GIT_DIR)
+                except AuthoritativeGitError as exc:
+                    return self.sendj({
+                        'repository_available': False,
+                        'query_error': str(exc),
+                        'metadata_patches': patches(),
+                        'authoritative_branches': [],
+                    }, 503)
+                metadata = patches()
+                branch_names = {item['name'] for item in branches}
+                metadata_names = {
+                    item.get('branch') for item in metadata
+                    if isinstance(item, dict) and item.get('branch')
+                }
+                orphan = [
+                    item for item in metadata
+                    if item.get('branch') and item.get('branch') not in branch_names
+                ]
+                missing = [
+                    item for item in branches
+                    if item['name'] not in metadata_names
+                ]
+                return self.sendj({
+                    'metadata_patches': metadata,
+                    'authoritative_branches': branches,
+                    'orphan_metadata': orphan,
+                    'branches_without_metadata': missing,
+                    'repository_available': True,
+                    'query_error': None,
+                    'patches': metadata,
+                    'branches': [item['name'] for item in branches],
+                })
            if path in ('/api/model','/model'): return self.sendj({'base':BASE_MODELS,'custom':model_docs(),'priority':[jload(p,{}) for p in sorted((WS/'config'/'model_priority').glob('*.json'))]})
            if path in ('/api/run','/api/runtime-status','/run'):
                svc=subprocess.run(['systemctl','is-active','aios-gitops-model-api'], text=True, capture_output=True)
-                return self.sendj({'service':'aios-gitops-model-api','status':svc.stdout.strip() or svc.stderr.strip(),'workspace_branch':sh(['rev-parse','--abbrev-ref','HEAD'])['stdout']})
+                snapshot = repository_snapshot(
+                    git_dir=AUTHORITATIVE_GIT_DIR,
+                    repository_identity=REPOSITORY_IDENTITY,
+                )
+                workspace_branch = None
+                if (WS / '.git').exists():
+                    result = sh(['rev-parse','--abbrev-ref','HEAD'])
+                    workspace_branch = result['stdout'] or None
+                payload = {
+                    'service':'aios-gitops-model-api',
+                    'status':svc.stdout.strip() or svc.stderr.strip(),
+                    'workspace_branch':workspace_branch,
+                    **runtime_release_info(),
+                    **snapshot,
+                    'writes_enabled': str(os.getenv('AIOS_GITOPS_WRITES_ENABLED','false')).lower() in {'1','true','yes','on'},
+                }
+                return self.sendj(payload, 200 if snapshot['repository_available'] else 503)
            if path in ('/api/action-monitor','/action-monitor'):
                latest=monitor.latest()
                ldict={'event_id':latest.event_id,'action':latest.action,'error':latest.error,'context':latest.context,'created_at':latest.created_at} if latest else None
                return self.sendj({'events':[{"event_id":e.event_id,"action":e.action,"error":e.error,"context":e.context,"created_at":e.created_at} for e in monitor.list_events()],'latest':ldict})
+            if path == '/api/tag-publication-status':
+                version=(q.get('version') or [''])[0]
+                try:
+                    version=validate_version(version)
+                    status=publication_publisher().get_tag_publication_status(version)
+                except ValueError:
+                    return self.sendj({'error':'invalid release version'},400)
+                return self.sendj(status)
+            if path == '/api/release-consistency':
+                request=publication_request_from_query(q)
+                return self.sendj(publication_publisher().get_release_consistency(request))
+            if path == '/api/release-acceptance':
+                request=publication_request_from_query(q)
+                return self.sendj(publication_publisher().run_release_acceptance(request))
+            if path in (
+                '/getReleaseCandidate',
+                '/getApprovalEnvelope',
+                '/getReleaseSaga',
+            ):
+                candidate_id=(q.get('candidate_id') or [''])[0]
+                if not candidate_id:
+                    return self.sendj({'error':'candidate_id is required'},400)
+                service=silent_release_service()
+                if path == '/getReleaseCandidate':
+                    return self.sendj(
+                        service.get_release_candidate(candidate_id)
+                    )
+                if path == '/getApprovalEnvelope':
+                    return self.sendj(
+                        service.get_approval_envelope(candidate_id)
+                    )
+                return self.sendj(service.get_release_saga(candidate_id))
                        # Admin AI Evolution Dashboard
            if path in ('/admin/ai-evolution','/admin/ai-evolution/'):
                return self.ai_evolution_page()
            if path in ('/admin/ai-evolution/api/data'):
                return self.ai_evolution_data()
            return self.sendj({'error':'not_found','path':path},404)
+        except FileNotFoundError:
+            return self.sendj({'error':'release candidate not found'},404)
+        except ValueError as e:
+            error=redact(e)
+            monitor.record_failure('do_GET', error, {'path':path})
+            return self.sendj({'error':error},400)
        except Exception as e:
-            monitor.record_failure('do_GET', str(e), {'path':path})
-            return self.sendj({'error':str(e)},500)
+            error=redact(e)
+            monitor.record_failure('do_GET', error, {'path':path})
+            return self.sendj({'error':error},500)
    def do_PUT(self):
-        path=urllib.parse.urlparse(self.path).path.rstrip('/'); data=self.body()
+        path=urllib.parse.urlparse(self.path).path.rstrip('/')
+        if reject_non_read_http(self, 'PUT', path): return
+        data=self.body()
        if path == '/api/model-priority': return self.model_priority(data)
        return self.sendj({'error':'not_found','path':path},404)
    def do_POST(self):
-        path=urllib.parse.urlparse(self.path).path.rstrip('/'); data=self.body()
+        path=urllib.parse.urlparse(self.path).path.rstrip('/')
+        if reject_non_read_http(self, 'POST', path): return
+        data=self.body()
        try:
+            if path == '/createReleaseCandidate':
+                a=self.need('release:candidate')
+                if not a: return
+                return self.sendj(
+                    silent_release_service().create_release_candidate(data)
+                )
+            if path == '/submitOwnerApproval':
+                a=self.need('release:approve')
+                if not a: return
+                return self.sendj(
+                    silent_release_service().submit_owner_approval(data)
+                )
+            if path == '/startDeployment':
+                a=self.need('release:deploy')
+                if not a: return
+                approval=(
+                    SignedReleasePlanApproval.from_dict(data['approval'])
+                    if isinstance(data.get('approval'), dict)
+                    else None
+                )
+                return self.sendj(
+                    silent_release_service().start_deployment(
+                        str(data.get('candidate_id') or ''),
+                        approval=approval,
+                    )
+                )
            if path in ('/api/branch','/api/create-branch'): return self.branch(data)
            if path in ('/api/file','/api/commit-file'): return self.file(data)
            if path == '/api/commit': return self.commit(data)
@@ -226,9 +603,30 @@ class H(BaseHTTPRequestHandler):
            if path == '/api/model-priority': return self.model_priority(data)
            if path == '/api/nl': return self.nl(data)
            return self.sendj({'error':'not_found','path':path},404)
+        except (ValueError, FileNotFoundError) as e:
+            error=redact(e)
+            monitor.record_failure('do_POST', error, {'path':path})
+            return self.sendj({'error':error},400)
+        except CapabilityAuthorizationError as e:
+            error=redact(e)
+            monitor.record_failure('do_POST', error, {'path':path})
+            return self.sendj({'error':error},403)
+        except SagaConflict as e:
+            error=redact(e)
+            monitor.record_failure('do_POST', error, {'path':path})
+            return self.sendj({'error':error},409)
        except Exception as e:
-            monitor.record_failure('do_POST', str(e), {'path':path})
-            return self.sendj({'error':str(e)},500)
+            error=redact(e)
+            monitor.record_failure('do_POST', error, {'path':path})
+            return self.sendj({'error':error},500)
+    def do_PATCH(self):
+        path=urllib.parse.urlparse(self.path).path.rstrip('/')
+        if reject_non_read_http(self, 'PATCH', path): return
+        return self.sendj({'error':'not_found','path':path},404)
+    def do_DELETE(self):
+        path=urllib.parse.urlparse(self.path).path.rstrip('/')
+        if reject_non_read_http(self, 'DELETE', path): return
+        return self.sendj({'error':'not_found','path':path},404)
    def branch(self,data):
        a=self.need('branch:create');
        if not a: return
@@ -252,12 +650,41 @@ class H(BaseHTTPRequestHandler):
        if not a: return
        ver=data.get('version') or data.get('tag')
        if not re.match(r'^V\d+R\d+C\d+(-[A-Za-z0-9_.-]+)?$', ver or ''): return self.sendj({'error':'version must match VxRxCx'},400)
-        if data.get('confirm') != True:
-            self.sendj({'status':'confirm_required','operation':'tag','hint':'This operation creates a Git tag. Confirm to proceed.','x-openai-isConsequential':True}, 428)
-            return
+        if not data.get('target_oid') or not data.get('evidence_closure_oid') or not data.get('approval_plan_id'):
+            return self.sendj({
+                'error':'production_tag_evidence_required',
+                'required':['version','target_oid','evidence_closure_oid','approval_plan_id'],
+            },400)
+        try:
+            target_oid=resolve_commit_oid(data.get('target_oid'))
+            evidence_oid=resolve_commit_oid(data.get('evidence_closure_oid'), 'evidence_closure_oid')
+        except ValueError as exc:
+            return self.sendj({'error':'invalid_tag_target','detail':str(exc)},400)
        if a['role'] != 'owner' or not data.get('execute'):
-            b=checkout(data.get('branch') or f'request/tag-{safe(ver)}', 'main', True); req={'version':ver,'requested_by':a['account'],'approval_required':True,'created_at':now()}; r=write_json(f'baseline/tag_requests/{safe(ver)}.json', req); c=commit([r], f'chore(chatgpt): request tag {ver}'); return self.sendj({'status':'approval_required','branch':b,'commit':c})
-        out=sh(['tag','-a',ver,'-m',data.get('message') or f'release {ver}'], True); self.sendj({'status':'tagged','version':ver,'git':out,'sync':sync_tag(ver)})
+            b=checkout(data.get('branch') or f'request/tag-{safe(ver)}', 'main', True); req={'version':ver,'target_oid':target_oid,'evidence_closure_oid':evidence_oid,'approval_plan_id':data.get('approval_plan_id'),'requested_by':a['account'],'approval_required':True,'created_at':now()}; r=write_json(f'baseline/tag_requests/{safe(ver)}.json', req); c=commit([r], f'chore(chatgpt): request tag {ver}'); return self.sendj({'status':'approval_required','branch':b,'request':req,'commit':c})
+        request=PublicationRequest(ver,target_oid,evidence_oid,str(data.get('approval_plan_id')))
+        main_before=sh(['rev-parse','refs/heads/main'], True)['stdout']
+        publisher=publication_publisher()
+        try:
+            publication=publisher.publish(request)
+        except PublicationManualOwnerReviewRequired as exc:
+            audit(a['account'],'tag_manual_owner_review_required',ver,{'target_oid':target_oid,'approval_plan_id':data.get('approval_plan_id'),'error':redact(exc)})
+            return self.sendj({'status':'MANUAL_OWNER_REVIEW_REQUIRED','error':redact(exc),'main_changed':False,'force_push':False},409)
+        except PublicationConflict as exc:
+            audit(a['account'],'tag_conflict',ver,{'target_oid':target_oid,'approval_plan_id':data.get('approval_plan_id'),'error':str(exc)})
+            return self.sendj({'status':'RECONCILIATION_REQUIRED','error':str(exc),'main_changed':False,'force_push':False},409)
+        except PublicationPending as exc:
+            audit(a['account'],'tag_pending',ver,{'target_oid':target_oid,'approval_plan_id':data.get('approval_plan_id'),'error':str(exc)})
+            return self.sendj({'status':'REMOTE_PUSH_PENDING','error':str(exc),'main_changed':False,'force_push':False},503)
+        except PublicationReconciliationRequired as exc:
+            audit(a['account'],'tag_reconciliation_required',ver,{'target_oid':target_oid,'approval_plan_id':data.get('approval_plan_id'),'error':str(exc)})
+            return self.sendj({'status':'RECONCILIATION_REQUIRED','error':str(exc),'main_changed':False,'force_push':False},502)
+        main_after=sh(['rev-parse','refs/heads/main'], True)['stdout']
+        if main_after != main_before:
+            raise RuntimeError('main changed during tag operation')
+        result={'status':publication['state'],'version':ver,'tag_name':ver,'tag_oid':publication['tag_oid'],'target_oid':target_oid,'expected_target_oid':target_oid,'evidence_closure_oid':evidence_oid,'approval_plan_id':data.get('approval_plan_id'),'workspace_head':sh(['rev-parse','HEAD'],True)['stdout'],'main_oid_before':main_before,'main_oid_after':main_after,'main_changed':False,'force_push':False,'publication':publication}
+        audit(a['account'],'tag',ver,result)
+        self.sendj(result)
    def rollback(self,data):
        a=self.need('rollback:request');
        if not a: return
@@ -352,7 +779,10 @@ return{vs,cmds,ar,cmd,cdet,tot,sok,sfail,runs,baseline,refreshMsg,loadCmd,selVer
        cmd_filter=(params.get('command') or [None])[0]
        bl=jload(WS/'baseline'/'current.json',{})
        current_ver=bl.get('current_baseline','V1R3C1')
-        tags=sh(['tag','--list','V*'])['stdout'].splitlines() if WS.exists() else []
+        try:
+            tags=[item['name'] for item in authoritative_tags(git_dir=required_authoritative_git_dir()) if str(item['name']).startswith('V')]
+        except (AuthoritativeGitError, RuntimeError) as exc:
+            return self.sendj({'error':redact(exc),'repository_available':False},503)
        versions=[]
        if (WS/'baseline'/'promotions').exists():
            for p in sorted((WS/'baseline'/'promotions').glob('*.json')):
@@ -390,9 +820,9 @@ return{vs,cmds,ar,cmd,cdet,tot,sok,sfail,runs,baseline,refreshMsg,loadCmd,selVer


 def api_spec():
-    return {'version':'V1R1C0-chatgpt-actions','openapi':'/api/openapi.yaml','read':['GET /api/base','GET /api/ver','GET /api/diff','GET /api/patch','GET /api/model','GET /api/run','GET /admin/ai-evolution'],'write':['POST /api/branch','POST /api/file','POST /api/commit','POST /api/patch','POST /api/tag','POST /api/rollback','POST /api/model','PUT /api/model-priority','POST /api/nl'],'policy':{'bearer_required_for_write':True,'direct_main_push':False,'delete_tag':False,'owner_approval_required_for_v_level':True,'api_keys_in_git':False,'git_secret_field':'secret_ref','online_git_sync':True}}
+    return {'version':'V1R1C0-chatgpt-actions','openapi':'/api/openapi.yaml','read':['GET /api/base','GET /api/ver','GET /api/diff','GET /api/patch','GET /api/model','GET /api/run','GET /getReleaseCandidate','GET /getApprovalEnvelope','GET /getReleaseSaga','GET /admin/ai-evolution'],'write':['POST /api/branch','POST /api/file','POST /api/commit','POST /api/patch','POST /api/tag','POST /api/rollback','POST /api/model','PUT /api/model-priority','POST /api/nl','POST /createReleaseCandidate','POST /submitOwnerApproval','POST /startDeployment'],'policy':{'bearer_required_for_write':True,'direct_main_push':False,'delete_tag':False,'owner_approval_required_for_v_level':True,'api_keys_in_git':False,'git_secret_field':'secret_ref','online_git_sync':True,'silent_release_execution_enabled':SILENT_RELEASE_EXECUTION_ENABLED,'silent_release_shadow_default':True}}

 def main():
    print(f'AIOS ChatGPT GitOps adapter listening on {HOST}:{PORT}')
    ThreadingHTTPServer((HOST,PORT), H).serve_forever()
-if __name__ == '__main__': main()
+if __name__ == '__main__': main()
@@ -0,0 +1,52 @@
+#!/usr/bin/env python3
+"""Fail-closed policy for in-process Git mutation handlers."""
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Mapping
+
+_TRUE = frozenset({"1", "true", "yes", "on"})
+
+
+@dataclass(frozen=True)
+class GitWriteDecision:
+    allowed: bool
+    status_code: int
+    error: str
+    reason: str
+    workspace: str
+
+    def payload(self) -> dict[str, str]:
+        return {
+            "status": "allowed" if self.allowed else "blocked",
+            "error": self.error,
+            "reason": self.reason,
+            "workspace": self.workspace,
+        }
+
+
+def _real(path: Path) -> Path:
+    return Path(os.path.realpath(os.path.abspath(str(path))))
+
+
+def evaluate_git_write(workspace: Path | str, env: Mapping[str, str] | None = None) -> GitWriteDecision:
+    values = os.environ if env is None else env
+    lexical = Path(os.path.abspath(str(workspace)))
+    canonical = _real(lexical)
+    shown = str(lexical)
+    if str(values.get("AIOS_GITOPS_WRITES_ENABLED", "false")).strip().lower() not in _TRUE:
+        return GitWriteDecision(False, 423, "gitops_writes_disabled", "AIOS_GITOPS_WRITES_ENABLED is false", shown)
+    if lexical != canonical:
+        return GitWriteDecision(False, 409, "workspace_symlink_forbidden", "workspace must be a canonical non-symlink path", shown)
+    controller = _real(Path(values.get("AIOS_GITOPS_CONTROLLER_PATH", "/data/aios-gitops/worktrees/controller")))
+    role = str(values.get("AIOS_GITOPS_WORKSPACE_ROLE", "")).strip().lower()
+    if canonical == controller or role == "runtime-anchor":
+        return GitWriteDecision(False, 423, "runtime_anchor_read_only", "controller/runtime-anchor is read-only", str(canonical))
+    writer_root = _real(Path(values.get("AIOS_GITOPS_APPROVED_WRITER_ROOT", "/data/aios-gitops/worktrees")))
+    try:
+        canonical.relative_to(writer_root)
+    except ValueError:
+        return GitWriteDecision(False, 409, "workspace_not_approved_writer", "workspace is outside the approved writer root", str(canonical))
+    return GitWriteDecision(True, 200, "", "approved isolated writer", str(canonical))
@@ -1,25 +0,0 @@
-"""AIOS-managed Hermes runtime boundary."""
-
-from .adapter import (
-    HermesAdapter,
-    HermesConflict,
-    HermesNotFound,
-    HermesRuntimeError,
-    InMemoryHermesStore,
-)
-from .contract import HermesHealth, HermesJob, HermesJobState, HermesResult
-from .worker import HermesWorker, WorkerRunResult
-
-__all__ = [
-    "HermesAdapter",
-    "HermesConflict",
-    "HermesHealth",
-    "HermesJob",
-    "HermesJobState",
-    "HermesNotFound",
-    "HermesResult",
-    "HermesRuntimeError",
-    "HermesWorker",
-    "InMemoryHermesStore",
-    "WorkerRunResult",
-]
@@ -1,437 +0,0 @@
-"""Tenant-partitioned Hermes queue and worker lease boundary."""
-from __future__ import annotations
-
-import hashlib
-import json
-import threading
-from dataclasses import replace
-from datetime import datetime, timedelta, timezone
-from typing import Iterable, Mapping
-
-from .contract import (
-    ALLOWED_TRANSITIONS,
-    TERMINAL_STATES,
-    HermesHealth,
-    HermesJob,
-    HermesJobState,
-    HermesResult,
-    utc_now,
-)
-
-
-class HermesRuntimeError(RuntimeError):
-    """Base Hermes runtime-boundary failure."""
-
-
-class HermesNotFound(HermesRuntimeError):
-    """A tenant-scoped job was not found."""
-
-
-class HermesConflict(HermesRuntimeError):
-    """A state, lease, idempotency, or revision conflict occurred."""
-
-
-class InMemoryHermesStore:
-    """Thread-safe reference store; production backends implement this contract."""
-
-    def __init__(self) -> None:
-        self.lock = threading.RLock()
-        self.jobs: dict[str, HermesJob] = {}
-        self.results: dict[str, HermesResult] = {}
-        self.idempotency: dict[tuple[str, str], tuple[str, str]] = {}
-        self.worker_heartbeats: dict[str, tuple[str, str | None]] = {}
-
-
-class HermesAdapter:
-    """Queue and reconcile Hermes jobs without owning AIOS policy."""
-
-    def __init__(
-        self,
-        store: InMemoryHermesStore | None = None,
-        *,
-        runtime_id: str = "hermes-runtime",
-        runtime_version: str = "v1",
-        default_lease_seconds: int = 60,
-    ) -> None:
-        if default_lease_seconds < 5:
-            raise ValueError("default_lease_seconds must be >= 5")
-        self.store = store or InMemoryHermesStore()
-        self.runtime_id = runtime_id
-        self.runtime_version = runtime_version
-        self.default_lease_seconds = int(default_lease_seconds)
-
-    @staticmethod
-    def _digest(job: HermesJob) -> str:
-        raw = json.dumps(
-            {
-                "tenant_id": job.tenant_id,
-                "cell_id": job.cell_id,
-                "profile_id": job.profile_id,
-                "task_id": job.task_id,
-                "trace_id": job.trace_id,
-                "action": job.action,
-                "payload": dict(job.payload),
-                "priority": job.priority,
-            },
-            ensure_ascii=False,
-            sort_keys=True,
-            separators=(",", ":"),
-            default=str,
-        ).encode("utf-8")
-        return hashlib.sha256(raw).hexdigest()
-
-    @staticmethod
-    def _parse(value: str | None) -> datetime | None:
-        if value is None:
-            return None
-        normalized = value[:-1] + "+00:00" if value.endswith("Z") else value
-        parsed = datetime.fromisoformat(normalized)
-        if parsed.tzinfo is None:
-            raise ValueError("timestamp must include timezone")
-        return parsed.astimezone(timezone.utc)
-
-    @staticmethod
-    def _format(value: datetime) -> str:
-        return value.astimezone(timezone.utc).isoformat().replace("+00:00", "Z")
-
-    @staticmethod
-    def _assert_tenant(job: HermesJob, tenant_id: str) -> None:
-        if job.tenant_id != tenant_id:
-            raise HermesNotFound("job not found")
-
-    def enqueue(self, job: HermesJob) -> HermesJob:
-        if job.state != HermesJobState.QUEUED or job.revision != 1:
-            raise HermesConflict("new job must be QUEUED at revision 1")
-        digest = self._digest(job)
-        idem_ref = (job.tenant_id, job.idempotency_key)
-        with self.store.lock:
-            existing = self.store.jobs.get(job.job_id)
-            if existing is not None:
-                if self._digest(existing) != digest:
-                    raise HermesConflict("job_id reused with different content")
-                return existing
-            prior = self.store.idempotency.get(idem_ref)
-            if prior is not None:
-                prior_id, prior_digest = prior
-                if prior_digest != digest:
-                    raise HermesConflict("idempotency key reused with different content")
-                return self.store.jobs[prior_id]
-            self.store.jobs[job.job_id] = job
-            self.store.idempotency[idem_ref] = (job.job_id, digest)
-            return job
-
-    def get(self, job_id: str, *, tenant_id: str) -> HermesJob:
-        with self.store.lock:
-            job = self.store.jobs.get(job_id)
-            if job is None:
-                raise HermesNotFound("job not found")
-            self._assert_tenant(job, tenant_id)
-            return job
-
-    def list_jobs(
-        self,
-        *,
-        tenant_id: str,
-        cell_id: str | None = None,
-        profile_id: str | None = None,
-        states: Iterable[HermesJobState | str] | None = None,
-    ) -> list[HermesJob]:
-        state_filter = {HermesJobState(item) for item in states} if states else None
-        with self.store.lock:
-            self._requeue_expired_locked()
-            jobs = [
-                job
-                for job in self.store.jobs.values()
-                if job.tenant_id == tenant_id
-                and (cell_id is None or job.cell_id == cell_id)
-                and (profile_id is None or job.profile_id == profile_id)
-                and (state_filter is None or job.state in state_filter)
-            ]
-        return sorted(jobs, key=lambda item: (item.priority, item.created_at, item.job_id))
-
-    def claim(
-        self,
-        *,
-        tenant_id: str,
-        cell_id: str,
-        profile_id: str,
-        worker_id: str,
-        lease_seconds: int | None = None,
-    ) -> HermesJob | None:
-        worker_id = str(worker_id or "").strip()
-        if not worker_id:
-            raise ValueError("worker_id is required")
-        duration = int(lease_seconds or self.default_lease_seconds)
-        if duration < 5:
-            raise ValueError("lease_seconds must be >= 5")
-        with self.store.lock:
-            self._requeue_expired_locked()
-            candidates = [
-                job
-                for job in self.store.jobs.values()
-                if job.tenant_id == tenant_id
-                and job.cell_id == cell_id
-                and job.profile_id == profile_id
-                and job.state == HermesJobState.QUEUED
-            ]
-            self.store.worker_heartbeats[worker_id] = (utc_now(), None)
-            if not candidates:
-                return None
-            current = sorted(
-                candidates,
-                key=lambda item: (item.priority, item.created_at, item.job_id),
-            )[0]
-            claimed = self._transition_locked(
-                current,
-                HermesJobState.CLAIMED,
-                assigned_worker_id=worker_id,
-                lease_expires_at=self._format(
-                    datetime.now(timezone.utc) + timedelta(seconds=duration)
-                ),
-            )
-            self.store.worker_heartbeats[worker_id] = (utc_now(), claimed.job_id)
-            return claimed
-
-    def start(
-        self,
-        job_id: str,
-        *,
-        tenant_id: str,
-        worker_id: str,
-        expected_revision: int | None = None,
-    ) -> HermesJob:
-        with self.store.lock:
-            current = self._owned_job_locked(job_id, tenant_id, worker_id)
-            self._assert_revision(current, expected_revision)
-            return self._transition_locked(current, HermesJobState.RUNNING)
-
-    def heartbeat(
-        self,
-        job_id: str,
-        *,
-        tenant_id: str,
-        worker_id: str,
-        lease_seconds: int | None = None,
-    ) -> HermesJob:
-        duration = int(lease_seconds or self.default_lease_seconds)
-        with self.store.lock:
-            current = self._owned_job_locked(job_id, tenant_id, worker_id)
-            if current.state not in {HermesJobState.CLAIMED, HermesJobState.RUNNING}:
-                raise HermesConflict("job does not accept heartbeat")
-            updated = replace(
-                current,
-                revision=current.revision + 1,
-                lease_expires_at=self._format(
-                    datetime.now(timezone.utc) + timedelta(seconds=duration)
-                ),
-                updated_at=utc_now(),
-            )
-            self.store.jobs[job_id] = updated
-            self.store.worker_heartbeats[worker_id] = (utc_now(), job_id)
-            return updated
-
-    def complete(
-        self,
-        job_id: str,
-        *,
-        tenant_id: str,
-        worker_id: str,
-        output: Mapping[str, object],
-        expected_revision: int | None = None,
-    ) -> HermesResult:
-        return self._finish(
-            job_id,
-            tenant_id=tenant_id,
-            worker_id=worker_id,
-            state=HermesJobState.COMPLETED,
-            output=output,
-            expected_revision=expected_revision,
-        )
-
-    def fail(
-        self,
-        job_id: str,
-        *,
-        tenant_id: str,
-        worker_id: str,
-        error: Mapping[str, object],
-        expected_revision: int | None = None,
-    ) -> HermesResult:
-        return self._finish(
-            job_id,
-            tenant_id=tenant_id,
-            worker_id=worker_id,
-            state=HermesJobState.FAILED,
-            error=error,
-            expected_revision=expected_revision,
-        )
-
-    def cancel(
-        self,
-        job_id: str,
-        *,
-        tenant_id: str,
-        expected_revision: int | None = None,
-    ) -> HermesResult:
-        with self.store.lock:
-            current = self.store.jobs.get(job_id)
-            if current is None:
-                raise HermesNotFound("job not found")
-            self._assert_tenant(current, tenant_id)
-            self._assert_revision(current, expected_revision)
-            if current.state in TERMINAL_STATES:
-                result = self.store.results.get(job_id)
-                if result is None:
-                    raise HermesConflict("terminal result missing")
-                return result
-            updated = self._transition_locked(current, HermesJobState.CANCELLED)
-            result = HermesResult(
-                job_id=updated.job_id,
-                tenant_id=updated.tenant_id,
-                task_id=updated.task_id,
-                trace_id=updated.trace_id,
-                state=HermesJobState.CANCELLED,
-                worker_id=updated.assigned_worker_id,
-                error={"code": "cancelled", "message": "cancelled by AIOS"},
-                finished_at=utc_now(),
-            )
-            self.store.results[job_id] = result
-            return result
-
-    def result(self, job_id: str, *, tenant_id: str) -> HermesResult:
-        with self.store.lock:
-            job = self.store.jobs.get(job_id)
-            if job is None:
-                raise HermesNotFound("job not found")
-            self._assert_tenant(job, tenant_id)
-            result = self.store.results.get(job_id)
-            if result is None:
-                raise HermesConflict("job has no terminal result")
-            return result
-
-    def health(self) -> HermesHealth:
-        with self.store.lock:
-            self._requeue_expired_locked()
-            active_jobs = sum(
-                1 for job in self.store.jobs.values()
-                if job.state in {HermesJobState.CLAIMED, HermesJobState.RUNNING}
-            )
-            queued_jobs = sum(
-                1 for job in self.store.jobs.values()
-                if job.state == HermesJobState.QUEUED
-            )
-            partitions = {
-                (job.tenant_id, job.cell_id, job.profile_id)
-                for job in self.store.jobs.values()
-            }
-            active_workers = sum(
-                1 for heartbeat, _ in self.store.worker_heartbeats.values()
-                if self._parse(heartbeat)
-                and self._parse(heartbeat) >= datetime.now(timezone.utc) - timedelta(seconds=120)
-            )
-        return HermesHealth(
-            runtime_id=self.runtime_id,
-            status="healthy",
-            version=self.runtime_version,
-            heartbeat_at=utc_now(),
-            active_workers=active_workers,
-            active_jobs=active_jobs,
-            queued_jobs=queued_jobs,
-            tenant_partitions=len(partitions),
-            profile_isolation_enforced=True,
-            details={"store": type(self.store).__name__},
-        )
-
-    def _finish(
-        self,
-        job_id: str,
-        *,
-        tenant_id: str,
-        worker_id: str,
-        state: HermesJobState,
-        output: Mapping[str, object] | None = None,
-        error: Mapping[str, object] | None = None,
-        expected_revision: int | None,
-    ) -> HermesResult:
-        with self.store.lock:
-            current = self._owned_job_locked(job_id, tenant_id, worker_id)
-            self._assert_revision(current, expected_revision)
-            updated = self._transition_locked(current, state)
-            result = HermesResult(
-                job_id=updated.job_id,
-                tenant_id=updated.tenant_id,
-                task_id=updated.task_id,
-                trace_id=updated.trace_id,
-                state=state,
-                worker_id=worker_id,
-                output=output,
-                error=error,
-                started_at=current.updated_at,
-                finished_at=utc_now(),
-            )
-            self.store.results[job_id] = result
-            self.store.worker_heartbeats[worker_id] = (utc_now(), None)
-            return result
-
-    def _owned_job_locked(self, job_id: str, tenant_id: str, worker_id: str) -> HermesJob:
-        current = self.store.jobs.get(job_id)
-        if current is None:
-            raise HermesNotFound("job not found")
-        self._assert_tenant(current, tenant_id)
-        if current.assigned_worker_id != worker_id:
-            raise HermesConflict("worker does not own job lease")
-        return current
-
-    @staticmethod
-    def _assert_revision(job: HermesJob, expected: int | None) -> None:
-        if expected is not None and job.revision != expected:
-            raise HermesConflict("job revision changed")
-
-    def _transition_locked(
-        self,
-        current: HermesJob,
-        target: HermesJobState,
-        *,
-        assigned_worker_id: str | None = None,
-        lease_expires_at: str | None = None,
-    ) -> HermesJob:
-        if target not in ALLOWED_TRANSITIONS[current.state]:
-            raise HermesConflict(
-                f"invalid transition {current.state.value} -> {target.value}"
-            )
-        updated = replace(
-            current,
-            state=target,
-            revision=current.revision + 1,
-            assigned_worker_id=(
-                assigned_worker_id
-                if assigned_worker_id is not None
-                else current.assigned_worker_id
-            ),
-            lease_expires_at=(
-                lease_expires_at
-                if lease_expires_at is not None
-                else (None if target in TERMINAL_STATES else current.lease_expires_at)
-            ),
-            updated_at=utc_now(),
-        )
-        self.store.jobs[current.job_id] = updated
-        return updated
-
-    def _requeue_expired_locked(self) -> None:
-        now = datetime.now(timezone.utc)
-        for current in list(self.store.jobs.values()):
-            expiry = self._parse(current.lease_expires_at)
-            if (
-                current.state in {HermesJobState.CLAIMED, HermesJobState.RUNNING}
-                and expiry is not None
-                and expiry <= now
-            ):
-                self.store.jobs[current.job_id] = replace(
-                    current,
-                    state=HermesJobState.QUEUED,
-                    revision=current.revision + 1,
-                    assigned_worker_id=None,
-                    lease_expires_at=None,
-                    updated_at=utc_now(),
-                )
@@ -1,153 +0,0 @@
-"""Tenant-scoped Hermes runtime contracts."""
-from __future__ import annotations
-
-import json
-import uuid
-from dataclasses import dataclass, field
-from datetime import datetime, timezone
-from enum import Enum
-from typing import Any, Mapping
-
-
-def utc_now() -> str:
-    return datetime.now(timezone.utc).isoformat().replace("+00:00", "Z")
-
-
-def _required(value: str, label: str) -> str:
-    normalized = str(value or "").strip()
-    if not normalized:
-        raise ValueError(f"{label} is required")
-    return normalized
-
-
-def _safe_mapping(value: Mapping[str, Any] | None) -> dict[str, Any]:
-    return json.loads(json.dumps(dict(value or {}), ensure_ascii=False, sort_keys=True, default=str))
-
-
-class HermesJobState(str, Enum):
-    QUEUED = "QUEUED"
-    CLAIMED = "CLAIMED"
-    RUNNING = "RUNNING"
-    COMPLETED = "COMPLETED"
-    FAILED = "FAILED"
-    CANCELLED = "CANCELLED"
-
-
-ALLOWED_TRANSITIONS: Mapping[HermesJobState, frozenset[HermesJobState]] = {
-    HermesJobState.QUEUED: frozenset({HermesJobState.CLAIMED, HermesJobState.CANCELLED}),
-    HermesJobState.CLAIMED: frozenset({HermesJobState.RUNNING, HermesJobState.CANCELLED}),
-    HermesJobState.RUNNING: frozenset(
-        {HermesJobState.COMPLETED, HermesJobState.FAILED, HermesJobState.CANCELLED}
-    ),
-    HermesJobState.COMPLETED: frozenset(),
-    HermesJobState.FAILED: frozenset(),
-    HermesJobState.CANCELLED: frozenset(),
-}
-TERMINAL_STATES = frozenset(
-    {HermesJobState.COMPLETED, HermesJobState.FAILED, HermesJobState.CANCELLED}
-)
-
-
-@dataclass(frozen=True)
-class HermesJob:
-    job_id: str
-    tenant_id: str
-    cell_id: str
-    profile_id: str
-    task_id: str
-    trace_id: str
-    action: str
-    payload: Mapping[str, Any] = field(default_factory=dict)
-    idempotency_key: str = ""
-    priority: int = 100
-    state: HermesJobState = HermesJobState.QUEUED
-    revision: int = 1
-    assigned_worker_id: str | None = None
-    lease_expires_at: str | None = None
-    created_at: str = field(default_factory=utc_now)
-    updated_at: str = field(default_factory=utc_now)
-
-    def __post_init__(self) -> None:
-        for name in (
-            "job_id", "tenant_id", "cell_id", "profile_id", "task_id",
-            "trace_id", "action", "idempotency_key", "created_at", "updated_at",
-        ):
-            object.__setattr__(self, name, _required(getattr(self, name), name))
-        object.__setattr__(self, "payload", _safe_mapping(self.payload))
-        object.__setattr__(self, "state", HermesJobState(self.state))
-        if not 0 <= int(self.priority) <= 1000:
-            raise ValueError("priority must be between 0 and 1000")
-        if self.revision < 1:
-            raise ValueError("revision must be >= 1")
-
-    @classmethod
-    def create(
-        cls,
-        *,
-        tenant_id: str,
-        cell_id: str,
-        profile_id: str,
-        task_id: str,
-        trace_id: str,
-        action: str,
-        payload: Mapping[str, Any] | None,
-        idempotency_key: str,
-        priority: int = 100,
-    ) -> "HermesJob":
-        return cls(
-            job_id=f"hermes_{uuid.uuid4().hex}",
-            tenant_id=tenant_id,
-            cell_id=cell_id,
-            profile_id=profile_id,
-            task_id=task_id,
-            trace_id=trace_id,
-            action=action,
-            payload=_safe_mapping(payload),
-            idempotency_key=idempotency_key,
-            priority=priority,
-        )
-
-
-@dataclass(frozen=True)
-class HermesResult:
-    job_id: str
-    tenant_id: str
-    task_id: str
-    trace_id: str
-    state: HermesJobState
-    worker_id: str | None = None
-    output: Mapping[str, Any] | None = None
-    error: Mapping[str, Any] | None = None
-    started_at: str | None = None
-    finished_at: str | None = None
-
-    def __post_init__(self) -> None:
-        for name in ("job_id", "tenant_id", "task_id", "trace_id"):
-            object.__setattr__(self, name, _required(getattr(self, name), name))
-        object.__setattr__(self, "state", HermesJobState(self.state))
-        if self.output is not None:
-            object.__setattr__(self, "output", _safe_mapping(self.output))
-        if self.error is not None:
-            object.__setattr__(self, "error", _safe_mapping(self.error))
-
-
-@dataclass(frozen=True)
-class HermesHealth:
-    runtime_id: str
-    status: str
-    version: str
-    heartbeat_at: str
-    active_workers: int = 0
-    active_jobs: int = 0
-    queued_jobs: int = 0
-    tenant_partitions: int = 0
-    profile_isolation_enforced: bool = True
-    details: Mapping[str, Any] = field(default_factory=dict)
-
-    def __post_init__(self) -> None:
-        for name in ("runtime_id", "status", "version", "heartbeat_at"):
-            object.__setattr__(self, name, _required(getattr(self, name), name))
-        for name in ("active_workers", "active_jobs", "queued_jobs", "tenant_partitions"):
-            if int(getattr(self, name)) < 0:
-                raise ValueError(f"{name} must be >= 0")
-        object.__setattr__(self, "details", _safe_mapping(self.details))
@@ -1,155 +0,0 @@
-"""Hermes worker loop with lease renewal and bounded recovery."""
-from __future__ import annotations
-
-import threading
-from dataclasses import dataclass
-from typing import Any, Callable, Mapping
-
-from .adapter import HermesAdapter, HermesConflict
-from .contract import HermesJob, HermesJobState
-
-
-JobHandler = Callable[[HermesJob], Mapping[str, Any]]
-
-
-@dataclass(frozen=True)
-class WorkerRunResult:
-    claimed: bool
-    job_id: str | None = None
-    state: str | None = None
-    error: str | None = None
-
-
-class HermesWorker:
-    """Poll one tenant/cell/profile partition and execute jobs safely."""
-
-    def __init__(
-        self,
-        adapter: HermesAdapter,
-        handler: JobHandler,
-        *,
-        worker_id: str,
-        tenant_id: str,
-        cell_id: str,
-        profile_id: str,
-        poll_seconds: float = 1.0,
-        heartbeat_seconds: float = 10.0,
-    ) -> None:
-        if poll_seconds <= 0 or heartbeat_seconds <= 0:
-            raise ValueError("poll_seconds and heartbeat_seconds must be positive")
-        for name, value in {
-            "worker_id": worker_id,
-            "tenant_id": tenant_id,
-            "cell_id": cell_id,
-            "profile_id": profile_id,
-        }.items():
-            if not str(value or "").strip():
-                raise ValueError(f"{name} is required")
-        self.adapter = adapter
-        self.handler = handler
-        self.worker_id = worker_id
-        self.tenant_id = tenant_id
-        self.cell_id = cell_id
-        self.profile_id = profile_id
-        self.poll_seconds = float(poll_seconds)
-        self.heartbeat_seconds = float(heartbeat_seconds)
-        self._stop = threading.Event()
-
-    def stop(self) -> None:
-        self._stop.set()
-
-    def run_once(self) -> WorkerRunResult:
-        job = self.adapter.claim(
-            tenant_id=self.tenant_id,
-            cell_id=self.cell_id,
-            profile_id=self.profile_id,
-            worker_id=self.worker_id,
-        )
-        if job is None:
-            return WorkerRunResult(claimed=False)
-
-        running = self.adapter.start(
-            job.job_id,
-            tenant_id=self.tenant_id,
-            worker_id=self.worker_id,
-            expected_revision=job.revision,
-        )
-
-        heartbeat_stop = threading.Event()
-        heartbeat_thread = threading.Thread(
-            target=self._heartbeat_loop,
-            args=(running.job_id, heartbeat_stop),
-            name=f"hermes-heartbeat-{self.worker_id}",
-            daemon=True,
-        )
-        heartbeat_thread.start()
-
-        output: Mapping[str, Any] | None = None
-        execution_error: Exception | None = None
-        try:
-            output = dict(self.handler(running))
-        except Exception as exc:  # runtime boundary: normalize below
-            execution_error = exc
-        finally:
-            # Stop the lease heartbeat before reading the final revision. This
-            # prevents a revision increment racing with complete/fail.
-            heartbeat_stop.set()
-            heartbeat_thread.join(timeout=max(self.heartbeat_seconds * 2, 1.0))
-
-        try:
-            current = self.adapter.get(running.job_id, tenant_id=self.tenant_id)
-            if execution_error is None:
-                result = self.adapter.complete(
-                    running.job_id,
-                    tenant_id=self.tenant_id,
-                    worker_id=self.worker_id,
-                    output=dict(output or {}),
-                    expected_revision=current.revision,
-                )
-                return WorkerRunResult(
-                    claimed=True,
-                    job_id=result.job_id,
-                    state=result.state.value,
-                )
-
-            result = self.adapter.fail(
-                running.job_id,
-                tenant_id=self.tenant_id,
-                worker_id=self.worker_id,
-                error={
-                    "code": "worker_error",
-                    "message": str(execution_error),
-                },
-                expected_revision=current.revision,
-            )
-            return WorkerRunResult(
-                claimed=True,
-                job_id=result.job_id,
-                state=result.state.value,
-                error=str(execution_error),
-            )
-        except HermesConflict as exc:
-            return WorkerRunResult(
-                claimed=True,
-                job_id=running.job_id,
-                state=HermesJobState.FAILED.value,
-                error=f"reconciliation_conflict: {exc}",
-            )
-
-    def run_forever(self) -> None:
-        while not self._stop.is_set():
-            result = self.run_once()
-            if not result.claimed:
-                self._stop.wait(self.poll_seconds)
-
-    def _heartbeat_loop(self, job_id: str, stop_event: threading.Event) -> None:
-        while not stop_event.wait(self.heartbeat_seconds):
-            try:
-                self.adapter.heartbeat(
-                    job_id,
-                    tenant_id=self.tenant_id,
-                    worker_id=self.worker_id,
-                )
-            except Exception:
-                stop_event.set()
-                return
@@ -1,37 +0,0 @@
-"""AIOS-managed OpenClaw execution adapter."""
-
-from .adapter import (
-    AdapterError,
-    CommandConflict,
-    CommandNotFound,
-    CommandRejected,
-    InMemoryCallbackSink,
-    OpenClawAdapter,
-)
-from .contract import (
-    CommandState,
-    OpenClawCommand,
-    OpenClawResult,
-    RuntimeHealth,
-    sign_command,
-    verify_command_signature,
-)
-from .transport import HTTPRuntimeTransport, InProcessRuntimeTransport, RuntimeTransport
-
-__all__ = [
-    "AdapterError",
-    "CommandConflict",
-    "CommandNotFound",
-    "CommandRejected",
-    "CommandState",
-    "HTTPRuntimeTransport",
-    "InMemoryCallbackSink",
-    "InProcessRuntimeTransport",
-    "OpenClawAdapter",
-    "OpenClawCommand",
-    "OpenClawResult",
-    "RuntimeHealth",
-    "RuntimeTransport",
-    "sign_command",
-    "verify_command_signature",
-]
@@ -1,228 +0,0 @@
-"""Signed, tenant-isolated execution adapter for OpenClaw runtimes."""
-from __future__ import annotations
-
-import threading
-from dataclasses import replace
-from typing import Callable, Mapping, Protocol
-
-from .contract import (
-    CommandState,
-    OpenClawCommand,
-    OpenClawResult,
-    RuntimeHealth,
-    utc_now,
-    verify_command_signature,
-)
-
-
-class AdapterError(RuntimeError):
-    """Base adapter failure."""
-
-
-class CommandRejected(AdapterError):
-    """A command failed signature or contract validation."""
-
-
-class CommandNotFound(AdapterError):
-    """A tenant-scoped command is not visible."""
-
-
-class CommandConflict(AdapterError):
-    """A command or idempotency key conflicts with an existing execution."""
-
-
-class RuntimeTransport(Protocol):
-    def execute(self, command: OpenClawCommand, timeout_seconds: float) -> OpenClawResult: ...
-    def cancel(self, command_id: str) -> bool: ...
-    def health(self) -> RuntimeHealth: ...
-
-
-class CallbackSink(Protocol):
-    def on_started(self, result: OpenClawResult) -> None: ...
-    def on_completed(self, result: OpenClawResult) -> None: ...
-    def on_failed(self, result: OpenClawResult) -> None: ...
-
-
-class InMemoryCallbackSink:
-    def __init__(self) -> None:
-        self._lock = threading.RLock()
-        self.started: list[OpenClawResult] = []
-        self.completed: list[OpenClawResult] = []
-        self.failed: list[OpenClawResult] = []
-
-    def on_started(self, result: OpenClawResult) -> None:
-        with self._lock:
-            self.started.append(result)
-
-    def on_completed(self, result: OpenClawResult) -> None:
-        with self._lock:
-            self.completed.append(result)
-
-    def on_failed(self, result: OpenClawResult) -> None:
-        with self._lock:
-            self.failed.append(result)
-
-
-SigningMaterialResolver = Callable[[str, str], bytes | str]
-
-
-class OpenClawAdapter:
-    """Verify, de-duplicate, execute, cancel and reconcile commands."""
-
-    def __init__(
-        self,
-        transport: RuntimeTransport,
-        signing_material_resolver: SigningMaterialResolver,
-        *,
-        callback_sink: CallbackSink | None = None,
-        default_timeout_seconds: float = 300.0,
-    ) -> None:
-        if default_timeout_seconds <= 0:
-            raise ValueError("default_timeout_seconds must be positive")
-        self.transport = transport
-        self.signing_material_resolver = signing_material_resolver
-        self.callback_sink = callback_sink or InMemoryCallbackSink()
-        self.default_timeout_seconds = float(default_timeout_seconds)
-        self._lock = threading.RLock()
-        self._commands: dict[str, OpenClawCommand] = {}
-        self._results: dict[str, OpenClawResult] = {}
-        self._idempotency: dict[tuple[str, str], tuple[str, str]] = {}
-
-    def _verify(self, command: OpenClawCommand) -> None:
-        try:
-            key_material = self.signing_material_resolver(command.tenant_id, command.key_id)
-        except Exception as exc:
-            raise CommandRejected("signing material unavailable") from exc
-        if not verify_command_signature(command, key_material):
-            raise CommandRejected("invalid or expired command signature")
-
-    @staticmethod
-    def _validate_result(command: OpenClawCommand, result: OpenClawResult) -> None:
-        if (
-            result.command_id != command.command_id
-            or result.tenant_id != command.tenant_id
-            or result.task_id != command.task_id
-            or result.trace_id != command.trace_id
-        ):
-            raise AdapterError("runtime returned mismatched command identity")
-        if result.state not in {
-            CommandState.COMPLETED,
-            CommandState.FAILED,
-            CommandState.CANCELLED,
-            CommandState.TIMED_OUT,
-        }:
-            raise AdapterError("runtime returned a non-terminal result")
-
-    def execute(
-        self,
-        command: OpenClawCommand,
-        *,
-        timeout_seconds: float | None = None,
-    ) -> OpenClawResult:
-        timeout = self.default_timeout_seconds if timeout_seconds is None else float(timeout_seconds)
-        if timeout <= 0:
-            raise ValueError("timeout_seconds must be positive")
-        self._verify(command)
-        digest = command.signature
-        idem_ref = (command.tenant_id, command.idempotency_key)
-
-        with self._lock:
-            prior_command = self._commands.get(command.command_id)
-            if prior_command is not None:
-                if prior_command.signature != command.signature:
-                    raise CommandConflict("command_id reused with different content")
-                return self._results[command.command_id]
-            prior_idem = self._idempotency.get(idem_ref)
-            if prior_idem is not None:
-                prior_id, prior_digest = prior_idem
-                if prior_digest != digest:
-                    raise CommandConflict("idempotency key reused with different content")
-                return self._results[prior_id]
-            running = OpenClawResult(
-                command_id=command.command_id,
-                tenant_id=command.tenant_id,
-                task_id=command.task_id,
-                trace_id=command.trace_id,
-                state=CommandState.RUNNING,
-                started_at=utc_now(),
-            )
-            self._commands[command.command_id] = command
-            self._results[command.command_id] = running
-            self._idempotency[idem_ref] = (command.command_id, digest)
-
-        self.callback_sink.on_started(running)
-        try:
-            result = self.transport.execute(command, timeout)
-            self._validate_result(command, result)
-        except TimeoutError as exc:
-            result = replace(
-                running,
-                state=CommandState.TIMED_OUT,
-                error={"code": "runtime_timeout", "message": str(exc) or "runtime timeout"},
-                finished_at=utc_now(),
-            )
-        except Exception as exc:
-            result = replace(
-                running,
-                state=CommandState.FAILED,
-                error={"code": "runtime_error", "message": str(exc)},
-                finished_at=utc_now(),
-            )
-
-        if result.started_at is None:
-            result = replace(result, started_at=running.started_at)
-        if result.finished_at is None:
-            result = replace(result, finished_at=utc_now())
-        with self._lock:
-            self._results[command.command_id] = result
-        if result.state == CommandState.COMPLETED:
-            self.callback_sink.on_completed(result)
-        else:
-            self.callback_sink.on_failed(result)
-        return result
-
-    def status(self, command_id: str, *, tenant_id: str) -> OpenClawResult:
-        with self._lock:
-            command = self._commands.get(command_id)
-            result = self._results.get(command_id)
-            if command is None or result is None or command.tenant_id != tenant_id:
-                raise CommandNotFound("command not found")
-            return result
-
-    def cancel(self, command_id: str, *, tenant_id: str) -> OpenClawResult:
-        with self._lock:
-            command = self._commands.get(command_id)
-            current = self._results.get(command_id)
-            if command is None or current is None or command.tenant_id != tenant_id:
-                raise CommandNotFound("command not found")
-            if current.state in {
-                CommandState.COMPLETED,
-                CommandState.FAILED,
-                CommandState.CANCELLED,
-                CommandState.TIMED_OUT,
-                CommandState.REJECTED,
-            }:
-                return current
-        if not self.transport.cancel(command_id):
-            raise AdapterError("runtime rejected cancellation")
-        cancelled = replace(
-            current,
-            state=CommandState.CANCELLED,
-            error={"code": "cancelled", "message": "cancelled by AIOS"},
-            finished_at=utc_now(),
-        )
-        with self._lock:
-            self._results[command_id] = cancelled
-        self.callback_sink.on_failed(cancelled)
-        return cancelled
-
-    def health(self) -> RuntimeHealth:
-        return self.transport.health()
-
-    def snapshot(self, *, tenant_id: str) -> Mapping[str, OpenClawResult]:
-        with self._lock:
-            return {
-                command_id: result
-                for command_id, result in self._results.items()
-                if self._commands[command_id].tenant_id == tenant_id
-            }
@@ -1,97 +0,0 @@
-"""Audit-oriented lifecycle callbacks for OpenClaw execution."""
-from __future__ import annotations
-
-import json
-import threading
-from dataclasses import dataclass, field
-from typing import Any, Mapping, Protocol
-
-from .contract import OpenClawResult, utc_now
-
-
-class EventPublisher(Protocol):
-    def publish(self, event: Mapping[str, Any]) -> None: ...
-
-
-@dataclass(frozen=True)
-class ExecutionEvent:
-    event_type: str
-    tenant_id: str
-    task_id: str
-    trace_id: str
-    command_id: str
-    state: str
-    created_at: str = field(default_factory=utc_now)
-    details: Mapping[str, Any] = field(default_factory=dict)
-
-    def as_dict(self) -> dict[str, Any]:
-        return {
-            "event_type": self.event_type,
-            "tenant_id": self.tenant_id,
-            "task_id": self.task_id,
-            "trace_id": self.trace_id,
-            "command_id": self.command_id,
-            "state": self.state,
-            "created_at": self.created_at,
-            "details": json.loads(
-                json.dumps(dict(self.details), ensure_ascii=False, default=str)
-            ),
-        }
-
-
-class InMemoryEventPublisher:
-    """Thread-safe publisher used by tests and first integration slice."""
-
-    def __init__(self) -> None:
-        self._lock = threading.RLock()
-        self.events: list[dict[str, Any]] = []
-
-    def publish(self, event: Mapping[str, Any]) -> None:
-        with self._lock:
-            self.events.append(
-                json.loads(json.dumps(dict(event), ensure_ascii=False, default=str))
-            )
-
-
-class AuditCallbackSink:
-    """Convert runtime callbacks into tenant-scoped audit events."""
-
-    def __init__(self, publisher: EventPublisher) -> None:
-        self.publisher = publisher
-
-    @staticmethod
-    def _event(
-        event_type: str,
-        result: OpenClawResult,
-    ) -> ExecutionEvent:
-        details: dict[str, Any] = {
-            "runtime_id": result.runtime_id,
-            "attempts": result.attempts,
-        }
-        if result.error:
-            details["error"] = dict(result.error)
-        if result.output:
-            details["output_present"] = True
-        return ExecutionEvent(
-            event_type=event_type,
-            tenant_id=result.tenant_id,
-            task_id=result.task_id,
-            trace_id=result.trace_id,
-            command_id=result.command_id,
-            state=result.state.value,
-            details=details,
-        )
-
-    def on_started(self, result: OpenClawResult) -> None:
-        self.publisher.publish(self._event("OPENCLAW_STARTED", result).as_dict())
-
-    def on_completed(self, result: OpenClawResult) -> None:
-        self.publisher.publish(self._event("OPENCLAW_COMPLETED", result).as_dict())
-
-    def on_failed(self, result: OpenClawResult) -> None:
-        event_type = {
-            "CANCELLED": "OPENCLAW_CANCELLED",
-            "TIMED_OUT": "OPENCLAW_TIMED_OUT",
-            "REJECTED": "OPENCLAW_REJECTED",
-        }.get(result.state.value, "OPENCLAW_FAILED")
-        self.publisher.publish(self._event(event_type, result).as_dict())
@@ -1,213 +0,0 @@
-"""Versioned AIOS to OpenClaw execution contracts."""
-from __future__ import annotations
-
-import hashlib
-import hmac
-import json
-import uuid
-from dataclasses import dataclass, field, replace
-from datetime import datetime, timezone
-from enum import Enum
-from typing import Any, Mapping
-
-CONTRACT_VERSION = "aios.openclaw.command.v1"
-DEFAULT_CLOCK_SKEW_SECONDS = 300
-
-
-def utc_now() -> str:
-    return datetime.now(timezone.utc).isoformat().replace("+00:00", "Z")
-
-
-def _parse_timestamp(value: str) -> datetime:
-    normalized = str(value or "").strip()
-    if not normalized:
-        raise ValueError("timestamp is required")
-    if normalized.endswith("Z"):
-        normalized = normalized[:-1] + "+00:00"
-    parsed = datetime.fromisoformat(normalized)
-    if parsed.tzinfo is None:
-        raise ValueError("timestamp must include a timezone")
-    return parsed.astimezone(timezone.utc)
-
-
-def _required(value: str, label: str) -> str:
-    normalized = str(value or "").strip()
-    if not normalized:
-        raise ValueError(f"{label} is required")
-    return normalized
-
-
-def _safe_mapping(value: Mapping[str, Any] | None) -> dict[str, Any]:
-    return json.loads(json.dumps(dict(value or {}), ensure_ascii=False, sort_keys=True, default=str))
-
-
-class CommandState(str, Enum):
-    ACCEPTED = "ACCEPTED"
-    RUNNING = "RUNNING"
-    COMPLETED = "COMPLETED"
-    FAILED = "FAILED"
-    CANCELLED = "CANCELLED"
-    TIMED_OUT = "TIMED_OUT"
-    REJECTED = "REJECTED"
-
-
-@dataclass(frozen=True)
-class OpenClawCommand:
-    command_id: str
-    tenant_id: str
-    task_id: str
-    trace_id: str
-    action: str
-    payload: Mapping[str, Any] = field(default_factory=dict)
-    idempotency_key: str = ""
-    created_at: str = field(default_factory=utc_now)
-    expires_at: str | None = None
-    contract_version: str = CONTRACT_VERSION
-    key_id: str = "default"
-    signature: str = ""
-
-    def __post_init__(self) -> None:
-        for field_name in (
-            "command_id", "tenant_id", "task_id", "trace_id", "action",
-            "idempotency_key", "created_at", "contract_version", "key_id",
-        ):
-            object.__setattr__(self, field_name, _required(getattr(self, field_name), field_name))
-        if self.contract_version != CONTRACT_VERSION:
-            raise ValueError(f"unsupported contract_version: {self.contract_version}")
-        object.__setattr__(self, "payload", _safe_mapping(self.payload))
-        _parse_timestamp(self.created_at)
-        if self.expires_at is not None:
-            object.__setattr__(self, "expires_at", _required(self.expires_at, "expires_at"))
-            _parse_timestamp(self.expires_at)
-
-    @classmethod
-    def create(
-        cls,
-        *,
-        tenant_id: str,
-        task_id: str,
-        trace_id: str,
-        action: str,
-        payload: Mapping[str, Any] | None,
-        idempotency_key: str,
-        expires_at: str | None = None,
-        key_id: str = "default",
-        command_id: str | None = None,
-    ) -> "OpenClawCommand":
-        return cls(
-            command_id=command_id or f"cmd_{uuid.uuid4().hex}",
-            tenant_id=tenant_id,
-            task_id=task_id,
-            trace_id=trace_id,
-            action=action,
-            payload=_safe_mapping(payload),
-            idempotency_key=idempotency_key,
-            expires_at=expires_at,
-            key_id=key_id,
-        )
-
-    def unsigned_dict(self) -> dict[str, Any]:
-        return {
-            "command_id": self.command_id,
-            "tenant_id": self.tenant_id,
-            "task_id": self.task_id,
-            "trace_id": self.trace_id,
-            "action": self.action,
-            "payload": _safe_mapping(self.payload),
-            "idempotency_key": self.idempotency_key,
-            "created_at": self.created_at,
-            "expires_at": self.expires_at,
-            "contract_version": self.contract_version,
-            "key_id": self.key_id,
-        }
-
-
-@dataclass(frozen=True)
-class OpenClawResult:
-    command_id: str
-    tenant_id: str
-    task_id: str
-    trace_id: str
-    state: CommandState
-    output: Mapping[str, Any] | None = None
-    error: Mapping[str, Any] | None = None
-    started_at: str | None = None
-    finished_at: str | None = None
-    runtime_id: str | None = None
-    attempts: int = 1
-
-    def __post_init__(self) -> None:
-        for field_name in ("command_id", "tenant_id", "task_id", "trace_id"):
-            object.__setattr__(self, field_name, _required(getattr(self, field_name), field_name))
-        object.__setattr__(self, "state", CommandState(self.state))
-        if self.output is not None:
-            object.__setattr__(self, "output", _safe_mapping(self.output))
-        if self.error is not None:
-            object.__setattr__(self, "error", _safe_mapping(self.error))
-        if self.started_at is not None:
-            _parse_timestamp(self.started_at)
-        if self.finished_at is not None:
-            _parse_timestamp(self.finished_at)
-        if self.attempts < 1:
-            raise ValueError("attempts must be >= 1")
-
-
-@dataclass(frozen=True)
-class RuntimeHealth:
-    runtime: str
-    runtime_id: str
-    status: str
-    version: str
-    heartbeat_at: str
-    active_tasks: int = 0
-    workspace_isolated: bool = False
-    credential_ref_configured: bool = False
-    details: Mapping[str, Any] = field(default_factory=dict)
-
-    def __post_init__(self) -> None:
-        for field_name in ("runtime", "runtime_id", "status", "version", "heartbeat_at"):
-            object.__setattr__(self, field_name, _required(getattr(self, field_name), field_name))
-        _parse_timestamp(self.heartbeat_at)
-        if self.active_tasks < 0:
-            raise ValueError("active_tasks must be >= 0")
-        object.__setattr__(self, "details", _safe_mapping(self.details))
-
-
-def canonical_command_bytes(command: OpenClawCommand) -> bytes:
-    return json.dumps(
-        command.unsigned_dict(), ensure_ascii=False, sort_keys=True, separators=(",", ":")
-    ).encode("utf-8")
-
-
-def sign_command(command: OpenClawCommand, key_material: bytes | str) -> OpenClawCommand:
-    key = key_material.encode("utf-8") if isinstance(key_material, str) else bytes(key_material)
-    if not key:
-        raise ValueError("signing material is required")
-    signature = hmac.new(key, canonical_command_bytes(command), hashlib.sha256).hexdigest()
-    return replace(command, signature=signature)
-
-
-def verify_command_signature(
-    command: OpenClawCommand,
-    key_material: bytes | str,
-    *,
-    now: datetime | None = None,
-    clock_skew_seconds: int = DEFAULT_CLOCK_SKEW_SECONDS,
-) -> bool:
-    if not command.signature:
-        return False
-    key = key_material.encode("utf-8") if isinstance(key_material, str) else bytes(key_material)
-    if not key:
-        return False
-    expected = hmac.new(key, canonical_command_bytes(command), hashlib.sha256).hexdigest()
-    if not hmac.compare_digest(expected, command.signature):
-        return False
-    current = (now or datetime.now(timezone.utc)).astimezone(timezone.utc)
-    created = _parse_timestamp(command.created_at)
-    if created.timestamp() - current.timestamp() > clock_skew_seconds:
-        return False
-    if command.expires_at is not None:
-        expires = _parse_timestamp(command.expires_at)
-        if current.timestamp() - expires.timestamp() > clock_skew_seconds:
-            return False
-    return True
@@ -1,103 +0,0 @@
-"""Health policy and self-healing decisions for OpenClaw runtimes."""
-from __future__ import annotations
-
-from dataclasses import dataclass, field
-from datetime import datetime, timezone
-from typing import Mapping
-
-from .contract import RuntimeHealth
-
-
-def _parse(value: str) -> datetime:
-    normalized = value[:-1] + "+00:00" if value.endswith("Z") else value
-    parsed = datetime.fromisoformat(normalized)
-    if parsed.tzinfo is None:
-        raise ValueError("heartbeat timestamp must include timezone")
-    return parsed.astimezone(timezone.utc)
-
-
-@dataclass(frozen=True)
-class HealthPolicy:
-    max_heartbeat_age_seconds: int = 90
-    require_workspace_isolation: bool = True
-    require_credential_ref: bool = True
-    accepted_statuses: frozenset[str] = field(
-        default_factory=lambda: frozenset({"healthy", "ready"})
-    )
-
-    def __post_init__(self) -> None:
-        if self.max_heartbeat_age_seconds < 5:
-            raise ValueError("max_heartbeat_age_seconds must be >= 5")
-        if not self.accepted_statuses:
-            raise ValueError("accepted_statuses must not be empty")
-
-
-@dataclass(frozen=True)
-class HealthAssessment:
-    healthy: bool
-    reasons: tuple[str, ...]
-    recoverable: bool
-    recommended_action: str
-    details: Mapping[str, object] = field(default_factory=dict)
-
-
-class RuntimeHealthMonitor:
-    """Evaluate runtime health and recommend bounded recovery actions."""
-
-    def __init__(self, policy: HealthPolicy | None = None) -> None:
-        self.policy = policy or HealthPolicy()
-
-    def assess(
-        self,
-        health: RuntimeHealth,
-        *,
-        now: datetime | None = None,
-    ) -> HealthAssessment:
-        current = (now or datetime.now(timezone.utc)).astimezone(timezone.utc)
-        heartbeat = _parse(health.heartbeat_at)
-        age = max(0.0, current.timestamp() - heartbeat.timestamp())
-        reasons: list[str] = []
-
-        if health.status.lower() not in self.policy.accepted_statuses:
-            reasons.append("runtime_status_unhealthy")
-        if age > self.policy.max_heartbeat_age_seconds:
-            reasons.append("heartbeat_stale")
-        if self.policy.require_workspace_isolation and not health.workspace_isolated:
-            reasons.append("workspace_not_isolated")
-        if self.policy.require_credential_ref and not health.credential_ref_configured:
-            reasons.append("credential_reference_missing")
-
-        if not reasons:
-            return HealthAssessment(
-                healthy=True,
-                reasons=(),
-                recoverable=True,
-                recommended_action="none",
-                details={"heartbeat_age_seconds": age},
-            )
-
-        non_recoverable = {
-            "workspace_not_isolated",
-            "credential_reference_missing",
-        }.intersection(reasons)
-        if non_recoverable:
-            action = "quarantine_runtime"
-            recoverable = False
-        elif "heartbeat_stale" in reasons:
-            action = "restart_runtime"
-            recoverable = True
-        else:
-            action = "drain_and_restart"
-            recoverable = True
-
-        return HealthAssessment(
-            healthy=False,
-            reasons=tuple(reasons),
-            recoverable=recoverable,
-            recommended_action=action,
-            details={
-                "heartbeat_age_seconds": age,
-                "runtime_id": health.runtime_id,
-                "active_tasks": health.active_tasks,
-            },
-        )
@@ -1,214 +0,0 @@
-"""Runtime transport implementations for the OpenClaw adapter."""
-from __future__ import annotations
-
-import json
-import threading
-import urllib.error
-import urllib.parse
-import urllib.request
-from typing import Any, Callable, Mapping, Protocol
-
-from .contract import (
-    CommandState,
-    OpenClawCommand,
-    OpenClawResult,
-    RuntimeHealth,
-    utc_now,
-)
-
-
-class RuntimeTransport(Protocol):
-    def execute(self, command: OpenClawCommand, timeout_seconds: float) -> OpenClawResult: ...
-    def cancel(self, command_id: str) -> bool: ...
-    def health(self) -> RuntimeHealth: ...
-
-
-class TransportError(RuntimeError):
-    """Runtime transport or protocol failure."""
-
-
-RuntimeHandler = Callable[[OpenClawCommand], Mapping[str, Any] | OpenClawResult]
-
-
-class InProcessRuntimeTransport:
-    """Deterministic runtime used by tests and controlled local integrations."""
-
-    def __init__(
-        self,
-        handler: RuntimeHandler,
-        *,
-        runtime_id: str = "openclaw-in-process",
-        version: str = "v1",
-        workspace_isolated: bool = True,
-        credential_ref_configured: bool = True,
-    ) -> None:
-        self.handler = handler
-        self.runtime_id = runtime_id
-        self.version = version
-        self.workspace_isolated = workspace_isolated
-        self.credential_ref_configured = credential_ref_configured
-        self._lock = threading.RLock()
-        self._running: set[str] = set()
-        self._cancelled: set[str] = set()
-
-    def execute(self, command: OpenClawCommand, timeout_seconds: float) -> OpenClawResult:
-        if timeout_seconds <= 0:
-            raise ValueError("timeout_seconds must be positive")
-        with self._lock:
-            if command.command_id in self._cancelled:
-                return OpenClawResult(
-                    command_id=command.command_id,
-                    tenant_id=command.tenant_id,
-                    task_id=command.task_id,
-                    trace_id=command.trace_id,
-                    state=CommandState.CANCELLED,
-                    error={"code": "cancelled", "message": "cancelled before execution"},
-                    finished_at=utc_now(),
-                    runtime_id=self.runtime_id,
-                )
-            self._running.add(command.command_id)
-        try:
-            raw = self.handler(command)
-            if isinstance(raw, OpenClawResult):
-                return raw
-            if not isinstance(raw, Mapping):
-                raise TransportError("runtime handler must return a mapping or OpenClawResult")
-            return OpenClawResult(
-                command_id=command.command_id,
-                tenant_id=command.tenant_id,
-                task_id=command.task_id,
-                trace_id=command.trace_id,
-                state=CommandState(str(raw.get("state", "COMPLETED"))),
-                output=raw.get("output"),
-                error=raw.get("error"),
-                started_at=str(raw.get("started_at") or utc_now()),
-                finished_at=str(raw.get("finished_at") or utc_now()),
-                runtime_id=str(raw.get("runtime_id") or self.runtime_id),
-                attempts=int(raw.get("attempts", 1)),
-            )
-        finally:
-            with self._lock:
-                self._running.discard(command.command_id)
-
-    def cancel(self, command_id: str) -> bool:
-        with self._lock:
-            self._cancelled.add(command_id)
-            return command_id in self._running
-
-    def health(self) -> RuntimeHealth:
-        with self._lock:
-            active = len(self._running)
-        return RuntimeHealth(
-            runtime="openclaw",
-            runtime_id=self.runtime_id,
-            status="healthy",
-            version=self.version,
-            heartbeat_at=utc_now(),
-            active_tasks=active,
-            workspace_isolated=self.workspace_isolated,
-            credential_ref_configured=self.credential_ref_configured,
-            details={"transport": "in_process"},
-        )
-
-
-class HTTPRuntimeTransport:
-    """Private HTTP transport for an OpenClaw runtime service."""
-
-    def __init__(
-        self,
-        base_url: str,
-        *,
-        runtime_id: str = "openclaw-http",
-        credential_ref: str | None = None,
-        max_response_bytes: int = 2_097_152,
-    ) -> None:
-        normalized = str(base_url).rstrip("/")
-        if not normalized.startswith(("http://", "https://")):
-            raise ValueError("base_url must use http or https")
-        self.base_url = normalized
-        self.runtime_id = runtime_id
-        self.credential_ref = credential_ref
-        self.max_response_bytes = int(max_response_bytes)
-
-    def _request(
-        self,
-        method: str,
-        path: str,
-        *,
-        payload: Mapping[str, Any] | None,
-        timeout_seconds: float,
-    ) -> Mapping[str, Any]:
-        body = None
-        headers = {"Accept": "application/json", "User-Agent": "AIOS-OpenClaw/1"}
-        if payload is not None:
-            body = json.dumps(dict(payload), separators=(",", ":")).encode("utf-8")
-            headers["Content-Type"] = "application/json"
-        if self.credential_ref:
-            headers["X-AIOS-Credential-Ref"] = self.credential_ref
-        request = urllib.request.Request(
-            f"{self.base_url}{path}",
-            data=body,
-            method=method,
-            headers=headers,
-        )
-        try:
-            with urllib.request.urlopen(request, timeout=timeout_seconds) as response:
-                raw = response.read(self.max_response_bytes + 1)
-        except urllib.error.HTTPError as exc:
-            raise TransportError(f"runtime returned HTTP {exc.code}") from exc
-        except urllib.error.URLError as exc:
-            raise TransportError(f"runtime unavailable: {exc.reason}") from exc
-        if len(raw) > self.max_response_bytes:
-            raise TransportError("runtime response exceeded size limit")
-        decoded = json.loads(raw.decode("utf-8"))
-        if not isinstance(decoded, Mapping):
-            raise TransportError("runtime response must be a JSON object")
-        return decoded
-
-    @staticmethod
-    def _command_payload(command: OpenClawCommand) -> dict[str, Any]:
-        return {**command.unsigned_dict(), "signature": command.signature}
-
-    def execute(self, command: OpenClawCommand, timeout_seconds: float) -> OpenClawResult:
-        value = self._request(
-            "POST",
-            "/v1/execute",
-            payload=self._command_payload(command),
-            timeout_seconds=timeout_seconds,
-        )
-        return OpenClawResult(
-            command_id=str(value["command_id"]),
-            tenant_id=str(value["tenant_id"]),
-            task_id=str(value["task_id"]),
-            trace_id=str(value["trace_id"]),
-            state=CommandState(str(value["state"])),
-            output=value.get("output"),
-            error=value.get("error"),
-            started_at=value.get("started_at"),
-            finished_at=value.get("finished_at"),
-            runtime_id=str(value.get("runtime_id") or self.runtime_id),
-            attempts=int(value.get("attempts", 1)),
-        )
-
-    def cancel(self, command_id: str) -> bool:
-        value = self._request(
-            "POST",
-            f"/v1/commands/{urllib.parse.quote(command_id, safe='')}/cancel",
-            payload={},
-            timeout_seconds=10.0,
-        )
-        return bool(value.get("accepted"))
-
-    def health(self) -> RuntimeHealth:
-        value = self._request("GET", "/v1/health", payload=None, timeout_seconds=5.0)
-        return RuntimeHealth(
-            runtime=str(value.get("runtime") or "openclaw"),
-            runtime_id=str(value.get("runtime_id") or self.runtime_id),
-            status=str(value.get("status") or "unknown"),
-            version=str(value.get("version") or "unknown"),
-            heartbeat_at=str(value.get("heartbeat_at") or utc_now()),
-            active_tasks=int(value.get("active_tasks", 0)),
-            workspace_isolated=bool(value.get("workspace_isolated", False)),
-            credential_ref_configured=bool(value.get("credential_ref_configured", False)),
-            details=value.get("details") if isinstance(value.get("details"), Mapping) else {},
-        )
@@ -1,46 +0,0 @@
-"""AIOS V2 control plane and execution orchestration."""
-
-from .control_plane import (
-    AgentRecord,
-    AuditEvent,
-    ControlPlaneError,
-    ControlPlaneService,
-    IdempotencyConflict,
-    InMemoryControlPlaneStore,
-    InvalidTransition,
-    NotFound,
-    PolicyDenied,
-    RequestContext,
-    RevisionConflict,
-    TaskRecord,
-    TaskState,
-    TenantIsolationError,
-    TenantRecord,
-    Unauthorized,
-)
-from .execution_tracking import ExecutionEvidence, ExecutionTracker
-from .orchestrator import DispatchRecord, ExecutionOrchestrator, OrchestrationError
-
-__all__ = [
-    "AgentRecord",
-    "AuditEvent",
-    "ControlPlaneError",
-    "ControlPlaneService",
-    "DispatchRecord",
-    "ExecutionEvidence",
-    "ExecutionOrchestrator",
-    "ExecutionTracker",
-    "IdempotencyConflict",
-    "InMemoryControlPlaneStore",
-    "InvalidTransition",
-    "NotFound",
-    "OrchestrationError",
-    "PolicyDenied",
-    "RequestContext",
-    "RevisionConflict",
-    "TaskRecord",
-    "TaskState",
-    "TenantIsolationError",
-    "TenantRecord",
-    "Unauthorized",
-]
@@ -1,357 +0,0 @@
-"""Production-candidate AIOS V2 application entrypoint.
-
-This process owns the public control-plane API and read-only web console. It
-loads durable control-plane state, dispatches approved work through runtime
-adapters, exposes tenant-scoped execution evidence and sanitized GitOps status,
-and never exposes runtime credentials to the browser.
-"""
-from __future__ import annotations
-
-import dataclasses
-import json
-import os
-import stat
-import urllib.parse
-from enum import Enum
-from http import HTTPStatus
-from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
-from pathlib import Path
-from typing import Any, Mapping
-
-from aios_hermes import HermesAdapter, HermesJobState, HermesResult
-from aios_openclaw import HTTPRuntimeTransport, OpenClawAdapter
-from aios_openclaw.callback import AuditCallbackSink, EventPublisher
-
-from .console import CONSOLE_HTML
-from .control_plane import AuditEvent, RequestContext
-from .execution_tracking import ExecutionTracker
-from .gateway import GatewayApplication, error_response
-from .gitops_status import collect_gitops_status
-from .orchestrator import ExecutionOrchestrator
-from .persistence import DurableControlPlaneService, SQLiteSnapshotRepository
-
-
-def _json_value(value: Any) -> Any:
-    if dataclasses.is_dataclass(value):
-        return {
-            item.name: _json_value(getattr(value, item.name))
-            for item in dataclasses.fields(value)
-        }
-    if isinstance(value, Enum):
-        return value.value
-    if isinstance(value, Mapping):
-        return {str(key): _json_value(item) for key, item in value.items()}
-    if isinstance(value, (list, tuple, set, frozenset)):
-        return [_json_value(item) for item in value]
-    return value
-
-
-class FileSigningMaterialResolver:
-    """Resolve runtime signing material from a root-owned file reference."""
-
-    def __init__(self, path: str | Path) -> None:
-        self.path = Path(path).resolve()
-
-    def __call__(self, tenant_id: str, key_id: str) -> bytes:
-        del tenant_id, key_id
-        metadata = self.path.stat()
-        if not stat.S_ISREG(metadata.st_mode):
-            raise RuntimeError("signing material reference is not a regular file")
-        if metadata.st_mode & 0o077:
-            raise RuntimeError("signing material file permissions must be 0600 or stricter")
-        value = self.path.read_bytes().strip()
-        if len(value) < 32:
-            raise RuntimeError("signing material is too short")
-        return value
-
-
-class ControlPlaneEventPublisher(EventPublisher):
-    """Append OpenClaw runtime events to the tenant audit stream."""
-
-    def __init__(self, service: DurableControlPlaneService) -> None:
-        self.service = service
-
-    def publish(self, event: Mapping[str, Any]) -> None:
-        tenant_id = str(event.get("tenant_id") or "").strip()
-        trace_id = str(event.get("trace_id") or "").strip()
-        command_id = str(event.get("command_id") or "").strip()
-        event_type = str(event.get("event_type") or "OPENCLAW_EVENT").strip()
-        if not tenant_id or not trace_id or not command_id:
-            raise ValueError("runtime audit event is missing tenant identity")
-        state_value = str(event.get("state") or "unknown").lower()
-        outcome = "allowed" if state_value == "completed" else state_value
-        audit = AuditEvent(
-            event_id=f"runtime_{command_id}_{len(self.service.store.audit_events) + 1}",
-            tenant_id=tenant_id,
-            principal_id="openclaw-runtime",
-            trace_id=trace_id,
-            action=event_type,
-            resource_type="openclaw_command",
-            resource_id=command_id,
-            outcome=outcome,
-            policy_version="runtime-v1",
-            details=dict(event.get("details") or {}),
-        )
-        with self.service.store.lock:
-            self.service.store.audit_events.append(audit)
-            self.service.repository.save(self.service._snapshot())
-
-
-class CandidateApplication:
-    """Compose durable control plane, runtimes, evidence and console routes."""
-
-    def __init__(
-        self,
-        gateway: GatewayApplication,
-        orchestrator: ExecutionOrchestrator,
-        tracker: ExecutionTracker,
-        hermes: HermesAdapter,
-        openclaw: OpenClawAdapter | None,
-    ) -> None:
-        self.gateway = gateway
-        self.orchestrator = orchestrator
-        self.tracker = tracker
-        self.hermes = hermes
-        self.openclaw = openclaw
-
-    def context(self, headers: Mapping[str, str]) -> RequestContext:
-        return self.gateway.context_from_headers(headers)
-
-    def handle_json(
-        self,
-        method: str,
-        raw_path: str,
-        headers: Mapping[str, str],
-        body: Any,
-    ) -> tuple[int, Mapping[str, Any]]:
-        parsed = urllib.parse.urlparse(raw_path)
-        path = parsed.path.rstrip("/") or "/"
-        method = method.upper()
-
-        if method == "GET" and path == "/api/v2/gitops":
-            context = self.context(headers)
-            return HTTPStatus.OK, {
-                "tenant_id": context.tenant_id,
-                "gitops": collect_gitops_status().as_dict(),
-            }
-
-        if method == "GET" and path == "/api/v2/runtime":
-            context = self.context(headers)
-            runtimes: list[dict[str, Any]] = []
-            if self.openclaw is None:
-                runtimes.append(
-                    {
-                        "name": "openclaw",
-                        "status": "disabled",
-                        "details": {"reason": "runtime_not_configured"},
-                    }
-                )
-            else:
-                try:
-                    health = self.openclaw.health()
-                    runtimes.append(
-                        {
-                            "name": "openclaw",
-                            "status": health.status,
-                            "details": _json_value(health),
-                        }
-                    )
-                except Exception as exc:
-                    runtimes.append(
-                        {
-                            "name": "openclaw",
-                            "status": "unavailable",
-                            "details": {"message": str(exc)},
-                        }
-                    )
-            hermes_health = self.hermes.health()
-            runtimes.append(
-                {
-                    "name": "hermes",
-                    "status": hermes_health.status,
-                    "details": _json_value(hermes_health),
-                }
-            )
-            return HTTPStatus.OK, {
-                "tenant_id": context.tenant_id,
-                "runtimes": runtimes,
-            }
-
-        if method == "GET" and path == "/api/v2/executions":
-            context = self.context(headers)
-            return HTTPStatus.OK, {
-                "executions": _json_value(
-                    self.tracker.list(tenant_id=context.tenant_id)
-                )
-            }
-
-        dispatch_match = __import__("re").fullmatch(
-            r"/api/v2/tasks/([^/]+)/dispatch",
-            path,
-        )
-        if method == "POST" and dispatch_match:
-            context = self.context(headers)
-            task_id = urllib.parse.unquote(dispatch_match.group(1))
-            payload = body if isinstance(body, Mapping) else {}
-            timeout = payload.get("timeout_seconds")
-            record = self.orchestrator.dispatch(
-                context,
-                task_id=task_id,
-                timeout_seconds=float(timeout) if timeout is not None else None,
-            )
-            return HTTPStatus.ACCEPTED, {"dispatch": _json_value(record)}
-
-        if method == "POST" and path == "/api/v2/hermes/results/reconcile":
-            context = self.context(headers)
-            if not isinstance(body, Mapping):
-                raise ValueError("JSON body must be an object")
-            result = HermesResult(
-                job_id=str(body["job_id"]),
-                tenant_id=str(body["tenant_id"]),
-                task_id=str(body["task_id"]),
-                trace_id=str(body["trace_id"]),
-                state=HermesJobState(str(body["state"])),
-                worker_id=(
-                    str(body["worker_id"])
-                    if body.get("worker_id") is not None
-                    else None
-                ),
-                output=body.get("output"),
-                error=body.get("error"),
-                started_at=body.get("started_at"),
-                finished_at=body.get("finished_at"),
-            )
-            task = self.orchestrator.reconcile_hermes(context, result)
-            return HTTPStatus.OK, {"task": _json_value(task)}
-
-        return self.gateway.handle(method, raw_path, headers, body)
-
-
-class CandidateRequestHandler(BaseHTTPRequestHandler):
-    server_version = "AIOSV2Candidate/1.0"
-    max_body_bytes = 1_048_576
-
-    @property
-    def application(self) -> CandidateApplication:
-        return self.server.application  # type: ignore[attr-defined]
-
-    def _read_body(self) -> Any:
-        length = int(self.headers.get("Content-Length", "0") or "0")
-        if length < 0 or length > self.max_body_bytes:
-            raise ValueError("request body is too large")
-        if length == 0:
-            return {}
-        content_type = self.headers.get("Content-Type", "").split(";", 1)[0].strip()
-        if content_type != "application/json":
-            raise ValueError("Content-Type must be application/json")
-        return json.loads(self.rfile.read(length).decode("utf-8"))
-
-    def _security_headers(self) -> None:
-        self.send_header("Cache-Control", "no-store")
-        self.send_header("X-Content-Type-Options", "nosniff")
-        self.send_header("X-Frame-Options", "DENY")
-        self.send_header("Referrer-Policy", "no-referrer")
-        self.send_header(
-            "Content-Security-Policy",
-            "default-src 'self'; style-src 'unsafe-inline'; script-src 'unsafe-inline'; connect-src 'self'",
-        )
-
-    def _send_json(self, status_code: int, payload: Mapping[str, Any]) -> None:
-        encoded = json.dumps(
-            _json_value(payload),
-            ensure_ascii=False,
-            separators=(",", ":"),
-        ).encode("utf-8")
-        self.send_response(int(status_code))
-        self.send_header("Content-Type", "application/json; charset=utf-8")
-        self.send_header("Content-Length", str(len(encoded)))
-        self._security_headers()
-        self.end_headers()
-        self.wfile.write(encoded)
-
-    def _send_console(self) -> None:
-        encoded = CONSOLE_HTML.encode("utf-8")
-        self.send_response(HTTPStatus.OK)
-        self.send_header("Content-Type", "text/html; charset=utf-8")
-        self.send_header("Content-Length", str(len(encoded)))
-        self._security_headers()
-        self.end_headers()
-        self.wfile.write(encoded)
-
-    def _dispatch(self, method: str) -> None:
-        path = urllib.parse.urlparse(self.path).path.rstrip("/") or "/"
-        if method == "GET" and path in {"/", "/console"}:
-            self._send_console()
-            return
-        try:
-            body = self._read_body() if method == "POST" else {}
-            status_code, payload = self.application.handle_json(
-                method,
-                self.path,
-                {key: value for key, value in self.headers.items()},
-                body,
-            )
-        except BaseException as exc:
-            status_code, payload = error_response(exc)
-        self._send_json(status_code, payload)
-
-    def do_GET(self) -> None:  # noqa: N802
-        self._dispatch("GET")
-
-    def do_POST(self) -> None:  # noqa: N802
-        self._dispatch("POST")
-
-
-class CandidateHTTPServer(ThreadingHTTPServer):
-    daemon_threads = True
-    allow_reuse_address = True
-
-    def __init__(self, address: tuple[str, int], application: CandidateApplication) -> None:
-        self.application = application
-        super().__init__(address, CandidateRequestHandler)
-
-
-def build_application() -> CandidateApplication:
-    state_dir = Path(os.getenv("AIOS_V2_STATE_DIR", "/var/lib/aios-v2")).resolve()
-    state_dir.mkdir(parents=True, exist_ok=True)
-    repository = SQLiteSnapshotRepository(state_dir / "control-plane.sqlite3")
-    service = DurableControlPlaneService(repository)
-    tracker = ExecutionTracker(state_dir / "executions")
-    hermes = HermesAdapter()
-
-    openclaw_url = os.getenv("AIOS_OPENCLAW_URL", "").strip()
-    material_file = os.getenv("AIOS_OPENCLAW_SIGNING_MATERIAL_FILE", "").strip()
-    openclaw = None
-    resolver = None
-    if openclaw_url and material_file:
-        resolver = FileSigningMaterialResolver(material_file)
-        transport = HTTPRuntimeTransport(
-            openclaw_url,
-            credential_ref=os.getenv("AIOS_OPENCLAW_CREDENTIAL_REF") or None,
-        )
-        openclaw = OpenClawAdapter(
-            transport,
-            resolver,
-            callback_sink=AuditCallbackSink(ControlPlaneEventPublisher(service)),
-        )
-
-    gateway = GatewayApplication(service)
-    orchestrator = ExecutionOrchestrator(
-        service,
-        openclaw=openclaw,
-        hermes=hermes,
-        openclaw_signing_material_resolver=resolver,
-    )
-    return CandidateApplication(gateway, orchestrator, tracker, hermes, openclaw)
-
-
-def main() -> None:
-    host = os.getenv("AIOS_V2_HOST", "127.0.0.1")
-    port = int(os.getenv("AIOS_V2_PORT", "18920"))
-    server = CandidateHTTPServer((host, port), build_application())
-    print(f"AIOS V2 candidate listening on {host}:{port}")
-    server.serve_forever()
-
-
-if __name__ == "__main__":
-    main()
@@ -1,69 +0,0 @@
-"""Dependency-free AIOS V2 web console assets.
-
-Authentication and tenant identity are injected by the trusted reverse proxy.
-The browser never selects a tenant and never calls OpenClaw or Hermes directly.
-"""
-
-CONSOLE_HTML = r'''<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="utf-8">
-  <meta name="viewport" content="width=device-width,initial-scale=1">
-  <meta name="referrer" content="no-referrer">
-  <title>AIOS V2 Console</title>
-  <style>
-    :root{font-family:Inter,ui-sans-serif,system-ui,sans-serif;color:#152033;background:#f4f7fb}
-    *{box-sizing:border-box} body{margin:0} header{background:#111827;color:white;padding:18px 24px;display:flex;justify-content:space-between;align-items:center}
-    header h1{font-size:20px;margin:0} header span{font-size:12px;color:#cbd5e1}
-    main{padding:24px;max-width:1440px;margin:auto}.notice{background:#fff7ed;border:1px solid #fed7aa;padding:12px 14px;border-radius:10px;margin-bottom:18px;font-size:13px}
-    .cards{display:grid;grid-template-columns:repeat(auto-fit,minmax(190px,1fr));gap:14px;margin-bottom:20px}.card,.panel{background:white;border:1px solid #e5e7eb;border-radius:12px;box-shadow:0 1px 2px rgba(0,0,0,.04)}
-    .card{padding:16px}.card b{display:block;font-size:28px;margin-top:8px}.card small{color:#64748b}.grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(420px,1fr));gap:16px}.panel{padding:16px;overflow:auto}.panel h2{font-size:16px;margin:0 0 12px}
-    table{width:100%;border-collapse:collapse;font-size:12px}th,td{text-align:left;border-bottom:1px solid #edf0f4;padding:8px;vertical-align:top}th{color:#64748b;font-weight:600}.state{font-weight:700}.ok{color:#047857}.bad{color:#b91c1c}.muted{color:#64748b}
-    button{border:0;border-radius:8px;padding:9px 13px;background:#2563eb;color:white;cursor:pointer}button:disabled{opacity:.5}.toolbar{display:flex;gap:8px;align-items:center;margin-bottom:16px}.error{color:#b91c1c;white-space:pre-wrap}
-  </style>
-</head>
-<body>
-<header><h1>AIOS V2 Control Plane</h1><span id="updated">Not loaded</span></header>
-<main>
-  <div class="notice">Read-only candidate console. Identity and tenant context must be injected by the trusted reverse proxy. The console never calls OpenClaw or Hermes directly.</div>
-  <div class="toolbar"><button id="refresh">Refresh</button><span id="error" class="error"></span></div>
-  <section class="cards">
-    <div class="card"><small>Agents</small><b id="agentCount">—</b></div>
-    <div class="card"><small>Tasks</small><b id="taskCount">—</b></div>
-    <div class="card"><small>Audit events</small><b id="auditCount">—</b></div>
-    <div class="card"><small>Executions</small><b id="executionCount">—</b></div>
-  </section>
-  <section class="grid">
-    <div class="panel"><h2>Runtime health</h2><div id="runtime"></div></div>
-    <div class="panel"><h2>Tasks</h2><div id="tasks"></div></div>
-    <div class="panel"><h2>Agents</h2><div id="agents"></div></div>
-    <div class="panel"><h2>Execution evidence</h2><div id="executions"></div></div>
-    <div class="panel"><h2>Audit</h2><div id="audit"></div></div>
-  </section>
-</main>
-<script>
-const esc=v=>String(v??'').replace(/[&<>"']/g,c=>({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]));
-const table=(cols,rows)=>`<table><thead><tr>${cols.map(c=>`<th>${esc(c[0])}</th>`).join('')}</tr></thead><tbody>${rows.map(r=>`<tr>${cols.map(c=>`<td>${esc(c[1](r))}</td>`).join('')}</tr>`).join('')}</tbody></table>`;
-async function api(path){const r=await fetch(path,{credentials:'same-origin',headers:{'Accept':'application/json'}});const data=await r.json().catch(()=>({}));if(!r.ok)throw new Error(`${r.status} ${data.message||data.error||path}`);return data}
-async function refresh(){
-  const btn=document.getElementById('refresh');btn.disabled=true;document.getElementById('error').textContent='';
-  try{
-    const [agents,tasks,audit,runtime,executions]=await Promise.all([
-      api('/api/v2/agents'),api('/api/v2/tasks'),api('/api/v2/audit'),api('/api/v2/runtime'),api('/api/v2/executions')
-    ]);
-    document.getElementById('agentCount').textContent=agents.agents.length;
-    document.getElementById('taskCount').textContent=tasks.tasks.length;
-    document.getElementById('auditCount').textContent=audit.events.length;
-    document.getElementById('executionCount').textContent=executions.executions.length;
-    document.getElementById('agents').innerHTML=table([['ID',x=>x.agent_id],['Runtime',x=>x.runtime],['Enabled',x=>x.enabled]],agents.agents);
-    document.getElementById('tasks').innerHTML=table([['Task',x=>x.task_id],['Action',x=>x.action],['State',x=>x.state],['Rev',x=>x.revision]],tasks.tasks);
-    document.getElementById('audit').innerHTML=table([['Time',x=>x.created_at],['Action',x=>x.action],['Outcome',x=>x.outcome],['Resource',x=>x.resource_id]],audit.events.slice(-100).reverse());
-    document.getElementById('executions').innerHTML=table([['Executor',x=>x.executor],['Task',x=>x.task_id],['Status',x=>x.status],['Progress',x=>`${x.progress_completed}/${x.progress_total}`],['Commit',x=>x.last_commit||'']],executions.executions);
-    document.getElementById('runtime').innerHTML=table([['Runtime',x=>x.name],['Status',x=>x.status],['Details',x=>JSON.stringify(x.details)]],runtime.runtimes);
-    document.getElementById('updated').textContent=`Updated ${new Date().toLocaleString()}`;
-  }catch(e){document.getElementById('error').textContent=e.message||String(e)}finally{btn.disabled=false}
-}
-document.getElementById('refresh').addEventListener('click',refresh);refresh();setInterval(refresh,30000);
-</script>
-</body>
-</html>'''
@@ -1,627 +0,0 @@
-"""Tenant-isolated AIOS V2 control-plane domain service.
-
-This module deliberately contains no OpenClaw or Hermes implementation details.
-It owns authoritative tenant, agent, task-lifecycle, idempotency and audit state.
-Runtime adapters consume approved tasks through a separate boundary.
-"""
-from __future__ import annotations
-
-import copy
-import hashlib
-import json
-import threading
-import uuid
-from dataclasses import dataclass, field
-from datetime import datetime, timezone
-from enum import Enum
-from typing import Any, Callable, Iterable, Mapping
-
-
-def _utc_now() -> str:
-    return datetime.now(timezone.utc).isoformat().replace("+00:00", "Z")
-
-
-def _new_id(prefix: str) -> str:
-    return f"{prefix}_{uuid.uuid4().hex}"
-
-
-def _canonical_digest(value: Mapping[str, Any]) -> str:
-    encoded = json.dumps(
-        value,
-        ensure_ascii=False,
-        sort_keys=True,
-        separators=(",", ":"),
-        default=str,
-    ).encode("utf-8")
-    return hashlib.sha256(encoded).hexdigest()
-
-
-class ControlPlaneError(RuntimeError):
-    """Base error returned by the control-plane domain."""
-
-
-class Unauthorized(ControlPlaneError):
-    """The caller is not authenticated or lacks the required role."""
-
-
-class TenantIsolationError(ControlPlaneError):
-    """A request attempted to cross a tenant boundary."""
-
-
-class NotFound(ControlPlaneError):
-    """A tenant-scoped resource does not exist or is not visible."""
-
-
-class InvalidTransition(ControlPlaneError):
-    """A task state transition violates the lifecycle contract."""
-
-
-class IdempotencyConflict(ControlPlaneError):
-    """An idempotency key was reused for a different command."""
-
-
-class RevisionConflict(ControlPlaneError):
-    """Optimistic task revision does not match current state."""
-
-
-class PolicyDenied(ControlPlaneError):
-    """The policy gate denied a control-plane operation."""
-
-
-@dataclass(frozen=True)
-class RequestContext:
-    """Authenticated request identity propagated across all AIOS layers."""
-
-    tenant_id: str
-    principal_id: str
-    trace_id: str
-    roles: frozenset[str] = field(default_factory=frozenset)
-    session_id: str | None = None
-    policy_version: str = "v1"
-
-    def __post_init__(self) -> None:
-        for name in ("tenant_id", "principal_id", "trace_id"):
-            if not str(getattr(self, name, "")).strip():
-                raise ValueError(f"{name} is required")
-
-    @classmethod
-    def create(
-        cls,
-        *,
-        tenant_id: str,
-        principal_id: str,
-        roles: Iterable[str] = (),
-        trace_id: str | None = None,
-        session_id: str | None = None,
-        policy_version: str = "v1",
-    ) -> "RequestContext":
-        return cls(
-            tenant_id=tenant_id.strip(),
-            principal_id=principal_id.strip(),
-            trace_id=trace_id or _new_id("trace"),
-            roles=frozenset(str(role).strip() for role in roles if str(role).strip()),
-            session_id=session_id,
-            policy_version=policy_version,
-        )
-
-
-@dataclass(frozen=True)
-class TenantRecord:
-    tenant_id: str
-    display_name: str
-    status: str = "active"
-    metadata: Mapping[str, Any] = field(default_factory=dict)
-    created_at: str = field(default_factory=_utc_now)
-    updated_at: str = field(default_factory=_utc_now)
-
-
-@dataclass(frozen=True)
-class AgentRecord:
-    agent_id: str
-    tenant_id: str
-    display_name: str
-    runtime: str
-    capabilities: tuple[str, ...] = field(default_factory=tuple)
-    enabled: bool = True
-    metadata: Mapping[str, Any] = field(default_factory=dict)
-    created_at: str = field(default_factory=_utc_now)
-    updated_at: str = field(default_factory=_utc_now)
-
-
-class TaskState(str, Enum):
-    CREATED = "CREATED"
-    APPROVED = "APPROVED"
-    RUNNING = "RUNNING"
-    COMPLETED = "COMPLETED"
-    FAILED = "FAILED"
-    CANCELLED = "CANCELLED"
-
-
-TERMINAL_TASK_STATES = frozenset(
-    {TaskState.COMPLETED, TaskState.FAILED, TaskState.CANCELLED}
-)
-
-ALLOWED_TASK_TRANSITIONS: Mapping[TaskState, frozenset[TaskState]] = {
-    TaskState.CREATED: frozenset({TaskState.APPROVED, TaskState.CANCELLED}),
-    TaskState.APPROVED: frozenset({TaskState.RUNNING, TaskState.CANCELLED}),
-    TaskState.RUNNING: frozenset(
-        {TaskState.COMPLETED, TaskState.FAILED, TaskState.CANCELLED}
-    ),
-    TaskState.COMPLETED: frozenset(),
-    TaskState.FAILED: frozenset(),
-    TaskState.CANCELLED: frozenset(),
-}
-
-
-@dataclass(frozen=True)
-class TaskRecord:
-    task_id: str
-    tenant_id: str
-    agent_id: str
-    action: str
-    payload: Mapping[str, Any]
-    state: TaskState = TaskState.CREATED
-    revision: int = 1
-    idempotency_key: str | None = None
-    request_digest: str = ""
-    result: Mapping[str, Any] | None = None
-    error: Mapping[str, Any] | None = None
-    created_by: str = ""
-    approved_by: str | None = None
-    created_at: str = field(default_factory=_utc_now)
-    updated_at: str = field(default_factory=_utc_now)
-
-
-@dataclass(frozen=True)
-class AuditEvent:
-    event_id: str
-    tenant_id: str
-    principal_id: str
-    trace_id: str
-    action: str
-    resource_type: str
-    resource_id: str
-    outcome: str
-    policy_version: str
-    details: Mapping[str, Any] = field(default_factory=dict)
-    created_at: str = field(default_factory=_utc_now)
-
-
-@dataclass(frozen=True)
-class PolicyDecision:
-    allowed: bool
-    reason: str
-    policy_version: str
-
-
-PolicyEvaluator = Callable[[RequestContext, str, Mapping[str, Any]], PolicyDecision]
-
-
-class InMemoryControlPlaneStore:
-    """Thread-safe reference store used by tests and the first gateway slice.
-
-    Production backends must preserve the same tenant-scoped interface and add
-    database row-level security, migrations, backup and HA evidence.
-    """
-
-    def __init__(self) -> None:
-        self.lock = threading.RLock()
-        self.tenants: dict[str, TenantRecord] = {}
-        self.agents: dict[str, AgentRecord] = {}
-        self.tasks: dict[str, TaskRecord] = {}
-        self.idempotency: dict[tuple[str, str], tuple[str, str]] = {}
-        self.audit_events: list[AuditEvent] = []
-
-
-class ControlPlaneService:
-    """Authoritative tenant, agent and task lifecycle service."""
-
-    def __init__(
-        self,
-        store: InMemoryControlPlaneStore | None = None,
-        *,
-        policy_evaluator: PolicyEvaluator | None = None,
-    ) -> None:
-        self.store = store or InMemoryControlPlaneStore()
-        self.policy_evaluator = policy_evaluator or self._default_policy
-
-    @staticmethod
-    def _default_policy(
-        context: RequestContext,
-        action: str,
-        resource: Mapping[str, Any],
-    ) -> PolicyDecision:
-        del resource
-        role_requirements = {
-            "tenant.register": {"platform_admin"},
-            "tenant.read": {"tenant_admin", "operator", "auditor", "platform_admin"},
-            "agent.register": {"tenant_admin", "operator", "platform_admin"},
-            "agent.read": {"tenant_admin", "operator", "auditor", "platform_admin"},
-            "task.create": {"tenant_admin", "operator", "platform_admin"},
-            "task.read": {"tenant_admin", "operator", "auditor", "platform_admin"},
-            "task.approve": {"tenant_admin", "approver", "platform_admin"},
-            "task.start": {"runtime", "operator", "platform_admin"},
-            "task.complete": {"runtime", "operator", "platform_admin"},
-            "task.fail": {"runtime", "operator", "platform_admin"},
-            "task.cancel": {"tenant_admin", "operator", "approver", "platform_admin"},
-            "audit.read": {"tenant_admin", "auditor", "platform_admin"},
-        }
-        required = role_requirements.get(action, {"platform_admin"})
-        allowed = bool(context.roles.intersection(required))
-        return PolicyDecision(
-            allowed=allowed,
-            reason="role_allowed" if allowed else "required_role_missing",
-            policy_version=context.policy_version,
-        )
-
-    def _require_context(self, context: RequestContext) -> None:
-        if not context.principal_id or not context.tenant_id or not context.trace_id:
-            raise Unauthorized("authenticated tenant context is required")
-
-    def _authorize(
-        self,
-        context: RequestContext,
-        action: str,
-        resource: Mapping[str, Any],
-    ) -> PolicyDecision:
-        self._require_context(context)
-        decision = self.policy_evaluator(context, action, resource)
-        if not decision.allowed:
-            self._audit(
-                context,
-                action=action,
-                resource_type=str(resource.get("resource_type", "policy")),
-                resource_id=str(resource.get("resource_id", "unknown")),
-                outcome="denied",
-                details={"reason": decision.reason},
-            )
-            raise PolicyDenied(f"{action} denied: {decision.reason}")
-        return decision
-
-    @staticmethod
-    def _assert_same_tenant(context: RequestContext, tenant_id: str) -> None:
-        if context.tenant_id != tenant_id and "platform_admin" not in context.roles:
-            raise TenantIsolationError("cross-tenant access denied")
-
-    def _audit(
-        self,
-        context: RequestContext,
-        *,
-        action: str,
-        resource_type: str,
-        resource_id: str,
-        outcome: str,
-        details: Mapping[str, Any] | None = None,
-    ) -> AuditEvent:
-        event = AuditEvent(
-            event_id=_new_id("audit"),
-            tenant_id=context.tenant_id,
-            principal_id=context.principal_id,
-            trace_id=context.trace_id,
-            action=action,
-            resource_type=resource_type,
-            resource_id=resource_id,
-            outcome=outcome,
-            policy_version=context.policy_version,
-            details=copy.deepcopy(dict(details or {})),
-        )
-        self.store.audit_events.append(event)
-        return event
-
-    def register_tenant(
-        self,
-        context: RequestContext,
-        *,
-        tenant_id: str,
-        display_name: str,
-        metadata: Mapping[str, Any] | None = None,
-    ) -> TenantRecord:
-        tenant_id = tenant_id.strip()
-        if not tenant_id or not display_name.strip():
-            raise ValueError("tenant_id and display_name are required")
-        self._authorize(
-            context,
-            "tenant.register",
-            {"resource_type": "tenant", "resource_id": tenant_id},
-        )
-        self._assert_same_tenant(context, tenant_id)
-        with self.store.lock:
-            if tenant_id in self.store.tenants:
-                raise ControlPlaneError(f"tenant already exists: {tenant_id}")
-            tenant = TenantRecord(
-                tenant_id=tenant_id,
-                display_name=display_name.strip(),
-                metadata=copy.deepcopy(dict(metadata or {})),
-            )
-            self.store.tenants[tenant_id] = tenant
-            self._audit(
-                context,
-                action="tenant.register",
-                resource_type="tenant",
-                resource_id=tenant_id,
-                outcome="allowed",
-            )
-            return tenant
-
-    def get_tenant(self, context: RequestContext, tenant_id: str | None = None) -> TenantRecord:
-        tenant_id = tenant_id or context.tenant_id
-        self._authorize(
-            context,
-            "tenant.read",
-            {"resource_type": "tenant", "resource_id": tenant_id},
-        )
-        self._assert_same_tenant(context, tenant_id)
-        with self.store.lock:
-            tenant = self.store.tenants.get(tenant_id)
-            if tenant is None:
-                raise NotFound("tenant not found")
-            return tenant
-
-    def register_agent(
-        self,
-        context: RequestContext,
-        *,
-        agent_id: str,
-        display_name: str,
-        runtime: str,
-        capabilities: Iterable[str] = (),
-        metadata: Mapping[str, Any] | None = None,
-    ) -> AgentRecord:
-        self._authorize(
-            context,
-            "agent.register",
-            {"resource_type": "agent", "resource_id": agent_id},
-        )
-        tenant = self.get_tenant(context)
-        if tenant.status != "active":
-            raise ControlPlaneError("tenant is not active")
-        normalized_capabilities = tuple(
-            sorted({str(item).strip() for item in capabilities if str(item).strip()})
-        )
-        if not agent_id.strip() or not display_name.strip() or not runtime.strip():
-            raise ValueError("agent_id, display_name and runtime are required")
-        with self.store.lock:
-            existing = self.store.agents.get(agent_id)
-            if existing is not None and existing.tenant_id != context.tenant_id:
-                raise TenantIsolationError("agent id belongs to another tenant")
-            if existing is not None:
-                raise ControlPlaneError(f"agent already exists: {agent_id}")
-            agent = AgentRecord(
-                agent_id=agent_id.strip(),
-                tenant_id=context.tenant_id,
-                display_name=display_name.strip(),
-                runtime=runtime.strip(),
-                capabilities=normalized_capabilities,
-                metadata=copy.deepcopy(dict(metadata or {})),
-            )
-            self.store.agents[agent.agent_id] = agent
-            self._audit(
-                context,
-                action="agent.register",
-                resource_type="agent",
-                resource_id=agent.agent_id,
-                outcome="allowed",
-                details={"runtime": agent.runtime},
-            )
-            return agent
-
-    def get_agent(self, context: RequestContext, agent_id: str) -> AgentRecord:
-        self._authorize(
-            context,
-            "agent.read",
-            {"resource_type": "agent", "resource_id": agent_id},
-        )
-        with self.store.lock:
-            agent = self.store.agents.get(agent_id)
-            if agent is None:
-                raise NotFound("agent not found")
-            self._assert_same_tenant(context, agent.tenant_id)
-            return agent
-
-    def list_agents(self, context: RequestContext) -> list[AgentRecord]:
-        self._authorize(
-            context,
-            "agent.read",
-            {"resource_type": "agent_collection", "resource_id": context.tenant_id},
-        )
-        with self.store.lock:
-            return [
-                agent
-                for agent in self.store.agents.values()
-                if agent.tenant_id == context.tenant_id
-            ]
-
-    def create_task(
-        self,
-        context: RequestContext,
-        *,
-        agent_id: str,
-        action: str,
-        payload: Mapping[str, Any] | None = None,
-        idempotency_key: str | None = None,
-    ) -> TaskRecord:
-        self._authorize(
-            context,
-            "task.create",
-            {"resource_type": "task", "resource_id": idempotency_key or "new"},
-        )
-        agent = self.get_agent(context, agent_id)
-        if not agent.enabled:
-            raise ControlPlaneError("agent is disabled")
-        if action not in agent.capabilities and "*" not in agent.capabilities:
-            raise PolicyDenied(f"agent does not advertise capability: {action}")
-        normalized_payload = copy.deepcopy(dict(payload or {}))
-        request_digest = _canonical_digest(
-            {"agent_id": agent_id, "action": action, "payload": normalized_payload}
-        )
-        normalized_key = idempotency_key.strip() if idempotency_key else None
-        with self.store.lock:
-            if normalized_key:
-                idempotency_ref = (context.tenant_id, normalized_key)
-                existing = self.store.idempotency.get(idempotency_ref)
-                if existing is not None:
-                    existing_task_id, existing_digest = existing
-                    if existing_digest != request_digest:
-                        raise IdempotencyConflict(
-                            "idempotency key was reused with a different request"
-                        )
-                    return self.store.tasks[existing_task_id]
-            task = TaskRecord(
-                task_id=_new_id("task"),
-                tenant_id=context.tenant_id,
-                agent_id=agent_id,
-                action=action,
-                payload=normalized_payload,
-                idempotency_key=normalized_key,
-                request_digest=request_digest,
-                created_by=context.principal_id,
-            )
-            self.store.tasks[task.task_id] = task
-            if normalized_key:
-                self.store.idempotency[(context.tenant_id, normalized_key)] = (
-                    task.task_id,
-                    request_digest,
-                )
-            self._audit(
-                context,
-                action="task.create",
-                resource_type="task",
-                resource_id=task.task_id,
-                outcome="allowed",
-                details={"agent_id": agent_id, "action": action},
-            )
-            return task
-
-    def get_task(self, context: RequestContext, task_id: str) -> TaskRecord:
-        self._authorize(
-            context,
-            "task.read",
-            {"resource_type": "task", "resource_id": task_id},
-        )
-        with self.store.lock:
-            task = self.store.tasks.get(task_id)
-            if task is None:
-                raise NotFound("task not found")
-            self._assert_same_tenant(context, task.tenant_id)
-            return task
-
-    def list_tasks(
-        self,
-        context: RequestContext,
-        *,
-        states: Iterable[TaskState | str] | None = None,
-    ) -> list[TaskRecord]:
-        self._authorize(
-            context,
-            "task.read",
-            {"resource_type": "task_collection", "resource_id": context.tenant_id},
-        )
-        state_filter = (
-            {TaskState(item) for item in states}
-            if states is not None
-            else None
-        )
-        with self.store.lock:
-            return [
-                task
-                for task in self.store.tasks.values()
-                if task.tenant_id == context.tenant_id
-                and (state_filter is None or task.state in state_filter)
-            ]
-
-    def transition_task(
-        self,
-        context: RequestContext,
-        *,
-        task_id: str,
-        target_state: TaskState | str,
-        expected_revision: int | None = None,
-        result: Mapping[str, Any] | None = None,
-        error: Mapping[str, Any] | None = None,
-    ) -> TaskRecord:
-        target = TaskState(target_state)
-        action_name = {
-            TaskState.APPROVED: "task.approve",
-            TaskState.RUNNING: "task.start",
-            TaskState.COMPLETED: "task.complete",
-            TaskState.FAILED: "task.fail",
-            TaskState.CANCELLED: "task.cancel",
-        }.get(target)
-        if action_name is None:
-            raise InvalidTransition(f"cannot transition to {target.value}")
-        self._authorize(
-            context,
-            action_name,
-            {"resource_type": "task", "resource_id": task_id},
-        )
-        with self.store.lock:
-            current = self.store.tasks.get(task_id)
-            if current is None:
-                raise NotFound("task not found")
-            self._assert_same_tenant(context, current.tenant_id)
-            if expected_revision is not None and current.revision != expected_revision:
-                raise RevisionConflict(
-                    f"expected revision {expected_revision}, current {current.revision}"
-                )
-            if target not in ALLOWED_TASK_TRANSITIONS[current.state]:
-                raise InvalidTransition(
-                    f"invalid transition {current.state.value} -> {target.value}"
-                )
-            if target == TaskState.COMPLETED and result is None:
-                raise ValueError("completed task requires result")
-            if target == TaskState.FAILED and error is None:
-                raise ValueError("failed task requires error")
-            updated = TaskRecord(
-                task_id=current.task_id,
-                tenant_id=current.tenant_id,
-                agent_id=current.agent_id,
-                action=current.action,
-                payload=current.payload,
-                state=target,
-                revision=current.revision + 1,
-                idempotency_key=current.idempotency_key,
-                request_digest=current.request_digest,
-                result=copy.deepcopy(dict(result)) if result is not None else current.result,
-                error=copy.deepcopy(dict(error)) if error is not None else current.error,
-                created_by=current.created_by,
-                approved_by=(
-                    context.principal_id
-                    if target == TaskState.APPROVED
-                    else current.approved_by
-                ),
-                created_at=current.created_at,
-                updated_at=_utc_now(),
-            )
-            self.store.tasks[task_id] = updated
-            self._audit(
-                context,
-                action=action_name,
-                resource_type="task",
-                resource_id=task_id,
-                outcome="allowed",
-                details={
-                    "from": current.state.value,
-                    "to": target.value,
-                    "revision": updated.revision,
-                },
-            )
-            return updated
-
-    def list_audit_events(
-        self,
-        context: RequestContext,
-        *,
-        resource_id: str | None = None,
-    ) -> list[AuditEvent]:
-        self._authorize(
-            context,
-            "audit.read",
-            {"resource_type": "audit", "resource_id": resource_id or context.tenant_id},
-        )
-        with self.store.lock:
-            return [
-                event
-                for event in self.store.audit_events
-                if event.tenant_id == context.tenant_id
-                and (resource_id is None or event.resource_id == resource_id)
-            ]
@@ -1,195 +0,0 @@
-"""Git-backed agent execution evidence for AIOS V2.
-
-Evidence is tenant-scoped, append-friendly, and contains no runtime credentials.
-It provides a deterministic source for claim, heartbeat, progress, result and
-verification state across Codex, OpenClaw and Hermes executors.
-"""
-from __future__ import annotations
-
-import json
-import os
-import threading
-from dataclasses import asdict, dataclass, field, replace
-from datetime import datetime, timezone
-from pathlib import Path
-from typing import Any, Mapping
-
-
-def utc_now() -> str:
-    return datetime.now(timezone.utc).isoformat().replace("+00:00", "Z")
-
-
-def _required(value: str, label: str) -> str:
-    normalized = str(value or "").strip()
-    if not normalized:
-        raise ValueError(f"{label} is required")
-    return normalized
-
-
-def _safe(value: Mapping[str, Any] | None) -> dict[str, Any]:
-    return json.loads(json.dumps(dict(value or {}), ensure_ascii=False, default=str))
-
-
-@dataclass(frozen=True)
-class ExecutionEvidence:
-    execution_id: str
-    tenant_id: str
-    task_id: str
-    agent_id: str
-    executor: str
-    branch: str
-    status: str = "claimed"
-    progress_completed: int = 0
-    progress_total: int = 1
-    current_step: str = "claim"
-    last_commit: str | None = None
-    test_status: str = "not_run"
-    test_summary: Mapping[str, Any] = field(default_factory=dict)
-    result_summary: Mapping[str, Any] = field(default_factory=dict)
-    claimed_at: str = field(default_factory=utc_now)
-    heartbeat_at: str = field(default_factory=utc_now)
-    completed_at: str | None = None
-
-    def __post_init__(self) -> None:
-        for name in (
-            "execution_id",
-            "tenant_id",
-            "task_id",
-            "agent_id",
-            "executor",
-            "branch",
-            "status",
-            "current_step",
-            "claimed_at",
-            "heartbeat_at",
-        ):
-            object.__setattr__(self, name, _required(getattr(self, name), name))
-        if self.progress_completed < 0 or self.progress_total < 1:
-            raise ValueError("invalid progress values")
-        if self.progress_completed > self.progress_total:
-            raise ValueError("progress_completed cannot exceed progress_total")
-        object.__setattr__(self, "test_summary", _safe(self.test_summary))
-        object.__setattr__(self, "result_summary", _safe(self.result_summary))
-
-
-class ExecutionTracker:
-    """Persist one JSON evidence record per tenant and execution."""
-
-    def __init__(self, root: str | Path) -> None:
-        self.root = Path(root).resolve()
-        self.root.mkdir(parents=True, exist_ok=True)
-        self._lock = threading.RLock()
-
-    @staticmethod
-    def _component(value: str) -> str:
-        normalized = _required(value, "path component")
-        if normalized in {".", ".."} or "/" in normalized or "\\" in normalized:
-            raise ValueError("invalid evidence path component")
-        return normalized
-
-    def _path(self, tenant_id: str, execution_id: str) -> Path:
-        tenant = self._component(tenant_id)
-        execution = self._component(execution_id)
-        return self.root / tenant / f"{execution}.json"
-
-    def claim(self, evidence: ExecutionEvidence) -> ExecutionEvidence:
-        path = self._path(evidence.tenant_id, evidence.execution_id)
-        with self._lock:
-            if path.exists():
-                current = self._read(path)
-                if current.task_id != evidence.task_id or current.agent_id != evidence.agent_id:
-                    raise RuntimeError("execution_id already belongs to another task")
-                return current
-            self._write(path, evidence)
-            return evidence
-
-    def heartbeat(
-        self,
-        *,
-        tenant_id: str,
-        execution_id: str,
-        status: str | None = None,
-        current_step: str | None = None,
-        progress_completed: int | None = None,
-        progress_total: int | None = None,
-        last_commit: str | None = None,
-    ) -> ExecutionEvidence:
-        path = self._path(tenant_id, execution_id)
-        with self._lock:
-            current = self._read(path)
-            updated = replace(
-                current,
-                status=status or current.status,
-                current_step=current_step or current.current_step,
-                progress_completed=(
-                    progress_completed
-                    if progress_completed is not None
-                    else current.progress_completed
-                ),
-                progress_total=(
-                    progress_total if progress_total is not None else current.progress_total
-                ),
-                last_commit=last_commit or current.last_commit,
-                heartbeat_at=utc_now(),
-            )
-            self._write(path, updated)
-            return updated
-
-    def complete(
-        self,
-        *,
-        tenant_id: str,
-        execution_id: str,
-        status: str,
-        test_status: str,
-        test_summary: Mapping[str, Any] | None = None,
-        result_summary: Mapping[str, Any] | None = None,
-        last_commit: str | None = None,
-    ) -> ExecutionEvidence:
-        path = self._path(tenant_id, execution_id)
-        with self._lock:
-            current = self._read(path)
-            updated = replace(
-                current,
-                status=_required(status, "status"),
-                current_step="complete",
-                progress_completed=current.progress_total,
-                last_commit=last_commit or current.last_commit,
-                test_status=_required(test_status, "test_status"),
-                test_summary=_safe(test_summary),
-                result_summary=_safe(result_summary),
-                heartbeat_at=utc_now(),
-                completed_at=utc_now(),
-            )
-            self._write(path, updated)
-            return updated
-
-    def get(self, *, tenant_id: str, execution_id: str) -> ExecutionEvidence:
-        return self._read(self._path(tenant_id, execution_id))
-
-    def list(self, *, tenant_id: str) -> list[ExecutionEvidence]:
-        tenant_dir = self.root / self._component(tenant_id)
-        if not tenant_dir.exists():
-            return []
-        records = [self._read(path) for path in tenant_dir.glob("*.json")]
-        return sorted(records, key=lambda item: (item.heartbeat_at, item.execution_id), reverse=True)
-
-    @staticmethod
-    def _read(path: Path) -> ExecutionEvidence:
-        try:
-            value = json.loads(path.read_text(encoding="utf-8"))
-        except FileNotFoundError as exc:
-            raise KeyError("execution evidence not found") from exc
-        if not isinstance(value, Mapping):
-            raise RuntimeError("invalid execution evidence file")
-        return ExecutionEvidence(**dict(value))
-
-    @staticmethod
-    def _write(path: Path, evidence: ExecutionEvidence) -> None:
-        path.parent.mkdir(parents=True, exist_ok=True)
-        temporary = path.with_suffix(f".tmp-{os.getpid()}")
-        temporary.write_text(
-            json.dumps(asdict(evidence), ensure_ascii=False, sort_keys=True, indent=2) + "\n",
-            encoding="utf-8",
-        )
-        os.replace(temporary, path)
@@ -1,346 +0,0 @@
-"""HTTP/JSON gateway for the AIOS V2 control plane.
-
-The gateway is intentionally runtime-neutral: browsers and external clients
-call this API, while OpenClaw and Hermes remain behind authenticated adapters.
-Identity headers are accepted only from a trusted reverse proxy in v1; direct
-public exposure is prohibited until signed identity middleware is enabled.
-"""
-from __future__ import annotations
-
-import dataclasses
-import json
-import os
-import re
-import urllib.parse
-from enum import Enum
-from http import HTTPStatus
-from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
-from typing import Any, Mapping
-
-from .control_plane import (
-    ControlPlaneError,
-    ControlPlaneService,
-    IdempotencyConflict,
-    InvalidTransition,
-    NotFound,
-    PolicyDenied,
-    RequestContext,
-    RevisionConflict,
-    TaskState,
-    TenantIsolationError,
-    Unauthorized,
-)
-
-
-TENANT_HEADER = "X-AIOS-Tenant-ID"
-PRINCIPAL_HEADER = "X-AIOS-Principal-ID"
-ROLES_HEADER = "X-AIOS-Roles"
-TRACE_HEADER = "X-AIOS-Trace-ID"
-SESSION_HEADER = "X-AIOS-Session-ID"
-POLICY_HEADER = "X-AIOS-Policy-Version"
-AUTHENTICATED_HEADER = "X-AIOS-Authenticated"
-
-_RESOURCE_ID_RE = re.compile(r"^[A-Za-z0-9][A-Za-z0-9._:-]{0,191}$")
-
-
-def _json_value(value: Any) -> Any:
-    if dataclasses.is_dataclass(value):
-        return {
-            field.name: _json_value(getattr(value, field.name))
-            for field in dataclasses.fields(value)
-        }
-    if isinstance(value, Enum):
-        return value.value
-    if isinstance(value, Mapping):
-        return {str(key): _json_value(item) for key, item in value.items()}
-    if isinstance(value, (list, tuple, set, frozenset)):
-        return [_json_value(item) for item in value]
-    return value
-
-
-def _require_mapping(value: Any, *, label: str = "JSON body") -> Mapping[str, Any]:
-    if not isinstance(value, Mapping):
-        raise ValueError(f"{label} must be an object")
-    return value
-
-
-def _require_resource_id(value: Any, *, label: str) -> str:
-    normalized = str(value or "").strip()
-    if not _RESOURCE_ID_RE.fullmatch(normalized):
-        raise ValueError(f"invalid {label}")
-    return normalized
-
-
-class GatewayApplication:
-    """Pure request router that can be tested without a listening socket."""
-
-    def __init__(self, service: ControlPlaneService | None = None) -> None:
-        self.service = service or ControlPlaneService()
-
-    @staticmethod
-    def context_from_headers(headers: Mapping[str, str]) -> RequestContext:
-        authenticated = str(headers.get(AUTHENTICATED_HEADER, "")).strip().lower()
-        if authenticated not in {"1", "true", "yes"}:
-            raise Unauthorized("trusted authentication assertion is required")
-        roles = [
-            role.strip()
-            for role in str(headers.get(ROLES_HEADER, "")).split(",")
-            if role.strip()
-        ]
-        return RequestContext.create(
-            tenant_id=str(headers.get(TENANT_HEADER, "")),
-            principal_id=str(headers.get(PRINCIPAL_HEADER, "")),
-            trace_id=str(headers.get(TRACE_HEADER, "")).strip() or None,
-            session_id=str(headers.get(SESSION_HEADER, "")).strip() or None,
-            policy_version=str(headers.get(POLICY_HEADER, "v1")).strip() or "v1",
-            roles=roles,
-        )
-
-    def handle(
-        self,
-        method: str,
-        raw_path: str,
-        headers: Mapping[str, str],
-        body: Any = None,
-    ) -> tuple[int, Mapping[str, Any]]:
-        parsed = urllib.parse.urlparse(raw_path)
-        path = parsed.path.rstrip("/") or "/"
-        query = urllib.parse.parse_qs(parsed.query, keep_blank_values=False)
-        method = method.upper()
-
-        if method == "GET" and path in {"/healthz", "/api/v2/health"}:
-            return HTTPStatus.OK, {
-                "service": "aios-v2-control-plane",
-                "status": "ok",
-                "store": type(self.service.store).__name__,
-            }
-
-        context = self.context_from_headers(headers)
-        payload = _require_mapping(body or {})
-
-        if method == "POST" and path == "/api/v2/tenants":
-            tenant = self.service.register_tenant(
-                context,
-                tenant_id=_require_resource_id(payload.get("tenant_id"), label="tenant_id"),
-                display_name=str(payload.get("display_name", "")),
-                metadata=_require_mapping(payload.get("metadata", {}), label="metadata"),
-            )
-            return HTTPStatus.CREATED, {"tenant": _json_value(tenant)}
-
-        if method == "GET" and path == "/api/v2/tenants/current":
-            tenant = self.service.get_tenant(context)
-            return HTTPStatus.OK, {"tenant": _json_value(tenant)}
-
-        if method == "POST" and path == "/api/v2/agents":
-            agent = self.service.register_agent(
-                context,
-                agent_id=_require_resource_id(payload.get("agent_id"), label="agent_id"),
-                display_name=str(payload.get("display_name", "")),
-                runtime=str(payload.get("runtime", "")),
-                capabilities=payload.get("capabilities", ()),
-                metadata=_require_mapping(payload.get("metadata", {}), label="metadata"),
-            )
-            return HTTPStatus.CREATED, {"agent": _json_value(agent)}
-
-        if method == "GET" and path == "/api/v2/agents":
-            return HTTPStatus.OK, {
-                "agents": _json_value(self.service.list_agents(context))
-            }
-
-        agent_match = re.fullmatch(r"/api/v2/agents/([^/]+)", path)
-        if method == "GET" and agent_match:
-            agent_id = _require_resource_id(
-                urllib.parse.unquote(agent_match.group(1)), label="agent_id"
-            )
-            return HTTPStatus.OK, {
-                "agent": _json_value(self.service.get_agent(context, agent_id))
-            }
-
-        if method == "POST" and path == "/api/v2/tasks":
-            task = self.service.create_task(
-                context,
-                agent_id=_require_resource_id(payload.get("agent_id"), label="agent_id"),
-                action=str(payload.get("action", "")).strip(),
-                payload=_require_mapping(payload.get("payload", {}), label="payload"),
-                idempotency_key=(
-                    str(payload["idempotency_key"]).strip()
-                    if payload.get("idempotency_key") is not None
-                    else None
-                ),
-            )
-            return HTTPStatus.CREATED, {"task": _json_value(task)}
-
-        if method == "GET" and path == "/api/v2/tasks":
-            requested_states = query.get("state")
-            tasks = self.service.list_tasks(context, states=requested_states)
-            return HTTPStatus.OK, {"tasks": _json_value(tasks)}
-
-        task_match = re.fullmatch(r"/api/v2/tasks/([^/]+)", path)
-        if method == "GET" and task_match:
-            task_id = _require_resource_id(
-                urllib.parse.unquote(task_match.group(1)), label="task_id"
-            )
-            return HTTPStatus.OK, {
-                "task": _json_value(self.service.get_task(context, task_id))
-            }
-
-        transition_match = re.fullmatch(
-            r"/api/v2/tasks/([^/]+)/(approve|start|complete|fail|cancel)", path
-        )
-        if method == "POST" and transition_match:
-            task_id = _require_resource_id(
-                urllib.parse.unquote(transition_match.group(1)), label="task_id"
-            )
-            transition = transition_match.group(2)
-            target = {
-                "approve": TaskState.APPROVED,
-                "start": TaskState.RUNNING,
-                "complete": TaskState.COMPLETED,
-                "fail": TaskState.FAILED,
-                "cancel": TaskState.CANCELLED,
-            }[transition]
-            expected_revision = payload.get("expected_revision")
-            if expected_revision is not None:
-                expected_revision = int(expected_revision)
-            task = self.service.transition_task(
-                context,
-                task_id=task_id,
-                target_state=target,
-                expected_revision=expected_revision,
-                result=(
-                    _require_mapping(payload.get("result"), label="result")
-                    if payload.get("result") is not None
-                    else None
-                ),
-                error=(
-                    _require_mapping(payload.get("error"), label="error")
-                    if payload.get("error") is not None
-                    else None
-                ),
-            )
-            return HTTPStatus.OK, {"task": _json_value(task)}
-
-        if method == "GET" and path == "/api/v2/audit":
-            resource_id = query.get("resource_id", [None])[0]
-            events = self.service.list_audit_events(
-                context,
-                resource_id=(
-                    _require_resource_id(resource_id, label="resource_id")
-                    if resource_id
-                    else None
-                ),
-            )
-            return HTTPStatus.OK, {"events": _json_value(events)}
-
-        return HTTPStatus.NOT_FOUND, {
-            "error": "not_found",
-            "message": "route not found",
-        }
-
-
-_ERROR_STATUS: tuple[tuple[type[BaseException], HTTPStatus], ...] = (
-    (Unauthorized, HTTPStatus.UNAUTHORIZED),
-    (PolicyDenied, HTTPStatus.FORBIDDEN),
-    (TenantIsolationError, HTTPStatus.NOT_FOUND),
-    (NotFound, HTTPStatus.NOT_FOUND),
-    (IdempotencyConflict, HTTPStatus.CONFLICT),
-    (RevisionConflict, HTTPStatus.CONFLICT),
-    (InvalidTransition, HTTPStatus.CONFLICT),
-    (ValueError, HTTPStatus.BAD_REQUEST),
-    (ControlPlaneError, HTTPStatus.BAD_REQUEST),
-)
-
-
-def error_response(exc: BaseException) -> tuple[int, Mapping[str, Any]]:
-    for error_type, status in _ERROR_STATUS:
-        if isinstance(exc, error_type):
-            return status, {
-                "error": error_type.__name__,
-                "message": str(exc),
-            }
-    return HTTPStatus.INTERNAL_SERVER_ERROR, {
-        "error": "InternalServerError",
-        "message": "internal server error",
-    }
-
-
-class GatewayRequestHandler(BaseHTTPRequestHandler):
-    server_version = "AIOSV2Gateway/1.0"
-    max_body_bytes = 1_048_576
-
-    @property
-    def application(self) -> GatewayApplication:
-        return self.server.application  # type: ignore[attr-defined]
-
-    def _read_body(self) -> Any:
-        length = int(self.headers.get("Content-Length", "0") or "0")
-        if length < 0 or length > self.max_body_bytes:
-            raise ValueError("request body is too large")
-        if length == 0:
-            return {}
-        content_type = self.headers.get("Content-Type", "").split(";", 1)[0].strip()
-        if content_type != "application/json":
-            raise ValueError("Content-Type must be application/json")
-        raw = self.rfile.read(length)
-        return json.loads(raw.decode("utf-8"))
-
-    def _send_json(self, status: int, payload: Mapping[str, Any]) -> None:
-        encoded = json.dumps(
-            _json_value(payload), ensure_ascii=False, separators=(",", ":")
-        ).encode("utf-8")
-        self.send_response(int(status))
-        self.send_header("Content-Type", "application/json; charset=utf-8")
-        self.send_header("Content-Length", str(len(encoded)))
-        self.send_header("Cache-Control", "no-store")
-        self.send_header("X-Content-Type-Options", "nosniff")
-        self.end_headers()
-        self.wfile.write(encoded)
-
-    def _dispatch(self, method: str) -> None:
-        try:
-            body = self._read_body() if method in {"POST", "PUT", "PATCH"} else {}
-            status, payload = self.application.handle(
-                method,
-                self.path,
-                {key: value for key, value in self.headers.items()},
-                body,
-            )
-        except BaseException as exc:  # handler boundary; sanitized below
-            status, payload = error_response(exc)
-        self._send_json(status, payload)
-
-    def do_GET(self) -> None:  # noqa: N802
-        self._dispatch("GET")
-
-    def do_POST(self) -> None:  # noqa: N802
-        self._dispatch("POST")
-
-    def log_message(self, format: str, *args: Any) -> None:
-        # Production deployment routes structured access logs through the
-        # reverse proxy; do not log identity headers or request bodies here.
-        super().log_message(format, *args)
-
-
-class GatewayHTTPServer(ThreadingHTTPServer):
-    daemon_threads = True
-    allow_reuse_address = True
-
-    def __init__(
-        self,
-        server_address: tuple[str, int],
-        application: GatewayApplication,
-    ) -> None:
-        self.application = application
-        super().__init__(server_address, GatewayRequestHandler)
-
-
-def main() -> None:
-    host = os.getenv("AIOS_V2_GATEWAY_HOST", "127.0.0.1")
-    port = int(os.getenv("AIOS_V2_GATEWAY_PORT", "18920"))
-    server = GatewayHTTPServer((host, port), GatewayApplication())
-    print(f"AIOS V2 control-plane gateway listening on {host}:{port}")
-    server.serve_forever()
-
-
-if __name__ == "__main__":
-    main()
@@ -1,123 +0,0 @@
-"""Sanitized GitOps runtime status for the AIOS Web control plane."""
-from __future__ import annotations
-
-import os
-import subprocess
-from dataclasses import dataclass, asdict
-from pathlib import Path
-from typing import Any, Mapping
-
-
-@dataclass(frozen=True)
-class GitOpsStatus:
-    available: bool
-    service_status: str
-    workspace_mode: str
-    workspace_branch: str | None
-    workspace_ref: str | None
-    workspace_dirty: bool | None
-    candidate_branch: str
-    release_channel: str
-    release_version: str
-    sync_status: str
-    details: Mapping[str, Any]
-
-    def as_dict(self) -> dict[str, Any]:
-        return asdict(self)
-
-
-def _run_git(worktree: Path, *args: str) -> tuple[int, str, str]:
-    process = subprocess.run(
-        ["git", "-C", str(worktree), *args],
-        text=True,
-        capture_output=True,
-        timeout=5,
-    )
-    return process.returncode, process.stdout.strip(), process.stderr.strip()
-
-
-def collect_gitops_status() -> GitOpsStatus:
-    """Return only non-sensitive Git/workspace metadata.
-
-    Remote URLs, environment values, credentials, filesystem contents and
-    command stderr are deliberately excluded from the Web response.
-    """
-
-    candidate_branch = os.getenv(
-        "AIOS_CANDIDATE_BRANCH",
-        "integration/aios-v2r1-cto-production-candidate-20260720",
-    )
-    release_channel = os.getenv("AIOS_RELEASE_CHANNEL", "candidate")
-    release_version = os.getenv("AIOS_RELEASE_VERSION", "V2R1C0-candidate")
-    sync_status = os.getenv("AIOS_GITOPS_SYNC_STATUS", "unknown")
-    worktree = Path(
-        os.getenv(
-            "AIOS_GITOPS_CONTROLLER_WORKTREE",
-            "/data/aios-gitops/worktrees/controller",
-        )
-    )
-
-    if not worktree.is_dir():
-        return GitOpsStatus(
-            available=False,
-            service_status="unknown",
-            workspace_mode="unavailable",
-            workspace_branch=None,
-            workspace_ref=None,
-            workspace_dirty=None,
-            candidate_branch=candidate_branch,
-            release_channel=release_channel,
-            release_version=release_version,
-            sync_status=sync_status,
-            details={"reason": "controller_worktree_unavailable"},
-        )
-
-    inside_code, inside, _ = _run_git(worktree, "rev-parse", "--is-inside-work-tree")
-    if inside_code != 0 or inside != "true":
-        return GitOpsStatus(
-            available=False,
-            service_status="unknown",
-            workspace_mode="invalid",
-            workspace_branch=None,
-            workspace_ref=None,
-            workspace_dirty=None,
-            candidate_branch=candidate_branch,
-            release_channel=release_channel,
-            release_version=release_version,
-            sync_status=sync_status,
-            details={"reason": "controller_worktree_invalid"},
-        )
-
-    branch_code, branch, _ = _run_git(worktree, "branch", "--show-current")
-    ref_code, ref_value, _ = _run_git(worktree, "rev-parse", "HEAD")
-    dirty_code, dirty_value, _ = _run_git(worktree, "status", "--porcelain=v1")
-
-    service_status = "unknown"
-    try:
-        process = subprocess.run(
-            ["systemctl", "is-active", "aios-gitops-model-api"],
-            text=True,
-            capture_output=True,
-            timeout=3,
-        )
-        service_status = process.stdout.strip() or "inactive"
-    except (FileNotFoundError, subprocess.TimeoutExpired):
-        service_status = "unavailable"
-
-    branch_value = branch if branch_code == 0 and branch else None
-    return GitOpsStatus(
-        available=True,
-        service_status=service_status,
-        workspace_mode="branch" if branch_value else "detached",
-        workspace_branch=branch_value,
-        workspace_ref=ref_value if ref_code == 0 else None,
-        workspace_dirty=bool(dirty_value) if dirty_code == 0 else None,
-        candidate_branch=candidate_branch,
-        release_channel=release_channel,
-        release_version=release_version,
-        sync_status=sync_status,
-        details={
-            "controller_clean": dirty_code == 0 and not dirty_value,
-            "controller_detached": branch_code == 0 and not branch,
-        },
-    )
@@ -1,264 +0,0 @@
-"""AIOS V2 execution orchestrator.
-
-The orchestrator is the only component allowed to translate an approved AIOS
-task into an OpenClaw command or Hermes job. OpenClaw and Hermes remain pure
-execution runtimes and never own tenant policy or task lifecycle.
-"""
-from __future__ import annotations
-
-from dataclasses import dataclass
-from typing import Any, Mapping
-
-from aios_hermes import HermesAdapter, HermesJob, HermesResult
-from aios_openclaw import (
-    CommandState,
-    OpenClawAdapter,
-    OpenClawCommand,
-    OpenClawResult,
-    sign_command,
-)
-
-from .control_plane import (
-    AgentRecord,
-    ControlPlaneService,
-    RequestContext,
-    TaskRecord,
-    TaskState,
-)
-
-
-class OrchestrationError(RuntimeError):
-    """AIOS failed to dispatch or reconcile a runtime execution."""
-
-
-@dataclass(frozen=True)
-class DispatchRecord:
-    tenant_id: str
-    task_id: str
-    agent_id: str
-    runtime: str
-    runtime_execution_id: str
-    state: str
-    trace_id: str
-
-
-class ExecutionOrchestrator:
-    """Dispatch approved AIOS tasks to runtime adapters and reconcile results."""
-
-    def __init__(
-        self,
-        control_plane: ControlPlaneService,
-        *,
-        openclaw: OpenClawAdapter | None = None,
-        hermes: HermesAdapter | None = None,
-        openclaw_signing_material_resolver=None,
-        openclaw_key_id: str = "default",
-        default_cell_id: str = "default",
-        default_profile_id: str = "default",
-    ) -> None:
-        self.control_plane = control_plane
-        self.openclaw = openclaw
-        self.hermes = hermes
-        self.openclaw_signing_material_resolver = openclaw_signing_material_resolver
-        self.openclaw_key_id = openclaw_key_id
-        self.default_cell_id = default_cell_id
-        self.default_profile_id = default_profile_id
-        self._dispatches: dict[tuple[str, str], DispatchRecord] = {}
-
-    def dispatch(
-        self,
-        context: RequestContext,
-        *,
-        task_id: str,
-        timeout_seconds: float | None = None,
-    ) -> DispatchRecord:
-        task = self.control_plane.get_task(context, task_id)
-        if task.state != TaskState.APPROVED:
-            raise OrchestrationError("only APPROVED tasks may be dispatched")
-        agent = self.control_plane.get_agent(context, task.agent_id)
-        existing = self._dispatches.get((task.tenant_id, task.task_id))
-        if existing is not None:
-            return existing
-
-        running = self.control_plane.transition_task(
-            context,
-            task_id=task.task_id,
-            target_state=TaskState.RUNNING,
-            expected_revision=task.revision,
-        )
-
-        runtime = agent.runtime.strip().lower()
-        try:
-            if runtime == "openclaw":
-                record = self._dispatch_openclaw(
-                    context,
-                    agent,
-                    running,
-                    timeout_seconds=timeout_seconds,
-                )
-            elif runtime == "hermes":
-                record = self._dispatch_hermes(context, agent, running)
-            else:
-                raise OrchestrationError(f"unsupported runtime: {agent.runtime}")
-        except Exception as exc:
-            current = self.control_plane.get_task(context, task.task_id)
-            if current.state == TaskState.RUNNING:
-                self.control_plane.transition_task(
-                    context,
-                    task_id=task.task_id,
-                    target_state=TaskState.FAILED,
-                    expected_revision=current.revision,
-                    error={"code": "dispatch_failed", "message": str(exc)},
-                )
-            raise
-
-        self._dispatches[(task.tenant_id, task.task_id)] = record
-        return record
-
-    def _dispatch_openclaw(
-        self,
-        context: RequestContext,
-        agent: AgentRecord,
-        task: TaskRecord,
-        *,
-        timeout_seconds: float | None,
-    ) -> DispatchRecord:
-        if self.openclaw is None or self.openclaw_signing_material_resolver is None:
-            raise OrchestrationError("OpenClaw runtime is not configured")
-        key_material = self.openclaw_signing_material_resolver(
-            task.tenant_id,
-            self.openclaw_key_id,
-        )
-        command = OpenClawCommand.create(
-            tenant_id=task.tenant_id,
-            task_id=task.task_id,
-            trace_id=context.trace_id,
-            action=task.action,
-            payload=task.payload,
-            idempotency_key=task.idempotency_key or task.task_id,
-            key_id=self.openclaw_key_id,
-        )
-        command = sign_command(command, key_material)
-        result = self.openclaw.execute(command, timeout_seconds=timeout_seconds)
-        self.reconcile_openclaw(context, result)
-        return DispatchRecord(
-            tenant_id=task.tenant_id,
-            task_id=task.task_id,
-            agent_id=agent.agent_id,
-            runtime="openclaw",
-            runtime_execution_id=command.command_id,
-            state=result.state.value,
-            trace_id=context.trace_id,
-        )
-
-    def _dispatch_hermes(
-        self,
-        context: RequestContext,
-        agent: AgentRecord,
-        task: TaskRecord,
-    ) -> DispatchRecord:
-        if self.hermes is None:
-            raise OrchestrationError("Hermes runtime is not configured")
-        metadata = dict(agent.metadata)
-        job = HermesJob.create(
-            tenant_id=task.tenant_id,
-            cell_id=str(metadata.get("cell_id") or self.default_cell_id),
-            profile_id=str(metadata.get("profile_id") or self.default_profile_id),
-            task_id=task.task_id,
-            trace_id=context.trace_id,
-            action=task.action,
-            payload=task.payload,
-            idempotency_key=task.idempotency_key or task.task_id,
-            priority=int(metadata.get("priority", 100)),
-        )
-        queued = self.hermes.enqueue(job)
-        return DispatchRecord(
-            tenant_id=task.tenant_id,
-            task_id=task.task_id,
-            agent_id=agent.agent_id,
-            runtime="hermes",
-            runtime_execution_id=queued.job_id,
-            state=queued.state.value,
-            trace_id=context.trace_id,
-        )
-
-    def reconcile_openclaw(
-        self,
-        context: RequestContext,
-        result: OpenClawResult,
-    ) -> TaskRecord:
-        task = self.control_plane.get_task(context, result.task_id)
-        if result.tenant_id != task.tenant_id:
-            raise OrchestrationError("OpenClaw result tenant mismatch")
-        if task.state != TaskState.RUNNING:
-            return task
-        if result.state == CommandState.COMPLETED:
-            return self.control_plane.transition_task(
-                context,
-                task_id=task.task_id,
-                target_state=TaskState.COMPLETED,
-                expected_revision=task.revision,
-                result=result.output or {},
-            )
-        if result.state in {
-            CommandState.FAILED,
-            CommandState.TIMED_OUT,
-            CommandState.REJECTED,
-        }:
-            return self.control_plane.transition_task(
-                context,
-                task_id=task.task_id,
-                target_state=TaskState.FAILED,
-                expected_revision=task.revision,
-                error=result.error or {"code": result.state.value.lower()},
-            )
-        if result.state == CommandState.CANCELLED:
-            return self.control_plane.transition_task(
-                context,
-                task_id=task.task_id,
-                target_state=TaskState.CANCELLED,
-                expected_revision=task.revision,
-            )
-        return task
-
-    def reconcile_hermes(
-        self,
-        context: RequestContext,
-        result: HermesResult,
-    ) -> TaskRecord:
-        task = self.control_plane.get_task(context, result.task_id)
-        if result.tenant_id != task.tenant_id:
-            raise OrchestrationError("Hermes result tenant mismatch")
-        if task.state != TaskState.RUNNING:
-            return task
-        if result.state.value == "COMPLETED":
-            return self.control_plane.transition_task(
-                context,
-                task_id=task.task_id,
-                target_state=TaskState.COMPLETED,
-                expected_revision=task.revision,
-                result=result.output or {},
-            )
-        if result.state.value == "FAILED":
-            return self.control_plane.transition_task(
-                context,
-                task_id=task.task_id,
-                target_state=TaskState.FAILED,
-                expected_revision=task.revision,
-                error=result.error or {"code": "hermes_failed"},
-            )
-        if result.state.value == "CANCELLED":
-            return self.control_plane.transition_task(
-                context,
-                task_id=task.task_id,
-                target_state=TaskState.CANCELLED,
-                expected_revision=task.revision,
-            )
-        return task
-
-    def dispatch_snapshot(self, *, tenant_id: str) -> Mapping[str, DispatchRecord]:
-        return {
-            task_id: record
-            for (record_tenant, task_id), record in self._dispatches.items()
-            if record_tenant == tenant_id
-        }
@@ -1,181 +0,0 @@
-"""Durable single-process persistence for the AIOS V2 control plane.
-
-The candidate uses an atomic SQLite snapshot so a gateway restart does not lose
-tenants, agents, task state, idempotency records, or audit events.  The domain
-service remains storage-agnostic; a later HA backend can replace this module
-without changing API or runtime-adapter contracts.
-"""
-from __future__ import annotations
-
-import json
-import sqlite3
-import threading
-from dataclasses import asdict
-from pathlib import Path
-from typing import Any, Callable
-
-from .control_plane import (
-    AgentRecord,
-    AuditEvent,
-    ControlPlaneService,
-    InMemoryControlPlaneStore,
-    TaskRecord,
-    TaskState,
-    TenantRecord,
-)
-
-
-class SQLiteSnapshotRepository:
-    """Store one versioned control-plane snapshot in SQLite."""
-
-    SCHEMA_VERSION = 1
-
-    def __init__(self, path: str | Path) -> None:
-        self.path = Path(path).resolve()
-        self.path.parent.mkdir(parents=True, exist_ok=True)
-        self._lock = threading.RLock()
-        self._initialize()
-
-    def _connect(self) -> sqlite3.Connection:
-        connection = sqlite3.connect(self.path, timeout=30.0)
-        connection.execute("PRAGMA journal_mode=WAL")
-        connection.execute("PRAGMA synchronous=FULL")
-        connection.execute("PRAGMA foreign_keys=ON")
-        return connection
-
-    def _initialize(self) -> None:
-        with self._connect() as connection:
-            connection.execute(
-                """
-                CREATE TABLE IF NOT EXISTS control_plane_snapshot (
-                    singleton_id INTEGER PRIMARY KEY CHECK (singleton_id = 1),
-                    schema_version INTEGER NOT NULL,
-                    payload_json TEXT NOT NULL,
-                    updated_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP
-                )
-                """
-            )
-
-    def load(self) -> dict[str, Any] | None:
-        with self._lock, self._connect() as connection:
-            row = connection.execute(
-                "SELECT schema_version, payload_json FROM control_plane_snapshot WHERE singleton_id = 1"
-            ).fetchone()
-        if row is None:
-            return None
-        schema_version, payload_json = row
-        if int(schema_version) != self.SCHEMA_VERSION:
-            raise RuntimeError(
-                f"unsupported control-plane snapshot version: {schema_version}"
-            )
-        decoded = json.loads(str(payload_json))
-        if not isinstance(decoded, dict):
-            raise RuntimeError("invalid control-plane snapshot")
-        return decoded
-
-    def save(self, payload: dict[str, Any]) -> None:
-        encoded = json.dumps(
-            payload,
-            ensure_ascii=False,
-            sort_keys=True,
-            separators=(",", ":"),
-            default=str,
-        )
-        with self._lock, self._connect() as connection:
-            connection.execute("BEGIN IMMEDIATE")
-            connection.execute(
-                """
-                INSERT INTO control_plane_snapshot (
-                    singleton_id, schema_version, payload_json, updated_at
-                ) VALUES (1, ?, ?, CURRENT_TIMESTAMP)
-                ON CONFLICT(singleton_id) DO UPDATE SET
-                    schema_version = excluded.schema_version,
-                    payload_json = excluded.payload_json,
-                    updated_at = CURRENT_TIMESTAMP
-                """,
-                (self.SCHEMA_VERSION, encoded),
-            )
-            connection.commit()
-
-
-class DurableControlPlaneService(ControlPlaneService):
-    """Control-plane service that persists after every successful mutation."""
-
-    def __init__(
-        self,
-        repository: SQLiteSnapshotRepository,
-        *,
-        policy_evaluator=None,
-    ) -> None:
-        self.repository = repository
-        store = InMemoryControlPlaneStore()
-        self._restore(store, repository.load())
-        super().__init__(store, policy_evaluator=policy_evaluator)
-
-    @staticmethod
-    def _restore(
-        store: InMemoryControlPlaneStore,
-        snapshot: dict[str, Any] | None,
-    ) -> None:
-        if not snapshot:
-            return
-        for item in snapshot.get("tenants", []):
-            record = TenantRecord(**item)
-            store.tenants[record.tenant_id] = record
-        for item in snapshot.get("agents", []):
-            normalized = dict(item)
-            normalized["capabilities"] = tuple(normalized.get("capabilities", ()))
-            record = AgentRecord(**normalized)
-            store.agents[record.agent_id] = record
-        for item in snapshot.get("tasks", []):
-            normalized = dict(item)
-            normalized["state"] = TaskState(normalized["state"])
-            record = TaskRecord(**normalized)
-            store.tasks[record.task_id] = record
-        store.audit_events.extend(AuditEvent(**item) for item in snapshot.get("audit", []))
-        for item in snapshot.get("idempotency", []):
-            store.idempotency[(item["tenant_id"], item["key"])] = (
-                item["task_id"],
-                item["digest"],
-            )
-
-    def _snapshot(self) -> dict[str, Any]:
-        with self.store.lock:
-            return {
-                "schema_version": self.repository.SCHEMA_VERSION,
-                "tenants": [asdict(item) for item in self.store.tenants.values()],
-                "agents": [asdict(item) for item in self.store.agents.values()],
-                "tasks": [
-                    {**asdict(item), "state": item.state.value}
-                    for item in self.store.tasks.values()
-                ],
-                "audit": [asdict(item) for item in self.store.audit_events],
-                "idempotency": [
-                    {
-                        "tenant_id": tenant_id,
-                        "key": key,
-                        "task_id": task_id,
-                        "digest": digest,
-                    }
-                    for (tenant_id, key), (task_id, digest)
-                    in self.store.idempotency.items()
-                ],
-            }
-
-    def _mutate(self, operation: Callable[[], Any]) -> Any:
-        with self.store.lock:
-            result = operation()
-            self.repository.save(self._snapshot())
-            return result
-
-    def register_tenant(self, *args, **kwargs):
-        return self._mutate(lambda: super(DurableControlPlaneService, self).register_tenant(*args, **kwargs))
-
-    def register_agent(self, *args, **kwargs):
-        return self._mutate(lambda: super(DurableControlPlaneService, self).register_agent(*args, **kwargs))
-
-    def create_task(self, *args, **kwargs):
-        return self._mutate(lambda: super(DurableControlPlaneService, self).create_task(*args, **kwargs))
-
-    def transition_task(self, *args, **kwargs):
-        return self._mutate(lambda: super(DurableControlPlaneService, self).transition_task(*args, **kwargs))
@@ -0,0 +1,355 @@
+"""Fail-closed access to the authoritative bare Git repository."""
+from __future__ import annotations
+
+import os
+import re
+import subprocess
+import urllib.parse
+from pathlib import Path
+from typing import Iterable
+
+_ALLOWED_COMMANDS = frozenset(
+    {
+        "cat-file",
+        "config",
+        "diff",
+        "for-each-ref",
+        "ls-remote",
+        "merge-base",
+        "push",
+        "remote",
+        "rev-parse",
+        "show-ref",
+        "tag",
+    }
+)
+_OID_RE = re.compile(r"^[0-9a-f]{40}$")
+_MAX_OUTPUT = 1_048_576
+_TIMEOUT = 8.0
+
+
+class AuthoritativeGitError(RuntimeError):
+    """A fail-closed authoritative repository or ref query error."""
+
+
+class AuthoritativeGitNotFound(AuthoritativeGitError):
+    """A validated revision does not exist in the authoritative repository."""
+
+
+class AuthoritativeGitOutputTooLarge(AuthoritativeGitError):
+    """A controlled Git query exceeded the response-size boundary."""
+
+
+def _redact(text: str) -> str:
+    value = str(text or "")
+    value = re.sub(r"(?i)(authorization\s*[:=]\s*)(?:bearer|token)\s+\S+", r"\1REDACTED", value)
+    value = re.sub(r"(?i)((?:access_)?token\s*[:=]\s*)\S+", r"\1REDACTED", value)
+    value = re.sub(r"(?i)(https?://[^/\s:@]+:)[^@\s/]+@", r"\1REDACTED@", value)
+    return value
+
+
+def _configured_path(git_dir: str | Path | None = None) -> Path:
+    raw = str(git_dir or os.getenv("AIOS_GITOPS_AUTHORITATIVE_GIT_DIR", "")).strip()
+    if not raw:
+        raise AuthoritativeGitError("AUTHORITATIVE_REPOSITORY_UNAVAILABLE")
+    path = Path(raw)
+    if not path.is_absolute() or ".." in path.parts:
+        raise AuthoritativeGitError("AUTHORITATIVE_REPOSITORY_UNAVAILABLE")
+    try:
+        resolved = path.resolve(strict=True)
+    except OSError as exc:
+        raise AuthoritativeGitError("AUTHORITATIVE_REPOSITORY_UNAVAILABLE") from exc
+    if not resolved.is_dir():
+        raise AuthoritativeGitError("AUTHORITATIVE_REPOSITORY_UNAVAILABLE")
+    return resolved
+
+
+def _run(
+    git_dir: Path,
+    args: list[str],
+    *,
+    check: bool,
+    timeout: float = _TIMEOUT,
+) -> subprocess.CompletedProcess[str]:
+    if not args or args[0] not in _ALLOWED_COMMANDS:
+        raise AuthoritativeGitError("GIT_REF_QUERY_FAILED")
+    try:
+        result = subprocess.run(
+            ["git", "--git-dir", str(git_dir), *args],
+            text=True,
+            capture_output=True,
+            timeout=timeout,
+            env={**os.environ, "GIT_OPTIONAL_LOCKS": "0"},
+        )
+    except (OSError, subprocess.TimeoutExpired) as exc:
+        raise AuthoritativeGitError("GIT_REF_QUERY_FAILED") from exc
+    if len(result.stdout) + len(result.stderr) > _MAX_OUTPUT:
+        raise AuthoritativeGitOutputTooLarge("GIT_OUTPUT_LIMIT_EXCEEDED")
+    if check and result.returncode != 0:
+        detail = _redact(result.stderr.strip() or result.stdout.strip())
+        raise AuthoritativeGitError(
+            "GIT_REF_QUERY_FAILED" + (f": {detail[:160]}" if detail else "")
+        )
+    return result
+
+
+def _repository_identity_from_remote(url: str) -> str:
+    value = str(url or "").strip().split("?", 1)[0].rstrip("/")
+    if not value:
+        return ""
+    if "://" in value:
+        value = urllib.parse.urlparse(value).path
+    elif ":" in value:
+        value = value.rsplit(":", 1)[1]
+    value = value.rsplit("@", 1)[-1].strip("/")
+    value = re.sub(r"\.git$", "", value, flags=re.IGNORECASE)
+    parts = [part for part in value.split("/") if part]
+    if len(parts) >= 2:
+        value = "/".join(parts[-2:])
+    return value.strip("/").lower()
+
+
+def verify_repository(
+    git_dir: str | Path | None = None,
+    repository_identity: str | None = None,
+) -> tuple[Path, str]:
+    path = _configured_path(git_dir)
+    expected = str(
+        repository_identity
+        or os.getenv("AIOS_GITOPS_REPOSITORY_IDENTITY", "")
+    ).strip().strip("/")
+    if not expected or expected.count("/") != 1:
+        raise AuthoritativeGitError("REPOSITORY_IDENTITY_MISMATCH")
+    bare = _run(path, ["rev-parse", "--is-bare-repository"], check=True)
+    if bare.stdout.strip().lower() != "true":
+        raise AuthoritativeGitError("AUTHORITATIVE_REPOSITORY_UNAVAILABLE")
+    remote = _run(path, ["config", "--get", "remote.gitea.url"], check=False)
+    actual = _repository_identity_from_remote(remote.stdout)
+    if actual != expected.lower():
+        raise AuthoritativeGitError("REPOSITORY_IDENTITY_MISMATCH")
+    return path, expected
+
+
+def run_authoritative_git(
+    args: list[str],
+    *,
+    check: bool = True,
+    git_dir: str | Path | None = None,
+    timeout: float = _TIMEOUT,
+) -> subprocess.CompletedProcess[str]:
+    path, _ = verify_repository(git_dir=git_dir)
+    return _run(path, list(args), check=check, timeout=timeout)
+
+
+def authoritative_head_oid(
+    *,
+    git_dir: str | Path | None = None,
+) -> str:
+    result = run_authoritative_git(["rev-parse", "--verify", "refs/heads/main"], git_dir=git_dir)
+    oid = result.stdout.strip().lower()
+    if not _OID_RE.fullmatch(oid):
+        raise AuthoritativeGitError("GIT_REF_QUERY_FAILED")
+    return oid
+
+
+def authoritative_tags(
+    *,
+    git_dir: str | Path | None = None,
+) -> list[dict[str, str | None]]:
+    result = run_authoritative_git(
+        [
+            "for-each-ref",
+            "refs/tags",
+            "--format=%(refname:strip=2)\t%(objectname)\t%(objecttype)",
+        ],
+        git_dir=git_dir,
+    )
+    tags: list[dict[str, str | None]] = []
+    for line in result.stdout.splitlines():
+        name, oid, object_type = (line.split("\t", 2) + ["", ""])[:3]
+        if not name or not _OID_RE.fullmatch(oid.lower()):
+            raise AuthoritativeGitError("GIT_REF_QUERY_FAILED")
+        peeled_result = run_authoritative_git(
+            ["rev-parse", "--verify", f"refs/tags/{name}^{{commit}}"],
+            git_dir=git_dir,
+        )
+        peeled = peeled_result.stdout.strip().lower()
+        if not _OID_RE.fullmatch(peeled):
+            raise AuthoritativeGitError("GIT_REF_QUERY_FAILED")
+        tags.append(
+            {
+                "name": name,
+                "tag_oid": oid.lower(),
+                "object_type": object_type,
+                "peeled_target_oid": peeled,
+            }
+        )
+    return tags
+
+
+def authoritative_branches(
+    *,
+    git_dir: str | Path | None = None,
+) -> list[dict[str, str]]:
+    result = run_authoritative_git(
+        [
+            "for-each-ref",
+            "refs/heads",
+            "--format=%(refname:strip=2)\t%(objectname)",
+        ],
+        git_dir=git_dir,
+    )
+    branches: list[dict[str, str]] = []
+    for line in result.stdout.splitlines():
+        name, oid = (line.split("\t", 1) + [""])[:2]
+        if not name or not _OID_RE.fullmatch(oid.lower()):
+            raise AuthoritativeGitError("GIT_REF_QUERY_FAILED")
+        branches.append({"name": name, "oid": oid.lower()})
+    return branches
+
+
+def authoritative_commit(
+    oid: str,
+    *,
+    git_dir: str | Path | None = None,
+) -> str:
+    value = str(oid or "").strip().lower()
+    if not _OID_RE.fullmatch(value):
+        raise ValueError("commit OID must be a full 40-character value")
+    result = run_authoritative_git(
+        ["rev-parse", "--verify", f"{value}^{{commit}}"],
+        git_dir=git_dir,
+    )
+    resolved = result.stdout.strip().lower()
+    if resolved != value:
+        raise AuthoritativeGitError("GIT_REF_QUERY_FAILED")
+    return resolved
+
+
+def authoritative_lineage(
+    ancestor: str,
+    descendant: str,
+    *,
+    git_dir: str | Path | None = None,
+) -> None:
+    authoritative_commit(ancestor, git_dir=git_dir)
+    authoritative_commit(descendant, git_dir=git_dir)
+    result = run_authoritative_git(
+        ["merge-base", "--is-ancestor", ancestor, descendant],
+        check=False,
+        git_dir=git_dir,
+    )
+    if result.returncode != 0:
+        raise AuthoritativeGitError("evidence lineage mismatch")
+
+
+_SAFE_REF_RE = re.compile(r"^[A-Za-z0-9][A-Za-z0-9._/-]{0,239}$")
+
+
+def _safe_ref_name(value: str) -> bool:
+    return bool(
+        _SAFE_REF_RE.fullmatch(value)
+        and ".." not in value
+        and "//" not in value
+        and "@{" not in value
+        and not value.endswith(("/", ".", ".lock"))
+        and not any(part in {"", ".", ".."} for part in value.split("/"))
+    )
+
+
+def validate_git_revision(
+    value: str,
+    field: str,
+    *,
+    git_dir: str | Path | None = None,
+) -> str:
+    revision = str(value or "").strip()
+    if not revision or revision != str(value or "") or revision.startswith("-"):
+        raise ValueError(f"invalid {field} revision")
+    if _OID_RE.fullmatch(revision.lower()):
+        try:
+            return authoritative_commit(revision.lower(), git_dir=git_dir)
+        except AuthoritativeGitError as exc:
+            raise AuthoritativeGitNotFound(f"{field} revision not found") from exc
+    if not _safe_ref_name(revision) or any(token in revision for token in ("^", "~", ":", "\\")):
+        raise ValueError(f"invalid {field} revision")
+    if revision.startswith("refs/"):
+        if not revision.startswith(("refs/heads/", "refs/tags/")):
+            raise ValueError(f"invalid {field} revision")
+        candidates = [revision]
+    else:
+        candidates = [f"refs/heads/{revision}", f"refs/tags/{revision}"]
+    matches: list[str] = []
+    for candidate in candidates:
+        result = run_authoritative_git(
+            ["rev-parse", "--verify", f"{candidate}^{{commit}}"],
+            check=False,
+            git_dir=git_dir,
+        )
+        oid = result.stdout.strip().lower()
+        if result.returncode == 0 and _OID_RE.fullmatch(oid):
+            matches.append(oid)
+    if not matches:
+        raise AuthoritativeGitNotFound(f"{field} revision not found")
+    if len(set(matches)) != 1 or len(matches) != 1:
+        raise ValueError(f"ambiguous {field} revision")
+    return matches[0]
+
+
+def authoritative_diff(
+    from_revision: str,
+    to_revision: str,
+    *,
+    git_dir: str | Path | None = None,
+) -> dict[str, object]:
+    path, _ = verify_repository(git_dir=git_dir)
+    from_oid = validate_git_revision(from_revision, "from", git_dir=path)
+    to_oid = validate_git_revision(to_revision, "to", git_dir=path)
+    args = ["diff", "--no-ext-diff", "--no-textconv", from_oid, to_oid]
+    result = run_authoritative_git(args, git_dir=path)
+    return {
+        "code": 0,
+        "stdout": result.stdout,
+        "stderr": "",
+        "cmd": ["git", f"--git-dir={path}", *args],
+        "from_oid": from_oid,
+        "to_oid": to_oid,
+    }
+
+
+def repository_snapshot(
+    *,
+    git_dir: str | Path | None = None,
+    repository_identity: str | None = None,
+) -> dict[str, object]:
+    configured = bool(
+        str(git_dir or os.getenv("AIOS_GITOPS_AUTHORITATIVE_GIT_DIR", "")).strip()
+    )
+    try:
+        path, identity = verify_repository(
+            git_dir=git_dir,
+            repository_identity=repository_identity,
+        )
+        head = authoritative_head_oid(git_dir=path)
+        return {
+            "repository_available": True,
+            "authoritative_git_dir_configured": configured,
+            "authoritative_git_dir_readable": True,
+            "authoritative_git_dir": str(path),
+            "authoritative_head_oid": head,
+            "repository_identity": identity,
+            "query_error": None,
+        }
+    except (AuthoritativeGitError, ValueError) as exc:
+        return {
+            "repository_available": False,
+            "authoritative_git_dir_configured": configured,
+            "authoritative_git_dir_readable": False,
+            "authoritative_git_dir": None,
+            "authoritative_head_oid": None,
+            "repository_identity": str(
+                repository_identity
+                or os.getenv("AIOS_GITOPS_REPOSITORY_IDENTITY", "")
+            ).strip() or None,
+            "query_error": _redact(str(exc)),
+        }
@@ -1,13 +1,25 @@
 {
-    "current_baseline": "V1R4C6",
-    "previous_baseline": "V1R4C5",
-    "promoted_at": "2026-07-11T21:00:00+08:00",
-    "git": "e204a90398bf646d46245b3088226749fa056edd",
-    "promoted_by": "openclaw/admin",
-    "promotion_reason": "V1R4C6 admin search agent integration, search gateway, agent platform, VERSION bump, merge tests deploy pipeline — not yet deployed to production",
-    "constraints": {
-        "memory_search_enabled": false,
-        "force_push_allowed": false,
-        "gitea_db_mutation_requires_owner_approval": true
-    }
-}
+  "current_baseline": "V2R1C2",
+  "previous_baseline": "V2R1C1",
+  "promoted_at": "2026-07-22T01:40:51Z",
+  "git": "3dd622b5a515f1fa4ef72b9f8ae9ce48ac703f24",
+  "promoted_by": "codex/owner-approved-gitops",
+  "promotion_reason": "Owner-authorized V2R1C2 Unified Portal production release after exact tag binding, complete evidence verification, and production acceptance PASS.",
+  "version": "V2R1C2",
+  "release_oid": "3dd622b5a515f1fa4ef72b9f8ae9ce48ac703f24",
+  "tag_oid": "a3bd84ebec9c705f7c9c5c03f7f4ec55f8854e36",
+  "target_oid": "3dd622b5a515f1fa4ef72b9f8ae9ce48ac703f24",
+  "release_run_id": "AIOS-V2R1C2-PRODUCTION-20260722T011836Z",
+  "status": "PRODUCTION_DEPLOYED",
+  "production_service": "aios-v2r1c2-production.service",
+  "production_port": 18920,
+  "rollback_version": "V2R1C1",
+  "constraints": {
+    "product_code_changed": true,
+    "production_redeployed": true,
+    "production_traffic_changed": true,
+    "tag_rewritten": false,
+    "force_push_allowed": false,
+    "rollback_assets_preserved": true
+  }
+}
@@ -0,0 +1,63 @@
+{
+  "schema_version": 2,
+  "automatic": [
+    "build",
+    "test",
+    "artifact",
+    "canary",
+    "evidence"
+  ],
+  "owner": [
+    "signed_release_plan"
+  ],
+  "forbidden": [
+    "force_push",
+    "tag_rewrite",
+    "direct_main_push",
+    "baseline_mutation",
+    "registry_mutation"
+  ],
+  "runtime_deployment": {
+    "approval_action": "signed_release_plan",
+    "required_capability": "runtime_switch",
+    "tag_operations_allowed": false,
+    "baseline_mutation_allowed": false,
+    "registry_mutation_allowed": false,
+    "writer_default": false,
+    "rollback_required": true
+  },
+  "tag_release": {
+    "approval_action": "signed_release_plan",
+    "required_capability": "tag_publish",
+    "separate_controller": true,
+    "duplicate_conflict": "fail_closed",
+    "rewrite_allowed": false,
+    "force_push_allowed": false
+  },
+  "baseline_registry_finalize": {
+    "approval_action": "signed_release_plan",
+    "required_capability": "baseline_registry_finalize",
+    "separate_controller": true,
+    "remote_tag_verification_required": true,
+    "gitea_api_verification_required": true,
+    "registry_baseline_consistency_required": true
+  },
+  "approval": {
+    "algorithm": "Ed25519",
+    "replay_protection": true,
+    "revocation_fail_closed": true,
+    "key_rotation_supported": true,
+    "capabilities": [
+      "runtime_switch",
+      "tag_publish",
+      "baseline_registry_finalize"
+    ]
+  },
+  "execution": {
+    "environment_variable": "AIOS_SILENT_RELEASE_EXECUTION_ENABLED",
+    "default_enabled": false,
+    "shadow_side_effects_allowed": false,
+    "durable_saga_required": true,
+    "pre_switch_revalidation_required": true
+  }
+}
@@ -0,0 +1,59 @@
+version: 1
+policy_id: gitops-isolated-worktree-governance-20260714T232948UTC8
+
+runtime_identity:
+  user: aiman
+  group: gitops
+  umask: "0002"
+  prohibit_root_workspace_writes: true
+
+repository:
+  source_worktree: /data/aios-gitops/workspace
+  bare_repo: /data/aios-gitops/repo.git
+  worktree_root: /data/aios-gitops/worktrees
+  remote: origin
+
+worktrees:
+  controller: /data/aios-gitops/worktrees/controller
+  task_pattern: /data/aios-gitops/worktrees/{agent}/{task_id}
+  allowed_agents:
+    - openclaw
+    - chatgpt
+    - controller
+  require_clean_start: true
+  remove_after_successful_push: true
+  retain_on_failure: true
+
+permissions:
+  owner: aiman
+  group: gitops
+  directory_mode: "2775"
+  file_mode: "0664"
+  default_acl:
+    user:aiman: rwx
+    group:gitops: rwx
+  apply_to:
+    - /data/aios-gitops
+    - /data/aios-gitops/worktrees
+
+preflight:
+  required_user: aiman
+  required_group: gitops
+  required_umask: "0002"
+  require_writable_git_dir: true
+  require_writable_task_dir: true
+  require_writable_result_dir: true
+  reject_shared_source_worktree: true
+  reject_existing_git_lock: true
+
+notifications:
+  owner_on_received: required
+  owner_on_terminal: required
+  preferred_channel: weixin
+  redact_secrets: true
+
+rollback:
+  preserve_source_worktree: true
+  remove_created_worktrees: true
+  restore_service_dropins: true
+  restore_service_state: true
@@ -0,0 +1,14 @@
+# Install as a systemd drop-in for GitOps/OpenClaw writer services.
+# Example: /etc/systemd/system/<service>.service.d/10-runtime-identity.conf
+
+[Service]
+User=aiman
+Group=gitops
+SupplementaryGroups=gitops
+UMask=0002
+Environment=AIOS_GITOPS_ROOT=/data/aios-gitops
+Environment=AIOS_BARE_REPO=/data/aios-gitops/repo.git
+Environment=AIOS_WORKTREE_ROOT=/data/aios-gitops/worktrees
+Environment=AIOS_RUNTIME_USER=aiman
+Environment=AIOS_RUNTIME_GROUP=gitops
+Environment=AIOS_RUNTIME_UMASK=0002
@@ -1,23 +0,0 @@
-FROM python:3.12-slim
-
-ENV PYTHONDONTWRITEBYTECODE=1 \
-    PYTHONUNBUFFERED=1 \
-    PYTHONPATH=/opt/aios/app \
-    AIOS_V2_HOST=0.0.0.0 \
-    AIOS_V2_PORT=18920 \
-    AIOS_V2_STATE_DIR=/var/lib/aios-v2
-
-RUN groupadd --system --gid 12001 aios \
-    && useradd --system --uid 12001 --gid aios --home-dir /nonexistent --shell /usr/sbin/nologin aios \
-    && install -d -o aios -g aios -m 0750 /opt/aios/app /var/lib/aios-v2
-
-WORKDIR /opt/aios/app
-COPY --chown=aios:aios active-runtime/app/ /opt/aios/app/
-
-USER aios:aios
-EXPOSE 18920
-
-HEALTHCHECK --interval=15s --timeout=5s --start-period=10s --retries=4 \
-  CMD python3 -c "import urllib.request; urllib.request.urlopen('http://127.0.0.1:18920/api/v2/health', timeout=3).read()"
-
-CMD ["python3", "-m", "aios_v2.app"]
@@ -1,44 +0,0 @@
-services:
-  aios-v2:
-    build:
-      context: ../../..
-      dockerfile: deploy/aios-v2/docker/Dockerfile
-    image: aios-v2:V2R1C0-candidate
-    init: true
-    restart: unless-stopped
-    ports:
-      - "127.0.0.1:${AIOS_V2_PORT:-18920}:18920"
-    environment:
-      AIOS_V2_HOST: 0.0.0.0
-      AIOS_V2_PORT: 18920
-      AIOS_V2_STATE_DIR: /var/lib/aios-v2
-      AIOS_OPENCLAW_URL: ${AIOS_OPENCLAW_URL:-}
-      AIOS_OPENCLAW_CREDENTIAL_REF: ${AIOS_OPENCLAW_CREDENTIAL_REF:-}
-      AIOS_OPENCLAW_SIGNING_MATERIAL_FILE: ${AIOS_OPENCLAW_SIGNING_MATERIAL_FILE:-}
-      AIOS_RELEASE_CHANNEL: candidate
-      AIOS_RELEASE_VERSION: V2R1C0-candidate
-    volumes:
-      - aios-v2-state:/var/lib/aios-v2
-      # Mount runtime signing material explicitly when OpenClaw is enabled.
-      # The host file must be mode 0600; never store it in this repository.
-      # - /etc/aios-v2/openclaw-signing-material:/run/secrets/openclaw-signing-material:ro
-    read_only: true
-    tmpfs:
-      - /tmp:rw,noexec,nosuid,nodev,size=64m
-    cap_drop:
-      - ALL
-    security_opt:
-      - no-new-privileges:true
-    healthcheck:
-      test:
-        - CMD
-        - python3
-        - -c
-        - "import urllib.request; urllib.request.urlopen('http://127.0.0.1:18920/api/v2/health', timeout=3).read()"
-      interval: 15s
-      timeout: 5s
-      retries: 4
-      start_period: 10s
-
-volumes:
-  aios-v2-state:
@@ -1,21 +0,0 @@
-# AIOS V2 candidate runtime configuration.
-# Copy to /etc/aios-v2/aios-v2.env and keep ownership root:aios, mode 0640.
-
-AIOS_V2_HOST=127.0.0.1
-AIOS_V2_PORT=18920
-AIOS_V2_STATE_DIR=/var/lib/aios-v2
-
-# Optional OpenClaw runtime. Leave blank to run with OpenClaw disabled.
-AIOS_OPENCLAW_URL=
-AIOS_OPENCLAW_CREDENTIAL_REF=
-
-# File path only. The referenced file must be mode 0600 or stricter and contain
-# at least 32 bytes. Never place signing material in this env file or Git.
-AIOS_OPENCLAW_SIGNING_MATERIAL_FILE=
-
-# Reverse proxy must authenticate users and inject X-AIOS-* identity headers.
-AIOS_TRUST_PROXY_HEADERS=true
-
-# Candidate deployment metadata exposed through health tooling.
-AIOS_RELEASE_CHANNEL=candidate
-AIOS_RELEASE_VERSION=V2R1C0-candidate
@@ -1,86 +0,0 @@
-#!/usr/bin/env bash
-set -Eeuo pipefail
-
-BASE_URL="${AIOS_V2_BASE_URL:-http://127.0.0.1:18920}"
-STATE_DIR="${AIOS_V2_STATE_DIR:-/var/lib/aios-v2}"
-CONTROLLER_WT="${AIOS_GITOPS_CONTROLLER_WORKTREE:-/data/aios-gitops/worktrees/controller}"
-SERVICE="${AIOS_V2_SERVICE:-aios-v2}"
-
-fail() {
-  echo "FAIL: $*" >&2
-  exit 1
-}
-
-pass() {
-  echo "PASS: $*"
-}
-
-command -v python3 >/dev/null || fail "python3 not installed"
-
-if command -v systemctl >/dev/null && systemctl list-unit-files "$SERVICE.service" >/dev/null 2>&1; then
-  systemctl is-active --quiet "$SERVICE" || fail "$SERVICE is not active"
-  pass "$SERVICE is active"
-fi
-
-python3 - "$BASE_URL" <<'PY'
-import json
-import sys
-import urllib.request
-
-base_url = sys.argv[1].rstrip("/")
-with urllib.request.urlopen(f"{base_url}/api/v2/health", timeout=5) as response:
-    payload = json.loads(response.read().decode("utf-8"))
-if payload.get("status") not in {"ok", "healthy", "ready"}:
-    raise SystemExit(f"unexpected health payload: {payload}")
-print(f"PASS: HTTP health status={payload.get('status')}")
-PY
-
-[[ -d "$STATE_DIR" ]] || fail "state directory missing: $STATE_DIR"
-[[ -w "$STATE_DIR" ]] || fail "state directory not writable: $STATE_DIR"
-pass "state directory writable"
-
-if [[ -e "$STATE_DIR/control-plane.sqlite3" ]]; then
-  python3 - "$STATE_DIR/control-plane.sqlite3" <<'PY'
-import sqlite3
-import sys
-
-path = sys.argv[1]
-connection = sqlite3.connect(f"file:{path}?mode=ro", uri=True, timeout=5)
-try:
-    row = connection.execute("PRAGMA quick_check").fetchone()
-finally:
-    connection.close()
-if not row or row[0] != "ok":
-    raise SystemExit(f"SQLite quick_check failed: {row}")
-print("PASS: SQLite quick_check=ok")
-PY
-else
-  echo "WARN: control-plane.sqlite3 not created yet"
-fi
-
-if [[ -d "$CONTROLLER_WT" ]] && git -C "$CONTROLLER_WT" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
-  branch="$(git -C "$CONTROLLER_WT" branch --show-current)"
-  dirty="$(git -C "$CONTROLLER_WT" status --porcelain=v1)"
-  [[ -z "$branch" ]] || fail "GitOps controller attached to branch: $branch"
-  [[ -z "$dirty" ]] || fail "GitOps controller workspace is dirty"
-  pass "GitOps controller detached and clean"
-fi
-
-python3 - "$STATE_DIR/executions" <<'PY'
-import json
-import pathlib
-import sys
-
-root = pathlib.Path(sys.argv[1])
-if not root.exists():
-    print("WARN: execution evidence directory not created yet")
-    raise SystemExit(0)
-for path in root.glob("*/*.json"):
-    value = json.loads(path.read_text(encoding="utf-8"))
-    for key in ("execution_id", "tenant_id", "task_id", "executor", "status"):
-        if not value.get(key):
-            raise SystemExit(f"invalid execution evidence {path}: missing {key}")
-print("PASS: execution evidence files valid")
-PY
-
-pass "AIOS V2 candidate healthcheck complete"
@@ -1,86 +0,0 @@
-#!/usr/bin/env bash
-set -Eeuo pipefail
-
-SERVICE="${AIOS_V2_SERVICE:-aios-v2}"
-RELEASE_ROOT="${AIOS_V2_RELEASE_ROOT:-/opt/aios/releases}"
-CURRENT_LINK="${AIOS_V2_CURRENT_LINK:-/opt/aios/current}"
-STATE_DIR="${AIOS_V2_STATE_DIR:-/var/lib/aios-v2}"
-BACKUP_ROOT="${AIOS_V2_BACKUP_ROOT:-/var/backups/aios-v2}"
-TARGET_RELEASE="${1:-}"
-RESTORE_STATE="${AIOS_V2_RESTORE_STATE:-0}"
-
-fail() {
-  echo "ERROR: $*" >&2
-  exit 1
-}
-
-[[ "${EUID}" -eq 0 ]] || fail "rollback must run as root"
-[[ -n "$TARGET_RELEASE" ]] || fail "usage: $0 <release-name-or-absolute-path>"
-
-if [[ "$TARGET_RELEASE" = /* ]]; then
-  TARGET_PATH="$(readlink -f "$TARGET_RELEASE")"
-else
-  [[ "$TARGET_RELEASE" != *"/"* && "$TARGET_RELEASE" != "." && "$TARGET_RELEASE" != ".." ]] \
-    || fail "invalid release name"
-  TARGET_PATH="$(readlink -f "$RELEASE_ROOT/$TARGET_RELEASE")"
-fi
-
-[[ -d "$TARGET_PATH/active-runtime/app" ]] || fail "target release is invalid: $TARGET_PATH"
-[[ -f "$TARGET_PATH/deploy/aios-v2/healthcheck/check.sh" ]] \
-  || fail "target release has no healthcheck"
-
-PREVIOUS_PATH=""
-if [[ -L "$CURRENT_LINK" ]]; then
-  PREVIOUS_PATH="$(readlink -f "$CURRENT_LINK")"
-fi
-
-STAMP="$(date -u +%Y%m%dT%H%M%SZ)"
-BACKUP_DIR="$BACKUP_ROOT/rollback-$STAMP"
-install -d -m 0750 "$BACKUP_DIR"
-
-if [[ -d "$STATE_DIR" ]]; then
-  tar --xattrs --acls -C "$(dirname "$STATE_DIR")" \
-    -czf "$BACKUP_DIR/state-before-rollback.tar.gz" \
-    "$(basename "$STATE_DIR")"
-fi
-
-printf '%s\n' "$PREVIOUS_PATH" > "$BACKUP_DIR/previous-release.txt"
-printf '%s\n' "$TARGET_PATH" > "$BACKUP_DIR/target-release.txt"
-
-systemctl stop "$SERVICE"
-ln -sfn "$TARGET_PATH" "${CURRENT_LINK}.next"
-mv -Tf "${CURRENT_LINK}.next" "$CURRENT_LINK"
-systemctl daemon-reload
-systemctl start "$SERVICE"
-
-if AIOS_V2_SERVICE="$SERVICE" \
-   AIOS_V2_STATE_DIR="$STATE_DIR" \
-   "$TARGET_PATH/deploy/aios-v2/healthcheck/check.sh"; then
-  echo "ROLLBACK_COMPLETE target=$TARGET_PATH backup=$BACKUP_DIR"
-  exit 0
-fi
-
-echo "Target release failed healthcheck; restoring previous release." >&2
-systemctl stop "$SERVICE" || true
-
-if [[ -n "$PREVIOUS_PATH" && -d "$PREVIOUS_PATH" ]]; then
-  ln -sfn "$PREVIOUS_PATH" "${CURRENT_LINK}.previous"
-  mv -Tf "${CURRENT_LINK}.previous" "$CURRENT_LINK"
-fi
-
-if [[ "$RESTORE_STATE" == "1" && -f "$BACKUP_DIR/state-before-rollback.tar.gz" ]]; then
-  rm -rf "$STATE_DIR"
-  tar --xattrs --acls -C "$(dirname "$STATE_DIR")" \
-    -xzf "$BACKUP_DIR/state-before-rollback.tar.gz"
-fi
-
-systemctl daemon-reload
-systemctl start "$SERVICE" || true
-
-if [[ -n "$PREVIOUS_PATH" && -x "$PREVIOUS_PATH/deploy/aios-v2/healthcheck/check.sh" ]]; then
-  AIOS_V2_SERVICE="$SERVICE" \
-  AIOS_V2_STATE_DIR="$STATE_DIR" \
-  "$PREVIOUS_PATH/deploy/aios-v2/healthcheck/check.sh" || true
-fi
-
-fail "rollback target failed; previous release restored; evidence=$BACKUP_DIR"
@@ -1,37 +0,0 @@
-[Unit]
-Description=AIOS V2 Control Plane Candidate
-After=network-online.target
-Wants=network-online.target
-
-[Service]
-Type=simple
-User=aios
-Group=aios
-WorkingDirectory=/opt/aios/current/active-runtime/app
-EnvironmentFile=-/etc/aios-v2/aios-v2.env
-Environment=PYTHONUNBUFFERED=1
-ExecStart=/usr/bin/python3 -m aios_v2.app
-Restart=on-failure
-RestartSec=3
-TimeoutStartSec=30
-TimeoutStopSec=30
-KillSignal=SIGTERM
-NoNewPrivileges=true
-PrivateTmp=true
-ProtectSystem=strict
-ProtectHome=true
-ProtectKernelTunables=true
-ProtectKernelModules=true
-ProtectControlGroups=true
-RestrictSUIDSGID=true
-RestrictRealtime=true
-LockPersonality=true
-MemoryDenyWriteExecute=true
-ReadWritePaths=/var/lib/aios-v2
-StateDirectory=aios-v2
-StateDirectoryMode=0750
-UMask=0027
-LimitNOFILE=65536
-
-[Install]
-WantedBy=multi-user.target
@@ -0,0 +1,27 @@
+# AIOS V2R1C2 Unified Portal production metadata.
+# No secret values belong in this file; runtime integrations use references.
+
+AIOS_V2_HOST=127.0.0.1
+AIOS_V2_PORT=18920
+AIOS_V2_STATE_DIR=/var/lib/aios-v2r1c2-production
+AIOS_PROVENANCE_STORE_FILE=/var/lib/aios-v2r1c2-production/run-provenance.sqlite3
+AIOS_EXTERNAL_TASK_STORE_FILE=/var/lib/aios-v2r1c2-production/external-task-truth.sqlite3
+AIOS_EXECUTOR_CATALOG_FILE=/var/lib/aios-v2r1c2-production/executor-catalog.json
+AIOS_EXECUTION_PLAN_FILES=/opt/aios-v2r1c2/plans/AIOS-V2R1C2-UNIFIED-PORTAL-RELEASE.json:/opt/aios-v2r1c2/plans/AIOS-V2R1C2-UNIFIED-PORTAL-TAKEOVER.json
+AIOS_EXECUTION_PLAN_FILE=/opt/aios-v2r1c2/plans/AIOS-V2R1C2-UNIFIED-PORTAL-TAKEOVER.json
+
+AIOS_RELEASE_VERSION=V2R1C2
+AIOS_TARGET_VERSION=V2R1C2
+AIOS_BASELINE_VERSION=V2R1C1
+AIOS_PREVIOUS_VERSION=V2R1C1
+AIOS_RELEASE_STATUS=PRODUCTION
+AIOS_RELEASE_SOURCE_OID=3dd622b5a515f1fa4ef72b9f8ae9ce48ac703f24
+AIOS_RELEASE_OID=3dd622b5a515f1fa4ef72b9f8ae9ce48ac703f24
+AIOS_RELEASE_TAG=V2R1C2
+AIOS_RELEASE_EVIDENCE_SHA256=2e27bb73b8e6297bd3077238f73a96d697fc3c3611c601c4dc9357e5fdcd8eee
+
+AIOS_OPENCLAW_CONTRACT_VERSION=aios.openclaw.command.v2
+AIOS_OPENCLAW_SIGNATURE_ALGORITHM=Ed25519
+AIOS_OPENCLAW_PLUGIN_VERSION=2.1.0-rc.4
+AIOS_OPENCLAW_SIGNING_KEY_ID=openclaw-v2r1-candidate-ed25519
+AIOS_OWNER_WECHAT_TARGET_REF=AIOS_OWNER_WECHAT_TARGET_REF
@@ -0,0 +1,44 @@
+[Unit]
+Description=AIOS V2R1C2 Unified Portal Production
+After=network-online.target
+Wants=network-online.target
+Conflicts=aios-orchestrator-gateway.service
+ConditionPathExists=/opt/aios-v2r1c2/active-runtime/app/aios_web/release_application.py
+ConditionPathExists=/opt/aios-v2r1c2/plans/AIOS-V2R1C2-UNIFIED-PORTAL-TAKEOVER.json
+
+[Service]
+Type=simple
+User=aios
+Group=aios
+WorkingDirectory=/opt/aios-v2r1c2/active-runtime/app
+EnvironmentFile=/etc/aios-v2/aios-v2r1c2-production.env
+Environment=PYTHONUNBUFFERED=1
+Environment=PYTHONDONTWRITEBYTECODE=1
+ExecStartPre=/usr/bin/test "$AIOS_V2_PORT" = "18920"
+ExecStartPre=/usr/bin/test "$AIOS_RELEASE_SOURCE_OID" = "3dd622b5a515f1fa4ef72b9f8ae9ce48ac703f24"
+ExecStartPre=/usr/bin/test "$AIOS_RELEASE_TAG" = "V2R1C2"
+ExecStart=/usr/bin/python3 -m aios_web.release_application
+Restart=on-failure
+RestartSec=3
+TimeoutStartSec=60
+TimeoutStopSec=30
+KillSignal=SIGTERM
+NoNewPrivileges=true
+PrivateTmp=true
+ProtectSystem=strict
+ProtectHome=true
+ProtectKernelTunables=true
+ProtectKernelModules=true
+ProtectControlGroups=true
+RestrictSUIDSGID=true
+RestrictRealtime=true
+LockPersonality=true
+MemoryDenyWriteExecute=true
+ReadWritePaths=/var/lib/aios-v2r1c2-production
+StateDirectory=aios-v2r1c2-production
+StateDirectoryMode=0750
+UMask=0027
+LimitNOFILE=65536
+
+[Install]
+WantedBy=multi-user.target
@@ -11,6 +11,8 @@ Environment=AIOS_GITOPS_WORKSPACE=/data/aios-gitops/workspace
 Environment=AIOS_GITOPS_DB=/data/aios-gitops/runtime/gitops_model.sqlite3
 Environment=AIOS_GITOPS_TOKEN_FILE=/data/aios-gitops/runtime/secrets/gitops.tokens
 Environment=AIOS_GITOPS_BARE_REPO=/data/aios-gitops/runtime/gitea-bin/data/repositories/aios/aios-v23.git
+Environment=AIOS_GITOPS_AUTHORITATIVE_GIT_DIR=/data/aios-gitops/repo.git
+Environment=AIOS_GITOPS_REPOSITORY_IDENTITY=aios/aios
 Environment=AIOS_GITOPS_HOST=127.0.0.1
 Environment=AIOS_GITOPS_PORT=18890
 ExecStart=/usr/bin/python3 /data/aios-gitops/workspace/active-runtime/app/aios_chatgpt_actions_api.py
@@ -1,243 +0,0 @@
-# AIOS V2 用户需求规格
-
- 文档版本：`V2R1C0-candidate`
- 状态：候选版本需求基线
- 适用范围：AIOS Control Plane、Agent Router、OpenClaw Adapter、Hermes Runtime、Web Console、GitOps、审计与部署
-
-## 1. 背景与目标
-
-现有系统已经具备 OpenClaw、Hermes、Agent Router、GitOps、局部 WebUI、审计和多租户候选能力。AIOS V2 的目标不是推倒重写，而是将这些分散能力收敛到统一、可审计、可 Web 化、可多租户隔离的控制面。
-
-AIOS V2 必须成为唯一控制面，负责租户、身份、Agent、策略、任务生命周期、审批、审计、Runtime 目录和执行证据。OpenClaw 与 Hermes 只承担执行职责，不得持有第二套控制面状态。
-
-## 2. 用户角色
-
-| 角色 | 主要诉求 |
-|---|---|
-| 平台管理员 | 管理租户、运行时、发布、GitOps 状态和全局策略 |
-| 租户管理员 | 管理本租户 Agent、任务、审批、审计和成员权限 |
-| 操作员 | 创建任务、发起执行、取消任务、查看运行状态 |
-| 审批人 | 审批高风险任务，查看策略判定依据 |
-| 审计员 | 查询本租户完整审计链和执行证据 |
-| Runtime Worker | 领取已批准任务、心跳、返回执行结果 |
-| 开发与运维人员 | 通过 GitOps 提交、测试、部署、回滚和修复 Bug |
-
-## 3. 核心用户需求
-
-### UR-001 唯一控制面
-
-所有任务创建、审批、取消、状态变化、策略判定和审计必须由 AIOS Control Plane 统一处理。
-
-验收：
-
- Web Console、API、Codex、OpenClaw 和 Hermes 均不得绕过 AIOS 创建或修改任务生命周期。
- OpenClaw/Hermes 的公开接口仅限执行、状态、取消、心跳和结果回传。
-
-### UR-002 复用现有能力
-
-系统不得重写已经稳定的 OpenClaw 执行能力、Hermes Runtime、Agent Router 或 GitOps 基础设施。
-
-验收：
-
- 通过 Adapter/Boundary 接入现有能力。
- 替换控制逻辑时保留原执行接口和可迁移数据。
-
-### UR-003 OpenClaw 与 Hermes 解耦
-
-OpenClaw 与 Hermes 必须从策略、租户、审批和任务生命周期中逐步解耦。
-
-验收：
-
- OpenClaw 仅接收已签名、已批准、带租户上下文的命令。
- Hermes 仅接收已批准的租户分区 Job。
- 二者均不得直接写 Control Plane 权威状态。
-
-### UR-004 全面 Web 化
-
-所有面向用户和运维的能力必须通过 Web Console 或稳定 API 访问。
-
-Web Console 至少展示：
-
- Tenant、Agent、Task、Approval、Runtime、Audit、Execution Evidence、GitOps Status。
- 所有写操作由 AIOS API 完成，浏览器不得直接调用 OpenClaw/Hermes。
-
-### UR-005 多租户隔离
-
-所有模块必须支持租户隔离，且默认拒绝跨租户访问。
-
-隔离范围：
-
- API 与会话
- Tenant/Agent/Task 数据
- OpenClaw 命令
- Hermes Queue、Cell、Profile、Worker Lease
- Memory、Cache、Artifact、SecretRef
- Audit、Execution Evidence、日志和指标
-
-验收：
-
- 资源记录的 `tenant_id` 不可为空。
- 跨租户访问返回拒绝或“资源不存在”，不得泄露存在性。
- 必须有跨租户负向测试。
-
-### UR-006 权威任务生命周期
-
-任务必须遵循统一状态机：
-
-```text
-CREATED -> APPROVED -> RUNNING -> COMPLETED
-    |          |          |
-    +----------+----------+-> CANCELLED
-                           +-> FAILED
-```
-
-验收：
-
- 禁止越级变化，例如 `CREATED -> COMPLETED`。
- 每次变化包含 revision、principal、trace、时间和审计事件。
-
-### UR-007 策略与审批
-
-所有有副作用任务必须经过策略判定；高风险任务必须支持人工审批。
-
-验收：
-
- Policy Decision 包含 allow/deny、reason 和 policy version。
- 拒绝事件进入审计。
- Runtime 不得自行放宽策略。
-
-### UR-008 幂等与并发安全
-
-任务和 Runtime 执行必须支持幂等与乐观并发控制。
-
-验收：
-
- 相同租户与幂等键、相同内容返回同一任务/执行。
- 相同幂等键不同内容返回冲突。
- revision 或 branch lease 冲突不得静默覆盖。
-
-### UR-009 可观测与执行证据
-
-平台必须能够确认 Codex、OpenClaw、Hermes 等执行器是否领取任务、当前进度、最近提交、测试结果和完成状态。
-
-验收：
-
- 存在 claim、heartbeat、progress、result 和 evidence 记录。
- Web/API 可按租户查询。
- 执行证据不得包含明文密钥。
-
-### UR-010 GitOps 唯一变更流程
-
-所有代码、配置、文档和部署资产修改必须进入非 `main` 分支，通过 commit、测试、审查和受控提升。
-
-验收：
-
- Controller worktree 必须 detached 且 clean。
- 本地 bare repo 与 Gitea 目标分支 OID 一致。
- 不允许直接 push `main`、直接创建生产 Tag 或绕过审批部署。
-
-### UR-011 持久化与恢复
-
-租户、Agent、Task、Audit、Idempotency 和 Execution Evidence 必须在服务重启后恢复。
-
-验收：
-
- 候选版支持 SQLite WAL 原子快照。
- 有 restart recovery 测试。
- 生产版需进一步提供迁移、备份、恢复、HA 和容量证据。
-
-### UR-012 审计与合规
-
-所有控制与执行动作必须生成不可混租户的审计事件。
-
-至少记录：
-
- tenant、principal、trace、action、resource、outcome、policy version、timestamp。
- OpenClaw/Hermes Runtime 生命周期。
- GitOps、部署和回滚动作。
-
-### UR-013 密钥安全
-
-Git、日志、Web、任务 payload 和审计记录中不得出现明文 API Key、密码、Token 或私钥。
-
-验收：
-
- Git 只存 `secret_ref`、`credential_ref`、`key_id` 或受保护文件路径。
- Secret 文件权限为 `0600` 或更严格。
- Secret Scanner 默认拒绝可疑提交。
-
-### UR-014 部署与回滚
-
-系统必须提供 systemd、Docker/Compose、健康检查和受保护回滚入口。
-
-验收：
-
- 服务以非 root 权限运行。
- 状态目录独立持久化。
- 回滚前自动备份状态。
- 默认只回滚代码，状态恢复需要显式授权。
-
-### UR-015 文档与代码同步
-
-任何影响用户行为、架构边界、API、数据模型、状态机、安全策略、部署或运维方式的变更，必须在同一分支同步更新 `docs/aios-v2/`。
-
-验收：
-
- 架构/功能代码变化但无文档变化时，文档同步门禁失败。
- Traceability Matrix 必须指向当前代码和测试。
- 新架构决策必须增加或更新 ADR。
-
-## 4. 非功能需求
-
-### NFR-001 安全
-
- 默认拒绝、最小权限、租户隔离、身份可信链、SecretRef、审计。
-
-### NFR-002 可靠性
-
- 幂等、revision、worker lease、heartbeat、重试边界、原子持久化、健康检查和回滚。
-
-### NFR-003 可维护性
-
- 模块边界稳定，Control Plane 与 Runtime 解耦；代码、文档、测试和部署可追踪。
-
-### NFR-004 可扩展性
-
- Store、Transport、Policy、EventPublisher、Runtime Adapter 均通过接口扩展。
-
-### NFR-005 可运维性
-
- Web/API 状态、systemd/Docker、健康检查、日志、GitOps 状态、候选报告。
-
-### NFR-006 性能候选指标
-
-候选版上线前至少验证：
-
- API P95、任务调度延迟、队列等待、Worker 心跳、SQLite 锁等待、审计写入时间。
- 具体 SLO 在预发布基准测试后固化，禁止无证据承诺。
-
-## 5. 本候选版本范围
-
-### 已纳入代码
-
- Control Plane、持久化、Gateway、Orchestrator、OpenClaw Adapter、Hermes Boundary、Execution Tracking、Web Console、GitOps Status、部署和回滚。
-
-### 尚需环境验证
-
- 精确测试执行证据。
- OpenClaw 真实 Runtime 联调。
- 生产数据库/队列替换或容量验证。
- 预发布性能、安全、重启和回滚演练。
- Owner 对 merge、Tag 和生产部署的批准。
-
-## 6. 用户验收场景
-
-1. 平台管理员创建租户并注册 OpenClaw/Hermes Agent。
-2. 操作员创建任务，审批人批准。
-3. AIOS Orchestrator 选择 Runtime，并创建签名命令或租户分区 Job。
-4. Runtime 执行并返回结果。
-5. AIOS 更新 Task、Audit 和 Execution Evidence。
-6. 租户用户在 Web Console 查看完整链路。
-7. 跨租户访问被拒绝。
-8. 服务重启后状态恢复。
-9. 候选部署健康检查通过，回滚演练成功。
@@ -1,461 +0,0 @@
-# AIOS V2 目标架构
-
- 文档版本：`V2R1C0-candidate`
- 架构状态：目标架构已实现为候选代码，待预发布验证
- 适用范围：Control Plane、Agent Router、OpenClaw、Hermes、Web Console、GitOps、审计、部署与运维
-
-## 1. 架构目标
-
-AIOS V2 的核心目标是把分散在 OpenClaw、Hermes、Agent Router、局部 WebUI 和 GitOps 中的控制能力收敛为一个权威控制面，同时保留现有执行能力，避免推倒重写。
-
-目标状态：
-
-```text
-用户 / Web Console / Public API
-                 |
-                 v
-          AIOS Control Plane
- Tenant | Identity | Agent | Task | Policy | Approval | Audit
-                 |
-                 v
-      Execution Orchestrator / Agent Router
-             /                      \
-            v                        v
-   OpenClaw Adapter            Hermes Boundary
-            |                        |
-            v                        v
-   OpenClaw Runtime            Hermes Workers
-             \                      /
-              v                    v
-       Result Reconciliation + Execution Evidence
-```
-
-设计结论：
-
- AIOS 是唯一控制面。
- Agent Router 是调度平面，不是第二控制面。
- OpenClaw 是执行适配与 Runtime。
- Hermes 是队列、Worker、Profile 与执行 Runtime。
- Web Console 只调用 AIOS API。
- GitOps 是代码、配置、文档和发布变更的唯一入口。
-
-## 2. 从现有架构到目标架构
-
-### 2.1 现有能力
-
-现有系统已经具备：
-
- OpenClaw 执行与 Fleet 能力。
- Hermes Worker、Profile、队列和工作区能力。
- Agent Router 路由经验和部分调度接口。
- GitOps 分支、提交、审批、回滚和审计能力。
- Tenant Context、Tenant Router、Memory Scope、SecretRef、Message Ledger 和审计候选实现。
- 局部 WebUI、Gateway 和自动任务领取能力。
-
-### 2.2 现有问题
-
- 控制逻辑分散，可能存在多个任务事实源。
- OpenClaw/Hermes 内部仍可能保存租户、策略或任务状态。
- 候选能力分散在多个分支，主线缺少权威实现。
- WebUI 与 API 入口不统一。
- 分支名称、代码、测试和部署证据之间缺少映射。
- 多租户隔离多为逻辑约束，尚缺全链路生产证据。
-
-### 2.3 演进原则
-
- 先加边界和适配器，再迁移控制权。
- 先复用接口，再替换内部实现。
- 先在候选分支验证，再受控提升。
- 不允许同时存在两套权威任务生命周期。
- 不以“大分支存在”代替验收证据。
-
-## 3. 逻辑分层
-
-### 3.1 Web 与 API 层
-
-职责：
-
- 提供 Tenant、Agent、Task、Approval、Runtime、Audit、Execution Evidence 和 GitOps 页面/API。
- 依赖可信身份代理注入 `X-AIOS-*` 身份头。
- 不允许浏览器直接访问 OpenClaw 或 Hermes。
- 不允许客户端自行选择或覆盖 `tenant_id`。
-
-候选实现：
-
- `active-runtime/app/aios_v2/app.py`
- `active-runtime/app/aios_v2/gateway.py`
- `active-runtime/app/aios_v2/console.py`
-
-### 3.2 AIOS Control Plane
-
-权威职责：
-
- Tenant Registry
- Agent Registry
- Task Lifecycle
- Policy Decision
- Approval
- Audit Event
- Runtime Inventory
- Execution Evidence
- Deployment/GitOps Status
-
-不负责：
-
- OpenClaw 内部执行细节。
- Hermes Worker 内部执行细节。
- 直接持有 Runtime 凭据明文。
-
-候选实现：
-
- `active-runtime/app/aios_v2/control_plane.py`
- `active-runtime/app/aios_v2/persistence.py`
- `active-runtime/app/aios_v2/execution_tracking.py`
- `active-runtime/app/aios_v2/gitops_status.py`
-
-### 3.3 Execution Orchestrator / Agent Router
-
-职责：
-
- 只接受 `APPROVED` 任务。
- 根据 Agent Registry 和 Policy Result 选择 Runtime。
- 生成 OpenClawCommand 或 HermesJob。
- 传播 tenant、task、trace、idempotency 和 policy version。
- 将 Runtime Result 回写 AIOS Task。
-
-不负责：
-
- 创建租户。
- 修改策略。
- 绕过审批。
- 保存第二套任务状态机。
-
-候选实现：
-
- `active-runtime/app/aios_v2/orchestrator.py`
-
-### 3.4 OpenClaw Adapter
-
-职责：
-
- 验证签名命令。
- 执行、查询、取消、健康检查和回调。
- 支持幂等、超时和租户隔离。
- 把 Runtime 生命周期转换为 AIOS 审计事件。
-
-不负责：
-
- Tenant、Policy、Approval、Task Lifecycle。
- 向浏览器暴露公网控制接口。
-
-候选实现：
-
- `active-runtime/app/aios_openclaw/contract.py`
- `active-runtime/app/aios_openclaw/adapter.py`
- `active-runtime/app/aios_openclaw/transport.py`
- `active-runtime/app/aios_openclaw/health.py`
- `active-runtime/app/aios_openclaw/callback.py`
-
-### 3.5 Hermes Runtime Boundary
-
-职责：
-
- Tenant/Cell/Profile 分区队列。
- Worker claim、start、heartbeat、complete、fail、cancel。
- Lease 超时和自动回队列。
- Result 回传和 Runtime Health。
-
-不负责：
-
- Policy、Approval、Tenant Registry、权威 Task Lifecycle。
-
-候选实现：
-
- `active-runtime/app/aios_hermes/contract.py`
- `active-runtime/app/aios_hermes/adapter.py`
- `active-runtime/app/aios_hermes/worker.py`
-
-### 3.6 Persistence
-
-候选实现使用 SQLite WAL 原子快照，持久化：
-
- Tenant
- Agent
- Task
- Audit
- Idempotency
- Execution Evidence 文件
-
-生产演进：
-
- Store 接口保持稳定。
- 可替换为 PostgreSQL、对象存储或分布式事件存储。
- 生产替换必须提供迁移、备份、恢复、HA、容量和租户隔离证据。
-
-## 4. 多租户架构
-
-### 4.1 权威租户上下文
-
-每次请求和执行至少传播：
-
-```text
-tenant_id
-principal_id
-session_id
-trace_id
-task_id
-policy_version
-```
-
-Runtime 还传播：
-
-```text
-command_id / job_id
-cell_id
-profile_id
-idempotency_key
-worker_id
-```
-
-### 4.2 隔离层级
-
-| 层级 | 隔离要求 |
-|---|---|
-| HTTP/API | 可信身份头、租户不可由浏览器覆盖 |
-| Control Plane | 所有资源带 `tenant_id`，跨租户默认拒绝 |
-| OpenClaw | 签名命令绑定 tenant/task/trace |
-| Hermes | tenant/cell/profile 三层分区 |
-| Storage | 候选为显式租户字段；生产需 RLS 或物理隔离策略 |
-| Evidence/Audit | 仅按当前租户查询 |
-| Cache/Memory | key 必须包含 tenant namespace |
-| Secret | 只保存引用，不保存明文 |
-| Logs/Metrics | 必须包含 tenant/task/trace 标签，并限制查询范围 |
-
-### 4.3 失败行为
-
- 跨租户资源访问返回拒绝或“未找到”。
- 不泄露其他租户资源存在性。
- 缺少 tenant context 时 fail closed。
- Runtime 返回的 tenant/task/trace 不匹配时拒绝回写。
-
-## 5. 任务与执行数据流
-
-### 5.1 任务创建与审批
-
-```text
-User/API
-   |
-   v
-Trusted Identity
-   |
-   v
-AIOS Gateway
-   |
-   v
-Policy Gate
-   |
-   v
-Task CREATED
-   |
-   v
-Approval
-   |
-   v
-Task APPROVED
-```
-
-### 5.2 OpenClaw 执行
-
-```text
-APPROVED Task
-   |
-   v
-Execution Orchestrator
-   |
-   v
-Signed OpenClawCommand
-   |
-   v
-OpenClaw Adapter
-   |
-   v
-Runtime Result
-   |
-   v
-Task Reconciliation + Audit + Evidence
-```
-
-### 5.3 Hermes 执行
-
-```text
-APPROVED Task
-   |
-   v
-Execution Orchestrator
-   |
-   v
-Tenant/Cell/Profile HermesJob
-   |
-   v
-Worker Claim + Lease + Heartbeat
-   |
-   v
-HermesResult
-   |
-   v
-Task Reconciliation + Audit + Evidence
-```
-
-## 6. 安全架构
-
-### 6.1 身份边界
-
- Public API 位于可信反向代理之后。
- 反向代理完成登录、会话、MFA 和身份头注入。
- 候选应用拒绝未认证身份断言。
- 生产不得允许客户端直接伪造 `X-AIOS-*`。
-
-### 6.2 Runtime 命令完整性
-
-OpenClawCommand 使用规范化序列化和 HMAC-SHA256：
-
- 签名覆盖 tenant、task、trace、action、payload、idempotency 和时间。
- 支持 key ID、到期时间和时钟偏差。
- Runtime 密钥通过受保护文件或外部 Secret Provider 解析。
-
-### 6.3 Secret 边界
-
-Git 允许：
-
-```text
-secret_ref
-credential_ref
-key_id
-受保护文件路径
-```
-
-Git 禁止：
-
-```text
-API Key
-密码
-Token
-私钥
-签名材料
-```
-
-### 6.4 Web 安全
-
-候选应用设置：
-
- no-store
- nosniff
- DENY frame
- no-referrer
- CSP
- 请求体大小限制
-
-生产还需验证：
-
- CSRF/CORS
- Rate Limit
- Session Timeout
- CSP Nonce/Hash
- WAF 和反向代理访问策略
-
-## 7. 可靠性架构
-
-### 7.1 幂等
-
- Control Plane：`tenant_id + idempotency_key + request_digest`。
- OpenClaw：`tenant_id + idempotency_key + signature`。
- Hermes：`tenant_id + idempotency_key + job_digest`。
-
-### 7.2 并发
-
- Task 使用 revision。
- Hermes 使用 revision + worker lease。
- GitOps 使用 detached controller + branch lease。
- 持久化使用 SQLite `BEGIN IMMEDIATE` 和原子快照。
-
-### 7.3 恢复
-
- Controller restart：detached guard。
- AIOS restart：SQLite restore。
- Worker crash：lease 到期后 Job 回到 QUEUED。
- Release failure：健康检查失败自动恢复 previous release。
-
-## 8. 可观测架构
-
-统一关联键：
-
-```text
-tenant_id
-principal_id
-trace_id
-task_id
-agent_id
-command_id / job_id
-worker_id
-commit
-```
-
-Web Console 展示：
-
- Tasks
- Agents
- Runtime Health
- Audit
- Execution Evidence
- GitOps Status
-
-生产还需接入：
-
- 结构化日志
- Metrics
- Distributed Tracing
- Alerting
- SLO Dashboard
-
-## 9. 部署架构
-
-支持两种候选部署：
-
-### systemd
-
- 非 root `aios` 用户。
- `ProtectSystem=strict`、`NoNewPrivileges` 等安全选项。
- 状态目录 `/var/lib/aios-v2`。
-
-### Docker/Compose
-
- 非 root UID/GID。
- Read-only root filesystem。
- Drop all capabilities。
- State volume。
- HTTP healthcheck。
-
-## 10. 架构约束
-
-以下行为视为架构违规：
-
-1. OpenClaw/Hermes 直接创建或批准 AIOS Task。
-2. Web Console 直接调用 Runtime。
-3. 新模块不携带 `tenant_id`。
-4. 新增第二套任务状态机或租户事实源。
-5. 在 Git 中提交明文凭据。
-6. 绕过 GitOps 修改生产代码/配置。
-7. 架构或功能变化未同步更新 `docs/aios-v2/`。
-8. 未通过测试和预发布门禁直接提升候选版本。
-
-## 11. 目标架构完成判定
-
-目标架构只有在以下证据齐全时才视为完成：
-
- 文档与代码映射完整。
- Candidate tests 对精确 commit 执行通过。
- OpenClaw/Hermes 实际 Runtime 联调通过。
- 多租户负向测试通过。
- 重启恢复和回滚演练通过。
- GitOps 本地/Gitea OID 一致。
- Owner 批准 merge、Tag 和生产部署。
@@ -1,313 +0,0 @@
-# AIOS V2 迁移与交付策略
-
- 文档版本：`V2R1C0-candidate`
- 交付原则：增量迁移、能力复用、控制权收敛、GitOps 唯一变更入口
-
-## 1. 迁移目标
-
-AIOS V2 不通过一次性重写替换现有系统，而是在保留 OpenClaw、Hermes、Agent Router、GitOps 和既有运行能力的前提下，将租户、策略、任务、审批、审计和发布治理收敛到 AIOS Control Plane。
-
-迁移完成的标志不是“新代码存在”，而是：
-
- AIOS 成为唯一权威控制面；
- OpenClaw/Hermes 不再保存第二套控制状态；
- 所有控制功能 Web/API 化；
- 所有模块通过租户隔离、测试和预发布门禁；
- 本地 Git、Gitea、测试、部署和回滚证据可追踪。
-
-## 2. 为什么采用增量迁移
-
-### 2.1 避免能力回退
-
-OpenClaw、Hermes 和 Agent Router 已经包含大量运行经验、边界处理和执行能力。整体重写会扩大风险面，并导致业务能力、操作流程和历史数据回退。
-
-### 2.2 保持可回滚
-
-每个迁移步骤必须：
-
- 独立分支；
- 小范围提交；
- 独立测试；
- 可单独回滚；
- 不要求立即关闭旧执行路径。
-
-### 2.3 先收敛控制权，再优化内部实现
-
-迁移优先级：
-
-```text
-唯一入口
-  -> 权威租户/任务/策略
-  -> Runtime Adapter
-  -> 数据层生产化
-  -> Web 与可观测
-  -> 性能与 HA
-```
-
-## 3. 分阶段迁移路线
-
-### Phase 0：GitOps 与架构事实源
-
-目标：建立可靠变更链和权威设计基线。
-
-已完成候选能力：
-
- Controller detached guard；
- 避免 fetch 到已检出本地分支；
- Gitea SSH 镜像；
- `docs/aios-v2/` 架构事实源；
- 候选分支、部署和回滚资产。
-
-退出条件：
-
- Controller detached 且 clean；
- 本地/Gitea OID 一致；
- 架构与需求文档纳入版本。
-
-### Phase 1：Control Plane 权威化
-
-目标：将 Tenant、Agent、Task、Policy、Approval 和 Audit 收敛到 AIOS。
-
-候选实现：
-
- `aios_v2/control_plane.py`
- `aios_v2/persistence.py`
- `aios_v2/gateway.py`
- `aios_v2/app.py`
-
-退出条件：
-
- 任务状态机统一；
- 幂等、revision、审计和跨租户拒绝通过测试；
- 服务重启后权威状态恢复。
-
-### Phase 2：OpenClaw 解耦
-
-目标：OpenClaw 从控制逻辑转为执行适配器。
-
-步骤：
-
-1. 定义签名命令合同；
-2. 引入 Adapter；
-3. 将直接调用迁移到 AIOS Orchestrator；
-4. Runtime 只返回执行结果和健康状态；
-5. 关闭或网络隔离旧公共控制入口。
-
-退出条件：
-
- 未批准任务无法生成有效命令；
- 命令绑定 tenant/task/trace/idempotency；
- 旧控制接口冻结并记录替代路径。
-
-### Phase 3：Hermes 解耦
-
-目标：Hermes 只承担租户分区队列和 Worker Runtime。
-
-步骤：
-
-1. 定义 HermesJob/HermesResult；
-2. 强制 tenant/cell/profile 分区；
-3. 引入 claim/lease/heartbeat；
-4. 将结果统一回写 AIOS；
-5. 移除 Hermes 内部策略和任务事实源。
-
-退出条件：
-
- Worker 无权创建 AIOS Task；
- 租约过期后 Job 可恢复；
- 跨租户 claim/read/result 被拒绝。
-
-### Phase 4：Web 与运维统一
-
-目标：所有用户与运维功能通过 AIOS Web/API。
-
-范围：
-
- Tenant、Agent、Task、Runtime、Audit、Execution Evidence、GitOps；
- systemd/Docker/Compose；
- healthcheck、rollback、release report。
-
-退出条件：
-
- 浏览器不直接调用 Runtime；
- 生产身份代理和权限模型通过验证；
- 部署、重启和回滚演练通过。
-
-### Phase 5：生产数据层与 HA
-
-目标：将候选 SQLite/内存运行状态替换或强化为生产级后端。
-
-要求：
-
- 数据迁移；
- RLS 或物理隔离；
- 备份恢复；
- HA 与容量；
- 多实例并发；
- 灾难恢复目标。
-
-该阶段不得改变上层合同，避免 Runtime 和 Web 再次耦合存储实现。
-
-## 4. 分支与提交策略
-
-### 4.1 分支类型
-
-| 类型 | 用途 |
-|---|---|
-| `task/*` | 可执行任务合同与主体实现 |
-| `patch/*` | 独立修复或窄范围增强 |
-| `integration/*` | 多模块候选收敛 |
-| `result/*` | 自动执行结果与证据 |
-| `release/*` | 受控发布候选 |
-
-### 4.2 规则
-
- 禁止直接修改 `main`；
- 一个提交应可独立审阅和回滚；
- 大文件和大范围变更应拆分；
- 所有行为变化必须同步文档和测试；
- 生产 Tag、部署和回滚需要 Owner 批准。
-
-## 5. GitOps 交付流程
-
-```text
-需求/架构更新
-      |
-      v
-任务分支 + 文档 + 测试
-      |
-      v
-代码提交 + Secret Gate
-      |
-      v
-本地 bare repo 同步
-      |
-      v
-Gitea 镜像与 OID 校验
-      |
-      v
-Candidate 集成
-      |
-      v
-自动测试与预发布
-      |
-      v
-Owner 审批
-      |
-      v
-Merge / Tag / Production Deploy
-```
-
-### 5.1 同步状态
-
-GitOps 返回必须区分：
-
- local sync；
- Gitea sync；
- branch OID；
- workspace mode；
- dirty state。
-
-仅返回 `common_git_dir synced` 不足以证明 Web 远端可见。
-
-## 6. 发布门禁
-
-### Gate A：设计完整性
-
- 用户需求、目标架构、模块契约、ADR 和追踪矩阵同步；
- 无冲突标记、断链或过期路径。
-
-### Gate B：代码质量
-
- 包可导入；
- 静态编译通过；
- Secret Scanner 通过；
- 无已知越权旁路。
-
-### Gate C：测试
-
- 单元、集成、多租户负向、重启恢复、Runtime 边界测试通过；
- 记录 commit、命令、exit code、pass/fail 和 artifact digest。
-
-### Gate D：预发布
-
- systemd 或 Compose 启动成功；
- 健康检查通过；
- OpenClaw/Hermes 真实联调通过；
- 备份、重启和回滚演练通过；
- 日志中无敏感信息。
-
-### Gate E：生产批准
-
- Owner 批准 merge、Tag 和生产部署；
- 发布窗口、回滚负责人和观察指标明确；
- 生产变更通过 GitOps 记录。
-
-## 7. 回滚策略
-
-### 7.1 代码回滚
-
- 使用 `/opt/aios/current` 原子 symlink 切换；
- 回滚前备份状态；
- 健康检查失败自动恢复 previous release。
-
-### 7.2 状态回滚
-
-默认不自动回滚状态，避免覆盖候选运行期间新增的 Task、Audit 和 Evidence。
-
-状态恢复只有在：
-
- 明确确认 schema 不兼容；
- 数据备份可验证；
- Owner 显式授权；
-
-时启用。
-
-### 7.3 Runtime 回滚
-
-OpenClaw/Hermes Adapter 采用稳定合同。若候选执行层失败，可恢复旧 Runtime 版本，但不得恢复旧控制权旁路。
-
-## 8. Bug 修复流程
-
-生产或预发布 Bug：
-
-1. 创建 `patch/bugfix/*`；
-2. 添加可复现测试；
-3. 修复代码；
-4. 更新相关需求/架构/契约/ADR；
-5. 运行候选验收；
-6. 进入新的 release candidate；
-7. Owner 批准部署。
-
-禁止在生产目录直接编辑文件后不回写 Git。
-
-## 9. 文档同步规则
-
-以下变化必须更新文档：
-
- 用户行为或页面；
- API 路径、Header、请求/响应；
- 数据模型、状态机、策略；
- OpenClaw/Hermes/Router 边界；
- 多租户与安全模型；
- 部署、健康检查、回滚；
- 测试或发布门禁。
-
-对应关系：
-
- 需求变化：更新 `01-USER-REQUIREMENTS.md`；
- 架构变化：更新 `02-TARGET-ARCHITECTURE.md` 和 ADR；
- 迁移/发布变化：更新本文件；
- 合同变化：更新 `04-MODULE-CONTRACTS.md`；
- 代码/测试路径变化：更新 `05-TRACEABILITY-MATRIX.md`。
-
-## 10. 当前候选后续步骤
-
-1. 完成文档同步门禁和 Acceptance Runner；
-2. 在精确 Candidate commit 执行测试；
-3. 推送 Gitea 并校验 OID；
-4. 部署隔离预发布环境；
-5. 联调真实 OpenClaw/Hermes；
-6. 执行重启、性能、安全和回滚演练；
-7. 生成最终 evidence；
-8. 请求 Owner 的 merge/Tag/production approval。
@@ -1,502 +0,0 @@
-# AIOS V2 模块契约
-
- 文档版本：`V2R1C0-candidate`
- 状态：候选实现契约基线
- 原则：Control Plane 权威、Runtime 执行、全链路租户隔离、所有状态可审计
-
-## 1. 通用上下文契约
-
-所有控制与执行请求必须携带以下上下文：
-
-| 字段 | 必填 | 说明 |
-|---|---:|---|
-| `tenant_id` | 是 | 权威租户标识 |
-| `principal_id` | 控制请求是 | 已认证主体 |
-| `trace_id` | 是 | 全链路追踪 |
-| `task_id` | 执行阶段是 | AIOS 权威任务 |
-| `session_id` | Web/交互请求建议 | 用户会话 |
-| `policy_version` | 控制请求是 | 策略版本 |
-| `idempotency_key` | 创建/执行是 | 幂等键 |
-
-规则：
-
- 缺少必填字段时 fail closed。
- 客户端不得覆盖由可信代理或 AIOS 生成的 `tenant_id`。
- Runtime 返回的 tenant/task/trace 必须与请求完全匹配。
- 所有持久化键、缓存键和队列分区必须包含租户命名空间。
-
-## 2. Tenant Contract
-
-### 2.1 TenantRecord
-
-```text
-tenant_id
-display_name
-status
-metadata
-created_at
-updated_at
-```
-
-约束：
-
- `tenant_id` 不可为空且不可变。
- `status` 至少支持 `active` 和受控停用状态。
- Tenant 只由 AIOS Control Plane 创建和维护。
- Runtime 不得创建租户。
-
-实现：`active-runtime/app/aios_v2/control_plane.py`
-
-## 3. Agent Contract
-
-### 3.1 AgentRecord
-
-```text
-agent_id
-tenant_id
-display_name
-runtime
-capabilities
-enabled
-metadata
-created_at
-updated_at
-```
-
-约束：
-
- Agent 属于唯一租户。
- `runtime` 由 Registry 决定，可取 `openclaw`、`hermes` 或后续注册 Runtime。
- `capabilities` 是允许调度的动作集合。
- `metadata` 可存 `cell_id`、`profile_id`、priority 等非敏感引用。
- 不得在 Agent metadata 中保存明文凭据。
-
-## 4. Task Contract
-
-### 4.1 TaskRecord
-
-```text
-task_id
-tenant_id
-agent_id
-action
-payload
-state
-revision
-idempotency_key
-request_digest
-result
-error
-created_by
-approved_by
-created_at
-updated_at
-```
-
-### 4.2 状态机
-
-```text
-CREATED -> APPROVED -> RUNNING -> COMPLETED
-    |          |          |
-    +----------+----------+-> CANCELLED
-                           +-> FAILED
-```
-
-允许转换：
-
-| 当前 | 允许目标 |
-|---|---|
-| CREATED | APPROVED, CANCELLED |
-| APPROVED | RUNNING, CANCELLED |
-| RUNNING | COMPLETED, FAILED, CANCELLED |
-| COMPLETED | 无 |
-| FAILED | 无 |
-| CANCELLED | 无 |
-
-约束：
-
- 每次转换必须校验 `revision`。
- COMPLETED 必须带 `result`。
- FAILED 必须带 `error`。
- 每次转换生成 AuditEvent。
- Runtime 不得直接写 Task Store，只能通过 Orchestrator reconcile。
-
-## 5. Policy Contract
-
-### 5.1 PolicyDecision
-
-```text
-allowed
-reason
-policy_version
-```
-
-约束：
-
- Policy 默认拒绝。
- Runtime 不得覆盖 PolicyDecision。
- 拒绝必须审计。
- 高风险动作必须经过 Approval。
-
-## 6. Audit Contract
-
-### 6.1 AuditEvent
-
-```text
-event_id
-tenant_id
-principal_id
-trace_id
-action
-resource_type
-resource_id
-outcome
-policy_version
-details
-created_at
-```
-
-约束：
-
- 按租户查询。
- `details` 不得包含明文凭据。
- OpenClaw/Hermes 生命周期事件必须映射到统一 AuditEvent。
- 生产版需增加不可变外部固化和完整性验证。
-
-## 7. OpenClaw Contract
-
-### 7.1 OpenClawCommand
-
-```text
-contract_version
-command_id
-tenant_id
-task_id
-trace_id
-action
-payload
-idempotency_key
-created_at
-expires_at
-key_id
-signature
-```
-
-签名覆盖：
-
- command_id
- tenant_id
- task_id
- trace_id
- action
- payload
- idempotency_key
- created_at / expires_at
- contract_version / key_id
-
-约束：
-
- 使用规范化 JSON 和 HMAC-SHA256。
- 只接受已批准任务生成的命令。
- 过期、未来时间超差、签名错误命令必须拒绝。
- `key_id` 只引用运行时材料，不包含材料本身。
-
-### 7.2 OpenClawResult
-
-```text
-command_id
-tenant_id
-task_id
-trace_id
-state
-output
-error
-started_at
-finished_at
-runtime_id
-attempts
-```
-
-状态：
-
-```text
-ACCEPTED
-RUNNING
-COMPLETED
-FAILED
-CANCELLED
-TIMED_OUT
-REJECTED
-```
-
-约束：
-
- Adapter 对外只接受终态结果用于 reconcile。
- 身份字段不匹配时拒绝回写。
- 结果通过 Orchestrator 更新 AIOS Task。
-
-### 7.3 RuntimeHealth
-
-```text
-runtime
-runtime_id
-status
-version
-heartbeat_at
-active_tasks
-workspace_isolated
-credential_ref_configured
-details
-```
-
-健康策略：
-
- heartbeat 不得超时。
- workspace isolation 与 credential reference 必须符合策略。
- 不安全 Runtime 应 quarantine，不得继续接收新任务。
-
-实现：`active-runtime/app/aios_openclaw/`
-
-## 8. Hermes Contract
-
-### 8.1 HermesJob
-
-```text
-job_id
-tenant_id
-cell_id
-profile_id
-task_id
-trace_id
-action
-payload
-idempotency_key
-priority
-state
-revision
-assigned_worker_id
-lease_expires_at
-created_at
-updated_at
-```
-
-状态机：
-
-```text
-QUEUED -> CLAIMED -> RUNNING -> COMPLETED
-   |         |          |
-   +---------+----------+-> CANCELLED
-                        +-> FAILED
-```
-
-约束：
-
- `tenant_id + cell_id + profile_id` 形成执行分区。
- claim 只能领取同分区 Job。
- Worker ID 不得跨分区复用。
- Lease 到期 Job 回到 QUEUED。
- revision 冲突不得覆盖。
-
-### 8.2 HermesResult
-
-```text
-job_id
-tenant_id
-task_id
-trace_id
-state
-worker_id
-output
-error
-started_at
-finished_at
-```
-
-约束：
-
- COMPLETED 必须有 output。
- FAILED 必须有 error。
- 只允许 AIOS Orchestrator reconcile。
-
-### 8.3 HermesHealth
-
-```text
-runtime_id
-status
-version
-heartbeat_at
-active_workers
-active_jobs
-queued_jobs
-tenant_partitions
-profile_isolation_enforced
-details
-```
-
-实现：`active-runtime/app/aios_hermes/`
-
-## 9. Execution Evidence Contract
-
-### 9.1 ExecutionEvidence
-
-```text
-execution_id
-tenant_id
-task_id
-agent_id
-executor
-branch
-status
-progress_completed
-progress_total
-current_step
-last_commit
-test_status
-test_summary
-result_summary
-claimed_at
-heartbeat_at
-completed_at
-```
-
-状态建议：
-
-```text
-claimed
-running
-blocked
-complete
-failed
-cancelled
-```
-
-约束：
-
- 按租户存储和查询。
- 每个阻塞必须记录原因、责任方和解除条件。
- 每次结果必须记录 branch、commit、测试命令和状态。
- 不得包含 Secret 或完整敏感 payload。
-
-## 10. GitOps Status Contract
-
-```text
-available
-service_status
-workspace_mode
-workspace_branch
-workspace_ref
-workspace_dirty
-candidate_branch
-release_channel
-release_version
-sync_status
-details
-```
-
-约束：
-
- Web 响应不得包含 remote URL、凭据或 stderr。
- Controller 必须 `detached + clean`。
- `sync_status` 必须区分 local 和 Gitea 镜像状态。
-
-## 11. Web/API Contract
-
-### 11.1 身份头
-
-可信代理注入：
-
-```text
-X-AIOS-Authenticated
-X-AIOS-Tenant-ID
-X-AIOS-Principal-ID
-X-AIOS-Roles
-X-AIOS-Trace-ID
-X-AIOS-Session-ID
-X-AIOS-Policy-Version
-```
-
-生产约束：
-
- 代理必须删除客户端同名头后重新注入。
- 应用不得直接暴露公网端口。
-
-### 11.2 核心 API
-
-```text
-GET  /api/v2/health
-POST /api/v2/tenants
-GET  /api/v2/tenants/current
-POST /api/v2/agents
-GET  /api/v2/agents
-POST /api/v2/tasks
-GET  /api/v2/tasks
-GET  /api/v2/tasks/{id}
-POST /api/v2/tasks/{id}/approve
-POST /api/v2/tasks/{id}/start
-POST /api/v2/tasks/{id}/complete
-POST /api/v2/tasks/{id}/fail
-POST /api/v2/tasks/{id}/cancel
-POST /api/v2/tasks/{id}/dispatch
-GET  /api/v2/audit
-GET  /api/v2/runtime
-GET  /api/v2/executions
-GET  /api/v2/gitops
-POST /api/v2/hermes/results/reconcile
-```
-
-## 12. Persistence Contract
-
-候选版：
-
- SQLite WAL
- `BEGIN IMMEDIATE`
- 原子 snapshot
- schema version
- restart restore
-
-持久化范围：
-
- tenants
- agents
- tasks
- audit
- idempotency
-
-生产替换要求：
-
- 不改变 Domain/API Contract。
- 提供 migration、backup、restore、HA、RLS/隔离和容量测试。
-
-## 13. Deployment Contract
-
-### systemd
-
- 非 root `aios` 用户。
- 状态目录 `/var/lib/aios-v2`。
- 最小权限和文件系统保护。
-
-### Docker
-
- 非 root UID/GID。
- read-only root filesystem。
- drop all capabilities。
- 独立状态 volume。
-
-### Rollback
-
- 回滚前备份状态。
- 默认只回滚代码。
- 状态恢复需显式授权。
- 回滚后必须执行 healthcheck。
-
-## 14. 契约变更规则
-
-任何以下变化必须在同一提交或同一分支更新本文档：
-
- 字段、状态、Header、API、错误语义；
- 租户或安全约束；
- OpenClaw/Hermes 边界；
- Persistence 或 Deployment Contract；
- Evidence/Audit 格式。
-
-不兼容变化必须新增 ADR 和版本号，不得静默修改。
@@ -1,113 +0,0 @@
-# AIOS V2 需求—架构—代码—测试—部署追踪矩阵
-
- 文档版本：`V2R1C0-candidate`
- 目的：确保每项用户需求都能追踪到架构设计、代码实现、自动测试、部署资产和验收命令
-
-## 1. 追踪规则
-
-每条需求至少具备：
-
-1. 需求编号；
-2. 架构章节；
-3. 实现路径；
-4. 测试路径；
-5. 部署/运维资产；
-6. 验收状态。
-
-状态定义：
-
- `Implemented`：代码已进入 Candidate 分支；
- `Test-defined`：测试代码已进入 Candidate 分支；
- `Test-verified`：精确 commit 的测试已运行并保存证据；
- `Pre-production verified`：预发布部署、健康检查和回滚演练已通过；
- `Production released`：Owner 批准并完成 merge/tag/deploy。
-
-## 2. 核心追踪矩阵
-
-| 需求 | 设计依据 | 代码实现 | 测试 | 部署/运维 | 当前状态 |
-|---|---|---|---|---|---|
-| UR-001 AIOS 唯一控制面 | `02-TARGET-ARCHITECTURE.md` §3.2/§3.3；ADR-001 | `aios_v2/control_plane.py`、`aios_v2/orchestrator.py`、`aios_v2/app.py` | `tests/aios_v2_candidate/test_candidate_flow.py` | `deploy/aios-v2/systemd/aios-v2.service` | Implemented / Test-defined |
-| UR-002 复用现有能力 | `02-TARGET-ARCHITECTURE.md` §2；`03-MIGRATION-AND-DELIVERY.md` §2 | `aios_openclaw/`、`aios_hermes/` | OpenClaw/Hermes flow tests | Candidate branch + adapter boundaries | Implemented / Test-defined |
-| UR-003 OpenClaw/Hermes 解耦 | `02-TARGET-ARCHITECTURE.md` §3.4/§3.5；ADR-002 | `aios_openclaw/adapter.py`、`aios_hermes/adapter.py` | runtime boundary tests in candidate flow suite | systemd/Docker runtime configuration | Implemented / Test-defined |
-| UR-004 全面 Web 化 | `02-TARGET-ARCHITECTURE.md` §3.1/§8 | `aios_v2/console.py`、`aios_v2/gateway.py`、`aios_v2/app.py` | API/console smoke test pending | Docker/systemd + reverse proxy requirement | Implemented / Test pending |
-| UR-005 多租户隔离 | `02-TARGET-ARCHITECTURE.md` §4；ADR-004 | `control_plane.py`、`orchestrator.py`、`aios_openclaw/*`、`aios_hermes/*`、`execution_tracking.py` | `test_cross_tenant_task_read_is_denied` | tenant-scoped state/evidence directories | Implemented / Test-defined |
-| UR-006 权威任务生命周期 | `04-MODULE-CONTRACTS.md` §4 | `control_plane.py` | OpenClaw/Hermes full-flow tests | persisted state + audit | Implemented / Test-defined |
-| UR-007 策略与审批 | `04-MODULE-CONTRACTS.md` §5 | `control_plane.py`、`gateway.py` | role/policy negative tests需补充 | reverse proxy identity + audit | Implemented / Partial test |
-| UR-008 幂等与并发安全 | `02-TARGET-ARCHITECTURE.md` §7 | `control_plane.py`、`aios_openclaw/adapter.py`、`aios_hermes/adapter.py`、`worker.py` | flow + restart tests；并发专项测试需补充 | GitOps detached guard + SQLite WAL | Implemented / Partial test |
-| UR-009 执行证据 | `04-MODULE-CONTRACTS.md` §9 | `execution_tracking.py` | `test_execution_tracking_persists_claim_heartbeat_and_result` | `/var/lib/aios-v2/executions` | Implemented / Test-defined |
-| UR-010 GitOps 唯一变更流程 | `03-MIGRATION-AND-DELIVERY.md` §4/§5；ADR-003 | GitOps Runtime、`gitops_status.py` | healthcheck 的 detached/clean 检查 | `deploy/aios-v2/healthcheck/check.sh` | Implemented / Runtime verified partially |
-| UR-011 持久化与恢复 | `02-TARGET-ARCHITECTURE.md` §3.6 | `persistence.py` | `test_durable_service_recovers_state_after_restart` | state dir + backup/rollback | Implemented / Test-defined |
-| UR-012 审计与合规 | `04-MODULE-CONTRACTS.md` §6 | `control_plane.py`、`aios_openclaw/callback.py`、`app.py` | flow test + audit assertions需补充 | Console audit view | Implemented / Partial test |
-| UR-013 密钥安全 | `02-TARGET-ARCHITECTURE.md` §6；ADR-006 | `FileSigningMaterialResolver`、credential refs、Secret Gate | permission/secret-scan test需补充 | env template + external protected file | Implemented / Partial test |
-| UR-014 部署与回滚 | `03-MIGRATION-AND-DELIVERY.md` §7 | deployment scripts/assets | acceptance runner + healthcheck | `deploy/aios-v2/` | Implemented / Pre-prod pending |
-| UR-015 文档与代码同步 | `03-MIGRATION-AND-DELIVERY.md` §9；ADR-005 | `tools/aios_v2_docs_code_check.py` | checker self-test / acceptance runner | CI/Gitea Actions 可调用 | Implemented after checker commit |
-
-## 3. API 追踪
-
-| API | 需求 | 实现 | 测试状态 |
-|---|---|---|---|
-| `GET /api/v2/health` | UR-004, UR-014 | `gateway.py` | healthcheck 定义完成 |
-| `POST /api/v2/tenants` | UR-001, UR-005 | `gateway.py` / `control_plane.py` | 需增加 HTTP 集成测试 |
-| `POST /api/v2/agents` | UR-001, UR-005 | `gateway.py` / `control_plane.py` | Domain flow 已覆盖 |
-| `POST /api/v2/tasks` | UR-006, UR-008 | `gateway.py` / `control_plane.py` | Domain flow 已覆盖 |
-| `POST /api/v2/tasks/{id}/approve` | UR-006, UR-007 | `gateway.py` | Domain flow 已覆盖 |
-| `POST /api/v2/tasks/{id}/dispatch` | UR-001, UR-003 | `app.py` / `orchestrator.py` | OpenClaw/Hermes flow 已覆盖 |
-| `GET /api/v2/runtime` | UR-004, UR-009 | `app.py` | HTTP smoke test待执行 |
-| `GET /api/v2/executions` | UR-009 | `app.py` / `execution_tracking.py` | Evidence persistence test已定义 |
-| `GET /api/v2/gitops` | UR-010 | `app.py` / `gitops_status.py` | Runtime/healthcheck验证待执行 |
-| `POST /api/v2/hermes/results/reconcile` | UR-003, UR-006 | `app.py` / `orchestrator.py` | Hermes flow已覆盖 Domain 路径 |
-
-## 4. 运行时契约追踪
-
-| 契约 | 设计 | 代码 | 测试 |
-|---|---|---|---|
-| OpenClawCommand | `04-MODULE-CONTRACTS.md` §7.1 | `aios_openclaw/contract.py` | OpenClaw full-flow；签名负向测试需补充 |
-| OpenClawResult | §7.2 | `aios_openclaw/contract.py` | OpenClaw full-flow |
-| RuntimeHealth | §7.3 | `aios_openclaw/contract.py`、`health.py` | health policy测试需补充 |
-| HermesJob | §8.1 | `aios_hermes/contract.py` | Hermes full-flow |
-| HermesResult | §8.2 | `aios_hermes/contract.py` | Hermes full-flow |
-| HermesHealth | §8.3 | `aios_hermes/contract.py`、`adapter.py` | healthcheck/worker test待执行 |
-| ExecutionEvidence | §9 | `execution_tracking.py` | evidence persistence test |
-| GitOpsStatus | §10 | `gitops_status.py` | healthcheck detached/clean检查 |
-
-## 5. 部署追踪
-
-| 能力 | 文件 | 验收命令 |
-|---|---|---|
-| systemd | `deploy/aios-v2/systemd/aios-v2.service` | `systemctl status aios-v2` |
-| 环境模板 | `deploy/aios-v2/env/aios-v2.env.example` | `systemd-analyze verify` + 文件权限检查 |
-| Docker | `deploy/aios-v2/docker/Dockerfile` | `docker build` |
-| Compose | `deploy/aios-v2/docker/compose.yaml` | `docker compose config` / `up` |
-| 健康检查 | `deploy/aios-v2/healthcheck/check.sh` | 直接执行 |
-| 回滚 | `deploy/aios-v2/rollback/rollback.sh` | 预发布回滚演练 |
-| 全量验收 | `deploy/aios-v2/acceptance/run-all.sh` | 直接执行 |
-
-## 6. 文档覆盖追踪
-
-| 文档 | 覆盖内容 | 代码/变更触发条件 |
-|---|---|---|
-| `README.md` | 事实源索引、状态语言、实现地图 | 新模块/目录/版本 |
-| `01-USER-REQUIREMENTS.md` | 用户需求、NFR、验收场景 | 用户行为、功能范围、验收变化 |
-| `02-TARGET-ARCHITECTURE.md` | 分层、边界、数据流、安全、租户 | 架构边界、数据流、运行时变化 |
-| `03-MIGRATION-AND-DELIVERY.md` | 迁移、GitOps、Gate、回滚 | 发布流程、迁移阶段、门禁变化 |
-| `04-MODULE-CONTRACTS.md` | 字段、API、状态机、错误语义 | Contract/API/模型变化 |
-| `05-TRACEABILITY-MATRIX.md` | 需求到代码测试部署映射 | 代码、测试、部署路径变化 |
-| `adr/*` | 关键不可逆或跨模块决策 | 新架构决策或旧决策替换 |
-
-## 7. 当前未完成验证项
-
-以下项目代码或测试定义已存在，但尚不能标记为 `Test-verified` 或 `Pre-production verified`：
-
-1. 精确 Candidate commit 的测试执行结果；
-2. HTTP API 与 Web Console 冒烟测试；
-3. 真实 OpenClaw Runtime 签名、取消、超时和健康联调；
-4. Hermes 长任务心跳、Worker 崩溃和 Lease 恢复演练；
-5. 多实例 SQLite/并发容量边界；
-6. systemd、Docker、Compose、restart 和 rollback 演练；
-7. local/Gitea Candidate OID 一致证明；
-8. 生产身份代理、防伪 Header、CSRF/CORS/Rate Limit 验证；
-9. 文档—代码同步检查器在 CI/Acceptance 中执行通过。
-
-## 8. 更新要求
-
-任何代码、API、部署或测试路径变化，必须同步更新本矩阵。验收脚本会检查本文档引用的关键路径存在，并检查架构/功能代码变化是否同时包含 `docs/aios-v2/` 变化。
@@ -1,98 +0,0 @@
-# AIOS V2 Architecture and Delivery Index
-
- Version line: `V2R1C0-candidate`
- Candidate branch: `integration/aios-v2r1-cto-production-candidate-20260720`
- Architecture owner: AIOS V2 CTO
- Status: implementation-complete candidate; runtime and production verification pending
-
-## 1. Purpose
-
-This directory is the single source of truth for AIOS V2 requirements, target architecture, module boundaries, migration strategy, release gates and architectural decisions.
-
-The design is based on the following non-negotiable principles:
-
-1. Do not rewrite the existing platform.
-2. Reuse OpenClaw, Hermes and Agent Router capabilities.
-3. Decouple OpenClaw and Hermes from control-plane ownership.
-4. AIOS is the only control plane.
-5. All user-facing and operational capabilities are Web/API accessible.
-6. Every module enforces multi-tenant isolation.
-7. Every change flows through Git branches, commits, tests, review and controlled promotion.
-
-## 2. Document map
-
-| Document | Purpose |
-|---|---|
-| [01-USER-REQUIREMENTS.md](01-USER-REQUIREMENTS.md) | Product goals, user requirements, non-functional requirements and acceptance criteria |
-| [02-TARGET-ARCHITECTURE.md](02-TARGET-ARCHITECTURE.md) | Target logical architecture, control boundaries, data flow, security and tenancy model |
-| [03-MIGRATION-AND-DELIVERY.md](03-MIGRATION-AND-DELIVERY.md) | Incremental migration plan, reuse strategy, GitOps workflow and release gates |
-| [04-MODULE-CONTRACTS.md](04-MODULE-CONTRACTS.md) | Tenant context, task lifecycle, OpenClaw, Hermes, audit and execution-evidence contracts |
-| [05-TRACEABILITY-MATRIX.md](05-TRACEABILITY-MATRIX.md) | Requirement-to-design-to-code-to-test mapping |
-| [adr/README.md](adr/README.md) | Architecture decision records |
-
-## 3. Current implementation map
-
-| Architecture capability | Candidate implementation |
-|---|---|
-| Tenant, agent, task, policy and audit control plane | `active-runtime/app/aios_v2/control_plane.py` |
-| Durable control-plane state | `active-runtime/app/aios_v2/persistence.py` |
-| Web/API gateway | `active-runtime/app/aios_v2/gateway.py` |
-| Unified application entrypoint | `active-runtime/app/aios_v2/app.py` |
-| Runtime dispatch and reconciliation | `active-runtime/app/aios_v2/orchestrator.py` |
-| Agent execution evidence | `active-runtime/app/aios_v2/execution_tracking.py` |
-| GitOps runtime visibility | `active-runtime/app/aios_v2/gitops_status.py` |
-| Web Console | `active-runtime/app/aios_v2/console.py` |
-| OpenClaw execution boundary | `active-runtime/app/aios_openclaw/` |
-| Hermes runtime boundary | `active-runtime/app/aios_hermes/` |
-| Candidate tests | `tests/aios_v2_candidate/` |
-| Deployment, health and rollback | `deploy/aios-v2/` |
-
-## 4. Status vocabulary
-
-The project separates code availability from release readiness:
-
- **Designed**: documented boundary and acceptance criteria exist.
- **Implemented**: code is committed on the candidate branch.
- **Test-defined**: automated tests exist in Git.
- **Test-verified**: tests were executed for the exact commit and evidence was recorded.
- **Pre-production verified**: deployed in an isolated environment with health, restart and rollback evidence.
- **Production released**: owner-approved merge/tag/deployment completed.
-
-A branch or file existing does not, by itself, mean a capability is production-ready.
-
-## 5. Design summary
-
-```text
-Browser / Web Console / Public API
-                 |
-                 v
-          AIOS Control Plane
-  Tenant | Agent | Task | Policy | Audit
-                 |
-                 v
-       Execution Orchestrator / Router
-             /                 \
-            v                   v
-   OpenClaw Adapter       Hermes Boundary
-            |                   |
-            v                   v
-   OpenClaw Runtime       Hermes Workers
-                 \
-                  v
-      Result Reconciliation + Evidence
-```
-
-The control plane owns authoritative identity, policy, approval, task lifecycle and audit state. OpenClaw and Hermes receive only tenant-scoped, approved execution work and return runtime results.
-
-## 6. Release rule
-
-No candidate may be promoted until:
-
- requirement-to-code traceability is complete;
- multi-tenant negative tests pass;
- controller workspace is detached and clean;
- local Git and Gitea branch OIDs match;
- persistence restart recovery passes;
- healthcheck and rollback pass in pre-production;
- no plaintext secret enters Git;
- owner approval is recorded for merge, tag and production deployment.
@@ -1,39 +0,0 @@
-# ADR-001: AIOS 作为唯一控制面
-
- Status: Accepted
- Date: 2026-07-20
-
-## Context
-
-现有系统包含多个执行和调度能力，若每个 Runtime 保存自己的任务、租户和策略状态，会形成多个事实源。
-
-## Decision
-
-AIOS Control Plane 是唯一权威控制面，负责：
-
- Tenant
- Agent
- Task
- Policy
- Approval
- Audit
- Execution Evidence
-
-OpenClaw、Hermes、Agent Router 只能执行或路由，不拥有第二套控制状态。
-
-## Consequences
-
-Positive:
-
- 状态唯一；
- 审计完整；
- Web/API 统一。
-
-Negative:
-
- Runtime 接入需要 Adapter。
- 迁移需要阶段性边界收敛。
-
-## Compliance
-
-任何新 Runtime 必须通过 AIOS Orchestrator 接入。
@@ -1,46 +0,0 @@
-# ADR-002: OpenClaw/Hermes 与控制面解耦
-
- Status: Accepted
- Date: 2026-07-20
-
-## Context
-
-OpenClaw 和 Hermes 已具备执行能力，但历史上可能承担部分控制职责。
-
-## Decision
-
-引入边界层：
-
-```text
-AIOS Control Plane
-        |
-        v
-Adapter / Boundary
-        |
-        v
-Runtime
-```
-
-OpenClaw：
-
- 执行签名命令；
- 返回结果；
- 提供健康状态。
-
-Hermes：
-
- 队列；
- Worker；
- Lease；
- Heartbeat；
- 执行结果。
-
-## Consequences
-
- Runtime 可独立演进。
- 控制逻辑不会分裂。
- 需要维护稳定 Contract。
-
-## Migration
-
-先接 Adapter，再迁移旧调用入口，最后关闭控制旁路。
@@ -1,44 +0,0 @@
-# ADR-003: 所有变更必须通过 GitOps
-
- Status: Accepted
- Date: 2026-07-20
-
-## Context
-
-直接在生产目录、长期 worktree 或主分支上修改代码，会造成不可追踪、不可回滚和分支冲突。
-
-## Decision
-
-所有代码、配置、文档、测试、部署和回滚资产必须通过以下流程：
-
-```text
-non-main branch -> commit -> local sync -> Gitea sync -> test -> review -> controlled promotion
-```
-
-Controller worktree 必须长期保持 detached 且 clean。每个写任务使用独立工作区或受控写入流程；相同分支写入必须串行。
-
-## Required evidence
-
-每个任务必须记录：
-
- branch
- commit
- changed files
- test command and result
- blocker and resolution
- local/Gitea sync status
- rollback note
-
-## Prohibited
-
- 直接 push `main`
- 未审批创建生产 Tag
- 在生产目录手工修改后不回写 Git
- fetch 到已被 worktree 检出的本地 branch ref
- 在 Git 中提交明文密钥
-
-## Consequences
-
-优点：可审计、可回滚、可并行治理。
-
-成本：紧急修复也必须形成 patch branch 和证据。
@@ -1,43 +0,0 @@
-# ADR-005: 文档与代码同步门禁
-
- Status: Accepted
- Date: 2026-07-20
-
-## Context
-
-架构、功能和部署变化如果不同步文档，会导致版本无法审计，后续 Agent 无法判断真实设计。
-
-## Decision
-
-所有影响以下内容的变更必须同步 `docs/aios-v2/`：
-
- 用户行为；
- API；
- 数据模型；
- 状态机；
- Runtime Boundary；
- 安全策略；
- 部署流程；
- 测试门禁。
-
-## Gate
-
-验收必须检查：
-
-1. 文档引用代码路径存在；
-2. API 文档有实现映射；
-3. Contract 字段有模型映射；
-4. Traceability Matrix 已更新；
-5. ADR 与架构变化一致。
-
-## Consequences
-
-优点：
-
- 架构长期可维护；
- Agent 执行有明确上下文；
- Bug 修复有历史依据。
-
-成本：
-
- 小功能也需要更新对应文档。
@@ -1,39 +0,0 @@
-# AIOS V2 Architecture Decision Records
-
-本目录记录影响多个模块、长期演进、兼容性、安全或交付流程的关键架构决策。
-
-## ADR 列表
-
-| ADR | 决策 |
-|---|---|
-| [ADR-001](ADR-001-single-control-plane.md) | AIOS 作为唯一控制面 |
-| [ADR-002](ADR-002-openclaw-hermes-decoupling.md) | OpenClaw/Hermes 与控制面解耦 |
-| [ADR-003](ADR-003-gitops-only-change-flow.md) | 所有变更必须通过 GitOps |
-| [ADR-004](ADR-004-multi-tenant-isolation.md) | 多租户隔离默认拒绝 |
-| [ADR-005](ADR-005-document-code-sync-gate.md) | 文档与代码同步门禁 |
-| [ADR-006](ADR-006-candidate-persistence-strategy.md) | 候选持久化采用可替换 SQLite Snapshot |
-
-## ADR 状态
-
- `Proposed`：提出但未采纳。
- `Accepted`：当前有效决策。
- `Superseded`：被新 ADR 替代。
- `Deprecated`：保留历史但禁止新实现采用。
-
-## 何时必须新增或更新 ADR
-
-以下变化必须新增或更新 ADR：
-
-1. 控制面与 Runtime 权限边界变化；
-2. 多租户隔离模型变化；
-3. API、数据模型或状态机出现不兼容变化；
-4. 持久化、消息、密钥、审计或部署方案发生跨模块变化；
-5. GitOps、发布、回滚或文档门禁变化；
-6. 替换 OpenClaw、Hermes、Agent Router 或核心基础设施。
-
-ADR 变化必须同步更新：
-
- `02-TARGET-ARCHITECTURE.md`
- `04-MODULE-CONTRACTS.md`
- `05-TRACEABILITY-MATRIX.md`
- 对应代码、测试和部署资产
@@ -0,0 +1,268 @@
+# AIOS Silent Release Controller Design Report
+
+状态：隔离分支实现；生产 mutation 禁止
+目标：自动准备 → 自动验证 → 单次 Owner 签名授权 → 分控制器自动执行与验收
+
+## 1. 当前痛点
+
+现有流程需要多轮人工传递 commit、tree、artifact、manifest、测试、canary、drop-in
+和回滚证据。证据在不同消息里重复抄写，容易出现：
+
+- 构建后 artifact、manifest 或 policy 已变化，但旧批准仍被使用；
+- Git、Gitea、systemd 与回滚结果由人工拼接，缺少同一一致性快照；
+- runtime switch、tag、Baseline、Registry 的授权边界不清；
+- 重启后只剩工作树内临时 JSON，无法可靠恢复；
+- approval replay、并发 writer、key revoke 和 secret inheritance 缺少统一防线。
+
+## 2. 新架构
+
+```text
+Build / Test / Canary
+        |
+        v
+ReleaseCandidate + DeploymentPlan
+        |
+        v
+ReleaseAcceptanceEngine
+        |
+        v
+READY_FOR_APPROVAL
+        |
+        v
+SignedReleasePlanApproval (Ed25519)
+        |
+        +--> runtime_switch capability
+        |       DeploymentController
+        |
+        +--> tag_publish capability
+        |       TagController
+        |
+        +--> baseline_registry_finalize capability
+                BaselineRegistryFinalizeController
+
+Durable ReleaseSagaStore + CapabilityLedger + Event Journal
+贯穿三个控制器；控制器互相不拥有对方的 mutation API。
+```
+
+一次 Owner 批准是同一个不可变 release plan 的签名，不是一个万能执行入口。三个 capability
+分别消费、分别留痕、分别幂等恢复。`force_push`、`tag_rewrite`、`direct_main_push`
+永远不是可签发 capability。
+
+## 3. 状态机
+
+```text
+PREPARING
+  -> VERIFYING
+  -> READY_FOR_APPROVAL
+  -> APPROVED
+  -> PRE_SWITCH_REVALIDATING
+  -> SWITCH_PENDING
+  -> SWITCHED
+  -> RUNTIME_VERIFYING
+  -> TAG_PENDING
+  -> TAG_VERIFIED
+  -> BASELINE_REGISTRY_PENDING
+  -> COMPLETED
+
+任一可恢复故障 -> RECONCILIATION_REQUIRED
+对象冲突       -> MANUAL_OWNER_REVIEW_REQUIRED
+切换后失败     -> ROLLBACK_PENDING -> ROLLED_BACK
+```
+
+状态快照使用 revision compare-and-set；事件同时写入 append-only journal。writer 崩溃后根据
+状态确定唯一恢复动作。并发控制器中只有一个 CAS winner。
+
+## 4. 数据模型
+
+### ReleaseCandidate
+
+```text
+candidate_id
+source_commit
+tree_oid
+artifact_sha256
+manifest_sha256
+tests
+canary
+rollback_ready
+git_consistency
+gitea_consistency
+approval_state
+```
+
+### DeploymentPlan
+
+```text
+service
+release_path / release_root
+dropin_path / dropin_sha256
+rollback_path / rollback_sha256
+source_commit
+artifact_sha256
+manifest_sha256
+policy_sha256
+health_contract
+sha256
+```
+
+### SignedReleasePlanApproval
+
+```text
+release_plan_id
+candidate_id
+source_commit
+tree_oid
+artifact_sha256
+manifest_sha256
+deployment_plan_sha256
+policy_sha256
+approval_plan_id
+evidence_closure_oid
+owner_approval_record_oid
+capabilities
+expires_at
+nonce
+key_id
+signature
+fingerprint
+```
+
+签名内容使用 canonical JSON，`signature` 不参与被签名字段。验证包括 Ed25519 签名、过期时间、
+公钥状态、approval revoke、candidate/plan/policy 逐字段绑定和 capability allowlist。
+
+## 5. API
+
+```text
+POST /createReleaseCandidate
+GET  /getReleaseCandidate?candidate_id=...
+GET  /getApprovalEnvelope?candidate_id=...
+POST /submitOwnerApproval
+POST /startDeployment
+GET  /getReleaseSaga?candidate_id=...
+```
+
+写接口要求 Bearer scope。`AIOS_SILENT_RELEASE_EXECUTION_ENABLED=false` 是默认值；此时可以
+持久化 candidate、生成 approval envelope、保存经验证的 Owner approval 和读取 Saga，
+但 `/startDeployment` 只返回 `SHADOW_MODE` 与空 `side_effects`。
+
+## 6. PreSwitchValidator
+
+切换前重新收集并比较：
+
+- source commit 与 tree；
+- artifact、manifest、policy 和 deployment plan SHA-256；
+- rollback readiness；
+- local、authoritative bare 与 Gitea refs；
+- repository identity；
+- task writer/production writer 边界；
+- health contract。
+
+任一变化都抛出：
+
+```text
+APPROVAL_STALE_REAPPROVAL_REQUIRED
+```
+
+旧批准不会被“最佳努力”继续使用。
+
+## 7. systemd 防线
+
+- service 与 drop-in 均为显式 allowlist；
+- release 与 drop-in resolved path 必须位于 release root 内；
+- 拒绝普通文件被替换为 symlink，拒绝 symlink escape；
+- deployment lock 覆盖 switch、restart 和首次 health check；
+- restart 前后记录 MainPID 与 ActiveEnterTimestampMonotonic；
+- artifact、drop-in、rollback 和 manifest 均按 plan hash 复验；
+- 子进程只接收固定 allowlist 环境，不继承 token、password、credential、askpass、
+  auth socket、`LD_PRELOAD`、`PYTHONPATH` 或数据库连接串。
+
+## 8. TagController 分离
+
+TagController 必须独立完成 approval、execute、verify，并留下：
+
+```text
+evidence_closure_oid
+approval_plan_id
+repository_identity
+remote_tag_oid
+remote_peeled_target_oid
+gitea_api_tag_oid
+gitea_listing_visible
+```
+
+同名 tag 的 tag OID 或 peeled target 不同，进入
+`MANUAL_OWNER_REVIEW_REQUIRED`；自动流程不 push、不删除、不重写、不 force push。
+
+## 9. Baseline / Registry 门禁
+
+只有以下全部一致时，`baseline_registry_finalize` capability 才能完成：
+
+```text
+Registry = Baseline = remote tag = Gitea API = expected target
+```
+
+UNKNOWN、API 不可达、repository identity 不符或 listing 不可见均 fail closed。
+
+## 10. Policy as Code
+
+```text
+automatic:
+  build, test, artifact, canary, evidence
+
+owner:
+  signed_release_plan
+
+capabilities:
+  runtime_switch
+  tag_publish
+  baseline_registry_finalize
+
+forbidden:
+  force_push
+  tag_rewrite
+  direct_main_push
+  baseline_mutation
+  registry_mutation
+```
+
+最后两个 forbidden 项指“脱离受治理 finalize controller 的直接 mutation”。
+
+## 11. Security model
+
+- Ed25519 公钥 ring 支持 rotation 和 revoke，私钥不进入 runtime；
+- approval plan 可撤销，过期、未知 key、错误签名均 fail closed；
+- nonce 与 capability operation 持久化，重复相同请求幂等，不同 fingerprint 重放拒绝；
+- Saga snapshot 原子写、journal append-only、CAS 防并发 writer；
+- credential 只通过受控 reference 使用，不进入 Git、API 响应或异常；
+- 子进程环境从空集合构建，不复制 `os.environ`；
+- Shadow 模式默认开启，execution adapter 缺失时不能降级执行；
+- runtime、tag、Baseline/Registry 分属三个能力最小化控制器。
+
+## 12. Migration plan
+
+1. Shadow：生成 candidate、plan、acceptance、approval package，仅比较现有人工结果。
+2. Signed approval：接入 Owner 公钥 ring、撤销源和审计 record；仍不接生产 executor。
+3. Canary execution：使用非生产 service/release root 验证锁、PID、health、崩溃恢复和回滚。
+4. Controlled production switch：另行 Owner 授权启用 execution flag，只开放 runtime capability。
+5. Tag/finalize：分别完成 Gitea 与 Registry/Baseline 生产验收后再启用对应 capability。
+
+每个阶段均可退回上一个阶段；不开启下一能力不会影响已经启用的控制器。
+
+## 13. Rollback plan
+
+- switch 前保存旧 symlink target、PID、启动时间、artifact 与 plan fingerprint；
+- restart 或 health 任一失败进入 `ROLLBACK_PENDING`；
+- 原子恢复旧 target，只 restart 指定 allowlist service；
+- 重新验证旧 runtime commit、writer=false 与 repository identity；
+- 成功进入 `ROLLED_BACK`，失败进入 `MANUAL_OWNER_REVIEW_REQUIRED`；
+- rollback 不修改 Git main、production tag、Baseline 或 Registry；
+- 保留脱敏 journal、approval fingerprint 和失败证据。
+
+## 14. 测试与外部依赖边界
+
+自动测试覆盖签名伪造、字段篡改、过期/revoke/key rotation、nonce replay、CAS race、
+崩溃恢复、artifact/policy/plan mutation、tag conflict、secret leakage、runtime without
+`.git`、rollback 和 shadow no-side-effects。
+
+本隔离实现不创建生产 KMS/key、不安装 systemd unit、不部署 Action runtime、不创建 tag，
+也不修改 Baseline/Registry。上述动作必须在单独生产批准中执行。
@@ -0,0 +1,68 @@
+# Gitea Tag Publication Atomicity
+
+Release publication is a fail-closed Saga bound to one immutable governance
+fingerprint:
+
+- `version`
+- `target_oid`
+- `evidence_closure_oid`
+- `approval_plan_id`
+
+The normal progression is:
+
+`PENDING` → `LOCAL_TAG_CREATED` → `REMOTE_PUSH_CONFIRMED` →
+`GITEA_API_CONFIRMED` → `BASELINE_UPDATE_PENDING` → `BASELINE_UPDATED` →
+`PRODUCTION_DEPLOYED`
+
+An unavailable remote uses `REMOTE_PUSH_PENDING` or
+`RECONCILIATION_REQUIRED`. A same-name tag object mismatch, peeled-target
+mismatch, changed governance fingerprint, or immutable deployment-evidence
+conflict enters `MANUAL_OWNER_REVIEW_REQUIRED`. That state blocks automatic
+push and reconciliation; recovery never deletes, rewrites, or force-pushes a
+tag.
+
+## Legacy state migration
+
+Readers normalize the historical `TAG_CREATED_LOCAL` value to
+`LOCAL_TAG_CREATED` in memory. Read-only status responses therefore expose only
+the canonical value. The next governed Saga write persists the canonical name;
+reading legacy state alone does not mutate the tag, Baseline, Registry, or Saga
+file. Any unrecognized persisted state fails closed as
+`RECONCILIATION_REQUIRED`.
+
+`BASELINE_UPDATE_PENDING` is persisted before either `baseline/current.json` or
+`versions/<version>.json` changes. Recovery revalidates the governance
+fingerprint, evidence lineage, remote annotated tag, peeled target, Gitea API,
+listing, and repository identity before idempotently completing matching
+partial records. A different tag or target enters
+`MANUAL_OWNER_REVIEW_REQUIRED`.
+
+## Durable state
+
+Production writers set `AIOS_GITOPS_PUBLICATION_STATE_DIR` to storage outside
+their disposable worktree. Recreating a writer must reuse that directory.
+Worktree JSON is not the authoritative Saga store.
+
+## Deployment gate
+
+`mark_production_deployed` performs fresh Git remote, peeled-target, Gitea ref,
+Gitea tag-object, listing, repository-identity, evidence-lineage, Registry, and
+Baseline checks. Deployment is allowed only when:
+
+`Registry = Baseline = remote tag = Gitea API = expected target`
+
+Deployment evidence must be an immutable `sha256:<64 hex>` or `git:<40 hex>`
+identifier.
+
+## Read-only acceptance
+
+- `getTagPublicationStatus` reads durable Saga state.
+- `getReleaseConsistency` compares every release authority.
+- `runReleaseAcceptance` returns `accepted: true` only for `PASS`.
+
+Unavailable evidence returns `UNKNOWN` with `fail_closed: true`; it is never
+treated as acceptance.
+
+The CLI, HTTP Action, and release script all enter the same publisher core for
+evidence-lineage verification. The release script stages Registry and Baseline
+records only; durable Saga state remains outside Git.
@@ -13,6 +13,27 @@ components:
      scheme: bearer
      bearerFormat: opaque-token
  schemas:
+    PublicationState:
+      type: string
+      description: Canonical durable publication state. Legacy TAG_CREATED_LOCAL is normalized on read and is never emitted by new writes.
+      enum:
+        - PENDING
+        - LOCAL_TAG_CREATED
+        - REMOTE_PUSH_PENDING
+        - REMOTE_PUSH_CONFIRMED
+        - GITEA_API_CONFIRMED
+        - BASELINE_UPDATE_PENDING
+        - BASELINE_UPDATED
+        - PRODUCTION_DEPLOYED
+        - RECONCILIATION_REQUIRED
+        - MANUAL_OWNER_REVIEW_REQUIRED
+    PublicationStatus:
+      type: object
+      required: [version, state]
+      properties:
+        version: {type: string}
+        state: {$ref: '#/components/schemas/PublicationState'}
+        fail_closed: {type: boolean}
    BranchRequest:
      type: object
      required: [branch]
@@ -50,9 +71,20 @@ components:
        message: {type: string}
    TagRequest:
      type: object
-      required: [version]
+      required: [version, target_oid, evidence_closure_oid, approval_plan_id]
      properties:
        version: {type: string, example: V1R1C1}
+        target_oid:
+          type: string
+          pattern: '^[0-9a-fA-F]{40}$'
+          description: Full approved commit OID. The tag is created explicitly at this commit, never implicitly at workspace HEAD.
+        evidence_closure_oid:
+          type: string
+          pattern: '^[0-9a-fA-F]{40}$'
+          description: Required evidence closure commit. target_oid must be its ancestor.
+        approval_plan_id:
+          type: string
+          description: Audited owner-approved release or tag plan identifier.
        message: {type: string}
        execute:
          type: boolean
@@ -103,7 +135,142 @@ components:
      properties:
        text: {type: string}
        branch: {type: string}
+    DeploymentPlan:
+      type: object
+      required: [service, release_path, release_root, dropin_path, dropin_sha256, rollback_path, rollback_sha256, source_commit, artifact_sha256, manifest_sha256, policy_sha256, health_contract]
+      properties:
+        service: {type: string}
+        release_path: {type: string}
+        release_root: {type: string}
+        dropin_path: {type: string}
+        dropin_sha256: {type: string, pattern: '^[0-9a-f]{64}$'}
+        rollback_path: {type: string}
+        rollback_sha256: {type: string, pattern: '^[0-9a-f]{64}$'}
+        source_commit: {type: string, pattern: '^[0-9a-f]{40}$'}
+        artifact_sha256: {type: string, pattern: '^[0-9a-f]{64}$'}
+        manifest_sha256: {type: string, pattern: '^[0-9a-f]{64}$'}
+        policy_sha256: {type: string, pattern: '^[0-9a-f]{64}$'}
+        health_contract: {type: object, additionalProperties: true}
+    ReleaseCandidateInput:
+      type: object
+      required: [candidate_id, source_commit, tree_oid, artifact_sha256, manifest_sha256]
+      properties:
+        candidate_id: {type: string, pattern: '^[A-Za-z0-9][A-Za-z0-9_.-]{2,127}$'}
+        source_commit: {type: string, pattern: '^[0-9a-f]{40}$'}
+        tree_oid: {type: string, pattern: '^[0-9a-f]{40}$'}
+        artifact_sha256: {type: string, pattern: '^[0-9a-f]{64}$'}
+        manifest_sha256: {type: string, pattern: '^[0-9a-f]{64}$'}
+        tests: {type: object}
+        canary: {type: object}
+        rollback_ready: {type: boolean}
+        git_consistency: {type: object}
+        gitea_consistency: {type: object}
+        deployment_plan: {$ref: '#/components/schemas/DeploymentPlan'}
+    SignedReleasePlanApproval:
+      type: object
+      required: [release_plan_id, candidate_id, source_commit, tree_oid, artifact_sha256, manifest_sha256, deployment_plan_sha256, policy_sha256, approval_plan_id, evidence_closure_oid, owner_approval_record_oid, capabilities, expires_at, nonce, key_id, signature]
+      properties:
+        release_plan_id: {type: string}
+        candidate_id: {type: string}
+        source_commit: {type: string, pattern: '^[0-9a-f]{40}$'}
+        tree_oid: {type: string, pattern: '^[0-9a-f]{40}$'}
+        artifact_sha256: {type: string, pattern: '^[0-9a-f]{64}$'}
+        manifest_sha256: {type: string, pattern: '^[0-9a-f]{64}$'}
+        deployment_plan_sha256: {type: string, pattern: '^[0-9a-f]{64}$'}
+        policy_sha256: {type: string, pattern: '^[0-9a-f]{64}$'}
+        approval_plan_id: {type: string}
+        evidence_closure_oid: {type: string, pattern: '^[0-9a-f]{40}$'}
+        owner_approval_record_oid: {type: string, pattern: '^[0-9a-f]{40}$'}
+        capabilities:
+          type: array
+          uniqueItems: true
+          items:
+            type: string
+            enum: [runtime_switch, tag_publish, baseline_registry_finalize]
+        expires_at: {type: string, format: date-time}
+        nonce: {type: string, minLength: 16}
+        key_id: {type: string}
+        signature: {type: string, format: byte, writeOnly: true}
+    StartDeploymentRequest:
+      type: object
+      required: [candidate_id, approval]
+      properties:
+        candidate_id: {type: string}
+        approval: {$ref: '#/components/schemas/SignedReleasePlanApproval'}
 paths:
+  /createReleaseCandidate:
+    post:
+      operationId: createReleaseCandidate
+      summary: Persist an immutable release candidate and deployment plan; shadow-safe
+      security: [{bearerAuth: []}]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: {$ref: '#/components/schemas/ReleaseCandidateInput'}
+      responses:
+        '200': {description: Candidate created or idempotently returned}
+        '400': {description: Invalid or conflicting candidate evidence}
+        '401': {description: Unauthorized}
+      x-openai-isConsequential: true
+  /getReleaseCandidate:
+    get:
+      operationId: getReleaseCandidate
+      summary: Read a durable release candidate
+      parameters:
+        - {in: query, name: candidate_id, required: true, schema: {type: string}}
+      responses:
+        '200': {description: Candidate}
+        '404': {description: Candidate not found}
+  /getApprovalEnvelope:
+    get:
+      operationId: getApprovalEnvelope
+      summary: Generate the immutable owner-signature payload
+      parameters:
+        - {in: query, name: candidate_id, required: true, schema: {type: string}}
+      responses:
+        '200': {description: Approval envelope fingerprint inputs}
+        '404': {description: Candidate not found}
+  /submitOwnerApproval:
+    post:
+      operationId: submitOwnerApproval
+      summary: Verify and durably store a signed owner release plan
+      security: [{bearerAuth: []}]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: {$ref: '#/components/schemas/SignedReleasePlanApproval'}
+      responses:
+        '200': {description: Signature verified and approval stored}
+        '400': {description: Invalid approval}
+        '403': {description: Signature, key, expiry, or revocation failure}
+        '409': {description: Conflicting release plan}
+      x-openai-isConsequential: true
+  /startDeployment:
+    post:
+      operationId: startDeployment
+      summary: Start the approved Saga; default shadow mode returns no side effects
+      security: [{bearerAuth: []}]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: {$ref: '#/components/schemas/StartDeploymentRequest'}
+      responses:
+        '200': {description: Shadow result or deployment Saga result}
+        '403': {description: Execution disabled or approval invalid}
+        '409': {description: Saga conflict}
+      x-openai-isConsequential: true
+  /getReleaseSaga:
+    get:
+      operationId: getReleaseSaga
+      summary: Read durable Saga state and event journal
+      parameters:
+        - {in: query, name: candidate_id, required: true, schema: {type: string}}
+      responses:
+        '200': {description: Saga snapshot}
+        '404': {description: Saga not found}
  /api/base:
    get:
      operationId: getBaseline
@@ -199,6 +366,39 @@ paths:
            schema: {$ref: '#/components/schemas/CommitRequest'}
      responses: {'200': {description: Commit result}, '401': {description: Unauthorized}}
      x-openai-isConsequential: true
+  /api/tag-publication-status:
+    get:
+      operationId: getTagPublicationStatus
+      summary: Read durable publication Saga status without mutation
+      parameters:
+        - {in: query, name: version, required: true, schema: {type: string, pattern: '^V\d+R\d+C\d+(?:-[A-Za-z0-9_.-]+)?$'}}
+      responses:
+        '200':
+          description: Canonical publication state or fail-closed UNKNOWN
+          content:
+            application/json:
+              schema: {$ref: '#/components/schemas/PublicationStatus'}
+        '400': {description: Version required}
+  /api/release-consistency:
+    get:
+      operationId: getReleaseConsistency
+      summary: Compare Registry, Baseline, remote tag, Gitea API, listing, repository identity, and expected target
+      parameters:
+        - {in: query, name: version, required: true, schema: {type: string}}
+        - {in: query, name: target_oid, required: true, schema: {type: string, pattern: '^[0-9a-fA-F]{40}$'}}
+        - {in: query, name: evidence_closure_oid, required: true, schema: {type: string, pattern: '^[0-9a-fA-F]{40}$'}}
+        - {in: query, name: approval_plan_id, required: true, schema: {type: string}}
+      responses: {'200': {description: PASS, FAIL, or fail-closed UNKNOWN}}
+  /api/release-acceptance:
+    get:
+      operationId: runReleaseAcceptance
+      summary: Run read-only release acceptance; UNKNOWN is not accepted
+      parameters:
+        - {in: query, name: version, required: true, schema: {type: string}}
+        - {in: query, name: target_oid, required: true, schema: {type: string, pattern: '^[0-9a-fA-F]{40}$'}}
+        - {in: query, name: evidence_closure_oid, required: true, schema: {type: string, pattern: '^[0-9a-fA-F]{40}$'}}
+        - {in: query, name: approval_plan_id, required: true, schema: {type: string}}
+      responses: {'200': {description: Acceptance result with accepted boolean}}
  /api/tag:
    post:
      operationId: requestOrCreateTag
@@ -209,7 +409,7 @@ paths:
        content:
          application/json:
            schema: {$ref: '#/components/schemas/TagRequest'}
-      responses: {'200': {description: Tag request committed or tag created}, '403': {description: Forbidden}}
+      responses: {'200': {description: Gitea-confirmed tag and fail-closed baseline result}, '400': {description: Missing governance evidence or invalid OID}, '403': {description: Forbidden}, '409': {description: Existing tag target conflict or evidence lineage mismatch}, '502': {description: Gitea reconciliation required}, '503': {description: Remote push pending}}
      x-openai-isConsequential: true
  /api/rollback:
    post:
@@ -245,4 +445,7 @@ paths:
        content:
          application/json:
            schema: {$ref: '#/components/schemas/NLRequest'}
-      responses: {'
+      responses:
+        '200': {description: Safe GitOps plan}
+        '401': {description: Unauthorized}
+      x-openai-isConsequential: true
@@ -0,0 +1,56 @@
+# V2R1C1 中央 Baseline 治理收口
+
+## 收口范围
+
+本次变更只登记已经完成生产验证并上线的 `V2R1C1`。它新增中央版本 Manifest、把中央 Baseline Pointer 从 `V1R4C6` 切换为 `V2R1C1`，并建立 Release、Companion、Artifact 与最终生产 Evidence 的追溯关系。
+
+本次不修改产品实现，不移动或重建 `V2R1C1` Tag，不改变 Release OID，不重新部署生产，不切换生产流量，也不重写历史证据。
+
+## 权威标识
+
+- Release：`release/AIOS-V2R1C1-20260721`
+- Release OID：`4e0e6dcb90e6732aa9838fe9d0af0b34746829b0`
+- Tag / Tag OID：`V2R1C1` / `4e0e6dcb90e6732aa9838fe9d0af0b34746829b0`
+- SemVer：`2.1.0-rc.1`
+- OpenClaw Companion：`2.1.0-rc.4`
+- Companion Source OID：`83f8f878c7da5dd8263f2af2efa80750492e5cb3`
+- Companion OID：`12d1c13170e0c5a691d67a9408e739e7a17064a3`
+- Artifact SHA256：`aadd5f3cfa0d8e796a21f6368f5c95e8c60e9063d6e9fcd9c4947cfa0c013671`
+- Contract：`aios.openclaw.command.v2` / `Ed25519`
+- Evidence Root：`/var/lib/aios-gitops/acceptance/aios-v2r1c1-openclaw-v2-companion-20260721T094442Z`
+- Final Audit Manifest SHA256：`2cdb884abf195969de3cdaa44c76aaac52a9165fb4918436855291e46b2f8d55`
+- Production Status：`PRODUCTION_DEPLOYED`
+
+## 治理路径
+
+- Governance Branch：`patch/chatgpt/AIOS-V2R1C1-BASELINE-REGISTRY-20260721`
+- Base Ref：`refs/heads/main`
+- Base OID：`3cf9958cb94614449e093639cbf902216d73447f`
+- Manifest Commit：`a56caf46f6bc335ec2395b674ead4b2a427c5edd`
+- Baseline Commit：`6dbd5cbe07d2960ca653049fefbcf3a3e18f9ab1`
+- Reviewer：`gpt-5.3-codex-spark validator and docs_reporter`
+- Review：`PASS`（`2026-07-21T14:23:00Z`）
+
+## 命令与退出码
+
+| 阶段 | 命令 | 开始 UTC | 结束 UTC | Exit Code |
+| --- | --- | --- | --- | ---: |
+| 中央只读核对 | `GET /api/run; GET /api/base; GET /api/ver` | 2026-07-21T14:09:40Z | 2026-07-21T14:09:40Z | 0 |
+| 创建治理分支 | `bash /tmp/registry-create-branch.sh` | 2026-07-21T14:17:05Z | 2026-07-21T14:17:05Z | 0 |
+| 核心元数据验证 | `bash /tmp/registry-validate-core.sh` | 2026-07-21T14:19:56Z | 2026-07-21T14:19:56Z | 0 |
+
+完整机读记录位于 `.agent/results/releases/V2R1C1-BASELINE-CLOSURE.json`，治理运行证据位于 `/var/lib/aios-gitops/acceptance/aios-v2r1c1-baseline-registry-20260721T141705Z`。
+
+## 元数据回滚
+
+若中央 Registry 解析或治理服务异常，保留 `versions/V2R1C1.json`，通过新的受审治理提交把 `baseline/current.json` 和 `VERSION` 临时恢复到 `V1R4C6`。该操作不得回滚生产系统、移动 Tag、修改 Release OID 或重写历史。
+
+## 范围证明
+
+```text
+product_code_changed=false
+tag_changed=false
+production_redeployed=false
+production_traffic_changed=false
+secret_material_recorded=false
+```
@@ -0,0 +1,35 @@
+# V2R1C2 Production Release
+
+- Release Run ID: `AIOS-V2R1C2-PRODUCTION-20260722T011836Z`
+- Previous production baseline: `V2R1C1`
+- Tag: `V2R1C2`
+- Tag object: `a3bd84ebec9c705f7c9c5c03f7f4ec55f8854e36`
+- Approved target: `3dd622b5a515f1fa4ef72b9f8ae9ce48ac703f24`
+- Evidence closure: `8cdca463aff9707edee00e20a3b56884130f6978`
+- Initial registry status: `TAG_CREATED_NOT_PROMOTED`
+- Final status: `PRODUCTION_DEPLOYED`
+- Production service: `aios-v2r1c2-production.service`
+- Production port: `18920`
+- Production acceptance SHA256: `a6c35e12cab7907ab6bcfd37d781b3d216f05a5ae002aa54a3112c70f43b991a`
+- Production online smoke SHA256: `fe9c6964e440f8871f2eb225f0132f70c634923389f7b8dfa85f615b100980a4`
+- Production health SHA256: `ee8084e8b57d188dc0039a276f4f3f1ed7025ff58ce91b111cc765627eb52d4c`
+- Live evidence directory: `/var/lib/aios-gitops/acceptance/AIOS-V2R1C2-PRODUCTION-20260722T011836Z`
+- Evidence hash index: `/var/lib/aios-gitops/acceptance/AIOS-V2R1C2-PRODUCTION-20260722T011836Z/production-evidence.sha256`
+
+## Production gates
+
+Promotion may proceed only when the 18921 candidate remains healthy, the committed evidence checksum file verifies without drift, the 18920 baseline is healthy, required secret references are available without exposing secret values, and the V2R1C1 rollback service/configuration remains intact.
+
+The obsolete release-plan `DECLARED` rows are not authoritative for this run. The production gate must explicitly select `AIOS-V2R1C2-UNIFIED-PORTAL-TAKEOVER-20260722` and require its three required stages to be `SUCCEEDED`; an unqualified aggregate across stale plan rows fails closed.
+
+## Synthetic WeChat scope
+
+WeChat-facing acceptance for this release used synthetic/mock receipts and transcripts only. It did not impersonate a real user and does not claim a real-user WeChat session. The relevant committed evidence entries are `wechat_simulated_receipts` and `wechat_simulated_transcript`; the production online smoke also records `simulation: true` and `real_user_impersonated: false`.
+
+## Rollback rule
+
+If Health, API, UI, Role Matrix, Tenant Isolation, Runtime, or Audit verification fails after the 18920 switch, stop the V2R1C2 production unit and restart the preserved V2R1C1 18920 service. Do not delete or rewrite either release tag or rollback asset.
+
+## Result
+
+The production switch completed at `2026-07-22T01:40:51Z`. Full acceptance and the production online smoke passed, including Health, API, UI, Role Matrix, Tenant Isolation, Runtime, Audit and the selected takeover release gate. The previous `aios-orchestrator-gateway.service` unit, configuration and Release Run backup remain available for rollback.
@@ -1,47 +0,0 @@
-# TASK-AIOS-CONTROL-PLANE-GATEWAY-V1
-
-## Owner
-Codex
-
-## Goal
-建立 AIOS V2 唯一控制面 Gateway v1。
-
-## Architecture Boundary
-
-AIOS Control Plane:
- Tenant Registry
- Agent Registry
- Task Lifecycle
- Policy Gate
- Approval
- Audit Event
-
-不允许：
- OpenClaw 直接管理任务生命周期
- Hermes 直接暴露控制 API
- Web UI 绕过 AIOS API
-
-## Deliverables
-
-1. Control Plane API skeleton
-2. Tenant context middleware
-3. Task state machine
-4. Agent registration contract
-5. Audit event interface
-
-## Acceptance
-
- 所有 API 携带 tenant_id
- 未授权跨租户访问拒绝
- Task create/update/cancel 可审计
- GitOps commit 可追踪
- pytest + integration test 通过
-
-## Migration
-
-复用：
- Agent Router
- OpenClaw adapter
- Hermes runtime
-
-不重写执行层。
@@ -0,0 +1,153 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+
+VERSION=V2R1C2
+EXPECTED_TARGET=3dd622b5a515f1fa4ef72b9f8ae9ce48ac703f24
+TAG_OBJECT=a3bd84ebec9c705f7c9c5c03f7f4ec55f8854e36
+REPO=/data/aios-gitops/repo.git
+SOURCE=/opt/aios-v2r1c2
+TAKEOVER=/data/aios-gitops/worktrees/codex/AIOS-V2R1C2-UNIFIED-PORTAL-TAKEOVER-20260722
+CANDIDATE_SERVICE=aios-v2r1c2-portal.service
+OLD_SERVICE=aios-orchestrator-gateway.service
+NEW_SERVICE=aios-v2r1c2-production.service
+CANDIDATE_STATE=/var/lib/aios-v2r1c2-portal
+PRODUCTION_STATE=/var/lib/aios-v2r1c2-production
+RUN_ID=${AIOS_RELEASE_RUN_ID:-AIOS-V2R1C2-PRODUCTION-20260722T011836Z}
+EVIDENCE_DIR=/var/lib/aios-gitops/acceptance/$RUN_ID
+SCRIPT_DIR=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)
+RELEASE_ROOT=$(cd -- "$SCRIPT_DIR/../.." && pwd)
+UNIT_SOURCE=$RELEASE_ROOT/deploy/aios-v2/systemd/aios-v2r1c2-production.service
+ENV_SOURCE=$RELEASE_ROOT/deploy/aios-v2/systemd/aios-v2r1c2-production.env.example
+LOCK=/run/lock/aios-v2r1c2-production-release.lock
+
+require_root() {
+  test "$(id -u)" -eq 0 || { echo 'root required' >&2; exit 77; }
+}
+
+health_old() {
+  curl -fsS --max-time 10 http://127.0.0.1:18920/healthz
+}
+
+health_new() {
+  curl -fsS --max-time 10 http://127.0.0.1:18920/api/v2/health
+}
+
+health_candidate() {
+  curl -fsS --max-time 10 http://127.0.0.1:18921/api/v2/health
+}
+
+wait_candidate() {
+  for _ in $(seq 1 30); do
+    if health_candidate; then
+      return 0
+    fi
+    sleep 1
+  done
+  return 1
+}
+
+preflight() {
+  require_root
+  test "$(git --git-dir="$REPO" rev-parse refs/tags/$VERSION)" = "$TAG_OBJECT"
+  test "$(git --git-dir="$REPO" rev-list -n 1 "$VERSION")" = "$EXPECTED_TARGET"
+  test -f "$SOURCE/active-runtime/app/aios_web/release_application.py"
+  test -f "$UNIT_SOURCE"
+  test -f "$ENV_SOURCE"
+  command -v sqlite3 >/dev/null
+  systemctl is-active --quiet "$CANDIDATE_SERVICE"
+  systemctl is-active --quiet "$OLD_SERVICE"
+  health_candidate >/dev/null
+  health_old >/dev/null
+  (
+    cd "$TAKEOVER/artifacts/v2r1c2"
+    sha256sum -c checksums.sha256 >/dev/null
+  )
+  diff -qr --exclude=__pycache__ "$TAKEOVER/active-runtime/app" "$SOURCE/active-runtime/app" >/dev/null
+  diff -qr "$TAKEOVER/plans" "$SOURCE/plans" >/dev/null
+  echo PREFLIGHT=PASS
+}
+
+prepare() {
+  preflight
+  install -d -m 0750 "$EVIDENCE_DIR" "$EVIDENCE_DIR/backup"
+  health_old >"$EVIDENCE_DIR/production-health-before.json"
+  health_candidate >"$EVIDENCE_DIR/candidate-health-before.json"
+  systemctl cat "$OLD_SERVICE" >"$EVIDENCE_DIR/backup/$OLD_SERVICE.unit"
+  cp -a /etc/aios-orchestrator-gateway "$EVIDENCE_DIR/backup/"
+  cp -a /etc/systemd/system/aios-orchestrator-gateway.service "$EVIDENCE_DIR/backup/"
+  if test -e "$PRODUCTION_STATE"; then
+    mv "$PRODUCTION_STATE" "$EVIDENCE_DIR/backup/aios-v2r1c2-production-state.preexisting"
+  fi
+  systemctl stop "$CANDIDATE_SERVICE"
+  trap 'systemctl start "$CANDIDATE_SERVICE" || true' EXIT
+  while IFS= read -r -d '' database; do
+    sqlite3 "$database" 'PRAGMA wal_checkpoint(TRUNCATE);' >/dev/null
+    test "$(sqlite3 "$database" 'PRAGMA quick_check;')" = ok
+  done < <(find "$CANDIDATE_STATE" -maxdepth 1 -type f -name '*.sqlite3' -print0)
+  install -d -o aios -g aios -m 0750 "$PRODUCTION_STATE"
+  cp -a "$CANDIDATE_STATE/." "$PRODUCTION_STATE/"
+  chown -R aios:aios "$PRODUCTION_STATE"
+  while IFS= read -r -d '' database; do
+    test "$(sqlite3 "$database" 'PRAGMA quick_check;')" = ok
+  done < <(find "$PRODUCTION_STATE" -maxdepth 1 -type f -name '*.sqlite3' -print0)
+  install -o root -g root -m 0644 "$UNIT_SOURCE" /etc/systemd/system/aios-v2r1c2-production.service
+  install -d -o root -g aios -m 0750 /etc/aios-v2
+  install -o root -g aios -m 0640 "$ENV_SOURCE" /etc/aios-v2/aios-v2r1c2-production.env
+  systemctl daemon-reload
+  systemctl start "$CANDIDATE_SERVICE"
+  wait_candidate >"$EVIDENCE_DIR/candidate-health-after-state-copy.json"
+  trap - EXIT
+  echo PREPARE=PASS
+}
+
+rollback() {
+  require_root
+  systemctl stop "$NEW_SERVICE" || true
+  systemctl disable "$NEW_SERVICE" >/dev/null 2>&1 || true
+  systemctl enable "$OLD_SERVICE" >/dev/null 2>&1 || true
+  systemctl start "$OLD_SERVICE"
+  health_old >"$EVIDENCE_DIR/rollback-health.json"
+  echo ROLLBACK=PASS
+}
+
+promote() {
+  require_root
+  test -f /etc/systemd/system/aios-v2r1c2-production.service
+  test -f /etc/aios-v2/aios-v2r1c2-production.env
+  ! systemctl is-active --quiet "$NEW_SERVICE"
+  systemctl is-active --quiet "$CANDIDATE_SERVICE"
+  health_candidate >/dev/null
+  health_old >"$EVIDENCE_DIR/production-health-switch-input.json"
+  trap 'trap - ERR; rollback' ERR
+  systemctl stop "$OLD_SERVICE"
+  systemctl start "$NEW_SERVICE"
+  for _ in $(seq 1 30); do
+    if health_new >"$EVIDENCE_DIR/production-health-after-switch.json" 2>/dev/null; then
+      echo PROMOTE=PASS
+      trap - ERR
+      return 0
+    fi
+    sleep 1
+  done
+  return 1
+}
+
+finalize() {
+  require_root
+  systemctl is-active --quiet "$NEW_SERVICE"
+  health_new >"$EVIDENCE_DIR/production-health-final.json"
+  systemctl disable "$OLD_SERVICE" >/dev/null
+  systemctl enable "$NEW_SERVICE" >/dev/null
+  echo FINALIZE=PASS
+}
+
+exec 9>"$LOCK"
+flock -n 9 || { echo 'release operation already running' >&2; exit 75; }
+case "${1:-}" in
+  preflight) preflight ;;
+  prepare) prepare ;;
+  promote) promote ;;
+  rollback) rollback ;;
+  finalize) finalize ;;
+  *) echo "usage: $0 {preflight|prepare|promote|rollback|finalize}" >&2; exit 64 ;;
+esac
@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+
+RUN_ID=AIOS-V2R1C2-PRODUCTION-20260722T011836Z
+CONTROL=/data/aios-gitops/worktrees/controller/ops/aios-v2/v2r1c2-production-control.sh
+REPO=/data/aios-gitops/repo.git
+EVIDENCE_DIR=/var/lib/aios-gitops/acceptance/$RUN_ID
+DRIVER=/data/aios-gitops/worktrees/controller/tools/run_online_smoke_18920.py
+TEMP_SOURCE=
+
+cleanup_temp() {
+  case "$TEMP_SOURCE" in
+    /tmp/aios-v2r1c2-production-acceptance.*)
+      test -d "$TEMP_SOURCE" && rm -rf -- "$TEMP_SOURCE"
+      ;;
+    '') ;;
+    *) echo "refusing to remove unexpected temporary path: $TEMP_SOURCE" >&2; return 1 ;;
+  esac
+}
+
+rollback_on_error() {
+  code=$?
+  trap - ERR
+  AIOS_RELEASE_RUN_ID="$RUN_ID" "$CONTROL" rollback || true
+  cleanup_temp || true
+  exit "$code"
+}
+trap rollback_on_error ERR
+
+AIOS_RELEASE_RUN_ID="$RUN_ID" "$CONTROL" promote
+systemctl is-active --quiet aios-v2r1c2-production.service
+! systemctl is-active --quiet aios-orchestrator-gateway.service
+curl -fsS --max-time 10 http://127.0.0.1:18920/api/v2/health >"$EVIDENCE_DIR/health-after-promote.json"
+curl -fsS --max-time 10 http://127.0.0.1:18921/api/v2/health >"$EVIDENCE_DIR/candidate-health-during-production.json"
+
+TEMP_SOURCE=$(mktemp -d /tmp/aios-v2r1c2-production-acceptance.XXXXXX)
+git --git-dir="$REPO" archive 8cdca463aff9707edee00e20a3b56884130f6978 | tar -x -C "$TEMP_SOURCE"
+(
+  cd "$TEMP_SOURCE"
+  python3 tools/aios_v2r1c2_acceptance.py \
+    --source-oid 3dd622b5a515f1fa4ef72b9f8ae9ce48ac703f24 \
+    --online \
+    --base-url http://127.0.0.1:18920 \
+    --evidence-output "$EVIDENCE_DIR/production-acceptance.json"
+)
+python3 "$DRIVER" "$TEMP_SOURCE" "$EVIDENCE_DIR/production-online-smoke.json"
+
+python3 - "$EVIDENCE_DIR/production-acceptance.json" "$EVIDENCE_DIR/production-online-smoke.json" <<'PY'
+import json
+import sys
+for path in sys.argv[1:]:
+    with open(path, encoding='utf-8') as handle:
+        data = json.load(handle)
+    if data.get('passed') is not True:
+        raise SystemExit(f'acceptance failed: {path}')
+PY
+
+systemctl show aios-v2r1c2-production.service \
+  -p ActiveState -p SubState -p MainPID -p NRestarts \
+  >"$EVIDENCE_DIR/production-service-status.txt"
+sha256sum "$EVIDENCE_DIR"/production-acceptance.json \
+  "$EVIDENCE_DIR"/production-online-smoke.json \
+  "$EVIDENCE_DIR"/health-after-promote.json \
+  >"$EVIDENCE_DIR/production-evidence.sha256"
+
+cleanup_temp
+TEMP_SOURCE=
+trap - ERR
+echo SWITCH_VALIDATED=PASS
@@ -0,0 +1,15 @@
+{
+  "patch_name": "gitea-tag-publication-atomicity",
+  "branch": "patch/gitea-tag-publication-atomicity-20260723",
+  "base": "main",
+  "risk": "high",
+  "description": "Fail-closed, resumable Gitea release-tag publication with exact remote ref, peeled target, API and listing verification before baseline update.",
+  "owner_approval": "received",
+  "constraints": {
+    "force_push": false,
+    "tag_rewrite": false,
+    "direct_main_push": false,
+    "secret_commit": false,
+    "production_runtime_anchor_change": false
+  }
+}
@@ -0,0 +1,9 @@
+{
+  "id": "patch-1784043007770-e97206c3",
+  "patch_name": "gitops-isolated-worktree-governance-20260714T232948UTC8",
+  "branch": "patch/gitops-isolated-worktree-governance-20260714T232948UTC8",
+  "risk": "high",
+  "description": "Root-cause remediation for recurring ACL and shared-worktree failures: unified aiman:gitops runtime identity, UMask=0002, inherited default ACLs, per-task isolated Git worktrees, startup preflight, migration/rollback scripts, systemd drop-in templates, audit evidence, and an OpenClaw execution task. No production business deployment in this patch.",
+  "created_by": "chatgpt-gitops-bot",
+  "created_at": "2026-07-14T15:30:07Z"
+}
@@ -1,9 +0,0 @@
-{
-  "type": "branch",
-  "branch": "integration/aios-v2r1-cto-production-candidate-20260720",
-  "base": "task/codex/AIOS-V2-CONTROL-PLANE-GATEWAY-V1-20260720",
-  "created_by": "chatgpt-gitops-bot",
-  "created_at": "2026-07-20T01:47:01Z",
-  "direct_main_push": false,
-  "owner_approval_required": true
-}
@@ -0,0 +1,10 @@
+{
+  "id": "nl-1784681185786-19ac0f82",
+  "text": "Create a safe GitOps plan for tag V2R1C2. The tag target must be commit 3dd622b5a515f1fa4ef72b9f8ae9ce48ac703f24. Evidence closure commit is 8cdca463aff9707edee00e20a3b56884130f6978. Do not tag the current workspace HEAD. Do not modify main. Do not force push. Do not promote production. If the target commit cannot be bound explicitly, keep the operation blocked.",
+  "intent": "unknown",
+  "action_plan": [],
+  "execute": false,
+  "owner_approval_required": true,
+  "created_by": "chatgpt-gitops-bot",
+  "created_at": "2026-07-22T00:46:25Z"
+}
@@ -0,0 +1,9 @@
+{
+  "type": "branch",
+  "branch": "patch/gitea-tag-publication-atomicity-20260723",
+  "base": "main",
+  "created_by": "owner-gitea-tag-atomicity-20260723",
+  "created_at": "2026-07-23T04:59:13Z",
+  "direct_main_push": false,
+  "owner_approval_required": true
+}
@@ -1,9 +0,0 @@
-{
-  "type": "branch",
-  "branch": "task/codex/AIOS-V2-CONTROL-PLANE-GATEWAY-V1-20260720",
-  "base": "main",
-  "created_by": "chatgpt-gitops-bot",
-  "created_at": "2026-07-19T17:06:04Z",
-  "direct_main_push": false,
-  "owner_approval_required": true
-}
@@ -0,0 +1,9 @@
+{
+  "type": "branch",
+  "branch": "task/codex/gitops-isolated-worktree-migration-20260715T001652UTC8",
+  "base": "patch/gitops-isolated-worktree-governance-20260714T232948UTC8",
+  "created_by": "chatgpt-gitops-bot",
+  "created_at": "2026-07-14T16:17:28Z",
+  "direct_main_push": false,
+  "owner_approval_required": true
+}
@@ -1,9 +0,0 @@
-{
-  "type": "branch",
-  "branch": "task/openclaw/AIOS-V2R1-PRODUCTION-DEPLOY-20260720",
-  "base": "integration/aios-v2r1-cto-production-candidate-20260720",
-  "created_by": "chatgpt-gitops-bot",
-  "created_at": "2026-07-20T03:49:09Z",
-  "direct_main_push": false,
-  "owner_approval_required": true
-}
@@ -0,0 +1,43 @@
+{
+  "base": "main",
+  "base_oid": "b739fbb5ec8f7096d2f5ade87f65a7c74b0ee870",
+  "commit_count": 10,
+  "commits": [
+    "fc0b9f29bf6dadfbcc8599da6f0ab11a6e19b529",
+    "3812e1ab0123c7da4726e51179a10746b5bbde83",
+    "3196d91b12d0ac5d7ea550b0474703a08736471b",
+    "54093d15437ce0af31acf6feeeffacf6626a59cd",
+    "27a0ae126b96d63c40544174e7a3859e30eba056",
+    "83ab67f7e11eae9da4546cab53169f5a6a47e0ae",
+    "f4b6ac8609faf947d2659b2c32564a26fcb3eb10",
+    "a3edc628a91a4af3d702aacefe0389f844615bc1",
+    "e40c05779c435c3726618de81e02e90953d727f3",
+    "edfad05d57fb3d23d8ab19d27bb6a43a7f2a298f"
+  ],
+  "file_count": 15,
+  "files": [
+    "active-runtime/app/aios_chatgpt_actions_api.py",
+    "active-runtime/app/aios_gitops_write_guard.py",
+    "active-runtime/app/gitea_tag_publication.py",
+    "docs/gitops/gitea-tag-publication-atomicity.md",
+    "docs/gitops/openapi-chatgpt-actions.yaml",
+    "patches/gitea-tag-publication-atomicity-20260723.json",
+    "patches/patch_gitea-tag-publication-atomicity-20260723.branch.json",
+    "scripts/generate_delivery_manifest.py",
+    "scripts/release_version.sh",
+    "scripts/verify_gitea_credential_rotation.py",
+    "security/incidents/GITEA-TOKEN-33-EXPOSURE-20260723.redacted.json",
+    "tests/run_live_gitea_fixture.sh",
+    "tests/test_chatgpt_actions_tag.py",
+    "tests/test_gitea_tag_publication.py",
+    "tests/test_gitea_tag_publication_live.py"
+  ],
+  "generated_from": {
+    "commit_range": "b739fbb5ec8f7096d2f5ade87f65a7c74b0ee870..edfad05d57fb3d23d8ab19d27bb6a43a7f2a298f",
+    "commits_command": "git log --reverse --format=%H b739fbb5ec8f7096d2f5ade87f65a7c74b0ee870..edfad05d57fb3d23d8ab19d27bb6a43a7f2a298f",
+    "files_command": "git diff --name-only b739fbb5ec8f7096d2f5ade87f65a7c74b0ee870..edfad05d57fb3d23d8ab19d27bb6a43a7f2a298f"
+  },
+  "manifest_path": "reports/gitea-tag-publication-atomicity-delivery.json",
+  "source_branch": "patch/gitea-tag-publication-atomicity-20260723",
+  "source_commit": "edfad05d57fb3d23d8ab19d27bb6a43a7f2a298f"
+}
@@ -0,0 +1,69 @@
+#!/usr/bin/env python3
+"""Generate the delivery file list from Git instead of hand-maintained counts."""
+from __future__ import annotations
+
+import argparse
+import json
+import subprocess
+from pathlib import Path
+
+
+def git(root: Path, *args: str) -> list[str]:
+    output = subprocess.check_output(
+        ["git", *args], cwd=root, text=True, encoding="utf-8"
+    )
+    return [line for line in output.splitlines() if line]
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--base", default="main")
+    parser.add_argument(
+        "--output",
+        default="reports/gitea-tag-publication-atomicity-delivery.json",
+    )
+    args = parser.parse_args()
+    root = Path(
+        subprocess.check_output(
+            ["git", "rev-parse", "--show-toplevel"], text=True, encoding="utf-8"
+        ).strip()
+    )
+    output = Path(args.output)
+    if output.is_absolute() or ".." in output.parts:
+        raise SystemExit("output must remain inside the repository")
+    output_path = root / output
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+    base_oid = git(root, "rev-parse", "--verify", f"{args.base}^{{commit}}")[0]
+    source_commit = git(root, "rev-parse", "--verify", "HEAD^{commit}")[0]
+    source_branch = git(root, "symbolic-ref", "--short", "HEAD")[0]
+    commit_range = f"{base_oid}..{source_commit}"
+    commits = git(root, "log", "--reverse", "--format=%H", commit_range)
+    files = [
+        path
+        for path in git(root, "diff", "--name-only", commit_range)
+        if path != output.as_posix()
+    ]
+    payload = {
+        "base": args.base,
+        "base_oid": base_oid,
+        "source_branch": source_branch,
+        "source_commit": source_commit,
+        "commit_count": len(commits),
+        "commits": commits,
+        "file_count": len(files),
+        "files": files,
+        "manifest_path": output.as_posix(),
+        "generated_from": {
+            "commit_range": commit_range,
+            "files_command": f"git diff --name-only {commit_range}",
+            "commits_command": f"git log --reverse --format=%H {commit_range}",
+        },
+    }
+    output_path.write_text(
+        json.dumps(payload, indent=2, sort_keys=True) + "\n", encoding="utf-8"
+    )
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())
@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT="${AIOS_GITOPS_ROOT:-/data/aios-gitops}"
+SOURCE="${AIOS_SOURCE_WORKTREE:-$ROOT/workspace}"
+BARE="${AIOS_BARE_REPO:-$ROOT/repo.git}"
+WORKTREES="${AIOS_WORKTREE_ROOT:-$ROOT/worktrees}"
+RUNTIME_USER="${AIOS_RUNTIME_USER:-aiman}"
+RUNTIME_GROUP="${AIOS_RUNTIME_GROUP:-gitops}"
+
+if [[ "$(id -u)" -ne 0 ]]; then
+  echo "ERROR: bootstrap must run as root" >&2
+  exit 2
+fi
+
+getent passwd "$RUNTIME_USER" >/dev/null
+getent group "$RUNTIME_GROUP" >/dev/null
+[[ -d "$SOURCE/.git" || -f "$SOURCE/.git" ]] || {
+  echo "ERROR: source worktree not found: $SOURCE" >&2
+  exit 3
+}
+
+install -d -o "$RUNTIME_USER" -g "$RUNTIME_GROUP" -m 2775 "$ROOT" "$WORKTREES"
+install -d -o "$RUNTIME_USER" -g "$RUNTIME_GROUP" -m 2775 \
+  "$WORKTREES/openclaw" "$WORKTREES/chatgpt" "$WORKTREES/controller"
+
+if [[ ! -d "$BARE" ]]; then
+  sudo -u "$RUNTIME_USER" -g "$RUNTIME_GROUP" git clone --bare "$SOURCE" "$BARE"
+fi
+
+chown -R "$RUNTIME_USER:$RUNTIME_GROUP" "$BARE" "$WORKTREES"
+find "$BARE" "$WORKTREES" -type d -exec chmod 2775 {} +
+find "$BARE" "$WORKTREES" -type f -exec chmod ug+rw {} +
+
+setfacl -R -m "u:${RUNTIME_USER}:rwX,g:${RUNTIME_GROUP}:rwX,m::rwX" "$BARE" "$WORKTREES"
+find "$BARE" "$WORKTREES" -type d -exec \
+  setfacl -m "d:u:${RUNTIME_USER}:rwx,d:g:${RUNTIME_GROUP}:rwx,d:m::rwx" {} +
+
+cat <<EOF
+bootstrap_status: PASS
+root: $ROOT
+source_worktree: $SOURCE
+bare_repo: $BARE
+worktree_root: $WORKTREES
+runtime_user: $RUNTIME_USER
+runtime_group: $RUNTIME_GROUP
+EOF
@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+EXPECTED_USER="${AIOS_RUNTIME_USER:-aiman}"
+EXPECTED_GROUP="${AIOS_RUNTIME_GROUP:-gitops}"
+EXPECTED_UMASK="${AIOS_RUNTIME_UMASK:-0002}"
+TASK_DIR="${AIOS_TASK_DIR:-.agent/tasks}"
+RESULT_DIR="${AIOS_RESULT_DIR:-.agent/results}"
+
+fail() {
+  echo "preflight_status: FAIL"
+  echo "reason: $1"
+  exit 1
+}
+
+USER_NOW="$(id -un)"
+GROUPS_NOW="$(id -Gn)"
+UMASK_NOW="$(umask)"
+ROOT="$(git rev-parse --show-toplevel 2>/dev/null || true)"
+GIT_DIR="$(git rev-parse --git-dir 2>/dev/null || true)"
+BRANCH="$(git branch --show-current 2>/dev/null || true)"
+
+[[ "$USER_NOW" == "$EXPECTED_USER" ]] || fail "runtime user is $USER_NOW, expected $EXPECTED_USER"
+[[ " $GROUPS_NOW " == *" $EXPECTED_GROUP "* ]] || fail "runtime user is not in $EXPECTED_GROUP"
+[[ "$UMASK_NOW" == "$EXPECTED_UMASK" || "$UMASK_NOW" == "002" ]] || fail "umask is $UMASK_NOW, expected $EXPECTED_UMASK"
+[[ -n "$ROOT" ]] || fail "not inside a git worktree"
+[[ "$ROOT" == /data/aios-gitops/worktrees/* ]] || fail "shared source worktree is prohibited: $ROOT"
+[[ -w "$ROOT" ]] || fail "worktree root is not writable"
+[[ -w "$GIT_DIR" ]] || fail "git dir is not writable: $GIT_DIR"
+[[ ! -e "$GIT_DIR/index.lock" ]] || fail "git index lock exists"
+install -d -m 2775 "$TASK_DIR" "$RESULT_DIR"
+[[ -w "$TASK_DIR" ]] || fail "task directory is not writable: $TASK_DIR"
+[[ -w "$RESULT_DIR" ]] || fail "result directory is not writable: $RESULT_DIR"
+[[ -z "$(git status --porcelain)" ]] || fail "worktree is not clean at task start"
+
+cat <<EOF
+preflight_status: PASS
+runtime_user: $USER_NOW
+runtime_groups: $GROUPS_NOW
+umask: $UMASK_NOW
+worktree: $ROOT
+git_dir: $GIT_DIR
+branch: $BRANCH
+workspace_clean: true
+task_path_writable: true
+result_path_writable: true
+git_lock_present: false
+EOF
@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ACTION="${1:-}"
+AGENT="${2:-}"
+TASK_ID="${3:-}"
+BASE_REF="${4:-origin/main}"
+
+ROOT="${AIOS_GITOPS_ROOT:-/data/aios-gitops}"
+BARE="${AIOS_BARE_REPO:-$ROOT/repo.git}"
+WORKTREES="${AIOS_WORKTREE_ROOT:-$ROOT/worktrees}"
+RUNTIME_USER="${AIOS_RUNTIME_USER:-aiman}"
+RUNTIME_GROUP="${AIOS_RUNTIME_GROUP:-gitops}"
+
+usage() {
+  echo "usage: $0 create|remove <openclaw|chatgpt|controller> <task-id> [base-ref]" >&2
+  exit 64
+}
+
+[[ "$ACTION" =~ ^(create|remove)$ ]] || usage
+[[ "$AGENT" =~ ^(openclaw|chatgpt|controller)$ ]] || usage
+[[ "$TASK_ID" =~ ^[A-Za-z0-9._-]+$ ]] || {
+  echo "ERROR: invalid task id" >&2
+  exit 65
+}
+[[ "$(id -un)" == "$RUNTIME_USER" ]] || {
+  echo "ERROR: must run as $RUNTIME_USER" >&2
+  exit 66
+}
+[[ "$(id -gn)" == "$RUNTIME_GROUP" || " $(id -Gn) " == *" $RUNTIME_GROUP "* ]] || {
+  echo "ERROR: user must be in $RUNTIME_GROUP" >&2
+  exit 67
+}
+[[ "$(umask)" == "0002" || "$(umask)" == "002" ]] || {
+  echo "ERROR: umask must be 0002" >&2
+  exit 68
+}
+[[ -d "$BARE" ]] || {
+  echo "ERROR: bare repository missing: $BARE" >&2
+  exit 69
+}
+
+PATHNAME="$WORKTREES/$AGENT/$TASK_ID"
+BRANCH="task/$AGENT/$TASK_ID"
+
+case "$ACTION" in
+  create)
+    [[ ! -e "$PATHNAME" ]] || {
+      echo "ERROR: worktree already exists: $PATHNAME" >&2
+      exit 70
+    }
+    git --git-dir="$BARE" fetch --all --prune
+    git --git-dir="$BARE" worktree add -b "$BRANCH" "$PATHNAME" "$BASE_REF"
+    install -d -m 2775 "$PATHNAME/.agent/tasks/$AGENT" "$PATHNAME/.agent/results/$AGENT"
+    setfacl -m "u:${RUNTIME_USER}:rwx,g:${RUNTIME_GROUP}:rwx,m::rwx" "$PATHNAME"
+    find "$PATHNAME" -type d -exec chmod g+s {} +
+    find "$PATHNAME" -type d -exec \
+      setfacl -m "d:u:${RUNTIME_USER}:rwx,d:g:${RUNTIME_GROUP}:rwx,d:m::rwx" {} +
+    printf 'worktree: %s\nbranch: %s\nbase: %s\n' "$PATHNAME" "$BRANCH" "$BASE_REF"
+    ;;
+  remove)
+    [[ -d "$PATHNAME" ]] || {
+      echo "ERROR: worktree not found: $PATHNAME" >&2
+      exit 71
+    }
+    [[ -z "$(git -C "$PATHNAME" status --porcelain)" ]] || {
+      echo "ERROR: worktree is not clean; retain for investigation" >&2
+      exit 72
+    }
+    git --git-dir="$BARE" worktree remove "$PATHNAME"
+    printf 'removed: %s\n' "$PATHNAME"
+    ;;
+esac
@@ -1,23 +1,53 @@
 #!/usr/bin/env bash
-set -euo pipefail
-VERSION="${1:?version required, e.g. V1R1C0}"
-MESSAGE="${2:-release $VERSION}"
-if ! echo "$VERSION" | grep -Eq '^V[0-9]+R[0-9]+C[0-9]+$'; then echo "ERROR: version must match VxRxCx"; exit 1; fi
-cd "${AIOS_GITOPS_WORKSPACE:-/data/aios-gitops/workspace}"
-git checkout main
-git pull origin main || true
-git tag -a "$VERSION" -m "$MESSAGE" || true
-git push origin "$VERSION" || true
-python3 - <<PY
-import json, datetime
-from pathlib import Path
-p=Path('baseline/current.json')
-if p.exists(): d=json.loads(p.read_text())
-else: p.parent.mkdir(exist_ok=True); d={}
-d['active_version']='$VERSION'; d['active_tag']='$VERSION'; d['updated_at']=datetime.datetime.now(datetime.UTC).isoformat(); d['update_mode']='git_patch_only'
-p.write_text(json.dumps(d, ensure_ascii=False, indent=2))
-PY
-git add baseline/current.json || true
-git commit -m "release($VERSION): update active baseline" || true
-git push origin main || true
-echo "RELEASE_DONE $VERSION"
+set -Eeuo pipefail
+
+VERSION="${1:?version required, e.g. V2R1C4}"
+TARGET_OID="${2:?target_oid required}"
+EVIDENCE_CLOSURE_OID="${3:?evidence_closure_oid required}"
+APPROVAL_PLAN_ID="${4:?approval_plan_id required}"
+WORKSPACE="${AIOS_GITOPS_WORKSPACE:-/data/aios-gitops/workspace}"
+TAG_REMOTE="${AIOS_GITOPS_GITEA_REMOTE:-gitea}"
+BRANCH_REMOTE="${AIOS_GITOPS_BRANCH_REMOTE:-gitea}"
+
+case "$VERSION" in
+  V[0-9]*R[0-9]*C[0-9]*) ;;
+  *) echo "ERROR: version must match VxRxCx" >&2; exit 64 ;;
+esac
+
+for value in "$TARGET_OID" "$EVIDENCE_CLOSURE_OID"; do
+  [[ "$value" =~ ^[0-9a-f]{40}$ ]] || {
+    echo "ERROR: target and evidence OIDs must be full lowercase 40-character OIDs" >&2
+    exit 64
+  }
+done
+
+[[ -n "$APPROVAL_PLAN_ID" ]] || {
+  echo "ERROR: approval_plan_id is required" >&2
+  exit 64
+}
+
+cd "$WORKSPACE"
+BRANCH="$(git symbolic-ref --quiet --short HEAD)" || {
+  echo "ERROR: release must run on an isolated branch, not detached HEAD" >&2
+  exit 65
+}
+case "$BRANCH" in
+  main|master) echo "ERROR: direct main/master release writes are forbidden" >&2; exit 65 ;;
+esac
+
+python3 "$WORKSPACE/active-runtime/app/gitea_tag_publication.py" publish \
+  --workspace "$WORKSPACE" \
+  --remote "$TAG_REMOTE" \
+  --version "$VERSION" \
+  --target-oid "$TARGET_OID" \
+  --evidence-closure-oid "$EVIDENCE_CLOSURE_OID" \
+  --approval-plan-id "$APPROVAL_PLAN_ID"
+
+git add -- "baseline/current.json" "versions/$VERSION.json"
+if ! git diff --cached --quiet; then
+  git commit -m "release($VERSION): record Gitea-confirmed baseline"
+fi
+
+# No force, no main push, and no ignored failure.
+git push "$BRANCH_REMOTE" "HEAD:refs/heads/$BRANCH"
+echo "RELEASE_BASELINE_UPDATED $VERSION branch=$BRANCH"
@@ -0,0 +1,152 @@
+#!/usr/bin/env python3
+"""Verify a Gitea credential rotation without printing either credential."""
+from __future__ import annotations
+
+import argparse
+import json
+import subprocess
+import urllib.error
+import urllib.parse
+import urllib.request
+from pathlib import Path
+
+
+def token_at(path: Path, line: int) -> str:
+    lines = path.read_text(encoding="utf-8").splitlines()
+    if line < 1 or line > len(lines) or not lines[line - 1].strip():
+        raise RuntimeError("credential reference has no configured token line")
+    return lines[line - 1].strip()
+
+
+def get(api: str, path: str, token: str) -> tuple[int, object | None]:
+    request = urllib.request.Request(
+        api.rstrip("/") + path,
+        headers={
+            "Accept": "application/json",
+            "Authorization": f"token {token}",
+            "User-Agent": "aios-gitops-credential-rotation-verifier/1",
+        },
+    )
+    try:
+        with urllib.request.urlopen(request, timeout=15) as response:
+            return response.status, json.loads(response.read().decode("utf-8"))
+    except urllib.error.HTTPError as exc:
+        return exc.code, None
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--old-token-file", type=Path, required=True)
+    parser.add_argument("--new-credential-file", type=Path, required=True)
+    parser.add_argument("--new-token-line", type=int, default=2)
+    parser.add_argument("--api", default="http://127.0.0.1:3000/api/v1")
+    parser.add_argument("--repository", default="aios/aios")
+    parser.add_argument("--version", default="V2R1C2")
+    parser.add_argument("--workspace", type=Path, required=True)
+    parser.add_argument("--remote", default="http://127.0.0.1:3000/aios/aios.git")
+    parser.add_argument(
+        "--branch",
+        default="patch/gitea-tag-publication-atomicity-20260723",
+    )
+    args = parser.parse_args()
+    old_token = token_at(args.old_token_file, 1)
+    new_token = token_at(args.new_credential_file, args.new_token_line)
+    repo_path = f"/repos/{args.repository}"
+    old_status, _ = get(args.api, repo_path, old_token)
+    new_status, _ = get(args.api, repo_path, new_token)
+    encoded = urllib.parse.quote(args.version, safe="")
+    ref_status, ref = get(
+        args.api,
+        f"{repo_path}/git/refs/tags/{encoded}",
+        new_token,
+    )
+    listing_status, listing = get(
+        args.api,
+        f"{repo_path}/tags?limit=50&page=1",
+        new_token,
+    )
+    refs = ref if isinstance(ref, list) else [ref]
+    exact = [
+        item
+        for item in refs
+        if isinstance(item, dict)
+        and item.get("ref") in {
+            f"refs/tags/{args.version}",
+            f"tags/{args.version}",
+        }
+    ]
+    tag_oid = (
+        str(((exact[0].get("object") or {}).get("sha")) or "").lower()
+        if len(exact) == 1
+        else None
+    )
+    tag_status, tag = (
+        get(args.api, f"{repo_path}/git/tags/{tag_oid}", new_token)
+        if tag_oid
+        else (0, None)
+    )
+    peeled_target = (
+        str(((tag.get("object") or {}).get("sha")) or "").lower()
+        if isinstance(tag, dict)
+        else None
+    )
+    listing_target = None
+    if isinstance(listing, list):
+        for item in listing:
+            if item.get("name") == args.version:
+                listing_target = str(
+                    ((item.get("commit") or {}).get("sha")) or ""
+                ).lower()
+                break
+    remote = subprocess.run(
+        [
+            "git",
+            "-c",
+            f"safe.directory={args.workspace}",
+            "-c",
+            "credential.helper=!/usr/local/libexec/aios-gitea-credential",
+            "-c",
+            "credential.useHttpPath=true",
+            "-C",
+            str(args.workspace),
+            "ls-remote",
+            args.remote,
+            f"refs/heads/{args.branch}",
+        ],
+        text=True,
+        capture_output=True,
+    )
+    remote_oid = (
+        remote.stdout.split()[0].lower()
+        if remote.returncode == 0 and remote.stdout.split()
+        else None
+    )
+    result = {
+        "old_token_repository_http": old_status,
+        "new_token_repository_http": new_status,
+        "git_ls_remote_oid": remote_oid,
+        "gitea_ref_http": ref_status,
+        "gitea_tag_oid": tag_oid,
+        "gitea_tag_object_http": tag_status,
+        "gitea_peeled_target_oid": peeled_target,
+        "gitea_listing_http": listing_status,
+        "gitea_listing_target_oid": listing_target,
+        "credentials_printed": False,
+    }
+    print(json.dumps(result, indent=2, sort_keys=True))
+    passed = (
+        old_status in {401, 403}
+        and new_status == 200
+        and remote_oid is not None
+        and ref_status == 200
+        and tag_oid is not None
+        and tag_status == 200
+        and peeled_target is not None
+        and listing_status == 200
+        and listing_target is not None
+    )
+    return 0 if passed else 2
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())
@@ -0,0 +1,38 @@
+{
+  "exposure_window": {
+    "detected_at": "2026-07-23T13:40:23+08:00",
+    "revoked_at": "2026-07-23T13:40:56+08:00",
+    "start": "2026-07-23T12:00:00+08:00",
+    "start_accuracy": "bounded approximation; precise platform tool-log timestamp unavailable"
+  },
+  "gitea_tag_read_validation": {
+    "listing_target_oid": "3dd622b5a515f1fa4ef72b9f8ae9ce48ac703f24",
+    "peeled_target_oid": "3dd622b5a515f1fa4ef72b9f8ae9ce48ac703f24",
+    "tag_mutation_performed": false,
+    "tag_oid": "a3bd84ebec9c705f7c9c5c03f7f4ec55f8854e36",
+    "version": "V2R1C2"
+  },
+  "impact_scope": "Gitea repository write access for gitops-bot; no evidence of unauthorized use observed during rotation checks",
+  "incident_id": "GITEA-TOKEN-33-EXPOSURE-20260723",
+  "log_handling": {
+    "credential_values_in_record": false,
+    "reason": "formal audit/tool logs must not be deleted",
+    "server_redacted_record_mode": "0640 root:gitops",
+    "source_tool_log_deleted": false
+  },
+  "new_credential_reference": "/etc/aios-gitops/credentials/gitea-git-http",
+  "new_token_validation": {
+    "after_revoke_repository_http": 200,
+    "before_revoke_repository_http": 200,
+    "git_ls_remote_oid": "54093d15437ce0af31acf6feeeffacf6626a59cd",
+    "idempotent_branch_push": true
+  },
+  "old_token_validation": {
+    "after_revoke_repository_http": 401,
+    "before_revoke_repository_http": 200
+  },
+  "production_tag_operation": "NOT_EXECUTED",
+  "replacement_token_record_id": 50,
+  "scope": "write:repository",
+  "token_id": 33
+}
@@ -1,39 +0,0 @@
-apiVersion: aios.v2/v1
-kind: AgentTask
-metadata:
-  name: codex-production-supervisor-task
-  owner: AIOS-Control-Plane
-spec:
-  executor: codex
-  role: architecture-supervisor
-  objective: >-
-    Supervise AIOS V2R1 production candidate deployment, resolve blocking issues,
-    review patches, and maintain architecture/document consistency.
-  responsibilities:
-    - review OpenClaw deployment evidence
-    - review Hermes runtime issues
-    - analyze failed tests and blockers
-    - approve or reject patch direction
-    - verify docs/code/traceability consistency
-    - require ADR updates for architecture changes
-    - maintain final release readiness assessment
-  prohibited:
-    - bypass GitOps process
-    - directly apply unreviewed production changes
-    - weaken tenant isolation or security gates
-    - approve missing evidence
-  required_checks:
-    - requirement traceability
-    - architecture boundary compliance
-    - test evidence
-    - secret safety
-    - rollback readiness
-    - document synchronization
-  evidence_required:
-    - claim
-    - heartbeat
-    - progress
-    - blocker
-    - review_result
-    - commit
-    - final_recommendation
@@ -1,35 +0,0 @@
-apiVersion: aios.v2/v1
-kind: AgentTask
-metadata:
-  name: openclaw-production-deploy-task
-  owner: AIOS-Control-Plane
-spec:
-  executor: openclaw
-  role: deployment-operator
-  objective: >-
-    Deploy AIOS V2R1 candidate runtime, execute health checks, integrate OpenClaw
-    runtime boundary, and fix low-risk runtime/deployment defects.
-  responsibilities:
-    - install systemd or Docker candidate deployment
-    - validate environment configuration
-    - execute healthcheck and smoke tests
-    - verify OpenClaw runtime connectivity
-    - fix small deployment/runtime defects through patch branches
-    - update ExecutionEvidence after every step
-  prohibited:
-    - modify AIOS control-plane architecture
-    - bypass GitOps workflow
-    - commit secrets
-    - directly edit production without a recorded change
-  evidence_required:
-    - claim
-    - heartbeat
-    - progress
-    - blocker
-    - commit
-    - test_status
-    - result
-  escalation:
-    - architecture change -> Codex supervisor
-    - security issue -> AIOS owner
-    - blocked deployment -> Codex supervisor
@@ -1,256 +0,0 @@
-from __future__ import annotations
-
-import sys
-import tempfile
-import unittest
-from pathlib import Path
-
-REPO_ROOT = Path(__file__).resolve().parents[2]
-APP_ROOT = REPO_ROOT / "active-runtime" / "app"
-if str(APP_ROOT) not in sys.path:
-    sys.path.insert(0, str(APP_ROOT))
-
-from aios_hermes import HermesAdapter, HermesJobState, HermesWorker
-from aios_openclaw import (
-    CommandState,
-    InProcessRuntimeTransport,
-    OpenClawAdapter,
-)
-from aios_v2 import (
-    ControlPlaneService,
-    ExecutionEvidence,
-    ExecutionOrchestrator,
-    ExecutionTracker,
-    RequestContext,
-    TaskState,
-    TenantIsolationError,
-)
-from aios_v2.persistence import DurableControlPlaneService, SQLiteSnapshotRepository
-
-
-SIGNING_MATERIAL = b"candidate-test-signing-material-0001"
-
-
-def context(
-    tenant_id: str,
-    principal: str,
-    *roles: str,
-) -> RequestContext:
-    return RequestContext.create(
-        tenant_id=tenant_id,
-        principal_id=principal,
-        roles=roles,
-        trace_id=f"trace-{tenant_id}-{principal}",
-    )
-
-
-def bootstrap(service: ControlPlaneService, tenant_id: str = "tenant-a"):
-    platform = context(tenant_id, "platform", "platform_admin")
-    service.register_tenant(
-        platform,
-        tenant_id=tenant_id,
-        display_name=tenant_id,
-    )
-    operator = context(
-        tenant_id,
-        "operator",
-        "tenant_admin",
-        "operator",
-        "approver",
-        "auditor",
-        "runtime",
-    )
-    return platform, operator
-
-
-class CandidateFlowTests(unittest.TestCase):
-    def test_openclaw_full_flow_reconciles_completed_task(self) -> None:
-        service = ControlPlaneService()
-        _, operator = bootstrap(service)
-        agent = service.register_agent(
-            operator,
-            agent_id="openclaw-agent",
-            display_name="OpenClaw",
-            runtime="openclaw",
-            capabilities=("echo",),
-        )
-        task = service.create_task(
-            operator,
-            agent_id=agent.agent_id,
-            action="echo",
-            payload={"message": "hello"},
-            idempotency_key="openclaw-flow-1",
-        )
-        approved = service.transition_task(
-            operator,
-            task_id=task.task_id,
-            target_state=TaskState.APPROVED,
-            expected_revision=task.revision,
-        )
-
-        transport = InProcessRuntimeTransport(
-            lambda command: {
-                "state": CommandState.COMPLETED.value,
-                "output": {"echo": command.payload["message"]},
-            }
-        )
-        resolver = lambda tenant_id, key_id: SIGNING_MATERIAL
-        adapter = OpenClawAdapter(transport, resolver)
-        orchestrator = ExecutionOrchestrator(
-            service,
-            openclaw=adapter,
-            openclaw_signing_material_resolver=resolver,
-        )
-
-        dispatch = orchestrator.dispatch(operator, task_id=approved.task_id)
-        completed = service.get_task(operator, task.task_id)
-
-        self.assertEqual(dispatch.runtime, "openclaw")
-        self.assertEqual(dispatch.state, CommandState.COMPLETED.value)
-        self.assertEqual(completed.state, TaskState.COMPLETED)
-        self.assertEqual(completed.result, {"echo": "hello"})
-
-    def test_hermes_full_flow_reconciles_worker_result(self) -> None:
-        service = ControlPlaneService()
-        _, operator = bootstrap(service)
-        agent = service.register_agent(
-            operator,
-            agent_id="hermes-agent",
-            display_name="Hermes",
-            runtime="hermes",
-            capabilities=("transform",),
-            metadata={"cell_id": "cell-a", "profile_id": "profile-a"},
-        )
-        task = service.create_task(
-            operator,
-            agent_id=agent.agent_id,
-            action="transform",
-            payload={"value": 7},
-            idempotency_key="hermes-flow-1",
-        )
-        approved = service.transition_task(
-            operator,
-            task_id=task.task_id,
-            target_state=TaskState.APPROVED,
-            expected_revision=task.revision,
-        )
-
-        hermes = HermesAdapter(default_lease_seconds=10)
-        orchestrator = ExecutionOrchestrator(service, hermes=hermes)
-        dispatch = orchestrator.dispatch(operator, task_id=approved.task_id)
-        self.assertEqual(dispatch.runtime, "hermes")
-        self.assertEqual(dispatch.state, HermesJobState.QUEUED.value)
-
-        worker = HermesWorker(
-            hermes,
-            lambda job: {"transformed": int(job.payload["value"]) * 2},
-            worker_id="worker-a",
-            tenant_id="tenant-a",
-            cell_id="cell-a",
-            profile_id="profile-a",
-            heartbeat_seconds=0.05,
-        )
-        run = worker.run_once()
-        self.assertTrue(run.claimed)
-        self.assertEqual(run.state, HermesJobState.COMPLETED.value)
-
-        result = hermes.result(dispatch.runtime_execution_id, tenant_id="tenant-a")
-        completed = orchestrator.reconcile_hermes(operator, result)
-        self.assertEqual(completed.state, TaskState.COMPLETED)
-        self.assertEqual(completed.result, {"transformed": 14})
-
-    def test_cross_tenant_task_read_is_denied(self) -> None:
-        service = ControlPlaneService()
-        _, tenant_a = bootstrap(service, "tenant-a")
-        platform_b = context("tenant-b", "platform", "platform_admin")
-        service.register_tenant(
-            platform_b,
-            tenant_id="tenant-b",
-            display_name="Tenant B",
-        )
-        tenant_b = context("tenant-b", "auditor", "auditor")
-
-        agent = service.register_agent(
-            tenant_a,
-            agent_id="agent-a",
-            display_name="Agent A",
-            runtime="hermes",
-            capabilities=("work",),
-        )
-        task = service.create_task(
-            tenant_a,
-            agent_id=agent.agent_id,
-            action="work",
-            payload={},
-            idempotency_key="tenant-isolation-1",
-        )
-
-        with self.assertRaises(TenantIsolationError):
-            service.get_task(tenant_b, task.task_id)
-
-    def test_durable_service_recovers_state_after_restart(self) -> None:
-        with tempfile.TemporaryDirectory() as temporary:
-            path = Path(temporary) / "state.sqlite3"
-            service = DurableControlPlaneService(SQLiteSnapshotRepository(path))
-            _, operator = bootstrap(service)
-            agent = service.register_agent(
-                operator,
-                agent_id="persistent-agent",
-                display_name="Persistent",
-                runtime="hermes",
-                capabilities=("persist",),
-            )
-            task = service.create_task(
-                operator,
-                agent_id=agent.agent_id,
-                action="persist",
-                payload={"ok": True},
-                idempotency_key="persist-1",
-            )
-
-            recovered = DurableControlPlaneService(SQLiteSnapshotRepository(path))
-            restored_task = recovered.get_task(operator, task.task_id)
-            self.assertEqual(restored_task.payload, {"ok": True})
-            self.assertEqual(restored_task.state, TaskState.CREATED)
-
-    def test_execution_tracking_persists_claim_heartbeat_and_result(self) -> None:
-        with tempfile.TemporaryDirectory() as temporary:
-            tracker = ExecutionTracker(temporary)
-            claimed = tracker.claim(
-                ExecutionEvidence(
-                    execution_id="exec-1",
-                    tenant_id="tenant-a",
-                    task_id="task-1",
-                    agent_id="agent-1",
-                    executor="codex",
-                    branch="task/codex/example",
-                    progress_total=3,
-                )
-            )
-            self.assertEqual(claimed.status, "claimed")
-            tracker.heartbeat(
-                tenant_id="tenant-a",
-                execution_id="exec-1",
-                status="running",
-                current_step="tests",
-                progress_completed=2,
-                last_commit="abc123",
-            )
-            tracker.complete(
-                tenant_id="tenant-a",
-                execution_id="exec-1",
-                status="complete",
-                test_status="passed",
-                test_summary={"passed": 5, "failed": 0},
-            )
-            restored = ExecutionTracker(temporary).get(
-                tenant_id="tenant-a",
-                execution_id="exec-1",
-            )
-            self.assertEqual(restored.status, "complete")
-            self.assertEqual(restored.progress_completed, 3)
-            self.assertEqual(restored.test_summary["passed"], 5)
-
-
-if __name__ == "__main__":
-    unittest.main()
@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+
+umask 077
+GITEA="${AIOS_GITEA_BINARY:-/data/aios-gitops/runtime/bin/gitea}"
+CONFIG="${AIOS_GITEA_CONFIG:-/data/aios-gitops/runtime/gitea-bin/custom/conf/app.ini}"
+WORKSPACE="${AIOS_GITOPS_WORKSPACE:-$(cd "$(dirname "$0")/.." && pwd)}"
+USER_NAME="tagatomicitytest$(date +%s)"
+TMP_DIR="$(mktemp -d /tmp/aios-gitea-live-test.XXXXXX)"
+
+cleanup() {
+  "$GITEA" --config "$CONFIG" admin user delete \
+    --username "$USER_NAME" --purge >/dev/null 2>&1 || true
+  rm -f "$TMP_DIR/token" "$TMP_DIR/create-output"
+  rmdir "$TMP_DIR" 2>/dev/null || true
+}
+trap cleanup EXIT
+
+"$GITEA" --config "$CONFIG" admin user create \
+  --username "$USER_NAME" \
+  --email "$USER_NAME@example.invalid" \
+  --random-password \
+  --must-change-password=false >"$TMP_DIR/create-output" 2>&1
+"$GITEA" --config "$CONFIG" admin user generate-access-token \
+  --username "$USER_NAME" \
+  --token-name live-temporary-repository-test \
+  --raw \
+  --scopes write:repository,write:user >"$TMP_DIR/token"
+chmod 600 "$TMP_DIR/token"
+
+cd "$WORKSPACE"
+AIOS_GITOPS_LIVE_GITEA_TEST=1 \
+AIOS_GITOPS_LIVE_GITEA_OWNER="$USER_NAME" \
+AIOS_GITOPS_LIVE_GITEA_TOKEN_FILE="$TMP_DIR/token" \
+AIOS_GITOPS_LIVE_GITEA_TOKEN_LINE=1 \
+python3 -m pytest -q tests/test_gitea_tag_publication_live.py
@@ -0,0 +1,324 @@
+from __future__ import annotations
+
+import importlib.util
+import json
+import os
+import subprocess
+import tempfile
+import unittest
+from types import SimpleNamespace
+from pathlib import Path
+from unittest.mock import Mock, patch
+
+ROOT = Path(__file__).resolve().parents[1]
+import sys
+sys.path.insert(0, str(ROOT / "runtime" / "agent-os"))
+sys.path.insert(0, str(ROOT / "active-runtime" / "app"))
+from gitea_tag_publication import build_publisher
+import authoritative_git as authoritative_git_module
+from authoritative_git import (
+    AuthoritativeGitError,
+    AuthoritativeGitNotFound,
+    AuthoritativeGitOutputTooLarge,
+    authoritative_branches,
+    authoritative_diff,
+    authoritative_commit,
+    authoritative_head_oid,
+    authoritative_tags,
+    repository_snapshot,
+    run_authoritative_git,
+    validate_git_revision,
+    verify_repository,
+)
+
+API_SPEC = importlib.util.spec_from_file_location(
+    "authoritative_test_api",
+    ROOT / "active-runtime" / "app" / "aios_chatgpt_actions_api.py",
+)
+assert API_SPEC and API_SPEC.loader
+api = importlib.util.module_from_spec(API_SPEC)
+API_SPEC.loader.exec_module(api)
+
+
+class AuthoritativeGitContextTests(unittest.TestCase):
+    def setUp(self):
+        self.tmp = tempfile.TemporaryDirectory()
+        self.root = Path(self.tmp.name)
+        self.bare = self.root / "repo.git"
+        self.seed = self.root / "seed"
+        self.runtime = self.root / "runtime"
+        subprocess.run(["git", "init", "--bare", str(self.bare)], check=True, capture_output=True)
+        subprocess.run(["git", "init", "-b", "main", str(self.seed)], check=True, capture_output=True)
+        for key, value in (("user.name", "test"), ("user.email", "test@example.invalid")):
+            subprocess.run(["git", "-C", str(self.seed), "config", key, value], check=True)
+        (self.seed / "README").write_text("context\n", encoding="utf-8")
+        subprocess.run(["git", "-C", str(self.seed), "add", "README"], check=True)
+        subprocess.run(["git", "-C", str(self.seed), "commit", "-m", "seed"], check=True, capture_output=True)
+        subprocess.run(["git", "-C", str(self.seed), "remote", "add", "origin", str(self.bare)], check=True)
+        subprocess.run(["git", "-C", str(self.seed), "push", "origin", "main"], check=True, capture_output=True)
+        subprocess.run(["git", "--git-dir", str(self.bare), "config", "remote.gitea.url", "https://g.cnnetmkt.top/git/aios/aios.git"], check=True)
+        subprocess.run(["git", "-C", str(self.seed), "tag", "-a", "V1R1C0", "-m", "annotated"], check=True)
+        subprocess.run(["git", "-C", str(self.seed), "tag", "V1R1C1"], check=True)
+        subprocess.run(["git", "-C", str(self.seed), "checkout", "-b", "patch/context"], check=True, capture_output=True)
+        (self.seed / "CHANGE").write_text("authoritative diff\n", encoding="utf-8")
+        subprocess.run(["git", "-C", str(self.seed), "add", "CHANGE"], check=True)
+        subprocess.run(["git", "-C", str(self.seed), "commit", "-m", "change"], check=True, capture_output=True)
+        subprocess.run(["git", "-C", str(self.seed), "push", "origin", "patch/context", "--tags"], check=True, capture_output=True)
+        (self.runtime / "versions").mkdir(parents=True)
+        (self.runtime / "patches").mkdir()
+        (self.runtime / "versions" / "V1R1C0.json").write_text(
+            json.dumps({"version": "V1R1C0"}), encoding="utf-8"
+        )
+        (self.runtime / "patches" / "context.json").write_text(
+            json.dumps({"branch": "patch/context"}), encoding="utf-8"
+        )
+        self.env = {
+            "AIOS_GITOPS_AUTHORITATIVE_GIT_DIR": str(self.bare),
+            "AIOS_GITOPS_REPOSITORY_IDENTITY": "aios/aios",
+        }
+
+    def tearDown(self):
+        self.tmp.cleanup()
+
+    def test_runtime_cwd_without_git_uses_authoritative_head(self):
+        with patch.dict(os.environ, self.env, clear=False), patch("os.getcwd", return_value=str(self.runtime)):
+            self.assertFalse((self.runtime / ".git").exists())
+            self.assertEqual(len(authoritative_head_oid()), 40)
+
+    def test_annotated_and_lightweight_tags_include_type_and_peeled_target(self):
+        with patch.dict(os.environ, self.env, clear=False):
+            tags = {item["name"]: item for item in authoritative_tags()}
+        self.assertEqual(tags["V1R1C0"]["object_type"], "tag")
+        self.assertEqual(tags["V1R1C0"]["peeled_target_oid"], tags["V1R1C1"]["peeled_target_oid"])
+        self.assertEqual(tags["V1R1C1"]["object_type"], "commit")
+
+    def test_authoritative_branches_include_exact_oids(self):
+        with patch.dict(os.environ, self.env, clear=False):
+            branches = {item["name"]: item["oid"] for item in authoritative_branches()}
+        self.assertIn("main", branches)
+        self.assertIn("patch/context", branches)
+        self.assertEqual(len(branches["main"]), 40)
+
+    def test_runtime_cwd_changes_do_not_change_results(self):
+        old_cwd = os.getcwd()
+        try:
+            with patch.dict(os.environ, self.env, clear=False):
+                first = authoritative_head_oid()
+                os.chdir(str(self.runtime))
+                second = authoritative_head_oid()
+            self.assertEqual(first, second)
+        finally:
+            os.chdir(old_cwd)
+
+    def test_missing_configuration_fails_closed(self):
+        with patch.dict(os.environ, {}, clear=True), self.assertRaises(AuthoritativeGitError):
+            verify_repository()
+
+    def test_missing_repository_fails_closed(self):
+        with patch.dict(os.environ, {**self.env, "AIOS_GITOPS_AUTHORITATIVE_GIT_DIR": str(self.root / "missing")}, clear=False):
+            with self.assertRaises(AuthoritativeGitError):
+                verify_repository()
+
+    def test_non_bare_repository_fails_closed(self):
+        with patch.dict(os.environ, self.env, clear=False), self.assertRaises(AuthoritativeGitError):
+            verify_repository(self.seed)
+
+    def test_repository_identity_mismatch_fails_closed(self):
+        with patch.dict(os.environ, {**self.env, "AIOS_GITOPS_REPOSITORY_IDENTITY": "other/repo"}, clear=False):
+            with self.assertRaises(AuthoritativeGitError):
+                verify_repository()
+
+    def test_git_command_failure_is_not_an_empty_success(self):
+        with patch.dict(os.environ, self.env, clear=False):
+            with self.assertRaises(AuthoritativeGitError) as ctx:
+                run_authoritative_git(["rev-parse", "--verify", "refs/heads/no-such-branch"])
+        self.assertIn("GIT_REF_QUERY_FAILED", str(ctx.exception))
+        self.assertNotIn("tags=[]", str(ctx.exception))
+
+    def test_commit_input_rejects_git_parameter_injection(self):
+        with patch.dict(os.environ, self.env, clear=False):
+            with self.assertRaises(ValueError):
+                authoritative_commit("1" * 39 + ";")
+
+    def test_repository_snapshot_exposes_authoritative_head(self):
+        with patch.dict(os.environ, self.env, clear=False):
+            snapshot = repository_snapshot()
+        self.assertTrue(snapshot["repository_available"])
+        self.assertEqual(snapshot["repository_identity"], "aios/aios")
+        self.assertEqual(len(snapshot["authoritative_head_oid"]), 40)
+
+    def _get(self, path):
+        handler = object.__new__(api.H)
+        handler.path = path
+        handler.sendj = Mock(side_effect=lambda data, code=200: (data, code))
+        handler.sendt = Mock(side_effect=lambda data, ctype="text/plain; charset=utf-8", code=200: (data, code))
+        with (
+            patch.dict(os.environ, self.env, clear=False),
+            patch.object(api, "WS", self.runtime),
+            patch.object(api, "AUTHORITATIVE_GIT_DIR", self.bare),
+            patch.object(api, "REPOSITORY_IDENTITY", "aios/aios"),
+        ):
+            api.H.do_GET(handler)
+        args = handler.sendj.call_args.args
+        return args[0], args[1] if len(args) > 1 else 200
+
+    def test_api_list_versions_uses_authoritative_tags(self):
+        body, code = self._get("/api/ver")
+        self.assertEqual(code, 200)
+        self.assertTrue(body["repository_available"])
+        self.assertTrue(body["local_authoritative_tags"])
+        self.assertEqual(body["head"], body["authoritative_head_oid"])
+        self.assertIn("V1R1C0", body["tags"])
+
+    def test_api_list_patches_uses_authoritative_branches(self):
+        body, code = self._get("/api/patch")
+        self.assertEqual(code, 200)
+        self.assertIn("patch/context", body["branches"])
+        self.assertTrue(body["authoritative_branches"])
+
+    def test_api_unavailable_does_not_return_empty_lists(self):
+        handler = object.__new__(api.H)
+        handler.path = "/api/ver"
+        handler.sendj = Mock(side_effect=lambda data, code=200: (data, code))
+        with patch.dict(os.environ, {}, clear=True), patch.object(api, "WS", self.runtime), patch.object(api, "AUTHORITATIVE_GIT_DIR", None), patch.object(api, "REPOSITORY_IDENTITY", ""):
+            api.H.do_GET(handler)
+        body, code = handler.sendj.call_args.args
+        self.assertEqual(code, 503)
+        self.assertFalse(body["repository_available"])
+        self.assertIn("query_error", body)
+
+    def test_api_runtime_status_contains_release_and_repository_fields(self):
+        handler = object.__new__(api.H)
+        handler.path = "/api/run"
+        handler.sendj = Mock(side_effect=lambda data, code=200: (data, code))
+        real_run = subprocess.run
+        def service_or_real(*args, **kwargs):
+            command = args[0] if args else kwargs.get("args", [])
+            if command and command[0] == "systemctl":
+                return subprocess.CompletedProcess(command, 0, stdout="active\n", stderr="")
+            return real_run(*args, **kwargs)
+        with (
+            patch.dict(os.environ, self.env, clear=False),
+            patch.object(api, "WS", self.runtime),
+            patch.object(api, "AUTHORITATIVE_GIT_DIR", self.bare),
+            patch.object(api, "REPOSITORY_IDENTITY", "aios/aios"),
+            patch.object(api.subprocess, "run", side_effect=service_or_real),
+        ):
+            api.H.do_GET(handler)
+        body, code = handler.sendj.call_args.args
+        self.assertEqual(code, 200)
+        self.assertIsNone(body["workspace_branch"])
+        self.assertTrue(body["authoritative_git_dir_configured"])
+        self.assertEqual(body["authoritative_head_oid"], body["authoritative_head_oid"])
+
+    def test_authoritative_head_is_independent_of_runtime_directory(self):
+        with patch.dict(os.environ, self.env, clear=False):
+            old = os.getcwd()
+            try:
+                os.chdir(str(self.runtime))
+                self.assertEqual(authoritative_head_oid(), authoritative_head_oid())
+            finally:
+                os.chdir(old)
+
+    def test_authoritative_api_is_read_only(self):
+        before = subprocess.run(["git", "--git-dir", str(self.bare), "show-ref"], check=True, capture_output=True, text=True).stdout
+        with patch.dict(os.environ, self.env, clear=False):
+            authoritative_tags()
+            authoritative_branches()
+        after = subprocess.run(["git", "--git-dir", str(self.bare), "show-ref"], check=True, capture_output=True, text=True).stdout
+        self.assertEqual(before, after)
+
+    def test_error_text_does_not_include_credential_values(self):
+        with patch.dict(os.environ, self.env, clear=False):
+            with self.assertRaises(AuthoritativeGitError) as ctx:
+                run_authoritative_git(["rev-parse", "--verify", "https://user:password@example.invalid/x"])
+        self.assertNotIn("password", str(ctx.exception).lower())
+
+    def test_cli_publisher_requires_and_uses_authoritative_repository(self):
+        args = SimpleNamespace(
+            workspace=str(self.runtime),
+            remote="gitea",
+            gitea_api="http://127.0.0.1:3000/api/v1",
+            gitea_repo="aios/aios",
+            gitea_token_file="/dev/null",
+        )
+        with patch.dict(os.environ, self.env, clear=False):
+            publisher = build_publisher(args)
+        self.assertEqual(publisher.git.authoritative_repo, self.bare)
+
+    def test_cli_publisher_fails_closed_without_authoritative_repository(self):
+        args = SimpleNamespace(
+            workspace=str(self.runtime),
+            remote="gitea",
+            gitea_api="http://127.0.0.1:3000/api/v1",
+            gitea_repo="aios/aios",
+            gitea_token_file="/dev/null",
+        )
+        with patch.dict(os.environ, {}, clear=True), self.assertRaises(RuntimeError):
+            build_publisher(args)
+
+    def test_authoritative_diff_supports_branch_tag_and_exact_oid(self):
+        with patch.dict(os.environ, self.env, clear=True):
+            by_ref = authoritative_diff("V1R1C0", "patch/context")
+            main_oid = validate_git_revision("refs/heads/main", "from")
+            patch_oid = validate_git_revision("refs/heads/patch/context", "to")
+            by_oid = authoritative_diff(main_oid, patch_oid)
+        self.assertIn("CHANGE", by_ref["stdout"])
+        self.assertEqual(by_ref["stdout"], by_oid["stdout"])
+        self.assertEqual(by_ref["code"], 0)
+
+    def test_authoritative_diff_is_cwd_independent(self):
+        old = os.getcwd()
+        try:
+            with patch.dict(os.environ, self.env, clear=True):
+                first = authoritative_diff("V1R1C0", "patch/context")["stdout"]
+                os.chdir(self.runtime)
+                second = authoritative_diff("V1R1C0", "patch/context")["stdout"]
+            self.assertEqual(first, second)
+        finally:
+            os.chdir(old)
+
+    def test_revision_injection_and_revision_expressions_are_rejected(self):
+        with patch.dict(os.environ, self.env, clear=True):
+            for value in ("--help", "--output=x", "HEAD~1", "main^{tree}", "@{1}", ":/secret", "", " main"):
+                with self.subTest(value=value), self.assertRaises(ValueError):
+                    validate_git_revision(value, "from")
+
+    def test_valid_but_missing_revision_is_not_found(self):
+        with patch.dict(os.environ, self.env, clear=True), self.assertRaises(AuthoritativeGitNotFound):
+            validate_git_revision("missing-branch", "from")
+
+    def test_diff_output_limit_is_fail_closed(self):
+        with patch.dict(os.environ, self.env, clear=True), patch.object(authoritative_git_module, "_MAX_OUTPUT", 1):
+            with self.assertRaises(AuthoritativeGitOutputTooLarge):
+                authoritative_diff("V1R1C0", "patch/context")
+
+    def test_api_diff_uses_authoritative_repository(self):
+        body, code = self._get("/api/diff?from=V1R1C0&to=patch/context")
+        self.assertEqual(code, 200)
+        self.assertIn("CHANGE", body["diff"]["stdout"])
+        self.assertEqual(len(body["diff"]["from_oid"]), 40)
+
+    def test_api_diff_status_mapping(self):
+        _, code = self._get("/api/diff?from=--help&to=patch/context")
+        self.assertEqual(code, 400)
+        _, code = self._get("/api/diff?from=missing-branch&to=patch/context")
+        self.assertEqual(code, 404)
+        with patch.object(api, "authoritative_diff", side_effect=AuthoritativeGitOutputTooLarge("GIT_OUTPUT_LIMIT_EXCEEDED")):
+            _, code = self._get("/api/diff?from=V1R1C0&to=patch/context")
+        self.assertEqual(code, 413)
+
+    def test_http_publisher_fails_closed_without_authoritative_repository(self):
+        with patch.dict(os.environ, {}, clear=True), patch.object(api, "AUTHORITATIVE_GIT_DIR", None), patch.object(api, "REPOSITORY_IDENTITY", ""):
+            with self.assertRaises(RuntimeError):
+                api.publication_publisher()
+
+    def test_http_publisher_fails_closed_on_identity_mismatch(self):
+        with patch.dict(os.environ, self.env, clear=True), patch.object(api, "AUTHORITATIVE_GIT_DIR", self.bare), patch.object(api, "REPOSITORY_IDENTITY", "other/repo"):
+            with self.assertRaises(RuntimeError):
+                api.publication_publisher()
+
+    def test_writer_guard_remains_false(self):
+        decision = api.evaluate_git_write(self.runtime, {"AIOS_GITOPS_WRITES_ENABLED": "false"})
+        self.assertFalse(decision.allowed)
+        self.assertEqual(decision.status_code, 423)
@@ -0,0 +1,431 @@
+from __future__ import annotations
+
+import importlib.util
+import json
+import os
+import shutil
+import subprocess
+import sys
+import tempfile
+import unittest
+import yaml
+from pathlib import Path
+from unittest.mock import Mock, patch
+
+ROOT = Path(__file__).resolve().parents[1]
+os.environ.setdefault("AIOS_GITOPS_WORKSPACE", str(ROOT))
+sys.path.insert(0, str(ROOT / "runtime" / "agent-os"))
+sys.path.insert(0, str(ROOT / "active-runtime" / "app"))
+SPEC = importlib.util.spec_from_file_location(
+    "aios_chatgpt_actions_api",
+    ROOT / "active-runtime" / "app" / "aios_chatgpt_actions_api.py",
+)
+assert SPEC and SPEC.loader
+api = importlib.util.module_from_spec(SPEC)
+SPEC.loader.exec_module(api)
+
+TARGET = "1" * 40
+EVIDENCE = "2" * 40
+TAG_OID = "3" * 40
+MAIN = "4" * 40
+
+
+class TagActionTests(unittest.TestCase):
+    def handler(self, role: str = "owner"):
+        handler = object.__new__(api.H)
+        handler.need = Mock(
+            return_value={"account": "owner", "role": role, "scopes": {"tag:create"}}
+        )
+        handler.sendj = Mock(side_effect=lambda data, code=200: (data, code))
+        return handler
+
+    def complete_request(self):
+        return {
+            "version": "V9R9C9",
+            "target_oid": TARGET,
+            "evidence_closure_oid": EVIDENCE,
+            "approval_plan_id": "owner-approved-test",
+            "execute": True,
+        }
+
+    def test_tag_publication_status_rejects_invalid_versions_without_reading(self):
+        invalid_queries = (
+            "../current",
+            "../../versions/V2R1C3",
+            "%2e%2e%2fcurrent",
+            "/etc/secret",
+            r"..\current",
+            "",
+        )
+        for value in invalid_queries:
+            with self.subTest(value=value):
+                handler = object.__new__(api.H)
+                handler.path = f"/api/tag-publication-status?version={value}"
+                handler.sendj = Mock(side_effect=lambda data, code=200: (data, code))
+                with patch.object(api, "publication_publisher") as publisher:
+                    handler.do_GET()
+                body = handler.sendj.call_args.args[0]
+                code = (
+                    handler.sendj.call_args.args[1]
+                    if len(handler.sendj.call_args.args) > 1
+                    else handler.sendj.call_args.kwargs.get("code", 200)
+                )
+                self.assertEqual(code, 400)
+                self.assertEqual(body, {"error": "invalid release version"})
+                if value:
+                    self.assertNotIn(value, str(body))
+                self.assertNotIn("/data/", str(body))
+                self.assertNotIn("BAIT-MUST-NOT-BE-READ", str(body))
+                publisher.assert_not_called()
+
+    def test_tag_publication_status_accepts_canonical_versions(self):
+        for version in ("V2R1C3", "V2R1C3-rc.1_build"):
+            with self.subTest(version=version):
+                handler = object.__new__(api.H)
+                handler.path = f"/api/tag-publication-status?version={version}"
+                handler.sendj = Mock(side_effect=lambda data, code=200: (data, code))
+                publisher = Mock()
+                publisher.get_tag_publication_status.return_value = {
+                    "version": version,
+                    "state": "UNKNOWN",
+                }
+                with patch.object(api, "publication_publisher", return_value=publisher):
+                    handler.do_GET()
+                body = handler.sendj.call_args.args[0]
+                code = (
+                    handler.sendj.call_args.args[1]
+                    if len(handler.sendj.call_args.args) > 1
+                    else handler.sendj.call_args.kwargs.get("code", 200)
+                )
+                self.assertEqual(code, 200)
+                self.assertEqual(body["version"], version)
+                publisher.get_tag_publication_status.assert_called_once_with(version)
+
+    def test_resolve_commit_oid_requires_full_exact_commit(self):
+        with patch.object(api, "authoritative_commit", return_value=TARGET):
+            self.assertEqual(api.resolve_commit_oid(TARGET), TARGET)
+        for value in (None, "1234567", "z" * 40):
+            with self.subTest(value=value), self.assertRaises(ValueError):
+                api.resolve_commit_oid(value)
+
+    def test_production_tag_requires_all_governance_fields(self):
+        handler = self.handler()
+        for missing in ("target_oid", "evidence_closure_oid", "approval_plan_id"):
+            payload = self.complete_request()
+            payload.pop(missing)
+            handler.tag(payload)
+            body, code = handler.sendj.call_args.args
+            self.assertEqual(code, 400)
+            self.assertIn("required", body)
+
+    def test_owner_execution_uses_atomic_publisher_and_never_changes_main(self):
+        handler = self.handler()
+        publication = {
+            "state": "BASELINE_UPDATED",
+            "tag_oid": TAG_OID,
+            "remote_tag_oid": TAG_OID,
+            "remote_peeled_target_oid": TARGET,
+            "gitea_listing_visible": True,
+        }
+
+        def fake_sh(args, check=False):
+            if args[:2] == ["merge-base", "--is-ancestor"]:
+                return {"code": 0, "stdout": "", "stderr": "", "cmd": []}
+            if args == ["rev-parse", "refs/heads/main"]:
+                return {"code": 0, "stdout": MAIN, "stderr": "", "cmd": []}
+            if args == ["rev-parse", "HEAD"]:
+                return {"code": 0, "stdout": EVIDENCE, "stderr": "", "cmd": []}
+            return {"code": 0, "stdout": "", "stderr": "", "cmd": []}
+
+        publisher = Mock()
+        publisher.publish.return_value = publication
+        with (
+            patch.object(api, "resolve_commit_oid", side_effect=[TARGET, EVIDENCE]),
+            patch.object(api, "sh", side_effect=fake_sh),
+            patch.object(api, "required_authoritative_git_dir", return_value=Path("/tmp/authoritative.git")),
+            patch.object(api, "GiteaTagClient"),
+            patch.object(api, "GitTagBackend"),
+            patch.object(api, "TagPublisher", return_value=publisher),
+            patch.object(api, "audit"),
+        ):
+            handler.tag(self.complete_request())
+        result = handler.sendj.call_args.args[0]
+        self.assertEqual(result["status"], "BASELINE_UPDATED")
+        self.assertEqual(result["target_oid"], TARGET)
+        self.assertEqual(result["tag_oid"], TAG_OID)
+        self.assertFalse(result["main_changed"])
+        self.assertFalse(result["force_push"])
+
+    def test_atomic_publisher_conflict_returns_reconciliation_required(self):
+        handler = self.handler()
+        publisher = Mock()
+        publisher.publish.side_effect = api.PublicationConflict("different remote OID")
+        with (
+            patch.object(api, "resolve_commit_oid", side_effect=[TARGET, EVIDENCE]),
+            patch.object(
+                api,
+                "sh",
+                side_effect=[
+                    {"code": 0, "stdout": "", "stderr": "", "cmd": []},
+                    {"code": 0, "stdout": MAIN, "stderr": "", "cmd": []},
+                ],
+            ),
+            patch.object(api, "required_authoritative_git_dir", return_value=Path("/tmp/authoritative.git")),
+            patch.object(api, "GiteaTagClient"),
+            patch.object(api, "GitTagBackend"),
+            patch.object(api, "TagPublisher", return_value=publisher),
+            patch.object(api, "audit"),
+        ):
+            handler.tag(self.complete_request())
+        body, code = handler.sendj.call_args.args
+        self.assertEqual(code, 409)
+        self.assertEqual(body["status"], "RECONCILIATION_REQUIRED")
+
+    def test_non_owner_request_persists_complete_target_binding(self):
+        handler = self.handler(role="chatgpt_bot")
+        with (
+            patch.object(api, "resolve_commit_oid", side_effect=[TARGET, EVIDENCE]),
+            patch.object(
+                api, "sh", return_value={"code": 0, "stdout": "", "stderr": "", "cmd": []}
+            ),
+            patch.object(api, "checkout", return_value="request/tag-v9r9c9"),
+            patch.object(
+                api,
+                "write_json",
+                return_value="baseline/tag_requests/V9R9C9.json",
+            ) as write_json,
+            patch.object(api, "commit", return_value={"status": "committed"}),
+        ):
+            handler.tag(self.complete_request())
+        saved = write_json.call_args.args[1]
+        self.assertEqual(saved["target_oid"], TARGET)
+        self.assertEqual(saved["evidence_closure_oid"], EVIDENCE)
+        self.assertEqual(saved["approval_plan_id"], "owner-approved-test")
+
+    def test_linked_worktree_branch_sync_verifies_instead_of_self_fetch(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            bare = root / "repo.git"
+            seed = root / "seed"
+            worktree = root / "writer"
+            subprocess.run(["git", "init", "--bare", str(bare)], check=True, capture_output=True)
+            subprocess.run(["git", "init", "-b", "main", str(seed)], check=True, capture_output=True)
+            subprocess.run(["git", "-C", str(seed), "config", "user.name", "test"], check=True)
+            subprocess.run(
+                ["git", "-C", str(seed), "config", "user.email", "test@example.invalid"],
+                check=True,
+            )
+            (seed / "x").write_text("x", encoding="utf-8")
+            subprocess.run(["git", "-C", str(seed), "add", "x"], check=True)
+            subprocess.run(["git", "-C", str(seed), "commit", "-m", "seed"], check=True, capture_output=True)
+            subprocess.run(["git", "-C", str(seed), "push", str(bare), "main"], check=True, capture_output=True)
+            subprocess.run(
+                ["git", "--git-dir", str(bare), "worktree", "add", "-b", "patch/test", str(worktree), "main"],
+                check=True,
+                capture_output=True,
+            )
+            old_ws, old_bare = api.WS, api.BARE_REPO
+            api.WS, api.BARE_REPO = worktree, bare
+            try:
+                result = api.sync_branch("patch/test")
+            finally:
+                api.WS, api.BARE_REPO = old_ws, old_bare
+            self.assertEqual(result["status"], "verified")
+            self.assertEqual(result["target"], "authoritative-bare")
+
+    def test_create_existing_branch_never_resets_it(self):
+        calls = []
+
+        def fake_sh(args, check=False):
+            calls.append(args)
+            if args[:2] == ["rev-parse", "--verify"]:
+                return {"code": 0, "stdout": MAIN, "stderr": "", "cmd": []}
+            return {"code": 0, "stdout": "", "stderr": "", "cmd": []}
+
+        with patch.object(api, "ensure_git"), patch.object(api, "sh", side_effect=fake_sh):
+            self.assertEqual(api.checkout("patch/existing", "main", True), "patch/existing")
+        self.assertIn(["checkout", "patch/existing"], calls)
+        self.assertFalse(any(call[:2] == ["checkout", "-B"] for call in calls))
+        self.assertFalse(any(call[:2] == ["checkout", "-b"] for call in calls))
+
+    def test_release_script_has_no_ignored_push_or_direct_main_update(self):
+        script = (ROOT / "scripts" / "release_version.sh").read_text(encoding="utf-8")
+        self.assertNotIn('git push origin "$VERSION" || true', script)
+        self.assertNotIn("git checkout main", script)
+        self.assertIn("approval_plan_id required", script)
+        self.assertIn("git push \"$BRANCH_REMOTE\"", script)
+        self.assertNotIn("RELEASE_DONE", script)
+        self.assertNotIn("merge-base --is-ancestor", script)
+        self.assertIn('"versions/$VERSION.json"', script)
+        self.assertNotIn('"baseline/tag_publications/$VERSION.json"', script)
+
+    def test_openapi_requires_complete_tag_governance_evidence(self):
+        schema = (
+            ROOT / "docs" / "gitops" / "openapi-chatgpt-actions.yaml"
+        ).read_text(encoding="utf-8")
+        self.assertIn(
+            "required: [version, target_oid, evidence_closure_oid, approval_plan_id]",
+            schema,
+        )
+        self.assertIn("x-openai-isConsequential: true", schema)
+        self.assertIn("Remote push pending", schema)
+        self.assertIn("operationId: getReleaseConsistency", schema)
+        self.assertIn("operationId: getTagPublicationStatus", schema)
+        self.assertIn("operationId: runReleaseAcceptance", schema)
+        document = yaml.safe_load(schema)
+        self.assertIn("/api/release-consistency", document["paths"])
+        status_parameters = document["paths"]["/api/tag-publication-status"]["get"][
+            "parameters"
+        ]
+        self.assertEqual(
+            status_parameters[0]["schema"]["pattern"],
+            r"^V\d+R\d+C\d+(?:-[A-Za-z0-9_.-]+)?$",
+        )
+        publication_states = document["components"]["schemas"]["PublicationState"][
+            "enum"
+        ]
+        self.assertIn("LOCAL_TAG_CREATED", publication_states)
+        self.assertIn("BASELINE_UPDATE_PENDING", publication_states)
+        self.assertNotIn("TAG_CREATED_LOCAL", publication_states)
+
+    def test_documented_normal_state_sequence_matches_canonical_contract(self):
+        document = (
+            ROOT / "docs" / "gitops" / "gitea-tag-publication-atomicity.md"
+        ).read_text(encoding="utf-8")
+        normal_section = document.split("## Legacy state migration", 1)[0]
+        self.assertIn("LOCAL_TAG_CREATED", normal_section)
+        self.assertIn("BASELINE_UPDATE_PENDING", normal_section)
+        self.assertNotIn("TAG_CREATED_LOCAL", normal_section)
+
+    def test_delivery_manifest_is_derived_from_git_without_self_reference(self):
+        generator = ROOT / "scripts" / "generate_delivery_manifest.py"
+        with tempfile.TemporaryDirectory() as td:
+            repo = Path(td)
+            subprocess.run(
+                ["git", "init", "-q", "-b", "main"], cwd=repo, check=True
+            )
+            subprocess.run(
+                ["git", "config", "user.email", "test@example.invalid"],
+                cwd=repo,
+                check=True,
+            )
+            subprocess.run(
+                ["git", "config", "user.name", "test"], cwd=repo, check=True
+            )
+            (repo / "base.txt").write_text("base", encoding="utf-8")
+            subprocess.run(["git", "add", "base.txt"], cwd=repo, check=True)
+            subprocess.run(
+                ["git", "commit", "-q", "-m", "base"], cwd=repo, check=True
+            )
+            base_oid = subprocess.check_output(
+                ["git", "rev-parse", "HEAD"], cwd=repo, text=True
+            ).strip()
+            subprocess.run(
+                ["git", "checkout", "-q", "-b", "patch/manifest-test"],
+                cwd=repo,
+                check=True,
+            )
+            (repo / "scripts").mkdir()
+            shutil.copy2(generator, repo / "scripts" / generator.name)
+            (repo / "source.txt").write_text(
+                "no credential content", encoding="utf-8"
+            )
+            subprocess.run(["git", "add", "."], cwd=repo, check=True)
+            subprocess.run(
+                ["git", "commit", "-q", "-m", "source one"], cwd=repo, check=True
+            )
+            (repo / "source.txt").write_text(
+                "no credential content\nsecond", encoding="utf-8"
+            )
+            subprocess.run(["git", "add", "source.txt"], cwd=repo, check=True)
+            subprocess.run(
+                ["git", "commit", "-q", "-m", "source two"], cwd=repo, check=True
+            )
+            source_commit = subprocess.check_output(
+                ["git", "rev-parse", "HEAD"], cwd=repo, text=True
+            ).strip()
+
+            subprocess.run(
+                [
+                    sys.executable,
+                    str(repo / "scripts" / generator.name),
+                    "--base",
+                    "main",
+                    "--output",
+                    "delivery.json",
+                ],
+                cwd=repo,
+                check=True,
+            )
+            manifest = json.loads((repo / "delivery.json").read_text())
+            expected_commits = (
+                subprocess.check_output(
+                    [
+                        "git",
+                        "log",
+                        "--reverse",
+                        "--format=%H",
+                        f"{base_oid}..{source_commit}",
+                    ],
+                    cwd=repo,
+                    text=True,
+                )
+                .strip()
+                .splitlines()
+            )
+
+            self.assertEqual(manifest["base"], "main")
+            self.assertEqual(manifest["base_oid"], base_oid)
+            self.assertEqual(manifest["source_branch"], "patch/manifest-test")
+            self.assertEqual(manifest["source_commit"], source_commit)
+            self.assertEqual(manifest["commits"], expected_commits)
+            self.assertEqual(manifest["commit_count"], len(expected_commits))
+            self.assertEqual(manifest["file_count"], len(manifest["files"]))
+            self.assertEqual(
+                manifest["manifest_path"],
+                "delivery.json",
+            )
+            self.assertNotIn(manifest["manifest_path"], manifest["files"])
+            self.assertEqual(
+                subprocess.check_output(
+                    ["git", "rev-parse", f"{manifest['source_commit']}^{{commit}}"],
+                    cwd=repo,
+                    text=True,
+                ).strip(),
+                source_commit,
+            )
+            self.assertNotIn("credential content", json.dumps(manifest))
+
+    def test_read_only_release_interfaces_are_allowlisted(self):
+        self.assertIn("/api/release-consistency", api.READ_ONLY_GET_PATHS)
+        self.assertIn("/api/tag-publication-status", api.READ_ONLY_GET_PATHS)
+        self.assertIn("/api/release-acceptance", api.READ_ONLY_GET_PATHS)
+
+    def test_release_consistency_query_requires_full_governance_fingerprint(self):
+        with self.assertRaises(ValueError):
+            api.publication_request_from_query({"version": ["V9R9C9"]})
+        parsed = api.publication_request_from_query(
+            {
+                "version": ["V9R9C9"],
+                "target_oid": [TARGET],
+                "evidence_closure_oid": [EVIDENCE],
+                "approval_plan_id": ["owner-approved-test"],
+            }
+        )
+        self.assertEqual(parsed.target_oid, TARGET)
+        self.assertEqual(parsed.approval_plan_id, "owner-approved-test")
+
+    def test_committed_security_incident_record_contains_no_secret(self):
+        record = (
+            ROOT
+            / "security"
+            / "incidents"
+            / "GITEA-TOKEN-33-EXPOSURE-20260723.redacted.json"
+        ).read_text(encoding="utf-8")
+        self.assertFalse(api.content_has_secret(record))
+        self.assertNotIn("token_plain", record)
+        self.assertNotIn("Authorization", record)
+
+
+if __name__ == "__main__":
+    unittest.main()
@@ -0,0 +1,872 @@
+from __future__ import annotations
+
+import json
+import os
+import shutil
+import subprocess
+import sys
+import tempfile
+import threading
+import time
+import unittest
+from pathlib import Path
+from unittest.mock import patch
+
+ROOT = Path(__file__).resolve().parents[1]
+sys.path.insert(0, str(ROOT / "active-runtime" / "app"))
+
+import gitea_tag_publication as publication_module  # noqa: E402
+
+from gitea_tag_publication import (  # noqa: E402
+    PublicationConflict,
+    PublicationPending,
+    PublicationReconciliationRequired,
+    PublicationRequest,
+    PublicationState,
+    PublicationStore,
+    GiteaTagClient,
+    GitTagBackend,
+    TagPublisher,
+)
+
+
+TARGET = "1" * 40
+EVIDENCE = "2" * 40
+TAG_OID = "3" * 40
+WRONG = "4" * 40
+
+
+class FakeGit:
+    def __init__(self):
+        self.local = None
+        self.remote = None
+        self.push_error = None
+        self.remote_error = None
+        self.lineage_error = None
+        self.pushes = 0
+        self.remote_checks = 0
+
+    def ensure_local_annotated_tag(self, request):
+        if self.local and self.local != (TAG_OID, request.target_oid):
+            raise PublicationConflict("local tag conflict")
+        self.local = (TAG_OID, request.target_oid)
+        return self.local
+
+    def remote_tag(self, remote, version):
+        self.remote_checks += 1
+        if self.remote_error:
+            raise self.remote_error
+        return self.remote
+
+    def push_tag(self, remote, version):
+        self.pushes += 1
+        if self.push_error:
+            raise self.push_error
+        self.remote = self.local
+
+    def validate_evidence_lineage(self, request):
+        if self.lineage_error:
+            raise self.lineage_error
+        return None
+
+    def repository_identity(self, remote, expected_repository):
+        return expected_repository
+
+
+class FakeGitea:
+    def __init__(self):
+        self.repository = "aios/aios"
+        self.lookup = (TAG_OID, TARGET)
+        self.visible = True
+        self.error = None
+        self.lookup_checks = 0
+        self.listing_checks = 0
+
+    def lookup_tag(self, version):
+        self.lookup_checks += 1
+        if self.error:
+            raise self.error
+        return self.lookup
+
+    def tag_visible_in_listing(self, version, expected_target_oid):
+        self.listing_checks += 1
+        if self.error:
+            raise self.error
+        return self.visible
+
+    def repository_identity(self):
+        return self.repository
+
+
+def request():
+    return PublicationRequest(
+        version="V9R9C9",
+        target_oid=TARGET,
+        evidence_closure_oid=EVIDENCE,
+        approval_plan_id="owner-approved-test",
+    )
+
+
+class TagPublicationTests(unittest.TestCase):
+    def publisher(self, root: Path, git=None, gitea=None):
+        baseline = root / "baseline" / "current.json"
+        baseline.parent.mkdir(parents=True)
+        baseline.write_text(
+            json.dumps({"current_baseline": "V9R9C8", "status": "PRODUCTION_DEPLOYED"}),
+            encoding="utf-8",
+        )
+        return TagPublisher(
+            workspace=root,
+            git=git or FakeGit(),
+            gitea=gitea or FakeGitea(),
+            remote="gitea",
+        )
+
+    def test_publication_store_rejects_path_traversal_without_reading(self):
+        invalid_versions = (
+            "../current",
+            "../../versions/V2R1C3",
+            "%2e%2e%2fcurrent",
+            "/etc/secret",
+            r"..\current",
+            "V2R1C3-..",
+            "",
+        )
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td) / "saga"
+            root.mkdir()
+            bait = root.parent / "current.json"
+            bait.write_text('{"secret":"BAIT-MUST-NOT-BE-READ"}', encoding="utf-8")
+            store = PublicationStore(Path(td), state_root=root)
+            for version in invalid_versions:
+                with self.subTest(version=version):
+                    with patch.object(
+                        Path,
+                        "read_text",
+                        side_effect=AssertionError("state file read attempted"),
+                    ):
+                        with self.assertRaisesRegex(
+                            ValueError, "^invalid release version$"
+                        ):
+                            store.load(version)
+                    with self.assertRaisesRegex(
+                        ValueError, "^invalid release version$"
+                    ):
+                        store.path(version)
+                    with self.assertRaisesRegex(
+                        ValueError, "^invalid release version$"
+                    ):
+                        with store.lock(version):
+                            self.fail("invalid version acquired a publication lock")
+            self.assertEqual(
+                bait.read_text(encoding="utf-8"),
+                '{"secret":"BAIT-MUST-NOT-BE-READ"}',
+            )
+
+    def test_publication_store_accepts_canonical_release_versions(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td) / "saga"
+            store = PublicationStore(Path(td), state_root=root)
+            for version in ("V2R1C3", "V2R1C3-rc.1_build"):
+                with self.subTest(version=version):
+                    self.assertEqual(store.path(version).parent, root.resolve())
+                    self.assertEqual(store.path(version).name, f"{version}.json")
+
+    def test_new_publication_uses_canonical_local_and_pending_states(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            git = FakeGit()
+            git.remote = (TAG_OID, TARGET)
+            gitea = FakeGitea()
+            publisher = self.publisher(root, git=git, gitea=gitea)
+            transitions = []
+            record = publisher.store.record
+
+            def observe(publication_request, state, **evidence):
+                transitions.append(state.value)
+                return record(publication_request, state, **evidence)
+
+            with patch.object(publisher.store, "record", side_effect=observe):
+                publisher.publish(request())
+
+            self.assertIn(PublicationState.LOCAL_TAG_CREATED.value, transitions)
+            self.assertNotIn("TAG_CREATED_LOCAL", transitions)
+            self.assertLess(
+                transitions.index(PublicationState.GITEA_API_CONFIRMED.value),
+                transitions.index(PublicationState.BASELINE_UPDATE_PENDING.value),
+            )
+            self.assertLess(
+                transitions.index(PublicationState.BASELINE_UPDATE_PENDING.value),
+                transitions.index(PublicationState.BASELINE_UPDATED.value),
+            )
+
+    def test_legacy_local_tag_state_is_normalized_on_read_and_next_write(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            publisher = self.publisher(root)
+            path = publisher.store.path(request().version)
+            path.parent.mkdir(parents=True, exist_ok=True)
+            path.write_text(
+                json.dumps(
+                    {
+                        **request().__dict__,
+                        "state": "TAG_CREATED_LOCAL",
+                        "tag_oid": TAG_OID,
+                    }
+                ),
+                encoding="utf-8",
+            )
+
+            loaded = publisher.get_tag_publication_status(request().version)
+            self.assertEqual(loaded["state"], "LOCAL_TAG_CREATED")
+            self.assertEqual(
+                json.loads(path.read_text(encoding="utf-8"))["state"],
+                "TAG_CREATED_LOCAL",
+            )
+
+            publisher.store.record(request(), PublicationState.LOCAL_TAG_CREATED)
+            persisted = json.loads(path.read_text(encoding="utf-8"))
+            self.assertEqual(persisted["state"], "LOCAL_TAG_CREATED")
+            self.assertNotIn("TAG_CREATED_LOCAL", json.dumps(persisted))
+
+    def test_unknown_persisted_state_fails_closed_without_mutation(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            git = FakeGit()
+            publisher = self.publisher(root, git=git)
+            path = publisher.store.path(request().version)
+            path.parent.mkdir(parents=True, exist_ok=True)
+            original = {
+                **request().__dict__,
+                "state": "UNRECOGNIZED_LEGACY_STATE",
+                "tag_oid": TAG_OID,
+            }
+            path.write_text(json.dumps(original), encoding="utf-8")
+
+            status = publisher.get_tag_publication_status(request().version)
+            self.assertEqual(
+                status["state"], PublicationState.RECONCILIATION_REQUIRED.value
+            )
+            self.assertTrue(status["fail_closed"])
+            with self.assertRaises(PublicationReconciliationRequired):
+                publisher.publish(request())
+            self.assertEqual(json.loads(path.read_text(encoding="utf-8")), original)
+            self.assertEqual(git.pushes, 0)
+
+    def test_evidence_lineage_conflict_requires_manual_owner_review(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            git = FakeGit()
+            git.lineage_error = PublicationConflict("evidence lineage mismatch")
+            publisher = self.publisher(root, git=git)
+
+            with self.assertRaises(PublicationConflict):
+                publisher.publish(request())
+
+            self.assertEqual(
+                publisher.store.load(request().version)["state"],
+                PublicationState.MANUAL_OWNER_REVIEW_REQUIRED.value,
+            )
+            self.assertEqual(git.pushes, 0)
+
+    def test_push_failure_does_not_update_baseline(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            git = FakeGit()
+            git.push_error = RuntimeError("push rejected")
+            publisher = self.publisher(root, git=git)
+            with self.assertRaises(PublicationPending):
+                publisher.publish(request())
+            baseline = json.loads((root / "baseline/current.json").read_text())
+            state = publisher.store.load("V9R9C9")
+            self.assertEqual(baseline["current_baseline"], "V9R9C8")
+            self.assertEqual(state["state"], PublicationState.REMOTE_PUSH_PENDING.value)
+
+    def test_deployed_record_with_missing_remote_tag_fails_closed(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            git = FakeGit()
+            publisher = self.publisher(root, git=git)
+            publisher.store.record(
+                request(),
+                PublicationState.PRODUCTION_DEPLOYED,
+                tag_oid=TAG_OID,
+                deployment_evidence="sha256:" + ("a" * 64),
+            )
+            with self.assertRaises(PublicationReconciliationRequired):
+                publisher.publish(request())
+            self.assertEqual(
+                publisher.store.load("V9R9C9")["state"],
+                "MANUAL_OWNER_REVIEW_REQUIRED",
+            )
+            self.assertEqual(git.pushes, 0)
+
+    def test_gitea_api_failure_does_not_deploy_or_update_baseline(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            git = FakeGit()
+            git.remote = (TAG_OID, TARGET)
+            gitea = FakeGitea()
+            gitea.error = RuntimeError("gitea unavailable")
+            publisher = self.publisher(root, git=git, gitea=gitea)
+            with self.assertRaises(PublicationReconciliationRequired):
+                publisher.publish(request())
+            baseline = json.loads((root / "baseline/current.json").read_text())
+            state = publisher.store.load("V9R9C9")
+            self.assertEqual(baseline["current_baseline"], "V9R9C8")
+            self.assertNotEqual(state["state"], PublicationState.PRODUCTION_DEPLOYED.value)
+            self.assertEqual(state["state"], PublicationState.RECONCILIATION_REQUIRED.value)
+
+    def test_remote_unreachable_recovers_idempotently(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            git = FakeGit()
+            git.remote_error = RuntimeError("network down")
+            publisher = self.publisher(root, git=git)
+            with self.assertRaises(PublicationPending):
+                publisher.publish(request())
+            git.remote_error = None
+            result = publisher.reconcile(request())
+            self.assertEqual(result["state"], PublicationState.BASELINE_UPDATED.value)
+            self.assertEqual(git.pushes, 1)
+
+    def test_same_name_different_remote_oid_is_rejected(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            git = FakeGit()
+            git.remote = (WRONG, TARGET)
+            publisher = self.publisher(root, git=git)
+            with self.assertRaises(PublicationConflict):
+                publisher.publish(request())
+            self.assertEqual(
+                publisher.store.load("V9R9C9")["state"],
+                PublicationState.MANUAL_OWNER_REVIEW_REQUIRED.value,
+            )
+
+    def test_annotated_tag_requires_exact_object_and_peeled_target(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            git = FakeGit()
+            git.remote = (TAG_OID, WRONG)
+            publisher = self.publisher(root, git=git)
+            with self.assertRaises(PublicationConflict):
+                publisher.publish(request())
+            self.assertEqual(git.pushes, 0)
+
+    def test_local_bare_success_but_gitea_failure_is_fail_closed(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            git = FakeGit()
+            git.remote = (TAG_OID, TARGET)
+            gitea = FakeGitea()
+            gitea.visible = False
+            publisher = self.publisher(root, git=git, gitea=gitea)
+            with self.assertRaises(PublicationReconciliationRequired):
+                publisher.publish(request())
+            self.assertEqual(
+                json.loads((root / "baseline/current.json").read_text())["current_baseline"],
+                "V9R9C8",
+            )
+
+    def test_restart_recovery_uses_persisted_state(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            git = FakeGit()
+            git.push_error = RuntimeError("temporary")
+            first = self.publisher(root, git=git)
+            with self.assertRaises(PublicationPending):
+                first.publish(request())
+            git.push_error = None
+            second = TagPublisher(root, git, FakeGitea(), "gitea")
+            result = second.reconcile(request())
+            self.assertEqual(result["state"], PublicationState.BASELINE_UPDATED.value)
+
+    def test_baseline_write_failure_preserves_update_pending(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            git = FakeGit()
+            git.remote = (TAG_OID, TARGET)
+            publisher = self.publisher(root, git=git)
+            atomic_write = publication_module.atomic_json_write
+
+            def fail_baseline(path, payload):
+                if path == publisher.baseline_path:
+                    raise OSError("baseline write failed")
+                return atomic_write(path, payload)
+
+            with (
+                patch.object(
+                    publication_module, "atomic_json_write", side_effect=fail_baseline
+                ),
+                self.assertRaises(PublicationReconciliationRequired),
+            ):
+                publisher.publish(request())
+
+            self.assertEqual(
+                publisher.store.load(request().version)["state"],
+                PublicationState.BASELINE_UPDATE_PENDING.value,
+            )
+            self.assertEqual(
+                json.loads(publisher.baseline_path.read_text())["current_baseline"],
+                "V9R9C8",
+            )
+            self.assertFalse(
+                (root / "versions" / f"{request().version}.json").exists()
+            )
+
+    def test_registry_write_failure_recovers_after_restart_without_tag_push(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            git = FakeGit()
+            git.remote = (TAG_OID, TARGET)
+            publisher = self.publisher(root, git=git)
+            registry_path = root / "versions" / f"{request().version}.json"
+            atomic_write = publication_module.atomic_json_write
+
+            def fail_registry(path, payload):
+                if path == registry_path:
+                    raise OSError("registry write failed")
+                return atomic_write(path, payload)
+
+            with (
+                patch.object(
+                    publication_module, "atomic_json_write", side_effect=fail_registry
+                ),
+                self.assertRaises(PublicationReconciliationRequired),
+            ):
+                publisher.publish(request())
+
+            self.assertEqual(
+                publisher.store.load(request().version)["state"],
+                PublicationState.BASELINE_UPDATE_PENDING.value,
+            )
+            self.assertEqual(
+                json.loads(publisher.baseline_path.read_text())["current_baseline"],
+                request().version,
+            )
+            self.assertFalse(registry_path.exists())
+
+            recovered = TagPublisher(root, git, FakeGitea(), "gitea")
+            result = recovered.reconcile(request())
+            self.assertEqual(result["state"], PublicationState.BASELINE_UPDATED.value)
+            self.assertTrue(registry_path.exists())
+            self.assertEqual(git.pushes, 0)
+
+    def test_pending_recovery_fills_missing_baseline_from_matching_registry(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            git = FakeGit()
+            git.remote = (TAG_OID, TARGET)
+            gitea = FakeGitea()
+            publisher = self.publisher(root, git=git, gitea=gitea)
+            publisher.store.record(
+                request(),
+                PublicationState.BASELINE_UPDATE_PENDING,
+                tag_oid=TAG_OID,
+            )
+            registry_path = root / "versions" / f"{request().version}.json"
+            registry_path.parent.mkdir(parents=True, exist_ok=True)
+            registry_path.write_text(
+                json.dumps(
+                    {
+                        **request().__dict__,
+                        "tag_oid": TAG_OID,
+                        "tag_object": TAG_OID,
+                        "registered": True,
+                        "enabled": True,
+                    }
+                ),
+                encoding="utf-8",
+            )
+
+            result = publisher.reconcile(request())
+
+            self.assertEqual(result["state"], PublicationState.BASELINE_UPDATED.value)
+            self.assertEqual(
+                json.loads(publisher.baseline_path.read_text())["current_baseline"],
+                request().version,
+            )
+            self.assertEqual(git.pushes, 0)
+            self.assertGreater(git.remote_checks, 0)
+            self.assertGreater(gitea.lookup_checks, 0)
+            self.assertGreater(gitea.listing_checks, 0)
+
+    def test_pending_recovery_revalidates_remote_and_conflict_requires_owner(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            git = FakeGit()
+            git.remote = (WRONG, TARGET)
+            publisher = self.publisher(root, git=git)
+            publisher.store.record(
+                request(),
+                PublicationState.BASELINE_UPDATE_PENDING,
+                tag_oid=TAG_OID,
+            )
+
+            with self.assertRaises(PublicationConflict):
+                publisher.reconcile(request())
+
+            self.assertEqual(
+                publisher.store.load(request().version)["state"],
+                PublicationState.MANUAL_OWNER_REVIEW_REQUIRED.value,
+            )
+            self.assertEqual(git.pushes, 0)
+
+    def test_reconciliation_is_idempotent_and_never_marks_deployed(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            git = FakeGit()
+            git.remote = (TAG_OID, TARGET)
+            publisher = self.publisher(root, git=git)
+            first = publisher.publish(request())
+            second = publisher.reconcile(request())
+            self.assertEqual(first["state"], PublicationState.BASELINE_UPDATED.value)
+            self.assertEqual(second["state"], PublicationState.BASELINE_UPDATED.value)
+            baseline = json.loads((root / "baseline/current.json").read_text())
+            self.assertEqual(baseline["status"], PublicationState.BASELINE_UPDATED.value)
+            self.assertEqual(git.pushes, 0)
+
+    def test_mark_deployed_requires_baseline_updated_and_evidence(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            publisher = self.publisher(root)
+            with self.assertRaises(PublicationReconciliationRequired):
+                publisher.mark_production_deployed(request(), "")
+            publisher.publish(request())
+            result = publisher.mark_production_deployed(
+                request(), "sha256:" + ("a" * 64)
+            )
+            self.assertEqual(result["state"], PublicationState.PRODUCTION_DEPLOYED.value)
+
+    def test_deployed_fingerprint_change_requires_manual_owner_review(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            git = FakeGit()
+            publisher = self.publisher(root, git=git)
+            publisher.store.record(
+                request(),
+                PublicationState.PRODUCTION_DEPLOYED,
+                tag_oid=TAG_OID,
+                deployment_evidence="sha256:" + ("a" * 64),
+            )
+            changed = PublicationRequest(
+                request().version,
+                WRONG,
+                request().evidence_closure_oid,
+                request().approval_plan_id,
+            )
+            with self.assertRaises(PublicationReconciliationRequired):
+                publisher.publish(changed)
+            state = publisher.store.load(request().version)
+            self.assertEqual(
+                state["state"], PublicationState.MANUAL_OWNER_REVIEW_REQUIRED.value
+            )
+            self.assertIn("target_oid", state["conflict_fields"])
+            self.assertEqual(git.pushes, 0)
+
+    def test_deployed_gitea_tag_object_change_requires_manual_review(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            git = FakeGit()
+            git.remote = (TAG_OID, TARGET)
+            gitea = FakeGitea()
+            gitea.lookup = (WRONG, TARGET)
+            publisher = self.publisher(root, git=git, gitea=gitea)
+            publisher.store.record(
+                request(),
+                PublicationState.PRODUCTION_DEPLOYED,
+                tag_oid=TAG_OID,
+                deployment_evidence="sha256:" + ("a" * 64),
+            )
+            with self.assertRaises(PublicationReconciliationRequired):
+                publisher.publish(request())
+            self.assertEqual(
+                publisher.store.load(request().version)["state"],
+                PublicationState.MANUAL_OWNER_REVIEW_REQUIRED.value,
+            )
+
+    def test_mark_deployed_rejects_different_approval_plan_id(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            publisher = self.publisher(root)
+            publisher.publish(request())
+            changed = PublicationRequest(
+                request().version,
+                request().target_oid,
+                request().evidence_closure_oid,
+                "different-owner-plan",
+            )
+            with self.assertRaises(PublicationReconciliationRequired):
+                publisher.mark_production_deployed(
+                    changed, "sha256:" + ("a" * 64)
+                )
+            self.assertEqual(
+                publisher.store.load(request().version)["state"],
+                PublicationState.MANUAL_OWNER_REVIEW_REQUIRED.value,
+            )
+
+    def test_state_survives_writer_worktree_deletion(self):
+        with tempfile.TemporaryDirectory() as td:
+            base = Path(td)
+            first_workspace = base / "writer-a"
+            first_workspace.mkdir()
+            state_root = base / "durable-state"
+            publisher = TagPublisher(
+                first_workspace,
+                FakeGit(),
+                FakeGitea(),
+                "gitea",
+                state_root=state_root,
+            )
+            publisher.store.record(request(), PublicationState.REMOTE_PUSH_PENDING)
+            shutil.rmtree(first_workspace)
+            second_workspace = base / "writer-b"
+            second_workspace.mkdir()
+            recovered = TagPublisher(
+                second_workspace,
+                FakeGit(),
+                FakeGitea(),
+                "gitea",
+                state_root=state_root,
+            )
+            self.assertEqual(
+                recovered.get_tag_publication_status(request().version)["state"],
+                PublicationState.REMOTE_PUSH_PENDING.value,
+            )
+
+    def test_duplicate_publication_lock_serializes_writers(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            state_root = root / "durable-state"
+            first = TagPublisher(
+                root, FakeGit(), FakeGitea(), "gitea", state_root=state_root
+            )
+            second = TagPublisher(
+                root, FakeGit(), FakeGitea(), "gitea", state_root=state_root
+            )
+            entered = threading.Event()
+
+            def wait_for_lock():
+                with second.store.lock(request().version):
+                    entered.set()
+
+            with first.store.lock(request().version):
+                worker = threading.Thread(target=wait_for_lock)
+                worker.start()
+                time.sleep(0.05)
+                self.assertFalse(entered.is_set())
+            worker.join(timeout=2)
+            self.assertTrue(entered.is_set())
+
+    def test_registry_baseline_mismatch_blocks_deployment(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            publisher = self.publisher(root)
+            publisher.publish(request())
+            registry_path = root / "versions" / f"{request().version}.json"
+            registry = json.loads(registry_path.read_text(encoding="utf-8"))
+            registry["target_oid"] = WRONG
+            registry_path.write_text(json.dumps(registry), encoding="utf-8")
+            with self.assertRaises(PublicationReconciliationRequired):
+                publisher.mark_production_deployed(
+                    request(), "sha256:" + ("a" * 64)
+                )
+            self.assertNotEqual(
+                publisher.store.load(request().version)["state"],
+                PublicationState.PRODUCTION_DEPLOYED.value,
+            )
+
+    def test_release_consistency_is_unknown_and_fail_closed_on_api_failure(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            git = FakeGit()
+            git.remote = (TAG_OID, TARGET)
+            gitea = FakeGitea()
+            publisher = self.publisher(root, git=git, gitea=gitea)
+            publisher.publish(request())
+            gitea.error = RuntimeError("Authorization: token super-secret")
+            result = publisher.run_release_acceptance(request())
+            self.assertEqual(result["status"], "UNKNOWN")
+            self.assertFalse(result["accepted"])
+            self.assertTrue(result["fail_closed"])
+            self.assertNotIn("super-secret", result["error"])
+
+    def test_release_consistency_fingerprint_failure_is_read_only(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            publisher = self.publisher(root)
+            publisher.publish(request())
+            before = publisher.store.load(request().version)
+            changed = PublicationRequest(
+                request().version,
+                WRONG,
+                request().evidence_closure_oid,
+                request().approval_plan_id,
+            )
+            result = publisher.get_release_consistency(changed)
+            after = publisher.store.load(request().version)
+            self.assertEqual(result["status"], "FAIL")
+            self.assertTrue(result["fail_closed"])
+            self.assertEqual(after, before)
+
+    def test_cli_evidence_lineage_mismatch_is_fail_closed(self):
+        with tempfile.TemporaryDirectory() as td:
+            root = Path(td)
+            subprocess.run(["git", "init", "-q", "-b", "patch/test"], cwd=root, check=True)
+            subprocess.run(
+                ["git", "config", "user.email", "test@example.invalid"],
+                cwd=root,
+                check=True,
+            )
+            subprocess.run(["git", "config", "user.name", "test"], cwd=root, check=True)
+            (root / "a").write_text("a", encoding="utf-8")
+            subprocess.run(["git", "add", "a"], cwd=root, check=True)
+            subprocess.run(["git", "commit", "-q", "-m", "a"], cwd=root, check=True)
+            target = subprocess.check_output(
+                ["git", "rev-parse", "HEAD"], cwd=root, text=True
+            ).strip()
+            subprocess.run(
+                ["git", "checkout", "-q", "--orphan", "unrelated"], cwd=root, check=True
+            )
+            subprocess.run(["git", "rm", "-q", "-rf", "."], cwd=root, check=True)
+            (root / "b").write_text("b", encoding="utf-8")
+            subprocess.run(["git", "add", "b"], cwd=root, check=True)
+            subprocess.run(["git", "commit", "-q", "-m", "b"], cwd=root, check=True)
+            evidence = subprocess.check_output(
+                ["git", "rev-parse", "HEAD"], cwd=root, text=True
+            ).strip()
+            authoritative = root / "authoritative.git"
+            subprocess.run(["git", "init", "-q", "--bare", str(authoritative)], check=True)
+            subprocess.run(
+                ["git", "--git-dir", str(authoritative), "config", "remote.gitea.url", "https://g.cnnetmkt.top/git/aios/aios.git"],
+                check=True,
+            )
+            subprocess.run(["git", "-C", str(root), "remote", "add", "authority", str(authoritative)], check=True)
+            subprocess.run(["git", "-C", str(root), "push", "-q", "authority", "--all"], check=True)
+            module = ROOT / "active-runtime" / "app" / "gitea_tag_publication.py"
+            cli_env = {
+                **os.environ,
+                "AIOS_GITOPS_AUTHORITATIVE_GIT_DIR": str(authoritative),
+                "AIOS_GITOPS_REPOSITORY_IDENTITY": "aios/aios",
+            }
+            result = subprocess.run(
+                [
+                    sys.executable,
+                    str(module),
+                    "publish",
+                    "--workspace",
+                    str(root),
+                    "--version",
+                    "V9R9C9",
+                    "--target-oid",
+                    target,
+                    "--evidence-closure-oid",
+                    evidence,
+                    "--approval-plan-id",
+                    "owner-plan",
+                    "--gitea-api",
+                    "http://127.0.0.1:1/api/v1",
+                    "--gitea-repo",
+                    "aios/aios",
+                    "--gitea-token-file",
+                    str(root / "missing-token"),
+                ],
+                text=True,
+                capture_output=True,
+                env=cli_env,
+            )
+            self.assertEqual(result.returncode, 2)
+            self.assertIn("evidence lineage mismatch", result.stdout)
+
+    def test_release_script_uses_shared_lineage_validation(self):
+        script = (ROOT / "scripts" / "release_version.sh").read_text(encoding="utf-8")
+        self.assertIn("gitea_tag_publication.py\" publish", script)
+        self.assertNotIn("merge-base --is-ancestor", script)
+
+    def test_error_redaction_hides_authorization_and_token_values(self):
+        from gitea_tag_publication import redact
+
+        message = redact(
+            "Authorization: Bearer abcdefghijklmnop token=super-secret "
+            "https://user:password@example.invalid/repo.git"
+        )
+        self.assertNotIn("abcdefghijklmnop", message)
+        self.assertNotIn("super-secret", message)
+        self.assertNotIn("password", message)
+
+    def test_remote_parser_requires_annotated_tag_object_and_peeled_target(self):
+        backend = GitTagBackend(Path("."))
+        with (
+            patch.object(backend, "_network_remote_url", return_value="ssh://gitea/repo"),
+            patch.object(
+                backend,
+                "run",
+                return_value=(
+                    f"{TAG_OID}\trefs/tags/V9R9C9\n"
+                    f"{TARGET}\trefs/tags/V9R9C9^{{}}"
+                ),
+            ),
+        ):
+            self.assertEqual(backend.remote_tag("gitea", "V9R9C9"), (TAG_OID, TARGET))
+        with (
+            patch.object(backend, "_network_remote_url", return_value="ssh://gitea/repo"),
+            patch.object(
+                backend,
+                "run",
+                return_value=f"{TARGET}\trefs/tags/V9R9C9",
+            ),
+            self.assertRaises(PublicationConflict),
+        ):
+            backend.remote_tag("gitea", "V9R9C9")
+
+    def test_local_path_remote_cannot_count_as_gitea(self):
+        backend = GitTagBackend(Path("."))
+        with (
+            patch.object(backend, "run", return_value="/data/aios-gitops/repo.git"),
+            self.assertRaises(PublicationConflict),
+        ):
+            backend._network_remote_url("origin")
+
+    def test_process_config_remote_url_is_resolved_for_subprocesses(self):
+        backend = GitTagBackend(Path("."))
+        with (
+            patch.object(backend, "run", side_effect=RuntimeError("no such remote")),
+            patch.dict(
+                os.environ,
+                {
+                    "GIT_CONFIG_COUNT": "1",
+                    "GIT_CONFIG_KEY_0": "remote.gitea-local.url",
+                    "GIT_CONFIG_VALUE_0": "http://127.0.0.1:3000/aios/aios.git",
+                },
+                clear=False,
+            ),
+        ):
+            self.assertEqual(
+                backend._network_remote_url("gitea-local"),
+                "http://127.0.0.1:3000/aios/aios.git",
+            )
+
+    def test_gitea_lookup_and_listing_use_authenticated_api(self):
+        with tempfile.TemporaryDirectory() as td:
+            token = Path(td) / "token"
+            token.write_text("test-token", encoding="utf-8")
+            client = GiteaTagClient("https://gitea.invalid/api/v1", "aios/aios", token)
+            paths = []
+
+            def fake_get(path):
+                paths.append(path)
+                if "/git/refs/tags/" in path:
+                    return {"object": {"type": "tag", "sha": TAG_OID}}
+                if "/git/tags/" in path:
+                    return {"object": {"type": "commit", "sha": TARGET}}
+                return [{"name": "V9R9C9", "commit": {"sha": TARGET}}]
+
+            with patch.object(client, "_get", side_effect=fake_get):
+                self.assertEqual(client.lookup_tag("V9R9C9"), (TAG_OID, TARGET))
+                self.assertTrue(client.tag_visible_in_listing("V9R9C9", TARGET))
+            self.assertTrue(any("/git/refs/tags/" in path for path in paths))
+            self.assertTrue(any("/tags?limit=" in path for path in paths))
+
+
+if __name__ == "__main__":
+    unittest.main()
@@ -0,0 +1,153 @@
+from __future__ import annotations
+
+import json
+import os
+import subprocess
+import sys
+import tempfile
+import unittest
+import urllib.request
+import uuid
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+sys.path.insert(0, str(ROOT / "active-runtime" / "app"))
+
+from gitea_tag_publication import (  # noqa: E402
+    GiteaTagClient,
+    GitTagBackend,
+    PublicationRequest,
+)
+
+
+@unittest.skipUnless(
+    os.getenv("AIOS_GITOPS_LIVE_GITEA_TEST") == "1",
+    "set AIOS_GITOPS_LIVE_GITEA_TEST=1 on the isolated writer host",
+)
+class LiveTemporaryGiteaIntegrationTest(unittest.TestCase):
+    def test_authenticated_ref_api_and_listing_against_temporary_repository(self):
+        api_url = os.getenv(
+            "AIOS_GITOPS_GITEA_API_URL", "http://127.0.0.1:3000/api/v1"
+        ).rstrip("/")
+        credential = Path(
+            os.getenv(
+                "AIOS_GITOPS_LIVE_GITEA_TOKEN_FILE",
+                os.getenv(
+                    "AIOS_GITOPS_GITEA_TOKEN_FILE",
+                "/etc/aios-gitops/credentials/gitea-git-http",
+                ),
+            )
+        )
+        token_line = int(os.getenv("AIOS_GITOPS_LIVE_GITEA_TOKEN_LINE", "1"))
+        token = credential.read_text(encoding="utf-8").splitlines()[token_line - 1].strip()
+        name = "tag-atomicity-integration-" + uuid.uuid4().hex[:12]
+        owner = os.getenv("AIOS_GITOPS_LIVE_GITEA_OWNER", "gitops-bot")
+
+        def api_request(method: str, path: str, payload=None):
+            body = (
+                json.dumps(payload).encode("utf-8") if payload is not None else None
+            )
+            request = urllib.request.Request(
+                api_url + path,
+                data=body,
+                method=method,
+                headers={
+                    "Accept": "application/json",
+                    "Content-Type": "application/json",
+                    "Authorization": f"token {token}",
+                },
+            )
+            with urllib.request.urlopen(request, timeout=15) as response:
+                raw = response.read()
+                return json.loads(raw.decode("utf-8")) if raw else None
+
+        created = False
+        try:
+            repository = api_request(
+                "POST",
+                "/user/repos",
+                {"name": name, "private": True, "auto_init": False},
+            )
+            created = True
+            self.assertEqual(repository["full_name"], f"{owner}/{name}")
+            with tempfile.TemporaryDirectory() as td:
+                work = Path(td)
+                subprocess.run(["git", "init", "-q", "-b", "patch/live"], cwd=work, check=True)
+                subprocess.run(
+                    ["git", "config", "user.email", "gitops-test@example.invalid"],
+                    cwd=work,
+                    check=True,
+                )
+                subprocess.run(
+                    ["git", "config", "user.name", "gitops-integration"],
+                    cwd=work,
+                    check=True,
+                )
+                (work / "release").write_text("target\n", encoding="utf-8")
+                subprocess.run(["git", "add", "release"], cwd=work, check=True)
+                subprocess.run(
+                    ["git", "commit", "-q", "-m", "target"], cwd=work, check=True
+                )
+                target = subprocess.check_output(
+                    ["git", "rev-parse", "HEAD"], cwd=work, text=True
+                ).strip()
+                (work / "evidence").write_text("closure\n", encoding="utf-8")
+                subprocess.run(["git", "add", "evidence"], cwd=work, check=True)
+                subprocess.run(
+                    ["git", "commit", "-q", "-m", "evidence"], cwd=work, check=True
+                )
+                evidence = subprocess.check_output(
+                    ["git", "rev-parse", "HEAD"], cwd=work, text=True
+                ).strip()
+                remote_url = f"http://127.0.0.1:3000/{owner}/{name}.git"
+                subprocess.run(["git", "remote", "add", "gitea", remote_url], cwd=work, check=True)
+                username_file = work / ".fixture-user"
+                username_file.write_text(owner + "\n", encoding="utf-8")
+                askpass = work / ".fixture-askpass"
+                askpass.write_text(
+                    "#!/bin/sh\n"
+                    'case \"$1\" in\n'
+                    f'  *Username*) sed -n 1p "{username_file}" ;;\n'
+                    f'  *) sed -n {token_line}p "{credential}" ;;\n'
+                    "esac\n",
+                    encoding="utf-8",
+                )
+                askpass.chmod(0o700)
+                git_env = {
+                    **os.environ,
+                    "GIT_ASKPASS": str(askpass),
+                    "GIT_TERMINAL_PROMPT": "0",
+                }
+                subprocess.run(
+                    ["git", "push", "gitea", "HEAD:refs/heads/patch/live"],
+                    cwd=work,
+                    check=True,
+                    capture_output=True,
+                    text=True,
+                    env=git_env,
+                )
+                version = "V0R0C1-LIVE-" + uuid.uuid4().hex[:8]
+                release = PublicationRequest(version, target, evidence, "live-integration")
+                backend = GitTagBackend(work)
+                os.environ["GIT_ASKPASS"] = str(askpass)
+                os.environ["GIT_TERMINAL_PROMPT"] = "0"
+                backend.validate_evidence_lineage(release)
+                tag_oid, peeled = backend.ensure_local_annotated_tag(release)
+                backend.push_tag("gitea", version)
+                self.assertEqual(backend.remote_tag("gitea", version), (tag_oid, peeled))
+                client = GiteaTagClient(
+                    api_url,
+                    f"{owner}/{name}",
+                    credential,
+                    token_line=token_line,
+                )
+                self.assertEqual(client.repository_identity(), f"{owner}/{name}")
+                self.assertEqual(client.lookup_tag(version), (tag_oid, target))
+                self.assertTrue(client.tag_visible_in_listing(version, target))
+        finally:
+            if created:
+                api_request("DELETE", f"/repos/{owner}/{name}")
+
+
+if __name__ == "__main__":
+    unittest.main()
@@ -0,0 +1,369 @@
+from __future__ import annotations
+
+import json
+import sys
+import tempfile
+import unittest
+from dataclasses import replace
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+sys.path.insert(0, str(ROOT / "active-runtime" / "app"))
+
+from silent_release_controller import (  # noqa: E402
+    AcceptanceEvidence,
+    ApprovalEnvelope,
+    ApprovalError,
+    ApprovalLedger,
+    DeploymentController,
+    DuplicateTagConflict,
+    ReleaseAcceptanceEngine,
+    ReleaseCandidate,
+    ReleaseCandidateStore,
+    ReleaseState,
+    SilentReleaseController,
+    SilentReleasePolicy,
+    TagApprovalEnvelope,
+    TagController,
+    redact,
+)
+
+
+COMMIT = "1" * 40
+TREE = "2" * 40
+ARTIFACT = "3" * 64
+MANIFEST = "4" * 64
+TAG_OID = "5" * 40
+TARGET = "6" * 40
+
+
+def candidate() -> ReleaseCandidate:
+    return ReleaseCandidate(
+        candidate_id="rc-20260723-001",
+        source_commit=COMMIT,
+        tree_oid=TREE,
+        artifact_sha256=ARTIFACT,
+        manifest_sha256=MANIFEST,
+    )
+
+
+def passing_evidence() -> AcceptanceEvidence:
+    return AcceptanceEvidence(
+        local_main_oid=COMMIT,
+        bare_main_oid=COMMIT,
+        gitea_main_oid=COMMIT,
+        repository_identity="aios/aios",
+        artifact_sha256=ARTIFACT,
+        manifest_sha256=MANIFEST,
+        manifest_source_commit=COMMIT,
+        manifest_tree_oid=TREE,
+        tests={"passed": True, "summary": "81 passed"},
+        canary={
+            "passed": True,
+            "runtime_without_git": True,
+            "writes_enabled": False,
+        },
+        rollback_ready=True,
+        authoritative_git_dir="/data/aios-gitops/repo.git",
+        authoritative_git_readable=True,
+    )
+
+
+class FakeProbe:
+    def __init__(self, evidence=None, error=None):
+        self.evidence = evidence or passing_evidence()
+        self.error = error
+        self.calls = 0
+
+    def collect(self, release_candidate):
+        self.calls += 1
+        if self.error:
+            raise self.error
+        return self.evidence
+
+
+class FakeBuilder:
+    def __init__(self):
+        self.calls = 0
+
+    def build(self, source_commit):
+        self.calls += 1
+        self.source_commit = source_commit
+        return candidate()
+
+
+class FakeDeployment:
+    def __init__(self, health=True, restart_error=None):
+        self.health = health
+        self.restart_error = restart_error
+        self.switched = 0
+        self.restarted = 0
+        self.rolled_back = 0
+
+    def atomic_switch(self, release_candidate):
+        self.switched += 1
+        return {"previous_target": "old", "new_target": release_candidate.candidate_id}
+
+    def restart(self):
+        self.restarted += 1
+        if self.restart_error:
+            raise self.restart_error
+
+    def health_check(self, release_candidate):
+        return {
+            "passed": self.health,
+            "runtime_commit": release_candidate.source_commit,
+            "writes_enabled": False,
+            "authoritative_head_oid": release_candidate.source_commit,
+            "repository_identity": "aios/aios",
+        }
+
+    def rollback(self, switch_evidence):
+        self.rolled_back += 1
+        return {"passed": True, "writes_enabled": False}
+
+
+class FakeTagAdapter:
+    def __init__(self):
+        self.current = None
+        self.creates = 0
+
+    def lookup(self, version):
+        return self.current
+
+    def create(self, version, tag_oid, target_oid):
+        self.creates += 1
+        self.current = (tag_oid, target_oid)
+
+    def verify(self, version):
+        return self.current
+
+
+class SilentReleaseControllerTests(unittest.TestCase):
+    def test_top_level_controller_automates_prepare_then_waits_for_owner(self):
+        builder = FakeBuilder()
+        with tempfile.TemporaryDirectory() as td:
+            store = ReleaseCandidateStore(Path(td) / "candidates")
+            controller = SilentReleaseController(
+                builder=builder,
+                acceptance=ReleaseAcceptanceEngine(
+                    FakeProbe(), expected_repository="aios/aios"
+                ),
+                deployment=DeploymentController(
+                    FakeDeployment(),
+                    ApprovalLedger(Path(td) / "approvals"),
+                    SilentReleasePolicy.default(),
+                    store,
+                    allow_legacy_unsigned_approval=True,
+                ),
+                store=store,
+                policy=SilentReleasePolicy.default(),
+            )
+            prepared = controller.prepare(COMMIT)
+            self.assertEqual(builder.calls, 1)
+            self.assertEqual(prepared.state, ReleaseState.READY_FOR_APPROVAL)
+            self.assertEqual(prepared.approval_state, "PENDING")
+            self.assertEqual(
+                store.load(prepared.candidate_id).state,
+                ReleaseState.READY_FOR_APPROVAL,
+            )
+
+    def test_candidate_model_round_trips_and_enforces_state_machine(self):
+        value = candidate()
+        self.assertEqual(value.state, ReleaseState.BUILDING)
+        value.transition(ReleaseState.VERIFYING)
+        restored = ReleaseCandidate.from_dict(value.to_dict())
+        self.assertEqual(restored.state, ReleaseState.VERIFYING)
+        with self.assertRaisesRegex(ValueError, "invalid release transition"):
+            restored.transition(ReleaseState.VERIFIED)
+
+    def test_acceptance_engine_moves_verified_candidate_to_ready(self):
+        value = candidate()
+        result = ReleaseAcceptanceEngine(
+            FakeProbe(), expected_repository="aios/aios"
+        ).evaluate(value)
+        self.assertTrue(result.ready)
+        self.assertEqual(value.state, ReleaseState.READY_FOR_APPROVAL)
+        self.assertTrue(value.rollback_ready)
+        self.assertTrue(value.tests["passed"])
+        self.assertTrue(value.canary["runtime_without_git"])
+        self.assertEqual(value.git_consistency["bare_main_oid"], COMMIT)
+        self.assertEqual(value.gitea_consistency["main_oid"], COMMIT)
+
+    def test_artifact_mismatch_fails_closed(self):
+        evidence = replace(passing_evidence(), artifact_sha256="9" * 64)
+        value = candidate()
+        result = ReleaseAcceptanceEngine(
+            FakeProbe(evidence), expected_repository="aios/aios"
+        ).evaluate(value)
+        self.assertFalse(result.ready)
+        self.assertEqual(value.state, ReleaseState.FAILED)
+        self.assertIn("artifact_sha256", result.failed_checks)
+
+    def test_gitea_unavailable_fails_closed(self):
+        value = candidate()
+        result = ReleaseAcceptanceEngine(
+            FakeProbe(error=RuntimeError("GITEA_UNAVAILABLE")),
+            expected_repository="aios/aios",
+        ).evaluate(value)
+        self.assertFalse(result.ready)
+        self.assertEqual(value.state, ReleaseState.FAILED)
+        self.assertIn("GITEA_UNAVAILABLE", value.failure_reason)
+
+    def test_git_unavailable_fails_closed(self):
+        value = candidate()
+        result = ReleaseAcceptanceEngine(
+            FakeProbe(error=RuntimeError("AUTHORITATIVE_GIT_UNAVAILABLE")),
+            expected_repository="aios/aios",
+        ).evaluate(value)
+        self.assertFalse(result.ready)
+        self.assertEqual(value.state, ReleaseState.FAILED)
+        self.assertIn("AUTHORITATIVE_GIT_UNAVAILABLE", value.failure_reason)
+
+    def test_runtime_with_git_metadata_is_rejected(self):
+        evidence = replace(
+            passing_evidence(),
+            canary={"passed": True, "runtime_without_git": False},
+        )
+        value = candidate()
+        result = ReleaseAcceptanceEngine(
+            FakeProbe(evidence), expected_repository="aios/aios"
+        ).evaluate(value)
+        self.assertFalse(result.ready)
+        self.assertIn("runtime_without_git", result.failed_checks)
+
+    def test_runtime_switch_requires_one_bound_owner_approval(self):
+        value = candidate()
+        ReleaseAcceptanceEngine(
+            FakeProbe(), expected_repository="aios/aios"
+        ).evaluate(value)
+        envelope = ApprovalEnvelope.for_candidate(
+            value,
+            approval_id="approval-001",
+            owner_id="owner",
+            expires_at="2099-01-01T00:00:00Z",
+        )
+        with tempfile.TemporaryDirectory() as td:
+            deployment = FakeDeployment()
+            controller = DeploymentController(
+                deployment,
+                ApprovalLedger(Path(td) / "approvals"),
+                SilentReleasePolicy.default(),
+                allow_legacy_unsigned_approval=True,
+            )
+            result = controller.deploy(value, envelope)
+            self.assertEqual(value.state, ReleaseState.VERIFIED)
+            self.assertTrue(result["verified"])
+            self.assertEqual(deployment.switched, 1)
+            self.assertEqual(deployment.restarted, 1)
+            self.assertEqual(deployment.rolled_back, 0)
+
+    def test_failed_health_check_rolls_back(self):
+        value = candidate()
+        ReleaseAcceptanceEngine(
+            FakeProbe(), expected_repository="aios/aios"
+        ).evaluate(value)
+        envelope = ApprovalEnvelope.for_candidate(
+            value,
+            approval_id="approval-rollback",
+            owner_id="owner",
+            expires_at="2099-01-01T00:00:00Z",
+        )
+        with tempfile.TemporaryDirectory() as td:
+            deployment = FakeDeployment(health=False)
+            result = DeploymentController(
+                deployment,
+                ApprovalLedger(Path(td) / "approvals"),
+                SilentReleasePolicy.default(),
+                allow_legacy_unsigned_approval=True,
+            ).deploy(value, envelope)
+            self.assertFalse(result["verified"])
+            self.assertEqual(value.state, ReleaseState.ROLLED_BACK)
+            self.assertEqual(deployment.rolled_back, 1)
+
+    def test_approval_replay_is_rejected(self):
+        value = candidate()
+        ReleaseAcceptanceEngine(
+            FakeProbe(), expected_repository="aios/aios"
+        ).evaluate(value)
+        envelope = ApprovalEnvelope.for_candidate(
+            value,
+            approval_id="approval-replay",
+            owner_id="owner",
+            expires_at="2099-01-01T00:00:00Z",
+        )
+        with tempfile.TemporaryDirectory() as td:
+            ledger = ApprovalLedger(Path(td) / "approvals")
+            controller = DeploymentController(
+                FakeDeployment(),
+                ledger,
+                SilentReleasePolicy.default(),
+                allow_legacy_unsigned_approval=True,
+            )
+            controller.deploy(value, envelope)
+            second = candidate()
+            ReleaseAcceptanceEngine(
+                FakeProbe(), expected_repository="aios/aios"
+            ).evaluate(second)
+            with self.assertRaisesRegex(ApprovalError, "already consumed"):
+                controller.deploy(second, envelope)
+
+    def test_tag_controller_is_separate_and_rejects_duplicate_conflict(self):
+        adapter = FakeTagAdapter()
+        adapter.current = (TAG_OID, TARGET)
+        controller = TagController(
+            adapter,
+            SilentReleasePolicy.default(),
+            ledger=None,
+            allow_legacy_unsigned_approval=True,
+        )
+        envelope = TagApprovalEnvelope(
+            approval_id="tag-approval-001",
+            owner_id="owner",
+            version="V9R9C9",
+            tag_oid="7" * 40,
+            target_oid=TARGET,
+            action="production_tag",
+            expires_at="2099-01-01T00:00:00Z",
+        )
+        approved = controller.approve(envelope)
+        with self.assertRaises(DuplicateTagConflict):
+            controller.execute(approved)
+        self.assertEqual(adapter.creates, 0)
+
+    def test_policy_separates_automatic_owner_and_forbidden_actions(self):
+        policy = SilentReleasePolicy.default()
+        self.assertTrue(policy.is_automatic("canary"))
+        self.assertTrue(policy.requires_owner("production_runtime_switch"))
+        self.assertTrue(policy.requires_owner("production_tag"))
+        self.assertTrue(policy.is_forbidden("force_push"))
+        self.assertTrue(policy.is_forbidden("tag_rewrite"))
+        self.assertTrue(policy.is_forbidden("direct_main_push"))
+        self.assertTrue(policy.is_forbidden("baseline_mutation"))
+        self.assertTrue(policy.is_forbidden("registry_mutation"))
+
+    def test_redaction_removes_credentials_from_errors(self):
+        message = (
+            "Authorization: Bearer super-secret-token "
+            "https://bot:password@example.invalid/repo.git token=another-secret"
+        )
+        safe = redact(message)
+        self.assertNotIn("super-secret-token", safe)
+        self.assertNotIn("password", safe)
+        self.assertNotIn("another-secret", safe)
+        self.assertIn("REDACTED", safe)
+
+    def test_candidate_store_persists_without_secret_fields(self):
+        value = candidate()
+        value.tests = {"passed": True, "Authorization": "Bearer hidden"}
+        with tempfile.TemporaryDirectory() as td:
+            store = ReleaseCandidateStore(Path(td))
+            store.save(value)
+            raw = store.path(value.candidate_id).read_text(encoding="utf-8")
+            self.assertNotIn("Bearer hidden", raw)
+            loaded = store.load(value.candidate_id)
+            self.assertEqual(loaded.candidate_id, value.candidate_id)
+
+
+if __name__ == "__main__":
+    unittest.main()
@@ -0,0 +1,16 @@
+#!/usr/bin/env python3
+import importlib.util
+import sys
+from pathlib import Path
+
+if len(sys.argv) != 3:
+    raise SystemExit('usage: run_online_smoke_18920.py <source-root> <output>')
+source_root = Path(sys.argv[1]).resolve()
+script = source_root / 'tools' / 'aios_v2r1c2_online_smoke.py'
+spec = importlib.util.spec_from_file_location('v2r1c2_online_smoke_production', script)
+if spec is None or spec.loader is None:
+    raise SystemExit('unable to load approved online smoke harness')
+module = importlib.util.module_from_spec(spec)
+spec.loader.exec_module(module)
+module.BASE = 'http://127.0.0.1:18920'
+raise SystemExit(module.main(sys.argv[2]))
@@ -0,0 +1,55 @@
+{
+  "version": "V2R1C1",
+  "codename": "openclaw-command-v2-production-baseline",
+  "status": "PRODUCTION_DEPLOYED",
+  "tag": "V2R1C1",
+  "tag_ref": "refs/tags/V2R1C1",
+  "tag_object": "4e0e6dcb90e6732aa9838fe9d0af0b34746829b0",
+  "previous_version": "V1R4C6",
+  "rollback_version": "V1R4C6",
+  "baseline": "V1R4C6",
+  "release_reason": "Register the already deployed AIOS V2R1C1 release, immutable tag, OpenClaw Command v2 companion, and final production evidence in the central GitOps Registry.",
+  "purpose": "Close the central version-governance gap without changing product implementation, the V2R1C1 tag, production release, deployment, or traffic.",
+  "changes": [
+    "governance: add the canonical V2R1C1 version manifest",
+    "governance: advance the central baseline pointer from V1R4C6 to V2R1C1",
+    "governance: link release, companion, artifact, validation, and final audit evidence"
+  ],
+  "artifacts": [
+    "docs/releases/V2R1C1-BASELINE-CLOSURE.md",
+    ".agent/results/releases/V2R1C1-BASELINE-CLOSURE.json",
+    ".agent/results/releases/V2R1C1-BASELINE-CLOSURE.md",
+    "/var/lib/aios-gitops/acceptance/aios-v2r1c1-openclaw-v2-companion-20260721T094442Z"
+  ],
+  "validated_actions": [
+    "release and tag OID equality",
+    "local and Gitea ref synchronization",
+    "OpenClaw Command v2 positive and negative validation",
+    "Gate A and Gate B",
+    "Hermes lifecycle 17/17",
+    "grant isolation 11/11",
+    "restart recovery",
+    "rollback and forward recovery",
+    "SQLite quick_check",
+    "secret scan with zero violations",
+    "final production healthcheck"
+  ],
+  "secret_plaintext_written": false,
+  "owner_approval_required": true,
+  "owner_notification_channels": [
+    "codex_owner_instruction",
+    "gitops_audit"
+  ],
+  "constraints_original": {
+    "product_code_changed": false,
+    "tag_changed": false,
+    "production_redeployed": false,
+    "production_traffic_changed": false,
+    "force_push_allowed": false,
+    "incubator_in_release_graph": false
+  },
+  "promoted_at": "2026-07-21T14:17:05Z",
+  "promoted_by": "chatgpt/owner-approved-governance",
+  "created_at": "2026-07-21T14:17:05Z",
+  "author": "chatgpt"
+}
@@ -0,0 +1,47 @@
+{
+  "version": "V2R1C2",
+  "codename": "unified-role-aware-portal",
+  "status": "PRODUCTION_DEPLOYED",
+  "tag": "V2R1C2",
+  "tag_ref": "refs/tags/V2R1C2",
+  "tag_object": "a3bd84ebec9c705f7c9c5c03f7f4ec55f8854e36",
+  "target_oid": "3dd622b5a515f1fa4ef72b9f8ae9ce48ac703f24",
+  "evidence_closure_oid": "8cdca463aff9707edee00e20a3b56884130f6978",
+  "previous_version": "V2R1C1",
+  "rollback_version": "V2R1C1",
+  "baseline": "V2R1C1",
+  "release_run_id": "AIOS-V2R1C2-PRODUCTION-20260722T011836Z",
+  "release_reason": "Register the Owner-approved V2R1C2 candidate tag and verified evidence before a separately gated production promotion.",
+  "candidate_url": "http://127.0.0.1:18921",
+  "production_url": "http://127.0.0.1:18920",
+  "aggregate_gate": "PASS",
+  "required_stages": "3/3 SUCCEEDED",
+  "evidence_status": "COMPLETE",
+  "wechat_acceptance": "SYNTHETIC_ONLY",
+  "real_user_wechat_accepted": false,
+  "evidence_manifest_sha256": "2e27bb73b8e6297bd3077238f73a96d697fc3c3611c601c4dc9357e5fdcd8eee",
+  "evidence_checksums_sha256": "3dcedaff367d5d1a114640d8918304d1c39154d38b078f7f0b097a95d43978be",
+  "prepromotion_acceptance_sha256": "402e9ce7690654ea7fd493985284446365a827b61fe195576dc7f4e4d4499ef7",
+  "audited_tag_plan": "nl-1784681185786-19ac0f82",
+  "owner_release_authorization": "GRANTED",
+  "production_acceptance_sha256": "a6c35e12cab7907ab6bcfd37d781b3d216f05a5ae002aa54a3112c70f43b991a",
+  "production_online_smoke_sha256": "fe9c6964e440f8871f2eb225f0132f70c634923389f7b8dfa85f615b100980a4",
+  "production_evidence_index": "/var/lib/aios-gitops/acceptance/AIOS-V2R1C2-PRODUCTION-20260722T011836Z/production-evidence.sha256",
+  "production_health_sha256": "ee8084e8b57d188dc0039a276f4f3f1ed7025ff58ce91b111cc765627eb52d4c",
+  "production_service": "aios-v2r1c2-production.service",
+  "production_promoted": true,
+  "main_changed_by_tag": false,
+  "main_changed_by_authorized_registry": true,
+  "force_push": false,
+  "constraints": {
+    "tag_rewrite_allowed": false,
+    "force_push_allowed": false,
+    "rollback_assets_must_be_preserved": true,
+    "production_promotion_requires_fresh_acceptance": true
+  },
+  "registered_at": "2026-07-22T01:18:36Z",
+  "promoted_at": "2026-07-22T01:40:51Z",
+  "updated_at": "2026-07-22T01:43:15Z",
+  "registered_by": "codex/owner-approved-gitops",
+  "promoted_by": "codex/owner-approved-gitops"
+}
Author	SHA1	Message	Date
chatgpt-gitops-bot	c2525ecd51	feat(gitops): harden one-approval silent release saga	2026-07-23 23:39:47 +08:00
chatgpt-gitops-bot	dad45ab32b	feat(gitops): add silent release controller	2026-07-23 22:49:54 +08:00
gitops-bot	238742150b	Merge pull request 'merge(gitops): bind runtime APIs to authoritative repository' (#11 ) from patch/runtime-authoritative-git-context-20260723 into main	2026-07-23 20:35:05 +08:00
chatgpt-gitops-bot	04865315a3	fix-gitops-bind-diff-and-publisher-to-authoritative-repository	2026-07-23 19:50:28 +08:00
chatgpt-gitops-bot	8e72dc22d6	fix-gitops-authoritative-cli-publication	2026-07-23 19:04:41 +08:00
chatgpt-gitops-bot	79ac5abac2	fix(gitops): bind runtime reads to authoritative repository	2026-07-23 18:51:53 +08:00
gitops-bot	655c69fc4b	merge(gitops): enforce fail-closed Gitea tag publication atomicity Source: patch/gitea-tag-publication-atomicity-20260723 Source commit: `63e0b8e705` Target base: `b739fbb5ec` Production deployment: not authorized Production tag operations: not authorized	2026-07-23 16:26:45 +08:00
ChatGPT Release Governance	63e0b8e705	chore(gitops): regenerate atomicity delivery manifest	2026-07-23 16:06:26 +08:00
ChatGPT Release Governance	edfad05d57	fix(gitops): align publication state contract	2026-07-23 16:05:00 +08:00
ChatGPT Release Governance	e40c05779c	fix-gitops-reject-publication-state-path-traversal	2026-07-23 14:57:07 +08:00
ChatGPT Release Governance	a3edc628a9	fix-serialize-duplicate-tag-publications	2026-07-23 14:38:27 +08:00
ChatGPT Release Governance	f4b6ac8609	test-reject-secrets-in-incident-record	2026-07-23 14:36:27 +08:00
ChatGPT Release Governance	83ab67f7e1	fix-git-process-configured-gitea-remote	2026-07-23 14:15:27 +08:00
ChatGPT Release Governance	27a0ae126b	fix-gitops-close-tag-publication-governance-gaps	2026-07-23 14:11:23 +08:00
ChatGPT Release Governance	54093d1543	chore(gitops): verify isolated writer branch	2026-07-23 12:59:13 +08:00
Codex GitOps Repair	3196d91b12	fix(gitops): preserve existing isolated branches	2026-07-23 12:58:32 +08:00
Codex GitOps Repair	3812e1ab01	fix(gitops): make Gitea tag publication fail closed	2026-07-23 12:57:41 +08:00
ChatGPT Release Governance	fc0b9f29bf	chore(gitops): create isolated gitea tag atomicity patch	2026-07-23 12:43:25 +08:00
ChatGPT Release Governance	b739fbb5ec	merge-V2R1C2-documentation-closure	2026-07-22 09:53:12 +08:00
ChatGPT Release Governance	02658d2329	clarify-synthetic-wechat-and-evidence-index	2026-07-22 09:52:56 +08:00
ChatGPT Release Governance	75efdef2d2	merge-V2R1C2-production-baseline	2026-07-22 09:48:07 +08:00
ChatGPT Release Governance	3584628cfe	finalize-V2R1C2-production-registry	2026-07-22 09:45:10 +08:00
ChatGPT Release Governance	181dc54b9f	merge-V2R1C2-transactional-acceptance-wrapper	2026-07-22 09:40:29 +08:00
ChatGPT Release Governance	ed7adc6c23	add-transactional-production-acceptance-wrapper	2026-07-22 09:40:11 +08:00
ChatGPT Release Governance	6e3a8ac11a	merge-V2R1C2-prepare-readiness-fix	2026-07-22 09:37:03 +08:00
ChatGPT Release Governance	dd352a79d1	wait-for-candidate-readiness-after-state-copy	2026-07-22 09:36:48 +08:00
ChatGPT Release Governance	abe17f4aec	merge-V2R1C2-production-assets	2026-07-22 09:35:25 +08:00
ChatGPT Release Governance	6d61929055	harden-V2R1C2-state-copy-and-final-gates	2026-07-22 09:35:04 +08:00
ChatGPT Release Governance	c4f9c8a5ca	add-V2R1C2-production-switch-and-rollback	2026-07-22 09:29:12 +08:00
ChatGPT Release Governance	9975453f50	merge-V2R1C2-tag-action-fix	2026-07-22 09:23:24 +08:00
ChatGPT Release Governance	26d81a9f34	merge-V2R1C2-registry	2026-07-22 09:22:33 +08:00
ChatGPT Release Governance	af2a1f39bc	register-V2R1C2-tagged-candidate	2026-07-22 09:19:48 +08:00
ChatGPT Release Governance	151b57100f	fix(gitops): bind release tags to approved target oid	2026-07-22 09:07:11 +08:00
ChatGPT Release Governance	aaf9a2c73f	chore(chatgpt): record nl plan unknown	2026-07-22 08:46:25 +08:00
ChatGPT Release Governance	a281bfeacd	merge(governance): reconcile V2R1C1 Registry with Gitea main	2026-07-21 22:29:06 +08:00
ChatGPT Release Governance	5894142682	merge(governance): register V2R1C1 central baseline	2026-07-21 22:26:23 +08:00
ChatGPT Release Governance	602cc9ee28	docs(release): record V2R1C1 baseline closure evidence	2026-07-21 22:24:40 +08:00
ChatGPT Release Governance	6dbd5cbe07	chore(baseline): advance central baseline to V2R1C1	2026-07-21 22:18:40 +08:00
ChatGPT Release Governance	a56caf46f6	chore(release): register V2R1C1 version manifest	2026-07-21 22:18:40 +08:00
openclaw	41e21ff5fe	result(openclaw): B3 evidence hardening completed See result/openclaw/v2r1-personal-weixin-b3-evidence-hardening-20260716T133000UTC8 for the result branch containing the implementation.	2026-07-16 15:39:19 +08:00
openclaw	b05eb1babe	task(codex): execute isolated worktree migration 20260715T001652UTC8	2026-07-15 00:17:28 +08:00
openclaw	a8581699f2	task(openclaw): migrate GitOps to isolated worktrees 20260714T233742UTC8	2026-07-14 23:32:52 +08:00
openclaw	cc9cada5df	feat(gitops): add unified systemd runtime identity drop-in	2026-07-14 23:32:18 +08:00
openclaw	dbed29c8c7	feat(gitops): add task environment preflight	2026-07-14 23:32:12 +08:00
openclaw	24f7e4ecc3	feat(gitops): add per-task worktree lifecycle script	2026-07-14 23:31:59 +08:00
openclaw	b588bf8fb2	feat(gitops): add isolated worktree bootstrap script	2026-07-14 23:31:43 +08:00
openclaw	f300033138	fix(gitops): correct default ACL runtime user	2026-07-14 23:31:32 +08:00
openclaw	7308c9c0c1	feat(gitops): add isolated worktree governance policy	2026-07-14 23:31:21 +08:00
openclaw	48290bd620	chore(gitops): start isolated worktree and unified identity governance	2026-07-14 23:30:07 +08:00