cmpnd 0.76.0__tar.gz → 0.77.0__tar.gz

{cmpnd-0.76.0 → cmpnd-0.77.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: cmpnd
-Version: 0.76.0
+Version: 0.77.0
 Summary: DSPy observability and deployment SDK for cmpnd
 Project-URL: Homepage, https://cmpnd.ai
 Author-email: cmpnd <hello@cmpnd.ai>

{cmpnd-0.76.0 → cmpnd-0.77.0}/cmpnd/identity.py

@@ -1,9 +1,10 @@
 """Identity and hash computations.
 
-The 64-bit program-identity hash is produced by the structural IR in
+A program's identity is its server-issued program id (``is_program_id``).
+The 64-bit program signature hash is produced by the structural IR in
 :mod:`cmpnd.ir`. ``compute_program_hash`` reflects a live ``dspy.Module``
-through that pipeline; trace, eval, and optimization paths share the
-one encoder.
+through that pipeline, and ``program_naming`` uses the hash only to
+generate a name for a program its user never named.
 
 Sibling hashes (``compute_signature_hash`` for model-sweep grouping,
 ``compute_valset_hash``, ``compute_dataset_hash``, ``compute_metric_hash``,
@@ -84,10 +85,9 @@ def _unsigned_to_signed_int64(value: int) -> int:  # pyright: ignore[reportUnuse
     Written as arithmetic rather than as ``ctypes.c_int64(value).value``, which
     is the identical operation spelled with a C type: mask to 64 bits, then
     subtract 2^64 from anything at or above the sign bit. ``ctypes`` is not
-    merely heavy for a two-line cast, it is *absent* where this has to run — the
-    wasm guest (`worker-wasm/guest/`) imports this module to reproduce the SDK's
-    ``program_signature_hash``, and its CPython has no ``_ctypes`` because there
-    is no libffi for wasi, so the module was never compiled. Equivalence with
+    merely heavy for a two-line cast, it is *absent* from the worker's wasm
+    kernel (`worker-wasm/guest/`), which imports this module, and whose CPython
+    has no ``_ctypes`` because there is no libffi for wasi. Equivalence with
     the ctypes form is asserted over every boundary in ``tests/test_identity.py``.
 
     Imported by ``cmpnd.ir.hash`` and exercised by ``tests/test_identity.py``;
@@ -156,8 +156,9 @@ def validate_program_id(value: object, *, source: str = "program_id") -> str:
 def compute_program_hash(module: Any) -> int | None:
     """Reflect a live ``dspy.Module`` to IR and hash it.
 
-    Returns ``None`` when ``module`` is ``None`` (callers commonly fold
-    this with ``or 0`` for trace-side DEFAULT-0 columns).
+    Returns ``None`` when ``module`` is ``None``. The worker's kernel does not
+    bundle :mod:`cmpnd.ir`, so this raises ``ModuleNotFoundError`` there; the
+    kernel generates no program names, so it never calls this.
     """
     if module is None:
         return None

{cmpnd-0.76.0 → cmpnd-0.77.0}/docs/sdk-instrumentation.md

@@ -146,7 +146,7 @@ optimization run name their program by `program_id`.
 [`CLUSTERING.md`](../../docs/CLUSTERING.md) explains how the hash is computed.
 
 - **On a span** — `_capture_module_attributes` in `callback.py` walks `instance.signature.input_fields` / `output_fields` and records names, types, descriptions and schemas. It reflects nothing, because a span never names a program.
-- **On a trace** — `_create_trace` in `callback.py` records the root signature, or for a composite module the `dspy.Predict` children's signatures as `component_signatures`. A root module call that names no program reflects the module once, for the name the SDK generates (`program_naming.generated_program_name`). The hash goes into that name and nowhere else.
+- **On a trace** — `_create_trace` in `callback.py` records the root signature, or for a composite module the `dspy.Predict` children's signatures as `component_signatures`. A root module call that names no program reflects the module once, for the name the SDK generates (`program_naming.generated_program_name`). The hash goes into that name and nowhere else. The worker's kernel replaces that function with one that generates no name, so a kernel never reflects a module.
 
 `python-sdk/cmpnd/identity.py` is the home of every hash the SDK computes.
 
@@ -1035,7 +1035,7 @@ A new hand-rolled serializer on any of those paths reopens the hole. `tests/test
 
 ## See also
 
-- [`./clustering.md`](../../docs/CLUSTERING.md) — the canonical explainer for `signature_hash`. Start here if you're wondering why two identical-looking modules have different hashes. A hash never decides a trace's program.
+- [`CLUSTERING.md`](../../docs/CLUSTERING.md) explains how traces and runs group under a program, and how the program signature hash is computed. A hash never decides a trace's program.
 - [`./optimization-tracking.md`](../../docs/optimization-tracking.md) — how `auto_instrument`'s GEPA patch and `cmpnd/optimizers/tracker.py` turn a `GEPA.compile` call into an `OptimizationRun` with linked evals.
 - The `cmpnd-testing` skill + [`../AGENTS.md`](../AGENTS.md) § "Running Tests & Checks" — patterns for writing callback tests against real databases, including `clear_context()` usage.
 - [`serve/DB.md`](../../serve/DB.md) — the Postgres schema these payloads land in.

{cmpnd-0.76.0 → cmpnd-0.77.0}/pyproject.toml

@@ -5,7 +5,7 @@ name = "cmpnd"
 # it's new) — no git tags. Bump with `uv version --bump {minor,patch}` or by
 # hand. Runtime `cmpnd.__version__` reads installed metadata, so it tracks
 # this automatically. See docs/plans/2026-07-02-sdk-pypi-tag-free-publish.md.
-version = "0.76.0"
+version = "0.77.0"
 description = "DSPy observability and deployment SDK for cmpnd"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -41,7 +41,7 @@ dependencies = [
     # Still required, and still the fast path — but `cmpnd/ir/xxh64.py` no
     # longer *needs* it: it falls back to a pure-Python xxh64 that the tests
     # check against this module, so a platform with no wheel and no compiler can
-    # still compute a program's identity. Don't drop the dependency on that
+    # still compute a program's signature hash. Don't drop the dependency on that
     # basis; the C module is an order of magnitude faster and every ordinary
     # install should have it.
     "xxhash>=3.0.0",

{cmpnd-0.76.0 → cmpnd-0.77.0}/uv.lock

@@ -505,7 +505,7 @@ wheels = [
 
 [[package]]
 name = "cmpnd"
-version = "0.76.0"
+version = "0.77.0"
 source = { editable = "." }
 default-groups = ["dspy-3-4-1"]
 dependencies = [