Troubleshooting

Documentation Map

• Overview

• Quick Start

• Installation

• Configuration

• Operations

• Troubleshooting

• Release Notes

• Compatibility

• Channel: latest

• Source repo: JaddaHelpifyr/jhf-shuttle

Troubleshooting

Use this page as the short-entry guide. Deep runtime and operator flows remain in the existing runbooks.

Primary References

• Operations
• Runbook
• Runtime Stack Contract (docs/RUNTIME_STACK_CONTRACT.md)
• JHF Shuttle Self Stack Runbook (docs/JHF_SHUTTLE_SELF_STACK_RUNBOOK.md)
• OpenClaw Upgrade Runbook (docs/OPENCLAW_UPGRADE_RUNBOOK.md)

CLI / Package Problems

Run this check:

py -m pytest -q tests/test_cli.py tests/test_imports.py
python -m n8n_expert --help

API Runtime Problems

Run this check:

py -m pytest -q tests/test_api_server.py
python -m n8n_expert serve --help

Runtime / Port / Drift Problems

Run this check:

python scripts/check_host_port_contract.py
python scripts/verify_runtime_port_contract.py --json
python scripts/verify_runtime_port_contract.py --json --ssh-target <internal-runtime-redacted><internal-runtime-redacted>
python scripts/verify_cpu_safe_runtime_guardrails.py --json
python scripts/verify_runtime_materialization_drift.py --ssh-target <internal-runtime-redacted><internal-runtime-redacted>

Fabric Governance Consumption Drift

Run this check:

python scripts/run_fabric_contract_governance_checks.py
python scripts/check_n8n_projection_contract.py
python scripts/check_n8n_application_contract.py

Upgrade / Catalog Drift

Run this check:

py scripts/run_upgrade_freshness_checks.py
py scripts/run_release_matrix_checks.py

---

AGPLv3. Learn more at helpifyr.com.