mammoth-cli 2.0.37__tar.gz → 2.0.38__tar.gz

{mammoth_cli-2.0.37 → mammoth_cli-2.0.38}/PKG-INFO

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

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

{mammoth_cli-2.0.37 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.0.37
+version: 2.0.38
 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."
 ---
 
@@ -76,17 +76,41 @@ mammoth view transform --help              # every data transformation
 | Blanks to a constant, or to the previous row's value | `view transform set-values` (`IS_EMPTY`), `view transform fill-missing` |
 | Clean text | `view transform text`, `replace`, `bulk-replace` |
 | Change a column's type | `view transform convert-type` |
+| Rename a column, sort the rows (view settings, not tasks) | `view transform rename-columns`, `view transform sort` |
 | Rank, running total, previous row | `view transform window` |
 | A dashboard | `dashboard create-blank` ([dashboards](references/recipes/dashboards.md)) |
 | Deliver the rows | `view export csv`, `view export postgres` (and other destinations), `view export dataset` |
 
 A search with no full match returns `suggestions` and a `hint`. Before you
 conclude the CLI cannot do something the web app does, check
-`view transform --help` and "Not a pipeline step" in
+`view transform --help` and "View settings, and what has no command" in
 [about Mammoth](references/about-mammoth.md). Do not switch to the web app
 in a browser, or compute the result locally, for work the CLI covers;
 report a real gap with the command you tried.
 
+## Several files, one deliverable
+
+Users often upload related files without saying how they relate ("make a
+dashboard from t_a and t_b"). Work it out from the data before you build:
+
+1. Read every view first: `view get VIEW_ID` (columns, types, row count) and
+   `view data get VIEW_ID --input '{"limit": 20}'`.
+2. Find the keys. A column in one view whose values appear in a column of
+   the other (`customer_id` and `id`, `order_ref` and `order_no`) is a
+   foreign key; the view with many rows per key is the main one.
+3. Make the keys match before the join: same type (`convert-type`), same
+   case and padding (`text`), no blanks (`set-values`, `filter`).
+4. Fix what the deliverable needs: numbers stored as text (`convert-type`
+   to `NUMERIC`), dates stored as text (`convert-type` to `DATE`), blanks.
+5. `view transform join` the lookup view into the main view (`LEFT`), then
+   read back and check the match rate
+   ([worked example](references/recipes/end-to-end.md), step 5).
+6. Build the dashboard from the joined view
+   ([dashboards](references/recipes/dashboards.md)).
+
+Say what you inferred (which columns you joined on, what you converted) in
+your report. If no column links the files, ask before you combine them.
+
 ## Calling a command
 
 - Ids are positionals; request fields are one `--input '{...}'` document;

{mammoth_cli-2.0.37 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/about-mammoth.md

@@ -100,6 +100,8 @@ Checkpoint Alert are the `view data-check` and `view checkpoint` families.
 | Shift a date by an interval | Add / Subtract Date Values | `increment-date` |
 | Add an empty column | Add Column | `add-column` |
 | Copy a column under a new name | Copy Columns | `copy-columns` |
+| Rename a column | Rename (column header) | `rename-columns` (a view setting, not a task) |
+| Sort the rows | Sort (grid) | `sort` (a view setting, not a task) |
 | Remove columns | Remove Column | `delete-columns` |
 | Add columns from another view by matching keys | Join | `join` (`INNER`, `LEFT`, `RIGHT`, `OUTER`) |
 | Bring one value per key from another view | Lookup | `lookup` |
@@ -117,15 +119,24 @@ value per key into one new column. Before either, confirm the key columns
 in both views have the same type and values; recipes/transforms.md has the
 read-back.
 
-## Not a pipeline step, and the nearest route
+## View settings, and what has no command
+
+Two commands change how the view shows its rows, not the rows. They add no
+pipeline task, like their web counterparts (a column-header rename, a grid
+sort):
+
+- **Rename a column:** `view transform rename-columns` with `{"renames":
+  {"cust_id": "Customer ID"}}`. The column keeps its internal name, so
+  earlier tasks keep working; later commands, data reads, exports and
+  dashboards use the new name. To name a column you create, use its
+  `new_column` or `as_name` field instead.
+- **Sort the rows:** `view transform sort` with `{"order_by": [["Revenue",
+  "DESC"]]}` (up to three columns; `[]` clears it). Data reads and exports
+  return rows in this order. To keep only the top N rows, use `limit-rows`
+  with `order_by`; for a rank column, `window` (`RANK`, `ROW_NUMBER`).
+
+No command:
 
-- **Rename a column.** The web app's rename is a display change, not a
-  task; the CLI has no rename command. Name new columns when you create them
-  (`new_column`, `as_name`); for an existing column, `copy-columns` under
-  the new name.
-- **Sort.** There is no sort task, and the CLI has no sort command. For
-  "top N by X" use `limit-rows` with `order_by`; for a rank column use
-  `window` (`RANK`, `ROW_NUMBER`).
 - **Union or append two views.** There is no union task. Upload a file into
   an existing dataset with `append_to_ds_id`, or send a view's rows into an
   existing dataset with `view export dataset` (`target_ds_id` and
@@ -139,6 +150,6 @@ Both call the same API. Do not switch to the web app in a browser for a
 task the CLI covers. Before you conclude that the CLI cannot do something,
 run `mammoth view transform --help`, search in plain words (`mammoth schema
 find "merge two datasets"` finds `join`; a search with no full match lists
-`suggestions`), and read the section above. If it is still missing, report
-the gap with the command you tried; do not work around it in the browser or
-by computing the result locally.
+`suggestions`), and read "View settings, and what has no command" above.
+If it is still missing, report the gap with the command you tried; do not
+work around it in the browser or by computing the result locally.

{mammoth_cli-2.0.37 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/capabilities.md

@@ -1,7 +1,7 @@
 # What is proven on release
 
 Generated from `docs/release-capability-matrix.json`; do not edit by hand.
-The CLI publishes 554 commands. 455 of them bind one of the 528 API operations in the matrix; the remainder are local commands (`schema`, `auth`, `doctor`, `log`, ...) or typed variants that share an operation (every `view transform *` command submits through `view.task.add`). 262 bound commands ran once successfully on release, 2 are not supported there, and the rest are untried. Untried is not broken: discover the contract with `mammoth schema get COMMAND_ID`, run it, and treat the structured error envelope as the answer.
+The CLI publishes 556 commands. 455 of them bind one of the 528 API operations in the matrix; the remainder are local commands (`schema`, `auth`, `doctor`, `log`, ...) or typed variants that share an operation (`view transform *` commands submit through `view.task.add`, except `rename-columns` and `sort`, which set view display properties through `view.update`). 262 bound commands ran once successfully on release, 2 are not supported there, and the rest are untried. Untried is not broken: discover the contract with `mammoth schema get COMMAND_ID`, run it, and treat the structured error envelope as the answer.
 
 Status meanings:
 

{mammoth_cli-2.0.37 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/command-index.md

@@ -1,6 +1,6 @@
 # Published CLI command catalog
 
-This generated catalog is a lookup table for every command in the published CLI manifest, currently 554; each entry carries its release status line. It is a command-contract index, not an assertion that every backend/OpenAPI operation has a CLI binding. For an exact local CLI contract, run `mammoth schema get COMMAND_ID`; `mammoth capability list` is an API-binding inventory and can omit typed/local CLI routes. For focused workflows, read the [recipes index](recipes/index.md). Sensitive structured input must come from a private file or pipe; never put secrets in literal argv.
+This generated catalog is a lookup table for every command in the published CLI manifest, currently 556; each entry carries its release status line. It is a command-contract index, not an assertion that every backend/OpenAPI operation has a CLI binding. For an exact local CLI contract, run `mammoth schema get COMMAND_ID`; `mammoth capability list` is an API-binding inventory and can omit typed/local CLI routes. For focused workflows, read the [recipes index](recipes/index.md). Sensitive structured input must come from a private file or pipe; never put secrets in literal argv.
 
 Load only the applicable domain file:
 
@@ -43,7 +43,7 @@ Load only the applicable domain file:
 - [upgrade](commands/upgrade.md) — 1 published commands
 - [user](commands/user.md) — 8 published commands
 - [version](commands/version.md) — 1 published commands
-- [view](commands/view.md) — 116 published commands
+- [view](commands/view.md) — 118 published commands
 - [webhook](commands/webhook.md) — 7 published commands
 - [workflow](commands/workflow.md) — 16 published commands
 - [workspace](commands/workspace.md) — 20 published commands

{mammoth_cli-2.0.37 → mammoth_cli-2.0.38}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/view.md

@@ -1034,6 +1034,16 @@ Result: `ViewTransformPivotResult`; mutation `reversible_pipeline`, confirmation
 
 Status on release: ran once on CLI 2.0.18 through `view.task.add` and was read back with `view data get`; other inputs for this transform are untried.
 
+### `view.transform.rename-columns`
+
+Run: `mammoth view transform rename-columns`. Exact input fields: `mammoth schema get view.transform.rename-columns`.
+
+Example: `mammoth view transform rename-columns 123 --input '{"renames": {"cust_id": "Customer ID"}, "dataset_id": 456}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `ViewTransformRenameColumnsResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; it submits through `view.task.add`, but this transform was not among those run.
+
 ### `view.transform.replace`
 
 Run: `mammoth view transform replace`. Exact input fields: `mammoth schema get view.transform.replace`.
@@ -1064,6 +1074,16 @@ Result: `ViewTransformSmallLargeResult`; mutation `reversible_pipeline`, confirm
 
 Status on release: untried; it submits through `view.task.add`, but this transform was not among those run.
 
+### `view.transform.sort`
+
+Run: `mammoth view transform sort`. Exact input fields: `mammoth schema get view.transform.sort`.
+
+Example: `mammoth view transform sort 123 --input '{"order_by": [["Revenue", "DESC"]], "dataset_id": 456}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `ViewTransformSortResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; it submits through `view.task.add`, but this transform was not among those run.
+
 ### `view.transform.split`
 
 Run: `mammoth view transform split`. Exact input fields: `mammoth schema get view.transform.split`.

{mammoth_cli-2.0.37 → mammoth_cli-2.0.38}/mammoth_cli/commands/registry.py

@@ -684,9 +684,11 @@ HANDLERS: dict[str, Handler] = {
     "view.transform.lookup": view_ops_cmd.view_transform_lookup,
     "view.transform.math": view_ops_cmd.view_transform_math,
     "view.transform.pivot": view_ops_cmd.view_transform_pivot,
+    "view.transform.rename-columns": view_ops_cmd.view_transform_rename_columns,
     "view.transform.replace": view_ops_cmd.view_transform_replace,
     "view.transform.set-values": view_ops_cmd.view_transform_set_values,
     "view.transform.small-large": view_ops_cmd.view_transform_small_large,
+    "view.transform.sort": view_ops_cmd.view_transform_sort,
     "view.transform.split": view_ops_cmd.view_transform_split,
     "view.transform.substring": view_ops_cmd.view_transform_substring,
     "view.transform.text": view_ops_cmd.view_transform_text,

{mammoth_cli-2.0.37 → mammoth_cli-2.0.38}/mammoth_cli/commands/schema.py

@@ -89,11 +89,11 @@ _COMMAND_DISCOVERY_PURPOSES = {
     "view.transform.convert-type": (
         "convert type cast numeric number text date column parse to number to date"
     ),
-    "view.transform.copy-columns": "copy duplicate rename column into a new column name",
+    "view.transform.copy-columns": "copy duplicate column into a new column",
     "view.transform.crosstab": (
         "crosstab cross tab pivot table matrix rows by columns summary into a new dataset"
     ),
-    "view.transform.date-diff": "date difference days between two date columns age duration",
+    "view.transform.date-diff": "date dates difference days between two date columns age duration",
     "view.transform.delete-columns": "delete drop remove columns",
     "view.transform.discard-duplicates": (
         "duplicate duplicates dedup dedupe deduplicate remove repeated rows unique distinct"
@@ -117,7 +117,7 @@ _COMMAND_DISCOVERY_PURPOSES = {
         "second view views dataset datasets table tables vlookup"
     ),
     "view.transform.json-extract": "json extract parse nested fields keys into columns",
-    "view.transform.limit-rows": "limit top bottom first last n rows order by sorted head",
+    "view.transform.limit-rows": "limit top bottom first last n rows head",
     "view.transform.lookup": (
         "lookup look up vlookup reference table map code to name enrich one value "
         "from another view dataset"
@@ -130,12 +130,19 @@ _COMMAND_DISCOVERY_PURPOSES = {
         "pivot group by aggregate aggregation sum count average summary summarize "
         "summarise per region total"
     ),
+    "view.transform.rename-columns": (
+        "rename column columns header headers relabel change column name names title"
+    ),
     "view.transform.replace": "find replace substitute text value in columns",
     "view.transform.set-values": (
         "set values assign overwrite blank empty default where condition label "
         "category bucket flag if then conditional value"
     ),
     "view.transform.small-large": "nth smallest largest value across columns",
+    "view.transform.sort": (
+        "sort sorting order rows by column ascending descending asc desc arrange "
+        "highest lowest newest oldest latest earliest date dates alphabetical"
+    ),
     "view.transform.split": "split column by delimiter separator into columns",
     "view.transform.substring": "substring left right characters regex pattern extract part text",
     "view.transform.text": (
@@ -404,7 +411,12 @@ def _tokens(value: str) -> frozenset[str]:
 
 
 def _query_tokens(query: str) -> tuple[str, ...]:
-    return tuple(token for token in _tokens(query) if token not in _DISCOVERY_STOPWORDS)
+    # Bare numbers ("top 10") are values, not intent words.
+    return tuple(
+        token
+        for token in _tokens(query)
+        if token not in _DISCOVERY_STOPWORDS and not token.isdigit()
+    )
 
 
 def _token_aliases(token: str) -> frozenset[str]:

{mammoth_cli-2.0.37 → mammoth_cli-2.0.38}/mammoth_cli/commands/view.py

@@ -252,10 +252,33 @@ BRIEF_VIEW_FIELDS: tuple[str, ...] = (
 )
 
 
+def apply_column_renames(record: Any) -> Any:
+    """Show renamed columns under their new names in a dataview record.
+
+    A rename (``view transform rename-columns`` or the web grid) is stored in
+    ``display_properties.COLUMN_NAMES`` as ``{internal_name: name}``; the
+    server's ``metadata`` keeps the name the pipeline produced. Every CLI
+    output uses the name the user sees, so the rename wins.
+    """
+    if not isinstance(record, dict):
+        return record
+    display = record.get("display_properties")
+    renames = display.get("COLUMN_NAMES") if isinstance(display, dict) else None
+    metadata = record.get(_METADATA_KEY)
+    if not isinstance(renames, dict) or not renames or not isinstance(metadata, list):
+        return record
+    columns = []
+    for column in metadata:
+        new_name = renames.get(column.get(_INTERNAL_NAME_KEY)) if isinstance(column, dict) else None
+        columns.append({**column, _DISPLAY_NAME_KEY: new_name} if new_name else column)
+    return {**record, _METADATA_KEY: columns}
+
+
 def brief_view_record(record: Any) -> Any:
-    """Keep only :data:`BRIEF_VIEW_FIELDS` of a dataview record."""
+    """Keep only :data:`BRIEF_VIEW_FIELDS` of a dataview record, renames applied."""
     if not isinstance(record, dict):
         return record
+    record = apply_column_renames(record)
     return {key: record[key] for key in BRIEF_VIEW_FIELDS if key in record}
 
 
@@ -369,6 +392,7 @@ def _dataview_metadata(
         )
     except Exception:  # noqa: BLE001 -- labels are a presentation nicety, never fatal
         return []
+    info = apply_column_renames(info)
     metadata = info.get(_METADATA_KEY) if isinstance(info, dict) else None
     if not isinstance(metadata, list):
         return []

{mammoth_cli-2.0.37 → mammoth_cli-2.0.38}/mammoth_cli/commands/view_ops.py

@@ -24,6 +24,7 @@ from typing import Any
 from mammoth_cli.commands.view import (
     BRIEF_VIEW_FIELDS,
     _require_discovery_allowed,
+    apply_column_renames,
     brief_view_record,
 )
 from mammoth_cli.context import profiles
@@ -478,20 +479,28 @@ def view_get(invocation: Invocation) -> HandlerResult:
         kwargs: dict[str, Any] = {
             "dataset_id": dataset_id,
             "dataview_id": view_id,
-            # Server-side projection; the brief set unless the caller asks.
+            # Server-side projection; the brief set (plus the display
+            # properties that carry column renames) unless the caller asks.
             "fields": document.get("fields")
-            or ",".join(key for key in BRIEF_VIEW_FIELDS if key != "dataset_id"),
+            or ",".join(
+                [key for key in BRIEF_VIEW_FIELDS if key != "dataset_id"] + ["display_properties"]
+            ),
         }
         with open_service(invocation) as (service, auth):
             data = service.call("mammoth.api.dataviews.DataviewsAPI.get", **kwargs)
             parents.remember(_profile_name(invocation), auth.workspace_id, {view_id: dataset_id})
+        data = apply_column_renames(data) if document.get("fields") else brief_view_record(data)
         return data, _meta(invocation, auth.workspace_id)
     context: dict[str, Any] = {"view_id": view_id}
     if dataset_id is not None:
         context["dataset_id"] = dataset_id
     # The generated contract predates the optional parent context; preserve
     # its declared fields, then add the validated SDK parent explicitly.
-    binding_document = {key: value for key, value in document.items() if key != "dataset_id"}
+    # ``fields`` projects the exact-parent route only; the discovery route
+    # returns the full record, trimmed below unless ``fields`` was asked for.
+    binding_document = {
+        key: value for key, value in document.items() if key not in ("dataset_id", "fields")
+    }
     kwargs = bind_command_inputs(invocation.command_id, binding_document, view_id=view_id)
     if dataset_id is not None:
         kwargs["dataset_id"] = dataset_id
@@ -503,6 +512,8 @@ def view_get(invocation: Invocation) -> HandlerResult:
         # The discovery path returns the standard record; trim it to the same
         # brief shape the exact path asks the server for.
         payload = brief_view_record(payload)
+    else:
+        payload = apply_column_renames(payload)
     return payload, _meta(invocation, auth.workspace_id)
 
 
@@ -794,6 +805,26 @@ def view_transform_limit_rows(invocation: Invocation) -> HandlerResult:
     return _dispatch_view(invocation, view_id, "limit_rows", **kwargs)
 
 
+def view_transform_rename_columns(invocation: Invocation) -> HandlerResult:
+    """Rename columns (a view display setting, not a task). ``renames`` is required."""
+    view_id = _view_id(invocation)
+    document = invocation.load_input()
+    _require_field(document, "renames")
+    assert document is not None
+    kwargs = _bind_transform_inputs(invocation, document)
+    return _dispatch_view(invocation, view_id, "rename_columns", **kwargs)
+
+
+def view_transform_sort(invocation: Invocation) -> HandlerResult:
+    """Set the view's row order (a display setting, not a task). ``order_by`` is required."""
+    view_id = _view_id(invocation)
+    document = invocation.load_input()
+    _require_field(document, "order_by")
+    assert document is not None
+    kwargs = _bind_transform_inputs(invocation, document)
+    return _dispatch_view(invocation, view_id, "sort_rows", **kwargs)
+
+
 def view_transform_lookup(invocation: Invocation) -> HandlerResult:
     """Look up values from another view. ``source``/``lookup_view_id``/``key``/
     ``value`` required."""

{mammoth_cli-2.0.37 → mammoth_cli-2.0.38}/mammoth_cli/services/input_fields.py

@@ -48,6 +48,9 @@ _EXAMPLE_INPUT_HINTS: dict[str, dict[str, Any]] = {
         "existing_column": "Status",
         "condition": {"column": "Status", "operator": "IS_EMPTY"},
     },
+    # View display settings: real column names read better than sample keys.
+    "view.transform.rename-columns": {"renames": {"cust_id": "Customer ID"}},
+    "view.transform.sort": {"order_by": [["Revenue", "DESC"]]},
     # The backend requires integer resource ids ("resource_ids must be
     # comma-separated integers"); the SDK annotation is a plain list[str].
     "project.resource-dependencies": {"resource_ids": [456]},

{mammoth_cli-2.0.37 → mammoth_cli-2.0.38}/pyproject.toml

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

{mammoth_cli-2.0.37 → mammoth_cli-2.0.38}/spec/manifests/commands/view.yaml

@@ -4543,6 +4543,47 @@ commands:
     must be a display name that does not already exist on the view (4DTVW018 SAME_DISPLAY_NAME_CANNOT_BE_REUSED):
     aggregate a joined column under a new name.'
   reviewed_by: primary
+- command_id: view.transform.rename-columns
+  command_path: view transform rename-columns
+  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.
+  options: []
+  sdk_symbol: mammoth._mixins._column_ops.ColumnOpsMixin.rename_columns
+  sdk_conversion: Call mammoth._mixins._column_ops.ColumnOpsMixin.rename_columns with validated request
+    fields.
+  request_model: ViewTransformRenameColumnsRequest
+  result_model: ViewTransformRenameColumnsResult
+  mutation_class: benign_mutation
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_disposable_project
+  live_test: LT-VIEW-TRANSFORM-RENAME-COLUMNS
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth view transform rename-columns VIEW_ID --help
+  agent_example: 'mammoth view transform rename-columns 123 --input ''{"renames": {"cust_id": "Customer ID"}, "dataset_id": 456}'''
+  unit_tests:
+  - UT-VIEW-TRANSFORM-RENAME-COLUMNS
+  contract_tests:
+  - CT-VIEW-TRANSFORM-RENAME-COLUMNS-HUMAN
+  - CT-VIEW-TRANSFORM-RENAME-COLUMNS-JSON
+  - CT-VIEW-TRANSFORM-RENAME-COLUMNS-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: 'A view display setting (the web grid''s column rename), not a pipeline task: it changes no data and adds no task.'
+  reviewed_by: primary
 - command_id: view.transform.replace
   command_path: view transform replace
   disposition: command
@@ -4666,6 +4707,47 @@ commands:
   undo_test: LT-VIEW-TRANSFORM-SMALL-LARGE-UNDO
   known_restrictions: null
   reviewed_by: primary
+- command_id: view.transform.sort
+  command_path: view transform sort
+  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.
+  options: []
+  sdk_symbol: mammoth._mixins._row_ops.RowOpsMixin.sort_rows
+  sdk_conversion: Call mammoth._mixins._row_ops.RowOpsMixin.sort_rows with validated request
+    fields.
+  request_model: ViewTransformSortRequest
+  result_model: ViewTransformSortResult
+  mutation_class: benign_mutation
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_disposable_project
+  live_test: LT-VIEW-TRANSFORM-SORT
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth view transform sort VIEW_ID --help
+  agent_example: 'mammoth view transform sort 123 --input ''{"order_by": [["Revenue", "DESC"]], "dataset_id": 456}'''
+  unit_tests:
+  - UT-VIEW-TRANSFORM-SORT
+  contract_tests:
+  - CT-VIEW-TRANSFORM-SORT-HUMAN
+  - CT-VIEW-TRANSFORM-SORT-JSON
+  - CT-VIEW-TRANSFORM-SORT-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: 'A view display setting (the web grid''s sort), not a pipeline task: data reads and exports return rows in this order. At most three columns.'
+  reviewed_by: primary
 - command_id: view.transform.split
   command_path: view transform split
   disposition: command

{mammoth_cli-2.0.37 → mammoth_cli-2.0.38}/spec/manifests/sdk-catalog.source.yaml

@@ -106,6 +106,13 @@ sdk_methods:
   pagination_policy: null
   openapi_operation_ids: []
   notes: Standard transformation policy; task deletion restores columns only when the task ID is stable.
+- sdk_symbol: mammoth._mixins._column_ops.ColumnOpsMixin.rename_columns
+  canonical_command: view.transform.rename-columns
+  alias_of: null
+  mutation_class: benign_mutation
+  wait_policy: not_async
+  pagination_policy: null
+  openapi_operation_ids: []
 - sdk_symbol: mammoth._mixins._date_ops.DateOpsMixin.date_diff
   canonical_command: view.transform.date-diff
   alias_of: null
@@ -193,6 +200,13 @@ sdk_methods:
   wait_policy: always_wait
   pagination_policy: null
   openapi_operation_ids: []
+- sdk_symbol: mammoth._mixins._row_ops.RowOpsMixin.sort_rows
+  canonical_command: view.transform.sort
+  alias_of: null
+  mutation_class: benign_mutation
+  wait_policy: not_async
+  pagination_policy: null
+  openapi_operation_ids: []
 - sdk_symbol: mammoth._mixins._row_ops.RowOpsMixin.unnest
   canonical_command: view.transform.unnest
   alias_of: null

{mammoth_cli-2.0.37 → mammoth_cli-2.0.38}/spec/manifests/sdk-methods.yaml

@@ -170,6 +170,18 @@ methods:
   pagination_policy: null
   secret_fields: []
   reviewed_by: primary
+- sdk_symbol: mammoth._mixins._column_ops.ColumnOpsMixin.rename_columns
+  implementation_origin: mammoth._mixins._column_ops.ColumnOpsMixin.rename_columns
+  signature: 'rename_columns(self, renames: ''dict[str, str]'') -> ''dict[str, Any]'''
+  openapi_operation_ids: []
+  canonical_command: view.transform.rename-columns
+  alias_of: null
+  no_command_reason: null
+  mutation_class: benign_mutation
+  wait_policy: not_async
+  pagination_policy: null
+  secret_fields: []
+  reviewed_by: primary
 - sdk_symbol: mammoth._mixins._date_ops.DateOpsMixin.date_diff
   implementation_origin: mammoth._mixins._date_ops.DateOpsMixin.date_diff
   signature: 'date_diff(self, component: ''DateDiffUnit'', start: ''str'', end: ''str'', new_column: ''str | None'' = None, existing_column: ''str | None'' = None) -> ''dict[str, Any]'''
@@ -314,6 +326,18 @@ methods:
   pagination_policy: null
   secret_fields: []
   reviewed_by: primary
+- sdk_symbol: mammoth._mixins._row_ops.RowOpsMixin.sort_rows
+  implementation_origin: mammoth._mixins._row_ops.RowOpsMixin.sort_rows
+  signature: 'sort_rows(self, order_by: ''list[list[str | SortDirection]]'') -> ''dict[str, Any]'''
+  openapi_operation_ids: []
+  canonical_command: view.transform.sort
+  alias_of: null
+  no_command_reason: null
+  mutation_class: benign_mutation
+  wait_policy: not_async
+  pagination_policy: null
+  secret_fields: []
+  reviewed_by: primary
 - sdk_symbol: mammoth._mixins._row_ops.RowOpsMixin.unnest
   implementation_origin: mammoth._mixins._row_ops.RowOpsMixin.unnest
   signature: 'unnest(self, columns: ''list[str]'', label_column: ''str'' = ''Label'', value_column: ''str'' = ''Value'', value_type: ''str | None'' = None) -> ''dict[str, Any]'''