How hiteater-wzm/eeo works
EEO combines an open brand-facts directory with AI visibility audits, a domain-ownership claim process, and an emerging reproducible measurement stack. The main audit flow accepts a brand and audit settings through one of several interfaces, runs questions against configured AI engines, then returns grades and answer evidence. The directory is a separate browse/search experience. Source excerpts establish the shared audit engine and key UI wiring; some major README-described subsystems are represented at their documented boundary because their implementation was not sampled.
Main entry points: core.cjs Audit core · App.jsx Web application · BrandDirectoryApp.jsx Directory application · registry Brand registry
Components 29
Visibility audits
- CLI audit
cli.cjs - Self-hosted API
server.cjs - MCP tools
mcp/server.cjs - GitHub Action
action/index.js - Browser extension
extension/background/background.js - Local audit app
extension/full/eeo-local.js - Audit core
core.cjs - Configured AI engines
- Grades and answer report
Brand directory
- Web application
web/src/App.jsx - Audit pages
web/src/StartPage.jsx - Report view
web/src/ReportPage.jsx - Crawler view
web/src/CrawlerPage.jsx - Directory application
web/src/BrandDirectoryApp.jsx - Directory home
web/src/pages/Home.jsx - Brand search
web/src/pages/Directory.jsx - Brand details
web/src/components/BrandDetailDialog.jsx
Claims and registry
- Brand registry
datasets/registry - Domain verification
platform/claim-verify.cjs - Claim finalization
platform/claim-finalize.cjs
Reproducible measurement
- Snapshot runner
tools/snapshot-run.cjs - Answer stance judging
lib/judge.cjs - Snapshot scoring
tools/score-snapshot.cjs - Statistical functions
lib/stats.cjs
Registry review
- Review preparation
tools/review2-prepare.cjs - Arbitration preparation
tools/review2-arbiter-prepare.cjs - Registry reader
tools/registry-lib.cjs
Other components
- Brand owner or auditor
- Brand claimant
Connections 37
- Brand owner or auditor → CLI audit: runs audit
README.md - Brand owner or auditor → Self-hosted API: requests audit
README.md - Brand owner or auditor → MCP tools: calls tools
README.md - Brand owner or auditor → GitHub Action: starts workflow
README.md - Brand owner or auditor → Browser extension: uses extension
README.md - Brand owner or auditor → Local audit app: opens app
README.md - CLI audit → Audit core: calls
core.cjs - Self-hosted API → Audit core: delegates
- MCP tools → Audit core: calls
mcp/server.cjs - GitHub Action → Audit core: calls
action/index.js - Browser extension → Local audit app: connects to
- Audit core → Configured AI engines: queries
core.cjs - Audit core → Grades and answer report: returns report
- Web application → Audit pages: renders
web/src/App.jsx - Web application → Report view: renders
web/src/App.jsx - Web application → Crawler view: renders
web/src/App.jsx - Audit pages → Audit core: submits audit
- Report view → Grades and answer report: displays
- Brand owner or auditor → Web application: browses site
README.md - Web application → Directory application: routes to
web/src/App.jsx - Directory application → Directory home: renders
web/src/BrandDirectoryApp.jsx - Directory application → Brand search: renders
web/src/BrandDirectoryApp.jsx - Brand search → Brand details: opens details
web/src/pages/Directory.jsx - Directory application → Brand registry: reads cards
- Brand claimant → Domain verification: proves ownership
README.md - Domain verification → Claim finalization: verifies claim
- Claim finalization → Brand registry: updates claim
- Snapshot runner → Configured AI engines: captures snapshots
- Snapshot runner → Answer stance judging: judges answers
- Answer stance judging → Configured AI engines: requests judgments
lib/judge.cjs - Answer stance judging → Statistical functions: computes agreement
lib/judge.cjs - Snapshot scoring → Statistical functions: uses statistics
- Brand owner or auditor → Review preparation: reviews registry
- Review preparation → Registry reader: reads registry
tools/review2-prepare.cjs - Arbitration preparation → Registry reader: reads registry
tools/review2-arbiter-prepare.cjs - Review preparation → Brand registry: samples entries
tools/review2-prepare.cjs - Arbitration preparation → Brand registry: restores evidence
tools/review2-arbiter-prepare.cjs