coulomb/kaizen-agentic
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: consolidate agent execution and custody
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
Details
CI Smoke / container-smoke (push) Successful in 2s
Details
ci / test (push) Successful in 52s
Details

Browse source
This commit is contained in:
tegwick 2026-08-20 22:43:55 +02:00
parent 6ed5708c21
commit d691135c4a
19 changed files with 372 additions and 64 deletions
Download patch file Download diff file Expand all files Collapse all files

30
docs/INTEGRATION_PATTERNS.md
View file

@ -56,9 +56,9 @@ invoke kaizen-agentic CLI commands.
**kaizen-agentic maintainer checklist:**
- [ ] Three definition files committed under `docs/integrations/activity-definitions/`
- [ ] activity-core PR or issue opened to register definitions
- [ ] Smoke test commands documented below pass on a pilot repo
- [x] Three definition files committed under `docs/integrations/activity-definitions/`
- [x] activity-core handoff completed for the resolver and pilot definitions
- [x] Smoke test commands documented below passed on the pilot roster
**Smoke test (manual):**
@ -71,7 +71,7 @@ kaizen-agentic metrics optimize
test -f .kaizen/metrics/optimizer/analysis.json && echo OK
```
**Boundary:** kaizen-agentic does not run Temporal schedules.
**Boundary:** kaizen-agentic does not run Temporal schedules or own durable work.
### Scheduled agent execution (WP-0006, ADR-005)
@ -109,8 +109,26 @@ kaizen-agentic schedule validate && kaizen-agentic schedule list
- [discover-kaizen-scheduled-repos.md](integrations/discover-kaizen-scheduled-repos.md) — resolver spec
- [kaizen-schedule-prepared-event.md](integrations/kaizen-schedule-prepared-event.md) — event payload
**Boundary:** kaizen-agentic declares and prepares; activity-core schedules;
state-hub owns the roster.
### Current automated runtime
The original WP-0006 resolver and manual prepare smoke established the supplier
contract. Current unattended execution composes it as follows:
| Stage | Owner | Contract |
|-------|-------|----------|
| Schedule/event and eligibility | activity-core | Temporal definition/rule plus repo/agent context |
| Durable work | activity-core | Unique idempotency key, `ops_run` state, lease, retry, result |
| Claim and execution | rein-aharness | Claim loop, `agent-session` approach, policy/profile/runtime resolution |
| Agent orientation | kaizen-agentic | `schedule prepare <agent>` offline bundle |
| Coordination evidence | State Hub | Roster, workplan/progress references; never prompts or secrets |
| Improvement evidence | kaizen-agentic / artifact-store | Project metrics and optional durable artifacts |
Manual invocation remains supported for smoke tests and operator-controlled
work. The automated path should keep prompts, secrets, and raw model output out
of `ops_run` and State Hub records.
**Boundary:** kaizen-agentic declares and prepares; activity-core schedules and
queues; rein-aharness executes; State Hub owns the roster and coordination view.
---