Files
cleveragents-core/docs/showcase/examples.json
T
HAL9000 07f9364bcb
ci.yml / docs: add showcase example for database migration management (push) Failing after 0s
docs: add showcase example for database migration management
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.
2026-04-07 14:53:12 +00:00

97 lines
3.6 KiB
JSON

{
"examples": [
{
"title": "Mastering Output Format Flags in CleverAgents CLI",
"category": "cli-tools",
"path": "cli-tools/output-format-flags.md",
"feature": "Output formats JSON YAML plain",
"commands": [
"agents --format json version",
"agents --format yaml version",
"agents --format plain version",
"agents -f json version",
"agents --format json info",
"agents --format json diagnostics",
"agents -f json actor list",
"agents -f yaml actor list",
"agents -f plain actor list"
],
"complexity": "intermediate",
"educational_value": "high",
"generated_by": "uat-tester",
"generated_at": "2026-04-07"
},
{
"title": "Managing AI Actors with the CleverAgents CLI",
"category": "cli-tools",
"path": "cli-tools/actor-management-workflow.md",
"feature": "Actor management workflows",
"commands": [
"agents actor --help",
"agents actor list",
"agents actor list --format json",
"agents actor list --format yaml",
"agents actor show openai/gpt-4o",
"agents actor show anthropic/claude-sonnet-4-20250514",
"agents actor show openai/gpt-4o --format json",
"agents actor add local/my-haiku-actor --config my-haiku-actor.yaml",
"agents actor add local/my-haiku-actor --config my-haiku-actor.yaml --format json",
"agents actor set-default local/my-haiku-actor",
"agents actor set-default anthropic/claude-sonnet-4-20250514",
"agents actor update local/my-haiku-actor --option temperature=0.7",
"agents actor set-default openai/gpt-4o",
"agents actor remove local/my-haiku-actor"
],
"complexity": "intermediate",
"educational_value": "high",
"generated_by": "uat-tester",
"generated_at": "2026-04-07"
},
{
"title": "Server Connection and A2A Protocol Integration",
"category": "cli-tools",
"path": "cli-tools/server-and-a2a-integration.md",
"feature": "Server and A2A integration",
"commands": [
"agents server --help",
"agents server status",
"agents server status --format json",
"agents server connect https://agents.example.com",
"agents server connect https://agents.example.com --format json",
"agents server connect https://agents.example.com --namespace my-team --format json",
"agents server connect http://localhost:8080 --no-tls-verify --format json",
"agents server status --format yaml",
"agents server status --format plain",
"agents server serve --help"
],
"complexity": "advanced",
"educational_value": "high",
"generated_by": "uat-tester",
"generated_at": "2026-04-07"
}
],
"categories": {
"cli-tools": {
"name": "CLI Tools",
"description": "Text-based command-line applications",
"keywords": ["CLI", "command-line", "terminal", "console", "tool"]
},
"api-clients": {
"name": "API Clients",
"description": "Command-line clients for web APIs",
"keywords": ["API", "REST", "client", "HTTP", "web", "request"]
},
"data-processing": {
"name": "Data Processing",
"description": "Tools for data analysis and transformation",
"keywords": ["data", "CSV", "JSON", "parser", "analyzer", "transform"]
},
"testing-tools": {
"name": "Testing Tools",
"description": "Testing utilities and automation",
"keywords": ["test", "pytest", "behave", "unittest", "automation", "QA"]
}
},
"last_updated": null
}