{
  "id": "planning_engine",
  "label": "Planning Engine Canonical",
  "phase": "phase-03",
  "category": "cognitive_flow",
  "status": "ACTIVE_DH_MIRROR",
  "purpose": "Define how DEVON-DEV converts approved scope, accepted evidence, assembled prompt context and FSM constraints into a technical execution plan before any server action is allowed.",
  "function": "Build the ordered plan that declares actions, files to read, files to alter, directories to create, commands, dependencies, required tests, operational risk, rollback path and FSM gates before execution can proceed.",
  "planning_contract": {
    "requires_approved_scope": true,
    "requires_accepted_evidence": true,
    "requires_prompt_assembly_context": true,
    "requires_fsm_gate_mapping": true,
    "requires_action_order": true,
    "requires_files_to_read": true,
    "requires_files_to_alter": true,
    "requires_directories_to_create": true,
    "requires_commands": true,
    "requires_dependencies": true,
    "requires_tests": true,
    "requires_risk": true,
    "requires_rollback": true,
    "decision_authority": "NONE_FSM_DECIDES"
  },
  "technology_requirements": [
    {
      "technology": "Planning Engine",
      "required_for": "Convert approved DEVON-DEV scope and accepted context into ordered technical execution plans before file, shell, test, rollback or deploy operations.",
      "required_by_phase": "phase-03",
      "required_by_category": "planning_engine",
      "required_by_buckets": [
        "Prerequisites",
        "Installation",
        "Configuration",
        "Validation",
        "Observable Evidence",
        "Failure Modes & Recovery",
        "Completion & Promotion"
      ],
      "expected_version": "MISSING until planning schema, plan builder and FSM gate mapping exist",
      "validation_command": "MISSING until plan generation can prove ordered actions, file targets, commands, dependencies, tests, rollback and FSM gates",
      "evidence_path": "/home/yeff/public_html/devon/canon/execution/state/dh_sources/planning_engine_canonical.json",
      "status_source": "Documentation Hub + future Planning Engine records + Execution Ledger",
      "blocking_if_missing": true,
      "failure_impact": "Without Planning Engine, DEVON-DEV execution becomes a sequence of improvised commands and patches instead of a governed plan with observable gates."
    }
  ],
  "depends_on": [
    "cfc",
    "documentation_before_code",
    "requirements_scope_engine",
    "project_dependency_graph",
    "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": [
    "impact_analysis_engine",
    "attention_focus_manager",
    "goals_manager",
    "modelops_llmops",
    "benchmark_evaluation_harness",
    "observability_core",
    "execution_ledger",
    "simulation_dry_run_engine"
  ]
}