mammoth-cli 2.0.27__tar.gz → 2.0.28__tar.gz

{mammoth_cli-2.0.27 → mammoth_cli-2.0.28}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.0.27
+Version: 2.0.28
 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.12
+Requires-Dist: mammoth-io<0.8,>=0.7.13
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.13
 Requires-Dist: pyyaml<7,>=6
@@ -286,6 +286,12 @@ COMMAND.ID` to verify a request shape against the installed CLI.
 Agent-readable indexes: [`docs/llms.txt`](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/llms.txt) and
 [`docs/llms-full.txt`](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/llms-full.txt).
 
+## Production readiness
+
+[`docs/production-readiness.md`](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/production-readiness.md)
+is the one-page verdict: what is proven live, what is not, and where every
+claim's evidence lives. Read it before promising a deliverable.
+
 ## Capability-matrix status
 
 The committed machine-readable release matrix is the canonical repository

{mammoth_cli-2.0.27 → mammoth_cli-2.0.28}/README.md

@@ -258,6 +258,12 @@ COMMAND.ID` to verify a request shape against the installed CLI.
 Agent-readable indexes: [`docs/llms.txt`](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/llms.txt) and
 [`docs/llms-full.txt`](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/llms-full.txt).
 
+## Production readiness
+
+[`docs/production-readiness.md`](https://github.com/EdgeMetric/mammothsdk/blob/main/mammoth-cli/docs/production-readiness.md)
+is the one-page verdict: what is proven live, what is not, and where every
+claim's evidence lives. Read it before promising a deliverable.
+
 ## Capability-matrix status
 
 The committed machine-readable release matrix is the canonical repository

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

{mammoth_cli-2.0.27 → mammoth_cli-2.0.28}/mammoth_cli/bundled_skill/mammoth-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mammoth-cli
-version: 2.0.27
+version: 2.0.28
 description: "Use Mammoth Analytics from a terminal: install or authenticate the CLI, discover its live command contract, and safely manage projects, data, views, pipelines, dashboards, exports, and handoffs."
 ---
 

{mammoth_cli-2.0.27 → mammoth_cli-2.0.28}/mammoth_cli/bundled_skill/mammoth-cli/references/capabilities-misc.md

@@ -140,4 +140,4 @@ Ran once: `workflow.create`, `workflow.delete`, `workflow.get`, `workflow.graph`
 
 Ran once: `workspace.app-usage`, `workspace.get`, `workspace.list`, `workspace.segment.list`, `workspace.segment.update`, `workspace.storage-breakdown`, `workspace.user.list`
 
-Evidence collected on CLI releases 1.1.5 through 2.0.24; each row's release is recorded in `docs/release-capability-matrix.json` (`evidence_version`). A row that ran on an older release has not been re-run since unless its note says so. Details: `docs/capability-evidence/` in the repository.
+Evidence collected on CLI releases 1.1.5 through 2.0.27; each row's release is recorded in `docs/release-capability-matrix.json` (`evidence_version`). A row that ran on an older release has not been re-run since unless its note says so. Details: `docs/capability-evidence/` in the repository.

{mammoth_cli-2.0.27 → mammoth_cli-2.0.28}/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 554 commands. 455 of them bind one of the 528 API operations in the matrix; the remainder are local commands (`schema`, `auth`, `doctor`, `log`, ...) or typed variants that share an operation (every `view transform *` command submits through `view.task.add`). 261 bound commands ran once successfully on release, 2 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.
+The CLI publishes 554 commands. 455 of them bind one of the 528 API operations in the matrix; the remainder are local commands (`schema`, `auth`, `doctor`, `log`, ...) or typed variants that share an operation (every `view transform *` command submits through `view.task.add`). 262 bound commands ran once successfully on release, 2 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.
 
 Status meanings:
 
@@ -18,7 +18,7 @@ The typed `view transform *` commands all submit through `view.task.add`; its ma
 | Family | Commands | Ran once | Not supported | Untried |
 |---|---|---|---|---|
 | `dashboard` | 104 | 81 | 2 | 21 |
-| `view` | 62 | 57 | 0 | 5 |
+| `view` | 62 | 58 | 0 | 4 |
 | `support` | 45 | 9 | 0 | 36 |
 | `billing` | 23 | 4 | 0 | 19 |
 | `connector` | 22 | 3 | 0 | 19 |
@@ -110,13 +110,12 @@ Ran once: `project.bulk-delete`, `project.bulk-update`, `project.checkpoint.list
 
 ## `view`
 
-Ran once: `view.active-user.list`, `view.active-user.mark`, `view.ai.generate-data`, `view.ai.profile`, `view.bulk-delete`, `view.checkpoint.create`, `view.checkpoint.delete`, `view.checkpoint.get`, `view.checkpoint.list`, `view.checkpoint.update`, `view.conditional-format.create`, `view.conditional-format.delete-all`, `view.conditional-format.list`, `view.conditional-format.update`, `view.create`, `view.data-check.create`, `view.data-check.delete`, `view.data-check.get`, `view.data-check.list`, `view.data.get`, `view.data.query`, `view.delete`, `view.derivative.create`, `view.derivative.data`, `view.derivative.delete`, `view.derivative.list`, `view.derivative.update`, `view.draft.command`, `view.export.delete`, `view.export.get`, `view.export.list`, `view.export.publish-db`, `view.export.update`, `view.exportable-config.apply`, `view.exportable-config.get`, `view.get`, `view.list`, `view.parameter-context`, `view.pipeline.edit`, `view.pipeline.get`, `view.pipeline.items`, `view.pipeline.rerun`, `view.preview`, `view.restore`, `view.task.add`, `view.task.delete`, `view.task.get`, `view.task.list`, `view.task.preview`, `view.task.update`, `view.trash`, `view.version.apply`, `view.version.delete`, `view.version.get`, `view.version.list`, `view.version.update`
+Ran once: `view.active-user.list`, `view.active-user.mark`, `view.ai.generate-data`, `view.ai.profile`, `view.bulk-delete`, `view.checkpoint.create`, `view.checkpoint.delete`, `view.checkpoint.get`, `view.checkpoint.list`, `view.checkpoint.update`, `view.conditional-format.create`, `view.conditional-format.delete-all`, `view.conditional-format.list`, `view.conditional-format.update`, `view.create`, `view.data-check.create`, `view.data-check.delete`, `view.data-check.get`, `view.data-check.list`, `view.data.get`, `view.data.query`, `view.delete`, `view.derivative.create`, `view.derivative.data`, `view.derivative.delete`, `view.derivative.list`, `view.derivative.update`, `view.draft.command`, `view.export.create`, `view.export.delete`, `view.export.get`, `view.export.list`, `view.export.publish-db`, `view.export.update`, `view.exportable-config.apply`, `view.exportable-config.get`, `view.get`, `view.list`, `view.parameter-context`, `view.pipeline.edit`, `view.pipeline.get`, `view.pipeline.items`, `view.pipeline.rerun`, `view.preview`, `view.restore`, `view.task.add`, `view.task.delete`, `view.task.get`, `view.task.list`, `view.task.preview`, `view.task.update`, `view.trash`, `view.version.apply`, `view.version.delete`, `view.version.get`, `view.version.list`, `view.version.update`
 
 | Command | State | Note |
 |---|---|---|
 | `view.ai.generation-info` | observed blocker | backend: GET /workspaces/4/projects/24/datasets/54/dataviews/76/data/generate -> HTTP 400 5GENR011 NOT_IMPLEMENTED 'Not implemented', request_id:null |
 | `view.data-check.update` | observed blocker | backend_error: PATCH with the schema's documented {op: command, path: enable/disable, value: null} shape returns HTTP 500 empty body (CLI outcome_unknown, exit 7) while the mutatio |
-| `view.export.create` | observed blocker | backend: CLI accepts the request (exit 0, job 358 accepted on POST /dataviews/76/actions), but job get 358 -> status:error, response:{"error":{"message":"'destination'"}} (a raw Py |
 | `view.export.publish-db-update` | CLI defect fixed, untried since | 2.0.16 (example value is the documented {"odbc_type": "postgres"} object (a bare string is rejected)) |
 
-Evidence collected on CLI releases 1.1.5 through 2.0.24; each row's release is recorded in `docs/release-capability-matrix.json` (`evidence_version`). A row that ran on an older release has not been re-run since unless its note says so. Details: `docs/capability-evidence/` in the repository.
+Evidence collected on CLI releases 1.1.5 through 2.0.27; each row's release is recorded in `docs/release-capability-matrix.json` (`evidence_version`). A row that ran on an older release has not been re-run since unless its note says so. Details: `docs/capability-evidence/` in the repository.

{mammoth_cli-2.0.27 → mammoth_cli-2.0.28}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/view.md

@@ -382,7 +382,7 @@ Example: `mammoth view export create 123 --input '{"export_spec": {"DATAVIEW_ID"
 
 Result: `ViewExportCreateResult`; mutation `external_effect`, confirmation `yes_always`, wait policy `returns_job`.
 
-Status on release: observed blocker — backend: CLI accepts the request (exit 0, job 358 accepted on POST /dataviews/76/actions), but job get 358 -> status:error, response:{"error":{"message":"'destination'"}} (a raw Py. Re-check before relying on it.
+Status on release: ran once on CLI 2.0.27 — cross-project send 2026-09-19: exit 0 on release with CLI 2.0.27. Raw internal_dataset export accepted (job 831 add_action) and created dataset 113 in project 57. Without USER_ID the same spec is 4GENR007 Validation error with no detail (the backend checks th…
 
 ### `view.export.csv`
 

{mammoth_cli-2.0.27 → mammoth_cli-2.0.28}/mammoth_cli/bundled_skill/mammoth-cli/references/recipes/exports.md

@@ -22,6 +22,31 @@ If `schema get view.export.csv` rejects requested fields, preserve the
 structured error and discover another declared export route rather than using
 raw HTTP.
 
+## Send a view into another project (parallel send, branch-out)
+
+`view export dataset` writes the view's rows into a Mammoth dataset **as a
+pipeline step of the source view**, so the copy is refreshed every time the
+source pipeline re-runs; existing tasks and existing exports (for example a
+Power BI send) are not touched — it is appended at the end of the pipeline.
+`target_project_id` puts the dataset in another project (proven on release:
+view 134 in project 58 → dataset 114 in project 57, refreshed 302 → 301 rows
+after a filter was added upstream).
+
+```bash
+mammoth view export dataset SOURCE_VIEW_ID SOURCE_DATASET_ID --yes \
+  --input '{"dataset_name": "Finance feed", "target_project_id": TARGET_PROJECT_ID}'
+# -> {"dataset_id": N, "project_id": TARGET_PROJECT_ID, "next": "mammoth view list N --project TARGET_PROJECT_ID"}
+mammoth view export list SOURCE_VIEW_ID SOURCE_DATASET_ID     # handler internal_dataset, status executed, TARGET_DS_ID N
+```
+
+`target_ds_id` writes into an existing dataset instead of creating one
+(`save_as_mode` `REPLACE_IN_DS` or `APPEND_TO_DS`). Read the delivery back in
+the target project (`view list N --project P`, `view data get`) before
+reporting it. Do not build this with `view export create`: the raw
+`internal_dataset` spec needs `USER_ID` and the `export_project` /
+`project_id` / `source_project_id` trio, and without them the backend answers
+`4GENR007 Validation error` with no detail; the typed command fills them.
+
 ## Destination exports that carry a secret
 
 `schema get` lists `secret_fields` for every typed destination export

{mammoth_cli-2.0.27 → mammoth_cli-2.0.28}/mammoth_cli/commands/view.py

@@ -1864,4 +1864,15 @@ def view_export_specialized(invocation: Invocation) -> HandlerResult:
         if dataset_id is None:
             dataset_id = _resolve_dataset_id(service, invocation, dataview_id, document)
         data = service.call_view(dataview_id, method, dataset_id=dataset_id, **kwargs)
+    if invocation.command_id == "view.export.dataset" and isinstance(data, int):
+        # The SDK returns the bare id of the dataset written to; name it, and
+        # say which project it landed in, so the agent's next read is obvious.
+        target_project = kwargs.get("target_project_id")
+        data = {
+            "dataset_id": data,
+            "project_id": int(target_project) if target_project is not None else project_id,
+            "source_view_id": dataview_id,
+            "next": f"mammoth view list {data}"
+            + (f" --project {int(target_project)}" if target_project is not None else ""),
+        }
     return data, _meta(invocation, auth.workspace_id, project_id)

{mammoth_cli-2.0.27 → mammoth_cli-2.0.28}/pyproject.toml

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

{mammoth_cli-2.0.27 → mammoth_cli-2.0.28}/spec/manifests/commands/view.yaml

@@ -1859,7 +1859,9 @@ commands:
   draft_test: null
   undo_test: null
   known_restrictions: 'Mutation class dynamic: benign_mutation for a new target, destructive when replacing
-    an existing target.'
+    an existing target. The export is appended to the source pipeline (end_of_pipeline) and re-runs with it;
+    target_project_id sends the dataset into another project (cross-project branch-out, proven on release).
+    Result: {dataset_id, project_id, source_view_id, next}.'
   reviewed_by: primary
 - command_id: view.export.delete
   command_path: view export delete

{mammoth_cli-2.0.27 → mammoth_cli-2.0.28}/spec/manifests/sdk-methods.yaml

@@ -6502,7 +6502,7 @@ methods:
   reviewed_by: primary
 - sdk_symbol: mammoth.view.View.branch_out
   implementation_origin: mammoth.view.View.branch_out
-  signature: 'branch_out(self, dataset_name: ''str'', *, target_ds_id: ''int | None'' = None, save_as_mode: ''SaveAsDatasetMode'' = <SaveAsDatasetMode.REPLACE: ''REPLACE_IN_DS''>, column_mapping: ''dict[str, str] | None'' = None, label_ids: ''list[int] | None'' = None, condition: ''Condition | CompoundCondition | NotCondition | None'' = None, timeout: ''int | None'' = None) -> ''int'''
+  signature: 'branch_out(self, dataset_name: ''str'', *, target_ds_id: ''int | None'' = None, save_as_mode: ''SaveAsDatasetMode'' = <SaveAsDatasetMode.REPLACE: ''REPLACE_IN_DS''>, column_mapping: ''dict[str, str] | None'' = None, label_ids: ''list[int] | None'' = None, condition: ''Condition | CompoundCondition | NotCondition | None'' = None, timeout: ''int | None'' = None, target_project_id: ''int | None'' = None) -> ''int'''
   openapi_operation_ids: []
   canonical_command: null
   alias_of: view.export.dataset
@@ -6744,7 +6744,7 @@ methods:
   reviewed_by: primary
 - sdk_symbol: mammoth.view.ViewExport.to_dataset
   implementation_origin: mammoth.view.ViewExport.to_dataset
-  signature: 'to_dataset(self, dataset_name: ''str'', *, target_ds_id: ''int | None'' = None, save_as_mode: ''SaveAsDatasetMode'' = <SaveAsDatasetMode.REPLACE: ''REPLACE_IN_DS''>, column_mapping: ''dict[str, str] | None'' = None, label_ids: ''list[int] | None'' = None, condition: ''Condition | CompoundCondition | NotCondition | None'' = None, timeout: ''int | None'' = None) -> ''int'''
+  signature: 'to_dataset(self, dataset_name: ''str'', *, target_ds_id: ''int | None'' = None, save_as_mode: ''SaveAsDatasetMode'' = <SaveAsDatasetMode.REPLACE: ''REPLACE_IN_DS''>, column_mapping: ''dict[str, str] | None'' = None, label_ids: ''list[int] | None'' = None, condition: ''Condition | CompoundCondition | NotCondition | None'' = None, timeout: ''int | None'' = None, target_project_id: ''int | None'' = None) -> ''int'''
   openapi_operation_ids: []
   canonical_command: view.export.dataset
   alias_of: null