From 9fcf37f0528422fe7a1b00b5f20095e0943e7ed8 Mon Sep 17 00:00:00 2001 From: Jeffrey Phillips Freeman Date: Thu, 2 Apr 2026 21:03:47 +0000 Subject: [PATCH 1/2] docs(specification): reorder command synopsis to separate validation commands The command synopsis section previously had 'agents validation' commands interspersed within the 'agents project' commands. This made the synopsis harder to read and violated the principle of grouping related commands together. Changes: - Moved 'agents validation add', 'validation attach', and 'validation detach' commands from their position between 'project show' and 'project delete' - Placed them in their own section after all project commands are complete - Maintained the existing command order within each group The synopsis now follows a clear structure: - session commands - project commands (grouped together) - validation commands (grouped together) - actor commands - skill commands - tool commands - etc. ISSUES CLOSED: #1552 --- docs/specification.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/specification.md b/docs/specification.md index afc37b2ec..5bc89bc55 100644 --- a/docs/specification.md +++ b/docs/specification.md @@ -229,10 +229,6 @@ The following standards are integrated into the architecture: 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>]... @@ -270,6 +266,11 @@ The following standards are integrated into the architecture: [--strategy <STRATEGY>]... <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 actor run [(--output|-o) <OUTPUT_FILE>] [-v...] [--unsafe|-u] [--context <CONTEXT_NAME>] [--context-dir <CONTEXT_PATH>] [--load-context <LOAD_CONTEXT_NAME>] -- 2.52.0 From 101e17b769e2f7690bb9a1f30b43780bccd39d92 Mon Sep 17 00:00:00 2001 From: Jeffrey Phillips Freeman Date: Thu, 2 Apr 2026 21:18:41 +0000 Subject: [PATCH 2/2] fix(lint): resolve linting errors --- src/cleveragents/cli/commands/tool.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/cleveragents/cli/commands/tool.py b/src/cleveragents/cli/commands/tool.py index ddf155a3f..379966325 100644 --- a/src/cleveragents/cli/commands/tool.py +++ b/src/cleveragents/cli/commands/tool.py @@ -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'] -- 2.52.0