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

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

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

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

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.0.68
+version: 2.0.70
 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."
 ---
 
@@ -85,7 +85,8 @@ mammoth view transform --help              # every data transformation
 | Deliver the rows | `view export csv`, `view export postgres` (and other destinations), `view export dataset` |
 | Run something on a schedule or on new data (refresh, append, alert) | `automation create`: a condition (`at_specific_time`, new file in a folder, ...) and tasks (`run_data_retrieval`, `append_data`, `send_an_alert`, `pull_cloud_files`). `schedule create` only pulls a connector's data. A dataset made from an uploaded file has no source to refresh from; say so. Full recipe, including a known `automation get` backend caveat: [recurring work](references/recipes/scheduling.md) |
 
-A search with no full match returns `suggestions` and a `hint`. Before you
+Call a find result (or `suggestions` entry) from its `accepted_fields` and
+`agent_example`. Before you
 conclude the CLI cannot do something the web app does, check
 `view transform --help` and "View settings, and what has no command" in
 [about Mammoth](references/about-mammoth.md). Do not switch to the web app
@@ -177,10 +178,10 @@ your report. If no column links the files, ask before you combine them.
   "limit": 50}`.
 - A timeout, exit 7 or interruption does not prove failure; reconcile an
   `outcome_unknown` (`job get`, `view task list`) before replaying.
-- Before you report, run `mammoth project check PROJECT_ID`. Its `to_report`
-  has one line for each open finding in every view and dashboard (blanks,
-  text numbers, money not shown, columns a dashboard cannot see). Fix each
-  one, or give it one line in the report.
+- Check an answer with no write against the question (a trend: time
+  buckets, a partial period named); no `project check`.
+- After a write, run `mammoth project check PROJECT_ID` and fix each
+  `to_report` line, or give it one line in the report.
 - Run the [report checklist](references/report-checklist.md) before stating
   a number or calling a step done. When files here disagree,
   [capabilities](references/capabilities.md) wins over a recipe, and a recipe

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

@@ -339,6 +339,8 @@ _SCOPE_REQUIREMENTS: dict[str, dict[str, Any]] = {
 }
 
 _MAX_FIND_RESULTS = 20
+# Outranks any word-overlap score: a command named by its full path comes first.
+_NAMED_COMMAND_BOOST = 10_000
 _MAX_FIND_LIMIT = 100
 # How many of a find's top matches carry inline accepted_fields/agent_example.
 # 35% of all eval tool calls were command discovery (schema find -> schema
@@ -1361,6 +1363,19 @@ def brief_schema(entry: dict[str, Any]) -> dict[str, Any]:
     return brief
 
 
+def _inline_call_detail(entries: list[dict[str, Any]]) -> None:
+    """Add each entry's compact accepted fields and agent example in place."""
+    for entry in entries:
+        record = command_by_id(entry["command_id"])
+        if record is None:
+            continue
+        fields = _compact_accepted_fields(record)
+        if fields is not None:
+            entry["accepted_fields"] = fields
+        if record.get("agent_example"):
+            entry["agent_example"] = record["agent_example"]
+
+
 def find_schemas(
     query: str,
     *,
@@ -1458,7 +1473,13 @@ def find_schemas(
                 "support.* commands act on another workspace as an operator, not the "
                 "caller's own; ordinary workspace work uses the non-support command."
             )
-        if len(matched_terms) == len(terms):
+        # A query that spells out this command's whole path (``aggregate view
+        # data ...``) asks for it by name, whatever goal words ride along.
+        path_tokens = set(_tokens(command_path))
+        named = len(path_tokens) >= 3 and path_tokens <= set(terms)
+        if named:
+            score += _NAMED_COMMAND_BOOST
+        if named or len(matched_terms) == len(terms):
             ranked_matches.append((score, entry))
         else:
             near_misses.append((len(matched_terms), score, entry, matched_terms))
@@ -1471,17 +1492,7 @@ def find_schemas(
     )
     total_matches = len(ranked_matches)
     page = [match for _, match in ranked_matches[offset : offset + bounded_limit]]
-    for rank, match in enumerate(page, start=offset):
-        if rank >= _INLINE_DETAIL_COUNT:
-            break
-        match_record = command_by_id(match["command_id"])
-        if match_record is None:
-            continue
-        fields = _compact_accepted_fields(match_record)
-        if fields is not None:
-            match["accepted_fields"] = fields
-        if match_record.get("agent_example"):
-            match["agent_example"] = match_record["agent_example"]
+    _inline_call_detail(page[: max(0, _INLINE_DETAIL_COUNT - offset)])
     has_more = offset + len(page) < total_matches
     continuation = (
         {
@@ -1508,6 +1519,9 @@ def find_schemas(
             {**entry, "matched_terms": matched}
             for _, _, entry, matched in near_misses[:_MAX_SUGGESTIONS]
         ]
+        # A goal phrased in the user's words rarely carries every term; the
+        # best near misses still say how to call them, so one find suffices.
+        _inline_call_detail(result["suggestions"][:_INLINE_DETAIL_COUNT])
         result["hint"] = _NO_MATCH_HINT
     return result
 

{mammoth_cli-2.0.68 → mammoth_cli-2.0.70}/mammoth_cli/runtime/strict.py

@@ -279,13 +279,23 @@ _UNKNOWN_FIELD_HINTS: dict[str, str] = {
         "from 'mammoth dashboard canvas get DASHBOARD_ID', edited. An --input file "
         "takes the same wrapped document."
     ),
-    "dataset.list": (
-        "project_id is not an --input field; pass the project with the global "
-        "--project option (or omit it to use the active project)."
-    ),
 }
 
 
+def _unknown_field_hint(command_id: str, document: dict[str, Any], accepted: list[str]) -> str:
+    """Name the fix for an unknown ``--input`` key, with the caller's own value."""
+    if command_id in _UNKNOWN_FIELD_HINTS:
+        return _UNKNOWN_FIELD_HINTS[command_id]
+    if "project_id" in document and "project_id" not in accepted:
+        return (
+            "project_id is not an --input field; put --project "
+            f"{document['project_id']} after the command: "
+            f"mammoth {command_id.replace('.', ' ')} ... --project {document['project_id']} "
+            "(or omit it to use the active project)."
+        )
+    return f"Accepted fields: {', '.join(accepted) or '(none)' }."
+
+
 def validate_input_fields(command_id: str, document: dict[str, Any] | None) -> None:
     """Reject unknown ``--input`` keys, then coerce known keys to their type.
 
@@ -334,9 +344,7 @@ def validate_input_fields(command_id: str, document: dict[str, Any] | None) -> N
                 f"{', '.join(unknown)}."
             ),
             exit_status=EXIT_USAGE,
-            hint=_UNKNOWN_FIELD_HINTS.get(
-                command_id, f"Accepted fields: {', '.join(sorted(fields_by_name)) or '(none)' }."
-            ),
+            hint=_unknown_field_hint(command_id, document, sorted(fields_by_name)),
             details={"unknown": unknown, "accepted": sorted(fields_by_name)},
         )
     if is_closed_zero_input(command_id) and document == {}:

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

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