{
  "id": "impact_analysis_engine",
  "label": "Impact Analysis Engine Canonical",
  "phase": "phase-03",
  "category": "cognitive_flow",
  "status": "ACTIVE_DH_MIRROR",
  "purpose": "Define how DEVON-DEV evaluates the consequence surface of a planned action before execution, testing, deployment, rollback preparation or promotion.",
  "function": "Classify planned work as NO_IMPACT, LOW_IMPACT, MEDIUM_IMPACT, HIGH_IMPACT, CRITICAL_IMPACT or UNKNOWN_IMPACT so execution cannot proceed when consequence scope is invisible, underestimated or missing approval.",
  "impact_contract": {
    "impact_states": [
      "NO_IMPACT",
      "LOW_IMPACT",
      "MEDIUM_IMPACT",
      "HIGH_IMPACT",
      "CRITICAL_IMPACT",
      "UNKNOWN_IMPACT"
    ],
    "unknown_impact_blocks_execution": true,
    "unknown_impact_requires_analysis_or_approval": true,
    "requires_dependency_context": true,
    "requires_planning_context": true,
    "requires_scope_context": true,
    "requires_validation_context": true,
    "requires_fsm_gate_mapping": true,
    "decision_authority": "NONE_FSM_DECIDES"
  },
  "technology_requirements": [
    {
      "technology": "Impact Analysis Engine",
      "required_for": "Classify the consequence level of DEVON-DEV planned actions before execution, file edits, commands, tests, deployment, rollback preparation or promotion.",
      "required_by_phase": "phase-03",
      "required_by_category": "impact_analysis_engine",
      "required_by_buckets": [
        "Prerequisites",
        "Installation",
        "Configuration",
        "Validation",
        "Observable Evidence",
        "Failure Modes & Recovery",
        "Completion & Promotion"
      ],
      "expected_version": "MISSING until impact-state schema, dependency lookup and FSM approval handoff exist",
      "validation_command": "MISSING until impact classification can prove affected files, modules, routes, services, configs, tests, rollback scope and FSM gate outcome",
      "evidence_path": "/home/yeff/public_html/devon/canon/execution/state/dh_sources/impact_analysis_engine_canonical.json",
      "status_source": "Documentation Hub + future Impact Analysis records + Project Dependency Graph + Execution Ledger",
      "blocking_if_missing": true,
      "failure_impact": "Without Impact Analysis Engine, DEVON-DEV can execute changes that look small while breaking unexamined files, routes, services, configs, tests or downstream flows."
    }
  ],
  "depends_on": [
    "cfc",
    "project_dependency_graph",
    "planning_engine",
    "requirements_scope_engine",
    "validation_matrix",
    "artifact_registry",
    "fsm_absolute_decision",
    "decision_rule_registry",
    "tool_registry",
    "prompt_governance",
    "prompt_instruction_assembly",
    "knowledge_conflict_resolver",
    "evidence_store",
    "architecture_source_registry"
  ],
  "used_by": [
    "attention_focus_manager",
    "goals_manager",
    "simulation_dry_run_engine",
    "test_validation_runner",
    "execution_ledger",
    "security_risk_engine",
    "observability_core",
    "self_monitoring"
  ]
}