1use crate::cli::output::Output;
2use crate::config::Settings;
3use crate::errors::{CascadeError, Result};
4use crate::git::find_repository_root;
5use dialoguer::{theme::ColorfulTheme, Confirm};
6use std::env;
7use std::fs;
8use std::path::{Path, PathBuf};
9use std::process::Command;
10use tracing::debug;
11
12#[derive(Debug, Clone, PartialEq)]
14pub enum RepositoryType {
15 Bitbucket,
16 GitHub,
17 GitLab,
18 AzureDevOps,
19 Unknown,
20}
21
22#[derive(Debug, Clone, PartialEq)]
24pub enum BranchType {
25 Main, Feature, Unknown,
28}
29
30#[derive(Debug, Clone)]
32pub struct InstallOptions {
33 pub check_prerequisites: bool,
34 pub feature_branches_only: bool,
35 pub confirm: bool,
36 pub force: bool,
37}
38
39impl Default for InstallOptions {
40 fn default() -> Self {
41 Self {
42 check_prerequisites: true,
43 feature_branches_only: true,
44 confirm: true,
45 force: false,
46 }
47 }
48}
49
50pub struct HooksManager {
52 repo_path: PathBuf,
53 repo_id: String,
54}
55
56#[derive(Debug, Clone)]
58pub enum HookType {
59 PostCommit,
61 PrePush,
63 CommitMsg,
65 PreCommit,
67 PrepareCommitMsg,
69}
70
71impl HookType {
72 fn filename(&self) -> String {
73 let base_name = match self {
74 HookType::PostCommit => "post-commit",
75 HookType::PrePush => "pre-push",
76 HookType::CommitMsg => "commit-msg",
77 HookType::PreCommit => "pre-commit",
78 HookType::PrepareCommitMsg => "prepare-commit-msg",
79 };
80 format!(
81 "{}{}",
82 base_name,
83 crate::utils::platform::git_hook_extension()
84 )
85 }
86
87 fn description(&self) -> &'static str {
88 match self {
89 HookType::PostCommit => "Auto-add new commits to active stack",
90 HookType::PrePush => "Prevent force pushes and validate stack state",
91 HookType::CommitMsg => "Validate commit message format",
92 HookType::PreCommit => "Smart edit mode guidance for better UX",
93 HookType::PrepareCommitMsg => "Add stack context to commit messages",
94 }
95 }
96}
97
98impl HooksManager {
99 pub fn new(repo_path: &Path) -> Result<Self> {
100 let git_dir = repo_path.join(".git");
102 if !git_dir.exists() {
103 return Err(CascadeError::config(
104 "Not a Git repository. Git hooks require a valid Git repository.".to_string(),
105 ));
106 }
107
108 let repo_id = Self::generate_repo_id(repo_path)?;
110
111 Ok(Self {
112 repo_path: repo_path.to_path_buf(),
113 repo_id,
114 })
115 }
116
117 fn generate_repo_id(repo_path: &Path) -> Result<String> {
119 use std::process::Command;
120
121 let output = Command::new("git")
122 .args(["remote", "get-url", "origin"])
123 .current_dir(repo_path)
124 .output()
125 .map_err(|e| CascadeError::config(format!("Failed to get remote URL: {e}")))?;
126
127 if !output.status.success() {
128 use sha2::{Digest, Sha256};
130 let canonical_path = repo_path
131 .canonicalize()
132 .unwrap_or_else(|_| repo_path.to_path_buf());
133 let path_str = canonical_path.to_string_lossy();
134 let mut hasher = Sha256::new();
135 hasher.update(path_str.as_bytes());
136 let result = hasher.finalize();
137 let hash = format!("{result:x}");
138 return Ok(format!("local-{}", &hash[..8]));
139 }
140
141 let remote_url = String::from_utf8_lossy(&output.stdout).trim().to_string();
142
143 let safe_name = remote_url
146 .replace("https://", "")
147 .replace("http://", "")
148 .replace("git@", "")
149 .replace("ssh://", "")
150 .replace(".git", "")
151 .replace([':', '/', '\\'], "-")
152 .chars()
153 .filter(|c| c.is_alphanumeric() || *c == '-' || *c == '.' || *c == '_')
154 .collect::<String>();
155
156 Ok(safe_name)
157 }
158
159 fn get_cascade_hooks_dir(&self) -> Result<PathBuf> {
161 let home = dirs::home_dir()
162 .ok_or_else(|| CascadeError::config("Could not find home directory".to_string()))?;
163 let cascade_hooks = home.join(".cascade").join("hooks").join(&self.repo_id);
164 Ok(cascade_hooks)
165 }
166
167 fn get_cascade_config_dir(&self) -> Result<PathBuf> {
169 let home = dirs::home_dir()
170 .ok_or_else(|| CascadeError::config("Could not find home directory".to_string()))?;
171 let cascade_config = home.join(".cascade").join("config").join(&self.repo_id);
172 Ok(cascade_config)
173 }
174
175 fn save_original_hooks_path(&self) -> Result<()> {
177 use std::process::Command;
178
179 let config_dir = self.get_cascade_config_dir()?;
180 fs::create_dir_all(&config_dir)
181 .map_err(|e| CascadeError::config(format!("Failed to create config directory: {e}")))?;
182
183 let original_path_file = config_dir.join("original-hooks-path");
184
185 if original_path_file.exists() {
187 if let Ok(saved_path) = fs::read_to_string(&original_path_file) {
189 let saved_path = saved_path.trim();
190 let cascade_hooks_dir = dirs::home_dir()
191 .ok_or_else(|| {
192 CascadeError::config("Could not find home directory".to_string())
193 })?
194 .join(".cascade")
195 .join("hooks")
196 .join(&self.repo_id);
197 let cascade_hooks_path = cascade_hooks_dir.to_string_lossy().to_string();
198
199 if saved_path == cascade_hooks_path {
200 fs::write(&original_path_file, "").map_err(|e| {
202 CascadeError::config(format!("Failed to fix corrupted hooks path: {e}"))
203 })?;
204 return Ok(());
205 }
206 }
207 return Ok(());
209 }
210
211 let output = Command::new("git")
212 .args(["config", "--get", "core.hooksPath"])
213 .current_dir(&self.repo_path)
214 .output()
215 .map_err(|e| CascadeError::config(format!("Failed to check git config: {e}")))?;
216
217 let original_path = if output.status.success() {
218 let current_hooks_path = String::from_utf8_lossy(&output.stdout).trim().to_string();
219
220 let cascade_hooks_dir = dirs::home_dir()
223 .ok_or_else(|| CascadeError::config("Could not find home directory".to_string()))?
224 .join(".cascade")
225 .join("hooks")
226 .join(&self.repo_id);
227 let cascade_hooks_path = cascade_hooks_dir.to_string_lossy().to_string();
228
229 if current_hooks_path == cascade_hooks_path {
230 String::new()
232 } else {
233 current_hooks_path
234 }
235 } else {
236 String::new()
238 };
239
240 fs::write(original_path_file, original_path).map_err(|e| {
241 CascadeError::config(format!("Failed to save original hooks path: {e}"))
242 })?;
243
244 Ok(())
245 }
246
247 fn restore_original_hooks_path(&self) -> Result<()> {
249 use std::process::Command;
250
251 let config_dir = self.get_cascade_config_dir()?;
252 let original_path_file = config_dir.join("original-hooks-path");
253
254 if !original_path_file.exists() {
255 return Ok(());
257 }
258
259 let original_path = fs::read_to_string(&original_path_file).map_err(|e| {
260 CascadeError::config(format!("Failed to read original hooks path: {e}"))
261 })?;
262
263 if original_path.is_empty() {
264 Command::new("git")
266 .args(["config", "--unset", "core.hooksPath"])
267 .current_dir(&self.repo_path)
268 .output()
269 .map_err(|e| {
270 CascadeError::config(format!("Failed to unset core.hooksPath: {e}"))
271 })?;
272 } else {
273 Command::new("git")
275 .args(["config", "core.hooksPath", &original_path])
276 .current_dir(&self.repo_path)
277 .output()
278 .map_err(|e| {
279 CascadeError::config(format!("Failed to restore core.hooksPath: {e}"))
280 })?;
281 }
282
283 fs::remove_file(original_path_file).ok();
285
286 Ok(())
287 }
288
289 #[allow(dead_code)]
291 fn get_hooks_path(repo_path: &Path) -> Result<PathBuf> {
292 use std::process::Command;
293
294 let output = Command::new("git")
296 .args(["config", "--get", "core.hooksPath"])
297 .current_dir(repo_path)
298 .output()
299 .map_err(|e| CascadeError::config(format!("Failed to check git config: {e}")))?;
300
301 let hooks_path = if output.status.success() {
302 let configured_path = String::from_utf8_lossy(&output.stdout).trim().to_string();
303 if configured_path.is_empty() {
304 repo_path.join(".git").join("hooks")
306 } else if configured_path.starts_with('/') {
307 PathBuf::from(configured_path)
309 } else {
310 repo_path.join(configured_path)
312 }
313 } else {
314 repo_path.join(".git").join("hooks")
316 };
317
318 Ok(hooks_path)
319 }
320
321 pub fn install_all(&self) -> Result<()> {
323 self.install_with_options(&InstallOptions::default())
324 }
325
326 pub fn install_essential(&self) -> Result<()> {
328 Output::progress("Installing essential Cascade Git hooks");
329
330 let essential_hooks = vec![
331 HookType::PrePush,
332 HookType::CommitMsg,
333 HookType::PrepareCommitMsg,
334 HookType::PreCommit,
335 ];
336
337 for hook in essential_hooks {
338 self.install_hook(&hook)?;
339 }
340
341 Output::success("Essential Cascade hooks installed successfully!");
342 Output::tip("Note: Post-commit auto-add hook available with 'ca hooks install --all'");
343 Output::section("Hooks installed");
344 self.list_installed_hooks()?;
345
346 Ok(())
347 }
348
349 pub fn install_with_options(&self, options: &InstallOptions) -> Result<()> {
351 if options.check_prerequisites && !options.force {
352 self.validate_prerequisites()?;
353 }
354
355 if options.feature_branches_only && !options.force {
356 self.validate_branch_suitability()?;
357 }
358
359 if options.confirm && !options.force {
360 self.confirm_installation()?;
361 }
362
363 Output::progress("Installing all Cascade Git hooks");
364
365 let hooks = vec![
367 HookType::PostCommit,
368 HookType::PrePush,
369 HookType::CommitMsg,
370 HookType::PrepareCommitMsg,
371 HookType::PreCommit,
372 ];
373
374 for hook in hooks {
375 self.install_hook(&hook)?;
376 }
377
378 Output::success("All Cascade hooks installed successfully!");
379 Output::section("Hooks installed");
380 self.list_installed_hooks()?;
381
382 Ok(())
383 }
384
385 pub fn install_hook(&self, hook_type: &HookType) -> Result<()> {
387 self.save_original_hooks_path()?;
389
390 let cascade_hooks_dir = self.get_cascade_hooks_dir()?;
392 fs::create_dir_all(&cascade_hooks_dir).map_err(|e| {
393 CascadeError::config(format!("Failed to create cascade hooks directory: {e}"))
394 })?;
395
396 let hook_content = self.generate_chaining_hook_script(hook_type)?;
398 let hook_path = cascade_hooks_dir.join(hook_type.filename());
399
400 fs::write(&hook_path, hook_content)
402 .map_err(|e| CascadeError::config(format!("Failed to write hook file: {e}")))?;
403
404 crate::utils::platform::make_executable(&hook_path)
406 .map_err(|e| CascadeError::config(format!("Failed to make hook executable: {e}")))?;
407
408 self.set_cascade_hooks_path()?;
410
411 Output::success(format!("Installed {} hook", hook_type.filename()));
412 Ok(())
413 }
414
415 fn set_cascade_hooks_path(&self) -> Result<()> {
417 use std::process::Command;
418
419 let cascade_hooks_dir = self.get_cascade_hooks_dir()?;
420 let hooks_path_str = cascade_hooks_dir.to_string_lossy();
421
422 let output = Command::new("git")
423 .args(["config", "core.hooksPath", &hooks_path_str])
424 .current_dir(&self.repo_path)
425 .output()
426 .map_err(|e| CascadeError::config(format!("Failed to set core.hooksPath: {e}")))?;
427
428 if !output.status.success() {
429 return Err(CascadeError::config(format!(
430 "Failed to set core.hooksPath: {}",
431 String::from_utf8_lossy(&output.stderr)
432 )));
433 }
434
435 Ok(())
436 }
437
438 pub fn uninstall_all(&self) -> Result<()> {
440 Output::progress("Removing Cascade Git hooks");
441
442 self.restore_original_hooks_path()?;
444
445 let cascade_hooks_dir = self.get_cascade_hooks_dir()?;
447 if cascade_hooks_dir.exists() {
448 fs::remove_dir_all(&cascade_hooks_dir).map_err(|e| {
449 CascadeError::config(format!("Failed to remove cascade hooks directory: {e}"))
450 })?;
451 }
452
453 let git_hooks_dir = self.repo_path.join(".git").join("hooks");
458 if git_hooks_dir.exists() {
459 for hook_type in &[
460 HookType::PostCommit,
461 HookType::PrePush,
462 HookType::CommitMsg,
463 HookType::PrepareCommitMsg,
464 HookType::PreCommit,
465 ] {
466 let hook_path = git_hooks_dir.join(hook_type.filename());
467 if hook_path.exists() {
468 if let Ok(content) = fs::read_to_string(&hook_path) {
471 if content.contains("# Cascade CLI Hook Wrapper")
472 && content.contains("cascade_logic()")
473 && content.contains("# Function to run Cascade logic")
474 {
475 debug!(
476 "Removing old Cascade wrapper hook from .git/hooks: {:?}",
477 hook_path
478 );
479 fs::remove_file(&hook_path).ok(); }
481 }
482 }
483 }
484 }
485
486 let cascade_config_dir = self.get_cascade_config_dir()?;
488 if cascade_config_dir.exists() {
489 fs::remove_dir(&cascade_config_dir).ok();
491 }
492
493 Output::success("All Cascade hooks removed!");
494 Ok(())
495 }
496
497 pub fn uninstall_hook(&self, hook_type: &HookType) -> Result<()> {
499 let cascade_hooks_dir = self.get_cascade_hooks_dir()?;
500 let hook_path = cascade_hooks_dir.join(hook_type.filename());
501
502 if hook_path.exists() {
503 fs::remove_file(&hook_path)
504 .map_err(|e| CascadeError::config(format!("Failed to remove hook file: {e}")))?;
505 Output::success(format!("Removed {} hook", hook_type.filename()));
506
507 let remaining_hooks = fs::read_dir(&cascade_hooks_dir)
509 .map_err(|e| CascadeError::config(format!("Failed to read hooks directory: {e}")))?
510 .filter_map(|entry| entry.ok())
511 .filter(|entry| {
512 entry.path().is_file() && !entry.file_name().to_string_lossy().starts_with('.')
513 })
514 .count();
515
516 if remaining_hooks == 0 {
517 Output::info(
518 "No more Cascade hooks installed, restoring original hooks configuration",
519 );
520 self.restore_original_hooks_path()?;
521 fs::remove_dir(&cascade_hooks_dir).ok();
522 }
523 } else {
524 Output::info(format!("{} hook not found", hook_type.filename()));
525 }
526
527 Ok(())
528 }
529
530 pub fn list_installed_hooks(&self) -> Result<()> {
532 let hooks = vec![
533 HookType::PostCommit,
534 HookType::PrePush,
535 HookType::CommitMsg,
536 HookType::PrepareCommitMsg,
537 HookType::PreCommit,
538 ];
539
540 Output::section("Git Hooks Status");
541
542 let cascade_hooks_dir = self.get_cascade_hooks_dir()?;
544 let using_cascade_hooks = cascade_hooks_dir.exists()
545 && self.get_current_hooks_path()?
546 == Some(cascade_hooks_dir.to_string_lossy().to_string());
547
548 if using_cascade_hooks {
549 Output::success("✓ Cascade hooks are installed and active");
550 Output::info(format!(
551 " Hooks directory: {}",
552 cascade_hooks_dir.display()
553 ));
554
555 let config_dir = self.get_cascade_config_dir()?;
557 let original_path_file = config_dir.join("original-hooks-path");
558 if original_path_file.exists() {
559 let original_path = fs::read_to_string(original_path_file).unwrap_or_default();
560 if !original_path.is_empty() {
561 Output::info(format!(" Chaining to original hooks: {original_path}"));
562 } else {
563 Output::info(" Chaining to original hooks: .git/hooks");
564 }
565 }
566 println!();
567 } else {
568 Output::warning("Cascade hooks are NOT installed in this repository");
569 println!();
570 Output::sub_item("To install Cascade hooks:");
571 Output::command_example("ca hooks install # recommended: 4 essential hooks");
572 Output::command_example(
573 "ca hooks install --all # all 5 hooks + post-commit auto-add",
574 );
575 println!();
576 Output::sub_item("Both options preserve existing hooks by chaining to them");
577 println!();
578 }
579
580 for hook in hooks {
581 let cascade_hook_path = cascade_hooks_dir.join(hook.filename());
582
583 if using_cascade_hooks && cascade_hook_path.exists() {
584 Output::success(format!("{}: {} ✓", hook.filename(), hook.description()));
585 } else {
586 let default_hook_path = self
588 .repo_path
589 .join(".git")
590 .join("hooks")
591 .join(hook.filename());
592 if default_hook_path.exists() {
593 Output::warning(format!(
594 "{}: {} (In .git/hooks, not managed by Cascade)",
595 hook.filename(),
596 hook.description()
597 ));
598 } else {
599 Output::error(format!(
600 "{}: {} (Not installed)",
601 hook.filename(),
602 hook.description()
603 ));
604 }
605 }
606 }
607
608 Ok(())
609 }
610
611 fn get_current_hooks_path(&self) -> Result<Option<String>> {
613 use std::process::Command;
614
615 let output = Command::new("git")
616 .args(["config", "--get", "core.hooksPath"])
617 .current_dir(&self.repo_path)
618 .output()
619 .map_err(|e| CascadeError::config(format!("Failed to check git config: {e}")))?;
620
621 if output.status.success() {
622 let path = String::from_utf8_lossy(&output.stdout).trim().to_string();
623 if path.is_empty() {
624 Ok(None)
625 } else {
626 Ok(Some(path))
627 }
628 } else {
629 Ok(None)
630 }
631 }
632
633 pub fn generate_hook_script(&self, hook_type: &HookType) -> Result<String> {
635 let cascade_cli = env::current_exe()
636 .map_err(|e| {
637 CascadeError::config(format!("Failed to get current executable path: {e}"))
638 })?
639 .to_string_lossy()
640 .to_string();
641
642 let script = match hook_type {
643 HookType::PostCommit => self.generate_post_commit_hook(&cascade_cli),
644 HookType::PrePush => self.generate_pre_push_hook(&cascade_cli),
645 HookType::CommitMsg => self.generate_commit_msg_hook(&cascade_cli),
646 HookType::PreCommit => self.generate_pre_commit_hook(&cascade_cli),
647 HookType::PrepareCommitMsg => self.generate_prepare_commit_msg_hook(&cascade_cli),
648 };
649
650 Ok(script)
651 }
652
653 pub fn generate_chaining_hook_script(&self, hook_type: &HookType) -> Result<String> {
655 let cascade_cli = env::current_exe()
656 .map_err(|e| {
657 CascadeError::config(format!("Failed to get current executable path: {e}"))
658 })?
659 .to_string_lossy()
660 .to_string();
661
662 let config_dir = self.get_cascade_config_dir()?;
663 let hook_name = match hook_type {
664 HookType::PostCommit => "post-commit",
665 HookType::PrePush => "pre-push",
666 HookType::CommitMsg => "commit-msg",
667 HookType::PreCommit => "pre-commit",
668 HookType::PrepareCommitMsg => "prepare-commit-msg",
669 };
670
671 let cascade_logic = match hook_type {
673 HookType::PostCommit => self.generate_post_commit_hook(&cascade_cli),
674 HookType::PrePush => self.generate_pre_push_hook(&cascade_cli),
675 HookType::CommitMsg => self.generate_commit_msg_hook(&cascade_cli),
676 HookType::PreCommit => self.generate_pre_commit_hook(&cascade_cli),
677 HookType::PrepareCommitMsg => self.generate_prepare_commit_msg_hook(&cascade_cli),
678 };
679
680 #[cfg(windows)]
682 return Ok(format!(
683 "@echo off\n\
684 rem Cascade CLI Hook Wrapper - {}\n\
685 rem This hook runs Cascade logic first, then chains to original hooks\n\n\
686 rem Run Cascade logic first\n\
687 call :cascade_logic %*\n\
688 set CASCADE_RESULT=%ERRORLEVEL%\n\
689 if %CASCADE_RESULT% neq 0 exit /b %CASCADE_RESULT%\n\n\
690 rem Check for original hook\n\
691 set ORIGINAL_HOOKS_PATH=\n\
692 if exist \"{}\\original-hooks-path\" (\n\
693 set /p ORIGINAL_HOOKS_PATH=<\"{}\\original-hooks-path\"\n\
694 )\n\n\
695 if \"%ORIGINAL_HOOKS_PATH%\"==\"\" (\n\
696 rem Default location\n\
697 for /f \"tokens=*\" %%i in ('git rev-parse --git-dir 2^>nul') do set GIT_DIR=%%i\n\
698 if exist \"%GIT_DIR%\\hooks\\{}\" (\n\
699 call \"%GIT_DIR%\\hooks\\{}\" %*\n\
700 exit /b %ERRORLEVEL%\n\
701 )\n\
702 ) else (\n\
703 rem Custom hooks path\n\
704 if exist \"%ORIGINAL_HOOKS_PATH%\\{}\" (\n\
705 call \"%ORIGINAL_HOOKS_PATH%\\{}\" %*\n\
706 exit /b %ERRORLEVEL%\n\
707 )\n\
708 )\n\n\
709 exit /b 0\n\n\
710 :cascade_logic\n\
711 {}\n\
712 exit /b %ERRORLEVEL%\n",
713 hook_name,
714 config_dir.to_string_lossy(),
715 config_dir.to_string_lossy(),
716 hook_name,
717 hook_name,
718 hook_name,
719 hook_name,
720 cascade_logic
721 ));
722
723 #[cfg(not(windows))]
724 {
725 let trimmed_logic = cascade_logic
727 .trim_start_matches("#!/bin/sh\n")
728 .trim_start_matches("set -e\n");
729
730 let wrapper = format!(
731 "#!/bin/sh\n\
732 # Cascade CLI Hook Wrapper - {}\n\
733 # This hook runs Cascade logic first, then chains to original hooks\n\n\
734 set -e\n\n\
735 # Function to run Cascade logic\n\
736 cascade_logic() {{\n",
737 hook_name
738 );
739
740 let chaining_logic = format!(
741 "\n\
742 }}\n\n\
743 # Run Cascade logic first\n\
744 cascade_logic \"$@\"\n\
745 CASCADE_RESULT=$?\n\
746 if [ $CASCADE_RESULT -ne 0 ]; then\n\
747 exit $CASCADE_RESULT\n\
748 fi\n\n\
749 # Check for original hook\n\
750 ORIGINAL_HOOKS_PATH=\"\"\n\
751 if [ -f \"{}/original-hooks-path\" ]; then\n\
752 ORIGINAL_HOOKS_PATH=$(cat \"{}/original-hooks-path\" 2>/dev/null || echo \"\")\n\
753 fi\n\n\
754 if [ -z \"$ORIGINAL_HOOKS_PATH\" ]; then\n\
755 # Default location\n\
756 GIT_DIR=$(git rev-parse --git-dir 2>/dev/null || echo \".git\")\n\
757 ORIGINAL_HOOK=\"$GIT_DIR/hooks/{}\"\n\
758 else\n\
759 # Custom hooks path\n\
760 ORIGINAL_HOOK=\"$ORIGINAL_HOOKS_PATH/{}\"\n\
761 fi\n\n\
762 # Run original hook if it exists and is executable\n\
763 if [ -x \"$ORIGINAL_HOOK\" ]; then\n\
764 \"$ORIGINAL_HOOK\" \"$@\"\n\
765 exit $?\n\
766 fi\n\n\
767 exit 0\n",
768 config_dir.to_string_lossy(),
769 config_dir.to_string_lossy(),
770 hook_name,
771 hook_name
772 );
773
774 Ok(format!("{}{}{}", wrapper, trimmed_logic, chaining_logic))
775 }
776 }
777
778 fn generate_post_commit_hook(&self, cascade_cli: &str) -> String {
779 #[cfg(windows)]
780 {
781 format!(
782 "@echo off\n\
783 rem Cascade CLI Hook - Post Commit\n\
784 rem Automatically adds new commits to the active stack\n\n\
785 rem Get the commit hash and message\n\
786 for /f \"tokens=*\" %%i in ('git rev-parse HEAD') do set COMMIT_HASH=%%i\n\
787 for /f \"tokens=*\" %%i in ('git log --format=%%s -n 1 HEAD') do set COMMIT_MSG=%%i\n\n\
788 rem Find repository root and check if Cascade is initialized\n\
789 for /f \"tokens=*\" %%i in ('git rev-parse --show-toplevel 2^>nul') do set REPO_ROOT=%%i\n\
790 if \"%REPO_ROOT%\"==\"\" set REPO_ROOT=.\n\
791 if not exist \"%REPO_ROOT%\\.cascade\" (\n\
792 echo ℹ️ Cascade not initialized, skipping stack management\n\
793 echo 💡 Run 'ca init' to start using stacked diffs\n\
794 exit /b 0\n\
795 )\n\n\
796 rem Check if there's an active stack\n\
797 \"{cascade_cli}\" stack list --active >nul 2>&1\n\
798 if %ERRORLEVEL% neq 0 (\n\
799 echo ℹ️ No active stack found, commit will not be added to any stack\n\
800 echo 💡 Use 'ca stack create ^<name^>' to create a stack for this commit\n\
801 exit /b 0\n\
802 )\n\n\
803 rem Add commit to active stack\n\
804 echo 🪝 Adding commit to active stack...\n\
805 echo 📝 Commit: %COMMIT_MSG%\n\
806 \"{cascade_cli}\" stack push --commit \"%COMMIT_HASH%\" --message \"%COMMIT_MSG%\"\n\
807 if %ERRORLEVEL% equ 0 (\n\
808 echo ✅ Commit added to stack successfully\n\
809 echo 💡 Next: 'ca submit' to create PRs when ready\n\
810 ) else (\n\
811 echo ⚠️ Failed to add commit to stack\n\
812 echo 💡 You can manually add it with: ca push --commit %COMMIT_HASH%\n\
813 )\n"
814 )
815 }
816
817 #[cfg(not(windows))]
818 {
819 format!(
820 "#!/bin/sh\n\
821 # Cascade CLI Hook - Post Commit\n\
822 # Automatically adds new commits to the active stack\n\n\
823 set -e\n\n\
824 # Get the commit hash and message\n\
825 COMMIT_HASH=$(git rev-parse HEAD)\n\
826 COMMIT_MSG=$(git log --format=%s -n 1 HEAD)\n\n\
827 # Find repository root and check if Cascade is initialized\n\
828 REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo \".\")\n\
829 if [ ! -d \"$REPO_ROOT/.cascade\" ]; then\n\
830 echo \"ℹ️ Cascade not initialized, skipping stack management\"\n\
831 echo \"💡 Run 'ca init' to start using stacked diffs\"\n\
832 exit 0\n\
833 fi\n\n\
834 # Check if there's an active stack\n\
835 if ! \"{cascade_cli}\" stack list --active > /dev/null 2>&1; then\n\
836 echo \"ℹ️ No active stack found, commit will not be added to any stack\"\n\
837 echo \"💡 Use 'ca stack create <name>' to create a stack for this commit\"\n\
838 exit 0\n\
839 fi\n\n\
840 # Add commit to active stack (using specific commit targeting)\n\
841 echo \"🪝 Adding commit to active stack...\"\n\
842 echo \"📝 Commit: $COMMIT_MSG\"\n\
843 if \"{cascade_cli}\" stack push --commit \"$COMMIT_HASH\" --message \"$COMMIT_MSG\"; then\n\
844 echo \"✅ Commit added to stack successfully\"\n\
845 echo \"💡 Next: 'ca submit' to create PRs when ready\"\n\
846 else\n\
847 echo \"⚠️ Failed to add commit to stack\"\n\
848 echo \"💡 You can manually add it with: ca push --commit $COMMIT_HASH\"\n\
849 fi\n"
850 )
851 }
852 }
853
854 fn generate_pre_push_hook(&self, cascade_cli: &str) -> String {
855 #[cfg(windows)]
856 {
857 format!(
858 "@echo off\n\
859 rem Cascade CLI Hook - Pre Push\n\
860 rem Prevents force pushes and validates stack state\n\n\
861 rem Allow force pushes from Cascade internal commands (ca sync, ca submit, etc.)\n\
862 if \"%CASCADE_INTERNAL_PUSH%\"==\"1\" (\n\
863 exit /b 0\n\
864 )\n\n\
865 rem Check for force push from user\n\
866 echo %* | findstr /C:\"--force\" /C:\"--force-with-lease\" /C:\"-f\" >nul\n\
867 if %ERRORLEVEL% equ 0 (\n\
868 echo ERROR: Force push detected\n\
869 echo Cascade CLI uses stacked diffs - force pushes can break stack integrity\n\
870 echo.\n\
871 echo Instead, try these commands:\n\
872 echo ca sync - Sync with remote changes ^(handles rebasing^)\n\
873 echo ca push - Push all unpushed commits\n\
874 echo ca submit - Submit all entries for review\n\
875 echo ca autoland - Auto-merge when approved + builds pass\n\
876 echo.\n\
877 echo If you really need to force push:\n\
878 echo git push --force-with-lease [remote] [branch]\n\
879 echo ^(But consider if this will affect other stack entries^)\n\
880 exit /b 1\n\
881 )\n\n\
882 rem Find repository root and check if Cascade is initialized\n\
883 for /f \"tokens=*\" %%i in ('git rev-parse --show-toplevel 2^>nul') do set REPO_ROOT=%%i\n\
884 if \"%REPO_ROOT%\"==\"\" set REPO_ROOT=.\n\
885 if not exist \"%REPO_ROOT%\\.cascade\" (\n\
886 exit /b 0\n\
887 )\n\n\
888 rem Validate stack state (silent unless error)\n\
889 \"{cascade_cli}\" validate >nul 2>&1\n\
890 if %ERRORLEVEL% neq 0 (\n\
891 echo Stack validation failed - run 'ca validate' for details\n\
892 exit /b 1\n\
893 )\n"
894 )
895 }
896
897 #[cfg(not(windows))]
898 {
899 format!(
900 "#!/bin/sh\n\
901 # Cascade CLI Hook - Pre Push\n\
902 # Prevents force pushes and validates stack state\n\n\
903 set -e\n\n\
904 # Allow force pushes from Cascade internal commands (ca sync, ca submit, etc.)\n\
905 if [ \"$CASCADE_INTERNAL_PUSH\" = \"1\" ]; then\n\
906 exit 0\n\
907 fi\n\n\
908 # Check for force push from user\n\
909 if echo \"$*\" | grep -q -- \"--force\\|--force-with-lease\\|-f\"; then\n\
910 echo \"ERROR: Force push detected\"\n\
911 echo \"Cascade CLI uses stacked diffs - force pushes can break stack integrity\"\n\
912 echo \"\"\n\
913 echo \"Instead, try these commands:\"\n\
914 echo \" ca sync - Sync with remote changes (handles rebasing)\"\n\
915 echo \" ca push - Push all unpushed commits\"\n\
916 echo \" ca submit - Submit all entries for review\"\n\
917 echo \" ca autoland - Auto-merge when approved + builds pass\"\n\
918 echo \"\"\n\
919 echo \"If you really need to force push:\"\n\
920 echo \" git push --force-with-lease [remote] [branch]\"\n\
921 echo \" (But consider if this will affect other stack entries)\"\n\
922 exit 1\n\
923 fi\n\n\
924 # Find repository root and check if Cascade is initialized\n\
925 REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo \".\")\n\
926 if [ ! -d \"$REPO_ROOT/.cascade\" ]; then\n\
927 exit 0\n\
928 fi\n\n\
929 # Validate stack state (silent unless error)\n\
930 if ! \"{cascade_cli}\" validate > /dev/null 2>&1; then\n\
931 echo \"Stack validation failed - run 'ca validate' for details\"\n\
932 exit 1\n\
933 fi\n"
934 )
935 }
936 }
937
938 fn generate_commit_msg_hook(&self, _cascade_cli: &str) -> String {
939 #[cfg(windows)]
940 {
941 r#"@echo off
942rem Cascade CLI Hook - Commit Message
943rem Validates commit message format
944
945set COMMIT_MSG_FILE=%1
946if "%COMMIT_MSG_FILE%"=="" (
947 echo ERROR: No commit message file provided
948 exit /b 1
949)
950
951rem Read commit message (Windows batch is limited, but this covers basic cases)
952for /f "delims=" %%i in ('type "%COMMIT_MSG_FILE%"') do set COMMIT_MSG=%%i
953
954rem Skip validation for merge commits, fixup commits, etc.
955echo %COMMIT_MSG% | findstr /B /C:"Merge" /C:"Revert" /C:"fixup!" /C:"squash!" >nul
956if %ERRORLEVEL% equ 0 exit /b 0
957
958rem Find repository root and check if Cascade is initialized
959for /f "tokens=*" %%i in ('git rev-parse --show-toplevel 2^>nul') do set REPO_ROOT=%%i
960if "%REPO_ROOT%"=="" set REPO_ROOT=.
961if not exist "%REPO_ROOT%\.cascade" exit /b 0
962
963rem Basic commit message validation
964echo %COMMIT_MSG% | findstr /R "^..........*" >nul
965if %ERRORLEVEL% neq 0 (
966 echo ERROR: Commit message too short (minimum 10 characters)
967 echo TIP: Write a descriptive commit message for better stack management
968 exit /b 1
969)
970
971rem Validation passed (silent success)
972exit /b 0
973"#
974 .to_string()
975 }
976
977 #[cfg(not(windows))]
978 {
979 r#"#!/bin/sh
980# Cascade CLI Hook - Commit Message
981# Validates commit message format
982
983set -e
984
985COMMIT_MSG_FILE="$1"
986COMMIT_MSG=$(cat "$COMMIT_MSG_FILE")
987
988# Skip validation for merge commits, fixup commits, etc.
989if echo "$COMMIT_MSG" | grep -E "^(Merge|Revert|fixup!|squash!)" > /dev/null; then
990 exit 0
991fi
992
993# Find repository root and check if Cascade is initialized
994REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
995if [ ! -d "$REPO_ROOT/.cascade" ]; then
996 exit 0
997fi
998
999# Basic commit message validation
1000if [ ${#COMMIT_MSG} -lt 10 ]; then
1001 echo "ERROR: Commit message too short (minimum 10 characters)"
1002 echo "TIP: Write a descriptive commit message for better stack management"
1003 exit 1
1004fi
1005
1006# Validation passed (silent success)
1007exit 0
1008"#
1009 .to_string()
1010 }
1011 }
1012
1013 #[allow(clippy::uninlined_format_args)]
1014 fn generate_pre_commit_hook(&self, cascade_cli: &str) -> String {
1015 #[cfg(windows)]
1016 {
1017 format!(
1018 "@echo off\n\
1019 rem Cascade CLI Hook - Pre Commit\n\
1020 rem Smart edit mode guidance for better UX\n\n\
1021 rem Check if Cascade is initialized\n\
1022 for /f \\\"tokens=*\\\" %%i in ('git rev-parse --show-toplevel 2^>nul') do set REPO_ROOT=%%i\n\
1023 if \\\"%REPO_ROOT%\\\"==\\\"\\\" set REPO_ROOT=.\n\
1024 if not exist \\\"%REPO_ROOT%\\.cascade\\\" exit /b 0\n\n\
1025 rem Get edit status\n\
1026 for /f \\\"tokens=*\\\" %%i in ('\\\"{0}\\\" entry status --quiet 2^>nul') do set EDIT_STATUS=%%i\n\
1027 if \\\"%EDIT_STATUS%\\\"==\\\"\\\" set EDIT_STATUS=inactive\n\n\
1028 rem Check if edit status is active\n\
1029 echo %EDIT_STATUS% | findstr /b \\\"active:\\\" >nul\n\
1030 if %ERRORLEVEL% equ 0 (\n\
1031 echo You're in EDIT MODE for a stack entry\n\
1032 echo.\n\
1033 echo Choose your action:\n\
1034 echo [A] Amend: Modify the current entry ^(default^)\n\
1035 echo [N] New: Create new entry on top\n\
1036 echo [C] Cancel: Stop and think about it\n\
1037 echo.\n\
1038 set /p choice=\\\"Your choice (A/n/c): \\\" <CON\n\
1039 if \\\"%choice%\\\"==\\\"\\\" set choice=A\n\
1040 \n\
1041 if /i \\\"%choice%\\\"==\\\"A\\\" (\n\
1042 rem Use ca entry amend to update entry ^(ignore any -m flag^)\n\
1043 rem The --all flag will stage changes automatically\n\
1044 \\\"{0}\\\" entry amend --all\n\
1045 exit /b %ERRORLEVEL%\n\
1046 ) else if /i \\\"%choice%\\\"==\\\"N\\\" (\n\
1047 echo Creating new stack entry...\n\
1048 echo The commit will proceed and post-commit hook will add it to your stack\n\
1049 rem Let commit proceed ^(Git will use -m flag or open editor^)\n\
1050 exit /b 0\n\
1051 ) else if /i \\\"%choice%\\\"==\\\"C\\\" (\n\
1052 echo Commit cancelled\n\
1053 exit /b 1\n\
1054 ) else (\n\
1055 echo Invalid choice. Please choose A, n, or c\n\
1056 exit /b 1\n\
1057 )\n\
1058 )\n\n\
1059 rem Not in edit mode, proceed normally\n\
1060 exit /b 0\n",
1061 cascade_cli
1062 )
1063 }
1064
1065 #[cfg(not(windows))]
1066 {
1067 let status_check = format!(
1070 "EDIT_STATUS=$(\"{}\" entry status --quiet 2>/dev/null || echo \"inactive\")",
1071 cascade_cli
1072 );
1073 let amend_line = format!(" \"{}\" entry amend --all", cascade_cli);
1074
1075 vec![
1076 "#!/bin/sh".to_string(),
1077 "# Cascade CLI Hook - Pre Commit".to_string(),
1078 "# Smart edit mode guidance for better UX".to_string(),
1079 "".to_string(),
1080 "set -e".to_string(),
1081 "".to_string(),
1082 "# Check if Cascade is initialized".to_string(),
1083 r#"REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")"#.to_string(),
1084 r#"if [ ! -d "$REPO_ROOT/.cascade" ]; then"#.to_string(),
1085 " exit 0".to_string(),
1086 "fi".to_string(),
1087 "".to_string(),
1088 "# Check if we're in edit mode".to_string(),
1089 r#"CURRENT_BRANCH=$(git branch --show-current 2>/dev/null)"#.to_string(),
1090 status_check,
1091 "".to_string(),
1092 "# If in edit mode, prompt for action".to_string(),
1093 r#"if echo "$EDIT_STATUS" | grep -q "^active:"; then"#.to_string(),
1094 " # Proper edit mode - prompt user".to_string(),
1095 r#" echo "You're in EDIT MODE for a stack entry""#.to_string(),
1096 r#" echo """#.to_string(),
1097 r#" echo "Choose your action:""#.to_string(),
1098 r#" echo " [A] Amend: Modify the current entry (default)""#.to_string(),
1099 r#" echo " [N] New: Create new entry on top""#.to_string(),
1100 r#" echo " [C] Cancel: Stop and think about it""#.to_string(),
1101 r#" echo """#.to_string(),
1102 " ".to_string(),
1103 " # Read user choice with default to amend".to_string(),
1104 r#" read -p "Your choice (A/n/c): " choice < /dev/tty"#.to_string(),
1105 " choice=${choice:-A}".to_string(),
1106 " ".to_string(),
1107 " ".to_string(),
1108 r#" case "$choice" in"#.to_string(),
1109 " [Aa])".to_string(),
1110 " # Use ca entry amend to properly update entry + working branch (ignore any -m flag)"
1111 .to_string(),
1112 " # The --all flag will stage changes automatically".to_string(),
1113 amend_line.replace(" ", " "),
1114 " exit $?".to_string(),
1115 " ;;".to_string(),
1116 " [Nn])".to_string(),
1117 r#" echo "Creating new stack entry...""#.to_string(),
1118 r#" echo "The commit will proceed and post-commit hook will add it to your stack""#.to_string(),
1119 " # Let the commit proceed normally (Git will use -m flag or open editor)"
1120 .to_string(),
1121 " exit 0".to_string(),
1122 " ;;".to_string(),
1123 " [Cc])".to_string(),
1124 r#" echo "Commit cancelled""#.to_string(),
1125 " exit 1".to_string(),
1126 " ;;".to_string(),
1127 " *)".to_string(),
1128 r#" echo "Invalid choice. Please choose A, n, or c""#.to_string(),
1129 " exit 1".to_string(),
1130 " ;;".to_string(),
1131 " esac".to_string(),
1132 "fi".to_string(),
1133 "".to_string(),
1134 "# Not in edit mode, proceed normally".to_string(),
1135 "exit 0".to_string(),
1136 ]
1137 .join("\n")
1138 }
1139 }
1140
1141 fn generate_prepare_commit_msg_hook(&self, cascade_cli: &str) -> String {
1142 #[cfg(windows)]
1143 {
1144 format!(
1145 "@echo off\n\
1146 rem Cascade CLI Hook - Prepare Commit Message\n\
1147 rem Adds stack context to commit messages\n\n\
1148 set COMMIT_MSG_FILE=%1\n\
1149 set COMMIT_SOURCE=%2\n\
1150 set COMMIT_SHA=%3\n\n\
1151 rem Only modify message if it's a regular commit (not merge, template, etc.)\n\
1152 if not \"%COMMIT_SOURCE%\"==\"\" if not \"%COMMIT_SOURCE%\"==\"message\" exit /b 0\n\n\
1153 rem Find repository root and check if Cascade is initialized\n\
1154 for /f \"tokens=*\" %%i in ('git rev-parse --show-toplevel 2^>nul') do set REPO_ROOT=%%i\n\
1155 if \"%REPO_ROOT%\"==\"\" set REPO_ROOT=.\n\
1156 if not exist \"%REPO_ROOT%\\.cascade\" exit /b 0\n\n\
1157 rem Check if in edit mode first\n\
1158 for /f \"tokens=*\" %%i in ('\"{cascade_cli}\" entry status --quiet 2^>nul') do set EDIT_STATUS=%%i\n\
1159 if \"%EDIT_STATUS%\"==\"\" set EDIT_STATUS=inactive\n\n\
1160 if not \"%EDIT_STATUS%\"==\"inactive\" (\n\
1161 rem In edit mode - add minimal context\n\
1162 set /p CURRENT_MSG=<%COMMIT_MSG_FILE%\n\n\
1163 rem Skip if message already has edit guidance\n\
1164 echo !CURRENT_MSG! | findstr \"[EDIT MODE]\" >nul\n\
1165 if %ERRORLEVEL% equ 0 exit /b 0\n\n\
1166 rem Add simple edit mode marker\n\
1167 echo.\n\
1168 echo # [EDIT MODE] Editing stack entry\n\
1169 echo # The pre-commit hook will prompt you for Amend/New choice\n\
1170 echo.\n\
1171 type \"%COMMIT_MSG_FILE%\"\n\
1172 ) > \"%COMMIT_MSG_FILE%.tmp\" && (\n\
1173 move \"%COMMIT_MSG_FILE%.tmp\" \"%COMMIT_MSG_FILE%\"\n\
1174 ) else (\n\
1175 rem Regular stack mode - check for active stack\n\
1176 for /f \"tokens=*\" %%i in ('\"{cascade_cli}\" stack list --active --format=name 2^>nul') do set ACTIVE_STACK=%%i\n\n\
1177 if not \"%ACTIVE_STACK%\"==\"\" (\n\
1178 rem Get current commit message\n\
1179 set /p CURRENT_MSG=<%COMMIT_MSG_FILE%\n\n\
1180 rem Skip if message already has stack context\n\
1181 echo !CURRENT_MSG! | findstr \"[stack:\" >nul\n\
1182 if %ERRORLEVEL% equ 0 exit /b 0\n\n\
1183 rem Add stack context to commit message\n\
1184 echo.\n\
1185 echo # Stack: %ACTIVE_STACK%\n\
1186 echo # This commit will be added to the active stack automatically.\n\
1187 echo # Use 'ca stack status' to see the current stack state.\n\
1188 type \"%COMMIT_MSG_FILE%\"\n\
1189 ) > \"%COMMIT_MSG_FILE%.tmp\"\n\
1190 move \"%COMMIT_MSG_FILE%.tmp\" \"%COMMIT_MSG_FILE%\"\n\
1191 )\n"
1192 )
1193 }
1194
1195 #[cfg(not(windows))]
1196 {
1197 format!(
1198 "#!/bin/sh\n\
1199 # Cascade CLI Hook - Prepare Commit Message\n\
1200 # Adds stack context to commit messages\n\n\
1201 set -e\n\n\
1202 COMMIT_MSG_FILE=\"$1\"\n\
1203 COMMIT_SOURCE=\"$2\"\n\
1204 COMMIT_SHA=\"$3\"\n\n\
1205 # Only modify message if it's a regular commit (not merge, template, etc.)\n\
1206 if [ \"$COMMIT_SOURCE\" != \"\" ] && [ \"$COMMIT_SOURCE\" != \"message\" ]; then\n\
1207 exit 0\n\
1208 fi\n\n\
1209 # Find repository root and check if Cascade is initialized\n\
1210 REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo \".\")\n\
1211 if [ ! -d \"$REPO_ROOT/.cascade\" ]; then\n\
1212 exit 0\n\
1213 fi\n\n\
1214 # Check if in edit mode first\n\
1215 EDIT_STATUS=$(\"{cascade_cli}\" entry status --quiet 2>/dev/null || echo \"inactive\")\n\
1216 \n\
1217 if [ \"$EDIT_STATUS\" != \"inactive\" ]; then\n\
1218 # In edit mode - add minimal context\n\
1219 CURRENT_MSG=$(cat \"$COMMIT_MSG_FILE\")\n\
1220 \n\
1221 # Skip if message already has edit guidance\n\
1222 if echo \"$CURRENT_MSG\" | grep -q \"\\[EDIT MODE\\]\"; then\n\
1223 exit 0\n\
1224 fi\n\
1225 \n\
1226 echo \"\n\
1227 # [EDIT MODE] Editing stack entry\n\
1228 # The pre-commit hook will prompt you for Amend/New choice\n\
1229 \n\
1230 $CURRENT_MSG\" > \"$COMMIT_MSG_FILE\"\n\
1231 else\n\
1232 # Regular stack mode - check for active stack\n\
1233 ACTIVE_STACK=$(\"{cascade_cli}\" stack list --active --format=name 2>/dev/null || echo \"\")\n\
1234 \n\
1235 if [ -n \"$ACTIVE_STACK\" ]; then\n\
1236 # Get current commit message\n\
1237 CURRENT_MSG=$(cat \"$COMMIT_MSG_FILE\")\n\
1238 \n\
1239 # Skip if message already has stack context\n\
1240 if echo \"$CURRENT_MSG\" | grep -q \"\\[stack:\"; then\n\
1241 exit 0\n\
1242 fi\n\
1243 \n\
1244 # Add stack context to commit message\n\
1245 echo \"\n\
1246 # Stack: $ACTIVE_STACK\n\
1247 # This commit will be added to the active stack automatically.\n\
1248 # Use 'ca stack status' to see the current stack state.\n\
1249 $CURRENT_MSG\" > \"$COMMIT_MSG_FILE\"\n\
1250 fi\n\
1251 fi\n"
1252 )
1253 }
1254 }
1255
1256 pub fn detect_repository_type(&self) -> Result<RepositoryType> {
1258 let output = Command::new("git")
1259 .args(["remote", "get-url", "origin"])
1260 .current_dir(&self.repo_path)
1261 .output()
1262 .map_err(|e| CascadeError::config(format!("Failed to get remote URL: {e}")))?;
1263
1264 if !output.status.success() {
1265 return Ok(RepositoryType::Unknown);
1266 }
1267
1268 let remote_url = String::from_utf8_lossy(&output.stdout)
1269 .trim()
1270 .to_lowercase();
1271
1272 if remote_url.contains("github.com") {
1273 Ok(RepositoryType::GitHub)
1274 } else if remote_url.contains("gitlab.com") || remote_url.contains("gitlab") {
1275 Ok(RepositoryType::GitLab)
1276 } else if remote_url.contains("dev.azure.com") || remote_url.contains("visualstudio.com") {
1277 Ok(RepositoryType::AzureDevOps)
1278 } else if remote_url.contains("bitbucket") {
1279 Ok(RepositoryType::Bitbucket)
1280 } else {
1281 Ok(RepositoryType::Unknown)
1282 }
1283 }
1284
1285 pub fn detect_branch_type(&self) -> Result<BranchType> {
1287 let output = Command::new("git")
1288 .args(["branch", "--show-current"])
1289 .current_dir(&self.repo_path)
1290 .output()
1291 .map_err(|e| CascadeError::config(format!("Failed to get current branch: {e}")))?;
1292
1293 if !output.status.success() {
1294 return Ok(BranchType::Unknown);
1295 }
1296
1297 let branch_name = String::from_utf8_lossy(&output.stdout)
1298 .trim()
1299 .to_lowercase();
1300
1301 if branch_name == "main" || branch_name == "master" || branch_name == "develop" {
1302 Ok(BranchType::Main)
1303 } else if !branch_name.is_empty() {
1304 Ok(BranchType::Feature)
1305 } else {
1306 Ok(BranchType::Unknown)
1307 }
1308 }
1309
1310 pub fn validate_prerequisites(&self) -> Result<()> {
1312 Output::check_start("Checking prerequisites for Cascade hooks");
1313
1314 let repo_type = self.detect_repository_type()?;
1316 match repo_type {
1317 RepositoryType::Bitbucket => {
1318 Output::success("Bitbucket repository detected");
1319 Output::tip("Hooks will work great with 'ca submit' and 'ca autoland' for Bitbucket integration");
1320 }
1321 RepositoryType::GitHub => {
1322 Output::success("GitHub repository detected");
1323 Output::tip("Consider setting up GitHub Actions for CI/CD integration");
1324 }
1325 RepositoryType::GitLab => {
1326 Output::success("GitLab repository detected");
1327 Output::tip("GitLab CI integration works well with Cascade stacks");
1328 }
1329 RepositoryType::AzureDevOps => {
1330 Output::success("Azure DevOps repository detected");
1331 Output::tip("Azure Pipelines can be configured to work with Cascade workflows");
1332 }
1333 RepositoryType::Unknown => {
1334 Output::info(
1335 "Unknown repository type - hooks will still work for local Git operations",
1336 );
1337 }
1338 }
1339
1340 let config_dir = crate::config::get_repo_config_dir(&self.repo_path)?;
1342 let config_path = config_dir.join("config.json");
1343 if !config_path.exists() {
1344 return Err(CascadeError::config(
1345 "🚫 Cascade not initialized!\n\n\
1346 Please run 'ca init' or 'ca setup' first to configure Cascade CLI.\n\
1347 Hooks require proper Bitbucket Server configuration.\n\n\
1348 Use --force to install anyway (not recommended)."
1349 .to_string(),
1350 ));
1351 }
1352
1353 let config = Settings::load_from_file(&config_path)?;
1355
1356 if config.bitbucket.url == "https://bitbucket.example.com"
1357 || config.bitbucket.url.contains("example.com")
1358 {
1359 return Err(CascadeError::config(
1360 "🚫 Invalid Bitbucket configuration!\n\n\
1361 Your Bitbucket URL appears to be a placeholder.\n\
1362 Please run 'ca setup' to configure a real Bitbucket Server.\n\n\
1363 Use --force to install anyway (not recommended)."
1364 .to_string(),
1365 ));
1366 }
1367
1368 if config.bitbucket.project == "PROJECT" || config.bitbucket.repo == "repo" {
1369 return Err(CascadeError::config(
1370 "🚫 Incomplete Bitbucket configuration!\n\n\
1371 Your project/repository settings appear to be placeholders.\n\
1372 Please run 'ca setup' to complete configuration.\n\n\
1373 Use --force to install anyway (not recommended)."
1374 .to_string(),
1375 ));
1376 }
1377
1378 Output::success("Prerequisites validation passed");
1379 Ok(())
1380 }
1381
1382 pub fn validate_branch_suitability(&self) -> Result<()> {
1384 let branch_type = self.detect_branch_type()?;
1385
1386 match branch_type {
1387 BranchType::Main => {
1388 return Err(CascadeError::config(
1389 "🚫 Currently on main/master branch!\n\n\
1390 Cascade hooks are designed for feature branch development.\n\
1391 Working directly on main/master with stacked diffs can:\n\
1392 • Complicate the commit history\n\
1393 • Interfere with team collaboration\n\
1394 • Break CI/CD workflows\n\n\
1395 💡 Recommended workflow:\n\
1396 1. Create a feature branch: git checkout -b feature/my-feature\n\
1397 2. Install hooks: ca hooks install\n\
1398 3. Develop with stacked commits (auto-added with hooks)\n\
1399 4. Push & submit: ca push && ca submit (all by default)\n\
1400 5. Auto-land when ready: ca autoland\n\n\
1401 Use --force to install anyway (not recommended)."
1402 .to_string(),
1403 ));
1404 }
1405 BranchType::Feature => {
1406 Output::success("Feature branch detected - suitable for stacked development");
1407 }
1408 BranchType::Unknown => {
1409 Output::warning("Unknown branch type - proceeding with caution");
1410 }
1411 }
1412
1413 Ok(())
1414 }
1415
1416 pub fn confirm_installation(&self) -> Result<()> {
1418 Output::section("Hook Installation Summary");
1419
1420 let hooks = vec![
1421 HookType::PostCommit,
1422 HookType::PrePush,
1423 HookType::CommitMsg,
1424 HookType::PrepareCommitMsg,
1425 ];
1426
1427 for hook in &hooks {
1428 Output::sub_item(format!("{}: {}", hook.filename(), hook.description()));
1429 }
1430
1431 println!();
1432 Output::section("These hooks will automatically");
1433 Output::bullet("Add commits to your active stack");
1434 Output::bullet("Validate commit messages");
1435 Output::bullet("Prevent force pushes that break stack integrity");
1436 Output::bullet("Add stack context to commit messages");
1437
1438 println!();
1439 Output::section("With hooks + new defaults, your workflow becomes");
1440 Output::sub_item("git commit → Auto-added to stack");
1441 Output::sub_item("ca push → Pushes all by default");
1442 Output::sub_item("ca submit → Submits all by default");
1443 Output::sub_item("ca autoland → Auto-merges when ready");
1444
1445 let should_install = Confirm::with_theme(&ColorfulTheme::default())
1447 .with_prompt("Install Cascade hooks?")
1448 .default(true)
1449 .interact()
1450 .map_err(|e| CascadeError::config(format!("Failed to get user confirmation: {e}")))?;
1451
1452 if should_install {
1453 Output::success("Proceeding with installation");
1454 Ok(())
1455 } else {
1456 Err(CascadeError::config(
1457 "Installation cancelled by user".to_string(),
1458 ))
1459 }
1460 }
1461}
1462
1463pub async fn install() -> Result<()> {
1465 install_with_options(false, false, false, false).await
1466}
1467
1468pub async fn install_essential() -> Result<()> {
1469 let current_dir = env::current_dir()
1470 .map_err(|e| CascadeError::config(format!("Could not get current directory: {e}")))?;
1471
1472 let repo_root = find_repository_root(¤t_dir)
1473 .map_err(|e| CascadeError::config(format!("Could not find git repository: {e}")))?;
1474
1475 let hooks_manager = HooksManager::new(&repo_root)?;
1476 hooks_manager.install_essential()
1477}
1478
1479pub async fn install_with_options(
1480 skip_checks: bool,
1481 allow_main_branch: bool,
1482 yes: bool,
1483 force: bool,
1484) -> Result<()> {
1485 let current_dir = env::current_dir()
1486 .map_err(|e| CascadeError::config(format!("Could not get current directory: {e}")))?;
1487
1488 let repo_root = find_repository_root(¤t_dir)
1489 .map_err(|e| CascadeError::config(format!("Could not find git repository: {e}")))?;
1490
1491 let hooks_manager = HooksManager::new(&repo_root)?;
1492
1493 let options = InstallOptions {
1494 check_prerequisites: !skip_checks,
1495 feature_branches_only: !allow_main_branch,
1496 confirm: !yes,
1497 force,
1498 };
1499
1500 hooks_manager.install_with_options(&options)
1501}
1502
1503pub async fn uninstall() -> Result<()> {
1504 let current_dir = env::current_dir()
1505 .map_err(|e| CascadeError::config(format!("Could not get current directory: {e}")))?;
1506
1507 let repo_root = find_repository_root(¤t_dir)
1508 .map_err(|e| CascadeError::config(format!("Could not find git repository: {e}")))?;
1509
1510 let hooks_manager = HooksManager::new(&repo_root)?;
1511 hooks_manager.uninstall_all()
1512}
1513
1514pub async fn status() -> Result<()> {
1515 let current_dir = env::current_dir()
1516 .map_err(|e| CascadeError::config(format!("Could not get current directory: {e}")))?;
1517
1518 let repo_root = find_repository_root(¤t_dir)
1519 .map_err(|e| CascadeError::config(format!("Could not find git repository: {e}")))?;
1520
1521 let hooks_manager = HooksManager::new(&repo_root)?;
1522 hooks_manager.list_installed_hooks()
1523}
1524
1525pub async fn install_hook(hook_name: &str) -> Result<()> {
1526 install_hook_with_options(hook_name, false, false).await
1527}
1528
1529pub async fn install_hook_with_options(
1530 hook_name: &str,
1531 skip_checks: bool,
1532 force: bool,
1533) -> Result<()> {
1534 let current_dir = env::current_dir()
1535 .map_err(|e| CascadeError::config(format!("Could not get current directory: {e}")))?;
1536
1537 let repo_root = find_repository_root(¤t_dir)
1538 .map_err(|e| CascadeError::config(format!("Could not find git repository: {e}")))?;
1539
1540 let hooks_manager = HooksManager::new(&repo_root)?;
1541
1542 let hook_type = match hook_name {
1543 "post-commit" => HookType::PostCommit,
1544 "pre-push" => HookType::PrePush,
1545 "commit-msg" => HookType::CommitMsg,
1546 "pre-commit" => HookType::PreCommit,
1547 "prepare-commit-msg" => HookType::PrepareCommitMsg,
1548 _ => {
1549 return Err(CascadeError::config(format!(
1550 "Unknown hook type: {hook_name}"
1551 )))
1552 }
1553 };
1554
1555 if !skip_checks && !force {
1557 hooks_manager.validate_prerequisites()?;
1558 }
1559
1560 hooks_manager.install_hook(&hook_type)
1561}
1562
1563pub async fn uninstall_hook(hook_name: &str) -> Result<()> {
1564 let current_dir = env::current_dir()
1565 .map_err(|e| CascadeError::config(format!("Could not get current directory: {e}")))?;
1566
1567 let repo_root = find_repository_root(¤t_dir)
1568 .map_err(|e| CascadeError::config(format!("Could not find git repository: {e}")))?;
1569
1570 let hooks_manager = HooksManager::new(&repo_root)?;
1571
1572 let hook_type = match hook_name {
1573 "post-commit" => HookType::PostCommit,
1574 "pre-push" => HookType::PrePush,
1575 "commit-msg" => HookType::CommitMsg,
1576 "pre-commit" => HookType::PreCommit,
1577 "prepare-commit-msg" => HookType::PrepareCommitMsg,
1578 _ => {
1579 return Err(CascadeError::config(format!(
1580 "Unknown hook type: {hook_name}"
1581 )))
1582 }
1583 };
1584
1585 hooks_manager.uninstall_hook(&hook_type)
1586}
1587
1588#[cfg(test)]
1589mod tests {
1590 use super::*;
1591 use std::process::Command;
1592 use tempfile::TempDir;
1593
1594 fn create_test_repo() -> (TempDir, std::path::PathBuf) {
1595 let temp_dir = TempDir::new().unwrap();
1596 let repo_path = temp_dir.path().to_path_buf();
1597
1598 Command::new("git")
1600 .args(["init"])
1601 .current_dir(&repo_path)
1602 .output()
1603 .unwrap();
1604 Command::new("git")
1605 .args(["config", "user.name", "Test"])
1606 .current_dir(&repo_path)
1607 .output()
1608 .unwrap();
1609 Command::new("git")
1610 .args(["config", "user.email", "test@test.com"])
1611 .current_dir(&repo_path)
1612 .output()
1613 .unwrap();
1614
1615 std::fs::write(repo_path.join("README.md"), "# Test").unwrap();
1617 Command::new("git")
1618 .args(["add", "."])
1619 .current_dir(&repo_path)
1620 .output()
1621 .unwrap();
1622 Command::new("git")
1623 .args(["commit", "-m", "Initial"])
1624 .current_dir(&repo_path)
1625 .output()
1626 .unwrap();
1627
1628 crate::config::initialize_repo(&repo_path, Some("https://test.bitbucket.com".to_string()))
1630 .unwrap();
1631
1632 (temp_dir, repo_path)
1633 }
1634
1635 #[test]
1636 fn test_hooks_manager_creation() {
1637 let (_temp_dir, repo_path) = create_test_repo();
1638 let _manager = HooksManager::new(&repo_path).unwrap();
1639
1640 assert_eq!(_manager.repo_path, repo_path);
1641 assert!(!_manager.repo_id.is_empty());
1643 }
1644
1645 #[test]
1646 fn test_hooks_manager_custom_hooks_path() {
1647 let (_temp_dir, repo_path) = create_test_repo();
1648
1649 Command::new("git")
1651 .args(["config", "core.hooksPath", "custom-hooks"])
1652 .current_dir(&repo_path)
1653 .output()
1654 .unwrap();
1655
1656 let custom_hooks_dir = repo_path.join("custom-hooks");
1658 std::fs::create_dir_all(&custom_hooks_dir).unwrap();
1659
1660 let _manager = HooksManager::new(&repo_path).unwrap();
1661
1662 assert_eq!(_manager.repo_path, repo_path);
1663 assert!(!_manager.repo_id.is_empty());
1665 }
1666
1667 #[test]
1668 fn test_hook_chaining_with_existing_hooks() {
1669 let (_temp_dir, repo_path) = create_test_repo();
1670 let manager = HooksManager::new(&repo_path).unwrap();
1671
1672 let hook_type = HookType::PreCommit;
1673 let hook_path = repo_path.join(".git/hooks").join(hook_type.filename());
1674
1675 let existing_hook_content = "#!/bin/bash\n# Project pre-commit hook\n./scripts/lint.sh\n";
1677 std::fs::write(&hook_path, existing_hook_content).unwrap();
1678 crate::utils::platform::make_executable(&hook_path).unwrap();
1679
1680 let result = manager.install_hook(&hook_type);
1682 assert!(result.is_ok());
1683
1684 let original_content = std::fs::read_to_string(&hook_path).unwrap();
1686 assert!(original_content.contains("# Project pre-commit hook"));
1687 assert!(original_content.contains("./scripts/lint.sh"));
1688
1689 let cascade_hooks_dir = manager.get_cascade_hooks_dir().unwrap();
1691 let cascade_hook_path = cascade_hooks_dir.join(hook_type.filename());
1692 assert!(cascade_hook_path.exists());
1693
1694 let uninstall_result = manager.uninstall_hook(&hook_type);
1696 assert!(uninstall_result.is_ok());
1697
1698 let after_uninstall = std::fs::read_to_string(&hook_path).unwrap();
1700 assert!(after_uninstall.contains("# Project pre-commit hook"));
1701 assert!(after_uninstall.contains("./scripts/lint.sh"));
1702
1703 assert!(!cascade_hook_path.exists());
1705 }
1706
1707 #[test]
1708 fn test_hook_installation() {
1709 let (_temp_dir, repo_path) = create_test_repo();
1710 let manager = HooksManager::new(&repo_path).unwrap();
1711
1712 let hook_type = HookType::PostCommit;
1714 let result = manager.install_hook(&hook_type);
1715 assert!(result.is_ok());
1716
1717 let hook_filename = hook_type.filename();
1719 let cascade_hooks_dir = manager.get_cascade_hooks_dir().unwrap();
1720 let hook_path = cascade_hooks_dir.join(&hook_filename);
1721 assert!(hook_path.exists());
1722
1723 #[cfg(unix)]
1725 {
1726 use std::os::unix::fs::PermissionsExt;
1727 let metadata = std::fs::metadata(&hook_path).unwrap();
1728 let permissions = metadata.permissions();
1729 assert!(permissions.mode() & 0o111 != 0); }
1731
1732 #[cfg(windows)]
1733 {
1734 assert!(hook_filename.ends_with(".bat"));
1736 assert!(hook_path.exists());
1737 }
1738 }
1739
1740 #[test]
1741 fn test_hook_detection() {
1742 let (_temp_dir, repo_path) = create_test_repo();
1743 let _manager = HooksManager::new(&repo_path).unwrap();
1744
1745 let post_commit_path = repo_path
1747 .join(".git/hooks")
1748 .join(HookType::PostCommit.filename());
1749 let pre_push_path = repo_path
1750 .join(".git/hooks")
1751 .join(HookType::PrePush.filename());
1752 let commit_msg_path = repo_path
1753 .join(".git/hooks")
1754 .join(HookType::CommitMsg.filename());
1755
1756 assert!(!post_commit_path.exists());
1758 assert!(!pre_push_path.exists());
1759 assert!(!commit_msg_path.exists());
1760 }
1761
1762 #[test]
1763 fn test_hook_validation() {
1764 let (_temp_dir, repo_path) = create_test_repo();
1765 let manager = HooksManager::new(&repo_path).unwrap();
1766
1767 let validation = manager.validate_prerequisites();
1769 let _ = validation; let branch_validation = manager.validate_branch_suitability();
1775 let _ = branch_validation; }
1778
1779 #[test]
1780 fn test_hook_uninstallation() {
1781 let (_temp_dir, repo_path) = create_test_repo();
1782 let manager = HooksManager::new(&repo_path).unwrap();
1783
1784 let hook_type = HookType::PostCommit;
1786 manager.install_hook(&hook_type).unwrap();
1787
1788 let cascade_hooks_dir = manager.get_cascade_hooks_dir().unwrap();
1789 let hook_path = cascade_hooks_dir.join(hook_type.filename());
1790 assert!(hook_path.exists());
1791
1792 let result = manager.uninstall_hook(&hook_type);
1793 assert!(result.is_ok());
1794 assert!(!hook_path.exists());
1795 }
1796
1797 #[test]
1798 fn test_hook_content_generation() {
1799 let (_temp_dir, repo_path) = create_test_repo();
1800 let manager = HooksManager::new(&repo_path).unwrap();
1801
1802 let binary_name = "cascade-cli";
1804
1805 let post_commit_content = manager.generate_post_commit_hook(binary_name);
1807 #[cfg(windows)]
1808 {
1809 assert!(post_commit_content.contains("@echo off"));
1810 assert!(post_commit_content.contains("rem Cascade CLI Hook"));
1811 }
1812 #[cfg(not(windows))]
1813 {
1814 assert!(post_commit_content.contains("#!/bin/sh"));
1815 assert!(post_commit_content.contains("# Cascade CLI Hook"));
1816 }
1817 assert!(post_commit_content.contains(binary_name));
1818
1819 let pre_push_content = manager.generate_pre_push_hook(binary_name);
1821 #[cfg(windows)]
1822 {
1823 assert!(pre_push_content.contains("@echo off"));
1824 assert!(pre_push_content.contains("rem Cascade CLI Hook"));
1825 }
1826 #[cfg(not(windows))]
1827 {
1828 assert!(pre_push_content.contains("#!/bin/sh"));
1829 assert!(pre_push_content.contains("# Cascade CLI Hook"));
1830 }
1831 assert!(pre_push_content.contains(binary_name));
1832
1833 let commit_msg_content = manager.generate_commit_msg_hook(binary_name);
1835 #[cfg(windows)]
1836 {
1837 assert!(commit_msg_content.contains("@echo off"));
1838 assert!(commit_msg_content.contains("rem Cascade CLI Hook"));
1839 }
1840 #[cfg(not(windows))]
1841 {
1842 assert!(commit_msg_content.contains("#!/bin/sh"));
1843 assert!(commit_msg_content.contains("# Cascade CLI Hook"));
1844 }
1845
1846 let prepare_commit_content = manager.generate_prepare_commit_msg_hook(binary_name);
1848 #[cfg(windows)]
1849 {
1850 assert!(prepare_commit_content.contains("@echo off"));
1851 assert!(prepare_commit_content.contains("rem Cascade CLI Hook"));
1852 }
1853 #[cfg(not(windows))]
1854 {
1855 assert!(prepare_commit_content.contains("#!/bin/sh"));
1856 assert!(prepare_commit_content.contains("# Cascade CLI Hook"));
1857 }
1858 assert!(prepare_commit_content.contains(binary_name));
1859 }
1860
1861 #[test]
1862 fn test_hook_status_reporting() {
1863 let (_temp_dir, repo_path) = create_test_repo();
1864 let manager = HooksManager::new(&repo_path).unwrap();
1865
1866 let repo_type = manager.detect_repository_type().unwrap();
1868 assert!(matches!(
1870 repo_type,
1871 RepositoryType::Bitbucket | RepositoryType::Unknown
1872 ));
1873
1874 let branch_type = manager.detect_branch_type().unwrap();
1876 assert!(matches!(
1878 branch_type,
1879 BranchType::Main | BranchType::Unknown
1880 ));
1881 }
1882
1883 #[test]
1884 fn test_force_installation() {
1885 let (_temp_dir, repo_path) = create_test_repo();
1886 let manager = HooksManager::new(&repo_path).unwrap();
1887
1888 let hook_filename = HookType::PostCommit.filename();
1890 let hook_path = repo_path.join(".git/hooks").join(&hook_filename);
1891
1892 #[cfg(windows)]
1893 let existing_content = "@echo off\necho existing hook";
1894 #[cfg(not(windows))]
1895 let existing_content = "#!/bin/sh\necho 'existing hook'";
1896
1897 std::fs::write(&hook_path, existing_content).unwrap();
1898
1899 let hook_type = HookType::PostCommit;
1901 let result = manager.install_hook(&hook_type);
1902 assert!(result.is_ok());
1903
1904 let cascade_hooks_dir = manager.get_cascade_hooks_dir().unwrap();
1906 let cascade_hook_path = cascade_hooks_dir.join(&hook_filename);
1907 assert!(cascade_hook_path.exists());
1908
1909 let original_content = std::fs::read_to_string(&hook_path).unwrap();
1911 assert!(original_content.contains("existing hook"));
1912
1913 let cascade_content = std::fs::read_to_string(&cascade_hook_path).unwrap();
1915 assert!(cascade_content.contains("cascade-cli") || cascade_content.contains("ca"));
1916 }
1917}