[EPIC] Test Coverage Implementation Programme

[ashleyshaw]

Epic Summary

The repository needs a governed coverage-expansion programme to raise test coverage to 80%+ before release. This parent issue tracks the six delivery phases that together cover the full 62-task plan in .github/projects/active/test-coverage-implementation/README.md.

Linked Stories/Tasks

• openspec-strict/children/01-phase-1-baseline-measurement.md
• openspec-strict/children/02-phase-2-metrics-agent-tests.md
• openspec-strict/children/03-phase-3-linting-agent-tests.md
• openspec-strict/children/04-phase-4-release-agent-enhancement.md
• openspec-strict/children/05-phase-5-utility-edge-cases.md
• openspec-strict/children/06-phase-6-validation-and-reporting.md

Live Issues

• Phase 1: #933
• Phase 2: #934
• Phase 3: #935
• Phase 4: #936
• Phase 5: #937
• Phase 6: #938

Milestones & Timeline

• Phase 1: establish the baseline and implementation checklist.
• Phase 2: add metrics-agent coverage.
• Phase 3: add linting-agent coverage.
• Phase 4: harden the release agent path.
• Phase 5: cover utility edge cases.
• Phase 6: validate, report, and close out the programme.

Acceptance Criteria

• All six phase issues are created and linked.
• The baseline coverage report is captured and documented.
• Coverage work reaches the 80%+ target or records the remaining gap explicitly.
• Validation artefacts and final reporting are complete.
• Documentation and PR/issue checklists are fully ticked off before closeout.

Dependencies / Blockers

• Stable test environment and coverage tooling.
• Accurate baseline data from the current repository state.
• Correct GitHub issue templates and labels for each phase.

Additional Context

The phase breakdown in the source README is the source of truth for all topic coverage. This epic keeps the work in one governed chain rather than allowing ad hoc issue creation.

---

Definition of Ready (DoR)

• Epic goal and scope defined
• Linked stories/tasks listed
• Milestones and timeline mapped
• Dependencies/blockers identified
• Estimate added (if applicable)
• Stakeholders/approvers listed

Definition of Done (DoD)

• All linked stories/tasks completed and closed
• Documentation/changelog updated
• QA and testing complete
• Milestone closed and release notes prepared

[linear-code]

LS-995

LS-1111

[github-actions]

✅ Issue checklists finalised after closure.