Files

dtoro 5e3b946ded cleanup: fix all stale references across .agents/ docs

- Rewrite AGENTS.md: DB as source of truth, MCP knowledge tools, archive refs
- Fix OIKOS.md: seeds/ paths, remove Python-era notes, update deployment status
- Fix commands.md, agent-enrollment.md: archive/knowledge/ links
- Fix all SKILL.md files: remove hosts/*.yaml refs, point to inventory.yaml
- Fix HERMES.md, schema.md, page-templates.md, llm-wiki.md: update paths
- Fix bootstrap.sh: identity check reads inventory.yaml
- Fix README.md, cutover-checklist.md: stale wiki references
- Move convert-wiki.py to archive/ (one-shot done)

2026-07-07 21:00:39 +02:00

2.0 KiB

Raw Blame History

name, risk_class, inputs, verification, docs_update_checklist, transition

name

risk_class

inputs

verification

docs_update_checklist

transition

lifecycle-migrate-node

config_mutation

node_name

source_host

target_host

homelab node <name> relations (re-check blast radius); homelab service <svc> health for every hosted service

doc_page_migration_note

inventory_host_and_lan_ip

active -> migrating -> active

Lifecycle: migrate a node

Modeled on the strong Phase 1+2 migration (plans/2026-06-03_110000-library-ssd-migration-to-ludo-mini.md). Requires (ontology): preflight + backup-verified before migrating; post-verify + Caddy backends checked + mounts checked + docs updated before returning to active.

homelab change preflight <every service the node hosts> — capture current health as a baseline.
Verify backups are current for anything with data at rest on the node (see backs-up-to edges once populated).
Set state: migrating in inventory.yaml.
Perform the migration (pct/qm move, or create-on-target + data-copy + destroy-source, per the specific case).
Update inventory.yaml: new host:, lan_ip, mesh addresses for the node; update every services: entry whose backend pointed at it if the backend name itself changes (usually it doesn't — only the host:/lan_ip on the guest entry moves).
Post-verify: re-run the Week-1 drift check by hand — confirm Caddy's backend IP for each affected service matches the new lan_ip (automatic in Week 3's drift detector), confirm mounts still resolve.
homelab service <name> health for every service the node hosts.
Set state: active. Add a migration note to the node's doc page (old host/IP → new, date, phase reference) — this repo's convention for every past migration (see archive/knowledge/containers/101-jellyfin.md, containers/129-house.md).

Regenerate: python3 mcp/build_host_files.py && python3 inventory.yaml.

2.0 KiB Raw Blame History

Lifecycle: migrate a node

2.0 KiB

Raw Blame History