thelapyae 0.3.1 → 0.5.0

package/CHANGELOG.md

@@ -5,6 +5,38 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.0] - 2026-01-20
+
+### Added
+- **Full TUI Overhaul**: Implemented a rich Text User Interface (TUI) with a centralized layout and header.
+- **Integrated CLI-to-TUI Consultation**: Running `thelapyae "your question"` now seamlessly launches the TUI and auto-starts the consultation.
+- **Dynamic UI Labels**: Titles and input box labels now update dynamically based on the current mode (e.g., "Consultation", "API Configuration", "Help").
+- **Inline Commands**: Converted popup dialogs for `/help`, `/config`, and `/sessions` into inline views for a more fluid experience.
+- **New Slash Commands**: Added `/new` to start a fresh session and `/exit` to cleanly quit the application.
+- **Branding & Aesthetics**: Added brand color (#f3c12b) and improved text alignment and layout responsiveness.
+
+### Changed
+- **Navigation**: Standardized Esc key to act as a "Back" button to return to the welcome screen from any command view.
+- **Default Behavior**: Removed redundant `q` and `Ctrl+N` keyboard shortcuts in favor of more explicit slash commands and Ctrl+C.
+- **Layout**: Simplified the main layout to prioritize readability with left-aligned examples and centered headers.
+
+### Fixed
+- **Input Issues**: Resolved double character input and accidental Vim mode triggers in the TUI input box.
+- **Service Integration**: Fixed errors in `SearchService`, `ConversationService`, and `SessionService` integration.
+- **Terminal Behavior**: Improved Ctrl+C handling for reliable immediate exit.
+- **API Config**: Fixed input blocking and Esc key behavior in the API configuration view.
+
+---
+
+## [0.4.0] - 2026-01-20
+
+### Added
+- Initial implementation of the `blessed`-based TUI framework.
+- Basic support for interactive slash commands.
+- Enhanced search service with Fuse.js integration.
+
+---
+
 ## [0.3.1] - 2026-01-18
 
 ### Fixed

package/README.md

@@ -21,7 +21,16 @@
 
 It features a **Think-with-AI** mode where it acts as a consultant, analyzing your specific life or work problems using these mental models to provide actionable advice. Even without AI, it provides powerful offline synthesis combining multiple perspectives.
 
-## ✨ What's New in v0.2.0
+## ✨ What's New in v0.5.0
+
+- 🎨 **Unified TUI Experience**: Entirely redesigned terminal interface with consistent branding (#f3c12b).
+- ⌨️ **Slash Command Power**: New `/new` and `/exit` commands for better session management.
+- 🔍 **Integrated CLI-to-TUI**: Run `thelapyae "question"` to jump directly into a TUI consultation.
+- 📑 **Inline Views**: Help, Configuration, and Sessions now display inline for a smoother workflow.
+- ⌨️ **Esc to Back**: Standardized **Esc** key navigation to return to the welcome screen from anywhere.
+- 🎯 **Fixed Input**: Resolved double-character and Vim mode issues for a fluid typing experience.
+
+### Previous Updates (v0.2.0-v0.3.0)
 
 - 🔐 **Secure Storage**: API keys now stored in OS keychain (not plain text)
 - 🔍 **Better Search**: Fuzzy matching with typo tolerance
@@ -47,7 +56,44 @@ npm install -g thelapyae
 
 ## 💡 Usage
 
-### Interactive Mode (Recommended)
+### TUI Mode (Recommended) 🎨
+
+The **new rich terminal interface** provides a beautiful, interactive experience:
+
+```bash
+$ thelapyae
+
+# You'll see a stunning centralized interface:
+# - Header: Brand logo and version
+# - Content: Consultations, Help, or History
+# - Bottom: Responsive input box
+
+# Commands:
+# /help     - Show interactive help
+# /new      - Start a new session
+# /exit     - Cleanly quit
+# /random   - Get a random model
+# /list     - List all models
+# /sessions - View past sessions
+# /config   - Setup API key
+
+# Navigation:
+# Enter     - Submit question/command
+# Esc       - Back to Welcome / Clear input
+# Ctrl+C    - Force Quit
+```
+
+**Features:**
+- 🎨 Beautiful interface with brand colors
+- ⌨️ Intuitive slash commands
+- 🔍 Live autocomplete as you type `/`
+- 💬 Interactive AI consultations
+- 📚 Browse session history inline
+- 🎯 Zero mouse required
+
+---
+
+### Interactive Mode (Classic)
 
 Just run `thelapyae` to enter an immersive interactive session:
 

package/bin/thelapyae.js

@@ -116,19 +116,20 @@ program
 
 // Default action (when no command is specified)
 program.action(async () => {
-  const InteractiveMode = require('../src/services/interactive-mode');
-  const interactive = new InteractiveMode(models, packageJson);
-  await interactive.start();
+  const TUI = require('../src/tui');
+  const tui = new TUI(models, packageJson);
+  tui.start();
 });
 
-// Handle unknown commands - treat as consult query
+// Handle unknown commands - treat as consult query in TUI
 program.on('command:*', async function (operands) {
   const query = operands.join(' ');
   
-  // If it looks like a question or statement, treat as consult
+  // If it looks like a question or statement, launch TUI with query
   if (query && query.length > 0) {
-    await consultCommand(query, models, program.opts());
-    process.exit(0);
+    const TUI = require('../src/tui');
+    const tui = new TUI(models, packageJson);
+    tui.start(query);
   } else {
     console.error(chalk.red(`\n❌ Unknown command: ${operands[0]}\n`));
     console.log(chalk.gray('Run'), chalk.cyan('thelapyae --help'), chalk.gray('for available commands\n'));
@@ -138,18 +139,19 @@ program.on('command:*', async function (operands) {
 
 // Parse arguments
 if (process.argv.length === 2) {
-  // No arguments - start interactive mode directly
+  // No arguments - start TUI mode directly
   (async () => {
-    const InteractiveMode = require('../src/services/interactive-mode');
-    const interactive = new InteractiveMode(models, packageJson);
-    await interactive.start();
+    const TUI = require('../src/tui');
+    const tui = new TUI(models, packageJson);
+    tui.start();
   })();
 } else if (process.argv.length > 2 && !process.argv[2].startsWith('-')) {
-  // Direct question provided (not a command or option)
+  // Direct question provided (not a command or option) - launch TUI with question
   const query = process.argv.slice(2).join(' ');
   (async () => {
-    await consultCommand(query, models, {});
-    process.exit(0);
+    const TUI = require('../src/tui');
+    const tui = new TUI(models, packageJson);
+    tui.start(query);
   })();
 } else {
   // Parse commands normally

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "thelapyae",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "description": "Personal CLI of La Pyae – mental models, stoicism, clear thinking",
   "bin": {
-    "thelapyae": "./bin/thelapyae.js"
+    "thelapyae": "bin/thelapyae.js"
   },
   "author": "La Pyae",
   "license": "MIT",
@@ -14,6 +14,8 @@
   },
   "dependencies": {
     "@google/generative-ai": "^0.24.1",
+    "blessed": "^0.1.81",
+    "blessed-contrib": "^4.11.0",
     "boxen": "^8.0.1",
     "chalk": "^4.1.2",
     "cli-table3": "^0.6.3",
@@ -24,6 +26,7 @@
     "gradient-string": "^3.0.0",
     "keytar": "^7.9.0",
     "natural": "^6.10.0",
+    "neo-blessed": "^0.2.0",
     "ora": "^5.4.1",
     "terminal-link": "^5.0.0"
   },

package/src/services/conversation-service.js

@@ -13,8 +13,9 @@ class ConversationService {
   /**
    * Generate reflection questions using AI
    */
-  async generateReflectionQuestions(query, models, count = 5) {
-    const spinner = ora('Generating reflection questions...').start();
+  async generateReflectionQuestions(query, models, count = 5, options = {}) {
+    const { showSpinner = true } = options;
+    const spinner = showSpinner ? ora('Generating reflection questions...').start() : null;
 
     try {
       const prompt = `You are a thoughtful consultant helping someone think through: "${query}"
@@ -55,11 +56,11 @@ Make them simple, clear, and thought-provoking.`;
       // Parse JSON
       const questions = JSON.parse(text);
 
-      spinner.succeed(`Generated ${questions.length} reflection questions`);
+      if (spinner) spinner.succeed(`Generated ${questions.length} reflection questions`);
       return questions;
 
     } catch (error) {
-      spinner.fail('Failed to generate reflection questions');
+      if (spinner) spinner.fail('Failed to generate reflection questions');
       throw new Error(`Could not generate questions: ${error.message}`);
     }
   }
@@ -136,8 +137,9 @@ Make them simple, clear, and thought-provoking.`;
   /**
    * Generate final analysis with mental models
    */
-  async generateFinalAnalysis(query, questionsAndAnswers, models) {
-    const spinner = ora('Analyzing your responses with mental models...').start();
+  async generateFinalAnalysis(query, questionsAndAnswers, models, options = {}) {
+    const { showSpinner = true } = options;
+    const spinner = showSpinner ? ora('Analyzing your responses with mental models...').start() : null;
 
     try {
       const conversation = this.formatConversation(query, questionsAndAnswers);
@@ -180,11 +182,11 @@ CRITICAL FORMATTING RULES FOR TERMINAL DISPLAY:
       const response = await result.response;
       const analysis = response.text();
 
-      spinner.succeed('Analysis complete');
+      if (spinner) spinner.succeed('Analysis complete');
       return analysis;
 
     } catch (error) {
-      spinner.fail('Analysis failed');
+      if (spinner) spinner.fail('Analysis failed');
       throw error;
     }
   }

package/src/tui/components/consultation-panel.js

@@ -0,0 +1,336 @@
+/**
+ * Consultation Panel Component
+ * Interactive consultation interface with AI
+ */
+
+const blessed = require('blessed');
+const theme = require('../theme');
+const SearchService = require('../../services/search-service');
+const ConversationService = require('../../services/conversation-service');
+const AIService = require('../../services/ai-service');
+const SessionService = require('../../services/session-service');
+const configService = require('../../services/config-service');
+
+class ConsultationPanel {
+  constructor(parent, models, layout) {
+    this.parent = parent;
+    this.models = models;
+    this.layout = layout;
+    
+    // Create search service instance
+    this.searchService = new SearchService(models);
+    
+    // AI and conversation services will be initialized when needed
+    this.aiService = null;
+    this.conversationService = null;
+    
+    this.currentQuery = '';
+    this.currentQuestions = [];
+    this.currentAnswers = [];
+    this.relevantModels = [];
+    
+    this.welcomeBox = null;
+    this.inputBox = null;
+    this.outputBox = null;
+  }
+
+  /**
+   * Show the consultation panel
+   */
+  show() {
+    this.parent.setContent('');
+    this.showWelcome();
+  }
+
+  /**
+   * Show welcome message
+   */
+  showWelcome() {
+    const welcomeText = `{center}{bold}{#f3c12b-fg}Welcome to thelapyae{/#f3c12b-fg}{/bold}{/center}
+
+Ask me anything about thinking, decisions, or life.
+I'll help you explore it using mental models.
+
+{bold}Examples:{/bold}
+  • "Should I quit my job?"
+  • "How do I prioritize my tasks?"
+  • "I feel overwhelmed with too many projects"
+
+{bold}Slash Commands:{/bold}
+  {cyan-fg}/random{/cyan-fg}   - Get a random mental model
+  {cyan-fg}/list{/cyan-fg}     - List all mental models
+  {cyan-fg}/sessions{/cyan-fg} - View past consultations
+  {cyan-fg}/config{/cyan-fg}   - Configure API key
+  {cyan-fg}/help{/cyan-fg}     - Show help
+  {cyan-fg}/new{/cyan-fg}      - Start new session
+  {cyan-fg}/exit{/cyan-fg}     - Exit application
+
+Just type your question or a slash command and press Enter!`;
+
+    this.parent.setContent(welcomeText);
+    this.parent.screen.render();
+  }
+
+  /**
+   * Start a new consultation
+   */
+  async startConsultation() {
+    // Create input box
+    const inputBox = blessed.textarea({
+      parent: this.parent.screen,
+      top: 'center',
+      left: 'center',
+      width: '80%',
+      height: 7,
+      label: ' What\'s on your mind? ',
+      border: theme.boxes.input.border,
+      style: theme.boxes.input.style,
+      inputOnFocus: true,
+      keys: true,
+      vi: true
+    });
+
+    inputBox.focus();
+    this.parent.screen.render();
+
+    // Get input
+    inputBox.readInput(async (err, value) => {
+      if (err || !value || !value.trim()) {
+        inputBox.destroy();
+        this.parent.screen.render();
+        return;
+      }
+
+      this.currentQuery = value.trim();
+      inputBox.destroy();
+      
+      // Start consultation flow
+      await this.runConsultation();
+    });
+  }
+
+  /**
+   * Handle a query from the input box
+   */
+  async handleQuery(query) {
+    this.currentQuery = query;
+    await this.runConsultation();
+  }
+
+  /**
+   * Run the consultation flow
+   */
+  async runConsultation() {
+    try {
+      // Show loading
+      this.showLoading('Analyzing your question...');
+
+      // Find relevant models using search service
+      const searchResults = this.searchService.search(this.currentQuery, 5);
+      this.relevantModels = searchResults.map(r => r.model);
+
+      // Check if API key is configured
+      const apiKey = await configService.getApiKey();
+      
+      if (!apiKey) {
+        this.showOfflineConsultation();
+        return;
+      }
+
+      // Initialize AI services if not already done
+      if (!this.aiService) {
+        this.aiService = new AIService(apiKey);
+      }
+      if (!this.conversationService) {
+        this.conversationService = new ConversationService(this.aiService);
+      }
+
+      // Generate reflection questions
+      this.showLoading('Generating reflection questions...');
+      this.currentQuestions = await this.conversationService.generateReflectionQuestions(
+        this.currentQuery,
+        this.relevantModels,
+        5,
+        { showSpinner: false }
+      );
+
+      // Ask questions interactively
+      await this.askQuestions();
+
+      // Generate final analysis
+      this.showLoading('Analyzing your responses...');
+      const questionsAndAnswers = this.currentQuestions.map((q, i) => ({
+        question: q,
+        answer: this.currentAnswers[i]
+      }));
+
+      const analysis = await this.conversationService.generateFinalAnalysis(
+        this.currentQuery,
+        questionsAndAnswers,
+        this.relevantModels,
+        { showSpinner: false }
+      );
+
+      // Show results
+      this.showResults(analysis);
+
+      // Save session
+      const sessionService = new SessionService();
+      const modelsUsed = this.relevantModels.map(m => m.title).join(', ');
+      sessionService.saveSession(
+        this.currentQuery,
+        questionsAndAnswers,
+        analysis,
+        { modelsUsed }
+      );
+
+    } catch (error) {
+      this.showError(error.message);
+    }
+  }
+
+  /**
+   * Ask reflection questions one by one
+   */
+  async askQuestions() {
+    this.currentAnswers = [];
+
+    for (let i = 0; i < this.currentQuestions.length; i++) {
+      const question = this.currentQuestions[i];
+      const answer = await this.askSingleQuestion(question, i + 1, this.currentQuestions.length);
+      
+      if (answer === null) {
+        // User cancelled
+        throw new Error('Consultation cancelled');
+      }
+      
+      this.currentAnswers.push(answer);
+    }
+  }
+
+  /**
+   * Ask a single question
+   */
+  askSingleQuestion(question, index, total) {
+    return new Promise((resolve) => {
+      // Show question in content area
+      const questionContent = `{bold}{cyan-fg}Question ${index}/${total}{/cyan-fg}{/bold}
+
+{bold}${question}{/bold}
+
+{gray-fg}Type your answer in the input box below and press Enter.
+Press Esc to skip this question.{/gray-fg}`;
+
+      this.parent.setContent(questionContent);
+      
+      // Update input box label
+      const mainInputBox = this.layout.inputBox;
+      mainInputBox.setLabel(` Type your answer here (Question ${index}/${total}) `);
+      mainInputBox.style.focus.border.fg = 'cyan';
+      
+      this.parent.screen.render();
+      
+      // Temporarily override Enter handler
+      const tempEnterHandler = (ch, key) => {
+        if (key.name === 'enter') {
+          const answer = mainInputBox.getValue().trim();
+          mainInputBox.clearValue();
+          
+          // Restore original state
+          mainInputBox.removeListener('keypress', tempEnterHandler);
+          mainInputBox.removeListener('keypress', tempEscHandler);
+          
+          // Reset label
+          mainInputBox.setLabel(' Ask me anything... (Press Enter to submit, Esc to clear) ');
+          mainInputBox.style.focus.border.fg = 'yellow';
+          
+          resolve(answer || '');
+        }
+      };
+      
+      // Temporarily override Esc handler to skip
+      const tempEscHandler = (ch, key) => {
+        if (key.name === 'escape') {
+          mainInputBox.clearValue();
+          
+          // Restore original state
+          mainInputBox.removeListener('keypress', tempEnterHandler);
+          mainInputBox.removeListener('keypress', tempEscHandler);
+          
+          // Reset label
+          mainInputBox.setLabel(' Ask me anything... (Press Enter to submit, Esc to clear) ');
+          mainInputBox.style.focus.border.fg = 'yellow';
+          
+          resolve(''); // Empty answer means skipped
+        }
+      };
+      
+      mainInputBox.on('keypress', tempEnterHandler);
+      mainInputBox.on('keypress', tempEscHandler);
+      
+      mainInputBox.focus();
+      this.parent.screen.render();
+    });
+  }
+
+  /**
+   * Show loading message
+   */
+  showLoading(message) {
+    this.parent.setContent(`{center}\n\n{bold}{cyan-fg}${message}{/cyan-fg}{/bold}\n\n{gray-fg}Please wait...{/gray-fg}{/center}`);
+    this.parent.screen.render();
+  }
+
+  /**
+   * Show offline consultation
+   */
+  showOfflineConsultation() {
+    const modelsText = this.relevantModels.map((m, i) => 
+      `${i + 1}. {bold}${m.title}{/bold}\n   ${m.explanation.substring(0, 200)}...`
+    ).join('\n\n');
+
+    const content = `{center}{bold}{yellow-fg}Offline Mode{/yellow-fg}{/bold}{/center}
+
+{bold}Your Question:{/bold}
+${this.currentQuery}
+
+{bold}Relevant Mental Models:{/bold}
+
+${modelsText}
+
+{center}{gray-fg}Configure your API key with 'thelapyae config' to enable AI consultation.{/gray-fg}{/center}`;
+
+    this.parent.setContent(content);
+    this.parent.screen.render();
+  }
+
+  /**
+   * Show results
+   */
+  showResults(analysis) {
+    const content = `{bold}{green-fg}✓ Analysis Complete{/green-fg}{/bold}
+
+{bold}Your Question:{/bold}
+${this.currentQuery}
+
+{bold}Analysis:{/bold}
+
+${analysis}
+
+{center}{gray-fg}Session saved. Press Ctrl+N for a new consultation.{/gray-fg}{/center}`;
+
+    this.parent.setContent(content);
+    this.parent.setScrollPerc(0);
+    this.parent.screen.render();
+  }
+
+  /**
+   * Show error
+   */
+  showError(message) {
+    this.parent.setContent(`{center}\n\n{bold}{red-fg}Error{/red-fg}{/bold}\n\n${message}\n\n{gray-fg}Press Ctrl+N to try again.{/gray-fg}{/center}`);
+    this.parent.screen.render();
+  }
+}
+
+module.exports = ConsultationPanel;