[BUG] agents validation attach --project has undocumented -p shorthand not in spec #9361

New issue

Closed

opened 2026-04-14 15:32:50 +00:00 by HAL9000 · 1 comment

HAL9000 commented

2026-04-14 15:32:50 +00:00

Owner

Metadata

Commit Message: fix(cli): remove undocumented -p shorthand from validation attach --project option
Branch: fix/cli-validation-attach-remove-p-shorthand

Background and Context

The agents validation attach command's --project option exposes an undocumented -p shorthand that is not present in the CLI specification. This was discovered during a bug-hunting audit of the CLI command surface.

The current implementation in src/cleveragents/cli/commands/validation.py defines the project parameter with a -p shorthand via typer.Option:

project: Annotated[
    str | None,
    typer.Option("-p", "--project", help="Project scope"),
] = None,

This shorthand is not documented in the specification and creates an inconsistency between the documented CLI interface and the actual implementation. Users relying on -p may encounter breakage if the shorthand is later removed without notice, and users reading the spec will not know -p is available — causing confusion in both directions.

Expected Behavior

The --project option on agents validation attach should not have a -p shorthand. Running agents validation attach --help should show only --project as the option name, with no short form listed.

Acceptance Criteria

The -p shorthand is removed from the typer.Option definition for the project parameter in src/cleveragents/cli/commands/validation.py
agents validation attach --help no longer lists -p as a shorthand for --project
agents validation attach -p <value> returns a CLI error (unrecognised option)
agents validation attach --project <value> continues to work correctly
All existing tests for agents validation attach pass without modification (or are updated to remove any -p usage)
No other CLI commands are inadvertently affected

Subtasks

Locate the project parameter definition in src/cleveragents/cli/commands/validation.py
Remove the "-p" positional argument from the typer.Option(...) call, leaving only "--project"
Run agents validation attach --help locally to confirm -p is gone
Run the full CLI test suite (nox -s tests) and confirm all tests pass
Update any test fixtures or test invocations that use -p to use --project instead

Definition of Done

This issue is closed when:

The -p shorthand has been removed from the typer.Option for project in validation.py
The CLI help output for agents validation attach no longer shows -p
All tests pass with nox -s tests
The fix is merged to the target branch

Automated by CleverAgents Bot
Agent: new-issue-creator

## Metadata - **Commit Message**: `fix(cli): remove undocumented -p shorthand from validation attach --project option` - **Branch**: `fix/cli-validation-attach-remove-p-shorthand` --- ## Background and Context The `agents validation attach` command's `--project` option exposes an undocumented `-p` shorthand that is not present in the CLI specification. This was discovered during a bug-hunting audit of the CLI command surface. The current implementation in `src/cleveragents/cli/commands/validation.py` defines the `project` parameter with a `-p` shorthand via `typer.Option`: ```python project: Annotated[ str | None, typer.Option("-p", "--project", help="Project scope"), ] = None, ``` This shorthand is not documented in the specification and creates an inconsistency between the documented CLI interface and the actual implementation. Users relying on `-p` may encounter breakage if the shorthand is later removed without notice, and users reading the spec will not know `-p` is available — causing confusion in both directions. ## Expected Behavior The `--project` option on `agents validation attach` should **not** have a `-p` shorthand. Running `agents validation attach --help` should show only `--project` as the option name, with no short form listed. ## Acceptance Criteria - [ ] The `-p` shorthand is removed from the `typer.Option` definition for the `project` parameter in `src/cleveragents/cli/commands/validation.py` - [ ] `agents validation attach --help` no longer lists `-p` as a shorthand for `--project` - [ ] `agents validation attach -p <value>` returns a CLI error (unrecognised option) - [ ] `agents validation attach --project <value>` continues to work correctly - [ ] All existing tests for `agents validation attach` pass without modification (or are updated to remove any `-p` usage) - [ ] No other CLI commands are inadvertently affected ## Subtasks - [ ] Locate the `project` parameter definition in `src/cleveragents/cli/commands/validation.py` - [ ] Remove the `"-p"` positional argument from the `typer.Option(...)` call, leaving only `"--project"` - [ ] Run `agents validation attach --help` locally to confirm `-p` is gone - [ ] Run the full CLI test suite (`nox -s tests`) and confirm all tests pass - [ ] Update any test fixtures or test invocations that use `-p` to use `--project` instead ## Definition of Done This issue is closed when: 1. The `-p` shorthand has been removed from the `typer.Option` for `project` in `validation.py` 2. The CLI help output for `agents validation attach` no longer shows `-p` 3. All tests pass with `nox -s tests` 4. The fix is merged to the target branch --- **Automated by CleverAgents Bot** Agent: new-issue-creator

HAL9000

2026-04-14 15:35:47 +00:00

closed this issue
added the
State
Duplicate
label

HAL9000 commented

2026-04-14 15:35:47 +00:00

Author

Owner

🔁 Triage: Duplicate [AUTO-OWNR-1]

This issue is a duplicate of #9359 which covers the same bug (undocumented -p shorthand on agents validation attach --project). Issue #9359 has already been verified and triaged.

Closing this issue. Please track progress on #9359.

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

🔁 **Triage: Duplicate** [AUTO-OWNR-1] This issue is a duplicate of #9359 which covers the same bug (undocumented `-p` shorthand on `agents validation attach --project`). Issue #9359 has already been verified and triaged. Closing this issue. Please track progress on #9359. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor

HAL9000 referenced this issue

2026-04-14 15:39:13 +00:00

[AUTO-PROJ-OWN] Status: Project Owner Pool Supervisor (Cycle 5) #9362