Add a verified CLI showcase for the version, info, and diagnostics commands,
register in examples.json and update CHANGELOG/CONTRIBUTORS.
ISSUES CLOSED: #7592
Created comprehensive showcase documentation for CLI version, info, and diagnostics commands
Documented fast-path vs regular command behavior
Included verified outputs and machine-readable JSON/YAML examples
Registered the showcase entry in docs/showcase/examples.json
Added BDD tests for the showcase documentation
Closes#7592
The BDD test step_commands_include checks for exact list membership.
"agents actor run" was missing from the commands list, causing the
"Showcase commands list is not empty" scenario to fail with:
AssertionError: Command 'agents actor run' not found in commands list
- Register REPL and actor run showcase in examples.json
- Add BDD tests for showcase documentation structure
- Verify markdown file exists and is properly formatted
- Validate JSON metadata for showcase entry
- Test documented commands and content sections
Closes#7552
- document the CLI workflow for registering tools, wrapping validations, and querying registry metadata
- index the new example in docs/showcase/examples.json
- re-enable coverage threshold regression checks by removing obsolete tdd_expected_fail tags
ISSUES CLOSED: #4565
Refs: #4305
Refs: #4227
Register the existing audit-log-and-security.md example in the showcase registry
(examples.json) so it appears alongside other CLI tool examples.
Includes 17 audit commands covering list, show, count, and prune
operations with all filter options.
Closes#10824
Adds a complete end-to-end walkthrough of the `agents db` command group,
verified by the UAT system with real command outputs. Covers:
- agents db --help (command discovery)
- agents db current (fresh database: 41 pending migrations listed)
- agents db history (full 41-revision DAG with branchpoints/mergepoints)
- agents db history --format json (structured DAG for scripting)
- agents db upgrade (applying all 41 migrations to head)
- agents db current --format json (CI/CD integration pattern)
- agents db downgrade -- -1 (relative rollback with -- separator)
- agents db downgrade <revision-id> (targeted rollback)
- agents db upgrade <revision-id> (targeted upgrade)
- agents db upgrade --format json (idempotent upgrade with JSON output)
Also updates examples.json index with the new entry.
Extend the UAT testing agents to capture successful test workflows and
automatically generate showcase documentation demonstrating real-world
usage of CleverAgents.
Key features added:
- Documentation generation when tests succeed end-to-end
- Intelligent duplicate detection to avoid redundant examples
- Categorization into cli-tools, api-clients, data-processing, testing-tools
- Automatic PR creation for new documentation examples
- Integration with existing UAT workflow without disruption
Documentation structure:
- New docs/showcase/ directory for real-world examples
- Category-specific subdirectories with README guides
- Example template for consistent formatting
- JSON index for tracking and duplicate detection
The UAT tester now serves dual purposes:
1. Finding bugs through comprehensive testing (existing behavior)
2. Generating high-quality documentation from successful test runs (new)
This enables the system to build its own showcase of capabilities while
performing regular quality assurance, providing valuable examples for
users and demonstrating the system's practical applications.
HAL9000
Repository Isolator
freemo