agileflow 2.96.0 → 2.96.2

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.96.2] - 2026-02-06
+
+### Fixed
+- Smart docs folder detection for existing AgileFlow installations
+
+## [2.96.1] - 2026-02-06
+
+### Fixed
+- Fix js-yaml module resolution in copied lib files
+
 ## [2.96.0] - 2026-02-05
 
 ### Added

package/lib/claude-cli-bridge.js

@@ -38,28 +38,27 @@ function createClaudeBridge(options = {}) {
 
     return new Promise((resolve, reject) => {
       // Spawn claude with streaming JSON output
-      claudeProcess = spawn('claude', [
-        '--print',
-        '--output-format', 'stream-json',
-        '--permission-mode', 'default',
-        content
-      ], {
-        cwd,
-        env: { ...process.env },
-        stdio: ['ignore', 'pipe', 'pipe']
-      });
+      claudeProcess = spawn(
+        'claude',
+        ['--print', '--output-format', 'stream-json', '--permission-mode', 'default', content],
+        {
+          cwd,
+          env: { ...process.env },
+          stdio: ['ignore', 'pipe', 'pipe'],
+        }
+      );
 
       // Parse NDJSON output line by line
       const rl = readline.createInterface({
         input: claudeProcess.stdout,
-        crlfDelay: Infinity
+        crlfDelay: Infinity,
       });
 
       let fullResponse = '';
       let toolUseBuffer = new Map();
       let hadAssistantText = false;
 
-      rl.on('line', (line) => {
+      rl.on('line', line => {
         try {
           const event = JSON.parse(line);
           const result = processEvent(event, {
@@ -68,7 +67,7 @@ function createClaudeBridge(options = {}) {
             onToolResult,
             onInit,
             toolUseBuffer,
-            hadAssistantText
+            hadAssistantText,
           });
 
           // Track if we've sent assistant text
@@ -93,12 +92,12 @@ function createClaudeBridge(options = {}) {
         }
       });
 
-      claudeProcess.stderr.on('data', (data) => {
+      claudeProcess.stderr.on('data', data => {
         const errorText = data.toString();
         if (onError) onError(errorText);
       });
 
-      claudeProcess.on('close', (code) => {
+      claudeProcess.on('close', code => {
         isRunning = false;
         claudeProcess = null;
 
@@ -112,7 +111,7 @@ function createClaudeBridge(options = {}) {
         }
       });
 
-      claudeProcess.on('error', (err) => {
+      claudeProcess.on('error', err => {
         isRunning = false;
         claudeProcess = null;
         if (onError) onError(err.message);
@@ -142,7 +141,7 @@ function createClaudeBridge(options = {}) {
   return {
     sendMessage,
     cancel,
-    isBusy
+    isBusy,
   };
 }
 
@@ -187,12 +186,7 @@ function processEvent(event, handlers) {
         for (const block of event.message.content) {
           if (block.type === 'tool_result' && onToolResult) {
             const toolUse = toolUseBuffer.get(block.tool_use_id);
-            onToolResult(
-              block.tool_use_id,
-              block.content,
-              block.is_error,
-              toolUse?.name
-            );
+            onToolResult(block.tool_use_id, block.content, block.is_error, toolUse?.name);
           }
         }
       }
@@ -217,5 +211,5 @@ function processEvent(event, handlers) {
 }
 
 module.exports = {
-  createClaudeBridge
+  createClaudeBridge,
 };

package/lib/dashboard-protocol.js

@@ -21,65 +21,65 @@
  */
 const OutboundMessageType = {
   // Connection & Session
-  SESSION_STATE: 'session_state',       // Session connected/resumed
-  SESSION_ERROR: 'session_error',       // Session error
+  SESSION_STATE: 'session_state', // Session connected/resumed
+  SESSION_ERROR: 'session_error', // Session error
 
   // Text Streaming
-  TEXT: 'text',                         // Claude text response
-  TEXT_DELTA: 'text_delta',             // Streaming text chunk
+  TEXT: 'text', // Claude text response
+  TEXT_DELTA: 'text_delta', // Streaming text chunk
 
   // Tool Calls
-  TOOL_START: 'tool_start',             // Tool call started
-  TOOL_RESULT: 'tool_result',           // Tool call completed
+  TOOL_START: 'tool_start', // Tool call started
+  TOOL_RESULT: 'tool_result', // Tool call completed
 
   // File Operations
-  FILE_READ: 'file_read',               // File was read
-  FILE_WRITE: 'file_write',             // File was written
-  FILE_EDIT: 'file_edit',               // File was edited (diff)
+  FILE_READ: 'file_read', // File was read
+  FILE_WRITE: 'file_write', // File was written
+  FILE_EDIT: 'file_edit', // File was edited (diff)
 
   // Shell Operations
-  BASH_START: 'bash_start',             // Bash command started
-  BASH_OUTPUT: 'bash_output',           // Bash output chunk
-  BASH_END: 'bash_end',                 // Bash command completed
+  BASH_START: 'bash_start', // Bash command started
+  BASH_OUTPUT: 'bash_output', // Bash output chunk
+  BASH_END: 'bash_end', // Bash command completed
 
   // Task Management
-  TASK_CREATED: 'task_created',         // Task was created
-  TASK_UPDATED: 'task_updated',         // Task status changed
-  TASK_LIST: 'task_list',               // Full task list
+  TASK_CREATED: 'task_created', // Task was created
+  TASK_UPDATED: 'task_updated', // Task status changed
+  TASK_LIST: 'task_list', // Full task list
 
   // Git Status
-  GIT_STATUS: 'git_status',             // Git status update
-  GIT_DIFF: 'git_diff',                 // Git diff content
+  GIT_STATUS: 'git_status', // Git status update
+  GIT_DIFF: 'git_diff', // Git diff content
 
   // Project Status
-  STATUS_UPDATE: 'status_update',       // Story/epic status update
+  STATUS_UPDATE: 'status_update', // Story/epic status update
 
   // Agent Communication
-  AGENT_SPAWN: 'agent_spawn',           // Sub-agent spawned
-  AGENT_RESULT: 'agent_result',         // Sub-agent completed
+  AGENT_SPAWN: 'agent_spawn', // Sub-agent spawned
+  AGENT_RESULT: 'agent_result', // Sub-agent completed
 
   // Notifications
-  NOTIFICATION: 'notification',         // General notification
+  NOTIFICATION: 'notification', // General notification
 
   // Terminal
-  TERMINAL_OUTPUT: 'terminal_output',   // Terminal output data
-  TERMINAL_RESIZE: 'terminal_resize',   // Terminal resize acknowledgment
-  TERMINAL_EXIT: 'terminal_exit',       // Terminal process exited
+  TERMINAL_OUTPUT: 'terminal_output', // Terminal output data
+  TERMINAL_RESIZE: 'terminal_resize', // Terminal resize acknowledgment
+  TERMINAL_EXIT: 'terminal_exit', // Terminal process exited
 
   // Automations
-  AUTOMATION_LIST: 'automation_list',   // List of all automations
+  AUTOMATION_LIST: 'automation_list', // List of all automations
   AUTOMATION_STATUS: 'automation_status', // Automation run status update
   AUTOMATION_RESULT: 'automation_result', // Automation run completed
 
   // Inbox
-  INBOX_LIST: 'inbox_list',             // List of inbox items
-  INBOX_ITEM: 'inbox_item',             // Single inbox item
+  INBOX_LIST: 'inbox_list', // List of inbox items
+  INBOX_ITEM: 'inbox_item', // Single inbox item
 
   // User Interaction
   ASK_USER_QUESTION: 'ask_user_question', // Claude is asking user a question
 
   // Errors
-  ERROR: 'error',                       // General error
+  ERROR: 'error', // General error
 };
 
 /**
@@ -88,43 +88,43 @@ const OutboundMessageType = {
  */
 const InboundMessageType = {
   // Messages
-  MESSAGE: 'message',                   // User message to Claude
-  CANCEL: 'cancel',                     // Cancel current operation
+  MESSAGE: 'message', // User message to Claude
+  CANCEL: 'cancel', // Cancel current operation
 
   // Session
-  SESSION_INIT: 'session_init',         // Initialize/resume session
-  SESSION_CLOSE: 'session_close',       // Close session
+  SESSION_INIT: 'session_init', // Initialize/resume session
+  SESSION_CLOSE: 'session_close', // Close session
 
   // Requests
-  REFRESH: 'refresh',                   // Request status refresh
+  REFRESH: 'refresh', // Request status refresh
 
   // Git Operations
-  GIT_STAGE: 'git_stage',               // Stage file(s)
-  GIT_UNSTAGE: 'git_unstage',           // Unstage file(s)
-  GIT_REVERT: 'git_revert',             // Revert file(s)
-  GIT_COMMIT: 'git_commit',             // Create commit
-  GIT_PUSH: 'git_push',                 // Push to remote
-  GIT_PR: 'git_pr',                     // Create pull request
+  GIT_STAGE: 'git_stage', // Stage file(s)
+  GIT_UNSTAGE: 'git_unstage', // Unstage file(s)
+  GIT_REVERT: 'git_revert', // Revert file(s)
+  GIT_COMMIT: 'git_commit', // Create commit
+  GIT_PUSH: 'git_push', // Push to remote
+  GIT_PR: 'git_pr', // Create pull request
   GIT_DIFF_REQUEST: 'git_diff_request', // Request diff for a file
 
   // Feedback
-  INLINE_COMMENT: 'inline_comment',     // Comment on diff line
+  INLINE_COMMENT: 'inline_comment', // Comment on diff line
 
   // Terminal
-  TERMINAL_INPUT: 'terminal_input',     // Terminal stdin
-  TERMINAL_RESIZE: 'terminal_resize',   // Resize terminal
-  TERMINAL_SPAWN: 'terminal_spawn',     // Spawn new terminal
-  TERMINAL_CLOSE: 'terminal_close',     // Close terminal
+  TERMINAL_INPUT: 'terminal_input', // Terminal stdin
+  TERMINAL_RESIZE: 'terminal_resize', // Resize terminal
+  TERMINAL_SPAWN: 'terminal_spawn', // Spawn new terminal
+  TERMINAL_CLOSE: 'terminal_close', // Close terminal
 
   // Automation
-  AUTOMATION_RUN: 'automation_run',     // Run automation
-  AUTOMATION_STOP: 'automation_stop',   // Stop automation
+  AUTOMATION_RUN: 'automation_run', // Run automation
+  AUTOMATION_STOP: 'automation_stop', // Stop automation
   AUTOMATION_LIST_REQUEST: 'automation_list_request', // Request automation list
   INBOX_LIST_REQUEST: 'inbox_list_request', // Request inbox list
-  INBOX_ACTION: 'inbox_action',         // Accept/dismiss inbox item
+  INBOX_ACTION: 'inbox_action', // Accept/dismiss inbox item
 
   // User Interaction Response
-  USER_ANSWER: 'user_answer',           // User's answer to AskUserQuestion
+  USER_ANSWER: 'user_answer', // User's answer to AskUserQuestion
 };
 
 // ============================================================================

package/lib/drivers/claude-driver.ts

@@ -14,7 +14,7 @@ import {
   CLICommand,
   IREventHandler,
   CLAUDE_CAPABILITIES,
-} from "../protocol/driver";
+} from '../protocol/driver';
 import {
   IREnvelope,
   IRSource,
@@ -27,31 +27,31 @@ import {
   IRTask,
   IRGit,
   IRError,
-} from "../protocol/ir";
+} from '../protocol/ir';
 
 // ============================================================================
 // Tool Name Mapping (Claude -> IR normalized names)
 // ============================================================================
 
 const CLAUDE_TOOL_MAPPING: Record<string, string> = {
-  "Read": "file_read",
-  "Write": "file_write",
-  "Edit": "file_edit",
-  "Bash": "shell_exec",
-  "Glob": "file_glob",
-  "Grep": "file_grep",
-  "WebSearch": "web_search",
-  "WebFetch": "web_fetch",
-  "Task": "agent_spawn",
-  "TaskCreate": "todo_create",
-  "TaskUpdate": "todo_update",
-  "TaskList": "todo_list",
-  "TaskGet": "todo_get",
-  "AskUserQuestion": "user_question",
-  "EnterPlanMode": "plan_mode_enter",
-  "ExitPlanMode": "plan_mode_exit",
-  "Skill": "skill_invoke",
-  "NotebookEdit": "notebook_edit",
+  Read: 'file_read',
+  Write: 'file_write',
+  Edit: 'file_edit',
+  Bash: 'shell_exec',
+  Glob: 'file_glob',
+  Grep: 'file_grep',
+  WebSearch: 'web_search',
+  WebFetch: 'web_fetch',
+  Task: 'agent_spawn',
+  TaskCreate: 'todo_create',
+  TaskUpdate: 'todo_update',
+  TaskList: 'todo_list',
+  TaskGet: 'todo_get',
+  AskUserQuestion: 'user_question',
+  EnterPlanMode: 'plan_mode_enter',
+  ExitPlanMode: 'plan_mode_exit',
+  Skill: 'skill_invoke',
+  NotebookEdit: 'notebook_edit',
 };
 
 /**
@@ -66,12 +66,12 @@ function normalizeToolName(claudeName: string): string {
 // ============================================================================
 
 export class ClaudeDriver implements Driver {
-  readonly id: IRSource = "claude";
-  readonly name = "Claude Code";
+  readonly id: IRSource = 'claude';
+  readonly name = 'Claude Code';
 
   private _status: DriverStatus = {
-    state: "stopped",
-    provider: "claude",
+    state: 'stopped',
+    provider: 'claude',
   };
 
   private _capabilities: Capability[] = [...CLAUDE_CAPABILITIES];
@@ -94,21 +94,21 @@ export class ClaudeDriver implements Driver {
     this._sessions.set(sessionId, { config, seqCounter: 0 });
 
     this._status = {
-      state: "ready",
-      provider: "claude",
-      model: config.model || "claude-3-opus",
+      state: 'ready',
+      provider: 'claude',
+      model: config.model || 'claude-3-opus',
       contextMax: config.maxTokens || 200000,
     };
 
     // Emit init event
     const initPayload: IRInit = {
-      provider: "claude",
-      version: "1.0.0", // TODO: Get actual version from CLI
+      provider: 'claude',
+      version: '1.0.0', // TODO: Get actual version from CLI
       capabilities: this._capabilities.filter(c => c.available).map(c => c.name),
       maxContext: config.maxTokens || 200000,
     };
 
-    this._emit(createIREnvelope("init", sessionId, "claude", initPayload));
+    this._emit(createIREnvelope('init', sessionId, 'claude', initPayload));
   }
 
   async stop(sessionId: string): Promise<void> {
@@ -117,7 +117,7 @@ export class ClaudeDriver implements Driver {
     if (this._sessions.size === 0) {
       this._status = {
         ...this._status,
-        state: "stopped",
+        state: 'stopped',
       };
     }
   }
@@ -147,14 +147,14 @@ export class ClaudeDriver implements Driver {
 
   async send(sessionId: string, command: CLICommand): Promise<void> {
     // Mark as busy
-    this._status = { ...this._status, state: "busy" };
+    this._status = { ...this._status, state: 'busy' };
 
     // This would normally send to the CLI process
     // For now, just emit a session state change
     const sessionPayload: IRSession = {
-      state: "thinking",
+      state: 'thinking',
     };
-    this._emit(createIREnvelope("session", sessionId, "claude", sessionPayload));
+    this._emit(createIREnvelope('session', sessionId, 'claude', sessionPayload));
   }
 
   // -------------------------------------------------------------------------
@@ -170,58 +170,60 @@ export class ClaudeDriver implements Driver {
     if (!session) return null;
 
     switch (claudeMessage.type) {
-      case "text":
-        return createIREnvelope<IRTextDelta>("text_delta", sessionId, "claude", {
+      case 'text':
+        return createIREnvelope<IRTextDelta>('text_delta', sessionId, 'claude', {
           text: claudeMessage.content,
           done: claudeMessage.done ?? false,
         });
 
-      case "tool_use":
-        return createIREnvelope<IRToolStart>("tool_start", sessionId, "claude", {
+      case 'tool_use':
+        return createIREnvelope<IRToolStart>('tool_start', sessionId, 'claude', {
           id: claudeMessage.id || `tool_${Date.now()}`,
           name: normalizeToolName(claudeMessage.tool),
           nativeName: claudeMessage.tool,
           input: claudeMessage.input || {},
         });
 
-      case "tool_result":
-        return createIREnvelope<IRToolResult>("tool_result", sessionId, "claude", {
-          id: claudeMessage.id || "",
+      case 'tool_result':
+        return createIREnvelope<IRToolResult>('tool_result', sessionId, 'claude', {
+          id: claudeMessage.id || '',
           ok: !claudeMessage.error,
           output: claudeMessage.content,
           error: claudeMessage.error,
         });
 
-      case "task":
-        return createIREnvelope<IRTask>("task", sessionId, "claude", {
-          action: claudeMessage.action as "create" | "update" | "delete" | "list",
-          task: claudeMessage.task ? {
-            ...claudeMessage.task,
-            status: claudeMessage.task.status as "pending" | "in_progress" | "completed",
-          } : undefined,
+      case 'task':
+        return createIREnvelope<IRTask>('task', sessionId, 'claude', {
+          action: claudeMessage.action as 'create' | 'update' | 'delete' | 'list',
+          task: claudeMessage.task
+            ? {
+                ...claudeMessage.task,
+                status: claudeMessage.task.status as 'pending' | 'in_progress' | 'completed',
+              }
+            : undefined,
           tasks: claudeMessage.tasks?.map((t: { id: string; subject: string; status: string }) => ({
             ...t,
-            status: t.status as "pending" | "in_progress" | "completed",
+            status: t.status as 'pending' | 'in_progress' | 'completed',
           })),
         });
 
-      case "git_status":
-        return createIREnvelope<IRGit>("git", sessionId, "claude", {
-          action: "status",
+      case 'git_status':
+        return createIREnvelope<IRGit>('git', sessionId, 'claude', {
+          action: 'status',
           branch: claudeMessage.branch,
           staged: claudeMessage.staged,
           unstaged: claudeMessage.unstaged,
         });
 
-      case "session_state":
-        return createIREnvelope<IRSession>("session", sessionId, "claude", {
-          state: claudeMessage.state as "connected" | "thinking" | "idle" | "error",
+      case 'session_state':
+        return createIREnvelope<IRSession>('session', sessionId, 'claude', {
+          state: claudeMessage.state as 'connected' | 'thinking' | 'idle' | 'error',
           message: claudeMessage.message,
         });
 
-      case "error":
-        return createIREnvelope<IRError>("error", sessionId, "claude", {
-          code: claudeMessage.code || "UNKNOWN",
+      case 'error':
+        return createIREnvelope<IRError>('error', sessionId, 'claude', {
+          code: claudeMessage.code || 'UNKNOWN',
           message: claudeMessage.message,
           details: claudeMessage.details,
           recoverable: claudeMessage.recoverable ?? true,
@@ -253,11 +255,11 @@ export class ClaudeDriver implements Driver {
   }
 
   private _emit(envelope: IREnvelope): void {
-    Array.from(this._eventHandlers).forEach((handler) => {
+    Array.from(this._eventHandlers).forEach(handler => {
       try {
         handler(envelope);
       } catch (error) {
-        console.error("[ClaudeDriver] Event handler error:", error);
+        console.error('[ClaudeDriver] Event handler error:', error);
       }
     });
   }