Skip to content

Commit 53216a5

Browse files
joshwilhelmiclaude
andcommitted
[gobby-cli-#877] chore: regenerate verified codewiki evidence
Regenerate the full gobby-wiki code vault with the installed gcode v2 binary (render_version 6) and record the epic #871 closeout evidence. - Full regen: 482 files / 81 modules / 9600 symbols, 585/585 docs at render_version 6, skipped 0. All file pages carry >=3 `## ` sections (Overview / How it fits / Key components); zero Component IDs, zero `API Symbols` tables, zero `<details>` on file or module pages; module pages slimmed with range-free frontmatter. - gwiki lint --project deltas: broken_links 0->0, missing_backlinks 2297->1471 (-826), orphan_pages 13->5 (-8). - Append the closeout section to docs/evidence/wiki-bakeoff-2026-06/ narrative-quality-853.md (supersedes the old #853E/#869 regen-only acceptance); honest note that the AI generate+verify narrative layer is deferred to the nightly daemon regen (cold full AI regen is hours-scale under the serial AiLimiter). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 018f2be commit 53216a5

598 files changed

Lines changed: 24395 additions & 67966 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

docs/evidence/wiki-bakeoff-2026-06/narrative-quality-853.md

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -245,3 +245,69 @@ _To be completed by #853E. Required lines:_
245245
- Guided tour reads as a tutorial (curated TOC, dependency-ordered chapters with Prev/Next chain).
246246
- `_meta/codewiki.json` `render_version: 4`.
247247
- Residual `missing_backlinks` itemized by source page (not dismissed).
248+
249+
---
250+
251+
## 6. Epic #871 closeout (Leaf 6 / #877) — verified-shape regen + after-metrics
252+
253+
Supersedes §5 and the old #853E / #869 "regen-only" acceptance. This is the closeout of the
254+
umbrella epic **#871 — "Trustworthy code-intelligence surfaces"**, which shipped (Leaves 1–5):
255+
decomposed `concepts.rs`; a grounded codewiki **verify pass** (generate → verify → strip
256+
unsupported blocks); verified multi-section file/module **narrative rendering**; internal
257+
**citation re-anchoring** + a no-LLM repair routine; and **gcode contract v2** (daemon-consumed
258+
query surface + public `codewiki --repair-citations`), built and installed to `~/.gobby/bin/`.
259+
260+
### Regen
261+
262+
Installed binary `~/.gobby/bin/gcode` 1.2.0 (`contract_version: 2`, `--repair-citations` live)
263+
ran:
264+
265+
```
266+
gcode codewiki --out gobby-wiki --ai off
267+
```
268+
269+
Result: `files: 482, modules: 81, symbols: 9600, skipped: 0, ai_enabled: false`. Every page in
270+
`_meta/codewiki.json` is now **`render_version: 6`** (585/585 docs; the cache epoch bumped 3/4→6
271+
in Leaves 2–3 forces a full rewrite out of the legacy symbol-dump shape).
272+
273+
### Page-shape assertions (whole vault)
274+
275+
| Check | Result |
276+
| --- | --- |
277+
| File pages with ≥3 `## ` sections | **482/482** (min = 3: `Overview` / `How it fits` / `Key components`) |
278+
| `Component ID` occurrences | **0** files |
279+
| `API Symbols` symbol-table header | **0** files |
280+
| `<details>` on file pages | **0** |
281+
| `<details>` on module pages | **0** |
282+
| Module pages slimmed (range-free frontmatter, bounded `Overview`/diagrams/`Files`) | yes |
283+
| `_meta/codewiki.json` render_version | **6** (all docs) |
284+
285+
The 20 residual `<details>` blocks are all on **aggregate** pages (`concepts/`, `narrative/`,
286+
`repo.md`, `_architecture`, `_hotspots`, `_onboarding`) and are the curated
287+
`<summary>Relevant source files</summary>` navigation aid — not the legacy per-symbol
288+
byte/line provenance dump that Leaf 3 removed from `render_file_doc`/`render_module_doc`.
289+
290+
### `gwiki lint --project` deltas (before → after regen)
291+
292+
| Metric | Before | After | Δ |
293+
| --- | --- | --- | --- |
294+
| `broken_links` | 0 | 0 | 0 |
295+
| `missing_backlinks` | 2297 | 1471 | **−826** |
296+
| `orphan_pages` | 13 | 5 | **−8** |
297+
| `missing_frontmatter` | 2 | 2 | 0 (pre-existing) |
298+
| `duplicate_aliases` | 0 | 0 | 0 |
299+
300+
Broken links stay at zero; the new narrative shape cut missing backlinks by 826 and orphan pages
301+
by 8.
302+
303+
### AI narrative + verify layer — deferred to nightly daemon regen (honest cost)
304+
305+
This regen used `--ai off`, so the committed vault carries the deterministic structural body
306+
(multi-section shape, hub-`summary` Key-components purposes, range-free frontmatter) and the
307+
**verify pass did not run on it**. The grounded generate→verify pipeline itself is independently
308+
proven by the Leaf 2/3 unit tests (planted-unsupported-block stripping, each degradation path,
309+
standalone direct generate+verify) and the Leaf 5 contract/CLI acceptance. A cold full **AI-on**
310+
regen is intentionally deferred to the nightly daemon regen (linked gobby-cron task), per the
311+
epic's "Honest cost" note: with the serial `AiLimiter` (`max_concurrency = 1`) a full
312+
generate+verify pass is ~2 calls × 574 pages and is hours-scale — observed **67 s blocked on
313+
file 1 of 482** before switching to the deterministic structural regen for this closeout.

gobby-wiki/code/_architecture.md

Lines changed: 12 additions & 24 deletions
Large diffs are not rendered by default.

gobby-wiki/code/_changes.md

Lines changed: 5575 additions & 6 deletions
Large diffs are not rendered by default.

gobby-wiki/code/_hotspots.md

Lines changed: 300 additions & 199 deletions
Large diffs are not rendered by default.

gobby-wiki/code/_onboarding.md

Lines changed: 69 additions & 53 deletions
Large diffs are not rendered by default.

0 commit comments

Comments
 (0)