test(openclaw): make tenant-boundary hook compatibility executable

docs(v2r1): isolate gateway receipt journals
docs(v2r1): finalize executable release contracts
2026-07-14 05:29:29 +08:00 · 2026-07-14 04:45:31 +08:00 · 2026-07-14 04:36:13 +08:00 · 2026-07-14 04:18:06 +08:00 · 2026-07-14 04:02:35 +08:00 · 2026-07-14 03:16:08 +08:00
146 changed files with 4671 additions and 25659 deletions
@@ -1,62 +0,0 @@
-# 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.
@@ -1,88 +0,0 @@
-{
-  "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
-  }
-}
@@ -1,43 +0,0 @@
-# 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`
@@ -1,28 +0,0 @@
-{
-  "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,267 +0,0 @@
-# 执行 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和回滚能力，生产业务未变化。
-```
@@ -11,3 +11,7 @@ runtime/tmp/
 runtime/cache/
 logs/
 config/test_write_perms
+/data/webops.sqlite3
+/data/webops.sqlite3-wal
+/data/webops.sqlite3-shm
+/data/webops.sqlite3-journal
@@ -1 +1 @@
-V2R1C2
+V1R4C6
@@ -5,59 +5,8 @@ from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
 from pathlib import Path
 from typing import Any

-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,
-)
+sys.path.insert(0, str(Path(os.getenv('AIOS_GITOPS_WORKSPACE', '/data/aios-gitops/workspace')) / 'runtime' / 'agent-os'))
 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')))
@@ -67,19 +16,6 @@ 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 = [
@@ -88,43 +24,7 @@ BASE_MODELS = [
  {'id':'base.gpt-5.5','provider':'openai','model':'gpt-5.5','display_name':'GPT-5.5','scope':'global'},
 ]
 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'(?<![A-Za-z0-9_])'
-    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', '/getReleasePlan', '/getReleaseAcceptance',
-    '/getApprovalEnvelope', '/getReleaseSaga', '/getCapabilityStatus',
-    '/getRecoveryStatus',
-})
-SILENT_RELEASE_POST_PATHS = frozenset({
-    '/createReleaseCandidate',
-    '/createReleaseIntent',
-    '/submitSignedApproval',
-    '/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
+SECRET_VAL_RE = re.compile(r'(sk-[A-Za-z0-9_-]{20,}|HPUA[A-Z0-9]{10,}|SDC[A-Za-z0-9]{20,})')

 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]}'
@@ -136,41 +36,6 @@ 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 _build_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,
-    )
-
-# Construct once during service startup. If production execution is enabled
-# without every trusted builder/orchestrator dependency, construction fails
-# closed before the HTTP server accepts traffic.
-_SILENT_RELEASE_SERVICE = _build_silent_release_service()
-
-
-def silent_release_service() -> SilentReleaseActionService:
-    return _SILENT_RELEASE_SERVICE
 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')
@@ -244,13 +109,9 @@ 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)
-    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}')
+    if create or sh(['rev-parse','--verify',b])['code'] != 0:
+        sh(['checkout',base], True); sh(['checkout','-B',b], True)
+    else: sh(['checkout',b], True)
    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')
@@ -260,19 +121,6 @@ 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}')
@@ -282,68 +130,15 @@ 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:
-    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'),
-    )
+    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()}

 def commit(paths, msg):
    ensure_git(); paths = [relpath(p) for p in paths] if paths else ['.']; sh(['add'] + paths, True)
@@ -363,16 +158,6 @@ 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):
@@ -394,236 +179,43 @@ 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
-        if path not in READ_ONLY_GET_PATHS: return self.sendj({'error':'not_found','path':path},404)
-        q=urllib.parse.parse_qs(u.query)
+        u=urllib.parse.urlparse(self.path); path=u.path.rstrip('/') if u.path != '/' else u.path; 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('authoritative_repository', repository_snapshot(
-                    git_dir=AUTHORITATIVE_GIT_DIR,
-                    repository_identity=REPOSITORY_IDENTITY,
-                ))
-                return self.sendj(data)
+                data=jload(WS/'baseline'/'current.json', {}); data.setdefault('git', sh(['rev-parse','--short','HEAD'])['stdout']); return self.sendj(data)
            if path in ('/api/ver','/api/versions','/ver'):
-                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'],
-                })
+                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']})
            if path in ('/api/diff','/diff'):
-                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],
-                })
+                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()})
            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)
-                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)
+                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']})
            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',
-                '/getReleasePlan',
-                '/getReleaseAcceptance',
-                '/getApprovalEnvelope',
-                '/getReleaseSaga',
-                '/getCapabilityStatus',
-            ):
-                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)
-                    )
-                if path == '/getReleasePlan':
-                    return self.sendj(service.get_release_plan(candidate_id))
-                if path == '/getReleaseAcceptance':
-                    return self.sendj(service.get_acceptance(candidate_id))
-                if path == '/getCapabilityStatus':
-                    return self.sendj(
-                        service.get_capability_status(candidate_id)
-                    )
-                return self.sendj(service.get_release_saga(candidate_id))
-            if path == '/getRecoveryStatus':
-                return self.sendj(
-                    silent_release_service().get_recovery_status()
-                )
                        # 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:
-            error=redact(e)
-            monitor.record_failure('do_GET', error, {'path':path})
-            return self.sendj({'error':error},500)
+            monitor.record_failure('do_GET', str(e), {'path':path})
+            return self.sendj({'error':str(e)},500)
    def do_PUT(self):
-        path=urllib.parse.urlparse(self.path).path.rstrip('/')
-        if reject_non_read_http(self, 'PUT', path): return
-        data=self.body()
+        path=urllib.parse.urlparse(self.path).path.rstrip('/'); 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('/')
-        if reject_non_read_http(self, 'POST', path): return
-        data=self.body()
+        path=urllib.parse.urlparse(self.path).path.rstrip('/'); 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 == '/createReleaseIntent':
-                a=self.need('release:candidate')
-                if not a: return
-                return self.sendj(
-                    silent_release_service().create_release_intent(data)
-                )
-            if path in ('/submitOwnerApproval','/submitSignedApproval'):
-                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
-                return self.sendj(
-                    silent_release_service().start_deployment(
-                        str(data.get('candidate_id') or '')
-                    )
-                )
            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)
@@ -634,30 +226,9 @@ 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:
-            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)
+            monitor.record_failure('do_POST', str(e), {'path':path})
+            return self.sendj({'error':str(e)},500)
    def branch(self,data):
        a=self.need('branch:create');
        if not a: return
@@ -681,41 +252,12 @@ 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 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 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 a['role'] != 'owner' or not data.get('execute'):
-            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)
+            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)})
    def rollback(self,data):
        a=self.need('rollback:request');
        if not a: return
@@ -810,10 +352,7 @@ 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')
-        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)
+        tags=sh(['tag','--list','V*'])['stdout'].splitlines() if WS.exists() else []
        versions=[]
        if (WS/'baseline'/'promotions').exists():
            for p in sorted((WS/'baseline'/'promotions').glob('*.json')):
@@ -851,9 +390,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 /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}}
+    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}}

 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()
@@ -1,52 +0,0 @@
-#!/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,316 +0,0 @@
-"""Task-scoped hardened wrapper around the existing Action API."""
-from __future__ import annotations
-
-import json
-import os
-import subprocess
-from pathlib import Path
-import urllib.parse
-
-import aios_chatgpt_actions_api as api
-import aios_isolated_writer_policy as policy
-from isolated_writer_authz import AuthorizationError, authorize
-from isolated_writer_commit_file import AtomicCommitFile, CommitFileError, OperationLedger
-from isolated_writer_token_registry import TokenRegistry
-
-_reject = api.reject_non_read_http
-_write_file = api.write_file
-_sync_branch = api.sync_branch
-_original_do_get = api.H.do_GET
-api.OPENAPI = Path(os.getenv("AIOS_GITOPS_ISOLATED_WRITER_OPENAPI", str(api.OPENAPI)))
-
-
-def _registry() -> TokenRegistry:
-    return TokenRegistry(Path(os.environ["AIOS_GITOPS_TOKEN_REGISTRY_V2"]))
-
-
-def _atomic_writer() -> AtomicCommitFile:
-    return AtomicCommitFile(
-        workspace=api.WS,
-        bare_repo=api.BARE_REPO,
-        ledger=OperationLedger(Path(os.environ["AIOS_GITOPS_WRITER_OPERATION_LEDGER"])),
-        remote=os.getenv("AIOS_GITOPS_GITEA_PUSH_REMOTE", ""),
-        audit=policy.append_audit_record,
-    )
-
-
-def _bearer(handler) -> str:
-    value = handler.headers.get("Authorization", "")
-    return value[7:].strip() if value.startswith("Bearer ") else ""
-
-
-def _authorize(handler, *, method: str, path: str, branch=None, target_path=None):
-    grant = authorize(
-        _registry(),
-        _bearer(handler),
-        method=method,
-        path=path,
-        source_ip=str(handler.client_address[0]),
-        workspace=api.WS,
-        branch=branch,
-        target_path=target_path,
-    )
-    grant.record["_source_ip"] = str(handler.client_address[0])
-    return grant
-
-
-def _authorization_error(handler, exc: AuthorizationError):
-    return handler.sendj({"error": exc.code}, exc.status)
-
-
-def _isolated_runtime_status(handler):
-    branch = api.sh(["rev-parse", "--abbrev-ref", "HEAD"], True)["stdout"]
-    head = api.sh(["rev-parse", "HEAD"], True)["stdout"]
-    return handler.sendj({
-        "service": os.getenv(
-            "AIOS_GITOPS_SERVICE_AUDIENCE",
-            "aios-isolated-writer.service",
-        ),
-        "status": "active",
-        "runtime_role": os.getenv("AIOS_GITOPS_RUNTIME_ROLE"),
-        "workspace_role": os.getenv("AIOS_GITOPS_WORKSPACE_ROLE"),
-        "writes_enabled": os.getenv("AIOS_GITOPS_WRITES_ENABLED", "").lower()
-        in {"1", "true", "yes", "on"},
-        "allowed_branch": policy.allowed_branch(),
-        "approved_base_oid": policy.allowed_base_oid(),
-        "workspace_branch": branch,
-        "workspace_head_oid": head,
-        "repository_identity": os.getenv("AIOS_GITOPS_REPOSITORY_IDENTITY"),
-        "token_policy_version": 2,
-        "atomic_commit_file": True,
-        "path_policy_sha256": policy.configured_path_policy_sha256(),
-    })
-
-
-def _isolated_do_get(self):
-    path = urllib.parse.urlparse(self.path).path.rstrip("/") or "/"
-    if path in {"/health", "/api/health"}:
-        return self.sendj({
-            "status": "ok",
-            "service": os.getenv(
-                "AIOS_GITOPS_SERVICE_AUDIENCE",
-                "aios-isolated-writer.service",
-            ),
-        })
-    if path not in {"/api/runtime-status", "/api/baseline", "/api/patches"}:
-        return self.sendj({"error": "isolated_writer_operation_forbidden"}, 403)
-    try:
-        _authorize(self, method="GET", path=path)
-    except AuthorizationError as exc:
-        return _authorization_error(self, exc)
-    if path == "/api/runtime-status":
-        return _isolated_runtime_status(self)
-    return _original_do_get(self)
-
-
-def _read_commit_file_body(handler):
-    try:
-        length = int(handler.headers.get("Content-Length", "0"))
-    except ValueError:
-        raise CommitFileError("writer_content_length_rejected") from None
-    if length <= 0:
-        raise CommitFileError("writer_request_object_required")
-    if length > 1_100_000:
-        raise CommitFileError("writer_request_too_large", 413)
-    raw = handler.rfile.read(length)
-    try:
-        value = json.loads(raw.decode("utf-8"))
-    except (UnicodeDecodeError, json.JSONDecodeError):
-        raise CommitFileError("writer_request_json_rejected") from None
-    if not isinstance(value, dict):
-        raise CommitFileError("writer_request_object_required")
-    return value
-
-
-def _isolated_do_post(self):
-    path = urllib.parse.urlparse(self.path).path.rstrip("/") or "/"
-    if path != "/api/commit-file":
-        return self.sendj({"error": "isolated_writer_operation_forbidden"}, 403)
-    try:
-        data = _read_commit_file_body(self)
-        branch = str(data.get("branch") or "")
-        target_path = str(data.get("path") or "")
-        grant = _authorize(
-            self,
-            method="POST",
-            path=path,
-            branch=branch,
-            target_path=target_path,
-        )
-        if api.content_has_secret(str(data.get("content") or "")):
-            raise CommitFileError("writer_secret_content_rejected", 403)
-        result = _atomic_writer().execute(grant, data)
-        return self.sendj(result)
-    except AuthorizationError as exc:
-        return _authorization_error(self, exc)
-    except CommitFileError as exc:
-        return self.sendj({"error": exc.code}, exc.status)
-    except PermissionError:
-        return self.sendj({"error": "isolated_writer_policy_rejected"}, 403)
-
-
-def reject_non_read_http(handler, method: str, path: str) -> bool:
-    if _reject(handler, method, path):
-        return True
-    try:
-        policy.validate_endpoint(method, path, api.WS, api.BARE_REPO)
-        return False
-    except PermissionError as exc:
-        handler.sendj({"error": str(exc)}, 403)
-        return True
-
-
-def checkout(branch, base="main", create=False):
-    api.ensure_git()
-    target = api.branch_name(branch)
-    policy.validate_branch_request({"branch": target, "base": base})
-    exists = api.sh(["rev-parse", "--verify", target])["code"] == 0
-    if exists:
-        if api.sh(["rev-parse", "--abbrev-ref", "HEAD"], True)["stdout"] != target:
-            api.sh(["checkout", target], True)
-    elif create:
-        api.sh(["checkout", "-b", target, base], True)
-    else:
-        raise PermissionError("isolated_writer_branch_missing")
-    policy.require_service_invariants(api.WS, api.BARE_REPO)
-    return target
-
-
-def write_file(path, content):
-    policy.validate_path(path, api.WS)
-    return _write_file(path, content)
-
-
-def sync_branch(branch: str):
-    policy.validate_sync_branch(branch)
-    local = _sync_branch(branch)
-    remote = os.getenv("AIOS_GITOPS_GITEA_PUSH_REMOTE", "").strip()
-    if remote != "gitea-http":
-        raise PermissionError("isolated_writer_gitea_remote_rejected")
-    head = api.sh(["rev-parse", "HEAD"], True)["stdout"]
-    pushed = subprocess.run(
-        ["git", "push", "--porcelain", remote, f"HEAD:refs/heads/{branch}"],
-        cwd=api.WS,
-        text=True,
-        capture_output=True,
-    )
-    if pushed.returncode != 0:
-        raise RuntimeError("isolated_writer_gitea_push_failed")
-    verified = subprocess.run(
-        ["git", "ls-remote", "--heads", remote, f"refs/heads/{branch}"],
-        cwd=api.WS,
-        text=True,
-        capture_output=True,
-    )
-    if verified.returncode != 0:
-        raise RuntimeError("isolated_writer_gitea_verification_failed")
-    fields = verified.stdout.strip().split()
-    if len(fields) != 2 or fields[0] != head or fields[1] != f"refs/heads/{branch}":
-        raise RuntimeError("isolated_writer_gitea_oid_mismatch")
-    return {
-        "status": "verified",
-        "target": "authoritative-bare+gitea",
-        "branch": branch,
-        "oid": head,
-        "local": local.get("status"),
-    }
-
-
-def commit(paths, msg):
-    policy.validate_commit_paths(paths, api.WS)
-    api.ensure_git()
-    selected = [api.relpath(p) for p in paths] if paths else ["."]
-    api.sh(["add", *selected], True)
-    policy.validate_staged_paths(api.WS)
-    branch = api.sh(["rev-parse", "--abbrev-ref", "HEAD"], True)["stdout"]
-    if not api.sh(["status", "--short"])["stdout"]:
-        return {"status": "no_changes", "branch": branch, "sync": sync_branch(branch)}
-    out = api.sh(["commit", "-m", msg], True)
-    branch = api.sh(["rev-parse", "--abbrev-ref", "HEAD"], True)["stdout"]
-    return {
-        "status": "committed",
-        "branch": branch,
-        "rev": api.sh(["rev-parse", "--short", "HEAD"], True)["stdout"],
-        "git": out,
-        "sync": sync_branch(branch),
-    }
-
-
-def audit(actor, action, target, payload):
-    policy.append_audit_record(
-        {
-            "at": api.now(),
-            "actor": actor,
-            "action": action,
-            "target": target,
-            "payload": api.sanitize(payload),
-        }
-    )
-
-
-def _validate_request(self, data, validate):
-    try:
-        validate(data)
-        return True
-    except PermissionError as exc:
-        self.sendj({"error": str(exc)}, 403)
-        return False
-
-
-def _checked_branch(self, data):
-    if not _validate_request(self, data, policy.validate_branch_request):
-        return
-    return _branch(self, data)
-
-
-def _checked_file(self, data):
-    data = dict(data)
-    data.setdefault("branch", policy.allowed_branch())
-    if not _validate_request(self, data, policy.validate_branch_request):
-        return
-    if not _validate_request(
-        self,
-        {"path": data.get("path", "")},
-        lambda item: policy.validate_path(item["path"], api.WS),
-    ):
-        return
-    return _file(self, data)
-
-
-def _checked_commit(self, data):
-    data = dict(data)
-    data.setdefault("branch", policy.allowed_branch())
-    if not _validate_request(self, data, policy.validate_branch_request):
-        return
-    return _commit(self, data)
-
-
-def _checked_patch(self, data):
-    data = dict(data)
-    data["branch"] = policy.allowed_branch()
-    if not _validate_request(self, data, policy.validate_branch_request):
-        return
-    return _patch(self, data)
-
-
-_branch, _file, _commit, _patch = api.H.branch, api.H.file, api.H.commit, api.H.patch
-api.reject_non_read_http = reject_non_read_http
-api.checkout, api.write_file, api.sync_branch, api.commit, api.audit = (
-    checkout,
-    write_file,
-    sync_branch,
-    commit,
-    audit,
-)
-api.H.branch, api.H.file, api.H.commit, api.H.patch = (
-    _checked_branch,
-    _checked_file,
-    _checked_commit,
-    _checked_patch,
-)
-api.H.do_GET = _isolated_do_get
-api.H.do_POST = _isolated_do_post
-
-if __name__ == "__main__":
-    policy.require_service_invariants(api.WS, api.BARE_REPO)
-    api.ThreadingHTTPServer((api.HOST, api.PORT), api.H).serve_forever()
@@ -1,310 +0,0 @@
-"""Fail-closed policy used only by the task-scoped Action writer."""
-from __future__ import annotations
-
-import os
-import json
-import stat
-import subprocess
-import re
-from pathlib import Path, PurePosixPath, PureWindowsPath
-from urllib.parse import unquote
-
-import isolated_writer_path_policy as path_policy
-
-WRITE_ENDPOINTS = frozenset({"/api/commit-file"})
-ALLOWED_ROOTS = (
-    "active-runtime",
-    "docs",
-    "patches",
-    "reports",
-    "scripts",
-    "test",
-    "tests",
-)
-DENIED_ROOTS = ("baseline", "config", "deploy", "deployments", "ops", "runtime", "services")
-_TRUE = frozenset({"1", "true", "yes", "on"})
-_FALSE = frozenset({"0", "false", "no", "off"})
-_DENY_FLAGS = (
-    "AIOS_GITOPS_ALLOW_MAIN_WRITE",
-    "AIOS_GITOPS_ALLOW_TAG_WRITE",
-    "AIOS_GITOPS_ALLOW_BASELINE_WRITE",
-    "AIOS_GITOPS_ALLOW_REGISTRY_WRITE",
-    "AIOS_GITOPS_ALLOW_ROLLBACK",
-    "AIOS_GITOPS_ALLOW_DEPLOYMENT",
-)
-
-
-def enforcement_required() -> bool:
-    return os.getenv("AIOS_GITOPS_ISOLATED_WRITER_ENFORCEMENT", "") == "required"
-
-
-def allowed_branch() -> str:
-    value = os.getenv("AIOS_GITOPS_ALLOWED_BRANCH", "").strip()
-    if not value:
-        raise PermissionError("isolated_writer_missing_allowed_branch")
-    return value
-
-
-def allowed_base_oid() -> str:
-    value = os.getenv("AIOS_GITOPS_ALLOWED_BASE_OID", "").strip().lower()
-    if len(value) != 40 or any(ch not in "0123456789abcdef" for ch in value):
-        raise PermissionError("isolated_writer_invalid_allowed_base_oid")
-    return value
-
-
-def _git(workspace: Path, *args: str) -> str:
-    result = subprocess.run(["git", *args], cwd=workspace, text=True, capture_output=True)
-    if result.returncode != 0:
-        raise PermissionError("isolated_writer_git_validation_failed")
-    return result.stdout.strip()
-
-
-def require_service_invariants(workspace: Path, bare_repo: Path) -> None:
-    if not enforcement_required():
-        return
-    if os.getenv("AIOS_GITOPS_WRITES_ENABLED", "").strip().lower() not in _TRUE:
-        raise PermissionError("isolated_writer_write_gate_required")
-    if os.getenv("AIOS_GITOPS_RUNTIME_ROLE", "") != "isolated-writer":
-        raise PermissionError("isolated_writer_role_required")
-    if os.getenv("AIOS_GITOPS_WORKSPACE_ROLE", "") != "isolated-writer":
-        raise PermissionError("isolated_writer_workspace_role_required")
-    if os.getenv("AIOS_GITOPS_TOKEN_POLICY_VERSION_REQUIRED", "") != "2":
-        raise PermissionError("isolated_writer_token_policy_v2_required")
-    if not os.getenv("AIOS_GITOPS_SERVICE_AUDIENCE", "").strip():
-        raise PermissionError("isolated_writer_service_audience_required")
-    if not os.getenv("AIOS_GITOPS_TOKEN_REGISTRY_V2", "").strip():
-        raise PermissionError("isolated_writer_token_registry_required")
-    if not os.getenv("AIOS_GITOPS_WRITER_OPERATION_LEDGER", "").strip():
-        raise PermissionError("isolated_writer_operation_ledger_required")
-    path_policy.configured_path_policy()
-    for name in _DENY_FLAGS:
-        if os.getenv(name, "").strip().lower() not in _FALSE:
-            raise PermissionError("isolated_writer_forbidden_capability_flag")
-    if os.getenv("AIOS_GITOPS_REPOSITORY_IDENTITY", "") != "aios/aios":
-        raise PermissionError("isolated_writer_repository_identity_rejected")
-    configured_bare_value = os.getenv("AIOS_GITOPS_AUTHORITATIVE_GIT_DIR", "").strip()
-    if not configured_bare_value:
-        raise PermissionError("isolated_writer_authoritative_repo_rejected")
-    configured_bare = Path(configured_bare_value)
-    if configured_bare.resolve(strict=True) != bare_repo.resolve(strict=True):
-        raise PermissionError("isolated_writer_authoritative_repo_rejected")
-    writer_root_value = os.getenv("AIOS_GITOPS_APPROVED_WRITER_ROOT", "").strip()
-    if not writer_root_value:
-        raise PermissionError("isolated_writer_workspace_outside_approved_root")
-    writer_root = Path(writer_root_value).resolve(strict=True)
-    lexical_workspace = Path(os.path.abspath(str(workspace)))
-    canonical_workspace = lexical_workspace.resolve(strict=True)
-    if lexical_workspace != canonical_workspace:
-        raise PermissionError("isolated_writer_workspace_symlink_rejected")
-    try:
-        canonical_workspace.relative_to(writer_root)
-    except (ValueError, FileNotFoundError):
-        raise PermissionError("isolated_writer_workspace_outside_approved_root") from None
-    if _git(workspace, "rev-parse", "--abbrev-ref", "HEAD") != allowed_branch():
-        raise PermissionError("isolated_writer_current_branch_rejected")
-    approved_base = allowed_base_oid()
-    try:
-        _git(workspace, "cat-file", "-e", f"{approved_base}^{{commit}}")
-        subprocess.run(
-            ["git", "merge-base", "--is-ancestor", approved_base, "HEAD"],
-            cwd=workspace,
-            check=True,
-            stdout=subprocess.DEVNULL,
-            stderr=subprocess.DEVNULL,
-        )
-    except (PermissionError, subprocess.CalledProcessError):
-        raise PermissionError("isolated_writer_approved_base_not_ancestor") from None
-    if _git(workspace, "merge-base", approved_base, "HEAD") != approved_base:
-        raise PermissionError("isolated_writer_merge_base_rejected")
-    common = Path(_git(workspace, "rev-parse", "--git-common-dir"))
-    if not common.is_absolute():
-        common = (workspace / common).resolve()
-    if common.resolve() != bare_repo.resolve():
-        raise PermissionError("isolated_writer_common_repo_rejected")
-
-
-def approved_audit_log_path() -> Path:
-    root_value = os.getenv("AIOS_GITOPS_APPROVED_AUDIT_ROOT", "").strip()
-    log_value = os.getenv("AIOS_GITOPS_AUDIT_LOG", "").strip()
-    if not root_value or not log_value:
-        raise PermissionError("isolated_writer_audit_path_missing")
-    lexical_root = Path(os.path.abspath(root_value))
-    lexical_log = Path(os.path.abspath(log_value))
-    root = lexical_root.resolve(strict=True)
-    if lexical_root != root or root.is_symlink() or not root.is_dir():
-        raise PermissionError("isolated_writer_audit_root_rejected")
-    try:
-        lexical_log.relative_to(root)
-    except ValueError:
-        raise PermissionError("isolated_writer_audit_path_outside_approved_root") from None
-    if lexical_log.parent.resolve(strict=True) != lexical_log.parent:
-        raise PermissionError("isolated_writer_audit_parent_symlink_rejected")
-    if lexical_log.exists() and lexical_log.is_symlink():
-        raise PermissionError("isolated_writer_audit_log_symlink_rejected")
-    os.chmod(root, 0o750)
-    os.chmod(lexical_log.parent, 0o750)
-    return lexical_log
-
-
-def append_audit_record(record: dict) -> None:
-    path = approved_audit_log_path()
-    flags = os.O_WRONLY | os.O_APPEND | os.O_CREAT
-    if hasattr(os, "O_NOFOLLOW"):
-        flags |= os.O_NOFOLLOW
-    descriptor = os.open(path, flags, 0o600)
-    try:
-        info = os.fstat(descriptor)
-        if not stat.S_ISREG(info.st_mode):
-            raise PermissionError("isolated_writer_audit_log_not_regular")
-        os.fchmod(descriptor, 0o600)
-        line = json.dumps(
-            _audit_sanitize(record),
-            ensure_ascii=False,
-            sort_keys=True,
-            separators=(",", ":"),
-        ).encode("utf-8") + b"\n"
-        os.write(descriptor, line)
-        os.fsync(descriptor)
-    finally:
-        os.close(descriptor)
-    parent_fd = os.open(path.parent, os.O_RDONLY | getattr(os, "O_DIRECTORY", 0))
-    try:
-        os.fsync(parent_fd)
-    finally:
-        os.close(parent_fd)
-
-
-def _audit_sanitize(value):
-    if isinstance(value, dict):
-        return {
-            key: (
-                "[REDACTED]"
-                if any(
-                    marker in str(key).lower()
-                    for marker in (
-                        "authorization",
-                        "credential",
-                        "password",
-                        "secret",
-                        "token",
-                        "private_key",
-                    )
-                )
-                and str(key).lower() != "token_id"
-                else _audit_sanitize(inner)
-            )
-            for key, inner in value.items()
-        }
-    if isinstance(value, list):
-        return [_audit_sanitize(item) for item in value]
-    if isinstance(value, str) and re.search(
-        r"(?i)(authorization\s*:\s*bearer|(?:token|password|secret)\s*[:=])",
-        value,
-    ):
-        return "[REDACTED]"
-    return value
-
-
-def validate_endpoint(method: str, path: str, workspace: Path, bare_repo: Path) -> None:
-    if not enforcement_required():
-        return
-    if method != "POST" or path not in WRITE_ENDPOINTS:
-        raise PermissionError("isolated_writer_operation_forbidden")
-    require_service_invariants(workspace, bare_repo)
-
-
-def validate_branch_request(data: dict) -> None:
-    if not enforcement_required():
-        return
-    branch = allowed_branch() if "branch" not in data else str(data.get("branch") or "").strip()
-    if branch != allowed_branch():
-        raise PermissionError("isolated_writer_branch_rejected")
-    if str(data.get("base", "main")).strip() != "main":
-        raise PermissionError("isolated_writer_base_rejected")
-    if data.get("force") or data.get("force_push"):
-        raise PermissionError("isolated_writer_force_rejected")
-
-
-def validate_path(path: str, workspace: Path | None = None) -> str:
-    if not isinstance(path, str):
-        raise PermissionError("isolated_writer_path_rejected")
-    value = path
-    if not value or value != value.strip() or "\x00" in value or "\\" in value:
-        raise PermissionError("isolated_writer_path_rejected")
-    try:
-        decoded = unquote(value, errors="strict")
-    except (UnicodeDecodeError, ValueError):
-        raise PermissionError("isolated_writer_path_rejected") from None
-    if decoded != value:
-        raise PermissionError("isolated_writer_path_rejected")
-    windows = PureWindowsPath(value)
-    posix = PurePosixPath(value)
-    parts = value.split("/")
-    if (
-        posix.is_absolute()
-        or windows.is_absolute()
-        or bool(windows.drive)
-        or any(part in {"", ".", ".."} for part in parts)
-    ):
-        raise PermissionError("isolated_writer_path_rejected")
-    first = parts[0]
-    service_exact_path = False
-    if first in DENIED_ROOTS:
-        try:
-            path_policy.require_service_path("commit_file.atomic", value)
-            service_exact_path = True
-        except path_policy.PathPolicyError as exc:
-            raise PermissionError(str(exc)) from None
-    if value != "README.md" and first not in ALLOWED_ROOTS and not service_exact_path:
-        raise PermissionError("isolated_writer_path_outside_allowed_roots")
-    if workspace is not None:
-        lexical_root = Path(os.path.abspath(str(workspace)))
-        root = lexical_root.resolve(strict=True)
-        if lexical_root != root:
-            raise PermissionError("isolated_writer_workspace_symlink_rejected")
-        current = root
-        for part in parts:
-            current = current / part
-            if current.is_symlink():
-                raise PermissionError("isolated_writer_path_symlink_rejected")
-        candidate = (root / value).resolve(strict=False)
-        try:
-            candidate.relative_to(root)
-        except ValueError:
-            raise PermissionError("isolated_writer_path_escapes_workspace") from None
-    return value
-
-
-def validate_content_for_path(path: str, content: str) -> None:
-    if path.split("/", 1)[0] not in DENIED_ROOTS:
-        return
-    try:
-        path_policy.validate_content("commit_file.atomic", path, content)
-    except path_policy.PathPolicyError as exc:
-        raise PermissionError(str(exc)) from None
-
-
-def configured_path_policy_sha256() -> str | None:
-    try:
-        return path_policy.configured_path_policy_sha256()
-    except path_policy.PathPolicyError as exc:
-        raise PermissionError(str(exc)) from None
-
-
-def validate_commit_paths(paths: list[str], workspace: Path | None = None) -> None:
-    if enforcement_required():
-        for path in paths:
-            if str(path).strip() != ".":
-                validate_path(str(path), workspace)
-
-
-def validate_staged_paths(workspace: Path) -> None:
-    if not enforcement_required():
-        return
-    for path in _git(workspace, "diff", "--cached", "--name-only").splitlines():
-        validate_path(path, workspace)
-
-
-def validate_sync_branch(branch: str) -> None:
-    if enforcement_required() and branch != allowed_branch():
-        raise PermissionError("isolated_writer_sync_branch_rejected")
@@ -0,0 +1,89 @@
+"""Append-only audit chain for AIOS V2R1."""
+from __future__ import annotations
+
+import hashlib
+import json
+from pathlib import Path
+import sqlite3
+from typing import Any
+
+from .tenant_context import canonical_json, isoformat, require_ident
+
+
+class AuditLog:
+    def __init__(self, database: str | Path) -> None:
+        self.database = str(database)
+        with sqlite3.connect(self.database) as db:
+            db.execute("PRAGMA journal_mode=WAL")
+            db.execute(
+                """
+                CREATE TABLE IF NOT EXISTS audit_events (
+                    seq INTEGER PRIMARY KEY AUTOINCREMENT,
+                    tenant_id TEXT NOT NULL,
+                    trace_id TEXT NOT NULL,
+                    event_type TEXT NOT NULL,
+                    payload TEXT NOT NULL,
+                    previous_hash TEXT NOT NULL,
+                    event_hash TEXT NOT NULL UNIQUE,
+                    created_at TEXT NOT NULL
+                )
+                """
+            )
+
+    def append(self, *, tenant_id: str, trace_id: str, event_type: str, payload: dict[str, Any]) -> str:
+        tenant_id = require_ident("tenant_id", tenant_id, tenant=True)
+        trace_id = require_ident("trace_id", trace_id)
+        event_type = require_ident("event_type", event_type)
+        with sqlite3.connect(self.database) as db:
+            previous = db.execute(
+                "SELECT event_hash FROM audit_events ORDER BY seq DESC LIMIT 1"
+            ).fetchone()
+            previous_hash = previous[0] if previous else "GENESIS"
+            body = {
+                "tenant_id": tenant_id,
+                "trace_id": trace_id,
+                "event_type": event_type,
+                "payload": payload,
+                "previous_hash": previous_hash,
+                "created_at": isoformat(),
+            }
+            digest = hashlib.sha256(
+                canonical_json(body)
+            ).hexdigest()
+            db.execute(
+                "INSERT INTO audit_events VALUES(NULL,?,?,?,?,?,?,?)",
+                (
+                    tenant_id,
+                    trace_id,
+                    event_type,
+                    json.dumps(payload, ensure_ascii=False),
+                    previous_hash,
+                    digest,
+                    body["created_at"],
+                ),
+            )
+            return digest
+
+    def verify(self) -> bool:
+        previous = "GENESIS"
+        with sqlite3.connect(self.database) as db:
+            rows = db.execute(
+                "SELECT tenant_id,trace_id,event_type,payload,previous_hash,event_hash,created_at "
+                "FROM audit_events ORDER BY seq"
+            )
+            for row in rows:
+                body = {
+                    "tenant_id": row[0],
+                    "trace_id": row[1],
+                    "event_type": row[2],
+                    "payload": json.loads(row[3]),
+                    "previous_hash": row[4],
+                    "created_at": row[6],
+                }
+                if row[4] != previous:
+                    return False
+                digest = hashlib.sha256(canonical_json(body)).hexdigest()
+                if digest != row[5]:
+                    return False
+                previous = digest
+        return True
@@ -0,0 +1,73 @@
+"""AIOS V2R1 Tenant Cell lifecycle CLI primitives."""
+from __future__ import annotations
+
+from dataclasses import dataclass
+from datetime import datetime, timezone
+import json
+from pathlib import Path
+
+from .tenant_context import ValidationError, require_ident
+
+
+@dataclass(frozen=True)
+class CellRecord:
+    tenant_id: str
+    cell_id: str
+    version: str
+    state: str
+    config_digest: str
+    created_at: str
+
+
+class CellManager:
+    def __init__(self, registry: str | Path) -> None:
+        self.registry = Path(registry)
+        self.registry.parent.mkdir(parents=True, exist_ok=True)
+        if not self.registry.exists():
+            self.registry.write_text("{\"cells\":{}}\n", encoding="utf-8")
+
+    def _load(self) -> dict:
+        return json.loads(self.registry.read_text(encoding="utf-8"))
+
+    def _save(self, value: dict) -> None:
+        self.registry.write_text(
+            json.dumps(value, ensure_ascii=False, indent=2) + "\n",
+            encoding="utf-8",
+        )
+
+    def create(self, tenant_id: str, cell_id: str, version: str, digest: str) -> CellRecord:
+        tenant_id = require_ident("tenant_id", tenant_id, tenant=True)
+        cell_id = require_ident("cell_id", cell_id)
+        data = self._load()
+        if tenant_id in data["cells"]:
+            raise ValidationError("tenant already has a cell")
+        record = CellRecord(
+            tenant_id,
+            cell_id,
+            version,
+            "created",
+            digest,
+            datetime.now(timezone.utc).isoformat(),
+        )
+        data["cells"][tenant_id] = record.__dict__
+        self._save(data)
+        return record
+
+    def status(self, tenant_id: str) -> CellRecord:
+        data = self._load()
+        item = data["cells"].get(tenant_id)
+        if not item:
+            raise ValidationError("unknown tenant")
+        return CellRecord(**item)
+
+    def transition(self, tenant_id: str, state: str) -> CellRecord:
+        allowed = {"created", "starting", "healthy", "upgrading", "rollback", "failed"}
+        if state not in allowed:
+            raise ValidationError("invalid cell state")
+        data = self._load()
+        item = data["cells"].get(tenant_id)
+        if not item:
+            raise ValidationError("unknown tenant")
+        item["state"] = state
+        self._save(data)
+        return CellRecord(**item)
@@ -0,0 +1,64 @@
+"""The only V2R1 ingress adapter: verified context to routed ledger record."""
+from __future__ import annotations
+
+from dataclasses import dataclass
+from datetime import datetime
+from threading import RLock
+from typing import Callable, Mapping, Any
+
+from .message_ledger import LedgerRecord, MessageLedger
+from .router import Route, TenantRouter
+from .session_pool import SessionLease, SessionPool
+from .tenant_context import CanonicalMessage, TenantContext, utc_now
+
+
+@dataclass(frozen=True)
+class IngressResult:
+    record: LedgerRecord
+    route: Route
+    session: SessionLease
+
+
+class ChannelAdapter:
+    """Fail-closed runtime ingress composition.
+
+    The adapter intentionally accepts no tenant or Cell authority outside the
+    signed context and TenantRouter.  A process lock keeps rollback handling
+    deterministic for a single runtime while SQLite protects cross-process
+    ledger writes.
+    """
+
+    def __init__(
+        self,
+        *,
+        router: TenantRouter,
+        ledger: MessageLedger,
+        session_pool: SessionPool,
+        signing_key: bytes,
+        clock: Callable[[], datetime] = utc_now,
+    ) -> None:
+        self._router = router
+        self._ledger = ledger
+        self._session_pool = session_pool
+        self._signing_key = signing_key
+        self._clock = clock
+        self._lock = RLock()
+
+    def ingest(self, *, token: str, message: Mapping[str, Any]) -> IngressResult:
+        with self._lock:
+            context = TenantContext.verify(token, self._signing_key, now=self._clock())
+            canonical = CanonicalMessage.from_mapping(message)
+            canonical.assert_context(context)
+            route = self._router.assert_context_route(context)
+            self._router.assert_message_route(canonical)
+            self._session_pool.assert_available(context, route)
+
+            existed = self._ledger.matches(canonical)
+            record = self._ledger.append(canonical)
+            try:
+                lease = self._session_pool.acquire(context, route)
+            except Exception:
+                if not existed:
+                    self._ledger.remove(record)
+                raise
+            return IngressResult(record=record, route=route, session=lease)
@@ -0,0 +1,48 @@
+"""aios-cell command implementation for V2R1 Cell lifecycle."""
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+
+from .cell_manager import CellManager
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="aios-cell")
+    parser.add_argument("registry")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    create = sub.add_parser("create")
+    create.add_argument("tenant_id")
+    create.add_argument("cell_id")
+    create.add_argument("version")
+    create.add_argument("digest")
+
+    status = sub.add_parser("status")
+    status.add_argument("tenant_id")
+
+    transition = sub.add_parser("transition")
+    transition.add_argument("tenant_id")
+    transition.add_argument("state")
+
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = build_parser().parse_args(argv)
+    manager = CellManager(args.registry)
+    if args.command == "create":
+        result = manager.create(args.tenant_id, args.cell_id, args.version, args.digest)
+    elif args.command == "status":
+        result = manager.status(args.tenant_id)
+    elif args.command == "transition":
+        result = manager.transition(args.tenant_id, args.state)
+    else:
+        return 2
+    print(json.dumps(result.__dict__, ensure_ascii=False, sort_keys=True))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())
@@ -0,0 +1,106 @@
+"""OpenClaw Cell lifecycle adapter for AIOS V2R1."""
+from __future__ import annotations
+
+from dataclasses import asdict, dataclass, field
+import json
+from pathlib import Path
+import subprocess
+from typing import Any, Mapping
+
+from .tenant_context import ValidationError, V2R1Error, require_ident
+
+
+@dataclass(frozen=True)
+class CellSpec:
+    tenant_id: str
+    image: str
+    runtime: str = "docker"
+    port: int | None = None
+    memory: str = "2g"
+    cpus: str = "2"
+    pids_limit: int = 512
+    network: str = "bridge"
+    env: tuple[str, ...] = field(default_factory=tuple)
+
+    def __post_init__(self) -> None:
+        require_ident("tenant_id", self.tenant_id, tenant=True)
+        if self.runtime not in {"docker", "podman"}:
+            raise ValidationError("unsupported runtime")
+        if not self.image:
+            raise ValidationError("image required")
+
+
+class OpenClawFleet:
+    def __init__(self, binary: str = "openclaw") -> None:
+        self.binary = binary
+
+    def _run(self, args: list[str]) -> dict[str, Any]:
+        proc = subprocess.run(
+            [self.binary, *args],
+            check=False,
+            text=True,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+        )
+        if proc.returncode:
+            raise V2R1Error(proc.stderr.strip() or "openclaw command failed")
+        data = json.loads(proc.stdout or "{}")
+        if isinstance(data, dict):
+            return data
+        return {"result": data}
+
+    def create(self, spec: CellSpec) -> dict[str, Any]:
+        return self._run([
+            "fleet", "create", spec.tenant_id,
+            "--image", spec.image,
+            "--runtime", spec.runtime,
+            "--json",
+        ])
+
+    def status(self, tenant_id: str) -> dict[str, Any]:
+        require_ident("tenant_id", tenant_id, tenant=True)
+        return self._run(["fleet", "status", tenant_id, "--json"])
+
+    def doctor(self, tenant_id: str | None = None) -> dict[str, Any]:
+        args = ["fleet", "doctor"]
+        if tenant_id:
+            require_ident("tenant_id", tenant_id, tenant=True)
+            args.append(tenant_id)
+        args.append("--json")
+        return self._run(args)
+
+    def backup(self, tenant_id: str, output: str | Path) -> dict[str, Any]:
+        return self._run(["fleet", "backup", tenant_id, "--out", str(output), "--json"])
+
+    def restore(self, tenant_id: str, archive: str | Path) -> dict[str, Any]:
+        return self._run(["fleet", "restore", tenant_id, "--from", str(archive), "--json"])
+
+    def upgrade(self, tenant_id: str, image: str) -> dict[str, Any]:
+        return self._run(["fleet", "upgrade", tenant_id, "--image", image, "--json"])
+
+
+def load_inventory(path: str | Path) -> list[CellSpec]:
+    raw = json.loads(Path(path).read_text(encoding="utf-8"))
+    if raw.get("schema_version") != "aios.cells.v1":
+        raise ValidationError("invalid inventory schema")
+    result: list[CellSpec] = []
+    seen: set[str] = set()
+    for item in raw.get("cells", []):
+        spec = CellSpec(
+            tenant_id=item["tenant_id"],
+            image=item["image"],
+            runtime=item.get("runtime", "docker"),
+            port=item.get("port"),
+            env=tuple(item.get("env", [])),
+        )
+        if spec.tenant_id in seen:
+            raise ValidationError("duplicate tenant")
+        seen.add(spec.tenant_id)
+        result.append(spec)
+    if not result:
+        raise ValidationError("no cells")
+    return result
+
+
+def inventory_as_dict(items: list[CellSpec]) -> dict[str, Any]:
+    return {"schema_version": "aios.cells.v1", "cells": [asdict(x) for x in items]}
@@ -0,0 +1,143 @@
+"""Tenant-partitioned Hermes shared agent fabric primitives."""
+from __future__ import annotations
+
+from dataclasses import dataclass
+from datetime import datetime, timezone
+from contextlib import closing
+from pathlib import Path
+import sqlite3
+from typing import Any
+
+from .tenant_context import (
+    CanonicalMessage,
+    ConflictError,
+    ScopeError,
+    ValidationError,
+    isoformat,
+    require_ident,
+)
+
+
+@dataclass(frozen=True)
+class FabricJob:
+    job_id: str
+    tenant_id: str
+    cell_id: str
+    profile_id: str
+    session_id: str
+    event_id: str
+    status: str = "queued"
+
+    def __post_init__(self) -> None:
+        for name in (
+            "job_id", "cell_id", "profile_id", "session_id", "event_id"
+        ):
+            require_ident(name, getattr(self, name))
+        require_ident("tenant_id", self.tenant_id, tenant=True)
+        if self.status not in {"queued", "running", "completed", "failed", "cancelled"}:
+            raise ValidationError("invalid job status")
+
+
+class HermesFabric:
+    """Shared scheduler storage with mandatory tenant partition keys."""
+
+    def __init__(self, database: str | Path) -> None:
+        self.database = str(database)
+        with closing(sqlite3.connect(self.database)) as connection, connection as db:
+            db.execute("PRAGMA journal_mode=WAL")
+            db.execute("PRAGMA synchronous=FULL")
+            db.execute(
+                """
+                CREATE TABLE IF NOT EXISTS fabric_jobs (
+                    job_id TEXT PRIMARY KEY,
+                    tenant_id TEXT NOT NULL,
+                    cell_id TEXT NOT NULL,
+                    profile_id TEXT NOT NULL,
+                    session_id TEXT NOT NULL,
+                    event_id TEXT NOT NULL UNIQUE,
+                    status TEXT NOT NULL,
+                    created_at TEXT NOT NULL,
+                    updated_at TEXT NOT NULL
+                )
+                """
+            )
+            db.execute(
+                "CREATE INDEX IF NOT EXISTS idx_fabric_tenant_queue "
+                "ON fabric_jobs(tenant_id, cell_id, status)"
+            )
+
+    def enqueue(
+        self,
+        *,
+        message: CanonicalMessage,
+        profile_id: str,
+    ) -> FabricJob:
+        profile_id = require_ident("profile_id", profile_id)
+        if not message.command_capable:
+            raise ScopeError("non-command events cannot create execution jobs")
+        if not message.is_authenticated_human_command:
+            raise ScopeError("only authenticated human commands can create jobs")
+        job = FabricJob(
+            job_id=f"job-{message.event_id}",
+            tenant_id=message.tenant_id,
+            cell_id=message.cell_id,
+            profile_id=profile_id,
+            session_id=message.session_id,
+            event_id=message.event_id,
+        )
+        now = isoformat()
+        conflict: ConflictError | None = None
+        try:
+            with closing(sqlite3.connect(self.database)) as connection, connection as db:
+                db.execute("PRAGMA journal_mode=WAL")
+                db.execute(
+                    "INSERT INTO fabric_jobs VALUES(?,?,?,?,?,?,?,?,?)",
+                    (
+                        job.job_id,
+                        job.tenant_id,
+                        job.cell_id,
+                        job.profile_id,
+                        job.session_id,
+                        job.event_id,
+                        job.status,
+                        now,
+                        now,
+                    ),
+                )
+        except sqlite3.IntegrityError:
+            conflict = ConflictError(
+                "fabric event already exists or violates queue uniqueness"
+            )
+        if conflict is not None:
+            raise conflict
+        return job
+
+    def claim(self, tenant_id: str, cell_id: str, profile_id: str) -> FabricJob | None:
+        require_ident("tenant_id", tenant_id, tenant=True)
+        require_ident("cell_id", cell_id)
+        require_ident("profile_id", profile_id)
+        with closing(sqlite3.connect(self.database)) as connection, connection as db:
+            db.execute("BEGIN IMMEDIATE")
+            row = db.execute(
+                "SELECT * FROM fabric_jobs WHERE tenant_id=? AND cell_id=? "
+                "AND profile_id=? AND status='queued' ORDER BY created_at LIMIT 1",
+                (tenant_id, cell_id, profile_id),
+            ).fetchone()
+            if not row:
+                db.commit()
+                return None
+            db.execute(
+                "UPDATE fabric_jobs SET status='running', updated_at=? WHERE job_id=?",
+                (isoformat(), row[0]),
+            )
+            db.commit()
+        return FabricJob(*row[:7])
+
+    def health(self) -> dict[str, Any]:
+        with closing(sqlite3.connect(self.database)) as connection, connection as db:
+            count = db.execute("SELECT count(*) FROM fabric_jobs").fetchone()[0]
+        return {
+            "component": "hermes_fabric",
+            "jobs": count,
+            "checked_at": datetime.now(timezone.utc).isoformat(),
+        }
@@ -0,0 +1,47 @@
+"""Hermes shared fabric profile isolation primitives."""
+from __future__ import annotations
+
+from dataclasses import dataclass
+from pathlib import Path
+import os
+
+from .tenant_context import ValidationError, require_ident
+
+
+@dataclass(frozen=True)
+class HermesProfile:
+    tenant_id: str
+    cell_id: str
+    profile_id: str
+    hermes_home: Path
+    workspace: Path
+
+    def __post_init__(self) -> None:
+        require_ident("tenant_id", self.tenant_id, tenant=True)
+        for name in ("cell_id", "profile_id"):
+            require_ident(name, getattr(self, name))
+        if not self.hermes_home.is_absolute() or not self.workspace.is_absolute():
+            raise ValidationError("profile paths must be absolute")
+
+    @property
+    def environment(self) -> dict[str, str]:
+        return {
+            "HERMES_HOME": str(self.hermes_home),
+            "HOME": str(self.hermes_home),
+            "AIOS_TENANT_ID": self.tenant_id,
+            "AIOS_CELL_ID": self.cell_id,
+            "AIOS_PROFILE_ID": self.profile_id,
+        }
+
+    def prepare(self) -> None:
+        self.hermes_home.mkdir(parents=True, exist_ok=True)
+        self.workspace.mkdir(parents=True, exist_ok=True)
+        os.chmod(self.hermes_home, 0o700)
+        os.chmod(self.workspace, 0o700)
+
+    def assert_path_allowed(self, path: str | Path) -> None:
+        target = Path(path).resolve()
+        for root in (self.hermes_home.resolve(), self.workspace.resolve()):
+            if target == root or root in target.parents:
+                return
+        raise ValidationError("path escapes profile isolation boundary")
@@ -0,0 +1,158 @@
+"""Fail-closed identity binding for authenticated external ingress.
+
+External payload claims are not authority.  An HMAC-authenticated envelope is
+the sole factory for :class:`AuthenticatedPrincipal`; the resolver then checks
+every claim against the authoritative ``TenantRouter`` before the runtime signs
+an internal ``TenantContext``.
+"""
+from __future__ import annotations
+
+from dataclasses import dataclass
+import hashlib
+import hmac
+import re
+from typing import Any, Mapping
+
+from .router import Route, TenantRouter
+from .tenant_context import ScopeError, ValidationError, canonical_json, require_ident
+
+
+_PROVENANCE = object()
+_SIGNATURE_RE = re.compile(r"^[0-9a-f]{64}$")
+_SCOPE_FIELDS = (
+    "principal_id", "tenant_id", "cell_id", "channel",
+    "channel_account_id", "session_id", "message",
+)
+
+
+class AuthenticationError(ValidationError):
+    """Authentication or identity resolution failed without disclosing scope."""
+
+
+@dataclass(frozen=True, init=False)
+class AuthenticatedPrincipal:
+    """A principal which only the verified envelope factory can create."""
+
+    principal_id: str
+
+    def __init__(self, principal_id: str, *, _provenance: object) -> None:
+        if _provenance is not _PROVENANCE:
+            raise TypeError("AuthenticatedPrincipal is created by authenticated ingress only")
+        object.__setattr__(self, "principal_id", require_ident("principal_id", principal_id))
+
+    @classmethod
+    def _verified(cls, principal_id: str) -> "AuthenticatedPrincipal":
+        return cls(principal_id, _provenance=_PROVENANCE)
+
+
+@dataclass(frozen=True)
+class IdentityClaims:
+    tenant_id: str
+    cell_id: str
+    channel: str
+    channel_account_id: str
+    session_id: str
+
+    def __post_init__(self) -> None:
+        require_ident("tenant_id", self.tenant_id, tenant=True)
+        for field in ("cell_id", "channel", "channel_account_id", "session_id"):
+            require_ident(field, getattr(self, field))
+
+
+@dataclass(frozen=True)
+class AuthenticatedIngress:
+    principal: AuthenticatedPrincipal
+    claims: IdentityClaims
+    message: Mapping[str, Any]
+
+
+@dataclass(frozen=True)
+class RuntimeIdentity:
+    tenant_id: str
+    cell_id: str
+    principal_id: str
+    channel: str
+    channel_account_id: str
+    session_id: str
+
+
+class IngressAuthenticator:
+    """Verify a canonical HMAC envelope before any identity lookup occurs."""
+
+    def __init__(self, hmac_key: bytes) -> None:
+        if not isinstance(hmac_key, bytes) or len(hmac_key) < 32:
+            raise ValidationError("ingress HMAC key must be at least 32 bytes")
+        self._hmac_key = hmac_key
+
+    @staticmethod
+    def _signed_payload(request: Mapping[str, Any]) -> dict[str, Any]:
+        if not isinstance(request, Mapping):
+            raise ValidationError("ingress request must be an object")
+        if set(request) != {*_SCOPE_FIELDS, "signature"}:
+            raise ValidationError("ingress request fields are invalid")
+        values = {field: request[field] for field in _SCOPE_FIELDS}
+        if not isinstance(values["message"], Mapping):
+            raise ValidationError("ingress message must be an object")
+        return values
+
+    def authenticate(self, request: Mapping[str, Any]) -> AuthenticatedIngress:
+        values = self._signed_payload(request)
+        signature = request["signature"]
+        if not isinstance(signature, str) or not _SIGNATURE_RE.fullmatch(signature):
+            raise AuthenticationError("invalid ingress signature")
+        expected = hmac.new(
+            self._hmac_key, canonical_json(values), hashlib.sha256
+        ).hexdigest()
+        if not hmac.compare_digest(expected, signature):
+            raise AuthenticationError("invalid ingress signature")
+        return AuthenticatedIngress(
+            principal=AuthenticatedPrincipal._verified(values["principal_id"]),
+            claims=IdentityClaims(
+                tenant_id=values["tenant_id"],
+                cell_id=values["cell_id"],
+                channel=values["channel"],
+                channel_account_id=values["channel_account_id"],
+                session_id=values["session_id"],
+            ),
+            message=dict(values["message"]),
+        )
+
+
+class RuntimeIdentityResolver:
+    """Resolve authenticated ingress identity through ``TenantRouter`` only."""
+
+    def __init__(self, router: TenantRouter) -> None:
+        self._router = router
+
+    def resolve(
+        self, principal: AuthenticatedPrincipal, claims: IdentityClaims
+    ) -> RuntimeIdentity:
+        if not isinstance(principal, AuthenticatedPrincipal):
+            raise AuthenticationError("untrusted principal type")
+        try:
+            route: Route = self._router.resolve(
+                channel=claims.channel,
+                channel_account_id=claims.channel_account_id,
+                principal_id=principal.principal_id,
+                session_id=claims.session_id,
+            )
+        except (ScopeError, ValidationError) as exc:
+            raise AuthenticationError("identity is not registered") from None
+        expected = (
+            claims.tenant_id, claims.cell_id, claims.channel,
+            claims.channel_account_id, principal.principal_id, claims.session_id,
+        )
+        actual = (
+            route.tenant_id, route.cell_id, route.channel,
+            route.channel_account_id, route.principal_id, route.session_id,
+        )
+        if actual != expected:
+            raise AuthenticationError("identity claims do not match authoritative route")
+        return RuntimeIdentity(
+            tenant_id=route.tenant_id,
+            cell_id=route.cell_id,
+            principal_id=route.principal_id,
+            channel=route.channel,
+            channel_account_id=route.channel_account_id,
+            session_id=route.session_id or "",
+        )
@@ -0,0 +1,60 @@
+"""Tenant-scoped memory namespace and access policy for AIOS V2R1."""
+from __future__ import annotations
+
+from dataclasses import dataclass
+from pathlib import PurePosixPath
+from typing import Literal
+
+from .tenant_context import ScopeError, ValidationError, require_ident
+
+
+MemoryKind = Literal["session", "profile", "cell", "tenant", "shared_artifact"]
+
+
+@dataclass(frozen=True)
+class MemoryScope:
+    tenant_id: str
+    cell_id: str
+    profile_id: str
+    session_id: str | None
+    kind: MemoryKind
+
+    def __post_init__(self) -> None:
+        require_ident("tenant_id", self.tenant_id, tenant=True)
+        for name in ("cell_id", "profile_id"):
+            require_ident(name, getattr(self, name))
+        if self.session_id is not None:
+            require_ident("session_id", self.session_id)
+        if self.kind not in {"session", "profile", "cell", "tenant", "shared_artifact"}:
+            raise ValidationError("invalid memory kind")
+        if self.kind == "session" and self.session_id is None:
+            raise ValidationError("session memory requires session_id")
+
+    @property
+    def namespace(self) -> str:
+        parts = ["tenant", self.tenant_id, "cell", self.cell_id]
+        if self.kind in {"profile", "session"}:
+            parts.extend(["profile", self.profile_id])
+        if self.kind == "session":
+            parts.extend(["session", str(self.session_id)])
+        parts.extend(["memory", self.kind])
+        return str(PurePosixPath(*parts))
+
+    def assert_access(self, requested: "MemoryScope", *, write: bool = False) -> None:
+        if self.tenant_id != requested.tenant_id:
+            raise ScopeError("cross-tenant memory access denied")
+        if self.cell_id != requested.cell_id:
+            raise ScopeError("cross-cell memory access denied")
+        if requested.kind == "shared_artifact":
+            if write:
+                raise ScopeError("shared artifacts are immutable")
+            return
+        if self.profile_id != requested.profile_id and requested.kind in {"profile", "session"}:
+            raise ScopeError("cross-profile memory access denied")
+        if requested.kind == "session" and self.session_id != requested.session_id:
+            raise ScopeError("cross-session memory access denied")
+
+
+def qualify_memory_key(scope: MemoryScope, key: str) -> str:
+    key = require_ident("memory_key", key)
+    return f"{scope.namespace}/{key}"
@@ -0,0 +1,224 @@
+"""Tenant-scoped append-only message ledger and exact quote resolver."""
+from __future__ import annotations
+
+from dataclasses import dataclass
+from datetime import timedelta
+from contextlib import closing
+import os
+from pathlib import Path
+import sqlite3
+from typing import Iterable
+
+from .tenant_context import (
+    CanonicalMessage,
+    ConflictError,
+    ScopeError,
+    ValidationError,
+    isoformat,
+    normalize_message_id,
+    parse_time,
+    utc_now,
+)
+
+
+@dataclass(frozen=True)
+class LedgerRecord:
+    tenant_id: str
+    cell_id: str
+    channel: str
+    channel_account_id: str
+    peer_id: str
+    direction: str
+    message_id: str
+    event_id: str
+    body: str
+    occurred_at: str
+    expires_at: str
+
+
+class MessageLedger:
+    """Exact-ID ledger.
+
+    The resolver never uses time windows, prefixes, similarity, or nearest-message
+    fallbacks. Ambiguity and absence fail closed.
+    """
+
+    def __init__(self, database: str | Path, *, ttl_days: int = 7) -> None:
+        if not 1 <= ttl_days <= 365:
+            raise ValidationError("ttl_days must be between 1 and 365")
+        self.database = Path(database)
+        self.ttl_days = ttl_days
+        self.database.parent.mkdir(parents=True, exist_ok=True)
+        self._initialize()
+        try:
+            os.chmod(self.database, 0o600)
+        except OSError:
+            pass
+
+    def _connect(self) -> sqlite3.Connection:
+        db = sqlite3.connect(str(self.database), timeout=30)
+        db.row_factory = sqlite3.Row
+        db.execute("PRAGMA journal_mode=WAL")
+        db.execute("PRAGMA synchronous=FULL")
+        db.execute("PRAGMA busy_timeout=30000")
+        return db
+
+    def _initialize(self) -> None:
+        with closing(self._connect()) as connection, connection as db:
+            db.executescript(
+                """
+                CREATE TABLE IF NOT EXISTS message_ledger (
+                    tenant_id TEXT NOT NULL,
+                    cell_id TEXT NOT NULL,
+                    channel TEXT NOT NULL,
+                    channel_account_id TEXT NOT NULL,
+                    peer_id TEXT NOT NULL,
+                    direction TEXT NOT NULL CHECK(direction IN ('inbound','outbound','internal')),
+                    message_id TEXT NOT NULL,
+                    event_id TEXT NOT NULL,
+                    body TEXT NOT NULL,
+                    occurred_at TEXT NOT NULL,
+                    expires_at TEXT NOT NULL,
+                    created_at TEXT NOT NULL,
+                    PRIMARY KEY(
+                      tenant_id, cell_id, channel, channel_account_id,
+                      peer_id, direction, message_id
+                    ),
+                    UNIQUE(tenant_id, cell_id, event_id)
+                );
+                CREATE INDEX IF NOT EXISTS idx_message_reply_lookup ON message_ledger(
+                    tenant_id, cell_id, channel, channel_account_id,
+                    peer_id, message_id, expires_at
+                );
+                """
+            )
+
+    def append(self, message: CanonicalMessage) -> LedgerRecord:
+        """Append one exact message through the runtime write path.
+
+        This is intentionally the owner of validation, idempotency, and the
+        immediate SQLite transaction.  Runtime callers must not depend on the
+        legacy ``remember`` compatibility name.
+        """
+        message_id = normalize_message_id(message.message_id)
+        now = utc_now()
+        expires = isoformat(now + timedelta(days=self.ttl_days))
+        key = (
+            message.tenant_id,
+            message.cell_id,
+            message.channel,
+            message.channel_account_id,
+            message.peer_id,
+            message.direction,
+            message_id,
+        )
+        storage_error: ConflictError | None = None
+        try:
+            with closing(self._connect()) as connection, connection as db:
+                db.execute("BEGIN IMMEDIATE")
+                existing = db.execute(
+                    "SELECT event_id, body, occurred_at, expires_at FROM message_ledger "
+                    "WHERE tenant_id=? AND cell_id=? AND channel=? AND channel_account_id=? "
+                    "AND peer_id=? AND direction=? AND message_id=?",
+                    key,
+                ).fetchone()
+                if existing:
+                    if existing["body"] != message.body:
+                        db.rollback()
+                        raise ConflictError("message ID collision with different content")
+                    db.commit()
+                    return LedgerRecord(
+                        *key, existing["event_id"], existing["body"],
+                        existing["occurred_at"], existing["expires_at"],
+                    )
+                db.execute(
+                    "INSERT INTO message_ledger VALUES(?,?,?,?,?,?,?,?,?,?,?,?)",
+                    (*key, message.event_id, message.body, message.occurred_at, expires, isoformat(now)),
+                )
+                db.commit()
+        except sqlite3.Error:
+            storage_error = ConflictError("ledger storage unavailable")
+        if storage_error is not None:
+            # Raise outside the sqlite exception handler so callers cannot inspect
+            # a driver exception through __cause__ or __context__.
+            raise storage_error
+        return LedgerRecord(*key, message.event_id, message.body, message.occurred_at, expires)
+
+    def remember(self, message: CanonicalMessage) -> LedgerRecord:
+        """Backward-compatible API wrapper for callers outside the runtime path."""
+        return self.append(message)
+
+    def matches(self, message: CanonicalMessage) -> bool:
+        """Whether this exact message is already durably represented."""
+        message_id = normalize_message_id(message.message_id)
+        with closing(self._connect()) as connection, connection as db:
+            row = db.execute(
+                "SELECT event_id, body FROM message_ledger WHERE tenant_id=? AND "
+                "cell_id=? AND channel=? AND channel_account_id=? AND peer_id=? "
+                "AND direction=? AND message_id=?",
+                (
+                    message.tenant_id, message.cell_id, message.channel,
+                    message.channel_account_id, message.peer_id, message.direction,
+                    message_id,
+                ),
+            ).fetchone()
+        return bool(row and row["event_id"] == message.event_id and row["body"] == message.body)
+
+    def remove(self, record: LedgerRecord) -> None:
+        """Compensate a newly appended record if a later ingress step fails."""
+        with closing(self._connect()) as connection, connection as db:
+            db.execute(
+                "DELETE FROM message_ledger WHERE tenant_id=? AND cell_id=? AND "
+                "channel=? AND channel_account_id=? AND peer_id=? AND direction=? "
+                "AND message_id=? AND event_id=?",
+                (
+                    record.tenant_id, record.cell_id, record.channel,
+                    record.channel_account_id, record.peer_id, record.direction,
+                    record.message_id, record.event_id,
+                ),
+            )
+
+    def resolve_quote(self, message: CanonicalMessage) -> str:
+        if message.quoted_body is not None:
+            return message.quoted_body
+        if message.reply_to_message_id is None:
+            raise ScopeError("quoted_text_unavailable")
+        reply_id = normalize_message_id(
+            message.reply_to_message_id,
+            field_name="reply_to_message_id",
+        )
+        with closing(self._connect()) as connection, connection as db:
+            rows = db.execute(
+                "SELECT direction, body, event_id FROM message_ledger "
+                "WHERE tenant_id=? AND cell_id=? AND channel=? AND channel_account_id=? "
+                "AND peer_id=? AND message_id=? AND expires_at>?",
+                (
+                    message.tenant_id,
+                    message.cell_id,
+                    message.channel,
+                    message.channel_account_id,
+                    message.peer_id,
+                    reply_id,
+                    isoformat(),
+                ),
+            ).fetchall()
+        if len(rows) == 1:
+            return str(rows[0]["body"])
+        if len(rows) > 1:
+            raise ConflictError("ambiguous reply ID across message directions")
+        raise ScopeError("quoted_text_unavailable")
+
+    def purge_expired(self) -> int:
+        with closing(self._connect()) as connection, connection as db:
+            cursor = db.execute(
+                "DELETE FROM message_ledger WHERE expires_at<=?", (isoformat(),)
+            )
+            return cursor.rowcount
+
+    def integrity_check(self) -> str:
+        with closing(self._connect()) as connection, connection as db:
+            return str(db.execute("PRAGMA integrity_check").fetchone()[0])
+
+    def count(self) -> int:
+        with closing(self._connect()) as connection, connection as db:
+            return int(db.execute("SELECT count(*) FROM message_ledger").fetchone()[0])
@@ -0,0 +1,336 @@
+"""Authoritative tenant registry and fail-closed message router."""
+from __future__ import annotations
+
+from contextlib import contextmanager
+from contextlib import closing
+from dataclasses import dataclass
+from datetime import datetime, timedelta
+import sqlite3
+from pathlib import Path
+from typing import Callable, Iterator
+
+from .tenant_context import (
+    CanonicalMessage,
+    ConflictError,
+    ScopeError,
+    TenantContext,
+    ValidationError,
+    isoformat,
+    parse_time,
+    require_ident,
+    utc_now,
+)
+
+
+@dataclass(frozen=True)
+class Route:
+    tenant_id: str
+    cell_id: str
+    channel: str
+    channel_account_id: str
+    principal_id: str
+    session_id: str | None
+
+
+class TenantRouter:
+    """SQLite-backed routing registry.
+
+    Channel accounts are authoritative tenant ownership boundaries. Principal and
+    session bindings may narrow a route, but can never move traffic to another
+    tenant or Cell.
+    """
+
+    def __init__(
+        self, database: str | Path, *, clock: Callable[[], datetime] = utc_now
+    ) -> None:
+        self.database = str(database)
+        self._clock = clock
+        self._initialize()
+
+    def _connect(self) -> sqlite3.Connection:
+        connection = sqlite3.connect(self.database, timeout=30, isolation_level=None)
+        connection.row_factory = sqlite3.Row
+        connection.execute("PRAGMA foreign_keys=ON")
+        connection.execute("PRAGMA journal_mode=WAL")
+        connection.execute("PRAGMA synchronous=FULL")
+        connection.execute("PRAGMA busy_timeout=30000")
+        return connection
+
+    @contextmanager
+    def _transaction(self) -> Iterator[sqlite3.Connection]:
+        connection = self._connect()
+        try:
+            connection.execute("BEGIN IMMEDIATE")
+            yield connection
+            connection.execute("COMMIT")
+        except Exception:
+            connection.execute("ROLLBACK")
+            raise
+        finally:
+            connection.close()
+
+    def _initialize(self) -> None:
+        with closing(self._connect()) as connection, connection as db:
+            db.executescript(
+                """
+                CREATE TABLE IF NOT EXISTS tenants (
+                    tenant_id TEXT PRIMARY KEY,
+                    cell_id TEXT NOT NULL UNIQUE,
+                    status TEXT NOT NULL CHECK(status IN ('active','suspended','retired')),
+                    created_at TEXT NOT NULL,
+                    updated_at TEXT NOT NULL
+                );
+                CREATE TABLE IF NOT EXISTS channel_routes (
+                    channel TEXT NOT NULL,
+                    channel_account_id TEXT NOT NULL,
+                    tenant_id TEXT NOT NULL,
+                    cell_id TEXT NOT NULL,
+                    created_at TEXT NOT NULL,
+                    PRIMARY KEY(channel, channel_account_id),
+                    FOREIGN KEY(tenant_id) REFERENCES tenants(tenant_id)
+                );
+                CREATE TABLE IF NOT EXISTS principal_routes (
+                    channel TEXT NOT NULL,
+                    channel_account_id TEXT NOT NULL,
+                    principal_id TEXT NOT NULL,
+                    tenant_id TEXT NOT NULL,
+                    cell_id TEXT NOT NULL,
+                    created_at TEXT NOT NULL,
+                    PRIMARY KEY(channel, channel_account_id, principal_id),
+                    FOREIGN KEY(channel, channel_account_id)
+                      REFERENCES channel_routes(channel, channel_account_id)
+                );
+                CREATE TABLE IF NOT EXISTS session_bindings (
+                    tenant_id TEXT NOT NULL,
+                    session_id TEXT NOT NULL,
+                    cell_id TEXT NOT NULL,
+                    principal_id TEXT NOT NULL,
+                    expires_at TEXT NOT NULL,
+                    created_at TEXT NOT NULL,
+                    PRIMARY KEY(tenant_id, session_id),
+                    FOREIGN KEY(tenant_id) REFERENCES tenants(tenant_id)
+                );
+                CREATE INDEX IF NOT EXISTS idx_session_expiry
+                  ON session_bindings(expires_at);
+                """
+            )
+
+    def register_tenant(self, tenant_id: str, cell_id: str) -> None:
+        tenant_id = require_ident("tenant_id", tenant_id, tenant=True)
+        cell_id = require_ident("cell_id", cell_id)
+        now = isoformat(self._clock())
+        with self._transaction() as db:
+            row = db.execute(
+                "SELECT cell_id, status FROM tenants WHERE tenant_id=?", (tenant_id,)
+            ).fetchone()
+            if row:
+                if row["cell_id"] != cell_id:
+                    raise ConflictError("tenant already bound to another cell")
+                db.execute(
+                    "UPDATE tenants SET status='active', updated_at=? WHERE tenant_id=?",
+                    (now, tenant_id),
+                )
+                return
+            conflict = db.execute(
+                "SELECT tenant_id FROM tenants WHERE cell_id=?", (cell_id,)
+            ).fetchone()
+            if conflict:
+                raise ConflictError("cell already belongs to another tenant")
+            db.execute(
+                "INSERT INTO tenants VALUES(?,?,?,?,?)",
+                (tenant_id, cell_id, "active", now, now),
+            )
+
+    def set_tenant_status(self, tenant_id: str, status: str) -> None:
+        tenant_id = require_ident("tenant_id", tenant_id, tenant=True)
+        if status not in {"active", "suspended", "retired"}:
+            raise ValidationError("invalid tenant status")
+        with self._transaction() as db:
+            cursor = db.execute(
+                "UPDATE tenants SET status=?, updated_at=? WHERE tenant_id=?",
+                (status, isoformat(self._clock()), tenant_id),
+            )
+            if cursor.rowcount != 1:
+                raise ValidationError("unknown tenant")
+
+    def bind_channel(
+        self,
+        *,
+        tenant_id: str,
+        channel: str,
+        channel_account_id: str,
+    ) -> None:
+        tenant_id = require_ident("tenant_id", tenant_id, tenant=True)
+        channel = require_ident("channel", channel)
+        channel_account_id = require_ident("channel_account_id", channel_account_id)
+        with self._transaction() as db:
+            tenant = db.execute(
+                "SELECT cell_id, status FROM tenants WHERE tenant_id=?", (tenant_id,)
+            ).fetchone()
+            if not tenant or tenant["status"] != "active":
+                raise ValidationError("tenant is not active")
+            existing = db.execute(
+                "SELECT tenant_id, cell_id FROM channel_routes "
+                "WHERE channel=? AND channel_account_id=?",
+                (channel, channel_account_id),
+            ).fetchone()
+            if existing:
+                if existing["tenant_id"] != tenant_id or existing["cell_id"] != tenant["cell_id"]:
+                    raise ConflictError("channel account already belongs to another tenant")
+                return
+            db.execute(
+                "INSERT INTO channel_routes VALUES(?,?,?,?,?)",
+                (channel, channel_account_id, tenant_id, tenant["cell_id"], isoformat(self._clock())),
+            )
+
+    def bind_principal(
+        self,
+        *,
+        tenant_id: str,
+        channel: str,
+        channel_account_id: str,
+        principal_id: str,
+    ) -> None:
+        principal_id = require_ident("principal_id", principal_id)
+        route = self.resolve_channel(channel, channel_account_id)
+        if route.tenant_id != tenant_id:
+            raise ScopeError("principal cannot cross tenant boundary")
+        with self._transaction() as db:
+            existing = db.execute(
+                "SELECT tenant_id, cell_id FROM principal_routes WHERE "
+                "channel=? AND channel_account_id=? AND principal_id=?",
+                (channel, channel_account_id, principal_id),
+            ).fetchone()
+            if existing:
+                if existing["tenant_id"] != tenant_id or existing["cell_id"] != route.cell_id:
+                    raise ConflictError("principal route conflict")
+                return
+            db.execute(
+                "INSERT INTO principal_routes VALUES(?,?,?,?,?,?)",
+                (
+                    channel,
+                    channel_account_id,
+                    principal_id,
+                    tenant_id,
+                    route.cell_id,
+                    isoformat(self._clock()),
+                ),
+            )
+
+    def bind_session(
+        self,
+        *,
+        tenant_id: str,
+        session_id: str,
+        cell_id: str,
+        principal_id: str,
+        ttl_seconds: int = 86400,
+    ) -> None:
+        tenant_id = require_ident("tenant_id", tenant_id, tenant=True)
+        session_id = require_ident("session_id", session_id)
+        cell_id = require_ident("cell_id", cell_id)
+        principal_id = require_ident("principal_id", principal_id)
+        if not 60 <= ttl_seconds <= 31 * 86400:
+            raise ValidationError("invalid session TTL")
+        now = self._clock()
+        expires = isoformat(now + timedelta(seconds=ttl_seconds))
+        with self._transaction() as db:
+            tenant = db.execute(
+                "SELECT cell_id, status FROM tenants WHERE tenant_id=?", (tenant_id,)
+            ).fetchone()
+            if not tenant or tenant["status"] != "active" or tenant["cell_id"] != cell_id:
+                raise ScopeError("session cell does not match tenant")
+            existing = db.execute(
+                "SELECT cell_id, principal_id FROM session_bindings "
+                "WHERE tenant_id=? AND session_id=?",
+                (tenant_id, session_id),
+            ).fetchone()
+            if existing and (
+                existing["cell_id"] != cell_id or existing["principal_id"] != principal_id
+            ):
+                raise ConflictError("session is already bound to another principal or cell")
+            db.execute(
+                "INSERT INTO session_bindings VALUES(?,?,?,?,?,?) "
+                "ON CONFLICT(tenant_id,session_id) DO UPDATE SET expires_at=excluded.expires_at",
+                (tenant_id, session_id, cell_id, principal_id, expires, isoformat(now)),
+            )
+
+    def resolve_channel(self, channel: str, channel_account_id: str) -> Route:
+        channel = require_ident("channel", channel)
+        channel_account_id = require_ident("channel_account_id", channel_account_id)
+        with closing(self._connect()) as connection, connection as db:
+            row = db.execute(
+                "SELECT r.tenant_id, r.cell_id, t.status FROM channel_routes r "
+                "JOIN tenants t ON t.tenant_id=r.tenant_id "
+                "WHERE r.channel=? AND r.channel_account_id=?",
+                (channel, channel_account_id),
+            ).fetchone()
+        if not row:
+            raise ScopeError("unknown channel account")
+        if row["status"] != "active":
+            raise ScopeError("tenant is not active")
+        return Route(row["tenant_id"], row["cell_id"], channel, channel_account_id, "", None)
+
+    def resolve(
+        self,
+        *,
+        channel: str,
+        channel_account_id: str,
+        principal_id: str,
+        session_id: str | None = None,
+    ) -> Route:
+        principal_id = require_ident("principal_id", principal_id)
+        base = self.resolve_channel(channel, channel_account_id)
+        with closing(self._connect()) as connection, connection as db:
+            principal = db.execute(
+                "SELECT tenant_id, cell_id FROM principal_routes WHERE "
+                "channel=? AND channel_account_id=? AND principal_id=?",
+                (channel, channel_account_id, principal_id),
+            ).fetchone()
+            if principal and (
+                principal["tenant_id"] != base.tenant_id or principal["cell_id"] != base.cell_id
+            ):
+                raise ScopeError("principal route violates channel ownership")
+            if session_id is not None:
+                session_id = require_ident("session_id", session_id)
+                session = db.execute(
+                    "SELECT cell_id, principal_id, expires_at FROM session_bindings "
+                    "WHERE tenant_id=? AND session_id=?",
+                    (base.tenant_id, session_id),
+                ).fetchone()
+                if not session:
+                    raise ScopeError("unknown session")
+                if parse_time(session["expires_at"]) <= self._clock():
+                    raise ScopeError("session expired")
+                if session["cell_id"] != base.cell_id or session["principal_id"] != principal_id:
+                    raise ScopeError("session scope mismatch")
+        return Route(
+            base.tenant_id,
+            base.cell_id,
+            channel,
+            channel_account_id,
+            principal_id,
+            session_id,
+        )
+
+    def assert_message_route(self, message: CanonicalMessage) -> Route:
+        route = self.resolve(
+            channel=message.channel,
+            channel_account_id=message.channel_account_id,
+            principal_id=message.principal_id,
+            session_id=message.session_id,
+        )
+        if message.tenant_id != route.tenant_id or message.cell_id != route.cell_id:
+            raise ScopeError("message claims do not match authoritative route")
+        return route
+
+    def assert_context_route(self, context: TenantContext) -> Route:
+        route = self.resolve(
+            channel=context.channel,
+            channel_account_id=context.channel_account_id,
+            principal_id=context.principal_id,
+            session_id=context.session_id,
+        )
+        if context.tenant_id != route.tenant_id or context.cell_id != route.cell_id:
+            raise ScopeError("context claims do not match authoritative route")
+        return route
@@ -0,0 +1,136 @@
+"""V2R1 runtime composition root for authenticated channel ingress."""
+from __future__ import annotations
+
+from dataclasses import dataclass
+from datetime import datetime
+from pathlib import Path
+from typing import Any, Callable, Mapping
+
+from .channel_adapter import ChannelAdapter, IngressResult
+from .identity import (
+    AuthenticationError,
+    IngressAuthenticator,
+    RuntimeIdentity,
+    RuntimeIdentityResolver,
+)
+from .message_ledger import MessageLedger
+from .router import TenantRouter
+from .session_pool import SessionPool
+from .tenant_context import ConflictError, ScopeError, TenantContext, ValidationError, utc_now
+
+
+@dataclass(frozen=True)
+class RuntimeIngressResponse:
+    """Sanitised boundary response; no exception text crosses external ingress."""
+
+    status: str
+    result: IngressResult | None = None
+
+
+class RuntimeWiring:
+    """Own the only external-to-runtime identity binding and message path.
+
+    The request accepted by :meth:`ingest` is an HMAC-authenticated envelope;
+    tenant, cell, channel, account, session, principal, and message claims are
+    signed together.  The envelope is then resolved against ``TenantRouter``.
+    Only that resolved identity can mint the short-lived internal context passed
+    to ``ChannelAdapter``.
+    """
+
+    def __init__(
+        self,
+        *,
+        router: TenantRouter,
+        ledger: MessageLedger,
+        session_pool: SessionPool,
+        channel_adapter: ChannelAdapter,
+        identity_resolver: RuntimeIdentityResolver,
+        ingress_authenticator: IngressAuthenticator,
+        internal_signing_key: bytes,
+        clock: Callable[[], datetime],
+    ) -> None:
+        self.router = router
+        self.ledger = ledger
+        self.session_pool = session_pool
+        self.channel_adapter = channel_adapter
+        self.identity_resolver = identity_resolver
+        self._ingress_authenticator = ingress_authenticator
+        self._internal_signing_key = internal_signing_key
+        self._clock = clock
+
+    @classmethod
+    def create(
+        cls,
+        root: str | Path,
+        *,
+        signing_key: bytes,
+        ingress_hmac_key: bytes | None = None,
+        clock: Callable[[], datetime] = utc_now,
+    ) -> "RuntimeWiring":
+        if not isinstance(signing_key, bytes) or len(signing_key) < 32:
+            raise ValidationError("internal signing key must be at least 32 bytes")
+        # Kept optional for one controlled migration release; the external
+        # request path still cannot supply a TenantContext token.
+        hmac_key = ingress_hmac_key if ingress_hmac_key is not None else signing_key
+        root_path = Path(root)
+        root_path.mkdir(parents=True, exist_ok=True)
+        router = TenantRouter(root_path / "router.sqlite3", clock=clock)
+        ledger = MessageLedger(root_path / "message_ledger.sqlite3")
+        session_pool = SessionPool(router)
+        adapter = ChannelAdapter(
+            router=router,
+            ledger=ledger,
+            session_pool=session_pool,
+            signing_key=signing_key,
+            clock=clock,
+        )
+        return cls(
+            router=router,
+            ledger=ledger,
+            session_pool=session_pool,
+            channel_adapter=adapter,
+            identity_resolver=RuntimeIdentityResolver(router),
+            ingress_authenticator=IngressAuthenticator(hmac_key),
+            internal_signing_key=signing_key,
+            clock=clock,
+        )
+
+    def _issue_internal_context(self, identity: RuntimeIdentity) -> TenantContext:
+        """Mint internal scope only after all claims matched the router route."""
+        return TenantContext.issue(
+            lifetime_seconds=300,
+            now=self._clock(),
+            tenant_id=identity.tenant_id,
+            cell_id=identity.cell_id,
+            principal_id=identity.principal_id,
+            principal_type="authenticated_user",
+            session_id=identity.session_id,
+            task_id=None,
+            channel=identity.channel,
+            channel_account_id=identity.channel_account_id,
+        )
+
+    def ingest(self, *, request: Mapping[str, Any]) -> RuntimeIngressResponse:
+        """Authenticate, resolve, issue internal context, then append and lease.
+
+        The only successful route is ``IngressAuthenticator`` ->
+        ``RuntimeIdentityResolver`` -> ``ChannelAdapter`` ->
+        ``MessageLedger.append`` + ``SessionPool``.  The legacy caller-supplied
+        TenantContext token interface is intentionally not accepted.
+        """
+        try:
+            ingress = self._ingress_authenticator.authenticate(request)
+            identity = self.identity_resolver.resolve(ingress.principal, ingress.claims)
+            context = self._issue_internal_context(identity)
+            result = self.channel_adapter.ingest(
+                token=context.sign(self._internal_signing_key), message=ingress.message
+            )
+            return RuntimeIngressResponse(status="ACCEPTED", result=result)
+        except (AuthenticationError, ScopeError):
+            return RuntimeIngressResponse(status="AUTH_FAILED")
+        except ValidationError:
+            return RuntimeIngressResponse(status="VALIDATION_FAILED")
+        except ConflictError:
+            return RuntimeIngressResponse(status="CONFLICT")
+        except Exception:
+            return RuntimeIngressResponse(status="INTERNAL_ERROR")
@@ -0,0 +1,33 @@
+"""Tenant and Cell scoped secret reference model.
+
+This module never stores secret values. It stores ownership and retrieval scope
+metadata for integration with a real secret broker.
+"""
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Literal
+
+from .tenant_context import ValidationError, require_ident
+
+
+@dataclass(frozen=True)
+class SecretRef:
+    secret_id: str
+    tenant_id: str
+    cell_id: str
+    kind: Literal["channel", "model", "tool", "runtime"]
+    version: str
+    broker_path: str
+
+    def __post_init__(self) -> None:
+        for name in ("secret_id", "cell_id", "version"):
+            require_ident(name, getattr(self, name))
+        require_ident("tenant_id", self.tenant_id, tenant=True)
+        if self.kind not in {"channel", "model", "tool", "runtime"}:
+            raise ValidationError("invalid secret kind")
+        if not self.broker_path.startswith("secret://"):
+            raise ValidationError("secret broker path required")
+
+    def can_be_used_by(self, *, tenant_id: str, cell_id: str) -> bool:
+        return self.tenant_id == tenant_id and self.cell_id == cell_id
@@ -0,0 +1,59 @@
+"""Process-local session lease pool backed by TenantRouter authority."""
+from __future__ import annotations
+
+from dataclasses import dataclass
+from threading import RLock
+
+from .router import Route, TenantRouter
+from .tenant_context import ScopeError, TenantContext
+
+
+@dataclass(frozen=True)
+class SessionLease:
+    tenant_id: str
+    cell_id: str
+    principal_id: str
+    session_id: str
+
+
+class SessionPool:
+    """Tracks active leases without creating a second session authority store."""
+
+    def __init__(self, router: TenantRouter) -> None:
+        self._router = router
+        self._leases: dict[tuple[str, str], SessionLease] = {}
+        self._lock = RLock()
+
+    @staticmethod
+    def _assert_route(context: TenantContext, route: Route) -> None:
+        if (
+            route.tenant_id != context.tenant_id
+            or route.cell_id != context.cell_id
+            or route.principal_id != context.principal_id
+            or route.session_id != context.session_id
+        ):
+            raise ScopeError("session lease does not match authoritative route")
+
+    def assert_available(self, context: TenantContext, route: Route) -> None:
+        """Re-resolve the context from the router before a ledger mutation."""
+        self._assert_route(context, route)
+        self._assert_route(context, self._router.assert_context_route(context))
+
+    def acquire(self, context: TenantContext, route: Route) -> SessionLease:
+        self._assert_route(context, route)
+        lease = SessionLease(
+            tenant_id=context.tenant_id,
+            cell_id=context.cell_id,
+            principal_id=context.principal_id,
+            session_id=context.session_id,
+        )
+        with self._lock:
+            return self._leases.setdefault((lease.tenant_id, lease.session_id), lease)
+
+    def release(self, lease: SessionLease) -> None:
+        with self._lock:
+            self._leases.pop((lease.tenant_id, lease.session_id), None)
+
+    def active_count(self) -> int:
+        with self._lock:
+            return len(self._leases)
@@ -0,0 +1,316 @@
+"""Signed tenant context and canonical message contract for AIOS V2R1."""
+from __future__ import annotations
+
+import base64
+from dataclasses import asdict, dataclass
+from datetime import datetime, timedelta, timezone
+import hashlib
+import hmac
+import json
+import re
+import secrets
+from typing import Any, Mapping
+
+VERSION = "V2R1C0"
+MAX_SAFE_INTEGER = 9_007_199_254_740_991
+TENANT_RE = re.compile(r"^[a-z0-9](?:[a-z0-9-]{0,38}[a-z0-9])?$")
+IDENT_RE = re.compile(r"^[A-Za-z0-9](?:[A-Za-z0-9._:@-]{0,126}[A-Za-z0-9])?$")
+
+
+class V2R1Error(RuntimeError):
+    pass
+
+
+class ValidationError(V2R1Error):
+    pass
+
+
+class ScopeError(V2R1Error):
+    pass
+
+
+class ConflictError(V2R1Error):
+    pass
+
+
+def utc_now() -> datetime:
+    return datetime.now(timezone.utc)
+
+
+def isoformat(value: datetime | None = None) -> str:
+    return (value or utc_now()).astimezone(timezone.utc).isoformat()
+
+
+def parse_time(value: str) -> datetime:
+    if not isinstance(value, str) or not value.strip():
+        raise ValidationError("timestamp must be a non-empty string")
+    text = value.strip()
+    if text.endswith("Z"):
+        text = text[:-1] + "+00:00"
+    try:
+        parsed = datetime.fromisoformat(text)
+    except ValueError as exc:
+        raise ValidationError(f"invalid timestamp: {value!r}") from exc
+    if parsed.tzinfo is None:
+        raise ValidationError("timestamp must include timezone")
+    return parsed.astimezone(timezone.utc)
+
+
+def require_ident(name: str, value: Any, *, tenant: bool = False) -> str:
+    if not isinstance(value, str):
+        raise ValidationError(f"{name} must be a string")
+    value = value.strip()
+    pattern = TENANT_RE if tenant else IDENT_RE
+    if not pattern.fullmatch(value):
+        raise ValidationError(f"invalid {name}: {value!r}")
+    return value
+
+
+def normalize_message_id(value: Any, *, field_name: str = "message_id") -> str:
+    if isinstance(value, bool):
+        raise ValidationError(f"{field_name} cannot be boolean")
+    if isinstance(value, str):
+        value = value.strip()
+        if not value or len(value) > 256 or any(ord(ch) < 32 for ch in value):
+            raise ValidationError(f"invalid {field_name}")
+        return value
+    if isinstance(value, int):
+        if abs(value) > MAX_SAFE_INTEGER:
+            raise ValidationError(f"{field_name} is an unsafe numeric ID")
+        return str(value)
+    raise ValidationError(f"{field_name} must be a lossless string or safe integer")
+
+
+def canonical_json(value: Any) -> bytes:
+    return json.dumps(
+        value, ensure_ascii=False, separators=(",", ":"), sort_keys=True
+    ).encode("utf-8")
+
+
+def _b64(data: bytes) -> str:
+    return base64.urlsafe_b64encode(data).rstrip(b"=").decode("ascii")
+
+
+def _unb64(value: str) -> bytes:
+    return base64.urlsafe_b64decode(value + "=" * (-len(value) % 4))
+
+
+@dataclass(frozen=True)
+class TenantContext:
+    tenant_id: str
+    cell_id: str
+    principal_id: str
+    principal_type: str
+    session_id: str
+    task_id: str | None
+    channel: str
+    channel_account_id: str
+    issued_at: str
+    expires_at: str
+    nonce: str
+
+    def __post_init__(self) -> None:
+        require_ident("tenant_id", self.tenant_id, tenant=True)
+        for name in (
+            "cell_id", "principal_id", "principal_type", "session_id",
+            "channel", "channel_account_id", "nonce",
+        ):
+            require_ident(name, getattr(self, name))
+        if self.task_id is not None:
+            require_ident("task_id", self.task_id)
+        issued = parse_time(self.issued_at)
+        expires = parse_time(self.expires_at)
+        if expires <= issued or expires - issued > timedelta(hours=1):
+            raise ValidationError("invalid tenant context lifetime")
+
+    @classmethod
+    def issue(cls, *, lifetime_seconds: int = 300, now: datetime | None = None, **scope: Any) -> "TenantContext":
+        if not 1 <= lifetime_seconds <= 3600:
+            raise ValidationError("lifetime_seconds must be between 1 and 3600")
+        current = (now or utc_now()).astimezone(timezone.utc)
+        return cls(
+            **scope,
+            issued_at=isoformat(current),
+            expires_at=isoformat(current + timedelta(seconds=lifetime_seconds)),
+            nonce=secrets.token_hex(16),
+        )
+
+    def sign(self, key: bytes) -> str:
+        if len(key) < 32:
+            raise ValidationError("signing key must be at least 32 bytes")
+        payload = _b64(canonical_json(asdict(self)))
+        signature = _b64(hmac.new(key, payload.encode("ascii"), hashlib.sha256).digest())
+        return f"{payload}.{signature}"
+
+    @classmethod
+    def verify(
+        cls,
+        token: str,
+        key: bytes,
+        *,
+        now: datetime | None = None,
+        expected_tenant_id: str | None = None,
+        expected_cell_id: str | None = None,
+    ) -> "TenantContext":
+        if len(key) < 32:
+            raise ValidationError("signing key must be at least 32 bytes")
+        try:
+            payload, encoded_signature = token.split(".", 1)
+            actual = _unb64(encoded_signature)
+            if encoded_signature != _b64(actual):
+                raise ValidationError("non-canonical tenant context signature")
+            data = json.loads(_unb64(payload))
+        except Exception as exc:
+            raise ValidationError("malformed tenant context token") from exc
+        expected = hmac.new(key, payload.encode("ascii"), hashlib.sha256).digest()
+        if not hmac.compare_digest(actual, expected):
+            raise ValidationError("tenant context signature mismatch")
+        context = cls(**data)
+        current = (now or utc_now()).astimezone(timezone.utc)
+        if current < parse_time(context.issued_at) - timedelta(seconds=60):
+            raise ValidationError("tenant context issued in future")
+        if current >= parse_time(context.expires_at):
+            raise ValidationError("tenant context expired")
+        if expected_tenant_id and context.tenant_id != expected_tenant_id:
+            raise ScopeError("tenant mismatch")
+        if expected_cell_id and context.cell_id != expected_cell_id:
+            raise ScopeError("cell mismatch")
+        return context
+
+
+@dataclass(frozen=True)
+class CanonicalMessage:
+    tenant_id: str
+    cell_id: str
+    principal_id: str
+    principal_type: str
+    origin_type: str
+    channel: str
+    channel_account_id: str
+    peer_id: str
+    conversation_id: str
+    session_id: str
+    task_id: str | None
+    event_id: str
+    message_id: str
+    reply_to_message_id: str | None
+    direction: str
+    command_capable: bool
+    occurred_at: str
+    received_at: str
+    body: str
+    quoted_body: str | None
+    adapter_name: str
+    adapter_version: str
+    schema_version: str = "aios.message.v1"
+
+    def __post_init__(self) -> None:
+        if self.schema_version != "aios.message.v1":
+            raise ValidationError("unsupported message schema version")
+        require_ident("tenant_id", self.tenant_id, tenant=True)
+        for name in (
+            "cell_id", "principal_id", "principal_type", "origin_type", "channel",
+            "channel_account_id", "peer_id", "conversation_id", "session_id",
+            "event_id", "adapter_name", "adapter_version",
+        ):
+            require_ident(name, getattr(self, name))
+        if self.task_id is not None:
+            require_ident("task_id", self.task_id)
+        normalize_message_id(self.message_id)
+        if self.reply_to_message_id is not None:
+            normalize_message_id(self.reply_to_message_id, field_name="reply_to_message_id")
+        if self.direction not in {"inbound", "outbound", "internal"}:
+            raise ValidationError("invalid direction")
+        if not isinstance(self.command_capable, bool):
+            raise ValidationError("command_capable must be boolean")
+        parse_time(self.occurred_at)
+        parse_time(self.received_at)
+        if not isinstance(self.body, str):
+            raise ValidationError("body must be a string")
+        if self.quoted_body is not None and not isinstance(self.quoted_body, str):
+            raise ValidationError("quoted_body must be a string or null")
+
+    @classmethod
+    def from_mapping(cls, data: Mapping[str, Any]) -> "CanonicalMessage":
+        content = data.get("content") or {}
+        adapter = data.get("adapter") or {}
+        if not isinstance(content, Mapping) or not isinstance(adapter, Mapping):
+            raise ValidationError("content and adapter must be objects")
+        values = dict(data)
+        return cls(
+            schema_version=values.get("schema_version", "aios.message.v1"),
+            tenant_id=values["tenant_id"],
+            cell_id=values["cell_id"],
+            principal_id=values["principal_id"],
+            principal_type=values["principal_type"],
+            origin_type=values["origin_type"],
+            channel=values["channel"],
+            channel_account_id=values["channel_account_id"],
+            peer_id=values["peer_id"],
+            conversation_id=values["conversation_id"],
+            session_id=values["session_id"],
+            task_id=values.get("task_id"),
+            event_id=values["event_id"],
+            message_id=normalize_message_id(values["message_id"]),
+            reply_to_message_id=(
+                normalize_message_id(values["reply_to_message_id"], field_name="reply_to_message_id")
+                if values.get("reply_to_message_id") is not None else None
+            ),
+            direction=values["direction"],
+            command_capable=values["command_capable"],
+            occurred_at=values["occurred_at"],
+            received_at=values["received_at"],
+            body=content.get("body", ""),
+            quoted_body=content.get("quoted_body"),
+            adapter_name=adapter["name"],
+            adapter_version=adapter["version"],
+        )
+
+    def assert_context(self, context: TenantContext) -> None:
+        fields = (
+            "tenant_id", "cell_id", "principal_id", "session_id", "task_id",
+            "channel", "channel_account_id",
+        )
+        mismatches = [name for name in fields if getattr(self, name) != getattr(context, name)]
+        if mismatches:
+            raise ScopeError("message/context mismatch: " + ", ".join(mismatches))
+
+    @property
+    def is_authenticated_human_command(self) -> bool:
+        return (
+            self.direction == "inbound"
+            and self.command_capable
+            and self.principal_type == "authenticated_user"
+            and self.origin_type == "channel_user"
+        )
+
+
+@dataclass(frozen=True)
+class PolicyDecision:
+    allowed: bool
+    approval_required: bool
+    code: str
+    reason: str
+
+
+READ_ONLY_TOOLS = frozenset({
+    "read", "grep", "glob", "find", "ls", "web_search", "web_fetch",
+    "memory_search", "sessions_list", "sessions_history", "session_status",
+})
+
+
+def evaluate_tool_call(tool_name: str, message: CanonicalMessage) -> PolicyDecision:
+    normalized = tool_name.strip().lower() if isinstance(tool_name, str) else ""
+    if not normalized:
+        return PolicyDecision(False, False, "invalid_tool", "tool name missing")
+    if normalized in READ_ONLY_TOOLS:
+        return PolicyDecision(True, False, "read_only", "read-only operation")
+    if not message.is_authenticated_human_command:
+        return PolicyDecision(
+            False, False, "origin_denied",
+            "side effects require an authenticated current human command",
+        )
+    return PolicyDecision(
+        True, True, "approval_required",
+        "authenticated human side effect requires explicit approval",
+    )
@@ -1,355 +0,0 @@
-"""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,167 +0,0 @@
-"""Fail-closed operation authorization for an isolated Git writer."""
-from __future__ import annotations
-
-import ipaddress
-import os
-import re
-import subprocess
-from dataclasses import dataclass
-from datetime import datetime, timezone
-from pathlib import Path
-from typing import Any
-
-from isolated_writer_token_registry import TokenRegistry
-
-
-ROUTE_OPERATIONS = {
-    ("GET", "/api/runtime-status"): "runtime.status.read",
-    ("GET", "/api/baseline"): "baseline.read",
-    ("GET", "/api/patches"): "patches.read",
-    ("POST", "/api/commit-file"): "commit_file.atomic",
-}
-OID_RE = re.compile(r"[0-9a-f]{40}")
-
-
-class AuthorizationError(PermissionError):
-    def __init__(self, code: str, status: int = 403):
-        super().__init__(code)
-        self.code = code
-        self.status = status
-
-
-@dataclass(frozen=True)
-class AuthorizedGrant:
-    record: dict[str, Any]
-    operation: str
-    use_count: int
-
-    @property
-    def token_id(self) -> str:
-        return str(self.record["token_id"])
-
-    @property
-    def task_id(self) -> str:
-        return str(self.record["task_id"])
-
-
-def operation_for(method: str, path: str) -> str:
-    operation = ROUTE_OPERATIONS.get((method.upper(), path))
-    if not operation:
-        raise AuthorizationError("isolated_writer_operation_forbidden")
-    return operation
-
-
-def _parse_time(value: Any) -> datetime:
-    try:
-        parsed = datetime.fromisoformat(str(value).replace("Z", "+00:00"))
-    except (TypeError, ValueError):
-        raise AuthorizationError("writer_token_time_invalid") from None
-    if parsed.tzinfo is None:
-        raise AuthorizationError("writer_token_time_invalid")
-    return parsed.astimezone(timezone.utc)
-
-
-def _git_is_ancestor(workspace: Path, base: str, branch: str) -> bool:
-    result = subprocess.run(
-        ["git", "merge-base", "--is-ancestor", base, branch],
-        cwd=workspace,
-        stdout=subprocess.DEVNULL,
-        stderr=subprocess.DEVNULL,
-    )
-    return result.returncode == 0
-
-
-def _validate_grant(
-    grant: dict[str, Any],
-    *,
-    audience: str,
-    source_ip: str,
-    operation: str,
-    branch: str | None,
-    path: str | None,
-    workspace: Path,
-    current_time: datetime,
-) -> None:
-    if int(grant.get("schema_version", 0)) != 2:
-        raise AuthorizationError("writer_token_policy_v2_required", 401)
-    if str(grant.get("audience") or "") != audience:
-        raise AuthorizationError("writer_token_audience_rejected")
-    try:
-        peer = ipaddress.ip_address(source_ip)
-        networks = [ipaddress.ip_network(str(value), strict=True) for value in grant.get("source_cidrs", [])]
-    except ValueError:
-        raise AuthorizationError("writer_token_source_rejected") from None
-    if not networks or not any(peer in network for network in networks):
-        raise AuthorizationError("writer_token_source_rejected")
-    created = _parse_time(grant.get("created_at"))
-    not_before = _parse_time(grant.get("not_before"))
-    expires = _parse_time(grant.get("expires_at"))
-    if expires <= not_before or (expires - created).total_seconds() > 1800:
-        raise AuthorizationError("writer_token_lifetime_rejected")
-    if current_time < not_before:
-        raise AuthorizationError("writer_token_not_yet_valid", 401)
-    if current_time >= expires:
-        raise AuthorizationError("writer_token_expired", 401)
-    if bool(grant.get("revoked")):
-        raise AuthorizationError("writer_token_revoked", 401)
-    operations = grant.get("allowed_operations")
-    if not isinstance(operations, list) or operation not in operations:
-        raise AuthorizationError("writer_token_operation_rejected")
-    expected_branch = str(grant.get("allowed_branch") or "")
-    configured_branch = os.getenv("AIOS_GITOPS_ALLOWED_BRANCH", "")
-    if expected_branch != configured_branch:
-        raise AuthorizationError("writer_token_branch_rejected")
-    if branch is not None and branch != expected_branch:
-        raise AuthorizationError("writer_token_branch_rejected")
-    if path is not None:
-        paths = grant.get("allowed_paths")
-        if not isinstance(paths, list) or path not in paths:
-            raise AuthorizationError("writer_token_path_rejected")
-    base = str(grant.get("approved_base_oid") or "").lower()
-    if not OID_RE.fullmatch(base):
-        raise AuthorizationError("writer_token_base_rejected")
-    if not _git_is_ancestor(workspace, base, expected_branch):
-        raise AuthorizationError("writer_token_base_not_ancestor")
-
-
-def authorize(
-    registry: TokenRegistry,
-    token: str,
-    *,
-    method: str,
-    path: str,
-    source_ip: str,
-    workspace: Path,
-    branch: str | None = None,
-    target_path: str | None = None,
-    current_time: datetime | None = None,
-) -> AuthorizedGrant:
-    if os.getenv("AIOS_GITOPS_TOKEN_POLICY_VERSION_REQUIRED", "") != "2":
-        raise AuthorizationError("writer_token_policy_v2_not_required")
-    if not token:
-        raise AuthorizationError("unauthorized", 401)
-    grant = registry.find(token)
-    if grant is None:
-        raise AuthorizationError("unauthorized", 401)
-    operation = operation_for(method, path)
-    _validate_grant(
-        grant,
-        audience=os.getenv("AIOS_GITOPS_SERVICE_AUDIENCE", ""),
-        source_ip=source_ip,
-        operation=operation,
-        branch=branch,
-        path=target_path,
-        workspace=workspace,
-        current_time=current_time or datetime.now(timezone.utc),
-    )
-    limits = grant.get("max_uses")
-    if not isinstance(limits, dict):
-        raise AuthorizationError("writer_token_use_limit_missing")
-    try:
-        used = registry.consume(str(grant["token_id"]), operation, int(limits[operation]))
-    except (KeyError, TypeError, ValueError):
-        raise AuthorizationError("writer_token_use_limit_missing") from None
-    except PermissionError as exc:
-        code = str(exc)
-        raise AuthorizationError(code, 401 if code == "writer_token_revoked" else 403) from None
-    return AuthorizedGrant(grant, operation, used)
@@ -1,403 +0,0 @@
-"""Atomic, idempotent commit-file Saga for the isolated writer."""
-from __future__ import annotations
-
-import fcntl
-import hashlib
-import json
-import os
-import re
-import sqlite3
-import subprocess
-import tempfile
-import threading
-from pathlib import Path
-from typing import Any
-
-import aios_isolated_writer_policy as policy
-
-
-OID_RE = re.compile(r"[0-9a-f]{40}")
-IDEMPOTENCY_RE = re.compile(r"[A-Za-z0-9][A-Za-z0-9._:-]{7,127}")
-STATES = frozenset({
-    "PENDING", "FILE_WRITTEN", "COMMITTED", "PUSHED", "VERIFIED", "COMPLETED",
-    "FAILED_RECOVERABLE", "MANUAL_REVIEW_REQUIRED",
-})
-_LOCKS: dict[str, threading.Lock] = {}
-_LOCKS_GUARD = threading.Lock()
-_LEDGER_INIT_LOCK = threading.Lock()
-
-
-class CommitFileError(RuntimeError):
-    def __init__(self, code: str, status: int = 400):
-        super().__init__(code)
-        self.code = code
-        self.status = status
-
-
-class SimulatedCrash(RuntimeError):
-    pass
-
-
-def canonical_digest(data: dict[str, Any]) -> str:
-    payload = {
-        "branch": data["branch"],
-        "path": data["path"],
-        "content_sha256": hashlib.sha256(data["content"].encode("utf-8")).hexdigest(),
-        "message": data["message"],
-        "expected_head_oid": data["expected_head_oid"],
-    }
-    encoded = json.dumps(payload, sort_keys=True, separators=(",", ":")).encode("utf-8")
-    return hashlib.sha256(encoded).hexdigest()
-
-
-class OperationLedger:
-    def __init__(self, path: Path | str):
-        self.path = Path(path)
-        self.path.parent.mkdir(parents=True, exist_ok=True)
-        if self.path.parent.is_symlink() or self.path.is_symlink():
-            raise PermissionError("writer_operation_ledger_symlink_rejected")
-        with _LEDGER_INIT_LOCK:
-            with self.connect() as db:
-                db.execute(
-                    """
-                    CREATE TABLE IF NOT EXISTS writer_operations (
-                        operation_id TEXT PRIMARY KEY,
-                        token_id TEXT NOT NULL,
-                        task_id TEXT NOT NULL,
-                        idempotency_key TEXT NOT NULL UNIQUE,
-                        operation_digest TEXT NOT NULL,
-                        branch TEXT NOT NULL,
-                        path TEXT NOT NULL,
-                        content_sha256 TEXT NOT NULL,
-                        pre_head_oid TEXT NOT NULL,
-                        commit_oid TEXT,
-                        push_status TEXT,
-                        verification_status TEXT,
-                        state TEXT NOT NULL,
-                        created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
-                        updated_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
-                        error_code TEXT
-                    )
-                    """
-                )
-        os.chmod(self.path, 0o600)
-
-    def connect(self) -> sqlite3.Connection:
-        db = sqlite3.connect(self.path, timeout=30)
-        db.row_factory = sqlite3.Row
-        db.execute("PRAGMA journal_mode=WAL")
-        db.execute("PRAGMA synchronous=FULL")
-        return db
-
-    def get_or_create(self, grant: Any, data: dict[str, Any], digest: str) -> dict[str, Any]:
-        key = data["idempotency_key"]
-        with self.connect() as db:
-            db.execute("BEGIN IMMEDIATE")
-            row = db.execute(
-                "SELECT * FROM writer_operations WHERE idempotency_key=?", (key,)
-            ).fetchone()
-            if row:
-                db.commit()
-                record = dict(row)
-                if record["operation_digest"] != digest:
-                    raise CommitFileError("writer_idempotency_conflict", 409)
-                if (
-                    record["token_id"] != grant.token_id
-                    or record["task_id"] != grant.task_id
-                ):
-                    raise CommitFileError("writer_idempotency_owner_conflict", 409)
-                return record
-            operation_id = hashlib.sha256(
-                f"{grant.task_id}\0{key}".encode("utf-8")
-            ).hexdigest()
-            content_sha = hashlib.sha256(data["content"].encode("utf-8")).hexdigest()
-            db.execute(
-                """
-                INSERT INTO writer_operations(
-                    operation_id,token_id,task_id,idempotency_key,operation_digest,
-                    branch,path,content_sha256,pre_head_oid,state
-                ) VALUES(?,?,?,?,?,?,?,?,?,?)
-                """,
-                (
-                    operation_id, grant.token_id, grant.task_id, key, digest,
-                    data["branch"], data["path"], content_sha,
-                    data["expected_head_oid"], "PENDING",
-                ),
-            )
-            db.commit()
-        return self.get(key)
-
-    def get(self, key: str) -> dict[str, Any]:
-        with self.connect() as db:
-            row = db.execute(
-                "SELECT * FROM writer_operations WHERE idempotency_key=?", (key,)
-            ).fetchone()
-        if row is None:
-            raise KeyError(key)
-        return dict(row)
-
-    def update(self, key: str, state: str, **fields: Any) -> dict[str, Any]:
-        if state not in STATES:
-            raise ValueError("invalid writer operation state")
-        allowed = {"commit_oid", "push_status", "verification_status", "error_code"}
-        assignments = ["state=?", "updated_at=CURRENT_TIMESTAMP"]
-        values: list[Any] = [state]
-        for name, value in fields.items():
-            if name not in allowed:
-                raise ValueError("invalid ledger field")
-            assignments.append(f"{name}=?")
-            values.append(value)
-        values.append(key)
-        with self.connect() as db:
-            db.execute("BEGIN IMMEDIATE")
-            db.execute(
-                f"UPDATE writer_operations SET {','.join(assignments)} WHERE idempotency_key=?",
-                values,
-            )
-            db.commit()
-        return self.get(key)
-
-
-class AtomicCommitFile:
-    def __init__(
-        self,
-        *,
-        workspace: Path,
-        bare_repo: Path,
-        ledger: OperationLedger,
-        remote: str,
-        audit,
-        crash_after_state: str | None = None,
-    ):
-        self.workspace = workspace
-        self.bare_repo = bare_repo
-        self.ledger = ledger
-        self.remote = remote
-        self.audit = audit
-        self.crash_after_state = crash_after_state
-
-    def _git(self, *args: str, check: bool = True) -> str:
-        result = subprocess.run(
-            ["git", *args], cwd=self.workspace, text=True, capture_output=True
-        )
-        if check and result.returncode != 0:
-            raise CommitFileError("writer_git_operation_failed", 500)
-        return result.stdout.strip()
-
-    def _transition(self, key: str, state: str, **fields: Any) -> dict[str, Any]:
-        record = self.ledger.update(key, state, **fields)
-        if self.crash_after_state == state:
-            raise SimulatedCrash(state)
-        return record
-
-    def _validate(self, data: Any) -> dict[str, Any]:
-        if not isinstance(data, dict):
-            raise CommitFileError("writer_request_object_required")
-        required = ("branch", "path", "content", "message", "expected_head_oid", "idempotency_key")
-        if any(field not in data for field in required):
-            raise CommitFileError("writer_request_incomplete")
-        if data.get("force") or data.get("force_push"):
-            raise CommitFileError("isolated_writer_force_rejected", 403)
-        if set(data) != set(required):
-            raise CommitFileError("writer_request_fields_rejected")
-        item = {field: data[field] for field in required}
-        if item["branch"] != policy.allowed_branch():
-            raise CommitFileError("isolated_writer_branch_rejected", 403)
-        try:
-            item["path"] = policy.validate_path(item["path"], self.workspace)
-        except PermissionError as exc:
-            raise CommitFileError(str(exc), 403) from None
-        if not isinstance(item["content"], str) or "\x00" in item["content"]:
-            raise CommitFileError("writer_content_rejected")
-        try:
-            policy.validate_content_for_path(item["path"], item["content"])
-        except PermissionError as exc:
-            raise CommitFileError(str(exc), 403) from None
-        if len(item["content"].encode("utf-8")) > 1_048_576:
-            raise CommitFileError("writer_content_too_large", 413)
-        message = item["message"]
-        if (
-            not isinstance(message, str)
-            or not 1 <= len(message) <= 200
-            or "\x00" in message
-            or "\n" in message
-            or "\r" in message
-        ):
-            raise CommitFileError("writer_message_rejected")
-        if not isinstance(item["expected_head_oid"], str) or not OID_RE.fullmatch(item["expected_head_oid"]):
-            raise CommitFileError("writer_expected_head_rejected")
-        if not isinstance(item["idempotency_key"], str) or not IDEMPOTENCY_RE.fullmatch(item["idempotency_key"]):
-            raise CommitFileError("writer_idempotency_key_rejected")
-        return item
-
-    def _atomic_write(self, relative: str, content: str) -> None:
-        target = self.workspace / relative
-        target.parent.mkdir(parents=True, exist_ok=True)
-        fd, temporary = tempfile.mkstemp(prefix=".writer-", dir=target.parent)
-        try:
-            with os.fdopen(fd, "wb", closefd=True) as stream:
-                stream.write(content.encode("utf-8"))
-                stream.flush()
-                os.fsync(stream.fileno())
-            os.replace(temporary, target)
-            parent_fd = os.open(target.parent, os.O_RDONLY | getattr(os, "O_DIRECTORY", 0))
-            try:
-                os.fsync(parent_fd)
-            finally:
-                os.close(parent_fd)
-        finally:
-            if os.path.exists(temporary):
-                os.unlink(temporary)
-
-    def _verify_remote(self, branch: str, oid: str) -> None:
-        bare = subprocess.run(
-            ["git", "--git-dir", str(self.bare_repo), "rev-parse", f"refs/heads/{branch}"],
-            text=True, capture_output=True,
-        )
-        if bare.returncode != 0 or bare.stdout.strip() != oid:
-            raise CommitFileError("writer_authoritative_bare_oid_mismatch", 500)
-        remote = subprocess.run(
-            ["git", "ls-remote", "--heads", self.remote, f"refs/heads/{branch}"],
-            cwd=self.workspace, text=True, capture_output=True,
-        )
-        if remote.returncode != 0:
-            raise CommitFileError("writer_gitea_verification_failed", 503)
-        fields = remote.stdout.strip().split()
-        if len(fields) != 2:
-            raise CommitFileError("writer_gitea_ref_missing", 503)
-        if fields[0] != oid:
-            raise CommitFileError("writer_gitea_oid_conflict", 409)
-
-    def execute(self, grant: Any, raw_data: Any) -> dict[str, Any]:
-        data = self._validate(raw_data)
-        digest = canonical_digest(data)
-        branch = data["branch"]
-        with _LOCKS_GUARD:
-            lock = _LOCKS.setdefault(branch, threading.Lock())
-        lock_path = self.ledger.path.parent / f"{hashlib.sha256(branch.encode()).hexdigest()}.lock"
-        with lock, open(lock_path, "a+b") as branch_lock:
-            fcntl.flock(branch_lock.fileno(), fcntl.LOCK_EX)
-            return self._execute_locked(grant, data, digest)
-
-    def _execute_locked(self, grant: Any, data: dict[str, Any], digest: str) -> dict[str, Any]:
-        key = data["idempotency_key"]
-        record = self.ledger.get_or_create(grant, data, digest)
-        if record["state"] == "COMPLETED":
-            return self._result(record, idempotent=True)
-        if self._git("rev-parse", "--abbrev-ref", "HEAD") != data["branch"]:
-            record = self._transition(
-                key, "MANUAL_REVIEW_REQUIRED", error_code="writer_current_branch_conflict"
-            )
-            self._audit(grant, data, digest, record, "manual_review_required")
-            raise CommitFileError("writer_current_branch_conflict", 409)
-        head = self._git("rev-parse", "HEAD")
-        commit_oid = record.get("commit_oid")
-        if head != record["pre_head_oid"] and head != commit_oid:
-            record = self._transition(
-                key, "MANUAL_REVIEW_REQUIRED", error_code="writer_branch_head_conflict"
-            )
-            self._audit(grant, data, digest, record, "manual_review_required")
-            raise CommitFileError("writer_branch_head_conflict", 409)
-        try:
-            state = record["state"]
-            if state == "MANUAL_REVIEW_REQUIRED":
-                raise CommitFileError("writer_manual_review_required", 409)
-            if state == "FAILED_RECOVERABLE":
-                if record.get("push_status") == "confirmed":
-                    state = "PUSHED"
-                else:
-                    state = "COMMITTED" if commit_oid else "FILE_WRITTEN"
-            if state == "PENDING":
-                self._atomic_write(data["path"], data["content"])
-                record = self._transition(key, "FILE_WRITTEN")
-                state = record["state"]
-            if state == "FILE_WRITTEN":
-                actual_sha = hashlib.sha256(
-                    (self.workspace / data["path"]).read_bytes()
-                ).hexdigest()
-                if actual_sha != record["content_sha256"]:
-                    raise CommitFileError("writer_file_content_conflict", 409)
-                staged_before = self._git("diff", "--cached", "--name-only", check=False).splitlines()
-                if staged_before:
-                    raise CommitFileError("writer_extra_staged_files_rejected", 409)
-                self._git("add", "--", data["path"])
-                staged = self._git("diff", "--cached", "--name-only").splitlines()
-                if staged != [data["path"]]:
-                    raise CommitFileError("writer_extra_staged_files_rejected", 409)
-                self._git("commit", "-m", data["message"])
-                commit_oid = self._git("rev-parse", "HEAD")
-                record = self._transition(key, "COMMITTED", commit_oid=commit_oid)
-                state = record["state"]
-            if state == "COMMITTED":
-                commit_oid = str(record["commit_oid"])
-                pushed = subprocess.run(
-                    ["git", "push", "--porcelain", self.remote, f"HEAD:refs/heads/{data['branch']}"],
-                    cwd=self.workspace, text=True, capture_output=True,
-                )
-                if pushed.returncode != 0:
-                    self._transition(
-                        key, "FAILED_RECOVERABLE",
-                        push_status="failed", error_code="writer_gitea_push_failed",
-                    )
-                    raise CommitFileError("writer_gitea_push_failed", 503)
-                record = self._transition(key, "PUSHED", push_status="confirmed")
-                state = record["state"]
-            if state == "PUSHED":
-                commit_oid = str(record["commit_oid"])
-                self._verify_remote(data["branch"], commit_oid)
-                record = self._transition(
-                    key, "VERIFIED", verification_status="bare+gitea"
-                )
-                state = record["state"]
-            if state == "VERIFIED":
-                record = self._transition(key, "COMPLETED", error_code=None)
-            self._audit(grant, data, digest, record, "completed")
-            return self._result(record, idempotent=False)
-        except SimulatedCrash:
-            raise
-        except CommitFileError as exc:
-            latest = self.ledger.get(key)
-            if latest["state"] not in {"FAILED_RECOVERABLE", "MANUAL_REVIEW_REQUIRED"}:
-                failure_state = (
-                    "MANUAL_REVIEW_REQUIRED"
-                    if exc.code in {
-                        "writer_gitea_oid_conflict",
-                        "writer_file_content_conflict",
-                        "writer_current_branch_conflict",
-                    }
-                    else "FAILED_RECOVERABLE"
-                )
-                latest = self._transition(key, failure_state, error_code=exc.code)
-            self._audit(grant, data, digest, latest, "failed")
-            raise
-
-    def _audit(self, grant: Any, data: dict[str, Any], digest: str, record: dict[str, Any], result: str) -> None:
-        self.audit({
-            "token_id": grant.token_id,
-            "task_id": grant.task_id,
-            "audience": grant.record["audience"],
-            "source_ip": grant.record.get("_source_ip", "socket-peer"),
-            "operation": grant.operation,
-            "branch": data["branch"],
-            "path": data["path"],
-            "idempotency_key": data["idempotency_key"],
-            "operation_digest": digest,
-            "path_policy_sha256": policy.configured_path_policy_sha256(),
-            "pre_head_oid": record["pre_head_oid"],
-            "commit_oid": record.get("commit_oid"),
-            "result": result,
-        })
-
-    @staticmethod
-    def _result(record: dict[str, Any], *, idempotent: bool) -> dict[str, Any]:
-        return {
-            "status": "completed",
-            "state": record["state"],
-            "operation_id": record["operation_id"],
-            "branch": record["branch"],
-            "path": record["path"],
-            "commit_oid": record.get("commit_oid"),
-            "push_status": record.get("push_status"),
-            "verification_status": record.get("verification_status"),
-            "idempotent": idempotent,
-        }
@@ -1,422 +0,0 @@
-"""Strict service-level exact-path policy for isolated Git writers."""
-from __future__ import annotations
-
-import grp
-import hashlib
-import json
-import os
-import re
-import stat
-from dataclasses import dataclass
-from functools import lru_cache
-from pathlib import Path, PurePosixPath, PureWindowsPath
-from typing import Any
-from urllib.parse import unquote
-
-
-MAX_POLICY_BYTES = 65_536
-POLICY_FIELDS = frozenset(
-    {
-        "schema_version",
-        "policy_id",
-        "audience",
-        "repository_identity",
-        "allowed_branch",
-        "allowed_operations",
-    }
-)
-OPERATION_FIELDS = frozenset({"exact_paths", "max_content_bytes", "content_profile"})
-SUPPORTED_OPERATIONS = frozenset({"commit_file.atomic"})
-SUPPORTED_CONTENT_PROFILES = frozenset({"systemd-codex-review-worker-v1"})
-_SECRET_RE = re.compile(
-    r"(?i)(authorization\s*:|bearer\s+|(?:token|password|secret)\s*[:=])"
-)
-_SYSTEMD_NAME_RE = re.compile(r"[A-Za-z][A-Za-z0-9]*\Z")
-_SYSTEMD_MAX_LINE_BYTES = 4096
-_SYSTEMD_ALLOWED_DIRECTIVES = {
-    "Unit": frozenset({"Description", "After", "Wants"}),
-    "Service": frozenset(
-        {
-            "Type",
-            "User",
-            "Group",
-            "WorkingDirectory",
-            "Environment",
-            "ExecStart",
-            "Restart",
-            "RestartSec",
-            "NoNewPrivileges",
-            "PrivateTmp",
-            "PrivateDevices",
-            "ProtectSystem",
-            "ProtectHome",
-            "ProtectKernelTunables",
-            "ProtectKernelModules",
-            "ProtectControlGroups",
-            "LockPersonality",
-            "RestrictSUIDSGID",
-            "RestrictRealtime",
-            "MemoryDenyWriteExecute",
-            "RuntimeDirectory",
-            "StateDirectory",
-            "CacheDirectory",
-            "ReadOnlyPaths",
-            "ReadWritePaths",
-            "UMask",
-        }
-    ),
-    "Install": frozenset({"WantedBy"}),
-}
-_SYSTEMD_MULTI_DIRECTIVES = frozenset(
-    {
-        ("Service", "Environment"),
-        ("Service", "ReadOnlyPaths"),
-        ("Service", "ReadWritePaths"),
-    }
-)
-_SYSTEMD_EXACT_SINGLE_VALUES = {
-    ("Unit", "Description"): "AIOS Codex Review/Test Worker",
-    ("Unit", "After"): "network-online.target",
-    ("Unit", "Wants"): "network-online.target",
-    ("Service", "Type"): "simple",
-    ("Service", "User"): "aiman",
-    ("Service", "Group"): "gitops",
-    (
-        "Service",
-        "WorkingDirectory",
-    ): "/usr/libexec/aios-codex-review-test-worker/current",
-    (
-        "Service",
-        "ExecStart",
-    ): "/usr/bin/python3 -m task_plane.workers.codex_review_test",
-    ("Service", "Restart"): "on-failure",
-    ("Service", "RestartSec"): "2",
-    ("Service", "NoNewPrivileges"): "true",
-    ("Service", "PrivateTmp"): "true",
-    ("Service", "PrivateDevices"): "true",
-    ("Service", "ProtectSystem"): "strict",
-    ("Service", "ProtectHome"): "true",
-    ("Service", "ProtectKernelTunables"): "true",
-    ("Service", "ProtectKernelModules"): "true",
-    ("Service", "ProtectControlGroups"): "true",
-    ("Service", "LockPersonality"): "true",
-    ("Service", "RestrictSUIDSGID"): "true",
-    ("Service", "RestrictRealtime"): "true",
-    ("Service", "MemoryDenyWriteExecute"): "true",
-    ("Service", "RuntimeDirectory"): "aios-codex-review-test-worker",
-    ("Service", "StateDirectory"): "aios-codex-review-test-worker",
-    ("Service", "CacheDirectory"): "aios-codex-review-test-worker",
-    ("Service", "UMask"): "0077",
-    ("Install", "WantedBy"): "multi-user.target",
-}
-_SYSTEMD_EXACT_MULTI_VALUES = {
-    ("Service", "Environment"): (
-        "AIOS_CODEX_WORKER_MODE=shadow",
-        "AIOS_TASK_PLANE_EXECUTION_ENABLED=false",
-        "PYTHONDONTWRITEBYTECODE=1",
-    ),
-    ("Service", "ReadOnlyPaths"): (
-        "/data/aios-gitops/repo.git",
-        "/usr/libexec/aios-codex-review-test-worker",
-    ),
-    ("Service", "ReadWritePaths"): (
-        "/run/aios-codex-review-test-worker",
-        "/var/lib/aios-codex-review-test-worker",
-        "/var/cache/aios-codex-review-test-worker",
-    ),
-}
-
-
-class PathPolicyError(PermissionError):
-    pass
-
-
-@dataclass(frozen=True)
-class OperationPolicy:
-    exact_paths: tuple[str, ...]
-    max_content_bytes: int
-    content_profile: str
-
-
-@dataclass(frozen=True)
-class ServicePathPolicy:
-    schema_version: int
-    policy_id: str
-    audience: str
-    repository_identity: str
-    allowed_branch: str
-    allowed_operations: dict[str, OperationPolicy]
-    sha256: str
-
-    def operation(self, name: str) -> OperationPolicy:
-        try:
-            return self.allowed_operations[name]
-        except KeyError:
-            raise PathPolicyError("isolated_writer_service_operation_rejected") from None
-
-    def require_exact_path(self, operation: str, path: str) -> OperationPolicy:
-        selected = self.operation(operation)
-        if path not in selected.exact_paths:
-            raise PathPolicyError("isolated_writer_service_path_rejected")
-        return selected
-
-
-def _canonical_json(value: Any) -> bytes:
-    return (
-        json.dumps(value, ensure_ascii=False, sort_keys=True, separators=(",", ":"))
-        + "\n"
-    ).encode("utf-8")
-
-
-def validate_relative_path_syntax(path: str) -> str:
-    if not isinstance(path, str):
-        raise PathPolicyError("isolated_writer_path_rejected")
-    if not path or path != path.strip() or "\x00" in path or "\\" in path:
-        raise PathPolicyError("isolated_writer_path_rejected")
-    try:
-        decoded = unquote(path, errors="strict")
-    except (UnicodeDecodeError, ValueError):
-        raise PathPolicyError("isolated_writer_path_rejected") from None
-    if decoded != path:
-        raise PathPolicyError("isolated_writer_path_rejected")
-    posix = PurePosixPath(path)
-    windows = PureWindowsPath(path)
-    parts = path.split("/")
-    if (
-        posix.is_absolute()
-        or windows.is_absolute()
-        or bool(windows.drive)
-        or any(part in {"", ".", ".."} for part in parts)
-    ):
-        raise PathPolicyError("isolated_writer_path_rejected")
-    return path
-
-
-def _require_fields(value: dict[str, Any], allowed: frozenset[str], code: str) -> None:
-    if set(value) != allowed:
-        raise PathPolicyError(code)
-
-
-def _parse_policy(document: Any, canonical: bytes) -> ServicePathPolicy:
-    if not isinstance(document, dict):
-        raise PathPolicyError("isolated_writer_path_policy_object_required")
-    _require_fields(document, POLICY_FIELDS, "isolated_writer_path_policy_fields_rejected")
-    if document["schema_version"] != 1:
-        raise PathPolicyError("isolated_writer_path_policy_schema_rejected")
-    text_fields = (
-        "policy_id",
-        "audience",
-        "repository_identity",
-        "allowed_branch",
-    )
-    if any(
-        not isinstance(document[field], str) or not document[field].strip()
-        for field in text_fields
-    ):
-        raise PathPolicyError("isolated_writer_path_policy_value_rejected")
-    raw_operations = document["allowed_operations"]
-    if not isinstance(raw_operations, dict) or not raw_operations:
-        raise PathPolicyError("isolated_writer_path_policy_operations_rejected")
-    if not set(raw_operations).issubset(SUPPORTED_OPERATIONS):
-        raise PathPolicyError("isolated_writer_path_policy_operations_rejected")
-    operations: dict[str, OperationPolicy] = {}
-    for name, raw in raw_operations.items():
-        if not isinstance(raw, dict):
-            raise PathPolicyError("isolated_writer_path_policy_operation_rejected")
-        _require_fields(
-            raw,
-            OPERATION_FIELDS,
-            "isolated_writer_path_policy_operation_fields_rejected",
-        )
-        paths = raw["exact_paths"]
-        if (
-            not isinstance(paths, list)
-            or not paths
-            or any(not isinstance(item, str) for item in paths)
-        ):
-            raise PathPolicyError("isolated_writer_path_policy_paths_rejected")
-        validated = tuple(validate_relative_path_syntax(item) for item in paths)
-        if len(set(validated)) != len(validated):
-            raise PathPolicyError("isolated_writer_path_policy_paths_rejected")
-        maximum = raw["max_content_bytes"]
-        if not isinstance(maximum, int) or isinstance(maximum, bool) or not 1 <= maximum <= 1_048_576:
-            raise PathPolicyError("isolated_writer_path_policy_size_rejected")
-        profile = raw["content_profile"]
-        if profile not in SUPPORTED_CONTENT_PROFILES:
-            raise PathPolicyError("isolated_writer_path_policy_profile_rejected")
-        operations[name] = OperationPolicy(validated, maximum, profile)
-    return ServicePathPolicy(
-        schema_version=1,
-        policy_id=document["policy_id"],
-        audience=document["audience"],
-        repository_identity=document["repository_identity"],
-        allowed_branch=document["allowed_branch"],
-        allowed_operations=operations,
-        sha256=hashlib.sha256(canonical).hexdigest(),
-    )
-
-
-def load_path_policy(
-    path: Path,
-    *,
-    expected_owner_uid: int = 0,
-    expected_group_gid: int | None = None,
-    expected_parent_mode: int = 0o750,
-    expected_file_mode: int = 0o640,
-) -> ServicePathPolicy:
-    lexical = Path(os.path.abspath(str(path)))
-    if lexical.is_symlink():
-        raise PathPolicyError("isolated_writer_path_policy_symlink_rejected")
-    try:
-        parent_info = lexical.parent.stat(follow_symlinks=False)
-        file_info = lexical.stat(follow_symlinks=False)
-    except FileNotFoundError:
-        raise PathPolicyError("isolated_writer_path_policy_missing") from None
-    if stat.S_ISLNK(parent_info.st_mode) or not stat.S_ISDIR(parent_info.st_mode):
-        raise PathPolicyError("isolated_writer_path_policy_parent_rejected")
-    if stat.S_ISLNK(file_info.st_mode) or not stat.S_ISREG(file_info.st_mode):
-        raise PathPolicyError("isolated_writer_path_policy_file_rejected")
-    if lexical.resolve(strict=True) != lexical:
-        raise PathPolicyError("isolated_writer_path_policy_symlink_rejected")
-    if (
-        parent_info.st_uid != expected_owner_uid
-        or stat.S_IMODE(parent_info.st_mode) != expected_parent_mode
-    ):
-        raise PathPolicyError("isolated_writer_path_policy_parent_permissions_rejected")
-    if (
-        file_info.st_uid != expected_owner_uid
-        or stat.S_IMODE(file_info.st_mode) != expected_file_mode
-    ):
-        raise PathPolicyError("isolated_writer_path_policy_permissions_rejected")
-    if expected_group_gid is not None and (
-        parent_info.st_gid != expected_group_gid or file_info.st_gid != expected_group_gid
-    ):
-        raise PathPolicyError("isolated_writer_path_policy_group_rejected")
-    if file_info.st_size <= 0 or file_info.st_size > MAX_POLICY_BYTES:
-        raise PathPolicyError("isolated_writer_path_policy_file_size_rejected")
-    raw = lexical.read_bytes()
-    try:
-        document = json.loads(raw.decode("utf-8"))
-    except (UnicodeDecodeError, json.JSONDecodeError):
-        raise PathPolicyError("isolated_writer_path_policy_json_rejected") from None
-    canonical = _canonical_json(document)
-    if raw != canonical:
-        raise PathPolicyError("isolated_writer_path_policy_not_canonical")
-    return _parse_policy(document, canonical)
-
-
-@lru_cache(maxsize=1)
-def configured_path_policy() -> ServicePathPolicy | None:
-    configured = os.getenv("AIOS_GITOPS_PATH_POLICY_FILE", "").strip()
-    if not configured:
-        return None
-    if not Path(configured).is_absolute():
-        raise PathPolicyError("isolated_writer_path_policy_path_rejected")
-    try:
-        gitops_gid = grp.getgrnam("gitops").gr_gid
-    except KeyError:
-        raise PathPolicyError("isolated_writer_path_policy_group_rejected") from None
-    loaded = load_path_policy(Path(configured), expected_group_gid=gitops_gid)
-    if loaded.audience != os.getenv("AIOS_GITOPS_SERVICE_AUDIENCE", ""):
-        raise PathPolicyError("isolated_writer_path_policy_audience_rejected")
-    if loaded.repository_identity != os.getenv("AIOS_GITOPS_REPOSITORY_IDENTITY", ""):
-        raise PathPolicyError("isolated_writer_path_policy_repository_rejected")
-    if loaded.allowed_branch != os.getenv("AIOS_GITOPS_ALLOWED_BRANCH", ""):
-        raise PathPolicyError("isolated_writer_path_policy_branch_rejected")
-    return loaded
-
-
-def clear_path_policy_cache() -> None:
-    configured_path_policy.cache_clear()
-
-
-def require_service_path(operation: str, path: str) -> OperationPolicy:
-    loaded = configured_path_policy()
-    if loaded is None:
-        raise PathPolicyError("isolated_writer_service_path_policy_required")
-    return loaded.require_exact_path(operation, path)
-
-
-def configured_path_policy_sha256() -> str | None:
-    loaded = configured_path_policy()
-    return None if loaded is None else loaded.sha256
-
-
-def validate_content(operation: str, path: str, content: str) -> None:
-    selected = require_service_path(operation, path)
-    try:
-        encoded = content.encode("utf-8", errors="strict")
-    except (AttributeError, UnicodeEncodeError):
-        raise PathPolicyError("isolated_writer_systemd_profile_rejected") from None
-    if len(encoded) > selected.max_content_bytes:
-        raise PathPolicyError("isolated_writer_service_content_too_large")
-    if selected.content_profile == "systemd-codex-review-worker-v1":
-        _validate_systemd_codex_review_worker(content)
-        return
-    raise PathPolicyError("isolated_writer_path_policy_profile_rejected")
-
-
-def _validate_systemd_codex_review_worker(content: str) -> None:
-    if not isinstance(content, str):
-        raise PathPolicyError("isolated_writer_systemd_profile_rejected")
-    try:
-        content.encode("utf-8", errors="strict")
-    except UnicodeEncodeError:
-        raise PathPolicyError("isolated_writer_systemd_profile_rejected") from None
-    if (
-        "\x00" in content
-        or "\r" in content
-        or _SECRET_RE.search(content)
-        or not content.endswith("\n")
-    ):
-        raise PathPolicyError("isolated_writer_systemd_profile_rejected")
-
-    sections: set[str] = set()
-    values: dict[tuple[str, str], list[str]] = {}
-    section: str | None = None
-    for line in content.splitlines():
-        if len(line.encode("utf-8")) > _SYSTEMD_MAX_LINE_BYTES:
-            raise PathPolicyError("isolated_writer_systemd_profile_rejected")
-        if not line:
-            continue
-        if line[0].isspace() or line.startswith(("#", ";")):
-            raise PathPolicyError("isolated_writer_systemd_profile_rejected")
-        if line.startswith("[") and line.endswith("]"):
-            candidate = line[1:-1]
-            if (
-                not _SYSTEMD_NAME_RE.fullmatch(candidate)
-                or candidate not in _SYSTEMD_ALLOWED_DIRECTIVES
-                or candidate in sections
-            ):
-                raise PathPolicyError("isolated_writer_systemd_profile_rejected")
-            sections.add(candidate)
-            section = candidate
-            continue
-        if section is None or "=" not in line:
-            raise PathPolicyError("isolated_writer_systemd_profile_rejected")
-        directive, value = line.split("=", 1)
-        if (
-            not _SYSTEMD_NAME_RE.fullmatch(directive)
-            or directive not in _SYSTEMD_ALLOWED_DIRECTIVES[section]
-            or not value
-            or value != value.strip()
-        ):
-            raise PathPolicyError("isolated_writer_systemd_profile_rejected")
-        key = (section, directive)
-        if key in values and key not in _SYSTEMD_MULTI_DIRECTIVES:
-            raise PathPolicyError("isolated_writer_systemd_profile_rejected")
-        values.setdefault(key, []).append(value)
-
-    if sections != set(_SYSTEMD_ALLOWED_DIRECTIVES):
-        raise PathPolicyError("isolated_writer_systemd_profile_rejected")
-    if set(values) != set(_SYSTEMD_EXACT_SINGLE_VALUES) | set(
-        _SYSTEMD_EXACT_MULTI_VALUES
-    ):
-        raise PathPolicyError("isolated_writer_systemd_profile_rejected")
-    for key, expected in _SYSTEMD_EXACT_SINGLE_VALUES.items():
-        if values.get(key) != [expected]:
-            raise PathPolicyError("isolated_writer_systemd_profile_rejected")
-    for key, expected in _SYSTEMD_EXACT_MULTI_VALUES.items():
-        observed = values.get(key, [])
-        if len(observed) != len(set(observed)) or tuple(observed) != expected:
-            raise PathPolicyError("isolated_writer_systemd_profile_rejected")
@@ -1,241 +0,0 @@
-"""Digest-only, task-scoped token registry for isolated writers."""
-from __future__ import annotations
-
-import argparse
-import hashlib
-import hmac
-import json
-import os
-import grp
-import pwd
-import secrets
-import sqlite3
-import stat
-import threading
-from datetime import datetime, timezone
-from pathlib import Path
-from typing import Any
-
-_REGISTRY_INIT_LOCK = threading.Lock()
-
-
-def utc_now() -> str:
-    return datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
-
-
-def token_digest(token: str) -> str:
-    return hashlib.sha256(token.encode("utf-8")).hexdigest()
-
-
-class TokenRegistry:
-    def __init__(self, path: Path | str):
-        self.path = Path(path)
-        self._prepare()
-
-    def _prepare(self) -> None:
-        self.path.parent.mkdir(parents=True, exist_ok=True)
-        if self.path.parent.is_symlink() or self.path.is_symlink():
-            raise PermissionError("writer_token_registry_symlink_rejected")
-        with _REGISTRY_INIT_LOCK:
-            with self._connect() as db:
-                db.executescript(
-                    """
-                    CREATE TABLE IF NOT EXISTS token_grants (
-                        token_id TEXT PRIMARY KEY,
-                        token_digest TEXT NOT NULL UNIQUE,
-                        grant_json TEXT NOT NULL,
-                        revoked INTEGER NOT NULL DEFAULT 0,
-                        created_at TEXT NOT NULL
-                    );
-                    CREATE TABLE IF NOT EXISTS token_uses (
-                        token_id TEXT NOT NULL,
-                        operation TEXT NOT NULL,
-                        use_count INTEGER NOT NULL DEFAULT 0,
-                        PRIMARY KEY(token_id, operation),
-                        FOREIGN KEY(token_id) REFERENCES token_grants(token_id)
-                    );
-                    """
-                )
-        os.chmod(self.path, 0o600)
-
-    def _connect(self) -> sqlite3.Connection:
-        db = sqlite3.connect(self.path, timeout=30, isolation_level=None)
-        db.row_factory = sqlite3.Row
-        db.execute("PRAGMA journal_mode=WAL")
-        db.execute("PRAGMA synchronous=FULL")
-        db.execute("PRAGMA foreign_keys=ON")
-        return db
-
-    def issue(self, grant: dict[str, Any], token: str | None = None) -> tuple[str, dict[str, Any]]:
-        value = token or secrets.token_urlsafe(32)
-        if len(value.encode("utf-8")) < 32:
-            raise ValueError("writer_token_entropy_insufficient")
-        record = dict(grant)
-        record["schema_version"] = 2
-        record["token_digest"] = token_digest(value)
-        record["revoked"] = False
-        record.setdefault("created_at", utc_now())
-        required = (
-            "token_id",
-            "audience",
-            "task_id",
-            "source_cidrs",
-            "allowed_branch",
-            "approved_base_oid",
-            "allowed_operations",
-            "allowed_paths",
-            "not_before",
-            "expires_at",
-            "max_uses",
-            "issued_by",
-        )
-        if any(not record.get(field) for field in required):
-            raise ValueError("writer_token_grant_incomplete")
-        encoded = json.dumps(record, sort_keys=True, separators=(",", ":"))
-        with self._connect() as db:
-            db.execute("BEGIN IMMEDIATE")
-            try:
-                db.execute(
-                    """
-                    INSERT INTO token_grants(token_id, token_digest, grant_json, revoked, created_at)
-                    VALUES(?,?,?,?,?)
-                    """,
-                    (
-                        str(record["token_id"]),
-                        str(record["token_digest"]),
-                        encoded,
-                        0,
-                        str(record["created_at"]),
-                    ),
-                )
-                db.execute("COMMIT")
-            except Exception:
-                db.execute("ROLLBACK")
-                raise
-        return value, record
-
-    def find(self, token: str) -> dict[str, Any] | None:
-        candidate = token_digest(token)
-        with self._connect() as db:
-            rows = db.execute(
-                "SELECT token_digest, grant_json, revoked FROM token_grants"
-            ).fetchall()
-        match = None
-        for row in rows:
-            if hmac.compare_digest(str(row["token_digest"]), candidate):
-                match = dict(json.loads(str(row["grant_json"])))
-                match["revoked"] = bool(row["revoked"])
-        return match
-
-    def consume(self, token_id: str, operation: str, maximum: int) -> int:
-        if maximum < 1:
-            raise PermissionError("writer_token_operation_exhausted")
-        with self._connect() as db:
-            db.execute("BEGIN IMMEDIATE")
-            try:
-                row = db.execute(
-                    "SELECT revoked FROM token_grants WHERE token_id=?",
-                    (token_id,),
-                ).fetchone()
-                if row is None or bool(row["revoked"]):
-                    raise PermissionError("writer_token_revoked")
-                used_row = db.execute(
-                    "SELECT use_count FROM token_uses WHERE token_id=? AND operation=?",
-                    (token_id, operation),
-                ).fetchone()
-                used = int(used_row["use_count"]) if used_row else 0
-                if used >= maximum:
-                    raise PermissionError("writer_token_operation_exhausted")
-                current = used + 1
-                db.execute(
-                    """
-                    INSERT INTO token_uses(token_id, operation, use_count)
-                    VALUES(?,?,?)
-                    ON CONFLICT(token_id, operation)
-                    DO UPDATE SET use_count=excluded.use_count
-                    """,
-                    (token_id, operation, current),
-                )
-                db.execute("COMMIT")
-                return current
-            except Exception:
-                db.execute("ROLLBACK")
-                raise
-
-    def revoke(self, token_id: str) -> bool:
-        with self._connect() as db:
-            db.execute("BEGIN IMMEDIATE")
-            changed = db.execute(
-                "UPDATE token_grants SET revoked=1 WHERE token_id=? AND revoked=0",
-                (token_id,),
-            ).rowcount
-            db.execute("COMMIT")
-        return bool(changed)
-
-    def usage(self, token_id: str, operation: str) -> int:
-        with self._connect() as db:
-            row = db.execute(
-                "SELECT use_count FROM token_uses WHERE token_id=? AND operation=?",
-                (token_id, operation),
-            ).fetchone()
-        return int(row["use_count"]) if row else 0
-
-
-def _write_secret_file(
-    path: Path,
-    token: str,
-    *,
-    owner: str | None = None,
-    group: str | None = None,
-) -> None:
-    path.parent.mkdir(parents=True, exist_ok=True)
-    if path.parent.is_symlink() or path.is_symlink():
-        raise PermissionError("writer_token_file_symlink_rejected")
-    flags = os.O_WRONLY | os.O_CREAT | os.O_EXCL
-    if hasattr(os, "O_NOFOLLOW"):
-        flags |= os.O_NOFOLLOW
-    fd = os.open(path, flags, 0o600)
-    try:
-        if not stat.S_ISREG(os.fstat(fd).st_mode):
-            raise PermissionError("writer_token_file_not_regular")
-        if owner is not None or group is not None:
-            uid = pwd.getpwnam(owner).pw_uid if owner is not None else -1
-            gid = grp.getgrnam(group).gr_gid if group is not None else -1
-            os.fchown(fd, uid, gid)
-        os.write(fd, token.encode("utf-8"))
-        os.fsync(fd)
-    finally:
-        os.close(fd)
-
-
-def main(argv: list[str] | None = None) -> int:
-    parser = argparse.ArgumentParser()
-    parser.add_argument("--registry", required=True)
-    sub = parser.add_subparsers(dest="command", required=True)
-    issue = sub.add_parser("issue")
-    issue.add_argument("--grant-file", required=True)
-    issue.add_argument("--token-file", required=True)
-    issue.add_argument("--owner")
-    issue.add_argument("--group")
-    revoke = sub.add_parser("revoke")
-    revoke.add_argument("--token-id", required=True)
-    args = parser.parse_args(argv)
-    registry = TokenRegistry(args.registry)
-    if args.command == "issue":
-        grant = json.loads(Path(args.grant_file).read_text(encoding="utf-8"))
-        token, record = registry.issue(grant)
-        _write_secret_file(
-            Path(args.token_file),
-            token,
-            owner=args.owner,
-            group=args.group,
-        )
-        print(json.dumps({"token_id": record["token_id"], "created": True}, sort_keys=True))
-        return 0
-    changed = registry.revoke(args.token_id)
-    print(json.dumps({"token_id": args.token_id, "revoked": changed}, sort_keys=True))
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())
@@ -1,564 +0,0 @@
-#!/usr/bin/env python3
-"""Execution-readiness adapters and the fail-closed Shadow controller service."""
-from __future__ import annotations
-
-import argparse
-import base64
-import dataclasses
-import hashlib
-import json
-import os
-import subprocess
-import threading
-import time
-from http import HTTPStatus
-from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
-from pathlib import Path
-from typing import Any, Callable, Mapping, Protocol
-from urllib.parse import parse_qs, urlparse
-
-from cryptography.hazmat.primitives.asymmetric.ed25519 import (
-    Ed25519PrivateKey,
-)
-
-from silent_release_controller import _sanitize, utc_now
-from silent_release_hardening import (
-    BuilderAttestation,
-    CapabilityAuthorizationError,
-    ReleaseRecoveryWorker,
-    SignedApprovalVerifier,
-    SignedReleasePlanApproval,
-    SilentReleaseActionService,
-    TrustedCandidateBundle,
-    _canonical_json,
-    _durable_json,
-    _safe_child,
-)
-
-
-class BuilderSigner(Protocol):
-    @property
-    def key_id(self) -> str:
-        ...
-
-    def sign(self, payload: bytes) -> bytes:
-        ...
-
-
-class LocalTestBuilderSigner:
-    """Ephemeral in-memory signer. It is forbidden for production execution."""
-
-    test_only = True
-
-    def __init__(self, key_id: str, private_key: Ed25519PrivateKey):
-        self._key_id = str(key_id)
-        self._private_key = private_key
-
-    @property
-    def key_id(self) -> str:
-        return self._key_id
-
-    @classmethod
-    def generate(
-        cls, key_id: str = "shadow-builder-test-key"
-    ) -> "LocalTestBuilderSigner":
-        return cls(key_id, Ed25519PrivateKey.generate())
-
-    @property
-    def public_key(self):
-        return self._private_key.public_key()
-
-    def sign(self, payload: bytes) -> bytes:
-        return self._private_key.sign(payload)
-
-
-class ExternalKmsBuilderSigner:
-    """Signer facade whose private operation remains in KMS/HSM."""
-
-    def __init__(
-        self,
-        key_id: str,
-        credential_reference: str,
-        sign_callback: Callable[[str, bytes], bytes],
-    ):
-        if not str(credential_reference).startswith(
-            ("kms://", "hsm://", "secret-manager://")
-        ):
-            raise ValueError("production builder requires a KMS/HSM reference")
-        self._key_id = str(key_id)
-        self.credential_reference = str(credential_reference)
-        self._sign_callback = sign_callback
-
-    @property
-    def key_id(self) -> str:
-        return self._key_id
-
-    def sign(self, payload: bytes) -> bytes:
-        return bytes(self._sign_callback(self.credential_reference, payload))
-
-
-class SignedTrustedBuilderAdapter:
-    """Signs evidence produced by a trusted collector, never caller evidence."""
-
-    def __init__(
-        self,
-        collector: Callable[[Mapping[str, Any]], TrustedCandidateBundle],
-        signer: BuilderSigner,
-    ):
-        self.collector = collector
-        self.signer = signer
-
-    def build(self, intent: Mapping[str, Any]) -> TrustedCandidateBundle:
-        forbidden = {
-            "artifact_sha256",
-            "canary",
-            "checks",
-            "manifest_sha256",
-            "tests",
-            "tree_oid",
-        }
-        if forbidden.intersection(intent):
-            raise CapabilityAuthorizationError(
-                "trusted builder rejects caller-supplied evidence"
-            )
-        unsigned = self.collector(dict(intent))
-        if unsigned.attestation is not None:
-            raise CapabilityAuthorizationError(
-                "collector cannot self-attest its evidence"
-            )
-        candidate = unsigned.candidate
-        test_sha = hashlib.sha256(
-            _canonical_json(_sanitize(candidate.tests))
-        ).hexdigest()
-        canary_sha = hashlib.sha256(
-            _canonical_json(_sanitize(candidate.canary))
-        ).hexdigest()
-        attestation_id = "builder-attestation-" + hashlib.sha256(
-            (
-                candidate.candidate_id
-                + "\0"
-                + candidate.source_commit
-                + "\0"
-                + candidate.artifact_sha256
-            ).encode("utf-8")
-        ).hexdigest()[:24]
-        attestation = BuilderAttestation(
-            builder_attestation_id=attestation_id,
-            builder_key_id=self.signer.key_id,
-            source_commit=candidate.source_commit,
-            tree_oid=candidate.tree_oid,
-            artifact_sha256=candidate.artifact_sha256,
-            manifest_sha256=candidate.manifest_sha256,
-            package_closure_sha256=(
-                unsigned.release_plan.deployment.package_closure_sha256
-            ),
-            test_evidence_sha256=test_sha,
-            canary_evidence_sha256=canary_sha,
-            issued_at=utc_now(),
-            signature="",
-        )
-        attestation = dataclasses.replace(
-            attestation,
-            signature=base64.b64encode(
-                self.signer.sign(attestation.canonical_bytes())
-            ).decode("ascii"),
-        )
-        return dataclasses.replace(unsigned, attestation=attestation)
-
-
-class ApprovalBackendAdapter(Protocol):
-    @property
-    def available(self) -> bool:
-        ...
-
-    def verify(
-        self,
-        approval: SignedReleasePlanApproval,
-        *,
-        candidate,
-        release_plan,
-        policy_sha256: str,
-    ) -> SignedReleasePlanApproval:
-        ...
-
-
-class LocalTestApprovalSigner:
-    """Test-only approval signer used solely for Shadow acceptance."""
-
-    test_only = True
-
-    def __init__(self, key_id: str, private_key: Ed25519PrivateKey):
-        self.key_id = str(key_id)
-        self.private_key = private_key
-
-    @classmethod
-    def generate(
-        cls, key_id: str = "shadow-owner-test-key"
-    ) -> "LocalTestApprovalSigner":
-        return cls(key_id, Ed25519PrivateKey.generate())
-
-    def sign(
-        self, approval: SignedReleasePlanApproval
-    ) -> SignedReleasePlanApproval:
-        unsigned = dataclasses.replace(
-            approval, key_id=self.key_id, signature=""
-        )
-        return dataclasses.replace(
-            unsigned,
-            signature=base64.b64encode(
-                self.private_key.sign(unsigned.canonical_bytes())
-            ).decode("ascii"),
-        )
-
-
-class ProductionApprovalBackendAdapter:
-    """Verification-only production adapter configured by a secret/KMS ref."""
-
-    def __init__(
-        self,
-        verifier: SignedApprovalVerifier,
-        credential_reference: str,
-    ):
-        if not str(credential_reference).startswith(
-            ("kms://", "hsm://", "secret-manager://")
-        ):
-            raise ValueError(
-                "production approval backend requires a KMS/secret reference"
-            )
-        self.verifier = verifier
-        self.credential_reference = str(credential_reference)
-
-    @property
-    def available(self) -> bool:
-        return True
-
-    def verify(
-        self,
-        approval: SignedReleasePlanApproval,
-        *,
-        candidate,
-        release_plan,
-        policy_sha256: str,
-    ) -> SignedReleasePlanApproval:
-        return self.verifier.verify_release_plan(
-            approval, candidate, release_plan, policy_sha256
-        )
-
-
-class UnavailableProductionApprovalBackend:
-    credential_reference = None
-
-    @property
-    def available(self) -> bool:
-        return False
-
-    def verify(self, *args, **kwargs):
-        raise CapabilityAuthorizationError(
-            "production approval backend is not configured"
-        )
-
-
-class LeaderLock:
-    def __init__(self, path: Path):
-        self.path = Path(path)
-        self.handle = None
-
-    def __enter__(self):
-        self.path.parent.mkdir(parents=True, exist_ok=True)
-        os.chmod(self.path.parent, 0o700)
-        self.handle = self.path.open("a+", encoding="utf-8")
-        os.chmod(self.path, 0o600)
-        try:
-            import fcntl
-
-            fcntl.flock(
-                self.handle.fileno(), fcntl.LOCK_EX | fcntl.LOCK_NB
-            )
-        except BlockingIOError as exc:
-            self.handle.close()
-            self.handle = None
-            raise RuntimeError("silent release leader is already active") from exc
-        return self
-
-    def __exit__(self, exc_type, exc, tb):
-        if self.handle is not None:
-            try:
-                import fcntl
-
-                fcntl.flock(self.handle.fileno(), fcntl.LOCK_UN)
-            finally:
-                self.handle.close()
-                self.handle = None
-
-
-class PersistentSilentReleaseController:
-    """Idempotent main-event controller with durable startup/recovery reports."""
-
-    def __init__(
-        self,
-        root: Path,
-        service: SilentReleaseActionService,
-        *,
-        main_probe: Callable[[], str],
-        recovery_worker: ReleaseRecoveryWorker | None = None,
-    ):
-        self.root = Path(root)
-        self.service = service
-        self.main_probe = main_probe
-        self.recovery_worker = recovery_worker
-        self.leader_path = self.root / "controller.leader.lock"
-        self.status_path = self.root / "controller-status.json"
-
-    def startup_verify(self) -> dict[str, Any]:
-        checked = 0
-        failed = 0
-        for journal in sorted(self.service.sagas.root.glob("*.events.jsonl")):
-            candidate_id = journal.name[: -len(".events.jsonl")]
-            saga = self.service.sagas.load(candidate_id)
-            checked += 1
-            if not saga.journal_integrity:
-                failed += 1
-        status = {
-            "checked_sagas": checked,
-            "execution_enabled": self.service.execution_enabled,
-            "failed_closed": failed,
-            "shadow_mode": not self.service.execution_enabled,
-            "side_effects_executed": False,
-            "status": "READY" if failed == 0 else "FAIL_CLOSED",
-        }
-        _durable_json(self.status_path, status)
-        return status
-
-    def run_once(self) -> dict[str, Any]:
-        with LeaderLock(self.leader_path):
-            startup = self.startup_verify()
-            if startup["status"] != "READY":
-                result = {
-                    "execution_enabled": self.service.execution_enabled,
-                    "intent": None,
-                    "notification": None,
-                    "recovery": None,
-                    "shadow_mode": not self.service.execution_enabled,
-                    "side_effects_executed": False,
-                    "startup": startup,
-                    "status": "FAIL_CLOSED",
-                }
-                _durable_json(self.status_path, result)
-                return _sanitize(result)
-            source_commit = str(self.main_probe())
-            event_id = f"main-{source_commit}"
-            intent = self.service.create_release_intent(
-                {"event_id": event_id, "source_commit": source_commit}
-            )
-            notification = None
-            if intent.get("candidate_id"):
-                notification = self.service.ensure_owner_notification(
-                    str(intent["candidate_id"])
-                )
-            recovery = (
-                self.recovery_worker.run_once()
-                if self.recovery_worker is not None
-                else self.service.get_recovery_status()
-            )
-            result = {
-                "execution_enabled": self.service.execution_enabled,
-                "intent": intent,
-                "notification": notification,
-                "recovery": recovery,
-                "shadow_mode": not self.service.execution_enabled,
-                "side_effects_executed": False,
-                "startup": startup,
-            }
-            _durable_json(self.status_path, result)
-            return _sanitize(result)
-
-
-class ShadowActionHandler(BaseHTTPRequestHandler):
-    service: SilentReleaseActionService
-    controller: PersistentSilentReleaseController
-
-    def log_message(self, fmt, *args):
-        return
-
-    def _json(self, payload: Mapping[str, Any], status=HTTPStatus.OK):
-        body = json.dumps(_sanitize(dict(payload)), sort_keys=True).encode()
-        self.send_response(int(status))
-        self.send_header("Content-Type", "application/json")
-        self.send_header("Content-Length", str(len(body)))
-        self.end_headers()
-        self.wfile.write(body)
-
-    def _body(self) -> dict[str, Any]:
-        size = int(self.headers.get("Content-Length", "0"))
-        if size > 1024 * 1024:
-            raise ValueError("request body is too large")
-        return json.loads(self.rfile.read(size) or b"{}")
-
-    def do_GET(self):
-        parsed = urlparse(self.path)
-        query = parse_qs(parsed.query)
-        candidate_id = str((query.get("candidate_id") or [""])[0])
-        try:
-            if parsed.path == "/healthz":
-                return self._json(
-                    {
-                        "execution_enabled": False,
-                        "shadow_mode": True,
-                        "side_effects_executed": False,
-                        "status": "ok",
-                    }
-                )
-            routes = {
-                "/getReleaseCandidate": self.service.get_release_candidate,
-                "/getReleasePlan": self.service.get_release_plan,
-                "/getReleaseAcceptance": self.service.get_acceptance,
-                "/getReleaseSaga": self.service.get_release_saga,
-                "/getCapabilityStatus": self.service.get_capability_status,
-            }
-            if parsed.path in routes:
-                return self._json(routes[parsed.path](candidate_id))
-            if parsed.path == "/getRecoveryStatus":
-                return self._json(self.service.get_recovery_status())
-            self._json({"error": "not_found"}, HTTPStatus.NOT_FOUND)
-        except (ValueError, FileNotFoundError) as exc:
-            self._json(
-                {"error": type(exc).__name__}, HTTPStatus.BAD_REQUEST
-            )
-
-    def do_POST(self):
-        parsed = urlparse(self.path)
-        try:
-            body = self._body()
-            if parsed.path == "/createReleaseIntent":
-                return self._json(self.service.create_release_intent(body))
-            if parsed.path in {
-                "/submitSignedApproval",
-                "/submitOwnerApproval",
-            }:
-                return self._json(self.service.submit_owner_approval(body))
-            if parsed.path == "/startDeployment":
-                return self._json(
-                    self.service.start_deployment(
-                        str(body.get("candidate_id") or "")
-                    )
-                )
-            self._json({"error": "not_found"}, HTTPStatus.NOT_FOUND)
-        except (ValueError, FileNotFoundError, CapabilityAuthorizationError) as exc:
-            self._json(
-                {"error": type(exc).__name__}, HTTPStatus.BAD_REQUEST
-            )
-
-
-def git_main_probe(repository: Path) -> Callable[[], str]:
-    repository = Path(repository)
-
-    def probe() -> str:
-        completed = subprocess.run(
-            [
-                "git",
-                f"--git-dir={repository}",
-                "rev-parse",
-                "refs/heads/main",
-            ],
-            check=True,
-            capture_output=True,
-            text=True,
-            timeout=15,
-            env={"PATH": os.environ.get("PATH", "")},
-        )
-        return completed.stdout.strip()
-
-    return probe
-
-
-def serve_shadow(
-    *,
-    state_root: Path,
-    repository: Path,
-    host: str,
-    port: int,
-    poll_seconds: float,
-) -> None:
-    service = SilentReleaseActionService.shadow(state_root)
-    controller = PersistentSilentReleaseController(
-        state_root,
-        service,
-        main_probe=git_main_probe(repository),
-    )
-    controller.run_once()
-    stop = threading.Event()
-
-    def controller_loop() -> None:
-        while not stop.wait(poll_seconds):
-            try:
-                controller.run_once()
-            except Exception as exc:  # fail closed and keep the API available
-                _durable_json(
-                    controller.status_path,
-                    {
-                        "error": type(exc).__name__,
-                        "execution_enabled": False,
-                        "shadow_mode": True,
-                        "side_effects_executed": False,
-                        "status": "FAIL_CLOSED",
-                    },
-                )
-
-    handler = type(
-        "ConfiguredShadowActionHandler",
-        (ShadowActionHandler,),
-        {"service": service, "controller": controller},
-    )
-    server = ThreadingHTTPServer((host, port), handler)
-    api_thread = threading.Thread(
-        target=server.serve_forever,
-        name="silent-release-shadow-api",
-        daemon=False,
-    )
-    controller_thread = threading.Thread(
-        target=controller_loop,
-        name="silent-release-shadow-controller",
-        daemon=True,
-    )
-    api_thread.start()
-    controller_thread.start()
-    try:
-        while api_thread.is_alive():
-            api_thread.join(timeout=1)
-    finally:
-        stop.set()
-        server.shutdown()
-        server.server_close()
-        controller_thread.join(timeout=max(1.0, poll_seconds + 1.0))
-
-
-def main() -> None:
-    parser = argparse.ArgumentParser()
-    parser.add_argument("--state-root", required=True, type=Path)
-    parser.add_argument("--repository", required=True, type=Path)
-    parser.add_argument("--host", default="127.0.0.1")
-    parser.add_argument("--port", default=18891, type=int)
-    parser.add_argument("--poll-seconds", default=30.0, type=float)
-    arguments = parser.parse_args()
-    if arguments.poll_seconds <= 0:
-        raise SystemExit("poll seconds must be positive")
-    if os.environ.get("AIOS_GITOPS_WRITES_ENABLED", "false").lower() != "false":
-        raise SystemExit("GitOps writes must remain disabled")
-    if (
-        os.environ.get(
-            "AIOS_SILENT_RELEASE_EXECUTION_ENABLED", "false"
-        ).lower()
-        != "false"
-    ):
-        raise SystemExit("Silent Release execution must remain disabled")
-    serve_shadow(
-        state_root=arguments.state_root,
-        repository=arguments.repository,
-        host=arguments.host,
-        port=arguments.port,
-        poll_seconds=arguments.poll_seconds,
-    )
-
-
-if __name__ == "__main__":
-    main()
@@ -1,21 +0,0 @@
-"""Task Plane runtime package."""
-
-from .models import (
-    EvidenceEnvelope,
-    ProbeEvidence,
-    ProbeOutcome,
-    TaskPlan,
-    TaskRecord,
-    TaskStatus,
-    TaskStateTransitionError,
-)
-
-__all__ = [
-    "EvidenceEnvelope",
-    "ProbeEvidence",
-    "ProbeOutcome",
-    "TaskPlan",
-    "TaskRecord",
-    "TaskStatus",
-    "TaskStateTransitionError",
-]
@@ -1,17 +0,0 @@
-"""Adapters for executing tasks via worker backends."""
-
-from .base import WorkerAdapter
-from .openclaw import OpenClawAdapter
-from .codex import CodexAdapter
-from .hermes import HermesAdapter
-from .a2a import A2AAdapter
-from .systemd_worker import SystemdWorkerAdapter
-
-__all__ = [
-    "WorkerAdapter",
-    "OpenClawAdapter",
-    "CodexAdapter",
-    "HermesAdapter",
-    "A2AAdapter",
-    "SystemdWorkerAdapter",
-]
@@ -1,31 +0,0 @@
-from __future__ import annotations
-
-from .base import WorkerAdapter
-
-
-class A2AAdapter(WorkerAdapter):
-    worker_name = "a2a"
-
-    def capabilities(self) -> list[str]:
-        return ["task.exchange", "agent.handoff"]
-
-    def claim(self, task):
-        return {"worker": self.worker_name, "task_id": task.task_id, "status": "claimed"}
-
-    def execute(self, task, claim):
-        return {"worker": self.worker_name, "task_id": task.task_id, "status": "SHADOW_VERIFIED", "claim_id": claim.claim_id, "execution_mode": "shadow", "production_side_effects": False}
-
-    def heartbeat(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "status": "alive"}
-
-    def report_progress(self, claim, progress):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "progress": progress}
-
-    def probe(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "status": claim.status}
-
-    def cancel(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "status": "cancelled"}
-
-    def collect_result(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "result": "not_collected"}
@@ -1,41 +0,0 @@
-"""Base worker adapter contract."""
-
-from __future__ import annotations
-
-import abc
-
-
-class WorkerAdapter(abc.ABC):
-    worker_name = "base"
-
-    @abc.abstractmethod
-    def capabilities(self) -> list[str]:
-        raise NotImplementedError
-
-    @abc.abstractmethod
-    def claim(self, task):
-        raise NotImplementedError
-
-    @abc.abstractmethod
-    def execute(self, task, claim):
-        raise NotImplementedError
-
-    @abc.abstractmethod
-    def heartbeat(self, claim):
-        raise NotImplementedError
-
-    @abc.abstractmethod
-    def report_progress(self, claim, progress):
-        raise NotImplementedError
-
-    @abc.abstractmethod
-    def probe(self, claim):
-        raise NotImplementedError
-
-    @abc.abstractmethod
-    def cancel(self, claim):
-        raise NotImplementedError
-
-    @abc.abstractmethod
-    def collect_result(self, claim):
-        raise NotImplementedError
@@ -1,31 +0,0 @@
-from __future__ import annotations
-
-from .base import WorkerAdapter
-
-
-class CodexAdapter(WorkerAdapter):
-    worker_name = "codex"
-
-    def capabilities(self) -> list[str]:
-        return ["code.read", "code.write.patch", "test.python", "review.security"]
-
-    def claim(self, task):
-        return {"worker": self.worker_name, "task_id": task.task_id, "status": "claimed"}
-
-    def execute(self, task, claim):
-        return {"worker": self.worker_name, "task_id": task.task_id, "status": "SHADOW_VERIFIED", "claim_id": claim.claim_id, "execution_mode": "shadow", "production_side_effects": False}
-
-    def heartbeat(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "status": "alive"}
-
-    def report_progress(self, claim, progress):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "progress": progress}
-
-    def probe(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "status": claim.status}
-
-    def cancel(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "status": "cancelled"}
-
-    def collect_result(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "result": "not_collected"}
@@ -1,31 +0,0 @@
-from __future__ import annotations
-
-from .base import WorkerAdapter
-
-
-class HermesAdapter(WorkerAdapter):
-    worker_name = "hermes"
-
-    def capabilities(self) -> list[str]:
-        return ["architecture.review", "policy.review", "threat.model"]
-
-    def claim(self, task):
-        return {"worker": self.worker_name, "task_id": task.task_id, "status": "claimed"}
-
-    def execute(self, task, claim):
-        return {"worker": self.worker_name, "task_id": task.task_id, "status": "SHADOW_VERIFIED", "claim_id": claim.claim_id, "execution_mode": "shadow", "production_side_effects": False}
-
-    def heartbeat(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "status": "alive"}
-
-    def report_progress(self, claim, progress):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "progress": progress}
-
-    def probe(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "status": claim.status}
-
-    def cancel(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "status": "cancelled"}
-
-    def collect_result(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "result": "not_collected"}
@@ -1,31 +0,0 @@
-from __future__ import annotations
-
-from .base import WorkerAdapter
-
-
-class OpenClawAdapter(WorkerAdapter):
-    worker_name = "openclaw"
-
-    def capabilities(self) -> list[str]:
-        return ["code.read", "code.write.patch", "test.execute", "runtime.shadow"]
-
-    def claim(self, task):
-        return {"worker": self.worker_name, "task_id": task.task_id, "status": "claimed"}
-
-    def execute(self, task, claim):
-        return {"worker": self.worker_name, "task_id": task.task_id, "status": "SHADOW_VERIFIED", "claim_id": claim.claim_id, "execution_mode": "shadow", "production_side_effects": False}
-
-    def heartbeat(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "status": "alive"}
-
-    def report_progress(self, claim, progress):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "progress": progress}
-
-    def probe(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "status": claim.status}
-
-    def cancel(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "status": "cancelled"}
-
-    def collect_result(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "result": "not_collected"}
@@ -1,31 +0,0 @@
-from __future__ import annotations
-
-from .base import WorkerAdapter
-
-
-class SystemdWorkerAdapter(WorkerAdapter):
-    worker_name = "systemd_worker"
-
-    def capabilities(self) -> list[str]:
-        return ["systemd.exec", "runtime.shell"]
-
-    def claim(self, task):
-        return {"worker": self.worker_name, "task_id": task.task_id, "status": "claimed"}
-
-    def execute(self, task, claim):
-        return {"worker": self.worker_name, "task_id": task.task_id, "status": "SHADOW_VERIFIED", "claim_id": claim.claim_id, "execution_mode": "shadow", "production_side_effects": False}
-
-    def heartbeat(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "status": "alive"}
-
-    def report_progress(self, claim, progress):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "progress": progress}
-
-    def probe(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "status": claim.status}
-
-    def cancel(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "status": "cancelled"}
-
-    def collect_result(self, claim):
-        return {"worker": self.worker_name, "claim_id": claim.claim_id, "result": "not_collected"}
@@ -1,27 +0,0 @@
-"""Agent registry abstraction."""
-
-from __future__ import annotations
-
-from .errors import NotFoundError
-
-
-class AgentRegistry:
-    def __init__(self):
-        self._agents: dict[str, dict] = {}
-
-    def register(self, agent_id: str, metadata: dict) -> None:
-        self._agents[agent_id] = {"agent_id": agent_id, **metadata}
-
-    def unregister(self, agent_id: str) -> None:
-        if agent_id not in self._agents:
-            raise NotFoundError("agent")
-        del self._agents[agent_id]
-
-    def list(self) -> list[dict]:
-        return list(self._agents.values())
-
-    def get(self, agent_id: str) -> dict:
-        try:
-            return self._agents[agent_id]
-        except KeyError:
-            raise NotFoundError("agent")
@@ -1,557 +0,0 @@
-"""Task Plane HTTP API implementation (stdlib-only)."""
-
-from __future__ import annotations
-
-import json
-import os
-import time
-import uuid
-import urllib.parse
-from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
-from typing import Any, Callable
-
-from .delegation import DelegationEngine
-from .errors import (
-    ConflictError,
-    ForbiddenError,
-    NotFoundError,
-    PayloadTooLargeError,
-    TaskPlaneHTTPError,
-    UnauthorizedError,
-    ValidationError,
-)
-from .evidence import EvidenceService
-from .journal import TaskJournal
-from .lease import LeaseManager
-from .models import (
-    EvidenceEnvelope,
-    ResultEnvelope,
-    TaskPlan,
-    TaskRecord,
-    iso8601_now,
-    contains_secret_text,
-    validate_identifier,
-)
-from .policy import PolicyEngine
-from .store import TaskPlaneStore
-from .worker_registry import WorkerRegistry
-
-
-def _json_payload(data: dict[str, Any], status: int = 200) -> tuple[int, bytes]:
-    body = json.dumps(data, ensure_ascii=False).encode("utf-8")
-    return status, body
-
-
-def _bounded_int(value: Any, name: str, minimum: int, maximum: int) -> int:
-    try:
-        number = int(value)
-    except (TypeError, ValueError) as exc:
-        raise ValidationError(f"invalid {name}") from exc
-    if not minimum <= number <= maximum:
-        raise ValidationError(f"invalid {name}")
-    return number
-
-
-class TaskPlaneService:
-    def __init__(self, store: TaskPlaneStore, policy: PolicyEngine | None = None):
-        self.store = store
-        self.policy = policy or PolicyEngine(
-            execution_enabled=False,
-            identity_capabilities={
-                "anon": {"task.creator", "task.read", "task.audit"}
-            },
-        )
-        self.journal = TaskJournal(store)
-        self.lease = LeaseManager(store)
-        self.workers = WorkerRegistry(store)
-        self.evidence = EvidenceService(store)
-        self.delegation = DelegationEngine(store)
-        self.store.probe_attestation_verifier = self.policy.probe_attestation_verifier
-
-    def create_task(self, body: dict[str, Any], idempotency_key: str | None = None) -> dict[str, Any]:
-        if body.get("parent_task_id"):
-            raise ForbiddenError("child tasks must use the delegate endpoint")
-        issuer = body.get("issuer", {})
-        actor = issuer.get("id", "anon") if isinstance(issuer, dict) else "anon"
-        self.policy.assert_allowed("create", actor)
-        try:
-            plan = TaskPlan.from_dict(body)
-        except (TypeError, ValueError) as exc:
-            raise ValidationError("invalid task plan") from exc
-        task = self.store.create_task_with_event(plan, idempotency_key=idempotency_key)
-        return task.to_dict()
-
-    def list_tasks(self, actor: str | None = None) -> list[dict[str, Any]]:
-        if actor is not None:
-            self.policy.assert_allowed("read", actor)
-        return [task.to_dict(include_task=False) for task in self.store.list_tasks()]
-
-    def get_task(self, task_id: str, actor: str | None = None) -> dict[str, Any]:
-        if actor is not None:
-            self.policy.assert_allowed("read", actor, task=self.store.get_task(task_id))
-        return self.store.get_task(task_id).to_dict()
-
-    def get_worker(self, worker_id: str, actor: str | None = None) -> dict[str, Any]:
-        if actor is not None:
-            self.policy.assert_allowed("read", actor)
-        return self.workers.get(worker_id).to_dict()
-
-    def list_workers(self, actor: str | None = None) -> list[dict[str, Any]]:
-        if actor is not None:
-            self.policy.assert_allowed("read", actor)
-        return [w.to_dict() for w in self.workers.list()]
-
-    def register_worker(self, body: dict[str, Any]) -> dict[str, Any]:
-        actor = str(body.get("actor_identity") or body.get("identity") or "")
-        is_admin = actor in self.policy.admin_identities
-        try:
-            existing = self.store.get_worker(str(body.get("worker_id") or ""))
-        except NotFoundError:
-            existing = None
-        if existing is not None and str(body.get("identity") or "") != existing.identity:
-            raise ConflictError("worker identity takeover rejected")
-        self.policy.assert_readonly_worker_registration(actor, body)
-        self.policy.assert_allowed(
-            "worker.admin" if is_admin else "worker.register", actor
-        )
-        try:
-            worker = self.workers.register(
-                body,
-                actor_identity=actor,
-                is_admin=is_admin,
-                expected_revision=body.get("expected_revision"),
-            )
-        except (TypeError, ValueError, KeyError) as exc:
-            raise ValidationError("invalid worker registration") from exc
-        return worker.to_dict()
-
-    def worker_heartbeat(self, worker_id: str, payload: dict[str, Any]) -> dict[str, Any]:
-        interval = payload.get("heartbeat_interval_seconds")
-        actor = str(payload.get("actor_identity") or "")
-        self.policy.assert_readonly_worker_binding(actor, worker_id)
-        self.policy.assert_allowed("worker.register", actor)
-        return self.workers.heartbeat(
-            worker_id,
-            heartbeat_interval_seconds=interval,
-            actor_identity=actor,
-            expected_revision=payload.get("expected_revision"),
-        ).to_dict()
-
-    def disable_worker(self, worker_id: str, payload: dict[str, Any]) -> dict[str, Any]:
-        actor = str(payload.get("actor_identity") or "")
-        self.policy.assert_allowed("worker.admin", actor)
-        return self.store.disable_worker(
-            worker_id,
-            actor_identity=actor,
-            expected_revision=int(payload.get("expected_revision")),
-            reason=str(payload.get("reason") or "disabled by administrator"),
-        ).to_dict()
-
-    def restore_worker(self, worker_id: str, payload: dict[str, Any]) -> dict[str, Any]:
-        actor = str(payload.get("actor_identity") or "")
-        self.policy.assert_allowed("worker.admin", actor)
-        return self.store.restore_worker(
-            worker_id,
-            actor_identity=actor,
-            expected_revision=int(payload.get("expected_revision")),
-        ).to_dict()
-
-    def claim(self, task_id: str, body: dict[str, Any]) -> dict[str, Any]:
-        actor = body.get("actor_identity") or body.get("worker_identity") or "worker"
-        self.policy.assert_allowed("claim", actor)
-        worker_id = body.get("worker_id")
-        if not worker_id:
-            raise ValidationError("worker_id required")
-
-        task = self.store.get_task(task_id)
-        self.policy.assert_readonly_worker_binding(actor, str(worker_id))
-        self.policy.assert_allowed("claim", actor, task=task)
-        lease_seconds = _bounded_int(
-            body.get("lease_seconds", 30), "lease_seconds", 1, 3600
-        )
-        claim = self.lease.claim(
-            task_id=task_id,
-            worker_id=worker_id,
-            worker_identity=actor,
-            lease_seconds=lease_seconds,
-            expected_revision=task.revision,
-            operation_digest=task.task_plan.operation_digest(),
-        )
-        return {"claim_id": claim.claim_id, **claim.to_dict()}
-
-    def heartbeat(self, task_id: str, body: dict[str, Any]) -> dict[str, Any]:
-        claim_id = body.get("claim_id")
-        if not claim_id:
-            raise ValidationError("claim_id required")
-        actor = body.get("actor_identity") or body.get("worker_identity") or "worker"
-        task = self.store.get_task(task_id)
-        claim = self.store.get_claim(claim_id)
-        self.policy.assert_readonly_worker_binding(actor, claim.worker_id)
-        self.policy.assert_allowed("heartbeat", actor, task=task)
-        if claim.worker_identity != actor:
-            raise ForbiddenError("claim identity mismatch")
-        lease_seconds = _bounded_int(
-            body.get("lease_seconds", 30), "lease_seconds", 1, 3600
-        )
-        claim = self.lease.heartbeat(task_id, claim_id, lease_seconds)
-        return {"claim_id": claim_id, "lease_until": claim.lease_until}
-
-    def progress(self, task_id: str, body: dict[str, Any]) -> dict[str, Any]:
-        claim_id = body.get("claim_id")
-        if not claim_id:
-            raise ValidationError("claim_id required")
-        actor = body.get("actor_identity") or body.get("worker_identity") or "worker"
-        progress = body.get("progress")
-        stage = body.get("stage", "RUNNING")
-        message = body.get("message")
-        if progress is None:
-            raise ValidationError("progress required")
-        task = self.store.get_task(task_id)
-        claim = self.store.get_claim(claim_id)
-        self.policy.assert_readonly_worker_binding(actor, claim.worker_id)
-        self.policy.assert_allowed("progress", actor, task=task)
-        if task.task_plan.data_classification == "credential-secret":
-            if message not in {None, ""} or contains_secret_text(stage):
-                raise ValidationError(
-                    "credential-secret progress must contain metadata only"
-                )
-        lease_seconds = _bounded_int(
-            body.get("lease_seconds", 30), "lease_seconds", 1, 3600
-        )
-        claim = self.store.record_progress(
-            task_id,
-            claim_id,
-            actor,
-            progress=progress,
-            stage=str(stage),
-            message=None if message is None else str(message),
-            lease_seconds=lease_seconds,
-        )
-        return {"claim_id": claim.claim_id, "status": claim.status, "progress": progress}
-
-    def complete(self, task_id: str, body: dict[str, Any]) -> dict[str, Any]:
-        claim_id = body.get("claim_id")
-        if not claim_id:
-            raise ValidationError("claim_id required")
-        actor = body.get("actor_identity") or body.get("worker_identity") or "worker"
-        task = self.store.get_task(task_id)
-
-        status = body.get("status", "COMPLETED")
-        outputs = body.get("outputs", [])
-        evidences = body.get("evidence", [])
-        if not isinstance(outputs, list):
-            raise ValidationError("outputs must be list")
-        if not isinstance(evidences, list):
-            raise ValidationError("evidence must be list")
-        if any(not isinstance(ev, dict) for ev in evidences):
-            raise ValidationError("evidence items must be objects")
-        claim = self.store.get_claim(claim_id)
-        self.policy.assert_readonly_worker_binding(actor, claim.worker_id)
-        self.policy.assert_allowed("result", actor, task=task)
-        if claim.worker_identity != actor:
-            raise ForbiddenError("claim identity mismatch")
-        if task.task_plan.data_classification == "credential-secret":
-            allowed_result_keys = {
-                "kind",
-                "hash",
-                "sha256",
-                "count",
-                "status",
-                "error_code",
-                "signature",
-                "attestation_ref",
-            }
-            for entry in [*outputs, *evidences]:
-                if (
-                    not isinstance(entry, dict)
-                    or set(entry) - allowed_result_keys
-                    or contains_secret_text(entry)
-                ):
-                    raise ValidationError(
-                        "credential-secret result must contain hash/count/status only"
-                    )
-
-        result = ResultEnvelope(
-            task_id=task_id,
-            claim_id=claim_id,
-            worker_identity=actor,
-            status=status,
-            outputs=outputs,
-            evidence=evidences,
-            started_at=str(body.get("started_at") or iso8601_now()),
-            completed_at=str(body.get("completed_at") or iso8601_now()),
-            result_digest=body.get("result_digest"),
-            signature=body.get("signature"),
-            attestation_ref=body.get("attestation_ref"),
-            operation_digest=claim.operation_digest,
-        )
-        evidence_decision = self.policy.evidence_verifier.verify(task, evidences)
-        if not evidence_decision.allowed:
-            raise ForbiddenError(evidence_decision.reason)
-        result_decision = self.policy.verify_result(result, task)
-        if not result_decision.allowed:
-            raise ForbiddenError(result_decision.reason)
-        result.result_digest = result.computed_digest()
-        previous = self.store._last_evidence_hash(task_id)
-        evidence_entries = []
-        for evidence in evidences:
-            envelope = EvidenceEnvelope.create(
-                task_id=task_id,
-                claim_id=claim_id,
-                kind=str(evidence.get("kind") or evidence.get("type") or "generic"),
-                worker_identity=actor,
-                payload=evidence,
-                previous_evidence_hash=previous,
-                signature=evidence.get("signature"),
-                attestation_ref=evidence.get("attestation_ref"),
-            )
-            evidence_entries.append(envelope)
-            previous = envelope.evidence_digest
-        self.store.complete_claim_with_evidence_and_event(
-            task_id,
-            claim_id,
-            status
-            if status
-            in {"COMPLETED", "FAILED_FINAL", "FAILED_RECOVERABLE", "CANCELLED"}
-            else "COMPLETED",
-            result.to_dict(),
-            evidence_entries,
-        )
-        return result.to_dict()
-
-    def fail(self, task_id: str, body: dict[str, Any]) -> dict[str, Any]:
-        claim_id = body.get("claim_id")
-        if not claim_id:
-            raise ValidationError("claim_id required")
-        reason = body.get("reason", "failed")
-        actor = body.get("actor_identity") or body.get("worker_identity") or "worker"
-        self.policy.assert_allowed("fail", actor)
-        task = self.store.get_task(task_id)
-        self.policy.assert_allowed("fail", actor, task=task)
-        claim = self.store.get_claim(claim_id)
-        if claim.worker_identity != actor:
-            raise ForbiddenError("claim identity mismatch")
-        status = "FAILED_RECOVERABLE" if body.get("recoverable", False) else "FAILED_FINAL"
-        self.store.fail_claim_with_event(task_id, claim_id, status, str(reason))
-        return {"task_id": task_id, "status": status, "reason": reason}
-
-    def cancel(self, task_id: str, body: dict[str, Any]) -> dict[str, Any]:
-        actor = body.get("actor_identity") or body.get("worker_identity") or "owner"
-        self.policy.assert_allowed("cancel", actor)
-        reason = body.get("reason", "cancelled")
-        task = self.store.get_task(task_id)
-        self.policy.assert_allowed("cancel", actor, task=task)
-        updated = self.store.cancel_task_with_event(
-            task_id, task.revision, reason=reason
-        )
-        return updated.to_dict()
-
-    def delegate(self, task_id: str, body: dict[str, Any]) -> dict[str, Any]:
-        actor = body.get("actor_identity") or "owner"
-        self.policy.assert_allowed("delegate", actor)
-        parent = self.store.get_task(task_id)
-        self.policy.assert_allowed("delegate", actor, task=parent)
-        if "task" in body:
-            try:
-                child_plan = TaskPlan.from_dict(body["task"])
-            except (TypeError, ValueError) as exc:
-                raise ValidationError("invalid child task plan") from exc
-        else:
-            plan_body = dict(body)
-            plan_body.pop("actor_identity", None)
-            try:
-                child_plan = TaskPlan.from_dict(plan_body)
-            except (TypeError, ValueError) as exc:
-                raise ValidationError("invalid child task plan") from exc
-        child_plan.parent_task_id = task_id
-        child = self.delegation.delegate(task_id, child_plan, caller=actor)
-        return child.to_dict()
-
-    def get_events(self, task_id: str, actor: str | None = None) -> list[dict[str, Any]]:
-        if actor is not None:
-            self.policy.assert_allowed("audit", actor, task=self.store.get_task(task_id))
-        self.store.get_task(task_id)
-        return self.store.list_events(task_id)
-
-    def get_evidence(self, task_id: str, actor: str | None = None) -> list[dict[str, Any]]:
-        if actor is not None:
-            self.policy.assert_allowed("audit", actor, task=self.store.get_task(task_id))
-        self.store.get_task(task_id)
-        return self.evidence.list(task_id)
-
-    def get_children(self, task_id: str, actor: str | None = None) -> list[str]:
-        if actor is not None:
-            self.policy.assert_allowed("read", actor, task=self.store.get_task(task_id))
-        self.store.get_task(task_id)
-        return self.store.list_children(task_id)
-
-
-class TaskPlaneRequestHandler(BaseHTTPRequestHandler):
-    service: TaskPlaneService | None = None
-    authenticator: Callable[[str], str | None] | None = None
-    max_body_bytes = 1_000_000
-
-    def log_message(self, format: str, *args: Any) -> None:
-        # BaseHTTPRequestHandler logs the raw request target; suppress it so
-        # attacker-controlled paths or query strings cannot leak credentials.
-        return
-
-    def _json(self) -> tuple[str | None, dict[str, Any]]:
-        try:
-            length = int(self.headers.get("Content-Length", "0"))
-        except ValueError as exc:
-            raise ValidationError("invalid content length") from exc
-        if length < 0:
-            raise ValidationError("invalid content length")
-        if length > self.max_body_bytes:
-            raise PayloadTooLargeError("payload exceeds limit")
-        raw = self.rfile.read(length) if length > 0 else b""
-        if not raw:
-            return None, {}
-        try:
-            decoded = raw.decode("utf-8")
-            payload = json.loads(decoded)
-            if not isinstance(payload, dict):
-                raise ValidationError("JSON payload must be an object")
-            return decoded, payload
-        except (UnicodeDecodeError, json.JSONDecodeError) as exc:
-            raise ValidationError("invalid JSON payload") from exc
-
-    def _response(self, status: int, payload: Any) -> None:
-        encoded = json.dumps(payload, ensure_ascii=False).encode("utf-8")
-        self.send_response(status)
-        self.send_header("Content-Type", "application/json; charset=utf-8")
-        self.send_header("Content-Length", str(len(encoded)))
-        self.end_headers()
-        self.wfile.write(encoded)
-
-    def _authenticated_identity(self) -> str:
-        authenticator = type(self).authenticator
-        if authenticator is None:
-            raise UnauthorizedError("authentication unavailable")
-        header = self.headers.get("Authorization", "")
-        if not header.startswith("Bearer "):
-            raise UnauthorizedError("bearer authentication required")
-        token = header[7:]
-        if not token or any(ord(ch) < 33 for ch in token):
-            raise UnauthorizedError("invalid bearer token")
-        identity = authenticator(token)
-        if not identity:
-            raise UnauthorizedError("invalid credentials")
-        return str(identity)
-
-    def _handle(self, handler):
-        try:
-            if self.service is None:
-                raise TaskPlaneHTTPError("service not configured")
-            result = handler()
-            if isinstance(result, tuple):
-                status, payload = result
-            else:
-                status, payload = 200, result
-            self._response(status, payload)
-        except TaskPlaneHTTPError as exc:
-            self._response(exc.status_code, exc.to_payload())
-        except Exception as exc:  # defensive
-            if isinstance(exc, TaskPlaneHTTPError):
-                raise
-            self._response(
-                500,
-                {"error": "internal_error", "message": "internal server error"},
-            )
-
-    def do_GET(self):  # noqa: N802
-        def route():
-            path = urllib.parse.urlparse(self.path).path
-            parts = [p for p in path.split("/") if p]
-            for part in parts[1:]:
-                if part not in {"events", "evidence", "children", "heartbeat"}:
-                    try:
-                        validate_identifier(part, "resource identifier")
-                    except ValueError as exc:
-                        raise ValidationError("invalid resource identifier") from exc
-            identity = self._authenticated_identity()
-
-            if len(parts) == 1 and parts[0] == "tasks":
-                return 200, self.service.list_tasks(identity)
-            if len(parts) == 2 and parts[0] == "tasks":
-                task_id = parts[1]
-                return 200, self.service.get_task(task_id, identity)
-            if len(parts) == 3 and parts[0] == "tasks" and parts[2] == "events":
-                return 200, self.service.get_events(parts[1], identity)
-            if len(parts) == 3 and parts[0] == "tasks" and parts[2] == "evidence":
-                return 200, self.service.get_evidence(parts[1], identity)
-            if len(parts) == 3 and parts[0] == "tasks" and parts[2] == "children":
-                return 200, self.service.get_children(parts[1], identity)
-            if len(parts) == 1 and parts[0] == "workers":
-                return 200, self.service.list_workers(identity)
-            if len(parts) == 2 and parts[0] == "workers":
-                return 200, self.service.get_worker(parts[1], identity)
-            raise NotFoundError("unknown endpoint")
-
-        self._handle(route)
-
-    def do_POST(self):  # noqa: N802
-        def route():
-            body_text, body = self._json()
-            identity = self._authenticated_identity()
-            path = urllib.parse.urlparse(self.path).path
-            parts = [p for p in path.split("/") if p]
-            headers = {k.lower(): v for k, v in self.headers.items()}
-
-            if len(parts) == 1 and parts[0] == "tasks":
-                issuer = body.get("issuer")
-                if issuer and (
-                    not isinstance(issuer, dict) or issuer.get("id") != identity
-                ):
-                    raise ForbiddenError("issuer identity mismatch")
-                body["issuer"] = {"type": "authenticated", "id": identity}
-                return 201, self.service.create_task(body or {}, headers.get("idempotency-key"))
-            if body.get("actor_identity") not in {None, identity}:
-                raise ForbiddenError("actor identity mismatch")
-            body["actor_identity"] = identity
-            if len(parts) == 3 and parts[0] == "tasks" and parts[2] == "claim":
-                return 200, self.service.claim(parts[1], body or {})
-            if len(parts) == 3 and parts[0] == "tasks" and parts[2] == "heartbeat":
-                return 200, self.service.heartbeat(parts[1], body or {})
-            if len(parts) == 3 and parts[0] == "tasks" and parts[2] == "progress":
-                return 200, self.service.progress(parts[1], body or {})
-            if len(parts) == 3 and parts[0] == "tasks" and parts[2] == "result":
-                return 200, self.service.complete(parts[1], body or {})
-            if len(parts) == 3 and parts[0] == "tasks" and parts[2] == "fail":
-                return 200, self.service.fail(parts[1], body or {})
-            if len(parts) == 3 and parts[0] == "tasks" and parts[2] == "cancel":
-                return 200, self.service.cancel(parts[1], body or {})
-            if len(parts) == 3 and parts[0] == "tasks" and parts[2] == "delegate":
-                return 200, self.service.delegate(parts[1], body or {})
-
-            if len(parts) == 2 and parts[0] == "workers" and parts[1] == "register":
-                if (
-                    body.get("identity") != identity
-                    and identity not in self.service.policy.admin_identities
-                ):
-                    raise ForbiddenError("worker identity mismatch")
-                return 201, self.service.register_worker(body or {})
-            if len(parts) == 3 and parts[0] == "workers" and parts[2] == "heartbeat":
-                return 200, self.service.worker_heartbeat(parts[1], body or {})
-            if len(parts) == 3 and parts[0] == "workers" and parts[2] == "disable":
-                return 200, self.service.disable_worker(parts[1], body or {})
-            if len(parts) == 3 and parts[0] == "workers" and parts[2] == "restore":
-                return 200, self.service.restore_worker(parts[1], body or {})
-            raise NotFoundError("unknown endpoint")
-
-        self._handle(route)
-
-
-def run_server(
-    host: str,
-    port: int,
-    service: TaskPlaneService,
-    *,
-    authenticator: Callable[[str], str | None] | None = None,
-):
-    handler = TaskPlaneRequestHandler
-    handler.service = service
-    handler.authenticator = authenticator
-    server = ThreadingHTTPServer((host, port), handler)
-    server.serve_forever()
@@ -1,36 +0,0 @@
-"""Capability matcher helpers."""
-
-from __future__ import annotations
-
-from fnmatch import fnmatch
-
-
-def _normalize_capability(capability: str) -> str:
-    return capability.strip().lower()
-
-
-def capability_matches(granted: str, required: str) -> bool:
-    granted = _normalize_capability(granted)
-    required = _normalize_capability(required)
-    if granted == required:
-        return True
-    # A granted wildcard such as "test.*" should match required "test.unit"
-    if "*" in granted:
-        return fnmatch(required, granted)
-    # A required wildcard is treated as a suffix/prefix requirement for callers.
-    if "*" in required:
-        return fnmatch(granted, required)
-    return False
-
-
-def has_capabilities(granted_caps: list[str], required_caps: list[str]) -> bool:
-    granted = [_normalize_capability(c) for c in granted_caps]
-    for required in required_caps:
-        required = _normalize_capability(required)
-        if not any(capability_matches(g, required) for g in granted):
-            return False
-    return True
-
-
-def normalize_capabilities(caps: list[str]) -> list[str]:
-    return sorted({_normalize_capability(cap) for cap in caps})
@@ -1,87 +0,0 @@
-"""Delegation guardrails."""
-
-from __future__ import annotations
-
-from .errors import ConflictError, ForbiddenError, NotFoundError
-from .models import Budget, TaskPlan, TaskRecord
-from .store import TaskPlaneStore
-
-
-class DelegationEngine:
-    def __init__(self, store: TaskPlaneStore):
-        self.store = store
-
-    def can_delegate(self, parent_id: str, child_plan: TaskPlan) -> bool:
-        parent = self.store.get_task(parent_id)
-        if parent.status == "COMPLETED":
-            raise ConflictError("cannot delegate completed task")
-        if parent.task_plan.max_delegation_depth <= 0:
-            raise ConflictError("max delegation depth not configured")
-
-        depth = self._depth(parent_id)
-        if depth >= parent.task_plan.max_delegation_depth:
-            raise ConflictError("max delegation depth reached")
-
-        if child_plan.parent_task_id not in {None, parent_id}:
-            raise ConflictError("delegation parent mismatch")
-        current = parent_id
-        while current:
-            if child_plan.task_id and current == child_plan.task_id:
-                raise ConflictError("delegation cycle")
-            current = self.store.parent_of(current)
-        return True
-
-    def delegate(self, parent_id: str, child_plan: TaskPlan, *, caller: str) -> TaskRecord:
-        self.can_delegate(parent_id, child_plan)
-        parent = self.store.get_task(parent_id)
-        if child_plan.required_capabilities and not set(child_plan.required_capabilities).issubset(
-            set(parent.task_plan.required_capabilities or [])
-        ):
-            raise ForbiddenError("child capabilities exceed parent constraints")
-        risk_rank = {"low": 1, "medium": 2, "high": 3}
-        if risk_rank.get(child_plan.risk, 99) > risk_rank.get(parent.task_plan.risk, -1):
-            raise ForbiddenError("child risk exceeds parent constraints")
-        child_plan.parent_task_id = parent_id
-        child_plan.correlation_id = parent.task_plan.correlation_id or parent.task_id
-        child_plan.preferred_workers = parent.task_plan.preferred_workers
-        child_plan.max_delegation_depth = min(
-            child_plan.max_delegation_depth,
-            parent.task_plan.max_delegation_depth,
-        )
-        child_plan.approval_policy = parent.task_plan.approval_policy
-
-        parent_budget = self.store.get_task_budget(parent_id)
-        required = Budget()
-        for name in ("time_seconds", "attempts", "tokens", "cost"):
-            available = getattr(parent_budget, name)
-            requested = getattr(child_plan.budgets, name)
-            if name == "attempts" and requested is None:
-                requested = 1
-            if available is not None:
-                requested = 0 if requested is None else requested
-                if requested > available:
-                    raise ConflictError(f"budget exceeded for {name}")
-                setattr(child_plan.budgets, name, requested)
-            setattr(required, name, requested)
-
-        # A retried identical delegation is a read, not a second budget charge.
-        if child_plan.task_id:
-            try:
-                existing = self.store.get_task(child_plan.task_id)
-            except NotFoundError:
-                existing = None
-            if existing is not None:
-                if (
-                    existing.task_plan.parent_task_id == parent_id
-                    and existing.task_plan.operation_digest()
-                    == child_plan.operation_digest()
-                ):
-                    return existing
-                raise ConflictError("delegation task_id conflict")
-
-        return self.store.delegate_task_with_budget_and_events(
-            parent_id, child_plan, caller=caller
-        )
-
-    def _depth(self, task_id: str) -> int:
-        return self.store._compute_depth(task_id)
@@ -1,71 +0,0 @@
-"""Error types for task plane operations."""
-
-from __future__ import annotations
-
-
-class TaskPlaneError(Exception):
-    """Base exception for API-compatible failures."""
-
-    status_code = 500
-    error_code = "task_plane_error"
-
-    def __init__(self, message: str, *, code: str | None = None, details: dict | None = None):
-        super().__init__(message)
-        self.message = message
-        self.details = details or {}
-        if code:
-            self.error_code = code
-
-    def to_payload(self) -> dict:
-        return {"error": self.error_code, "message": self.message, "details": self.details}
-
-
-class TaskPlaneHTTPError(TaskPlaneError):
-    """Base class with explicit HTTP status."""
-
-    status_code = 500
-
-
-class ValidationError(TaskPlaneHTTPError):
-    status_code = 400
-    error_code = "validation_error"
-
-
-class UnauthorizedError(TaskPlaneHTTPError):
-    status_code = 401
-    error_code = "unauthorized"
-
-
-class ForbiddenError(TaskPlaneHTTPError):
-    status_code = 403
-    error_code = "forbidden"
-
-
-class NotFoundError(TaskPlaneHTTPError):
-    status_code = 404
-    error_code = "not_found"
-
-
-class ConflictError(TaskPlaneHTTPError):
-    status_code = 409
-    error_code = "conflict"
-
-
-class PayloadTooLargeError(TaskPlaneHTTPError):
-    status_code = 413
-    error_code = "payload_too_large"
-
-
-class FailedDependencyError(TaskPlaneHTTPError):
-    status_code = 424
-    error_code = "failed_dependency"
-
-
-class LockedError(TaskPlaneHTTPError):
-    status_code = 423
-    error_code = "locked"
-
-
-class ServiceUnavailableError(TaskPlaneHTTPError):
-    status_code = 503
-    error_code = "service_unavailable"
@@ -1,108 +0,0 @@
-"""CloudEvents-compatible event envelope and durable outbox helpers."""
-
-from __future__ import annotations
-
-from dataclasses import dataclass
-from datetime import datetime, timezone
-from typing import Callable, Protocol
-
-from .store import TaskPlaneStore
-
-
-@dataclass
-class CloudEvent:
-    specversion: str = "1.0"
-    id: str = ""
-    type: str = ""
-    source: str = "spiffe://aios/task-plane"
-    subject: str = ""
-    datacontenttype: str = "application/json"
-    data: dict | None = None
-
-    @property
-    def time(self) -> str:
-        return datetime.now(timezone.utc).replace(microsecond=0).isoformat().replace("+00:00", "Z")
-
-    def asdict(self) -> dict:
-        return {
-            "specversion": self.specversion,
-            "id": self.id,
-            "type": self.type,
-            "source": self.source,
-            "subject": self.subject,
-            "time": self.time,
-            "datacontenttype": self.datacontenttype,
-            "data": self.data or {},
-        }
-
-
-NOT_DELIVERED = "NOT_DELIVERED"
-DELIVERED = "DELIVERED"
-FAILED_DELIVERY = "FAILED"
-
-
-class NotificationAdapter(Protocol):
-    name: str
-
-    def deliver(self, envelope: dict) -> str | None:
-        """Return a provider receipt, or None when delivery is unconfirmed."""
-
-
-class CallbackNotificationAdapter:
-    """Adapter seam for webhook, NATS, GPT, dashboard, and WeChat transports."""
-
-    def __init__(self, name: str, callback: Callable[[dict], str | None]):
-        self.name = name
-        self._callback = callback
-
-    def deliver(self, envelope: dict) -> str | None:
-        return self._callback(envelope)
-
-
-class WebhookAdapter(CallbackNotificationAdapter):
-    def __init__(self, callback: Callable[[dict], str | None]):
-        super().__init__("webhook", callback)
-
-
-class NatsJetStreamAdapter(CallbackNotificationAdapter):
-    def __init__(self, callback: Callable[[dict], str | None]):
-        super().__init__("nats-jetstream", callback)
-
-
-class GPTResultCallbackAdapter(CallbackNotificationAdapter):
-    def __init__(self, callback: Callable[[dict], str | None]):
-        super().__init__("gpt-result-callback", callback)
-
-
-class DashboardAdapter(CallbackNotificationAdapter):
-    def __init__(self, callback: Callable[[dict], str | None]):
-        super().__init__("dashboard", callback)
-
-
-class WeChatGatewayAdapter(CallbackNotificationAdapter):
-    def __init__(self, callback: Callable[[dict], str | None]):
-        super().__init__("wechat-gateway", callback)
-
-
-class DurableOutboxDispatcher:
-    def __init__(self, store: TaskPlaneStore):
-        self.store = store
-
-    def dispatch(self, message_id: str, adapter: NotificationAdapter) -> dict:
-        row = self.store.get_outbox_message(message_id)
-        import json
-
-        envelope = json.loads(row["payload"])
-        try:
-            receipt = adapter.deliver(envelope)
-        except Exception:
-            return self.store.record_outbox_delivery(
-                message_id,
-                receipt=None,
-                error=f"{adapter.name} delivery failed",
-            )
-        return self.store.record_outbox_delivery(
-            message_id,
-            receipt=str(receipt) if receipt else None,
-            error=None if receipt else f"{adapter.name} receipt unavailable",
-        )
@@ -1,31 +0,0 @@
-"""Evidence helpers."""
-
-from __future__ import annotations
-
-import hashlib
-import json
-
-from .store import TaskPlaneStore
-
-
-def evidence_digest(payload: dict) -> str:
-    body = json.dumps(payload, sort_keys=True, separators=(",", ":"))
-    return hashlib.sha256(body.encode("utf-8")).hexdigest()
-
-
-class EvidenceService:
-    def __init__(self, store: TaskPlaneStore):
-        self.store = store
-
-    def add(self, task_id: str, kind: str, payload: dict, worker_identity: str) -> str:
-        return self.store.add_evidence(task_id, kind, payload, worker_identity)
-
-    def list(self, task_id: str) -> list[dict]:
-        return self.store.list_evidence(task_id)
-
-    def verify(self, task_id: str, required_kinds: list[str]) -> bool:
-        evidences = self.list(task_id)
-        observed = {e["kind"] for e in evidences}
-        return set(required_kinds).issubset(
-            observed
-        ) and self.store.verify_evidence_integrity(task_id)
@@ -1,22 +0,0 @@
-"""Event journaling helpers."""
-
-from __future__ import annotations
-
-from .errors import ValidationError
-from .store import TaskPlaneStore
-
-
-class TaskJournal:
-    def __init__(self, store: TaskPlaneStore):
-        self.store = store
-
-    def append(self, task_id: str, event_type: str, data: dict, *, subject: str | None = None) -> None:
-        if not event_type:
-            raise ValidationError("event_type required")
-        self.store.append_event(task_id, event_type, data, subject=subject)
-
-    def list(self, task_id: str) -> list[dict]:
-        return self.store.list_events(task_id)
-
-    def check_chain(self, task_id: str) -> bool:
-        return self.store.verify_event_chain(task_id)
@@ -1,32 +0,0 @@
-"""Claim and lease management helpers."""
-
-from __future__ import annotations
-
-from .errors import LockedError
-from .models import ProbeEvidence
-from .store import TaskPlaneStore
-
-
-class LeaseManager:
-    def __init__(self, store: TaskPlaneStore):
-        self.store = store
-
-    def claim(self, task_id: str, worker_id: str, worker_identity: str, lease_seconds: int, expected_revision: int, operation_digest: str):
-        return self.store.claim_task(task_id, worker_id, worker_identity, lease_seconds, expected_revision, operation_digest)
-
-    def heartbeat(self, task_id: str, claim_id: str, lease_seconds: int):
-        claim = self.store.heartbeat_claim(task_id, claim_id, lease_seconds)
-        return claim
-
-    def probe(self, claim_id: str):
-        claim = self.store.get_claim(claim_id)
-        if claim.status != "ACTIVE":
-            raise LockedError("claim not active")
-        return claim
-
-    def recover(self, task_id: str, claim_id: str, probe: ProbeEvidence):
-        return self.store.recover_expired_claim(
-            task_id,
-            claim_id,
-            probe,
-        )
@@ -1,829 +0,0 @@
-"""Core data models for the task plane."""
-
-from __future__ import annotations
-
-import hashlib
-import json
-import re
-import time
-import uuid
-import urllib.parse
-from enum import StrEnum
-from dataclasses import dataclass, field
-from datetime import datetime, timezone
-from typing import Any
-
-
-SENSITIVE_KEYS = {
-    "secret",
-    "password",
-    "token",
-    "api_key",
-    "access_token",
-    "refresh_token",
-    "authorization",
-    "private_key",
-    "client_secret",
-    "credential",
-}
-IDENTIFIER_RE = re.compile(r"[A-Za-z0-9][A-Za-z0-9._:-]{0,127}")
-TYPE_RE = re.compile(r"[A-Za-z0-9][A-Za-z0-9._-]{0,127}")
-RISK_LEVELS = {"low", "medium", "high"}
-DATA_CLASSIFICATIONS = {
-    "public",
-    "internal",
-    "confidential",
-    "credential-secret",
-}
-SECRET_TEXT_PATTERNS = (
-    re.compile(r"(?i)\bAuthorization\s*:\s*Bearer\s+\S+"),
-    re.compile(r"(?i)\b(?:password|passwd|api[_-]?key|access[_-]?token|secret)\s*[:=]\s*\S+"),
-    re.compile(r"\bsk-[A-Za-z0-9_-]{12,}\b"),
-    re.compile(r"\bAKIA[0-9A-Z]{16}\b"),
-    re.compile(r"-----BEGIN (?:RSA |EC |OPENSSH )?PRIVATE KEY-----"),
-)
-TASK_PLAN_KEYS = {
-    "schema_version",
-    "task_id",
-    "task_type",
-    "issuer",
-    "intent",
-    "required_capabilities",
-    "preferred_workers",
-    "risk",
-    "approval_policy",
-    "dependencies",
-    "max_delegation_depth",
-    "budgets",
-    "evidence_requirements",
-    "parent_task_id",
-    "correlation_id",
-    "metadata",
-    "data_classification",
-    "execution_zone",
-    "network_policy",
-    "logging_policy",
-    "allowed_input_paths",
-    "allowed_output_paths",
-    "output_policy",
-}
-
-
-def _now_ts() -> float:
-    return time.time()
-
-
-def canonical_json(value: Any) -> str:
-    return json.dumps(value, ensure_ascii=False, sort_keys=True, separators=(",", ":"))
-
-
-def compute_sha256_hex(value: Any) -> str:
-    return hashlib.sha256(canonical_json(value).encode("utf-8")).hexdigest()
-
-
-def contains_secret_text(value: Any) -> bool:
-    if isinstance(value, str):
-        return any(pattern.search(value) for pattern in SECRET_TEXT_PATTERNS)
-    if isinstance(value, dict):
-        return any(contains_secret_text(item) for item in value.values())
-    if isinstance(value, (list, tuple)):
-        return any(contains_secret_text(item) for item in value)
-    return False
-
-
-def validate_relative_paths(values: Any, name: str) -> list[str]:
-    paths = _normalize_list(values)
-    for value in paths:
-        decoded = urllib.parse.unquote(value)
-        parts = value.replace("\\", "/").split("/")
-        if (
-            decoded != value
-            or "\\" in value
-            or value.startswith("/")
-            or re.match(r"^[A-Za-z]:", value)
-            or any(part in {"", ".", ".."} for part in parts)
-        ):
-            raise ValueError(f"invalid {name}")
-    return paths
-
-
-def validate_identifier(value: Any, name: str) -> str:
-    text = str(value or "")
-    if (
-        not IDENTIFIER_RE.fullmatch(text)
-        or urllib.parse.unquote(text) != text
-        or any(ord(ch) < 32 or ord(ch) == 127 for ch in text)
-    ):
-        raise ValueError(f"invalid {name}")
-    return text
-
-
-def validate_type(value: Any, name: str) -> str:
-    text = str(value or "")
-    if not TYPE_RE.fullmatch(text):
-        raise ValueError(f"invalid {name}")
-    return text
-
-
-def redact_value(value: Any) -> Any:
-    if isinstance(value, dict):
-        redacted = {}
-        for key, inner in value.items():
-            lowered = str(key).lower()
-            if lowered in SENSITIVE_KEYS or lowered.endswith(
-                ("_password", "_secret", "_access_token", "_refresh_token", "_private_key")
-            ):
-                redacted[key] = "[REDACTED]"
-            else:
-                redacted[key] = redact_value(inner)
-        return redacted
-    if isinstance(value, list):
-        return [redact_value(v) for v in value]
-    if isinstance(value, tuple):
-        return tuple(redact_value(v) for v in value)
-    return value
-
-
-class TaskStateTransitionError(ValueError):
-    pass
-
-
-class TaskStatus(StrEnum):
-    CREATED = "CREATED"
-    QUEUED = "QUEUED"
-    CLAIMED = "CLAIMED"
-    RUNNING = "RUNNING"
-    WAITING_CHILD = "WAITING_CHILD"
-    VERIFYING = "VERIFYING"
-    COMPLETED = "COMPLETED"
-    FAILED_RECOVERABLE = "FAILED_RECOVERABLE"
-    FAILED_FINAL = "FAILED_FINAL"
-    CANCELLED = "CANCELLED"
-    MANUAL_REVIEW_REQUIRED = "MANUAL_REVIEW_REQUIRED"
-
-
-TASK_STATES = {
-    status.value for status in TaskStatus
-}
-
-
-TASK_NEXT_STATES = {
-    "CREATED": {"QUEUED", "CLAIMED", "CANCELLED", "MANUAL_REVIEW_REQUIRED"},
-    "QUEUED": {"CLAIMED", "CANCELLED", "FAILED_RECOVERABLE", "FAILED_FINAL"},
-    "CLAIMED": {"RUNNING", "FAILED_RECOVERABLE", "FAILED_FINAL", "CANCELLED"},
-    "RUNNING": {"VERIFYING", "WAITING_CHILD", "COMPLETED", "FAILED_RECOVERABLE", "FAILED_FINAL", "CANCELLED"},
-    "WAITING_CHILD": {"RUNNING", "VERIFYING", "FAILED_RECOVERABLE", "FAILED_FINAL", "CANCELLED"},
-    "VERIFYING": {"COMPLETED", "FAILED_RECOVERABLE", "FAILED_FINAL", "CANCELLED"},
-    "COMPLETED": set(),
-    "FAILED_RECOVERABLE": {"CLAIMED", "RUNNING", "CANCELLED"},
-    "FAILED_FINAL": set(),
-    "CANCELLED": set(),
-    "MANUAL_REVIEW_REQUIRED": {"RUNNING", "CANCELLED"},
-}
-
-
-@dataclass
-class Budget:
-    time_seconds: int | None = None
-    attempts: int | None = None
-    tokens: int | None = None
-    cost: float | None = None
-
-    @classmethod
-    def from_dict(cls, data: dict[str, Any] | None) -> "Budget":
-        if not data:
-            return cls()
-        if not isinstance(data, dict) or set(data) - {
-            "time_seconds",
-            "attempts",
-            "tokens",
-            "cost",
-        }:
-            raise ValueError("invalid budget")
-        for name in ("time_seconds", "attempts", "tokens", "cost"):
-            value = data.get(name)
-            if value is not None:
-                try:
-                    if float(value) < 0:
-                        raise ValueError("budget values must be non-negative")
-                except (TypeError, ValueError) as exc:
-                    raise ValueError("invalid budget value") from exc
-        return cls(
-            time_seconds=_to_positive_int(data.get("time_seconds")),
-            attempts=_to_positive_int(data.get("attempts")),
-            tokens=_to_positive_int(data.get("tokens")),
-            cost=_to_float(data.get("cost")),
-        )
-
-    def to_dict(self) -> dict[str, Any]:
-        return {
-            "time_seconds": self.time_seconds,
-            "attempts": self.attempts,
-            "tokens": self.tokens,
-            "cost": self.cost,
-        }
-
-    def merge(self, other: "Budget") -> "Budget":
-        return Budget(
-            time_seconds=_first_non_none(self.time_seconds, other.time_seconds),
-            attempts=_first_non_none(self.attempts, other.attempts),
-            tokens=_first_non_none(self.tokens, other.tokens),
-            cost=_first_non_none(self.cost, other.cost),
-        )
-
-
-@dataclass
-class TaskPlan:
-    schema_version: int = 1
-    task_id: str | None = None
-    task_type: str = "code.change"
-    issuer: dict[str, Any] = field(default_factory=dict)
-    intent: str | None = None
-    required_capabilities: list[str] = field(default_factory=list)
-    preferred_workers: list[str] = field(default_factory=list)
-    risk: str = "medium"
-    approval_policy: str = "patch-only"
-    dependencies: list[str] = field(default_factory=list)
-    max_delegation_depth: int = 5
-    budgets: Budget = field(default_factory=Budget)
-    evidence_requirements: list[str] = field(default_factory=list)
-    parent_task_id: str | None = None
-    correlation_id: str | None = None
-    metadata: dict[str, Any] = field(default_factory=dict)
-    data_classification: str = "internal"
-    execution_zone: str = "isolated-development"
-    network_policy: str = "controlled"
-    logging_policy: str = "redacted"
-    allowed_input_paths: list[str] = field(default_factory=list)
-    allowed_output_paths: list[str] = field(default_factory=list)
-    output_policy: str = "standard"
-
-    @classmethod
-    def from_dict(cls, data: dict[str, Any] | None) -> "TaskPlan":
-        if not isinstance(data, dict):
-            raise ValueError("task plan payload must be an object")
-        unknown = set(data) - TASK_PLAN_KEYS
-        if unknown:
-            raise ValueError("unknown task plan fields")
-        if "task_id" not in data or data["task_id"] is None:
-            data = dict(data)
-            data["task_id"] = f"task-{uuid.uuid4()}"
-        risk = str(data.get("risk", "medium"))
-        if risk not in RISK_LEVELS:
-            raise ValueError("invalid risk")
-        issuer = data.get("issuer", {})
-        if not isinstance(issuer, dict):
-            raise ValueError("issuer must be an object")
-        schema_version = int(data.get("schema_version", 1))
-        if schema_version != 1:
-            raise ValueError("unsupported schema_version")
-        max_depth = _to_positive_int(data.get("max_delegation_depth"), default=5)
-        if max_depth is None or max_depth > 32:
-            raise ValueError("invalid max_delegation_depth")
-        classification = str(data.get("data_classification", "internal"))
-        if classification not in DATA_CLASSIFICATIONS:
-            raise ValueError("invalid data_classification")
-        execution_zone = validate_type(
-            data.get("execution_zone", "isolated-development"), "execution_zone"
-        )
-        network_policy = validate_type(
-            data.get("network_policy", "controlled"), "network_policy"
-        )
-        logging_policy = validate_type(
-            data.get("logging_policy", "redacted"), "logging_policy"
-        )
-        output_policy = validate_type(
-            data.get("output_policy", "standard"), "output_policy"
-        )
-        if contains_secret_text(
-            {
-                "intent": data.get("intent"),
-                "metadata": data.get("metadata", {}),
-            }
-        ):
-            raise ValueError("task content contains secret material")
-        if classification == "credential-secret":
-            if execution_zone != "secure-file-transformer":
-                raise ValueError("credential-secret requires secure-file-transformer")
-            if network_policy != "denied":
-                raise ValueError("credential-secret requires network denied")
-            if logging_policy != "metadata-only":
-                raise ValueError("credential-secret requires metadata-only logging")
-            if output_policy != "hash-count-status-only":
-                raise ValueError("credential-secret requires restricted output")
-        return cls(
-            schema_version=schema_version,
-            task_id=validate_identifier(data["task_id"], "task_id"),
-            task_type=validate_type(data.get("task_type", "code.change"), "task_type"),
-            issuer=issuer,
-            intent=data.get("intent"),
-            required_capabilities=_normalize_list(data.get("required_capabilities", [])),
-            preferred_workers=_normalize_list(data.get("preferred_workers", [])),
-            risk=risk,
-            approval_policy=validate_type(
-                data.get("approval_policy", "patch-only"), "approval_policy"
-            ),
-            dependencies=_normalize_list(data.get("dependencies", [])),
-            max_delegation_depth=max_depth,
-            budgets=Budget.from_dict(data.get("budgets")),
-            evidence_requirements=_normalize_list(data.get("evidence_requirements", [])),
-            parent_task_id=data.get("parent_task_id"),
-            correlation_id=data.get("correlation_id"),
-            metadata=data.get("metadata", {}) if isinstance(data.get("metadata", {}), dict) else {},
-            data_classification=classification,
-            execution_zone=execution_zone,
-            network_policy=network_policy,
-            logging_policy=logging_policy,
-            allowed_input_paths=validate_relative_paths(
-                data.get("allowed_input_paths", []), "allowed_input_paths"
-            ),
-            allowed_output_paths=validate_relative_paths(
-                data.get("allowed_output_paths", []), "allowed_output_paths"
-            ),
-            output_policy=output_policy,
-        )
-
-    def to_dict(self, *, redact: bool = False) -> dict[str, Any]:
-        payload = {
-            "schema_version": self.schema_version,
-            "task_id": self.task_id,
-            "task_type": self.task_type,
-            "issuer": self.issuer,
-            "intent": self.intent,
-            "required_capabilities": list(self.required_capabilities),
-            "preferred_workers": list(self.preferred_workers),
-            "risk": self.risk,
-            "approval_policy": self.approval_policy,
-            "dependencies": list(self.dependencies),
-            "max_delegation_depth": self.max_delegation_depth,
-            "budgets": self.budgets.to_dict(),
-            "evidence_requirements": list(self.evidence_requirements),
-            "parent_task_id": self.parent_task_id,
-            "correlation_id": self.correlation_id,
-            "metadata": dict(self.metadata),
-            "data_classification": self.data_classification,
-            "execution_zone": self.execution_zone,
-            "network_policy": self.network_policy,
-            "logging_policy": self.logging_policy,
-            "allowed_input_paths": list(self.allowed_input_paths),
-            "allowed_output_paths": list(self.allowed_output_paths),
-            "output_policy": self.output_policy,
-        }
-        if redact:
-            payload = redact_value(payload)
-        return payload
-
-    def operation_digest(self) -> str:
-        return compute_sha256_hex(self.to_dict())
-
-
-@dataclass
-class TaskRecord:
-    task_id: str
-    status: str
-    revision: int
-    task_plan: TaskPlan
-    created_at: float
-    updated_at: float
-    root_task_id: str
-    idempotency_key: str | None = None
-    failure_reason: str | None = None
-
-    def with_status(self, status: str) -> "TaskRecord":
-        allowed = TASK_NEXT_STATES.get(self.status, set())
-        if status != self.status and (not allowed and self.status not in {"COMPLETED", "FAILED_FINAL", "CANCELLED"}):
-            raise TaskStateTransitionError(f"Cannot transition {self.status} -> {status}")
-        if status not in TASK_STATES:
-            raise TaskStateTransitionError(f"Invalid status {status}")
-        if status != self.status and self.status in TASK_NEXT_STATES and status not in TASK_NEXT_STATES[self.status]:
-            raise TaskStateTransitionError(f"Cannot transition {self.status} -> {status}")
-        return TaskRecord(
-            task_id=self.task_id,
-            status=status,
-            revision=self.revision + 1,
-            task_plan=self.task_plan,
-            created_at=self.created_at,
-            updated_at=_now_ts(),
-            root_task_id=self.root_task_id,
-            idempotency_key=self.idempotency_key,
-            failure_reason=self.failure_reason,
-        )
-
-    def to_dict(self, *, include_task=True, redact_payload: bool = True) -> dict[str, Any]:
-        payload = {
-            "task_id": self.task_id,
-            "status": self.status,
-            "revision": self.revision,
-            "root_task_id": self.root_task_id,
-            "parent_task_id": self.task_plan.parent_task_id,
-            "created_at": _fmt_ts(self.created_at),
-            "updated_at": _fmt_ts(self.updated_at),
-            "failure_reason": self.failure_reason,
-        }
-        if include_task:
-            payload["plan"] = self.task_plan.to_dict(redact=redact_payload)
-        if self.idempotency_key:
-            payload["idempotency_key"] = self.idempotency_key
-        return payload
-
-
-@dataclass
-class WorkerRegistration:
-    worker_id: str
-    worker_type: str
-    identity: str
-    capabilities: list[str]
-    trust_zone: str
-    max_concurrency: int
-    heartbeat_interval_seconds: int
-    supported_protocols: list[str]
-    registered_at: float
-    last_heartbeat: float
-    status: str = "active"
-    disabled: bool = False
-    owner_identity: str = ""
-    registration_revision: int = 1
-    registration_policy: str = "self"
-    created_at: float = 0.0
-    updated_at: float = 0.0
-    disabled_reason: str | None = None
-
-    @classmethod
-    def from_dict(cls, data: dict[str, Any]) -> "WorkerRegistration":
-        if not isinstance(data, dict):
-            raise ValueError("worker registration payload must be an object")
-        now = _now_ts()
-        worker_id = validate_identifier(data.get("worker_id"), "worker_id")
-        worker_type = validate_type(data.get("worker_type"), "worker_type")
-        identity = str(data.get("identity") or "").strip()
-        if not identity or any(ord(ch) < 32 for ch in identity):
-            raise ValueError("invalid identity")
-        max_concurrency = _to_positive_int(data.get("max_concurrency"), default=1)
-        heartbeat_interval = _to_positive_int(
-            data.get("heartbeat_interval_seconds"), default=15
-        )
-        if not max_concurrency:
-            raise ValueError("max_concurrency must be positive")
-        if not heartbeat_interval:
-            raise ValueError("heartbeat_interval_seconds must be positive")
-        return cls(
-            worker_id=worker_id,
-            worker_type=worker_type,
-            identity=identity,
-            capabilities=_normalize_list(data.get("capabilities", [])),
-            trust_zone=str(data.get("trust_zone") or "default"),
-            max_concurrency=max_concurrency,
-            heartbeat_interval_seconds=heartbeat_interval,
-            supported_protocols=_normalize_list(
-                data.get("supported_protocols", ["aios-task-v1"])
-            ),
-            registered_at=float(data.get("registered_at") or now),
-            last_heartbeat=float(data.get("last_heartbeat") or now),
-            status=str(data.get("status") or "active"),
-            disabled=bool(data.get("disabled", False)),
-            owner_identity=str(data.get("owner_identity") or identity),
-            registration_revision=int(data.get("registration_revision") or 1),
-            registration_policy=str(data.get("registration_policy") or "self"),
-            created_at=float(data.get("created_at") or data.get("registered_at") or now),
-            updated_at=float(data.get("updated_at") or now),
-            disabled_reason=data.get("disabled_reason"),
-        )
-
-    def to_dict(self, redact_payload: bool = True) -> dict[str, Any]:
-        payload = {
-            "worker_id": self.worker_id,
-            "worker_type": self.worker_type,
-            "identity": self.identity,
-            "capabilities": list(self.capabilities),
-            "trust_zone": self.trust_zone,
-            "max_concurrency": self.max_concurrency,
-            "heartbeat_interval_seconds": self.heartbeat_interval_seconds,
-            "supported_protocols": list(self.supported_protocols),
-            "registered_at": _fmt_ts(self.registered_at),
-            "last_heartbeat": _fmt_ts(self.last_heartbeat),
-            "status": self.status,
-            "disabled": self.disabled,
-            "owner_identity": self.owner_identity,
-            "registration_revision": self.registration_revision,
-            "registration_policy": self.registration_policy,
-            "created_at": _fmt_ts(self.created_at or self.registered_at),
-            "updated_at": _fmt_ts(self.updated_at or self.last_heartbeat),
-            "disabled_reason": self.disabled_reason,
-        }
-        if redact_payload:
-            payload = redact_value(payload)
-        return payload
-
-
-@dataclass(frozen=True)
-class EvidenceEnvelope:
-    schema_version: int
-    evidence_id: str
-    task_id: str
-    claim_id: str
-    kind: str
-    worker_identity: str
-    payload: dict[str, Any]
-    created_at: float
-    previous_evidence_hash: str
-    evidence_digest: str
-    signature: str | None = None
-    attestation_ref: str | None = None
-
-    @classmethod
-    def create(
-        cls,
-        *,
-        task_id: str,
-        claim_id: str,
-        kind: str,
-        worker_identity: str,
-        payload: dict[str, Any],
-        previous_evidence_hash: str,
-        signature: str | None = None,
-        attestation_ref: str | None = None,
-        evidence_id: str | None = None,
-        created_at: float | None = None,
-    ) -> "EvidenceEnvelope":
-        envelope = cls(
-            schema_version=1,
-            evidence_id=evidence_id or f"evd-{uuid.uuid4()}",
-            task_id=validate_identifier(task_id, "task_id"),
-            claim_id=validate_identifier(claim_id, "claim_id"),
-            kind=validate_type(kind, "evidence kind"),
-            worker_identity=str(worker_identity),
-            payload=redact_value(payload),
-            created_at=float(created_at or _now_ts()),
-            previous_evidence_hash=str(previous_evidence_hash or ""),
-            evidence_digest="",
-            signature=signature,
-            attestation_ref=attestation_ref,
-        )
-        return dataclass_replace(
-            envelope, evidence_digest=compute_sha256_hex(envelope.digest_payload())
-        )
-
-    def digest_payload(self) -> dict[str, Any]:
-        return {
-            "schema_version": self.schema_version,
-            "evidence_id": self.evidence_id,
-            "task_id": self.task_id,
-            "claim_id": self.claim_id,
-            "kind": self.kind,
-            "worker_identity": self.worker_identity,
-            "payload": self.payload,
-            "created_at": self.created_at,
-            "previous_evidence_hash": self.previous_evidence_hash,
-            "attestation_ref": self.attestation_ref,
-        }
-
-    def verify(
-        self,
-        *,
-        expected_task_id: str,
-        expected_claim_id: str,
-        expected_previous_hash: str,
-        attestation_verifier: Any = None,
-    ) -> bool:
-        if (
-            self.schema_version != 1
-            or self.task_id != expected_task_id
-            or self.claim_id != expected_claim_id
-            or self.previous_evidence_hash != expected_previous_hash
-            or self.evidence_digest != compute_sha256_hex(self.digest_payload())
-        ):
-            return False
-        if self.signature or self.attestation_ref:
-            return True if attestation_verifier is None else bool(attestation_verifier(self))
-        return True
-
-    def to_dict(self) -> dict[str, Any]:
-        return {
-            **self.digest_payload(),
-            "evidence_digest": self.evidence_digest,
-            "signature": self.signature,
-        }
-
-
-class ProbeOutcome(StrEnum):
-    NOT_APPLIED = "NOT_APPLIED"
-    APPLIED_VERIFIED = "APPLIED_VERIFIED"
-    INDETERMINATE = "INDETERMINATE"
-    CONFLICT = "CONFLICT"
-
-
-@dataclass(frozen=True)
-class ProbeEvidence:
-    schema_version: int
-    probe_id: str
-    task_id: str
-    claim_id: str
-    worker_id: str
-    worker_identity: str
-    operation_digest: str
-    outcome: ProbeOutcome
-    observed_at: float
-    expires_at: float
-    probe_executor_identity: str
-    evidence_digest: str
-    signature: str | None = None
-    attestation_ref: str | None = None
-
-    @classmethod
-    def create(cls, **data: Any) -> "ProbeEvidence":
-        outcome = data["outcome"]
-        if not isinstance(outcome, ProbeOutcome):
-            outcome = ProbeOutcome(str(outcome))
-        probe = cls(
-            schema_version=1,
-            probe_id=data.get("probe_id") or f"probe-{uuid.uuid4()}",
-            task_id=validate_identifier(data["task_id"], "task_id"),
-            claim_id=validate_identifier(data["claim_id"], "claim_id"),
-            worker_id=validate_identifier(data["worker_id"], "worker_id"),
-            worker_identity=str(data["worker_identity"]),
-            operation_digest=str(data["operation_digest"]),
-            outcome=outcome,
-            observed_at=float(data["observed_at"]),
-            expires_at=float(data["expires_at"]),
-            probe_executor_identity=str(data["probe_executor_identity"]),
-            evidence_digest="",
-            signature=data.get("signature"),
-            attestation_ref=data.get("attestation_ref"),
-        )
-        return dataclass_replace(
-            probe, evidence_digest=compute_sha256_hex(probe.digest_payload())
-        )
-
-    def digest_payload(self) -> dict[str, Any]:
-        return {
-            "schema_version": self.schema_version,
-            "probe_id": self.probe_id,
-            "task_id": self.task_id,
-            "claim_id": self.claim_id,
-            "worker_id": self.worker_id,
-            "worker_identity": self.worker_identity,
-            "operation_digest": self.operation_digest,
-            "outcome": self.outcome.value,
-            "observed_at": self.observed_at,
-            "expires_at": self.expires_at,
-            "probe_executor_identity": self.probe_executor_identity,
-            "attestation_ref": self.attestation_ref,
-        }
-
-    def verify(self, *, now: float, attestation_verifier: Any) -> bool:
-        if (
-            self.schema_version != 1
-            or self.expires_at <= now
-            or self.observed_at > now
-            or self.evidence_digest != compute_sha256_hex(self.digest_payload())
-            or not (self.signature or self.attestation_ref)
-        ):
-            return False
-        return bool(attestation_verifier and attestation_verifier(self))
-
-    def to_dict(self) -> dict[str, Any]:
-        return {
-            **self.digest_payload(),
-            "evidence_digest": self.evidence_digest,
-            "signature": self.signature,
-        }
-
-
-def dataclass_replace(value: Any, **changes: Any) -> Any:
-    from dataclasses import replace
-
-    return replace(value, **changes)
-
-
-@dataclass
-class WorkerClaim:
-    claim_id: str
-    task_id: str
-    worker_id: str
-    worker_identity: str
-    claimed_at: float
-    lease_until: float
-    attempt: int
-    task_revision: int
-    operation_digest: str
-    status: str = "ACTIVE"
-
-    def to_dict(self, redact_payload: bool = True) -> dict[str, Any]:
-        payload = {
-            "claim_id": self.claim_id,
-            "task_id": self.task_id,
-            "worker_id": self.worker_id,
-            "worker_identity": self.worker_identity,
-            "claimed_at": _fmt_ts(self.claimed_at),
-            "lease_until": _fmt_ts(self.lease_until),
-            "attempt": self.attempt,
-            "task_revision": self.task_revision,
-            "operation_digest": self.operation_digest,
-            "status": self.status,
-        }
-        if redact_payload:
-            payload = redact_value(payload)
-        return payload
-
-
-@dataclass
-class ResultEnvelope:
-    task_id: str
-    claim_id: str
-    worker_identity: str
-    status: str
-    outputs: list[dict[str, Any]]
-    evidence: list[dict[str, Any]]
-    started_at: str
-    completed_at: str
-    result_digest: str | None = None
-    signature: str | None = None
-    attestation_ref: str | None = None
-    operation_digest: str | None = None
-    trust_status: str = "untrusted_shadow_result"
-
-    def digest_payload(self) -> dict[str, Any]:
-        return {
-            "task_id": self.task_id,
-            "claim_id": self.claim_id,
-            "worker_identity": self.worker_identity,
-            "status": self.status,
-            "outputs": self.outputs,
-            "evidence": self.evidence,
-            "started_at": self.started_at,
-            "completed_at": self.completed_at,
-            "operation_digest": self.operation_digest,
-            "attestation_ref": self.attestation_ref,
-        }
-
-    def computed_digest(self) -> str:
-        return compute_sha256_hex(self.digest_payload())
-
-    def to_dict(self, redact_payload: bool = True) -> dict[str, Any]:
-        payload = {
-            "task_id": self.task_id,
-            "claim_id": self.claim_id,
-            "worker_identity": self.worker_identity,
-            "status": self.status,
-            "outputs": self.outputs,
-            "evidence": self.evidence,
-            "started_at": self.started_at,
-            "completed_at": self.completed_at,
-            "result_digest": self.result_digest,
-            "signature": self.signature,
-            "attestation_ref": self.attestation_ref,
-            "operation_digest": self.operation_digest,
-            "trust_status": self.trust_status,
-        }
-        if redact_payload:
-            payload = redact_value(payload)
-        return payload
-
-
-def _normalize_list(value: Any) -> list[str]:
-    if not isinstance(value, list):
-        raise ValueError("expected list")
-    if len(value) > 128 or any(
-        not isinstance(v, str)
-        or not v
-        or len(v) > 256
-        or any(ord(ch) < 32 for ch in v)
-        for v in value
-    ):
-        raise ValueError("invalid list item")
-    return list(value)
-
-
-def _to_positive_int(value: Any, default: int | None = None) -> int | None:
-    if value is None:
-        return default
-    try:
-        number = int(value)
-    except (TypeError, ValueError):
-        return default
-    return number if number >= 0 else default
-
-
-def _to_float(value: Any) -> float | None:
-    if value is None:
-        return None
-    try:
-        return float(value)
-    except (TypeError, ValueError):
-        return None
-
-
-def _first_non_none(primary: Any, fallback: Any) -> Any:
-    if primary is not None:
-        return primary
-    return fallback
-
-
-def iso8601_now() -> str:
-    return datetime.now(timezone.utc).replace(microsecond=0).isoformat().replace("+00:00", "Z")
-
-
-def _fmt_ts(value: float | None) -> str | None:
-    if value is None:
-        return None
-    return datetime.fromtimestamp(value, tz=timezone.utc).replace(microsecond=0).isoformat().replace("+00:00", "Z")
@@ -1,226 +0,0 @@
-"""Policy and verification logic (fail-closed)."""
-
-from __future__ import annotations
-
-from dataclasses import dataclass
-from typing import Callable
-
-from .errors import ForbiddenError, LockedError
-from .models import ProbeEvidence, ResultEnvelope, TaskRecord
-
-
-RISK_RANK = {"low": 1, "medium": 2, "high": 3}
-READONLY_WORKER_ACTIONS = frozenset(
-    {"claim", "result", "fail", "progress", "heartbeat"}
-)
-ALL_ACTION_CAPABILITIES = frozenset(
-    {
-        "task.creator",
-        "worker.self_register",
-        "worker.admin",
-        "task.claim",
-        "task.cancel",
-        "task.delegate",
-        "task.read",
-        "task.audit",
-    }
-)
-
-
-@dataclass
-class PolicyDecision:
-    allowed: bool
-    reason: str = ""
-
-
-@dataclass(frozen=True)
-class ReadonlyWorkerProfile:
-    """A narrowly-scoped identity allowed to process safe Shadow tasks only."""
-
-    worker_id: str
-    identity: str
-    capabilities: frozenset[str]
-    task_types: frozenset[str] = frozenset({"code.review", "test.execute"})
-
-    def permits_task(self, task: TaskRecord) -> bool:
-        plan = task.task_plan
-        if plan.task_type not in self.task_types or plan.risk != "low":
-            return False
-        if plan.data_classification not in {"public", "internal"}:
-            return False
-        if plan.metadata.get("production_side_effects") is not False:
-            return False
-        return set(plan.required_capabilities).issubset(self.capabilities)
-
-
-class IdentityVerifier:
-    def __init__(self, trusted_identities: set[str] | None = None):
-        self.trusted_identities = trusted_identities
-
-    def verify(self, identity: str) -> bool:
-        if self.trusted_identities is None:
-            return True
-        return identity in self.trusted_identities
-
-
-class EvidenceVerifier:
-    def __init__(self, mandatory: list[str] | None = None):
-        self.mandatory = set(mandatory or [])
-
-    def verify(self, task: TaskRecord, evidences: list[dict]) -> PolicyDecision:
-        required = set(task.task_plan.evidence_requirements or [])
-        if not required and not self.mandatory:
-            return PolicyDecision(True)
-        observed = {e.get("kind") for e in evidences}
-        missing = required.union(self.mandatory) - observed
-        if missing:
-            return PolicyDecision(False, f"missing evidence: {', '.join(sorted(missing))}")
-        return PolicyDecision(True)
-
-
-class PolicyEngine:
-    """
-    Fail-closed policy engine with minimal but explicit decisions.
-    """
-
-    def __init__(
-        self,
-        *,
-        identity_verifier: IdentityVerifier | None = None,
-        evidence_verifier: EvidenceVerifier | None = None,
-        execution_enabled: bool = False,
-        max_risk: str = "medium",
-        result_signature_verifier: Callable[[ResultEnvelope], bool] | None = None,
-        probe_attestation_verifier: Callable[[ProbeEvidence], bool] | None = None,
-        identity_capabilities: dict[str, set[str]] | None = None,
-        admin_identities: set[str] | None = None,
-        readonly_worker_execution_enabled: bool = False,
-        readonly_worker_profiles: list[ReadonlyWorkerProfile] | None = None,
-    ) -> None:
-        if max_risk not in RISK_RANK:
-            raise ValueError("invalid max_risk")
-        self.identity_verifier = identity_verifier or IdentityVerifier()
-        self.evidence_verifier = evidence_verifier or EvidenceVerifier()
-        self.execution_enabled = execution_enabled
-        self.max_risk = max_risk
-        self.result_signature_verifier = result_signature_verifier
-        self.probe_attestation_verifier = probe_attestation_verifier
-        self.identity_capabilities = {
-            identity: set(capabilities)
-            for identity, capabilities in (identity_capabilities or {}).items()
-        }
-        self.admin_identities = set(admin_identities or ())
-        self.readonly_worker_execution_enabled = readonly_worker_execution_enabled
-        self.readonly_worker_profiles = {
-            profile.identity: profile for profile in (readonly_worker_profiles or [])
-        }
-
-    def _readonly_worker_allows(
-        self, action: str, actor: str, task: TaskRecord | None
-    ) -> bool:
-        profile = self.readonly_worker_profiles.get(actor)
-        return bool(
-            self.readonly_worker_execution_enabled
-            and action in READONLY_WORKER_ACTIONS
-            and profile is not None
-            and (task is None or profile.permits_task(task))
-        )
-
-    def assert_readonly_worker_binding(self, actor: str, worker_id: str) -> None:
-        profile = self.readonly_worker_profiles.get(actor)
-        if profile is not None and profile.worker_id != worker_id:
-            raise ForbiddenError("worker identity binding mismatch")
-
-    def assert_readonly_worker_registration(self, actor: str, payload: dict) -> None:
-        profile = self.readonly_worker_profiles.get(actor)
-        if profile is None:
-            return
-        if (
-            str(payload.get("worker_id") or "") != profile.worker_id
-            or str(payload.get("identity") or "") != profile.identity
-            or set(payload.get("capabilities") or []) != set(profile.capabilities)
-            or str(payload.get("trust_zone") or "") != "isolated-review"
-            or int(payload.get("max_concurrency") or 0) != 1
-            or int(payload.get("heartbeat_interval_seconds") or 0) != 15
-        ):
-            raise ForbiddenError("readonly worker registration mismatch")
-
-    def verify_result(
-        self, result: ResultEnvelope, task: TaskRecord | None = None
-    ) -> PolicyDecision:
-        computed = result.computed_digest()
-        if result.result_digest and result.result_digest != computed:
-            return PolicyDecision(False, "result digest mismatch")
-        sensitive = bool(
-            task
-            and (
-                task.task_plan.data_classification
-                in {"confidential", "credential-secret"}
-                or any(
-                    capability.startswith(
-                        ("code.write", "deploy", "secret", "production")
-                    )
-                    for capability in task.task_plan.required_capabilities
-                )
-            )
-        )
-        if sensitive and not (result.signature or result.attestation_ref):
-            return PolicyDecision(False, "trusted result proof required")
-        if result.signature is not None or result.attestation_ref is not None:
-            if self.result_signature_verifier is None:
-                return PolicyDecision(False, "result signature verifier unavailable")
-            if not self.result_signature_verifier(result):
-                return PolicyDecision(False, "result signature invalid")
-            result.trust_status = "trusted_result"
-        else:
-            result.trust_status = "untrusted_shadow_result"
-        return PolicyDecision(True)
-
-    def authorize(self, action: str, actor: str, task: TaskRecord | None = None, context: dict | None = None) -> PolicyDecision:
-        context = context or {}
-        if not self.identity_verifier.verify(actor):
-            return PolicyDecision(False, "identity untrusted")
-
-        action_capabilities = {
-            "create": "task.creator",
-            "read": "task.read",
-            "audit": "task.audit",
-            "claim": "task.claim",
-            "result": "task.claim",
-            "fail": "task.claim",
-            "progress": "task.claim",
-            "heartbeat": "task.claim",
-            "cancel": "task.cancel",
-            "delegate": "task.delegate",
-            "worker.register": "worker.self_register",
-            "worker.admin": "worker.admin",
-        }
-        required_capability = action_capabilities.get(action)
-        if required_capability:
-            granted = set(
-                self.identity_capabilities.get(
-                    actor, self.identity_capabilities.get("*", set())
-                )
-            )
-            if required_capability not in granted:
-                return PolicyDecision(False, f"action {action} not permitted")
-
-        if action in {"claim", "result", "fail", "cancel", "progress", "delegate", "heartbeat"} and not self.execution_enabled:
-            if not self._readonly_worker_allows(action, actor, task):
-                return PolicyDecision(False, "execution disabled")
-
-        if action == "delegate" and task and task.status not in {"COMPLETED", "FAILED_FINAL", "CANCELLED"}:
-            risk = str(context.get("risk", task.task_plan.risk))
-            if RISK_RANK.get(risk, 2) > RISK_RANK.get(self.max_risk, 1):
-                return PolicyDecision(False, f"risk {risk} exceeds policy")
-
-        return PolicyDecision(True)
-
-    def assert_allowed(self, action: str, actor: str, task: TaskRecord | None = None, context: dict | None = None):
-        decision = self.authorize(action, actor, task, context=context)
-        if not decision.allowed:
-            if decision.reason == "identity untrusted":
-                raise ForbiddenError(decision.reason)
-            if decision.reason == "execution disabled":
-                raise LockedError("execution disabled")
-            raise ForbiddenError(decision.reason)
@@ -1,76 +0,0 @@
-"""Task scheduler primitives."""
-
-from __future__ import annotations
-
-import time
-from .errors import NotFoundError
-from .capabilities import has_capabilities
-from .models import WorkerClaim
-from .store import TaskPlaneStore
-
-
-class TaskScheduler:
-    def __init__(self, store: TaskPlaneStore):
-        self.store = store
-
-    def next_queued_task(self, worker_id: str):
-        worker = self.store.get_worker(worker_id)
-        tasks = sorted(
-            self.store.list_tasks(),
-            key=lambda task: (
-                -int(task.task_plan.metadata.get("priority", 0)),
-                task.created_at,
-                task.task_id,
-            ),
-        )
-        for task in tasks:
-            if task.status not in {"CREATED", "QUEUED", "FAILED_RECOVERABLE"}:
-                continue
-            if task.task_plan.task_type == "worker.registry.audit":
-                continue
-            if task.status == "FAILED_RECOVERABLE" and not self.store.task_has_retryable_probe(
-                task.task_id
-            ):
-                continue
-            if not has_capabilities(
-                worker.capabilities, task.task_plan.required_capabilities
-            ):
-                continue
-            if any(
-                self.store.get_task(dependency).status != "COMPLETED"
-                for dependency in task.task_plan.dependencies
-            ):
-                continue
-            if (
-                task.task_plan.data_classification == "credential-secret"
-                and worker.worker_type != "secure_file_transformer"
-                and "secure_file_transformer" not in worker.capabilities
-            ):
-                continue
-            return task
-        return None
-
-    def schedule_for_worker(self, worker_id: str, lease_seconds: int = 15) -> WorkerClaim:
-        worker = self.store.get_worker(worker_id)
-        if worker.disabled:
-            from .errors import LockedError
-
-            raise LockedError("worker disabled")
-        if time.time() > worker.last_heartbeat + (
-            worker.heartbeat_interval_seconds * 3
-        ):
-            from .errors import LockedError
-
-            raise LockedError("worker offline")
-        task = self.next_queued_task(worker_id)
-        if task is None:
-            raise NotFoundError("no queued tasks available")
-        claim = self.store.claim_task(
-            task.task_id,
-            worker_id,
-            worker.identity,
-            lease_seconds=lease_seconds,
-            expected_revision=task.revision,
-            operation_digest=task.task_plan.operation_digest(),
-        )
-        return claim
@@ -1,68 +0,0 @@
-"""Worker registry abstraction and read helpers."""
-
-from __future__ import annotations
-
-import time
-
-from .capabilities import has_capabilities
-from .errors import NotFoundError
-from .models import WorkerRegistration
-from .store import TaskPlaneStore
-
-
-class WorkerRegistry:
-    def __init__(self, store: TaskPlaneStore):
-        self.store = store
-
-    def register(
-        self,
-        payload: dict,
-        *,
-        actor_identity: str,
-        is_admin: bool,
-        expected_revision: int | None,
-    ) -> WorkerRegistration:
-        reg = WorkerRegistration.from_dict(payload)
-        return self.store.register_worker(
-            reg,
-            actor_identity=actor_identity,
-            is_admin=is_admin,
-            expected_revision=expected_revision,
-        )
-
-    def heartbeat(
-        self,
-        worker_id: str,
-        heartbeat_interval_seconds: int | None = None,
-        *,
-        actor_identity: str,
-        expected_revision: int | None,
-    ) -> WorkerRegistration:
-        return self.store.heartbeat_worker(
-            worker_id,
-            heartbeat_interval_seconds=heartbeat_interval_seconds,
-            actor_identity=actor_identity,
-            expected_revision=expected_revision,
-        )
-
-    def list(self):
-        return self.store.list_workers()
-
-    def get(self, worker_id: str) -> WorkerRegistration:
-        try:
-            return self.store.get_worker(worker_id)
-        except NotFoundError:
-            raise
-
-    def can_execute(self, worker_id: str, required_capabilities: list[str]) -> bool:
-        worker = self.store.get_worker(worker_id)
-        return has_capabilities(worker.capabilities, required_capabilities)
-
-    def is_online(self, worker_id: str, *, now: float | None = None) -> bool:
-        worker = self.store.get_worker(worker_id)
-        deadline = worker.last_heartbeat + (worker.heartbeat_interval_seconds * 3)
-        return not worker.disabled and (time.time() if now is None else now) <= deadline
-
-    def stale_workers(self, *, now: float | None = None) -> list[WorkerRegistration]:
-        current = time.time() if now is None else now
-        return [worker for worker in self.list() if not self.is_online(worker.worker_id, now=current)]
@@ -1,8 +1,7 @@
-<<<<<<< HEAD
 # AIOS Agent Command Plane Registry
 # Git is the single source of truth for all agent commands.
 version: 1.0.0
-created_at: 2026-07-08T15:20:00+08:00
+created_at: "2026-07-08T15:20:00+08:00"
 baseline: V1R3C1

 commands:
@@ -12,6 +11,22 @@ commands:
  completed_path: "agents/commands/completed/"
  failed_path: "agents/commands/failed/"

+directories:
+  commands/active: "New commands pending execution — Git is the only entry point"
+  commands/running: "Commands currently being executed by an agent"
+  commands/completed: "Commands that finished successfully — moved here on success"
+  commands/failed: "Commands that finished with errors — moved here on failure"
+
+lifecycle:
+  new: active/
+  running: running/
+  success: completed/
+  failure: failed/
+
+# Command lifecycle state machine:
+# active/ → locked & moved to running/ → execute → success → completed/
+#                                                          → failure → failed/
+
 policies:
  path: "agents/policies/"
  source: "git"
@@ -38,30 +53,4 @@ audit:
  agent_runs: "audit/agent-runs/"
  version_history: "audit/version-history/"
  command_history: "audit/command-history/"
-=======
-# AIOS Agent Command Registry
-# Git is the single source of truth for all agent commands.
-
-registry_version: 1.0.0
-created_at: "2026-07-08T15:44:00+08:00"
-baseline: V1R3C1
-
-directories:
-  commands/active:    "New commands pending execution — Git is the only entry point"
-  commands/running:   "Commands currently being executed by an agent"
-  commands/completed: "Commands that finished successfully — moved here on success"
-  commands/failed:    "Commands that finished with errors — moved here on failure"
-
-state: agents/state/
-policies: agents/policies/
-
-lifecycle:
-  new:     active/
-  running: running/
-  success: completed/
-  failure: failed/
-
-# Command lifecycle state machine:
-# active/ → locked & moved to running/ → execute → success → completed/
-#                                                          → failure → failed/
->>>>>>> 4d18ee0 (feat(cmd): enable Agent Command Plane, audit plane, and Web UI dashboard)
+  interaction_history: "audit/interaction-history/"
@@ -1,25 +1,13 @@
 {
-  "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
-  }
-}
+    "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
+    }
+}
@@ -1,103 +0,0 @@
-{
-  "schema_version": 4,
-  "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",
-    "trust_domain": "aios.production",
-    "maximum_lifetime_seconds": 3600,
-    "release_plan_sha256_required": true,
-    "not_before_required": true,
-    "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,
-    "trusted_candidate_builder_required": true,
-    "actual_plan_regeneration_required": true,
-    "startup_fail_closed_on_missing_component": true,
-    "recovery_worker_shadow_default": true,
-    "production_approval_backend_required": true,
-    "production_builder_signer": "kms-hsm-secret-manager-only",
-    "production_execution_without_backend": "unavailable"
-  },
-  "durability": {
-    "journal": "sha256-hash-chain",
-    "probe_journal": "sha256-hash-chain",
-    "exclusive_capability_claims": true,
-    "side_effect_probe_before_lease_takeover": true,
-    "side_effect_probe_before_failed_recoverable_retry": true,
-    "probe_results": [
-      "NOT_APPLIED",
-      "APPLIED_VERIFIED",
-      "INDETERMINATE",
-      "CONFLICT"
-    ],
-    "probe_operation_digest_required": true,
-    "probe_freshness_required": true,
-    "tamper_result": "MANUAL_OWNER_REVIEW_REQUIRED"
-  },
-  "tag_pending": {
-    "required_observations": [
-      "remote_git_ref",
-      "annotated_tag_object",
-      "peeled_target",
-      "gitea_api",
-      "gitea_listing",
-      "repository_identity"
-    ],
-    "indeterminate_result": "RECONCILIATION_REQUIRED",
-    "conflict_result": "MANUAL_OWNER_REVIEW_REQUIRED",
-    "automatic_reconciliation": false
-  }
-}
@@ -1,59 +0,0 @@
-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
@@ -1,14 +0,0 @@
-# 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,27 +0,0 @@
-# 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
@@ -1,44 +0,0 @@
-[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,8 +11,6 @@ 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,25 +0,0 @@
-[Unit]
-Description=AIOS Silent Release Shadow Controller
-After=network-online.target
-Wants=network-online.target
-
-[Service]
-Type=simple
-User=aiman
-Group=gitops
-UMask=0077
-Environment=AIOS_GITOPS_WRITES_ENABLED=false
-Environment=AIOS_SILENT_RELEASE_EXECUTION_ENABLED=false
-Environment=PYTHONDONTWRITEBYTECODE=1
-ExecStart=/usr/bin/python3 /usr/libexec/aios-silent-release-shadow/current/active-runtime/app/silent_release_execution.py --state-root /var/lib/aios-silent-release-shadow --repository /data/aios-gitops/repo.git --host 127.0.0.1 --port 18891 --poll-seconds 30
-Restart=on-failure
-RestartSec=5
-NoNewPrivileges=true
-PrivateTmp=true
-ProtectSystem=strict
-ProtectHome=true
-ReadWritePaths=/var/lib/aios-silent-release-shadow
-ReadOnlyPaths=/data/aios-gitops/repo.git /usr/libexec/aios-silent-release-shadow
-
-[Install]
-WantedBy=multi-user.target
@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+printf 'AIOS V2R1C0 RC1 health check\n'
+
+python3 - <<'PY'
+from pathlib import Path
+required = [
+ 'active-runtime/app/aios_v2r1/tenant_context.py',
+ 'active-runtime/app/aios_v2r1/router.py',
+ 'active-runtime/app/aios_v2r1/hermes_fabric.py',
+ 'openclaw/plugins/aios-tenant-boundary/openclaw.plugin.json',
+]
+missing=[p for p in required if not Path(p).exists()]
+if missing:
+    raise SystemExit('missing: '+','.join(missing))
+print('artifact presence PASS')
+PY
+
+echo 'runtime health requires OpenClaw environment probe'
@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT=$(cd "$(dirname "$0")/../.." && pwd)
+EXPECTED_BRANCH="release/v2r1c0-tenant-cell-fabric-20260712"
+
+if [[ "$(git -C "$ROOT" branch --show-current)" != "$EXPECTED_BRANCH" ]]; then
+  echo "wrong release branch"
+  exit 1
+fi
+
+COMMIT=$(git -C "$ROOT" rev-parse HEAD)
+echo "Installing AIOS V2R1C0 RC1 commit=$COMMIT"
+
+python3 - <<'PY'
+import compileall
+if not compileall.compile_dir('active-runtime/app/aios_v2r1', quiet=1):
+    raise SystemExit(1)
+print('python compile PASS')
+PY
+
+if [[ -f openclaw/plugins/aios-tenant-boundary/package.json ]]; then
+  echo "plugin package PASS"
+else
+  echo "plugin package missing"
+  exit 1
+fi
+
+echo "Installation preflight PASS"
@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+MODE=${1:---check}
+
+case "$MODE" in
+  --check)
+    echo "V2R1C0 RC1 validation mode"
+    ;;
+  --install)
+    echo "Install requires approved OpenClaw Cell target"
+    ;;
+  --rollback)
+    echo "Rollback requires recorded Cell backup"
+    ;;
+  *)
+    echo "Usage: $0 [--check|--install|--rollback]"
+    exit 2
+    ;;
+esac
+
+python3 - <<'PY'
+import compileall
+raise SystemExit(0 if compileall.compile_dir('active-runtime/app/aios_v2r1', quiet=1) else 1)
+PY
+
+echo "python runtime syntax: PASS"
@@ -1,4 +1,3 @@
-<<<<<<< HEAD
 # AIOS Agent Audit Plane Architecture

 ## Overview
@@ -25,9 +24,10 @@ Agent Command Plane (agents/commands/)
    +---> Audit
    |         |
    |         v
-    |     audit/agent-runs/        (per-agent log)
-    |     audit/command-history/   (per-command log)
-    |     audit/version-history/   (per-baseline log)
+    |     audit/agent-runs/          (per-agent log)
+    |     audit/command-history/     (per-command log)
+    |     audit/version-history/     (per-baseline log)
+    |     audit/interaction-history/ (agent conversation traces)
    |
    +---> Git Commit
              |
@@ -45,8 +45,39 @@ Agent Command Plane (agents/commands/)
 5. Git commit locks the audit record
 6. Web UI displays timeline from git history

+## Directory Structure
+
+```
+audit/
+├── agent-runs/          # Per-execution records (JSON)
+├── command-history/     # Command lifecycle history
+├── version-history/     # Version/baseline change log
+└── interaction-history/ # Agent conversation traces
+```
+
 ## Audit Record Schema

+Current agent-run records use the following fields:
+
+| Field | Description |
+|-------|-------------|
+| agent_run_id | Unique execution ID |
+| command | Command file name |
+| agent | Executing agent name |
+| version | Baseline version at execution time |
+| objective | Human-readable goal |
+| start_time | ISO-8601 start timestamp |
+| end_time | ISO-8601 completion timestamp |
+| interaction_count | Agent-owner interaction turns |
+| tool_call_count | Tool invocations during execution |
+| changed_files | Files modified in this run |
+| commit_sha | Git commit hash |
+| test_result | Test verification outcome |
+| final_result | SUCCESS / FAILED / PARTIAL |
+| evidence_path | Link to evidence directory |
+
+Legacy records remain valid and may use the following compatibility shape:
+
 ```json
 {
  "id": "",
@@ -72,51 +103,6 @@ Agent Command Plane (agents/commands/)
 - Every code change must be traceable to who/what agent created it
 - No agent-created changes without audit trail

-## Related
-
- [Agent Command Plane](../agents/README.md)
- [Baseline System](baseline-system.md)
-=======
-# AIOS Agent Audit Plane
-
-## Purpose
-
-Every agent action is recorded. All code changes are traceable to:
- Who made the change
- Why the change was made
- When it was made
- Which version introduced it
- What test results showed
-
-## Directory Structure
-
-```
-audit/
-├── agent-runs/         # Per-execution records (JSON)
-├── command-history/    # Command lifecycle history
-├── version-history/    # Version/baseline change log
-└── interaction-history/ # Agent conversation traces
-```
-
-## Agent Run Record
-
-| Field | Description |
-|-------|-------------|
-| agent_run_id | Unique execution ID |
-| command | Command file name |
-| agent | Executing agent name |
-| version | Baseline version at execution time |
-| objective | Human-readable goal |
-| start_time | ISO-8601 start timestamp |
-| end_time | ISO-8601 completion timestamp |
-| interaction_count | Agent-owner interaction turns |
-| tool_call_count | Tool invocations during execution |
-| changed_files | Files modified in this run |
-| commit_sha | Git commit hash |
-| test_result | Test verification outcome |
-| final_result | SUCCESS / FAILED / PARTIAL |
-| evidence_path | Link to evidence directory |
-
 ## Version History

 Records baseline promotions, rollbacks, and version changes.
@@ -127,6 +113,9 @@ Conversation logs between agent and owner for each command execution.

 ## Audit Trail Requirement

-All changes tracked via Git with signed commits where possible.
-Every commit message references the originating Command ID.
->>>>>>> 4d18ee0 (feat(cmd): enable Agent Command Plane, audit plane, and Web UI dashboard)
+All changes are tracked via Git with signed commits where possible. Every commit references the originating Command ID.
+
+## Related
+
+- [Agent Command Plane](../agents/README.md)
+- [Baseline System](baseline-system.md)
@@ -0,0 +1,26 @@
+# AIOS V1R5 to V2R1 Migration Plan
+
+## Goal
+
+Move from shared Gateway assumptions to Tenant Cell isolation.
+
+## Order
+
+1. Establish Tenant Registry and signed Tenant Context.
+2. Implement Tenant Router.
+3. Implement OpenClaw Cell lifecycle management.
+4. Introduce canonical message envelope.
+5. Add provenance and execution policy enforcement.
+6. Migrate Hermes into shared fabric with isolated profiles.
+7. Migrate memory, secrets and audit storage.
+
+## Do Not
+
+- Do not modify Hermes first.
+- Do not share production credentials across tenants.
+- Do not treat workspace separation as a sandbox.
+- Do not allow unknown message origins to execute tools.
+
+## Acceptance
+
+Each migration stage requires automated tests and runtime evidence before promotion.
@@ -0,0 +1,49 @@
+# AIOS V2R1 OpenClaw Tenant Cell + Hermes Shared Agent Fabric Architecture
+
+## Status
+
+Release train: V2R1C0
+
+Purpose: replace shared runtime trust assumptions with tenant-isolated Cell architecture.
+
+## Principles
+
+1. OpenClaw Gateway is a trust boundary.
+2. Each production tenant receives an isolated Cell.
+3. Hermes provides shared scheduling/fabric capability but not shared tenant state.
+4. Tenant identity, origin, session and task scope are mandatory in every event.
+5. Unknown provenance fails closed.
+
+## Target Components
+
+- Tenant Router
+- OpenClaw Cell Manager
+- Canonical Message Envelope
+- Tenant Inbox/Outbox Ledger
+- Secret Scope Manager
+- Memory Namespace Manager
+- Hermes Profile Worker Fabric
+- Sandbox Execution Layer
+- Audit Event Pipeline
+
+## Migration Order
+
+Phase 1: Tenant Router + Cell Manager
+
+Phase 2: Canonical Message and Policy Layer
+
+Phase 3: Hermes Shared Agent Fabric
+
+Phase 4: Memory, Secret and Audit isolation
+
+Phase 5: Production tenant migration
+
+## Release Gate
+
+A V2R1 production release requires:
+
+- tenant isolation tests passed
+- message provenance tests passed
+- runtime commit matches release commit
+- OpenClaw plugin runtime inspection passed
+- rollback verified
@@ -1,268 +0,0 @@
-# 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。上述动作必须在单独生产批准中执行。
@@ -1,107 +0,0 @@
-# AIOS Silent Release Execution Readiness
-
-## Scope and stop point
-
-This change makes the controller execution-ready while deploying only a
-localhost-bound Shadow control plane. Both production gates remain false:
-
-```text
-AIOS_GITOPS_WRITES_ENABLED=false
-AIOS_SILENT_RELEASE_EXECUTION_ENABLED=false
-```
-
-Shadow completion is evidence preparation, not a production release. It cannot
-write a production tag, switch a business runtime, or mutate Baseline/Registry.
-
-## Recovery state machine
-
-Every expired or `FAILED_RECOVERABLE` capability requires fresh, operation-bound
-probe evidence before another adapter may run:
-
-```text
-NOT_APPLIED       -> one new exclusive claim may retry
-APPLIED_VERIFIED  -> mark COMPLETED without adapter replay
-INDETERMINATE     -> RECONCILIATION_REQUIRED; no automatic writes
-CONFLICT          -> MANUAL_OWNER_REVIEW_REQUIRED; no automatic writes
-```
-
-Probe evidence binds the immutable operation digest, is freshness checked, and
-is appended to a separate SHA-256 hash-chained journal. Completion still
-requires the active claim ID. File locks and leases ensure that concurrent
-recovery workers cannot execute the same adapter.
-
-`TAG_PENDING` uses independent remote ref, annotated object, peeled target,
-Gitea API, Gitea listing, and repository identity evidence. Exact absence may
-roll back a switched runtime. Exact publication continues to finalization.
-Unavailable/divergent evidence stops at reconciliation; a different OID or
-target stops for Owner review. No branch can force, delete, or rewrite a tag.
-
-## Trusted build and approval
-
-Callers submit only an event ID and exact source commit. Test, canary, artifact,
-manifest, rollback, secret scan, Git and Gitea evidence are generated by the
-trusted builder. The builder emits an Ed25519 attestation binding:
-
- builder attestation/key IDs;
- source commit and tree OID;
- artifact, manifest and package-closure SHA-256;
- test and canary evidence SHA-256;
- issuance time and signature.
-
-The controller contains only trusted public keys. Production signing is exposed
-through a KMS/HSM/secret-manager adapter; a local private-key adapter is marked
-test-only and is used only for ephemeral Shadow acceptance.
-
-Owner approvals are immutable, time-bounded, revocable, trust-domain bound, and
-single-use per capability ledger. If the production approval backend reference
-is absent, production execution is unavailable while Shadow remains available.
-Caller-supplied `owner_id` is never a fallback.
-
-## Persistent controller and API
-
-`aios-silent-release-controller.service` runs independently from the business
-GitOps API. It uses a single leader lock, durable intents/candidates/Sagas,
-startup journal verification, idempotent main events, one notification record,
-and recovery reporting. The final deployed service is report-only Shadow mode.
-
-The Action contract exposes:
-
- `createReleaseIntent`
- `getReleaseCandidate`
- `getReleasePlan`
- `getReleaseAcceptance`
- `submitSignedApproval`
- `getReleaseSaga`
- `getCapabilityStatus`
- `startDeployment`
- `getRecoveryStatus`
-
-Every Shadow response declares `execution_enabled=false`, `shadow_mode=true`
-and `side_effects_executed=false`. `startDeployment` returns a simulated
-`SHADOW_COMPLETED` result and never claims production capabilities.
-
-## Migration and rollback
-
-1. Merge through a governed pull request.
-2. Build from a clean detached worktree at the exact merge commit.
-3. Verify artifact, manifest, package closure, tests, live fixture, no-.git
-   canary, rollback archive and secret scan.
-4. Install a versioned Shadow release without changing the business runtime.
-5. Start the separate localhost-only controller with both gates false.
-6. Run Shadow candidates and freeze production PID/tag/Baseline/Registry hashes.
-7. Remove ephemeral test keys and temporary repositories.
-
-Rollback stops and disables only the Shadow controller and restores/removes its
-versioned `current` link. The existing production API, tag set, Baseline and
-Registry are not involved.
-
-## Future activation envelope
-
-Activation requires a new one-time Owner approval binding the exact controller
-commit, artifact/manifest/policy/unit hashes, trusted key IDs, KMS/secret
-references, release and rollback roots, authoritative Git/repository identity,
-Shadow candidate/evidence IDs, test results, activation plan and rollback plan.
-That approval may only flip
-`AIOS_SILENT_RELEASE_EXECUTION_ENABLED=false` to `true`; each real release still
-requires its own signed ReleasePlan. This change does not request or consume
-that activation approval.
@@ -1,84 +0,0 @@
-# Silent Release Controller Production Contract
-
-Status: review-only implementation. Production execution remains disabled.
-
-## Trust boundary
-
-The caller submits only release intent. A configured trusted builder owns ref
-validation, build, tests, artifact and manifest hashing, package closure,
-canary, rollback readiness, Git/Gitea consistency, and secret scanning. Caller
-supplied success evidence is rejected.
-
-The resulting immutable `ReleasePlan` contains deployment, tag, and
-finalization plans. One Ed25519 owner signature binds its SHA-256 digest,
-candidate evidence, policy digest, owner identity, trust domain, validity
-window, evidence lineage, and three narrow capabilities.
-
-## Durable execution
-
-The Saga journal is the source of truth. Every record is sequence-numbered and
-SHA-256 hash-chained from a fixed genesis hash. Snapshots are rebuildable
-caches. Journal corruption, truncation, reordering, missing records, or hash
-mismatch moves the release to `MANUAL_OWNER_REVIEW_REQUIRED`.
-
-Capability execution uses an exclusive, leased claim. A second worker receives
-`BUSY`; an expired claim is not reassigned until a capability-specific
-side-effect probe reports that the operation was not applied. Runtime, tag,
-and finalization remain separately claimed and recoverable.
-
-## Execution order
-
-```text
-APPROVED
-  -> PRE_SWITCH_REVALIDATING
-  -> SWITCH_PENDING
-  -> SWITCHED
-  -> RUNTIME_VERIFYING
-  -> RUNTIME_VERIFIED
-  -> TAG_PENDING
-  -> TAG_VERIFIED
-  -> BASELINE_REGISTRY_PENDING
-  -> COMPLETED
-```
-
-The actual adapter configuration is regenerated before execution and must
-match the signed plan. Trusted allowlists come from controlled policy, not the
-request.
-
-A failure before verified tag publication rolls the runtime back. A failure
-after the exact tag is verified enters `RECONCILIATION_REQUIRED`; the tag is
-never deleted or rewritten. A same-name/different-OID conflict enters
-`MANUAL_OWNER_REVIEW_REQUIRED`. Registry/Baseline finalization requires exact
-remote and Gitea tag proof, and Baseline is recorded last.
-
-## Action and recovery contract
-
-`submitOwnerApproval` verifies and durably stores the signed plan, then moves
-the Saga to `APPROVED`. `startDeployment` loads that durable approval and
-ignores caller-supplied approval content. Enabling execution without the
-trusted builder, verifier, validator, policy, and orchestrator fails during
-service construction.
-
-The recovery worker scans incomplete journals and resumes through the same
-claims and verification gates. It never automatically resumes a manual-review
-Saga. In shadow mode it only reports state and performs no adapter side
-effects.
-
-The deployed Action factory does not enable the legacy caller-evidence path.
-If the trusted builder is absent, candidate creation is rejected even while
-execution remains in shadow mode. The compatibility path exists only through
-the explicit test-only `SilentReleaseActionService.shadow()` constructor.
-
-Finalization is composed from separate `RegistryController` and
-`BaselineController` claims. Registry is verified first and Baseline is the
-last mutation; a retry reuses completed Registry evidence and never moves
-Baseline ahead of tag verification.
-
-## Governance
-
- `force_push`: forbidden
- `tag_rewrite`: forbidden
- `direct_main_push`: forbidden
- production execution default: disabled
- production tag operations in this change: not executed
- Baseline/Registry mutations in this change: not executed
@@ -1,68 +0,0 @@
-# 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.
@@ -1,68 +0,0 @@
-# Isolated Writer Exact-Path Policy V1
-
-This policy is an additional, service-owned authorization layer for
-`POST /api/commit-file`. It never expands a Token Policy V2 grant.
-
-An atomic write is permitted only when all of the following agree:
-
-1. socket peer, audience, operation, branch, base and exact path in the
-   Token Policy V2 grant;
-2. service audience, repository identity, branch, operation and exact path
-   in `AIOS_GITOPS_PATH_POLICY_FILE`;
-3. lexical path, resolved containment and symlink checks;
-4. the configured content-size and content-profile checks;
-5. operation digest, expected branch HEAD and durable operation ledger.
-
-Any failed layer returns a fail-closed policy error. Coarse `/api/file` and
-`/api/commit` routes remain forbidden.
-
-## File contract
-
-The configured path must be absolute. The parent directory must be
-`root:gitops 0750`; the regular, non-symlink file must be
-`root:gitops 0640`. JSON must use UTF-8 canonical encoding with sorted keys,
-compact separators and one trailing newline. Unknown fields, unsupported
-operations or profiles, duplicate paths, oversized policies and
-group/world-writable files are rejected during Writer startup.
-
-Example:
-
-```json
-{"allowed_branch":"patch/codex-review-test-worker-20260724","allowed_operations":{"commit_file.atomic":{"content_profile":"systemd-codex-review-worker-v1","exact_paths":["deploy/systemd/aios-codex-review-test-worker.service"],"max_content_bytes":32768}},"audience":"aios-codex-review-worker-writer.service","policy_id":"codex-review-worker-path-policy-v1","repository_identity":"aios/aios","schema_version":1}
-```
-
-The SHA-256 of the canonical policy is exposed in the isolated runtime
-status and written to the operation audit record. The request body cannot
-select or override the policy file.
-
-## Content profile
-
-`systemd-codex-review-worker-v1` is an exact, fail-closed unit grammar. The
-only sections are `[Unit]`, `[Service]` and `[Install]`. Each section has a
-directive allowlist; every single-value directive and every repeated
-`Environment`, `ReadOnlyPaths` and `ReadWritePaths` entry must match the
-governed Shadow unit contract exactly.
-
-The profile fixes the Python module
-`task_plane.workers.codex_review_test`, `User=aiman`, `Group=gitops`,
-the controlled `/usr/libexec/aios-codex-review-test-worker/current`
-working directory, all hardening switches and the three permitted
-environment variables. It grants read access only to the authoritative
-bare repository and the versioned worker artifact, and write access only
-to the worker runtime, state and cache directories.
-
-Unknown sections or directives are rejected, including lifecycle hooks,
-credential injection, environment imports, root images, bind mounts,
-capability expansion, devices, sockets and top-level writable paths. The
-parser also rejects duplicate sections, duplicate single-value directives,
-empty resets, continuation lines, CRLF, NUL, non-UTF-8 surrogate content,
-overlong lines and Unicode lookalike directive names. It does not use
-`ConfigParser(strict=False)` or silently merge repeated values.
-
-Production credentials, if later authorized, must be supplied by a
-separately governed deployment drop-in. They are not permitted in the
-source unit or this content profile.
-
-Policy changes require a separate maintenance branch and Owner-reviewed
-ordinary merge commit. A task-scoped Writer must not edit its own policy
-file.
@@ -13,27 +13,6 @@ 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]
@@ -51,31 +30,6 @@ components:
        path: {type: string, example: docs/gitops/chatgpt-change.md}
        content: {type: string}
        message: {type: string}
-    AtomicFileCommitRequest:
-      type: object
-      additionalProperties: false
-      required: [branch, path, content, message, expected_head_oid, idempotency_key]
-      properties:
-        branch:
-          type: string
-          pattern: '^patch/[A-Za-z0-9._/-]+$'
-        path:
-          type: string
-          minLength: 1
-          maxLength: 512
-        content:
-          type: string
-          maxLength: 1048576
-        message:
-          type: string
-          minLength: 1
-          maxLength: 200
-        expected_head_oid:
-          type: string
-          pattern: '^[0-9a-f]{40}$'
-        idempotency_key:
-          type: string
-          pattern: '^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$'
    CommitRequest:
      type: object
      properties:
@@ -96,20 +50,9 @@ components:
        message: {type: string}
    TagRequest:
      type: object
-      required: [version, target_oid, evidence_closure_oid, approval_plan_id]
+      required: [version]
      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
@@ -160,216 +103,7 @@ components:
      properties:
        text: {type: string}
        branch: {type: string}
-    DeploymentPlan:
-      type: object
-      required: [service, release_path, release_root, cutover_link, dropin_path, dropin_sha256, systemd_unit_sha256, rollback_path, rollback_sha256, source_commit, tree_oid, artifact_sha256, manifest_sha256, package_closure_sha256, authoritative_git_dir, repository_identity, writer_expected, baseline_before_sha256, registry_before_sha256, production_tag_refset_before_sha256, health_contract_version, timeout_policy, retry_policy, policy_sha256, health_contract]
-      properties:
-        service: {type: string}
-        release_path: {type: string}
-        release_root: {type: string}
-        cutover_link: {type: string}
-        dropin_path: {type: string}
-        dropin_sha256: {type: string, pattern: '^[0-9a-f]{64}$'}
-        systemd_unit_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}$'}
-        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}$'}
-        package_closure_sha256: {type: string, pattern: '^[0-9a-f]{64}$'}
-        authoritative_git_dir: {type: string}
-        repository_identity: {type: string}
-        writer_expected: {type: boolean, enum: [false]}
-        baseline_before_sha256: {type: string, pattern: '^[0-9a-f]{64}$'}
-        registry_before_sha256: {type: string, pattern: '^[0-9a-f]{64}$'}
-        production_tag_refset_before_sha256: {type: string, pattern: '^[0-9a-f]{64}$'}
-        health_contract_version: {type: string}
-        timeout_policy: {type: object}
-        retry_policy: {type: object}
-        policy_sha256: {type: string, pattern: '^[0-9a-f]{64}$'}
-        health_contract: {type: object, additionalProperties: true}
-    ReleaseCandidateInput:
-      type: object
-      required: [source_commit, version]
-      additionalProperties: false
-      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}$'}
-        version: {type: string, pattern: '^V[0-9]+R[0-9]+C[0-9]+(?:[-.][A-Za-z0-9][A-Za-z0-9.-]*)?$'}
-    ReleaseIntentInput:
-      type: object
-      required: [event_id, source_commit]
-      additionalProperties: false
-      properties:
-        event_id: {type: string, pattern: '^[A-Za-z0-9][A-Za-z0-9_.:-]{2,255}$'}
-        source_commit: {type: string, pattern: '^[0-9a-f]{40}$'}
-    SignedReleasePlanApproval:
-      type: object
-      required: [release_plan_id, candidate_id, source_commit, tree_oid, artifact_sha256, manifest_sha256, deployment_plan_sha256, release_plan_sha256, policy_sha256, approval_plan_id, evidence_closure_oid, owner_approval_record_oid, capabilities, owner_identity, trust_domain, issued_at, not_before, 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}$'}
-        release_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}$'}
-        owner_identity: {type: string}
-        trust_domain: {type: string}
-        issued_at: {type: string, format: date-time}
-        not_before: {type: string, format: date-time}
-        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]
-      additionalProperties: false
-      properties:
-        candidate_id: {type: string}
 paths:
-  /createReleaseIntent:
-    post:
-      operationId: createReleaseIntent
-      summary: Create an idempotent intent; all build evidence comes from the trusted builder
-      security: [{bearerAuth: []}]
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema: {$ref: '#/components/schemas/ReleaseIntentInput'}
-      responses:
-        '200': {description: Intent created or idempotently returned}
-        '400': {description: Caller evidence or invalid intent rejected}
-      x-openai-isConsequential: true
-  /createReleaseCandidate:
-    post:
-      operationId: createReleaseCandidate
-      summary: Submit release intent to the trusted builder; caller evidence is rejected
-      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}
-  /getReleasePlan:
-    get:
-      operationId: getReleasePlan
-      parameters:
-        - {in: query, name: candidate_id, required: true, schema: {type: string}}
-      responses:
-        '200': {description: Immutable release plan}
-        '404': {description: Candidate not found}
-  /getReleaseAcceptance:
-    get:
-      operationId: getReleaseAcceptance
-      parameters:
-        - {in: query, name: candidate_id, required: true, schema: {type: string}}
-      responses:
-        '200': {description: Builder attestation and acceptance checks}
-        '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
-  /submitSignedApproval:
-    post:
-      operationId: submitSignedApproval
-      summary: Alias for immutable signed owner approval submission
-      security: [{bearerAuth: []}]
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema: {$ref: '#/components/schemas/SignedReleasePlanApproval'}
-      responses:
-        '200': {description: Signature verified and approval stored}
-        '403': {description: Production approval backend unavailable or signature invalid}
-      x-openai-isConsequential: true
-  /startDeployment:
-    post:
-      operationId: startDeployment
-      summary: Resume the durable approved Saga; caller cannot replace approval
-      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}
-  /getCapabilityStatus:
-    get:
-      operationId: getCapabilityStatus
-      parameters:
-        - {in: query, name: candidate_id, required: true, schema: {type: string}}
-      responses:
-        '200': {description: Durable single-use capability records}
-  /getRecoveryStatus:
-    get:
-      operationId: getRecoveryStatus
-      responses:
-        '200': {description: Fail-closed recovery classification}
  /api/base:
    get:
      operationId: getBaseline
@@ -453,25 +187,6 @@ paths:
            schema: {$ref: '#/components/schemas/FileCommitRequest'}
      responses: {'200': {description: File committed}, '400': {description: Secret rejected or invalid path}, '401': {description: Unauthorized}}
      x-openai-isConsequential: true
-  /api/commit-file:
-    post:
-      operationId: commitFileAtomic
-      summary: Atomically write one allowlisted file, commit, push, and verify using Token Policy V2
-      security: [{bearerAuth: []}]
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema: {$ref: '#/components/schemas/AtomicFileCommitRequest'}
-      responses:
-        '200': {description: Completed or idempotently replayed}
-        '400': {description: Invalid canonical request}
-        '401': {description: Missing, invalid, expired, or revoked Token Policy V2 grant}
-        '403': {description: Audience, source, branch, operation, path, or policy denied}
-        '409': {description: Idempotency conflict or manual review required}
-        '413': {description: Request too large}
-        '503': {description: Push or remote verification unavailable; recoverable}
-      x-openai-isConsequential: true
  /api/commit:
    post:
      operationId: commitChanges
@@ -484,39 +199,6 @@ 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
@@ -527,7 +209,7 @@ paths:
        content:
          application/json:
            schema: {$ref: '#/components/schemas/TagRequest'}
-      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}}
+      responses: {'200': {description: Tag request committed or tag created}, '403': {description: Forbidden}}
      x-openai-isConsequential: true
  /api/rollback:
    post:
@@ -563,7 +245,4 @@ paths:
        content:
          application/json:
            schema: {$ref: '#/components/schemas/NLRequest'}
-      responses:
-        '200': {description: Safe GitOps plan}
-        '401': {description: Unauthorized}
-      x-openai-isConsequential: true
+      responses: {'
@@ -1,56 +0,0 @@
-# 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
-```
@@ -1,35 +0,0 @@
-# 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.
@@ -0,0 +1,601 @@
+# V2R1 Authenticated Runtime Release Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Close exactly five reviewed blockers between the replayed V2R1 tree and an evidence-backed, authenticated, digest-bound release candidate.
+
+**Architecture:** Use one canonical `aios_v2r1` Python package; authenticate a Node-to-Python loopback envelope before server-side Weixin projection and authority resolution; make `ACCEPTED` terminal; dispatch through a durable outbox and the verified Hermes HTTP router; stage an isolated OpenClaw candidate with three services; promote only byte-identical artifacts after live reconciliation evidence.
+
+**Tech Stack:** Python 3.11 and pytest, SQLite, Node.js, OpenClaw 2026.6.11, loopback HTTP, systemd credentials and units, SHA-256 manifests.
+
+## Global gates and dynamic blocker ledger
+
+- B1 and B2 may proceed only after review accepts the corrected design and plan.
+- B3, B4, and B5 are evidence-gated. Unresolved evidence stops that task before implementation, commit, or ledger append.
+- Current outbound evidence is `EVIDENCE_REQUIRED`; B4 and B5 remain stopped until a verified provider echo exactly binds `client_id -> message_id`.
+- Keep exactly five blocker commits, one each for B1 through B5. The docs-correction commit is the reviewed starting point, not a blocker.
+- Do not create a tag, edit `VERSION` or `baseline/current.json`, push `main`, deploy/restart a live service, modify active OpenClaw configuration, or invoke Fleet.
+- All OpenClaw loader work uses an isolated temporary or candidate config/state directory.
+- `ACCEPTED` is terminal. Legacy handling is reachable only when bridge mode is explicitly `disabled`.
+- Never claim exactly-once Hermes delivery or use time/approximation as message authority.
+
+After docs review, initialize the stable per-worktree ledger from the then-current tip rather than a hardcoded SHA:
+
+```bash
+test -z "$(git status --porcelain)"
+test "$(git branch --show-current)" = "integration/v2r1-runtime-20260714"
+start_sha="$(git rev-parse HEAD)"
+start_parent="$(git rev-parse HEAD^)"
+start_tree="$(git rev-parse HEAD^{tree})"
+ledger="$(git rev-parse --git-path v2r1-blocker-ledger.tsv)"
+umask 077
+test ! -e "$ledger"
+printf 'START\t%s\t%s\t%s\n' "$start_sha" "$start_parent" "$start_tree" >"$ledger"
+```
+
+Expected: the clean reviewed docs-correction tip is `START`. At the beginning of every blocker, rehydrate and verify the latest ledger row before work:
+
+```bash
+ledger="$(git rev-parse --git-path v2r1-blocker-ledger.tsv)"
+test -s "$ledger"
+IFS=$'\t' read -r last_label last_sha last_parent last_tree < <(tail -n 1 "$ledger")
+test "$(git rev-parse HEAD)" = "$last_sha"
+test "$(git rev-parse HEAD^)" = "$last_parent"
+test "$(git rev-parse HEAD^{tree})" = "$last_tree"
+```
+
+Each blocker appends `label, SHA, parent, tree` only after its review passes. The ledger stays in the worktree Git directory and is never staged.
+
+---
+
+## Task B1: Prove the real OpenClaw plugin loader and permission contract
+
+**Files:**
+
+- Modify: `openclaw/plugins/aios-tenant-boundary/package.json`
+- Modify: `openclaw/plugins/aios-tenant-boundary/openclaw.plugin.json`
+- Modify only on demonstrated hook failure: `openclaw/plugins/aios-tenant-boundary/dist/index.js`
+- Modify only on demonstrated policy failure: `openclaw/plugins/aios-tenant-boundary/dist/policy.js`
+- Create: `openclaw/plugins/aios-tenant-boundary/test/compat.test.js`
+- Create: `openclaw/plugins/aios-tenant-boundary/test/policy.test.js`
+- Create: `openclaw/plugins/aios-tenant-boundary/test/loader.test.mjs`
+
+**Exact contract:** package/manifest versions `2.1.0-rc.1`; `blockUnknownAgentRuns` boolean default `false`; `approvalTimeoutMs` integer min `1000`, max `300000`, default `60000`; every runtime-read property declared. Default permission proves only `before_tool_call` is usable. `before_agent_run` and `agent_end` require `plugins.entries.aios-tenant-boundary.hooks.allowConversationAccess=true`. Fake API tests are supplemental; real runtime inspection is mandatory.
+
+- [ ] Add Node tests for missing/blocked/allowlisted senders, automation, read-only tools, absent provenance, approval, exact timeout bounds, cleanup, age pruning, versions, and schema.
+- [ ] Add `loader.test.mjs` to parse real inspect JSON and assert linked path, version, diagnostics, hooks, and permission state.
+- [ ] Run initial RED:
+
+```bash
+cd openclaw/plugins/aios-tenant-boundary
+npm test
+```
+
+Expected RED: current package has no tracked tests; version and missing-schema assertions fail.
+
+- [ ] Normalize versions/schema; change runtime only when an executable test proves incompatibility. Capture TAP and prove at least one test executed:
+
+```bash
+tmp="$(mktemp -d)"
+set -o pipefail
+npm test -- --test-reporter=tap | tee "$tmp/plugin.tap"
+test "$(grep -c '^ok [0-9]' "$tmp/plugin.tap")" -gt 0
+test -z "$(grep '^not ok ' "$tmp/plugin.tap" || true)"
+```
+
+Expected GREEN: npm exits 0, TAP contains one or more `ok` test records, and contains no `not ok` record.
+- [ ] Run the real loader twice in isolated state:
+
+```bash
+repo="$(git rev-parse --show-toplevel)"
+tmp="$(mktemp -d)"
+export OPENCLAW_STATE_DIR="$tmp/state"
+export OPENCLAW_CONFIG_PATH="$tmp/state/openclaw.json"
+mkdir -p "$OPENCLAW_STATE_DIR"
+openclaw plugins install --link "$repo/openclaw/plugins/aios-tenant-boundary"
+openclaw plugins inspect aios-tenant-boundary --runtime --json >"$tmp/default-inspect.json"
+node "$repo/openclaw/plugins/aios-tenant-boundary/test/loader.test.mjs" default "$tmp/default-inspect.json"
+openclaw config set plugins.entries.aios-tenant-boundary.hooks.allowConversationAccess true --strict-json
+openclaw config validate
+set +e
+openclaw doctor --lint --json >"$tmp/doctor-lint.json"
+doctor_rc=$?
+set -e
+test "$doctor_rc" = 0 || test "$doctor_rc" = 1
+python3 - "$tmp/doctor-lint.json" <<'PY'
+import json, sys
+data = json.load(open(sys.argv[1]))
+def walk(value):
+    if isinstance(value, dict):
+        yield value
+        for child in value.values(): yield from walk(child)
+    elif isinstance(value, list):
+        for child in value: yield from walk(child)
+bad = [item for item in walk(data) if str(item.get("severity", "")).lower() in {"error", "fatal"} and "plugin" in json.dumps(item).lower()]
+assert not bad, bad
+PY
+openclaw doctor --post-upgrade --json >"$tmp/doctor-plugin.json"
+openclaw plugins inspect aios-tenant-boundary --runtime --json >"$tmp/opt-in-inspect.json"
+node "$repo/openclaw/plugins/aios-tenant-boundary/test/loader.test.mjs" opt-in "$tmp/opt-in-inspect.json"
+```
+
+Expected GREEN: config validation and post-upgrade doctor exit 0; lint doctor may exit 0 or 1, warnings are allowed, parsed JSON contains zero error/fatal plugin findings; default inspection proves only `before_tool_call`; opt-in proves `before_agent_run`, `before_tool_call`, `agent_end`.
+
+- [ ] Run carried-forward tests:
+
+```bash
+PYTHONDONTWRITEBYTECODE=1 PYTEST_ADDOPTS='-p no:cacheprovider' PYTHONPATH=active-runtime/app python3 -m pytest tests/v2r1 tests/integration -q
+```
+
+Expected GREEN: `32 passed`.
+
+- [ ] Commit and append ledger:
+
+```bash
+git add openclaw/plugins/aios-tenant-boundary/package.json openclaw/plugins/aios-tenant-boundary/openclaw.plugin.json \
+  openclaw/plugins/aios-tenant-boundary/dist/index.js openclaw/plugins/aios-tenant-boundary/dist/policy.js \
+  openclaw/plugins/aios-tenant-boundary/test/compat.test.js openclaw/plugins/aios-tenant-boundary/test/policy.test.js \
+  openclaw/plugins/aios-tenant-boundary/test/loader.test.mjs
+git commit -m "fix(v2r1): prove OpenClaw plugin compatibility"
+```
+
+### Review B1
+
+- [ ] `git diff --check HEAD^ HEAD` has no output; commit contains only named B1 paths and unchanged optional `dist` files do not appear.
+- [ ] Re-run Node tests, both real loader permission modes, validation/doctor, and 32 Python tests.
+- [ ] Prove B1 parent equals ledger `START` and, before the final append step, the ledger still contains only `START`.
+- [ ] Stop if real inspection does not prove default-only `before_tool_call` and explicit conversation-access hooks.
+- [ ] After every prior B1 review check passes, append B1 and verify the recorded commit identity:
+
+```bash
+ledger="$(git rev-parse --git-path v2r1-blocker-ledger.tsv)"
+printf 'B1\t%s\t%s\t%s\n' "$(git rev-parse HEAD)" "$(git rev-parse HEAD^)" "$(git rev-parse HEAD^{tree})" >>"$ledger"
+IFS=$'\t' read -r label sha parent tree < <(tail -n 1 "$ledger")
+test "$label" = B1
+test "$sha" = "$(git rev-parse HEAD)"
+test "$parent" = "$(git rev-parse HEAD^)"
+test "$tree" = "$(git rev-parse HEAD^{tree})"
+```
+
+---
+
+## Task B2: Package only `aios_v2r1` and repair the exact legacy import set
+
+**Files:**
+
+- Create: `active-runtime/pyproject.toml`
+- Create: `active-runtime/app/aios_v2r1/__init__.py`
+- Create: `active-runtime/app/aios_v2r1/ingress_service.py`
+- Modify: `active-runtime/app/aios_v2r1/cli.py`
+- Create: `tests/v2r1/test_ingress_service.py`
+- Create: `tests/test_v2r1_package_identity.py`
+- Modify: the exact 23 Appendix A test files, and no unlisted legacy import file
+
+**Exact contract:** V2R1 imports only as `aios_v2r1`; no `active_runtime` shim/alias/namespace extension/copied tree. Wheel includes `aios_v2r1`, excludes `active_runtime` and legacy `app`. Legacy repository tests change `active_runtime.app.*` to `app.*` and run with `PYTHONPATH='active-runtime:active-runtime/app'`. Mutation routes return bounded `SERVICE_NOT_CONFIGURED` until B3/B4 processors exist. Existing cell CLI stays compatible and `serve` is separate.
+
+- [ ] Rehydrate the stable blocker ledger using the global snippet and require its latest label is `B1`.
+- [ ] Rehydrate the exact explorer manifest path and compare sorted actual/expected lists between exact marker lines. The marker names are assembled from split literals so this command cannot match itself:
+
+```bash
+actual="$(git rev-parse --git-path v2r1-active-runtime-imports.actual)"
+expected="$(git rev-parse --git-path v2r1-active-runtime-imports.expected)"
+plan=docs/superpowers/plans/2026-07-14-v2r1-runtime-release-plan.md
+begin="$(printf '%s' 'APPENDIX_A_''BEGIN')"
+end="$(printf '%s' 'APPENDIX_A_''END')"
+tick="$(printf '\140')"
+git grep -l -E '^(from|import) active_runtime\.app' -- tests | sort >"$actual"
+awk -v begin="${tick}${begin}${tick}" -v end="${tick}${end}${tick}" '
+  $0 == begin {inside=1; next}
+  $0 == end {inside=0; next}
+  inside && /^- tests\// {sub(/^- /, ""); print}
+' "$plan" | sort >"$expected"
+test "$(wc -l < "$actual" | tr -d ' ')" = 23
+test "$(wc -l < "$expected" | tr -d ' ')" = 23
+cmp -s "$actual" "$expected"
+```
+
+Expected: exact match to 23 paths. Drift requires another docs review.
+
+- [ ] Add package/service/CLI tests; run initial RED:
+
+```bash
+PYTHONDONTWRITEBYTECODE=1 PYTEST_ADDOPTS='-p no:cacheprovider' PYTHONPATH='active-runtime:active-runtime/app' \
+  python3 -m pytest tests/v2r1/test_ingress_service.py tests/test_v2r1_package_identity.py -q
+```
+
+Expected RED: package metadata, ingress service, and identity tests do not exist.
+
+- [ ] Implement package/disabled processor boundary and replace imports in exactly Appendix A. Prove no shim/old import:
+
+```bash
+test ! -e active_runtime
+test -z "$(git grep -l -E '^(from|import) active_runtime\.app' -- tests || true)"
+```
+
+- [ ] Run full collect and full suite:
+
+```bash
+PYTHONDONTWRITEBYTECODE=1 PYTEST_ADDOPTS='-p no:cacheprovider' PYTHONPATH='active-runtime:active-runtime/app' python3 -m pytest --collect-only -q
+PYTHONDONTWRITEBYTECODE=1 PYTEST_ADDOPTS='-p no:cacheprovider' PYTHONPATH='active-runtime:active-runtime/app' python3 -m pytest -q
+```
+
+Expected GREEN: zero collection/import errors and complete suite passes; pre-existing failures still block B2.
+
+- [ ] Build and inspect isolated wheel:
+
+```bash
+tmp="$(mktemp -d)"
+python3 -m pip wheel --no-deps --no-build-isolation active-runtime -w "$tmp/wheels"
+wheel="$(find "$tmp/wheels" -name '*.whl' -print -quit)"
+python3 -m venv "$tmp/venv"
+"$tmp/venv/bin/python" -m pip install --no-deps "$wheel"
+"$tmp/venv/bin/python" - "$wheel" <<'PY'
+import sys, zipfile
+names = zipfile.ZipFile(sys.argv[1]).namelist()
+assert any(n.endswith("aios_v2r1/ingress_service.py") for n in names)
+assert not any(n.startswith("active_runtime/") or n.startswith("app/") for n in names)
+import aios_v2r1
+assert aios_v2r1.__name__ == "aios_v2r1"
+PY
+```
+
+Expected GREEN: one wheel, one V2R1 namespace, installed identity `aios_v2r1`.
+
+- [ ] Stage six named paths plus exact explorer list, commit, append ledger:
+
+```bash
+actual="$(git rev-parse --git-path v2r1-active-runtime-imports.actual)"
+git add active-runtime/pyproject.toml active-runtime/app/aios_v2r1/__init__.py \
+  active-runtime/app/aios_v2r1/ingress_service.py active-runtime/app/aios_v2r1/cli.py \
+  tests/v2r1/test_ingress_service.py tests/test_v2r1_package_identity.py
+while IFS= read -r path; do git add -- "$path"; done <"$actual"
+git commit -m "feat(v2r1): package canonical authenticated ingress"
+```
+
+### Review B2
+
+- [ ] Require `git diff --check`, exactly 29 paths (six named plus Appendix A), exact-list/no-shim checks, full collect/full pytest, and wheel identity.
+- [ ] Require B2 parent equals B1 in ledger.
+- [ ] Prove mutation routes remain fail-closed until authenticated processors are installed.
+- [ ] After all prior B2 review checks pass, append B2 and verify the recorded commit identity:
+
+```bash
+ledger="$(git rev-parse --git-path v2r1-blocker-ledger.tsv)"
+printf 'B2\t%s\t%s\t%s\n' "$(git rev-parse HEAD)" "$(git rev-parse HEAD^)" "$(git rev-parse HEAD^{tree})" >>"$ledger"
+IFS=$'\t' read -r label sha parent tree < <(tail -n 1 "$ledger")
+test "$label" = B2
+test "$sha" = "$(git rev-parse HEAD)"
+test "$parent" = "$(git rev-parse HEAD^)"
+test "$tree" = "$(git rev-parse HEAD^{tree})"
+```
+
+---
+
+## Task B3: Implement authenticated Node transport and server-side Weixin authority
+
+**Evidence gate before code:** create `release/v2r1c0-rc1/weixin-bridge-evidence.json` only after recording installed TS/JS paths and SHA-256, exact inbound bigint/raw fields, authenticated account/sender/conversation sources, authority-map owner/mode/schema, candidate credential contract, and `disabled|enforced` mode owner. Stop if any source is inferred, Node would need the authority map, or patch targets are not byte-idempotent.
+
+**Files after evidence acceptance:**
+
+- Modify: `active-runtime/app/aios_v2r1/identity.py`
+- Modify: `active-runtime/app/aios_v2r1/tenant_context.py`
+- Modify: `active-runtime/app/aios_v2r1/ingress_service.py`
+- Create: `active-runtime/app/aios_v2r1/bridge_auth.py`
+- Create: `active-runtime/app/aios_v2r1/weixin_projection.py`
+- Create: `fixes/patch_openclaw_weixin_v2r1_ingress.py`
+- Create: `tests/v2r1/test_bridge_auth.py`
+- Create: `tests/v2r1/test_weixin_projection.py`
+- Create: `tests/integration/test_v2r1_bridge_transport.py`
+- Create: `tests/test_weixin_v2r1_ingress_bridge.py`
+- Create: four `tests/fixtures/weixin_v2r1/*.json` files named in the commit command
+- Create: `release/v2r1c0-rc1/weixin-bridge-evidence.json`
+
+**Exact contract:** Every authenticated POST has wire shape `{"unsigned_body":{"schema_version":"aios.signed-request.v1","key_id":"bridge-current","issued_at_ms":1784000000000,"nonce":"base64url-16-byte-value","route_payload":{}},"signature":"lowercase-64-hex"}`. `unsigned_body` has exactly those five fields; `route_payload` holds only route-specific content. The signing object is exactly `{"method":"POST","path":"<exact route>","body":unsigned_body}`. Canonical JSON is UTF-8 with recursive Unicode-codepoint-sorted object keys, no whitespace, no ASCII escaping, no floats, and string IDs; the outer `signature` is the lowercase 64-hex HMAC-SHA256 of those bytes. There is no authorization header, nested signature, or alternate route form. Python verifies before projection. Skew 30 seconds; replay five minutes; active+previous rotation; fresh nonce retry. Node reads bridge-ingress and the separate receipt-read keyring through distinct `$CREDENTIALS_DIRECTORY` files. Python owns projection/authority/internal signing. `POST /v1/receipts/status` accepts `account_id` plus exactly one of `event_id|receipt_id`, resolves only same-account/event scope, and uses receipt-read. Response max 4096 bytes. `REPLAY_REJECTED` is transport/service-only, never `RuntimeIngressResponse`. Accepted is terminal; legacy disabled-only. `Date.now()` and every local `_ms` timestamp are telemetry only.
+
+- [ ] Rehydrate the stable ledger with the global snippet and require latest label `B2` before evidence collection.
+- [ ] Add RED tests for the one exact wire/signing contract on `/v1/ingress` and `/v1/receipts/status`, including rejection of extra/missing fields, signature-inside-body, authorization-header variants, nonce lengths, skew boundaries, replay, key rotation, fresh retry, roles, bounded routes, terminal accepted, disabled legacy, bigint, and exact quote/attachment.
+- [ ] Run initial RED:
+
+```bash
+PYTHONDONTWRITEBYTECODE=1 PYTEST_ADDOPTS='-p no:cacheprovider' PYTHONPATH='active-runtime:active-runtime/app' \
+  python3 -m pytest tests/v2r1/test_bridge_auth.py tests/v2r1/test_weixin_projection.py \
+    tests/integration/test_v2r1_bridge_transport.py tests/test_weixin_v2r1_ingress_bridge.py -q
+```
+
+Expected RED: authenticator, server projection, processor, patcher absent.
+
+- [ ] Implement authenticated transport/server projection and byte-idempotent TS/JS patch. Never embed authority or internal key in Node.
+- [ ] Run focused, existing Weixin, full collect, and full pytest. Expected GREEN: all pass.
+- [ ] Commit exactly 15 paths and append ledger:
+
+```bash
+git add active-runtime/app/aios_v2r1/identity.py active-runtime/app/aios_v2r1/tenant_context.py \
+  active-runtime/app/aios_v2r1/ingress_service.py active-runtime/app/aios_v2r1/bridge_auth.py \
+  active-runtime/app/aios_v2r1/weixin_projection.py fixes/patch_openclaw_weixin_v2r1_ingress.py \
+  tests/v2r1/test_bridge_auth.py tests/v2r1/test_weixin_projection.py \
+  tests/integration/test_v2r1_bridge_transport.py tests/test_weixin_v2r1_ingress_bridge.py \
+  tests/fixtures/weixin_v2r1/text.json tests/fixtures/weixin_v2r1/quoted-text.json \
+  tests/fixtures/weixin_v2r1/image-with-text.json tests/fixtures/weixin_v2r1/unresolved-reference.json \
+  release/v2r1c0-rc1/weixin-bridge-evidence.json
+git commit -m "feat(v2r1): bridge authenticated Weixin authority"
+```
+
+### Review B3
+
+- [ ] Require exactly 15 named paths, `git diff --check`, focused/full tests, and a second patcher pass with empty diff.
+- [ ] Prove Node transports evidence only; Python owns projection/authority; RuntimeWiring re-resolves.
+- [ ] Prove fresh nonce on retry, terminal accepted, and legacy unreachable in `enforced`.
+- [ ] Require B3 parent equals B2. Stop without commit/ledger append when evidence is unresolved.
+- [ ] After all prior B3 review checks pass, append B3 and verify the recorded commit identity:
+
+```bash
+ledger="$(git rev-parse --git-path v2r1-blocker-ledger.tsv)"
+printf 'B3\t%s\t%s\t%s\n' "$(git rev-parse HEAD)" "$(git rev-parse HEAD^)" "$(git rev-parse HEAD^{tree})" >>"$ledger"
+IFS=$'\t' read -r label sha parent tree < <(tail -n 1 "$ledger")
+test "$label" = B3
+test "$sha" = "$(git rev-parse HEAD)"
+test "$parent" = "$(git rev-parse HEAD^)"
+test "$tree" = "$(git rev-parse HEAD^{tree})"
+```
+
+---
+
+## Task B4: Connect the durable outbox to the verified Hermes HTTP router
+
+**Evidence gate before code:** create `release/v2r1c0-rc1/hermes-http-contract-evidence.json` from live listener/unit/source/schema inspection and `release/v2r1c0-rc1/weixin-outbound-binding-evidence.json` from raw protocol evidence. Hermes evidence resolves schemas, `aios-hermes-router.service`, source digest, exact 140-second timeout, tenant/user ownership, and repeated-`route_id` behavior as idempotent/non-idempotent. Outbound evidence must prove exact provider echo `client_id -> message_id`. Current ACK `ret/errmsg` plus reference `ref_msg.message_item.msg_id/ref_msg.message_item.create_time_ms` is `EVIDENCE_REQUIRED` and hard-stops B4; timestamp cannot unlock it.
+
+**Files only after both gates pass:**
+
+- Create: `active-runtime/app/aios_v2r1/outbox.py`
+- Create: `active-runtime/app/aios_v2r1/hermes_http.py`
+- Create: `active-runtime/app/aios_v2r1/hermes_worker.py`
+- Create: `active-runtime/app/aios_v2r1/outbound_receipt.py`
+- Modify: `active-runtime/app/aios_v2r1/ingress_service.py`
+- Modify: `active-runtime/app/aios_v2r1/message_ledger.py`
+- Create: `tests/v2r1/test_outbox.py`
+- Create: `tests/v2r1/test_hermes_http.py`
+- Create: `tests/v2r1/test_outbound_receipt.py`
+- Create: `tests/integration/test_v2r1_delivery_flow.py`
+- Modify: `fixes/patch_openclaw_weixin_outbound_quotes.py`
+- Create: `fixes/patch_openclaw_weixin_outbound_receipts.py`
+- Create: `openclaw/plugins/aios-tenant-boundary/dist/receipt-client.js`
+- Create: `openclaw/plugins/aios-tenant-boundary/dist/outbound-receipt-journal.js`
+- Create: `openclaw/plugins/aios-tenant-boundary/test/receipt-client.test.js`
+- Modify: `tests/test_weixin_outbound_quote_timestamp.py`
+- Create: `tests/test_weixin_outbound_receipt_boundary.py`
+- Create: both evidence JSON files named above
+
+**Exact contract:** readiness `GET http://127.0.0.1:18791/health/ready`; dispatch `POST http://127.0.0.1:18791/internal/hermes/route`; downstream 140 seconds; worker deadline 150 seconds; 120-second direct timeout forbidden. States `pending|leased|delivered|delivery_unknown|dead`. No exactly-once. Unknown idempotency stops; known false prevents ambiguous retry; known true retries same `route_id`/digest. After B4 evidence, the actual Node Weixin sender receives a separate `outbound-receipt-write` `LoadCredential=` and uses the same one POST signing contract for `/v1/outbound-receipts`: exact five-field `unsigned_body`, exact `{method,path,body}` signing object, canonical JSON, and outer lowercase 64-hex HMAC-SHA256 signature.
+
+Node alone owns its callback journal at `$STATE_DIRECTORY/outbound-receipts`. The gateway unit supplies a gateway-specific `StateDirectory=` with `StateDirectoryMode=0700`; the directory and its mode-`0600` files are owned and readable only by that gateway's service user. The send-boundary patch persists one sanitized per-client-ID JSON entry using a safe fixed-width digest filename: same-directory temporary file, file `fsync`, atomic rename to `.pending`, then directory `fsync`. Records contain only bounded IDs, send-success, attempt count, and next-attempt metadata—no bodies, quotes, attachments, signatures, credentials, key material, or provider payloads. Startup recovery and a background worker perform bounded authenticated callback retries without invoking Weixin send again. A pending record is deleted and the directory `fsync`ed only after an authenticated application ACK. Python owns receipt/outbox/worker storage and has no second send journal. Missing exact binding records `EVIDENCE_REQUIRED`, null provider ID, hard stop; `Date.now()` and local `_ms` fields remain telemetry only.
+
+- [ ] Rehydrate the stable ledger and require latest label `B3` before evidence collection.
+- [ ] Execute evidence collectors first. Current expected result is `EVIDENCE_REQUIRED`; stop with no runtime edit, B4 commit, or ledger append.
+- [ ] After future exact binding acceptance, add RED tests for replay/collision/lease/unknown/dead, HTTP schema, 140/150 budgets, idempotency branches, the exact receipt signing role, exact provider mapping, ledger quote, `$STATE_DIRECTORY/outbound-receipts` resolution, directory/file ownership and `0700`/`0600` modes, file/directory `fsync`, atomic `.pending` rename, startup/background bounded retry, no-body/no-secret persistence, no content resend, and authenticated-ACK-only delete plus directory `fsync`.
+- [ ] Run initial RED:
+
+```bash
+PYTHONDONTWRITEBYTECODE=1 PYTEST_ADDOPTS='-p no:cacheprovider' PYTHONPATH='active-runtime:active-runtime/app' \
+  python3 -m pytest tests/v2r1/test_outbox.py tests/v2r1/test_hermes_http.py \
+    tests/v2r1/test_outbound_receipt.py tests/integration/test_v2r1_delivery_flow.py \
+    tests/test_weixin_outbound_quote_timestamp.py tests/test_weixin_outbound_receipt_boundary.py -q
+node --test openclaw/plugins/aios-tenant-boundary/test/receipt-client.test.js
+```
+
+Expected RED after evidence acceptance: modules absent.
+
+- [ ] Implement outbox, bounded HTTP adapter/worker, authenticated callback client, Node-owned durable callback journal, actual Weixin send-boundary patch, role-authenticated receipt route, exact Python receipt store, and outbound ledger append only after exact binding. Run Python, Node, both patchers twice for byte-idempotence, actual send-boundary, full, and loader tests; expected GREEN, with callback failure journaled without resend, timeout ambiguity `delivery_unknown`, and no exactly-once assertion.
+- [ ] Commit exactly 19 paths:
+
+```bash
+git add active-runtime/app/aios_v2r1/outbox.py active-runtime/app/aios_v2r1/hermes_http.py \
+  active-runtime/app/aios_v2r1/hermes_worker.py active-runtime/app/aios_v2r1/outbound_receipt.py \
+  active-runtime/app/aios_v2r1/ingress_service.py active-runtime/app/aios_v2r1/message_ledger.py \
+  tests/v2r1/test_outbox.py tests/v2r1/test_hermes_http.py tests/v2r1/test_outbound_receipt.py \
+  tests/integration/test_v2r1_delivery_flow.py fixes/patch_openclaw_weixin_outbound_quotes.py \
+  fixes/patch_openclaw_weixin_outbound_receipts.py openclaw/plugins/aios-tenant-boundary/dist/receipt-client.js \
+  openclaw/plugins/aios-tenant-boundary/dist/outbound-receipt-journal.js \
+  openclaw/plugins/aios-tenant-boundary/test/receipt-client.test.js tests/test_weixin_outbound_quote_timestamp.py \
+  tests/test_weixin_outbound_receipt_boundary.py release/v2r1c0-rc1/hermes-http-contract-evidence.json \
+  release/v2r1c0-rc1/weixin-outbound-binding-evidence.json
+git commit -m "feat(v2r1): dispatch through evidenced Hermes outbox"
+```
+
+### Review B4
+
+- [ ] Require exactly 19 paths, accepted evidence digests, `git diff --check`, Python/Node/patcher/send-boundary/full/loader tests.
+- [ ] Prove 150 exceeds exact 140 and no 120-second production deadline remains.
+- [ ] Search changed files for exactly-once claims and timestamp/approximate binding; require none.
+- [ ] Require B4 parent equals B3. If either evidence remains unresolved, correct result is STOP with no commit.
+- [ ] After all prior B4 review checks pass, append B4 and verify the recorded commit identity:
+
+```bash
+ledger="$(git rev-parse --git-path v2r1-blocker-ledger.tsv)"
+printf 'B4\t%s\t%s\t%s\n' "$(git rev-parse HEAD)" "$(git rev-parse HEAD^)" "$(git rev-parse HEAD^{tree})" >>"$ledger"
+IFS=$'\t' read -r label sha parent tree < <(tail -n 1 "$ledger")
+test "$label" = B4
+test "$sha" = "$(git rev-parse HEAD)"
+test "$parent" = "$(git rev-parse HEAD^)"
+test "$tree" = "$(git rev-parse HEAD^{tree})"
+```
+
+---
+
+## Task B5: Build digest-bound isolated candidate staging and rollback
+
+**Evidence gate before code:** accepted B3/B4 ledger entries. `capture_live_preflight.py` creates one evidence file containing a reconciled Gitea branch-consistency sentinel (`status=healthy`, `drift_count=0`, refs matching candidate) and the V1R4C6 live snapshot (host identity, capture time, Git SHA, units, commands, listeners, OpenClaw version, config/plugin digests, credential metadata, state/database paths, mounts, active artifact, rollback target). `release_ctl.py --preflight-file` validates the schema, exact current host, sentinel, all required fields, and freshness no older than 300 seconds. Stop if either record is missing, stale, host-mismatched, malformed, or inconsistent before staging or promotion.
+
+**Files:**
+
+- Create: `deploy/v2r1/release_ctl.py`
+- Create: `deploy/v2r1/capture_live_preflight.py`
+- Modify: `deploy/v2r1/install.sh`, `deploy/v2r1/validate.sh`, `deploy/v2r1/healthcheck.sh`
+- Create: `deploy/v2r1/rollback.sh`
+- Create: `deploy/v2r1/aios-v2r1-candidate-gateway.service`
+- Create: `deploy/v2r1/aios-v2r1-production-gateway.service`
+- Create: `deploy/v2r1/aios-v2r1-ingress.service`
+- Create: `deploy/v2r1/aios-v2r1-hermes-worker.service`
+- Create: `deploy/v2r1/openclaw-candidate.json5`
+- Create: `release/v2r1c0-rc1/FLEET_UNSUPPORTED`
+- Create: `tests/deploy/test_v2r1_release_contract.py`
+- Modify: `release/v2r1c0-rc1/RELEASE.md`
+
+**Exact contract:** `python3 deploy/v2r1/release_ctl.py` exposes only `build`, `stage`, `verify-stage`, `promote`, `status`, and `rollback`. Forward states are exactly `BUILT -> STAGED -> STAGE_VERIFIED -> PRODUCTION`; rollback states are `ROLLBACK_STARTED -> ROLLED_BACK|ROLLBACK_FAILED`. Forward commands accept `--preflight-file`; callers supply no artifact, reconciled-sentinel, or runtime-snapshot digest strings. The controller validates the evidence and computes/persists all three digests internally. `verify-stage` and `promote` each recapture live evidence with the collector, revalidate it, recompute the triplet, and reject any drift from the recorded candidate state. Deterministic same bytes stage/prod; isolated users/state/config/ports/credentials; `LoadCredential=` least-role delivery; linked candidate plugin with runtime inspect, `allowConversationAccess=true`, config validate, doctor, inspect; `NOOP_DIGEST_MATCH` zero mutation/controller calls. Candidate and production gateway units use distinct dedicated users and distinct `StateDirectory=` values (`aios-v2r1-candidate-gateway` versus `aios-v2r1-production-gateway`), both set `StateDirectoryMode=0700`, and resolve journals only below their own `$STATE_DIRECTORY/outbound-receipts`; sharing, symlinking, or bind-mounting journal state is forbidden. The current root-run production gateway remains root-owned only until its audited migration; candidate staging never reads it, and migrated mode-`0600` records become readable only by the production gateway user. STOP blocks forward actions but permits only `rollback --rollback-only --to-previous-recorded --reason-file "$reason_file"`; exact prior digest/snapshot, no forward migration, cannot remove STOP, audited.
+
+- [ ] Rehydrate the stable ledger and require latest label `B4` before live evidence capture.
+- [ ] Add RED release tests for deterministic builds, dirty/secret rejection, rejection of caller digest arguments, preflight schema/required fields/exact-host/sentinel/freshness-at-300-seconds, tamper and recapture drift, isolated config, loader sequence, unit credentials, candidate/production service-user ownership, exact distinct `StateDirectory=` names and paths, `StateDirectoryMode=0700`, journal file mode `0600`, no shared/symlink/bind-mounted journal state, root-production transition only during audited migration, no-op, STOP forward block, constrained rollback, readiness timeout, and prior integrity.
+- [ ] Run initial RED:
+
+```bash
+PYTHONDONTWRITEBYTECODE=1 PYTEST_ADDOPTS='-p no:cacheprovider' python3 -m pytest tests/deploy/test_v2r1_release_contract.py -q
+```
+
+Expected RED: driver, collector, units/config, rollback wrapper, lifecycle absent.
+
+- [ ] Implement deterministic artifact and the executable state machine; wrappers never switch branches/create tags/edit baseline/version/suppress errors. Exercise exact commands:
+
+```bash
+preflight_file="$(mktemp)"
+python3 deploy/v2r1/capture_live_preflight.py --output "$preflight_file"
+python3 deploy/v2r1/release_ctl.py build --source "$source_sha" --output "$build_dir" --preflight-file "$preflight_file"
+python3 deploy/v2r1/release_ctl.py stage --artifact "$artifact" --preflight-file "$preflight_file" --root "$release_root"
+python3 deploy/v2r1/release_ctl.py verify-stage --preflight-file "$preflight_file" --root "$release_root"
+python3 deploy/v2r1/release_ctl.py promote --preflight-file "$preflight_file" --root "$release_root"
+python3 deploy/v2r1/release_ctl.py status --root "$release_root"
+python3 deploy/v2r1/release_ctl.py rollback --root "$release_root" --rollback-only --to-previous-recorded --reason-file "$reason_file"
+```
+
+Expected GREEN: the collector creates the evidence file; the controller accepts no caller digest strings, validates it, and computes the artifact/sentinel/runtime triplet internally. State records advance only through `BUILT,STAGED,STAGE_VERIFIED,PRODUCTION`; `verify-stage` and `promote` recapture current live state and require the same triplet; rollback records `ROLLBACK_STARTED` then `ROLLED_BACK` or `ROLLBACK_FAILED`.
+- [ ] Execute candidate loader in isolated environment:
+
+```bash
+tmp="$(mktemp -d)"
+candidate_release="$tmp/release/current"
+export OPENCLAW_STATE_DIR="$tmp/openclaw-state"
+export OPENCLAW_CONFIG_PATH="$tmp/openclaw-state/openclaw.json"
+mkdir -p "$OPENCLAW_STATE_DIR"
+openclaw plugins install --link "$candidate_release/openclaw/plugins/aios-tenant-boundary"
+openclaw plugins inspect aios-tenant-boundary --runtime --json >"$tmp/plugin-before.json"
+openclaw config set plugins.entries.aios-tenant-boundary.hooks.allowConversationAccess true --strict-json
+openclaw config validate
+set +e
+openclaw doctor --lint --json >"$tmp/doctor-lint.json"
+doctor_rc=$?
+set -e
+test "$doctor_rc" = 0 || test "$doctor_rc" = 1
+python3 - "$tmp/doctor-lint.json" <<'PY'
+import json, sys
+data = json.load(open(sys.argv[1]))
+def walk(value):
+    if isinstance(value, dict):
+        yield value
+        for child in value.values(): yield from walk(child)
+    elif isinstance(value, list):
+        for child in value: yield from walk(child)
+bad = [item for item in walk(data) if str(item.get("severity", "")).lower() in {"error", "fatal"} and "plugin" in json.dumps(item).lower()]
+assert not bad, bad
+PY
+openclaw doctor --post-upgrade --json >"$tmp/doctor-plugin.json"
+openclaw plugins inspect aios-tenant-boundary --runtime --json >"$tmp/plugin-after.json"
+```
+
+Expected GREEN: plugin path inside candidate; config validation and post-upgrade doctor exit 0; lint doctor exits 0 or 1, warnings are allowed, and parsed JSON has zero error/fatal plugin findings; final inspect proves three hooks/permission; active V1R4C6 paths are absent.
+
+- [ ] Run release/full Python/Node/loader tests, two byte-identical builds, and refreshed sentinel/snapshot comparisons. Expected GREEN: all pass.
+- [ ] Commit exactly 14 paths and append ledger:
+
+```bash
+git add deploy/v2r1/release_ctl.py deploy/v2r1/capture_live_preflight.py deploy/v2r1/install.sh \
+  deploy/v2r1/validate.sh deploy/v2r1/healthcheck.sh deploy/v2r1/rollback.sh \
+  deploy/v2r1/aios-v2r1-candidate-gateway.service deploy/v2r1/aios-v2r1-production-gateway.service \
+  deploy/v2r1/aios-v2r1-ingress.service \
+  deploy/v2r1/aios-v2r1-hermes-worker.service deploy/v2r1/openclaw-candidate.json5 \
+  release/v2r1c0-rc1/FLEET_UNSUPPORTED tests/deploy/test_v2r1_release_contract.py release/v2r1c0-rc1/RELEASE.md
+git commit -m "deploy(v2r1): bind candidate release to live evidence"
+```
+
+### Review B5
+
+- [ ] Require exactly 14 paths, no live secret/snapshot payload in Git, `git diff --check`, complete tests, two identical builds.
+- [ ] Inspect both gateway units and acceptance-test distinct service users, distinct `StateDirectory=` names/absolute paths, `StateDirectoryMode=0700`, mode-`0600` journal files, and no shared, symlinked, or bind-mounted receipt journal.
+- [ ] Prove candidate paths never resolve active V1R4C6; STOP blocks forward while rollback selects only recorded previous state and cannot remove STOP.
+- [ ] Prove staging validates the collector-created file and `verify-stage`/`promote` each recapture current live sentinel/runtime state, compute digests internally, and compare the same triplet; prove no caller-supplied digest option exists.
+- [ ] Require B5 parent equals B4.
+- [ ] After all prior B5 review checks pass, append B5 and verify the recorded commit identity:
+
+```bash
+ledger="$(git rev-parse --git-path v2r1-blocker-ledger.tsv)"
+printf 'B5\t%s\t%s\t%s\n' "$(git rev-parse HEAD)" "$(git rev-parse HEAD^)" "$(git rev-parse HEAD^{tree})" >>"$ledger"
+IFS=$'\t' read -r label sha parent tree < <(tail -n 1 "$ledger")
+test "$label" = B5
+test "$sha" = "$(git rev-parse HEAD)"
+test "$parent" = "$(git rev-parse HEAD^)"
+test "$tree" = "$(git rev-parse HEAD^{tree})"
+```
+
+## Final five-commit verification
+
+Run only after all evidence/task reviews pass:
+
+```bash
+ledger="$(git rev-parse --git-path v2r1-blocker-ledger.tsv)"
+python3 - "$ledger" <<'PY'
+from pathlib import Path
+import subprocess, sys
+rows = [line.split("\t") for line in Path(sys.argv[1]).read_text().splitlines()]
+assert [row[0] for row in rows] == ["START", "B1", "B2", "B3", "B4", "B5"]
+for i in range(1, len(rows)):
+    label, sha, recorded_parent, recorded_tree = rows[i]
+    parent = subprocess.check_output(["git", "rev-parse", sha + "^"], text=True).strip()
+    tree = subprocess.check_output(["git", "rev-parse", sha + "^{tree}"], text=True).strip()
+    assert parent == rows[i - 1][1]
+    assert parent == recorded_parent and tree == recorded_tree, label
+start, head = rows[0][1], rows[-1][1]
+assert subprocess.check_output(["git", "rev-parse", "HEAD"], text=True).strip() == head
+assert subprocess.check_output(["git", "rev-list", "--count", f"{start}..{head}"], text=True).strip() == "5"
+assert not subprocess.check_output(["git", "rev-list", "--merges", f"{start}..{head}"], text=True).strip()
+PY
+test -z "$(git status --porcelain)"
+PYTHONDONTWRITEBYTECODE=1 PYTEST_ADDOPTS='-p no:cacheprovider' PYTHONPATH='active-runtime:active-runtime/app' python3 -m pytest --collect-only -q
+PYTHONDONTWRITEBYTECODE=1 PYTEST_ADDOPTS='-p no:cacheprovider' PYTHONPATH='active-runtime:active-runtime/app' python3 -m pytest -q
+(cd openclaw/plugins/aios-tenant-boundary && npm test)
+```
+
+Expected: labels exactly `START,B1,B2,B3,B4,B5`; current HEAD/parent/tree match recorded values; `START..HEAD` has exactly five commits and no merge; clean tree; full collect/full Python/Node/loader/release tests pass.
+
+Review authority roles, status spelling, timeout units, routes, response bounds, terminal semantics, evidence states, types, and sentinel behavior. Scan unresolved markers with split literals:
+
+```bash
+marker_pattern="$(printf '%s' 'TO''DO|T''BD|FIX''ME|CHANGE''_ME|INSERT''_')"
+git grep -nE "$marker_pattern" -- active-runtime deploy/v2r1 openclaw/plugins/aios-tenant-boundary release/v2r1c0-rc1 tests
+```
+
+Expected: no matches. Any contradiction, type mismatch, unresolved evidence, extra blocker commit, or missing review stops release preparation.
+
+## Appendix A: Exact legacy `active_runtime.app` import files
+
+`APPENDIX_A_BEGIN`
+- tests/test_agent_event_bus.py
+- tests/test_agent_observability_loop.py
+- tests/test_architect_governance.py
+- tests/test_architect_research_timeline.py
+- tests/test_architecture_change_classifier.py
+- tests/test_architecture_owner_gate.py
+- tests/test_architect_weekly_research.py
+- tests/test_change_governance.py
+- tests/test_governance_event_bridge.py
+- tests/test_governance_timeline.py
+- tests/test_search_agent_adapter.py
+- tests/test_search_architect_integration.py
+- tests/test_search_gateway_dashboard.py
+- tests/test_search_gateway_general_capability.py
+- tests/test_search_gateway_orchestrator.py
+- tests/test_search_gateway.py
+- tests/test_search_provider_registry.py
+- tests/test_task_center.py
+- tests/test_task_dashboard_view.py
+- tests/test_task_event_and_statistics.py
+- tests/test_task_lifecycle.py
+- tests/test_task_orchestrator.py
+- tests/test_v1r4c1_risk_fixes.py
+`APPENDIX_A_END`
@@ -0,0 +1,287 @@
+# V2R1 Authenticated Runtime Bridge Design
+
+**Date:** 2026-07-14
+**Status:** Preflight design — B3/B4/B5 evidence-gated
+**Release target:** V2R1C0 RC1
+**Scope:** Executable OpenClaw policy compatibility, canonical Python packaging, authenticated Weixin loopback ingress, exact message authority, real Hermes HTTP dispatch, and digest-bound release operations.
+
+## Decision and execution gates
+
+Three alternatives were evaluated:
+
+- **Alternative A — preserve the verified replay and stop at documentation.** Lowest immediate risk, but every runtime release blocker remains open.
+- **Alternative B — patch only the Weixin path.** Demonstrates a message path but cannot prove plugin loading, transport authority, durable dispatch, artifact identity, or rollback.
+- **Alternative C — close five independently reviewed blockers.** Prove the plugin, package one Python namespace, build the authenticated bridge, connect a durable outbox to the real Hermes HTTP router, then rehearse a digest-bound release.
+
+Alternative C remains the selected architecture because active full-execution authorization covers implementation preparation. That authorization does not waive the following gates:
+
+- B1 and B2 may start only after this corrected design and plan are reviewed.
+- B3 stops unless the installed Weixin payload shape, patch target hashes, authority-map ownership, and transport signing boundary are evidenced.
+- B4 stops unless Hermes request/response schema, router ownership, downstream timeout, idempotency behavior, and exact outbound message binding are evidenced.
+- B5 stops unless B3 and B4 are accepted and the reconciled sentinel plus the V1R4C6 live-runtime snapshot are current for the candidate digest.
+
+The present outbound evidence is insufficient, so B4 and B5 are currently stopped. This document defines the fail-closed path; it does not claim the missing evidence exists.
+
+## Verified preflight observations
+
+Read-only inspection on 2026-07-14 established these facts:
+
+- OpenClaw is `2026.6.11` and exposes `plugins install --link`, `plugins inspect --runtime --json`, `config set`, `config validate`, and `doctor`.
+- The OpenClaw schema requires a non-bundled plugin to opt into conversation-bearing hooks with `plugins.entries.aios-tenant-boundary.hooks.allowConversationAccess=true`.
+- Without that opt-in, the tenant-boundary plugin's currently usable policy hook is `before_tool_call`; `before_agent_run` and `agent_end` cannot be treated as delivered authority.
+- `aios-hermes-router.service` owns `/opt/aios-v23/shared/hermes_route_memory/hermes_router_service.py` and listens on `127.0.0.1:18791`.
+- `GET http://127.0.0.1:18791/health/ready` returns router readiness and identifies the executor health URL.
+- `POST http://127.0.0.1:18791/internal/hermes/route` is the router submission endpoint.
+- The router forwards to the executor with an exact 140-second timeout. The existing direct Weixin helper uses 120 seconds, so it is incompatible and cannot be reused as the worker deadline.
+- Router ownership and schema are inspectable, but replay/idempotency behavior for repeated `route_id` is not proved.
+- A Weixin reference event exposes `ref_msg.message_item.msg_id` and `ref_msg.message_item.create_time_ms`, but not the original outbound `client_id`. The send acknowledgement exposes only `ret` and `errmsg`. No exact `client_id -> message_id` binding currently exists.
+
+## Execution modes and terminal semantics
+
+The gateway has exactly two modes:
+
+- `disabled`: the V2R1 bridge performs no submission and the legacy message path may run.
+- `enforced`: every eligible Weixin event is handled by the V2R1 bridge. The legacy path is prohibited.
+
+There is no shadow, dual-send, or fall-through mode. In `enforced` mode:
+
+- `ACCEPTED` is terminal. The Node caller must not invoke the legacy handler, Hermes directly, or a second transport path.
+- A duplicate with the same canonical event and payload returns the same accepted receipt and is also terminal.
+- `AUTH_FAILED`, `VALIDATION_FAILED`, `CONFLICT`, and `INTERNAL_ERROR` are terminal runtime results for that attempt. They never authorize legacy fallback. `REPLAY_REJECTED` belongs only to the authenticated HTTP transport/service boundary and is never a `RuntimeIngressResponse.status`.
+- A transport timeout requires a receipt-status query. A retry is allowed only when the status is absent and must use a fresh nonce while retaining the same exact event identity.
+
+Legacy handling is therefore reachable only when configuration explicitly says `disabled`, never as error recovery.
+
+## Architecture and data flow
+
+```text
+Authenticated Weixin event in isolated OpenClaw candidate gateway
+  -> Node bridge client reads bridge credential from CREDENTIALS_DIRECTORY
+  -> Node signs the exact method/path/unsigned_body object and POSTs the outer wrapper to 127.0.0.1
+  -> Python ingress service authenticates freshness, nonce, key role, and replay
+  -> server-side WeixinProjection parses exact protocol evidence
+  -> server-side root-owned authority map supplies tenant/cell/principal/session
+  -> Python signs an internal RuntimeWiring request with a separate key role
+  -> RuntimeWiring.ingest -> TenantRouter -> MessageLedger -> SessionPool
+  -> ingress receipt reaches terminal ACCEPTED
+  -> HermesOutbox -> dedicated Hermes worker
+  -> HermesHttpAdapter -> 127.0.0.1:18791/internal/hermes/route
+  -> Weixin send boundary -> outbound receipt evidence
+```
+
+Node never constructs `CanonicalMessage`, never opens the authority map, and never supplies tenant or cell authority. Python never trusts route claims from the raw Weixin object. The root-owned authority map is keyed by authenticated account, sender, and conversation evidence; its result is still re-resolved through `TenantRouter` before mutation.
+
+## One POST signing contract
+
+Every authenticated POST route uses exactly one wire shape; there is no `auth`, authorization header, nested signature, or route-specific signing variant:
+
+```json
+{"unsigned_body":{"schema_version":"aios.signed-request.v1","key_id":"bridge-current","issued_at_ms":1784000000000,"nonce":"base64url-16-byte-value","route_payload":{}},"signature":"lowercase-64-hex"}
+```
+
+`unsigned_body` contains exactly `schema_version`, `key_id`, `issued_at_ms`, `nonce`, and `route_payload`. `route_payload` is the route-specific content: ingress account/sender/conversation/raw event, receipt-status account plus one identifier, or outbound receipt. The signer constructs exactly:
+
+```json
+{"method":"POST","path":"<exact route>","body":{"schema_version":"aios.signed-request.v1","key_id":"bridge-current","issued_at_ms":1784000000000,"nonce":"base64url-16-byte-value","route_payload":{}}}
+```
+
+The signing input is canonical JSON encoded as UTF-8, with object keys recursively sorted by Unicode code point, `,` and `:` separators, no insignificant whitespace, no ASCII escaping of Unicode, no floats, and protocol IDs represented as strings. `signature` is lowercase 64-hex HMAC-SHA256 of those bytes. It is outside `unsigned_body` and outside the signing input. Verification reconstructs the same object using literal method `POST` and the exact request path; no normalized, decoded, prefix-matched, or caller-declared path is accepted.
+
+Transport authentication is fail-closed:
+
+- accepted clock skew is at most 30 seconds in either direction;
+- `(key_id, nonce)` is retained in a durable replay cache for five minutes;
+- a nonce decoding to any length other than 16 bytes is rejected;
+- a repeated nonce is `REPLAY_REJECTED`, even when payload and signature are identical;
+- every retry creates a cryptographically fresh nonce and `issued_at_ms` while preserving the exact event/message identity used for idempotency;
+- the keyring contains one active key and at most one previous key; `key_id` selects the key and unknown IDs fail;
+- rotation first installs the new verifier key, then switches the Node signer, then removes the old key only after the five-minute replay window and maximum request lifetime have elapsed.
+
+The Node candidate gateway receives the bridge-ingress and receipt-read keyrings through separate systemd `LoadCredential=` entries below `$CREDENTIALS_DIRECTORY`. It never receives the Python internal signing key or authority map. Only after B4 evidence is accepted, the Node Weixin sender receives a third, separate `outbound-receipt-write` credential for authenticated callbacks.
+
+## Service routes and bounded responses
+
+The Python service binds loopback only and exposes exactly:
+
+- `GET /health/live`
+- `GET /health/ready`
+- `POST /v1/ingress`
+- `POST /v1/receipts/status`
+- `POST /v1/outbound-receipts`
+
+`POST /v1/ingress` requires the `bridge-ingress` HMAC role. `POST /v1/receipts/status` requires `receipt-read`; its `route_payload` contains `account_id` plus exactly one of `event_id` or `receipt_id`. Both or neither is `VALIDATION_FAILED`. Resolution is restricted to the same account and event scope, and unknown/cross-account identifiers return the same bounded result. `POST /v1/outbound-receipts` requires `outbound-receipt-write`; no receipt role can submit ingress. Every route uses the one POST signing contract above and the same nonce, skew, replay, rotation, and fresh-retry rules.
+
+Request bodies are at most 1 MiB. Any JSON response is at most 4096 bytes and contains only stable codes and bounded identifiers. The ingress response fields are `status`, `event_id`, `message_id`, and `receipt_id`. The receipt-status response fields are `status`, `receipt_id`, `event_id`, `updated_at`, `outbox_status`, `outbound_status`, and `evidence_state`. No response contains message bodies, quote text, attachments, route objects, paths, signatures, keys, provider payloads, or exception text.
+
+Runtime-to-HTTP status mapping is exact:
+
+| Stable status | HTTP | Retry rule |
+|---|---:|---|
+| `ACCEPTED` | 202 | Terminal; query receipt after transport uncertainty |
+| `AUTH_FAILED` | 401 | No retry until credential or authority changes |
+| `REPLAY_REJECTED` | 409 | Transport/service only; retry same event with a fresh nonce |
+| `VALIDATION_FAILED` | 400 | No retry |
+| `CONFLICT` | 409 | Operator review |
+| `INTERNAL_ERROR` | 503 | Query receipt first; identical event may retry with fresh nonce |
+
+## Canonical Python package
+
+The release package has one V2R1 import identity: `aios_v2r1`. There is no `active_runtime` compatibility shim, alias package, `sys.modules` alias, or copied source tree.
+
+`active-runtime/pyproject.toml` packages `aios_v2r1` from `active-runtime/app`. Repository tests use `PYTHONPATH='active-runtime:active-runtime/app'`: legacy modules import as `app.*`, while V2R1 imports as `aios_v2r1.*`. The implementation plan enumerates all 23 known `active_runtime.app` test imports and replaces them explicitly. Full collection, full pytest, and wheel inspection must prove the wheel contains one V2R1 namespace and that source and installed imports resolve to `aios_v2r1` only.
+
+## Exact projection, quote, and attachment authority
+
+`WeixinProjection` runs in Python after transport authentication. It preserves numeric Weixin IDs from the JSON token as decimal strings and rejects a value that has already passed through unsafe JavaScript-number conversion.
+
+- `event_id` is deterministic from authenticated account, sender, conversation, direction, and exact protocol event ID.
+- `message_id` is an exact provider/server message ID when supplied.
+- `reply_to_message_id` comes only from an explicit reference ID.
+- `quoted_body` comes only from explicit referenced text or from `MessageLedger.resolve_quote()` using the fully scoped exact message ID.
+- Timestamp, nearest-message order, recent-message cache, numeric approximation, prefix, similarity, and local client ID are never quote authority.
+
+`CanonicalAttachment` contains `attachment_id`, `kind`, `media_type`, `sha256`, and `size_bytes`. Attachment bytes are accepted only when exact protocol identity and digest/size verification both pass. A reference without exact media evidence cannot fall back to the latest image.
+
+`Date.now()` is local send telemetry only. It may populate a local observation timestamp but cannot populate a provider timestamp, resolve a quote, correlate a client ID, or select a message.
+
+## Outbound evidence and hard stop
+
+The current Weixin protocol evidence cannot bind an outbound client ID to a later reference:
+
+- send acknowledgement: `ret` and `errmsg` only;
+- later reference: `ref_msg.message_item.msg_id` and `ref_msg.message_item.create_time_ms`;
+- absent evidence: the original outbound `client_id` echoed beside the provider `message_id`.
+
+Therefore outbound quote authority is unavailable. A successful send may be recorded as transport success, but `OutboundReceipt.evidence_state` must be `EVIDENCE_REQUIRED`, and the release gate must hard STOP. `sent` does not mean `confirmed`, and neither timestamp equality nor proximity may upgrade it.
+
+The only acceptable future unlock is verified provider/reference evidence that echoes or otherwise exactly binds `client_id -> message_id`. That evidence must include the raw protocol fields, parser test, collision test, and a durable mapping scoped by tenant, cell, account, peer, direction, and exact IDs. Until then no outbound record becomes quote authority.
+
+`OutboundReceipt` has stable fields:
+
+```text
+receipt_id, outbox_id, tenant_id, cell_id, channel, channel_account_id,
+peer_id, client_message_id, provider_message_id, payload_sha256,
+status = sent | confirmed | failed,
+evidence_state = EXACT | EVIDENCE_REQUIRED
+```
+
+`provider_message_id` is null while evidence is unavailable. `POST /v1/outbound-receipts` rejects any attempt to synthesize it from `Date.now()`, `ref_msg.message_item.create_time_ms`, message order, or approximate matching. Every local timestamp field is explicitly suffixed `_ms` and remains telemetry.
+
+After B4 evidence is accepted, the actual Node Weixin sender owns its outbound callback retry journal at `$STATE_DIRECTORY/outbound-receipts`. Its systemd unit declares a gateway-specific `StateDirectory=` and `StateDirectoryMode=0700`; systemd owns that directory to the unit's `User=`/`Group=`, and no other gateway service user may read it. The sender receives its separate `outbound-receipt-write` `LoadCredential=` entry only at that gate. Each journal entry is one sanitized JSON record per client ID, named by a safe fixed-width digest of that ID. It contains only bounded identifiers, send-success state, callback-attempt count, and next-attempt metadata—never message bodies, quote text, attachments, signatures, key material, credentials, or provider payloads.
+
+Persistence is exact: create a same-directory temporary file with mode `0600`, owned and readable only by that gateway's service user, write the sanitized record, `fsync` the file, atomically rename it to its final `.pending` name, then `fsync` the directory. Startup recovery and a background worker retry authenticated callbacks with bounded attempts and backoff; they never call the Weixin send operation again. A pending record is deleted, followed by directory `fsync`, only after the Python callback returns an authenticated application ACK. Transport uncertainty, non-ACK responses, and callback authentication failures retain the record for bounded retry.
+
+Ownership is deliberately split. Node owns this send-success/callback-retry journal. Python owns the authenticated receipt endpoint, receipt store, outbox, and Hermes worker state. Python does not create or own a second send journal, so there is only one durable resend boundary.
+
+## Real Hermes HTTP adapter and outbox semantics
+
+The runtime does not claim that the local `HermesFabric` SQLite primitive is the production Hermes transport. Production dispatch uses:
+
+- readiness: `GET http://127.0.0.1:18791/health/ready`;
+- submission: `POST http://127.0.0.1:18791/internal/hermes/route`;
+- owner: `aios-hermes-router.service`;
+- downstream executor budget: exactly 140 seconds;
+- worker HTTP deadline: 150 seconds, so the known 120-second direct-bridge mismatch is removed.
+
+`HermesHttpAdapter` validates bounded request and response schemas before accepting a result. `HermesOutbox` provides durable intent and leases, but the system makes no exactly-once claim. Exact local states are `pending`, `leased`, `delivered`, `delivery_unknown`, and `dead`.
+
+Repeated delivery behavior depends on evidence:
+
+- if the verified router contract proves the same `route_id` and payload digest are idempotent, an expired/failed attempt may retry with that exact pair;
+- if idempotency is false, the worker never automatically retries an ambiguous submission;
+- if idempotency is unresolved, B4 stops before implementation and commit;
+- a client timeout or connection loss after send becomes `delivery_unknown`, never a fabricated failure or success.
+
+B4 evidence must record the live listener, owning unit, executable/source digest, readiness response schema, route request fields, route response fields, exact 140-second downstream timeout, router tenant/user ownership rules, and repeated-`route_id` behavior. The dedicated `aios-v2r1-hermes-worker.service` is installed only in B5 after this evidence is accepted.
+
+## OpenClaw plugin compatibility and permissions
+
+The plugin configuration contract is exact:
+
+- `blockUnknownAgentRuns`: boolean, default `false`;
+- `approvalTimeoutMs`: integer, minimum `1000`, maximum `300000`, default `60000`;
+- package and manifest versions are identical;
+- every property read by runtime code appears in `configSchema`.
+
+Unit tests with a fake API remain useful, but they are insufficient. B1 must run the real OpenClaw loader in an isolated state/config directory. It must prove two permission states:
+
+1. Default hook permissions: runtime inspection shows only `before_tool_call` is usable for this plugin; no test treats `before_agent_run` provenance as present.
+2. Explicit conversation access: set `plugins.entries.aios-tenant-boundary.hooks.allowConversationAccess=true`, validate config, reload/inspect runtime, and prove `before_agent_run`, `before_tool_call`, and `agent_end` are installed.
+
+The default remains fail-closed for side effects because absent run provenance cannot authorize them. Candidate production never relies on the default-only state; the isolated staging config explicitly opts in and is validated.
+
+## Isolated candidate staging and plugin loader sequence
+
+B5 defines separate staging and production gateway units plus the isolated ingress and worker units. Staging starts the candidate trio; production gateway activation occurs only through the evidence-gated promotion/migration:
+
+- `aios-v2r1-candidate-gateway.service`
+- `aios-v2r1-production-gateway.service`
+- `aios-v2r1-ingress.service`
+- `aios-v2r1-hermes-worker.service`
+
+The candidate gateway uses its dedicated service user with `StateDirectory=aios-v2r1-candidate-gateway`; the migrated production gateway uses a different dedicated service user with `StateDirectory=aios-v2r1-production-gateway`. Both units set `StateDirectoryMode=0700`, and both resolve their journal only as `$STATE_DIRECTORY/outbound-receipts`. The names, absolute paths, owners, and journal contents are distinct; staging and production never share, bind-mount, or symlink journal state. The current root-run production gateway retains its own root-owned state only until an explicit audited migration. Candidate staging never reads that state. Migration verifies pending records contain no bodies or secrets, installs them only into the production-specific directory with its service user ownership and mode `0600`, and leaves no root-owned production journal in active use.
+
+The candidate gateway has its own OpenClaw state directory, config file, port, credentials, and plugin link. It does not edit or restart the active V1R4C6 gateway. The loader sequence against the candidate state is fixed:
+
+```bash
+openclaw plugins install --link "$candidate_release/openclaw/plugins/aios-tenant-boundary"
+openclaw plugins inspect aios-tenant-boundary --runtime --json
+openclaw config set plugins.entries.aios-tenant-boundary.hooks.allowConversationAccess true --strict-json
+openclaw config validate
+openclaw doctor --lint --json
+openclaw doctor --post-upgrade --json
+openclaw plugins inspect aios-tenant-boundary --runtime --json
+```
+
+The environment supplies the isolated config/state paths. Any command that resolves to the active V1R4C6 config is a hard stop. Inspection output must prove the linked candidate path, version, hooks, and permission state.
+
+## Artifact, preflight evidence, promotion, and rollback
+
+One deterministic archive and manifest are built from a clean reviewed commit. Staging and production consume byte-identical artifact digests. `NOOP_DIGEST_MATCH` returns exit 0 and performs no extraction, migration, symlink change, restart, or deployment audit increment.
+
+The executable controller is `python3 deploy/v2r1/release_ctl.py` with commands `build`, `stage`, `verify-stage`, `promote`, `status`, and `rollback`. Forward state transitions are exactly `BUILT -> STAGED -> STAGE_VERIFIED -> PRODUCTION`; skipping or reversing a forward edge is rejected. `capture_live_preflight.py` creates the evidence file and every mutating controller command accepts it as `--preflight-file`; callers never supply digest strings. The controller validates the evidence schema, exact host identity, reconciled sentinel health and candidate refs, required runtime fields, and capture freshness of at most 300 seconds. It then computes the artifact, reconciled-sentinel, and runtime-snapshot SHA-256 digests internally and persists that triplet in the state record.
+
+`verify-stage` and `promote` each invoke the live collector again, validate the fresh result by the same rules, recompute the triplet internally, and compare the recaptured live state with the recorded candidate state. Any host, sentinel, candidate-ref, runtime-field, artifact, or digest drift rejects the transition. `status` is read-only. Rollback transitions are `PRODUCTION -> ROLLBACK_STARTED -> ROLLED_BACK`; a failed recovery records `ROLLBACK_FAILED` without claiming the prior state is active. `NOOP_DIGEST_MATCH` leaves the current state and all three digests unchanged.
+
+Before staging and again before promotion, both pieces of live evidence are mandatory:
+
+- reconciled Gitea branch-consistency sentinel: `status=healthy`, `drift_count=0`, and recorded refs matching the candidate manifest;
+- V1R4C6 live-runtime snapshot: active Git SHA, service units, process commands, listener ports, OpenClaw version, config/plugin digests, credential metadata without secrets, state/database paths, mounts, current artifact identity, and rollback target.
+
+The snapshot is immutable, SHA-256-addressed, and timestamped. Promotion rejects a snapshot older than 300 seconds or any live drift from it. `capture_live_preflight.py` creates these evidence inputs from live inspection; `release_ctl.py` may validate and recapture them but may not invent missing fields or accept caller-asserted digests.
+
+The host sentinel `/var/lib/aios-v2r1/STOP` blocks forward mutation: install, migration, staging activation, promotion, candidate/production restart, and new artifact selection. It does not block one constrained recovery command:
+
+```text
+rollback --rollback-only --to-previous-recorded --reason-file "$reason_file"
+```
+
+That escape may only select the exact previous digest and its recorded compatible database snapshot; it cannot install new bytes, run forward migrations, choose an arbitrary digest, remove the sentinel, or start a new candidate. It writes an audit record before and after the attempt. If previous-state evidence is missing or fails digest/integrity checks, rollback also stops.
+
+The tracked `release/v2r1c0-rc1/FLEET_UNSUPPORTED` capability sentinel remains authoritative. `OpenClawFleet` and `openclaw fleet` are outside this release.
+
+## Stop conditions
+
+Preparation or release stops when any of these is true:
+
+- corrected design/plan review is not accepted;
+- a B3/B4/B5 evidence gate remains unresolved;
+- authoritative Git refs differ from reviewed values or the worktree is dirty;
+- the real plugin loader does not prove the required hook permissions;
+- transport key role, `key_id`, timestamp, exact nonce length, skew, replay cache, rotation, or fresh-retry behavior fails;
+- Node attempts projection/authority resolution or Python trusts route claims from the raw event;
+- `ACCEPTED` can fall through to legacy processing, or legacy runs while bridge mode is `enforced`;
+- quote or attachment resolution uses timestamp, approximation, recent order, or a local client ID;
+- outbound evidence remains `EVIDENCE_REQUIRED`;
+- Hermes schema, ownership, 140-second downstream budget, router identity rules, or repeated-route behavior is unresolved;
+- any code or document claims exactly-once Hermes delivery;
+- the candidate gateway is not isolated from V1R4C6;
+- reconciled sentinel or V1R4C6 live-runtime snapshot is absent, stale, inconsistent, or digest-invalid;
+- artifact, migration, staging, or production digest differs;
+- the STOP sentinel blocks a forward action;
+- constrained rollback cannot prove the exact previous artifact and compatible snapshot;
+- any main, tag, `VERSION`, baseline, live service, or deployment mutation occurs without the separate release authorization.
+
+## Acceptance
+
+The design is review-complete when the plan contains exactly five blocker commits, dynamically anchors their parent chain at B1 start, enumerates all legacy import edits, and has executable RED/GREEN/review gates. Runtime release acceptance additionally requires all B3/B4/B5 evidence gates, the full Python collection and suite, the real Node/OpenClaw loader harness, exact receipt semantics, isolated candidate staging, deterministic artifacts, current live evidence, and rehearsed constrained rollback.
@@ -1,42 +0,0 @@
-# AIOS Task Plane
-
-该模块是与任务发起方、Worker 类型和通知后端解耦的持久化任务控制平面。当前交付仅用于隔离开发与 Shadow 验收；默认 `execution_enabled=false`，不会修改生产、tag、Baseline 或 Registry。
-
-## 架构
-
- `TaskPlaneService`：统一服务边界和 HTTP 路由。
- `TaskPlaneStore`：SQLite WAL、revision/CAS、串行事务、租约、hash-chained journal、evidence 和 durable outbox。
- `WorkerRegistry` / `LeaseManager`：身份绑定、capability、并发额度、心跳、过期探测后恢复。
- `DelegationEngine`：父子 DAG、全局深度、capability/risk/approval/budget 单调约束和幂等重放。
- `PolicyEngine`：默认关闭执行；身份、证据、结果摘要和可插拔签名验签均 fail-closed。
- `WorkerAdapter`：OpenClaw、Codex、Hermes、A2A 和 systemd Worker 的统一契约。默认实现只返回 `SHADOW_VERIFIED`，不执行外部命令。
- `DurableOutboxDispatcher`：Webhook、NATS JetStream、GPT callback、Dashboard 和 WeChat 的回执式通知接口。没有真实回执时始终保留 `NOT_DELIVERED`。
-
-## 状态与恢复
-
-正常路径为 `CREATED → QUEUED/CLAIMED → RUNNING → VERIFYING/COMPLETED`；失败路径使用 `FAILED_RECOVERABLE`、`FAILED_FINAL`、`CANCELLED` 或 `MANUAL_REVIEW_REQUIRED`。每次状态事件都进入同一事务中的 append-only hash chain。
-
-租约过期不会自动重放副作用。控制平面必须先调用 Worker probe，只有明确确认原执行已停止，才可将 claim 标记为 `EXPIRED` 并把任务转为 `FAILED_RECOVERABLE`。结果必须匹配 task、claim、Worker identity、未过期 lease 和 operation digest；重复结果返回冲突。
-
-## 安全模型
-
- task/worker/claim/message ID 使用 allowlist pattern，拒绝 URL 编码差异、路径分隔符和控制字符。
- HTTP body 最大 1 MB，非对象 JSON、异常 Content-Length 和非法参数返回 400/413。
- 内部异常响应不回显路径、payload 或凭据；默认 HTTP access log 不记录原始 request target。
- secret-like 字段在 durable task、event、evidence 和 outbox 写入前脱敏。
- 结果签名存在但没有配置验签器时拒绝；摘要、evidence 或 event 被篡改时验收失败。
- SQLite 文件创建为 0600；新建状态目录使用 0700。
-
-## 验收
-
-```bash
-PYTHONPATH=active-runtime \
-  bash scripts/task-plane/run_task_plane_acceptance.sh
-
-PYTHONPATH=active-runtime \
-  python3 scripts/task-plane/create_shadow_tasks.py \
-    --database reports/task-plane-shadow.sqlite3 \
-    --report reports/task-plane-shadow.json
-```
-
-上述脚本只使用本地 SQLite 和 Shadow adapter，不触发真实 OpenClaw、Codex、Hermes、微信或生产执行。
@@ -1,314 +0,0 @@
-openapi: 3.0.3
-info:
-  title: AIOS Task Plane API
-  version: 1.0.0
-  description: >
-    Durable control-plane APIs for task orchestration with fail-closed policy.
-    Every POST operation requires bearerAuth; read-only GET operations may be
-    exposed according to the surrounding runtime policy.
-servers:
-  - url: /
-paths:
-  /tasks:
-    get:
-      summary: List tasks
-      responses:
-        "200":
-          description: Task list
-    post:
-      security: [ { bearerAuth: [] } ]
-      summary: Create task
-      parameters:
-        - in: header
-          name: Idempotency-Key
-          required: false
-          schema:
-            type: string
-            minLength: 1
-            maxLength: 128
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/TaskPlan"
-      responses:
-        "201": { description: Created }
-        "400": { description: Bad request }
-        "401": { description: Unauthorized }
-        "403": { description: Forbidden }
-        "409": { description: Conflict }
-        "413": { description: Payload too large }
-        "423": { description: Execution or resource locked }
-        "503": { description: Authentication or service unavailable }
-  /tasks/{task_id}:
-    get:
-      summary: Get task
-      parameters:
-        - $ref: "#/components/parameters/TaskId"
-      responses:
-        "200": { description: OK }
-        "404": { description: Not found }
-  /tasks/{task_id}/claim:
-    post:
-      security: [ { bearerAuth: [] } ]
-      summary: Claim a task
-      parameters:
-        - $ref: "#/components/parameters/TaskId"
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/TaskClaimRequest"
-      responses:
-        "200": { description: Claimed }
-        "401": { description: Unauthorized }
-        "403": { description: Forbidden }
-        "404": { description: Not found }
-        "409": { description: Conflict }
-        "423": { description: Execution disabled }
-  /tasks/{task_id}/heartbeat:
-    post:
-      security: [ { bearerAuth: [] } ]
-      summary: Renew task claim lease
-      parameters: [ $ref: "#/components/parameters/TaskId" ]
-      responses:
-        "200": { description: Leased }
-        "400": { description: Bad request }
-        "401": { description: Unauthorized }
-        "403": { description: Forbidden }
-        "404": { description: Task or claim not found }
-        "409": { description: Claim conflict }
-        "413": { description: Payload too large }
-        "423": { description: Lease or execution locked }
-        "503": { description: Service unavailable }
-  /tasks/{task_id}/progress:
-    post:
-      security: [ { bearerAuth: [] } ]
-      summary: Report task progress
-      parameters: [ $ref: "#/components/parameters/TaskId" ]
-      responses:
-        "200": { description: Progress saved }
-        "400": { description: Bad request }
-        "401": { description: Unauthorized }
-        "403": { description: Forbidden }
-        "404": { description: Task or claim not found }
-        "409": { description: Claim conflict }
-        "413": { description: Payload too large }
-        "423": { description: Lease or execution locked }
-        "503": { description: Service unavailable }
-  /tasks/{task_id}/result:
-    post:
-      security: [ { bearerAuth: [] } ]
-      summary: Submit task result
-      parameters: [ $ref: "#/components/parameters/TaskId" ]
-      responses:
-        "200": { description: Result accepted }
-        "400": { description: Bad request }
-        "401": { description: Unauthorized }
-        "403": { description: Result policy rejected }
-        "404": { description: Task or claim not found }
-        "409": { description: Duplicate or mismatched result }
-        "413": { description: Payload too large }
-        "423": { description: Lease or execution locked }
-        "503": { description: Verification service unavailable }
-  /tasks/{task_id}/fail:
-    post:
-      security: [ { bearerAuth: [] } ]
-      summary: Mark task failed
-      parameters: [ $ref: "#/components/parameters/TaskId" ]
-      responses:
-        "200": { description: Failure recorded }
-        "400": { description: Bad request }
-        "401": { description: Unauthorized }
-        "403": { description: Forbidden }
-        "404": { description: Task or claim not found }
-        "409": { description: Claim conflict }
-        "413": { description: Payload too large }
-        "423": { description: Lease or execution locked }
-        "503": { description: Service unavailable }
-  /tasks/{task_id}/cancel:
-    post:
-      security: [ { bearerAuth: [] } ]
-      summary: Cancel task
-      parameters: [ $ref: "#/components/parameters/TaskId" ]
-      responses:
-        "200": { description: Cancelled }
-        "400": { description: Bad request }
-        "401": { description: Unauthorized }
-        "403": { description: Forbidden }
-        "404": { description: Task not found }
-        "409": { description: Revision or state conflict }
-        "413": { description: Payload too large }
-        "423": { description: Resource locked }
-        "503": { description: Service unavailable }
-  /tasks/{task_id}/delegate:
-    post:
-      security: [ { bearerAuth: [] } ]
-      summary: Delegate task
-      parameters: [ $ref: "#/components/parameters/TaskId" ]
-      responses:
-        "200": { description: Delegated }
-        "400": { description: Bad request }
-        "401": { description: Unauthorized }
-        "403": { description: Forbidden }
-        "404": { description: Parent task not found }
-        "409": { description: Conflict }
-        "413": { description: Payload too large }
-        "423": { description: Execution locked }
-        "503": { description: Service unavailable }
-  /workers/register:
-    post:
-      security: [ { bearerAuth: [] } ]
-      summary: Register worker
-      responses:
-        "201": { description: Worker registered }
-        "400": { description: Bad request }
-        "401": { description: Unauthorized }
-        "403": { description: Worker identity mismatch }
-        "409": { description: Registration conflict }
-        "413": { description: Payload too large }
-        "423": { description: Resource locked }
-        "503": { description: Service unavailable }
-  /workers/{worker_id}/heartbeat:
-    post:
-      security: [ { bearerAuth: [] } ]
-      summary: Worker heartbeat
-      parameters: [ $ref: "#/components/parameters/WorkerId" ]
-      responses:
-        "200": { description: Heartbeat accepted }
-        "400": { description: Bad request }
-        "401": { description: Unauthorized }
-        "403": { description: Forbidden }
-        "404": { description: Worker not found }
-        "409": { description: Worker state conflict }
-        "413": { description: Payload too large }
-        "423": { description: Worker locked }
-        "503": { description: Service unavailable }
-  /workers:
-    get:
-      summary: List workers
-      responses:
-        "200": { description: Worker list }
-  /workers/{worker_id}:
-    get:
-      summary: Get worker
-      parameters: [ $ref: "#/components/parameters/WorkerId" ]
-      responses:
-        "200": { description: Worker details }
-  /tasks/{task_id}/events:
-    get:
-      summary: Task events
-      parameters: [ $ref: "#/components/parameters/TaskId" ]
-      responses:
-        "200": { description: Event list }
-  /tasks/{task_id}/evidence:
-    get:
-      summary: Task evidence
-      parameters: [ $ref: "#/components/parameters/TaskId" ]
-      responses:
-        "200": { description: Evidence list }
-  /tasks/{task_id}/children:
-    get:
-      summary: Task child tasks
-      parameters: [ $ref: "#/components/parameters/TaskId" ]
-      responses:
-        "200": { description: Child list }
-components:
-  securitySchemes:
-    bearerAuth:
-      type: http
-      scheme: bearer
-      bearerFormat: opaque
-  parameters:
-    TaskId:
-      name: task_id
-      in: path
-      required: true
-      schema:
-        type: string
-        minLength: 1
-        maxLength: 128
-        pattern: '^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$'
-    WorkerId:
-      name: worker_id
-      in: path
-      required: true
-      schema:
-        type: string
-        minLength: 1
-        maxLength: 128
-        pattern: '^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$'
-  schemas:
-    TaskPlan:
-      type: object
-      additionalProperties: false
-      properties:
-        schema_version: { type: integer, enum: [1] }
-        task_id:
-          type: string
-          minLength: 1
-          maxLength: 128
-          pattern: '^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$'
-        task_type:
-          type: string
-          minLength: 1
-          maxLength: 128
-          pattern: '^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$'
-        issuer: { type: object }
-        intent: { type: string, maxLength: 16384 }
-        required_capabilities:
-          type: array
-          maxItems: 128
-          items: { type: string }
-        preferred_workers:
-          type: array
-          maxItems: 64
-          items: { type: string }
-        risk: { type: string, enum: [low, medium, high] }
-        approval_policy:
-          type: string
-          maxLength: 128
-        dependencies:
-          type: array
-          maxItems: 128
-          items: { type: string }
-        max_delegation_depth: { type: integer, minimum: 0, maximum: 32 }
-        budgets:
-          type: object
-          additionalProperties: false
-          properties:
-            time_seconds: { type: integer, minimum: 0 }
-            attempts: { type: integer, minimum: 0 }
-            tokens: { type: integer, minimum: 0 }
-            cost: { type: number, minimum: 0 }
-        evidence_requirements:
-          type: array
-          maxItems: 128
-          items: { type: string }
-        parent_task_id:
-          type: string
-          maxLength: 128
-        correlation_id:
-          type: string
-          maxLength: 128
-        metadata:
-          type: object
-    TaskClaimRequest:
-      type: object
-      additionalProperties: false
-      required: [worker_id, actor_identity]
-      properties:
-        worker_id:
-          type: string
-          maxLength: 128
-          pattern: '^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$'
-        lease_seconds:
-          type: integer
-          minimum: 1
-          maximum: 3600
-        actor_identity:
-          type: string
-          minLength: 1
-          maxLength: 512
@@ -0,0 +1,111 @@
+import {
+  classifyRun,
+  decideToolCall,
+  resolveSenderId,
+  runKey,
+} from "./policy.js";
+
+const MAX_RUN_AGE_MS = 60 * 60 * 1000;
+
+function prune(activeRuns, now = Date.now()) {
+  for (const [key, value] of activeRuns.entries()) {
+    if (now - value.recordedAt > MAX_RUN_AGE_MS) activeRuns.delete(key);
+  }
+}
+
+function approvalTimeout(config) {
+  const value = config.approvalTimeoutMs;
+  return Number.isInteger(value) && value >= 1000 && value <= 300000
+    ? value
+    : 60000;
+}
+
+export default {
+  id: "aios-tenant-boundary",
+  name: "AIOS Tenant Boundary",
+  description: "Fail-closed user-origin and side-effect policy for Tenant Cells.",
+
+  register(api) {
+    const activeRuns = new Map();
+
+    api.on(
+      "before_agent_run",
+      async (event, ctx) => {
+        prune(activeRuns);
+        const config = event.context?.pluginConfig ?? api.pluginConfig ?? {};
+        const trust = classifyRun(ctx, config);
+        const key = runKey(event, ctx);
+        const existing = key ? activeRuns.get(key) : undefined;
+        if (existing && existing.senderId !== trust.senderId) {
+          return {
+            outcome: "block",
+            reason: "run_scope_sender_conflict",
+            message: "This run scope is already bound to a different authenticated sender.",
+          };
+        }
+        if (key) {
+          activeRuns.set(key, { ...trust, recordedAt: Date.now() });
+        }
+
+        if (
+          config.blockUnknownAgentRuns === true &&
+          trust.trusted !== true &&
+          trust.reason !== "job_id_present"
+        ) {
+          return {
+            outcome: "block",
+            reason: trust.reason,
+            message: "This message cannot be verified as coming from the active authenticated user.",
+          };
+        }
+        return { outcome: "pass" };
+      },
+      { priority: 100 },
+    );
+
+    api.on(
+      "before_tool_call",
+      async (event, ctx) => {
+        prune(activeRuns);
+        const config = event.context?.pluginConfig ?? api.pluginConfig ?? {};
+        const key = runKey(event, ctx);
+        let trust = key ? activeRuns.get(key) : undefined;
+        const senderId = resolveSenderId(ctx);
+        if (trust && senderId && trust.senderId !== senderId) {
+          trust = { trusted: false, reason: "run_scope_sender_conflict" };
+        }
+        const decision = decideToolCall(event.toolName, trust, config);
+
+        if (decision.action === "block") {
+          return {
+            block: true,
+            blockReason: `AIOS V2R1 origin policy denied tool call: ${decision.code}`,
+          };
+        }
+        if (decision.action === "approval") {
+          return {
+            requireApproval: {
+              title: `Approve ${String(event.toolName)}`,
+              description: "Authenticated user requested a side-effecting tool call in this Tenant Cell.",
+              severity: "warning",
+              timeoutMs: approvalTimeout(config),
+              allowedDecisions: ["allow-once", "deny"],
+              pluginId: "aios-tenant-boundary",
+            },
+          };
+        }
+        return undefined;
+      },
+      { priority: 100 },
+    );
+
+    api.on(
+      "agent_end",
+      async (event, ctx) => {
+        const key = runKey(event, ctx);
+        if (key) activeRuns.delete(key);
+      },
+      { priority: 100 },
+    );
+  },
+};
@@ -0,0 +1,91 @@
+const DEFAULT_READ_ONLY_TOOLS = Object.freeze([
+  "read", "grep", "glob", "find", "ls", "web_search", "web_fetch",
+  "memory_search", "sessions_list", "sessions_history", "session_status",
+]);
+
+function strings(value) {
+  return Array.isArray(value)
+    ? value.filter((item) => typeof item === "string" && item.trim())
+        .map((item) => item.trim())
+    : [];
+}
+
+export function resolveSenderId(ctx = {}) {
+  const direct = typeof ctx.senderId === "string" ? ctx.senderId.trim() : "";
+  const nested = typeof ctx.channelContext?.sender?.id === "string"
+    ? ctx.channelContext.sender.id.trim()
+    : "";
+  return direct || nested || undefined;
+}
+
+export function classifyRun(ctx = {}, config = {}) {
+  const senderId = resolveSenderId(ctx);
+  const trusted = new Set(strings(config.trustedSenderIds));
+  const blocked = new Set(strings(config.blockedSenderIds));
+
+  if (typeof ctx.jobId === "string" && ctx.jobId) {
+    return { trusted: false, origin: "automation", reason: "job_id_present" };
+  }
+  if (!senderId) {
+    return { trusted: false, origin: "system_or_unknown", reason: "sender_id_missing" };
+  }
+  if (blocked.has(senderId)) {
+    return { trusted: false, origin: "blocked_sender", reason: "sender_blocked", senderId };
+  }
+  if (config.requireExplicitTrustedSenders !== false && !trusted.has(senderId)) {
+    return { trusted: false, origin: "untrusted_sender", reason: "sender_not_allowlisted", senderId };
+  }
+  return {
+    trusted: true,
+    origin: "authenticated_channel_user",
+    reason: "sender_verified",
+    senderId,
+  };
+}
+
+export function decideToolCall(toolName, runTrust, config = {}) {
+  const name = typeof toolName === "string" ? toolName.trim().toLowerCase() : "";
+  const configured = strings(config.readOnlyTools).map((item) => item.toLowerCase());
+  const readOnly = new Set(configured.length ? configured : DEFAULT_READ_ONLY_TOOLS);
+  if (!name) {
+    return { action: "block", code: "tool_name_missing" };
+  }
+  if (readOnly.has(name)) {
+    return { action: "allow", code: "read_only" };
+  }
+  if (!runTrust || runTrust.trusted !== true) {
+    return {
+      action: "block",
+      code: runTrust?.reason || "run_provenance_missing",
+    };
+  }
+  if (config.requireApprovalForHumanSideEffects === false) {
+    return { action: "allow", code: "trusted_side_effect" };
+  }
+  return { action: "approval", code: "human_side_effect" };
+}
+
+export function runKey(event = {}, ctx = {}) {
+  const normalize = (value) => typeof value === "string" && value.trim()
+    ? value.trim()
+    : undefined;
+  const sameField = (eventValue, contextValue) => {
+    const fromEvent = normalize(eventValue);
+    const fromContext = normalize(contextValue);
+    return {
+      valid: !(fromEvent && fromContext && fromEvent !== fromContext),
+      value: fromEvent || fromContext,
+    };
+  };
+  const runId = sameField(event.runId, ctx.runId);
+  const agentId = sameField(event.agentId, ctx.agentId);
+  const sessionId = sameField(event.sessionId, ctx.sessionId);
+  const sessionKey = sameField(event.sessionKey, ctx.sessionKey);
+  if (!runId.valid || !agentId.valid || !sessionId.valid || !sessionKey.valid) {
+    return undefined;
+  }
+  const selectedSession = sessionId.value || sessionKey.value;
+  return runId.value && agentId.value && selectedSession
+    ? JSON.stringify([runId.value, agentId.value, selectedSession])
+    : undefined;
+}
@@ -0,0 +1,25 @@
+{
+  "id": "aios-tenant-boundary",
+  "name": "AIOS Tenant Boundary",
+  "description": "Enforces AIOS V2R1 tenant provenance and tool policy boundaries.",
+  "version": "2.1.0-rc.1",
+  "entry": "dist/index.js",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "requireExplicitTrustedSenders": { "type": "boolean", "default": true },
+      "trustedSenderIds": { "type": "array", "items": { "type": "string" }, "default": [] },
+      "blockedSenderIds": { "type": "array", "items": { "type": "string" }, "default": [] },
+      "readOnlyTools": { "type": "array", "items": { "type": "string" } },
+      "requireApprovalForHumanSideEffects": { "type": "boolean", "default": true },
+      "blockUnknownAgentRuns": { "type": "boolean", "default": false },
+      "approvalTimeoutMs": {
+        "type": "integer",
+        "minimum": 1000,
+        "maximum": 300000,
+        "default": 60000
+      }
+    }
+  }
+}
@@ -0,0 +1,18 @@
+{
+  "name": "@aios/openclaw-tenant-boundary",
+  "version": "2.1.0-rc.1",
+  "type": "module",
+  "description": "AIOS V2R1 Tenant Cell provenance and side-effect policy boundary for OpenClaw.",
+  "files": [
+    "dist",
+    "openclaw.plugin.json"
+  ],
+  "scripts": {
+    "test": "node --test test/*.test.js"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  }
+}
@@ -0,0 +1,64 @@
+import assert from "node:assert/strict";
+import { readFile } from "node:fs/promises";
+import test from "node:test";
+
+import plugin from "../dist/index.js";
+
+const packageJson = JSON.parse(
+  await readFile(new URL("../package.json", import.meta.url), "utf8"),
+);
+const manifest = JSON.parse(
+  await readFile(new URL("../openclaw.plugin.json", import.meta.url), "utf8"),
+);
+
+function registrations(config = {}) {
+  const seen = [];
+  plugin.register({
+    pluginConfig: config,
+    on(name, handler, options) {
+      seen.push({ name, handler, options });
+    },
+  });
+  return seen;
+}
+
+test("package, manifest, and executable test command are release compatible", () => {
+  assert.equal(packageJson.version, "2.1.0-rc.1");
+  assert.equal(manifest.version, "2.1.0-rc.1");
+  assert.equal(packageJson.scripts.test, "node --test test/*.test.js");
+});
+
+test("schema declares every runtime-read property and exact B1 bounds", () => {
+  const properties = manifest.configSchema.properties;
+  const runtimeKeys = [
+    "approvalTimeoutMs",
+    "blockUnknownAgentRuns",
+    "blockedSenderIds",
+    "readOnlyTools",
+    "requireApprovalForHumanSideEffects",
+    "requireExplicitTrustedSenders",
+    "trustedSenderIds",
+  ];
+  assert.deepEqual(Object.keys(properties).sort(), runtimeKeys);
+  assert.deepEqual(properties.blockUnknownAgentRuns, {
+    type: "boolean",
+    default: false,
+  });
+  assert.deepEqual(properties.approvalTimeoutMs, {
+    type: "integer",
+    minimum: 1000,
+    maximum: 300000,
+    default: 60000,
+  });
+});
+
+test("all three hooks register exactly once at priority 100", () => {
+  const seen = registrations();
+  assert.deepEqual(
+    seen.map(({ name }) => name).sort(),
+    ["agent_end", "before_agent_run", "before_tool_call"],
+  );
+  for (const registration of seen) {
+    assert.deepEqual(registration.options, { priority: 100 });
+  }
+});
@@ -0,0 +1,50 @@
+import assert from "node:assert/strict";
+import { readFile } from "node:fs/promises";
+import { realpath } from "node:fs/promises";
+
+const [mode, inspectPath] = process.argv.slice(2);
+assert.ok(["default", "opt-in"].includes(mode), `unsupported mode: ${mode}`);
+assert.ok(inspectPath, "inspect JSON path is required");
+
+const data = JSON.parse(await readFile(inspectPath, "utf8"));
+const plugin = data.plugin;
+assert.equal(plugin.id, "aios-tenant-boundary");
+assert.equal(plugin.version, "2.1.0-rc.1");
+assert.equal(plugin.status, "loaded");
+assert.equal(plugin.activated, true);
+assert.equal(await realpath(plugin.rootDir), await realpath(new URL("..", import.meta.url)));
+assert.equal(await realpath(plugin.source), await realpath(new URL("../dist/index.js", import.meta.url)));
+assert.equal(data.install.source, "path");
+assert.equal(await realpath(data.install.installPath), await realpath(plugin.rootDir));
+
+const hooks = data.typedHooks
+  .map(({ name, priority }) => ({ name, priority }))
+  .sort((a, b) => a.name.localeCompare(b.name));
+const expectedNames = mode === "default"
+  ? ["before_tool_call"]
+  : ["agent_end", "before_agent_run", "before_tool_call"];
+assert.deepEqual(hooks.map(({ name }) => name), expectedNames);
+assert.ok(hooks.every(({ priority }) => priority === 100));
+
+const diagnostics = data.diagnostics ?? [];
+assert.equal(
+  diagnostics.filter(({ level, severity }) =>
+    ["error", "fatal"].includes(String(level ?? severity).toLowerCase())).length,
+  0,
+);
+if (mode === "default") {
+  assert.deepEqual(
+    diagnostics.map(({ level, message }) => ({ level, message })).sort((a, b) => a.message.localeCompare(b.message)),
+    ["agent_end", "before_agent_run"].map((hook) => ({
+      level: "warn",
+      message: `typed hook "${hook}" blocked because non-bundled plugins must set plugins.entries.aios-tenant-boundary.hooks.allowConversationAccess=true`,
+    })).sort((a, b) => a.message.localeCompare(b.message)),
+  );
+} else {
+  assert.deepEqual(diagnostics, []);
+}
+
+const properties = plugin.configJsonSchema?.properties ?? {};
+for (const key of ["approvalTimeoutMs", "blockUnknownAgentRuns"]) {
+  assert.ok(Object.hasOwn(properties, key), `missing runtime schema property: ${key}`);
+}
@@ -0,0 +1,349 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import plugin from "../dist/index.js";
+import {
+  classifyRun,
+  decideToolCall,
+  resolveSenderId,
+  runKey,
+} from "../dist/policy.js";
+
+function registration(config = {}) {
+  const handlers = new Map();
+  plugin.register({
+    pluginConfig: config,
+    on(name, handler) {
+      handlers.set(name, handler);
+    },
+  });
+  return {
+    beforeAgentRun: handlers.get("before_agent_run"),
+    beforeToolCall: handlers.get("before_tool_call"),
+    agentEnd: handlers.get("agent_end"),
+  };
+}
+
+function agentContext(id, senderId) {
+  return {
+    runId: `run-${id}`,
+    agentId: "agent-main",
+    sessionId: "session-uuid-123",
+    sessionKey: "agent:main:weixin:direct:user",
+    ...(senderId ? { senderId } : {}),
+  };
+}
+
+function toolContext(id, extra = {}) {
+  return {
+    runId: `run-${id}`,
+    agentId: "agent-main",
+    sessionId: "session-uuid-123",
+    sessionKey: "agent:main:weixin:direct:user",
+    ...extra,
+  };
+}
+
+test("sender classification covers missing, blocked, allowlisted, and automation", () => {
+  assert.equal(resolveSenderId({ channelContext: { sender: { id: " nested " } } }), "nested");
+  assert.deepEqual(classifyRun({}, {}), {
+    trusted: false,
+    origin: "system_or_unknown",
+    reason: "sender_id_missing",
+  });
+  assert.equal(
+    classifyRun({ senderId: "blocked" }, { blockedSenderIds: ["blocked"] }).reason,
+    "sender_blocked",
+  );
+  assert.equal(
+    classifyRun(
+      { senderId: "alice" },
+      { requireExplicitTrustedSenders: true, trustedSenderIds: ["alice"] },
+    ).trusted,
+    true,
+  );
+  assert.deepEqual(classifyRun({ jobId: "job-1" }, {}), {
+    trusted: false,
+    origin: "automation",
+    reason: "job_id_present",
+  });
+});
+
+test("unknown agent runs default to pass but fail closed when explicitly enabled", async () => {
+  const defaultHandlers = registration();
+  assert.deepEqual(
+    await defaultHandlers.beforeAgentRun({}, agentContext("default")),
+    { outcome: "pass" },
+  );
+
+  const enforced = registration({ blockUnknownAgentRuns: true });
+  const denied = await enforced.beforeAgentRun({}, agentContext("denied"));
+  assert.equal(denied.outcome, "block");
+  assert.equal(denied.reason, "sender_id_missing");
+  assert.doesNotMatch(denied.reason + denied.message, /undefined|\r|\n/);
+
+  assert.deepEqual(
+    await enforced.beforeAgentRun({}, { ...agentContext("job"), jobId: "job-1" }),
+    { outcome: "pass" },
+  );
+});
+
+test("read-only tools pass without provenance and side effects fail with a stable reason", async () => {
+  assert.deepEqual(decideToolCall("read", undefined, {}), {
+    action: "allow",
+    code: "read_only",
+  });
+  assert.deepEqual(decideToolCall("shell", undefined, {}), {
+    action: "block",
+    code: "run_provenance_missing",
+  });
+
+  const handlers = registration();
+  assert.equal(await handlers.beforeToolCall({ toolName: "read" }, {}), undefined);
+  const blocked = await handlers.beforeToolCall({ toolName: "shell" }, {});
+  assert.equal(blocked.block, true);
+  assert.equal(
+    blocked.blockReason,
+    "AIOS V2R1 origin policy denied tool call: run_provenance_missing",
+  );
+});
+
+test("trusted human side effects request approval with exact timeout validation", async () => {
+  for (const [configured, expected] of [
+    [undefined, 60000],
+    [1000, 1000],
+    [300000, 300000],
+    [999, 60000],
+    [300001, 60000],
+    [60000.5, 60000],
+    ["1000", 60000],
+    [null, 60000],
+  ]) {
+    const config = {
+      requireExplicitTrustedSenders: true,
+      trustedSenderIds: ["alice"],
+    };
+    if (configured !== undefined) config.approvalTimeoutMs = configured;
+    const handlers = registration(config);
+    const id = `approval-${String(configured)}`;
+    await handlers.beforeAgentRun({}, agentContext(id, "alice"));
+    const result = await handlers.beforeToolCall({ toolName: "shell" }, toolContext(id));
+    assert.equal(result.requireApproval.timeoutMs, expected, String(configured));
+    assert.deepEqual(result.requireApproval.allowedDecisions, ["allow-once", "deny"]);
+  }
+});
+
+test("active run provenance is isolated by registration, run, and sender", async () => {
+  const config = {
+    requireExplicitTrustedSenders: true,
+    trustedSenderIds: ["alice", "bob"],
+  };
+  const first = registration(config);
+  const second = registration(config);
+  await first.beforeAgentRun({}, agentContext("shared", "alice"));
+
+  const otherSender = await first.beforeToolCall(
+    { toolName: "shell" },
+    toolContext("shared", { senderId: "bob" }),
+  );
+  assert.equal(otherSender.block, true);
+  assert.match(otherSender.blockReason, /run_scope_sender_conflict$/);
+
+  const otherRegistration = await second.beforeToolCall(
+    { toolName: "shell" },
+    toolContext("shared"),
+  );
+  assert.equal(otherRegistration.block, true);
+  assert.match(otherRegistration.blockReason, /run_provenance_missing$/);
+});
+
+test("agent_end cleanup removes only the matching shared scope", async () => {
+  const handlers = registration({
+    requireExplicitTrustedSenders: true,
+    trustedSenderIds: ["alice", "bob"],
+  });
+  await handlers.beforeAgentRun({}, agentContext("alice-scope", "alice"));
+  await handlers.beforeAgentRun({}, agentContext("bob-scope", "bob"));
+  await handlers.agentEnd({}, toolContext("alice-scope"));
+
+  const alice = await handlers.beforeToolCall(
+    { toolName: "shell" },
+    toolContext("alice-scope"),
+  );
+  assert.equal(alice.block, true);
+
+  const bob = await handlers.beforeToolCall(
+    { toolName: "shell" },
+    toolContext("bob-scope"),
+  );
+  assert.ok(bob.requireApproval);
+});
+
+test("run provenance expires after the bounded age", async (t) => {
+  const originalNow = Date.now;
+  t.after(() => { Date.now = originalNow; });
+  let now = 1_000_000;
+  Date.now = () => now;
+  const handlers = registration({
+    requireExplicitTrustedSenders: true,
+    trustedSenderIds: ["alice"],
+  });
+  await handlers.beforeAgentRun({}, agentContext("expiring", "alice"));
+  now += 60 * 60 * 1000 + 1;
+  const result = await handlers.beforeToolCall(
+    { toolName: "shell" },
+    toolContext("expiring"),
+  );
+  assert.equal(result.block, true);
+  assert.match(result.blockReason, /run_provenance_missing$/);
+});
+
+test("host-shaped lifecycle keeps distinct sessionId and sessionKey across all hooks", async () => {
+  const handlers = registration({
+    requireExplicitTrustedSenders: true,
+    trustedSenderIds: ["alice"],
+  });
+  const before = agentContext("host-shape", "alice");
+  const tool = toolContext("host-shape");
+  const end = toolContext("host-shape");
+  for (const ctx of [before, tool, end]) {
+    assert.equal(ctx.sessionId, "session-uuid-123");
+    assert.equal(ctx.sessionKey, "agent:main:weixin:direct:user");
+    assert.equal(ctx.runId, "run-host-shape");
+    assert.equal(ctx.agentId, "agent-main");
+  }
+
+  await handlers.beforeAgentRun({}, before);
+  const result = await handlers.beforeToolCall(
+    { toolName: "shell" },
+    tool,
+  );
+  assert.ok(result.requireApproval);
+  assert.equal(result.block, undefined);
+  await handlers.agentEnd({}, end);
+  const cleaned = await handlers.beforeToolCall({ toolName: "shell" }, tool);
+  assert.equal(cleaned.block, true);
+  assert.match(cleaned.blockReason, /run_provenance_missing$/);
+});
+
+test("shared scope collision fails closed without overwriting original sender", async () => {
+  const handlers = registration({
+    requireExplicitTrustedSenders: true,
+    trustedSenderIds: ["alice", "bob"],
+  });
+  assert.deepEqual(
+    await handlers.beforeAgentRun({}, agentContext("collision", "alice")),
+    { outcome: "pass" },
+  );
+  const collision = await handlers.beforeAgentRun(
+    {},
+    agentContext("collision", "bob"),
+  );
+  assert.equal(collision.outcome, "block");
+  assert.equal(collision.reason, "run_scope_sender_conflict");
+  assert.doesNotMatch(collision.message, /alice|bob/);
+
+  const original = await handlers.beforeToolCall(
+    { toolName: "shell" },
+    toolContext("collision"),
+  );
+  assert.ok(original.requireApproval);
+});
+
+test("shared scope normalization is exact and incomplete scope fails closed", async () => {
+  const bothAliases = runKey({}, {
+    runId: " run-1 ",
+    agentId: " agent-1 ",
+    sessionId: " session-uuid-123 ",
+    sessionKey: " agent:main:weixin:direct:user ",
+  });
+  assert.equal(
+    bothAliases,
+    JSON.stringify(["run-1", "agent-1", "session-uuid-123"]),
+  );
+
+  const fallback = runKey(
+    { sessionKey: " agent:main:weixin:direct:user " },
+    {
+      runId: "run-1",
+      agentId: "agent-1",
+      sessionKey: "agent:main:weixin:direct:user",
+    },
+  );
+  assert.equal(
+    fallback,
+    JSON.stringify(["run-1", "agent-1", "agent:main:weixin:direct:user"]),
+  );
+  assert.equal(runKey(
+    { sessionId: "event-session" },
+    {
+      runId: "run-1",
+      agentId: "agent-1",
+      sessionId: "context-session",
+      sessionKey: "agent:main:weixin:direct:user",
+    },
+  ), undefined);
+  assert.equal(runKey({}, {
+    runId: "run-1",
+    agentId: "agent-1",
+    sessionKey: "agent:main:weixin:direct:user",
+    sessionId: "session-uuid-123",
+  }), bothAliases);
+  assert.equal(runKey({}, {
+    runId: "run-1",
+    agentId: "agent-1",
+    sessionKey: "agent:main:weixin:direct:user",
+  }), fallback);
+  assert.equal(runKey({}, {
+    agentId: "agent-1", sessionId: "session-uuid-123",
+  }), undefined);
+
+  const handlers = registration();
+  const missing = await handlers.beforeToolCall(
+    { toolName: "shell" },
+    { agentId: "agent-1", sessionId: "session-uuid-123" },
+  );
+  assert.equal(missing.block, true);
+  assert.match(missing.blockReason, /run_provenance_missing$/);
+});
+
+test("sessionKey fallback requires sessionId absent from both hook contexts", async () => {
+  const handlers = registration({
+    requireExplicitTrustedSenders: true,
+    trustedSenderIds: ["alice"],
+  });
+  const before = {
+    runId: "run-fallback",
+    agentId: "agent-main",
+    sessionKey: "agent:main:weixin:direct:user",
+    senderId: "alice",
+  };
+  const tool = {
+    runId: "run-fallback",
+    agentId: "agent-main",
+    sessionKey: "agent:main:weixin:direct:user",
+  };
+  await handlers.beforeAgentRun({}, before);
+  assert.ok((await handlers.beforeToolCall({ toolName: "shell" }, tool)).requireApproval);
+
+  const mismatchedSelection = await handlers.beforeToolCall(
+    { toolName: "shell" },
+    { ...tool, sessionId: "session-uuid-123" },
+  );
+  assert.equal(mismatchedSelection.block, true);
+  assert.match(mismatchedSelection.blockReason, /run_provenance_missing$/);
+});
+
+test("same-named event and context sessionId mismatch fails closed", async () => {
+  const handlers = registration({
+    requireExplicitTrustedSenders: true,
+    trustedSenderIds: ["alice"],
+  });
+  await handlers.beforeAgentRun({}, agentContext("event-mismatch", "alice"));
+  const result = await handlers.beforeToolCall(
+    { toolName: "shell", sessionId: "different-session" },
+    toolContext("event-mismatch"),
+  );
+  assert.equal(result.block, true);
+  assert.match(result.blockReason, /run_provenance_missing$/);
+});
@@ -1,153 +0,0 @@
-#!/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
@@ -1,69 +0,0 @@
-#!/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
@@ -1,15 +0,0 @@
-{
-  "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
-  }
-}
@@ -1,9 +0,0 @@
-{
-  "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,10 +0,0 @@
-{
-  "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"
-}
@@ -1,9 +0,0 @@
-{
-  "type": "branch",
-  "branch": "patch/aios-agent-task-control-plane-20260724",
-  "base": "main",
-  "created_by": "agent-task-plane-writer",
-  "created_at": "2026-07-24T02:20:56Z",
-  "direct_main_push": false,
-  "owner_approval_required": true
-}
@@ -1,9 +0,0 @@
-{
-  "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/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
-}
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
openclaw	5f43ac26dc	test(openclaw): make tenant-boundary hook compatibility executable	2026-07-14 05:29:29 +08:00
openclaw	14b03fc893	docs(v2r1): isolate gateway receipt journals	2026-07-14 04:45:31 +08:00
openclaw	04100a1aae	docs(v2r1): finalize executable release contracts	2026-07-14 04:36:13 +08:00
openclaw	e13f601cff	docs(v2r1): make blocker gates executable	2026-07-14 04:18:06 +08:00
openclaw	1e7d1969cd	docs(v2r1): close runtime bridge review gaps	2026-07-14 04:02:35 +08:00
openclaw	d2a3814a2f	docs(v2r1): define authenticated runtime release design	2026-07-14 03:16:08 +08:00
openclaw	c444622279	integrate(v2r1): replay verified runtime tree	2026-07-14 03:02:17 +08:00