From 3c9d669729ced421dbf5f50433c3f7cee800b224 Mon Sep 17 00:00:00 2001 From: Torben Nehmer Date: Sat, 19 Sep 2026 17:40:35 +0200 Subject: [PATCH] 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 --- CHANGES.md | 22 +++++++++++++ README.md | 2 +- VERSION | 2 +- instructions/kb-profiles.md | 4 +-- instructions/wiki-ingest/SKILL.md | 2 +- kb/concepts/architectures/LLM Wiki Pattern.md | 2 +- .../architectures/Three-Layer Architecture.md | 2 +- kb/entities/COLLECTION.md | 6 ++-- kb/entities/INDEX.md | 32 +++++++++---------- .../{projects => codebases}/BCDModule.md | 4 +-- .../{projects => codebases}/Chemenu.md | 4 +-- .../andybalholm-edl.md | 4 +-- .../goresponsiveness.md | 4 +-- .../{projects => codebases}/ha-core.md | 4 +-- .../{projects => codebases}/hacs-e3dc.md | 4 +-- .../hacs-integration-blueprint.md | 4 +-- .../llm-wiki-skills.md | 4 +-- .../{projects => codebases}/plugnburn-edl.md | 4 +-- .../wiki-skills-vanillaflava.md | 4 +-- .../{projects => codebases}/wiki-skills.md | 4 +-- kb/index.md | 4 +-- tools/chemenu/tests/test_type_resolver.py | 6 ++-- tools/chemenu/tests/test_types_cmd.py | 2 +- types/entity.guidance.md | 4 +-- types/entity.md | 4 +-- types/entity.schema.yaml | 2 +- 26 files changed, 81 insertions(+), 59 deletions(-) rename kb/entities/{projects => codebases}/BCDModule.md (95%) rename kb/entities/{projects => codebases}/Chemenu.md (99%) rename kb/entities/{projects => codebases}/andybalholm-edl.md (95%) rename kb/entities/{projects => codebases}/goresponsiveness.md (94%) rename kb/entities/{projects => codebases}/ha-core.md (97%) rename kb/entities/{projects => codebases}/hacs-e3dc.md (95%) rename kb/entities/{projects => codebases}/hacs-integration-blueprint.md (95%) rename kb/entities/{projects => codebases}/llm-wiki-skills.md (97%) rename kb/entities/{projects => codebases}/plugnburn-edl.md (95%) rename kb/entities/{projects => codebases}/wiki-skills-vanillaflava.md (98%) rename kb/entities/{projects => codebases}/wiki-skills.md (98%) diff --git a/CHANGES.md b/CHANGES.md index c3dd77f..a3e8b16 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -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 + + +- Entity-Subtyp project nach codebase umbenannt + + +### 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 diff --git a/README.md b/README.md index 1cf4a9d..bffd06f 100644 --- a/README.md +++ b/README.md @@ -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: diff --git a/VERSION b/VERSION index dfda3e0..6abaeb2 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -6.1.0 +6.2.0 diff --git a/instructions/kb-profiles.md b/instructions/kb-profiles.md index 2b3fd84..dc51321 100644 --- a/instructions/kb-profiles.md +++ b/instructions/kb-profiles.md @@ -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. diff --git a/instructions/wiki-ingest/SKILL.md b/instructions/wiki-ingest/SKILL.md index 54a2183..0e68186 100644 --- a/instructions/wiki-ingest/SKILL.md +++ b/instructions/wiki-ingest/SKILL.md @@ -165,7 +165,7 @@ validator complains - and the ticked list is the only record that they happened. ```bash tools/wikitool new entity --name "" \ - --set entity_type= --set provenance=sourced + --set entity_type= --set provenance=sourced ``` (`mixed` if you will also add unsourced general-knowledge context.) Then write the diff --git a/kb/concepts/architectures/LLM Wiki Pattern.md b/kb/concepts/architectures/LLM Wiki Pattern.md index 4540349..198a69b 100644 --- a/kb/concepts/architectures/LLM Wiki Pattern.md +++ b/kb/concepts/architectures/LLM Wiki Pattern.md @@ -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 diff --git a/kb/concepts/architectures/Three-Layer Architecture.md b/kb/concepts/architectures/Three-Layer Architecture.md index 6c670af..52043f1 100644 --- a/kb/concepts/architectures/Three-Layer Architecture.md +++ b/kb/concepts/architectures/Three-Layer Architecture.md @@ -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 diff --git a/kb/entities/COLLECTION.md b/kb/entities/COLLECTION.md index 2589dcd..484cd01 100644 --- a/kb/entities/COLLECTION.md +++ b/kb/entities/COLLECTION.md @@ -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 diff --git a/kb/entities/INDEX.md b/kb/entities/INDEX.md index 7314fe1..65301d4 100644 --- a/kb/entities/INDEX.md +++ b/kb/entities/INDEX.md @@ -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 | diff --git a/kb/entities/projects/BCDModule.md b/kb/entities/codebases/BCDModule.md similarity index 95% rename from kb/entities/projects/BCDModule.md rename to kb/entities/codebases/BCDModule.md index 0ab7766..6561c33 100644 --- a/kb/entities/projects/BCDModule.md +++ b/kb/entities/codebases/BCDModule.md @@ -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: [] diff --git a/kb/entities/projects/Chemenu.md b/kb/entities/codebases/Chemenu.md similarity index 99% rename from kb/entities/projects/Chemenu.md rename to kb/entities/codebases/Chemenu.md index 7a16df8..cce58a0 100644 --- a/kb/entities/projects/Chemenu.md +++ b/kb/entities/codebases/Chemenu.md @@ -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 diff --git a/kb/entities/projects/andybalholm-edl.md b/kb/entities/codebases/andybalholm-edl.md similarity index 95% rename from kb/entities/projects/andybalholm-edl.md rename to kb/entities/codebases/andybalholm-edl.md index 4ad5311..fbe4d6a 100644 --- a/kb/entities/projects/andybalholm-edl.md +++ b/kb/entities/codebases/andybalholm-edl.md @@ -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: [] diff --git a/kb/entities/projects/goresponsiveness.md b/kb/entities/codebases/goresponsiveness.md similarity index 94% rename from kb/entities/projects/goresponsiveness.md rename to kb/entities/codebases/goresponsiveness.md index 38a2e5b..de8d0b5 100644 --- a/kb/entities/projects/goresponsiveness.md +++ b/kb/entities/codebases/goresponsiveness.md @@ -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: [] diff --git a/kb/entities/projects/ha-core.md b/kb/entities/codebases/ha-core.md similarity index 97% rename from kb/entities/projects/ha-core.md rename to kb/entities/codebases/ha-core.md index 61b15e5..66acdb9 100644 --- a/kb/entities/projects/ha-core.md +++ b/kb/entities/codebases/ha-core.md @@ -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 diff --git a/kb/entities/projects/hacs-e3dc.md b/kb/entities/codebases/hacs-e3dc.md similarity index 95% rename from kb/entities/projects/hacs-e3dc.md rename to kb/entities/codebases/hacs-e3dc.md index 0ace58d..180d9c7 100644 --- a/kb/entities/projects/hacs-e3dc.md +++ b/kb/entities/codebases/hacs-e3dc.md @@ -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 diff --git a/kb/entities/projects/hacs-integration-blueprint.md b/kb/entities/codebases/hacs-integration-blueprint.md similarity index 95% rename from kb/entities/projects/hacs-integration-blueprint.md rename to kb/entities/codebases/hacs-integration-blueprint.md index 0c40950..c2875d7 100644 --- a/kb/entities/projects/hacs-integration-blueprint.md +++ b/kb/entities/codebases/hacs-integration-blueprint.md @@ -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: [] diff --git a/kb/entities/projects/llm-wiki-skills.md b/kb/entities/codebases/llm-wiki-skills.md similarity index 97% rename from kb/entities/projects/llm-wiki-skills.md rename to kb/entities/codebases/llm-wiki-skills.md index aad66f0..4cdafd4 100644 --- a/kb/entities/projects/llm-wiki-skills.md +++ b/kb/entities/codebases/llm-wiki-skills.md @@ -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] diff --git a/kb/entities/projects/plugnburn-edl.md b/kb/entities/codebases/plugnburn-edl.md similarity index 95% rename from kb/entities/projects/plugnburn-edl.md rename to kb/entities/codebases/plugnburn-edl.md index cc2ed81..bc2d8e5 100644 --- a/kb/entities/projects/plugnburn-edl.md +++ b/kb/entities/codebases/plugnburn-edl.md @@ -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 diff --git a/kb/entities/projects/wiki-skills-vanillaflava.md b/kb/entities/codebases/wiki-skills-vanillaflava.md similarity index 98% rename from kb/entities/projects/wiki-skills-vanillaflava.md rename to kb/entities/codebases/wiki-skills-vanillaflava.md index 2afb543..498187a 100644 --- a/kb/entities/projects/wiki-skills-vanillaflava.md +++ b/kb/entities/codebases/wiki-skills-vanillaflava.md @@ -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 diff --git a/kb/entities/projects/wiki-skills.md b/kb/entities/codebases/wiki-skills.md similarity index 98% rename from kb/entities/projects/wiki-skills.md rename to kb/entities/codebases/wiki-skills.md index fce07aa..96b7354 100644 --- a/kb/entities/projects/wiki-skills.md +++ b/kb/entities/codebases/wiki-skills.md @@ -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 diff --git a/kb/index.md b/kb/index.md index 00d8184..d8b9607 100644 --- a/kb/index.md +++ b/kb/index.md @@ -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) | diff --git a/tools/chemenu/tests/test_type_resolver.py b/tools/chemenu/tests/test_type_resolver.py index 3eb125c..1cf6ce4 100644 --- a/tools/chemenu/tests/test_type_resolver.py +++ b/tools/chemenu/tests/test_type_resolver.py @@ -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(): diff --git a/tools/chemenu/tests/test_types_cmd.py b/tools/chemenu/tests/test_types_cmd.py index eb0ac2e..4c5fd84 100644 --- a/tools/chemenu/tests/test_types_cmd.py +++ b/tools/chemenu/tests/test_types_cmd.py @@ -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... diff --git a/types/entity.guidance.md b/types/entity.guidance.md index 88d539f..fcc8e74 100644 --- a/types/entity.guidance.md +++ b/types/entity.guidance.md @@ -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 diff --git a/types/entity.md b/types/entity.md index 74cdaeb..8cff927 100644 --- a/types/entity.md +++ b/types/entity.md @@ -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) | diff --git a/types/entity.schema.yaml b/types/entity.schema.yaml index 79554a4..33d9161 100644 --- a/types/entity.schema.yaml +++ b/types/entity.schema.yaml @@ -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