UAT: `agents project show` rich output format does not match spec — missing Validations, Context, Indexing Status, and Active Plans sections #3570

New issue

Open

opened 2026-04-05 19:50:14 +00:00 by freemo · 1 comment

freemo commented

2026-04-05 19:50:14 +00:00

Owner

Metadata

Branch: fix/project-show-rich-output-spec-alignment
Commit Message: fix(cli): align project show Rich output with spec — add Validations, Context, Indexing Status, and Active Plans sections
Milestone: (none — backlog)
Parent Epic: #397

Background and Context

The agents project show command's Rich terminal output format does not match the specification. This was discovered during UAT testing of the CLI output rendering layer on 2026-04-05.

The implementation produces a single panel titled Project: <name> with only basic fields, but the spec (lines 3183–3232 of docs/specification.md) requires six distinct sections: Project Details, Linked Resources, Validations, Context, Indexing Status, and Active Plans, followed by a final status line.

Current Behavior

Rich output (from src/cleveragents/cli/commands/project.py, lines 884–940):

The implementation renders a single panel titled Project: <name> with only:

Name, Namespace, Description, Created, Updated
Linked Resources list (resource IDs only, no Type or Sandbox columns)

Missing from the implementation:

No Validations section (spec requires showing all validations attached to linked resources)
No Context section (spec requires showing context configuration: Include patterns, Exclude patterns, Max File Size)
No Indexing Status section (spec requires showing Text Index, Vector Index, Graph Store, Indexed Files, Last Indexed)
No Active Plans section (spec requires showing active plans targeting this project with Plan ID, Action, Phase columns)
Linked Resources table is missing Type and Sandbox columns (only resource IDs shown)
No ✓ OK Project loaded message at the end

Expected Behavior

Rich output (from docs/specification.md, lines 3183–3232):

╭─ Project Details ──────────────╮
│ Name: local/api-service        │
│ Description: Backend API       │
│ Resources: 2                   │
│ Remote: no                     │
│ Created: 2026-02-08 12:46      │
╰────────────────────────────────╯

╭─ Linked Resources ──────────────────────────────────────────────────────╮
│ Resource          Type            Sandbox              Read-Only        │
│ ────────────────  ──────────────  ────────────────────  ─────────       │
│ local/api-repo   git-checkout    git_worktree         no                │
│ local/staging-db local/database  transaction_rollback yes               │
╰─────────────────────────────────────────────────────────────────────────╯

╭─ Validations (3) ──────────────────────────────────────────────────────────────────╮
│ local/run-tests          Run unit tests with coverage    required                  │
│   resource: local/api-repo  scope: project  (attachment: 01HXM5A1B2C3D4E5F6G7…)    │
╰────────────────────────────────────────────────────────────────────────────────────╯

╭─ Context ───────────────────╮
│ Include: repo               │
│ Exclude: **/node_modules/** │
│ Max File Size: 1 MB         │
╰─────────────────────────────╯

╭─ Indexing Status ──────────╮
│ Text Index: ready          │
│ Vector Index: ready        │
│ Graph Store: disabled      │
│ Indexed Files: 347         │
│ Last Indexed: 12:48        │
╰────────────────────────────╯

╭─ Active Plans ──────────────────────────╮
│ Plan ID   Action               Phase    │
│ ────────  ───────────────────  ───────  │
│ 01HXM7A9  local/code-coverage  execute  │
╰─────────────────────────────────────────╯

✓ OK Project loaded

Acceptance Criteria

agents project show Rich output renders a Project Details panel with: Name, Description, Resources count, Remote, Created — matching the spec layout exactly.
The Linked Resources panel renders a table with columns: Resource, Type, Sandbox, Read-Only — matching the spec layout exactly.
A Validations panel appears showing all validations attached to linked resources, with name, description, mode, resource, scope, and attachment ID.
A Context panel appears showing: Include patterns, Exclude patterns, Max File Size.
An Indexing Status panel appears showing: Text Index, Vector Index, Graph Store, Indexed Files, Last Indexed.
An Active Plans panel appears showing a table with columns: Plan ID, Action, Phase.
The status line ✓ OK Project loaded appears after all panels.
The single Project: <name> panel is removed and replaced with the six-section layout.
All existing agents project show tests pass; new tests cover all six panels and the status line.

Supporting Information

Code location: src/cleveragents/cli/commands/project.py, show() function, lines 884–940.
Spec reference: docs/specification.md, lines 3183–3232 (CLI output rendering for project show).
Related: Epic #397 "Server & Autonomy Infrastructure" covers output rendering and CLI polish.
Similar issues: #3515 (agents project create output mismatch), #3519 (agents project link-resource output mismatch), #3565 (agents project list output mismatch).

Steps to Reproduce

Create a project: agents project create --description "Backend API" local/api-service
Run agents project show local/api-service
Observe the output — it shows a single panel with basic info instead of the spec-required six-section layout.

Impact

The missing Validations, Context, Indexing Status, and Active Plans sections mean users cannot see the full project state from project show. This is a significant functional gap since the spec explicitly defines these as required output sections. Users must resort to --output json or --output yaml to access this information, defeating the purpose of the Rich terminal output.

Subtasks

Replace the single Project: <name> panel in show() (lines 884–940 of project.py) with a Project Details panel containing: Name, Description, Resources count, Remote, Created.
Replace the resource IDs list with a Linked Resources table containing columns: Resource, Type, Sandbox, Read-Only.
Add a Validations panel showing all validations attached to linked resources (name, description, mode, resource, scope, attachment ID).
Add a Context panel showing: Include patterns, Exclude patterns, Max File Size.
Add an Indexing Status panel showing: Text Index, Vector Index, Graph Store, Indexed Files, Last Indexed.
Add an Active Plans panel showing a table with columns: Plan ID, Action, Phase.
Add the ✓ OK Project loaded status line after all panels.
Add/update Behave scenarios covering all six panels and the status line.
Run nox (all default sessions) and fix any errors.
Verify coverage >= 97% via nox -s coverage_report.

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, 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.
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%.

Backlog note: This issue was discovered during autonomous operation
on milestone v3.5.0. It does not block milestone completion and has been
placed in the backlog for human review and future milestone assignment.

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: ca-uat-tester

## Metadata - **Branch**: `fix/project-show-rich-output-spec-alignment` - **Commit Message**: `fix(cli): align project show Rich output with spec — add Validations, Context, Indexing Status, and Active Plans sections` - **Milestone**: *(none — backlog)* - **Parent Epic**: #397 ## Background and Context The `agents project show` command's Rich terminal output format does not match the specification. This was discovered during UAT testing of the CLI output rendering layer on 2026-04-05. The implementation produces a single panel titled `Project: <name>` with only basic fields, but the spec (lines 3183–3232 of `docs/specification.md`) requires six distinct sections: **Project Details**, **Linked Resources**, **Validations**, **Context**, **Indexing Status**, and **Active Plans**, followed by a final status line. ## Current Behavior **Rich output** (from `src/cleveragents/cli/commands/project.py`, lines 884–940): The implementation renders a single panel titled `Project: <name>` with only: - Name, Namespace, Description, Created, Updated - Linked Resources list (resource IDs only, no Type or Sandbox columns) Missing from the implementation: - No `Validations` section (spec requires showing all validations attached to linked resources) - No `Context` section (spec requires showing context configuration: Include patterns, Exclude patterns, Max File Size) - No `Indexing Status` section (spec requires showing Text Index, Vector Index, Graph Store, Indexed Files, Last Indexed) - No `Active Plans` section (spec requires showing active plans targeting this project with Plan ID, Action, Phase columns) - Linked Resources table is missing `Type` and `Sandbox` columns (only resource IDs shown) - No `✓ OK Project loaded` message at the end ## Expected Behavior **Rich output** (from `docs/specification.md`, lines 3183–3232): ``` ╭─ Project Details ──────────────╮ │ Name: local/api-service │ │ Description: Backend API │ │ Resources: 2 │ │ Remote: no │ │ Created: 2026-02-08 12:46 │ ╰────────────────────────────────╯ ╭─ Linked Resources ──────────────────────────────────────────────────────╮ │ Resource Type Sandbox Read-Only │ │ ──────────────── ────────────── ──────────────────── ───────── │ │ local/api-repo git-checkout git_worktree no │ │ local/staging-db local/database transaction_rollback yes │ ╰─────────────────────────────────────────────────────────────────────────╯ ╭─ Validations (3) ──────────────────────────────────────────────────────────────────╮ │ local/run-tests Run unit tests with coverage required │ │ resource: local/api-repo scope: project (attachment: 01HXM5A1B2C3D4E5F6G7…) │ ╰────────────────────────────────────────────────────────────────────────────────────╯ ╭─ Context ───────────────────╮ │ Include: repo │ │ Exclude: **/node_modules/** │ │ Max File Size: 1 MB │ ╰─────────────────────────────╯ ╭─ Indexing Status ──────────╮ │ Text Index: ready │ │ Vector Index: ready │ │ Graph Store: disabled │ │ Indexed Files: 347 │ │ Last Indexed: 12:48 │ ╰────────────────────────────╯ ╭─ Active Plans ──────────────────────────╮ │ Plan ID Action Phase │ │ ──────── ─────────────────── ─────── │ │ 01HXM7A9 local/code-coverage execute │ ╰─────────────────────────────────────────╯ ✓ OK Project loaded ``` ## Acceptance Criteria - [ ] `agents project show` Rich output renders a **Project Details** panel with: Name, Description, Resources count, Remote, Created — matching the spec layout exactly. - [ ] The **Linked Resources** panel renders a table with columns: **Resource**, **Type**, **Sandbox**, **Read-Only** — matching the spec layout exactly. - [ ] A **Validations** panel appears showing all validations attached to linked resources, with name, description, mode, resource, scope, and attachment ID. - [ ] A **Context** panel appears showing: Include patterns, Exclude patterns, Max File Size. - [ ] An **Indexing Status** panel appears showing: Text Index, Vector Index, Graph Store, Indexed Files, Last Indexed. - [ ] An **Active Plans** panel appears showing a table with columns: **Plan ID**, **Action**, **Phase**. - [ ] The status line `✓ OK Project loaded` appears after all panels. - [ ] The single `Project: <name>` panel is removed and replaced with the six-section layout. - [ ] All existing `agents project show` tests pass; new tests cover all six panels and the status line. ## Supporting Information - **Code location**: `src/cleveragents/cli/commands/project.py`, `show()` function, lines 884–940. - **Spec reference**: `docs/specification.md`, lines 3183–3232 (CLI output rendering for `project show`). - **Related**: Epic #397 "Server & Autonomy Infrastructure" covers output rendering and CLI polish. - **Similar issues**: #3515 (`agents project create` output mismatch), #3519 (`agents project link-resource` output mismatch), #3565 (`agents project list` output mismatch). ## Steps to Reproduce 1. Create a project: `agents project create --description "Backend API" local/api-service` 2. Run `agents project show local/api-service` 3. Observe the output — it shows a single panel with basic info instead of the spec-required six-section layout. ## Impact The missing Validations, Context, Indexing Status, and Active Plans sections mean users cannot see the full project state from `project show`. This is a significant functional gap since the spec explicitly defines these as required output sections. Users must resort to `--output json` or `--output yaml` to access this information, defeating the purpose of the Rich terminal output. ## Subtasks - [ ] Replace the single `Project: <name>` panel in `show()` (lines 884–940 of `project.py`) with a **Project Details** panel containing: Name, Description, Resources count, Remote, Created. - [ ] Replace the resource IDs list with a **Linked Resources** table containing columns: Resource, Type, Sandbox, Read-Only. - [ ] Add a **Validations** panel showing all validations attached to linked resources (name, description, mode, resource, scope, attachment ID). - [ ] Add a **Context** panel showing: Include patterns, Exclude patterns, Max File Size. - [ ] Add an **Indexing Status** panel showing: Text Index, Vector Index, Graph Store, Indexed Files, Last Indexed. - [ ] Add an **Active Plans** panel showing a table with columns: Plan ID, Action, Phase. - [ ] Add the `✓ OK Project loaded` status line after all panels. - [ ] Add/update Behave scenarios covering all six panels and the status line. - [ ] Run `nox` (all default sessions) and fix any errors. - [ ] Verify coverage >= 97% via `nox -s coverage_report`. ## 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, 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. - 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%. > **Backlog note:** This issue was discovered during autonomous operation > on milestone v3.5.0. It does not block milestone completion and has been > placed in the backlog for human review and future milestone assignment. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: ca-uat-tester

freemo added this to the v3.7.0 milestone

2026-04-05 20:14:46 +00:00

freemo commented

2026-04-05 20:15:11 +00:00

Author

Owner

Issue triaged by project owner:

State: Verified
Priority: Low — agents project show Rich output shows a single panel instead of spec-required six sections (Project Details, Linked Resources, Validations, Context, Indexing Status, Active Plans).
Milestone: v3.7.0
Story Points: 5 — L — Requires adding 5 new panels with data from multiple sources (validations, context config, indexing status, active plans). More complex than other CLI output issues.
MoSCoW: Could Have — Output formatting polish. Part of the same pattern as #3515, #3519, #3565. The command works; the output just doesn't match the spec layout.
Parent Epic: #397 (dependency link already exists)

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

Issue triaged by project owner: - **State**: Verified - **Priority**: Low — `agents project show` Rich output shows a single panel instead of spec-required six sections (Project Details, Linked Resources, Validations, Context, Indexing Status, Active Plans). - **Milestone**: v3.7.0 - **Story Points**: 5 — L — Requires adding 5 new panels with data from multiple sources (validations, context config, indexing status, active plans). More complex than other CLI output issues. - **MoSCoW**: Could Have — Output formatting polish. Part of the same pattern as #3515, #3519, #3565. The command works; the output just doesn't match the spec layout. - **Parent Epic**: #397 (dependency link already exists) --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: ca-project-owner

freemo removed this from the v3.7.0 milestone

2026-04-06 23:38:25 +00:00