feat(encyclopedia): consolidate creates overview articles; higher fold/consolidate caps #23

2026-10-27T09:41:29Z

claude-bot commented

2026-10-27 09:41:29 +00:00

After the rebuild (375 articles) there was no hierarchy where the natural parent had no article: heating (vitocal-waermepumpe, open3e, viessmann-can-bus-integration, vitocharge-vx3, EMS …), lighting, and the 13 rooms (no floor articles). 113 articles had a single note, and folds were capped at 5 per run.

Overviews: a consolidate reply may propose a new overview article over ≥2 group members (e.g. Heizung, Beleuchtung, Erdgeschoss; the prompt treats UG/KG/Keller as one floor). Marked with an optional overview flag in the plan (format stays 3, existing plan kept). An overview is written from its own notes plus its current children's notes, round-robin, at most 12 borrowed, recomputed every run; borrowed notes are never assigned to it. Overviews and any article with children are never folded. An overview without children is deleted (no own notes) or becomes an ordinary article.
Overview proposals under a redirected/retired slug are dropped; an overview takes the parent most of its children share; no hostnames/IDs/IPs in titles.
Caps: MaxFoldsPerRun 5 → 100, MaxConsolidationsPerRun 60 → 150.
Prompts.Version 9: remembered consolidate groups and fold decisions are asked again, so the first night after deploy is longer.

Spec: section added to docs/superpowers/specs/2026-10-26-encyclopedia-consolidation-design.md.

Tests: Application 302, Contracts 85, Core 174, Host 164. Independent Opus review, one fix round; open minors: an overview that loses its last child but keeps own notes waits one night before being rewritten as an ordinary article; one redundant assertion in a test.

🤖 Generated with Claude Code

After the rebuild (375 articles) there was no hierarchy where the natural parent had no article: heating (`vitocal-waermepumpe`, `open3e`, `viessmann-can-bus-integration`, `vitocharge-vx3`, EMS …), lighting, and the 13 rooms (no floor articles). 113 articles had a single note, and folds were capped at 5 per run. - **Overviews:** a consolidate reply may propose a new overview article over ≥2 group members (e.g. Heizung, Beleuchtung, Erdgeschoss; the prompt treats UG/KG/Keller as one floor). Marked with an optional `overview` flag in the plan (format stays 3, existing plan kept). An overview is written from its own notes plus its current children's notes, round-robin, at most 12 borrowed, recomputed every run; borrowed notes are never assigned to it. Overviews and any article with children are never folded. An overview without children is deleted (no own notes) or becomes an ordinary article. - Overview proposals under a redirected/retired slug are dropped; an overview takes the parent most of its children share; no hostnames/IDs/IPs in titles. - **Caps:** `MaxFoldsPerRun` 5 → 100, `MaxConsolidationsPerRun` 60 → 150. - `Prompts.Version` 9: remembered consolidate groups and fold decisions are asked again, so the first night after deploy is longer. Spec: section added to `docs/superpowers/specs/2026-10-26-encyclopedia-consolidation-design.md`. Tests: Application 302, Contracts 85, Core 174, Host 164. Independent Opus review, one fix round; open minors: an overview that loses its last child but keeps own notes waits one night before being rewritten as an ordinary article; one redundant assertion in a test. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

claude-bot added 2 commits 2026-10-27 09:41:29 +00:00

feat(encyclopedia): consolidation proposes overview articles; raise fold and consolidate caps 6a1d51ec02

Consolidation could only link existing articles as parents, so subjects
whose natural parent had no article (heating, lighting, floors) stayed
flat. The consolidate reply may now propose new overview articles over
two or more group members. An overview is written from its children's
first sources (in turn, at most 12) and an article with sub-articles is
never folded for being thin. The prompts name floors EG/OG/DG/KG and
treat UG, KG and Keller as one floor.

MaxFoldsPerRun 5 -> 100 and MaxConsolidationsPerRun 60 -> 150: a
bootstrap plan of ~400 articles needs several passes and the calls are
small. Prompts.Version 9 re-asks remembered consolidation groups; the
plan format is unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

fix(encyclopedia): overviews borrow their sub-articles' sources each run and live as long as they have sub-articles

ci/woodpecker/pr/test Pipeline was successful

Details

ci/woodpecker/push/test Pipeline was successful

Details

4145e023ff

An overview's borrowed sources were a snapshot taken at creation: a
sub-article that left kept feeding it, a merge moved the borrowed notes
into the target, and losing the borrowed notes deleted the overview and
retired its natural slug while its sub-articles lived on.

Overviews now carry an overview mark (optional plan field, format
unchanged) and only their own sources; what they are written from is
derived every run from their current sub-articles (in turn, at most 12),
for staleness, fingerprints and the write. Note removal never deletes an
overview; one left without sub-articles is deleted when it has no own
sources (slug stays free) or becomes an ordinary article.

An overview proposal under a redirected or retired slug is dropped
instead of parenting the children under the redirect target. An overview
takes the parent most of its children have, none on a tie. The
consolidate prompt carries the no-concrete-names rule for titles and
slugs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

k.renner merged commit 0468226304 into main

2026-10-27 09:43:08 +00:00

k.renner deleted branch feat/encyclopedia-overviews

2026-10-27 09:43:08 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: konairius/Wiki#23