feat: Implement unified configuration for Executor and Registry, enhance Executor's preflight checks and call methods, and introduce new client, system module, and event APIs.

Author: tercel

CHANGELOG.md

@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.7.0] - 2026-03-09
+
+### Added
+
+#### Documentation — New Files
+- **APCore Client API** (`docs/api/client-api.md`) — Full API reference for the unified `APCore` client covering 19 public methods: `call`, `call_async`, `stream`, `validate`, `module`, `register`, `discover`, `list_modules`, `describe`, `use`, `use_before`, `use_after`, `remove`, `on`, `off`, `disable`, `enable`, plus `events` property and global `apcore.*` entry points
+- **Event System** (`docs/features/event-system.md`) — `EventEmitter`, `ApCoreEvent`, `EventSubscriber` protocol, `WebhookSubscriber` (retry strategy), `A2ASubscriber` (auth modes), subscriber type factory registry, event types table, and YAML configuration reference
+- **System Modules** (`docs/features/system-modules.md`) — Complete reference for 10 built-in `system.*` modules with input/output schemas: `system.health.summary`, `system.health.module`, `system.manifest.module`, `system.manifest.full`, `system.usage.summary`, `system.usage.module`, `system.control.update_config`, `system.control.reload_module`, `system.control.toggle_feature`; plus `register_sys_modules()` setup guide and YAML configuration
+
+### Changed
+
+#### Documentation — Updated Files
+- **`docs/getting-started.md`** — Added §8 Global Entry Points (16 `apcore.*` module-level functions) and §9 System Modules quick start with health/usage/manifest examples
+- **`docs/api/executor-api.md`** — `validate()` return type updated from `ValidationResult` to `PreflightResult` with 6-check breakdown and `requires_approval` flag; `call()`/`call_async()`/`stream()` signatures updated with `version_hint` parameter; added `ModuleDisabledError`, `ModuleTimeoutError`, `ReloadFailedError`, `FeatureNotImplementedError`, `DependencyNotFoundError` to error types; timeout section rewritten for dual-timeout model with cooperative cancellation (`CancelToken` + 5s grace period)
+- **`docs/api/registry-api.md`** — Added `disable()`/`enable()` module toggle, `safe_unregister()` with cooperative drain (Algorithm A21), `acquire()` context manager, `is_draining()`, `describe()` for AI/LLM tool discovery, `negotiate_version()` (Algorithm A14)
+- **`docs/features/observability.md`** — Added three subsystems: `ErrorHistory` (ring buffer with deduplication, `ErrorEntry` dataclass), `UsageCollector` (hourly bucketed storage, trend computation, `UsageMiddleware`), `PlatformNotifyMiddleware` (threshold-based alerting with hysteresis)
+- **`docs/guides/middleware.md`** — Replaced hand-written `RetryMiddleware` example with built-in `RetryMiddleware` + `RetryConfig` reference (exponential/fixed backoff, jitter, retryable-only); added §5.5–5.7 cross-references for `ErrorHistoryMiddleware`, `UsageMiddleware`, `PlatformNotifyMiddleware`
+- **`docs/features/schema-system.md`** — Added `SchemaStrategy` enum (`yaml_first`, `native_first`, `yaml_only`) and `ExportProfile` enum (`mcp`, `openai`, `anthropic`, `generic`)
+- **`docs/features/core-executor.md`** — Added dual-timeout model (global deadline + per-module), cooperative cancellation with `CancelToken`, deep merge for streaming (depth cap 32), error propagation via `propagate_error()` (Algorithm A11), `PreflightResult` validation
+- **`docs/README.md`** — Added `client-api.md`, `event-system.md`, `system-modules.md` to directory tree, API reference table, feature specifications table, and concept index
+
+---
+
 ## [0.6.0] - 2026-03-07
 
 ### Added

README.md

@@ -996,6 +996,7 @@ Development guide: see [Adapter Development Guide](./docs/guides/adapter-develop
 
 | Document | Description |
 |------|------|
+| [APCore Client](./docs/api/client-api.md) | High-level client API (recommended entry point) |
 | [Module Interface](./docs/api/module-interface.md) | Module interface definition |
 | [Context Object](./docs/api/context-object.md) | Execution context |
 | [Registry API](./docs/api/registry-api.md) | Registry API |
@@ -1013,6 +1014,8 @@ Development guide: see [Adapter Development Guide](./docs/guides/adapter-develop
 | [Registry System](./docs/features/registry-system.md) | Module discovery, registration, and querying |
 | [Schema System](./docs/features/schema-system.md) | Schema loading, validation, `$ref` resolution, and export |
 | [Approval System](./docs/features/approval-system.md) | Runtime enforcement of `requires_approval` via pluggable ApprovalHandler |
+| [Event System](./docs/features/event-system.md) | Event emission, subscription, delivery lifecycle |
+| [System Modules](./docs/features/system-modules.md) | Built-in system.* modules for health, manifest, usage, control |
 
 ### Usage Guides
 

docs/README.md

@@ -14,6 +14,7 @@ docs/
 ├── concepts.md                        ← Design philosophy & core concepts
 ├── architecture.md                    ← Framework technical architecture
 ├── api/                               ← API reference (authoritative definitions)
+│   ├── client-api.md                  ← APCore unified client
 │   ├── module-interface.md            ← Module base class interface
 │   ├── context-object.md              ← Context execution context
 │   ├── registry-api.md                ← Registry center
@@ -25,6 +26,8 @@ docs/
 │   ├── decorator-bindings.md          ← Decorator and YAML Bindings
 │   ├── middleware-system.md           ← Middleware System
 │   ├── observability.md               ← Observability System
+│   ├── event-system.md                ← Event System
+│   ├── system-modules.md              ← System Modules (AI Introspection)
 │   ├── registry-system.md             ← Module Registry and Discovery System
 │   └── schema-system.md              ← Schema System
 ├── guides/                            ← Usage guides (7 articles)
@@ -58,6 +61,7 @@ Core interface definitions for the module system, including complete API documen
 
 | API Document | Description |
 |--------------|-------------|
+| [APCore Client](./api/client-api.md) | Unified client API (recommended entry point) |
 | [Module Interface](./api/module-interface.md) | Complete definition of the Module base class |
 | [Context Object](./api/context-object.md) | Complete definition of the execution context |
 | [Registry API](./api/registry-api.md) | Module registry center API |
@@ -75,6 +79,8 @@ Implementation-ready feature specifications for SDK developers. Each document de
 | [Decorator & YAML Bindings](./features/decorator-bindings.md) | `@module` decorator and YAML-based declarative module creation |
 | [Middleware System](./features/middleware-system.md) | Composable middleware pipeline with onion execution model |
 | [Observability](./features/observability.md) | Distributed tracing, metrics collection, and structured logging |
+| [Event System](./features/event-system.md) | Global event bus, subscribers, and threshold alerting |
+| [System Modules](./features/system-modules.md) | Built-in `system.*` modules for AI bidirectional introspection |
 | [Registry System](./features/registry-system.md) | Module discovery, registration, and querying with 8-step pipeline |
 | [Schema System](./features/schema-system.md) | Schema loading, validation, `$ref` resolution, and LLM export |
 
@@ -121,6 +127,7 @@ Quickly find authoritative definitions for concepts:
 
 | Concept | Authoritative Definition | Quick Reference |
 |---------|--------------------------|-----------------|
+| APCore Client | [client-api.md](./api/client-api.md) | [Getting Started](./getting-started.md) |
 | Module | [module-interface.md](./api/module-interface.md) | [README](../README.md#module-development) |
 | ModuleAnnotations | [module-interface.md#annotations](./api/module-interface.md#34-annotations) | [README](../README.md#schema-system) |
 | Context | [context-object.md](./api/context-object.md) | [README](../README.md#context-object) |