v0.7.0-beta.0 - Experimental OpenCode adapter and provider profiles

Summary

CEWP v0.7.0-beta.0 adds the Phase 7 external provider foundation.

This release introduces the first experimental external CLI adapter path with OpenCode, adds provider profile read models, improves binary/version/auth readiness reporting, and documents the future provider/model/terminal orchestration direction for CEWP.

OpenCode support is experimental. Claude Code, Gemini CLI, Hermes, desktop UI, WebSocket/server runtime, and long-running interactive terminal sessions are not implemented yet.

Added / Improved

• Added external adapter contract harness
• Added experimental opencode provider
• Added OpenCode command contract
• Added shared adapter CLI probe/version reporting
• Added experimental OpenCode execution MVP
• Added OpenCode failure diagnostics for invalid JSON, nonzero exit, timeout, missing binary, and silent provider failures
• Added safe OpenCode dogfood guidance
• Added provider profile architecture and terminal orchestration design docs
• Added provider-profile/v1 read model
• Added OpenCode model override support
• Clarified binary readiness vs auth/model readiness
• Improved doctor output for provider profiles and optional OpenCode availability

Safety

• OpenCode remains experimental and optional
• Missing OpenCode is non-fatal
• Binary availability does not imply auth/model readiness
• Claude/Gemini/Hermes providers were not added
• Desktop UI/server/interactive terminal sessions were not added
• Runtime guardrails were not weakened
• Scope checks were not changed
• Reviewer Decision: PASS finalize gate remains unchanged
• No automatic merge, push, publish, tag, or release behavior was added

Validation

• node ./bin/cewp.js --help
• node ./bin/cewp.js doctor
• npm test
• npm run smoke
• npm run check
• npm run pack:dry-run
• npm pack --dry-run
• Linux validation passed

v0.6.0-beta.0 - Adapter contract and runtime observability

Summary

CEWP v0.6.0-beta.0 adds the Phase 6 adapter contract and runtime observability foundation.

This release hardens the adapter model before adding external providers. It adds adapter capability metadata, a versioned adapter result contract, structured availability reporting, read-only run timeline projection, a stable operator JSON envelope, and typed artifact inventory for future TUI/desktop/web UI layers.

This release still supports only codex-exec and the non-executing manual adapter. Claude, Gemini, OpenCode, local model, and other external provider adapters are not implemented yet.

Added / Improved

• Added adapter capability metadata for codex-exec and manual
• Added adapter-result/v1 normalized adapter result shape
• Added structured adapter availability reporting
• Improved cewp doctor with adapter capability and availability summaries
• Added read-only run timeline projection from event JSONL files
• Added operator-json/v1 envelope for operator JSON output
• Added typed artifact inventory for run metadata, board metadata, manual handoffs, worker reports, reviewer reports, review packets, adapter last messages, and event files
• Preserved existing text output while improving JSON readiness for future UI layers
• Expanded smoke coverage for adapter contracts, availability, timeline projection, JSON envelope, artifact inventory, and package surface checks

Safety

• No external provider adapters were added
• Runtime guardrails were not changed
• Scope checks were not changed
• Reviewer Decision: PASS finalize gate remains unchanged
• codex-exec and manual remain the only supported providers
• The manual adapter remains non-executing
• Operator projections are read-only
• Local/private folders and test files are not included in the npm package surface

Validation

• node ./bin/cewp.js --help
• node ./bin/cewp.js doctor
• npm test
• npm run smoke
• npm run check
• npm run pack:dry-run
• npm pack --dry-run

v0.5.0-beta.0 - Operator run surface

Summary

CEWP v0.5.0-beta.0 adds the Phase 5 operator UX surface.

This release introduces read-only run browser and operator helper commands for understanding CEWP runs, inspecting current state, choosing the next safe action, and generating resume packets for handoff or continuation.

This release still supports only codex-exec and the non-executing manual adapter. Claude, Gemini, OpenCode, local model, and other external provider adapters are not implemented yet.

Added / Improved

• Added cewp run list as a read-only run browser
• Added cewp run status [run-id] for detailed run inspection
• Added cewp run next [run-id] to recommend the single next safe action
• Added cewp run resume [run-id] to print a compact handoff/resume packet
• Added --json output for run list, run status, run next, and run resume
• Added shared run inspection serialization for operator commands
• Added latest-run behavior across operator commands
• Added next-action labels such as complete-manual, collect, reviewer-dry-run, and finalize-dry-run
• Improved operator documentation around the run list → run status → run next → run resume workflow
• Expanded smoke coverage for JSON output, read-only behavior, no-runs/missing-run paths, and operator command help

Safety

• Operator commands are read-only
• No external provider adapters were added
• Runtime guardrails were not changed
• Scope checks were not changed
• Reviewer Decision: PASS finalize gate remains unchanged
• codex-exec and manual remain the only supported providers
• The manual adapter remains non-executing
• Local/private folders and test files are not included in the npm package surface

Validation

• node ./bin/cewp.js --help
• node ./bin/cewp.js doctor
• npm test
• npm run smoke
• npm run check
• npm run pack:dry-run
• npm pack --dry-run

v0.4.0-beta.0 - Manual adapter foundation

Summary

CEWP v0.4.0-beta.0 starts the Phase 4 adapter experiments line with the new non-executing manual adapter.

The manual adapter does not call Codex or any external AI tool. It writes handoff files, lets the user complete work manually, and provides a controlled way to record manual results back into the CEWP workflow.

This release still supports only codex-exec and manual. Claude, Gemini, OpenCode, local model, and other external provider adapters are not implemented yet.

Added / Improved

• Added the non-executing manual adapter
• Added manual handoff artifacts under .cewp/runs/<run-id>/manual/<role>.md
• Improved manual adapter dry-run and actual dispatch output
• Added clear handoff guidance with role, run ID, run path, working directory, expected output path, and completion commands
• Added manual result intake with cewp run dispatch complete <role> --from <file>
• Recorded manual results into the existing worker/reviewer artifact flow
• Added manual adapter support in config resolution and doctor/status surfaces
• Updated CLI help for --adapter <codex-exec|manual>
• Expanded smoke coverage for manual handoff, manual completion, dispatch dry-runs, and package surface checks
• Updated adapter contract and release notes documentation

Safety

• The manual adapter does not execute external commands
• External AI provider adapters were not added
• Runtime guardrails were not changed
• Scope checks were not changed
• Reviewer Decision: PASS finalize gate remains unchanged
• allowedFiles / forbiddenFiles behavior remains unchanged
• Local/private folders and test files are not included in the npm package surface

Validation

• node ./bin/cewp.js --help
• node ./bin/cewp.js doctor
• npm test
• npm run smoke
• npm run check
• npm run pack:dry-run
• npm pack --dry-run

v0.3.1-beta.0 - Adapter config hardening

Summary

CEWP v0.3.1-beta.0 continues the v0.3 adapter foundation work with adapter config hardening, doctor visibility, init template support, and CodeGraph workflow hygiene.

This release still supports only the codex-exec provider. External provider support is not implemented yet.

Added / Improved

• Added optional root-level cewp.config.json adapter config support
• Added cewp doctor adapter config source/provider summary
• Added cewp init --with-config to generate a starter adapter config template
• Hardened adapter config coverage across dispatch, workers, and pipeline dry-run flows
• Added CodeGraph-assisted discovery documentation and local index hygiene
• Added package surface guards for .codegraph/ and other local/private folders
• Updated install and adapter contract documentation

Safety

• External providers were not added
• Runtime guardrails were not changed
• allowedFiles / forbiddenFiles behavior remains unchanged
• Reviewer Decision: PASS finalize gate remains unchanged
• .codegraph/, .ctxo/, .cewp/, .cewp-worktrees/, and tests/ are not included in the npm package surface

Validation

• node ./bin/cewp.js --help
• node ./bin/cewp.js doctor
• npm test
• npm run smoke
• npm run check
• npm run pack:dry-run
• npm pack --dry-run

v0.3.0-beta.0 - Adapter foundation

Summary

CEWP v0.3.0-beta.0 introduces the first adapter foundation layer for Coordinator Mode.

This release does not add external provider support yet. The current production provider remains codex-exec, but the internal adapter boundary is now cleaner and better prepared for future provider experiments.

Added / Improved

• Formalized fake/test adapter harness
• Minimal internal adapter registry
• Adapter result shape normalization
• Role-based adapter config normalization foundation
• Dispatch adapter resolution through config helpers
• Centralized codex-exec command construction
• codex-exec availability checks in doctor/preflight
• Adapter contract documentation updates

Safety

• CEWP guardrails remain active
• allowedFiles / forbiddenFiles checks remain CEWP-owned
• Committed and uncommitted scope checks remain active
• Reviewer Decision: PASS gate remains required for finalize
• No automatic merge, push, publish, release, or tag behavior was added
• External provider support is not implemented in this release

Validation

• node ./bin/cewp.js --help
• node ./bin/cewp.js doctor
• node ./bin/cewp.js list
• npm test
• npm run smoke
• npm run check
• npm run pack:dry-run
• npm pack --dry-run
• Dev Node Linux validation PASS

v0.2.0-beta.2 - Lifecycle smoke and failure-path hardening

Summary

CEWP v0.2.0-beta.2 focuses on lifecycle test hardening, failure-path coverage, and public documentation cleanup after v0.2.0-beta.1.

Added / Improved

• Fake worker lifecycle smoke tests
• Fake reviewer lifecycle smoke tests
• Pipeline failure-path smoke tests
• Pipeline failure summary UX
• Dev Node validation workflow hardening
• Public adapter contract documentation
• Adapter roadmap details trimmed from public docs
• Package surface hygiene checks strengthened

Validation

• npm test
• npm run smoke
• npm run check
• npm run pack:dry-run
• Dev Node Linux validation PASS

Notes

No automatic merge, push, publish, release, or tag behavior was added. CEWP guardrails remain active.

v0.2.0-beta.1 - Policy enforcement and guardrail hardening

v0.2.0-beta.1 - Policy enforcement and guardrail hardening

This patch hardens the v0.2 Coordinator Mode runtime without changing the core workflow shape.

Highlights

• Added runtime enforcement for Operator Policy modes.

• safe is the default behavior when no policy file exists.

• High-impact local CEWP actions now require policy permission:

  • worker execution
  • reviewer execution
  • dispatch pipeline execution
  • finalize
  • cleanup
  • prune deletion

• full-authority now works as a real advanced local workflow mode while preserving CEWP guardrails.

• Real worker execution now requires explicit non-empty allowedFiles.

• Parallel worker execution now detects common overlapping scopes such as docs/** vs docs/install.md.

• External or absolute targetWorktree paths are blocked by default unless they resolve under the CEWP-managed worktree root.

• Added more harness coverage for policy gates, worker scope guardrails, parallel overlap detection, and target worktree policy.

• Added npm scripts for local validation:

  • npm test
  • npm run smoke
  • npm run check
  • npm run pack:dry-run

• Updated installer wording, package description, docs, and release notes.

Safety

• No automatic merge.
• No automatic push.
• No automatic publish or release.
• Cleanup and prune remain guarded.
• Reviewer PASS is still required for finalize.
• Worker scope checks include both uncommitted and committed branch changes.
• allowedFiles / forbiddenFiles guardrails remain active.
• full-authority does not disable CEWP safety checks.

Verification

Validated with:

node .\bin\cewp.js doctor
npm test
npm pack --dry-run

The npm package is published as:

npm install @setrathex/codex-engineering-workflow-pack

Current npm dist-tags:

latest: 0.2.0-beta.1
beta: 0.2.0-beta.1

v0.2.0-beta.0 - Coordinator Mode runtime and guarded parallel dispatch

Release Notes

0.2.0-beta.0

Summary

CEWP now includes a local-first Coordinator Mode runtime for multi-agent engineering workflows, with worktree isolation, dispatch planning, guarded Codex execution, parallel workers, reviewer gate, operator policy modes, harness smoke tests, and modularized CLI internals.

Added

• Coordinator Mode runtime under .cewp/runs/<run-id>/
• Worktree helpers: plan/create/status
• Review packet collection
• Finalize, cleanup, prune helpers
• Dispatch plan/check/prompts/start dry-run
• Guarded codex-exec adapter execution
• Sequential and parallel worker execution
• Reviewer execution
• Dispatch pipeline
• Operator policy config:
  • cewp policy show
  • cewp policy set safe
  • cewp policy set trusted
  • cewp policy set full-authority
  • cewp policy reset
• Harness smoke tests
• Modular src/** runtime structure

Safety

• No automatic merge
• No automatic push
• No automatic publish/release
• Cleanup is dry-run by default
• Finalize requires reviewer Decision: PASS
• Worker scope checks include both uncommitted and committed branch changes
• allowedFiles / forbiddenFiles guardrails remain active
• Full authority mode is supported but does not disable CEWP guardrails

Verification

• node --check ./bin/cewp.js
• node ./bin/cewp.js --help
• node ./bin/cewp.js doctor
• node ./bin/cewp.js list
• node ./tests/harness/run-smoke.js
• npm pack --dry-run