mammoth-cli 2.0.19__tar.gz → 2.0.20__tar.gz

{mammoth_cli-2.0.19 → mammoth_cli-2.0.20}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.0.19
+Version: 2.0.20
 Summary: Command-line interface for the Mammoth Analytics platform
 Project-URL: homepage, https://mammoth.io
 Project-URL: repository, https://github.com/EdgeMetric/mammothsdk
@@ -17,7 +17,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: <3.15,>=3.12
 Requires-Dist: jsonschema>=4.20
 Requires-Dist: keyring<26,>=25.7
-Requires-Dist: mammoth-io<0.8,>=0.7.10
+Requires-Dist: mammoth-io<0.8,>=0.7.11
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.13
 Requires-Dist: pyyaml<7,>=6
@@ -250,6 +250,7 @@ The full generated list is in [docs/reference/commands.md](https://github.com/Ed
 | [Output and errors](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/reference/output-and-errors.md) | Envelopes, exit codes, error codes. |
 | [Global flags](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/reference/global-flags.md) | The flags every command shares. |
 | [Troubleshooting](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/troubleshooting.md) | Exit codes, error envelopes, the run log, recovery. |
+| [Agent prompt](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/agent-prompt.md) | Paste-ready prompt: an agent uses Mammoth through the CLI in bash. |
 | [Upgrade](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/upgrade.md) / [Uninstall](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/uninstall.md) | Keep the CLI current, or remove it. |
 | [Command reference](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/reference/commands.md) | Every command, grouped by family. |
 

{mammoth_cli-2.0.19 → mammoth_cli-2.0.20}/README.md

@@ -222,6 +222,7 @@ The full generated list is in [docs/reference/commands.md](https://github.com/Ed
 | [Output and errors](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/reference/output-and-errors.md) | Envelopes, exit codes, error codes. |
 | [Global flags](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/reference/global-flags.md) | The flags every command shares. |
 | [Troubleshooting](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/troubleshooting.md) | Exit codes, error envelopes, the run log, recovery. |
+| [Agent prompt](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/agent-prompt.md) | Paste-ready prompt: an agent uses Mammoth through the CLI in bash. |
 | [Upgrade](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/upgrade.md) / [Uninstall](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/uninstall.md) | Keep the CLI current, or remove it. |
 | [Command reference](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/reference/commands.md) | Every command, grouped by family. |
 

{mammoth_cli-2.0.19 → mammoth_cli-2.0.20}/mammoth_cli/__init__.py

@@ -6,7 +6,7 @@ not implement a second HTTP client and does not call private SDK members.
 
 from __future__ import annotations
 
-__version__ = "2.0.19"
+__version__ = "2.0.20"
 
 # The versioned machine output envelope contract.
 SCHEMA_VERSION = 1

{mammoth_cli-2.0.19 → mammoth_cli-2.0.20}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.0.19
+version: 2.0.20
 description: "Use Mammoth Analytics from a terminal: install or authenticate the CLI, discover its live command contract, and safely manage projects, data, views, pipelines, dashboards, exports, and handoffs."
 ---
 

{mammoth_cli-2.0.19 → mammoth_cli-2.0.20}/mammoth_cli/commands/project.py

@@ -14,7 +14,6 @@ from __future__ import annotations
 from typing import Any
 
 from mammoth_cli.errors.envelope import (
-    CODE_CONFLICT,
     CODE_INVALID_ARGUMENT,
     CODE_MISSING_ARGUMENT,
     CODE_MISSING_FIELD,
@@ -217,9 +216,6 @@ def project_create(invocation: Invocation) -> HandlerResult:
     return data, _meta(invocation, auth.workspace_id, resolved_project(invocation))
 
 
-#: The projects route caps ``limit`` at 100 (backend 4GENR007 above it) and
-#: the SDK exposes no offset, so this is the largest listing one call can see.
-_ENSURE_PROJECT_LIST_LIMIT = 100
 _ENSURE_CREATE_SYMBOL = "mammoth.api.projects.ProjectsAPI.create"
 
 
@@ -243,8 +239,9 @@ def project_ensure(invocation: Invocation) -> HandlerResult:
             hint="Pass the name as a positional argument or a 'name' input field.",
         )
     with open_service(invocation) as (service, auth):
-        listing = service.list_projects(limit=_ENSURE_PROJECT_LIST_LIMIT)
-        projects = list(listing.get("projects", [])) if isinstance(listing, dict) else []
+        # Walks every 100-row page of the projects route, so an exact-name
+        # match anywhere in the workspace is found before anything is created.
+        projects = [p for p in service.list_all_projects() if isinstance(p, dict)]
         same_name = sorted(
             (p for p in projects if isinstance(p, dict) and p.get("name") == name),
             key=lambda p: int(p.get("id") or 0),
@@ -258,21 +255,6 @@ def project_ensure(invocation: Invocation) -> HandlerResult:
                 "duplicates": [p.get("id") for p in same_name[1:]],
             }
             return data, _meta(invocation, auth.workspace_id, chosen.get("id"))
-        truncated = bool(listing.get("next")) if isinstance(listing, dict) else False
-        if truncated or len(projects) >= _ENSURE_PROJECT_LIST_LIMIT:
-            # A name beyond the first page may exist; creating blindly would
-            # break the idempotency this command promises.
-            raise CliError(
-                code=CODE_CONFLICT,
-                message=(
-                    f"Workspace has more than {_ENSURE_PROJECT_LIST_LIMIT} projects; "
-                    f"cannot prove {name!r} is absent."
-                ),
-                exit_status=EXIT_USAGE,
-                hint="Find the project with 'project list' and pass --project, "
-                "or create it explicitly with 'project create'.",
-                details={"listed": len(projects)},
-            )
         created = service.call(_ENSURE_CREATE_SYMBOL, name=name)
     record = created.get("project", created) if isinstance(created, dict) else {}
     project_id = record.get("id") if isinstance(record, dict) else None

{mammoth_cli-2.0.19 → mammoth_cli-2.0.20}/mammoth_cli/services/protocol.py

@@ -76,6 +76,14 @@ class MammothService(Protocol):
         """
         ...
 
+    def list_all_projects(self) -> list[dict[str, Any]]:
+        """Every project in the workspace, across the route's pages.
+
+        Returns:
+            The project records (``id``, ``name``).
+        """
+        ...
+
     def get_project(self, project_id: int) -> dict[str, Any]:
         """Get one project by id.
 

{mammoth_cli-2.0.19 → mammoth_cli-2.0.20}/mammoth_cli/services/sdk_service.py

@@ -31,6 +31,9 @@ from mammoth_cli.services.conditions import CONDITION_KWARG, compile_condition
 from mammoth_cli.services.dispatch import resolve_sdk_method
 from mammoth_cli.services.mapping import map_sdk_exception
 
+#: Largest ``limit`` the projects route accepts (``4GENR007`` above it).
+_PROJECT_PAGE_SIZE = 100
+
 
 class SdkMammothService:
     """Production :class:`~mammoth_cli.services.protocol.MammothService`."""
@@ -615,25 +618,44 @@ class SdkMammothService:
     def list_projects(self, limit: int = 100, offset: int = 0) -> dict[str, Any]:
         """List projects in the current workspace.
 
-        The public SDK does not expose server-side pagination offsets, so an
-        offset is applied client-side to the returned page.
+        The projects route caps ``limit`` at 100 and pages with a server-side
+        ``offset``; a larger ``limit`` is served by walking the pages.
 
         Args:
             limit: Maximum number of results.
             offset: Number of leading results to skip.
 
         Returns:
-            The raw project-list response, sliced by ``offset``/``limit``.
+            The raw project-list response, with ``projects`` holding at most
+            ``limit`` records from ``offset`` on.
+
+        Raises:
+            CliError: Mapped from any SDK exception.
+        """
+        try:
+            if limit <= _PROJECT_PAGE_SIZE:
+                response = self._client.projects.list(limit=limit, offset=offset)
+                return {**response, "projects": list(response.get("projects", []))}
+            everything = self._client.projects.list_all()
+        except Exception as exc:
+            raise map_sdk_exception(exc) from exc
+        return {
+            "projects": everything[offset : offset + limit],
+            "limit": limit,
+            "offset": offset,
+            "next": "",
+        }
+
+    def list_all_projects(self) -> list[dict[str, Any]]:
+        """Every project in the workspace, across the route's 100-row pages.
 
         Raises:
             CliError: Mapped from any SDK exception.
         """
         try:
-            response = self._client.projects.list(limit=limit + offset)
+            return list(self._client.projects.list_all())
         except Exception as exc:
             raise map_sdk_exception(exc) from exc
-        projects = response.get("projects", [])
-        return {**response, "projects": projects[offset : offset + limit]}
 
     def get_project(self, project_id: int) -> dict[str, Any]:
         """Get one project by id.

{mammoth_cli-2.0.19 → mammoth_cli-2.0.20}/mammoth_cli/services/testing.py

@@ -118,6 +118,11 @@ class FakeMammothService:
         self.calls.append("list_projects")
         return {"projects": self.projects[offset : offset + limit]}
 
+    def list_all_projects(self) -> list[dict[str, Any]]:
+        """Return the whole in-memory project list."""
+        self.calls.append("list_all_projects")
+        return list(self.projects)
+
     def get_project(self, project_id: int) -> dict[str, Any]:
         """Return one in-memory project, or raise ``resource_not_found``."""
         self.calls.append("get_project")

{mammoth_cli-2.0.19 → mammoth_cli-2.0.20}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "mammoth-cli"
-version = "2.0.19"
+version = "2.0.20"
 description = "Command-line interface for the Mammoth Analytics platform"
 authors = [{name = "Mammoth Analytics", email = "support@mammoth.io"}]
 readme = "README.md"
 license = "LicenseRef-Proprietary"
 requires-python = ">=3.12,<3.15"
 dependencies = [
-    "mammoth-io (>=0.7.10,<0.8)",
+    "mammoth-io (>=0.7.11,<0.8)",
     "typer (>=0.27,<0.28)",
     "rich (>=15,<16)",
     "platformdirs (>=4.10,<5)",

{mammoth_cli-2.0.19 → mammoth_cli-2.0.20}/spec/manifests/sdk-catalog.source.yaml

@@ -2925,7 +2925,8 @@ sdk_methods:
   wait_policy: not_async
   pagination_policy: single_page
   openapi_operation_ids: []
-  notes: 'B01 FIRST_PAGE_ONLY: no offset/cursor continuation proven yet.'
+  notes: 'Single page; the route caps limit at 100 (4GENR007). SDK 0.7.11 adds offset and list_all
+    for the following pages.'
 - sdk_symbol: mammoth.api.projects.ProjectsAPI.pending_changes
   canonical_command: project.pending-changes
   alias_of: null

{mammoth_cli-2.0.19 → mammoth_cli-2.0.20}/spec/manifests/sdk-methods.yaml

@@ -1,5 +1,5 @@
 manifest_schema_version: 1
-method_count: 572
+method_count: 573
 generator_version: '1'
 methods:
 - sdk_symbol: mammoth._mixins._advanced_ops.AdvancedOpsMixin.add_sql
@@ -4805,7 +4805,7 @@ methods:
   reviewed_by: primary
 - sdk_symbol: mammoth.api.projects.ProjectsAPI.list
   implementation_origin: mammoth.api.projects.ProjectsAPI.list
-  signature: 'list(self, workspace_id: ''int | None'' = None, limit: ''int'' = 100) -> ''dict[str, Any]'''
+  signature: 'list(self, workspace_id: ''int | None'' = None, limit: ''int'' = 100, offset: ''int'' = 0) -> ''dict[str, Any]'''
   openapi_operation_ids: []
   canonical_command: project.list
   alias_of: null
@@ -4815,6 +4815,19 @@ methods:
   pagination_policy: single_page
   secret_fields: []
   reviewed_by: primary
+- sdk_symbol: mammoth.api.projects.ProjectsAPI.list_all
+  implementation_origin: mammoth.api.projects.ProjectsAPI.list_all
+  signature: 'list_all(self, workspace_id: ''int | None'' = None) -> ''_list[dict[str, Any]]'''
+  openapi_operation_ids: []
+  canonical_command: null
+  alias_of: null
+  no_command_reason: SDK-only helper that walks the 100-row pages of the projects route; project
+    ensure uses it through the service layer, project list stays single-page.
+  mutation_class: null
+  wait_policy: null
+  pagination_policy: null
+  secret_fields: []
+  reviewed_by: primary
 - sdk_symbol: mammoth.api.projects.ProjectsAPI.pending_changes
   implementation_origin: mammoth.api.projects.ProjectsAPI.pending_changes
   signature: 'pending_changes(self, project_id: ''int'', workspace_id: ''int | None'' = None) -> ''dict[str, Any]'''