{
  "rows": [
    {
      "id": "kv-cache",
      "canonical": "KV cache",
      "family": "cache",
      "kind": "subsystem",
      "definition": "The kernel-owned raw attention state: per-position Key and Value tensor rows for the running model, supporting in-place eviction and prefix reuse.",
      "distinction": "Local raw tensors the kernel owns - NOT vCache (a control plane over a remote cache) and NOT cachemeta (which owns no tensors).",
      "distinct_from": ["vcache", "cachemeta", "radixkv"],
      "aliases": ["model KV", "local KV"],
      "grounding": "kvcache",
      "grounding_kind": "symbol",
      "glossary_anchor": "docs/fak/concept-glossary.md",
      "parent": "",
      "verdict": "crystal",
      "gaps": []
    },
    {
      "id": "vcache",
      "canonical": "vCache",
      "family": "cache",
      "kind": "subsystem",
      "definition": "The virtual API cache: a page-table abstraction that models a remote provider's prefix cache as virtual pages, with a manifest of canonical prefix chains and warmth belief.",
      "distinction": "A CONTROL PLANE over a cache you do not own - NOT the KV cache (local tensors) and NOT the provider prompt-cache itself.",
      "distinct_from": ["kv-cache", "prompt-cache", "cachemeta"],
      "aliases": ["virtual API cache", "vcachegov", "vcachechain"],
      "grounding": "vcache",
      "grounding_kind": "symbol",
      "glossary_anchor": "docs/fak/concept-glossary.md",
      "parent": "",
      "verdict": "crystal",
      "gaps": []
    },
    {
      "id": "cachemeta",
      "canonical": "cachemeta",
      "family": "cache",
      "kind": "subsystem",
      "definition": "The typed metadata contract (tier 1): owns no payloads, names reusable cache entries, and carries their validity / security / residency metadata and typed lookup verdicts.",
      "distinction": "The PASSIVE metadata foundation every cache plane builds on - NOT vCache (the active control loop built atop it).",
      "distinct_from": ["vcache", "kv-cache", "enginecache"],
      "aliases": ["cache metadata contract"],
      "grounding": "cachemeta",
      "grounding_kind": "path",
      "glossary_anchor": "docs/fak/concept-glossary.md",
      "parent": "",
      "verdict": "crystal",
      "gaps": []
    },
    {
      "id": "prompt-cache",
      "canonical": "Prompt cache",
      "family": "cache",
      "kind": "concept",
      "definition": "The upstream provider feature: a prefix cached via cache_control breakpoints, reported back as cache_read_input_tokens / cache_creation_input_tokens with a specific pricing multiplier.",
      "distinction": "A provider FEATURE you use - NOT vCache (the control loop you build) and NOT the KV cache (local tensors).",
      "distinct_from": ["vcache", "provider-cache", "cache-read"],
      "aliases": ["Anthropic prompt cache", "cachereadinputtokens"],
      "grounding": "cachereadinputtokens",
      "grounding_kind": "symbol",
      "glossary_anchor": "docs/fak/concept-glossary.md",
      "parent": "",
      "verdict": "crystal",
      "gaps": []
    },
    {
      "id": "provider-cache",
      "canonical": "Provider cache",
      "family": "cache",
      "kind": "metric",
      "definition": "A cachemeta entry on plane=provider: the OBSERVED telemetry record of what the provider's prompt cache did (read/creation token counts), marked non-re-serveable local proof.",
      "distinction": "The recorded OBSERVATION of the provider feature - NOT the Prompt cache feature itself and NOT a local cache fak can serve from.",
      "distinct_from": ["prompt-cache", "vcache"],
      "aliases": ["provider-side cache"],
      "grounding": "providercache",
      "grounding_kind": "symbol",
      "glossary_anchor": "docs/fak/concept-glossary.md",
      "parent": "",
      "verdict": "crystal",
      "gaps": []
    },
    {
      "id": "cache-control",
      "canonical": "cache_control",
      "family": "cache",
      "kind": "config",
      "definition": "The WRITE placement mechanism: the cache_control breakpoint you place to tell the provider where to cache a prefix.",
      "distinction": "The breakpoint you PLACE - NOT cache_read (what the provider reports it served) and NOT cache_creation (what it reports it wrote).",
      "distinct_from": ["cache-read", "cache-creation-tokens"],
      "aliases": ["cache breakpoint"],
      "grounding": "cachecontrol",
      "grounding_kind": "symbol",
      "glossary_anchor": "docs/fak/concept-glossary.md",
      "parent": "prompt-cache",
      "verdict": "crystal",
      "gaps": []
    },
    {
      "id": "cache-read",
      "canonical": "cache_read",
      "family": "cache",
      "kind": "metric",
      "definition": "The READ telemetry: cache_read_input_tokens, what the provider reports it served from its cache rather than re-prefilling, billed at 0.1x base input.",
      "distinction": "What the provider reports it READ - NOT cache_control (the placement) and NOT cache_creation (the write cost).",
      "distinct_from": ["cache-creation-tokens", "cache-control"],
      "aliases": ["cachereadtokens"],
      "grounding": "cachereadtokens",
      "grounding_kind": "symbol",
      "glossary_anchor": "docs/fak/concept-glossary.md",
      "parent": "prompt-cache",
      "verdict": "crystal",
      "gaps": []
    },
    {
      "id": "cache-creation-tokens",
      "canonical": "cache_creation_input_tokens",
      "family": "cache",
      "kind": "metric",
      "definition": "The WRITE telemetry: cache_creation_input_tokens, what the provider reports it wrote to its cache on this call, billed at 1.25-2.0x base input depending on TTL.",
      "distinction": "What the provider reports it WROTE - NOT cache_read (the read rebate) and NOT cache_control (the placement mechanism).",
      "distinct_from": ["cache-read", "cache-control"],
      "aliases": ["cachecreationtokens"],
      "grounding": "cachecreationtokens",
      "grounding_kind": "symbol",
      "glossary_anchor": "docs/fak/concept-glossary.md",
      "parent": "prompt-cache",
      "verdict": "crystal",
      "gaps": []
    },
    {
      "id": "radixkv",
      "canonical": "RadixKV",
      "family": "cache",
      "kind": "subsystem",
      "definition": "A local token-trie data structure for fast prefix lookup that points INTO KV-cache spans, with materialization binding so cross-model spans are never reused.",
      "distinction": "The token-trie INDEX into KV spans - NOT the KV cache (the tensor storage it indexes) and NOT vCache (remote abstraction).",
      "distinct_from": ["kv-cache", "vcache"],
      "aliases": ["radix tree KV"],
      "grounding": "radixkv",
      "grounding_kind": "path",
      "glossary_anchor": "docs/fak/concept-glossary.md",
      "parent": "kv-cache",
      "verdict": "crystal",
      "gaps": []
    },
    {
      "id": "enginecache",
      "canonical": "enginecache",
      "family": "cache",
      "kind": "subsystem",
      "definition": "The adapter that translates cachemeta invalidation directives into a remote serving engine's control API (SGLang / vLLM prefix-cache reset or span evict).",
      "distinction": "The ADAPTER to a remote engine's cache - NOT cachemeta (the pure contract) and NOT vCache (the policy that triggers it).",
      "distinct_from": ["cachemeta", "vcache", "xenginekv"],
      "aliases": ["remote cache bridge"],
      "grounding": "enginecache",
      "grounding_kind": "path",
      "glossary_anchor": "docs/fak/concept-glossary.md",
      "parent": "",
      "verdict": "crystal",
      "gaps": []
    },
    {
      "id": "viewcache",
      "canonical": "ViewCache",
      "family": "cache",
      "kind": "subsystem",
      "definition": "Storage of materialized lossy projections (summary, QA, facts) over canonical memory pages, with FAULT / RECOMPUTE / HIT materialization verdicts.",
      "distinction": "STORES derived projections - NOT MemoryView (the typed CONTRACT for a projection) and NOT the KV cache (raw tensors).",
      "distinct_from": ["memoryview", "kv-cache"],
      "aliases": ["derived view cache"],
      "grounding": "viewcache",
      "grounding_kind": "symbol",
      "glossary_anchor": "docs/fak/concept-glossary.md",
      "parent": "",
      "verdict": "crystal",
      "gaps": []
    },
    {
      "id": "memoryview",
      "canonical": "MemoryView",
      "family": "cache",
      "kind": "subsystem",
      "definition": "The typed virtual-view contract binding a lossy derived projection (summary, graph) to its canonical raw-memory source by content digest + byte span, with provenance.",
      "distinction": "The CONTRACT binding a projection to its source - NOT ViewCache (the storage of materialized views) and NOT the canonical raw bytes.",
      "distinct_from": ["viewcache", "kv-cache"],
      "aliases": ["memview", "semantic view contract"],
      "grounding": "memview",
      "grounding_kind": "path",
      "glossary_anchor": "docs/fak/concept-glossary.md",
      "parent": "",
      "verdict": "crystal",
      "gaps": []
    },
    {
      "id": "hardware-aware-cache",
      "canonical": "Hardware-aware cache",
      "family": "cache",
      "kind": "subsystem",
      "definition": "The placement POLICY that knows each tier's physical character (HBM / DRAM / NUMA-far / CXL / disk / remote) and demotes hot entries one tier colder under pressure.",
      "distinction": "The placement POLICY - NOT the KV cache (the storage it places) and NOT KV transfer (the migration directive it emits).",
      "distinct_from": ["kv-cache", "kv-transfer"],
      "aliases": ["tiered cache policy"],
      "grounding": "planplacement",
      "grounding_kind": "symbol",
      "glossary_anchor": "docs/fak/concept-glossary.md",
      "parent": "",
      "verdict": "crystal",
      "gaps": []
    },
    {
      "id": "kv-transfer",
      "canonical": "KV transfer",
      "family": "cache",
      "kind": "symbol",
      "definition": "The migration DIRECTIVE emitted by hardware-aware placement: migrate / offload / restore / route a KV span between tiers.",
      "distinction": "The migration DIRECTIVE - NOT the KV cache (the storage) and NOT the hardware-aware policy (which emits it).",
      "distinct_from": ["hardware-aware-cache", "kv-cache"],
      "aliases": ["KV relocation"],
      "grounding": "kvtransfer",
      "grounding_kind": "symbol",
      "glossary_anchor": "docs/fak/concept-glossary.md",
      "parent": "hardware-aware-cache",
      "verdict": "crystal",
      "gaps": []
    },
    {
      "id": "vblock",
      "canonical": "vBlock",
      "family": "cache",
      "kind": "symbol",
      "definition": "The unit of cacheable work in vCache: a cachemeta entry whose identity carries every axis that must match for provider reuse (content digest, model, tokenizer, endpoints, position in prefix DAG).",
      "distinction": "A LOGICAL UNIT named by its identity axes - NOT vCache (the control system managing vBlocks) and NOT the KV cache (raw tensors).",
      "distinct_from": ["vcache", "kv-cache"],
      "aliases": ["virtual block"],
      "grounding": "vblock",
      "grounding_kind": "symbol",
      "glossary_anchor": "",
      "parent": "vcache",
      "verdict": "defined",
      "gaps": ["not yet written into the concept glossary - currently defined-only"]
    },
    {
      "id": "kvlayout",
      "canonical": "KVLayout",
      "family": "cache",
      "kind": "symbol",
      "definition": "The interface abstracting the per-position bytes a given attention variant caches and how to reconstruct per-head K/V from those bytes (standard vs MLA).",
      "distinction": "The reconstruction INTERFACE over cached bytes - NOT the KV cache (the storage) and NOT MLAConfig (the projection geometry).",
      "distinct_from": ["kv-cache", "mla-config"],
      "aliases": [],
      "grounding": "kvlayout",
      "grounding_kind": "symbol",
      "glossary_anchor": "",
      "parent": "kv-cache",
      "verdict": "defined",
      "gaps": ["not yet written into the concept glossary - currently defined-only"]
    },
    {
      "id": "mla-config",
      "canonical": "MLAConfig",
      "family": "cache",
      "kind": "symbol",
      "definition": "The low-rank MLA projection geometry (DeepSeek V2/V3): latent width, RoPE dim, and down/up projection matrices for compressing the K/V cache.",
      "distinction": "The projection PARAMETERS - NOT KVLayout (the interface that uses them) and NOT the KV cache (the cached tensors).",
      "distinct_from": ["kvlayout", "kv-cache"],
      "aliases": [],
      "grounding": "mlaconfig",
      "grounding_kind": "symbol",
      "glossary_anchor": "",
      "parent": "kvlayout",
      "verdict": "defined",
      "gaps": ["not yet written into the concept glossary - currently defined-only"]
    }
  ]
}
