Skip to content

v1.108.143 — UNDER_THE_HOOD.md: the technical manual

Choose a tag to compare

View all tags
@jgravelle jgravelle released this 18 Jul 17:21
v1.108.143
f5ecbbe

Documentation-only release: no behavior changes.

New root doc UNDER_THE_HOOD.md — a workshop-manual counterpart to USER_GUIDE.md, for developers who want the machinery rather than the workflows. Six chapters:

  1. How jCodeMunch knows when it's wrong — the four-state retrieval verdict (ok / low_confidence / absent / degraded), calibrated confidence, per-symbol freshness
  2. What the ranking actually does — channel fusion, exact-name pinning, PageRank, learned per-repo weights, the retrieval-regret loop
  3. Every number states its basis — the declared/measured provenance contract, the gold corpus, and the drift guards
  4. The meter only errs downward — the token meter's every-error-points-down design
  5. The server disciplines itself — tool tiers, the CI-enforced 4,000-token schema budget, machine-checkable read-only annotations
  6. Evidence imports — compiler indexes and runtime traces, imported rather than executed

Plus a chapter map positioning the existing deep references (ARCHITECTURE, SPEC, CONFIGURATION, CONTEXT_PROVIDERS, TOKEN_SAVINGS, schemas/) and the forthcoming chapters. Linked from README's doc table.

Assets 10
Loading