feat: working orhcestration engine

This commit is contained in:
2026-10-21 19:50:24 +01:00
commit ce5e2f20cd
161 changed files with 31794 additions and 0 deletions

View File

@@ -0,0 +1,32 @@
# Step 2: the modules that depend on nothing about a subject
Built 2026-10-13, from the Reference at `8b397cd`.
## Brought
Twenty-five modules, 4,468 lines, copied by `scripts/bring.py` with imports renamed, then put through `ruff check --fix` and `ruff format` because the longer package name re-wraps import lines. Nothing else in them was changed.
`config`, `checkpointing`, `database`, `customer_case`, `baseline`, `scope`, `providers`, `adk/runtime`, `adk/adk_runtime`, `skills/agent_skills`, `states/execution_state`, `tools/jev`, `tools/guardrail`, `tools/workspace`, `tools/skill_routing`, `tools/mcp`, `learning/proposals`, `learning/proof`, `learning/skill`, and the package `__init__` files.
## Differed from the plan
The plan listed more modules as usable as they are. Reading their imports showed these depend on the Reference's Deliverable graph or its file formats, so they wait for step 3: `states/ledger`, `recorder` (through the Ledger), `adk/fake_runtime`, `states/lessons`, `nodes/intake` (its tests need the fake runtime), `workflows/execution_graph`, `tools/scoping`, `tools/meaning`, `learning/curator`, `learning/evidence`, `main`.
## Tests
Six test files brought, 85 tests. Changed after bringing:
| File | Change | Why |
| --- | --- | --- |
| `tests/agents/test_adk_runtime.py` | Skills come from `tests/fixtures/skills/` (`toy-design`, `toy-security`) in place of the Reference's bundle; two assertions on Skill text follow | The engine has no Skills of its own |
| `tests/test_scope.py` | The two tests of the Reference's real catalogue and benchmark spec removed | They test the Reference's subject; they return with its example Workflow in step 5 |
| `tests/tools/test_jev.py` | The two `open_decider` tests removed | `open_decider` is in `agent.py`; they return in step 3 |
| `tests/tools/test_mcp.py` | The `gate_cloud_read` test removed | `gate_cloud_read` is in `tools/execution.py`; it returns in step 3 |
## Left for step 3
These brought modules still carry names from the Reference's subject (Terraform, pillars, Google Cloud, its Deliverables), counted by line: `providers` 26, `config` 18, `adk/adk_runtime` 18, `tools/mcp` 9, `adk/runtime` 4, `tools/workspace` 4, `baseline` 2, `states/execution_state` 2, `scope` 1, `database` 1. Some are comments and examples; `providers` and `config` hold real fields that belong to a Workflow. `config.BASE_DIR` and `providers._REPO_ROOT` resolve paths from the package's own location, which is wrong once the package is installed into an agent.
## Verified
`pytest -q`: 85 passed. `ruff check .`, `ruff format --check .` and `mypy .`: clean. `git status` in the Reference shows the same nine modified files as before this work began, none under `app/` or `tests/`.