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