feat: add version-aware preset auto-upgrade

Author: kanfil

CHANGELOG.md

@@ -4,7 +4,14 @@ All notable changes to the Specify CLI and templates are documented here.
 
 # [Unreleased]
 
-# [0.8.4+adlc3] - 2026-04-30
+# [0.8.4+adlc4] - 2026-04-30
+
+### Added
+
+- **Preset auto-upgrade**: Presets now auto-upgrade when CLI version bumps.
+  - Add version comparison at two gates: file scaffolding + registry re-registration
+  - Bundled version > installed version triggers re-scaffold/re-register
+  - Bundled version <= installed version skips (preserves manual edits)
 
 ### Changed
 

presets/agentic-sdlc/preset.yml

@@ -3,7 +3,7 @@ schema_version: "1.0"
 preset:
   id: "agentic-sdlc"
   name: "Agentic SDLC Governance"
-  version: "1.0.0"
+  version: "1.0.1"
   description: "Enhanced templates with governance, team-ai-directives integration, extension hooks, and architectural rigor for the Agentic SDLC workflow"
   author: "Tikal"
   repository: "https://github.com/tikalk/agentic-sdlc-spec-kit"

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentic-sdlc-specify-cli"
-version = "0.8.4+adlc3"
+version = "0.8.4+adlc4"
 description = "Specify CLI (tikalk fork). Agentic SDLC toolkit for Spec-Driven Development with pre-installed extensions and AI integrations."
 requires-python = ">=3.11"
 dependencies = [

src/specify_cli/cli_customization.py

@@ -22,6 +22,7 @@
 import os
 import shutil
 import typer
+from packaging import version
 from pathlib import Path
 from typing import Any, Optional
 
@@ -275,6 +276,26 @@ def _scaffold_extensions_to_project(
     return scaffolded
 
 
+# ============================================================================
+# PRESET VERSIONING
+# ============================================================================
+
+
+def _read_preset_version(preset_dir: Path) -> str | None:
+    """Read version from preset.yml if it exists."""
+    preset_yml = preset_dir / "preset.yml"
+    if not preset_yml.exists():
+        return None
+
+    from .presets import PresetManifest
+
+    try:
+        manifest = PresetManifest(preset_yml)
+        return manifest.version
+    except Exception:
+        return None
+
+
 def _scaffold_presets_to_project(
     source_dir: Path,
     project_dir: Path,
@@ -294,6 +315,14 @@ def _scaffold_presets_to_project(
         proj_preset = project_dir / preset_dir.name
 
         if (proj_preset / "preset.yml").exists():
+            bundled_version = _read_preset_version(preset_dir)
+            installed_version = _read_preset_version(proj_preset)
+            if bundled_version and installed_version:
+                try:
+                    if version.parse(bundled_version) <= version.parse(installed_version):
+                        continue
+                except Exception:
+                    pass
             continue
 
         if proj_preset.exists():
@@ -683,9 +712,22 @@ def _install_bundled_presets(
             continue
 
         try:
+            bundled_version = _read_preset_version(preset_dir)
+
             if registry.is_installed(preset_name):
-                skipped.append(f"{preset_name} (existing)")
-                continue
+                reg_entry = registry.get(preset_name)
+                installed_version = reg_entry.get("version") if reg_entry else None
+
+                if bundled_version and installed_version:
+                    try:
+                        if version.parse(bundled_version) <= version.parse(installed_version):
+                            skipped.append(f"{preset_name} (existing v{installed_version})")
+                            continue
+                    except Exception:
+                        pass
+                else:
+                    skipped.append(f"{preset_name} (existing)")
+                    continue
 
             from .presets import PresetManifest