Skip to main content

jhf-loom Troubleshooting

Documentation Map​

Troubleshooting

Scope​

This page is the canonical v1.6 troubleshooting surface for jhf-loom.

It is intentionally command-first and points to bounded diagnostics instead of ad-hoc host probing.

Common Failure Classes​

Search Mandatory Gate Fails​

Symptoms:

  • readiness is red
  • search service is unhealthy or delayed

Run:

bash scripts/loom-runtime-control.sh readiness
python scripts/validate_runtime_contract.py

Verify after recovery:

bash scripts/loom-runtime-control.sh postcheck
bash scripts/loom-runtime-control.sh readiness

Runtime Materialization Drift​

Symptoms:

  • repo truth and live stack diverge
  • app readback does not match compose/runtime truth

Run:

python scripts/validate_runtime_materialization_drift.py
python scripts/validate_runtime_materialization_drift.py --host <internal-runtime-redacted> --stack-dir /home/administrator/jhf-loom-live-stack --insecure

Verify after recovery:

python scripts/validate_runtime_materialization_drift.py --host <internal-runtime-redacted> --stack-dir /home/administrator/jhf-loom-live-stack --insecure

Shared-Host Pressure / Memory Guard​

Symptoms:

  • excessive swap growth
  • low-idle profile no longer stays in the expected budget corridor

Run:

bash scripts/loom-runtime-control.sh memory-guard
python scripts/validate_live_low_idle_runtime_policy.py --insecure --idle-window-seconds 1800 --moderate-traffic-seconds 90

Verify after recovery:

bash scripts/loom-runtime-control.sh memory-guard

Run This Check​

python scripts/validate_docs_platform_v1_6.py
bash scripts/loom-runtime-control.sh diagnostics
bash scripts/loom-runtime-control.sh readiness

Supporting Deep-Dive Docs​

  • Operations
  • Runbook
  • Deploy and Verify (docs/DEPLOY_VERIFY.md)
  • Shared Host Memory Reclaim (docs/SHARED_HOST_MEMORY_RECLAIM.md)

License: AGPLv3.

Helpifyr: https://helpifyr.com