EPIC: CLI Output Format Compliance — Global Flags, JSON Envelope & Error Responses #5203
Labels
No labels
auto/needs-reevaluation
controller-managed
auto/blocked-by-deps
auto/ci-timeout
auto/claimed-implementer
auto/claimed-merge
auto/claimed-reviewer
auto/driver-down
auto/invariant-violation
auto/last-attempt-tier-0
auto/last-attempt-tier-1
auto/last-attempt-tier-2
auto/last-attempt-tier-min
Automation Tracking
auto/needs-conflict-resolution
auto/needs-implementer
auto/postmortem
auto/ready-to-merge
auto/restart-throttled
auto/revert
auto/sentinel
auto/stale-inactivity
auto/unstable
Blocked
Bounty
$100
Bounty
$1000
Bounty
$10000
Bounty
$20
Bounty
$2000
Bounty
$250
Bounty
$50
Bounty
$500
Bounty
$5000
Bounty
$750
MoSCoW
Could have
MoSCoW
Must have
MoSCoW
Should have
Needs Feedback
Points
1
Points
13
Points
2
Points
21
Points
3
Points
34
Points
5
Points
55
Points
8
Points
88
Priority
Backlog
Priority
CI Blocker
Priority
Critical
Priority
High
Priority
Low
Priority
Medium
Signed-off: Owner
Signed-off: Scrum Master
Signed-off: Tech Lead
Spike
State
Completed
State
Duplicate
State
In Progress
State
In Review
State
Paused
State
Unverified
State
Verified
State
Wont Do
Type
Automation
Type
Bug
Type
Discussion
Type
Documentation
Type
Epic
Type
Feature
Type
Legendary
Type
Refactor
Type
Support
Type
Task
Type
Testing
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Blocks
Depends on
#4942 LEGENDARY: Decision Intelligence — Plan Decisions, Corrections, Subplans & Checkpoints
cleveragents/cleveragents-core
#4794 UAT:
agents plan execute --format json hardcodes sandbox.strategy: "git_worktree" regardless of actual resource sandbox strategy
cleveragents/cleveragents-core
#5011 UAT:
agents actor remove missing --format option — inconsistent with all other actor subcommands
cleveragents/cleveragents-core
#5024 UAT:
--format help text inconsistency — color format omitted from per-command _FORMAT_HELP strings but present in constants.py
cleveragents/cleveragents-core
#5030 UAT:
agents skill refresh command exists in implementation but is not defined in the spec
cleveragents/cleveragents-core
#5033 UAT:
agents skill tools has undocumented --refresh flag not in spec
cleveragents/cleveragents-core
#5043 UAT:
agents tool add duplicate-tool error output format deviates from spec (plain format uses [ERROR] instead of Error:)
cleveragents/cleveragents-core
#5077 UAT:
agents actor run has undocumented --config option not in spec — bypasses actor registry
cleveragents/cleveragents-core
#5191 UAT: Global
--format flag ignored by subcommands — agents --format json session list outputs rich table instead of JSON
cleveragents/cleveragents-core
#5192 UAT: Global
--data-dir and --config-path flags not implemented — spec-required global flags raise NoSuchOption error
cleveragents/cleveragents-core
#5193 UAT: Global
-v verbosity flag not implemented — spec-required repeatable verbosity flag raises NoSuchOption error
cleveragents/cleveragents-core
#5194 UAT: JSON/YAML envelope
command field is always empty string — spec requires actual command name
cleveragents/cleveragents-core
#5195 UAT: JSON/YAML envelope missing
metadata field — spec requires top-level metadata object in envelope
cleveragents/cleveragents-core
#5196 UAT: JSON/YAML
messages[0].text is always "ok" — spec requires meaningful command-specific message text
cleveragents/cleveragents-core
#5197 UAT: JSON/YAML error responses not structured per spec — errors output plain text to stderr instead of structured JSON envelope
cleveragents/cleveragents-core
#5198 UAT: JSON/YAML envelope
timing.duration_ms is always 0 — command execution time not measured
cleveragents/cleveragents-core
#5528 UAT:
agents project link-resource output missing structured Resource Linked panel with Type and Access fields
cleveragents/cleveragents-core
#5534 UAT:
agents project unlink-resource fails if resource has been deleted — cannot clean up dangling links
cleveragents/cleveragents-core
#5588 UAT:
agents project context set rich output does not match spec — missing Limits, Summarization, and Other Views panels
cleveragents/cleveragents-core
#5591 UAT:
agents project context inspect does not return assembled context fragments with UKO URIs — uses stub simulation instead of live ACMS pipeline
cleveragents/cleveragents-core
#5594 UAT:
agents project context simulate uses stub simulation instead of live ACMS pipeline — does not show token budget breakdown per strategy
cleveragents/cleveragents-core
#5625 UAT:
agents resource type add output missing "New subcommand available" info message and multi-panel layout
cleveragents/cleveragents-core
#5628 UAT:
agents resource type remove output missing "Resources Using" count and "Subcommand Removed" panel
cleveragents/cleveragents-core
#5631 UAT:
agents resource type show output missing "Source" field and "Checkpointable" in sandbox section
cleveragents/cleveragents-core
#5632 UAT:
agents resource type list missing "✓ OK N resource types listed" success count message
cleveragents/cleveragents-core
#5634 UAT:
agents resource type JSON/YAML output uses resource_kind instead of physical_virtual as specified
cleveragents/cleveragents-core
#5730 UAT: Global
-v/--verbose repeatable flag missing from main_callback — spec requires count-based verbosity (ERROR→WARN→INFO→DEBUG→TRACE)
cleveragents/cleveragents-core
#5741 UAT:
CLEVERAGENTS_FORMAT env var not checked in CLI format resolution — spec-required tier in resolution chain is missing
cleveragents/cleveragents-core
#5743 UAT:
_print_basic_help() fast-path bypasses Typer and omits global flags (--format, -v, --data-dir, --config-path) from help output
cleveragents/cleveragents-core
#5752 UAT: Global
--format/-f short flag conflicts with init --force/-f — ambiguous argument parsing when using -f with init command
cleveragents/cleveragents-core
#5764 UAT:
agents audit export command is missing — spec requires JSON/CSV export of audit logs
cleveragents/cleveragents-core
#5891 UAT:
agents session list missing --actor filter option — cannot filter sessions by actor
cleveragents/cleveragents-core
#5902 UAT:
agents session list truncates session ID to 8 chars — cannot use displayed ID with other commands
cleveragents/cleveragents-core
#5967 UAT:
agents project link-resource JSON output does not match spec — missing resource_linked, access, and indexing fields
cleveragents/cleveragents-core
#5977 UAT:
agents project link-resource exposes raw SQLAlchemy IntegrityError when resource is already linked
cleveragents/cleveragents-core
#6083 UAT:
agents plan apply rich output uses generic single panel instead of spec-required multi-panel layout
cleveragents/cleveragents-core
#6095 UAT:
agents plan use, plan status, plan apply, and plan list JSON/YAML output missing spec-required envelope structure
cleveragents/cleveragents-core
#6100 UAT:
agents plan list Summary panel missing Cancelled count and Filters panel hidden when no filters active
cleveragents/cleveragents-core
#6111 UAT:
agents project create JSON/YAML output missing spec-required sections — paths, defaults, resources panels absent
cleveragents/cleveragents-core
#6126 UAT:
agents plan execute rich output uses generic single panel instead of spec-required multi-panel layout
cleveragents/cleveragents-core
#6160 UAT:
agents project show JSON/YAML output missing spec-required sections — validations, context, indexing_status, active_plans absent
cleveragents/cleveragents-core
#7039 BUG-HUNT: [error-handling] Overly broad
except Exception: patterns in CLI command modules mask critical errors
cleveragents/cleveragents-core
#7118 BUG-HUNT: [Security] SQLite URL parsing vulnerability allows path traversal in database checking
cleveragents/cleveragents-core
#7945 UAT: Plan CLI JSON outputs diverge from specification
cleveragents/cleveragents-core
Reference
cleveragents/cleveragents-core#5203
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Background
Part of the Decision Intelligence Legendary (#4942). This Epic fixes critical CLI output format compliance issues: global flags (
--format,--data-dir,--config-path,-v) not working, JSON/YAML envelope fields missing or incorrect, and error responses not structured per spec.Demonstrable Capability
When this Epic is complete, all CLI commands respect global flags, produce correctly structured JSON/YAML envelopes with all required fields, and return structured error responses instead of plain text.
Child Issues
--formatflag ignored by subcommands--data-dirand--config-pathflags not implemented-vverbosity flag not implementedcommandfield is always empty stringmetadatafieldmessages[0].textis always"ok"timing.duration_msis always 0Definition of Done
--formatflag propagates to all subcommands--data-dirand--config-pathflags functional-vverbosity flag works (repeatable)Metadata
fix/v3.2.0/cli-output-format-complianceAutomated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planner
--formatflag ignored by subcommands —agents --format json session listoutputs rich table instead of JSON--data-dirand--config-pathflags not implemented — spec-required global flags raise NoSuchOption error-vverbosity flag not implemented — spec-required repeatable verbosity flag raises NoSuchOption errorcommandfield is always empty string — spec requires actual command namemetadatafield — spec requires top-levelmetadataobject in envelopemessages[0].textis always"ok"— spec requires meaningful command-specific message texttiming.duration_msis always 0 — command execution time not measuredIssue triaged by project owner:
Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: project-owner
Epic Planning: This Epic was created to group 8 orphaned UAT issues related to global CLI flag compliance and JSON/YAML envelope format issues.
Child Issues Linked
--formatflag ignored by subcommands (Priority/Critical)--data-dirand--config-pathflags not implemented (Priority/Critical)-vverbosity flag not implemented (Priority/High)commandfield is always empty string (Priority/High)metadatafield (Priority/Medium)messages[0].textis always"ok"(Priority/Medium)timing.duration_msis always 0 (Priority/Backlog)Dependency Chain
Note: Issues #5191 and #5192 are Priority/Critical — global flags are fundamental to CLI usability.
Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planner
agents tool addduplicate-tool error output format deviates from spec (plain format uses[ERROR]instead ofError:)--formathelp text inconsistency —colorformat omitted from per-command_FORMAT_HELPstrings but present inconstants.pyagents actor runhas undocumented--configoption not in spec — bypasses actor registryagents skill toolshas undocumented--refreshflag not in specagents skill refreshcommand exists in implementation but is not defined in the specagents actor removemissing--formatoption — inconsistent with all other actor subcommandsagents plan execute --format jsonhardcodessandbox.strategy: "git_worktree"regardless of actual resource sandbox strategyagents project unlink-resourcefails if resource has been deleted — cannot clean up dangling linksagents project link-resourceoutput missing structured Resource Linked panel with Type and Access fieldsagents project context simulateuses stub simulation instead of live ACMS pipeline — does not show token budget breakdown per strategyagents project context inspectdoes not return assembled context fragments with UKO URIs — uses stub simulation instead of live ACMS pipelineagents project context setrich output does not match spec — missing Limits, Summarization, and Other Views panelsagents resource typeJSON/YAML output usesresource_kindinstead ofphysical_virtualas specifiedagents resource type listmissing "✓ OK N resource types listed" success count messageagents resource type showoutput missing "Source" field and "Checkpointable" in sandbox sectionagents resource type removeoutput missing "Resources Using" count and "Subcommand Removed" panelagents resource type addoutput missing "New subcommand available" info message and multi-panel layout-v/--verboserepeatable flag missing frommain_callback— spec requires count-based verbosity (ERROR→WARN→INFO→DEBUG→TRACE)CLEVERAGENTS_FORMATenv var not checked in CLI format resolution — spec-required tier in resolution chain is missing_print_basic_help()fast-path bypasses Typer and omits global flags (--format,-v,--data-dir,--config-path) from help output--format/-fshort flag conflicts withinit --force/-f— ambiguous argument parsing when using-fwithinitcommandagents audit exportcommand is missing — spec requires JSON/CSV export of audit logsCLEVERAGENTS_FORMATenv var not checked in CLI format resolution — spec-required tier in resolution chain is missing #5741_print_basic_help()fast-path bypasses Typer and omits global flags (--format,-v,--data-dir,--config-path) from help output #5743--format/-fshort flag conflicts withinit --force/-f— ambiguous argument parsing when using-fwithinitcommand #5752agents audit exportcommand is missing — spec requires JSON/CSV export of audit logs #5764agents session listtruncates session ID to 8 chars — cannot use displayed ID with other commandsagents session listmissing--actorfilter option — cannot filter sessions by actoragents project link-resourceexposes raw SQLAlchemyIntegrityErrorwhen resource is already linkedagents project link-resourceJSON output does not match spec — missingresource_linked,access, andindexingfieldsagents plan executerich output uses generic single panel instead of spec-required multi-panel layoutagents plan applyrich output uses generic single panel instead of spec-required multi-panel layoutagents plan listSummary panel missingCancelledcount and Filters panel hidden when no filters activeagents plan use,plan status,plan apply, andplan listJSON/YAML output missing spec-required envelope structureagents project showJSON/YAML output missing spec-required sections —validations,context,indexing_status,active_plansabsentagents project createJSON/YAML output missing spec-required sections —paths,defaults,resourcespanels absentexcept Exception:patterns in CLI command modules mask critical errors #7039except Exception:patterns in CLI command modules mask critical errors