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

Merged

freemo merged 1 commit from feature/m4-cli-extensions into master

2026-02-24 14:04:53 +00:00

freemo commented

2026-02-24 10:28:26 +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

Rows
Columns