2.6 KiB
2.6 KiB
id, title, status, wave, depends_on, plan, spec, adr
| id | title | status | wave | depends_on | plan | spec | adr | |
|---|---|---|---|---|---|---|---|---|
| 05-end-to-end-fixture | Managed fixture end-to-end proof | in_progress | 4 |
|
plan.md | ../../specs/plugins/requirements/agent-tools.md | ../../decisions/2026-08-11-plugin-tools-through-kandev-mcp.md |
Task 05: Managed fixture end-to-end proof
Acceptance
- The managed fixture declares and implements a tool that returns its arguments and immutable Kandev-bound context, plus controlled error/timeout behavior.
- A real subprocess plus MCP JSON-RPC integration test proves discovery, invocation, schema rejection before RPC, structured result mapping, and cancellation/no-retry behavior.
- Live removal/recovery tests prove one list-changed notification per effective change, stale snapshot rejection, fail-closed calls after removal, and clean subprocess/server teardown.
Verification
cd apps/backend && go test -race -run 'Test.*PluginAgentTool' ./internal/plugins/runtime ./internal/mcp/server ./internal/mcp/handlers ./internal/backendapp
Files likely touched
apps/backend/internal/plugins/runtime/testdata/fixtureplugin/main.goapps/backend/internal/plugins/runtime/manager_test.goapps/backend/internal/mcp/server/plugin_tools_integration_test.goapps/backend/internal/backendapp/plugin_agent_tools_integration_test.go
Dependencies
Task 04.
Parallelism
Sequential. It exercises the complete implementation and may adjust only test seams, not redefine public contracts.
Inputs
- Every spec scenario
- Existing managed runtime fixture, MCP external integration test, initialized MCP session, and plugin runtime teardown patterns
Risks
- Subprocess tests can leak or flake if they use sleeps. Use bounded contexts, readiness signals, explicit cleanup, and deterministic invocation counters.
- The integration must prove no retry rather than only asserting one successful response.
Output contract
Report full-path evidence, subprocess artifacts and cleanup, invocation counts, notification counts, exact commands/results, and task/plan status updates.
Results
- Extended
cmd/plugin-fixturewith the manifest-declaredtest_echotool, which returns arguments and bound task/surface context over the SDK RPC. - Built
.build/kandev-plugin-e2e-1.0.0.tar.gz, sideloaded it into a running backend, and verified the installed record is active withtest_echo. - Verification:
go test ./cmd/plugin-fixtureandmake e2e-plugin-packagepassed. The SDK gRPC round-trip test also passes inpkg/pluginsdk. - Full MCP JSON-RPC subprocess integration and lifecycle hot-removal coverage remain future work.