fix: handle detached HEAD state in bench update & add --app-name override for get-app

bench/app.py

@@ -668,6 +668,7 @@ def get_app(
 	resolve_deps=False,
 	cache_key=None,
 	compress_artifacts=False,
+	app_name=None,
 ):
 	"""bench get-app clones a Frappe App from remote (GitHub or any other git server),
 	and installs it on the current bench. This also resolves dependencies based on the
@@ -778,6 +779,14 @@ def get_app(
 
 	if to_clone:
 		app.get()
+		# rename folder if app_name override provided
+		if app_name and app_name != app.repo:
+			os.rename(
+				os.path.join(bench_path, "apps", app.repo),
+				os.path.join(bench_path, "apps", app_name),
+			)
+			app.app_name = app_name
+			app.repo = app_name
 
 	if (
 		to_clone
@@ -1033,6 +1042,13 @@ def pull_apps(apps=None, bench_path=".", reset=False):
 					bench.run(f"git fetch {remote} --unshallow", cwd=app_dir)
 
 			branch = get_current_branch(app, bench_path=bench_path)
+
+			# --- FIX: Skip update if detached HEAD ---
+			if not branch:
+				print(f"App {app} is pinned to a specific version. Skipping update.")
+				continue
+			# -----------------------------------------
+
 			logger.log(f"pulling {app}")
 			if reset:
 				reset_cmd = f"git reset --hard {remote}/{branch}"

bench/commands/make.py

@@ -163,6 +163,7 @@ def drop(path):
 	default=False,
 	help="Whether to gzip get-app artifacts that are to be cached",
 )
+@click.option("--app-name", default=None, help="Override folder name on disk")
 def get_app(
 	git_url,
 	branch,
@@ -174,6 +175,7 @@ def get_app(
 	resolve_deps=False,
 	cache_key=None,
 	compress_artifacts=False,
+	app_name=None,
 ):
 	"clone an app from the internet and set it up in your bench"
 	from bench.app import get_app
@@ -188,9 +190,8 @@ def get_app(
 		resolve_deps=resolve_deps,
 		cache_key=cache_key,
 		compress_artifacts=compress_artifacts,
+		app_name=app_name,
 	)
-
-
 @click.command("new-app", help="Create a new Frappe application under apps folder")
 @click.option(
 	"--no-git",

bench/utils/app.py

@@ -177,7 +177,11 @@ def get_current_branch(app, bench_path="."):
 	from bench.utils import get_cmd_output
 
 	repo_dir = get_repo_dir(app, bench_path=bench_path)
-	return get_cmd_output("git symbolic-ref -q --short HEAD", cwd=repo_dir)
+	try:
+		return get_cmd_output("git symbolic-ref -q --short HEAD", cwd=repo_dir)
+	except Exception:
+		# If we are in Detached HEAD state (e.g. pinned tag), this returns None
+		return None
 
 
 @lru_cache(maxsize=5)
@@ -273,8 +277,8 @@ def get_app_name(bench_path: str, folder_name: str) -> str:
 
 	if not app_name:
 		raise AppInstallationError(
-            "Could not determine the package name. Checked pyproject.toml, setup.cfg, and setup.py."
-        )
+			"Could not determine the package name. Checked pyproject.toml, setup.cfg, and setup.py."
+		)
 
 
 	if app_name and folder_name != app_name: