sdetkit 1.0.3__tar.gz → 1.2.0__tar.gz

sdetkit-1.2.0/PKG-INFO

@@ -0,0 +1,215 @@
+Metadata-Version: 2.4
+Name: sdetkit
+Version: 1.2.0
+Summary: Operator-grade release confidence and test intelligence platform: deterministic gates, evidence, integration assurance, and failure forensics.
+Author: DevS69 contributors
+Maintainer: DevS69 maintainers
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/sherif69-sa/DevS69-sdetkit
+Project-URL: Repository, https://github.com/sherif69-sa/DevS69-sdetkit
+Project-URL: Documentation, https://sherif69-sa.github.io/DevS69-sdetkit/
+Project-URL: Issues, https://github.com/sherif69-sa/DevS69-sdetkit/issues
+Project-URL: Releases, https://github.com/sherif69-sa/DevS69-sdetkit/releases
+Project-URL: Changelog, https://github.com/sherif69-sa/DevS69-sdetkit/blob/main/CHANGELOG.md
+Project-URL: Release Process, https://github.com/sherif69-sa/DevS69-sdetkit/blob/main/docs/project/release-process.md
+Project-URL: Trust and Support Policy, https://github.com/sherif69-sa/DevS69-sdetkit/blob/main/docs/versioning-and-support.md
+Keywords: sdet,testing,qa,automation,cli,devtools,quality-gates
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx<1,>=0.28.1
+Requires-Dist: tomli>=2.0.1; python_version < "3.11"
+Provides-Extra: dev
+Requires-Dist: build==1.5.1; extra == "dev"
+Requires-Dist: mypy==2.3.0; extra == "dev"
+Requires-Dist: pre-commit==4.6.0; extra == "dev"
+Requires-Dist: ruff==0.15.22; extra == "dev"
+Requires-Dist: twine==6.2.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: hypothesis==6.156.6; extra == "test"
+Requires-Dist: pre-commit==4.6.0; extra == "test"
+Requires-Dist: PyYAML; extra == "test"
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-asyncio; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Requires-Dist: pytest-xdist[psutil]; extra == "test"
+Provides-Extra: docs
+Requires-Dist: mkdocs==1.6.1; extra == "docs"
+Requires-Dist: mkdocs-material==9.7.7; extra == "docs"
+Provides-Extra: packaging
+Requires-Dist: build==1.5.1; extra == "packaging"
+Requires-Dist: check-wheel-contents==0.6.3; extra == "packaging"
+Requires-Dist: twine==6.2.0; extra == "packaging"
+Provides-Extra: telegram
+Requires-Dist: python-telegram-bot<23,>=22.7; extra == "telegram"
+Provides-Extra: whatsapp
+Requires-Dist: twilio<10,>=9.10.9; extra == "whatsapp"
+Dynamic: license-file
+
+<div align="center">
+  <img src="docs/assets/logo-mark.svg" alt="DevS69 mark" width="68" />
+  <h1>DevS69 SDETKit</h1>
+  <p><strong>From noisy CI evidence to deterministic ship / no-ship decisions.</strong></p>
+</div>
+
+DevS69 SDETKit is a release-confidence CLI for deterministic ship/no-ship decisions with machine-readable evidence.
+
+**Primary outcome:** know if a change is ready to ship.
+**Runtime requirement:** Python 3.10+.
+
+Canonical first path: `python -m sdetkit gate fast` -> `python -m sdetkit gate release` -> `python -m sdetkit doctor`.
+
+## Start here
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+python -m pip install -U pip
+python -m pip install sdetkit==1.0.3
+
+python -m sdetkit gate fast --format json --stable-json --out build/gate-fast.json
+python -m sdetkit gate release --format json --out build/release-preflight.json
+python -m sdetkit doctor --format json --out build/doctor.json
+```
+
+Generated first-run artifacts:
+
+```text
+build/
+├── gate-fast.json
+├── release-preflight.json
+└── doctor.json
+```
+
+## Why SDETKit?
+
+Most quality tools stop at a failed check. SDETKit connects the evidence into an operator decision:
+
+- **Decide:** produce deterministic `SHIP` / `NO-SHIP` evidence.
+- **Diagnose:** extract the first meaningful failure instead of repeating the loudest wrapper error.
+- **Prove:** recommend exact verification commands and preserve machine-readable artifacts.
+- **Protect:** keep investigation and remediation review-first unless an explicit guarded policy allows more.
+
+## From failure to next action
+
+```text
+input: FAILED tests/test_release_contract.py::test_wheel_smoke
+classification: test
+affected_file: tests/test_release_contract.py
+next_command: python -m pytest -q tests/test_release_contract.py -o addopts=
+authority: review-first; no repository mutation or merge authorization
+```
+
+Start with [`docs/first-failure-triage.md`](docs/first-failure-triage.md) and [`docs/investigation-operator-guide.md`](docs/investigation-operator-guide.md).
+
+## Public launch proof
+
+See the [committed public launch proof](docs/public-launch-proof.md) for a realistic saved pytest failure reduced to its first failing node, affected file, focused proof command, and review-first decision. The same proof includes a fixture-based Python, JavaScript/TypeScript, and Go adoption profile generated without installing target dependencies, executing target code, mutating the target, or authorizing a merge.
+
+The proof is tied to an immutable source commit and is explicitly marked **main-only until the qualified 1.2.0 release**.
+
+## Decision contract
+
+| Signal | Decision |
+| --- | --- |
+| `gate-fast.json.ok == true` and `release-preflight.json.ok == true` | ✅ SHIP |
+| Any `ok: false` | ❌ NO-SHIP |
+| `failed_steps` present in either artifact | ❌ NO-SHIP |
+
+Secondary lanes cover review, investigation, quality, maintenance, and CI automation once the primary gate decision is stable. Investigation/reporting/planning lanes are diagnostic-only by default; repository mutation requires explicit guarded policy and PR-only remediation controls.
+
+## What SDETKit gives teams
+
+- **Deterministic decisions:** every release-confidence run ends in an auditable SHIP / NO-SHIP signal.
+- **Evidence-first artifacts:** JSON and Markdown outputs can be reviewed by humans, bots, and CI.
+- **Diagnostic investigation:** `sdetkit investigate` explains failures and recommends proof commands without mutating the repository.
+- **Guarded automation path:** remediation and PR automation are explicit opt-in lanes, not the default behavior.
+- **One workflow everywhere:** use the same core commands locally, in CI, and during operator handoff.
+
+| Lane | Command | Start here when... |
+| --- | --- | --- |
+| Release gate | `python -m sdetkit gate fast` -> `python -m sdetkit gate release` -> `python -m sdetkit doctor` | You need a ship/no-ship decision. |
+| Readiness evidence | `python -m sdetkit repo audit . --format json --fail-on none` → `python -m sdetkit security scan --fail-on none --format sarif --output build/security.sarif --sbom-output build/sbom.cdx.json` → `python -m sdetkit evidence pack --output .sdetkit/out/evidence.zip` | You need local repository, security, and bundled evidence. See [Repo Audit](docs/repo-audit.md), [Security Gate](docs/security-gate.md), and [Artifact reference](docs/artifact-reference.md). |
+| Review | `python -m sdetkit review . --no-workspace --format operator-json` | You need operator-facing findings. |
+| Investigation | `python -m sdetkit investigate failure --log build/quality.log --format markdown` | A CI log or PR check needs triage before remediation. |
+| CI-ready | `./ci.sh quick --artifact-dir .sdetkit/out` and `make merge-ready` | You want a local CI-equivalent smoke path. |
+
+## Product proof
+
+<!-- product-proof-start -->
+SDETKit is backed by committed live-adoption proof.
+
+- **Evidence:** `docs/artifacts/live-adoption/product-proof-post-1072/`
+- **Decision:** `SHIP with known STRICT_FINDINGS`
+- **Blocking failures:** `0`
+- **Known strict finding:** `legacy-noargs` compatibility behavior only
+- **Proof page:** [`docs/live-adoption-product-proof.md`](docs/live-adoption-product-proof.md)
+<!-- product-proof-end -->
+
+For this repository, `make first-proof` emits `FIRST_PROOF_DECISION=SHIP|NO-SHIP` and writes the consolidated bundle under `build/first-proof/`.
+
+## Release channel
+
+The install command above uses the latest published package, `sdetkit==1.0.3`. The repository `main` branch contains additional diagnostic, verification, benchmark, trajectory, multi-ecosystem, CI-provider, and mixed-workspace capabilities that remain **main-only** until the qualified 1.2.0 release. See the [current product delta](docs/current-product-delta.md) before treating repository documentation as installed-wheel proof.
+
+## Documentation map
+
+- Start in 5 minutes: [docs/start-here-5-minutes.md](docs/start-here-5-minutes.md)
+- Operator essentials: [docs/operator-essentials.md](docs/operator-essentials.md)
+- Investigation operator guide: [docs/investigation-operator-guide.md](docs/investigation-operator-guide.md)
+- Adaptive diagnosis: [docs/adaptive-diagnosis.md](docs/adaptive-diagnosis.md)
+- Public launch proof: [docs/public-launch-proof.md](docs/public-launch-proof.md)
+- Artifact reference: [docs/artifact-reference.md](docs/artifact-reference.md)
+- Recommended CI flow: [docs/recommended-ci-flow.md](docs/recommended-ci-flow.md)
+- CLI reference: [docs/cli.md](docs/cli.md)
+- Contributor guide: [CONTRIBUTING.md](CONTRIBUTING.md)
+
+## Advanced lanes live in docs
+
+Historical and transition-era references (secondary) remain outside the first-time path.
+
+- External repository adoption: [docs/adoption.md](docs/adoption.md)
+- Portfolio readiness and reporting: [docs/portfolio-readiness.md](docs/portfolio-readiness.md)
+- Operations handbook: [docs/operations-handbook.md](docs/operations-handbook.md)
+- Remediation cookbook: [docs/remediation-cookbook.md](docs/remediation-cookbook.md)
+- Release process: [docs/project/release-process.md](docs/project/release-process.md)
+
+## Top-tier reporting sample pipeline
+
+Run `make top-tier-reporting`; see [docs/portfolio-reporting-recipe.md](docs/portfolio-reporting-recipe.md) and [docs/kpi-schema.md](docs/kpi-schema.md).
+
+## Upgrade next (intent router)
+
+Run `make upgrade-next`; see [docs/upgrade-next-commands.md](docs/upgrade-next-commands.md).
+
+## Real workflow operations
+
+See [docs/real-workflow-operations.md](docs/real-workflow-operations.md). Common aliases: `make ops-daily`, `make ops-daily-fast`, `make ops-weekly`, `make ops-premerge`, `make ops-premerge-fast`, `make ops-premerge-next`, `make ops-premerge-next-fast`, `make ops-followup`, `make ops-now`, `make ops-now-lite`, `make ops-next`.
+
+## Repository layout
+
+| Area | Purpose |
+| --- | --- |
+| `src/` | SDETKit Python package and CLI implementation. |
+| `tests/` | Unit, workflow, docs, and contract tests. |
+| `docs/` | Operator guides, artifact references, quality gates, and developer docs, including `docs/artifacts/`. |
+| `.github/workflows/` | CI, quality, maintenance, and artifact upload automation. |
+
+## Project policies
+
+- Docs map: [docs/docs-map.md](docs/docs-map.md)
+- Security: [SECURITY.md](SECURITY.md)
+- Quality playbook: [docs/project/quality-playbook.md](docs/project/quality-playbook.md)
+- Release notes: [CHANGELOG.md](CHANGELOG.md)

sdetkit-1.2.0/README.md

@@ -0,0 +1,155 @@
+<div align="center">
+  <img src="docs/assets/logo-mark.svg" alt="DevS69 mark" width="68" />
+  <h1>DevS69 SDETKit</h1>
+  <p><strong>From noisy CI evidence to deterministic ship / no-ship decisions.</strong></p>
+</div>
+
+DevS69 SDETKit is a release-confidence CLI for deterministic ship/no-ship decisions with machine-readable evidence.
+
+**Primary outcome:** know if a change is ready to ship.
+**Runtime requirement:** Python 3.10+.
+
+Canonical first path: `python -m sdetkit gate fast` -> `python -m sdetkit gate release` -> `python -m sdetkit doctor`.
+
+## Start here
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+python -m pip install -U pip
+python -m pip install sdetkit==1.0.3
+
+python -m sdetkit gate fast --format json --stable-json --out build/gate-fast.json
+python -m sdetkit gate release --format json --out build/release-preflight.json
+python -m sdetkit doctor --format json --out build/doctor.json
+```
+
+Generated first-run artifacts:
+
+```text
+build/
+├── gate-fast.json
+├── release-preflight.json
+└── doctor.json
+```
+
+## Why SDETKit?
+
+Most quality tools stop at a failed check. SDETKit connects the evidence into an operator decision:
+
+- **Decide:** produce deterministic `SHIP` / `NO-SHIP` evidence.
+- **Diagnose:** extract the first meaningful failure instead of repeating the loudest wrapper error.
+- **Prove:** recommend exact verification commands and preserve machine-readable artifacts.
+- **Protect:** keep investigation and remediation review-first unless an explicit guarded policy allows more.
+
+## From failure to next action
+
+```text
+input: FAILED tests/test_release_contract.py::test_wheel_smoke
+classification: test
+affected_file: tests/test_release_contract.py
+next_command: python -m pytest -q tests/test_release_contract.py -o addopts=
+authority: review-first; no repository mutation or merge authorization
+```
+
+Start with [`docs/first-failure-triage.md`](docs/first-failure-triage.md) and [`docs/investigation-operator-guide.md`](docs/investigation-operator-guide.md).
+
+## Public launch proof
+
+See the [committed public launch proof](docs/public-launch-proof.md) for a realistic saved pytest failure reduced to its first failing node, affected file, focused proof command, and review-first decision. The same proof includes a fixture-based Python, JavaScript/TypeScript, and Go adoption profile generated without installing target dependencies, executing target code, mutating the target, or authorizing a merge.
+
+The proof is tied to an immutable source commit and is explicitly marked **main-only until the qualified 1.2.0 release**.
+
+## Decision contract
+
+| Signal | Decision |
+| --- | --- |
+| `gate-fast.json.ok == true` and `release-preflight.json.ok == true` | ✅ SHIP |
+| Any `ok: false` | ❌ NO-SHIP |
+| `failed_steps` present in either artifact | ❌ NO-SHIP |
+
+Secondary lanes cover review, investigation, quality, maintenance, and CI automation once the primary gate decision is stable. Investigation/reporting/planning lanes are diagnostic-only by default; repository mutation requires explicit guarded policy and PR-only remediation controls.
+
+## What SDETKit gives teams
+
+- **Deterministic decisions:** every release-confidence run ends in an auditable SHIP / NO-SHIP signal.
+- **Evidence-first artifacts:** JSON and Markdown outputs can be reviewed by humans, bots, and CI.
+- **Diagnostic investigation:** `sdetkit investigate` explains failures and recommends proof commands without mutating the repository.
+- **Guarded automation path:** remediation and PR automation are explicit opt-in lanes, not the default behavior.
+- **One workflow everywhere:** use the same core commands locally, in CI, and during operator handoff.
+
+| Lane | Command | Start here when... |
+| --- | --- | --- |
+| Release gate | `python -m sdetkit gate fast` -> `python -m sdetkit gate release` -> `python -m sdetkit doctor` | You need a ship/no-ship decision. |
+| Readiness evidence | `python -m sdetkit repo audit . --format json --fail-on none` → `python -m sdetkit security scan --fail-on none --format sarif --output build/security.sarif --sbom-output build/sbom.cdx.json` → `python -m sdetkit evidence pack --output .sdetkit/out/evidence.zip` | You need local repository, security, and bundled evidence. See [Repo Audit](docs/repo-audit.md), [Security Gate](docs/security-gate.md), and [Artifact reference](docs/artifact-reference.md). |
+| Review | `python -m sdetkit review . --no-workspace --format operator-json` | You need operator-facing findings. |
+| Investigation | `python -m sdetkit investigate failure --log build/quality.log --format markdown` | A CI log or PR check needs triage before remediation. |
+| CI-ready | `./ci.sh quick --artifact-dir .sdetkit/out` and `make merge-ready` | You want a local CI-equivalent smoke path. |
+
+## Product proof
+
+<!-- product-proof-start -->
+SDETKit is backed by committed live-adoption proof.
+
+- **Evidence:** `docs/artifacts/live-adoption/product-proof-post-1072/`
+- **Decision:** `SHIP with known STRICT_FINDINGS`
+- **Blocking failures:** `0`
+- **Known strict finding:** `legacy-noargs` compatibility behavior only
+- **Proof page:** [`docs/live-adoption-product-proof.md`](docs/live-adoption-product-proof.md)
+<!-- product-proof-end -->
+
+For this repository, `make first-proof` emits `FIRST_PROOF_DECISION=SHIP|NO-SHIP` and writes the consolidated bundle under `build/first-proof/`.
+
+## Release channel
+
+The install command above uses the latest published package, `sdetkit==1.0.3`. The repository `main` branch contains additional diagnostic, verification, benchmark, trajectory, multi-ecosystem, CI-provider, and mixed-workspace capabilities that remain **main-only** until the qualified 1.2.0 release. See the [current product delta](docs/current-product-delta.md) before treating repository documentation as installed-wheel proof.
+
+## Documentation map
+
+- Start in 5 minutes: [docs/start-here-5-minutes.md](docs/start-here-5-minutes.md)
+- Operator essentials: [docs/operator-essentials.md](docs/operator-essentials.md)
+- Investigation operator guide: [docs/investigation-operator-guide.md](docs/investigation-operator-guide.md)
+- Adaptive diagnosis: [docs/adaptive-diagnosis.md](docs/adaptive-diagnosis.md)
+- Public launch proof: [docs/public-launch-proof.md](docs/public-launch-proof.md)
+- Artifact reference: [docs/artifact-reference.md](docs/artifact-reference.md)
+- Recommended CI flow: [docs/recommended-ci-flow.md](docs/recommended-ci-flow.md)
+- CLI reference: [docs/cli.md](docs/cli.md)
+- Contributor guide: [CONTRIBUTING.md](CONTRIBUTING.md)
+
+## Advanced lanes live in docs
+
+Historical and transition-era references (secondary) remain outside the first-time path.
+
+- External repository adoption: [docs/adoption.md](docs/adoption.md)
+- Portfolio readiness and reporting: [docs/portfolio-readiness.md](docs/portfolio-readiness.md)
+- Operations handbook: [docs/operations-handbook.md](docs/operations-handbook.md)
+- Remediation cookbook: [docs/remediation-cookbook.md](docs/remediation-cookbook.md)
+- Release process: [docs/project/release-process.md](docs/project/release-process.md)
+
+## Top-tier reporting sample pipeline
+
+Run `make top-tier-reporting`; see [docs/portfolio-reporting-recipe.md](docs/portfolio-reporting-recipe.md) and [docs/kpi-schema.md](docs/kpi-schema.md).
+
+## Upgrade next (intent router)
+
+Run `make upgrade-next`; see [docs/upgrade-next-commands.md](docs/upgrade-next-commands.md).
+
+## Real workflow operations
+
+See [docs/real-workflow-operations.md](docs/real-workflow-operations.md). Common aliases: `make ops-daily`, `make ops-daily-fast`, `make ops-weekly`, `make ops-premerge`, `make ops-premerge-fast`, `make ops-premerge-next`, `make ops-premerge-next-fast`, `make ops-followup`, `make ops-now`, `make ops-now-lite`, `make ops-next`.
+
+## Repository layout
+
+| Area | Purpose |
+| --- | --- |
+| `src/` | SDETKit Python package and CLI implementation. |
+| `tests/` | Unit, workflow, docs, and contract tests. |
+| `docs/` | Operator guides, artifact references, quality gates, and developer docs, including `docs/artifacts/`. |
+| `.github/workflows/` | CI, quality, maintenance, and artifact upload automation. |
+
+## Project policies
+
+- Docs map: [docs/docs-map.md](docs/docs-map.md)
+- Security: [SECURITY.md](SECURITY.md)
+- Quality playbook: [docs/project/quality-playbook.md](docs/project/quality-playbook.md)
+- Release notes: [CHANGELOG.md](CHANGELOG.md)

sdetkit-1.2.0/pyproject.toml

@@ -0,0 +1,253 @@
+[build-system]
+requires = ["setuptools>=65.5.1", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sdetkit"
+version = "1.2.0"
+requires-python = ">=3.10"
+readme = "README.md"
+description = "Operator-grade release confidence and test intelligence platform: deterministic gates, evidence, integration assurance, and failure forensics."
+license = "Apache-2.0"
+license-files = ["LICENSE"]
+keywords = ["sdet", "testing", "qa", "automation", "cli", "devtools", "quality-gates"]
+authors = [{ name = "DevS69 contributors" }]
+maintainers = [{ name = "DevS69 maintainers" }]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: Testing",
+  "Topic :: Software Development :: Quality Assurance",
+  "Topic :: Utilities",
+]
+dependencies = [
+  "httpx>=0.28.1,<1",
+  "tomli>=2.0.1; python_version < '3.11'"
+]
+[project.urls]
+Homepage = "https://github.com/sherif69-sa/DevS69-sdetkit"
+Repository = "https://github.com/sherif69-sa/DevS69-sdetkit"
+Documentation = "https://sherif69-sa.github.io/DevS69-sdetkit/"
+Issues = "https://github.com/sherif69-sa/DevS69-sdetkit/issues"
+Releases = "https://github.com/sherif69-sa/DevS69-sdetkit/releases"
+Changelog = "https://github.com/sherif69-sa/DevS69-sdetkit/blob/main/CHANGELOG.md"
+"Release Process" = "https://github.com/sherif69-sa/DevS69-sdetkit/blob/main/docs/project/release-process.md"
+"Trust and Support Policy" = "https://github.com/sherif69-sa/DevS69-sdetkit/blob/main/docs/versioning-and-support.md"
+
+[project.optional-dependencies]
+dev = [
+  "build==1.5.1",
+  "mypy==2.3.0",
+  "pre-commit==4.6.0",
+  "ruff==0.15.22",
+  "twine==6.2.0"
+]
+test = [
+  "hypothesis==6.156.6",
+  "pre-commit==4.6.0",
+  "PyYAML",
+  "pytest",
+  "pytest-asyncio",
+  "pytest-cov",
+  "pytest-xdist[psutil]"
+]
+docs = [
+  "mkdocs==1.6.1",
+  "mkdocs-material==9.7.7"
+]
+packaging = [
+  "build==1.5.1",
+  "check-wheel-contents==0.6.3",
+  "twine==6.2.0"
+]
+telegram = [
+  "python-telegram-bot>=22.7,<23"
+]
+whatsapp = [
+  "twilio>=9.10.9,<10"
+]
+
+[tool.setuptools]
+
+[tool.setuptools.package-dir]
+"" = "src"
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+extend-exclude = ["templates/platform_problem/rich"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+ignore = ["E501"]
+
+[tool.ruff.lint.per-file-ignores]
+"src/sitecustomize.py" = ["UP017"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+line-ending = "lf"
+
+[tool.mypy]
+python_version = "3.10"
+warn_unused_configs = true
+warn_return_any = true
+no_implicit_optional = true
+strict_equality = true
+check_untyped_defs = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+ignore_missing_imports = true
+
+[[tool.mypy.overrides]]
+module = "httpx"
+ignore_missing_imports = true
+
+[[tool.mypy.overrides]]
+module = "httpx.*"
+ignore_missing_imports = true
+
+[[tool.mypy.overrides]]
+module = [
+  "sdetkit.*"
+]
+ignore_errors = true
+
+[[tool.mypy.overrides]]
+module = [
+  "sdetkit.diagnostic_job",
+  "sdetkit.diagnostic_worker_trajectory",
+  "sdetkit.failure_vector",
+  "sdetkit.safety_gate",
+]
+ignore_errors = false
+
+[[tool.mypy.overrides]]
+module = [
+  "sdetkit.failure_vector_adapters",
+  "sdetkit.failure_vector_cpp",
+]
+ignore_errors = false
+
+[[tool.mypy.overrides]]
+module = "sdetkit.workspace_failure_ownership"
+ignore_errors = false
+
+[[tool.mypy.overrides]]
+module = "sdetkit.mixed_monorepo_operator_proof"
+ignore_errors = false
+
+[[tool.mypy.overrides]]
+module = "sdetkit.cpp_operator_proof"
+ignore_errors = false
+
+[[tool.mypy.overrides]]
+module = "sdetkit.merge_readiness"
+ignore_errors = false
+
+[[tool.mypy.overrides]]
+module = "sdetkit.protected_proof_chain"
+ignore_errors = false
+
+[[tool.mypy.overrides]]
+module = [
+  "sdetkit.diagnostic_execution_plan",
+  "sdetkit.trajectory_store",
+]
+ignore_errors = false
+
+[[tool.mypy.overrides]]
+module = [
+  "sdetkit.adoption_proof_recommendations",
+  "sdetkit.adoption_repo_topology",
+]
+ignore_errors = false
+
+[[tool.mypy.overrides]]
+module = "sdetkit.adoption_surface.jenkins"
+ignore_errors = false
+
+[[tool.mypy.overrides]]
+module = [
+  "sdetkit.adoption_surface.cpp",
+  "sdetkit.adoption_surface.cpp_quality_security",
+]
+ignore_errors = false
+
+[[tool.mypy.overrides]]
+module = "sdetkit.adoption_surface.javascript_security"
+ignore_errors = false
+
+[[tool.mypy.overrides]]
+module = "sdetkit.adoption_surface.java_security"
+ignore_errors = false
+
+[[tool.mypy.overrides]]
+module = [
+  "sdetkit.adoption_evidence_bundle",
+  "sdetkit.adoption_external_integration",
+]
+ignore_errors = false
+
+[[tool.mypy.overrides]]
+module = [
+  "sdetkit.adoption_learning",
+  "sdetkit.adoption_public_repo_trial_matrix_report",
+]
+ignore_errors = false
+
+[[tool.mypy.overrides]]
+module = [
+  "sdetkit._pr_quality_required_terminal_checks",
+  "sdetkit._pr_quality_required_terminal_merge",
+  "sdetkit._pr_quality_required_terminal_records",
+  "sdetkit._pr_quality_required_terminal_snapshot",
+  "sdetkit.pr_quality_required_terminal",
+]
+ignore_errors = false
+
+[tool.mutmut]
+paths_to_mutate = ["src/sdetkit"]
+tests_dir = ["tests"]
+runner = "PYTHONPATH=src pytest -q --ignore=mutants"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-m 'not network'"
+markers = [
+  "network: allow real network access for this test",
+]
+
+[tool.pip_audit]
+ignore-vulns = ["CVE-2026-1703", "CVE-2026-4539"]
+
+[project.scripts]
+sdetkit = "sdetkit.cli:main"
+sdkit = "sdetkit.cli:main"
+kvcli = "sdetkit._entrypoints:kvcli"
+apigetcli = "sdetkit._entrypoints:apigetcli"
+sdetkit-test-bootstrap-contract = "sdetkit.test_bootstrap_contract:main"
+sdetkit-test-bootstrap-validate = "sdetkit.test_bootstrap_validate:main"
+sdetkit-diagnostic-queue-runner = "sdetkit.diagnostic_queue_runner_cli:main"
+sdetkit-local-diagnostic-queue-dashboard = "sdetkit.local_diagnostic_queue_dashboard:main"
+sdetkit-adoption-learning-report-dashboard = "sdetkit.adoption_learning_report_dashboard:main"
+sdetkit-maintenance-queue-rollup-dashboard = "sdetkit.maintenance_queue_rollup_dashboard:main"
+
+[project.entry-points."sdetkit.notify_adapters"]
+stdout = "sdetkit.notify_plugins:stdout_adapter"
+telegram = "sdetkit.notify_plugins:telegram_adapter"
+whatsapp = "sdetkit.notify_plugins:whatsapp_adapter"
+
+[project.entry-points."sdetkit.ops_tasks"]
+[tool.setuptools.package-data]
+sdetkit = ["public_command_surface.json", "data/*.json"]

sdetkit-1.2.0/src/sdetkit/__init__.py

@@ -0,0 +1,45 @@
+"""Top-level package exports and compatibility lazy-imports."""
+
+from __future__ import annotations
+
+import importlib
+from types import ModuleType
+
+_SUBPACKAGES = (
+    "readiness",
+    "phases",
+    "evidence",
+    "intelligence",
+    "cli",
+    "core",
+    "gates",
+    "ops",
+    "utils",
+)
+
+_ALIAS_MAP = {
+    "gate": "sdetkit.gates.gate",
+    "security_gate": "sdetkit.gates.security_gate",
+    "playbooks_cli": "sdetkit.cli.playbooks_cli",
+    "playbook_post": "sdetkit.cli.playbook_post",
+    "serve": "sdetkit.cli.serve",
+    "review_engine": "sdetkit.intelligence.review_engine",
+    "review": "sdetkit.intelligence.review",
+}
+
+
+def __getattr__(name: str) -> ModuleType:
+    candidates = [_ALIAS_MAP.get(name, f"sdetkit.{name}")]
+    candidates.extend(f"sdetkit.{subpackage}.{name}" for subpackage in _SUBPACKAGES)
+    last_error: ModuleNotFoundError | None = None
+    for module_name in candidates:
+        try:
+            module = importlib.import_module(module_name)
+        except ModuleNotFoundError as exc:
+            if exc.name != module_name:
+                raise
+            last_error = exc
+            continue
+        globals()[name] = module
+        return module
+    raise AttributeError(name) from last_error