Skip to content

Release Notes

Jump to bottom
m1ngsama edited this page Mar 1, 2026 · 1 revision

CHANGELOG

[Unreleased]

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

  • 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

Clone this wiki locally