{
  "retrieval_policy_manifest_id": "FAMILYCASE-AI-RETRIEVAL-POLICY-MANIFEST-001",
  "generated_at": "2026-06-09T03:44:47.111Z",
  "brand": "FamilyCase.AI",
  "status": "retrieval_policy_ready_local_enforcement_spec_only",
  "production_customer_launch": "no_go",
  "vector_store_manifest_id": "FAMILYCASE-AI-VECTOR-STORE-MANIFEST-001",
  "semantic_chunk_registry_id": "FAMILYCASE-AI-SEMANTIC-CHUNK-REGISTRY-001",
  "knowledge_graph_seed_id": "FAMILYCASE-AI-KNOWLEDGE-GRAPH-SEED-001",
  "control_plane_register_id": "FAMILYCASE-AI-CORPORATE-CONTROL-PLANE-REGISTER-001",
  "owner_task_queue_index_id": "FAMILYCASE-AI-OWNER-TASK-QUEUE-INDEX-001",
  "enforcement_model": {
    "default_deny": true,
    "rbac_required": true,
    "abac_required": true,
    "rebac_supported": true,
    "retrieval_time_authorization_required": true,
    "prompt_only_authorization_allowed": false,
    "post_generation_filtering_only_allowed": false
  },
  "global_retrieval_sequence": {
    "graph_lookup_first": true,
    "vector_retrieval_second": true,
    "metadata_filtering_required": true,
    "source_validation_required": true,
    "confidence_scoring_required": true,
    "tenant_isolation_required": true
  },
  "data_classification_rules": [
    {
      "classification": "public_governance",
      "allowed": true,
      "examples": [
        "operating-system docs",
        "public registry JSON",
        "public dashboard JSON"
      ]
    },
    {
      "classification": "internal_governance",
      "allowed": true,
      "examples": [
        "local reports",
        "owner worksheets",
        "risk mitigation plans"
      ]
    },
    {
      "classification": "customer_confidential",
      "allowed": false,
      "examples": [
        "case facts",
        "client names",
        "matter numbers",
        "uploaded evidence"
      ]
    }
  ],
  "agent_policies": [
    {
      "agent_role": "chief_knowledge_officer_agent",
      "allowed_stores": [
        "governance_knowledge_store",
        "knowledge_architecture_store",
        "agent_workforce_knowledge_store"
      ],
      "decision_ceiling": 2,
      "purpose": "Knowledge governance, retrieval quality, source lineage, and knowledge architecture recommendations.",
      "mandatory_filters": [
        "source_path",
        "retrieval_tags",
        "confidence",
        "data_classification"
      ],
      "retrieval_sequence": [
        "knowledge_graph_lookup",
        "vector_candidate_retrieval",
        "metadata_filtering",
        "source_validation",
        "confidence_scoring"
      ],
      "blocked_actions": [
        "access_customer_data",
        "connect_live_system",
        "generate_embeddings",
        "write_external_ticket",
        "send_notification",
        "approve_production_launch",
        "accept_risk"
      ],
      "audit_required": true,
      "tenant_isolation_required": true,
      "human_review_required_above_tier": 2
    },
    {
      "agent_role": "program_management_office_agent",
      "allowed_stores": [
        "governance_knowledge_store",
        "agent_workforce_knowledge_store"
      ],
      "decision_ceiling": 1,
      "purpose": "Portfolio tracking, initiative queue review, and local execution status reporting.",
      "mandatory_filters": [
        "source_path",
        "retrieval_tags",
        "confidence",
        "data_classification"
      ],
      "retrieval_sequence": [
        "knowledge_graph_lookup",
        "vector_candidate_retrieval",
        "metadata_filtering",
        "source_validation",
        "confidence_scoring"
      ],
      "blocked_actions": [
        "access_customer_data",
        "connect_live_system",
        "generate_embeddings",
        "write_external_ticket",
        "send_notification",
        "approve_production_launch",
        "accept_risk"
      ],
      "audit_required": true,
      "tenant_isolation_required": true,
      "human_review_required_above_tier": 1
    },
    {
      "agent_role": "chief_operating_agent",
      "allowed_stores": [
        "governance_knowledge_store",
        "agent_workforce_knowledge_store"
      ],
      "decision_ceiling": 2,
      "purpose": "Operating rhythm, dashboard rollups, resource allocation recommendations, and process optimization.",
      "mandatory_filters": [
        "source_path",
        "retrieval_tags",
        "confidence",
        "data_classification"
      ],
      "retrieval_sequence": [
        "knowledge_graph_lookup",
        "vector_candidate_retrieval",
        "metadata_filtering",
        "source_validation",
        "confidence_scoring"
      ],
      "blocked_actions": [
        "access_customer_data",
        "connect_live_system",
        "generate_embeddings",
        "write_external_ticket",
        "send_notification",
        "approve_production_launch",
        "accept_risk"
      ],
      "audit_required": true,
      "tenant_isolation_required": true,
      "human_review_required_above_tier": 2
    },
    {
      "agent_role": "chief_content_officer_agent",
      "allowed_stores": [
        "governance_knowledge_store",
        "growth_revenue_knowledge_store"
      ],
      "decision_ceiling": 1,
      "purpose": "Documentation, education, content coverage, and local content operations planning.",
      "mandatory_filters": [
        "source_path",
        "retrieval_tags",
        "confidence",
        "data_classification"
      ],
      "retrieval_sequence": [
        "knowledge_graph_lookup",
        "vector_candidate_retrieval",
        "metadata_filtering",
        "source_validation",
        "confidence_scoring"
      ],
      "blocked_actions": [
        "access_customer_data",
        "connect_live_system",
        "generate_embeddings",
        "write_external_ticket",
        "send_notification",
        "approve_production_launch",
        "accept_risk"
      ],
      "audit_required": true,
      "tenant_isolation_required": true,
      "human_review_required_above_tier": 1
    },
    {
      "agent_role": "chief_revenue_agent",
      "allowed_stores": [
        "governance_knowledge_store",
        "growth_revenue_knowledge_store"
      ],
      "decision_ceiling": 2,
      "purpose": "Revenue attribution, growth analytics, forecast support, and ROI recommendations.",
      "mandatory_filters": [
        "source_path",
        "retrieval_tags",
        "confidence",
        "data_classification"
      ],
      "retrieval_sequence": [
        "knowledge_graph_lookup",
        "vector_candidate_retrieval",
        "metadata_filtering",
        "source_validation",
        "confidence_scoring"
      ],
      "blocked_actions": [
        "access_customer_data",
        "connect_live_system",
        "generate_embeddings",
        "write_external_ticket",
        "send_notification",
        "approve_production_launch",
        "accept_risk"
      ],
      "audit_required": true,
      "tenant_isolation_required": true,
      "human_review_required_above_tier": 2
    },
    {
      "agent_role": "chief_security_agent",
      "allowed_stores": [
        "governance_knowledge_store",
        "knowledge_architecture_store",
        "agent_workforce_knowledge_store"
      ],
      "decision_ceiling": 2,
      "purpose": "Security, access control, audit, risk, and compliance boundary review.",
      "mandatory_filters": [
        "source_path",
        "retrieval_tags",
        "confidence",
        "data_classification"
      ],
      "retrieval_sequence": [
        "knowledge_graph_lookup",
        "vector_candidate_retrieval",
        "metadata_filtering",
        "source_validation",
        "confidence_scoring"
      ],
      "blocked_actions": [
        "access_customer_data",
        "connect_live_system",
        "generate_embeddings",
        "write_external_ticket",
        "send_notification",
        "approve_production_launch",
        "accept_risk"
      ],
      "audit_required": true,
      "tenant_isolation_required": true,
      "human_review_required_above_tier": 2
    }
  ],
  "source_validation_scorecards": {
    "chunk_sources": {
      "scorecard_id": "FAMILYCASE-AI-CHUNK-SOURCE-VALIDATION-SCORECARD-001",
      "status": "passed_static_local_sources",
      "validation_scope": "semantic_chunk_registry",
      "source_count": 10,
      "chunk_count": 440,
      "verified_source_count": 10,
      "missing_source_count": 0,
      "missing_sources": [],
      "duplicate_chunk_id_count": 0,
      "duplicate_chunk_ids": [],
      "chunks_missing_lineage_count": 0,
      "chunks_missing_retrieval_tags_count": 0,
      "chunks_missing_confidence_count": 0,
      "chunks_missing_text_preview_count": 0,
      "minimum_source_lineage_confidence": 1,
      "required_controls": [
        "source_path_exists",
        "source_lineage_matches_chunk_source",
        "retrieval_tags_present",
        "confidence_present",
        "text_preview_present",
        "duplicate_chunk_ids_blocked"
      ],
      "no_side_effects": true
    },
    "graph_node_sources": {
      "scorecard_id": "FAMILYCASE-AI-GRAPH-NODE-SOURCE-VALIDATION-SCORECARD-001",
      "status": "passed_static_local_sources",
      "validation_scope": "knowledge_graph_nodes",
      "knowledge_graph_seed_id": "FAMILYCASE-AI-KNOWLEDGE-GRAPH-SEED-001",
      "node_count": 53,
      "source_count": 26,
      "verified_source_count": 26,
      "missing_source_count": 0,
      "missing_sources": [],
      "duplicate_node_id_count": 0,
      "duplicate_node_ids": [],
      "nodes_missing_source_count": 0,
      "nodes_missing_confidence_count": 0,
      "nodes_missing_label_count": 0,
      "minimum_node_confidence": 1,
      "required_controls": [
        "node_source_exists",
        "node_label_present",
        "node_confidence_present",
        "duplicate_node_ids_blocked",
        "generated_artifact_sources_explicit"
      ],
      "no_side_effects": true
    }
  },
  "retrieval_simulation_tests": [
    {
      "simulation_id": "RETRIEVAL-SIM-ALLOW-001",
      "name": "Allow public governance retrieval for authorized knowledge agent",
      "agent_role": "chief_knowledge_officer_agent",
      "requested_store": "knowledge_architecture_store",
      "data_classification": "public_governance",
      "requested_action": "retrieve_governance_source",
      "decision_tier": 1,
      "expected_decision": "allow",
      "expected_reason": "Agent is authorized for the requested store, classification is allowed, and decision tier is within ceiling.",
      "actual_decision": "allow",
      "passed": true,
      "no_side_effects": true
    },
    {
      "simulation_id": "RETRIEVAL-SIM-ALLOW-002",
      "name": "Allow internal governance retrieval for authorized security agent",
      "agent_role": "chief_security_agent",
      "requested_store": "governance_knowledge_store",
      "data_classification": "internal_governance",
      "requested_action": "retrieve_risk_control_source",
      "decision_tier": 2,
      "expected_decision": "allow",
      "expected_reason": "Security agent is authorized for governance retrieval and internal governance material is allowed for local review.",
      "actual_decision": "allow",
      "passed": true,
      "no_side_effects": true
    },
    {
      "simulation_id": "RETRIEVAL-SIM-DENY-001",
      "name": "Deny customer-confidential retrieval",
      "agent_role": "chief_knowledge_officer_agent",
      "requested_store": "governance_knowledge_store",
      "data_classification": "customer_confidential",
      "requested_action": "retrieve_case_fact",
      "decision_tier": 1,
      "expected_decision": "deny",
      "expected_reason": "Customer-confidential data is denied by classification rule regardless of agent role.",
      "actual_decision": "deny",
      "passed": true,
      "no_side_effects": true
    },
    {
      "simulation_id": "RETRIEVAL-SIM-DENY-002",
      "name": "Deny unauthorized store access",
      "agent_role": "chief_content_officer_agent",
      "requested_store": "knowledge_architecture_store",
      "data_classification": "public_governance",
      "requested_action": "retrieve_architecture_source",
      "decision_tier": 1,
      "expected_decision": "deny",
      "expected_reason": "Content agent is not authorized for the requested knowledge architecture store.",
      "actual_decision": "deny",
      "passed": true,
      "no_side_effects": true
    },
    {
      "simulation_id": "RETRIEVAL-SIM-DENY-003",
      "name": "Deny blocked live-system action",
      "agent_role": "chief_operating_agent",
      "requested_store": "governance_knowledge_store",
      "data_classification": "internal_governance",
      "requested_action": "connect_live_system",
      "decision_tier": 1,
      "expected_decision": "deny",
      "expected_reason": "Live-system connection is a blocked action in every local retrieval policy.",
      "actual_decision": "deny",
      "passed": true,
      "no_side_effects": true
    },
    {
      "simulation_id": "RETRIEVAL-SIM-DENY-004",
      "name": "Deny embedding generation action",
      "agent_role": "chief_knowledge_officer_agent",
      "requested_store": "knowledge_architecture_store",
      "data_classification": "public_governance",
      "requested_action": "generate_embeddings",
      "decision_tier": 1,
      "expected_decision": "deny",
      "expected_reason": "Embedding generation is blocked until provider, security, privacy, cost, rollback, and tenant isolation approvals are accepted.",
      "actual_decision": "deny",
      "passed": true,
      "no_side_effects": true
    },
    {
      "simulation_id": "RETRIEVAL-SIM-DENY-005",
      "name": "Deny production launch approval action",
      "agent_role": "chief_revenue_agent",
      "requested_store": "growth_revenue_knowledge_store",
      "data_classification": "internal_governance",
      "requested_action": "approve_production_launch",
      "decision_tier": 2,
      "expected_decision": "deny",
      "expected_reason": "Retrieval agents cannot approve production launch.",
      "actual_decision": "deny",
      "passed": true,
      "no_side_effects": true
    },
    {
      "simulation_id": "RETRIEVAL-SIM-REVIEW-001",
      "name": "Require human review above decision ceiling",
      "agent_role": "program_management_office_agent",
      "requested_store": "governance_knowledge_store",
      "data_classification": "internal_governance",
      "requested_action": "retrieve_governance_source",
      "decision_tier": 2,
      "expected_decision": "human_review_required",
      "expected_reason": "Requested decision tier exceeds the agent decision ceiling.",
      "actual_decision": "human_review_required",
      "passed": true,
      "no_side_effects": true
    }
  ],
  "store_coverage": [
    {
      "store_id": "governance_knowledge_store",
      "permitted_agent_count": 6
    },
    {
      "store_id": "agent_workforce_knowledge_store",
      "permitted_agent_count": 4
    },
    {
      "store_id": "growth_revenue_knowledge_store",
      "permitted_agent_count": 2
    },
    {
      "store_id": "knowledge_architecture_store",
      "permitted_agent_count": 2
    }
  ],
  "audit_event_schema": [
    "request_id",
    "agent_role",
    "query_purpose",
    "allowed_stores",
    "metadata_filters",
    "source_ids",
    "confidence_score",
    "decision_tier",
    "blocked_actions_checked",
    "timestamp"
  ],
  "no_side_effects_boundary": "This retrieval policy is a local enforcement specification only. It does not grant credentials, connect stores, retrieve data, generate embeddings, run agents, approve actions, or skip required human review.",
  "source_evidence": [
    "public/vector-store-manifest.json",
    "public/semantic-chunk-registry.json",
    "public/knowledge-graph-seed.json",
    "public/corporate-control-plane-register.json",
    "public/owner-task-queue-index.json",
    "docs/knowledge-graph-rag-operating-system.md",
    "docs/agent-governance-workforce-operating-system.md"
  ]
}
