Kevin

Diagram Grounding — what the pipeline verifies, and what it does not

gather_source reads watch paths; ground() drops invented subs and unverifiable citations; payload keys are counted, never cut.

Diagram Grounding — what the pipeline verifies, and what it does not (v2026-08-22T175604Z-b502e8bc6d) 2026-08-27 | gather_source reads watch paths; ground() drops invented subs and unverifiable citations; payload keys are counted, never cut. 1 - Audit Citations - Verifies citations in gathered source audit_citations.py gather_source ground() source_cited_names named_in_source MODEL_DIR architecture/content/*.json architecture/content/*.md git ls-files REPO_ROOT git ls-files cited names verified citat… 1. Reads source files 2. Extracts cited names 3. Verifies names against tracked fi… 4. Reports unverified citations 5. Exits non-zero on missing files Sample citation report missing-file: agent_bridge.py missing-file: windows_plugin.py outside-repo: ~/.kevin/role.json The audit does not verify the correctness of citations, only their existence in the repository. Legend actor = initiates work · process = code path · store = state on disk · bus = durable queue · dashed = separate process cyan = request flow · pink = state read/write · dashed green = pull / return path · red = refusal As of 2026-08-27 14:59 UTC, from commit 1b71989

Provenance

This drawing is generated, not drawn. It is rebuilt from the source files below, so when they change the picture changes — a diagram here cannot quietly describe a system that no longer works this way.

Owner
Kevin
Slug
diagram-grounding
Rendered
2026-08-22T175604Z
From commit
b502e8bc6d
Updated
27 Aug 2026, 14:59 UTC
Sources at
1b71989
Watches
1 path
  • scripts/diagram_render