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.
Files changed (273) hide show
  1. {devstuff-2.24.0 → devstuff-2.25.0}/AGENTS.md +4 -3
  2. {devstuff-2.24.0 → devstuff-2.25.0}/CHANGELOG.md +6 -0
  3. {devstuff-2.24.0 → devstuff-2.25.0}/CLAUDE.md +17 -0
  4. {devstuff-2.24.0 → devstuff-2.25.0}/PKG-INFO +3 -1
  5. {devstuff-2.24.0 → devstuff-2.25.0}/README.md +2 -0
  6. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/README.md +1 -0
  7. devstuff-2.25.0/docs/specs/managed-by/development-plan.md +68 -0
  8. devstuff-2.25.0/docs/specs/managed-by/specifications.md +105 -0
  9. devstuff-2.25.0/docs/specs/managed-by/stack-decisions.md +53 -0
  10. {devstuff-2.24.0 → devstuff-2.25.0}/pyproject.toml +1 -1
  11. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/catalog.py +8 -0
  12. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/install_cmd.py +20 -9
  13. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/list_cmd.py +11 -7
  14. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/generic.py +3 -0
  15. devstuff-2.25.0/src/dev_setup/managers.py +281 -0
  16. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/tools.yaml +7 -0
  17. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_catalog.py +58 -0
  18. devstuff-2.25.0/tests/test_managers.py +535 -0
  19. {devstuff-2.24.0 → devstuff-2.25.0}/uv.lock +1 -1
  20. {devstuff-2.24.0 → devstuff-2.25.0}/.claude/skills/run-stuff/SKILL.md +0 -0
  21. {devstuff-2.24.0 → devstuff-2.25.0}/.claude/skills/run-stuff/smoke.sh +0 -0
  22. {devstuff-2.24.0 → devstuff-2.25.0}/.github/codex/review.md +0 -0
  23. {devstuff-2.24.0 → devstuff-2.25.0}/.github/workflows/agent.yml +0 -0
  24. {devstuff-2.24.0 → devstuff-2.25.0}/.github/workflows/bump.yml +0 -0
  25. {devstuff-2.24.0 → devstuff-2.25.0}/.github/workflows/ci.yml +0 -0
  26. {devstuff-2.24.0 → devstuff-2.25.0}/.github/workflows/publish.yml +0 -0
  27. {devstuff-2.24.0 → devstuff-2.25.0}/.github/workflows/test-installs.yml +0 -0
  28. {devstuff-2.24.0 → devstuff-2.25.0}/.gitignore +0 -0
  29. {devstuff-2.24.0 → devstuff-2.25.0}/dev/Dockerfile +0 -0
  30. {devstuff-2.24.0 → devstuff-2.25.0}/dev/Dockerfile.ci +0 -0
  31. {devstuff-2.24.0 → devstuff-2.25.0}/dev/Makefile +0 -0
  32. {devstuff-2.24.0 → devstuff-2.25.0}/dev/docker-compose.yml +0 -0
  33. {devstuff-2.24.0 → devstuff-2.25.0}/devstuff +0 -0
  34. {devstuff-2.24.0 → devstuff-2.25.0}/docs/ROADMAP.md +0 -0
  35. {devstuff-2.24.0 → devstuff-2.25.0}/docs/github-agent.md +0 -0
  36. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/agent/development-plan.md +0 -0
  37. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/agent/specifications.md +0 -0
  38. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/agent/stack-decisions.md +0 -0
  39. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/ansible-config/development-plan.md +0 -0
  40. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/ansible-config/specifications.md +0 -0
  41. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/ansible-config/stack-decisions.md +0 -0
  42. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/bat-config/development-plan.md +0 -0
  43. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/bat-config/specifications.md +0 -0
  44. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/bat-config/stack-decisions.md +0 -0
  45. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/commitizen-config/development-plan.md +0 -0
  46. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/commitizen-config/specifications.md +0 -0
  47. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/commitizen-config/stack-decisions.md +0 -0
  48. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/docker-config/development-plan.md +0 -0
  49. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/docker-config/specifications.md +0 -0
  50. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/docker-config/stack-decisions.md +0 -0
  51. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/fmhy-picks/development-plan.md +0 -0
  52. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/fmhy-picks/specifications.md +0 -0
  53. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/fmhy-picks/stack-decisions.md +0 -0
  54. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/lazygit-config/development-plan.md +0 -0
  55. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/lazygit-config/specifications.md +0 -0
  56. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/lazygit-config/stack-decisions.md +0 -0
  57. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/mcp/development-plan.md +0 -0
  58. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/mcp/specifications.md +0 -0
  59. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/mcp/stack-decisions.md +0 -0
  60. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/outdated/development-plan.md +0 -0
  61. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/outdated/specifications.md +0 -0
  62. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/outdated/stack-decisions.md +0 -0
  63. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/plan-and-progress/specifications.md +0 -0
  64. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/precommit-config/development-plan.md +0 -0
  65. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/precommit-config/specifications.md +0 -0
  66. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/precommit-config/stack-decisions.md +0 -0
  67. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/profile/development-plan.md +0 -0
  68. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/profile/specifications.md +0 -0
  69. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/profile/stack-decisions.md +0 -0
  70. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/profile-apply/development-plan.md +0 -0
  71. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/profile-apply/specifications.md +0 -0
  72. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/profile-apply/stack-decisions.md +0 -0
  73. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/starship-config/development-plan.md +0 -0
  74. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/starship-config/specifications.md +0 -0
  75. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/starship-config/stack-decisions.md +0 -0
  76. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/syncthing-config/development-plan.md +0 -0
  77. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/syncthing-config/specifications.md +0 -0
  78. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/syncthing-config/stack-decisions.md +0 -0
  79. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/uv-backbone/development-plan.md +0 -0
  80. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/uv-backbone/specifications.md +0 -0
  81. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/uv-backbone/stack-decisions.md +0 -0
  82. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/verbose-mode/development-plan.md +0 -0
  83. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/verbose-mode/specifications.md +0 -0
  84. {devstuff-2.24.0 → devstuff-2.25.0}/docs/specs/verbose-mode/stack-decisions.md +0 -0
  85. {devstuff-2.24.0 → devstuff-2.25.0}/install.sh +0 -0
  86. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/__init__.py +0 -0
  87. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/__main__.py +0 -0
  88. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/__init__.py +0 -0
  89. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/approval.py +0 -0
  90. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/bridges.py +0 -0
  91. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/catalog.py +0 -0
  92. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/completion.py +0 -0
  93. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/config.py +0 -0
  94. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/loop.py +0 -0
  95. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/ollama.py +0 -0
  96. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/preflight.py +0 -0
  97. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/primitives.py +0 -0
  98. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/registry.py +0 -0
  99. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/sandbox.py +0 -0
  100. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/session.py +0 -0
  101. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/transcript.py +0 -0
  102. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent/wizard.py +0 -0
  103. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent_tools.schema.json +0 -0
  104. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/agent_tools.yaml +0 -0
  105. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/apply_exec.py +0 -0
  106. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/apply_plan.py +0 -0
  107. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/base.py +0 -0
  108. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/bundles/ai-agents.yaml +0 -0
  109. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/bundles/ai-local.yaml +0 -0
  110. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/bundles/devops.yaml +0 -0
  111. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/bundles/essentials.yaml +0 -0
  112. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/bundles/languages.yaml +0 -0
  113. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/bundles/python.yaml +0 -0
  114. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/bundles.py +0 -0
  115. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/cli.py +0 -0
  116. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/__init__.py +0 -0
  117. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/_plan.py +0 -0
  118. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/add_cmd.py +0 -0
  119. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/agent_cmd.py +0 -0
  120. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/catalog_cmd.py +0 -0
  121. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/configure_cmd.py +0 -0
  122. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/delete_cmd.py +0 -0
  123. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/docs_cmd.py +0 -0
  124. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/doctor_cmd.py +0 -0
  125. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/functions_cmd.py +0 -0
  126. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/help_cmd.py +0 -0
  127. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/links_cmd.py +0 -0
  128. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/mcp_cmd.py +0 -0
  129. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/outdated_cmd.py +0 -0
  130. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/profile_cmd.py +0 -0
  131. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/remove_cmd.py +0 -0
  132. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/run_cmd.py +0 -0
  133. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/skills_cmd.py +0 -0
  134. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/commands/update_cmd.py +0 -0
  135. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/__init__.py +0 -0
  136. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/ansible/__init__.py +0 -0
  137. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/ansible/detect.py +0 -0
  138. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/ansible/model.py +0 -0
  139. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/ansible/render.py +0 -0
  140. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/ansible/validate.py +0 -0
  141. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/ansible/wizard.py +0 -0
  142. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/bat/__init__.py +0 -0
  143. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/bat/detect.py +0 -0
  144. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/bat/model.py +0 -0
  145. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/bat/preview.py +0 -0
  146. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/bat/render.py +0 -0
  147. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/bat/wizard.py +0 -0
  148. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/commitizen/__init__.py +0 -0
  149. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/commitizen/detect.py +0 -0
  150. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/commitizen/model.py +0 -0
  151. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/commitizen/render.py +0 -0
  152. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/commitizen/validate.py +0 -0
  153. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/commitizen/wizard.py +0 -0
  154. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/docker/__init__.py +0 -0
  155. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/docker/detect.py +0 -0
  156. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/docker/model.py +0 -0
  157. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/docker/render.py +0 -0
  158. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/docker/validate.py +0 -0
  159. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/docker/wizard.py +0 -0
  160. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/lazygit/__init__.py +0 -0
  161. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/lazygit/detect.py +0 -0
  162. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/lazygit/model.py +0 -0
  163. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/lazygit/render.py +0 -0
  164. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/lazygit/validate.py +0 -0
  165. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/lazygit/wizard.py +0 -0
  166. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/precommit/__init__.py +0 -0
  167. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/precommit/detect.py +0 -0
  168. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/precommit/model.py +0 -0
  169. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/precommit/render.py +0 -0
  170. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/precommit/validate.py +0 -0
  171. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/precommit/wizard.py +0 -0
  172. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/reptyr/__init__.py +0 -0
  173. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/reptyr/wizard.py +0 -0
  174. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/__init__.py +0 -0
  175. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/fonts.py +0 -0
  176. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/icons.py +0 -0
  177. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/model.py +0 -0
  178. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/preview.py +0 -0
  179. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/render.py +0 -0
  180. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/starship/wizard.py +0 -0
  181. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/syncthing/__init__.py +0 -0
  182. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/syncthing/api.py +0 -0
  183. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/syncthing/detect.py +0 -0
  184. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/syncthing/model.py +0 -0
  185. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/configure/syncthing/wizard.py +0 -0
  186. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/doctor.py +0 -0
  187. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/function_runner.py +0 -0
  188. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/functions.schema.json +0 -0
  189. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/functions.yaml +0 -0
  190. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/functions_catalog.py +0 -0
  191. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/functions_registry.py +0 -0
  192. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/links.schema.json +0 -0
  193. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/links.yaml +0 -0
  194. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/links_catalog.py +0 -0
  195. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/links_registry.py +0 -0
  196. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/mcp/__init__.py +0 -0
  197. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/mcp/core.py +0 -0
  198. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/mcp/http.py +0 -0
  199. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/mcp/openapi.py +0 -0
  200. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/mcp/printconfig.py +0 -0
  201. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/mcp/process.py +0 -0
  202. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/mcp/stdio.py +0 -0
  203. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/mcp/token.py +0 -0
  204. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/profile.py +0 -0
  205. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/registry.py +0 -0
  206. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/snapshot.py +0 -0
  207. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/ui.py +0 -0
  208. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/updates.py +0 -0
  209. {devstuff-2.24.0 → devstuff-2.25.0}/src/dev_setup/verbose.py +0 -0
  210. {devstuff-2.24.0 → devstuff-2.25.0}/tests/__init__.py +0 -0
  211. {devstuff-2.24.0 → devstuff-2.25.0}/tests/integration/__init__.py +0 -0
  212. {devstuff-2.24.0 → devstuff-2.25.0}/tests/integration/conftest.py +0 -0
  213. {devstuff-2.24.0 → devstuff-2.25.0}/tests/integration/test_agent_smoke.py +0 -0
  214. {devstuff-2.24.0 → devstuff-2.25.0}/tests/integration/test_agent_tui.py +0 -0
  215. {devstuff-2.24.0 → devstuff-2.25.0}/tests/integration/test_commitizen_config.py +0 -0
  216. {devstuff-2.24.0 → devstuff-2.25.0}/tests/integration/test_mcp_claude.py +0 -0
  217. {devstuff-2.24.0 → devstuff-2.25.0}/tests/integration/test_mcp_conformance.py +0 -0
  218. {devstuff-2.24.0 → devstuff-2.25.0}/tests/integration/test_profile_apply.py +0 -0
  219. {devstuff-2.24.0 → devstuff-2.25.0}/tests/integration/test_tools.py +0 -0
  220. {devstuff-2.24.0 → devstuff-2.25.0}/tests/mcp_http_support.py +0 -0
  221. {devstuff-2.24.0 → devstuff-2.25.0}/tests/mcp_process_support.py +0 -0
  222. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_agent.py +0 -0
  223. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_agent_bridges.py +0 -0
  224. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_agent_completion.py +0 -0
  225. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_agent_loop.py +0 -0
  226. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_agent_sandbox.py +0 -0
  227. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_agent_tools.py +0 -0
  228. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_agent_wizard.py +0 -0
  229. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_apply_exec.py +0 -0
  230. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_apply_plan.py +0 -0
  231. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_apply_run.py +0 -0
  232. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_bundles.py +0 -0
  233. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_catalog_scripts.py +0 -0
  234. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_configure_ansible.py +0 -0
  235. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_configure_bat.py +0 -0
  236. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_configure_commitizen.py +0 -0
  237. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_configure_docker.py +0 -0
  238. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_configure_lazygit.py +0 -0
  239. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_configure_precommit.py +0 -0
  240. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_configure_reptyr.py +0 -0
  241. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_configure_starship.py +0 -0
  242. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_configure_syncthing.py +0 -0
  243. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_doctor.py +0 -0
  244. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_functions.py +0 -0
  245. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_generic.py +0 -0
  246. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_installed_version.py +0 -0
  247. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_lifecycle_cmds.py +0 -0
  248. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_links.py +0 -0
  249. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_mcp_classify.py +0 -0
  250. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_mcp_core.py +0 -0
  251. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_mcp_http.py +0 -0
  252. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_mcp_http_cmd.py +0 -0
  253. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_mcp_openapi.py +0 -0
  254. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_mcp_printconfig.py +0 -0
  255. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_mcp_process.py +0 -0
  256. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_mcp_stdio.py +0 -0
  257. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_mcp_token.py +0 -0
  258. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_outdated_cmd.py +0 -0
  259. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_pin_support.py +0 -0
  260. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_plan_and_select.py +0 -0
  261. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_profile.py +0 -0
  262. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_profile_apply_cmd.py +0 -0
  263. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_profile_diff.py +0 -0
  264. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_profile_diff_cmd.py +0 -0
  265. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_profile_snapshot_cmd.py +0 -0
  266. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_registry.py +0 -0
  267. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_snapshot.py +0 -0
  268. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_ui.py +0 -0
  269. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_update_checker_parity.py +0 -0
  270. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_update_notes.py +0 -0
  271. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_updates.py +0 -0
  272. {devstuff-2.24.0 → devstuff-2.25.0}/tests/test_uv_probes.py +0 -0
  273. {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 | Base | Notes |
70
- |---|---|---|---|
71
- | [#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 | `feat/fmhy-picks` | `master` | Opened 2026-10-13. Also carries the AGENTS.md #76 follow-up commit. Not yet run: a real install of any of the five (no Docker on the dev host), so the CI canary is their first run; the lazygit wizard under a pty. |
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). |
@@ -1,3 +1,9 @@
1
+ ## v2.25.0 (2026-10-13)
2
+
3
+ ### Features
4
+
5
+ - **list**: note which catalog tool manages, or could manage, each tool
6
+
1
7
  ## v2.24.0 (2026-10-13)
2
8
 
3
9
  ### 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.24.0
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.
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "devstuff"
3
- version = "2.24.0"
3
+ version = "2.25.0"
4
4
  description = "Development environment setup CLI for Linux"
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.11"
@@ -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
- statuses = pool.map(lambda t: t.is_installed(), tools)
169
- installed = dict(zip((t.key for t in tools), statuses, strict=True))
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
- if len(desc) > desc_width:
191
- desc = desc[: desc_width - 1] + "…"
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