fix: address copilot review feedback

Author: PascalThuet

docs/reference/integrations.md

@@ -88,10 +88,10 @@ specify integration switch <key>
 | Option                   | Description                                                              |
 | ------------------------ | ------------------------------------------------------------------------ |
 | `--script sh\|ps`        | Script type: `sh` (bash/zsh) or `ps` (PowerShell)                        |
-| `--force`                | Force removal of modified files during uninstall                         |
+| `--force`                | Force removal of modified files during uninstall; when the target is already installed, overwrite managed shared templates while changing the default |
 | `--integration-options`  | Options for the target integration                                       |
 
-If the target integration is not already installed, equivalent to running `uninstall` followed by `install` in a single step. If the target integration is already installed, `switch` only changes the default integration, like `use`.
+If the target integration is not already installed, equivalent to running `uninstall` followed by `install` in a single step. In this mode, `--force` controls whether modified files from the removed integration are deleted. If the target integration is already installed, `switch` only changes the default integration, like `use`; in this mode, `--force` controls whether managed shared templates are overwritten while the default changes.
 
 ## Use an Installed Integration
 

src/specify_cli/__init__.py

@@ -2171,8 +2171,10 @@ def integration_install(
                 unsafe_keys.append(installed_key)
         if unsafe_keys or not getattr(integration, "multi_install_safe", False):
             console.print(
-                f"[red]Error:[/red] Integration '{', '.join(installed_keys)}' is already installed."
+                f"[red]Error:[/red] Installed integrations: {', '.join(installed_keys)}."
             )
+            if default_key:
+                console.print(f"Default integration: [cyan]{default_key}[/cyan].")
             console.print(
                 "Installing multiple integrations is only automatic when all involved "
                 "integrations are declared multi-install safe."

src/specify_cli/shared_infra.py

@@ -10,16 +10,29 @@
 from .integrations.manifest import IntegrationManifest
 
 
-def load_speckit_manifest(project_path: Path, *, version: str) -> IntegrationManifest:
+def load_speckit_manifest(
+    project_path: Path,
+    *,
+    version: str,
+    console: Any | None = None,
+) -> IntegrationManifest:
     """Load the shared infrastructure manifest, preserving existing entries."""
     manifest_path = project_path / ".specify" / "integrations" / "speckit.manifest.json"
     if manifest_path.exists():
         try:
             manifest = IntegrationManifest.load("speckit", project_path)
             manifest.version = version
             return manifest
-        except (ValueError, FileNotFoundError):
-            pass
+        except (ValueError, FileNotFoundError) as exc:
+            if console is not None:
+                console.print(
+                    f"[yellow]Warning:[/yellow] Could not read shared infrastructure "
+                    f"manifest at {manifest_path}: {exc}"
+                )
+                console.print(
+                    "A new shared manifest will be created; previously tracked "
+                    "shared files may be treated as untracked."
+                )
     return IntegrationManifest("speckit", project_path, version=version)
 
 
@@ -60,7 +73,7 @@ def refresh_shared_templates(
     if not templates_src.is_dir():
         return
 
-    manifest = load_speckit_manifest(project_path, version=version)
+    manifest = load_speckit_manifest(project_path, version=version, console=console)
     tracked_files = manifest.files
     modified = set(manifest.check_modified())
     skipped_files: list[str] = []
@@ -105,7 +118,7 @@ def install_shared_infra(
     invoke_separator: str = ".",
 ) -> bool:
     """Install shared scripts and templates into *project_path*."""
-    manifest = load_speckit_manifest(project_path, version=version)
+    manifest = load_speckit_manifest(project_path, version=version, console=console)
     skipped_files: list[str] = []
 
     scripts_src = shared_scripts_source(core_pack=core_pack, repo_root=repo_root)

tests/integrations/test_cli.py

@@ -254,6 +254,23 @@ def test_shared_infra_skip_warning_displayed(self, tmp_path, capsys):
         normalized = " ".join(captured.out.split())
         assert "specify integration upgrade --force" in normalized
 
+    def test_shared_infra_warns_when_manifest_cannot_be_loaded(self, tmp_path, capsys):
+        """Invalid shared manifests warn before falling back to a new manifest."""
+        from specify_cli import _install_shared_infra
+
+        project = tmp_path / "bad-shared-manifest-test"
+        project.mkdir()
+        integrations_dir = project / ".specify" / "integrations"
+        integrations_dir.mkdir(parents=True)
+        manifest_path = integrations_dir / "speckit.manifest.json"
+        manifest_path.write_text("{not json", encoding="utf-8")
+
+        _install_shared_infra(project, "sh")
+
+        captured = capsys.readouterr()
+        assert "Could not read shared infrastructure manifest" in captured.out
+        assert "A new shared manifest will be created" in captured.out
+
     def test_shared_infra_no_warning_when_forced(self, tmp_path, capsys):
         """No skip warning when force=True (all files overwritten)."""
         from specify_cli import _install_shared_infra

tests/integrations/test_integration_subcommand.py

@@ -131,7 +131,8 @@ def test_install_different_when_one_exists(self, tmp_path):
         finally:
             os.chdir(old_cwd)
         assert result.exit_code != 0
-        assert "already installed" in result.output
+        assert "Installed integrations: copilot" in result.output
+        assert "Default integration: copilot" in result.output
         assert "--force" in result.output
 
     def test_install_multi_safe_integration(self, tmp_path):
@@ -215,6 +216,7 @@ def test_install_multi_unsafe_requires_force(self, tmp_path):
         finally:
             os.chdir(old_cwd)
         assert result.exit_code != 0
+        assert "Installed integrations: copilot" in result.output
         assert "multi-install safe" in result.output
         assert "--force" in result.output