devstuff 2.14.0__tar.gz → 2.16.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {devstuff-2.14.0 → devstuff-2.16.0}/AGENTS.md +2 -1
- {devstuff-2.14.0 → devstuff-2.16.0}/CHANGELOG.md +12 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/CLAUDE.md +24 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/PKG-INFO +30 -1
- {devstuff-2.14.0 → devstuff-2.16.0}/README.md +29 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/ROADMAP.md +18 -1
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/README.md +1 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/agent/specifications.md +1 -1
- devstuff-2.16.0/docs/specs/mcp/development-plan.md +110 -0
- devstuff-2.16.0/docs/specs/mcp/specifications.md +568 -0
- devstuff-2.16.0/docs/specs/mcp/stack-decisions.md +189 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/pyproject.toml +1 -1
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/agent/bridges.py +73 -1
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/agent/catalog.py +1 -1
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/agent/registry.py +4 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/agent_tools.schema.json +1 -1
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/agent_tools.yaml +37 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/cli.py +2 -0
- devstuff-2.16.0/src/dev_setup/commands/mcp_cmd.py +90 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/outdated_cmd.py +2 -8
- devstuff-2.16.0/src/dev_setup/mcp/__init__.py +1 -0
- devstuff-2.16.0/src/dev_setup/mcp/core.py +443 -0
- devstuff-2.16.0/src/dev_setup/mcp/process.py +120 -0
- devstuff-2.16.0/src/dev_setup/mcp/stdio.py +158 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/updates.py +15 -0
- devstuff-2.16.0/tests/test_agent_bridges.py +258 -0
- devstuff-2.16.0/tests/test_mcp_classify.py +171 -0
- devstuff-2.16.0/tests/test_mcp_core.py +547 -0
- devstuff-2.16.0/tests/test_mcp_process.py +263 -0
- devstuff-2.16.0/tests/test_mcp_stdio.py +465 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/uv.lock +1 -1
- {devstuff-2.14.0 → devstuff-2.16.0}/.claude/skills/run-stuff/SKILL.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/.claude/skills/run-stuff/smoke.sh +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/.github/codex/review.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/.github/workflows/agent.yml +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/.github/workflows/bump.yml +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/.github/workflows/ci.yml +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/.github/workflows/publish.yml +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/.github/workflows/test-installs.yml +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/.gitignore +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/dev/Dockerfile +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/dev/Dockerfile.ci +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/dev/Makefile +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/dev/docker-compose.yml +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/devstuff +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/github-agent.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/agent/development-plan.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/agent/stack-decisions.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/ansible-config/development-plan.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/ansible-config/specifications.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/ansible-config/stack-decisions.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/bat-config/development-plan.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/bat-config/specifications.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/bat-config/stack-decisions.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/commitizen-config/development-plan.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/commitizen-config/specifications.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/commitizen-config/stack-decisions.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/docker-config/development-plan.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/docker-config/specifications.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/docker-config/stack-decisions.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/lazygit-config/development-plan.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/lazygit-config/specifications.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/lazygit-config/stack-decisions.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/outdated/development-plan.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/outdated/specifications.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/outdated/stack-decisions.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/plan-and-progress/specifications.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/precommit-config/development-plan.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/precommit-config/specifications.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/precommit-config/stack-decisions.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/profile/development-plan.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/profile/specifications.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/profile/stack-decisions.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/profile-apply/development-plan.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/profile-apply/specifications.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/profile-apply/stack-decisions.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/starship-config/development-plan.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/starship-config/specifications.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/starship-config/stack-decisions.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/uv-backbone/development-plan.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/uv-backbone/specifications.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/uv-backbone/stack-decisions.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/verbose-mode/development-plan.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/verbose-mode/specifications.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/docs/specs/verbose-mode/stack-decisions.md +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/install.sh +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/__init__.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/__main__.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/agent/__init__.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/agent/approval.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/agent/completion.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/agent/config.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/agent/loop.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/agent/ollama.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/agent/preflight.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/agent/primitives.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/agent/sandbox.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/agent/session.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/agent/transcript.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/agent/wizard.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/apply_exec.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/apply_plan.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/base.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/bundles/ai-agents.yaml +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/bundles/ai-local.yaml +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/bundles/devops.yaml +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/bundles/essentials.yaml +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/bundles/languages.yaml +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/bundles/python.yaml +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/bundles.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/catalog.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/__init__.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/_plan.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/add_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/agent_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/catalog_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/configure_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/delete_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/docs_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/doctor_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/functions_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/help_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/install_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/links_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/list_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/profile_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/remove_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/run_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/skills_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/commands/update_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/__init__.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/ansible/__init__.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/ansible/detect.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/ansible/model.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/ansible/render.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/ansible/validate.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/ansible/wizard.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/bat/__init__.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/bat/detect.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/bat/model.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/bat/preview.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/bat/render.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/bat/wizard.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/commitizen/__init__.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/commitizen/detect.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/commitizen/model.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/commitizen/render.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/commitizen/validate.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/commitizen/wizard.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/docker/__init__.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/docker/detect.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/docker/model.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/docker/render.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/docker/validate.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/docker/wizard.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/lazygit/__init__.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/lazygit/detect.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/lazygit/model.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/lazygit/render.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/lazygit/validate.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/lazygit/wizard.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/precommit/__init__.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/precommit/detect.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/precommit/model.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/precommit/render.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/precommit/validate.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/precommit/wizard.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/reptyr/__init__.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/reptyr/wizard.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/starship/__init__.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/starship/fonts.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/starship/icons.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/starship/model.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/starship/preview.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/starship/render.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/configure/starship/wizard.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/doctor.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/function_runner.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/functions.schema.json +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/functions.yaml +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/functions_catalog.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/functions_registry.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/generic.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/links.schema.json +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/links.yaml +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/links_catalog.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/links_registry.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/profile.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/registry.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/snapshot.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/tools.yaml +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/ui.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/src/dev_setup/verbose.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/__init__.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/integration/__init__.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/integration/conftest.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/integration/test_agent_smoke.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/integration/test_agent_tui.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/integration/test_commitizen_config.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/integration/test_profile_apply.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/integration/test_tools.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_agent.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_agent_completion.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_agent_loop.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_agent_sandbox.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_agent_tools.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_agent_wizard.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_apply_exec.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_apply_plan.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_apply_run.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_bundles.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_catalog.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_configure_ansible.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_configure_bat.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_configure_commitizen.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_configure_docker.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_configure_lazygit.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_configure_precommit.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_configure_reptyr.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_configure_starship.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_doctor.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_functions.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_generic.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_installed_version.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_lifecycle_cmds.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_links.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_outdated_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_pin_support.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_plan_and_select.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_profile.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_profile_apply_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_profile_diff.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_profile_diff_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_profile_snapshot_cmd.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_registry.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_snapshot.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_ui.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_update_checker_parity.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_update_notes.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_updates.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_uv_probes.py +0 -0
- {devstuff-2.14.0 → devstuff-2.16.0}/tests/test_verbose.py +0 -0
|
@@ -66,7 +66,7 @@ didn't have, is stated as exactly that: not as passing.
|
|
|
66
66
|
|
|
67
67
|
Refresh with the `gh pr list` command above when this looks stale.
|
|
68
68
|
|
|
69
|
-
None
|
|
69
|
+
None.
|
|
70
70
|
|
|
71
71
|
### Closed as dropped
|
|
72
72
|
|
|
@@ -84,3 +84,4 @@ start from a fresh branch off `origin/master` and replay the commits rather than
|
|
|
84
84
|
| From | Owed |
|
|
85
85
|
|---|---|
|
|
86
86
|
| [#60](https://github.com/thesawdawg/dev-setup-py/pull/60) `profile apply`, bundles, docs (merged 2026-10-11, released as 2.13.0) | The first run of `make run-apply-tests` (in `dev/`) in the CI image. The test is written, and its `uv` + pinned-`commitizen` half was run against the real installers in an isolated `HOME`; the `yq` half and the container run have not happened. Tick the last box under M3 in `docs/ROADMAP.md` when it passes. |
|
|
87
|
+
| [#62](https://github.com/thesawdawg/dev-setup-py/pull/62) plan preview, live progress view and the guided `add` wizard (merged 2026-10-11, released as 2.14.0) | (1) About ten older sites still put error text into `ui.error`/`ui.dim` unescaped, which raises `MarkupError` on a `[/…]`-shaped string: `configure_cmd`, `doctor_cmd`, `run_cmd`, `skills_cmd`, the commitizen and reptyr wizards, `add_cmd`. Escape with `rich.markup.escape` when touching one (see `docs/specs/plan-and-progress/`, F-1). (2) Not run live: `update` and its picker, the `install`/`remove` pickers, and the `npm`, `apt` and `git` installers under the progress view; unit-tested only. (3) Open design points, deliberately unchanged: a missing requirement asks three questions, and the `add` step counter reads `1/7` then `2/8`. |
|
|
@@ -1,3 +1,15 @@
|
|
|
1
|
+
## v2.16.0 (2026-10-12)
|
|
2
|
+
|
|
3
|
+
### Features
|
|
4
|
+
|
|
5
|
+
- **mcp**: M-2 — devstuff mcp over stdio, with the detach and supervisor
|
|
6
|
+
|
|
7
|
+
## v2.15.0 (2026-10-12)
|
|
8
|
+
|
|
9
|
+
### Features
|
|
10
|
+
|
|
11
|
+
- **mcp**: M-1 — outdated and profile_diff bridges, tool classification, sudo measurement
|
|
12
|
+
|
|
1
13
|
## v2.14.0 (2026-10-11)
|
|
2
14
|
|
|
3
15
|
### Features
|
|
@@ -681,6 +681,30 @@ strategy-dispatch pattern as `_INSTALLERS` in `generic.py`.
|
|
|
681
681
|
`target`. Only a genuinely new mechanism needs a new `impl: primitive` callable registered in
|
|
682
682
|
`_PRIMITIVES`. `type: script` functions are auto-exposed as `fn_<key>` tools with no edit at all.
|
|
683
683
|
|
|
684
|
+
`outdated` and `profile_diff` are bridges that return the *same JSON* as `devstuff outdated --json` /
|
|
685
|
+
`profile diff --json`, built by the same functions (`updates.build_rows`, `profile.compare`) so the command
|
|
686
|
+
and the tool cannot disagree. A parameter of `type: array` is always a list of strings, and
|
|
687
|
+
`AgentTool.bind()` checks names, never types — the bridge is the type check (`_string_list`). The
|
|
688
|
+
`devstuff mcp` server (spec in `docs/specs/mcp/`) gates tools by `mcp.core.classify` — `(impl, target)`, never
|
|
689
|
+
the `mutating` label or the key — and a test fails when a bridge is added to `_BRIDGES` without a gate row.
|
|
690
|
+
|
|
691
|
+
**The MCP server** (`mcp/`, `commands/mcp_cmd.py`, spec in `docs/specs/mcp/`) — things that are load-bearing:
|
|
692
|
+
- **`core.py` is pure; the transports are not.** Gating, binding, JSON-RPC and the probe lifecycle are tested with
|
|
693
|
+
hand-built frames and a fake runner. Listing and calling read **one** `Toolbox`, so a tool that is off is absent
|
|
694
|
+
from `tools/list` *and* refused by `tools/call` — a list-only check passes when dispatch is wide open.
|
|
695
|
+
- **A request's `id` is echoed with its type, and a notification is the *absence* of the key**, never a falsy
|
|
696
|
+
value: Claude Code sends an integer `0` for `initialize`. Unknown methods are `-32601`, not `{}` — the real
|
|
697
|
+
client opens with `server/discover` and falls back to `initialize` only when told it is unknown.
|
|
698
|
+
- **The protocol channel is moved at the descriptor level** (`stdio.isolate_stdio`): private non-inheritable
|
|
699
|
+
`dup`s, then fd 1 → stderr and fd 0 → `/dev/null`. Anything that prints, however it does it, lands on stderr.
|
|
700
|
+
The test leaks through five routes and has a control showing the same leaks corrupt an un-isolated stream.
|
|
701
|
+
- **The server detaches from its terminal first** (`process.detach`): `/dev/null` stdin does *not* stop `sudo`
|
|
702
|
+
prompting on `/dev/tty`. `setsid`, else fork + supervisor (`EPERM` from a shell), then verify and fail closed.
|
|
703
|
+
The supervisor forwards `SIGHUP` as `SIGTERM` or a closed terminal orphans the server.
|
|
704
|
+
- **Reads are never blocked by an install; they are kept honest.** `generic._once` memos live as long as the
|
|
705
|
+
process, so `Dispatcher` clears them when a burst of reads starts and after every mutation (in `finally`), and
|
|
706
|
+
re-runs a read a mutation straddled. The advisory note is a *separate* content item so JSON stays parseable.
|
|
707
|
+
|
|
684
708
|
**Security invariants — do not weaken these without deliberate thought:**
|
|
685
709
|
- `Workspace.resolve()` in `agent/sandbox.py` is the *only* thing standing between the model and
|
|
686
710
|
the filesystem. It resolves symlinks and `..` **before** the containment check; reordering that
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: devstuff
|
|
3
|
-
Version: 2.
|
|
3
|
+
Version: 2.16.0
|
|
4
4
|
Summary: Development environment setup CLI for Linux
|
|
5
5
|
Project-URL: Repository, https://github.com/thesawdawg/dev-setup-py
|
|
6
6
|
Author-email: Sawyer <sawyerksu@gmail.com>
|
|
@@ -1159,6 +1159,33 @@ confirmation.
|
|
|
1159
1159
|
|
|
1160
1160
|
---
|
|
1161
1161
|
|
|
1162
|
+
## MCP server (`devstuff mcp`)
|
|
1163
|
+
|
|
1164
|
+
`devstuff mcp` serves devstuff's tools to an MCP client over **stdio**. It is started *by* the client, not by
|
|
1165
|
+
hand. Register it with Claude Code:
|
|
1166
|
+
|
|
1167
|
+
```bash
|
|
1168
|
+
claude mcp add devstuff -- devstuff mcp # read-only tools only
|
|
1169
|
+
claude mcp add devstuff -- devstuff mcp --allow-install # also install_tool
|
|
1170
|
+
```
|
|
1171
|
+
|
|
1172
|
+
| Flag | Effect |
|
|
1173
|
+
|---|---|
|
|
1174
|
+
| *(none)* | `list_tools`, `search_catalog`, `tool_info`, `outdated`, `profile_diff` — nothing that changes the machine |
|
|
1175
|
+
| `--allow-install` | adds `install_tool`, which installs a catalog tool as you |
|
|
1176
|
+
| `--allow-functions` | adds every `type: script` function as `fn_<key>` |
|
|
1177
|
+
| `--list-tools` | print what these flags would expose, and which gate each tool sits behind; starts nothing |
|
|
1178
|
+
|
|
1179
|
+
A tool whose flag is off is not hidden but **absent and refused**: a call naming it is answered as an unknown tool.
|
|
1180
|
+
Workspace tools (`read_file`, `run_command`, …) never exist here — the client already has files and a shell.
|
|
1181
|
+
|
|
1182
|
+
The server has **no terminal**: an installer that needs a `sudo` password fails at once with a message telling the
|
|
1183
|
+
client to run `devstuff install <key>` in a terminal, rather than waiting for a password nobody can type.
|
|
1184
|
+
Logs (`-v`, `-vv`) go to stderr. HTTP and OpenAPI front ends are still to come; see
|
|
1185
|
+
[`docs/specs/mcp/`](docs/specs/mcp/).
|
|
1186
|
+
|
|
1187
|
+
---
|
|
1188
|
+
|
|
1162
1189
|
## Agent
|
|
1163
1190
|
|
|
1164
1191
|
`devstuff agent` opens an interactive session with a **local** model (via [Ollama](https://ollama.com))
|
|
@@ -1260,6 +1287,8 @@ deny_patterns: [] # extra regexes refused on top of the built-in
|
|
|
1260
1287
|
| `list_tools` | | List the devstuff catalog with install state |
|
|
1261
1288
|
| `search_catalog` | | Find a catalog tool by name or description |
|
|
1262
1289
|
| `tool_info` | | Details for one catalog tool |
|
|
1290
|
+
| `outdated` | | Which installed tools have a newer version (the rows `devstuff outdated --json` prints) |
|
|
1291
|
+
| `profile_diff` | | Compare this machine to a bundled profile such as `@devops` (the rows `profile diff --json` prints) |
|
|
1263
1292
|
| `install_tool` | ! | Install a catalog tool (handles sudo itself) |
|
|
1264
1293
|
| `fn_<key>` | ! | Every `type: script` entry in `functions.yaml`, exposed automatically |
|
|
1265
1294
|
|
|
@@ -1132,6 +1132,33 @@ confirmation.
|
|
|
1132
1132
|
|
|
1133
1133
|
---
|
|
1134
1134
|
|
|
1135
|
+
## MCP server (`devstuff mcp`)
|
|
1136
|
+
|
|
1137
|
+
`devstuff mcp` serves devstuff's tools to an MCP client over **stdio**. It is started *by* the client, not by
|
|
1138
|
+
hand. Register it with Claude Code:
|
|
1139
|
+
|
|
1140
|
+
```bash
|
|
1141
|
+
claude mcp add devstuff -- devstuff mcp # read-only tools only
|
|
1142
|
+
claude mcp add devstuff -- devstuff mcp --allow-install # also install_tool
|
|
1143
|
+
```
|
|
1144
|
+
|
|
1145
|
+
| Flag | Effect |
|
|
1146
|
+
|---|---|
|
|
1147
|
+
| *(none)* | `list_tools`, `search_catalog`, `tool_info`, `outdated`, `profile_diff` — nothing that changes the machine |
|
|
1148
|
+
| `--allow-install` | adds `install_tool`, which installs a catalog tool as you |
|
|
1149
|
+
| `--allow-functions` | adds every `type: script` function as `fn_<key>` |
|
|
1150
|
+
| `--list-tools` | print what these flags would expose, and which gate each tool sits behind; starts nothing |
|
|
1151
|
+
|
|
1152
|
+
A tool whose flag is off is not hidden but **absent and refused**: a call naming it is answered as an unknown tool.
|
|
1153
|
+
Workspace tools (`read_file`, `run_command`, …) never exist here — the client already has files and a shell.
|
|
1154
|
+
|
|
1155
|
+
The server has **no terminal**: an installer that needs a `sudo` password fails at once with a message telling the
|
|
1156
|
+
client to run `devstuff install <key>` in a terminal, rather than waiting for a password nobody can type.
|
|
1157
|
+
Logs (`-v`, `-vv`) go to stderr. HTTP and OpenAPI front ends are still to come; see
|
|
1158
|
+
[`docs/specs/mcp/`](docs/specs/mcp/).
|
|
1159
|
+
|
|
1160
|
+
---
|
|
1161
|
+
|
|
1135
1162
|
## Agent
|
|
1136
1163
|
|
|
1137
1164
|
`devstuff agent` opens an interactive session with a **local** model (via [Ollama](https://ollama.com))
|
|
@@ -1233,6 +1260,8 @@ deny_patterns: [] # extra regexes refused on top of the built-in
|
|
|
1233
1260
|
| `list_tools` | | List the devstuff catalog with install state |
|
|
1234
1261
|
| `search_catalog` | | Find a catalog tool by name or description |
|
|
1235
1262
|
| `tool_info` | | Details for one catalog tool |
|
|
1263
|
+
| `outdated` | | Which installed tools have a newer version (the rows `devstuff outdated --json` prints) |
|
|
1264
|
+
| `profile_diff` | | Compare this machine to a bundled profile such as `@devops` (the rows `profile diff --json` prints) |
|
|
1236
1265
|
| `install_tool` | ! | Install a catalog tool (handles sudo itself) |
|
|
1237
1266
|
| `fn_<key>` | ! | Every `type: script` entry in `functions.yaml`, exposed automatically |
|
|
1238
1267
|
|
|
@@ -22,6 +22,7 @@ M5 is independent polish that can be slotted in anywhere.
|
|
|
22
22
|
| M3 | `devstuff profile apply` + bundled bundles | Medium–high | M2 | `profile-apply/` |
|
|
23
23
|
| M4 | Agent tools for `doctor` / `outdated` | Low | M1 | `agent/` (amend) |
|
|
24
24
|
| M5 | Shell completion | Low | — | `completion/` |
|
|
25
|
+
| M6 | `devstuff mcp`: MCP (stdio + HTTP) and OpenAPI tool server | Medium | M1; builds `outdated` / `profile_diff` agent tools (overlaps M4) | `mcp/` (approved) |
|
|
25
26
|
| — | git / tmux configurator | Medium | — | `git-config/` (unscheduled) |
|
|
26
27
|
| — | `devstuff sandbox <tool>` | Medium | — | `sandbox/` (unscheduled) |
|
|
27
28
|
|
|
@@ -141,7 +142,9 @@ checks. Per `CLAUDE.md` this is mostly a YAML edit (`impl: catalog` / `impl: pri
|
|
|
141
142
|
`agent_tools.yaml`); `agent_tools.schema.json` must be updated in the same change if any field is
|
|
142
143
|
added.
|
|
143
144
|
|
|
144
|
-
- `outdated` is read-only and safe to expose unconditionally.
|
|
145
|
+
- `outdated` is read-only and safe to expose unconditionally. **Done 2026-10-12** (built under M6's M-1, along
|
|
146
|
+
with `profile_diff`): `agent_tools.yaml` gains `outdated` and `profile_diff`, and the catalog an `array`
|
|
147
|
+
parameter type. `doctor` is still open.
|
|
145
148
|
- `doctor --fix` mutates the machine, so the agent gets the **check-only** form. A model
|
|
146
149
|
deciding to apply fixes is a separate question for the spec, not a default.
|
|
147
150
|
|
|
@@ -156,6 +159,20 @@ added.
|
|
|
156
159
|
install-state lookups.
|
|
157
160
|
- Document the one-line install in README.md alongside the existing shell-integration notes.
|
|
158
161
|
|
|
162
|
+
## M6 — `devstuff mcp`
|
|
163
|
+
|
|
164
|
+
Serve devstuff's catalog-aware tools to any MCP or OpenAPI client, so an AI client asks devstuff to install
|
|
165
|
+
or inspect a tool instead of guessing at `apt` and `npm` itself.
|
|
166
|
+
|
|
167
|
+
**Spec:** [`specs/mcp/`](specs/mcp/) — **approved**, 2026-10-11 (findings measured; two goals: Claude compatibility, OpenAPI coverage).
|
|
168
|
+
**Progress:** M-1 (bridges, classification) and M-2 (the stdio server, `devstuff mcp`) built 2026-10-12; M-3 (HTTP, REST, OpenAPI) and M-4 (conformance, `--print-config`, docs) remain.
|
|
169
|
+
|
|
170
|
+
- Three framings, one dispatcher: MCP over stdio, MCP over HTTP, and OpenAPI/REST (`/openapi.json`, `/tools`).
|
|
171
|
+
- Read-only tools by default (`list_tools`, `search_catalog`, `tool_info`, `outdated`, `profile_diff`);
|
|
172
|
+
`install_tool` exists only under `--allow-install` and the `script` functions only under `--allow-functions`, enforced at dispatch.
|
|
173
|
+
- No new runtime dependency: stdlib transport, the official SDK only as a test-time client.
|
|
174
|
+
- Shares M4's `outdated` agent tool; `doctor` stays in M4.
|
|
175
|
+
|
|
159
176
|
---
|
|
160
177
|
|
|
161
178
|
## Unscheduled candidates
|
|
@@ -51,3 +51,4 @@ They are most useful when they capture:
|
|
|
51
51
|
| [`profile/`](profile/) — `devstuff profile snapshot` / `diff`, a portable description of a machine's tools | Complete (v1: snapshot, diff; apply is its own spec) |
|
|
52
52
|
| [`plan-and-progress/`](plan-and-progress/) — plan preview, live progress view and the guided `add` wizard for `install`/`remove`/`update`/`add` | Implemented (documented after the fact; no `stack-decisions.md`) |
|
|
53
53
|
| [`profile-apply/`](profile-apply/) — `devstuff profile apply`, make a machine match a profile | Complete (v1: apply, six bundles; container test written, first run pending) |
|
|
54
|
+
| [`mcp/`](mcp/) — `devstuff mcp`, devstuff's tools as an MCP (stdio + HTTP) and OpenAPI tool server | Approved 2026-10-11 (spec only; findings measured) |
|
|
@@ -92,7 +92,7 @@ mutating step. It stays local: no API keys, no network egress of source code, us
|
|
|
92
92
|
- **`AgentTool`** — `key`, `name`, `description`, `impl` (`primitive`|`catalog`|`function`),
|
|
93
93
|
`mutating: bool`, `params: [AgentParam]`, `target` (for `catalog`/`function` bridges).
|
|
94
94
|
Serialises to an Ollama `tools[]` JSON-Schema entry via `to_schema()`.
|
|
95
|
-
- **`AgentParam`** — `name`, `type` (`string`|`integer`|`boolean`), `description`, `required`,
|
|
95
|
+
- **`AgentParam`** — `name`, `type` (`string`|`integer`|`boolean`; `number` and `array` since 2026-10-12 — an array is always of strings, see `mcp/` F-12), `description`, `required`,
|
|
96
96
|
`default`, `enum`.
|
|
97
97
|
- **`Workspace`** — `root: Path` (immutable), `cwd: Path` (mutable, always under `root`);
|
|
98
98
|
owns `resolve(path) -> Path` which raises `SandboxError` on escape.
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
# Development plan: `devstuff mcp`
|
|
2
|
+
|
|
3
|
+
**Date:** 2026-10-11
|
|
4
|
+
**Spec:** [specifications.md](specifications.md) · **Decisions:** [stack-decisions.md](stack-decisions.md)
|
|
5
|
+
|
|
6
|
+
## Order of work
|
|
7
|
+
|
|
8
|
+
Spec → measurement → tests → code → mutation check → live check → docs, one commit per milestone, one PR
|
|
9
|
+
targeting `master` from a branch cut **after** this spec merges (never stacked on the spec branch — see
|
|
10
|
+
`AGENTS.md`).
|
|
11
|
+
|
|
12
|
+
| M | Delivers | Needs |
|
|
13
|
+
|---|---|---|
|
|
14
|
+
| **M-1** ✅ 2026-10-12 | Measure what remains of F-6/F-11: does sudo's line survive `_run`'s capture (FR-13)? Then `agent/bridges.py` + `agent_tools.yaml`: `outdated` and `profile_diff`; FR-4 test; the FR-1a classification table and its forcing test | — |
|
|
15
|
+
| **M-2** ✅ 2026-10-12 | `src/dev_setup/mcp/`: `core.py` (classification, dispatch, gating, probe lifecycle FR-8a, JSON-RPC handling — pure), `stdio.py` (FR-11/11a/12/19, incl. the detach + supervisor), `commands/mcp_cmd.py` (stdio only) | M-1 |
|
|
16
|
+
| **M-3** | `mcp/http.py`: `POST /mcp`, token/Host/Origin (FR-20, 24–28); then REST + OpenAPI (FR-21–23) | M-2 |
|
|
17
|
+
| **M-4** | **G-1:** conformance tests (real SDK client; real `claude mcp list`); `--print-config` (FR-31). **G-2:** OpenAPI validity, both-direction coverage and the document-driven client (FR-22a–c). One live `tools/call` through Claude Code, with consent. README, CLAUDE.md section, specs index, roadmap | M-3 |
|
|
18
|
+
|
|
19
|
+
## Layout
|
|
20
|
+
|
|
21
|
+
```
|
|
22
|
+
src/dev_setup/mcp/
|
|
23
|
+
├── __init__.py
|
|
24
|
+
├── core.py # pure: Toolbox (derive + classify + gate), dispatch(), handle_jsonrpc(), probe lifecycle. No I/O, no sockets
|
|
25
|
+
├── process.py # FR-11a: setsid / fork-supervisor / /dev/tty verify (injectable so the refusal path is testable)
|
|
26
|
+
├── stdio.py # the fd move (FR-11) and the line loop
|
|
27
|
+
├── http.py # ThreadingHTTPServer: auth, Host/Origin, /mcp, /tools, /openapi.json
|
|
28
|
+
├── token.py # persistent 0600 token file, mode check, --rotate-token
|
|
29
|
+
├── printconfig.py # FR-31 snippets
|
|
30
|
+
└── openapi.py # pure: tools -> OpenAPI 3.1 document (same toolbox object as tools/list)
|
|
31
|
+
src/dev_setup/commands/mcp_cmd.py
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
`core.py` is pure for the reason `profile.py` and `apply_plan.py` are: the whole decision table — gating,
|
|
35
|
+
binding, errors, version negotiation — is tested with hand-built frames and no sockets or processes.
|
|
36
|
+
|
|
37
|
+
## Testing strategy
|
|
38
|
+
|
|
39
|
+
**Unit (`tests/test_mcp_*.py`, default run):**
|
|
40
|
+
- `core`: one test per FR-3/5/6/15–18 outcome, driven with hand-built JSON-RPC dicts. The gating test
|
|
41
|
+
asserts a gated tool is absent from `tools/list` **and** refused by `tools/call` **and** `POST /tools/x`
|
|
42
|
+
— three assertions, because FR-3 says dispatch, and a list-only check passes when dispatch is open.
|
|
43
|
+
- `outdated`/`profile_diff` bridges return the same array as the commands' `--json` for a faked machine;
|
|
44
|
+
an `unknown` row stays `unknown` (the honesty rule, with a test that breaks the renderer to prove it can
|
|
45
|
+
fail, as `outdated` did).
|
|
46
|
+
- `http`: a real `ThreadingHTTPServer` on port `0` in-process, exercised with `urllib`. Token, `Host`,
|
|
47
|
+
`Origin` ordering (403 before 401), 405/413, no CORS headers.
|
|
48
|
+
- **Tests must be able to reach the guard they claim to test.** The stdout-purity test needs a fake
|
|
49
|
+
installer that writes through *every* route in F-1 — `print`, `sys.stdout`, `os.write(1)`, a child
|
|
50
|
+
`echo`, a child `cat` — run in a subprocess whose stdout the test reads, or it passes whatever the code
|
|
51
|
+
does. A second case runs the same installer *without* the fd move and asserts it does corrupt the
|
|
52
|
+
stream, so the test is shown to be able to fail.
|
|
53
|
+
|
|
54
|
+
**Dev dependencies added:** `mcp` and `openapi-spec-validator` in the `dev` group only (never runtime).
|
|
55
|
+
|
|
56
|
+
**Claude Code conformance (`tests/integration/test_mcp_claude.py`, skipped when `claude` is not on `PATH`):**
|
|
57
|
+
the F-8 method, run against `devstuff mcp` — isolated `HOME`, `claude mcp add` for stdio and for HTTP with the
|
|
58
|
+
bearer header, `claude mcp list`, assert `✔ Connected` for both. No model turn, no credentials.
|
|
59
|
+
|
|
60
|
+
**OpenAPI (`tests/test_mcp_openapi.py`):** FR-22a validator run (plus a broken copy it must reject), FR-22b set
|
|
61
|
+
equality across `tools/list` / `GET /tools` / the document for all four flag combinations, and FR-22c's
|
|
62
|
+
document-driven client. Mutation targets: drop a tool from the document, rename an `operationId`, document a
|
|
63
|
+
status the server never sends, send one it never documents.
|
|
64
|
+
|
|
65
|
+
**SDK conformance (`tests/integration/test_mcp_conformance.py`, skipped when `mcp` is not importable):** the
|
|
66
|
+
real SDK client — `mcp` in the **dev** dependency group — against `devstuff mcp` over stdio and over HTTP:
|
|
67
|
+
`initialize`, `tools/list`, `tools/call` of a read-only tool, and a gated tool absent without the flag and
|
|
68
|
+
present with it. This is the test that would have caught F-2.
|
|
69
|
+
|
|
70
|
+
**Review-driven tests (spec §5a), each with the mutation that must break it:**
|
|
71
|
+
- *Classification (FR-1a):* the exact F-10a user file under all four flag combinations; a forcing test over
|
|
72
|
+
`agent.bridges._BRIDGES`. Mutation: gate on `tool.mutating` instead — the override test must fail.
|
|
73
|
+
- *Probe freshness (FR-8a):* a fake machine changed between calls; an install that fails after changing state;
|
|
74
|
+
a slow fake probe overlapping a mutation (the retry, and the note when it cannot retry). Mutation: drop the
|
|
75
|
+
`finally` clear, drop the 0→1 clear, drop the retry — one named test each.
|
|
76
|
+
- *No terminal (FR-11a):* a pty harness (it must answer `ESC[6n`, per `CLAUDE.md`) running the server with each
|
|
77
|
+
gate flag; `/dev/tty` unreachable in the server and a child; real `sudo -k true` fails fast. Detach is
|
|
78
|
+
injectable, so a forced failure shows the exit-1 refusal with a gate flag and the warn-and-serve path
|
|
79
|
+
without one. Mutation: drop the verify, and drop the supervisor's signal forwarding.
|
|
80
|
+
- *OpenAPI (FR-22b/c, FR-23):* every body row; `openai_tool_list` reserved; per-operation response schemas.
|
|
81
|
+
Mutation: validate every `200` against `ToolResult`, treat an absent body as an error — each must fail.
|
|
82
|
+
|
|
83
|
+
**Mutation check:** the restore-in-`finally` harness used for `apply` and the progress view — break each
|
|
84
|
+
FR's code (remove the gate from dispatch, make `-32601` return `{}`, drop the `dup2`, compare the token
|
|
85
|
+
with `==` order-swapped, skip the `Origin` check), confirm a named test fails, and verify the working tree
|
|
86
|
+
restores byte-for-byte. Survivors become tests or deleted code.
|
|
87
|
+
|
|
88
|
+
**Live check (isolated `HOME`):** `claude mcp add` against the real binary if a client is available on the
|
|
89
|
+
machine; otherwise the SDK client script, stated honestly as the substitute. A real `install_tool` of a
|
|
90
|
+
cheap user-space tool (`uv tool` or `nvm`-free) under `--allow-install` (and a read-only `fn_*` under `--allow-functions` alone), and a sudo-needing one to confirm
|
|
91
|
+
FR-13's message. Anything not run live is listed as not run.
|
|
92
|
+
|
|
93
|
+
## Risks
|
|
94
|
+
|
|
95
|
+
| Risk | Mitigation |
|
|
96
|
+
|---|---|
|
|
97
|
+
| Protocol drift: clients move to `2026-07-28` and beyond | Conformance test against the current SDK; FR-16 means a newer client falls back rather than failing; revisit when the fallback stops being offered |
|
|
98
|
+
| The detach (FR-11a) changes process identity: Ctrl-C no longer reaches the server, and the fork path leaves a supervisor | The supervisor forwards `SIGINT`/`SIGTERM` and mirrors the exit status; tested under a pty. Built and measured in M-2 under a pty (F-14); a closing terminal's `SIGHUP` is forwarded as `SIGTERM` so it cannot orphan the server |
|
|
99
|
+
| `dup2` is process-wide and POSIX-only | `devstuff` targets Linux (README); the module refuses to start on a platform without `os.dup2`, with a message, rather than starting unprotected |
|
|
100
|
+
| Claude changes its handshake again (it already moved from `initialize` to `server/discover`-first) | The `claude mcp list` test runs against whatever `claude` is installed, so a release that stops connecting fails the suite on the next run; FR-16 means an unknown method degrades rather than errors |
|
|
101
|
+
| Claude Desktop can't be run here | The `claude-desktop` snippet is checked for shape only and the report says so; stdio is the transport it uses, and that path is covered by the Claude Code and SDK tests |
|
|
102
|
+
| A tool prints to the *original* stdout via a saved file object | The private fd is only reachable from `stdio.py`; a test greps that nothing else holds it |
|
|
103
|
+
| HTTP exposes `install_tool` to the network | Loopback default, token, `Host`/`Origin`, the flag, and the one-line banner (FR-25/27); no claim beyond that |
|
|
104
|
+
| `list_tools` probes every tool (seconds on a cold machine) and a client times out | Measure at M-2; if slow, share probes only within a burst of concurrent requests and clear them per FR-8a — never keep them across idle time or a mutation (a stale "installed" answer is worse than a slow one) |
|
|
105
|
+
| The conformance dev dependency fails to resolve on some CI Python | OQ-5; the test skips rather than breaks the suite |
|
|
106
|
+
|
|
107
|
+
## Out of scope for this plan
|
|
108
|
+
|
|
109
|
+
`profile apply`, `update` and `remove` as tools (OQ-4); resources/prompts; a per-tool allow-list (OQ-6);
|
|
110
|
+
the `doctor` agent tool (M4's other half).
|