cleveragents/cleveragents-core

Fork 3

UAT: Global `--data-dir` and `--config-path` flags not implemented — spec-required global flags raise NoSuchOption error #5192

New issue

Closed

opened 2026-04-09 03:06:21 +00:00 by HAL9000 · 1 comment

HAL9000 commented

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

Owner

Bug Report

Feature Area: CLI Commands — Global flags --data-dir and --config-path
Severity: Critical — these are spec-required global flags; their absence breaks documented usage patterns
Source: src/cleveragents/cli/main.py (main_callback / app.callback)

What Was Tested

Runtime testing of the global --data-dir and --config-path flags as defined in the spec.

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

The spec defines these as global flags:

agents|cleveragents  [--data-dir <DATA_PATH>] [--config-path <CONFIG_PATH>]
                     ...

Spec description:

--data-dir PATH: Overrides the global data directory (database, caches, sessions, logs). When omitted, the default data location is used.
--config-path PATH: Overrides the global configuration file path. When omitted, the default config path is used.

Spec example:

$ agents --data-dir /srv/cleveragents --config-path /srv/cleveragents/config.toml info

Actual Behavior

Both flags raise a fatal error:

$ agents --data-dir /tmp/test-data-dir version
Error [500] INTERNAL: An unexpected error occurred
Wrapping unexpected exception: NoSuchOption: No such option: --data-dir

$ agents --config-path /tmp/test-config.toml version
Error [500] INTERNAL: An unexpected error occurred
Wrapping unexpected exception: NoSuchOption: No such option: --config-path

Exit code: 1

Root Cause

The main_callback in src/cleveragents/cli/main.py does not define --data-dir or --config-path parameters. The app.callback() decorator only defines --version, --show-secrets, and --format. These two global flags are completely absent from the implementation.

Steps to Reproduce

agents --data-dir /tmp/test version
# Expected: version output using /tmp/test as data dir
# Actual: Error [500] INTERNAL: NoSuchOption: No such option: --data-dir

agents --config-path /tmp/test.toml version
# Expected: version output using /tmp/test.toml as config
# Actual: Error [500] INTERNAL: NoSuchOption: No such option: --config-path

Impact

Multi-tenant setups that use --data-dir to isolate data per user/project are completely broken
CI/CD pipelines that use --config-path to specify environment-specific configs are broken
The spec example agents --data-dir /srv/cleveragents --config-path /srv/cleveragents/config.toml info fails entirely

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

## Bug Report **Feature Area:** CLI Commands — Global flags `--data-dir` and `--config-path` **Severity:** Critical — these are spec-required global flags; their absence breaks documented usage patterns **Source:** `src/cleveragents/cli/main.py` (main_callback / app.callback) --- ## What Was Tested Runtime testing of the global `--data-dir` and `--config-path` flags as defined in the spec. ## Expected Behavior (from spec §CLI Commands §Global Flags) The spec defines these as global flags: ``` agents|cleveragents [--data-dir <DATA_PATH>] [--config-path <CONFIG_PATH>] ... ``` Spec description: - `--data-dir PATH`: Overrides the global data directory (database, caches, sessions, logs). When omitted, the default data location is used. - `--config-path PATH`: Overrides the global configuration file path. When omitted, the default config path is used. Spec example: ```bash $ agents --data-dir /srv/cleveragents --config-path /srv/cleveragents/config.toml info ``` ## Actual Behavior Both flags raise a fatal error: ``` $ agents --data-dir /tmp/test-data-dir version Error [500] INTERNAL: An unexpected error occurred Wrapping unexpected exception: NoSuchOption: No such option: --data-dir $ agents --config-path /tmp/test-config.toml version Error [500] INTERNAL: An unexpected error occurred Wrapping unexpected exception: NoSuchOption: No such option: --config-path ``` Exit code: 1 ## Root Cause The `main_callback` in `src/cleveragents/cli/main.py` does not define `--data-dir` or `--config-path` parameters. The `app.callback()` decorator only defines `--version`, `--show-secrets`, and `--format`. These two global flags are completely absent from the implementation. ## Steps to Reproduce ```bash agents --data-dir /tmp/test version # Expected: version output using /tmp/test as data dir # Actual: Error [500] INTERNAL: NoSuchOption: No such option: --data-dir agents --config-path /tmp/test.toml version # Expected: version output using /tmp/test.toml as config # Actual: Error [500] INTERNAL: NoSuchOption: No such option: --config-path ``` ## Impact - Multi-tenant setups that use `--data-dir` to isolate data per user/project are completely broken - CI/CD pipelines that use `--config-path` to specify environment-specific configs are broken - The spec example `agents --data-dir /srv/cleveragents --config-path /srv/cleveragents/config.toml info` fails entirely --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

labels

2026-04-09 03:06:25 +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

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

HAL9000 added this to the v3.2.0 milestone

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

HAL9000 referenced this issue

2026-04-09 03:13:10 +00:00

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

HAL9000 added the

labels

2026-04-09 03:19:25 +00:00

HAL9000 referenced this issue

2026-04-09 03:19:59 +00:00

[AUTO-PROJ-OWN] Project Owner Report (Cycle 2) #5205

hurui200320 referenced this issue

2026-05-11 06:14:02 +00:00

UAT: Global CLI options --data-dir, --config-path, and -v not implemented — crash with "No such option" #6785

hurui200320 referenced this issue

2026-05-11 06:14:13 +00:00

UAT: Global CLI options --data-dir, --config-path, --format, and -v not implemented on main app #1367

hurui200320 referenced this issue

2026-05-11 06:14:14 +00:00

UAT: Global CLI options --data-dir and --config-path are not implemented — spec requires both #2409

hurui200320 referenced this issue

2026-05-11 06:14:16 +00:00

UAT: Missing global --data-dir and --config-path CLI options #3615

hurui200320 referenced this issue

2026-05-11 06:14:17 +00:00

UAT: CLI missing spec-required global options --data-dir and --config-path #3747

hurui200320 commented

2026-05-11 06:14:18 +00:00

Member

Duplicate — consolidated into #6785.

This ticket describes the same issue as #1367, #2409, #3615, #3747, #5497, #5712, and #6878: the global CLI options --data-dir, --config-path, and -v are missing from main_callback() in src/cleveragents/cli/main.py.

All content from this ticket has been aggregated into #6785, which is now the canonical tracking issue. This ticket is being closed as a duplicate. Please follow and comment on #6785 going forward.

**Duplicate — consolidated into #6785.** This ticket describes the same issue as #1367, #2409, #3615, #3747, #5497, #5712, and #6878: the global CLI options `--data-dir`, `--config-path`, and `-v` are missing from `main_callback()` in `src/cleveragents/cli/main.py`. All content from this ticket has been aggregated into **#6785**, which is now the canonical tracking issue. This ticket is being closed as a duplicate. Please follow and comment on #6785 going forward.

hurui200320 referenced this issue

2026-05-11 06:14:20 +00:00

UAT: Global --data-dir and --config-path options missing from CLI — spec requires them on all commands #5497

hurui200320 referenced this issue

2026-05-11 06:14:21 +00:00

UAT: Global --data-dir flag missing from CLI main_callback — spec-required override for core.data-dir not implemented #5712

hurui200320 referenced this issue

2026-05-11 06:14:22 +00:00

UAT: CLI core missing spec-required global --data-dir, --config-path, and -v verbosity options #6878

hurui200320

2026-05-11 06:14:32 +00:00