docs(specification): reorder command synopsis to separate validation commands (#1552) #1554

Merged
freemo merged 2 commits from fix/issue-1552-reorder-command-synopsis into master 2026-04-02 21:30:27 +00:00
2 changed files with 6 additions and 5 deletions
+5 -4
View File
@@ -229,10 +229,6 @@ The following standards are integrated into the architecture:
<span style="color: cyan; font-weight: 600;">agents</span> project unlink-resource [<span style="color: cyan;">--yes</span>|<span style="color: yellow;">-y</span>] <span style="color: #66cc66;">&lt;PROJECT&gt;</span> <span style="color: #66cc66;">&lt;RESOURCE_NAME&gt;</span>
<span style="color: cyan; font-weight: 600;">agents</span> project list [(<span style="color: magenta;"><span style="color: cyan;">--namespace</span>|<span style="color: yellow;">-n</span></span>) NS] [<span style="color: #66cc66;">&lt;REGEX&gt;</span>]
<span style="color: cyan; font-weight: 600;">agents</span> project show <span style="color: #66cc66;">&lt;PROJECT&gt;</span>
<span style="color: cyan; font-weight: 600;">agents</span> validation add (<span style="color: magenta;"><span style="color: cyan;">--config</span>|<span style="color: yellow;">-c</span></span>) <span style="color: #66cc66;">&lt;FILE&gt;</span> [<span style="color: cyan;">--update</span>]
<span style="color: cyan; font-weight: 600;">agents</span> validation attach [<span style="color: cyan;">--project</span> <span style="color: #66cc66;">&lt;PROJECT&gt;</span>|<span style="color: cyan;">--plan</span> <span style="color: #66cc66;">&lt;PLAN_ID&gt;</span>]
<span style="color: #66cc66;">&lt;RESOURCE&gt;</span> <span style="color: #66cc66;">&lt;VALIDATION&gt;</span> [<span style="color: #66cc66;">&lt;ARGS&gt;</span>...]
<span style="color: cyan; font-weight: 600;">agents</span> validation detach [<span style="color: cyan;">--yes</span>|<span style="color: yellow;">-y</span>] <span style="color: #66cc66;">&lt;ATTACHMENT_ID&gt;</span>
<span style="color: cyan; font-weight: 600;">agents</span> project delete [<span style="color: cyan;">--force</span>|<span style="color: yellow;">-f</span>] [<span style="color: cyan;">--yes</span>|<span style="color: yellow;">-y</span>] <span style="color: #66cc66;">&lt;NAME&gt;</span>
<span style="color: cyan; font-weight: 600;">agents</span> project context set[<span style="color: cyan;">--view</span> (<span style="color: magenta;">strategize|execute|apply|default</span>)]
[<span style="color: cyan;">--include-resource</span> <span style="color: #66cc66;">&lt;INCLUDE_RESOURCE&gt;</span>]...
@@ -270,6 +266,11 @@ The following standards are integrated into the architecture:
[<span style="color: cyan;">--strategy</span> <span style="color: #66cc66;">&lt;STRATEGY&gt;</span>]...
<span style="color: #66cc66;">&lt;PROJECT&gt;</span>
<span style="color: cyan; font-weight: 600;">agents</span> validation add (<span style="color: magenta;"><span style="color: cyan;">--config</span>|<span style="color: yellow;">-c</span></span>) <span style="color: #66cc66;">&lt;FILE&gt;</span> [<span style="color: cyan;">--update</span>]
<span style="color: cyan; font-weight: 600;">agents</span> validation attach [<span style="color: cyan;">--project</span> <span style="color: #66cc66;">&lt;PROJECT&gt;</span>|<span style="color: cyan;">--plan</span> <span style="color: #66cc66;">&lt;PLAN_ID&gt;</span>]
<span style="color: #66cc66;">&lt;RESOURCE&gt;</span> <span style="color: #66cc66;">&lt;VALIDATION&gt;</span> [<span style="color: #66cc66;">&lt;ARGS&gt;</span>...]
<span style="color: cyan; font-weight: 600;">agents</span> validation detach [<span style="color: cyan;">--yes</span>|<span style="color: yellow;">-y</span>] <span style="color: #66cc66;">&lt;ATTACHMENT_ID&gt;</span>
<span style="color: cyan; font-weight: 600;">agents</span> actor run [(<span style="color: magenta;"><span style="color: cyan;">--output</span>|<span style="color: yellow;">-o</span></span>) <span style="color: #66cc66;">&lt;OUTPUT_FILE&gt;</span>]
[<span style="color: yellow;">-v</span>...] [<span style="color: cyan;">--unsafe</span>|<span style="color: yellow;">-u</span>] [<span style="color: cyan;">--context</span> <span style="color: #66cc66;">&lt;CONTEXT_NAME&gt;</span>]
[<span style="color: cyan;">--context-dir</span> <span style="color: #66cc66;">&lt;CONTEXT_PATH&gt;</span>] [<span style="color: cyan;">--load-context</span> <span style="color: #66cc66;">&lt;LOAD_CONTEXT_NAME&gt;</span>]
+1 -1
View File
@@ -246,7 +246,7 @@ def add(
# If the YAML has a top-level 'tool:' key, extract its contents
if isinstance(config_dict, dict) and 'tool' in config_dict:
config_dict = config_dict['tool']
# Ignore 'cleveragents:' version header if present
if isinstance(config_dict, dict) and 'cleveragents' in config_dict:
del config_dict['cleveragents']