{
  "id": "knowledge_versioning",
  "label": "Knowledge Versioning Canonical",
  "phase": "phase-08",
  "category": "memory_learning_reasoning",
  "status": "ACTIVE_DH_MIRROR",
  "purpose": "Define how DEVON-DEV versions policies, sources, promoted memories, decisions, instructions and knowledge bases.",
  "function": "Prevent stale knowledge from masquerading as truth by binding every governed knowledge item to version_id, source_id, content_hash, previous_version, active_status, supersession, freshness, FSM approval and audit evidence.",
  "versioning_contract": {
    "requires_version_id": true,
    "requires_source_id": true,
    "requires_content_hash": true,
    "requires_previous_version": true,
    "requires_active_status": true,
    "requires_promotion_state": true,
    "requires_superseded_by": true,
    "requires_freshness_state": true,
    "requires_fsm_approval": true,
    "requires_audit_evidence": true,
    "requires_git_link_for_sources_policies": true,
    "requires_database_version_record": true,
    "requires_document_hash": true,
    "versions_policies": true,
    "versions_sources": true,
    "versions_promoted_memories": true,
    "versions_decisions": true,
    "versions_instructions": true,
    "versions_knowledge_bases": true,
    "blocks_unversioned_policy_use": true,
    "blocks_stale_memory_as_truth": true,
    "blocks_unhashed_document_promotion": true,
    "blocks_unapproved_version_activation": true,
    "decision_authority": "NONE_FSM_DECIDES"
  },
  "versioned_knowledge_classes": [
    "policies",
    "sources",
    "promoted_memories",
    "decisions",
    "instructions",
    "knowledge_bases",
    "document_snapshots",
    "source_snapshots",
    "prompt_instructions",
    "fsm_rules",
    "canon_references",
    "learning_records",
    "retrieval_indexes",
    "evidence_snapshots"
  ],
  "technology_requirements": [
    {
      "technology": "Knowledge Version Registry",
      "required_for": "Define how DEVON-DEV versions policies, sources, promoted memories, decisions, instructions and knowledge bases.",
      "required_by_phase": "phase-08",
      "required_by_category": "knowledge_versioning",
      "required_by_buckets": [
        "Prerequisites",
        "Installation",
        "Configuration",
        "Validation",
        "Observable Evidence",
        "Failure Modes & Recovery",
        "Completion & Promotion"
      ],
      "expected_version": "MISSING until Knowledge Version Registry is implemented and connected to the Execution & Monitoring Panel",
      "validation_command": "MISSING until knowledge_versioning can prove source, scope, status, evidence and decision linkage",
      "evidence_path": "/home/yeff/public_html/devon/canon/execution/state/dh_sources/knowledge_versioning_canonical.json",
      "status_source": "Documentation Hub + future Execution & Monitoring Panel",
      "blocking_if_missing": true,
      "failure_impact": "Without Knowledge Version Registry, DEVON-DEV cannot distinguish active knowledge from superseded knowledge."
    }
  ],
  "depends_on": [
    "sec",
    "memory_arch",
    "knowledge_ingestion",
    "knowledge_versioning",
    "memory_lifecycle",
    "learning_gov"
  ],
  "used_by": [
    "future_execution_monitoring_panel",
    "planning_reasoning",
    "tool_execution"
  ]
}