{
  "id": "retrieval_engine",
  "label": "Retrieval Engine Canonical",
  "phase": "phase-03",
  "category": "cognitive_flow",
  "status": "ACTIVE_DH_MIRROR",
  "purpose": "Define the technical search mechanism that supplies Internal RAG with material evidence before DEVON-DEV asks a model to interpret project state.",
  "function": "Convert evidence needs into concrete searches by path, doc_id, category_id, phase_id, status, branch, text, contract, command, log and error so RAG receives retrievable material instead of vague context requests.",
  "service_target": {
    "technology": "Python Retrieval Engine",
    "mvp_location": "module_inside_devon_rag_service",
    "future_container": "devon-retrieval-engine",
    "search_modes": [
      "file_search",
      "index_search",
      "metadata_search",
      "hybrid_search"
    ],
    "material_status": "MISSING",
    "decision_authority": "NONE_FSM_DECIDES"
  },
  "technology_requirements": [
    {
      "technology": "Python Retrieval Engine",
      "required_for": "Search internal DEVON-DEV evidence by path, doc_id, category_id, phase_id, status, branch, text, contract, command, log and error before RAG context building.",
      "required_by_phase": "phase-03",
      "required_by_category": "retrieval_engine",
      "required_by_buckets": [
        "Prerequisites",
        "Installation",
        "Configuration",
        "Validation",
        "Observable Evidence",
        "Failure Modes & Recovery",
        "Completion & Promotion"
      ],
      "expected_version": "MISSING until retrieval module or service implementation exists",
      "validation_command": "MISSING until devon-rag-service exposes file search, index search, metadata search and hybrid search checks",
      "evidence_path": "/home/yeff/public_html/devon/canon/execution/state/dh_sources/retrieval_engine_canonical.json",
      "status_source": "Documentation Hub + future devon-rag-service retrieval health check + Evidence Store",
      "blocking_if_missing": true,
      "failure_impact": "Without Retrieval Engine, Internal RAG cannot locate evidence reliably and DEVON-DEV may interpret from incomplete context, stale memory or manually selected fragments."
    }
  ],
  "depends_on": [
    "cfc",
    "local_llm_runtime",
    "qwen_coder_model",
    "qwen_data_interpreter",
    "internal_rag",
    "architecture_source_registry",
    "artifact_registry",
    "validation_matrix",
    "fsm_absolute_decision"
  ],
  "used_by": [
    "embeddings_engine",
    "vector_index",
    "evidence_store",
    "knowledge_conflict_resolver",
    "prompt_governance",
    "prompt_instruction_assembly",
    "observability_core",
    "self_monitoring"
  ]
}