mammoth-cli 2.0.23__tar.gz → 2.0.24__tar.gz

{mammoth_cli-2.0.23 → mammoth_cli-2.0.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.0.23
+Version: 2.0.24
 Summary: Command-line interface for the Mammoth Analytics platform
 Project-URL: homepage, https://mammoth.io
 Project-URL: repository, https://github.com/EdgeMetric/mammothsdk

{mammoth_cli-2.0.23 → mammoth_cli-2.0.24}/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.23"
+__version__ = "2.0.24"
 
 # The versioned machine output envelope contract.
 SCHEMA_VERSION = 1

{mammoth_cli-2.0.23 → mammoth_cli-2.0.24}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.0.23
+version: 2.0.24
 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."
 ---
 
@@ -51,6 +51,10 @@ before the next step.
   family, `schema find WORDS` a search.
 - Uploads return a **dataset** id; transforms, joins, exports and previews
   take the **view** id from `view list DATASET_ID`.
+- `view list` and `view get` return the brief record (id, ds_id, name,
+  status, row_count, `metadata` columns and types, pipeline state);
+  `view get ... --input '{"fields": "__full"}'` or `view list ... --input
+  '{"full": true}'` returns the dependency and display trees too.
 - Column inputs and expressions use the exact **display names** the view
   returns, never backend aliases.
 - Destructive commands need `--yes --confirm ID`. Preserve requested

{mammoth_cli-2.0.23 → mammoth_cli-2.0.24}/mammoth_cli/bundled_skill/mammoth-cli/references/recipes/end-to-end.md

@@ -68,6 +68,8 @@ mammoth dataset list --project PROJECT_ID           # the id is gone
 mammoth project list                                # matches the baseline plus your deliverables
 # only if the task said the whole project was temporary:
 # mammoth project delete PROJECT_ID --yes --confirm PROJECT_ID
+#   202 means queued: project list can still show it for a while; project get
+#   returning resource_not_found is the proof, re-check rather than re-delete
 ```
 
 Then walk the [report checklist](../report-checklist.md). If any step

{mammoth_cli-2.0.23 → mammoth_cli-2.0.24}/mammoth_cli/bundled_skill/mammoth-cli/references/recipes/resources.md

@@ -56,10 +56,12 @@ through your context, so size costs nothing but time. Two boundaries hold:
   upload the parts, or compress it (a `.zip`/`.gz` of a CSV is accepted and
   expanded server-side).
 
-Scanning and parsing time grows with size; pass `--timeout 300` on anything
-past a few MB and, when the command returns `timeout` with a `job_handle`,
-poll with the `job get` recovery command it prints instead of uploading
-again. A bare HTTP 500 from this route (`outcome_unknown`, empty body) means
+Scanning and parsing time grows with size; the upload waits up to 300 s by
+default (`--job-timeout N` to change it) and, when the command returns
+`timeout` with a `job_handle`, poll with the `job get` recovery command it
+prints instead of uploading again: a second upload of the same file queues a
+second job behind the first, and one stuck scan job holds every later upload
+in the workspace (seen on release with jobs 667 and 708). A bare HTTP 500 from this route (`outcome_unknown`, empty body) means
 the upload service is degraded; check `job get` for a job first, do not
 retry in a loop.
 

{mammoth_cli-2.0.23 → mammoth_cli-2.0.24}/mammoth_cli/commands/view.py

@@ -231,6 +231,34 @@ def _meta(invocation: Invocation, workspace_id: int, project_id: int | None) ->
 # ---------------------------------------------------------------------------
 
 
+#: What an agent reads a view for: identity, parent, columns and types, row
+#: count, and pipeline state. The record's ``dependencies_info`` and display
+#: trees are several times that size and rarely wanted; ``fields`` (``"__full"``,
+#: ``"__standard"`` or a list) returns them.
+BRIEF_VIEW_FIELDS: tuple[str, ...] = (
+    "id",
+    "ds_id",
+    "dataset_id",
+    "name",
+    "status",
+    "row_count",
+    "column_count",
+    "metadata",
+    "pipeline_status",
+    "is_pipeline_running",
+    "is_dataview_data_in_sync",
+    "data_updated_at",
+    "updated_at",
+)
+
+
+def brief_view_record(record: Any) -> Any:
+    """Keep only :data:`BRIEF_VIEW_FIELDS` of a dataview record."""
+    if not isinstance(record, dict):
+        return record
+    return {key: record[key] for key in BRIEF_VIEW_FIELDS if key in record}
+
+
 def view_list(invocation: Invocation) -> HandlerResult:
     """List dataviews for a dataset in the active project."""
     project_id = require_project(invocation)
@@ -243,6 +271,14 @@ def view_list(invocation: Invocation) -> HandlerResult:
         parents.remember_records(
             _profile_name(invocation), auth.workspace_id, data, project_id=project_id
         )
+    if (
+        isinstance(data, dict)
+        and isinstance(data.get("dataviews"), list)
+        and not document.get("full")
+    ):
+        # The list route has no field projection in the SDK; trim each record
+        # to the brief shape ``view get`` returns (``full: true`` keeps all).
+        data = {**data, "dataviews": [brief_view_record(item) for item in data["dataviews"]]}
     return data, _meta(invocation, auth.workspace_id, project_id)
 
 

{mammoth_cli-2.0.23 → mammoth_cli-2.0.24}/mammoth_cli/commands/view_ops.py

@@ -21,7 +21,11 @@ from __future__ import annotations
 
 from typing import Any
 
-from mammoth_cli.commands.view import _require_discovery_allowed
+from mammoth_cli.commands.view import (
+    BRIEF_VIEW_FIELDS,
+    _require_discovery_allowed,
+    brief_view_record,
+)
 from mammoth_cli.context import profiles
 from mammoth_cli.errors.envelope import (
     CODE_INVALID_ARGUMENT,
@@ -304,9 +308,13 @@ def view_get(invocation: Invocation) -> HandlerResult:
         # The release operation is dataset-scoped.  Bypass the rich-object
         # resolver when the caller supplied the exact parent so no discovery
         # probe can escape the requested project/dataset.
-        kwargs: dict[str, Any] = {"dataset_id": dataset_id, "dataview_id": view_id}
-        if "fields" in document:
-            kwargs["fields"] = document["fields"]
+        kwargs: dict[str, Any] = {
+            "dataset_id": dataset_id,
+            "dataview_id": view_id,
+            # Server-side projection; the brief set unless the caller asks.
+            "fields": document.get("fields")
+            or ",".join(key for key in BRIEF_VIEW_FIELDS if key != "dataset_id"),
+        }
         with open_service(invocation) as (service, auth):
             data = service.call("mammoth.api.dataviews.DataviewsAPI.get", **kwargs)
             parents.remember(_profile_name(invocation), auth.workspace_id, {view_id: dataset_id})
@@ -324,6 +332,10 @@ def view_get(invocation: Invocation) -> HandlerResult:
         data = service.call(_symbol(invocation), **kwargs)
         payload = _view_payload(data)
         parents.remember_records(_profile_name(invocation), auth.workspace_id, payload)
+    if not document.get("fields"):
+        # The discovery path returns the standard record; trim it to the same
+        # brief shape the exact path asks the server for.
+        payload = brief_view_record(payload)
     return payload, _meta(invocation, auth.workspace_id)
 
 

{mammoth_cli-2.0.23 → mammoth_cli-2.0.24}/mammoth_cli/services/command_contract.py

@@ -578,6 +578,11 @@ _S7_ADDITIONAL_INPUT_FIELDS: dict[str, tuple[FieldSpec, ...]] = {
     # The GET data route has no server-side page size; the CLI trims the row
     # list so a read-back costs a screen of tokens, not the whole view.
     "view.data.get": (FieldSpec("limit", required=False, annotation=int, default=50),),
+    # The dataview GET takes a server-side projection: "__min", "__standard",
+    # "__full" or a comma-separated field list.
+    "view.get": (FieldSpec("fields", required=False, annotation=str | None, default=None),),
+    # ``view list`` records are trimmed to the brief shape; ``full`` keeps them.
+    "view.list": (FieldSpec("full", required=False, annotation=bool, default=False),),
     "activity.list": (
         FieldSpec("project_id", required=False, annotation=int | None, default=None),
         FieldSpec("workspace_id", required=False, annotation=int | None, default=None),

{mammoth_cli-2.0.23 → mammoth_cli-2.0.24}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mammoth-cli"
-version = "2.0.23"
+version = "2.0.24"
 description = "Command-line interface for the Mammoth Analytics platform"
 authors = [{name = "Mammoth Analytics", email = "support@mammoth.io"}]
 readme = "README.md"