mammoth-cli 1.0.0__tar.gz

mammoth_cli-1.0.0/LICENSE

@@ -0,0 +1,23 @@
+Mammoth Analytics Proprietary License
+
+Copyright (c) Mammoth Analytics, Inc. All rights reserved.
+
+This software and its accompanying documentation ("the Software") are the
+proprietary and confidential property of Mammoth Analytics, Inc. ("Mammoth").
+The Software is licensed, not sold.
+
+Subject to the terms of a separate written agreement with Mammoth, or the terms
+under which the Software is distributed on the Python Package Index, you are
+granted a non-exclusive, non-transferable right to install and use the Software
+to interact with the Mammoth Analytics platform.
+
+You may not copy, modify, merge, publish, distribute, sublicense, or sell copies
+of the Software, or remove or alter any proprietary notices, except as expressly
+permitted by Mammoth in writing.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL MAMMOTH BE
+LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF
+CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

mammoth_cli-1.0.0/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: mammoth-cli
+Version: 1.0.0
+Summary: Command-line interface for the Mammoth Analytics platform
+License: Proprietary
+License-File: LICENSE
+Author: Mammoth Analytics
+Author-email: support@mammoth.io
+Requires-Python: >=3.12,<3.15
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: PyYAML (>=6,<7)
+Requires-Dist: keyring (>=25.7,<26)
+Requires-Dist: mammoth-io (>=0.6.0,<0.7)
+Requires-Dist: platformdirs (>=4.10,<5)
+Requires-Dist: pydantic (>=2.13,<3)
+Requires-Dist: rich (>=15,<16)
+Requires-Dist: tomlkit (>=0.15.1,<0.16)
+Requires-Dist: typer (>=0.27,<0.28)
+Project-URL: Homepage, https://mammoth.io
+Project-URL: Repository, https://github.com/EdgeMetric/mm-pysdk
+Description-Content-Type: text/markdown
+
+# mammoth-cli
+
+A typed command-line interface for the [Mammoth Analytics](https://mammoth.io)
+platform. The executable is `mammoth`.
+
+The CLI uses the public `mammoth-io` SDK for all Mammoth requests. It does not
+build a second HTTP client and does not call private SDK members.
+
+## Status
+
+Stable. `mammoth-cli` 1.0.0 is a production release; the command surface and the
+machine-output contract are covered by the compatibility policy below.
+
+## Versioning & support
+
+`mammoth-cli` follows [Semantic Versioning](https://semver.org) for the 1.x
+series. Within the 1.x major line:
+
+- The machine-output and error-envelope contract is stable. `SCHEMA_VERSION`
+  (see `mammoth_cli/__init__.py`) identifies that contract and does not change
+  incompatibly within a major version; new fields may be added, but existing
+  fields and their meanings are preserved.
+- The CLI surface is stable: command names, subcommands, flags, and exit codes
+  are not removed or repurposed. New commands, flags, and output fields may be
+  added in minor releases.
+- Bug fixes ship in patch releases; additive, backward-compatible changes ship
+  in minor releases.
+
+Any breaking change to the machine-output contract or the CLI surface bumps the
+major version (2.0.0).
+
+## Layout
+
+| Path | Purpose |
+|---|---|
+| `mammoth_cli/` | CLI package (`app`, `commands`, `contracts`, `services`, `context`, `output`, `errors`, `manifest`, `skills`, `messages`). |
+| `spec/openapi/` | Pinned production OpenAPI snapshot and metadata. |
+| `spec/manifests/` | Reviewed parity manifests: operations, SDK methods, commands, and the schema. |
+| `spec/reports/` | Generated parity report and expected red-first baseline. |
+| `scripts/` | Deterministic build scripts (offline, no login). |
+| `tests/` | Contract, unit, subprocess, and guarded live tests. |
+
+## Reproducing the manifests
+
+```bash
+python scripts/sync_openapi.py --check    # verify the pinned snapshot digest
+python scripts/build_manifests.py         # regenerate the three manifests
+python scripts/build_parity_report.py     # regenerate spec/reports/parity.md
+```
+
+Refreshing the pinned snapshot from the network is an explicit maintenance
+operation (`python scripts/sync_openapi.py`); ordinary CI never fetches it.
+
+## Development
+
+```bash
+pytest tests/ -q                 # unit + contract tests (live tests deselected)
+ruff check mammoth_cli scripts tests
+black mammoth_cli scripts tests
+mypy mammoth_cli
+```
+

mammoth_cli-1.0.0/README.md

@@ -0,0 +1,61 @@
+# mammoth-cli
+
+A typed command-line interface for the [Mammoth Analytics](https://mammoth.io)
+platform. The executable is `mammoth`.
+
+The CLI uses the public `mammoth-io` SDK for all Mammoth requests. It does not
+build a second HTTP client and does not call private SDK members.
+
+## Status
+
+Stable. `mammoth-cli` 1.0.0 is a production release; the command surface and the
+machine-output contract are covered by the compatibility policy below.
+
+## Versioning & support
+
+`mammoth-cli` follows [Semantic Versioning](https://semver.org) for the 1.x
+series. Within the 1.x major line:
+
+- The machine-output and error-envelope contract is stable. `SCHEMA_VERSION`
+  (see `mammoth_cli/__init__.py`) identifies that contract and does not change
+  incompatibly within a major version; new fields may be added, but existing
+  fields and their meanings are preserved.
+- The CLI surface is stable: command names, subcommands, flags, and exit codes
+  are not removed or repurposed. New commands, flags, and output fields may be
+  added in minor releases.
+- Bug fixes ship in patch releases; additive, backward-compatible changes ship
+  in minor releases.
+
+Any breaking change to the machine-output contract or the CLI surface bumps the
+major version (2.0.0).
+
+## Layout
+
+| Path | Purpose |
+|---|---|
+| `mammoth_cli/` | CLI package (`app`, `commands`, `contracts`, `services`, `context`, `output`, `errors`, `manifest`, `skills`, `messages`). |
+| `spec/openapi/` | Pinned production OpenAPI snapshot and metadata. |
+| `spec/manifests/` | Reviewed parity manifests: operations, SDK methods, commands, and the schema. |
+| `spec/reports/` | Generated parity report and expected red-first baseline. |
+| `scripts/` | Deterministic build scripts (offline, no login). |
+| `tests/` | Contract, unit, subprocess, and guarded live tests. |
+
+## Reproducing the manifests
+
+```bash
+python scripts/sync_openapi.py --check    # verify the pinned snapshot digest
+python scripts/build_manifests.py         # regenerate the three manifests
+python scripts/build_parity_report.py     # regenerate spec/reports/parity.md
+```
+
+Refreshing the pinned snapshot from the network is an explicit maintenance
+operation (`python scripts/sync_openapi.py`); ordinary CI never fetches it.
+
+## Development
+
+```bash
+pytest tests/ -q                 # unit + contract tests (live tests deselected)
+ruff check mammoth_cli scripts tests
+black mammoth_cli scripts tests
+mypy mammoth_cli
+```

mammoth_cli-1.0.0/mammoth_cli/__init__.py

@@ -0,0 +1,14 @@
+"""Mammoth CLI — a typed command-line interface for the Mammoth Analytics platform.
+
+All Mammoth transport goes through the public ``mammoth-io`` SDK. The CLI does
+not implement a second HTTP client and does not call private SDK members.
+"""
+
+from __future__ import annotations
+
+__version__ = "1.0.0"
+
+# The versioned machine output envelope contract.
+SCHEMA_VERSION = 1
+
+__all__ = ["__version__", "SCHEMA_VERSION"]

mammoth_cli-1.0.0/mammoth_cli/__main__.py

@@ -0,0 +1,27 @@
+"""Module and console entry point for the Mammoth CLI.
+
+This module exposes ``main`` so that both the ``mammoth`` console script and
+``python -m mammoth_cli`` start the same Typer application. Keeping the entry
+point here (rather than in ``app``) gives the package a stable, importable
+launch symbol that does not change when the application wiring moves.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from mammoth_cli.app import app
+
+
+def main() -> Any:
+    """Run the Mammoth CLI application.
+
+    Returns:
+        The value returned by the Typer application, which the runtime uses as
+        the process exit code.
+    """
+    return app()
+
+
+if __name__ == "__main__":  # pragma: no cover
+    main()