id: cited-architecture-questions
version: v1
description: Deterministic factuality and citation cases for architecture question planning.
cases:
  - id: upstream-dependency-with-citation
    question: What breaks if Identity goes down?
    entities:
      - {key: "service:checkout", name: Checkout, kind: service, evidence_ids: [ev-checkout]}
      - {key: "service:identity", name: Identity, kind: service, evidence_ids: [ev-identity]}
    relationships:
      - {key: "checkout|calls|identity", source_key: "service:checkout", target_key: "service:identity", kind: calls, evidence_ids: [ev-edge]}
    coverage_gaps: []
    expected_intent: dependency
    expected_resolution: resolved
    expected_answerability: answerable
    expected_path_count: 1
    expected_path_evidence: true

  - id: downstream-dependency-with-citation
    question: What does Checkout call downstream?
    entities:
      - {key: "service:checkout", name: Checkout, kind: service, evidence_ids: [ev-checkout]}
      - {key: "service:payments", name: Payments, kind: service, evidence_ids: [ev-payments]}
    relationships:
      - {key: "checkout|calls|payments", source_key: "service:checkout", target_key: "service:payments", kind: calls, evidence_ids: [ev-edge]}
    coverage_gaps: []
    expected_intent: dependency
    expected_resolution: resolved
    expected_answerability: answerable
    expected_path_count: 1
    expected_path_evidence: true

  - id: ambiguous-service-name
    question: What depends on Identity?
    entities:
      - {key: "service:identity-production", name: Identity, kind: service, evidence_ids: [ev-prod]}
      - {key: "service:identity-staging", name: Identity, kind: service, evidence_ids: [ev-stage]}
    relationships: []
    coverage_gaps: []
    expected_intent: dependency
    expected_resolution: ambiguous
    expected_answerability: ambiguous
    expected_path_count: 0
    expected_path_evidence: false

  - id: unknown-architecture-subject
    question: What breaks if Ledger goes down?
    entities:
      - {key: "service:identity", name: Identity, kind: service, evidence_ids: [ev-identity]}
    relationships: []
    coverage_gaps: []
    expected_intent: dependency
    expected_resolution: not_found
    expected_answerability: not_found
    expected_path_count: 0
    expected_path_evidence: false

  - id: ownership-without-proof
    question: Who owns Billing?
    entities:
      - {key: "service:billing", name: Billing, kind: service}
    relationships: []
    coverage_gaps:
      - {reason_code: owner_not_observed, detail: Ownership metadata is missing.}
    expected_intent: ownership
    expected_resolution: resolved
    expected_answerability: insufficient_evidence
    expected_path_count: 0
    expected_path_evidence: false

  - id: relationship-without-proof
    question: What breaks if Identity goes down?
    entities:
      - {key: "service:checkout", name: Checkout, kind: service}
      - {key: "service:identity", name: Identity, kind: service}
    relationships:
      - {key: "checkout|calls|identity", source_key: "service:checkout", target_key: "service:identity", kind: calls}
    coverage_gaps:
      - {reason_code: source_missing, detail: Deployment evidence has not been collected.}
    expected_intent: dependency
    expected_resolution: resolved
    expected_answerability: insufficient_evidence
    expected_path_count: 1
    expected_path_evidence: false

  - id: bounded-cycle
    question: What does Checkout call downstream?
    entities:
      - {key: "service:checkout", name: Checkout, kind: service, evidence_ids: [ev-checkout]}
      - {key: "service:payments", name: Payments, kind: service, evidence_ids: [ev-payments]}
    relationships:
      - {key: "checkout|calls|payments", source_key: "service:checkout", target_key: "service:payments", kind: calls, evidence_ids: [ev-one]}
      - {key: "payments|calls|checkout", source_key: "service:payments", target_key: "service:checkout", kind: calls, evidence_ids: [ev-two]}
    coverage_gaps: []
    expected_intent: dependency
    expected_resolution: resolved
    expected_answerability: answerable
    expected_path_count: 1
    expected_path_evidence: true

  - id: evidence-question-with-current-proof
    question: Why do we believe Checkout exists?
    entities:
      - {key: "service:checkout", name: Checkout, kind: service, evidence_ids: [ev-checkout]}
    relationships: []
    coverage_gaps: []
    expected_intent: evidence
    expected_resolution: resolved
    expected_answerability: answerable
    expected_path_count: 0
    expected_path_evidence: false