Skip to content

Documentation validation (2026-07-06)

TL;DR

Read-only agents reviewed journal history, Cloudflare Pages publishing, broad docs/ drift, and cleanup/tech debt. This branch fixed high-confidence repo drift in docs without changing runtime behavior. Remaining drift either needs live validation or belongs in a runtime/config follow-up.

Validation Scope

Area Result
Cloudflare Pages docs Updated for Node 22 tooling, Node 24 action runtime, wrangler-action@v4, and workflow trigger paths
Journal Added a 2026-07-06 check-in covering work since the 2026-07-03 Komodo audit
Wazuh docs Updated manager stack version/scope and recorded the 4.14.6 manager vs 4.14.5 agent-role drift
Host lifecycle docs Fixed stale ollama, k6-loadtest, graylog, and sqlserver2022 host-index statuses; refreshed k6-loadtest page
Runbooks Refreshed old monitoring decom, infra-services capacity, adding-service, and restore procedures

Commands Run

Command Result
uv run python scripts/lint-markdown.py --fix Passed; no lint errors after auto-fix
uv run python scripts/lint-markdown.py Passed
uv run mkdocs build --strict Passed; existing nav/anchor informational messages remain

Residual Drift / Follow-Up

  • Live validation still needed: Phoenix trace ingestion, Komodo Alerter setup, Wazuh/externals restore evidence, and IoT-to-AdGuard DNS firewall reality.
  • Runtime follow-up: decide whether to bump the wazuh-agent role default from 4.14.5 to match the 4.14.6 manager stack.
  • Generator follow-up: host index drift shows render-doc-stubs.py does not currently maintain host indexes.

Mermaid: Docs Drift Triage

flowchart LR
    A["Docs drift sweep"] --> B["Repo-proven drift"]
    A --> C["Needs live validation"]
    A --> D["Runtime follow-up"]

    B --> B1["Cloudflare Pages"]
    B --> B2["Host lifecycle"]
    B --> B3["Capacity / restore / onboarding"]

    C --> C1["Phoenix traces"]
    C --> C2["Komodo Alerter"]
    C --> C3["Restore evidence"]

    D --> D1["Wazuh agent version"]
    D --> D2["Host index generator"]