Skip to main content

Troubleshooting

Purpose​

This page is the canonical v1.6 troubleshooting surface for jhf-selvage. 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/verify_docs_inventory.py
python scripts/export-fabric-metadata.py
python scripts/verify_fabric_oss_upgrade_consumer.py --json

Symptom Routing​

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

  • docs inventory, manifest, or source-doc drift -> JaddaHelpifyr/jhf-selvage
  • Fabric contract or consumer-adoption drift -> JaddaHelpifyr/helpifyr-fabric
  • production runtime/cutover posture -> JaddaHelpifyr/jhf-wire or JaddaHelpifyr/jhf-spindle, depending on the affected lane

Do not treat jhf-selvage as the owner for a production runtime claim unless the admission/cutover truth has been explicitly promoted.

Evidence Before Escalation​

Collect the bounded repo-owned evidence first:

python scripts/validate_docs_platform_v1_6.py
python scripts/verify_docs_inventory.py
python scripts/export-fabric-metadata.py
python scripts/verify_fabric_oss_upgrade_consumer.py --json

If the issue is about cutover, missing upstream admission, or external runtime ownership, attach this evidence bundle to the owner issue instead of widening the local slice.

Supporting Docs​

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