titan-cli 0.1.3__tar.gz → 0.1.5__tar.gz

{titan_cli-0.1.3 → titan_cli-0.1.5}/PKG-INFO

@@ -1,9 +1,9 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: titan-cli
-Version: 0.1.3
+Version: 0.1.5
 Summary: Modular development tools orchestrator - Streamline your workflows with AI integration and intuitive terminal UI
-Home-page: https://github.com/masmovil/titan-cli
 License: MIT
+License-File: LICENSE
 Keywords: cli,workflow,orchestrator,automation,devtools,ai
 Author: finxo
 Author-email: finxeto@gmail.com
@@ -19,6 +19,8 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Requires-Dist: anthropic (>=0.75.0,<0.76.0)
 Requires-Dist: google-auth (>=2.43.0,<3.0.0)
 Requires-Dist: google-genai (>=1.58.0,<2.0.0)
@@ -34,6 +36,7 @@ Requires-Dist: tomli (>=2.0.0,<3.0.0)
 Requires-Dist: tomli-w (>=1.0.0,<2.0.0)
 Requires-Dist: typer (>=0.20.0,<1.0.0)
 Project-URL: Documentation, https://github.com/masmovil/titan-cli
+Project-URL: Homepage, https://github.com/masmovil/titan-cli
 Project-URL: Repository, https://github.com/masmovil/titan-cli
 Description-Content-Type: text/markdown
 

{titan_cli-0.1.3 → titan_cli-0.1.5}/plugins/titan-plugin-git/titan_plugin_git/clients/git_client.py

@@ -282,13 +282,14 @@ class GitClient:
         """
         self._run_command(["git", "branch", branch_name, start_point])
 
-    def commit(self, message: str, all: bool = False) -> str:
+    def commit(self, message: str, all: bool = False, no_verify: bool = False) -> str:
         """
         Create a commit
 
         Args:
             message: Commit message
             all: Stage all modified and new files (`git add --all`)
+            no_verify: Skip pre-commit and commit-msg hooks
 
         Returns:
             Commit hash
@@ -298,6 +299,8 @@ class GitClient:
             self._run_command(["git", "add", "--all"])
 
         args = ["git", "commit", "-m", message]
+        if no_verify:
+            args.append("--no-verify")
         self._run_command(args)
 
         return self._run_command(["git", "rev-parse", "HEAD"])
@@ -347,7 +350,7 @@ class GitClient:
         self._run_command(["git", "branch", delete_arg, branch])
         return True
 
-    def push(self, remote: str = "origin", branch: Optional[str] = None, set_upstream: bool = False) -> None:
+    def push(self, remote: str = "origin", branch: Optional[str] = None, set_upstream: bool = False, tags: bool = False) -> None:
         """
         Push to remote
 
@@ -355,12 +358,16 @@ class GitClient:
             remote: Remote name
             branch: Branch to push (default: current)
             set_upstream: Set upstream tracking
+            tags: Push tags to remote (use --tags flag)
         """
         args = ["git", "push"]
 
         if set_upstream:
             args.append("-u")
-            
+
+        if tags:
+            args.append("--tags")
+
         args.append(remote)
 
         if branch:
@@ -769,4 +776,75 @@ class GitClient:
         except GitCommandError:
             # Command failed, likely no remote 'origin' or not a git repo
             pass
-        return None, None
+        return None, None
+
+    def create_tag(self, tag_name: str, message: str, ref: str = "HEAD") -> None:
+        """
+        Create an annotated tag
+
+        Args:
+            tag_name: Name of the tag
+            message: Tag annotation message
+            ref: Reference to tag (default: HEAD)
+
+        Raises:
+            GitCommandError: If tag creation fails
+        """
+        self._run_command(["git", "tag", "-a", tag_name, "-m", message, ref])
+
+    def delete_tag(self, tag_name: str) -> None:
+        """
+        Delete a local tag
+
+        Args:
+            tag_name: Name of the tag to delete
+
+        Raises:
+            GitCommandError: If tag deletion fails
+        """
+        self._run_command(["git", "tag", "-d", tag_name])
+
+    def tag_exists(self, tag_name: str) -> bool:
+        """
+        Check if a tag exists locally
+
+        Args:
+            tag_name: Name of the tag to check
+
+        Returns:
+            True if tag exists, False otherwise
+        """
+        try:
+            self._run_command(["git", "tag", "-l", tag_name], check=False)
+            tags = self._run_command(["git", "tag", "-l", tag_name]).strip()
+            return tags == tag_name
+        except GitCommandError:
+            return False
+
+    def list_tags(self) -> List[str]:
+        """
+        List all tags in the repository
+
+        Returns:
+            List of tag names
+        """
+        try:
+            output = self._run_command(["git", "tag", "-l"])
+            if output.strip():
+                return [tag.strip() for tag in output.split('\n') if tag.strip()]
+            return []
+        except GitCommandError:
+            return []
+
+    def is_protected_branch(self, branch: str) -> bool:
+        """
+        Check if a branch is protected (main, master, develop, etc.)
+
+        Args:
+            branch: Branch name to check
+
+        Returns:
+            True if branch is protected
+        """
+        protected_branches = ["main", "master", "develop", "production", "staging"]
+        return branch.lower() in protected_branches

{titan_cli-0.1.3 → titan_cli-0.1.5}/plugins/titan-plugin-git/titan_plugin_git/plugin.py

@@ -100,6 +100,7 @@ class GitPlugin(TitanPlugin):
         """
         from .steps.branch_steps import get_current_branch_step, get_base_branch_step
         from .steps.ai_commit_message_step import ai_generate_commit_message
+        from .steps.diff_summary_step import show_uncommitted_diff_summary, show_branch_diff_summary
 
         return {
             "get_status": get_git_status_step,
@@ -108,6 +109,8 @@ class GitPlugin(TitanPlugin):
             "get_current_branch": get_current_branch_step,
             "get_base_branch": get_base_branch_step,
             "ai_generate_commit_message": ai_generate_commit_message,
+            "show_uncommitted_diff_summary": show_uncommitted_diff_summary,
+            "show_branch_diff_summary": show_branch_diff_summary,
         }
 
     @property

{titan_cli-0.1.3 → titan_cli-0.1.5}/plugins/titan-plugin-git/titan_plugin_git/steps/ai_commit_message_step.py

@@ -1,7 +1,6 @@
 # plugins/titan-plugin-git/titan_plugin_git/steps/ai_commit_message_step.py
 from titan_cli.engine import WorkflowContext, WorkflowResult, Success, Error, Skip
 from titan_plugin_git.messages import msg
-from titan_cli.ui.tui.widgets import Panel
 
 
 def ai_generate_commit_message(ctx: WorkflowContext) -> WorkflowResult:
@@ -29,29 +28,25 @@ def ai_generate_commit_message(ctx: WorkflowContext) -> WorkflowResult:
     if not ctx.textual:
         return Error("Textual UI context is not available for this step.")
 
+    # Begin step container
+    ctx.textual.begin_step("AI Commit Message")
+
     # Check if AI is configured
     if not ctx.ai or not ctx.ai.is_available():
-        ctx.textual.mount(
-            Panel(
-                text=msg.Steps.AICommitMessage.AI_NOT_CONFIGURED,
-                panel_type="info"
-            )
-        )
+        ctx.textual.text(msg.Steps.AICommitMessage.AI_NOT_CONFIGURED, markup="dim")
+        ctx.textual.end_step("skip")
         return Skip(msg.Steps.AICommitMessage.AI_NOT_CONFIGURED)
 
     # Get git client
     if not ctx.git:
+        ctx.textual.end_step("error")
         return Error(msg.Steps.AICommitMessage.GIT_CLIENT_NOT_AVAILABLE)
 
     # Get git status
     git_status = ctx.get('git_status')
     if not git_status or git_status.is_clean:
-        ctx.textual.mount(
-            Panel(
-                text=msg.Steps.AICommitMessage.NO_CHANGES_TO_COMMIT,
-                panel_type="info"
-            )
-        )
+        ctx.textual.text(msg.Steps.AICommitMessage.NO_CHANGES_TO_COMMIT, markup="dim")
+        ctx.textual.end_step("skip")
         return Skip(msg.Steps.AICommitMessage.NO_CHANGES_TO_COMMIT)
 
     try:
@@ -62,6 +57,7 @@ def ai_generate_commit_message(ctx: WorkflowContext) -> WorkflowResult:
         diff_text = ctx.git.get_uncommitted_diff()
 
         if not diff_text or diff_text.strip() == "":
+            ctx.textual.end_step("skip")
             return Skip(msg.Steps.AICommitMessage.NO_UNCOMMITTED_CHANGES)
 
         # Build AI prompt
@@ -86,17 +82,17 @@ def ai_generate_commit_message(ctx: WorkflowContext) -> WorkflowResult:
 
 ## CRITICAL Instructions
 Generate ONE single-line conventional commit message following this EXACT format:
-- type(scope): description
+- type(scope): Description
 - Types: feat, fix, refactor, docs, test, chore, style, perf
 - Scope: area affected (e.g., auth, api, ui)
-- Description: clear summary in imperative mood (be descriptive, concise, and at least 5 words long)
+- Description: clear summary in imperative mood, starting with CAPITAL letter (be descriptive, concise, and at least 5 words long)
 - NO line breaks, NO body, NO additional explanation
 
-Examples (notice they are all one line):
-- feat(auth): add OAuth2 integration with Google provider
-- fix(api): resolve race condition in cache invalidation
-- refactor(ui): simplify menu component and remove unused props
-- refactor(workflows): add support for nested workflow execution
+Examples (notice they start with capital letter and are all one line):
+- feat(auth): Add OAuth2 integration with Google provider
+- fix(api): Resolve race condition in cache invalidation
+- refactor(ui): Simplify menu component and remove unused props
+- refactor(workflows): Add support for nested workflow execution
 
 Return ONLY the single-line commit message, absolutely nothing else."""
 
@@ -115,6 +111,18 @@ Return ONLY the single-line commit message, absolutely nothing else."""
         # Take only the first line if AI returned multiple lines
         commit_message = commit_message.split('\n')[0].strip()
 
+        # Ensure subject starts with capital letter (conventional commits requirement)
+        # Format: type(scope): Description
+        if ':' in commit_message:
+            parts = commit_message.split(':', 1)
+            if len(parts) == 2:
+                prefix = parts[0]  # type(scope)
+                subject = parts[1].strip()  # description
+                # Capitalize first letter of subject
+                if subject and subject[0].islower():
+                    subject = subject[0].upper() + subject[1:]
+                commit_message = f"{prefix}: {subject}"
+
         # Show preview to user
         ctx.textual.text("")  # spacing
         ctx.textual.text(msg.Steps.AICommitMessage.GENERATED_MESSAGE_TITLE, markup="bold")
@@ -136,25 +144,21 @@ Return ONLY the single-line commit message, absolutely nothing else."""
             try:
                 manual_message = ctx.textual.ask_text(msg.Prompts.ENTER_COMMIT_MESSAGE)
                 if not manual_message:
+                    ctx.textual.end_step("error")
                     return Error(msg.Steps.Commit.COMMIT_MESSAGE_REQUIRED)
 
                 # Overwrite the metadata to ensure the manual message is used
+                ctx.textual.end_step("success")
                 return Success(
                     message=msg.Steps.Prompt.COMMIT_MESSAGE_CAPTURED,
                     metadata={"commit_message": manual_message}
                 )
             except (KeyboardInterrupt, EOFError):
+                ctx.textual.end_step("error")
                 return Error(msg.Steps.Prompt.USER_CANCELLED)
 
-        # Show success panel
-        ctx.textual.mount(
-            Panel(
-                text="AI commit message generated successfully",
-                panel_type="success"
-            )
-        )
-
         # Success - save to context
+        ctx.textual.end_step("success")
         return Success(
             msg.Steps.AICommitMessage.SUCCESS_MESSAGE,
             metadata={"commit_message": commit_message}
@@ -164,6 +168,7 @@ Return ONLY the single-line commit message, absolutely nothing else."""
         ctx.textual.text(msg.Steps.AICommitMessage.GENERATION_FAILED.format(e=e), markup="yellow")
         ctx.textual.text(msg.Steps.AICommitMessage.FALLBACK_TO_MANUAL, markup="dim")
 
+        ctx.textual.end_step("skip")
         return Skip(msg.Steps.AICommitMessage.GENERATION_FAILED.format(e=e))
 
 

{titan_cli-0.1.3 → titan_cli-0.1.5}/plugins/titan-plugin-git/titan_plugin_git/steps/branch_steps.py

@@ -1,6 +1,5 @@
 # plugins/titan-plugin-git/titan_plugin_git/steps/branch_steps.py
 from titan_cli.engine import WorkflowContext, WorkflowResult, Success, Error
-from titan_cli.ui.tui.widgets import Panel
 from titan_plugin_git.messages import msg
 
 def get_current_branch_step(ctx: WorkflowContext) -> WorkflowResult:
@@ -20,37 +19,28 @@ def get_current_branch_step(ctx: WorkflowContext) -> WorkflowResult:
     if not ctx.textual:
         return Error("Textual UI context is not available for this step.")
 
+    # Begin step container
+    ctx.textual.begin_step("Get Head Branch")
+
     if not ctx.git:
         error_msg = msg.Steps.Status.GIT_CLIENT_NOT_AVAILABLE
-        ctx.textual.mount(
-            Panel(
-                text=error_msg,
-                panel_type="error"
-            )
-        )
+        ctx.textual.text(error_msg, markup="red")
+        ctx.textual.end_step("error")
         return Error(error_msg)
 
     try:
         current_branch = ctx.git.get_current_branch()
         success_msg = msg.Steps.Branch.GET_CURRENT_BRANCH_SUCCESS.format(branch=current_branch)
-        ctx.textual.mount(
-            Panel(
-                text=success_msg,
-                panel_type="success"
-            )
-        )
+        ctx.textual.text(success_msg, markup="green")
+        ctx.textual.end_step("success")
         return Success(
             success_msg,
             metadata={"pr_head_branch": current_branch}
         )
     except Exception as e:
         error_msg = msg.Steps.Branch.GET_CURRENT_BRANCH_FAILED.format(e=e)
-        ctx.textual.mount(
-            Panel(
-                text=error_msg,
-                panel_type="error"
-            )
-        )
+        ctx.textual.text(error_msg, markup="red")
+        ctx.textual.end_step("error")
         return Error(error_msg, exception=e)
 
 def get_base_branch_step(ctx: WorkflowContext) -> WorkflowResult:
@@ -70,35 +60,26 @@ def get_base_branch_step(ctx: WorkflowContext) -> WorkflowResult:
     if not ctx.textual:
         return Error("Textual UI context is not available for this step.")
 
+    # Begin step container
+    ctx.textual.begin_step("Get Base Branch")
+
     if not ctx.git:
         error_msg = msg.Steps.Status.GIT_CLIENT_NOT_AVAILABLE
-        ctx.textual.mount(
-            Panel(
-                text=error_msg,
-                panel_type="error"
-            )
-        )
+        ctx.textual.text(error_msg, markup="red")
+        ctx.textual.end_step("error")
         return Error(error_msg)
 
     try:
         base_branch = ctx.git.main_branch
         success_msg = msg.Steps.Branch.GET_BASE_BRANCH_SUCCESS.format(branch=base_branch)
-        ctx.textual.mount(
-            Panel(
-                text=success_msg,
-                panel_type="success"
-            )
-        )
+        ctx.textual.text(success_msg, markup="green")
+        ctx.textual.end_step("success")
         return Success(
             success_msg,
             metadata={"pr_base_branch": base_branch}
         )
     except Exception as e:
         error_msg = msg.Steps.Branch.GET_BASE_BRANCH_FAILED.format(e=e)
-        ctx.textual.mount(
-            Panel(
-                text=error_msg,
-                panel_type="error"
-            )
-        )
+        ctx.textual.text(error_msg, markup="red")
+        ctx.textual.end_step("error")
         return Error(error_msg, exception=e)

{titan_cli-0.1.3 → titan_cli-0.1.5}/plugins/titan-plugin-git/titan_plugin_git/steps/commit_step.py

@@ -3,7 +3,6 @@ from titan_cli.engine import WorkflowContext, WorkflowResult, Success, Error
 from titan_cli.engine.results import Skip
 from titan_plugin_git.exceptions import GitClientError, GitCommandError
 from titan_plugin_git.messages import msg
-from titan_cli.ui.tui.widgets import Panel
 
 
 def create_git_commit_step(ctx: WorkflowContext) -> WorkflowResult:
@@ -18,6 +17,7 @@ def create_git_commit_step(ctx: WorkflowContext) -> WorkflowResult:
         git_status (GitStatus): The git status object, used to check if the working directory is clean.
         commit_message (str): The message for the commit.
         all_files (bool, optional): Whether to commit all modified and new files. Defaults to True.
+        no_verify (bool, optional): Skip pre-commit and commit-msg hooks. Defaults to False.
         commit_hash (str, optional): If present, indicates a commit was already created.
 
     Outputs (saved to ctx.data):
@@ -31,50 +31,46 @@ def create_git_commit_step(ctx: WorkflowContext) -> WorkflowResult:
     if not ctx.textual:
         return Error("Textual UI context is not available for this step.")
 
+    # Begin step container
+    ctx.textual.begin_step("Create Commit")
+
     # Skip if there's nothing to commit
     git_status = ctx.data.get("git_status")
     if git_status and git_status.is_clean:
-        ctx.textual.mount(
-            Panel(
-                text=msg.Steps.Commit.WORKING_DIRECTORY_CLEAN,
-                panel_type="info"
-            )
-        )
+        ctx.textual.text(msg.Steps.Commit.WORKING_DIRECTORY_CLEAN, markup="dim")
+        ctx.textual.end_step("skip")
         return Skip(msg.Steps.Commit.WORKING_DIRECTORY_CLEAN)
 
     if not ctx.git:
+        ctx.textual.end_step("error")
         return Error(msg.Steps.Commit.GIT_CLIENT_NOT_AVAILABLE)
 
     commit_message = ctx.get('commit_message')
     if not commit_message:
-        ctx.textual.mount(
-            Panel(
-                text=msg.Steps.Commit.NO_COMMIT_MESSAGE,
-                panel_type="info"
-            )
-        )
+        ctx.textual.text(msg.Steps.Commit.NO_COMMIT_MESSAGE, markup="dim")
+        ctx.textual.end_step("skip")
         return Skip(msg.Steps.Commit.NO_COMMIT_MESSAGE)
-        
+
     all_files = ctx.get('all_files', True)
+    no_verify = ctx.get('no_verify', False)
 
     try:
-        commit_hash = ctx.git.commit(message=commit_message, all=all_files)
+        commit_hash = ctx.git.commit(message=commit_message, all=all_files, no_verify=no_verify)
 
-        # Show success panel
-        ctx.textual.mount(
-            Panel(
-                text=f"Commit created: {commit_hash[:7]}",
-                panel_type="success"
-            )
-        )
+        # Show success message
+        ctx.textual.text(f"Commit created: {commit_hash[:7]}", markup="green")
 
+        ctx.textual.end_step("success")
         return Success(
             message=msg.Steps.Commit.COMMIT_SUCCESS.format(commit_hash=commit_hash),
             metadata={"commit_hash": commit_hash}
         )
     except GitClientError as e:
+        ctx.textual.end_step("error")
         return Error(msg.Steps.Commit.CLIENT_ERROR_DURING_COMMIT.format(e=e))
     except GitCommandError as e:
+        ctx.textual.end_step("error")
         return Error(msg.Steps.Commit.COMMAND_FAILED_DURING_COMMIT.format(e=e))
     except Exception as e:
+        ctx.textual.end_step("error")
         return Error(msg.Steps.Commit.UNEXPECTED_ERROR_DURING_COMMIT.format(e=e))

titan_cli-0.1.5/plugins/titan-plugin-git/titan_plugin_git/steps/diff_summary_step.py

@@ -0,0 +1,182 @@
+# plugins/titan-plugin-git/titan_plugin_git/steps/diff_summary_step.py
+from titan_cli.engine import WorkflowContext, WorkflowResult, Success, Error, Skip
+from titan_plugin_git.messages import msg
+
+
+def show_uncommitted_diff_summary(ctx: WorkflowContext) -> WorkflowResult:
+    """
+    Show summary of uncommitted changes (git diff --stat).
+
+    Provides a visual overview of files changed and lines modified
+    before generating commit messages.
+
+    Returns:
+        Success: Always (even if no changes, for workflow continuity)
+    """
+    if not ctx.textual:
+        return Error("Textual UI context is not available for this step.")
+
+    if not ctx.git:
+        return Error(msg.Steps.Push.GIT_CLIENT_NOT_AVAILABLE)
+
+    # Begin step container
+    ctx.textual.begin_step("Show Changes Summary")
+
+    try:
+        # Get diff stat for uncommitted changes
+        stat_output = ctx.git._run_command(["git", "diff", "--stat", "HEAD"])
+
+        if not stat_output or not stat_output.strip():
+            ctx.textual.text("No uncommitted changes to show", markup="dim")
+            ctx.textual.end_step("success")
+            return Success("No changes")
+
+        # Show the stat summary with colors
+        ctx.textual.text("")  # spacing
+        ctx.textual.text("Changes summary:", markup="bold")
+        ctx.textual.text("")  # spacing
+
+        # Parse lines to find max filename length for alignment
+        file_lines = []
+        summary_lines = []
+        max_filename_len = 0
+
+        for line in stat_output.split('\n'):
+            if not line.strip():
+                continue
+
+            if '|' in line:
+                parts = line.split('|')
+                filename = parts[0].strip()
+                stats = '|'.join(parts[1:]) if len(parts) > 1 else ''
+                file_lines.append((filename, stats))
+                max_filename_len = max(max_filename_len, len(filename))
+            else:
+                summary_lines.append(line)
+
+        # Display aligned file changes
+        for filename, stats in file_lines:
+            # Pad filename to align pipes
+            padded_filename = filename.ljust(max_filename_len)
+
+            # Replace + with green and - with red
+            stats = stats.replace('+', '[green]+[/green]')
+            stats = stats.replace('-', '[red]-[/red]')
+
+            ctx.textual.text(f"  {padded_filename} | {stats}")
+
+        # Display summary lines
+        for line in summary_lines:
+            colored_line = line.replace('(+)', '[green](+)[/green]')
+            colored_line = colored_line.replace('(-)', '[red](-)[/red]')
+            ctx.textual.text(f"  {colored_line}", markup="dim")
+
+        ctx.textual.text("")  # spacing
+
+        # End step container with success
+        ctx.textual.end_step("success")
+
+        return Success("Diff summary displayed")
+
+    except Exception as e:
+        # Don't fail the workflow, just skip
+        ctx.textual.end_step("skip")
+        return Skip(f"Could not show diff summary: {e}")
+
+
+def show_branch_diff_summary(ctx: WorkflowContext) -> WorkflowResult:
+    """
+    Show summary of branch changes (git diff base...head --stat).
+
+    Provides a visual overview of files changed between branches
+    before generating PR descriptions.
+
+    Inputs (from ctx.data):
+        pr_head_branch (str): Head branch name
+
+    Returns:
+        Success: Always (even if no changes, for workflow continuity)
+    """
+    if not ctx.textual:
+        return Error("Textual UI context is not available for this step.")
+
+    # Begin step container
+    ctx.textual.begin_step("Show Branch Changes Summary")
+
+    if not ctx.git:
+        ctx.textual.text(msg.Steps.Push.GIT_CLIENT_NOT_AVAILABLE, markup="red")
+        ctx.textual.end_step("error")
+        return Error(msg.Steps.Push.GIT_CLIENT_NOT_AVAILABLE)
+
+    head_branch = ctx.get("pr_head_branch")
+    if not head_branch:
+        ctx.textual.text("No head branch specified", markup="dim")
+        ctx.textual.end_step("skip")
+        return Skip("No head branch specified")
+
+    base_branch = ctx.git.main_branch
+
+    try:
+        # Get diff stat between branches
+        stat_output = ctx.git._run_command([
+            "git", "diff", "--stat", f"{base_branch}...{head_branch}"
+        ])
+
+        if not stat_output or not stat_output.strip():
+            ctx.textual.text(f"No changes between {base_branch} and {head_branch}", markup="dim")
+            ctx.textual.end_step("success")
+            return Success("No changes")
+
+        # Show the stat summary with colors
+        ctx.textual.text("")  # spacing
+        ctx.textual.text(f"Changes in {head_branch} vs {base_branch}:", markup="bold")
+        ctx.textual.text("")  # spacing
+
+        # Parse lines to find max filename length for alignment
+        file_lines = []
+        summary_lines = []
+        max_filename_len = 0
+
+        for line in stat_output.split('\n'):
+            if not line.strip():
+                continue
+
+            if '|' in line:
+                parts = line.split('|')
+                filename = parts[0].strip()
+                stats = '|'.join(parts[1:]) if len(parts) > 1 else ''
+                file_lines.append((filename, stats))
+                max_filename_len = max(max_filename_len, len(filename))
+            else:
+                summary_lines.append(line)
+
+        # Display aligned file changes
+        for filename, stats in file_lines:
+            # Pad filename to align pipes
+            padded_filename = filename.ljust(max_filename_len)
+
+            # Replace + with green and - with red
+            stats = stats.replace('+', '[green]+[/green]')
+            stats = stats.replace('-', '[red]-[/red]')
+
+            ctx.textual.text(f"  {padded_filename} | {stats}")
+
+        # Display summary lines
+        for line in summary_lines:
+            colored_line = line.replace('(+)', '[green](+)[/green]')
+            colored_line = colored_line.replace('(-)', '[red](-)[/red]')
+            ctx.textual.text(f"  {colored_line}", markup="dim")
+
+        ctx.textual.text("")  # spacing
+
+        ctx.textual.end_step("success")
+        return Success("Branch diff summary displayed")
+
+    except Exception as e:
+        # Don't fail the workflow, just skip
+        ctx.textual.text(f"Could not show branch diff summary: {e}", markup="yellow")
+        ctx.textual.end_step("skip")
+        return Skip(f"Could not show branch diff summary: {e}")
+
+
+__all__ = ["show_uncommitted_diff_summary", "show_branch_diff_summary"]