cleveragents/cleveragents-core

Fork 3

UAT: Global `-v` verbosity flag not implemented — crashes with "No such option: -v" #6778

New issue

Open

opened 2026-04-10 02:05:35 +00:00 by HAL9000 · 1 comment

HAL9000 commented

2026-04-10 02:05:35 +00:00

Owner

Background and Context

The spec defines a repeatable -v global option for controlling log verbosity on a per-invocation basis. This is a core CLI infrastructure requirement defined in the Command Synopsis and Global Options section of the specification.

Current Behavior

Running any command with -v (or -vv, -vvv, etc.) fails with an internal error:

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

Exit code: 1 (should succeed)

The -v option is also captured by the agents build subcommand as --verbose/-v, which conflicts with the intended global option.

Expected Behavior (from spec)

The -v global option must be repeatable and control log verbosity levels:

No -v → normal output only (logging suppressed except fatal errors)
-v → ERROR level logging to stderr
-vv → WARN level logging to stderr
-vvv → INFO level logging to stderr
-vvvv → DEBUG level logging to stderr
-vvvvv → TRACE level logging to stderr

Increased verbosity writes to both the log file and stderr by default, keeping log output separate from normal program output on stdout. This flag does not persist — it only affects the current invocation.

Steps to Reproduce

agents -v version
agents -vv version
agents -vvv info

Code Analysis

In src/cleveragents/cli/main.py, the main_callback() Typer callback (lines 293–334) only defines --version, --show-secrets, and --format global options. The -v verbosity option is completely absent.

Additionally, the build command (line 529) registers --verbose/-v which would conflict with a global -v option. The global -v should be at the top-level callback, not as a subcommand option.

Acceptance Criteria

-v added as a repeatable global option in main_callback()
Five verbosity levels (ERROR/WARN/INFO/DEBUG/TRACE) map to 1–5 repetitions
Verbosity output goes to stderr, not stdout
agents -v version, agents -vv info, agents -vvvvv diagnostics all work correctly
The build --verbose/-v conflict is resolved

Supporting Information

Spec reference: docs/specification.md → Global Options → -v
Code location: src/cleveragents/cli/main.py, function main_callback()
Runtime confirmed: agents -v version → Error [500] INTERNAL: An unexpected error occurred

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

## Background and Context The spec defines a repeatable `-v` global option for controlling log verbosity on a per-invocation basis. This is a core CLI infrastructure requirement defined in the Command Synopsis and Global Options section of the specification. ## Current Behavior Running any command with `-v` (or `-vv`, `-vvv`, etc.) fails with an internal error: ``` $ agents -v version Wrapping unexpected exception: NoSuchOption: No such option: -v Error [500] INTERNAL: An unexpected error occurred ``` Exit code: 1 (should succeed) The `-v` option is also captured by the `agents build` subcommand as `--verbose/-v`, which conflicts with the intended global option. ## Expected Behavior (from spec) The `-v` global option must be **repeatable** and control log verbosity levels: - No `-v` → normal output only (logging suppressed except fatal errors) - `-v` → ERROR level logging to stderr - `-vv` → WARN level logging to stderr - `-vvv` → INFO level logging to stderr - `-vvvv` → DEBUG level logging to stderr - `-vvvvv` → TRACE level logging to stderr Increased verbosity writes to both the log file and stderr by default, keeping log output separate from normal program output on stdout. This flag does not persist — it only affects the current invocation. ## Steps to Reproduce ```bash agents -v version agents -vv version agents -vvv info ``` ## Code Analysis In `src/cleveragents/cli/main.py`, the `main_callback()` Typer callback (lines 293–334) only defines `--version`, `--show-secrets`, and `--format` global options. The `-v` verbosity option is completely absent. Additionally, the `build` command (line 529) registers `--verbose/-v` which would conflict with a global `-v` option. The global `-v` should be at the top-level callback, not as a subcommand option. ## Acceptance Criteria - [ ] `-v` added as a repeatable global option in `main_callback()` - [ ] Five verbosity levels (ERROR/WARN/INFO/DEBUG/TRACE) map to 1–5 repetitions - [ ] Verbosity output goes to stderr, not stdout - [ ] `agents -v version`, `agents -vv info`, `agents -vvvvv diagnostics` all work correctly - [ ] The `build --verbose/-v` conflict is resolved ## Supporting Information - Spec reference: `docs/specification.md` → Global Options → `-v` - Code location: `src/cleveragents/cli/main.py`, function `main_callback()` - Runtime confirmed: `agents -v version` → `Error [500] INTERNAL: An unexpected error occurred` --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

labels

2026-04-10 02:05:38 +00:00

HAL9000 added this to the v3.4.0 milestone

2026-04-10 02:05:45 +00:00

HAL9000 referenced this issue

2026-04-10 02:08:40 +00:00

[AUTO-UAT-POOL] UAT Testing Report (Cycle 4) #6758

HAL9000 added

and removed

labels

2026-04-14 07:19:47 +00:00

HAL9000 commented

2026-04-14 07:19:47 +00:00

Author

Owner

✅ Verified — UAT bug: global -v verbosity flag crashes. MoSCoW: Must-have. Priority: High — spec violation.

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

✅ **Verified** — UAT bug: global `-v` verbosity flag crashes. MoSCoW: Must-have. Priority: High — spec violation. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor