deployproof 0.2.1__tar.gz → 1.0.0__tar.gz

{deployproof-0.2.1/src/deployproof.egg-info → deployproof-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deployproof
-Version: 0.2.1
+Version: 1.0.0
 Summary: A deterministic AI-code deployability checker that catches what coverage misses.
 Author-email: SVS Praveen <svspraveens@gmail.com>
 License-Expression: MIT
@@ -32,10 +32,10 @@ Dynamic: license-file
 
 > Deterministic pre-push verification for AI-assisted codebases: AST mutation testing, credential scanning, sandbox-escape detection, mock-usage alerts, swallowed-exception checks, and dependency hallucination defense.
 
-[![PyPI version](https://img.shields.io/badge/pypi-v0.2.1-007ec6.svg)](https://pypi.org/project/deployproof/)
+[![PyPI version](https://img.shields.io/badge/pypi-v1.0.0-007ec6.svg)](https://pypi.org/project/deployproof/)
 [![Python versions](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-3776ab.svg)](https://pypi.org/project/deployproof/)
 [![CI](https://github.com/SVSPraveen/DeployProof/actions/workflows/ci.yml/badge.svg)](https://github.com/SVSPraveen/DeployProof/actions/workflows/ci.yml)
-[![Tests](https://img.shields.io/badge/tests-94%20passed-2ea44f.svg)](https://github.com/SVSPraveen/DeployProof)
+[![Tests](https://img.shields.io/badge/tests-111%20passed-2ea44f.svg)](https://github.com/SVSPraveen/DeployProof)
 [![Stress Tests](https://img.shields.io/badge/stress%20tests-11%2F11%20passed-2ea44f.svg)](stress_fixtures/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
@@ -45,6 +45,8 @@ Dynamic: license-file
 
 AI-assisted development introduces subtle failure modes that standard linters and coverage tools miss: test suites with high line coverage but near-zero mutation scores, hardcoded credentials generated in passing, symlinks that deceive approval prompts into escaping the repository sandbox, silently swallowed exceptions, and package names hallucinated by LLMs that don't exist on PyPI. DeployProof catches these at the pre-push stage, before they reach CI or production.
 
+> **Privacy & Security Guarantee**: DeployProof runs 100% locally on your machine. It makes zero outbound network calls, except for querying the official PyPI registry (JSON API) to verify that newly introduced dependencies exist and are not hallucinated. DeployProof sends no source code, telemetry, test results, or secret findings to any external server.
+
 ## Install
 
 ```bash
@@ -53,20 +55,70 @@ pip install deployproof
 
 Requires Python 3.10+.
 
-## Quickstart
+## How to Use DeployProof
+
+DeployProof provides two distinct modes of operation. We believe in total transparency about execution costs:
 
-Initialize in your repository:
+### 1. Diff-Scoped Pre-Push Gate (`deployproof check`) — *Primary Fast Workflow*
+Evaluates **only the files modified in your active session or git diff** (1–3 files typically). Because only newly edited AST nodes are mutated, it executes in **2 to 5 seconds** in local developer loops, pre-commit hooks, and pre-push gates.
 
 ```bash
-deployproof init
+# Fast daily check: verifies modified files in your current working tree / git diff (2-5s)
+deployproof check
+
+# Output structured JSON for automation or IDE tooling
+deployproof check --json
+
+# Enforce strict gates on newly introduced mocks or swallowed errors
+deployproof check --strict-mocks --strict-error-handling
 ```
 
-Run all verification checks against changes in the current session (git diff):
+### 2. Full Repository Audit Mode (`deployproof check --full-repo`) — *Thorough Codebase Audits*
+Evaluates **every tracked Python file across the entire repository**. Because mutation testing generates hundreds or thousands of mutants and runs the test suite against each one in isolated multi-worker sandboxes, full repository scans take real, honest compute time:
 
 ```bash
-deployproof check
+# Run a full-repository audit across all tracked files
+deployproof check --full-repo
+
+# Customize the parallel worker process count (defaults to auto-detected CPU count capped at 8)
+deployproof check --full-repo --workers 8
+```
+
+#### Real-World Timing Expectations:
+| Scan Mode | Target Scope | Typical Duration | Intended Use Case |
+| :--- | :--- | :--- | :--- |
+| **`deployproof check`** | Git Diff (1–3 modified files) | **2 – 5 seconds** | Local pre-commit, active AI IDE coding loops, pre-push sanity checks. |
+| **`deployproof check --workers 8`** | Large Multi-File Diff (100+ mutants) | **1 – 3 minutes** | Large feature branch reviews, refactors. |
+| **`deployproof check --full-repo`** | Small Repo (< 100 mutants) | **30s – 2 minutes** | Initial repo onboarding, weekly audits. |
+| **`deployproof check --full-repo`** | Medium Repo (200–500 mutants) | **5 – 15 minutes** | Release validation, scheduled CI jobs. |
+| **`deployproof check --full-repo`** | Heavy / Network Lib (`requests`, 800 mutants) | **60 – 85 minutes** | Deep occasional audit sweeps. |
+
+### Parallel Multi-Worker Sandboxing (`--workers N`)
+
+DeployProof includes a built-in multi-process execution engine (`ProcessPoolExecutor`) for parallel mutation testing. You can supply `--workers <N>` to both diff-scoped checks and full-repo audits:
+
+```bash
+# Parallelize a large uncommitted diff across 8 worker processes
+deployproof check --workers 8
+
+# Full repository audit distributed across 8 worker processes
+deployproof check --full-repo --workers 8
 ```
 
+#### How Parallel Sandboxing Works:
+1. **Snapshot Creation**: DeployProof takes an initial atomic snapshot of your project into a clean temporary directory.
+2. **PID-Keyed Sandboxes**: Each worker process receives its own dedicated filesystem sandbox (`worker_<PID>`), with an independent `pytest` cache (`--override-ini=cache_dir=...`) and separate temporary directory (`--basetemp=...`).
+3. **Zero Mutation Leaks**: Mutants are generated and executed inside individual worker sandboxes in parallel. The working tree is untouched, and signal handlers (`SIGINT`, `SIGTERM`, `SIGBREAK`) ensure sandboxes are cleanly purged upon completion or interruption.
+
+#### Advantages & When to Use:
+* **Large Diff / Full Repo Speedup**: Near-linear execution scaling across CPU cores for batches with 50+ mutants, cutting 30-minute sweeps down to 5–8 minutes.
+* **Process & Cache Isolation**: Eliminates cross-test state leakage, shared database locking, and `.pytest_cache` collisions between concurrent workers.
+
+#### Trade-offs & When NOT to Use:
+* **Small Daily Diffs (1–3 files)**: Do NOT use `--workers` for small 2-line edits. Spawning isolated sandboxes and copying file trees incurs ~1–2 seconds of snapshot overhead. Sequential in-place mutation executes in **2–5 seconds** with zero snapshot overhead.
+* **Disk Space & I/O Overhead**: Running $N$ workers copies the repository snapshot $N$ times into temporary storage ($N \times \text{repo size}$ in `tempfile.gettempdir()`). On disk-constrained environments, use fewer workers (e.g. `--workers 2` or `--workers 4`).
+* **Subprocess / Port Collisions**: If your test suite binds to fixed network ports (e.g. localhost:8080) without dynamic port selection, parallel workers running tests concurrently may trigger port conflicts. Use isolated ports or run sequentially in such environments.
+
 Output includes a section for each check — symlink scan, secrets scan, dependency scan, mock detection, control flow analysis, and mutation score — with a pass/fail line at the bottom. 
 
 ### Exit Codes:
@@ -173,6 +225,8 @@ Pre-check clean: 100% of tested basic mutations caught.
 | `deployproof check --files <paths...>` | Explicitly evaluate specific files (bypasses git diff). |
 | `deployproof check --threshold <float>` | Minimum mutation score percentage required to pass (default: `80.0`). |
 | `deployproof check --base <ref>` | Base git ref (branch/commit/tag) to diff against. |
+| `deployproof check --full-repo` | Audit all tracked files across the entire repository root (respecting `.gitignore`), using isolated parallel workers. |
+| `deployproof check --workers <int>` | Set the number of isolated parallel worker processes for `--full-repo` scans (default: auto-detected CPU count capped at 8). |
 | `deployproof check --wsl` | Delegate mutation testing to `mutmut` inside WSL (Windows only). |
 
 > **Note:** `deployproof check --wsl` (Windows only) is newer and less battle-tested than the core checks — [file an issue](https://github.com/SVSPraveen/DeployProof/issues) if you hit something.
@@ -189,7 +243,7 @@ deployproof check --json
 
 ```json
 {
-  "version": "0.2.1",
+  "version": "1.0.0",
   "status": "passed",
   "summary": {
     "target_files_count": 1,
@@ -270,9 +324,9 @@ deployproof check --json
 - **Control Flow and Error Handling** — AST-based detector for bare `except:` without re-raise, silently swallowed broad exceptions (`except Exception:` that only `pass` or log/print without re-raising or returning error indicators), and dead/unreachable code following unconditional `return`, `raise`, `break`, or `continue`, with an optional `--strict-error-handling` hard gate.
 
 ## What This Doesn't Do
-
+ 
 - **Test-only diffs are not yet caught.** If a diff modifies or weakens assertions in a test file without changing the corresponding source file, DeployProof currently sees zero modified source lines and passes with 0 mutants evaluated. This is a known gap — see [INVESTIGATION_blastradius.md](INVESTIGATION_blastradius.md) for the reverse-mapping approach being evaluated to close it. Until this lands, DeployProof does not protect against test suites being weakened directly.
-- **Not a full-repo audit.** Checks are scoped to files changed in the current session (git diff). Files you haven't touched are not re-evaluated.
+- **Diff-scoping vs Full Audits:** Standard `deployproof check` is intentionally scoped strictly to files modified in the active git diff (for 2–5s speed). To audit every file in the entire repository, explicitly pass the `--full-repo` flag.
 - **Python only.** Mutation testing and import extraction currently support Python files only. Other languages are not scanned.
 - **No auto-fix.** DeployProof reports findings; it does not modify your code, rewrite imports, or suggest patches.
 - **No IDE plugin yet.** There is no VS Code extension or JetBrains plugin. The CLI is the interface. IDE integration is on the roadmap.
@@ -289,8 +343,8 @@ Fixtures cover weak test suites, zero-test orphan modules, planted OpenAI/AWS cr
 
 ## Status & Roadmap
 
-- **Current (v0.2.1):** Diff-scoped AST mutation testing (with recursive `test/`/`tests/` discovery, AST column-offset snippet reconstruction, and `SIGINT`/`SIGTERM`/`SIGBREAK` signal-safe disk restoration), baseline test-collection failure isolation with distinct exit code `2`, entropy-driven value-based secrets scanner (including unquoted .env values and prefix validation), GhostApproval symlink sandbox-escape detector, PyPI dependency hallucination / slopsquatting scanner (with import-to-distribution translation, recursive `-r` requirements scanning, and dynamic import detection via `importlib` / `__import__`), mock-introduction detector (`--strict-mocks`), control-flow / swallowed-exception scanner (`--strict-error-handling`), 11/11 launch-day stress test suite, 94 unit tests, machine-readable `--json` output, and Tier 2 CI verification via GitHub Actions (mutmut).
-- **Next:** Multi-language mutation support and expanded ecosystem rule packs.
+- **Current (v1.0.0):** Diff-scoped AST mutation testing (with recursive discovery and `SIGINT`/`SIGTERM`/`SIGBREAK` signal-safe disk restoration), **Full Repository Audit Mode (`--full-repo`)** with isolated parallel multi-worker sandboxes and AST import-graph test discovery, baseline test-collection failure isolation with distinct exit code `2`, entropy-driven value-based secrets scanner, GhostApproval symlink sandbox-escape detector, PyPI dependency hallucination / slopsquatting scanner (with import-to-distribution translation, recursive `-r` requirements scanning, and dynamic import detection via `importlib` / `__import__`), mock-introduction detector (`--strict-mocks`), control-flow / swallowed-exception scanner (`--strict-error-handling`), 11/11 launch-day stress test suite, **111 unit tests**, live unbuffered progress streaming, and machine-readable `--json` output.
+- **Next:** Reverse test-to-source dependency mapping (see `FUTURE_SCOPE.md`), SARIF 2.1.0 PR annotations, and multi-language mutation rule packs.
 
 ## Contributing
 
@@ -303,3 +357,4 @@ MIT. See [LICENSE](LICENSE).
 ---
 
 *Created by [SVS Praveen](https://github.com/SVSPraveen) · [Portfolio](https://svspraveen.vercel.app/) · [LinkedIn](https://www.linkedin.com/in/svs-praveen-s/)*
+

{deployproof-0.2.1 → deployproof-1.0.0}/README.md

@@ -2,10 +2,10 @@
 
 > Deterministic pre-push verification for AI-assisted codebases: AST mutation testing, credential scanning, sandbox-escape detection, mock-usage alerts, swallowed-exception checks, and dependency hallucination defense.
 
-[![PyPI version](https://img.shields.io/badge/pypi-v0.2.1-007ec6.svg)](https://pypi.org/project/deployproof/)
+[![PyPI version](https://img.shields.io/badge/pypi-v1.0.0-007ec6.svg)](https://pypi.org/project/deployproof/)
 [![Python versions](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-3776ab.svg)](https://pypi.org/project/deployproof/)
 [![CI](https://github.com/SVSPraveen/DeployProof/actions/workflows/ci.yml/badge.svg)](https://github.com/SVSPraveen/DeployProof/actions/workflows/ci.yml)
-[![Tests](https://img.shields.io/badge/tests-94%20passed-2ea44f.svg)](https://github.com/SVSPraveen/DeployProof)
+[![Tests](https://img.shields.io/badge/tests-111%20passed-2ea44f.svg)](https://github.com/SVSPraveen/DeployProof)
 [![Stress Tests](https://img.shields.io/badge/stress%20tests-11%2F11%20passed-2ea44f.svg)](stress_fixtures/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
@@ -15,6 +15,8 @@
 
 AI-assisted development introduces subtle failure modes that standard linters and coverage tools miss: test suites with high line coverage but near-zero mutation scores, hardcoded credentials generated in passing, symlinks that deceive approval prompts into escaping the repository sandbox, silently swallowed exceptions, and package names hallucinated by LLMs that don't exist on PyPI. DeployProof catches these at the pre-push stage, before they reach CI or production.
 
+> **Privacy & Security Guarantee**: DeployProof runs 100% locally on your machine. It makes zero outbound network calls, except for querying the official PyPI registry (JSON API) to verify that newly introduced dependencies exist and are not hallucinated. DeployProof sends no source code, telemetry, test results, or secret findings to any external server.
+
 ## Install
 
 ```bash
@@ -23,20 +25,70 @@ pip install deployproof
 
 Requires Python 3.10+.
 
-## Quickstart
+## How to Use DeployProof
+
+DeployProof provides two distinct modes of operation. We believe in total transparency about execution costs:
 
-Initialize in your repository:
+### 1. Diff-Scoped Pre-Push Gate (`deployproof check`) — *Primary Fast Workflow*
+Evaluates **only the files modified in your active session or git diff** (1–3 files typically). Because only newly edited AST nodes are mutated, it executes in **2 to 5 seconds** in local developer loops, pre-commit hooks, and pre-push gates.
 
 ```bash
-deployproof init
+# Fast daily check: verifies modified files in your current working tree / git diff (2-5s)
+deployproof check
+
+# Output structured JSON for automation or IDE tooling
+deployproof check --json
+
+# Enforce strict gates on newly introduced mocks or swallowed errors
+deployproof check --strict-mocks --strict-error-handling
 ```
 
-Run all verification checks against changes in the current session (git diff):
+### 2. Full Repository Audit Mode (`deployproof check --full-repo`) — *Thorough Codebase Audits*
+Evaluates **every tracked Python file across the entire repository**. Because mutation testing generates hundreds or thousands of mutants and runs the test suite against each one in isolated multi-worker sandboxes, full repository scans take real, honest compute time:
 
 ```bash
-deployproof check
+# Run a full-repository audit across all tracked files
+deployproof check --full-repo
+
+# Customize the parallel worker process count (defaults to auto-detected CPU count capped at 8)
+deployproof check --full-repo --workers 8
+```
+
+#### Real-World Timing Expectations:
+| Scan Mode | Target Scope | Typical Duration | Intended Use Case |
+| :--- | :--- | :--- | :--- |
+| **`deployproof check`** | Git Diff (1–3 modified files) | **2 – 5 seconds** | Local pre-commit, active AI IDE coding loops, pre-push sanity checks. |
+| **`deployproof check --workers 8`** | Large Multi-File Diff (100+ mutants) | **1 – 3 minutes** | Large feature branch reviews, refactors. |
+| **`deployproof check --full-repo`** | Small Repo (< 100 mutants) | **30s – 2 minutes** | Initial repo onboarding, weekly audits. |
+| **`deployproof check --full-repo`** | Medium Repo (200–500 mutants) | **5 – 15 minutes** | Release validation, scheduled CI jobs. |
+| **`deployproof check --full-repo`** | Heavy / Network Lib (`requests`, 800 mutants) | **60 – 85 minutes** | Deep occasional audit sweeps. |
+
+### Parallel Multi-Worker Sandboxing (`--workers N`)
+
+DeployProof includes a built-in multi-process execution engine (`ProcessPoolExecutor`) for parallel mutation testing. You can supply `--workers <N>` to both diff-scoped checks and full-repo audits:
+
+```bash
+# Parallelize a large uncommitted diff across 8 worker processes
+deployproof check --workers 8
+
+# Full repository audit distributed across 8 worker processes
+deployproof check --full-repo --workers 8
 ```
 
+#### How Parallel Sandboxing Works:
+1. **Snapshot Creation**: DeployProof takes an initial atomic snapshot of your project into a clean temporary directory.
+2. **PID-Keyed Sandboxes**: Each worker process receives its own dedicated filesystem sandbox (`worker_<PID>`), with an independent `pytest` cache (`--override-ini=cache_dir=...`) and separate temporary directory (`--basetemp=...`).
+3. **Zero Mutation Leaks**: Mutants are generated and executed inside individual worker sandboxes in parallel. The working tree is untouched, and signal handlers (`SIGINT`, `SIGTERM`, `SIGBREAK`) ensure sandboxes are cleanly purged upon completion or interruption.
+
+#### Advantages & When to Use:
+* **Large Diff / Full Repo Speedup**: Near-linear execution scaling across CPU cores for batches with 50+ mutants, cutting 30-minute sweeps down to 5–8 minutes.
+* **Process & Cache Isolation**: Eliminates cross-test state leakage, shared database locking, and `.pytest_cache` collisions between concurrent workers.
+
+#### Trade-offs & When NOT to Use:
+* **Small Daily Diffs (1–3 files)**: Do NOT use `--workers` for small 2-line edits. Spawning isolated sandboxes and copying file trees incurs ~1–2 seconds of snapshot overhead. Sequential in-place mutation executes in **2–5 seconds** with zero snapshot overhead.
+* **Disk Space & I/O Overhead**: Running $N$ workers copies the repository snapshot $N$ times into temporary storage ($N \times \text{repo size}$ in `tempfile.gettempdir()`). On disk-constrained environments, use fewer workers (e.g. `--workers 2` or `--workers 4`).
+* **Subprocess / Port Collisions**: If your test suite binds to fixed network ports (e.g. localhost:8080) without dynamic port selection, parallel workers running tests concurrently may trigger port conflicts. Use isolated ports or run sequentially in such environments.
+
 Output includes a section for each check — symlink scan, secrets scan, dependency scan, mock detection, control flow analysis, and mutation score — with a pass/fail line at the bottom. 
 
 ### Exit Codes:
@@ -143,6 +195,8 @@ Pre-check clean: 100% of tested basic mutations caught.
 | `deployproof check --files <paths...>` | Explicitly evaluate specific files (bypasses git diff). |
 | `deployproof check --threshold <float>` | Minimum mutation score percentage required to pass (default: `80.0`). |
 | `deployproof check --base <ref>` | Base git ref (branch/commit/tag) to diff against. |
+| `deployproof check --full-repo` | Audit all tracked files across the entire repository root (respecting `.gitignore`), using isolated parallel workers. |
+| `deployproof check --workers <int>` | Set the number of isolated parallel worker processes for `--full-repo` scans (default: auto-detected CPU count capped at 8). |
 | `deployproof check --wsl` | Delegate mutation testing to `mutmut` inside WSL (Windows only). |
 
 > **Note:** `deployproof check --wsl` (Windows only) is newer and less battle-tested than the core checks — [file an issue](https://github.com/SVSPraveen/DeployProof/issues) if you hit something.
@@ -159,7 +213,7 @@ deployproof check --json
 
 ```json
 {
-  "version": "0.2.1",
+  "version": "1.0.0",
   "status": "passed",
   "summary": {
     "target_files_count": 1,
@@ -240,9 +294,9 @@ deployproof check --json
 - **Control Flow and Error Handling** — AST-based detector for bare `except:` without re-raise, silently swallowed broad exceptions (`except Exception:` that only `pass` or log/print without re-raising or returning error indicators), and dead/unreachable code following unconditional `return`, `raise`, `break`, or `continue`, with an optional `--strict-error-handling` hard gate.
 
 ## What This Doesn't Do
-
+ 
 - **Test-only diffs are not yet caught.** If a diff modifies or weakens assertions in a test file without changing the corresponding source file, DeployProof currently sees zero modified source lines and passes with 0 mutants evaluated. This is a known gap — see [INVESTIGATION_blastradius.md](INVESTIGATION_blastradius.md) for the reverse-mapping approach being evaluated to close it. Until this lands, DeployProof does not protect against test suites being weakened directly.
-- **Not a full-repo audit.** Checks are scoped to files changed in the current session (git diff). Files you haven't touched are not re-evaluated.
+- **Diff-scoping vs Full Audits:** Standard `deployproof check` is intentionally scoped strictly to files modified in the active git diff (for 2–5s speed). To audit every file in the entire repository, explicitly pass the `--full-repo` flag.
 - **Python only.** Mutation testing and import extraction currently support Python files only. Other languages are not scanned.
 - **No auto-fix.** DeployProof reports findings; it does not modify your code, rewrite imports, or suggest patches.
 - **No IDE plugin yet.** There is no VS Code extension or JetBrains plugin. The CLI is the interface. IDE integration is on the roadmap.
@@ -259,8 +313,8 @@ Fixtures cover weak test suites, zero-test orphan modules, planted OpenAI/AWS cr
 
 ## Status & Roadmap
 
-- **Current (v0.2.1):** Diff-scoped AST mutation testing (with recursive `test/`/`tests/` discovery, AST column-offset snippet reconstruction, and `SIGINT`/`SIGTERM`/`SIGBREAK` signal-safe disk restoration), baseline test-collection failure isolation with distinct exit code `2`, entropy-driven value-based secrets scanner (including unquoted .env values and prefix validation), GhostApproval symlink sandbox-escape detector, PyPI dependency hallucination / slopsquatting scanner (with import-to-distribution translation, recursive `-r` requirements scanning, and dynamic import detection via `importlib` / `__import__`), mock-introduction detector (`--strict-mocks`), control-flow / swallowed-exception scanner (`--strict-error-handling`), 11/11 launch-day stress test suite, 94 unit tests, machine-readable `--json` output, and Tier 2 CI verification via GitHub Actions (mutmut).
-- **Next:** Multi-language mutation support and expanded ecosystem rule packs.
+- **Current (v1.0.0):** Diff-scoped AST mutation testing (with recursive discovery and `SIGINT`/`SIGTERM`/`SIGBREAK` signal-safe disk restoration), **Full Repository Audit Mode (`--full-repo`)** with isolated parallel multi-worker sandboxes and AST import-graph test discovery, baseline test-collection failure isolation with distinct exit code `2`, entropy-driven value-based secrets scanner, GhostApproval symlink sandbox-escape detector, PyPI dependency hallucination / slopsquatting scanner (with import-to-distribution translation, recursive `-r` requirements scanning, and dynamic import detection via `importlib` / `__import__`), mock-introduction detector (`--strict-mocks`), control-flow / swallowed-exception scanner (`--strict-error-handling`), 11/11 launch-day stress test suite, **111 unit tests**, live unbuffered progress streaming, and machine-readable `--json` output.
+- **Next:** Reverse test-to-source dependency mapping (see `FUTURE_SCOPE.md`), SARIF 2.1.0 PR annotations, and multi-language mutation rule packs.
 
 ## Contributing
 
@@ -273,3 +327,4 @@ MIT. See [LICENSE](LICENSE).
 ---
 
 *Created by [SVS Praveen](https://github.com/SVSPraveen) · [Portfolio](https://svspraveen.vercel.app/) · [LinkedIn](https://www.linkedin.com/in/svs-praveen-s/)*
+

{deployproof-0.2.1 → deployproof-1.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deployproof"
-version = "0.2.1"
+version = "1.0.0"
 description = "A deterministic AI-code deployability checker that catches what coverage misses."
 readme = "README.md"
 requires-python = ">=3.10"

{deployproof-0.2.1 → deployproof-1.0.0}/src/deployproof/__init__.py

@@ -1,2 +1,2 @@
 """DeployProof - Deterministic AI-Code Deployability Checker."""
-__version__ = "0.2.1"
+__version__ = "1.0.0"

{deployproof-0.2.1 → deployproof-1.0.0}/src/deployproof/cli.py

@@ -6,9 +6,9 @@ from typing import List, Optional
 from deployproof import __version__
 from deployproof.dependencies import extract_all_new_dependencies, scan_dependencies
 from deployproof.control_flow import scan_session_files_for_control_flow
-from deployproof.diff import DiffScopeError, InvalidBaseRefError, NotAGitRepositoryError, get_git_root, is_test_file, resolve_changed_python_files, resolve_changed_session_files
+from deployproof.diff import DiffScopeError, InvalidBaseRefError, NotAGitRepositoryError, get_git_root, is_excluded_mutation_target, is_test_file, resolve_changed_python_files, resolve_changed_session_files, resolve_full_repo_session_files
 from deployproof.mocks import scan_session_files_for_mocks
-from deployproof.mutator import run_mutation_tests
+from deployproof.mutator import cleanup_stale_deployproof_temp_dirs, run_mutation_tests
 from deployproof.reporter import LARGE_FILE_LOC_THRESHOLD, format_json_report, format_report
 from deployproof.secrets import scan_session_files_for_secrets
 from deployproof.symlinks import scan_session_files_for_symlinks
@@ -20,6 +20,8 @@ def create_parser() -> argparse.ArgumentParser:
     parser.add_argument('-v', '--version', action='version', version=f'%(prog)s {__version__}', help="Show program's version number and exit.")
     subparsers = parser.add_subparsers(dest='command', help='Available commands')
     check_parser = subparsers.add_parser('check', help='Run deployability verification checks against session changes.')
+    check_parser.add_argument('--full-repo', action='store_true', default=False, help='Scan all files in repository respecting .gitignore instead of diff-scoped session files.')
+    check_parser.add_argument('--workers', type=int, default=None, help='Number of parallel worker processes for --full-repo scan (default: auto, up to 8).')
     check_parser.add_argument('--base', type=str, default=None, help='Base git ref (branch/commit/tag) to diff against.')
     check_parser.add_argument('--files', nargs='+', type=str, default=None, help='Explicit files to evaluate (bypasses git diff).')
     check_parser.add_argument('--tests', nargs='+', type=str, default=None, help='Specific test file(s) or directories to execute.')
@@ -34,8 +36,10 @@ def create_parser() -> argparse.ArgumentParser:
 
 def handle_check(args: argparse.Namespace) -> int:
     """Handle the 'check' subcommand."""
+    cleanup_stale_deployproof_temp_dirs()
     cwd = Path.cwd().resolve()
     repo_root: Optional[Path] = None
+    is_full_repo = getattr(args, 'full_repo', False)
     try:
         if args.files:
             session_files = [Path(f).resolve() for f in args.files]
@@ -46,6 +50,14 @@ def handle_check(args: argparse.Namespace) -> int:
                     repo_root = session_files[0].parent
             else:
                 repo_root = cwd
+        elif is_full_repo:
+            try:
+                repo_root = get_git_root(cwd)
+            except DiffScopeError:
+                repo_root = cwd
+            if not getattr(args, 'json', False):
+                print('Notice: Full repo scan active — evaluating all repository files (this may take significantly longer than a diff-scoped check).\n')
+            session_files = resolve_full_repo_session_files(cwd=cwd)
         else:
             repo_root = get_git_root(cwd)
             session_files = resolve_changed_session_files(cwd=cwd, base=args.base)
@@ -69,20 +81,20 @@ def handle_check(args: argparse.Namespace) -> int:
             return 0
     symlink_result = scan_session_files_for_symlinks(session_files, repo_root=repo_root or cwd)
     secrets_result = scan_session_files_for_secrets(session_files)
-    extracted_deps = extract_all_new_dependencies(session_files, root=repo_root or cwd, base=args.base)
+    extracted_deps = extract_all_new_dependencies(session_files, root=repo_root or cwd, base=args.base, full_repo=is_full_repo)
     dependency_result = scan_dependencies(extracted_deps)
-    mock_result = scan_session_files_for_mocks(session_files=session_files, root=repo_root or cwd, base=args.base)
-    control_flow_result = scan_session_files_for_control_flow(session_files=session_files, root=repo_root or cwd, base=args.base)
+    mock_result = scan_session_files_for_mocks(session_files=session_files, root=repo_root or cwd, base=args.base, full_repo=is_full_repo)
+    control_flow_result = scan_session_files_for_control_flow(session_files=session_files, root=repo_root or cwd, base=args.base, full_repo=is_full_repo)
     if args.files:
-        non_test_files = [f for f in session_files if f.is_file() and f.suffix == '.py' and (not is_test_file(f))]
-        target_files = non_test_files if non_test_files else [f for f in session_files if f.is_file() and f.suffix == '.py']
+        non_excluded_files = [f for f in session_files if f.is_file() and f.suffix == '.py' and (not is_excluded_mutation_target(f, repo_root or cwd))]
+        target_files = non_excluded_files if non_excluded_files else [f for f in session_files if f.is_file() and f.suffix == '.py']
     else:
-        target_files = [f for f in session_files if f.is_file() and f.suffix == '.py' and (not is_test_file(f))]
+        target_files = [f for f in session_files if f.is_file() and f.suffix == '.py' and (not is_excluded_mutation_target(f, repo_root or cwd))]
     if not getattr(args, 'json', False):
         for f in target_files:
             try:
                 loc = len(f.read_text(encoding='utf-8', errors='replace').splitlines())
-                if loc < LARGE_FILE_LOC_THRESHOLD:
+                if loc >= LARGE_FILE_LOC_THRESHOLD:
                     try:
                         rel = f.relative_to(repo_root or cwd)
                     except ValueError:
@@ -107,7 +119,7 @@ def handle_check(args: argparse.Namespace) -> int:
         elif not getattr(args, 'json', False):
             print(wsl_msg)
             print('-' * 68)
-    result = run_mutation_tests(target_files=target_files, repo_root=repo_root or cwd, test_runner_timeout=args.timeout, extra_pytest_args=args.tests)
+    result = run_mutation_tests(target_files=target_files, repo_root=repo_root or cwd, test_runner_timeout=args.timeout, extra_pytest_args=args.tests, workers=getattr(args, 'workers', None), is_full_repo=is_full_repo, base=args.base, quiet=getattr(args, 'json', False))
     if getattr(args, 'json', False):
         report_text = format_json_report(result=result, target_files=target_files, secrets_result=secrets_result, symlink_result=symlink_result, dependency_result=dependency_result, mock_result=mock_result, control_flow_result=control_flow_result, strict_mocks=getattr(args, 'strict_mocks', False), strict_error_handling=getattr(args, 'strict_error_handling', False), repo_root=repo_root or cwd, threshold=args.threshold, version=__version__)
     else:
@@ -157,12 +169,12 @@ def main(argv: Optional[List[str]]=None) -> int:
     """Entry point for the DeployProof CLI."""
     if hasattr(sys.stdout, 'reconfigure'):
         try:
-            sys.stdout.reconfigure(errors='replace')
+            sys.stdout.reconfigure(line_buffering=True, errors='replace')
         except Exception:
             pass
     if hasattr(sys.stderr, 'reconfigure'):
         try:
-            sys.stderr.reconfigure(errors='replace')
+            sys.stderr.reconfigure(line_buffering=False, errors='replace')
         except Exception:
             pass
     parser = create_parser()

{deployproof-0.2.1 → deployproof-1.0.0}/src/deployproof/control_flow.py

@@ -216,6 +216,7 @@ def scan_file_for_control_flow(
     file_path: Path,
     root: Path,
     base: Optional[str] = None,
+    full_repo: bool = False,
 ) -> List[ControlFlowFinding]:
     """Scan a Python file for bare excepts, swallowed exceptions, and unreachable code."""
     if not file_path.is_file() or file_path.suffix != ".py":
@@ -227,7 +228,10 @@ def scan_file_for_control_flow(
     except Exception:
         return []
 
-    modified_lines = get_modified_line_ranges(file_path=file_path, root=root, base=base)
+    if full_repo:
+        modified_lines = None
+    else:
+        modified_lines = get_modified_line_ranges(file_path=file_path, root=root, base=base)
     source_lines = source_code.splitlines()
 
     scanner = ControlFlowScanner(
@@ -243,6 +247,7 @@ def scan_session_files_for_control_flow(
     session_files: List[Path],
     root: Path,
     base: Optional[str] = None,
+    full_repo: bool = False,
 ) -> ControlFlowScanSummary:
     """Scan all modified session Python files for control flow and error handling issues."""
     all_findings: List[ControlFlowFinding] = []
@@ -251,7 +256,7 @@ def scan_session_files_for_control_flow(
     for f in session_files:
         if f.is_file() and f.suffix == ".py":
             scanned_files.append(f)
-            findings = scan_file_for_control_flow(file_path=f, root=root, base=base)
+            findings = scan_file_for_control_flow(file_path=f, root=root, base=base, full_repo=full_repo)
             all_findings.extend(findings)
 
     return ControlFlowScanSummary(

deployproof-1.0.0/src/deployproof/coverage_plugin.py

@@ -0,0 +1,14 @@
+"""Pytest plugin for DeployProof coverage-guided test selection.
+
+Switches coverage context to the current test nodeid during pytest execution,
+allowing DeployProof to map each source line to the exact test cases covering it.
+"""
+try:
+    import coverage
+
+    def pytest_runtest_protocol(item, nextitem):
+        cov = coverage.Coverage.current()
+        if cov is not None:
+            cov.switch_context(item.nodeid)
+except ImportError:
+    pass

{deployproof-0.2.1 → deployproof-1.0.0}/src/deployproof/dependencies.py

@@ -229,6 +229,70 @@ STDLIB_MODULES: Set[str] = set(getattr(sys, "stdlib_module_names", set())) | {
     "zoneinfo",
 }
 
+# Legacy Python 2 standard library modules (for compatibility shims and backports)
+LEGACY_STDLIB_MODULES: Set[str] = {
+    "BaseHTTPServer",
+    "Bastion",
+    "CGIHTTPServer",
+    "ConfigParser",
+    "Cookie",
+    "DocXMLRPCServer",
+    "HTMLParser",
+    "MimeWriter",
+    "Queue",
+    "SimpleHTTPServer",
+    "SimpleXMLRPCServer",
+    "SocketServer",
+    "StringIO",
+    "UserDict",
+    "UserList",
+    "UserString",
+    "al",
+    "anydbm",
+    "cPickle",
+    "cStringIO",
+    "cd",
+    "commands",
+    "cookielib",
+    "copy_reg",
+    "dbhash",
+    "dumbdbm",
+    "dummy_thread",
+    "dummy_threading",
+    "fl",
+    "fm",
+    "fpformat",
+    "gdbm",
+    "gl",
+    "hotshot",
+    "htmlentitydefs",
+    "htmllib",
+    "httplib",
+    "imgfile",
+    "jpeg",
+    "md5",
+    "mimetools",
+    "mimify",
+    "mutex",
+    "new",
+    "posixfile",
+    "repr",
+    "rfc822",
+    "rotor",
+    "sets",
+    "sha",
+    "statvfs",
+    "sunaudio",
+    "sv",
+    "thread",
+    "urllib2",
+    "urlparse",
+    "whichdb",
+    "xmlrpclib",
+}
+
+STDLIB_MODULES = STDLIB_MODULES | LEGACY_STDLIB_MODULES
+
 # Mapping of common top-level Python import names to their PyPI distribution package names
 IMPORT_TO_PYPI_MAP: Dict[str, str] = {
     "yaml": "PyYAML",
@@ -500,6 +564,7 @@ def extract_new_imports_from_py_file(
     root: Path,
     local_modules: Set[str],
     base: Optional[str] = None,
+    full_repo: bool = False,
 ) -> List[ExtractedDependency]:
     """
     Extract newly added external imports from a modified or new Python file.
@@ -515,7 +580,7 @@ def extract_new_imports_from_py_file(
     except Exception:
         return []
 
-    added_linenos = get_added_linenos_for_file(file_path, root, base=base)
+    added_linenos = None if full_repo else get_added_linenos_for_file(file_path, root, base=base)
     extracted: List[ExtractedDependency] = []
     seen: Set[str] = set()
 
@@ -778,6 +843,7 @@ def extract_new_manifest_dependencies(
     root: Path,
     local_modules: Optional[Set[str]] = None,
     base: Optional[str] = None,
+    full_repo: bool = False,
 ) -> List[ExtractedDependency]:
     """
     Extract external dependencies from modified manifest files (requirements.txt, pyproject.toml, etc.).
@@ -794,7 +860,7 @@ def extract_new_manifest_dependencies(
     if not (is_requirements or is_pyproject or is_setup_py or is_setup_cfg):
         return []
 
-    added_linenos = get_added_linenos_for_file(file_path, root, base=base)
+    added_linenos = None if full_repo else get_added_linenos_for_file(file_path, root, base=base)
 
     if is_requirements:
         return _parse_requirements_file(
@@ -892,9 +958,10 @@ def extract_all_new_dependencies(
     session_files: List[Path],
     root: Path,
     base: Optional[str] = None,
+    full_repo: bool = False,
 ) -> List[ExtractedDependency]:
     """
-    Extract all newly added external dependencies from modified Python files and manifests in session.
+    Extract all external dependencies from Python files and manifests.
     """
     local_modules = get_local_module_names(root)
     all_deps: List[ExtractedDependency] = []
@@ -902,14 +969,14 @@ def extract_all_new_dependencies(
 
     for p in session_files:
         if p.suffix == ".py":
-            py_deps = extract_new_imports_from_py_file(p, root, local_modules=local_modules, base=base)
+            py_deps = extract_new_imports_from_py_file(p, root, local_modules=local_modules, base=base, full_repo=full_repo)
             for d in py_deps:
                 key = f"{d.name}:{d.source_file}:{d.lineno}"
                 if key not in seen_unique:
                     seen_unique.add(key)
                     all_deps.append(d)
         else:
-            manifest_deps = extract_new_manifest_dependencies(p, root, local_modules=local_modules, base=base)
+            manifest_deps = extract_new_manifest_dependencies(p, root, local_modules=local_modules, base=base, full_repo=full_repo)
             for d in manifest_deps:
                 key = f"{d.name}:{d.source_file}:{d.lineno}"
                 if key not in seen_unique:
@@ -983,7 +1050,7 @@ def query_pypi_registry(
     url = f"https://pypi.org/pypi/{canonical_pkg}/json"
     req = urllib.request.Request(
         url,
-        headers={"User-Agent": "DeployProof/0.2.1 (https://github.com/SVSPraveen/DeployProof)"},
+        headers={"User-Agent": "DeployProof/1.0.0 (https://github.com/SVSPraveen/DeployProof)"},
     )
 
     try: