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

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

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

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

{mammoth_cli-1.0.2 → mammoth_cli-1.0.4}/mammoth_cli/commands/auth.py

@@ -38,7 +38,7 @@ from mammoth_cli.errors.envelope import (
     EXIT_USAGE,
     CliError,
 )
-from mammoth_cli.output.policy import resolve_policy
+from mammoth_cli.output.policy import MACHINE_OUTPUTS
 from mammoth_cli.runtime import executor
 from mammoth_cli.runtime import options as go
 from mammoth_cli.runtime.invocation import Invocation
@@ -185,6 +185,27 @@ def _validate_login_document(document: dict[str, Any]) -> LoginRequest:
         ) from exc
 
 
+def _prompt_blockers(invocation: Invocation) -> list[str]:
+    """Reasons this invocation cannot interactively prompt, in report order.
+
+    Mirrors the ``can_prompt`` rule used by
+    :func:`mammoth_cli.runtime.confirm.enforce_confirmation` — a real TTY,
+    without ``--no-input`` and not a machine output format. A genuine
+    interactive terminal is ground truth for "a human is present," so it
+    intentionally does NOT consult the ``CI``/``TERM=dumb`` heuristic: those
+    only proxy for the absence of a human, which a real TTY disproves. Returns
+    an empty list when prompting is possible.
+    """
+    reasons: list[str] = []
+    if not sys.stdin.isatty():
+        reasons.append("stdin is not an interactive terminal")
+    if invocation.no_input:
+        reasons.append("--no-input is set")
+    if invocation.output in MACHINE_OUTPUTS:
+        reasons.append(f"--output {invocation.output} is a machine format")
+    return reasons
+
+
 def _run_login(
     invocation: Invocation,
     *,
@@ -201,13 +222,7 @@ def _run_login(
             hint=f"Use one of: {', '.join(_STORAGE_MODES)}.",
         )
 
-    policy = resolve_policy(
-        output=invocation.output,
-        no_input=invocation.no_input,
-        no_progress=invocation.no_progress,
-        is_tty=sys.stdin.isatty(),
-        color=invocation.color,
-    )
+    blockers = _prompt_blockers(invocation)
 
     effective_workspace: int | None
     if invocation.input_file is not None:
@@ -216,7 +231,7 @@ def _run_login(
         api_key, api_secret = request.api_key, request.api_secret
         effective_workspace = workspace if workspace is not None else request.workspace_id
         effective_prefix = server_prefix if server_prefix is not None else request.server_prefix
-    elif not policy.prompts_disabled:
+    elif not blockers:
         api_key = typer.prompt("API key", hide_input=True)
         api_secret = typer.prompt("API secret", hide_input=True)
         effective_workspace = workspace
@@ -226,7 +241,12 @@ def _run_login(
             code="login_input_required",
             message="Non-interactive login requires --input.",
             exit_status=EXIT_USAGE,
-            hint="Pass --input FILE|- (with --input-format for stdin), or run in a terminal.",
+            hint=(
+                "Interactive prompting is off because "
+                + "; ".join(blockers)
+                + ". Pass --input FILE|- (with --input-format for stdin), "
+                "or run in an interactive terminal."
+            ),
         )
 
     if effective_workspace is None or effective_workspace <= 0:
@@ -271,7 +291,7 @@ def _run_login(
         api_key,
         api_secret,
         storage=cast(credentials.StorageMode, storage),
-        interactive=not policy.prompts_disabled,
+        interactive=not blockers,
     )
     profiles.set_selected(profile_name)
 
@@ -431,20 +451,18 @@ def _run_logout(
             exit_status=EXIT_USAGE,
         )
 
-    policy = resolve_policy(
-        output=invocation.output,
-        no_input=invocation.no_input,
-        no_progress=invocation.no_progress,
-        is_tty=sys.stdin.isatty(),
-        color=invocation.color,
-    )
     if not yes:
-        if policy.prompts_disabled:
+        blockers = _prompt_blockers(invocation)
+        if blockers:
             raise CliError(
                 code=CODE_CONFIRMATION_REQUIRED,
                 message="auth logout requires --yes in non-interactive mode.",
                 exit_status=EXIT_USAGE,
-                hint="Re-run with --yes.",
+                hint=(
+                    "Interactive confirmation is off because "
+                    + "; ".join(blockers)
+                    + ". Re-run with --yes, or run in an interactive terminal."
+                ),
             )
         if not typer.confirm("Remove the stored credentials?", default=False):
             raise CliError(

{mammoth_cli-1.0.2 → mammoth_cli-1.0.4}/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.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "mammoth-cli"
-version = "1.0.2"
+version = "1.0.4"
 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.4}/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.4}/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.4}/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.4}/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.4}/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.4}/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.4}/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.4}/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: