REPORT

Audit Report

Project: miniOS | 2026-10-28 | 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	1401	Resolved import edges parsed from source
EXTRACTED	2269	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: 596, communities: 11
• File doc coverage: 530/596
• Orphans (no docs at any level): 47
• Layers detected: 5
• Security findings: 0
• Large files (>256KB, maybe generated): 1 (sign.s)

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: ~242290 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