How bogdaniel/zenchron-engineering works
Zenchron Engineering is a local engineering control plane: an operator submits or plans GitHub issue work, the persistent runtime coordinates workers and governs changes through verification, provenance, policy, and authority, while the operator retains the merge decision. The README documents the workflow and major capabilities; source excerpts show deterministic analysis, policy compilation, evidence handling, authority evaluation, and reassessment. Several runtime subsystems are represented by their exact tree paths but were not excerpted, so the graph avoids asserting undocumented internal call chains.
Main entry points: controller.go Engineering runtime · compiler.go Plan compilation · operator.go CLI commands · supervisor.go Runtime supervisor
Components 26
Operator interface
- CLI commands
cmd/zenchron-engineering/operator.go - Controller commands
cmd/zenchron-engineering/controller.go - Control API
controlplane/api.go
Change governance
- Plan compilation
planning/compiler.go - Assignment context
planning/context.go - Plan graph
planning/graph.go - Plan registry
planning/registry.go - Plan resolution
planning/resolver.go - Plan validation
planning/validate.go - Fact analysis
analysis/analysis.go - Policy compiler
policy/compiler.go - Scope reassessment
reassessment/reassessment.go - Evidence binding
evidence/evidence.go - Authority decision
authority/authority.go
Runtime execution
- Engineering runtime
runtime/controller.go - Agent providers
runtime/agents.go - Bounded operations
runtime/operations.go - Repository Git
runtime/repository_git.go
Persistent control plane
- Runtime supervisor
runtime/supervisor.go - Run reconciler
runtime/reconciler.go - Run journal
runtime/journal.go - SQLite state
runtime/sqlite_store.go
External systems
- GitHub adapter
runtime/github.go - Review feedback
runtime/feedback.go
Other components
- Operator
- GitHub
Connections 30
- Operator → CLI commands: submits work
README.md - CLI commands → Plan compilation: requests plan
README.md - Plan compilation → Assignment context: compiles assignments
- Plan compilation → Plan graph: models dependencies
- Plan compilation → Plan registry: uses capabilities
- Plan compilation → Plan resolution: resolves workers
- Plan compilation → Plan validation: validates plan
- CLI commands → Engineering runtime: starts issue runs
README.md - CLI commands → Runtime supervisor: starts service
README.md - Runtime supervisor → Engineering runtime: owns work
README.md - Engineering runtime → Run reconciler: advances runs
runtime/controller.go - Run reconciler → Bounded operations: executes bounded work
- Engineering runtime → Run journal: persists run events
README.md - Engineering runtime → SQLite state: stores durable state
- Engineering runtime → GitHub adapter: gets issue context
README.md - Engineering runtime → Agent providers: invokes worker
README.md - Engineering runtime → Repository Git: manages candidate
README.md - Engineering runtime → Fact analysis: derives facts
- Engineering runtime → Policy compiler: compiles contract
- Engineering runtime → Scope reassessment: reassesses changes
README.md - Scope reassessment → Policy compiler: recompiles contract
reassessment/reassessment.go - Engineering runtime → Evidence binding: checks evidence
- Engineering runtime → Authority decision: requests authorization
- GitHub → Review feedback: sends review comments
README.md - Review feedback → Engineering runtime: routes admitted feedback
README.md - Engineering runtime → GitHub adapter: publishes pull request
README.md - GitHub adapter → GitHub: opens pull request
README.md - Operator → GitHub: merges externally
README.md - CLI commands → Control API: controls service
- Controller commands → Runtime supervisor: manages controller