zen-cli 0.1.6__tar.gz → 0.1.7__tar.gz

{zen_cli-0.1.6 → zen_cli-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: zen-cli
-Version: 0.1.6
+Version: 0.1.7
 Summary: CLI for Zen Desktop Service. Designed for AI and Human.
 Project-URL: Homepage, https://pypi.org/project/zen-cli/
 Author: zen-cli authors
@@ -34,29 +34,29 @@ Description-Content-Type: text/markdown
 
 [![PyPI](https://img.shields.io/pypi/v/zen-cli?logo=pypi&logoColor=white)](https://pypi.org/project/zen-cli/) [![Python](https://img.shields.io/badge/python-3.12%2B-3776AB?logo=python&logoColor=white)](https://www.python.org/downloads/) [![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE) [![PyPI downloads](https://img.shields.io/pypi/dm/zen-cli)](https://pypi.org/project/zen-cli/) [![Wheel](https://img.shields.io/pypi/wheel/zen-cli)](https://pypi.org/project/zen-cli/) [![OS](https://img.shields.io/badge/OS-macOS%20%7C%20Linux%20%7C%20Windows-informational)](https://pypi.org/project/zen-cli/) [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff) [![Checked with mypy](https://img.shields.io/badge/mypy-checked-2A6DB2)](https://mypy-lang.org/) [![Click](https://img.shields.io/badge/cli-Click%208-4584b6)](https://click.palletsprojects.com/) [![Hatch](https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5)](https://github.com/pypa/hatch)
 
-Command-line toolbox for Zen Cloud PC, designed for AI and human.
+面向 AI 和人的 Zen Cloud 命令行工具。
 
-## Contents
+## 目录
 
-- [Try it out](#try-it-out)
-  - [Prerequisites](#prerequisites)
-  - [Installation](#installation)
-    - [Mac & Linux](#mac--linux)
+- [试用](#试用)
+  - [前置条件](#前置条件)
+  - [安装](#安装)
+    - [Mac 与 Linux](#mac-与-linux)
     - [Windows](#windows)
-  - [Use the CLI](#use-the-cli)
-- [Documentation](#documentation)
-- [License](#license)
+  - [使用 CLI](#使用-cli)
+- [文档](#文档)
+- [许可证](#许可证)
 
-## Try it out
+## 试用
 
-### Prerequisites
+### 前置条件
 
-* Python 3.12 or newer
+* Python 3.12 或更新版本
 * Pip
 
-### Installation
+### 安装
 
-#### Mac & Linux
+#### Mac 与 Linux
 
 ```text
 pip install zen-cli
@@ -68,9 +68,9 @@ pip install zen-cli
 pip install zen-cli
 ```
 
-If Python was installed without “Add python to PATH”, add Python and its `Scripts` directory to PATH.
+如果安装 Python 时没有勾选 “Add python to PATH”，请把 Python 及其 `Scripts` 目录加入 PATH。
 
-### Use the CLI
+### 使用 CLI
 
 ```text
 zen login
@@ -79,20 +79,22 @@ zen auth details
 zen auth token
 ```
 
-`zen login` reuses a valid cached token or configured credentials (API token, client id/secret). If neither is available it starts device-code login. It does not print the access token. Machine login is `zen login --client-id` / `--client-secret`. `zen auth status` is JSON (`logged_in`, `method`, `ttl`). `zen auth details` is the JWT and org. `zen auth token` is the bearer (`--service` on details/token). `zen auth refresh` refreshes the cached token.
 
-Run a command, for example, list pools:
+跑一条命令，例如列出桌面池：
 
 ```text
 zen pool list
 ```
 
-## Documentation
+## 文档
 
-* [User guide](docs/user-guide.md) — profiles, flags, payloads, and command conventions
-* [Cheatsheet](docs/cheatsheet.md) — command examples
-* [Developer guide](docs/dev.md) — build, test, and package layout
+* [用户指南](docs/user-guide.md) — profile、旗标、请求体和命令约定
+* [环境变量](docs/env.md) — `zen` 读取的环境变量
+* [速查](docs/cheatsheet.md) — 命令示例
+* [CLI 通用原则](docs/cli-principles.md) — 退出码、输出格式、通用参数和特例
+* [开发指南](docs/dev-guide.md) — 环境、`dev.py`、Jenkins 和如何加命令
+* [编码原则](docs/coding-principles.md) — 包划分和导入方向
 
-## License
+## 许可证
 
-Licensed under the MIT License. See [LICENSE](LICENSE).
+采用 MIT License。见 [LICENSE](LICENSE)。

zen_cli-0.1.7/README.md

@@ -0,0 +1,68 @@
+# zen-cli
+
+[![PyPI](https://img.shields.io/pypi/v/zen-cli?logo=pypi&logoColor=white)](https://pypi.org/project/zen-cli/) [![Python](https://img.shields.io/badge/python-3.12%2B-3776AB?logo=python&logoColor=white)](https://www.python.org/downloads/) [![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE) [![PyPI downloads](https://img.shields.io/pypi/dm/zen-cli)](https://pypi.org/project/zen-cli/) [![Wheel](https://img.shields.io/pypi/wheel/zen-cli)](https://pypi.org/project/zen-cli/) [![OS](https://img.shields.io/badge/OS-macOS%20%7C%20Linux%20%7C%20Windows-informational)](https://pypi.org/project/zen-cli/) [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff) [![Checked with mypy](https://img.shields.io/badge/mypy-checked-2A6DB2)](https://mypy-lang.org/) [![Click](https://img.shields.io/badge/cli-Click%208-4584b6)](https://click.palletsprojects.com/) [![Hatch](https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5)](https://github.com/pypa/hatch)
+
+面向 AI 和人的 Zen Cloud 命令行工具。
+
+## 目录
+
+- [试用](#试用)
+  - [前置条件](#前置条件)
+  - [安装](#安装)
+    - [Mac 与 Linux](#mac-与-linux)
+    - [Windows](#windows)
+  - [使用 CLI](#使用-cli)
+- [文档](#文档)
+- [许可证](#许可证)
+
+## 试用
+
+### 前置条件
+
+* Python 3.12 或更新版本
+* Pip
+
+### 安装
+
+#### Mac 与 Linux
+
+```text
+pip install zen-cli
+```
+
+#### Windows
+
+```text
+pip install zen-cli
+```
+
+如果安装 Python 时没有勾选 “Add python to PATH”，请把 Python 及其 `Scripts` 目录加入 PATH。
+
+### 使用 CLI
+
+```text
+zen login
+zen auth status
+zen auth details
+zen auth token
+```
+
+
+跑一条命令，例如列出桌面池：
+
+```text
+zen pool list
+```
+
+## 文档
+
+* [用户指南](docs/user-guide.md) — profile、旗标、请求体和命令约定
+* [环境变量](docs/env.md) — `zen` 读取的环境变量
+* [速查](docs/cheatsheet.md) — 命令示例
+* [CLI 通用原则](docs/cli-principles.md) — 退出码、输出格式、通用参数和特例
+* [开发指南](docs/dev-guide.md) — 环境、`dev.py`、Jenkins 和如何加命令
+* [编码原则](docs/coding-principles.md) — 包划分和导入方向
+
+## 许可证
+
+采用 MIT License。见 [LICENSE](LICENSE)。

{zen_cli-0.1.6 → zen_cli-0.1.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "zen-cli"
-version = "0.1.6"
+version = "0.1.7"
 description = "CLI for Zen Desktop Service. Designed for AI and Human."
 readme = "README.md"
 license = "MIT"
@@ -44,7 +44,7 @@ include = ["src/zen_cli", "tests", "README.md", "LICENSE"]
 target-version = "py312"
 line-length = 120
 src = ["src"]
-exclude = ["cli-ref", "src/zen_cli/support/test_utils2.py"]
+exclude = ["cli-ref"]
 
 [tool.ruff.lint]
 select = ["E", "F", "I", "UP", "B", "SIM", "RUF"]
@@ -53,7 +53,6 @@ select = ["E", "F", "I", "UP", "B", "SIM", "RUF"]
 python_version = "3.12"
 strict = true
 files = ["src"]
-exclude = ["test_utils2\\.py"]
 
 [[tool.mypy.overrides]]
 module = ["mcp", "mcp.*"]

zen_cli-0.1.7/src/zen_cli/__init__.py

@@ -0,0 +1,14 @@
+"""zen-cli package."""
+
+_httpx_aliased = False
+
+
+def alias_httpx() -> None:
+    """Install httpx2 as httpx. Call before the first HTTP client import."""
+    global _httpx_aliased
+    if _httpx_aliased:
+        return
+    import httpx2
+
+    httpx2.alias_httpx()
+    _httpx_aliased = True

{zen_cli-0.1.6 → zen_cli-0.1.7}/src/zen_cli/cli.py

@@ -32,11 +32,8 @@ logging.getLogger("urllib3").setLevel(logging.ERROR)
 # logging.getLogger("zen_cli.sglib.login_support").setLevel(logging.DEBUG)
 # logging.getLogger("login_support").setLevel(logging.DEBUG)
 # -----------------------------------------------------------
-import zen_cli.sglib.ez_client as ez_client  # noqa: E402
 
-ez_client._print_http_error = False
-
-CONTEXT_SETTINGS = {
+CONTEXT_SETTINGS: dict[str, Any] = {
     "help_option_names": ["-h", "--help"],
     "max_content_width": 160,
 }
@@ -52,6 +49,7 @@ def _apply_readonly() -> None:
     else:
         is_readonly = bool(is_readonly)
     if is_readonly:
+        from zen_cli.sglib import ez_client
         from zen_cli.util import readonly as readonly_support
 
         ez_client.set_readonly(True, readonly_support.ALLOW_PATHS)
@@ -75,7 +73,7 @@ def _enable_verbose() -> None:
 
 
 def _check_upgrade() -> None:
-    check_flag_from_env = env.bool("HCS_CLI_CHECK_UPGRADE", True)
+    check_flag_from_env = env.bool("ZEN_CLI_CHECK_UPGRADE", True)
     if not check_flag_from_env:
         return
     if os.environ.get("_ZEN_COMPLETE"):
@@ -105,7 +103,7 @@ def _check_upgrade() -> None:
 @click.option(
     "--check-upgrade/--no-check-upgrade",
     default=None,
-    help="Check for a new zen-cli version. On by default. Or set HCS_CLI_CHECK_UPGRADE=false.",
+    help="Check for a new zen-cli version. On by default. Or set ZEN_CLI_CHECK_UPGRADE=false.",
 )
 @click.option(
     "--telemetry/--no-telemetry",
@@ -155,6 +153,9 @@ def cli(
 
         mdc_session.set(mdc)
 
+    from zen_cli.support.recent import install as install_recent
+
+    install_recent()
     _apply_readonly()
     load_commands()
 
@@ -171,6 +172,8 @@ def load_commands() -> None:
 def main() -> None:
     ctxp.init(app_name="zen", config_path=str(_CONFIG_DIR))
     load_dotenv(".env")
+    if not logger.color_enabled():
+        CONTEXT_SETTINGS["color"] = False
     if os.environ.get("_ZEN_COMPLETE"):
         ctxp.telemetry.disable()
     ctxp.init_cli(main_cli=cli, commands_dir=str(_COMMANDS_DIR))

{zen_cli-0.1.6 → zen_cli-0.1.7}/src/zen_cli/cmds/activity/list.py

@@ -3,8 +3,9 @@ from typing import Any
 import click
 
 import zen_cli.sglib.cli_options as cli
-from zen_cli.ctxp import recent, util
+from zen_cli.ctxp import recent
 from zen_cli.service import activity
+from zen_cli.support.activity import format_activity_table
 
 _RESOURCE_TYPES = [
     "ORG",
@@ -28,26 +29,6 @@ _RESOURCE_TYPES = [
     "NOTIFICATION",
 ]
 
-_TABLE_MAPPING = {
-    "code": "Code",
-    "severity": "Severity",
-    "initiator": "Initiator",
-    "serviceName": "Service",
-    "resourceId": "Resource",
-    "traceId": "Trace",
-}
-
-
-def _format_activity_table(data: Any) -> Any:
-    for d in data:
-        if d.get("timestamp") and not d.get("createdAt"):
-            d["createdAt"] = d["timestamp"]
-        if not d.get("name"):
-            d["name"] = d.get("resourceName") or d.get("code") or ""
-        if not d.get("type"):
-            d["type"] = d.get("resourceType")
-    return util.default_table_formatter(data, _TABLE_MAPPING)
-
 
 @click.command(name="list")
 @cli.org_id
@@ -101,7 +82,7 @@ def _format_activity_table(data: Any) -> Any:
 )
 @cli.sort
 @cli.limit
-@cli.formatter(_format_activity_table)
+@cli.formatter(format_activity_table)
 def list_activities(
     org: str,
     service_name: str,

{zen_cli-0.1.6 → zen_cli-0.1.7}/src/zen_cli/cmds/api.py

@@ -2,9 +2,7 @@ from typing import Any
 
 import click
 
-from zen_cli.service import api as zen_api
 from zen_cli.sglib import mdc as mdc_session
-from zen_cli.sglib.client_util import resolve_zds_base_url
 from zen_cli.support.payload import handle_data_input
 
 
@@ -108,6 +106,9 @@ def api(
     if raise_on_404 and method not in ("GET", "DELETE"):
         raise click.UsageError("The --raise-on-404 option is only applicable for GET and DELETE methods.")
 
+    from zen_cli.service import api as zen_api
+    from zen_cli.sglib.client_util import resolve_zds_base_url
+
     raw_data, json_data = handle_data_input(data_arg, json_arg)
 
     if method in ["GET", "DELETE"] and (raw_data is not None or json_data is not None):

{zen_cli-0.1.6 → zen_cli-0.1.7}/src/zen_cli/cmds/auth/status.py

@@ -13,5 +13,5 @@ from zen_cli.support import auth as auth_support
     help="Report login status for a target service override.",
 )
 def status(service: str | None) -> Any:
-    """Show whether you are logged in, the login method, and token TTL in seconds."""
+    """Show whether you are logged in, TTL, and main JWT identity (name, acct, org, roles)."""
     return auth_support.session_status(service)

{zen_cli-0.1.6 → zen_cli-0.1.7}/src/zen_cli/cmds/completion.py

@@ -9,6 +9,9 @@ _SHELLS = ("bash", "zsh", "fish", "powershell")
 def completion(shell: str) -> None:
     """Print a shell completion script.
 
+    Writes the script to stdout (not via --output). I/O flags do not apply.
+    Skips the startup upgrade check.
+
     \b
     bash:
         eval "$(zen completion bash)"

zen_cli-0.1.7/src/zen_cli/cmds/deployment/list.py

@@ -0,0 +1,19 @@
+from typing import Any
+
+import click
+
+import zen_cli.sglib.cli_options as cli
+from zen_cli.ctxp import recent
+from zen_cli.service import deployment
+from zen_cli.support.deployment import format_deployment_table
+
+
+@click.command(name="list")
+@cli.org_id
+@cli.limit
+@cli.formatter(format_deployment_table)
+def list_deployments(org: str, **kwargs: Any) -> Any:
+    """List express deployments."""
+    ret = deployment.list(org_id=cli.get_org_id(org), **kwargs)
+    recent.helper.default_list(ret, "deployment")
+    return ret

{zen_cli-0.1.6 → zen_cli-0.1.7}/src/zen_cli/cmds/login.py

@@ -6,8 +6,8 @@ import click
 import zen_cli.ctxp as ctxp
 import zen_cli.sglib as sglib
 from zen_cli.ctxp.util import error_details
-from zen_cli.sglib import login_support
 from zen_cli.sglib.cli_options import use_org
+from zen_cli.support import auth as auth_support
 from zen_cli.support import profile as profile_support
 
 # Login use cases:
@@ -88,12 +88,14 @@ def login(
     """Login Zen Desktop Service.
 
     This command works with the current profile and will update the current profile.
+    --org is the login org, not a resource --org. --verbose is this command's own flag.
+
     With no method flag, reuses the cached token or configured credentials.
     If neither is available, starts device-code login. Browser SSO runs only
     with `--browser`.
 
-    Inspect or refresh an existing session with `zen auth` (not this command):
-    `zen auth status`, `zen auth details`, `zen auth token`, `zen auth refresh`.
+    On success, prints the same JSON as `zen auth status`.
+    Inspect or refresh later with `zen auth details`, `zen auth token`, `zen auth refresh`.
     Per-service tokens: `zen auth details --service` / `zen auth token --service`.
 
     \b
@@ -183,6 +185,8 @@ def login(
 
     interactive = browser or device_code
 
+    from zen_cli.sglib import login_support
+
     if interactive and not login_support.identify_client_id(csp.url):
         return ctxp.error(
             "The interactive login on the specified stack is not yet available. Try a different authentication method."
@@ -240,7 +244,7 @@ def login(
         # Cache key is md5(csp config); re-save so orgId backfill does not orphan the entry.
         sglib.auth.save_auth_cache(csp, oauth_token)
 
-    return None
+    return auth_support.session_status()
 
 
 def _is_missing_session(err: BaseException) -> bool:
@@ -253,6 +257,8 @@ def _echo(msg: str) -> None:
 
 
 def _do_browser_login() -> Any:
+    from zen_cli.sglib import login_support
+
     current: Any = ctxp.profile.current()
     auth_config = current.csp
     org_id = auth_config.orgId
@@ -282,21 +288,19 @@ def _do_browser_login() -> Any:
 
 
 def _do_device_login() -> Any:
+    from zen_cli.sglib import login_support
+
     current: Any = ctxp.profile.current()
     auth_config = current.csp
     org_id = auth_config.orgId
 
     def _announce(started: dict[str, Any]) -> None:
-        uri = started.get("verification_uri") or ""
-        complete = started.get("verification_uri_complete") or uri
+        url = started.get("verification_uri_complete") or started.get("verification_uri") or ""
         _echo("Logging to Zen Desktop Service with device code...")
         _echo(f"  CSP:          {auth_config.url}")
         _echo(f"  Organization: {org_id if org_id else '<default>'}")
         _echo(f"  Profile:      {ctxp.profile.name()}")
-        _echo(f"On any device, open {uri} and enter this code:")
-        _echo(f"  {started.get('user_code')}")
-        if complete and complete != uri:
-            _echo(f"Or open: {complete}")
+        _echo(f"Open: {url}")
         _echo("Waiting for authorization. Press CTRL+C to abort.")
 
     token = login_support.login_via_device_code(auth_config.url, org_id, announce=_announce)

{zen_cli-0.1.6 → zen_cli-0.1.7}/src/zen_cli/cmds/mcp.py

@@ -5,6 +5,9 @@ import click
 def mcp() -> None:
     """Run the zen MCP server over stdio.
 
+    Uses stdout for the MCP protocol; I/O flags do not apply.
+    Skips the startup upgrade check.
+
     Tools: api, plus get/list for org, activity, entitlement, group, provider,
     sag, network, credential, deployment, notification, pool, vm, and task.
     """

{zen_cli-0.1.6 → zen_cli-0.1.7}/src/zen_cli/cmds/network/list.py

@@ -3,15 +3,9 @@ from typing import Any
 import click
 
 import zen_cli.sglib.cli_options as cli
-from zen_cli.ctxp import recent, util
+from zen_cli.ctxp import recent
 from zen_cli.service.cockpit import network
-
-
-def _format_network_table(data: Any) -> Any:
-    for d in data:
-        if not d.get("name"):
-            d["name"] = d.get("description") or d.get("region") or ""
-    return util.default_table_formatter(data, {"region": "Region"})
+from zen_cli.support.network import format_network_table
 
 
 @click.command(name="list")
@@ -19,7 +13,7 @@ def _format_network_table(data: Any) -> Any:
 @cli.search
 @cli.sort
 @cli.limit
-@cli.formatter(_format_network_table)
+@cli.formatter(format_network_table)
 def list_networks(org: str, **kwargs: Any) -> Any:
     """List network infrastructure deployments."""
     ret = network.list(org_id=cli.get_org_id(org), **kwargs)

{zen_cli-0.1.6 → zen_cli-0.1.7}/src/zen_cli/cmds/notification/list.py

@@ -3,27 +3,9 @@ from typing import Any
 import click
 
 import zen_cli.sglib.cli_options as cli
-from zen_cli.ctxp import recent, util
+from zen_cli.ctxp import recent
 from zen_cli.service import notification
-
-
-def _format_notification_table(data: Any) -> Any:
-    for d in data:
-        if not d.get("name"):
-            d["name"] = d.get("title") or d.get("code") or ""
-        if d.get("sentAt") and not d.get("createdAt"):
-            d["createdAt"] = d["sentAt"]
-        if d.get("lastOccurrenceAt") and not d.get("updatedAt"):
-            d["updatedAt"] = d["lastOccurrenceAt"]
-    return util.default_table_formatter(
-        data,
-        {
-            "code": "Code",
-            "serviceName": "Service",
-            "resourceName": "Resource",
-            "acknowledgedBy": "Ack By",
-        },
-    )
+from zen_cli.support.notification import format_notification_table
 
 
 @click.command(name="list")
@@ -41,7 +23,7 @@ def _format_notification_table(data: Any) -> Any:
 )
 @cli.sort
 @cli.limit
-@cli.formatter(_format_notification_table)
+@cli.formatter(format_notification_table)
 def list_notifications(
     org: str,
     service_name: str,

zen_cli-0.1.7/src/zen_cli/cmds/org/list.py

@@ -0,0 +1,20 @@
+from typing import Any
+
+import click
+
+import zen_cli.sglib.cli_options as cli
+from zen_cli.ctxp import recent
+from zen_cli.service import org
+from zen_cli.support.org import format_org_table
+
+
+@click.command(name="list")
+@cli.search
+@cli.sort
+@cli.limit
+@cli.formatter(format_org_table)
+def list_orgs(**kwargs: Any) -> Any:
+    """List org details"""
+    ret = org.list(**kwargs)
+    recent.helper.default_list(ret, "org", field_name="orgId")
+    return ret

zen_cli-0.1.7/src/zen_cli/cmds/pool/list.py

@@ -0,0 +1,36 @@
+from typing import Any
+
+import click
+
+import zen_cli.sglib.cli_options as cli
+from zen_cli.ctxp import recent
+from zen_cli.service.cockpit import pool
+from zen_cli.support.pool import format_pool_table
+
+
+@click.command(name="list")
+@cli.org_id
+@cli.search
+@cli.sort
+@cli.limit
+@click.option("--brokerable-only", type=bool, required=False, default=False)
+@click.option("--expanded", type=bool, required=False, default=False)
+@click.option(
+    "--reported-search",
+    type=str,
+    required=False,
+    help="Search expression for selection of pool reported properties",
+)
+@cli.formatter(format_pool_table)
+def list_pools(org: str, **kwargs: Any) -> Any:
+    """List pools"""
+
+    org_id = cli.get_org_id(org)
+
+    if "search" in kwargs:
+        kwargs["pool_search"] = kwargs["search"]
+        del kwargs["search"]
+
+    ret = pool.list(org_id=org_id, **kwargs)
+    recent.helper.default_list(ret, "pool")
+    return ret

{zen_cli-0.1.6 → zen_cli-0.1.7}/src/zen_cli/cmds/task/delete.py

@@ -25,7 +25,10 @@ def delete(
     confirm: bool,
     **kwargs: Any,
 ) -> Any:
-    """Delete a task."""
+    """Delete a task.
+
+    Not implemented. Prints TODO on stderr and exits 1.
+    """
     namespace, group, key = parse_task_param(namespace, group, smart_path)
     org_id = cli.get_org_id(org)
     ret = task.get(org_id, namespace, group, key, **kwargs)
@@ -38,5 +41,4 @@ def delete(
     # with contextlib.suppress(Exception):
     #     task.cancel(org_id, namespace, group, key)
     # return task.delete(org_id, namespace, group, key, execution_id, exclusive_id)
-    click.echo("Task delete is not implemented on the service side yet.", err=True)
-    return "", 1
+    return "TODO", 1

zen_cli-0.1.7/src/zen_cli/cmds/task/duplicate.py

@@ -0,0 +1,29 @@
+from typing import Any
+
+import click
+
+import zen_cli.sglib.cli_options as cli
+from zen_cli.support.task import duplicate_task
+
+
+@click.command()
+@cli.org_id
+@click.option("--namespace", "-n", type=str, required=False)
+@click.option("--group", "-g", type=str, required=False)
+@click.option(
+    "--reference",
+    "-r",
+    type=str,
+    required=True,
+    help="Reference task to copy parameters from, format: [[<namespace>/]<group>/]<key>.",
+)
+@click.option(
+    "--at",
+    type=str,
+    required=False,
+    help="Schedule time, exact time 'YYYY-MM-DD HH:MM:SS', or delta time '1h30m', default is now.",
+)
+@click.argument("smart_path", type=str, required=False)
+def duplicate(org: str, namespace: str, group: str, smart_path: str, at: str, reference: str, **kwargs: Any) -> Any:
+    """Duplicate an existing task to run once, immediately or at a specific time."""
+    return duplicate_task(cli.get_org_id(org), namespace, group, smart_path, at, reference, **kwargs)

{zen_cli-0.1.6 → zen_cli-0.1.7}/src/zen_cli/cmds/task/list.py

@@ -48,7 +48,7 @@ _TIME_RANGE = "Time range, one side optional. E.g. '2026-01-01,'"
 @click.option("--time-scheduled", type=str, required=False, help=_TIME_RANGE)
 @click.option("--time-started", type=str, required=False, help=_TIME_RANGE)
 @click.option("--time-completed", type=str, required=False, help=_TIME_RANGE)
-@cli.limit(default=10)
+@cli.limit
 @cli.search
 @cli.formatter(format_task_table)
 def list_tasks(

{zen_cli-0.1.6 → zen_cli-0.1.7}/src/zen_cli/cmds/task/log.py

@@ -27,7 +27,7 @@ from zen_cli.support.task import (
     ),
 )
 @cli.search
-@cli.limit(default=10)
+@cli.limit
 @cli.formatter(format_tasklog_table)
 def log(
     org: str, namespace: str, group: str, smart_path: str, last: bool, state: str, search: str, **kwargs: Any

{zen_cli-0.1.6 → zen_cli-0.1.7}/src/zen_cli/cmds/upgrade.py

@@ -6,7 +6,10 @@ import click
 
 @click.command()
 def upgrade() -> None:
-    """Upgrade zen-cli."""
+    """Upgrade zen-cli.
+
+    Runs pip and writes its output to the terminal. Skips the startup upgrade check.
+    """
     cmd = "pip install -U zen-cli --upgrade-strategy eager --no-cache-dir"
     p = subprocess.run(cmd, stdout=sys.stdout, stderr=sys.stderr, text=False, shell=True, check=False)
     if p.returncode: