Command synopsis should be reordered #1552

Closed
opened 2026-04-02 20:58:00 +00:00 by brent.edwards · 1 comment
Member

When the documentation is run, http://localhost:8000/cleveragents/specification/#command-synopsis holds:

agents project create [(--description|-d) <DESC>] [--resource <RESOURCE>]...
                     [--invariant <INVARIANT>]... [--invariant-actor <ACTOR>] <NAME>
agents project link-resource [--read-only] <PROJECT> <RESOURCE>
agents project unlink-resource [--yes|-y] <PROJECT> <RESOURCE_NAME>
agents project list [(--namespace|-n) NS] [<REGEX>]
agents project show <PROJECT>
agents validation add (--config|-c) <FILE> [--update]
agents validation attach [--project <PROJECT>|--plan <PLAN_ID>]
                         <RESOURCE> <VALIDATION> [<ARGS>...]
agents validation detach [--yes|-y] <ATTACHMENT_ID>
agents project delete [--force|-f] [--yes|-y] <NAME>
agents project context set[--view (strategize|execute|apply|default)]
                          [--include-resource <INCLUDE_RESOURCE>]...
                          [--exclude-resource <EXCLUDE_RESOURCE>]...
                          [--include-path <INCLUDE_GLOB>]...
                          [--exclude-path <EXCLUDE_GLOB>]...
                          [--hot-max-tokens <N>]
                          [--warm-max-decisions <N_WARM_MAX>]
                          [--cold-max-decisions <N_COLD_MAX>]
                          [--query-limit <N>]
                          [--max-file-size <MAX_FILE_BYTES>]
                          [--max-total-size <MAX_TOTAL_BYTES>]
                          [--summarize|--no-summarize]
                          [--summary-max-tokens <N>]
                          [--strategy <STRATEGY>]...
                          [--default-breadth <N>]
                          [--default-depth <INT_OR_NAME>]
                          [--depth-gradient <HOP:INT_OR_NAME>]...
                          [--skeleton-ratio <FLOAT>]
                          [--temporal-scope (current|recent|all)]
                          [--auto-refresh|--no-auto-refresh]
                          [--execution-environment <RESOURCE_NAME>]
                          [--execution-env-priority (fallback|override)]
                          [--clear] <PROJECT>
agents project context show [--view (strategize|execute|apply|default)]
                            <PROJECT>
agents project context inspect [--view (strategize|execute|apply|default)]
                               [--strategy <STRATEGY>]
                               [--focus <UKO_URI>]...
                               [--breadth <N>] [--depth <INT_OR_NAME>]
                               <PROJECT>
agents project context simulate [--view (strategize|execute|apply|default)]
                                [--budget <TOKENS>]
                                [--focus <UKO_URI>]...
                                [--strategy <STRATEGY>]...
                                <PROJECT>

Notice that agents validation is in the middle of agents project.

agents validation should be separate from agents project.

When the documentation is run, http://localhost:8000/cleveragents/specification/#command-synopsis holds: ``` agents project create [(--description|-d) <DESC>] [--resource <RESOURCE>]... [--invariant <INVARIANT>]... [--invariant-actor <ACTOR>] <NAME> agents project link-resource [--read-only] <PROJECT> <RESOURCE> agents project unlink-resource [--yes|-y] <PROJECT> <RESOURCE_NAME> agents project list [(--namespace|-n) NS] [<REGEX>] agents project show <PROJECT> agents validation add (--config|-c) <FILE> [--update] agents validation attach [--project <PROJECT>|--plan <PLAN_ID>] <RESOURCE> <VALIDATION> [<ARGS>...] agents validation detach [--yes|-y] <ATTACHMENT_ID> agents project delete [--force|-f] [--yes|-y] <NAME> agents project context set[--view (strategize|execute|apply|default)] [--include-resource <INCLUDE_RESOURCE>]... [--exclude-resource <EXCLUDE_RESOURCE>]... [--include-path <INCLUDE_GLOB>]... [--exclude-path <EXCLUDE_GLOB>]... [--hot-max-tokens <N>] [--warm-max-decisions <N_WARM_MAX>] [--cold-max-decisions <N_COLD_MAX>] [--query-limit <N>] [--max-file-size <MAX_FILE_BYTES>] [--max-total-size <MAX_TOTAL_BYTES>] [--summarize|--no-summarize] [--summary-max-tokens <N>] [--strategy <STRATEGY>]... [--default-breadth <N>] [--default-depth <INT_OR_NAME>] [--depth-gradient <HOP:INT_OR_NAME>]... [--skeleton-ratio <FLOAT>] [--temporal-scope (current|recent|all)] [--auto-refresh|--no-auto-refresh] [--execution-environment <RESOURCE_NAME>] [--execution-env-priority (fallback|override)] [--clear] <PROJECT> agents project context show [--view (strategize|execute|apply|default)] <PROJECT> agents project context inspect [--view (strategize|execute|apply|default)] [--strategy <STRATEGY>] [--focus <UKO_URI>]... [--breadth <N>] [--depth <INT_OR_NAME>] <PROJECT> agents project context simulate [--view (strategize|execute|apply|default)] [--budget <TOKENS>] [--focus <UKO_URI>]... [--strategy <STRATEGY>]... <PROJECT> ``` Notice that `agents validation` is in the middle of `agents project`. `agents validation` should be separate from `agents project`.
freemo self-assigned this 2026-04-02 20:58:56 +00:00
brent.edwards changed title from Command synopsis should be rerdered to Command synopsis should be reordered 2026-04-02 20:59:16 +00:00
Owner

Implementation Complete ✓

PR Created: #1554
Branch: fix/issue-1552-reorder-command-synopsis

Changes Made

Reordered the command synopsis section in docs/specification.md:

  • Removed agents validation commands from within the agents project commands
  • Created a separate validation commands section after all project commands
  • Maintained command order within each group

Result

The command synopsis now has clear separation:

  1. session commands
  2. project commands (all together)
  3. validation commands (all together)
  4. actor commands
  5. skill commands
  6. tool commands

Ready for review and merge.


Automated by CleverAgents Bot
Supervisor: Product Builder | Agent: product-builder

## Implementation Complete ✓ **PR Created**: #1554 **Branch**: `fix/issue-1552-reorder-command-synopsis` ### Changes Made Reordered the command synopsis section in `docs/specification.md`: - Removed `agents validation` commands from within the `agents project` commands - Created a separate validation commands section after all project commands - Maintained command order within each group ### Result The command synopsis now has clear separation: 1. session commands 2. project commands (all together) 3. validation commands (all together) 4. actor commands 5. skill commands 6. tool commands **Ready for review and merge.** --- **Automated by CleverAgents Bot** Supervisor: Product Builder | Agent: product-builder
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.

Dependencies

No dependencies set.

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