feat(cli): add action and plan CLI extensions #413

Merged
freemo merged 1 commits from feature/m4-cli-extensions into master 2026-02-24 14:04:53 +00:00
Owner

Summary

Adds extended CLI flags and enriched output for the plan and action command groups, enabling users to configure automation profiles, invariants, and actor overrides directly from the command line.

Changes

  • plan use command: Added --automation-profile, --invariant (repeatable), --strategy-actor, --execution-actor, --estimation-actor, and --invariant-actor flags. All actor flags validate namespaced names via validate_namespaced_actor(). Automation profiles are checked against BUILTIN_PROFILES. Flags persist to plan metadata.
  • plan status/list output: Added "Profile" and "Invariants" columns to the plan status summary and lifecycle-list tables. Expanded _plan_spec_dict with estimation_actor, invariant_actor, and invariants fields across all output formats (json, yaml, plain, table). Rich panel rendering in _print_lifecycle_plan now displays invariants with source provenance tags.
  • action show output: Extended _print_action and _action_spec_dict with estimation_actor, invariant_actor, invariants, inputs_schema, and automation_profile fields.
  • Documentation: Added docs/reference/plan_cli.md and updated docs/reference/action_cli.md with extended flags and examples.
  • Tests: 29 Behave scenarios (features/cli_extensions.feature), 5 Robot Framework integration tests (robot/cli_extensions.robot), and 6 ASV benchmark suites (benchmarks/cli_extensions_bench.py).

Closes #325

## Summary Adds extended CLI flags and enriched output for the `plan` and `action` command groups, enabling users to configure automation profiles, invariants, and actor overrides directly from the command line. ### Changes - **`plan use` command**: Added `--automation-profile`, `--invariant` (repeatable), `--strategy-actor`, `--execution-actor`, `--estimation-actor`, and `--invariant-actor` flags. All actor flags validate namespaced names via `validate_namespaced_actor()`. Automation profiles are checked against `BUILTIN_PROFILES`. Flags persist to plan metadata. - **`plan status/list` output**: Added "Profile" and "Invariants" columns to the plan status summary and lifecycle-list tables. Expanded `_plan_spec_dict` with `estimation_actor`, `invariant_actor`, and `invariants` fields across all output formats (json, yaml, plain, table). Rich panel rendering in `_print_lifecycle_plan` now displays invariants with source provenance tags. - **`action show` output**: Extended `_print_action` and `_action_spec_dict` with `estimation_actor`, `invariant_actor`, `invariants`, `inputs_schema`, and `automation_profile` fields. - **Documentation**: Added `docs/reference/plan_cli.md` and updated `docs/reference/action_cli.md` with extended flags and examples. - **Tests**: 29 Behave scenarios (`features/cli_extensions.feature`), 5 Robot Framework integration tests (`robot/cli_extensions.robot`), and 6 ASV benchmark suites (`benchmarks/cli_extensions_bench.py`). Closes #325
freemo added this to the v3.1.0 milestone 2026-02-24 10:29:19 +00:00
freemo added the
Type
Feature
label 2026-02-24 10:29:46 +00:00
freemo force-pushed feature/m4-cli-extensions from 33ba030b7d to aa008ba5d7 2026-02-24 13:41:12 +00:00 Compare
freemo scheduled this pull request to auto merge when all checks succeed 2026-02-24 13:41:29 +00:00
freemo merged commit aa008ba5d7 into master 2026-02-24 14:04:53 +00:00
freemo deleted branch feature/m4-cli-extensions 2026-02-24 14:04:53 +00:00
freemo added a new dependency 2026-02-24 14:17:00 +00:00
freemo self-assigned this 2026-02-24 14:22:26 +00:00
freemo added the
State
Completed
label 2026-03-04 00:58:29 +00:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Blocks
Reference: cleveragents/cleveragents-core#413