mammoth-cli 2.2.7__tar.gz → 2.2.8__tar.gz

{mammoth_cli-2.2.7 → mammoth_cli-2.2.8}/PKG-INFO

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

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

{mammoth_cli-2.2.7 → mammoth_cli-2.2.8}/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 612 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. 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 633 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. 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.7 → mammoth_cli-2.2.8}/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 612; 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 633; 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:
 
@@ -41,7 +41,7 @@ Load only the applicable domain file:
 - [schema](commands/schema.md) — 3 published commands
 - [skill](commands/skill.md) — 7 published commands
 - [snippet](commands/snippet.md) — 8 published commands
-- [support](commands/support.md) — 45 published commands
+- [support](commands/support.md) — 66 published commands
 - [template](commands/template.md) — 5 published commands
 - [trash](commands/trash.md) — 3 published commands
 - [upgrade](commands/upgrade.md) — 1 published commands

{mammoth_cli-2.2.7 → mammoth_cli-2.2.8}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/support.md

@@ -262,6 +262,56 @@ Result: `SupportPlanSelfServeListResult`; mutation `read`, confirmation `none`,
 
 Status on release: ran once on CLI 2.0.15 — admin read sweep 2026-09-18: exit 0 on release with CLI 2.0.15. The CLI gates this GET behind --yes --confirm WORKSPACE_ID (confirm_target policy); with confirmation: exit 0; data.plans Single invocation only.
 
+### `support.plan.storage-option.archive`
+
+Run: `mammoth support plan storage-option archive`. Exact input fields: `mammoth schema get support.plan.storage-option.archive`.
+
+Example: `mammoth support plan storage-option archive 123 123`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+
+Result: `SupportPlanStorageOptionArchiveResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.plan.storage-option.create`
+
+Run: `mammoth support plan storage-option create`. Exact input fields: `mammoth schema get support.plan.storage-option.create`.
+
+Example: `mammoth support plan storage-option create 123 --input '{"storage_gb": 1, "monthly_price": 1.0, "annual_price": 1.0}'`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+
+Result: `SupportPlanStorageOptionCreateResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.plan.storage-option.list`
+
+Run: `mammoth support plan storage-option list`. Exact input fields: `mammoth schema get support.plan.storage-option.list`.
+
+Example: `mammoth support plan storage-option list 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `SupportPlanStorageOptionListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.plan.storage-option.update`
+
+Run: `mammoth support plan storage-option update`. Exact input fields: `mammoth schema get support.plan.storage-option.update`.
+
+Example: `mammoth support plan storage-option update 123 123`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+
+Result: `SupportPlanStorageOptionUpdateResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.plan.unarchive`
+
+Run: `mammoth support plan unarchive`. Exact input fields: `mammoth schema get support.plan.unarchive`.
+
+Example: `mammoth support plan unarchive 123`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+
+Result: `SupportPlanUnarchiveResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `support.plan.update`
 
 Run: `mammoth support plan update`. Exact input fields: `mammoth schema get support.plan.update`.
@@ -312,6 +362,166 @@ Result: `SupportSubscriptionUpdateResult`; mutation `high_impact`, confirmation
 
 Status on release: untried; no live run recorded.
 
+### `support.template.audit`
+
+Run: `mammoth support template audit`. Exact input fields: `mammoth schema get support.template.audit`.
+
+Example: `mammoth support template audit`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `SupportTemplateAuditResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.template.canvas`
+
+Run: `mammoth support template canvas`. Exact input fields: `mammoth schema get support.template.canvas`.
+
+Example: `mammoth support template canvas sample`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `SupportTemplateCanvasResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.template.data-preview`
+
+Run: `mammoth support template data-preview`. Exact input fields: `mammoth schema get support.template.data-preview`.
+
+Example: `mammoth support template data-preview sample`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `SupportTemplateDataPreviewResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.template.discard`
+
+Run: `mammoth support template discard`. Exact input fields: `mammoth schema get support.template.discard`.
+
+Example: `mammoth support template discard sample`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+
+Result: `SupportTemplateDiscardResult`; mutation `destructive`, confirmation `confirm_target`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.template.edit`
+
+Run: `mammoth support template edit`. Exact input fields: `mammoth schema get support.template.edit`.
+
+Example: `mammoth support template edit sample --input '{"changes": {"sample_key": "Status"}}'`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+
+Result: `SupportTemplateEditResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.template.export`
+
+Run: `mammoth support template export`. Exact input fields: `mammoth schema get support.template.export`.
+
+Example: `mammoth support template export sample`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `SupportTemplateExportResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.template.export-dashboard`
+
+Run: `mammoth support template export-dashboard`. Exact input fields: `mammoth schema get support.template.export-dashboard`.
+
+Example: `mammoth support template export-dashboard 123 --input '{"slug": "sample"}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `SupportTemplateExportDashboardResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.template.import`
+
+Run: `mammoth support template import`. Exact input fields: `mammoth schema get support.template.import`.
+
+Example: `mammoth support template import template.zip`. Illustrative only: append `--yes` after observing an owned target.
+
+Result: `SupportTemplateImportResult`; mutation `high_impact`, confirmation `yes_always`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.template.inspect`
+
+Run: `mammoth support template inspect`. Exact input fields: `mammoth schema get support.template.inspect`.
+
+Example: `mammoth support template inspect template.zip`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `SupportTemplateInspectResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.template.list`
+
+Run: `mammoth support template list`. Exact input fields: `mammoth schema get support.template.list`.
+
+Example: `mammoth support template list`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `SupportTemplateListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.template.publish`
+
+Run: `mammoth support template publish`. Exact input fields: `mammoth schema get support.template.publish`.
+
+Example: `mammoth support template publish sample`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+
+Result: `SupportTemplatePublishResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.template.retire`
+
+Run: `mammoth support template retire`. Exact input fields: `mammoth schema get support.template.retire`.
+
+Example: `mammoth support template retire sample`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+
+Result: `SupportTemplateRetireResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.template.snapshots`
+
+Run: `mammoth support template snapshots`. Exact input fields: `mammoth schema get support.template.snapshots`.
+
+Example: `mammoth support template snapshots`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `SupportTemplateSnapshotsResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.template.thumbnail.clear`
+
+Run: `mammoth support template thumbnail clear`. Exact input fields: `mammoth schema get support.template.thumbnail.clear`.
+
+Example: `mammoth support template thumbnail clear sample`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+
+Result: `SupportTemplateThumbnailClearResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.template.thumbnail.set`
+
+Run: `mammoth support template thumbnail set`. Exact input fields: `mammoth schema get support.template.thumbnail.set`.
+
+Example: `mammoth support template thumbnail set sample card.png`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+
+Result: `SupportTemplateThumbnailSetResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `support.template.unpublish`
+
+Run: `mammoth support template unpublish`. Exact input fields: `mammoth schema get support.template.unpublish`.
+
+Example: `mammoth support template unpublish sample`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+
+Result: `SupportTemplateUnpublishResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `support.user.list-all`
 
 Run: `mammoth support user list-all`. Exact input fields: `mammoth schema get support.user.list-all`.

{mammoth_cli-2.2.7 → mammoth_cli-2.2.8}/mammoth_cli/commands/registry.py

@@ -648,6 +648,27 @@ HANDLERS: dict[str, Handler] = {
     "support.feature-profile.update": support_cmd.support_feature_profile_update,
     "support.ownership.transfer": support_cmd.support_ownership_transfer,
     "support.plan.archive": support_cmd.support_plan_archive,
+    "support.plan.unarchive": support_cmd.support_plan_unarchive,
+    "support.plan.storage-option.list": support_cmd.support_plan_storage_option_list,
+    "support.plan.storage-option.create": support_cmd.support_plan_storage_option_create,
+    "support.plan.storage-option.update": support_cmd.support_plan_storage_option_update,
+    "support.plan.storage-option.archive": support_cmd.support_plan_storage_option_archive,
+    "support.template.list": support_cmd.support_template_list,
+    "support.template.edit": support_cmd.support_template_edit,
+    "support.template.data-preview": support_cmd.support_template_data_preview,
+    "support.template.canvas": support_cmd.support_template_canvas,
+    "support.template.publish": support_cmd.support_template_publish,
+    "support.template.unpublish": support_cmd.support_template_unpublish,
+    "support.template.retire": support_cmd.support_template_retire,
+    "support.template.inspect": support_cmd.support_template_inspect,
+    "support.template.import": support_cmd.support_template_import,
+    "support.template.thumbnail.set": support_cmd.support_template_thumbnail_set,
+    "support.template.thumbnail.clear": support_cmd.support_template_thumbnail_clear,
+    "support.template.discard": support_cmd.support_template_discard,
+    "support.template.snapshots": support_cmd.support_template_snapshots,
+    "support.template.audit": support_cmd.support_template_audit,
+    "support.template.export": support_cmd.support_template_export,
+    "support.template.export-dashboard": support_cmd.support_template_export_dashboard,
     "support.plan.chargebee-list": support_cmd.support_plan_chargebee_list,
     "support.plan.create": support_cmd.support_plan_create,
     "support.plan.delete": support_cmd.support_plan_delete,

{mammoth_cli-2.2.7 → mammoth_cli-2.2.8}/mammoth_cli/commands/schema.py

@@ -427,6 +427,27 @@ _COMMAND_DISCOVERY_PURPOSES = {
     "dashboard.template.thumbnail.clear": "remove delete template picture card image thumbnail",
     "dashboard.gallery.list": "public template gallery curated templates catalog examples browse",
     "dashboard.gallery.get": "one public gallery template card by slug",
+    "support.plan.unarchive": "platform admin restore an archived subscription plan",
+    "support.plan.storage-option.list": "platform admin plan storage sizes prices options",
+    "support.plan.storage-option.create": "platform admin add a storage size price to a plan",
+    "support.plan.storage-option.update": "platform admin reprice resize a plan storage option",
+    "support.plan.storage-option.archive": "platform admin retire a plan storage option",
+    "support.template.list": "platform admin curated template catalog worklist drafts faults",
+    "support.template.edit": "platform admin retag rename reorder curated template filing",
+    "support.template.data-preview": "platform admin curated template sample rows",
+    "support.template.canvas": "platform admin curated template draft canvas review",
+    "support.template.publish": "platform admin take curated template live in gallery",
+    "support.template.unpublish": "platform admin take curated template down back to draft",
+    "support.template.retire": "platform admin retire curated template stop offering",
+    "support.template.inspect": "platform admin read template bundle zip before import",
+    "support.template.import": "platform admin import template bundle zip curated draft",
+    "support.template.thumbnail.set": "platform admin upload curated template picture",
+    "support.template.thumbnail.clear": "platform admin remove curated template picture",
+    "support.template.discard": "platform admin undo template import discard curated draft",
+    "support.template.snapshots": "platform admin stored datasets behind curated templates",
+    "support.template.audit": "platform admin audit curated template catalog gates faults",
+    "support.template.export": "platform admin download curated template bundle zip",
+    "support.template.export-dashboard": "platform admin download a board as template bundle zip",
     "connector.ai.chat": (
         "connect our own internal custom api build a connector for an unsupported source"
     ),

{mammoth_cli-2.2.7 → mammoth_cli-2.2.8}/mammoth_cli/commands/support.py

@@ -23,7 +23,11 @@ from mammoth_cli.errors.envelope import (
     CliError,
 )
 from mammoth_cli.manifest.loader import command_by_id
-from mammoth_cli.runtime.confirm import POLICY_CONFIRM_TARGET, enforce_confirmation
+from mammoth_cli.runtime.confirm import (
+    POLICY_CONFIRM_TARGET,
+    POLICY_YES_ALWAYS,
+    enforce_confirmation,
+)
 from mammoth_cli.runtime.invocation import Invocation
 from mammoth_cli.runtime.session import open_service
 from mammoth_cli.services.command_contract import bind_command_inputs
@@ -491,6 +495,87 @@ def support_plan_archive(invocation: Invocation) -> HandlerResult:
     return data, _meta(invocation, auth.workspace_id)
 
 
+def _require_named_int(invocation: Invocation, name: str, human: str) -> int:
+    """Return a required integer positional by its declared name, or raise usage."""
+    raw = invocation.positional(name)
+    if raw is None:
+        raise CliError(
+            code=CODE_MISSING_ARGUMENT, message=f"A {human} is required.", exit_status=EXIT_USAGE
+        )
+    try:
+        return int(raw)
+    except ValueError as exc:
+        raise CliError(
+            code=CODE_INVALID_ARGUMENT,
+            message=f"The {human} argument '{raw}' is not an integer.",
+            exit_status=EXIT_USAGE,
+        ) from exc
+
+
+def support_plan_unarchive(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: unarchive one subscription plan by id."""
+    plan_id = _require_int_positional(invocation, "plan id")
+    _confirm(invocation, action=f"unarchive plan {plan_id}", target=str(plan_id))
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), plan_id=plan_id)
+    return data, _meta(invocation, auth.workspace_id)
+
+
+def support_plan_storage_option_list(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: list a plan's storage options, archived ones included."""
+    plan_id = _require_int_positional(invocation, "plan id")
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), plan_id=plan_id)
+    return data, _meta(invocation, auth.workspace_id)
+
+
+def support_plan_storage_option_create(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: add a storage option (total GB and prices) to a plan."""
+    plan_id = _require_int_positional(invocation, "plan id")
+    document = _bound_document(invocation)
+    kwargs: dict[str, Any] = {
+        "plan_id": plan_id,
+        "storage_gb": _require_field(document, "storage_gb"),
+        "monthly_price": _require_field(document, "monthly_price"),
+        "annual_price": _require_field(document, "annual_price"),
+    }
+    _confirm(invocation, action=f"add a storage option to plan {plan_id}", target=str(plan_id))
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), **kwargs)
+    return data, _meta(invocation, auth.workspace_id)
+
+
+def support_plan_storage_option_update(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: re-price or resize one storage option of a plan."""
+    plan_id = _require_int_positional(invocation, "plan id")
+    option_id = _require_named_int(invocation, "option_id", "storage option id")
+    document = _bound_document(invocation)
+    kwargs: dict[str, Any] = {"plan_id": plan_id, "option_id": option_id}
+    _forward_optional(document, kwargs, ("storage_gb", "monthly_price", "annual_price"))
+    _confirm(
+        invocation,
+        action=f"update storage option {option_id} of plan {plan_id}",
+        target=str(option_id),
+    )
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), **kwargs)
+    return data, _meta(invocation, auth.workspace_id)
+
+
+def support_plan_storage_option_archive(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: archive one storage option of a plan (never deleted)."""
+    plan_id = _require_int_positional(invocation, "plan id")
+    option_id = _require_named_int(invocation, "option_id", "storage option id")
+    _confirm(
+        invocation,
+        action=f"archive storage option {option_id} of plan {plan_id}",
+        target=str(option_id),
+    )
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), plan_id=plan_id, option_id=option_id)
+    return data, _meta(invocation, auth.workspace_id)
+
+
 # -- Subscriptions ------------------------------------------------------------------
 
 
@@ -784,3 +869,165 @@ def support_workspace_user_transfer(invocation: Invocation) -> HandlerResult:
     with open_service(invocation) as (service, auth):
         data = service.call(_symbol(invocation), **kwargs)
     return data, _meta(invocation, auth.workspace_id)
+
+
+# -- Curated template catalog (dashboards v3 admin) ---------------------------------
+#
+# Every route refuses a caller without a Mammoth staff (platform-admin) role, and
+# acts on CURATED templates only. The help line of each command says so first.
+
+
+def _require_text_positional(invocation: Invocation, name: str, human: str) -> str:
+    """Return a required string positional by its declared name, or raise usage."""
+    value = invocation.positional(name)
+    if not value:
+        raise CliError(
+            code=CODE_MISSING_ARGUMENT,
+            message=f"A {human} is required.",
+            exit_status=EXIT_USAGE,
+            hint=f"Pass the {human} as a positional argument.",
+        )
+    return str(value)
+
+
+def _template_read(invocation: Invocation) -> HandlerResult:
+    """Call a slug-addressed read of the curated catalog."""
+    slug = _require_text_positional(invocation, "slug", "template slug")
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), slug=slug)
+    return data, _meta(invocation, auth.workspace_id)
+
+
+def _template_write(invocation: Invocation, verb: str) -> HandlerResult:
+    """Call a slug-addressed write of the curated catalog after ``--confirm SLUG``."""
+    slug = _require_text_positional(invocation, "slug", "template slug")
+    _confirm(invocation, action=f"{verb} curated template '{slug}'", target=slug)
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), slug=slug)
+    return data, _meta(invocation, auth.workspace_id)
+
+
+def support_template_list(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: list every curated template, drafts and faults first."""
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation))
+    return data, _meta(invocation, auth.workspace_id)
+
+
+def support_template_edit(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: edit a curated template's filing ('changes' from '--input')."""
+    slug = _require_text_positional(invocation, "slug", "template slug")
+    document = _bound_document(invocation)
+    changes = _require_field(document, "changes")
+    _confirm(invocation, action=f"edit curated template '{slug}'", target=slug)
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), slug=slug, changes=changes)
+    return data, _meta(invocation, auth.workspace_id)
+
+
+def support_template_data_preview(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: read up to 50 rows of the data a curated template opens on."""
+    return _template_read(invocation)
+
+
+def support_template_canvas(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: read a curated template's canvas, drafts included."""
+    return _template_read(invocation)
+
+
+def support_template_publish(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: take a curated draft live in every customer's gallery."""
+    return _template_write(invocation, "publish")
+
+
+def support_template_unpublish(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: take a live or retired curated template back to draft."""
+    return _template_write(invocation, "unpublish")
+
+
+def support_template_retire(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: retire a curated template (kept, no longer offered)."""
+    return _template_write(invocation, "retire")
+
+
+def support_template_thumbnail_clear(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: remove a curated template's picture."""
+    return _template_write(invocation, "remove the picture of")
+
+
+def support_template_discard(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: permanently remove a curated draft, its board and its data."""
+    return _template_write(invocation, "discard")
+
+
+def support_template_thumbnail_set(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: upload or replace a curated template's picture from FILE."""
+    slug = _require_text_positional(invocation, "slug", "template slug")
+    file_path = _require_text_positional(invocation, "file", "image file path")
+    _confirm(invocation, action=f"replace the picture of curated template '{slug}'", target=slug)
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), slug=slug, file=file_path)
+    return data, _meta(invocation, auth.workspace_id)
+
+
+def support_template_inspect(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: read a template file (.zip) without importing it."""
+    file_path = _require_text_positional(invocation, "file", "template file path")
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), file=file_path)
+    return data, _meta(invocation, auth.workspace_id)
+
+
+def support_template_import(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: import a template file (.zip) as a curated draft. '--yes' required."""
+    file_path = _require_text_positional(invocation, "file", "template file path")
+    document = _bound_document(invocation)
+    kwargs: dict[str, Any] = {"file": file_path}
+    _forward_optional(document, kwargs, ("dataset",))
+    enforce_confirmation(
+        invocation,
+        policy=POLICY_YES_ALWAYS,
+        action=f"import template file {file_path} into the curated catalog",
+    )
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), **kwargs)
+    return data, _meta(invocation, auth.workspace_id)
+
+
+def support_template_snapshots(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: list every stored dataset the template catalog holds."""
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation))
+    return data, _meta(invocation, auth.workspace_id)
+
+
+def support_template_audit(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: re-run every curated-catalog gate (read-only)."""
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation))
+    return data, _meta(invocation, auth.workspace_id)
+
+
+def support_template_export(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: download a curated template as a .zip template file."""
+    slug = _require_text_positional(invocation, "slug", "template slug")
+    document = _bound_document(invocation)
+    kwargs: dict[str, Any] = {"slug": slug}
+    _forward_optional(document, kwargs, ("output_path", "with_data"))
+    with open_service(invocation) as (service, auth):
+        path = service.call(_symbol(invocation), **kwargs)
+    return {"output_path": str(path)}, _meta(invocation, auth.workspace_id)
+
+
+def support_template_export_dashboard(invocation: Invocation) -> HandlerResult:
+    """Platform admin only: download a dashboard you can edit as a .zip template file."""
+    dashboard_id = _require_int_positional(invocation, "dashboard id")
+    document = _bound_document(invocation)
+    kwargs: dict[str, Any] = {
+        "dashboard_id": dashboard_id,
+        "slug": _require_field(document, "slug"),
+    }
+    _forward_optional(document, kwargs, ("output_path", "with_data"))
+    with open_service(invocation) as (service, auth):
+        path = service.call(_symbol(invocation), **kwargs)
+    return {"output_path": str(path)}, _meta(invocation, auth.workspace_id)