From 81ddfc65b4661c52569f8b8d1ee41d5a6d68f85e Mon Sep 17 00:00:00 2001
From: akbash <akbash@herdr.dev>
Date: Sat, 26 Sep 2026 03:13:20 +0300
Subject: fix: accept plugin install options before the repository (#4453)

refs #4446

Co-authored-by: akbash-bot <300245827+akbash-bot@users.noreply.github.com>
Co-authored-by: JJ Liebig <jonathan.liebig@gmail.com>
---
 tests/cli/plugins.rs | 37 ++++++++++++++++++++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)

(limited to 'tests/cli')

diff --git a/tests/cli/plugins.rs b/tests/cli/plugins.rs
index 6726c243..23f1b352 100644
--- a/tests/cli/plugins.rs
+++ b/tests/cli/plugins.rs
@@ -387,6 +387,36 @@ command = ["sh", "-c", "sleep 5"]
     cleanup_spawned_herdr(herdr, base);
 }
 
+#[test]
+fn plugin_install_usage_errors_include_options_without_installing() {
+    let base = unique_test_dir();
+    let config_home = base.join("config");
+    let runtime_dir = base.join("runtime");
+    let state_home = base.join("state");
+    fs::create_dir_all(&runtime_dir).unwrap();
+
+    for args in [
+        vec!["plugin", "install"],
+        vec!["plugin", "install", "owner"],
+    ] {
+        let output = run_named_cli_with_env(
+            &config_home,
+            &runtime_dir,
+            &args,
+            &[("XDG_STATE_HOME", &state_home)],
+        );
+        assert_eq!(output.status.code(), Some(2), "{args:?}");
+        let stderr = String::from_utf8_lossy(&output.stderr);
+        assert!(stderr.contains("usage: herdr plugin install"), "{stderr}");
+        assert!(stderr.contains("[--ref REF] [--yes|-y]"), "{stderr}");
+        assert!(!config_home.join("herdr-dev/plugins").exists());
+        assert!(!config_home.join("herdr-dev/plugins.json").exists());
+        assert!(!state_home.exists());
+    }
+
+    cleanup_test_base(&base);
+}
+
 #[test]
 fn plugin_install_list_uninstall_offline_cli_smoke_test() {
     let base = unique_test_dir();
@@ -433,6 +463,7 @@ command = ["sh", "-c", "echo bootstrap"]
     )
     .unwrap();
 
+    run_git(&source_repo, &["tag", "v0.43.0"]);
     let install = run_named_cli_with_env(
         &config_home,
         &runtime_dir,
@@ -441,11 +472,14 @@ command = ["sh", "-c", "echo bootstrap"]
             "plugins",
             "plugin",
             "install",
-            "ogulcancelik/herdr-plugin-examples/worktree-bootstrap",
             "--yes",
+            "--ref",
+            "v0.43.0",
+            "ogulcancelik/herdr-plugin-examples/worktree-bootstrap",
         ],
         &[
             ("GIT_CONFIG_GLOBAL", &git_config),
+            ("XDG_STATE_HOME", &base.join("state")),
             ("HERDR_SESSION", Path::new("leaked-session")),
         ],
     );
@@ -467,6 +501,7 @@ command = ["sh", "-c", "echo bootstrap"]
     assert_eq!(plugin["source"]["owner"], "ogulcancelik");
     assert_eq!(plugin["source"]["repo"], "herdr-plugin-examples");
     assert_eq!(plugin["source"]["subdir"], "worktree-bootstrap");
+    assert_eq!(plugin["source"]["requested_ref"], "v0.43.0");
     assert!(plugin["source"]["resolved_commit"].as_str().is_some());
     let managed_path = PathBuf::from(plugin["source"]["managed_path"].as_str().unwrap());
     assert!(managed_path.exists(), "managed checkout should exist");
-- 
cgit v1.2.3