apcore-cli 0.3.0__tar.gz → 0.3.1__tar.gz

{apcore_cli-0.3.0 → apcore_cli-0.3.1}/CHANGELOG.md

@@ -5,6 +5,26 @@ 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.3.1] - 2026-03-27
+
+### Added
+
+- **DisplayResolver integration** — `__main__.py` integrates `DisplayResolver` from `apcore-toolkit` (optional) when `--binding` option is provided; gracefully skipped when not installed.
+- **`init` to `BUILTIN_COMMANDS`** — `init` subcommand is now registered in the builtin commands set.
+- **`APCORE_AUTH_API_KEY` to man page** — environment variable documented in generated roff man page.
+- **Grouped shell completion with `_APCORE_GRP`** — bash/zsh/fish completion scripts now support two-level group/command completion via the `_APCORE_GRP` environment variable (`shell.py`).
+- **Path traversal validation for `--dir` in `init` command** — rejects paths containing `..` segments to prevent directory escape (`init_cmd.py`).
+
+### Fixed
+
+- **`RegistryWriter` API call** — constructor now called without parameters; fixes `TypeError` introduced by upstream API change.
+
+### Changed
+
+- `apcore` dependency bumped to `>=0.14.0`.
+
+---
+
 ## [0.3.0] - 2026-03-23
 
 ### Added

{apcore_cli-0.3.0 → apcore_cli-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: apcore-cli
-Version: 0.3.0
+Version: 0.3.1
 Summary: Terminal adapter for apcore — execute AI-Perceivable modules from the command line
 Project-URL: Homepage, https://aiperceivable.com
 Project-URL: Repository, https://github.com/aiperceivable/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.1
+Requires-Dist: apcore>=0.14.0
 Requires-Dist: click>=8.1
 Requires-Dist: cryptography>=41.0
 Requires-Dist: jsonschema>=4.20
@@ -85,7 +85,7 @@ Terminal adapter for apcore. Execute AI-Perceivable modules from the command lin
 pip install apcore-cli
 ```
 
-Requires Python 3.11+ and `apcore >= 0.13.0`.
+Requires Python 3.11+ and `apcore >= 0.14.0`.
 
 ## Quick Start
 

{apcore_cli-0.3.0 → apcore_cli-0.3.1}/README.md

@@ -48,7 +48,7 @@ Terminal adapter for apcore. Execute AI-Perceivable modules from the command lin
 pip install apcore-cli
 ```
 
-Requires Python 3.11+ and `apcore >= 0.13.0`.
+Requires Python 3.11+ and `apcore >= 0.14.0`.
 
 ## Quick Start
 

{apcore_cli-0.3.0 → apcore_cli-0.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "apcore-cli"
-version = "0.3.0"
+version = "0.3.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.1",
+    "apcore>=0.14.0",
     "click>=8.1",
     "jsonschema>=4.20",
     "rich>=13.0",

{apcore_cli-0.3.0 → apcore_cli-0.3.1}/src/apcore_cli/__main__.py

@@ -45,10 +45,16 @@ def _extract_commands_dir(argv: list[str] | None = None) -> str | None:
     return _extract_argv_option(argv, "--commands-dir")
 
 
+def _extract_binding_path(argv: list[str] | None = None) -> str | None:
+    """Extract --binding value from argv before Click parses it."""
+    return _extract_argv_option(argv, "--binding")
+
+
 def create_cli(
     extensions_dir: str | None = None,
     prog_name: str | None = None,
     commands_dir: str | None = None,
+    binding_path: str | None = None,
 ) -> click.Group:
     """Create the CLI application.
 
@@ -62,6 +68,9 @@ def create_cli(
         commands_dir: Directory containing convention-based modules.
                       When set, scans for plain-function modules and registers
                       them via ConventionScanner (requires apcore-toolkit).
+        binding_path: Path to binding.yaml file or directory for display resolution.
+                      When set, applies DisplayResolver to convention-scanned modules
+                      (requires apcore-toolkit).
     """
     if prog_name is None:
         prog_name = os.path.basename(sys.argv[0]) or "apcore-cli"
@@ -138,8 +147,17 @@ def create_cli(
                 conv_scanner = ConventionScanner()
                 conv_modules = conv_scanner.scan(commands_dir)
                 if conv_modules:
-                    writer = RegistryWriter(registry=registry)
-                    writer.write(conv_modules)
+                    if binding_path is not None:
+                        try:
+                            from apcore_toolkit import DisplayResolver
+
+                            display_resolver = DisplayResolver()
+                            conv_modules = display_resolver.resolve(conv_modules, binding_path=binding_path)
+                            logger.info("DisplayResolver: applied binding from %s", binding_path)
+                        except ImportError:
+                            logger.warning("DisplayResolver not available in apcore-toolkit")
+                    writer = RegistryWriter()
+                    writer.write(conv_modules, registry)
                     logger.info("Convention scanner: registered %d modules from %s", len(conv_modules), commands_dir)
             except ImportError:
                 logger.warning("apcore-toolkit not installed — convention module scanning unavailable")
@@ -182,6 +200,12 @@ def create_cli(
         default=None,
         help="Path to convention-based commands directory.",
     )
+    @click.option(
+        "--binding",
+        "binding_opt",
+        default=None,
+        help="Path to binding.yaml file or directory for display resolution.",
+    )
     @click.option(
         "--log-level",
         default=None,
@@ -193,6 +217,7 @@ def create_cli(
         ctx: click.Context,
         extensions_dir_opt: str | None = None,
         commands_dir_opt: str | None = None,
+        binding_opt: str | None = None,
         log_level: str | None = None,
     ) -> None:
         if log_level is not None:
@@ -228,7 +253,8 @@ def main(prog_name: str | None = None) -> None:
     """
     ext_dir = _extract_extensions_dir()
     cmd_dir = _extract_commands_dir()
-    cli = create_cli(extensions_dir=ext_dir, prog_name=prog_name, commands_dir=cmd_dir)
+    bind_path = _extract_binding_path()
+    cli = create_cli(extensions_dir=ext_dir, prog_name=prog_name, commands_dir=cmd_dir, binding_path=bind_path)
     cli(standalone_mode=True)
 
 

{apcore_cli-0.3.0 → apcore_cli-0.3.1}/src/apcore_cli/cli.py

@@ -27,7 +27,7 @@ if TYPE_CHECKING:
 
 logger = logging.getLogger("apcore_cli.cli")
 
-BUILTIN_COMMANDS = ["exec", "list", "describe", "completion", "man"]
+BUILTIN_COMMANDS = ["completion", "describe", "exec", "init", "list", "man"]
 
 # Module-level audit logger, set during CLI init
 _audit_logger: AuditLogger | None = None

{apcore_cli-0.3.0 → apcore_cli-0.3.1}/src/apcore_cli/init_cmd.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import sys
 from pathlib import Path
 
 import click
@@ -59,6 +60,10 @@ def register_init_command(cli: click.Group) -> None:
 
         MODULE_ID is the module identifier (e.g., ops.deploy, user.create).
         """
+        if output_dir is not None and ".." in Path(output_dir).parts:
+            click.echo("Error: Output directory must not contain '..' path components.", err=True)
+            sys.exit(2)
+
         # Parse module_id into parts
         parts = module_id.rsplit(".", 1)
         if len(parts) == 2:

{apcore_cli-0.3.0 → apcore_cli-0.3.1}/src/apcore_cli/shell.py

@@ -59,7 +59,7 @@ def _generate_bash_completion(prog_name: str) -> str:
         "\n"
         "    if [[ ${COMP_CWORD} -eq 1 ]]; then\n"
         f"        local all_ids=$({groups_and_top_cmd})\n"
-        '        local builtins="exec list describe completion man"\n'
+        '        local builtins="completion describe exec init list man"\n'
         '        COMPREPLY=( $(compgen -W "${builtins} ${all_ids}" -- ${cur}) )\n'
         "        return 0\n"
         "    fi\n"
@@ -124,6 +124,7 @@ def _generate_zsh_completion(prog_name: str) -> str:
         "        'list:List available modules'\n"
         "        'describe:Show module metadata and schema'\n"
         "        'completion:Generate shell completion script'\n"
+        "        'init:Scaffolding commands'\n"
         "        'man:Generate man page'\n"
         "    )\n"
         "\n"
@@ -208,6 +209,8 @@ def _generate_fish_completion(prog_name: str) -> str:
         f'complete -c {quoted} -n "__fish_use_subcommand"'
         ' -a completion -d "Generate shell completion script"\n'
         f'complete -c {quoted} -n "__fish_use_subcommand"'
+        ' -a init -d "Scaffolding commands"\n'
+        f'complete -c {quoted} -n "__fish_use_subcommand"'
         ' -a man -d "Generate man page"\n'
         f'complete -c {quoted} -n "__fish_use_subcommand"'
         f' -a "({groups_and_top_cmd})" -d "Module group or command"\n'
@@ -304,6 +307,9 @@ def _generate_man_page(command_name: str, command: click.Command | None, prog_na
         "Global apcore logging verbosity. One of: DEBUG, INFO, WARNING, ERROR. "
         "Used as fallback when \\fBAPCORE_CLI_LOGGING_LEVEL\\fR is not set. Default: WARNING."
     )
+    sections.append(".TP")
+    sections.append("\\fBAPCORE_AUTH_API_KEY\\fR")
+    sections.append("API key for authenticating with the apcore registry.")
 
     sections.append(".SH EXIT CODES")
     exit_codes = [
@@ -380,7 +386,7 @@ def register_shell_commands(cli: click.Group, prog_name: str = "apcore-cli") ->
         parent_group = parent.command
         cmd = parent_group.commands.get(command) if isinstance(parent_group, click.Group) else None
 
-        known_builtins = {"list", "describe", "completion", "man"}
+        known_builtins = {"completion", "describe", "exec", "init", "list", "man"}
         if cmd is None and command not in known_builtins:
             click.echo(f"Error: Unknown command '{command}'.", err=True)
             sys.exit(2)