apcore-cli 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,59 @@
+# Changelog
+
+All notable changes to apcore-cli (TypeScript 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.0] - 2026-03-18
+
+### Added
+- Core dispatch pipeline: `buildModuleCommand` now fully wires schema resolution, built-in options (`--input`, `--yes`, `--large-input`, `--format`, `--sandbox`), input collection, approval gate, sandbox execution, audit logging, and output formatting
+- `LazyModuleGroup.getCommand` now calls `buildModuleCommand` instead of creating bare Commander commands
+- `createCli` wired with program name resolution from `argv`, `--extensions-dir` and `--log-level` global options, and log level resolution from `APCORE_CLI_LOGGING_LEVEL` / `APCORE_LOGGING_LEVEL` env vars
+- Commander `.exitOverride()` — custom exit code mapping via `exitCodeForError` is now active (previously dead code because Commander calls `process.exit()` internally)
+- `src/logger.ts` — structured logger utility with `setLogLevel`, `getLogLevel`, `debug`, `info`, `warn`, `error` functions respecting `logging.level` config
+- `setAuditLogger` / `getAuditLogger` — module-level audit logger getter/setter (ported from Python SDK)
+- `tests/main.test.ts` — 14 new tests covering `createCli`, Commander exitOverride, `buildModuleCommand` action execution, and SIGINT handling
+- `APCORE_CLI_LOGGING_LEVEL` env var support — 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`
+- 181 tests total (up from 167)
+
+### Changed
+- `schemaToCommanderOptions` renamed to `schemaToCliOptions` — framework-agnostic name matching spec canonical form
+- `AuditLogger` constructor parameter renamed from `logPath` to `path` — matches spec and Python SDK
+- `ConfigResolver.DEFAULTS` keys normalized to snake_case: `cli.stdinBufferLimit` → `cli.stdin_buffer_limit`, `cli.autoApprove` → `cli.auto_approve` — matches spec and Python SDK
+- `ConfigResolver.DEFAULTS` `logging.level` default changed from `"INFO"` to `"WARNING"` — matches updated spec
+- `ConfigEncryptor.store` / `ConfigEncryptor.retrieve` now async — required by keytar dynamic import change
+- `AuthProvider.getApiKey` / `AuthProvider.authenticateRequest` now async — propagated from ConfigEncryptor async change
+- Version string read from `package.json` at runtime instead of hardcoded in 3 places
+- `readStdin()` properly removes event listeners on completion/error — prevents listener accumulation
+- Removed duplicate `resolveFormat` re-export from `main.ts` (index.ts already exports from output.ts)
+
+### Fixed
+- **Commander exit code mapping was dead code**: `program.parse()` calls `process.exit()` internally; added `.exitOverride()` so errors throw `CommanderError` and the catch block in `main()` can apply `exitCodeForError` mapping
+- **`LazyModuleGroup.getCommand` bypassed `buildModuleCommand`**: was creating bare `new Command(cmdName)` instead of building a fully wired command with schema options and execution callback
+- **`require('keytar')` in ESM module**: replaced with dynamic `await import('keytar')` via cached helper; keytar is an optional peer dependency (archived/deprecated)
+- **README `--stdin json` flag**: corrected to `--input -`
+- **README missing Features and API Overview sections**: added comprehensive sections
+
+### Security
+- `AuditLogger._hashInput`: uses `crypto.randomBytes(16)` per-invocation salt before SHA-256 hashing, preventing cross-invocation input correlation
+- Added security comment on AES key derivation fallback (best-effort when OS keyring unavailable — key derived from hostname + username)
+
+## [0.1.0] - 2026-03-17
+
+### Added
+- Core Dispatcher (FE-01): `LazyModuleGroup`, `buildModuleCommand`, `collectInput`, `validateModuleId`, `createCli`, `main`
+- Schema Parser (FE-02): `schemaToCliOptions`, `mapType`, `extractHelp`, `reconvertEnumValues`
+- Ref Resolver (FE-02): `resolveRefs` with `$ref`, `allOf`, `anyOf`, `oneOf` support, max depth 32
+- Config Resolver (FE-07): `ConfigResolver` with 4-tier precedence (CLI > Env > File > Default), YAML config loading
+- Approval Gate (FE-03): `checkApproval` with TTY detection, `--yes` bypass, `APCORE_CLI_AUTO_APPROVE` env var, 60s timeout
+- Discovery (FE-04): `list` and `describe` commands with `--tag` AND-filtering and `--format json|table`
+- Output Formatter (FE-08): `formatModuleList`, `formatModuleDetail`, `formatExecResult` with TTY-adaptive JSON/table rendering
+- Security Manager (FE-05): `AuthProvider` (API key auth with keyring/AES), `ConfigEncryptor` (keyring + AES-256-GCM fallback), `AuditLogger` (JSON Lines with salted SHA-256), `Sandbox` (subprocess isolation)
+- Shell Integration (FE-06): bash/zsh/fish completion generators, roff man page generator
+- Error classes: `ApprovalTimeoutError`, `ApprovalDeniedError`, `AuthenticationError`, `ConfigDecryptionError`, `ModuleExecutionError`, `ModuleNotFoundError`, `SchemaValidationError`
+- Exit code mapping: `EXIT_CODES` constant and `exitCodeForError` helper (0, 1, 2, 44, 45, 46, 47, 48, 77, 130)
+- 167 tests (unit and integration)
+- TypeScript strict mode with full type coverage
+- Pre-commit hooks: `apdev-js check-chars`, `apdev-js check-imports`, `tsc --noEmit`

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI Partner Up
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,290 @@
+<div align="center">
+  <img src="https://raw.githubusercontent.com/aipartnerup/apcore-cli/main/apcore-cli-logo.svg" alt="apcore-cli logo" width="200"/>
+</div>
+
+# apcore-cli
+
+Terminal adapter for apcore. Execute AI-Perceivable modules from the command line.
+
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+[![Node](https://img.shields.io/badge/node-18%2B-blue.svg)](https://nodejs.org)
+[![Tests](https://img.shields.io/badge/tests-181%20passed-brightgreen.svg)]()
+
+| | |
+|---|---|
+| **TypeScript SDK** | [github.com/aipartnerup/apcore-cli-typescript](https://github.com/aipartnerup/apcore-cli-typescript) |
+| **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) |
+
+**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.
+
+```
+┌──────────────────┐
+│  nestjs-apcore   │  <- your existing apcore project (unchanged)
+│  express-apcore  │
+│  ...             │
+└────────┬─────────┘
+         │  extensions directory
+         v
+┌──────────────────┐
+│   apcore-cli     │  <- just install & point to extensions dir
+└───┬──────────┬───┘
+    │          │
+    v          v
+ Terminal    Unix
+ Commands    Pipes
+```
+
+## Design Philosophy
+
+- **Zero intrusion** -- your apcore project needs no code changes, no imports, no dependencies on apcore-cli
+- **Zero configuration** -- point to an extensions directory, everything is auto-discovered
+- **Pure adapter** -- apcore-cli reads from the apcore Registry; it never modifies your modules
+- **Unix-native** -- JSON output for pipes, rich tables for terminals, STDIN input, shell completions
+
+## Installation
+
+```bash
+pnpm add apcore-cli apcore-js
+```
+
+Requires Node.js 18+ and `apcore-js >= 0.13.0`.
+
+## Quick Start
+
+### Zero-code approach
+
+If you already have an apcore-based project with an extensions directory:
+
+```bash
+# Execute a module
+apcore-cli --extensions-dir ./extensions math.add --a 42 --b 58
+
+# Or set the env var once
+export APCORE_EXTENSIONS_ROOT=./extensions
+apcore-cli math.add --a 42 --b 58
+```
+
+All modules are auto-discovered. CLI flags are auto-generated from each module's JSON Schema.
+
+### Programmatic approach (TypeScript API)
+
+```typescript
+import { createCli } from "apcore-cli";
+
+// Build the CLI from your registry
+const cli = createCli("./extensions");
+cli.parse(process.argv);
+```
+
+Or use the `LazyModuleGroup` directly with Commander:
+
+```typescript
+import { LazyModuleGroup, buildModuleCommand } from "apcore-cli";
+import { Registry, Executor } from "apcore-js";
+
+const registry = new Registry("./extensions");
+registry.discover();
+const executor = new Executor(registry);
+
+const group = new LazyModuleGroup(registry, executor);
+const cmd = group.getCommand("math.add");
+cmd?.parse(process.argv);
+```
+
+## Integration with Existing Projects
+
+### Typical apcore project structure
+
+```
+your-project/
+├── extensions/          <- modules live here
+│   ├── math/
+│   │   └── add.ts
+│   ├── text/
+│   │   └── upper.ts
+│   └── ...
+├── your_app.ts          <- your existing code (untouched)
+└── ...
+```
+
+### Adding CLI support
+
+No changes to your project. Just install and run:
+
+```bash
+pnpm add apcore-cli apcore-js
+apcore-cli --extensions-dir ./extensions list
+apcore-cli --extensions-dir ./extensions math.add --a 5 --b 10
+```
+
+### STDIN piping (Unix pipes)
+
+```bash
+# Pipe JSON input
+echo '{"a": 100, "b": 200}' | apcore-cli math.add --input -
+# {"sum": 300}
+
+# CLI flags override STDIN values
+echo '{"a": 1, "b": 2}' | apcore-cli math.add --input - --a 999
+# {"sum": 1001}
+
+# Chain with other tools
+apcore-cli sysutil.info | jq '.os, .hostname'
+```
+
+## CLI Reference
+
+```
+apcore-cli [OPTIONS] COMMAND [ARGS]
+```
+
+### Global Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--extensions-dir` | `./extensions` | Path to apcore extensions directory |
+| `--log-level` | `WARNING` | Logging: `DEBUG`, `INFO`, `WARNING`, `ERROR` |
+| `--version` | | Show version and exit |
+| `--help` | | Show help and exit |
+
+### Built-in Commands
+
+| Command | Description |
+|---------|-------------|
+| `list` | List available modules with optional tag filtering |
+| `describe <module_id>` | Show full module metadata and schemas |
+| `exec <module_id>` | Internal routing alias for module execution |
+| `completion <shell>` | Generate shell completion script (bash/zsh/fish) |
+| `man <command>` | Generate man page in roff format |
+
+### Module Execution Options
+
+When executing a module (e.g. `apcore-cli math.add`), these built-in options are always available:
+
+| Option | Description |
+|--------|-------------|
+| `--input -` | Read JSON input from STDIN |
+| `--yes` / `-y` | Bypass approval prompts |
+| `--large-input` | Allow STDIN input larger than 10MB |
+| `--format` | Output format: `json` or `table` |
+| `--sandbox` | Run module in subprocess sandbox |
+
+Schema-generated flags (e.g. `--a`, `--b`) are added automatically from the module's `input_schema`.
+
+### Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Success |
+| `1` | Module execution error |
+| `2` | Invalid CLI input |
+| `44` | Module not found / disabled / load error |
+| `45` | Schema validation error |
+| `46` | Approval denied or timed out |
+| `47` | Configuration error |
+| `48` | Schema circular reference |
+| `77` | ACL denied |
+| `130` | Execution cancelled (Ctrl+C) |
+
+## Configuration
+
+apcore-cli uses a 4-tier configuration precedence:
+
+1. **CLI flag** (highest): `--extensions-dir ./custom`
+2. **Environment variable**: `APCORE_EXTENSIONS_ROOT=./custom`
+3. **Config file**: `apcore.yaml`
+4. **Default** (lowest): `./extensions`
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `APCORE_EXTENSIONS_ROOT` | Path to extensions directory | `./extensions` |
+| `APCORE_CLI_AUTO_APPROVE` | Set to `1` to bypass all approval prompts | *(unset)* |
+| `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)* |
+
+### Config File (`apcore.yaml`)
+
+```yaml
+extensions:
+  root: ./extensions
+logging:
+  level: DEBUG
+sandbox:
+  enabled: false
+```
+
+## Features
+
+- **Auto-discovery** -- all modules in the extensions directory are found and exposed as CLI commands
+- **Auto-generated flags** -- JSON Schema `input_schema` is converted to `--flag value` CLI options with type validation
+- **Boolean flag pairs** -- `--verbose` / `--no-verbose` from `"type": "boolean"` schema properties
+- **Enum choices** -- `"enum": ["json", "csv"]` becomes `--format json` with Commander validation
+- **STDIN piping** -- `--input -` reads JSON from STDIN, CLI flags override for duplicate keys
+- **TTY-adaptive output** -- rich tables for terminals, JSON for pipes (configurable via `--format`)
+- **Approval gate** -- TTY-aware HITL prompts for modules with `requires_approval: true`, with `--yes` bypass and 60s timeout
+- **Schema validation** -- inputs validated against JSON Schema before execution, with `$ref`/`allOf`/`anyOf`/`oneOf` resolution
+- **Security** -- API key auth (keyring + AES-256-GCM), append-only audit logging, subprocess sandboxing
+- **Shell completions** -- `apcore-cli completion bash|zsh|fish` generates completion scripts with dynamic module ID completion
+- **Man pages** -- `apcore-cli man <command>` generates roff-formatted man pages
+- **Audit logging** -- all executions logged to `~/.apcore-cli/audit.jsonl` with SHA-256 input hashing
+
+## How It Works
+
+### Mapping: apcore to CLI
+
+| apcore | CLI |
+|--------|-----|
+| `module_id` (`math.add`) | Command name (`apcore-cli math.add`) |
+| `description` | `--help` text |
+| `input_schema.properties` | CLI flags (`--a`, `--b`) |
+| `input_schema.required` | Validated post-collection via ajv (required fields shown as `[required]` in `--help`) |
+| `annotations.requires_approval` | HITL approval prompt |
+
+### Architecture
+
+```
+User / AI Agent (terminal)
+    |
+    v
+apcore-cli (the adapter)
+    |
+    +-- ConfigResolver       4-tier config precedence
+    +-- LazyModuleGroup      Dynamic Commander command generation
+    +-- schema_parser        JSON Schema -> Commander 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
+    |
+    v
+apcore Registry + Executor (your modules, unchanged)
+```
+
+## API Overview
+
+**Classes:** `LazyModuleGroup`, `ConfigResolver`, `AuthProvider`, `ConfigEncryptor`, `AuditLogger`, `Sandbox`
+
+**Functions:** `createCli`, `main`, `buildModuleCommand`, `validateModuleId`, `collectInput`, `schemaToCliOptions`, `reconvertEnumValues`, `resolveRefs`, `checkApproval`, `resolveFormat`, `formatModuleList`, `formatModuleDetail`, `formatExecResult`, `registerDiscoveryCommands`, `registerShellCommands`, `setAuditLogger`, `getAuditLogger`, `exitCodeForError`, `mapType`, `extractHelp`, `truncate`
+
+**Errors:** `ApprovalTimeoutError`, `ApprovalDeniedError`, `AuthenticationError`, `ConfigDecryptionError`, `ModuleExecutionError`, `ModuleNotFoundError`, `SchemaValidationError`
+
+## Development
+
+```bash
+git clone https://github.com/aipartnerup/apcore-cli-typescript.git
+cd apcore-cli-typescript
+pnpm install
+pnpm test                        # 181 tests
+pnpm build                       # compile TypeScript
+```
+
+## License
+
+Apache-2.0

package/dist/bin/apcore-cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/bin/apcore-cli.js

@@ -0,0 +1,197 @@
+#!/usr/bin/env node
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+
+// node_modules/.pnpm/tsup@8.5.1_postcss@8.5.8_typescript@5.9.3/node_modules/tsup/assets/esm_shims.js
+import path from "path";
+import { fileURLToPath } from "url";
+var init_esm_shims = __esm({
+  "node_modules/.pnpm/tsup@8.5.1_postcss@8.5.8_typescript@5.9.3/node_modules/tsup/assets/esm_shims.js"() {
+    "use strict";
+  }
+});
+
+// src/errors.ts
+function exitCodeForError(error) {
+  if (error instanceof ApprovalTimeoutError) {
+    return EXIT_CODES.APPROVAL_TIMEOUT;
+  }
+  if (error instanceof ApprovalDeniedError) {
+    return EXIT_CODES.APPROVAL_DENIED;
+  }
+  if (error instanceof AuthenticationError) {
+    return EXIT_CODES.ACL_DENIED;
+  }
+  if (error instanceof ConfigDecryptionError) {
+    return EXIT_CODES.CONFIG_INVALID;
+  }
+  if (error instanceof SchemaValidationError) {
+    return EXIT_CODES.SCHEMA_VALIDATION_ERROR;
+  }
+  if (error instanceof ModuleNotFoundError) {
+    return EXIT_CODES.MODULE_NOT_FOUND;
+  }
+  if (error instanceof ModuleExecutionError) {
+    return EXIT_CODES.MODULE_EXECUTE_ERROR;
+  }
+  if (error instanceof Error) {
+    const code = error.code;
+    const codeMap = {
+      MODULE_NOT_FOUND: EXIT_CODES.MODULE_NOT_FOUND,
+      MODULE_LOAD_ERROR: EXIT_CODES.MODULE_LOAD_ERROR,
+      MODULE_DISABLED: EXIT_CODES.MODULE_DISABLED,
+      SCHEMA_VALIDATION_ERROR: EXIT_CODES.SCHEMA_VALIDATION_ERROR,
+      SCHEMA_CIRCULAR_REF: EXIT_CODES.SCHEMA_CIRCULAR_REF,
+      APPROVAL_DENIED: EXIT_CODES.APPROVAL_DENIED,
+      APPROVAL_TIMEOUT: EXIT_CODES.APPROVAL_TIMEOUT,
+      CONFIG_NOT_FOUND: EXIT_CODES.CONFIG_NOT_FOUND,
+      CONFIG_INVALID: EXIT_CODES.CONFIG_INVALID,
+      MODULE_EXECUTE_ERROR: EXIT_CODES.MODULE_EXECUTE_ERROR,
+      MODULE_TIMEOUT: EXIT_CODES.MODULE_TIMEOUT,
+      ACL_DENIED: EXIT_CODES.ACL_DENIED
+    };
+    if (code && code in codeMap) {
+      return codeMap[code];
+    }
+  }
+  return EXIT_CODES.MODULE_EXECUTE_ERROR;
+}
+var ApprovalTimeoutError, AuthenticationError, ConfigDecryptionError, ModuleExecutionError, ApprovalDeniedError, SchemaValidationError, ModuleNotFoundError, EXIT_CODES;
+var init_errors = __esm({
+  "src/errors.ts"() {
+    "use strict";
+    init_esm_shims();
+    ApprovalTimeoutError = class extends Error {
+      constructor(message = "Approval timed out") {
+        super(message);
+        this.name = "ApprovalTimeoutError";
+      }
+    };
+    AuthenticationError = class extends Error {
+      constructor(message = "Authentication failed") {
+        super(message);
+        this.name = "AuthenticationError";
+      }
+    };
+    ConfigDecryptionError = class extends Error {
+      constructor(message = "Config decryption failed") {
+        super(message);
+        this.name = "ConfigDecryptionError";
+      }
+    };
+    ModuleExecutionError = class extends Error {
+      constructor(message = "Module execution failed") {
+        super(message);
+        this.name = "ModuleExecutionError";
+      }
+    };
+    ApprovalDeniedError = class extends Error {
+      constructor(message = "Approval denied") {
+        super(message);
+        this.name = "ApprovalDeniedError";
+      }
+    };
+    SchemaValidationError = class extends Error {
+      constructor(message = "Schema validation failed") {
+        super(message);
+        this.name = "SchemaValidationError";
+      }
+    };
+    ModuleNotFoundError = class extends Error {
+      constructor(message = "Module not found") {
+        super(message);
+        this.name = "ModuleNotFoundError";
+      }
+    };
+    EXIT_CODES = {
+      SUCCESS: 0,
+      MODULE_EXECUTE_ERROR: 1,
+      MODULE_TIMEOUT: 1,
+      INVALID_CLI_INPUT: 2,
+      MODULE_NOT_FOUND: 44,
+      MODULE_LOAD_ERROR: 44,
+      MODULE_DISABLED: 44,
+      SCHEMA_VALIDATION_ERROR: 45,
+      APPROVAL_DENIED: 46,
+      APPROVAL_TIMEOUT: 46,
+      CONFIG_NOT_FOUND: 47,
+      CONFIG_INVALID: 47,
+      SCHEMA_CIRCULAR_REF: 48,
+      ACL_DENIED: 77,
+      KEYBOARD_INTERRUPT: 130
+    };
+  }
+});
+
+// bin/apcore-cli.ts
+init_esm_shims();
+
+// src/main.ts
+init_esm_shims();
+init_errors();
+import { readFileSync } from "fs";
+import { fileURLToPath as fileURLToPath2 } from "url";
+import * as path2 from "path";
+import { Command, CommanderError } from "commander";
+
+// src/ref-resolver.ts
+init_esm_shims();
+init_errors();
+
+// src/schema-parser.ts
+init_esm_shims();
+init_errors();
+
+// src/approval.ts
+init_esm_shims();
+init_errors();
+import * as readline from "readline";
+
+// src/output.ts
+init_esm_shims();
+
+// src/logger.ts
+init_esm_shims();
+var LEVELS = { DEBUG: 0, INFO: 1, WARNING: 2, ERROR: 3 };
+var currentLevel = "WARNING";
+function setLogLevel(level) {
+  const upper = level.toUpperCase();
+  if (upper in LEVELS) {
+    currentLevel = upper;
+  }
+}
+
+// src/main.ts
+var __dirname2 = path2.dirname(fileURLToPath2(import.meta.url));
+var pkg = JSON.parse(readFileSync(path2.resolve(__dirname2, "../package.json"), "utf-8"));
+var VERSION = pkg.version;
+function createCli(extensionsDir, progName) {
+  const resolvedProgName = progName ?? path2.basename(process.argv[1] ?? "apcore-cli") ?? "apcore-cli";
+  const cliLogLevel = process.env.APCORE_CLI_LOGGING_LEVEL ?? process.env.APCORE_LOGGING_LEVEL ?? "WARNING";
+  setLogLevel(cliLogLevel);
+  const program = new Command(resolvedProgName).exitOverride().version(VERSION, "--version", `Show ${resolvedProgName} version`).description("apcore CLI \u2014 execute apcore modules from the command line").option("--extensions-dir <path>", "Path to extensions directory").option("--log-level <level>", "Logging level (DEBUG|INFO|WARNING|ERROR)", "WARNING");
+  void extensionsDir;
+  return program;
+}
+function main(progName) {
+  const program = createCli(void 0, progName);
+  try {
+    program.parse(process.argv);
+  } catch (error) {
+    if (error instanceof CommanderError) {
+      process.exit(error.exitCode);
+    }
+    const code = exitCodeForError(error);
+    if (error instanceof Error) {
+      process.stderr.write(`Error: ${error.message}
+`);
+    }
+    process.exit(code);
+  }
+}
+
+// bin/apcore-cli.ts
+main("apcore-cli");
+//# sourceMappingURL=apcore-cli.js.map