{
  "version": "v1.0",
  "document_role": "planning_reasoning_authority",
  "planning_modes": [
    "single_step",
    "multi_step"
  ],
  "rules": [
    "planning_must_be_bounded",
    "planning_must_be_validated",
    "planning_cannot_execute",
    "planning_requires_deterministic_gate"
  ],
  "forbidden": [
    "unbounded_reasoning",
    "execution_inside_planning",
    "planner_override_fsm"
  ],
  "canon_meta": {
    "canon_id": "devon-planning-reasoning-canonical",
    "version": "2.0.0",
    "status": "ACTIVE",
    "master_authority": "master_architecture_index.md",
    "preserve_original_content": true,
    "canonical_layer_key": "memory_layer",
    "phase_origin": [
      "phase-08"
    ],
    "installation_order": 110,
    "primary_stage": "cognition_base"
  },
  "governance_reference": {
    "master_authority": "master_architecture_index.md",
    "primary_axis": "canonical_layer",
    "secondary_axis": "deployment_order",
    "preserve_phase_registry": true,
    "preserve_original_content": true
  },
  "canonical_layer_key": "memory_layer",
  "phase_origin": [
    "phase-08"
  ],
  "installation_order": 110,
  "primary_stage": "cognition_base",
  "canonical_position": {
    "canonical_layer_key": "memory_layer",
    "phase_origin": [
      "phase-08"
    ],
    "installation_order": 110,
    "primary_stage": "cognition_base"
  },
  "id": "planning_reasoning",
  "label": "Planning Reasoning Canonical",
  "phase": "phase-08",
  "category": "memory_learning_reasoning",
  "status": "ACTIVE_DH_MIRROR",
  "purpose": "Define how DEVON-DEV plans work before tools, patches, runtime actions or learning loops execute.",
  "function": "Constrain reasoning order, planning boundaries, evidence dependency and decision handoff so the system does not improvise execution paths from incomplete context.",
  "technology_requirements": [
    {
      "technology": "Planning State Engine",
      "required_for": "Define how DEVON-DEV plans work before tools, patches, runtime actions or learning loops execute.",
      "required_by_phase": "phase-08",
      "required_by_category": "planning_reasoning",
      "required_by_buckets": [
        "Prerequisites",
        "Installation",
        "Configuration",
        "Validation",
        "Observable Evidence",
        "Failure Modes & Recovery",
        "Completion & Promotion"
      ],
      "expected_version": "MISSING until Planning State Engine is implemented and connected to the Execution & Monitoring Panel",
      "validation_command": "MISSING until planning_reasoning can prove source, scope, status, evidence and decision linkage",
      "evidence_path": "/home/yeff/public_html/devon/canon/execution/state/dh_sources/planning_reasoning_canonical.json",
      "status_source": "Documentation Hub + future Execution & Monitoring Panel",
      "blocking_if_missing": true,
      "failure_impact": "Without Planning State Engine, DEVON-DEV cannot prove why an execution sequence was chosen."
    }
  ],
  "depends_on": [
    "sec",
    "memory_arch",
    "knowledge_ingestion",
    "knowledge_versioning",
    "memory_lifecycle",
    "learning_gov"
  ],
  "used_by": [
    "future_execution_monitoring_panel",
    "planning_reasoning",
    "tool_execution"
  ]
}