{
  "id": "evidence_store",
  "label": "Evidence Store Canonical",
  "phase": "phase-03",
  "category": "cognitive_flow",
  "status": "ACTIVE_DH_MIRROR",
  "purpose": "Register internal and external evidence used by DEVON-DEV so interpretation, prompt assembly, validation reasoning, recovery analysis and FSM acceptance remain auditable.",
  "function": "Persist every evidence item with source, path_or_url, timestamp, hash, excerpt, status, freshness, task usage and FSM acceptance state so DEVON-DEV can prove what material shaped a model interpretation or operational decision.",
  "evidence_record_contract": {
    "required_fields": [
      "source",
      "path_or_url",
      "timestamp",
      "hash",
      "excerpt",
      "status",
      "freshness",
      "used_by_task",
      "accepted_by_fsm"
    ],
    "internal_evidence_supported": true,
    "external_evidence_supported": true,
    "hashing_required": true,
    "fsm_acceptance_required_for_authoritative_use": true,
    "decision_authority": "NONE_FSM_DECIDES"
  },
  "service_target": {
    "technology": "Evidence Store",
    "mvp_storage": "primary_relational_database_plus_local_object_storage_volume",
    "mature_container": "devon-evidence-store",
    "components": [
      "relational_evidence_table",
      "local_object_storage",
      "evidence_hashing",
      "source_registry_link",
      "freshness_marker",
      "task_usage_link",
      "fsm_acceptance_marker"
    ],
    "material_status": "MISSING",
    "decision_authority": "NONE_FSM_DECIDES"
  },
  "technology_requirements": [
    {
      "technology": "Relational Evidence Store",
      "required_for": "Persist evidence records with source, path_or_url, timestamp, hash, excerpt, status, freshness, task usage and FSM acceptance.",
      "required_by_phase": "phase-03",
      "required_by_category": "evidence_store",
      "required_by_buckets": [
        "Prerequisites",
        "Installation",
        "Configuration",
        "Validation",
        "Observable Evidence",
        "Failure Modes & Recovery",
        "Completion & Promotion"
      ],
      "expected_version": "MISSING until database schema and evidence write/read checks exist",
      "validation_command": "MISSING until evidence insert, lookup, hash verification, freshness update and FSM acceptance marker checks exist",
      "evidence_path": "/home/yeff/public_html/devon/canon/execution/state/dh_sources/evidence_store_canonical.json",
      "status_source": "Documentation Hub + future database schema + future Evidence Store health check",
      "blocking_if_missing": true,
      "failure_impact": "Without a relational evidence store, DEVON-DEV cannot prove which evidence informed interpretation, prompt assembly, validation reasoning or FSM acceptance."
    },
    {
      "technology": "Local Object Storage Volume",
      "required_for": "Persist larger evidence excerpts, fetched pages, snapshots, reports and external captures without stuffing all material into relational rows.",
      "required_by_phase": "phase-03",
      "required_by_category": "evidence_store",
      "required_by_buckets": [
        "Installation",
        "Configuration",
        "Validation",
        "Observable Evidence",
        "Failure Modes & Recovery"
      ],
      "expected_version": "MISSING until storage path, retention rule and backup rule exist",
      "validation_command": "MISSING until object write, object read, checksum, retention and restore checks exist",
      "evidence_path": "/home/yeff/public_html/devon/canon/execution/state/dh_sources/evidence_store_canonical.json",
      "status_source": "Documentation Hub + future volume governance + future backup manager",
      "blocking_if_missing": true,
      "failure_impact": "Without local object storage, DEVON-DEV loses durable handling for fetched pages, snapshots, large excerpts and evidence attachments."
    },
    {
      "technology": "Evidence Hashing",
      "required_for": "Prove that stored evidence did not silently change after retrieval, trust classification or prompt injection.",
      "required_by_phase": "phase-03",
      "required_by_category": "evidence_store",
      "required_by_buckets": [
        "Configuration",
        "Validation",
        "Observable Evidence",
        "Failure Modes & Recovery",
        "Completion & Promotion"
      ],
      "expected_version": "MISSING until hashing algorithm and verification path are decided",
      "validation_command": "MISSING until hash generation and re-verification checks exist",
      "evidence_path": "/home/yeff/public_html/devon/canon/execution/state/dh_sources/evidence_store_canonical.json",
      "status_source": "Documentation Hub + future Evidence Store hash verification logs",
      "blocking_if_missing": true,
      "failure_impact": "Without hashing, evidence can drift after capture and DEVON-DEV cannot prove that later decisions used the same material originally observed."
    }
  ],
  "depends_on": [
    "cfc",
    "internal_rag",
    "retrieval_engine",
    "embeddings_engine",
    "vector_index",
    "external_knowledge_access",
    "source_trust_registry",
    "artifact_registry",
    "fsm_absolute_decision",
    "architecture_source_registry"
  ],
  "used_by": [
    "knowledge_conflict_resolver",
    "prompt_governance",
    "prompt_instruction_assembly",
    "modelops_llmops",
    "benchmark_evaluation_harness",
    "observability_core",
    "self_monitoring"
  ]
}
