dominus-sdk-python 9.0.12__tar.gz → 9.0.13__tar.gz

{dominus_sdk_python-9.0.12 → dominus_sdk_python-9.0.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 9.0.12
+Version: 9.0.13
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License-Expression: LicenseRef-Proprietary
@@ -38,8 +38,8 @@ Async Python SDK for the Dominus gateway-first service plane.
 ## Agent Guide
 
 Start with `docs/agent-guide/INDEX.md`. The current snapshot is
-`docs/agent-guide/2026-09-14-1300-sdk-python/00-reading-order.md`; the latest
-cleanup audit is `docs/janitor/2026-09-14-1300-sdk-python-cleanup-audit.md`.
+`docs/agent-guide/2026-09-19-1300-sdk-python/00-reading-order.md`; the latest
+cleanup audit is `docs/janitor/2026-09-19-1300-sdk-python-cleanup-audit.md`.
 
 ## What This Repo Ships
 
@@ -48,7 +48,7 @@ cleanup audit is `docs/janitor/2026-09-14-1300-sdk-python-cleanup-audit.md`.
 - Gateway-scoped client mode for MCP and other user-JWT sessions
 - Transport compatibility for wrapped `{success,data}` responses and unwrapped Warden/control-plane success objects
 - Local helpers for JWT verification, trace propagation, retries, and console capture
-- Current package version: `9.0.12`
+- Current package version: `9.0.13`
 
 ## Install
 

{dominus_sdk_python-9.0.12 → dominus_sdk_python-9.0.13}/README.md

@@ -5,8 +5,8 @@ Async Python SDK for the Dominus gateway-first service plane.
 ## Agent Guide
 
 Start with `docs/agent-guide/INDEX.md`. The current snapshot is
-`docs/agent-guide/2026-09-14-1300-sdk-python/00-reading-order.md`; the latest
-cleanup audit is `docs/janitor/2026-09-14-1300-sdk-python-cleanup-audit.md`.
+`docs/agent-guide/2026-09-19-1300-sdk-python/00-reading-order.md`; the latest
+cleanup audit is `docs/janitor/2026-09-19-1300-sdk-python-cleanup-audit.md`.
 
 ## What This Repo Ships
 
@@ -15,7 +15,7 @@ cleanup audit is `docs/janitor/2026-09-14-1300-sdk-python-cleanup-audit.md`.
 - Gateway-scoped client mode for MCP and other user-JWT sessions
 - Transport compatibility for wrapped `{success,data}` responses and unwrapped Warden/control-plane success objects
 - Local helpers for JWT verification, trace propagation, retries, and console capture
-- Current package version: `9.0.12`
+- Current package version: `9.0.13`
 
 ## Install
 

{dominus_sdk_python-9.0.12 → dominus_sdk_python-9.0.13}/dominus/__init__.py

@@ -191,7 +191,7 @@ from .errors import (
     TimeoutError as DominusTimeoutError,
 )
 
-__version__ = "9.0.12"
+__version__ = "9.0.13"
 __all__ = [
     # Main SDK instance
     "dominus",

{dominus_sdk_python-9.0.12 → dominus_sdk_python-9.0.13}/dominus/namespaces/authority.py

@@ -56,6 +56,11 @@ LIST_RUN_KIND = "workflow"
 #: top-level projection on the wire; this SDK never relies on that default.
 RESULT_VIEW_BOUND = "bound"
 
+#: Canonical coherent deploy read view. Authority still serves the legacy
+#: ``latest_deployment_*`` projection when ``view`` is omitted; this SDK never
+#: relies on that default, and carries no legacy fallback.
+DEPLOY_VIEW_COHERENT = "coherent"
+
 
 def remote_command_outcome(payload: Mapping[str, Any]) -> Dict[str, Any]:
     """Unwrap a canonical ``RemoteCommandResult`` to the remote outcome it carries.
@@ -72,6 +77,35 @@ def remote_command_outcome(payload: Mapping[str, Any]) -> Dict[str, Any]:
     return dict(payload)
 
 
+def coherent_deploy_state(payload: Mapping[str, Any]) -> Dict[str, Any]:
+    """Split a coherent deploy read into current state, labeled history, provenance.
+
+    A coherent read returns the deploy's one current rollout, its executor
+    history, and the provenance naming which rollout is current. This accessor
+    keeps that separation intact so history can never be read as current state:
+    ``current_rollout`` stays ``None`` when Authority reports the read as
+    partial (an unset or unresolvable ``current_rollout_id``), and the newest
+    history entry is never substituted for it. ``partial`` restates the
+    provenance flag for callers that branch on it.
+    """
+    envelope: Mapping[str, Any] = payload if isinstance(payload, Mapping) else {}
+    provenance = envelope.get("provenance")
+    provenance = dict(provenance) if isinstance(provenance, Mapping) else {}
+    current = envelope.get("current_rollout")
+    history = envelope.get("executor_history")
+    return {
+        "deploy": dict(envelope.get("deploy") or {}),
+        "current_rollout": dict(current) if isinstance(current, Mapping) else None,
+        "executor_history": (
+            [dict(row) for row in history if isinstance(row, Mapping)]
+            if isinstance(history, list)
+            else []
+        ),
+        "provenance": provenance,
+        "partial": bool(provenance.get("partial")),
+    }
+
+
 def _is_workflow_recipe_ref(value: Optional[str]) -> bool:
     return str(value or "").strip().startswith("recipe://workflow-recipe-v1/")
 
@@ -1077,11 +1111,21 @@ class AuthorityNamespace:
         )
 
     async def get_deploy(self, deploy_id: str, *, timeout: Optional[float] = None) -> Dict[str, Any]:
-        """Get deploy by id. ``GET /api/authority/deploys/{deploy_id}``."""
+        """Get deploy by id in coherent current state.
+
+        ``GET /api/authority/deploys/{deploy_id}?view=coherent`` returns
+        ``{deploy, current_rollout, executor_history, provenance}``: the single
+        current rollout, the executor history labeled as history, and the
+        provenance naming which rollout is current (``partial`` when Authority
+        cannot resolve one). The view is requested explicitly so the read never
+        rides the server's legacy default, and there is no legacy fallback.
+        Use :func:`coherent_deploy_state` to read the sections apart.
+        """
         if not deploy_id:
             raise ValueError("deploy_id is required")
+        qs = _query_string({"view": DEPLOY_VIEW_COHERENT})
         return await self._get(
-            f"/api/authority/deploys/{quote(deploy_id, safe='')}",
+            f"/api/authority/deploys/{quote(deploy_id, safe='')}{qs}",
             timeout=self._http_timeout(timeout, 30.0),
         )
 

{dominus_sdk_python-9.0.12 → dominus_sdk_python-9.0.13}/dominus_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 9.0.12
+Version: 9.0.13
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License-Expression: LicenseRef-Proprietary
@@ -38,8 +38,8 @@ Async Python SDK for the Dominus gateway-first service plane.
 ## Agent Guide
 
 Start with `docs/agent-guide/INDEX.md`. The current snapshot is
-`docs/agent-guide/2026-09-14-1300-sdk-python/00-reading-order.md`; the latest
-cleanup audit is `docs/janitor/2026-09-14-1300-sdk-python-cleanup-audit.md`.
+`docs/agent-guide/2026-09-19-1300-sdk-python/00-reading-order.md`; the latest
+cleanup audit is `docs/janitor/2026-09-19-1300-sdk-python-cleanup-audit.md`.
 
 ## What This Repo Ships
 
@@ -48,7 +48,7 @@ cleanup audit is `docs/janitor/2026-09-14-1300-sdk-python-cleanup-audit.md`.
 - Gateway-scoped client mode for MCP and other user-JWT sessions
 - Transport compatibility for wrapped `{success,data}` responses and unwrapped Warden/control-plane success objects
 - Local helpers for JWT verification, trace propagation, retries, and console capture
-- Current package version: `9.0.12`
+- Current package version: `9.0.13`
 
 ## Install
 

{dominus_sdk_python-9.0.12 → dominus_sdk_python-9.0.13}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dominus-sdk-python"
-version = "9.0.12"
+version = "9.0.13"
 description = "Python SDK for the Dominus gateway-first platform"
 readme = "README.md"
 license = "LicenseRef-Proprietary"

{dominus_sdk_python-9.0.12 → dominus_sdk_python-9.0.13}/tests/test_authority_public_vocabulary.py

@@ -611,6 +611,91 @@ async def test_bootstrap_provisioning_target_carries_repo_template():
     assert "repo_template" not in absent_client.calls[-1]["body"]
 
 
+# --- Task 16: singular deploy reader reads coherent current state --
+
+
+@pytest.mark.asyncio
+async def test_get_deploy_requests_the_coherent_view_explicitly():
+    from dominus.namespaces.authority import DEPLOY_VIEW_COHERENT
+
+    client = FakeClient()
+    ns = AuthorityNamespace(client)
+
+    await ns.get_deploy("deploy::dominus-authority--production")
+
+    assert client.calls[0]["method"] == "GET"
+    assert client.calls[0]["endpoint"] == (
+        "/api/authority/deploys/deploy%3A%3Adominus-authority--production?view=coherent"
+    )
+    # The view is named on the wire, never inherited from the server default.
+    assert DEPLOY_VIEW_COHERENT == "coherent"
+
+
+def test_coherent_deploy_state_keeps_current_and_history_labeled_apart():
+    from dominus.namespaces.authority import coherent_deploy_state
+
+    state = coherent_deploy_state(
+        {
+            "deploy": {"deploy_id": "deploy-1", "app_slug": "carebridge"},
+            "current_rollout": {"rollout_id": "rollout-2", "generation": 7},
+            "executor_history": [
+                {"rollout_id": "rollout-1", "generation": 6},
+                {"rollout_id": "rollout-2", "generation": 7, "is_current": True},
+            ],
+            "provenance": {
+                "view": "coherent",
+                "source": "current_rollout",
+                "rollout_id": "rollout-2",
+                "generation": 7,
+                "is_current": True,
+                "partial": False,
+            },
+        }
+    )
+
+    assert state["current_rollout"]["rollout_id"] == "rollout-2"
+    assert [row["rollout_id"] for row in state["executor_history"]] == ["rollout-1", "rollout-2"]
+    assert state["provenance"]["generation"] == 7
+    assert state["partial"] is False
+
+
+def test_coherent_deploy_state_never_substitutes_history_for_a_missing_current_rollout():
+    from dominus.namespaces.authority import coherent_deploy_state
+
+    state = coherent_deploy_state(
+        {
+            "deploy": {"deploy_id": "deploy-2"},
+            "current_rollout": None,
+            "executor_history": [{"rollout_id": "rollout-9", "generation": 3}],
+            "provenance": {
+                "view": "coherent",
+                "source": None,
+                "rollout_id": None,
+                "is_current": False,
+                "partial": True,
+            },
+        }
+    )
+
+    # An unresolved current rollout stays an explicit partial; the newest
+    # history entry is not promoted into its place.
+    assert state["current_rollout"] is None
+    assert state["partial"] is True
+    assert [row["rollout_id"] for row in state["executor_history"]] == ["rollout-9"]
+
+
+def test_coherent_deploy_state_tolerates_a_non_envelope_payload():
+    from dominus.namespaces.authority import coherent_deploy_state
+
+    state = coherent_deploy_state({"code": "authority.deploy_not_found"})
+
+    assert state["deploy"] == {}
+    assert state["current_rollout"] is None
+    assert state["executor_history"] == []
+    assert state["provenance"] == {}
+    assert state["partial"] is False
+
+
 def test_bootstrap_signature_carries_standalone_and_root_role():
     bootstrap_sig = inspect.signature(AuthorityNamespace.bootstrap_provisioning_target)
     assert "standalone" in bootstrap_sig.parameters