odd-repo-mapper

Deterministic code intelligence tool producing evidence-backed architecture diagrams and feature-test traceability matrices.

Quick Start

npm install
npm run build

# Scan a repository
npx repo-mapper scan --root . --out ./out

# Verify outputs
npx repo-mapper verify ./out

Philosophy

The mapper does not explain the codebase. It produces evidence that allows humans (and tools) to explain it safely.

• Evidence-first: Every claim is backed by file/symbol/edge proof
• Deterministic: Same inputs → same outputs, byte-for-byte
• Fail-closed: Missing evidence → failure, not silent degradation

Commands

| Command | Description | | -------- | ------------------------------------------------------------- | | scan | Produce repo_profile.json, toolchain.json, graph.sqlite | | verify | Validate artifacts against schemas and invariants |

Artifacts

| File | Description | | ------------------- | -------------------------------------------------- | | repo_profile.json | File classification, language stats, build systems | | toolchain.json | Node version, lockfile hash, dependencies | | graph.sqlite | SQLite knowledge graph (canonical) | | graph.json | Portable JSON export with contentHash |

License

See LICENSE for details. © Odd Essentials, LLC