solvapay-python 0.9.2__tar.gz → 0.9.3__tar.gz

{solvapay_python-0.9.2 → solvapay_python-0.9.3}/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.9.3] — 2026-06-07
+
+### Features
+
+- **Layer DAG now hard-enforced via single layered `import-linter` contract.** `tools/importlinter.cfg` replaces three sparse `forbidden` contracts with one `type = layers` contract covering the full HLD §V1.1 DAG (`_transport → _http → models → operations → client → paywall|webhooks → adapters → fastapi|langchain`). Closes the L2 `models` purity gap and the L5 `paywall`/`webhooks` framework-neutrality gap. `exhaustive = true` flags any new top-level module that ships without an explicit layer assignment. `ignore_type_checking_imports = true` strips `TYPE_CHECKING` blocks from the graph so cross-layer type hints do not trip the gate. CI-only change; no public-API impact.
+
+
 ## [0.9.2] — 2026-06-06
 
 ### Features

{solvapay_python-0.9.2 → solvapay_python-0.9.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: solvapay-python
-Version: 0.9.2
+Version: 0.9.3
 Summary: Community Python SDK for SolvaPay (agent-native payment rails)
 Project-URL: Homepage, https://github.com/dhruv-sanan/solvapay-python
 Project-URL: Issues, https://github.com/dhruv-sanan/solvapay-python/issues
@@ -359,12 +359,15 @@ Default is `"2026-05-22"` (v0.9 ship date). Bump only on major SDK versions.
 | v0.9 ✅ | Production polish — API-version pinning, idempotency TTL, `RetryTransport`, `RecordingTransport`, ASGI adapter, secret rotation, `sign_webhook`, contract tests, lint automation, MkDocs site, supply-chain hygiene |
 | v0.9.1 ✅ | Security & supply-chain quality — PyPI attestations (PEP 740 / Sigstore), CycloneDX SBOM on releases, `bandit` + `osv-scanner` CI, Hypothesis-driven secret-redaction property tests, constant-time `verify_webhook` smoke test, explicit PCI-scope statement |
 | v0.9.2 ✅ | Performance & stability quality — cold-import baseline harness, PEP 562 lazy adapter imports, `solvapay.sign_webhook` top-level re-export, microbenchmark harness (`solvapay[bench]`), troubleshooting docs |
+| v0.9.3 ✅ | Layer DAG hard-enforcement — single `type = layers` `import-linter` contract replaces three sparse `forbidden` contracts; closes the L2 `models` purity gap and the L5 `paywall`/`webhooks` framework-neutrality gap; `exhaustive = true` flags any unlayered top-level module; `ignore_type_checking_imports = true` keeps cross-layer type hints lint-clean |
 | v1.0 | Gated on founder signal — OpenAPI-generated models, WSGI/Lambda adapters, V2 planning |
 
 ---
 
 ## Status
 
+**v0.9.3** — Layer DAG hard-enforcement quality patch. `tools/importlinter.cfg` now ships a single `type = layers` contract covering the full HLD §V1.1 DAG (`_transport → _http → models → operations → client → paywall|webhooks → adapters → fastapi|langchain`), replacing three sparse `forbidden` contracts. `exhaustive = true` flags any new top-level module that ships without an explicit layer assignment; `ignore_type_checking_imports = true` strips `TYPE_CHECKING` blocks from the dependency graph so cross-layer type hints do not trip the gate. New `tests/test_layer_dag.py` shells the contract from pytest as a belt-and-suspenders gate. `docs/architecture/layers.md` refreshed. CI-only change; no public-API impact. 306 tests. 87% line coverage. `mypy --strict` clean (45 files).
+
 **v0.9.2** — Performance & stability quality patch. Cold-import baseline harness (`tests/test_cold_import.py`, 1.5x regression gate). PEP 562 lazy adapter imports — bare `import solvapay` no longer loads framework adapter modules. `solvapay.sign_webhook` promoted to top-level (alongside `verify_webhook`). Microbenchmark harness under `tests/benchmarks/` (opt-in `solvapay[bench]`). New docs: `docs/troubleshooting.md` (top-10 errors) and `docs/architecture/cold-start.md`. 305 tests. 87% line coverage. `mypy --strict` clean (45 files).
 
 **v0.9.1** — Security & supply-chain quality patch. PyPI uploads now carry PEP 740 attestations (Sigstore-backed via OIDC trusted publishing); each GitHub release ships a CycloneDX SBOM (`sbom.cdx.json`). `mypy --strict` clean (45 files). 302 tests. 87% line / 85% branch coverage.

{solvapay_python-0.9.2 → solvapay_python-0.9.3}/README.md

@@ -321,12 +321,15 @@ Default is `"2026-05-22"` (v0.9 ship date). Bump only on major SDK versions.
 | v0.9 ✅ | Production polish — API-version pinning, idempotency TTL, `RetryTransport`, `RecordingTransport`, ASGI adapter, secret rotation, `sign_webhook`, contract tests, lint automation, MkDocs site, supply-chain hygiene |
 | v0.9.1 ✅ | Security & supply-chain quality — PyPI attestations (PEP 740 / Sigstore), CycloneDX SBOM on releases, `bandit` + `osv-scanner` CI, Hypothesis-driven secret-redaction property tests, constant-time `verify_webhook` smoke test, explicit PCI-scope statement |
 | v0.9.2 ✅ | Performance & stability quality — cold-import baseline harness, PEP 562 lazy adapter imports, `solvapay.sign_webhook` top-level re-export, microbenchmark harness (`solvapay[bench]`), troubleshooting docs |
+| v0.9.3 ✅ | Layer DAG hard-enforcement — single `type = layers` `import-linter` contract replaces three sparse `forbidden` contracts; closes the L2 `models` purity gap and the L5 `paywall`/`webhooks` framework-neutrality gap; `exhaustive = true` flags any unlayered top-level module; `ignore_type_checking_imports = true` keeps cross-layer type hints lint-clean |
 | v1.0 | Gated on founder signal — OpenAPI-generated models, WSGI/Lambda adapters, V2 planning |
 
 ---
 
 ## Status
 
+**v0.9.3** — Layer DAG hard-enforcement quality patch. `tools/importlinter.cfg` now ships a single `type = layers` contract covering the full HLD §V1.1 DAG (`_transport → _http → models → operations → client → paywall|webhooks → adapters → fastapi|langchain`), replacing three sparse `forbidden` contracts. `exhaustive = true` flags any new top-level module that ships without an explicit layer assignment; `ignore_type_checking_imports = true` strips `TYPE_CHECKING` blocks from the dependency graph so cross-layer type hints do not trip the gate. New `tests/test_layer_dag.py` shells the contract from pytest as a belt-and-suspenders gate. `docs/architecture/layers.md` refreshed. CI-only change; no public-API impact. 306 tests. 87% line coverage. `mypy --strict` clean (45 files).
+
 **v0.9.2** — Performance & stability quality patch. Cold-import baseline harness (`tests/test_cold_import.py`, 1.5x regression gate). PEP 562 lazy adapter imports — bare `import solvapay` no longer loads framework adapter modules. `solvapay.sign_webhook` promoted to top-level (alongside `verify_webhook`). Microbenchmark harness under `tests/benchmarks/` (opt-in `solvapay[bench]`). New docs: `docs/troubleshooting.md` (top-10 errors) and `docs/architecture/cold-start.md`. 305 tests. 87% line coverage. `mypy --strict` clean (45 files).
 
 **v0.9.1** — Security & supply-chain quality patch. PyPI uploads now carry PEP 740 attestations (Sigstore-backed via OIDC trusted publishing); each GitHub release ships a CycloneDX SBOM (`sbom.cdx.json`). `mypy --strict` clean (45 files). 302 tests. 87% line / 85% branch coverage.

solvapay_python-0.9.3/docs/architecture/layers.md

@@ -0,0 +1,84 @@
+# Layer Architecture (HLD V1.1)
+
+The SDK is organized into strict layers. Each layer may only import from layers below it.
+Violations fail CI via `import-linter` (see `tools/importlinter.cfg`).
+
+From **v0.9.3** the DAG is enforced as a single `type = layers` contract, replacing the
+earlier three sparse `forbidden` contracts. `exhaustive = true` flags any new top-level
+module that ships without an explicit layer assignment.
+
+## Layer DAG
+
+```
+L7  solvapay.fastapi           — Top-level adapter shims (re-export from L6.adapters.*)
+    solvapay.langchain
+L6  solvapay.adapters          — Framework adapters (MCP, LangChain, ASGI, FastAPI)
+L5  solvapay.paywall           — Paywall / AsyncPaywall primitives
+    solvapay.webhooks          — Webhook verify + pipeline
+L4  solvapay.client            — SolvaPay / AsyncSolvaPay public facades
+    solvapay._async_client
+L3  solvapay.operations        — Resource namespace operations (sv.customers.ensure etc.)
+L2  solvapay.models            — Pydantic request/response models
+L1  solvapay._http             — HTTP-client wrapper around the transport kernel
+L0  solvapay._transport        — Transport Protocol + httpx impl + middleware
+```
+
+> **Note.** The HLD ships an aspirational L1 `_wire` slot that is currently unused.
+> The shipped layout uses L1 for `_http` (the existing transport-kernel wrapper).
+> When `_wire` ships, it will sit between `_transport` and `_http`.
+
+## Allowed imports
+
+A module at L_n may import from any module at L_(n-1) or below, plus the layer-independent
+leaf modules (`exceptions`, `_stability`, `_config`, `idempotency`, `events`, `paywall_state`).
+
+| Layer | May import |
+|-------|------------|
+| L0 `_transport` | stdlib, httpx, leaf modules |
+| L1 `_http` | L0 + leaf modules |
+| L2 `models` | stdlib, pydantic, leaf modules |
+| L3 `operations` | L0–L2 + leaf modules |
+| L4 `client` / `_async_client` | L0–L3 + leaf modules |
+| L5 `paywall` / `webhooks` | L0–L4 + leaf modules |
+| L6 `adapters` | L0–L5 + leaf modules |
+| L7 `fastapi` / `langchain` (top-level shims) | L0–L6 + leaf modules |
+| `tests/` | everything (permissive; tests live outside the `solvapay` container) |
+
+Sibling modules on the same row (e.g. `paywall` ↔ `webhooks`, or `client` ↔ `_async_client`)
+may not import each other. Each is independently constrained against the layers below.
+
+## Why L7 = stability tier, not function (DG2 lock)
+
+`solvapay.experimental` (reserved for v1.0) groups features by **stability**, not by
+domain. A webhook adapter that is still unstable lives in L6 (adapters) while it's being
+proven, then graduates to the canonical path once stable. This prevents the
+`experimental` namespace from becoming a permanent home for half-finished features.
+
+## Leaf modules (layer-independent)
+
+These are listed in `exhaustive_ignores` in the contract because they have no upward edges
+and no downward consumers beyond the boundary primitives:
+
+- `solvapay.exceptions`
+- `solvapay._stability`
+- `solvapay._config`
+- `solvapay.idempotency`
+- `solvapay.events`
+- `solvapay.paywall_state`
+
+## TYPE_CHECKING imports
+
+The contract sets `ignore_type_checking_imports = true`. Imports inside `if TYPE_CHECKING:`
+blocks are stripped from the dependency graph, so cross-layer type hints (e.g.
+`from solvapay.client import SolvaPay` for annotation purposes) do not trip the gate.
+`mypy` still resolves these via the standard `from __future__ import annotations`
+pattern enforced by `tools/lint_invariants.py`.
+
+## Enforcement
+
+```bash
+~/.local/bin/uv run lint-imports --config tools/importlinter.cfg
+```
+
+Runs in CI on every push and PR. Also wrapped by `tests/test_layer_dag.py` so the
+contract is exercised by `pytest` for local feedback.

{solvapay_python-0.9.2 → solvapay_python-0.9.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "solvapay-python"
-version = "0.9.2"
+version = "0.9.3"
 description = "Community Python SDK for SolvaPay (agent-native payment rails)"
 readme = "README.md"
 license = { text = "MIT" }

{solvapay_python-0.9.2 → solvapay_python-0.9.3}/src/solvapay/__init__.py

@@ -109,7 +109,7 @@ __all__ = [
     "stable",
     "verify_webhook",
 ]
-__version__ = "0.9.2"
+__version__ = "0.9.3"
 
 # PEP 562 — lazy adapter submodule access.
 # Adapters drag in optional heavy deps (fastmcp, langchain-core, fastapi).

solvapay_python-0.9.3/tests/_baselines/cold_import.json

@@ -0,0 +1 @@
+{"darwin": 99.82}

solvapay_python-0.9.3/tests/test_cold_import.py

@@ -0,0 +1,92 @@
+"""Cold-import baseline harness.
+
+Measures ``python -X importtime -c "import solvapay"`` and compares against
+a committed per-platform baseline.
+
+Behaviour:
+- **CI** (``CI=true`` env var set by GitHub Actions): always prints the
+  measurement; never fails. GitHub runners have no persistent baseline across
+  fresh checkouts, so asserting would produce false failures on every run.
+- **Local**: writes a per-platform baseline on first run; subsequent runs assert
+  within 1.5x. Catches cold-import regressions introduced during development.
+
+Platform keys: ``sys.platform`` (``darwin``, ``linux``, ``win32``).
+The hard <200 ms CI gate is a v1.0 feature (HLD §V1.20); v0.9.2 measures only.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import re
+import subprocess
+import sys
+from pathlib import Path
+
+BASELINE_PATH = Path(__file__).parent / "_baselines" / "cold_import.json"
+BASELINE_PATH.parent.mkdir(exist_ok=True)
+REGRESSION_FACTOR = 1.5
+PLATFORM = sys.platform  # e.g. "darwin", "linux", "win32"
+IN_CI = os.environ.get("CI", "").lower() in ("true", "1")
+
+
+def _measure_import_ms() -> float:
+    result = subprocess.run(
+        [sys.executable, "-X", "importtime", "-c", "import solvapay"],
+        capture_output=True,
+        text=True,
+    )
+    # importtime writes to stderr.
+    # Each line: "import time:  <self_us> | <cumulative_us> | <module>"
+    lines = [ln for ln in result.stderr.splitlines() if "import time:" in ln]
+    if not lines:
+        raise RuntimeError(f"No importtime output captured.\nstderr:\n{result.stderr}")
+    # The outermost module (solvapay) has the highest cumulative value.
+    cumulative_us = max(
+        int(m.group(1)) for ln in lines if (m := re.search(r"import time:\s+\d+\s+\|\s+(\d+)", ln))
+    )
+    return cumulative_us / 1000.0  # µs → ms
+
+
+def test_cold_import_baseline() -> None:
+    """Measure cold-import time. Assert vs baseline locally; print-only in CI."""
+    current_ms = _measure_import_ms()
+
+    if IN_CI:
+        # CI has no persistent state; just report the number.
+        print(f"\n[cold-import] CI platform={PLATFORM} current={current_ms:.1f} ms (no assertion)")
+        assert current_ms < 2000, (
+            f"Cold-import took {current_ms:.0f} ms — suspiciously slow even for CI"
+        )
+        return
+
+    # Local: per-platform baseline regression gate.
+    baselines: dict[str, float] = {}
+    if BASELINE_PATH.exists():
+        raw = json.loads(BASELINE_PATH.read_text())
+        # Support legacy flat format {"cold_import_ms": X}.
+        if "cold_import_ms" in raw and not any(k in raw for k in ("darwin", "linux", "win32")):
+            baselines = {PLATFORM: raw["cold_import_ms"]}
+        else:
+            baselines = raw
+
+    if PLATFORM not in baselines:
+        assert current_ms < 2000, (
+            f"Cold-import took {current_ms:.0f} ms on first run — suspiciously slow"
+        )
+        baselines[PLATFORM] = round(current_ms, 2)
+        BASELINE_PATH.write_text(json.dumps(baselines, sort_keys=True))
+        print(f"\n[cold-import] {PLATFORM} baseline written: {current_ms:.1f} ms")
+        return
+
+    baseline_ms: float = baselines[PLATFORM]
+    limit_ms = baseline_ms * REGRESSION_FACTOR
+
+    print(
+        f"\n[cold-import] platform={PLATFORM} current={current_ms:.1f} ms  "
+        f"baseline={baseline_ms:.1f} ms  limit={limit_ms:.1f} ms"
+    )
+    assert current_ms <= limit_ms, (
+        f"Cold-import regression on {PLATFORM}: {current_ms:.1f} ms > {limit_ms:.1f} ms "
+        f"(baseline={baseline_ms:.1f} ms x {REGRESSION_FACTOR})"
+    )

solvapay_python-0.9.3/tests/test_layer_dag.py

@@ -0,0 +1,35 @@
+"""Belt-and-suspenders enforcement of the HLD §V1.1 layer DAG.
+
+The primary gate is the CI step that runs ``lint-imports`` directly. This
+test shells out to the same command so that ``pytest`` also fails locally
+if someone introduces an upward import without re-running ``lint-imports``.
+"""
+
+from __future__ import annotations
+
+import shutil
+import subprocess
+from pathlib import Path
+
+import pytest
+
+REPO_ROOT = Path(__file__).resolve().parent.parent
+CONFIG = REPO_ROOT / "tools" / "importlinter.cfg"
+
+
+def test_layered_dag_contract_holds() -> None:
+    lint_imports = shutil.which("lint-imports")
+    if lint_imports is None:
+        pytest.skip("lint-imports not on PATH; CI runs it directly")
+    result = subprocess.run(
+        [lint_imports, "--config", str(CONFIG)],
+        cwd=REPO_ROOT,
+        capture_output=True,
+        text=True,
+        check=False,
+    )
+    assert result.returncode == 0, (
+        f"lint-imports failed (rc={result.returncode}).\n"
+        f"stdout:\n{result.stdout}\n"
+        f"stderr:\n{result.stderr}"
+    )

solvapay_python-0.9.3/tools/importlinter.cfg

@@ -0,0 +1,32 @@
+[importlinter]
+root_package = solvapay
+include_external_packages = False
+# TYPE_CHECKING blocks vanish from the import graph; cross-layer type hints
+# do not trip the layered DAG check below. mypy still sees them via the
+# `from __future__ import annotations` + `TYPE_CHECKING:` pattern.
+ignore_type_checking_imports = True
+
+[importlinter:contract:layered-dag]
+name = solvapay layer DAG (HLD V1.1)
+type = layers
+exhaustive = true
+exhaustive_ignores =
+    exceptions
+    _stability
+    _config
+    idempotency
+    events
+    paywall_state
+layers =
+    fastapi | langchain
+    adapters
+    paywall | webhooks
+    client | _async_client
+    operations
+    models
+    _http
+    _transport
+containers =
+    solvapay
+ignore_imports =
+    solvapay.paywall.state -> solvapay.paywall_state

{solvapay_python-0.9.2 → solvapay_python-0.9.3}/uv.lock

@@ -2003,6 +2003,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
 ]
 
+[[package]]
+name = "py-cpuinfo"
+version = "9.0.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/37/a8/d832f7293ebb21690860d2e01d8115e5ff6f2ae8bbdc953f0eb0fa4bd2c7/py-cpuinfo-9.0.0.tar.gz", hash = "sha256:3cdbbf3fac90dc6f118bfd64384f309edeadd902d7c8fb17f02ffa1fc3f49690", size = 104716, upload-time = "2022-10-25T20:38:06.303Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e0/a9/023730ba63db1e494a271cb018dcd361bd2c917ba7004c3e49d5daf795a2/py_cpuinfo-9.0.0-py3-none-any.whl", hash = "sha256:859625bc251f64e21f077d099d4162689c762b5d6a4c3c97553d56241c9674d5", size = 22335, upload-time = "2022-10-25T20:38:27.636Z" },
+]
+
 [[package]]
 name = "py-key-value-aio"
 version = "0.4.4"
@@ -2291,6 +2300,19 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/e5/35/f8b19922b6a25bc0880171a2f1a003eaeb93657475193ab516fd87cac9da/pytest_asyncio-1.3.0-py3-none-any.whl", hash = "sha256:611e26147c7f77640e6d0a92a38ed17c3e9848063698d5c93d5aa7aa11cebff5", size = 15075, upload-time = "2025-11-10T16:07:45.537Z" },
 ]
 
+[[package]]
+name = "pytest-benchmark"
+version = "5.2.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "py-cpuinfo" },
+    { name = "pytest" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/24/34/9f732b76456d64faffbef6232f1f9dbec7a7c4999ff46282fa418bd1af66/pytest_benchmark-5.2.3.tar.gz", hash = "sha256:deb7317998a23c650fd4ff76e1230066a76cb45dcece0aca5607143c619e7779", size = 341340, upload-time = "2025-11-09T18:48:43.215Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/33/29/e756e715a48959f1c0045342088d7ca9762a2f509b945f362a316e9412b7/pytest_benchmark-5.2.3-py3-none-any.whl", hash = "sha256:bc839726ad20e99aaa0d11a127445457b4219bdb9e80a1afc4b51da7f96b0803", size = 45255, upload-time = "2025-11-09T18:48:39.765Z" },
+]
+
 [[package]]
 name = "pytest-cov"
 version = "7.1.0"
@@ -2692,7 +2714,7 @@ wheels = [
 
 [[package]]
 name = "solvapay-python"
-version = "0.9.1"
+version = "0.9.3"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },
@@ -2700,6 +2722,9 @@ dependencies = [
 ]
 
 [package.optional-dependencies]
+bench = [
+    { name = "pytest-benchmark" },
+]
 fastapi = [
     { name = "fastapi" },
 ]
@@ -2742,9 +2767,10 @@ requires-dist = [
     { name = "httpx", specifier = ">=0.27,<0.29" },
     { name = "langchain-core", marker = "extra == 'langchain'", specifier = ">=0.3,<1.5" },
     { name = "pydantic", specifier = ">=2.6,<2.14" },
+    { name = "pytest-benchmark", marker = "extra == 'bench'", specifier = ">=4.0,<6" },
     { name = "tenacity", marker = "extra == 'retry'", specifier = ">=8.2,<10" },
 ]
-provides-extras = ["fastapi", "langchain", "mcp", "asgi", "retry"]
+provides-extras = ["fastapi", "langchain", "mcp", "asgi", "retry", "bench"]
 
 [package.metadata.requires-dev]
 dev = [

solvapay_python-0.9.2/docs/architecture/layers.md

@@ -1,46 +0,0 @@
-# Layer Architecture (HLD V1.1)
-
-The SDK is organized into strict layers. Each layer may only import from layers below it.
-Violations fail CI via `import-linter` (see `tools/importlinter.cfg`).
-
-## Layer DAG
-
-```
-L0  solvapay._transport      — Transport Protocol + httpx impl + middleware
-L1  solvapay._wire           — Wire codec (reserved; currently unused)
-L2  solvapay.models          — Pydantic request/response models
-L3  solvapay.operations      — Resource namespace operations (sv.customers.ensure etc.)
-L4  solvapay.client          — SolvaPay / AsyncSolvaPay public facades
-    solvapay._async_client
-L5  solvapay.paywall         — Paywall / AsyncPaywall primitives
-    solvapay.webhooks        — Webhook verify + pipeline
-L6  solvapay.adapters        — Framework adapters (MCP, LangChain, ASGI)
-L7  solvapay.experimental    — Experimental features (reserved)
-L8  tests/                   — Test suite (permissive; may import L0–L7)
-```
-
-## Allowed imports
-
-| Layer | May import |
-|-------|-----------|
-| L0 `_transport` | stdlib, httpx, `exceptions` |
-| L1 `_wire` | L0 |
-| L2 `models` | stdlib, pydantic |
-| L3 `operations` | L0, L1, L2 |
-| L4 `client` | L0–L3, `_config`, `exceptions` |
-| L5 `paywall` | L0–L4 |
-| L5 `webhooks` | L0–L2, `exceptions` |
-| L6 `adapters` | L0–L5 |
-| L7 `experimental` | L0–L6 |
-| L8 `tests` | L0–L7 (no `from solvapay._*` outside `tests/internal/`) |
-
-## Why L7 = stability tier, not function (DG2 lock)
-
-`solvapay.experimental` groups features by **stability**, not by domain. A webhook adapter
-that is still unstable lives in L6 (adapters) while it's being proven, then graduates to
-the canonical path once stable. This prevents the "experimental" namespace from becoming a
-permanent home for half-finished features.
-
-## Enforcement
-
-`uv run lint-imports --config tools/importlinter.cfg` — run in CI on every push.

solvapay_python-0.9.2/tests/_baselines/cold_import.json

@@ -1 +0,0 @@
-{"cold_import_ms": 99.82}

solvapay_python-0.9.2/tests/test_cold_import.py

@@ -1,66 +0,0 @@
-"""Cold-import baseline harness.
-
-Runs ``python -X importtime -c "import solvapay"`` via subprocess, parses the
-highest cumulative time from the importtime output, and writes a baseline on
-first run. Subsequent runs assert the current time is within 1.5x the baseline.
-
-CI prints the absolute ms value so regressions are visible in the test name.
-The hard <200 ms gate is a v1.0 feature (HLD §V1.20); this only measures.
-"""
-
-from __future__ import annotations
-
-import json
-import re
-import subprocess
-import sys
-from pathlib import Path
-
-BASELINE_PATH = Path(__file__).parent / "_baselines" / "cold_import.json"
-BASELINE_PATH.parent.mkdir(exist_ok=True)
-REGRESSION_FACTOR = 1.5
-
-
-def _measure_import_ms() -> float:
-    result = subprocess.run(
-        [sys.executable, "-X", "importtime", "-c", "import solvapay"],
-        capture_output=True,
-        text=True,
-    )
-    # importtime writes to stderr.
-    # Each line: "import time:  <self_us> | <cumulative_us> | <module>"
-    lines = [ln for ln in result.stderr.splitlines() if "import time:" in ln]
-    if not lines:
-        raise RuntimeError(f"No importtime output captured.\nstderr:\n{result.stderr}")
-    # The outermost module (solvapay) has the highest cumulative value.
-    cumulative_us = max(
-        int(m.group(1)) for ln in lines if (m := re.search(r"import time:\s+\d+\s+\|\s+(\d+)", ln))
-    )
-    return cumulative_us / 1000.0  # µs → ms
-
-
-def test_cold_import_baseline() -> None:
-    """Measure cold-import time and assert within 1.5x of committed baseline."""
-    current_ms = _measure_import_ms()
-
-    if not BASELINE_PATH.exists():
-        # Sanity: import must complete in <2 s even on first run (no regression).
-        assert current_ms < 2000, (
-            f"Cold-import took {current_ms:.0f} ms on first run — suspiciously slow"
-        )
-        BASELINE_PATH.write_text(json.dumps({"cold_import_ms": round(current_ms, 2)}))
-        print(f"\n[cold-import] Baseline written: {current_ms:.1f} ms")
-        return
-
-    baseline = json.loads(BASELINE_PATH.read_text())
-    baseline_ms: float = baseline["cold_import_ms"]
-    limit_ms = baseline_ms * REGRESSION_FACTOR
-
-    print(
-        f"\n[cold-import] current={current_ms:.1f} ms  "
-        f"baseline={baseline_ms:.1f} ms  limit={limit_ms:.1f} ms"
-    )
-    assert current_ms <= limit_ms, (
-        f"Cold-import regression: {current_ms:.1f} ms > {limit_ms:.1f} ms "
-        f"(baseline={baseline_ms:.1f} ms x {REGRESSION_FACTOR})"
-    )

solvapay_python-0.9.2/tools/importlinter.cfg

@@ -1,42 +0,0 @@
-[importlinter]
-root_packages =
-    solvapay
-include_external_packages = True
-
-[importlinter:contract:no-upward-imports]
-name = Layer DAG — no upward imports (HLD V1.1)
-type = forbidden
-
-# L0: _transport must not import higher layers
-source_modules =
-    solvapay._transport
-forbidden_modules =
-    solvapay.client
-    solvapay._async_client
-    solvapay.paywall
-    solvapay.webhooks
-    solvapay.adapters
-    solvapay.operations
-
-[importlinter:contract:no-client-importing-adapters]
-name = Layer DAG — client (L4) must not import adapters (L6) or experimental (L7)
-type = forbidden
-
-source_modules =
-    solvapay.client
-    solvapay._async_client
-
-forbidden_modules =
-    solvapay.adapters
-    solvapay.experimental
-
-[importlinter:contract:operations-no-paywall]
-name = Layer DAG — operations (L3) must not import paywall (L5) or adapters (L6)
-type = forbidden
-
-source_modules =
-    solvapay.operations
-
-forbidden_modules =
-    solvapay.paywall
-    solvapay.adapters