cleveragents/cleveragents-core

Fork 3

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

New issue

Open

opened 2026-04-04 20:51:40 +00:00 by freemo · 1 comment

freemo commented

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

Owner

Metadata

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

Background and Context

The v3 specification (docs/specification.md) defines the agents actor context show <NAME> command as part of the agents actor context command group. Actor contexts are the persistent memory/state associated with an actor, allowing it to maintain continuity and accumulated knowledge over time. The show command is essential for inspecting, debugging, and monitoring an actor's context state.

The current implementation in src/cleveragents/cli/commands/actor_context.py only implements three of the required commands:

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

The module docstring itself confirms the omission: "Implements agents actor context remove, agents actor context export, and agents actor context import per the v3 specification" — show is not mentioned.

The spec references at lines 285 and 5977–6025 both require this command to be present.

Current Behavior

Running agents actor context show <NAME> produces a "command not found" error. The context_show function does not exist anywhere in src/cleveragents/cli/commands/actor_context.py.

Steps to Reproduce:

Run agents actor context show docs
Expected: Shows content/details of the "docs" actor context (messages, metadata, and state)
Actual: Command not found error

Expected Behavior

Per the v3 specification (lines 285 and 5977–6025), the command:

agents actor context show <NAME>

should display the content of a named actor context, including messages, metadata, and state for the named context.

Acceptance Criteria

agents actor context show <NAME> is a registered CLI command
The command displays messages, metadata, and state for the named actor context
The command returns a clear error when the named context does not exist
The command output matches the format described in the v3 specification (lines 5977–6025)
The implementation is consistent with the style of the existing context_remove, context_export, and context_import commands in the same module
The module docstring is updated to include agents actor context show
All nox stages pass with no errors
Test coverage >= 97%

Supporting Information

Spec reference: docs/specification.md lines 285 and 5977–6025
Code location: src/cleveragents/cli/commands/actor_context.py — missing context_show function
Discovered during: UAT testing of the agents actor context command group

Subtasks

Implement context_show function in src/cleveragents/cli/commands/actor_context.py
Register context_show as the show subcommand of the actor_context Click group
Implement output formatting: display messages, metadata, and state for the named context
Implement error handling for non-existent context names
Update the module docstring to include agents actor context show
Tests (Behave): Add BDD scenarios for agents actor context show (happy path, missing context)
Tests (Robot): Add integration test for agents actor context show
Verify coverage >= 97% via nox -s coverage_report
Run nox (all default sessions), fix any errors

Definition of Done

This issue is complete when:

All subtasks above are completed and checked off.
A Git commit is created where the first line of the commit message matches the Commit Message in Metadata exactly (fix(cli): implement missing agents actor context show command), followed by a blank line, then additional lines providing relevant details about the implementation.
The commit is pushed to the remote on the branch matching the Branch in Metadata exactly (fix/m3-actor-context-show-command).
The commit is submitted as a pull request to master, reviewed, and merged before this issue is marked done.
All nox stages pass.
Coverage >= 97%.

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

## Metadata - **Branch**: `fix/m3-actor-context-show-command` - **Commit Message**: `fix(cli): implement missing agents actor context show command` - **Milestone**: v3.2.0 - **Parent Epic**: #392 ## Background and Context The v3 specification (`docs/specification.md`) defines the `agents actor context show <NAME>` command as part of the `agents actor context` command group. Actor contexts are the persistent memory/state associated with an actor, allowing it to maintain continuity and accumulated knowledge over time. The `show` command is essential for inspecting, debugging, and monitoring an actor's context state. The current implementation in `src/cleveragents/cli/commands/actor_context.py` only implements three of the required commands: - `context_remove` (`agents actor context remove`) - `context_export` (`agents actor context export`) - `context_import` (`agents actor context import`) The module docstring itself confirms the omission: *"Implements `agents actor context remove`, `agents actor context export`, and `agents actor context import` per the v3 specification"* — `show` is not mentioned. The spec references at lines 285 and 5977–6025 both require this command to be present. ## Current Behavior Running `agents actor context show <NAME>` produces a "command not found" error. The `context_show` function does not exist anywhere in `src/cleveragents/cli/commands/actor_context.py`. **Steps to Reproduce:** 1. Run `agents actor context show docs` 2. **Expected:** Shows content/details of the "docs" actor context (messages, metadata, and state) 3. **Actual:** Command not found error ## Expected Behavior Per the v3 specification (lines 285 and 5977–6025), the command: ``` agents actor context show <NAME> ``` should display the content of a named actor context, including messages, metadata, and state for the named context. ## Acceptance Criteria - [ ] `agents actor context show <NAME>` is a registered CLI command - [ ] The command displays messages, metadata, and state for the named actor context - [ ] The command returns a clear error when the named context does not exist - [ ] The command output matches the format described in the v3 specification (lines 5977–6025) - [ ] The implementation is consistent with the style of the existing `context_remove`, `context_export`, and `context_import` commands in the same module - [ ] The module docstring is updated to include `agents actor context show` - [ ] All nox stages pass with no errors - [ ] Test coverage >= 97% ## Supporting Information - **Spec reference:** `docs/specification.md` lines 285 and 5977–6025 - **Code location:** `src/cleveragents/cli/commands/actor_context.py` — missing `context_show` function - **Discovered during:** UAT testing of the `agents actor context` command group ## Subtasks - [ ] Implement `context_show` function in `src/cleveragents/cli/commands/actor_context.py` - [ ] Register `context_show` as the `show` subcommand of the `actor_context` Click group - [ ] Implement output formatting: display messages, metadata, and state for the named context - [ ] Implement error handling for non-existent context names - [ ] Update the module docstring to include `agents actor context show` - [ ] Tests (Behave): Add BDD scenarios for `agents actor context show` (happy path, missing context) - [ ] Tests (Robot): Add integration test for `agents actor context show` - [ ] Verify coverage >= 97% via `nox -s coverage_report` - [ ] Run `nox` (all default sessions), fix any errors ## Definition of Done This issue is complete when: - All subtasks above are completed and checked off. - A Git commit is created where the **first line** of the commit message matches the Commit Message in Metadata exactly (`fix(cli): implement missing agents actor context show command`), followed by a blank line, then additional lines providing relevant details about the implementation. - The commit is pushed to the remote on the branch matching the **Branch** in Metadata exactly (`fix/m3-actor-context-show-command`). - The commit is submitted as a **pull request** to `master`, reviewed, and **merged** before this issue is marked done. - 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:51:47 +00:00

freemo added a new dependency

2026-04-04 20:52:06 +00:00

#392 Epic: Actor YAML & Compiler

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:09 +00:00

freemo commented

2026-04-06 22:29:27 +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.