Skip to content

v0.2.0 — winner concentration (HHI)

Choose a tag to compare

View all tags
@gulmezeren2-byte gulmezeren2-byte released this 17 Jul 15:42
· 11 commits to main since this release
v0.2.0
cc72192

Winner concentration (HHI). ihalent single-bid flags a lack of competition within a tender; this new command flags it across tenders — whether the same few firms win everything a buyer puts out.

ihalent concentration awards.jsonl
ihalent concentration awards.jsonl --authority "İl Özel İdaresi"   # within one buyer
ihalent concentration awards.jsonl --json --top 10

It reports the Herfindahl-Hirschman Index (0..1 over win counts) plus the leading firms and their win shares:

  • Spelling variants fold together, and each award is attributed to its lead winner, so shares sum to 1 and the HHI is meaningful.
  • The coverage travels with the number — high concentration in a thin slice (a small authority with few tenders) is arithmetic, not evidence. It is a place to look, not a conclusion.
  • As a rough guide (US DOJ/FTC thresholds rescaled to 0-1): below 0.15 unconcentrated, 0.15-0.25 moderate, above 0.25 highly concentrated.

Available three ways: the CLI command, a concentration MCP tool (with --authority/--province slicing), and ihalent.analytics.concentration.

Full changelog: https://github.com/gulmezeren2-byte/ihalent/blob/main/CHANGELOG.md

Assets 2
Loading