Commit Graph

18 Commits

Author SHA1 Message Date
HAL9000 9edee2d7d5 docs: fix inaccurate fast-path claim in CLI basics documentation
The version, info, and diagnostics commands were incorrectly stated as being on the fast-path. Only --help and --version are eager exit options that skip subcommand module loading.

ISSUES CLOSED: #7592
2026-06-14 23:57:38 -04:00
HAL9000 f38491e5a6 docs: add showcase example for CLI version/info/diagnostics basics
Add a verified CLI showcase for the version, info, and diagnostics commands,
register in examples.json and update CHANGELOG/CONTRIBUTORS.

ISSUES CLOSED: #7592
2026-06-14 23:57:38 -04:00
HAL9000 f808abff86 chore(ci): fix pre-commit hook failures
Fix JSON syntax errors in .devcontainer/devcontainer.json (removed
invalid JS-style // comments) and .devcontainer/opencode.json (removed
90+ trailing commas). Apply auto-fixes for end-of-file and trailing
whitespace issues across 100+ files. Fix SIM105 ruff violations in
benchmarks/core_circuit_breaker_bench.py (use contextlib.suppress).

Note: The security fix from issue #7478 (validate_path startswith bypass)
was already delivered to master in commit e18ac5f2. This PR as currently
structured is non-atomic (35 commits across 10+ issues) and needs
significant restructure before merge. This commit only addresses the
CI/pre-commit failures.

ISSUES CLOSED: #7478
2026-06-14 09:51:14 -04:00
HAL9000 c1a29a331b docs: add showcase example for resource and skill management
CI / lint (pull_request) Successful in 1m9s
CI / push-validation (pull_request) Successful in 54s
CI / quality (pull_request) Successful in 1m20s
CI / typecheck (pull_request) Successful in 1m37s
CI / security (pull_request) Successful in 1m37s
CI / build (pull_request) Successful in 1m19s
CI / helm (pull_request) Successful in 1m31s
CI / unit_tests (pull_request) Successful in 6m45s
CI / docker (pull_request) Successful in 2m54s
CI / integration_tests (pull_request) Successful in 10m45s
CI / coverage (pull_request) Successful in 22m39s
CI / status-check (pull_request) Successful in 5s
Align the resource and skill management showcase with review feedback: consistent resource type counts (101), explicit save-to-disk instructions before each skill registration command, metadata callouts for non-obvious behaviors (Config: unknown, capability summary zeros, local/linear-tracker 0-tool count), and README framing to acknowledge platform feature walkthroughs.

Remove obsolete tdd_issue tags from coverage threshold Robot tests now that the noxfile enforces COVERAGE_THRESHOLD = 97.

Harden the Skip If No LLM Keys E2E helper with per-key regex validation and log-level suppression to prevent credential leakage in CI logs. Restore the Resolve LLM Actor keyword that was inadvertently removed from common_e2e.resource.

Update CHANGELOG.md and CONTRIBUTORS.md per project requirements.

ISSUES CLOSED: #4470
2026-06-06 22:55:02 -04:00
HAL9000 34f658a32a docs(showcase): showcase CLI version/info/diagnostics commands
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
2026-06-06 06:28:09 -04:00
HAL9000 c0ca274691 fix(showcase): add "agents actor run" to commands list in examples.json
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
2026-06-06 04:58:21 -04:00
Repository Isolator 1551c6e41d docs(showcase): add REPL and actor run CLI showcase
- 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
2026-06-06 04:58:20 -04:00
HAL9000 0b8b971e7f docs: document actor removal impact handling and --unsafe flag
CI / lint (pull_request) Successful in 56s
CI / typecheck (pull_request) Successful in 1m6s
CI / helm (pull_request) Successful in 45s
CI / build (pull_request) Successful in 52s
CI / security (pull_request) Successful in 1m15s
CI / quality (pull_request) Successful in 1m22s
CI / push-validation (pull_request) Successful in 37s
CI / unit_tests (pull_request) Successful in 6m56s
CI / docker (pull_request) Successful in 1m51s
CI / integration_tests (pull_request) Successful in 10m51s
CI / coverage (pull_request) Successful in 11m14s
CI / status-check (pull_request) Successful in 4s
- Added comprehensive documentation about actor removal impact handling, outlining potential effects on dependencies, data integrity, and service continuity. Includes a clear, step-by-step checklist for evaluating impact prior to removal and guidance on planning mitigations.

- Documented the --unsafe flag and when it's required, with explicit warnings, usage criteria, and recommended safeguards, rollback steps, and testing considerations.

- Added non-zero impact scenarios and best practices for safe removal, including concrete examples of edge cases, guidance on graceful shutdown, data migration considerations, and rollback planning to minimize disruption.

- Updated the actor management workflow showcase with new guidance, aligning demonstrations and diagrams with the updated removal process and decision points.

Closes #7540
2026-06-06 03:52:55 -04:00
HAL9000 bc64074036 docs: add tool and validation management showcase
CI / push-validation (pull_request) Successful in 27s
CI / build (pull_request) Successful in 39s
CI / lint (pull_request) Successful in 43s
CI / helm (pull_request) Successful in 46s
CI / typecheck (pull_request) Successful in 1m11s
CI / quality (pull_request) Successful in 1m11s
CI / security (pull_request) Successful in 1m15s
CI / unit_tests (pull_request) Successful in 7m0s
CI / docker (pull_request) Successful in 1m33s
CI / coverage (pull_request) Successful in 15m2s
CI / integration_tests (pull_request) Successful in 24m26s
CI / status-check (pull_request) Successful in 3s
- 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
2026-05-30 17:21:55 -04:00
hurui200320 85c579b51f fix(cli): display full session IDs in session list output
CI / status-check (push) Blocked by required conditions
CI / benchmark-regression (push) Waiting to run
CI / push-validation (push) Successful in 36s
CI / helm (push) Successful in 45s
CI / build (push) Successful in 58s
CI / lint (push) Successful in 1m9s
CI / quality (push) Successful in 1m18s
CI / typecheck (push) Successful in 1m31s
CI / security (push) Successful in 1m36s
CI / e2e_tests (push) Successful in 3m42s
CI / unit_tests (push) Successful in 4m38s
CI / integration_tests (push) Successful in 4m51s
CI / coverage (push) Has started running
CI / docker (push) Successful in 1m30s
CI / benchmark-publish (push) Has started running
CI / helm (pull_request) Successful in 32s
CI / push-validation (pull_request) Successful in 23s
CI / build (pull_request) Successful in 1m2s
CI / lint (pull_request) Successful in 1m11s
CI / quality (pull_request) Successful in 1m16s
CI / typecheck (pull_request) Successful in 1m24s
CI / security (pull_request) Successful in 1m38s
CI / benchmark-publish (pull_request) Has been skipped
CI / e2e_tests (pull_request) Successful in 4m36s
CI / unit_tests (pull_request) Successful in 4m48s
CI / benchmark-regression (pull_request) Failing after 1m23s
CI / docker (pull_request) Successful in 1m49s
CI / coverage (pull_request) Successful in 10m54s
CI / integration_tests (pull_request) Failing after 3m59s
CI / status-check (pull_request) Failing after 4s
Remove the [:8] truncation from session IDs in the Rich table row,
Most Recent summary, and Oldest summary fields of list_sessions()
and _session_list_dict().  Session IDs are 26-character ULIDs and
must be usable directly for copy-paste into session tell, session
show, and other session commands.  The structured output (JSON/YAML)
already used full IDs in the sessions[*].id field, but the summary
panel leaked the truncation into those formats as well.

Added Behave scenarios:
- Rich table displays full 26-character ULIDs (scoped to table region)
- Summary panel shows full ULIDs for unnamed sessions (scoped to panel)
- Summary panel shows session names for named sessions
- Full ULID from list output works with session tell (round-trip,
  uses parsed ULID, not hardcoded constant)

Review Cycle 2 fixes:
- docs/specification.md: Updated YAML output example to full ULIDs
- docs/showcase/*.md: Updated all example output blocks to full ULIDs
- docs/reference/session_cli.md: Replaced placeholder with full ULID
- features/session_cli.feature: Consecutive When steps -> And
- features/steps/session_cli_steps.py: Summary panel asserts both IDs,
  8-char negative guard in table output, ULID capture scoped to table
  region with fixture verification, named-session absence check for
  second session
- CHANGELOG.md: Added [Unreleased] entry for the behavioral change

ISSUES CLOSED: #10970
2026-05-05 10:56:18 +00:00
HAL9000 ab15eec673 docs(showcase): add audit log and security commands example to registry
CI / lint (push) Successful in 1m14s
CI / quality (push) Successful in 1m13s
CI / typecheck (push) Successful in 1m24s
CI / security (push) Successful in 1m41s
CI / push-validation (push) Successful in 30s
CI / helm (push) Successful in 39s
CI / benchmark-publish (push) Failing after 44s
CI / build (push) Successful in 50s
CI / e2e_tests (push) Successful in 3m48s
CI / integration_tests (push) Successful in 7m20s
CI / unit_tests (push) Successful in 9m1s
CI / docker (push) Successful in 1m47s
CI / coverage (push) Successful in 12m50s
CI / status-check (push) Successful in 3s
CI / benchmark-publish (pull_request) Has been skipped
CI / coverage (pull_request) Successful in 10m46s
CI / typecheck (pull_request) Successful in 1m46s
CI / unit_tests (pull_request) Successful in 5m23s
CI / docker (pull_request) Successful in 1m30s
CI / push-validation (pull_request) Successful in 29s
CI / lint (pull_request) Successful in 1m15s
CI / build (pull_request) Successful in 1m4s
CI / helm (pull_request) Successful in 30s
CI / quality (pull_request) Successful in 1m36s
CI / security (pull_request) Successful in 1m56s
CI / integration_tests (pull_request) Successful in 3m53s
CI / e2e_tests (pull_request) Successful in 4m10s
CI / status-check (pull_request) Successful in 3s
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
2026-04-28 20:47:15 +00:00
HAL9000 0f0efe02e3 docs: update examples.json index with actor management workflow entry
CI / helm (pull_request) Successful in 34s
CI / build (pull_request) Successful in 50s
CI / lint (pull_request) Successful in 57s
CI / push-validation (pull_request) Successful in 28s
CI / quality (pull_request) Successful in 1m23s
CI / typecheck (pull_request) Successful in 1m28s
CI / benchmark-publish (pull_request) Has been skipped
CI / security (pull_request) Successful in 1m37s
CI / e2e_tests (pull_request) Successful in 3m46s
CI / integration_tests (pull_request) Successful in 4m32s
CI / unit_tests (pull_request) Successful in 5m50s
CI / docker (pull_request) Successful in 1m22s
CI / coverage (pull_request) Successful in 13m4s
CI / status-check (push) Blocked by required conditions
CI / benchmark-publish (push) Failing after 39s
CI / push-validation (push) Successful in 22s
CI / helm (push) Successful in 35s
CI / status-check (pull_request) Successful in 5s
CI / build (push) Successful in 50s
CI / lint (push) Successful in 1m17s
CI / quality (push) Successful in 1m34s
CI / typecheck (push) Successful in 1m36s
CI / security (push) Successful in 1m38s
CI / coverage (push) Has started running
CI / e2e_tests (push) Successful in 3m51s
CI / integration_tests (push) Successful in 4m19s
CI / unit_tests (push) Successful in 5m20s
CI / docker (push) Successful in 2m4s
ISSUES CLOSED: #7539
2026-04-26 16:52:36 +00:00
HAL9000 39b6fb3fa8 docs: harden backup script example
CI / lint (pull_request) Successful in 34s
CI / build (pull_request) Successful in 31s
CI / quality (pull_request) Successful in 56s
CI / push-validation (pull_request) Successful in 24s
CI / typecheck (pull_request) Successful in 1m12s
CI / security (pull_request) Successful in 1m12s
CI / helm (pull_request) Successful in 36s
CI / e2e_tests (pull_request) Successful in 4m38s
CI / integration_tests (pull_request) Successful in 5m12s
CI / unit_tests (pull_request) Successful in 7m43s
CI / docker (pull_request) Successful in 1m54s
CI / coverage (pull_request) Successful in 14m53s
CI / status-check (pull_request) Successful in 1s
CI / benchmark-publish (pull_request) Has been skipped
CI / benchmark-regression (pull_request) Failing after 10h26m29s
2026-04-10 23:37:56 +00:00
HAL9000 6523034cb0 docs: add actor context management showcase (remove, export, import)
Document the CLI-based lifecycle for removing, exporting, and importing named contexts, including JSON import limitations and scripting examples.

ISSUES CLOSED: #4409
2026-04-10 23:37:56 +00:00
HAL9000 057e3f5bfb docs: showing off some showcased workflows
ci.yml / docs: showing off some showcased workflows (push) Failing after 0s
2026-04-07 15:27:39 -04:00
HAL9000 ccfbf11009 docs: add showcase example for server and A2A integration
ci.yml / docs: add showcase example for server and A2A integration (push) Failing after 0s
Adds a complete end-to-end walkthrough of the server connection CLI
commands and A2A protocol facade, verified by the UAT system with real
command outputs. Covers:

- agents server --help, connect, status, serve commands
- All output formats (rich, json, yaml, plain)
- A2A JSON-RPC 2.0 wire format (A2aRequest, A2aResponse, A2aEvent)
- A2aLocalFacade: 42 supported operations, stub mode, service wiring
- get_facade() wired to real DI container
- A2aVersionNegotiator: version negotiation and mismatch handling
- ServerConnectionConfig: validation rules

Also updates examples.json index with the new entry.
2026-04-07 14:54:49 +00:00
HAL9000 07f9364bcb docs: add showcase example for database migration management
ci.yml / docs: add showcase example for database migration management (push) Failing after 0s
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
freemo e54818d5cb feat: enhance UAT tester with automatic documentation generation
ci.yml / feat: enhance UAT tester with automatic documentation generation (push) Failing after 0s
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.
2026-04-06 00:12:06 +00:00