Skip to content

docs(qual): reconcile coverage closure plan - #260

Merged
abiorh-claw merged 5 commits into
mainfrom
codex/ws-qual-001-current-audit
Aug 4, 2026
Merged

docs(qual): reconcile coverage closure plan#260
abiorh-claw merged 5 commits into
mainfrom
codex/ws-qual-001-current-audit

Conversation

@Abiorh001

@Abiorh001 Abiorh001 commented Aug 3, 2026

Copy link
Copy Markdown
Collaborator

Chunk

WS-QUAL-001-PLAN2 — current-main coverage reconciliation.

Goal

Replace the obsolete 78→82→84→86→88→90 milestone ladder with the smallest owner-scoped path from the current hosted 88.575080% baseline to a blocking global 90% floor.

Current evidence

Backend run 30854931616 on exact tested tree 19d48f7ea4bf20cb29f03cbba54f98683ce52661, later merged through ART PR #249, recorded:

  • 2,925 completed tests
  • 20,793 / 23,475 covered statements
  • 88.575080% global coverage
  • 640.284 seconds hosted wall time
  • 468.506 seconds slowest semantic lane

Exact ceiling math:

  • 89.55% requires 21,022 covered statements: +229
  • 90% requires 21,128 covered statements: +335
  • 90.25% requires 21,187 covered statements: +394

Design

  • 02R: PROJECT/setup behavior tests in backend/tests/test_projects.py, targeting >=89.55%.
  • optional 03R: CHECKER behavior tests in backend/tests/test_checkers.py, targeting >=90.25%.
  • 04R: separate CI-only change from global --fail-under=78 to --fail-under=90, permitted only after exact hosted >=90.25% proof.
  • If those owner-scoped chunks are insufficient, stop and plan one exact owner-specific successor. There is no mixed residual percentage bucket.

Scope and non-goals

Planning records only. No application, tests, workflow, dependency, coverage threshold, AUTH, ART, REV, CON, or external contributor changes originate in PLAN2. Service decomposition, type checking, mutation/property testing, and CI lane optimization remain separate initiatives.

Historical cleanup

PRs #103, #105, and #108 remain durable. Unimplemented 01B2 and the old 02-06 milestone contracts are explicitly historical and cannot authorize work.

Verification

  • stale Workstream wording
  • stale authorization documentation
  • stale artifact contracts
  • Markdown links
  • lightweight Agent Gates
  • exact Decimal coverage arithmetic
  • git diff --check

All pass locally on the reconciled head.

Review results

Architecture, senior engineering, QA, product/operations, CI integrity, and docs reviews pass after repairing placeholder contracts, mixed ownership, runtime controls, historical classification, authorization vocabulary, and exact coverage math.

External review

The first Agent Gates failure was caused by ambiguous actor-role vocabulary in two planning lines; repaired without changing any scanner or CI rule. CodeRabbit posted no actionable finding because its review request was temporarily rate-limited; a new review has been requested on the repaired head.

Human review focus

Confirm the plan is simple, behavior-led, owner-scoped, and does not reward artificial coverage tests or revive old parser/ratchet complexity.

Merge ownership

Planning only. Explicit human approval and passing GitHub checks are required. No implementation chunk starts automatically after merge.

@coderabbitai

coderabbitai Bot commented Aug 3, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@Abiorh001, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 29 minutes

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 0c74b558-f3ab-4e6a-b0e2-79eb8f495db9

📥 Commits

Reviewing files that changed from the base of the PR and between 50f498f and ffe3624.

📒 Files selected for processing (9)
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/DISCOVERY.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/INTENT.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/PLAN.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/STATUS.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/chunks/WS-QUAL-001-01B2-baseline-evidence-ci-ratchet.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/chunks/WS-QUAL-001-04R-global-90-floor.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/chunks/WS-QUAL-001-PLAN2-current-main-reconciliation.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/reviews/WS-QUAL-001-PLAN2-external-review-response.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/reviews/WS-QUAL-001-PLAN2-review-and-trust-bundle.md
📝 Walkthrough

Walkthrough

The PR reconciles WS-QUAL-001 with current hosted coverage evidence. It replaces historical milestone planning with PLAN2, adds bounded behavioral test and CI-floor contracts, marks superseded records as historical, and documents review evidence and approval gates.

Changes

Backend coverage-floor planning

Layer / File(s) Summary
Current baseline and governance
.agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/{DECISIONS,DISCOVERY,INTENT,RISKS,STATUS}.md
The records now use the hosted 88.95% baseline, define the 90% target, document scope and risks, and state that implementation is not active.
Closure plan and active contracts
.agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/PLAN.md, chunks/WS-QUAL-001-{PLAN2-current-main-reconciliation,02R-project-setup-behavior-coverage,03R-checker-behavior-coverage,04R-global-90-floor}.md
PLAN2 defines bounded test work followed by a separate 90% CI floor change. The contracts define proof thresholds, allowed scope, verification, and stop conditions.
Historical records and chunk navigation
.agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/CHUNK_MAP.md, chunks/README.md, chunks/WS-QUAL-001-*.md
The chunk map identifies current records and superseded work. Historical contracts now cannot authorize implementation.
Review and trust evidence
.agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/reviews/*
The new records capture hosted evidence, review outcomes, validation commands, external wording repairs, and required approval gates.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

Suggested reviewers: abiorh-claw

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description explains the plan and evidence, but it omits many required template sections, including test delta, acceptance proof, gate integrity, and reviewer tables. Complete the required template sections and preserve the documented plan, evidence, reviewer results, risks, follow-up work, and merge ownership details.
✅ Passed checks (4 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title clearly identifies the documentation change to the coverage closure plan.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/ws-qual-001-current-audit

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@Abiorh001

Copy link
Copy Markdown
Collaborator Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Aug 4, 2026

Copy link
Copy Markdown
✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 5

🧹 Nitpick comments (1)
.agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/chunks/WS-QUAL-001-PLAN2-current-main-reconciliation.md (1)

31-35: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Enforce the allowed-file boundary.

The contract forbids application, test, workflow, CI, dependency, and coverage files. The listed commands only check wording, links, and whitespace. Add an automated PR-diff path check that fails when any file outside .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/** changes. git diff --check does not enforce scope.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In
@.agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/chunks/WS-QUAL-001-PLAN2-current-main-reconciliation.md
around lines 31 - 35, Add an automated verification command alongside the
existing checks that inspects the PR diff and fails if any changed file is
outside .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/**. Ensure
the path check enforces the allowed-file boundary independently of git diff
--check, wording validation, and link validation.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In
@.agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/chunks/WS-QUAL-001-01B2-baseline-evidence-ci-ratchet.md:
- Around line 1-5: Update the Status field in the historical contract document
to a machine-readable historical/non-executable value, replacing the
future-activation status while preserving the existing superseded and
do-not-implement declaration.

In
@.agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/chunks/WS-QUAL-001-04R-global-90-floor.md:
- Around line 19-24: Update the hosted evidence recording flow to verify the
exact head coverage from generated .ci/test-lanes/coverage.json, recording the
90.25% result in hosted-evidence.json or failing when covered_lines * 100 /
num_statements is below 90.25; preserve the existing global 90% and
protected-check validations.

In @.agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/PLAN.md:
- Around line 5-6: Update the approach section of the plan to explicitly state
that an additional owner-specific test chunk is permitted only when 02R and 03R
are insufficient, resolving the contradiction with the two-chunk limit while
preserving the one floor switch.

In
@.agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/reviews/WS-QUAL-001-PLAN2-external-review-response.md:
- Around line 10-14: Update both
.agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/reviews/WS-QUAL-001-PLAN2-external-review-response.md
lines 10-14 and
.agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/reviews/WS-QUAL-001-PLAN2-review-and-trust-bundle.md
lines 61-66 to record the CodeRabbit review as unavailable or pending rather
than claiming no actionable findings, and retain the requirement for a fresh
exact-head review unless explicitly waived.

In
@.agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/reviews/WS-QUAL-001-PLAN2-review-and-trust-bundle.md:
- Around line 43-48: Update the “Deterministic evidence” list in the
review-and-trust bundle to include check_stale_authorization_docs.py and
check_stale_artifact_contracts.py, matching
WS-QUAL-001-PLAN2-external-review-response.md, or explicitly label the current
commands as a subset of the rerun evidence.

---

Nitpick comments:
In
@.agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/chunks/WS-QUAL-001-PLAN2-current-main-reconciliation.md:
- Around line 31-35: Add an automated verification command alongside the
existing checks that inspects the PR diff and fails if any changed file is
outside .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/**. Ensure
the path check enforces the allowed-file boundary independently of git diff
--check, wording validation, and link validation.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 548469a3-1ab5-452c-9746-bc6a09a7ba60

📥 Commits

Reviewing files that changed from the base of the PR and between 7e87a91 and 50f498f.

📒 Files selected for processing (20)
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/CHUNK_MAP.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/DECISIONS.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/DISCOVERY.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/INTENT.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/PLAN.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/RISKS.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/STATUS.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/chunks/README.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/chunks/WS-QUAL-001-01B2-baseline-evidence-ci-ratchet.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/chunks/WS-QUAL-001-02-project-service-coverage.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/chunks/WS-QUAL-001-02R-project-setup-behavior-coverage.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/chunks/WS-QUAL-001-03-project-boundary-coverage.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/chunks/WS-QUAL-001-03R-checker-behavior-coverage.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/chunks/WS-QUAL-001-04-task-coverage.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/chunks/WS-QUAL-001-04R-global-90-floor.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/chunks/WS-QUAL-001-05-checker-coverage.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/chunks/WS-QUAL-001-06-permanent-90-floor.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/chunks/WS-QUAL-001-PLAN2-current-main-reconciliation.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/reviews/WS-QUAL-001-PLAN2-external-review-response.md
  • .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/reviews/WS-QUAL-001-PLAN2-review-and-trust-bundle.md

Comment thread .agent-loop/initiatives/WS-QUAL-001-backend-coverage-floor/PLAN.md Outdated
@abiorh-claw
abiorh-claw self-requested a review August 4, 2026 05:46
@abiorh-claw
abiorh-claw merged commit 8f2a31f into main Aug 4, 2026
19 checks passed
@abiorh-claw
abiorh-claw deleted the codex/ws-qual-001-current-audit branch August 4, 2026 05:54
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.

2 participants