kb/concepts/ bekommt Areas: layout: fuer concept, Area-Titel aus jedem Type-Spec, Schwellen-Empfehlung im lint (schliesst #59)

Files changed: - CHANGES.md - README.md - VERSION - kb/concepts/Ambient Environment Dependency.md - kb/concepts/Anti-Cramming Heuristic.md - kb/concepts/Audit Trail.md - kb/concepts/BM25.md - kb/concepts/Bulk Operations.md - kb/concepts/CI Integration.md - kb/concepts/COLLECTION.md - kb/concepts/CPPC.md - kb/concepts/Checkpoint Audit.md - kb/concepts/Claude Code Auto Mode.md - kb/concepts/Command Round-Trip Integrity.md - kb/concepts/Confidence Scoring.md - kb/concepts/Consolidation Tiers.md - kb/concepts/Content Quality Control.md - kb/concepts/Context Isolation.md - kb/concepts/Contradiction Resolution.md - kb/concepts/Cross-platform Agent Skills.md - kb/concepts/Crystallization.md - kb/concepts/Delete Rather Than Anonymize.md - kb/concepts/Denylist over Allowlist.md - kb/concepts/Detect-Repair Asymmetry.md - kb/concepts/Diff-Reviewable Agent Edits.md - kb/concepts/Dual Licensing by File Plan.md - kb/concepts/Entity Extraction.md - kb/concepts/Episodic Memory.md - kb/concepts/Event-Driven Automation.md - kb/concepts/Filter on Ingest.md - kb/concepts/Forgetting.md - kb/concepts/Graph Traversal.md - kb/concepts/Green Suite Blind Spot.md - kb/concepts/Hooks.md - kb/concepts/Hybrid Search.md - kb/concepts/INDEX.md - kb/concepts/Implementation Spectrum.md - kb/concepts/Index Scaling.md - kb/concepts/Issue Label Scheme.md - kb/concepts/Iteration and Cost Limits.md - kb/concepts/KB Migration.md - kb/concepts/KB Stack Versioning.md - kb/concepts/Knowledge Compounding.md - kb/concepts/Knowledge Graph.md - kb/concepts/LLM Wiki Pattern.md - kb/concepts/Lint Workflow.md - kb/concepts/MCP-Leseserver.md - kb/concepts/Mass-Update Gate.md - kb/concepts/Memory Lifecycle.md - kb/concepts/Mesh Sync.md - kb/concepts/Modbus.md - kb/concepts/Multi-Agent Collaboration.md - kb/concepts/Naming Convention Conflict.md - kb/concepts/OKF Compatibility.md - kb/concepts/Optional Instance Context File.md - kb/concepts/Personalization Plane.md - kb/concepts/Privacy and Governance.md - kb/concepts/Procedural Memory.md - kb/concepts/Publish-Remote Gate.md - kb/concepts/Quality Scoring.md - kb/concepts/Quality and Self-Correction.md - kb/concepts/RAG.md - kb/concepts/Reciprocal Rank Fusion.md - kb/concepts/SSD TRIM.md - kb/concepts/Scale Ceiling.md - kb/concepts/Self-Healing.md - kb/concepts/Semantic Lint Automation.md - kb/concepts/Semantic Memory.md - kb/concepts/Session Orientation.md - kb/concepts/Shared vs Private.md - kb/concepts/Split Merge Reclassify.md - kb/concepts/Split Threshold.md - kb/concepts/Structural Enforcement over Documented Rule.md - kb/concepts/Stub Threshold.md - kb/concepts/Supersession.md - kb/concepts/Three-Layer Architecture.md - kb/concepts/Token Economics.md - kb/concepts/Typed Relationships.md - kb/concepts/User Management.md - kb/concepts/Vector Search.md - kb/concepts/Work Coordination.md - kb/concepts/Workflow Extraction.md - kb/concepts/Workflow Orchestration.md - kb/concepts/Working Memory.md - kb/concepts/Write-Once Frontmatter Fields.md - kb/concepts/architectures/Consolidation Tiers.md - kb/concepts/architectures/Context Isolation.md - kb/concepts/architectures/Cross-platform Agent Skills.md - kb/concepts/architectures/Episodic Memory.md - kb/concepts/architectures/Hybrid Search.md - kb/concepts/architectures/Implementation Spectrum.md - kb/concepts/architectures/Knowledge Graph.md - kb/concepts/architectures/LLM Wiki Pattern.md - kb/concepts/architectures/MCP-Leseserver.md - kb/concepts/architectures/Memory Lifecycle.md - kb/concepts/architectures/OKF Compatibility.md - kb/concepts/architectures/Optional Instance Context File.md - kb/concepts/architectures/Personalization Plane.md - kb/concepts/architectures/Procedural Memory.md - kb/concepts/architectures/RAG.md - kb/concepts/architectures/Scale Ceiling.md - kb/concepts/architectures/Semantic Memory.md - kb/concepts/architectures/Three-Layer Architecture.md - kb/concepts/architectures/Token Economics.md - kb/concepts/architectures/Working Memory.md - kb/concepts/decisions/Delete Rather Than Anonymize.md - kb/concepts/decisions/Denylist over Allowlist.md - kb/concepts/decisions/Diff-Reviewable Agent Edits.md - kb/concepts/decisions/Dual Licensing by File Plan.md - kb/concepts/decisions/Issue Label Scheme.md - kb/concepts/decisions/KB Stack Versioning.md - kb/concepts/decisions/Structural Enforcement over Documented Rule.md - kb/concepts/patterns/Audit Trail.md - kb/concepts/patterns/BM25.md - kb/concepts/patterns/Command Round-Trip Integrity.md - kb/concepts/patterns/Confidence Scoring.md - kb/concepts/patterns/Contradiction Resolution.md - kb/concepts/patterns/Entity Extraction.md - kb/concepts/patterns/Filter on Ingest.md - kb/concepts/patterns/Forgetting.md - kb/concepts/patterns/Graph Traversal.md - kb/concepts/patterns/Mesh Sync.md - kb/concepts/patterns/Quality Scoring.md - kb/concepts/patterns/Reciprocal Rank Fusion.md - kb/concepts/patterns/Self-Healing.md - kb/concepts/patterns/Shared vs Private.md - kb/concepts/patterns/Typed Relationships.md - kb/concepts/patterns/Vector Search.md - kb/concepts/patterns/Work Coordination.md - kb/concepts/problems/Ambient Environment Dependency.md - kb/concepts/problems/Detect-Repair Asymmetry.md - kb/concepts/problems/Green Suite Blind Spot.md - kb/concepts/problems/Naming Convention Conflict.md - kb/concepts/problems/Write-Once Frontmatter Fields.md - kb/concepts/protocols/CPPC.md - kb/concepts/protocols/Modbus.md - kb/concepts/protocols/SSD TRIM.md - kb/concepts/workflows/Anti-Cramming Heuristic.md - kb/concepts/workflows/Bulk Operations.md - kb/concepts/workflows/CI Integration.md - kb/concepts/workflows/Checkpoint Audit.md - kb/concepts/workflows/Claude Code Auto Mode.md - kb/concepts/workflows/Content Quality Control.md - kb/concepts/workflows/Crystallization.md - kb/concepts/workflows/Event-Driven Automation.md - kb/concepts/workflows/Hooks.md - kb/concepts/workflows/Index Scaling.md - kb/concepts/workflows/Iteration and Cost Limits.md - kb/concepts/workflows/KB Migration.md - kb/concepts/workflows/Knowledge Compounding.md - kb/concepts/workflows/Lint Workflow.md - kb/concepts/workflows/Mass-Update Gate.md - kb/concepts/workflows/Multi-Agent Collaboration.md - kb/concepts/workflows/Privacy and Governance.md - kb/concepts/workflows/Publish-Remote Gate.md - kb/concepts/workflows/Quality and Self-Correction.md - kb/concepts/workflows/Semantic Lint Automation.md - kb/concepts/workflows/Session Orientation.md - kb/concepts/workflows/Split Merge Reclassify.md - kb/concepts/workflows/Split Threshold.md - kb/concepts/workflows/Stub Threshold.md - kb/concepts/workflows/Supersession.md - kb/concepts/workflows/User Management.md - kb/concepts/workflows/Workflow Extraction.md - kb/concepts/workflows/Workflow Orchestration.md - kb/index.md - kb/log.md - tools/CONTRACT.md - tools/README.md - tools/chemenu/catalog.py - tools/chemenu/commands/index_build.py - tools/chemenu/lint_core.py - tools/chemenu/tests/conftest.py - tools/chemenu/tests/test_cite_cmd.py - tools/chemenu/tests/test_git_publish.py - tools/chemenu/tests/test_index_build.py - tools/chemenu/tests/test_lint.py - tools/chemenu/tests/test_new_page.py - tools/chemenu/tests/test_provenance.py - tools/chemenu/tests/test_type_resolver.py - tools/chemenu/tests/test_xref.py - types/concept.md - types/type-spec.md
2026-09-08 10:07:46 +02:00
parent 63b4bb82d9
commit 7f74303a00
103 changed files with 703 additions and 180 deletions
@@ -35,7 +35,7 @@ dev-checkout concern - readable here, never shipped as something to parse.

 ---

-## 4.8.0-beta.5 - 2026-09-05 - update entity naming conventions to use singular form for consistency
+## 4.8.0-beta.6 - 2026-09-08 - kb/concepts/ bekommt Areas: layout: fuer concept, Area-Titel aus jedem Type-Spec, Schwellen-Empfehlung im lint (schliesst #59)

 **Author:** Torben Nehmer

@@ -46,6 +46,7 @@ dev-checkout concern - readable here, never shipped as something to parse.
 - raw accept: incoming/ als abgeleiteter Rohablage-Eingang (schliesst #58)
 - raw accept: Stem-Eindeutigkeit im Typverzeichnis erzwingen, --replaces als einziger Weg daran vorbei (schliesst #64)
 - update entity naming conventions to use singular form for consistency
+- kb/concepts/ bekommt Areas: layout: fuer concept, Area-Titel aus jedem Type-Spec, Schwellen-Empfehlung im lint (schliesst #59)
 <!-- /wikitool:bumps -->

 Das Label `status/incoming` gibt es seit heute in Gitea: der Mensch legt einen
@@ -301,6 +302,81 @@ keine Kompatibilitätsfrage, solange sie vor `4.8.0` landet.

 Schließt #64.

+**`kb/concepts/` bekommt Areas** (#59): Sharden ist längst automatisch —
+`index_build.SHARD_THRESHOLD = 50`, hergeleitet aus der wikieigenen Seite
+`Index Scaling` — aber es passiert **pro Area**, und eine Area legt niemand an.
+`kb/concepts/` hatte keine, also war die Schwelle dort ein toter Wert: 80 Seiten
+in einer einzigen Tabelle, weit über der eigenen Grenze, ohne dass je etwas
+gefeuert hätte. Die Ursache war eine Asymmetrie in den Type-Specs — `entity`
+deklarierte ein `layout:`, `concept` nicht, obwohl das Subtype-Feld fertig dalag.
+
+`types/concept.md` deklariert es jetzt für alle sechs `concept_type`-Werte
+(`architectures/`, `patterns/`, `protocols/`, `workflows/`, `decisions/`,
+`problems/`). Für `source` bewusst **nicht**: 25 von 29 Seiten sind `notes`, die
+Aufteilung ergäbe eine Area und vier Splitter, und `kb/sources/` liegt mit 29
+Seiten ohnehin unter der Schwelle. Ein Subtype-Feld zu haben ist kein Grund, es
+als Achse zu benutzen.
+
+Zwei Dinge im Code, beide Folgen desselben Befunds. `_area_titles()` in
+`index_build.py` löste `entity` fest über `find_type_by_name("entity")` auf und
+las nur dessen `layout:` — jeder zweite Typ mit einem `layout:` hätte
+`.title()`-Namen auf dem Verzeichnisnamen bekommen statt der deklarierten Titel.
+Es liest jetzt jedes Type-Spec, und zwar **pro Collection** geschlüsselt, damit
+zwei Typen denselben Area-Namen für Verschiedenes benutzen dürfen. Und der neue
+`lint`-Befund meldet eine Collection über der Schwelle **ohne** Areas, mit der
+Verteilung ihres Subtype-Felds — als Empfehlung, nicht als Failure, und nur
+dann, wenn die Aufteilung jede entstehende Area unter die Schwelle drückt. Das
+begrenzt sich selbst in beide Richtungen: `kb/comparisons/` mit einer Seite
+feuert nie, und die schlechte Aufteilung nach `source_type` unterbleibt von
+allein, ohne dass der Check etwas über Sources wüsste.
+
+Zwei Dinge fielen unterwegs an, die das Issue nicht vorhergesehen hatte.
+`lint_core.py` durfte `SHARD_THRESHOLD`/`group_pages` nicht aus
+`commands/index_build.py` importieren — `test_api.py` prüft strukturell, dass
+`chemenu.api` kein Modul unter `chemenu.commands` lädt, und der Import hätte den
+ganzen CLI-Kopf mitgezogen. Die Gruppierung liegt deshalb neu in
+`tools/chemenu/catalog.py`, entlang derselben Linie wie `lint_core.py`:
+Korpusform hier, Darstellung dort. Und `_anchor()` strich mit `[^a-z0-9\s-]`
+jeden Nicht-ASCII-Buchstaben ersatzlos — die Karte verlinkte auf `#ablufe`,
+während die Überschrift im Shard `#abläufe` heißt. Vorher fiel das keinem auf,
+weil alle Entity-Area-Titel zufällig ASCII sind; `Abläufe` ist der erste, der es
+nicht ist.
+
+Auf dieser Instanz angewendet: `wikitool move --reconcile` hat alle 80
+Concept-Seiten in ihre Area gezogen, `migrate verify --from HEAD` bestätigt
+`182 compared, 0 added, 0 removed, 80 moved, 0 findings` — kein Titel, kein
+Body, kein Frontmatter-Feld angefasst. `index rebuild` erzeugt sechs Areas
+(Abläufe 28, Architekturen 20, Muster 17, Entscheidungen 7, Problemstellungen 5,
+Protokolle 3); keine über der Schwelle, also kein eigener Shard, und die
+Schwelle wirkt wieder als Schwelle.
+
+Geändert: `types/concept.md` (`layout:`), `types/type-spec.md` (wann ein
+`layout:` sich lohnt), `tools/chemenu/catalog.py` (neu),
+`tools/chemenu/commands/index_build.py` (`area_titles`, `_anchor`),
+`tools/chemenu/lint_core.py` (`unsharded_collections`),
+`tools/chemenu/tests/` (Fixture-Concept liegt jetzt in seiner Area, plus neun
+neue Tests), `tools/CONTRACT.md`, `tools/README.md`, `README.md`,
+`kb/concepts/COLLECTION.md`, sowie die 80 bewegten Seiten unter `kb/concepts/`.
+
+**MINOR**, nicht MAJOR: der Umzug ist ein **Angebot**, kein Zwang. Eine
+bestehende Instanz, die `move --reconcile` nicht laufen lässt, bleibt
+funktionsfähig — `group_pages` liest das Dateisystem, nicht das `layout:`, also
+landen flache Bestandsseiten in der Area „All" und neu angelegte in ihrer
+eigenen; beides rendert. Der gemischte Zustand meldet sich als `lint`-Befund
+*Misplaced Pages*, der seit jeher advisory ist. Und ein Downgrade auf einen
+Stack ohne dieses `layout:` funktioniert weiter: die Verzeichnisse bleiben
+Verzeichnisse, nur die Anzeigetitel fallen auf `.title()` zurück. Kosmetik, kein
+Bruch der Austauschbarkeit in beiden Richtungen.
+
+Schließt #59.
+
+**Nachzug an `63b4bb8`:** die Umstellung der Namenskonvention auf `HA Integration`
+hatte in `README.md` das Gegenbeispiel verloren — die Zeile las
+``Use singular for entities: `HA Integration.md` (not `HA Integration.md`)``, beide
+Seiten des „not" identisch, also eine Regel ohne Fall, an dem sie greift.
+`kb/CONVENTIONS.md` und `kb/entities/COLLECTION.md` hatten im selben Commit das
+korrekte Paar bekommen; `README.md` zieht jetzt mit `HA Integrations.md` nach.
+
 ---

 ## 4.7.4 - 2026-09-04 - bootstrap.md nennt den session-id-WARN nach frischem Bootstrap explizit als erwartet