Skip to content

docs(rfc-0001,rfc-0008): advance both to green on the maturity ladder - #192

Merged
jensholdgaard merged 3 commits into
mainfrom
docs/rfc0001-0008-advance-to-green
Jun 13, 2026
Merged

docs(rfc-0001,rfc-0008): advance both to green on the maturity ladder#192
jensholdgaard merged 3 commits into
mainfrom
docs/rfc0001-0008-advance-to-green

Conversation

@jensholdgaard

@jensholdgaard jensholdgaard commented Jun 13, 2026

Copy link
Copy Markdown
Owner

What

Advances RFC 0001 (template miner) and RFC 0008 (WAL) on the docs/verification.md §3 / README.md maturity ladder — both to green (all §5 acceptance criteria pass). Docs-only: status: frontmatter + a Status note on each + the roadmap §3 line.

Why not validated

The ladder reserves validated for thesis-gates in benchmarks.md §7 passing on representative corpora:

  • RFC 0001 touches A1 (compression crossover) + C1 (reconstruction). C1 passes authoritatively (1.000000); A1 is an authoritative FAIL with a corpus-size/hardware sensitivity open item (parked pending a > 1 GB corpus). So validated waits on A1 — but A1 is a thesis gate, not an acceptance gate, so it doesn't block green.
  • RFC 0008 is a durability buffer — its pillar touches no thesis gate — so green is the top of its acceptance ladder and the terminal accepted flip is your call per README.md. (RFC0008.5's corruption audit event remains a documented §9 deferral, not a gap — the structured-error + halt halves are green.)

Verification

Confirmed no live #[ignore]/unimplemented!() acceptance stubs remain in ourios-miner or ourios-wal, and both crates' suites pass. mdbook build clean.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Updated RFC specifications with current status indicators and completed test coverage information.
    • Refreshed project roadmap reflecting the latest feature readiness milestones.

All §5 acceptance criteria pass for each (zero #[ignore]/unimplemented
stubs in ourios-miner / ourios-wal). RFC 0001 specified→green; RFC 0008
red→green. Each gets a Status note recording the basis:
- RFC 0001: every §5 scenario green (miner-internal + the relocated
  cross-crate criteria); not yet validated — the A1 compression
  thesis-gate (template-mining pillar) is an authoritative FAIL parked
  pending a larger corpus, while C1 reconstruction passes. green is an
  acceptance gate, not a thesis gate, so A1 doesn't block it.
- RFC 0008: all §5 arms .1–.10 green; the corruption audit event is a
  documented §9 deferral, not a gap. The WAL touches no benchmarks.md
  §7 thesis gate, so green is its acceptance ceiling and the terminal
  accepted flip is the maintainer's.
Roadmap §3 RFC 0001 status line updated to match.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@jensholdgaard
jensholdgaard requested a review from Copilot June 13, 2026 19:58
@coderabbitai

coderabbitai Bot commented Jun 13, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@jensholdgaard, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 38 minutes and 45 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

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.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 2fe6829a-b745-4779-b883-6ebe9f436578

📥 Commits

Reviewing files that changed from the base of the PR and between 4e60ddb and 6298a80.

📒 Files selected for processing (2)
  • docs/rfcs/0008-wal.md
  • docs/roadmap.md
📝 Walkthrough

Walkthrough

RFC documents for template miner (0001) and WAL (0008) are promoted from specified/red to green status with detailed status notes explaining test coverage, deferred items, and validation gate dependencies. The roadmap is updated to reflect these status changes.

Changes

RFC Status Green Milestone Documentation

Layer / File(s) Summary
RFC 0001 template miner status transition
docs/rfcs/0001-template-miner.md
Front-matter status changes from specified to green with expanded status note describing green criteria (all §5 acceptance passing with live tests), remaining miner-internal and relocated scenarios, and explaining why validated is withheld pending A1 compression-crossover resolution.
RFC 0008 WAL status transition
docs/rfcs/0008-wal.md
Front-matter status changes from red to green with status note confirming all §5 test arms live and passing, clarifying deferred corruption audit event (with halting/recovery remaining green), and noting validated does not apply since WAL is outside benchmark thesis gates.
Roadmap current-state update
docs/roadmap.md
§3 current state block updated to show RFC 0001 §5 scenarios fully green (35/35) instead of red (18/35), validation pending A1 compression thesis-gate; RFC 0008 status updated to green with cross-crate criteria clarification.

Possibly related PRs

  • jensholdgaard/ourios#47: Both PRs update docs/roadmap.md §3 "Current state" to adjust RFC 0001 scenario readiness (green/red counts) and related status notes in the same roadmap section.
  • jensholdgaard/ourios#65: Both PRs edit docs/rfcs/0008-wal.md readiness status, with this PR's red→green update building on the retrieved PR's earlier §5 contract-specification work.
  • jensholdgaard/ourios#189: Both PRs update docs/rfcs/0008-wal.md to reflect deferring the RFC0008.5 corruption audit event, with this PR's "green" status note incorporating that deferred requirement.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

📋 Two RFCs crossed the green-light threshold today,
Tests all passing, no stubs in the way—
Roadmap updated, the milestones align,
Though A1 compression waits for its time. ✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed Title clearly and concisely summarizes the main change: advancing two RFCs (0001 and 0008) to green status on the maturity ladder. Specific, focused, and directly related to the changeset.
Description check ✅ Passed Description covers all required template sections: Summary (detailed what/why), Related (RFC references), and addresses core checklist items (docs updated, verification confirmed). Comprehensive explanation of maturity advancement rationale.
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.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/rfc0001-0008-advance-to-green

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 and usage tips.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Advances RFC 0001 (template miner) and RFC 0008 (WAL) up the documentation “maturity ladder” by flipping their status: frontmatter to green, adding status notes summarizing the green-gate justification, and updating the roadmap’s current-state snapshot accordingly.

Changes:

  • Update RFC 0001 and RFC 0008 frontmatter status: to green and add status-note prose explaining why.
  • Refresh docs/roadmap.md “Current state” lines to reflect the new green statuses (and related notes about validated).

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.

File Description
docs/roadmap.md Updates current-state snapshot to reflect RFC 0001 / RFC 0008 now being green.
docs/rfcs/0008-wal.md Flips RFC 0008 status to green and adds a status note summarizing acceptance coverage and remaining deferrals.
docs/rfcs/0001-template-miner.md Flips RFC 0001 status to green and adds a status note explaining acceptance coverage and why validated is still pending.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/roadmap.md Outdated
Comment thread docs/roadmap.md Outdated
Comment thread docs/rfcs/0008-wal.md Outdated
Comment thread docs/rfcs/0008-wal.md Outdated

@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: 1

🤖 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 `@docs/roadmap.md`:
- Around line 65-70: Update the roadmap banner date to "2026-06-13" and fix the
RFC 0001 tally line: replace the text "**RFC 0001 §5 scenarios green: 35 / 35 —
RFC 0001 status: `green`**" with an accurate count (e.g., correct "35 / 35" to
the current number of §5 scenarios and adjust wording if needed) or remove the
"X / X" tally entirely so the snapshot is consistent; ensure the adjacent note
"(2026-06-13; ...)" remains accurate.
🪄 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: bb5f03d1-df14-42fa-ab9d-4d7a462970c7

📥 Commits

Reviewing files that changed from the base of the PR and between 38b40ce and 4e60ddb.

📒 Files selected for processing (3)
  • docs/rfcs/0001-template-miner.md
  • docs/rfcs/0008-wal.md
  • docs/roadmap.md

Comment thread docs/roadmap.md Outdated
… note wording

- roadmap: RFC 0001 §5 is 42 scenarios not 35 (Copilot); banner re-dated
  2026-05-22 → 2026-06-13 (the RFC 0005 line under it is still accurate —
  0005 is still  at 10/11).
- RFC 0008 status note: scope the no-stubs claim to the acceptance tests
  under tests/ — encode_audit_event() in lib.rs is still unimplemented!()
  but it's the §9 AuditEvent-serde deferral, not a §5 criterion (Copilot).
- RFC 0008 status note: 'validated is N/A' → 'vacuously satisfied' (no
  thesis gate to fail); the RFC stays green rather than self-promoting
  through a vacuous stage, and accepted is the maintainer's flip — matches
  the ladder wording instead of contradicting it (Copilot).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

Comment thread docs/rfcs/0008-wal.md Outdated
Comment thread docs/roadmap.md
- RFC 0008 status note: point the accepted-flip reference at
  docs/rfcs/README.md (was a bare README.md — ambiguous vs repo root),
  matching the ladder reference earlier in the same note (Copilot).
- roadmap: top-level "Last updated" 2026-05-22 -> 2026-06-13 to match
  the §3 snapshot date, with a note that the §§4+ phase narrative
  predates it and isn't re-verified here (Copilot).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@jensholdgaard
jensholdgaard merged commit 8569fab into main Jun 13, 2026
11 checks passed
@jensholdgaard
jensholdgaard deleted the docs/rfc0001-0008-advance-to-green branch June 13, 2026 20:22
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