apcore-cli 0.1.0__tar.gz → 0.2.1__tar.gz

apcore_cli-0.2.1/CHANGELOG.md

@@ -0,0 +1,92 @@
+# Changelog
+
+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.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_LOGGING_LEVEL` env var — CLI-specific log level that takes priority over `APCORE_LOGGING_LEVEL`; 3-tier precedence: `--log-level` flag > `APCORE_CLI_LOGGING_LEVEL` > `APCORE_LOGGING_LEVEL` > `WARNING` (`__main__.py`)
+- `test_cli_logging_level_takes_priority_over_global` — verifies `APCORE_CLI_LOGGING_LEVEL=DEBUG` wins over `APCORE_LOGGING_LEVEL=ERROR`
+- `test_cli_logging_level_fallback_to_global` — verifies fallback when CLI-specific var is unset
+- `test_builtin_name_collision_exits_2` — schema property named `format` (or other reserved names) causes `build_module_command` to exit 2
+- `test_exec_result_table_format` — `--format table` renders Rich Key/Value table to stdout
+- `test_bash_completion_quotes_prog_name_in_directive` — verifies `shlex.quote()` applied to `complete -F` directive, not just embedded subshell
+- `test_zsh_completion_quotes_prog_name_in_directives` — verifies `compdef` line uses quoted prog_name
+- `test_fish_completion_quotes_prog_name_in_directives` — verifies `complete -c` lines use quoted prog_name
+- 17 new tests (244 → 261 total)
+
+### Changed
+- `--log-level` accepted choices: `WARN` → `WARNING` (`__main__.py`)
+- `schema_to_click_options`: schema-derived options now always have `required=False`; required fields marked `[required]` in help text instead of Click enforcement — allows `--input -` STDIN to supply required values without Click rejecting first (`schema_parser.py`)
+- `format_exec_result`: now routes through `resolve_format()` and renders Rich table when `--format table` is specified; previously ignored its `format` parameter (`output.py`)
+- `_generate_bash_completion`, `_generate_zsh_completion`, `_generate_fish_completion`: `shlex.quote()` applied to ALL prog_name positions in generated scripts (complete directives, compdef, complete -c), not only embedded subshell commands (`shell.py`)
+- `check_approval`: removed unused `ctx: click.Context` parameter (`approval.py`)
+- `set_audit_logger`: broadened type annotation from `AuditLogger` to `AuditLogger | None` (`cli.py`)
+- `collect_input`: simplified redundant condition `if not raw or raw_size == 0:` → `if not raw:` (`cli.py`)
+- Example `Input` models: all 7 modules updated with `Field(description=...)` on every field so CLI `--help` shows descriptive text for each flag
+
+### Fixed
+- **`--input -` STDIN blocked by Click required enforcement**: `schema_to_click_options` was generating `required=True` Click options; Click validated before the callback ran, rejecting STDIN-only invocations. Resolved by always using `required=False` and delegating required validation to `jsonschema.validate()` after input collection. Fixes all 6 `TestRealStdinPiping` failures.
+- **`--log-level` had no effect**: `logging.basicConfig()` is a no-op after the first call; subsequent `create_cli()` calls in tests retained the prior handler's level. Fixed by calling `logging.getLogger().setLevel()` explicitly after `basicConfig()`.
+- **`test_log_level_flag_takes_effect` false pass**: `--help` is an eager flag that exits before the group callback, so `--log-level DEBUG --help` never applied the log level. Test updated to use `completion bash` subcommand instead.
+- **Shell completion directives not shell-safe**: prog names with spaces or special characters were unquoted in `complete -F`, `compdef`, and `complete -c` lines. Fixed by assigning `quoted = shlex.quote(prog_name)` and using it in all directive positions.
+- **Audit `set_audit_logger(None)` type error**: type annotation rejected `None`; broadened to `AuditLogger | None`.
+- **Test logger level leakage**: tests modifying root logger level affected subsequent tests; fixed with `try/finally` that restores the original level.
+
+### Security
+- `AuditLogger._hash_input`: now uses `secrets.token_bytes(16)` per-invocation salt before hashing, preventing cross-invocation input correlation via SHA-256 rainbow tables
+- `build_module_command`: added reserved-name collision guard — exits 2 if a schema property (`input`, `yes`, `large_input`, `format`, `sandbox`) conflicts with a built-in CLI option name
+- `_prompt_with_timeout` (SIGALRM path): wrapped in `try/finally` to guarantee signal handler restoration regardless of exit path
+
+## [0.1.0] - 2026-03-15
+
+### Added
+- `--sandbox` flag for subprocess-isolated module execution (FE-05)
+- `ModuleExecutionError` exception class for sandbox failures
+- Windows approval timeout support via `threading.Timer` + `ctypes` (FE-03)
+- Approval timeout clamping to 1..3600 seconds range (FE-03)
+- Tag format validation (`^[a-z][a-z0-9_-]*$`) in `list --tag` (FE-04)
+- `cli.auto_approve` config key with `False` default (FE-07)
+- Extensions directory readability check with exit code 47 (FE-01)
+- Missing required property warning in schema parser (FE-02)
+- DEBUG log `"Loading extensions from {path}"` before registry discovery (FE-01)
+- `TYPE_CHECKING` imports for proper type annotations (`Registry`, `Executor`, `ModuleDescriptor`, `ConfigResolver`, `AuditLogger`)
+- `_get_module_id()` helper for `canonical_id`/`module_id` resolution
+- `APCORE_AUTH_API_KEY` and `APCORE_CLI_SANDBOX` to README environment variables table
+- `--sandbox` to README module execution options table
+- CHANGELOG.md
+- Core Dispatcher (FE-01): `LazyModuleGroup`, `build_module_command`, `collect_input`, `validate_module_id`
+- Schema Parser (FE-02): `schema_to_click_options`, `_map_type`, `_extract_help`, `reconvert_enum_values`
+- Ref Resolver (FE-02): `resolve_refs`, `_resolve_node` with `$ref`, `allOf`, `anyOf`, `oneOf` support
+- Config Resolver (FE-07): `ConfigResolver` with 4-tier precedence (CLI > Env > File > Default)
+- Approval Gate (FE-03): `check_approval`, `_prompt_with_timeout` with TTY detection and Unix SIGALRM
+- Discovery (FE-04): `list` and `describe` commands with tag filtering and TTY-adaptive output
+- Output Formatter (FE-08): `format_module_list`, `format_module_detail`, `format_exec_result` with Rich rendering
+- Security Manager (FE-05): `AuthProvider`, `ConfigEncryptor` (keyring + AES-256-GCM), `AuditLogger` (JSON Lines), `Sandbox` (subprocess isolation)
+- Shell Integration (FE-06): bash/zsh/fish completion generators, roff man page generator
+- 8 example modules: `math.add`, `math.multiply`, `text.upper`, `text.reverse`, `text.wordcount`, `sysutil.info`, `sysutil.env`, `sysutil.disk`
+- 244 tests (unit, integration, end-to-end)
+- CI workflow with pytest and coverage
+- Pre-commit hooks configuration

apcore_cli-0.2.1/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.1.0 → apcore_cli-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: apcore-cli
-Version: 0.1.0
+Version: 0.2.1
 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
@@ -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
@@ -45,7 +45,7 @@ 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-244%20passed-brightgreen.svg)]()
+[![Tests](https://img.shields.io/badge/tests-263%20passed-brightgreen.svg)]()
 
 | | |
 |---|---|
@@ -207,7 +207,7 @@ apcore-cli [OPTIONS] COMMAND [ARGS]
 | Option | Default | Description |
 |--------|---------|-------------|
 | `--extensions-dir` | `./extensions` | Path to apcore extensions directory |
-| `--log-level` | `INFO` | Logging: `DEBUG`, `INFO`, `WARN`, `ERROR` |
+| `--log-level` | `WARNING` | Logging: `DEBUG`, `INFO`, `WARNING`, `ERROR` |
 | `--version` | | Show version and exit |
 | `--help` | | Show help and exit |
 
@@ -264,9 +264,11 @@ apcore-cli uses a 4-tier configuration precedence:
 |----------|-------------|---------|
 | `APCORE_EXTENSIONS_ROOT` | Path to extensions directory | `./extensions` |
 | `APCORE_CLI_AUTO_APPROVE` | Set to `1` to bypass all approval prompts | *(unset)* |
-| `APCORE_LOGGING_LEVEL` | Log level | `INFO` |
+| `APCORE_CLI_LOGGING_LEVEL` | CLI-specific log level (takes priority over `APCORE_LOGGING_LEVEL`) | `WARNING` |
+| `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`)
 
@@ -277,6 +279,8 @@ logging:
   level: DEBUG
 sandbox:
   enabled: false
+cli:
+  help_text_max_length: 1000
 ```
 
 ## Features
@@ -303,7 +307,7 @@ sandbox:
 | `module_id` (`math.add`) | Command name (`apcore-cli math.add`) |
 | `description` | `--help` text |
 | `input_schema.properties` | CLI flags (`--a`, `--b`) |
-| `input_schema.required` | Required flag enforcement |
+| `input_schema.required` | Validated post-collection via `jsonschema.validate()` (required fields shown as `[required]` in `--help`) |
 | `annotations.requires_approval` | HITL approval prompt |
 
 ### Architecture
@@ -316,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
     |
@@ -414,46 +418,11 @@ apcore-cli --extensions-dir ./extensions greet.hello --name Alice --greeting Hi
 git clone https://github.com/aipartnerup/apcore-cli-python.git
 cd apcore-cli-python
 pip install -e ".[dev]"
-pytest                           # 244 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.1.0 → apcore_cli-0.2.1}/README.md

@@ -8,7 +8,7 @@ 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-244%20passed-brightgreen.svg)]()
+[![Tests](https://img.shields.io/badge/tests-263%20passed-brightgreen.svg)]()
 
 | | |
 |---|---|
@@ -170,7 +170,7 @@ apcore-cli [OPTIONS] COMMAND [ARGS]
 | Option | Default | Description |
 |--------|---------|-------------|
 | `--extensions-dir` | `./extensions` | Path to apcore extensions directory |
-| `--log-level` | `INFO` | Logging: `DEBUG`, `INFO`, `WARN`, `ERROR` |
+| `--log-level` | `WARNING` | Logging: `DEBUG`, `INFO`, `WARNING`, `ERROR` |
 | `--version` | | Show version and exit |
 | `--help` | | Show help and exit |
 
@@ -227,9 +227,11 @@ apcore-cli uses a 4-tier configuration precedence:
 |----------|-------------|---------|
 | `APCORE_EXTENSIONS_ROOT` | Path to extensions directory | `./extensions` |
 | `APCORE_CLI_AUTO_APPROVE` | Set to `1` to bypass all approval prompts | *(unset)* |
-| `APCORE_LOGGING_LEVEL` | Log level | `INFO` |
+| `APCORE_CLI_LOGGING_LEVEL` | CLI-specific log level (takes priority over `APCORE_LOGGING_LEVEL`) | `WARNING` |
+| `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`)
 
@@ -240,6 +242,8 @@ logging:
   level: DEBUG
 sandbox:
   enabled: false
+cli:
+  help_text_max_length: 1000
 ```
 
 ## Features
@@ -266,7 +270,7 @@ sandbox:
 | `module_id` (`math.add`) | Command name (`apcore-cli math.add`) |
 | `description` | `--help` text |
 | `input_schema.properties` | CLI flags (`--a`, `--b`) |
-| `input_schema.required` | Required flag enforcement |
+| `input_schema.required` | Validated post-collection via `jsonschema.validate()` (required fields shown as `[required]` in `--help`) |
 | `annotations.requires_approval` | HITL approval prompt |
 
 ### Architecture
@@ -279,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
     |
@@ -377,46 +381,11 @@ apcore-cli --extensions-dir ./extensions greet.hello --name Alice --greeting Hi
 git clone https://github.com/aipartnerup/apcore-cli-python.git
 cd apcore-cli-python
 pip install -e ".[dev]"
-pytest                           # 244 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.1.0 → apcore_cli-0.2.1}/examples/extensions/math/add.py

@@ -1,11 +1,11 @@
 """math.add — Add two numbers."""
 
-from pydantic import BaseModel
+from pydantic import BaseModel, Field
 
 
 class Input(BaseModel):
-    a: int
-    b: int
+    a: int = Field(..., description="First operand")
+    b: int = Field(..., description="Second operand")
 
 
 class Output(BaseModel):

{apcore_cli-0.1.0 → apcore_cli-0.2.1}/examples/extensions/math/multiply.py

@@ -1,11 +1,11 @@
 """math.multiply — Multiply two numbers."""
 
-from pydantic import BaseModel
+from pydantic import BaseModel, Field
 
 
 class Input(BaseModel):
-    a: int
-    b: int
+    a: int = Field(..., description="First operand")
+    b: int = Field(..., description="Second operand")
 
 
 class Output(BaseModel):

{apcore_cli-0.1.0 → apcore_cli-0.2.1}/examples/extensions/sysutil/disk.py

@@ -2,11 +2,11 @@
 
 import os
 
-from pydantic import BaseModel
+from pydantic import BaseModel, Field
 
 
 class Input(BaseModel):
-    path: str = "/"
+    path: str = Field("/", description="Filesystem path to check (default: /)")
 
 
 class Output(BaseModel):

{apcore_cli-0.1.0 → apcore_cli-0.2.1}/examples/extensions/sysutil/env.py

@@ -2,12 +2,12 @@
 
 import os
 
-from pydantic import BaseModel
+from pydantic import BaseModel, Field
 
 
 class Input(BaseModel):
-    name: str
-    default: str = ""
+    name: str = Field(..., description="Environment variable name to read")
+    default: str = Field("", description="Value to return if the variable is not set")
 
 
 class Output(BaseModel):

{apcore_cli-0.1.0 → apcore_cli-0.2.1}/examples/extensions/text/reverse.py

@@ -1,10 +1,10 @@
 """text.reverse — Reverse a string."""
 
-from pydantic import BaseModel
+from pydantic import BaseModel, Field
 
 
 class Input(BaseModel):
-    text: str
+    text: str = Field(..., description="Input string to reverse")
 
 
 class Output(BaseModel):

{apcore_cli-0.1.0 → apcore_cli-0.2.1}/examples/extensions/text/upper.py

@@ -1,10 +1,10 @@
 """text.upper — Convert text to uppercase."""
 
-from pydantic import BaseModel
+from pydantic import BaseModel, Field
 
 
 class Input(BaseModel):
-    text: str
+    text: str = Field(..., description="Input string to convert")
 
 
 class Output(BaseModel):

{apcore_cli-0.1.0 → apcore_cli-0.2.1}/examples/extensions/text/wordcount.py

@@ -1,10 +1,10 @@
 """text.wordcount — Count words, characters, and lines."""
 
-from pydantic import BaseModel
+from pydantic import BaseModel, Field
 
 
 class Input(BaseModel):
-    text: str
+    text: str = Field(..., description="Input text to analyse")
 
 
 class Output(BaseModel):

{apcore_cli-0.1.0 → apcore_cli-0.2.1}/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.1.0 → apcore_cli-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "apcore-cli"
-version = "0.1.0"
+version = "0.2.1"
 description = "Terminal adapter for apcore — execute AI-Perceivable modules from the command line"
 readme = "README.md"
 license = "Apache-2.0"
@@ -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",

apcore_cli-0.2.1/src/apcore_cli/__init__.py

@@ -0,0 +1,9 @@
+"""apcore-cli: CLI adapter for the apcore module ecosystem."""
+
+from importlib.metadata import PackageNotFoundError
+from importlib.metadata import version as _get_version
+
+try:
+    __version__ = _get_version("apcore-cli")
+except PackageNotFoundError:
+    __version__ = "unknown"

{apcore_cli-0.1.0 → apcore_cli-0.2.1}/src/apcore_cli/__main__.py

@@ -36,23 +36,55 @@ def _extract_extensions_dir(argv: list[str] | None = None) -> str | None:
     return None
 
 
-def create_cli(extensions_dir: str | None = None) -> click.Group:
+def create_cli(extensions_dir: str | None = None, prog_name: str | None = None) -> click.Group:
     """Create the CLI application.
 
     Args:
         extensions_dir: Override for extensions directory.
                         When None, resolves via ConfigResolver (env/file/default).
+        prog_name: Name shown in help text and version output.
+                   Defaults to the basename of sys.argv[0], so downstream projects
+                   that install their own entry-point script get the correct name
+                   automatically (e.g. ``mycli`` instead of ``apcore-cli``).
     """
+    if prog_name is None:
+        prog_name = os.path.basename(sys.argv[0]) or "apcore-cli"
+
+    # Resolve CLI log level (3-tier precedence, evaluated before Click runs):
+    #   APCORE_CLI_LOGGING_LEVEL (CLI-specific) > APCORE_LOGGING_LEVEL (global) > WARNING
+    # The --log-level flag (parsed later) can further override at runtime.
+    _cli_level_str = os.environ.get("APCORE_CLI_LOGGING_LEVEL", "").upper()
+    _global_level_str = os.environ.get("APCORE_LOGGING_LEVEL", "").upper()
+    _active_level_str = _cli_level_str or _global_level_str
+    _default_level = getattr(logging, _active_level_str, logging.WARNING) if _active_level_str else logging.WARNING
+    logging.basicConfig(level=_default_level, format="%(levelname)s: %(message)s")
+    # basicConfig is a no-op if handlers already exist; always set the root level explicitly.
+    logging.getLogger().setLevel(_default_level)
+    # Silence noisy upstream apcore loggers unless the user requests verbose output.
+    # Always set explicitly so the level is deterministic regardless of prior state.
+    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)
 
@@ -97,12 +129,13 @@ def create_cli(extensions_dir: str | None = None) -> click.Group:
         cls=LazyModuleGroup,
         registry=registry,
         executor=executor,
-        name="apcore-cli",
+        help_text_max_length=help_text_max_length,
+        name=prog_name,
         help="CLI adapter for the apcore module ecosystem.",
     )
     @click.version_option(
         version=__version__,
-        prog_name="apcore-cli",
+        prog_name=prog_name,
     )
     @click.option(
         "--extensions-dir",
@@ -113,11 +146,18 @@ def create_cli(extensions_dir: str | None = None) -> click.Group:
     @click.option(
         "--log-level",
         default=None,
-        type=click.Choice(["DEBUG", "INFO", "WARN", "ERROR"], case_sensitive=False),
-        help="Log level.",
+        type=click.Choice(["DEBUG", "INFO", "WARNING", "ERROR"], case_sensitive=False),
+        help="Log verbosity. Overrides APCORE_CLI_LOGGING_LEVEL and APCORE_LOGGING_LEVEL env vars.",
     )
     @click.pass_context
     def cli(ctx: click.Context, extensions_dir_opt: str | None = None, log_level: str | None = None) -> None:
+        if log_level is not None:
+            # basicConfig() is a no-op once handlers exist; set level on the root logger directly.
+            level = getattr(logging, log_level.upper(), logging.WARNING)
+            logging.getLogger().setLevel(level)
+            # Keep apcore logger in sync: verbose when user asks for it, quiet otherwise.
+            apcore_level = level if level <= logging.INFO else logging.ERROR
+            logging.getLogger("apcore").setLevel(apcore_level)
         ctx.ensure_object(dict)
         ctx.obj["extensions_dir"] = ext_dir
 
@@ -125,16 +165,20 @@ def create_cli(extensions_dir: str | None = None) -> click.Group:
     register_discovery_commands(cli, registry)
 
     # Register shell integration commands
-    register_shell_commands(cli)
+    register_shell_commands(cli, prog_name=prog_name)
 
     return cli
 
 
-def main() -> None:
-    """Main entry point for apcore-cli."""
-    # Extract --extensions-dir from argv before Click parses
+def main(prog_name: str | None = None) -> None:
+    """Main entry point for apcore-cli.
+
+    Args:
+        prog_name: Override the program name shown in help/version output.
+                   When None, inferred from sys.argv[0] automatically.
+    """
     ext_dir = _extract_extensions_dir()
-    cli = create_cli(extensions_dir=ext_dir)
+    cli = create_cli(extensions_dir=ext_dir, prog_name=prog_name)
     cli(standalone_mode=True)