Skip to main content

Debug Fabric readiness issue

This page is a post-V1 curated runbook entry generated from the Fabric-owned runbook inventory contract. It is intentionally contract-first: owner and source truth are explicit, and unresolved gaps are recorded instead of being silently invented.

Symptom​

Fabric readiness looks unhealthy or inconsistent with the behavior operators observe from the stack.

Likely Owner​

  • Canonical owner: JaddaHelpifyr/helpifyr-fabric

First Checks​

  • Start with the canonical owner repo JaddaHelpifyr/helpifyr-fabric and confirm the reported symptom is owned there.
  • Read the owner troubleshooting or operations source before attempting any runtime mutation.
  • Collect the current readiness or deployment evidence first so recovery stays reversible and auditable.

Commands​

  • No new copy-paste-safe command bundle is admitted in this contract-first slice.
  • Use only the bounded verify or recovery commands that already exist in the listed owner source references.

Evidence​

  • Readiness or health endpoint readback for the affected surface.
  • Relevant deployment, workflow, or task evidence referenced by the owner repo runbook or troubleshooting source.

Recovery​

  • Follow the canonical owner repo path first; supporting repos only extend the investigation after owner truth is exhausted.
  • If the remaining gap list below still blocks a safe public procedure, stop and route the issue back to the owning repo instead of inventing a workaround.

Escalation​

  • Primary owner: JaddaHelpifyr/helpifyr-fabric.

Verify After Recovery​

  • Re-run the bounded owner verify path and confirm the original symptom is no longer present.
  • Only treat the incident as closed when the post-recovery readback matches the owner repo expectation.

Source Truth​

  • Fabric runbook contract: contracts/docs/public_manufacturer_docs_post_v1_runbooks_v1.json
  • Owner source: JaddaHelpifyr/helpifyr-fabric:docs/TROUBLESHOOTING.md
  • Owner source: JaddaHelpifyr/helpifyr-fabric:docs/operations/HOST_STACK_VERIFICATION.md
  • Owner source: JaddaHelpifyr/helpifyr-fabric:docs/operations/OPENCLAW_PROVIDER_VERIFICATION.md

Current Inventory Status​

  • Status: ready_for_authoring