oskar/homelab-codex-ws
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity
homelab-codex-ws/services/home-assistant/config/ken-legacy
History
oskar 00a5d62c89 fix(kb): README-wskazniki dla services i hosts + wyjatek ken-legacy 
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>
2026-08-04 16:58:46 +02:00
..
automations feat(ha): archival import of ken-legacy config 2026-07-22 16:49:09 +02:00
blueprints feat(ha): archival import of ken-legacy config 2026-07-22 16:49:09 +02:00
scenes feat(ha): archival import of ken-legacy config 2026-07-22 16:49:09 +02:00
scripts feat(ha): archival import of ken-legacy config 2026-07-22 16:49:09 +02:00
configuration.yaml feat(ha): archival import of ken-legacy config 2026-07-22 16:49:09 +02:00
groups.yaml feat(ha): archival import of ken-legacy config 2026-07-22 16:49:09 +02:00
known_devices.yaml feat(ha): archival import of ken-legacy config 2026-07-22 16:49:09 +02:00
README.md fix(kb): README-wskazniki dla services i hosts + wyjatek ken-legacy 2026-08-04 16:58:46 +02:00

README.md

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