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

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

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

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

{mammoth_cli-2.2.5 → mammoth_cli-2.2.6}/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 597 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 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.
 
 Status meanings:
 

{mammoth_cli-2.2.5 → mammoth_cli-2.2.6}/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 597; 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 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.
 
 Load only the applicable domain file:
 
@@ -13,7 +13,7 @@ Load only the applicable domain file:
 - [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) — 4 published commands
+- [browse](commands/browse.md) — 6 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
@@ -23,7 +23,7 @@ Load only the applicable domain file:
 - [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) — 93 published commands
+- [dashboard](commands/dashboard.md) — 95 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
@@ -51,4 +51,4 @@ Load only the applicable domain file:
 - [view](commands/view.md) — 90 published commands
 - [webhook](commands/webhook.md) — 7 published commands
 - [workflow](commands/workflow.md) — 16 published commands
-- [workspace](commands/workspace.md) — 25 published commands
+- [workspace](commands/workspace.md) — 26 published commands

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

@@ -22,6 +22,26 @@ Result: `BrowseProjectResult`; mutation `read`, confirmation `none`, wait policy
 
 Status on release: observed blocker — backend_error: GET /workspaces/4/projects/47/browse HTTP 500 empty body. Re-check before relying on it.
 
+### `browse.resource`
+
+Run: `mammoth browse resource`. Exact input fields: `mammoth schema get browse.resource`.
+
+Example: `mammoth browse resource dataset 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `BrowseResourceResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `browse.resources`
+
+Run: `mammoth browse resources`. Exact input fields: `mammoth schema get browse.resources`.
+
+Example: `mammoth browse resources`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `BrowseResourcesResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `browse.root`
 
 Run: `mammoth browse root`. Exact input fields: `mammoth schema get browse.root`.

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

@@ -322,6 +322,16 @@ Result: `DashboardEmbedUsageGetResult`; mutation `read`, confirmation `none`, wa
 
 Status on release: untried; no live run recorded.
 
+### `dashboard.embed.usage.summary`
+
+Run: `mammoth dashboard embed usage summary`. Exact input fields: `mammoth schema get dashboard.embed.usage.summary`.
+
+Example: `mammoth dashboard embed usage summary --input '{"dashboard_ids": [1]}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DashboardEmbedUsageSummaryResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `dashboard.exemplar.extract`
 
 Run: `mammoth dashboard exemplar extract`. Exact input fields: `mammoth schema get dashboard.exemplar.extract`.
@@ -372,6 +382,16 @@ Result: `DashboardFilterResult`; mutation `benign_mutation`, confirmation `none`
 
 Status on release: untried; no live run recorded.
 
+### `dashboard.format-preview`
+
+Run: `mammoth dashboard format-preview`. Exact input fields: `mammoth schema get dashboard.format-preview`.
+
+Example: `mammoth dashboard format-preview 123 --input '{"style": "sample"}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `DashboardFormatPreviewResult`; 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`.

{mammoth_cli-2.2.5 → mammoth_cli-2.2.6}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/workspace.md

@@ -64,6 +64,16 @@ Result: `WorkspaceGetResult`; mutation `read`, confirmation `none`, wait policy
 
 Status on release: ran once on CLI 2.0.18 — fixture-lifecycle sweep 2026-09-19: exit 0 on release with CLI 2.0.18. Returned workspace 4 (API Tests) profile. Single invocation only.
 
+### `workspace.home`
+
+Run: `mammoth workspace home`. Exact input fields: `mammoth schema get workspace.home`.
+
+Example: `mammoth workspace home`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `WorkspaceHomeResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `workspace.invite.delete`
 
 Run: `mammoth workspace invite delete`. Exact input fields: `mammoth schema get workspace.invite.delete`.

{mammoth_cli-2.2.5 → mammoth_cli-2.2.6}/mammoth_cli/commands/browse.py

@@ -149,3 +149,49 @@ def browse_workspace(invocation: Invocation) -> HandlerResult:
     with open_service(invocation) as (service, auth):
         data = service.call(_symbol(invocation), **kwargs)
     return data, _meta(invocation, auth.workspace_id, resolved_project(invocation))
+
+
+def browse_resources(invocation: Invocation) -> HandlerResult:
+    """List one project's resources a cursor page at a time (resources v2)."""
+    project_id = require_project(invocation)
+    document = invocation.load_input() or {}
+    kwargs: dict[str, Any] = {"project_id": project_id}
+    _forward_optional(
+        document,
+        kwargs,
+        (
+            "parent_type",
+            "parent_id",
+            "resource_type",
+            "search",
+            "cursor",
+            "limit",
+            "sort",
+            "fields",
+        ),
+    )
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), **kwargs)
+    return data, _meta(invocation, auth.workspace_id, project_id)
+
+
+def browse_resource(invocation: Invocation) -> HandlerResult:
+    """Get one resource of the active project: type, then id, as positionals."""
+    project_id = require_project(invocation)
+    resource_type = invocation.positional("resource_type")
+    object_id = invocation.positional("object_id")
+    if not resource_type or object_id is None:
+        raise CliError(
+            code=CODE_MISSING_ARGUMENT,
+            message="This command requires a resource type and a resource id.",
+            exit_status=EXIT_USAGE,
+            hint="Pass the type, then the id: mammoth browse resource dataset 123.",
+        )
+    with open_service(invocation) as (service, auth):
+        data = service.call(
+            _symbol(invocation),
+            resource_type=str(resource_type),
+            object_id=int(object_id),
+            project_id=project_id,
+        )
+    return data, _meta(invocation, auth.workspace_id, project_id)

{mammoth_cli-2.2.5 → mammoth_cli-2.2.6}/mammoth_cli/commands/registry.py

@@ -295,6 +295,7 @@ HANDLERS: dict[str, Handler] = {
     "workspace.create": workspace_cmd.workspace_create,
     "workspace.delete": workspace_cmd.workspace_delete,
     "workspace.get": workspace_cmd.workspace_get,
+    "workspace.home": workspace_cmd.workspace_home,
     "workspace.list": workspace_cmd.workspace_list,
     "workspace.invite.delete": workspace_cmd.workspace_invite_delete,
     "workspace.invite.list": workspace_cmd.workspace_invite_list,
@@ -361,6 +362,8 @@ HANDLERS: dict[str, Handler] = {
     "batch.bulk-delete": batch_cmd.batch_bulk_delete,
     # browse family
     "browse.folder": browse_cmd.browse_folder,
+    "browse.resource": browse_cmd.browse_resource,
+    "browse.resources": browse_cmd.browse_resources,
     "browse.project": browse_cmd.browse_project,
     "browse.root": browse_cmd.browse_root,
     "browse.workspace": browse_cmd.browse_workspace,
@@ -447,6 +450,8 @@ HANDLERS: dict[str, Handler] = {
     "dashboard.embed.config.set": dashboard_cmd.generated_dashboard,
     "dashboard.embed.key.rotate": dashboard_cmd.generated_dashboard,
     "dashboard.embed.usage.get": dashboard_cmd.generated_dashboard,
+    "dashboard.embed.usage.summary": dashboard_cmd.generated_dashboard,
+    "dashboard.format-preview": dashboard_cmd.generated_dashboard,
     "dashboard.embed.origin.revoke": dashboard_cmd.generated_dashboard,
     "dashboard.embed.preview-token.create": dashboard_cmd.generated_dashboard,
     "dashboard.embed.secret.rotate": dashboard_cmd.generated_dashboard,

{mammoth_cli-2.2.5 → mammoth_cli-2.2.6}/mammoth_cli/commands/schema.py

@@ -398,6 +398,19 @@ _COMMAND_DISCOVERY_PURPOSES = {
         "unstructured pending review"
     ),
     "project.resource-status": "stuck stale failing broken error status anything wrong health",
+    "dashboard.embed.usage.summary": (
+        "embedded sites how many websites pages embed my boards library all dashboards origins"
+    ),
+    "dashboard.format-preview": (
+        "switch format style what would change lose carry over preview dry run report slides"
+    ),
+    "workspace.home": (
+        "home screen health issues needs attention overview usage snapshot suggestions"
+    ),
+    "browse.resources": (
+        "page through project resources cursor next page has more folder children v2 listing"
+    ),
+    "browse.resource": "open one resource by type and id properties of a dataset view folder",
     "connector.ai.chat": (
         "connect our own internal custom api build a connector for an unsupported source"
     ),

{mammoth_cli-2.2.5 → mammoth_cli-2.2.6}/mammoth_cli/commands/workspace.py

@@ -143,6 +143,13 @@ def workspace_app_usage(invocation: Invocation) -> HandlerResult:
     return data, _meta(invocation, auth.workspace_id)
 
 
+def workspace_home(invocation: Invocation) -> HandlerResult:
+    """Read the Home summary: usage snapshot, health issues and suggestions."""
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation))
+    return data, _meta(invocation, auth.workspace_id)
+
+
 def workspace_check_expression(invocation: Invocation) -> HandlerResult:
     """Ask the AI assistant to check an expression. Payload comes from ``--input``."""
     document = invocation.load_input()

{mammoth_cli-2.2.5 → mammoth_cli-2.2.6}/mammoth_cli/services/command_contract.py

@@ -431,6 +431,8 @@ S2_COMMANDS = frozenset(
         "annotation.update",
         "browse.folder",
         "browse.project",
+        "browse.resource",
+        "browse.resources",
         "browse.root",
         "browse.workspace",
         "dataset.bulk-delete",
@@ -501,6 +503,7 @@ S2_COMMANDS = frozenset(
         "workspace.create",
         "workspace.delete",
         "workspace.get",
+        "workspace.home",
         "workspace.list",
         "workspace.llm-task",
         "workspace.reactivate",

{mammoth_cli-2.2.5 → mammoth_cli-2.2.6}/mammoth_cli/services/positionals.py

@@ -130,6 +130,20 @@ POSITIONAL_OVERRIDES: dict[str, tuple[PositionalSpec, ...]] = {
     # The chat session is the global ``--session`` option, never a positional or
     # an --input field; only the action or run being addressed is positional.
     "agent.action.list": (),
+    # The parent is named in ``--input`` (``parent_id``), never positionally.
+    "browse.resources": (),
+    "browse.resource": (
+        PositionalSpec(
+            name="resource_type",
+            type=str,
+            required=True,
+            help="Resource type, for example dataset or dataview.",
+            example_value="dataset",
+        ),
+        PositionalSpec(
+            name="object_id", type=int, required=True, help="ID of the resource within its type."
+        ),
+    ),
     # The invite is named in ``--input`` (``invite_id``), never positionally.
     "workspace.invite.update-role": (),
     "agent.run.status": (),

{mammoth_cli-2.2.5 → mammoth_cli-2.2.6}/pyproject.toml

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

{mammoth_cli-2.2.5 → mammoth_cli-2.2.6}/spec/manifests/commands/browse.yaml

@@ -143,3 +143,89 @@ commands:
   undo_test: null
   known_restrictions: Validate level against the OpenAPI enum and report truncation.
   reviewed_by: primary
+- command_id: browse.resources
+  command_path: browse resources
+  disposition: command
+  alias_of: null
+  operation_ids: []
+  positionals: []
+  options: []
+  sdk_symbol: mammoth.api.browse.BrowseAPI.resources_list
+  sdk_conversion: Call mammoth.api.browse.BrowseAPI.resources_list with validated request fields.
+  request_model: BrowseResourcesRequest
+  result_model: BrowseResourcesResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: cursor
+  acceptance_evidence: live_read_only
+  live_test: LT-BROWSE-RESOURCES
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth browse resources --help
+  agent_example: 'mammoth browse resources'
+  unit_tests:
+  - UT-BROWSE-RESOURCES
+  contract_tests:
+  - CT-BROWSE-RESOURCES-HUMAN
+  - CT-BROWSE-RESOURCES-JSON
+  - CT-BROWSE-RESOURCES-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: 'One project''s resources a cursor page at a time (resources v2): pass next_cursor back as cursor while has_more is true. Optional parent_type and parent_id list inside a folder; resource_type, search, sort and fields narrow the page.'
+  reviewed_by: primary
+  readback:
+    command: browse.resources
+    ids: {}
+    kind: object
+- command_id: browse.resource
+  command_path: browse resource
+  disposition: command
+  alias_of: null
+  operation_ids: []
+  positionals:
+  - name: resource_type
+    type: str
+    required: true
+    metavar: RESOURCE_TYPE
+    falls_back_to_field: null
+    help: Resource type, for example dataset or dataview.
+  - name: object_id
+    type: int
+    required: true
+    metavar: OBJECT_ID
+    falls_back_to_field: null
+    help: ID of the resource within its type.
+  options: []
+  sdk_symbol: mammoth.api.browse.BrowseAPI.resource_get
+  sdk_conversion: Call mammoth.api.browse.BrowseAPI.resource_get with validated request fields.
+  request_model: BrowseResourceRequest
+  result_model: BrowseResourceResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_read_only
+  live_test: LT-BROWSE-RESOURCE
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth browse resource RESOURCE_TYPE OBJECT_ID --help
+  agent_example: 'mammoth browse resource dataset 123'
+  unit_tests:
+  - UT-BROWSE-RESOURCE
+  contract_tests:
+  - CT-BROWSE-RESOURCE-HUMAN
+  - CT-BROWSE-RESOURCE-JSON
+  - CT-BROWSE-RESOURCE-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: 'One resource of the project with its full properties (resources v2); name the type, then the id.'
+  reviewed_by: primary
+  readback:
+    command: browse.resource
+    ids: {}
+    kind: object

{mammoth_cli-2.2.5 → mammoth_cli-2.2.6}/spec/manifests/commands/dashboard.yaml

@@ -5115,3 +5115,83 @@ commands:
   undo_test: null
   known_restrictions: null
   reviewed_by: primary
+- command_id: dashboard.embed.usage.summary
+  command_path: dashboard embed usage summary
+  disposition: command
+  alias_of: null
+  operation_ids: []
+  positionals: []
+  options: []
+  sdk_symbol: mammoth.api.dashboards.DashboardsAPI.embed_usage_summary
+  sdk_conversion: Call mammoth.api.dashboards.DashboardsAPI.embed_usage_summary with validated request fields.
+  request_model: DashboardEmbedUsageSummaryRequest
+  result_model: DashboardEmbedUsageSummaryResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_read_only
+  live_test: LT-DASHBOARD-EMBED-USAGE-SUMMARY
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth dashboard embed usage summary --help
+  agent_example: 'mammoth dashboard embed usage summary --input ''{"dashboard_ids": [1]}'''
+  unit_tests:
+  - UT-DASHBOARD-EMBED-USAGE-SUMMARY
+  contract_tests:
+  - CT-DASHBOARD-EMBED-USAGE-SUMMARY-HUMAN
+  - CT-DASHBOARD-EMBED-USAGE-SUMMARY-JSON
+  - CT-DASHBOARD-EMBED-USAGE-SUMMARY-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: 'Active embed origins per board over the last 90 days, for several boards in one call (the library view). Boards outside the workspace are ignored. For one board''s origins and render counts use dashboard embed usage get.'
+  reviewed_by: primary
+  readback:
+    command: dashboard.embed.usage.summary
+    ids: {}
+    kind: object
+- command_id: dashboard.format-preview
+  command_path: dashboard format-preview
+  disposition: command
+  alias_of: null
+  operation_ids: []
+  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.format_preview
+  sdk_conversion: Call mammoth.api.dashboards.DashboardsAPI.format_preview with validated request fields.
+  request_model: DashboardFormatPreviewRequest
+  result_model: DashboardFormatPreviewResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_read_only
+  live_test: LT-DASHBOARD-FORMAT-PREVIEW
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth dashboard format-preview DASHBOARD_ID --help
+  agent_example: 'mammoth dashboard format-preview 123 --input ''{"style": "sample"}'''
+  unit_tests:
+  - UT-DASHBOARD-FORMAT-PREVIEW
+  contract_tests:
+  - CT-DASHBOARD-FORMAT-PREVIEW-HUMAN
+  - CT-DASHBOARD-FORMAT-PREVIEW-JSON
+  - CT-DASHBOARD-FORMAT-PREVIEW-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: 'Dry run of a format switch on a copy of the canvas: what carries over, what the new style adds, and what the target cannot show (not_shown). Nothing is saved. Take style names from dashboard style preset list.'
+  reviewed_by: primary
+  readback:
+    command: dashboard.format-preview
+    ids: {}
+    kind: object

{mammoth_cli-2.2.5 → mammoth_cli-2.2.6}/spec/manifests/commands/workspace.yaml

@@ -985,3 +985,40 @@ commands:
     command: workspace.user.list
     ids: {}
     kind: object
+- command_id: workspace.home
+  command_path: workspace home
+  disposition: command
+  alias_of: null
+  operation_ids: []
+  positionals: []
+  options: []
+  sdk_symbol: mammoth.api.workspaces.WorkspacesAPI.home_summary
+  sdk_conversion: Call mammoth.api.workspaces.WorkspacesAPI.home_summary with validated request fields.
+  request_model: WorkspaceHomeRequest
+  result_model: WorkspaceHomeResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_read_only
+  live_test: LT-WORKSPACE-HOME
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth workspace home --help
+  agent_example: 'mammoth workspace home'
+  unit_tests:
+  - UT-WORKSPACE-HOME
+  contract_tests:
+  - CT-WORKSPACE-HOME-HUMAN
+  - CT-WORKSPACE-HOME-JSON
+  - CT-WORKSPACE-HOME-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: 'The Home read: usage_summary (storage, plan), health_issues (type, severity, occurrence_count, available_actions) and suggestions. Read-only; not a chat turn.'
+  reviewed_by: primary
+  readback:
+    command: workspace.home
+    ids: {}
+    kind: object

{mammoth_cli-2.2.5 → mammoth_cli-2.2.6}/spec/manifests/sdk-catalog.source.yaml

@@ -4606,3 +4606,38 @@ notes_on_dispositions:
 - 'B01 FIRST_PAGE_ONLY: workspace/project/dataset/dataview list methods (and ProjectsAPI.get, ViewsResource.list,
   private dataview discovery) "have no offset/cursor. ... Add a public proven continuation contract before
   --all or completeness claims."'
+- sdk_symbol: mammoth.api.dashboards.DashboardsAPI.embed_usage_summary
+  canonical_command: dashboard.embed.usage.summary
+  alias_of: null
+  mutation_class: null
+  wait_policy: null
+  pagination_policy: null
+  openapi_operation_ids: []
+- sdk_symbol: mammoth.api.dashboards.DashboardsAPI.format_preview
+  canonical_command: dashboard.format-preview
+  alias_of: null
+  mutation_class: null
+  wait_policy: null
+  pagination_policy: null
+  openapi_operation_ids: []
+- sdk_symbol: mammoth.api.workspaces.WorkspacesAPI.home_summary
+  canonical_command: workspace.home
+  alias_of: null
+  mutation_class: null
+  wait_policy: null
+  pagination_policy: null
+  openapi_operation_ids: []
+- sdk_symbol: mammoth.api.browse.BrowseAPI.resources_list
+  canonical_command: browse.resources
+  alias_of: null
+  mutation_class: null
+  wait_policy: null
+  pagination_policy: null
+  openapi_operation_ids: []
+- sdk_symbol: mammoth.api.browse.BrowseAPI.resource_get
+  canonical_command: browse.resource
+  alias_of: null
+  mutation_class: null
+  wait_policy: null
+  pagination_policy: null
+  openapi_operation_ids: []

{mammoth_cli-2.2.5 → mammoth_cli-2.2.6}/spec/manifests/sdk-methods.yaml

@@ -7528,3 +7528,63 @@ methods:
   secret_fields:
   - token_secret
   reviewed_by: primary
+- sdk_symbol: mammoth.api.dashboards.DashboardsAPI.embed_usage_summary
+  implementation_origin: mammoth.api.dashboards.DashboardsAPI.embed_usage_summary
+  signature: 'embed_usage_summary(self, dashboard_ids: ''_list[int]'') -> ''dict[str, Any]'''
+  openapi_operation_ids: []
+  canonical_command: dashboard.embed.usage.summary
+  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.format_preview
+  implementation_origin: mammoth.api.dashboards.DashboardsAPI.format_preview
+  signature: 'format_preview(self, dashboard_id: ''int'', style: ''str'') -> ''dict[str, Any]'''
+  openapi_operation_ids: []
+  canonical_command: dashboard.format-preview
+  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.workspaces.WorkspacesAPI.home_summary
+  implementation_origin: mammoth.api.workspaces.WorkspacesAPI.home_summary
+  signature: 'home_summary(self) -> ''dict[str, Any]'''
+  openapi_operation_ids: []
+  canonical_command: workspace.home
+  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.browse.BrowseAPI.resources_list
+  implementation_origin: mammoth.api.browse.BrowseAPI.resources_list
+  signature: 'resources_list(self, project_id: ''int | None'' = None, parent_type: ''str | None'' = None, parent_id: ''int | None'' = None, resource_type: ''str | None'' = None, search: ''str | None'' = None, cursor: ''str | None'' = None, limit: ''int | None'' = None, sort: ''str | None'' = None, fields: ''str | None'' = None) -> ''dict[str, Any]'''
+  openapi_operation_ids: []
+  canonical_command: browse.resources
+  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.browse.BrowseAPI.resource_get
+  implementation_origin: mammoth.api.browse.BrowseAPI.resource_get
+  signature: 'resource_get(self, resource_type: ''str'', object_id: ''int'', project_id: ''int | None'' = None) -> ''dict[str, Any]'''
+  openapi_operation_ids: []
+  canonical_command: browse.resource
+  alias_of: null
+  no_command_reason: null
+  mutation_class: null
+  wait_policy: null
+  pagination_policy: null
+  secret_fields: []
+  reviewed_by: primary