{
  "schema": "varexis-public-evidence-record/0.3",
  "generated_at_utc": "2026-10-24T17:38:21.804Z",
  "record_id": "VXI-EXT-PROCUREMENT-SMART-SUCCESSFUL-SEARCH-PERMISSION-OMISSIONS-01-v1",
  "record_kind": "external_reference",
  "title": "SMART successful responses and omitted records",
  "system": "HL7 SMART App Launch",
  "evidence_family": "vendor_evidence_review",
  "index_status": "PUBLIC_SAFE_SOURCE_REVIEW",
  "evidence_state": "PRIMARY_DOCUMENTATION_REVIEW_ONLY",
  "canonical_question": "Does HTTP 200 from a SMART-authorized FHIR search prove that every matching clinical record was returned?",
  "near_questions": [
    "Can a SMART FHIR search silently omit restricted records?",
    "Why can a clinical API return 200 with incomplete results?",
    "Do SMART scopes override a user’s existing permissions?",
    "What evidence supports completeness of a SMART search?"
  ],
  "supported_claims": [
    {
      "claim": "SMART 2.2 states that scopes cannot exceed underlying system permissions. Its permission examples allow a successful 200 response while records are omitted because access is unavailable, or a forbidden response. A successful request is therefore not a completeness certificate for the clinical dataset.",
      "reliance": "DOCUMENTED_CAPABILITY_ONLY"
    }
  ],
  "not_demonstrated_claims": [
    "Independent verification of a patient record’s completeness",
    "The records filtered by the actual server and the full expected population are unknown.",
    "Buyer deployment testing, live runtime enforcement, certification or permission to act",
    "Expanded capabilities or licences for existing INDEX executables"
  ],
  "public_summary": "SMART 2.2 states that scopes cannot exceed underlying system permissions. Its permission examples allow a successful 200 response while records are omitted because access is unavailable, or a forbidden response. A successful request is therefore not a completeness certificate for the clinical dataset.",
  "related_record_ids": [],
  "source_review": {
    "source_type": "official_external_documentation",
    "source_title": "App Launch: Scopes and Launch Context - SMART App Launch v2.2.0",
    "source_url": "https://www.hl7.org/fhir/smart-app-launch/STU2.2/scopes-and-launch-context.html",
    "checked_on": "2026-10-24",
    "candidate_record_id": "VXI-EXT-PROCUREMENT-SMART-SUCCESSFUL-SEARCH-PERMISSION-OMISSIONS-01-v1",
    "candidate_record_sha256": "4c7572852bf5251cf6b882d240a1c26b3e9e88230fca502d4dca3bc642fe040b",
    "method": "Primary documentation reviewed for the published bounded statement.",
    "deployment_tested_by_varexis": false,
    "revalidation": "The delivered snapshot preserves the review date shown. Recheck current primary documentation and deployment context before relying on present applicability; payment does not trigger fresh research."
  },
  "answer_policy": {
    "classification": "DOCUMENTED_WITH_DEPLOYMENT_BOUNDARY",
    "bounded_answer": "SMART 2.2 states that scopes cannot exceed underlying system permissions. Its permission examples allow a successful 200 response while records are omitted because access is unavailable, or a forbidden response. A successful request is therefore not a completeness certificate for the clinical dataset.",
    "required_buyer_context": "Granted scope and underlying permission policy; Expected patient and resource population; Returned results, pagination and documented exclusions. Buyer deployment not inspected.",
    "missing_evidence": "A broader claim needs evidence matching the intended use. Payment does not upgrade the evidence state."
  },
  "private_boundary": "Raw logs, thresholds, private paths, source code, protected mechanisms and reconstruction-level details are excluded from public and paid delivery.",
  "decision_profile": {
    "schema": "varexis-vendor-evidence-review/1",
    "review_status": "documentation_review_only",
    "checked_on": "2026-10-24",
    "claim_to_check": "Does HTTP 200 from a SMART-authorized FHIR search prove that every matching clinical record was returned?",
    "documented_statement": {
      "status": "documented",
      "statement": "SMART 2.2 states that scopes cannot exceed underlying system permissions. Its permission examples allow a successful 200 response while records are omitted because access is unavailable, or a forbidden response. A successful request is therefore not a completeness certificate for the clinical dataset.",
      "source_ids": [
        "smart-scopes-pinned"
      ]
    },
    "review_inference": {
      "status": "review_inference",
      "statement": "Reconcile the authorized resource population, server policy and returned records before accepting completeness.",
      "source_ids": [
        "smart-scopes-pinned"
      ]
    },
    "buyer_evidence_required": [
      "Granted scope and underlying permission policy",
      "Expected patient and resource population",
      "Returned results, pagination and documented exclusions"
    ],
    "review_condition": {
      "status": "varexis_review_policy",
      "statement": "Do not treat HTTP success alone as complete clinical evidence."
    },
    "unknowns": "The records filtered by the actual server and the full expected population are unknown.",
    "unknown_finding": {
      "status": "unknown",
      "statement": "The records filtered by the actual server and the full expected population are unknown."
    },
    "evidence_sources": [
      {
        "source_id": "smart-scopes-pinned",
        "url": "https://www.hl7.org/fhir/smart-app-launch/STU2.2/scopes-and-launch-context.html",
        "final_url": "https://www.hl7.org/fhir/smart-app-launch/STU2.2/scopes-and-launch-context.html",
        "status": 200,
        "captured_at_utc": "2026-10-24T17:22:37.716Z",
        "sha256": "3317f5e9600ecd856c8d04b7234005a7f6deba84d0b2eb5a07ddf342cb1ec063",
        "bytes": 79968,
        "title": "App Launch: Scopes and Launch Context - SMART App Launch v2.2.0",
        "hash_basis": "Decoded HTTP response body bytes",
        "rights_review": "Factual paraphrase and source metadata only; raw source retained privately and not redistributed.",
        "checked_on": "2026-10-24",
        "capture_status": 200,
        "claim_review_completed": true,
        "reviewed_sections": [
          "Clinical scope syntax",
          "Launch context",
          "Underlying permissions and omitted results"
        ],
        "version_context": "SMART App Launch STU2.2 (2.2.0), pinned published URL."
      }
    ],
    "observed_deployment": false,
    "commercial_reliance_boundary": "Documentation review only; the buyer must establish applicability and actual outcomes. INDEX does not inspect or control the deployment.",
    "paid_value": {
      "decision_context": "Avoid accepting an incomplete clinical administrative export.",
      "free": "Complete review, sources, practical questions and limitations; may be saved locally.",
      "single_request": "Existing server-saved version-bound route snapshot for later authenticated retrieval.",
      "evidence_receipt": "The same snapshot plus the existing unsigned delivery receipt.",
      "excluded": [
        "Fresh vendor research",
        "Continuous monitoring or change alerts",
        "Testing the buyer configuration",
        "Private evidence or vendor certification"
      ],
      "integrity": "Hashes identify content versions; they do not prove truth or provide a signature."
    },
    "revalidation": {
      "trigger": "A saved purchase does not recheck the source or buyer configuration.",
      "specific_watch": "Recheck the documented behavior, product version and buyer evidence before relying on a current outcome."
    },
    "buyer_relevance": "Avoid accepting an incomplete clinical administrative export.",
    "refusal_conditions": [
      "Do not treat HTTP success alone as complete clinical evidence."
    ]
  },
  "niche": {
    "niche_id": "agent-authority-action-evidence",
    "label": "Agent Authority & Action Evidence",
    "classification_id": "audit",
    "classification_label": "Audit, Provenance & Evidence Accountability",
    "topic_id": "audit",
    "buyer_intent": "Avoid accepting an incomplete clinical administrative export.",
    "comparison_role": "supplementary_discovery"
  },
  "paid_access_note": "The full published answer and boundaries are free. Paid access saves the selected route and source versions, with an unsigned receipt when purchased. Preview coverage before paying. Fresh research, bespoke assessment and protected evidence are excluded.",
  "service_route": {
    "request_guide": "/varexis-index/request.html",
    "request_workflow": "/varexis-index/request-workflow.json",
    "service_id": "single_request",
    "service_routes_url": "/varexis-index/service-routes.json",
    "payment_required": true,
    "availability_endpoint": "/api/index/capabilities",
    "operational_status": "AUTOMATIC_SERVICE_CAPABILITIES_GATED",
    "checkout_url": "/index-access"
  },
  "authority_boundary": "VAREXIS-INDEX informs evidence reliance. It does not provide advice, certification, deployment authority, security assurance, production approval, or guarantee.",
  "human_page": "/varexis-index/catalog.html#smart-successful-search-permission-omissions",
  "machine_readable_record": "/varexis-index/records/smart-successful-search-permission-omissions.json"
}
