oskar 6f79a008f6 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:53:57 +02:00

1.2 KiB

Raw Blame History

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

1.2 KiB Raw Blame History

ken-legacy — historical archive, do not deploy

1.2 KiB

Raw Blame History