devstuff 2.23.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.23.0 → devstuff-2.25.0}/.claude/skills/run-stuff/smoke.sh +1 -1
- {devstuff-2.23.0 → devstuff-2.25.0}/.github/workflows/test-installs.yml +5 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/AGENTS.md +6 -4
- {devstuff-2.23.0 → devstuff-2.25.0}/CHANGELOG.md +12 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/CLAUDE.md +17 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/PKG-INFO +8 -1
- {devstuff-2.23.0 → devstuff-2.25.0}/README.md +7 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/README.md +2 -0
- devstuff-2.25.0/docs/specs/fmhy-picks/development-plan.md +58 -0
- devstuff-2.25.0/docs/specs/fmhy-picks/specifications.md +93 -0
- devstuff-2.25.0/docs/specs/fmhy-picks/stack-decisions.md +74 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/lazygit-config/development-plan.md +3 -2
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/lazygit-config/specifications.md +4 -2
- 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.23.0 → devstuff-2.25.0}/pyproject.toml +1 -1
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/catalog.py +8 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/install_cmd.py +20 -9
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/list_cmd.py +11 -7
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/lazygit/wizard.py +42 -3
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/generic.py +3 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/links.yaml +30 -0
- devstuff-2.25.0/src/dev_setup/managers.py +281 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/tools.yaml +102 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_catalog.py +58 -0
- devstuff-2.25.0/tests/test_catalog_scripts.py +308 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_configure_lazygit.py +125 -0
- devstuff-2.25.0/tests/test_managers.py +535 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/uv.lock +1 -1
- devstuff-2.23.0/tests/test_catalog_scripts.py +0 -110
- {devstuff-2.23.0 → devstuff-2.25.0}/.claude/skills/run-stuff/SKILL.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/.github/codex/review.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/.github/workflows/agent.yml +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/.github/workflows/bump.yml +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/.github/workflows/ci.yml +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/.github/workflows/publish.yml +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/.gitignore +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/dev/Dockerfile +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/dev/Dockerfile.ci +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/dev/Makefile +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/dev/docker-compose.yml +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/devstuff +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/ROADMAP.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/github-agent.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/agent/development-plan.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/agent/specifications.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/agent/stack-decisions.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/ansible-config/development-plan.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/ansible-config/specifications.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/ansible-config/stack-decisions.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/bat-config/development-plan.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/bat-config/specifications.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/bat-config/stack-decisions.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/commitizen-config/development-plan.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/commitizen-config/specifications.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/commitizen-config/stack-decisions.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/docker-config/development-plan.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/docker-config/specifications.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/docker-config/stack-decisions.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/lazygit-config/stack-decisions.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/mcp/development-plan.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/mcp/specifications.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/mcp/stack-decisions.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/outdated/development-plan.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/outdated/specifications.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/outdated/stack-decisions.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/plan-and-progress/specifications.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/precommit-config/development-plan.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/precommit-config/specifications.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/precommit-config/stack-decisions.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/profile/development-plan.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/profile/specifications.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/profile/stack-decisions.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/profile-apply/development-plan.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/profile-apply/specifications.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/profile-apply/stack-decisions.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/starship-config/development-plan.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/starship-config/specifications.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/starship-config/stack-decisions.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/syncthing-config/development-plan.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/syncthing-config/specifications.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/syncthing-config/stack-decisions.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/uv-backbone/development-plan.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/uv-backbone/specifications.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/uv-backbone/stack-decisions.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/verbose-mode/development-plan.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/verbose-mode/specifications.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/docs/specs/verbose-mode/stack-decisions.md +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/install.sh +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/__init__.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/__main__.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/agent/__init__.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/agent/approval.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/agent/bridges.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/agent/catalog.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/agent/completion.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/agent/config.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/agent/loop.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/agent/ollama.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/agent/preflight.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/agent/primitives.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/agent/registry.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/agent/sandbox.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/agent/session.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/agent/transcript.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/agent/wizard.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/agent_tools.schema.json +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/agent_tools.yaml +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/apply_exec.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/apply_plan.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/base.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/bundles/ai-agents.yaml +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/bundles/ai-local.yaml +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/bundles/devops.yaml +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/bundles/essentials.yaml +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/bundles/languages.yaml +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/bundles/python.yaml +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/bundles.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/cli.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/__init__.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/_plan.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/add_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/agent_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/catalog_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/configure_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/delete_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/docs_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/doctor_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/functions_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/help_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/links_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/mcp_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/outdated_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/profile_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/remove_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/run_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/skills_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/commands/update_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/__init__.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/ansible/__init__.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/ansible/detect.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/ansible/model.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/ansible/render.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/ansible/validate.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/ansible/wizard.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/bat/__init__.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/bat/detect.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/bat/model.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/bat/preview.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/bat/render.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/bat/wizard.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/commitizen/__init__.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/commitizen/detect.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/commitizen/model.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/commitizen/render.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/commitizen/validate.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/commitizen/wizard.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/docker/__init__.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/docker/detect.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/docker/model.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/docker/render.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/docker/validate.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/docker/wizard.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/lazygit/__init__.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/lazygit/detect.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/lazygit/model.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/lazygit/render.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/lazygit/validate.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/precommit/__init__.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/precommit/detect.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/precommit/model.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/precommit/render.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/precommit/validate.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/precommit/wizard.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/reptyr/__init__.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/reptyr/wizard.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/__init__.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/fonts.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/icons.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/model.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/preview.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/render.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/wizard.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/syncthing/__init__.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/syncthing/api.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/syncthing/detect.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/syncthing/model.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/configure/syncthing/wizard.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/doctor.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/function_runner.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/functions.schema.json +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/functions.yaml +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/functions_catalog.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/functions_registry.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/links.schema.json +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/links_catalog.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/links_registry.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/mcp/__init__.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/mcp/core.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/mcp/http.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/mcp/openapi.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/mcp/printconfig.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/mcp/process.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/mcp/stdio.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/mcp/token.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/profile.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/registry.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/snapshot.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/ui.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/updates.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/src/dev_setup/verbose.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/__init__.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/integration/__init__.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/integration/conftest.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/integration/test_agent_smoke.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/integration/test_agent_tui.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/integration/test_commitizen_config.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/integration/test_mcp_claude.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/integration/test_mcp_conformance.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/integration/test_profile_apply.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/integration/test_tools.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/mcp_http_support.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/mcp_process_support.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_agent.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_agent_bridges.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_agent_completion.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_agent_loop.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_agent_sandbox.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_agent_tools.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_agent_wizard.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_apply_exec.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_apply_plan.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_apply_run.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_bundles.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_configure_ansible.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_configure_bat.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_configure_commitizen.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_configure_docker.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_configure_precommit.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_configure_reptyr.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_configure_starship.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_configure_syncthing.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_doctor.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_functions.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_generic.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_installed_version.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_lifecycle_cmds.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_links.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_mcp_classify.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_mcp_core.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_mcp_http.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_mcp_http_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_mcp_openapi.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_mcp_printconfig.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_mcp_process.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_mcp_stdio.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_mcp_token.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_outdated_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_pin_support.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_plan_and_select.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_profile.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_profile_apply_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_profile_diff.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_profile_diff_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_profile_snapshot_cmd.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_registry.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_snapshot.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_ui.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_update_checker_parity.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_update_notes.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_updates.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_uv_probes.py +0 -0
- {devstuff-2.23.0 → devstuff-2.25.0}/tests/test_verbose.py +0 -0
|
@@ -35,7 +35,7 @@ echo "=== devstuff smoke tests ==="
|
|
|
35
35
|
echo ""
|
|
36
36
|
|
|
37
37
|
check "version" uv run devstuff version
|
|
38
|
-
check_output "version number" "
|
|
38
|
+
check_output "version number" "devstuff [0-9]" uv run devstuff version
|
|
39
39
|
check "list (all)" uv run devstuff list
|
|
40
40
|
check "list core" uv run devstuff list core
|
|
41
41
|
check "list tools" uv run devstuff list tools
|
|
@@ -60,7 +60,9 @@ jobs:
|
|
|
60
60
|
- claude-code # npm tool, installs nvm first via `requires`
|
|
61
61
|
- codex # npm tool, installs nvm first via `requires`
|
|
62
62
|
- commitizen # uvx tool, requires uv
|
|
63
|
+
- delta # apt: git-delta
|
|
63
64
|
- devin # curl|bash installer, ~/.local/bin
|
|
65
|
+
- fzf # apt + ~/.bashrc key bindings
|
|
64
66
|
- gh
|
|
65
67
|
- ghgrab # uvx tool, requires uv
|
|
66
68
|
- git-lfs
|
|
@@ -78,13 +80,16 @@ jobs:
|
|
|
78
80
|
- mkcert
|
|
79
81
|
- nerd-font
|
|
80
82
|
- nvm
|
|
83
|
+
- opencode # npm: opencode-ai, requires nvm
|
|
81
84
|
- php
|
|
82
85
|
- pi # installs nvm first via its declared `requires`
|
|
83
86
|
- pre-commit # uvx tool, requires uv
|
|
84
87
|
- python # uv-managed CPython, requires uv
|
|
85
88
|
- ruby # compiles from source — this job takes ~15 minutes
|
|
86
89
|
- reptyr
|
|
90
|
+
- ripgrep
|
|
87
91
|
- saml2aws
|
|
92
|
+
- shellcheck
|
|
88
93
|
- starship
|
|
89
94
|
- syncthing # official apt repo (v2); no systemd user session in CI
|
|
90
95
|
- tmux
|
|
@@ -62,13 +62,13 @@ When you open or update a PR, say in its body what was **run** and what was **no
|
|
|
62
62
|
exists but has not had its first real run, or that needs a sudo or Docker the author's machine
|
|
63
63
|
didn't have, is stated as exactly that: not as passing.
|
|
64
64
|
|
|
65
|
-
## Open PRs (snapshot, 2026-10-
|
|
65
|
+
## Open PRs (snapshot, 2026-10-13)
|
|
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
|
|
|
@@ -90,3 +90,5 @@ commits rather than merging `master` in.
|
|
|
90
90
|
| [#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. |
|
|
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
|
+
| [#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). |
|
|
@@ -1,3 +1,15 @@
|
|
|
1
|
+
## v2.25.0 (2026-10-13)
|
|
2
|
+
|
|
3
|
+
### Features
|
|
4
|
+
|
|
5
|
+
- **list**: note which catalog tool manages, or could manage, each tool
|
|
6
|
+
|
|
7
|
+
## v2.24.0 (2026-10-13)
|
|
8
|
+
|
|
9
|
+
### Features
|
|
10
|
+
|
|
11
|
+
- **tools**: add delta, ripgrep, ShellCheck, fzf and OpenCode; add five FMHY links
|
|
12
|
+
|
|
1
13
|
## v2.23.0 (2026-10-13)
|
|
2
14
|
|
|
3
15
|
### Features
|
|
@@ -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
|
|
|
@@ -1648,6 +1649,8 @@ links:
|
|
|
1648
1649
|
| `bat` | bat | cat replacement with syntax highlighting and git integration (`devstuff configure bat`) | `bat --help` |
|
|
1649
1650
|
| `bubblewrap` | bubblewrap + socat | Unprivileged sandbox (bwrap) and network relay (socat) — what Claude Code's /sandbox needs on Linux | `bwrap --help` |
|
|
1650
1651
|
| `commitizen` | Commitizen | Conventional-commit prompt, semantic version bumping, and changelog generation (`devstuff configure commitizen`) | `cz --help` |
|
|
1652
|
+
| `delta` | delta | Syntax-highlighting pager for git diffs — the `devstuff configure lazygit` wizard can install it for you | `delta --help` |
|
|
1653
|
+
| `fzf` | fzf | Command-line fuzzy finder — installs the apt package and adds Ctrl-R/Ctrl-T/Alt-C key bindings to `~/.bashrc` | `fzf --help` |
|
|
1651
1654
|
| `gh` | GitHub CLI | GitHub's official CLI | `gh --help` |
|
|
1652
1655
|
| `ghgrab` | ghgrab | TUI and CLI for downloading files, folders, and release assets from GitHub and other git forges without cloning | `ghgrab --help` |
|
|
1653
1656
|
| `git-lfs` | Git LFS | Git extension for versioning large files | `git lfs --help` |
|
|
@@ -1657,6 +1660,7 @@ links:
|
|
|
1657
1660
|
| `ipython` | IPython | Enhanced interactive Python shell with rich tab completion and magic commands | `ipython --help` |
|
|
1658
1661
|
| `lazygit` | lazygit | TUI git client for fast, keyboard-driven git workflows (`devstuff configure lazygit`) | `lazygit --help` |
|
|
1659
1662
|
| `reptyr` | reptyr | Move a running process to another terminal (`devstuff configure reptyr` for permissions) | `reptyr -h` |
|
|
1663
|
+
| `ripgrep` | ripgrep | Fast recursive code search (`rg`) | `rg --help` |
|
|
1660
1664
|
| `llamactl` | llamactl | CLI for managing LlamaDeploy projects and deployments (LlamaIndex) | `llamactl --help` |
|
|
1661
1665
|
| `llm-checker` | llm-checker | Check LLM compatibility with your hardware | `llm-checker --help` |
|
|
1662
1666
|
| `lmstudio` | LM Studio | Run large language models locally with a GUI | `lms --help` |
|
|
@@ -1669,8 +1673,10 @@ links:
|
|
|
1669
1673
|
| `codex` | Codex CLI | OpenAI coding agent for the terminal | `codex --help` |
|
|
1670
1674
|
| `devin` | Devin CLI | Cognition's AI software engineer, in the terminal | `devin --help` |
|
|
1671
1675
|
| `hey-dave` | hey-dave | Terminal coding-agent harness that runs D.A.V.E. natively | `dave --help` |
|
|
1676
|
+
| `opencode` | OpenCode | Open-source AI coding agent for the terminal | `opencode --help` |
|
|
1672
1677
|
| `pre-commit` | pre-commit | Git hook manager for automated code quality checks (`devstuff configure pre-commit`) | `pre-commit --help` |
|
|
1673
1678
|
| `saml2aws` | saml2aws | SAML → AWS STS credentials CLI (Versent) | `saml2aws --help` |
|
|
1679
|
+
| `shellcheck` | ShellCheck | Static analysis and linting for shell scripts | `shellcheck --help` |
|
|
1674
1680
|
| `starship` | Starship | Fast, cross-shell customizable prompt (`devstuff configure starship`) | `starship --help` |
|
|
1675
1681
|
| `syncthing` | Syncthing | Peer-to-peer file sync daemon (`devstuff configure syncthing` to pair devices) | `syncthing --help` |
|
|
1676
1682
|
| `tmux` | tmux | Terminal multiplexer — persistent sessions, windows and panes | `tmux -h` |
|
|
@@ -1724,6 +1730,7 @@ tools:
|
|
|
1724
1730
|
| `help_cmd` | no | Command shown in `list` under the package entry |
|
|
1725
1731
|
| `docs_url` | no | URL opened by `devstuff docs <key>` |
|
|
1726
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 |
|
|
1727
1734
|
| `npm_name` | npm | npm package name |
|
|
1728
1735
|
| `pip_name` | pip | PyPI package name. Extras work as-is: `pip_name: "ansible-lint[lock]"` |
|
|
1729
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
|
|
|
@@ -1621,6 +1622,8 @@ links:
|
|
|
1621
1622
|
| `bat` | bat | cat replacement with syntax highlighting and git integration (`devstuff configure bat`) | `bat --help` |
|
|
1622
1623
|
| `bubblewrap` | bubblewrap + socat | Unprivileged sandbox (bwrap) and network relay (socat) — what Claude Code's /sandbox needs on Linux | `bwrap --help` |
|
|
1623
1624
|
| `commitizen` | Commitizen | Conventional-commit prompt, semantic version bumping, and changelog generation (`devstuff configure commitizen`) | `cz --help` |
|
|
1625
|
+
| `delta` | delta | Syntax-highlighting pager for git diffs — the `devstuff configure lazygit` wizard can install it for you | `delta --help` |
|
|
1626
|
+
| `fzf` | fzf | Command-line fuzzy finder — installs the apt package and adds Ctrl-R/Ctrl-T/Alt-C key bindings to `~/.bashrc` | `fzf --help` |
|
|
1624
1627
|
| `gh` | GitHub CLI | GitHub's official CLI | `gh --help` |
|
|
1625
1628
|
| `ghgrab` | ghgrab | TUI and CLI for downloading files, folders, and release assets from GitHub and other git forges without cloning | `ghgrab --help` |
|
|
1626
1629
|
| `git-lfs` | Git LFS | Git extension for versioning large files | `git lfs --help` |
|
|
@@ -1630,6 +1633,7 @@ links:
|
|
|
1630
1633
|
| `ipython` | IPython | Enhanced interactive Python shell with rich tab completion and magic commands | `ipython --help` |
|
|
1631
1634
|
| `lazygit` | lazygit | TUI git client for fast, keyboard-driven git workflows (`devstuff configure lazygit`) | `lazygit --help` |
|
|
1632
1635
|
| `reptyr` | reptyr | Move a running process to another terminal (`devstuff configure reptyr` for permissions) | `reptyr -h` |
|
|
1636
|
+
| `ripgrep` | ripgrep | Fast recursive code search (`rg`) | `rg --help` |
|
|
1633
1637
|
| `llamactl` | llamactl | CLI for managing LlamaDeploy projects and deployments (LlamaIndex) | `llamactl --help` |
|
|
1634
1638
|
| `llm-checker` | llm-checker | Check LLM compatibility with your hardware | `llm-checker --help` |
|
|
1635
1639
|
| `lmstudio` | LM Studio | Run large language models locally with a GUI | `lms --help` |
|
|
@@ -1642,8 +1646,10 @@ links:
|
|
|
1642
1646
|
| `codex` | Codex CLI | OpenAI coding agent for the terminal | `codex --help` |
|
|
1643
1647
|
| `devin` | Devin CLI | Cognition's AI software engineer, in the terminal | `devin --help` |
|
|
1644
1648
|
| `hey-dave` | hey-dave | Terminal coding-agent harness that runs D.A.V.E. natively | `dave --help` |
|
|
1649
|
+
| `opencode` | OpenCode | Open-source AI coding agent for the terminal | `opencode --help` |
|
|
1645
1650
|
| `pre-commit` | pre-commit | Git hook manager for automated code quality checks (`devstuff configure pre-commit`) | `pre-commit --help` |
|
|
1646
1651
|
| `saml2aws` | saml2aws | SAML → AWS STS credentials CLI (Versent) | `saml2aws --help` |
|
|
1652
|
+
| `shellcheck` | ShellCheck | Static analysis and linting for shell scripts | `shellcheck --help` |
|
|
1647
1653
|
| `starship` | Starship | Fast, cross-shell customizable prompt (`devstuff configure starship`) | `starship --help` |
|
|
1648
1654
|
| `syncthing` | Syncthing | Peer-to-peer file sync daemon (`devstuff configure syncthing` to pair devices) | `syncthing --help` |
|
|
1649
1655
|
| `tmux` | tmux | Terminal multiplexer — persistent sessions, windows and panes | `tmux -h` |
|
|
@@ -1697,6 +1703,7 @@ tools:
|
|
|
1697
1703
|
| `help_cmd` | no | Command shown in `list` under the package entry |
|
|
1698
1704
|
| `docs_url` | no | URL opened by `devstuff docs <key>` |
|
|
1699
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 |
|
|
1700
1707
|
| `npm_name` | npm | npm package name |
|
|
1701
1708
|
| `pip_name` | pip | PyPI package name. Extras work as-is: `pip_name: "ansible-lint[lock]"` |
|
|
1702
1709
|
| `uv_with` | no (pip/uvx) | Extra packages installed into the tool's environment (`uv tool install --with`) |
|
|
@@ -47,6 +47,8 @@ They are most useful when they capture:
|
|
|
47
47
|
| [`ansible-config/`](ansible-config/) — `devstuff configure ansible`, the ansible.cfg wizard | Complete (v1) |
|
|
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
|
+
| [`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 |
|
|
50
52
|
| [`verbose-mode/`](verbose-mode/) — `-v`/`-vv`, the process-wide verbosity level | Complete (v1) |
|
|
51
53
|
| [`outdated/`](outdated/) — `devstuff outdated`, the read-only installed-vs-latest report | Complete (v1) |
|
|
52
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,58 @@
|
|
|
1
|
+
# FMHY picks — development plan
|
|
2
|
+
|
|
3
|
+
One branch (`feat/fmhy-picks`) and one PR, like #76.
|
|
4
|
+
|
|
5
|
+
## Milestones
|
|
6
|
+
|
|
7
|
+
- **M-1 Selection documented.** This directory. *Done 2026-10-13.*
|
|
8
|
+
- **M-2 Catalog.** The five tools (FR-1…FR-5) and five links (FR-10), CI matrix entries and README
|
|
9
|
+
rows (FR-6). *Done 2026-10-13.*
|
|
10
|
+
- **M-3 fzf script tests.** Run the shipped fzf install/remove scripts in bash against a temporary
|
|
11
|
+
`HOME` with fake `sudo`/`apt-get`/`fzf`, in `tests/test_catalog_scripts.py` (FR-4a…FR-4c).
|
|
12
|
+
*Done 2026-10-13.*
|
|
13
|
+
- **M-4 lazygit offer.** The delta install offer in `configure/lazygit/wizard.py` (FR-7…FR-9),
|
|
14
|
+
with tests, and an update to `docs/specs/lazygit-config/`. *Done 2026-10-13.*
|
|
15
|
+
|
|
16
|
+
## Testing
|
|
17
|
+
|
|
18
|
+
- Unit: `uv run pytest`, including the catalog/matrix coverage tests that already require a matrix
|
|
19
|
+
entry for every built-in.
|
|
20
|
+
- fzf block: source the written `~/.bashrc` in a fresh `bash -i`-like run for each case — `fzf
|
|
21
|
+
--bash` works; `fzf --bash` fails and the fallback file exists; neither; fzf absent — and
|
|
22
|
+
assert a zero exit and empty stderr. Each test must fail against a deliberately broken block.
|
|
23
|
+
- lazygit: drive `_ask_pager` with stubbed `ui`, `shutil.which` and `install_by_key`: offer made
|
|
24
|
+
and accepted, declined, install failed, non-delta pager missing (no offer), delta present (no
|
|
25
|
+
offer).
|
|
26
|
+
|
|
27
|
+
## What was run and what was not
|
|
28
|
+
|
|
29
|
+
Run on the dev host, 2026-10-13:
|
|
30
|
+
|
|
31
|
+
- `uv run pytest tests/test_catalog_scripts.py tests/test_configure_lazygit.py
|
|
32
|
+
tests/test_catalog.py tests/test_links.py -q` — 125 passed, 12 skipped, including
|
|
33
|
+
`test_ci_matrix_covers_every_builtin_tool` (both directions).
|
|
34
|
+
- Full `uv run pytest -q` — 2371 passed, 52 skipped (12 are the lazygit live tests, skipped
|
|
35
|
+
because lazygit is not on this host).
|
|
36
|
+
- `uv run ruff check .` — clean.
|
|
37
|
+
- `bash .claude/skills/run-stuff/smoke.sh` — all 11 checks (after fixing its stale
|
|
38
|
+
`1\.` version expectation; the project is at 2.x).
|
|
39
|
+
- `devstuff list` shows all five tools as not installed.
|
|
40
|
+
- Teeth checks: the fzf block tests were shown to fail against a naive `eval "$(fzf --bash)"`
|
|
41
|
+
block (stderr leaks in the three non-happy cases); the fzf `check_cmd` marker test was shown
|
|
42
|
+
to fail against the old `check_cmd: fzf` (a binary alone returns 0); and the lazygit gate
|
|
43
|
+
tests 1, 4 and 7 were shown to fail against a stubbed-out `_DeltaGate.check`. All restored.
|
|
44
|
+
|
|
45
|
+
Not run:
|
|
46
|
+
|
|
47
|
+
- No real install of the five tools on the dev host (none is installed and the host has no
|
|
48
|
+
Docker, and no sudo/apt/npm installs were run), so the weekly `test-installs.yml` canary is
|
|
49
|
+
their first real run. For fzf, that test's `is_installed()` covers the binary and the
|
|
50
|
+
`~/.bashrc` marker (FR-4d), but not that the key bindings actually load: the CI image's fzf
|
|
51
|
+
0.44 has no `--bash` and the minimized image likely has no fallback file (D-3).
|
|
52
|
+
- The interactive lazygit wizard under a pty; the gate was exercised with stubbed prompts.
|
|
53
|
+
|
|
54
|
+
## Risks
|
|
55
|
+
|
|
56
|
+
- `opencode-ai`'s `postinstall` downloads a platform binary; a network or registry change there
|
|
57
|
+
fails the install even though `npm install` itself works. The CI canary catches it.
|
|
58
|
+
- fzf's fallback path is not exercised by the CI container (D-3).
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
# FMHY picks — specifications
|
|
2
|
+
|
|
3
|
+
Five tools and five links chosen from a scan of the FMHY wiki's docs
|
|
4
|
+
(<https://github.com/fmhy/edit/tree/main/docs>), mainly `developer-tools.md`, `linux-macos.md`,
|
|
5
|
+
`system-tools.md`, `file-tools.md` and `text-tools.md`. Selected 2026-10-13; the owner approved the
|
|
6
|
+
list and answered the design questions recorded in [`stack-decisions.md`](stack-decisions.md).
|
|
7
|
+
|
|
8
|
+
## Selection criteria
|
|
9
|
+
|
|
10
|
+
A candidate was ranked on:
|
|
11
|
+
|
|
12
|
+
1. **Fit.** A Linux command-line tool that one of the existing install types can install, and that
|
|
13
|
+
the CI install container (`ubuntu:24.04`) can test. Desktop-only and server-stack software is a
|
|
14
|
+
link, not a tool.
|
|
15
|
+
2. **Connection to the catalog.** It completes something devstuff already ships (a wizard, a tool
|
|
16
|
+
group), rather than standing alone.
|
|
17
|
+
3. **Prominence.** FMHY stars it, or lists it in more than one place.
|
|
18
|
+
4. **Not already present.** Anything in `tools.yaml` or `links.yaml` was excluded (lazygit, bat,
|
|
19
|
+
htop, starship, tmux, gum, gh, ghgrab, syncthing, Homepage, Server Box, Devhints, Linux Command
|
|
20
|
+
Library, crontab.guru and so on).
|
|
21
|
+
|
|
22
|
+
## Selected tools
|
|
23
|
+
|
|
24
|
+
| Key | Tool | FMHY section | Why |
|
|
25
|
+
|---|---|---|---|
|
|
26
|
+
| `delta` | delta | Git Tools | The lazygit wizard's recommended "With delta" preset writes `delta --dark --paging=never` but cannot install delta. |
|
|
27
|
+
| `ripgrep` | ripgrep | CLI Tools | The standard fast code search. |
|
|
28
|
+
| `shellcheck` | ShellCheck | Terminal / Shell | Lints shell scripts; this project ships a lot of bash in YAML. The pre-commit wizard's shellcheck hook runs in Docker and gives no local binary. |
|
|
29
|
+
| `fzf` | fzf | Fuzzy finders | The usual fuzzy finder, behind shell history search and many other tools. |
|
|
30
|
+
| `opencode` | OpenCode | AI coding harnesses (starred) | The main open-source coding agent missing from `ai-tools` (claude-code, codex, pi, devin). |
|
|
31
|
+
|
|
32
|
+
Runners-up, not selected: lazydocker (no apt package), btop (overlaps htop), zoxide, glow, lnav, gdu.
|
|
33
|
+
|
|
34
|
+
## Selected links
|
|
35
|
+
|
|
36
|
+
| Key | Link | Category | FMHY section |
|
|
37
|
+
|---|---|---|---|
|
|
38
|
+
| `devdocs` | DevDocs — <https://devdocs.io/> | `reference` | Developer Tools (starred) |
|
|
39
|
+
| `archwiki` | ArchWiki — <https://wiki.archlinux.org/> | `reference` | Linux Guides (starred) |
|
|
40
|
+
| `explainshell` | explainshell — <https://explainshell.com/> | `shell` | Terminal / Shell |
|
|
41
|
+
| `awesome-selfhosted` | Awesome Selfhosted — <https://awesome-selfhosted.net/> | `discovery` | Server / Selfhosting (starred) |
|
|
42
|
+
| `deps-dev` | deps.dev — <https://deps.dev/> | `security` | Developer Tools |
|
|
43
|
+
|
|
44
|
+
Runners-up, not selected: Free for Developers, Can I Use, Compiler Explorer, TerminalTrove, grep.app.
|
|
45
|
+
|
|
46
|
+
## Requirements
|
|
47
|
+
|
|
48
|
+
### Tools
|
|
49
|
+
|
|
50
|
+
- **FR-1** `delta`: `type: apt`, `apt_packages: git-delta`, `check_cmd: delta`. The package and the
|
|
51
|
+
command have different names; the check names the command.
|
|
52
|
+
- **FR-2** `ripgrep`: `type: apt`, `apt_packages: ripgrep`, `check_cmd: rg`.
|
|
53
|
+
- **FR-3** `shellcheck`: `type: apt`, `apt_packages: shellcheck`, `check_cmd: shellcheck`.
|
|
54
|
+
- **FR-4** `fzf`: `type: bash`. The install script installs the `fzf` apt package and appends a
|
|
55
|
+
marked block to `~/.bashrc` that turns on fzf's key bindings (Ctrl-R, Ctrl-T, Alt-C). The remove
|
|
56
|
+
script removes the package and strips exactly that block.
|
|
57
|
+
- **FR-4a** The block must work on fzf 0.44 (Ubuntu 24.04, no `fzf --bash`) and on fzf ≥ 0.48:
|
|
58
|
+
use `fzf --bash` when it succeeds, otherwise source
|
|
59
|
+
`/usr/share/doc/fzf/examples/key-bindings.bash` if it is readable, otherwise do nothing.
|
|
60
|
+
- **FR-4b** The block must never make a shell's startup fail or print an error, including when
|
|
61
|
+
fzf has since been uninstalled by other means.
|
|
62
|
+
- **FR-4c** Re-running install must not add a second block.
|
|
63
|
+
- **FR-4d** fzf counts as installed only when the `fzf` command exists and `~/.bashrc`
|
|
64
|
+
carries the marker line, so an fzf installed earlier by other means still gets the
|
|
65
|
+
block on `devstuff install fzf`.
|
|
66
|
+
- **FR-5** `opencode`: `type: npm`, `npm_name: opencode-ai`, `check_cmd: opencode`, requires `nvm`
|
|
67
|
+
(the npm type's default).
|
|
68
|
+
- **FR-6** Every new tool has a CI install-matrix entry in `.github/workflows/test-installs.yml`
|
|
69
|
+
and a row in the README's tool table.
|
|
70
|
+
|
|
71
|
+
### lazygit wizard
|
|
72
|
+
|
|
73
|
+
- **FR-7** When the user picks a delta pager and `delta` is not on `PATH`, the wizard offers to
|
|
74
|
+
install the `delta` catalog tool through `install_by_key`, the same way the starship wizard
|
|
75
|
+
offers `nerd-font`. Declining keeps the current warning and continues; the chosen pager is not
|
|
76
|
+
changed.
|
|
77
|
+
- **FR-8** The offer is made only for a pager whose command is `delta`. Any other missing pager
|
|
78
|
+
command keeps today's warning with no offer.
|
|
79
|
+
- **FR-9** If the install fails or is declined, the warning tells the user how to install later:
|
|
80
|
+
`devstuff install delta`.
|
|
81
|
+
|
|
82
|
+
### Links
|
|
83
|
+
|
|
84
|
+
- **FR-10** The five links above are added to `links.yaml` under existing categories.
|
|
85
|
+
|
|
86
|
+
## Non-goals
|
|
87
|
+
|
|
88
|
+
- Installing a tool does not change its configuration. In particular, `delta` does not set git's
|
|
89
|
+
`core.pager`; that belongs to a git configurator (see the unscheduled `git-config/` item in
|
|
90
|
+
`docs/ROADMAP.md`).
|
|
91
|
+
- No newer-than-archive builds. All four apt tools use the Ubuntu archive even where upstream is
|
|
92
|
+
ahead (see `stack-decisions.md`).
|
|
93
|
+
- No fzf integration for shells other than bash, matching the starship and homebrew entries.
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
# FMHY picks — stack decisions
|
|
2
|
+
|
|
3
|
+
## Measured package versions (2026-10-13)
|
|
4
|
+
|
|
5
|
+
From packages.ubuntu.com and npm:
|
|
6
|
+
|
|
7
|
+
| Package | `noble` (24.04, the CI image) | `resolute` (dev host) | Upstream |
|
|
8
|
+
|---|---|---|---|
|
|
9
|
+
| `git-delta` (installs `/usr/bin/delta`) | 0.16.5 | 0.18.2 | 0.20.1 |
|
|
10
|
+
| `ripgrep` | 14.1.0 | 15.1.0 | — |
|
|
11
|
+
| `shellcheck` | 0.9.0 | 0.11.0 | — |
|
|
12
|
+
| `fzf` | 0.44.1 | 0.67.0 | 0.74.5 |
|
|
13
|
+
| npm `opencode-ai` | — | — | 1.19.0, MIT, `bin: opencode`, has a `postinstall` |
|
|
14
|
+
|
|
15
|
+
None of the five is installed on the dev host.
|
|
16
|
+
|
|
17
|
+
## Decisions
|
|
18
|
+
|
|
19
|
+
### D-1: the Ubuntu archive for delta, ripgrep, ShellCheck and fzf
|
|
20
|
+
|
|
21
|
+
**Chosen:** `apt` from the distro archive (`type: bash` for fzf, see D-3).
|
|
22
|
+
|
|
23
|
+
**Rejected:** upstream GitHub release binaries. Each is newer, but needs a per-tool download
|
|
24
|
+
script with architecture mapping, version discovery and checksum handling, plus a hand-written
|
|
25
|
+
updater. The archive versions are all usable: delta 0.16.5 already supports `--dark` and
|
|
26
|
+
`--paging=never`, which is what the lazygit preset writes. `type: apt` also gives `outdated`,
|
|
27
|
+
`update` and version pinning for free.
|
|
28
|
+
|
|
29
|
+
### D-2: the lazygit wizard offers to install delta
|
|
30
|
+
|
|
31
|
+
**Chosen** (owner, 2026-10-13): when a delta pager is selected and `delta` is missing, offer to
|
|
32
|
+
install it through `install_by_key` (`commands/install_cmd.py`), the existing seam the starship
|
|
33
|
+
wizard uses for `nerd-font`.
|
|
34
|
+
|
|
35
|
+
**Rejected:** catalog entry only, leaving the wizard's warning as the only help.
|
|
36
|
+
|
|
37
|
+
### D-3: fzf as a `type: bash` entry with a `~/.bashrc` block
|
|
38
|
+
|
|
39
|
+
**Chosen** (owner, 2026-10-13): a bash script that installs the apt package and appends a marked
|
|
40
|
+
block, with a remove script that strips it. Same pattern as `starship` and `homebrew`.
|
|
41
|
+
|
|
42
|
+
**Cost, accepted:** a `bash` entry has no update checker, so `devstuff outdated` reports fzf as
|
|
43
|
+
`unsupported`, `devstuff update fzf` is a full reinstall, and fzf cannot be pinned in a profile.
|
|
44
|
+
|
|
45
|
+
**Cost, accepted (owner, 2026-10-13):** the check requires the marker in `~/.bashrc` (FR-4d),
|
|
46
|
+
so a user whose own fzf setup already binds the keys sees fzf as *not installed* — and
|
|
47
|
+
`devstuff remove fzf` would apt-remove an fzf they may have installed themselves.
|
|
48
|
+
|
|
49
|
+
**Rejected:** extending the `apt` type to run `install_script` after `apt-get install`. It would
|
|
50
|
+
keep fzf's update check, but is an engine change. **Finding while deciding:** today an `apt` entry
|
|
51
|
+
honours `remove_script` but silently ignores `install_script`, and `validate_catalog` does not
|
|
52
|
+
reject it. That trap is recorded here, not fixed by this work.
|
|
53
|
+
|
|
54
|
+
**Why the block has a fallback (FR-4a):** `fzf --bash` was added in fzf 0.48, and the CI image's
|
|
55
|
+
fzf is 0.44. Both noble's and resolute's `fzf` packages ship
|
|
56
|
+
`/usr/share/doc/fzf/examples/key-bindings.bash`. Minimized Docker images exclude `/usr/share/doc`,
|
|
57
|
+
so in the CI container the block may legitimately do nothing; the install test checks the binary,
|
|
58
|
+
not the key bindings.
|
|
59
|
+
|
|
60
|
+
### D-4: OpenCode through the `npm` type
|
|
61
|
+
|
|
62
|
+
**Chosen** (owner kept OpenCode over the runners-up, 2026-10-13): `npm_name: opencode-ai`, like
|
|
63
|
+
`claude-code` and `codex`.
|
|
64
|
+
|
|
65
|
+
**Rejected:** OpenCode's `curl | bash` installer, which would make it a `bash` entry with no update
|
|
66
|
+
check. Note that the package's real binary comes from its `postinstall`; the generic npm installer
|
|
67
|
+
runs scripts (only the `pi` entry passes `--ignore-scripts`, in its own script), so nothing extra is
|
|
68
|
+
needed.
|
|
69
|
+
|
|
70
|
+
### D-5: link categories
|
|
71
|
+
|
|
72
|
+
All five go into existing categories (`reference`, `shell`, `discovery`, `security`). explainshell
|
|
73
|
+
sits under `shell` next to the tmux wiki and Linux Command Library rather than `reference`, because
|
|
74
|
+
it explains shell commands specifically.
|
|
@@ -78,5 +78,6 @@ wizard's own launch check uses one internally too):
|
|
|
78
78
|
- Keybinding remapping (Open Question 1) and `gui.theme` colours (Open Question 2).
|
|
79
79
|
- `customCommands` authoring — preserved, never edited.
|
|
80
80
|
- Running the type probe at wizard time (Open Question 3).
|
|
81
|
-
- Offering to install delta when it is chosen but missing (Open Question 4) —
|
|
82
|
-
|
|
81
|
+
- ~~Offering to install delta when it is chosen but missing (Open Question 4)~~ — resolved
|
|
82
|
+
2026-10-13: `delta` is a catalog tool and the wizard offers to install it through
|
|
83
|
+
`install_by_key` when a delta pager is chosen (see `docs/specs/fmhy-picks/`).
|
|
@@ -45,7 +45,9 @@ effect.
|
|
|
45
45
|
- `customCommands`. Same reasoning: preserved, never authored.
|
|
46
46
|
- Themes beyond the icon settings. `gui.theme` is fifteen colour-role lists; the starship
|
|
47
47
|
configurator is where this repo does colour work.
|
|
48
|
-
- Installing
|
|
48
|
+
- Installing a Nerd Font. The wizard points at `devstuff install`. (Delta is now a
|
|
49
|
+
catalog tool and the wizard offers to install it when a delta pager is chosen
|
|
50
|
+
— Open Question 4, resolved; see `docs/specs/fmhy-picks/`.)
|
|
49
51
|
|
|
50
52
|
---
|
|
51
53
|
|
|
@@ -138,7 +140,7 @@ effect.
|
|
|
138
140
|
| 1 | Should keybindings be configurable? | **Resolved 2026-08-02 — no.** A remapping UI over ~150 bindings is its own wizard. The existing tree is preserved. |
|
|
139
141
|
| 2 | Should `gui.theme` colours be offered? | **Resolved 2026-08-02 — not in v1.** Fifteen colour-role lists; the starship configurator is where this repo does colour, and lifting its palette model here is a larger change than it looks. |
|
|
140
142
|
| 3 | Should the type probe run at wizard time rather than authoring time? | **Resolved 2026-08-02 — no.** Each probe is a pty launch of ~2.5 seconds; probing 27 settings would take a minute and would need lazygit installed. Verified once, at authoring time, with the method recorded. |
|
|
141
|
-
| 4 | Should the wizard offer to install delta when it is selected but missing? | **
|
|
143
|
+
| 4 | Should the wizard offer to install delta when it is selected but missing? | **Resolved 2026-10-13:** yes — `delta` is now a catalog tool and the wizard offers to install it through `install_by_key` (see `docs/specs/fmhy-picks/`). |
|
|
142
144
|
| 5 | Should `default_drift` fail a save or only warn? | **Open — currently a failed check, which asks.** It fires when lazygit changes a default, which is a real signal the model is stale, but it is not a problem with the user's config. |
|
|
143
145
|
|
|
144
146
|
---
|
|
@@ -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.
|