devstuff 2.24.0__tar.gz → 2.25.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.24.0 → devstuff-2.25.0}/AGENTS.md +4 -3
- {devstuff-2.24.0 → devstuff-2.25.0}/CHANGELOG.md +6 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/CLAUDE.md +17 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/PKG-INFO +3 -1
- {devstuff-2.24.0 → devstuff-2.25.0}/README.md +2 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/README.md +1 -0
- devstuff-2.25.0/docs/specs/managed-by/development-plan.md +68 -0
- devstuff-2.25.0/docs/specs/managed-by/specifications.md +105 -0
- devstuff-2.25.0/docs/specs/managed-by/stack-decisions.md +53 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/pyproject.toml +1 -1
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/catalog.py +8 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/install_cmd.py +20 -9
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/list_cmd.py +11 -7
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/generic.py +3 -0
- devstuff-2.25.0/src/dev_setup/managers.py +281 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/tools.yaml +7 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_catalog.py +58 -0
- devstuff-2.25.0/tests/test_managers.py +535 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/uv.lock +1 -1
- {devstuff-2.24.0 → devstuff-2.25.0}/.claude/skills/run-stuff/SKILL.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/.claude/skills/run-stuff/smoke.sh +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/.github/codex/review.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/.github/workflows/agent.yml +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/.github/workflows/bump.yml +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/.github/workflows/ci.yml +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/.github/workflows/publish.yml +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/.github/workflows/test-installs.yml +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/.gitignore +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/dev/Dockerfile +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/dev/Dockerfile.ci +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/dev/Makefile +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/dev/docker-compose.yml +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/devstuff +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/ROADMAP.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/github-agent.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/agent/development-plan.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/agent/specifications.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/agent/stack-decisions.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/ansible-config/development-plan.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/ansible-config/specifications.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/ansible-config/stack-decisions.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/bat-config/development-plan.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/bat-config/specifications.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/bat-config/stack-decisions.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/commitizen-config/development-plan.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/commitizen-config/specifications.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/commitizen-config/stack-decisions.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/docker-config/development-plan.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/docker-config/specifications.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/docker-config/stack-decisions.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/fmhy-picks/development-plan.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/fmhy-picks/specifications.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/fmhy-picks/stack-decisions.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/lazygit-config/development-plan.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/lazygit-config/specifications.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/lazygit-config/stack-decisions.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/mcp/development-plan.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/mcp/specifications.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/mcp/stack-decisions.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/outdated/development-plan.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/outdated/specifications.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/outdated/stack-decisions.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/plan-and-progress/specifications.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/precommit-config/development-plan.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/precommit-config/specifications.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/precommit-config/stack-decisions.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/profile/development-plan.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/profile/specifications.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/profile/stack-decisions.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/profile-apply/development-plan.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/profile-apply/specifications.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/profile-apply/stack-decisions.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/starship-config/development-plan.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/starship-config/specifications.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/starship-config/stack-decisions.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/syncthing-config/development-plan.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/syncthing-config/specifications.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/syncthing-config/stack-decisions.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/uv-backbone/development-plan.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/uv-backbone/specifications.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/uv-backbone/stack-decisions.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/verbose-mode/development-plan.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/verbose-mode/specifications.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/verbose-mode/stack-decisions.md +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/install.sh +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/__init__.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/__main__.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/__init__.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/approval.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/bridges.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/catalog.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/completion.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/config.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/loop.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/ollama.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/preflight.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/primitives.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/registry.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/sandbox.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/session.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/transcript.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/wizard.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent_tools.schema.json +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent_tools.yaml +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/apply_exec.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/apply_plan.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/base.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/bundles/ai-agents.yaml +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/bundles/ai-local.yaml +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/bundles/devops.yaml +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/bundles/essentials.yaml +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/bundles/languages.yaml +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/bundles/python.yaml +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/bundles.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/cli.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/__init__.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/_plan.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/add_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/agent_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/catalog_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/configure_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/delete_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/docs_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/doctor_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/functions_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/help_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/links_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/mcp_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/outdated_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/profile_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/remove_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/run_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/skills_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/update_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/__init__.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/ansible/__init__.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/ansible/detect.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/ansible/model.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/ansible/render.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/ansible/validate.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/ansible/wizard.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/bat/__init__.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/bat/detect.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/bat/model.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/bat/preview.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/bat/render.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/bat/wizard.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/commitizen/__init__.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/commitizen/detect.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/commitizen/model.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/commitizen/render.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/commitizen/validate.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/commitizen/wizard.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/docker/__init__.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/docker/detect.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/docker/model.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/docker/render.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/docker/validate.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/docker/wizard.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/lazygit/__init__.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/lazygit/detect.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/lazygit/model.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/lazygit/render.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/lazygit/validate.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/lazygit/wizard.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/precommit/__init__.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/precommit/detect.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/precommit/model.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/precommit/render.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/precommit/validate.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/precommit/wizard.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/reptyr/__init__.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/reptyr/wizard.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/__init__.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/fonts.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/icons.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/model.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/preview.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/render.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/wizard.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/syncthing/__init__.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/syncthing/api.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/syncthing/detect.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/syncthing/model.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/syncthing/wizard.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/doctor.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/function_runner.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/functions.schema.json +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/functions.yaml +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/functions_catalog.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/functions_registry.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/links.schema.json +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/links.yaml +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/links_catalog.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/links_registry.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/mcp/__init__.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/mcp/core.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/mcp/http.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/mcp/openapi.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/mcp/printconfig.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/mcp/process.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/mcp/stdio.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/mcp/token.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/profile.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/registry.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/snapshot.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/ui.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/updates.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/verbose.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/__init__.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/integration/__init__.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/integration/conftest.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/integration/test_agent_smoke.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/integration/test_agent_tui.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/integration/test_commitizen_config.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/integration/test_mcp_claude.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/integration/test_mcp_conformance.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/integration/test_profile_apply.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/integration/test_tools.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/mcp_http_support.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/mcp_process_support.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_agent.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_agent_bridges.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_agent_completion.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_agent_loop.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_agent_sandbox.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_agent_tools.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_agent_wizard.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_apply_exec.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_apply_plan.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_apply_run.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_bundles.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_catalog_scripts.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_configure_ansible.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_configure_bat.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_configure_commitizen.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_configure_docker.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_configure_lazygit.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_configure_precommit.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_configure_reptyr.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_configure_starship.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_configure_syncthing.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_doctor.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_functions.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_generic.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_installed_version.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_lifecycle_cmds.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_links.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_mcp_classify.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_mcp_core.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_mcp_http.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_mcp_http_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_mcp_openapi.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_mcp_printconfig.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_mcp_process.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_mcp_stdio.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_mcp_token.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_outdated_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_pin_support.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_plan_and_select.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_profile.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_profile_apply_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_profile_diff.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_profile_diff_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_profile_snapshot_cmd.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_registry.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_snapshot.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_ui.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_update_checker_parity.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_update_notes.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_updates.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_uv_probes.py +0 -0
- {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_verbose.py +0 -0
|
@@ -66,9 +66,9 @@ 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
|
-
| PR | Branch
|
|
70
|
-
|
|
71
|
-
| [#
|
|
69
|
+
| PR | Branch → base | What |
|
|
70
|
+
|---|---|---|
|
|
71
|
+
| [#78](https://github.com/thesawdawg/dev-setup-py/pull/78) | `feat/managed-by` → `master` | Manager notes (uv/nvm, system copies) in `list` and the `install` picker; `managed_by` catalog field |
|
|
72
72
|
|
|
73
73
|
### Closed as dropped
|
|
74
74
|
|
|
@@ -91,3 +91,4 @@ commits rather than merging `master` in.
|
|
|
91
91
|
| [#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`. |
|
|
92
92
|
| [#75](https://github.com/thesawdawg/dev-setup-py/pull/75) `syncthing` tool and `configure syncthing` pairing wizard (merged 2026-10-12, released as 2.22.0) | (1) The first real `devstuff install syncthing`: the weekly `test-installs.yml` canary is its first run, where the no-user-session branch is the expected path. (2) The interactive wizard against a live user service, and `sudo loginctl enable-linger` itself. Both are unit-tested only, with a fake API client; the real-binary tests drive two throwaway daemons, not the wizard. When either happens, update "What was run and what was not" in `docs/specs/syncthing-config/development-plan.md` and the status row in `docs/specs/README.md`. |
|
|
93
93
|
| [#76](https://github.com/thesawdawg/dev-setup-py/pull/76) `tmux`, `gum`, `bubblewrap` (+ `socat`) tools; Druid, Homepage, Server Box and tmux wiki links (merged 2026-10-13, released as 2.23.0) | The first real install of `tmux`, `gum` and `bubblewrap`: the dev host has no Docker, so the weekly `test-installs.yml` canary is their first run. The bubblewrap remove refusal and both-binaries check are tested with fake `apt-get`/`sudo` only. |
|
|
94
|
+
| [#77](https://github.com/thesawdawg/dev-setup-py/pull/77) `delta`, `ripgrep`, `shellcheck`, `fzf`, `opencode` tools; lazygit wizard's delta install offer; five FMHY links (merged 2026-10-13, released as 2.24.0) | (1) The first real install of all five: the weekly `test-installs.yml` canary is their first run. For fzf it confirms the binary and the `~/.bashrc` marker, not that the key bindings load (the CI image's fzf 0.44 has no `--bash`, and the minimized image likely lacks the fallback file). (2) The lazygit wizard's delta offer under a pty; tested with stubbed prompts only. When either happens, update "What was run and what was not" in `docs/specs/fmhy-picks/development-plan.md` and the status row in `docs/specs/README.md`. (3) Known, unfixed: an `apt` entry silently ignores `install_script` and `validate_catalog` accepts it (`docs/specs/fmhy-picks/stack-decisions.md`, D-3). |
|
|
@@ -64,6 +64,7 @@ src/dev_setup/
|
|
|
64
64
|
├── links.yaml # Bundled link catalog (+ links_catalog.py / links_registry.py / links.schema.json)
|
|
65
65
|
├── ui.py # Rich console + questionary wrappers (spinners, prompts, styled output)
|
|
66
66
|
├── verbose.py # Process-wide -v/-vv level + the stderr logger built on it
|
|
67
|
+
├── managers.py # Who manages a tool's installs (uv/nvm) — the notes `list` and the `install` picker show
|
|
67
68
|
├── updates.py # Update probing + the five-state classifier, shared by `update` and `outdated`
|
|
68
69
|
├── profile.py # Profile file format (strict load, deterministic dump) + the seven-state diff classifier — pure
|
|
69
70
|
├── snapshot.py # Asks the machine: builds a Profile / the facts `profile.compare` needs
|
|
@@ -160,6 +161,22 @@ and `devstuff outdated` share one collector and one classifier. Things that are
|
|
|
160
161
|
- **Exit status is "did the lookup run", not the answer** (the same rule as `run_cmd`), and `--json`
|
|
161
162
|
writes only the array to stdout, even at `-vv`.
|
|
162
163
|
|
|
164
|
+
**Manager notes** (`managers.py`, spec in `docs/specs/managed-by/`): `list` and the `install` picker
|
|
165
|
+
annotate a tool with the catalog manager that owns its installs — derived from the install type
|
|
166
|
+
(`uvx`/`pip` → uv, `npm` → nvm) or explicit via `managed_by` (python, pi). Things that are load-bearing:
|
|
167
|
+
- **Two signals, both measured on the machine.** The *type signal* reuses `outdated`'s probes —
|
|
168
|
+
`uv tool list` membership for uvx/pip, `npm ls -g` inside a sourced nvm for npm — so `list` and
|
|
169
|
+
`outdated` never disagree. The *path signal* is for explicit `managed_by` on other types: resolve
|
|
170
|
+
the tool's `version_cmd`/`check_cmd` binary and test `Path.is_relative_to` against the manager's
|
|
171
|
+
own reported roots (`uv tool dir`, `uv python dir`, `$NVM_DIR`). Never `str.startswith` —
|
|
172
|
+
`uv/python-other` shares a textual prefix with `uv/python` and is not inside it.
|
|
173
|
+
- **`outside` has no install remedy on purpose.** `install_cmd` returns early on `is_installed()`,
|
|
174
|
+
so "run devstuff install" advice on an installed-outside-uv row would be false. `system-copy` can
|
|
175
|
+
carry the remedy because the tool reads *not* installed — there, install actually runs.
|
|
176
|
+
- **`unknown` is not `managed`.** A probe that cannot answer (failed `uv tool list`, unparseable
|
|
177
|
+
npm JSON, missing manager) renders "couldn't confirm", and a `managed_by` typo or absent key
|
|
178
|
+
yields no note at all rather than a wrong one.
|
|
179
|
+
|
|
163
180
|
**Profiles** (`profile.py`, `snapshot.py`, `commands/profile_cmd.py`; spec in `docs/specs/profile/`):
|
|
164
181
|
`devstuff profile snapshot` / `diff` describe and compare a machine; `apply` (below) changes one. Things that are
|
|
165
182
|
load-bearing:
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: devstuff
|
|
3
|
-
Version: 2.
|
|
3
|
+
Version: 2.25.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>
|
|
@@ -238,6 +238,7 @@ devstuff list --available # only packages not yet installed
|
|
|
238
238
|
```
|
|
239
239
|
|
|
240
240
|
Output columns: status (✔/✘), package key, description, install type, version (if installed), help command.
|
|
241
|
+
Tools another catalog tool manages or could manage get a second line — `✓ managed by uv`, `installed outside nvm`, `uv can manage this`, or a warning that a system copy (e.g. `/usr/bin/python3`) exists outside the manager — probed against the machine, not inferred from the catalog.
|
|
241
242
|
|
|
242
243
|
---
|
|
243
244
|
|
|
@@ -1729,6 +1730,7 @@ tools:
|
|
|
1729
1730
|
| `help_cmd` | no | Command shown in `list` under the package entry |
|
|
1730
1731
|
| `docs_url` | no | URL opened by `devstuff docs <key>` |
|
|
1731
1732
|
| `requires` | no | List of package keys that must already be installed |
|
|
1733
|
+
| `managed_by` | no | Catalog key of the tool that manages this one's installs (e.g. `uv`, `nvm`). Implied for `npm` → `nvm` and `pip`/`uvx` → `uv`; set it only when the type doesn't imply one |
|
|
1732
1734
|
| `npm_name` | npm | npm package name |
|
|
1733
1735
|
| `pip_name` | pip | PyPI package name. Extras work as-is: `pip_name: "ansible-lint[lock]"` |
|
|
1734
1736
|
| `uv_with` | no (pip/uvx) | Extra packages installed into the tool's environment (`uv tool install --with`) |
|
|
@@ -211,6 +211,7 @@ devstuff list --available # only packages not yet installed
|
|
|
211
211
|
```
|
|
212
212
|
|
|
213
213
|
Output columns: status (✔/✘), package key, description, install type, version (if installed), help command.
|
|
214
|
+
Tools another catalog tool manages or could manage get a second line — `✓ managed by uv`, `installed outside nvm`, `uv can manage this`, or a warning that a system copy (e.g. `/usr/bin/python3`) exists outside the manager — probed against the machine, not inferred from the catalog.
|
|
214
215
|
|
|
215
216
|
---
|
|
216
217
|
|
|
@@ -1702,6 +1703,7 @@ tools:
|
|
|
1702
1703
|
| `help_cmd` | no | Command shown in `list` under the package entry |
|
|
1703
1704
|
| `docs_url` | no | URL opened by `devstuff docs <key>` |
|
|
1704
1705
|
| `requires` | no | List of package keys that must already be installed |
|
|
1706
|
+
| `managed_by` | no | Catalog key of the tool that manages this one's installs (e.g. `uv`, `nvm`). Implied for `npm` → `nvm` and `pip`/`uvx` → `uv`; set it only when the type doesn't imply one |
|
|
1705
1707
|
| `npm_name` | npm | npm package name |
|
|
1706
1708
|
| `pip_name` | pip | PyPI package name. Extras work as-is: `pip_name: "ansible-lint[lock]"` |
|
|
1707
1709
|
| `uv_with` | no (pip/uvx) | Extra packages installed into the tool's environment (`uv tool install --with`) |
|
|
@@ -48,6 +48,7 @@ They are most useful when they capture:
|
|
|
48
48
|
| [`lazygit-config/`](lazygit-config/) — `devstuff configure lazygit`, the icons/pager/panels wizard | Complete (v1) |
|
|
49
49
|
| [`syncthing-config/`](syncthing-config/) — the `syncthing` tool plus `devstuff configure syncthing`, device pairing over the local API | Complete (v1; first real install and live wizard run pending) |
|
|
50
50
|
| [`fmhy-picks/`](fmhy-picks/) — five tools (delta, ripgrep, ShellCheck, fzf, OpenCode) and five links chosen from the FMHY wiki, plus the lazygit wizard's delta install offer | Implemented 2026-10-13 (first real installs pending: the CI canary is their first run) |
|
|
51
|
+
| [`managed-by/`](managed-by/) — manager notes in `list` and the `install` picker (`managed_by` field + uv/nvm probes + system-copy flags) | Implemented 2026-10-13 |
|
|
51
52
|
| [`verbose-mode/`](verbose-mode/) — `-v`/`-vv`, the process-wide verbosity level | Complete (v1) |
|
|
52
53
|
| [`outdated/`](outdated/) — `devstuff outdated`, the read-only installed-vs-latest report | Complete (v1) |
|
|
53
54
|
| [`profile/`](profile/) — `devstuff profile snapshot` / `diff`, a portable description of a machine's tools | Complete (v1: snapshot, diff; apply is its own spec) |
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
# Managed-by notes — development plan
|
|
2
|
+
|
|
3
|
+
## Milestones
|
|
4
|
+
|
|
5
|
+
- **M-1 — data model.** `managed_by` catalog field + validation; `GenericTool`
|
|
6
|
+
field; `tools.yaml` entries for python and pi. Covered by `tests/test_catalog.py`
|
|
7
|
+
additions (accepted/rejected values, round-trip, bundled keys resolve).
|
|
8
|
+
- **M-2 — `managers.py`.** `ManagerNote`, `manager_of`, `note_for`, the type
|
|
9
|
+
signal (shared `uv tool list` probe, new `_nvm_npm_globals` `_once` probe), the
|
|
10
|
+
path signal (`_uv_roots`/`_nvm_roots` + `is_relative_to`), `list_line` and
|
|
11
|
+
`picker_hint`. Covered by `tests/test_managers.py` — every state, both signals,
|
|
12
|
+
probe failure, Rich escaping, never-raises.
|
|
13
|
+
- **M-3 — surfaces.** The note rides the existing worker pools in `list_cmd._probe`
|
|
14
|
+
and `_install_interactive`; list appends the line after help/requires; the picker
|
|
15
|
+
applies the suffix/disabled override. Covered by CliRunner list tests and a
|
|
16
|
+
captured-picker-choices test.
|
|
17
|
+
- **M-4 — live check.** Real `devstuff list` / `list --installed` on the author's
|
|
18
|
+
machine; a PTY-driven picker capture; timing before/after.
|
|
19
|
+
|
|
20
|
+
## Testing strategy
|
|
21
|
+
|
|
22
|
+
Probes are monkeypatched (`generic._uv_tool_versions`, `managers._nvm_npm_globals`,
|
|
23
|
+
`managers._ROOT_PROBES`, `shutil.which`, `generic._probe`) so each test reaches the
|
|
24
|
+
verdict it names; `generic.forget_probes()` isolates the `_once` memos. The
|
|
25
|
+
sibling-directory case asserts the naïve `startswith` *would* have matched while the
|
|
26
|
+
verdict is `outside`. The escaping test renders through a real `Console`, not a
|
|
27
|
+
string comparison. The nvm JSON probe is tested for both nonzero-rc-with-valid-JSON
|
|
28
|
+
and unparseable output.
|
|
29
|
+
|
|
30
|
+
## Risks
|
|
31
|
+
|
|
32
|
+
- A `managed_by` key with no root probe (any catalog key is valid) → `unknown`,
|
|
33
|
+
covered by test.
|
|
34
|
+
- `note_for` must never break `list` → everything runs under a top-level `try`,
|
|
35
|
+
covered by test.
|
|
36
|
+
- The path signal judges what `PATH` resolves, not what the tool's own check saw. If
|
|
37
|
+
`python` is uv-managed (its check reads `~/.local/bin/python3` directly) but
|
|
38
|
+
`~/.local/bin` is not on the `PATH` devstuff runs with, `python3` resolves to
|
|
39
|
+
`/usr/bin` and the row reads `installed outside uv`. That is true of what the shell
|
|
40
|
+
would run, so it is left as is rather than special-cased.
|
|
41
|
+
- Per-run cost → notes ride the existing probe pools; one `uv tool list`, one
|
|
42
|
+
`npm ls -g`, ≤2 `uv * dir` calls per process via `_once`.
|
|
43
|
+
|
|
44
|
+
## What was run and what was not
|
|
45
|
+
|
|
46
|
+
Run on the author's machine, 2026-10-13:
|
|
47
|
+
|
|
48
|
+
- `uv run pytest tests/test_managers.py tests/test_catalog.py -q` — 62 passed.
|
|
49
|
+
- `uv run pytest -q` (full suite) — 2410 passed, 52 skipped, 71 deselected.
|
|
50
|
+
- `uv run ruff check .` — clean.
|
|
51
|
+
- Real `COLUMNS=160 uv run devstuff list` and `list --installed`, saved to
|
|
52
|
+
`/tmp/managed-by-list.txt` and `/tmp/managed-by-list-installed.txt`. Measured
|
|
53
|
+
states matched the host facts: ipython/hey-dave `✓ managed by uv`, commitizen
|
|
54
|
+
`installed outside uv` (`.venv/bin/cz`), claude-code/codex/pi `✓ managed by nvm`,
|
|
55
|
+
python `python3 at /usr/bin/python3.14 isn't managed by uv; …`, uninstalled
|
|
56
|
+
uvx/npm rows `can manage this`.
|
|
57
|
+
- The interactive `install` picker driven under a real pty (200×120, arrow-key
|
|
58
|
+
scroll, Ctrl-C to exit — nothing installed), captured to
|
|
59
|
+
`/tmp/managed-by-picker.txt`: `installed · managed by uv|nvm`,
|
|
60
|
+
`installed outside uv`, `(via uv)` / `(via nvm)` suffixes all rendered.
|
|
61
|
+
- Timing `uv run devstuff list` three times each way: before ~2.9s
|
|
62
|
+
(2.98/2.85/2.96), after ~3.2s (3.30/3.23/3.15) — the ~0.3s is the four new
|
|
63
|
+
per-process probes (`uv tool list`, `uv tool dir`, `uv python dir`,
|
|
64
|
+
`npm ls -g`), each `_once`-memoised and shared across rows.
|
|
65
|
+
|
|
66
|
+
Not run: no tool was installed, removed or updated; no sudo/apt/npm/Docker on the
|
|
67
|
+
host. The notes' states on a machine *without* uv or nvm are covered only by the
|
|
68
|
+
monkeypatched unit tests, not a real manager-free host.
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
# Managed-by notes — specifications
|
|
2
|
+
|
|
3
|
+
> "When listing installable/installed tools, for any that are or can-be managed by
|
|
4
|
+
> another tool (i.e., uv can manage python) include an indication or recommendation
|
|
5
|
+
> note." — owner request, 2026-10-13
|
|
6
|
+
|
|
7
|
+
The motivating case was measured on the author's machine the same day: `commitizen`
|
|
8
|
+
shows as installed because `cz` resolves inside this repo's `.venv` under `uv run`,
|
|
9
|
+
yet `uv tool list` does not contain it — the catalog said "uvx tool", the machine
|
|
10
|
+
said "not managed by uv". A binary's presence alone cannot establish who owns it.
|
|
11
|
+
|
|
12
|
+
Owner decisions, 2026-10-13 (settled):
|
|
13
|
+
|
|
14
|
+
1. **Data**: a new optional catalog field `managed_by: <tool key>`, plus derived
|
|
15
|
+
defaults (`uvx`/`pip` → uv, `npm` → nvm). No YAML edits for uvx/npm entries.
|
|
16
|
+
2. **Verify installed rows against the machine**; catalog metadata alone is not
|
|
17
|
+
sufficient evidence of management.
|
|
18
|
+
3. **Scope**: only catalog managers (uv, nvm) — plus flagging *system copies* (a
|
|
19
|
+
tool that reads not-installed while its executable exists elsewhere, e.g.
|
|
20
|
+
`python3` at `/usr/bin`).
|
|
21
|
+
4. **Surfaces**: `devstuff list` (including `--installed`/`--available`) and the
|
|
22
|
+
`devstuff install` interactive picker.
|
|
23
|
+
|
|
24
|
+
## Requirements
|
|
25
|
+
|
|
26
|
+
### Data model
|
|
27
|
+
|
|
28
|
+
- **FR-1** `managed_by` is an optional catalog field: a string matching the tool-key
|
|
29
|
+
pattern, never the tool's own key. Validation rejects non-strings, non-keys and
|
|
30
|
+
self-references; it does **not** check that the named manager exists in the same
|
|
31
|
+
catalog file (a user catalog may point at a bundled key).
|
|
32
|
+
- **FR-2** `GenericTool` carries `managed_by` through `from_dict`/`to_dict`; empty
|
|
33
|
+
is omitted in serialization.
|
|
34
|
+
- **FR-3** `AUTO_MANAGER = {"uvx": "uv", "pip": "uv", "npm": "nvm"}` supplies the
|
|
35
|
+
manager when `managed_by` is unset. `manager_of` returns `None` when there is no
|
|
36
|
+
manager, when the manager is the tool itself, or when `registry.exists(manager)`
|
|
37
|
+
is false — a typo produces no note, never a wrong one.
|
|
38
|
+
- **FR-4** The bundled catalog sets `managed_by` exactly twice: `python` → `uv`
|
|
39
|
+
(with `version_cmd: python3`, the managed executable) and `pi` → `nvm` (with
|
|
40
|
+
`version_cmd: pi`).
|
|
41
|
+
|
|
42
|
+
### The verdict
|
|
43
|
+
|
|
44
|
+
- **FR-5** `note_for(tool, installed)` never raises and returns `None` or a
|
|
45
|
+
`ManagerNote` in one of five states:
|
|
46
|
+
|
|
47
|
+
| State | Meaning |
|
|
48
|
+
|---|---|
|
|
49
|
+
| `managed` | installed, and a probe confirmed the manager owns it |
|
|
50
|
+
| `outside` | installed, and a probe confirmed the manager does not own it (path shown when resolvable); also: the manager itself is absent |
|
|
51
|
+
| `can-manage` | not installed, and the manager could own it |
|
|
52
|
+
| `system-copy` | not installed, but the tool's executable exists elsewhere |
|
|
53
|
+
| `unknown` | a probe needed for the verdict failed — never rendered as managed |
|
|
54
|
+
|
|
55
|
+
- **FR-6** Type signal — uvx/pip tools under `uv`: membership of `tool.pip_name` in
|
|
56
|
+
the shared `uv tool list` probe (`generic._uv_tool_versions`) is managed; absence
|
|
57
|
+
is `outside`. A failed probe is `unknown` with the probe's `why`, except "uv is
|
|
58
|
+
not installed", which is definitively `outside` — uv manages nothing it isn't
|
|
59
|
+
there to run.
|
|
60
|
+
- **FR-7** Type signal — npm tools under `nvm`: membership of `tool.npm_name` in
|
|
61
|
+
the output of `. "$NVM_DIR/nvm.sh" && npm ls -g --depth=0 --json` is managed;
|
|
62
|
+
absence is `outside`. Valid JSON is parsed **regardless of exit code** (`npm ls -g`
|
|
63
|
+
can exit non-zero over extraneous packages while printing a valid tree);
|
|
64
|
+
unparseable output is `unknown`. No `nvm.sh` is `outside`.
|
|
65
|
+
- **FR-8** Path signal — explicit `managed_by` on other types: resolve the tool's
|
|
66
|
+
executable (`version_cmd`, else simple `check_cmd`) and test
|
|
67
|
+
`Path.is_relative_to` against the manager's own reported roots on resolved paths:
|
|
68
|
+
`uv tool dir` + `uv python dir` for uv, `$NVM_DIR` (default `~/.nvm`) for nvm.
|
|
69
|
+
Containment is `managed`; anything else is `outside`. A `startswith` check is
|
|
70
|
+
forbidden — `uv/python-other` shares the prefix and is outside.
|
|
71
|
+
- **FR-8a** nvm-managed executables that `shutil.which` misses get a second probe
|
|
72
|
+
through an nvm-sourced `command -v` (pi's binary only exists once nvm puts a
|
|
73
|
+
node bin dir on PATH).
|
|
74
|
+
- **FR-8b** A manager whose roots probe fails yields `unknown`; a manager that is
|
|
75
|
+
absent (no uv binary, no `$NVM_DIR`) yields `outside`. A `managed_by` key with
|
|
76
|
+
no known roots (e.g. `docker`) yields `unknown`, not a crash.
|
|
77
|
+
- **FR-9** Uninstalled tools whose executable resolves on PATH are `system-copy`
|
|
78
|
+
with `executable` and the resolved `path`; otherwise `can-manage`.
|
|
79
|
+
|
|
80
|
+
### Surfaces
|
|
81
|
+
|
|
82
|
+
- **FR-10** `devstuff list` appends a second description line per note state
|
|
83
|
+
(`✓ managed by uv`, `installed outside uv (path); uv can manage it`,
|
|
84
|
+
`⇢ uv can manage this`, `python3 at /usr/bin/python3.14 isn't managed by uv;
|
|
85
|
+
\`devstuff install python\` lets uv manage it`, `? uv-managed tool; couldn't
|
|
86
|
+
confirm (why)`), under all three filters. Machine-derived text is escaped
|
|
87
|
+
through `rich.markup.escape`.
|
|
88
|
+
- **FR-11** The interactive `install` picker shows the same states: `managed`/
|
|
89
|
+
`outside` replace the disabled text (`installed · managed by uv`), `can-manage`
|
|
90
|
+
and `system-copy` append a plain-text title suffix (`(via uv)`,
|
|
91
|
+
`(python3 found outside uv)`), and `unknown` keeps the default `installed` —
|
|
92
|
+
never a positive claim. Disabled requires rows keep their `requires …` text and
|
|
93
|
+
still get the suffix.
|
|
94
|
+
- **FR-12** All probes run inside the commands' existing worker pools; shared
|
|
95
|
+
probes use `generic._once` so `forget_probes()` covers them and the 8-worker
|
|
96
|
+
`list` runs each subprocess once.
|
|
97
|
+
|
|
98
|
+
## Non-goals
|
|
99
|
+
|
|
100
|
+
- No install remedy on `outside` rows — `install_cmd` returns early on
|
|
101
|
+
`is_installed()`, so that advice would be false.
|
|
102
|
+
- No Homebrew/other-manager detection (see stack-decisions D-4).
|
|
103
|
+
- No migration or re-parenting of outside-installed tools.
|
|
104
|
+
- No `managed_by` enforcement at install time — the field annotates, it does not
|
|
105
|
+
route installs through the manager.
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
# Managed-by notes — stack decisions
|
|
2
|
+
|
|
3
|
+
Decisions below were settled by the owner on 2026-10-13; rejected alternatives are
|
|
4
|
+
the part that gets re-litigated later, so they carry their reasons.
|
|
5
|
+
|
|
6
|
+
## Accepted
|
|
7
|
+
|
|
8
|
+
- **D-1 — `managed_by` field + derived defaults.** Explicit `managed_by: <key>` for
|
|
9
|
+
tools whose type does not imply a manager (python, pi); `AUTO_MANAGER` derives
|
|
10
|
+
`uvx`/`pip` → uv and `npm` → nvm so no YAML noise is added to those entries.
|
|
11
|
+
`managed_by` names a *catalog key*, so `registry.exists` can drop typos and
|
|
12
|
+
missing managers instead of printing wrong notes.
|
|
13
|
+
- **D-2 — Verify against the machine, not the catalog.** Installed rows are
|
|
14
|
+
resolved through real probes (`uv tool list`, `npm ls -g` under nvm, executable
|
|
15
|
+
paths vs manager-reported roots). Measured 2026-10-13 on the author's machine:
|
|
16
|
+
`commitizen` reads installed via the repo venv's `cz` but is absent from
|
|
17
|
+
`uv tool list` — catalog-only would claim it managed (outdated-spec finding F-2).
|
|
18
|
+
- **D-3 — Scope: uv and nvm only, plus system copies.** Only catalog managers get
|
|
19
|
+
verdicts; `managed_by` to any other key answers `unknown`, not a guess. The one
|
|
20
|
+
widening the owner asked for is `system-copy`: a not-installed tool whose
|
|
21
|
+
executable exists outside the manager (python3 at `/usr/bin`) gets flagged
|
|
22
|
+
because "install it through uv" is real advice there.
|
|
23
|
+
- **D-4 — Surfaces: `list` and the `install` picker.** Both filters
|
|
24
|
+
(`--installed`/`--available`) included since the notes matter on both sides.
|
|
25
|
+
- **D-5 — The type signal reuses `outdated`'s probes.** `list` and `outdated` must
|
|
26
|
+
agree about what uv manages, so `_uv_tool_versions` is shared verbatim rather
|
|
27
|
+
than parsed a second way. nvm's signal mirrors it (`npm ls -g --json`) but lives
|
|
28
|
+
in `managers.py` because the existing `_npm_global_installed` substring-matches
|
|
29
|
+
per package and would query *system* npm when nvm is absent — a wrong-manager
|
|
30
|
+
answer.
|
|
31
|
+
- **D-6 — `version_cmd` doubles as "the managed executable".** The path signal and
|
|
32
|
+
`get_version` both need a real binary name, and `python`'s/`pi`'s `check_cmd`s
|
|
33
|
+
are compound shell expressions that name none. `version_cmd: python3` /
|
|
34
|
+
`version_cmd: pi` supply it — the same role the field already plays for
|
|
35
|
+
`bwrap`/`fzf`. Side effect: `get_version` now reaches `python3 --version` /
|
|
36
|
+
`pi --version` instead of falling through to `_bash_version(<key>)`.
|
|
37
|
+
|
|
38
|
+
## Rejected
|
|
39
|
+
|
|
40
|
+
- **Catalog-only notes** — would claim `commitizen` is uv-managed when it is not
|
|
41
|
+
(see D-2). The whole feature exists because presence ≠ ownership.
|
|
42
|
+
- **Homebrew / other-manager suggestions** — noisy on machines without brew, and
|
|
43
|
+
brew needs a formula-name map we do not have. Scope stays with managers the
|
|
44
|
+
catalog itself can name.
|
|
45
|
+
- **Inferring management from `requires`** — `requires` is a prerequisite, not
|
|
46
|
+
ownership: `ansible-vault` requires `ansible` but neither is managed by it.
|
|
47
|
+
Conflating them would flag nearly every tool.
|
|
48
|
+
- **A "not managed" remedy on `outside` rows** — `install_cmd` early-returns on
|
|
49
|
+
`is_installed()`; the advice would never run. `system-copy` carries
|
|
50
|
+
`devstuff install <key>` only because there it does run.
|
|
51
|
+
- **`str.startswith` path containment** — `uv/python-other` shares the textual
|
|
52
|
+
prefix of `uv/python`. `Path.is_relative_to` on resolved paths is required, and
|
|
53
|
+
the sibling-directory test exists to prove it.
|
|
@@ -40,6 +40,7 @@ SUPPORTED_FIELDS = {
|
|
|
40
40
|
"sha256",
|
|
41
41
|
"install_script",
|
|
42
42
|
"remove_script",
|
|
43
|
+
"managed_by",
|
|
43
44
|
}
|
|
44
45
|
|
|
45
46
|
|
|
@@ -122,6 +123,13 @@ def validate_catalog(raw: Any, *, source: Path | str = "<catalog>") -> dict[str,
|
|
|
122
123
|
elif not isinstance(requires, list) or not all(isinstance(v, str) for v in requires):
|
|
123
124
|
raise CatalogError(f"{source}: tool {key!r} requires must be a list of strings")
|
|
124
125
|
|
|
126
|
+
managed_by = item.get("managed_by")
|
|
127
|
+
if managed_by is not None:
|
|
128
|
+
if not isinstance(managed_by, str) or not VALID_KEY.match(managed_by):
|
|
129
|
+
raise CatalogError(f"{source}: tool {key!r} managed_by must be a tool key")
|
|
130
|
+
if managed_by == key:
|
|
131
|
+
raise CatalogError(f"{source}: tool {key!r} cannot be managed_by itself")
|
|
132
|
+
|
|
125
133
|
validated[key] = item
|
|
126
134
|
|
|
127
135
|
return validated
|
|
@@ -7,7 +7,7 @@ import click
|
|
|
7
7
|
import questionary
|
|
8
8
|
from rich.markup import escape
|
|
9
9
|
|
|
10
|
-
from dev_setup import registry, ui
|
|
10
|
+
from dev_setup import managers, registry, ui
|
|
11
11
|
from dev_setup.base import Tool
|
|
12
12
|
from dev_setup.commands._plan import plan_for, plan_summary
|
|
13
13
|
|
|
@@ -163,10 +163,16 @@ def _install_interactive(*, yes: bool) -> None:
|
|
|
163
163
|
ui.print_banner()
|
|
164
164
|
tools = registry.all_tools()
|
|
165
165
|
|
|
166
|
-
# Probe installed status concurrently — each check shells out.
|
|
166
|
+
# Probe installed status concurrently — each check shells out. The manager
|
|
167
|
+
# note rides along so its probes share this pass rather than a second one.
|
|
168
|
+
def _probe_one(t: Tool) -> tuple[bool, managers.ManagerNote | None]:
|
|
169
|
+
inst = t.is_installed()
|
|
170
|
+
return inst, managers.note_for(t, inst)
|
|
171
|
+
|
|
167
172
|
with ui.spinner("Checking installed packages..."), ThreadPoolExecutor(max_workers=8) as pool:
|
|
168
|
-
|
|
169
|
-
|
|
173
|
+
probed = dict(zip((t.key for t in tools), pool.map(_probe_one, tools), strict=True))
|
|
174
|
+
installed = {k: v[0] for k, v in probed.items()}
|
|
175
|
+
notes = {k: v[1] for k, v in probed.items()}
|
|
170
176
|
|
|
171
177
|
by_cat: dict[str, list[Tool]] = {}
|
|
172
178
|
for t in tools:
|
|
@@ -186,11 +192,16 @@ def _install_interactive(*, yes: bool) -> None:
|
|
|
186
192
|
for t in entries:
|
|
187
193
|
is_inst = installed[t.key]
|
|
188
194
|
missing = [] if is_inst else registry.missing_requires(t)
|
|
195
|
+
note = notes[t.key]
|
|
196
|
+
suffix, disabled_override = (
|
|
197
|
+
managers.picker_hint(note, t) if note is not None else ("", None)
|
|
198
|
+
)
|
|
189
199
|
desc = t.description
|
|
190
|
-
|
|
191
|
-
|
|
200
|
+
room = max(10, desc_width - len(suffix))
|
|
201
|
+
if len(desc) > room:
|
|
202
|
+
desc = desc[: room - 1] + "…"
|
|
192
203
|
if is_inst:
|
|
193
|
-
disabled = "installed"
|
|
204
|
+
disabled = disabled_override or "installed"
|
|
194
205
|
elif missing:
|
|
195
206
|
disabled = f"requires {', '.join(missing)}"
|
|
196
207
|
else:
|
|
@@ -201,10 +212,10 @@ def _install_interactive(*, yes: bool) -> None:
|
|
|
201
212
|
title: str | list[tuple[str, str]] = (
|
|
202
213
|
[
|
|
203
214
|
("class:check", "● " if is_inst else " "),
|
|
204
|
-
("class:text", f"{t.key:<{key_width}}{desc}"),
|
|
215
|
+
("class:text", f"{t.key:<{key_width}}{desc}{suffix}"),
|
|
205
216
|
]
|
|
206
217
|
if disabled
|
|
207
|
-
else f" {t.key:<{key_width}}{desc}"
|
|
218
|
+
else f" {t.key:<{key_width}}{desc}{suffix}"
|
|
208
219
|
)
|
|
209
220
|
choices.append(questionary.Choice(
|
|
210
221
|
title=title,
|
|
@@ -4,17 +4,17 @@ from concurrent.futures import ThreadPoolExecutor
|
|
|
4
4
|
|
|
5
5
|
import click
|
|
6
6
|
|
|
7
|
-
from dev_setup import registry, ui
|
|
7
|
+
from dev_setup import managers, registry, ui
|
|
8
8
|
from dev_setup.base import Tool
|
|
9
9
|
|
|
10
10
|
_MAX_WORKERS = 8
|
|
11
11
|
|
|
12
12
|
|
|
13
|
-
def _probe(tool: Tool) -> tuple[Tool, bool, str]:
|
|
13
|
+
def _probe(tool: Tool) -> tuple[Tool, bool, str, managers.ManagerNote | None]:
|
|
14
14
|
"""Gather subprocess-heavy status for one tool (runs in a worker thread)."""
|
|
15
15
|
is_inst = tool.is_installed()
|
|
16
16
|
version = tool.get_version() if is_inst else ""
|
|
17
|
-
return tool, is_inst, version
|
|
17
|
+
return tool, is_inst, version, managers.note_for(tool, is_inst)
|
|
18
18
|
|
|
19
19
|
|
|
20
20
|
@click.command("list")
|
|
@@ -35,12 +35,12 @@ def list_cmd(show_filter: str, category: str) -> None:
|
|
|
35
35
|
probed = list(pool.map(_probe, tools))
|
|
36
36
|
|
|
37
37
|
by_cat: dict = {}
|
|
38
|
-
for tool, is_inst, version in probed:
|
|
38
|
+
for tool, is_inst, version, note in probed:
|
|
39
39
|
if show_filter == "installed" and not is_inst:
|
|
40
40
|
continue
|
|
41
41
|
if show_filter == "available" and is_inst:
|
|
42
42
|
continue
|
|
43
|
-
by_cat.setdefault(tool.category, []).append((tool, is_inst, version))
|
|
43
|
+
by_cat.setdefault(tool.category, []).append((tool, is_inst, version, note))
|
|
44
44
|
|
|
45
45
|
if not by_cat:
|
|
46
46
|
ui.warn("No packages match the given filters.")
|
|
@@ -52,7 +52,7 @@ def list_cmd(show_filter: str, category: str) -> None:
|
|
|
52
52
|
if not entries:
|
|
53
53
|
continue
|
|
54
54
|
|
|
55
|
-
n_inst = sum(1 for _, is_inst, _ in entries if is_inst)
|
|
55
|
+
n_inst = sum(1 for _, is_inst, _, _ in entries if is_inst)
|
|
56
56
|
tbl = ui.table(
|
|
57
57
|
title=f"[bold]{cat}[/] [{ui.GRAY}]{n_inst}/{len(entries)} installed[/]"
|
|
58
58
|
)
|
|
@@ -62,7 +62,7 @@ def list_cmd(show_filter: str, category: str) -> None:
|
|
|
62
62
|
tbl.add_column("Type", style=ui.CYAN, no_wrap=True)
|
|
63
63
|
tbl.add_column("Version", style=ui.GRAY, no_wrap=True, max_width=28, overflow="ellipsis")
|
|
64
64
|
|
|
65
|
-
for tool, is_inst, version in entries:
|
|
65
|
+
for tool, is_inst, version, note in entries:
|
|
66
66
|
icon = f"[{ui.GREEN}]●[/]" if is_inst else f"[{ui.GRAY}]○[/]"
|
|
67
67
|
desc = tool.description
|
|
68
68
|
if tool.help_cmd:
|
|
@@ -71,6 +71,10 @@ def list_cmd(show_filter: str, category: str) -> None:
|
|
|
71
71
|
missing = registry.missing_requires(tool)
|
|
72
72
|
if missing:
|
|
73
73
|
desc += f"\n[{ui.AMBER}] ⚠ requires: {', '.join(missing)}[/]"
|
|
74
|
+
if note is not None:
|
|
75
|
+
line = managers.list_line(note, tool)
|
|
76
|
+
if line:
|
|
77
|
+
desc += f"\n{line}"
|
|
74
78
|
tbl.add_row(icon, tool.key, desc, tool.install_type, version)
|
|
75
79
|
|
|
76
80
|
ui.console.print(tbl)
|
|
@@ -156,6 +156,9 @@ class GenericTool(Tool):
|
|
|
156
156
|
remove_script: str = ""
|
|
157
157
|
help_cmd: str = ""
|
|
158
158
|
docs_url: str = ""
|
|
159
|
+
# Catalog key of the tool that manages this one's installs (uv, nvm, …) when
|
|
160
|
+
# the install type doesn't imply one — see managers.py for what it drives.
|
|
161
|
+
managed_by: str = ""
|
|
159
162
|
requires: list | None = None
|
|
160
163
|
builtin: bool = False
|
|
161
164
|
|