mammoth-cli 2.0.66__tar.gz → 2.0.68__tar.gz

{mammoth_cli-2.0.66 → mammoth_cli-2.0.68}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.0.66
+Version: 2.0.68
 Summary: Command-line interface for the Mammoth Analytics platform
 Project-URL: homepage, https://mammoth.io
 Project-URL: repository, https://github.com/EdgeMetric/mammothsdk

{mammoth_cli-2.0.66 → mammoth_cli-2.0.68}/mammoth_cli/__init__.py

@@ -6,7 +6,7 @@ not implement a second HTTP client and does not call private SDK members.
 
 from __future__ import annotations
 
-__version__ = "2.0.66"
+__version__ = "2.0.68"
 
 # The versioned machine output envelope contract.
 SCHEMA_VERSION = 1

{mammoth_cli-2.0.66 → mammoth_cli-2.0.68}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.0.66
+version: 2.0.68
 description: "Use Mammoth Analytics from a terminal: install or authenticate the CLI, discover its live command contract, and safely manage projects, data, views, pipelines (join, merge, pivot, filter, clean), dashboards, exports, and handoffs."
 ---
 

{mammoth_cli-2.0.66 → mammoth_cli-2.0.68}/mammoth_cli/commands/schema.py

@@ -63,7 +63,7 @@ _GROUP_DISCOVERY_PURPOSES = {
 _COMMAND_DISCOVERY_PURPOSES = {
     "file.upload": (
         "upload import CSV spreadsheet XLSX source data append add rows union stack "
-        "a file into an existing dataset"
+        "a file into an existing dataset excel workbook tabs sheets drop in"
     ),
     "file.upload-folder": "upload source-data directory folder",
     "view.export.csv": "export download local CSV file artifact",
@@ -85,7 +85,9 @@ _COMMAND_DISCOVERY_PURPOSES = {
     "view.export.onedrive": "one drive onedrive microsoft cloud storage",
     "view.export.postgres": "postgres postgresql database",
     "view.export.powerbi": "power bi powerbi microsoft dashboard workspace",
-    "view.export.publish-db": "publish database live connection odbc bi tool reads table",
+    "view.export.publish-db": (
+        "publish database live connection odbc bi tool reads table point straight at always latest"
+    ),
     "view.export.publish-db-update": "publish database update refresh live connection",
     "view.export.redshift": "redshift amazon aws database warehouse",
     "view.export.rest": "webhook http endpoint api push rest",
@@ -255,7 +257,7 @@ _COMMAND_DISCOVERY_PURPOSES = {
     # The web app's column Explore cards: what is trending, how a column is
     # spread, its top values, a count over time.
     "view.data.explore": (
-        "explore trend trends trending over time per day week month quarter year "
+        "explore trend trends trending over time per day week month quarter year by date "
         "distribution spread histogram top most common frequent values breakdown share "
         "percentage profile"
     ),
@@ -272,11 +274,14 @@ _COMMAND_DISCOVERY_PURPOSES = {
     "connector.ai.chat": (
         "connect our own internal custom api build a connector for an unsupported source"
     ),
+    "file.set-password": "locked password protected file pdf excel unlock",
     "project.sample-flow": "sample example demo starter data dataset try start from",
     "webhook.create": (
-        "webhook http endpoint api push create data pushed in sent from another system receive"
+        "webhook http endpoint api push create data pushed in sent from another system receive "
+        "url app post posts events rows straight in"
     ),
-    "dataset.create-from-pdf": "pdf table document extract into a dataset",
+    "dataset.create-from-pdf": "pdf table document extract get the table out of into a dataset",
+    "dashboard.pdf.export": "pdf of a board dashboard download print meeting export",
     "view.checkpoint.create": (
         "stop halt pause pipeline alert notify flag when rows match a rule condition checkpoint"
     ),
@@ -294,8 +299,16 @@ _COMMAND_DISCOVERY_PURPOSES = {
         "retention purge old data send an emailed file attachment"
     ),
     "billing.subscription.update": "upgrade downgrade bigger plan change subscription tier",
-    "billing.invoice.list": "past bills billing history invoices payments receipts",
-    "project.memory.add": "remember save preference always from now on note for next time",
+    "billing.invoice.list": "past bills billed billing history invoices payments receipts so far",
+    "project.memory.add": (
+        "remember save preference prefer prefers always from now on note for next time "
+        "amounts currency format style"
+    ),
+    # A rule about what a board's data means ("Returned orders are refunds") is
+    # the board's own context, not the user's preference.
+    "dashboard.context.create": (
+        "remember for this board dashboard rule meaning definition counts treat as business context"
+    ),
     "project.memory.list": "remembered saved preferences what do you remember memory",
     "project.memory.remove": "forget remove delete saved preference memory",
 }

{mammoth_cli-2.0.66 → mammoth_cli-2.0.68}/mammoth_cli/commands/view.py

@@ -957,8 +957,18 @@ def _build_pivot_fields(
     fields: dict[str, Any] = {"aggregations": resolved_aggregations}
     group_by = document.get("group_by")
     if group_by:
-        fields["group_by"] = [column_map.get(column, column) for column in group_by]
-        as_map.update({f"group_{index}": column for index, column in enumerate(group_by)})
+        # A string groups by the column's values; {column, truncate|resolution}
+        # buckets a DATE (DAY..YEAR) or NUMERIC column first, like Explore.
+        columns = [item["column"] if isinstance(item, dict) else item for item in group_by]
+        fields["group_by"] = [
+            (
+                {**item, "column": column_map.get(item["column"], item["column"])}
+                if isinstance(item, dict)
+                else column_map.get(item, item)
+            )
+            for item in group_by
+        ]
+        as_map.update({f"group_{index}": column for index, column in enumerate(columns)})
     return fields, as_map
 
 

{mammoth_cli-2.0.66 → mammoth_cli-2.0.68}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mammoth-cli"
-version = "2.0.66"
+version = "2.0.68"
 description = "Command-line interface for the Mammoth Analytics platform"
 authors = [{name = "Mammoth Analytics", email = "support@mammoth.io"}]
 readme = "README.md"

{mammoth_cli-2.0.66 → mammoth_cli-2.0.68}/spec/manifests/commands/dashboard.yaml

@@ -1762,7 +1762,8 @@ commands:
   undo_test: null
   known_restrictions: Backend requires params.data to be the browser-hydrated DashboardData map
     (pre-rendered widget results); the server stores only query descriptors and cannot rebuild
-    it, so a PDF cannot be produced from the CLI alone.
+    it, so a PDF cannot be produced from the CLI alone; point the user to the board's Download PDF
+    in the app.
   reviewed_by: primary
 - command_id: dashboard.published-data-by-url
   command_path: dashboard published-data-by-url

{mammoth_cli-2.0.66 → mammoth_cli-2.0.68}/spec/manifests/commands/project.yaml

@@ -460,7 +460,7 @@ commands:
   - CT-PROJECT-MEMORY-ADD-ERROR
   draft_test: null
   undo_test: null
-  known_restrictions: 'Save only a preference the user stated for how the agent works or shows things (at most 20, each at most 200 characters); never data, results or secrets. The in-app agent applies them in every later turn in this project.'
+  known_restrictions: 'Save only a preference the user stated for how the agent works or shows things (at most 20, each at most 200 characters); never data, results or secrets. The in-app agent applies them in every later turn in this project. A rule about what a board''s data means (for example, Returned orders are refunds) belongs to that board: dashboard context create.'
   reviewed_by: primary
 - command_id: project.memory.remove
   command_path: project memory remove

{mammoth_cli-2.0.66 → mammoth_cli-2.0.68}/spec/manifests/commands/view.yaml

@@ -1136,7 +1136,11 @@ commands:
   known_restrictions: 'Read-only: computes and returns an aggregated result without adding a task to
     the view''s pipeline or otherwise changing it. Pass exactly one of ''aggregations'' (a PIVOT
     group-by; ''group_by'' is optional) or ''metric'' (a single METRIC value). ''function'' is one of
-    SUM, COUNT, AVG, MIN, MAX.'
+    SUM, COUNT, AVG, MIN, MAX, STDDEV, DISTINCT_COUNT. A group_by item is a column name, or
+    {"column": C, "truncate": DAY|WEEK|MONTH|QUARTER|YEAR} to bucket a DATE (a trend over time),
+    or {"column": C, "resolution": N} to bucket a NUMERIC; grouping by a raw date gives one row per
+    day. A metric is a number: only COUNT and DISTINCT_COUNT work on a DATE or TEXT column. For one
+    column''s trend, top values or spread, view data explore is the shorter call.'
   reviewed_by: primary
 - command_id: view.data.explore
   command_path: view data explore