refactor(output): Refactor actor, plan, and resource/tool/skill/config CLI commands to use OutputSession #8996

Open
opened 2026-04-14 04:36:14 +00:00 by HAL9000 · 1 comment
Owner

Background and Context

The Output Rendering Framework requires all CLI commands to produce structured output through the OutputSession pipeline. This issue covers the second batch of commands: actor commands, plan commands, and the remaining commands (resource, tool, skill, action, config, invariant, validation, lsp).

This is the second of two refactoring issues for CLI command migration (the first covers system/session/project commands in a sibling issue). Together they complete the full CLI migration to OutputSession.

Parent Epic: #936 (Epic: Output Rendering Pipeline Integration — Wire Commands to OutputSession Framework)

Acceptance Criteria

  • All actor commands (actor add, actor list, actor show, actor update, actor remove) route output through OutputSession
  • All plan commands (plan start, plan list, plan show, plan tree, plan correct, etc.) route output through OutputSession
  • All resource, tool, skill, action, config, invariant, validation, and lsp commands route output through OutputSession
  • Output envelope matches spec: {command, status, exit_code, data, timing, messages} for all commands
  • No command still calls format_output() directly for these command groups
  • All nox stages pass with coverage >= 97%

Subtasks

  • Refactor src/cleveragents/cli/commands/actor.py — all actor subcommands to use OutputSession
  • Refactor src/cleveragents/cli/commands/plan.py — all plan subcommands to use OutputSession
  • Refactor src/cleveragents/cli/commands/resource.py — all resource subcommands to use OutputSession
  • Refactor src/cleveragents/cli/commands/tool.py — all tool subcommands to use OutputSession
  • Refactor src/cleveragents/cli/commands/skill.py, action.py, config.py, invariant.py, validation.py, lsp.py
  • Ensure output envelope fields match spec for all refactored commands
  • Write/update unit tests for each refactored command verifying OutputSession is used
  • Write/update BDD scenarios for actor, plan, and resource command output structure
  • Run nox (all default sessions), fix any errors

Definition of Done

  • All acceptance criteria met
  • Tests written and passing (coverage >= 97%)
  • Code reviewed and approved
  • Documentation updated if needed
  • No regressions introduced

Metadata

  • Commit message: refactor(output): wire actor, plan, resource commands to OutputSession
  • Branch name: feat/output-session-actor-plan-resource

Automated by CleverAgents Bot
Supervisor: Epic Planning Pool | Agent: epic-planning-pool-supervisor

## Background and Context The Output Rendering Framework requires all CLI commands to produce structured output through the `OutputSession` pipeline. This issue covers the second batch of commands: actor commands, plan commands, and the remaining commands (resource, tool, skill, action, config, invariant, validation, lsp). This is the second of two refactoring issues for CLI command migration (the first covers system/session/project commands in a sibling issue). Together they complete the full CLI migration to `OutputSession`. Parent Epic: #936 (Epic: Output Rendering Pipeline Integration — Wire Commands to OutputSession Framework) ## Acceptance Criteria - [ ] All actor commands (`actor add`, `actor list`, `actor show`, `actor update`, `actor remove`) route output through `OutputSession` - [ ] All plan commands (`plan start`, `plan list`, `plan show`, `plan tree`, `plan correct`, etc.) route output through `OutputSession` - [ ] All resource, tool, skill, action, config, invariant, validation, and lsp commands route output through `OutputSession` - [ ] Output envelope matches spec: `{command, status, exit_code, data, timing, messages}` for all commands - [ ] No command still calls `format_output()` directly for these command groups - [ ] All nox stages pass with coverage >= 97% ## Subtasks - [ ] Refactor `src/cleveragents/cli/commands/actor.py` — all actor subcommands to use `OutputSession` - [ ] Refactor `src/cleveragents/cli/commands/plan.py` — all plan subcommands to use `OutputSession` - [ ] Refactor `src/cleveragents/cli/commands/resource.py` — all resource subcommands to use `OutputSession` - [ ] Refactor `src/cleveragents/cli/commands/tool.py` — all tool subcommands to use `OutputSession` - [ ] Refactor `src/cleveragents/cli/commands/skill.py`, `action.py`, `config.py`, `invariant.py`, `validation.py`, `lsp.py` - [ ] Ensure output envelope fields match spec for all refactored commands - [ ] Write/update unit tests for each refactored command verifying `OutputSession` is used - [ ] Write/update BDD scenarios for actor, plan, and resource command output structure - [ ] Run `nox` (all default sessions), fix any errors ## Definition of Done - [ ] All acceptance criteria met - [ ] Tests written and passing (coverage >= 97%) - [ ] Code reviewed and approved - [ ] Documentation updated if needed - [ ] No regressions introduced ## Metadata - **Commit message:** `refactor(output): wire actor, plan, resource commands to OutputSession` - **Branch name:** `feat/output-session-actor-plan-resource` --- **Automated by CleverAgents Bot** Supervisor: Epic Planning Pool | Agent: epic-planning-pool-supervisor
HAL9000 added this to the v3.5.0 milestone 2026-04-14 04:44:58 +00:00
Author
Owner

Verified — OutputSession refactor is needed for consistent CLI output. MoSCoW: Must-have. Priority: Medium.


Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: project-owner-pool-supervisor

✅ **Verified** — OutputSession refactor is needed for consistent CLI output. MoSCoW: Must-have. Priority: Medium. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor
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.

Reference
cleveragents/cleveragents-core#8996
No description provided.