{
  "schemaVersion": 1,
  "generatedAt": "2026-08-12T23:42:08.800Z",
  "generationKey": "270dd5498eaee04190be5073a2851e4388e312ea777d484d091475e5d5cfd5f2",
  "metadataPayloadSha256": "41813654c82ce120dd3ed8c00a5377ea3dfb76d9a0e6391ba64d335b8a51f6ad",
  "diagram": {
    "id": "semantic-cache-lookup-tiers-37c99796",
    "title": "Semantic cache lookup tiers",
    "description": "Exact-key first (free), then pgvector cosine, then a paid LLM equivalence check in the uncertainty band. Every path that would serve passes a serve-time ACL re-check first; a failed re-check is a miss, never a leak.",
    "status": "current",
    "canonicalAppearanceKey": "tsx:src/app/(docs)/docs/concepts/semantic-caching/page.tsx:tiersChart#1"
  },
  "aliases": [],
  "concepts": [
    "Semantic caching",
    "Tiers"
  ],
  "keywords": [
    "→ exact_key",
    "exact_key hit?",
    "≥ 0.97",
    "yes (≥ 0.97)",
    "in [0.90, 0.97)",
    "< 0.90",
    "serve + promote (new exact_key)",
    "serve-time ACL re-check",
    "pgvector cosine",
    "≥ directServeThreshold?",
    "not equivalent",
    "all deps readable",
    "cheap LLM equivalence check",
    "MISS → run pipeline → store",
    "serve cached StructuredAnswer",
    "any dep gone / tombstoned",
    "question + model + promptVersion + effectiveConfig",
    "yes",
    "no",
    "equivalent"
  ],
  "mermaid": {
    "type": "flowchart",
    "direction": "TB",
    "sourceSha256": "37c99796549fce6f64851e9ba172c0eb6e416333b1bc87465bb93caf5a26e1f8"
  },
  "provenance": [
    {
      "appearanceKey": "tsx:src/app/(docs)/docs/concepts/semantic-caching/page.tsx:tiersChart#1",
      "surface": "route",
      "sourcePath": "src/app/(docs)/docs/concepts/semantic-caching/page.tsx",
      "line": 26,
      "route": "/docs/concepts/semantic-caching",
      "symbol": "tiersChart",
      "caption": "Exact-key first (free), then pgvector cosine, then a paid LLM equivalence check in the uncertainty band. Every path that would serve passes a serve-time ACL re-check first; a failed re-check is a miss, never a leak."
    }
  ],
  "embeddedMetadata": [
    {
      "sourcePath": "src/app/(docs)/docs/concepts/semantic-caching/page.tsx",
      "caption": "Exact-key first (free), then pgvector cosine, then a paid LLM equivalence check in the uncertainty band. Every path that would serve passes a serve-time ACL re-check first; a failed re-check is a miss, never a leak."
    }
  ],
  "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/semantic-cache-lookup-tiers-37c99796/semantic-cache-lookup-tiers-37c99796.mmd",
    "svg": "/diagrams/semantic-cache-lookup-tiers-37c99796/semantic-cache-lookup-tiers-37c99796.svg",
    "png": "/diagrams/semantic-cache-lookup-tiers-37c99796/semantic-cache-lookup-tiers-37c99796.png",
    "drawio": "/diagrams/semantic-cache-lookup-tiers-37c99796/semantic-cache-lookup-tiers-37c99796.drawio",
    "json": "/diagrams/semantic-cache-lookup-tiers-37c99796/semantic-cache-lookup-tiers-37c99796.json"
  },
  "artifactSha256": {
    "mmd": "43bac5482057375461bfa97419e0b298392f3a9025c4d3826f1e98da4413b980",
    "svg": "de31d64b6c6c101d9abde1bfe3277dd0ea9c26f21190ac759b173924eea493ce",
    "png": "58c1ae37786c8b76f13682cd10e7aec59387cbdd42ac26d2bc06270110bd2a59",
    "drawio": "f4f773f5406d37b17d167ef9a0310dc1a823f8e7d16d01615a5f68877863e9d0"
  }
}