Aller au contenu principal

Debug failed agent task

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​

An agent-owned task is stuck, rejected, or missing expected closeout evidence.

Likely Owner​

  • Canonical owner: JaddaHelpifyr/jhf-warp
  • Supporting owner: JaddaHelpifyr/jhf-pattern
  • Supporting owner: JaddaHelpifyr/jhf-reed

First Checks​

  • Start with the canonical owner repo JaddaHelpifyr/jhf-warp 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/jhf-warp.
  • Supporting owner: JaddaHelpifyr/jhf-pattern.
  • Supporting owner: JaddaHelpifyr/jhf-reed.

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/jhf-warp:docs/TROUBLESHOOTING.md
  • Owner source: JaddaHelpifyr/jhf-pattern:docs/TROUBLESHOOTING.md
  • Owner source: JaddaHelpifyr/jhf-reed:docs/TROUBLESHOOTING.md

Current Inventory Status​

  • Status: needs_owner_input

Remaining Gaps​

  • Need one canonical first-check sequence for Pattern versus Warp ownership split on stuck or rejected agent work.