---
title: "fak intent-literal scorecard - does a metric's name invite an intent its definition delivers"
description: "Inward metric-honesty scorecard: each reported metric positioned on whether its NAME invites a wider intent than its LITERAL definition delivers (the self-referential-denominator trap: 'how much we do of X' where X is our own set, not the market) - and whether the surface discloses the gap. One driven number: intent-literal-debt."
---

# Intent-literal / metric-honesty scorecard

_Auto-generated by `tools/intent_literal_scorecard.py`. Do not hand-edit; re-run the tool._

**Grade A** - score 100.0 - intent_literal_debt **0** - 10 positioned metric(s) over 4 surface(s) - 9 with a divergent denominator - 13 coverage advisory.

The law: a metric whose NAME invites a wider intent than its LITERAL definition delivers  -  worst of all a SELF-REFERENTIAL denominator ("how much we do of X" where X is our own positioned set, not the external market)  -  must DISCLOSE that gap where a reader sees it. A disclosed divergence is honest; an undisclosed one is debt. This is distinct from concept-disambiguation (do two NAMES blur) and conflation (a number's PROVENANCE).

Standing: clear 1, disclosed 9, misleading 0.

| metric | surface | invited intent | literal meaning | denominator | verdict |
|---|---|---|---|---|---|
| `Coverage (concept-disambiguation scorecard)` | concept-scorecard-doc | the whole discovered confusable namespace is now positioned | 100.0% = 862/862 confusable tree tokens positioned; the denominator is the whole discover... | external-universe | clear |
| `closure_rate` | dispatch-status-doc | throughput - how many issues the fleet closes per period | an HONESTY ratio = TRUE_RESOLVED / (TRUE_RESOLVED + CLAIMED_CLOSED); a low value means fe... | self-referential | disclosed |
| `completed /h` | dispatch-status-doc | the dispatcher's own productivity - how fast the loop is shipping | completed-per-hour counts resolved (not wontfix/dup) closes from ANY actor; a gh-rate far... | subset | disclosed |
| `Composite score (industry scorecard)` | industry-scorecard-doc | fak is an A-grade product - fak is winning the field | 98.8/100 grades how complete and honest fak's competitive MAP is (honesty x 60% + coverag... | self-referential | disclosed |
| `Coverage (industry scorecard)` | industry-scorecard-doc | fak covers / serves ~100% of the LLM-serving market | 100% = 89/89 industry dimensions fak has POSITIONED itself against in its OWN taxonomy; t... | self-referential | disclosed |
| `fak_gateway_in_kernel_request_memory_plan_bytes` | serving-metrics | cumulative or aggregate memory demand / memory pressure | the most-recent single served request's memory plan - a last-request gauge, not an aggreg... | snapshot | disclosed |
| `fak_gateway_inflight_max_age_seconds` | serving-metrics | maximum request latency, or a hung-request detector | the age of the oldest in-flight request AT SCRAPE TIME; a request that hangs and finishes... | snapshot | disclosed |
| `fak_kernel_decisions_total` | serving-metrics | the distribution of real adjudication decisions the kernel made | decisions by winning rung INCLUDING rung=vdso, which means no adjudication happened - a b... | self-referential | disclosed |
| `fak_gateway_vdso_hit_ratio` | serving-metrics | a cache hit rate - reads served from a cache divided by lookups | the fraction of kernel submissions served by the vDSO fast path (an adjudication-bypass r... | self-referential | disclosed |
| `fak_kernel_vdso_hits_total` | serving-metrics | cache hits - how often a trust/result cache was effective | kernel submissions served by the vDSO fast path (a count of adjudication bypasses), not c... | self-referential | disclosed |

## Coverage advisory (SOFT - intent-laden metrics not yet positioned)

- serving-metrics: intent-laden metric 'fak_blob_dedup_hits_total' carries a name a reader may over-read; not yet positioned by a row
- serving-metrics: intent-laden metric 'fak_blob_dedup_ratio' carries a name a reader may over-read; not yet positioned by a row
- serving-metrics: intent-laden metric 'fak_gateway_compaction_reset_score' carries a name a reader may over-read; not yet positioned by a row
- serving-metrics: intent-laden metric 'fak_gateway_context_pollution_rate' carries a name a reader may over-read; not yet positioned by a row
- serving-metrics: intent-laden metric 'fak_gateway_in_kernel_request_memory_headroom_ratio' carries a name a reader may over-read; not yet positioned by a row
- serving-metrics: intent-laden metric 'fak_gateway_inference_cached_prompt_hit_ratio' carries a name a reader may over-read; not yet positioned by a row
- serving-metrics: intent-laden metric 'fak_gateway_inference_cached_prompt_hits_total' carries a name a reader may over-read; not yet positioned by a row
- serving-metrics: intent-laden metric 'fak_gateway_kv_memory_headroom_ratio' carries a name a reader may over-read; not yet positioned by a row
- serving-metrics: intent-laden metric 'fak_gateway_kv_prefix_reuse_ratio' carries a name a reader may over-read; not yet positioned by a row
- serving-metrics: intent-laden metric 'fak_vcache_hit_rate' carries a name a reader may over-read; not yet positioned by a row
- serving-metrics: intent-laden metric 'fak_vcache_saved_ratio' carries a name a reader may over-read; not yet positioned by a row
- serving-metrics: intent-laden metric 'fak_vdso_hit_rate' carries a name a reader may over-read; not yet positioned by a row
- serving-metrics: intent-laden metric 'fak_vdso_hits_total' carries a name a reader may over-read; not yet positioned by a row
