Keeps this page in sync as the body changes. Pause it any time for a quieter view.
Path /specs/auto-heal-from-diagnostics
Last refresh never
Auto-Heal from Diagnostics
inventory_source local | spec_api /api/spec-registry/auto-heal-from-diagnostics | registry_updated 2026-04-09T03:10:08.827226Z
potential_value 0.00 | actual_value 1.00 | value_gap 0.00
estimated_cost 0.00 | actual_cost 1.00 | cost_gap 1.00
estimated_roi 0.00 | actual_roi 1.00
Missing contributor linkage. Submit a change request with contributor attribution.
Open process view for this spec
task_ids -
branches -
source_files specs/auto-heal-from-diagnostics.md, specs/data-driven-timeout-resume.md, specs/failed-task-diagnostics-contract.md, specs/heal-completion-issue-resolution.md, specs/incident-response-and-self-healing.md, specs/smart-reap.md, specs/stale-task-reaper.md, specs/task-deduplication.md
evidence_refs -
Open implementation view for this spec
implementation_refs spec-registry:auto-heal-from-diagnostics, spec-registry:data-driven-timeout-resume, spec-registry:failed-task-diagnostics-contract, spec-registry:heal-completion-issue-resolution, spec-registry:incident-response-and-self-healing, spec-registry:smart-reap, spec-registry:stale-task-reaper, spec-registry:task-deduplication
lineage_ids -
public_endpoints -
summary **Idea**: `agent-auto-heal` (sub-idea of `coherence-network-agent-pipeline`)
process_summary Heal strategy map: Define a mapping from each error category to a heal strategy: `{category: {direction_template, executor_hint, max_retrie; Auto-heal trigger: `maybe_create_heal_task(failed_task: dict) -> dict | None` inspects a failed task, classifies its error, checks cooldown; Cooldown & retry guard: Do not create a heal task if: (a) the failed task already has a heal task (check `context.heal_task_id`), (b) the origin; Heal task context: Created heal tasks include in `context`: `{source_task_id, error_category, error_summary, retry_count, strategy_name}` f; Auto-heal stats endpoint: `GET /api/agent/auto-heal/stats` returns `{total_failed, heals_created, heal_rate, by_category: {category: {failed, heal
pseudocode_summary -
implementation_summary api/app/services/auto_heal_service.py (HEAL_STRATEGIES, generate_heal_task()); api/app/routers/agent_auto_heal_routes.py (heal task endpoints); api/app/services/agent_service_task_derive.py (heal task derivation)