devstuff 2.23.0__tar.gz → 2.24.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 (269) hide show
  1. {devstuff-2.23.0 → devstuff-2.24.0}/.claude/skills/run-stuff/smoke.sh +1 -1
  2. {devstuff-2.23.0 → devstuff-2.24.0}/.github/workflows/test-installs.yml +5 -0
  3. {devstuff-2.23.0 → devstuff-2.24.0}/AGENTS.md +3 -2
  4. {devstuff-2.23.0 → devstuff-2.24.0}/CHANGELOG.md +6 -0
  5. {devstuff-2.23.0 → devstuff-2.24.0}/PKG-INFO +6 -1
  6. {devstuff-2.23.0 → devstuff-2.24.0}/README.md +5 -0
  7. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/README.md +1 -0
  8. devstuff-2.24.0/docs/specs/fmhy-picks/development-plan.md +58 -0
  9. devstuff-2.24.0/docs/specs/fmhy-picks/specifications.md +93 -0
  10. devstuff-2.24.0/docs/specs/fmhy-picks/stack-decisions.md +74 -0
  11. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/lazygit-config/development-plan.md +3 -2
  12. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/lazygit-config/specifications.md +4 -2
  13. {devstuff-2.23.0 → devstuff-2.24.0}/pyproject.toml +1 -1
  14. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/lazygit/wizard.py +42 -3
  15. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/links.yaml +30 -0
  16. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/tools.yaml +95 -0
  17. devstuff-2.24.0/tests/test_catalog_scripts.py +308 -0
  18. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_configure_lazygit.py +125 -0
  19. {devstuff-2.23.0 → devstuff-2.24.0}/uv.lock +1 -1
  20. devstuff-2.23.0/tests/test_catalog_scripts.py +0 -110
  21. {devstuff-2.23.0 → devstuff-2.24.0}/.claude/skills/run-stuff/SKILL.md +0 -0
  22. {devstuff-2.23.0 → devstuff-2.24.0}/.github/codex/review.md +0 -0
  23. {devstuff-2.23.0 → devstuff-2.24.0}/.github/workflows/agent.yml +0 -0
  24. {devstuff-2.23.0 → devstuff-2.24.0}/.github/workflows/bump.yml +0 -0
  25. {devstuff-2.23.0 → devstuff-2.24.0}/.github/workflows/ci.yml +0 -0
  26. {devstuff-2.23.0 → devstuff-2.24.0}/.github/workflows/publish.yml +0 -0
  27. {devstuff-2.23.0 → devstuff-2.24.0}/.gitignore +0 -0
  28. {devstuff-2.23.0 → devstuff-2.24.0}/CLAUDE.md +0 -0
  29. {devstuff-2.23.0 → devstuff-2.24.0}/dev/Dockerfile +0 -0
  30. {devstuff-2.23.0 → devstuff-2.24.0}/dev/Dockerfile.ci +0 -0
  31. {devstuff-2.23.0 → devstuff-2.24.0}/dev/Makefile +0 -0
  32. {devstuff-2.23.0 → devstuff-2.24.0}/dev/docker-compose.yml +0 -0
  33. {devstuff-2.23.0 → devstuff-2.24.0}/devstuff +0 -0
  34. {devstuff-2.23.0 → devstuff-2.24.0}/docs/ROADMAP.md +0 -0
  35. {devstuff-2.23.0 → devstuff-2.24.0}/docs/github-agent.md +0 -0
  36. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/agent/development-plan.md +0 -0
  37. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/agent/specifications.md +0 -0
  38. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/agent/stack-decisions.md +0 -0
  39. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/ansible-config/development-plan.md +0 -0
  40. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/ansible-config/specifications.md +0 -0
  41. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/ansible-config/stack-decisions.md +0 -0
  42. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/bat-config/development-plan.md +0 -0
  43. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/bat-config/specifications.md +0 -0
  44. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/bat-config/stack-decisions.md +0 -0
  45. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/commitizen-config/development-plan.md +0 -0
  46. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/commitizen-config/specifications.md +0 -0
  47. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/commitizen-config/stack-decisions.md +0 -0
  48. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/docker-config/development-plan.md +0 -0
  49. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/docker-config/specifications.md +0 -0
  50. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/docker-config/stack-decisions.md +0 -0
  51. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/lazygit-config/stack-decisions.md +0 -0
  52. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/mcp/development-plan.md +0 -0
  53. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/mcp/specifications.md +0 -0
  54. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/mcp/stack-decisions.md +0 -0
  55. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/outdated/development-plan.md +0 -0
  56. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/outdated/specifications.md +0 -0
  57. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/outdated/stack-decisions.md +0 -0
  58. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/plan-and-progress/specifications.md +0 -0
  59. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/precommit-config/development-plan.md +0 -0
  60. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/precommit-config/specifications.md +0 -0
  61. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/precommit-config/stack-decisions.md +0 -0
  62. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/profile/development-plan.md +0 -0
  63. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/profile/specifications.md +0 -0
  64. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/profile/stack-decisions.md +0 -0
  65. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/profile-apply/development-plan.md +0 -0
  66. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/profile-apply/specifications.md +0 -0
  67. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/profile-apply/stack-decisions.md +0 -0
  68. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/starship-config/development-plan.md +0 -0
  69. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/starship-config/specifications.md +0 -0
  70. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/starship-config/stack-decisions.md +0 -0
  71. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/syncthing-config/development-plan.md +0 -0
  72. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/syncthing-config/specifications.md +0 -0
  73. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/syncthing-config/stack-decisions.md +0 -0
  74. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/uv-backbone/development-plan.md +0 -0
  75. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/uv-backbone/specifications.md +0 -0
  76. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/uv-backbone/stack-decisions.md +0 -0
  77. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/verbose-mode/development-plan.md +0 -0
  78. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/verbose-mode/specifications.md +0 -0
  79. {devstuff-2.23.0 → devstuff-2.24.0}/docs/specs/verbose-mode/stack-decisions.md +0 -0
  80. {devstuff-2.23.0 → devstuff-2.24.0}/install.sh +0 -0
  81. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/__init__.py +0 -0
  82. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/__main__.py +0 -0
  83. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/agent/__init__.py +0 -0
  84. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/agent/approval.py +0 -0
  85. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/agent/bridges.py +0 -0
  86. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/agent/catalog.py +0 -0
  87. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/agent/completion.py +0 -0
  88. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/agent/config.py +0 -0
  89. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/agent/loop.py +0 -0
  90. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/agent/ollama.py +0 -0
  91. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/agent/preflight.py +0 -0
  92. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/agent/primitives.py +0 -0
  93. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/agent/registry.py +0 -0
  94. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/agent/sandbox.py +0 -0
  95. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/agent/session.py +0 -0
  96. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/agent/transcript.py +0 -0
  97. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/agent/wizard.py +0 -0
  98. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/agent_tools.schema.json +0 -0
  99. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/agent_tools.yaml +0 -0
  100. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/apply_exec.py +0 -0
  101. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/apply_plan.py +0 -0
  102. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/base.py +0 -0
  103. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/bundles/ai-agents.yaml +0 -0
  104. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/bundles/ai-local.yaml +0 -0
  105. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/bundles/devops.yaml +0 -0
  106. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/bundles/essentials.yaml +0 -0
  107. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/bundles/languages.yaml +0 -0
  108. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/bundles/python.yaml +0 -0
  109. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/bundles.py +0 -0
  110. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/catalog.py +0 -0
  111. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/cli.py +0 -0
  112. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/__init__.py +0 -0
  113. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/_plan.py +0 -0
  114. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/add_cmd.py +0 -0
  115. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/agent_cmd.py +0 -0
  116. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/catalog_cmd.py +0 -0
  117. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/configure_cmd.py +0 -0
  118. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/delete_cmd.py +0 -0
  119. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/docs_cmd.py +0 -0
  120. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/doctor_cmd.py +0 -0
  121. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/functions_cmd.py +0 -0
  122. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/help_cmd.py +0 -0
  123. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/install_cmd.py +0 -0
  124. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/links_cmd.py +0 -0
  125. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/list_cmd.py +0 -0
  126. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/mcp_cmd.py +0 -0
  127. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/outdated_cmd.py +0 -0
  128. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/profile_cmd.py +0 -0
  129. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/remove_cmd.py +0 -0
  130. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/run_cmd.py +0 -0
  131. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/skills_cmd.py +0 -0
  132. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/commands/update_cmd.py +0 -0
  133. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/__init__.py +0 -0
  134. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/ansible/__init__.py +0 -0
  135. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/ansible/detect.py +0 -0
  136. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/ansible/model.py +0 -0
  137. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/ansible/render.py +0 -0
  138. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/ansible/validate.py +0 -0
  139. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/ansible/wizard.py +0 -0
  140. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/bat/__init__.py +0 -0
  141. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/bat/detect.py +0 -0
  142. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/bat/model.py +0 -0
  143. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/bat/preview.py +0 -0
  144. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/bat/render.py +0 -0
  145. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/bat/wizard.py +0 -0
  146. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/commitizen/__init__.py +0 -0
  147. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/commitizen/detect.py +0 -0
  148. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/commitizen/model.py +0 -0
  149. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/commitizen/render.py +0 -0
  150. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/commitizen/validate.py +0 -0
  151. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/commitizen/wizard.py +0 -0
  152. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/docker/__init__.py +0 -0
  153. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/docker/detect.py +0 -0
  154. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/docker/model.py +0 -0
  155. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/docker/render.py +0 -0
  156. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/docker/validate.py +0 -0
  157. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/docker/wizard.py +0 -0
  158. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/lazygit/__init__.py +0 -0
  159. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/lazygit/detect.py +0 -0
  160. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/lazygit/model.py +0 -0
  161. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/lazygit/render.py +0 -0
  162. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/lazygit/validate.py +0 -0
  163. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/precommit/__init__.py +0 -0
  164. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/precommit/detect.py +0 -0
  165. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/precommit/model.py +0 -0
  166. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/precommit/render.py +0 -0
  167. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/precommit/validate.py +0 -0
  168. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/precommit/wizard.py +0 -0
  169. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/reptyr/__init__.py +0 -0
  170. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/reptyr/wizard.py +0 -0
  171. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/starship/__init__.py +0 -0
  172. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/starship/fonts.py +0 -0
  173. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/starship/icons.py +0 -0
  174. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/starship/model.py +0 -0
  175. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/starship/preview.py +0 -0
  176. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/starship/render.py +0 -0
  177. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/starship/wizard.py +0 -0
  178. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/syncthing/__init__.py +0 -0
  179. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/syncthing/api.py +0 -0
  180. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/syncthing/detect.py +0 -0
  181. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/syncthing/model.py +0 -0
  182. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/configure/syncthing/wizard.py +0 -0
  183. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/doctor.py +0 -0
  184. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/function_runner.py +0 -0
  185. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/functions.schema.json +0 -0
  186. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/functions.yaml +0 -0
  187. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/functions_catalog.py +0 -0
  188. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/functions_registry.py +0 -0
  189. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/generic.py +0 -0
  190. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/links.schema.json +0 -0
  191. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/links_catalog.py +0 -0
  192. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/links_registry.py +0 -0
  193. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/mcp/__init__.py +0 -0
  194. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/mcp/core.py +0 -0
  195. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/mcp/http.py +0 -0
  196. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/mcp/openapi.py +0 -0
  197. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/mcp/printconfig.py +0 -0
  198. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/mcp/process.py +0 -0
  199. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/mcp/stdio.py +0 -0
  200. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/mcp/token.py +0 -0
  201. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/profile.py +0 -0
  202. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/registry.py +0 -0
  203. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/snapshot.py +0 -0
  204. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/ui.py +0 -0
  205. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/updates.py +0 -0
  206. {devstuff-2.23.0 → devstuff-2.24.0}/src/dev_setup/verbose.py +0 -0
  207. {devstuff-2.23.0 → devstuff-2.24.0}/tests/__init__.py +0 -0
  208. {devstuff-2.23.0 → devstuff-2.24.0}/tests/integration/__init__.py +0 -0
  209. {devstuff-2.23.0 → devstuff-2.24.0}/tests/integration/conftest.py +0 -0
  210. {devstuff-2.23.0 → devstuff-2.24.0}/tests/integration/test_agent_smoke.py +0 -0
  211. {devstuff-2.23.0 → devstuff-2.24.0}/tests/integration/test_agent_tui.py +0 -0
  212. {devstuff-2.23.0 → devstuff-2.24.0}/tests/integration/test_commitizen_config.py +0 -0
  213. {devstuff-2.23.0 → devstuff-2.24.0}/tests/integration/test_mcp_claude.py +0 -0
  214. {devstuff-2.23.0 → devstuff-2.24.0}/tests/integration/test_mcp_conformance.py +0 -0
  215. {devstuff-2.23.0 → devstuff-2.24.0}/tests/integration/test_profile_apply.py +0 -0
  216. {devstuff-2.23.0 → devstuff-2.24.0}/tests/integration/test_tools.py +0 -0
  217. {devstuff-2.23.0 → devstuff-2.24.0}/tests/mcp_http_support.py +0 -0
  218. {devstuff-2.23.0 → devstuff-2.24.0}/tests/mcp_process_support.py +0 -0
  219. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_agent.py +0 -0
  220. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_agent_bridges.py +0 -0
  221. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_agent_completion.py +0 -0
  222. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_agent_loop.py +0 -0
  223. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_agent_sandbox.py +0 -0
  224. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_agent_tools.py +0 -0
  225. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_agent_wizard.py +0 -0
  226. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_apply_exec.py +0 -0
  227. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_apply_plan.py +0 -0
  228. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_apply_run.py +0 -0
  229. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_bundles.py +0 -0
  230. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_catalog.py +0 -0
  231. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_configure_ansible.py +0 -0
  232. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_configure_bat.py +0 -0
  233. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_configure_commitizen.py +0 -0
  234. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_configure_docker.py +0 -0
  235. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_configure_precommit.py +0 -0
  236. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_configure_reptyr.py +0 -0
  237. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_configure_starship.py +0 -0
  238. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_configure_syncthing.py +0 -0
  239. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_doctor.py +0 -0
  240. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_functions.py +0 -0
  241. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_generic.py +0 -0
  242. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_installed_version.py +0 -0
  243. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_lifecycle_cmds.py +0 -0
  244. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_links.py +0 -0
  245. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_mcp_classify.py +0 -0
  246. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_mcp_core.py +0 -0
  247. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_mcp_http.py +0 -0
  248. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_mcp_http_cmd.py +0 -0
  249. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_mcp_openapi.py +0 -0
  250. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_mcp_printconfig.py +0 -0
  251. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_mcp_process.py +0 -0
  252. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_mcp_stdio.py +0 -0
  253. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_mcp_token.py +0 -0
  254. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_outdated_cmd.py +0 -0
  255. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_pin_support.py +0 -0
  256. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_plan_and_select.py +0 -0
  257. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_profile.py +0 -0
  258. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_profile_apply_cmd.py +0 -0
  259. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_profile_diff.py +0 -0
  260. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_profile_diff_cmd.py +0 -0
  261. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_profile_snapshot_cmd.py +0 -0
  262. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_registry.py +0 -0
  263. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_snapshot.py +0 -0
  264. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_ui.py +0 -0
  265. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_update_checker_parity.py +0 -0
  266. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_update_notes.py +0 -0
  267. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_updates.py +0 -0
  268. {devstuff-2.23.0 → devstuff-2.24.0}/tests/test_uv_probes.py +0 -0
  269. {devstuff-2.23.0 → devstuff-2.24.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" "1\." uv run devstuff version
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-12)
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
69
  | PR | Branch | Base | Notes |
70
70
  |---|---|---|---|
71
- | [#76](https://github.com/thesawdawg/dev-setup-py/pull/76) `tmux`, `gum`, `bubblewrap` (+ `socat`) tools; Druid, Homepage, Server Box and tmux wiki links | `feat/tmux-gum-bubblewrap-links` | `master` | Opened 2026-10-12. Also carries the AGENTS.md #75 follow-up commit. Not yet run: a real install of any of the three (no Docker on the dev host); the CI canary is their first run. |
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. |
72
72
 
73
73
  ### Closed as dropped
74
74
 
@@ -90,3 +90,4 @@ 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. |
@@ -1,3 +1,9 @@
1
+ ## v2.24.0 (2026-10-13)
2
+
3
+ ### Features
4
+
5
+ - **tools**: add delta, ripgrep, ShellCheck, fzf and OpenCode; add five FMHY links
6
+
1
7
  ## v2.23.0 (2026-10-13)
2
8
 
3
9
  ### Features
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: devstuff
3
- Version: 2.23.0
3
+ Version: 2.24.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>
@@ -1648,6 +1648,8 @@ links:
1648
1648
  | `bat` | bat | cat replacement with syntax highlighting and git integration (`devstuff configure bat`) | `bat --help` |
1649
1649
  | `bubblewrap` | bubblewrap + socat | Unprivileged sandbox (bwrap) and network relay (socat) — what Claude Code's /sandbox needs on Linux | `bwrap --help` |
1650
1650
  | `commitizen` | Commitizen | Conventional-commit prompt, semantic version bumping, and changelog generation (`devstuff configure commitizen`) | `cz --help` |
1651
+ | `delta` | delta | Syntax-highlighting pager for git diffs — the `devstuff configure lazygit` wizard can install it for you | `delta --help` |
1652
+ | `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
1653
  | `gh` | GitHub CLI | GitHub's official CLI | `gh --help` |
1652
1654
  | `ghgrab` | ghgrab | TUI and CLI for downloading files, folders, and release assets from GitHub and other git forges without cloning | `ghgrab --help` |
1653
1655
  | `git-lfs` | Git LFS | Git extension for versioning large files | `git lfs --help` |
@@ -1657,6 +1659,7 @@ links:
1657
1659
  | `ipython` | IPython | Enhanced interactive Python shell with rich tab completion and magic commands | `ipython --help` |
1658
1660
  | `lazygit` | lazygit | TUI git client for fast, keyboard-driven git workflows (`devstuff configure lazygit`) | `lazygit --help` |
1659
1661
  | `reptyr` | reptyr | Move a running process to another terminal (`devstuff configure reptyr` for permissions) | `reptyr -h` |
1662
+ | `ripgrep` | ripgrep | Fast recursive code search (`rg`) | `rg --help` |
1660
1663
  | `llamactl` | llamactl | CLI for managing LlamaDeploy projects and deployments (LlamaIndex) | `llamactl --help` |
1661
1664
  | `llm-checker` | llm-checker | Check LLM compatibility with your hardware | `llm-checker --help` |
1662
1665
  | `lmstudio` | LM Studio | Run large language models locally with a GUI | `lms --help` |
@@ -1669,8 +1672,10 @@ links:
1669
1672
  | `codex` | Codex CLI | OpenAI coding agent for the terminal | `codex --help` |
1670
1673
  | `devin` | Devin CLI | Cognition's AI software engineer, in the terminal | `devin --help` |
1671
1674
  | `hey-dave` | hey-dave | Terminal coding-agent harness that runs D.A.V.E. natively | `dave --help` |
1675
+ | `opencode` | OpenCode | Open-source AI coding agent for the terminal | `opencode --help` |
1672
1676
  | `pre-commit` | pre-commit | Git hook manager for automated code quality checks (`devstuff configure pre-commit`) | `pre-commit --help` |
1673
1677
  | `saml2aws` | saml2aws | SAML → AWS STS credentials CLI (Versent) | `saml2aws --help` |
1678
+ | `shellcheck` | ShellCheck | Static analysis and linting for shell scripts | `shellcheck --help` |
1674
1679
  | `starship` | Starship | Fast, cross-shell customizable prompt (`devstuff configure starship`) | `starship --help` |
1675
1680
  | `syncthing` | Syncthing | Peer-to-peer file sync daemon (`devstuff configure syncthing` to pair devices) | `syncthing --help` |
1676
1681
  | `tmux` | tmux | Terminal multiplexer — persistent sessions, windows and panes | `tmux -h` |
@@ -1621,6 +1621,8 @@ links:
1621
1621
  | `bat` | bat | cat replacement with syntax highlighting and git integration (`devstuff configure bat`) | `bat --help` |
1622
1622
  | `bubblewrap` | bubblewrap + socat | Unprivileged sandbox (bwrap) and network relay (socat) — what Claude Code's /sandbox needs on Linux | `bwrap --help` |
1623
1623
  | `commitizen` | Commitizen | Conventional-commit prompt, semantic version bumping, and changelog generation (`devstuff configure commitizen`) | `cz --help` |
1624
+ | `delta` | delta | Syntax-highlighting pager for git diffs — the `devstuff configure lazygit` wizard can install it for you | `delta --help` |
1625
+ | `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
1626
  | `gh` | GitHub CLI | GitHub's official CLI | `gh --help` |
1625
1627
  | `ghgrab` | ghgrab | TUI and CLI for downloading files, folders, and release assets from GitHub and other git forges without cloning | `ghgrab --help` |
1626
1628
  | `git-lfs` | Git LFS | Git extension for versioning large files | `git lfs --help` |
@@ -1630,6 +1632,7 @@ links:
1630
1632
  | `ipython` | IPython | Enhanced interactive Python shell with rich tab completion and magic commands | `ipython --help` |
1631
1633
  | `lazygit` | lazygit | TUI git client for fast, keyboard-driven git workflows (`devstuff configure lazygit`) | `lazygit --help` |
1632
1634
  | `reptyr` | reptyr | Move a running process to another terminal (`devstuff configure reptyr` for permissions) | `reptyr -h` |
1635
+ | `ripgrep` | ripgrep | Fast recursive code search (`rg`) | `rg --help` |
1633
1636
  | `llamactl` | llamactl | CLI for managing LlamaDeploy projects and deployments (LlamaIndex) | `llamactl --help` |
1634
1637
  | `llm-checker` | llm-checker | Check LLM compatibility with your hardware | `llm-checker --help` |
1635
1638
  | `lmstudio` | LM Studio | Run large language models locally with a GUI | `lms --help` |
@@ -1642,8 +1645,10 @@ links:
1642
1645
  | `codex` | Codex CLI | OpenAI coding agent for the terminal | `codex --help` |
1643
1646
  | `devin` | Devin CLI | Cognition's AI software engineer, in the terminal | `devin --help` |
1644
1647
  | `hey-dave` | hey-dave | Terminal coding-agent harness that runs D.A.V.E. natively | `dave --help` |
1648
+ | `opencode` | OpenCode | Open-source AI coding agent for the terminal | `opencode --help` |
1645
1649
  | `pre-commit` | pre-commit | Git hook manager for automated code quality checks (`devstuff configure pre-commit`) | `pre-commit --help` |
1646
1650
  | `saml2aws` | saml2aws | SAML → AWS STS credentials CLI (Versent) | `saml2aws --help` |
1651
+ | `shellcheck` | ShellCheck | Static analysis and linting for shell scripts | `shellcheck --help` |
1647
1652
  | `starship` | Starship | Fast, cross-shell customizable prompt (`devstuff configure starship`) | `starship --help` |
1648
1653
  | `syncthing` | Syncthing | Peer-to-peer file sync daemon (`devstuff configure syncthing` to pair devices) | `syncthing --help` |
1649
1654
  | `tmux` | tmux | Terminal multiplexer — persistent sessions, windows and panes | `tmux -h` |
@@ -47,6 +47,7 @@ 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) |
50
51
  | [`verbose-mode/`](verbose-mode/) — `-v`/`-vv`, the process-wide verbosity level | Complete (v1) |
51
52
  | [`outdated/`](outdated/) — `devstuff outdated`, the read-only installed-vs-latest report | Complete (v1) |
52
53
  | [`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) — `delta` is not
82
- in `tools.yaml` yet, which is what that would need first.
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 delta or a Nerd Font. The wizard points at `devstuff install`.
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? | **Open.** `delta` is not currently in `tools.yaml`; adding it would make the same `install_cmd.install_by_key` offer the starship wizard makes for `nerd-font` possible. |
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
  ---
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "devstuff"
3
- version = "2.23.0"
3
+ version = "2.24.0"
4
4
  description = "Development environment setup CLI for Linux"
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.11"
@@ -38,6 +38,41 @@ def _select(prompt: str, choices: list, current: object) -> str:
38
38
  return ui.select(prompt, choices, default=default) or str(current)
39
39
 
40
40
 
41
+ class _DeltaGate:
42
+ """At most one install offer per wizard run (same reasoning as starship's _FontGate).
43
+
44
+ The pager question and the presets can be revisited from the review menu; a
45
+ declined offer should not come back every time, and a second look at a missing
46
+ delta gets the install hint without the prompt.
47
+ """
48
+
49
+ def __init__(self) -> None:
50
+ self._offered = False
51
+
52
+ def check(self, cfg: LazygitConfig) -> None:
53
+ if not cfg.pager or cfg.pager.split()[0] != "delta" or shutil.which("delta"):
54
+ return
55
+ ui.console.print()
56
+ ui.warn("delta is not on your PATH — diffs would fail to render until it is.")
57
+ if self._offered:
58
+ ui.dim(" Install it with: devstuff install delta")
59
+ return
60
+ self._offered = True
61
+
62
+ from dev_setup import registry
63
+ from dev_setup.commands.install_cmd import install_by_key
64
+
65
+ if registry.get("delta") is None: # pragma: no cover — the key is built in
66
+ ui.dim(" Install it with: devstuff install delta")
67
+ return
68
+ if not ui.confirm("Install delta now?", default=True):
69
+ ui.dim(" You can install it later: devstuff install delta")
70
+ return
71
+ if not install_by_key("delta", yes=True) or shutil.which("delta") is None:
72
+ ui.warn("delta still is not on your PATH.")
73
+ ui.dim(" You can install it later: devstuff install delta")
74
+
75
+
41
76
  def _ask_preset(cfg: LazygitConfig, found: detect.Lazygit) -> None:
42
77
  choices = [
43
78
  questionary.Choice(title=preset.label, value=preset.key, description=preset.description)
@@ -83,8 +118,8 @@ def _ask_icons(cfg: LazygitConfig, found: detect.Lazygit) -> None:
83
118
 
84
119
  def _ask_pager(cfg: LazygitConfig) -> None:
85
120
  ui.console.print()
86
- ui.dim(" An external pager renders diffs. delta is the usual choice; it must be")
87
- ui.dim(" installed separately and needs --paging=never so it does not open its own.")
121
+ ui.dim(" An external pager renders diffs. delta is the usual choice (the wizard offers")
122
+ ui.dim(" to install it if it is missing) and needs --paging=never so it does not open its own.")
88
123
  choices = [
89
124
  questionary.Choice(title=label, value=command) for command, label in PAGERS.items()
90
125
  ]
@@ -94,7 +129,7 @@ def _ask_pager(cfg: LazygitConfig) -> None:
94
129
  cfg.pager = chosen
95
130
  if cfg.pager:
96
131
  tool = cfg.pager.split()[0]
97
- if shutil.which(tool) is None:
132
+ if tool != "delta" and shutil.which(tool) is None:
98
133
  ui.warn(f"{tool} is not on your PATH — diffs would fail to render until it is.")
99
134
  cfg.color_arg = "always"
100
135
 
@@ -347,8 +382,10 @@ def run(*, target: Path | None = None) -> LazygitConfig | None:
347
382
  _report(found)
348
383
 
349
384
  ui.console.print()
385
+ delta = _DeltaGate()
350
386
  _ask_preset(cfg, found)
351
387
  _ask_icons(cfg, found)
388
+ delta.check(cfg)
352
389
 
353
390
  while True:
354
391
  _show_preview(cfg, found)
@@ -374,10 +411,12 @@ def run(*, target: Path | None = None) -> LazygitConfig | None:
374
411
  if action == "preset":
375
412
  _ask_preset(cfg, found)
376
413
  _ask_icons(cfg, found)
414
+ delta.check(cfg)
377
415
  elif action == "icons":
378
416
  _ask_icons(cfg, found)
379
417
  elif action == "pager":
380
418
  _ask_pager(cfg)
419
+ delta.check(cfg)
381
420
  elif action == "appearance":
382
421
  _ask_appearance(cfg)
383
422
  elif action == "git":
@@ -79,6 +79,12 @@ links:
79
79
  category: shell
80
80
  url: https://github.com/tmux/tmux/wiki
81
81
 
82
+ explainshell:
83
+ name: explainshell
84
+ description: Paste a shell command to see what each part and flag does
85
+ category: shell
86
+ url: https://explainshell.com/
87
+
82
88
  conventional-commits:
83
89
  name: Conventional Commits
84
90
  description: The commit message specification used by commitizen
@@ -109,6 +115,18 @@ links:
109
115
  category: reference
110
116
  url: https://devhints.io/
111
117
 
118
+ devdocs:
119
+ name: DevDocs
120
+ description: API documentation for hundreds of languages and libraries in one searchable, offline-capable site
121
+ category: reference
122
+ url: https://devdocs.io/
123
+
124
+ archwiki:
125
+ name: ArchWiki
126
+ description: In-depth Linux reference for system configuration and tools, useful well beyond Arch
127
+ category: reference
128
+ url: https://wiki.archlinux.org/
129
+
112
130
  awesome-open-source:
113
131
  name: Awesome Open Source
114
132
  description: Curated open source projects browsable by topic and language
@@ -121,6 +139,12 @@ links:
121
139
  category: discovery
122
140
  url: https://fmhy.net/developer-tools
123
141
 
142
+ awesome-selfhosted:
143
+ name: Awesome Selfhosted
144
+ description: Curated index of free self-hostable software
145
+ category: discovery
146
+ url: https://awesome-selfhosted.net/
147
+
124
148
  crontab-guru:
125
149
  name: crontab guru
126
150
  description: Editor for cron schedule expressions that explains in plain English when a schedule runs
@@ -210,3 +234,9 @@ links:
210
234
  description: Free and open platform for network and host visibility, honeypots, and log and case management, with a Pro edition
211
235
  category: security
212
236
  url: https://securityonionsolutions.com/software
237
+
238
+ deps-dev:
239
+ name: deps.dev
240
+ description: Open-source package explorer — versions, dependency graphs, advisories and supply-chain signals
241
+ category: security
242
+ url: https://deps.dev/