feat(cli): implement context show and context clear CLI commands for ACMS #9586

Open
opened 2026-04-14 23:37:08 +00:00 by HAL9000 · 3 comments
Owner

Metadata

  • Commit message: feat(cli): implement context show and context clear CLI commands for ACMS
  • Branch name: feat/v3.4.0-context-show-clear-cli

Background and Context

Users need context show to view assembled context for a view and context clear to remove stale context entries. Without context show, users cannot inspect what context would be sent to an LLM for a given view. Without context clear, stale or unwanted context entries accumulate in the index with no way to remove them, degrading context quality over time.

Expected Behavior

When this issue is complete:

  • context show <view> displays assembled context with budget utilization summary
  • context clear removes entries by --path, --tag, or --tier with --yes bypass
  • Both commands have --help documentation
  • Unit tests pass with coverage >= 97%

Acceptance Criteria

  • context show <view> displays assembled context with budget utilization summary
  • context clear removes entries by --path, --tag, or --tier with --yes bypass
  • Both commands have --help documentation
  • Unit tests pass with coverage >= 97%

Subtasks

  • Implement context show command with budget utilization summary
  • Implement context clear command with path/tag/tier filtering
  • Implement confirmation prompt with --yes bypass
  • Write --help documentation
  • Write unit tests
  • Verify coverage >= 97%

Definition of Done

This issue is closed when:

  1. context show <view> displays the assembled context with budget utilization summary
  2. context clear removes entries by --path, --tag, or --tier filters
  3. Confirmation prompt is implemented with --yes bypass for non-interactive use
  4. --help documentation is complete for both commands
  5. All unit tests pass (happy path + error cases)
  6. Test coverage >= 97% for all code introduced in this issue
  7. Code is reviewed and merged into the target branch

Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor [AUTO-EPIC-3]

## Metadata - **Commit message**: `feat(cli): implement context show and context clear CLI commands for ACMS` - **Branch name**: `feat/v3.4.0-context-show-clear-cli` ## Background and Context Users need `context show` to view assembled context for a view and `context clear` to remove stale context entries. Without `context show`, users cannot inspect what context would be sent to an LLM for a given view. Without `context clear`, stale or unwanted context entries accumulate in the index with no way to remove them, degrading context quality over time. ## Expected Behavior When this issue is complete: - `context show <view>` displays assembled context with budget utilization summary - `context clear` removes entries by --path, --tag, or --tier with --yes bypass - Both commands have --help documentation - Unit tests pass with coverage >= 97% ## Acceptance Criteria - [ ] `context show <view>` displays assembled context with budget utilization summary - [ ] `context clear` removes entries by --path, --tag, or --tier with --yes bypass - [ ] Both commands have --help documentation - [ ] Unit tests pass with coverage >= 97% ## Subtasks - [ ] Implement `context show` command with budget utilization summary - [ ] Implement `context clear` command with path/tag/tier filtering - [ ] Implement confirmation prompt with --yes bypass - [ ] Write --help documentation - [ ] Write unit tests - [ ] Verify coverage >= 97% ## Definition of Done This issue is closed when: 1. `context show <view>` displays the assembled context with budget utilization summary 2. `context clear` removes entries by --path, --tag, or --tier filters 3. Confirmation prompt is implemented with --yes bypass for non-interactive use 4. --help documentation is complete for both commands 5. All unit tests pass (happy path + error cases) 6. Test coverage >= 97% for all code introduced in this issue 7. Code is reviewed and merged into the target branch --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor [AUTO-EPIC-3]
Author
Owner

[AUTO-OWNR-1] Triage Decision: Verified — MoSCoW/Must Have

Core ACMS v1 (Advanced Context Management System) feature for v3.4.0 (M5: ACMS v1 + Context Scaling). Must Have for milestone completion.

Milestone: v3.4.0
Priority: High


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


Automated by CleverAgents Bot
Agent: automation-tracking-manager

[AUTO-OWNR-1] **Triage Decision: Verified — MoSCoW/Must Have** Core ACMS v1 (Advanced Context Management System) feature for v3.4.0 (M5: ACMS v1 + Context Scaling). Must Have for milestone completion. **Milestone:** v3.4.0 **Priority:** High --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor --- **Automated by CleverAgents Bot** Agent: automation-tracking-manager
HAL9000 added this to the v3.4.0 milestone 2026-04-15 03:28:53 +00:00
Author
Owner

[AUTO-GROOM-9675] Re-opening issue — closed prematurely

This issue was closed at 2026-04-15T01:19:22Z, but the linked PR #9675 was not created until 2026-04-15T01:46:35Z and has not been merged. Furthermore, PR #9675 currently has an open REQUEST_CHANGES review (Review ID: 5797 by HAL9001) with multiple blocking CI and quality issues that must be resolved before merge.

Re-opening this issue and setting it to State/In Review to accurately reflect that the work is in active review but not yet complete. It will be closed automatically when PR #9675 is merged via the Closes #9586 keyword.

**[AUTO-GROOM-9675] Re-opening issue — closed prematurely** This issue was closed at `2026-04-15T01:19:22Z`, but the linked PR #9675 was not created until `2026-04-15T01:46:35Z` and has **not been merged**. Furthermore, PR #9675 currently has an open `REQUEST_CHANGES` review (Review ID: 5797 by HAL9001) with multiple blocking CI and quality issues that must be resolved before merge. Re-opening this issue and setting it to `State/In Review` to accurately reflect that the work is in active review but not yet complete. It will be closed automatically when PR #9675 is merged via the `Closes #9586` keyword.
HAL9000 reopened this issue 2026-04-15 19:02:42 +00:00
Author
Owner

[AUTO-OWNR-1] Triage complete.

Verified — Valid feature. context show and context clear CLI commands are required by the v3.4.0 acceptance criteria ("Context assembly CLI functional").

  • Type: Feature
  • Priority: High
  • MoSCoW: Must Have — context CLI commands are v3.4.0 acceptance criteria
  • Milestone: v3.4.0 — ACMS CLI

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

[AUTO-OWNR-1] Triage complete. **Verified** ✅ — Valid feature. `context show` and `context clear` CLI commands are required by the v3.4.0 acceptance criteria ("Context assembly CLI functional"). - **Type**: Feature - **Priority**: High - **MoSCoW**: Must Have — context CLI commands are v3.4.0 acceptance criteria - **Milestone**: v3.4.0 — ACMS CLI --- **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.

Dependencies

No dependencies set.

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