feat: add release pipeline and auto-reinstall

[AndreJorgeLopes]

Summary

• Add automated release pipeline triggered by conventional commits on push to main
• Add auto-reinstall watchdog extension that keeps the local devflow binary current after merges
• Full test coverage: 48 unit tests covering commit parsing, semver, version bump, install mode detection, and auto-reinstall guards

Changes

Release Pipeline (lib/release.sh, .github/workflows/release.yml)

• Conventional commit parser (_parse_conventional_commits) determines version bump from feat:/fix:/feat!:/BREAKING CHANGE:
• Semver arithmetic in pure bash
• bump_all_versions updates Makefile, utils.sh, plugin.json, marketplace.json, and all command badges using portable sed
• GitHub Actions workflow: single-push architecture (version bump + Formula update in one commit), concurrency guard, [skip release] support, workflow_dispatch for manual overrides
• CLI commands: devflow version-bump <version>, devflow release (preview)

Auto-Reinstall (lib/watch.sh)

• _detect_install_mode: distinguishes symlink (make link), copy (make install), Homebrew (warn only)
• _auto_reinstall_check: SHA-based staleness detection, opt-in via devflow watch setup
• Dry-run support, error handling with retry (SHA not updated on failure), full error logging

Test plan

• 48/48 unit tests pass (bats tests/unit/)
• Smoke tests pass (make test)
• Version consistency validated (make check-version)
• devflow release preview works
• devflow help shows all new commands
• GitHub Actions workflow will be tested on first merge to main

[Copilot]

Pull request overview

Adds a conventional-commit–driven release pipeline (CLI + GitHub Actions) and extends the watchdog to optionally auto-reinstall devflow when origin/main advances, along with supporting docs, tests, and plugin/skill updates.

Changes:

• Introduces lib/release.sh + .github/workflows/release.yml to compute semver bumps from conventional commits and publish releases automatically.
• Adds scripts/bump-version.sh and a make version-bump target to update all version-bearing files consistently.
• Extends lib/watch.sh with install-mode detection and an opt-in auto-reinstall step; updates skills/plugin command docs accordingly.

Reviewed changes

Copilot reviewed 36 out of 37 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
visualizations/architecture/devflow-ecosystem.md	Documents new CLI commands in the ecosystem diagram/table.
tests/unit/watch.bats	Adds unit tests for install-mode detection and auto-reinstall guards.
tests/unit/release.bats	Adds unit tests for conventional commit parsing, semver bumping, and version bump behavior.
skills/worktree-flow/new-feature.md	Adds optional “codebase walkthrough” step before brainstorming.
skills/registry.json	Registers the new codebase-walkthrough skill.
skills/process-discipline/codebase-walkthrough.md	Adds the new walkthrough skill definition/content.
scripts/bump-version.sh	Adds a standalone version bump script used by CLI/CI.
Makefile	Adds version-bump phony target and wiring to bump script.
lib/watch.sh	Adds auto-reinstall functionality and setup opt-in; integrates into watcher run steps.
lib/release.sh	Adds conventional commit parsing, semver bumping, and CLI wrappers for release/version bump.
docs/plans/2026-03-19-release-and-reinstall-plan.md	Adds an implementation plan doc for the feature set.
docs/plans/2026-03-18-release-pipeline-design.md	Adds design doc for the release pipeline.
docs/plans/2026-03-18-auto-reinstall-design.md	Adds design doc for the auto-reinstall extension.
devflow-plugin/hooks/hooks.json	Adds a Stop hook to remind about session wrap-up commands.
devflow-plugin/commands/writing-plans.md	Updates the writing-plans command content (agent-deck handoff flow).
devflow-plugin/commands/visualizations-config.md	Removes version badge from description; keeps command intent.
devflow-plugin/commands/update-visualizations.md	Removes version badge from description; keeps command intent.
devflow-plugin/commands/spec-feature.md	Removes version badge from description; keeps command intent.
devflow-plugin/commands/session-summary.md	Removes version badge from description; keeps command intent.
devflow-plugin/commands/scope-check.md	Deletes this command doc.
devflow-plugin/commands/retain-learning.md	Removes version badge from description; keeps command intent.
devflow-plugin/commands/reflect-session.md	Removes version badge from description; keeps command intent.
devflow-plugin/commands/pre-push-check.md	Removes version badge from description; keeps command intent.
devflow-plugin/commands/pr-strategy.md	Deletes this command doc.
devflow-plugin/commands/dependency-update.md	Removes version badge from description; keeps command intent.
devflow-plugin/commands/create-pr.md	Simplifies PR creation guidance to GitHub-only flow.
devflow-plugin/commands/new-feature.md	Simplifies new-feature flow; adds optional walkthrough hook.
devflow-plugin/commands/finish-feature.md	Simplifies finish-feature flow; removes VCS-aware/MR branching.
devflow-plugin/commands/task-prioritize.md	Deletes this command doc.
devflow-plugin/commands/task-complete.md	Deletes this command doc.
devflow-plugin/commands/check-sensitive.md	Deletes this command doc.
devflow-plugin/commands/codebase-walkthrough.md	Adds plugin command file for the walkthrough (mirrors skill content).
CLAUDE.md	Documents release process + auto-reinstall; adds lib/release.sh to structure.
bin/devflow	Sources lib/release.sh and adds version-bump / release command dispatch + help.
.github/workflows/release.yml	Adds automated release workflow for pushes to main and manual dispatch.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

When no previous tag exists, the computed range ${initial_commit}..HEAD excludes the initial (root) commit itself. For a repo with only one commit (the root), git log <root>..HEAD returns nothing, so the parser will incorrectly return none and skip the first release. Consider scanning all commits when last_tag is empty (e.g., git log --format ... HEAD), or using an inclusive range (e.g., --reverse --format ... $(git rev-list --max-parents=0 HEAD)), so the root commit is included.

Suggested change

	# Determine commit range
	local range
	if [[ -n "$last_tag" ]]; then
	range="${last_tag}..HEAD"
	else
	# No previous tag — scan from initial commit
	local initial_commit
	initial_commit="$(git -C "$project_dir" rev-list --max-parents=0 HEAD 2>/dev/null | head -1)"
	range="${initial_commit}..HEAD"
	fi
	# Get full commit messages (subject + body)
	local commits
	commits="$(git -C "$project_dir" log "$range" --format='%B---COMMIT_SEP---' 2>/dev/null || echo "")"
	# Determine log target
	local log_target
	if [[ -n "$last_tag" ]]; then
	log_target="${last_tag}..HEAD"
	else
	# No previous tag — scan all commits reachable from HEAD, including the root commit
	log_target="HEAD"
	fi
	# Get full commit messages (subject + body)
	local commits
	commits="$(git -C "$project_dir" log "$log_target" --format='%B---COMMIT_SEP---' 2>/dev/null || echo "")"

[Copilot]

Commit parsing currently stores the full log output in a bash variable and then tries to inject NUL separators via sed 's/.../\x00/g'. BSD/macOS sed does not reliably support \xNN escapes, and bash variables cannot hold NUL bytes anyway, so this approach is fragile across platforms. Prefer streaming directly from git log using git’s built-in %x00 to emit NUL separators (and avoid the intermediate variable), then iterate with read -d ''.

[Copilot]

In the failure path, the notification uses $? after writing to the log, so it will report the exit code of the last echo/mkdir, not the failing make command. Capture make's exit status immediately (e.g., into a local make_rc) before doing any other commands, and use that value in the notify/log message.

Suggested change

	# Log full make output for debugging
	mkdir -p "${HOME}/.devflow"
	echo "[$(date -u '+%Y-%m-%dT%H:%M:%SZ')] make ${make_target} FAILED output:" >> "${HOME}/.devflow/watch.log"
	echo "$make_output" >> "${HOME}/.devflow/watch.log"
	_watch_notify "devflow auto-update FAILED: make ${make_target} exited with code $?" "$headless"
	local make_rc=$?
	# Log full make output for debugging
	mkdir -p "${HOME}/.devflow"
	echo "[$(date -u '+%Y-%m-%dT%H:%M:%SZ')] make ${make_target} FAILED output:" >> "${HOME}/.devflow/watch.log"
	echo "$make_output" >> "${HOME}/.devflow/watch.log"
	_watch_notify "devflow auto-update FAILED: make ${make_target} exited with code ${make_rc}" "$headless"

[Copilot]

The categorization case patterns only match types with a literal : (e.g., refactor:) or type(, so conventional-commit variants with breaking markers like refactor!: / docs!: won’t be captured into any of the feat|fix|other lists. This leads to missing entries in the preview/release notes even though the bump may be detected as major. Consider allowing an optional ! before : (and after scope) for the non-feat/fix categories as well, or normalizing the subject before matching.

Suggested change

	feat:*|feat\(*)
	[[ "$bump" != "major" ]] && bump="minor"
	feat_msgs+="feat|${subject}\n"
	;;
	fix:*|fix\(*)
	[[ "$bump" == "none" ]] && bump="patch"
	fix_msgs+="fix|${subject}\n"
	;;
	docs:*|chore:*|refactor:*|test:*|ci:*|style:*|perf:*)
	feat:*|feat!:*|feat\(*)
	[[ "$bump" != "major" ]] && bump="minor"
	feat_msgs+="feat|${subject}\n"
	;;
	fix:*|fix!:*|fix\(*)
	[[ "$bump" == "none" ]] && bump="patch"
	fix_msgs+="fix|${subject}\n"
	;;
	docs:*|docs!:*|docs\(*|chore:*|chore!:*|chore\(*|refactor:*|refactor!:*|refactor\(*|test:*|test!:*|test\(*|ci:*|ci!:*|ci\(*|style:*|style!:*|style\(*|perf:*|perf!:*|perf\(*)

[AndreJorgeLopes]

review the code after the changes and if you find any required change, do the changes yourself! Also, resolve the conversations if not needed anymore @copilot

[Copilot]

@AndreJorgeLopes The model is not available for your account. This can happen if the model was disabled by your organization's policy or if your Copilot plan doesn't include access to it.

You can try again without specifying a model (just @copilot) to use the default, or choose a different model from the model picker.

If you want to contact GitHub about this error, please mention the following identifier so they can better serve you: 4df03dd3-0882-4268-94c3-63afc0bca0a2

[Copilot]

@AndreJorgeLopes The model is not available for your account. This can happen if the model was disabled by your organization's policy or if your Copilot plan doesn't include access to it.

You can try again without specifying a model (just @copilot) to use the default, or choose a different model from the model picker.

If you want to contact GitHub about this error, please mention the following identifier so they can better serve you: 4df03dd3-0882-4268-94c3-63afc0bca0a2

[Copilot]

@AndreJorgeLopes The model is not available for your account. This can happen if the model was disabled by your organization's policy or if your Copilot plan doesn't include access to it.

You can try again without specifying a model (just @copilot) to use the default, or choose a different model from the model picker.

If you want to contact GitHub about this error, please mention the following identifier so they can better serve you: 4df03dd3-0882-4268-94c3-63afc0bca0a2

[Copilot]

@AndreJorgeLopes The model is not available for your account. This can happen if the model was disabled by your organization's policy or if your Copilot plan doesn't include access to it.

You can try again without specifying a model (just @copilot) to use the default, or choose a different model from the model picker.

If you want to contact GitHub about this error, please mention the following identifier so they can better serve you: 4df03dd3-0882-4268-94c3-63afc0bca0a2

[Copilot]

@AndreJorgeLopes The model is not available for your account. This can happen if the model was disabled by your organization's policy or if your Copilot plan doesn't include access to it.

You can try again without specifying a model (just @copilot) to use the default, or choose a different model from the model picker.

If you want to contact GitHub about this error, please mention the following identifier so they can better serve you: 4df03dd3-0882-4268-94c3-63afc0bca0a2

[Copilot]

@AndreJorgeLopes The model is not available for your account. This can happen if the model was disabled by your organization's policy or if your Copilot plan doesn't include access to it.

You can try again without specifying a model (just @copilot) to use the default, or choose a different model from the model picker.

If you want to contact GitHub about this error, please mention the following identifier so they can better serve you: 4df03dd3-0882-4268-94c3-63afc0bca0a2

[AndreJorgeLopes]

@copilot

[Copilot]

@AndreJorgeLopes The model is not available for your account. This can happen if the model was disabled by your organization's policy or if your Copilot plan doesn't include access to it.

You can try again without specifying a model (just @copilot) to use the default, or choose a different model from the model picker.

If you want to contact GitHub about this error, please mention the following identifier so they can better serve you: 12f8c425-c44d-4934-92d6-bd64d3537d5c

[AndreJorgeLopes]

@copilot

[Copilot]

@AndreJorgeLopes The model is not available for your account. This can happen if the model was disabled by your organization's policy or if your Copilot plan doesn't include access to it.

You can try again without specifying a model (just @copilot) to use the default, or choose a different model from the model picker.

If you want to contact GitHub about this error, please mention the following identifier so they can better serve you: 12f8c425-c44d-4934-92d6-bd64d3537d5c

[AndreJorgeLopes]

@claude[agent]