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

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

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

{mammoth_cli-2.2.8 → mammoth_cli-2.2.9}/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.9}/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.9}/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.9}/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.9}/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.9}/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.9}/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.9}/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.9}/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.9}/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
@@ -210,18 +229,19 @@ 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)
         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)
+                matches = _find_in_projects(service, needle, others, skipped)
                 projects += others
         else:
             projects = visible
-            matches = _find_in_projects(service, needle, projects)
+            matches = _find_in_projects(service, needle, projects, skipped)
         meta = {
             "profile": invocation.profile,
             "workspace_id": auth.workspace_id,
@@ -229,8 +249,10 @@ def dataset_find(invocation: Invocation) -> HandlerResult:
         }
     result: dict[str, Any] = {
         "matches": matches,
-        "projects_searched": len(projects),
+        "projects_searched": len(projects) - len(skipped),
     }
+    if skipped:
+        result["projects_skipped"] = skipped
     if note := ambiguity_note(len(matches), name_substring):
         result["note"] = note
     return result, meta

{mammoth_cli-2.2.8 → mammoth_cli-2.2.9}/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.9}/mammoth_cli/commands/folder.py

@@ -126,12 +126,7 @@ def folder_find(invocation: Invocation) -> HandlerResult:
             if project_id is None:
                 continue
             project_name = project.get("name")
-            # FoldersAPI.list caps at 100 per page and has no list_all; request
-            # the maximum so a project's folders are not silently truncated.
-            response = service.call(
-                "mammoth.api.folders.FoldersAPI.list", project_id=project_id, limit=100
-            )
-            for folder in _folders_of(response):
+            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(

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

@@ -31,7 +31,6 @@ from mammoth_cli.manifest.loader import command_by_id
 from mammoth_cli.runtime import embedded
 from mammoth_cli.runtime.confirm import (
     POLICY_CONFIRM_TARGET,
-    POLICY_PROMPT_OR_YES,
     POLICY_YES_ALWAYS,
     enforce_confirmation,
 )
@@ -401,8 +400,9 @@ def project_bulk_delete(invocation: Invocation) -> HandlerResult:
     project_ids = _require_input_field(document, "project_ids")
     enforce_confirmation(
         invocation,
-        policy=POLICY_PROMPT_OR_YES,
+        policy=POLICY_CONFIRM_TARGET,
         action=f"delete {len(project_ids)} projects",
+        target=",".join(str(project_id) for project_id in sorted(set(project_ids))),
     )
     with open_service(invocation) as (service, auth):
         data = service.call(_symbol(invocation), project_ids=project_ids)
@@ -632,11 +632,10 @@ def _map_checks[T](
     if len(items) <= 1:
         return [work(service, auth, item) for item in items]
     with ThreadPoolExecutor(max_workers=min(_CHECK_WORKERS, len(items))) as pool:
-        return list(
-            pool.map(
-                lambda item: _in_worker(invocation, lambda svc, ath: work(svc, ath, item)),
-                items,
-            )
+        return embedded.pool_map(
+            pool,
+            lambda item: _in_worker(invocation, lambda svc, ath: work(svc, ath, item)),
+            items,
         )
 
 

{mammoth_cli-2.2.8 → mammoth_cli-2.2.9}/mammoth_cli/commands/schema.py

@@ -1645,8 +1645,9 @@ def schema_index(family: str | None = None) -> dict[str, Any]:
     ``schema get`` for the command it picked.
     """
     entries = schema_entries()
-    if family:
-        wanted = family.strip().split(".")[0].split()[0]
+    words = (family or "").strip().split(".")[0].split()
+    if words:
+        wanted = words[0]
         commands = [
             {
                 "command_id": entry["command_id"],