From 13377473a2296767336000fd48b0a5c06a606641 Mon Sep 17 00:00:00 2001
From: robot-wklken <wklken3@gmail.com>
Date: Tue, 20 Oct 2026 18:03:55 +0800
Subject: [PATCH] chore(release): prepare v0.2.9 metadata and release notes

Keep the release unreleased until AIDev #21 merges and its notes and verification are included.
---
 CHANGELOG.md     | 29 +++++++++++++++++++++++++++++
 latest.json      |  2 +-
 npm/package.json |  2 +-
 3 files changed, 31 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 07f8692..27c16fd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,35 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.2.9] - Unreleased
+
+发布前置条件：等待 AIDev [#21](https://github.com/TencentBlueKing/bk-cli/pull/21) 合入，补充其发布说明并重新验证后再发布。以下草案基于 `v0.2.8 → ee4d3eb`，包含已合并的 #41。
+
+### Highlights
+
+- **内置 `--jq` 结果投影**：支持对 API 和系统命令的完整返回结果进行筛选、提取和转换，无需安装外部 jq。分页命令在聚合完成后统一投影，输出为 JSON Lines。([#40](https://github.com/TencentBlueKing/bk-cli/pull/40), @robot-wklken)
+- **个人 token 登录**：新增 `auth login --personal_token`，通过 Bearer 认证调用接口，支持凭据加密存储和认证信息脱敏。([#30](https://github.com/TencentBlueKing/bk-cli/pull/30), @robot-wklken)
+- **环境变量登录**：支持通过 `BK_CLI_*` 环境变量提供四种登录凭据，减少在命令行参数中暴露凭据；显式 flags 优先，并校验环境模式冲突和空白输入。([#28](https://github.com/TencentBlueKing/bk-cli/pull/28), @robot-wklken)
+- **批量申请网关权限**：新增 `apigateway apply_gateway_permission`，支持按网关批量申请资源权限，提交前要求明确确认，并保留申请单号及服务端返回的审批信息。([#38](https://github.com/TencentBlueKing/bk-cli/pull/38), @robot-wklken)
+- **从文件或 stdin 读取请求体**：支持 `--body @file.json` 和 `--body -`，便于复用复杂 JSON、组合 shell pipeline 和执行自动化任务。([#19](https://github.com/TencentBlueKing/bk-cli/pull/19), @robot-wklken)
+
+### Improvements
+
+- 补充 usage skill 中的内置 `--jq` 示例、输出规则和失败处理指引，明确投影失败后不得自动重发请求。([#41](https://github.com/TencentBlueKing/bk-cli/pull/41), @wklken)
+- 新增系统命令接入与变更的 Issue 模板，方便提交接口信息和命令需求。([#24](https://github.com/TencentBlueKing/bk-cli/pull/24), @wklken)
+
+### Fixes
+
+- **修复 JSON 数字精度丢失**：默认响应输出保留大整数、小数和指数的原始数字字面量，避免大 ID 被舍入；同步修复 CMDB 分页中的数字解析，确保相邻大整数主机 ID 不被错误去重。([#36](https://github.com/TencentBlueKing/bk-cli/pull/36), @robot-wklken)
+- **修复帮助示例中的 shell 展开问题**：调整 URL、凭据、请求头和脚本示例的引用方式，避免复制执行时 `$`、命令替换等内容被意外展开。([#26](https://github.com/TencentBlueKing/bk-cli/pull/26), @robot-wklken)
+
+### Upgrade Guide
+
+- 使用个人 token 时，不要混用其他登录凭据或叠加 `X-Bkapi-Authorization`。权限申请接口仍要求应用身份，不支持个人 token。
+- 环境变量凭据仅由 `auth login` 读取。建议限定注入作用域，登录完成后清理环境变量。
+- `--jq` 投影失败时会保留原始响应并报告错误，**不代表请求未执行**。先检查任务、资源或申请单 ID，再决定后续操作。
+- 内置 `--jq` 保持整数精度，但小数和指数遵循 gojq 浮点语义；需要保留原始数字字面量时省略 `--jq`。
+
 ## [0.2.7] - 2026-06-22
 
 ### Bug Fixes
diff --git a/latest.json b/latest.json
index 0b50333..02a2f38 100644
--- a/latest.json
+++ b/latest.json
@@ -1 +1 @@
-{"version":"v0.2.7"}
+{"version":"v0.2.9"}
diff --git a/npm/package.json b/npm/package.json
index ab5faeb..c82ce8b 100644
--- a/npm/package.json
+++ b/npm/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@blueking/bk-cli",
-  "version": "0.2.6",
+  "version": "0.2.9",
   "description": "BlueKing CLI - agent-first CLI for BlueKing APIs",
   "bin": {
     "bk-cli": "scripts/run.js"