mammoth-cli 2.0.52__tar.gz → 2.0.54__tar.gz

{mammoth_cli-2.0.52 → mammoth_cli-2.0.54}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.0.52
+Version: 2.0.54
 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.23
+Requires-Dist: mammoth-io<0.8,>=0.7.25
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.13
 Requires-Dist: pyyaml<7,>=6

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

{mammoth_cli-2.0.52 → mammoth_cli-2.0.54}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.0.52
+version: 2.0.54
 description: "Use Mammoth Analytics from a terminal: install or authenticate the CLI, discover its live command contract, and safely manage projects, data, views, pipelines (join, merge, pivot, filter, clean), dashboards, exports, and handoffs."
 ---
 
@@ -140,10 +140,10 @@ your report. If no column links the files, ask before you combine them.
 - `mammoth skill show --input '{"file": "references/recipes/transforms.md"}'`
   prints any file of this skill; `mammoth skill agents-md install` writes a
   steering block into a repository's AGENTS.md so later sessions start here.
-- `COMMAND --help` lists the input fields with types; `mammoth schema get
-  COMMAND_ID` is the full contract (add `--input '{"full": true}'` for the
-  JSON Schema); `schema list` is the family index, `schema list view` one
-  family, `schema find WORDS` a search.
+- `COMMAND --help` lists input fields; `schema find WORDS` inlines
+  `accepted_fields`/`agent_example` for top matches, else `mammoth schema
+  get COMMAND_ID` (`--input '{"full": true}'` for the schema); `schema
+  list`/`schema list view` list families.
 - 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,

{mammoth_cli-2.0.52 → mammoth_cli-2.0.54}/mammoth_cli/bundled_skill/mammoth-cli/references/jobs-drafts.md

@@ -9,7 +9,9 @@ happens with the job, so you do not have to guess:
   envelope says `"status": "done"` and `"pipeline_state": "ready"`: the
   pipeline has finished, so do not poll its `future_id`; verify the values
   with `view data get`. (With SDK ≤ 0.7.13 the same envelope said
-  `"processing"`; it meant the same thing.)
+  `"processing"`; it meant the same thing.) If the view's auto-run is off,
+  the same call instead returns `"status": "staged"` with a `message`
+  naming `view draft submit VIEW_ID` — run that to actually execute it.
 - Only a `returns_job` command normally needs you to wait on the job id
   explicitly:
   ```bash
@@ -27,7 +29,13 @@ is `outcome_unknown`. Re-read the exact target and scope before replaying it;
 the operation may already have committed.
 
 ## Draft mode
-Batch several pipeline edits, then submit them together:
+With auto-run on (the normal mode), every pipeline change reruns the whole
+pipeline. On a big view, say 1M rows, adding 3 rules runs it 3 times. When you
+know up front that you will make several changes, enter draft mode, add them
+all, then submit: the pipeline runs once. A staged change has no data until the
+submit, so read back after it, not before. A view already in draft mode (auto-run
+off) answers each change with `"status": "staged"`; add the rest, then submit
+once.
 ```bash
 mammoth view draft enter 1039 --project 180
 mammoth view transform add-column 1039 --project 180 \

{mammoth_cli-2.0.52 → mammoth_cli-2.0.54}/mammoth_cli/commands/folder.py

@@ -156,8 +156,9 @@ def folder_find(invocation: Invocation) -> HandlerResult:
     return {
         "matches": matches,
         "projects_searched": len(projects),
-        "projects_truncated": invocation.project is None
-        and len(projects) >= _MAX_PROJECTS_SEARCHED,
+        "projects_truncated": (
+            invocation.project is None and len(projects) >= _MAX_PROJECTS_SEARCHED
+        ),
     }, meta
 
 
@@ -240,13 +241,39 @@ def folder_update(invocation: Invocation) -> HandlerResult:
 
 
 def folder_move(invocation: Invocation) -> HandlerResult:
-    """Move resources into a target folder in the active project."""
+    """Move resources into a target folder in the active project.
+
+    One of ``resource_ids``, ``dataset_ids``, or ``view_ids`` is required.
+    ``dataset_ids``/``view_ids`` take the plain ids ``dataset get``/``view
+    get`` return and are resolved to resource ids by the SDK; ``resource_ids``
+    is for when the caller already has a resource id from elsewhere.
+    """
     project_id = require_project(invocation)
-    document = invocation.load_input()
-    resource_ids = _require_field(document, "resource_ids")
-    kwargs: dict[str, Any] = {"resource_ids": resource_ids, "project_id": project_id}
-    assert document is not None
-    _forward_optional(document, kwargs, ("target_folder_resource_id", "source_folder_resource_id"))
+    document = invocation.load_input() or {}
+    kwargs: dict[str, Any] = {"project_id": project_id}
+    _forward_optional(
+        document,
+        kwargs,
+        (
+            "resource_ids",
+            "dataset_ids",
+            "view_ids",
+            "target_folder_resource_id",
+            "source_folder_resource_id",
+        ),
+    )
+    if not any(field in kwargs for field in ("resource_ids", "dataset_ids", "view_ids")):
+        raise CliError(
+            code=CODE_MISSING_FIELD,
+            message=(
+                "This command requires one of 'resource_ids', 'dataset_ids', " "or 'view_ids'."
+            ),
+            exit_status=EXIT_USAGE,
+            hint=(
+                "Pass it via --input, e.g. "
+                '--input \'{"dataset_ids": [1407], "target_folder_resource_id": 3445}\'.'
+            ),
+        )
     with open_service(invocation) as (service, auth):
         data = service.call(_symbol(invocation), **kwargs)
     return data, _meta(invocation, auth.workspace_id, project_id)

{mammoth_cli-2.0.52 → mammoth_cli-2.0.54}/mammoth_cli/commands/project.py

@@ -572,6 +572,20 @@ def project_check(invocation: Invocation) -> HandlerResult:
             }
             if "before_dashboard" in preview:
                 entry["before_dashboard"] = preview["before_dashboard"]
+            other_views = preview.get("other_views")
+            if other_views:
+                # Only the first (most recent) view is previewed and checked.
+                # Say so explicitly instead of letting silence read as "this
+                # is the only view" -- which view to change is the user's
+                # call unless they already named one.
+                entry["other_views"] = other_views
+                other_desc = ", ".join(f"{v['id']} ({v.get('name')})" for v in other_views)
+                to_report.append(
+                    f"dataset {dataset.get('name')} (id {dataset_id}) has "
+                    f"{len(other_views) + 1} views; only view {preview['view_id']} was "
+                    f"checked (others: {other_desc}). Which view to change is the "
+                    "user's pick unless they named one."
+                )
             views.append(entry)
             where = f"view {preview['view_id']} ({dataset.get('name')})"
             to_report += [_report_line(where, w) for w in entry["column_warnings"]]

{mammoth_cli-2.0.52 → mammoth_cli-2.0.54}/mammoth_cli/commands/schema.py

@@ -227,6 +227,14 @@ _SCOPE_REQUIREMENTS: dict[str, dict[str, Any]] = {
 
 _MAX_FIND_RESULTS = 20
 _MAX_FIND_LIMIT = 100
+# How many of a find's top matches carry inline accepted_fields/agent_example.
+# 35% of all eval tool calls were command discovery (schema find -> schema
+# get) because find's compact entry gave a command_id but not what to pass
+# it; inlining the top few lets an agent act without a second round trip in
+# the common case where one of them is right. Bounded to a few commands so a
+# broad query never balloons the result (the tool result goes into the
+# model's context).
+_INLINE_DETAIL_COUNT = 3
 
 # Search is intentionally a small, deterministic intent matcher rather than a
 # fuzzy/remote search service.  The aliases describe language users commonly
@@ -369,6 +377,19 @@ def _accepted_fields(record: dict[str, Any]) -> list[dict[str, Any]] | None:
     ]
 
 
+def _compact_accepted_fields(record: dict[str, Any]) -> list[dict[str, Any]] | None:
+    """``_accepted_fields`` without the per-field JSON Schema.
+
+    A find result inlines this for its top matches: enough to compose a call
+    (name, type, required, enum) without the nested-schema detail ``schema
+    get`` returns.
+    """
+    fields = _accepted_fields(record)
+    if fields is None:
+        return None
+    return [{key: field[key] for key in ("name", "type", "required", "enum")} for field in fields]
+
+
 def _externally_supplied_fields(command_id: str) -> frozenset[str]:
     """Fields supplied by positionals or authenticated CLI context."""
     if command_id in LOCAL_COMMANDS:
@@ -1301,6 +1322,17 @@ def find_schemas(
     )
     total_matches = len(ranked_matches)
     page = [match for _, match in ranked_matches[offset : offset + bounded_limit]]
+    for rank, match in enumerate(page, start=offset):
+        if rank >= _INLINE_DETAIL_COUNT:
+            break
+        match_record = command_by_id(match["command_id"])
+        if match_record is None:
+            continue
+        fields = _compact_accepted_fields(match_record)
+        if fields is not None:
+            match["accepted_fields"] = fields
+        if match_record.get("agent_example"):
+            match["agent_example"] = match_record["agent_example"]
     has_more = offset + len(page) < total_matches
     continuation = (
         {

{mammoth_cli-2.0.52 → mammoth_cli-2.0.54}/mammoth_cli/commands/view.py

@@ -2307,16 +2307,25 @@ def view_export_specialized(invocation: Invocation) -> HandlerResult:
         if is_dataset_route and isinstance(data, int):
             # The SDK returns the bare id of the dataset written to; name it, and
             # say which project it landed in, so the agent's next read is obvious.
+            # The written dataset's view id/name is resolved here too: an append
+            # (save_as_mode=APPEND_TO_DS) never changes it, so telling the agent
+            # to go re-list every time -- as a text-only 'next' hint used to --
+            # cost one avoidable round trip per append to the same dataset. Best
+            # effort: a failed lookup falls back to the old hint instead.
             data = {
                 "dataset_id": data,
                 "project_id": result_project_id,
                 "source_view_id": dataview_id,
-                "next": (
-                    f"mammoth view list {data}"
-                    + (f" --project {result_project_id}" if target_project is not None else "")
-                ),
             }
-            rows_after = _dataset_row_count(service, data["dataset_id"], result_project_id)
+            view_info = _dataset_view_info(service, data["dataset_id"], result_project_id)
+            if view_info is not None:
+                data["view_id"] = view_info["id"]
+                data["view_name"] = view_info["name"]
+            else:
+                data["next"] = f"mammoth view list {data['dataset_id']}" + (
+                    f" --project {result_project_id}" if target_project is not None else ""
+                )
+            rows_after = view_info["row_count"] if view_info is not None else None
             if rows_after is not None:
                 data["rows_after"] = rows_after
             if rows_before is not None:
@@ -2342,6 +2351,35 @@ def _dataset_row_count(service: Any, dataset_id: int, project_id: int | None) ->
         return None
 
 
+def _dataset_view_info(
+    service: Any, dataset_id: int, project_id: int | None
+) -> dict[str, Any] | None:
+    """Id, name, and row count of a dataset's current (most recent) view, best effort.
+
+    Used right after ``view.export.dataset`` writes to ``dataset_id``: the
+    id/name let the response carry the view an agent needs next instead of a
+    'go list it' hint (an append never changes it), and the row count feeds
+    ``rows_after`` -- one listing call instead of two. Any failure returns
+    None; the caller falls back to the 'next' hint and skips ``rows_after``.
+    """
+    try:
+        listing = service.call(_DATAVIEW_LIST_SYMBOL, dataset_id=dataset_id, project_id=project_id)
+        views = listing.get("dataviews") if isinstance(listing, dict) else None
+        if not isinstance(views, list) or not views or not isinstance(views[0], dict):
+            return None
+        view_id = views[0].get("id")
+        if not isinstance(view_id, int):
+            return None
+    except Exception:  # noqa: BLE001 -- best effort; the caller's fallbacks still work
+        return None
+    row_count = views[0].get("row_count")
+    return {
+        "id": view_id,
+        "name": views[0].get("name"),
+        "row_count": int(row_count) if row_count is not None else None,
+    }
+
+
 _DATAVIEW_LIST_SYMBOL = "mammoth.api.dataviews.DataviewsAPI.list"
 #: Rows an upload shows of each new view (enough to see keys and formats).
 _UPLOAD_SAMPLE_ROWS = 3
@@ -2365,6 +2403,15 @@ def upload_preview(service: Any, dataset_id: int, project_id: int | None) -> dic
         views = listing.get("dataviews") if isinstance(listing, dict) else None
         if not isinstance(views, list) or not views or not isinstance(views[0], dict):
             return None
+        # A dataset with more than one live view has one previewed here; the
+        # rest are named (id + name) so a caller (``project.check``) can say
+        # a view besides the one checked exists, rather than silently acting
+        # on the single view this function happens to preview.
+        other_views = [
+            {"id": other.get("id"), "name": other.get("name")}
+            for other in views[1:]
+            if isinstance(other, dict) and isinstance(other.get("id"), int)
+        ]
         record = apply_column_renames(views[0])
         view_id = record.get("id")
         if not isinstance(view_id, int):
@@ -2412,6 +2459,8 @@ def upload_preview(service: Any, dataset_id: int, project_id: int | None) -> dic
         hints = []
     if hints:
         preview["before_dashboard"] = {"warnings": hints, "note": UPLOAD_NOTE}
+    if other_views:
+        preview["other_views"] = other_views
     return preview
 
 

{mammoth_cli-2.0.52 → mammoth_cli-2.0.54}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "mammoth-cli"
-version = "2.0.52"
+version = "2.0.54"
 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.23,<0.8)",
+    "mammoth-io (>=0.7.25,<0.8)",
     "typer (>=0.27,<0.28)",
     "rich (>=15,<16)",
     "platformdirs (>=4.10,<5)",

{mammoth_cli-2.0.52 → mammoth_cli-2.0.54}/spec/manifests/commands/folder.yaml

@@ -260,8 +260,11 @@ commands:
   - CT-FOLDER-MOVE-ERROR
   draft_test: null
   undo_test: null
-  known_restrictions: 'B05 FOLDER_MOVE_NO_WAIT: SDK returns ObjectJobSchema but exposes no public wait
-    method; do not advertise --wait/--no-wait.'
+  known_restrictions: Prefer dataset_ids/view_ids (the plain ids dataset get/view get return) over resource_ids
+    -- the SDK resolves them to resource ids for you. resource_ids itself takes each item's resource id,
+    not a dataset/view's own id. target_folder_resource_id is the destination folder's id field, exactly
+    as folder list/folder get/folder create return it (NOT the folder's resource_id field, despite this
+    parameter's name).
   reviewed_by: primary
 - command_id: folder.root
   command_path: folder root

{mammoth_cli-2.0.52 → mammoth_cli-2.0.54}/spec/manifests/sdk-catalog.source.yaml

@@ -2507,8 +2507,14 @@ sdk_methods:
   wait_policy: returns_job
   pagination_policy: none
   openapi_operation_ids: []
-  notes: 'B05 FOLDER_MOVE_NO_WAIT: SDK returns ObjectJobSchema but exposes no public wait method; do not
-    advertise --wait/--no-wait.'
+  # Internal-only: B05 FOLDER_MOVE_NO_WAIT — SDK returns ObjectJobSchema but exposes no public wait
+  # method; do not advertise --wait/--no-wait. Kept here (not in `notes`, which build_manifests.py
+  # surfaces verbatim as the agent-facing known_restrictions) per the T2-J-013 fix.
+  notes: 'Prefer dataset_ids/view_ids (the plain ids dataset get/view get return) over resource_ids
+    -- the SDK resolves them to resource ids for you. resource_ids itself takes each item''s resource
+    id, not a dataset/view''s own id. target_folder_resource_id is the destination folder''s id field,
+    exactly as folder list/folder get/folder create return it (NOT the folder''s resource_id field,
+    despite this parameter''s name).'
 - sdk_symbol: mammoth.api.folders.FoldersAPI.trash
   canonical_command: folder.trash
   alias_of: null

{mammoth_cli-2.0.52 → mammoth_cli-2.0.54}/spec/manifests/sdk-methods.yaml

@@ -4130,7 +4130,7 @@ methods:
   reviewed_by: primary
 - sdk_symbol: mammoth.api.folders.FoldersAPI.move
   implementation_origin: mammoth.api.folders.FoldersAPI.move
-  signature: 'move(self, resource_ids: ''_list[str]'', target_folder_resource_id: ''str | None'' = None, source_folder_resource_id: ''str | None'' = None, workspace_id: ''int | None'' = None, project_id: ''int | None'' = None) -> ''ObjectJobSchema'''
+  signature: 'move(self, resource_ids: ''_list[str] | None'' = None, target_folder_resource_id: ''str | None'' = None, source_folder_resource_id: ''str | None'' = None, workspace_id: ''int | None'' = None, project_id: ''int | None'' = None, *, dataset_ids: ''_list[int] | None'' = None, view_ids: ''_list[int] | None'' = None) -> ''ObjectJobSchema'''
   openapi_operation_ids: []
   canonical_command: folder.move
   alias_of: null