devstuff 2.21.0__tar.gz → 2.22.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 (264) hide show
  1. {devstuff-2.21.0 → devstuff-2.22.0}/.github/workflows/test-installs.yml +1 -0
  2. {devstuff-2.21.0 → devstuff-2.22.0}/AGENTS.md +3 -1
  3. {devstuff-2.21.0 → devstuff-2.22.0}/CHANGELOG.md +6 -0
  4. {devstuff-2.21.0 → devstuff-2.22.0}/CLAUDE.md +39 -5
  5. {devstuff-2.21.0 → devstuff-2.22.0}/PKG-INFO +4 -1
  6. {devstuff-2.21.0 → devstuff-2.22.0}/README.md +3 -0
  7. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/README.md +1 -0
  8. devstuff-2.22.0/docs/specs/syncthing-config/development-plan.md +93 -0
  9. devstuff-2.22.0/docs/specs/syncthing-config/specifications.md +179 -0
  10. devstuff-2.22.0/docs/specs/syncthing-config/stack-decisions.md +131 -0
  11. {devstuff-2.21.0 → devstuff-2.22.0}/pyproject.toml +1 -1
  12. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/__init__.py +6 -0
  13. devstuff-2.22.0/src/dev_setup/configure/syncthing/__init__.py +1 -0
  14. devstuff-2.22.0/src/dev_setup/configure/syncthing/api.py +144 -0
  15. devstuff-2.22.0/src/dev_setup/configure/syncthing/detect.py +77 -0
  16. devstuff-2.22.0/src/dev_setup/configure/syncthing/model.py +241 -0
  17. devstuff-2.22.0/src/dev_setup/configure/syncthing/wizard.py +277 -0
  18. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/tools.yaml +31 -0
  19. devstuff-2.22.0/tests/test_configure_syncthing.py +640 -0
  20. {devstuff-2.21.0 → devstuff-2.22.0}/uv.lock +1 -1
  21. {devstuff-2.21.0 → devstuff-2.22.0}/.claude/skills/run-stuff/SKILL.md +0 -0
  22. {devstuff-2.21.0 → devstuff-2.22.0}/.claude/skills/run-stuff/smoke.sh +0 -0
  23. {devstuff-2.21.0 → devstuff-2.22.0}/.github/codex/review.md +0 -0
  24. {devstuff-2.21.0 → devstuff-2.22.0}/.github/workflows/agent.yml +0 -0
  25. {devstuff-2.21.0 → devstuff-2.22.0}/.github/workflows/bump.yml +0 -0
  26. {devstuff-2.21.0 → devstuff-2.22.0}/.github/workflows/ci.yml +0 -0
  27. {devstuff-2.21.0 → devstuff-2.22.0}/.github/workflows/publish.yml +0 -0
  28. {devstuff-2.21.0 → devstuff-2.22.0}/.gitignore +0 -0
  29. {devstuff-2.21.0 → devstuff-2.22.0}/dev/Dockerfile +0 -0
  30. {devstuff-2.21.0 → devstuff-2.22.0}/dev/Dockerfile.ci +0 -0
  31. {devstuff-2.21.0 → devstuff-2.22.0}/dev/Makefile +0 -0
  32. {devstuff-2.21.0 → devstuff-2.22.0}/dev/docker-compose.yml +0 -0
  33. {devstuff-2.21.0 → devstuff-2.22.0}/devstuff +0 -0
  34. {devstuff-2.21.0 → devstuff-2.22.0}/docs/ROADMAP.md +0 -0
  35. {devstuff-2.21.0 → devstuff-2.22.0}/docs/github-agent.md +0 -0
  36. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/agent/development-plan.md +0 -0
  37. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/agent/specifications.md +0 -0
  38. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/agent/stack-decisions.md +0 -0
  39. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/ansible-config/development-plan.md +0 -0
  40. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/ansible-config/specifications.md +0 -0
  41. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/ansible-config/stack-decisions.md +0 -0
  42. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/bat-config/development-plan.md +0 -0
  43. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/bat-config/specifications.md +0 -0
  44. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/bat-config/stack-decisions.md +0 -0
  45. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/commitizen-config/development-plan.md +0 -0
  46. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/commitizen-config/specifications.md +0 -0
  47. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/commitizen-config/stack-decisions.md +0 -0
  48. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/docker-config/development-plan.md +0 -0
  49. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/docker-config/specifications.md +0 -0
  50. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/docker-config/stack-decisions.md +0 -0
  51. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/lazygit-config/development-plan.md +0 -0
  52. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/lazygit-config/specifications.md +0 -0
  53. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/lazygit-config/stack-decisions.md +0 -0
  54. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/mcp/development-plan.md +0 -0
  55. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/mcp/specifications.md +0 -0
  56. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/mcp/stack-decisions.md +0 -0
  57. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/outdated/development-plan.md +0 -0
  58. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/outdated/specifications.md +0 -0
  59. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/outdated/stack-decisions.md +0 -0
  60. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/plan-and-progress/specifications.md +0 -0
  61. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/precommit-config/development-plan.md +0 -0
  62. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/precommit-config/specifications.md +0 -0
  63. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/precommit-config/stack-decisions.md +0 -0
  64. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/profile/development-plan.md +0 -0
  65. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/profile/specifications.md +0 -0
  66. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/profile/stack-decisions.md +0 -0
  67. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/profile-apply/development-plan.md +0 -0
  68. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/profile-apply/specifications.md +0 -0
  69. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/profile-apply/stack-decisions.md +0 -0
  70. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/starship-config/development-plan.md +0 -0
  71. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/starship-config/specifications.md +0 -0
  72. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/starship-config/stack-decisions.md +0 -0
  73. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/uv-backbone/development-plan.md +0 -0
  74. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/uv-backbone/specifications.md +0 -0
  75. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/uv-backbone/stack-decisions.md +0 -0
  76. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/verbose-mode/development-plan.md +0 -0
  77. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/verbose-mode/specifications.md +0 -0
  78. {devstuff-2.21.0 → devstuff-2.22.0}/docs/specs/verbose-mode/stack-decisions.md +0 -0
  79. {devstuff-2.21.0 → devstuff-2.22.0}/install.sh +0 -0
  80. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/__init__.py +0 -0
  81. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/__main__.py +0 -0
  82. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/agent/__init__.py +0 -0
  83. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/agent/approval.py +0 -0
  84. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/agent/bridges.py +0 -0
  85. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/agent/catalog.py +0 -0
  86. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/agent/completion.py +0 -0
  87. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/agent/config.py +0 -0
  88. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/agent/loop.py +0 -0
  89. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/agent/ollama.py +0 -0
  90. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/agent/preflight.py +0 -0
  91. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/agent/primitives.py +0 -0
  92. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/agent/registry.py +0 -0
  93. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/agent/sandbox.py +0 -0
  94. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/agent/session.py +0 -0
  95. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/agent/transcript.py +0 -0
  96. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/agent/wizard.py +0 -0
  97. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/agent_tools.schema.json +0 -0
  98. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/agent_tools.yaml +0 -0
  99. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/apply_exec.py +0 -0
  100. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/apply_plan.py +0 -0
  101. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/base.py +0 -0
  102. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/bundles/ai-agents.yaml +0 -0
  103. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/bundles/ai-local.yaml +0 -0
  104. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/bundles/devops.yaml +0 -0
  105. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/bundles/essentials.yaml +0 -0
  106. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/bundles/languages.yaml +0 -0
  107. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/bundles/python.yaml +0 -0
  108. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/bundles.py +0 -0
  109. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/catalog.py +0 -0
  110. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/cli.py +0 -0
  111. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/__init__.py +0 -0
  112. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/_plan.py +0 -0
  113. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/add_cmd.py +0 -0
  114. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/agent_cmd.py +0 -0
  115. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/catalog_cmd.py +0 -0
  116. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/configure_cmd.py +0 -0
  117. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/delete_cmd.py +0 -0
  118. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/docs_cmd.py +0 -0
  119. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/doctor_cmd.py +0 -0
  120. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/functions_cmd.py +0 -0
  121. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/help_cmd.py +0 -0
  122. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/install_cmd.py +0 -0
  123. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/links_cmd.py +0 -0
  124. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/list_cmd.py +0 -0
  125. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/mcp_cmd.py +0 -0
  126. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/outdated_cmd.py +0 -0
  127. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/profile_cmd.py +0 -0
  128. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/remove_cmd.py +0 -0
  129. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/run_cmd.py +0 -0
  130. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/skills_cmd.py +0 -0
  131. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/commands/update_cmd.py +0 -0
  132. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/ansible/__init__.py +0 -0
  133. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/ansible/detect.py +0 -0
  134. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/ansible/model.py +0 -0
  135. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/ansible/render.py +0 -0
  136. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/ansible/validate.py +0 -0
  137. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/ansible/wizard.py +0 -0
  138. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/bat/__init__.py +0 -0
  139. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/bat/detect.py +0 -0
  140. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/bat/model.py +0 -0
  141. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/bat/preview.py +0 -0
  142. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/bat/render.py +0 -0
  143. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/bat/wizard.py +0 -0
  144. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/commitizen/__init__.py +0 -0
  145. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/commitizen/detect.py +0 -0
  146. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/commitizen/model.py +0 -0
  147. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/commitizen/render.py +0 -0
  148. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/commitizen/validate.py +0 -0
  149. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/commitizen/wizard.py +0 -0
  150. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/docker/__init__.py +0 -0
  151. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/docker/detect.py +0 -0
  152. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/docker/model.py +0 -0
  153. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/docker/render.py +0 -0
  154. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/docker/validate.py +0 -0
  155. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/docker/wizard.py +0 -0
  156. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/lazygit/__init__.py +0 -0
  157. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/lazygit/detect.py +0 -0
  158. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/lazygit/model.py +0 -0
  159. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/lazygit/render.py +0 -0
  160. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/lazygit/validate.py +0 -0
  161. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/lazygit/wizard.py +0 -0
  162. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/precommit/__init__.py +0 -0
  163. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/precommit/detect.py +0 -0
  164. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/precommit/model.py +0 -0
  165. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/precommit/render.py +0 -0
  166. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/precommit/validate.py +0 -0
  167. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/precommit/wizard.py +0 -0
  168. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/reptyr/__init__.py +0 -0
  169. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/reptyr/wizard.py +0 -0
  170. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/starship/__init__.py +0 -0
  171. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/starship/fonts.py +0 -0
  172. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/starship/icons.py +0 -0
  173. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/starship/model.py +0 -0
  174. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/starship/preview.py +0 -0
  175. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/starship/render.py +0 -0
  176. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/configure/starship/wizard.py +0 -0
  177. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/doctor.py +0 -0
  178. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/function_runner.py +0 -0
  179. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/functions.schema.json +0 -0
  180. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/functions.yaml +0 -0
  181. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/functions_catalog.py +0 -0
  182. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/functions_registry.py +0 -0
  183. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/generic.py +0 -0
  184. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/links.schema.json +0 -0
  185. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/links.yaml +0 -0
  186. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/links_catalog.py +0 -0
  187. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/links_registry.py +0 -0
  188. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/mcp/__init__.py +0 -0
  189. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/mcp/core.py +0 -0
  190. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/mcp/http.py +0 -0
  191. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/mcp/openapi.py +0 -0
  192. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/mcp/printconfig.py +0 -0
  193. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/mcp/process.py +0 -0
  194. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/mcp/stdio.py +0 -0
  195. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/mcp/token.py +0 -0
  196. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/profile.py +0 -0
  197. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/registry.py +0 -0
  198. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/snapshot.py +0 -0
  199. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/ui.py +0 -0
  200. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/updates.py +0 -0
  201. {devstuff-2.21.0 → devstuff-2.22.0}/src/dev_setup/verbose.py +0 -0
  202. {devstuff-2.21.0 → devstuff-2.22.0}/tests/__init__.py +0 -0
  203. {devstuff-2.21.0 → devstuff-2.22.0}/tests/integration/__init__.py +0 -0
  204. {devstuff-2.21.0 → devstuff-2.22.0}/tests/integration/conftest.py +0 -0
  205. {devstuff-2.21.0 → devstuff-2.22.0}/tests/integration/test_agent_smoke.py +0 -0
  206. {devstuff-2.21.0 → devstuff-2.22.0}/tests/integration/test_agent_tui.py +0 -0
  207. {devstuff-2.21.0 → devstuff-2.22.0}/tests/integration/test_commitizen_config.py +0 -0
  208. {devstuff-2.21.0 → devstuff-2.22.0}/tests/integration/test_mcp_claude.py +0 -0
  209. {devstuff-2.21.0 → devstuff-2.22.0}/tests/integration/test_mcp_conformance.py +0 -0
  210. {devstuff-2.21.0 → devstuff-2.22.0}/tests/integration/test_profile_apply.py +0 -0
  211. {devstuff-2.21.0 → devstuff-2.22.0}/tests/integration/test_tools.py +0 -0
  212. {devstuff-2.21.0 → devstuff-2.22.0}/tests/mcp_http_support.py +0 -0
  213. {devstuff-2.21.0 → devstuff-2.22.0}/tests/mcp_process_support.py +0 -0
  214. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_agent.py +0 -0
  215. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_agent_bridges.py +0 -0
  216. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_agent_completion.py +0 -0
  217. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_agent_loop.py +0 -0
  218. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_agent_sandbox.py +0 -0
  219. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_agent_tools.py +0 -0
  220. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_agent_wizard.py +0 -0
  221. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_apply_exec.py +0 -0
  222. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_apply_plan.py +0 -0
  223. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_apply_run.py +0 -0
  224. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_bundles.py +0 -0
  225. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_catalog.py +0 -0
  226. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_configure_ansible.py +0 -0
  227. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_configure_bat.py +0 -0
  228. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_configure_commitizen.py +0 -0
  229. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_configure_docker.py +0 -0
  230. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_configure_lazygit.py +0 -0
  231. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_configure_precommit.py +0 -0
  232. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_configure_reptyr.py +0 -0
  233. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_configure_starship.py +0 -0
  234. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_doctor.py +0 -0
  235. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_functions.py +0 -0
  236. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_generic.py +0 -0
  237. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_installed_version.py +0 -0
  238. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_lifecycle_cmds.py +0 -0
  239. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_links.py +0 -0
  240. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_mcp_classify.py +0 -0
  241. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_mcp_core.py +0 -0
  242. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_mcp_http.py +0 -0
  243. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_mcp_http_cmd.py +0 -0
  244. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_mcp_openapi.py +0 -0
  245. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_mcp_printconfig.py +0 -0
  246. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_mcp_process.py +0 -0
  247. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_mcp_stdio.py +0 -0
  248. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_mcp_token.py +0 -0
  249. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_outdated_cmd.py +0 -0
  250. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_pin_support.py +0 -0
  251. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_plan_and_select.py +0 -0
  252. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_profile.py +0 -0
  253. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_profile_apply_cmd.py +0 -0
  254. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_profile_diff.py +0 -0
  255. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_profile_diff_cmd.py +0 -0
  256. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_profile_snapshot_cmd.py +0 -0
  257. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_registry.py +0 -0
  258. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_snapshot.py +0 -0
  259. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_ui.py +0 -0
  260. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_update_checker_parity.py +0 -0
  261. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_update_notes.py +0 -0
  262. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_updates.py +0 -0
  263. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_uv_probes.py +0 -0
  264. {devstuff-2.21.0 → devstuff-2.22.0}/tests/test_verbose.py +0 -0
@@ -84,6 +84,7 @@ jobs:
84
84
  - reptyr
85
85
  - saml2aws
86
86
  - starship
87
+ - syncthing # official apt repo (v2); no systemd user session in CI
87
88
  - uv
88
89
  - yq
89
90
 
@@ -66,7 +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
- None.
69
+ | PR | Branch | Base | Notes |
70
+ |---|---|---|---|
71
+ | [#75](https://github.com/thesawdawg/dev-setup-py/pull/75) `syncthing` tool + `configure syncthing` pairing wizard | `feat/syncthing` | `master` | Opened 2026-10-12. Not yet run: a real `devstuff install syncthing` (the CI canary is its first run) and the wizard against a live user service. |
70
72
 
71
73
  ### Closed as dropped
72
74
 
@@ -1,3 +1,9 @@
1
+ ## v2.22.0 (2026-10-12)
2
+
3
+ ### Features
4
+
5
+ - **syncthing**: add the syncthing tool and a device-pairing configurator
6
+
1
7
  ## v2.21.0 (2026-10-12)
2
8
 
3
9
  ### Features
@@ -375,15 +375,18 @@ ones tools already have.
375
375
  ## Configurators (`configure/`) — tool-specific wizards, deliberately *not* catalog-driven
376
376
 
377
377
  `src/dev_setup/configure/` holds per-tool setup wizards (`devstuff configure <tool>`), registered
378
- in a `CONFIGURATORS` dict keyed by catalog tool key. There are seven:
378
+ in a `CONFIGURATORS` dict keyed by catalog tool key. There are nine:
379
379
  `configure/starship/{model,render,preview,fonts,wizard}.py`,
380
380
  `configure/commitizen/{model,render,detect,validate,wizard}.py`,
381
381
  `configure/precommit/{model,render,detect,validate,wizard}.py` (the package can't be named
382
382
  `pre-commit`, so the hyphenated catalog key maps to the `precommit` package in `CONFIGURATORS`),
383
383
  `configure/docker/{model,render,detect,validate,wizard}.py`,
384
384
  `configure/bat/{model,render,detect,preview,wizard}.py`,
385
- `configure/ansible/{model,render,detect,validate,wizard}.py` and
386
- `configure/lazygit/{model,render,detect,validate,wizard}.py`.
385
+ `configure/ansible/{model,render,detect,validate,wizard}.py`,
386
+ `configure/lazygit/{model,render,detect,validate,wizard}.py`,
387
+ `configure/reptyr/wizard.py` and
388
+ `configure/syncthing/{model,api,detect,wizard}.py` (the only one that configures a *running
389
+ service* through its REST API rather than writing a file — `--output` is refused).
387
390
 
388
391
  **The pattern they all share, and the one thing that matters most when adding another:**
389
392
  *measure the tool, don't recall it.* Every configurator's `model.py` was built by interrogating
@@ -646,10 +649,41 @@ Full reasoning in `docs/specs/lazygit-config/`.
646
649
  - **Icons reuse `configure/starship/fonts.detect()`**, including its `None` — "cannot tell" is
647
650
  not "no", and inverting that would nag every user without fontconfig.
648
651
 
652
+ **Within the syncthing configurator, a 200 from the REST API is not evidence the config
653
+ changed.** Everything below was measured against syncthing v2.1.6; full reasoning in
654
+ `docs/specs/syncthing-config/`.
655
+
656
+ **Things learned from the real binary — don't "simplify" these away:**
657
+ - **Writes go to the collection endpoints with POST, never `PUT …/<id>`.** The collection
658
+ POSTs upsert and carry any id in the body — a folder id containing `/` 404s the
659
+ `PUT /rest/config/folders/<id>` route even percent-encoded, and POSTs fine.
660
+ - **The device must be written before the folder that lists it.** A folder `devices` entry
661
+ naming a device absent from `config.devices` is *silently dropped* with a 200 — that is why
662
+ `wizard.apply` posts in that order and `model.verify` re-reads the config afterwards.
663
+ - **An unknown folder `type` is stored as `sendreceive`**, not rejected — so the mode comes
664
+ from a picker, and `verify()` compares the stored type to what was asked for.
665
+ - **Syncthing accepts nested/overlapping folder paths without complaint** — the overlap check
666
+ is `model.paths_overlap`, ours alone, and it compares resolved paths (`/a/sync` vs
667
+ `/a/sync2` must not match).
668
+ - **The wizard always sends an absolute, resolved folder path** — syncthing accepts relative
669
+ and `~/` paths and resolves them against the daemon's working directory, which is not
670
+ necessarily the user's home.
671
+ - **The API key is never printed, logged or put on a command line** — it lives in the
672
+ `X-API-Key` header, `Endpoint.__repr__` redacts it, and error paths escape outside text
673
+ through `rich.markup.escape` before Rich sees it.
674
+ - **Linger is asked about in the wizard, never set by the install** — `loginctl
675
+ enable-linger` needs sudo and changes a system-wide property; a `None` from
676
+ `detect.linger_enabled()` means "cannot tell" and stays quiet.
677
+ - The tool's install uses the **official apt repo (stable-v2)**, not the Ubuntu archive
678
+ (1.29), and its remove deliberately leaves the apt source, keyring, config and linger in
679
+ place.
680
+
649
681
  Not yet built: configurators for anything other than starship, commitizen, pre-commit, docker,
650
- bat, ansible and lazygit; `repo: local` pre-commit hook authoring and hooks outside the curated
682
+ bat, ansible, lazygit, reptyr and syncthing; `repo: local` pre-commit hook authoring and hooks outside the curated
651
683
  catalog; lazygit keybindings and `customCommands` authoring (both preserved, never edited);
652
- ansible fact-caching backends; and — for pre-commit and commitizen only — round-tripping an
684
+ ansible fact-caching backends; the syncthing `sendonly`/`receiveencrypted` folder modes,
685
+ sharing more than one folder per run, and automating the server-side approval (still a manual
686
+ step, printed at the end); and — for pre-commit and commitizen only — round-tripping an
653
687
  existing hand-edited config back into wizard state. The four newer configurators *do* round-trip,
654
688
  because JSON, INI, bat's flag list and lazygit's YAML are all flat enough to preserve faithfully;
655
689
  pre-commit's is not, and that asymmetry is deliberate (see each spec's stack-decisions).
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: devstuff
3
- Version: 2.21.0
3
+ Version: 2.22.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>
@@ -581,6 +581,7 @@ devstuff configure starship --output /tmp/try.toml # write elsewhere, leave th
581
581
  | `lazygit` | Icons, diff pager, panels and git behaviour |
582
582
  | `pre-commit` | Which git hooks run, when they run, and what they're allowed to rewrite |
583
583
  | `starship` | Prompt style, colour palette, which sections appear, and layout |
584
+ | `syncthing` | Pair this machine with a server device and share one folder, via the local API |
584
585
 
585
586
  The reptyr wizard verifies the live kernel setting after applying it. Other wizards check
586
587
  their result against the real tool before saving. What that check can prove
@@ -593,6 +594,7 @@ varies a lot, and the wizards say so rather than implying more than they know:
593
594
  | `docker` | key typos, malformed CIDRs, numeric log options | **five configs `dockerd --validate` accepts that stop every container from starting** |
594
595
  | `lazygit` | wrong types (refuses to start) | **unknown keys and invalid enum values** — both silently ignored |
595
596
  | `pre-commit` | the file's shape | **hook ids** — `validate-config` never opens a repository |
597
+ | `syncthing` | malformed IDs and payloads (HTTP 400) | **whether the config actually stored what was sent** — the API returns 200 while dropping a folder's unknown device or coercing an unknown folder type |
596
598
 
597
599
  #### Commitizen wizard
598
600
 
@@ -1668,6 +1670,7 @@ links:
1668
1670
  | `pre-commit` | pre-commit | Git hook manager for automated code quality checks (`devstuff configure pre-commit`) | `pre-commit --help` |
1669
1671
  | `saml2aws` | saml2aws | SAML → AWS STS credentials CLI (Versent) | `saml2aws --help` |
1670
1672
  | `starship` | Starship | Fast, cross-shell customizable prompt (`devstuff configure starship`) | `starship --help` |
1673
+ | `syncthing` | Syncthing | Peer-to-peer file sync daemon (`devstuff configure syncthing` to pair devices) | `syncthing --help` |
1671
1674
  | `yq` | yq | Portable command-line YAML/JSON/XML processor | `yq --help` |
1672
1675
 
1673
1676
  ### Languages
@@ -554,6 +554,7 @@ devstuff configure starship --output /tmp/try.toml # write elsewhere, leave th
554
554
  | `lazygit` | Icons, diff pager, panels and git behaviour |
555
555
  | `pre-commit` | Which git hooks run, when they run, and what they're allowed to rewrite |
556
556
  | `starship` | Prompt style, colour palette, which sections appear, and layout |
557
+ | `syncthing` | Pair this machine with a server device and share one folder, via the local API |
557
558
 
558
559
  The reptyr wizard verifies the live kernel setting after applying it. Other wizards check
559
560
  their result against the real tool before saving. What that check can prove
@@ -566,6 +567,7 @@ varies a lot, and the wizards say so rather than implying more than they know:
566
567
  | `docker` | key typos, malformed CIDRs, numeric log options | **five configs `dockerd --validate` accepts that stop every container from starting** |
567
568
  | `lazygit` | wrong types (refuses to start) | **unknown keys and invalid enum values** — both silently ignored |
568
569
  | `pre-commit` | the file's shape | **hook ids** — `validate-config` never opens a repository |
570
+ | `syncthing` | malformed IDs and payloads (HTTP 400) | **whether the config actually stored what was sent** — the API returns 200 while dropping a folder's unknown device or coercing an unknown folder type |
569
571
 
570
572
  #### Commitizen wizard
571
573
 
@@ -1641,6 +1643,7 @@ links:
1641
1643
  | `pre-commit` | pre-commit | Git hook manager for automated code quality checks (`devstuff configure pre-commit`) | `pre-commit --help` |
1642
1644
  | `saml2aws` | saml2aws | SAML → AWS STS credentials CLI (Versent) | `saml2aws --help` |
1643
1645
  | `starship` | Starship | Fast, cross-shell customizable prompt (`devstuff configure starship`) | `starship --help` |
1646
+ | `syncthing` | Syncthing | Peer-to-peer file sync daemon (`devstuff configure syncthing` to pair devices) | `syncthing --help` |
1644
1647
  | `yq` | yq | Portable command-line YAML/JSON/XML processor | `yq --help` |
1645
1648
 
1646
1649
  ### Languages
@@ -46,6 +46,7 @@ They are most useful when they capture:
46
46
  | [`bat-config/`](bat-config/) — `devstuff configure bat`, the theme and decoration wizard | Complete (v1) |
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
+ | [`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) |
49
50
  | [`verbose-mode/`](verbose-mode/) — `-v`/`-vv`, the process-wide verbosity level | Complete (v1) |
50
51
  | [`outdated/`](outdated/) — `devstuff outdated`, the read-only installed-vs-latest report | Complete (v1) |
51
52
  | [`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,93 @@
1
+ # Development Plan: `devstuff configure syncthing`
2
+
3
+ **Date:** 2026-10-12
4
+ **Status:** Milestones 1–4 complete; first real `devstuff install syncthing` and a live
5
+ wizard run against a real service are still pending (see "What was run and what was not").
6
+
7
+ ---
8
+
9
+ ## Milestones
10
+
11
+ | # | Milestone | Deliverable | Done when |
12
+ |---|-----------|-------------|-----------|
13
+ | 1 | Catalog entry | `syncthing` in `tools.yaml` (`type: bash`, official v2 apt repo, user service), CI matrix + README rows | `devstuff list` shows it; `test_ci_matrix_covers_every_builtin_tool` passes |
14
+ | 2 | Model | `configure/syncthing/model.py` — device-ID Luhn, `paths_overlap`, `Request`, `plan`, `build_*`, `verify` | Every refusal branch and both real device IDs unit-tested |
15
+ | 3 | API + detect | `configure/syncthing/{api,detect}.py` — config.xml discovery, urllib `Client`, probes | `discover` fixtures cover loopback/wildcard/tls/unix/non-loopback |
16
+ | 4 | Wizard + registry | `configure/syncthing/wizard.py`, `CONFIGURATORS` entry | Happy-path, verify-failure and refusal tests pass; `--list`/`--path` work |
17
+ | 5 | Docs | this spec, CLAUDE.md, README | Spec matches the code |
18
+
19
+ ## Testing Strategy
20
+
21
+ **`tests/test_configure_syncthing.py` — 38 tests, unit by default:**
22
+
23
+ - **Device IDs:** both real syncthing-generated IDs validate; a last-char flip and a
24
+ single data-char substitution are rejected; lowercase/dashless forms normalise;
25
+ wrong length and bad charset (`0`, `1`, `8`) each get their own reason. The Luhn
26
+ implementation is pinned against the real IDs, not a recollection.
27
+ - **`plan()`:** every refusal branch (own ID, path conflict, type conflict, overlap)
28
+ plus create/share/none and the existing-device-is-untouched case.
29
+ - **`verify()`:** each silent failure it exists to catch — the dropped folder-device
30
+ entry, the coerced type, the absent device — with config dicts that really exhibit
31
+ the behaviour.
32
+ - **`discover()`:** config.xml fixtures for each address shape; `Endpoint.__repr__`
33
+ proven not to contain the key.
34
+ - **Wizard:** happy path against a fake `Client` (asserts device-before-folder POST
35
+ order, that the local ID is printed for the server side, and that the API key never
36
+ reaches captured output); verify-failure returns `None`; `--output` refused;
37
+ ID re-prompts; linger-off and service-inactive branches run the right commands.
38
+
39
+ **Against the real binary (skipped without `syncthing`):**
40
+
41
+ - `test_pairing_two_real_instances` generates two throwaway instances under a tmp
42
+ `--home`, pairs A→B through the real plan/build/apply/verify path with a folder ID
43
+ containing `/`, and asserts B's `cluster/pending/devices` lists A — the
44
+ "server-side approval still required" behaviour, end to end.
45
+ - `test_the_silent_drop_and_type_coercion_the_wizard_guards` asserts the two silent
46
+ behaviours the whole write-order + verify design depends on, so a future syncthing
47
+ that starts *rejecting* them is caught here.
48
+ - Both instances are killed in the fixture finalizer via a `pkill` on the unique
49
+ `--home` path — `serve` detaches its worker into its own session, so killing the
50
+ spawned process leaves it behind. Nothing touches `~/.local/state/syncthing` or the
51
+ user's running service.
52
+
53
+ ## What was run and what was not
54
+
55
+ **Run:**
56
+
57
+ - `uv run pytest tests/test_configure_syncthing.py` — 38 passed, including both
58
+ real-daemon tests against syncthing v2.1.6.
59
+ - The Luhn check against the two real device IDs, and the rejection of the
60
+ flipped-char ID that real syncthing also rejects (400).
61
+ - `uv run devstuff configure --list`, `configure syncthing --path`, `devstuff list`
62
+ — syncthing appears in all three.
63
+ - `syncthing generate`/`serve --help` against the installed v2.1.6 for the real flag
64
+ names.
65
+
66
+ **Not run:**
67
+
68
+ - `devstuff install syncthing` against a clean machine — the install script follows
69
+ the `gh` pattern but has not had its first real run; the CI matrix entry will
70
+ exercise it in a container (where the no-user-session branch is the expected path).
71
+ - The interactive wizard under a real pty against the user's real service — the host
72
+ this was developed on has a live syncthing config that must not be mutated; the
73
+ wizard path was exercised with a fake `Client` and monkeypatched prompts instead.
74
+ - `sudo loginctl enable-linger` — the command is asserted in a unit test, not
75
+ executed.
76
+
77
+ ## Risks
78
+
79
+ | Risk | Mitigation |
80
+ |------|------------|
81
+ | **The API returns 200 for a write it silently mangles** (dropped device entry, coerced type). | Write order (device before folder) plus `verify()` on a re-read config; problems are errors (FR-18/19). |
82
+ | **The API key leaks** into output, errors or `-v` logs. | Header-only auth, `ProxyHandler({})`, `Endpoint.__repr__` redaction, and a test asserting the key is absent from captured wizard output (NFR-4). |
83
+ | **A folder ID with a `/` needs the collection POST.** | All writes are POST; the live test's folder ID contains a slash so a PUT regression is caught (SD-2). |
84
+ | **Ubuntu's archive version gets installed instead of v2.** | The entry uses the official repo by name (`stable-v2`); no pin file needed today — revisit if Ubuntu ever ships a higher-versioned build (SD-3). |
85
+ | **The user runs the wizard as root.** | Refused up front — there is no root-owned user service to manage (FR-13). |
86
+
87
+ ## Not built
88
+
89
+ - `sendonly`/`receiveencrypted` folder modes, multiple folders per run, introducer or
90
+ auto-accept options.
91
+ - Server-side approval automation (Open Question 3) — printed as instructions instead.
92
+ - The `syncthing@<user>` system unit (SD-5).
93
+ - Removing the apt repo, config or linger on `remove` (SD-6).
@@ -0,0 +1,179 @@
1
+ # Specification: `devstuff install syncthing` + `devstuff configure syncthing`
2
+
3
+ **Date:** 2026-10-12
4
+ **Status:** Implemented (v1)
5
+ **Authors:** Sawyer + Devin
6
+
7
+ ---
8
+
9
+ ## 1. Problem Statement & Goals
10
+
11
+ Pairing a workstation with a storage server over Syncthing means: install the daemon,
12
+ get its systemd *user* service running, find the local API's address and key, add the
13
+ server's device ID, create or share a folder with it — and then still approve both on
14
+ the server. Each step has a different failure mode, and syncthing's REST API makes two
15
+ of them silent: a folder's `devices` entry naming a device not yet in the config is
16
+ dropped without an error, and an unrecognised folder `type` is stored as
17
+ `sendreceive`. A wizard that trusts the 200s reports success for a pairing that does
18
+ not exist.
19
+
20
+ `devstuff install syncthing` puts the official v2 build on the machine and enables the
21
+ user service. `devstuff configure syncthing` then does the pairing through the local
22
+ REST API, checking the stored config afterwards because the API's response code does
23
+ not say what it stored.
24
+
25
+ **Success criteria**
26
+
27
+ - Install gives a working syncthing v2 with its user service enabled where a user
28
+ session exists — and does not fail where there is none (CI container).
29
+ - The wizard pairs this machine with a server device and shares exactly one folder,
30
+ verified by re-reading the stored config.
31
+ - Nothing is written until the user confirms a review screen.
32
+ - The API key never appears in output, errors, logs or a process command line.
33
+ - Zero new runtime dependencies.
34
+
35
+ **Non-goals**
36
+
37
+ - Approving anything on the server side. The remote end is a human's GUI step; the
38
+ wizard prints the instructions and this machine's Device ID.
39
+ - `sendonly` and `receiveencrypted` folder modes, multiple folders per run,
40
+ introducer/auto-accept, and every other syncthing setting.
41
+ - The `syncthing@<user>` system unit — the wizard manages the packaged *user* unit
42
+ only.
43
+ - Removing syncthing's apt repo, config or keys on `remove` (see SD-6).
44
+
45
+ ---
46
+
47
+ ## 2. Functional Requirements
48
+
49
+ ### Catalog entry (`tools.yaml`)
50
+
51
+ - **FR-1** `syncthing` is a `bash`-type tool that installs from the official
52
+ `apt.syncthing.net` repo (`stable-v2`), not the Ubuntu archive (1.29).
53
+ - **FR-2** The install enables and starts the `syncthing.service` *user* unit when a
54
+ systemd user session exists, and succeeds with a printed hint when it does not.
55
+ - **FR-3** `remove` stops/disables the user service and removes the package, and says
56
+ what it left: the config/keys in `~/.local/state/syncthing`, the apt source and
57
+ keyring, and linger.
58
+
59
+ ### Model (`configure/syncthing/model.py`) — pure, no I/O
60
+
61
+ - **FR-4** `device_id_problem()` validates format, charset (A–Z, 2–7), length (56
62
+ after normalising) and the four Luhn mod-32 check digits, returning a
63
+ human-readable reason or `None`. `normalize_device_id()` uppercases, strips
64
+ whitespace/dashes and regroups into 8×7.
65
+ - **FR-5** `paths_overlap()` is true for equal paths or one inside the other, on
66
+ resolved paths; a shared path *prefix* is not overlap.
67
+ - **FR-6** `plan()` takes the `GET /rest/config` dict and a `Request` and returns a
68
+ `Plan` (`add_device`, `folder_action` ∈ create/share/none, review lines) or a
69
+ `Refusal`. Refusals: the server ID equals the local ID; a folder with the same ID
70
+ exists with a different resolved path or type (edit it in the GUI); the folder path
71
+ overlaps another folder's.
72
+ - **FR-7** `build_device()` fills the `defaults/device` template with the server ID,
73
+ name, `addresses=["dynamic"]`, `introducer=false`, `autoAcceptFolders=false`.
74
+ `build_folder()` fills `defaults/folder` for create, or appends the server device
75
+ to the existing folder for share; the result always lists local + server devices.
76
+ - **FR-8** `verify()` re-checks a re-read config: the device is present, the folder
77
+ is present with the asked-for resolved path and type, and the server is in the
78
+ folder's devices. Problems name the silent-drop/coercion behaviour they catch.
79
+
80
+ ### API (`configure/syncthing/api.py`)
81
+
82
+ - **FR-9** `discover(config.xml)` parses the `<gui>` element into an `Endpoint`:
83
+ `0.0.0.0`/`[::]` map to loopback; `tls="true"` produces https with verification
84
+ off, only for a loopback host; `unix://` and non-loopback hosts return a reason
85
+ string, not an endpoint.
86
+ - **FR-10** `Client` uses stdlib `urllib` with `ProxyHandler({})` (proxies must not
87
+ see the key) and a 5s timeout. The key goes only in the `X-API-Key` header.
88
+ `Endpoint.__repr__` redacts it; `ApiError` carries status and body, never the key.
89
+ - **FR-11** `wait_ready()` polls `system/status` until `myID` appears or the timeout
90
+ expires.
91
+
92
+ ### Detection (`configure/syncthing/detect.py`)
93
+
94
+ - **FR-12** `config_file()` parses `syncthing paths`, falling back to
95
+ `$XDG_STATE_HOME/syncthing/config.xml`, then legacy `~/.config/syncthing/` if it
96
+ exists. `user_session()`, `service_active()`, `has_systemd()` and
97
+ `linger_enabled()` probe via `generic._probe`; `None` from `linger_enabled`
98
+ means "cannot tell".
99
+
100
+ ### Wizard (`configure/syncthing/wizard.py`)
101
+
102
+ - **FR-13** `run(*, target=None)` refuses `--output` (there is no file to export)
103
+ and refuses euid 0 (syncthing is a per-user service).
104
+ - **FR-14** Without systemd or a user session it explains and stops. An inactive
105
+ service is offered to be started (`systemctl --user enable --now`), and the API is
106
+ then waited on.
107
+ - **FR-15** If linger is off the wizard explains it (sync while logged out, needs
108
+ sudo), asks (default Yes), runs `sudo loginctl enable-linger <user>`, and
109
+ re-checks. `None` stays quiet; declining continues.
110
+ - **FR-16** Prompts: server Device ID (locally validated, re-prompted; own ID
111
+ rejected), server name (skipped if the device exists, default "Storage server"),
112
+ folder ID (required, exact-match with the server), local path (default
113
+ `~/SyncthingShared`, expanded, must be absolute), mode picker.
114
+ - **FR-17** A review screen lists the planned changes as plain text; nothing is
115
+ written before the confirm. An already-configured pairing skips the write and goes
116
+ to the summary.
117
+ - **FR-18** The apply creates the folder directory, POSTs the device then the
118
+ folder (order is load-bearing, FR-8/SD-2), and a mid-apply `ApiError` reports what
119
+ was and wasn't written.
120
+ - **FR-19** Afterwards the config is re-read and `verify()`ed; problems are errors,
121
+ not warnings. On success the summary prints the hostname, this machine's Device
122
+ ID, folder ID/path/mode, the server-side approval steps and the GUI URL, and a
123
+ `restart-required` answer is acted on with a confirm.
124
+
125
+ ---
126
+
127
+ ## 3. Non-Functional Requirements
128
+
129
+ - **NFR-1** Zero new runtime dependencies; stdlib `urllib`, `xml.etree` only.
130
+ - **NFR-2** Unit tests need neither syncthing nor the network; the real-binary tests
131
+ `skipif` no `syncthing` binary and run throwaway instances under a tmp `--home`.
132
+ They never touch `~/.local/state/syncthing` or the running service.
133
+ - **NFR-3** All subprocess calls go through `generic._run`/`_probe`; all text from
134
+ outside (API errors, device IDs, reasons) goes through `rich.markup.escape` or a
135
+ `Text` before Rich sees it.
136
+ - **NFR-4** The API key is never printed, logged or passed on a command line.
137
+
138
+ ---
139
+
140
+ ## 4. Open Questions
141
+
142
+ | # | Question | Status |
143
+ |---|----------|--------|
144
+ | 1 | Should the wizard offer to install syncthing when it is missing? | **Resolved 2026-10-12 — no extra handling.** The generic command layer already warns + offers (`configure_cmd` checks `is_installed`), and the wizard stops at "no config file" anyway. |
145
+ | 2 | Should `--output` export something anyway (e.g. a device+folder JSON)? | **Resolved 2026-10-12 — no.** The artifact would be a script input for `curl`, not a config file; the API is the only writer. |
146
+ | 3 | Should the wizard automate the server-side approval? | **Open.** Needs credentials on the server; out of scope for v1. |
147
+
148
+ ---
149
+
150
+ ## 5. Findings That Changed the Design
151
+
152
+ Measured against syncthing v2.1.6 on two throwaway instances — each one drove a part
153
+ of the design rather than being trusted:
154
+
155
+ - **The collection `POST` endpoints upsert by id; `PUT /rest/config/folders/<id>`
156
+ 404s on an id containing `/`**, even percent-encoded. All writes use POST; the
157
+ user's real folder id contains a slash.
158
+ - **A folder `devices` entry for a device not in `config.devices` is silently
159
+ dropped with a 200.** Hence the write order (device first) and `verify()`'s
160
+ re-read — "the API took it" and "the config stored it" are different facts.
161
+ - **`type: "bogus"` is stored as `sendreceive`, not rejected.** The mode picker and
162
+ the verify step both exist because of this.
163
+ - **Nested and identical-overlapping folder paths are accepted** and sit `idle`.
164
+ The overlap check is entirely the wizard's.
165
+ - **Relative and `~/` folder paths are accepted and resolved against the daemon's
166
+ working directory** — the wizard expands and resolves the path itself and always
167
+ sends an absolute one.
168
+ - **Device-ID validation is local-worthwhile:** the API rejects bad IDs with a 400,
169
+ but only after the write attempt; the wizard catches typos (charset, length,
170
+ check digit) in the prompt loop.
171
+ - **`GET /rest/config/defaults/{device,folder}` return usable templates** — the
172
+ folder defaults already include the local device — so `build_*` fills templates
173
+ rather than authoring dicts from scratch.
174
+ - **`serve` detaches its worker into its own session.** Killing the monitor process
175
+ leaves the worker running; the live-test fixture cleans up by the unique `--home`
176
+ path instead.
177
+ - **Both instances generated before either listens can be probed onto the same
178
+ port.** The fixture pins each throwaway daemon's `listenAddress` to a distinct
179
+ free port.
@@ -0,0 +1,131 @@
1
+ # Stack Decisions: `devstuff configure syncthing`
2
+
3
+ **Date:** 2026-10-12
4
+ **Context:** The ninth configurator, and the first that configures a *running service*
5
+ through its REST API instead of writing a config file. SD-1/SD-2 in
6
+ `docs/specs/starship-config/` (configurators are Python modules in a registry, keyed
7
+ in Python rather than declared in `tools.yaml`) apply unchanged and are not restated.
8
+
9
+ ---
10
+
11
+ ## SD-1 — The local REST API via stdlib `urllib`, not `syncthing cli`
12
+
13
+ **Decision: all daemon interaction is HTTP against `127.0.0.1` with the `X-API-Key`
14
+ header, using `urllib` with a `ProxyHandler({})` opener.**
15
+
16
+ The REST API is the documented, versioned contract — syncthing's own GUI is just a
17
+ client of it. `syncthing cli` exists, but its argument and JSON shapes change between
18
+ versions, it shells out per call, and each invocation would carry the API key as a
19
+ command-line argument — visible in `ps` and in devstuff's own `-vv` command log, which
20
+ is exactly where this project's subprocess helpers put argv.
21
+
22
+ - **Rejected — `syncthing cli` subcommands.** Less stable surface, and the key on argv.
23
+ - **Rejected — a HTTP library (requests/httpx).** A new runtime dependency for one wizard;
24
+ `urllib` is sufficient and keeps NFR-1.
25
+ - **Rejected — the default urllib opener.** It honours `http_proxy`, and a corporate proxy
26
+ must never see the local daemon's API key — hence the explicit empty `ProxyHandler`.
27
+
28
+ **Consequence:** `api.py` is ~120 lines and the key exists in exactly one place — the
29
+ header set in `Client._request`. `Endpoint.__repr__` redacts it so a traceback or a
30
+ `verbose` dump can't leak it.
31
+
32
+ ## SD-2 — `POST` to the collection endpoints, never `PUT …/<id>`
33
+
34
+ **Decision: device and folder writes are `POST /rest/config/devices` and
35
+ `POST /rest/config/folders` with the id inside the body.**
36
+
37
+ Measured on v2.1.6: the collection POSTs upsert by id and accept any id — space, `?`,
38
+ `#`, `%`, unicode and `/` all work. `PUT /rest/config/folders/<id>` returns 404 for an
39
+ id containing `/`, even percent-encoded, because the id is a path segment. The folder
40
+ id this was built for (`shared/…`) hits exactly that.
41
+
42
+ - **Rejected — `PUT` for "update" and `POST` for "create".** The put-by-id route is the
43
+ broken one; the collection POST already upserts, so a second code path is risk for
44
+ nothing.
45
+
46
+ ## SD-3 — The official apt repo (stable-v2), not the Ubuntu archive
47
+
48
+ **Decision: the install adds `apt.syncthing.net` (`syncthing stable-v2`) with the
49
+ upstream release key, modelled on the `gh` entry.**
50
+
51
+ The Ubuntu archive ships 1.29 — a major version behind v2, with a different on-disk
52
+ config format (`~/.config/syncthing` vs `~/.local/state/syncthing`) and a different
53
+ REST surface. The user chose v2 deliberately.
54
+
55
+ - **Rejected — the Ubuntu archive.** Ships 1.x; "simpler" only until a mixed-v1/v2 pair
56
+ has to be debugged.
57
+ - **Rejected — a pin in `/etc/apt/preferences.d`.** Deliberately not added: the repo's
58
+ 2.x already outranks the archive's 1.29, so a pin would be a file doing nothing.
59
+ Revisit if Ubuntu ever ships a higher-versioned build.
60
+
61
+ ## SD-4 — Linger is asked about in the wizard, never set by the install
62
+
63
+ **Decision: `devstuff install` never touches `loginctl`; the wizard detects linger is
64
+ off, explains what it does, and asks (default Yes).**
65
+
66
+ `loginctl enable-linger` needs sudo and changes a system-wide property (the user's
67
+ services run without a login). An installer doing it unprompted is a machine-policy
68
+ change hidden inside an app install; a wizard asking about it is a decision.
69
+
70
+ - **Rejected — enable linger in `install_script`.** Same sudo-and-system-wide cost, no
71
+ user consent.
72
+ - **Rejected — do nothing.** Then sync silently stops whenever the user logs out, which
73
+ is most of the point of a storage pairing on a headless-leaning machine.
74
+
75
+ **Consequence:** `detect.linger_enabled()` has a real three-state answer — `None`
76
+ ("loginctl can't say") stays silent rather than warning about a state it can't see,
77
+ the same contract as the Nerd Font check.
78
+
79
+ ## SD-5 — The packaged systemd *user* unit, not `syncthing@user`
80
+
81
+ **Decision: the install and the wizard both manage `syncthing.service` under
82
+ `systemctl --user`; the system unit is not touched.**
83
+
84
+ The Debian package ships `/usr/lib/systemd/user/syncthing.service`
85
+ (`ExecStart=/usr/bin/syncthing serve --no-browser --no-restart`). A user unit runs as
86
+ the user, keeps config in `~/.local/state/syncthing`, needs no root to start, and pairs
87
+ with linger to survive logout. `syncthing@<user>` runs the daemon as root-managed
88
+ system service — a different operating model for a machine where syncthing is one
89
+ user's tool.
90
+
91
+ - **Rejected — `systemctl enable syncthing@<user>`.** Needs root for every management
92
+ operation and makes the daemon's files root-owned. Wrong shape for a dev tool.
93
+ - **Rejected — "just run `syncthing` in a shell".** Then nothing survives reboot or
94
+ logout; the wizard would be pairing a daemon that isn't running half the time.
95
+
96
+ **Consequence:** the wizard refuses to run as root (there is no root user service to
97
+ manage), and a host with no systemd user session gets an explanation rather than a
98
+ failure.
99
+
100
+ ## SD-6 — `remove` leaves the apt repo, config and linger in place
101
+
102
+ **Decision: `remove_script` stops/disables the user unit and removes the package;
103
+ the apt source, keyring, `~/.local/state/syncthing` and linger are left and said to
104
+ be left.**
105
+
106
+ The apt repo may predate this install — removing it could break another syncthing the
107
+ user installed by hand. The config dir holds the device's identity (key pair); deleting
108
+ it makes a reinstall look like a new device to every peer. Linger is a per-user system
109
+ property this tool only *asked* about.
110
+
111
+ - **Rejected — `apt-get remove` plus wiping the source/keyring/config.** Destroys
112
+ device identity and possibly a repo the user had anyway.
113
+
114
+ ## SD-7 — `--output` is refused
115
+
116
+ **Decision: `run(target=…)` prints an explanation and returns None.**
117
+
118
+ Every other configurator writes a file, so `--output` means "write it elsewhere". Here
119
+ there is no file: syncthing is configured through its running API. Silently treating
120
+ `--output` as "POST to a different daemon" would be a trap, and exporting a JSON blob
121
+ would produce an artifact nothing consumes.
122
+
123
+ ## SD-8 — The apply path takes an explicit `Client`
124
+
125
+ **Decision: `wizard.apply(client, config, local_id, req, plan)` is a function the
126
+ wizard calls and the live test calls directly.**
127
+
128
+ The prompts and systemd steps can't be exercised without a pty, but plan → POST order
129
+ → verify can — against two real throwaway daemons. Factoring the writes out of `run()`
130
+ is what makes the live test test the same code path the wizard runs, rather than a
131
+ reimplementation of it.
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "devstuff"
3
- version = "2.21.0"
3
+ version = "2.22.0"
4
4
  description = "Development environment setup CLI for Linux"
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.11"
@@ -88,6 +88,12 @@ CONFIGURATORS: dict[str, Configurator] = {
88
88
  description="Prompt style, colour palette, and which sections appear",
89
89
  module="dev_setup.configure.starship.wizard",
90
90
  ),
91
+ "syncthing": Configurator(
92
+ key="syncthing",
93
+ label="Syncthing",
94
+ description="Pair with a server device and share a folder through the local API",
95
+ module="dev_setup.configure.syncthing.wizard",
96
+ ),
91
97
  }
92
98
 
93
99
 
@@ -0,0 +1 @@
1
+ """`devstuff configure syncthing` — pair with a server device via the local API."""