mammoth-cli 2.2.98__tar.gz → 2.2.99__tar.gz

{mammoth_cli-2.2.98 → mammoth_cli-2.2.99}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.2.98
+Version: 2.2.99
 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.2.98 → mammoth_cli-2.2.99}/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.98"
+__version__ = "2.2.99"
 
 # The versioned machine output envelope contract.
 SCHEMA_VERSION = 1

{mammoth_cli-2.2.98 → mammoth_cli-2.2.99}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.2.98
+version: 2.2.99
 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.2.98 → mammoth_cli-2.2.99}/mammoth_cli/commands/schema.py

@@ -2373,6 +2373,10 @@ def _inline_call_detail(entries: list[dict[str, Any]]) -> None:
         record = command_by_id(entry["command_id"])
         if record is None:
             continue
+        entry["positionals"] = [
+            {key: item[key] for key in ("name", "metavar", "type", "required")}
+            for item in _positionals(entry["command_id"])
+        ]
         fields = _compact_accepted_fields(record)
         if fields is not None:
             entry["accepted_fields"] = fields

{mammoth_cli-2.2.98 → mammoth_cli-2.2.99}/mammoth_cli/commands/view/_common.py

@@ -9,6 +9,7 @@ from mammoth_cli.errors.envelope import (
     CODE_INVALID_ARGUMENT,
     CODE_MISSING_ARGUMENT,
     CODE_MISSING_FIELD,
+    CODE_RESOURCE_NOT_FOUND,
     CODE_SDK_SYMBOL_UNRESOLVED,
     EXIT_USAGE,
     CliError,
@@ -188,6 +189,38 @@ def _view_parent_dataset_id(service: Any, invocation: Invocation, view_id: int)
     return dataset_id
 
 
+def _explain_swapped_ids(
+    service: Any, error: CliError, invocation: Invocation, view_id: int, dataset_id: int
+) -> None:
+    """Raise a clear refusal when a not-found call was given DATASET_ID then VIEW_ID.
+
+    The arguments are ``VIEW_ID [DATASET_ID]``; passing them the other way round
+    only produces a bare 404. If the first number is really a view of the second,
+    say so. Any other outcome leaves the original error to be re-raised.
+    """
+    if error.code != CODE_RESOURCE_NOT_FOUND:
+        return
+    try:
+        parent = int(service.call(_FIND_DATASET_SYMBOL, dataview_id=dataset_id))
+    except CliError:
+        return
+    if parent != view_id:
+        return
+    raise CliError(
+        code=CODE_INVALID_ARGUMENT,
+        message=(
+            f"{view_id} is a dataset id and {dataset_id} is its view; "
+            "the order is VIEW_ID DATASET_ID"
+        ),
+        exit_status=EXIT_USAGE,
+        hint=(
+            f"Run it again as: mammoth {invocation.command_path} {dataset_id} {view_id}"
+            " (same options)"
+        ),
+        details={"view_id": dataset_id, "dataset_id": view_id},
+    ) from error
+
+
 def _verified_dataset_id(
     service: Any, invocation: Invocation, view_id: int, document: dict[str, Any]
 ) -> int:
@@ -199,7 +232,12 @@ def _verified_dataset_id(
     explicit = _int_positional_at(invocation, 1, "dataset id")
     if explicit is None and document.get(_DATASET_ID_FIELD) is not None:
         explicit = _int_field(document[_DATASET_ID_FIELD], _DATASET_ID_FIELD)
-    real = _view_parent_dataset_id(service, invocation, view_id)
+    try:
+        real = _view_parent_dataset_id(service, invocation, view_id)
+    except CliError as exc:
+        if explicit is not None:
+            _explain_swapped_ids(service, exc, invocation, view_id, explicit)
+        raise
     if explicit is not None:
         _check_parent_matches(view_id, explicit, real)
     return real

{mammoth_cli-2.2.98 → mammoth_cli-2.2.99}/mammoth_cli/commands/view/data_read.py

@@ -6,10 +6,10 @@ from typing import Any
 
 from mammoth_cli.commands.view._common import (
     _COLUMNS_KEY,
-    _FIND_DATASET_SYMBOL,
     _QUERY_DATA_SYMBOL,
     _ROWS_KEY,
     HandlerResult,
+    _explain_swapped_ids,
     _forward_optional,
     _int_field,
     _page_offset,
@@ -27,8 +27,6 @@ from mammoth_cli.commands.view.columns import (
     _compile_query_filters,
 )
 from mammoth_cli.errors.envelope import (
-    CODE_INVALID_ARGUMENT,
-    CODE_RESOURCE_NOT_FOUND,
     EXIT_USAGE,
     CliError,
 )
@@ -66,7 +64,7 @@ def view_data_get(invocation: Invocation) -> HandlerResult:
                 service, invocation, auth.workspace_id, dataset_id, view_id, project_id
             )
         except CliError as exc:
-            _explain_swapped_ids(service, exc, view_id, dataset_id)
+            _explain_swapped_ids(service, exc, invocation, view_id, dataset_id)
             raise
         mapping, types, _currencies = _profile_of_info(info)
         kwargs: dict[str, Any] = {
@@ -199,33 +197,6 @@ def _close_last_page(data: Any, offset: Any) -> Any:
     return closed
 
 
-def _explain_swapped_ids(service: Any, error: CliError, view_id: int, dataset_id: int) -> None:
-    """Raise a clear refusal when a not-found read was given DATASET_ID then VIEW_ID.
-
-    The arguments are ``VIEW_ID [DATASET_ID]``; passing them the other way round
-    only produces a bare 404. If the first number is really a view of the second,
-    say so. Any other outcome leaves the original error to be re-raised.
-    """
-    if error.code != CODE_RESOURCE_NOT_FOUND:
-        return
-    try:
-        parent = int(service.call(_FIND_DATASET_SYMBOL, dataview_id=dataset_id))
-    except CliError:
-        return
-    if parent != view_id:
-        return
-    raise CliError(
-        code=CODE_INVALID_ARGUMENT,
-        message=(
-            f"{view_id} is a dataset id and {dataset_id} is its view; "
-            "the order is VIEW_ID DATASET_ID"
-        ),
-        exit_status=EXIT_USAGE,
-        hint=f"Run it again as: mammoth view data get {dataset_id} {view_id}",
-        details={"view_id": dataset_id, "dataset_id": view_id},
-    ) from error
-
-
 #: Rows a plain ``view data get`` returns unless ``limit`` says otherwise.
 _DATA_GET_DEFAULT_LIMIT = 50
 

{mammoth_cli-2.2.98 → mammoth_cli-2.2.99}/pyproject.toml

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

{mammoth_cli-2.2.98 → mammoth_cli-2.2.99}/spec/manifests/commands/view.yaml

@@ -5449,8 +5449,7 @@ commands:
     help: ID of the view to act on.
   options: []
   sdk_symbol: mammoth._mixins._text_ops.TextOpsMixin.substring
-  sdk_conversion: 'CLI one-call op: View.substring with a first-word regex, then View.submit_draft when
-    the step was staged; from mammoth_cli.commands.view_ops. The accepted document fields are in command_contract.py.'
+  sdk_conversion: 'CLI one-call op: View.substring with a first-word regex; from mammoth_cli.commands.view_ops. The accepted document fields are in command_contract.py.'
   request_model: ViewTransformFirstNameRequest
   result_model: ViewTransformFirstNameResult
   mutation_class: reversible_pipeline
@@ -5483,10 +5482,10 @@ commands:
   undo_test: null
   known_restrictions: 'Use for "extract the first name" or the first word of a text column. --input: "column"
     (a TEXT column, required) and exactly one of "new_column" or "existing_column". Takes the text up
-    to the first space. One call: if the view is in draft mode the step is staged, the draft is submitted
-    and the result waits on this step''s own run (run.transform_status DONE), not on the pipeline reading
-    ready. A draft that already held other staged steps is left staged (status staged) because submitting
-    would run them too; run view draft submit when that is intended.'
+    to the first space. One call: if the view is in draft mode the step is staged (status staged) and the
+    draft stays unsubmitted, whether or not it already held staged steps; run view draft submit when
+    that is intended. Outside draft mode the result waits on this step''s own run (run.transform_status
+    DONE), not on the pipeline reading ready.'
   reviewed_by: primary
 - command_id: view.transform.generate-sql
   command_path: view transform generate-sql
@@ -6330,8 +6329,7 @@ commands:
     help: ID of the view to act on.
   options: []
   sdk_symbol: mammoth._mixins._math_ops.MathOpsMixin.math
-  sdk_conversion: 'CLI one-call op: View.math with existing_column, then View.submit_draft when the step
-    was staged; from mammoth_cli.commands.view_ops. The accepted document fields are in command_contract.py.'
+  sdk_conversion: 'CLI one-call op: View.math with existing_column; from mammoth_cli.commands.view_ops. The accepted document fields are in command_contract.py.'
   request_model: ViewTransformUpdateColumnRequest
   result_model: ViewTransformUpdateColumnResult
   mutation_class: reversible_pipeline
@@ -6365,9 +6363,9 @@ commands:
   known_restrictions: 'Use to overwrite a numeric column with an expression over its own values ("add
     5 to Cost"). --input: "column" (an existing column, required) and "expression" (required, as in view
     transform math). Same as view transform math with existing_column set. One call: if the view is in
-    draft mode the step is staged, the draft is submitted and the result waits on this step''s own run
-    (run.transform_status DONE), not on the pipeline reading ready. A draft that already held other staged
-    steps is left staged (status staged); run view draft submit when that is intended.'
+    draft mode the step is staged (status staged) and the draft stays unsubmitted, whether or not it already
+    held staged steps; run view draft submit when that is intended. Outside draft mode the result waits
+    on this step''s own run (run.transform_status DONE), not on the pipeline reading ready.'
   reviewed_by: primary
 - command_id: view.transform.window
   command_path: view transform window
@@ -7065,7 +7063,7 @@ commands:
   - CT-VIEW-EXPLORE-PANEL-SET-ERROR
   draft_test: null
   undo_test: null
-  known_restrictions: 'This is the command that opens Explore cards in the UI. Open a card per column
+  known_restrictions: 'Saves the Explore cards of the calling user for a view; it shows nothing by itself. Open a card per column
     with {"panel": {"columns": "all"}} or {"panel": {"columns": ["Region", "Amount"]}}: each named column
     that has no card gets one and the saved cards stay. To replace the whole panel, run view explore-panel
     get first and write back {"panel": {"cards": [...]}}. A panel with no cards list is refused, because

{mammoth_cli-2.2.98 → mammoth_cli-2.2.99}/spec/manifests/compiled/commands.json

@@ -685,7 +685,7 @@
 {"command_id":"view.explore-panel.edit","command_path":"view explore-panel edit","disposition":"command","alias_of":null,"operation_ids":["Patch"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."},{"name":"dataset_id","type":"int","required":false,"metavar":"DATASET_ID","falls_back_to_field":"dataset_id","help":"Optional parent dataset ID. Leave it out and the CLI looks up the view's dataset. A value that is not the view's dataset is refused before the write."}],"options":[],"sdk_symbol":"mammoth.api.dataviews.DataviewsAPI.set_explore_panel","sdk_conversion":"Call mammoth.api.dataviews.DataviewsAPI.set_explore_panel with validated request fields.","request_model":"ViewExplorePanelEditRequest","result_model":"ViewExplorePanelEditResult","mutation_class":"benign_mutation","edits_target":true,"confirmation":"none","wait_policy":"not_async","pagination_policy":"none","acceptance_evidence":"contract_only_no_disposable_fixture","no_readback":"the command reads the saved panel back itself and returns it as \"panel\" (the same data view explore-panel get returns)","live_test":null,"live_exemption_reason":"Needs a disposable project; no live config locally.","contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view explore-panel edit VIEW_ID --help","agent_example":"mammoth view explore-panel edit 123 456 --input '{\"edits\": [{\"op\": \"metric\", \"card\": \"Region\", \"agg\": \"SUM\", \"of\": \"Amount\"}]}'","unit_tests":["UT-VIEW-EXPLORE-PANEL-EDIT"],"contract_tests":["CT-VIEW-EXPLORE-PANEL-EDIT-HUMAN","CT-VIEW-EXPLORE-PANEL-EDIT-JSON","CT-VIEW-EXPLORE-PANEL-EDIT-ERROR"],"draft_test":null,"undo_test":null,"known_restrictions":"Changes the Explore cards the way the card menus do, with display names and no card JSON, and writes the panel once. The card must be open (view explore-panel set). Input {\"edits\": [...]}, applied in order; each edit is {\"op\", \"card\": COLUMN NAME, ...}. metric: {\"agg\": COUNT} or {\"agg\": SUM|AVG|MIN|MAX|STDDEV|DISTINCT_COUNT, \"of\": NUMERIC COLUMN} (DISTINCT_COUNT takes any column). sort: {\"by\": metric|value, \"direction\": ASC|DESC}, list views only. view: {\"view\": list|columns|timeline|donut|treemap}, which depends on the column type. level: {\"level\": a date level or a number bucket width}. filter / exclude: {\"values\": [...]} for text, {\"from\", \"to\"} for ranges, {\"blanks\": true} for blanks; clear: the filter off; remove: the card off. Query cards: {\"op\": \"search\", \"text\": \"...\", \"columns\": [...]}, {\"op\": \"scatter\", \"x\": NUMERIC, \"y\": NUMERIC, \"box\": {...}} and {\"op\": \"ask\", \"question\": \"...\"} (the question goes to the same suggestions call the web app makes and its condition is kept). An unknown column, a column of the wrong type or a value outside the web app's options is refused with the valid choices. The result carries \"panel\", the panel read back. It is a per-user preference: it does not change the view or what other users see.","reviewed_by":"primary"},
 {"command_id":"view.explore-panel.export-image","command_path":"view explore-panel export-image","disposition":"command","alias_of":null,"operation_ids":["RenderFigureSvg"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."},{"name":"dataset_id","type":"int","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."}],"options":[],"sdk_symbol":"mammoth.api.dashboards.DashboardsAPI.render_figure_svg","sdk_conversion":"Read the view's saved Explore panel and the card's grouped rows, build the engine figure spec from them, call mammoth.api.dashboards.DashboardsAPI.render_figure_svg, and write the returned SVG to output_path.","request_model":"ViewExplorePanelExportImageRequest","result_model":"ViewExplorePanelExportImageResult","mutation_class":"read","edits_target":false,"confirmation":"none","wait_policy":"not_async","pagination_policy":"none","acceptance_evidence":"contract_only_no_disposable_fixture","no_readback":"the result carries output_path, the file written; the SVG is not echoed","live_test":null,"live_exemption_reason":"The render route is not deployed to koyal yet (mvc-service PR","contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view explore-panel export-image VIEW_ID --help","agent_example":"mammoth view explore-panel export-image 123 --input '{\"card\": \"Region\", \"output_path\": \"card.svg\", \"style_id\": null}'","unit_tests":["UT-VIEW-EXPLORE-PANEL-EXPORT-IMAGE"],"contract_tests":["CT-VIEW-EXPLORE-PANEL-EXPORT-IMAGE-HUMAN","CT-VIEW-EXPLORE-PANEL-EXPORT-IMAGE-JSON","CT-VIEW-EXPLORE-PANEL-EXPORT-IMAGE-ERROR"],"draft_test":null,"undo_test":null,"known_restrictions":"Writes the open Explore card \"card\" (its column display name) as an SVG file at \"output_path\" (default explore-card-VIEW_ID.svg). The backend has no rasterizer, so this writes SVG only; the web app's PNG is a browser screenshot. A bar card becomes a bar chart (one bar per group, its value the card's metric); a list card becomes a table of its rows. The rows are read as view data explore reads them, so the list is the top values the backend returns (TEXT: 20). \"style_id\" optionally renders with a saved style. The card must be open (view explore-panel set). Not available inside the Mammoth app: it writes a file on the host. It is a per-user preference read; it does not change the view or the panel.","reviewed_by":"primary"},
 {"command_id":"view.explore-panel.get","command_path":"view explore-panel get","disposition":"command","alias_of":null,"operation_ids":[],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."},{"name":"dataset_id","type":"int","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."}],"options":[],"sdk_symbol":"mammoth.api.dataviews.DataviewsAPI.explore_panel","sdk_conversion":"Call mammoth.api.dataviews.DataviewsAPI.explore_panel with validated request fields.","request_model":"ViewExplorePanelGetRequest","result_model":"ViewExplorePanelGetResult","mutation_class":"read","confirmation":"none","wait_policy":"not_async","pagination_policy":"none","acceptance_evidence":"contract_only_no_disposable_fixture","live_test":null,"live_exemption_reason":"Needs a disposable project with a saved Explore panel; no live config locally.","contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view explore-panel get VIEW_ID --help","agent_example":"mammoth view explore-panel get 123 456","unit_tests":["UT-VIEW-EXPLORE-PANEL-GET"],"contract_tests":["CT-VIEW-EXPLORE-PANEL-GET-HUMAN","CT-VIEW-EXPLORE-PANEL-GET-JSON","CT-VIEW-EXPLORE-PANEL-GET-ERROR"],"draft_test":null,"undo_test":null,"known_restrictions":"Read-only. Returns the Explore panel the caller saved on this view, {height, cards}, or {} when none is saved. It is a per-user preference: other users do not see it. VIEW_ID is the only id needed.","reviewed_by":"primary"},
-{"command_id":"view.explore-panel.set","command_path":"view explore-panel set","disposition":"command","alias_of":null,"operation_ids":["Patch"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."},{"name":"dataset_id","type":"int","required":false,"metavar":"DATASET_ID","falls_back_to_field":"dataset_id","help":"Optional parent dataset ID. Leave it out and the CLI looks up the view's dataset. A value that is not the view's dataset is refused before the write."}],"options":[],"sdk_symbol":"mammoth.api.dataviews.DataviewsAPI.set_explore_panel","sdk_conversion":"Call mammoth.api.dataviews.DataviewsAPI.set_explore_panel with validated request fields.","request_model":"ViewExplorePanelSetRequest","result_model":"ViewExplorePanelSetResult","mutation_class":"benign_mutation","edits_target":true,"confirmation":"none","wait_policy":"not_async","pagination_policy":"none","acceptance_evidence":"contract_only_no_disposable_fixture","no_readback":"the command reads the saved panel back itself and returns it as \"panel\" (the same data view explore-panel get returns); a generic state block would drop the open flag and nested fields","live_test":null,"live_exemption_reason":"Needs a disposable project; no live config locally.","contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view explore-panel set VIEW_ID --help","agent_example":"mammoth view explore-panel set 123 456 --input '{\"panel\": {\"columns\": \"all\"}}'","unit_tests":["UT-VIEW-EXPLORE-PANEL-SET"],"contract_tests":["CT-VIEW-EXPLORE-PANEL-SET-HUMAN","CT-VIEW-EXPLORE-PANEL-SET-JSON","CT-VIEW-EXPLORE-PANEL-SET-ERROR"],"draft_test":null,"undo_test":null,"known_restrictions":"This is the command that opens Explore cards in the UI. Open a card per column with {\"panel\": {\"columns\": \"all\"}} or {\"panel\": {\"columns\": [\"Region\", \"Amount\"]}}: each named column that has no card gets one and the saved cards stay. To replace the whole panel, run view explore-panel get first and write back {\"panel\": {\"cards\": [...]}}. A panel with no cards list is refused, because the web app shows only cards. The result carries \"panel\", the panel read back after the write (what get returns): check its cards to see which are open. It is a per-user preference: it does not change the view or what other users see.","reviewed_by":"primary"},
+{"command_id":"view.explore-panel.set","command_path":"view explore-panel set","disposition":"command","alias_of":null,"operation_ids":["Patch"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."},{"name":"dataset_id","type":"int","required":false,"metavar":"DATASET_ID","falls_back_to_field":"dataset_id","help":"Optional parent dataset ID. Leave it out and the CLI looks up the view's dataset. A value that is not the view's dataset is refused before the write."}],"options":[],"sdk_symbol":"mammoth.api.dataviews.DataviewsAPI.set_explore_panel","sdk_conversion":"Call mammoth.api.dataviews.DataviewsAPI.set_explore_panel with validated request fields.","request_model":"ViewExplorePanelSetRequest","result_model":"ViewExplorePanelSetResult","mutation_class":"benign_mutation","edits_target":true,"confirmation":"none","wait_policy":"not_async","pagination_policy":"none","acceptance_evidence":"contract_only_no_disposable_fixture","no_readback":"the command reads the saved panel back itself and returns it as \"panel\" (the same data view explore-panel get returns); a generic state block would drop the open flag and nested fields","live_test":null,"live_exemption_reason":"Needs a disposable project; no live config locally.","contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view explore-panel set VIEW_ID --help","agent_example":"mammoth view explore-panel set 123 456 --input '{\"panel\": {\"columns\": \"all\"}}'","unit_tests":["UT-VIEW-EXPLORE-PANEL-SET"],"contract_tests":["CT-VIEW-EXPLORE-PANEL-SET-HUMAN","CT-VIEW-EXPLORE-PANEL-SET-JSON","CT-VIEW-EXPLORE-PANEL-SET-ERROR"],"draft_test":null,"undo_test":null,"known_restrictions":"Saves the Explore cards of the calling user for a view; it shows nothing by itself. Open a card per column with {\"panel\": {\"columns\": \"all\"}} or {\"panel\": {\"columns\": [\"Region\", \"Amount\"]}}: each named column that has no card gets one and the saved cards stay. To replace the whole panel, run view explore-panel get first and write back {\"panel\": {\"cards\": [...]}}. A panel with no cards list is refused, because the web app shows only cards. The result carries \"panel\", the panel read back after the write (what get returns): check its cards to see which are open. It is a per-user preference: it does not change the view or what other users see.","reviewed_by":"primary"},
 {"command_id":"view.export.azure-blob","command_path":"view export azure-blob","disposition":"command","alias_of":null,"operation_ids":["AddExport"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to export."},{"name":"dataset_id","type":"int","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."}],"options":[],"sdk_symbol":"mammoth.view.ViewExport.to_azure_blob","sdk_conversion":"Call mammoth.view.ViewExport.to_azure_blob with validated request fields.","request_model":"ViewExportAzureBlobRequest","result_model":"ViewExportAzureBlobResult","mutation_class":"external_effect","edits_target":false,"confirmation":"yes_always","wait_policy":"returns_job","pagination_policy":"none","acceptance_evidence":"contract_only_high_impact","readback":{"command":"job.get","ids":{"job_id":"result.future_id|result.job.id"},"kind":"delivery"},"live_test":null,"live_exemption_reason":"High-impact or external-effect operation without a disposable fixture.","contract_fixture":null,"required_fixture_guard":null,"secret_fields":["client_secret"],"human_example":"mammoth view export azure-blob VIEW_ID --help","agent_example":"mammoth view export azure-blob 123 456 --input /private/path/request.json --yes","unit_tests":["UT-VIEW-EXPORT-AZURE-BLOB"],"contract_tests":["CT-VIEW-EXPORT-AZURE-BLOB-HUMAN","CT-VIEW-EXPORT-AZURE-BLOB-JSON","CT-VIEW-EXPORT-AZURE-BLOB-ERROR"],"draft_test":null,"undo_test":null,"known_restrictions":null,"reviewed_by":"primary"},
 {"command_id":"view.export.bigquery","command_path":"view export bigquery","disposition":"command","alias_of":null,"operation_ids":["AddExport"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to export."},{"name":"dataset_id","type":"int","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."}],"options":[],"sdk_symbol":"mammoth.view.ViewExport.to_bigquery","sdk_conversion":"Call mammoth.view.ViewExport.to_bigquery with validated request fields.","request_model":"ViewExportBigqueryRequest","result_model":"ViewExportBigqueryResult","mutation_class":"external_effect","edits_target":false,"confirmation":"yes_always","wait_policy":"returns_job","pagination_policy":"none","acceptance_evidence":"contract_only_high_impact","readback":{"command":"job.get","ids":{"job_id":"result.future_id|result.job.id"},"kind":"delivery"},"live_test":null,"live_exemption_reason":"High-impact or external-effect operation without a disposable fixture.","contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view export bigquery VIEW_ID --help","agent_example":"mammoth view export bigquery 123 456 --input '{\"selected_profile\": {}, \"selected_identity\": {}, \"table\": \"exports\"}' --yes","unit_tests":["UT-VIEW-EXPORT-BIGQUERY"],"contract_tests":["CT-VIEW-EXPORT-BIGQUERY-HUMAN","CT-VIEW-EXPORT-BIGQUERY-JSON","CT-VIEW-EXPORT-BIGQUERY-ERROR"],"draft_test":null,"undo_test":null,"known_restrictions":"Require upsert keys for UPSERT and type both partition variants. With export_type REPLACE (the default) it drops and recreates the destination table on this export and on every later run of the view's pipeline; refused unless the input sets replace_table to true (replace_table_not_acknowledged). The result carries refreshes_on_pipeline_run and a note saying so.","reviewed_by":"primary"},
 {"command_id":"view.export.create","command_path":"view export create","disposition":"command","alias_of":null,"operation_ids":["AddExport"],"positionals":[{"name":"dataview_id","type":"int","required":true,"metavar":"DATAVIEW_ID","falls_back_to_field":null,"help":"ID of the dataview."}],"options":[],"sdk_symbol":"mammoth.api.exports.ExportsAPI.create","sdk_conversion":"Call mammoth.api.exports.ExportsAPI.create with validated request fields.","request_model":"ViewExportCreateRequest","result_model":"ViewExportCreateResult","mutation_class":"external_effect","edits_target":false,"confirmation":"yes_always","wait_policy":"returns_job","pagination_policy":"none","acceptance_evidence":"contract_only_high_impact","readback":{"command":"job.get","ids":{"job_id":"result.future_id|result.job.id"},"kind":"delivery"},"live_test":null,"live_exemption_reason":"High-impact or external-effect operation without a disposable fixture.","contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view export create DATAVIEW_ID --help","agent_example":"mammoth view export create 123 --input '{\"export_spec\": {\"DATAVIEW_ID\": 1, \"handler_type\": \"postgres\", \"trigger_type\": \"none\", \"run_immediately\": true}}' --yes","unit_tests":["UT-VIEW-EXPORT-CREATE"],"contract_tests":["CT-VIEW-EXPORT-CREATE-HUMAN","CT-VIEW-EXPORT-CREATE-JSON","CT-VIEW-EXPORT-CREATE-ERROR"],"draft_test":null,"undo_test":null,"known_restrictions":"Replace open destination dictionaries with the typed destination union.","reviewed_by":"primary"},
@@ -753,7 +753,7 @@
 {"command_id":"view.transform.extract-date","command_path":"view transform extract-date","disposition":"command","alias_of":null,"operation_ids":["AddTask"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."}],"options":[],"sdk_symbol":"mammoth._mixins._date_ops.DateOpsMixin.extract_date","sdk_conversion":"Call mammoth._mixins._date_ops.DateOpsMixin.extract_date with validated request fields.","request_model":"ViewTransformExtractDateRequest","result_model":"ViewTransformExtractDateResult","mutation_class":"reversible_pipeline","edits_target":true,"confirmation":"none","wait_policy":"always_wait","pagination_policy":"none","acceptance_evidence":"live_disposable_project","readback":{"command":"view.data.get","ids":{"view_id":"positional.0"},"kind":"data"},"live_test":"LT-VIEW-TRANSFORM-EXTRACT-DATE","live_exemption_reason":null,"contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view transform extract-date VIEW_ID --help","agent_example":"mammoth view transform extract-date 123 --input '{\"column\": \"Status\", \"component\": \"year\", \"dataset_id\": 456}'","unit_tests":["UT-VIEW-TRANSFORM-EXTRACT-DATE"],"contract_tests":["CT-VIEW-TRANSFORM-EXTRACT-DATE-HUMAN","CT-VIEW-TRANSFORM-EXTRACT-DATE-JSON","CT-VIEW-TRANSFORM-EXTRACT-DATE-ERROR"],"draft_test":"LT-VIEW-TRANSFORM-EXTRACT-DATE-DRAFT","undo_test":"LT-VIEW-TRANSFORM-EXTRACT-DATE-UNDO","known_restrictions":"Observe first: `view get VIEW_ID` to confirm the column type is DATE (run convert-type first if TEXT) and `view data get` to check a few values. For a month bucket use `year_month_number` (\"2026-10\"), which sorts in time order; `year_month` (\"2026, October\") sorts alphabetically on a chart axis.","reviewed_by":"primary"},
 {"command_id":"view.transform.fill-missing","command_path":"view transform fill-missing","disposition":"command","alias_of":null,"operation_ids":["AddTask"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."}],"options":[],"sdk_symbol":"mammoth._mixins._row_ops.RowOpsMixin.fill_missing","sdk_conversion":"Call mammoth._mixins._row_ops.RowOpsMixin.fill_missing with validated request fields.","request_model":"ViewTransformFillMissingRequest","result_model":"ViewTransformFillMissingResult","mutation_class":"reversible_pipeline","edits_target":true,"confirmation":"none","wait_policy":"always_wait","pagination_policy":"none","acceptance_evidence":"live_disposable_project","readback":{"command":"view.data.get","ids":{"view_id":"positional.0"},"kind":"data"},"live_test":"LT-VIEW-TRANSFORM-FILL-MISSING","live_exemption_reason":null,"contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view transform fill-missing VIEW_ID --help","agent_example":"mammoth view transform fill-missing 123 --input '{\"column\": \"Status\", \"direction\": \"FIRST_VALUE\", \"dataset_id\": 456}'","unit_tests":["UT-VIEW-TRANSFORM-FILL-MISSING"],"contract_tests":["CT-VIEW-TRANSFORM-FILL-MISSING-HUMAN","CT-VIEW-TRANSFORM-FILL-MISSING-JSON","CT-VIEW-TRANSFORM-FILL-MISSING-ERROR"],"draft_test":"LT-VIEW-TRANSFORM-FILL-MISSING-DRAFT","undo_test":"LT-VIEW-TRANSFORM-FILL-MISSING-UNDO","known_restrictions":"Observe first: `view data profile VIEW_ID` for the blank count of the column, so the result can be compared to it.","reviewed_by":"primary"},
 {"command_id":"view.transform.filter","command_path":"view transform filter","disposition":"command","alias_of":null,"operation_ids":["AddTask"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."}],"options":[],"sdk_symbol":"mammoth._mixins._filter_ops.FilterOpsMixin.filter_rows","sdk_conversion":"Call mammoth._mixins._filter_ops.FilterOpsMixin.filter_rows with validated request fields.","request_model":"ViewTransformFilterRequest","result_model":"ViewTransformFilterResult","mutation_class":"reversible_pipeline","edits_target":true,"confirmation":"none","wait_policy":"always_wait","pagination_policy":"none","acceptance_evidence":"live_disposable_project","readback":{"command":"view.data.get","ids":{"view_id":"positional.0"},"kind":"data"},"live_test":"LT-VIEW-TRANSFORM-FILTER","live_exemption_reason":null,"contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view transform filter VIEW_ID --help","agent_example":"mammoth view transform filter 123 --input '{\"condition\": {\"column\": \"Status\", \"operator\": \"EQ\", \"value\": \"Active\"}, \"dataset_id\": 456}'","unit_tests":["UT-VIEW-TRANSFORM-FILTER"],"contract_tests":["CT-VIEW-TRANSFORM-FILTER-HUMAN","CT-VIEW-TRANSFORM-FILTER-JSON","CT-VIEW-TRANSFORM-FILTER-ERROR"],"draft_test":"LT-VIEW-TRANSFORM-FILTER-DRAFT","undo_test":"LT-VIEW-TRANSFORM-FILTER-UNDO","known_restrictions":"Observe first: count the rows that match with `view data aggregate` using the same condition, and the total with no condition.","reviewed_by":"primary"},
-{"command_id":"view.transform.first-name","command_path":"view transform first-name","disposition":"command","alias_of":null,"operation_ids":["AddTask"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."}],"options":[],"sdk_symbol":"mammoth._mixins._text_ops.TextOpsMixin.substring","sdk_conversion":"CLI one-call op: View.substring with a first-word regex, then View.submit_draft when the step was staged; from mammoth_cli.commands.view_ops. The accepted document fields are in command_contract.py.","request_model":"ViewTransformFirstNameRequest","result_model":"ViewTransformFirstNameResult","mutation_class":"reversible_pipeline","edits_target":true,"confirmation":"none","wait_policy":"always_wait","pagination_policy":"none","acceptance_evidence":"live_disposable_project","readback":{"command":"view.data.get","ids":{"view_id":"positional.0"},"kind":"data"},"live_test":null,"live_exemption_reason":"Covered by tests/realcode/test_one_call_transform_ops.py, which drives the real CLI and SDK against a recording HTTP socket; no live case is recorded yet.","contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view transform first-name VIEW_ID --help","agent_example":"mammoth view transform first-name 123 --input '{\"column\": \"Name\", \"new_column\": \"First name\", \"dataset_id\": 456}'","unit_tests":["UT-VIEW-TRANSFORM-FIRST-NAME"],"contract_tests":["CT-VIEW-TRANSFORM-FIRST-NAME-HUMAN","CT-VIEW-TRANSFORM-FIRST-NAME-JSON","CT-VIEW-TRANSFORM-FIRST-NAME-ERROR"],"draft_test":null,"undo_test":null,"known_restrictions":"Use for \"extract the first name\" or the first word of a text column. --input: \"column\" (a TEXT column, required) and exactly one of \"new_column\" or \"existing_column\". Takes the text up to the first space. One call: if the view is in draft mode the step is staged, the draft is submitted and the result waits on this step's own run (run.transform_status DONE), not on the pipeline reading ready. A draft that already held other staged steps is left staged (status staged) because submitting would run them too; run view draft submit when that is intended.","reviewed_by":"primary"},
+{"command_id":"view.transform.first-name","command_path":"view transform first-name","disposition":"command","alias_of":null,"operation_ids":["AddTask"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."}],"options":[],"sdk_symbol":"mammoth._mixins._text_ops.TextOpsMixin.substring","sdk_conversion":"CLI one-call op: View.substring with a first-word regex; from mammoth_cli.commands.view_ops. The accepted document fields are in command_contract.py.","request_model":"ViewTransformFirstNameRequest","result_model":"ViewTransformFirstNameResult","mutation_class":"reversible_pipeline","edits_target":true,"confirmation":"none","wait_policy":"always_wait","pagination_policy":"none","acceptance_evidence":"live_disposable_project","readback":{"command":"view.data.get","ids":{"view_id":"positional.0"},"kind":"data"},"live_test":null,"live_exemption_reason":"Covered by tests/realcode/test_one_call_transform_ops.py, which drives the real CLI and SDK against a recording HTTP socket; no live case is recorded yet.","contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view transform first-name VIEW_ID --help","agent_example":"mammoth view transform first-name 123 --input '{\"column\": \"Name\", \"new_column\": \"First name\", \"dataset_id\": 456}'","unit_tests":["UT-VIEW-TRANSFORM-FIRST-NAME"],"contract_tests":["CT-VIEW-TRANSFORM-FIRST-NAME-HUMAN","CT-VIEW-TRANSFORM-FIRST-NAME-JSON","CT-VIEW-TRANSFORM-FIRST-NAME-ERROR"],"draft_test":null,"undo_test":null,"known_restrictions":"Use for \"extract the first name\" or the first word of a text column. --input: \"column\" (a TEXT column, required) and exactly one of \"new_column\" or \"existing_column\". Takes the text up to the first space. One call: if the view is in draft mode the step is staged (status staged) and the draft stays unsubmitted, whether or not it already held staged steps; run view draft submit when that is intended. Outside draft mode the result waits on this step's own run (run.transform_status DONE), not on the pipeline reading ready.","reviewed_by":"primary"},
 {"command_id":"view.transform.generate-sql","command_path":"view transform generate-sql","disposition":"command","alias_of":null,"operation_ids":["AddTask"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."}],"options":[],"sdk_symbol":"mammoth._mixins._advanced_ops.AdvancedOpsMixin.generate_sql","sdk_conversion":"Call mammoth._mixins._advanced_ops.AdvancedOpsMixin.generate_sql with validated request fields.","request_model":"ViewTransformGenerateSqlRequest","result_model":"ViewTransformGenerateSqlResult","mutation_class":"reversible_pipeline","edits_target":false,"confirmation":"none","wait_policy":"always_wait","pagination_policy":"none","acceptance_evidence":"live_disposable_project","readback":{"command":"view.data.get","ids":{"view_id":"positional.0"},"kind":"data"},"live_test":"LT-VIEW-TRANSFORM-GENERATE-SQL","live_exemption_reason":null,"contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view transform generate-sql VIEW_ID --help","agent_example":"mammoth view transform generate-sql 123 --input '{\"intent\": \"Summarize revenue by region\", \"dataset_id\": 456}'","unit_tests":["UT-VIEW-TRANSFORM-GENERATE-SQL"],"contract_tests":["CT-VIEW-TRANSFORM-GENERATE-SQL-HUMAN","CT-VIEW-TRANSFORM-GENERATE-SQL-JSON","CT-VIEW-TRANSFORM-GENERATE-SQL-ERROR"],"draft_test":"LT-VIEW-TRANSFORM-GENERATE-SQL-DRAFT","undo_test":"LT-VIEW-TRANSFORM-GENERATE-SQL-UNDO","known_restrictions":"Writes and validates a SQL query from the intent and returns it as data.sql; it does not change the view (release, 2026-09-25: no task was added). Apply the query with view transform add-sql (data.apply is the exact command); add-sql replaces the view's columns with the result.","reviewed_by":"primary"},
 {"command_id":"view.transform.increment-date","command_path":"view transform increment-date","disposition":"command","alias_of":null,"operation_ids":["AddTask"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."}],"options":[],"sdk_symbol":"mammoth._mixins._date_ops.DateOpsMixin.increment_date","sdk_conversion":"Call mammoth._mixins._date_ops.DateOpsMixin.increment_date with validated request fields.","request_model":"ViewTransformIncrementDateRequest","result_model":"ViewTransformIncrementDateResult","mutation_class":"reversible_pipeline","edits_target":true,"confirmation":"none","wait_policy":"always_wait","pagination_policy":"none","acceptance_evidence":"live_disposable_project","readback":{"command":"view.data.get","ids":{"view_id":"positional.0"},"kind":"data"},"live_test":"LT-VIEW-TRANSFORM-INCREMENT-DATE","live_exemption_reason":null,"contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view transform increment-date VIEW_ID --help","agent_example":"mammoth view transform increment-date 123 --input '{\"column\": \"Status\", \"delta\": {}, \"dataset_id\": 456}'","unit_tests":["UT-VIEW-TRANSFORM-INCREMENT-DATE"],"contract_tests":["CT-VIEW-TRANSFORM-INCREMENT-DATE-HUMAN","CT-VIEW-TRANSFORM-INCREMENT-DATE-JSON","CT-VIEW-TRANSFORM-INCREMENT-DATE-ERROR"],"draft_test":"LT-VIEW-TRANSFORM-INCREMENT-DATE-DRAFT","undo_test":"LT-VIEW-TRANSFORM-INCREMENT-DATE-UNDO","known_restrictions":"Observe first: `view get VIEW_ID` to confirm the column type is DATE, and `view data get` to check a few values.","reviewed_by":"primary"},
 {"command_id":"view.transform.join","command_path":"view transform join","disposition":"command","alias_of":null,"operation_ids":["AddTask"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."}],"options":[],"sdk_symbol":"mammoth._mixins._advanced_ops.AdvancedOpsMixin.join","sdk_conversion":"Call mammoth._mixins._advanced_ops.AdvancedOpsMixin.join with validated request fields.","request_model":"ViewTransformJoinRequest","result_model":"ViewTransformJoinResult","mutation_class":"reversible_pipeline","edits_target":true,"confirmation":"none","wait_policy":"always_wait","pagination_policy":"none","acceptance_evidence":"live_disposable_project","readback":{"command":"view.data.get","ids":{"view_id":"positional.0"},"kind":"data"},"live_test":"LT-VIEW-TRANSFORM-JOIN","live_exemption_reason":null,"contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view transform join VIEW_ID --help","agent_example":"mammoth view transform join 123 --input '{\"foreign_view\": 1, \"join_type\": \"INNER\", \"on\": [{\"left\": \"Customer ID\", \"right\": \"Customer ID\"}], \"select\": [\"Region\"], \"dataset_id\": 456, \"foreign_dataset_id\": 457}'","unit_tests":["UT-VIEW-TRANSFORM-JOIN"],"contract_tests":["CT-VIEW-TRANSFORM-JOIN-HUMAN","CT-VIEW-TRANSFORM-JOIN-JSON","CT-VIEW-TRANSFORM-JOIN-ERROR"],"draft_test":"LT-VIEW-TRANSFORM-JOIN-DRAFT","undo_test":"LT-VIEW-TRANSFORM-JOIN-UNDO","known_restrictions":"Observe first: read both key columns (`view data get`, `view data profile`) and run this with `--dry-run` for `join_preview.match_rate`.","reviewed_by":"primary"},
@@ -771,7 +771,7 @@
 {"command_id":"view.transform.substring","command_path":"view transform substring","disposition":"command","alias_of":null,"operation_ids":["AddTask"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."}],"options":[],"sdk_symbol":"mammoth._mixins._text_ops.TextOpsMixin.substring","sdk_conversion":"Call mammoth._mixins._text_ops.TextOpsMixin.substring with validated request fields.","request_model":"ViewTransformSubstringRequest","result_model":"ViewTransformSubstringResult","mutation_class":"reversible_pipeline","edits_target":true,"confirmation":"none","wait_policy":"always_wait","pagination_policy":"none","acceptance_evidence":"live_disposable_project","readback":{"command":"view.data.get","ids":{"view_id":"positional.0"},"kind":"data"},"live_test":"LT-VIEW-TRANSFORM-SUBSTRING","live_exemption_reason":null,"contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view transform substring VIEW_ID --help","agent_example":"mammoth view transform substring 123 --input '{\"column\": \"Status\", \"dataset_id\": 456}'","unit_tests":["UT-VIEW-TRANSFORM-SUBSTRING"],"contract_tests":["CT-VIEW-TRANSFORM-SUBSTRING-HUMAN","CT-VIEW-TRANSFORM-SUBSTRING-JSON","CT-VIEW-TRANSFORM-SUBSTRING-ERROR"],"draft_test":"LT-VIEW-TRANSFORM-SUBSTRING-DRAFT","undo_test":"LT-VIEW-TRANSFORM-SUBSTRING-UNDO","known_restrictions":"Observe first: `view data get VIEW_ID` on the column to see the real value lengths and formats.","reviewed_by":"primary"},
 {"command_id":"view.transform.text","command_path":"view transform text","disposition":"command","alias_of":null,"operation_ids":["AddTask"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."}],"options":[],"sdk_symbol":"mammoth._mixins._text_ops.TextOpsMixin.text_transform","sdk_conversion":"Call mammoth._mixins._text_ops.TextOpsMixin.text_transform with validated request fields.","request_model":"ViewTransformTextRequest","result_model":"ViewTransformTextResult","mutation_class":"reversible_pipeline","edits_target":true,"confirmation":"none","wait_policy":"always_wait","pagination_policy":"none","acceptance_evidence":"live_disposable_project","readback":{"command":"view.data.get","ids":{"view_id":"positional.0"},"kind":"data"},"live_test":"LT-VIEW-TRANSFORM-TEXT","live_exemption_reason":null,"contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view transform text VIEW_ID --help","agent_example":"mammoth view transform text 123 --input '{\"columns\": [\"Status\"], \"dataset_id\": 456}'","unit_tests":["UT-VIEW-TRANSFORM-TEXT"],"contract_tests":["CT-VIEW-TRANSFORM-TEXT-HUMAN","CT-VIEW-TRANSFORM-TEXT-JSON","CT-VIEW-TRANSFORM-TEXT-ERROR"],"draft_test":"LT-VIEW-TRANSFORM-TEXT-DRAFT","undo_test":"LT-VIEW-TRANSFORM-TEXT-UNDO","known_restrictions":"Observe first: `view data profile VIEW_ID` on the column to see the current values (case, padding, spelling variants).","reviewed_by":"primary"},
 {"command_id":"view.transform.unnest","command_path":"view transform unnest","disposition":"command","alias_of":null,"operation_ids":["AddTask"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."}],"options":[],"sdk_symbol":"mammoth._mixins._row_ops.RowOpsMixin.unnest","sdk_conversion":"Call mammoth._mixins._row_ops.RowOpsMixin.unnest with validated request fields.","request_model":"ViewTransformUnnestRequest","result_model":"ViewTransformUnnestResult","mutation_class":"reversible_pipeline","edits_target":true,"confirmation":"none","wait_policy":"always_wait","pagination_policy":"none","acceptance_evidence":"live_disposable_project","readback":{"command":"view.data.get","ids":{"view_id":"positional.0"},"kind":"data"},"live_test":"LT-VIEW-TRANSFORM-UNNEST","live_exemption_reason":null,"contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view transform unnest VIEW_ID --help","agent_example":"mammoth view transform unnest 123 --input '{\"columns\": [\"Status\"], \"dataset_id\": 456}'","unit_tests":["UT-VIEW-TRANSFORM-UNNEST"],"contract_tests":["CT-VIEW-TRANSFORM-UNNEST-HUMAN","CT-VIEW-TRANSFORM-UNNEST-JSON","CT-VIEW-TRANSFORM-UNNEST-ERROR"],"draft_test":"LT-VIEW-TRANSFORM-UNNEST-DRAFT","undo_test":"LT-VIEW-TRANSFORM-UNNEST-UNDO","known_restrictions":"Observe first: `view data get VIEW_ID` on the column to see how the nested values are stored.","reviewed_by":"primary"},
-{"command_id":"view.transform.update-column","command_path":"view transform update-column","disposition":"command","alias_of":null,"operation_ids":["AddTask"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."}],"options":[],"sdk_symbol":"mammoth._mixins._math_ops.MathOpsMixin.math","sdk_conversion":"CLI one-call op: View.math with existing_column, then View.submit_draft when the step was staged; from mammoth_cli.commands.view_ops. The accepted document fields are in command_contract.py.","request_model":"ViewTransformUpdateColumnRequest","result_model":"ViewTransformUpdateColumnResult","mutation_class":"reversible_pipeline","edits_target":true,"confirmation":"none","wait_policy":"always_wait","pagination_policy":"none","acceptance_evidence":"live_disposable_project","readback":{"command":"view.data.get","ids":{"view_id":"positional.0"},"kind":"data"},"live_test":null,"live_exemption_reason":"Covered by tests/realcode/test_one_call_transform_ops.py, which drives the real CLI and SDK against a recording HTTP socket; no live case is recorded yet.","contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view transform update-column VIEW_ID --help","agent_example":"mammoth view transform update-column 123 --input '{\"column\": \"Cost\", \"expression\": \"Cost + 5\", \"dataset_id\": 456}'","unit_tests":["UT-VIEW-TRANSFORM-UPDATE-COLUMN"],"contract_tests":["CT-VIEW-TRANSFORM-UPDATE-COLUMN-HUMAN","CT-VIEW-TRANSFORM-UPDATE-COLUMN-JSON","CT-VIEW-TRANSFORM-UPDATE-COLUMN-ERROR"],"draft_test":null,"undo_test":null,"known_restrictions":"Use to overwrite a numeric column with an expression over its own values (\"add 5 to Cost\"). --input: \"column\" (an existing column, required) and \"expression\" (required, as in view transform math). Same as view transform math with existing_column set. One call: if the view is in draft mode the step is staged, the draft is submitted and the result waits on this step's own run (run.transform_status DONE), not on the pipeline reading ready. A draft that already held other staged steps is left staged (status staged); run view draft submit when that is intended.","reviewed_by":"primary"},
+{"command_id":"view.transform.update-column","command_path":"view transform update-column","disposition":"command","alias_of":null,"operation_ids":["AddTask"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."}],"options":[],"sdk_symbol":"mammoth._mixins._math_ops.MathOpsMixin.math","sdk_conversion":"CLI one-call op: View.math with existing_column; from mammoth_cli.commands.view_ops. The accepted document fields are in command_contract.py.","request_model":"ViewTransformUpdateColumnRequest","result_model":"ViewTransformUpdateColumnResult","mutation_class":"reversible_pipeline","edits_target":true,"confirmation":"none","wait_policy":"always_wait","pagination_policy":"none","acceptance_evidence":"live_disposable_project","readback":{"command":"view.data.get","ids":{"view_id":"positional.0"},"kind":"data"},"live_test":null,"live_exemption_reason":"Covered by tests/realcode/test_one_call_transform_ops.py, which drives the real CLI and SDK against a recording HTTP socket; no live case is recorded yet.","contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view transform update-column VIEW_ID --help","agent_example":"mammoth view transform update-column 123 --input '{\"column\": \"Cost\", \"expression\": \"Cost + 5\", \"dataset_id\": 456}'","unit_tests":["UT-VIEW-TRANSFORM-UPDATE-COLUMN"],"contract_tests":["CT-VIEW-TRANSFORM-UPDATE-COLUMN-HUMAN","CT-VIEW-TRANSFORM-UPDATE-COLUMN-JSON","CT-VIEW-TRANSFORM-UPDATE-COLUMN-ERROR"],"draft_test":null,"undo_test":null,"known_restrictions":"Use to overwrite a numeric column with an expression over its own values (\"add 5 to Cost\"). --input: \"column\" (an existing column, required) and \"expression\" (required, as in view transform math). Same as view transform math with existing_column set. One call: if the view is in draft mode the step is staged (status staged) and the draft stays unsubmitted, whether or not it already held staged steps; run view draft submit when that is intended. Outside draft mode the result waits on this step's own run (run.transform_status DONE), not on the pipeline reading ready.","reviewed_by":"primary"},
 {"command_id":"view.transform.window","command_path":"view transform window","disposition":"command","alias_of":null,"operation_ids":["AddTask"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."}],"options":[],"sdk_symbol":"mammoth._mixins._aggregate_ops.AggregateOpsMixin.window","sdk_conversion":"Call mammoth._mixins._aggregate_ops.AggregateOpsMixin.window with validated request fields.","request_model":"ViewTransformWindowRequest","result_model":"ViewTransformWindowResult","mutation_class":"reversible_pipeline","edits_target":true,"confirmation":"none","wait_policy":"always_wait","pagination_policy":"none","acceptance_evidence":"live_disposable_project","readback":{"command":"view.data.get","ids":{"view_id":"positional.0"},"kind":"data"},"live_test":"LT-VIEW-TRANSFORM-WINDOW","live_exemption_reason":null,"contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view transform window VIEW_ID --help","agent_example":"mammoth view transform window 123 --input '{\"function\": \"ROW_NUMBER\", \"dataset_id\": 456}'","unit_tests":["UT-VIEW-TRANSFORM-WINDOW"],"contract_tests":["CT-VIEW-TRANSFORM-WINDOW-HUMAN","CT-VIEW-TRANSFORM-WINDOW-JSON","CT-VIEW-TRANSFORM-WINDOW-ERROR"],"draft_test":"LT-VIEW-TRANSFORM-WINDOW-DRAFT","undo_test":"LT-VIEW-TRANSFORM-WINDOW-UNDO","known_restrictions":"Observe first: `view get VIEW_ID` for the column types, and `view data profile` for blanks in the partition and order columns. Exactly one of new_column or existing_column is required; both or neither is refused.","reviewed_by":"primary"},
 {"command_id":"view.trash","command_path":"view trash","disposition":"command","alias_of":null,"operation_ids":["TrashDataview"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."},{"name":"dataset_id","type":"int","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."}],"options":[],"sdk_symbol":"mammoth.api.dataviews.DataviewsAPI.trash","sdk_conversion":"Call mammoth.api.dataviews.DataviewsAPI.trash with validated request fields.","request_model":"ViewTrashRequest","result_model":"ViewTrashResult","mutation_class":"benign_mutation","edits_target":true,"confirmation":"none","wait_policy":"not_async","pagination_policy":"none","acceptance_evidence":"live_disposable_project","readback":{"command":"view.get","ids":{"view_id":"positional.0"},"kind":"object"},"live_test":"LT-VIEW-TRASH","live_exemption_reason":null,"contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view trash VIEW_ID --help","agent_example":"mammoth view trash 123 456","unit_tests":["UT-VIEW-TRASH"],"contract_tests":["CT-VIEW-TRASH-HUMAN","CT-VIEW-TRASH-JSON","CT-VIEW-TRASH-ERROR"],"draft_test":null,"undo_test":null,"known_restrictions":null,"reviewed_by":"primary"},
 {"command_id":"view.update","command_path":"view update","disposition":"command","alias_of":null,"operation_ids":["Patch"],"positionals":[{"name":"view_id","type":"int","required":true,"metavar":"VIEW_ID","falls_back_to_field":null,"help":"ID of the view to act on."},{"name":"dataset_id","type":"int","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."}],"options":[],"sdk_symbol":"mammoth.api.dataviews.DataviewsAPI.update","sdk_conversion":"Call mammoth.api.dataviews.DataviewsAPI.update with validated request fields.","request_model":"ViewUpdateRequest","result_model":"ViewUpdateResult","mutation_class":"benign_mutation","edits_target":true,"confirmation":"none","wait_policy":"not_async","pagination_policy":"none","acceptance_evidence":"live_disposable_project","readback":{"command":"view.get","ids":{"view_id":"positional.0"},"kind":"object"},"live_test":"LT-VIEW-UPDATE","live_exemption_reason":null,"contract_fixture":null,"required_fixture_guard":null,"secret_fields":[],"human_example":"mammoth view update VIEW_ID --help","agent_example":"mammoth view update 123 456 --input '{\"name\": \"Revenue report\"}'","unit_tests":["UT-VIEW-UPDATE"],"contract_tests":["CT-VIEW-UPDATE-HUMAN","CT-VIEW-UPDATE-JSON","CT-VIEW-UPDATE-ERROR"],"draft_test":null,"undo_test":null,"known_restrictions":"Only the typed rename is offered (--input {\"name\": ...}); any other patch is refused with B09 DATAVIEW_INPUT_UNTYPED because patch_data is an arbitrary dictionary.","reviewed_by":"primary"},