Scan artifacts

TraceMap writes evidence you can inspect.

The scanner emits machine-readable facts, a queryable SQLite index, a manifest that records coverage and commit state, a human report, and logs for analyzer diagnostics.

Required scan output

Five files define the scan packet.

scan-manifest.jsonRepository identity, commit SHA, scanner version, analysis level, build status, and coverage.

facts.ndjsonOne deterministic fact per line, including rule IDs, tiers, spans, and extractor metadata.

index.sqliteQueryable facts plus tables for symbols, relationships, edges, surfaces, aliases, and flows when available.

report.mdHuman-readable summary of coverage, gaps, facts, surfaces, and limitations.

logs/analyzer.logAnalyzer diagnostics and project-load details for failed or partial analysis.

Example

Scan a sample repository.

Restore is explicit. Failed project load is not treated as clean analysis.

dotnet run --project src/dotnet/TraceMap.Cli -- scan \
  --repo samples/modern-sample \
  --out .tracemap