devstuff 2.21.0__tar.gz → 2.23.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {devstuff-2.21.0 → devstuff-2.23.0}/.github/workflows/test-installs.yml +4 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/AGENTS.md +4 -1
- {devstuff-2.21.0 → devstuff-2.23.0}/CHANGELOG.md +12 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/CLAUDE.md +39 -5
- {devstuff-2.21.0 → devstuff-2.23.0}/PKG-INFO +7 -1
- {devstuff-2.21.0 → devstuff-2.23.0}/README.md +6 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/README.md +1 -0
- devstuff-2.23.0/docs/specs/syncthing-config/development-plan.md +93 -0
- devstuff-2.23.0/docs/specs/syncthing-config/specifications.md +179 -0
- devstuff-2.23.0/docs/specs/syncthing-config/stack-decisions.md +131 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/pyproject.toml +1 -1
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/__init__.py +6 -0
- devstuff-2.23.0/src/dev_setup/configure/syncthing/__init__.py +1 -0
- devstuff-2.23.0/src/dev_setup/configure/syncthing/api.py +144 -0
- devstuff-2.23.0/src/dev_setup/configure/syncthing/detect.py +77 -0
- devstuff-2.23.0/src/dev_setup/configure/syncthing/model.py +241 -0
- devstuff-2.23.0/src/dev_setup/configure/syncthing/wizard.py +277 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/links.yaml +24 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/tools.yaml +89 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/integration/test_tools.py +3 -0
- devstuff-2.23.0/tests/test_catalog_scripts.py +110 -0
- devstuff-2.23.0/tests/test_configure_syncthing.py +640 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/uv.lock +1 -1
- {devstuff-2.21.0 → devstuff-2.23.0}/.claude/skills/run-stuff/SKILL.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/.claude/skills/run-stuff/smoke.sh +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/.github/codex/review.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/.github/workflows/agent.yml +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/.github/workflows/bump.yml +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/.github/workflows/ci.yml +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/.github/workflows/publish.yml +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/.gitignore +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/dev/Dockerfile +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/dev/Dockerfile.ci +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/dev/Makefile +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/dev/docker-compose.yml +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/devstuff +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/ROADMAP.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/github-agent.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/agent/development-plan.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/agent/specifications.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/agent/stack-decisions.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/ansible-config/development-plan.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/ansible-config/specifications.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/ansible-config/stack-decisions.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/bat-config/development-plan.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/bat-config/specifications.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/bat-config/stack-decisions.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/commitizen-config/development-plan.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/commitizen-config/specifications.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/commitizen-config/stack-decisions.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/docker-config/development-plan.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/docker-config/specifications.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/docker-config/stack-decisions.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/lazygit-config/development-plan.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/lazygit-config/specifications.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/lazygit-config/stack-decisions.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/mcp/development-plan.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/mcp/specifications.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/mcp/stack-decisions.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/outdated/development-plan.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/outdated/specifications.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/outdated/stack-decisions.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/plan-and-progress/specifications.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/precommit-config/development-plan.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/precommit-config/specifications.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/precommit-config/stack-decisions.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/profile/development-plan.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/profile/specifications.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/profile/stack-decisions.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/profile-apply/development-plan.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/profile-apply/specifications.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/profile-apply/stack-decisions.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/starship-config/development-plan.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/starship-config/specifications.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/starship-config/stack-decisions.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/uv-backbone/development-plan.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/uv-backbone/specifications.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/uv-backbone/stack-decisions.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/verbose-mode/development-plan.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/verbose-mode/specifications.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/docs/specs/verbose-mode/stack-decisions.md +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/install.sh +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/__init__.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/__main__.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/agent/__init__.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/agent/approval.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/agent/bridges.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/agent/catalog.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/agent/completion.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/agent/config.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/agent/loop.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/agent/ollama.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/agent/preflight.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/agent/primitives.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/agent/registry.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/agent/sandbox.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/agent/session.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/agent/transcript.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/agent/wizard.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/agent_tools.schema.json +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/agent_tools.yaml +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/apply_exec.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/apply_plan.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/base.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/bundles/ai-agents.yaml +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/bundles/ai-local.yaml +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/bundles/devops.yaml +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/bundles/essentials.yaml +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/bundles/languages.yaml +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/bundles/python.yaml +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/bundles.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/catalog.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/cli.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/__init__.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/_plan.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/add_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/agent_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/catalog_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/configure_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/delete_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/docs_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/doctor_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/functions_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/help_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/install_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/links_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/list_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/mcp_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/outdated_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/profile_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/remove_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/run_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/skills_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/commands/update_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/ansible/__init__.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/ansible/detect.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/ansible/model.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/ansible/render.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/ansible/validate.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/ansible/wizard.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/bat/__init__.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/bat/detect.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/bat/model.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/bat/preview.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/bat/render.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/bat/wizard.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/commitizen/__init__.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/commitizen/detect.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/commitizen/model.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/commitizen/render.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/commitizen/validate.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/commitizen/wizard.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/docker/__init__.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/docker/detect.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/docker/model.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/docker/render.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/docker/validate.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/docker/wizard.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/lazygit/__init__.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/lazygit/detect.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/lazygit/model.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/lazygit/render.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/lazygit/validate.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/lazygit/wizard.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/precommit/__init__.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/precommit/detect.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/precommit/model.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/precommit/render.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/precommit/validate.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/precommit/wizard.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/reptyr/__init__.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/reptyr/wizard.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/starship/__init__.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/starship/fonts.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/starship/icons.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/starship/model.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/starship/preview.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/starship/render.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/configure/starship/wizard.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/doctor.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/function_runner.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/functions.schema.json +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/functions.yaml +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/functions_catalog.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/functions_registry.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/generic.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/links.schema.json +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/links_catalog.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/links_registry.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/mcp/__init__.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/mcp/core.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/mcp/http.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/mcp/openapi.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/mcp/printconfig.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/mcp/process.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/mcp/stdio.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/mcp/token.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/profile.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/registry.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/snapshot.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/ui.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/updates.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/src/dev_setup/verbose.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/__init__.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/integration/__init__.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/integration/conftest.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/integration/test_agent_smoke.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/integration/test_agent_tui.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/integration/test_commitizen_config.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/integration/test_mcp_claude.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/integration/test_mcp_conformance.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/integration/test_profile_apply.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/mcp_http_support.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/mcp_process_support.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_agent.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_agent_bridges.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_agent_completion.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_agent_loop.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_agent_sandbox.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_agent_tools.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_agent_wizard.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_apply_exec.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_apply_plan.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_apply_run.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_bundles.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_catalog.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_configure_ansible.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_configure_bat.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_configure_commitizen.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_configure_docker.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_configure_lazygit.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_configure_precommit.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_configure_reptyr.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_configure_starship.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_doctor.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_functions.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_generic.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_installed_version.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_lifecycle_cmds.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_links.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_mcp_classify.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_mcp_core.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_mcp_http.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_mcp_http_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_mcp_openapi.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_mcp_printconfig.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_mcp_process.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_mcp_stdio.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_mcp_token.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_outdated_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_pin_support.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_plan_and_select.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_profile.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_profile_apply_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_profile_diff.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_profile_diff_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_profile_snapshot_cmd.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_registry.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_snapshot.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_ui.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_update_checker_parity.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_update_notes.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_updates.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_uv_probes.py +0 -0
- {devstuff-2.21.0 → devstuff-2.23.0}/tests/test_verbose.py +0 -0
|
@@ -56,6 +56,7 @@ jobs:
|
|
|
56
56
|
- arcane-cli # release binary into /usr/local/bin
|
|
57
57
|
- aws
|
|
58
58
|
- bat
|
|
59
|
+
- bubblewrap # apt: bubblewrap + socat for Claude Code /sandbox
|
|
59
60
|
- claude-code # npm tool, installs nvm first via `requires`
|
|
60
61
|
- codex # npm tool, installs nvm first via `requires`
|
|
61
62
|
- commitizen # uvx tool, requires uv
|
|
@@ -64,6 +65,7 @@ jobs:
|
|
|
64
65
|
- ghgrab # uvx tool, requires uv
|
|
65
66
|
- git-lfs
|
|
66
67
|
- go
|
|
68
|
+
- gum # Charm apt repo
|
|
67
69
|
- hey-dave # uvx tool, requires uv + a managed Python 3.14
|
|
68
70
|
- homebrew # slow: builds from source
|
|
69
71
|
- htop
|
|
@@ -84,6 +86,8 @@ jobs:
|
|
|
84
86
|
- reptyr
|
|
85
87
|
- saml2aws
|
|
86
88
|
- starship
|
|
89
|
+
- syncthing # official apt repo (v2); no systemd user session in CI
|
|
90
|
+
- tmux
|
|
87
91
|
- uv
|
|
88
92
|
- yq
|
|
89
93
|
|
|
@@ -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
|
-
|
|
69
|
+
| PR | Branch | Base | Notes |
|
|
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. |
|
|
70
72
|
|
|
71
73
|
### Closed as dropped
|
|
72
74
|
|
|
@@ -87,3 +89,4 @@ commits rather than merging `master` in.
|
|
|
87
89
|
|---|---|
|
|
88
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. |
|
|
89
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
|
+
| [#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`. |
|
|
@@ -1,3 +1,15 @@
|
|
|
1
|
+
## v2.23.0 (2026-10-13)
|
|
2
|
+
|
|
3
|
+
### Features
|
|
4
|
+
|
|
5
|
+
- **tools**: add tmux, gum and bubblewrap; add Druid, Homepage, Server Box and tmux wiki links
|
|
6
|
+
|
|
7
|
+
## v2.22.0 (2026-10-12)
|
|
8
|
+
|
|
9
|
+
### Features
|
|
10
|
+
|
|
11
|
+
- **syncthing**: add the syncthing tool and a device-pairing configurator
|
|
12
|
+
|
|
1
13
|
## v2.21.0 (2026-10-12)
|
|
2
14
|
|
|
3
15
|
### 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
|
|
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
|
|
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
|
|
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;
|
|
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.
|
|
3
|
+
Version: 2.23.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
|
|
|
@@ -1644,10 +1646,12 @@ links:
|
|
|
1644
1646
|
|
|
1645
1647
|
| `arcane-cli` | Arcane CLI | Command-line client for an Arcane Docker management server (needs a running server) | `arcane-cli --help` |
|
|
1646
1648
|
| `bat` | bat | cat replacement with syntax highlighting and git integration (`devstuff configure bat`) | `bat --help` |
|
|
1649
|
+
| `bubblewrap` | bubblewrap + socat | Unprivileged sandbox (bwrap) and network relay (socat) — what Claude Code's /sandbox needs on Linux | `bwrap --help` |
|
|
1647
1650
|
| `commitizen` | Commitizen | Conventional-commit prompt, semantic version bumping, and changelog generation (`devstuff configure commitizen`) | `cz --help` |
|
|
1648
1651
|
| `gh` | GitHub CLI | GitHub's official CLI | `gh --help` |
|
|
1649
1652
|
| `ghgrab` | ghgrab | TUI and CLI for downloading files, folders, and release assets from GitHub and other git forges without cloning | `ghgrab --help` |
|
|
1650
1653
|
| `git-lfs` | Git LFS | Git extension for versioning large files | `git lfs --help` |
|
|
1654
|
+
| `gum` | gum | Prompts, pickers, spinners and styled output for shell scripts (Charm) | `gum --help` |
|
|
1651
1655
|
| `htop` | htop | Interactive process and resource monitor | `man htop` |
|
|
1652
1656
|
| `homebrew` | Homebrew | Package manager for Linux (and macOS) | `brew --help` |
|
|
1653
1657
|
| `ipython` | IPython | Enhanced interactive Python shell with rich tab completion and magic commands | `ipython --help` |
|
|
@@ -1668,6 +1672,8 @@ links:
|
|
|
1668
1672
|
| `pre-commit` | pre-commit | Git hook manager for automated code quality checks (`devstuff configure pre-commit`) | `pre-commit --help` |
|
|
1669
1673
|
| `saml2aws` | saml2aws | SAML → AWS STS credentials CLI (Versent) | `saml2aws --help` |
|
|
1670
1674
|
| `starship` | Starship | Fast, cross-shell customizable prompt (`devstuff configure starship`) | `starship --help` |
|
|
1675
|
+
| `syncthing` | Syncthing | Peer-to-peer file sync daemon (`devstuff configure syncthing` to pair devices) | `syncthing --help` |
|
|
1676
|
+
| `tmux` | tmux | Terminal multiplexer — persistent sessions, windows and panes | `tmux -h` |
|
|
1671
1677
|
| `yq` | yq | Portable command-line YAML/JSON/XML processor | `yq --help` |
|
|
1672
1678
|
|
|
1673
1679
|
### 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
|
|
|
@@ -1617,10 +1619,12 @@ links:
|
|
|
1617
1619
|
|
|
1618
1620
|
| `arcane-cli` | Arcane CLI | Command-line client for an Arcane Docker management server (needs a running server) | `arcane-cli --help` |
|
|
1619
1621
|
| `bat` | bat | cat replacement with syntax highlighting and git integration (`devstuff configure bat`) | `bat --help` |
|
|
1622
|
+
| `bubblewrap` | bubblewrap + socat | Unprivileged sandbox (bwrap) and network relay (socat) — what Claude Code's /sandbox needs on Linux | `bwrap --help` |
|
|
1620
1623
|
| `commitizen` | Commitizen | Conventional-commit prompt, semantic version bumping, and changelog generation (`devstuff configure commitizen`) | `cz --help` |
|
|
1621
1624
|
| `gh` | GitHub CLI | GitHub's official CLI | `gh --help` |
|
|
1622
1625
|
| `ghgrab` | ghgrab | TUI and CLI for downloading files, folders, and release assets from GitHub and other git forges without cloning | `ghgrab --help` |
|
|
1623
1626
|
| `git-lfs` | Git LFS | Git extension for versioning large files | `git lfs --help` |
|
|
1627
|
+
| `gum` | gum | Prompts, pickers, spinners and styled output for shell scripts (Charm) | `gum --help` |
|
|
1624
1628
|
| `htop` | htop | Interactive process and resource monitor | `man htop` |
|
|
1625
1629
|
| `homebrew` | Homebrew | Package manager for Linux (and macOS) | `brew --help` |
|
|
1626
1630
|
| `ipython` | IPython | Enhanced interactive Python shell with rich tab completion and magic commands | `ipython --help` |
|
|
@@ -1641,6 +1645,8 @@ links:
|
|
|
1641
1645
|
| `pre-commit` | pre-commit | Git hook manager for automated code quality checks (`devstuff configure pre-commit`) | `pre-commit --help` |
|
|
1642
1646
|
| `saml2aws` | saml2aws | SAML → AWS STS credentials CLI (Versent) | `saml2aws --help` |
|
|
1643
1647
|
| `starship` | Starship | Fast, cross-shell customizable prompt (`devstuff configure starship`) | `starship --help` |
|
|
1648
|
+
| `syncthing` | Syncthing | Peer-to-peer file sync daemon (`devstuff configure syncthing` to pair devices) | `syncthing --help` |
|
|
1649
|
+
| `tmux` | tmux | Terminal multiplexer — persistent sessions, windows and panes | `tmux -h` |
|
|
1644
1650
|
| `yq` | yq | Portable command-line YAML/JSON/XML processor | `yq --help` |
|
|
1645
1651
|
|
|
1646
1652
|
### 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.
|
|
@@ -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
|
|