Skip to content

📝 docs(logs): wave 37, the gate and its checker - #65

Merged
Misery7100 merged 2 commits into
mainfrom
wave-37-the-gate-and-its-checker
Aug 24, 2026
Merged

📝 docs(logs): wave 37, the gate and its checker#65
Misery7100 merged 2 commits into
mainfrom
wave-37-the-gate-and-its-checker

Conversation

@Misery7100

@Misery7100 Misery7100 commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

User description

Summary

Wave 37 executed the rfc-index gate carried out of wave 36. It ships one
file
— the wave's execution log — because the work it records happened in the
repository that owns the checker, and because the half of the plan that was
meant to happen here turned out not to be needed.

The gate's checker had two defects, both found by running it against this
collection: it read fenced code blocks as markup, and it found the Grade
column by position. Both are fixed in
morzecrew/agent-skills#13,
merged. They are not fixed here, and deliberately so — skills-lock.json
names that repository as the source of rfc-writer, so an edit here is reverted
by the next routine sync. This repository has 9 such sync commits, 4 of which
rewrote rfc_index.py itself.

Closes #
RFC: none — this is an execution log against the whole collection, not a design.

What the gate now reports

32 problems → 27. The three "broken links" in RFC 0019 were false positives
(a Go generic signature, and a fenced markdown sample whose links resolve from
the file it samples). RFCs 0023–0028 now pass unchanged: reading the column
by heading rather than index is what makes this repository's house style legal,
so the seven table rewrites the plan called for were never necessary. That they
pass on their merits was checked, not assumed — a grade in 0023 replaced with
PROBABLY is reported.

The finding worth reading: RFC 0030's grades were destroyed

Drift count: 1. RFC 0030's decision table was written with a real Grade
column — git show 6d3752d has four rows holding | OPEN |, and today's file
has none. Answering the questions overwrote the grades in place, one careful
edit at a time, into the only column that looked like it was for answers. The
table still reads as well-maintained; the header is now the only evidence the
column ever held a grade.

The old checker could not report this. Reading cell two, a destroyed grade
and an absent one produced the same message, so it hid behind 22 copies of a
boring one. RFC 0030 is not amended in this PR — which grade each of rows 1,
3, 4 and 5 takes is the author's call, and the log proposes rather than writes.

Type

  • Feature
  • Fix
  • Refactor (no behaviour change)
  • Docs
  • Chore / CI / dependencies
  • Breaking change

Design

  • Behaviour matches the accepted RFC
  • The RFC is amended in this PR, because the design changed

No RFC is amended. That is the point of the log: proposals go to the author,
and an RFC edited to match what was built stops recording that a decision ever
changed.

Lifecycle invariants

Not applicable — no product code changes. The diff is one file under logs/,
which nothing reads at runtime.

Compatibility

  • Manifest schema (schemas/) unchanged
  • Hook ABI unchanged, or versioned and documented
  • New or changed exit codes are in the reference docs — none changed

Secrets & safety

  • No secret value reaches stdout, stderr, the journal, or an error message
  • Destructive paths confirm first, or take a backup first — none touched

Verification

  • just ci green
  • The acceptance run against real Docker exercises this path

What I ran and what it proved:

  • just ci — green, 86.6% statement coverage against an 84% floor.
  • just log-checklogs/wave-37.md: 0 problems. Then sabotaged three ways to
    prove it is genuinely checked: understating the drift count, an illegal
    grade/action pair, and evidence replaced by a sentence. Each fails; each
    restored clean.
  • just acceptance-coveracceptance passed.
  • just test-docker -count=1 — green, test/suite 174.6s. Forced fresh
    because the cached run would have been a valid pass reported as a run.

Risk & rollback

None to a live installation. The diff adds one file under logs/; no
binary, schema, unit, or documented surface changes. Reverting is deleting a
file.

The real risk is one this PR cannot remove: the gate is still not wired into
ci
, and this PR says why rather than wiring it red. 22 RFCs carry 354
ungraded decision rows, deferred as a unit of its own. log-check, wired in
wave 36, went green the day it was wired; a gate committed red is a gate whose
first job is to be switched off.

Note on ordering

The log's Carried section says the upstream fix is unmerged. It was, when
written; agent-skills#13 has since merged. The log is append-only and is left as
written. Syncing the fixed checker into this repository is wave 38's first
item, not this PR's
— and it should not land before this, since this is the
record of why the sync is wanted.


Summary by cubic

Adds logs/wave-37.md, the execution log for the rfc-index gate, and explains upstream checker fixes and their impact. Old checker misparsed code fences and assumed the Grade column’s position; the fixed checker respects code fences and finds Grade by heading, reducing problems 32→27, removing RFC 0019 false positives, and surfacing real drift in RFC 0030.

  • Only adds the log; no runtime code, schemas, hooks, or exits changed.
  • Do not edit the vendored checker here; skills-lock.json sources rfc-writer from morzecrew/agent-skills. Sync of the fix will follow.
  • Leave RFCs 0023–0028 decision tables as-is; they now pass under the fixed checker.
  • RFC 0030 drift: four destroyed grades. Required action: the RFC author restores grades and moves answers to their own column.
  • Keep rfc-index out of ci for now; the gate still fails on 27 problems.

Written for commit b5a80fc. Summary will update on new commits.

Review in cubic


CodeAnt-AI Description

Document the wave 37 RFC index gate review and its findings

What Changed

  • Adds an execution log explaining why the RFC index checker is being fixed upstream instead of modified in this repository
  • Records that checker improvements reduce reported problems from 32 to 27 and allow RFCs 0023–0028 to pass without table rewrites
  • Documents one detected drift in RFC 0030, where four existing grades were overwritten while answers were added
  • Explains why the gate remains out of CI until its failures are resolved, and carries forward ungraded rows and other follow-up work
  • Corrects the recorded count of vendored skill syncs from five to nine, including four updates to the checker

Impact

✅ Clearer RFC gate findings
✅ Prevented unnecessary RFC table rewrites
✅ Accurate follow-up and sync counts

💡 Usage Guide

Checking Your Pull Request

Every time you make a pull request, our system automatically looks through it. We check for security issues, mistakes in how you're setting up your infrastructure, and common code problems. We do this to make sure your changes are solid and won't cause any trouble later.

Talking to CodeAnt AI

Got a question or need a hand with something in your pull request? You can easily get in touch with CodeAnt AI right here. Just type the following in a comment on your pull request, and replace "Your question here" with whatever you want to ask:

@codeant-ai ask: Your question here

This lets you have a chat with CodeAnt AI about your pull request, making it easier to understand and improve your code.

Example

@codeant-ai ask: Can you suggest a safer alternative to storing this secret?

Preserve Org Learnings with CodeAnt

You can record team preferences so CodeAnt AI applies them in future reviews. Reply directly to the specific CodeAnt AI suggestion (in the same thread) and replace "Your feedback here" with your input:

@codeant-ai: Your feedback here

This helps CodeAnt AI learn and adapt to your team's coding style and standards.

Example

@codeant-ai: Do not flag unused imports.

Retrigger review

Ask CodeAnt AI to review the PR again, by typing:

@codeant-ai: review

Check Your Repository Health

To analyze the health of your code repository, visit our dashboard at https://app.codeant.ai. This tool helps you identify potential issues and areas for improvement in your codebase, ensuring your repository maintains high standards of code health.

Misery7100 and others added 2 commits August 21, 2026 18:26
The `rfc-index` gate carried out of wave 36, ruled B-then-D by the author:
fix the checker in the repository that owns it, then take the mechanical
win. B landed upstream; D was almost entirely subsumed by it, and the log
records that rather than manufacturing work to fill the plan's shape.

Drift count 1, against RFC 0030: its decision table was written with a real
Grade column holding `OPEN`, and answering its questions overwrote four
grades in place. The old checker could not report it — reading the grade
from column two, a destroyed grade and an absent one produced the same
message.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Five was read off a `git log -5` run to answer whether the file had ever
been re-synced. It had; the `-5` was a display limit, and it travelled with
the number into a sentence that needed a count. Measured: 9 sync commits, 8
touching rfc-writer, 4 touching rfc_index.py itself.

Appended rather than edited, per this collection's own practice. The claim
it supported is stronger for the correction.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@codeant-ai

codeant-ai Bot commented Aug 24, 2026

Copy link
Copy Markdown

🤖 CodeAnt AI — Review Status

Status Commit Started (UTC) Finished (UTC)
✅ Reviewed your PR b5a80fc Aug 24, 2026 · 11:15 11:15

@codeant-ai

codeant-ai Bot commented Aug 24, 2026

Copy link
Copy Markdown

Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@coderabbitai

coderabbitai Bot commented Aug 24, 2026

Copy link
Copy Markdown

Important

Review skipped

Review was skipped due to path filters

⛔ Files ignored due to path filters (1)
  • logs/wave-37.md is excluded by none and included by none

CodeRabbit blocks several paths by default. You can override this behavior by explicitly including those paths in the path filters. For example, including **/dist/** will override the default block on the dist directory, by removing the pattern from both the lists.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 51e19b10-f4fc-4b0c-9e30-3b77e7b520c0

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

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.

@codeant-ai codeant-ai Bot added the size:L This PR changes 100-499 lines, ignoring generated files label Aug 24, 2026
@Misery7100
Misery7100 merged commit 7f4f2b7 into main Aug 24, 2026
15 checks passed
@Misery7100
Misery7100 deleted the wave-37-the-gate-and-its-checker branch August 24, 2026 11:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:L This PR changes 100-499 lines, ignoring generated files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant