aditya b25a886df8 feat(skill): add MCP refresh hooks ...

Implement SkillRegistry.refresh(name) and refresh_all() to recompute
flattened tool sets on demand. Wire MCPToolAdapter.dispatch_notification()
to MCPRefreshHook, which debounces rapid notifications/tools/list_changed
bursts into a single refresh_all() call (default 0.5 s window).

Add safeguard that skips tool-ref validation when no ToolRegistry is
configured, emitting a single WARNING with recovery steps. Introduce
immutable SkillRefreshResult (refreshed/failed/skipped counts) with
to_summary() and merge() for CLI and log output.

New files:
- src/cleveragents/skills/refresh.py        (SkillRefreshResult)
- src/cleveragents/mcp/refresh_hook.py      (MCPRefreshHook)
- features/skill_refresh.feature            (19 Behave scenarios)
- features/steps/skill_refresh_steps.py
- robot/skill_refresh.robot                 (10 Robot tests)
- robot/helper_skill_refresh.py
- benchmarks/skill_refresh_bench.py         (ASV benchmarks)
- docs/reference/skill_refresh.md

Modified:
- src/cleveragents/skills/registry.py       (refresh, refresh_all)
- src/cleveragents/mcp/adapter.py           (notification listener API)
- src/cleveragents/skills/__init__.py       (export SkillRefreshResult)
- src/cleveragents/mcp/__init__.py          (export MCPRefreshHook)
- CHANGELOG.md

ISSUES CLOSED #168

2026-02-26 12:29:49 +00:00

..

__init__.py

Significantly revamped the base project to use more robust static checking including benchmarks and integration test support

2025-10-31 16:18:53 -04:00

acp_facade_bench.py

feat(M6.1): ACP facade stubs with transport, events, and versioning

2026-02-22 15:02:19 +00:00

action_cli_bench.py

feat(cli): align action commands to spec

2026-02-14 12:16:39 -05:00

action_schema_bench.py

docs(action): add action YAML schema and examples

2026-02-13 19:01:55 +05:30

actor_cli_bench.py

feat(cli): align actor commands to YAML

2026-02-24 19:12:01 +00:00

actor_compiler_bench.py

feat(actor): compile hierarchical actor configs to LangGraph

2026-02-24 17:57:18 +00:00

actor_examples_load_bench.py

test(actor): add ASV benchmarks for actor examples loading

2026-02-18 10:49:26 +00:00

actor_loading_bench.py

feat(actor): add actor registry and loader

2026-02-19 11:29:34 +00:00

actor_registry_bench.py

Fix: Fixed linting errors

2026-02-22 14:18:24 -05:00

actor_runtime_bench.py

Fix: Fixed linting errors

2026-02-22 14:18:24 -05:00

actor_schema_bench.py

perf(actor): add ASV benchmarks for actor schema

2026-02-17 13:54:27 +00:00

agent_skills_registry_bench.py

feat(concurrency): add plan and project locks

2026-02-25 10:48:05 -05:00

apply_pipeline_bench.py

feat(apply): add validation-gated apply pipeline

2026-02-25 10:01:57 +00:00

automation_legacy_cleanup_bench.py

refactor(automation): remove automation_level legacy fields

2026-02-20 15:57:21 +00:00

automation_profile_bench.py

feat(automation): add automation profiles and guards

2026-02-22 10:19:43 +00:00

automation_profile_cli_bench.py

Fix: Fixed linting errors

2026-02-22 14:18:24 -05:00

automation_profile_resolution_bench.py

refactor(automation): remove automation_level legacy fields

2026-02-20 15:57:21 +00:00

binding_resolution_bench.py

Fix: Fixed linting errors

2026-02-22 14:18:24 -05:00

change_tracking_bench.py

feat(change): add ChangeSet models and invocation tracker

2026-02-21 16:27:40 +00:00

changeset_capture_bench.py

Merge branch 'master' into develop-20260217

2026-02-18 03:27:00 +00:00

changeset_persistence_bench.py

feat(changeset): persist changesets and diff artifacts

2026-02-26 02:47:14 +00:00

ci_yaml_parse_bench.py

feat(ci): add nox-based PR validation workflow

2026-02-12 22:01:51 +00:00

cleanup_bench.py

Fix: Fixed linting errors

2026-02-22 14:18:24 -05:00

cli_benchmark.py

Tests: Added benchmarks for PlanGenerationGraph

2025-12-11 13:55:55 -05:00

cli_core_bench.py

feat(cli): enhance version/info/diagnostics with --format and --check

2026-02-18 12:18:03 +00:00

cli_extension_tests_bench.py

test(coverage): add Behave scenarios for remaining under-tested modules

2026-02-25 19:38:43 -05:00

cli_extensions_bench.py

test(cli): cover action and plan extensions

2026-02-24 20:11:42 +00:00

cli_format_bench.py

refactor(automation): remove automation_level legacy fields

2026-02-20 15:57:21 +00:00

cli_robot_flow_bench.py

fix(ci): remove stale AutomationLevel refs from benchmarks and prevent ANSI in JSON output

2026-02-20 21:46:46 +00:00

concurrency_lock_bench.py

feat(concurrency): add plan and project locks

2026-02-25 10:48:05 -05:00

config_cli_bench.py

fix(bench): remove unsupported mix_stderr param from CliRunner in config_cli_bench

2026-02-20 22:19:26 +00:00

config_resolution_bench.py

feat(config): add config service with multi-level resolution

2026-02-23 10:44:58 +00:00

cost_controls_bench.py

feat(provider): add cost controls and fallback

2026-02-25 12:08:01 -05:00

coverage_report_bench.py

feat(repo): add resource repositories

2026-02-16 21:35:54 +00:00

db_migration_action_args_bench.py

feat(db): add spec-aligned action and plan tables with migrations, ORM models, and benchmarks

2026-02-13 13:05:20 -05:00

db_migration_actions_bench.py

feat(db): add spec-aligned action and plan tables with migrations, ORM models, and benchmarks

2026-02-13 13:05:20 -05:00

db_migration_plans_bench.py

refactor(automation): remove automation_level legacy fields

2026-02-20 15:57:21 +00:00

decision_correction_bench.py

feat(M4.2): Correction service with revert/append BFS + dry-run

2026-02-22 16:40:06 +00:00

decision_correction_model_bench.py

feat(correction): add correction model and CLI hooks

2026-02-22 11:07:35 +00:00

decision_model_bench.py

feat(decision): add decision domain and context snapshots

2026-02-23 22:19:19 +00:00

diff_review_bench.py

feat(change): add diff review artifacts

2026-02-25 10:02:38 +00:00

docs_build_bench.py

style: fix formatting

2026-02-20 20:38:53 +00:00

dod_evaluation_bench.py

feat(dod): enforce definition-of-done gating

2026-02-25 10:04:31 +00:00

error_recovery_bench.py

feat(concurrency): add plan and project locks

2026-02-25 10:48:05 -05:00

file_tool_bench.py

feat(skill): add file operation skills

2026-02-21 10:18:26 -05:00

git_tool_bench.py

test(robot): fix failing integration tests related to safe.directory config and git version

2026-02-21 18:11:31 +00:00

inline_tool_bench.py

feat(skill): add inline tool executor

2026-02-20 08:50:08 -05:00

invariant_merge_bench.py

Fix: Fixed linting errors

2026-02-22 14:18:24 -05:00

legacy_removal_bench.py

refactor(automation): remove automation_level legacy fields

2026-02-20 15:57:21 +00:00

lsp_registry_bench.py

feat(lsp): add registry and runtime stubs

2026-02-22 10:15:25 +00:00

m1_sourcecode_smoke_bench.py

test(e2e): add M1 source-code plan lifecycle suite

2026-02-25 04:50:43 +00:00

m2_actor_tool_smoke_bench.py

test(coverage): add Behave scenarios for remaining under-tested modules

2026-02-25 19:38:43 -05:00

mcp_runtime_bench.py

feat(skill): add MCP adapter for external tools

2026-02-25 13:17:26 +00:00

output_rendering_bench.py

feat(cli): add output rendering framework with materialization strategies

2026-02-21 10:19:45 -05:00

persistence_robot_bench.py

fix(ci): remove stale AutomationLevel refs from benchmarks and prevent ANSI in JSON output

2026-02-20 21:46:46 +00:00

persistence_suites_bench.py

refactor(automation): remove automation_level legacy fields

2026-02-20 15:57:21 +00:00

phase_reversion_bench.py

Fix: linting errors fixed

2026-02-23 09:47:00 -05:00

plan_actor_integration_bench.py

feat(plan): execute strategize and execute via actors

2026-02-21 10:18:26 -05:00

plan_cli_bench.py

refactor(automation): remove automation_level legacy fields

2026-02-20 15:57:21 +00:00

plan_cli_smoke_bench.py

refactor(automation): remove automation_level legacy fields

2026-02-20 15:57:21 +00:00

plan_diff_bench.py

Tests: Significantly improved coverage of the unit tests

2026-02-22 00:43:08 -05:00

plan_execute_bench.py

feat(M1.2): PlanExecutionContext, RuntimeExecuteActor, and runtime mode

2026-02-22 15:13:43 +00:00

plan_generation_benchmark.py

feat(domain): add spec-aligned Resource and Project models

2026-02-13 21:54:31 +00:00

plan_lifecycle_persistence_bench.py

fix(tests): resolve unit test and benchmark failures

2026-02-17 02:24:35 +00:00

plan_model_bench.py

fix(tests): resolve unit test and benchmark failures

2026-02-17 02:24:35 +00:00

plan_phase_bench.py

Fix: Fixed linting errors

2026-02-22 14:18:24 -05:00

plan_phase_migration_bench.py

Merge branch 'master' into feature/q0-min-coverage

2026-02-17 02:35:20 +00:00

plan_repository_bench.py

refactor(automation): remove automation_level legacy fields

2026-02-20 15:57:21 +00:00

plan_resume_bench.py

feat(concurrency): add plan resume

2026-02-25 14:00:04 -05:00

project_cli_bench.py

feat(cli): add project commands (core)

2026-02-16 23:56:55 -05:00

project_context_cli_bench.py

Merge branch 'master' into develop-20260217

2026-02-18 03:27:00 +00:00

project_context_policy_bench.py

Merge branch 'master' into develop-20260217

2026-02-18 03:27:00 +00:00

project_migration_bench.py

Merge branch 'master' into feature/q0-min-coverage

2026-02-17 02:35:20 +00:00

project_repository_bench.py

Tests: Significantly improved coverage of the unit tests

2026-02-22 00:43:08 -05:00

repl_bench.py

feat(cli): add interactive repl

2026-02-23 03:11:12 +00:00

resource_cli_bench.py

feat(cli): add resource commands (core)

2026-02-16 16:46:54 -05:00

resource_cli_tree_bench.py

feat(cli): add resource tree and inspect commands

2026-02-20 08:48:33 -05:00

resource_dag_bench.py

Fix: Fixed linting errors

2026-02-22 14:18:24 -05:00

resource_handler_bench.py

feat(resource): add handler runtime for git-checkout and fs-directory

2026-02-23 22:20:44 +00:00

resource_registry_bench.py

refactor(benchmark): clean up resource registry bench per review

2026-02-23 22:20:44 +00:00

resource_registry_migration_bench.py

Merge branch 'master' into feature/q0-min-coverage

2026-02-17 02:35:20 +00:00

resource_repository_bench.py

feat(session): add session persistence and repositories

2026-02-18 00:10:15 +00:00

resource_service_bench.py

feat(cli): add resource commands (core)

2026-02-16 16:46:54 -05:00

resource_type_builtin_bench.py

feat(resource): add git-checkout and fs-directory resource types

2026-02-15 10:44:14 -05:00

resource_type_fs_bench.py

Merge branch 'master' into develop-20260217

2026-02-18 03:27:00 +00:00

resource_type_model_bench.py

feat(resource): add resource type model + schema loader

2026-02-15 15:19:09 +00:00

resource_type_schema_bench.py

feat(resource): add resource type model + schema loader

2026-02-15 15:19:09 +00:00

scale_fixture_bench.py

test(perf): add scale test fixtures

2026-02-20 03:31:43 +00:00

search_tool_bench.py

feat(skill): add directory and search skills

2026-02-21 10:18:26 -05:00

security_audit_bench.py

Tests: Significantly improved coverage of the unit tests

2026-02-22 00:43:08 -05:00

security_eval_bench.py

fix(security): remove eval-based config parsing

2026-02-21 16:32:03 +00:00

security_exception_bench.py

fix(security): enforce explicit exception handling

2026-02-25 10:05:57 +00:00

security_scan_bench.py

feat(qa): align security scans with nox

2026-02-13 19:24:24 +00:00

security_secrets_bench.py

feat(security): add secrets masking and validation (H-21/SEC5)

2026-02-19 11:15:18 +00:00

security_template_bench.py

fix(security): harden template rendering

2026-02-25 10:06:27 +00:00

session_cli_bench.py

feat(cli): add session commands

2026-02-20 01:10:19 +00:00

session_model_bench.py

feat(session): add session domain models and contracts

2026-02-14 03:50:40 +00:00

session_persistence_bench.py

Fix: Fixed linting errors

2026-02-22 14:18:24 -05:00

skill_cli_bench.py

feat(cli): add skill commands

2026-02-17 14:44:40 +00:00

skill_context_bench.py

Fix: Fixed linting errors

2026-02-22 14:18:24 -05:00

skill_flatten_bench.py

feat(actor): compile hierarchical actor configs to LangGraph

2026-02-24 17:57:18 +00:00

skill_protocol_bench.py

feat(skill): add skill protocol and metadata

2026-02-20 08:50:08 -05:00

skill_refresh_bench.py

feat(skill): add MCP refresh hooks

2026-02-26 12:29:49 +00:00

skill_registry_bench.py

feat(skill): add skill registry persistence

2026-02-21 16:30:40 +00:00

skill_resolution_bench.py

feat(skill): add skill domain model and resolver

2026-02-14 03:54:14 +00:00

skill_schema_bench.py

style(skill): apply ruff auto-formatting to skill schema files

2026-02-17 10:13:19 +00:00

subplan_model_validation_bench.py

test(domain): add subplan model suites

2026-02-19 22:07:56 +00:00

tool_builtin_file_bench.py

feat(repo): add resource repositories

2026-02-16 21:35:54 +00:00

tool_cli_bench.py

feat(cli): add tool and validation commands

2026-02-20 08:49:30 -05:00

tool_lifecycle_bench.py

feat(tool): add tool lifecycle runtime

2026-02-14 18:55:48 +00:00

tool_model_bench.py

Fix: Fixed linting errors

2026-02-22 14:18:24 -05:00

tool_registry_bench.py

feat(tool): add tool registry persistence

2026-02-17 20:28:20 +00:00

tool_router_bench.py

feat(change): add tool router for providers

2026-02-21 10:23:31 -05:00

tool_runtime_bench.py

Fix: Fixed linting errors

2026-02-22 14:18:24 -05:00

uow_lifecycle_bench.py

refactor(automation): remove automation_level legacy fields

2026-02-20 15:57:21 +00:00

validation_apply_bench.py

feat(apply): run validation attachments

2026-02-25 10:03:21 +00:00

validation_edge_bench.py

test(validation): add edge case suites

2026-02-20 02:54:08 +00:00

validation_pipeline_bench.py

feat(concurrency): add plan and project locks

2026-02-25 10:48:05 -05:00