docs(v2r2c1): record governed document refresh acceptance

2026-08-10 23:56:10 +08:00
parent ce88505a9e
commit a5f6dba1e6
1 changed files with 205 additions and 0 deletions
@@ -0,0 +1,205 @@
+# AIOS V2R2C1 Pre-Push Review Acceptance Record????????
+
+## 1. ????
+
+### Mechanism audit object
+
+- Repository?aios/aios
+- Audit base?b660e2cc324749391323b1f7bebc865f324161f7
+- Mechanism branch?patch/v2r2c1-release-registry-convergence-20260810
+- Latest mechanism HEAD?52b74ba61040246fffa8b10011c1199830e3d665
+- Follow-up commits?
+  - 51b5f0e53e69bd9f5c4077c7f399ede17571c368
+  - 52b74ba61040246fffa8b10011c1199830e3d665
+- Audited delta?17 files changed, 1403 insertions(+), 79 deletions(-)
+- Ancestor check?b660e2c ? mechanism latest ? ancestor
+
+### Documentation candidate
+
+- Target branch?agent/docs/v2r2c1-provenance-mainline-refresh-20260810
+- Branch base?52b74ba61040246fffa8b10011c1199830e3d665
+- Branch mode?CREATE_NEW????? CONTINUE_EXISTING generations
+- Task?AIOS-V2R2C1-DOC-REFRESH-20260810
+- Initial durable job?job-bce7cfde812976059a98f5ebd0296c50
+- Writer lease?aios.task-writer-lease.v2?detached worktree?CAS enabled
+
+???? Owner-review candidate??? main?tag?Baseline ? production release?
+
+## 2. Live runtime ???????
+
+### getRuntimeStatus
+
+V2 governed Action writer?
+
+- service?aios-chatgpt-bridge-v2-staging.service?
+- state?active?
+- listener?127.0.0.1:18892?
+- bridge schema?aios.chatgpt-gitops-bridge.v2?
+- repository?aios/aios?
+- authoritative_git_dir?/data/aios-gitops/repo.git?
+- legacy_global_writes_enabled?false?
+
+V2 capabilities?
+
+- governed_writes_enabled?true?
+- legacy_writes_enabled?false?
+- main_write?false?
+- production_write?false?
+- baseline_write?false?
+- tag_write?false?
+- force_push?false?
+- supported document operations?createGovernedTask?acquireWriterLease?commitFileGoverned?getGitOpsJob?reconcileGitOpsJob?
+
+?? aios-gitops-action-writer.service ???? branch/base ?????? inactive?19891 ???????????????????? enforcement?? token???? API ? direct Git ?? V2 writer?
+
+### getBaseline
+
+?? /api/base ???
+
+| ?? | ? |
+|---|---|
+| version | V2R2C1 |
+| generation | 4 |
+| authoritative main | 3244f0f17f8845592ac94d585f5ebd65693c9f29 |
+| status | PRODUCTION_DEPLOYED |
+| deployment_state | ACTIVE |
+| production_deployed | true |
+| tag_oid | 07fc2746b688f5f243f29b39de39f32edc3dd9d2 |
+| target / peeled target | 998d30304787e31e5ae607c0bd86b5edb2b0e5ad |
+| evidence_closure_oid | a8b906d1bc24088c19647e98de6a679268f6d0a2 |
+| approval_plan_id | sha256:c0df52008ae7f64cec5ee2d28947aa7b892066c670ab8295e4549140b1a7500e |
+| legacy_global_writes_enabled | false |
+
+Baseline authority SHA-256 ? d8e23bad49bdb3e4192ba708c3dfe7fc5b7cdc6a513c2f87acd6412a51867231??????????????
+
+## 3. createBranch / createPatch / commit ??
+
+V2 API ?????? legacy global /api/patch write????????????
+
+1. createGovernedTask??? task?repository?base_oid?target_branch?risk?description ? idempotency key?
+2. acquireWriterLease?CREATE_NEW ?? detached worktree ?? main branch CAS?
+3. read authoritative branch HEAD?
+4. CONTINUE_EXISTING lease ?? generation?
+5. ??? /v2/commit-file?
+6. durable job reconcile?
+7. authority ref?Gitea network ref?Gitea API branch ref ?? readback?
+
+?? createGovernedTask ?? HTTP 200?
+
+- base_oid = 52b74ba61040246fffa8b10011c1199830e3d665?
+- expected_branch_oid = base_oid?
+- target_branch = agent/docs/v2r2c1-provenance-mainline-refresh-20260810?
+- create_target_branch = true?
+- worktree_mode = detached_at_base_oid?
+
+?? acquireWriterLease ?? HTTP 200?
+
+- branch_mode = CREATE_NEW?
+- cas_ref_update_required = true?
+- generation = 1?
+- target branch ?????
+
+## 4. ?????????????
+
+??????? read HEAD ? new generation lease ? single-file commit ? job wait/reconcile ? readback?
+
+| ?? | job | authority / Gitea API / remote OID | ?? |
+|---|---|---|---|
+| README.md | job-d469cf515cab106843f74356f30e782d | 35ae3d57161c5eabcf281739381c54b6bece61e5 | COMPLETED / remote_verified |
+| docs/requirements/V2R2C1-pre-push-review-fix.md | job-9e1e4f4b861c2e041547a2ffa3b34542 | d7aa3a5e011588c138930fa97d45e2b281560f08 | COMPLETED / remote_verified |
+| docs/architecture/release-provenance-and-registry-convergence.md | job-b2b7d20a21ff6ed45eda5c8da66e2b17 | 6b7b4c8b8d94c3ad700736dae1c138e29f292713 | COMPLETED / remote_verified |
+| docs/version-differences/V2R2C1-pre-push-mechanism-diff.md | job-2df052f1eb0238a5da0e0d0f5787c635 | ce88505a9e11331db5373f43e2d44df29002ef34 | COMPLETED / remote_verified |
+
+?? durable receipt ????
+
+- authority_oid = api_branch_oid = git_remote_oid?
+- commit_visible = true?
+- remote_verified = true?
+- force_push = false?
+
+README ?????? REMOTE_PUSH_PENDING / RECONCILIATION_REQUIRED ????????? job revision 7 ????? reconcile??? revision 10?COMPLETED?remote_verified=true?? 202 ??????????
+
+??????????????? commit???? OID ??????? durable receipt?authoritative ref ? Gitea API readback ???????????? self-referential OID?
+
+## 5. ?? mechanism ????
+
+### Git checks
+
+- b660e2c ? 52b74ba git diff --check?PASS?
+- 17 ??????? py_compile?PASS?
+- targeted mechanism tests?63 passed?
+- full test suite?760 passed?2 skipped?1 failed?154 subtests passed?
+
+### External signer gate
+
+????
+
+~~~text
+tests/test_signer_contract_compatibility.py::SignerContractCompatibilityTests::test_real_signer_help_and_self_test_are_available
+/usr/local/libexec/aios-grant-signer-adapter self-test returned 42
+~~~
+
+?????? self-test ??? 42?????? external signer gate?????????????????????????
+
+### Mechanism acceptance matrix
+
+| ?? | ?? | ?? |
+|---|---|---|
+| ?? M ??? source blob | source_registry_snapshot | PASS |
+| M/C ancestor ? bytes convergence | verify_source_registry_main_convergence | PASS by code/tests |
+| authoritative repository path/identity | verify_authoritative_repository | PASS by code/tests |
+| canonical approval authority | verify_approval_authority | PASS by code/tests |
+| release binding / artifact mode | ArtifactBuilder + CLI | PASS by code/tests |
+| executor independent Git re-read | approved_release_executor | PASS by code/tests |
+| runtime-only ??? source Git | v2r2c1_production_adapter | PASS by code/tests |
+| projection-only ??? convergence | list_registry_versions_report | PASS by code/tests |
+| post-runtime main advance fail closed | test_v2r2c1_pre_push_review | PASS by test |
+| full external gate | signer contract compatibility | PARTIAL |
+
+## 6. ???????
+
+?????????
+
+- ? main ?? branch?
+- README ???
+- requirements?
+- architecture?
+- acceptance?
+- version differences?
+- authoritative / Gitea readback?
+- Owner-review candidate?
+
+????????
+
+- direct main push?
+- main merge?
+- Production Baseline update?
+- versions/V2R2C1.json ???
+- tag create/delete/rewrite?
+- force push?
+- production runtime mutation?
+- systemd/nginx production reload/restart?
+- production release?
+- rollback?
+- secret commit?
+
+?????
+
+~~~text
+force_push_used: false
+tag_rewritten: false
+direct_main_push: false
+secrets_committed: false
+production_mutation: false
+legacy_global_writes_enabled: false
+~~~
+
+## 7. ????
+
+?? mechanism code review?COMPLETE?
+
+???????? Owner review???????????? durable commit?authoritative branch OID?Gitea API branch OID ? remote readback ??????
+
+Full external gate?PARTIAL???? signer self-test ?? 42?
+
+Merge??? release?tag?Baseline ? production action?NOT RUN?