feat(decisions): implement agents plan explain CLI command #8528

Open
opened 2026-04-13 20:36:16 +00:00 by HAL9000 · 0 comments
Owner

Metadata

  • Commit message type: feat
  • Scope: decisions
  • Branch name prefix: feat/v3.2.0-plan-explain-cli

Background and Context

As part of Epic #8477 (Decision Recording & Persistence), the agents plan explain <decision-id> command provides users with full details for a single decision: context, rationale, alternatives considered, and outcome. This enables deep inspection of any decision in the plan.

This issue depends on the Decision data model and recording hooks being implemented first.

This issue blocks Epic #8477.

Expected Behavior

  • agents plan explain <decision-id> displays full details for the specified decision
  • Output includes: decision ID, phase, timestamp, context snapshot summary, alternatives considered, rationale, and outcome
  • If the decision has been corrected, the correction history is also shown
  • Output is formatted for readability in the terminal

Acceptance Criteria

  • agents plan explain <decision-id> command is registered in the CLI
  • Command requires a decision-id argument
  • Output shows all decision fields: ID, phase, timestamp, context summary, alternatives, rationale, outcome
  • If decision has corrections, correction history is displayed
  • Command handles unknown decision-id gracefully (shows clear error message)
  • Integration tests verify explain output for a known decision
  • Unit tests achieve >= 97% coverage for explain logic

Subtasks

  • Register plan explain subcommand in the CLI argument parser
  • Implement decision detail query (fetch single decision by ID with full context)
  • Implement formatted output for decision details
  • Add correction history display if corrections exist
  • Handle edge cases: unknown ID, malformed context snapshot
  • Write unit tests for explain output formatting
  • Write integration tests for agents plan explain end-to-end

Definition of Done

  1. agents plan explain <decision-id> command is functional
  2. Integration tests verify explain output for a known decision
  3. Unit tests pass with >= 97% coverage for new code
  4. Help text is updated for the new command
  5. Code reviewed and merged to main branch

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

## Metadata - **Commit message type**: `feat` - **Scope**: `decisions` - **Branch name prefix**: `feat/v3.2.0-plan-explain-cli` ## Background and Context As part of Epic #8477 (Decision Recording & Persistence), the `agents plan explain <decision-id>` command provides users with full details for a single decision: context, rationale, alternatives considered, and outcome. This enables deep inspection of any decision in the plan. This issue depends on the Decision data model and recording hooks being implemented first. This issue blocks Epic #8477. ## Expected Behavior - `agents plan explain <decision-id>` displays full details for the specified decision - Output includes: decision ID, phase, timestamp, context snapshot summary, alternatives considered, rationale, and outcome - If the decision has been corrected, the correction history is also shown - Output is formatted for readability in the terminal ## Acceptance Criteria - [ ] `agents plan explain <decision-id>` command is registered in the CLI - [ ] Command requires a `decision-id` argument - [ ] Output shows all decision fields: ID, phase, timestamp, context summary, alternatives, rationale, outcome - [ ] If decision has corrections, correction history is displayed - [ ] Command handles unknown decision-id gracefully (shows clear error message) - [ ] Integration tests verify explain output for a known decision - [ ] Unit tests achieve >= 97% coverage for explain logic ## Subtasks - [ ] Register `plan explain` subcommand in the CLI argument parser - [ ] Implement decision detail query (fetch single decision by ID with full context) - [ ] Implement formatted output for decision details - [ ] Add correction history display if corrections exist - [ ] Handle edge cases: unknown ID, malformed context snapshot - [ ] Write unit tests for explain output formatting - [ ] Write integration tests for `agents plan explain` end-to-end ## Definition of Done 1. `agents plan explain <decision-id>` command is functional 2. Integration tests verify explain output for a known decision 3. Unit tests pass with >= 97% coverage for new code 4. Help text is updated for the new command 5. Code reviewed and merged to main branch --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
HAL9000 added this to the v3.2.0 milestone 2026-04-13 20:57:05 +00:00
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.

Dependencies

No dependencies set.

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