mammoth-cli 2.2.9__tar.gz → 2.2.10__tar.gz

{mammoth_cli-2.2.9 → mammoth_cli-2.2.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.2.9
+Version: 2.2.10
 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.9,>=0.8.10
+Requires-Dist: mammoth-io<0.9,>=0.8.11
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.12.5
 Requires-Dist: pyyaml<7,>=6

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

{mammoth_cli-2.2.9 → mammoth_cli-2.2.10}/mammoth_cli/bundled_skill/mammoth-cli/references/capabilities.md

@@ -1,7 +1,7 @@
 # What is proven on release
 
 Generated from `docs/release-capability-matrix.json`; do not edit by hand.
-The CLI publishes 633 commands. 455 of them bind one of the 528 API operations in the matrix; the remainder are local commands (`schema`, `auth`, `doctor`, `log`, ...) or typed variants that share an operation (`view transform *` commands submit through `view.task.add`, except `rename-columns` and `sort`, which set view display properties through `view.update`). 262 bound commands ran once successfully on release, 2 are not supported there, and the rest are untried. Untried is not broken: discover the contract with `mammoth schema get COMMAND_ID`, run it, and treat the structured error envelope as the answer. Use an untried command normally: confirm a write with the user first, check its result with a read afterwards, and never refuse a command only because it is untried.
+The CLI publishes 633 commands. 504 of them bind one of the 545 API operations in the matrix; the remainder are local commands (`schema`, `auth`, `doctor`, `log`, ...) or typed variants that share an operation (`view transform *` commands submit through `view.task.add`, except `rename-columns` and `sort`, which set view display properties through `view.update`). 262 bound commands ran once successfully on release, 1 are not supported there, and the rest are untried. Untried is not broken: discover the contract with `mammoth schema get COMMAND_ID`, run it, and treat the structured error envelope as the answer. Use an untried command normally: confirm a write with the user first, check its result with a read afterwards, and never refuse a command only because it is untried.
 
 Status meanings:
 
@@ -17,20 +17,21 @@ The typed `view transform *` commands all submit through `view.task.add` (`renam
 
 | Family | Commands | Ran once | Not supported | Untried |
 |---|---|---|---|---|
-| `dashboard` | 104 | 81 | 2 | 21 |
+| `dashboard` | 122 | 81 | 1 | 40 |
+| `support` | 66 | 9 | 0 | 57 |
 | `view` | 62 | 58 | 0 | 4 |
-| `support` | 45 | 9 | 0 | 36 |
+| `billing` | 24 | 4 | 0 | 20 |
 | `connector` | 22 | 3 | 0 | 19 |
-| `billing` | 21 | 4 | 0 | 17 |
-| `workspace` | 19 | 7 | 0 | 12 |
-| `dataset` | 17 | 12 | 0 | 5 |
+| `workspace` | 20 | 7 | 0 | 13 |
+| `dataset` | 18 | 12 | 0 | 6 |
 | `project` | 17 | 15 | 0 | 2 |
 | `workflow` | 16 | 9 | 0 | 7 |
 | `parameter` | 14 | 7 | 0 | 7 |
 | `data-app` | 12 | 1 | 0 | 11 |
+| `automation` | 8 | 3 | 0 | 5 |
+| `browse` | 8 | 1 | 0 | 7 |
 | `folder` | 8 | 8 | 0 | 0 |
 | `snippet` | 8 | 6 | 0 | 2 |
-| `automation` | 7 | 3 | 0 | 4 |
 | `user` | 7 | 3 | 0 | 4 |
 | `webhook` | 7 | 5 | 0 | 2 |
 | `addon` | 6 | 0 | 0 | 6 |
@@ -43,7 +44,6 @@ The typed `view transform *` commands all submit through `view.task.add` (`renam
 | `notification` | 5 | 1 | 0 | 4 |
 | `schedule` | 5 | 0 | 0 | 5 |
 | `template` | 5 | 5 | 0 | 0 |
-| `browse` | 4 | 1 | 0 | 3 |
 | `external-key` | 4 | 1 | 0 | 3 |
 | `trash` | 3 | 3 | 0 | 0 |
 | `activity` | 2 | 1 | 0 | 1 |
@@ -58,7 +58,6 @@ Ran once: `dashboard.action`, `dashboard.analytics`, `dashboard.archive`, `dashb
 
 | Command | State | Note |
 |---|---|---|
-| `dashboard.create` | not supported | Not supported on release: backend returns HTTP 409 4DASH012 DASHBOARD_LEGACY_CREATION_RETIRED (legacy dashboard creation retired). Use dashboard.create-blank or dashboard.v3.generate. Dashboard sweep 2026-09-18, CLI 2.0.12. |
 | `dashboard.pdf.export` | not supported | Not supported from the CLI on release: backend HTTP 400 4GENR001 requires params.data to be the browser-hydrated DashboardData map and states it cannot rebuild it from stored descriptors (dashboard sweep and Haiku e2e, 2026-09-18). The route works only with a client render pass. |
 | `dashboard.data.draft` | observed blocker | blocked_missing_fixture: Dashboard 56 (create-blank/v3 engine) has no widgets in its canvas and getDraftData rejects with backend_code 4DASH004 DASHBOARD_WRONG_ENGINE: "This dashbo |
 | `dashboard.data.published` | observed blocker | blocked_missing_fixture: Same as dashboard.data.draft: backend_code 4DASH004 DASHBOARD_WRONG_ENGINE on /dashboards/56/getPublishData |
@@ -110,7 +109,7 @@ Ran once: `project.bulk-delete`, `project.bulk-update`, `project.checkpoint.list
 
 ## `view`
 
-Ran once: `view.active-user.list`, `view.active-user.mark`, `view.ai.generate-data`, `view.ai.profile`, `view.bulk-delete`, `view.checkpoint.create`, `view.checkpoint.delete`, `view.checkpoint.get`, `view.checkpoint.list`, `view.checkpoint.update`, `view.conditional-format.create`, `view.conditional-format.delete-all`, `view.conditional-format.list`, `view.conditional-format.update`, `view.create`, `view.data-check.create`, `view.data-check.delete`, `view.data-check.get`, `view.data-check.list`, `view.data.get`, `view.data.query`, `view.delete`, `view.derivative.create`, `view.derivative.data`, `view.derivative.delete`, `view.derivative.list`, `view.derivative.update`, `view.draft.command`, `view.export.create`, `view.export.delete`, `view.export.get`, `view.export.list`, `view.export.publish-db`, `view.export.update`, `view.exportable-config.apply`, `view.exportable-config.get`, `view.get`, `view.list`, `view.parameter-context`, `view.pipeline.edit`, `view.pipeline.get`, `view.pipeline.items`, `view.pipeline.rerun`, `view.preview`, `view.restore`, `view.task.add`, `view.task.delete`, `view.task.get`, `view.task.list`, `view.task.preview`, `view.task.update`, `view.trash`, `view.version.apply`, `view.version.delete`, `view.version.get`, `view.version.list`, `view.version.update`
+Ran once: `view.active-user.list`, `view.active-user.mark`, `view.ai.generate-data`, `view.ai.profile`, `view.bulk-delete`, `view.checkpoint.create`, `view.checkpoint.delete`, `view.checkpoint.get`, `view.checkpoint.list`, `view.checkpoint.update`, `view.conditional-format.create`, `view.conditional-format.delete-all`, `view.conditional-format.list`, `view.conditional-format.update`, `view.create`, `view.data-check.create`, `view.data-check.delete`, `view.data-check.get`, `view.data-check.list`, `view.data.aggregate`, `view.data.get`, `view.data.query`, `view.delete`, `view.derivative.create`, `view.derivative.data`, `view.derivative.delete`, `view.derivative.list`, `view.derivative.update`, `view.draft.command`, `view.export.create`, `view.export.delete`, `view.export.get`, `view.export.list`, `view.export.publish-db`, `view.export.update`, `view.exportable-config.apply`, `view.exportable-config.get`, `view.get`, `view.list`, `view.parameter-context`, `view.pipeline.edit`, `view.pipeline.get`, `view.pipeline.items`, `view.pipeline.rerun`, `view.preview`, `view.restore`, `view.task.add`, `view.task.delete`, `view.task.get`, `view.task.list`, `view.task.preview`, `view.task.update`, `view.trash`, `view.version.apply`, `view.version.delete`, `view.version.get`, `view.version.list`, `view.version.update`
 
 | Command | State | Note |
 |---|---|---|

{mammoth_cli-2.2.9 → mammoth_cli-2.2.10}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/view.md

@@ -220,7 +220,7 @@ Example: `mammoth view data aggregate 123 --input '{"group_by": ["Channel"], "ag
 
 Result: `ViewDataAggregateResult`; mutation `read`, confirmation `none`, wait policy `always_wait`.
 
-Status on release: untried; no live run recorded.
+Status on release: ran once on CLI 2.0.18 — golden-data check 2026-09-19 (CLI 2.0.18): condition on the pivoted view compiled to the backend clause shape and answered (exit 0); EQ with a column select and an AND of CONTAINS/NE also verified read-only on a pre-existing view. Before 2.0.18 the spec was f…
 
 ### `view.data.compare`
 
@@ -270,7 +270,7 @@ Example: `mammoth view data query 123 123`. Placeholders are illustrative; resol
 
 Result: `ViewDataQueryResult`; mutation `read`, confirmation `none`, wait policy `always_wait`.
 
-Status on release: ran once on CLI 2.0.18 — golden-data check 2026-09-19 (CLI 2.0.18): condition on the pivoted view compiled to the backend clause shape and answered (exit 0); EQ with a column select and an AND of CONTAINS/NE also verified read-only on a pre-existing view. Before 2.0.18 the spec was f…
+Status on release: ran once on CLI 2.0.28 — ILG simulation 2026-09-19: exit 0 on release with CLI 2.0.28. Paged reads (limit up to 500) used for every value check; envelope data.data rows keyed by display name. Single invocation only.
 
 ### `view.delete`
 

{mammoth_cli-2.2.9 → mammoth_cli-2.2.10}/mammoth_cli/commands/dashboard.py

@@ -396,6 +396,10 @@ def dashboard_get(invocation: Invocation) -> HandlerResult:
     return data, _meta(invocation, auth.workspace_id)
 
 
+#: Sources whose owning dataset one ``dashboard get`` looks up (one request each).
+_MAX_SOURCE_LOOKUPS = 20
+
+
 def _source_dataset(service: Any, invocation: Invocation, workspace_id: Any, view_id: int) -> Any:
     """The dataset that owns ``view_id``: remembered, else looked up; never raises."""
     profile_name = invocation.profile or profiles.get_selected()
@@ -422,16 +426,18 @@ def _with_source_datasets(
     sources = data.get("sources") if isinstance(data, dict) else None
     if not isinstance(sources, list) or not sources:
         return data
+    view_ids = [view_id for view_id in sources if isinstance(view_id, int)]
     views = [
         _source_dataset(service, invocation, workspace_id, view_id)
-        for view_id in sources
-        if isinstance(view_id, int)
+        for view_id in view_ids[:_MAX_SOURCE_LOOKUPS]
     ]
-    return {
-        **data,
-        "source_views": views,
-        "sources_note": "sources are view ids; use a source's dataset_id for dataset commands.",
-    }
+    note = "sources are view ids; use a source's dataset_id for dataset commands."
+    if len(view_ids) > _MAX_SOURCE_LOOKUPS:
+        note += (
+            f" Only the first {_MAX_SOURCE_LOOKUPS} of {len(view_ids)} sources were labelled;"
+            " read the others with 'view get VIEW_ID'."
+        )
+    return {**data, "source_views": views, "sources_note": note}
 
 
 def _with_board_project(data: Any) -> Any:

{mammoth_cli-2.2.9 → mammoth_cli-2.2.10}/mammoth_cli/commands/dataset.py

@@ -196,6 +196,63 @@ def _find_in_projects(
     return matches
 
 
+#: Pages of resource search read for one name (100 hits each); past it the result says so.
+_SEARCH_PAGES = 5
+_SEARCH_PAGE_SIZE = 100
+
+
+def search_hits(
+    service: Any, resource_type: str, needle: str, project_id: int | None = None
+) -> tuple[list[dict[str, Any]], bool]:
+    """Resources of ``resource_type`` whose name contains ``needle``, from the search route.
+
+    One request (one more per 100 hits) replaces a listing per project: the
+    workspace search, or the project's own resource list when ``project_id`` is
+    given. Returns the minimal rows and whether the read stopped at
+    ``_SEARCH_PAGES`` pages with more hits unread.
+    """
+    symbol = (
+        "mammoth.api.browse.BrowseAPI.resources_search"
+        if project_id is None
+        else "mammoth.api.browse.BrowseAPI.resources_list"
+    )
+    scope: dict[str, Any] = {} if project_id is None else {"project_id": project_id}
+    rows: list[dict[str, Any]] = []
+    cursor: str | None = None
+    for _ in range(_SEARCH_PAGES):
+        page = service.call(
+            symbol,
+            search=needle,
+            resource_type=resource_type,
+            limit=_SEARCH_PAGE_SIZE,
+            cursor=cursor,
+            fields="minimal",
+            **scope,
+        )
+        rows += [r for r in page.get("resources", []) if isinstance(r, dict)]
+        cursor = page.get("next_cursor")
+        if not (page.get("has_more") and cursor):
+            return rows, False
+    return rows, True
+
+
+def search_cut_note(kind: str) -> str:
+    """Said when a name search stopped early, with how to narrow it."""
+    return (
+        f"The name matched more than {_SEARCH_PAGES * _SEARCH_PAGE_SIZE} {kind}, so only the "
+        "first of them were read. Use a longer name, or --project, to narrow it."
+    )
+
+
+def _projects_holding(
+    service: Any, needle: str, visible: list[dict[str, Any]]
+) -> tuple[list[dict[str, Any]], bool]:
+    """The visible projects that hold a dataset whose name contains ``needle``."""
+    rows, cut = search_hits(service, "datasource", needle)
+    holding = {r.get("project_id") for r in rows}
+    return [p for p in visible if p.get("id") in holding], cut
+
+
 def _other_projects(visible: list[dict[str, Any]], project_id: int) -> list[dict[str, Any]]:
     """Every visible project except ``project_id``."""
     return [p for p in visible if p.get("id") != project_id]
@@ -232,16 +289,20 @@ def dataset_find(invocation: Invocation) -> HandlerResult:
     skipped: list[dict[str, Any]] = []
     with open_service(invocation) as (service, auth):
         visible = _visible_projects(service)
+        cut = False
         if invocation.project is not None:
             projects: list[dict[str, Any]] = [named_project(service, invocation.project, visible)]
             matches = _find_in_projects(service, needle, projects, skipped)
             if not matches:
-                others = _other_projects(visible, invocation.project)
-                matches = _find_in_projects(service, needle, others, skipped)
-                projects += others
+                holding, cut = _projects_holding(service, needle, visible)
+                matches = _find_in_projects(
+                    service, needle, _other_projects(holding, invocation.project), skipped
+                )
+                projects += _other_projects(visible, invocation.project)
         else:
             projects = visible
-            matches = _find_in_projects(service, needle, projects, skipped)
+            holding, cut = _projects_holding(service, needle, visible)
+            matches = _find_in_projects(service, needle, holding, skipped)
         meta = {
             "profile": invocation.profile,
             "workspace_id": auth.workspace_id,
@@ -253,7 +314,11 @@ def dataset_find(invocation: Invocation) -> HandlerResult:
     }
     if skipped:
         result["projects_skipped"] = skipped
-    if note := ambiguity_note(len(matches), name_substring):
+    notes = [ambiguity_note(len(matches), name_substring)]
+    if cut:
+        result["truncated"] = True
+        notes.append(search_cut_note("datasets"))
+    if note := " ".join(n for n in notes if n):
         result["note"] = note
     return result, meta
 
@@ -304,8 +369,9 @@ def _dataset_name_search(
         records = data.get("datasets", []) if isinstance(data, dict) else []
         page = search_page(records, name, int(document.get("offset", 0)), document.get("limit"))
         if page["matched"] == 0:
+            holding, cut = _projects_holding(service, name.lower(), _visible_projects(service))
             elsewhere = _find_in_projects(
-                service, name.lower(), _other_projects(_visible_projects(service), project_id)
+                service, name.lower(), _other_projects(holding, project_id)
             )
             if elsewhere:
                 page["in_other_projects"] = elsewhere
@@ -313,6 +379,11 @@ def _dataset_name_search(
                     f"No dataset in project {project_id} matches; the ones listed in "
                     "in_other_projects do. Run the next call with --project <its project_id>."
                 )
+            if cut:
+                page["truncated"] = True
+                page["note"] = " ".join(
+                    filter(None, (page.get("note"), search_cut_note("datasets")))
+                )
     page["name"] = name
     return page, _meta(invocation, auth.workspace_id, project_id)
 

{mammoth_cli-2.2.9 → mammoth_cli-2.2.10}/mammoth_cli/commands/file.py

@@ -237,9 +237,17 @@ def file_upload(invocation: Invocation) -> HandlerResult:
         # the status the platform holds for each dataset, not an assumed one.
         result = _upload_result(data, lambda dataset_id: _dataset_status(service, dataset_id))
         project_id = resolved_project(invocation)
+        previewed = 0
         for entry in result["datasets"]:
             if entry.get("status") != "ready":
                 continue
+            if previewed >= _UPLOAD_PREVIEW_LIMIT:
+                entry["preview_skipped"] = (
+                    f"Only the first {_UPLOAD_PREVIEW_LIMIT} datasets are previewed; "
+                    f"run 'view list {entry['id']}' to see this one."
+                )
+                continue
+            previewed += 1
             preview = upload_preview(service, int(entry["id"]), project_id)
             if "preview_error" in preview:
                 entry["preview_error"] = preview["preview_error"]
@@ -253,6 +261,10 @@ def file_upload(invocation: Invocation) -> HandlerResult:
     return result, _meta(invocation, auth.workspace_id, resolved_project(invocation))
 
 
+#: Uploaded datasets one ``file upload`` previews (several requests each).
+_UPLOAD_PREVIEW_LIMIT = 5
+
+
 def _require_local_files(files: Any) -> None:
     """Fail as a usage error, naming the path, when a local file is missing.
 

{mammoth_cli-2.2.9 → mammoth_cli-2.2.10}/mammoth_cli/commands/folder.py

@@ -11,7 +11,7 @@ from __future__ import annotations
 
 from typing import Any
 
-from mammoth_cli.commands.dataset import named_project
+from mammoth_cli.commands.dataset import named_project, search_cut_note, search_hits
 from mammoth_cli.errors.envelope import (
     CODE_INVALID_ARGUMENT,
     CODE_MISSING_ARGUMENT,
@@ -107,45 +107,40 @@ def _require_string_positional(invocation: Invocation, name: str) -> str:
 def folder_find(invocation: Invocation) -> HandlerResult:
     """Search folder names for a substring across every visible project.
 
-    Read-only local composite: lists the projects the credential can see (or
-    just the one named by ``--project``), then lists folders in each and
-    keeps a case-insensitive substring match. Does not require an active
-    project.
+    Read-only local composite: one resource-search request (the workspace's, or
+    the project's with ``--project``) returns every folder whose name contains
+    the substring, case-insensitively, and the projects the credential can see
+    name them. Does not require an active project.
     """
     name_substring = _require_string_positional(invocation, "name substring")
-    needle = name_substring.lower()
-    matches: list[dict[str, Any]] = []
     with open_service(invocation) as (service, auth):
         visible = list(service.list_all_projects())
         if invocation.project is not None:
             projects: list[dict[str, Any]] = [named_project(service, invocation.project, visible)]
         else:
             projects = visible
-        for project in projects:
-            project_id = project.get("id")
-            if project_id is None:
-                continue
-            project_name = project.get("name")
-            for folder in _project_folders(service, project_id):
-                name = folder.get("name") if isinstance(folder, dict) else None
-                if isinstance(name, str) and needle in name.lower():
-                    matches.append(
-                        {
-                            "project_id": project_id,
-                            "project_name": project_name,
-                            "id": folder.get("id"),
-                            "name": name,
-                        }
-                    )
+        rows, cut = search_hits(service, "label", name_substring, invocation.project)
+        names = {p.get("id"): p.get("name") for p in projects}
+        matches = [
+            {
+                "project_id": row["project_id"],
+                "project_name": names[row["project_id"]],
+                "id": row.get("object_id"),
+                "name": row.get("name"),
+            }
+            for row in rows
+            if row.get("project_id") in names
+        ]
         meta = {
             "profile": invocation.profile,
             "workspace_id": auth.workspace_id,
             "project_id": invocation.project,
         }
-    return {
-        "matches": matches,
-        "projects_searched": len(projects),
-    }, meta
+    result: dict[str, Any] = {"matches": matches, "projects_searched": len(projects)}
+    if cut:
+        result["truncated"] = True
+        result["note"] = search_cut_note("folders")
+    return result, meta
 
 
 def folder_list(invocation: Invocation) -> HandlerResult:

{mammoth_cli-2.2.9 → mammoth_cli-2.2.10}/mammoth_cli/commands/project.py

@@ -599,11 +599,19 @@ def _datasets_to_check(service: Any, project_id: int, scoped: int | None) -> lis
     """Every dataset of the project, or only the named one -- never a walk when scoped."""
     if scoped is not None:
         return [{"id": scoped, "name": f"dataset {scoped}"}]
-    listing = service.call(_DATASETS_LIST_SYMBOL, project_id=project_id)
+    listing = service.call(_DATASETS_LIST_SYMBOL, project_id=project_id, sort="(created_at:desc)")
     return listing.get("datasets", []) if isinstance(listing, dict) else []
 
 
-_CHECK_WORKERS = 6
+_CHECK_WORKERS = 2
+#: Most recent datasets and dashboards one ``project check`` reads (several requests each).
+_CHECK_MAX_DATASETS = 20
+_CHECK_MAX_DASHBOARDS = 10
+
+
+def _not_checked_line(kind: str, omitted: int, how: str) -> str:
+    """The report line for resources left unchecked by the cap, and how to reach them."""
+    return f"{omitted} more {kind} were not checked (only the most recent were); {how}"
 
 
 def _in_worker[T](invocation: Invocation, work: Callable[[Any, Any], T]) -> T:
@@ -751,7 +759,16 @@ def project_check(invocation: Invocation) -> HandlerResult:
     statuses: list[dict[str, Any]] = []
     scoped_dataset = _scoped_dataset_id(invocation)
     with open_service(invocation) as (service, auth):
-        datasets = _datasets_to_check(service, project_id, scoped_dataset)
+        every_dataset = _datasets_to_check(service, project_id, scoped_dataset)
+        datasets = every_dataset[:_CHECK_MAX_DATASETS]
+        if len(every_dataset) > len(datasets):
+            to_report.append(
+                _not_checked_line(
+                    "datasets",
+                    len(every_dataset) - len(datasets),
+                    "run 'project check DATASET_ID' for a specific one.",
+                )
+            )
         previews = _map_checks(
             invocation,
             service,
@@ -787,11 +804,20 @@ def project_check(invocation: Invocation) -> HandlerResult:
         boards = (
             [] if scoped_dataset else service.call(_DASHBOARDS_LIST_SYMBOL, project_id=project_id)
         )
+        every_board = [b for b in boards if isinstance(b, dict)] if isinstance(boards, list) else []
+        if len(every_board) > _CHECK_MAX_DASHBOARDS:
+            to_report.append(
+                _not_checked_line(
+                    "dashboards",
+                    len(every_board) - _CHECK_MAX_DASHBOARDS,
+                    "check one with 'dashboard get DASHBOARD_ID'.",
+                )
+            )
         results = _map_checks(
             invocation,
             service,
             auth,
-            [b for b in boards if isinstance(b, dict)] if isinstance(boards, list) else [],
+            every_board[:_CHECK_MAX_DASHBOARDS],
             _check_dashboard(invocation),
         )
         for result in filter(None, results):

{mammoth_cli-2.2.9 → mammoth_cli-2.2.10}/mammoth_cli/commands/view.py

@@ -416,9 +416,14 @@ def brief_view_record(record: Any) -> Any:
 _DATASETS_LIST_ALL_SYMBOL = "mammoth.api.datasets.DatasetsAPI.list_all"
 #: Soft floor for the no-DATASET_ID ``view list`` walk: whole per-dataset
 #: pages are pulled and appended until at least this many views have been
-#: collected (or every dataset in the project has been visited), so one call
-#: never silently returns a single dataset's worth from a large project.
-_VIEW_LIST_ALL_DATASETS_MIN_VIEWS = 100
+#: collected (or the visit cap below is reached), so one call never returns a
+#: single dataset's worth from a large project. Sized to what the agent output
+#: cap shows (about 15 summaries): reading more only to cut them is waste.
+_VIEW_LIST_ALL_DATASETS_MIN_VIEWS = 20
+#: Most datasets one no-DATASET_ID ``view list`` call reads views of, whether or
+#: not they hold any, so a project of many empty datasets costs a fixed number of
+#: requests. The result carries ``next_dataset_offset`` to resume from.
+_VIEW_LIST_ALL_DATASETS_MAX_VISITS = 25
 
 
 def view_list(invocation: Invocation) -> HandlerResult:
@@ -521,6 +526,11 @@ def _compact_view_list(
         stop = [d.get("id") for d in datasets].index(dropped)
         result["next_dataset_offset"] = stop
         result["datasets_visited"] = stop - start
+    if "next_dataset_offset" in result and not summary.get("views_omitted"):
+        result["more"] = (
+            f"Datasets from position {result['next_dataset_offset']} on were not read; "
+            "pass dataset_offset to continue, or list one dataset with 'view list DATASET_ID'."
+        )
     if summary.get("views_omitted"):
         result["more"] = (
             "Some views were cut to fit the output cap; list one dataset with "
@@ -540,9 +550,10 @@ def _view_list_across_project(
 
     Starts at ``dataset_offset`` (default 0) into the project's dataset
     list, pulling whole per-dataset view pages until either every dataset
-    has been visited or at least ``_VIEW_LIST_ALL_DATASETS_MIN_VIEWS`` views
-    have been collected. ``next_dataset_offset`` names where to resume when
-    the project holds more datasets than were visited. Returns the result and
+    has been visited, at least ``_VIEW_LIST_ALL_DATASETS_MIN_VIEWS`` views
+    have been collected, or ``_VIEW_LIST_ALL_DATASETS_MAX_VISITS`` datasets were
+    read. ``next_dataset_offset`` names where to resume when the project holds
+    more datasets than were visited. Returns the result and
     the project's dataset records (with the summary fields when ``compact``).
     """
     dataset_offset = int(document.get("dataset_offset", 0))
@@ -568,7 +579,10 @@ def _view_list_across_project(
             if isinstance(item, dict):
                 item = {**item, "dataset_id": dataset_id}
             dataviews.append(item)
-        if len(dataviews) >= _VIEW_LIST_ALL_DATASETS_MIN_VIEWS:
+        if (
+            len(dataviews) >= _VIEW_LIST_ALL_DATASETS_MIN_VIEWS
+            or visited - dataset_offset >= _VIEW_LIST_ALL_DATASETS_MAX_VISITS
+        ):
             break
     result: dict[str, Any] = {"dataviews": dataviews, "datasets_visited": visited - dataset_offset}
     if visited < len(datasets):
@@ -2786,11 +2800,20 @@ def view_pipeline_rerun(invocation: Invocation) -> HandlerResult:
     return data, _meta(invocation, auth.workspace_id, None)
 
 
+#: Seconds ``view pipeline wait`` waits when the caller names no ``timeout`` (the SDK's own
+#: default is an hour, one request every few seconds for as long as it runs).
+_PIPELINE_WAIT_TIMEOUT = 300.0
+
+
 def view_pipeline_wait(invocation: Invocation) -> HandlerResult:
-    """Wait for a dataview's pipeline to finish running."""
+    """Wait for a dataview's pipeline to finish running.
+
+    Waits up to ``_PIPELINE_WAIT_TIMEOUT`` seconds unless ``timeout`` says more,
+    polling less often the longer it waits.
+    """
     dataview_id = _require_int_positional_at(invocation, 0, "dataview id")
     document = invocation.load_input() or {}
-    kwargs: dict[str, Any] = {"dataview_id": dataview_id}
+    kwargs: dict[str, Any] = {"dataview_id": dataview_id, "timeout": _PIPELINE_WAIT_TIMEOUT}
     _forward_optional(document, kwargs, ("dataset_id", "timeout", "poll_interval"))
     with open_service(invocation) as (service, auth):
         data = service.call(_symbol(invocation), **kwargs)

{mammoth_cli-2.2.9 → mammoth_cli-2.2.10}/mammoth_cli/commands/view_profile.py

@@ -39,7 +39,10 @@ HandlerResult = tuple[Any, dict[str, Any]]
 _AGGREGATE = "mammoth.api.dataviews.DataviewsAPI.aggregate"
 _STORED_STATS = "mammoth.api.ai.AIAPI.generate_profile"
 _TOTALS_BATCH = 40
-_WORKERS = 6
+#: Concurrent aggregate jobs; each is one request plus its polls on the host's own server.
+_WORKERS = 2
+#: Columns profiled when the caller names none (the rest are reported as not profiled).
+_DEFAULT_PROFILE_COLUMNS = 20
 _DEFAULT_TOP = 5
 _DEFAULT_DETAIL_LIMIT = 50
 _ASSOCIATION_LIMIT = 20
@@ -94,7 +97,8 @@ def view_data_profile(invocation: Invocation) -> HandlerResult:
 
 def build_profile(scope: _Scope, document: dict[str, Any], workers: int) -> dict[str, Any]:
     """Read the stored stats, query the rest, and assemble the result."""
-    names = _selected_columns(scope, document)
+    every_name = _selected_columns(scope, document)
+    names = every_name if "columns" in document else every_name[:_DEFAULT_PROFILE_COLUMNS]
     target = document.get("target")
     if target is not None and target not in scope.types:
         raise _usage(f"target column {target!r} is not in the view", sorted(scope.types))
@@ -119,6 +123,12 @@ def build_profile(scope: _Scope, document: dict[str, Any], workers: int) -> dict
         "spelling_variants_checked": variants_checked,
         "spelling_variants_skipped": variants_skipped,
     }
+    if len(names) < len(every_name):
+        result["columns_not_profiled"] = every_name[len(names) :]
+        result["columns_not_profiled_note"] = (
+            f"Only the first {len(names)} of {len(every_name)} columns were profiled; "
+            "pass input 'columns' (names) to profile others."
+        )
     if target:
         result["target"] = _target_report(
             scope, str(target), names, facts, tables, live_rows, workers

{mammoth_cli-2.2.9 → mammoth_cli-2.2.10}/mammoth_cli/runtime/dryrun_targets.py

@@ -417,6 +417,34 @@ def _read_name(
     return {"type": kind, "id": target_id, "name": name}
 
 
+#: Resource kinds one bulk request can name, and the resource type the route calls each.
+BULK_TYPES: dict[str, str] = {"dataset": "datasource", "view": "dataview", "folder": "label"}
+_BULK_SYMBOL = "mammoth.api.browse.BrowseAPI.resources_bulk"
+
+
+def _read_names(
+    service: MammothService, kind: str, ids: list[int], arguments: Mapping[str, Any]
+) -> list[dict[str, Any]]:
+    """Name every id of ``kind``: one bulk request per 100 ids where the route knows the kind.
+
+    An id the bulk read does not return (missing, or not readable by the
+    caller) is read on its own, so the error it raises is the resource's own.
+    """
+    if kind not in BULK_TYPES or len(ids) < 2:
+        return [_read_name(service, kind, item, arguments) for item in ids]
+    scope = {"project_id": arguments["project_id"]} if arguments.get("project_id") else {}
+    rows = service.call(_BULK_SYMBOL, items=[(BULK_TYPES[kind], item) for item in ids], **scope)
+    names = {row.get("object_id"): row.get("name") for row in rows if isinstance(row, Mapping)}
+    return [
+        (
+            {"type": kind, "id": item, "name": names[item]}
+            if isinstance(names.get(item), str) and names[item]
+            else _read_name(service, kind, item, arguments)
+        )
+        for item in ids
+    ]
+
+
 def _path(record: Any, dotted: str) -> object:
     """Follow ``a.b`` through nested mappings (or attributes)."""
     for part in dotted.split("."):
@@ -468,15 +496,26 @@ def _unresolved_name(kind: str, target_id: object, symbol: str, key: str) -> Cli
     )
 
 
-def _sub_record(service: MammothService, sub: Sub, target: object, args: Mapping[str, Any]) -> Any:
-    """Read the sub-resource (or find it in its list); None when nothing is declared."""
+def _sub_record(
+    service: MammothService,
+    sub: Sub,
+    target: object,
+    args: Mapping[str, Any],
+    lists: dict[str, Any],
+) -> Any:
+    """Read the sub-resource (or find it in its list); None when nothing is declared.
+
+    A list read serves every target of the call, so it is made once (``lists``).
+    """
     if sub.source is None:
         return None
     symbol = _symbol_of(sub.source)
     kwargs = {key: args[key] for key in sub.forward if args.get(key) is not None}
     if sub.container is None:
         return service.call(symbol, **{sub.ids_arg: target}, **kwargs)
-    listed = service.call(symbol, **kwargs)
+    if symbol not in lists:
+        lists[symbol] = service.call(symbol, **kwargs)
+    listed = lists[symbol]
     items = listed if isinstance(listed, list) else (listed or {}).get(sub.container, [])
     found = next((i for i in items if str(_path(i, sub.id_field)) == str(target)), None)
     if found is None:
@@ -499,8 +538,10 @@ def _sub_targets(
             raise unresolvable_error(command_id, f"the {sub.parent} id is unknown")
         parent = f"\u201c{_parent_name(service, sub.parent, parent_ids[0], args)}\u201d"
     targets = []
+    lists: dict[str, Any] = {}
     for target in ids:
-        label = _label(_sub_record(service, sub, target, args), sub) if target != "all" else None
+        record = _sub_record(service, sub, target, args, lists) if target != "all" else None
+        label = _label(record, sub) if target != "all" else None
         shown = f"\u201c{label}\u201d" if label else str(target)
         layout = sub.name_fmt or ("{parent} \u203a {kind} {label}" if parent else "{kind} {label}")
         name = layout.format(**{**args, "parent": parent, "kind": sub.kind, "label": shown})
@@ -595,7 +636,7 @@ def resolve_targets(
     parent = {**arguments}
     if "dataset_id" not in parent and would_call.get("dataset_id") is not None:
         parent["dataset_id"] = would_call["dataset_id"]
-    return [_read_name(service, kind, item, parent) for item in ids] + invites
+    return _read_names(service, kind, ids, parent) + invites
 
 
 #: Deletes whose dry run also lists what depends on the resource: command ->