Chemenu 2.1.0 - deterministischer Wissenskompiler

Chemenu kompiliert Rohnotizen zu einem verlinkten, quellengebundenen Wiki: raw/ -> types/ + tools/ -> kb/ -> reports/. Was mechanisch ist, macht tools/wikitool; was Urteil braucht, macht ein Agent unter Contracts, deren Grenzen in Code durchgesetzt sind statt im Prompt. Dieser Commit ist der Startpunkt der oeffentlichen Historie. Die vorherige Entwicklung fand in einer privaten Instanz statt und ist nicht Teil dieses Repositorys; ihre Erzaehlung steht vollstaendig in CHANGES.md, das mit 44 Eintraegen von 0.1.0 bis 2.1.0 erhalten geblieben ist. Der mitgelieferte Korpus ist ein Testbett und eine Demo: 170 Seiten ueber den Stack selbst - Gates, Lint, Versionierung, Suche, das Wiki-Muster. Er dokumentiert das Werkzeug mit den eigenen Mitteln des Werkzeugs. Lizenz: AGPL-3.0 fuer den Stack (tools/, types/), CC-BY-4.0 fuer die Inhalte. Die Grenze zwischen beiden ist der Dateiplan, den dist export berechnet - siehe NOTICE.
2026-09-01 16:24:34 +02:00
commit 18ae28f918
368 changed files with 50628 additions and 0 deletions
@@ -0,0 +1,109 @@
+---
+type: types/type-spec.md
+name: entity
+description: Basistyp für Entity-Seiten - Projekte, Systeme, Werkzeuge, Technologien oder Personen
+schema: types/entity.schema.yaml
+subtype_field: entity_type
+base_dir: entities
+page_ref_fields: [related, sources]
+layout:
+  project: {dir: projects, title: Projekte}
+  system: {dir: systems, title: Systeme}
+  tool: {dir: tools, title: Werkzeuge}
+  technology: {dir: technologies, title: Technologien}
+  person: {dir: people, title: Personen}
+---
+
+# Entity
+
+`entity` ist der Typ für konkrete Dinge: Projekte, Systeme, Werkzeuge, Technologien oder Personen. Entities sind die primären Bausteine des Wissensgraphen.
+
+## Wann zu verwenden
+
+- Darstellung eines Softwareprojekts, einer Initiative oder eines Arbeitsvorhabens
+- Dokumentation eines betriebenen Systems, Dienstes oder einer Infrastrukturkomponente
+- Beschreibung eines CLI-Werkzeugs, Hilfsprogramms oder einer Programmbibliothek
+- Festhalten von Informationen zu einer Sprache, einem Framework oder einem Protokoll
+- Dokumentation einer Person, eines Teams oder einer Organisation
+
+## Wann NICHT zu verwenden
+
+- Für abstrakte Konzepte, Muster oder Methodiken (dann `concept`)
+- Für Quelldokumente oder eingelesenes Material (dann `source`)
+- Für vergleichende Analysen (dann `comparison`)
+
+## Frontmatter
+
+| Feld | Pflicht | Verwendung |
+|---|---:|---|
+| `type` | Ja | `types/entity.md` |
+| `entity_type` | Ja | Eines von: project, system, tool, technology, person |
+| `tags` | Nein | Navigations-Tags zur Kategorisierung |
+| `created` | Ja | Erstellungsdatum (YYYY-MM-DD) |
+| `modified` | Ja | Datum der letzten Änderung (YYYY-MM-DD) |
+| `related` | Nein | Titel verwandter Seiten (Entities, Concepts, Sources) |
+| `sources` | Nein | Titel der Source-Seiten, die die Aussagen dieser Seite stützen |
+| `confidence` | Nein | Abgeleitete Konfidenz (0.0-1.0), neu berechnet von `wikitool confidence decay` |
+| `confidence_base` | Nein | Unverfallene Konfidenz zum Zeitpunkt der letzten Bestätigung - bei einer Neubewertung dieses Feld ändern, nicht `confidence` |
+| `provenance` | Ja | sourced, general oder mixed |
+| `summary` | Ja | Einzeiler für `kb/index.md` |
+
+## Autorenanweisungen
+
+- Der Titel ist der kanonische Name der Entity und folgt der etablierten Bezeichnung des Gegenstands, nicht der KB-Sprache (`kb/CONTRACT.md`, Abschnitte "Naming" und "Language")
+- Die Hauptbeschreibung steht weit oben
+- Auf verwandte Entities und Concepts verlinken, wo Beziehungen bestehen
+- Bei `provenance: sourced` oder `mixed` harte Fakten inline mit einer `[^cite-id]`-Fußnote belegen -
+  `tools/wikitool cite add --page "<Title>" --source "Source - X"` erzeugt Id und Definition
+- Wikipedia-Tonfall: sachlich, neutral, keine Werbesprache
+
+## Template
+
+```markdown
+# {name}
+
+**Typ:** {entity_type|capitalize}
+
+## Beschreibung
+
+TODO: 1-2 Absätze dazu, was diese Entity ist und wozu sie dient.
+
+## Kerndaten
+
+- **Zweck:** TODO
+- **Status:** aktiv, abgelöst, in Planung usw.
+- **Version:** TODO (falls zutreffend)
+- **Sprache/Technik:** TODO (falls zutreffend)
+- **Verantwortlich:** TODO (falls zutreffend)
+- **Repository:** TODO (falls zutreffend)
+
+## Beziehungen
+
+- **Hängt ab von:** TODO
+- **Verwendet von:** TODO
+- **Verwandt mit:** TODO
+
+## Details
+
+TODO: Ausführliche Informationen, nach sinnvollen Abschnitten gegliedert
+
+## Historie
+
+- [{today}] - Page created via wikitool
+
+## Siehe auch
+
+- TODO: Verwandte Seiten
+```
+
+`## Beziehungen` und `## Siehe auch` sind toolgeführt: `wikitool xref` schreibt in genau diese
+Abschnitte, benannt in `tools/chemenu/sections.py`. Der Wert hinter `**Typ:**` bleibt der
+englische Enum-Wert - danach filtert `search --field`.
+
+---
+
+Ergänzende Hinweise:
+
+- Entity-Seiten bilden den konkreten Bestand der Wissensbasis
+- Jeder Entity-Typ (project, system, tool usw.) ist eine Ausprägung dieses Basistyps
+- Die Beziehungen zwischen Entities tragen die Vernetzung des Wissensgraphen