fix(help): the top-level "--help" hides commands behind a truncated list #844

New issue

Open

opened 2026-10-20 16:50:51 +00:00 by hexajon · 0 comments

hexajon commented

2026-10-20 16:50:51 +00:00

Owner

What happens

The top-level --help does not show the full command list. repo was not visible on the first read; I found it only on a second look. So even listing the commands costs two reads before any real work.

Fix

The top-level --help should list every command, grouped if needed, or state plainly where the rest of the list lives. A caller should learn the full command set in one read. ADR 0008 already makes the CLI render its help from the operation registry, so the full command list is available to render in full.

Acceptance criteria

The top-level --help lists every command, grouped if needed, or names where the rest of the list is.
A reader finds any top-level command, repo included, in one read.
The listing renders from the operation registry (ADR 0008).

ADR 0008 (the operation registry renders the CLI help), #754 (scoped madt_help on the MCP surface, a distinct axis).

## What happens The top-level `--help` does not show the full command list. `repo` was not visible on the first read; I found it only on a second look. So even listing the commands costs two reads before any real work. ## Fix The top-level `--help` should list every command, grouped if needed, or state plainly where the rest of the list lives. A caller should learn the full command set in one read. ADR 0008 already makes the CLI render its help from the operation registry, so the full command list is available to render in full. ## Acceptance criteria - The top-level `--help` lists every command, grouped if needed, or names where the rest of the list is. - A reader finds any top-level command, `repo` included, in one read. - The listing renders from the operation registry (ADR 0008). ## Related - ADR 0008 (the operation registry renders the CLI help), #754 (scoped `madt_help` on the MCP surface, a distinct axis).

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

sixfold-space/madtea#844

No description provided.

Rows
Columns