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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.2.8
+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.9
+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.8 → 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.8"
+__version__ = "2.2.10"
 
 # The versioned machine output envelope contract.
 SCHEMA_VERSION = 1

{mammoth_cli-2.2.8 → mammoth_cli-2.2.10}/mammoth_cli/app.py

@@ -457,6 +457,12 @@ class _EnvelopeGroup(TyperGroup):
                     # classify an argv flag that is not a known global option;
                     # a known option's malformed value remains usage_error.
                     known, _valued = _global_option_flags()
+                    command = getattr(getattr(error, "ctx", None), "command", None)
+                    known = known | {
+                        flag
+                        for param in getattr(command, "params", [])
+                        for flag in (*param.opts, *param.secondary_opts)
+                    }
                     option = next(
                         (
                             token.split("=", 1)[0]

{mammoth_cli-2.2.8 → 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.8 → mammoth_cli-2.2.10}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/dashboard.md

@@ -386,7 +386,7 @@ Status on release: untried; no live run recorded.
 
 Run: `mammoth dashboard format-preview`. Exact input fields: `mammoth schema get dashboard.format-preview`.
 
-Example: `mammoth dashboard format-preview 123 --input '{"style": "sample"}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+Example: `mammoth dashboard format-preview 123 --input '{"style": "presentation"}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
 
 Result: `DashboardFormatPreviewResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
 

{mammoth_cli-2.2.8 → mammoth_cli-2.2.10}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/dataset.md

@@ -26,7 +26,7 @@ Status on release: untried; no live run recorded.
 
 Run: `mammoth dataset broken-rows resolve`. Exact input fields: `mammoth schema get dataset.broken-rows.resolve`.
 
-Example: `mammoth dataset broken-rows resolve 123 --input '{"op": "add", "batch_id": 1, "rows": [{"sample_key": "Status"}]}'`. Illustrative only: append `--yes` after observing an owned target.
+Example: `mammoth dataset broken-rows resolve 123 --input '{"op": "add", "batch_id": 1, "rows": [{"line_num": 2, "line": "corrected,line,here"}]}'`. Illustrative only: append `--yes` after observing an owned target.
 
 Result: `DatasetBrokenRowsResolveResult`; mutation `destructive`, confirmation `prompt_or_yes`, wait policy `not_async`.
 

{mammoth_cli-2.2.8 → mammoth_cli-2.2.10}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/project.md

@@ -6,9 +6,9 @@ Every command returns the standard JSON envelope. On nonzero exit, read the erro
 
 Run: `mammoth project bulk-delete`. Exact input fields: `mammoth schema get project.bulk-delete`.
 
-Example: `mammoth project bulk-delete --input '{"project_ids": [1]}'`. Illustrative only: append `--yes` after observing an owned target.
+Example: `mammoth project bulk-delete --input '{"project_ids": [1]}'`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
 
-Result: `ProjectBulkDeleteResult`; mutation `destructive`, confirmation `prompt_or_yes`, wait policy `not_async`.
+Result: `ProjectBulkDeleteResult`; mutation `destructive`, confirmation `confirm_target`, wait policy `not_async`.
 
 Status on release: ran once on CLI 2.0.14 — write sweep 2026-09-18: exit 0 on release with CLI 2.0.14. Created throwaway project 22 (cli-write-sweep-throwaway-20260918), then bulk-deleted it. Without --yes: confirmation_required. With --yes: data:{}. Verified via project list: only project 3 (protected…
 

{mammoth_cli-2.2.8 → 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.8 → mammoth_cli-2.2.10}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/workflow.md

@@ -16,9 +16,9 @@ Status on release: untried; no live run recorded.
 
 Run: `mammoth workflow block auth`. Exact input fields: `mammoth schema get workflow.block.auth`.
 
-Example: `mammoth workflow block auth 123 123 --input '{"auth_data": {"sample_key": "Status"}}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+Example: `mammoth workflow block auth 123 123 --input '{"auth_data": {"sample_key": "Status"}}'`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
 
-Result: `WorkflowBlockAuthResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+Result: `WorkflowBlockAuthResult`; mutation `benign_mutation`, confirmation `confirm_target`, wait policy `not_async`.
 
 Status on release: untried; no live run recorded.
 
@@ -56,9 +56,9 @@ Status on release: untried; no live run recorded.
 
 Run: `mammoth workflow cleanup`. Exact input fields: `mammoth schema get workflow.cleanup`.
 
-Example: `mammoth workflow cleanup`. Placeholders are illustrative; resolve IDs and input from observed reads.
+Example: `mammoth workflow cleanup`. Illustrative only: append `--yes` after observing an owned target.
 
-Result: `WorkflowCleanupResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+Result: `WorkflowCleanupResult`; mutation `destructive`, confirmation `prompt_or_yes`, wait policy `not_async`.
 
 Status on release: untried; no live run recorded.
 

{mammoth_cli-2.2.8 → mammoth_cli-2.2.10}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/workspace.md

@@ -258,8 +258,8 @@ Status on release: untried; no live run recorded.
 
 Run: `mammoth workspace user update-batch`. Exact input fields: `mammoth schema get workspace.user.update-batch`.
 
-Example: `mammoth workspace user update-batch --input '{"patches": [{"sample_key": "Status"}]}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+Example: `mammoth workspace user update-batch --input '{"patches": [{"sample_key": "Status"}]}'`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
 
-Result: `WorkspaceUserUpdateBatchResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+Result: `WorkspaceUserUpdateBatchResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
 
 Status on release: untried; no live run recorded.

{mammoth_cli-2.2.8 → mammoth_cli-2.2.10}/mammoth_cli/commands/activity.py

@@ -12,6 +12,7 @@ public SDK method named by the command's reviewed manifest ``sdk_symbol``.
 from __future__ import annotations
 
 import json
+import shlex
 from datetime import UTC, datetime
 from typing import Any
 
@@ -136,7 +137,9 @@ def _refuse_bare_resource_id(document: dict[str, Any]) -> None:
             f" keys each resource by its type — {forms}."
         ),
         exit_status=EXIT_USAGE,
-        recovery_commands=[f"mammoth activity list --input '{retry}'" for retry in retries],
+        recovery_commands=[
+            f"mammoth activity list --input {shlex.quote(retry)}" for retry in retries
+        ],
     )
 
 
@@ -205,8 +208,10 @@ def _user_emails(service: Any) -> dict[Any, str]:
 
 def _change(entry: dict[str, Any], emails: dict[Any, str]) -> dict[str, Any]:
     """One log entry as a line of a change list: when, who, what, on which object."""
-    details = entry.get("details") if isinstance(entry.get("details"), dict) else {}
-    primary = entry.get("primary_object") if isinstance(entry.get("primary_object"), dict) else {}
+    raw_details = entry.get("details")
+    details: dict[str, Any] = raw_details if isinstance(raw_details, dict) else {}
+    raw_primary = entry.get("primary_object")
+    primary: dict[str, Any] = raw_primary if isinstance(raw_primary, dict) else {}
     user_id = entry.get("user_id")
     change = {
         "when": _local_time(entry.get("created_at")),

{mammoth_cli-2.2.8 → mammoth_cli-2.2.10}/mammoth_cli/commands/calc.py

@@ -18,7 +18,13 @@ from __future__ import annotations
 import ast
 import re
 from collections.abc import Callable
-from decimal import ROUND_HALF_UP, Decimal, DivisionByZero, InvalidOperation
+from decimal import (
+    ROUND_HALF_UP,
+    Decimal,
+    DivisionByZero,
+    InvalidOperation,
+    localcontext,
+)
 from typing import Any
 
 from mammoth_cli.errors.envelope import CODE_INVALID_ARGUMENT, EXIT_USAGE, CliError
@@ -30,6 +36,9 @@ HandlerResult = tuple[Any, dict[str, Any]]
 #: valid Python expression syntax on its own.
 _PERCENT_RE = re.compile(r"(\d+(?:\.\d+)?)\s*%")
 
+#: Significant digits kept in a result (Python's default is 28).
+_PRECISION = 60
+
 _BINOPS: dict[type, Callable[[Decimal, Decimal], Decimal]] = {
     ast.Add: lambda a, b: a + b,
     ast.Sub: lambda a, b: a - b,
@@ -48,18 +57,26 @@ def _unsupported(expression: str) -> CliError:
     )
 
 
-def _evaluate(node: ast.AST, expression: str) -> Decimal:
+def _literal(node: ast.Constant, source: str) -> Decimal:
+    """The number as written: going through a float would round away digits past 17."""
+    try:
+        return Decimal(ast.get_source_segment(source, node) or "")
+    except InvalidOperation:
+        return Decimal(str(node.value))
+
+
+def _evaluate(node: ast.AST, expression: str, source: str) -> Decimal:
     if isinstance(node, ast.Expression):
-        return _evaluate(node.body, expression)
+        return _evaluate(node.body, expression, source)
     if (
         isinstance(node, ast.Constant)
         and isinstance(node.value, (int, float))
         and not isinstance(node.value, bool)
     ):
-        return Decimal(str(node.value))
+        return _literal(node, source)
     if isinstance(node, ast.BinOp) and type(node.op) in _BINOPS:
-        left = _evaluate(node.left, expression)
-        right = _evaluate(node.right, expression)
+        left = _evaluate(node.left, expression, source)
+        right = _evaluate(node.right, expression, source)
         try:
             return _BINOPS[type(node.op)](left, right)
         except (InvalidOperation, DivisionByZero, ZeroDivisionError) as exc:
@@ -69,7 +86,7 @@ def _evaluate(node: ast.AST, expression: str) -> Decimal:
                 exit_status=EXIT_USAGE,
             ) from exc
     if isinstance(node, ast.UnaryOp) and isinstance(node.op, (ast.UAdd, ast.USub)):
-        value = _evaluate(node.operand, expression)
+        value = _evaluate(node.operand, expression, source)
         return value if isinstance(node.op, ast.UAdd) else -value
     if (
         isinstance(node, ast.Call)
@@ -78,7 +95,7 @@ def _evaluate(node: ast.AST, expression: str) -> Decimal:
         and not node.keywords
         and 1 <= len(node.args) <= 2
     ):
-        value = _evaluate(node.args[0], expression)
+        value = _evaluate(node.args[0], expression, source)
         ndigits = 0
         if len(node.args) == 2:
             digits_node = node.args[1]
@@ -90,7 +107,14 @@ def _evaluate(node: ast.AST, expression: str) -> Decimal:
                 raise _unsupported(expression)
             ndigits = digits_node.value
         quantum = Decimal(1).scaleb(-ndigits)
-        return value.quantize(quantum, rounding=ROUND_HALF_UP)
+        try:
+            return value.quantize(quantum, rounding=ROUND_HALF_UP)
+        except InvalidOperation as exc:
+            raise CliError(
+                code=CODE_INVALID_ARGUMENT,
+                message=f"round() digits out of range in {expression!r}.",
+                exit_status=EXIT_USAGE,
+            ) from exc
     raise _unsupported(expression)
 
 
@@ -120,5 +144,8 @@ def calc(invocation: Invocation) -> HandlerResult:
             hint="calc supports + - * / and parentheses, unary +/-, a trailing "
             "'%' (divides by 100), and round(x[, ndigits]).",
         ) from exc
-    result = _evaluate(tree, expression)
+    source = normalized
+    with localcontext() as context:
+        context.prec = _PRECISION
+        result = _evaluate(tree, expression, source)
     return {"expression": expression, "result": str(result)}, {}

{mammoth_cli-2.2.8 → mammoth_cli-2.2.10}/mammoth_cli/commands/client_app.py

@@ -27,6 +27,7 @@ from mammoth_cli.errors.envelope import (
     CliError,
 )
 from mammoth_cli.manifest.loader import command_by_id
+from mammoth_cli.output.normalize import Revealed, normalize
 from mammoth_cli.runtime.confirm import (
     POLICY_CONFIRM_TARGET,
     POLICY_PROMPT_OR_YES,
@@ -210,6 +211,8 @@ def client_app_create(invocation: Invocation) -> HandlerResult:
     _forward_optional(document, kwargs, ("description",))
     with open_service(invocation) as (service, auth):
         data = service.call(_symbol(invocation), **kwargs)
+    # The API shows the new app's token once; masking it would lose it for good.
+    data = Revealed(normalize(data, redact_secrets=False))
     return data, _meta(invocation, auth.workspace_id, resolved_project(invocation))
 
 

{mammoth_cli-2.2.8 → 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.8 → mammoth_cli-2.2.10}/mammoth_cli/commands/dataset.py

@@ -149,19 +149,38 @@ def _visible_projects(service: Any) -> list[dict[str, Any]]:
 
 
 def _find_in_projects(
-    service: Any, needle: str, projects: list[dict[str, Any]]
+    service: Any,
+    needle: str,
+    projects: list[dict[str, Any]],
+    skipped: list[dict[str, Any]] | None = None,
 ) -> list[dict[str, Any]]:
-    """Datasets whose name contains ``needle`` (case-insensitive), in each of ``projects``."""
+    """Datasets whose name contains ``needle`` (case-insensitive), in each of ``projects``.
+
+    A project that cannot be read does not end the search: with ``skipped`` it is
+    recorded there (id, name, why) and the rest are still searched.
+    """
     matches: list[dict[str, Any]] = []
     for project in projects:
         project_id = project.get("id")
         if project_id is None:
             continue
-        response = service.call(
-            "mammoth.api.datasets.DatasetsAPI.list_all",
-            project_id=project_id,
-            fields=DATASET_ROW_FIELDS,
-        )
+        try:
+            response = service.call(
+                "mammoth.api.datasets.DatasetsAPI.list_all",
+                project_id=project_id,
+                fields=DATASET_ROW_FIELDS,
+            )
+        except CliError as error:
+            if skipped is None:
+                raise
+            skipped.append(
+                {
+                    "project_id": project_id,
+                    "project_name": project.get("name"),
+                    "error": error.message,
+                }
+            )
+            continue
         datasets = response.get("datasets", []) if isinstance(response, dict) else []
         for dataset in datasets:
             name = dataset.get("name") if isinstance(dataset, dict) else None
@@ -177,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]
@@ -210,18 +286,23 @@ def dataset_find(invocation: Invocation) -> HandlerResult:
     """
     name_substring = _require_string_positional(invocation, "name substring")
     needle = name_substring.lower()
+    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)
+            matches = _find_in_projects(service, needle, projects, skipped)
             if not matches:
-                others = _other_projects(visible, invocation.project)
-                matches = _find_in_projects(service, needle, others)
-                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)
+            holding, cut = _projects_holding(service, needle, visible)
+            matches = _find_in_projects(service, needle, holding, skipped)
         meta = {
             "profile": invocation.profile,
             "workspace_id": auth.workspace_id,
@@ -229,9 +310,15 @@ def dataset_find(invocation: Invocation) -> HandlerResult:
         }
     result: dict[str, Any] = {
         "matches": matches,
-        "projects_searched": len(projects),
+        "projects_searched": len(projects) - len(skipped),
     }
-    if note := ambiguity_note(len(matches), name_substring):
+    if skipped:
+        result["projects_skipped"] = skipped
+    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
 
@@ -282,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
@@ -291,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.8 → mammoth_cli-2.2.10}/mammoth_cli/commands/doctor.py

@@ -133,9 +133,8 @@ _PROJECT_LIMIT = 20
 
 def _visible_projects(service: Any) -> list[dict[str, Any]]:
     """Return the projects this credential can list, or an empty list."""
-    response = service.list_projects(limit=_PROJECT_LIMIT + 1)
-    projects = response.get("projects", []) if isinstance(response, dict) else []
-    return [p for p in projects if isinstance(p, dict)]
+    # Every page: "is the selected project visible" must not stop at the first few.
+    return [p for p in service.list_all_projects() if isinstance(p, dict)]
 
 
 def _nearest_existing(path: Path) -> Path:

{mammoth_cli-2.2.8 → 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.