Allow reconciler to close superseded PRs/issues without switching to author #525

New Issue

2026-07-08T03:42:14-05:00

jcwalker3 commented

2026-07-08 03:42:14 -05:00

Problem:
During reconciliation of PR #490 and issue #470, the session started as prgs-reconciler but had to switch to prgs-author to close the superseded PR/issue and file the follow-up issue. This is a role-boundary problem: supersede/close decisions after a landed duplicate are controller/reconciler work, not author work.

Observed:

PR #512 was verified merged.
PR #490 was closed as superseded by merged PR #502.
Issue #470 was closed as superseded/satisfied by PR #502.
Issue #524 was created.
These mutations required switching from prgs-reconciler to prgs-author.

Required behavior:

Reconciler profile should have an explicit, gated tool path for closing superseded PRs.
Reconciler profile should have an explicit, gated tool path for closing issues as superseded/satisfied by landed PRs.
Reconciler profile should be able to file narrow follow-up issues when reconciliation discovers leftover scope.
These operations must require live-state proof and canonical comments.
Author profile should not be required for post-merge/supersession reconciliation.

Acceptance criteria:

Add or update reconciler-capable tools for close-superseded PR and close-satisfied issue.
Require proof that the superseding PR is merged and on master.
Require a canonical close comment citing the superseding PR and merge commit.
Fail closed if the target PR is still independently required or mergeable work remains.
Add tests proving reconciler can close superseded PRs/issues without switching to author.
Add tests proving author/reviewer/merger cannot bypass the reconciler gate for supersession decisions.
Update runbook guidance for duplicate PR and superseded issue reconciliation.

Problem: During reconciliation of PR #490 and issue #470, the session started as prgs-reconciler but had to switch to prgs-author to close the superseded PR/issue and file the follow-up issue. This is a role-boundary problem: supersede/close decisions after a landed duplicate are controller/reconciler work, not author work. Observed: - PR #512 was verified merged. - PR #490 was closed as superseded by merged PR #502. - Issue #470 was closed as superseded/satisfied by PR #502. - Issue #524 was created. - These mutations required switching from prgs-reconciler to prgs-author. Required behavior: - Reconciler profile should have an explicit, gated tool path for closing superseded PRs. - Reconciler profile should have an explicit, gated tool path for closing issues as superseded/satisfied by landed PRs. - Reconciler profile should be able to file narrow follow-up issues when reconciliation discovers leftover scope. - These operations must require live-state proof and canonical comments. - Author profile should not be required for post-merge/supersession reconciliation. Acceptance criteria: 1. Add or update reconciler-capable tools for close-superseded PR and close-satisfied issue. 2. Require proof that the superseding PR is merged and on master. 3. Require a canonical close comment citing the superseding PR and merge commit. 4. Fail closed if the target PR is still independently required or mergeable work remains. 5. Add tests proving reconciler can close superseded PRs/issues without switching to author. 6. Add tests proving author/reviewer/merger cannot bypass the reconciler gate for supersession decisions. 7. Update runbook guidance for duplicate PR and superseded issue reconciliation.

jcwalker3 added the status:in-progress label 2026-07-09 09:57:29 -05:00

jcwalker3 commented

2026-07-09 09:57:30 -05:00

Issue claim heartbeat

kind: claim
issue: Allow reconciler to close superseded PRs/issues without switching to author (#525)
branch: feat/issue-525-reconciler-supersession-close
phase: claimed
profile: prgs-author
pr: none
blocker: none
next_action: create worktree and begin implementation

**Issue claim heartbeat** - kind: claim - issue: #525 - branch: feat/issue-525-reconciler-supersession-close - phase: claimed - profile: prgs-author - pr: none - blocker: none - next_action: create worktree and begin implementation

jcwalker3 referenced a pull request that will close this issue

2026-07-09 11:41:03 -05:00

feat: reconciler supersession close path for PRs/issues (Closes #525) #583

jcwalker3 added status:pr-open and removed status:in-progress labels 2026-07-09 11:41:04 -05:00

sysadmin referenced this issue

2026-07-09 11:47:21 -05:00

feat: reconciler supersession close path for PRs/issues (Closes #525) #583

sysadmin referenced this issue

2026-07-09 11:48:39 -05:00

feat: reconciler supersession close path for PRs/issues (Closes #525) #583

sysadmin referenced this issue

2026-07-09 11:57:07 -05:00