Phase 2b: Integrate Maigret into background check orchestrator

Completed Jun 01, 2026
← Back to Reports

Executive Summary

Verified Maigret integration end-to-end after review approval. Smoke test confirms: 5 profiles found on soxoj across 5 sites (top_sites=10), 3 with enrichment (fullname, location, bio, interests), 1 alt username discovered, 73-line markdown report with all 10 sections.

📊 Key Findings

--skip-maigret flag works. Syntax clean at 1018 lines.
📄 View Full Report →

💬 Additional Insight

review-required handoff:
```json
{
"changed_files": ["~/.hermes/background-check/orchestrator.py"],
"lines_before": 775,
"lines_after": 1018,
"stages": 7,
"features_added": [
"--username CLI flag for social media profiling",
"--skip-maigret flag to bypass Maigret stage",
"--maigret-top-sites N (default 500, 0 for all 3,159 sites)",
"run_maigret() — calls Maigret CLI, parses ndjson output",
"Social media section in markdown report (section 7)",
"Enrichment data extraction: fullname, location, bio, image, follower counts, interests",
"Alternate username discovery + risk indicator",
"Deduplicated interest tag collection"
],
"decisions": [
"CLI subprocess approach (not Python API) — v0.6.1 API differs from benchmark docs",
"ndjson format for rich enrichment data (vs simple which lacks fullname/location/etc.)",
"Default top_sites=500 as balance between scan depth and speed"
],
"test_results": {
"smoke_test": "PASS — soxoj: 9 profiles found, 6 enriched, 1 alt username discovered",
"syntax_check": "PASS — ast.parse() OK at 1018 lines",
"report_generation": "PASS — 77-line markdown with 10 sections"
}
}
```

⏱ Timeline