@iservu-inc/adf-cli 0.5.6 → 0.7.0

package/CHANGELOG.md

@@ -5,6 +5,77 @@ All notable changes to `@iservu-inc/adf-cli` 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.6.0] - 2025-10-05
+
+### 🎯 Fixed Cursor Positioning with Editor Input
+
+**FIX:** Switched from inline input to editor-based input to fix cursor lag on multi-line answers.
+
+#### The Problem
+
+When typing long answers in the terminal, the text cursor would fall behind by 3-4 characters when wrapping to a second line:
+
+![Cursor Lag Issue](https://user-images.githubusercontent.com/...)
+- Text wraps to multiple lines
+- Cursor position becomes desynchronized
+- Hard to track where you're typing
+- Frustrating UX for detailed answers
+
+This is a known issue with `inquirer`'s `input` type and terminal line wrapping.
+
+#### The Solution
+
+Switched to `editor` type for all answers:
+- Opens your system's default text editor (Notepad, nano, vi, etc.)
+- Perfect for multi-line, detailed answers
+- No cursor positioning issues
+- Better editing experience (copy/paste, formatting, etc.)
+
+**New Workflow:**
+1. Question is displayed
+2. Your editor automatically opens
+3. Type your answer (multi-line, formatted, etc.)
+4. Save and close the editor
+5. Answer is captured and interview continues
+
+**To skip a question:** Leave the editor empty and save.
+
+#### Benefits
+
+- ✅ **No more cursor lag** - Editor handles display properly
+- ✅ **Better for long answers** - Multi-line editing is natural
+- ✅ **Standard CLI pattern** - Used by git, crontab, etc.
+- ✅ **Copy/paste friendly** - Full editor capabilities
+- ✅ **Markdown support** - `.md` extension for syntax highlighting
+
+#### Technical Changes
+
+- Modified: `lib/frameworks/interviewer.js`
+  - Changed answer input from `type: 'input'` to `type: 'editor'`
+  - Changed follow-up input to `type: 'editor'`
+  - Added clear instructions about editor workflow
+  - Empty answers treated as skips
+  - Updated guidance text
+
+#### User Experience
+
+**Before (inline):**
+```
+Your answer: The primary use action is to eng█ge...
+[cursor lags behind when wrapping]
+```
+
+**After (editor):**
+```
+(Your editor will open. Save and close to continue, or leave empty + save to skip)
+[Editor opens]
+[Type answer with full multi-line support]
+[Save & close]
+✓ Answer captured
+```
+
+---
+
 ## [0.5.6] - 2025-10-05
 
 ### 🔧 Fixed Invalid .env State Detection

package/lib/frameworks/interviewer.js

@@ -559,36 +559,57 @@ class Interviewer {
     console.log(chalk.gray(`💡 ${question.guidance}`));
     console.log(chalk.green(`   ✓ Good: ${question.goodExample}`));
     console.log(chalk.red(`   ✗ Bad: ${question.badExample}`));
-    console.log(chalk.gray(`   (Type "skip" to skip remaining questions in this block)\n`));
 
     // Start tracking time for this question
     if (this.skipTracker) {
       this.skipTracker.startQuestion(question.id);
     }
 
-    // Get answer
+    // Get answer using editor for better multi-line support
+    console.log(chalk.gray('   (Your editor will open. Save and close to continue, or leave empty + save to skip)'));
+    console.log('');
+
+    // Show exit shortcut at bottom with padding
+    console.log(chalk.gray('─'.repeat(60)));
+    console.log(chalk.yellow('💡 TIP: Type "exit" in the editor to save progress and exit (resume anytime with: adf init)'));
+    console.log(chalk.gray('─'.repeat(60)));
+    console.log('');
+
     const { answer } = await inquirer.prompt([
       {
-        type: 'input',
+        type: 'editor',
         name: 'answer',
-        message: 'Your answer:',
-        validate: (input) => {
-          if (!input || input.trim().length === 0) {
-            return 'Please provide an answer or type "skip"';
-          }
-          return true;
-        }
+        message: '',
+        waitForUseInput: false,
+        postfix: '.md',
+        default: ''
       }
     ]);
 
-    if (answer.toLowerCase() === 'skip') {
+    // Handle empty answer or "skip" as skip
+    if (!answer || answer.trim().length === 0 || answer.toLowerCase().trim() === 'skip') {
       // Record skip event
       if (this.skipTracker) {
         this.skipTracker.recordSkip(question, 'manual');
       }
+      console.log(chalk.gray('\n⏭️  Skipped\n'));
       return null; // Signal to skip remaining questions
     }
 
+    // Handle "exit" keyword - save progress and exit gracefully
+    if (answer.toLowerCase().trim() === 'exit') {
+      console.log(chalk.yellow('\n💾 Saving progress and exiting...'));
+
+      // Ensure progress is saved
+      if (this.progressTracker) {
+        await this.progressTracker.save();
+      }
+
+      console.log(chalk.green('✓ Progress saved!'));
+      console.log(chalk.cyan('Resume anytime with: adf init\n'));
+      process.exit(0);
+    }
+
     // Analyze answer quality (use AI if available, fallback to heuristic)
     let qualityMetrics;
     try {
@@ -671,16 +692,41 @@ class Interviewer {
     }
 
     if (followUp) {
-      console.log(chalk.yellow(`\n🤖 ${followUp.message}\n`));
+      console.log(chalk.yellow(`\n🤖 ${followUp.message}`));
+      console.log(chalk.yellow(`   ${followUp.question}`));
+      console.log(chalk.gray('   (Your editor will open for follow-up answer)\n'));
+
+      // Show exit shortcut at bottom with padding
+      console.log(chalk.gray('─'.repeat(60)));
+      console.log(chalk.yellow('💡 TIP: Type "exit" in the editor to save progress and exit (resume anytime with: adf init)'));
+      console.log(chalk.gray('─'.repeat(60)));
+      console.log('');
 
       const { followUpAnswer } = await inquirer.prompt([
         {
-          type: 'input',
+          type: 'editor',
           name: 'followUpAnswer',
-          message: followUp.question
+          message: '',
+          waitForUseInput: false,
+          postfix: '.md',
+          default: ''
         }
       ]);
 
+      // Handle "exit" keyword - save progress and exit gracefully
+      if (followUpAnswer && followUpAnswer.toLowerCase().trim() === 'exit') {
+        console.log(chalk.yellow('\n💾 Saving progress and exiting...'));
+
+        // Ensure progress is saved
+        if (this.progressTracker) {
+          await this.progressTracker.save();
+        }
+
+        console.log(chalk.green('✓ Progress saved!'));
+        console.log(chalk.cyan('Resume anytime with: adf init\n'));
+        process.exit(0);
+      }
+
       if (followUpAnswer && followUpAnswer.trim()) {
         // Combine answers
         const combined = `${answer} | Follow-up: ${followUpAnswer}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iservu-inc/adf-cli",
-  "version": "0.5.6",
+  "version": "0.7.0",
   "description": "CLI tool for AgentDevFramework - AI-assisted development framework with multi-provider AI support",
   "main": "index.js",
   "bin": {