fix(dev): report scaffold filesystem failures as a clean CLI error

The `dev integration scaffold` command only caught FileExistsError/ValueError,
so an OSError raised during mkdir()/write_text() (permission denied, read-only
checkout, a path component that is a file, ...) bubbled up as a traceback
instead of a clean error + exit code. Broaden the handler to OSError (which
also covers FileExistsError) and add coverage for the filesystem-error path.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: PascalThuet

src/specify_cli/__init__.py

@@ -605,7 +605,11 @@ def dev_integration_scaffold(
     project_root = Path.cwd()
     try:
         result = scaffold_integration(project_root, key, integration_type)
-    except (FileExistsError, ValueError) as exc:
+    except (OSError, ValueError) as exc:
+        # OSError covers filesystem failures during mkdir()/write_text()
+        # (permission denied, read-only checkout, a path component that is a
+        # file, ...) as well as FileExistsError; surface them as a clean CLI
+        # error instead of a traceback.
         console.print(f"[red]Error:[/red] {exc}")
         raise typer.Exit(1)
 

tests/integrations/test_integration_scaffold.py

@@ -102,6 +102,28 @@ def test_dev_integration_scaffold_rejects_unknown_type_before_scaffolding(tmp_pa
     assert not (root / "src" / "specify_cli" / "integrations" / "my_agent").exists()
 
 
+def test_dev_integration_scaffold_reports_filesystem_errors_cleanly(tmp_path, monkeypatch):
+    root = _repo_root(tmp_path)
+    monkeypatch.chdir(root)
+
+    import specify_cli.integration_scaffold as scaffold_module
+
+    def boom(*args, **kwargs):
+        raise PermissionError("Permission denied: read-only checkout")
+
+    monkeypatch.setattr(scaffold_module, "scaffold_integration", boom)
+
+    result = runner.invoke(app, [
+        "dev", "integration", "scaffold", "my-agent",
+        "--type", "markdown",
+    ], catch_exceptions=False)
+
+    output = strip_ansi(result.output)
+    assert result.exit_code == 1
+    assert "Error:" in output
+    assert "Permission denied" in output
+
+
 def test_scaffold_refuses_invalid_key(tmp_path):
     root = _repo_root(tmp_path)