{
  "schemaVersion": 1,
  "generatedAt": "2026-08-12T23:41:19.419Z",
  "generationKey": "8d96332940e1126b6c4d3fa1a8658c432be4aadeaed846e9d880d9b9cae0bfe7",
  "metadataPayloadSha256": "dba0807943492bed88bf04609f8cbfd8cd0984edbc6ea4c23e3ecbd3fb48d04a",
  "diagram": {
    "id": "retrieval-and-grounded-generation-0c2d5983",
    "title": "Retrieval and grounded generation",
    "description": "Actor principals constrain FTS, vector, and graph candidates before ranking and context assembly; policy controls whether generation, clarification, or abstention ships.",
    "status": "current",
    "canonicalAppearanceKey": "tsx:src/app/(docs)/docs/architecture/page.tsx:RETRIEVAL_CHART#1"
  },
  "aliases": [],
  "concepts": [
    "Public overview diagrams",
    "Retrieval and grounded generation",
    "Retrieval"
  ],
  "keywords": [
    "query understanding",
    "rewrite + constraints",
    "FTS channel",
    "reciprocal-rank fusion",
    "graph expansion",
    "optional rerank",
    "answer policy",
    "answer / caveat",
    "clarify / abstain",
    "question + actor principals",
    "retrieve() with ACL predicates",
    "vector channel (pgvector)",
    "from visible seed concepts",
    "grounded generation + citations",
    "clarification or pointers",
    "groundedness + conflict checks",
    "Sn"
  ],
  "mermaid": {
    "type": "flowchart",
    "direction": "LR",
    "sourceSha256": "0c2d598391dbbb05557c4e32c1f7143c349dbc9a88193ab022041c4097e64fd5"
  },
  "provenance": [
    {
      "appearanceKey": "md:docs/architecture/public-overview-diagrams.md#4",
      "surface": "markdown",
      "sourcePath": "docs/architecture/public-overview-diagrams.md",
      "line": 129,
      "heading": "Retrieval and grounded generation"
    },
    {
      "appearanceKey": "tsx:src/app/(docs)/docs/architecture/page.tsx:RETRIEVAL_CHART#1",
      "surface": "route",
      "sourcePath": "src/components/docs/diagrams.ts",
      "line": 47,
      "route": "/docs/architecture",
      "symbol": "RETRIEVAL_CHART",
      "caption": "Actor principals constrain FTS, vector, and graph candidates before ranking and context assembly; policy controls whether generation, clarification, or abstention ships."
    }
  ],
  "embeddedMetadata": [
    {
      "sourcePath": "docs/architecture/public-overview-diagrams.md",
      "heading": "Retrieval and grounded generation"
    },
    {
      "sourcePath": "src/components/docs/diagrams.ts",
      "caption": "Actor principals constrain FTS, vector, and graph candidates before ranking and context assembly; policy controls whether generation, clarification, or abstention ships."
    }
  ],
  "generation": {
    "application": {
      "name": "eli-ai",
      "version": "0.1.0"
    },
    "environment": {
      "node": "v26.3.1",
      "yarn": "4.17.1",
      "platform": "linux",
      "architecture": "x64",
      "containerImage": "playwright:v1.62.1-noble@sha256:c091b21d9fae78c76e85cd4356431e9b018402f172a214fc7d7a5e9a7e29d8ac+node:26.3.1-bookworm-slim@sha256:209558c3e5e40e8adff68959d3c2ba7cd73723e716d89196878a0c362fa1e109"
    },
    "packages": {
      "mermaid": "11.16.0",
      "mermaidCli": "11.16.0",
      "playwright": "1.62.1",
      "playwrightCore": "1.62.1",
      "puppeteer": "25.6.0",
      "puppeteerCore": "25.6.0"
    },
    "renderer": {
      "mermaidConfigSha256": "68c10966fe84406ee626034d58bfabd555df9f65f691204b7c46db24038da101",
      "themeCssSha256": "c80287a78d80ad63d27bd5ca348b2ef9a7e2f44da289e436be6484ea28a1b033",
      "browser": {
        "name": "chromium",
        "revision": "1234",
        "version": "151.0.7922.34",
        "executableSha256": "0b20b130e7edd9dd51873be867761295fe0cfad490c2b9a64f95bd3cfc08fa71"
      },
      "font": {
        "family": "Eli Diagram Inter Variable",
        "fileSha256": "3100e775e8616cd2611beecfa23a4263d7037586789b43f035236a2e6fbd4c62",
        "licenseSha256": "3b0a5fca3d17942cde889069889dedbbbd075e9b599968c82a95f4d944e9b345"
      }
    },
    "adapterVersions": {
      "diagramGenerator": "2",
      "drawioFlowchart": "1",
      "drawioSequence": "1",
      "drawioState": "1",
      "drawioGantt": "1"
    }
  },
  "artifacts": {
    "mmd": "/diagrams/retrieval-and-grounded-generation-0c2d5983/retrieval-and-grounded-generation-0c2d5983.mmd",
    "svg": "/diagrams/retrieval-and-grounded-generation-0c2d5983/retrieval-and-grounded-generation-0c2d5983.svg",
    "png": "/diagrams/retrieval-and-grounded-generation-0c2d5983/retrieval-and-grounded-generation-0c2d5983.png",
    "drawio": "/diagrams/retrieval-and-grounded-generation-0c2d5983/retrieval-and-grounded-generation-0c2d5983.drawio",
    "json": "/diagrams/retrieval-and-grounded-generation-0c2d5983/retrieval-and-grounded-generation-0c2d5983.json"
  },
  "artifactSha256": {
    "mmd": "1267d34c08d7f3ae43a719cc6a605398346365929afed8d5406b4fc1a9a18ce7",
    "svg": "89585579d74cc18126aa913f3af7e5929ca6890a53119cc1a6405ac7963b1770",
    "png": "8e09e1075086dabcd71cd69b99071d9aa9db27d664f7b5fd706836035e0d7e6a",
    "drawio": "11982548371c63ec7621c7f5638fbb5ede7f88289cf942fb25449b36eeee5dc5"
  }
}