Added warning message about git extension no longer being enabled by default

Author: Aaron Sun

.specify/features/git-extension-deprecation-notice/spec.md

@@ -0,0 +1,51 @@
+# Add notice that git extension will no longer be enabled by default at 1.0.0
+
+> **Source**: [#2165](https://github.com/github/spec-kit/issues/2165) — imported on 2026-04-12
+
+## Overview
+
+Add a deprecation notice during `specify init` to inform users that the git extension, currently auto-enabled by default, will require explicit opt-in starting with v1.0.0. This ensures users are aware of the upcoming behavioral change well in advance.
+
+## Problem Statement
+
+The `git` extension is currently bundled and enabled by default during `specify init`. Starting with v1.0.0, it will still be bundled but no longer enabled by default — users will need to explicitly opt in. Without advance notice, users may be surprised by this change when upgrading to v1.0.0.
+
+## Requirements
+
+### Functional Requirements
+
+- FR-1: During `specify init`, display a warning notice when the git extension is auto-enabled
+- FR-2: The notice must clearly state the timeline (v1.0.0) for the change
+- FR-3: The notice must explain how to opt in after the change (`specify init --extension git` or `specify extension add git`)
+- FR-4: The notice must be non-blocking (warning styling, does not halt initialization)
+
+### Non-Functional Requirements
+
+- NFR-1: Notice should use yellow/warning styling consistent with existing CLI warning patterns
+- NFR-2: Notice should be concise and actionable
+
+## User Scenarios
+
+### Scenario 1: User runs specify init and sees deprecation notice
+
+**Given** a user is initializing a new project with `specify init`
+**When** the git extension is auto-enabled as part of the default behavior
+**Then** a warning notice is displayed informing them that the git extension will require explicit opt-in starting with v1.0.0
+
+### Scenario 2: User understands how to opt in after v1.0.0
+
+**Given** a user sees the deprecation notice during `specify init`
+**When** they read the notice
+**Then** they understand they can use `specify init --extension git` or `specify extension add git` to enable the git extension after v1.0.0
+
+## Acceptance Criteria
+
+- [ ] AC-1: `specify init` shows a notice when the git extension is auto-enabled
+- [ ] AC-2: Notice is visible but non-blocking (yellow/warning styling)
+- [ ] AC-3: Message clearly states the timeline (v1.0.0) and how to opt in
+
+## Out of Scope
+
+- Changes to the git extension itself or its functionality
+- Changes to the bundled status of the git extension (it remains bundled/shipped with spec-kit)
+- Actually removing the default-enabled behavior (that happens at v1.0.0, not now)

src/specify_cli/__init__.py

@@ -1211,6 +1211,7 @@ def init(
 
             ensure_constitution_from_template(project_path, tracker=tracker)
 
+            _git_ext_freshly_installed = False
             if not no_git:
                 tracker.start("git")
                 git_messages = []
@@ -1245,6 +1246,7 @@ def init(
                                 bundled_path, get_speckit_version()
                             )
                             git_messages.append("extension installed")
+                            _git_ext_freshly_installed = True
                     else:
                         git_has_error = True
                         git_messages.append("bundled extension not found")
@@ -1356,6 +1358,21 @@ def init(
     console.print(tracker.render())
     console.print("\n[bold green]Project ready.[/bold green]")
 
+    if _git_ext_freshly_installed:
+        console.print()
+        console.print(
+            Panel(
+                "The [bold]git[/bold] extension is currently enabled by default, "
+                "but starting with [bold]v1.0.0[/bold] it will require explicit opt-in.\n\n"
+                "To opt in after v1.0.0:\n"
+                "  • [cyan]specify init --extension git[/cyan]\n"
+                "  • [cyan]specify extension add git[/cyan]  (post-init)",
+                title="[yellow]⚠ Upcoming Change: git Extension[/yellow]",
+                border_style="yellow",
+                padding=(1, 2),
+            )
+        )
+
     # Agent folder security notice
     agent_config = AGENT_CONFIG.get(selected_ai)
     if agent_config:

tests/extensions/git/test_git_extension.py

@@ -587,3 +587,79 @@ def test_check_feature_branch_rejects_malformed_timestamp(self, tmp_path: Path):
             capture_output=True, text=True,
         )
         assert result.returncode != 0
+
+
+# ── Deprecation Notice Tests ──────────────────────────────────────────────────
+
+
+class TestGitExtDeprecationNotice:
+    """Tests for the v1.0.0 deprecation notice shown during specify init."""
+
+    def test_deprecation_notice_shown_on_fresh_install(self, tmp_path: Path):
+        """specify init shows the git extension deprecation notice on first install."""
+        from typer.testing import CliRunner
+        from unittest.mock import patch, MagicMock
+        from specify_cli import app
+
+        project_dir = tmp_path / "test-project"
+        runner = CliRunner()
+
+        mock_registry = MagicMock()
+        mock_registry.is_installed.return_value = False
+
+        mock_manager = MagicMock()
+        mock_manager.registry = mock_registry
+
+        with patch("specify_cli.extensions.ExtensionManager", return_value=mock_manager):
+            result = runner.invoke(
+                app,
+                ["init", str(project_dir), "--ai", "claude", "--ignore-agent-tools", "--script", "sh"],
+                catch_exceptions=False,
+            )
+
+        assert result.exit_code == 0, result.output
+        assert "Upcoming Change: git Extension" in result.output
+        assert "v1.0.0" in result.output
+        assert "specify init --extension git" in result.output
+
+    def test_deprecation_notice_not_shown_when_already_installed(self, tmp_path: Path):
+        """specify init does NOT show the deprecation notice when git extension is already installed."""
+        from typer.testing import CliRunner
+        from unittest.mock import patch, MagicMock
+        from specify_cli import app
+
+        project_dir = tmp_path / "test-project"
+        runner = CliRunner()
+
+        mock_registry = MagicMock()
+        mock_registry.is_installed.return_value = True
+
+        mock_manager = MagicMock()
+        mock_manager.registry = mock_registry
+
+        with patch("specify_cli.extensions.ExtensionManager", return_value=mock_manager):
+            result = runner.invoke(
+                app,
+                ["init", str(project_dir), "--ai", "claude", "--ignore-agent-tools", "--script", "sh"],
+                catch_exceptions=False,
+            )
+
+        assert result.exit_code == 0, result.output
+        assert "Upcoming Change: git Extension" not in result.output
+
+    def test_deprecation_notice_not_shown_with_no_git_flag(self, tmp_path: Path):
+        """specify init does NOT show the deprecation notice when --no-git is passed."""
+        from typer.testing import CliRunner
+        from specify_cli import app
+
+        project_dir = tmp_path / "test-project"
+        runner = CliRunner()
+
+        result = runner.invoke(
+            app,
+            ["init", str(project_dir), "--ai", "claude", "--ignore-agent-tools", "--no-git", "--script", "sh"],
+            catch_exceptions=False,
+        )
+
+        assert result.exit_code == 0, result.output
+        assert "Upcoming Change: git Extension" not in result.output