@nbtca/prompt 1.0.9 → 1.0.14

package/.github/workflows/publish.yml

@@ -1,59 +0,0 @@
-name: Publish to npm
-
-on:
-  push:
-    tags:
-      - "v*"
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      id-token: write
-
-    steps:
-      - name: 🛎️ Checkout code
-        uses: actions/checkout@v4
-
-      - name: 🟢 Set up Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: "20"
-          registry-url: "https://registry.npmjs.org/"
-          cache: "npm"
-
-      - name: 📦 Install dependencies
-        run: npm ci
-
-      - name: 🔨 Build TypeScript
-        run: npm run build
-
-      - name: ✅ Verify build
-        run: |
-          test -d dist || (echo "dist directory not found" && exit 1)
-          test -f dist/index.js || (echo "dist/index.js not found" && exit 1)
-          echo "Build artifacts verified"
-
-      - name: 📋 Check package version
-        id: version
-        run: |
-          TAG_VERSION=${GITHUB_REF#refs/tags/v}
-          PKG_VERSION=$(node -p "require('./package.json').version")
-          echo "Tag version: $TAG_VERSION"
-          echo "Package version: $PKG_VERSION"
-          if [ "$TAG_VERSION" != "$PKG_VERSION" ]; then
-            echo "Version mismatch! Tag: v$TAG_VERSION, package.json: v$PKG_VERSION"
-            exit 1
-          fi
-          echo "version=$PKG_VERSION" >> $GITHUB_OUTPUT
-
-      - name: 🚀 Publish to npm
-        run: npm publish --access public --provenance
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: ✅ Success notification
-        run: |
-          echo "🎉 Successfully published @nbtca/prompt@${{ steps.version.outputs.version }} to npm"
-

package/CHANGELOG.md

@@ -1,125 +0,0 @@
-# CHANGELOG
-
-## [1.0.5] - 2025-12-10
-
-### Fixed
-- **Knowledge Base 403 Error**: Resolved GitHub API rate limiting issue that caused 403 errors when browsing documentation
-  - Added GitHub token authentication support via `GITHUB_TOKEN` or `GH_TOKEN` environment variables
-  - Improved error messages with rate limit information and reset time
-  - Increased rate limit from 60 to 5000 requests per hour when using a token
-
-### Added
-- **Pager-Style Document Viewer**: Documents now open in a pager (similar to vim/journalctl/less)
-  - Natural scrolling navigation with arrow keys, Space, j/k (vim-style), and q to quit
-  - Content doesn't flood the terminal anymore
-  - Better reading experience for long documents
-  - Automatic fallback to direct output if pager is unavailable
-- **Re-read Document Option**: Added ability to re-read a document after viewing without going back to the list
-- **Environment Variable Support**:
-  - `GITHUB_TOKEN` or `GH_TOKEN` for GitHub API authentication
-  - `PAGER` for custom pager selection (defaults to `less`)
-
-### Improved
-- Enhanced error handling with detailed rate limit diagnostics
-- Better user feedback when rate limits are reached
-- Clearer instructions for resolving authentication issues
-
-### Technical Details
-- Added `displayInPager()` function for spawning system pager processes
-- Enhanced `fetchGitHubDirectory()` with conditional token authentication
-- Updated documentation viewer workflow for better UX
-
-## [1.0.4] - 2025-12-10
-
-### Enhanced
-- **Smooth Slogan Animation**: Implemented true color interpolation for buttery smooth gradient animation
-  - Increased frame rate from 24 to 60 FPS for ultra-smooth motion
-  - Changed easing from cubic to sine wave for more natural transitions
-  - Dynamically generate gradients per frame instead of using pre-defined set
-  - Eliminates staggered/jumping effect in the slogan text animation
-
-### Technical Details
-- Added `hexToRgb()`, `rgbToHex()`, and `interpolateColor()` functions for mathematical color blending
-- Implemented `easeInOutSine()` easing function for smooth acceleration/deceleration
-- Each frame now uses unique, mathematically interpolated colors
-
-## [1.0.3] - 2025-11-27
-
-### Changed
-- Version alignment and bug fixes
-
-## [1.0.2] - 2025-11-27
-
-### Added
-- **Terminal Documentation Viewer**: Browse and read Markdown documentation from nbtca/documents repository directly in terminal
-  - GitHub API integration for fetching directory structure and file contents
-  - Recursive directory navigation with [DIR] and [MD] indicators
-  - VitePress syntax cleaning (frontmatter, containers, [[toc]], HTML comments)
-  - Terminal Markdown rendering using marked-terminal
-  - Browser fallback on network errors or user preference
-  - Retry mechanism for failed network requests
-
-### Changed
-- **ASCII-Only Interface**: Removed all emoji icons for maximum terminal compatibility
-  - Replaced emoji with ASCII symbols: [*], [?], [x], [..], [DIR], [MD], [ <], [ ^], [ *]
-  - Works on all terminal emulators, SSH sessions, tmux, and legacy systems
-  - Follows Unix/Linux terminal conventions
-  - Professional, minimalist design
-
-### Improved
-- **Terminal UX Enhancements**:
-  - Added keybinding hints to main menu: "Navigation: j/k or ↑/↓ | Jump: g/G | Quit: q or Ctrl+C"
-  - Added ESC key infrastructure for future back navigation and operation cancellation
-  - Standardized navigation symbols across all menus
-  - Better vim-keys.ts documentation with clearer comments
-
-### Fixed
-- **Development Workflow**: Fixed `pnpm run dev` auto-restart issue
-  - Split dev command: `dev` (no watch, for interactive CLI) and `dev:watch` (with watch mode)
-  - Proper exit behavior for interactive CLI testing
-
-### Documentation
-- Added DEVELOPMENT.md: Comprehensive development guide with workflows, testing methods, and common issues
-- Added TERMINAL_UX.md: Terminal UX improvements and compatibility documentation
-- Updated README.md: Professional, concise documentation without decorative elements
-
-### Technical Details
-- Enhanced docs.ts with GitHub repository integration
-- Improved menu.ts with ASCII symbols and keybinding hints
-- Enhanced vim-keys.ts with ESC support and better documentation
-- Better package.json scripts for development workflow
-
-## [1.0.1] - 2025-11-21
-
-### Added
-- New English tagline with smooth blue gradient animation
-- Full Vim keybindings support (j/k/g/G/q)
-- Minimalist UI design inspired by Claude Code CLI
-
-### Improved
-- Smoother gradient animation (24 frames, 1.2s duration)
-- Removed keyboard instruction text for cleaner interface
-- Blue color scheme throughout (deep blue → sky blue → cyan)
-
-### Changed
-- q key now exits the application
-- Removed Chinese tagline
-- Simplified menu layout
-
-### Removed
-- Unused DATA_MANAGEMENT.md documentation
-
-### Dependencies
-- Updated gradient-string to ^3.0.0
-- Updated @inquirer/prompts to ^8.0.3
-
-## [1.0.0] - 2025-11-21
-
-### Added
-- Initial release of NBTCA Prompt CLI tool
-- Interactive terminal menu system
-- Event calendar integration
-- Repair service information
-- Knowledge base access
-- Quick links to official website and GitHub
-- About section with project information

package/DEVELOPMENT.md

@@ -1,258 +0,0 @@
-# 开发指南
-
-## 🚀 快速开始
-
-### 安装依赖
-
-```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 渲染美观
-- [ ] 错误处理友好
-- [ ] 导航流畅

package/TERMINAL_UX.md

@@ -1,184 +0,0 @@
-# Terminal UX Improvements
-
-## Summary
-
-All changes align with standard Linux/Unix terminal conventions for better user experience and consistency.
-
-## Changes Made
-
-### 1. Standardized Navigation Symbols
-
-**Before**:
-```
-[📁] emoji icons
-[<-] inconsistent arrows
-[ ] empty brackets
-```
-
-**After**:
-```
-[..] - Up to parent directory (Unix convention)
-[ <] - Back/Previous
-[ ^] - Return to main menu
-[ *] - Special action (open in browser)
-[DIR] - Directory indicator
-[MD]  - Markdown file indicator
-[ ?] - Help/About
-[ x] - Exit
-```
-
-**Rationale**: ASCII-only symbols ensure maximum terminal compatibility and follow Unix conventions (e.g., `..` for parent directory).
-
-### 2. Added Keybinding Hints
-
-**Main Menu**:
-```
-Navigation: j/k or ↑/↓ | Jump: g/G | Quit: q or Ctrl+C
-```
-
-**Location**: Displayed above main menu for visibility
-
-**Rationale**: Users should know available shortcuts without reading documentation.
-
-### 3. ESC Key Support
-
-**Implementation**: ESC key now properly passed through to menus
-
-**Expected Behavior** (future enhancement):
-- ESC in submenus = go back one level
-- ESC in main menu = exit application
-
-**Current State**: Infrastructure added, full implementation needs inquirer customization
-
-**Rationale**: ESC is standard cancel/back key in Unix terminals.
-
-### 4. Improved Documentation
-
-**Added Descriptions**:
-- Knowledge Base menu now shows purpose
-- Comments in code clarified
-
-**Rationale**: Self-documenting UI reduces user confusion.
-
-## Navigation Symbol Reference
-
-```
-Symbol  | Meaning                  | Unix Standard
---------|--------------------------|---------------
-[..]    | Parent directory         | Yes (cd ..)
-[DIR]   | Directory entry          | Common
-[MD]    | Markdown file            | N/A
-[ <]    | Go back/previous         | No (custom)
-[ ^]    | Go to top/main menu      | No (custom)
-[ *]    | Special action           | No (custom)
-[ ?]    | Help/Information         | Common (man ?)
-[ x]    | Exit/Quit                | No (custom)
-```
-
-## Keybinding Reference
-
-```
-Key     | Action                | Standard
---------|----------------------|----------
-↑/↓     | Navigate up/down     | Yes
-j/k     | Navigate up/down     | Vim
-g       | Jump to first        | Vim
-G       | Jump to last         | Vim
-q       | Quit application     | Vim/less/man
-ESC     | Cancel/Go back       | Yes
-Ctrl+C  | Force quit           | Yes
-Enter   | Select/Confirm       | Yes
-```
-
-## Comparison with Common Unix Tools
-
-### less/more
-- j/k navigation: ✓ Supported
-- g/G jump: ✓ Supported
-- q quit: ✓ Supported
-- ESC: Usually not used
-
-### man
-- j/k navigation: ✓ Supported
-- g/G jump: ✓ Supported
-- q quit: ✓ Supported
-- h for help: Not implemented (use [?] menu item)
-
-### vim
-- j/k navigation: ✓ Supported
-- g/G jump: ✓ Supported
-- q quit: ✓ Supported
-- ESC: ✓ Infrastructure added
-
-### fzf (fuzzy finder)
-- j/k navigation: ✓ Supported
-- Ctrl+C quit: ✓ Supported
-- ESC cancel: ✓ Infrastructure added
-
-## Implementation Details
-
-### vim-keys.ts
-- Maps j/k to arrow keys
-- Maps g/G to home/end
-- Maps q to Ctrl+C
-- Passes ESC through for menu handling
-
-### menu.ts
-- Shows keybinding hints before menu
-- Standardized symbol usage
-- Consistent formatting
-
-### docs.ts
-- Uses [..] for parent directory (Unix standard)
-- Uses [ ^] for main menu (clear intent)
-- Uses [ <] for back navigation
-- Added descriptive subtitle
-
-## Terminal Compatibility
-
-All symbols tested and work correctly on:
-- iTerm2 (macOS)
-- Terminal.app (macOS)
-- GNOME Terminal (Linux)
-- Windows Terminal
-- PuTTY (SSH)
-- tmux/screen multiplexers
-
-## Future Enhancements
-
-1. **Context-aware q key**: Currently q always exits. Consider:
-   - q in submenu = go back
-   - Q (shift) = force quit
-
-2. **ESC back navigation**: Full implementation requires:
-   - Custom inquirer plugin or wrapper
-   - State management for menu stack
-
-3. **Help overlay**: F1 or ? key for:
-   - Show all keybindings
-   - Context-sensitive help
-
-4. **Breadcrumb trail**: Show current location:
-   ```
-   Main > Docs > Tutorial > Getting Started
-   ```
-
-5. **Operation cancellation**: Allow Ctrl+C during:
-   - Network requests
-   - File loading
-   - Long operations
-
-## Migration Notes
-
-### Breaking Changes
-None. All changes are additive or improve existing behavior.
-
-### User-Facing Changes
-- New keybinding hints displayed
-- Updated navigation symbols (more intuitive)
-- ESC key now recognized (infrastructure)
-
-### Developer Notes
-- ESC handling requires inquirer extension for full functionality
-- Current implementation provides foundation
-- Symbol constants could be extracted to config