feat(cli): align actor commands to YAML #412

Merged
freemo merged 1 commits from feature/m3-actor-cli into master 2026-02-24 19:39:45 +00:00
Owner

Summary

Aligns the agents actor add/remove/list/show CLI commands to YAML-first actor configurations, namespaced names, and multi-format output support (--format json|yaml|plain). This brings the actor CLI in line with the YAML-based actor config schema introduced by the actor compiler work.

Changes

  • --format option: Added --format json|yaml|plain to list, show, add, and update commands for structured output serialization via format_output rendering.
  • --update flag: Added to the add command to support updating existing actors in place.
  • _actor_spec_dict helper: New helper for structured output serialization of actor specifications.
  • _print_actor update: Refactored to support format_output rendering across all output formats.
  • Documentation: Added CLI reference documentation for actor commands.
  • Tests: 11 Behave scenarios for CLI format scenarios, Robot Framework integration test for show output fields, and ASV benchmark (benchmarks/actor_cli_bench.py) for CLI parsing overhead.

Closes #288

## Summary Aligns the `agents actor add/remove/list/show` CLI commands to YAML-first actor configurations, namespaced names, and multi-format output support (`--format json|yaml|plain`). This brings the actor CLI in line with the YAML-based actor config schema introduced by the actor compiler work. ### Changes - **`--format` option**: Added `--format json|yaml|plain` to `list`, `show`, `add`, and `update` commands for structured output serialization via `format_output` rendering. - **`--update` flag**: Added to the `add` command to support updating existing actors in place. - **`_actor_spec_dict` helper**: New helper for structured output serialization of actor specifications. - **`_print_actor` update**: Refactored to support `format_output` rendering across all output formats. - **Documentation**: Added CLI reference documentation for actor commands. - **Tests**: 11 Behave scenarios for CLI format scenarios, Robot Framework integration test for `show` output fields, and ASV benchmark (`benchmarks/actor_cli_bench.py`) for CLI parsing overhead. Closes #288
freemo added this to the v3.1.0 milestone 2026-02-24 10:29:18 +00:00
freemo added the
Type
Feature
label 2026-02-24 10:29:45 +00:00
freemo added a new dependency 2026-02-24 14:24:53 +00:00
freemo force-pushed feature/m3-actor-cli from 67f0e18b5e to 11a6665863 2026-02-24 14:30:54 +00:00 Compare
freemo force-pushed feature/m3-actor-cli from 11a6665863 to 836f9dbbea 2026-02-24 18:45:24 +00:00 Compare
freemo scheduled this pull request to auto merge when all checks succeed 2026-02-24 18:45:38 +00:00
freemo force-pushed feature/m3-actor-cli from 836f9dbbea to f7993d7309 2026-02-24 19:12:03 +00:00 Compare
freemo scheduled this pull request to auto merge when all checks succeed 2026-02-24 19:12:23 +00:00
freemo merged commit f7993d7309 into master 2026-02-24 19:39:45 +00:00
freemo deleted branch feature/m3-actor-cli 2026-02-24 19:39:45 +00:00
freemo added the
State
Completed
label 2026-03-04 00:58:28 +00:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Blocks
#288 feat(cli): align actor commands to YAML
cleveragents/cleveragents-core
Reference: cleveragents/cleveragents-core#412