windyboy
6879d79cc6
- hass: Scribe 3.8.0 → 4.4.0（HACS jonathan-gtd/scribe，2026-09-13 随 Core 2026.9.1 / HAOS 18.2 升级）。记录 4.0 两个 breaking change 在本机均无需动作 （3.x 结构 DB + PK 在、TimescaleDB 2.29.2 已装）、配置优先级 YAML > options > entry data > 默认值、以及「YAML 改动必须重启 Core」。 - hass: 新增 stats_io_interval: 300（备份 scribe.yaml.bak-20260913-191558）。 变更前 24h scribe 自写 11 019/87 461 行（12.6%）；实测发布间隔 300s。 retention_states/retention_events 可用但刻意不设；flush_interval 仍被 entry data 钉在 5s（采用新默认 30s 需显式写 YAML）。 - pgdb: sensor_minute 2.26 GB 是压缩窗口内的正常暂存（compress_after 按 chunk 结束时间判断，09-17 才合格），稳态 4–5 GB 平台期，暂不处理；复查点 09-17 之后。顺带修正 hass/scribe 库体积事实。 校验：scripts/validate-repo.sh PASS (0 warnings)。
Runbook index
Entry point for all runbooks. Before operational work, read the repo entry
AGENTS.md and the spec RUNBOOKS.md. New
runbooks start from _template.md.
Route by intent
| Intent | Runbook | Type |
|---|---|---|
| mailcow health check | mailcow-health.md | read-only |
| mailcow update | mailcow-update.md | change (gated) |
| mailcow SMTP/IMAP client | mailcow-smtp-client.md | reference |
| Vaultwarden health check | vaultwarden-health.md | read-only |
| Vaultwarden SQLite→PG migrate | vaultwarden-sqlite-to-postgres.md | change (destructive) |
| PowerDNS health check | pdns-health.md | read-only |
| RustDesk health check | rustdesk-health.md | read-only |
| Matrix health check | matrix-health.md | read-only |
| Plane health check | plane-health.md | read-only |
| pgdb health check | pgdb-health.md | read-only |
| pgdb DB restore (pg_restore) | pgdb-restore.md | change (procedure) |
| pgdb image/compose update | pgdb-update.md | change (gated) |
| AdGuard Home health check | adguard-home-health.md | read-only |
| Host disk cleanup (logs/apt/docker) | host-disk-cleanup.md | change (gated) |
| Matter packet capture | matter-packet-capture.md | read-only |
| Home Assistant maintenance | home-assistant-maintenance.md | change (gated) |
| matrix_e2ee integration update | matrix-e2ee-update.md | change (gated) |
| Routine Ansible operations | ansible-operations.md | change (allowlisted) |
| Linear issue → mergeable change | issue-to-merge.md | delivery |
| Failing health/playbook run | fix-ci.md | change |
| Release a reviewed change to production | release.md | change (gated) |
| Roll back a change | rollback.md | change (gated) |
| Controlled network configuration | network-change.md | change (gated) |
| Network outage / service recovery | network-recovery.md | recovery |
Notes
fix-ci.md,release.md,rollback.md,network-change.md,network-recovery.mdare adapted from the upstream guide to this repo's VPS-ops context (execution layer is Ansible + SSH + Linear, not a software CI/CD pipeline).- Health runbooks are read-only; they stop (
STOP) when live state conflicts with the expected state instead of mutating production.