# Changelog

## [1.18.1] - 2026-05-26

### Summary

v1.18.1 是一次 patch 版本更新，聚焦于 **数据库并发稳定性** 和 **Worker 协议层重构**。引入全局 WriteMu 消除 SQLite 并发写入的 SQLITE_BUSY 错误，重构 Claude Code 协议类型到独立包并实现 OCS WorkerCommander（权限控制、Compact 死锁修复）。同时修复了多步 agentic turn 的 token 统计膨胀、Cron job 永久跳过、Slack 消息处理永久阻塞等稳定性问题。

### Changed

- **Worker**: Move Claude Code protocol types from `base` to `claudecode` package, resolving SOLID/DIP violation. Implement `WorkerCommander` for OCS with `allowed_tools` permission enforcement. (#484)
- **Worker**: Harden `Compact` with context guard and 30s secondary timeout, deprecate unprotected `Stdin()` in favor of `StdinLocked()`. (#484)
- **Worker**: Fix OCS `Clear` to propagate new session ID to SSE subscription, add `sync.Mutex` to `ServerCommander` preventing data race. (#484)
- **Gateway Core**: Introduce global `WriteMu` across all SQLite stores to serialize writes and eliminate SQLITE_BUSY errors under concurrent load. (#479)
- **Gateway Core**: Extract `WriteMu.WithLock()` DRY helper consolidating 16 nil-check-lock-unlock call sites. (#479)
- **Session**: Add `source` column for differentiated cleanup — cron sessions 24h, normal sessions 7d, with configurable retention. (#477)
- **Session**: `ContextFill` now reads only from `get_context_usage` control channel, eliminating 2-3x token inflation in multi-step agentic turns. (#477)
- **Cron**: Validate `platform` matches `PlatformKey` fields (feishu requires `chat_id`, slack requires `channel_id`). (#479)

### Fixed

- **Cron**: `finishExecution` now syncs `RunningAtMs=0` to in-memory state, preventing permanently skipped jobs after timeout or failure. (#488)
- **Worker**: `turns` table `created_at=0` caused by missing `Timestamp`/`Version` in mapper — switched to `events.NewEnvelope()`. (#485)
- **Worker**: OCS `handleStepStarted` ignoring `model` field, causing empty `model_usage` in turn stats. (#485)
- **Messaging/Slack**: `handlerMu` could be held indefinitely when OCS worker start hangs — added 120s context timeout with user feedback. (#481)
- **Gateway Core**: EventStore `Collector` flush/close ordering and double-release safety net. (#479)
- **Gateway Core**: PID file accumulation on worker crash path — `proc/manager.Wait()` now calls `untrackPID`. (#479)

## [1.18.0] - 2026-05-22

### Summary

v1.18.0 是一次 minor 版本更新，聚焦于 **认证架构简化** 和 **飞书交互增强**。移除 ES256 JWT 签名体系（~3800 行），替换为 API Key + Bot ID 双字段认证模型，降低部署复杂度并消除密钥管理负担。API Key 验证使用 `subtle.ConstantTimeCompare` 防止时序攻击，resolver 调用移至锁外避免阻塞。飞书 AskUserQuestion 新增 CardKit v2 按钮交互（copy_text 一键复制选项），支持多选题提示。

### Breaking Changes

#### 认证模型变更

- **移除 JWT (ES256) 认证**：不再支持 `Authorization: Bearer <jwt>` 头。所有客户端必须使用 `X-API-Key` 头传递 API key。(#467)
- **Bot ID 传输变更**：不再通过 JWT `bot_id` claim 传递。改为 `X-Bot-ID` HTTP 头或 `bot_id` query param。服务端通过 `security.BotIDFromRequest(r)` 提取。(#467)
- **浏览器 WebSocket 客户端**：init envelope 的 `auth.token` 字段语义从 JWT 变为 API key（deferred auth）。(#467)
- **环境变量**：`HOTPLEX_JWT_SECRET` 已移除。改用 `HOTPLEX_SECURITY_API_KEY_*` 编号式环境变量。(#467)
- **用户身份**：JWT `sub` claim 的自动 per-user 隔离不再可用。默认身份为 `api_user`。多用户隔离需配置 `APIKeyResolver`（`security.SetKeyResolver()`）将 API key 映射到用户身份。(#467)
- **`--strict` 标志**：`hotplex config validate --strict` 已移除（用于检查 JWT secret 是否设置，不再适用）。

#### SDK Breaking Changes

| SDK | 移除 | 替代 |
|-----|------|------|
| Go Client | `AuthToken()` option, `token.go`, `gen-token/` | `BotID()` option — 发送 `X-Bot-ID` 头 |
| Java Client | `JwtTokenGenerator`, `.tokenGenerator()`, jjwt/bcprov 依赖 | `.apiKey()` + `.botId()` — 发送 `X-Bot-ID` 头 |
| TypeScript Client | `generate-test-token.ts`, `jose` 依赖 | `authToken` 字段语义改为 API key（deferred browser auth） |
| Python Client | — | `auth_token` 参数语义改为 API key |

#### 配置 API 变更

- `config.Load(path, LoadOptions{})` → `config.Load(path)` — 移除 `LoadOptions` 和 `SecretsProvider` 管道。
- `config.NewWatcher(log, path, sp, store, ...)` → `config.NewWatcher(log, path, store, ...)` — 移除 `SecretsProvider` 参数。
- `security.NewAuthenticator(cfg, jwtValidator)` → `security.NewAuthenticator(cfg)` — 移除 JWT validator 参数。
- `security.BotIDFromHeader(r)` → `security.BotIDFromRequest(r)` — 重命名以反映同时读取 header 和 query param。

### Added

- **Messaging/Feishu**: AskUserQuestion CardKit v2 按钮交互 — `copy_text` action 元素替代 markdown 列表，用户点击按钮即可复制选项文本，支持多选题提示和编号回退列表。(#474)

### Changed

- **Security**: API Key 验证改用 `subtle.ConstantTimeCompare` 防止时序攻击（SEC-001）。(#476)
- **Security**: `AuthenticateRequest` 将 resolver 调用移到读锁外，避免外部网络调用阻塞（CONC-004）。(#476)
- **Security**: 移除 `cliProtectedVars` 中已废弃的 `GATEWAY_TOKEN` 条目，同步更新 Env-Whitelist 文档。(#476)
- **Security**: `BotIDFromRequest` 添加信任边界文档注释（SEC-003），明确 Bot ID 未与 API Key 密码学绑定的设计决策。(#476)

### Removed

- `internal/security/jwt.go` — JWT 验证器（ES256 签名、HKDF 密钥派生、JTI 黑名单）。(#467)
- `client/token.go` — Go SDK JWT token 生成。(#467)
- `client/scripts/gen-token/` — Go SDK token 生成命令行工具。(#467)
- `client/examples/08_token_generator/` — Go SDK token 生成示例。(#467)
- `examples/typescript-client/scripts/generate-test-token.ts` — TS SDK JWT token 生成脚本。(#467)
- `examples/java-client/src/main/java/dev/hotplex/security/JwtTokenGenerator.java` — Java SDK JWT 生成器。(#467)
- `golang-jwt/jwt/v5` 依赖 — 不再需要。(#467)
- `jjwt-api/impl/jackson` + `bcprov-jdk18on` 依赖（Java SDK） — 不再需要。(#467)

### Fixed

- **Messaging/Feishu**: JSON 1.0/2.0 兼容性 — 交互卡片使用 JSON 1.0 以支持 `action` + `copy_text` 元素（JSON 2.0 不支持）。(#474)
- **Messaging/Feishu**: 选项文本经 `SanitizeText()` 清洗，防止注入。(#474)
- **SDK/Java**: `QuickStart.java` 变量名 `signingKey` 修正为 `apiKey`。(#476)
- **Docs**: `integration-patterns.md` SDK 伪代码更新为实际 API（`client.APIKey()`/`client.BotID()`）。(#476)

### Security

- API Key 恒定时间比较（`subtle.ConstantTimeCompare`），替代 `map[string]bool` lookup，消除时序攻击面。(#476)
- 移除 JWT JTI 黑名单 sweep goroutine 和 HKDF 密钥派生，减少攻击面和资源开销。(#467)

### Migration Guide

**1. 环境变量替换：**
```bash
# 旧（已移除）
export HOTPLEX_JWT_SECRET="$(openssl rand -base64 32)"

# 新
export HOTPLEX_SECURITY_API_KEY_1="your-api-key"
export HOTPLEX_ADMIN_TOKEN_1="your-admin-token"
```

**2. Go SDK 迁移：**
```go
// 旧
client.New(ctx, URL("ws://localhost:8888/ws"), WorkerType("claude_code"), AuthToken("jwt-token"))

// 新
client.New(ctx, URL("ws://localhost:8888/ws"), WorkerType("claude_code"), BotID("bot-123"))
```

**3. 多用户隔离：** 如果之前依赖 JWT `sub` 实现用户隔离，需在 Gateway 启动时配置 `APIKeyResolver`：
```go
auth.SetKeyResolver(security.NewChainResolver(dbResolver, configResolver))
```

**4. 浏览器 WebSocket：** init envelope 中 `auth.token` 从传 JWT 改为传 API key，`auth.bot_id` 保持不变。

## [1.17.0] - 2026-05-21

### Summary

v1.17.0 是一次 minor 版本更新，聚焦于 **Admin WebUI 全面升级** 和 **企业级多用户隔离**。Admin 面板新增 Gateway 重启 API、Sessions 页面重构（实时更新/搜索筛选/详情视图）、API Key 用户管理 WebUI、Login 帮助面板，并在 Chat UI 侧边栏底部集成 Admin 入口；安全层新增 APIKeyResolver 实现 API Key → 用户身份映射，激活完整的会话隔离链路（UUIDv5 session key、SEC-008 跨用户拒绝、per-user 配额）；CodexCLI Worker 修复审批死锁和竞态条件；飞书 SDK 升级至 v3.9.1 并完成交互卡片按钮规格设计。

### Added

- **Security**: APIKeyResolver for enterprise multi-user session isolation — ChainResolver (config → DB) maps API keys to user identities, activating UUIDv5 session keys, SEC-008 cross-user rejection, per-user SQL filtering, and PoolManager per-user quotas. Admin API CRUD for api_key_users table with cache coherence. (#468)
- **WebChat UI**: Admin WebUI overhaul — gateway restart endpoint (POST /admin/restart), sessions page with real-time updates/search/detail view, API Key user management page with create/edit/delete, login help accordion, admin dashboard enhancements with improved layout and stats. (#471, #473)
- **WebChat UI**: Admin entry in chat sidebar — styled admin dashboard link at sidebar footer with icon container, hover gold accent, and descriptive subtitle. (#473)
- **Messaging**: Add M/B units to FormatTokenCount for large token values — display as K/M/B suffixes with compact formatting, applied to both Go backend and webchat TS frontend. (#470)
- **Messaging**: Upgrade Lark SDK to v3.9.1 and add interactive card buttons spec — comprehensive spec for implementing card button callbacks across Feishu/Slack/WebChat, documenting SDK card handler limitation. (#466)

### Changed

- **Worker**: CodexCLI security hardening — extract timeout constants, fix sendEnvelope timer leak with time.NewTimer + Stop(), unify write-mu blocks into writeFrame(), remove personality double-default.

### Fixed

- **Worker**: CodexCLI approval deadlock — server-initiated JSON-RPC requests (approvals) were silently dropped; implement HandlePermissionResponse via RespondServerRequest, add approval method aliases. (#462)
- **Worker**: CodexCLI Input() TOCTOU race — move nil check into spawn(), enforce StartupTimeout, add 5s timeout for critical event sends, add doneCh-based lifecycle binding. (#462)
- **Messaging**: FormatTokenCount unit boundary rounding — 999999 now shows "1M" instead of "1000.0K", use threshold-based unit bumping and stale ".0" suffix cleanup.
- **Admin**: Routing, sessions UX, and login redirect loop — fix Next.js SPA directory-to-html resolution, correct admin URL default from 9090 to 9999, replace router.replace with window.location.replace to fix stale auth state.
- **Release**: Guard changelog extraction against regex bracket misparse — add line count sanity check for multi-version extraction detection.

## [1.16.0] - 2026-05-20

### Summary

v1.16.0 是一次 minor 版本更新，聚焦于 **第三 Worker 接入** 和 **管理后台**。新增 OpenAI Codex CLI Worker（exec + app-server 双模式），支持 GPT-5/o4 系列模型通过 Web/Slack/飞书使用；Agent Bot Management WebUI 提供完整的可视化管理（Bot CRUD、配置编辑、Prompt 预览、Session/Cron 管理）。EventStore 从 SQLite 视图升级为物化 turns 表（含 cache token 拆分），Claude Code input token 统计修复使其准确计入缓存 token（影响 35-60% 的用量数据）。

### Added

- **Worker**: Codex CLI Worker — third worker type supporting `codex exec --json` (one-shot) and `codex app-server` (persistent JSON-RPC) dual modes, with 11 TurnItem → AEP event mapping, lazy-start singleton process with ref counting and 30m idle drain. (#450)
- **WebChat UI**: Agent Bot Management WebUI — dashboard, bot list/detail/create/delete, agent config editor (SOUL/AGENTS/SKILLS/USER/MEMORY), system prompt preview, session management, cron management, and connection settings. (#453)
- **Admin API**: Bot config CRUD and agent config file management — `BotConfigProvider` adapter bridging admin API to messaging config, with scope hierarchy (`admin:write` → `admin:read` → `config:read`). (#453)

### Changed

- **EventStore**: Replace turns views with materialized table — pre-computed turns table written at done/input time via Collector dual-channel, replacing expensive SQLite views (13+ json_extract per row + window functions). Breaking: `TurnRecord.ID string→int64`, `before_seq→before_id` API param, new `generation`/`turn_num`/cache token fields. (#456)
- **EventStore**: Buffer and aggregate reasoning events — extend delta accumulator pattern to reasoning chunks, reducing SQLite writes from N rows per reasoning block to 1 merged row. (#455)
- **Configuration**: Change events retention default from 7 to 30 days (168h → 720h). (#456)

### Fixed

- **Gateway Core**: Include cache tokens in Claude Code input token accounting — Anthropic API reports `input_tokens + cache_creation_input_tokens + cache_read_input_tokens` as separate fields; previously only `input_tokens` was counted, dropping ~35-60% of actual usage. (#456)
- **Worker**: OCS HTTP POST 30s timeout falsely reported "server unreachable" — split error classification into `isTimeoutError`/`isUnreachableError`, add dedicated 5min sendClient for input delivery. (#449)
- **Messaging**: CardKit empty flush triggering field validation error (99992402) — skip flush when content is empty but lastFlushed has content. (#449)
- **Messaging**: Messaging bridge event drop — swap `StartPlatformSession`/`JoinPlatformSession` call order so platform conn is registered before state transitions. (#449)
- **Worker**: Codex CLI app-server mode `appConn.Send` bypassed JSON-RPC by writing raw AEP to stdin — replaced with `ErrNotImplemented` fail-fast. (#458)

## [1.15.0] - 2026-05-18

### Summary

v1.15.0 是一次 minor 版本更新，聚焦于 **OCS V2 Converter 架构升级** 和 **Phrases 话术定制系统**。OCS Worker 引入独立 Converter 结构体替代 V1 消息解析，支持结构化权限/问答事件、reasoning 阶段检测、model/schema/variant 透传；Claude Code Worker 新增 4 项 Session Flags 映射（--continue/--fork-session/--resume-session-at/--settings）；飞书消息适配器完成 Welcome Card 可配置化和 Persona Phrases 系统；Slack 修复 Reasoning 状态映射。

### Added

- **Worker**: OCS V2 Converter architecture — standalone `Converter` struct with typed event parsing, per-session `turnState` tracking, and structured tool call/result conversion, replacing V1 `message.part.delta/updated` parsing. (#434)
- **Worker**: Structured permission/question events — direct `PermissionRequestData`/`QuestionRequestData` conversion replacing raw passthrough, with Feishu elicitation explicit accept/decline keywords. (#443)
- **Worker**: Reasoning phase detection — bracket `field="text"` deltas between reasoning lifecycle events to prevent inner monologue leakage in OCS 1.15+ unified `message.part.delta`. (#437)
- **Worker**: Model/JSONSchema/variant passing — bridge 6 capability gaps between OCS Worker and OpenCode Server (AllowedModels, JSONSchema, variant/reasoning effort, reasoning events, experimental event system, image modality). (#434)
- **Worker**: Claude Code session flags — map `ContinueSession`/`ForkSession`/`ResumeSessionAt`/`ConfigEnv` to `--continue`, `--fork-session`, `--resume-session-at`, `--settings` CLI flags. (#444)
- **Messaging**: Configurable welcome card via phrases — extract hardcoded capabilities, quick commands, and closing line into 3 phrase categories with per-bot customization. (#441)
- **Messaging**: Persona phrases — `persona` and `closings` categories for placeholder status lines and random sign-off on turn completion, with abort-path omission. (#438)

### Changed

- **Worker**: OCS singleton.go reduced by 244 lines — event dispatch fully delegated to V2 Converter with simplified SSE integration. (#434)
- **Messaging**: Chat access non-blocking — `handleChatEntered` no longer propagates errors, record failures logged as Warn instead of blocking user flow. (#442)

### Fixed

- **Worker**: Fix tool failure edge case — `isFailed=true` with nil Error now reports "tool failed" instead of silently falling through to success path. (#434)
- **Worker**: Fix cross-process turnState leak — add `Converter.Reset()` called in `startProcessLocked` to prevent stale state across process restarts. (#434)
- **Worker**: Fix data race on conn.variant/allowedModel — consolidate reads and writes under single `conn.mu` lock acquisition. (#434)
- **Messaging**: Fix Slack reasoning status — add `events.Reasoning` → `StatusThinking` mapping in `notifyStatusFromEvent`. (#442)

## [1.14.0] - 2026-05-15

### Summary

v1.14.0 是一次 minor 版本更新，聚焦于 **OCS Worker 生产就绪** 和 **零 CGO 构建**。OCS Worker 从单连接 SSE 升级为全局 EventBus 架构，新增指数退避重连、LastInput 崩溃恢复、HTTP 错误分类等关键能力，配合 4 项并发修复消除生产风险。SQLite 驱动统一为纯 Go 实现（modernc.org/sqlite），所有平台支持 `CGO_ENABLED=0` 构建，Linux arm64 不再需要交叉编译器。

### Added

- **Worker**: OCS SSE EventBus — singleton global SSE reader (`GET /global/event`) with per-session channel dispatch, replacing per-worker SSE connections. (#428)
- **Worker**: SSE reconnection with exponential backoff (500ms initial, 10s max, 20% jitter) and empty-stream detection to prevent CPU-burning tight loops. (#428)
- **Worker**: LastInput caching via `InputRecoverer` interface for bridge crash recovery re-delivery. (#428)
- **Worker**: HTTP error classification — server down / 502 / 503 mapped to typed `WorkerError(ErrKindUnavailable)` for gateway retry routing. (#428)
- **Messaging**: P2P chat entered event — welcome card on first/returning user entry for Feishu (`bot_p2p_chat_entered_v1`) and Slack (`app_home_opened`), with `ChatAccessStore` analytics (new/returning/active classification, 1h cooldown). (#427, #430)

### Changed

- **Infrastructure**: Consolidate to pure-Go SQLite driver (modernc.org/sqlite), removing mattn/go-sqlite3 CGO dependency — enables `CGO_ENABLED=0` across all build targets (Makefile, Dockerfile, release CI) and simplifies cross-compilation.
- **Eventstore**: Relax collector flush interval from 100ms to 1s and delta flush from 2s to 3s, reducing disk I/O overhead.
- **Gateway Core**: Remove per-event debug log in bridge forwarding to cut log volume under high throughput.

### Fixed

- **Worker**: Fix shared pointer mutation in `dispatchToAllSubscribers` — convert envelope inside the subscriber loop instead of reusing a shared pointer, which caused all subscribers to receive the last sessionID.
- **Messaging**: Skip cumulative `message.part.updated` text to prevent Feishu card duplication — cumulative text was appended as incremental delta, causing repeated text in streaming cards.
- **Worker**: Eliminate test data race on backoff package variables — replace `t.Cleanup` restore with deferred restore after goroutine exit.
- **Worker**: Prevent tight SSE reconnect loop on empty streams — only reset attempts after reading at least one data line; on empty EOF, apply exponential backoff.

## [1.13.2] - 2026-05-15

### Summary

v1.13.2 是一次 patch 更新，聚焦于 **消息体验增强** 和 **错误处理类型安全**。新增 Phrases 模块，将硬编码的 CLI 提示语和问候语提取为可配置、可扩展的消息池（权重随机 + 级联加载 + per-bot 个性化）；Worker 层引入类型化 `WorkerError` 替代脆弱的字符串匹配错误分类。

### Added

- **Messaging**: Phrases module — extract 28 CLI tips and 8 greetings from feishu placeholder into a shared, configurable message pool with weighted random selection (bot=4, global=2, platform=1), cascade-append loading, per-bot personalization, and B-channel skill manual. (#426)

### Changed

- **Worker**: Replace `strings.Contains` error classification with typed `WorkerError` + `Kind` enum — gateway uses `errors.As` for type-safe routing instead of fragile string matching. (#426)

## [1.13.1] - 2026-05-15

### Summary

v1.13.1 是一次 patch 更新，聚焦于 **架构健壮性与可观测性**。新增 per-bot 配置覆盖能力，支持多 Bot 场景下独立凭证与权限控制；Brain ConfigSpec 注册表消除 35+ 环境变量的静默降级；Gateway 新增 7 项 Prometheus 指标和 admin 审计日志；messaging/eventstore 层完成 DRY 重构减少约 140 行重复代码。

### Added

- **Config**: Per-bot configuration with platform-level fallback — override credentials, work directory, and access control per bot instance, with `${VAR}` env expansion fix. (#415)
- **Gateway Core**: 7 Prometheus metrics — session starts/errors/duration, init handshake latency, retry attempts/exhaustion, worker creation duration. (#417)
- **Admin API**: Structured audit logging for write operations + request-level middleware logging (method, path, status, duration, IP). (#417)

### Changed

- **Brain**: ConfigSpec registry (38 entries) replaces 35+ hardcoded `os.Getenv` calls with startup validation and structured warnings. (#420)
- **Service**: CommandRunner interface — 16+ `exec.Command` calls now injectable for testability. (#420)
- **Eventstore**: Extract `accumulateDelta`/`getOrCreateAccum` helpers, replace manual reverse with `slices.Reverse`, add dropped counter and `TurnQuerier` interface. (#419)
- **Messaging**: DRY — extract `createAndEnable` helper from streaming card lifecycle (~45 lines), shared interaction `SendResponse` factory + metadata builders (~96 lines). (#418)
- **Admin API**: Cron handler test coverage — 28 table-driven tests, 0% → covered. (#420)

### Fixed

- **Config**: Scope `.gitignore` `skills/` to repo root, update MessagingConfig comment. (#416)

## [1.13.0] - 2026-05-14

### Summary

v1.13.0 是一次 minor 版本更新，核心主题是 **多 Bot 支持** 和 **性能优化**。新增 Multi-Bot 架构，允许单个 Gateway 同时运行多个独立 Bot 实例（独立凭证、Soul、Worker 类型），完全向后兼容现有单 Bot 配置。同步引入 Brain/Session 锁优化（lock-dropping）降低锁竞争延迟，以及 Worker 接口去重简化适配器开发。

### Added

- **Messaging**: Multi-bot support — run multiple independent bot instances per platform (Slack/Feishu) with separate credentials, soul, worker type, and STT/TTS config. Backward compatible: single-bot configs auto-wrap into `bots[]` via `normalizeSlackBots`/`normalizeFeishuBots`. (#410)
- **Messaging**: `BotRegistry` — concurrent-safe runtime registry with Register/Unregister/Get/List/UpdateStatus/UnregisterAll lifecycle operations. (#410)
- **Admin API**: Bot status endpoints — `GET /admin/bots` lists all registered bots, `GET /admin/bots/{name}` returns single bot details. (#410)
- **CLI**: Multi-bot config diagnostic checker — validates credential completeness, bot count limits, and name uniqueness. (#410)
- **Config**: `SlackBotConfig`/`FeishuBotConfig` types with per-bot STT/TTS inheritance via `propagateBotDefaults`. (#410)

### Changed

- **Brain**: Lock-dropping optimization — memory compression and context pruning now release locks before expensive LLM calls, reducing contention on high-concurrency sessions. (#409)
- **Session**: `runningIndex` + terminated eviction + attach lock-dropping — O(1) active session lookup by key, automatic cleanup of terminated sessions, and non-blocking session attach. (#408)
- **Worker**: Deduplicate `ControlRequester` and `WorkerCommander` interfaces into unified `Controllable` interface, simplifying worker adapter implementation. (#406)
- **Cron**: Admin adapter DRY — extract shared adapter logic, add test coverage. (#409)

## [1.12.0] - 2026-05-13

### Summary

v1.12.0 是一次 minor 版本更新，聚焦于 **Gateway 运维可靠性**。新增 detached restart helper（Worker-initiated restart 独立 PGID 进程），解决 Worker 进程执行 gateway restart 时被连带杀死的长期问题。同步修复 JWT audience 类型匹配、admin CIDR 热重载和 cron trigger 配置路径解析三个 bug。

### Added

- **Gateway Core**: Detached restart helper — fork 独立 PGID 进程完成 `gateway restart --detached`，在 Gateway/Worker shutdown 后存活并重启。60s 冷却期防止重启循环，跨平台支持 Unix (Setpgid) / Windows (CREATE_NEW_PROCESS_GROUP)。 (#404)

### Fixed

- **Security**: JWT `hasAudience` 类型匹配 — type switch 改为匹配 `jwt.ClaimStrings`（named `[]string` type），修复 audience 验证始终失败的问题。 (#403)
- **Config**: Admin `allowed_cidrs` 热重载 — 新增 hot-reload callback，配置变更即时生效无需重启。 (#403)
- **Cron/CLI**: TriggerViaAdmin 配置路径解析 — 通过 gateway PID 文件定位实际 config path，修复 CLI 从不同目录运行时 `.env` 路径不匹配问题。 (#403)

## [1.11.4] - 2026-05-13

### Summary

v1.11.4 是一次 patch 更新，聚焦于 **Cron 迁移修复、投递身份和 Java SDK JWT 同步**。修复 Cron migration 005-008 的 SQLite 列序错位（4 个迁移合并为单一 005）；修复 Cron 飞书投递身份（`--as bot`）；同步 Java SDK JWT 密钥派生至 HKDF (RFC 5869) 与 Gateway 一致；更新 JWT 安全文档。

### Fixed

- **Cron**: Migration column order corruption — consolidating migrations 005-008 into a single 005 that creates the final schema directly, eliminating ALTER TABLE ADD COLUMN + SELECT * misalignment. Data fix script provided for existing deployments.
- **Cron**: Feishu delivery identity — executor adds `--as bot` to lark-cli command so cron results are sent as bot identity instead of user identity. (#402)
- **SDK/Java**: JWT key derivation synced to HKDF-SHA256 (RFC 5869) with info "hotplex-ecdsa-p256", matching Go gateway and Go client SDK. Previous direct-copy derivation produced incompatible keys, causing all Java-generated tokens to be rejected by v1.11.3+ gateways. (#402)

### ⚠️ Migration Notice (v1.11.0-v1.11.3 users)

If you deployed any version from v1.11.0 to v1.11.3, your `cron_jobs` table has corrupted column data. See `scripts/fix-cron-column-order.sh` for the one-time repair script.

## [1.11.3] - 2026-05-12

### Summary

v1.11.3 是一次 patch 更新，聚焦于 **Cron attached session**、**安全加固双批次** 和 **文档中心演进**。新增 attached session 支持定时注入现有会话（`--attach` CLI，`at:+N` 相对时间语法）；两个安全批次覆盖 config reflection panic、dead validators 激活、飞书 goroutine panic recovery、admin body size limit 等 11 项修复；文档中心新增 sidebar audience grouping、构建时 link validation、Java SDK 参考文档。

### Added

- **Cron**: Attached session — inject cron prompts into existing live sessions via `--attach` CLI flag. Supports state-based dispatch (Running→InjectInput, Idle→ResumeAndInput), auto-fills from `$GATEWAY_SESSION_ID`, cascade-deletes on session terminate. (#377)
- **Cron**: `at:+N` relative time syntax (min 1min, max 72h) for one-shot attached jobs with `--attach`. (#377)
- **Cron**: Prometheus metric `hotplex_cron_attached_total` for attached session dispatch tracking. (#377)
- **Admin**: `admin:write` scope added to default scopes for cron trigger authorization. (#393)
- **Docs**: Java SDK reference documentation (`docs/reference/sdk-java.md`). (#393)

### Fixed

- **Config**: Reflection panic on env-mapping typo — `setField`/`setBoolField`/`setSliceField` no longer panic on non-existent struct fields, return descriptive errors instead. Startup `Validate()` warns on misconfigurations (negative retention_period, zero max_size). (#390)
- **Security**: Dead validators activated — `ValidateTools` and `ValidateModel` enforced at init handshake, previously zero production callers. Defense-in-depth model validation in claudecode worker. (#386)
- **Security**: JWT key derivation upgraded to HKDF (RFC 5869) — Go Client SDK synchronized to match gateway implementation. (#391)
- **Security**: `GenerateToken`/`GenerateTokenWithJTI` auto-fill `aud` claim when audience configured. (#391)
- **Security**: `SanitizeArg` preserves non-ASCII characters (CJK/Emoji). (#391)
- **Admin**: Request body size limit (1MB) added to cron create/update handlers to prevent memory exhaustion. (#380)
- **Worker**: URL path escaping added to OCS question/elicitation handlers. (#388)
- **Messaging/Feishu**: Panic recovery added to 3 unprotected goroutine entries (sendTurnSummaryCard, TTS Process, ChatQueue.runWorker). (#378)
- **Brain**: Structured logging when SafetyGuard blocks threats — previously only incremented atomic counter. (#381)
- **Brain**: Configurable fail-closed policy (`FailClosedOnBrainError`) + `atomic.Pointer` for global singletons to eliminate data race. (#379)
- **Cron**: Double metric counting fixed, error path persist fix, migration 008 CHECK constraint two-step table replacement. (#377)

### Changed

- **Cron**: Rename `PayloadAgentTurn` → `PayloadIsolatedSession`, `agent_turn` → `isolated_session` in SQLite migration 008. (#377)
- **Cron**: Skill manual trimmed 24% — removed creator-unnecessary sections for tighter Agent consumption. (#377)
- **Config**: `setField`/`setBoolField`/`setSliceField` signatures changed from void to error return type. (#390)
- **Docs**: Sidebar audience grouping, last-modified timestamps, build-time link validation (zero broken links enforced), CI path expansion for docs changes. (#393)


## [1.11.2] - 2026-05-11

### Summary

v1.11.2 是一次 patch 更新，聚焦于 **Cron 执行器可靠性** 和 **飞书适配器代码健康**。修复 cron executor stdin 未关闭导致 `--print` 模式 worker 永久挂起的关键 bug，同时持久化 auto-disable 标志防止 `rebuildIndex` 重新启用已失败的 job。飞书适配器完成 SOLID 重构，将 1562 行 god file 拆分为 5 个职责明确的模块。

### Fixed

- **Cron**: Executor stdin EOF — close stdin after writing cron prompt so `--print` mode workers exit cleanly instead of hanging indefinitely. Persist auto-disable flag to SQLite so `rebuildIndex` does not re-enable failed jobs. (#372)
- **Worker**: Base conn `CloseStdin()` method for cross-worker stdin shutdown.

### Changed

- **Messaging/Feishu**: SOLID + DRY refactoring — split `adapter.go` (1562→353 lines) into `conn.go`, `handler.go`, `media.go`, `ws.go`. Extract 184-line `WriteCtx` dispatcher into per-event handlers, consolidate Lark IM API helpers to eliminate 4× duplication. (#370)

## [1.11.1] - 2026-05-11

### Summary

v1.11.1 是一次 patch 更新，聚焦于 **Cron 定时任务可靠性** 和 **WebSocket 连接稳定性**。核心改动包括：Cron 生命周期约束系统（防止无限执行、race condition 修复、mergeJobState 原子状态更新）、Cron executor 传递 job 实际 platform 以正确加载 agent 配置、WebSocket backpressure 优化（TryWriteMessage 防止慢客户端因 delta 丢弃而断连）。影响 Cron 调度器、Gateway Core 和 Agent Config 加载层。

### Added

- **Cron**: Lifecycle constraint system — recurring jobs require `max_runs` + `expires_at`, auto-default to max-runs=10 / expires-at=now+24h, auto-disable after 10 consecutive execution failures or 5 schedule errors. (#369)
- **Cron**: WorkDirResolver — platform-aware workdir resolution (explicit > platform-specific > worker default) via `config.ResolvePlatformWorkDir`.
- **Cron**: `mergeJobState` atomic state update — prevents executeJob goroutines from overwriting concurrent CLI state changes (e.g. disable).
- **Gateway Core**: TryWriteMessage — non-blocking write that silently drops droppable events (message.delta, raw) instead of disconnecting slow clients.

### Changed

- **Cron**: Executor passes job's actual platform (e.g. "feishu", "slack") to agent config loader instead of hardcoded "cron", enabling correct 3-tier config fallback (global → platform → bot).
- **Cron**: Session detection for env injection and MCP suppression switched from `platform == "cron"` to `platformKey["cron_job_id"]` presence check.
- **Cron**: Skill manual restructured with XML sections (`<critical_rules>`, `<intent_recognition>`, `<prompt_assembly>`, `<lifecycle_inference>`) for clearer Agent consumption.
- **Gateway Core**: Extract `bufferOrReject` helper to eliminate duplication between WriteMessage and TryWriteMessage closed-check + init-phase buffering.

## [1.11.0] - 2026-05-11

### Summary

v1.11.0 是一次 minor 版本更新，聚焦于 **文档门户基础设施和 MCP 配置治理**。新增静态文档门户（51 篇文档，go:embed + gateway 原生托管）、MCP 配置基础设施（cron 自动抑制 MCP 节省 ~600 MB/worker）、以及 WebChat/docs 启动 banner 的文档链接覆盖。同时修复 Slack 适配器在 Clone 重构后丢失工具信息的关键问题。

### Added

- **Docs Portal**: Static documentation portal — `cmd/build-docs` generates HTML from Markdown, `internal/docs` embeds and serves at `/docs/` route. 51 docs across guides, tutorials, reference, and explanation sections. (#367)
- **Worker**: MCP config infrastructure — user-configurable MCP server control and automatic MCP suppression for cron workers, saving ~600 MB per cron worker. `config.MCPServerConfig` validation, hot-reload via `atomic.Value`, and pre-serialized JSON injection. (#367)
- **WebChat UI**: Documentation links in three surfaces — header gold pill badge, sidebar footer, and welcome screen "Read Documentation" button.
- **CLI**: Startup banner now shows `Docs` line with gateway `/docs/` URL alongside Gateway/Admin/WebChat addresses.

### Changed

- **Docs**: Restructure docs directory — archive 20 legacy docs, delete 4 stale files, merge STT-SETUP into voice-features, consolidate assets. MISE audit fixed 126 issues (12 P0 + 56 P1 + 58 P2) including ghost CLI commands, phantom API endpoints, and hallucinated config fields.

### Fixed

- **Messaging/Slack**: Restore tool info in assistant status messages and turn summaries — `events.Clone` struct copy broke three type assertion paths (`ToolCallData`/`ToolResultData` pointer mismatch, `map[string]int` in `map[string]any` container, `float64` vs `int` in summary). Fix via `events.DecodeAs[T]` and `events.ToInt64`. (#364)
- **Gateway Core**: `extractDeltaContent`/`extractMessageContent` handle typed struct data from `Clone()` deep copy (was only handling `map[string]any`). (#368)

## [1.10.2] - 2026-05-10

### Summary

v1.10.2 是一次 patch 更新，修复 cron session 全局碰撞导致 100% 超时失败的关键 bug，同时包含 Gateway 热路径性能优化（handler 拆分、异步写管道消除 HOL 阻塞、Clone 3200x 提速）和 cron `--silent` 结构化字段替代文本前缀。

### Fixed

- **Cron**: Session key derivation ignored job ID — all cron jobs for the same owner/bot/workDir derived the same key, causing 100% timeout failures. Introduce CronNamespace UUIDv5 with per-execution isolation. (#362)
- **Gateway Core**: Head-of-line blocking — one slow WebSocket client could stall Hub broadcast for up to 10s. Per-conn writeCh (cap 64) decouples Hub.Run from write latency; slow clients are disconnected immediately. (#325)

### Changed

- **Gateway Core**: Split handler.go (852 lines) into 4 files by responsibility — handler.go, commands.go, worker_cmds.go, errors.go. Move EncodeJSON outside c.mu.Lock to reduce lock hold time. (#352)
- **Gateway Core**: Event.Clone() replaces JSON round-trip with struct copy — 3200x faster, 0 allocs for typed events; recursive deep copy for map[string]any nested values. Add CloneDeep() for full JSON independence. (#325)
- **Cron**: Promote `silent` from magic `[SILENT]` prompt prefix to structural `Silent bool` field — CLI `--silent` flag, YAML `silent: true`, Admin API support, `cron get` human-readable output. (#366)

## [1.10.1] - 2026-05-10

### Summary

v1.10.1 是一次 patch 更新，修复 CLI 创建的 cron job 因 `Platform` 硬编码为 `"cron"` 导致执行结果无法投递到 Slack/飞书的关键 bug。同时包含 Gateway 和 Messaging/Slack 模块的 DRY 重构。

### Fixed

- **CLI**: Cron job creation resolves target platform from env vars (`GATEWAY_PLATFORM`/`GATEWAY_CHANNEL_ID`/`GATEWAY_THREAD_ID`) and `--platform`/`--platform-key` flags, fixing silent delivery failure to Slack/Feishu. (#360)

### Changed

- **Messaging/Slack**: Extract `SlackAPI` interface for testability — adapter tests can mock Slack API calls without Socket Mode. (#361)
- **Messaging/Slack**: SOLID + DRY refactor — extract `WriteCtx` decomposition into `conn_events.go`, make `TTLCache` generic, deduplicate validator logic. (#356)
- **Gateway**: DRY refactor — extract Slack context injection, auth boilerplate, and workdir validation helpers. (#357)

## [1.10.0] - 2026-05-10

### Summary

v1.10.0 是一次 minor 版本更新，核心变更是 **AI-native Cronjob 调度器** 正式投产（SQLite 持久化、at/every/cron 三种调度、Slack/飞书结果投递、7 个 Admin API 端点 + CLI）。安全方面修复了 cron handler 缺失 scope 校验（任意认证请求可管理定时任务）、`mustGenerateJTI` 静默失败、updater 绕过注入的 HTTP client。可靠性方面修复了 Brain 模块多处 data race、Gateway crashTracker 无限增长、WebChat 双实例心跳异常、onboard 向导无限挂起。

### Added

- **Cron**: AI-native cronjob scheduler — timer-driven tick loop with at-most-once semantics, SQLite persistence via goose migration, three schedule types (at/every/cron with timezone), concurrency cap, graceful shutdown with running-job drain. (#340)
- **Cron/CLI**: `hotplex cron` subcommand — list/get/create/update/delete/trigger/history operations with direct SQLite CRUD and Admin API trigger.
- **Cron/Admin API**: 7 new endpoints — CRUD + trigger + run history for cron job management.
- **Cron/Metrics**: Prometheus counters — `cron_fires_total`, `cron_errors_total`, `cron_duration_seconds`.
- **Gateway**: Context env var injection (`GATEWAY_*`) for worker processes, normalizing Slack/Feishu platform differences.

### Changed

- **Admin API**: DI improvements — `startedAt` and `LogCollector` injected via `Deps` instead of package-level globals; `requireScope` helper eliminates duplicated scope-check boilerplate; `LogCollector.Recent` merged with `Total` to avoid double lock acquisition.
- **Worker/OCS**: DRY lifecycle helpers — extract `checkNotStarted`, `acquireServer`, `startSSE`, `release` to eliminate ~55 lines of duplicated Terminate/Kill/Start/Resume code. (#344)
- **Worker**: Unified grace period constant — `proc.DefaultGracePeriod` as canonical source, replacing three scattered 5s definitions. (#258)
- **Brain**: Replace `sync.Once` + direct assignment in `IntentRouter` with `atomic.Pointer` to eliminate dual-init data race. (#339)
- **Security**: DRY path getters — `GetAllowedBaseDirs`/`GetForbiddenWorkDirs` unified from platform-specific files to shared `path.go`.
- **Config**: Unexport field registries (`hotReloadableFields`/`staticFields`), remove dead `MustLoad`/`ReadFile` API. (#253)
- **Events**: Unexport `ValidTransitions` → `validTransitions`; callers use `IsValidTransition()`. (#252)
- **Service**: DRY unix helpers — extract `stopAndUnload` (darwin) and `writeServiceFile` (shared unix). (#263)

### Fixed

- **Security**: All 7 cron handler endpoints lacked scope validation — any authenticated request could create, delete, or trigger cron jobs. Read ops now require `admin:read`; write ops require `admin:write`. (#259, #353)
- **Security**: `mustGenerateJTI` silently returned empty string on `crypto/rand` failure instead of panicking. (#341, #353)
- **Security**: Cron admin token isolated from worker env — `HOTPLEX_ADMIN_TOKEN` only injected when `platform=="cron"`, preventing credential leak to all worker processes.
- **Admin API**: `clientIP` broke IPv6 bracketed addresses (`[::1]:8080`) — replaced `strings.Cut` with `net.SplitHostPort`. (#347)
- **Brain**: Data races in `IntentRouter` (`enabled` → `atomic.Bool`), `ContextCompressor` (`config.Enabled` → `atomic.Bool` reads), and `SafetyGuard` (`Close` → `sync.WaitGroup` for cleanup goroutine). (#346)
- **Gateway**: `crashTracker` entries never deleted — unbounded map growth on long-running gateways; `pendingError` silently lost when worker recv channel closed; state notification sends now log warnings on failure. (#345)
- **WebChat**: Duplicate `BrowserHotPlexClient` instances on re-render — useEffect guard disconnects lingering client before creating new one. (#334)
- **Updater**: `Download()` bypassed injected `u.Client` with hardcoded `http.Client`, making it untestable. Now uses `u.Client` with context deadline. (#251, #353)
- **Session**: Phantom `DeleteExpiredEvents` mock (method doesn't exist on interface) removed; `Kill()` error now logged in `DeletePhysical`. (#243, #353)
- **Cmd**: Onboard wizard hung indefinitely on closed stdin — replaced bare `context.Background()` with 5-minute timeout. (#245)
- **Cron**: Data races in Scheduler (`Clone+putJob`), Delivery (`sync.Mutex`), `executeJob` context propagation; at-schedule busy-loop debounce when concurrency cap hit; `persistCtx` context leak fixed.

### Security

- Cron handler endpoints now enforce JWT scope checks (admin:read / admin:write). Previously any valid token could manage cron jobs. (#259)
- Cron admin token isolated from generic worker environment to prevent credential exposure. (#340)

## [1.9.1] - 2026-05-10

### Summary

v1.9.1 是一次 patch 版本更新，聚焦于 **热路径性能优化** 和 **运维可观测性修复**。Worker stdio 热路径消除双重 JSON 解析（每 turn 省约 1000 次分配），SafetyGuard 采用 RLock 快路径 + lazy limiter eviction 防止内存无限增长。WebChat 新增 stop button 取消反馈动画，飞书修复 THINKING 反应泄漏，EventStore/AgentConfig 修复静默错误吞没。

### Added

- **WebChat UI**: Stop button shows spinner animation during 600ms cancellation window, giving clear visual feedback before send button appears.

### Changed

- **Worker**: Eliminate double JSON parse in claudecode `readOutput` hot path — single `json.Unmarshal` + reuse for type routing, control_response, and error extraction. Saves ~1000 allocs/turn. (#327)
- **Brain**: SafetyGuard uses `RLock` fast path for concurrent lookups and adds lazy limiter eviction — entries not seen within 1 hour are cleaned up when map exceeds 100 entries. (#328)
- **WebChat UI**: Remove ghost message pattern that caused `MessageRepository` ID collisions.

### Fixed

- **Messaging/Feishu**: THINKING reaction from silence timer was never cleaned up — both Typing and THINKING emojis accumulated on user messages.
- **EventStore**: `QueryTurnStats` silently skipped scan errors, returning partial or misleading results. Now logs warning with error details. (#293)
- **CLI**: `status` command hardcoded `http://` for health check URL, reporting "unreachable" when TLS is enabled. (#297)
- **Agent Config**: Config content exceeding 8KB/40KB limits was silently truncated with no indication — now logs warning with file name and size details. (#247)
- **CI**: Webchat build was skipped on cache miss when `build-webchat` was false, leaving `internal/webchat/out` absent and failing `go vet`.

## [1.9.0] - 2026-05-09

### Summary

v1.9.0 是一次 minor 版本更新，聚焦于 **跨平台工具格式化统一** 和 **消息通道稳定性**。核心变更是提取共享 `toolfmt` 包，消除飞书与 Slack 适配器约 360 行重复代码并统一工具调用/结果的 UX 呈现。飞书新增 streaming placeholder 卡片（消除了"黑洞"静默等待）和实时 tool activity strip，WebChat 获得 ErrorBoundary 防御上游 assistant-ui 崩溃、双层消息去重和完整的类型系统统一，Gateway Core 修复了多个并发缺陷（WritePump race、Bridge.accum 泄漏、端口冲突静默崩溃）。

### Added

- **Messaging**: Streaming placeholder card sent immediately on message receipt — eliminates perceived silence during worker processing, displays "⏳ 正在思考..." with in-place updates as content arrives.
- **Messaging/Feishu**: Tool activity strip in streaming cards — real-time emoji + short text display of tool calls with 2-entry scrolling window and CJK-aware visual truncation.
- **Messaging**: Shared `toolfmt` package for cross-platform tool formatting — `FormatCall`, `FormatResult`, `ShortenPath`, `TruncateRunes` with consistent UX across Feishu and Slack.
- **WebChat UI**: ErrorBoundary component to catch assistant-ui MessageRepository crash (#2380) with recovery UI.
- **WebChat UI**: Structured JSON logger replacing 15 console calls, connection state indicator (connected/connecting/disconnected) in thread footer.

### Changed

- **Messaging/Feishu**: Rich placeholder intros with randomized CLI tips covering slash commands, gateway lifecycle, service management, and multi-platform capabilities.
- **WebChat UI**: Unified `HotPlexMessage<P>` generic type, version synced from v1.1.0 to v1.8.1, all 10 `as-any` casts eliminated with typed accessors.
- **Messaging/Slack**: Removed per-tool formatter functions and unused `aepEventToStatus` helper, now uses shared `toolfmt` package.

### Fixed

- **Gateway Core**: WritePump panic recovery data race on `Conn.closed` — recovery defer now uses `c.Close()` for locking and idempotency. (#301)
- **Gateway Core**: Bridge.accum map grew without bound — entries now deleted in `cleanupCrashedWorker` on all worker exit paths. (#298)
- **Gateway Core**: Silent kill on port conflict — `ensureNotRunning()` check fails with clear message instead of silent crash.
- **Messaging/Feishu**: Streaming card lifecycle regression fixes — nil streamCtrl guard, flush loop lazy start via `sync.Once`, `PhaseCreationFailed` handling, concurrent card prevention, turn number preservation after TTL rotation, false-positive rate-limit warning on close.
- **Messaging/Slack**: `flushBuffer` rate-limit reordering — content extraction moved inside lock to prevent message reordering. (#299)
- **Messaging/Slack**: NativeStreamingWriter TOCTOU race, broken byte accounting from chunk prefixes, and fallback content loss. (#318)
- **WebChat UI**: Two-layer message dedup (exact ID + content-signature) and messageStart adoption of pending streaming messages for assistant-ui lifecycle consistency.
- **Admin API**: DB probe errors now logged and conditionally included in health response. (#292)
- **Client SDK**: Init rejection errors (e.g., auth failure) now propagated instead of silently ignored.

## [1.8.1] - 2026-05-09

### Summary

v1.8.1 是一次 patch 版本更新，聚焦于 **配置层 DRY 重构** 和 **STT/TTS 稳定性修复**。提取 `MessagingPlatformConfig` 共享结构体并引入消息层共享默认值（`FillFrom` 传播模式），将 Slack/Feishu 的 STT/TTS/WorkerType 配置统一声明一次。同时修复 STT 持久进程死锁、MOSS TTS idle monitor 死锁、ONNX 模型补丁过期、以及飞书卡片首次 turn 标题分支问题。新增 git 分支检测工具和 doctor TTS 诊断。

### Changed

- **Configuration**: Extract `MessagingPlatformConfig` embedded struct to deduplicate 9 shared fields between SlackConfig and FeishuConfig. (#316)
- **Configuration**: Introduce messaging-level shared defaults (WorkerType, STT, TTS) with `FillFrom()` zero-value propagation. Three-level priority: platform > messaging > Default().
- **Configuration**: Rename `TTSConfig.Enabled` → `TTSEnabled` to resolve Go struct embedding field shadowing.
- **Configuration**: Demote `dm_policy`/`group_policy` to platform-level only — no longer propagated from messaging level.

### Fixed

- **STT**: Resolve `PersistentSTT` deadlocks in `Transcribe`, `idleMonitor`, and `Close` — mutex contention caused goroutine hang on concurrent transcription requests.
- **TTS**: Resolve `MossProcess` `idleMonitor` deadlock and add active request check to prevent premature subprocess shutdown.
- **STT**: Fix ONNX model patch staleness — `fix_onnx_model.py` now patches the model in-place with SHA-256 verification, and `stt_server.py` validates patch before loading.
- **Messaging/Feishu**: Fix card header branch logic on first turn — branch name was incorrectly resolved when git context was not yet available.
- **Configuration**: Quote `STT_LOCAL_CMD` in `env.example` — unquoted values with spaces trigger `VAR=value command` shell semantics when `dev.sh` sources `.env`, causing the STT server to start eagerly on every `make dev`/`dev-stop`/`status` invocation.

### Added

- **Messaging**: Git branch detection utility for enriched card headers.

## [1.8.0] - 2026-05-09

### Summary

v1.8.0 是一次 minor 版本更新，聚焦于 **飞书卡片体验升级** 和 **Gateway 安全加固**。飞书适配器新增 CardKit v2 彩色标题栏（生成中/完成/取消/权限/提问/MCP 六色状态）、交互卡片消息解析、以及 enriched card headers（turn/model/branch/workdir 元数据标签）。Gateway Admin API 迁移到独立端口（9999）并加固中间件链。WebChat 移除 localStorage 缓存层，全面依赖服务端 SQLite 持久化。多语言 SDK 客户端统一重构。

### Added

- **Messaging/Feishu**: CardKit v2 header for all card types — color-coded title bars (wathet=generating, blue=done, grey=cancelled, orange=permission, yellow=question, violet=MCP) via unified card builder with streaming state machine. (#311)
- **Messaging/Feishu**: Interactive card message type support — parse `msg_type=interactive` with schema 1.0/2.0, extract text/div/markdown/note/column_set elements and embedded images.
- **Messaging/Feishu**: Enriched card headers with turn/model/branch/workdir metadata tags — progressive tag display during streaming, preserved across card lifecycle.
- **SDK**: Multi-language client SDK refactoring — Go client async API (`SendInputAsync`), Python transport reconnect, TypeScript backoff/errors modules, Java API updates. Fix reasoning content duplication in Worker parser.

### Changed

- **Messaging/Feishu**: Deduplicate bot API calls — merged `fetchBotOpenID` + `resolveBotName` into single `fetchBotInfo` (one API call instead of two).
- **WebChat**: Remove localStorage message cache — server SQLite is the authoritative persistence layer, eliminating cache-sync bugs (~150 LOC removed).
- **Gateway**: Admin API runs on dedicated address (default `localhost:9999`) with its own HTTP server instead of sharing gateway port. (#289)
- **Messaging/TTS**: `SharedSynthesizer` ref-counted sharing across Feishu/Slack adapters to avoid MOSS port conflict.
- **STT**: Enable INT8 quantization in stt_server.py (~400MB vs ~900MB), reduce idle TTL from 1h to 15m.

### Fixed

- **Gateway**: Admin server hardening — apply middleware chain (CORS, panic recovery, rate-limit, IP-whitelist, token auth), add ReadTimeout/WriteTimeout, parallel gateway+admin shutdown. (#289)
- **Gateway**: `serverErr` channel buffer increased 1→2 to prevent silent drop of concurrent goroutine failures; restore `cfg.Admin.Enabled` guard.
- **WebChat**: Ghost message orphan on `sendInput` failure — remove both user+ghost messages instead of only ghost. (#303)
- **WebChat**: Context-usage data silently discarded — inject into last assistant message parts instead of creating standalone message. (#303)
- **WebChat**: Missing permission/question/elicitation interaction handlers and response routing. (#303)
- **Messaging/Feishu**: Data races in streaming card `Close`/`Abort` — capture mutable state under mutex before use outside critical section.
- **Config**: JWT secret validation relaxed from `==32` to `>=32` bytes to fix doctor false-negative for valid non-32-byte secrets.
- **Config**: Warning log deduplication — JWT secret and normalize path warnings now emit once per process via `sync.Map`.
- **Dev**: Banner detection filters Go default log format (`log.Printf`) in addition to slog patterns.

## [1.7.2] - 2026-05-08

### Summary

v1.7.2 是一次 patch 版本更新，聚焦于 **TTS 管线可靠性与安全加固**。Edge TTS 原生实现替代了失效的第三方依赖，MOSS-TTS-Nano sidecar 替代 Kokoro-82M 提供本地 CPU 合成。安全方面修复了 SEC-008 session 劫持防护、跨 5 模块的 panic/data race/FD leak 问题。Worker 修复了 SDK tool_result 解析缺失，Slack 修复了流式表格重复渲染。

### Added

- **Messaging/TTS**: MOSS-TTS-Nano (Fudan/OpenMOSS) sidecar — Python FastAPI HTTP IPC with lazy start, idle timer, PGID isolation. Replaces Kokoro-82M ONNX (net -826 LOC). (#283)
- **Messaging/Feishu**: Card Header specification (v2.0) — header types, streaming state transitions, unified card builder design.

### Changed

- **Messaging/TTS**: Native Edge TTS implementation replaces broken `lib-x/edgetts` dependency — implements Microsoft's WS + token auth protocol directly. (#294, #295)
- **Messaging/TTS**: TTS summary prompt split into system/user levels; speech pipeline enhanced with Markdown sanitization and large number normalization.
- **Messaging/TTS**: Stream rotation TTL increased from 6min to 500s for Feishu and Slack adapters.
- **CLI/Onboard**: Wizard TTS dependency check validates MOSS-TTS-Nano requirements (python3 + model dir). (#283)

### Fixed

- **Security**: SEC-008 session hijack prevention — user ownership verification on WS reconnect; panic/data race/FD leak fixes across 5 modules (auth, JWT, dedup, proc, Slack event loop). (#288, #291)
- **Gateway**: Inbound event persistence now functional — Bridge wired into Handler for all message paths. (#288)
- **Gateway**: `ShouldRetry` data race — config patterns now snapshotted under mutex. (#288)
- **Session**: Store errors logged instead of silently swallowed; max-turns kill force-sets TERMINATED to prevent orphans. (#288)
- **Worker**: SDK `tool_result` payload parsing — tool results previously discarded producing empty events. (#287)
- **Messaging/Slack**: Streaming table duplication — simplified stop flow eliminates `block_mismatch` errors.
- **Messaging/TTS**: MOSS sidecar race conditions — PID cleanup on terminate, context propagation, mutex-protected activeWg. (#302)

### Security

- SEC-008: User ownership check on WebSocket session reconnect prevents session hijack when key collision occurs. (#288)
- Protected env vars (`HOME`, `CLAUDECODE`, `GATEWAY_TOKEN`) filtered from `.env` loading. (#291)

## [1.7.1] - 2026-05-08

### Summary

v1.7.1 是一次 patch 版本更新，聚焦于 **稳定性修复** 和 **TTS 体验优化**。修复了 Gateway 事件持久化缺失、Worker 进程资源泄漏、Admin API 数据竞争等 5 个生产级缺陷。新增 `ChatWithOptions` LLM 参数控制接口精准约束 TTS 摘要输出长度，TTS 默认启用语音回复并优化为 150 字符上限（~37s 音频）。Onboard 向导重构为 go:embed + YAML AST 单一数据源。

### Added

- **Brain**: `ChatWithOptions(ctx, prompt, opts)` interface — `MaxTokens` and `Temperature` (*float64, nil=default) thread through the entire decorator chain (retry → cache → rate limit → circuit → metrics → Brain wrapper). TTS callers use `SummaryChatOpts{MaxTokens: 256, Temperature: 0.3}`. (#282)
- **Messaging/TTS**: Voice replies enabled by default for voice-triggered turns; max_chars lowered to 150 (~37s audio) to fit Feishu's 60s voice cap. Shared summary prompt extracted to `tts/prompt.go`. (#282)
- **CLI/Onboard**: TTS dependency checker — validates ffmpeg and edge-tts availability with cross-platform install hints. (#282)

### Changed

- **CLI/Onboard**: Wizard config generation refactored from 314-line string builder to `go:embed` + YAML AST manipulation — `configs/config.yaml` is now the single source of truth. (#282)
- **Worker**: OCS `Wait()` now blocks with 2s grace window instead of immediate return, preventing silent zombie sessions after crash. Metadata dispatch unified into `base.InputMetadataHandler`. (#285)

### Fixed

- **Gateway**: Inbound events never stored — messaging envelopes constructed without Seq assignment, causing `v_turns` aggregation failure. Also capture interaction responses (permission/question/elicitation) as inbound events. (#275)
- **Worker**: `proc.Manager` resource leak — ctx.Done() path now calls `Kill()` instead of returning early; `cmd.Wait()` protected by `sync.Once` against concurrent calls. (#285, #269)
- **Admin**: Data race in rate limiter and CIDR allowlist (mutex-protected → `atomic.Value`); `HandleStats` returns 503 instead of 200+empty when session list fails. (#285, #272)
- **Skills**: `Locator.Close()` panic on double invocation — channel close protected by `sync.Once`. Goroutine leak on gateway shutdown — `Close()` added to shutdown sequence. (#279, #281)
- **Brain**: `ChatOptions.Temperature` changed from `float64` to `*float64` — supports explicit deterministic output (temp=0) without zero-value ambiguity. Cache key precision fixed (`strconv.FormatFloat` replaces `%.2f`). (#282)

## [1.7.0] - 2026-05-07

### Summary

v1.7.0 是一次 minor 版本更新，聚焦于 **LLM 编排能力** 和 **语音交互管道**。新增 Brain 模块作为 Gateway 内置的 LLM 编排层（支持 OpenAI/Anthropic 双协议，含重试/缓存/限流/熔断装饰器链），实现飞书和 Slack 双平台的 voice-in → voice-out 全链路管道（STT → Brain 摘要 → Edge TTS → Opus 编码 → 音频消息回传）。Agent Config 获得 Windows 命令注入防护和 XML 标签清洗，Brain 模块经过严格清理删除 ~2700 行死代码并修复 4 个并发安全缺陷。

### Added

- **Brain**: LLM orchestration module — lightweight Chat()/ChatStream() interface with OpenAI and Anthropic protocol support, decorator chain (retry → cache → rate limit → circuit breaker → metrics), model routing, and cost estimation. Fail-open design: missing API key = graceful degradation. (#273)
- **Messaging/Feishu**: TTS voice reply pipeline — voice input detected → Brain text summary → Edge TTS synthesis → FFmpeg MP3→Opus conversion → Feishu audio message upload. Configurable voice, max chars, and concurrency limiter. (#273)
- **Messaging/Slack**: TTS voice reply pipeline mirroring Feishu behavior — identical voice-triggered flow with Slack file upload integration. (#273)
- **Configuration**: Onboard wizard enhanced with environment-backed worker commands and contextual tips in generated config and .env files.

### Changed

- **Agent Config**: Windows command injection prevention — switch from inline `--append-system-prompt` to temporary file injection (`--append-system-prompt-file`) to avoid cmd.exe argument mangling.
- **Agent Config**: XML tag sanitization in system prompt builder — unreserved XML tags are HTML-escaped to prevent prompt injection through config files.
- **Agent Config**: META-COGNITION.md enhanced with P0–P4 decision tree, config modification SOP, and self-correction protocol. Moved to B-channel (directives) for higher authority.
- **Brain**: Simplified API key resolution to 3 clear priority levels — dedicated `HOTPLEX_BRAIN_*` env vars → worker config file extraction (`~/.claude/settings.json`) → system env vars (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`). Removed `PROVIDER_TYPE` concept.
- **Brain**: Removed ~2700 lines of dead code — 7 unused components (failover, priority, budget, health, observable, builder, presets), 3 dead interfaces, duplicate LLM client wrappers. Extracted shared helpers, promoted atomic counters, consolidated token estimation.

### Fixed

- **Brain**: 4 critical concurrency issues — ChatStream context cancel causing goroutine leaks, globalBrain unprotected concurrent access, Anthropic streaming goroutine leak on ctx cancellation, CachedClient silently swallowing json.Marshal errors. (#273)
- **Brain**: API key not wired to LLM client constructors — hardcoded empty string bypassed config resolution entirely.
- **Brain**: IntentRouter data race (int64 counters → atomic.Int64) and MetricsCollector nil panic on OTel instrument creation failure.
- **Messaging/TTS**: `voiceTriggered` data race (bool → atomic.Bool), TTS goroutine using platform writer's 30s context instead of independent 60s context, text truncation off-by-3.
- **Messaging/Feishu**: Content() extraction moved before Close() to prevent empty text on TTS pipeline, brain input truncated to 5× maxChars before LLM summary.
- **CLI**: Onboard wizard missing worker commands in generated config.yaml and .env files.

### Security

- **Agent Config**: Windows cmd.exe argument injection mitigated via temporary file-based prompt injection. Unreserved XML tags in agent configs are sanitized at prompt assembly time.

## [1.6.1] - 2026-05-06

### Summary

v1.6.1 是一次 patch 版本更新，聚焦于 **Worker 环境变量安全隔离重构**。将脆弱的 allow-by-default 白名单替换为 deny-by-default 黑名单，修复 Windows 平台因系统变量被过滤导致的 Worker 启动失败。新增 `HOTPLEX_WORKER_` 前缀剥离机制，让用户在 .env 中配置的密钥（如 `HOTPLEX_WORKER_GITHUB_TOKEN`）安全注入 Worker 子进程。清理了 735 行死代码，修复了 `allowed_envs` 配置项的语义反转 bug，并全面同步了文档和规格。

### Added

- **Worker**: `HOTPLEX_WORKER_` prefix stripping — secrets in .env prefixed with `HOTPLEX_WORKER_` are automatically stripped and injected into worker subprocess env (e.g., `HOTPLEX_WORKER_GITHUB_TOKEN` → `GITHUB_TOKEN`). Gateway-internal `HOTPLEX_*` vars are never exposed.
- **Messaging**: `turn_summary_enabled` config toggle to control whether turn summary messages are sent after each completed turn (default: true). (#223)

### Changed

- **Worker**: Environment variable filtering inverted from whitelist to blocklist — all `os.Environ()` vars pass through by default; only explicitly blocked entries are filtered. This fixes Windows compatibility where system vars (SystemRoot, ProgramFiles, etc.) were previously stripped. (307ae85)
- **Worker**: Blocklist entries ending with `_` are treated as prefix matches (e.g., `HOTPLEX_` blocks all `HOTPLEX_*` vars).
- **Worker**: `BuildEnv` optimized — single `os.Environ()` snapshot instead of 3 calls; Phase 7 reuses `setOrAppend` helper.
- **Messaging**: TurnSummary rendering deduplicated — extracted `Fields()` method consolidating field selection across Slack/Feishu paths. (#223)
- **Security**: Removed dead code — `SafeEnvBuilder`, `BuildWorkerEnv`, `IsSensitive`, `env_builder.go` (~735 lines). `base.BuildEnv` is now the sole env construction path.
- **Configuration**: Removed broken `allowed_envs` field (its entries were incorrectly merged into blocklist, blocking vars instead of allowing them). Use `env_blocklist` or `HOTPLEX_WORKER_` prefix instead.
- **Docs**: All documentation synchronized from whitelist to blocklist terminology — Env-Whitelist-Strategy rewritten as Blocklist Strategy, spec docs (SEC-030~036), config reference, and README updated.

## [1.6.0] - 2026-05-06

### Summary

v1.6.0 是一次 minor 版本更新，聚焦于 **Onboard 体验重构** 和 **Gateway 可靠性加固**。Onboard Wizard 经历全面改造：新增步骤注册表支持增量重跑、凭据校验、binary PATH 安装，并修复了安全默认值（localhost 绑定）和测试二进制覆盖 PATH 的严重 bug。Gateway Core 获得多层 panic recovery 和 FD leak 修复。Slack 适配器新增流式轮转消除 Stream expired 降级。Worker 新增 permission_prompt 可配置和 interaction chain 三个 P0 修复。

### Added

- **CLI**: Onboard wizard step registry with three run modes — full config, keep existing, and incremental step selection. (#203)
- **CLI**: Binary install step — auto-installs hotplex to PATH after onboard (SHA256 verification, cross-platform rc file config).
- **CLI**: Credential validation for Slack (xoxb-/xapp-) and Feishu (cli_) tokens during onboard input.
- **CLI**: Agent config template deployment during onboard with 3-level fallback documentation.
- **Worker**: `permission_prompt` config option under `worker.claude_code` to control `--permission-prompt-tool stdio`. (#201)
- **Worker**: `permission_auto_approve` list for silent tool approval (default: ExitPlanMode). (#201)
- **Messaging**: Slack stream rotation — proactive 6min wallclock rotation aligned with Feishu pattern, eliminating Stream expired fallback. (#211)

### Changed

- **Messaging**: Interaction chain hardening — close active stream writer before sending interaction events (Slack/Feishu), strip nested backticks from args preview, fallback candidate matching for lost request IDs. (#201)
- **Messaging**: Feishu permission text matching expanded vocabulary (added "同意", "ok", "好的", "确认", "取消" etc.).
- **Messaging**: Turn summary refactored — extracted clampContextPct/tokenPair helpers, renamed Timer field.
- **Gateway Core**: WritePump, Hub.Run, and bridge w.Wait goroutine all now have panic recovery with graceful cleanup. (#221)
- **Gateway Core**: handleInput returns error on worker failure instead of silent nil. (#221)
- **Worker**: Pi-mono adapter removed — was a stub with no real implementation, cleaned from 27 files.

### Fixed

- **CLI**: Onboard generated `gateway.addr: ":8888"` binding to 0.0.0.0 — now correctly uses `localhost:8888`. (#203)
- **CLI**: Onboard generated `db.busy_timeout: 500ms` — now matches code default of `5s`.
- **CLI**: Onboard `stepBinaryInstall` copied test binary to PATH during `go test` — added `.test` suffix guard.
- **CLI**: Onboard hallucination audit — corrected Feishu Open ID lookup instructions, hot reload claims, and STT URL.
- **Session**: Data race in `ListActive` — missing RLock on SessionInfo field reads. (#220)
- **Session**: Silent error swallow in `TransitionWithInput` max-turns cleanup and `scanSession` unmarshal. (#220)
- **Worker**: Panic in `readOutput` goroutine without recovery (claudecode adapter). (#220)
- **Worker**: FD leak — stdin/stdout/stderr file descriptors not closed after process exit. (#220)
- **Event Store**: Nil map panic in `Collector.Capture` after `Close()`. (#220)

## [1.5.4] - 2026-05-06

### Summary

v1.5.4 是一次 patch 版本更新，聚焦于 **交互系统安全加固与数据完整性**。修复交互管道两级数据丢失 bug（Question/Elicitation 字段丢失 + OwnerID 未持久化）形成的连锁失败链，飞书/Slack 双平台增加 OwnerID 验证防止群聊未授权操作。Worker stdin 写入统一为单 mutex 序列化防止 NDJSON 交错。同时修复 OCS 响应安全限制、turn summary 显示问题、config audit 内存增长等多项 bug。

### Added

- **Messaging/Slack**: Text-based interaction fallback — 当 Block Kit 按钮不可用时，用户可通过文本（"allow/deny/accept/decline \<requestID\>"）响应交互。(#197)
- **Messaging/Feishu**: Card 发送失败自动回退纯文本 — 与 Slack invalid_blocks fallback 对齐。(#197)

### Changed

- **Config**: STT 模式自动推断 — 移除 `stt_local_mode` 配置项，由 `stt_local_cmd` 中是否包含 `{file}` 占位符自动判断 ephemeral/persistent 模式。(#186)
- **Messaging**: Turn Summary 共享 helper 提取 — `FormatDurationParts`/`FormatTokenUsage` 统一至 turn_summary.go，消除飞书/Slack 重复格式化代码。(#194)
- **Messaging/Feishu**: Turn Summary 改用专用卡片格式，cooldown 检查使用 atomic CAS 消除 TOCTOU 竞态。(#194)
- **Client/SDK**: `decodeAs` 迁移至 `events.DecodeAs[T]` — 支持泛型类型透传，删除冗余测试。(#178)

### Fixed

- **Messaging**: 交互管道数据丢失 — `ExtractQuestionData`/`ExtractElicitationData` 在 `map[string]any` 分支丢失 `questions` 字段，改用 `events.DecodeAs[T]` 修复。(#195)
- **Session**: OwnerID 未持久化 — `upsert_session` SQL ON CONFLICT 不更新 `owner_id`，导致 session resume 后交互响应静默失败。(#196)
- **Gateway Core**: OwnerID 未注入 Worker 信封 — worker 发出的 permission/question/elicitation envelope 缺少 OwnerID，交互响应无法路由。(#191)
- **Gateway Core**: `handleCD` 路径提取错误 — `map[string]any` 分支读取 `d["path"]` 而非 `d["details"]["path"]`。(#197)
- **Gateway Core**: TruncatePath 显示误导 — 含隐藏目录的深路径截断显示 `/.hotplex/workspace` 而非 `~/.hotplex/workspace`，增加 home 目录替换。(#185)
- **Gateway Core**: Detached HEAD 显示空分支 — 改为显示短 commit hash。(#194)
- **Worker/OCS**: 4 处未限制的错误响应读取 — 添加 `io.LimitReader(resp.Body, 4096)` 防止 OOM，URL path segment 使用 `url.PathEscape` 防止注入。(#145)
- **Worker/ClaudeCode**: Stdin 写入交错 — `Conn.Send`/`SendUserMessage` 改为持锁写入，`ControlHandler` 共享同一 mutex 统一序列化。(#197)
- **Messaging**: CancelAll 后 timeout goroutine 复活 — 新增 `cancelCh` 机制，`CancelAll` 关闭 channel 停止 `watchTimeout`。(#197)
- **CLI**: `loadEnvFile` 重复写入 + 受保护变量过滤 — `.env` 重复 key 消除，跳过 HOME/PATH 等受保护变量。(#150)
- **Config**: Audit log 无限增长 — 添加 `maxAuditLen(256)` 上限，static callbacks 合并为单 goroutine 触发。(#146)

### Security

- **Messaging**: 飞书/Slack 交互响应 OwnerID 验证 — 飞书 `checkPendingInteraction` 增加 userID 参数，Slack `handleInteractionEvent` 改为 Get→验证→Complete 防止 TOCTOU 竞态。(#197)
- **Session**: Admin 所有权绕过增加审计日志 — 记录 admin_user_id、session_id、session_owner。(#143)

## [1.5.3] - 2026-05-05

### Summary

v1.5.3 是一次 patch 版本更新，聚焦于 **消息通道稳定性** 和 **EventStore 架构简化**。修复 Slack 流式输出死锁、消息静默丢弃、DM 线程丢失三个高频问题。EventStore 合并至共享数据库消除双文件运维负担，Turn Summary 统一为 Slack/飞书共享的多行卡片布局。同时修复安全路径穿越、Worker 控制请求映射、per-turn token 统计等多项 bug。

### Added

- **Gateway Core**: `GatewayEventsNoSubscribersDropped` Prometheus counter — 追踪因无订阅连接而静默丢弃的事件，提升消息丢失可观测性。(#182)
- **STT**: Auto-patch ONNX models — 首次加载时自动修补模型文件，添加 `.patched` marker 避免重复修补。(#182)
- **STT**: Audio STT failure fallback — STT 失败时下载音频到磁盘并提示 Worker 使用 `stt_once.py` 转录，防止音频内容静默丢失。(#182)

### Changed

- **EventStore**: Events 表合并至 session 共享数据库 — 新增 goose migration 002/003，`source` 列追踪事件来源（normal/crash/timeout/fresh_start），`v_turns` SQL VIEW 替代 ConversationStore。(#171)
- **Messaging**: Turn Summary 统一为 Slack/飞书共享的多行卡片布局 — 导出 `FormatDuration`/`FormatToolNames` 共享 helper，消除 47 行 Slack 重复代码。(#181)
- **Gateway Core**: Bridge 拆分 `captureEvent`/`CaptureInbound` 使用 `json.RawMessage` 减少重复序列化，`events.DecodeAs[T]` 泛型 helper 替代 6 处 map→struct JSON round-trip。(#176)
- **Slack**: Streaming start 使用首个 Write payload 作为初始内容，移除 "Thinking..." 占位符。(#182)

### Fixed

- **Slack**: `closeStreamWriter` 不可重入死锁 — `sync.Mutex` 持锁调用 `Close()` 触发 `onComplete` 回调再次获锁，导致所有后续 turn 永久阻塞。(#182)
- **Slack**: `flushBuffer` 在 `w.closed=true` 后跳过最终 flush — 移除 closed 检查，确保退出时缓冲内容完整发送。(#182)
- **Slack**: `appendWithRetry` 无限阻塞 — 添加 per-call 10s 超时防止 Slack API 无响应时 Close() 永久挂起。(#182)
- **Slack**: DM 流式输出失败 — `StartStreamContext` 缺少 `thread_ts` 和 `team_id` 导致 DM 消息 API 报错。(#174)
- **Slack**: Fallback PostMessage 缺少 `thread_ts` — 非流式回退消息发到 DM 顶层而非线程内。(#182)
- **Gateway Core**: `JoinPlatformSession` 死连接未检测 — `pcEntry` writeLoop 退出后事件仍被静默丢弃，新增 `select on done` 检测并替换。(#182)
- **Gateway Core**: Worker cold-start 计入 Turn 1 时长 — `turnStartTime` 改为 firstEvent 时重置，排除 worker 启动开销。(#176)
- **Gateway Core**: Per-turn token delta 与累计总量相同 — `resetPerTurn()` 被标记为死代码未调用，Done 后补充调用修复。(#176)
- **Gateway Core**: `pendingError` 双重 JSON 编码 — captureEvent 内部已 Marshal，调用方重复 Marshal 导致数据损坏。(#176)
- **Worker/ClaudeCode**: `HasSessionFiles` 空目录误判 — 空 `session-env/<id>` 目录触发无效 resume 浪费 ~14s。(#173)
- **Worker**: `control_request` 字段映射错误 — SDK 使用 "request" 非 "response"，导致 `can_use_tool` 阻塞无限等待。(#170)
- **Security**: Slack/飞书媒体处理路径穿越 — `filepath.Clean` 前缀检查和 `filepath.Base` 文件名清洗。(#167)
- **WebChat**: `message.parts` 为 null 时 filter/find 崩溃 — 新增 null guard 防止反序列化异常。(#177)

## [1.5.2] - 2026-05-04

### Summary

v1.5.2 是一次 patch 版本更新，聚焦于 **安全加固** 和 **交互授权链修复**。修复 REST API 所有权绕过、JWT 弱密钥接受、Admin IP 欺骗和时序侧信道攻击四个安全漏洞。交互授权链全路径 5 个断裂点全部修复，Slack/飞书/WebChat 用户现在可正常响应 Permission/Question/Elicitation 请求。同时新增 Slack delete-file CLI 命令和 Block Kit 表格渲染，WebChat 和 EventStore 获得性能优化。

### Added

- **Messaging/Slack**: `hotplex slack delete-file --file-id <F_FILE_ID>` 命令 — 调用 Slack files.delete API，支持 AI agent 清理过时上传文件。(#164)
- **Messaging/Slack**: Markdown 表格渲染为 Block Kit TableBlock — 流式输出结束后自动升级为表格+Markdown 混合布局，header-only/列不匹配等边界安全降级为代码块。(#148)

### Changed

- **Gateway Core**: bridge.go 分解为 4 个职责文件（bridge/bridge_worker/bridge_forward/bridge_retry），SessionManager 拆分为 5 个子接口（ISP），提升可读性和可测试性。(#153)
- **WebChat**: delta rAF 批处理、React.memo 非流式消息跳过重渲染、highlight.js 懒加载（~200KB → 按需 8 语言）。(#141)
- **EventStore**: delta 优化 — 捕获 seq 后的快速路径、三触发器 flush（大小/计时器/事件结束）、LLM 重试时丢弃过期 accumulator。(#153)

### Fixed

- **Gateway**: 交互授权链全路径修复 — 添加 `--permission-prompt-tool stdio` 到 Claude Code Worker 参数、修复 OwnerID 空值、替换静默错误丢弃为结构化日志、handleInput metadata 路由短路、WebChat 新增 Question/Elicitation 事件类型。(#160)
- **Gateway**: SIGTERM（exit code 143）误报为用户可见错误 — 正常退出/bridge 发起的终止改为 debug 日志。(#160)
- **Messaging/Slack**: Markdown 表格在 header-only 或列不匹配时触发 OOB panic。(#148)
- **Messaging/Slack**: joinSegments 末尾多余空白 — 未修剪换行符导致消息间距异常。

### Security

- **API**: GetSession/DeleteSession 端点缺失所有权检查 — 任何已认证用户可访问/删除他人 session。ListSessions limit 上限 500 防止资源滥用。(#155)
- **Security**: JWT secret 弱密钥检查 — 拒绝非 32 字节密钥，config audit 日志脱敏 api_keys/jwt_secret 字段。(#156)
- **Admin**: X-Forwarded-For 无条件信任导致 IP 白名单绕过 — admin token 验证改用常量时间比较消除时序侧信道。(#149)

## [1.5.1] - 2026-05-04

### Summary

v1.5.1 是一次 patch 版本更新，修复 v1.5.0 引入的 **agent 配置注入丢失** 和 **.env 路径展开失败** 两个关键问题。Bridge 闭包捕获导致 agent config SystemPrompt 在 worker Start/Resume 时被静默丢弃；Viper env override 绕过路径规范化导致 `~` 前缀路径无法解析。同时修复了 dev.sh 与 gateway PID 文件 JSON 格式不兼容导致的 `make dev` 启动失败。

### Fixed

- **Gateway**: Agent config SystemPrompt 在 worker Start/Resume 时被静默丢弃 — `workerStartFunc` 闭包捕获了 injection 前的 `workerInfo` 副本，注入的 SystemPrompt 未传递到 worker 进程。(#139)
- **Configuration**: `.env` 中 `~` 前缀路径（如 `~/.hotplex/...`）未展开 — Viper env override 在路径规范化之后写入原始值，导致 agent config、STT 等目录解析失败。(#138)
- **Configuration**: Worker 和 STT 环境变量通过 `.env` 设置时被静默忽略 — 缺少 `BindEnv` 调用导致 `claude_code.command`、`opencode_server.*` 和 `messaging.*.stt_*` 字段无法从环境变量读取。(#138)
- **Agent Config**: Agent config 启用但无对应文件时无告警 — 新增 `HasGlobalFiles()` 检测和 `agentConfigGlobalFilesChecker` 诊断检查。(#138)
- **Dev Tooling**: `make dev` 启动失败 — gateway PID 文件升级为 JSON 格式后 dev.sh `cat` 读取失败，误判进程已死。新增 `read_pid()` 兼容两种格式。

## [1.5.0] - 2026-05-03

### Summary

v1.5.0 是一次 minor 版本更新，聚焦于 **Slack 运维自服务、Agent 配置灵活性、反馈连续性诊断、Session 生命周期可靠性**。新增 `hotplex slack` CLI 子命令组（10 个命令），Agent 配置升级为 per-bot 3-level 目录 fallback（BREAKING：session ID 变化），hotplex-diagnostics skill 引入反馈链路时间线交叉验证检测静默中断。Gateway 修复了 resume 盲重试导致的 5 秒延迟（P0），飞书流式卡片解耦 Write/Flush 消除速率限制丢帧。

### Added

- **CLI**: `hotplex slack` 子命令组 — 10 个命令（send-message, update-message, schedule-message, upload-file, download-file, list-channels, search, canvas, bookmark, react），支持 env var 自动解析 channel/thread 上下文。Gateway 通过 bridge 注入 `HOTPLEX_SLACK_CHANNEL_ID`/`HOTPLEX_SLACK_THREAD_TS` 到 Worker 环境。(#137, #131)
- **Configuration**: Per-bot 3-level 目录 fallback — Agent 配置按文件独立解析 `global → platform/<platform>/ → <platform>/<botID>/`，替代旧的后缀追加机制（`SOUL.slack.md`）。BotID 贯穿 Slack/飞书全链路并纳入 session key 派生。新增 `agentConfigSuffixChecker` 检测废弃后缀文件。(#129)
- **Skills**: hotplex-diagnostics 运行时诊断 skill — 7 步方法论（进程 → Session → 反馈连续性 → 日志 → 适配器 → 源码 → Issue），FEEDBACK_STALL 分类（PIPELINE_STALL/BACKPRESSURE_DROP/ADAPTER_FAILURE/CLIENT_DISCONNECT），时间线交叉验证检测静默中断。
- **Gateway**: 精确 context 用量 — `get_context_usage` control channel 查询替代聚合 Done 事件统计，消除跨 turn 累积导致的 context fill 虚高。Turn summary 工具名显示限制为 top 5（"+N" 提示）。(#132)
- **CLI**: Gateway 子命令分解 — `runGateway()` 拆分为 initLogging/initOrphanCleanup/initStores/shutdownGateway，PID 文件升级为 JSON 格式存储 config path 和 dev mode。admin_adapters.go 从 routes.go 提取。
- **WebChat**: TurnSummaryCard 组件 — 前端渲染 per-turn session 数据（模型、context fill、时长、工具调用）。

### Changed

- **Gateway**: Worker 清理事件改为 Error 替代合成 Done — 语义正确，相同的 UI 清理（清除指示器、关闭流式卡片）但不触发 turn summary。提取 `sendError` 辅助函数替换 7 处内联 Error 信封创建。新增 `ErrCodeTurnTimeout` 常量。
- **Agent Config**: Context fill 计算修正 — Claude Code SDK `usage.input_tokens` 已含 cached tokens（billing breakdown 非叠加），移除重复计数消除 ContextFill 超过 ContextWindow 的不可能值。
- **Configuration**: `Bridge.adapter` 改用 `atomic.Value` 保证线程安全；`SetAdapter` 在 platform mismatch 时返回 error 而非仅日志 Warn。
- **CI**: GitHub Actions 升级至 Node.js 24 兼容版本 — actions/cache v5, upload/download-artifact v7。

### Fixed

- **Gateway**: Session 生命周期修复 — resume 盲重试消除（P0: 新增 `SessionFileChecker` 接口，bridge 恢复前检查 session 文件存在性，zombie GC 删除文件时自动降级为全新启动）；GC race 修复（handleGC 原子重读 session state 避免与 cleanupCrashedWorker 竞争）；空 session ID 验证。(#135, #133, #134)
- **Messaging/Feishu**: Write/Flush 解耦为后台 150ms timer loop — 防止 CardKit 100ms 速率限制静默丢帧和误报 integrity warning，修复 `bufRunes` 计数器 flush 后未重置。(#128)
- **WebChat**: 消息去重 — adapter 层在传入 assistant-ui ExternalStoreAdapter 前按 ID 去重，修复事件处理器竞争导致的 `MessageRepository same id already exists` 错误。

### Security

- **CLI/Slack**: `loadEnvFile` 防止覆盖已有环境变量；Worker 白名单使用精确条目替代宽泛前缀匹配；`download-file` 使用认证的 `client.GetFileContext` 替代裸 `http.Get`；rune 截断确保 CJK 字符正确处理。

## [1.4.0] - 2026-05-03

### Summary

v1.4.0 是一次 minor 版本更新，聚焦于 **运维自服务能力、Gateway 稳定性与并发安全、SQLite OOM 韧性、Messaging 层架构治理**。新增 CLI 自更新命令（GitHub Releases API + SHA256 校验 + 原子替换）、Turn Summary 紧凑单行摘要（per-turn stats + context fill 百分比）、智能目录切换安全策略、config-driven Worker 环境变量注入、SQLite CGo 双驱动自动降级。Gateway 全面加固并发安全（pcEntry race condition、Session panic recovery、WriteBufferFull 信号化），上下文占用率改用当前 turn token 计算以对齐 Claude Code 行为。Messaging 层提取 BaseAdapter 消除 connPool 重复、统一 `$context` 命令输出。CI 流水线并行化和缓存优化显著缩短构建时间。

### Added

- **CLI**: `hotplex update` 自更新命令 — GitHub Releases API 集成、SHA256 校验验证、原子二进制替换、服务自动重启支持（`--check`、`-y`、`--restart` 标志）。(#115)
- **Messaging**: Turn Summary per-turn stats — Done 事件后生成紧凑单行摘要（`Model · N% · ⏱ Xs · 🔧 N`），从 session accumulator 提取模型、上下文占用率、时长、工具调用数。(#122, #118)
- **Security**: 智能目录切换安全策略 — 支持用户主目录和 `/usr/local` 约定优于配置的智能判断，跨平台路径验证。(#110 相关)
- **Configuration**: Worker 环境变量注入 — `worker.environment` 配置驱动，支持 `${VAR}` 展开和 `env_whitelist` 过滤，默认注入 `BUN_RUNTIME_NV=disable_avx512`。
- **Configuration**: `db.events_path` 可配置 — events.db 路径支持自定义，脱离默认数据目录。
- **SQLite**: CGo 双驱动自动降级 — CGo 构建使用 mattn/go-sqlite3（性能优先），纯 Go 构建使用 modernc.org/sqlite（OOM 韧性），build tag 自动选择。
- **Messaging**: `$context` 命令输出美化 — 共享格式化层（severity 级别、进度条、友好 token 计数、操作建议），Slack/飞书/WebChat 统一输出。WebChat 新增 ContextUsageCard 玻璃态组件。(#110)
- **Messaging**: events.Message 处理 — 飞书和 Slack 适配器新增 handler/bridge 发起的独立消息处理（cd 确认、命令反馈）。
- **Messaging**: 控制命令详细错误消息 — 用户友好的错误提示替代静默失败。

### Changed

- **Messaging**: 提取 BaseAdapter[C] 泛型结构体 — 消除 Slack/飞书适配器约 30 行 connPool 重复代码，提供 `InitConnPool`/`GetOrCreateConn`/`DrainConns`/`DeleteConn` 统一生命周期管理。(#114)
- **Gateway**: 模块拆分 — 从 hub.go 提取 SeqGen 和 pcEntry 到独立文件，提取 `createAndLaunchWorker`、`requireActiveOwner` 辅助函数，Handler 改用 SessionManager 接口替代具体类型。
- **Gateway**: 上下文占用率改用 `ContextFill`（当前 turn input tokens）替代累计 TotalInput 计算 — 对齐 Claude Code per-turn 上下文跟踪语义，新增 `context_fill` 字段到 session stats snapshot。
- **Gateway**: 移除 TurnIdleTimeout idle detection — 合成 Done 机制不可靠，execution_timeout 30m 仍是僵尸会话安全网。
- **Gateway**: 消除 `toInt64`/`toFloat64`/`formatTokenCount`/`extractSessionStats` 重复实现 — 替换为 events 包 `ToInt64`/`ToFloat64` 等价函数，移除死代码。
- **Session**: 提取 `audit_store.go`（审计追踪方法）、`stores.go`（store 工厂）、`updateSession` 辅助函数，store.go 减少 182 行。
- **SQLite**: 提取 `sqlutil` 包统一 DB 初始化和 PRAGMA 调优，消除冗余零值回退。
- **Security**: 提取 `resolveSigningKey` 辅助函数，移除无用的 `DevAllowedTools`。
- **Admin**: 提取 CORS 处理到中间件。
- **Metrics**: 移除 `session_id` label 防止 delta 指标基数无限增长。
- **CI**: 流水线优化 — 移除 Gate 阶段、步骤并行化、Go/WebChat 缓存。
- **Messaging**: 关闭 turn_timeout 默认值（原 15m 过于激进，execution_timeout 30m 已足够捕获僵尸会话）。
- **Service**: systemd WorkingDirectory 对齐 worker.default_work_dir 而非硬编码 `$HOME`。(#109)

### Fixed

- **Service**: ExecStart 路径解析 — `ResolveBinaryPath()` 优先使用 PATH 查找（`exec.LookPath`），修复 build 目录路径写入 systemd unit 的问题。(#113)
- **Configuration**: `${VAR}` 环境变量展开 — ExpandEnv 已定义但未在加载路径中调用，worker.environment 值注入为字面量而非展开值。(#111)
- **Configuration**: Workdir fallback 链统一 — messaging 适配器路径正确展开 `~` 为用户主目录。
- **Gateway**: pcEntry WriteCtx/Close race condition — 并发写入和关闭导致 panic，新增错误分类辅助函数。关闭 data channel 解除 writeLoop 阻塞。
- **Session**: 并发安全加固 — UpdateWorkDir/ClearContext 添加 RLock 保护早期返回字段读取；回调函数添加 panic recovery；级联删除包裹在事务中；WriteBuffer 满时返回 `ErrWriteBufferFull` 替代静默丢弃。
- **Worker**: RLIMIT_AS 自限 bug 修复 — 网关进程被自身内存限制崩溃；禁用 RLIMIT_AS 修复 Bun 运行时崩溃。(#112 相关)
- **Worker**: OCS SSE 超时和启动问题修复；releaseOnce 行为测试覆盖。(#112 相关)
- **Messaging**: watchTimeout panic recovery 和 idleMonitor context race 修复。
- **Messaging/Feishu**: ChatQueue `wg.Add` 移入 mutex lock 内防止 race；非用户流式卡片清理路径用 Close() 替代 Abort()；控制命令错误静默失败修复。
- **Messaging/Feishu**: `sendTurnSummary` 改用 fresh context 并在活跃流式卡片中追加摘要，避免重复消息和 stale context 问题。
- **Agent Config**: `readFile` 区分 IsNotExist 和其他错误类型。
- **CLI**: wizard stepAgentConfig 写入和关闭错误处理。

### Security

- **Configuration**: GH_TOKEN/GITHUB_TOKEN 重命名为 HOTPLEX_WORKER_GH_TOKEN/HOTPLEX_WORKER_GITHUB_TOKEN 前缀，防止 shell 环境污染影响 `gh` CLI keyring 认证。(#111)

## [1.3.0] - 2026-04-30

### Summary

v1.3.0 是一次 minor 版本更新，聚焦于 **跨平台 Windows 支持、Gateway 安全默认值与生命周期管理、WebChat 嵌入式 SPA + AI Native UX、Messaging 适配器 DRY/SOLID 重构、Session History REST API、DI 构造函数注入**。新增 Windows amd64/arm64 一等公民支持（Job Object 进程树管理、纯 Go SQLite、跨平台路径安全验证）。Gateway 全面加固安全基线（localhost-only 默认绑定）、新增系统服务管理（systemd/launchd/SCM）和守护进程模式。WebChat 完成嵌入式 SPA 部署（`go:embed`）和 AI Native UX 升级（ghost assistant、AgentTool/TodoTool、glassmorphism 设计）。Messaging 层完成 issue #65 七阶段重构，提取共享 Pipeline/ConnPool/Streaming/Dedup/Backoff/Gate 到基础包。DI 层从 setter 链迁移到构造函数注入。

### Added

- **Platform**: Windows amd64/arm64 一等公民支持 — Job Object 进程树清理、纯 Go SQLite (modernc.org)、跨平台 TTY 检测、路径安全验证、pipe 错误检测。(#64, 794a8ff, de8b097, 1e75218, 6229be9)
- **Gateway**: 安全默认值加固 — localhost-only 默认绑定、daemon 模式 (`-d`)、统一进程生命周期管理 (stop/restart/status/service)。(#62, 3204cfc)
- **Gateway**: 系统服务管理 — install/uninstall/start/stop/restart 支持 systemd/launchd/Windows SCM，user/system 级别。(#62, 3204cfc)
- **Gateway**: `GET /api/sessions/{id}/history` — 会话历史 REST 端点，支持 cursor 分页查询 ConversationStore。(#60, d17b90d, 440525e)
- **Gateway**: `GetBySessionBefore` — ConversationStore 新增基于序列号的分页查询，用于历史回放。(#60, 440525e)
- **WebChat**: 嵌入式 SPA — Next.js 静态导出通过 `go:embed` 嵌入 gateway 二进制，SPA fallback 路由，零外部依赖部署。(#62, 5d0a414)
- **WebChat**: Ghost assistant — 后端静默期间显示 skeleton 占位符，消除"黑洞效应"。(#62, 0ce448c, 171963f)
- **WebChat**: AI Native UX — thinking indicator 重设计、glassmorphism copy button、inline message actions、AgentTool 和 TodoTool 结构化任务渲染。(#62, 08fa8ed, cf6a2b6, 3003c0b, 2f49dfa, aa727b6)
- **WebChat**: History runtime adapter — L1 (React state) + L2 (LocalStorage) 双层缓存，cursor 分页历史加载。(#60, a5bbb72, 686e1fa, ed7aecb)
- **Skills**: Skills 发现整合到独立 `skills` 包 — 可配置 TTL 缓存 + CWD 目录扫描。(#67, f1538fe)
- **CI**: OpenCode + OMO 离线 bundle — GitHub Release 自动打包和安装脚本，支持离线环境部署。(#59, ffaf168, 3412b22)
- **Infrastructure**: `make hooks` 目标自动安装 git hooks，`make quickstart` 适配非开发者用户。(#62, c61b03e, ca5b698)

### Changed

- **Messaging**: 七阶段 DRY/SOLID 重构 (issue #65) — 提取共享 Pipeline、ConnPool、StreamingCard 抽象、Dedup/Backoff/Gate 到 `internal/messaging/` 基础包；Feishu/Slack 适配器代码量大幅缩减。(#67, 02f239b, 1be2d0f, c0892b4, 37751dc, e8f0ae3, 24cf4eb)
- **DI**: 构造函数注入替代 setter 链 — Handler/Bridge/Adapter 改用 `Deps` struct 注入，编译期保证完整性。(#61, f906d30)
- **Logging**: 结构化日志优化 — gateway 栈统一 slog key-value 风格 (snake_case)，注入 channel 标识到所有组件 logger，14 个可恢复错误从 Error 降级为 Warn。(#67, baf4546)
- **Security**: TOCTOU 修复 + SSRF DNS mock — ExpandAndAbs 解析符号链接防止 workdir 竞态，6 个 Manager 方法 copy-then-write 模式消除 lock-DB-I/O。(#67, a290bb3)
- **Security**: 跨平台路径验证重构 — `ValidateWorkDir` 拆分为 `path_unix.go`/`path_windows.go`，Windows 大小写不敏感。(#64, 6229be9, d702753)
- **Session**: 移除 EventStore + PostgresStore，ConversationStore 增加统计查询 — 简化持久化架构。(#67, a7b6eda)
- **Gateway**: PID 文件容错 — restart 遇到 stale PID 时 warning 并继续启动而非失败。(#62, 0165d17)
- **Config**: `~` 展开修复 — 所有 YAML 路径字段正确展开波浪号为 home 目录，防止创建字面 `~` 目录。(#62, dad790c)
- **Hooks**: pre-push gate 增强 — 新增 fmt + lint + go vet + go mod verify + race test，本地拦截 CI 失败。(#62, 05961c1, c61b03e, 6e08233)

### Fixed

- **Messaging**: 飞书消息无响应三类根因 — ResumeSession 输入丢失、Error 事件静默丢弃、长时间无输出无提示。(#68, e96640d)
- **Gateway**: `handler.sm` nil guard — conn.go idle 转换检查添加空指针防护。(#67, 9203060)
- **Slack**: `TestShortenPaths` data race — mutex-guarded `SetWorkDir` 消除竞态条件。(#68, 0e30a30)
- **WebChat**: 多项 UX 修复 — 额外换行、tool 折叠/展开、terminal 状态生命周期、reasoning markdown 渲染、scroll button 定位。(#62, various)
- **WebChat**: 依赖更新和类型兼容性修复 — pin ai SDK 版本，修复 ConversationRecord success 类型。(#68, fab6be6, 632f180)
- **Windows**: 进程管理加固 — 修复跨平台 STT Job Object 清理、PID 文件路径、signal 处理、pipe 错误检测。(#64, 031eab2, f602b6a, de8b097)
- **CI**: large file guard 扫描 HEAD tree only 避免误报；OMO 插件通过 OpenCode auto-discovery 注册。(#59, d4b6818, 1883866)

## [1.2.0] - 2026-04-29

### Summary

v1.2.0 是一次 minor 版本更新，聚焦于 **会话历史持久化、Skills 体验升级和仓库安全加固**。新增 MessageStore（事件级持久化）和 ConversationStore（轮次级持久化）双层架构，为会话回放和审计提供数据基础。Gateway 新增 Skills 发现与列表展示能力（缓存 + DRY 共享模块）。WebChat 完成 UX v5 重构（智能折叠、高级动画、GenUI 工具组件）。安全层面完成 5 层大文件防御体系（gitignore → gitattributes → pre-commit → pre-push → CI guard），并从历史中彻底清除 46MB 误提交二进制。测试覆盖率持续提升至中高风险路径全覆盖。

### Added

- **Session**: MessageStore — event-level persistence with async batch writer, SQLite backend, Postgres stub; `EventStoreEnabled` config flag (default: true). (4f20233)
- **Session**: ConversationStore — turn-level persistence (user input + assistant response with tools, tokens, cost, duration); cascade delete on session removal. (4f20233)
- **Session**: Admin stats endpoint — `GET /admin/sessions/{id}/stats` for aggregated session statistics. (4f20233)
- **Gateway Core**: SkillsLocator — project/user/plugin directory scanning with configurable TTL cache. (c7446b3, ef58fe7)
- **Gateway Core**: Skills listing event dispatch — `/skills` command in WebSocket and messaging platforms with paginated display. (36699d5)
- **Messaging**: Shared skills helpers — DRY consolidation of Feishu/Slack skills list formatting into `messaging/skills_helpers.go`. (2bf2bbd)
- **WebChat**: Hybrid architecture v5 — smart collapsing, advanced animations, and layout optimization. (4fea33b)
- **WebChat**: GenUI tool components — ListTool and TodoTool for enhanced tool rendering. (5164387)
- **WebChat**: Message cache and turn replay utilities for client-side session history. (4f20233)
- **Security**: 5-layer large file defense — `.gitignore` + `.gitattributes` + pre-commit hook + pre-push scan + CI large-file-guard job; blocks all files >1MB from entering the repository. (b410de5, 0b3e866)
- **Security**: `RegisterCommand` validation — path separator and dangerous character checks for worker command whitelist. (e9f6415)
- **Gateway Core**: Configurable Claude Code startup command via `worker.claude_code.command`. (e9f6415)
- **Agent Config**: Built-in metacognition via `go:embed` — agent self-knowledge (architecture, mechanisms) injected as C-channel. (879298d)
- **Docs**: Feishu and Slack integration guides (Chinese + English bilingual). (4f20233)

### Changed

- **Gateway Core**: Skills parsing deduplication — eliminated duplication between skills_locator and gateway handler. (624ca02)
- **Gateway Core**: Control request timeout isolated — prevent global timeout from affecting individual control commands. (d940e91)
- **Messaging**: Feishu streaming card error handling — error events now close streaming card to prevent stale cards after TURN_TIMEOUT. (879298d)
- **Messaging**: Silent message drop prevention — check session state before assuming worker is alive on resume. (879298d)
- **Session**: Reset ExpiresAt on session resume — prevent GC max_lifetime from killing reactivated sessions. (879298d)
- **Infrastructure**: Removed 46MB `hotplex` binary from git history; `.git` size reduced from 52MB to 8MB. (0b3e866)
- **Testing**: Coverage expansion — medium-ROI packages (cli/checkers, skills, worker/claudecode, feishu) now at 67–89%. (e9f6415, 879298d)

### Fixed

- **Gateway Core**: Frontmatter parsing fixed — skills display format unified across platforms. (db98ffa)
- **Gateway Core**: Claude Code skills properly discovered from all skill directories (user, project, plugin). (63c7b64)
- **Gateway Core**: LLM retry false positives — `ShouldRetry` now matches only ErrorData, not turn text containing error-like strings. (879298d)
- **Gateway Core**: Proc double-log on exit — guarded by `exited` flag to prevent duplicate log lines. (879298d)
- **Worker**: OCS compact auto-resolves model from message history; rewind auto-resolves last assistant messageID. (b7569f1)
- **Messaging**: Slack `sendSkillsList` method added for SkillsList event handling. (a6a0b2c)
- **WebChat**: Bot avatar alignment, rendering fixes, and useAuiState migration. (34d6f7c)
- **WebChat**: Default workDir passed when creating sessions. (c7146a4)
- **Security**: 22 non-functional issues resolved from comprehensive audit (errcheck, gocritic, gofmt). (175671e)

## [1.1.2] - 2026-04-26

### Summary

v1.1.2 是一次 patch 版本更新，聚焦于 **会话数据持久化与连接稳定性**。新增 Conversation Store（异步批量写入会话轮次数据）和 Session Stats API（token/延迟/成本统计），为 WebChat 和管理端提供会话级别的洞察。Gateway Core 修复了多个关键稳定性问题（CAS race guard、fast reconnect、session ID 一致性、mapper 事件丢失），并引入 title-based session management 和 startup session repair。Session 层完成 SQLite 性能优化（PRAGMA 调优、级联删除、events TTL、自动 VACUUM）。测试覆盖率从 68% 提升至 84%+。

### Added

- **Gateway Core**: Title-based session management — thread title parameter through bridge, session manager, REST API, and WebSocket init path; deterministic UUIDv5 session IDs from (userID, workerType, title, workDir). (f4761c66)
- **Gateway Core**: `RepairRunningSessions` on startup — stale running sessions transitioned to terminated, preventing ghost sessions after gateway restart. (4fd59ee5)
- **Gateway Core**: `GetSessionsByState` store query + migration 003 backfill for NULL `work_dir` values. (4fd59ee5)
- **Gateway Core**: REST API tests — 15 HTTP handler tests covering CreateSession, DeleteSession, ListSessions, GetSession, SwitchWorkDir endpoints. (8d701565)
- **Gateway Core**: Session manager tests — coverage for RepairRunningSessions, DetachWorkerIf CAS, GetSessionsByState, work_dir round-trip, migration idempotency. (be7eb9e9, 4ac803d8)
- **Messaging**: Feishu streaming card TTL rotation — proactive 6-minute card replacement with async abort and reply_to threading to bypass Feishu's 10-minute server limit. (2bccd702)
- **Session**: Conversation store — async batch writer for turn-level persistence (user input + assistant response with tools, tokens, cost, duration); 3 recording paths (normal done, crash/timeout, fresh start). (ce02d0eb)
- **Gateway Core**: Session stats API — aggregated turn statistics from done events (`GET /api/sessions/{id}/stats`). (ce02d0eb)

### Changed

- **Session**: SQLite storage optimization — PRAGMA tuning (32MB cache, 256MB mmap), cascade delete for events/audit on session deletion, events TTL cleanup (30 days), automatic VACUUM when free pages exceed 20%. (2d569a8b)
- **Gateway Core**: Fast reconnect for idle sessions — skip terminate+resume cycle when worker is still alive, transition directly back to running. (0a71a61b)
- **Gateway Core**: CAS semantics for DetachWorker — prevents old forwardEvents goroutines from clobbering a concurrently replaced worker. (0a71a61b)
- **CLI**: Agent config templates migrated from Go constants to `embed.FS` files, onboard wizard streamlined v3→v4. (9f56623d)
- **Gateway Core**: Code quality pass — extract `IsDeadProcessError` helper, merge accumulator locks, skip tracing spans for high-frequency pings, promote bare strings to constants. (120d2487, e9b05625)

### Fixed

- **Gateway Core**: ClaudeCode mapper silently discarded `EventSystem` and `EventSessionState` — payload type mismatch (`string` vs `json.RawMessage`) caused all state transitions to be dropped. (2bccd702)
- **Gateway Core**: Worker crash recovery — transient `INTERNAL_ERROR` suppressed, `RESUME_RETRY` handled with automatic fresh-start fallback in UI. (0a71a61b)
- **Gateway Core**: Skip LLM retry for empty output from resumed workers and exit code 143 (SIGTERM from connection replacement). (0a71a61b)
- **Messaging**: Feishu streaming card write failure now gracefully falls back to static IM delivery instead of returning error to caller. (2bccd702)
- **WebChat**: Connection stability — deterministic session IDs across REST/WS paths, browser console warnings eliminated, frontend crash guards for undefined message roles. (0a71a61b, 14575983, 4fd59ee5)
- **WebChat**: CommandMenu filter bug — inconsistent `/` prefix variable caused slash commands to not filter correctly. (120d2487)
- **WebChat**: useCopyToClipboard timeout leak on unmount; useSessions panel state stabilized with useCallback. (120d2487)
- **Session**: `errors.Is` for `sql.ErrNoRows` comparison (errorlint compliance). (45ddac6f)
- **E2E**: Flaky state event assertion removed from SendInputReceiveEvents test. (01ffdec7)

## [1.1.1] - 2026-04-26

### Added

- **WebChat**: "Obsidian" dark theme redesign — glassmorphism design system, Outfit + JetBrains Mono typography, framer-motion spring animations across messages, tool cards, and reasoning blocks.
- **WebChat**: GenUI tool rendering — TerminalTool (stdout/stderr split, auto-collapse), FileDiffTool (syntax-aware diff with copy), SearchTool (match highlighting), and PermissionCard (approve/reject MCP events interactively).
- **WebChat**: Slash command palette (`CommandMenu`) with fuzzy search across all commands (`/gc`, `/reset`, `/cd`, `/skills`, `/new`) and worker skills.
- **WebChat**: MetricsBar — live token counts, turn latency, and wall-clock time extracted from AEP `done.stats` events.
- **WebChat**: NewSessionModal with worker type selector, workdir input, recent directories dropdown, and nuqs URL deep linking for one-click session setup.
- **WebChat**: Code block folding, syntax highlighting, and copy-to-clipboard in Markdown rendering.
- **Gateway**: OpenCode Server singleton process model — all sessions share one lazily-started `opencode serve` process with ref counting and 30m idle drain, replacing per-session process spawning.
- **Gateway**: `/cd <path>` in-session directory switching with path validation and security guard; `/skills` command to list available worker skills.
- **Gateway**: Agent config XML injection with B/C channel architecture (`<directives>` for SOUL/AGENTS/SKILLS, `<context>` for USER/MEMORY); platform variants (e.g. `SOUL.slack.md`) auto-appended.
- **Gateway**: Session `work_dir` persistence — working directory stored in SQLite, enabling session stickiness across page reloads and idempotent session re-creation via `DeletePhysical`.
- **CLI**: Onboard wizard auto-generates agent config files (SOUL/AGENTS/SKILLS/USER/MEMORY) during setup.

### Changed

- **Infrastructure**: install.sh rewritten as binary-only installer (851→113 lines); uninstall.sh streamlined (189→102 lines) with `--purge` and PID cleanup.
- **Configuration**: Agent config size limits tightened to 8K/file, 40K total.

### Fixed

- **Gateway**: Nil pointer panic in claudecode worker `Resume()` — race condition where `w.Proc` was nil'd by concurrent `Terminate()` while `Resume()` called `Start()`.
- **Gateway**: Worker crash recovery — transient `INTERNAL_ERROR` suppressed; `RESUME_RETRY` handled gracefully in UI with automatic fresh-start fallback.
- **Gateway**: SQLite session migration silent failure — batch SQL split to per-statement execution, fixing missing `work_dir` column on upgrade.
- **WebChat**: Composer input frozen after slash command interaction — state synchronization restored IME compatibility and keyboard responsiveness.
- **WebChat**: User-facing error messages for terminal states (SESSION_BUSY, TURN_TIMEOUT, INTERNAL_ERROR) replace raw error codes.
- **WebChat**: Minor fixes — CommandMenu visibility, NewSessionModal dropdown overflow, Jump-to-Last button positioning, code block wrapping, turbopack serialization warnings.
