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

Closed
opened 2026-04-05 20:37:42 +00:00 by freemo · 1 comment
Owner

Metadata

  • Branch: fix/uat-missing-global-cli-options-data-dir-config-path
  • Commit Message: fix(cli): add missing --data-dir and --config-path global options to main_callback
  • Milestone: (none — backlog, see note below)
  • Parent Epic: #3370

Background

The specification (docs/specification.md, "Global Options" section) mandates two global options on the main CLI entry point:

  • --data-dir PATH — Overrides the global data directory (database, caches, sessions, logs)
  • --config-path PATH — Overrides the global configuration file path

These options must be available on every command invocation, e.g.:

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

Problem

The main_callback in src/cleveragents/cli/main.py (lines 292–316) only defines --version and --show-secrets global options. Neither --data-dir nor --config-path is present anywhere in the CLI entry point.

Impact: Users cannot override the data directory or config path from the CLI. This blocks use cases such as running multiple CleverAgents instances with different data directories or using non-default config paths — both of which are fundamental spec requirements.

Subtasks

  • Write a failing Behave scenario in features/ that reproduces the missing --data-dir and --config-path options (TDD: failing test first)
  • Add --data-dir PATH Typer option to main_callback in src/cleveragents/cli/main.py
  • Add --config-path PATH Typer option to main_callback in src/cleveragents/cli/main.py
  • Wire both options into the application context / config resolution layer so they override defaults at runtime
  • Ensure both options are propagated to all sub-commands via the Typer context object
  • Add Robot Framework integration test in robot/ verifying the options are accepted and applied end-to-end
  • Update any relevant docstrings and help text to match the spec wording

Definition of Done

  • agents --data-dir <path> <subcommand> correctly overrides the data directory for the invocation
  • agents --config-path <path> <subcommand> correctly overrides the config file path for the invocation
  • Both options appear in agents --help output
  • Behave unit tests cover the new options (TDD: failing test committed before fix)
  • Robot Framework integration test passes end-to-end
  • The associated PR has been merged
  • All nox stages pass
  • Coverage >= 97%

Backlog note: This issue was discovered during autonomous operation
on milestone v3.6.0. It does not block milestone completion and has been
placed in the backlog for human review and future milestone assignment.


Automated by CleverAgents Bot
Supervisor: Acting on behalf of: UAT Testing | Agent: ca-new-issue-creator

## Metadata - **Branch**: `fix/uat-missing-global-cli-options-data-dir-config-path` - **Commit Message**: `fix(cli): add missing --data-dir and --config-path global options to main_callback` - **Milestone**: *(none — backlog, see note below)* - **Parent Epic**: #3370 ## Background The specification (`docs/specification.md`, "Global Options" section) mandates two global options on the main CLI entry point: - `--data-dir PATH` — Overrides the global data directory (database, caches, sessions, logs) - `--config-path PATH` — Overrides the global configuration file path These options must be available on **every** command invocation, e.g.: ``` agents --data-dir /srv/cleveragents --config-path /srv/cleveragents/config.toml info ``` ## Problem The `main_callback` in `src/cleveragents/cli/main.py` (lines 292–316) only defines `--version` and `--show-secrets` global options. Neither `--data-dir` nor `--config-path` is present anywhere in the CLI entry point. **Impact**: Users cannot override the data directory or config path from the CLI. This blocks use cases such as running multiple CleverAgents instances with different data directories or using non-default config paths — both of which are fundamental spec requirements. ## Subtasks - [ ] Write a failing Behave scenario in `features/` that reproduces the missing `--data-dir` and `--config-path` options (TDD: failing test first) - [ ] Add `--data-dir PATH` Typer option to `main_callback` in `src/cleveragents/cli/main.py` - [ ] Add `--config-path PATH` Typer option to `main_callback` in `src/cleveragents/cli/main.py` - [ ] Wire both options into the application context / config resolution layer so they override defaults at runtime - [ ] Ensure both options are propagated to all sub-commands via the Typer context object - [ ] Add Robot Framework integration test in `robot/` verifying the options are accepted and applied end-to-end - [ ] Update any relevant docstrings and help text to match the spec wording ## Definition of Done - [ ] `agents --data-dir <path> <subcommand>` correctly overrides the data directory for the invocation - [ ] `agents --config-path <path> <subcommand>` correctly overrides the config file path for the invocation - [ ] Both options appear in `agents --help` output - [ ] Behave unit tests cover the new options (TDD: failing test committed before fix) - [ ] Robot Framework integration test passes end-to-end - [ ] The associated PR has been merged - [ ] All nox stages pass - [ ] Coverage >= 97% > **Backlog note:** This issue was discovered during autonomous operation > on milestone v3.6.0. It does not block milestone completion and has been > placed in the backlog for human review and future milestone assignment. --- **Automated by CleverAgents Bot** Supervisor: Acting on behalf of: UAT Testing | Agent: ca-new-issue-creator
freemo added this to the v3.7.0 milestone 2026-04-05 20:42:22 +00:00
Member

Duplicate — consolidated into #6785.

This ticket describes the same issue as #1367, #2409, #3747, #5192, #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, #3747, #5192, #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.
Sign in to join this conversation.
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
cleveragents/cleveragents-core#3615
No description provided.