gwc-pybundle 2.1.2__py3-none-any.whl

gwc_pybundle-2.1.2.dist-info/RECORD

@@ -0,0 +1,82 @@
+gwc_pybundle-2.1.2.dist-info/licenses/LICENSE.md,sha256=ZmD484KG9hysmSMFT824y7aIc8lhFBnjkN-3DJNjXCc,1108
+pybundle/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pybundle/__main__.py,sha256=MHKZ_ae3fSLGTLUUMOx15fWdeOnJSHhq-zslRP5F5Lc,79
+pybundle/cli.py,sha256=VvEHrWDC1BM_Y8CkJQDaK0Epzo1v5ljOdoG1djKZNdE,19372
+pybundle/context.py,sha256=LBd0QYUuX_fMdWbV06L6v4TZFkAet2o1h9GS1PN8iYY,13357
+pybundle/doctor.py,sha256=6tpEH5_UVKA8Wbi5kKkUoxXMjTGOrEZr3leBd4pU3Lw,4669
+pybundle/filters.py,sha256=98haWs-EzQlaroVdU-rP-c3661GPwi-hmj119OsgtJQ,4675
+pybundle/manifest.py,sha256=LJB1JXg5kH6nKjgzif-sDWoaaqmIEkF3ctlbHqE0EHQ,2289
+pybundle/packaging.py,sha256=CQ394kUmn6sudpy7ExGpmeanfRVEf_xxwrX_swaotFg,1407
+pybundle/policy.py,sha256=PLk2Fs1hBxfn0jAWE3Jcj1jhlUnwfD5ivOFrUScI8Io,3929
+pybundle/profiles.py,sha256=09iy3-1pIsC4KrHZfDsoFLKhaUewkqX6xurTLPcAks8,14247
+pybundle/roadmap_model.py,sha256=rcMwphd3uNiwzAVx_tGTE20GYYFRzyvbCoFcYGRS9aY,991
+pybundle/roadmap_scan.py,sha256=iVJgaTgFjieTNv_NP_hjOFGJYgE8hOdG3UK0NRUtClU,11223
+pybundle/root_detect.py,sha256=d_HdA_usPxK1orc9cnNTY_fZrvdScQnI_f1XvvlHSFA,361
+pybundle/runner.py,sha256=oG4nUIpUVefcho45_gCdEeywMTBZepOjrciXFeERy-g,5548
+pybundle/tools.py,sha256=dLg6m7tW11QC6SoJUzoayYEI-lq_kKuOm2eN2uzqnQo,1926
+pybundle/steps/__init__.py,sha256=3NL5A0Oj4MlTPW7LvdzesrLHMJG98nV-qrcaJuICE4o,394
+pybundle/steps/ai_context.py,sha256=YYp83eKiHrLI2dAFjlk48i3F9n0BZC_NFle43-PzqGE,27346
+pybundle/steps/api_docs.py,sha256=SXDITOHi2mGEcBZISAn_8K9Jex6baaWUHJnRC22GAr8,8278
+pybundle/steps/asyncio_analysis.py,sha256=LYOY8Iwu-2t4dgBpFn5dzLF_iz2nFdEuWOph6FnAcnw,14249
+pybundle/steps/bandit.py,sha256=4gT9JJerhT9W8O6lF_Vwk6iNjYvJqQcihVcF816NzS4,2439
+pybundle/steps/base.py,sha256=9LZwPYlGAWfnIe5DRbfP89ZmMLhbmOm9SQ-vWmQANHA,356
+pybundle/steps/blocking_call_detection.py,sha256=K9HjSKQ69NbE9TfLvNgFaX1WpNwGZgd2oqxNPc8oLDU,10534
+pybundle/steps/call_graph.py,sha256=zUwZD2FHDmbGlf2JsOUaImjIJW7tPZpo-edXPBBRpo0,7764
+pybundle/steps/compileall.py,sha256=uB_eFVq1FSSrdzZvx9hgs4IbNJnrXzPOCjyTfDw0gsc,2446
+pybundle/steps/config_docs.py,sha256=fsJgf1JqaGBztRsrbsh5K827JXltPYRvM_nYOvrhxVw,11542
+pybundle/steps/config_validation.py,sha256=jmJq0uYAwwt0BSBB6f1TEofm2_iKAHrcl01KwehzN3A,10747
+pybundle/steps/container_image.py,sha256=NkvT-GVEAOmvqgH5B0V67zcP-Y-m8Z-t2h7tDXynZRA,9910
+pybundle/steps/context_expand.py,sha256=pG1-59RqQFIdTlMj5CJ65b8Or9qNk8LgudntdT10m7M,7986
+pybundle/steps/copy_pack.py,sha256=_I_hDBLiG9f9ETFzpG59lOFhe7nOasGPRvQb4CunBlE,9778
+pybundle/steps/coverage.py,sha256=HIMuQH8PFPeoo_bPsIhn3U2UHzes5qiQIyJRqRnz0yI,3600
+pybundle/steps/cprofile_step.py,sha256=WLibVdy4jLSSezdEFkLBwcRsSpWIsbLrX1597Iozy-4,5729
+pybundle/steps/dependency_sizes.py,sha256=DVvPXktnrVloGccFZBy3NdYQblnvRQsgmuzqYheU_Xc,5330
+pybundle/steps/django_checks.py,sha256=TMnLRykEWN24Sep2pn4_5vIl4l36Z9HtuTl3lLFeXtU,7190
+pybundle/steps/dockerfile_lint.py,sha256=nZ4zH3qhBedTHwfUdEq-HkocRA7Alu_gdkj0w_5RE4E,9561
+pybundle/steps/dockerignore.py,sha256=HzZfd4O-6H-bZZyHg1OMbMSad5VEQ2qrdJbHRuzDrnU,10887
+pybundle/steps/duplication.py,sha256=ntQzmIYaCYWG0fCo4i5GI4Yx2jH6Td94p6V94L7W9Ug,3838
+pybundle/steps/env_completeness.py,sha256=qu28TMuwuSGuEAirDXgnNUT2-iJIunVMwJFOEYtI32U,9747
+pybundle/steps/env_var_usage.py,sha256=XcmSzkXkQGJYVKn0bkJ2Yi67ITQjDKvQBlKM6ekNhmg,8985
+pybundle/steps/error_refs.py,sha256=mq1DGXREQRudycyPb7H0obkHmv3HvO-QPPbf2zoZDu0,5640
+pybundle/steps/event_loop_patterns.py,sha256=EYHhHnpanPk1AHjudcoeVhPdeihxnVMVx9wwUbjto18,10675
+pybundle/steps/exception_patterns.py,sha256=8dPdnrZ1W2DrVwJvJjCUB1HzUrfhrujKu6K1cLCAegE,6694
+pybundle/steps/fastapi_integration.py,sha256=38JQpjoUWc2zJEQqp99p7ZygBcELNj3xbN7LuVei4_w,8942
+pybundle/steps/flask_debugging.py,sha256=Jrvjvgp7-gV2mfygbh-EYZwhwO8fzLKv_Ob7R1ovNAQ,10797
+pybundle/steps/git_analytics.py,sha256=_N2Fo8NtcNyFepJ6nqaYVdL7tYmVwdnyjh4tYwf73eM,11438
+pybundle/steps/handoff_md.py,sha256=3gl0is27Iumdh-g9pzsYT1KaRPUOeq2BfZ6KhbolT-w,6739
+pybundle/steps/import_time.py,sha256=JwLR3DXrZMhLzhVTJYEYnvOhNXfhpNblsKiUHKRdR-o,6292
+pybundle/steps/interrogate.py,sha256=O-oNOWZ1NXWbNS3bV7-v3fADurl6c7GwyaHgfu7CDIY,3525
+pybundle/steps/license_scan.py,sha256=Bbo1FEokrbSbIzbxAkGo2WWZTEUFeWYOW3y-UMY1EfU,3559
+pybundle/steps/line_profiler.py,sha256=c8vyOiMKXCaU_7qA58wyi7K_8lenRXJF5zPC7g_Lw1g,4164
+pybundle/steps/link_validation.py,sha256=tWYMnFurF4xzS-khSJCpFpAtadgLxLRTIB8eLPHUteU,10266
+pybundle/steps/logging_analysis.py,sha256=S_Srl0FM7QphXRB8B_OEe3ujh6bFIUIyxOAGi0O2-4o,7932
+pybundle/steps/memory_profile.py,sha256=-DiRvEs6vViQCyvzyM-2YeV27aT0X2zxF94Y6aZGHvM,5243
+pybundle/steps/migration_history.py,sha256=5cfgdxeGYU9E108rd1erH4c3dKlM-FBlDlRpRTs6Dz4,12320
+pybundle/steps/mutation_testing.py,sha256=glqLsVOEpdt1phEpYjzdsDbqdefUse8sgFz9migEAAw,5301
+pybundle/steps/mypy.py,sha256=hA-20H-Vv9BI_u0fgstnANXnItoD36dSJ4J5aXTCLKk,3705
+pybundle/steps/orm_optimization.py,sha256=gLKACtOsyy3EiDUzs9lFcZU0ZVk83DXYmtVwKhzIVWA,11560
+pybundle/steps/pip_audit.py,sha256=qNkHeyjzUFJ9SSKU4jTKOsUnWnNYAk_jWcmPlUckkAA,1582
+pybundle/steps/pipdeptree.py,sha256=cD1PppGXQ9dSaZ1PpYI-066JeNqXQThQyJ0kw1etw30,2125
+pybundle/steps/pylance.py,sha256=PiIyyYm8gTVv-dihzRjvD4waZnz31qNOEAjYIlscvSY,15715
+pybundle/steps/pytest.py,sha256=vfr2DI6aYCTit_j9QdV3WtKlOZtLMCCSm2E__3tsZt4,2177
+pybundle/steps/query_pattern_analysis.py,sha256=4oXy4_vyQQ3UrrwakJYu4ExAJc9lT6MiVduFW76-WBw,12608
+pybundle/steps/radon.py,sha256=5zeNienQJoIOCJh3aNMlFjRXzCU8cw6cuqX26bO8nHk,5256
+pybundle/steps/repro_md.py,sha256=EvoNVKaHFelfrv_jfBLpbkORTiDSjah3GgWXW3NvEXY,4856
+pybundle/steps/rg_scans.py,sha256=hcHhzPAJ_MdPthRLcfIzxlkXoQJkDF2bIX2wU1By2gU,2511
+pybundle/steps/roadmap.py,sha256=gFS2Mo9CR1A8wg6xNVP_FnJuT_dm8yWjgRJbtlyN2wk,5213
+pybundle/steps/ruff.py,sha256=Furb9nx0xMkb270jtrZiYdZ5pNB6J4iOvKRtxj82_aE,4057
+pybundle/steps/secrets_detection.py,sha256=SKphNUYDL1a-Ui1BEI8dOPsY8YXDqAENv6f4TEZspB8,8983
+pybundle/steps/security_headers.py,sha256=u1RC-lDfNL7JeUa2yMHYkmiDkDbS83Db7LXFEXpRKKU,11244
+pybundle/steps/shell.py,sha256=vYGu9fZ5gDdZnKSfok95bOTIWu5HNvS23atsY5FwtJE,2529
+pybundle/steps/slow_tests.py,sha256=E21xOcUy85MNp9n4bNuYzAtRxOnbG_gUHoi2Tjs4JHc,6891
+pybundle/steps/sqlalchemy_validation.py,sha256=cgqKI4dx2yNp5Q9uL_q_O26pUUxwCaCi5gCOH8fzKVo,9542
+pybundle/steps/test_flakiness.py,sha256=-OiAtUWFA2xp67RcC5D6jUlnqGN_E_Zw-5yfLET1KuM,7162
+pybundle/steps/tree.py,sha256=tz5Z7clOEuKWMW6wjj2xtEu3pNjEto8dYgHYaoDdM0E,3674
+pybundle/steps/type_coverage.py,sha256=7AF0FLqVifPmj17mEYuGcehpLrYz3-tFv-0e5ZCPxiA,9684
+pybundle/steps/unused_deps.py,sha256=pPGPGY2F6P3cGDl1mR6L1-mYxlJ_xu92GQSaFmJhTkw,8263
+pybundle/steps/vulture.py,sha256=afanCBH3YZ-89HEH8UGd-uJzDnTUO_jKss-6jZQCcE0,6137
+gwc_pybundle-2.1.2.dist-info/METADATA,sha256=zKrvyqzho74sgrlZE8nD2blW1kN_Pmz3NJlHKOpgs-w,26454
+gwc_pybundle-2.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+gwc_pybundle-2.1.2.dist-info/entry_points.txt,sha256=xgXfIvyx9ZI6jd9MscFWNMzQrcX4scTVJ9L7WwksUHg,47
+gwc_pybundle-2.1.2.dist-info/top_level.txt,sha256=N5x3QutDUtHQn3HwkFmH5PeM9uPY-E5wOKUJSE8PBKM,9
+gwc_pybundle-2.1.2.dist-info/RECORD,,

gwc_pybundle-2.1.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

gwc_pybundle-2.1.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pybundle = pybundle.cli:main

gwc_pybundle-2.1.2.dist-info/licenses/LICENSE.md

@@ -0,0 +1,25 @@
+The MIT License (MIT)
+=====================
+
+Copyright © 2025 Jessica Brown
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the “Software”), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

gwc_pybundle-2.1.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+pybundle

pybundle/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

pybundle/cli.py

@@ -0,0 +1,546 @@
+from __future__ import annotations
+
+import argparse
+from pathlib import Path
+import shlex
+
+from .context import BundleContext, RunOptions
+from .profiles import get_profile
+from .root_detect import detect_project_root
+from importlib.metadata import PackageNotFoundError, version as pkg_version
+from .runner import run_profile
+
+
+def get_version() -> str:
+    # 1) Canonical for installed distributions (including editable)
+    try:
+        return pkg_version("gwc-pybundle")
+    except PackageNotFoundError:
+        pass
+
+    # 2) Dev fallback: locate pyproject.toml by walking up from this file
+    try:
+        import tomllib  # py3.11+
+    except Exception:
+        return "unknown"
+
+    here = Path(__file__).resolve()
+    for parent in [here.parent] + list(here.parents):
+        pp = parent / "pyproject.toml"
+        if pp.is_file():
+            try:
+                data = tomllib.loads(pp.read_text(encoding="utf-8"))
+                return data.get("project", {}).get("version", "unknown")
+            except Exception:
+                return "unknown"
+
+    return "unknown"
+
+
+def add_common_args(sp: argparse.ArgumentParser) -> None:
+    sp.add_argument(
+        "--project-root",
+        type=Path,
+        default=None,
+        help="Explicit project root (skip auto-detect)",
+    )
+    sp.add_argument(
+        "--outdir",
+        type=Path,
+        default=None,
+        help="Output directory (default: <root>/artifacts)",
+    )
+    sp.add_argument("--name", default=None, help="Override archive name prefix")
+    sp.add_argument(
+        "--strict", action="store_true", help="Fail non-zero if any step fails"
+    )
+    sp.add_argument(
+        "--redact",
+        action=argparse.BooleanOptionalAction,
+        default=True,
+        help="Redact secrets in logs/text",
+    )
+    sp.add_argument(
+        "--json",
+        action="store_true",
+        help="Emit machine-readable JSON to stdout.",
+    )
+
+
+def _resolve_profile_defaults(profile: str, o: RunOptions) -> RunOptions:
+    if profile == "ai":
+        # AI defaults: skip slow/flake-prone tools unless explicitly enabled
+        return RunOptions(
+            **{
+                **o.__dict__,
+                "no_ruff": o.no_ruff if o.no_ruff is not None else True,
+                "no_mypy": o.no_mypy if o.no_mypy is not None else True,
+                "no_pytest": o.no_pytest if o.no_pytest is not None else True,
+                "no_rg": o.no_rg if o.no_rg is not None else True,
+                "no_error_refs": o.no_error_refs
+                if o.no_error_refs is not None
+                else True,
+                "no_context": o.no_context if o.no_context is not None else True,
+            }
+        )
+    return o
+
+
+def add_run_only_args(sp: argparse.ArgumentParser) -> None:
+    sp.add_argument(
+        "--format",
+        choices=["auto", "zip", "tar.gz"],
+        default="auto",
+        help="Archive format",
+    )
+    sp.add_argument(
+        "--clean-workdir",
+        action="store_true",
+        help="Delete expanded workdir after packaging",
+    )
+
+
+def add_knobs(sp: argparse.ArgumentParser) -> None:
+    # selective skips
+    sp.add_argument("--ruff", dest="no_ruff", action="store_false", default=None)
+    sp.add_argument("--no-ruff", dest="no_ruff", action="store_true", default=None)
+    sp.add_argument("--mypy", dest="no_mypy", action="store_false", default=None)
+    sp.add_argument("--no-mypy", dest="no_mypy", action="store_true", default=None)
+    sp.add_argument("--pylance", dest="no_pylance", action="store_false", default=None)
+    sp.add_argument(
+        "--no-pylance", dest="no_pylance", action="store_true", default=None
+    )
+    sp.add_argument("--pytest", dest="no_pytest", action="store_false", default=None)
+    sp.add_argument("--no-pytest", dest="no_pytest", action="store_true", default=None)
+    sp.add_argument("--bandit", dest="no_bandit", action="store_false", default=None)
+    sp.add_argument("--no-bandit", dest="no_bandit", action="store_true", default=None)
+    sp.add_argument(
+        "--pip-audit", dest="no_pip_audit", action="store_false", default=None
+    )
+    sp.add_argument(
+        "--no-pip-audit", dest="no_pip_audit", action="store_true", default=None
+    )
+    sp.add_argument(
+        "--coverage", dest="no_coverage", action="store_false", default=None
+    )
+    sp.add_argument(
+        "--no-coverage", dest="no_coverage", action="store_true", default=None
+    )
+    sp.add_argument("--rg", dest="no_rg", action="store_false", default=None)
+    sp.add_argument("--no-rg", dest="no_rg", action="store_true", default=None)
+    sp.add_argument(
+        "--error-refs", dest="no_error_refs", action="store_false", default=None
+    )
+    sp.add_argument(
+        "--no-error-refs", dest="no_error_refs", action="store_true", default=None
+    )
+    sp.add_argument("--context", dest="no_context", action="store_false", default=None)
+    sp.add_argument(
+        "--no-context", dest="no_context", action="store_true", default=None
+    )
+
+    # code quality tools (v1.3.0)
+    sp.add_argument("--vulture", dest="no_vulture", action="store_false", default=None)
+    sp.add_argument(
+        "--no-vulture", dest="no_vulture", action="store_true", default=None
+    )
+    sp.add_argument("--radon", dest="no_radon", action="store_false", default=None)
+    sp.add_argument("--no-radon", dest="no_radon", action="store_true", default=None)
+    sp.add_argument(
+        "--interrogate", dest="no_interrogate", action="store_false", default=None
+    )
+    sp.add_argument(
+        "--no-interrogate", dest="no_interrogate", action="store_true", default=None
+    )
+    sp.add_argument(
+        "--duplication", dest="no_duplication", action="store_false", default=None
+    )
+    sp.add_argument(
+        "--no-duplication", dest="no_duplication", action="store_true", default=None
+    )
+
+    # dependency analysis tools (v1.3.1)
+    sp.add_argument(
+        "--pipdeptree", dest="no_pipdeptree", action="store_false", default=None
+    )
+    sp.add_argument(
+        "--no-pipdeptree", dest="no_pipdeptree", action="store_true", default=None
+    )
+    sp.add_argument(
+        "--unused-deps", dest="no_unused_deps", action="store_false", default=None
+    )
+    sp.add_argument(
+        "--no-unused-deps", dest="no_unused_deps", action="store_true", default=None
+    )
+    sp.add_argument(
+        "--license-scan", dest="no_license_scan", action="store_false", default=None
+    )
+    sp.add_argument(
+        "--no-license-scan", dest="no_license_scan", action="store_true", default=None
+    )
+    sp.add_argument(
+        "--dependency-sizes",
+        dest="no_dependency_sizes",
+        action="store_false",
+        default=None,
+    )
+    sp.add_argument(
+        "--no-dependency-sizes",
+        dest="no_dependency_sizes",
+        action="store_true",
+        default=None,
+    )
+
+    # performance profiling (v1.4.0)
+    sp.add_argument("--profile", dest="no_profile", action="store_false", default=None)
+    sp.add_argument(
+        "--no-profile", dest="no_profile", action="store_true", default=None
+    )
+    sp.add_argument(
+        "--profile-entry-point",
+        type=str,
+        default=None,
+        help="Entry point for profiling (e.g., main.py or tests/)",
+    )
+    sp.add_argument(
+        "--profile-memory",
+        action="store_true",
+        default=False,
+        help="Enable memory profiling with tracemalloc",
+    )
+    sp.add_argument(
+        "--enable-line-profiler",
+        action="store_true",
+        default=False,
+        help="Enable line_profiler (requires @profile decorators)",
+    )
+
+    # test quality & coverage (v1.4.1)
+    sp.add_argument(
+        "--test-flakiness-runs",
+        type=int,
+        default=3,
+        help="Number of times to run tests for flakiness detection (default: 3)",
+    )
+    sp.add_argument(
+        "--slow-test-threshold",
+        type=float,
+        default=1.0,
+        help="Threshold in seconds for identifying slow tests (default: 1.0)",
+    )
+    sp.add_argument(
+        "--mutation",
+        dest="enable_mutation_testing",
+        action="store_true",
+        default=False,
+        help="Enable mutation testing with mutmut (VERY SLOW!)",
+    )
+    sp.add_argument(
+        "--no-mutation",
+        dest="enable_mutation_testing",
+        action="store_false",
+        default=False,
+        help="Disable mutation testing (default)",
+    )
+
+    # documentation & type quality (v1.5.0)
+    sp.add_argument(
+        "--type-coverage", dest="no_type_coverage", action="store_false", default=None
+    )
+    sp.add_argument(
+        "--no-type-coverage", dest="no_type_coverage", action="store_true", default=None
+    )
+    sp.add_argument(
+        "--link-check", dest="no_link_check", action="store_false", default=None
+    )
+    sp.add_argument(
+        "--no-link-check", dest="no_link_check", action="store_true", default=None
+    )
+    sp.add_argument(
+        "--api-docs", dest="no_api_docs", action="store_false", default=None
+    )
+    sp.add_argument(
+        "--no-api-docs", dest="no_api_docs", action="store_true", default=None
+    )
+    sp.add_argument(
+        "--config-docs", dest="no_config_docs", action="store_false", default=None
+    )
+    sp.add_argument(
+        "--no-config-docs", dest="no_config_docs", action="store_true", default=None
+    )
+
+    # Git analytics options (v1.5.1)
+    sp.add_argument(
+        "--git-analytics", dest="no_git_analytics", action="store_false", default=None
+    )
+    sp.add_argument(
+        "--no-git-analytics", dest="no_git_analytics", action="store_true", default=None
+    )
+    sp.add_argument(
+        "--git-blame-depth",
+        type=int,
+        default=100,
+        help="Number of commits to analyze in git blame (default: 100)",
+    )
+
+    # Runtime analysis options (v1.5.2)
+    sp.add_argument(
+        "--runtime-analysis", dest="no_runtime_analysis", action="store_false", default=None
+    )
+    sp.add_argument(
+        "--no-runtime-analysis", dest="no_runtime_analysis", action="store_true", default=None
+    )
+
+    # Container & deployment options (v2.0.0)
+    sp.add_argument(
+        "--container-analysis", dest="no_container_analysis", action="store_false", default=None
+    )
+    sp.add_argument(
+        "--no-container-analysis", dest="no_container_analysis", action="store_true", default=None
+    )
+    sp.add_argument(
+        "--docker-image",
+        type=str,
+        default=None,
+        help="Docker image name for analysis (default: auto-detect from docker-compose)",
+    )
+
+    # Configuration & security options (v2.0.0)
+    sp.add_argument(
+        "--config-security-analysis", dest="no_config_security_analysis", action="store_false", default=None
+    )
+    sp.add_argument(
+        "--no-config-security-analysis", dest="no_config_security_analysis", action="store_true", default=None
+    )
+
+    # Async & modern Python options (v2.0.0)
+    sp.add_argument(
+        "--async-analysis", dest="no_async_analysis", action="store_false", default=None
+    )
+    sp.add_argument(
+        "--no-async-analysis", dest="no_async_analysis", action="store_true", default=None
+    )
+
+    # Database & data layer options (v2.0.0)
+    sp.add_argument(
+        "--db-analysis", dest="no_db_analysis", action="store_false", default=None
+    )
+    sp.add_argument(
+        "--no-db-analysis", dest="no_db_analysis", action="store_true", default=None
+    )
+
+    # Framework-specific options (v2.0.0)
+    sp.add_argument(
+        "--framework-analysis", dest="no_framework_analysis", action="store_false", default=None
+    )
+    sp.add_argument(
+        "--no-framework-analysis", dest="no_framework_analysis", action="store_true", default=None
+    )
+
+    # Security options
+    sp.add_argument(
+        "--strict-paths",
+        action="store_true",
+        help="Only use tools from trusted system directories (enhanced security)",
+    )
+
+    # targets / args
+    sp.add_argument("--ruff-target", default=".")
+    sp.add_argument("--mypy-target", default=".")
+    sp.add_argument(
+        "--pytest-args",
+        default="-q",
+        help='Pytest args as a single string, e.g. "--maxfail=1 -q"',
+    )
+
+    # caps
+    sp.add_argument("--error-max-files", type=int, default=250)
+    sp.add_argument("--context-depth", type=int, default=2)
+    sp.add_argument("--context-max-files", type=int, default=600)
+
+
+def build_parser() -> argparse.ArgumentParser:
+    p = argparse.ArgumentParser(
+        prog="pybundle", description="Build portable diagnostic bundles for projects."
+    )
+    sub = p.add_subparsers(dest="cmd", required=True)
+    sub.add_parser("version", help="Show version")
+    sub.add_parser("list-profiles", help="List available profiles")
+
+    runp = sub.add_parser("run", help="Run a profile and build an archive")
+    runp.add_argument("profile", choices=["analysis", "debug", "backup", "ai"])
+    add_common_args(runp)
+    add_run_only_args(runp)
+    add_knobs(runp)
+
+    docp = sub.add_parser("doctor", help="Show tool availability and what would run")
+    docp.add_argument(
+        "profile",
+        choices=["analysis", "debug", "backup", "ai"],
+        nargs="?",
+        default="analysis",
+    )
+    add_common_args(docp)
+    add_knobs(docp)
+
+    return p
+
+
+def _build_options(args) -> RunOptions:
+    pytest_args = (
+        shlex.split(args.pytest_args) if getattr(args, "pytest_args", None) else ["-q"]
+    )
+    return RunOptions(
+        no_ruff=getattr(args, "no_ruff", None),
+        no_mypy=getattr(args, "no_mypy", None),
+        no_pylance=getattr(args, "no_pylance", None),
+        no_pytest=getattr(args, "no_pytest", None),
+        no_bandit=getattr(args, "no_bandit", None),
+        no_pip_audit=getattr(args, "no_pip_audit", None),
+        no_coverage=getattr(args, "no_coverage", None),
+        no_rg=getattr(args, "no_rg", None),
+        no_error_refs=getattr(args, "no_error_refs", None),
+        no_context=getattr(args, "no_context", None),
+        no_compileall=getattr(args, "no_compileall", None),
+        no_vulture=getattr(args, "no_vulture", None),
+        no_radon=getattr(args, "no_radon", None),
+        no_interrogate=getattr(args, "no_interrogate", None),
+        no_duplication=getattr(args, "no_duplication", None),
+        no_pipdeptree=getattr(args, "no_pipdeptree", None),
+        no_unused_deps=getattr(args, "no_unused_deps", None),
+        no_license_scan=getattr(args, "no_license_scan", None),
+        no_dependency_sizes=getattr(args, "no_dependency_sizes", None),
+        no_profile=getattr(args, "no_profile", None),
+        profile_entry_point=getattr(args, "profile_entry_point", None),
+        profile_memory=getattr(args, "profile_memory", False),
+        enable_line_profiler=getattr(args, "enable_line_profiler", False),
+        test_flakiness_runs=getattr(args, "test_flakiness_runs", 3),
+        slow_test_threshold=getattr(args, "slow_test_threshold", 1.0),
+        enable_mutation_testing=getattr(args, "enable_mutation_testing", False),
+        no_type_coverage=getattr(args, "no_type_coverage", None),
+        no_link_check=getattr(args, "no_link_check", None),
+        no_api_docs=getattr(args, "no_api_docs", None),
+        no_config_docs=getattr(args, "no_config_docs", None),
+        no_git_analytics=getattr(args, "no_git_analytics", None),
+        git_blame_depth=getattr(args, "git_blame_depth", 100),
+        no_runtime_analysis=getattr(args, "no_runtime_analysis", None),
+        no_container_analysis=getattr(args, "no_container_analysis", None),
+        docker_image=getattr(args, "docker_image", None),
+        no_config_security_analysis=getattr(args, "no_config_security_analysis", None),
+        no_async_analysis=getattr(args, "no_async_analysis", None),
+        no_db_analysis=getattr(args, "no_db_analysis", None),
+        no_framework_analysis=getattr(args, "no_framework_analysis", None),
+        strict_paths=getattr(args, "strict_paths", False),
+        ruff_target=getattr(args, "ruff_target", "."),
+        mypy_target=getattr(args, "mypy_target", "."),
+        pytest_args=pytest_args,
+        error_max_files=getattr(args, "error_max_files", 250),
+        context_depth=getattr(args, "context_depth", 2),
+        context_max_files=getattr(args, "context_max_files", 600),
+    )
+
+
+def main(argv: list[str] | None = None) -> int:
+    import sys
+    
+    # Capture full command for reproducibility before parsing
+    if argv is None:
+        command_line = ' '.join(sys.argv)
+    else:
+        command_line = 'pybundle ' + ' '.join(argv)
+    
+    args = build_parser().parse_args(argv)
+
+    if args.cmd == "version":
+        print(f"pybundle {get_version()}")
+        return 0
+
+    if args.cmd == "list-profiles":
+        print("ai        - AI-friendly context bundle (fast, low-flake defaults)")
+        print("backup    - portable snapshot (scaffold)")
+        print("analysis  - neutral diagnostic bundle (humans, tools, assistants)")
+        print("debug     - deeper diagnostics for developers")
+        return 0
+
+    # run + doctor need a root
+    root = args.project_root or detect_project_root(Path.cwd())
+    if root is None:
+        print("❌ Could not detect project root. Use --project-root PATH.")
+        return 20
+
+    outdir = args.outdir or (root / "artifacts")
+
+    options = _resolve_profile_defaults(args.profile, _build_options(args))
+    profile = get_profile(args.profile, options)
+
+    if args.cmd == "doctor":
+        ctx = BundleContext.create(
+            root=root,
+            outdir=outdir,
+            profile_name=args.profile,
+            archive_format="auto",
+            name_prefix=args.name,
+            strict=args.strict,
+            redact=args.redact,
+            json_mode=args.json,
+            keep_workdir=True,
+            options=options,
+        )
+        ctx.command_used = command_line
+
+        if args.json:
+            ctx.emit_json(ctx.doctor_report(profile))
+        else:
+            ctx.print_doctor(profile)
+        return 0
+
+    # cmd == run
+    keep_workdir = not args.clean_workdir
+
+    ctx = BundleContext.create(
+        root=root,
+        outdir=outdir,
+        profile_name=args.profile,
+        archive_format=args.format,
+        name_prefix=args.name,
+        strict=args.strict,
+        redact=args.redact,
+        json_mode=args.json,
+        keep_workdir=keep_workdir,
+        options=options,
+    )
+    ctx.command_used = command_line
+
+    rc = run_profile(ctx, profile)
+
+    if args.json:
+        copied = None
+        excluded = None
+
+        mf = ctx.metadir / "50_copy_manifest.txt"
+        if mf.exists():
+            data: dict[str, str] = {}
+            for line in mf.read_text(encoding="utf-8").splitlines():
+                if "=" in line:
+                    k, v = line.split("=", 1)
+                    data[k.strip()] = v.strip()
+
+            copied = int(data.get("copied_files", "0"))
+            excluded = int(data.get("excluded_files", "0"))
+
+        payload = {
+            "status": "ok" if rc == 0 else "fail",
+            "command": "run",
+            "profile": profile.name,
+            "files_included": copied if copied is not None else 0,
+            "files_excluded": excluded if excluded is not None else 0,
+            "duration_ms": ctx.duration_ms or 0,
+            "bundle_path": str(ctx.archive_path) if ctx.archive_path else None,
+        }
+        ctx.emit_json(payload)
+
+    return rc
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())