Skip to content

docs(epic): regenerate the epic-status projection at epic completion - #567

Merged
drmoisan merged 1 commit into
mainfrom
docs/epic-status-build-ci-coverage-gate-fidelity
Aug 15, 2026
Merged

docs(epic): regenerate the epic-status projection at epic completion#567
drmoisan merged 1 commit into
mainfrom
docs/epic-status-build-ci-coverage-gate-fidelity

Conversation

@drmoisan

Copy link
Copy Markdown
Owner

docs(epic): regenerate the epic-status projection at epic completion

Documentation only. One file changes: docs/features/epics/build-ci-coverage-gate-fidelity/epic-status.md.

Summary

Why

epic-status.md is a generated projection of the epic checkpoint, regenerated at each lifecycle boundary including final integration-PR completion. The prior revision was written before the integration PR existed, so its Integration PR table was empty and its Issues section described all nine issues as pending closure. Both are now resolved and the projection was stale.

What Changed

Section Change
Header Status is now COMPLETE; integration branch marked merged and retired; Last updated synchronized with content
Features 494 advanced to worktree_removed; merge_confirmed_at values corrected to the authoritative gh mergedAt timestamps; PR #543 disclosed for feature 457
Integration PR Populated with PR #566, head 3e61c67e, the five required check results, merge commit 8bd23551, and merge time
Fan-In Review New — two independent feature-review passes, both zero Blocking, plus the epic-review AC result
Known Gaps New — #561 through #565, and the resulting partial discharge of leading indicator 2
Checkpoint Completion Status New — records that require_complete cannot pass and why
Intermittent test Fifth sample added: the final integration run passed
Issues Rewritten from "pending closure" to the closed record with per-issue timestamps
Retained Branches New — disposition of the two local-only unmerged branches

Verification

Completed — the facts recorded in this document were verified against git and gh before it was written: gh pr view 566, gh pr checks 566, gh run view 31867645467, and gh issue view for each of the nine issues. The epic checkpoint passes plain validate_orchestration_artifacts validation.

Recommended — none. This change adds no executable code and no test. CI runs on it because its base is main.

Backward Compatibility / Migration Notes

None. epic-status.md is a generated projection consumed by humans; nothing reads it programmatically. epic.md, the human-authored manifest, is untouched.

Risks and Mitigations

Risk Mitigation
The projection disagrees with the checkpoint The checkpoint remains machine-authoritative, and git / gh remain authoritative over both per the cache doctrine. Every figure here was read from gh rather than copied from the checkpoint.

Rollback: revert the commit. No behavior depends on this file.

Review Guide

Single file, single commit. The two sections worth attention are Known Gaps Merged With This Epic, which states that the coverage-threshold contradiction the epic set out to remove still exists, and Checkpoint Completion Status, which records the unsatisfiable require_complete gate rather than working around it.

Follow-ups

GitHub Auto-close

None.

Records the terminal state of the build-ci-coverage-gate-fidelity epic:
integration PR #566 merged to main as 8bd2355 with all five required
checks green on the first run, and all nine issues auto-closed as COMPLETED
at merge.

Corrections to the prior projection, both raised by the epic audit:

- Feature 457's row now discloses PR #543, a second merged pull request from
  the same head branch. It is a chore(memory) commit in the same class as
  #534, #539, and #541, not a second delivery PR; #542 remains the recorded
  delivery PR.
- The "Last updated" marker previously predated data inside its own table.

Adds the fan-in review results (two independent feature-review passes, both
zero Blocking), the five known gaps merged with the epic (#561-#565), the
partial discharge of leading indicator 2 caused by #563, and an explicit
record that the checkpoint cannot satisfy require_complete because the
per-feature launch bindings were never produced by the original run.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@drmoisan
drmoisan merged commit 5bc4a43 into main Aug 15, 2026
5 checks passed
@drmoisan
drmoisan deleted the docs/epic-status-build-ci-coverage-gate-fidelity branch August 15, 2026 05:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant