mammoth-cli 2.0.61__tar.gz → 2.0.63__tar.gz

{mammoth_cli-2.0.61 → mammoth_cli-2.0.63}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.0.61
+Version: 2.0.63
 Summary: Command-line interface for the Mammoth Analytics platform
 Project-URL: homepage, https://mammoth.io
 Project-URL: repository, https://github.com/EdgeMetric/mammothsdk
@@ -17,9 +17,9 @@ 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.30
+Requires-Dist: mammoth-io<0.8,>=0.7.31
 Requires-Dist: platformdirs<5,>=4.10
-Requires-Dist: pydantic<3,>=2.13
+Requires-Dist: pydantic<3,>=2.12.5
 Requires-Dist: pyyaml<7,>=6
 Requires-Dist: rich<16,>=15
 Requires-Dist: tomlkit<0.16,>=0.15.1

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

{mammoth_cli-2.0.61 → mammoth_cli-2.0.63}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.0.61
+version: 2.0.63
 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.61 → mammoth_cli-2.0.63}/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.61 → mammoth_cli-2.0.63}/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.61 → mammoth_cli-2.0.63}/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.61 → mammoth_cli-2.0.63}/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.61 → mammoth_cli-2.0.63}/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.61 → mammoth_cli-2.0.63}/mammoth_cli/commands/schema.py

@@ -140,6 +140,34 @@ _COMMAND_DISCOVERY_PURPOSES = {
     "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"

{mammoth_cli-2.0.61 → mammoth_cli-2.0.63}/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.61 → mammoth_cli-2.0.63}/pyproject.toml

@@ -1,20 +1,20 @@
 [project]
 name = "mammoth-cli"
-version = "2.0.61"
+version = "2.0.63"
 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.30,<0.8)",
+    "mammoth-io (>=0.7.31,<0.8)",
     "typer (>=0.27,<0.28)",
     "rich (>=15,<16)",
     "platformdirs (>=4.10,<5)",
     "tomlkit (>=0.15.1,<0.16)",
     "keyring (>=25.7,<26)",
     "PyYAML (>=6,<7)",
-    "pydantic (>=2.13,<3)",
+    "pydantic (>=2.12.5,<3)",
     "jsonschema (>=4.20)",
 ]
 urls = {homepage = "https://mammoth.io", repository = "https://github.com/EdgeMetric/mammothsdk"}

{mammoth_cli-2.0.61 → mammoth_cli-2.0.63}/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.61 → mammoth_cli-2.0.63}/spec/manifests/sdk-catalog.source.yaml

@@ -1446,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
@@ -1454,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
@@ -1463,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
@@ -1486,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

{mammoth_cli-2.0.61 → mammoth_cli-2.0.63}/spec/manifests/sdk-methods.yaml

@@ -2092,6 +2092,31 @@ methods:
   pagination_policy: none
   secret_fields: []
   reviewed_by: primary
+- sdk_symbol: mammoth.api.dashboards.DashboardsAPI.export_powerbi
+  implementation_origin: mammoth.api.dashboards.DashboardsAPI.export_powerbi
+  signature: 'export_powerbi(self, dashboard_id: ''int'', output_path: ''str | Path | None'' = None) -> ''Path'''
+  openapi_operation_ids: []
+  canonical_command: dashboard.bi-export
+  alias_of: null
+  no_command_reason: null
+  mutation_class: read
+  wait_policy: not_async
+  pagination_policy: none
+  secret_fields: []
+  reviewed_by: primary
+- sdk_symbol: mammoth.api.dashboards.DashboardsAPI.export_tableau
+  implementation_origin: mammoth.api.dashboards.DashboardsAPI.export_tableau
+  signature: 'export_tableau(self, dashboard_id: ''int'', output_path: ''str | Path | None'' = None) -> ''Path'''
+  openapi_operation_ids: []
+  canonical_command: null
+  alias_of: null
+  no_command_reason: One of two target-specific implementations behind `dashboard bi-export`
+    (--input target=tableau); export_powerbi is the manifest's representative sdk_symbol.
+  mutation_class: read
+  wait_policy: not_async
+  pagination_policy: none
+  secret_fields: []
+  reviewed_by: primary
 - sdk_symbol: mammoth.api.dashboards.DashboardsAPI.extract_context
   implementation_origin: mammoth.api.dashboards.DashboardsAPI.extract_context
   signature: 'extract_context(self, body: ''ContextExtractSpec'') -> ''dict[str, Any]'''
@@ -2325,6 +2350,31 @@ methods:
   pagination_policy: null
   secret_fields: []
   reviewed_by: primary
+- sdk_symbol: mammoth.api.dashboards.DashboardsAPI.powerbi_export_artifact
+  implementation_origin: mammoth.api.dashboards.DashboardsAPI.powerbi_export_artifact
+  signature: 'powerbi_export_artifact(self, dashboard_id: ''int'') -> ''dict[str, Any]'''
+  openapi_operation_ids: []
+  canonical_command: null
+  alias_of: null
+  no_command_reason: SDK-only artifact fetch (content_base64) export_powerbi decodes and writes
+    to disk; dashboard bi-export is the reviewed CLI command.
+  mutation_class: null
+  wait_policy: null
+  pagination_policy: null
+  secret_fields: []
+  reviewed_by: primary
+- sdk_symbol: mammoth.api.dashboards.DashboardsAPI.powerbi_preflight
+  implementation_origin: mammoth.api.dashboards.DashboardsAPI.powerbi_preflight
+  signature: 'powerbi_preflight(self, dashboard_id: ''int'') -> ''PowerBiPreflightResponse'''
+  openapi_operation_ids: []
+  canonical_command: dashboard.bi-preflight
+  alias_of: null
+  no_command_reason: null
+  mutation_class: null
+  wait_policy: null
+  pagination_policy: null
+  secret_fields: []
+  reviewed_by: primary
 - sdk_symbol: mammoth.api.dashboards.DashboardsAPI.published_canvas
   implementation_origin: mammoth.api.dashboards.DashboardsAPI.published_canvas
   signature: 'published_canvas(self: ''Any'', url: ''str'') -> ''CanvasResponse'''
@@ -2904,6 +2954,32 @@ methods:
   pagination_policy: none
   secret_fields: []
   reviewed_by: primary
+- sdk_symbol: mammoth.api.dashboards.DashboardsAPI.tableau_export_artifact
+  implementation_origin: mammoth.api.dashboards.DashboardsAPI.tableau_export_artifact
+  signature: 'tableau_export_artifact(self, dashboard_id: ''int'') -> ''dict[str, Any]'''
+  openapi_operation_ids: []
+  canonical_command: null
+  alias_of: null
+  no_command_reason: SDK-only artifact fetch (content_base64) export_tableau decodes and writes
+    to disk; dashboard bi-export is the reviewed CLI command.
+  mutation_class: null
+  wait_policy: null
+  pagination_policy: null
+  secret_fields: []
+  reviewed_by: primary
+- sdk_symbol: mammoth.api.dashboards.DashboardsAPI.tableau_preflight
+  implementation_origin: mammoth.api.dashboards.DashboardsAPI.tableau_preflight
+  signature: 'tableau_preflight(self, dashboard_id: ''int'') -> ''TableauPreflightResponse'''
+  openapi_operation_ids: []
+  canonical_command: null
+  alias_of: null
+  no_command_reason: One of two target-specific implementations behind `dashboard bi-preflight`
+    (--input target=tableau); powerbi_preflight is the manifest's representative sdk_symbol.
+  mutation_class: null
+  wait_policy: null
+  pagination_policy: null
+  secret_fields: []
+  reviewed_by: primary
 - sdk_symbol: mammoth.api.dashboards.DashboardsAPI.take_pending_template
   implementation_origin: mammoth.api.dashboards.DashboardsAPI.take_pending_template
   signature: 'take_pending_template(self) -> ''dict[str, Any]'''