apcore-cli 0.2.0__tar.gz → 0.2.2__tar.gz

{apcore_cli-0.2.0 → apcore_cli-0.2.2}/CHANGELOG.md

@@ -5,6 +5,30 @@ All notable changes to apcore-cli (Python SDK) will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.2] - 2026-03-22
+
+### Changed
+- Rebrand: aipartnerup → aiperceivable
+
+## [0.2.1] - 2026-03-19
+
+### Changed
+- Help text truncation limit increased from 200 to 1000 characters (configurable via `cli.help_text_max_length` config key)
+- `_extract_help`: added `max_length: int = 1000` parameter (`schema_parser.py`)
+- `schema_to_click_options`: added `max_help_length: int = 1000` parameter (`schema_parser.py`)
+- `build_module_command`: added `help_text_max_length: int = 1000` parameter, threaded through to schema parser (`cli.py`)
+- `LazyModuleGroup`: constructor accepts `help_text_max_length: int = 1000`, passes to `build_module_command` (`cli.py`)
+- `create_cli`: resolves `cli.help_text_max_length` from `ConfigResolver` and passes to `LazyModuleGroup` (`__main__.py`)
+- `format_exec_result`: nested dict/list values in table mode now rendered with `json.dumps` instead of `str()` (`output.py`)
+
+### Added
+- `cli.help_text_max_length` config key (default: 1000) in `ConfigResolver.DEFAULTS` (`config.py`)
+- `APCORE_CLI_HELP_TEXT_MAX_LENGTH` environment variable support for configuring help text max length
+- `test_help_truncation_default`: tests default 1000-char truncation
+- `test_help_no_truncation_within_limit`: tests no truncation at 999 chars
+- `test_help_truncation_custom_max`: tests custom max_length parameter
+- 263 tests (up from 261)
+
 ## [0.2.0] - 2026-03-16
 
 ### Added

apcore_cli-0.2.2/CLAUDE.md

@@ -0,0 +1,30 @@
+# CLAUDE.md — apcore-cli-python
+
+## Build & Test
+
+- `pytest` — run all tests. **Must pass before considering any task complete.**
+- `pytest --cov` — run with coverage report.
+- `ruff check .` — lint check.
+- `ruff format .` — format all code. **Run after every code change.**
+
+## Code Style
+
+- Python 3.11+ with `from __future__ import annotations`.
+- All code must pass `ruff check` and `ruff format --check`.
+- Type annotations on all public function signatures.
+- Use `click.echo()` for user-facing output, `logger.*` for debug/diagnostic output.
+- Prefer `sys.exit(code)` with exit code constants over raising exceptions for CLI errors.
+
+## Project Conventions
+
+- Spec repo (single source of truth): `../apcore-cli/docs/`
+- Package structure: `src/apcore_cli/` with `__init__.py` exporting `__version__` only.
+- Entry point: `apcore_cli.__main__:main`.
+- Security modules live in `src/apcore_cli/security/` sub-package.
+- ConfigResolver.DEFAULTS values are Python-typed (str, int, bool).
+- Tests organized by module: `tests/test_<module>.py`, security tests in `tests/test_security/`.
+
+## Environment
+
+- Python >= 3.11
+- Key dependencies: click >= 8.0, rich >= 13.0, jsonschema >= 4.0, pyyaml >= 6.0

{apcore_cli-0.2.0 → apcore_cli-0.2.2}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: apcore-cli
-Version: 0.2.0
+Version: 0.2.2
 Summary: Terminal adapter for apcore — execute AI-Perceivable modules from the command line
-Project-URL: Homepage, https://aipartnerup.com
-Project-URL: Repository, https://github.com/aipartnerup/apcore-cli-python
-Project-URL: Documentation, https://github.com/aipartnerup/apcore-cli-python#readme
-Project-URL: Issues, https://github.com/aipartnerup/apcore-cli-python/issues
-Author-email: aipartnerup <team@aipartnerup.com>
+Project-URL: Homepage, https://aiperceivable.com
+Project-URL: Repository, https://github.com/aiperceivable/apcore-cli-python
+Project-URL: Documentation, https://github.com/aiperceivable/apcore-cli-python#readme
+Project-URL: Issues, https://github.com/aiperceivable/apcore-cli-python/issues
+Author-email: aiperceivable <team@aiperceivable.com>
 License-Expression: Apache-2.0
 Keywords: agent,ai,apcore,automation,cli,command-line,llm,shell,terminal,unix
 Classifier: Development Status :: 3 - Alpha
@@ -20,7 +20,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.11
-Requires-Dist: apcore>=0.13.0
+Requires-Dist: apcore>=0.13.1
 Requires-Dist: click>=8.1
 Requires-Dist: cryptography>=41.0
 Requires-Dist: jsonschema>=4.20
@@ -36,7 +36,7 @@ Requires-Dist: ruff>=0.1; extra == 'dev'
 Description-Content-Type: text/markdown
 
 <div align="center">
-  <img src="https://raw.githubusercontent.com/aipartnerup/apcore-cli/main/apcore-cli-logo.svg" alt="apcore-cli logo" width="200"/>
+  <img src="https://raw.githubusercontent.com/aiperceivable/apcore-cli/main/apcore-cli-logo.svg" alt="apcore-cli logo" width="200"/>
 </div>
 
 # apcore-cli
@@ -45,15 +45,15 @@ Terminal adapter for apcore. Execute AI-Perceivable modules from the command lin
 
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
 [![Python](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://python.org)
-[![Tests](https://img.shields.io/badge/tests-261%20passed-brightgreen.svg)]()
+[![Tests](https://img.shields.io/badge/tests-263%20passed-brightgreen.svg)]()
 
 | | |
 |---|---|
-| **Python SDK** | [github.com/aipartnerup/apcore-cli-python](https://github.com/aipartnerup/apcore-cli-python) |
-| **Spec repo** | [github.com/aipartnerup/apcore-cli](https://github.com/aipartnerup/apcore-cli) |
-| **apcore core** | [github.com/aipartnerup/apcore](https://github.com/aipartnerup/apcore) |
+| **Python SDK** | [github.com/aiperceivable/apcore-cli-python](https://github.com/aiperceivable/apcore-cli-python) |
+| **Spec repo** | [github.com/aiperceivable/apcore-cli](https://github.com/aiperceivable/apcore-cli) |
+| **apcore core** | [github.com/aiperceivable/apcore](https://github.com/aiperceivable/apcore) |
 
-**apcore-cli** turns any [apcore](https://github.com/aipartnerup/apcore)-based project into a fully featured CLI tool — with **zero code changes** to your existing modules.
+**apcore-cli** turns any [apcore](https://github.com/aiperceivable/apcore)-based project into a fully featured CLI tool — with **zero code changes** to your existing modules.
 
 ```
 ┌──────────────────┐
@@ -94,7 +94,7 @@ Requires Python 3.11+ and `apcore >= 0.13.0`.
 The repo includes 8 example modules you can run immediately:
 
 ```bash
-git clone https://github.com/aipartnerup/apcore-cli-python.git
+git clone https://github.com/aiperceivable/apcore-cli-python.git
 cd apcore-cli-python
 pip install -e ".[dev]"
 
@@ -268,6 +268,7 @@ apcore-cli uses a 4-tier configuration precedence:
 | `APCORE_LOGGING_LEVEL` | Global apcore log level (fallback when `APCORE_CLI_LOGGING_LEVEL` is unset) | `WARNING` |
 | `APCORE_AUTH_API_KEY` | API key for remote registry authentication | *(unset)* |
 | `APCORE_CLI_SANDBOX` | Set to `1` to enable subprocess sandboxing | *(unset)* |
+| `APCORE_CLI_HELP_TEXT_MAX_LENGTH` | Maximum characters for CLI option help text before truncation | `1000` |
 
 ### Config File (`apcore.yaml`)
 
@@ -278,6 +279,8 @@ logging:
   level: DEBUG
 sandbox:
   enabled: false
+cli:
+  help_text_max_length: 1000
 ```
 
 ## Features
@@ -317,10 +320,10 @@ apcore-cli (the adapter)
     |
     +-- ConfigResolver       4-tier config precedence
     +-- LazyModuleGroup      Dynamic Click command generation
-    +-- SchemaParser         JSON Schema -> Click options
-    +-- RefResolver          $ref / allOf / anyOf / oneOf
-    +-- ApprovalGate         TTY-aware HITL approval
-    +-- OutputFormatter      TTY-adaptive JSON/table output
+    +-- schema_parser        JSON Schema -> Click options
+    +-- ref_resolver         $ref / allOf / anyOf / oneOf
+    +-- approval             TTY-aware HITL approval
+    +-- output               TTY-adaptive JSON/table output
     +-- AuditLogger          JSON Lines execution logging
     +-- Sandbox              Subprocess isolation
     |
@@ -412,49 +415,14 @@ apcore-cli --extensions-dir ./extensions greet.hello --name Alice --greeting Hi
 ## Development
 
 ```bash
-git clone https://github.com/aipartnerup/apcore-cli-python.git
+git clone https://github.com/aiperceivable/apcore-cli-python.git
 cd apcore-cli-python
 pip install -e ".[dev]"
-pytest                           # 261 tests
+pytest                           # 263 tests
 pytest --cov                     # with coverage report
 bash examples/run_examples.sh   # run all examples
 ```
 
-### Project Structure
-
-```
-src/apcore_cli/
-├── __init__.py              # Package version
-├── __main__.py              # CLI entry point, wiring
-├── cli.py                   # LazyModuleGroup, build_module_command, collect_input
-├── config.py                # ConfigResolver (4-tier precedence)
-├── schema_parser.py         # JSON Schema -> Click options
-├── ref_resolver.py          # $ref / allOf / anyOf / oneOf resolution
-├── output.py                # TTY-adaptive output formatting (rich)
-├── discovery.py             # list / describe commands
-├── approval.py              # HITL approval gate with timeout
-├── shell.py                 # bash/zsh/fish completion + man pages
-├── _sandbox_runner.py       # Subprocess entry point for sandboxed execution
-└── security/
-    ├── __init__.py           # Exports
-    ├── auth.py               # API key authentication
-    ├── config_encryptor.py   # Keyring + AES-256-GCM encrypted config
-    ├── audit.py              # JSON Lines audit logging
-    └── sandbox.py            # Subprocess-based execution isolation
-
-examples/
-├── run_examples.sh          # Run all examples end-to-end
-└── extensions/
-    ├── math/                # math.add, math.multiply
-    ├── text/                # text.upper, text.reverse, text.wordcount
-    └── sysutil/             # sysutil.info, sysutil.env, sysutil.disk
-
-planning/                    # Implementation plans (TDD task breakdowns)
-├── overview.md
-├── state.json
-└── *.md                     # Per-feature plans
-```
-
 ## License
 
 Apache-2.0

{apcore_cli-0.2.0 → apcore_cli-0.2.2}/README.md

@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="https://raw.githubusercontent.com/aipartnerup/apcore-cli/main/apcore-cli-logo.svg" alt="apcore-cli logo" width="200"/>
+  <img src="https://raw.githubusercontent.com/aiperceivable/apcore-cli/main/apcore-cli-logo.svg" alt="apcore-cli logo" width="200"/>
 </div>
 
 # apcore-cli
@@ -8,15 +8,15 @@ Terminal adapter for apcore. Execute AI-Perceivable modules from the command lin
 
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
 [![Python](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://python.org)
-[![Tests](https://img.shields.io/badge/tests-261%20passed-brightgreen.svg)]()
+[![Tests](https://img.shields.io/badge/tests-263%20passed-brightgreen.svg)]()
 
 | | |
 |---|---|
-| **Python SDK** | [github.com/aipartnerup/apcore-cli-python](https://github.com/aipartnerup/apcore-cli-python) |
-| **Spec repo** | [github.com/aipartnerup/apcore-cli](https://github.com/aipartnerup/apcore-cli) |
-| **apcore core** | [github.com/aipartnerup/apcore](https://github.com/aipartnerup/apcore) |
+| **Python SDK** | [github.com/aiperceivable/apcore-cli-python](https://github.com/aiperceivable/apcore-cli-python) |
+| **Spec repo** | [github.com/aiperceivable/apcore-cli](https://github.com/aiperceivable/apcore-cli) |
+| **apcore core** | [github.com/aiperceivable/apcore](https://github.com/aiperceivable/apcore) |
 
-**apcore-cli** turns any [apcore](https://github.com/aipartnerup/apcore)-based project into a fully featured CLI tool — with **zero code changes** to your existing modules.
+**apcore-cli** turns any [apcore](https://github.com/aiperceivable/apcore)-based project into a fully featured CLI tool — with **zero code changes** to your existing modules.
 
 ```
 ┌──────────────────┐
@@ -57,7 +57,7 @@ Requires Python 3.11+ and `apcore >= 0.13.0`.
 The repo includes 8 example modules you can run immediately:
 
 ```bash
-git clone https://github.com/aipartnerup/apcore-cli-python.git
+git clone https://github.com/aiperceivable/apcore-cli-python.git
 cd apcore-cli-python
 pip install -e ".[dev]"
 
@@ -231,6 +231,7 @@ apcore-cli uses a 4-tier configuration precedence:
 | `APCORE_LOGGING_LEVEL` | Global apcore log level (fallback when `APCORE_CLI_LOGGING_LEVEL` is unset) | `WARNING` |
 | `APCORE_AUTH_API_KEY` | API key for remote registry authentication | *(unset)* |
 | `APCORE_CLI_SANDBOX` | Set to `1` to enable subprocess sandboxing | *(unset)* |
+| `APCORE_CLI_HELP_TEXT_MAX_LENGTH` | Maximum characters for CLI option help text before truncation | `1000` |
 
 ### Config File (`apcore.yaml`)
 
@@ -241,6 +242,8 @@ logging:
   level: DEBUG
 sandbox:
   enabled: false
+cli:
+  help_text_max_length: 1000
 ```
 
 ## Features
@@ -280,10 +283,10 @@ apcore-cli (the adapter)
     |
     +-- ConfigResolver       4-tier config precedence
     +-- LazyModuleGroup      Dynamic Click command generation
-    +-- SchemaParser         JSON Schema -> Click options
-    +-- RefResolver          $ref / allOf / anyOf / oneOf
-    +-- ApprovalGate         TTY-aware HITL approval
-    +-- OutputFormatter      TTY-adaptive JSON/table output
+    +-- schema_parser        JSON Schema -> Click options
+    +-- ref_resolver         $ref / allOf / anyOf / oneOf
+    +-- approval             TTY-aware HITL approval
+    +-- output               TTY-adaptive JSON/table output
     +-- AuditLogger          JSON Lines execution logging
     +-- Sandbox              Subprocess isolation
     |
@@ -375,49 +378,14 @@ apcore-cli --extensions-dir ./extensions greet.hello --name Alice --greeting Hi
 ## Development
 
 ```bash
-git clone https://github.com/aipartnerup/apcore-cli-python.git
+git clone https://github.com/aiperceivable/apcore-cli-python.git
 cd apcore-cli-python
 pip install -e ".[dev]"
-pytest                           # 261 tests
+pytest                           # 263 tests
 pytest --cov                     # with coverage report
 bash examples/run_examples.sh   # run all examples
 ```
 
-### Project Structure
-
-```
-src/apcore_cli/
-├── __init__.py              # Package version
-├── __main__.py              # CLI entry point, wiring
-├── cli.py                   # LazyModuleGroup, build_module_command, collect_input
-├── config.py                # ConfigResolver (4-tier precedence)
-├── schema_parser.py         # JSON Schema -> Click options
-├── ref_resolver.py          # $ref / allOf / anyOf / oneOf resolution
-├── output.py                # TTY-adaptive output formatting (rich)
-├── discovery.py             # list / describe commands
-├── approval.py              # HITL approval gate with timeout
-├── shell.py                 # bash/zsh/fish completion + man pages
-├── _sandbox_runner.py       # Subprocess entry point for sandboxed execution
-└── security/
-    ├── __init__.py           # Exports
-    ├── auth.py               # API key authentication
-    ├── config_encryptor.py   # Keyring + AES-256-GCM encrypted config
-    ├── audit.py              # JSON Lines audit logging
-    └── sandbox.py            # Subprocess-based execution isolation
-
-examples/
-├── run_examples.sh          # Run all examples end-to-end
-└── extensions/
-    ├── math/                # math.add, math.multiply
-    ├── text/                # text.upper, text.reverse, text.wordcount
-    └── sysutil/             # sysutil.info, sysutil.env, sysutil.disk
-
-planning/                    # Implementation plans (TDD task breakdowns)
-├── overview.md
-├── state.json
-└── *.md                     # Per-feature plans
-```
-
 ## License
 
 Apache-2.0

{apcore_cli-0.2.0 → apcore_cli-0.2.2}/planning/schema-parser.md

@@ -83,7 +83,7 @@
 - `tests/test_schema_parser.py`:
   - `test_help_from_x_llm_description`: `x-llm-description` present → used over `description`.
   - `test_help_from_description`: Only `description` → used.
-  - `test_help_truncation`: Description > 200 chars → truncated to 197 + "...".
+  - `test_help_truncation_default`: Description > 1000 chars (default) → truncated to 997 + "...".
   - `test_help_none`: No description fields → `None`.
   - `test_flag_collision_detection`: Properties `foo_bar` and `foo-bar` both map to `--foo-bar` → exit 48.
 

{apcore_cli-0.2.0 → apcore_cli-0.2.2}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "hatchling.build"
 
 [project]
 name = "apcore-cli"
-version = "0.2.0"
+version = "0.2.2"
 description = "Terminal adapter for apcore — execute AI-Perceivable modules from the command line"
 readme = "README.md"
 license = "Apache-2.0"
 requires-python = ">=3.11"
 authors = [
-    { name = "aipartnerup", email = "team@aipartnerup.com" },
+    { name = "aiperceivable", email = "team@aiperceivable.com" },
 ]
 keywords = ["apcore", "cli", "terminal", "ai", "agent", "llm", "command-line", "automation", "shell", "unix"]
 classifiers = [
@@ -26,7 +26,7 @@ classifiers = [
     "Environment :: Console",
 ]
 dependencies = [
-    "apcore>=0.13.0",
+    "apcore>=0.13.1",
     "click>=8.1",
     "jsonschema>=4.20",
     "rich>=13.0",
@@ -48,10 +48,10 @@ dev = [
 apcore-cli = "apcore_cli.__main__:main"
 
 [project.urls]
-Homepage = "https://aipartnerup.com"
-Repository = "https://github.com/aipartnerup/apcore-cli-python"
-Documentation = "https://github.com/aipartnerup/apcore-cli-python#readme"
-Issues = "https://github.com/aipartnerup/apcore-cli-python/issues"
+Homepage = "https://aiperceivable.com"
+Repository = "https://github.com/aiperceivable/apcore-cli-python"
+Documentation = "https://github.com/aiperceivable/apcore-cli-python#readme"
+Issues = "https://github.com/aiperceivable/apcore-cli-python/issues"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/apcore_cli"]

{apcore_cli-0.2.0 → apcore_cli-0.2.2}/src/apcore_cli/__main__.py

@@ -65,16 +65,26 @@ def create_cli(extensions_dir: str | None = None, prog_name: str | None = None)
     apcore_level = _default_level if _default_level <= logging.INFO else logging.ERROR
     logging.getLogger("apcore").setLevel(apcore_level)
 
+    config = ConfigResolver()
+
     if extensions_dir is not None:
         ext_dir = extensions_dir
     else:
-        config = ConfigResolver()
         ext_dir = config.resolve(
             "extensions.root",
             cli_flag="--extensions-dir",
             env_var="APCORE_EXTENSIONS_ROOT",
         )
 
+    help_text_max_length = config.resolve(
+        "cli.help_text_max_length",
+        env_var="APCORE_CLI_HELP_TEXT_MAX_LENGTH",
+    )
+    try:
+        help_text_max_length = int(help_text_max_length)
+    except (TypeError, ValueError):
+        help_text_max_length = 1000
+
     ext_dir_missing = not os.path.exists(ext_dir)
     ext_dir_unreadable = not ext_dir_missing and not os.access(ext_dir, os.R_OK)
 
@@ -119,6 +129,7 @@ def create_cli(extensions_dir: str | None = None, prog_name: str | None = None)
         cls=LazyModuleGroup,
         registry=registry,
         executor=executor,
+        help_text_max_length=help_text_max_length,
         name=prog_name,
         help="CLI adapter for the apcore module ecosystem.",
     )

{apcore_cli-0.2.0 → apcore_cli-0.2.2}/src/apcore_cli/cli.py

@@ -41,10 +41,17 @@ def set_audit_logger(audit_logger: AuditLogger | None) -> None:
 class LazyModuleGroup(click.Group):
     """Custom Click Group that lazily loads apcore modules as subcommands."""
 
-    def __init__(self, registry: Registry, executor: Executor, **kwargs: Any) -> None:
+    def __init__(
+        self,
+        registry: Registry,
+        executor: Executor,
+        help_text_max_length: int = 1000,
+        **kwargs: Any,
+    ) -> None:
         super().__init__(**kwargs)
         self._registry = registry
         self._executor = executor
+        self._help_text_max_length = help_text_max_length
         self._module_cache: dict[str, click.Command] = {}
 
     def list_commands(self, ctx: click.Context) -> list[str]:
@@ -70,7 +77,7 @@ class LazyModuleGroup(click.Group):
         if module_def is None:
             return None
 
-        cmd = build_module_command(module_def, self._executor)
+        cmd = build_module_command(module_def, self._executor, help_text_max_length=self._help_text_max_length)
         self._module_cache[cmd_name] = cmd
         return cmd
 
@@ -101,7 +108,11 @@ def _get_module_id(module_def: ModuleDescriptor) -> str:
     return module_def.module_id
 
 
-def build_module_command(module_def: ModuleDescriptor, executor: Executor) -> click.Command:
+def build_module_command(
+    module_def: ModuleDescriptor,
+    executor: Executor,
+    help_text_max_length: int = 1000,
+) -> click.Command:
     """Build a Click command from an apcore module definition.
 
     Generates Click options from the module's input_schema, wires up
@@ -137,7 +148,7 @@ def build_module_command(module_def: ModuleDescriptor, executor: Executor) -> cl
     else:
         resolved_schema = input_schema
 
-    schema_options = schema_to_click_options(resolved_schema)
+    schema_options = schema_to_click_options(resolved_schema, max_help_length=help_text_max_length)
 
     def callback(**kwargs: Any) -> None:
         # Separate built-in options from schema-generated kwargs

{apcore_cli-0.2.0 → apcore_cli-0.2.2}/src/apcore_cli/config.py

@@ -18,10 +18,11 @@ class ConfigResolver:
 
     DEFAULTS: dict[str, Any] = {
         "extensions.root": "./extensions",
-        "logging.level": "INFO",
+        "logging.level": "WARNING",
         "sandbox.enabled": False,
         "cli.stdin_buffer_limit": 10_485_760,  # 10 MB
         "cli.auto_approve": False,
+        "cli.help_text_max_length": 1000,
     }
 
     def __init__(

{apcore_cli-0.2.0 → apcore_cli-0.2.2}/src/apcore_cli/schema_parser.py

@@ -50,19 +50,19 @@ def _map_type(prop_name: str, prop_schema: dict) -> Any:
     return result
 
 
-def _extract_help(prop_schema: dict) -> str | None:
+def _extract_help(prop_schema: dict, max_length: int = 1000) -> str | None:
     """Extract help text from schema property, preferring x-llm-description."""
     text = prop_schema.get("x-llm-description")
     if not text:
         text = prop_schema.get("description")
     if not text:
         return None
-    if len(text) > 200:
-        return text[:197] + "..."
+    if max_length > 0 and len(text) > max_length:
+        return text[: max_length - 3] + "..."
     return text
 
 
-def schema_to_click_options(schema: dict) -> list[click.Option]:
+def schema_to_click_options(schema: dict, max_help_length: int = 1000) -> list[click.Option]:
     """Convert JSON Schema properties to a list of Click options."""
     properties = schema.get("properties", {})
     required_list = schema.get("required", [])
@@ -93,7 +93,7 @@ def schema_to_click_options(schema: dict) -> list[click.Option]:
 
         click_type = _map_type(prop_name, prop_schema)
         is_required = prop_name in required_list
-        _help_base = _extract_help(prop_schema)
+        _help_base = _extract_help(prop_schema, max_length=max_help_length)
         # Append [required] to help text for user clarity; do NOT set required=True
         # at the Click level because that would block --input - (STDIN) from working.
         # Schema-level required validation happens in the callback via jsonschema.validate().

{apcore_cli-0.2.0 → apcore_cli-0.2.2}/tests/test_config.py

@@ -26,6 +26,7 @@ class TestConfigResolverSkeleton:
             "logging.level",
             "sandbox.enabled",
             "cli.stdin_buffer_limit",
+            "cli.help_text_max_length",
         ]
         for key in expected_keys:
             assert key in resolver.DEFAULTS, f"Missing default key: {key}"

{apcore_cli-0.2.0 → apcore_cli-0.2.2}/tests/test_schema_parser.py

@@ -205,9 +205,20 @@ class TestHelpAndCollisions:
         result = _extract_help({"description": "Regular help"})
         assert result == "Regular help"
 
-    def test_help_truncation(self):
-        long_text = "x" * 250
+    def test_help_truncation_default(self):
+        long_text = "x" * 1100
         result = _extract_help({"description": long_text})
+        assert len(result) == 1000
+        assert result.endswith("...")
+
+    def test_help_no_truncation_within_limit(self):
+        text = "x" * 999
+        result = _extract_help({"description": text})
+        assert result == text
+
+    def test_help_truncation_custom_max(self):
+        long_text = "x" * 300
+        result = _extract_help({"description": long_text}, max_length=200)
         assert len(result) == 200
         assert result.endswith("...")