How tetra4ge/githygiene works
GitHygiene is a dependency-security platform: users sync repositories, ingest manifests, extract dependencies, scan for advisories, and review organization-scoped findings. The gateway owns persistence and integrations; the optional AI path adds advisory-surface extraction, deterministic code evidence, reachability assessment, and remediation. The README documents some capabilities whose controller internals were not sampled, so those links are limited to documented or indexed relationships; the AI service is present in source despite the README’s older “scaffolded” status.
Main entry points: index.routes.js API routes · osv.controller.js Advisory matching · ai.controller.js AI orchestration · db.config.js PostgreSQL
Components 27
User console
- Dashboard
frontend/src/pages/dashboard/Overview.tsx - Session state
frontend/src/lib/authStore.ts - API client
frontend/src/lib/api.ts
API and access
- REST gateway
api-gateway/server.js - API routes
api-gateway/routes/index.routes.js - JWT verification
api-gateway/middlewares/auth.middleware.js - Org access scope
api-gateway/utils/rbac.util.js
Dependency security
- Manifest ingestion
api-gateway/controllers/manifest.controller.js - Dependency extraction
api-gateway/controllers/parser.controller.js - Manifest parsers
api-gateway/services/parsers - Dependency scan
api-gateway/controllers/scanner.controller.js - Advisory matching
api-gateway/controllers/osv.controller.js - OSV integration
api-gateway/services/osv.service.js - Version lookup
api-gateway/services/registry.service.js - Risk scoring
api-gateway/services/scoring.service.js
AI analysis
- AI orchestration
api-gateway/controllers/ai.controller.js - Code evidence search
api-gateway/services/evidence.service.js - AI HTTP service
api-gateway/services/ai.service.js - AI endpoints
ai-service/api/routes - Analysis prompts
ai-service/llm/prompts.py - Structured model client
ai-service/llm/gemini_client.py - Model settings
ai-service/core/config.py - Response contracts
ai-service/models/schemas.py
Persistence and graph
- Dependency graph
api-gateway/services/graph.service.js - PostgreSQL
api-gateway/config/db.config.js - Neo4j
api-gateway/config/db.config.js
Other components
- Signed-in user
Connections 31
- Signed-in user → Dashboard: uses
README.md - Dashboard → Session state: tracks session
frontend/src/App.tsx - Dashboard → API client: requests data
- API client → REST gateway: REST calls
README.md - REST gateway → API routes: mounts API
api-gateway/server.js - API routes → JWT verification: protects endpoints
- API routes → Manifest ingestion: routes ingest
- API routes → Dependency extraction: routes extraction
- API routes → Dependency scan: routes scans
api-gateway/routes/index.routes.js - API routes → Advisory matching: routes advisories
api-gateway/routes/index.routes.js - API routes → AI orchestration: routes analysis
- Manifest ingestion → PostgreSQL: stores manifests
api-gateway/controllers/manifest.controller.js - Dependency extraction → Manifest parsers: uses parsers
api-gateway/controllers/parser.controller.js - Dependency extraction → PostgreSQL: writes dependencies
README.md - Dependency scan → PostgreSQL: records alerts
README.md - Advisory matching → OSV integration: queries advisories
api-gateway/controllers/osv.controller.js - Advisory matching → Version lookup: looks up versions
api-gateway/controllers/osv.controller.js - Advisory matching → Risk scoring: computes score
api-gateway/controllers/osv.controller.js - Advisory matching → Dependency graph: writes scan graph
api-gateway/controllers/osv.controller.js - Advisory matching → PostgreSQL: reads and writes
api-gateway/controllers/osv.controller.js - Dependency graph → Neo4j: queries graph
api-gateway/services/graph.service.js - AI orchestration → Org access scope: checks access
api-gateway/controllers/ai.controller.js - AI orchestration → Code evidence search: searches code
api-gateway/controllers/ai.controller.js - AI orchestration → Dependency graph: gets dependency path
api-gateway/controllers/ai.controller.js - AI orchestration → AI HTTP service: requests analysis
api-gateway/controllers/ai.controller.js - AI orchestration → PostgreSQL: caches assessments
api-gateway/controllers/ai.controller.js - AI HTTP service → AI endpoints: calls service
- AI endpoints → Analysis prompts: builds prompts
ai-service/api/routes/assess.py - AI endpoints → Structured model client: generates analysis
ai-service/api/routes/assess.py - Structured model client → Model settings: reads settings
ai-service/llm/gemini_client.py - AI endpoints → Response contracts: validates payloads
ai-service/api/routes/assess.py