mammoth-cli 2.0.49__tar.gz → 2.0.51__tar.gz

{mammoth_cli-2.0.49 → mammoth_cli-2.0.51}/PKG-INFO

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

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

{mammoth_cli-2.0.49 → mammoth_cli-2.0.51}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.0.49
+version: 2.0.51
 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."
 ---
 

{mammoth_cli-2.0.49 → mammoth_cli-2.0.51}/mammoth_cli/commands/schema.py

@@ -92,6 +92,13 @@ _COMMAND_DISCOVERY_PURPOSES = {
     "view.export.sftp": "sftp secure file transfer server",
     "view.export.sharepoint": "share point sharepoint microsoft",
     "view.export.tableau": "tableau server dashboard",
+    # "Run"/"execute"/"apply"/"refresh" the pipeline is ambiguous between
+    # re-running its tasks and applying a pending draft; both need to surface.
+    "view.pipeline.rerun": (
+        "run execute rerun re-run refresh recompute apply pipeline tasks "
+        "from a point in the task sequence"
+    ),
+    "view.draft.submit": "apply submit run execute a pending draft changes",
     "webhook.create": "webhook http endpoint api push create",
     "webhook.update": "webhook http endpoint api update",
     "webhook.get": "webhook http endpoint api get",
@@ -142,7 +149,8 @@ _COMMAND_DISCOVERY_PURPOSES = {
         "fill missing null empty blank blanks impute carry forward fill down values"
     ),
     "view.transform.filter": (
-        "filter rows keep drop exclude remove delete rows where condition subset"
+        "filter rows keep drop exclude remove delete rows where condition subset "
+        "bind bound binding parameter"
     ),
     "view.transform.generate-sql": "generate write sql query from natural language intent question",
     "view.transform.increment-date": "add subtract days months years to a date column shift",

{mammoth_cli-2.0.49 → mammoth_cli-2.0.51}/mammoth_cli/commands/view.py

@@ -286,15 +286,39 @@ def brief_view_record(record: Any) -> Any:
     return {key: record[key] for key in BRIEF_VIEW_FIELDS if key in record}
 
 
+#: dataset.list_all's SDK symbol, reused from the pagination-safe helper item
+#: A's discovery fix relies on (mammoth/api/datasets.py) rather than a
+#: single unpaginated page, so a project with many datasets is not silently
+#: truncated here either.
+_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
+
+
 def view_list(invocation: Invocation) -> HandlerResult:
-    """List dataviews for a dataset in the active project."""
+    """List dataviews for a dataset, or every dataset in the active project.
+
+    Omitting DATASET_ID used to fail outright with ``missing_argument`` --
+    an agent's very first move is often ``view list`` before it knows any
+    dataset id. It now walks every dataset in the active project instead
+    (paged; see :data:`_VIEW_LIST_ALL_DATASETS_MIN_VIEWS`), same as passing
+    an explicit id still does for a single dataset.
+    """
     project_id = require_project(invocation)
-    dataset_id = _require_int_positional_at(invocation, 0, "dataset id")
+    dataset_id = _int_positional_at(invocation, 0, "dataset id")
     document = invocation.load_input() or {}
-    kwargs: dict[str, Any] = {"dataset_id": dataset_id, "project_id": project_id}
-    _forward_optional(document, kwargs, ("limit", "sort"))
+    if dataset_id is None and document.get(_DATASET_ID_FIELD) is not None:
+        dataset_id = int(document[_DATASET_ID_FIELD])
     with open_service(invocation) as (service, auth):
-        data = service.call(_symbol(invocation), **kwargs)
+        if dataset_id is None:
+            data = _view_list_across_project(service, _symbol(invocation), document, project_id)
+        else:
+            kwargs: dict[str, Any] = {"dataset_id": dataset_id, "project_id": project_id}
+            _forward_optional(document, kwargs, ("limit", "sort"))
+            data = service.call(_symbol(invocation), **kwargs)
         parents.remember_records(
             _profile_name(invocation), auth.workspace_id, data, project_id=project_id
         )
@@ -309,6 +333,45 @@ def view_list(invocation: Invocation) -> HandlerResult:
     return data, _meta(invocation, auth.workspace_id, project_id)
 
 
+def _view_list_across_project(
+    service: Any, view_list_symbol: str, document: dict[str, Any], project_id: int
+) -> dict[str, Any]:
+    """Aggregate dataviews from every dataset in the project (paged).
+
+    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.
+    """
+    dataset_offset = int(document.get("dataset_offset", 0))
+    datasets_page = service.call(_DATASETS_LIST_ALL_SYMBOL, project_id=project_id)
+    datasets = datasets_page.get("datasets", []) if isinstance(datasets_page, dict) else []
+    view_kwargs: dict[str, Any] = {}
+    _forward_optional(document, view_kwargs, ("sort",))
+    dataviews: list[Any] = []
+    visited = dataset_offset
+    for index in range(dataset_offset, len(datasets)):
+        dataset = datasets[index]
+        visited = index + 1
+        dataset_id = dataset.get("id") if isinstance(dataset, dict) else None
+        if not isinstance(dataset_id, int):
+            continue
+        page = service.call(
+            view_list_symbol, dataset_id=dataset_id, project_id=project_id, **view_kwargs
+        )
+        for item in page.get("dataviews", []) if isinstance(page, dict) else []:
+            if isinstance(item, dict):
+                item = {**item, "dataset_id": dataset_id}
+            dataviews.append(item)
+        if len(dataviews) >= _VIEW_LIST_ALL_DATASETS_MIN_VIEWS:
+            break
+    result: dict[str, Any] = {"dataviews": dataviews, "datasets_visited": visited - dataset_offset}
+    if visited < len(datasets):
+        result["next_dataset_offset"] = visited
+    return result
+
+
 def view_bulk_delete(invocation: Invocation) -> HandlerResult:
     """Permanently delete several dataviews by id. Prompt or ``--yes`` required."""
     project_id = require_project(invocation)
@@ -778,15 +841,17 @@ def _relabel_and_check(
     if mapping is None or types is None:
         mapping, types = _column_profile(service, dataset_id, view_id, project_id)
     data = _relabel_columns(service, dataset_id, view_id, project_id, data, mapping)
-    return _with_column_warnings(data, types, view_id)
+    return _with_column_warnings(data, types, view_id, dataset_id)
 
 
-def _with_column_warnings(data: Any, types: dict[str, str], view_id: int) -> Any:
+def _with_column_warnings(
+    data: Any, types: dict[str, str], view_id: int, dataset_id: int | None = None
+) -> Any:
     """Add ``column_warnings`` for the rows of a data page (never fatal)."""
     if not isinstance(data, dict) or not isinstance(data.get(_ROWS_KEY), list) or not types:
         return data
     try:
-        warnings = column_warnings(data[_ROWS_KEY], types, view_id)
+        warnings = column_warnings(data[_ROWS_KEY], types, view_id, dataset_id)
     except Exception:  # noqa: BLE001 -- a presentation aid must not fail the read
         return data
     return {**data, "column_warnings": warnings} if warnings else data
@@ -1635,6 +1700,31 @@ def view_pipeline_edit(invocation: Invocation) -> HandlerResult:
     return data, _meta(invocation, auth.workspace_id, None)
 
 
+#: OpenAPI ``PipelineInfo`` (the exact ``get_pipeline`` payload) pins
+#: ``draft_mode`` as a top-level string enum and ``auto_run`` as a top-level
+#: bool. "dirty" means unsubmitted draft changes are pending; ``auto_run``
+#: false means new tasks stop short of computing. Both leave a dataview
+#: looking finished when it is not (WPP/T3 evidence: agents that never ran
+#: 'view pipeline get' had no way to notice either).
+_DRAFT_MODE_DIRTY = "dirty"
+
+
+def _pipeline_action_hint(view_id: int, data: dict[str, Any]) -> str | None:
+    """Best-effort hint naming the exact command a stale pipeline needs."""
+    if data.get("draft_mode") == _DRAFT_MODE_DIRTY:
+        return (
+            f"This view has an unsubmitted draft with pending changes; run "
+            f"'mammoth view draft submit {view_id}' to apply them."
+        )
+    if data.get("auto_run") is False:
+        return (
+            f"Auto-run is off for this pipeline; new tasks will not compute "
+            f"automatically. Run 'mammoth view pipeline rerun {view_id}' to "
+            f"compute pending tasks now."
+        )
+    return None
+
+
 def view_pipeline_get(invocation: Invocation) -> HandlerResult:
     """Get a dataview's full pipeline."""
     dataview_id = _require_int_positional_at(invocation, 0, "dataview id")
@@ -1643,6 +1733,9 @@ def view_pipeline_get(invocation: Invocation) -> HandlerResult:
     _forward_optional(document, kwargs, ("dataset_id",))
     with open_service(invocation) as (service, auth):
         data = service.call(_symbol(invocation), **kwargs)
+    hint = _pipeline_action_hint(dataview_id, data) if isinstance(data, dict) else None
+    if hint is not None:
+        data = {**data, "hint": hint}
     return data, _meta(invocation, auth.workspace_id, None)
 
 
@@ -2149,7 +2242,18 @@ def view_export_specialized(invocation: Invocation) -> HandlerResult:
         for name, parameter in signature.parameters.items()
         if name != "self" and parameter.kind is not inspect.Parameter.VAR_KEYWORD
     }
-    allowed = explicit_fields | set(_SPECIAL_EXPORT_COMMON_FIELDS) | {_DATASET_ID_FIELD}
+    # The six common trigger controls only actually reach the SDK call when
+    # the route's method has a **kwargs sink to carry them; ``to_dataset`` has
+    # a closed signature (no **kwargs) and does not accept any of them.
+    # Allowing them anyway let a field like ``end_of_pipeline`` pass this
+    # check and then crash the call itself with an opaque "unexpected keyword
+    # argument" TypeError instead of a clear unknown_input_field.
+    accepts_var_keyword = any(
+        parameter.kind is inspect.Parameter.VAR_KEYWORD
+        for parameter in signature.parameters.values()
+    )
+    common_fields = _SPECIAL_EXPORT_COMMON_FIELDS if accepts_var_keyword else frozenset()
+    allowed = explicit_fields | common_fields | {_DATASET_ID_FIELD}
     unknown = sorted(set(document) - allowed)
     if unknown:
         raise CliError(
@@ -2290,7 +2394,7 @@ def upload_preview(service: Any, dataset_id: int, project_id: int | None) -> dic
         "sample_rows": rows[:_UPLOAD_SAMPLE_ROWS],
     }
     try:
-        warnings = column_warnings(rows, types, view_id) if rows else []
+        warnings = column_warnings(rows, types, view_id, dataset_id) if rows else []
     except Exception:  # noqa: BLE001
         warnings = []
     if warnings:

{mammoth_cli-2.0.49 → mammoth_cli-2.0.51}/mammoth_cli/services/command_contract.py

@@ -592,8 +592,13 @@ _S7_ADDITIONAL_INPUT_FIELDS: dict[str, tuple[FieldSpec, ...]] = {
     # The dataview GET takes a server-side projection: "__min", "__standard",
     # "__full" or a comma-separated field list.
     "view.get": (FieldSpec("fields", required=False, annotation=str | None, default=None),),
-    # ``view list`` records are trimmed to the brief shape; ``full`` keeps them.
-    "view.list": (FieldSpec("full", required=False, annotation=bool, default=False),),
+    # ``view list`` records are trimmed to the brief shape; ``full`` keeps
+    # them. ``dataset_offset`` resumes the no-DATASET_ID, every-dataset-in-
+    # the-project walk (item G) at a later dataset index.
+    "view.list": (
+        FieldSpec("full", required=False, annotation=bool, default=False),
+        FieldSpec("dataset_offset", required=False, annotation=int, default=0),
+    ),
     "activity.list": (
         FieldSpec("project_id", required=False, annotation=int | None, default=None),
         FieldSpec("workspace_id", required=False, annotation=int | None, default=None),

{mammoth_cli-2.0.49 → mammoth_cli-2.0.51}/mammoth_cli/services/data_quality.py

@@ -61,10 +61,43 @@ def _convert_hint(view_id: int | None, column: str, to: str) -> str:
     return f"mammoth view transform convert-type {target} --input '{spec}'"
 
 
+def _duplicate_rows_warning(
+    rows: list[Mapping[str, Any]],
+    view_id: int | None,
+    dataset_id: int | None,
+) -> dict[str, Any] | None:
+    """Return a table-level warning when the page itself holds exact duplicates.
+
+    Scoped honestly to the rows actually read: an agent must not read this as
+    table-wide duplication without separately checking the full table (e.g.
+    ``view data aggregate`` COUNT vs a distinct count).
+    """
+    fingerprints = [json.dumps(row, sort_keys=True, default=str) for row in rows]
+    counts: dict[str, int] = {}
+    for fingerprint in fingerprints:
+        counts[fingerprint] = counts.get(fingerprint, 0) + 1
+    duplicate_count = sum(count - 1 for count in counts.values() if count > 1)
+    if not duplicate_count:
+        return None
+    warning: dict[str, Any] = {
+        "issue": "duplicate_rows",
+        "detail": (
+            f"{duplicate_count} of the {len(rows)} rows read are exact duplicates "
+            "of another row in this page (not checked table-wide)."
+        ),
+        "rows_checked": len(rows),
+    }
+    if view_id is not None and dataset_id is not None:
+        spec = json.dumps({"dataset_id": dataset_id})
+        warning["fix"] = f"mammoth view transform discard-duplicates {view_id} --input '{spec}'"
+    return warning
+
+
 def column_warnings(
     rows: Iterable[Mapping[str, Any]],
     column_types: Mapping[str, str],
     view_id: int | None = None,
+    dataset_id: int | None = None,
 ) -> list[dict[str, Any]]:
     """Return warnings for text columns that hold numbers or dates, and for blanks.
 
@@ -72,18 +105,24 @@ def column_warnings(
         rows: Row objects keyed by display name (a data page after relabeling).
         column_types: Display name to Mammoth type (``TEXT``, ``NUMERIC``, ...).
         view_id: The view the rows came from, used in the suggested command.
+        dataset_id: The view's dataset, used for the duplicate-rows fix
+            command (a mutation, so it needs the exact parent, not discovery).
 
     Returns:
         One record per finding: ``column``, ``issue``
-        (``numbers_stored_as_text``, ``dates_stored_as_text`` or
-        ``blank_values``), ``detail`` and, where one command fixes it, ``fix``.
-        Counts are over the rows given (``rows_checked`` on each record).
+        (``numbers_stored_as_text``, ``dates_stored_as_text``,
+        ``blank_values`` or the table-level ``duplicate_rows``), ``detail``
+        and, where one command fixes it, ``fix``. Counts are over the rows
+        given (``rows_checked`` on each record).
     """
     materialised = [row for row in rows if isinstance(row, Mapping)]
     if not materialised:
         return []
     checked = len(materialised)
     warnings: list[dict[str, Any]] = []
+    duplicate_warning = _duplicate_rows_warning(materialised, view_id, dataset_id)
+    if duplicate_warning is not None:
+        warnings.append(duplicate_warning)
     for column, col_type in column_types.items():
         values = [row.get(column) for row in materialised if column in row]
         if not values:

{mammoth_cli-2.0.49 → mammoth_cli-2.0.51}/mammoth_cli/services/mapping.py

@@ -109,6 +109,38 @@ def _job_recovery(job_id: object, *, profile: str | None = None) -> list[str]:
 
 _PROJECT_DELETE = re.compile(r"/workspaces/\d+/projects/(\d+)/?$")
 _DASHBOARD_WRITE = re.compile(r"/dashboards/(\d+)(?:/|$)")
+_ENDPOINT_WORKSPACE = re.compile(r"/workspaces/(\d+)")
+
+
+def _workspace_mismatch_error(exc: MammothAuthError, workspace_id: int | None) -> CliError | None:
+    """A 401 whose endpoint targets a workspace other than the profile's own
+    is a scoping mistake, not invalid credentials, so it must not tell the
+    user to reauthenticate (release evidence T4-L-002 — the in-product agent
+    parroted "reauthenticate" to a web user for exactly this case).
+    """
+    if workspace_id is None:
+        return None
+    endpoint = getattr(exc, "endpoint", None)
+    if not isinstance(endpoint, str):
+        return None
+    match = _ENDPOINT_WORKSPACE.search(endpoint)
+    if match is None:
+        return None
+    target_workspace_id = int(match.group(1))
+    if target_workspace_id == workspace_id:
+        return None
+    return CliError(
+        code=CODE_AUTHORIZATION_REQUIRED,
+        message=(
+            f"No access to workspace {target_workspace_id} "
+            f"(this sign-in is for workspace {workspace_id})."
+        ),
+        exit_status=EXIT_AUTH,
+        hint="Pass --workspace or use a profile signed in for that workspace.",
+        details=_metadata(exc),
+        request_id=exc.request_id,
+        authorization_required=True,
+    )
 
 
 def _resource_recovery(
@@ -161,6 +193,9 @@ def map_sdk_exception(
         )
 
     if isinstance(exc, MammothAuthError):
+        mismatch = _workspace_mismatch_error(exc, workspace_id)
+        if mismatch is not None:
+            return mismatch
         return CliError(
             code=CODE_AUTHENTICATION_FAILED,
             message="Mammoth rejected the provided credentials.",

{mammoth_cli-2.0.49 → mammoth_cli-2.0.51}/mammoth_cli/services/positionals.py

@@ -168,6 +168,23 @@ POSITIONAL_OVERRIDES: dict[str, tuple[PositionalSpec, ...]] = {
     "dashboard.tags.merge": (
         PositionalSpec(name="tag_id", type=int, required=True, help="ID of the source tag."),
     ),
+    # Item G: an agent's first move is often `view list` before it has any
+    # dataset id; omitting it now walks every dataset in the active project
+    # (paged) instead of failing with missing_argument.
+    "view.list": (
+        PositionalSpec(
+            name="dataset_id",
+            type=int,
+            required=False,
+            falls_back_to_field="dataset_id",
+            help=(
+                "ID of the dataset. Omit it to list dataviews across every "
+                "dataset in the active project instead (paged; see the "
+                "'dataset_offset' input field and the 'next_dataset_offset' "
+                "result field)."
+            ),
+        ),
+    ),
     # Explicit parent avoids rich-view discovery for the release-scoped GET.
     "view.get": (
         PositionalSpec(name="view_id", type=int, required=True, help="ID of the view."),
@@ -913,6 +930,22 @@ EXACT_PARENT_HELP = (
     "'dataset_id' input field; only read commands may omit it and discover the parent."
 )
 
+# Per-command overrides of ``EXACT_PARENT_HELP`` for a command whose own
+# fields could otherwise be mistaken for this positional. ``view.export.dataset``
+# also takes a ``target_ds_id`` input field naming the destination dataset;
+# an agent that read only the generic text passed a destination id here
+# instead and hit a not-found on the (unrelated) source view's own parent
+# (WPP evidence c38/c39).
+_EXACT_PARENT_HELP_OVERRIDES: dict[str, str] = {
+    "view.export.dataset": (
+        "Exact parent dataset ID of the SOURCE view being exported -- not the "
+        "destination. Required for this command: pass it here or as the "
+        "'dataset_id' input field. To write into an existing destination dataset "
+        "instead of creating one, use the 'target_ds_id' input field, not this "
+        "positional."
+    ),
+}
+
 
 def _with_exact_parent_help(
     command_id: str, specs: tuple[PositionalSpec, ...]
@@ -926,13 +959,14 @@ def _with_exact_parent_help(
     record = command_by_id(command_id)
     if record is None or record.get("mutation_class", "read") == "read":
         return specs
+    help_text = _EXACT_PARENT_HELP_OVERRIDES.get(command_id, EXACT_PARENT_HELP)
     return tuple(
         (
             PositionalSpec(
                 name=spec.name,
                 type=spec.type,
                 required=spec.required,
-                help=EXACT_PARENT_HELP,
+                help=help_text,
                 falls_back_to_field=spec.falls_back_to_field,
                 fills_sdk_param=spec.fills_sdk_param,
                 example_value=spec.example_value,

{mammoth_cli-2.0.49 → mammoth_cli-2.0.51}/mammoth_cli/services/type_system.py

@@ -91,13 +91,36 @@ def is_opaque_mapping(annotation: Any) -> bool:
     return not args or (len(args) == 2 and args[1] is Any)
 
 
+#: A leaf condition's ``value`` may be a literal, or a marker that binds it to
+#: a project/workspace parameter's live value instead. The server deep-walks
+#: task params for this exact shape and substitutes the parameter's current
+#: value at execution time (``api/api/parameters/binding_extractor.py`` /
+#: ``consts.py`` in mvc-service); the SDK's ``Condition.value`` already
+#: forwards it untouched, so no SDK change is needed — only this schema was
+#: silent about the shape existing.
+_PARAMETER_BINDING_SCHEMA = {
+    "type": "object",
+    "description": (
+        "Bind to a project/workspace parameter's live value instead of a literal. "
+        "Create one first with 'parameter create' if it does not exist yet."
+    ),
+    "properties": {
+        "type": {"const": "parameter"},
+        "parameter_id": {"type": "integer"},
+    },
+    "required": ["type", "parameter_id"],
+    "additionalProperties": False,
+    "example": {"type": "parameter", "parameter_id": 12},
+}
+
+
 def _condition_schema() -> dict[str, Any]:
     leaf = {
         "type": "object",
         "properties": {
             "column": {"type": "string", "example": "Status"},
             "operator": {"type": "string", "example": "EQ"},
-            "value": {"example": "Active"},
+            "value": {"anyOf": [{"example": "Active"}, _PARAMETER_BINDING_SCHEMA]},
             "case_sensitive": {"type": "boolean"},
             "value_is_column": {"type": "boolean"},
             "component": {"type": "string"},

{mammoth_cli-2.0.49 → mammoth_cli-2.0.51}/pyproject.toml

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

{mammoth_cli-2.0.49 → mammoth_cli-2.0.51}/spec/manifests/commands/view.yaml

@@ -1881,8 +1881,10 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: 'Exact parent dataset ID. Required for this command: pass it here or as the ''dataset_id'' input
-      field; only read commands may omit it and discover the parent.'
+    help: 'Exact parent dataset ID of the SOURCE view being exported -- not the destination.
+      Required for this command: pass it here or as the ''dataset_id'' input field. To write into
+      an existing destination dataset instead of creating one, use the ''target_ds_id'' input field,
+      not this positional.'
   options: []
   sdk_symbol: mammoth.view.ViewExport.to_dataset
   sdk_conversion: Call mammoth.view.ViewExport.to_dataset with validated request fields.
@@ -2994,10 +2996,12 @@ commands:
   positionals:
   - name: dataset_id
     type: int
-    required: true
+    required: false
     metavar: DATASET_ID
-    falls_back_to_field: null
-    help: ID of the dataset.
+    falls_back_to_field: dataset_id
+    help: 'ID of the dataset. Omit it to list dataviews across every dataset in
+      the active project instead (paged; see the ''dataset_offset'' input field
+      and the ''next_dataset_offset'' result field).'
   options: []
   sdk_symbol: mammoth.api.dataviews.DataviewsAPI.list
   sdk_conversion: Call mammoth.api.dataviews.DataviewsAPI.list with validated request fields.
@@ -3013,7 +3017,7 @@ commands:
   contract_fixture: null
   required_fixture_guard: null
   secret_fields: []
-  human_example: mammoth view list DATASET_ID --help
+  human_example: mammoth view list --help
   agent_example: mammoth view list 123
   unit_tests:
   - UT-VIEW-LIST