mammoth-cli 2.2.2__tar.gz → 2.2.3__tar.gz

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mammoth-cli
-Version: 2.2.2
+Version: 2.2.3
 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.9,>=0.8.4
+Requires-Dist: mammoth-io<0.9,>=0.8.5
 Requires-Dist: platformdirs<5,>=4.10
 Requires-Dist: pydantic<3,>=2.12.5
 Requires-Dist: pyyaml<7,>=6

{mammoth_cli-2.2.2 → mammoth_cli-2.2.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__ = "2.2.2"
+__version__ = "2.2.3"
 
 # The versioned machine output envelope contract.
 SCHEMA_VERSION = 1

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/mammoth_cli/bundled_skill/mammoth-cli/references/command-index.md

@@ -1,6 +1,6 @@
 # Published CLI command catalog
 
-This generated catalog is a lookup table for every command in the published CLI manifest, currently 589; each entry carries its release status line. It is a command-contract index, not an assertion that every backend/OpenAPI operation has a CLI binding. For an exact local CLI contract, run `mammoth schema get COMMAND_ID`; `mammoth capability list` is an API-binding inventory and can omit typed/local CLI routes. For focused workflows, read the [recipes index](recipes/index.md). Sensitive structured input must come from a private file or pipe; never put secrets in literal argv.
+This generated catalog is a lookup table for every command in the published CLI manifest, currently 595; each entry carries its release status line. It is a command-contract index, not an assertion that every backend/OpenAPI operation has a CLI binding. For an exact local CLI contract, run `mammoth schema get COMMAND_ID`; `mammoth capability list` is an API-binding inventory and can omit typed/local CLI routes. For focused workflows, read the [recipes index](recipes/index.md). Sensitive structured input must come from a private file or pipe; never put secrets in literal argv.
 
 Load only the applicable domain file:
 
@@ -34,7 +34,7 @@ Load only the applicable domain file:
 - [log](commands/log.md) — 2 published commands
 - [notification](commands/notification.md) — 5 published commands
 - [parameter](commands/parameter.md) — 14 published commands
-- [project](commands/project.md) — 23 published commands
+- [project](commands/project.md) — 24 published commands
 - [report](commands/report.md) — 1 published commands
 - [schedule](commands/schedule.md) — 5 published commands
 - [schema](commands/schema.md) — 3 published commands
@@ -50,4 +50,4 @@ Load only the applicable domain file:
 - [view](commands/view.md) — 90 published commands
 - [webhook](commands/webhook.md) — 7 published commands
 - [workflow](commands/workflow.md) — 16 published commands
-- [workspace](commands/workspace.md) — 20 published commands
+- [workspace](commands/workspace.md) — 25 published commands

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/project.md

@@ -132,6 +132,16 @@ Result: `ProjectMemoryRemoveResult`; mutation `benign_mutation`, confirmation `n
 
 Status on release: untried; no live run recorded.
 
+### `project.needs-attention`
+
+Run: `mammoth project needs-attention`. Exact input fields: `mammoth schema get project.needs-attention`.
+
+Example: `mammoth project needs-attention 123`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `ProjectNeedsAttentionResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `project.pending-changes`
 
 Run: `mammoth project pending-changes`. Exact input fields: `mammoth schema get project.pending-changes`.

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/mammoth_cli/bundled_skill/mammoth-cli/references/commands/workspace.md

@@ -64,6 +64,56 @@ Result: `WorkspaceGetResult`; mutation `read`, confirmation `none`, wait policy
 
 Status on release: ran once on CLI 2.0.18 — fixture-lifecycle sweep 2026-09-19: exit 0 on release with CLI 2.0.18. Returned workspace 4 (API Tests) profile. Single invocation only.
 
+### `workspace.invite.delete`
+
+Run: `mammoth workspace invite delete`. Exact input fields: `mammoth schema get workspace.invite.delete`.
+
+Example: `mammoth workspace invite delete --input '{"invite_ids": [1]}'`. Illustrative only: append `--yes` after observing an owned target.
+
+Result: `WorkspaceInviteDeleteResult`; mutation `destructive`, confirmation `prompt_or_yes`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `workspace.invite.list`
+
+Run: `mammoth workspace invite list`. Exact input fields: `mammoth schema get workspace.invite.list`.
+
+Example: `mammoth workspace invite list`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `WorkspaceInviteListResult`; mutation `read`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `workspace.invite.resend`
+
+Run: `mammoth workspace invite resend`. Exact input fields: `mammoth schema get workspace.invite.resend`.
+
+Example: `mammoth workspace invite resend --input '{"invite_ids": [1]}'`. Placeholders are illustrative; resolve IDs and input from observed reads.
+
+Result: `WorkspaceInviteResendResult`; mutation `benign_mutation`, confirmation `none`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `workspace.invite.revoke`
+
+Run: `mammoth workspace invite revoke`. Exact input fields: `mammoth schema get workspace.invite.revoke`.
+
+Example: `mammoth workspace invite revoke --input '{"invite_ids": [1]}'`. Illustrative only: append `--yes` after observing an owned target.
+
+Result: `WorkspaceInviteRevokeResult`; mutation `destructive`, confirmation `prompt_or_yes`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
+### `workspace.invite.update-role`
+
+Run: `mammoth workspace invite update-role`. Exact input fields: `mammoth schema get workspace.invite.update-role`.
+
+Example: `mammoth workspace invite update-role --input '{"invite_id": 1, "role": "sample"}'`. Illustrative only: append `--yes` after observing an owned target.
+
+Result: `WorkspaceInviteUpdateRoleResult`; mutation `high_impact`, confirmation `yes_always`, wait policy `not_async`.
+
+Status on release: untried; no live run recorded.
+
 ### `workspace.list`
 
 Run: `mammoth workspace list`. Exact input fields: `mammoth schema get workspace.list`.

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/mammoth_cli/bundled_skill/mammoth-cli/references/operations.md

@@ -129,6 +129,12 @@ Response shapes are not uniform; never reuse one `jq` path across commands.
 command returns its object directly under `data`. Inspect the first response
 before extracting a field.
 
+`project list` shows only the projects the user is a member of, the same as the
+Mammoth UI. A workspace owner or admin can read other projects but not open
+them, so never report them as access denied. Pass `include_non_members: true`
+only when the user asks about projects they are not in; each row then carries
+`member`.
+
 ## Exports
 
 First inspect `view.export.list/get` for existing configuration and the exact

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/mammoth_cli/commands/dataset.py

@@ -31,7 +31,7 @@ from mammoth_cli.runtime.invocation import Invocation
 from mammoth_cli.runtime.new_data import with_file_upload_path
 from mammoth_cli.runtime.session import open_service, require_project
 from mammoth_cli.services.listing import (
-    DATASET_LIST_FIELDS,
+    DATASET_ROW_FIELDS,
     ambiguity_note,
     dataset_summary,
     fit_budget,
@@ -258,7 +258,7 @@ def dataset_list(invocation: Invocation) -> HandlerResult:
         return _dataset_name_search(invocation, project_id, name.strip(), document)
     compact = not document.get("full")
     if compact:
-        kwargs["fields"] = DATASET_LIST_FIELDS
+        kwargs["fields"] = DATASET_ROW_FIELDS
     with open_service(invocation) as (service, auth):
         data = service.call(_symbol(invocation), **kwargs)
     if compact:
@@ -279,7 +279,7 @@ def _dataset_name_search(
             "mammoth.api.datasets.DatasetsAPI.list_all",
             project_id=project_id,
             sort=document.get("sort", "(created_at:desc)"),
-            fields=DATASET_LIST_FIELDS,
+            fields=DATASET_ROW_FIELDS,
         )
         records = data.get("datasets", []) if isinstance(data, dict) else []
         page = search_page(records, name, int(document.get("offset", 0)), document.get("limit"))

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/mammoth_cli/commands/project.py

@@ -115,7 +115,11 @@ def _forward_optional(
 
 
 def project_list(invocation: Invocation) -> HandlerResult:
-    """List projects in the active workspace, one page at a time.
+    """List the caller's member projects in the active workspace, one page at a time.
+
+    These are the projects the Mammoth UI shows. ``include_non_members: true``
+    adds the other workspace projects (workspace owners and admins can read
+    them but not open them); every row then carries ``member``.
 
     ``offset`` forwards for pagination past the server's 100-row page, the
     same as ``dataset list``; a short page's ``next`` in the response is
@@ -124,7 +128,7 @@ def project_list(invocation: Invocation) -> HandlerResult:
     """
     document = invocation.load_input() or {}
     kwargs: dict[str, Any] = {"limit": int(document.get("limit", 100))}
-    _forward_optional(document, kwargs, ("offset",))
+    _forward_optional(document, kwargs, ("offset", "include_non_members"))
     with open_service(invocation) as (service, auth):
         data = service.call(_symbol(invocation), **kwargs)
     return data, _meta(invocation, auth.workspace_id, resolved_project(invocation))
@@ -146,6 +150,14 @@ def project_pending_changes(invocation: Invocation) -> HandlerResult:
     return data, _meta(invocation, auth.workspace_id, project_id)
 
 
+def project_needs_attention(invocation: Invocation) -> HandlerResult:
+    """List the Monitor "Needs Attention" rows with the dataset behind each view."""
+    project_id = _project_id(invocation)
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), project_id=project_id)
+    return data, _meta(invocation, auth.workspace_id, project_id)
+
+
 def project_memory_list(invocation: Invocation) -> HandlerResult:
     """List the caller's saved agent preferences for a project."""
     project_id = _project_id(invocation)

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/mammoth_cli/commands/registry.py

@@ -253,6 +253,7 @@ HANDLERS: dict[str, Handler] = {
     "project.list": project_cmd.project_list,
     "project.get": project_cmd.project_get,
     "project.check": project_cmd.project_check,
+    "project.needs-attention": project_cmd.project_needs_attention,
     "project.pending-changes": project_cmd.project_pending_changes,
     "project.memory.list": project_cmd.project_memory_list,
     "project.memory.add": project_cmd.project_memory_add,
@@ -293,6 +294,11 @@ HANDLERS: dict[str, Handler] = {
     "workspace.delete": workspace_cmd.workspace_delete,
     "workspace.get": workspace_cmd.workspace_get,
     "workspace.list": workspace_cmd.workspace_list,
+    "workspace.invite.delete": workspace_cmd.workspace_invite_delete,
+    "workspace.invite.list": workspace_cmd.workspace_invite_list,
+    "workspace.invite.resend": workspace_cmd.workspace_invite_resend,
+    "workspace.invite.revoke": workspace_cmd.workspace_invite_revoke,
+    "workspace.invite.update-role": workspace_cmd.workspace_invite_update_role,
     "workspace.llm-task": workspace_cmd.workspace_llm_task,
     "workspace.reactivate": workspace_cmd.workspace_reactivate,
     "workspace.segment.list": workspace_cmd.workspace_segment_list,

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/mammoth_cli/commands/schema.py

@@ -341,6 +341,9 @@ _COMMAND_DISCOVERY_PURPOSES = {
     "project.pending-changes": (
         "source changes new rows not taken in yet pending updates waiting to apply"
     ),
+    "project.needs-attention": (
+        "monitor needs attention error failing pipeline views delete datasets behind list"
+    ),
     "project.resource-status": "stuck stale failing broken error status anything wrong health",
     "connector.ai.chat": (
         "connect our own internal custom api build a connector for an unsupported source"

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/mammoth_cli/commands/workspace.py

@@ -308,7 +308,7 @@ def workspace_user_list(invocation: Invocation) -> HandlerResult:
     """
     document = invocation.load_input() or {}
     kwargs: dict[str, Any] = {"fields": _USER_LIST_FIELDS}
-    _forward_optional(document, kwargs, ("fields",))
+    _forward_optional(document, kwargs, ("fields", "project_id"))
     with open_service(invocation) as (service, auth):
         data = service.call(_symbol(invocation), **kwargs)
     return data, _meta(invocation, auth.workspace_id)
@@ -372,3 +372,55 @@ def workspace_user_update_batch(invocation: Invocation) -> HandlerResult:
     with open_service(invocation) as (service, auth):
         data = service.call(_symbol(invocation), patches=patches)
     return data, _meta(invocation, auth.workspace_id)
+
+
+def workspace_invite_list(invocation: Invocation) -> HandlerResult:
+    """List pending invites with their invite ids; ``project_id`` narrows to one project."""
+    document = invocation.load_input() or {}
+    kwargs: dict[str, Any] = {}
+    _forward_optional(document, kwargs, ("project_id",))
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), **kwargs)
+    return data, _meta(invocation, auth.workspace_id)
+
+
+def _invite_ids_call(invocation: Invocation) -> HandlerResult:
+    document = invocation.load_input()
+    invite_ids = _require_field(document, "invite_ids")
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), invite_ids=invite_ids)
+    return data, _meta(invocation, auth.workspace_id)
+
+
+def workspace_invite_resend(invocation: Invocation) -> HandlerResult:
+    """Send the invitation email again. ``invite_ids`` from ``--input``."""
+    return _invite_ids_call(invocation)
+
+
+def workspace_invite_revoke(invocation: Invocation) -> HandlerResult:
+    """Revoke pending invites. Prompt or ``--yes`` required."""
+    enforce_confirmation(
+        invocation, policy=POLICY_PROMPT_OR_YES, action="revoke pending workspace invites"
+    )
+    return _invite_ids_call(invocation)
+
+
+def workspace_invite_delete(invocation: Invocation) -> HandlerResult:
+    """Delete pending invites and free their seats. Prompt or ``--yes`` required."""
+    enforce_confirmation(
+        invocation, policy=POLICY_PROMPT_OR_YES, action="delete pending workspace invites"
+    )
+    return _invite_ids_call(invocation)
+
+
+def workspace_invite_update_role(invocation: Invocation) -> HandlerResult:
+    """Change the role a pending invite grants. ``--yes`` required."""
+    document = invocation.load_input()
+    invite_id = _require_field(document, "invite_id")
+    role = _require_field(document, "role")
+    enforce_confirmation(
+        invocation, policy=POLICY_YES_ALWAYS, action=f"change the role of invite {invite_id}"
+    )
+    with open_service(invocation) as (service, auth):
+        data = service.call(_symbol(invocation), invite_id=invite_id, role=role)
+    return data, _meta(invocation, auth.workspace_id)

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/mammoth_cli/runtime/dryrun_targets.py

@@ -132,6 +132,16 @@ class Sub:
 
 _VIEW_FWD = ("dataset_id", "dataview_id", "project_id")
 
+#: A pending workspace invite, named by its email from ``workspace invite list``.
+_INVITE_SUB = Sub(
+    "invite",
+    "invite_ids",
+    source="workspace.invite.list",
+    container="invites",
+    label_paths=("email",),
+    name_fmt="invite for {label}",
+)
+
 #: Command -> the sub-resources it changes. Shapes verified live on koyal:
 #: task ``params.SEQUENCE_NUMBER``/``params.TASK_KEY``; version ``name``;
 #: agent session ``title``; parameter group ``name``; tag ``name``; context
@@ -303,6 +313,8 @@ SUBS: dict[str, tuple[Sub, ...]] = {
             name_fmt="{label} › access to {parent}",
         ),
     ),
+    "workspace.invite.delete": (_INVITE_SUB,),
+    "workspace.invite.revoke": (_INVITE_SUB,),
     "notification.delete": (Sub("notification", "notification_id"),),
     "notification.delete-batch": (Sub("notification", "ids"),),
 }
@@ -526,6 +538,16 @@ def _target_spec(command_id: str, would_call: Mapping[str, Any]) -> tuple[str, s
     return None
 
 
+def _remove_batch_invites(
+    service: MammothService, command_id: str, arguments: Mapping[str, Any]
+) -> list[dict[str, Any]]:
+    """The pending invites a ``user remove-batch`` call deletes, named by email."""
+    invite_ids = _ids(arguments.get("invite_ids"))
+    if not invite_ids:
+        return []
+    return _sub_targets(service, command_id, _INVITE_SUB, {"invite_ids": invite_ids})
+
+
 def resolve_targets(
     service: MammothService, command_id: str, would_call: Mapping[str, Any]
 ) -> list[dict[str, Any]]:
@@ -559,8 +581,9 @@ def resolve_targets(
         return []
     kind, id_arg = spec
     ids = _ids(arguments.get(id_arg, would_call.get(id_arg)))
-    if arguments.get("invite_ids"):
-        raise unresolvable_error(command_id, "pending invites have no read that names them")
+    invites = _remove_batch_invites(service, command_id, arguments)
+    if not ids and invites:
+        return invites
     if not ids:
         raise unresolvable_error(
             command_id, f"the call carries no explicit '{id_arg}' ids (it may target every {kind})"
@@ -572,7 +595,7 @@ def resolve_targets(
     parent = {**arguments}
     if "dataset_id" not in parent and would_call.get("dataset_id") is not None:
         parent["dataset_id"] = would_call["dataset_id"]
-    return [_read_name(service, kind, item, parent) for item in ids]
+    return [_read_name(service, kind, item, parent) for item in ids] + invites
 
 
 #: Deletes whose dry run also lists what depends on the resource: command ->

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/mammoth_cli/runtime/runlog.py

@@ -30,6 +30,7 @@ import json
 import logging
 import os
 import sys
+import threading
 import time
 import uuid
 from dataclasses import dataclass, field
@@ -45,6 +46,12 @@ LOG_DIR_ENV = "MAMMOTH_LOG_DIR"
 RETENTION_DAYS = 7
 MAX_FILE_BYTES = 20 * 1024 * 1024
 _LOGGER_NAMES = ("mammoth", "mammoth_cli")
+#: Invocations overlap in an embedded host (one thread each). Logger levels are
+#: process-wide, so they are saved by the first attach and restored by the last
+#: detach; a per-invocation restore silenced the others' ``mammoth.http`` lines.
+_LEVEL_LOCK = threading.Lock()
+_ATTACHED = 0
+_SAVED_LEVELS: dict[str, int] = {}
 _INPUT_OPTION = "--input"
 _REDACTED_INPUT = "<redacted --input>"
 
@@ -234,12 +241,19 @@ class RunLog:
     def attach(self, *, debug: bool) -> None:
         if self._disabled:
             return
+        global _ATTACHED
         level = logging.DEBUG if debug else logging.INFO
+        with _LEVEL_LOCK:
+            if _ATTACHED == 0:
+                _SAVED_LEVELS.update({n: logging.getLogger(n).level for n in _LOGGER_NAMES})
+            _ATTACHED += 1
+            self._previous_levels.update(_SAVED_LEVELS)
+            for name in _LOGGER_NAMES:
+                logger = logging.getLogger(name)
+                if logger.level == logging.NOTSET or logger.level > level:
+                    logger.setLevel(level)
         for name in _LOGGER_NAMES:
             logger = logging.getLogger(name)
-            self._previous_levels[name] = logger.level
-            if logger.level == logging.NOTSET or logger.level > level:
-                logger.setLevel(level)
             handlers: list[logging.Handler] = [_JsonlHandler(self)]
             if debug:
                 handlers.append(_StderrHandler(level=level))
@@ -250,8 +264,14 @@ class RunLog:
     def detach(self) -> None:
         for logger, handler in self._handlers:
             logger.removeHandler(handler)
-        for name, level in self._previous_levels.items():
-            logging.getLogger(name).setLevel(level)
+        global _ATTACHED
+        if self._previous_levels:
+            with _LEVEL_LOCK:
+                _ATTACHED -= 1
+                if _ATTACHED == 0:
+                    for name, level in _SAVED_LEVELS.items():
+                        logging.getLogger(name).setLevel(level)
+            self._previous_levels.clear()
         self._handlers.clear()
 
 

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/mammoth_cli/services/command_contract.py

@@ -482,6 +482,7 @@ S2_COMMANDS = frozenset(
         "project.memory.add",
         "project.memory.list",
         "project.memory.remove",
+        "project.needs-attention",
         "project.pending-changes",
         "project.publish-credentials",
         "project.resource-dependencies",

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/mammoth_cli/services/listing.py

@@ -26,6 +26,10 @@ DATASET_LIST_FIELDS = (
     "id,name,created_at,updated_at,status,stats,sources,data_schema,additional_info"
 )
 
+#: ``fields`` for ``dataset list`` rows: only what the server computes cheaply. ``stats``
+#: (row count: DuckDB) and ``data_schema`` stay on ``dataset get``.
+DATASET_ROW_FIELDS = "id,name,created_at,updated_at,status,sources,additional_info"
+
 _MAX_COLUMNS = 4
 #: Columns whose stored sample values a view summary shows, and values per column.
 _SAMPLE_COLUMNS = 6

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/mammoth_cli/services/positionals.py

@@ -130,6 +130,8 @@ POSITIONAL_OVERRIDES: dict[str, tuple[PositionalSpec, ...]] = {
     # The chat session is the global ``--session`` option, never a positional or
     # an --input field; only the action or run being addressed is positional.
     "agent.action.list": (),
+    # The invite is named in ``--input`` (``invite_id``), never positionally.
+    "workspace.invite.update-role": (),
     "agent.run.status": (),
     "agent.run.list": (),
     "agent.action.delete": (
@@ -301,6 +303,7 @@ POSITIONAL_OVERRIDES: dict[str, tuple[PositionalSpec, ...]] = {
             help="Check only this dataset's first view; no other dataset or dashboard is read.",
         ),
     ),
+    "project.needs-attention": _optional_project_id(),
     "project.pending-changes": _optional_project_id(),
     "project.memory.list": _optional_project_id(),
     "project.memory.add": _optional_project_id(),

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/mammoth_cli/services/protocol.py

@@ -64,7 +64,9 @@ class MammothService(Protocol):
         """
         ...
 
-    def list_projects(self, limit: int = 100, offset: int = 0) -> dict[str, Any]:
+    def list_projects(
+        self, limit: int = 100, offset: int = 0, include_non_members: bool = False
+    ) -> dict[str, Any]:
         """List projects in the current workspace.
 
         Args:
@@ -76,7 +78,7 @@ class MammothService(Protocol):
         """
         ...
 
-    def list_all_projects(self) -> list[dict[str, Any]]:
+    def list_all_projects(self, include_non_members: bool = False) -> list[dict[str, Any]]:
         """Every project in the workspace, across the route's pages.
 
         Returns:

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/mammoth_cli/services/sdk_service.py

@@ -792,8 +792,10 @@ class SdkMammothService:
         except Exception as exc:
             raise map_sdk_exception(exc) from exc
 
-    def list_projects(self, limit: int = 100, offset: int = 0) -> dict[str, Any]:
-        """List projects in the current workspace.
+    def list_projects(
+        self, limit: int = 100, offset: int = 0, include_non_members: bool = False
+    ) -> dict[str, Any]:
+        """List projects in the current workspace (member projects unless widened).
 
         The projects route caps ``limit`` at 100 and pages with a server-side
         ``offset``; a larger ``limit`` is served by walking the pages.
@@ -801,6 +803,8 @@ class SdkMammothService:
         Args:
             limit: Maximum number of results.
             offset: Number of leading results to skip.
+            include_non_members: Also list projects the caller is not a member
+                of; each row then carries ``member``.
 
         Returns:
             The raw project-list response, with ``projects`` holding at most
@@ -811,9 +815,15 @@ class SdkMammothService:
         """
         try:
             if limit <= _PROJECT_PAGE_SIZE:
-                response = self._run(self._client.projects.list(limit=limit, offset=offset))
+                response = self._run(
+                    self._client.projects.list(
+                        limit=limit, offset=offset, include_non_members=include_non_members
+                    )
+                )
                 return {**response, "projects": list(response.get("projects", []))}
-            everything = self._run(self._client.projects.list_all())
+            everything = self._run(
+                self._client.projects.list_all(include_non_members=include_non_members)
+            )
         except Exception as exc:
             raise map_sdk_exception(exc) from exc
         return {
@@ -823,14 +833,20 @@ class SdkMammothService:
             "next": "",
         }
 
-    def list_all_projects(self) -> list[dict[str, Any]]:
-        """Every project in the workspace, across the route's 100-row pages.
+    def list_all_projects(self, include_non_members: bool = False) -> list[dict[str, Any]]:
+        """Every member project in the workspace, across the route's 100-row pages.
+
+        Args:
+            include_non_members: Also list projects the caller is not a member
+                of; each row then carries ``member``.
 
         Raises:
             CliError: Mapped from any SDK exception.
         """
         try:
-            return list(self._run(self._client.projects.list_all()))
+            return list(
+                self._run(self._client.projects.list_all(include_non_members=include_non_members))
+            )
         except Exception as exc:
             raise map_sdk_exception(exc) from exc
 

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/mammoth_cli/services/testing.py

@@ -120,12 +120,14 @@ class FakeMammothService:
             )
         return {"projects": self.projects[:1]}
 
-    def list_projects(self, limit: int = 100, offset: int = 0) -> dict[str, Any]:
+    def list_projects(
+        self, limit: int = 100, offset: int = 0, include_non_members: bool = False
+    ) -> dict[str, Any]:
         """Return the in-memory project list, sliced by offset/limit."""
         self.calls.append("list_projects")
         return {"projects": self.projects[offset : offset + limit]}
 
-    def list_all_projects(self) -> list[dict[str, Any]]:
+    def list_all_projects(self, include_non_members: bool = False) -> list[dict[str, Any]]:
         """Return the whole in-memory project list."""
         self.calls.append("list_all_projects")
         return list(self.projects)

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "mammoth-cli"
-version = "2.2.2"
+version = "2.2.3"
 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.8.4,<0.9)",
+    "mammoth-io (>=0.8.5,<0.9)",
     "typer (>=0.27,<0.28)",
     "rich (>=15,<16)",
     "platformdirs (>=4.10,<5)",

{mammoth_cli-2.2.2 → mammoth_cli-2.2.3}/spec/manifests/commands/project.yaml

@@ -546,6 +546,49 @@ commands:
     ids:
       project_id: positional.0
     kind: object
+- command_id: project.needs-attention
+  command_path: project needs-attention
+  disposition: command
+  alias_of: null
+  operation_ids: []
+  positionals:
+  - name: project_id
+    type: int
+    required: false
+    metavar: PROJECT_ID
+    falls_back_to_field: null
+    help: ID of the project to act on; defaults to the active project.
+  options: []
+  sdk_symbol: mammoth.api.projects.ProjectsAPI.needs_attention
+  sdk_conversion: Call mammoth.api.projects.ProjectsAPI.needs_attention with validated request fields.
+  request_model: ProjectNeedsAttentionRequest
+  result_model: ProjectNeedsAttentionResult
+  mutation_class: read
+  confirmation: none
+  wait_policy: not_async
+  pagination_policy: none
+  acceptance_evidence: live_read_only
+  live_test: LT-PROJECT-NEEDS-ATTENTION
+  live_exemption_reason: null
+  contract_fixture: null
+  required_fixture_guard: null
+  secret_fields: []
+  human_example: mammoth project needs-attention --help
+  agent_example: mammoth project needs-attention 123
+  unit_tests:
+  - UT-PROJECT-NEEDS-ATTENTION
+  contract_tests:
+  - CT-PROJECT-NEEDS-ATTENTION-HUMAN
+  - CT-PROJECT-NEEDS-ATTENTION-JSON
+  - CT-PROJECT-NEEDS-ATTENTION-ERROR
+  draft_test: null
+  undo_test: null
+  known_restrictions: 'The rows of the Monitor Needs Attention tab for one project (the app has no workspace-wide list): pipeline_error, pending_pipeline, pending_data, checkpoint (needs approval), data_check (failed), each with view_id and the owning dataset_id; datasets lists each affected dataset once with its view_ids. Dataset-level action-needed items and pending retentions are not returned by the API and are not included. To delete the datasets behind the views, take dataset_id from datasets and run dataset delete or dataset bulk-delete (confirm first).'
+  reviewed_by: primary
+  readback:
+    command: project.needs-attention
+    ids: {}
+    kind: object
 - command_id: project.pending-changes
   command_path: project pending-changes
   disposition: command