fix(w6d): bridge Iskra approval to Forgejo review #475

Merged
Iskra merged 1 commit from codex/w6d-automerge-review-bridge into main 2026-05-25 09:11:06 +02:00
Collaborator

Canary status: missing — rely on required Forgejo checks before merge

Canary Context Pack

Product story

W6d should let Iskra merge narrow, deterministic, docs/status-style PRs without Piotr doing the final click. The test run proved the merge token works, but only after a manual formal Forgejo review by Iskra.

What changed

  • The merge actor now creates a formal Forgejo APPROVED review as the merge actor after Matrix approval and deterministic readiness, immediately before merge.
  • Readiness ignores stale/dismissed approvals.
  • Readiness blocks PRs whose merge_base is behind base.sha, matching branch protection's out-of-date blocker.

Why it changed

The #470 smoke proved Matrix approval alone is not enough for Forgejo branch protection. Forgejo requires a current formal PR review, and stale reviews after branch updates must not be counted.

Files touched

  • control-plane/platformctl/ci/automerge_actor.py
  • control-plane/platformctl/ci/automerge_readiness.py
  • control-plane/platformctl/tests/test_automerge_actor.py
  • control-plane/platformctl/tests/test_automerge_readiness.py

Relevant context

W6d autonomous merge pilot; branch protection requires one current approval, required statuses, and non-outdated branch.

Runtime evidence

#470 was merged by Iskra after a fresh formal Iskra approval and successful automerge run #2723. This PR codifies that manual bridge.

Known constraints

The pilot remains narrow: docs/status/runbook/roadmap-only; no runtime, secret, workflow, module, schema, decision, script, or test PR is eligible for autonomous merge v0.

Explicit out-of-scope

This does not implement automatic branch update/rebase. Outdated PRs are blocked and must be updated before another automerge attempt.

Requested decision

Approve merge if tests and required checks are green.

Merge blockers

  • Failing tests or required Forgejo checks.
  • Any concern that the approval review should be created at a different point in the workflow.

Spec sources read

  • control-plane/platformctl/ci/automerge_actor.py — merge actor implementation.
  • control-plane/platformctl/ci/automerge_readiness.py — deterministic readiness gates.
  • control-plane/platformctl/tests/test_automerge_actor.py — actor coverage.
  • control-plane/platformctl/tests/test_automerge_readiness.py — readiness coverage.
  • .forgejo/workflows/automerge-pilot.yml — workflow call order.

Test plan

  • git diff --check
  • PYTHONPATH=control-plane pytest -q control-plane/platformctl/tests/test_forgejo_ci_scripts_contract.py control-plane/platformctl/tests/test_automerge_actor.py control-plane/platformctl/tests/test_automerge_readiness.py → 57 passed
Canary status: missing — rely on required Forgejo checks before merge ## Canary Context Pack ### Product story W6d should let Iskra merge narrow, deterministic, docs/status-style PRs without Piotr doing the final click. The test run proved the merge token works, but only after a manual formal Forgejo review by Iskra. ### What changed - The merge actor now creates a formal Forgejo `APPROVED` review as the merge actor after Matrix approval and deterministic readiness, immediately before merge. - Readiness ignores stale/dismissed approvals. - Readiness blocks PRs whose `merge_base` is behind `base.sha`, matching branch protection's out-of-date blocker. ### Why it changed The #470 smoke proved Matrix approval alone is not enough for Forgejo branch protection. Forgejo requires a current formal PR review, and stale reviews after branch updates must not be counted. ### Files touched - `control-plane/platformctl/ci/automerge_actor.py` - `control-plane/platformctl/ci/automerge_readiness.py` - `control-plane/platformctl/tests/test_automerge_actor.py` - `control-plane/platformctl/tests/test_automerge_readiness.py` ### Relevant context W6d autonomous merge pilot; branch protection requires one current approval, required statuses, and non-outdated branch. ### Runtime evidence #470 was merged by `Iskra` after a fresh formal Iskra approval and successful automerge run #2723. This PR codifies that manual bridge. ### Known constraints The pilot remains narrow: docs/status/runbook/roadmap-only; no runtime, secret, workflow, module, schema, decision, script, or test PR is eligible for autonomous merge v0. ### Explicit out-of-scope This does not implement automatic branch update/rebase. Outdated PRs are blocked and must be updated before another automerge attempt. ### Requested decision Approve merge if tests and required checks are green. ### Merge blockers - Failing tests or required Forgejo checks. - Any concern that the approval review should be created at a different point in the workflow. ## Spec sources read - `control-plane/platformctl/ci/automerge_actor.py` — merge actor implementation. - `control-plane/platformctl/ci/automerge_readiness.py` — deterministic readiness gates. - `control-plane/platformctl/tests/test_automerge_actor.py` — actor coverage. - `control-plane/platformctl/tests/test_automerge_readiness.py` — readiness coverage. - `.forgejo/workflows/automerge-pilot.yml` — workflow call order. ## Test plan - `git diff --check` - `PYTHONPATH=control-plane pytest -q control-plane/platformctl/tests/test_forgejo_ci_scripts_contract.py control-plane/platformctl/tests/test_automerge_actor.py control-plane/platformctl/tests/test_automerge_readiness.py` → 57 passed
fix(w6d): bridge Iskra approval to Forgejo review
All checks were successful
platformctl plan / auto-apply scope (pull_request) Successful in 22s
python-ci / Python 3.11 (pull_request) Successful in 43s
python-ci / Python 3.12 (pull_request) Successful in 43s
workflow-lint / lint (pull_request) Successful in 5s
canary-required / canary (pull_request) Successful in 14s
base-is-main / guard (pull_request) Successful in 1s
canary-required / collect-diff (pull_request) Successful in 5s
infra-docs-drift / docs-drift (pull_request) Successful in 5s
patchwarden-pr-sanity / collect-diff (pull_request) Successful in 4s
pyfallow / Pyfallow gate (control-plane) (pull_request) Successful in 21s
python-ci / Python 3.13 (pull_request) Successful in 43s
patchwarden-pr-sanity / sanity (pull_request) Successful in 23s
03313e3e8b
pdurlej approved these changes 2026-05-25 09:09:45 +02:00
Iskra merged commit 25e4e45e32 into main 2026-05-25 09:11:06 +02:00
Iskra referenced this pull request from a commit 2026-05-25 09:11:08 +02:00
Sign in to join this conversation.
No reviewers
No labels
W6d-automerge-calibration
agent/claude-code
agent/codex
agent/hermes
agent/iskra
agent/ollama
agent/patchwarden
automerge-candidate
class/security-sensitive
cutover-gate
dependency/blocked
dependency/blocks-others
dependency/cross-repo
dependency/needs-confirmation
domain:agents
domain:ci
domain:docs
domain:forgejo
domain:infra
domain:memory
domain:runtime
domain:signal
domain:ux
flow/architecture
flow/blocked
flow/deployed
flow/done
flow/implementation
flow/intake
flow/maintained
flow/observed
flow/ready
flow/refining
flow/retired
flow/review
iterating
judge/codex-candidate
judge/hermes-candidate
judge/low-confidence
judge/needs-refinement
judge/operator-needed
judge/p0
judge/p1
judge/p2
judge/p3
judge/park
judge/patchwarden-candidate
judge/stale-priority
kind/adr
kind/bug
kind/chore
kind/feature
kind/infra
kind/ops
kind/refactor
kind/research
large-impact
merge/auto
merge/manual
merge/manual-dependency-conflict
merge/manual-failing-tests
merge/manual-merge-conflict
merge/manual-missing-review
merge/manual-operator-preference
merge/manual-red-zone
merge/manual-security-sensitive
merge/manual-unclear-scope
merge/manual-unknown
meta
mode:operator-only
mode:patchwarden-iskra-approved
mode:safe-auto
needs-operator-decision
needs-triage
not-ready
observed/erroring
observed/needs-followup
observed/pending
observed/retire-candidate
observed/unused
observed/used
operator-emotional
owner-attention
phase/02
phase/03
priority:p0
priority:p1
priority:p2
priority:p3
proposed
ready-for-agent
ready-for-operator
recovery
review:claude-reviewed
review:codex-reviewed
review:dziadek-reviewed
review:needs-human
risk/exposure
risk/process
risk/product
risk/runtime
safety:external-write
safety:no-prod-mutation
safety:prod-impact
safety:secret-touch
size/large
size/medium
size/small
size/tiny
size/unknown
source/adr
source/agent-generated
source/manual
source/operator-chat
source/voice-note
status:blocked
status:codex-ready
status:merged:pending-evidence
status:needs-evidence
status:operator-needed
status:parked
tier/full
tier/lite
tier/stacked
tier:0-platform-substrate
tier:1-iskra-value-layer
tier:2-tools-products-modules
type:bug
type:chore
type:docs
type:feat
type:policy
type:research
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
pdurlej/platform!475
No description provided.