dominus-sdk-python 6.3.0__tar.gz → 7.0.0__tar.gz

{dominus_sdk_python-6.3.0 → dominus_sdk_python-7.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 6.3.0
+Version: 7.0.0
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License-Expression: LicenseRef-Proprietary
@@ -35,6 +35,12 @@ Requires-Dist: PyJWT>=2.8.0; extra == "all"
 
 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-06-27-0849-agent-guide/00-reading-order.md`; the latest
+cleanup audit is `docs/janitor/2026-06-27-0849-agent-guide-cleanup-audit.md`.
+
 ## What This Repo Ships
 
 - Python 3.9+ asyncio client for Dominus services
@@ -42,7 +48,7 @@ Async Python SDK for the Dominus gateway-first service plane.
 - 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: `6.1.1`
+- Current package version: `7.0.0`
 
 ## Install
 
@@ -223,6 +229,9 @@ JWT and selected scope headers directly through Gateway.
 | `warden` | Warden | Thin operator control-plane request surface |
 | `platform` | Platform Worker | Group/repository policy decisions with actor attribution |
 | `coder` | Coder Runtime | Policy-bound Coder run lifecycle with workflow/pipeline recipe launch sources |
+| `publisher` | Publisher | Release/channel/signing build and artifact operations |
+| `stash` | Stash | Stash items, kinds, bookmarks, watches, artifact facade |
+| `recipes` | Recipe Worker | Recipe type registry, publish, validate, get/list |
 | `fastapi` | Local decorators | `@jwt`, `@psk`, `@scopes(...)` |
 
 ## Root Shortcuts

{dominus_sdk_python-6.3.0 → dominus_sdk_python-7.0.0}/README.md

@@ -2,6 +2,12 @@
 
 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-06-27-0849-agent-guide/00-reading-order.md`; the latest
+cleanup audit is `docs/janitor/2026-06-27-0849-agent-guide-cleanup-audit.md`.
+
 ## What This Repo Ships
 
 - Python 3.9+ asyncio client for Dominus services
@@ -9,7 +15,7 @@ Async Python SDK for the Dominus gateway-first service plane.
 - 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: `6.1.1`
+- Current package version: `7.0.0`
 
 ## Install
 
@@ -190,6 +196,9 @@ JWT and selected scope headers directly through Gateway.
 | `warden` | Warden | Thin operator control-plane request surface |
 | `platform` | Platform Worker | Group/repository policy decisions with actor attribution |
 | `coder` | Coder Runtime | Policy-bound Coder run lifecycle with workflow/pipeline recipe launch sources |
+| `publisher` | Publisher | Release/channel/signing build and artifact operations |
+| `stash` | Stash | Stash items, kinds, bookmarks, watches, artifact facade |
+| `recipes` | Recipe Worker | Recipe type registry, publish, validate, get/list |
 | `fastapi` | Local decorators | `@jwt`, `@psk`, `@scopes(...)` |
 
 ## Root Shortcuts

{dominus_sdk_python-6.3.0 → dominus_sdk_python-7.0.0}/dominus/__init__.py

@@ -115,6 +115,7 @@ from .namespaces.warden import WardenNamespace
 from .namespaces.platform import PlatformNamespace
 from .namespaces.coder import CoderNamespace
 from .namespaces.publisher import PublisherNamespace
+from .namespaces.stash import StashNamespace
 
 # Export AI namespace for agent-runtime operations
 from .namespaces.ai import (
@@ -172,7 +173,7 @@ from .errors import (
     TimeoutError as DominusTimeoutError,
 )
 
-__version__ = "6.3.0"
+__version__ = "7.0.0"
 __all__ = [
     # Main SDK instance
     "dominus",
@@ -226,6 +227,7 @@ __all__ = [
     "PlatformNamespace",
     "CoderNamespace",
     "PublisherNamespace",
+    "StashNamespace",
     # AI namespace for agent-runtime operations
     "AiNamespace",
     "RagSubNamespace",

{dominus_sdk_python-6.3.0 → dominus_sdk_python-7.0.0}/dominus/namespaces/__init__.py

@@ -21,6 +21,8 @@ from .deployer import DeployerNamespace
 from .warden import WardenNamespace
 from .platform import PlatformNamespace
 from .coder import CoderNamespace
+from .publisher import PublisherNamespace
+from .stash import StashNamespace
 from .ai import (
     AiNamespace,
     RagSubNamespace,
@@ -52,6 +54,8 @@ __all__ = [
     "WardenNamespace",
     "PlatformNamespace",
     "CoderNamespace",
+    "PublisherNamespace",
+    "StashNamespace",
     "AiNamespace",
     "RagSubNamespace",
     "ArtifactsSubNamespace",

{dominus_sdk_python-6.3.0 → dominus_sdk_python-7.0.0}/dominus/namespaces/authority.py

@@ -3,7 +3,7 @@ Authority Namespace - Dominus Authority service surface.
 
 Canonical SDK entry point for the dominus-authority service. Mirrors the MCP
 ``authority_*`` tool surface so application code can drive runs, provisioning
-targets, deploys, managed clients, timelines, dossiers, and Authority context resolution
+targets, deploys, managed clients, timelines, verdicts, and Authority context resolution
 without touching workflow-manager / client-worker / deploy-worker routes
 directly.
 
@@ -13,7 +13,7 @@ All methods route through the gateway (``use_gateway=True``) which maps
 Run launch is also exposed as ``dominus.workflow.ensure(...)``. Both call
 ``/api/authority/runs/ensure``. Use ``dominus.workflow.ensure`` for the
 canonical recipe-backed launch path; use ``dominus.authority.ensure_run`` when
-you want to think in Authority terms (run lifecycle, run dossiers, retries,
+you want to think in Authority terms (run lifecycle, verdicts, retries,
 cancels).
 """
 from __future__ import annotations
@@ -74,7 +74,7 @@ class AuthorityNamespace:
             subject="PCM47474562",
         )
         await dominus.authority.list_provisioning_targets()
-        await dominus.authority.get_run_dossier(run_id)
+        await dominus.authority.get_run_verdict(run_id)
     """
 
     def __init__(self, client: "Dominus"):
@@ -489,27 +489,17 @@ class AuthorityNamespace:
             timeout=self._http_timeout(timeout, 30.0),
         )
 
-    async def get_run_dossier(
+    async def get_run_verdict(
         self,
         run_id: str,
         *,
-        since: Optional[str] = None,
-        until: Optional[str] = None,
-        window_hours: Optional[int] = None,
-        limit: Optional[int] = None,
         timeout: Optional[float] = None,
     ) -> Dict[str, Any]:
-        """Get the full Authority dossier for a run. ``GET /api/authority/dossiers/run/{run_id}``."""
+        """Get the compact Authority verdict for a run. ``GET /api/authority/runs/{run_id}/verdict``."""
         if not run_id:
             raise ValueError("run_id is required")
-        qs = _query_string({
-            "since": since,
-            "until": until,
-            "window_hours": window_hours,
-            "limit": limit,
-        })
         return await self._get(
-            f"/api/authority/dossiers/run/{quote(run_id, safe='')}{qs}",
+            f"/api/authority/runs/{quote(run_id, safe='')}/verdict",
             timeout=self._http_timeout(timeout, 30.0),
         )
 
@@ -984,39 +974,6 @@ class AuthorityNamespace:
             timeout=self._http_timeout(timeout, 30.0),
         )
 
-    async def get_provisioning_target_dossier(
-        self,
-        provisioning_target_slug: str,
-        *,
-        app_slug: Optional[str] = None,
-        env: Optional[str] = None,
-        target_org_id: Optional[str] = None,
-        target_env: Optional[str] = None,
-        since: Optional[str] = None,
-        until: Optional[str] = None,
-        window_hours: Optional[int] = None,
-        limit: Optional[int] = None,
-        timeout: Optional[float] = None,
-    ) -> Dict[str, Any]:
-        """Get full Authority dossier for a provisioning target. ``GET /api/authority/dossiers/provisioning-target/{provisioning_target_slug}``."""
-        if not provisioning_target_slug:
-            raise ValueError("provisioning_target_slug is required")
-        tid, tev = self._target_query_params(target_org_id, target_env)
-        qs = _query_string({
-            "app_slug": app_slug,
-            "env": env,
-            "target_org_id": tid,
-            "target_env": tev,
-            "since": since,
-            "until": until,
-            "window_hours": window_hours,
-            "limit": limit,
-        })
-        return await self._get(
-            f"/api/authority/dossiers/provisioning-target/{quote(provisioning_target_slug, safe='')}{qs}",
-            timeout=self._http_timeout(timeout, 30.0),
-        )
-
     # ==================================================================
     # Deploys
     # ==================================================================
@@ -1147,36 +1104,20 @@ class AuthorityNamespace:
             timeout=self._http_timeout(timeout, 30.0),
         )
 
-    async def get_deploy_dossier(
+    async def get_deploy_verdict(
         self,
         deploy_id: str,
         *,
-        since: Optional[str] = None,
-        until: Optional[str] = None,
-        window_hours: Optional[int] = None,
-        limit: Optional[int] = None,
-        full: bool = False,
         timeout: Optional[float] = None,
     ) -> Dict[str, Any]:
         """
-        Get the full Authority dossier for a deploy.
-        ``GET /api/authority/dossiers/deploy/{deploy_id}``.
-
-        Mirrors the MCP ``authority_get_deploy_dossier`` tool. If the dossier
-        route is not yet enabled in dominus-authority the gateway will return
-        404 — the SDK surface is intentionally aligned with MCP.
+        Get the compact Authority verdict for a deploy.
+        ``GET /api/authority/deploys/{deploy_id}/verdict``.
         """
         if not deploy_id:
             raise ValueError("deploy_id is required")
-        qs = _query_string({
-            "since": since,
-            "until": until,
-            "window_hours": window_hours,
-            "limit": limit,
-            "full": 1 if full else None,
-        })
         return await self._get(
-            f"/api/authority/dossiers/deploy/{quote(deploy_id, safe='')}{qs}",
+            f"/api/authority/deploys/{quote(deploy_id, safe='')}/verdict",
             timeout=self._http_timeout(timeout, 30.0),
         )
 

{dominus_sdk_python-6.3.0 → dominus_sdk_python-7.0.0}/dominus/start.py

@@ -168,7 +168,7 @@ class Dominus:
         from .namespaces.sync import SyncNamespace
         self.sync = SyncNamespace(self)
 
-        # Authority service (runs, provisioning targets, deploys, managed clients, dossiers)
+        # Authority service (runs, provisioning targets, deploys, managed clients, verdicts)
         from .namespaces.authority import AuthorityNamespace
         self.authority = AuthorityNamespace(self)
 

{dominus_sdk_python-6.3.0 → dominus_sdk_python-7.0.0}/dominus_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python
-Version: 6.3.0
+Version: 7.0.0
 Summary: Python SDK for the Dominus gateway-first platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License-Expression: LicenseRef-Proprietary
@@ -35,6 +35,12 @@ Requires-Dist: PyJWT>=2.8.0; extra == "all"
 
 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-06-27-0849-agent-guide/00-reading-order.md`; the latest
+cleanup audit is `docs/janitor/2026-06-27-0849-agent-guide-cleanup-audit.md`.
+
 ## What This Repo Ships
 
 - Python 3.9+ asyncio client for Dominus services
@@ -42,7 +48,7 @@ Async Python SDK for the Dominus gateway-first service plane.
 - 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: `6.1.1`
+- Current package version: `7.0.0`
 
 ## Install
 
@@ -223,6 +229,9 @@ JWT and selected scope headers directly through Gateway.
 | `warden` | Warden | Thin operator control-plane request surface |
 | `platform` | Platform Worker | Group/repository policy decisions with actor attribution |
 | `coder` | Coder Runtime | Policy-bound Coder run lifecycle with workflow/pipeline recipe launch sources |
+| `publisher` | Publisher | Release/channel/signing build and artifact operations |
+| `stash` | Stash | Stash items, kinds, bookmarks, watches, artifact facade |
+| `recipes` | Recipe Worker | Recipe type registry, publish, validate, get/list |
 | `fastapi` | Local decorators | `@jwt`, `@psk`, `@scopes(...)` |
 
 ## Root Shortcuts

{dominus_sdk_python-6.3.0 → dominus_sdk_python-7.0.0}/dominus_sdk_python.egg-info/SOURCES.txt

@@ -56,6 +56,7 @@ tests/test_errors.py
 tests/test_flat_commands.py
 tests/test_health.py
 tests/test_logs.py
+tests/test_namespace_barrel_exports.py
 tests/test_platform_coder_namespaces.py
 tests/test_provisioning_parity.py
 tests/test_public_exports.py

{dominus_sdk_python-6.3.0 → dominus_sdk_python-7.0.0}/pyproject.toml

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

{dominus_sdk_python-6.3.0 → dominus_sdk_python-7.0.0}/tests/test_authority_public_vocabulary.py

@@ -193,32 +193,11 @@ async def test_authority_scope_methods_use_canonical_context_wire_names():
         window_hours=24,
         limit=150,
     )
-    await namespace.get_run_dossier(
-        "run-1",
-        since="2026-04-11T08:33:00Z",
-        until="2026-04-11T09:33:00Z",
-        window_hours=24,
-        limit=150,
-    )
-    await namespace.get_provisioning_target_dossier(
-        "summit-radiology",
-        app_slug="carebridge",
-        env="production",
-        target_org_id="target-org-1",
-        target_env="production",
-        since="2026-04-11T08:33:00Z",
-        until="2026-04-11T09:33:00Z",
-        window_hours=24,
-        limit=150,
-    )
-    await namespace.get_deploy_dossier(
-        "deploy-1",
-        since="2026-04-11T08:33:00Z",
-        until="2026-04-11T09:33:00Z",
-        window_hours=24,
-        limit=150,
-        full=True,
-    )
+    assert not hasattr(namespace, "get_run_dossier")
+    assert not hasattr(namespace, "get_provisioning_target_dossier")
+    assert not hasattr(namespace, "get_deploy_dossier")
+    await namespace.get_run_verdict("run-1")
+    await namespace.get_deploy_verdict("deploy-1")
     await namespace.query_timelines(
         subject="PCM47474562",
         company="summit-radiology",
@@ -305,19 +284,12 @@ async def test_authority_scope_methods_use_canonical_context_wire_names():
         "since=2026-04-11T08%3A33%3A00Z&until=2026-04-11T09%3A33%3A00Z&window_hours=24&limit=150"
     )
     assert client.calls[5]["endpoint"] == (
-        "/api/authority/dossiers/run/run-1?"
-        "since=2026-04-11T08%3A33%3A00Z&until=2026-04-11T09%3A33%3A00Z&window_hours=24&limit=150"
+        "/api/authority/runs/run-1/verdict"
     )
     assert client.calls[6]["endpoint"] == (
-        "/api/authority/dossiers/provisioning-target/summit-radiology?"
-        "app_slug=carebridge&env=production&target_org_id=target-org-1&target_env=production"
-        "&since=2026-04-11T08%3A33%3A00Z&until=2026-04-11T09%3A33%3A00Z&window_hours=24&limit=150"
-    )
-    assert client.calls[7]["endpoint"] == (
-        "/api/authority/dossiers/deploy/deploy-1?"
-        "since=2026-04-11T08%3A33%3A00Z&until=2026-04-11T09%3A33%3A00Z&window_hours=24&limit=150&full=1"
+        "/api/authority/deploys/deploy-1/verdict"
     )
-    assert client.calls[8]["body"] == {
+    assert client.calls[7]["body"] == {
         "subject": "PCM47474562",
         "company": "summit-radiology",
         "run_id": "run-1",
@@ -326,37 +298,37 @@ async def test_authority_scope_methods_use_canonical_context_wire_names():
         "window_hours": 24,
         "limit": 150,
     }
-    assert client.calls[9]["endpoint"] == (
+    assert client.calls[8]["endpoint"] == (
         "/api/authority/timelines/archive-status?"
         "all_scopes=true&app_slug=carebridge&env=production&limit=5"
     )
-    assert client.calls[10]["endpoint"] == "/api/authority/timelines/archive"
-    assert client.calls[10]["method"] == "POST"
-    assert client.calls[10]["body"] == {
+    assert client.calls[9]["endpoint"] == "/api/authority/timelines/archive"
+    assert client.calls[9]["method"] == "POST"
+    assert client.calls[9]["body"] == {
         "max_hours": 24,
         "max_runtime_ms": 600000,
     }
-    assert client.calls[11]["endpoint"] == "/api/authority/timelines/archive-repair"
-    assert client.calls[11]["method"] == "POST"
-    assert client.calls[11]["body"] == {
+    assert client.calls[10]["endpoint"] == "/api/authority/timelines/archive-repair"
+    assert client.calls[10]["method"] == "POST"
+    assert client.calls[10]["body"] == {
         "since": "2026-04-01T00:00:00Z",
         "until": "2026-04-02T00:00:00Z",
     }
-    assert client.calls[12]["endpoint"] == "/api/authority/timelines/archive-verify"
-    assert client.calls[12]["body"] == {
+    assert client.calls[11]["endpoint"] == "/api/authority/timelines/archive-verify"
+    assert client.calls[11]["body"] == {
         "since": "2026-04-01T00:00:00Z",
         "until": "2026-04-02T00:00:00Z",
     }
-    assert client.calls[13]["endpoint"] == "/api/authority/timelines/archive-prune"
-    assert client.calls[13]["body"] == {
+    assert client.calls[12]["endpoint"] == "/api/authority/timelines/archive-prune"
+    assert client.calls[12]["body"] == {
         "since": "2026-01-01T00:00:00Z",
         "until": "2026-01-02T00:00:00Z",
         "retention_days": 365,
         "dry_run": False,
         "confirm": "DELETE_EXPIRED_ARCHIVE_OBJECTS",
     }
-    assert client.calls[14]["endpoint"] == "/api/authority/schedules"
-    assert client.calls[14]["body"] == {
+    assert client.calls[13]["endpoint"] == "/api/authority/schedules"
+    assert client.calls[13]["body"] == {
         "schedule_key": "demo.hourly",
         "owner_app_slug": "carebridge",
         "owner_env": "production",
@@ -364,16 +336,16 @@ async def test_authority_scope_methods_use_canonical_context_wire_names():
         "frequency_kind": "hourly",
         "max_runtime_ms": 600000,
     }
-    assert client.calls[15]["endpoint"] == "/api/authority/schedules/demo.hourly"
-    assert client.calls[15]["method"] == "PATCH"
-    assert client.calls[15]["body"] == {
+    assert client.calls[14]["endpoint"] == "/api/authority/schedules/demo.hourly"
+    assert client.calls[14]["method"] == "PATCH"
+    assert client.calls[14]["body"] == {
         "enabled": False,
         "next_due_at": "2026-04-19T00:00:00Z",
     }
-    assert client.calls[16]["endpoint"] == "/api/authority/schedules/claim-due"
-    assert client.calls[16]["body"] == {"limit": 5, "lock_seconds": 900}
-    assert client.calls[17]["endpoint"] == "/api/authority/schedules/demo.hourly/runs/run-1/complete"
-    assert client.calls[18]["endpoint"] == "/api/authority/schedules/demo.hourly/runs/run-2/fail"
+    assert client.calls[15]["endpoint"] == "/api/authority/schedules/claim-due"
+    assert client.calls[15]["body"] == {"limit": 5, "lock_seconds": 900}
+    assert client.calls[16]["endpoint"] == "/api/authority/schedules/demo.hourly/runs/run-1/complete"
+    assert client.calls[17]["endpoint"] == "/api/authority/schedules/demo.hourly/runs/run-2/fail"
 
 
 @pytest.mark.asyncio

dominus_sdk_python-7.0.0/tests/test_namespace_barrel_exports.py

@@ -0,0 +1,26 @@
+import dominus
+import dominus.namespaces
+
+
+def test_stash_and_publisher_importable_from_top_level_barrel():
+    from dominus import StashNamespace, PublisherNamespace
+
+    assert StashNamespace is not None
+    assert PublisherNamespace is not None
+
+
+def test_stash_and_publisher_importable_from_namespaces_barrel():
+    from dominus.namespaces import StashNamespace, PublisherNamespace
+
+    assert StashNamespace is not None
+    assert PublisherNamespace is not None
+
+
+def test_top_level_all_lists_stash_and_publisher():
+    assert "StashNamespace" in dominus.__all__
+    assert "PublisherNamespace" in dominus.__all__
+
+
+def test_namespaces_all_lists_stash_and_publisher():
+    assert "StashNamespace" in dominus.namespaces.__all__
+    assert "PublisherNamespace" in dominus.namespaces.__all__