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

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

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

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

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.0.67
+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.67 → mammoth_cli-2.0.68}/mammoth_cli/commands/schema.py

@@ -257,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"
     ),

{mammoth_cli-2.0.67 → 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.67 → mammoth_cli-2.0.68}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mammoth-cli"
-version = "2.0.67"
+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.67 → 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