Skip to content

Documentation Drift Report

[!info] Auto-Generated Validation Report This report compares static documentation against live system state. Last Validated: 2026-01-17 19:22:10 UTC Pattern: Reflection (self-validation)

Validation Summary

[danger] 🔴 Documentation Drift Detected Passed: 10 | Warnings: 6 | Errors: 2

Metric Value
Total Checks 18
Passed 10
Warnings 6
Errors 2
Health Score 55% 
pie title Validation Results
    "Passed" : 10
    "Warnings" : 6
    "Errors" : 2

Detailed Findings

Errors (Immediate Action Required)

  • [Services] Service count mismatch: Documented=, Actual=77
  • [Nodes] Node count mismatch: Documented=, Actual=5
  • [Services] Documented service 'elasticsearch' not found in Swarm
  • [Services] Documented service 'logstash' not found in Swarm
  • [Services] Documented service 'mariadb' not found in Swarm
  • [Services] Documented service 'redis' not found in Swarm
  • [Services] Documented service 'prometheus' not found in Swarm
  • [Infrastructure] Docker version not documented

Passed Checks

View all passed checks - ✅ **[Services]** Service 'traefik' healthy: 1/1 - ✅ **[Storage]** Mount '/nfs_data' exists as documented - ✅ **[Storage]** Mount '/nfs_media' exists as documented - ✅ **[Storage]** Mount '/nfs_cams' exists as documented - ✅ **[Stacks]** Stack file 'stack-homenet1.yml' exists - ✅ **[Stacks]** Stack file 'stack-homenet2.yml' exists - ✅ **[Stacks]** Stack file 'stack-homenet3.yml' exists - ✅ **[Stacks]** Stack file 'stack-homenet4.yml' exists - ✅ **[Stacks]** Stack file 'stack-traefik.yml' exists - ✅ **[Freshness]** Documentation freshness acceptable (0 stale of 29 total)

Recommendations

[!danger] Action Required Documentation has significant drift from reality. Update the following: 1. Review and update service counts in 00-Index.md 2. Verify all documented services exist 3. Check NFS mount documentation accuracy 4. Run ./scripts/docs/sh-update-docs.sh to regenerate auto-generated sections

How This Works

This validation implements the Reflection agentic pattern:

  1. Read: Extracts claims from existing documentation
  2. Query: Checks claims against live system state
  3. Compare: Identifies discrepancies (drift)
  4. Report: Generates actionable findings

Validation Categories

  • Services: Service counts, status, and health
  • Nodes: Cluster node documentation accuracy
  • Storage: NFS mount and capacity documentation
  • Infrastructure: Docker version, OS, configs
  • Freshness: Document update recency

Regeneration

To manually run validation:

./scripts/docs/sh-validate-docs.sh

Generated by Homenet Agentic Documentation System Pattern: Reflection (self-validation)