gitpush-tool 0.4.0__tar.gz → 0.4.1__tar.gz

{gitpush_tool-0.4.0 → gitpush_tool-0.4.1}/LONG_DESCRIPTION.md

@@ -9,6 +9,7 @@ A supercharged Git CLI and safety tool that simplifies repository creation and p
 
 ## ✨ Features
 
+- **Decision-Support Status Dashboard (`gitpush status`):** Actionable repository overview showing worktree breakdown, commit sync, intelligent next-step recommendations, and a 0-100 Repo Health score.
 - **Pre-Push Safety & Diffstat Preview:** See changed files, line additions/deletions (`+X, -Y`), ahead/behind status, and pending commits before pushing.
 - **Dangerous Git Operation Guard:** Analyzes and protects against risky actions (`reset --hard`, force pushes, deleting unmerged branches, dirty `git clean`, detached HEADs).
 - **Protected Branch Safeguard:** Automatically detects and alerts when pushing or force-pushing to `main`, `master`, `prod`, `release`, or `dev`.
@@ -19,6 +20,40 @@ A supercharged Git CLI and safety tool that simplifies repository creation and p
 
 ---
 
+## 📊 Decision-Support Status Dashboard (`gitpush status`)
+
+```text
+Repository:  my-project
+Branch:      feature/payment
+Tracking:    origin/feature/payment
+
+WORKTREE
+────────────────────────
+Modified       4
+Added          2
+Deleted        1
+Untracked      3
+Line Changes   +142, -18
+
+COMMITS
+────────────────────────
+Ahead          3
+Behind         1
+
+PUSH / STATUS
+────────────────────────
+⚠ Remote has 1 commit(s) you don't have locally.
+
+Recommended:
+    git pull --rebase
+    gitpush "Commit message"
+
+Health:
+    82/100 [████████░░] Good (Minor Action Needed)
+```
+
+---
+
 ## 🛡️ Pre-Push Warning & Inspection
 
 Whenever you run `gitpush`, you get an instant, clear breakdown of your repository state:

{gitpush_tool-0.4.0/gitpush_tool.egg-info → gitpush_tool-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitpush-tool
-Version: 0.4.0
+Version: 0.4.1
 Summary: Supercharged Git push tool with automatic GitHub repo creation and pushing
 Home-page: https://github.com/inevitablegs/gitpush
 Author: Ganesh Sonawane
@@ -38,6 +38,7 @@ A supercharged Git CLI and safety tool that simplifies repository creation and p
 
 ## ✨ Features
 
+- **Decision-Support Status Dashboard (`gitpush status`):** Actionable repository overview showing worktree breakdown, commit sync, intelligent next-step recommendations, and a 0-100 Repo Health score.
 - **Pre-Push Safety & Diffstat Preview:** See changed files, line additions/deletions (`+X, -Y`), ahead/behind status, and pending commits before pushing.
 - **Dangerous Git Operation Guard:** Analyzes and protects against risky actions (`reset --hard`, force pushes, deleting unmerged branches, dirty `git clean`, detached HEADs).
 - **Protected Branch Safeguard:** Automatically detects and alerts when pushing or force-pushing to `main`, `master`, `prod`, `release`, or `dev`.
@@ -48,6 +49,40 @@ A supercharged Git CLI and safety tool that simplifies repository creation and p
 
 ---
 
+## 📊 Decision-Support Status Dashboard (`gitpush status`)
+
+```text
+Repository:  my-project
+Branch:      feature/payment
+Tracking:    origin/feature/payment
+
+WORKTREE
+────────────────────────
+Modified       4
+Added          2
+Deleted        1
+Untracked      3
+Line Changes   +142, -18
+
+COMMITS
+────────────────────────
+Ahead          3
+Behind         1
+
+PUSH / STATUS
+────────────────────────
+⚠ Remote has 1 commit(s) you don't have locally.
+
+Recommended:
+    git pull --rebase
+    gitpush "Commit message"
+
+Health:
+    82/100 [████████░░] Good (Minor Action Needed)
+```
+
+---
+
 ## 🛡️ Pre-Push Warning & Inspection
 
 Whenever you run `gitpush`, you get an instant, clear breakdown of your repository state:

{gitpush_tool-0.4.0 → gitpush_tool-0.4.1}/README.md

@@ -9,6 +9,7 @@ A supercharged Git CLI and safety tool that simplifies repository creation and p
 
 ## ✨ Features
 
+- **Decision-Support Status Dashboard (`gitpush status`):** Actionable repository overview showing worktree breakdown, commit sync, intelligent next-step recommendations, and a 0-100 Repo Health score.
 - **Pre-Push Safety & Diffstat Preview:** See changed files, line additions/deletions (`+X, -Y`), ahead/behind status, and pending commits before pushing.
 - **Dangerous Git Operation Guard:** Analyzes and protects against risky actions (`reset --hard`, force pushes, deleting unmerged branches, dirty `git clean`, detached HEADs).
 - **Protected Branch Safeguard:** Automatically detects and alerts when pushing or force-pushing to `main`, `master`, `prod`, `release`, or `dev`.
@@ -27,6 +28,42 @@ pip install gitpush-tool
 
 ---
 
+## 📊 Decision-Support Status Dashboard (`gitpush status`)
+
+Instead of raw, cryptic Git output, `gitpush status` gives you structured decision support:
+
+```text
+Repository:  my-project
+Branch:      feature/payment
+Tracking:    origin/feature/payment
+
+WORKTREE
+────────────────────────
+Modified       4
+Added          2
+Deleted        1
+Untracked      3
+Line Changes   +142, -18
+
+COMMITS
+────────────────────────
+Ahead          3
+Behind         1
+
+PUSH / STATUS
+────────────────────────
+⚠ Remote has 1 commit(s) you don't have locally.
+
+Recommended:
+    git pull --rebase
+    gitpush "Commit message"
+
+Health:
+    82/100 [████████░░] Good (Minor Action Needed)
+```
+
+---
+
 ## 🛡️ Pre-Push Warning & Inspection
 
 Whenever you run `gitpush`, you get an instant, clear breakdown of your repository state:

{gitpush_tool-0.4.0 → gitpush_tool-0.4.1}/gitpush/__doc__.py

@@ -1,5 +1,5 @@
 """
-GitPush Tool - Supercharged Git CLI (v0.4.0)
+GitPush Tool - Supercharged Git CLI (v0.4.1)
 
 A powerful command-line tool that simplifies Git operations with automatic GitHub
 repository creation, pre-push diffstat inspection, and dangerous operation safeguards.
@@ -14,6 +14,7 @@ Key Features:
 • GitHub CLI integration
 
 Basic Usage:
+  gitpush status                        # Decision-support repository status
   gitpush "Commit message"              # Standard push with preview
   gitpush "Commit message" -y           # Push without confirmation prompt
   gitpush --dry-run                     # Preview changes without pushing

gitpush_tool-0.4.1/gitpush/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.4.1"

{gitpush_tool-0.4.0 → gitpush_tool-0.4.1}/gitpush/cli.py

@@ -45,6 +45,8 @@ from .safety import (
     Style
 )
 
+from .status import format_status_dashboard
+
 
 # --- GitHub CLI Installation Orchestrator and Helpers ---
 
@@ -684,6 +686,12 @@ def handle_guard_command(raw_args: List[str], auto_confirm: bool = False) -> int
 # --- Main Entry Point ---
 
 def run():
+    # Handle status subcommand upfront if detected
+    if len(sys.argv) > 1 and sys.argv[1].lower() == "status":
+        verbose = "-v" in sys.argv or "--verbose" in sys.argv
+        print(format_status_dashboard(verbose=verbose))
+        sys.exit(0)
+
     # Handle guard subcommand upfront if detected
     if len(sys.argv) > 1 and sys.argv[1].lower() in ("guard", "check", "verify-danger"):
         guard_args = sys.argv[2:]
@@ -692,9 +700,10 @@ def run():
         sys.exit(handle_guard_command(clean_args, auto_confirm=auto_confirm))
 
     parser = argparse.ArgumentParser(
-        description="🚀 Supercharged Git push tool with GitHub repo creation, diff previews, and safety guards",
+        description="🚀 Supercharged Git push tool with decision-support status dashboard and safety guards",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""Examples:
+  Decision status:       gitpush status
   Standard push:         gitpush "My new feature"
   Push without prompt:   gitpush "My new feature" -y
   Dry run preview:       gitpush "My new feature" --dry-run

gitpush_tool-0.4.1/gitpush/status.py

@@ -0,0 +1,369 @@
+"""
+GitPush Decision-Support Status Dashboard
+Provides a rich, actionable overview of repository health, worktree breakdown,
+commit sync state, and intelligent contextual recommendations.
+"""
+
+import os
+import sys
+import subprocess
+from typing import Optional, Dict, List, Tuple, Any
+
+from .safety import (
+    is_git_repo,
+    get_repo_name,
+    get_repo_root,
+    get_current_branch,
+    is_detached_head,
+    is_protected_branch,
+    get_ahead_behind,
+    get_diffstat_summary,
+    run_git,
+    colorize,
+    Style
+)
+
+
+def get_tracking_branch(cwd: Optional[str] = None) -> Optional[str]:
+    """Get the upstream tracking branch for the current HEAD, e.g. origin/main."""
+    res = run_git(["rev-parse", "--abbrev-ref", "--symbolic-full-name", "@{u}"], cwd=cwd)
+    if res.returncode == 0 and res.stdout.strip():
+        return res.stdout.strip()
+    return None
+
+
+def get_stash_count(cwd: Optional[str] = None) -> int:
+    """Get count of stashes in the stash list."""
+    res = run_git(["stash", "list"], cwd=cwd)
+    if res.returncode == 0 and res.stdout.strip():
+        return len(res.stdout.strip().splitlines())
+    return 0
+
+
+def get_worktree_breakdown(cwd: Optional[str] = None) -> Dict[str, int]:
+    """
+    Categorizes working tree changes into:
+    - modified
+    - added (staged new files)
+    - deleted
+    - untracked
+    - renamed
+    - unmerged (conflicts)
+    """
+    counts = {
+        "modified": 0,
+        "added": 0,
+        "deleted": 0,
+        "untracked": 0,
+        "renamed": 0,
+        "unmerged": 0
+    }
+    
+    res = run_git(["status", "--porcelain=v1", "-uall"], cwd=cwd)
+    if res.returncode != 0 or not res.stdout.strip():
+        return counts
+
+    for line in res.stdout.splitlines():
+        if len(line) < 3:
+            continue
+        index_code = line[0]
+        work_code = line[1]
+        
+        # Check unmerged / conflicts
+        if index_code in ('U', 'A', 'D') and work_code == 'U' or (index_code == 'U' and work_code in ('U', 'A', 'D')) or (index_code == 'A' and work_code == 'A') or (index_code == 'D' and work_code == 'D'):
+            counts["unmerged"] += 1
+            continue
+
+        # Untracked
+        if index_code == '?' and work_code == '?':
+            counts["untracked"] += 1
+            continue
+
+        # Added / New in index
+        if index_code == 'A':
+            counts["added"] += 1
+            if work_code == 'M':
+                counts["modified"] += 1
+            elif work_code == 'D':
+                counts["deleted"] += 1
+            continue
+
+        # Deleted
+        if index_code == 'D' or work_code == 'D':
+            counts["deleted"] += 1
+            continue
+
+        # Renamed
+        if index_code == 'R' or work_code == 'R':
+            counts["renamed"] += 1
+            continue
+
+        # Modified
+        if index_code == 'M' or work_code == 'M':
+            counts["modified"] += 1
+            continue
+
+    return counts
+
+
+def calculate_repo_health(
+    detached: bool,
+    unmerged_count: int,
+    behind_count: int,
+    diverged: bool,
+    modified_count: int,
+    untracked_count: int,
+    stash_count: int,
+    is_protected: bool
+) -> Tuple[int, str, str]:
+    """
+    Computes a repository health score between 0 and 100 with a label and color style.
+    Returns: (score, label, color_style)
+    """
+    score = 100
+
+    # Severe issues
+    if unmerged_count > 0:
+        score -= min(40, unmerged_count * 20)
+    if detached:
+        score -= 25
+    if diverged:
+        score -= 20
+    elif behind_count > 0:
+        score -= min(15, behind_count * 3)
+
+    # Worktree hygiene
+    total_dirty = modified_count + untracked_count
+    if total_dirty > 20:
+        score -= 15
+    elif total_dirty > 10:
+        score -= 10
+    elif total_dirty > 5:
+        score -= 5
+
+    # Stash buildup
+    if stash_count > 10:
+        score -= 10
+    elif stash_count > 5:
+        score -= 5
+
+    # Clamp between 0 and 100
+    score = max(0, min(100, score))
+
+    if score >= 90:
+        label = "Excellent (Clean & Ready)"
+        color = Style.GREEN
+    elif score >= 75:
+        label = "Good (Minor Action Needed)"
+        color = Style.CYAN
+    elif score >= 50:
+        label = "Attention Needed"
+        color = Style.YELLOW
+    else:
+        label = "Critical (Conflicts / Detached)"
+        color = Style.RED
+
+    return score, label, color
+
+
+def get_decision_recommendations(
+    branch: str,
+    tracking: Optional[str],
+    ahead: int,
+    behind: int,
+    diverged: bool,
+    detached: bool,
+    worktree: Dict[str, int],
+    is_protected: bool
+) -> Tuple[List[str], List[str]]:
+    """
+    Generates actionable, contextual push/pull notes and recommended next commands.
+    Returns: (status_notes, recommended_commands)
+    """
+    status_notes = []
+    recommended = []
+
+    total_worktree_changes = sum(worktree.values())
+
+    # 1. Unmerged / Conflicts
+    if worktree.get("unmerged", 0) > 0:
+        status_notes.append(colorize(f"❌ {worktree['unmerged']} merge conflict(s) require resolution.", Style.BOLD, Style.RED))
+        recommended.append("Resolve conflict markers in affected files, then run: git add .")
+        recommended.append("Continue rebase/merge with: git rebase --continue (or git commit)")
+        return status_notes, recommended
+
+    # 2. Detached HEAD
+    if detached:
+        status_notes.append(colorize("⚠ You are in a detached HEAD state. Commits made here are not on a branch.", Style.YELLOW))
+        recommended.append("Create a new branch to keep your work: git switch -c feature/my-new-branch")
+        return status_notes, recommended
+
+    # 3. Remote Tracking & Sync
+    if tracking is None:
+        status_notes.append("Branch has no remote tracking branch set.")
+        if total_worktree_changes > 0:
+            recommended.append(f'gitpush "Commit message" {branch} origin')
+        else:
+            recommended.append(f"git push -u origin {branch}")
+    elif diverged:
+        status_notes.append(colorize(f"⚠ Branch has diverged from '{tracking}' ({ahead} ahead, {behind} behind).", Style.YELLOW))
+        recommended.append("Rebase onto remote changes: git pull --rebase")
+        recommended.append(f'Then push your changes: gitpush')
+    elif behind > 0:
+        status_notes.append(colorize(f"⚠ Remote has {behind} commit(s) you don't have locally.", Style.YELLOW))
+        recommended.append("git pull --rebase")
+        if ahead > 0 or total_worktree_changes > 0:
+            recommended.append(f'gitpush "Commit message"')
+    elif ahead > 0:
+        if total_worktree_changes > 0:
+            status_notes.append(f"Ready to commit {total_worktree_changes} change(s) and push {ahead} commit(s).")
+            recommended.append(f'gitpush "Commit message"')
+        else:
+            status_notes.append(colorize(f"✔ Ready to push {ahead} local commit(s) to '{tracking}'.", Style.GREEN))
+            recommended.append("gitpush")
+    else:
+        # Synced with remote
+        if total_worktree_changes > 0:
+            status_notes.append(f"You have {total_worktree_changes} uncommitted file change(s).")
+            recommended.append(f'gitpush "Describe your changes"')
+        else:
+            status_notes.append(colorize("✔ Repository is clean and in sync with remote.", Style.GREEN))
+            recommended.append("No action needed (all changes committed and pushed).")
+
+    # Protected branch advice
+    if is_protected and (ahead > 0 or total_worktree_changes > 0):
+        status_notes.append(colorize(f"ℹ '{branch}' is a protected branch.", Style.CYAN))
+        if not any("git switch -c" in r for r in recommended):
+            recommended.append(f"Tip: If contributing a feature, branch off: git switch -c feature/new-idea")
+
+    return status_notes, recommended
+
+
+def format_status_dashboard(cwd: Optional[str] = None, verbose: bool = False) -> str:
+    """
+    Format the complete decision-support status dashboard.
+    """
+    if not is_git_repo(cwd):
+        return colorize("❌ Not a Git repository (or any of the parent directories).", Style.RED)
+
+    repo_name = get_repo_name(cwd)
+    branch = get_current_branch(cwd)
+    detached = is_detached_head(cwd)
+    tracking = get_tracking_branch(cwd)
+    is_prot = is_protected_branch(branch)
+    
+    # Remote sync status
+    remote = "origin"
+    remote_branch = branch
+    if tracking and "/" in tracking:
+        remote, remote_branch = tracking.split("/", 1)
+    
+    behind, ahead = get_ahead_behind(remote, remote_branch, cwd)
+    diverged = (ahead > 0 and behind > 0)
+    
+    # Worktree breakdown
+    worktree = get_worktree_breakdown(cwd)
+    stash_count = get_stash_count(cwd)
+    diff_summary = get_diffstat_summary(cwd)
+    
+    # Health score
+    score, health_label, health_color = calculate_repo_health(
+        detached=detached,
+        unmerged_count=worktree.get("unmerged", 0),
+        behind_count=behind,
+        diverged=diverged,
+        modified_count=worktree["modified"],
+        untracked_count=worktree["untracked"],
+        stash_count=stash_count,
+        is_protected=is_prot
+    )
+
+    # Decision recommendations
+    status_notes, recommendations = get_decision_recommendations(
+        branch=branch,
+        tracking=tracking,
+        ahead=ahead,
+        behind=behind,
+        diverged=diverged,
+        detached=detached,
+        worktree=worktree,
+        is_protected=is_prot
+    )
+
+    lines = []
+    lines.append("")
+    lines.append(f"{colorize('Repository:', Style.BOLD)}  {colorize(repo_name, Style.GREEN)}")
+    
+    branch_styled = branch
+    if detached:
+        branch_styled = colorize(f"{branch} [DETACHED HEAD ⚠️]", Style.BOLD, Style.RED)
+    elif is_prot:
+        branch_styled = colorize(f"{branch} [Protected]", Style.BOLD, Style.YELLOW)
+    else:
+        branch_styled = colorize(branch, Style.CYAN)
+    
+    lines.append(f"{colorize('Branch:', Style.BOLD)}      {branch_styled}")
+    tracking_str = tracking if tracking else colorize("None (no tracking remote)", Style.DIM)
+    lines.append(f"{colorize('Tracking:', Style.BOLD)}    {tracking_str}")
+    lines.append("")
+
+    # WORKTREE section
+    lines.append(colorize("WORKTREE", Style.BOLD))
+    lines.append(colorize("────────────────────────", Style.DIM))
+    total_worktree = sum(worktree.values())
+    if total_worktree == 0:
+        lines.append(colorize("Clean (no changes)", Style.DIM))
+    else:
+        if worktree["modified"] > 0:
+            lines.append(f"Modified       {colorize(str(worktree['modified']), Style.CYAN)}")
+        if worktree["added"] > 0:
+            lines.append(f"Added          {colorize(str(worktree['added']), Style.GREEN)}")
+        if worktree["deleted"] > 0:
+            lines.append(f"Deleted        {colorize(str(worktree['deleted']), Style.RED)}")
+        if worktree["renamed"] > 0:
+            lines.append(f"Renamed        {colorize(str(worktree['renamed']), Style.CYAN)}")
+        if worktree["untracked"] > 0:
+            lines.append(f"Untracked      {colorize(str(worktree['untracked']), Style.YELLOW)}")
+        if worktree["unmerged"] > 0:
+            lines.append(f"Conflicts      {colorize(str(worktree['unmerged']), Style.BOLD, Style.RED)}")
+        
+        # Line stat addition/deletion
+        if diff_summary["total_additions"] > 0 or diff_summary["total_deletions"] > 0:
+            adds = colorize(f"+{diff_summary['total_additions']}", Style.GREEN)
+            dels = colorize(f"-{diff_summary['total_deletions']}", Style.RED)
+            lines.append(f"Line Changes   {adds}, {dels}")
+
+    if stash_count > 0:
+        lines.append(f"Stashes        {stash_count} saved")
+    lines.append("")
+
+    # COMMITS section
+    lines.append(colorize("COMMITS", Style.BOLD))
+    lines.append(colorize("────────────────────────", Style.DIM))
+    ahead_str = colorize(str(ahead), Style.GREEN) if ahead > 0 else "0"
+    behind_str = colorize(str(behind), Style.RED) if behind > 0 else "0"
+    lines.append(f"Ahead          {ahead_str}")
+    lines.append(f"Behind         {behind_str}")
+    lines.append("")
+
+    # PUSH / PULL section (Decision Support)
+    lines.append(colorize("PUSH / STATUS", Style.BOLD))
+    lines.append(colorize("────────────────────────", Style.DIM))
+    for note in status_notes:
+        lines.append(note)
+    lines.append("")
+
+    # Recommended Action
+    lines.append(colorize("Recommended:", Style.BOLD))
+    for rec in recommendations:
+        lines.append(f"    {colorize(rec, Style.CYAN)}")
+    lines.append("")
+
+    # Repository Health Score
+    health_bar_filled = int(score / 10)
+    health_bar = f"[{'█' * health_bar_filled}{'░' * (10 - health_bar_filled)}]"
+    lines.append(colorize("Health:", Style.BOLD))
+    lines.append(f"    {colorize(f'{score}/100', Style.BOLD, health_color)} {colorize(health_bar, health_color)} {colorize(health_label, Style.DIM)}")
+    lines.append("")
+
+    return "\n".join(lines)

{gitpush_tool-0.4.0 → gitpush_tool-0.4.1/gitpush_tool.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitpush-tool
-Version: 0.4.0
+Version: 0.4.1
 Summary: Supercharged Git push tool with automatic GitHub repo creation and pushing
 Home-page: https://github.com/inevitablegs/gitpush
 Author: Ganesh Sonawane
@@ -38,6 +38,7 @@ A supercharged Git CLI and safety tool that simplifies repository creation and p
 
 ## ✨ Features
 
+- **Decision-Support Status Dashboard (`gitpush status`):** Actionable repository overview showing worktree breakdown, commit sync, intelligent next-step recommendations, and a 0-100 Repo Health score.
 - **Pre-Push Safety & Diffstat Preview:** See changed files, line additions/deletions (`+X, -Y`), ahead/behind status, and pending commits before pushing.
 - **Dangerous Git Operation Guard:** Analyzes and protects against risky actions (`reset --hard`, force pushes, deleting unmerged branches, dirty `git clean`, detached HEADs).
 - **Protected Branch Safeguard:** Automatically detects and alerts when pushing or force-pushing to `main`, `master`, `prod`, `release`, or `dev`.
@@ -48,6 +49,40 @@ A supercharged Git CLI and safety tool that simplifies repository creation and p
 
 ---
 
+## 📊 Decision-Support Status Dashboard (`gitpush status`)
+
+```text
+Repository:  my-project
+Branch:      feature/payment
+Tracking:    origin/feature/payment
+
+WORKTREE
+────────────────────────
+Modified       4
+Added          2
+Deleted        1
+Untracked      3
+Line Changes   +142, -18
+
+COMMITS
+────────────────────────
+Ahead          3
+Behind         1
+
+PUSH / STATUS
+────────────────────────
+⚠ Remote has 1 commit(s) you don't have locally.
+
+Recommended:
+    git pull --rebase
+    gitpush "Commit message"
+
+Health:
+    82/100 [████████░░] Good (Minor Action Needed)
+```
+
+---
+
 ## 🛡️ Pre-Push Warning & Inspection
 
 Whenever you run `gitpush`, you get an instant, clear breakdown of your repository state:

{gitpush_tool-0.4.0 → gitpush_tool-0.4.1}/gitpush_tool.egg-info/SOURCES.txt

@@ -8,10 +8,12 @@ gitpush/__doc__.py
 gitpush/__init__.py
 gitpush/cli.py
 gitpush/safety.py
+gitpush/status.py
 gitpush_tool.egg-info/PKG-INFO
 gitpush_tool.egg-info/SOURCES.txt
 gitpush_tool.egg-info/dependency_links.txt
 gitpush_tool.egg-info/entry_points.txt
 gitpush_tool.egg-info/top_level.txt
 tests/test_cli.py
-tests/test_safety.py
+tests/test_safety.py
+tests/test_status.py

{gitpush_tool-0.4.0 → gitpush_tool-0.4.1}/gitpush_tool.egg-info/entry_points.txt

@@ -1,3 +1,4 @@
 [console_scripts]
 gitpush = gitpush.cli:run
 gitpush-guard = gitpush.cli:run
+gitpush-status = gitpush.cli:run

{gitpush_tool-0.4.0 → gitpush_tool-0.4.1}/setup.py

@@ -2,21 +2,18 @@ from setuptools import setup, find_packages
 from pathlib import Path
 
 # Read long description
-long_desc_file = Path(__file__).parent / "LONG_DESCRIPTION.md"
-if not long_desc_file.exists():
-    long_desc_file = Path(__file__).parent / "README.md"
-long_description = long_desc_file.read_text(encoding="utf-8") if long_desc_file.exists() else ""
-
+long_description = (Path(__file__).parent / "LONG_DESCRIPTION.md").read_text(encoding="utf-8")
 
 setup(
     name="gitpush-tool",
-    version="0.4.0",
+    version="0.4.1",
     packages=find_packages(),
     install_requires=[],
     entry_points={
         "console_scripts": [
             "gitpush=gitpush.cli:run",
-            "gitpush-guard=gitpush.cli:run"
+            "gitpush-guard=gitpush.cli:run",
+            "gitpush-status=gitpush.cli:run"
         ],
     },
     author="Ganesh Sonawane",

gitpush_tool-0.4.1/tests/test_status.py

@@ -0,0 +1,113 @@
+import unittest
+import os
+import sys
+import tempfile
+import shutil
+import subprocess
+from pathlib import Path
+
+# Add package root to sys.path
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+from gitpush.status import (
+    get_tracking_branch,
+    get_stash_count,
+    get_worktree_breakdown,
+    calculate_repo_health,
+    get_decision_recommendations,
+    format_status_dashboard
+)
+
+
+class TestStatusDashboard(unittest.TestCase):
+
+    def setUp(self):
+        self.test_dir = tempfile.mkdtemp()
+        subprocess.run(["git", "init"], cwd=self.test_dir, capture_output=True, check=True)
+        subprocess.run(["git", "config", "user.name", "Test User"], cwd=self.test_dir, capture_output=True, check=True)
+        subprocess.run(["git", "config", "user.email", "test@example.com"], cwd=self.test_dir, capture_output=True, check=True)
+        subprocess.run(["git", "branch", "-M", "feature/payment"], cwd=self.test_dir, capture_output=True, check=True)
+        
+        # Initial commit
+        init_file = os.path.join(self.test_dir, "init.txt")
+        with open(init_file, "w") as f:
+            f.write("init\n")
+        subprocess.run(["git", "add", "."], cwd=self.test_dir, capture_output=True, check=True)
+        subprocess.run(["git", "commit", "-m", "initial commit"], cwd=self.test_dir, capture_output=True, check=True)
+
+    def tearDown(self):
+        shutil.rmtree(self.test_dir, ignore_errors=True)
+
+    def test_worktree_breakdown(self):
+        # Create modified, added, untracked, deleted files
+        f1 = os.path.join(self.test_dir, "init.txt")
+        with open(f1, "w") as f:
+            f.write("init modified\n")
+
+        f2 = os.path.join(self.test_dir, "new_staged.txt")
+        with open(f2, "w") as f:
+            f.write("staged\n")
+        subprocess.run(["git", "add", "new_staged.txt"], cwd=self.test_dir, check=True)
+
+        f3 = os.path.join(self.test_dir, "untracked.txt")
+        with open(f3, "w") as f:
+            f.write("untracked\n")
+
+        counts = get_worktree_breakdown(cwd=self.test_dir)
+        self.assertEqual(counts["modified"], 1)
+        self.assertEqual(counts["added"], 1)
+        self.assertEqual(counts["untracked"], 1)
+
+    def test_health_calculation(self):
+        score_clean, label_clean, _ = calculate_repo_health(
+            detached=False,
+            unmerged_count=0,
+            behind_count=0,
+            diverged=False,
+            modified_count=0,
+            untracked_count=0,
+            stash_count=0,
+            is_protected=False
+        )
+        self.assertEqual(score_clean, 100)
+        self.assertIn("Excellent", label_clean)
+
+        score_dirty, label_dirty, _ = calculate_repo_health(
+            detached=True,
+            unmerged_count=1,
+            behind_count=3,
+            diverged=True,
+            modified_count=6,
+            untracked_count=6,
+            stash_count=6,
+            is_protected=True
+        )
+        self.assertTrue(score_dirty < 50)
+
+    def test_decision_recommendations(self):
+        # Test behind remote recommendation
+        notes, recs = get_decision_recommendations(
+            branch="feature/payment",
+            tracking="origin/feature/payment",
+            ahead=0,
+            behind=2,
+            diverged=False,
+            detached=False,
+            worktree={"modified": 0, "added": 0, "deleted": 0, "untracked": 0, "renamed": 0, "unmerged": 0},
+            is_protected=False
+        )
+        self.assertTrue(any("git pull --rebase" in r for r in recs))
+        self.assertTrue(any("Remote has" in n for n in notes))
+
+    def test_format_status_dashboard(self):
+        dashboard = format_status_dashboard(cwd=self.test_dir)
+        self.assertIn("Repository:", dashboard)
+        self.assertIn("feature/payment", dashboard)
+        self.assertIn("WORKTREE", dashboard)
+        self.assertIn("COMMITS", dashboard)
+        self.assertIn("Health:", dashboard)
+        self.assertIn("Recommended:", dashboard)
+
+
+if __name__ == "__main__":
+    unittest.main()

gitpush_tool-0.4.0/gitpush/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.4.0"

gitpush_tool-0.4.0/tests/test_cli.py

@@ -1,25 +0,0 @@
-import unittest
-import sys
-import subprocess
-from pathlib import Path
-
-# Add package root to sys.path
-sys.path.insert(0, str(Path(__file__).parent.parent))
-
-from gitpush.cli import handle_guard_command
-
-
-class TestCLI(unittest.TestCase):
-
-    def test_guard_help_when_no_args(self):
-        code = handle_guard_command([])
-        self.assertEqual(code, 1)
-
-    def test_guard_dry_check(self):
-        # Run git status through guard with -y
-        code = handle_guard_command(["status"], auto_confirm=True)
-        self.assertEqual(code, 0)
-
-
-if __name__ == "__main__":
-    unittest.main()

gitpush_tool-0.4.0/tests/test_safety.py

@@ -1,169 +0,0 @@
-import unittest
-import os
-import sys
-import tempfile
-import shutil
-import subprocess
-from pathlib import Path
-
-# Add package root to sys.path
-sys.path.insert(0, str(Path(__file__).parent.parent))
-
-from gitpush.safety import (
-    is_git_repo,
-    get_repo_name,
-    get_repo_root,
-    get_current_branch,
-    is_detached_head,
-    is_protected_branch,
-    get_ahead_behind,
-    get_diffstat_summary,
-    DangerousOperationAnalyzer,
-    format_danger_box,
-    format_prepush_summary
-)
-
-
-class TestSafetyEngine(unittest.TestCase):
-
-    def setUp(self):
-        # Create a temporary directory and initialize a git repo for testing
-        self.test_dir = tempfile.mkdtemp()
-        subprocess.run(["git", "init"], cwd=self.test_dir, capture_output=True, check=True)
-        subprocess.run(["git", "config", "user.name", "Test User"], cwd=self.test_dir, capture_output=True, check=True)
-        subprocess.run(["git", "config", "user.email", "test@example.com"], cwd=self.test_dir, capture_output=True, check=True)
-        subprocess.run(["git", "branch", "-M", "main"], cwd=self.test_dir, capture_output=True, check=True)
-        # Create initial root commit
-        init_file = os.path.join(self.test_dir, "init.txt")
-        with open(init_file, "w") as f:
-            f.write("init\n")
-        subprocess.run(["git", "add", "."], cwd=self.test_dir, capture_output=True, check=True)
-        subprocess.run(["git", "commit", "-m", "initial commit"], cwd=self.test_dir, capture_output=True, check=True)
-
-    def tearDown(self):
-        shutil.rmtree(self.test_dir, ignore_errors=True)
-
-    def test_is_git_repo(self):
-        self.assertTrue(is_git_repo(cwd=self.test_dir))
-        non_repo = tempfile.mkdtemp()
-        try:
-            self.assertFalse(is_git_repo(cwd=non_repo))
-        finally:
-            shutil.rmtree(non_repo, ignore_errors=True)
-
-    def test_repo_name_and_root(self):
-        root = get_repo_root(cwd=self.test_dir)
-        self.assertIsNotNone(root)
-        self.assertEqual(os.path.abspath(root), os.path.abspath(self.test_dir))
-        name = get_repo_name(cwd=self.test_dir)
-        self.assertEqual(name, os.path.basename(self.test_dir))
-
-    def test_protected_branch_detection(self):
-        self.assertTrue(is_protected_branch("main"))
-        self.assertTrue(is_protected_branch("master"))
-        self.assertTrue(is_protected_branch("prod"))
-        self.assertTrue(is_protected_branch("production"))
-        self.assertTrue(is_protected_branch("release"))
-        self.assertTrue(is_protected_branch("dev"))
-        self.assertFalse(is_protected_branch("feature/login"))
-        self.assertFalse(is_protected_branch("bugfix-123"))
-
-    def test_diffstat_summary(self):
-        # Initially clean
-        diff = get_diffstat_summary(cwd=self.test_dir)
-        self.assertFalse(diff["has_changes"])
-
-        # Create a file
-        f1 = os.path.join(self.test_dir, "hello.txt")
-        with open(f1, "w") as f:
-            f.write("Line 1\nLine 2\nLine 3\n")
-
-        diff = get_diffstat_summary(cwd=self.test_dir)
-        self.assertTrue(diff["has_changes"])
-        self.assertEqual(diff["untracked_count"], 1)
-        self.assertEqual(diff["total_additions"], 3)
-
-        # Commit initial file
-        subprocess.run(["git", "add", "."], cwd=self.test_dir, check=True)
-        subprocess.run(["git", "commit", "-m", "Init"], cwd=self.test_dir, check=True)
-
-        # Modify file
-        with open(f1, "w") as f:
-            f.write("Line 1 modified\nLine 2\nLine 3\nLine 4 added\n")
-
-        diff = get_diffstat_summary(cwd=self.test_dir)
-        self.assertTrue(diff["has_changes"])
-        self.assertEqual(diff["modified_count"], 1)
-        self.assertTrue(diff["total_additions"] > 0)
-
-    def test_reset_hard_analysis(self):
-        # Create 3 commits
-        f = os.path.join(self.test_dir, "file.txt")
-        for i in range(1, 4):
-            with open(f, "a") as fp:
-                fp.write(f"commit {i}\n")
-            subprocess.run(["git", "add", "."], cwd=self.test_dir, check=True)
-            subprocess.run(["git", "commit", "-m", f"commit {i}"], cwd=self.test_dir, check=True)
-
-        # Make uncommitted changes
-        with open(f, "a") as fp:
-            fp.write("uncommitted work\n")
-
-        report = DangerousOperationAnalyzer.analyze_reset_hard("HEAD~2", cwd=self.test_dir)
-        self.assertTrue(report.is_dangerous)
-        self.assertEqual(report.lost_items.get("commits"), 2)
-        self.assertEqual(report.lost_items.get("modified_files"), 1)
-
-        # Format danger box output
-        box = format_danger_box(report, repo_name="test-repo")
-        self.assertIn("git reset --hard HEAD~2", box)
-        self.assertIn("2 commit(s)", box)
-        self.assertIn("1 modified/staged file(s)", box)
-        self.assertIn("test-repo", box)
-
-    def test_force_push_analysis(self):
-        report = DangerousOperationAnalyzer.analyze_force_push("origin", "main", cwd=self.test_dir)
-        self.assertTrue(report.is_dangerous)
-        self.assertIn("PROTECTED BRANCH", report.risks[0])
-
-    def test_clean_analysis(self):
-        # Create untracked file
-        untracked = os.path.join(self.test_dir, "untracked.txt")
-        with open(untracked, "w") as fp:
-            fp.write("untracked\n")
-
-        report = DangerousOperationAnalyzer.analyze_clean(force=True, remove_dirs=True, cwd=self.test_dir)
-        self.assertTrue(report.is_dangerous)
-        self.assertEqual(report.lost_items.get("untracked_files"), 1)
-
-    def test_branch_delete_analysis(self):
-        # Create a branch with an unmerged commit
-        subprocess.run(["git", "checkout", "-b", "feature-x"], cwd=self.test_dir, check=True)
-        f = os.path.join(self.test_dir, "feat.txt")
-        with open(f, "w") as fp:
-            fp.write("feature\n")
-        subprocess.run(["git", "add", "."], cwd=self.test_dir, check=True)
-        subprocess.run(["git", "commit", "-m", "feature commit"], cwd=self.test_dir, check=True)
-        subprocess.run(["git", "checkout", "main"], cwd=self.test_dir, check=True)
-
-        report = DangerousOperationAnalyzer.analyze_branch_delete("feature-x", force=True, cwd=self.test_dir)
-        self.assertTrue(report.is_dangerous)
-        self.assertEqual(report.lost_items.get("unmerged_commits"), 1)
-
-    def test_arbitrary_command_analyzer(self):
-        # Test command parsing
-        rep1 = DangerousOperationAnalyzer.analyze_arbitrary_command(["git", "reset", "--hard", "HEAD~3"], cwd=self.test_dir)
-        self.assertIsNotNone(rep1)
-        self.assertIn("reset --hard", rep1.operation_name)
-
-        rep2 = DangerousOperationAnalyzer.analyze_arbitrary_command(["git", "clean", "-fd"], cwd=self.test_dir)
-        self.assertIsNotNone(rep2)
-        self.assertIn("Clean", rep2.operation_name)
-
-        rep3 = DangerousOperationAnalyzer.analyze_arbitrary_command(["git", "push", "--force", "origin", "main"], cwd=self.test_dir)
-        self.assertIsNotNone(rep3)
-        self.assertIn("Force Push", rep3.operation_name)
-
-
-if __name__ == "__main__":
-    unittest.main()