hurui200320
554d6889cc
CI / lint (push) Successful in 17s
CI / build (push) Successful in 17s
CI / quality (push) Successful in 28s
CI / security (push) Successful in 43s
CI / typecheck (push) Successful in 46s
CI / benchmark-regression (push) Has been skipped
CI / unit_tests (push) Successful in 3m34s
CI / integration_tests (push) Successful in 3m37s
CI / docker (push) Successful in 56s
CI / e2e_tests (push) Successful in 5m19s
CI / coverage (push) Successful in 7m4s
CI / benchmark-publish (push) Successful in 20m58s
## Summary Add the missing `--skill` repeatable flag to `actor run` and `actor-run` CLI commands, aligning the implementation with the specification (CLI Synopsis line 277). The flag enables ad-hoc skill injection at runtime without modifying YAML configuration. Closes #887 ## Changes ### DI Container - **`container.py`**: Added `_build_skill_service()` factory and `skill_service` Singleton provider, following the established `_build_*` pattern. Falls back to in-memory `SkillService()` when the database is unavailable. Exception handling narrowed to `(ImportError, OperationalError, DatabaseError, OSError)` with `exc_info=True` for traceability. ### CLI Layer - **`actor.py`**: Added `--skill` Typer option (`list[str] | None`, repeatable, `metavar="NAME"`). Help text notes that skills only augment tool-bearing agents. Wrapped constructor in the existing `try/except` block so `CleverAgentsException` from skill resolution is properly caught. - **`actor_run.py`**: Same `--skill` option with `metavar="NAME"`. Exception handler catches `CleverAgentsException` (matching master — not broadened to `CleverAgentsError`). - **`skill.py`**: Removed module-level `_service` cache. `_get_skill_service()` now always delegates to `get_container().skill_service()` so that `reset_container()` correctly invalidates the cached instance. `_reset_skill_service()` now overrides the container's provider via `providers.Object()`. Removed dead `validate_skill_names()` function. ### Runtime Layer - **`application.py`** (438 lines, down from 625): `ReactiveCleverAgentsApp` gains `skill_names` parameter with automatic deduplication via `dict.fromkeys`. `_resolve_skills()` obtains `SkillService` from the DI container (no CLI layer import). Separate `except KeyError` and `except ValueError` produce distinct error messages (`"not found in registry"` vs `"resolution failed: {exc}"`). Skill tools are only injected into agents that already have tools (`if self._resolved_skill_tools and tools:`), preventing LLM agents from being converted to pass-through `SimpleToolAgent` instances. When skill tools are skipped for tool-less agents, `logger.debug` emits a diagnostic message. `_sanitize_skill_name()` validates skill name format with tightened regex: `^[\w.-]{1,127}/[\w.-]{1,127}$` with `re.ASCII` flag. Zero-tool skill warning now uses `logger.warning` (not `print(stderr)`), ensuring structured log output and proper log-level filtering. - **`graph_executor.py`** (334 lines): Extracted graph execution logic. Type annotations improved. ### Tests - 24+ Behave scenarios across feature files covering: single/multiple/unknown skill flags, skill+context combined, duplicate deduplication, skill resolution, ValueError path, zero-tool resolution, error handling, tool merging, default behavior, overrides, LLM agent guard, `_sanitize_skill_name` edge cases (empty string, too-long name, ANSI escape codes, disallowed characters), `_build_skill_service` happy+fallback paths, `_get_skill_service` container delegation. - CLI "unknown skill" tests for **both** `actor.py` and `actor_run.py` exercise the real error chain (mock only `get_container()`, not the entire `ReactiveCleverAgentsApp`), testing `_resolve_skills()` → `CleverAgentsException` → `except CleverAgentsException` → exit code 2 end-to-end. - Combined skill+context tests assert `ContextManager` was instantiated and `exists()` was called in dedicated **Then** steps. - `@coverage` tags added to all new scenarios. - **Robot Framework smoke tests** added (`robot/skill_actor_run.robot` + `robot/helper_skill_actor_run.py`): unknown-skill error path and valid-skill acceptance path. ### Changelog - Added entry under `## Unreleased` in `CHANGELOG.md`. ## Review Fixes Applied (Brent Edwards, Rounds 1 & 2) | # | Finding | Resolution | |---|---------|------------| | **P1-1** | `print(stderr)` for zero-tool skill warning | **Fixed** — replaced with `logger.warning("Skill '%s' resolved to zero tools", name)`, removed unused `import sys` | | **P2-2** | Skill tools silently skipped for tool-less agents | **Fixed** — added `logger.debug` when skipped; updated `--skill` help text to note "only augments tool-bearing agents" | | **P2-3** | `container.py` at 739 lines | **Acknowledged** — pre-existing growth (+59 lines for `_build_skill_service`); extracting factories is a separate refactoring task | | **P2-4↑** | `CleverAgentsException` → `CleverAgentsError` broadens catch scope | **Fixed** — reverted `actor_run.py` to `except CleverAgentsException` matching master | | **P3-5** | No Robot Framework smoke test for `--skill` | **Fixed** — added `skill_actor_run.robot` with 2 test cases (unknown-skill error, valid-skill acceptance) | | **P3-6** | `GraphExecutor._follow_chained_edges` static-calling-static | **Acknowledged** — cosmetic pattern that doesn't affect correctness; can address in a follow-up | ## Known Limitations / Deferred Items | Item | Reason | |------|--------| | `actor.py` at 679 lines (500-line guideline) | Pre-existing (670 on master), +9 lines for `--skill`. Refactoring the shared `_execute()` closure is a separate task. | | `container.py` at 739 lines (500-line guideline) | Was 680 lines on master, +59 lines for `_build_skill_service()` and `skill_service` provider. Refactoring into sub-modules is a separate task. | | Code duplication between `actor.py` and `actor_run.py` `run()` | ~47 lines identical code. Coupled with the line-count issue above — both require extracting shared execution logic into a helper module. | | `SimpleToolAgent` only executes `tools[0]` | Deferred to #974. Pre-existing architectural limitation, not introduced by this PR. | | `GraphExecutor._follow_chained_edges` static-calling-static pattern | Cosmetic, doesn't affect behavior. | ## Quality Gates - `nox -s lint`: ✅ PASS - `nox -s typecheck`: ✅ PASS (0 errors) - `nox -s unit_tests`: ✅ PASS (11,130 scenarios, 0 failures) - `nox -s integration_tests`: ✅ PASS (1,559 tests, 0 failures) - `nox -s coverage_report`: ✅ 97% (meets threshold) - Branch rebased onto latest `master` (`ab1fd19b`) Reviewed-on: #971 Co-authored-by: Rui Hu <rui.hu@cleverthis.com> Co-committed-by: Rui Hu <rui.hu@cleverthis.com>
87 lines
3.3 KiB
Gherkin
87 lines
3.3 KiB
Gherkin
Feature: Actor run command coverage
|
|
As a developer
|
|
I want the actor run command module covered
|
|
So the standalone actor run command stays reliable
|
|
|
|
@coverage
|
|
Scenario: Actor run command loads context and persists output
|
|
Given an actor CLI runner
|
|
And I have an actor JSON config file
|
|
And I have a saved context JSON file
|
|
And I have an actor output file path
|
|
When I invoke the actor-run command with load context and a context name
|
|
Then the actor run should write output and persist context
|
|
|
|
@coverage
|
|
Scenario: Actor run command loads context without name
|
|
Given an actor CLI runner
|
|
And I have an actor JSON config file
|
|
And I have a saved context JSON file
|
|
When I invoke the actor-run command with load context only
|
|
Then the actor run should update global context and echo result
|
|
|
|
@coverage
|
|
Scenario: Actor run command reuses named context
|
|
Given an actor CLI runner
|
|
And I have an actor JSON config file
|
|
When I invoke the actor-run command with context only
|
|
Then the actor run should reuse saved context
|
|
|
|
@coverage
|
|
Scenario: Actor run command executes without context
|
|
Given an actor CLI runner
|
|
And I have an actor JSON config file
|
|
When I invoke the actor-run command without any context
|
|
Then the actor run should call single shot without context manager
|
|
|
|
@coverage
|
|
Scenario: Actor run command reports unsafe configuration error
|
|
Given an actor CLI runner
|
|
And I have an actor JSON config file
|
|
When I invoke the actor-run command with an unsafe configuration error
|
|
Then the actor run should exit with error code 1
|
|
|
|
@coverage
|
|
Scenario: Actor run command reports clever agents exception
|
|
Given an actor CLI runner
|
|
And I have an actor JSON config file
|
|
When I invoke the actor-run command with a clever agents exception
|
|
Then the actor run should exit with error code 2
|
|
|
|
@coverage
|
|
Scenario: Actor run command with single skill flag
|
|
Given an actor CLI runner
|
|
And I have an actor JSON config file
|
|
When I invoke the actor-run command with a single skill flag
|
|
Then the actor run should pass skill names to the runtime
|
|
|
|
@coverage
|
|
Scenario: Actor run command with multiple skill flags
|
|
Given an actor CLI runner
|
|
And I have an actor JSON config file
|
|
When I invoke the actor-run command with multiple skill flags
|
|
Then the actor run should pass all skill names to the runtime
|
|
|
|
@coverage
|
|
Scenario: Actor run command with unknown skill flag
|
|
Given an actor CLI runner
|
|
And I have an actor JSON config file
|
|
When I invoke the actor-run command with an unknown skill flag
|
|
Then the actor run should exit with skill not found error
|
|
|
|
@coverage
|
|
Scenario: Actor run command with skill and context flags combined
|
|
Given an actor CLI runner
|
|
And I have an actor JSON config file
|
|
When I invoke the actor-run command with skill and context flags
|
|
Then the actor run should pass skill names to the runtime
|
|
And the context manager should have been instantiated
|
|
And the context manager exists should have been called
|
|
|
|
@coverage
|
|
Scenario: Actor run command with duplicate skill names
|
|
Given an actor CLI runner
|
|
And I have an actor JSON config file
|
|
When I invoke the actor-run command with duplicate skill flags
|
|
Then the actor run should pass duplicate skill names to the runtime
|