humancli 0.2.0__tar.gz → 0.4.0__tar.gz

{humancli-0.2.0 → humancli-0.4.0}/.agents/skills/release/SKILL.md

@@ -7,7 +7,7 @@ description: Prepare and ship an agentcli release. Use when asked to cut a relea
 
 ## Overview
 
-Prepare a tagged release that matches the GitHub Actions release workflow. The workflow requires the tag version to match both `pyproject.toml` and `src/agentcli/__init__.py`.
+Prepare a tagged release that matches the GitHub Actions release workflow. The workflow requires the tag version to match both `pyproject.toml` and `src/humancli/__init__.py`.
 
 ## Workflow
 
@@ -21,7 +21,7 @@ If the current version has a `.dev` suffix, assume the target release version is
 Update version strings to match the release tag:
 
 - `pyproject.toml`: `project.version = "<major.minor.patch>"`
-- `src/agentcli/__init__.py`: `__version__ = "<major.minor.patch>"`
+- `src/humancli/__init__.py`: `__version__ = "<major.minor.patch>"`
 - `uv.lock`: refresh so the root package version matches (run `uv lock` or `uv sync`).
 
 ### 3) Run checks
@@ -45,4 +45,4 @@ If you keep a dev version between releases, bump the minor version (reset patch
 
 ## Notes
 
-- The release workflow checks that the tag matches `pyproject.toml` and `src/agentcli/__init__.py`.
+- The release workflow checks that the tag matches `pyproject.toml` and `src/humancli/__init__.py`.

{humancli-0.2.0 → humancli-0.4.0}/.github/workflows/release.yml

@@ -36,7 +36,7 @@ jobs:
           project_version = pyproject['project']['version']
 
           init_version = None
-          init_path = Path('src') / 'agentcli' / '__init__.py'
+          init_path = Path('src') / 'humancli' / '__init__.py'
           if init_path.is_file():
             m = re.search(r'__version__\s*=\s*"([^"]+)"', init_path.read_text(encoding='utf-8'))
             if m:
@@ -46,7 +46,7 @@ jobs:
             raise SystemExit(f"Tag {tag!r} does not match pyproject version {project_version!r}")
           if init_version and init_version != project_version:
             raise SystemExit(
-              f"src/agentcli/__init__.py __version__ {init_version!r} does not match pyproject version {project_version!r}"
+              f"src/humancli/__init__.py __version__ {init_version!r} does not match pyproject version {project_version!r}"
             )
 
           print(f"OK: tag {tag!r} matches version {project_version!r}")

{humancli-0.2.0 → humancli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: humancli
-Version: 0.2.0
+Version: 0.4.0
 Summary: Python CLIs for agents and humans
 Project-URL: Repository, https://github.com/elyase/agentcli
 Project-URL: Issues, https://github.com/elyase/agentcli/issues
@@ -47,10 +47,10 @@ agentcli builds command-line interfaces that produce structured, parseable outpu
 pip install humancli
 ```
 
-The package installs as `humancli` on PyPI but you import it as `agentcli`:
+The package installs as `humancli` on PyPI and you import it as `humancli`:
 
 ```python
-from agentcli import App
+from humancli import App
 ```
 
 ## Quick start
@@ -58,7 +58,7 @@ from agentcli import App
 ### Single function
 
 ```python
-from agentcli import run
+from humancli import run
 
 def greet(name: str):
     """Greet someone."""
@@ -84,7 +84,7 @@ $ greet --llms
 ### Multi-command app
 
 ```python
-from agentcli import App
+from humancli import App
 
 app = App("my-cli", version="1.0.0")
 
@@ -107,7 +107,7 @@ Parameters before `*` are positional arguments. Parameters after `*` are named o
 
 ```python
 from typing import Annotated, Literal
-from agentcli import App, Param
+from humancli import App, Param
 
 app = App("deploy-cli")
 
@@ -156,12 +156,12 @@ def fetch_cases(*, limit: int = 20):
 
 ## Agent discovery
 
-Every agentcli app gets built-in flags for agent consumption:
+Every humancli app gets built-in flags for agent consumption:
 
 - `--llms` — markdown command index
 - `--llms-full` — full JSON schema of all commands
 - `--json` / `--yaml` / `--jsonl` — structured output formats
-- `--mcp` — start as an MCP server (requires `agentcli[mcp]`)
+- `--mcp` — start as an MCP server (requires `humancli[mcp]`)
 
 ## Optional extras
 

{humancli-0.2.0 → humancli-0.4.0}/README.md

@@ -10,10 +10,10 @@ agentcli builds command-line interfaces that produce structured, parseable outpu
 pip install humancli
 ```
 
-The package installs as `humancli` on PyPI but you import it as `agentcli`:
+The package installs as `humancli` on PyPI and you import it as `humancli`:
 
 ```python
-from agentcli import App
+from humancli import App
 ```
 
 ## Quick start
@@ -21,7 +21,7 @@ from agentcli import App
 ### Single function
 
 ```python
-from agentcli import run
+from humancli import run
 
 def greet(name: str):
     """Greet someone."""
@@ -47,7 +47,7 @@ $ greet --llms
 ### Multi-command app
 
 ```python
-from agentcli import App
+from humancli import App
 
 app = App("my-cli", version="1.0.0")
 
@@ -70,7 +70,7 @@ Parameters before `*` are positional arguments. Parameters after `*` are named o
 
 ```python
 from typing import Annotated, Literal
-from agentcli import App, Param
+from humancli import App, Param
 
 app = App("deploy-cli")
 
@@ -119,12 +119,12 @@ def fetch_cases(*, limit: int = 20):
 
 ## Agent discovery
 
-Every agentcli app gets built-in flags for agent consumption:
+Every humancli app gets built-in flags for agent consumption:
 
 - `--llms` — markdown command index
 - `--llms-full` — full JSON schema of all commands
 - `--json` / `--yaml` / `--jsonl` — structured output formats
-- `--mcp` — start as an MCP server (requires `agentcli[mcp]`)
+- `--mcp` — start as an MCP server (requires `humancli[mcp]`)
 
 ## Optional extras
 

{humancli-0.2.0 → humancli-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "humancli"
-version = "0.2.0"
+version = "0.4.0"
 description = "Python CLIs for agents and humans"
 readme = "README.md"
 license = "MIT"
@@ -44,7 +44,7 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [tool.hatch.build.targets.wheel]
-packages = ["src/agentcli"]
+packages = ["src/humancli"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]

{humancli-0.2.0/src/agentcli → humancli-0.4.0/src/humancli}/__init__.py

@@ -1,11 +1,11 @@
-"""agentcli: Python CLIs for agents and humans."""
+"""humancli: Python CLIs for agents and humans."""
 
 from ._app import App, run
 from ._context import Context
 from ._errors import AgentCliError, ConfigError, ParseError, ValidationError
 from ._types import Param, Result
 
-__version__ = "0.2.0"
+__version__ = "0.4.0"
 
 __all__ = [
     "AgentCliError",

{humancli-0.2.0/src/agentcli → humancli-0.4.0/src/humancli}/_errors.py

@@ -31,13 +31,13 @@ class AgentCliError(Exception):
         self.exit_code = exit_code
 
     def to_error_info(self) -> ErrorInfo:
-        from ._output import ErrorInfo
+        from ._output import ErrorInfo, _make_cta
 
         return ErrorInfo(
             code=self.code,
             message=self.message,
             retryable=self.retryable,
-            suggested_commands=self.cta,
+            cta=_make_cta(self.cta, description="To fix this:"),
         )
 
 

{humancli-0.2.0/src/agentcli → humancli-0.4.0/src/humancli}/_output.py

@@ -2,24 +2,30 @@ from __future__ import annotations
 
 import dataclasses
 import json
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 from typing import Any
 
 from ._errors import AgentCliError
 
 
+@dataclass(frozen=True)
+class CtaBlock:
+    description: str = "Suggested commands:"
+    commands: list[str] = field(default_factory=list)
+
+
 @dataclass(frozen=True)
 class ErrorInfo:
     code: str
     message: str
     retryable: bool = False
-    suggested_commands: list[str] | None = None
+    cta: CtaBlock | None = None
 
 
 @dataclass
 class Meta:
     command: str
-    suggested_commands: list[str] | None = None
+    cta: CtaBlock | None = None
     duration_ms: float | None = None
     streamed: bool = False
 
@@ -32,32 +38,35 @@ class Envelope:
     meta: Meta | None = None
 
 
+def _make_cta(
+    commands: list[str] | None, description: str = "Suggested commands:"
+) -> CtaBlock | None:
+    if not commands:
+        return None
+    return CtaBlock(description=description, commands=commands)
+
+
 def make_success_envelope(
     data: Any,
     *,
     command: str,
     cta: list[str] | None = None,
 ) -> Envelope:
-    return Envelope(
-        ok=True, data=data, meta=Meta(command=command, suggested_commands=cta)
-    )
+    return Envelope(ok=True, data=data, meta=Meta(command=command, cta=_make_cta(cta)))
 
 
 def make_error_envelope(error: Exception, *, command: str) -> Envelope:
     if isinstance(error, AgentCliError):
+        cta_block = _make_cta(error.cta, description="To fix this:")
         info = ErrorInfo(
             code=error.code,
             message=error.message,
             retryable=error.retryable,
-            suggested_commands=error.cta,
+            cta=cta_block,
         )
     else:
         info = ErrorInfo(code="UNKNOWN", message=str(error), retryable=False)
-    return Envelope(
-        ok=False,
-        error=info,
-        meta=Meta(command=command, suggested_commands=info.suggested_commands),
-    )
+    return Envelope(ok=False, error=info, meta=Meta(command=command, cta=info.cta))
 
 
 def make_envelope(
@@ -77,7 +86,7 @@ def make_envelope(
             data=data,
             meta=Meta(
                 command=command,
-                suggested_commands=cta,
+                cta=_make_cta(cta),
                 duration_ms=duration_ms,
                 streamed=streamed,
             ),
@@ -87,7 +96,7 @@ def make_envelope(
         error=error,
         meta=Meta(
             command=command,
-            suggested_commands=cta,
+            cta=_make_cta(cta),
             duration_ms=duration_ms,
             streamed=streamed,
         ),

humancli-0.2.0/tests/test_agentcli.py → humancli-0.4.0/tests/test_humancli.py

@@ -3,8 +3,8 @@ from __future__ import annotations
 import unittest
 from typing import Annotated, Literal
 
-from agentcli import App, Context, Param, Result
-from agentcli.testing import CliRunner
+from humancli import App, Context, Param, Result
+from humancli.testing import CliRunner
 
 
 class AgentCliTests(unittest.TestCase):

{humancli-0.2.0 → humancli-0.4.0}/uv.lock

@@ -249,7 +249,7 @@ wheels = [
 
 [[package]]
 name = "humancli"
-version = "0.2.0"
+version = "0.4.0"
 source = { editable = "." }
 dependencies = [
     { name = "docstring-parser" },