docs: align README/AGENTS/skills with Bun as sole packaging engine

The READMEs still described the Bun build as an experimental pipeline
running alongside the default Node.js SEA chain, and AGENTS.md still
mentioned SEA packaging in CI plus a kimi-build workspace exclusion that
no longer exists. Rewrite the fork-feature blurbs, add the missing
Bun toolchain entry to the fork additions list, switch the docs/skill
instructions to bun commands, and fix the native-stage comment whose
default engine claim contradicted the code.

Author: luozihao

.agents/skills/sync-changelog/SKILL.md

@@ -335,7 +335,7 @@ Check:
 Then run the docs build:
 
 ```bash
-pnpm --filter docs run build
+cd docs && bun run build
 ```
 
 ### 8. Human Review Checkpoint
@@ -397,7 +397,7 @@ Fill in `.github/pull_request_template.md`. For changelog sync PRs:
 
 - **Related Issue**: write `N/A — post-release docs maintenance` (no issue required).
 - **Problem**: the docs-site changelog is behind the published CLI release(s).
-- **What changed**: list synced version(s), note English source + Chinese translation, and mention verification (`pnpm --filter docs run build`).
+- **What changed**: list synced version(s), note English source + Chinese translation, and mention verification (`cd docs && bun run build`).
 - **Checklist**: check CONTRIBUTING; explain no issue, no tests, no changeset, and that `gen-docs` is not needed because this is the dedicated changelog sync flow.
 
 Example body:
@@ -415,7 +415,7 @@ The docs-site changelog has not yet been synced for `<version range>` after the
 
 - Synced `<version range>` from `apps/kimi-code/CHANGELOG.md` into `docs/en/release-notes/changelog.md`
 - Translated the new English increment into `docs/zh/release-notes/changelog.md`
-- Verified with `pnpm --filter docs run build`
+- Verified with `cd docs && bun run build`
 
 ## Checklist
 

AGENTS.md

@@ -21,6 +21,7 @@ This is a TypeScript monorepo built for agent-assisted development. This file is
 - **Team** — Multi-agent discussion and collaboration tool; agents can debate, cross-review, and reach consensus before output.
 - **Rust Native Tools** — Performance-critical tools (grep, glob, edit, read, write, bash, token counting, output truncation) rewritten in Rust as a native Node addon, significantly faster than JS.
 - **Windows launchers** — `start-native.bat` builds the native Rust tools if needed and launches the CLI in dev mode (`bun run dev:cli`, tsx running `src/main.ts`); `start-desktop.bat` builds and launches a locally vendored desktop shell when `apps/kimi-desktop` is present (the shell source is not tracked in this fork).
+- **Bun toolchain & packaging** — Bun is both the package manager (hoisted workspace, `bun.lock`) and the sole native-binary packaging engine (`bun build --compile` via `build-bun.mjs`); the former pnpm workspace setup and the Node SEA build chain were retired. Self-update remains engine-aware for legacy SEA installs.
 - **DeepSeek Harness capability fusion** — Selected capabilities ported from [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) (MIT): MCP auto-reconnect with bounded exponential backoff (`mcpCore/connection-manager.ts`). Ported modules carry a source note in their header; capability selection and comparison notes live in the session report.
 
 > For a user-facing summary of these additions, see `README.md` → "What's Different in This Fork" (and its Chinese mirror `README.zh-CN.md` → "本 Fork 新增特性").
@@ -296,7 +297,7 @@ GitHub Actions (`ci.yml`) runs on every PR and push to `main`:
 3. **test-pi-tui** — `pi-tui` suite (uses node:test, not vitest)
 4. **lint** — `bun run lint` (oxlint --type-aware), `bun run sherif`, locale key parity (`check-locale-keys.mjs`), locale placeholder validity (`check-locale-placeholders.cjs`), and locale JSON freshness (regenerate via `generate-locale-json.cjs` and fail on any tracked diff)
 5. **typecheck** — TypeScript check across all packages (uses `tsgo` from `@typescript/native-preview`)
-6. **native bundle** — Built by `_native-build.yml` (a `workflow_call` workflow invoked from `release.yml` and `manual-native-bundle.yml`) on a 6-target matrix (linux-x64, linux-arm64, darwin-x64, darwin-arm64, win32-x64, win32-arm64): `(cd packages/kimi-native-tools && bun run build)` (napi-rs build; no cargo test), then SEA packaging and a native smoke test.
+6. **native bundle** — Built by `_native-build.yml` (a `workflow_call` workflow invoked from `release.yml` and `manual-native-bundle.yml`) on a 6-target matrix (linux-x64, linux-arm64, darwin-x64, darwin-arm64, win32-x64, win32-arm64): `(cd packages/kimi-native-tools && bun run build)` (napi-rs build; no cargo test), then Bun single-file packaging (`build:native:bun`) and a native smoke test.
 7. **codeql** — `codeql.yml` scans js/ts on PRs, pushes to `main`, and weekly. A branch ruleset requires CodeQL results (plus blocks force pushes and branch deletion) for merges into `main`.
 
 Additional workflows: `_native-build.yml`, `codeql.yml`, `docs-deploy.yml`, `manual-native-bundle.yml`, `nix-build.yml`, `pkg-pr-new.yml`, `pr-title-checker.yml`, `release.yml`.
@@ -442,7 +443,7 @@ Two dependencies are deliberately removed: `ssh2@1.17.0>cpu-features` and `ssh2@
 
 ## Monorepo Workspace Maintenance
 
-- **The `workspaces` field in the root `package.json`** is the source of truth for workspace membership. Globs: `packages/*` (minus `!packages/kimi-build`), `apps/*` (minus `!apps/kimi-web`), `apps/vis/server`, `apps/vis/web`, and `docs`.
+- **The `workspaces` field in the root `package.json`** is the source of truth for workspace membership. Globs: `packages/*`, `apps/*` (minus `!apps/kimi-web`), `apps/vis/server`, `apps/vis/web`, and `docs`.
 - **`flake.nix`** also contains a hardcoded `workspacePaths` list that must be manually kept in sync.
 - **Whenever you add or remove a workspace package, you MUST update both the root `package.json` and `flake.nix`** — for every package, including leaf / test / e2e packages that nothing depends on.
   - Missing a path in `flake.nix`'s `workspacePaths` silently drops files from the Nix build's `src` fileset.

README.md

@@ -15,7 +15,7 @@ Compared to upstream, this fork adds:
 - **🤖 Team.** Multi-agent discussion and collaboration tool — agents can debate, cross-review, and reach consensus before output.
 - **⚡ Rust Native Tools.** Performance-critical tools (grep, glob, edit, read, write, bash, token counting, output truncation) rewritten in Rust as native Node addon, significantly faster than JS.
 - **🪟 Windows launchers.** `start-native.bat` launches the native CLI; `start-desktop.bat` builds/launches a locally vendored desktop shell when present.
-- **🥖 Bun migration (experimental).** Experimental single-file builds via `bun build --compile` now run in CI as a six-platform matrix (linux/darwin/win32 × x64/arm64) alongside the default Node.js SEA pipeline: node-pty and pi-tui helpers load from a unified packaged-asset cache, host terminal sessions support both runtimes, URL-fetch SSRF semantics stay identical across runtimes (bundled undici), self-update is engine-aware, and `/status` shows a Runtime row. Validated on linux-x64 only so far; the long-term goal is for Bun to replace SEA as the sole release engine.
+- **🥖 Bun as the sole packaging engine.** Release binaries are single-file builds via `bun build --compile`, produced by the CI six-platform matrix (linux/darwin/win32 × x64/arm64). The former default Node.js SEA pipeline has been retired: node-pty and pi-tui helpers load from a unified packaged-asset cache, URL-fetch SSRF semantics are identical across runtimes (bundled undici), self-update is engine-aware and still recognizes legacy SEA installs, and `/status` shows a Runtime row.
 - Various other fixes and QoL improvements.
 
 For a deeper, contributor-facing breakdown of these additions and how they integrate with the rest of the project, see `AGENTS.md` → "Fork-specific additions vs upstream".

README.zh-CN.md

@@ -17,7 +17,7 @@
 - **🤖 Team 多 Agent 讨论**：多 Agent 讨论协作工具，Agent 之间可辩论、交叉审查并达成共识后输出。
 - **⚡ Rust 原生工具加速**：性能关键工具（grep、glob、edit、read、write、bash、token 统计、输出截断）用 Rust 重写为原生 Node addon，显著快于 JS 实现。
 - **🪟 Windows 启动脚本**：`start-native.bat` 一键启动原生 CLI；`start-desktop.bat` 用于构建并启动本地 vendored 桌面壳（仅当 `apps/kimi-desktop` 存在时可用）。
-- **🥖 Bun 迁移（实验性）**：通过 `bun build --compile` 的实验性单文件构建已接入 CI 六平台矩阵（linux/darwin/win32 × x64/arm64），与默认的 Node.js SEA 流水线并行：node-pty 与 pi-tui helper 统一由打包资产缓存加载、宿主终端会话支持双运行时、URL-fetch SSRF 语义跨运行时一致（统一捆绑 undici）、自更新感知引擎、`/status` 显示 Runtime 行。目前仅在 linux-x64 上实测验证；长期目标是让 Bun 取代 SEA 成为唯一发布引擎。
+- **🥖 Bun 唯一打包引擎**:发布二进制通过 `bun build --compile` 产出单文件构建,由 CI 六平台矩阵(linux/darwin/win32 × x64/arm64)生成。原默认的 Node.js SEA 流水线已退役:node-pty 与 pi-tui helper 统一由打包资产缓存加载、URL-fetch SSRF 语义跨运行时一致(统一捆绑 undici)、自更新感知引擎且仍识别旧 SEA 安装、`/status` 显示 Runtime 行。
 - 其他多项修复和体验优化。
 
 如需了解面向贡献者的更深入说明与集成细节，请参见根目录 `AGENTS.md` → "Fork-specific additions vs upstream"（中文语境参见对应章节）。

apps/kimi-web/CHANGELOG.md

@@ -1,7 +1,9 @@
 # @moonshot-ai/kimi-web
 
-> **Note**: kimi-web is excluded from the pnpm workspace and does not maintain an independent changelog.
-> It ships as part of the Kimi Code CLI release (see `apps/kimi-code/CHANGELOG.md`); entries below only cover the period when it was published separately.
+> **Note**: kimi-web is excluded from the root Bun workspace (it keeps its own pnpm setup)
+> and does not maintain an independent changelog.
+> It ships as part of the Kimi Code CLI release (see `apps/kimi-code/CHANGELOG.md`); entries
+> below only cover the period when it was published separately.
 
 ## 0.1.2
 

docs/AGENTS.md

@@ -173,7 +173,7 @@ Outline prompt:
 
 ```
 * Install and upgrade
-  * System requirements: Node.js 24.15.0+, recommend pnpm
+  * System requirements: Node.js 24.15.0+, recommend npm
   * Install, upgrade, uninstall steps
 ```
 
@@ -185,7 +185,7 @@ Outline prompt:
 ### System requirements
 
 - Node.js 24.15.0+
-- Recommend pnpm
+- Recommend npm
 
 ### Install
 
@@ -201,9 +201,9 @@ Outline prompt:
 ```markdown
 ## Install and upgrade
 
-Kimi Code CLI requires Node.js 24.15.0 or later. We recommend using pnpm for installation and management.
+Kimi Code CLI requires Node.js 24.15.0 or later. We recommend using npm for installation and management.
 
-If you haven't installed pnpm yet, please refer to the pnpm installation docs first. Install Kimi Code CLI:
+If you haven't installed npm yet, please refer to the npm installation docs first. Install Kimi Code CLI:
 
 (code block)
 
@@ -318,11 +318,11 @@ Before shipping, verify these values match the rest of the docs:
 ## Build and preview
 
 - Docs are built with VitePress from `docs/`.
-- Common commands (run inside `docs/`):
-  - `npm install`
-  - `npm run dev`
-  - `npm run build`
-  - `npm run preview`
+- Common commands (run inside `docs/`, or from the repo root via `bun run dev:docs`):
+  - `bun install`
+  - `bun run dev`
+  - `bun run build`
+  - `bun run preview`
 - The build output is `docs/.vitepress/dist`.
 
 ## Changelog syncing

packages/kap-server/AGENTS.md

@@ -41,4 +41,4 @@ The global search surface is `POST /api/v1/search` (`src/search/` + `src/routes/
 - Every query runs under explicit budgets (max terms, postings visits via `MiniDb.searchBoundedAsync`, candidate caps, confirmation text volume, a match deadline) with over-budget pages flagged `incomplete: 'candidate_cap' | 'postings_budget' | 'deadline'`. The budget VALUES are centralized: per-query work budgets in `src/search/searchService.ts` (mirrored as service test knobs), worker-host budgets in `src/search/worker/host.ts` (ready/close/request/sync watchdogs, heap cap, crash backoff), minidb's process-wide worker slots and slice budgets in `packages/minidb/src/maintenance.ts` / `recovery.ts`. Query concurrency is structural, not a semaphore: one worker thread per service serializes all index-route CPU work, each query is individually budgeted and watchdogged, and the worker heap cap turns a pathological burst into a degraded-restart rather than a main-process stall.
 - Pagination is keyset over `(time, key)` / `(score, time, key)` with versioned v2 tokens pinning the index generation (a rebuild/reopen/rescan invalidates old tokens with `invalid_page_token`; legacy v1 offset tokens are still accepted and upgraded), and per-session sync scans only that session's file-meta keys (`\0meta\file\<sessionId>\<hash>`, migrated from the pre-v2 hash-only keys by a one-time background pass).
 - When `container.session_id` is provided and that session is live in this process (`TranscriptService.forSessionLive` returns a store, wired via `setLiveTranscriptSource` in `start.ts`), BOTH modes instead scan the in-memory transcript store (turn prompts + assistant text frames, history established via `whenReady`/`ensureAgentHistory`) — no index involved; terms-mode live hits are scored Σ log(1+tf) (comparable only within a route, per the `GlobalSearchSource` contract), live-route errors never fall back to the index, and the response's `source: 'live' | 'index'` field (also mixed into the page-token fingerprint, so a mid-pagination route flip invalidates the old token) tells the caller which route served the page.
-- Dev/test worker runtime: the worker entry (`src/search/worker/entry.ts`) loads from TS source under Node's native type stripping plus a repo-local `.js`→`.ts` resolve hook (`src/search/worker/register-dev-hooks.mjs`); the npm bundle emits `dist/search-worker.mjs` (`apps/kimi-code/tsdown.dist-worker.config.ts`); the SEA binary embeds it as the `kap-search-worker` runtime asset (`apps/kimi-code/scripts/native/manifest.mjs`), installed at startup by `apps/kimi-code/src/native/search-worker.ts`.
+- Dev/test worker runtime: the worker entry (`src/search/worker/entry.ts`) loads from TS source under Node's native type stripping plus a repo-local `.js`→`.ts` resolve hook (`src/search/worker/register-dev-hooks.mjs`); the npm bundle emits `dist/search-worker.mjs` (`apps/kimi-code/tsdown.dist-worker.config.ts`); the Bun single-file binary embeds it as the `kap-search-worker` runtime asset (`apps/kimi-code/scripts/native/manifest.mjs`), installed at startup by `apps/kimi-code/src/native/search-worker.ts`.

scripts/generate-locale-json.cjs

@@ -1,7 +1,7 @@
 /**
  * Generate JSON locale files from TypeScript locale sources.
  *
- * Usage: pnpm run generate:locale-json
+ * Usage: bun run generate:locale-json
  *
  * Reads each TS locale file and writes its JSON equivalent so the
  * Rust i18n engine can load them directly without runtime serialization.

scripts/prompt-optimizer/knowledge-rs/standards.md

@@ -136,7 +136,7 @@ scope:
 tags: node, bun, environment
 scope: 
 
-需要 Node.js >= 24.15.0、Bun >= 1.4.0（`bunfig.toml` 钉了 hoisted linker）。Node 版本不满足会让 SEA 构建脚本直接报错。
+需要 Node.js >= 24.15.0、Bun >= 1.4.0（`bunfig.toml` 钉了 hoisted linker）。Node 版本不满足会让原生打包脚本（`bun run build:native:bun`）直接报错。
 
 ---