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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.2.6
+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.7
+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.6 → 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.6"
+__version__ = "2.2.8"
 
 # The versioned machine output envelope contract.
 SCHEMA_VERSION = 1

{mammoth_cli-2.2.6 → 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 602 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.6 → 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 602; 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:
 
@@ -12,8 +12,8 @@ Load only the applicable domain file:
 - [auth](commands/auth.md) — 3 published commands
 - [automation](commands/automation.md) — 8 published commands
 - [batch](commands/batch.md) — 7 published commands
-- [billing](commands/billing.md) — 22 published commands
-- [browse](commands/browse.md) — 6 published commands
+- [billing](commands/billing.md) — 25 published commands
+- [browse](commands/browse.md) — 8 published commands
 - [calc](commands/calc.md) — 1 published commands
 - [capability](commands/capability.md) — 3 published commands
 - [client-app](commands/client-app.md) — 5 published commands
@@ -22,8 +22,8 @@ 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-style](commands/dashboard-style.md) — 10 published commands
-- [dashboard](commands/dashboard.md) — 95 published commands
+- [dashboard-template](commands/dashboard-template.md) — 12 published commands
+- [dashboard](commands/dashboard.md) — 98 published commands
 - [data-app](commands/data-app.md) — 12 published commands
 - [dataset](commands/dataset.md) — 21 published commands
 - [doctor](commands/doctor.md) — 1 published commands
@@ -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.6 → mammoth_cli-2.2.8}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/billing.md

@@ -152,6 +152,26 @@ Result: `BillingStripePreviewInvoiceResult`; mutation `read`, confirmation `none
 
 Status on release: observed blocker — backend_error: The CLI gates this GET behind --yes --confirm WORKSPACE_ID; with confirmation: HTTP 400 4SUBS037 'Failed to perform subscription operation'. Re-check before relying on it.
 
+### `billing.stripe.recheck-limits`
+
+Run: `mammoth billing stripe recheck-limits`. Exact input fields: `mammoth schema get billing.stripe.recheck-limits`.
+
+Example: `mammoth billing stripe recheck-limits`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `BillingStripeRecheckLimitsResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `billing.stripe.resume`
+
+Run: `mammoth billing stripe resume`. Exact input fields: `mammoth schema get billing.stripe.resume`.
+
+Example: `mammoth billing stripe resume`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+
+Result: `BillingStripeResumeResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `billing.stripe.retry-payment`
 
 Run: `mammoth billing stripe retry-payment`. Exact input fields: `mammoth schema get billing.stripe.retry-payment`.
@@ -172,6 +192,16 @@ Result: `BillingStripeStatusResult`; mutation `read`, confirmation `none`, wait
 
 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 with billing_cycle, has_active_subscription, is_trial_expired, ... (20 keys) Si…
 
+### `billing.stripe.storage.set`
+
+Run: `mammoth billing stripe storage set`. Exact input fields: `mammoth schema get billing.stripe.storage.set`.
+
+Example: `mammoth billing stripe storage set --input '{"storage_gb": 1}'`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+
+Result: `BillingStripeStorageSetResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `billing.stripe.sync`
 
 Run: `mammoth billing stripe sync`. Exact input fields: `mammoth schema get billing.stripe.sync`.

{mammoth_cli-2.2.6 → mammoth_cli-2.2.8}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/browse.md

@@ -2,6 +2,16 @@
 
 Every command returns the standard JSON envelope. On nonzero exit, read the error envelope and its `recovery_commands`; do not guess request fields. "Status on release" is joined from `docs/release-capability-matrix.json`: *ran once* means one bounded live run succeeded on the named CLI release, *untried* means nobody has run it (use it normally: confirm writes with the user, check the result afterwards), *not supported* means the backend refuses it. When this file disagrees with [capabilities](../capabilities.md) or a recipe, they win. Envelope shapes: [machine output](../machine-output.md).
 
+### `browse.ancestors`
+
+Run: `mammoth browse ancestors`. Exact input fields: `mammoth schema get browse.ancestors`.
+
+Example: `mammoth browse ancestors 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `BrowseAncestorsResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `browse.folder`
 
 Run: `mammoth browse folder`. Exact input fields: `mammoth schema get browse.folder`.
@@ -52,6 +62,16 @@ Result: `BrowseRootResult`; mutation `read`, confirmation `none`, wait policy `n
 
 Status on release: observed blocker — backend_error: GET /browse still HTTP 500 empty body on release (same as 2026-09-18/19 sweeps). Re-check before relying on it.
 
+### `browse.search`
+
+Run: `mammoth browse search`. Exact input fields: `mammoth schema get browse.search`.
+
+Example: `mammoth browse search`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `BrowseSearchResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `browse.workspace`
 
 Run: `mammoth browse workspace`. Exact input fields: `mammoth schema get browse.workspace`.

mammoth_cli-2.2.8/mammoth_cli/bundled_skill/mammoth-cli/references/commands/dashboard-template.md

@@ -0,0 +1,123 @@
+# `dashboard-template` commands
+
+Every command returns the standard JSON envelope. On nonzero exit, read the error envelope and its `recovery_commands`; do not guess request fields. "Status on release" is joined from `docs/release-capability-matrix.json`: *ran once* means one bounded live run succeeded on the named CLI release, *untried* means nobody has run it (use it normally: confirm writes with the user, check the result afterwards), *not supported* means the backend refuses it. When this file disagrees with [capabilities](../capabilities.md) or a recipe, they win. Envelope shapes: [machine output](../machine-output.md).
+
+### `dashboard.template.apply`
+
+Run: `mammoth dashboard template apply`. Exact input fields: `mammoth schema get dashboard.template.apply`.
+
+Example: `mammoth dashboard template apply --input '{"body": {"params": {"source_dashboard_id": 1, "target_dataview_id": 1}}}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DashboardTemplateApplyResult`; mutation `benign_mutation`, confirmation `none`, wait policy `always_wait`.
+
+Status on release: ran once on CLI 2.0.14 — dashboard re-verification 2026-09-18: exit 0 on release with CLI 2.0.14. Succeeded and created a NEW dashboard (id 57, derived_from 56, url U6WuS1Z2haJj8h96JkcFxw) mapped onto view 45 with fidelity {"blocked":false,"dropped":0,"unmatched_required":[]}. This i…
+
+### `dashboard.template.create`
+
+Run: `mammoth dashboard template create`. Exact input fields: `mammoth schema get dashboard.template.create`.
+
+Example: `mammoth dashboard template create --input '{"body": {"params": {"dashboard_id": 1, "title": "Revenue report"}}}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DashboardTemplateCreateResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: observed blocker — backend_error: POST /dashboards/v3/templates HTTP 500 empty body / outcome_unknown, as on 2026-09-18. Re-check before relying on it.
+
+### `dashboard.template.delete`
+
+Run: `mammoth dashboard template delete`. Exact input fields: `mammoth schema get dashboard.template.delete`.
+
+Example: `mammoth dashboard template delete resource-123`. Illustrative only: append `--yes` after observing an owned target.
+
+Result: `DashboardTemplateDeleteResult`; mutation `destructive`, confirmation `prompt_or_yes`, wait policy `not_async`.
+
+Status on release: observed blocker — blocked_missing_fixture: dashboard.template.create never produced an owned template (HTTP 500 both attempts, reconciled as not-committed via template list). Re-check before relying on it.
+
+### `dashboard.template.fit`
+
+Run: `mammoth dashboard template fit`. Exact input fields: `mammoth schema get dashboard.template.fit`.
+
+Example: `mammoth dashboard template fit 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DashboardTemplateFitResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: ran once on CLI 2.0.12 — Read-only sweep 2026-09-18: exit 0 on release with CLI 2.0.11; result keys: dataview_id, fits. Single read only; no fixture variants, error envelopes, or write paths assessed. Also: Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: d…
+
+### `dashboard.template.get`
+
+Run: `mammoth dashboard template get`. Exact input fields: `mammoth schema get dashboard.template.get`.
+
+Example: `mammoth dashboard template get resource-123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DashboardTemplateGetResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: ran once on CLI 2.0.14 — dashboard re-verification 2026-09-18: exit 0 on release with CLI 2.0.14. CLI defect fixed, confirmed: returned a full matched structured body ({"explore":{...},"self_fit":{"grade":"great",...},"source_dashboard_id":1,"template":{...}}) instead of raising Vali…
+
+### `dashboard.template.list`
+
+Run: `mammoth dashboard template list`. Exact input fields: `mammoth schema get dashboard.template.list`.
+
+Example: `mammoth dashboard template list`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DashboardTemplateListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: ran once on CLI 2.0.21 — ergonomics sweep 2026-09-19: exit 0 on release with CLI 2.0.21. Returned the template catalogue (formats, functions, ...). Single invocation only.
+
+### `dashboard.template.preview`
+
+Run: `mammoth dashboard template preview`. Exact input fields: `mammoth schema get dashboard.template.preview`.
+
+Example: `mammoth dashboard template preview --input '{"body": {"params": {"source_dashboard_id": 1, "target_dataview_id": 1}}}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DashboardTemplatePreviewResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: ran once on CLI 2.0.12 — Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: canvas, fidelity, mapping, meta, plan, specs, target_fields. previewed D=52's canvas retargeted to dataview 47 (life expectancy dataset) Single invocation only; no error-path or varia…
+
+### `dashboard.template.rename`
+
+Run: `mammoth dashboard template rename`. Exact input fields: `mammoth schema get dashboard.template.rename`.
+
+Example: `mammoth dashboard template rename resource-123 --input '{"body": {"params": {"title": "Revenue report"}}}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DashboardTemplateRenameResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `dashboard.template.resolve-mapping`
+
+Run: `mammoth dashboard template resolve-mapping`. Exact input fields: `mammoth schema get dashboard.template.resolve-mapping`.
+
+Example: `mammoth dashboard template resolve-mapping --input '{"body": {"params": {"source_dashboard_id": 1, "target_dataview_id": 1}}}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DashboardTemplateResolveMappingResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: ran once on CLI 2.0.12 — Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: fidelity, mapping, target_fields. resolved mapping from D=52's current dataview (46, GDP after swap-data) to target dataview 47 (life expectancy) Single invocation only; no error-path…
+
+### `dashboard.template.thumbnail.clear`
+
+Run: `mammoth dashboard template thumbnail clear`. Exact input fields: `mammoth schema get dashboard.template.thumbnail.clear`.
+
+Example: `mammoth dashboard template thumbnail clear resource-123`. Illustrative only: append `--yes` after observing an owned target.
+
+Result: `DashboardTemplateThumbnailClearResult`; mutation `destructive`, confirmation `prompt_or_yes`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `dashboard.template.thumbnail.get`
+
+Run: `mammoth dashboard template thumbnail get`. Exact input fields: `mammoth schema get dashboard.template.thumbnail.get`.
+
+Example: `mammoth dashboard template thumbnail get resource-123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DashboardTemplateThumbnailGetResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `dashboard.template.thumbnail.set`
+
+Run: `mammoth dashboard template thumbnail set`. Exact input fields: `mammoth schema get dashboard.template.thumbnail.set`.
+
+Example: `mammoth dashboard template thumbnail set resource-123 card.png`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DashboardTemplateThumbnailSetResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.

{mammoth_cli-2.2.6 → mammoth_cli-2.2.8}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/dashboard.md

@@ -392,6 +392,26 @@ Result: `DashboardFormatPreviewResult`; mutation `read`, confirmation `none`, wa
 
 Status on release: untried; no live run recorded.
 
+### `dashboard.gallery.get`
+
+Run: `mammoth dashboard gallery get`. Exact input fields: `mammoth schema get dashboard.gallery.get`.
+
+Example: `mammoth dashboard gallery get sample`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DashboardGalleryGetResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `dashboard.gallery.list`
+
+Run: `mammoth dashboard gallery list`. Exact input fields: `mammoth schema get dashboard.gallery.list`.
+
+Example: `mammoth dashboard gallery list`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DashboardGalleryListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `dashboard.get`
 
 Run: `mammoth dashboard get`. Exact input fields: `mammoth schema get dashboard.get`.
@@ -700,165 +720,175 @@ Result: `DashboardSourceListResult`; mutation `read`, confirmation `none`, wait
 
 Status on release: observed blocker — blocker; still broken, not one of the 11 CLI-fixed commands. Re-check before relying on it.
 
-### `dashboard.suggestion.list`
+### `dashboard.style.custom.create`
 
-Run: `mammoth dashboard suggestion list`. Exact input fields: `mammoth schema get dashboard.suggestion.list`.
+Run: `mammoth dashboard style custom create`. Exact input fields: `mammoth schema get dashboard.style.custom.create`.
 
-Example: `mammoth dashboard suggestion list 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+Example: `mammoth dashboard style custom create --input '{"body": {"params": {"signals": {}}}}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
 
-Result: `DashboardSuggestionListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+Result: `DashboardStyleCustomCreateResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
 
-Status on release: ran once on CLI 2.0.12 — Published PyPI CLI 1.1.11 job-backed suggestion read for retained dataview46 reconciled job158 to terminal success with 9 structured suggestions; bounded to one job and not Full. A permitted reread spawned pending job159 with null payload. Also: Dashboard swe…
+Status on release: ran once on CLI 2.0.12 — Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: style. created custom style id=1 with full unredacted colors/font/viz (no tokens field passed) Single invocation only; no error-path or variant coverage.
 
-### `dashboard.swap-data`
+### `dashboard.style.custom.delete`
 
-Run: `mammoth dashboard swap-data`. Exact input fields: `mammoth schema get dashboard.swap-data`.
+Run: `mammoth dashboard style custom delete`. Exact input fields: `mammoth schema get dashboard.style.custom.delete`.
 
-Example: `mammoth dashboard swap-data 123 --input '{"body": {"params": {"dataview_id": 1}}}'`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+Example: `mammoth dashboard style custom delete resource-123`. Illustrative only: append `--yes` after observing an owned target.
 
-Result: `ObjectJobSchema`; mutation `benign_mutation`, confirmation `confirm_target`, wait policy `always_wait`.
+Result: `DashboardStyleCustomDeleteResult`; mutation `destructive`, confirmation `prompt_or_yes`, wait policy `not_async`.
 
-Status on release: ran once on CLI 2.0.12 — Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: bake_ok, fidelity, id, sequence. swapped D=52 from dataview 45 (population) to dataview 46 (GDP), both Terra OWID reference views with similar schema; fidelity: 1 mapped, 1 dropped, n…
+Status on release: ran once on CLI 2.0.12 — Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: ok. deleted custom style 1 Single invocation only; no error-path or variant coverage.
 
-### `dashboard.tags.delete`
+### `dashboard.style.custom.list`
 
-Run: `mammoth dashboard tags delete`. Exact input fields: `mammoth schema get dashboard.tags.delete`.
+Run: `mammoth dashboard style custom list`. Exact input fields: `mammoth schema get dashboard.style.custom.list`.
 
-Example: `mammoth dashboard tags delete 123 --yes --confirm 123`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+Example: `mammoth dashboard style custom list`. Placeholders are illustrative; resolve IDs and input from observed reads.
 
-Result: `DashboardTagsDeleteResult`; mutation `destructive`, confirmation `confirm_target`, wait policy `not_async`.
+Result: `DashboardStyleCustomListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
 
-Status on release: ran once on CLI 2.0.12 — Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: n/a. deleted self-created tag 12 (entity) Single invocation only; no error-path or variant coverage. Current checkout binding is committed structural mapping; release behavior remains…
+Status on release: ran once on CLI 2.0.12 — Bounded release read succeeded with pinned CLI 1.1.9 in workspace 4; empty custom-style list observed. No Full claim: no non-empty fixture. Also: Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: styles. empty custom styles list Sing…
 
-### `dashboard.tags.list`
+### `dashboard.style.custom.update`
 
-Run: `mammoth dashboard tags list`. Exact input fields: `mammoth schema get dashboard.tags.list`.
+Run: `mammoth dashboard style custom update`. Exact input fields: `mammoth schema get dashboard.style.custom.update`.
 
-Example: `mammoth dashboard tags list`. Placeholders are illustrative; resolve IDs and input from observed reads.
+Example: `mammoth dashboard style custom update resource-123 --input '{"body": {"params": {"signals": {}}}}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
 
-Result: `DashboardTagsListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+Result: `DashboardStyleCustomUpdateResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
 
-Status on release: ran once on CLI 2.0.12 — Bounded release read succeeded with pinned CLI 1.1.9 in workspace 4; empty tag list observed. No Full claim: no non-empty fixture. Current checkout binding is committed structural mapping; release behavior remains unverified. Current checkout binding is commi…
+Status on release: ran once on CLI 2.0.12 — Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: style. renamed custom style 1 Single invocation only; no error-path or variant coverage.
 
-### `dashboard.tags.merge`
+### `dashboard.style.default.get`
 
-Run: `mammoth dashboard tags merge`. Exact input fields: `mammoth schema get dashboard.tags.merge`.
+Run: `mammoth dashboard style default get`. Exact input fields: `mammoth schema get dashboard.style.default.get`.
 
-Example: `mammoth dashboard tags merge 123 --input '{"target_id": 456}' --yes --confirm 123`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+Example: `mammoth dashboard style default get`. Placeholders are illustrative; resolve IDs and input from observed reads.
 
-Result: `DashboardTagsMergeResult`; mutation `destructive`, confirmation `confirm_target`, wait policy `not_async`.
+Result: `DashboardStyleDefaultGetResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
 
-Status on release: ran once on CLI 2.0.12 — Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: id, merged_into, name. merged self-created tag 13 into self-created tag 11 (population); no pre-existing tag touched Single invocation only; no error-path or variant coverage. Current…
+Status on release: ran once on CLI 2.0.14 — dashboard re-verification 2026-09-18: exit 0 on release with CLI 2.0.14. CLI defect fixed, confirmed: returned a real matched body {"styleId":"stone"} instead of raising ValidationError on an unmatched 2xx. Single invocation only.
 
-### `dashboard.tags.rename`
+### `dashboard.style.default.set`
 
-Run: `mammoth dashboard tags rename`. Exact input fields: `mammoth schema get dashboard.tags.rename`.
+Run: `mammoth dashboard style default set`. Exact input fields: `mammoth schema get dashboard.style.default.set`.
 
-Example: `mammoth dashboard tags rename 123 --input '{"name": "Revenue"}' --yes --confirm 123`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+Example: `mammoth dashboard style default set --input '{"body": {"params": {"styleId": "sample"}}}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
 
-Result: `DashboardTagsRenameResult`; mutation `benign_mutation`, confirmation `confirm_target`, wait policy `not_async`.
+Result: `DashboardStyleDefaultSetResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
 
-Status on release: ran once on CLI 2.0.12 — Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: id, merged_into, name. renamed tag 13 (created by this run's dashboard.tags.set) successfully Single invocation only; no error-path or variant coverage. Current checkout binding is co…
+Status on release: ran once on CLI 2.0.14 — dashboard re-verification 2026-09-18: exit 0 on release with CLI 2.0.14. Set styleId to the exact value read from style default get ("stone"), i.e. a verified no-op restore. Result {"styleId":"stone"}; re-ran style default get afterward and confirmed it still…
 
-### `dashboard.tags.set`
+### `dashboard.style.derive`
 
-Run: `mammoth dashboard tags set`. Exact input fields: `mammoth schema get dashboard.tags.set`.
+Run: `mammoth dashboard style derive`. Exact input fields: `mammoth schema get dashboard.style.derive`.
 
-Example: `mammoth dashboard tags set 123 --input '{"tags": ["Revenue"]}' --yes --confirm 123`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
+Example: `mammoth dashboard style derive --input '{"body": {"params": {"signals": {}}}}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
 
-Result: `DashboardTagsSetResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
+Result: `DashboardStyleDeriveResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
 
-Status on release: ran once on CLI 2.0.12 — Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: tags. set tag sweep-tag-alpha on D=52 Single invocation only; no error-path or variant coverage. Current checkout binding is committed structural mapping; release behavior remains unv…
+Status on release: ran once on CLI 2.0.14 — dashboard re-verification 2026-09-18: exit 0 on release with CLI 2.0.14. CLI defect fixed, confirmed: returned a full real styleTokens object (colors, font, viz palette, radius, shadow, etc.) with no '***REDACTED***' placeholders anywhere in the body. Single…
+
+### `dashboard.style.extract-brand`
+
+Run: `mammoth dashboard style extract-brand`. Exact input fields: `mammoth schema get dashboard.style.extract-brand`.
+
+Example: `mammoth dashboard style extract-brand --input '{"body": {"params": {"url": "https://example.com/data.csv"}}}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
 
-### `dashboard.template.apply`
+Result: `DashboardStyleExtractBrandResult`; mutation `benign_mutation`, confirmation `none`, wait policy `always_wait`.
 
-Run: `mammoth dashboard template apply`. Exact input fields: `mammoth schema get dashboard.template.apply`.
+Status on release: ran once on CLI 2.0.12 — Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: screenshot, signals. captured screenshot + extracted brand signals (accents/font/ground/primary), no redaction here Single invocation only; no error-path or variant coverage.
 
-Example: `mammoth dashboard template apply --input '{"body": {"params": {"source_dashboard_id": 1, "target_dataview_id": 1}}}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+### `dashboard.style.preset.list`
 
-Result: `DashboardTemplateApplyResult`; mutation `benign_mutation`, confirmation `none`, wait policy `always_wait`.
+Run: `mammoth dashboard style preset list`. Exact input fields: `mammoth schema get dashboard.style.preset.list`.
 
-Status on release: ran once on CLI 2.0.14 — dashboard re-verification 2026-09-18: exit 0 on release with CLI 2.0.14. Succeeded and created a NEW dashboard (id 57, derived_from 56, url U6WuS1Z2haJj8h96JkcFxw) mapped onto view 45 with fidelity {"blocked":false,"dropped":0,"unmatched_required":[]}. This i…
+Example: `mammoth dashboard style preset list`. Placeholders are illustrative; resolve IDs and input from observed reads.
 
-### `dashboard.template.create`
+Result: `DashboardStylePresetListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
 
-Run: `mammoth dashboard template create`. Exact input fields: `mammoth schema get dashboard.template.create`.
+Status on release: ran once on CLI 2.0.12 — Bounded release read succeeded with pinned CLI 1.1.9 in workspace 4; 10 stock presets returned. No Full claim: custom preset fixture not observed. Also: Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: presets. returns built-in styl…
 
-Example: `mammoth dashboard template create --input '{"body": {"params": {"dashboard_id": 1, "title": "Revenue report"}}}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+### `dashboard.style.token.list`
 
-Result: `DashboardTemplateCreateResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+Run: `mammoth dashboard style token list`. Exact input fields: `mammoth schema get dashboard.style.token.list`.
 
-Status on release: observed blocker — backend_error: POST /dashboards/v3/templates HTTP 500 empty body / outcome_unknown, as on 2026-09-18. Re-check before relying on it.
+Example: `mammoth dashboard style token list resource-123`. Placeholders are illustrative; resolve IDs and input from observed reads.
 
-### `dashboard.template.delete`
+Result: `DashboardStyleTokenListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
 
-Run: `mammoth dashboard template delete`. Exact input fields: `mammoth schema get dashboard.template.delete`.
+Status on release: ran once on CLI 1.1.11 — Published PyPI CLI 1.1.11 / SDK 0.7.1 read of observed preset stone returned a redacted token payload. Bounded to one preset and redacted semantics; not Full. Dashboard sweep 2026-09-18 on release observed cli_error: HTTP 200 but result is tokens='***REDACTED…
 
-Example: `mammoth dashboard template delete resource-123`. Illustrative only: append `--yes` after observing an owned target.
+### `dashboard.suggestion.list`
+
+Run: `mammoth dashboard suggestion list`. Exact input fields: `mammoth schema get dashboard.suggestion.list`.
+
+Example: `mammoth dashboard suggestion list 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
 
-Result: `DashboardTemplateDeleteResult`; mutation `destructive`, confirmation `prompt_or_yes`, wait policy `not_async`.
+Result: `DashboardSuggestionListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
 
-Status on release: observed blocker — blocked_missing_fixture: dashboard.template.create never produced an owned template (HTTP 500 both attempts, reconciled as not-committed via template list). Re-check before relying on it.
+Status on release: ran once on CLI 2.0.12 — Published PyPI CLI 1.1.11 job-backed suggestion read for retained dataview46 reconciled job158 to terminal success with 9 structured suggestions; bounded to one job and not Full. A permitted reread spawned pending job159 with null payload. Also: Dashboard swe…
 
-### `dashboard.template.fit`
+### `dashboard.swap-data`
 
-Run: `mammoth dashboard template fit`. Exact input fields: `mammoth schema get dashboard.template.fit`.
+Run: `mammoth dashboard swap-data`. Exact input fields: `mammoth schema get dashboard.swap-data`.
 
-Example: `mammoth dashboard template fit 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+Example: `mammoth dashboard swap-data 123 --input '{"body": {"params": {"dataview_id": 1}}}'`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
 
-Result: `DashboardTemplateFitResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+Result: `ObjectJobSchema`; mutation `benign_mutation`, confirmation `confirm_target`, wait policy `always_wait`.
 
-Status on release: ran once on CLI 2.0.12 — Read-only sweep 2026-09-18: exit 0 on release with CLI 2.0.11; result keys: dataview_id, fits. Single read only; no fixture variants, error envelopes, or write paths assessed. Also: Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: d…
+Status on release: ran once on CLI 2.0.12 — Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: bake_ok, fidelity, id, sequence. swapped D=52 from dataview 45 (population) to dataview 46 (GDP), both Terra OWID reference views with similar schema; fidelity: 1 mapped, 1 dropped, n…
 
-### `dashboard.template.get`
+### `dashboard.tags.delete`
 
-Run: `mammoth dashboard template get`. Exact input fields: `mammoth schema get dashboard.template.get`.
+Run: `mammoth dashboard tags delete`. Exact input fields: `mammoth schema get dashboard.tags.delete`.
 
-Example: `mammoth dashboard template get resource-123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+Example: `mammoth dashboard tags delete 123 --yes --confirm 123`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
 
-Result: `DashboardTemplateGetResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+Result: `DashboardTagsDeleteResult`; mutation `destructive`, confirmation `confirm_target`, wait policy `not_async`.
 
-Status on release: ran once on CLI 2.0.14 — dashboard re-verification 2026-09-18: exit 0 on release with CLI 2.0.14. CLI defect fixed, confirmed: returned a full matched structured body ({"explore":{...},"self_fit":{"grade":"great",...},"source_dashboard_id":1,"template":{...}}) instead of raising Vali…
+Status on release: ran once on CLI 2.0.12 — Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: n/a. deleted self-created tag 12 (entity) Single invocation only; no error-path or variant coverage. Current checkout binding is committed structural mapping; release behavior remains…
 
-### `dashboard.template.list`
+### `dashboard.tags.list`
 
-Run: `mammoth dashboard template list`. Exact input fields: `mammoth schema get dashboard.template.list`.
+Run: `mammoth dashboard tags list`. Exact input fields: `mammoth schema get dashboard.tags.list`.
 
-Example: `mammoth dashboard template list`. Placeholders are illustrative; resolve IDs and input from observed reads.
+Example: `mammoth dashboard tags list`. Placeholders are illustrative; resolve IDs and input from observed reads.
 
-Result: `DashboardTemplateListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+Result: `DashboardTagsListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
 
-Status on release: ran once on CLI 2.0.21 — ergonomics sweep 2026-09-19: exit 0 on release with CLI 2.0.21. Returned the template catalogue (formats, functions, ...). Single invocation only.
+Status on release: ran once on CLI 2.0.12 — Bounded release read succeeded with pinned CLI 1.1.9 in workspace 4; empty tag list observed. No Full claim: no non-empty fixture. Current checkout binding is committed structural mapping; release behavior remains unverified. Current checkout binding is commi…
 
-### `dashboard.template.preview`
+### `dashboard.tags.merge`
 
-Run: `mammoth dashboard template preview`. Exact input fields: `mammoth schema get dashboard.template.preview`.
+Run: `mammoth dashboard tags merge`. Exact input fields: `mammoth schema get dashboard.tags.merge`.
 
-Example: `mammoth dashboard template preview --input '{"body": {"params": {"source_dashboard_id": 1, "target_dataview_id": 1}}}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+Example: `mammoth dashboard tags merge 123 --input '{"target_id": 456}' --yes --confirm 123`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
 
-Result: `DashboardTemplatePreviewResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+Result: `DashboardTagsMergeResult`; mutation `destructive`, confirmation `confirm_target`, wait policy `not_async`.
 
-Status on release: ran once on CLI 2.0.12 — Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: canvas, fidelity, mapping, meta, plan, specs, target_fields. previewed D=52's canvas retargeted to dataview 47 (life expectancy dataset) Single invocation only; no error-path or varia…
+Status on release: ran once on CLI 2.0.12 — Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: id, merged_into, name. merged self-created tag 13 into self-created tag 11 (population); no pre-existing tag touched Single invocation only; no error-path or variant coverage. Current…
 
-### `dashboard.template.rename`
+### `dashboard.tags.rename`
 
-Run: `mammoth dashboard template rename`. Exact input fields: `mammoth schema get dashboard.template.rename`.
+Run: `mammoth dashboard tags rename`. Exact input fields: `mammoth schema get dashboard.tags.rename`.
 
-Example: `mammoth dashboard template rename resource-123 --input '{"body": {"params": {"title": "Revenue report"}}}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+Example: `mammoth dashboard tags rename 123 --input '{"name": "Revenue"}' --yes --confirm 123`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
 
-Result: `DashboardTemplateRenameResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+Result: `DashboardTagsRenameResult`; mutation `benign_mutation`, confirmation `confirm_target`, wait policy `not_async`.
 
-Status on release: untried; no live run recorded.
+Status on release: ran once on CLI 2.0.12 — Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: id, merged_into, name. renamed tag 13 (created by this run's dashboard.tags.set) successfully Single invocation only; no error-path or variant coverage. Current checkout binding is co…
 
-### `dashboard.template.resolve-mapping`
+### `dashboard.tags.set`
 
-Run: `mammoth dashboard template resolve-mapping`. Exact input fields: `mammoth schema get dashboard.template.resolve-mapping`.
+Run: `mammoth dashboard tags set`. Exact input fields: `mammoth schema get dashboard.tags.set`.
 
-Example: `mammoth dashboard template resolve-mapping --input '{"body": {"params": {"source_dashboard_id": 1, "target_dataview_id": 1}}}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+Example: `mammoth dashboard tags set 123 --input '{"tags": ["Revenue"]}' --yes --confirm 123`. Illustrative only: append `--yes --confirm <EXACT_TARGET>` after observing the target.
 
-Result: `DashboardTemplateResolveMappingResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+Result: `DashboardTagsSetResult`; mutation `high_impact`, confirmation `confirm_target`, wait policy `not_async`.
 
-Status on release: ran once on CLI 2.0.12 — Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: fidelity, mapping, target_fields. resolved mapping from D=52's current dataview (46, GDP after swap-data) to target dataview 47 (life expectancy) Single invocation only; no error-path…
+Status on release: ran once on CLI 2.0.12 — Dashboard sweep 2026-09-18: exit 0 on release with CLI 2.0.12; result keys: tags. set tag sweep-tag-alpha on D=52 Single invocation only; no error-path or variant coverage. Current checkout binding is committed structural mapping; release behavior remains unv…
 
 ### `dashboard.templates.pending`