mammoth-cli 2.0.60__tar.gz → 2.0.62__tar.gz

{mammoth_cli-2.0.60 → mammoth_cli-2.0.62}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.0.60
+Version: 2.0.62
 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.29
+Requires-Dist: mammoth-io<0.8,>=0.7.31
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.13
 Requires-Dist: pyyaml<7,>=6

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

{mammoth_cli-2.0.60 → mammoth_cli-2.0.62}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.0.60
+version: 2.0.62
 description: "Use Mammoth Analytics from a terminal: install or authenticate the CLI, discover its live command contract, and safely manage projects, data, views, pipelines (join, merge, pivot, filter, clean), dashboards, exports, and handoffs."
 ---
 

{mammoth_cli-2.0.60 → mammoth_cli-2.0.62}/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 557 commands. 455 of them bind one of the 528 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, 2 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.
+The CLI publishes 567 commands. 455 of them bind one of the 528 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, 2 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.
 
 Status meanings:
 

{mammoth_cli-2.0.60 → mammoth_cli-2.0.62}/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 565; 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 567; 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:
 
@@ -21,7 +21,7 @@ Load only the applicable domain file:
 - [connector](commands/connector.md) — 22 published commands
 - [context](commands/context.md) — 3 published commands
 - [dashboard-qa](commands/dashboard-qa.md) — 13 published commands
-- [dashboard](commands/dashboard.md) — 98 published commands
+- [dashboard](commands/dashboard.md) — 100 published commands
 - [data-app](commands/data-app.md) — 12 published commands
 - [dataset](commands/dataset.md) — 17 published commands
 - [doctor](commands/doctor.md) — 1 published commands

{mammoth_cli-2.0.60 → mammoth_cli-2.0.62}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/activity.md

@@ -16,8 +16,8 @@ Known restriction: BLOCKED[B19 ACTIVITY_EXPORT_UNTYPED_ASYNC]: format/filters/do
 
 Run: `mammoth activity list`. Exact input fields: `mammoth schema get activity.list`.
 
-Example: `mammoth activity list`. Discovery only: this command is fail-closed and must not dispatch a request.
+Example: `mammoth activity list`. Placeholders are illustrative; resolve IDs and input from observed reads.
 
-Execution is unavailable for the current contract and returns `unsupported_contract`. Do not infer request fields or retry it; use only a separately typed alternative.
+Result: `ActivityListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
 
-Known restriction: BLOCKED[B17 VARIADIC_INPUT_UNTYPED]: **filters is unconstrained; reserved, not registered.
+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. Returned activity_logs scoped to project 41 (our own actions), e.g. View category entries. Single invocation only.

{mammoth_cli-2.0.60 → mammoth_cli-2.0.62}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/dashboard.md

@@ -52,6 +52,26 @@ Result: `TwbAssessResponse`; mutation `read`, confirmation `none`, wait policy `
 
 Status on release: untried; no live run recorded.
 
+### `dashboard.bi-export`
+
+Run: `mammoth dashboard bi-export`. Exact input fields: `mammoth schema get dashboard.bi-export`.
+
+Example: `mammoth dashboard bi-export 123 --input '{"target": "powerbi"}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DashboardBiExportResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `dashboard.bi-preflight`
+
+Run: `mammoth dashboard bi-preflight`. Exact input fields: `mammoth schema get dashboard.bi-preflight`.
+
+Example: `mammoth dashboard bi-preflight 123 --input '{"target": "powerbi"}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `PowerBiPreflightResponse`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `dashboard.cancel-generation`
 
 Run: `mammoth dashboard cancel-generation`. Exact input fields: `mammoth schema get dashboard.cancel-generation`.

{mammoth_cli-2.0.60 → mammoth_cli-2.0.62}/mammoth_cli/commands/dashboard.py

@@ -11,7 +11,7 @@ SDK method named by the command's reviewed manifest ``sdk_symbol``.
 from __future__ import annotations
 
 from pathlib import Path
-from typing import Any
+from typing import Any, Literal, cast
 
 from mammoth.models.dashboards import AddPagesSpec
 from pydantic import ValidationError
@@ -23,11 +23,12 @@ from mammoth_cli.errors.envelope import (
     CODE_MISSING_ARGUMENT,
     CODE_MISSING_FIELD,
     CODE_SDK_SYMBOL_UNRESOLVED,
+    CODE_UNSUPPORTED_CONTRACT,
     EXIT_USAGE,
     CliError,
 )
 from mammoth_cli.manifest.loader import command_by_id
-from mammoth_cli.runtime import parents
+from mammoth_cli.runtime import embedded, parents
 from mammoth_cli.runtime.confirm import (
     POLICY_CONFIRM_TARGET,
     POLICY_NONE,
@@ -803,3 +804,72 @@ def dashboard_import_workbook(invocation: Invocation) -> HandlerResult:
     with open_service(invocation) as (service, auth):
         data = service.call(_symbol(invocation), file=file_path, project_id=project_id)
     return data, _meta(invocation, auth.workspace_id)
+
+
+# ── BI export (Power BI / Tableau) ───────────────────────────────────────────
+
+_BI_TARGETS: tuple[Literal["powerbi", "tableau"], ...] = ("powerbi", "tableau")
+_BI_EXPORT_EMBEDDED_REFUSAL = (
+    "The file cannot be downloaded from here. Send the user to the dashboard's Publish menu"
+    " (the arrow next to Publish) -> Export to Power BI / Export to Tableau."
+)
+
+
+def _bi_target(document: dict[str, Any]) -> Literal["powerbi", "tableau"]:
+    """Read and validate the required ``target`` input field."""
+    target = document.get("target")
+    if target not in _BI_TARGETS:
+        raise CliError(
+            code=CODE_INVALID_ARGUMENT,
+            message="Input `target` must be 'powerbi' or 'tableau'.",
+            exit_status=EXIT_USAGE,
+            hint='Pass --input \'{"target": "powerbi"}\' or \'{"target": "tableau"}\'.',
+        )
+    return cast(Literal["powerbi", "tableau"], target)
+
+
+def dashboard_bi_preflight(invocation: Invocation) -> HandlerResult:
+    """What a Power BI or Tableau export of this dashboard would carry.
+
+    Side-effect free -- nothing is built and nothing is logged, so the export
+    dialog can be opened and dismissed freely. Required input ``target``
+    (``powerbi`` or ``tableau``) selects which release route answers.
+    """
+    dashboard_id = _require_int_positional(invocation, "dashboard id")
+    document = invocation.load_input() or {}
+    target = _bi_target(document)
+    symbol = f"mammoth.api.dashboards.DashboardsAPI.{target}_preflight"
+    with open_service(invocation) as (service, auth):
+        data = service.call(symbol, dashboard_id=dashboard_id)
+    return data, _meta(invocation, auth.workspace_id)
+
+
+def dashboard_bi_export(invocation: Invocation) -> HandlerResult:
+    """Download this dashboard as a Power BI project (.zip) or Tableau workbook (.twbx).
+
+    Required input ``target`` (``powerbi`` or ``tableau``) selects the release
+    route. With no ``output_path`` the file is written to the current
+    directory under an auto-generated name.
+
+    Embedded (see ``mammoth_cli.runtime.embedded``) it is refused: the route
+    needs the Authorization header, so a link handed to the user's browser
+    401s. The user downloads it from the dashboard's own export dialog.
+    """
+    dashboard_id = _require_int_positional(invocation, "dashboard id")
+    document = invocation.load_input() or {}
+    target = _bi_target(document)
+    if embedded.active():
+        raise CliError(
+            code=CODE_UNSUPPORTED_CONTRACT,
+            message=_BI_EXPORT_EMBEDDED_REFUSAL,
+            exit_status=EXIT_USAGE,
+            hint="Run `dashboard bi-preflight` to tell the user what will convert first.",
+        )
+    symbol = f"mammoth.api.dashboards.DashboardsAPI.export_{target}"
+    kwargs: dict[str, Any] = {"dashboard_id": dashboard_id}
+    _forward_optional(document, kwargs, ("output_path",))
+    with open_service(invocation) as (service, auth):
+        data = service.call(symbol, **kwargs)
+    # The SDK returns a Path; render it as a string so the written location is
+    # visible in every output mode and serializes cleanly to JSON.
+    return {"output_path": str(data)}, _meta(invocation, auth.workspace_id)

{mammoth_cli-2.0.60 → mammoth_cli-2.0.62}/mammoth_cli/commands/registry.py

@@ -376,6 +376,8 @@ HANDLERS: dict[str, Handler] = {
     "dashboard.assess-twb": dashboard_cmd.dashboard_assess_twb,
     "dashboard.assess-pbix": dashboard_cmd.dashboard_assess_pbix,
     "dashboard.import-workbook": dashboard_cmd.dashboard_import_workbook,
+    "dashboard.bi-preflight": dashboard_cmd.dashboard_bi_preflight,
+    "dashboard.bi-export": dashboard_cmd.dashboard_bi_export,
     "dashboard.embed.config.get": dashboard_cmd.generated_dashboard,
     "dashboard.embed.config.set": dashboard_cmd.generated_dashboard,
     "dashboard.embed.key.rotate": dashboard_cmd.generated_dashboard,

{mammoth_cli-2.0.60 → mammoth_cli-2.0.62}/mammoth_cli/commands/schema.py

@@ -106,6 +106,21 @@ _COMMAND_DISCOVERY_PURPOSES = {
     "webhook.delete": "webhook http endpoint api delete",
     "webhook.send": "webhook http endpoint api push send",
     "webhook.send-get": "webhook http endpoint api pull send get",
+    # "What did I ask you about earlier this week?" is a lookup over past
+    # agent conversations. Live-eval evidence: `schema find` on that phrasing
+    # never matched `agent.session.list`/`agent.session.messages` because
+    # neither command's own text says "conversation", "chat", "history", or
+    # "asked" -- and the unrelated per-project `connector.ai.session.*`
+    # family, whose OpenAPI summary literally says "chat session", outranked
+    # them. These two ARE the past-conversation lookup: list the sessions,
+    # then read one's messages.
+    "agent.session.list": (
+        "chat conversation conversations history past previous asked earlier week "
+        "messages sessions"
+    ),
+    "agent.session.messages": (
+        "chat conversation conversations history past previous asked earlier week read"
+    ),
     "workspace.user.add": (
         "invite add member teammate email role editor viewer admin assign permission access"
     ),
@@ -116,6 +131,43 @@ _COMMAND_DISCOVERY_PURPOSES = {
     "client-app.list": (
         "api keys api key secret credentials workspace active script integration list"
     ),
+    # "How much storage am I using, and what plan am I on?" only ever reached
+    # workspace.storage-breakdown -- a paginated per-item list with no total
+    # that pages through every project before giving up. This command's own
+    # text says neither "storage" nor "usage"; it is the one that carries the
+    # actual total (storage_used/current_storage_allowed/plan_storage_value/
+    # max_storage_allowed).
+    "workspace.app-usage": (
+        "storage usage used space how much plan current allowed total quota limit"
+    ),
+    # "Give me this board as a Power BI file" / "open this in Tableau" is the
+    # dashboard-to-BI-file export pair, not `view.export.powerbi`/`.tableau`
+    # (those publish a live ODBC connection for a dataview, not a downloadable
+    # file for a dashboard). Both destinations' vocabulary lives on both
+    # commands: the dialog answers "what will I get" the same way for either
+    # tool (see PowerBiPreflightResponse/TableauPreflightResponse), and the
+    # export downloads whichever the caller names via input `target`.
+    "dashboard.bi-preflight": (
+        "power bi powerbi pbix pbip tableau twb twbx workbook file board open this dashboard "
+        "board in power bi desktop or tableau desktop preview dry run what would convert "
+        "figures rows before downloading export"
+    ),
+    "dashboard.bi-export": (
+        "power bi powerbi pbix pbip tableau twb twbx workbook file board open this dashboard "
+        "board in power bi desktop or tableau desktop download export save project convert"
+    ),
+    # "Bring my old Power BI report in" / "move my dashboards over" is the
+    # workbook-to-Mammoth-dataset import, the opposite direction of
+    # `dashboard.bi-export`. The command id's own tokens ("import",
+    # "workbook") already cover half of this -- "workbook" is deliberately
+    # NOT repeated below: it would double-score (command-id token AND purpose
+    # match) and outrank `dashboard.bi-export`/`.bi-preflight` on the bare
+    # "tableau workbook" phrasing those two must win instead. Only "tableau"
+    # (its own text says neither tool's name) and the migration verbs are new.
+    "dashboard.import-workbook": (
+        "bring in migrate move transfer switch old existing dashboards dashboard over power "
+        "bi report tableau file upload"
+    ),
     "automation.create": (
         "schedule scheduled recurring repeat refresh rerun run every day daily week weekly "
         "hour hourly month monthly automatically trigger alert email a dataset pipeline"
@@ -280,6 +332,18 @@ _DISCOVERY_SYNONYMS: dict[str, tuple[str, ...]] = {
     "api": ("client-app",),
     "key": ("client-app",),
     "keys": ("client-app",),
+    # "What did I ask you earlier?" is a past-conversation lookup: an agent
+    # session. Nothing in `agent.session.list`/`agent.session.messages` text
+    # says "conversation", "chat", or "history", so a query phrased that way
+    # (rather than with the literal word "session") never found them.
+    "conversation": ("session",),
+    "conversations": ("session",),
+    "chat": ("session",),
+    "chats": ("session",),
+    "history": ("session",),
+    "previous": ("session",),
+    "earlier": ("session",),
+    "asked": ("session",),
     # British spellings search the same as the American ones.
     "summarise": ("summarize",),
     "standardise": ("standardize",),
@@ -412,7 +476,16 @@ def _externally_supplied_fields(command_id: str) -> frozenset[str]:
                 if item.falls_back_to_field is None
             }
         )
-    return excluded_input_fields(command_id)
+    excluded = excluded_input_fields(command_id)
+    if command_id == "activity.list":
+        # ``excluded_input_fields`` treats "project_id" as the active-project
+        # context on every command, but here it is an ActivityFiltersSchema
+        # request-body filter (any workspace project, not the active one) --
+        # the command's own contract already admits and forwards it (see
+        # ``_S7_ADDITIONAL_INPUT_FIELDS["activity.list"]``). Only
+        # "workspace_id" is the legacy-admitted, never-forwarded field here.
+        excluded -= {"project_id"}
+    return excluded
 
 
 def _positionals(command_id: str) -> list[dict[str, Any]]:

{mammoth_cli-2.0.60 → mammoth_cli-2.0.62}/mammoth_cli/services/command_contract.py

@@ -14,7 +14,7 @@ from collections.abc import Mapping
 from dataclasses import dataclass
 from functools import cache
 from types import MappingProxyType
-from typing import Any, cast
+from typing import Any, Literal, cast
 
 from mammoth.models.batches import (
     ColumnIdMapping,
@@ -626,6 +626,16 @@ _S7_ADDITIONAL_INPUT_FIELDS: dict[str, tuple[FieldSpec, ...]] = {
         # GLOBAL or WORKSPACE_PREFERENCES.
         FieldSpec("patch", required=False, annotation=list[Any] | None, default=None),
     ),
+    # ``target`` picks which of the two backing SDK methods the handler calls
+    # (powerbi_preflight/tableau_preflight, export_powerbi/export_tableau); it
+    # is CLI-side dispatch, never forwarded into either SDK call, so neither
+    # signature can introspect it.
+    "dashboard.bi-preflight": (
+        FieldSpec("target", required=True, annotation=Literal["powerbi", "tableau"]),
+    ),
+    "dashboard.bi-export": (
+        FieldSpec("target", required=True, annotation=Literal["powerbi", "tableau"]),
+    ),
     # user.update previously pinned name/email here as a guess, from when
     # UserProfileAPI.update took **fields and so had nothing introspectable.
     # The SDK method is now typed (first_name, last_name -- the backend's

{mammoth_cli-2.0.60 → mammoth_cli-2.0.62}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "mammoth-cli"
-version = "2.0.60"
+version = "2.0.62"
 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.7.29,<0.8)",
+    "mammoth-io (>=0.7.31,<0.8)",
     "typer (>=0.27,<0.28)",
     "rich (>=15,<16)",
     "platformdirs (>=4.10,<5)",

{mammoth_cli-2.0.60 → mammoth_cli-2.0.62}/spec/manifests/commands/activity.yaml

@@ -67,6 +67,5 @@ commands:
   - CT-ACTIVITY-LIST-ERROR
   draft_test: null
   undo_test: null
-  known_restrictions: 'BLOCKED[B17 VARIADIC_INPUT_UNTYPED]: **filters is unconstrained; reserved, not
-    registered.'
+  known_restrictions: null
   reviewed_by: primary

{mammoth_cli-2.0.60 → mammoth_cli-2.0.62}/spec/manifests/commands/dashboard.yaml

@@ -156,7 +156,7 @@ commands:
   - mammoth-cli/tests/contract/test_rel341_schema_preserves_release_overlay.py::test_rel341_schema_preserves_release_overlay
   draft_test: null
   undo_test: null
-  known_restrictions: Release snapshot provenance only; unverified against release.
+  known_restrictions: "Release snapshot provenance only; unverified against release. These take a workbook file from the local disk. Inside the Mammoth app the user's file cannot reach the agent: send the user to the dashboard import page at /workspaces/{workspace_id}/publish/import (Publish → Import), where they upload the .pbix/.twb/.twbx themselves."
   reviewed_by: primary
 - command_id: dashboard.assess-twb
   command_path: dashboard assess-twb
@@ -194,7 +194,96 @@ commands:
   - mammoth-cli/tests/contract/test_rel357_schema_preserves_release_overlay.py::test_rel357_schema_preserves_release_overlay
   draft_test: null
   undo_test: null
-  known_restrictions: Release snapshot provenance only; unverified against release.
+  known_restrictions: "Release snapshot provenance only; unverified against release. These take a workbook file from the local disk. Inside the Mammoth app the user's file cannot reach the agent: send the user to the dashboard import page at /workspaces/{workspace_id}/publish/import (Publish → Import), where they upload the .pbix/.twb/.twbx themselves."
+  reviewed_by: primary
+- command_id: dashboard.bi-preflight
+  command_path: dashboard bi-preflight
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - PowerbiPreflight
+  - TableauPreflightHandler
+  positionals:
+  - name: dashboard_id
+    type: int
+    required: true
+    metavar: DASHBOARD_ID
+    falls_back_to_field: null
+    help: ID of the dashboard.
+  options: []
+  sdk_symbol: mammoth.api.dashboards.DashboardsAPI.powerbi_preflight
+  sdk_conversion: Call mammoth.api.dashboards.DashboardsAPI.powerbi_preflight or .tableau_preflight,
+    chosen by input `target`, with validated request fields.
+  request_model: DashboardBiPreflightRequest
+  result_model: PowerBiPreflightResponse
+  mutation_class: read
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: contract_only_no_disposable_fixture
+  live_test: null
+  live_exemption_reason: Release-only supplemental binding; no disposable fixture.
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth dashboard bi-preflight DASHBOARD_ID --help
+  agent_example: 'mammoth dashboard bi-preflight 123 --input ''{"target": "powerbi"}'''
+  unit_tests:
+  - mammoth-cli/tests/unit/commands/test_dashboard.py::test_bi_preflight_dispatches_powerbi
+  - mammoth-cli/tests/unit/commands/test_dashboard.py::test_bi_preflight_dispatches_tableau
+  - mammoth-cli/tests/unit/commands/test_dashboard.py::test_bi_preflight_rejects_unknown_target_value_without_a_request
+  contract_tests:
+  - mammoth-cli/tests/contract/test_rel360_bi_export.py::test_rel360_schema_preserves_release_overlay
+  draft_test: null
+  undo_test: null
+  known_restrictions: Release snapshot provenance only; unverified against release. Author-only,
+    like the release routes it calls -- a non-author caller is refused, unlike `dashboard pdf export`
+    (which any viewer can run).
+  reviewed_by: primary
+- command_id: dashboard.bi-export
+  command_path: dashboard bi-export
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - PowerbiExport
+  - TableauExport
+  positionals:
+  - name: dashboard_id
+    type: int
+    required: true
+    metavar: DASHBOARD_ID
+    falls_back_to_field: null
+    help: ID of the dashboard.
+  options: []
+  sdk_symbol: mammoth.api.dashboards.DashboardsAPI.export_powerbi
+  sdk_conversion: Call mammoth.api.dashboards.DashboardsAPI.export_powerbi or .export_tableau, chosen
+    by input `target`, with validated request fields.
+  request_model: DashboardBiExportRequest
+  result_model: DashboardBiExportResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: contract_only_no_disposable_fixture
+  live_test: null
+  live_exemption_reason: Release-only supplemental binding; no disposable fixture.
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth dashboard bi-export DASHBOARD_ID --help
+  agent_example: 'mammoth dashboard bi-export 123 --input ''{"target": "powerbi"}'''
+  unit_tests:
+  - mammoth-cli/tests/unit/commands/test_dashboard.py::test_bi_export_writes_file_in_terminal_mode
+  - mammoth-cli/tests/unit/commands/test_dashboard.py::test_bi_export_embedded_points_user_to_export_dialog
+  contract_tests:
+  - mammoth-cli/tests/contract/test_rel361_bi_export.py::test_rel361_schema_preserves_release_overlay
+  draft_test: null
+  undo_test: null
+  known_restrictions: "Release snapshot provenance only; unverified against release. Author-only, like
+    bi-preflight. Terminal mode writes `output_path` to local disk. Inside the Mammoth app the
+    download cannot reach the user: run `dashboard bi-preflight` to tell them what will convert,
+    then send them to the dashboard's Publish menu (the arrow next to Publish) -> Export to Power
+    BI / Export to Tableau, where they download the file themselves."
   reviewed_by: primary
 - command_id: dashboard.cancel-generation
   command_path: dashboard cancel-generation
@@ -1382,7 +1471,7 @@ commands:
   - mammoth-cli/tests/contract/test_rel340_schema_preserves_release_overlay.py::test_rel340_schema_preserves_release_overlay
   draft_test: null
   undo_test: null
-  known_restrictions: Release snapshot provenance only; unverified against release.
+  known_restrictions: "Release snapshot provenance only; unverified against release. These take a workbook file from the local disk. Inside the Mammoth app the user's file cannot reach the agent: send the user to the dashboard import page at /workspaces/{workspace_id}/publish/import (Publish → Import), where they upload the .pbix/.twb/.twbx themselves."
   reviewed_by: primary
 - command_id: dashboard.job-by-url
   command_path: dashboard job-by-url

{mammoth_cli-2.0.60 → mammoth_cli-2.0.62}/spec/manifests/commands/workspace.yaml

@@ -427,7 +427,9 @@ commands:
   - CT-WORKSPACE-STORAGE-BREAKDOWN-ERROR
   draft_test: null
   undo_test: null
-  known_restrictions: null
+  known_restrictions: This is a paginated per-item list of storage-consuming resources (limit/offset);
+    it carries no workspace total and can page through thousands of items. For the workspace's total
+    storage used/allowed, use `workspace app-usage` instead.
   reviewed_by: primary
 - command_id: workspace.update
   command_path: workspace update

{mammoth_cli-2.0.60 → mammoth_cli-2.0.62}/spec/manifests/sdk-catalog.source.yaml

@@ -267,7 +267,6 @@ sdk_methods:
   wait_policy: not_async
   pagination_policy: offset
   openapi_operation_ids: []
-  notes: 'BLOCKED[B17 VARIADIC_INPUT_UNTYPED]: **filters is unconstrained; reserved, not registered.'
 - sdk_symbol: mammoth.api.addons.AddonsAPI.add_connector
   canonical_command: addon.connector.add
   alias_of: null
@@ -1447,6 +1446,7 @@ sdk_methods:
   pagination_policy: none
   openapi_operation_ids:
   - AssessTwb
+  notes: "These take a workbook file from the local disk. Inside the Mammoth app the user's file cannot reach the agent: send the user to the dashboard import page at /workspaces/{workspace_id}/publish/import (Publish → Import), where they upload the .pbix/.twb/.twbx themselves."
 - sdk_symbol: mammoth.api.dashboards.DashboardsAPI.assess_pbix
   canonical_command: dashboard.assess-pbix
   mutation_class: read
@@ -1455,6 +1455,7 @@ sdk_methods:
   pagination_policy: none
   openapi_operation_ids:
   - AssessPbix
+  notes: "These take a workbook file from the local disk. Inside the Mammoth app the user's file cannot reach the agent: send the user to the dashboard import page at /workspaces/{workspace_id}/publish/import (Publish → Import), where they upload the .pbix/.twb/.twbx themselves."
 - sdk_symbol: mammoth.api.dashboards.DashboardsAPI.import_workbook
   canonical_command: dashboard.import-workbook
   mutation_class: high_impact
@@ -1464,6 +1465,7 @@ sdk_methods:
   agent_example: mammoth dashboard import-workbook sample.twbx --project 456 --yes --confirm 456 --output json --no-input
   openapi_operation_ids:
   - ImportWorkbookDataset
+  notes: "These take a workbook file from the local disk. Inside the Mammoth app the user's file cannot reach the agent: send the user to the dashboard import page at /workspaces/{workspace_id}/publish/import (Publish → Import), where they upload the .pbix/.twb/.twbx themselves."
 - sdk_symbol: mammoth.api.dashboards.DashboardsAPI.use_template
   canonical_command: dashboard.templates.use
   alias_of: null
@@ -1487,6 +1489,56 @@ sdk_methods:
   wait_policy: always_wait
   pagination_policy: null
   openapi_operation_ids: []
+- sdk_symbol: mammoth.api.dashboards.DashboardsAPI.powerbi_preflight
+  canonical_command: dashboard.bi-preflight
+  alias_of: null
+  mutation_class: null
+  wait_policy: null
+  pagination_policy: null
+  openapi_operation_ids: []
+- sdk_symbol: mammoth.api.dashboards.DashboardsAPI.tableau_preflight
+  canonical_command: null
+  alias_of: null
+  mutation_class: null
+  wait_policy: null
+  pagination_policy: null
+  openapi_operation_ids: []
+  notes: One of two target-specific implementations behind `dashboard bi-preflight` (--input
+    target=tableau); powerbi_preflight is the manifest's representative sdk_symbol.
+- sdk_symbol: mammoth.api.dashboards.DashboardsAPI.powerbi_export_artifact
+  canonical_command: null
+  alias_of: null
+  mutation_class: null
+  wait_policy: null
+  pagination_policy: null
+  openapi_operation_ids: []
+  notes: SDK-only artifact fetch (content_base64) export_powerbi decodes and writes to disk;
+    dashboard bi-export is the reviewed CLI command.
+- sdk_symbol: mammoth.api.dashboards.DashboardsAPI.tableau_export_artifact
+  canonical_command: null
+  alias_of: null
+  mutation_class: null
+  wait_policy: null
+  pagination_policy: null
+  openapi_operation_ids: []
+  notes: SDK-only artifact fetch (content_base64) export_tableau decodes and writes to disk;
+    dashboard bi-export is the reviewed CLI command.
+- sdk_symbol: mammoth.api.dashboards.DashboardsAPI.export_powerbi
+  canonical_command: dashboard.bi-export
+  alias_of: null
+  mutation_class: read
+  wait_policy: not_async
+  pagination_policy: none
+  openapi_operation_ids: []
+- sdk_symbol: mammoth.api.dashboards.DashboardsAPI.export_tableau
+  canonical_command: null
+  alias_of: null
+  mutation_class: read
+  wait_policy: not_async
+  pagination_policy: none
+  openapi_operation_ids: []
+  notes: One of two target-specific implementations behind `dashboard bi-export` (--input
+    target=tableau); export_powerbi is the manifest's representative sdk_symbol.
 - sdk_symbol: mammoth.api.dashboards.DashboardsAPI.published_canvas
   canonical_command: dashboard.published.canvas
   alias_of: null
@@ -3891,6 +3943,9 @@ sdk_methods:
   wait_policy: null
   pagination_policy: null
   openapi_operation_ids: []
+  notes: This is a paginated per-item list of storage-consuming resources (limit/offset); it carries
+    no workspace total and can page through thousands of items. For the workspace's total storage
+    used/allowed, use `workspace app-usage` instead.
 - sdk_symbol: mammoth.api.workspaces.WorkspacesAPI.user_add
   canonical_command: workspace.user.add
   alias_of: null