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:
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
|
## 6.1.0 - 2026-09-17 - Upgrade-Pfad und Iteration-Budget-Gate gehaertet, wiki/-Pfadliterale bereinigt
|
||||||
|
|
||||||
**Author:** Torben Nehmer
|
**Author:** Torben Nehmer
|
||||||
|
|||||||
@@ -220,7 +220,7 @@ command reference.
|
|||||||
|
|
||||||
## Entity Types
|
## 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
|
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:
|
written - is declared by the type-spec, so ask the tool rather than a table here:
|
||||||
|
|
||||||
|
|||||||
@@ -128,11 +128,11 @@ want it.
|
|||||||
|
|
||||||
### `entities`
|
### `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
|
- **Quality goal:** pointability plus currency - what the thing is, where it actually is, and
|
||||||
whether that is still true.
|
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
|
`technologies/`, `people/`. Areas, not collections - they inherit the contract and carry no
|
||||||
`COLLECTION.md`.
|
`COLLECTION.md`.
|
||||||
- **Per-area emphasis** spelled out, so a system page is not written like a technology page.
|
- **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
|
```bash
|
||||||
tools/wikitool new entity --name "<Name>" \
|
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
|
(`mixed` if you will also add unsourced general-knowledge context.) Then write the
|
||||||
|
|||||||
@@ -166,7 +166,7 @@ Periodische Gesundheitsprüfung zu:
|
|||||||
|
|
||||||
### Seitentypen
|
### Seitentypen
|
||||||
- **Source-Seiten**: Zusammenfassungen aufgenommener Quellen
|
- **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
|
- **Concept-Seiten**: Architekturen, Muster, Protokolle, Workflows, Entscheidungen, Probleme
|
||||||
- **Vergleichs-Seiten**: Nebeneinander-Analyse von Entities
|
- **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
|
**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.
|
`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/concepts/` — Concept-Seiten (Architekturen, Patterns, Protokolle, Workflows)
|
||||||
- `kb/sources/` — Zusammenfassungen von ingested Quellen
|
- `kb/sources/` — Zusammenfassungen von ingested Quellen
|
||||||
- `kb/comparisons/` — Vergleichstabellen und Analysen
|
- `kb/comparisons/` — Vergleichstabellen und Analysen
|
||||||
|
|||||||
@@ -28,7 +28,7 @@ tone, relationship labels, the confidence rubric. Neither is restated here.
|
|||||||
|
|
||||||
| Area | Holds |
|
| 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 |
|
| `systems/` | Deployed and running systems, given a descriptive name |
|
||||||
| `tools/` | CLI and desktop tools, named as the tool names itself |
|
| `tools/` | CLI and desktop tools, named as the tool names itself |
|
||||||
| `technologies/` | Protocols, languages, formats, in their standard spelling and capitalization |
|
| `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
|
## Per-area emphasis
|
||||||
|
|
||||||
- **Projects** - purpose, status, language/stack, owner, repository, dependencies on other
|
- **Codebases** - purpose, status, language/stack, owner, repository, dependencies on other
|
||||||
projects and systems, architectural decisions.
|
codebases and systems, architectural decisions.
|
||||||
- **Systems** - purpose, components, dependencies, configuration locations, deployment,
|
- **Systems** - purpose, components, dependencies, configuration locations, deployment,
|
||||||
operational status, monitoring.
|
operational status, monitoring.
|
||||||
- **Technologies** - purpose, use cases, trade-offs, version compatibility, which projects and
|
- **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`.
|
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
|
## Personen
|
||||||
|
|
||||||
| Page | Type | Summary | Last Modified |
|
| 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 |
|
| [[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 |
|
| [[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
|
## Systeme
|
||||||
|
|
||||||
| Page | Type | Summary | Last Modified |
|
| Page | Type | Summary | Last Modified |
|
||||||
|
|||||||
@@ -1,9 +1,9 @@
|
|||||||
---
|
---
|
||||||
type: types/entity.md
|
type: types/entity.md
|
||||||
entity_type: project
|
entity_type: codebase
|
||||||
tags: []
|
tags: []
|
||||||
created: 2026-08-02
|
created: 2026-08-02
|
||||||
modified: 2026-08-29
|
modified: 2026-09-19
|
||||||
related:
|
related:
|
||||||
- uses: Go
|
- uses: Go
|
||||||
sources: []
|
sources: []
|
||||||
@@ -1,9 +1,9 @@
|
|||||||
---
|
---
|
||||||
type: types/entity.md
|
type: types/entity.md
|
||||||
entity_type: project
|
entity_type: codebase
|
||||||
tags: [wiki, llm, knowledge-base]
|
tags: [wiki, llm, knowledge-base]
|
||||||
created: 2026-08-04
|
created: 2026-08-04
|
||||||
modified: 2026-09-17
|
modified: 2026-09-19
|
||||||
related:
|
related:
|
||||||
- implements: Personalization Plane
|
- implements: Personalization Plane
|
||||||
- implements: Issue Label Scheme
|
- implements: Issue Label Scheme
|
||||||
@@ -1,9 +1,9 @@
|
|||||||
---
|
---
|
||||||
type: types/entity.md
|
type: types/entity.md
|
||||||
entity_type: project
|
entity_type: codebase
|
||||||
tags: []
|
tags: []
|
||||||
created: 2026-08-02
|
created: 2026-08-02
|
||||||
modified: 2026-08-29
|
modified: 2026-09-19
|
||||||
related:
|
related:
|
||||||
- uses: Go
|
- uses: Go
|
||||||
sources: []
|
sources: []
|
||||||
+2
-2
@@ -1,9 +1,9 @@
|
|||||||
---
|
---
|
||||||
type: types/entity.md
|
type: types/entity.md
|
||||||
entity_type: project
|
entity_type: codebase
|
||||||
tags: []
|
tags: []
|
||||||
created: 2026-08-02
|
created: 2026-08-02
|
||||||
modified: 2026-08-29
|
modified: 2026-09-19
|
||||||
related:
|
related:
|
||||||
- uses: Go
|
- uses: Go
|
||||||
sources: []
|
sources: []
|
||||||
@@ -1,9 +1,9 @@
|
|||||||
---
|
---
|
||||||
type: types/entity.md
|
type: types/entity.md
|
||||||
entity_type: project
|
entity_type: codebase
|
||||||
tags: [home-automation, e3dc, go, python]
|
tags: [home-automation, e3dc, go, python]
|
||||||
created: 2026-07-25
|
created: 2026-07-25
|
||||||
modified: 2026-08-29
|
modified: 2026-09-19
|
||||||
related:
|
related:
|
||||||
- required-by: hacs-e3dc
|
- required-by: hacs-e3dc
|
||||||
- required-by: hacs-integration-blueprint
|
- required-by: hacs-integration-blueprint
|
||||||
@@ -1,9 +1,9 @@
|
|||||||
---
|
---
|
||||||
type: types/entity.md
|
type: types/entity.md
|
||||||
entity_type: project
|
entity_type: codebase
|
||||||
tags: []
|
tags: []
|
||||||
created: 2026-08-02
|
created: 2026-08-02
|
||||||
modified: 2026-08-29
|
modified: 2026-09-19
|
||||||
related:
|
related:
|
||||||
- depends-on: E3DC
|
- depends-on: E3DC
|
||||||
- uses: Go
|
- uses: Go
|
||||||
+2
-2
@@ -1,9 +1,9 @@
|
|||||||
---
|
---
|
||||||
type: types/entity.md
|
type: types/entity.md
|
||||||
entity_type: project
|
entity_type: codebase
|
||||||
tags: []
|
tags: []
|
||||||
created: 2026-08-02
|
created: 2026-08-02
|
||||||
modified: 2026-08-29
|
modified: 2026-09-19
|
||||||
related:
|
related:
|
||||||
- depends-on: ha-core
|
- depends-on: ha-core
|
||||||
sources: []
|
sources: []
|
||||||
@@ -1,9 +1,9 @@
|
|||||||
---
|
---
|
||||||
type: types/entity.md
|
type: types/entity.md
|
||||||
entity_type: project
|
entity_type: codebase
|
||||||
tags: [wiki, skills, cross-platform]
|
tags: [wiki, skills, cross-platform]
|
||||||
created: 2026-08-04
|
created: 2026-08-04
|
||||||
modified: 2026-08-29
|
modified: 2026-09-19
|
||||||
related:
|
related:
|
||||||
- see-also: Chemenu
|
- see-also: Chemenu
|
||||||
sources: [Source - Copilot Skill Restructure Instructions]
|
sources: [Source - Copilot Skill Restructure Instructions]
|
||||||
@@ -1,9 +1,9 @@
|
|||||||
---
|
---
|
||||||
type: types/entity.md
|
type: types/entity.md
|
||||||
entity_type: project
|
entity_type: codebase
|
||||||
tags: []
|
tags: []
|
||||||
created: 2026-08-02
|
created: 2026-08-02
|
||||||
modified: 2026-08-29
|
modified: 2026-09-19
|
||||||
related:
|
related:
|
||||||
- uses: Go
|
- uses: Go
|
||||||
- uses: gdeploy
|
- uses: gdeploy
|
||||||
+2
-2
@@ -1,9 +1,9 @@
|
|||||||
---
|
---
|
||||||
type: types/entity.md
|
type: types/entity.md
|
||||||
entity_type: project
|
entity_type: codebase
|
||||||
tags: [wiki, skills, cross-platform]
|
tags: [wiki, skills, cross-platform]
|
||||||
created: 2026-08-04
|
created: 2026-08-04
|
||||||
modified: 2026-09-01
|
modified: 2026-09-19
|
||||||
related:
|
related:
|
||||||
- see-also: Chemenu
|
- see-also: Chemenu
|
||||||
- see-also: llm-wiki-skills
|
- see-also: llm-wiki-skills
|
||||||
@@ -1,9 +1,9 @@
|
|||||||
---
|
---
|
||||||
type: types/entity.md
|
type: types/entity.md
|
||||||
entity_type: project
|
entity_type: codebase
|
||||||
tags: [wiki, skills, claude-code]
|
tags: [wiki, skills, claude-code]
|
||||||
created: 2026-08-04
|
created: 2026-08-04
|
||||||
modified: 2026-09-01
|
modified: 2026-09-19
|
||||||
related:
|
related:
|
||||||
- see-also: Chemenu
|
- see-also: Chemenu
|
||||||
- see-also: wiki-skills-vanillaflava
|
- 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
|
- **Concepts:** 80
|
||||||
- **Entities:** 72
|
- **Entities:** 72
|
||||||
- **Sources:** 29
|
- **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 |
|
| Area | Pages | Index |
|
||||||
|------|------:|-------|
|
|------|------:|-------|
|
||||||
|
| Codebasen | 11 | [entities/INDEX.md#codebasen](entities/INDEX.md#codebasen) |
|
||||||
| Personen | 4 | [entities/INDEX.md#personen](entities/INDEX.md#personen) |
|
| 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) |
|
| Systeme | 6 | [entities/INDEX.md#systeme](entities/INDEX.md#systeme) |
|
||||||
| Technologien | 20 | [entities/INDEX.md#technologien](entities/INDEX.md#technologien) |
|
| Technologien | 20 | [entities/INDEX.md#technologien](entities/INDEX.md#technologien) |
|
||||||
| Werkzeuge | 31 | [entities/INDEX.md#werkzeuge](entities/INDEX.md#werkzeuge) |
|
| 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
|
"""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."""
|
is what lets config.py and new_page.py stop hand-maintaining that list."""
|
||||||
values = resolver.get_enum("types/entity.md", "entity_type")
|
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():
|
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
|
# "Language"), so it is checked for presence, not for wording: pinning the
|
||||||
# words here made translating the wiki fail five unrelated tests.
|
# words here made translating the wiki fail five unrelated tests.
|
||||||
assert {key: spec["dir"] for key, spec in layout.items()} == {
|
assert {key: spec["dir"] for key, spec in layout.items()} == {
|
||||||
"project": "projects",
|
"codebase": "codebases",
|
||||||
"system": "systems",
|
"system": "systems",
|
||||||
"tool": "tools",
|
"tool": "tools",
|
||||||
"technology": "technologies",
|
"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())
|
assert all(spec.get("title") for spec in layout.values())
|
||||||
# Order drives kb/index.md section order.
|
# 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():
|
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"]}
|
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"]["required"] is True
|
||||||
assert fields_by_name["entity_type"]["enum"] == [
|
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
|
assert fields_by_name["tags"]["required"] is False
|
||||||
# The body must carry the page skeleton an authoring LLM works from...
|
# 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
|
## 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
|
- Documenting a running system, service or infrastructure component
|
||||||
- Describing a CLI tool, utility or software library
|
- Describing a CLI tool, utility or software library
|
||||||
- Recording information about a language, a framework or a protocol
|
- 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:
|
Relevant Notes:
|
||||||
|
|
||||||
- Entity pages form the concrete inventory of the knowledge base
|
- 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
|
- The relationships between entities carry the knowledge graph's interconnection
|
||||||
+2
-2
@@ -8,7 +8,7 @@ base_dir: entities
|
|||||||
page_ref_fields: [related, sources]
|
page_ref_fields: [related, sources]
|
||||||
guidance: types/entity.guidance.md
|
guidance: types/entity.guidance.md
|
||||||
layout:
|
layout:
|
||||||
project: {dir: projects, title: Projekte}
|
codebase: {dir: codebases, title: Codebasen}
|
||||||
system: {dir: systems, title: Systeme}
|
system: {dir: systems, title: Systeme}
|
||||||
tool: {dir: tools, title: Werkzeuge}
|
tool: {dir: tools, title: Werkzeuge}
|
||||||
technology: {dir: technologies, title: Technologien}
|
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 |
|
| Field | Required | Use |
|
||||||
|---|---:|---|
|
|---|---:|---|
|
||||||
| `type` | Yes | `types/entity.md` |
|
| `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 |
|
| `tags` | No | Navigation tags for categorization |
|
||||||
| `created` | Yes | Creation date (YYYY-MM-DD) |
|
| `created` | Yes | Creation date (YYYY-MM-DD) |
|
||||||
| `modified` | Yes | Date last changed (YYYY-MM-DD) |
|
| `modified` | Yes | Date last changed (YYYY-MM-DD) |
|
||||||
|
|||||||
@@ -7,7 +7,7 @@ properties:
|
|||||||
description: Must reference the entity type-spec
|
description: Must reference the entity type-spec
|
||||||
entity_type:
|
entity_type:
|
||||||
type: string
|
type: string
|
||||||
enum: [project, system, tool, technology, person]
|
enum: [codebase, system, tool, technology, person]
|
||||||
description: The specific category of entity
|
description: The specific category of entity
|
||||||
tags:
|
tags:
|
||||||
type: array
|
type: array
|
||||||
|
|||||||
Reference in new issue
Block a user