How sipyourdrink-ltd/bernstein works
Bernstein is an AI-agent governance layer: users define policy and run plans, then a deterministic scheduler coordinates agents, gates deliverables, and records evidence for later verification. The graph also preserves documented product branches for task admission, tracker-based handoffs, compliance evidence, integrations, and the web dashboard. README statements support the high-level workflow; unsampled subsystems are represented at their exact enclosing directories, and their internal calls are not inferred.
Main entry points: tick_pipeline.py Deterministic scheduler · audit_chain.py Audit chain · work_ledger.py Work ledger · admission Admission control
Components 18
Run execution
- Deterministic scheduler
src/bernstein/core/orchestration/tick_pipeline.py - Tracker handoffs
src/bernstein/core/orchestration/tracker_pipeline.py
Governance and evidence
- Quality gates
src/bernstein/core/quality/quality_gates.py - Policy engine
src/bernstein/core/security/policy_engine.py - Admission control
src/bernstein/core/admission - Audit chain
src/bernstein/core/security/audit_chain.py - Lineage tracking
src/bernstein/core/lineage - Offline verification
verify_cli/bernstein_verify - Compliance evidence
src/bernstein/compliance
User interfaces
- Bernstein CLI
src/bernstein/cli/main.py - Web dashboard
web/src/App.tsx - Task views
web/src/routes/Tasks.tsx
Integrations and agents
- Agent adapters
src/bernstein/adapters - Python SDK
sdk/python/src/bernstein_sdk/client.py - Jira webhook
integrations/jira_webhook/app.py
Data services
- Work ledger
src/bernstein/core/persistence/work_ledger.py - Data sources
src/bernstein/core/datasources/engine.py
Other components
- Operator
Connections 18
- Operator → Bernstein CLI: defines and runs
README.md - Bernstein CLI → Deterministic scheduler: runs plans
README.md - Deterministic scheduler → Agent adapters: dispatches agents
README.md - Deterministic scheduler → Quality gates: gates outputs
README.md - Deterministic scheduler → Audit chain: records run
README.md - Deterministic scheduler → Lineage tracking: records lineage
README.md - Audit chain → Offline verification: verifies offline
README.md - Deterministic scheduler → Work ledger: claims backlog
README.md - Operator → Tracker handoffs: configures handoffs
- Admission control → Work ledger: projects ledger
src/bernstein/core/admission/ledger.py - Admission control → Audit chain: optional audit
src/bernstein/core/admission/engine.py - Operator → Web dashboard: views operations
README.md - Web dashboard → Task views: routes tasks
web/src/App.tsx - Python SDK → Operator: submits task requests
sdk/python/src/bernstein_sdk/client.py - Jira webhook → Python SDK: uses task API
integrations/jira_webhook/app.py - Data sources → Work ledger: reads data
- Compliance evidence → Audit chain: uses evidence
- Policy engine → Deterministic scheduler: governs execution