gwc-pybundle 1.4.5__py3-none-any.whl

gwc_pybundle-1.4.5.dist-info/RECORD

@@ -0,0 +1,55 @@
+gwc_pybundle-1.4.5.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=Fg8Jwv7PWNHnsdA46x2OVWNO7kz6SZlQ5xfU5XRTGfw,14544
+pybundle/context.py,sha256=j2m3v1n8SCIs6vw69fqzUuSbT0iSf805KXolqpVccac,12013
+pybundle/doctor.py,sha256=6tpEH5_UVKA8Wbi5kKkUoxXMjTGOrEZr3leBd4pU3Lw,4669
+pybundle/filters.py,sha256=gKluTcoi6g0vt40m8sMbqmT-W2XBo_X7slW0CCAQI_o,3040
+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=D_kOG0z477l6h6n5YifWZpuQIP6u4z2JrPKqn_CaHs0,10673
+pybundle/roadmap_model.py,sha256=rcMwphd3uNiwzAVx_tGTE20GYYFRzyvbCoFcYGRS9aY,991
+pybundle/roadmap_scan.py,sha256=ogS7j9pVIhqk_1u7eTBTUDjUGupZdU2RYWy1KcUPrgE,9613
+pybundle/root_detect.py,sha256=d_HdA_usPxK1orc9cnNTY_fZrvdScQnI_f1XvvlHSFA,361
+pybundle/runner.py,sha256=pw0T3QhbIl7cR7xyNcrm48IToE2b8NB8ZVFvtOEjyzw,5220
+pybundle/tools.py,sha256=dLg6m7tW11QC6SoJUzoayYEI-lq_kKuOm2eN2uzqnQo,1926
+pybundle/steps/__init__.py,sha256=3NL5A0Oj4MlTPW7LvdzesrLHMJG98nV-qrcaJuICE4o,394
+pybundle/steps/bandit.py,sha256=4gT9JJerhT9W8O6lF_Vwk6iNjYvJqQcihVcF816NzS4,2439
+pybundle/steps/base.py,sha256=9LZwPYlGAWfnIe5DRbfP89ZmMLhbmOm9SQ-vWmQANHA,356
+pybundle/steps/compileall.py,sha256=uB_eFVq1FSSrdzZvx9hgs4IbNJnrXzPOCjyTfDw0gsc,2446
+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=z8KjKb2tydA0z5fnq6eZSJolpiWEld7NnlNQOSfj7AY,5755
+pybundle/steps/dependency_sizes.py,sha256=oAzqUCmD0f7eOJfxE_S_ARgTszKEOJHSP5i-Z6aP0MI,5207
+pybundle/steps/duplication.py,sha256=NmeNXXcEUYnlJWSCcilwb4K9NhTsGBvWJf4EoZZ3tBI,3304
+pybundle/steps/error_refs.py,sha256=mq1DGXREQRudycyPb7H0obkHmv3HvO-QPPbf2zoZDu0,5640
+pybundle/steps/handoff_md.py,sha256=TOv9IEqrss60ZKHlCx7XEzq_FgSZ38jr2sT3Nr7AwNM,6038
+pybundle/steps/import_time.py,sha256=tEoybXsLYAYZ2iQjhsg6dN-VH37utsOThvHP-xwZ16k,6394
+pybundle/steps/interrogate.py,sha256=la_3zy1gulqg382cNI3zFq4obH0OQyMZJQ9_FbCXIzU,2872
+pybundle/steps/license_scan.py,sha256=rEigwhFC80btqAfecL2mFKyBxQkYP19FVESRXmaJaBY,3640
+pybundle/steps/line_profiler.py,sha256=8RDjv8AE-xmnlPZzGXYEaOaLoJ2KlL8V8d_rrUJ7V94,4141
+pybundle/steps/memory_profile.py,sha256=a8Iq3zdDstDrwWY4JmsIeIQV1JVKm5Pbx-D7OZw6AX4,5359
+pybundle/steps/mutation_testing.py,sha256=MIHRrX6PrIfg9Aeal81Qe-G5pKMCPn0kGSbWuykVZUY,5417
+pybundle/steps/mypy.py,sha256=QykLCT5XkQOJHHRxj4VAaPuCycoQOFymj-Xhz8cuc1c,1991
+pybundle/steps/pip_audit.py,sha256=qNkHeyjzUFJ9SSKU4jTKOsUnWnNYAk_jWcmPlUckkAA,1582
+pybundle/steps/pipdeptree.py,sha256=ZIBAC_qEBE_iUh8bX6ogYQVRCSB0blfiCmsGh4gFUbU,2150
+pybundle/steps/pylance.py,sha256=PiIyyYm8gTVv-dihzRjvD4waZnz31qNOEAjYIlscvSY,15715
+pybundle/steps/pytest.py,sha256=vfr2DI6aYCTit_j9QdV3WtKlOZtLMCCSm2E__3tsZt4,2177
+pybundle/steps/radon.py,sha256=2gi_MQibkHhE1y9Bm3kpirlJc5SPQpHgI0yHieQ6VFo,4072
+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=xrKSn5QBQ5sLBKW5TQCORANlvlh1eHdikOhxJP2gO54,3815
+pybundle/steps/shell.py,sha256=vYGu9fZ5gDdZnKSfok95bOTIWu5HNvS23atsY5FwtJE,2529
+pybundle/steps/slow_tests.py,sha256=3Gc1h4JB_41yjWthwVaIVMP3flm5xaCyQ94Nw86IB1o,7101
+pybundle/steps/test_flakiness.py,sha256=5W8OGCJT1VsLu3jVcv55-CdtgdCYhk20jBCA9xvTpxc,7283
+pybundle/steps/tree.py,sha256=tz5Z7clOEuKWMW6wjj2xtEu3pNjEto8dYgHYaoDdM0E,3674
+pybundle/steps/unused_deps.py,sha256=L6n0fyu-p2lQkWjMKe8I5Ad5JMkou3muNU2qtqPOgOg,4870
+pybundle/steps/vulture.py,sha256=-3964YRxqoQ-zRrAN6pS0HNlVeUzw-z75JZdbELavEw,2942
+gwc_pybundle-1.4.5.dist-info/METADATA,sha256=iKF1bpXHiM9G1vvPyP2exuQcikA0cZjKR8W5glbF81g,25610
+gwc_pybundle-1.4.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+gwc_pybundle-1.4.5.dist-info/entry_points.txt,sha256=xgXfIvyx9ZI6jd9MscFWNMzQrcX4scTVJ9L7WwksUHg,47
+gwc_pybundle-1.4.5.dist-info/top_level.txt,sha256=N5x3QutDUtHQn3HwkFmH5PeM9uPY-E5wOKUJSE8PBKM,9
+gwc_pybundle-1.4.5.dist-info/RECORD,,

gwc_pybundle-1.4.5.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-1.4.5.dist-info/entry_points.txt

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

gwc_pybundle-1.4.5.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-1.4.5.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,365 @@
+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)")
+
+    # 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),
+        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:
+    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,
+        )
+
+        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,
+    )
+
+    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())