Skip to content

Benchmark & evidence

ContextIQ's claims are measurable and reproducible, not marketing.

Published results (v1.0.0)

The v1.0.0 benchmark run is archived with a permanent DOI: 10.5281/zenodo.21535772. Every input is content-hashed so a third party can confirm they ran the same dataset.

  • Generated: 2026-07-24 14:25 UTC
  • Dataset hash: 654a8300befab41d4396c8fee5d318d233a2debc52212a17b22d8cceca1f08b0 (63 files)
  • Environment: Python 3.11.13 · 26-language deep-parse extractor
  • Source of record: benchmarks/REPORT.md + benchmarks/MANIFEST.json

Retrieval quality

MetricValue
Queries96
Corpora4
Recall@50.989
Symbol recall0.735
Answerable rate0.604
Irrelevant-token ratio (waste)0.708

Per-corpus (Python / Go / TypeScript):

CorpusnRecall@5Symbol recallAnswerableWaste
retrieval_tasks420.9760.6670.5950.554
gosvc181.00.7220.5560.853
pyshop181.00.9170.7220.774
tsapi181.00.7220.5560.854

Test discovery (implementation ↔ test mapping)

MetricValue
Precision1.0
Recall0.9
F10.9474
hit@10.9
Gold pairs10
TP / FP / FN9 / 0 / 1

Measured on benchmarks/testmap/ (Python / Go / TypeScript / Java, labeled in pairs.json). The naming heuristic scores perfect precision; the single miss is a deliberately name-divergent pair that only the call graph links (recovered at symbol granularity by get_test_map).

Reproduce

bash
tokengraph benchmark --all          # retrieval quality across all corpora
tokengraph test-map --benchmark     # test-discovery precision / recall / F1
tokengraph publish-benchmark        # regenerate REPORT.md + MANIFEST.json

Verify the dataset is byte-identical by re-hashing benchmarks/ and comparing dataset_hash in benchmarks/MANIFEST.json.

Hallucination-reduction benchmark

bash
tokengraph hallucination

A multi-repo, reproducible codebase-fact grounding benchmark: it measures how much the guard reduces fabricated files / symbols / imports across real repositories. The published run is archived with a DOI (see the project README badge).

Quantify the guard on your repo

bash
tokengraph grounding

Reports fabrications caught vs. real references flagged — the precision / recall of the verify layer on your own code.

Test-map accuracy

bash
tokengraph test-map --benchmark

Scores the implementation ↔ test mapping with precision / recall / F1 / hit@1 on a labeled corpus.

Evidence packs (audit / CI)

bash
tokengraph evidence "add retry logic"

Produces a deterministic, hash-grounded JSON pack for a task — same inputs, same bytes — so a reviewer or CI job can verify exactly what context an agent was given. All output is secret-scanned.

Next steps

Released under the terms in the repository LICENSE.