eou-diagnose

Diagnose EOU Failure

Diagnose the failure described in $target and recommend the minimum repair path.

Required reading

1. foundry/failure-taxonomy.yml — F1–F12 class definitions and repair heuristics
2. foundry/constitution.yml — invariants that constrain repair options
3. schemas/incident.schema.yml — validate the input incident report against this schema if it is a structured YAML file

Stop conditions

Halt and request clarification if:

• $target does not identify an EOU ID and one cannot be inferred from the content.
• The incident report contains no observable failure symptom — only a conclusion or label.
• foundry/failure-taxonomy.yml does not exist — failure classification cannot proceed without it.

Procedure

1. Read $target (incident report or audit finding) and extract the observable failure symptom.
2. For each symptom, classify it against the F1–F12 taxonomy. One symptom may match multiple classes — list all that apply, ranked by confidence.
3. For each classified failure, identify the minimum repair action using this precedence (smallest blast radius first):
   • schema field addition or constraint
   • validator strengthening
   • stop condition
   • regression case
   • context manifest repair
   • ECP (structural EOU change)
   • human approval gate
   • EOU split / merge / retire
4. Rule out prompt-only explanations: if the failure recurs despite correct inputs, classify as structural (F3–F12), not F1 (prompt ambiguity).
5. Write the diagnosis report.

Output

Every diagnosis produces one of two outcomes:

• Change warranted — write the diagnosis report, then use $ecp-propose to open an ECP.
• No change warranted — write a no-change record to foundry/audits/incidents/{incident_id}.no-change.yml with fields: incident_id, eou_id, diagnosis_summary, decision: no_change, rationale, reviewed_by, reviewed_at, reopen_condition.

A no-change record is not a failure of the diagnosis process. It is evidence that the system reviewed and rejected a change rather than silently ignoring the incident.