Skip to content
grisun0 edited this page Oct 16, 2026 · 29 revisions

Audit Report

Project: ReadMenator | 2026-10-15 | offline, deterministic

Confidence Trail

Every edge is tagged. Extracted means parsed from source; inferred means derived heuristically; ambiguous is reported, never hidden.

Confidence Count Meaning
EXTRACTED 611 Resolved import edges parsed from source
EXTRACTED 1332 Raw import statements (may include externals)
INFERRED 5 Surprising cross-community bridges
AMBIGUOUS 0 No uncertain edges are emitted by the static scanner

Coverage

  • Files: 155, communities: 8
  • File doc coverage: 135/155
  • Orphans (no docs at any level): 11
  • Layers detected: 6
  • Security findings: 0
  • Large files (>256KB, maybe generated): 0

Limits

  • Python uses the ast module; all other languages use regex parsers.
  • No dataflow or runtime tracing; taint follows the import graph only.
  • Symbol docs come from adjacent comments; missing docs are listed, not invented.
  • Centrality scores count every scanned file equally, including checked-in build artifacts; verify large files before refactoring.

Token Benchmark

  • Wiki index plus community pages estimate: ~83434 tokens (chars/4).
  • Full re-read of every source file would cost strictly more on any non-trivial project; this wiki is the cheaper entry point.
  • Generation cost: $0, offline, no network calls.

Reproduce

readmenator . --rebuild
readmenator . wiki

Clone this wiki locally