mammoth-cli 1.0.2__tar.gz → 1.0.3__tar.gz

{mammoth_cli-1.0.2 → mammoth_cli-1.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 1.0.2
+Version: 1.0.3
 Summary: Command-line interface for the Mammoth Analytics platform
 License: Proprietary
 License-File: LICENSE

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

{mammoth_cli-1.0.2 → mammoth_cli-1.0.3}/mammoth_cli/services/positionals.py

@@ -226,6 +226,35 @@ POSITIONAL_OVERRIDES: dict[str, tuple[PositionalSpec, ...]] = {
             ("support.user.update", "email", "Email of the user to update"),
         )
     },
+    # These ``create`` verbs take their identifying name (or ``intent``) as a
+    # positional OR the matching ``--input`` field: each handler reads
+    # ``extra_args[0] or document.get(<field>)``. Without a registered optional
+    # positional the strict validator rejects the positional form outright, so
+    # only the ``--input`` form is invokable and the documented dual-sourcing is
+    # a half promise. Author an optional locator that falls back to the field --
+    # the same shape as ``project create``.
+    **{
+        command: (
+            PositionalSpec(
+                name=field,
+                type=str,
+                required=False,
+                help=f"{label}; or pass it via the '{field}' input field.",
+                falls_back_to_field=field,
+            ),
+        )
+        for command, field, label in (
+            ("automation.create", "name", "Name of the new automation"),
+            ("client-app.create", "app_name", "Name of the new client app"),
+            ("dashboard.create", "intent", "Generation intent for the new dashboard"),
+            ("folder.create", "name", "Name of the new folder"),
+            ("parameter.create", "name", "Name of the new parameter"),
+            ("parameter.group.create", "name", "Name of the new parameter group"),
+            ("snippet.create", "name", "Name of the new snippet"),
+            ("webhook.create", "name", "Name of the new webhook"),
+            ("workflow.create", "name", "Name of the new workflow"),
+        )
+    },
     # ``schema get`` / ``capability get`` are CLI-only discovery commands with no
     # backing SDK signature (their ``sdk_symbol`` is a meta-reference), so the
     # derivation emits nothing. Their handlers read the single id positionally

{mammoth_cli-1.0.2 → mammoth_cli-1.0.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "mammoth-cli"
-version = "1.0.2"
+version = "1.0.3"
 description = "Command-line interface for the Mammoth Analytics platform"
 authors = ["Mammoth Analytics <support@mammoth.io>"]
 readme = "README.md"

{mammoth_cli-1.0.2 → mammoth_cli-1.0.3}/spec/manifests/commands/automation.yaml

@@ -6,7 +6,13 @@ commands:
   alias_of: null
   operation_ids:
   - CreateAutomation
-  positionals: []
+  positionals:
+  - name: name
+    type: str
+    required: false
+    metavar: NAME
+    falls_back_to_field: name
+    help: Name of the new automation; or pass it via the 'name' input field.
   options: []
   sdk_symbol: mammoth.api.automations.AutomationsAPI.create
   sdk_conversion: Call mammoth.api.automations.AutomationsAPI.create with validated request fields.
@@ -23,8 +29,8 @@ commands:
   required_fixture_guard: null
   secret_fields: []
   human_example: mammoth automation create --help
-  agent_example: 'mammoth automation create --input ''{"name": "example", "description": "example", "tasks":
-    [{"task_type": "run_data_retrieval"}]}'' --output json --no-input'
+  agent_example: 'mammoth automation create example --input ''{"description": "example", "tasks": [{"task_type":
+    "run_data_retrieval"}]}'' --output json --no-input'
   unit_tests:
   - UT-AUTOMATION-CREATE
   contract_tests:

{mammoth_cli-1.0.2 → mammoth_cli-1.0.3}/spec/manifests/commands/client-app.yaml

@@ -6,7 +6,13 @@ commands:
   alias_of: null
   operation_ids:
   - CreateApp
-  positionals: []
+  positionals:
+  - name: app_name
+    type: str
+    required: false
+    metavar: APP_NAME
+    falls_back_to_field: app_name
+    help: Name of the new client app; or pass it via the 'app_name' input field.
   options: []
   sdk_symbol: mammoth.api.clientapps.ClientAppsAPI.create
   sdk_conversion: Call mammoth.api.clientapps.ClientAppsAPI.create with validated request fields.
@@ -23,7 +29,7 @@ commands:
   required_fixture_guard: null
   secret_fields: []
   human_example: mammoth client-app create --help
-  agent_example: 'mammoth client-app create --input ''{"app_name": "example"}'' --output json --no-input'
+  agent_example: mammoth client-app create example --output json --no-input
   unit_tests:
   - UT-CLIENT-APP-CREATE
   contract_tests:

{mammoth_cli-1.0.2 → mammoth_cli-1.0.3}/spec/manifests/commands/dashboard.yaml

@@ -487,7 +487,13 @@ commands:
   alias_of: null
   operation_ids:
   - GenerateDashboard
-  positionals: []
+  positionals:
+  - name: intent
+    type: str
+    required: false
+    metavar: INTENT
+    falls_back_to_field: intent
+    help: Generation intent for the new dashboard; or pass it via the 'intent' input field.
   options: []
   sdk_symbol: mammoth.api.dashboards.DashboardsAPI.create
   sdk_conversion: Call mammoth.api.dashboards.DashboardsAPI.create with validated request fields.
@@ -505,8 +511,7 @@ commands:
   required_fixture_guard: null
   secret_fields: []
   human_example: mammoth dashboard create --help
-  agent_example: 'mammoth dashboard create --input ''{"intent": "example", "source": [1]}'' --output json
-    --no-input'
+  agent_example: 'mammoth dashboard create example --input ''{"source": [1]}'' --output json --no-input'
   unit_tests:
   - UT-DASHBOARD-CREATE
   contract_tests:

{mammoth_cli-1.0.2 → mammoth_cli-1.0.3}/spec/manifests/commands/folder.yaml

@@ -40,7 +40,13 @@ commands:
   alias_of: null
   operation_ids:
   - CreateFolder
-  positionals: []
+  positionals:
+  - name: name
+    type: str
+    required: false
+    metavar: NAME
+    falls_back_to_field: name
+    help: Name of the new folder; or pass it via the 'name' input field.
   options: []
   sdk_symbol: mammoth.api.folders.FoldersAPI.create
   sdk_conversion: Call mammoth.api.folders.FoldersAPI.create with validated request fields.
@@ -57,7 +63,7 @@ commands:
   required_fixture_guard: null
   secret_fields: []
   human_example: mammoth folder create --help
-  agent_example: 'mammoth folder create --input ''{"name": "example"}'' --output json --no-input'
+  agent_example: mammoth folder create example --output json --no-input
   unit_tests:
   - UT-FOLDER-CREATE
   contract_tests:

{mammoth_cli-1.0.2 → mammoth_cli-1.0.3}/spec/manifests/commands/parameter.yaml

@@ -6,7 +6,13 @@ commands:
   alias_of: null
   operation_ids:
   - CreateParameter
-  positionals: []
+  positionals:
+  - name: name
+    type: str
+    required: false
+    metavar: NAME
+    falls_back_to_field: name
+    help: Name of the new parameter; or pass it via the 'name' input field.
   options: []
   sdk_symbol: mammoth.api.parameters.ParametersAPI.create
   sdk_conversion: Call mammoth.api.parameters.ParametersAPI.create with validated request fields.
@@ -23,8 +29,8 @@ commands:
   required_fixture_guard: null
   secret_fields: []
   human_example: mammoth parameter create --help
-  agent_example: 'mammoth parameter create --input ''{"name": "example", "param_type": "example", "value":
-    "example"}'' --output json --no-input'
+  agent_example: 'mammoth parameter create example --input ''{"param_type": "example", "value": "example"}''
+    --output json --no-input'
   unit_tests:
   - UT-PARAMETER-CREATE
   contract_tests:
@@ -201,7 +207,13 @@ commands:
   alias_of: null
   operation_ids:
   - CreateGroup
-  positionals: []
+  positionals:
+  - name: name
+    type: str
+    required: false
+    metavar: NAME
+    falls_back_to_field: name
+    help: Name of the new parameter group; or pass it via the 'name' input field.
   options: []
   sdk_symbol: mammoth.api.parameters.ParametersAPI.group_create
   sdk_conversion: Call mammoth.api.parameters.ParametersAPI.group_create with validated request fields.
@@ -218,7 +230,7 @@ commands:
   required_fixture_guard: null
   secret_fields: []
   human_example: mammoth parameter group create --help
-  agent_example: 'mammoth parameter group create --input ''{"name": "example"}'' --output json --no-input'
+  agent_example: mammoth parameter group create example --output json --no-input
   unit_tests:
   - UT-PARAMETER-GROUP-CREATE
   contract_tests:

{mammoth_cli-1.0.2 → mammoth_cli-1.0.3}/spec/manifests/commands/snippet.yaml

@@ -6,7 +6,13 @@ commands:
   alias_of: null
   operation_ids:
   - CreateSnippet
-  positionals: []
+  positionals:
+  - name: name
+    type: str
+    required: false
+    metavar: NAME
+    falls_back_to_field: name
+    help: Name of the new snippet; or pass it via the 'name' input field.
   options: []
   sdk_symbol: mammoth.api.snippets.SnippetsAPI.create
   sdk_conversion: Call mammoth.api.snippets.SnippetsAPI.create with validated request fields.
@@ -23,8 +29,8 @@ commands:
   required_fixture_guard: null
   secret_fields: []
   human_example: mammoth snippet create --help
-  agent_example: 'mammoth snippet create --input ''{"name": "example", "code": "example", "language":
-    "example"}'' --output json --no-input'
+  agent_example: 'mammoth snippet create example --input ''{"code": "example", "language": "example"}''
+    --output json --no-input'
   unit_tests:
   - UT-SNIPPET-CREATE
   contract_tests:

{mammoth_cli-1.0.2 → mammoth_cli-1.0.3}/spec/manifests/commands/webhook.yaml

@@ -6,7 +6,13 @@ commands:
   alias_of: null
   operation_ids:
   - CreateAWebhook
-  positionals: []
+  positionals:
+  - name: name
+    type: str
+    required: false
+    metavar: NAME
+    falls_back_to_field: name
+    help: Name of the new webhook; or pass it via the 'name' input field.
   options: []
   sdk_symbol: mammoth.api.webhooks.WebhooksAPI.create
   sdk_conversion: Call mammoth.api.webhooks.WebhooksAPI.create with validated request fields.
@@ -23,7 +29,7 @@ commands:
   required_fixture_guard: null
   secret_fields: []
   human_example: mammoth webhook create --help
-  agent_example: mammoth webhook create --output json --no-input
+  agent_example: mammoth webhook create example --output json --no-input
   unit_tests:
   - UT-WEBHOOK-CREATE
   contract_tests:

{mammoth_cli-1.0.2 → mammoth_cli-1.0.3}/spec/manifests/commands/workflow.yaml

@@ -261,7 +261,13 @@ commands:
   alias_of: null
   operation_ids:
   - CreateWorkflow
-  positionals: []
+  positionals:
+  - name: name
+    type: str
+    required: false
+    metavar: NAME
+    falls_back_to_field: name
+    help: Name of the new workflow; or pass it via the 'name' input field.
   options: []
   sdk_symbol: mammoth.api.workflows.WorkflowsAPI.create
   sdk_conversion: Call mammoth.api.workflows.WorkflowsAPI.create with validated request fields.
@@ -278,7 +284,7 @@ commands:
   required_fixture_guard: null
   secret_fields: []
   human_example: mammoth workflow create --help
-  agent_example: 'mammoth workflow create --input ''{"name": "example"}'' --output json --no-input'
+  agent_example: mammoth workflow create example --output json --no-input
   unit_tests:
   - UT-WORKFLOW-CREATE
   contract_tests: