How aakarsh-kumar/binary-trace works
Compliance Review is a local-first system for ingesting student prose, code, or mixed submissions, selecting capability-appropriate skills, running compliance checks, verifying cited evidence, and persisting auditable results. Users can initiate review through the CLI or Streamlit dashboard; the dashboard also supports uploads and review browsing. The graph preserves the documented skill retrieval, capability gating, deterministic/model-based checks, evidence verification, metrics, and database layers. Some modules were not sampled, so uncertain runtime links are omitted.
Main entry points: harness/orchestrator.py Review orchestrator · ingestion/orchestrator.py Ingestion orchestrator · app.py Dashboard · repository.py Review repository
Components 22
User entrypoints
- CLI
src/compliance_review/cli.py - Dashboard
src/compliance_review/dashboard/app.py - Upload handler
src/compliance_review/dashboard/upload_handler.py
Submission ingestion
- Ingestion orchestrator
src/compliance_review/ingestion/orchestrator.py - Format parsers
src/compliance_review/ingestion - Repository parser
src/compliance_review/ingestion/repo.py
Review pipeline
- Review orchestrator
src/compliance_review/harness/orchestrator.py - K-run checks
src/compliance_review/harness/k_run.py - Deterministic checks
src/compliance_review/checks/deterministic - Model checks
src/compliance_review/checks/model_based - Evidence verifier
src/compliance_review/evidence/verifier.py - Severity cap
src/compliance_review/harness/severity_cap.py
Skills and retrieval
- Skill loader
src/compliance_review/skills/loader.py - Capability gate
src/compliance_review/retrieval/capability_gate.py - Skill selector
src/compliance_review/retrieval/selector.py - Vector index
src/compliance_review/retrieval/vector_index.py
Persistence and reporting
- Review repository
src/compliance_review/db/repository.py - Database engine
src/compliance_review/db/engine.py - Review tables
src/compliance_review/db/tables.py - Dashboard queries
src/compliance_review/dashboard/queries.py - Metrics computation
src/compliance_review/metrics/compute.py
Other components
- Reviewer
Connections 28
- Reviewer → CLI: runs review
src/compliance_review/cli.py - Reviewer → Dashboard: uses dashboard
README.md - Dashboard → Upload handler: handles uploads
src/compliance_review/dashboard/app.py - Dashboard → Ingestion orchestrator: ingests source
src/compliance_review/dashboard/app.py - Upload handler → Ingestion orchestrator: calls callback
src/compliance_review/dashboard/upload_handler.py - Upload handler → Review orchestrator: reviews callback
- CLI → Ingestion orchestrator: ingests source
src/compliance_review/cli.py - CLI → Review orchestrator: runs review
src/compliance_review/cli.py - Ingestion orchestrator → Format parsers: dispatches parsing
src/compliance_review/ingestion/orchestrator.py - Ingestion orchestrator → Repository parser: parses code
src/compliance_review/ingestion/orchestrator.py - Ingestion orchestrator → Review repository: creates submission
src/compliance_review/ingestion/orchestrator.py - Review orchestrator → Capability gate: checks capabilities
src/compliance_review/harness/orchestrator.py - Review orchestrator → Skill selector: selects skill
src/compliance_review/harness/orchestrator.py - Review orchestrator → Skill loader: loads checklist
src/compliance_review/harness/orchestrator.py - Review orchestrator → K-run checks: runs checks
src/compliance_review/harness/orchestrator.py - Review orchestrator → Evidence verifier: verifies evidence
src/compliance_review/harness/orchestrator.py - Review orchestrator → Severity cap: caps severity
src/compliance_review/harness/orchestrator.py - Review orchestrator → Review repository: persists review
src/compliance_review/harness/orchestrator.py - K-run checks → Deterministic checks: runs checks
src/compliance_review/harness/k_run.py - K-run checks → Model checks: runs checks
src/compliance_review/harness/k_run.py - Vector index → Skill loader: loads skills
src/compliance_review/retrieval/vector_index.py - Review repository → Database engine: opens connections
src/compliance_review/db/repository.py - Review repository → Review tables: queries tables
src/compliance_review/db/repository.py - Database engine → Dashboard: uses settings
src/compliance_review/db/engine.py - Dashboard queries → Review repository: reads submissions
src/compliance_review/dashboard/queries.py - Dashboard → Dashboard queries: loads submissions
src/compliance_review/dashboard/app.py - Metrics computation → Review tables: computes metrics
src/compliance_review/metrics/compute.py - Metrics computation → Evidence verifier: uses verification
src/compliance_review/metrics/compute.py