[appleweiping]

Summary

• Add bounded maximum-cardinality edge-bottleneck flow assignment, with fixed-point score total as a final objective.
• Validate against an independent exhaustive small-graph oracle, resource caps, CLI, and synthetic audited benchmark.
• Document the distinction from document-sum maximin and OpenReview FairFlow; no official parity claim.

Validation

• Windows: 1005 passed, 1 symlink skip; pure branch coverage 90.39%.
• WSL: 1006 passed.
• Ruff, mypy, Bandit, uv audit, sdist/wheel and isolated wheel CLI smoke passed.

Assisted-by: OpenAI Codex