ghostbuster-cli 0.3.0__tar.gz → 0.4.0__tar.gz

ghostbuster_cli-0.4.0/.github/FUNDING.yml

@@ -0,0 +1,4 @@
+# GitHub Sponsor configuration for ghostbuster-cli
+ko_fi: adewanggar
+custom:
+  - https://saweria.co/adewanggar

{ghostbuster_cli-0.3.0 → ghostbuster_cli-0.4.0}/.github/workflows/publish.yml

@@ -3,9 +3,6 @@ name: Publish to PyPI
 on:
   release:
     types: [published]
-  push:
-    tags:
-      - "v*"
 
 jobs:
   pypi-publish:
@@ -33,3 +30,5 @@ jobs:
 
       - name: Publish package distributions to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true

{ghostbuster_cli-0.3.0 → ghostbuster_cli-0.4.0}/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-08-29
+
+### Added
+
+- **Git Diff / Incremental Fast Scan Mode (`ghostbuster scan --diff` / `-d`)**:
+  - Scan only modified, staged, and untracked files instead of the entire project tree.
+  - Added `--diff-base` flag to compare working branch against a target ref (e.g. `ghostbuster scan --diff-base origin/main`).
+  - Ideal for monorepos and GitHub Actions PR validation.
+  - Zero false positives: global reference verification remains intact for zombie code.
+
 ## [0.3.0] - 2026-08-29
 
 ### Added

{ghostbuster_cli-0.3.0 → ghostbuster_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ghostbuster-cli
-Version: 0.3.0
+Version: 0.4.0
 Summary: Find and bust the ghosts haunting your codebase - unused deps, dead code, orphan files, and phantom env vars.
 Project-URL: Homepage, https://github.com/adewanggar/ghostbuster-cli
 Project-URL: Documentation, https://github.com/adewanggar/ghostbuster-cli#readme
@@ -128,6 +128,18 @@ ghostbuster scan ./my-project
 ghostbuster scan -v
 ```
 
+### Incremental / Git Diff Scan
+
+Scan only files that were modified, staged, or untracked in your working tree:
+
+```bash
+# Scan modified files only (fast mode)
+ghostbuster scan --diff
+
+# Compare working branch against main/master
+ghostbuster scan --diff-base origin/main
+```
+
 ### Filtered Scan
 
 ```bash
@@ -243,6 +255,13 @@ pip install pytest ruff mypy
 pytest tests/ -v
 ```
 
+## Support & Sponsor
+
+If Ghostbuster helped clean up your codebase or saved CI minutes, consider supporting the project:
+
+[![Ko-fi](https://img.shields.io/badge/Ko--fi-Support%20on%20Ko--fi-FF5E5B?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ko-fi.com/adewanggar)
+[![Saweria](https://img.shields.io/badge/Saweria-Dukung%20lewat%20Saweria-FA8072?style=for-the-badge&logo=tether&logoColor=white)](https://saweria.co/adewanggar)
+
 ## License
 
 MIT (c) Ghostbuster Contributors

{ghostbuster_cli-0.3.0 → ghostbuster_cli-0.4.0}/README.md

@@ -90,6 +90,18 @@ ghostbuster scan ./my-project
 ghostbuster scan -v
 ```
 
+### Incremental / Git Diff Scan
+
+Scan only files that were modified, staged, or untracked in your working tree:
+
+```bash
+# Scan modified files only (fast mode)
+ghostbuster scan --diff
+
+# Compare working branch against main/master
+ghostbuster scan --diff-base origin/main
+```
+
 ### Filtered Scan
 
 ```bash
@@ -205,6 +217,13 @@ pip install pytest ruff mypy
 pytest tests/ -v
 ```
 
+## Support & Sponsor
+
+If Ghostbuster helped clean up your codebase or saved CI minutes, consider supporting the project:
+
+[![Ko-fi](https://img.shields.io/badge/Ko--fi-Support%20on%20Ko--fi-FF5E5B?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ko-fi.com/adewanggar)
+[![Saweria](https://img.shields.io/badge/Saweria-Dukung%20lewat%20Saweria-FA8072?style=for-the-badge&logo=tether&logoColor=white)](https://saweria.co/adewanggar)
+
 ## License
 
 MIT (c) Ghostbuster Contributors

{ghostbuster_cli-0.3.0 → ghostbuster_cli-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ghostbuster-cli"
-version = "0.3.0"
+version = "0.4.0"
 description = "Find and bust the ghosts haunting your codebase - unused deps, dead code, orphan files, and phantom env vars."
 readme = "README.md"
 license = "MIT"

{ghostbuster_cli-0.3.0 → ghostbuster_cli-0.4.0}/src/ghostbuster/__init__.py

@@ -1,3 +1,3 @@
 """Ghostbuster — Find and bust the ghosts haunting your codebase."""
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"

{ghostbuster_cli-0.3.0 → ghostbuster_cli-0.4.0}/src/ghostbuster/cli/scan.py

@@ -23,6 +23,7 @@ from ghostbuster.cli.display import (
     print_scan_result_markdown,
     print_scanning_start,
 )
+from ghostbuster.core.git_diff import get_changed_files
 from ghostbuster.core.models import GhostCategory
 from ghostbuster.core.scanner import create_default_orchestrator
 
@@ -55,6 +56,17 @@ def scan(
         "-c",
         help="Only scan specific categories (dead-import, orphan-file, zombie-code, phantom-env).",
     ),
+    diff: bool = typer.Option(
+        False,
+        "--diff",
+        "-d",
+        help="Incremental fast scan: only scan modified, staged, and untracked files.",
+    ),
+    diff_base: str | None = typer.Option(
+        None,
+        "--diff-base",
+        help="Compare changed files against a specific git ref/branch (e.g. main, origin/main, HEAD~1).",
+    ),
     verbose: bool = typer.Option(
         False,
         "--verbose",
@@ -74,6 +86,8 @@ def scan(
 
     Examples:
         ghostbuster scan
+        ghostbuster scan --diff
+        ghostbuster scan --diff-base origin/main
         ghostbuster scan ./my-project --verbose
         ghostbuster scan --format json --category dead-import
     """
@@ -91,10 +105,19 @@ def scan(
                 )
                 raise typer.Exit(1)
 
+    # Handle diff mode
+    changed_files: set[Path] | None = None
+    if diff or diff_base:
+        changed_files = get_changed_files(path, base_ref=diff_base)
+
     # Show banner for rich format
     if format == OutputFormat.rich:
         print_banner()
         print_scanning_start(str(path), _get_scanner_names(category))
+        if diff or diff_base:
+            console.print(
+                f"  [cyan]Diff mode active ({len(changed_files or set())} changed files analyzed)[/cyan]\n"
+            )
 
     # Run the scan
     try:
@@ -105,7 +128,11 @@ def scan(
             if format == OutputFormat.rich
             else _nullcontext()
         ):
-            result = orchestrator.run(path, categories=category)
+            result = orchestrator.run(
+                path,
+                categories=category,
+                changed_files=changed_files if (diff or diff_base) else None,
+            )
 
     except Exception as exc:
         print_error(f"Scan failed: {exc}", "Run with --debug flag for full traceback.")

ghostbuster_cli-0.4.0/src/ghostbuster/core/git_diff.py

@@ -0,0 +1,80 @@
+"""Git Diff helper - detects changed and untracked files in git repositories."""
+
+from __future__ import annotations
+
+import subprocess
+from pathlib import Path
+
+
+def get_changed_files(path: Path, base_ref: str | None = None) -> set[Path]:
+    """Get the set of changed, added, and untracked files in a git repository.
+
+    Args:
+        path: Root path of the project.
+        base_ref: Optional git reference/branch to compare against (e.g. 'main', 'origin/main', 'HEAD~1').
+
+    Returns:
+        A set of absolute Paths for all modified/added/untracked files.
+    """
+    changed: set[Path] = set()
+
+    # Verify directory is a git repository
+    try:
+        check_git = subprocess.run(
+            ["git", "rev-parse", "--is-inside-work-tree"],
+            cwd=path,
+            capture_output=True,
+            text=True,
+            check=False,
+        )
+        if check_git.returncode != 0:
+            return changed
+    except (OSError, FileNotFoundError):
+        return changed
+
+    commands: list[list[str]] = []
+
+    if base_ref:
+        # Compare current working state or branch against base_ref
+        commands.append(["git", "diff", "--name-only", "--diff-filter=ACMR", base_ref])
+    else:
+        # Unstaged changes in working tree
+        commands.append(["git", "diff", "--name-only", "--diff-filter=ACMR"])
+        # Staged changes in index
+        commands.append(["git", "diff", "--name-only", "--cached", "--diff-filter=ACMR"])
+
+    # Also capture untracked files from git status
+    commands.append(["git", "status", "--porcelain"])
+
+    for cmd in commands:
+        try:
+            res = subprocess.run(
+                cmd,
+                cwd=path,
+                capture_output=True,
+                text=True,
+                check=False,
+            )
+            if res.returncode == 0:
+                for line in res.stdout.splitlines():
+                    line = line.strip()
+                    if not line:
+                        continue
+
+                    # Parse git status --porcelain output: '?? path/to/file' or 'M  path/to/file'
+                    if cmd[1] == "status":
+                        parts = line.split(maxsplit=1)
+                        if len(parts) == 2:
+                            rel_file = parts[1].strip('"')
+                            file_path = (path / rel_file).resolve()
+                            if file_path.exists():
+                                changed.add(file_path)
+                    else:
+                        # Parse git diff --name-only output
+                        file_path = (path / line).resolve()
+                        if file_path.exists():
+                            changed.add(file_path)
+        except OSError:
+            continue
+
+    return changed

{ghostbuster_cli-0.3.0 → ghostbuster_cli-0.4.0}/src/ghostbuster/core/scanner.py

@@ -52,6 +52,7 @@ class ScanOrchestrator:
         self,
         path: Path,
         categories: list[str] | None = None,
+        changed_files: set[Path] | None = None,
     ) -> ScanResult:
         """Run all registered scanners (or filtered subset) on the given path.
 
@@ -59,6 +60,8 @@ class ScanOrchestrator:
             path: Root directory to scan.
             categories: Optional list of category names to filter scanners.
                         If None, all scanners are run.
+            changed_files: Optional set of changed file Paths from git diff.
+                           If provided, results will be filtered to these files.
 
         Returns:
             Aggregated ScanResult with all ghosts found and a score.
@@ -86,6 +89,18 @@ class ScanOrchestrator:
                     )
                 )
 
+        # In diff mode, filter ghosts to only those originating in changed files
+        if changed_files is not None:
+            resolved_changed = {p.resolve() for p in changed_files}
+            filtered_ghosts: list[Ghost] = []
+            for g in all_ghosts:
+                if g.file_path and g.file_path.resolve() in resolved_changed:
+                    filtered_ghosts.append(g)
+                elif not g.file_path:
+                    # Keep findings without a specific file path (general warnings)
+                    filtered_ghosts.append(g)
+            all_ghosts = filtered_ghosts
+
         elapsed_ms = (time.perf_counter() - start) * 1000
         score = calculate_score(all_ghosts)
 

{ghostbuster_cli-0.3.0 → ghostbuster_cli-0.4.0}/tests/test_cli.py

@@ -17,7 +17,7 @@ class TestCLI:
         result = runner.invoke(app, ["--version"])
         assert result.exit_code == 0
         assert "ghostbuster" in result.output
-        assert "0.3.0" in result.output
+        assert "0.4.0" in result.output
 
     def test_help_flag(self) -> None:
         """--help should print help text."""

ghostbuster_cli-0.4.0/tests/test_git_diff.py

@@ -0,0 +1,114 @@
+"""Tests for Git Diff / Fast Scan mode."""
+
+from __future__ import annotations
+
+import subprocess
+from pathlib import Path
+
+from typer.testing import CliRunner
+
+from ghostbuster.cli.app import app
+from ghostbuster.core.git_diff import get_changed_files
+from ghostbuster.core.models import Ghost, GhostCategory, Severity
+from ghostbuster.core.scanner import ScanOrchestrator
+
+runner = CliRunner()
+
+
+class TestGitDiffHelper:
+    """Tests for get_changed_files."""
+
+    def test_non_git_directory_returns_empty_set(self, tmp_path: Path) -> None:
+        """Should return empty set for a non-git directory."""
+        changed = get_changed_files(tmp_path)
+        assert len(changed) == 0
+
+    def test_detects_untracked_and_modified_files(self, tmp_path: Path) -> None:
+        """Should detect untracked and modified files in a git repo."""
+        # Initialize git repo in tmp_path
+        subprocess.run(["git", "init"], cwd=tmp_path, capture_output=True, check=True)
+        subprocess.run(
+            ["git", "config", "user.email", "test@example.com"],
+            cwd=tmp_path,
+            capture_output=True,
+            check=True,
+        )
+        subprocess.run(
+            ["git", "config", "user.name", "Test User"],
+            cwd=tmp_path,
+            capture_output=True,
+            check=True,
+        )
+
+        # Create committed file
+        file1 = tmp_path / "initial.py"
+        file1.write_text("x = 1\n", encoding="utf-8")
+        subprocess.run(["git", "add", "."], cwd=tmp_path, capture_output=True, check=True)
+        subprocess.run(
+            ["git", "commit", "-m", "init"], cwd=tmp_path, capture_output=True, check=True
+        )
+
+        # Modify file1 and create untracked file2
+        file1.write_text("x = 2\n", encoding="utf-8")
+        file2 = tmp_path / "untracked.py"
+        file2.write_text("y = 3\n", encoding="utf-8")
+
+        changed = get_changed_files(tmp_path)
+        assert file1.resolve() in changed
+        assert file2.resolve() in changed
+
+
+class TestScanOrchestratorDiffFilter:
+    """Tests for ScanOrchestrator filtering with changed_files."""
+
+    def test_filters_ghosts_to_changed_files(self, tmp_path: Path) -> None:
+        """Should only return ghosts originating in changed_files."""
+        file_a = tmp_path / "a.py"
+        file_b = tmp_path / "b.py"
+        file_a.write_text("pass\n", encoding="utf-8")
+        file_b.write_text("pass\n", encoding="utf-8")
+
+        ghosts = [
+            Ghost(
+                category=GhostCategory.ZOMBIE_CODE,
+                name="unused_a",
+                message="unused in a",
+                file_path=file_a,
+                severity=Severity.LOW,
+            ),
+            Ghost(
+                category=GhostCategory.ZOMBIE_CODE,
+                name="unused_b",
+                message="unused in b",
+                file_path=file_b,
+                severity=Severity.LOW,
+            ),
+        ]
+
+        class MockScanner:
+            name = "mock"
+
+            def scan(self, path: Path) -> list[Ghost]:
+                return ghosts
+
+        orchestrator = ScanOrchestrator()
+        orchestrator.register(MockScanner())
+
+        # Only file_a changed
+        result = orchestrator.run(tmp_path, changed_files={file_a})
+        assert len(result.ghosts) == 1
+        assert result.ghosts[0].name == "unused_a"
+
+
+class TestScanCliDiffFlag:
+    """Tests for CLI --diff flag."""
+
+    def test_cli_diff_option_help(self) -> None:
+        """--help should include --diff and --diff-base."""
+        import re
+
+        result = runner.invoke(app, ["scan", "--help"])
+        assert result.exit_code == 0
+        clean_output = re.sub(r"\x1b\[[0-9;]*[a-zA-Z]", "", result.output)
+        assert "--diff" in clean_output
+        assert "--diff-base" in clean_output