Skip to content

Commit b66bc1b

Browse files
committed
chore: upgrade apcore dependency to 0.17.1 and implement usability enhancements including dry-run, system management, and pipeline tracing.
1 parent fc81fbc commit b66bc1b

7 files changed

Lines changed: 1550 additions & 93 deletions

File tree

CHANGELOG.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,43 @@ All notable changes to the apcore-cli specification will be documented in this f
44

55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
66

7+
## [0.6.0] - 2026-04-06
8+
9+
### Changed
10+
11+
- **Dependency bump**: requires `apcore >= 0.17.1` (was `>= 0.15.1`). Incorporates three apcore releases:
12+
- **apcore 0.16.0**: Execution Pipeline Strategy (`ExecutionStrategy`, `PipelineEngine`, `PipelineTrace`, 11 built-in steps, preset strategies), `Executor.strategy` parameter, `call_with_trace()` / `call_async_with_trace()`, Config Bus enhancements (`env_style`, `max_depth`, `env_prefix` auto-derivation, `env_map`), `ContextKey<T>` typed accessors, `ModuleAnnotations.extra` field, ACL condition handlers (`register_condition()`, `$or`/`$not`, `async_check()`).
13+
- **apcore 0.17.0**: Pipeline v2 declarative step metadata (`match_modules`, `ignore_errors`, `pure`, `timeout_ms`), `PipelineContext.dry_run` / `version_hint` / `executed_middlewares`, `StepTrace.skip_reason`, `safety_check``call_chain_guard` rename, pipeline step reorder (middleware_before now executes before input_validation), YAML pipeline configuration.
14+
- **apcore 0.17.1**: `minimal` execution strategy preset (4-step pipeline), `requires`/`provides` step dependency metadata.
15+
- Updated SRS, Tech Design, Project Manifest, and feature spec to reflect `apcore >= 0.17.1` dependency.
16+
- Updated ADR-03 (Executor Integration) to document optional `strategy` parameter and `call_with_trace()` availability.
17+
- Updated SRS Execution Constraint to reference the standard 11-step pipeline and custom `ExecutionStrategy` support via pre-configured Executor.
18+
19+
### Added
20+
21+
- **FE-11: Usability Enhancements** — 11 new capabilities implemented across Python, TypeScript, and Rust SDKs:
22+
- **`--dry-run` preflight mode** (§3.1) — Validates module call without executing via `Executor.validate()`. Standalone `validate` command also added.
23+
- **System management commands** (§3.2) — `health`, `usage`, `enable`, `disable`, `reload`, `config get`/`config set`. Delegates to `system.*` modules; graceful no-op when unavailable.
24+
- **Enhanced error output** (§3.3) — Structured JSON errors with `ai_guidance`, `suggestion`, `retryable`, `user_fixable`, `details`. TTY mode shows suggestion and retryable; JSON mode includes all fields.
25+
- **`--trace` pipeline visualization** (§3.4) — Displays per-step execution trace via `call_with_trace()`.
26+
- **ApprovalHandler integration** (§3.5) — `--approval-timeout` (configurable), `--approval-token` (async resume). `CliApprovalHandler` class wraps TTY prompt as standard `ApprovalHandler` protocol.
27+
- **`--stream` output** (§3.6) — JSONL streaming via `Executor.stream()` for modules with `annotations.streaming=true`.
28+
- **Enhanced `list` command** (§3.7) — `--search`, `--status`, `--annotation`, `--sort`, `--reverse`, `--deprecated`, `--deps` filters.
29+
- **`--strategy` selection** (§3.8) — Choose execution pipeline: `standard`, `internal`, `testing`, `performance`, `minimal`. New `describe-pipeline` command.
30+
- **Output format extensions** (§3.9) — `--format csv|yaml|jsonl` and `--fields` for dot-path field selection.
31+
- **Multi-level grouping** (§3.10) — `cli.group_depth` config (default: 1, max: 3).
32+
- **Custom command extension point** (§3.11) — `create_cli(extra_commands=[...])` for downstream projects.
33+
- **New error code**: Handle `CONFIG_ENV_MAP_CONFLICT` from apcore 0.16.0.
34+
- New config keys: `cli.approval_timeout` (60), `cli.strategy` ("standard"), `cli.group_depth` (1).
35+
- New environment variables: `APCORE_CLI_APPROVAL_TIMEOUT`, `APCORE_CLI_STRATEGY`, `APCORE_CLI_GROUP_DEPTH`.
36+
37+
### Fixed
38+
39+
- **Schema parser**: Required schema properties now correctly enforced at CLI level (was silently optional).
40+
- **Approval gate**: Fixed inverted logic in annotation type guard that could crash on malformed annotations.
41+
42+
---
43+
744
## [0.5.1] - 2026-04-03
845

946
### Added

0 commit comments

Comments
 (0)