Merge pull request #103 from dmoliveira/my_opencode-e22-autoflow-adapter

Implement E22-T2 autoflow orchestration adapter

Author: dmoliveira

CHANGELOG.md

@@ -70,6 +70,7 @@ All notable changes to this project are documented in this file.
 - Added `scripts/budget_command.py` with `/budget status|profile|override|doctor` controls for execution budget visibility and tuning.
 - Added `/budget`, `/budget-status`, `/budget-profile`, `/budget-override`, and `/budget-doctor-json` aliases in `opencode.json`.
 - Added `instructions/autoflow_command_contract.md` defining Epic 22 Task 22.1 `/autoflow` subcommands, validation/error contract, output schema modes, lifecycle states, and safety defaults.
+- Added `scripts/autoflow_adapter.py` implementing Epic 22 Task 22.2 primitive composition and deterministic transition/explain logic for unified orchestration.
 
 ### Changes
 - Documented extension evaluation outcomes and when each tool is the better fit.
@@ -136,6 +137,7 @@ All notable changes to this project are documented in this file.
 - Expanded budget verification coverage for invalid override input handling and usage guidance in selftest.
 - Marked Epic 20 Task 20.4 complete and promoted Epic 20 status to done in the roadmap.
 - Marked Epic 22 as in progress and completed Task 22.1 contract definition notes in the roadmap.
+- Expanded selftest coverage with `/autoflow` adapter status and explain-path checks for illegal transitions and resume-gating fallback reason codes.
 
 ## v0.2.0 - 2026-02-12
 

IMPLEMENTATION_ROADMAP.md

@@ -787,10 +787,11 @@ Every command-oriented epic must ship all of the following:
   - [x] Subtask 22.1.2: Define input plan requirements and validation errors
   - [x] Subtask 22.1.3: Define output format for concise and verbose modes
   - [x] Notes: Added `instructions/autoflow_command_contract.md` defining `/autoflow` subcommands, deterministic validation/error shape, concise-vs-JSON output schema, lifecycle status model, and safety defaults for Task 22.2 implementation.
-- [ ] Task 22.2: Implement orchestration adapter layer
-  - [ ] Subtask 22.2.1: Compose existing plan, todo, budget, checkpoint, and loop primitives
-  - [ ] Subtask 22.2.2: Add deterministic state machine transitions
-  - [ ] Subtask 22.2.3: Add explain mode showing decisions and fallbacks
+- [x] Task 22.2: Implement orchestration adapter layer
+  - [x] Subtask 22.2.1: Compose existing plan, todo, budget, checkpoint, and loop primitives
+  - [x] Subtask 22.2.2: Add deterministic state machine transitions
+  - [x] Subtask 22.2.3: Add explain mode showing decisions and fallbacks
+  - [x] Notes: Added `scripts/autoflow_adapter.py` to compose runtime primitives (`plan`, `todo`, `budget`, `checkpoint`, `resume`, `loop_guard`) and resolve deterministic intent transitions with explain traces and fallback reason codes.
 - [ ] Task 22.3: Add safety and usability controls
   - [ ] Subtask 22.3.1: Add `dry-run` to preview actions without mutating state
   - [ ] Subtask 22.3.2: Add explicit kill-switch behavior for unsafe or runaway states

README.md

@@ -177,6 +177,13 @@ Current baseline includes:
 - concise human output plus structured `--json` schema for automation
 - lifecycle status model and safety defaults for dry-run, stop, and recovery gating
 
+Task 22.2 adapter baseline:
+
+- adapter module: `scripts/autoflow_adapter.py`
+- primitive composition: `plan`, `todo_compliance`, `budget`, `checkpoint`, `resume`, and `loop_guard`
+- deterministic transition matrix for `start|status|resume|stop|report|dry-run`
+- explain path that returns trace entries plus fallback intent/reason when transitions are illegal or resume gating fails
+
 ## Installed plugin stack 🔌
 
 - `@mohak34/opencode-notifier@latest` - desktop and sound alerts for completion, errors, and permission prompts.
@@ -1159,6 +1166,7 @@ For your LangGraph setup, default endpoint target is `http://localhost:3000/open
 - `scripts/stack_profile_command.py` - backend script for `/stack`
 - `scripts/browser_command.py` - backend script for `/browser`
 - `scripts/start_work_command.py` - backend script for `/start-work`
+- `scripts/autoflow_adapter.py` - orchestration adapter for `/autoflow` transition and explain planning
 - `scripts/budget_command.py` - backend script for `/budget`
 - `scripts/todo_command.py` - backend script for `/todo`
 - `scripts/resume_command.py` - backend script for `/resume`