Integrate GHunt Google Intelligence into Background Check Pipeline (Stage 2.7)

Completed Jun 01, 2026

Executive Summary

GHunt Stage 2.7 verified and complete — run_ghunt() function (100+ lines), --ghunt/--skip-ghunt flags, google_ecosystem section in normalize() and report(), graceful degradation when unauthenticated. Syntax OK, dry run passes.

📊 Key Findings

Outstanding manual step: Scott must run 'ghunt login' with a throwaway Google account before --ghunt produces results.

⏱ Timeline

💬 Additional Insights

review-required handoff: ```json { "changed_files": ["/home/kanfl/.hermes/background-check/orchestrator.py"], "lines_added": 484, "total_lines": 2016, "functions_added": ["run_ghunt()"], "functions_modified": ["normalize()", "generate_report()", "main()"], "new_flag": "--ghunt (opt-in, default off)", "new_flag_skip": "--skip-ghunt", "venv_packages_installed": ["ghunt==2.3.4", "httpx==0.27.2", "geopy==2.4.1", "imagehash==4.3.2", "protobuf==5.29.6", "scipy==1.17.1"], "skill_updated": "background-check-tool (SKILL.md patched with GHunt docs)", "decisions": [ "GHLunt is opt-in (--ghunt flag) to avoid blocking the main pipeline when auth is missing", "GHunt requires one-time 'ghunt login' with a throwaway Google account — not Scott's personal account", "Graceful degradation: if not authenticated, GHunt logs 'not_authenticated' error and pipeline continues", "Placed as Stage 2.7 between Maigret (2.5) and h8mail (3)", "Output goes into unified JSON as 'google_ecosystem' section with 20+ structured fields", "Report section: 7.5 Google Ecosystem (after social media, before breach data)" ], "outstanding_manual_step": "Scott must run 'ghunt login' from the venv to authenticate before --ghunt will work" } ```