Merge pull request #463 from lbedner/v0.5.3-rc2

v0.5.3-rc2

Author: lbedner

CLAUDE.md

@@ -32,7 +32,7 @@ Each generated project includes:
 
 ## Installation
 
-**Current Version**: v0.5.3-rc1
+**Current Version**: v0.5.3-rc2
 
 ```bash
 pip install aegis-stack
@@ -67,6 +67,29 @@ This project uses `uv` for dependency management and a `Makefile` for CLI develo
 
 **Template testing is critical** - always run `make test-template` after modifying templates to ensure generated projects work correctly.
 
+### TestPyPI Release Testing
+Test upgrade paths using TestPyPI before publishing to PyPI:
+
+```bash
+# 1. Install old version from TestPyPI and create project
+uvx --index-url https://test.pypi.org/simple/ \
+    --extra-index-url https://pypi.org/simple/ \
+    --index-strategy unsafe-best-match \
+    aegis-stack@0.5.2 init test-upgrade-project
+
+# 2. Install new RC version and test update
+cd test-upgrade-project
+uvx --index-url https://test.pypi.org/simple/ \
+    --extra-index-url https://pypi.org/simple/ \
+    --index-strategy unsafe-best-match \
+    aegis-stack@0.5.3-rc2 update
+```
+
+**Key uvx flags:**
+- `--index-url` - Primary source: TestPyPI
+- `--extra-index-url` - Fallback: PyPI (for dependencies not on TestPyPI)
+- `--index-strategy unsafe-best-match` - Allows mixing packages from different indexes
+
 ## Code Navigation (LSP-First)
 
 Use the Language Server (Pyright) for code navigation instead of grep/glob:

aegis/__init__.py

@@ -2,4 +2,4 @@
 Aegis Stack CLI - Component generation and project management tools.
 """
 
-__version__ = "0.5.3-rc1"
+__version__ = "0.5.3-rc2"

aegis/commands/update.py

@@ -22,7 +22,6 @@
     format_conflict_report,
     get_changelog,
     get_current_template_commit,
-    get_latest_version,
     get_template_root,
     is_version_downgrade,
     resolve_ref_to_commit,
@@ -158,14 +157,12 @@ def update_command(
         target_ref = resolve_version_to_ref(to_version, template_root)
         target_version_display = to_version
     else:
-        # Default to latest release version (not HEAD, not prereleases)
-        # Prereleases (rc, alpha, beta) are only picked up via explicit --to-version
-        latest = get_latest_version(template_root)
-        if latest:
-            target_ref = f"v{latest}"
-            target_version_display = f"{latest} (latest release)"
+        # Default to CLI version - templates should match the installed CLI
+        target_ref = resolve_version_to_ref(cli_version, template_root)
+        if target_ref:
+            target_version_display = f"{cli_version} (current CLI)"
         else:
-            # Fallback to HEAD only if no versions found
+            # Fallback to HEAD if CLI version tag doesn't exist
             target_ref = "HEAD"
             head_commit = resolve_ref_to_commit("HEAD", template_root)
             if head_commit:

copier.yml

@@ -6,7 +6,7 @@
 # - Update support
 
 _min_copier_version: "9.0.0"
-_version: "0.5.3-rc1"
+_version: "0.5.3-rc2"
 
 # IMPORTANT: Template content is in subdirectory
 # This allows the template to be recognized as git-tracked (aegis-stack repo root has .git)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "aegis-stack"
-version = "0.5.3-rc1"
+version = "0.5.3-rc2"
 description = "A production-ready Python foundation for builders who refuse to wait. Try: uvx aegis-stack init my-project"
 readme = "README.md"
 requires-python = ">=3.11,<3.15"

tests/cli/test_update_command.py

@@ -176,17 +176,14 @@ def test_dry_run_shows_preview(self, project_factory: "ProjectFactory") -> None:
 class TestUpdateCommandVersionResolution:
     """Tests for version resolution logic."""
 
-    @patch("aegis.commands.update.get_latest_version")
     @patch("aegis.commands.update.resolve_version_to_ref")
     def test_update_to_latest_default(
         self,
         mock_resolve: MagicMock,
-        mock_get_latest: MagicMock,
         project_factory: "ProjectFactory",
     ) -> None:
-        """Test that update defaults to latest version."""
-        # Setup mocks
-        mock_get_latest.return_value = "0.2.0"
+        """Test that update defaults to CLI version."""
+        # Setup mock - resolve_version_to_ref is called with CLI version
         mock_resolve.return_value = "v0.2.0"
 
         # Use cached base project
@@ -810,17 +807,14 @@ def test_update_shows_current_and_target_versions(
         # Should show version information
         assert "version" in output or "template" in output
 
-    @patch("aegis.commands.update.get_latest_version")
     @patch("aegis.commands.update.get_current_template_commit")
     def test_update_shows_cli_version(
         self,
         mock_get_commit: MagicMock,
-        mock_latest: MagicMock,
         project_factory: "ProjectFactory",
     ) -> None:
         """Test that update shows CLI version information."""
         mock_get_commit.return_value = "abc123"
-        mock_latest.return_value = "0.2.0"
 
         project_path = project_factory("base")