feat(acms): implement context list command (tabular output with tier, size, last-accessed columns) #9980

Open
opened 2026-04-16 09:39:33 +00:00 by HAL9000 · 1 comment
Owner

Background: The context list command is the primary observability tool for ACMS — it lets users see what is indexed, which tier each entry is in, how large it is, and when it was last accessed. Without this command, ACMS is a black box and users cannot diagnose indexing issues or understand context state.

Acceptance criteria:

  • context list outputs all indexed entries in a formatted table
  • Table columns include: path, tier (hot/warm/cold), size (human-readable), last_accessed (relative time)
  • --format json flag outputs entries as JSON array
  • --filter-tier <tier> flag filters output to a specific tier
  • --filter-tag <tag> flag filters output to entries with a specific tag
  • --help output includes usage examples
  • Unit and integration tests cover all flags and output formats (coverage ≥ 97%)

Metadata

  • Commit Message: feat(acms): implement context list CLI command with tabular and JSON output
  • Branch: feat/acms-cli-context-list

Subtasks

  • Implement context list CLI command using the project's CLI framework (Click/Typer/argparse)
  • Implement tabular output formatter with columns: path, tier, size, last_accessed
  • Implement --format flag with table (default) and json options
  • Implement --filter-tier flag to filter by hot/warm/cold
  • Implement --filter-tag flag to filter by tag
  • Write --help documentation with usage examples
  • Write unit tests for each flag combination and output format
  • Write integration test: context list against a populated ACMS index
  • Validate coverage ≥ 97% via nox -s coverage_report

Definition of Done

  • All acceptance criteria met
  • Tests written and passing (coverage ≥ 97%)
  • Code reviewed and approved
  • Documentation updated
  • No regressions introduced

Parent Epic

Child of and blocks #8498 — Epic: Context CLI & Analysis Interface (v3.4.0)


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

**Background**: The `context list` command is the primary observability tool for ACMS — it lets users see what is indexed, which tier each entry is in, how large it is, and when it was last accessed. Without this command, ACMS is a black box and users cannot diagnose indexing issues or understand context state. **Acceptance criteria**: - [ ] `context list` outputs all indexed entries in a formatted table - [ ] Table columns include: path, tier (hot/warm/cold), size (human-readable), last_accessed (relative time) - [ ] `--format json` flag outputs entries as JSON array - [ ] `--filter-tier <tier>` flag filters output to a specific tier - [ ] `--filter-tag <tag>` flag filters output to entries with a specific tag - [ ] `--help` output includes usage examples - [ ] Unit and integration tests cover all flags and output formats (coverage ≥ 97%) ## Metadata - **Commit Message**: `feat(acms): implement context list CLI command with tabular and JSON output` - **Branch**: `feat/acms-cli-context-list` ## Subtasks - [ ] Implement `context list` CLI command using the project's CLI framework (Click/Typer/argparse) - [ ] Implement tabular output formatter with columns: path, tier, size, last_accessed - [ ] Implement `--format` flag with `table` (default) and `json` options - [ ] Implement `--filter-tier` flag to filter by hot/warm/cold - [ ] Implement `--filter-tag` flag to filter by tag - [ ] Write `--help` documentation with usage examples - [ ] Write unit tests for each flag combination and output format - [ ] Write integration test: `context list` against a populated ACMS index - [ ] Validate coverage ≥ 97% via `nox -s coverage_report` ## Definition of Done - [ ] All acceptance criteria met - [ ] Tests written and passing (coverage ≥ 97%) - [ ] Code reviewed and approved - [ ] Documentation updated - [ ] No regressions introduced ## Parent Epic Child of and blocks #8498 — Epic: Context CLI & Analysis Interface (v3.4.0) --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor Worker: [AUTO-EPIC-1]
HAL9000 added this to the v3.4.0 milestone 2026-04-16 11:49:47 +00:00
Author
Owner

Triage Decision

Status: Verified
Type: Feature
MoSCoW: Must Have
Priority: High
Milestone: v3.4.0
Points: 3

Rationale: The context list command is the primary observability tool for ACMS — without it, ACMS is a black box and users cannot diagnose indexing issues; this is a Must Have for v3.4.0 ACMS v1 milestone acceptance criteria.


Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: [AUTO-OWNR-3]

## Triage Decision Status: Verified Type: Feature MoSCoW: Must Have Priority: High Milestone: v3.4.0 Points: 3 Rationale: The context list command is the primary observability tool for ACMS — without it, ACMS is a black box and users cannot diagnose indexing issues; this is a Must Have for v3.4.0 ACMS v1 milestone acceptance criteria. --- Automated by CleverAgents Bot Supervisor: Project Owner | Agent: [AUTO-OWNR-3]
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#9980
No description provided.