{
  "schema": "backend_managed_enrichment_routing_v01",
  "issue": 431,
  "parent_issue": 428,
  "status": "deterministic_backend_managed_routing",
  "artifact_path": "docs/product-architecture/backend_managed_enrichment_routing_v01.json",
  "document_path": "docs/product-architecture/backend_managed_enrichment_routing_v01.md",
  "registry_artifact": "docs/product-architecture/enrichment_source_registry_v01.json",
  "supported_modes": [
    "Answer",
    "Explain",
    "Assess",
    "Find evidence"
  ],
  "supported_profiles": [
    "general_ai_capability",
    "ai_security",
    "ai_governance",
    "gxp_regulated_life_sciences",
    "medical_device_samd",
    "ot_endpoint_infrastructure",
    "foundation_model_providers",
    "agent_rag_engineering",
    "independent_evidence",
    "vendor_product_docs"
  ],
  "default_profile_behavior": {
    "default_profile": "general_ai_capability",
    "default_source_scope": "package_only",
    "package_plus_enrichment_requires_explicit_scope_or_controlled_operator_default": true,
    "normal_client_source_ids_are_not_routing_authority": true
  },
  "mode_source_pack_eligibility": {
    "Answer": {
      "enrichment_allowed_when_scope_is_package_plus_enrichment": true,
      "eligible_source_pack_rule": "selected_profile_source_packs"
    },
    "Explain": {
      "enrichment_allowed_when_scope_is_package_plus_enrichment": true,
      "eligible_source_pack_rule": "selected_profile_source_packs"
    },
    "Assess": {
      "enrichment_allowed_when_scope_is_package_plus_enrichment": true,
      "eligible_source_pack_rule": "selected_profile_source_packs",
      "deterministic_missing_proposal_evidence_refusal_precedes_enrichment": true
    },
    "Find evidence": {
      "package_evidence_first": true,
      "enrichment_allowed_when_scope_is_package_plus_enrichment": true,
      "eligible_source_pack_rule": "selected_profile_source_packs"
    }
  },
  "profile_source_pack_eligibility": {
    "general_ai_capability": [
      "core_ai_capability"
    ],
    "ai_security": [
      "core_ai_capability",
      "ai_security"
    ],
    "ai_governance": [
      "core_ai_capability",
      "ai_governance"
    ],
    "gxp_regulated_life_sciences": [
      "core_ai_capability",
      "gxp_regulated_life_sciences"
    ],
    "medical_device_samd": [
      "core_ai_capability",
      "medical_device_samd"
    ],
    "ot_endpoint_infrastructure": [
      "core_ai_capability",
      "ot_endpoint_infrastructure"
    ],
    "foundation_model_providers": [
      "core_ai_capability",
      "foundation_model_providers"
    ],
    "agent_rag_engineering": [
      "core_ai_capability",
      "agent_rag_engineering"
    ],
    "independent_evidence": [
      "core_ai_capability",
      "independent_evidence"
    ],
    "vendor_product_docs": [
      "core_ai_capability",
      "vendor_product_docs"
    ]
  },
  "operator_configured_defaults": {
    "routing_mode": "backend_managed",
    "default_profile": "general_ai_capability",
    "default_source_scope": "package_only",
    "retrieval_adapter": "allowlisted_public_fetch",
    "server_registry_sources": "AICD_CURRENT_CONTEXT_SOURCE_REGISTRY_JSON or AICD_CURRENT_CONTEXT_SOURCES_JSON",
    "operator_override_source_ids_scope": "advanced_operator_debug_only_server_validated",
    "selection_scope": "server_resolved_run_only"
  },
  "source_eligibility_rules": {
    "must_exist_in_registry_artifact": true,
    "source_pack_must_be_eligible_for_profile_and_mode": true,
    "allowed_statuses": [
      "active_default",
      "active_available",
      "profile_default"
    ],
    "allowed_license_modes": [
      "public",
      "metadata_only",
      "rights_cleared_controlled_excerpt"
    ],
    "browser_fetch_allowed_must_be_false": true,
    "provider_call_allowed_must_be_false": true,
    "package_authority_must_be_false": true,
    "registry_mutable_by_user_must_be_false": true,
    "retrieval_mode_must_be_owner_approved_runtime_profile_required": true,
    "package_authority_mutation_allowed": false
  },
  "source_exclusion_rules": {
    "forbidden_statuses": [
      "preview_only",
      "unavailable",
      "deprecated",
      "retired",
      "admin_gated"
    ],
    "forbidden_license_modes": [
      "licensed_excerpt_required"
    ],
    "vendor_provider_sources_must_not_be_global_defaults": true,
    "vendor_product_docs_only_product_triggered_or_explicitly_configured": true,
    "foundation_model_provider_sources_must_not_be_global_defaults": true,
    "client_selected_ids_cannot_override_eligibility": true
  },
  "runtime_source_aliases": {
    "nist-ai-rmf-public-framework-candidate": "nist-ai-rmf-1-0",
    "nist-ssdf-sp-800-218-candidate": "nist-sp-800-218-ssdf",
    "owasp-genai-llm-top-10-2025-candidate": "owasp-genai-llm-top-10-2025",
    "cisa-nsa-ncsc-secure-ai-system-development-guidelines-candidate": "cisa-nsa-ncsc-secure-ai-system-development"
  },
  "telemetry_contract": {
    "compact_ui": [
      "source_scope",
      "selected_profile",
      "routing_mode",
      "routing_result"
    ],
    "routing_result_values": [
      "package-only",
      "resolved eligible sources",
      "no eligible sources",
      "retrieval unavailable",
      "retrieved",
      "failed closed"
    ],
    "advanced_operator_debug": [
      "resolved_mode",
      "selected_profile",
      "eligible_source_packs",
      "eligible_source_ids",
      "excluded_source_ids_with_reason",
      "routing_policy_artifact",
      "server_registry_status",
      "retrieval_adapter",
      "retrieval_status",
      "used_enrichment_source_ids",
      "eligible_but_unused_source_ids",
      "package_authority_unchanged"
    ]
  },
  "refusal_and_degrade_behavior": {
    "server_registry_unconfigured": "retain_existing_fail_closed_behavior",
    "no_eligible_sources_message": "backend enrichment routing resolved no eligible sources",
    "missing_package_support": "refuse_before_enrichment_routing",
    "deterministic_refusal": "do_not_retrieve_enrichment",
    "retrieval_failure": "return_no_enrichment_refs_with_failed_closed_telemetry"
  },
  "boundary_confirmations": {
    "arbitrary_web_search_added": false,
    "source_discovery_added": false,
    "external_crawling_added": false,
    "browser_side_source_fetching_added": false,
    "browser_side_provider_calls_added": false,
    "user_entered_url_fetching_added": false,
    "registry_mutation_added": false,
    "package_authority_mutation_added": false,
    "session_source_text_persisted": false,
    "durable_memory_added": false,
    "vector_db_added": false,
    "graph_db_added": false,
    "hosted_retrieval_added": false,
    "cloudflare_configuration_changed": false,
    "provider_model_configuration_changed": false,
    "issue_78_mutated": false,
    "issue_271_reopened_or_mutated": false,
    "issue_428_closed": false,
    "issue_432_started": false,
    "codex_automerge_applied": false
  }
}