pcli/openspec/changes/archive/2026-02-11-add-status-command/specs/cli-commands/spec.md

ADDED Requirements

Requirement: Status command

The system SHALL provide a top-level status command registered directly on the root command (not as a subcommand of any resource group). pcli status SHALL take no positional arguments. The command SHALL fetch all boards via ListBoards, then fetch each board's details via GetBoard sequentially, aggregate card counts per list, and output the result via the standard output.Print mechanism respecting the global --format flag.

Scenario: Run status command

• WHEN pcli status is executed
• THEN the system SHALL output a summary of all boards with their lists and card counts

Scenario: Status command respects format flag

• WHEN pcli status --format table is executed
• THEN the output SHALL be in table format

Scenario: Status command default format

• WHEN pcli status is executed without a --format flag
• THEN the output SHALL be in JSON envelope format