mammoth-cli 2.2.94__tar.gz → 2.2.96__tar.gz

{mammoth_cli-2.2.94 → mammoth_cli-2.2.96}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.2.94
+Version: 2.2.96
 Summary: Command-line interface for the Mammoth Analytics platform
 Project-URL: homepage, https://mammoth.io
 Project-URL: repository, https://github.com/EdgeMetric/mammothsdk
@@ -16,9 +16,10 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: <3.15,>=3.12
+Requires-Dist: certifi>=2026.10.19
 Requires-Dist: jsonschema>=4.20
 Requires-Dist: keyring<26,>=25.7
-Requires-Dist: mammoth-io<0.9,>=0.8.47
+Requires-Dist: mammoth-io<0.9,>=0.8.49
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.12.5
 Requires-Dist: pyyaml<7,>=6

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

{mammoth_cli-2.2.94 → mammoth_cli-2.2.96}/mammoth_cli/app.py

@@ -19,6 +19,7 @@ import inspect
 import json
 import re
 import sys
+import threading
 from collections.abc import Callable, Sequence
 from dataclasses import replace
 from difflib import get_close_matches
@@ -82,7 +83,6 @@ _GROUP_DESCRIPTIONS = {
     "log": "Locate and read the local run log.",
     "context": "Inspect and select the active project context.",
     "dashboard": "Build, query, and publish dashboards.",
-    "data-app": "Create and manage data applications.",
     "dataset": "Create, inspect, and manage datasets.",
     "external-key": "Manage LLM provider keys (OpenAI, Anthropic, etc.) used by AI features.",
     "file": (
@@ -115,19 +115,12 @@ _GROUP_DESCRIPTIONS = {
 
 # One line per ``agent`` subgroup, so ``mammoth agent --help`` tells them apart.
 _AGENT_SUBGROUP_DESCRIPTIONS = {
-    "access": "Set who may use an agent definition.",
+    "access": "Grant, request and review access to the Mammoth agent, and its settings.",
     "action": "List and delete the changes an agent chat made.",
-    "charter": "Read, change and restore an agent definition's charter.",
-    "feedback": "Read the feedback an agent definition has received.",
-    "goldens": "Manage and run the golden cases an agent definition is proven against.",
-    "memory": "Manage the facts an agent definition has learned, per project.",
     "message": "Correct the request kind of a reply in an agent chat.",
     "plan": "Approve, skip or discard the plan of an agent chat, or edit its workflow proposal.",
-    "projects": "Set or clear the projects an agent definition works in.",
     "run": "Inspect and control an agent's runs.",
-    "scratch": "Read, write and clear an agent definition's scratchpad notes per project.",
     "session": "List, read, delete and share agent chat sessions.",
-    "team": "Set the agents this agent may consult while answering.",
     "turn": "Control one turn of an agent chat session.",
 }
 
@@ -158,15 +151,20 @@ _SUBGROUP_DESCRIPTIONS = {
     "collection email-updates": "Read and set a collection's email updates, and send a test.",
     "collection email-updates me": "Read and set your own email updates for a collection.",
     "collection members": "Remove members from a collection.",
+    "automation route": "Preview and set which automation a watched folder's file goes to.",
+    "automation run-file": "Act on a file an automation run held back.",
     "connector ai": "Chat with the connector assistant to set up a connection.",
     "connector ai session": "List connector assistant sessions and their messages.",
     "connector connection": "Create, read, update and delete connector connections.",
+    "connector draft": "Build a connector step by step: sources, gaps, sample, then save.",
+    "connector draft source": "List a draft's sources, preview them and find join keys.",
     "connector ds-config": "Create, read, update and delete data-source configs.",
     "connector query": "Generate connector queries and check their status.",
     "context project": "Show, select or clear the active project.",
     "dashboard audience": "Read who views a dashboard and its digest.",
     "dashboard audience digest": "Read and set the audience digest of a dashboard.",
     "dashboard canvas": "Read, save and restore a dashboard canvas.",
+    "dashboard chart-type": "List, create and delete the workspace's own chart types.",
     "dashboard chat": "Edit a dashboard by chat and read the chat history.",
     "dashboard chat attachment": "Upload a file to a dashboard's chat.",
     "dashboard context": "Create, review, apply and manage dashboard contexts.",
@@ -184,14 +182,14 @@ _SUBGROUP_DESCRIPTIONS = {
     "dashboard embed usage": "Read embed usage and its summary.",
     "dashboard engagement": "Read a dashboard's engagement and remind its viewers.",
     "dashboard exemplar": "Extract an exemplar from a dashboard.",
-    "dashboard figure": "Add figures to a dashboard.",
+    "dashboard figure": "Add, describe and read the data behind dashboard figures.",
     "dashboard filter": "Add, list and remove dashboard filters.",
     "dashboard gallery": "List and read gallery dashboards.",
     "dashboard own-data": "Start, check and finish a dashboard's own-data setup.",
     "dashboard page": "Plan dashboard pages.",
     "dashboard pages": "Add pages to a dashboard.",
     "dashboard pdf": "Export a dashboard as a PDF.",
-    "dashboard published": "Read and export a published dashboard.",
+    "dashboard published": "Read, drill into and export a published dashboard.",
     "dashboard published pdf": "Export a published dashboard as a PDF.",
     "dashboard published video": "Export a published dashboard as a video.",
     "dashboard qa": "Ask questions of a dashboard and manage the Q&A sessions.",
@@ -216,7 +214,6 @@ _SUBGROUP_DESCRIPTIONS = {
     "dashboard templates": "Use or list pending dashboard templates.",
     "dashboard v3": "Generate v3 dashboards.",
     "dashboard video": "Export a dashboard as a video.",
-    "data-app user": "List and remove the users of a data app.",
     "dataset broken-rows": "List and resolve rows that failed to load.",
     "dataset definition": "List, save and remove what terms mean for a dataset.",
     "dataset file-settings": "Read, update and undo a dataset's file settings.",
@@ -308,7 +305,6 @@ _ROOT_HELP_PANELS = {
     "batch": "Work with data",
     "dashboard": "Build and share",
     "collection": "Build and share",
-    "data-app": "Build and share",
     "report": "Build and share",
     "template": "Build and share",
     "snippet": "Build and share",
@@ -1629,6 +1625,10 @@ def _lazy_help_command(command_id: str) -> type[TyperCommand]:
     return LazyHelpCommand
 
 
+#: Guards the lazy builds below. Re-entrant: building a command can build another.
+_BUILD_LOCK = threading.RLock()
+
+
 def _unbuilt_leaf() -> None:
     """Registration placeholder: a lazy leaf takes its real callback from the built command."""
 
@@ -1645,24 +1645,33 @@ def _lazy_leaf_command(command_id: str) -> type[TyperCommand]:
         _built: _ClickCommand | None = None
 
         def _real(self) -> _ClickCommand:
-            if self._built is None:
-                from typer.models import CommandInfo
-
-                info = CommandInfo(
-                    name=self.name,
-                    callback=_build_leaf(command_id),
-                    # The help text is read from this class's lazy ``help`` property; building
-                    # it here would import the contract and schema layers on every run.
-                    help="",
-                    rich_help_panel=self.rich_help_panel,
-                    context_settings=_leaf_context_settings(command_id),
-                )
-                self._built = typer.main.get_command_from_info(
-                    info,
-                    pretty_exceptions_short=_LAZY_SETTINGS["pretty_exceptions_short"],
-                    rich_markup_mode=self.rich_markup_mode,
-                )
-            return self._built
+            built = self._built
+            if built is not None:
+                return built
+            # Double-checked: a host's worker threads may reach a first use together.
+            with _BUILD_LOCK:
+                built = self._built
+                if built is None:
+                    built = self._built = self._build()
+            return built
+
+        def _build(self) -> _ClickCommand:
+            from typer.models import CommandInfo
+
+            info = CommandInfo(
+                name=self.name,
+                callback=_build_leaf(command_id),
+                # The help text is read from this class's lazy ``help`` property; building
+                # it here would import the contract and schema layers on every run.
+                help="",
+                rich_help_panel=self.rich_help_panel,
+                context_settings=_leaf_context_settings(command_id),
+            )
+            return typer.main.get_command_from_info(
+                info,
+                pretty_exceptions_short=_LAZY_SETTINGS["pretty_exceptions_short"],
+                rich_markup_mode=self.rich_markup_mode,
+            )
 
         @property
         def params(self) -> list[_ClickParameter]:
@@ -1924,7 +1933,9 @@ def registered_command_paths() -> set[str]:
     return paths
 
 
-@cache
+_ROOT_COMMAND: Any = None
+
+
 def _root_click_command() -> Any:
     """Build (once) and cache the fully resolved Click command tree.
 
@@ -1933,11 +1944,19 @@ def _root_click_command() -> Any:
     that is expensive enough that recomputing it per lookup made a full sweep
     over every command (see the contract test) take minutes. Cached because
     the tree is fixed for the process lifetime (:data:`app` is built once at
-    import time).
+    import time). Built under a lock, so a host's threads making their first call
+    together share one tree instead of each building their own.
     """
-    root: Any = typer.main.get_command(app)
-    root.commands  # noqa: B018 -- materialise every lazy top-level group
-    return root
+    global _ROOT_COMMAND
+    root = _ROOT_COMMAND
+    if root is not None:
+        return root
+    with _BUILD_LOCK:
+        if _ROOT_COMMAND is None:
+            built: Any = typer.main.get_command(app)
+            built.commands  # noqa: B018 -- materialise every lazy top-level group
+            _ROOT_COMMAND = built
+        return _ROOT_COMMAND
 
 
 def command_option_names(command_path: str) -> set[str]:

{mammoth_cli-2.2.94 → mammoth_cli-2.2.96}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.2.94
+version: 2.2.96
 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.2.94 → mammoth_cli-2.2.96}/mammoth_cli/bundled_skill/mammoth-cli/references/capabilities-misc.md

@@ -78,10 +78,6 @@ Ran once: `connector.active`, `connector.ai.session.list`, `connector.list`
 | `connector.query.generate` | observed blocker | blocked_missing_fixture: No real connector connection exists in workspace 4 (connector.list shows all is_added:false; connector.active returns []), matching the documented capabili |
 | `connector.query.status` | observed blocker | blocked_missing_fixture: No real connector connection exists in workspace 4 (connector list shows all is_added:false; connector active returns []) and creating one requires externa |
 
-## `data-app`
-
-Ran once: `data-app.list`
-
 ## `external-key`
 
 Ran once: `external-key.list`

{mammoth_cli-2.2.94 → mammoth_cli-2.2.96}/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 860 commands. 516 of them bind one of the 545 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, 1 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 845 commands. 700 of them bind one of the 769 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`). 261 bound commands ran once successfully on release, 1 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:
 
@@ -17,27 +17,27 @@ The typed `view transform *` commands all submit through `view.task.add` (`renam
 
 | Family | Commands | Ran once | Not supported | Untried |
 |---|---|---|---|---|
-| `dashboard` | 131 | 81 | 1 | 49 |
-| `support` | 66 | 9 | 0 | 57 |
-| `view` | 63 | 58 | 0 | 5 |
-| `billing` | 24 | 4 | 0 | 20 |
-| `connector` | 22 | 3 | 0 | 19 |
-| `workspace` | 20 | 7 | 0 | 13 |
-| `dataset` | 18 | 12 | 0 | 6 |
-| `project` | 17 | 15 | 0 | 2 |
-| `workflow` | 16 | 9 | 0 | 7 |
+| `dashboard` | 166 | 81 | 1 | 84 |
+| `support` | 112 | 9 | 0 | 103 |
+| `view` | 71 | 58 | 0 | 13 |
+| `agent` | 41 | 1 | 0 | 40 |
+| `connector` | 39 | 3 | 0 | 36 |
+| `workspace` | 27 | 7 | 0 | 20 |
+| `billing` | 26 | 4 | 0 | 22 |
+| `dataset` | 26 | 12 | 0 | 14 |
+| `workflow` | 23 | 9 | 0 | 14 |
+| `collection` | 21 | 0 | 0 | 21 |
+| `project` | 18 | 15 | 0 | 3 |
 | `parameter` | 14 | 7 | 0 | 7 |
-| `data-app` | 12 | 1 | 0 | 11 |
+| `automation` | 13 | 3 | 0 | 10 |
 | `browse` | 9 | 1 | 0 | 8 |
-| `automation` | 8 | 3 | 0 | 5 |
+| `file` | 8 | 5 | 0 | 3 |
 | `folder` | 8 | 8 | 0 | 0 |
 | `snippet` | 8 | 6 | 0 | 2 |
 | `user` | 7 | 3 | 0 | 4 |
 | `webhook` | 7 | 5 | 0 | 2 |
 | `addon` | 6 | 0 | 0 | 6 |
-| `agent` | 6 | 1 | 0 | 5 |
 | `batch` | 6 | 6 | 0 | 0 |
-| `file` | 6 | 5 | 0 | 1 |
 | `ai` | 5 | 3 | 0 | 2 |
 | `annotation` | 5 | 1 | 0 | 4 |
 | `client-app` | 5 | 0 | 0 | 5 |
@@ -47,6 +47,7 @@ The typed `view transform *` commands all submit through `view.task.add` (`renam
 | `external-key` | 4 | 1 | 0 | 3 |
 | `trash` | 3 | 3 | 0 | 0 |
 | `activity` | 2 | 1 | 0 | 1 |
+| `auth` | 2 | 0 | 0 | 2 |
 | `job` | 2 | 2 | 0 | 0 |
 | `report` | 1 | 1 | 0 | 0 |
 

{mammoth_cli-2.2.94 → mammoth_cli-2.2.96}/mammoth_cli/bundled_skill/mammoth-cli/references/command-index.md

@@ -1,16 +1,16 @@
 # Published CLI command catalog
 
-This generated catalog is a lookup table for every command in the published CLI manifest, currently 860; 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 845; 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:
 
 - [activity](commands/activity.md) — 2 published commands
-- [addon](commands/addon.md) — 7 published commands
-- [agent](commands/agent.md) — 73 published commands
+- [addon](commands/addon.md) — 6 published commands
+- [agent](commands/agent.md) — 44 published commands
 - [ai](commands/ai.md) — 5 published commands
 - [annotation](commands/annotation.md) — 5 published commands
 - [auth](commands/auth.md) — 5 published commands
-- [automation](commands/automation.md) — 8 published commands
+- [automation](commands/automation.md) — 13 published commands
 - [batch](commands/batch.md) — 7 published commands
 - [billing](commands/billing.md) — 27 published commands
 - [browse](commands/browse.md) — 9 published commands
@@ -21,15 +21,14 @@ Load only the applicable domain file:
 - [collection](commands/collection.md) — 21 published commands
 - [completion](commands/completion.md) — 2 published commands
 - [config](commands/config.md) — 4 published commands
-- [connector](commands/connector.md) — 25 published commands
+- [connector](commands/connector.md) — 40 published commands
 - [context](commands/context.md) — 4 published commands
 - [dashboard-qa](commands/dashboard-qa.md) — 14 published commands
 - [dashboard-template](commands/dashboard-template.md) — 12 published commands
+- [dashboard-published](commands/dashboard-published.md) — 10 published commands
 - [dashboard-style](commands/dashboard-style.md) — 10 published commands
 - [dashboard-embed](commands/dashboard-embed.md) — 9 published commands
-- [dashboard-published](commands/dashboard-published.md) — 8 published commands
-- [dashboard](commands/dashboard.md) — 106 published commands
-- [data-app](commands/data-app.md) — 12 published commands
+- [dashboard](commands/dashboard.md) — 112 published commands
 - [dataset](commands/dataset.md) — 30 published commands
 - [doctor](commands/doctor.md) — 1 published commands
 - [external-key](commands/external-key.md) — 4 published commands
@@ -54,7 +53,7 @@ Load only the applicable domain file:
 - [token](commands/token.md) — 3 published commands
 - [trash](commands/trash.md) — 3 published commands
 - [upgrade](commands/upgrade.md) — 1 published commands
-- [user](commands/user.md) — 8 published commands
+- [user](commands/user.md) — 7 published commands
 - [version](commands/version.md) — 1 published commands
 - [view-transform](commands/view-transform.md) — 35 published commands
 - [view](commands/view.md) — 110 published commands

{mammoth_cli-2.2.94 → mammoth_cli-2.2.96}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/addon.md

@@ -22,16 +22,6 @@ Result: `AddonConnectorRemoveResult`; mutation `high_impact`, confirmation `conf
 
 Status on release: untried; no live run recorded.
 
-### `addon.list`
-
-Run: `mammoth addon list`. Exact input fields: `mammoth schema get addon.list`.
-
-Example: `mammoth addon list`. Placeholders are illustrative; resolve IDs and input from observed reads.
-
-Result: `AddonListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
-
-Status on release: untried; no live run recorded.
-
 ### `addon.storage.add`
 
 Run: `mammoth addon storage add`. Exact input fields: `mammoth schema get addon.storage.add`.