feat(cli): implement context list and context add CLI commands for ACMS #9585

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

Metadata

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

Background and Context

Users need context list to view all indexed entries and context add to add files/directories to the ACMS index. Without these commands, ACMS is a black box — users cannot see what context is indexed or add new context entries. These are the foundational read/write CLI commands for ACMS user interaction.

Expected Behavior

When this issue is complete:

  • context list displays all indexed entries with tier, size, last-accessed metadata
  • context add <path> indexes a file or directory with optional --tag and --policy flags
  • Both commands have --help documentation
  • --format flag supports JSON/table output
  • Unit tests pass with coverage >= 97%

Acceptance Criteria

  • context list displays all indexed entries with tier, size, last-accessed metadata
  • context add <path> indexes a file or directory with optional --tag and --policy flags
  • Both commands have --help documentation
  • --format flag supports JSON/table output
  • Unit tests pass with coverage >= 97%

Subtasks

  • Implement context list command with tabular output
  • Implement context add command with --tag and --policy flags
  • Implement --format flag for JSON/table switching
  • Write --help documentation
  • Write unit tests
  • Verify coverage >= 97%

Definition of Done

This issue is closed when:

  1. context list command displays all indexed entries with tier, size, and last-accessed metadata
  2. context add <path> successfully indexes files and directories with --tag and --policy flags
  3. --format flag switches output between JSON and table formats
  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 list and context add CLI commands for ACMS` - **Branch name**: `feat/v3.4.0-context-list-add-cli` ## Background and Context Users need `context list` to view all indexed entries and `context add` to add files/directories to the ACMS index. Without these commands, ACMS is a black box — users cannot see what context is indexed or add new context entries. These are the foundational read/write CLI commands for ACMS user interaction. ## Expected Behavior When this issue is complete: - `context list` displays all indexed entries with tier, size, last-accessed metadata - `context add <path>` indexes a file or directory with optional --tag and --policy flags - Both commands have --help documentation - --format flag supports JSON/table output - Unit tests pass with coverage >= 97% ## Acceptance Criteria - [ ] `context list` displays all indexed entries with tier, size, last-accessed metadata - [ ] `context add <path>` indexes a file or directory with optional --tag and --policy flags - [ ] Both commands have --help documentation - [ ] --format flag supports JSON/table output - [ ] Unit tests pass with coverage >= 97% ## Subtasks - [ ] Implement `context list` command with tabular output - [ ] Implement `context add` command with --tag and --policy flags - [ ] Implement --format flag for JSON/table switching - [ ] Write --help documentation - [ ] Write unit tests - [ ] Verify coverage >= 97% ## Definition of Done This issue is closed when: 1. `context list` command displays all indexed entries with tier, size, and last-accessed metadata 2. `context add <path>` successfully indexes files and directories with --tag and --policy flags 3. --format flag switches output between JSON and table formats 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 08:32:28 +00:00
HAL9000 reopened this issue 2026-04-15 19:36:33 +00:00
Author
Owner

[AUTO-OWNR-1] Triage complete.

Verified — Valid feature. context list and context add 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 list` and `context add` 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#9585
No description provided.