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 \"Tip: 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 \"Tip: 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 \"Tip: 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 \"Tip: 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 Skip hook if called from ca entry amend ^(avoid infinite loop^)\n\
1026 if \\\"%CASCADE_SKIP_HOOKS%\\\"==\\\"1\\\" exit /b 0\n\n\
1027 rem Get edit status\n\
1028 for /f \\\"tokens=*\\\" %%i in ('\\\"{0}\\\" entry status --quiet 2^>nul') do set EDIT_STATUS=%%i\n\
1029 if \\\"%EDIT_STATUS%\\\"==\\\"\\\" set EDIT_STATUS=inactive\n\n\
1030 rem Check if edit status is active\n\
1031 echo %EDIT_STATUS% | findstr /b \\\"active:\\\" >nul\n\
1032 if %ERRORLEVEL% equ 0 (\n\
1033 echo You're in EDIT MODE for a stack entry\n\
1034 echo.\n\
1035 echo Choose your action:\n\
1036 echo [a] amend: Modify the current entry ^(default^)\n\
1037 echo [n] new: Create new entry on top\n\
1038 echo [c] cancel: Stop and think about it\n\
1039 echo.\n\
1040 set /p choice=\\\"Your choice (a/n/c): \\\" <CON\n\
1041 if \\\"%choice%\\\"==\\\"\\\" set choice=a\n\
1042 \n\
1043 if /i \\\"%choice%\\\"==\\\"A\\\" (\n\
1044 rem Use ca entry amend to update entry ^(ignore any -m flag^)\n\
1045 rem The --all flag will stage changes, --restack updates dependent entries\n\
1046 \\\"{0}\\\" entry amend --all --restack\n\
1047 exit /b %ERRORLEVEL%\n\
1048 ) else if /i \\\"%choice%\\\"==\\\"N\\\" (\n\
1049 echo Creating new stack entry...\n\
1050 echo The commit will proceed and post-commit hook will add it to your stack\n\
1051 rem Let commit proceed ^(Git will use -m flag or open editor^)\n\
1052 exit /b 0\n\
1053 ) else if /i \\\"%choice%\\\"==\\\"C\\\" (\n\
1054 echo Commit cancelled\n\
1055 exit /b 1\n\
1056 ) else (\n\
1057 echo Invalid choice. Please choose A, n, or c\n\
1058 exit /b 1\n\
1059 )\n\
1060 )\n\n\
1061 rem Not in edit mode, proceed normally\n\
1062 exit /b 0\n",
1063 cascade_cli
1064 )
1065 }
1066
1067 #[cfg(not(windows))]
1068 {
1069 let status_check = format!(
1072 "EDIT_STATUS=$(\"{}\" entry status --quiet 2>/dev/null || echo \"inactive\")",
1073 cascade_cli
1074 );
1075 let amend_line = format!(" \"{}\" entry amend --all --restack", cascade_cli);
1076
1077 vec![
1078 "#!/bin/sh".to_string(),
1079 "# Cascade CLI Hook - Pre Commit".to_string(),
1080 "# Smart edit mode guidance for better UX".to_string(),
1081 "".to_string(),
1082 "set -e".to_string(),
1083 "".to_string(),
1084 "# Check if Cascade is initialized".to_string(),
1085 r#"REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")"#.to_string(),
1086 r#"if [ ! -d "$REPO_ROOT/.cascade" ]; then"#.to_string(),
1087 " exit 0".to_string(),
1088 "fi".to_string(),
1089 "".to_string(),
1090 "# Skip hook if called from ca entry amend (avoid infinite loop)".to_string(),
1091 r#"if [ "$CASCADE_SKIP_HOOKS" = "1" ]; then"#.to_string(),
1092 " exit 0".to_string(),
1093 "fi".to_string(),
1094 "".to_string(),
1095 "# Check if we're in edit mode".to_string(),
1096 r#"CURRENT_BRANCH=$(git branch --show-current 2>/dev/null)"#.to_string(),
1097 status_check,
1098 "".to_string(),
1099 "# If in edit mode, check if we're on a stack entry branch".to_string(),
1100 r#"if echo "$EDIT_STATUS" | grep -q "^active:"; then"#.to_string(),
1101 " # Check if current branch is a stack entry branch".to_string(),
1102 format!(r#" if ! "{}" stack list --format=json 2>/dev/null | grep -q "\"branch_name\": \"$CURRENT_BRANCH\""; then"#, cascade_cli),
1103 r#" # Not on a stack entry branch - edit mode is for a different branch"#.to_string(),
1104 r#" # Silently proceed with normal commit"#.to_string(),
1105 " exit 0".to_string(),
1106 " fi".to_string(),
1107 " ".to_string(),
1108 " # Proper edit mode - prompt user".to_string(),
1109 r#" echo "You're in EDIT MODE for a stack entry""#.to_string(),
1110 r#" echo """#.to_string(),
1111 r#" echo "Choose your action:""#.to_string(),
1112 r#" echo " [a] amend: Modify the current entry (default)""#.to_string(),
1113 r#" echo " [n] new: Create new entry on top""#.to_string(),
1114 r#" echo " [c] cancel: Stop and think about it""#.to_string(),
1115 r#" echo """#.to_string(),
1116 " ".to_string(),
1117 " # Read user choice with default to amend".to_string(),
1118 r#" read -p "Your choice (a/n/c): " choice < /dev/tty"#.to_string(),
1119 " choice=${choice:-a}".to_string(),
1120 " ".to_string(),
1121 " ".to_string(),
1122 r#" case "$choice" in"#.to_string(),
1123 " [Aa])".to_string(),
1124 " # Use ca entry amend to properly update entry + working branch (ignore any -m flag)"
1125 .to_string(),
1126 " # The --all flag will stage changes automatically".to_string(),
1127 amend_line.replace(" ", " "),
1128 " exit $?".to_string(),
1129 " ;;".to_string(),
1130 " [Nn])".to_string(),
1131 r#" echo "Creating new stack entry...""#.to_string(),
1132 r#" echo "The commit will proceed and post-commit hook will add it to your stack""#.to_string(),
1133 " # Let the commit proceed normally (Git will use -m flag or open editor)"
1134 .to_string(),
1135 " exit 0".to_string(),
1136 " ;;".to_string(),
1137 " [Cc])".to_string(),
1138 r#" echo "Commit cancelled""#.to_string(),
1139 " exit 1".to_string(),
1140 " ;;".to_string(),
1141 " *)".to_string(),
1142 r#" echo "Invalid choice. Please choose A, n, or c""#.to_string(),
1143 " exit 1".to_string(),
1144 " ;;".to_string(),
1145 " esac".to_string(),
1146 "fi".to_string(),
1147 "".to_string(),
1148 "# Not in edit mode, proceed normally".to_string(),
1149 "exit 0".to_string(),
1150 ]
1151 .join("\n")
1152 }
1153 }
1154
1155 fn generate_prepare_commit_msg_hook(&self, cascade_cli: &str) -> String {
1156 #[cfg(windows)]
1157 {
1158 format!(
1159 "@echo off\n\
1160 rem Cascade CLI Hook - Prepare Commit Message\n\
1161 rem Adds stack context to commit messages\n\n\
1162 set COMMIT_MSG_FILE=%1\n\
1163 set COMMIT_SOURCE=%2\n\
1164 set COMMIT_SHA=%3\n\n\
1165 rem Skip if user provided message via -m flag, merge commit, etc.\n\
1166 if not \"%COMMIT_SOURCE%\"==\"\" exit /b 0\n\n\
1167 rem Find repository root and check if Cascade is initialized\n\
1168 for /f \"tokens=*\" %%i in ('git rev-parse --show-toplevel 2^>nul') do set REPO_ROOT=%%i\n\
1169 if \"%REPO_ROOT%\"==\"\" set REPO_ROOT=.\n\
1170 if not exist \"%REPO_ROOT%\\.cascade\" exit /b 0\n\n\
1171 rem Check for active stack\n\
1172 for /f \"tokens=*\" %%i in ('\"{cascade_cli}\" stack list --active --format=name 2^>nul') do set ACTIVE_STACK=%%i\n\n\
1173 if not \"%ACTIVE_STACK%\"==\"\" (\n\
1174 rem Get current commit message\n\
1175 set /p CURRENT_MSG=<%COMMIT_MSG_FILE%\n\n\
1176 rem Skip if message already has stack context\n\
1177 echo !CURRENT_MSG! | findstr \"[stack:\" >nul\n\
1178 if %ERRORLEVEL% equ 0 exit /b 0\n\n\
1179 rem Add stack context to commit message\n\
1180 echo.\n\
1181 echo # Stack: %ACTIVE_STACK%\n\
1182 echo # This commit will be added to the active stack automatically.\n\
1183 echo # Use 'ca stack status' to see the current stack state.\n\
1184 type \"%COMMIT_MSG_FILE%\"\n\
1185 ) > \"%COMMIT_MSG_FILE%.tmp\"\n\
1186 move \"%COMMIT_MSG_FILE%.tmp\" \"%COMMIT_MSG_FILE%\"\n"
1187 )
1188 }
1189
1190 #[cfg(not(windows))]
1191 {
1192 format!(
1193 "#!/bin/sh\n\
1194 # Cascade CLI Hook - Prepare Commit Message\n\
1195 # Adds stack context to commit messages\n\n\
1196 set -e\n\n\
1197 COMMIT_MSG_FILE=\"$1\"\n\
1198 COMMIT_SOURCE=\"$2\"\n\
1199 COMMIT_SHA=\"$3\"\n\n\
1200 # Skip if user provided message via -m flag, merge commit, etc.\n\
1201 if [ \"$COMMIT_SOURCE\" != \"\" ]; then\n\
1202 exit 0\n\
1203 fi\n\n\
1204 # Find repository root and check if Cascade is initialized\n\
1205 REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo \".\")\n\
1206 if [ ! -d \"$REPO_ROOT/.cascade\" ]; then\n\
1207 exit 0\n\
1208 fi\n\n\
1209 # Check for active stack\n\
1210 ACTIVE_STACK=$(\"{cascade_cli}\" stack list --active --format=name 2>/dev/null || echo \"\")\n\
1211 \n\
1212 if [ -n \"$ACTIVE_STACK\" ]; then\n\
1213 # Get current commit message\n\
1214 CURRENT_MSG=$(cat \"$COMMIT_MSG_FILE\")\n\
1215 \n\
1216 # Skip if message already has stack context\n\
1217 if echo \"$CURRENT_MSG\" | grep -q \"\\[stack:\"; then\n\
1218 exit 0\n\
1219 fi\n\
1220 \n\
1221 # Add stack context to commit message\n\
1222 echo \"\n\
1223 # Stack: $ACTIVE_STACK\n\
1224 # This commit will be added to the active stack automatically.\n\
1225 # Use 'ca stack status' to see the current stack state.\n\
1226 $CURRENT_MSG\" > \"$COMMIT_MSG_FILE\"\n\
1227 fi\n"
1228 )
1229 }
1230 }
1231
1232 pub fn detect_repository_type(&self) -> Result<RepositoryType> {
1234 let output = Command::new("git")
1235 .args(["remote", "get-url", "origin"])
1236 .current_dir(&self.repo_path)
1237 .output()
1238 .map_err(|e| CascadeError::config(format!("Failed to get remote URL: {e}")))?;
1239
1240 if !output.status.success() {
1241 return Ok(RepositoryType::Unknown);
1242 }
1243
1244 let remote_url = String::from_utf8_lossy(&output.stdout)
1245 .trim()
1246 .to_lowercase();
1247
1248 if remote_url.contains("github.com") {
1249 Ok(RepositoryType::GitHub)
1250 } else if remote_url.contains("gitlab.com") || remote_url.contains("gitlab") {
1251 Ok(RepositoryType::GitLab)
1252 } else if remote_url.contains("dev.azure.com") || remote_url.contains("visualstudio.com") {
1253 Ok(RepositoryType::AzureDevOps)
1254 } else if remote_url.contains("bitbucket") {
1255 Ok(RepositoryType::Bitbucket)
1256 } else {
1257 Ok(RepositoryType::Unknown)
1258 }
1259 }
1260
1261 pub fn detect_branch_type(&self) -> Result<BranchType> {
1263 let output = Command::new("git")
1264 .args(["branch", "--show-current"])
1265 .current_dir(&self.repo_path)
1266 .output()
1267 .map_err(|e| CascadeError::config(format!("Failed to get current branch: {e}")))?;
1268
1269 if !output.status.success() {
1270 return Ok(BranchType::Unknown);
1271 }
1272
1273 let branch_name = String::from_utf8_lossy(&output.stdout)
1274 .trim()
1275 .to_lowercase();
1276
1277 if branch_name == "main" || branch_name == "master" || branch_name == "develop" {
1278 Ok(BranchType::Main)
1279 } else if !branch_name.is_empty() {
1280 Ok(BranchType::Feature)
1281 } else {
1282 Ok(BranchType::Unknown)
1283 }
1284 }
1285
1286 pub fn validate_prerequisites(&self) -> Result<()> {
1288 Output::check_start("Checking prerequisites for Cascade hooks");
1289
1290 let repo_type = self.detect_repository_type()?;
1292 match repo_type {
1293 RepositoryType::Bitbucket => {
1294 Output::success("Bitbucket repository detected");
1295 Output::tip("Hooks will work great with 'ca submit' and 'ca autoland' for Bitbucket integration");
1296 }
1297 RepositoryType::GitHub => {
1298 Output::success("GitHub repository detected");
1299 Output::tip("Consider setting up GitHub Actions for CI/CD integration");
1300 }
1301 RepositoryType::GitLab => {
1302 Output::success("GitLab repository detected");
1303 Output::tip("GitLab CI integration works well with Cascade stacks");
1304 }
1305 RepositoryType::AzureDevOps => {
1306 Output::success("Azure DevOps repository detected");
1307 Output::tip("Azure Pipelines can be configured to work with Cascade workflows");
1308 }
1309 RepositoryType::Unknown => {
1310 Output::info(
1311 "Unknown repository type - hooks will still work for local Git operations",
1312 );
1313 }
1314 }
1315
1316 let config_dir = crate::config::get_repo_config_dir(&self.repo_path)?;
1318 let config_path = config_dir.join("config.json");
1319 if !config_path.exists() {
1320 return Err(CascadeError::config(
1321 "🚫 Cascade not initialized!\n\n\
1322 Please run 'ca init' or 'ca setup' first to configure Cascade CLI.\n\
1323 Hooks require proper Bitbucket Server configuration.\n\n\
1324 Use --force to install anyway (not recommended)."
1325 .to_string(),
1326 ));
1327 }
1328
1329 let config = Settings::load_from_file(&config_path)?;
1331
1332 if config.bitbucket.url == "https://bitbucket.example.com"
1333 || config.bitbucket.url.contains("example.com")
1334 {
1335 return Err(CascadeError::config(
1336 "🚫 Invalid Bitbucket configuration!\n\n\
1337 Your Bitbucket URL appears to be a placeholder.\n\
1338 Please run 'ca setup' to configure a real Bitbucket Server.\n\n\
1339 Use --force to install anyway (not recommended)."
1340 .to_string(),
1341 ));
1342 }
1343
1344 if config.bitbucket.project == "PROJECT" || config.bitbucket.repo == "repo" {
1345 return Err(CascadeError::config(
1346 "🚫 Incomplete Bitbucket configuration!\n\n\
1347 Your project/repository settings appear to be placeholders.\n\
1348 Please run 'ca setup' to complete configuration.\n\n\
1349 Use --force to install anyway (not recommended)."
1350 .to_string(),
1351 ));
1352 }
1353
1354 Output::success("Prerequisites validation passed");
1355 Ok(())
1356 }
1357
1358 pub fn validate_branch_suitability(&self) -> Result<()> {
1360 let branch_type = self.detect_branch_type()?;
1361
1362 match branch_type {
1363 BranchType::Main => {
1364 return Err(CascadeError::config(
1365 "🚫 Currently on main/master branch!\n\n\
1366 Cascade hooks are designed for feature branch development.\n\
1367 Working directly on main/master with stacked diffs can:\n\
1368 • Complicate the commit history\n\
1369 • Interfere with team collaboration\n\
1370 • Break CI/CD workflows\n\n\
1371 Recommended workflow:\n\
1372 1. Create a feature branch: git checkout -b feature/my-feature\n\
1373 2. Install hooks: ca hooks install\n\
1374 3. Develop with stacked commits (auto-added with hooks)\n\
1375 4. Push & submit: ca push && ca submit (all by default)\n\
1376 5. Auto-land when ready: ca autoland\n\n\
1377 Use --force to install anyway (not recommended)."
1378 .to_string(),
1379 ));
1380 }
1381 BranchType::Feature => {
1382 Output::success("Feature branch detected - suitable for stacked development");
1383 }
1384 BranchType::Unknown => {
1385 Output::warning("Unknown branch type - proceeding with caution");
1386 }
1387 }
1388
1389 Ok(())
1390 }
1391
1392 pub fn confirm_installation(&self) -> Result<()> {
1394 Output::section("Hook Installation Summary");
1395
1396 let hooks = vec![
1397 HookType::PostCommit,
1398 HookType::PrePush,
1399 HookType::CommitMsg,
1400 HookType::PrepareCommitMsg,
1401 ];
1402
1403 for hook in &hooks {
1404 Output::sub_item(format!("{}: {}", hook.filename(), hook.description()));
1405 }
1406
1407 println!();
1408 Output::section("These hooks will automatically");
1409 Output::bullet("Add commits to your active stack");
1410 Output::bullet("Validate commit messages");
1411 Output::bullet("Prevent force pushes that break stack integrity");
1412 Output::bullet("Add stack context to commit messages");
1413
1414 println!();
1415 Output::section("With hooks + new defaults, your workflow becomes");
1416 Output::sub_item("git commit → Auto-added to stack");
1417 Output::sub_item("ca push → Pushes all by default");
1418 Output::sub_item("ca submit → Submits all by default");
1419 Output::sub_item("ca autoland → Auto-merges when ready");
1420
1421 let should_install = Confirm::with_theme(&ColorfulTheme::default())
1423 .with_prompt("Install Cascade hooks?")
1424 .default(true)
1425 .interact()
1426 .map_err(|e| CascadeError::config(format!("Failed to get user confirmation: {e}")))?;
1427
1428 if should_install {
1429 Output::success("Proceeding with installation");
1430 Ok(())
1431 } else {
1432 Err(CascadeError::config(
1433 "Installation cancelled by user".to_string(),
1434 ))
1435 }
1436 }
1437}
1438
1439pub async fn install() -> Result<()> {
1441 install_with_options(false, false, false, false).await
1442}
1443
1444pub async fn install_essential() -> Result<()> {
1445 let current_dir = env::current_dir()
1446 .map_err(|e| CascadeError::config(format!("Could not get current directory: {e}")))?;
1447
1448 let repo_root = find_repository_root(¤t_dir)
1449 .map_err(|e| CascadeError::config(format!("Could not find git repository: {e}")))?;
1450
1451 let hooks_manager = HooksManager::new(&repo_root)?;
1452 hooks_manager.install_essential()
1453}
1454
1455pub async fn install_with_options(
1456 skip_checks: bool,
1457 allow_main_branch: bool,
1458 yes: bool,
1459 force: bool,
1460) -> Result<()> {
1461 let current_dir = env::current_dir()
1462 .map_err(|e| CascadeError::config(format!("Could not get current directory: {e}")))?;
1463
1464 let repo_root = find_repository_root(¤t_dir)
1465 .map_err(|e| CascadeError::config(format!("Could not find git repository: {e}")))?;
1466
1467 let hooks_manager = HooksManager::new(&repo_root)?;
1468
1469 let options = InstallOptions {
1470 check_prerequisites: !skip_checks,
1471 feature_branches_only: !allow_main_branch,
1472 confirm: !yes,
1473 force,
1474 };
1475
1476 hooks_manager.install_with_options(&options)
1477}
1478
1479pub async fn uninstall() -> Result<()> {
1480 let current_dir = env::current_dir()
1481 .map_err(|e| CascadeError::config(format!("Could not get current directory: {e}")))?;
1482
1483 let repo_root = find_repository_root(¤t_dir)
1484 .map_err(|e| CascadeError::config(format!("Could not find git repository: {e}")))?;
1485
1486 let hooks_manager = HooksManager::new(&repo_root)?;
1487 hooks_manager.uninstall_all()
1488}
1489
1490pub async fn status() -> Result<()> {
1491 let current_dir = env::current_dir()
1492 .map_err(|e| CascadeError::config(format!("Could not get current directory: {e}")))?;
1493
1494 let repo_root = find_repository_root(¤t_dir)
1495 .map_err(|e| CascadeError::config(format!("Could not find git repository: {e}")))?;
1496
1497 let hooks_manager = HooksManager::new(&repo_root)?;
1498 hooks_manager.list_installed_hooks()
1499}
1500
1501pub async fn install_hook(hook_name: &str) -> Result<()> {
1502 install_hook_with_options(hook_name, false, false).await
1503}
1504
1505pub async fn install_hook_with_options(
1506 hook_name: &str,
1507 skip_checks: bool,
1508 force: bool,
1509) -> Result<()> {
1510 let current_dir = env::current_dir()
1511 .map_err(|e| CascadeError::config(format!("Could not get current directory: {e}")))?;
1512
1513 let repo_root = find_repository_root(¤t_dir)
1514 .map_err(|e| CascadeError::config(format!("Could not find git repository: {e}")))?;
1515
1516 let hooks_manager = HooksManager::new(&repo_root)?;
1517
1518 let hook_type = match hook_name {
1519 "post-commit" => HookType::PostCommit,
1520 "pre-push" => HookType::PrePush,
1521 "commit-msg" => HookType::CommitMsg,
1522 "pre-commit" => HookType::PreCommit,
1523 "prepare-commit-msg" => HookType::PrepareCommitMsg,
1524 _ => {
1525 return Err(CascadeError::config(format!(
1526 "Unknown hook type: {hook_name}"
1527 )))
1528 }
1529 };
1530
1531 if !skip_checks && !force {
1533 hooks_manager.validate_prerequisites()?;
1534 }
1535
1536 hooks_manager.install_hook(&hook_type)
1537}
1538
1539pub async fn uninstall_hook(hook_name: &str) -> Result<()> {
1540 let current_dir = env::current_dir()
1541 .map_err(|e| CascadeError::config(format!("Could not get current directory: {e}")))?;
1542
1543 let repo_root = find_repository_root(¤t_dir)
1544 .map_err(|e| CascadeError::config(format!("Could not find git repository: {e}")))?;
1545
1546 let hooks_manager = HooksManager::new(&repo_root)?;
1547
1548 let hook_type = match hook_name {
1549 "post-commit" => HookType::PostCommit,
1550 "pre-push" => HookType::PrePush,
1551 "commit-msg" => HookType::CommitMsg,
1552 "pre-commit" => HookType::PreCommit,
1553 "prepare-commit-msg" => HookType::PrepareCommitMsg,
1554 _ => {
1555 return Err(CascadeError::config(format!(
1556 "Unknown hook type: {hook_name}"
1557 )))
1558 }
1559 };
1560
1561 hooks_manager.uninstall_hook(&hook_type)
1562}
1563
1564#[cfg(test)]
1565mod tests {
1566 use super::*;
1567 use std::process::Command;
1568 use tempfile::TempDir;
1569
1570 fn create_test_repo() -> (TempDir, std::path::PathBuf) {
1571 let temp_dir = TempDir::new().unwrap();
1572 let repo_path = temp_dir.path().to_path_buf();
1573
1574 Command::new("git")
1576 .args(["init"])
1577 .current_dir(&repo_path)
1578 .output()
1579 .unwrap();
1580 Command::new("git")
1581 .args(["config", "user.name", "Test"])
1582 .current_dir(&repo_path)
1583 .output()
1584 .unwrap();
1585 Command::new("git")
1586 .args(["config", "user.email", "test@test.com"])
1587 .current_dir(&repo_path)
1588 .output()
1589 .unwrap();
1590
1591 std::fs::write(repo_path.join("README.md"), "# Test").unwrap();
1593 Command::new("git")
1594 .args(["add", "."])
1595 .current_dir(&repo_path)
1596 .output()
1597 .unwrap();
1598 Command::new("git")
1599 .args(["commit", "-m", "Initial"])
1600 .current_dir(&repo_path)
1601 .output()
1602 .unwrap();
1603
1604 crate::config::initialize_repo(&repo_path, Some("https://test.bitbucket.com".to_string()))
1606 .unwrap();
1607
1608 (temp_dir, repo_path)
1609 }
1610
1611 #[test]
1612 fn test_hooks_manager_creation() {
1613 let (_temp_dir, repo_path) = create_test_repo();
1614 let _manager = HooksManager::new(&repo_path).unwrap();
1615
1616 assert_eq!(_manager.repo_path, repo_path);
1617 assert!(!_manager.repo_id.is_empty());
1619 }
1620
1621 #[test]
1622 fn test_hooks_manager_custom_hooks_path() {
1623 let (_temp_dir, repo_path) = create_test_repo();
1624
1625 Command::new("git")
1627 .args(["config", "core.hooksPath", "custom-hooks"])
1628 .current_dir(&repo_path)
1629 .output()
1630 .unwrap();
1631
1632 let custom_hooks_dir = repo_path.join("custom-hooks");
1634 std::fs::create_dir_all(&custom_hooks_dir).unwrap();
1635
1636 let _manager = HooksManager::new(&repo_path).unwrap();
1637
1638 assert_eq!(_manager.repo_path, repo_path);
1639 assert!(!_manager.repo_id.is_empty());
1641 }
1642
1643 #[test]
1644 fn test_hook_chaining_with_existing_hooks() {
1645 let (_temp_dir, repo_path) = create_test_repo();
1646 let manager = HooksManager::new(&repo_path).unwrap();
1647
1648 let hook_type = HookType::PreCommit;
1649 let hook_path = repo_path.join(".git/hooks").join(hook_type.filename());
1650
1651 let existing_hook_content = "#!/bin/bash\n# Project pre-commit hook\n./scripts/lint.sh\n";
1653 std::fs::write(&hook_path, existing_hook_content).unwrap();
1654 crate::utils::platform::make_executable(&hook_path).unwrap();
1655
1656 let result = manager.install_hook(&hook_type);
1658 assert!(result.is_ok());
1659
1660 let original_content = std::fs::read_to_string(&hook_path).unwrap();
1662 assert!(original_content.contains("# Project pre-commit hook"));
1663 assert!(original_content.contains("./scripts/lint.sh"));
1664
1665 let cascade_hooks_dir = manager.get_cascade_hooks_dir().unwrap();
1667 let cascade_hook_path = cascade_hooks_dir.join(hook_type.filename());
1668 assert!(cascade_hook_path.exists());
1669
1670 let uninstall_result = manager.uninstall_hook(&hook_type);
1672 assert!(uninstall_result.is_ok());
1673
1674 let after_uninstall = std::fs::read_to_string(&hook_path).unwrap();
1676 assert!(after_uninstall.contains("# Project pre-commit hook"));
1677 assert!(after_uninstall.contains("./scripts/lint.sh"));
1678
1679 assert!(!cascade_hook_path.exists());
1681 }
1682
1683 #[test]
1684 fn test_hook_installation() {
1685 let (_temp_dir, repo_path) = create_test_repo();
1686 let manager = HooksManager::new(&repo_path).unwrap();
1687
1688 let hook_type = HookType::PostCommit;
1690 let result = manager.install_hook(&hook_type);
1691 assert!(result.is_ok());
1692
1693 let hook_filename = hook_type.filename();
1695 let cascade_hooks_dir = manager.get_cascade_hooks_dir().unwrap();
1696 let hook_path = cascade_hooks_dir.join(&hook_filename);
1697 assert!(hook_path.exists());
1698
1699 #[cfg(unix)]
1701 {
1702 use std::os::unix::fs::PermissionsExt;
1703 let metadata = std::fs::metadata(&hook_path).unwrap();
1704 let permissions = metadata.permissions();
1705 assert!(permissions.mode() & 0o111 != 0); }
1707
1708 #[cfg(windows)]
1709 {
1710 assert!(hook_filename.ends_with(".bat"));
1712 assert!(hook_path.exists());
1713 }
1714 }
1715
1716 #[test]
1717 fn test_hook_detection() {
1718 let (_temp_dir, repo_path) = create_test_repo();
1719 let _manager = HooksManager::new(&repo_path).unwrap();
1720
1721 let post_commit_path = repo_path
1723 .join(".git/hooks")
1724 .join(HookType::PostCommit.filename());
1725 let pre_push_path = repo_path
1726 .join(".git/hooks")
1727 .join(HookType::PrePush.filename());
1728 let commit_msg_path = repo_path
1729 .join(".git/hooks")
1730 .join(HookType::CommitMsg.filename());
1731
1732 assert!(!post_commit_path.exists());
1734 assert!(!pre_push_path.exists());
1735 assert!(!commit_msg_path.exists());
1736 }
1737
1738 #[test]
1739 fn test_hook_validation() {
1740 let (_temp_dir, repo_path) = create_test_repo();
1741 let manager = HooksManager::new(&repo_path).unwrap();
1742
1743 let validation = manager.validate_prerequisites();
1745 let _ = validation; let branch_validation = manager.validate_branch_suitability();
1751 let _ = branch_validation; }
1754
1755 #[test]
1756 fn test_hook_uninstallation() {
1757 let (_temp_dir, repo_path) = create_test_repo();
1758 let manager = HooksManager::new(&repo_path).unwrap();
1759
1760 let hook_type = HookType::PostCommit;
1762 manager.install_hook(&hook_type).unwrap();
1763
1764 let cascade_hooks_dir = manager.get_cascade_hooks_dir().unwrap();
1765 let hook_path = cascade_hooks_dir.join(hook_type.filename());
1766 assert!(hook_path.exists());
1767
1768 let result = manager.uninstall_hook(&hook_type);
1769 assert!(result.is_ok());
1770 assert!(!hook_path.exists());
1771 }
1772
1773 #[test]
1774 fn test_hook_content_generation() {
1775 let (_temp_dir, repo_path) = create_test_repo();
1776 let manager = HooksManager::new(&repo_path).unwrap();
1777
1778 let binary_name = "cascade-cli";
1780
1781 let post_commit_content = manager.generate_post_commit_hook(binary_name);
1783 #[cfg(windows)]
1784 {
1785 assert!(post_commit_content.contains("@echo off"));
1786 assert!(post_commit_content.contains("rem Cascade CLI Hook"));
1787 }
1788 #[cfg(not(windows))]
1789 {
1790 assert!(post_commit_content.contains("#!/bin/sh"));
1791 assert!(post_commit_content.contains("# Cascade CLI Hook"));
1792 }
1793 assert!(post_commit_content.contains(binary_name));
1794
1795 let pre_push_content = manager.generate_pre_push_hook(binary_name);
1797 #[cfg(windows)]
1798 {
1799 assert!(pre_push_content.contains("@echo off"));
1800 assert!(pre_push_content.contains("rem Cascade CLI Hook"));
1801 }
1802 #[cfg(not(windows))]
1803 {
1804 assert!(pre_push_content.contains("#!/bin/sh"));
1805 assert!(pre_push_content.contains("# Cascade CLI Hook"));
1806 }
1807 assert!(pre_push_content.contains(binary_name));
1808
1809 let commit_msg_content = manager.generate_commit_msg_hook(binary_name);
1811 #[cfg(windows)]
1812 {
1813 assert!(commit_msg_content.contains("@echo off"));
1814 assert!(commit_msg_content.contains("rem Cascade CLI Hook"));
1815 }
1816 #[cfg(not(windows))]
1817 {
1818 assert!(commit_msg_content.contains("#!/bin/sh"));
1819 assert!(commit_msg_content.contains("# Cascade CLI Hook"));
1820 }
1821
1822 let prepare_commit_content = manager.generate_prepare_commit_msg_hook(binary_name);
1824 #[cfg(windows)]
1825 {
1826 assert!(prepare_commit_content.contains("@echo off"));
1827 assert!(prepare_commit_content.contains("rem Cascade CLI Hook"));
1828 }
1829 #[cfg(not(windows))]
1830 {
1831 assert!(prepare_commit_content.contains("#!/bin/sh"));
1832 assert!(prepare_commit_content.contains("# Cascade CLI Hook"));
1833 }
1834 assert!(prepare_commit_content.contains(binary_name));
1835 }
1836
1837 #[test]
1838 fn test_hook_status_reporting() {
1839 let (_temp_dir, repo_path) = create_test_repo();
1840 let manager = HooksManager::new(&repo_path).unwrap();
1841
1842 let repo_type = manager.detect_repository_type().unwrap();
1844 assert!(matches!(
1846 repo_type,
1847 RepositoryType::Bitbucket | RepositoryType::Unknown
1848 ));
1849
1850 let branch_type = manager.detect_branch_type().unwrap();
1852 assert!(matches!(
1854 branch_type,
1855 BranchType::Main | BranchType::Unknown
1856 ));
1857 }
1858
1859 #[test]
1860 fn test_force_installation() {
1861 let (_temp_dir, repo_path) = create_test_repo();
1862 let manager = HooksManager::new(&repo_path).unwrap();
1863
1864 let hook_filename = HookType::PostCommit.filename();
1866 let hook_path = repo_path.join(".git/hooks").join(&hook_filename);
1867
1868 #[cfg(windows)]
1869 let existing_content = "@echo off\necho existing hook";
1870 #[cfg(not(windows))]
1871 let existing_content = "#!/bin/sh\necho 'existing hook'";
1872
1873 std::fs::write(&hook_path, existing_content).unwrap();
1874
1875 let hook_type = HookType::PostCommit;
1877 let result = manager.install_hook(&hook_type);
1878 assert!(result.is_ok());
1879
1880 let cascade_hooks_dir = manager.get_cascade_hooks_dir().unwrap();
1882 let cascade_hook_path = cascade_hooks_dir.join(&hook_filename);
1883 assert!(cascade_hook_path.exists());
1884
1885 let original_content = std::fs::read_to_string(&hook_path).unwrap();
1887 assert!(original_content.contains("existing hook"));
1888
1889 let cascade_content = std::fs::read_to_string(&cascade_hook_path).unwrap();
1891 assert!(cascade_content.contains("cascade-cli") || cascade_content.contains("ca"));
1892 }
1893}