You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The README oversells what is actually fetched, and it has no privacy section at all — a serious gap for a tool that sends resume text to a third-party LLM and caches it on disk. Trust is this product's whole value proposition; over-claiming undermines it.
Concrete mismatches between README and code today:
The bigtech agent is described as leaning hardest on DSA/LeetCode while being unable to fetch LeetCode.
Proposal
1. Honesty pass on the feature list. Rewrite the "multi-source fusion" bullet to state what is reliably fetched today (GitHub, portfolio/web, best-effort Scholar) vs. recorded-but-not-fetched (Codeforces/LeetCode handles) vs. resume-derived (arXiv/ORCID). Keep the roadmap items as roadmap.
2. Add a ## Privacy section covering:
Resume text is parsed by the selected LLM provider (Gemini by default) — treat it as data sent to that provider under their policy.
External signals are fetched locally and also sent to the LLM; nothing goes to a HireGauge server.
Recruiter mode (--mode recruiter) reframes output for a hiring reader — using it to evaluate other people is a regulated use (e.g. NYC Local Law 144 bias-audit, EU AI Act); the user is responsible for compliance.
3. Add a docs regression test in tests/test_docs.py asserting the README doesn't claim Codeforces/LeetCode stats are "fetched" until they are.
Acceptance criteria
Feature list matches implementation reality.
## Privacy section added covering LLM data flow, local cache, and recruiter-mode legal note.
tests/test_docs.py guards against re-introducing the misleading "fetch(es) codeforces/leetcode" phrasing.
Problem
The README oversells what is actually fetched, and it has no privacy section at all — a serious gap for a tool that sends resume text to a third-party LLM and caches it on disk. Trust is this product's whole value proposition; over-claiming undermines it.
Concrete mismatches between README and code today:
scholarly, which Google actively blocks.bigtechagent is described as leaning hardest on DSA/LeetCode while being unable to fetch LeetCode.Proposal
1. Honesty pass on the feature list. Rewrite the "multi-source fusion" bullet to state what is reliably fetched today (GitHub, portfolio/web, best-effort Scholar) vs. recorded-but-not-fetched (Codeforces/LeetCode handles) vs. resume-derived (arXiv/ORCID). Keep the roadmap items as roadmap.
2. Add a
## Privacysection covering:hiregauge cache clearwipes it;HIREGAUGE_CACHE_DIRoverrides the location.--mode recruiter) reframes output for a hiring reader — using it to evaluate other people is a regulated use (e.g. NYC Local Law 144 bias-audit, EU AI Act); the user is responsible for compliance.3. Add a docs regression test in
tests/test_docs.pyasserting the README doesn't claim Codeforces/LeetCode stats are "fetched" until they are.Acceptance criteria
## Privacysection added covering LLM data flow, local cache, and recruiter-mode legal note.tests/test_docs.pyguards against re-introducing the misleading "fetch(es) codeforces/leetcode" phrasing.Files
README.mdtests/test_docs.pyRelated: #9 (percentile honesty), #21, #7, #17 (recruiter mode).