Skip to content

docs(rfc-0001): flip status to validated - #198

Merged
jensholdgaard merged 3 commits into
mainfrom
docs/rfc-0001-validated
Jun 14, 2026
Merged

docs(rfc-0001): flip status to validated#198
jensholdgaard merged 3 commits into
mainfrom
docs/rfc-0001-validated

Conversation

@jensholdgaard

@jensholdgaard jensholdgaard commented Jun 14, 2026

Copy link
Copy Markdown
Owner

What

Flips RFC 0001 (template miner) → validated on the maturity ladder, per the maintainer's authorization.

Why it's validated

docs/verification.md §3 reserves validated for every thesis-gate the RFC's pillars touch passing on representative corpora (benchmarks.md §7). The template-mining pillar's gates are C1 (reconstruction fidelity) and C2 (template-count convergence):

  • C1 = 1.000000, C2 = 40-template plateau at 11.2 M lines (formal gate applying) on a representative ≥ 1 M-line corpus (LogHub HDFS_v1).
  • Recorded authoritatively on the §1 baseline hardware (baseline-8vcpu-32gib) in benchmarks.md §9.6 (identical to the §9.5 diagnostic run — deterministic gates).
  • A1 (compression vs zstd) is a diagnostic, not a gate (RFC 0011), already encoded in the §7 gate table.

Changes

  • docs/rfcs/0001-template-miner.md: frontmatter status: green → validated + status-note rewrite.
  • docs/roadmap.md: §3 status tracker + header.

Note (flagged, not blocking)

RFC 0011 (the A1 re-scope that defines C1/C2 as the gates) is still drafted. The §7 gate table already reflects the A1 demotion, so this flip is well-founded, but accepting RFC 0011 would fully ratify the chain. accepted remains your terminal sign-off for RFC 0001.

Invariants

Doc/status-only. No code, schema, or hot path.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Updated RFC 0001 status documentation and project roadmap with the latest validation information.

Per the maintainer's 2026-06-14 authorization. The ladder
(docs/verification.md §3) reserves `validated` for every thesis-gate the
RFC's pillars touch passing on representative corpora (benchmarks.md §7).
The template-mining pillar's gates are C1 (reconstruction fidelity) and
C2 (template-count convergence) — both pass on a representative ≥ 1 M-line
corpus, authoritatively on the §1 baseline hardware (benchmarks.md §9.6:
C1 1.000000, C2 a 40-template plateau at 11.2 M lines, formal gate
applying). A1 (compression vs zstd) is a diagnostic, not a gate (RFC 0011,
already encoded in the §7 gate table).

Updates the frontmatter status, the RFC status note, and the roadmap §3
tracker. NB RFC 0011 (the A1 re-scope) is still `drafted`; §7 already
reflects the demotion, but accepting RFC 0011 would fully ratify the
chain. `accepted` remains the maintainer's terminal sign-off.

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

coderabbitai Bot commented Jun 14, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 97fd51f8-b072-40a6-9475-a2fa8c92d0d9

📥 Commits

Reviewing files that changed from the base of the PR and between cf3b58b and c71d500.

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

📝 Walkthrough

Walkthrough

RFC 0001 (docs/rfcs/0001-template-miner.md) has its status field changed from green to validated. The Status note section is rewritten to document C1/C2 gate results on the LogHub HDFS_v1 corpus, demote A1 to diagnostic, and add an accepted sign-off. docs/roadmap.md is refreshed to 2026-06-14 with matching validated status and updated §3 current-state text.

Changes

RFC 0001 validated status update

Layer / File(s) Summary
RFC 0001 front-matter and status note
docs/rfcs/0001-template-miner.md
status field changes from green to validated; Status note section is replaced with C1/C2 gate ladder wording, LogHub HDFS_v1 corpus and hardware references, A1 demotion to diagnostic, and a terminal accepted sign-off.
Roadmap metadata and §3 current-state refresh
docs/roadmap.md
"Last updated" advances to 2026-06-14, RFC 0001 status line changes to validated, and §3 current-state is rewritten to show 42/42 scenarios, C1/C2 pass status, and corpus/baseline references; A1 is noted as diagnostic, not a gate.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

  • jensholdgaard/ourios#194: Records the authoritative baseline C1/C2 results on LogHub HDFS_v1 that this PR references when setting RFC 0001's gate state to validated.
  • jensholdgaard/ourios#192: Directly edits the same two files (docs/rfcs/0001-template-miner.md, docs/roadmap.md) around the same RFC 0001 maturity-ladder/greenvalidated narrative.
  • jensholdgaard/ourios#193: Introduces the A1 re-scope semantics (diagnostic vs. thesis gate) that this PR incorporates into the RFC 0001 status note.

Poem

🐇 Hop, hop, the gates have passed!
C1 and C2 hold steady and fast,
green gives way to validated light,
A1 steps back—diagnostic, not a fight.
The roadmap blooms on June fourteen's dawn,
Another milestone checked, the rabbit hops on! ✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title directly and concisely describes the main change: updating RFC 0001's status from green to validated.
Description check ✅ Passed The description follows the template structure with Summary and Related sections, provides detailed justification for the status change, and explains the gate criteria. However, the Checklist section is missing entirely.
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/rfc-0001-validated

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

Updates documentation to reflect RFC 0001 (template miner) advancing to validated on the project’s RFC maturity ladder, based on recorded thesis-gate results on baseline hardware.

Changes:

  • Flip RFC 0001 frontmatter status from greenvalidated and rewrite the RFC’s status note to cite the relevant C1/C2 benchmark evidence.
  • Update docs/roadmap.md “Last updated” note and “Current state” section to reflect RFC 0001 as validated (and keep RFC 0008 as green).

Reviewed changes

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

File Description
docs/roadmap.md Updates roadmap “last updated” note and current-state status line to reflect RFC 0001 validated, with benchmark citations.
docs/rfcs/0001-template-miner.md Updates RFC 0001 frontmatter status and rewrites status note with the rationale/citations for validated.

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

Comment thread docs/roadmap.md Outdated
Comment thread docs/rfcs/0001-template-miner.md Outdated
Copilot flagged that "representative ≥ 1 M-line corpus" conflated two
thresholds: benchmarks.md §8 defines "representative" as the ≥ 1 GiB
canonical floor, while ≥ 1 M-line is C2's formal-gate threshold. HDFS_v1
satisfies both (≈ 1.47 GiB, 11.2 M lines); reword the RFC 0001 status note
and the roadmap §3 entry to say so precisely.

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 2 out of 2 changed files in this pull request and generated 4 comments.

Comment thread docs/roadmap.md Outdated
Comment thread docs/roadmap.md Outdated
Comment thread docs/roadmap.md Outdated
Comment thread docs/rfcs/0001-template-miner.md Outdated
…lot)

Copilot flagged that bare "§1 baseline hardware" / "§8 canonical floor"
refs are ambiguous — each doc has its own §1/§8. Qualify them explicitly
as `benchmarks.md` §1 (hardware baseline) and §8 (≥ 1 GiB canonical
floor) in the RFC 0001 status note and the roadmap §3 entry + header.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@jensholdgaard
jensholdgaard merged commit 46da33d into main Jun 14, 2026
12 checks passed
@jensholdgaard
jensholdgaard deleted the docs/rfc-0001-validated branch June 14, 2026 12:34
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