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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.0.64
+Version: 2.0.66
 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.8,>=0.7.31
+Requires-Dist: mammoth-io<0.8,>=0.7.32
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.12.5
 Requires-Dist: pyyaml<7,>=6

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

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

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.0.64
+version: 2.0.66
 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.64 → mammoth_cli-2.0.66}/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 567; 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 571; 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:
 
@@ -32,7 +32,7 @@ Load only the applicable domain file:
 - [log](commands/log.md) — 2 published commands
 - [notification](commands/notification.md) — 5 published commands
 - [parameter](commands/parameter.md) — 14 published commands
-- [project](commands/project.md) — 20 published commands
+- [project](commands/project.md) — 23 published commands
 - [report](commands/report.md) — 1 published commands
 - [schedule](commands/schedule.md) — 5 published commands
 - [schema](commands/schema.md) — 3 published commands
@@ -45,7 +45,7 @@ Load only the applicable domain file:
 - [user](commands/user.md) — 8 published commands
 - [version](commands/version.md) — 1 published commands
 - [view-transform](commands/view-transform.md) — 32 published commands
-- [view](commands/view.md) — 87 published commands
+- [view](commands/view.md) — 88 published commands
 - [webhook](commands/webhook.md) — 7 published commands
 - [workflow](commands/workflow.md) — 16 published commands
 - [workspace](commands/workspace.md) — 20 published commands

{mammoth_cli-2.0.64 → mammoth_cli-2.0.66}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/project.md

@@ -102,6 +102,36 @@ Result: `ProjectListResult`; 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. Final check: only project 3 (API Tests_project, pre-existing, not touched) remains; project 41 is gone. Project 40 (golden-... concurrent run) was also gone by this point but was never tou…
 
+### `project.memory.add`
+
+Run: `mammoth project memory add`. Exact input fields: `mammoth schema get project.memory.add`.
+
+Example: `mammoth project memory add 123 --input '{"text": "sample"}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `ProjectMemoryAddResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `project.memory.list`
+
+Run: `mammoth project memory list`. Exact input fields: `mammoth schema get project.memory.list`.
+
+Example: `mammoth project memory list 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `ProjectMemoryListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `project.memory.remove`
+
+Run: `mammoth project memory remove`. Exact input fields: `mammoth schema get project.memory.remove`.
+
+Example: `mammoth project memory remove 123 --input '{"index": 1}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `ProjectMemoryRemoveResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `project.pending-changes`
 
 Run: `mammoth project pending-changes`. Exact input fields: `mammoth schema get project.pending-changes`.

{mammoth_cli-2.0.64 → mammoth_cli-2.0.66}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/view.md

@@ -222,6 +222,16 @@ Result: `ViewDataAggregateResult`; mutation `read`, confirmation `none`, wait po
 
 Status on release: untried; no live run recorded.
 
+### `view.data.explore`
+
+Run: `mammoth view data explore`. Exact input fields: `mammoth schema get view.data.explore`.
+
+Example: `mammoth view data explore 123 Status 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `ViewDataExploreResult`; mutation `read`, confirmation `none`, wait policy `always_wait`.
+
+Status on release: untried; no live run recorded.
+
 ### `view.data.get`
 
 Run: `mammoth view data get`. Exact input fields: `mammoth schema get view.data.get`.

{mammoth_cli-2.0.64 → mammoth_cli-2.0.66}/mammoth_cli/commands/project.py

@@ -141,6 +141,32 @@ def project_pending_changes(invocation: Invocation) -> HandlerResult:
     return data, _meta(invocation, auth.workspace_id, project_id)
 
 
+def project_memory_list(invocation: Invocation) -> HandlerResult:
+    """List the caller's saved agent preferences for a project."""
+    project_id = _project_id(invocation)
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), project_id=project_id)
+    return data, _meta(invocation, auth.workspace_id, project_id)
+
+
+def project_memory_add(invocation: Invocation) -> HandlerResult:
+    """Save one agent preference (``text`` from ``--input``) for the caller."""
+    project_id = _project_id(invocation)
+    text = _require_input_field(invocation.load_input(), "text")
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), project_id=project_id, text=text)
+    return data, _meta(invocation, auth.workspace_id, project_id)
+
+
+def project_memory_remove(invocation: Invocation) -> HandlerResult:
+    """Remove the caller's saved preference at ``index`` (from ``--input``)."""
+    project_id = _project_id(invocation)
+    index = _require_input_field(invocation.load_input(), "index")
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), project_id=project_id, index=index)
+    return data, _meta(invocation, auth.workspace_id, project_id)
+
+
 def project_resource_status(invocation: Invocation) -> HandlerResult:
     """Report the status of a project's resources."""
     project_id = _project_id(invocation)

{mammoth_cli-2.0.64 → mammoth_cli-2.0.66}/mammoth_cli/commands/registry.py

@@ -207,6 +207,9 @@ HANDLERS: dict[str, Handler] = {
     "project.get": project_cmd.project_get,
     "project.check": project_cmd.project_check,
     "project.pending-changes": project_cmd.project_pending_changes,
+    "project.memory.list": project_cmd.project_memory_list,
+    "project.memory.add": project_cmd.project_memory_add,
+    "project.memory.remove": project_cmd.project_memory_remove,
     "project.resource-status": project_cmd.project_resource_status,
     "project.resource-dependencies": project_cmd.project_resource_dependencies,
     "project.resource-dependencies.update": project_cmd.project_resource_dependencies_update,
@@ -597,6 +600,7 @@ HANDLERS: dict[str, Handler] = {
     "view.data.get": view_cmd.view_data_get,
     "view.data.query": view_cmd.view_data_query,
     "view.data.aggregate": view_cmd.view_data_aggregate,
+    "view.data.explore": view_cmd.view_data_explore,
     "view.exportable-config.get": view_cmd.view_exportable_config_get,
     "view.exportable-config.apply": view_cmd.view_exportable_config_apply,
     "view.conditional-format.create": view_cmd.view_conditional_format_create,

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

@@ -85,7 +85,7 @@ _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",
+    "view.export.publish-db": "publish database live connection odbc bi tool reads table",
     "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",
@@ -99,7 +99,6 @@ _COMMAND_DISCOVERY_PURPOSES = {
         "from a point in the task sequence"
     ),
     "view.draft.submit": "apply submit run execute a pending draft changes",
-    "webhook.create": "webhook http endpoint api push create",
     "webhook.update": "webhook http endpoint api update",
     "webhook.get": "webhook http endpoint api get",
     "webhook.list": "webhook http endpoint api list",
@@ -168,10 +167,6 @@ _COMMAND_DISCOVERY_PURPOSES = {
         "bring in migrate move transfer switch old existing dashboards dashboard over power "
         "bi report tableau file upload"
     ),
-    "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"
-    ),
     # One entry per ``view transform`` command, in the words a user states a
     # goal in rather than Mammoth's own task names.  This is the CLI's version
     # of the web app's Transform menu; keep every transform listed.
@@ -257,6 +252,52 @@ _COMMAND_DISCOVERY_PURPOSES = {
         "window rank row number running total cumulative sum moving average lag lead "
         "previous next row partition"
     ),
+    # 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 "
+        "distribution spread histogram top most common frequent values breakdown share "
+        "percentage profile"
+    ),
+    # Goals users state in their own words, one entry per command the agent's
+    # system prompt used to spell out by hand.
+    "dashboard.suggestion.list": "ideas suggest suggestions what to show put on a board chart",
+    "dashboard.analytics": "who viewed seen opened views visitors usage of a board",
+    "dashboard.share": "share make live publish board for the team link access",
+    "connector.connection.list": "which outside external sources connected connections list",
+    "project.pending-changes": (
+        "source changes new rows not taken in yet pending updates waiting to apply"
+    ),
+    "project.resource-status": "stuck stale failing broken error status anything wrong health",
+    "connector.ai.chat": (
+        "connect our own internal custom api build a connector for an unsupported source"
+    ),
+    "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"
+    ),
+    "dataset.create-from-pdf": "pdf table document extract into a dataset",
+    "view.checkpoint.create": (
+        "stop halt pause pipeline alert notify flag when rows match a rule condition checkpoint"
+    ),
+    "view.data-check.create": "data quality check rule validate rows match condition flag",
+    "view.derivative.create": "metric kpi number single value to check track daily monitor",
+    "view.draft.auto-run": (
+        "stop prevent re-running rerun automatically when source changes auto run enable disable"
+    ),
+    "data-app.create": (
+        "page portal form others drop upload a file cleaned the same way self service"
+    ),
+    "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 "
+        "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",
+    "project.memory.list": "remembered saved preferences what do you remember memory",
+    "project.memory.remove": "forget remove delete saved preference memory",
 }
 
 # A compact string scope is retained for existing discovery consumers.  These
@@ -380,6 +421,10 @@ _DISCOVERY_STOPWORDS = frozenset(
         "this",
         "that",
         "how",
+        "what",
+        "is",
+        # The tail of "what's"/"it's" once the apostrophe splits the word.
+        "s",
         "do",
         "want",
         "need",

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

@@ -978,13 +978,40 @@ def _build_metric_fields(
     return {"metric": resolved}, {"metric": resolved["as_name"]}
 
 
+_METRIC_ANY_TYPE_FUNCTIONS = frozenset({"COUNT", "DISTINCT_COUNT"})
+
+
+def _require_numeric_metric(
+    document: dict[str, Any], column_types: dict[str, str], view_id: int
+) -> None:
+    """Refuse a METRIC the backend cannot compute: it stores a NUMERIC value,
+    so only COUNT/DISTINCT_COUNT work on a non-numeric column."""
+    metric = document.get("metric")
+    if not isinstance(metric, dict):
+        return
+    column = metric.get("column")
+    function = str(metric.get("function", "")).upper()
+    column_type = column_types.get(str(column), "")
+    if function in _METRIC_ANY_TYPE_FUNCTIONS or column_type in ("", "NUMERIC"):
+        return
+    raise CliError(
+        code=CODE_INVALID_ARGUMENTS,
+        message=f"A metric is a number: {function} of the {column_type} column '{column}' "
+        "cannot be computed here.",
+        exit_status=EXIT_USAGE,
+        hint=f"For the latest or earliest value run: mammoth view data explore {view_id} "
+        f'{column} --input \'{{"column_type": "{column_type}", "level": "DAY", '
+        '"sort": "value_desc", "limit": 1}\' (value_asc for the earliest).',
+    )
+
+
 def view_data_aggregate(invocation: Invocation) -> HandlerResult:
     """Aggregate a dataview's data: a PIVOT group-by or a single METRIC value.
 
     Read-only: computes and returns the aggregated result without adding a
     task to the view's pipeline or otherwise changing it. Pass exactly one of
     ``aggregations`` (a PIVOT; ``group_by`` is optional) or ``metric`` (a
-    METRIC). ``function`` is one of SUM, COUNT, AVG, MIN, MAX. An optional
+    METRIC). ``function`` is one of SUM, COUNT, AVG, MIN, MAX, STDDEV, DISTINCT_COUNT. An optional
     ``condition`` filters rows before aggregating, and ``sequence`` pins the
     read to a pipeline step (default: latest). Never use ``view transform
     pivot`` just to read a number — it mutates the view's pipeline.
@@ -1012,6 +1039,7 @@ def view_data_aggregate(invocation: Invocation) -> HandlerResult:
         if has_pivot:
             fields, as_map = _build_pivot_fields(document, display_to_internal)
         else:
+            _require_numeric_metric(document, column_types, view_id)
             fields, as_map = _build_metric_fields(document, display_to_internal)
         kwargs: dict[str, Any] = {
             "dataset_id": dataset_id,
@@ -1030,6 +1058,74 @@ def view_data_aggregate(invocation: Invocation) -> HandlerResult:
     return data, _meta(invocation, auth.workspace_id, project_id)
 
 
+def _require_string_positional_at(invocation: Invocation, index: int, name: str) -> str:
+    """Return the positional argument at ``index`` as a nonblank string, or raise."""
+    if len(invocation.extra_args) <= index or not str(invocation.extra_args[index]).strip():
+        raise CliError(
+            code=CODE_MISSING_ARGUMENT,
+            message=f"This command requires a {name} argument.",
+            exit_status=EXIT_USAGE,
+            hint=f"Pass the {name} as a positional argument.",
+        )
+    return str(invocation.extra_args[index])
+
+
+def view_data_explore(invocation: Invocation) -> HandlerResult:
+    """Explore one column: trend, distribution, or top values, like the web app's
+    column Explore card.
+
+    Read-only: computes and returns the result without adding a task to the
+    view's pipeline or otherwise changing it. Buckets by the column's type --
+    a DATE column by ``level`` (default "AUTO"; or DAY/WEEK/MONTH/QUARTER/
+    YEAR/...) for a trend "over time"/"by month"/"by year"; a NUMERIC column
+    by ``level`` resolution (default "AUTO") for a distribution/histogram; any
+    other column (TEXT) as its top values by count, ``limit`` (default 20).
+    Every bucket carries ``count`` and ``percentage`` of the column's total.
+    An optional ``metric`` ``{"column": ..., "function": ...}`` (SUM, COUNT,
+    AVG, MIN, MAX, STDDEV or DISTINCT_COUNT) adds a second aggregate per bucket over another column,
+    and an optional ``condition`` filters rows first -- same as ``view data
+    aggregate``, which this command wraps for the raw PIVOT shape. Never use
+    ``view transform pivot`` just to explore a column; it mutates the
+    pipeline.
+    """
+    project_id = require_project(invocation)
+    view_id = _require_int_positional_at(invocation, 0, "view id")
+    column_arg = _require_string_positional_at(invocation, 1, "column")
+    document = invocation.load_input() or {}
+    with open_service(invocation) as (service, auth):
+        dataset_id = _resolve_dataset_id(service, invocation, view_id, document, 2)
+        internal_to_display, column_types = _column_profile(
+            service, dataset_id, view_id, project_id
+        )
+        display_to_internal = {
+            display: internal for internal, display in internal_to_display.items()
+        }
+        internal_column = display_to_internal.get(column_arg, column_arg)
+        column_type = column_types.get(column_arg, "")
+        kwargs: dict[str, Any] = {
+            "dataset_id": dataset_id,
+            "dataview_id": view_id,
+            "project_id": project_id,
+            "column": internal_column,
+            "column_type": column_type,
+        }
+        as_map: dict[str, str] = {"group_0": "bucket", "agg_0": "count"}
+        metric = document.get("metric")
+        if isinstance(metric, dict):
+            resolved_metric = _resolved_aggregate_item(metric, display_to_internal)
+            kwargs["metric"] = resolved_metric
+            as_map["agg_1"] = resolved_metric["as_name"]
+        if document.get(CONDITION_KWARG) is not None:
+            compiled = compile_condition(document[CONDITION_KWARG])
+            kwargs[CONDITION_KWARG] = compiled.build(
+                display_to_internal or None, column_types or None
+            )
+        _forward_optional(document, kwargs, ("level", "sequence", "limit", "offset", "sort"))
+        data = service.call(_symbol(invocation), **kwargs)
+        data = _relabel_columns(service, dataset_id, view_id, project_id, data, as_map)
+    return data, _meta(invocation, auth.workspace_id, project_id)
+
+
 def view_exportable_config_get(invocation: Invocation) -> HandlerResult:
     """Get a dataview's exportable pipeline configuration."""
     project_id = require_project(invocation)

{mammoth_cli-2.0.64 → mammoth_cli-2.0.66}/mammoth_cli/services/command_contract.py

@@ -435,6 +435,9 @@ S2_COMMANDS = frozenset(
         "project.delete",
         "project.get",
         "project.list",
+        "project.memory.add",
+        "project.memory.list",
+        "project.memory.remove",
         "project.pending-changes",
         "project.publish-credentials",
         "project.resource-dependencies",

{mammoth_cli-2.0.64 → mammoth_cli-2.0.66}/mammoth_cli/services/positionals.py

@@ -261,6 +261,9 @@ POSITIONAL_OVERRIDES: dict[str, tuple[PositionalSpec, ...]] = {
     "project.get": _optional_project_id(),
     "project.check": _optional_project_id(),
     "project.pending-changes": _optional_project_id(),
+    "project.memory.list": _optional_project_id(),
+    "project.memory.add": _optional_project_id(),
+    "project.memory.remove": _optional_project_id(),
     "project.resource-status": _optional_project_id(),
     "project.resource-dependencies": _optional_project_id(),
     "project.resource-dependencies.update": _optional_project_id(),
@@ -617,6 +620,34 @@ POSITIONAL_OVERRIDES: dict[str, tuple[PositionalSpec, ...]] = {
             ("view.version.update", "version_id", "ID of the pipeline version."),
         )
     },
+    # ``view data explore`` takes VIEW_ID first, then the required COLUMN (a
+    # display name, not an id -- the only ``str``-typed sub-positional in this
+    # family), then the OPTIONAL trailing DATASET_ID resolved from the view,
+    # mirroring the sub-resource commands above. ``column`` is a real,
+    # positional-sourced parameter of ``DataviewsAPI.explore``, so it stays out
+    # of the advertised --input fields without needing ``fills_sdk_param``.
+    "view.data.explore": (
+        PositionalSpec(
+            name="view_id",
+            type=int,
+            required=True,
+            help="ID of the view to act on.",
+            fills_sdk_param="dataview_id",
+        ),
+        PositionalSpec(
+            name="column",
+            type=str,
+            required=True,
+            help="Display name of the column to explore.",
+        ),
+        PositionalSpec(
+            name="dataset_id",
+            type=int,
+            required=False,
+            help="ID of the dataset the view belongs to; resolved from the view when omitted.",
+            falls_back_to_field="dataset_id",
+        ),
+    ),
     # ``billing hosted-page`` takes the page's object type as a positional OR an
     # ``object_type`` --input field (handler dual-sources
     # ``_string_positional(invocation) or document.get("object_type")``). The SDK

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

@@ -1,13 +1,13 @@
 [project]
 name = "mammoth-cli"
-version = "2.0.64"
+version = "2.0.66"
 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.7.31,<0.8)",
+    "mammoth-io (>=0.7.32,<0.8)",
     "typer (>=0.27,<0.28)",
     "rich (>=15,<16)",
     "platformdirs (>=4.10,<5)",

{mammoth_cli-2.0.64 → mammoth_cli-2.0.66}/spec/manifests/commands/automation.yaml

@@ -40,7 +40,9 @@ commands:
   draft_test: null
   undo_test: null
   known_restrictions: 'B15 AUTOMATION_EXTERNAL_EFFECTS: task models can pull cloud files and send email;
-    requires connector/email allowlists and dedicated fixtures.'
+    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.'
   reviewed_by: primary
 - command_id: automation.delete
   command_path: automation delete

{mammoth_cli-2.0.64 → mammoth_cli-2.0.66}/spec/manifests/commands/billing.yaml

@@ -814,5 +814,5 @@ commands:
   - CT-BILLING-SUBSCRIPTION-UPDATE-ERROR
   draft_test: null
   undo_test: null
-  known_restrictions: null
+  known_restrictions: 'Plans: storage 1 GB Free, 10 GB Starter, 50 GB Pro; users 1, 5, 10.'
   reviewed_by: primary

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

@@ -283,7 +283,8 @@ commands:
     bi-preflight. Terminal mode writes `output_path` to local disk. Inside the Mammoth app the
     download cannot reach the user: run `dashboard bi-preflight` to tell them what will convert,
     then send them to the dashboard's Publish menu (the arrow next to Publish) -> Export to Power
-    BI / Export to Tableau, where they download the file themselves."
+    BI / Export to Tableau, where they download the file themselves. No command makes a PDF of a
+    board: that is the board's Download PDF in the app."
   reviewed_by: primary
 - command_id: dashboard.cancel-generation
   command_path: dashboard cancel-generation

{mammoth_cli-2.0.64 → mammoth_cli-2.0.66}/spec/manifests/commands/file.yaml

@@ -317,7 +317,8 @@ commands:
     upload well under 16 MB: split larger files or upload a zip/gz. Parsing is asynchronous; use --timeout 300 for files past a few MB and poll the returned
     job on timeout. Upload authorization is tenant- and scope-specific; a permission failure does not
     make this route universally unavailable. On success retain returned IDs, read them back, and
-    verify owned cleanup; do not assume other upload variants are qualified.'
+    verify owned cleanup; do not assume other upload variants are qualified. Each sheet of an Excel
+    file becomes its own dataset.'
   reviewed_by: primary
 - command_id: file.upload-folder
   command_path: file upload-folder

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

@@ -384,6 +384,123 @@ commands:
   undo_test: null
   known_restrictions: 'B01 FIRST_PAGE_ONLY: no offset/cursor continuation proven yet.'
   reviewed_by: primary
+- command_id: project.memory.list
+  command_path: project memory list
+  disposition: command
+  alias_of: null
+  operation_ids: []
+  positionals:
+  - name: project_id
+    type: int
+    required: false
+    metavar: PROJECT_ID
+    falls_back_to_field: null
+    help: ID of the project to act on; defaults to the active project.
+  options: []
+  sdk_symbol: mammoth.api.projects.ProjectsAPI.list_agent_memory
+  sdk_conversion: Call mammoth.api.projects.ProjectsAPI.list_agent_memory with validated request fields.
+  request_model: ProjectMemoryListRequest
+  result_model: ProjectMemoryListResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: contract_only_no_disposable_fixture
+  live_test: null
+  live_exemption_reason: No automated disposable-project fixture wired into tests/live yet for this command.
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth project memory list --help
+  agent_example: 'mammoth project memory list 123'
+  unit_tests:
+  - UT-PROJECT-MEMORY-LIST
+  contract_tests:
+  - CT-PROJECT-MEMORY-LIST-HUMAN
+  - CT-PROJECT-MEMORY-LIST-JSON
+  - CT-PROJECT-MEMORY-LIST-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: 'The saved preferences are the caller''s own, per project, oldest first; the in-app agent reads them at the start of every turn. Remove one by its zero-based position in this list.'
+  reviewed_by: primary
+- command_id: project.memory.add
+  command_path: project memory add
+  disposition: command
+  alias_of: null
+  operation_ids: []
+  positionals:
+  - name: project_id
+    type: int
+    required: false
+    metavar: PROJECT_ID
+    falls_back_to_field: null
+    help: ID of the project to act on; defaults to the active project.
+  options: []
+  sdk_symbol: mammoth.api.projects.ProjectsAPI.add_agent_memory
+  sdk_conversion: Call mammoth.api.projects.ProjectsAPI.add_agent_memory with validated request fields.
+  request_model: ProjectMemoryAddRequest
+  result_model: ProjectMemoryAddResult
+  mutation_class: benign_mutation
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: contract_only_no_disposable_fixture
+  live_test: null
+  live_exemption_reason: No automated disposable-project fixture wired into tests/live yet for this command.
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth project memory add --help
+  agent_example: 'mammoth project memory add 123 --input ''{"text": "sample"}'''
+  unit_tests:
+  - UT-PROJECT-MEMORY-ADD
+  contract_tests:
+  - CT-PROJECT-MEMORY-ADD-HUMAN
+  - CT-PROJECT-MEMORY-ADD-JSON
+  - 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.'
+  reviewed_by: primary
+- command_id: project.memory.remove
+  command_path: project memory remove
+  disposition: command
+  alias_of: null
+  operation_ids: []
+  positionals:
+  - name: project_id
+    type: int
+    required: false
+    metavar: PROJECT_ID
+    falls_back_to_field: null
+    help: ID of the project to act on; defaults to the active project.
+  options: []
+  sdk_symbol: mammoth.api.projects.ProjectsAPI.remove_agent_memory
+  sdk_conversion: Call mammoth.api.projects.ProjectsAPI.remove_agent_memory with validated request fields.
+  request_model: ProjectMemoryRemoveRequest
+  result_model: ProjectMemoryRemoveResult
+  mutation_class: benign_mutation
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: contract_only_no_disposable_fixture
+  live_test: null
+  live_exemption_reason: No automated disposable-project fixture wired into tests/live yet for this command.
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth project memory remove --help
+  agent_example: 'mammoth project memory remove 123 --input ''{"index": 1}'''
+  unit_tests:
+  - UT-PROJECT-MEMORY-REMOVE
+  contract_tests:
+  - CT-PROJECT-MEMORY-REMOVE-HUMAN
+  - CT-PROJECT-MEMORY-REMOVE-JSON
+  - CT-PROJECT-MEMORY-REMOVE-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: 'index is the zero-based position from project memory list; use it when the user asks to forget a preference.'
+  reviewed_by: primary
 - command_id: project.pending-changes
   command_path: project pending-changes
   disposition: command