feat: replace inquirer with @clack/prompts for modern TUI (#13)

* fix: align Node.js engine requirement with runtime dependencies

* feat: improve terminal UX with command mode and docs loop

* feat: add roadmap shortcut in menu and command mode

* feat: polish terminal UX with unix-style command mode

* chore: migrate docs to wiki and prepare v1.0.10 release

* chore: reduce npm package payload with files whitelist

* chore: release v1.0.11 with publish diagnostics

* chore: release v1.0.12

* chore: release v1.0.13

* feat: replace inquirer with @clack/prompts for modern TUI

Replaces the entire inquirer stack with @clack/prompts, bringing the
terminal experience in line with modern CLIs (Claude Code, Gemini CLI).

Changes:
- Drop inquirer, @inquirer/prompts, @types/inquirer (-87 packages)
- Add @clack/prompts (+4 packages)
- ui.ts: delegate success/error/info/warn to clack log.*; add
  createSpinner() that returns a real async-bound SpinnerResult
- menu.ts: select() with emoji labels + hint text; isCancel + outro
  for graceful Ctrl+C exit; showAbout() now uses note() info box
- main.ts: printHeader() replaced by intro() session frame
- calendar.ts: real spinner bound to fetchEvents(); Unicode box-drawing
  table (┌─┬─┐) replaces dashed ASCII output
- repair.ts, website.ts: spinner wraps open() instead of fake timer
- docs.ts: all inquirer prompts replaced with select()/confirm();
  doc category labels updated with emoji icons
- i18n: add eventsFound key (zh + en); add field to Translations type

Backward compatibility: src/index.ts script mode is untouched.
All non-interactive commands (--json, --help, lang) continue to work.

Author: m1ngsama

.github/workflows/ci.yml

@@ -12,7 +12,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [18, 20]
+        node-version: [20, 22]
 
     steps:
       - name: 🛎️ Checkout code

.github/workflows/publish.yml

@@ -49,11 +49,21 @@ jobs:
           echo "version=$PKG_VERSION" >> $GITHUB_OUTPUT
 
       - name: 🚀 Publish to npm
-        run: npm publish --access public --provenance
+        run: |
+          set +e
+          PUBLISH_OUTPUT=$(npm publish --access public --provenance 2>&1)
+          PUBLISH_EXIT=$?
+          set -e
+          echo "$PUBLISH_OUTPUT"
+          if [ "$PUBLISH_EXIT" -ne 0 ]; then
+            if echo "$PUBLISH_OUTPUT" | grep -q "EOTP"; then
+              echo "::error::npm publish failed with EOTP. Use an npm automation token for NPM_TOKEN or disable OTP requirement for token-based publish."
+            fi
+            exit "$PUBLISH_EXIT"
+          fi
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
       - name: ✅ Success notification
         run: |
           echo "🎉 Successfully published @nbtca/prompt@${{ steps.version.outputs.version }} to npm"
-

.nvmrc

@@ -0,0 +1 @@
+20.12.0

CHANGELOG.md

@@ -1,5 +1,47 @@
 # CHANGELOG
 
+Release notes are maintained in Wiki:
+
+- https://github.com/nbtca/Prompt/wiki/Release-Notes
+
+## [Unreleased]
+
+## [1.0.13] - 2026-03-01
+
+### Changed
+- Re-triggered release after rotating to npm classic automation token.
+
+## [1.0.12] - 2026-03-01
+
+### Changed
+- Triggered re-release after rotating npm automation token.
+
+## [1.0.11] - 2026-03-01
+
+### Changed
+- Improved npm publish workflow diagnostics for OTP-related failures (`EOTP`).
+- Reduced npm package payload via `files` whitelist in `package.json`.
+
+## [1.0.10] - 2026-03-01
+
+### Added
+- Command mode flags:
+  - `--open` for explicit browser side effects on URL commands
+  - `--json` for machine-readable event output
+  - `--plain` for non-colored terminal output
+  - `--no-logo` to skip startup logo in interactive mode
+- Roadmap shortcut support in both menu and command mode
+
+### Changed
+- URL commands (`repair`, `website`, `github`, `roadmap`) now print URL by default in command mode
+- Main menu now includes quick command-mode hint
+- Docs menu keeps user in docs flow for repeated operations
+
+### Improved
+- Better non-TTY behavior: startup logo animation is skipped outside interactive terminals
+- Error/warning messages consistently go to `stderr`
+- Terminal UX documentation rewritten with explicit output contract
+
 ## [1.0.5] - 2025-12-10
 
 ### Fixed

DEVELOPMENT.md

@@ -1,258 +1,5 @@
-# 开发指南
+# Development Guide
 
-## 🚀 快速开始
+Moved to Wiki:
 
-### 安装依赖
-
-```bash
-pnpm install
-```
-
-## 🧪 本地测试方法
-
-### ✅ 方法 1: 快速测试（推荐）
-
-```bash
-pnpm run dev
-```
-
-- ✅ 直接运行 TypeScript 源码
-- ✅ 不会自动重启
-- ✅ 适合交互式 CLI 测试
-- ✅ 程序退出后命令才结束
-- ✅ 可以正常使用 Ctrl+C 退出
-
-**使用场景**: 日常开发和功能测试
-
-### 📦 方法 2: 生产环境测试
-
-```bash
-# 步骤 1: 构建
-pnpm run build
-
-# 步骤 2: 运行
-pnpm start
-```
-
-- ✅ 测试编译后的代码
-- ✅ 最接近生产环境
-- ⚠️ 修改代码后需要重新构建
-
-**使用场景**: 发布前最终测试
-
-### 🔗 方法 3: 全局命令测试
-
-```bash
-# 步骤 1: 构建并链接到全局
-pnpm run build
-npm link
-
-# 步骤 2: 在任何目录测试
-nbtca
-
-# 步骤 3: 测试完成后清理
-npm unlink -g @nbtca/prompt
-```
-
-**使用场景**: 测试全局安装体验
-
-### ⚠️ 方法 4: 监听模式（不推荐用于交互式测试）
-
-```bash
-pnpm run dev:watch
-```
-
-- ⚠️ 文件变化时自动重启
-- ❌ 不适合交互式 CLI 测试
-- ❌ 会频繁中断交互
-- ✅ 仅适合纯函数/工具类开发
-
-**使用场景**: 仅用于调试非交互式代码
-
-## 🎯 测试新功能（知识库模块）
-
-### 测试步骤
-
-1. **启动程序**
-   ```bash
-   pnpm run dev
-   ```
-
-2. **选择 "知识库" 选项**
-   - 使用方向键或 Vim 键位 (j/k) 导航
-   - 按 Enter 确认
-
-3. **浏览文档分类**
-   - 📚 教程 (Tutorial)
-   - 🔧 维修日
-   - 🎉 相关活动举办
-   - 📋 流程文档 (Process)
-   - 🛠️ 维修相关 (Repair)
-   - 📦 归档文档 (Archived)
-   - 📖 README
-
-4. **测试功能点**
-   - [ ] 进入目录
-   - [ ] 返回上级目录
-   - [ ] 查看 Markdown 文件
-   - [ ] 终端渲染是否正常
-   - [ ] 在浏览器中打开
-   - [ ] 网络错误处理
-
-### 预期行为
-
-✅ **正常流程**:
-1. 从 GitHub 获取文档列表
-2. 显示目录树
-3. 选择文件后在终端渲染 Markdown
-4. 提供返回或浏览器打开选项
-
-✅ **错误处理**:
-1. GitHub API 失败时提示重试
-2. 文件加载失败时建议浏览器打开
-3. 网络超时友好提示
-
-## 🔧 常见问题
-
-### Q1: 为什么 `pnpm run dev` 比 `pnpm run dev:watch` 好？
-
-**A**: 对于交互式 CLI 应用:
-
-- `pnpm run dev` (tsx src/index.ts)
-  - ✅ 运行一次，等待程序退出
-  - ✅ 用户可以正常交互
-  - ✅ Ctrl+C 正常工作
-
-- `pnpm run dev:watch` (tsx watch src/index.ts)
-  - ❌ 监听文件变化，自动重启
-  - ❌ 用户操作会被中断
-  - ❌ Ctrl+C 只能退出 tsx，不能优雅退出程序
-
-### Q2: 如何退出正在运行的程序？
-
-**A**:
-- **正常退出**: 在菜单中选择 "退出" 选项
-- **强制退出**: 按 `Ctrl+C`
-- 如果卡住: 按 `Ctrl+C` 两次
-
-### Q3: 修改代码后看不到变化？
-
-**A**: 取决于你的测试方法:
-- `pnpm run dev`: 重新运行命令即可
-- `pnpm start`: 需要先 `pnpm run build`
-- `npm link`: 需要 `pnpm run build` 后重新测试
-
-### Q4: TypeScript 编译错误怎么办？
-
-**A**:
-```bash
-# 检查类型错误
-pnpm run build
-
-# 如果有错误，根据提示修复
-# 常见错误:
-# - 导入路径缺少 .js 后缀
-# - 类型定义不匹配
-# - 未使用的变量
-```
-
-## 📝 开发工作流
-
-### 日常开发
-
-```bash
-# 1. 修改代码
-vim src/features/docs.ts
-
-# 2. 测试
-pnpm run dev
-
-# 3. 重复 1-2 直到功能完成
-```
-
-### 提交前检查
-
-```bash
-# 1. 确保构建通过
-pnpm run build
-
-# 2. 测试编译后的代码
-pnpm start
-
-# 3. 提交
-git add .
-git commit -m "feat: add terminal docs viewer"
-```
-
-### 发布前测试
-
-```bash
-# 1. 构建
-pnpm run build
-
-# 2. 全局测试
-npm link
-nbtca
-
-# 3. 清理
-npm unlink -g @nbtca/prompt
-```
-
-## 🎨 代码规范
-
-- 使用 TypeScript 严格模式
-- 函数添加 JSDoc 注释
-- 导入模块使用 `.js` 后缀（即使是 `.ts` 文件）
-- 保持代码简洁，避免过度抽象
-
-## 📂 项目结构
-
-```
-src/
-├── config/           # 配置常量
-│   ├── data.ts      # URL、应用信息
-│   └── theme.ts     # 颜色主题
-│
-├── core/            # 核心功能
-│   ├── logo.ts      # Logo 显示
-│   ├── menu.ts      # 主菜单
-│   ├── ui.ts        # UI 组件
-│   └── vim-keys.ts  # Vim 键位支持
-│
-├── features/        # 功能模块
-│   ├── calendar.ts  # 活动日历
-│   ├── docs.ts      # 知识库 ⭐ 新功能
-│   ├── repair.ts    # 维修服务
-│   └── website.ts   # 网站访问
-│
-├── logo/           # Logo 资源
-├── index.ts        # 入口
-├── main.ts         # 主逻辑
-└── types.ts        # 类型定义
-```
-
-## 🌟 新功能说明
-
-### 知识库终端查看器
-
-**文件**: `src/features/docs.ts`
-
-**核心功能**:
-1. `fetchGitHubDirectory()` - 从 GitHub API 获取目录
-2. `fetchGitHubRawContent()` - 获取文件原始内容
-3. `browseDirectory()` - 交互式目录浏览
-4. `viewMarkdownFile()` - 终端渲染 Markdown
-5. `showDocsMenu()` - 主菜单入口
-
-**依赖**:
-- `axios` - HTTP 请求
-- `marked` + `marked-terminal` - Markdown 渲染
-- `inquirer` - 交互式选择
-- `chalk` - 终端颜色
-
-**测试要点**:
-- [ ] GitHub API 正常调用
-- [ ] 目录树正确显示
-- [ ] Markdown 渲染美观
-- [ ] 错误处理友好
-- [ ] 导航流畅
+- https://github.com/nbtca/Prompt/wiki/Development-Guide

README.md

@@ -17,27 +17,22 @@ Or run directly:
 npx @nbtca/prompt
 ```
 
-## Usage
-
-```bash
-nbtca
-```
-
-Navigate with arrow keys or vim bindings (j/k/g/G).
-
 ## Documentation
 
-See the [Wiki](https://github.com/nbtca/Prompt/wiki) for:
+Project documentation has been moved to the GitHub Wiki.
 
-- [Development Guide](https://github.com/nbtca/Prompt/wiki/Development)
+- [Home](https://github.com/nbtca/Prompt/wiki)
+- [Getting Started](https://github.com/nbtca/Prompt/wiki/Getting-Started)
+- [Development Guide](https://github.com/nbtca/Prompt/wiki/Development-Guide)
+- [Terminal UX](https://github.com/nbtca/Prompt/wiki/Terminal-UX)
+- [Release Notes](https://github.com/nbtca/Prompt/wiki/Release-Notes)
 - [Features](https://github.com/nbtca/Prompt/wiki/Features)
 - [Terminal Compatibility](https://github.com/nbtca/Prompt/wiki/Terminal-Compatibility)
 - [FAQ](https://github.com/nbtca/Prompt/wiki/FAQ)
-- [Changelog](https://github.com/nbtca/Prompt/wiki/Changelog)
 
 ## Requirements
 
-- Node.js >= 16.0.0
+- Node.js >= 20.12.0
 
 ## License