mammoth-cli 2.2.92__tar.gz → 2.2.94__tar.gz

{mammoth_cli-2.2.92 → mammoth_cli-2.2.94}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.2.92
+Version: 2.2.94
 Summary: Command-line interface for the Mammoth Analytics platform
 Project-URL: homepage, https://mammoth.io
 Project-URL: repository, https://github.com/EdgeMetric/mammothsdk
@@ -18,7 +18,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.9,>=0.8.45
+Requires-Dist: mammoth-io<0.9,>=0.8.47
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.12.5
 Requires-Dist: pyyaml<7,>=6

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

{mammoth_cli-2.2.92 → mammoth_cli-2.2.94}/mammoth_cli/app.py

@@ -148,6 +148,7 @@ _SUBGROUP_DESCRIPTIONS = {
     "auth connected-apps": "List and revoke the apps you have authorised.",
     "billing invoice": "List and charge invoices.",
     "billing stripe": "Manage the Stripe subscription: checkout, trial, payment methods, invoices.",
+    "billing stripe held-change": "Read or cancel a held plan change.",
     "billing stripe payment-method": "List, delete and default Stripe payment methods.",
     "billing stripe storage": "Set the Stripe storage tier.",
     "billing subscription": "Read and update the subscription.",
@@ -167,6 +168,7 @@ _SUBGROUP_DESCRIPTIONS = {
     "dashboard audience digest": "Read and set the audience digest of a dashboard.",
     "dashboard canvas": "Read, save and restore a dashboard canvas.",
     "dashboard chat": "Edit a dashboard by chat and read the chat history.",
+    "dashboard chat attachment": "Upload a file to a dashboard's chat.",
     "dashboard context": "Create, review, apply and manage dashboard contexts.",
     "dashboard data": "Read the data behind a dashboard, draft or published.",
     "dashboard embed": "Manage dashboard embedding: keys, origins, tokens and usage.",
@@ -219,6 +221,7 @@ _SUBGROUP_DESCRIPTIONS = {
     "dataset definition": "List, save and remove what terms mean for a dataset.",
     "dataset file-settings": "Read, update and undo a dataset's file settings.",
     "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.",
     "project checkpoint": "List project checkpoints.",
     "project data-check": "List project data checks.",
@@ -226,11 +229,17 @@ _SUBGROUP_DESCRIPTIONS = {
     "project resource-dependencies": "Update project resource dependencies.",
     "project user": "Add, update and remove project users.",
     "skill agents-md": "Install the agent instructions file.",
+    "support billing": "Trials, plan changes, payment retries, refunds and cancellations.",
     "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 entitlement": "Read the entitlement registry.",
     "support feature": "Create, list, update and delete features.",
     "support feature-profile": "Manage feature profiles and their features.",
+    "support identity": "List and read users across workspaces.",
     "support ownership": "Transfer ownership.",
+    "support partner": "Create, read and update partners, and manage their billing and invoices.",
+    "support partner client": "List, delete and detach (or cancel detaching) a partner's clients.",
     "support plan": "Manage billing plans.",
     "support plan storage-option": "Manage a plan's storage options.",
     "support subscription": "Create, read and update subscriptions.",
@@ -238,13 +247,16 @@ _SUBGROUP_DESCRIPTIONS = {
     "support template thumbnail": "Set and clear a template thumbnail.",
     "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 user": "Add, list, remove and transfer workspace users.",
     "user avatar": "Upload or delete the avatar.",
     "user preference": "Read and update user preferences.",
     "view active-user": "List the users active on a view and mark activity.",
     "view ai": "AI profile and generated data for a view.",
     "view checkpoint": "Create, list, update and delete view checkpoints.",
-    "view conditional-format": "Create, list, update and delete conditional formats.",
+    "view column": "Set how a view's columns look.",
+    "view column format": "Set how columns display: date or number format.",
+    "view conditional-format": "Create, list, update, replace and delete conditional formats.",
     "view data": "Read, query, aggregate, compare and profile a view's data.",
     "view data-check": "Create, list, update and delete data checks on a view.",
     "view derivative": "Create, list, update and delete derivative views.",
@@ -321,6 +333,7 @@ _ROOT_HELP_PANELS = {
     "activity": "Manage resources",
     "support": "Manage resources",
     "config": "CLI and agent tools",
+    "run": "CLI and agent tools",
     "completion": "CLI and agent tools",
     "skill": "CLI and agent tools",
     "log": "CLI and agent tools",
@@ -1421,9 +1434,26 @@ def _indexed_summary(command_id: str) -> str | None:
     return _summary_index().get(command_id)
 
 
+def _sdk_backed(command_id: str) -> bool:
+    """Whether the command's help comes from an SDK method's docstring."""
+    from mammoth_cli.commands.registry import _TARGETS
+
+    return _TARGETS.get(command_id, "").endswith(":generated_dashboard")
+
+
 #: A line of ``--help`` a command needs that its handler's shared docstring cannot carry.
 _RAW_NOTE = "Input field raw: true returns DATE values with their time, not the date alone."
+_RUN_HELP_NOTE = (
+    'One command per line: {"cmd": "view task list", "args": ["290"], "input": {}, '
+    '"flags": {"project": 1}, "id": "a"}. cmd is the command path, args its positionals, '
+    "input its --input document, flags the global flags by long name (yes, confirm, dry-run, "
+    "project). Prints each line's envelope plus line, cmd and exit, then a summary; stops at "
+    "the first failed line (exit = its status) unless --continue. No global --yes: a "
+    "mutating line carries its own. --dry-run, --profile and --project apply to every line. "
+    "FILE defaults to stdin; --continue may come before or after it."
+)
 _HELP_NOTES = {
+    "run": _RUN_HELP_NOTE,
     "view.data.get": _RAW_NOTE,
     "view.data.query": _RAW_NOTE,
     "view.export.dataset": (
@@ -1452,7 +1482,11 @@ def _command_help(command_id: str, record: dict[str, Any] | None) -> str | None:
     from mammoth_cli.commands.schema import IN_PLACE_RECIPE, edits_view_in_place
 
     parts: list[str] = []
-    summary = live_command_summary(command_id)
+    # The generated index equals the handler's docstring (a unit test pins it) and reading it
+    # keeps the handler's module, and the SDK it imports, out of ``--help``. A command built from
+    # an SDK method reads it live: the installed SDK may be newer than the index.
+    summary = None if _sdk_backed(command_id) else _indexed_summary(command_id)
+    summary = summary or live_command_summary(command_id)
     if summary:
         parts.append(summary)
     if record is not None and edits_view_in_place(record):
@@ -1617,7 +1651,9 @@ def _lazy_leaf_command(command_id: str) -> type[TyperCommand]:
                 info = CommandInfo(
                     name=self.name,
                     callback=_build_leaf(command_id),
-                    help=_command_help(command_id, command_by_id(command_id)),
+                    # The help text is read from this class's lazy ``help`` property; building
+                    # it here would import the contract and schema layers on every run.
+                    help="",
                     rich_help_panel=self.rich_help_panel,
                     context_settings=_leaf_context_settings(command_id),
                 )
@@ -1751,6 +1787,11 @@ _ROOT_LEAF_HELP: dict[str, str] = {
         "Say what NAME refers to: a dataset, a view or a project, with ids and projects."
         "\n\nExample: mammoth resolve uqa-w29-ren\n\nInput fields: all_projects (bool)"
     ),
+    "run": (
+        "Run many commands in one process: JSON Lines of cmd, args, input and flags."
+        f"\n\n{_RUN_HELP_NOTE}"
+        "\n\nExample: mammoth run commands.jsonl"
+    ),
     "upgrade": (
         "Upgrade the mammoth CLI to the latest (or a specified) version from PyPI."
         "\n\nExample: mammoth upgrade --yes"

{mammoth_cli-2.2.92 → mammoth_cli-2.2.94}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.2.92
+version: 2.2.94
 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."
 ---
 
@@ -192,7 +192,7 @@ your report. If no column links the files, ask before you combine them.
   a web-app task you cannot find in the CLI:** [about Mammoth](references/about-mammoth.md)
 - **Cold start, task plan, or unsupported route:** [task start](references/task-start.md)
 - **Login, profiles, and authorized scope:** [auth](references/auth.md)
-- **Nested input, output envelopes, confirmations, jobs, or recovery:**
+- **Input, envelopes, `mammoth run` (batch), confirmations, jobs, recovery:**
   [input](references/input.md), [machine output](references/machine-output.md),
   [safety](references/safety.md), or [jobs and drafts](references/jobs-drafts.md)
 - **Import, resources, transforms, pipelines, dashboards, exports, or cleanup:**

{mammoth_cli-2.2.92 → mammoth_cli-2.2.94}/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 782 commands. 516 of them bind one of the 545 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, 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 860 commands. 516 of them bind one of the 545 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, 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:
 

{mammoth_cli-2.2.92 → mammoth_cli-2.2.94}/mammoth_cli/bundled_skill/mammoth-cli/references/command-index.md

@@ -1,18 +1,18 @@
 # Published CLI command catalog
 
-This generated catalog is a lookup table for every command in the published CLI manifest, currently 782; 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 860; 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:
 
 - [activity](commands/activity.md) — 2 published commands
 - [addon](commands/addon.md) — 7 published commands
-- [agent](commands/agent.md) — 54 published commands
+- [agent](commands/agent.md) — 73 published commands
 - [ai](commands/ai.md) — 5 published commands
 - [annotation](commands/annotation.md) — 5 published commands
 - [auth](commands/auth.md) — 5 published commands
 - [automation](commands/automation.md) — 8 published commands
 - [batch](commands/batch.md) — 7 published commands
-- [billing](commands/billing.md) — 25 published commands
+- [billing](commands/billing.md) — 27 published commands
 - [browse](commands/browse.md) — 9 published commands
 - [calc](commands/calc.md) — 1 published commands
 - [capabilities](commands/capabilities.md) — 1 published commands
@@ -21,16 +21,16 @@ Load only the applicable domain file:
 - [collection](commands/collection.md) — 21 published commands
 - [completion](commands/completion.md) — 2 published commands
 - [config](commands/config.md) — 4 published commands
-- [connector](commands/connector.md) — 23 published commands
+- [connector](commands/connector.md) — 25 published commands
 - [context](commands/context.md) — 4 published commands
 - [dashboard-qa](commands/dashboard-qa.md) — 14 published commands
 - [dashboard-template](commands/dashboard-template.md) — 12 published commands
 - [dashboard-style](commands/dashboard-style.md) — 10 published commands
 - [dashboard-embed](commands/dashboard-embed.md) — 9 published commands
 - [dashboard-published](commands/dashboard-published.md) — 8 published commands
-- [dashboard](commands/dashboard.md) — 104 published commands
+- [dashboard](commands/dashboard.md) — 106 published commands
 - [data-app](commands/data-app.md) — 12 published commands
-- [dataset](commands/dataset.md) — 28 published commands
+- [dataset](commands/dataset.md) — 30 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
@@ -44,11 +44,12 @@ Load only the applicable domain file:
 - [project](commands/project.md) — 25 published commands
 - [report](commands/report.md) — 1 published commands
 - [resolve](commands/resolve.md) — 1 published commands
+- [run](commands/run.md) — 1 published commands
 - [schedule](commands/schedule.md) — 5 published commands
 - [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) — 66 published commands
+- [support](commands/support.md) — 112 published commands
 - [template](commands/template.md) — 5 published commands
 - [token](commands/token.md) — 3 published commands
 - [trash](commands/trash.md) — 3 published commands
@@ -56,7 +57,7 @@ Load only the applicable domain file:
 - [user](commands/user.md) — 8 published commands
 - [version](commands/version.md) — 1 published commands
 - [view-transform](commands/view-transform.md) — 35 published commands
-- [view](commands/view.md) — 106 published commands
+- [view](commands/view.md) — 110 published commands
 - [webhook](commands/webhook.md) — 7 published commands
 - [workflow](commands/workflow.md) — 23 published commands
 - [workspace](commands/workspace.md) — 33 published commands

{mammoth_cli-2.2.92 → mammoth_cli-2.2.94}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/agent.md

@@ -2,6 +2,146 @@
 
 Every command returns the standard JSON envelope. On nonzero exit, read the error envelope and its `recovery_commands`; do not guess request fields. "Status on release" is joined from `docs/release-capability-matrix.json`: *ran once* means one bounded live run succeeded on the named CLI release, *untried* means nobody has run it (use it normally: confirm writes with the user, check the result afterwards), *not supported* means the backend refuses it. When this file disagrees with [capabilities](../capabilities.md) or a recipe, they win. Envelope shapes: [machine output](../machine-output.md).
 
+### `agent.access.askers`
+
+Run: `mammoth agent access askers`. Exact input fields: `mammoth schema get agent.access.askers`.
+
+Example: `mammoth agent access askers 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentAccessAskersResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `agent.access.chart.save`
+
+Run: `mammoth agent access chart save`. Exact input fields: `mammoth schema get agent.access.chart.save`.
+
+Example: `mammoth agent access chart save resource-123 resource-123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentAccessChartSaveResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `agent.access.grant.give`
+
+Run: `mammoth agent access grant give`. Exact input fields: `mammoth schema get agent.access.grant.give`.
+
+Example: `mammoth agent access grant give --input '{"emails": ["analyst@example.com"], "level": "ask", "items": [{"project_id": 1}]}' --yes`. Illustrative only: append `--yes` after observing an owned target.
+
+Result: `AgentAccessGrantGiveResult`; mutation `external_effect`, confirmation `yes_always`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `agent.access.grant.list`
+
+Run: `mammoth agent access grant list`. Exact input fields: `mammoth schema get agent.access.grant.list`.
+
+Example: `mammoth agent access grant list`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentAccessGrantListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `agent.access.grant.revoke`
+
+Run: `mammoth agent access grant revoke`. Exact input fields: `mammoth schema get agent.access.grant.revoke`.
+
+Example: `mammoth agent access grant revoke 123 --yes`. Illustrative only: append `--yes` after observing an owned target.
+
+Result: `AgentAccessGrantRevokeResult`; mutation `destructive`, confirmation `prompt_or_yes`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `agent.access.grant.update`
+
+Run: `mammoth agent access grant update`. Exact input fields: `mammoth schema get agent.access.grant.update`.
+
+Example: `mammoth agent access grant update 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentAccessGrantUpdateResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `agent.access.me`
+
+Run: `mammoth agent access me`. Exact input fields: `mammoth schema get agent.access.me`.
+
+Example: `mammoth agent access me`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentAccessMeResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `agent.access.people`
+
+Run: `mammoth agent access people`. Exact input fields: `mammoth schema get agent.access.people`.
+
+Example: `mammoth agent access people`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentAccessPeopleResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `agent.access.reach`
+
+Run: `mammoth agent access reach`. Exact input fields: `mammoth schema get agent.access.reach`.
+
+Example: `mammoth agent access reach`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentAccessReachResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `agent.access.request.add-to-context`
+
+Run: `mammoth agent access request add-to-context`. Exact input fields: `mammoth schema get agent.access.request.add-to-context`.
+
+Example: `mammoth agent access request add-to-context 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentAccessRequestAddToContextResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `agent.access.request.create`
+
+Run: `mammoth agent access request create`. Exact input fields: `mammoth schema get agent.access.request.create`.
+
+Example: `mammoth agent access request create --input '{"kind": "access", "text": "Please share the Sales project"}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentAccessRequestCreateResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `agent.access.request.list`
+
+Run: `mammoth agent access request list`. Exact input fields: `mammoth schema get agent.access.request.list`.
+
+Example: `mammoth agent access request list`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentAccessRequestListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `agent.access.request.mine`
+
+Run: `mammoth agent access request mine`. Exact input fields: `mammoth schema get agent.access.request.mine`.
+
+Example: `mammoth agent access request mine resource-123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentAccessRequestMineResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `agent.access.request.resolve`
+
+Run: `mammoth agent access request resolve`. Exact input fields: `mammoth schema get agent.access.request.resolve`.
+
+Example: `mammoth agent access request resolve 123 --input '{"status": "done"}' --yes`. Illustrative only: append `--yes` after observing an owned target.
+
+Result: `AgentAccessRequestResolveResult`; mutation `destructive`, confirmation `prompt_or_yes`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `agent.access.set`
 
 Run: `mammoth agent access set`. Exact input fields: `mammoth schema get agent.access.set`.
@@ -12,6 +152,36 @@ Result: `AgentAccessSetResult`; mutation `benign_mutation`, confirmation `none`,
 
 Status on release: untried; no live run recorded.
 
+### `agent.access.settings.get`
+
+Run: `mammoth agent access settings get`. Exact input fields: `mammoth schema get agent.access.settings.get`.
+
+Example: `mammoth agent access settings get`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentAccessSettingsGetResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `agent.access.settings.update`
+
+Run: `mammoth agent access settings update`. Exact input fields: `mammoth schema get agent.access.settings.update`.
+
+Example: `mammoth agent access settings update --input '{"enabled": true}' --yes --confirm 123`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+
+Result: `AgentAccessSettingsUpdateResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `agent.access.tree`
+
+Run: `mammoth agent access tree`. Exact input fields: `mammoth schema get agent.access.tree`.
+
+Example: `mammoth agent access tree`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentAccessTreeResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `agent.action.delete`
 
 Run: `mammoth agent action delete`. Exact input fields: `mammoth schema get agent.action.delete`.
@@ -482,6 +652,16 @@ Result: `AgentSessionDeleteResult`; mutation `destructive`, confirmation `prompt
 
 Status on release: untried; no live run recorded.
 
+### `agent.session.feedback.list`
+
+Run: `mammoth agent session feedback list`. Exact input fields: `mammoth schema get agent.session.feedback.list`.
+
+Example: `mammoth agent session feedback list resource-123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentSessionFeedbackListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `agent.session.list`
 
 Run: `mammoth agent session list`. Exact input fields: `mammoth schema get agent.session.list`.
@@ -532,6 +712,16 @@ Result: `AgentTurnCancelResult`; mutation `benign_mutation`, confirmation `none`
 
 Status on release: untried; no live run recorded.
 
+### `agent.turn.rate`
+
+Run: `mammoth agent turn rate`. Exact input fields: `mammoth schema get agent.turn.rate`.
+
+Example: `mammoth agent turn rate resource-123 resource-123 --input '{"rating": "up"}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AgentTurnRateResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `agent.update`
 
 Run: `mammoth agent update`. Exact input fields: `mammoth schema get agent.update`.

{mammoth_cli-2.2.92 → mammoth_cli-2.2.94}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/billing.md

@@ -16,7 +16,7 @@ Status on release: observed blocker — backend_error: The CLI gates this GET be
 
 Run: `mammoth billing hosted-page`. Exact input fields: `mammoth schema get billing.hosted-page`.
 
-Example: `mammoth billing hosted-page change_plan --yes --confirm change_plan`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+Example: `mammoth billing hosted-page change_plan --yes --confirm 123`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
 
 Result: `BillingHostedPageResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
 
@@ -66,7 +66,7 @@ Status on release: untried; no live run recorded.
 
 Run: `mammoth billing stripe create`. Exact input fields: `mammoth schema get billing.stripe.create`.
 
-Example: `mammoth billing stripe create 123 --yes --confirm 123`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+Example: `mammoth billing stripe create 123 --yes --confirm 456`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
 
 Result: `BillingStripeCreateResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
 
@@ -92,6 +92,26 @@ Result: `BillingStripeGetResult`; mutation `read`, confirmation `none`, wait pol
 
 Status on release: untried; no live run recorded.
 
+### `billing.stripe.held-change.cancel`
+
+Run: `mammoth billing stripe held-change cancel`. Exact input fields: `mammoth schema get billing.stripe.held-change.cancel`.
+
+Example: `mammoth billing stripe held-change cancel --yes --confirm 123`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+
+Result: `BillingStripeHeldChangeCancelResult`; mutation `destructive`, confirmation `confirm_target`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `billing.stripe.held-change.get`
+
+Run: `mammoth billing stripe held-change get`. Exact input fields: `mammoth schema get billing.stripe.held-change.get`.
+
+Example: `mammoth billing stripe held-change get`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `BillingStripeHeldChangeGetResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `billing.stripe.history`
 
 Run: `mammoth billing stripe history`. Exact input fields: `mammoth schema get billing.stripe.history`.

{mammoth_cli-2.2.92 → mammoth_cli-2.2.94}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/connector.md

@@ -114,6 +114,16 @@ Result: `ConnectorConnectionListResult`; mutation `read`, confirmation `none`, w
 
 Status on release: observed blocker — server_error: see sweep report. Re-check before relying on it.
 
+### `connector.connection.list-all`
+
+Run: `mammoth connector connection list-all`. Exact input fields: `mammoth schema get connector.connection.list-all`.
+
+Example: `mammoth connector connection list-all`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `ConnectorConnectionListAllResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `connector.connection.query`
 
 Run: `mammoth connector connection query`. Exact input fields: `mammoth schema get connector.connection.query`.
@@ -124,6 +134,16 @@ Result: `ConnectorConnectionQueryResult`; mutation `read`, confirmation `none`,
 
 Status on release: untried; no live run recorded.
 
+### `connector.connection.test`
+
+Run: `mammoth connector connection test`. Exact input fields: `mammoth schema get connector.connection.test`.
+
+Example: `mammoth connector connection test prod-warehouse`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `ConnectorConnectionTestResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `connector.connection.update`
 
 Run: `mammoth connector connection update`. Exact input fields: `mammoth schema get connector.connection.update`.

{mammoth_cli-2.2.92 → mammoth_cli-2.2.94}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/dashboard.md

@@ -162,6 +162,16 @@ Result: `DashboardCanvasSaveResult`; mutation `benign_mutation`, confirmation `n
 
 Status on release: ran once on CLI 2.0.28 — ILG simulation 2026-09-19: exit 0 on release with CLI 2.0.28. Authored a canvas from a blank one: page-level focus.kpis (sum with unit.prefix GBP, and a countDistinct card), added bar (measure+measure2), hbar, line on a derived ratio measure (canvas.derived),…
 
+### `dashboard.chat.attachment.upload`
+
+Run: `mammoth dashboard chat attachment upload`. Exact input fields: `mammoth schema get dashboard.chat.attachment.upload`.
+
+Example: `mammoth dashboard chat attachment upload 123 notes.pdf`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DashboardChatAttachmentUploadResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `dashboard.chat.edit`
 
 Run: `mammoth dashboard chat edit`. Exact input fields: `mammoth schema get dashboard.chat.edit`.
@@ -980,6 +990,16 @@ Result: `DashboardTrashResult`; mutation `benign_mutation`, confirmation `none`,
 
 Status on release: ran once on CLI 2.0.12 — Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: n/a. trashed D2=54; confirmed via dashboard list -- 54 no longer appears in the active list Single invocation only; no error-path or variant coverage. Also exercised successfully in t…
 
+### `dashboard.unpublished`
+
+Run: `mammoth dashboard unpublished`. Exact input fields: `mammoth schema get dashboard.unpublished`.
+
+Example: `mammoth dashboard unpublished 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DashboardUnpublishedResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `dashboard.update`
 
 Run: `mammoth dashboard update`. Exact input fields: `mammoth schema get dashboard.update`.

{mammoth_cli-2.2.92 → mammoth_cli-2.2.94}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/dataset.md

@@ -262,6 +262,26 @@ Result: `DatasetSearchResult`; mutation `read`, confirmation `none`, wait policy
 
 Status on release: untried; no live run recorded.
 
+### `dataset.tool-claim.get`
+
+Run: `mammoth dataset tool-claim get`. Exact input fields: `mammoth schema get dataset.tool-claim.get`.
+
+Example: `mammoth dataset tool-claim get --input '{"token": "replace-with-secret"}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DatasetToolClaimGetResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `dataset.tool-claim.redeem`
+
+Run: `mammoth dataset tool-claim redeem`. Exact input fields: `mammoth schema get dataset.tool-claim.redeem`.
+
+Example: `mammoth dataset tool-claim redeem --input '{"token": "replace-with-secret"}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DatasetToolClaimRedeemResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `dataset.trash`
 
 Run: `mammoth dataset trash`. Exact input fields: `mammoth schema get dataset.trash`.

mammoth_cli-2.2.94/mammoth_cli/bundled_skill/mammoth-cli/references/commands/run.md

@@ -0,0 +1,13 @@
+# `run` commands
+
+Every command returns the standard JSON envelope. On nonzero exit, read the error envelope and its `recovery_commands`; do not guess request fields. "Status on release" is joined from `docs/release-capability-matrix.json`: *ran once* means one bounded live run succeeded on the named CLI release, *untried* means nobody has run it (use it normally: confirm writes with the user, check the result afterwards), *not supported* means the backend refuses it. When this file disagrees with [capabilities](../capabilities.md) or a recipe, they win. Envelope shapes: [machine output](../machine-output.md).
+
+### `run`
+
+Run: `mammoth run`. Exact input fields: `mammoth schema get run`.
+
+Example: `mammoth run commands.jsonl`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `RunResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.