feat(resource): add devcontainer resource type and auto-discovery handler #520

Merged

freemo merged 1 commit from feature/m6-devcontainer-handler into master

2026-03-03 03:14:48 +00:00

freemo commented

2026-03-03 00:14:57 +00:00

Owner

Summary

Added container-instance, devcontainer-instance, and devcontainer-file built-in resource types to the resource registry
Implemented DevcontainerHandler with snapshot sandbox strategy and auto-discovery logic for .devcontainer/ directories
Wired handler into the resolver and added CLI support with --path and --image flags
Added Behave tests (22 scenarios), Robot tests (10 cases), ASV benchmarks, and reference documentation

Details

This PR implements the devcontainer resource integration described in ADR-043 and the resource type inheritance from ADR-042. The devcontainer-instance type inherits from container-instance and is auto-discovered when git-checkout or fs-directory resources contain .devcontainer/devcontainer.json or root .devcontainer.json files. JSON validation ensures invalid configs are skipped gracefully.

Files Created

src/cleveragents/resource/handlers/devcontainer.py — DevcontainerHandler
src/cleveragents/resource/handlers/discovery.py — Auto-discovery module
features/devcontainer_handler.feature — Behave scenarios
features/steps/devcontainer_handler_steps.py — Step definitions
robot/devcontainer_handler.robot — Robot integration tests
robot/helper_devcontainer_handler.py — Robot helper
benchmarks/devcontainer_handler_bench.py — ASV benchmarks
docs/reference/devcontainer_resources.md — Reference documentation

Files Modified

src/cleveragents/domain/models/core/resource_type.py — Added types to BUILTIN_NAMES
src/cleveragents/application/services/resource_registry_service.py — Added built-in type definitions
src/cleveragents/resource/handlers/__init__.py — Exported DevcontainerHandler
src/cleveragents/cli/commands/resource.py — Added --image flag
CHANGELOG.md — Added entry

Quality Gates

Lint: PASS
Typecheck: PASS (0 errors, Pyright strict)
Unit tests: PASS (22 new scenarios, all passing; pre-existing failures unchanged)
Integration tests: PASS (10 new test cases, all passing; pre-existing failures unchanged)
Coverage: 97%
Benchmarks: Validated

Closes #511

## Summary - Added `container-instance`, `devcontainer-instance`, and `devcontainer-file` built-in resource types to the resource registry - Implemented `DevcontainerHandler` with snapshot sandbox strategy and auto-discovery logic for `.devcontainer/` directories - Wired handler into the resolver and added CLI support with `--path` and `--image` flags - Added Behave tests (22 scenarios), Robot tests (10 cases), ASV benchmarks, and reference documentation ## Details This PR implements the devcontainer resource integration described in ADR-043 and the resource type inheritance from ADR-042. The `devcontainer-instance` type inherits from `container-instance` and is auto-discovered when `git-checkout` or `fs-directory` resources contain `.devcontainer/devcontainer.json` or root `.devcontainer.json` files. JSON validation ensures invalid configs are skipped gracefully. ### Files Created - `src/cleveragents/resource/handlers/devcontainer.py` — DevcontainerHandler - `src/cleveragents/resource/handlers/discovery.py` — Auto-discovery module - `features/devcontainer_handler.feature` — Behave scenarios - `features/steps/devcontainer_handler_steps.py` — Step definitions - `robot/devcontainer_handler.robot` — Robot integration tests - `robot/helper_devcontainer_handler.py` — Robot helper - `benchmarks/devcontainer_handler_bench.py` — ASV benchmarks - `docs/reference/devcontainer_resources.md` — Reference documentation ### Files Modified - `src/cleveragents/domain/models/core/resource_type.py` — Added types to BUILTIN_NAMES - `src/cleveragents/application/services/resource_registry_service.py` — Added built-in type definitions - `src/cleveragents/resource/handlers/__init__.py` — Exported DevcontainerHandler - `src/cleveragents/cli/commands/resource.py` — Added --image flag - `CHANGELOG.md` — Added entry ### Quality Gates - Lint: PASS - Typecheck: PASS (0 errors, Pyright strict) - Unit tests: PASS (22 new scenarios, all passing; pre-existing failures unchanged) - Integration tests: PASS (10 new test cases, all passing; pre-existing failures unchanged) - Coverage: 97% - Benchmarks: Validated Closes #511

Rows
Columns