mammoth-cli 2.0.86__tar.gz → 2.0.87__tar.gz

{mammoth_cli-2.0.86 → mammoth_cli-2.0.87}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.0.86
+Version: 2.0.87
 Summary: Command-line interface for the Mammoth Analytics platform
 Project-URL: homepage, https://mammoth.io
 Project-URL: repository, https://github.com/EdgeMetric/mammothsdk
@@ -17,7 +17,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: <3.15,>=3.12
 Requires-Dist: jsonschema>=4.20
 Requires-Dist: keyring<26,>=25.7
-Requires-Dist: mammoth-io<0.8,>=0.7.40
+Requires-Dist: mammoth-io<0.8,>=0.7.41
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.12.5
 Requires-Dist: pyyaml<7,>=6

{mammoth_cli-2.0.86 → mammoth_cli-2.0.87}/mammoth_cli/__init__.py

@@ -6,7 +6,7 @@ not implement a second HTTP client and does not call private SDK members.
 
 from __future__ import annotations
 
-__version__ = "2.0.86"
+__version__ = "2.0.87"
 
 # The versioned machine output envelope contract.
 SCHEMA_VERSION = 1

{mammoth_cli-2.0.86 → mammoth_cli-2.0.87}/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 573; 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 576; 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:
 
@@ -24,7 +24,7 @@ Load only the applicable domain file:
 - [dashboard-qa](commands/dashboard-qa.md) — 13 published commands
 - [dashboard](commands/dashboard.md) — 100 published commands
 - [data-app](commands/data-app.md) — 12 published commands
-- [dataset](commands/dataset.md) — 18 published commands
+- [dataset](commands/dataset.md) — 20 published commands
 - [doctor](commands/doctor.md) — 1 published commands
 - [external-key](commands/external-key.md) — 4 published commands
 - [file](commands/file.md) — 9 published commands
@@ -46,7 +46,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) — 32 published commands
-- [view](commands/view.md) — 89 published commands
+- [view](commands/view.md) — 90 published commands
 - [webhook](commands/webhook.md) — 7 published commands
 - [workflow](commands/workflow.md) — 16 published commands
 - [workspace](commands/workspace.md) — 20 published commands

{mammoth_cli-2.0.86 → mammoth_cli-2.0.87}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/dataset.md

@@ -132,6 +132,26 @@ Result: `DatasetGetResult`; mutation `read`, confirmation `none`, wait policy `n
 
 Status on release: ran once on CLI 2.0.18 — golden-data check 2026-09-19: exit 0 on release with CLI 2.0.18. Single invocation only.
 
+### `dataset.interpretation.confirm`
+
+Run: `mammoth dataset interpretation confirm`. Exact input fields: `mammoth schema get dataset.interpretation.confirm`.
+
+Example: `mammoth dataset interpretation confirm 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DatasetInterpretationConfirmResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `dataset.interpretation.preview`
+
+Run: `mammoth dataset interpretation preview`. Exact input fields: `mammoth schema get dataset.interpretation.preview`.
+
+Example: `mammoth dataset interpretation preview 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DatasetInterpretationPreviewResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `dataset.list`
 
 Run: `mammoth dataset list`. Exact input fields: `mammoth schema get dataset.list`.

{mammoth_cli-2.0.86 → mammoth_cli-2.0.87}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/external-key.md

@@ -6,7 +6,9 @@ Every command returns the standard JSON envelope. On nonzero exit, read the erro
 
 Run: `mammoth external-key create`. Exact input fields: `mammoth schema get external-key.create`.
 
-Example: `mammoth external-key create --input '{"key_type": "open_ai", "key_name": "Revenue report", "secure_key": "sample"}'`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+Example: `mammoth external-key create --input /private/path/request.json`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+
+Secret fields: pass the body as `--input FILE` (mode 0600); never inline.
 
 Result: `ExternalKeyCreateResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
 

{mammoth_cli-2.0.86 → mammoth_cli-2.0.87}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/project.md

@@ -26,7 +26,7 @@ Status on release: ran once on CLI 2.0.15 — re-verification 2026-09-18: exit 0
 
 Run: `mammoth project check`. Exact input fields: `mammoth schema get project.check`.
 
-Example: `mammoth project check 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+Example: `mammoth project check 123 456`. Placeholders are illustrative; resolve IDs and input from observed reads.
 
 Result: `ProjectCheckResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
 

{mammoth_cli-2.0.86 → mammoth_cli-2.0.87}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/view.md

@@ -252,6 +252,16 @@ Result: `ViewDataGetResult`; mutation `read`, confirmation `none`, wait policy `
 
 Status on release: ran once on CLI 2.0.28 — ILG simulation 2026-09-19: exit 0 on release with CLI 2.0.28. Paged reads (limit up to 500) used for every value check; envelope data.data rows keyed by display name. Single invocation only.
 
+### `view.data.profile`
+
+Run: `mammoth view data profile`. Exact input fields: `mammoth schema get view.data.profile`.
+
+Example: `mammoth view data profile 123 --input '{"target": "Churn"}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `ViewDataProfileResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `view.data.query`
 
 Run: `mammoth view data query`. Exact input fields: `mammoth schema get view.data.query`.

{mammoth_cli-2.0.86 → mammoth_cli-2.0.87}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/workspace.md

@@ -138,7 +138,7 @@ Status on release: untried; no live run recorded.
 
 Run: `mammoth workspace user add`. Exact input fields: `mammoth schema get workspace.user.add`.
 
-Example: `mammoth workspace user add --yes --input '{"email_ids": ["analyst@example.com"]}'`. Illustrative only: append `--yes` after observing an owned target.
+Example: `mammoth workspace user add --input '{"email_ids": ["analyst@example.com"]}' --yes`. Illustrative only: append `--yes` after observing an owned target.
 
 Result: `WorkspaceUserAddResult`; mutation `benign_mutation`, confirmation `yes_always`, wait policy `not_async`.
 

{mammoth_cli-2.0.86 → mammoth_cli-2.0.87}/mammoth_cli/commands/dashboard.py

@@ -39,6 +39,7 @@ from mammoth_cli.runtime.confirm import (
 from mammoth_cli.runtime.invocation import Invocation
 from mammoth_cli.runtime.session import open_service, require_project, resolved_project
 from mammoth_cli.services.argspec import arg_spec
+from mammoth_cli.services.board_values import board_values, dashboard_link
 from mammoth_cli.services.command_contract import bind_command_inputs
 from mammoth_cli.services.dashboard_pages import check_added_pages
 from mammoth_cli.services.dashboard_review import (
@@ -670,9 +671,38 @@ def generated_dashboard(invocation: Invocation) -> HandlerResult:
             data = check_added_pages(service, positionals["dashboard_id"], requested, data)
         if invocation.command_id in _REVIEWED_COMMANDS:
             data = _with_deliverable_check(invocation, service, auth, positionals, data)
+        if invocation.command_id in _VALUED_COMMANDS:
+            data = _with_board_values(service, auth, positionals, data)
     return data, _meta(invocation, auth.workspace_id)
 
 
+#: Board-building steps whose result carries the evaluated card/tile numbers.
+_VALUED_COMMANDS = frozenset({"dashboard.v3.generate", "dashboard.chat.edit"})
+
+
+def _with_board_values(service: Any, auth: Any, positionals: dict[str, Any], data: Any) -> Any:
+    """Add ``dashboard_link`` and each KPI card's and tile's evaluated number.
+
+    The result of a build/edit is definitions; the agent must see the numbers
+    it is about to report (a rate that reads 21.9% where the data says 14.9%).
+    """
+    data = _dump_model(data)
+    if not isinstance(data, dict):
+        return data
+    dashboard_id = positionals.get("dashboard_id") or data.get("id") or data.get("dashboard_id")
+    if not isinstance(dashboard_id, int):
+        return {**data, "values": {"unavailable": "the result names no dashboard id"}}
+    return {
+        **data,
+        "dashboard_link": dashboard_link(auth.base_url, auth.workspace_id, dashboard_id),
+        "values": board_values(service, dashboard_id),
+    }
+
+
+def _dump_model(value: Any) -> Any:
+    return value.model_dump(mode="json") if hasattr(value, "model_dump") else value
+
+
 #: Authoring steps whose result carries ``deliverable_check``.
 _REVIEWED_COMMANDS = frozenset(
     {"dashboard.create-blank", "dashboard.canvas.save", "dashboard.pages.add"}

{mammoth_cli-2.0.86 → mammoth_cli-2.0.87}/mammoth_cli/commands/dataset.py

@@ -30,6 +30,7 @@ from mammoth_cli.runtime.confirm import (
 from mammoth_cli.runtime.invocation import Invocation
 from mammoth_cli.runtime.new_data import with_file_upload_path
 from mammoth_cli.runtime.session import open_service, require_project
+from mammoth_cli.services.listing import DATASET_LIST_FIELDS, dataset_summary, fit_budget
 
 HandlerResult = tuple[Any, dict[str, Any]]
 
@@ -192,16 +193,49 @@ def dataset_find(invocation: Invocation) -> HandlerResult:
 
 
 def dataset_list(invocation: Invocation) -> HandlerResult:
-    """List datasets in the active project."""
+    """List datasets in the active project, newest first, each with what tells them apart.
+
+    Every item carries its size, created/updated time, how its data arrived, and
+    its column names and types (from the list route's stored ``stats``,
+    ``sources`` and ``data_schema``), cut to fit the agent tool output cap.
+    ``full: true`` returns the raw ``{id, name}`` list instead.
+    """
     project_id = require_project(invocation)
     document = invocation.load_input() or {}
     kwargs: dict[str, Any] = {"project_id": project_id}
     _forward_optional(document, kwargs, ("limit", "offset", "sort"))
+    compact = not document.get("full")
+    if compact:
+        kwargs["fields"] = DATASET_LIST_FIELDS
     with open_service(invocation) as (service, auth):
         data = service.call(_symbol(invocation), **kwargs)
+    if compact:
+        data = _compact_dataset_list(data, kwargs.get("offset", 0), kwargs.get("sort"))
     return data, _meta(invocation, auth.workspace_id, project_id)
 
 
+def _compact_dataset_list(data: Any, offset: int, sort: str | None) -> Any:
+    """Summarise a dataset-list page and fit it to the tool output cap."""
+    datasets = data.get("datasets") if isinstance(data, dict) else None
+    if not isinstance(datasets, list):
+        return data
+    summaries = [dataset_summary(item) for item in datasets if isinstance(item, dict)]
+    kept, omitted = fit_budget(summaries)
+    result: dict[str, Any] = {
+        "datasets": kept,
+        "shown": len(kept),
+        "order": sort or "newest first (created_at desc)",
+        "note": (
+            "A dataset record holds no sample values; 'view list DATASET_ID' shows "
+            "stored sample_values per view."
+        ),
+    }
+    if omitted or data.get("next"):
+        result["more"] = True
+        result["next_offset"] = int(offset) + len(kept)
+    return result
+
+
 def _export_write_hint(data: dict[str, Any]) -> str | None:
     """Name the recurring export that writes into this dataset, if any.
 
@@ -395,6 +429,34 @@ def dataset_file_settings_undo(invocation: Invocation) -> HandlerResult:
     return data, _meta(invocation, auth.workspace_id, project_id)
 
 
+_INTERPRETATION_FIELDS = ("user_instruction", "structure_map", "destination_dataset_id")
+
+
+def dataset_interpretation(invocation: Invocation) -> HandlerResult:
+    """Preview or confirm how a file that can be read several ways is interpreted.
+
+    ``--input`` carries ``user_instruction`` (plain English, e.g. one of the
+    suggestions ``dataset get`` shows), a ``structure_map`` from an earlier
+    preview, or a ``destination_dataset_id``; at least one is required.
+    """
+    project_id = require_project(invocation)
+    dataset_id = _require_int_positional(invocation, "dataset id")
+    document = invocation.load_input() or {}
+    kwargs: dict[str, Any] = {"dataset_id": dataset_id, "project_id": project_id}
+    _forward_optional(document, kwargs, _INTERPRETATION_FIELDS)
+    if not any(field in kwargs for field in _INTERPRETATION_FIELDS):
+        raise CliError(
+            code=CODE_MISSING_ARGUMENT,
+            message="Say how to read the file: pass one of " + ", ".join(_INTERPRETATION_FIELDS),
+            exit_status=EXIT_USAGE,
+            hint="Use a suggestion from 'mammoth dataset get DATASET_ID' "
+            "(additional_info.interpretation.instruction_suggestions) as user_instruction.",
+        )
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), **kwargs)
+    return data, _meta(invocation, auth.workspace_id, project_id)
+
+
 def dataset_create(invocation: Invocation) -> HandlerResult:
     """Create a dataset from a spec and creation type (required ``--input`` fields)."""
     project_id = require_project(invocation)

{mammoth_cli-2.0.86 → mammoth_cli-2.0.87}/mammoth_cli/commands/job.py

@@ -26,6 +26,7 @@ from mammoth_cli.errors.envelope import (
 from mammoth_cli.manifest.loader import command_by_id
 from mammoth_cli.runtime.invocation import Invocation
 from mammoth_cli.runtime.session import open_service
+from mammoth_cli.services.board_values import board_values, dashboard_link
 
 HandlerResult = tuple[Any, dict[str, Any]]
 
@@ -169,7 +170,7 @@ def job_wait(invocation: Invocation) -> HandlerResult:
     symbol, kwargs = _wait_call(invocation, document, kwargs)
     try:
         with open_service(invocation) as (service, auth):
-            data = _wait_result(job_id, service.call(symbol, **kwargs))
+            data = _with_board(service, auth, _wait_result(job_id, service.call(symbol, **kwargs)))
     except KeyboardInterrupt as exc:
         # Keep the explicit handle even when the polling implementation raises
         # a bare SIGINT.  A caller can inspect/resume it without replaying the
@@ -186,6 +187,25 @@ def job_wait(invocation: Invocation) -> HandlerResult:
     return data, _meta(invocation, auth.workspace_id)
 
 
+#: Jobs that build a board. A build that outlived its own wait hands back a running
+#: job; waiting on it here must report what the build would have: the board's link
+#: and its evaluated numbers (UQA-RT2-05).
+_BOARD_BUILD_OPERATIONS = frozenset({"generate_dashboard_v3"})
+
+
+def _with_board(service: Any, auth: Any, data: dict[str, Any]) -> dict[str, Any]:
+    """Add ``dashboard_link`` and the board's evaluated numbers to a finished board build."""
+    result = data.get("result")
+    board = result.get("id") if isinstance(result, dict) else None
+    if data.get("operation") not in _BOARD_BUILD_OPERATIONS or not isinstance(board, int):
+        return data
+    return {
+        **data,
+        "dashboard_link": dashboard_link(auth.base_url, auth.workspace_id, board),
+        "values": board_values(service, board),
+    }
+
+
 def job_wait_many(invocation: Invocation) -> HandlerResult:
     """Block until several jobs complete, or raise on failure/timeout.
 

{mammoth_cli-2.0.86 → mammoth_cli-2.0.87}/mammoth_cli/commands/project.py

@@ -563,13 +563,37 @@ def _report_line(where: str, warning: dict[str, Any]) -> str:
     return f"{subject}: {warning.get('issue')}. {warning.get('detail', '')}".strip()
 
 
+def _scoped_dataset_id(invocation: Invocation) -> int | None:
+    """The DATASET_ID that narrows ``project check`` to one dataset, or None."""
+    raw = invocation.positional("dataset_id")
+    if raw is None:
+        return None
+    try:
+        return int(raw)
+    except ValueError as exc:
+        raise CliError(
+            code=CODE_INVALID_ARGUMENT,
+            message=f"The dataset id argument '{raw}' is not an integer.",
+            exit_status=EXIT_USAGE,
+        ) from exc
+
+
+def _datasets_to_check(service: Any, project_id: int, scoped: int | None) -> list[Any]:
+    """Every dataset of the project, or only the named one -- never a walk when scoped."""
+    if scoped is not None:
+        return [{"id": scoped, "name": f"dataset {scoped}"}]
+    listing = service.call(_DATASETS_LIST_SYMBOL, project_id=project_id)
+    return listing.get("datasets", []) if isinstance(listing, dict) else []
+
+
 def project_check(invocation: Invocation) -> HandlerResult:
     """List what a report on this project must still account for.
 
     Read-only local composite, run before reporting: for each dataset, the
     first view's ``column_warnings`` and ``before_dashboard``; for each
     dashboard, its ``deliverable_check``. ``to_report`` flattens them into
-    one line per finding. Cold-agent evals (2.0.41) left one column's blanks
+    one line per finding. Given a DATASET_ID it reads only that dataset's first
+    view (no dataset list, no dashboards). Cold-agent evals (2.0.41) left one column's blanks
     undecided in every run, because the warning sat in an earlier result.
     """
     from mammoth_cli.commands.dashboard import _with_deliverable_check
@@ -579,9 +603,9 @@ def project_check(invocation: Invocation) -> HandlerResult:
     views: list[dict[str, Any]] = []
     dashboards: list[dict[str, Any]] = []
     to_report: list[str] = []
+    scoped_dataset = _scoped_dataset_id(invocation)
     with open_service(invocation) as (service, auth):
-        listing = service.call(_DATASETS_LIST_SYMBOL, project_id=project_id)
-        datasets = listing.get("datasets", []) if isinstance(listing, dict) else []
+        datasets = _datasets_to_check(service, project_id, scoped_dataset)
         for dataset in datasets:
             dataset_id = dataset.get("id") if isinstance(dataset, dict) else None
             if not isinstance(dataset_id, int):
@@ -615,7 +639,9 @@ def project_check(invocation: Invocation) -> HandlerResult:
             views.append(entry)
             where = f"view {preview['view_id']} ({dataset.get('name')})"
             to_report += [_report_line(where, w) for w in entry["column_warnings"]]
-        boards = service.call(_DASHBOARDS_LIST_SYMBOL, project_id=project_id)
+        boards = (
+            [] if scoped_dataset else service.call(_DASHBOARDS_LIST_SYMBOL, project_id=project_id)
+        )
         for board in boards if isinstance(boards, list) else []:
             dashboard_id = board.get("id") if isinstance(board, dict) else None
             if not isinstance(dashboard_id, int):
@@ -634,11 +660,11 @@ def project_check(invocation: Invocation) -> HandlerResult:
         "project_id": project_id,
         "views": views,
         "dashboards": dashboards,
-        "to_report": to_report,
-        "note": (
-            "Before you report: fix each finding, or give it one line in the report "
-            "(what you did and why). A finding you do not mention is a miss."
-            if to_report
-            else "Nothing open in the views or dashboards."
+        **(
+            {"scope": {"dataset_id": scoped_dataset, "dashboards": "not checked"}}
+            if scoped_dataset
+            else {}
         ),
+        "to_report": to_report,
+        **({} if to_report else {"note": "Nothing open in the views or dashboards."}),
     }, meta

{mammoth_cli-2.0.86 → mammoth_cli-2.0.87}/mammoth_cli/commands/registry.py

@@ -53,6 +53,7 @@ from mammoth_cli.commands import trash as trash_cmd
 from mammoth_cli.commands import user as user_cmd
 from mammoth_cli.commands import view as view_cmd
 from mammoth_cli.commands import view_ops as view_ops_cmd
+from mammoth_cli.commands import view_profile as view_profile_cmd
 from mammoth_cli.commands import webhook as webhook_cmd
 from mammoth_cli.commands import workflow as workflow_cmd
 from mammoth_cli.commands import workspace as workspace_cmd
@@ -315,6 +316,8 @@ HANDLERS: dict[str, Handler] = {
     "dataset.file-settings.update": dataset_cmd.dataset_file_settings_update,
     "dataset.file-settings.undo": dataset_cmd.dataset_file_settings_undo,
     "dataset.broken-rows.list": dataset_cmd.dataset_broken_rows,
+    "dataset.interpretation.preview": dataset_cmd.dataset_interpretation,
+    "dataset.interpretation.confirm": dataset_cmd.dataset_interpretation,
     "dataset.create": dataset_cmd.dataset_create,
     "dataset.create-from-pdf": dataset_cmd.dataset_create_from_pdf,
     "dataset.rename": dataset_cmd.dataset_rename,
@@ -648,6 +651,7 @@ HANDLERS: dict[str, Handler] = {
     "view.data.aggregate": view_cmd.view_data_aggregate,
     "view.data.compare": view_cmd.view_data_compare,
     "view.data.explore": view_cmd.view_data_explore,
+    "view.data.profile": view_profile_cmd.view_data_profile,
     "view.exportable-config.get": view_cmd.view_exportable_config_get,
     "view.exportable-config.apply": view_cmd.view_exportable_config_apply,
     "view.conditional-format.create": view_cmd.view_conditional_format_create,

{mammoth_cli-2.0.86 → mammoth_cli-2.0.87}/mammoth_cli/commands/schema.py

@@ -42,6 +42,19 @@ _OUTPUT_JSON_NO_INPUT: tuple[str, ...] = ()
 # the published example points at a protected owner-only file instead, so no
 # generated or copied command line ever puts a credential in argv.
 _PROTECTED_INPUT_PATH = "/private/path/request.json"
+# Commands whose useful example the SDK signature cannot express: a distinct
+# second id, an optional-but-central input field, or two views to compare.
+_FIXED_EXAMPLES: dict[str, tuple[tuple[str, ...], dict[str, Any]]] = {
+    "project.check": (("123", "456"), {}),
+    "view.data.profile": (("123",), {"target": "Churn"}),
+    "view.data.compare": (
+        ("111", "222"),
+        {
+            "group_by": ["Campaign"],
+            "aggregations": [{"column": "Spend", "function": "SUM", "as_name": "Spend"}],
+        },
+    ),
+}
 _OPAQUE_EXPERT_COMMANDS = frozenset({"view.task.add", "view.task.preview", "view.task.update"})
 _TYPED_TRANSFORM_ALTERNATIVES = [
     "view.transform.filter",
@@ -311,6 +324,14 @@ _COMMAND_DISCOVERY_PURPOSES = {
     # view.data.explore's own purpose text already uses both for its trend
     # feature.
     "view.data.aggregate": "group and sum totals by month week without changing the pipeline",
+    # Goals stated as "what is in this data" / "why do customers churn": one
+    # whole-view profile answers both, so the phrasing must reach it.
+    "view.data.profile": (
+        "profile explore what is in this data understand a dataset every column blanks missing "
+        "empty nulls distinct unique duplicates dirty inconsistent categories spelling variants "
+        "check look at overview summary statistics churn drivers drive driving feature "
+        "importance correlation which columns predict affect influence the target outcome"
+    ),
     # Goals users state in their own words, one entry per command the agent's
     # system prompt used to spell out by hand.
     "dashboard.suggestion.list": "ideas suggest suggestions what to show put on a board chart",
@@ -1055,6 +1076,17 @@ def runnable_example(
                 *_OUTPUT_JSON_NO_INPUT,
             ]
         )
+    if record["command_id"] in _FIXED_EXAMPLES:
+        positional_samples, sample_input = _FIXED_EXAMPLES[record["command_id"]]
+        return shlex.join(
+            [
+                "mammoth",
+                *record["command_path"].split(),
+                *positional_samples,
+                *(["--input", json.dumps(sample_input)] if sample_input else []),
+                *_OUTPUT_JSON_NO_INPUT,
+            ]
+        )
     if record["command_id"] == "batch.create-spec":
         return shlex.join(
             [
@@ -1215,7 +1247,7 @@ def runnable_example(
         else:
             tokens.extend(["--input", json.dumps(document)])
     tokens.extend(_OUTPUT_JSON_NO_INPUT)
-    if record["command_id"] in {"project.user.update", "data-app.share"}:
+    if record["command_id"] in {"project.user.update", "data-app.share", "workspace.user.add"}:
         # These published high-impact examples must satisfy the same policy
         # their manifests advertise; otherwise discovery emits a command that
         # deterministically fails before dispatch.
@@ -1402,9 +1434,7 @@ def _schema_common(record: dict[str, Any]) -> dict[str, Any]:
     contract_level = (
         "opaque_expert"
         if record["command_id"] in _OPAQUE_EXPERT_COMMANDS
-        else "partially_typed"
-        if opaque_fields
-        else "typed"
+        else "partially_typed" if opaque_fields else "typed"
     )
     return {
         "positionals": _positionals(record["command_id"]),