Skip to main content

Troubleshooting

Purpose​

This page is the canonical v1.6 troubleshooting surface for jhf-swatch. It stays command-first and bounded, while deeper runbooks remain supporting truth.

Run This Check​

python scripts/validate_docs_platform_v1_6.py
python scripts/docs/validate_docs_inventory.py
python scripts/run_local_checks.py

Symptom Routing​

Start with the repo-owned checks above, then route by owner:

  • scenario, execution-pack, or docs drift -> JaddaHelpifyr/jhf-swatch
  • runtime, host, or container behavior -> JaddaHelpifyr/jhf-openclaw-env
  • cross-repo orchestration or mailbox/runtime execution -> owning runtime repo

Do not widen a Swatch docs-only lane into a runtime investigation without first capturing the bounded repo-owned evidence.

Evidence Before Escalation​

Collect:

python scripts/validate_docs_platform_v1_6.py
python scripts/docs/validate_docs_inventory.py
python scripts/run_local_checks.py

If the problem is runtime-only after these checks, hand off with this evidence instead of turning Swatch into a runtime owner.

Supporting Docs​

AGPLv3. See ../LICENSE (LICENSE). Learn more at helpifyr.com.