cleveragents/cleveragents-core

Fork 3

UAT: `agents actor context list` command is missing — spec requires it but it is not implemented #2840

New issue

Open

opened 2026-04-04 20:47:46 +00:00 by freemo · 1 comment

freemo commented

2026-04-04 20:47:46 +00:00

Owner

Metadata

Branch: fix/actor-context-list-command-missing
Commit Message: fix(cli): implement agents actor context list command per v3 specification
Milestone: v3.2.0
Parent Epic: #392

Bug Report

Background and Context

The specification (docs/specification.md, line 284 and lines 5862–5976) defines the following CLI command:

agents actor context list [<REGEX>]

This command must list all named actor contexts, with an optional regex filter to narrow results. However, the implementation in src/cleveragents/cli/commands/actor_context.py only implements three commands:

context_remove (agents actor context remove)
context_export (agents actor context export)
context_import (agents actor context import)

The list command is completely absent. The module docstring confirms this omission: "Implements agents actor context remove, agents actor context export, and agents actor context import per the v3 specification" — list is not mentioned.

Steps to Reproduce

Run agents actor context list
Expected: Lists all named actor contexts (with optional regex filter)
Actual: Command not found error

Expected Behavior (from spec)

agents actor context list [<REGEX>]

Lists files stored in an actor context. Optional regex filter to narrow results.

Code Location

src/cleveragents/cli/commands/actor_context.py — missing context_list function and its Click command registration.

Impact

Any user or automated workflow attempting to enumerate actor contexts via the CLI will receive a command-not-found error. This is a spec-compliance gap that blocks actor context management workflows.

Subtasks

Add context_list function to src/cleveragents/cli/commands/actor_context.py implementing agents actor context list [<REGEX>]
Register the new context_list command with the actor_context Click group
Update the module docstring in actor_context.py to include agents actor context list
Write Behave unit test scenarios in features/ covering: listing all contexts (no filter), listing with a matching regex filter, and listing with a non-matching regex filter (empty result)
Ensure all nox stages pass (nox -e lint, nox -e typecheck, nox -e unit_tests, nox -e coverage_report)
Confirm test coverage remains ≥ 97%

Definition of Done

agents actor context list executes without error and lists all named actor contexts
agents actor context list <REGEX> correctly filters the output by the provided regex pattern
The module docstring in actor_context.py accurately reflects all four implemented commands including list
Behave feature file covers all three scenarios: no filter, matching filter, non-matching filter
All nox stages pass
Coverage >= 97%

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: ca-new-issue-creator

## Metadata - **Branch**: `fix/actor-context-list-command-missing` - **Commit Message**: `fix(cli): implement agents actor context list command per v3 specification` - **Milestone**: v3.2.0 - **Parent Epic**: #392 ## Bug Report ### Background and Context The specification (`docs/specification.md`, line 284 and lines 5862–5976) defines the following CLI command: ``` agents actor context list [<REGEX>] ``` This command must list all named actor contexts, with an optional regex filter to narrow results. However, the implementation in `src/cleveragents/cli/commands/actor_context.py` only implements three commands: - `context_remove` (`agents actor context remove`) - `context_export` (`agents actor context export`) - `context_import` (`agents actor context import`) The `list` command is completely absent. The module docstring confirms this omission: *"Implements `agents actor context remove`, `agents actor context export`, and `agents actor context import` per the v3 specification"* — `list` is not mentioned. ### Steps to Reproduce 1. Run `agents actor context list` 2. **Expected**: Lists all named actor contexts (with optional regex filter) 3. **Actual**: Command not found error ### Expected Behavior (from spec) ``` agents actor context list [<REGEX>] ``` Lists files stored in an actor context. Optional regex filter to narrow results. ### Code Location `src/cleveragents/cli/commands/actor_context.py` — missing `context_list` function and its Click command registration. ### Impact Any user or automated workflow attempting to enumerate actor contexts via the CLI will receive a command-not-found error. This is a spec-compliance gap that blocks actor context management workflows. ## Subtasks - [ ] Add `context_list` function to `src/cleveragents/cli/commands/actor_context.py` implementing `agents actor context list [<REGEX>]` - [ ] Register the new `context_list` command with the `actor_context` Click group - [ ] Update the module docstring in `actor_context.py` to include `agents actor context list` - [ ] Write Behave unit test scenarios in `features/` covering: listing all contexts (no filter), listing with a matching regex filter, and listing with a non-matching regex filter (empty result) - [ ] Ensure all nox stages pass (`nox -e lint`, `nox -e typecheck`, `nox -e unit_tests`, `nox -e coverage_report`) - [ ] Confirm test coverage remains ≥ 97% ## Definition of Done - [ ] `agents actor context list` executes without error and lists all named actor contexts - [ ] `agents actor context list <REGEX>` correctly filters the output by the provided regex pattern - [ ] The module docstring in `actor_context.py` accurately reflects all four implemented commands including `list` - [ ] Behave feature file covers all three scenarios: no filter, matching filter, non-matching filter - [ ] All nox stages pass - [ ] Coverage >= 97% --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: ca-new-issue-creator

freemo added this to the v3.2.0 milestone

2026-04-04 20:47:50 +00:00

freemo added a new dependency

2026-04-04 20:48:00 +00:00

#392 Epic: Actor YAML & Compiler

freemo referenced this issue

2026-04-04 20:51:19 +00:00

[CA-AUTO] UAT Pool Supervisor — v3.7.0 — Session Tracker #2803

freemo referenced this issue

2026-04-04 20:57:13 +00:00

[CA-AUTO] Project Owner — project-owner-1 — Session Tracker #2793

freemo referenced this issue

2026-04-04 20:57:37 +00:00

[CA-AUTO] UAT Pool Supervisor — v3.7.0 — Session Tracker #2803

freemo referenced this issue

2026-04-04 21:08:24 +00:00

[CA-AUTO] UAT Pool Supervisor — v3.7.0 — Session Tracker #2803

freemo referenced this issue

2026-04-05 02:44:00 +00:00

[CA-AUTO] UAT Pool Supervisor — v3.7.0 — Session Tracker #2875

freemo referenced this issue

2026-04-05 20:29:17 +00:00

[Automated] CleverAgents Build Session - 2026-04-05 #3572

freemo removed this from the v3.2.0 milestone

2026-04-06 22:29:13 +00:00

freemo commented

2026-04-06 22:29:30 +00:00

Author

Owner

This issue has been moved to the backlog as part of an aggressive grooming of the v3.2.0 milestone. It has been deemed non-critical for the minimal viability of the milestone and will be addressed in a future release.