feat(cli): align action commands to spec #238

Closed
opened 2026-02-22 23:40:25 +00:00 by freemo · 1 comment
Owner

Metadata

  • Commit: feat(cli): align action commands to spec
  • Branch: feature/m1-action-cli

Subtasks

  • Enforce config-only agents action create --config <file>; reject legacy flags and inline overrides.
  • Load config via ActionConfigSchema.from_yaml_file()Action.from_config() and surface file/line validation errors.
  • Remove action available; align action list/show/archive to namespaced names with --namespace + --state filters.
  • Ensure action CLI output includes namespaced name, short_name, state, actor refs, and definition_of_done summary.
  • Update docs/reference/action_cli.md with config-only flow, filters, and error cases.
  • Tests (Behave): Add scenarios for config-only create, legacy flag rejection, and list/show filters.
  • Tests (Robot): Add Robot smoke for action create/list/show/archive (DB-backed).
  • Tests (ASV): Add benchmarks/action_cli_bench.py for config load + parsing overhead.
  • Run nox (all default sessions, including benchmark), fix any errors if needed ensuring nox passes.
  • Verify coverage >=97% via nox -s coverage_report. If coverage is <97% then review the current unit test coverage report at build/coverage.xml and use it to write new Behave based unit tests to improve code coverage. Specifically, write Behave style unit tests that are descriptively named and specifically improves coverage on whichever file has the most uncovered lines by writing tests that will target the uncovered lines in the report. Once that is done rerun nox -s coverage_report to verify all tests pass and coverage is above >=97%. Only mark this as complete once coverage is >=97%, if not repeat this task as many times as is needed until coverage reaches >=97%.

Section: #### Section 3 Notes
Status: Completed

## Metadata - **Commit**: `feat(cli): align action commands to spec` - **Branch**: `feature/m1-action-cli` ## Subtasks - [x] Enforce config-only `agents action create --config <file>`; reject legacy flags and inline overrides. - [x] Load config via `ActionConfigSchema.from_yaml_file()` → `Action.from_config()` and surface file/line validation errors. - [x] Remove `action available`; align `action list/show/archive` to namespaced names with `--namespace` + `--state` filters. - [x] Ensure action CLI output includes namespaced name, short_name, state, actor refs, and definition_of_done summary. - [x] Update `docs/reference/action_cli.md` with config-only flow, filters, and error cases. - [x] Tests (Behave): Add scenarios for config-only create, legacy flag rejection, and list/show filters. - [x] Tests (Robot): Add Robot smoke for action create/list/show/archive (DB-backed). - [x] Tests (ASV): Add `benchmarks/action_cli_bench.py` for config load + parsing overhead. - [x] Run `nox` (all default sessions, including benchmark), fix any errors if needed ensuring nox passes. - [x] Verify coverage >=97% via `nox -s coverage_report`. If coverage is <97% then review the current unit test coverage report at `build/coverage.xml` and use it to write new Behave based unit tests to improve code coverage. Specifically, write Behave style unit tests that are descriptively named and specifically improves coverage on whichever file has the most uncovered lines by writing tests that will target the uncovered lines in the report. Once that is done rerun `nox -s coverage_report` to verify all tests pass and coverage is above >=97%. Only mark this as complete once coverage is >=97%, if not repeat this task as many times as is needed until coverage reaches >=97%. **Section**: #### Section 3 Notes **Status**: Completed
freemo added this to the v3.0.0 milestone 2026-02-22 23:40:25 +00:00
freemo self-assigned this 2026-02-22 23:40:25 +00:00
Author
Owner

Implementation Notes — A4b.action: Action CLI Spec Alignment

2026-02-14: Stage A4b.action Complete - Action CLI Spec Alignment

  • Rewrote action.py: config-only action create --config <file>, removed action available command, added filters to action list.

(Migrated from docs/implementation-notes.md)

## Implementation Notes — A4b.action: Action CLI Spec Alignment **2026-02-14**: Stage A4b.action Complete - Action CLI Spec Alignment - Rewrote `action.py`: config-only `action create --config <file>`, removed `action available` command, added filters to `action list`. *(Migrated from `docs/implementation-notes.md`)*
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Blocks Depends on
#61 feat(cli): align action commands to spec
cleveragents/cleveragents-core
Reference
cleveragents/cleveragents-core#238
No description provided.