UAT: Global `-v` verbosity flag not implemented — spec-required repeatable verbosity flag raises NoSuchOption error #5193

New issue

Open

opened 2026-04-09 03:06:34 +00:00 by HAL9000 · 0 comments

HAL9000 commented

2026-04-09 03:06:34 +00:00

Owner

Bug Report

Feature Area: CLI Commands — Global -v verbosity flag
Severity: High — verbosity control is a spec-required global flag; debugging and log-level control is broken
Source: src/cleveragents/cli/main.py (main_callback / app.callback)

What Was Tested

Runtime testing of the global -v verbosity flag as defined in the spec.

Expected Behavior (from spec §CLI Commands §Global Flags)

The spec defines -v as a repeatable global flag:

agents|cleveragents  ...
                     [-v...]
                     <COMMAND> [<ARGS>...]

Spec description:

-v: Increase log verbosity for a single invocation (repeatable). By default (no -v), only normal command output is shown on stdout; logging output is suppressed except on fatal errors. Each additional -v raises the verbosity one level:

-v = ERROR (non-fatal, recoverable errors)

-vv = WARN

-vvv = INFO

-vvvv = DEBUG

-vvvvv = TRACE

Actual Behavior

The -v flag raises a fatal error:

$ agents -v version
Error [500] INTERNAL: An unexpected error occurred
Wrapping unexpected exception: NoSuchOption: No such option: -v

Exit code: 1

Root Cause

The main_callback in src/cleveragents/cli/main.py does not define a -v parameter. The app.callback() decorator only defines --version, --show-secrets, and --format. The -v verbosity flag is completely absent from the implementation.

Note: Some subcommands (e.g., actor run) have their own --verbose/-v flag, but the global -v for log verbosity control is not implemented.

Steps to Reproduce

agents -v version
# Expected: version output with ERROR-level logging enabled
# Actual: Error [500] INTERNAL: NoSuchOption: No such option: -v

agents -vvv version
# Expected: version output with INFO-level logging enabled
# Actual: Error [500] INTERNAL: NoSuchOption: No such option: -v

Impact

Developers cannot increase log verbosity for debugging without modifying config files
The spec's documented debugging workflow (-vvvv for DEBUG output) is completely unavailable
Log verbosity is stuck at WARNING level (the hardcoded default in configure_structlog)

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

## Bug Report **Feature Area:** CLI Commands — Global `-v` verbosity flag **Severity:** High — verbosity control is a spec-required global flag; debugging and log-level control is broken **Source:** `src/cleveragents/cli/main.py` (main_callback / app.callback) --- ## What Was Tested Runtime testing of the global `-v` verbosity flag as defined in the spec. ## Expected Behavior (from spec §CLI Commands §Global Flags) The spec defines `-v` as a repeatable global flag: ``` agents|cleveragents ... [-v...] <COMMAND> [<ARGS>...] ``` Spec description: > `-v`: Increase log verbosity for a single invocation (repeatable). By default (no `-v`), only normal command output is shown on stdout; logging output is suppressed except on fatal errors. Each additional `-v` raises the verbosity one level: > - `-v` = ERROR (non-fatal, recoverable errors) > - `-vv` = WARN > - `-vvv` = INFO > - `-vvvv` = DEBUG > - `-vvvvv` = TRACE ## Actual Behavior The `-v` flag raises a fatal error: ``` $ agents -v version Error [500] INTERNAL: An unexpected error occurred Wrapping unexpected exception: NoSuchOption: No such option: -v ``` Exit code: 1 ## Root Cause The `main_callback` in `src/cleveragents/cli/main.py` does not define a `-v` parameter. The `app.callback()` decorator only defines `--version`, `--show-secrets`, and `--format`. The `-v` verbosity flag is completely absent from the implementation. Note: Some subcommands (e.g., `actor run`) have their own `--verbose/-v` flag, but the global `-v` for log verbosity control is not implemented. ## Steps to Reproduce ```bash agents -v version # Expected: version output with ERROR-level logging enabled # Actual: Error [500] INTERNAL: NoSuchOption: No such option: -v agents -vvv version # Expected: version output with INFO-level logging enabled # Actual: Error [500] INTERNAL: NoSuchOption: No such option: -v ``` ## Impact - Developers cannot increase log verbosity for debugging without modifying config files - The spec's documented debugging workflow (`-vvvv` for DEBUG output) is completely unavailable - Log verbosity is stuck at WARNING level (the hardcoded default in `configure_structlog`) --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

labels

2026-04-09 03:06:37 +00:00

HAL9000 referenced this issue

2026-04-09 03:12:30 +00:00

EPIC: CLI Output Format Compliance — Global Flags, JSON Envelope & Error Responses #5203

HAL9000 added a new dependency

2026-04-09 03:12:46 +00:00