Enginery

Enginery is an open-source, local-first control plane for agentic engineering. It coordinates humans, coding agents, and deterministic tools through governed workflows that turn engineering intent into verified software outcomes, and improve the system that produces them.

Status

v0.4.0, published on PyPI and GitHub Releases (v0.1.0, v0.2.0, v0.3.0, and v0.4.0 are all live). Enginery ships three of its four planned workflow stages: a coordinator-owned issue-to-merge-ready-pull-request workflow (Stage 1, proven against a real GitHub repository and a real OMP/Claude Code coding-agent harness), a dependency-ordered plan-to-verified-release workflow with a second coding-agent harness and capability provenance (Stage 2, proven against a real disposable PyPI/TestPyPI and GitHub Release publication), and a production-incident-to-hotfix-and-rollback workflow (Stage 3, proven against a real but controlled local HTTP service — never a real production, container, or cloud destination). Stage 4 (governed factory self-improvement) is gate-deferred with no committed date; run enginery gate status --gate G4 to see exactly which entry conditions are currently met. See RELEASE_NOTES.md and CHANGELOG.md for the full compatibility statement.

Recovery demonstration

A recorded, real coordinator-interruption-and-recovery run: a live coding-agent worker dispatched against a real GitHub issue, deliberately interrupted (no coordinator polling for 39 seconds while the worker kept running as an independent process), then recovered by a later, separate invocation that recognized the still-running worker and never dispatched a second one — confirmed by exactly one pull request and one commit. Published write-up: gist.github.com/Mathews-Tom/eb2ff07e918b329dc25a0fbfcab71945. The reusable runbook is docs/recovery-demonstration.md.

Pilot evidence and research

• docs/pitch.md records the Stage 1 gate-G1 pilot (go, 2026-07-20) and a follow-on Stage 2/Stage 3 manual-baseline-versus-Enginery comparison (2026-07-22) — real elapsed time, intervention counts, and burden for both paths, with no productivity claim beyond the recorded numbers.
• docs/competitive-capability-matrix.md is a dated, hands-on capability comparison against the closest control-plane entrants, with a first-hand observation or an explicit "not independently verified" mark for every row.

Installation

pip install enginery

Or from source:

git clone https://github.com/Mathews-Tom/Enginery.git
cd Enginery
uv sync --all-extras --dev

CLI

uv run enginery --version
uv run enginery doctor
uv run enginery adapter doctor --json
uv run enginery ledger verify --database ledger.db
uv run enginery policy explain request.json
uv run enginery stage1 build-request --output request.json --run-id issue-1 \
  --repository owner/repo --external-reference "..." \
  --source-snapshot-reference "..." --source-revision "..." \
  --base-revision "..." --title "..." --objective "..." \
  --acceptance-criterion "..." --repository-path /path/to/repo \
  --workspace-path /path/to/workspace --artifact-root /path/to/artifacts
uv run enginery stage1 start --database ledger.db --owner operator --request request.json
uv run enginery stage2 status --database ledger.db --owner operator --stack-id ID
uv run enginery workspace inspect --database ledger.db --owner operator --json
uv run enginery outcome completeness --database ledger.db
uv run enginery workspace release --database ledger.db --owner operator \
  --repository-id ID --run-id ID --dry-run
uv run enginery gate status --gate G4 --database ledger.db --json
uv run enginery capability lock --check

See docs/operations.md for the full command surface and docs/adapters.md for the adapter/port contracts.

Development

uv run ruff check .
uv run ruff format --check .
uv run mypy --strict src
uv run pytest -q
uv run python scripts/verify_project_identity.py

See CONTRIBUTING.md for package-boundary rules and SECURITY.md for the vulnerability-reporting process.

License

Apache License 2.0. See LICENSE.