oskar 6b85c7ef68 feat(kb): SPLIT service+runbook — 10 serwisow -> 20 dokumentow

Wzorzec mechaniczny: sekcje deploy/verify/install/testy wycinane do
kb/runbooks/<serwis>-*.md, reszta zostaje dokumentem type: service.
Wzajemne `links` w obie strony. Tresc sekcji nietknieta — przenoszone
doslownie, dodany wylacznie naglowek H1 nowego runbooka.

kb-query, paperless-worker, planner-agent, ha-diag-agent, ollama-piha,
narty27, home-assistant, ha-mcp, job-gmail-header-backfill, job-mail-body-ingest.

Weryfikacja: dla kazdego pliku multizbior niepustych linii
(main + runbook) == oryginal z HEAD. Zero zgubionych, zero dodanych.

Recon szacowal 13 splitow service+runbook; faktycznie 2-typowych jest 10,
pozostale 5 (paperless, nextcloud, gokapi, fleet-prometheus, deploy-runner)
sa 3-typowe i ida osobno jako splity wielotypowe.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-08-04 16:58:46 +02:00

1.4 KiB

Raw Blame History

okf

type

visibility

status

updated

links

0.1

service

private

active

2026-07-22

../runbooks/home-assistant-deploy.md

home-assistant (configs-as-code)

Status: phase 1 (partial). Read-only import tooling, plus a deploy (repo -> instance) write path for the api adapter's automations/scripts/ scenes scope only (scripts/ha/deploy.sh) — see "Deploy" below. Dashboards, helpers, and the docker-exec adapter have no write path yet. See DESIGN.md for the full phasing, adapter, sync, and validation model, and for the open questions still blocking phase 2/3.

Layout

services/home-assistant/
├── DESIGN.md              # decision registry — read this first
├── instances.yaml         # per-instance adapter/host/token config
├── .gitignore             # excludes secrets/db/log/token paths from every import
├── config/<instance>/     # canonical, normalized /config mirror per instance
├── storage-export/<instance>/  # curated .storage/* export (registries, dashboards)
└── fixtures/              # dated /api/states snapshots

Instances: ken (RPi4/HAOS, LAN 192.168.31.7, api adapter — canonical home instance since the 2026-07-22 cutover), ken-legacy (PIHA, container homeassistant5, docker-exec adapter, archived — pre-migration instance, import only, never deploy), chelsty-ha (Tailscale, api adapter — see instances.yaml and DESIGN.md "Incident log").

1.4 KiB Raw Blame History

home-assistant (configs-as-code)

Layout

1.4 KiB

Raw Blame History