mammoth-cli 2.2.85__tar.gz → 2.2.86__tar.gz

{mammoth_cli-2.2.85 → mammoth_cli-2.2.86}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.2.85
+Version: 2.2.86
 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.43
+Requires-Dist: mammoth-io<0.9,>=0.8.44
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.12.5
 Requires-Dist: pyyaml<7,>=6

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

{mammoth_cli-2.2.85 → mammoth_cli-2.2.86}/mammoth_cli/__main__.py

@@ -8,6 +8,7 @@ launch symbol that does not change when the application wiring moves.
 
 from __future__ import annotations
 
+import os
 import sys
 from typing import Any
 
@@ -19,6 +20,10 @@ def main() -> Any:
         The value returned by the Typer application, which the runtime uses as
         the process exit code.
     """
+    # pydantic looks up installed plugins (entry points) the first time it builds a
+    # model, and imports each one it finds: with logfire in the environment that is
+    # about 0.4 s on every command that loads the SDK. The CLI uses no plugin.
+    os.environ.setdefault("PYDANTIC_DISABLE_PLUGINS", "__all__")
     if sys.argv[1:] == ["--version"]:
         # The answer needs none of the command tree; skip building it.
         from mammoth_cli import __version__

{mammoth_cli-2.2.85 → mammoth_cli-2.2.86}/mammoth_cli/app.py

@@ -43,6 +43,7 @@ from mammoth_cli.output.policy import (
     OUTPUT_AUTO,
     SELECTABLE_OUTPUTS,
     VALID_OUTPUTS,
+    canonical_output,
     resolve_output,
 )
 from mammoth_cli.services.positionals import PositionalSpec, resolve_positionals
@@ -84,8 +85,15 @@ _GROUP_DESCRIPTIONS = {
     "data-app": "Create and manage data applications.",
     "dataset": "Create, inspect, and manage datasets.",
     "external-key": "Manage LLM provider keys (OpenAI, Anthropic, etc.) used by AI features.",
-    "file": "Upload and manage source files.",
-    "folder": "Organize folders and their contents.",
+    "file": (
+        "Upload files (file upload; a whole local directory: file upload-folder) and manage "
+        "uploaded source files. An uploaded file becomes a dataset: delete it with "
+        "'dataset delete'."
+    ),
+    "folder": (
+        "Create, rename, move and delete project folders that organize datasets, views and "
+        "dashboards. To upload a local directory use 'file upload-folder'."
+    ),
     "job": "Inspect and wait for asynchronous jobs.",
     "notification": "Manage workspace notifications.",
     "parameter": "Manage parameters and parameter groups.",
@@ -146,6 +154,8 @@ _SUBGROUP_DESCRIPTIONS = {
     "browse resources": "Browse workspace resources in bulk.",
     "collection dashboards": "Add dashboards to a collection or remove them.",
     "collection files": "Upload files to a collection.",
+    "collection email-updates": "Read and set a collection's email updates, and send a test.",
+    "collection email-updates me": "Read and set your own email updates for a collection.",
     "collection members": "Remove members from a collection.",
     "connector ai": "Chat with the connector assistant to set up a connection.",
     "connector ai session": "List connector assistant sessions and their messages.",
@@ -161,6 +171,9 @@ _SUBGROUP_DESCRIPTIONS = {
     "dashboard data": "Read the data behind a dashboard, draft or published.",
     "dashboard embed": "Manage dashboard embedding: keys, origins, tokens and usage.",
     "dashboard embed config": "Read and set the embed configuration.",
+    "dashboard email-updates": "Read and set a dashboard's email updates, and send a test.",
+    "dashboard email-updates me": "Read and set your own email updates for a dashboard.",
+    "dashboard live-chart": "Create live charts, set their audience and see where they are used.",
     "dashboard embed key": "Rotate the embed key.",
     "dashboard embed lifetime": "Set the embed token lifetime.",
     "dashboard embed origin": "Revoke an allowed embed origin.",
@@ -245,6 +258,7 @@ _SUBGROUP_DESCRIPTIONS = {
     "view variants": "Create view variants.",
     "view version": "List, read, apply and delete view versions.",
     "workflow block": "Add and configure workflow blocks.",
+    "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.",
     "workspace segment": "List and update workspace segments.",
@@ -269,6 +283,8 @@ _ROOT_HELP_PANELS = {
     "context": "Start here",
     "doctor": "Start here",
     "project": "Start here",
+    "how": "Discover commands",
+    "capabilities": "Discover commands",
     "schema": "Discover commands",
     "capability": "Discover commands",
     "browse": "Discover commands",
@@ -357,6 +373,7 @@ def _output_mode_from_argv(argv: Sequence[str] | None) -> str:
         elif token.startswith("-o") and len(token) > 2:
             mode = token[2:]
         index += 1
+    mode = canonical_output(mode)
     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.
@@ -436,6 +453,76 @@ def _corrected_command(tokens: Sequence[str]) -> str | None:
     return " ".join(["mammoth", *rest, *leading])
 
 
+def _parent_words(context: Any) -> list[str]:
+    """The command words above an unknown one, without the program name."""
+    words: list[str] = []
+    while context is not None and getattr(context, "parent", None) is not None:
+        words.insert(0, str(context.info_name))
+        context = context.parent
+    return words
+
+
+def _unknown_command_report(error: Any) -> CliError | None:
+    """``No such command 'X'``: name the nearest commands and the discovery commands."""
+    from mammoth_cli.services.suggest import DISCOVERY_HINT, command_suggestions
+
+    match = _NO_SUCH_COMMAND.search(error.format_message() or "")
+    if match is None or match.group("name").startswith("-"):
+        return None
+    name = match.group("name")
+    parent = _parent_words(getattr(error, "ctx", None))
+    paths = [str(record["command_path"]).split() for record in _command_records()]
+    suggestions = command_suggestions(parent, name, paths)
+    where = f" under 'mammoth {' '.join(parent)}'" if parent else ""
+    message = f"No such command '{name}'{where}."
+    if suggestions:
+        message += f" Did you mean: {', '.join(suggestions)}?"
+    goal = name.replace('"', "")
+    return CliError(
+        code="usage_error",
+        message=message,
+        exit_status=EXIT_USAGE,
+        hint=DISCOVERY_HINT,
+        details={"command": name, "did_you_mean": suggestions},
+        recovery_commands=[
+            *(f"{suggestion} --help" for suggestion in suggestions[:2]),
+            f'mammoth how "{goal}"',
+            f'mammoth schema find "{goal}"',
+        ],
+    )
+
+
+def _unknown_option_report(error: Any, option: str) -> CliError:
+    """An unknown ``--option``: name the nearest valid one (global or the command's own)."""
+    from mammoth_cli.services.suggest import option_suggestion
+
+    command = getattr(getattr(error, "ctx", None), "command", None)
+    known = set(_global_option_flags()[0]) | {
+        flag
+        for param in getattr(command, "params", [])
+        for flag in (*param.opts, *param.secondary_opts)
+    }
+    suggestion = option_suggestion(option, sorted(known))
+    close = sorted(getattr(error, "possibilities", None) or [])
+    if suggestion is None and close:
+        # Click's own guess also catches a prefix ('--server' for '--server-prefix').
+        suggestion = {"flag": close[0], "hint": f"Did you mean {' or '.join(close)}?"}
+    details: dict[str, Any] = {"option": option}
+    if suggestion is not None:
+        details["did_you_mean"] = suggestion["flag"]
+    return CliError(
+        code="unknown_option",
+        message=f"Unknown option '{option}'.",
+        exit_status=EXIT_USAGE,
+        hint=(
+            suggestion["hint"]
+            if suggestion is not None
+            else "Run the command with --help to list its options."
+        ),
+        details=details,
+    )
+
+
 def _usage_error_report(error: Any, tokens: Sequence[str]) -> CliError | None:
     """Classify a usage error whose own Click message is empty or misleading.
 
@@ -464,7 +551,9 @@ def _usage_error_report(error: Any, tokens: Sequence[str]) -> CliError | None:
     if match is None:
         return None
     name = match.group("name").split("=", 1)[0]
-    if not name.startswith("-") or name not in _global_option_flags()[0]:
+    if not name.startswith("-"):
+        return _unknown_command_report(error)
+    if name not in _global_option_flags()[0]:
         return None
     # Only leaf commands declare the global options, so a group reads one as a
     # subcommand name and reports a misleading "No such command '--profile'".
@@ -649,13 +738,7 @@ class _EnvelopeGroup(TyperGroup):
         report = None if is_missing_parameter else _usage_error_report(error, tokens)
         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 = CliError(
-                code="unknown_option",
-                message=f"Unknown option '{option}'.",
-                exit_status=EXIT_USAGE,
-                hint="Check the command schema with 'mammoth schema get'.",
-                details={"option": option},
-            )
+            report = _unknown_option_report(error, option)
         if _output_mode_from_argv(argv) in MACHINE_OUTPUTS:
             if report is None:
                 missing = is_missing_parameter
@@ -668,18 +751,7 @@ class _EnvelopeGroup(TyperGroup):
                     )
                 elif isinstance(error, _typer_click_exceptions.NoSuchOption):
                     option = getattr(error, "option_name", None) or "unknown"
-                    close = getattr(error, "possibilities", None) or []
-                    report = CliError(
-                        code="unknown_option",
-                        message=f"Unknown option '{option}'.",
-                        exit_status=EXIT_USAGE,
-                        hint=(
-                            f"Did you mean {' or '.join(sorted(close))}?"
-                            if close
-                            else "Check the command schema with 'mammoth schema get'."
-                        ),
-                        details={"option": option},
-                    )
+                    report = _unknown_option_report(error, option)
                 elif isinstance(error, _typer_click_exceptions.BadParameter):
                     # With optional typed positionals Click may consume an
                     # unknown option token as the positional value. Only
@@ -687,13 +759,7 @@ class _EnvelopeGroup(TyperGroup):
                     # a known option's malformed value remains usage_error.
                     option = _unknown_flag_in(error, tokens)
                     if option:
-                        report = CliError(
-                            code="unknown_option",
-                            message=f"Unknown option '{option}'.",
-                            exit_status=EXIT_USAGE,
-                            hint="Check the command schema with 'mammoth schema get'.",
-                            details={"option": option},
-                        )
+                        report = _unknown_option_report(error, option)
                     else:
                         report = CliError(
                             code="usage_error",
@@ -714,12 +780,18 @@ class _EnvelopeGroup(TyperGroup):
         elif report is None:
             error.show()
         else:
-            typer.echo(f"Error: {report.message}", err=True)
             # A no-subcommand error arrives with the help text already on
             # screen, so repeating "run --help" below it would be noise.
             no_args = _NO_ARGS_ERROR is not None and isinstance(error, _NO_ARGS_ERROR)
+            ctx = getattr(error, "ctx", None)
+            if ctx is not None and not no_args:
+                # Click's own usage line first, as its prose error has it.
+                typer.echo(ctx.get_usage(), err=True)
+            typer.echo(f"Error: {report.message}", err=True)
             if report.hint and not no_args:
                 typer.echo(report.hint, err=True)
+            for command in report.recovery_commands:
+                typer.echo(f"  try: {command}", err=True)
 
 
 def _version_callback(value: bool) -> None:
@@ -1095,16 +1167,24 @@ def _execute(invocation: Invocation) -> None:
     # resolving the mutable selected-profile pointer after an interrupt.
     from mammoth_cli.context import profiles
     from mammoth_cli.runtime import executor, validate
+    from mammoth_cli.runtime.compact import COMPACT_COMMANDS, FULL_FLAG, with_compact
     from mammoth_cli.runtime.confirm import refuse_mismatched_confirm
     from mammoth_cli.runtime.dataset_health import with_dataset_health
     from mammoth_cli.runtime.intent_only import refuse_hand_crafted_write
     from mammoth_cli.runtime.locked_files import with_locked_files
     from mammoth_cli.runtime.new_data import with_new_data_path
+    from mammoth_cli.runtime.next_commands import with_next_commands
     from mammoth_cli.runtime.opens import with_opens
     from mammoth_cli.runtime.strict import validate_extra_args
 
     if invocation.profile is None:
         invocation = replace(invocation, profile=profiles.get_selected(), profile_is_default=True)
+    if invocation.command_id in COMPACT_COMMANDS and FULL_FLAG in invocation.extra_args:
+        invocation = replace(
+            invocation,
+            extra_args=[arg for arg in invocation.extra_args if arg != FULL_FLAG],
+            full_output=True,
+        )
 
     def producer() -> tuple[Any, dict[str, Any]]:
         refuse_hand_crafted_write(invocation.command_id)
@@ -1134,7 +1214,8 @@ def _execute(invocation: Invocation) -> None:
             return _dry_run(handler, invocation)
         data, meta = handler(invocation)
         checked = with_locked_files(with_dataset_health(_apply_verify(invocation, data)))
-        return with_new_data_path(checked), with_opens(invocation, checked, meta)
+        meta = with_next_commands(invocation, checked, with_opens(invocation, checked, meta))
+        return with_compact(invocation, with_new_data_path(checked)), meta
 
     executor.run(
         invocation.command_id,
@@ -1360,6 +1441,18 @@ def _command_help(command_id: str, record: dict[str, Any] | None) -> str | None:
     if fields:
         label = _INPUT_FIELDS_LABEL.get(command_id, "Input fields")
         parts.append(f"{label}: {fields}")
+    from mammoth_cli.services.field_enums import nested_choices_help
+
+    nested = nested_choices_help(command_id)
+    if nested:
+        parts.append(nested)
+    from mammoth_cli.runtime.compact import COMPACT_COMMANDS, FULL_FLAG
+
+    if command_id in COMPACT_COMMANDS:
+        parts.append(
+            "The result is compact: ids, checks, verify and a canvas summary. "
+            f"Pass {FULL_FLAG} for the complete response."
+        )
     return "\n\n".join(parts) or None
 
 
@@ -1383,7 +1476,8 @@ def _help_input_fields(command_id: str) -> str | None:
     for field in fields:
         label = f"{field.name}*" if field.required else field.name
         enum = field.enum_values
-        kind = "|".join(str(item) for item in enum[:6]) if enum else _short_type(field.type_name)
+        # Every value: a fixed list cut short is a guess the caller cannot check.
+        kind = " | ".join(str(item) for item in enum) if enum else _short_type(field.type_name)
         rendered.append(f"{label} ({kind})" if kind else label)
         if len(rendered) == 12 and len(fields) > 12:
             rendered.append(f"... {len(fields) - 12} more (schema get {command_id})")
@@ -1396,7 +1490,8 @@ def _short_type(type_name: str) -> str:
     text = str(type_name or "")
     if "condition." in text:
         return "condition"
-    return " | ".join(part.strip().rsplit(".", 1)[-1] for part in text.split("|"))[:40]
+    # Drop each dotted module path but keep the brackets around it (``list[a.b.C]``).
+    return re.sub(r"(?:\w+\.)+(\w+)", r"\1", " | ".join(p.strip() for p in text.split("|")))[:60]
 
 
 def _command_records() -> list[dict[str, Any]]:
@@ -1607,6 +1702,10 @@ def _load_top_level_group(name: str) -> Any:
 # would import the handler's module (and its SDK dependencies). A test pins this
 # table to :func:`_command_help` so it cannot drift.
 _ROOT_LEAF_HELP: dict[str, str] = {
+    "capabilities": (
+        "List what the CLI cannot do yet, and what to do instead."
+        "\n\nExample: mammoth capabilities"
+    ),
     "calc": (
         "Evaluate one arithmetic expression exactly."
         "\n\nExample: mammoth calc '2063664 - 1917815'"
@@ -1615,6 +1714,10 @@ _ROOT_LEAF_HELP: dict[str, str] = {
         "Run environment and connectivity diagnostics."
         "\n\nExample: mammoth doctor\n\nInput fields: wait (int)"
     ),
+    "how": (
+        "Turn a plain-language goal into an ordered recipe of commands."
+        "\n\nExample: mammoth how 'refresh a dataset daily'"
+    ),
     "link": (
         "Read the workspace, project, folder, dataset and view ids out of a pasted app URL."
         "\n\nExample: mammoth link https://app.mammoth.io/workspaces/1/projects/2/data/datasets"

{mammoth_cli-2.2.85 → mammoth_cli-2.2.86}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.2.16
+version: 2.2.86
 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."
 ---
 
@@ -67,6 +67,7 @@ State the goal in plain words;
 `view transform --help` is the Transform menu with one line per task:
 
 ```bash
+mammoth how "blend two files by day"       # ordered steps, multi-step goal
 mammoth schema find "merge two datasets"   # -> view.transform.join
 mammoth view transform --help              # every data transformation
 mammoth schema find "join two datasets; remove duplicates; build a dashboard"   # 1 call, 1 result per goal
@@ -93,15 +94,15 @@ mammoth schema find "join two datasets; remove duplicates; build a dashboard"
 
 Call a find result (or `suggestions` entry) from its `accepted_fields` and
 `agent_example`. Before concluding the CLI cannot do something the web app
-does, check `view transform --help` and "View settings, and what has no
+does, run `mammoth capabilities` (known gaps) and check
+`view transform --help` and "View settings, and what has no
 command" in [about Mammoth](references/about-mammoth.md). Do not switch to
 the browser, or compute locally, for work the CLI covers; report a real gap
 with the command 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 building:
+Users often upload related files without saying how they relate. Work it out from the data before building:
 
 1. Upload every file, or find the ones already uploaded. An upload result
    carries a `view` preview of what Mammoth made of it (`view_id`, column
@@ -109,7 +110,7 @@ dashboard from t_a and t_b"). Work it out from the data before building:
    data get VIEW_ID` per view; warnings list numbers/dates stored as text,
    and blanks, each with its fix.
 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
+   the other (`customer_id` and `id`) is a
    foreign key; the view with many rows per key is the main one.
 3. Read both key columns, then match the keys: same type (`convert-type`), same
    case and padding (`text`), no blanks (`set-values`, `filter`).
@@ -131,8 +132,7 @@ dashboard from t_a and t_b"). Work it out from the data before building:
    revenue, not a unit price. Fix each `deliverable_check` warning, or say
    why not.
 
-For the defaults that most pipelines use (new column or overwrite, `LEFT`
-joins, date steps), see
+For common pipeline defaults, see
 [transforms](references/recipes/transforms.md#what-most-pipelines-look-like).
 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.
@@ -141,7 +141,7 @@ your report. If no column links the files, ask before you combine them.
 
 - Ids are positionals; request fields are one `--input '{...}'` document;
   no per-field flags (`project create NAME`, not `--name`).
-- `COMMAND --help` lists input fields; `schema find WORDS` inlines
+- `COMMAND --help` lists input fields and allowed values; `schema find WORDS` inlines
   `accepted_fields`/`agent_example` for top matches, else `schema get
   ID,ID` (one call; `--input '{"full": true}'` for all
   fields); `schema list`/`schema list view` list families.

{mammoth_cli-2.2.85 → mammoth_cli-2.2.86}/mammoth_cli/bundled_skill/mammoth-cli/references/auth.md

@@ -6,17 +6,21 @@ Login accepts nothing else. If `auth status` reports `credential: key_secret`
 (a profile saved by an older CLI), it still works, but ask the operator to run
 `mammoth auth login` again with a token.
 
-A token may be limited to one project. It then gets HTTP 403
-`authorization_required` in every other project, including a project it has
-created. When that happens, stop creating projects: ask the operator which
-project the token belongs to and pass `--project ID`, or ask for a token
-created without a project.
+A token may be limited to one project, and a browser or device sign-in to one
+or several. It then gets HTTP 403 `authorization_required` in every other
+project, including a project it has created. When that happens, stop creating
+projects: `mammoth auth status --check` lists them in `token_projects`; pass one
+as `--project ID`, or ask for a token created without a project.
 
 ## Browser sign-in
 
 `mammoth auth login --method oauth` signs the operator in through the browser (PKCE, loopback
 `127.0.0.1`). The CLI keeps a 1 h `mm_` token and refreshes it under a file lock. `auth status`
-reports `credential: oauth` and `expires_at`. A refresh that fails exits 4 with `login_expired`:
+reports `credential: oauth` and `access_token_expires_at` (`expires_at` is the same value, kept for
+compatibility). That is when the 1 h access token ends, not when the login does: `refreshes_automatically: true`.
+Only a failed refresh needs a new login. `auth status --check` also adds `workspace_name` and, for a
+project-limited token, `token_project_name` (`token_projects` lists every project it is
+limited to; `token_project` is the lowest). A refresh that fails exits 4 with `login_expired`:
 tell the operator to run `mammoth auth login` again. `--no-browser` prints the URL. `--device` is the sign-in for a
 machine with no browser: it prints a short code and a URL for the operator to approve on another
 device, then polls. An agent may run `mammoth auth login --device` (and only that): it prints the

{mammoth_cli-2.2.85 → mammoth_cli-2.2.86}/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 753 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 781 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.85 → mammoth_cli-2.2.86}/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 753; 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 781; 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:
 
@@ -15,9 +15,10 @@ Load only the applicable domain file:
 - [billing](commands/billing.md) — 25 published commands
 - [browse](commands/browse.md) — 9 published commands
 - [calc](commands/calc.md) — 1 published commands
+- [capabilities](commands/capabilities.md) — 1 published commands
 - [capability](commands/capability.md) — 3 published commands
 - [client-app](commands/client-app.md) — 5 published commands
-- [collection](commands/collection.md) — 16 published commands
+- [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
@@ -25,13 +26,16 @@ Load only the applicable domain file:
 - [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](commands/dashboard.md) — 108 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
 - [data-app](commands/data-app.md) — 12 published commands
 - [dataset](commands/dataset.md) — 27 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
 - [folder](commands/folder.md) — 10 published commands
+- [how](commands/how.md) — 1 published commands
 - [job](commands/job.md) — 4 published commands
 - [link](commands/link.md) — 1 published commands
 - [log](commands/log.md) — 2 published commands
@@ -52,7 +56,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) — 103 published commands
+- [view](commands/view.md) — 106 published commands
 - [webhook](commands/webhook.md) — 7 published commands
-- [workflow](commands/workflow.md) — 20 published commands
-- [workspace](commands/workspace.md) — 31 published commands
+- [workflow](commands/workflow.md) — 23 published commands
+- [workspace](commands/workspace.md) — 33 published commands

mammoth_cli-2.2.86/mammoth_cli/bundled_skill/mammoth-cli/references/commands/capabilities.md

@@ -0,0 +1,13 @@
+# `capabilities` 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).
+
+### `capabilities`
+
+Run: `mammoth capabilities`. Exact input fields: `mammoth schema get capabilities`.
+
+Example: `mammoth capabilities`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `CapabilitiesResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.

{mammoth_cli-2.2.85 → mammoth_cli-2.2.86}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/collection.md

@@ -62,6 +62,56 @@ Result: `CollectionDeleteResult`; mutation `destructive`, confirmation `prompt_o
 
 Status on release: untried; no live run recorded.
 
+### `collection.email-updates.get`
+
+Run: `mammoth collection email-updates get`. Exact input fields: `mammoth schema get collection.email-updates.get`.
+
+Example: `mammoth collection email-updates get 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `CollectionEmailUpdatesGetResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `collection.email-updates.me.get`
+
+Run: `mammoth collection email-updates me get`. Exact input fields: `mammoth schema get collection.email-updates.me.get`.
+
+Example: `mammoth collection email-updates me get 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `CollectionEmailUpdatesMeGetResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `collection.email-updates.me.set`
+
+Run: `mammoth collection email-updates me set`. Exact input fields: `mammoth schema get collection.email-updates.me.set`.
+
+Example: `mammoth collection email-updates me set 123 --input '{"subscribed": true}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `CollectionEmailUpdatesMeSetResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `collection.email-updates.set`
+
+Run: `mammoth collection email-updates set`. Exact input fields: `mammoth schema get collection.email-updates.set`.
+
+Example: `mammoth collection email-updates set 123 --input '{"enabled": true, "timezone": "UTC"}' --yes`. Illustrative only: append `--yes` after observing an owned target.
+
+Result: `CollectionEmailUpdatesSetResult`; mutation `external_effect`, confirmation `yes_always`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `collection.email-updates.test`
+
+Run: `mammoth collection email-updates test`. Exact input fields: `mammoth schema get collection.email-updates.test`.
+
+Example: `mammoth collection email-updates test 123 --yes`. Illustrative only: append `--yes` after observing an owned target.
+
+Result: `CollectionEmailUpdatesTestResult`; mutation `external_effect`, confirmation `yes_always`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `collection.files.upload`
 
 Run: `mammoth collection files upload`. Exact input fields: `mammoth schema get collection.files.upload`.