mammoth-cli 2.0.7__tar.gz → 2.0.8__tar.gz

{mammoth_cli-2.0.7 → mammoth_cli-2.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.0.7
+Version: 2.0.8
 Summary: Command-line interface for the Mammoth Analytics platform
 Project-URL: homepage, https://mammoth.io
 Project-URL: repository, https://github.com/EdgeMetric/mammothsdk

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

{mammoth_cli-2.0.7 → mammoth_cli-2.0.8}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -39,7 +39,10 @@ the result.
 ## Working rules
 
 - Resolve workspace/project/dataset/view parents from reads; pass observed IDs
-  and `--project`. A dataset does not select a default view.
+  and `--project`. A dataset does not select a default view. Every `view`
+  command that changes, exports, or deletes data requires the exact parent
+  `DATASET_ID` (trailing positional or `dataset_id` input field); only reads
+  may omit it and discover the parent. Get it from `mammoth view get VIEW_ID`.
 - Use exact view-schema **display names** in expressions and column inputs,
   never backend aliases.
 - Inspect the result after a mutation. A timeout, exit 7, or interruption does

{mammoth_cli-2.0.7 → mammoth_cli-2.0.8}/mammoth_cli/commands/view.py

@@ -164,9 +164,41 @@ def _resolve_dataset_id(
     field = document.get(_DATASET_ID_FIELD)
     if field is not None:
         return int(field)
+    _require_discovery_allowed(invocation, view_id)
     return int(service.call(_FIND_DATASET_SYMBOL, dataview_id=view_id))
 
 
+def _require_discovery_allowed(invocation: Invocation, view_id: int) -> None:
+    """Refuse project-wide parent discovery before anything but a read.
+
+    Omitting the parent sends the resolver on a browse-and-probe walk over
+    every dataset in the project. For a read that is a convenience; before a
+    mutation, an export, or a delete it means the target is chosen by a
+    probe whose first denied dataset can end the search on the wrong parent.
+    Those commands therefore require the exact parent, and fail closed here
+    with the read that supplies it.
+    """
+    record = command_by_id(invocation.command_id) or {}
+    if record.get("mutation_class", "read") == "read":
+        return
+    project = f" --project {invocation.project}" if invocation.project else ""
+    lookup = f"mammoth view get {view_id}{project} --output json --no-input"
+    raise CliError(
+        code=CODE_MISSING_ARGUMENT,
+        message=(
+            "This command changes or exports data, so it requires the exact parent "
+            "DATASET_ID; project-wide parent discovery is only performed for reads."
+        ),
+        exit_status=EXIT_USAGE,
+        hint=(
+            "Read the parent first, then pass it as the trailing DATASET_ID positional "
+            "or the 'dataset_id' input field: " + lookup
+        ),
+        details={"view_id": view_id, "mutation_class": record.get("mutation_class")},
+        recovery_commands=[lookup],
+    )
+
+
 def _meta(invocation: Invocation, workspace_id: int, project_id: int | None) -> dict[str, Any]:
     """Build the common envelope metadata for a view command."""
     return {

{mammoth_cli-2.0.7 → mammoth_cli-2.0.8}/mammoth_cli/commands/view_ops.py

@@ -301,18 +301,16 @@ def view_get(invocation: Invocation) -> HandlerResult:
 def view_delete(invocation: Invocation) -> HandlerResult:
     """Permanently delete one view by id. Prompt or ``--yes`` required.
 
-    ``dataset_id`` may be supplied as the trailing positional, in structured
-    input, or by a typed resource reference.  When present it is forwarded to
-    the SDK so deletion uses exactly that parent endpoint and never performs a
-    workspace-wide parent probe.
+    ``dataset_id`` is required: the trailing positional, the structured input
+    field, or a typed resource reference must name the exact parent. It is
+    forwarded to the SDK so deletion uses exactly that parent endpoint and
+    never performs a project-wide parent probe before a destructive call.
     """
     view_id = _view_id(invocation)
     enforce_confirmation(invocation, policy=POLICY_PROMPT_OR_YES, action=f"delete view {view_id}")
     document = invocation.load_input() or {}
-    dataset_id = _resolve_exact_dataset_id(invocation, view_id, document)
-    context: dict[str, Any] = {"view_id": view_id}
-    if dataset_id is not None:
-        context["dataset_id"] = dataset_id
+    dataset_id = _resolve_exact_dataset_id(invocation, view_id, document, required=True)
+    context: dict[str, Any] = {"view_id": view_id, "dataset_id": dataset_id}
     kwargs = bind_command_inputs(invocation.command_id, document, **context)
     with open_service(invocation) as (service, auth):
         data = service.call(_symbol(invocation), **kwargs)

{mammoth_cli-2.0.7 → mammoth_cli-2.0.8}/mammoth_cli/services/positionals.py

@@ -852,10 +852,46 @@ def positionals_for(command_id: str, sdk_symbol: str | None) -> tuple[Positional
         signature derivation, else an empty tuple).
     """
     if command_id in POSITIONAL_OVERRIDES:
-        return POSITIONAL_OVERRIDES[command_id]
+        return _with_exact_parent_help(command_id, POSITIONAL_OVERRIDES[command_id])
     if not sdk_symbol:
         return ()
-    return derive_positionals(command_id, sdk_symbol)
+    return _with_exact_parent_help(command_id, derive_positionals(command_id, sdk_symbol))
+
+
+EXACT_PARENT_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."
+)
+
+
+def _with_exact_parent_help(
+    command_id: str, specs: tuple[PositionalSpec, ...]
+) -> tuple[PositionalSpec, ...]:
+    """Tell the truth about an optional ``dataset_id`` on a non-read command.
+
+    The parse shape stays optional (the field may also arrive via ``--input``),
+    but the handler refuses project-wide parent discovery before a mutation,
+    export, or delete, so the help must say the parent is required there.
+    """
+    record = command_by_id(command_id)
+    if record is None or record.get("mutation_class", "read") == "read":
+        return specs
+    return tuple(
+        (
+            PositionalSpec(
+                name=spec.name,
+                type=spec.type,
+                required=spec.required,
+                help=EXACT_PARENT_HELP,
+                falls_back_to_field=spec.falls_back_to_field,
+                fills_sdk_param=spec.fills_sdk_param,
+                example_value=spec.example_value,
+            )
+            if spec.name == "dataset_id" and not spec.required and spec.falls_back_to_field
+            else spec
+        )
+        for spec in specs
+    )
 
 
 def _symbol_for(command_id: str) -> str | None:

{mammoth_cli-2.0.7 → mammoth_cli-2.0.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mammoth-cli"
-version = "2.0.7"
+version = "2.0.8"
 description = "Command-line interface for the Mammoth Analytics platform"
 authors = [{name = "Mammoth Analytics", email = "support@mammoth.io"}]
 readme = "README.md"

{mammoth_cli-2.0.7 → mammoth_cli-2.0.8}/spec/manifests/commands/view.yaml

@@ -64,7 +64,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.dataviews.DataviewsAPI.mark_active
   sdk_conversion: Call mammoth.api.dataviews.DataviewsAPI.mark_active with validated request fields.
@@ -272,7 +273,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.checkpoints.CheckpointsAPI.create
   sdk_conversion: Call mammoth.api.checkpoints.CheckpointsAPI.create with validated request fields.
@@ -325,7 +327,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.checkpoints.CheckpointsAPI.delete
   sdk_conversion: Call mammoth.api.checkpoints.CheckpointsAPI.delete with validated request fields.
@@ -475,7 +478,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.checkpoints.CheckpointsAPI.update
   sdk_conversion: Call mammoth.api.checkpoints.CheckpointsAPI.update with validated request fields.
@@ -522,7 +526,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.dataviews.DataviewsAPI.conditional_format_create
   sdk_conversion: Call mammoth.api.dataviews.DataviewsAPI.conditional_format_create with validated request
@@ -571,7 +576,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.dataviews.DataviewsAPI.conditional_format_delete
   sdk_conversion: Call mammoth.api.dataviews.DataviewsAPI.conditional_format_delete with validated request
@@ -665,7 +671,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.dataviews.DataviewsAPI.conditional_format_update
   sdk_conversion: Call mammoth.api.dataviews.DataviewsAPI.conditional_format_update with validated request
@@ -753,7 +760,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.data_checks.DataChecksAPI.create
   sdk_conversion: Call mammoth.api.data_checks.DataChecksAPI.create with validated request fields.
@@ -807,7 +815,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.data_checks.DataChecksAPI.delete
   sdk_conversion: Call mammoth.api.data_checks.DataChecksAPI.delete with validated request fields.
@@ -957,7 +966,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.data_checks.DataChecksAPI.update
   sdk_conversion: Call mammoth.api.data_checks.DataChecksAPI.update with validated request fields.
@@ -1097,7 +1107,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the parent dataset; or pass it via the 'dataset_id' input field.
+    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.'
   options: []
   sdk_symbol: mammoth.client.ViewsResource.delete
   sdk_conversion: Call mammoth.client.ViewsResource.delete with validated request fields.
@@ -1144,7 +1155,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.derivatives.DerivativesAPI.create
   sdk_conversion: Call mammoth.api.derivatives.DerivativesAPI.create with validated request fields.
@@ -1198,7 +1210,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.derivatives.DerivativesAPI.data
   sdk_conversion: Call mammoth.api.derivatives.DerivativesAPI.data with validated request fields.
@@ -1251,7 +1264,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.derivatives.DerivativesAPI.delete
   sdk_conversion: Call mammoth.api.derivatives.DerivativesAPI.delete with validated request fields.
@@ -1349,7 +1363,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.derivatives.DerivativesAPI.update
   sdk_conversion: Call mammoth.api.derivatives.DerivativesAPI.update with validated request fields.
@@ -1637,7 +1652,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the parent dataset; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.view.ViewExport.to_azure_blob
   sdk_conversion: Call mammoth.view.ViewExport.to_azure_blob with validated request fields.
@@ -1683,7 +1699,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the parent dataset; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.view.ViewExport.to_bigquery
   sdk_conversion: Call mammoth.view.ViewExport.to_bigquery with validated request fields.
@@ -1813,7 +1830,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the parent dataset; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.view.ViewExport.to_dataset
   sdk_conversion: Call mammoth.view.ViewExport.to_dataset with validated request fields.
@@ -1906,7 +1924,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the parent dataset; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.view.ViewExport.to_elasticsearch
   sdk_conversion: Call mammoth.view.ViewExport.to_elasticsearch with validated request fields.
@@ -1952,7 +1971,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the parent dataset; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.view.ViewExport.to_email
   sdk_conversion: Call mammoth.view.ViewExport.to_email with validated request fields.
@@ -1999,7 +2019,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the parent dataset; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.view.ViewExport.to_ftp
   sdk_conversion: Call mammoth.view.ViewExport.to_ftp with validated request fields.
@@ -2137,7 +2158,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the parent dataset; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.view.ViewExport.to_s3
   sdk_conversion: Call mammoth.view.ViewExport.to_s3 with validated request fields.
@@ -2184,7 +2206,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the parent dataset; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.view.ViewExport.to_mssql
   sdk_conversion: Call mammoth.view.ViewExport.to_mssql with validated request fields.
@@ -2230,7 +2253,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the parent dataset; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.view.ViewExport.to_mysql
   sdk_conversion: Call mammoth.view.ViewExport.to_mysql with validated request fields.
@@ -2276,7 +2300,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the parent dataset; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.view.ViewExport.to_onedrive
   sdk_conversion: Call mammoth.view.ViewExport.to_onedrive with validated request fields.
@@ -2322,7 +2347,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the parent dataset; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.view.ViewExport.to_postgres
   sdk_conversion: Call mammoth.view.ViewExport.to_postgres with validated request fields.
@@ -2368,7 +2394,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the parent dataset; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.view.ViewExport.to_powerbi
   sdk_conversion: Call mammoth.view.ViewExport.to_powerbi with validated request fields.
@@ -2497,7 +2524,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the parent dataset; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.view.ViewExport.to_redshift
   sdk_conversion: Call mammoth.view.ViewExport.to_redshift with validated request fields.
@@ -2543,7 +2571,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the parent dataset; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.view.ViewExport.to_rest_api
   sdk_conversion: Call mammoth.view.ViewExport.to_rest_api with validated request fields.
@@ -2591,7 +2620,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the parent dataset; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.view.ViewExport.to_sftp
   sdk_conversion: Call mammoth.view.ViewExport.to_sftp with validated request fields.
@@ -2640,7 +2670,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the parent dataset; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.view.ViewExport.to_sharepoint
   sdk_conversion: Call mammoth.view.ViewExport.to_sharepoint with validated request fields.
@@ -2686,7 +2717,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the parent dataset; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.view.ViewExport.to_tableau
   sdk_conversion: Call mammoth.view.ViewExport.to_tableau with validated request fields.
@@ -2779,7 +2811,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: Optional parent dataset ID; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.dataviews.DataviewsAPI.apply_exportable_config
   sdk_conversion: Call mammoth.api.dataviews.DataviewsAPI.apply_exportable_config with validated request
@@ -3299,7 +3332,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.dataviews.DataviewsAPI.restore
   sdk_conversion: Call mammoth.api.dataviews.DataviewsAPI.restore with validated request fields.
@@ -4850,7 +4884,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.dataviews.DataviewsAPI.trash
   sdk_conversion: Call mammoth.api.dataviews.DataviewsAPI.trash with validated request fields.
@@ -4896,7 +4931,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.dataviews.DataviewsAPI.update
   sdk_conversion: Call mammoth.api.dataviews.DataviewsAPI.update with validated request fields.
@@ -4949,7 +4985,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.pipeline_versions.PipelineVersionsAPI.apply
   sdk_conversion: Call mammoth.api.pipeline_versions.PipelineVersionsAPI.apply with validated request
@@ -5002,7 +5039,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.pipeline_versions.PipelineVersionsAPI.delete
   sdk_conversion: Call mammoth.api.pipeline_versions.PipelineVersionsAPI.delete with validated request
@@ -5153,7 +5191,8 @@ commands:
     required: false
     metavar: DATASET_ID
     falls_back_to_field: dataset_id
-    help: ID of the dataset the view belongs to; resolved from the view when omitted.
+    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.'
   options: []
   sdk_symbol: mammoth.api.pipeline_versions.PipelineVersionsAPI.update
   sdk_conversion: Call mammoth.api.pipeline_versions.PipelineVersionsAPI.update with validated request