mammoth-cli 2.2.35__tar.gz → 2.2.37__tar.gz

{mammoth_cli-2.2.35 → mammoth_cli-2.2.37}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.2.35
+Version: 2.2.37
 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.9,>=0.8.18
+Requires-Dist: mammoth-io<0.9,>=0.8.20
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.12.5
 Requires-Dist: pyyaml<7,>=6

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

{mammoth_cli-2.2.35 → mammoth_cli-2.2.37}/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 646 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 652 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.35 → mammoth_cli-2.2.37}/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 646; 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 652; 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) — 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) — 96 published commands
+- [dashboard](commands/dashboard.md) — 98 published commands
 - [data-app](commands/data-app.md) — 12 published commands
 - [dataset](commands/dataset.md) — 22 published commands
 - [doctor](commands/doctor.md) — 1 published commands
@@ -36,7 +36,7 @@ Load only the applicable domain file:
 - [log](commands/log.md) — 2 published commands
 - [notification](commands/notification.md) — 5 published commands
 - [parameter](commands/parameter.md) — 14 published commands
-- [project](commands/project.md) — 24 published commands
+- [project](commands/project.md) — 25 published commands
 - [report](commands/report.md) — 1 published commands
 - [schedule](commands/schedule.md) — 5 published commands
 - [schema](commands/schema.md) — 3 published commands
@@ -49,7 +49,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) — 91 published commands
+- [view](commands/view.md) — 94 published commands
 - [webhook](commands/webhook.md) — 7 published commands
 - [workflow](commands/workflow.md) — 16 published commands
 - [workspace](commands/workspace.md) — 26 published commands

{mammoth_cli-2.2.35 → mammoth_cli-2.2.37}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/dashboard.md

@@ -308,7 +308,7 @@ Run: `mammoth dashboard duplicate`. Exact input fields: `mammoth schema get dash
 
 Example: `mammoth dashboard duplicate 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
 
-Result: `DashboardDuplicateResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+Result: `DashboardDuplicateResult`; mutation `benign_mutation`, confirmation `none`, wait policy `start_or_wait`.
 
 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: id. duplicated D=52 -> D2=54 Single invocation only; no error-path or variant coverage.
 
@@ -562,6 +562,26 @@ Result: `DashboardPagesAddResult`; mutation `high_impact`, confirmation `confirm
 
 Status on release: ran once on CLI 2.0.28 — ILG simulation 2026-09-19: exit 0 on release with CLI 2.0.28. Needs --yes --confirm DASHBOARD_ID. body.params.pages[] takes PageAdd objects (title, focus{kpis}, charts[]); the route runs through the LLM guard and dropped unit.prefix on a money card ('nothing…
 
+### `dashboard.pbix-assess`
+
+Run: `mammoth dashboard pbix-assess`. Exact input fields: `mammoth schema get dashboard.pbix-assess`.
+
+Example: `mammoth dashboard pbix-assess 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DashboardPbixAssessResult`; mutation `read`, confirmation `none`, wait policy `always_wait`.
+
+Status on release: untried; no live run recorded.
+
+### `dashboard.pbix-intent`
+
+Run: `mammoth dashboard pbix-intent`. Exact input fields: `mammoth schema get dashboard.pbix-intent`.
+
+Example: `mammoth dashboard pbix-intent 123 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DashboardPbixIntentResult`; mutation `read`, confirmation `none`, wait policy `always_wait`.
+
+Status on release: untried; no live run recorded.
+
 ### `dashboard.pdf-artifact`
 
 Run: `mammoth dashboard pdf-artifact`. Exact input fields: `mammoth schema get dashboard.pdf-artifact`.

{mammoth_cli-2.2.35 → mammoth_cli-2.2.37}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/project.md

@@ -42,6 +42,16 @@ Result: `ProjectCheckpointListResult`; mutation `read`, confirmation `none`, wai
 
 Status on release: ran once on CLI an earlier release — Bounded release read in project 3 succeeded; empty checkpoint list observed. No Full claim: no non-empty fixture.
 
+### `project.copy`
+
+Run: `mammoth project copy`. Exact input fields: `mammoth schema get project.copy`.
+
+Example: `mammoth project copy 123 'Revenue report'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `ProjectCopyResult`; mutation `benign_mutation`, confirmation `none`, wait policy `always_wait`.
+
+Status on release: untried; no live run recorded.
+
 ### `project.create`
 
 Run: `mammoth project create`. Exact input fields: `mammoth schema get project.create`.

{mammoth_cli-2.2.35 → mammoth_cli-2.2.37}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/view.md

@@ -52,6 +52,16 @@ Result: `ViewAiProfileResult`; mutation `benign_mutation`, confirmation `none`,
 
 Status on release: ran once on CLI 2.0.15 — re-verification 2026-09-18: exit 0 on release with CLI 2.0.15. Fix held: release ProfileGenerationSpec {params:{action}} body accepted; returned real generated insights: {"data":{"insights":{"performance_analysis":{"domain_specific_insights":[...]}}}}. Single…
 
+### `view.analyze`
+
+Run: `mammoth view analyze`. Exact input fields: `mammoth schema get view.analyze`.
+
+Example: `mammoth view analyze 123 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `ViewAnalyzeResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `view.bulk-delete`
 
 Run: `mammoth view bulk-delete`. Exact input fields: `mammoth schema get view.bulk-delete`.
@@ -112,6 +122,16 @@ Result: `ViewCheckpointUpdateResult`; mutation `benign_mutation`, confirmation `
 
 Status on release: ran once on CLI 2.0.18 — fixture-lifecycle sweep 2026-09-19: exit 0 on release with CLI 2.0.18. First attempt sending a full AddCheckpointSpec body (matching create's shape) failed with invalid_input_field_type; update actually needs body.patches[] (CheckpointPatches/CheckPointPatch…
 
+### `view.compare`
+
+Run: `mammoth view compare`. Exact input fields: `mammoth schema get view.compare`.
+
+Example: `mammoth view compare --input '{"pairs": [[1, 2]]}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `ViewCompareResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `view.conditional-format.create`
 
 Run: `mammoth view conditional-format create`. Exact input fields: `mammoth schema get view.conditional-format.create`.
@@ -714,6 +734,16 @@ Result: `ViewListResult`; mutation `read`, confirmation `none`, wait policy `not
 
 Status on release: ran once on CLI 2.0.21 — ergonomics sweep 2026-09-19: exit 0 on release with CLI 2.0.21. Listed dataview 116 (ds_id 94, row_count 3); the parent cache picked up 116 -> 94 so later view commands took the view id alone. Single invocation only.
 
+### `view.optimize`
+
+Run: `mammoth view optimize`. Exact input fields: `mammoth schema get view.optimize`.
+
+Example: `mammoth view optimize 123 123`. Illustrative only: append `--yes` after observing an owned target.
+
+Result: `ViewOptimizeResult`; mutation `reversible_pipeline`, confirmation `prompt_or_yes`, wait policy `start_or_wait`.
+
+Status on release: untried; no live run recorded.
+
 ### `view.parameter-context`
 
 Run: `mammoth view parameter-context`. Exact input fields: `mammoth schema get view.parameter-context`.

{mammoth_cli-2.2.35 → mammoth_cli-2.2.37}/mammoth_cli/commands/dashboard.py

@@ -746,6 +746,36 @@ def generated_dashboard(invocation: Invocation) -> HandlerResult:
     return data, _meta(invocation, auth.workspace_id)
 
 
+def dashboard_duplicate(invocation: Invocation) -> HandlerResult:
+    """Copy a v3 dashboard; with ``target_dataview_id`` also wait for its data swap.
+
+    The result keeps ``id`` and ``swap_job_id`` and adds ``swap_state`` and
+    ``swap_result`` when a swap job was queued.
+    """
+    document = _bound_document(invocation)
+    positionals = _generated_positionals(invocation)
+    kwargs = bind_command_inputs(invocation.command_id, document, **positionals)
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), **kwargs)
+        if hasattr(data, "model_dump"):
+            data = data.model_dump(mode="json")
+        if isinstance(data, dict) and data.get("swap_job_id") is not None:
+            settled = service.wait_if_job({"job_id": data["swap_job_id"]})
+            data = {**data, "swap_state": "success", "swap_result": settled}
+    return data, _meta(invocation, auth.workspace_id)
+
+
+def dashboard_attachment_read(invocation: Invocation) -> HandlerResult:
+    """Run a workbook read on an attachment (intent or assess) and return the job's result."""
+    positionals = _generated_positionals(invocation)
+    with open_service(invocation) as (service, auth):
+        queued = service.call(_symbol(invocation), **positionals)
+        if hasattr(queued, "model_dump"):
+            queued = queued.model_dump(mode="json")
+        data = service.wait_if_job(queued)
+    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"})
 

{mammoth_cli-2.2.35 → mammoth_cli-2.2.37}/mammoth_cli/commands/dataset.py

@@ -804,6 +804,9 @@ def dataset_create(invocation: Invocation) -> HandlerResult:
     dataset_spec = _require_field(document, "dataset_spec")
     ds_creation_type = _require_field(document, "ds_creation_type")
     _require_clone_views(ds_creation_type, dataset_spec)
+    # A clone can land in another project (``dataset_spec.target_project_id``): the
+    # name check and the result's scope are that project's, not the active one's.
+    landing_project_id = _clone_target_project(ds_creation_type, dataset_spec) or project_id
     kwargs: dict[str, Any] = {
         "dataset_spec": dataset_spec,
         "ds_creation_type": ds_creation_type,
@@ -813,15 +816,31 @@ def dataset_create(invocation: Invocation) -> HandlerResult:
     _forward_optional(document, kwargs, ("folder_resource_id",))
     with open_service(invocation) as (service, auth):
         if invocation.dry_run:
-            _predict_final_name(invocation, service, dataset_spec, project_id)
+            _predict_final_name(invocation, service, dataset_spec, landing_project_id)
         data = service.call(_symbol(invocation), **kwargs)
         # ``datasets.create`` returns a bare job handle and never waits. Block on
         # it here (honoring ``--job-timeout``) so the command reports a finished
         # dataset id instead of a job id the caller must poll separately.
         settled = service.wait_if_job(data)
         result = _created_dataset(data, settled)
-        _add_final_name(service, result, dataset_spec, project_id)
-    return result, _meta(invocation, auth.workspace_id, project_id)
+        _add_final_name(service, result, dataset_spec, landing_project_id)
+    return result, _meta(invocation, auth.workspace_id, landing_project_id)
+
+
+def _clone_target_project(ds_creation_type: object, dataset_spec: object) -> int | None:
+    """The clone's ``target_project_id`` (a positive integer), or None when it is not set."""
+    if ds_creation_type != "clone" or not isinstance(dataset_spec, dict):
+        return None
+    target = dataset_spec.get("target_project_id")
+    if target is None:
+        return None
+    if isinstance(target, bool) or not isinstance(target, int) or target <= 0:
+        raise CliError(
+            code=CODE_INVALID_ARGUMENT,
+            message=f"dataset_spec.target_project_id must be a positive integer, got {target!r}.",
+            exit_status=EXIT_USAGE,
+        )
+    return target
 
 
 def _require_clone_views(ds_creation_type: object, dataset_spec: object) -> None:

{mammoth_cli-2.2.35 → mammoth_cli-2.2.37}/mammoth_cli/commands/file.py

@@ -226,16 +226,25 @@ def file_upload(invocation: Invocation) -> HandlerResult:
             hint="Pass the file(s) as positional arguments or a 'files' input field.",
         )
     with open_service(invocation) as (service, auth):
-        data = service.call(_symbol(invocation), **kwargs)
-        # The SDK waits for the upload job and returns the created dataset
-        # id(s) as a bare int/list. When the caller opts out of waiting
-        # (``wait_for_completion: false``) the bare job id is returned unchanged.
+        # When the caller opts out of waiting (``wait_for_completion: false``)
+        # the bare job id is returned unchanged.
         if not document.get("wait_for_completion", True):
+            data = service.call(_symbol(invocation), **kwargs)
             return data, _meta(invocation, auth.workspace_id, resolved_project(invocation))
+        # The SDK waits for the upload job; ``upload_result`` also returns the
+        # files the server refused, which the bare id list of ``upload`` drops.
+        outcome = service.call(_UPLOAD_RESULT_SYMBOL, **kwargs)
+        data = outcome["dataset_ids"]
+        refused = _refused_files(outcome.get("errors"))
+        if outcome.get("errors") and not data:
+            raise _upload_refused_error(outcome["errors"], refused)
         # A finished upload job does not mean a usable dataset: a CSV with an
         # ambiguous date column lands in ``need_action`` with no view. Report
         # the status the platform holds for each dataset, not an assumed one.
         result = _upload_result(data, lambda dataset_id: _dataset_status(service, dataset_id))
+        if refused:
+            result["warnings"] = [_upload_refused_message(outcome["errors"], refused)]
+            result["refused_files"] = refused
         project_id = resolved_project(invocation)
         previewed = 0
         for entry in result["datasets"]:
@@ -290,6 +299,45 @@ def _require_local_files(files: Any) -> None:
             )
 
 
+_UPLOAD_RESULT_SYMBOL = "mammoth.api.files.FilesAPI.upload_result"
+
+#: Workbook files that cannot become datasets; ``dashboard pbix-intent`` reads them.
+_WORKBOOK_SUFFIXES = (".pbix", ".twb", ".twbx")
+_WORKBOOK_HINT = (
+    "Power BI and Tableau workbooks are not datasets: attach the workbook in the chat "
+    "and use `dashboard pbix-intent` to read it."
+)
+
+
+def _refused_files(errors: Any) -> list[str]:
+    """File names the upload job refused, flattened from its ``errors`` map."""
+    if not isinstance(errors, dict):
+        return []
+    names: list[str] = []
+    for value in errors.values():
+        for item in value if isinstance(value, list) else [value]:
+            if isinstance(item, str) and item not in names:
+                names.append(item)
+    return names
+
+
+def _upload_refused_message(errors: dict[str, Any], refused: list[str]) -> str:
+    reasons = ", ".join(sorted(errors))
+    return f"The server refused {', '.join(refused) or 'the upload'} ({reasons})."
+
+
+def _upload_refused_error(errors: dict[str, Any], refused: list[str]) -> CliError:
+    """The error for an upload whose files were all refused (no dataset made)."""
+    workbook = any(name.lower().endswith(_WORKBOOK_SUFFIXES) for name in refused)
+    return CliError(
+        code=CODE_INVALID_ARGUMENT,
+        message=_upload_refused_message(errors, refused) + " No dataset was created.",
+        exit_status=EXIT_USAGE,
+        hint=_WORKBOOK_HINT if workbook else "Upload a supported file type (CSV, Excel, JSON).",
+        details={"errors": errors, "refused_files": refused},
+    )
+
+
 _DATASET_GET_SYMBOL = "mammoth.api.datasets.DatasetsAPI.get"
 
 

{mammoth_cli-2.2.35 → mammoth_cli-2.2.37}/mammoth_cli/commands/project.py

@@ -275,6 +275,34 @@ def project_create(invocation: Invocation) -> HandlerResult:
     return data, _meta(invocation, auth.workspace_id, resolved_project(invocation))
 
 
+def project_copy(invocation: Invocation) -> HandlerResult:
+    """Copy a project into a new one and wait for the copy job.
+
+    ``PROJECT_ID NAME`` are positional; ``dataset_ids``, ``include_dashboards`` and
+    ``exclude_data`` come from ``--input``. The result is the job's:
+    ``project_id``, ``dataset_map``, ``view_map``, ``skipped`` and ``dashboards``.
+    """
+    source_id = _int_positional(invocation, "project id")
+    name = invocation.extra_args[1] if len(invocation.extra_args) > 1 else None
+    if source_id is None or not name:
+        raise CliError(
+            code=CODE_MISSING_ARGUMENT,
+            message="A source project id and a name for the copy are required.",
+            exit_status=EXIT_USAGE,
+            hint="mammoth project copy PROJECT_ID NAME",
+        )
+    document = invocation.load_input() or {}
+    kwargs: dict[str, Any] = {"project_id": source_id, "name": name}
+    _forward_optional(document, kwargs, _COPY_OPTIONAL)
+    with open_service(invocation) as (service, auth):
+        queued = service.call(_symbol(invocation), **kwargs)
+        data = service.wait_if_job(queued)
+    return data, _meta(invocation, auth.workspace_id, source_id)
+
+
+_COPY_OPTIONAL = ("dataset_ids", "include_dashboards", "exclude_data")
+
+
 _ENSURE_CREATE_SYMBOL = "mammoth.api.projects.ProjectsAPI.create"
 
 

{mammoth_cli-2.2.35 → mammoth_cli-2.2.37}/mammoth_cli/commands/registry.py

@@ -266,6 +266,7 @@ HANDLERS: dict[str, Handler] = {
     "project.publish-credentials": project_cmd.project_publish_credentials,
     # project family (mutations)
     "project.create": project_cmd.project_create,
+    "project.copy": project_cmd.project_copy,
     "project.ensure": project_cmd.project_ensure,
     "project.update": project_cmd.project_update,
     "project.delete": project_cmd.project_delete,
@@ -454,6 +455,9 @@ HANDLERS: dict[str, Handler] = {
     "dashboard.qa.insights": dashboard_cmd.generated_dashboard,
     "dashboard.templates.pending": dashboard_cmd.generated_dashboard,
     "dashboard.templates.use": dashboard_cmd.generated_dashboard,
+    "dashboard.duplicate": dashboard_cmd.dashboard_duplicate,
+    "dashboard.pbix-intent": dashboard_cmd.dashboard_attachment_read,
+    "dashboard.pbix-assess": dashboard_cmd.dashboard_attachment_read,
     "dashboard.assess-twb": dashboard_cmd.dashboard_assess_twb,
     "dashboard.assess-pbix": dashboard_cmd.dashboard_assess_pbix,
     "dashboard.import-workbook": dashboard_cmd.dashboard_import_workbook,
@@ -716,6 +720,9 @@ HANDLERS: dict[str, Handler] = {
     "view.restore": view_cmd.view_restore,
     "view.trash": view_cmd.view_trash,
     "view.impact": view_cmd.view_impact,
+    "view.analyze": view_cmd.view_analyze,
+    "view.optimize": view_cmd.view_optimize,
+    "view.compare": view_cmd.view_compare,
     "view.update": view_cmd.view_update,
     "view.data.get": view_cmd.view_data_get,
     "view.data.query": view_cmd.view_data_query,

{mammoth_cli-2.2.35 → mammoth_cli-2.2.37}/mammoth_cli/commands/schema.py

@@ -449,6 +449,12 @@ _COMMAND_DISCOVERY_PURPOSES = {
     "dashboard.context.apply": "apply the reviewed context change to the dashboard",
     "dashboard.qa.insights": "what questions viewers asked on the dashboard grouped unanswered",
     "view.impact": "what breaks if I delete this dataview or a task dependents impact",
+    "view.analyze": "which pipeline steps are wasted duplicate suspended no-op filter move earlier",
+    "view.optimize": "drop wasted pipeline steps hoist filters",
+    "view.compare": "are these two views the same data row counts column differences checksums",
+    "dashboard.pbix-intent": "read an attached Power BI workbook against my view what would map",
+    "dashboard.pbix-assess": "what does an attached Power BI workbook hold",
+    "project.copy": "copy a whole project into a new one datasets views pipelines dashboards",
     "browse.ancestors": "folder path breadcrumb where does this folder live parent folders chain",
     "browse.search": (
         "find search a dataset view folder by name across all projects whole workspace global"

{mammoth_cli-2.2.35 → mammoth_cli-2.2.37}/mammoth_cli/commands/view.py

@@ -906,6 +906,57 @@ def view_impact(invocation: Invocation) -> HandlerResult:
     return data, _meta(invocation, auth.workspace_id, project_id)
 
 
+def view_analyze(invocation: Invocation) -> HandlerResult:
+    """List pipeline steps that can be dropped or moved without changing the result (read-only)."""
+    project_id = require_project(invocation)
+    dataview_id = _require_int_positional_at(invocation, 0, "view id")
+    document = invocation.load_input() or {}
+    with open_service(invocation) as (service, auth):
+        dataset_id = _resolve_dataset_id(service, invocation, dataview_id, document)
+        data = service.call(
+            _symbol(invocation),
+            dataset_id=dataset_id,
+            dataview_id=dataview_id,
+            project_id=project_id,
+        )
+    return data, _meta(invocation, auth.workspace_id, project_id)
+
+
+def view_optimize(invocation: Invocation) -> HandlerResult:
+    """Apply the safe pipeline findings, then wait for the rerun it queued.
+
+    ``apply_rules`` limits the rules applied; omitted, every safe finding is applied.
+    The result keeps the server's ``applied`` / ``skipped`` / step counts and adds
+    ``job_state`` and ``job_result`` when a rerun job was queued.
+    """
+    project_id = require_project(invocation)
+    dataview_id = _require_int_positional_at(invocation, 0, "view id")
+    document = invocation.load_input() or {}
+    enforce_confirmation(
+        invocation,
+        policy=POLICY_PROMPT_OR_YES,
+        action=f"optimize the pipeline of view {dataview_id}",
+    )
+    kwargs: dict[str, Any] = {"dataview_id": dataview_id, "project_id": project_id}
+    _forward_optional(document, kwargs, ("apply_rules",))
+    with open_service(invocation) as (service, auth):
+        kwargs["dataset_id"] = _resolve_dataset_id(service, invocation, dataview_id, document)
+        data = service.call(_symbol(invocation), **kwargs)
+        if isinstance(data, dict) and data.get("job_id") is not None:
+            settled = service.wait_if_job({"job_id": data["job_id"]})
+            data = {**data, "job_state": "success", "job_result": settled}
+    return data, _meta(invocation, auth.workspace_id, project_id)
+
+
+def view_compare(invocation: Invocation) -> HandlerResult:
+    """Compare dataviews pairwise: rows, column differences and checksums (read-only)."""
+    document = invocation.load_input()
+    pairs = _require_field(document, "pairs")
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), pairs=pairs)
+    return data, _meta(invocation, auth.workspace_id, None)
+
+
 def view_update(invocation: Invocation) -> HandlerResult:
     """Rename a view from the name input field; any other patch is refused.
 

{mammoth_cli-2.2.35 → mammoth_cli-2.2.37}/mammoth_cli/runtime/verify.py

@@ -241,6 +241,8 @@ def _verify_and_reason(
         return False, _pipeline_error_reason(pipeline_error)
     if data.get("has_error"):
         return False, "the operation reported an error"
+    if data.get("refused_files"):
+        return False, "the server refused some of the files"
     for status in (data.get("status"), _job_status(data)):
         if isinstance(status, str) and status.lower() in _FAILURE_STATUSES:
             return False, "the operation failed"

{mammoth_cli-2.2.35 → mammoth_cli-2.2.37}/mammoth_cli/services/input_fields.py

@@ -93,6 +93,7 @@ _EXAMPLE_INPUT_HINTS: dict[str, dict[str, Any]] = {
     "dashboard.format-preview": {"style": "presentation"},
     # ``task`` needs a task_id too; the whole-view scope is the one that stands alone.
     "view.impact": {"scope": "view"},
+    "view.compare": {"pairs": [[1, 2]]},
     # One [type, id] pair per resource, as ``browse resources`` lists them.
     "browse.resources.bulk": {"items": [["dataview", 42]]},
     "view.export.azure-blob": {

{mammoth_cli-2.2.35 → mammoth_cli-2.2.37}/mammoth_cli/services/positionals.py

@@ -440,6 +440,13 @@ POSITIONAL_OVERRIDES: dict[str, tuple[PositionalSpec, ...]] = {
             falls_back_to_field="name",
         ),
     ),
+    # project copy: the source project is the resource, the new project's name follows.
+    "project.copy": (
+        PositionalSpec(
+            name="project_id", type=int, required=True, help="ID of the project to copy."
+        ),
+        PositionalSpec(name="name", type=str, required=True, help="Name of the new project."),
+    ),
     # project ensure: exact name to find or create, positional or ``name`` field.
     "project.ensure": (
         PositionalSpec(
@@ -779,6 +786,8 @@ POSITIONAL_OVERRIDES: dict[str, tuple[PositionalSpec, ...]] = {
             "view.restore",
             "view.trash",
             "view.impact",
+            "view.analyze",
+            "view.optimize",
             "view.update",
             "view.conditional-format.create",
             "view.conditional-format.delete-all",

{mammoth_cli-2.2.35 → mammoth_cli-2.2.37}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "mammoth-cli"
-version = "2.2.35"
+version = "2.2.37"
 description = "Command-line interface for the Mammoth Analytics platform"
 authors = [{name = "Mammoth Analytics", email = "support@mammoth.io"}]
 readme = "README.md"
 license = "LicenseRef-Proprietary"
 requires-python = ">=3.12,<3.15"
 dependencies = [
-    "mammoth-io (>=0.8.18,<0.9)",
+    "mammoth-io (>=0.8.20,<0.9)",
     "typer (>=0.27,<0.28)",
     "rich (>=15,<16)",
     "platformdirs (>=4.10,<5)",

{mammoth_cli-2.2.35 → mammoth_cli-2.2.37}/spec/manifests/commands/dashboard.yaml

@@ -1034,7 +1034,7 @@ commands:
   mutation_class: benign_mutation
   edits_target: false
   confirmation: none
-  wait_policy: not_async
+  wait_policy: start_or_wait
   pagination_policy: none
   acceptance_evidence: contract_only_no_disposable_fixture
   readback:
@@ -1058,7 +1058,7 @@ commands:
   - CT-DASHBOARD-DUPLICATE-ERROR
   draft_test: null
   undo_test: null
-  known_restrictions: null
+  known_restrictions: 'Copies the dashboard over the same dataset. Example: mammoth dashboard duplicate 123 --input ''{"target_dataview_id": 456}''. With the target_dataview_id input field the copy is made in that view''s project and its data swap is queued: the command waits for that job and adds swap_state and swap_result next to id and swap_job_id. project_id (optional) names the project for the copy.'
   reviewed_by: primary
 - command_id: dashboard.embed.config.get
   command_path: dashboard embed config get
@@ -5804,3 +5804,91 @@ commands:
     command: dashboard.qa.insights
     ids: {}
     kind: object
+- command_id: dashboard.pbix-intent
+  command_path: dashboard pbix-intent
+  disposition: command
+  alias_of: null
+  operation_ids: []
+  positionals:
+  - name: attachment_id
+    type: int
+    required: true
+    metavar: ATTACHMENT_ID
+    falls_back_to_field: null
+    help: ID of the attachment.
+  - name: target_dataview_id
+    type: int
+    required: true
+    metavar: TARGET_DATAVIEW_ID
+    falls_back_to_field: null
+    help: ID of the target dataview.
+  options: []
+  sdk_symbol: mammoth.api.dashboards.DashboardsAPI.attachment_intent
+  sdk_conversion: Call mammoth.api.dashboards.DashboardsAPI.attachment_intent with validated request fields.
+  request_model: DashboardPbixIntentRequest
+  result_model: DashboardPbixIntentResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: always_wait
+  pagination_policy: none
+  acceptance_evidence: contract_only_no_disposable_fixture
+  live_test: null
+  live_exemption_reason: Backend route ships with this release; no disposable fixture runs it yet.
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth dashboard pbix-intent ATTACHMENT_ID TARGET_DATAVIEW_ID --help
+  agent_example: mammoth dashboard pbix-intent 123 123
+  unit_tests:
+  - UT-DASHBOARD-PBIX-INTENT
+  contract_tests:
+  - CT-DASHBOARD-PBIX-INTENT-HUMAN
+  - CT-DASHBOARD-PBIX-INTENT-JSON
+  - CT-DASHBOARD-PBIX-INTENT-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: 'Read-only. Reads a Power BI workbook the web app already attached (ATTACHMENT_ID)
+    against one of your views (TARGET_DATAVIEW_ID), waits for the job and returns its result: intent,
+    coverage {mapped, total}, unmapped_visuals, field_map and target_dataview_id, or {rejected, source}.
+    No dashboard or sample data is made. Uploading the attachment is done in the web app.'
+  reviewed_by: primary
+- command_id: dashboard.pbix-assess
+  command_path: dashboard pbix-assess
+  disposition: command
+  alias_of: null
+  operation_ids: []
+  positionals:
+  - name: attachment_id
+    type: int
+    required: true
+    metavar: ATTACHMENT_ID
+    falls_back_to_field: null
+    help: ID of the attachment.
+  options: []
+  sdk_symbol: mammoth.api.dashboards.DashboardsAPI.attachment_assess
+  sdk_conversion: Call mammoth.api.dashboards.DashboardsAPI.attachment_assess with validated request fields.
+  request_model: DashboardPbixAssessRequest
+  result_model: DashboardPbixAssessResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: always_wait
+  pagination_policy: none
+  acceptance_evidence: contract_only_no_disposable_fixture
+  live_test: null
+  live_exemption_reason: Backend route ships with this release; no disposable fixture runs it yet.
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth dashboard pbix-assess ATTACHMENT_ID --help
+  agent_example: mammoth dashboard pbix-assess 123
+  unit_tests:
+  - UT-DASHBOARD-PBIX-ASSESS
+  contract_tests:
+  - CT-DASHBOARD-PBIX-ASSESS-HUMAN
+  - CT-DASHBOARD-PBIX-ASSESS-JSON
+  - CT-DASHBOARD-PBIX-ASSESS-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: 'Read-only. Assesses a workbook the web app already attached (ATTACHMENT_ID): waits
+    for the job and returns its result. Use dashboard assess-pbix for a local file.'
+  reviewed_by: primary