build: migrate cli sources to typescript

Author: pallyoung

.github/workflows/release.yml

@@ -102,10 +102,10 @@ jobs:
           cache: pnpm
           registry-url: 'https://registry.npmjs.org'
       - run: pnpm install --frozen-lockfile
-      - run: pnpm version:check
+      - run: pnpm release:check
       - run: node -e "require('fs').mkdirSync('.artifacts', { recursive: true })"
-      - run: pnpm --dir packages/cli pack --pack-destination ../../.artifacts
-      - run: npm publish packages/cli --access public
+      - run: pnpm --dir .build/stage/npm/coder-studio pack --pack-destination ../../../../.artifacts
+      - run: npm publish .build/stage/npm/coder-studio --access public
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
       - uses: actions/upload-artifact@v4

README.en.md

@@ -92,12 +92,14 @@ The repository is organized into three layers:
 - source
   - `apps/web`: frontend source
   - `apps/server`: Rust / Tauri server source
-  - `packages/cli`: npm CLI package source
+  - `packages/cli`: npm CLI package source and publish metadata
+  - `packages/cli/src`: CLI TypeScript source
 - templates
   - `templates/npm/platform-packages/*`: per-platform npm package templates
 - build outputs
   - `.build/web/dist`: frontend build output
   - `.build/server/target`: Rust build output
+  - `.build/cli`: compiled CLI output
   - `.build/stage/npm/*`: pre-publish staging packages
   - `.artifacts/`: tarballs, manifests, and checksums
 
@@ -148,6 +150,12 @@ Server runtime build:
 pnpm build:server
 ```
 
+CLI build:
+
+```bash
+pnpm build:cli
+```
+
 Tauri shell build:
 
 ```bash

README.md

@@ -58,12 +58,14 @@ pnpm install
 - 源码层
   - `apps/web`：前端源码
   - `apps/server`：Rust / Tauri 服务端源码
-  - `packages/cli`：npm CLI 包源码
+  - `packages/cli`：npm CLI 包源码与发布元数据
+  - `packages/cli/src`：CLI TypeScript 源码
 - 模板层
   - `templates/npm/platform-packages/*`：各平台 npm 包模板
 - 产物层
   - `.build/web/dist`：前端构建产物
   - `.build/server/target`：Rust 构建产物
+  - `.build/cli`：CLI 编译产物
   - `.build/stage/npm/*`：发布前 staging 包
   - `.artifacts/`：最终 tarball、manifest、checksum
 
@@ -147,6 +149,12 @@ pnpm build
 pnpm build:server
 ```
 
+构建 CLI：
+
+```bash
+pnpm build:cli
+```
+
 构建 Tauri 壳层：
 
 ```bash

docs/development/README.en.md

@@ -52,6 +52,7 @@ Current development ports:
 - server entry point: `apps/server/src/main.rs`
 - server HTTP transport layer: `apps/server/src/command/http.rs`
 - Rust services: `apps/server/src/services/`
+- CLI TypeScript source: `packages/cli/src/`
 
 ## Document Index
 

docs/development/README.md

@@ -54,6 +54,7 @@ pnpm dev:stack
 - server 入口：`apps/server/src/main.rs`
 - server HTTP 传输层：`apps/server/src/command/http.rs`
 - Rust 服务实现：`apps/server/src/services/`
+- CLI TypeScript 源码：`packages/cli/src/`
 
 ## 文档列表
 

docs/development/npm-release.en.md

@@ -4,18 +4,20 @@
 
 The repository now publishes these packages:
 
-- `packages/cli`: source for the primary `@spencer-kit/coder-studio` package
+- `packages/cli`: source manifest and publish metadata for the primary `@spencer-kit/coder-studio` package
+- `packages/cli/src`: CLI TypeScript source
 - `templates/npm/platform-packages/*`: platform package templates
-- `.build/stage/npm/*`: generated publish staging directories
+- `.build/cli`: compiled CLI output
+- `.build/stage/npm/*`: generated publish staging directories for the main package and platform packages
 - `.artifacts/`: final tarballs, manifest, and checksums
 
 Layer responsibilities:
 
-- source: `packages/cli`, `apps/web`, `apps/server`
+- source: `packages/cli`, `packages/cli/src`, `apps/web`, `apps/server`
 - templates: `templates/npm/platform-packages/*`
-- build outputs: `.build/web/dist`, `.build/server/target`, `.build/stage/npm/*`, `.artifacts/`
+- build outputs: `.build/web/dist`, `.build/server/target`, `.build/cli`, `.build/stage/npm/*`, `.artifacts/`
 
-The main package owns the CLI. Platform package templates own publish metadata. The staging directories receive native binaries and built frontend assets.
+The main package source owns the CLI implementation, `.build/cli` receives compiled output, platform package templates own publish metadata, and the staging directories receive the actual publishable package contents.
 
 ## CLI Usage
 
@@ -67,7 +69,8 @@ Use `CODER_STUDIO_HOME` to override the state directory for tests or isolated en
 ```bash
 pnpm version:check
 pnpm build:web
-pnpm build:runtime
+pnpm build:server
+pnpm build:cli
 pnpm build:packages
 pnpm pack:local
 pnpm release:verify
@@ -78,8 +81,9 @@ What they do:
 
 - `version:check`: verifies the root package, main package, platform packages, `Cargo.toml`, and `tauri.conf.json` all share the same version
 - `build:web`: builds the frontend into `.build/web/dist`
-- `build:runtime`: builds the Rust/Tauri release binary into `.build/server/target`
-- `build:packages`: materializes `.build/stage/npm/<platform>` from templates and injects the binary plus frontend assets
+- `build:server`: builds the Rust/Tauri release binary into `.build/server/target`
+- `build:cli`: compiles `packages/cli/src` into `.build/cli`
+- `build:packages`: materializes `.build/stage/npm/coder-studio` and `.build/stage/npm/<platform>` by injecting compiled CLI output plus native/frontend assets
 - `pack:local`: runs the release build and emits local tarballs into `.artifacts/`
 - `release:verify`: runs version checks, CLI tests, Rust tests, local packaging, and smoke validation
 - `release:verify:full`: adds release E2E on top of `release:verify`
@@ -142,7 +146,10 @@ ls .artifacts
 - `release-manifest.json`
 - `SHA256SUMS.txt`
 
-`.build/stage/npm/` holds the generated publishable staging package for the current platform.
+`.build/stage/npm/` holds:
+
+- `coder-studio`: the generated publishable main package
+- `<platform>`: the generated publishable runtime package for the current platform
 
 ## GitHub Actions
 
@@ -162,7 +169,7 @@ The automation is split into three workflows:
 - `release.yml`
   - starts with a `preflight` job that validates the tag and runs `pnpm version:check`
   - publishes the 4 platform runtime packages from `.build/stage/npm/*`
-  - publishes the main `@spencer-kit/coder-studio` package
+  - publishes the main `@spencer-kit/coder-studio` package from `.build/stage/npm/coder-studio`
   - aggregates tarballs and attaches `release-manifest.json` plus `SHA256SUMS.txt` to the GitHub Release
 
 ## Release Trigger

docs/development/npm-release.md

@@ -4,18 +4,20 @@
 
 当前仓库已经拆成以下发布结构：
 
-- `packages/cli`：主 npm 包源码，发布名为 `@spencer-kit/coder-studio`
+- `packages/cli`：主 npm 包源码与发布元数据，发布名为 `@spencer-kit/coder-studio`
+- `packages/cli/src`：CLI TypeScript 源码
 - `templates/npm/platform-packages/*`：平台包模板
-- `.build/stage/npm/*`：平台包 staging 目录
+- `.build/cli`：CLI 编译产物
+- `.build/stage/npm/*`：主包与平台包 staging 目录
 - `.artifacts/`：最终 tarball、manifest、checksum
 
 分层职责：
 
-- 源码层：`packages/cli`、`apps/web`、`apps/server`
+- 源码层：`packages/cli`、`packages/cli/src`、`apps/web`、`apps/server`
 - 模板层：`templates/npm/platform-packages/*`
-- 产物层：`.build/web/dist`、`.build/server/target`、`.build/stage/npm/*`、`.artifacts/`
+- 产物层：`.build/web/dist`、`.build/server/target`、`.build/cli`、`.build/stage/npm/*`、`.artifacts/`
 
-主包负责 CLI，平台包模板负责发布元数据，staging 目录负责承接原生二进制和前端静态资源。
+主包源码负责 CLI 的 TypeScript 实现，`.build/cli` 承接编译结果，平台包模板负责发布元数据，staging 目录负责承接真正可发布的 npm 包内容。
 
 ## CLI 用法
 
@@ -67,7 +69,8 @@ CLI 默认会在本机状态目录下写入运行信息：
 ```bash
 pnpm version:check
 pnpm build:web
-pnpm build:runtime
+pnpm build:server
+pnpm build:cli
 pnpm build:packages
 pnpm pack:local
 pnpm release:verify
@@ -78,8 +81,9 @@ pnpm release:verify:full
 
 - `version:check`：校验根包、主包、平台包、`Cargo.toml`、`tauri.conf.json` 版本是否完全一致
 - `build:web`：构建前端到 `.build/web/dist`
-- `build:runtime`：构建 Rust/Tauri release 二进制到 `.build/server/target`
-- `build:packages`：从模板目录生成 `.build/stage/npm/<platform>`，并注入二进制与前端产物
+- `build:server`：构建 Rust/Tauri release 二进制到 `.build/server/target`
+- `build:cli`：把 `packages/cli/src` 编译到 `.build/cli`
+- `build:packages`：生成 `.build/stage/npm/coder-studio` 和当前平台的 `.build/stage/npm/<platform>`，分别注入 CLI 编译产物与原生二进制/前端产物
 - `pack:local`：执行 release 构建后，生成本地主包和当前平台包 tarball 到 `.artifacts/`
 - `release:verify`：跑版本校验、CLI 单测、Rust 单测、本地打包和 smoke
 - `release:verify:full`：在 `release:verify` 基础上追加 release E2E
@@ -142,7 +146,10 @@ ls .artifacts
 - `release-manifest.json`
 - `SHA256SUMS.txt`
 
-而 `.build/stage/npm/` 会包含当前平台的可发布 staging 包目录。
+而 `.build/stage/npm/` 会包含：
+
+- `coder-studio`：主包 staging 目录
+- `<platform>`：当前平台运行时包 staging 目录
 
 ## GitHub Actions
 
@@ -162,7 +169,7 @@ ls .artifacts
 - `release.yml`
   - 先执行 `preflight` 校验 tag 与版本一致，并跑 `pnpm version:check`
   - 再按平台矩阵从 `.build/stage/npm/*` 发布 4 个运行时包
-  - 再发布主包 `@spencer-kit/coder-studio`
+  - 再从 `.build/stage/npm/coder-studio` 发布主包 `@spencer-kit/coder-studio`
   - 最后汇总 tarball，生成 `release-manifest.json` 和 `SHA256SUMS.txt`，附加到 GitHub Release
 
 ## 发布触发方式

package.json

@@ -13,17 +13,18 @@
     "build:web": "vite build",
     "build:server": "cargo build --release --manifest-path apps/server/Cargo.toml",
     "build:runtime": "pnpm build:server",
+    "build:cli": "node scripts/build/build-cli.mjs",
     "check:server": "cargo check --manifest-path apps/server/Cargo.toml",
     "test:server": "cargo test --manifest-path apps/server/Cargo.toml",
     "build:packages": "node scripts/build/build-packages.mjs",
     "preview": "vite preview",
     "tauri": "node scripts/dev/run-tauri.mjs",
     "test:e2e": "playwright test",
-    "test:e2e:release": "playwright test -c playwright.release.config.ts",
-    "test:cli": "node --test tests/cli/config.test.mjs tests/cli/platform.test.mjs tests/release/release.test.mjs",
+    "test:e2e:release": "pnpm build:web && pnpm build:server && pnpm build:cli && playwright test -c playwright.release.config.ts",
+    "test:cli": "pnpm build:cli && node --test tests/cli/config.test.mjs tests/cli/platform.test.mjs tests/release/release.test.mjs",
     "test:smoke": "node --test tests/smoke/cli-smoke.test.mjs",
     "pack:local": "pnpm release:check && node scripts/release/pack-local.mjs",
-    "release:check": "pnpm version:check && pnpm build:web && pnpm build:server && pnpm build:packages",
+    "release:check": "pnpm version:check && pnpm build:web && pnpm build:server && pnpm build:cli && pnpm build:packages",
     "release:verify": "pnpm test:cli && pnpm test:server && pnpm pack:local && pnpm test:smoke",
     "release:verify:full": "pnpm release:verify && pnpm test:e2e:release",
     "version:sync": "node scripts/release/sync-version.mjs",
@@ -51,6 +52,7 @@
     "@changesets/cli": "^2.29.7",
     "@playwright/test": "^1.58.2",
     "@tauri-apps/cli": "^2.0.0",
+    "@types/node": "^24.6.1",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^6.0.1",

packages/cli/bin/coder-studio.mjs packages/cli/src/bin/coder-studio.mtspackages/cli/bin/coder-studio.mjs renamed to packages/cli/src/bin/coder-studio.mts

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// @ts-nocheck
 import { runCli } from '../lib/cli.mjs';
 
 runCli().then((code) => {

packages/cli/lib/cli.mjs packages/cli/src/lib/cli.mtspackages/cli/lib/cli.mjs renamed to packages/cli/src/lib/cli.mts

@@ -1,3 +1,4 @@
+// @ts-nocheck
 import fs from 'node:fs/promises';
 import {
   generateCompletionScript,