mammoth-cli 2.1.2__tar.gz → 2.1.4__tar.gz

{mammoth_cli-2.1.2 → mammoth_cli-2.1.4}/PKG-INFO

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

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

{mammoth_cli-2.1.2 → mammoth_cli-2.1.4}/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 579; 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 580; 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:
 
@@ -10,7 +10,7 @@ Load only the applicable domain file:
 - [ai](commands/ai.md) — 5 published commands
 - [annotation](commands/annotation.md) — 5 published commands
 - [auth](commands/auth.md) — 3 published commands
-- [automation](commands/automation.md) — 7 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) — 4 published commands

{mammoth_cli-2.1.2 → mammoth_cli-2.1.4}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/automation.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, *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).
 
+### `automation.capabilities`
+
+Run: `mammoth automation capabilities`. Exact input fields: `mammoth schema get automation.capabilities`.
+
+Example: `mammoth automation capabilities`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `AutomationCapabilitiesResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `automation.create`
 
 Run: `mammoth automation create`. Exact input fields: `mammoth schema get automation.create`.

{mammoth_cli-2.1.2 → mammoth_cli-2.1.4}/mammoth_cli/commands/automation.py

@@ -171,6 +171,13 @@ def automation_list(invocation: Invocation) -> HandlerResult:
     return data, _meta(invocation, auth.workspace_id, resolved_project(invocation))
 
 
+def automation_capabilities(invocation: Invocation) -> HandlerResult:
+    """List every task, trigger, option and file format automations support."""
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation))
+    return data, _meta(invocation, auth.workspace_id, resolved_project(invocation))
+
+
 def automation_get(invocation: Invocation) -> HandlerResult:
     """Get one automation by id. Automation id is positional."""
     automation_id = _require_int_positional(invocation, "automation id")

{mammoth_cli-2.1.2 → mammoth_cli-2.1.4}/mammoth_cli/commands/dashboard.py

@@ -54,6 +54,7 @@ from mammoth_cli.services.dashboard_review import (
     NEW_COLUMN_NOTE,
     columns_not_on_dashboard,
     has_profiles,
+    reporting_month,
     review,
 )
 from mammoth_cli.services.positionals import resolve_positionals
@@ -796,15 +797,20 @@ def _deliverable_warnings(
         if isinstance(view_id, int) and dataset_id is not None
         else None
     )
+    scope = reporting_month(canvas_doc, dashboard_id)
     if not has_profiles(canvas_doc):
-        return review(canvas_doc, dataset_id, current)
+        return scope + review(canvas_doc, dataset_id, current)
     stale = columns_not_on_dashboard(canvas_doc, current)
-    return stale + [
-        warning
-        for warning in review(canvas_doc, dataset_id)
-        # On a stale board the money advice is the rebuild, not a new column.
-        if not (stale and warning["issue"] in {"money_not_shown", "unit_price_summed"})
-    ]
+    return (
+        scope
+        + stale
+        + [
+            warning
+            for warning in review(canvas_doc, dataset_id)
+            # On a stale board the money advice is the rebuild, not a new column.
+            if not (stale and warning["issue"] in {"money_not_shown", "unit_price_summed"})
+        ]
+    )
 
 
 _CANVAS_SAVE = "mammoth.api.dashboards.DashboardsAPI.canvas_save"

{mammoth_cli-2.1.2 → mammoth_cli-2.1.4}/mammoth_cli/commands/registry.py

@@ -507,6 +507,7 @@ HANDLERS: dict[str, Handler] = {
     "user.update": user_cmd.user_update,
     # automation family
     "automation.list": automation_cmd.automation_list,
+    "automation.capabilities": automation_cmd.automation_capabilities,
     "automation.get": automation_cmd.automation_get,
     "automation.trash": automation_cmd.automation_trash,
     "automation.restore": automation_cmd.automation_restore,

{mammoth_cli-2.1.2 → mammoth_cli-2.1.4}/mammoth_cli/commands/schema.py

@@ -406,6 +406,12 @@ _COMMAND_DISCOVERY_PURPOSES = {
     "data-app.create": (
         "page portal form others drop upload a file cleaned the same way self service"
     ),
+    # "does automation support pdf" -- what an automation reads, writes, triggers on
+    # and accepts is answered by the server, not by memory.
+    "automation.capabilities": (
+        "automation automations support supports supported pdf csv format formats file types "
+        "can do what trigger triggers action actions task tasks option options capabilities"
+    ),
     "automation.create": (
         "schedule scheduled recurring repeat refresh rerun run every day daily week weekly "
         "hour hourly month monthly automatically trigger alert email a dataset pipeline "

{mammoth_cli-2.1.2 → mammoth_cli-2.1.4}/mammoth_cli/services/dashboard_review.py

@@ -334,3 +334,30 @@ def columns_not_on_dashboard(
 def has_profiles(canvas_doc: Any) -> bool:
     """Whether a canvas read carries the backend's column profile."""
     return isinstance(canvas_doc, Mapping) and bool(_profiles(canvas_doc))
+
+
+def reporting_month(canvas_doc: Any, dashboard_id: int) -> list[dict[str, Any]]:
+    """``board_scoped_to_month`` when the board reports one month of its data.
+
+    The builder opens a new board on the data's latest month when the ask names
+    no period, so "total sales and sales by region" came back as December 2018
+    only (UQA-RT22-01). Only the agent knows whether the user asked for a month,
+    so it is shown the scope and the one edit that widens it.
+    """
+    canvas = canvas_doc.get("canvas") if isinstance(canvas_doc, Mapping) else None
+    period = canvas.get("period") if isinstance(canvas, Mapping) else None
+    month = period.get("value") if isinstance(period, Mapping) else None
+    if not isinstance(month, str):
+        return []
+    prompt = json.dumps({"body": {"params": {"prompt": "Cover all dates: no reporting month"}}})
+    return [
+        {
+            "issue": "board_scoped_to_month",
+            "detail": (
+                f"This board reports only {month}: its KPI cards, breakdowns and table count "
+                "that month, while trend charts still plot every date. If the user did not "
+                "ask for that month, widen it with the fix."
+            ),
+            "fix": f"mammoth dashboard chat edit {dashboard_id} --input '{prompt}'",
+        }
+    ]

{mammoth_cli-2.1.2 → mammoth_cli-2.1.4}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "mammoth-cli"
-version = "2.1.2"
+version = "2.1.4"
 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.0,<0.9)",
+    "mammoth-io (>=0.8.1,<0.9)",
     "typer (>=0.27,<0.28)",
     "rich (>=15,<16)",
     "platformdirs (>=4.10,<5)",

{mammoth_cli-2.1.2 → mammoth_cli-2.1.4}/spec/manifests/commands/automation.yaml

@@ -1,5 +1,43 @@
 manifest_schema_version: 1
 commands:
+- command_id: automation.capabilities
+  command_path: automation capabilities
+  disposition: command
+  alias_of: null
+  operation_ids:
+  - GetAutomationCapabilities
+  positionals: []
+  options: []
+  sdk_symbol: mammoth.api.automations.AutomationsAPI.capabilities
+  sdk_conversion: Call mammoth.api.automations.AutomationsAPI.capabilities with validated request fields.
+  request_model: AutomationCapabilitiesRequest
+  result_model: AutomationCapabilitiesResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_read_only
+  live_test: null
+  live_exemption_reason: Live coverage is tests/live/test_automation_capabilities.py (runs on the test server).
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth automation capabilities --help
+  agent_example: mammoth automation capabilities
+  unit_tests:
+  - UT-AUTOMATION-CAPABILITIES
+  contract_tests:
+  - CT-AUTOMATION-CAPABILITIES-HUMAN
+  - CT-AUTOMATION-CAPABILITIES-JSON
+  - CT-AUTOMATION-CAPABILITIES-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: 'Read-only. Lists everything an automation supports, straight from the server: tasks
+    (each with task_type, summary, required_fields, optional_fields, options = accepted values per field,
+    formats_in and formats_out = file formats it reads or writes) and conditions (the triggers: condition_type,
+    summary, fields, options). Answer "can an automation do X?" (a PDF, an email attachment, a schedule)
+    from this, never from memory. Then create with `automation create`.'
+  reviewed_by: primary
 - command_id: automation.create
   command_path: automation create
   disposition: command
@@ -40,7 +78,8 @@ commands:
   - CT-AUTOMATION-CREATE-ERROR
   draft_test: null
   undo_test: null
-  known_restrictions: 'B15 AUTOMATION_EXTERNAL_EFFECTS: task models can pull cloud files and send email;
+  known_restrictions: 'B15 AUTOMATION_EXTERNAL_EFFECTS: run `automation capabilities` first: it lists every
+    task, trigger, option and file format in and out (PDF included). Task models can pull cloud files and send email;
     requires connector/email allowlists and dedicated fixtures. Delete old rows on a schedule with
     task apply_retention_policy (datasource_id, rule_type time_based, count_based or
     condition_based). An emailed file is task send_an_alert with attachments.dataview_ids: each

{mammoth_cli-2.1.2 → mammoth_cli-2.1.4}/spec/manifests/openapi-operations.yaml

@@ -4846,6 +4846,25 @@ operations:
   alias_of: null
   sdk_symbol: mammoth.api.automations.AutomationsAPI.list
   reviewed_by: primary
+- identity: GET /workspaces/{workspace_id}/projects/{project_id}/automations/capabilities
+  method: GET
+  path: /workspaces/{workspace_id}/projects/{project_id}/automations/capabilities
+  operation_id: GetAutomationCapabilities
+  tags:
+  - Automations
+  summary: Get automation capabilities
+  security:
+  - apiKey
+  - apiSecret
+  request_schema: null
+  response_schemas: []
+  deprecated: false
+  disposition: command
+  disposition_reason: User-initiated production operation.
+  canonical_command: automation.capabilities
+  alias_of: null
+  sdk_symbol: mammoth.api.automations.AutomationsAPI.capabilities
+  reviewed_by: primary
 - identity: POST /workspaces/{workspace_id}/projects/{project_id}/automations
   method: POST
   path: /workspaces/{workspace_id}/projects/{project_id}/automations

{mammoth_cli-2.1.2 → mammoth_cli-2.1.4}/spec/manifests/sdk-catalog.source.yaml

@@ -469,6 +469,13 @@ sdk_methods:
   wait_policy: null
   pagination_policy: null
   openapi_operation_ids: []
+- sdk_symbol: mammoth.api.automations.AutomationsAPI.capabilities
+  canonical_command: automation.capabilities
+  alias_of: null
+  mutation_class: read
+  wait_policy: not_async
+  pagination_policy: none
+  openapi_operation_ids: []
 - sdk_symbol: mammoth.api.automations.AutomationsAPI.create
   canonical_command: automation.create
   alias_of: null
@@ -476,7 +483,8 @@ sdk_methods:
   wait_policy: not_async
   pagination_policy: none
   openapi_operation_ids: []
-  notes: 'B15 AUTOMATION_EXTERNAL_EFFECTS: task models can pull cloud files and send email; requires connector/email
+  notes: 'B15 AUTOMATION_EXTERNAL_EFFECTS: what automations support (tasks, triggers, options, file formats
+    in and out) is listed by `automation capabilities`. Task models can pull cloud files and send email; requires connector/email
     allowlists and dedicated fixtures. An emailed file (send_an_alert, attachments.dataview_ids) is
     sent as a CSV per view. The combined row count of all attached views must stay within 100,000
     -- over that, the automation is refused (and a run that grows past it fails).'

{mammoth_cli-2.1.2 → mammoth_cli-2.1.4}/spec/manifests/sdk-methods.yaml

@@ -764,6 +764,18 @@ methods:
   pagination_policy: null
   secret_fields: []
   reviewed_by: primary
+- sdk_symbol: mammoth.api.automations.AutomationsAPI.capabilities
+  implementation_origin: mammoth.api.automations.AutomationsAPI.capabilities
+  signature: 'capabilities(self) -> ''dict[str, Any]'''
+  openapi_operation_ids: []
+  canonical_command: automation.capabilities
+  alias_of: null
+  no_command_reason: null
+  mutation_class: read
+  wait_policy: not_async
+  pagination_policy: none
+  secret_fields: []
+  reviewed_by: primary
 - sdk_symbol: mammoth.api.automations.AutomationsAPI.create
   implementation_origin: mammoth.api.automations.AutomationsAPI.create
   signature: 'create(self, name: ''str'', description: ''str'', tasks: ''_list[AutomationTaskSpec]'', conditions: ''_list[AutomationConditionSpec] | None'' = None, condition_mode: ''AutomationConditionMode'' = <AutomationConditionMode.AND: ''and''>) -> ''dict[str, Any]'''

{mammoth_cli-2.1.2 → mammoth_cli-2.1.4}/spec/openapi/metadata.json

@@ -2,8 +2,8 @@
   "api_version": "0.1.0",
   "fetched_at": "2026-07-22T16:02:48.950866+00:00",
   "openapi_version": "3.1.0",
-  "operation_count": 447,
-  "path_count": 289,
+  "operation_count": 448,
+  "path_count": 290,
   "redacted_example_fields": [
     "api_key",
     "api_secret",
@@ -20,6 +20,6 @@
     "key (credential-shaped)"
   ],
   "schema_count": 864,
-  "sha256": "31a0b89da93732ffd8e158529d81733aaa7437a19a0c4375133b89e080bd63a5",
+  "sha256": "71036c0f1d3e7a5b6e187ca579f80f1a4c4d23fd87e68407fb0b2148257c50c1",
   "source_url": "https://app.mammoth.io/api/v2/docs/openapi.json"
 }