00a5d62c89
Naprawa kontraktu CLAUDE.md §Service Structure (opcja b). Migracja do KB
zabrala README z katalogow serwisow i hostow, przez co 0/26 katalogow
services/ spelnialo wymagany layout. Wskazniki przywracaja nawigacje,
nie duplikujac tresci.
31 wskaznikow, jednolity format, dokladnie 5 linii:
# <nazwa>
<jedno zdanie opisu>
Dokumentacja: [kb/...](../../kb/...)
Opis nie jest pisany od zera — wyciagany z kb-doca: pierwsze pelne zdanie
pierwszego akapitu (sklejane z zawinietych linii, ciete tylko tam, gdzie
backticki i nawiasy sa zbilansowane), a dla node'ow czlon tytulu H1 po
myslniku. Dla ha-mcp opis z H1, bo pierwszy akapit zaczyna sie od markera
statusu. Wiodace markery "**Status: ...**" sa zdejmowane.
26 x services/<svc>/README.md, 5 x hosts/<node>/README.md.
WYJATEK services/home-assistant/config/ken-legacy/README.md: pelne
ostrzezenie "historical archive, do not deploy" przywrocone doslownie
z historii (odzyskane z drzewa sprzed migracji) + link do kb-doca.
Ostrzezenie musi stac tam, gdzie chroni — w katalogu archiwum, nie tylko
w KB. Odwolanie do services/home-assistant/DESIGN.md przepiete na
kb/decisions/ha-configs-as-code.md + kb/incidents/2026-07-22-ha-dwie-instancje.md.
check_okf.py: POINTER_GLOBS + is_pointer() wykluczaja wskazniki ze scope'u
lintu. Wskazniki celowo NIE maja frontmattera OKF — to nawigacja, nie
dokumenty KB. Wykluczenie zapisane wprost, zeby poszerzenie SCOPE nie
zaczelo ich nagle walidowac.
Bez wskaznikow: hosts/chelsty-ha/ i hosts/lustro/ — nie maja dokumentow
w kb/nodes/ (luka odnotowana juz w reconie etapu 1). Utworzenie ich
wymagaloby napisania nowej dokumentacji, czyli wyjscia poza konwersje.
Lint: 190/190 ZGODNE. Weryfikacja 822 plikow: 0 martwych linkow.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
26 lines
1.2 KiB
Markdown
26 lines
1.2 KiB
Markdown
# ken-legacy — historical archive, do not deploy
|
|
|
|
This directory holds the `/config` import of the **pre-migration** Home
|
|
Assistant instance: the `homeassistant5` container on piha, wound down
|
|
2026-07. It is kept for historical reference only — e.g. recovering the
|
|
logic of an old automation — not as a live or deployable instance.
|
|
|
|
See `kb/decisions/ha-configs-as-code.md` and the incident
|
|
`kb/incidents/2026-07-22-ha-dwie-instancje.md` (2026-07-22) for
|
|
why this instance exists separately from the canonical `ken` (now the
|
|
Home Assistant OS instance on the RPi4 at 192.168.31.7): this container
|
|
kept running after the real migration and was firing automations in
|
|
parallel with the real home instance until the cutover was caught and
|
|
fixed.
|
|
|
|
**Rules for humans and agents:**
|
|
- Never run `import.sh ken-legacy` expecting a deploy target — it isn't
|
|
one. `services/home-assistant/instances.yaml` marks it `status:
|
|
archived` for this reason.
|
|
- Never write back to `homeassistant5` from this directory.
|
|
- Treat everything here as read-only history.
|
|
|
|
Archival import performed: 2026-07-22.
|
|
|
|
Dokumentacja: [kb/services/home-assistant-ken-legacy.md](../../../../kb/services/home-assistant-ken-legacy.md)
|