repair-orchestrator

Repair Orchestrator

The escalating repair pipeline. Driven by quality.json findings.

Inputs

• workspace/{task_id}/quality.json (one or more gates failed)
• workspace/{task_id}/review.json (if independent-reviewer ran)
• state.repair_iteration (current attempt count; cap = 4)

5 escalation levels

Level 1 — SURGICAL (cheapest, fastest)
  Edit specific lines indicated by quality.json.repairs[].instruction
  Use Edit tool only (preserve everything else)
  If quality improves ≥3 score → progress; loop back at Level 1 again
  If improvement <3 → escalate to Level 2

Level 2 — SECTION-REWRITE
  Identify which section(s) most contribute to failures
  Spawn writer agent for that section with:
    - original section spec
    - failures list as "things to fix"
    - stronger constraints
  Re-run quality gates
  If still failing → escalate to Level 3

Level 3 — STAGE-REWRITE
  Rerun one whole stage of build phase:
    - If structural issues: outline-architect (revise outline)
    - If reference issues: fact-check-and-citation (verify everything again)
    - If voice issues: humanizer (with stricter settings)
  Re-run quality gates
  If still failing → escalate to Level 4

Level 4 — FULL-REGEN
  Rerun all of Phase Build (preserve research.json + angle.json + outline.json)
  Re-run quality gates
  If still failing → escalate to Level 5

Level 5 — FROM-SCRATCH
  Rerun from Plan phase:
    - Pick alternative title from angle.alternative_titles_considered
    - New outline from scratch
    - New writer agents
  Re-run quality gates
  If still failing → HALT, return best-of-N to user

Hard cap: 4 total rounds across all levels. After round 4, return whatever artifact had highest quality.json score with a documented "could not converge" message.

Decision tree

Read quality.json.repairs[] and quality.gates:

def pick_level(quality, prior_iterations, prior_level):
    # First iteration after gate fail
    if prior_iterations == 0:
        return 1  # Always start surgical
    
    # Surgical didn't improve enough
    if prior_level == 1:
        # Was improvement small?
        delta = current_score - prior_score
        if delta < 3:
            return 2  # Escalate
        return 1  # Continue surgical
    
    # Section rewrite didn't help
    if prior_level == 2:
        # How many sections needed rewrite?
        problem_sections = [s for s in sections if has_issues(s)]
        if len(problem_sections) > 3:
            return 3  # Stage-level fix
        return 2  # Try again
    
    # Stage rewrite didn't help → full regen
    if prior_level == 3:
        return 4
    
    # Full regen didn't help → from scratch
    if prior_level == 4:
        return 5