apcore-cli 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -5,6 +5,45 @@ All notable changes to apcore-cli (TypeScript SDK) will be documented in this fi
 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.6.0] - 2026-04-06
+
+### Changed
+
+- **Dependency bump**: requires `apcore-js >= 0.17.1` (was `>= 0.15.1`). Adds Execution Pipeline Strategy, Config Bus enhancements, Pipeline v2 declarative step metadata, `minimal` strategy preset.
+- **Schema parser**: Required schema properties now correctly enforced at Commander option level (was silently optional).
+- `checkApproval()` now accepts `timeout` parameter instead of hardcoded 60s.
+
+### Added
+
+- **FE-11: Usability Enhancements** — 11 new capabilities:
+  - `--dry-run` preflight mode. Standalone `validate` command via `registerValidateCommand()`.
+  - System management commands: `health`, `usage`, `enable`, `disable`, `reload`, `config get`/`config set` in `system-cmd.ts`. Graceful no-op when system modules unavailable.
+  - Enhanced error output: `emitErrorJson()` / `emitErrorTty()` with structured guidance fields.
+  - `--trace` pipeline visualization.
+  - `CliApprovalHandler` class implementing apcore `ApprovalHandler` protocol. `--approval-timeout`, `--approval-token` flags.
+  - `--stream` JSONL output.
+  - Enhanced `list` command: `--search`, `--status`, `--annotation`, `--sort`, `--reverse`, `--deprecated`, `--deps`, `--flat`.
+  - `--strategy` selection: `standard`, `internal`, `testing`, `performance`, `minimal`. `describe-pipeline` command in `strategy.ts`.
+  - Output format extensions: `--format csv|yaml|jsonl`, `--fields` dot-path field selection.
+  - Multi-level grouping: `groupDepth` parameter in `resolveGroup()`.
+  - Custom command extension: `CreateCliOptions.extraCommands` with collision detection.
+- `Executor` interface extended with optional `validate()`, `callWithTrace()`, `stream()`, `call()` methods.
+- `PreflightResult`, `PreflightCheck`, `PipelineTrace`, `PipelineTraceStep` types exported.
+- New error code: `CONFIG_ENV_MAP_CONFLICT` in `EXIT_CODES`.
+- Config defaults: `cli.approval_timeout` (60), `cli.strategy` ("standard"), `cli.group_depth` (1).
+- New files: `system-cmd.ts`, `strategy.ts`.
+
+---
+
+## [0.5.1] - 2026-04-03
+
+### Added
+- **Pre-populated registry support** — `createCli()` accepts a `CreateCliOptions` object with optional `registry` and `executor` fields. When a pre-populated `Registry` is provided, filesystem discovery is skipped entirely. This enables frameworks that register modules at runtime to generate CLI commands from their existing registry without requiring an extensions directory.
+- `CreateCliOptions` interface exported from package index.
+- Passing `executor` without `registry` throws an error.
+
+---
+
 ## [0.4.0] - 2026-03-29
 
 ### Added

package/README.md

@@ -73,11 +73,28 @@ All modules are auto-discovered. CLI flags are auto-generated from each module's
 ```typescript
 import { createCli } from "apcore-cli";
 
-// Build the CLI from your registry
+// Build the CLI from an extensions directory (auto-discovers modules)
 const cli = createCli("./extensions");
 cli.parse(process.argv);
 ```
 
+#### Pre-populated registry
+
+Frameworks that register modules at runtime can pass a pre-populated `Registry` directly via `CreateCliOptions`, skipping filesystem discovery entirely:
+
+```typescript
+import { createCli } from "apcore-cli";
+import type { CreateCliOptions } from "apcore-cli";
+
+// registry and executor are already populated by your framework
+const cli = createCli({
+  registry,
+  executor,
+  progName: "myapp",
+});
+cli.parse(process.argv);
+```
+
 Or use the `LazyModuleGroup` directly with Commander:
 
 ```typescript
@@ -277,6 +294,8 @@ apcore Registry + Executor (your modules, unchanged)
 
 **Classes:** `LazyModuleGroup`, `ConfigResolver`, `AuthProvider`, `ConfigEncryptor`, `AuditLogger`, `Sandbox`
 
+**Interfaces:** `CreateCliOptions`, `Registry`, `Executor`, `ModuleDescriptor`
+
 **Functions:** `createCli`, `main`, `buildModuleCommand`, `validateModuleId`, `collectInput`, `schemaToCliOptions`, `reconvertEnumValues`, `resolveRefs`, `checkApproval`, `resolveFormat`, `formatModuleList`, `formatModuleDetail`, `formatExecResult`, `registerDiscoveryCommands`, `registerShellCommands`, `setAuditLogger`, `getAuditLogger`, `setVerboseHelp`, `setDocsUrl`, `buildProgramManPage`, `configureManHelp`, `exitCodeForError`, `mapType`, `extractHelp`, `truncate`
 
 **Errors:** `ApprovalTimeoutError`, `ApprovalDeniedError`, `AuthenticationError`, `ConfigDecryptionError`, `ModuleExecutionError`, `ModuleNotFoundError`, `SchemaValidationError`