Engineering managers
Use the manager packet to see which contracts, routes, packages, gaps, and coverage labels shaped the review.
Find the bodies.
When someone asks “what static evidence does this change reach?”, TraceMap answers from the repository instead of memory. It scans code into rule-backed facts and assembles a bounded review packet for contracts, endpoints, dependencies, and SQL surfaces — with a rule ID, evidence tier, coverage label, and file span on every row, and honest gaps where the analysis stops. Runs locally. Reproducible.
It is static evidence, not runtime proof: it shows what the code shows and marks where it cannot be sure. No LLM calls, embeddings, vector databases, or prompt-based classification in the scanner or reducer.
scan-manifest.json
facts.ndjson
index.sqlite
report.md
logs/analyzer.log
ruleId: contract.delta.impact.v2
tier: Tier2Structural
commitSha: 5e7fe17
classification: NeedsReview
First look
Use the manager packet to frame static evidence, gaps, limitations, and human review before anyone claims impact or safety.
2 Reviewer needs the packet.Read the packet guide to follow rule IDs, evidence tiers, coverage labels, source spans, and limitations.
3 Someone needs to see it.Open public-safe proof assets that make generated report shapes scannable without replacing the source artifacts.
4 Engineer wants to run it.Run the checked-in demo and inspect public-safe summaries before drilling into local-only artifacts.
5 Mobile reviewer asks about Swift.Open the Swift v0 evidence lane and pinned real-world smoke proof for static evidence discovery over public app samples.
Evidence journey
Who it helps
Use the manager packet to see which contracts, routes, packages, gaps, and coverage labels shaped the review.
Start from the packet guide, rule IDs, evidence tiers, commit SHAs, and line spans when deciding what needs human attention.
Use the output artifacts to consume stable JSON, NDJSON, SQLite, and Markdown without depending on prompts or hidden model state.
Evidence model
Compiler-resolved symbol evidence where the language adapter can prove identity.
Known framework, project, endpoint, package, SQL, config, or DTO patterns.
Useful static clues when semantic proof is not available.
Analysis gaps, unavailable sections, reduced coverage, or unable-to-prove cases.
Artifacts
scan-manifest.jsonRepo, commit, scanner, build, and coverage metadata.facts.ndjsonRule-backed facts with evidence tiers and source spans.index.sqliteQueryable facts, symbols, relationships, surfaces, and flows.report.mdHuman-readable summary with coverage and known gaps.logs/analyzer.logAnalyzer diagnostics for partial or failed project loading.The evidence packet guide shows how to read a generated TraceMap packet without losing the rule IDs, evidence tiers, coverage labels, commit SHA, and limitations behind the summary. The manager packet gives leaders the same bounded evidence story before anyone claims impact or safety.
Workflows
Index .NET, TypeScript, JVM, Python, and Swift repositories into deterministic facts.
Compare contract deltas against indexed evidence and label reduced coverage honestly.
Merge many indexes with source provenance for cross-repo dependency reports.
Trace bounded static evidence from endpoints to surfaces, or from surfaces back to roots.
Compare snapshots and summarize changed static evidence without claiming runtime behavior.
Assemble a release-oriented packet from coverage, impact, contract, and gap evidence.
Get started
The demo scans sample repositories, writes a generated artifact bundle, and produces public-shareable summaries without local absolute paths.
git clone https://github.com/joefeser/tracemap.git
cd tracemap
./scripts/demo-public.sh
dotnet run --project src/dotnet/TraceMap.Cli -- scan \
--repo samples/modern-sample \
--out .tracemap
Boundaries
Source of truth