deploy-guard-engine 0.1.1__tar.gz → 0.1.2__tar.gz

deploy_guard_engine-0.1.2/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: deploy-guard-engine
+Version: 0.1.2
+Summary: Static root-cause analysis for a Python stack trace - offline, no account. Plus a deployment-gate scanner.
+Author: sai55387
+License: MIT
+Project-URL: Homepage, https://github.com/Dineshsai7/deploy-guard-engine
+Project-URL: Issues, https://github.com/Dineshsai7/deploy-guard-engine/issues
+Project-URL: Changelog, https://github.com/Dineshsai7/deploy-guard-engine/blob/main/CHANGELOG.md
+Keywords: traceback,stacktrace,root-cause,debugging,static-analysis,control-flow,nullability,deployment,ci,incident
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# deploy-guard-engine
+
+This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access.

deploy_guard_engine-0.1.2/README.md

@@ -0,0 +1,3 @@
+# deploy-guard-engine
+
+This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access.

{deploy_guard_engine-0.1.1 → deploy_guard_engine-0.1.2}/pyproject.toml

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
 
 [project]
 name = "deploy-guard-engine"
-version = "0.1.1"
+version = "0.1.2"
 description = "Static root-cause analysis for a Python stack trace - offline, no account. Plus a deployment-gate scanner."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -36,16 +36,19 @@ dependencies = []
 dev = ["pytest>=7.0", "pytest-cov", "ruff", "build", "twine"]
 
 [project.urls]
-Homepage = "https://github.com/sai55387/deploy-guard"
-Issues = "https://github.com/sai55387/deploy-guard/issues"
-Changelog = "https://github.com/sai55387/deploy-guard/blob/main/CHANGELOG.md"
+Homepage = "https://github.com/Dineshsai7/deploy-guard-engine"
+Issues = "https://github.com/Dineshsai7/deploy-guard-engine/issues"
+Changelog = "https://github.com/Dineshsai7/deploy-guard-engine/blob/main/CHANGELOG.md"
 
 [project.scripts]
 deploy-guard = "deploy_guard.cli:main"
 dg = "deploy_guard.cli:main"
 
-[tool.hatch.build.targets.wheel]
-packages = ["src/deploy_guard"]
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-dir]
+"" = "src"
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]

deploy_guard_engine-0.1.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

deploy_guard_engine-0.1.2/src/deploy_guard/__init__.py

@@ -0,0 +1,3 @@
+"""Placeholder public build - see README."""
+
+__version__ = "0.1.2"

deploy_guard_engine-0.1.2/src/deploy_guard/__main__.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/analysis/__init__.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/analysis/callgraph.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/analysis/context.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/analysis/findings.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/analysis/nullability.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/analysis/paths.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/cli.py

@@ -0,0 +1,43 @@
+"""``deploy-guard`` command-line interface (placeholder public build - see README).
+"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+
+from deploy_guard import __version__
+
+_NOTICE = 'This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access.'
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="deploy-guard", description=__doc__)
+    parser.add_argument("--version", action="version", version=f"deploy-guard {__version__}")
+    sub = parser.add_subparsers(dest="command")
+    for name, help_ in (
+        ("scan", "analyse and report (never fails the build)"),
+        ("check", "deployment gate - exit non-zero on blockers"),
+        ("explain", "explain a pasted traceback using the project's analysis"),
+        ("version", "print version"),
+    ):
+        p = sub.add_parser(name, help=help_)
+        p.add_argument("path", nargs="?", default=".")
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    if args.command == "version" or args.command is None:
+        print(f"deploy-guard {__version__}")
+        if args.command is None:
+            print(_NOTICE, file=sys.stderr)
+            return 2
+        return 0
+    print(_NOTICE, file=sys.stderr)
+    return 3
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

deploy_guard_engine-0.1.2/src/deploy_guard/config.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/engine.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/explain/__init__.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/explain/explainer.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/explain/render.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/explain/traceback_parse.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/frontend/__init__.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/frontend/python_cfg.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/frontend/python_frontend.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/generators/__init__.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/generators/base.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/generators/import_smoke.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/ingest/__init__.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/ingest/discover.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/ir/__init__.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/ir/cfg.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/ir/model.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/report/__init__.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/report/render.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard/store.py

@@ -0,0 +1 @@
+"""Placeholder public build - see README. This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access."""

deploy_guard_engine-0.1.2/src/deploy_guard_engine.egg-info/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: deploy-guard-engine
+Version: 0.1.2
+Summary: Static root-cause analysis for a Python stack trace - offline, no account. Plus a deployment-gate scanner.
+Author: sai55387
+License: MIT
+Project-URL: Homepage, https://github.com/Dineshsai7/deploy-guard-engine
+Project-URL: Issues, https://github.com/Dineshsai7/deploy-guard-engine/issues
+Project-URL: Changelog, https://github.com/Dineshsai7/deploy-guard-engine/blob/main/CHANGELOG.md
+Keywords: traceback,stacktrace,root-cause,debugging,static-analysis,control-flow,nullability,deployment,ci,incident
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# deploy-guard-engine
+
+This published build of deploy-guard-engine is a placeholder - it reserves the package name but contains no analysis logic. The working tool is distributed privately; contact the maintainer for access.

deploy_guard_engine-0.1.2/src/deploy_guard_engine.egg-info/SOURCES.txt

@@ -0,0 +1,39 @@
+LICENSE
+README.md
+pyproject.toml
+src/deploy_guard/__init__.py
+src/deploy_guard/__main__.py
+src/deploy_guard/cli.py
+src/deploy_guard/config.py
+src/deploy_guard/engine.py
+src/deploy_guard/py.typed
+src/deploy_guard/store.py
+src/deploy_guard/analysis/__init__.py
+src/deploy_guard/analysis/callgraph.py
+src/deploy_guard/analysis/context.py
+src/deploy_guard/analysis/findings.py
+src/deploy_guard/analysis/nullability.py
+src/deploy_guard/analysis/paths.py
+src/deploy_guard/explain/__init__.py
+src/deploy_guard/explain/explainer.py
+src/deploy_guard/explain/render.py
+src/deploy_guard/explain/traceback_parse.py
+src/deploy_guard/frontend/__init__.py
+src/deploy_guard/frontend/python_cfg.py
+src/deploy_guard/frontend/python_frontend.py
+src/deploy_guard/generators/__init__.py
+src/deploy_guard/generators/base.py
+src/deploy_guard/generators/import_smoke.py
+src/deploy_guard/ingest/__init__.py
+src/deploy_guard/ingest/discover.py
+src/deploy_guard/ir/__init__.py
+src/deploy_guard/ir/cfg.py
+src/deploy_guard/ir/model.py
+src/deploy_guard/report/__init__.py
+src/deploy_guard/report/render.py
+src/deploy_guard_engine.egg-info/PKG-INFO
+src/deploy_guard_engine.egg-info/SOURCES.txt
+src/deploy_guard_engine.egg-info/dependency_links.txt
+src/deploy_guard_engine.egg-info/entry_points.txt
+src/deploy_guard_engine.egg-info/requires.txt
+src/deploy_guard_engine.egg-info/top_level.txt

deploy_guard_engine-0.1.2/src/deploy_guard_engine.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

deploy_guard_engine-0.1.2/src/deploy_guard_engine.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+deploy-guard = deploy_guard.cli:main
+dg = deploy_guard.cli:main

deploy_guard_engine-0.1.2/src/deploy_guard_engine.egg-info/requires.txt

@@ -0,0 +1,7 @@
+
+[dev]
+pytest>=7.0
+pytest-cov
+ruff
+build
+twine

deploy_guard_engine-0.1.2/src/deploy_guard_engine.egg-info/top_level.txt

@@ -0,0 +1 @@
+deploy_guard

deploy_guard_engine-0.1.1/.github/workflows/ci.yml

@@ -1,37 +0,0 @@
-name: ci
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-      - run: python -m pip install --upgrade pip
-      - run: pip install -e ".[dev]"
-      - run: ruff check src
-      - run: pytest -q
-
-  build:
-    runs-on: ubuntu-latest
-    needs: test
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-      - run: pip install build
-      - run: python -m build
-      - uses: actions/upload-artifact@v4
-        with:
-          name: dist
-          path: dist/

deploy_guard_engine-0.1.1/.github/workflows/publish.yml

@@ -1,24 +0,0 @@
-name: publish
-
-# Publishes to PyPI on a tagged release using Trusted Publishing (OIDC) -
-# no API token needed. Configure the publisher at
-# https://pypi.org/manage/project/deploy-guard/settings/publishing/
-
-on:
-  release:
-    types: [published]
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    environment: pypi
-    permissions:
-      id-token: write
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-      - run: pip install build
-      - run: python -m build
-      - uses: pypa/gh-action-pypi-publish@release/v1

deploy_guard_engine-0.1.1/.gitignore

@@ -1,19 +0,0 @@
-__pycache__/
-*.py[cod]
-*.egg-info/
-.eggs/
-build/
-dist/
-.venv/
-venv/
-deploy_guard_env/
-deployguard_env/
-.pytest_cache/
-.mypy_cache/
-.ruff_cache/
-.coverage
-htmlcov/
-.idea/
-.vscode/
-.deploy-guard/cache/
-.deploy-guard/*.log

deploy_guard_engine-0.1.1/CHANGELOG.md

@@ -1,52 +0,0 @@
-# Changelog
-
-All notable changes to this project are documented here.
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
-
-## [0.1.0] - 2026-09-01
-
-First public release. Reworked from an internal prototype ("deployguard").
-
-### Added
-- **Interprocedural call graph** (`deploy_guard.analysis.callgraph`) - best-effort
-  resolution of intra-project calls by qualified name, bare name, and
-  `Class.method` suffix.
-- **Caller-aware `inconsistent-return`** - a value/None function is only `review`
-  when an in-project caller dereferences or returns the result without a guard;
-  otherwise it drops to a `note`. Kills the copy-pasted-helper false-positive
-  flood.
-- **Interprocedural nullability** - a call that resolves to a project function
-  which can return `None` now makes the result nullable, so
-  `x = compute(); x.attr` is flagged when `compute()` is a local function.
-- **`explain` walks the whole call chain** - every project frame in the
-  traceback is analysed, not just the deepest.
-- **Configuration file** - `[tool.deploy-guard]` in the scanned project's
-  `pyproject.toml` (Python 3.11+ for TOML reading). CLI flags override.
-- Packaging: `LICENSE` (MIT), trove classifiers, `dg` short alias, this
-  changelog, a standalone single-file build.
-
-### Changed
-- Renamed distribution to **`deploy-guard`** (import package `deploy_guard`);
-  `deployguard` was already taken on PyPI.
-- README leads with `explain`; `scan` is positioned as a supporting gate, with
-  a pointer to ruff + mypy for general linting.
-
-### Carried over from the prototype
-- Python frontend, CFG builder (`if`/`while`/`for`/`with`/`try`/`match` + async),
-  path enumeration -> behavior spec.
-- Flow-sensitive nullability with `is None` / truthiness / `isinstance` guards,
-  early-return guards, short-circuit narrowing in `and`/`or`/ternary, `.get()`
-  and `re.match/search` sources, `Optional[...]` params.
-- Findings: `none-dereference`, `swallowed-exception`, `unreachable-code`,
-  `bare-except`, `mutable-default-arg`, `invalid-escape`, `path-explosion`.
-- Import-smoke test generator.
-- `explain` traceback parser with dedicated handlers for AttributeError,
-  TypeError, KeyError, IndexError, ZeroDivisionError, UnboundLocalError,
-  NameError, ValueError; the "checks in the wrong order" special case.
-- Text / Markdown / JSON output, duplicate-finding collapse, `--disable`.
-
-### Known limitations
-- Python only (a Java frontend would reuse the analysis unchanged).
-- Call resolution is name-based, not full import resolution - ambiguous names
-  stay unresolved.
-- No Z3-backed concrete repro inputs yet.

deploy_guard_engine-0.1.1/PKG-INFO

@@ -1,175 +0,0 @@
-Metadata-Version: 2.5
-Name: deploy-guard-engine
-Version: 0.1.1
-Summary: Static root-cause analysis for a Python stack trace - offline, no account. Plus a deployment-gate scanner.
-Project-URL: Homepage, https://github.com/sai55387/deploy-guard
-Project-URL: Issues, https://github.com/sai55387/deploy-guard/issues
-Project-URL: Changelog, https://github.com/sai55387/deploy-guard/blob/main/CHANGELOG.md
-Author: sai55387
-License: MIT
-License-File: LICENSE
-Keywords: ci,control-flow,debugging,deployment,incident,nullability,root-cause,stacktrace,static-analysis,traceback
-Classifier: Development Status :: 3 - Alpha
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development :: Debuggers
-Classifier: Topic :: Software Development :: Quality Assurance
-Classifier: Topic :: Software Development :: Testing
-Requires-Python: >=3.10
-Provides-Extra: dev
-Requires-Dist: build; extra == 'dev'
-Requires-Dist: pytest-cov; extra == 'dev'
-Requires-Dist: pytest>=7.0; extra == 'dev'
-Requires-Dist: ruff; extra == 'dev'
-Requires-Dist: twine; extra == 'dev'
-Description-Content-Type: text/markdown
-
-# deploy-guard
-
-**Static root-cause analysis for a Python stack trace.** Paste a traceback,
-point it at the repo, and get: which variable is `None` and *why*, the branch
-path that reached the crash, where the bad value entered across the call
-chain, and a concrete fix. Fully local — no server, no account, no
-network. Zero dependencies. Python 3.10+.
-
-It also ships a deployment-gate scanner (`scan` / `check`), but for
-general-purpose linting you should run **[ruff](https://docs.astral.sh/ruff/)
-+ [mypy](https://mypy-lang.org/)** — they are faster and deeper. What
-deploy-guard does that they don't is turn *a traceback you already have* into
-an explanation grounded in your code.
-
-## Install
-
-```bash
-pip install deploy-guard-engine   # or: pipx install deploy-guard-engine
-```
-
-Or run it with no install at all — a single ~120 KB file:
-
-```bash
-./scripts/build-standalone.sh     # -> dist/deploy-guard.pyz
-python deploy-guard.pyz explain --project ./service < traceback.txt
-```
-
-## Explain a traceback
-
-```bash
-deploy-guard explain --project ./service --file traceback.txt
-# or pipe it
-deploy-guard explain --project ./service < traceback.txt
-```
-
-```
-Explaining:  AttributeError: 'NoneType' object has no attribute 'empty'
-
-Crash site:  project_folder/file_name.py:231 — create_json
-
-231 | if _df.empty or _df is None:
-
-Why:
-
-_df can be None because the default value passed to .get() is None.
-
-It reaches this line when processing report_dict.
-
-Although the condition checks _df is None, Python evaluates the or expression from left to right.
-
-Therefore, _df.empty is evaluated first. If _df is None, this raises an AttributeError before the None check is reached.
-
-Call chain (from the traceback):
-
-project_file:164 function_name
-└─ file_locator.py:231 create_json <- exception raised
-
-Scan finding:
-none-dereference (block) at file_locator.py:231
-
-Fix:
-Reorder the condition so _df is None is checked first:
-
-if _df is None or _df.empty:
-
-This ensures _df.empty is only accessed when _df is not None.
-```
-
-Dedicated explanations for `AttributeError` / `TypeError` (None), `KeyError`,
-`IndexError`, `ZeroDivisionError`, `UnboundLocalError`, `NameError`, and
-`int()` / `float()` `ValueError`. Anything else falls back to the call chain
-+ the branch conditions that reach the line. The call chain is analysed
-*interprocedurally* &mdash; each project frame is checked, and a `None` that
-originates in an argument is traced back to the caller that passed it.
-
-## Scan a project
-
-```bash
-deploy-guard scan  ./service                 # report, never fails
-deploy-guard scan  ./service --behavior      # + the when-X-returns-Y table
-deploy-guard check ./service --fail-on review  # gate: exit 1 on findings
-deploy-guard scan  ./service --report report.json
-```
-
-| Rule | Severity | Catches |
-|---|---|---|
-| `none-dereference` | block / review | attr/subscript on a possibly-`None` value (interprocedural: a call to a project function that can return `None` counts) |
-| `inconsistent-return` | review / note | returns a value on some paths, `None` on others &mdash; **review only when an in-project caller uses the result without a guard**, otherwise a note |
-| `swallowed-exception` | review | `except …: pass` |
-| `unreachable-code` | warn | code after an always-diverting branch |
-| `bare-except` | warn | `except:` with no type |
-| `mutable-default-arg` | warn | `def f(x=[])` |
-| `invalid-escape` | note | `"\d"` in a non-raw string |
-| `path-explosion` | note | too-branchy function (detection still complete) |
-
-Notes are collapsed to a one-line count; `--notes` lists them. Identical
-findings from copy-pasted functions fold into one; `--no-collapse` expands.
-
-## Configuration
-
-A `[tool.deploy-guard]` table in the **scanned project's** `pyproject.toml`
-(Python 3.11+ for TOML reading):
-
-```toml
-[tool.deploy-guard]
-disable = ["bare-except"]
-exclude = ["vendor", "migrations"]
-fail-on = "review"
-include-tests = false
-```
-
-CLI flags override the file.
-
-## How it works
-
-```
-discover -> lower to IR -> CFG per function -> call graph
-   -> behavior spec (path conditions -> returns/raises)
-   -> nullability data-flow (merges None facts at every branch join; interprocedural)
-   -> findings   |   explain (traceback -> the above, focused on one failure)
-```
-
-The nullability pass is a forward fixpoint over the CFG &mdash; it merges
-facts at branch joins, so it covers 100% of a function regardless of how
-branchy it is, in roughly linear time.
-
-`scan` and `explain` only **read** your code &mdash; never import or run it.
-
-## Develop
-
-```bash
-pip install -e ".[dev]"
-pytest
-ruff check src
-```
-
-## What changed from the prototype
-
-See [CHANGELOG.md](CHANGELOG.md). Headline: an interprocedural call graph, so
-`explain` traces a `None` across frames and `inconsistent-return` no longer
-fires on copy-pasted helpers whose callers all guard the result; plus real
-packaging and a config file.