From a5f6dba1e699fac3894da93c1109618f6b28c7d9 Mon Sep 17 00:00:00 2001 From: AIOS Governed Continuation Date: Mon, 10 Aug 2026 23:56:10 +0800 Subject: [PATCH] docs(v2r2c1): record governed document refresh acceptance --- .../V2R2C1-pre-push-review-acceptance.md | 205 ++++++++++++++++++ 1 file changed, 205 insertions(+) create mode 100644 docs/acceptance/V2R2C1-pre-push-review-acceptance.md diff --git a/docs/acceptance/V2R2C1-pre-push-review-acceptance.md b/docs/acceptance/V2R2C1-pre-push-review-acceptance.md new file mode 100644 index 0000000..165efca --- /dev/null +++ b/docs/acceptance/V2R2C1-pre-push-review-acceptance.md @@ -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? \ No newline at end of file