mammoth-cli 2.3.0__tar.gz → 2.4.0__tar.gz

{mammoth_cli-2.3.0 → mammoth_cli-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.3.0
+Version: 2.4.0
 Summary: Command-line interface for the Mammoth Analytics platform
 Project-URL: homepage, https://mammoth.io
 Project-URL: repository, https://github.com/EdgeMetric/mammothsdk
@@ -17,9 +17,10 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: <3.15,>=3.12
 Requires-Dist: certifi>=2026.10.19
+Requires-Dist: click<9,>=8.1
 Requires-Dist: jsonschema>=4.20
 Requires-Dist: keyring<26,>=25.7
-Requires-Dist: mammoth-io<0.9,>=0.8.52
+Requires-Dist: mammoth-io<0.9,>=0.8.53
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.12.5
 Requires-Dist: pyyaml<7,>=6

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

{mammoth_cli-2.3.0 → mammoth_cli-2.4.0}/mammoth_cli/app/__init__.py

@@ -55,7 +55,7 @@ from mammoth_cli.app.usage import (
     missing_argument_hint,
 )
 from mammoth_cli.commands import BESPOKE
-from mammoth_cli.errors.envelope import EXIT_USAGE, CliError
+from mammoth_cli.errors.envelope import EXIT_INTERRUPT, EXIT_USAGE, CliError, cancelled_error
 from mammoth_cli.manifest.loader import command_by_id
 from mammoth_cli.output.policy import (
     MACHINE_OUTPUTS,
@@ -178,12 +178,16 @@ class _EnvelopeGroup(TyperGroup):
         try:
             result = super().main(*args, **kwargs)
         except _USAGE_ERRORS as error:
-            argv = kwargs.get("args")
-            if argv is None:
-                argv = args[0] if args else None
+            argv = _argv_of(args, kwargs)
             self.render_usage_error(error, argv)
             raise SystemExit(getattr(error, "exit_code", EXIT_USAGE)) from None
         except _ABORT_ERRORS:
+            mode = _output_mode_from_argv(_argv_of(args, kwargs))
+            if mode in MACHINE_OUTPUTS or mode == "yaml":
+                from mammoth_cli.output.emit import emit_error
+
+                emit_error(cancelled_error(), machine=True, output=mode)
+                raise SystemExit(EXIT_INTERRUPT) from None
             typer.echo("Aborted!", err=True)
             raise SystemExit(1) from None
         # Under standalone_mode=False a normal return is either None (success) or
@@ -223,7 +227,8 @@ class _EnvelopeGroup(TyperGroup):
         if is_missing_parameter and (option := _unknown_flag_in(error, tokens)):
             # A misspelt flag is the first thing to fix, ahead of a missing argument.
             report = _unknown_option_report(error, option)
-        if _output_mode_from_argv(argv) in MACHINE_OUTPUTS:
+        mode = _output_mode_from_argv(argv)
+        if mode in MACHINE_OUTPUTS or mode == "yaml":
             if report is None:
                 missing = is_missing_parameter
                 if missing:
@@ -260,7 +265,7 @@ class _EnvelopeGroup(TyperGroup):
                     )
             from mammoth_cli.output.emit import emit_error
 
-            emit_error(report, machine=True)
+            emit_error(report, machine=True, output=mode)
         elif report is None:
             error.show()
             if is_missing_parameter:
@@ -280,6 +285,22 @@ class _EnvelopeGroup(TyperGroup):
                 typer.echo(f"  try: {command}", err=True)
 
 
+def _argv_of(args: tuple[Any, ...], kwargs: dict[str, Any]) -> Sequence[str] | None:
+    """The argv a ``main`` call was given: the ``args`` keyword, else the first positional.
+
+    Args:
+        args: The positional arguments of the ``main`` call.
+        kwargs: The keyword arguments of the ``main`` call.
+
+    Returns:
+        The argv tokens, or None when the call used ``sys.argv``.
+    """
+    argv = kwargs.get("args")
+    if argv is None:
+        argv = args[0] if args else None
+    return argv
+
+
 def _build_leaf(command_id: str, *, is_group_callback: bool = False) -> Callable[..., None]:
     """Return a Typer callback bound to one manifest command id.
 

{mammoth_cli-2.3.0 → mammoth_cli-2.4.0}/mammoth_cli/app/help_text.py

@@ -69,7 +69,7 @@ _GROUP_DESCRIPTIONS = {
     "skill": "Install and manage the Mammoth agent skill.",
     "snippet": "Manage reusable snippets.",
     "support": "Manage support and administration resources.",
-    "template": "Manage templates.",
+    "template": "Manage legacy workspace templates (the project catalog is 'workflow template').",
     "trash": "Inspect, restore, and remove trashed resources.",
     "user": "Manage users and account settings.",
     "view": "Transform, query, and publish data views.",
@@ -119,8 +119,11 @@ _SUBGROUP_DESCRIPTIONS = {
     "collection members": "Remove members from a collection.",
     "automation route": "Preview and set which automation a watched folder's file goes to.",
     "automation run-file": "Act on a file an automation run held back.",
-    "connector ai": "Chat with the connector assistant to set up a connection.",
-    "connector ai session": "List connector assistant sessions and their messages.",
+    "connector ai": (
+        "The older connector chat for one connection; it cannot save an AI connector. "
+        "To build one, use 'connector draft create'."
+    ),
+    "connector ai session": "List older connector chat sessions and their messages.",
     "connector connection": "Create, read, update and delete connector connections.",
     "connector draft": "Build a connector step by step: sources, gaps, sample, then save.",
     "connector draft source": "List a draft's sources, preview them and find join keys.",
@@ -182,7 +185,11 @@ _SUBGROUP_DESCRIPTIONS = {
     "dashboard video": "Export a dashboard as a video.",
     "dataset broken-rows": "List and resolve rows that failed to load.",
     "dataset definition": "List, save and remove what terms mean for a dataset.",
+    "dataset from-url": "Preview a link, follow or copy a dataset made from a link, and show them.",
     "dataset file-settings": "Read, update and undo a dataset's file settings.",
+    "dataset update-method": (
+        "Read or set whether a new file replaces a dataset's rows or adds to them."
+    ),
     "dataset interpretation": "Preview and confirm how a file is interpreted.",
     "dataset tool-claim": "Read an emailed Open tables link and add its tables to a project.",
     "parameter group": "Create, list, update, reorder and delete parameter groups.",
@@ -196,6 +203,9 @@ _SUBGROUP_DESCRIPTIONS = {
     "support connector": "Create, list, update and delete connectors.",
     "support connector-profile": "Manage connector profiles and their connectors.",
     "support deal": "Create, read and update deals, and move them to partners.",
+    "support project-move": (
+        "Follow a project move between workspaces, and purge its source copies."
+    ),
     "support entitlement": "Read the entitlement registry.",
     "support feature": "Create, list, update and delete features.",
     "support feature-profile": "Manage feature profiles and their features.",
@@ -211,6 +221,9 @@ _SUBGROUP_DESCRIPTIONS = {
     "support user": "List, register and update users.",
     "support workspace": "Manage workspaces: create, suspend, restore and delete.",
     "support workspace invite": "Cancel or resend a workspace invite.",
+    "support workspace project": (
+        "List a workspace's projects, check and start moving one to another workspace."
+    ),
     "support workspace user": "Add, list, remove and transfer workspace users.",
     "user avatar": "Upload or delete the avatar.",
     "user preference": "Read and update user preferences.",
@@ -233,6 +246,9 @@ _SUBGROUP_DESCRIPTIONS = {
     "view variants": "Create view variants.",
     "view version": "List, read, apply and delete view versions.",
     "workflow block": "Add and configure workflow blocks.",
+    "workflow template": (
+        "Browse the workflow template catalog, match it to your tables, preview and build it."
+    ),
     "workspace export-hosts": "Read and set the hosts exports may send data to.",
     "workspace invite": "List, resend, revoke and delete workspace invites.",
     "workspace oauth-client": "Register, list, delete and revoke OAuth client grants.",

{mammoth_cli-2.3.0 → mammoth_cli-2.4.0}/mammoth_cli/app/usage.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import os
 import re
 import sys
 from collections.abc import Sequence
@@ -81,6 +82,11 @@ def _output_mode_from_argv(argv: Sequence[str] | None) -> str:
             mode = token[2:]
         index += 1
     mode = canonical_output(mode)
+    if mode == OUTPUT_AUTO:
+        # ``MAMMOTH_OUTPUT`` is the session default an agent exports once; honour it here too.
+        requested = canonical_output(os.environ.get("MAMMOTH_OUTPUT", "").strip().lower())
+        if requested in SELECTABLE_OUTPUTS:
+            mode = requested
     if mode not in SELECTABLE_OUTPUTS:
         # A value the command would reject (``--output xml``) must not turn the
         # error into prose: judge it by where stdout goes, like the default.

{mammoth_cli-2.3.0 → mammoth_cli-2.4.0}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.3.0
+version: 2.4.0
 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.3.0 → mammoth_cli-2.4.0}/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 851 commands. 700 of them bind one of the 769 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`). 261 bound commands ran once successfully on release, 1 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. Use an untried command normally: confirm a write with the user first, check its result with a read afterwards, and never refuse a command only because it is untried.
+The CLI publishes 872 commands. 705 of them bind one of the 769 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`). 261 bound commands ran once successfully on release, 1 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. Use an untried command normally: confirm a write with the user first, check its result with a read afterwards, and never refuse a command only because it is untried.
 
 Status meanings:
 
@@ -18,7 +18,7 @@ The typed `view transform *` commands all submit through `view.task.add` (`renam
 | Family | Commands | Ran once | Not supported | Untried |
 |---|---|---|---|---|
 | `dashboard` | 166 | 81 | 1 | 84 |
-| `support` | 112 | 9 | 0 | 103 |
+| `support` | 117 | 9 | 0 | 108 |
 | `view` | 71 | 58 | 0 | 13 |
 | `agent` | 41 | 1 | 0 | 40 |
 | `connector` | 39 | 3 | 0 | 36 |

{mammoth_cli-2.3.0 → mammoth_cli-2.4.0}/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 851; 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 872; 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:
 
@@ -29,7 +29,7 @@ Load only the applicable domain file:
 - [dashboard-style](commands/dashboard-style.md) — 10 published commands
 - [dashboard-embed](commands/dashboard-embed.md) — 9 published commands
 - [dashboard](commands/dashboard.md) — 112 published commands
-- [dataset](commands/dataset.md) — 30 published commands
+- [dataset](commands/dataset.md) — 37 published commands
 - [doctor](commands/doctor.md) — 1 published commands
 - [external-key](commands/external-key.md) — 4 published commands
 - [file](commands/file.md) — 11 published commands
@@ -50,15 +50,15 @@ Load only the applicable domain file:
 - [schema](commands/schema.md) — 3 published commands
 - [skill](commands/skill.md) — 7 published commands
 - [snippet](commands/snippet.md) — 8 published commands
-- [support](commands/support.md) — 112 published commands
+- [support](commands/support.md) — 117 published commands
 - [template](commands/template.md) — 5 published commands
 - [token](commands/token.md) — 3 published commands
 - [trash](commands/trash.md) — 3 published commands
 - [upgrade](commands/upgrade.md) — 1 published commands
 - [user](commands/user.md) — 7 published commands
 - [version](commands/version.md) — 1 published commands
-- [view-transform](commands/view-transform.md) — 35 published commands
+- [view-transform](commands/view-transform.md) — 36 published commands
 - [view](commands/view.md) — 110 published commands
 - [webhook](commands/webhook.md) — 7 published commands
-- [workflow](commands/workflow.md) — 23 published commands
+- [workflow](commands/workflow.md) — 31 published commands
 - [workspace](commands/workspace.md) — 33 published commands

{mammoth_cli-2.3.0 → mammoth_cli-2.4.0}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/ai.md

@@ -36,7 +36,7 @@ Status on release: observed blocker — permission: POST /workspaces/4/projects/
 
 Run: `mammoth ai sql generate`. Exact input fields: `mammoth schema get ai.sql.generate`.
 
-Example: `mammoth ai sql generate 'Summarize revenue by region' --input '{"dataset_id": 456}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+Example: `mammoth ai sql generate 'Summarize revenue by region' --input '{"dataset_id": 456, "dataview_id": 123}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
 
 Result: `AiSqlGenerateResult`; mutation `read`, confirmation `none`, wait policy `always_wait`.
 

{mammoth_cli-2.3.0 → mammoth_cli-2.4.0}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/dataset.md

@@ -132,6 +132,26 @@ Result: `DatasetDeleteResult`; mutation `destructive`, confirmation `prompt_or_y
 
 Status on release: ran once on CLI 2.0.18 — fixture-lifecycle sweep 2026-09-19: exit 0 on release with CLI 2.0.18. Deleted dataset 85 (main fixture.csv/view 106) after get-back confirmed id/name. Single invocation only.
 
+### `dataset.download`
+
+Run: `mammoth dataset download`. Exact input fields: `mammoth schema get dataset.download`.
+
+Example: `mammoth dataset download --input '{"resource_ids": [12, 13], "name": "sales", "file_type": "csv"}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DatasetDownloadResult`; mutation `benign_mutation`, confirmation `none`, wait policy `always_wait`.
+
+Status on release: untried; no live run recorded.
+
+### `dataset.download-plan`
+
+Run: `mammoth dataset download-plan`. Exact input fields: `mammoth schema get dataset.download-plan`.
+
+Example: `mammoth dataset download-plan --input '{"resource_ids": [12, 13]}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DatasetDownloadPlanResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `dataset.file-settings.get`
 
 Run: `mammoth dataset file-settings get`. Exact input fields: `mammoth schema get dataset.file-settings.get`.
@@ -156,7 +176,7 @@ Status on release: ran once on CLI 2.0.15 — re-verification 2026-09-18: exit 0
 
 Run: `mammoth dataset file-settings update`. Exact input fields: `mammoth schema get dataset.file-settings.update`.
 
-Example: `mammoth dataset file-settings update 123 --input '{"delimiter": ",", "has_header": true, "initial_skip_count": 0, "quotechar": "\""}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+Example: `mammoth dataset file-settings update 123 --input '{"initial_skip_count": 2}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
 
 Result: `DatasetFileSettingsUpdateResult`; mutation `benign_mutation`, confirmation `none`, wait policy `always_wait`.
 
@@ -172,6 +192,36 @@ Result: `DatasetFindResult`; mutation `read`, confirmation `none`, wait policy `
 
 Status on release: untried; no live run recorded.
 
+### `dataset.from-url.follow`
+
+Run: `mammoth dataset from-url follow`. Exact input fields: `mammoth schema get dataset.from-url.follow`.
+
+Example: `mammoth dataset from-url follow 123 --input '{"follow": false}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DatasetFromUrlFollowResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `dataset.from-url.links`
+
+Run: `mammoth dataset from-url links`. Exact input fields: `mammoth schema get dataset.from-url.links`.
+
+Example: `mammoth dataset from-url links`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DatasetFromUrlLinksResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `dataset.from-url.preview`
+
+Run: `mammoth dataset from-url preview`. Exact input fields: `mammoth schema get dataset.from-url.preview`.
+
+Example: `mammoth dataset from-url preview https://example.com/data.csv`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DatasetFromUrlPreviewResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `dataset.get`
 
 Run: `mammoth dataset get`. Exact input fields: `mammoth schema get dataset.get`.
@@ -301,3 +351,23 @@ Example: `mammoth dataset update --input '{"patch_data": [{"name": "Status"}]}'
 Execution is unavailable for the current contract and returns `unsupported_contract`. Do not infer request fields or retry it; use only a separately typed alternative.
 
 Known restriction: BLOCKED[B07 DATASET_PATCH_UNTYPED]: raw patch operations include rename/refresh/column changes/reattach/deletion; do not dispatch them. Use dataset.rename or dataset.file-settings.update for their typed variants. The pinned SDK has no public binding for the singular UpdateDataset route, so its other OpenAPI patch variants remain unavailable until a typed SDK contract exists.
+
+### `dataset.update-method.get`
+
+Run: `mammoth dataset update-method get`. Exact input fields: `mammoth schema get dataset.update-method.get`.
+
+Example: `mammoth dataset update-method get 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DatasetUpdateMethodGetResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `dataset.update-method.set`
+
+Run: `mammoth dataset update-method set`. Exact input fields: `mammoth schema get dataset.update-method.set`.
+
+Example: `mammoth dataset update-method set 123 --input '{"mode": "replace"}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DatasetUpdateMethodSetResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.

{mammoth_cli-2.3.0 → mammoth_cli-2.4.0}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/support.md

@@ -672,6 +672,26 @@ Result: `SupportPlanUpdateStorageTiersResult`; mutation `high_impact`, confirmat
 
 Status on release: untried; no live run recorded.
 
+### `support.project-move.get`
+
+Run: `mammoth support project-move get`. Exact input fields: `mammoth schema get support.project-move.get`.
+
+Example: `mammoth support project-move get 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `SupportProjectMoveGetResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.project-move.purge`
+
+Run: `mammoth support project-move purge`. Exact input fields: `mammoth schema get support.project-move.purge`.
+
+Example: `mammoth support project-move purge 123 --yes --confirm 123`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+
+Result: `SupportProjectMovePurgeResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `support.search`
 
 Run: `mammoth support search`. Exact input fields: `mammoth schema get support.search`.
@@ -1042,6 +1062,36 @@ Result: `SupportWorkspaceListResult`; mutation `read`, confirmation `none`, wait
 
 Status on release: ran once on CLI 2.0.15 — admin read sweep 2026-09-18: exit 0 on release with CLI 2.0.15. The CLI gates this GET behind --yes --confirm WORKSPACE_ID (confirm_target policy); with confirmation: exit 0; route returns a bare array so the SDK wraps it as {status_code:200, response:[...]}…
 
+### `support.workspace.project.list`
+
+Run: `mammoth support workspace project list`. Exact input fields: `mammoth schema get support.workspace.project.list`.
+
+Example: `mammoth support workspace project list 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `SupportWorkspaceProjectListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.workspace.project.move-check`
+
+Run: `mammoth support workspace project move-check`. Exact input fields: `mammoth schema get support.workspace.project.move-check`.
+
+Example: `mammoth support workspace project move-check 123 456 --input '{"target_workspace_id": 1}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `SupportWorkspaceProjectMoveCheckResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.workspace.project.move-start`
+
+Run: `mammoth support workspace project move-start`. Exact input fields: `mammoth schema get support.workspace.project.move-start`.
+
+Example: `mammoth support workspace project move-start 123 456 --input '{"target_workspace_id": 1}' --yes --confirm 123`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+
+Result: `SupportWorkspaceProjectMoveStartResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `support.workspace.restore-access`
 
 Run: `mammoth support workspace restore-access`. Exact input fields: `mammoth schema get support.workspace.restore-access`.

{mammoth_cli-2.3.0 → mammoth_cli-2.4.0}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/view-transform.md

@@ -252,6 +252,16 @@ Result: `ViewTransformRenameColumnsResult`; mutation `benign_mutation`, confirma
 
 Status on release: ran once on CLI 2.0.40 through `view.task.add` and was read back with `view data get`; other inputs for this transform are untried.
 
+### `view.transform.repeat-rows`
+
+Run: `mammoth view transform repeat-rows`. Exact input fields: `mammoth schema get view.transform.repeat-rows`.
+
+Example: `mammoth view transform repeat-rows 123 --input '{"dataset_id": 456}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `ViewTransformRepeatRowsResult`; mutation `reversible_pipeline`, confirmation `none`, wait policy `always_wait`.
+
+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`.

{mammoth_cli-2.3.0 → mammoth_cli-2.4.0}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/workflow.md

@@ -192,6 +192,86 @@ Result: `WorkflowSaveUndoResult`; mutation `destructive`, confirmation `prompt_o
 
 Status on release: untried; no live run recorded.
 
+### `workflow.template.build`
+
+Run: `mammoth workflow template build`. Exact input fields: `mammoth schema get workflow.template.build`.
+
+Example: `mammoth workflow template build bank-reconciliation --input '{"inputs": {"main": 101}, "matches": {"main": {"amount": {"column": "Amount"}}}, "destination_name": "Bank reconciliation"}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `WorkflowTemplateBuildResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `workflow.template.fit`
+
+Run: `mammoth workflow template fit`. Exact input fields: `mammoth schema get workflow.template.fit`.
+
+Example: `mammoth workflow template fit bank-reconciliation --input '{"inputs": {"main": 101}}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `WorkflowTemplateFitResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `workflow.template.get`
+
+Run: `mammoth workflow template get`. Exact input fields: `mammoth schema get workflow.template.get`.
+
+Example: `mammoth workflow template get bank-reconciliation`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `WorkflowTemplateGetResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `workflow.template.list`
+
+Run: `mammoth workflow template list`. Exact input fields: `mammoth schema get workflow.template.list`.
+
+Example: `mammoth workflow template list`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `WorkflowTemplateListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `workflow.template.preview`
+
+Run: `mammoth workflow template preview`. Exact input fields: `mammoth schema get workflow.template.preview`.
+
+Example: `mammoth workflow template preview bank-reconciliation --input '{"inputs": {"main": 101}, "matches": {"main": {"amount": {"column": "Amount"}}}}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `WorkflowTemplatePreviewResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `workflow.template.rank`
+
+Run: `mammoth workflow template rank`. Exact input fields: `mammoth schema get workflow.template.rank`.
+
+Example: `mammoth workflow template rank bank-reconciliation --input '{"input_key": "main", "dataset_ids": [101, 102]}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `WorkflowTemplateRankResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `workflow.template.sample-result`
+
+Run: `mammoth workflow template sample-result`. Exact input fields: `mammoth schema get workflow.template.sample-result`.
+
+Example: `mammoth workflow template sample-result bank-reconciliation`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `WorkflowTemplateSampleResultResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `workflow.template.samples`
+
+Run: `mammoth workflow template samples`. Exact input fields: `mammoth schema get workflow.template.samples`.
+
+Example: `mammoth workflow template samples bank-reconciliation`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `WorkflowTemplateSamplesResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `workflow.update`
 
 Run: `mammoth workflow update`. Exact input fields: `mammoth schema get workflow.update`.

{mammoth_cli-2.3.0 → mammoth_cli-2.4.0}/mammoth_cli/bundled_skill/mammoth-cli/references/machine-output.md

@@ -20,11 +20,19 @@ command that succeeded (`file upload`, `view create`, a `view transform`,
 filled in with this result's ids, usually the read-back. Run them as they are
 when they fit the task; a write that did not verify has none.
 
-## Error envelope (stderr)
+## Error envelope (stdout, non-zero exit)
 ```json
 {"schema_version": 1, "error": {"code": "resource_not_found", "message": "...", "hint": "...", "details": {}, "request_id": null, "retryable": false, "authorization_required": false, "recovery_commands": ["..."], "exit": 1, "log_ref": {"file": ".../logs/2026-09-19.jsonl", "run_id": "b6bc6bf6d166"}}}
 ```
 
+With `-o json`, `-o ndjson` or `-o yaml` (also via `MAMMOTH_OUTPUT`, or `auto` on a pipe) the error
+envelope is the one document on stdout, exactly where a success envelope would be, and the exit
+status stays non-zero: read stdout, parse it, branch on `error` and the exit code. This covers
+usage errors, refusals, unexpected exceptions and Ctrl-C. stderr carries only what a person reads
+(the `Next:` line, hints, progress, `--debug` tracebacks); never depend on it. Only if stdout is
+unwritable (a closed pipe) does the envelope fall back to stderr. Table, plain and csv output keep
+the short `error [code]: message` text on stderr.
+
 A mistyped command, option or column carries `details.did_you_mean`: the nearest
 commands (unknown command), the nearest option (`--profle`, or `"--project 3633"`
 passed as one argument: pass the value separately) or the nearest column (`Day`
@@ -42,6 +50,20 @@ refresh (`login_expired`, exit 4) needs a new `mammoth auth login`. `auth status
 token); a name is left out when its lookup fails, and the ids are always present. A sign-in limited
 to several projects adds `project_ids` to `auth login` and `token_projects` to `auth status --check`.
 
+## Resource ids in results
+
+One id key per resource, at the top level of `data`: `<resource>_id`. Every create-type command
+(`create`, `create-*`, `duplicate`, `copy`) names the resource it made that way: `dataset create`
+gives `dataset_id`, `project create` `project_id`, `connector connection create` `connection_id`
+(the value `identity_key` / `connection_key` holds, which is the CONNECTION_KEY other commands
+take), `dashboard create-blank` `dashboard_id`. A write that made a dataset, view or dashboard
+(`file upload`, `view export dataset`, `dashboard v3 generate`, ...) also gives that
+`<kind>_id`, and `job wait` / `job get` lift the `dataset_id`, `view_id` or `dashboard_id` their
+`response` or `result` holds, so a script never reads `response.dataset_id`. The older keys
+(`id`, `identity_key`, nested `response`) stay for compatibility; save `data.<resource>_id`, never
+the whole reply. A result that carries no id (a job still running) has no such key: wait on its
+`job_id`, then read the id from `job wait`.
+
 ## Representative result keys
 
 These are compact shapes, not substitutes for `schema get`. IDs and field
@@ -105,7 +127,7 @@ echoed `id`. The last line is the summary, which has no `line`: `data` holds `li
 - A bad line (invalid JSON, a duplicate or unknown key, a flag in `args`, a reserved flag) is an
   `invalid_run_line` error for that line, exit 2. `run`, `auth login` and `auth logout` cannot be
   lines, however `cmd` and `args` spell them (`run_command_refused`).
-- stdout carries only the envelopes; progress and diagnostics stay on stderr.
+- stdout carries only the envelopes (errors included); progress and diagnostics stay on stderr.
 - Steps: a line with `"name": "up"` keeps its envelope, and a later line reads it in `args`,
   `input` or `flags` as `"{{steps.up.data.dataset.id}}"` (a whole-string reference keeps its type;
   paths take `[0]` indexes). `"when"` skips a line when false (`{"eq": [A, B]}`, `{"in": [A, LIST]}`,

{mammoth_cli-2.3.0 → mammoth_cli-2.4.0}/mammoth_cli/bundled_skill/mammoth-cli/references/recipes/dashboards.md

@@ -189,6 +189,20 @@ the user to use Download PDF in the app; never retry with `{"data": {}}`.
 not publish: `was_published` stays false until you also run
 `dashboard action DASHBOARD_ID --input '{"action":"publish-presentation"}'`.
 `share` returns `data: null`; read the url slug back with `dashboard get`.
+
+To put the link behind a password, write it (8 to 128 characters) to a file and
+pass the path, never the password itself:
+`mammoth dashboard share ID --input '{"type_of_auth": "password", "password_file": "./pw.txt"}' --yes`.
+The file must not be readable by group or others (`chmod 600`). The trailing
+newline is stripped and the password is never printed or logged.
+This needs a Mammoth with PRD-656. On an older one the password is ignored: the
+CLI reads the share back, and unless `options.has_password` is true it exits
+non-zero with `unsupported_by_server` and puts the earlier share back (the
+error says whether it did; if not, run
+`mammoth dashboard share ID --input '{"type_of_auth": "mammoth"}' --yes`).
+Sharing as `password` again without `password_file` keeps the old password;
+`dashboard get` shows `options.has_password: true`, never the password. To undo,
+share as `mammoth` or `public` again. Viewers enter the password on the link.
 `dashboard action` with `publish-data` on a board that was never published
 publishes the presentation instead and says so. `share` and `action` print the
 deliverable check in their confirmation text.

{mammoth_cli-2.3.0 → mammoth_cli-2.4.0}/mammoth_cli/bundled_skill/mammoth-cli/references/recipes/file-import.md

@@ -41,3 +41,36 @@ mammoth view list DATASET_ID                              # the new dataset must
 Report the dataset name and id. If the call returns an error envelope (a bad
 host, login or path shows up here), report it as is and stop; do not retry the
 create blindly.
+
+## Replace instead of add
+
+An upload into an existing dataset adds its rows by default. To replace them
+instead, set the dataset's update method once; every later upload then replaces:
+
+```bash
+mammoth dataset update-method get DATASET_ID              # the current mode: add or replace
+mammoth dataset update-method set DATASET_ID --input '{"mode": "replace"}'
+mammoth file upload ./new.csv --input '{"append_to_ds_id": DATASET_ID}'
+```
+
+Set it back with `{"mode": "add"}` before the next upload if the rows should be
+added again. The setting stays on the dataset, not on one file.
+
+If the file's columns do not match the dataset's, `file upload` exits 1 with
+`schema_mismatch` (`rows_added` 0, `kept_dataset_ids`, a next step): nothing was
+added and the file's own dataset stays in the project. Fix the columns or the
+dataset's `schema_mapping` (`dataset update-method set`); `override_target_schema`
+is allowed only under `replace`, with `append_to_ds_id` and the wait.
+
+## Undo an append
+
+To take back the rows one upload added, list the dataset's batches and delete
+the one to remove. Deleting a batch removes its rows (a write: confirm first):
+
+```bash
+mammoth batch list DATASET_ID                             # each batch: its id and row count
+mammoth batch delete DATASET_ID BATCH_ID --yes
+```
+
+`mammoth history undo` also reverts an append. Use `batch list` and
+`batch delete` when the batch is not the last change.