Skip to content

Wave-1 three-way matrix: 10 never-tuned corpora + DeepWiki/CodeWiki peer manifests - #1

Merged
blade47 merged 3 commits into
mainfrom
bench/wave1-three-way-matrix
Jul 29, 2026
Merged

Wave-1 three-way matrix: 10 never-tuned corpora + DeepWiki/CodeWiki peer manifests#1
blade47 merged 3 commits into
mainfrom
bench/wave1-three-way-matrix

Conversation

@blade47

@blade47 blade47 commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Ten new corpora (corpora/<repo>-2026-07/): resilience4j, ktor, ripgrep, sidekiq, laravel/framework, Polly, Alamofire, argo-cd, fd, FluentValidation — 8 languages, none ever used to tune the pipeline. argo-cd/fd/FluentValidation ran as a sealed holdout (selected in advance, generated last, zero pipeline changes mid-wave). Each corpus carries _meta.json provenance (doc0 commit, source SHA, model stack) and a full _graph-index.json.
  • Nineteen peer manifests (corpora/peers/): DeepWiki arms for all ten repos (344 per-page URLs, live-verified) and CodeWiki arms for the eight it covers plus hono — sha256-pinned, content never redistributed, CodeWiki's displayed generation commit recorded per arm.
  • fetch-codewiki/: standalone playwright pipeline (optional dependency, tsc-clean without it) reproducing the CodeWiki extraction, h2 splitting, and prose-preserving citation normalization.
  • Report (docs/benchmarks/2026-07-29-wave1-three-way-matrix.md) + raw per-arm results jsonl + README headline block.

Headline (full population, one pinned judge, ~20k claim groups, 0 judge failures)

Never-tuned mean (10 repos) doc0 DeepWiki CodeWiki (Google)
Claim support 0.856 (0.796–0.904) 0.588 (0.378–0.776) 0.430 (0.326–0.591)

doc0 wins every per-repo head-to-head; the sealed holdout mean (0.886) came in above the main wave (0.843). The report documents the fairness protocol (CodeWiki judged at its own pinned commits — four rows commit-identical; extraction-artifact hypotheses tested with sensitivity runs before accepting peer numbers) and an honesty section disclosing doc0's own wave-discovered defects (ktor OpenAPI test-fixture pollution, JVM citation-resolution gap).

Deliberately out of scope

  • baselines/v0.1-launch.baseline.json entries for the new corpora — that file is mid-edit in separately staged local work; pin the deterministic metrics there with the usual Why: line.
  • The staged hono-v3 corpus and the experimental corpus dirs (celery, cli, nextjs, hono-v4/v5, redis-v2) — untouched, they remain local.

Gates

npx tsc --noEmit clean · 95/95 tests green · eslint clean on new tooling · no internal paths in public-facing files

🤖 Generated with Claude Code

…odeWiki peer manifests

Ten new corpora (resilience4j, ktor, ripgrep, sidekiq, laravel, Polly,
Alamofire, argo-cd, fd, FluentValidation — 8 languages, none used to tune
the pipeline; the last three ran as a sealed holdout) with full provenance
and graph indexes. Nineteen hash-pinned peer manifests: DeepWiki with
live-verified per-page URLs, CodeWiki with its displayed generation commit
recorded per arm. New standalone fetch-codewiki pipeline (playwright,
optional dependency) reproduces the CodeWiki extraction + prose-preserving
citation normalization.

Full-population results (same pinned judge, both sides, 0 judge failures):
doc0 0.856 vs DeepWiki 0.588 vs CodeWiki 0.430 mean claim support;
doc0 wins every per-repo head-to-head. Report includes the fairness
protocol (peer-SHA pinning, extraction-artifact sensitivity runs) and an
honesty section disclosing doc0's own defects found during the wave.

Baseline pinning for the new corpora is deliberately deferred —
v0.1-launch.baseline.json is mid-edit in separately staged work.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

@chatgpt-codex-connector chatgpt-codex-connector 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 832ae418f4

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread corpora/peers/codewiki-argocd.manifest.json
Comment thread corpora/peers/fetch-codewiki/README.md
Comment thread corpora/peers/fetch-codewiki/normalize.ts
Comment thread corpora/peers/fetch-codewiki/fetch.ts Outdated
Comment thread corpora/peers/fetch-codewiki/split.ts
… fetch pipeline

- Peer manifests gain structured pinned_source_sha (set on all nine CodeWiki
  arms); the judged tier now checks each pinned peer out at its own commit
  instead of judging every peer against the corpus source SHA. ensureSourceRepo
  refactored to a repo/sha/dir-keyed ensureSourceAt both paths share.
- peers:fetch handles codewiki manifests as verify-only (pages come from the
  fetch-codewiki playwright pipeline, not HTTP; unfetched arms skip with the
  exact command to run) instead of falling into the raw-HTML branch.
- normalizeCitations is idempotent (already-normalized path:line labels are
  left untouched) and splitExtraction clears stale .md pages before writing,
  so rerunning the advertised CLIs cannot change prose, hashes, or leak
  removed sections into scoring. Both behaviors pinned in
  test/fetch-codewiki.test.ts.
- Coverage detection in fetch.ts is structural (CodeWiki's not-found headline)
  rather than a bare "404" substring that wiki prose can trip.
- README keeps only the latest full-population matrix; superseded n=40
  snapshots remain in docs/benchmarks/.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

@chatgpt-codex-connector chatgpt-codex-connector 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e0f8db1cd9

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread corpora/peers/fetch-peers.ts
Comment thread corpora/peers/fetch-codewiki/split.ts Outdated
Comment thread corpora/peers/fetch-codewiki/extract.js Outdated
…afe split, full-block dedup

- peers:fetch exits 1 when codewiki pages haven't been browser-extracted yet,
  printing the exact fetch-codewiki command per manifest — a silent skip let
  the run report success while the judged runner rejected the same empty
  directory moments later.
- splitExtraction tracks fenced-code state so a "## " shell/Ruby/Python
  comment inside a code block can't open a spurious section and split the
  fence across pages (pinned in test; the committed 2026-07-28 arms were
  audited — zero pages with unbalanced fences, so the scored corpus is
  unaffected).
- extract.js deduplicates repeated DOM blocks by the full block, not a
  200-char prefix, so distinct blocks sharing a long setup prefix are never
  dropped.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@blade47
blade47 merged commit ba6c714 into main Jul 29, 2026
3 checks passed
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.

1 participant