ghostbuster-cli 0.1.0__tar.gz → 0.2.0__tar.gz

{ghostbuster_cli-0.1.0 → ghostbuster_cli-0.2.0}/.github/workflows/ci.yml

@@ -11,7 +11,7 @@ permissions:
 
 jobs:
   lint:
-    name: Lint
+    name: Lint & Type Check
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -24,6 +24,7 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
+          pip install -e .
           pip install ruff mypy
 
       - name: Ruff check
@@ -33,12 +34,10 @@ jobs:
         run: ruff format --check src/ tests/
 
       - name: Mypy type check
-        run: |
-          pip install -e ".[dev]" 2>/dev/null || pip install -e .
-          mypy src/
+        run: mypy src/
 
   test:
-    name: Test (Python ${{ matrix.python-version }})
+    name: Test (Python ${{ matrix.python-version }} on ${{ matrix.os }})
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
@@ -69,7 +68,7 @@ jobs:
         run: pytest tests/ -v --tb=short
 
   build:
-    name: Build check
+    name: Build Check
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -80,33 +79,12 @@ jobs:
           python-version: "3.12"
 
       - name: Install build tools
-        run: python -m pip install --upgrade pip build twine
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
 
       - name: Build package
         run: python -m build
 
       - name: Check package
         run: twine check dist/*
-
-      - name: Upload artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: dist
-          path: dist/
-
-  # Uncomment when ready to publish to PyPI
-  # publish:
-  #   name: Publish to PyPI
-  #   needs: [lint, test, build]
-  #   runs-on: ubuntu-latest
-  #   if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
-  #   environment: pypi
-  #   permissions:
-  #     id-token: write  # Required for trusted publishing
-  #   steps:
-  #     - uses: actions/download-artifact@v4
-  #       with:
-  #         name: dist
-  #         path: dist/
-  #     - name: Publish to PyPI
-  #       uses: pypa/gh-action-pypi-publish@release/v1

ghostbuster_cli-0.2.0/.github/workflows/publish.yml

@@ -0,0 +1,35 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  pypi-publish:
+    name: Upload package to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/ghostbuster-cli
+    permissions:
+      id-token: write  # Mandatory for Trusted Publishing (OIDC)
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build
+        run: python -m pip install --upgrade pip build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

ghostbuster_cli-0.2.0/.pre-commit-hooks.yaml

@@ -0,0 +1,8 @@
+- id: ghostbuster-scan
+  name: ghostbuster scan
+  description: Find and bust the ghosts haunting your codebase
+  entry: ghostbuster scan
+  language: python
+  types: [python]
+  pass_filenames: false
+  always_run: true

{ghostbuster_cli-0.1.0 → ghostbuster_cli-0.2.0}/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-08-29
+
+### Added
+
+- **Pre-commit Hook Integration**: added `.pre-commit-hooks.yaml` for automated pre-commit scanning (`ghostbuster-scan`).
+- **Auto-Fix for Orphan Files**: `ghostbuster bust --confirm` now automatically appends missing folders and files to `.gitignore`.
+- **Auto-Fix for Phantom Env Vars**: `ghostbuster bust --confirm` now automatically appends missing environment variable stubs to `.env.example`.
+- **Poetry Dependencies Support**: Dead Import Scanner now automatically parses `[tool.poetry.dependencies]` and `[tool.poetry.group.*.dependencies]`.
+- Comprehensive test suite for all auto-fixers (`GitignoreFixer`, `EnvFixer`, `ImportFixer`).
+
 ## [0.1.0] - 2026-08-29
 
 ### Added

{ghostbuster_cli-0.1.0 → ghostbuster_cli-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ghostbuster-cli
-Version: 0.1.0
+Version: 0.2.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
@@ -28,6 +28,12 @@ Requires-Python: >=3.10
 Requires-Dist: rich>=13.0.0
 Requires-Dist: tomli>=2.0.0; python_version < '3.11'
 Requires-Dist: typer>=0.9.0
+Provides-Extra: dev
+Requires-Dist: build>=1.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Requires-Dist: twine>=5.0.0; extra == 'dev'
 Description-Content-Type: text/markdown
 
 <div align="center">
@@ -104,9 +110,9 @@ ghostbuster bust --confirm
 ```
 
 Currently auto-fixes:
-- Removes unused import statements
-- Suggests `.gitignore` additions for orphan files
-- Suggests `.env` additions for phantom env vars
+- Removes unused import statements from Python files
+- Appends missing orphan files and directories to `.gitignore`
+- Appends missing environment variable stubs (`KEY=`) to `.env.example`
 
 ## Usage
 
@@ -146,6 +152,18 @@ ghostbuster scan --format json
 ghostbuster scan --format markdown
 ```
 
+### Pre-commit Hook Integration
+
+Add Ghostbuster to your `.pre-commit-config.yaml`:
+
+```yaml
+repos:
+  - repo: https://github.com/adewanggar/ghostbuster-cli
+    rev: v0.2.0
+    hooks:
+      - id: ghostbuster-scan
+```
+
 ### CI Integration
 
 ```yaml

{ghostbuster_cli-0.1.0 → ghostbuster_cli-0.2.0}/README.md

@@ -72,9 +72,9 @@ ghostbuster bust --confirm
 ```
 
 Currently auto-fixes:
-- Removes unused import statements
-- Suggests `.gitignore` additions for orphan files
-- Suggests `.env` additions for phantom env vars
+- Removes unused import statements from Python files
+- Appends missing orphan files and directories to `.gitignore`
+- Appends missing environment variable stubs (`KEY=`) to `.env.example`
 
 ## Usage
 
@@ -114,6 +114,18 @@ ghostbuster scan --format json
 ghostbuster scan --format markdown
 ```
 
+### Pre-commit Hook Integration
+
+Add Ghostbuster to your `.pre-commit-config.yaml`:
+
+```yaml
+repos:
+  - repo: https://github.com/adewanggar/ghostbuster-cli
+    rev: v0.2.0
+    hooks:
+      - id: ghostbuster-scan
+```
+
 ### CI Integration
 
 ```yaml

{ghostbuster_cli-0.1.0 → ghostbuster_cli-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ghostbuster-cli"
-version = "0.1.0"
+version = "0.2.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"
@@ -42,6 +42,15 @@ dependencies = [
     "tomli>=2.0.0; python_version < '3.11'",
 ]
 
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "ruff>=0.4.0",
+    "mypy>=1.10.0",
+    "build>=1.0.0",
+    "twine>=5.0.0",
+]
+
 [project.scripts]
 ghostbuster = "ghostbuster.cli.app:app"
 
@@ -97,5 +106,4 @@ warn_return_any = true
 warn_unused_configs = true
 disallow_untyped_defs = true
 check_untyped_defs = true
-mypy_path = "src"
-packages = ["ghostbuster"]
+ignore_missing_imports = true

{ghostbuster_cli-0.1.0 → ghostbuster_cli-0.2.0}/src/ghostbuster/__init__.py

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

{ghostbuster_cli-0.1.0 → ghostbuster_cli-0.2.0}/src/ghostbuster/cli/bust.py

@@ -22,7 +22,7 @@ from ghostbuster.cli.display import (
 )
 from ghostbuster.core.models import GhostCategory
 from ghostbuster.core.scanner import create_default_orchestrator
-from ghostbuster.fixers.import_fixer import ImportFixer
+from ghostbuster.fixers import EnvFixer, Fixer, GitignoreFixer, ImportFixer
 
 
 def bust(
@@ -101,16 +101,28 @@ def bust(
 
     console.print(f"  Found [bold]{len(fixable_ghosts)}[/bold] fixable ghosts.\n")
 
-    # Apply fixes per category
-    fixer = ImportFixer()
+    # Run fixers across all categories
+    fixers: list[Fixer] = [
+        ImportFixer(),
+        GitignoreFixer(),
+        EnvFixer(),
+    ]
+
+    all_changes: list[str] = []
 
     if confirm:
-        changes = fixer.fix(fixable_ghosts, path)
-        print_bust_applied(changes)
+        for fixer in fixers:
+            changes = fixer.fix(fixable_ghosts, path)
+            all_changes.extend(changes)
+
+        print_bust_applied(all_changes)
         console.print(
             "\n  [bold green]Ghostbusting complete![/bold green] "
             "Don't forget to review the changes and run your tests.\n"
         )
     else:
-        changes = fixer.preview(fixable_ghosts, path)
-        print_bust_preview(changes)
+        for fixer in fixers:
+            changes = fixer.preview(fixable_ghosts, path)
+            all_changes.extend(changes)
+
+        print_bust_preview(all_changes)

{ghostbuster_cli-0.1.0 → ghostbuster_cli-0.2.0}/src/ghostbuster/config.py

@@ -11,6 +11,7 @@ from __future__ import annotations
 import sys
 from dataclasses import dataclass, field
 from pathlib import Path
+from typing import Any, cast
 
 
 @dataclass
@@ -84,7 +85,7 @@ class GhostbusterConfig:
         return config
 
 
-def _load_toml(filepath: Path) -> dict:
+def _load_toml(filepath: Path) -> dict[str, Any]:
     """Load a TOML file and return its contents as a dict."""
     try:
         if sys.version_info >= (3, 11):
@@ -92,25 +93,26 @@ def _load_toml(filepath: Path) -> dict:
         else:
             import tomli as tomllib  # type: ignore[no-redef]
 
-        return tomllib.loads(filepath.read_text(encoding="utf-8"))
+        data = tomllib.loads(filepath.read_text(encoding="utf-8"))
+        return cast("dict[str, Any]", data) if isinstance(data, dict) else {}
     except Exception:
         return {}
 
 
-def _apply_config(config: GhostbusterConfig, data: dict) -> GhostbusterConfig:
+def _apply_config(config: GhostbusterConfig, data: dict[str, Any]) -> GhostbusterConfig:
     """Apply a dict of config values to a GhostbusterConfig."""
-    if "exclude_dirs" in data:
+    if "exclude_dirs" in data and isinstance(data["exclude_dirs"], list):
         config.exclude_dirs = data["exclude_dirs"]
-    if "exclude_patterns" in data:
+    if "exclude_patterns" in data and isinstance(data["exclude_patterns"], list):
         config.exclude_patterns = data["exclude_patterns"]
-    if "categories" in data:
+    if "categories" in data and isinstance(data["categories"], list):
         config.categories = data["categories"]
-    if "ignore_packages" in data:
+    if "ignore_packages" in data and isinstance(data["ignore_packages"], list):
         config.ignore_packages = data["ignore_packages"]
-    if "ignore_env_vars" in data:
+    if "ignore_env_vars" in data and isinstance(data["ignore_env_vars"], list):
         config.ignore_env_vars = data["ignore_env_vars"]
-    if "ignore_names" in data:
+    if "ignore_names" in data and isinstance(data["ignore_names"], list):
         config.ignore_names = data["ignore_names"]
-    if "large_file_threshold" in data:
+    if "large_file_threshold" in data and isinstance(data["large_file_threshold"], int):
         config.large_file_threshold = data["large_file_threshold"]
     return config

ghostbuster_cli-0.2.0/src/ghostbuster/fixers/__init__.py

@@ -0,0 +1,29 @@
+"""Auto-fix modules for resolving ghost findings."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Protocol
+
+from ghostbuster.fixers.env_fixer import EnvFixer
+from ghostbuster.fixers.gitignore_fixer import GitignoreFixer
+from ghostbuster.fixers.import_fixer import ImportFixer
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+    from ghostbuster.core.models import Ghost
+
+
+class Fixer(Protocol):
+    """Protocol that all fixers must implement."""
+
+    def preview(self, ghosts: list[Ghost], path: Path) -> list[str]:
+        """Return preview of changes without applying them."""
+        ...
+
+    def fix(self, ghosts: list[Ghost], path: Path) -> list[str]:
+        """Apply fixes and return list of changes made."""
+        ...
+
+
+__all__ = ["EnvFixer", "Fixer", "GitignoreFixer", "ImportFixer"]

ghostbuster_cli-0.2.0/src/ghostbuster/fixers/env_fixer.py

@@ -0,0 +1,112 @@
+"""Env Fixer - adds phantom environment variables to .env.example or .env."""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+from ghostbuster.core.models import Ghost, GhostCategory
+
+
+class EnvFixer:
+    """Auto-fixer that appends missing environment variable stubs to .env.example."""
+
+    def preview(self, ghosts: list[Ghost], path: Path) -> list[str]:
+        """Return a list of changes that would be made without modifying files."""
+        env_ghosts = [g for g in ghosts if g.category == GhostCategory.PHANTOM_ENV and g.fixable]
+        if not env_ghosts:
+            return []
+
+        target_file = self._get_target_file(path)
+        keys_to_add = self._get_keys_to_add(env_ghosts, target_file)
+        if not keys_to_add:
+            return []
+
+        target_name = target_file.name if target_file.exists() else f"{target_file.name} (new file)"
+
+        changes: list[str] = []
+        for key in keys_to_add:
+            changes.append(f"  Would add '{key}=' to {target_name}")
+
+        return changes
+
+    def fix(self, ghosts: list[Ghost], path: Path) -> list[str]:
+        """Append missing environment variable keys to .env.example or .env."""
+        env_ghosts = [g for g in ghosts if g.category == GhostCategory.PHANTOM_ENV and g.fixable]
+        if not env_ghosts:
+            return []
+
+        target_file = self._get_target_file(path)
+        keys_to_add = self._get_keys_to_add(env_ghosts, target_file)
+        if not keys_to_add:
+            return []
+
+        existing_content = ""
+        if target_file.exists():
+            try:
+                existing_content = target_file.read_text(encoding="utf-8")
+            except OSError:
+                existing_content = ""
+
+        # Prepare new lines
+        new_lines: list[str] = []
+        if existing_content and not existing_content.endswith("\n"):
+            new_lines.append("\n")
+
+        for key in keys_to_add:
+            new_lines.append(f"{key}=\n")
+
+        try:
+            with target_file.open("a", encoding="utf-8") as f:
+                f.write("".join(new_lines))
+        except OSError:
+            return []
+
+        applied: list[str] = []
+        for key in keys_to_add:
+            applied.append(f"  Added '{key}=' to {target_file.name}")
+
+        return applied
+
+    def _get_target_file(self, path: Path) -> Path:
+        """Get the preferred env file to update."""
+        env_example = path / ".env.example"
+        if env_example.exists():
+            return env_example
+
+        env_sample = path / ".env.sample"
+        if env_sample.exists():
+            return env_sample
+
+        env_template = path / ".env.template"
+        if env_template.exists():
+            return env_template
+
+        # Default to .env.example to prevent accidental secret commits
+        return path / ".env.example"
+
+    def _get_keys_to_add(self, ghosts: list[Ghost], target_file: Path) -> list[str]:
+        """Determine unique environment variable keys that need to be added."""
+        existing_keys: set[str] = set()
+
+        if target_file.exists():
+            try:
+                for line in target_file.read_text(encoding="utf-8").splitlines():
+                    cleaned = line.strip()
+                    if cleaned and not cleaned.startswith("#"):
+                        match = re.match(r"^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)=", cleaned)
+                        if match:
+                            existing_keys.add(match.group(1))
+            except OSError:
+                pass
+
+        keys: list[str] = []
+        seen: set[str] = set()
+
+        for ghost in ghosts:
+            key = ghost.name
+            if key not in existing_keys and key not in seen:
+                seen.add(key)
+                keys.append(key)
+
+        return keys

ghostbuster_cli-0.2.0/src/ghostbuster/fixers/gitignore_fixer.py

@@ -0,0 +1,101 @@
+"""Gitignore Fixer - adds orphan files and directories to .gitignore."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from ghostbuster.core.models import Ghost, GhostCategory
+
+
+class GitignoreFixer:
+    """Auto-fixer that appends orphan files/directories to .gitignore."""
+
+    def preview(self, ghosts: list[Ghost], path: Path) -> list[str]:
+        """Return a list of changes that would be made without modifying files."""
+        orphan_ghosts = [g for g in ghosts if g.category == GhostCategory.ORPHAN_FILE and g.fixable]
+        if not orphan_ghosts:
+            return []
+
+        entries_to_add = self._get_entries_to_add(orphan_ghosts, path)
+        if not entries_to_add:
+            return []
+
+        gitignore_path = path / ".gitignore"
+        target_name = ".gitignore" if gitignore_path.exists() else ".gitignore (new file)"
+
+        changes: list[str] = []
+        for entry in entries_to_add:
+            changes.append(f"  Would add '{entry}' to {target_name}")
+
+        return changes
+
+    def fix(self, ghosts: list[Ghost], path: Path) -> list[str]:
+        """Append missing orphan patterns to .gitignore."""
+        orphan_ghosts = [g for g in ghosts if g.category == GhostCategory.ORPHAN_FILE and g.fixable]
+        if not orphan_ghosts:
+            return []
+
+        entries_to_add = self._get_entries_to_add(orphan_ghosts, path)
+        if not entries_to_add:
+            return []
+
+        gitignore_path = path / ".gitignore"
+        existing_content = ""
+        if gitignore_path.exists():
+            try:
+                existing_content = gitignore_path.read_text(encoding="utf-8")
+            except OSError:
+                existing_content = ""
+
+        # Prepare new content
+        new_lines: list[str] = []
+        if existing_content and not existing_content.endswith("\n"):
+            new_lines.append("\n")
+
+        for entry in entries_to_add:
+            new_lines.append(f"{entry}\n")
+
+        try:
+            with gitignore_path.open("a", encoding="utf-8") as f:
+                f.write("".join(new_lines))
+        except OSError:
+            return []
+
+        applied: list[str] = []
+        for entry in entries_to_add:
+            applied.append(f"  Added '{entry}' to .gitignore")
+
+        return applied
+
+    def _get_entries_to_add(self, ghosts: list[Ghost], path: Path) -> list[str]:
+        """Determine unique entries that need to be added to .gitignore."""
+        gitignore_path = path / ".gitignore"
+        existing_lines: set[str] = set()
+
+        if gitignore_path.exists():
+            try:
+                for line in gitignore_path.read_text(encoding="utf-8").splitlines():
+                    cleaned = line.strip()
+                    if cleaned and not cleaned.startswith("#"):
+                        existing_lines.add(cleaned.rstrip("/"))
+            except OSError:
+                pass
+
+        entries: list[str] = []
+        seen: set[str] = set()
+
+        for ghost in ghosts:
+            # Determine appropriate pattern
+            name = ghost.name
+            if ghost.file_path and ghost.file_path.is_dir():
+                pattern = f"{name}/"
+                check_name = name.rstrip("/")
+            else:
+                pattern = name
+                check_name = name
+
+            if check_name not in existing_lines and pattern not in seen:
+                seen.add(pattern)
+                entries.append(pattern)
+
+        return entries

{ghostbuster_cli-0.1.0 → ghostbuster_cli-0.2.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.1.0" in result.output
+        assert "0.2.0" in result.output
 
     def test_help_flag(self) -> None:
         """--help should print help text."""

ghostbuster_cli-0.2.0/tests/test_fixers.py

@@ -0,0 +1,171 @@
+"""Tests for Ghostbuster auto-fixers."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from ghostbuster.core.models import Ghost, GhostCategory, Severity
+from ghostbuster.fixers.env_fixer import EnvFixer
+from ghostbuster.fixers.gitignore_fixer import GitignoreFixer
+
+
+class TestGitignoreFixer:
+    """Tests for GitignoreFixer."""
+
+    def test_preview_gitignore_changes(self, tmp_path: Path) -> None:
+        """Should preview adding orphan directories/files to .gitignore."""
+        node_modules = tmp_path / "node_modules"
+        node_modules.mkdir()
+
+        ghosts = [
+            Ghost(
+                category=GhostCategory.ORPHAN_FILE,
+                name="node_modules",
+                message="Directory node_modules should be in .gitignore",
+                file_path=node_modules,
+                severity=Severity.HIGH,
+                fixable=True,
+            ),
+            Ghost(
+                category=GhostCategory.ORPHAN_FILE,
+                name=".DS_Store",
+                message="File .DS_Store should be in .gitignore",
+                file_path=tmp_path / ".DS_Store",
+                severity=Severity.LOW,
+                fixable=True,
+            ),
+        ]
+
+        fixer = GitignoreFixer()
+        preview = fixer.preview(ghosts, tmp_path)
+
+        assert len(preview) == 2
+        assert any("node_modules/" in p for p in preview)
+        assert any(".DS_Store" in p for p in preview)
+        # .gitignore should NOT be created during preview
+        assert not (tmp_path / ".gitignore").exists()
+
+    def test_apply_gitignore_fix(self, tmp_path: Path) -> None:
+        """Should append missing entries to .gitignore."""
+        (tmp_path / "venv").mkdir()
+        (tmp_path / ".gitignore").write_text("__pycache__/\n", encoding="utf-8")
+
+        ghosts = [
+            Ghost(
+                category=GhostCategory.ORPHAN_FILE,
+                name="venv",
+                message="venv should be in .gitignore",
+                file_path=tmp_path / "venv",
+                severity=Severity.HIGH,
+                fixable=True,
+            ),
+        ]
+
+        fixer = GitignoreFixer()
+        applied = fixer.fix(ghosts, tmp_path)
+
+        assert len(applied) == 1
+        content = (tmp_path / ".gitignore").read_text(encoding="utf-8")
+        assert "__pycache__/\n" in content
+        assert "venv/\n" in content
+
+    def test_skips_already_ignored_entries(self, tmp_path: Path) -> None:
+        """Should not add duplicate entries."""
+        (tmp_path / ".gitignore").write_text("node_modules/\n", encoding="utf-8")
+        (tmp_path / "node_modules").mkdir()
+
+        ghosts = [
+            Ghost(
+                category=GhostCategory.ORPHAN_FILE,
+                name="node_modules",
+                message="Directory node_modules",
+                file_path=tmp_path / "node_modules",
+                severity=Severity.HIGH,
+                fixable=True,
+            ),
+        ]
+
+        fixer = GitignoreFixer()
+        applied = fixer.fix(ghosts, tmp_path)
+        assert len(applied) == 0
+
+
+class TestEnvFixer:
+    """Tests for EnvFixer."""
+
+    def test_preview_env_changes(self, tmp_path: Path) -> None:
+        """Should preview adding missing env keys to .env.example."""
+        ghosts = [
+            Ghost(
+                category=GhostCategory.PHANTOM_ENV,
+                name="DATABASE_URL",
+                message="DATABASE_URL is missing",
+                severity=Severity.HIGH,
+                fixable=True,
+            ),
+            Ghost(
+                category=GhostCategory.PHANTOM_ENV,
+                name="STRIPE_SECRET_KEY",
+                message="STRIPE_SECRET_KEY is missing",
+                severity=Severity.HIGH,
+                fixable=True,
+            ),
+        ]
+
+        fixer = EnvFixer()
+        preview = fixer.preview(ghosts, tmp_path)
+
+        assert len(preview) == 2
+        assert any("DATABASE_URL=" in p for p in preview)
+        assert any("STRIPE_SECRET_KEY=" in p for p in preview)
+        assert not (tmp_path / ".env.example").exists()
+
+    def test_apply_env_fix(self, tmp_path: Path) -> None:
+        """Should create .env.example and append missing keys."""
+        ghosts = [
+            Ghost(
+                category=GhostCategory.PHANTOM_ENV,
+                name="API_KEY",
+                message="API_KEY is missing",
+                severity=Severity.HIGH,
+                fixable=True,
+            ),
+        ]
+
+        fixer = EnvFixer()
+        applied = fixer.fix(ghosts, tmp_path)
+
+        assert len(applied) == 1
+        env_example = tmp_path / ".env.example"
+        assert env_example.exists()
+        content = env_example.read_text(encoding="utf-8")
+        assert "API_KEY=\n" in content
+
+    def test_preserves_existing_keys_in_env_example(self, tmp_path: Path) -> None:
+        """Should append new keys without duplicating existing ones."""
+        (tmp_path / ".env.example").write_text("EXISTING_KEY=123\n", encoding="utf-8")
+
+        ghosts = [
+            Ghost(
+                category=GhostCategory.PHANTOM_ENV,
+                name="EXISTING_KEY",
+                message="Already in example",
+                severity=Severity.HIGH,
+                fixable=True,
+            ),
+            Ghost(
+                category=GhostCategory.PHANTOM_ENV,
+                name="NEW_KEY",
+                message="New key",
+                severity=Severity.HIGH,
+                fixable=True,
+            ),
+        ]
+
+        fixer = EnvFixer()
+        applied = fixer.fix(ghosts, tmp_path)
+
+        assert len(applied) == 1
+        content = (tmp_path / ".env.example").read_text(encoding="utf-8")
+        assert "EXISTING_KEY=123\n" in content
+        assert "NEW_KEY=\n" in content

ghostbuster_cli-0.1.0/src/ghostbuster/fixers/__init__.py

@@ -1 +0,0 @@
-"""Auto-fix modules for resolving ghost findings."""