build: entity_type project -> codebase rename (#122)
Files changed: - CHANGES.md - README.md - VERSION - instructions/kb-profiles.md - instructions/wiki-ingest/SKILL.md - kb/concepts/architectures/LLM Wiki Pattern.md - kb/concepts/architectures/Three-Layer Architecture.md - kb/entities/COLLECTION.md - kb/entities/INDEX.md - kb/entities/codebases/BCDModule.md - kb/entities/codebases/Chemenu.md - kb/entities/codebases/andybalholm-edl.md - kb/entities/codebases/goresponsiveness.md - kb/entities/codebases/ha-core.md - kb/entities/codebases/hacs-e3dc.md - kb/entities/codebases/hacs-integration-blueprint.md - kb/entities/codebases/llm-wiki-skills.md - kb/entities/codebases/plugnburn-edl.md - kb/entities/codebases/wiki-skills-vanillaflava.md - kb/entities/codebases/wiki-skills.md - kb/entities/projects/BCDModule.md - kb/entities/projects/Chemenu.md - kb/entities/projects/andybalholm-edl.md - kb/entities/projects/goresponsiveness.md - kb/entities/projects/ha-core.md - kb/entities/projects/hacs-e3dc.md - kb/entities/projects/hacs-integration-blueprint.md - kb/entities/projects/llm-wiki-skills.md - kb/entities/projects/plugnburn-edl.md - kb/entities/projects/wiki-skills-vanillaflava.md - kb/entities/projects/wiki-skills.md - kb/index.md - tools/chemenu/tests/test_type_resolver.py - tools/chemenu/tests/test_types_cmd.py - types/entity.guidance.md - types/entity.md - types/entity.schema.yaml
This commit is contained in:
torben committed
1 parent
11c400c670
commit
3c9d669729
26 files changed
+81
-59
No files matched your search
+22
@@ -59,6 +59,28 @@ concern - readable here, never shipped as something to parse.
|
||||
|
||||
---
|
||||
|
||||
## 6.2.0 - 2026-09-19 - Entity-Subtyp project nach codebase umbenannt
|
||||
|
||||
**Author:** Torben Nehmer
|
||||
|
||||
<!-- wikitool:bumps -->
|
||||
- Entity-Subtyp project nach codebase umbenannt
|
||||
<!-- /wikitool:bumps -->
|
||||
|
||||
### Entity-Subtyp project nach codebase umbenannt
|
||||
|
||||
`entity_type: project` bezeichnete in diesem Korpus ausnahmslos Codebasen; Gitea #119 zieht
|
||||
daraus einen eigenen Typ fuer das Vorhaben (`gtd/project`, Paket #123), wodurch der bisherige
|
||||
Wert homonym geworden waere. `types/entity.schema.yaml` und `types/entity.md` fuehren jetzt
|
||||
`codebase` statt `project`, `kb/entities/projects/` heisst `kb/entities/codebases/`, und die elf
|
||||
betroffenen Seiten wurden ausschliesslich ueber `wikitool touch`/`move` umgezogen. Kein
|
||||
Grenzuebertritt: `types/entity.md` ist `.template`-basiert, `dist upgrade` schreibt nie die
|
||||
adoptierte Kopie einer Instanz, nur den mitgelieferten Standard daneben - eine bestehende
|
||||
Instanz behaelt ihren eigenen `project`-Wert unangetastet und uebernimmt die Umbenennung erst,
|
||||
wenn sie es sich vornimmt.
|
||||
|
||||
---
|
||||
|
||||
## 6.1.0 - 2026-09-17 - Upgrade-Pfad und Iteration-Budget-Gate gehaertet, wiki/-Pfadliterale bereinigt
|
||||
|
||||
**Author:** Torben Nehmer
|
||||
|
||||
@@ -220,7 +220,7 @@ command reference.
|
||||
|
||||
## Entity Types
|
||||
|
||||
Entities are subtyped as project, system, tool, technology, or person, and each subtype has
|
||||
Entities are subtyped as codebase, system, tool, technology, or person, and each subtype has
|
||||
its own directory under `kb/entities/`. The authoritative list - and where each one is
|
||||
written - is declared by the type-spec, so ask the tool rather than a table here:
|
||||
|
||||
|
||||
@@ -128,11 +128,11 @@ want it.
|
||||
|
||||
### `entities`
|
||||
|
||||
Concrete, pointable things: projects, deployed systems, tools, technologies, people.
|
||||
Concrete, pointable things: codebases, deployed systems, tools, technologies, people.
|
||||
|
||||
- **Quality goal:** pointability plus currency - what the thing is, where it actually is, and
|
||||
whether that is still true.
|
||||
- **Areas** driven by the `entity_type:` field: `projects/`, `systems/`, `tools/`,
|
||||
- **Areas** driven by the `entity_type:` field: `codebases/`, `systems/`, `tools/`,
|
||||
`technologies/`, `people/`. Areas, not collections - they inherit the contract and carry no
|
||||
`COLLECTION.md`.
|
||||
- **Per-area emphasis** spelled out, so a system page is not written like a technology page.
|
||||
|
||||
@@ -165,7 +165,7 @@ validator complains - and the ticked list is the only record that they happened.
|
||||
|
||||
```bash
|
||||
tools/wikitool new entity --name "<Name>" \
|
||||
--set entity_type=<system|project|tool|technology|person> --set provenance=sourced
|
||||
--set entity_type=<system|codebase|tool|technology|person> --set provenance=sourced
|
||||
```
|
||||
|
||||
(`mixed` if you will also add unsourced general-knowledge context.) Then write the
|
||||
|
||||
@@ -166,7 +166,7 @@ Periodische Gesundheitsprüfung zu:
|
||||
|
||||
### Seitentypen
|
||||
- **Source-Seiten**: Zusammenfassungen aufgenommener Quellen
|
||||
- **Entity-Seiten**: Projekte, Systeme, Tools, Technologien, Menschen
|
||||
- **Entity-Seiten**: Codebasen, Systeme, Tools, Technologien, Menschen
|
||||
- **Concept-Seiten**: Architekturen, Muster, Protokolle, Workflows, Entscheidungen, Probleme
|
||||
- **Vergleichs-Seiten**: Nebeneinander-Analyse von Entities
|
||||
|
||||
|
||||
@@ -66,7 +66,7 @@ Die Three-Layer Architecture ist die strukturelle Grundlage des [[LLM Wiki Patte
|
||||
**Collections:** Ein Verzeichnis unter `kb/` ist eine Collection genau dann, wenn es eine
|
||||
`COLLECTION.md` trägt; ein Unterverzeichnis darin ist ein Bereich, der sie erbt.
|
||||
|
||||
- `kb/entities/` — Entity-Seiten (Projekte, Systeme, Tools, Technologien, Personen)
|
||||
- `kb/entities/` — Entity-Seiten (Codebasen, Systeme, Tools, Technologien, Personen)
|
||||
- `kb/concepts/` — Concept-Seiten (Architekturen, Patterns, Protokolle, Workflows)
|
||||
- `kb/sources/` — Zusammenfassungen von ingested Quellen
|
||||
- `kb/comparisons/` — Vergleichstabellen und Analysen
|
||||
|
||||
@@ -28,7 +28,7 @@ tone, relationship labels, the confidence rubric. Neither is restated here.
|
||||
|
||||
| Area | Holds |
|
||||
|------|-------|
|
||||
| `projects/` | Codebases and initiatives, named after their repository or common name |
|
||||
| `codebases/` | Codebases, named after their repository or common name |
|
||||
| `systems/` | Deployed and running systems, given a descriptive name |
|
||||
| `tools/` | CLI and desktop tools, named as the tool names itself |
|
||||
| `technologies/` | Protocols, languages, formats, in their standard spelling and capitalization |
|
||||
@@ -38,8 +38,8 @@ These are areas, not collections: they inherit this contract and carry no `COLLE
|
||||
|
||||
## Per-area emphasis
|
||||
|
||||
- **Projects** - purpose, status, language/stack, owner, repository, dependencies on other
|
||||
projects and systems, architectural decisions.
|
||||
- **Codebases** - purpose, status, language/stack, owner, repository, dependencies on other
|
||||
codebases and systems, architectural decisions.
|
||||
- **Systems** - purpose, components, dependencies, configuration locations, deployment,
|
||||
operational status, monitoring.
|
||||
- **Technologies** - purpose, use cases, trade-offs, version compatibility, which projects and
|
||||
|
||||
+16
-16
@@ -4,6 +4,22 @@
|
||||
|
||||
72 page(s). Regenerated by `wikitool index rebuild`.
|
||||
|
||||
## Codebasen
|
||||
|
||||
| Page | Type | Summary | Last Modified |
|
||||
|------|------|---------|----------------|
|
||||
| [[andybalholm-edl]] | codebase | Go-basierte EDL-Bibliothek für die Kommunikation mit eingebetteten Geräten. | 2026-09-19 |
|
||||
| [[BCDModule]] | codebase | Go-Modul, das die Entscheidungslogik für die Batterieladung umsetzt. | 2026-09-19 |
|
||||
| [[Chemenu]] | codebase | Deterministischer Wissenskompiler (raw/ -> kb/); seit 2.0.0 unter dem Namen Chemenu; Issue 26 zur Versionsstellen-Nomenklatur in 2.5.0 geschlossen | 2026-09-19 |
|
||||
| [[goresponsiveness]] | codebase | Go-Werkzeug zur Messung von Anwendungsleistung und Responsiveness. | 2026-09-19 |
|
||||
| [[ha-core]] | codebase | Kern-Integrationsbibliothek für Home-Assistant-E3DC-Systeme; stellt die E3DC-Kommunikationsprotokolle und den Home-Assistant-Integrationscode bereit. | 2026-09-19 |
|
||||
| [[hacs-e3dc]] | codebase | Home Assistant Custom Component zur Überwachung von E3DC-Energiesystemen. | 2026-09-19 |
|
||||
| [[hacs-integration-blueprint]] | codebase | Home-Assistant-Automatisierungs-Blueprints für das E3DC-Energiemanagement. | 2026-09-19 |
|
||||
| [[llm-wiki-skills]] | codebase | Plattformübergreifende LLM-Wiki-Skills von yugasun | 2026-09-19 |
|
||||
| [[plugnburn-edl]] | codebase | Go-basiertes EDL-Werkzeug zur Firmware-Programmierung eingebetteter Geräte. | 2026-09-19 |
|
||||
| [[wiki-skills]] | codebase | Umsetzung der Wiki-Skills für Claude Code von kfchou | 2026-09-19 |
|
||||
| [[wiki-skills-vanillaflava]] | codebase | Referenzimplementierung plattformübergreifender LLM-Wiki-Skills | 2026-09-19 |
|
||||
|
||||
## Personen
|
||||
|
||||
| Page | Type | Summary | Last Modified |
|
||||
@@ -13,22 +29,6 @@
|
||||
| [[Rohit Gupta]] | person | Urheber von agentmemory, einem persistenten Speicher für KI-Coding-Agenten mit über 20000 GitHub-Stars. | 2026-08-29 |
|
||||
| [[Vannevar Bush]] | person | Amerikanischer Ingenieur und Wissenschaftsadministrator, der 1945 das Memex-Konzept ersann: ein persönlicher, kuratierter Wissensspeicher mit assoziativen Dokumentpfaden. | 2026-08-29 |
|
||||
|
||||
## Projekte
|
||||
|
||||
| Page | Type | Summary | Last Modified |
|
||||
|------|------|---------|----------------|
|
||||
| [[andybalholm-edl]] | project | Go-basierte EDL-Bibliothek für die Kommunikation mit eingebetteten Geräten. | 2026-08-29 |
|
||||
| [[BCDModule]] | project | Go-Modul, das die Entscheidungslogik für die Batterieladung umsetzt. | 2026-08-29 |
|
||||
| [[Chemenu]] | project | Deterministischer Wissenskompiler (raw/ -> kb/); seit 2.0.0 unter dem Namen Chemenu; Issue 26 zur Versionsstellen-Nomenklatur in 2.5.0 geschlossen | 2026-09-02 |
|
||||
| [[goresponsiveness]] | project | Go-Werkzeug zur Messung von Anwendungsleistung und Responsiveness. | 2026-08-29 |
|
||||
| [[ha-core]] | project | Kern-Integrationsbibliothek für Home-Assistant-E3DC-Systeme; stellt die E3DC-Kommunikationsprotokolle und den Home-Assistant-Integrationscode bereit. | 2026-08-29 |
|
||||
| [[hacs-e3dc]] | project | Home Assistant Custom Component zur Überwachung von E3DC-Energiesystemen. | 2026-08-29 |
|
||||
| [[hacs-integration-blueprint]] | project | Home-Assistant-Automatisierungs-Blueprints für das E3DC-Energiemanagement. | 2026-08-29 |
|
||||
| [[llm-wiki-skills]] | project | Plattformübergreifende LLM-Wiki-Skills von yugasun | 2026-08-29 |
|
||||
| [[plugnburn-edl]] | project | Go-basiertes EDL-Werkzeug zur Firmware-Programmierung eingebetteter Geräte. | 2026-08-29 |
|
||||
| [[wiki-skills]] | project | Umsetzung der Wiki-Skills für Claude Code von kfchou | 2026-09-01 |
|
||||
| [[wiki-skills-vanillaflava]] | project | Referenzimplementierung plattformübergreifender LLM-Wiki-Skills | 2026-09-01 |
|
||||
|
||||
## Systeme
|
||||
|
||||
| Page | Type | Summary | Last Modified |
|
||||
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
type: types/entity.md
|
||||
entity_type: project
|
||||
entity_type: codebase
|
||||
tags: []
|
||||
created: 2026-08-02
|
||||
modified: 2026-08-29
|
||||
modified: 2026-09-19
|
||||
related:
|
||||
- uses: Go
|
||||
sources: []
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
type: types/entity.md
|
||||
entity_type: project
|
||||
entity_type: codebase
|
||||
tags: [wiki, llm, knowledge-base]
|
||||
created: 2026-08-04
|
||||
modified: 2026-09-17
|
||||
modified: 2026-09-19
|
||||
related:
|
||||
- implements: Personalization Plane
|
||||
- implements: Issue Label Scheme
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
type: types/entity.md
|
||||
entity_type: project
|
||||
entity_type: codebase
|
||||
tags: []
|
||||
created: 2026-08-02
|
||||
modified: 2026-08-29
|
||||
modified: 2026-09-19
|
||||
related:
|
||||
- uses: Go
|
||||
sources: []
|
||||
+2
-2
@@ -1,9 +1,9 @@
|
||||
---
|
||||
type: types/entity.md
|
||||
entity_type: project
|
||||
entity_type: codebase
|
||||
tags: []
|
||||
created: 2026-08-02
|
||||
modified: 2026-08-29
|
||||
modified: 2026-09-19
|
||||
related:
|
||||
- uses: Go
|
||||
sources: []
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
type: types/entity.md
|
||||
entity_type: project
|
||||
entity_type: codebase
|
||||
tags: [home-automation, e3dc, go, python]
|
||||
created: 2026-07-25
|
||||
modified: 2026-08-29
|
||||
modified: 2026-09-19
|
||||
related:
|
||||
- required-by: hacs-e3dc
|
||||
- required-by: hacs-integration-blueprint
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
type: types/entity.md
|
||||
entity_type: project
|
||||
entity_type: codebase
|
||||
tags: []
|
||||
created: 2026-08-02
|
||||
modified: 2026-08-29
|
||||
modified: 2026-09-19
|
||||
related:
|
||||
- depends-on: E3DC
|
||||
- uses: Go
|
||||
+2
-2
@@ -1,9 +1,9 @@
|
||||
---
|
||||
type: types/entity.md
|
||||
entity_type: project
|
||||
entity_type: codebase
|
||||
tags: []
|
||||
created: 2026-08-02
|
||||
modified: 2026-08-29
|
||||
modified: 2026-09-19
|
||||
related:
|
||||
- depends-on: ha-core
|
||||
sources: []
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
type: types/entity.md
|
||||
entity_type: project
|
||||
entity_type: codebase
|
||||
tags: [wiki, skills, cross-platform]
|
||||
created: 2026-08-04
|
||||
modified: 2026-08-29
|
||||
modified: 2026-09-19
|
||||
related:
|
||||
- see-also: Chemenu
|
||||
sources: [Source - Copilot Skill Restructure Instructions]
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
type: types/entity.md
|
||||
entity_type: project
|
||||
entity_type: codebase
|
||||
tags: []
|
||||
created: 2026-08-02
|
||||
modified: 2026-08-29
|
||||
modified: 2026-09-19
|
||||
related:
|
||||
- uses: Go
|
||||
- uses: gdeploy
|
||||
+2
-2
@@ -1,9 +1,9 @@
|
||||
---
|
||||
type: types/entity.md
|
||||
entity_type: project
|
||||
entity_type: codebase
|
||||
tags: [wiki, skills, cross-platform]
|
||||
created: 2026-08-04
|
||||
modified: 2026-09-01
|
||||
modified: 2026-09-19
|
||||
related:
|
||||
- see-also: Chemenu
|
||||
- see-also: llm-wiki-skills
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
type: types/entity.md
|
||||
entity_type: project
|
||||
entity_type: codebase
|
||||
tags: [wiki, skills, claude-code]
|
||||
created: 2026-08-04
|
||||
modified: 2026-09-01
|
||||
modified: 2026-09-19
|
||||
related:
|
||||
- see-also: Chemenu
|
||||
- see-also: wiki-skills-vanillaflava
|
||||
+2
-2
@@ -18,7 +18,7 @@ The page tables live in a generated `INDEX.md` inside each collection, linked be
|
||||
- **Concepts:** 80
|
||||
- **Entities:** 72
|
||||
- **Sources:** 29
|
||||
- **Last Updated:** 2026-09-10
|
||||
- **Last Updated:** 2026-09-19
|
||||
|
||||
---
|
||||
|
||||
@@ -46,8 +46,8 @@ The page tables live in a generated `INDEX.md` inside each collection, linked be
|
||||
|
||||
| Area | Pages | Index |
|
||||
|------|------:|-------|
|
||||
| Codebasen | 11 | [entities/INDEX.md#codebasen](entities/INDEX.md#codebasen) |
|
||||
| Personen | 4 | [entities/INDEX.md#personen](entities/INDEX.md#personen) |
|
||||
| Projekte | 11 | [entities/INDEX.md#projekte](entities/INDEX.md#projekte) |
|
||||
| Systeme | 6 | [entities/INDEX.md#systeme](entities/INDEX.md#systeme) |
|
||||
| Technologien | 20 | [entities/INDEX.md#technologien](entities/INDEX.md#technologien) |
|
||||
| Werkzeuge | 31 | [entities/INDEX.md#werkzeuge](entities/INDEX.md#werkzeuge) |
|
||||
|
||||
@@ -8,7 +8,7 @@ def test_get_enum_returns_schema_declared_values():
|
||||
"""entity_type's valid values come from entity.schema.yaml's enum - this
|
||||
is what lets config.py and new_page.py stop hand-maintaining that list."""
|
||||
values = resolver.get_enum("types/entity.md", "entity_type")
|
||||
assert values == ["project", "system", "tool", "technology", "person"]
|
||||
assert values == ["codebase", "system", "tool", "technology", "person"]
|
||||
|
||||
|
||||
def test_get_enum_shared_across_types():
|
||||
@@ -142,7 +142,7 @@ def test_get_layout_reads_entity_type_specs_own_layout_field():
|
||||
# "Language"), so it is checked for presence, not for wording: pinning the
|
||||
# words here made translating the wiki fail five unrelated tests.
|
||||
assert {key: spec["dir"] for key, spec in layout.items()} == {
|
||||
"project": "projects",
|
||||
"codebase": "codebases",
|
||||
"system": "systems",
|
||||
"tool": "tools",
|
||||
"technology": "technologies",
|
||||
@@ -150,7 +150,7 @@ def test_get_layout_reads_entity_type_specs_own_layout_field():
|
||||
}
|
||||
assert all(spec.get("title") for spec in layout.values())
|
||||
# Order drives kb/index.md section order.
|
||||
assert list(layout) == ["project", "system", "tool", "technology", "person"]
|
||||
assert list(layout) == ["codebase", "system", "tool", "technology", "person"]
|
||||
|
||||
|
||||
def test_concept_layout_covers_every_declared_concept_type():
|
||||
|
||||
@@ -41,7 +41,7 @@ def test_types_describe_entity_reports_schema_and_body():
|
||||
fields_by_name = {f["field"]: f for f in data["fields"]}
|
||||
assert fields_by_name["entity_type"]["required"] is True
|
||||
assert fields_by_name["entity_type"]["enum"] == [
|
||||
"project", "system", "tool", "technology", "person",
|
||||
"codebase", "system", "tool", "technology", "person",
|
||||
]
|
||||
assert fields_by_name["tags"]["required"] is False
|
||||
# The body must carry the page skeleton an authoring LLM works from...
|
||||
|
||||
@@ -11,7 +11,7 @@ Entities are the primary building blocks of the knowledge graph.
|
||||
|
||||
## When to use
|
||||
|
||||
- Representing a software project, an initiative or a piece of work
|
||||
- Representing a software project or codebase
|
||||
- Documenting a running system, service or infrastructure component
|
||||
- Describing a CLI tool, utility or software library
|
||||
- Recording information about a language, a framework or a protocol
|
||||
@@ -37,5 +37,5 @@ Entities are the primary building blocks of the knowledge graph.
|
||||
Relevant Notes:
|
||||
|
||||
- Entity pages form the concrete inventory of the knowledge base
|
||||
- Every entity type (project, system, tool and so on) is a variant of this base type
|
||||
- Every entity type (codebase, system, tool and so on) is a variant of this base type
|
||||
- The relationships between entities carry the knowledge graph's interconnection
|
||||
+2
-2
@@ -8,7 +8,7 @@ base_dir: entities
|
||||
page_ref_fields: [related, sources]
|
||||
guidance: types/entity.guidance.md
|
||||
layout:
|
||||
project: {dir: projects, title: Projekte}
|
||||
codebase: {dir: codebases, title: Codebasen}
|
||||
system: {dir: systems, title: Systeme}
|
||||
tool: {dir: tools, title: Werkzeuge}
|
||||
technology: {dir: technologies, title: Technologien}
|
||||
@@ -27,7 +27,7 @@ how to write a conforming page is [types/entity.guidance.md](entity.guidance.md)
|
||||
| Field | Required | Use |
|
||||
|---|---:|---|
|
||||
| `type` | Yes | `types/entity.md` |
|
||||
| `entity_type` | Yes | One of: project, system, tool, technology, person |
|
||||
| `entity_type` | Yes | One of: codebase, system, tool, technology, person |
|
||||
| `tags` | No | Navigation tags for categorization |
|
||||
| `created` | Yes | Creation date (YYYY-MM-DD) |
|
||||
| `modified` | Yes | Date last changed (YYYY-MM-DD) |
|
||||
|
||||
@@ -7,7 +7,7 @@ properties:
|
||||
description: Must reference the entity type-spec
|
||||
entity_type:
|
||||
type: string
|
||||
enum: [project, system, tool, technology, person]
|
||||
enum: [codebase, system, tool, technology, person]
|
||||
description: The specific category of entity
|
||||
tags:
|
||||
type: array
|
||||
|
||||
Reference in new issue
Block a user