feat(wiki): filter auto-generated pages from default views (ADR-2244 Phase 5)

[cdeust]

Summary

Phase 5 of ADR-2244 — filter, don't delete for auto-generated pages. The 8,734 file-doc pages produced by codebase_analyze are valuable lookup tables but they'd dominate any default listing — exactly the catch-all problem Phase 1 was supposed to solve, just shifted from notes/ to reference/.

Phase 5 says: keep them indexed, hide them from the default view, surface them in their own section.

Changes

wiki_list (handler + tool registry)

New include_auto_generated: bool = False parameter. Default behaviour: pages with frontmatter provenance: auto-generated are excluded; response carries auto_generated_count so callers know they exist. Pass include_auto_generated=True to opt in.

wiki_reindex (handler)

INDEX.md gets two top-level sections:

## Human-authored
### adr (N)
...
### explanation (N)
...

## Auto-generated reference
_Produced by codebase_analyze and similar tooling. Lookup-shaped, not curated narrative._
### reference (N)
...

Both sections still grouped by kind. Deterministic output preserved.

Shared work

_classify_page (in both handlers) reads frontmatter once per page and returns (is_redirect_stub, is_auto_generated). The two filters share the same disk read on the ~9,000-page wiki. Worst-case latency observed locally: <500ms on the live wiki.

Tests

tests_py/handlers/test_wiki_redirect_handlers.py — 5 new tests added (25 total in file now):

Surface	Test
wiki_list	auto-gen excluded by default
wiki_list	include_auto_generated=True returns both
wiki_list	both filters compose without double-counting
wiki_list	fast-path when both filters off
wiki_reindex	INDEX.md has Human-authored first, Auto-generated section second

• pytest tests_py/handlers/test_wiki_redirect_handlers.py — 25 passed
• pytest tests_py/core/ tests_py/shared/ tests_py/handlers/test_wiki_redirect_handlers.py tests_py/handlers/test_wiki_sync_errors.py — 2060 passed
• ruff format --check and ruff check clean

Out of scope (follow-ups)

• wiki_search / wiki_view / wiki_export learning the same filter (lower urgency — listing dominance was the primary user complaint).
• Search-time relevance shaping (auto-gen pages might warrant a lower default boost in any future scorer). Out of scope here.

🤖 Generated with Claude Code