@gracefultools/astrid-sdk 0.6.1 → 0.7.1

package/dist/executors/terminal-base.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Terminal Executor Base Interface
+ *
+ * Common interface for all terminal executors (Claude, OpenAI, Gemini).
+ * Terminal mode executes tasks using local tools instead of remote APIs.
+ */
+import type { Session } from '../server/session-manager.js';
+/**
+ * Result from terminal execution
+ */
+export interface TerminalExecutionResult {
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    sessionId?: string;
+    gitDiff?: string;
+    modifiedFiles?: string[];
+    prUrl?: string;
+}
+/**
+ * Context for terminal task execution
+ */
+export interface TerminalTaskContext {
+    comments?: Array<{
+        authorName: string;
+        content: string;
+        createdAt: string;
+    }>;
+    prUrl?: string;
+    repository?: string;
+}
+/**
+ * Parsed output from terminal execution
+ */
+export interface ParsedOutput {
+    summary?: string;
+    files?: string[];
+    prUrl?: string;
+    error?: string;
+}
+/**
+ * Progress callback function
+ */
+export type TerminalProgressCallback = (message: string) => void;
+/**
+ * Common interface for all terminal executors.
+ *
+ * Terminal executors process tasks using local tool execution:
+ * - Claude: Spawns local Claude Code CLI
+ * - OpenAI: Uses OpenAI API with local tool execution
+ * - Gemini: Uses Gemini API with local tool execution
+ */
+export interface TerminalExecutor {
+    /**
+     * Check if the executor is available (e.g., CLI installed, API key set)
+     */
+    checkAvailable(): Promise<boolean>;
+    /**
+     * Start a new session to process a task
+     *
+     * @param session - The session containing task details
+     * @param prompt - Optional custom prompt (uses default if not provided)
+     * @param context - Optional context including comments and PR info
+     * @param onProgress - Optional callback for progress updates
+     * @returns Execution result with output, modified files, and PR URL
+     */
+    startSession(session: Session, prompt?: string, context?: TerminalTaskContext, onProgress?: TerminalProgressCallback): Promise<TerminalExecutionResult>;
+    /**
+     * Resume an existing session with new input
+     *
+     * @param session - The session to resume
+     * @param input - New input from user (e.g., follow-up message)
+     * @param context - Optional updated context
+     * @param onProgress - Optional callback for progress updates
+     * @returns Execution result
+     */
+    resumeSession(session: Session, input: string, context?: TerminalTaskContext, onProgress?: TerminalProgressCallback): Promise<TerminalExecutionResult>;
+    /**
+     * Parse output to extract key information
+     *
+     * @param output - Raw output string from execution
+     * @returns Parsed output with summary, files, PR URL, and error
+     */
+    parseOutput(output: string): ParsedOutput;
+}
+/**
+ * Extract PR URL from output text
+ */
+export declare function extractPrUrl(output: string): string | undefined;
+/**
+ * Format comment history for context
+ */
+export declare function formatCommentHistory(comments?: TerminalTaskContext['comments']): string;
+/**
+ * Capture git changes in a repository
+ */
+export declare function captureGitChanges(projectPath: string): Promise<{
+    diff: string;
+    files: string[];
+}>;
+/**
+ * Build default prompt for a task
+ */
+export declare function buildDefaultPrompt(session: Session, context?: TerminalTaskContext): string;
+//# sourceMappingURL=terminal-base.d.ts.map

package/dist/executors/terminal-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-base.d.ts","sourceRoot":"","sources":["../../src/executors/terminal-base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAM3D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,UAAU,EAAE,MAAM,CAAA;QAClB,OAAO,EAAE,MAAM,CAAA;QACf,SAAS,EAAE,MAAM,CAAA;KAClB,CAAC,CAAA;IACF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;AAMhE;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAElC;;;;;;;;OAQG;IACH,YAAY,CACV,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,mBAAmB,EAC7B,UAAU,CAAC,EAAE,wBAAwB,GACpC,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAEnC;;;;;;;;OAQG;IACH,aAAa,CACX,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,mBAAmB,EAC7B,UAAU,CAAC,EAAE,wBAAwB,GACpC,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAEnC;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAA;CAC1C;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAe/D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC,UAAU,CAAC,GAAG,MAAM,CASvF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAuCvG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,MAAM,CAyBR"}

package/dist/executors/terminal-base.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * Terminal Executor Base Interface
+ *
+ * Common interface for all terminal executors (Claude, OpenAI, Gemini).
+ * Terminal mode executes tasks using local tools instead of remote APIs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractPrUrl = extractPrUrl;
+exports.formatCommentHistory = formatCommentHistory;
+exports.captureGitChanges = captureGitChanges;
+exports.buildDefaultPrompt = buildDefaultPrompt;
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Extract PR URL from output text
+ */
+function extractPrUrl(output) {
+    const prUrlPatterns = [
+        /https:\/\/github\.com\/[^\/]+\/[^\/]+\/pull\/\d+/g,
+        /PR URL:\s*(https:\/\/[^\s]+)/i,
+        /Pull Request:\s*(https:\/\/[^\s]+)/i
+    ];
+    for (const pattern of prUrlPatterns) {
+        const match = output.match(pattern);
+        if (match) {
+            return match[0].replace(/PR URL:\s*/i, '').replace(/Pull Request:\s*/i, '');
+        }
+    }
+    return undefined;
+}
+/**
+ * Format comment history for context
+ */
+function formatCommentHistory(comments) {
+    if (!comments || comments.length === 0)
+        return '';
+    const formatted = comments
+        .slice(-10)
+        .map(c => `**${c.authorName}** (${new Date(c.createdAt).toLocaleString()}):\n${c.content}`)
+        .join('\n\n---\n\n');
+    return `\n\n## Previous Discussion\n\n${formatted}`;
+}
+/**
+ * Capture git changes in a repository
+ */
+async function captureGitChanges(projectPath) {
+    const { execSync } = await import('child_process');
+    try {
+        // Get modified files (staged and unstaged)
+        const statusOutput = execSync('git status --porcelain', {
+            cwd: projectPath,
+            encoding: 'utf-8',
+            timeout: 10000
+        });
+        const files = statusOutput
+            .split('\n')
+            .filter(line => line.trim())
+            .map(line => line.slice(3).trim()); // Remove status prefix
+        // Get diff (staged and unstaged, limited to 5000 chars)
+        let diff = '';
+        try {
+            diff = execSync('git diff HEAD --no-color', {
+                cwd: projectPath,
+                encoding: 'utf-8',
+                timeout: 10000,
+                maxBuffer: 1024 * 1024 // 1MB max
+            });
+            // Truncate if too long
+            if (diff.length > 5000) {
+                diff = diff.slice(0, 5000) + '\n\n[... diff truncated ...]';
+            }
+        }
+        catch {
+            // No diff or not a git repo
+        }
+        console.log(`📊 Git changes: ${files.length} files modified`);
+        return { diff, files };
+    }
+    catch {
+        return { diff: '', files: [] };
+    }
+}
+/**
+ * Build default prompt for a task
+ */
+function buildDefaultPrompt(session, context) {
+    const commentHistory = formatCommentHistory(context?.comments);
+    return `# Task: ${session.title}
+
+${session.description || ''}
+${commentHistory}
+
+## Workflow Requirements
+
+1. Understand the task and verify the platform (iOS = ios-app/, Web = components/, app/)
+2. Locate relevant code and make ONLY the requested changes
+3. Run predeploy tests: \`npm run predeploy\`
+4. Create PR: \`gh pr create\` with a clear title
+
+## Output Requirements
+
+Your response MUST include:
+1. Task understanding: What was requested
+2. Actual changes made: What you changed and WHY
+3. Files modified: List each file path
+4. Test results: Output from \`npm run predeploy\`
+5. PR URL: The pull request URL (REQUIRED)
+
+Begin by analyzing the task.`;
+}
+//# sourceMappingURL=terminal-base.js.map

package/dist/executors/terminal-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-base.js","sourceRoot":"","sources":["../../src/executors/terminal-base.ts"],"names":[],"mappings":"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"}

package/dist/executors/terminal-claude.d.ts

@@ -11,29 +11,13 @@
  * - Extracts PR URLs and git changes from output
  */
 import type { Session } from '../server/session-manager.js';
-export interface TerminalExecutionResult {
-    exitCode: number | null;
-    stdout: string;
-    stderr: string;
-    sessionId?: string;
-    gitDiff?: string;
-    modifiedFiles?: string[];
-    prUrl?: string;
-}
+import type { TerminalExecutor, TerminalTaskContext, ParsedOutput, TerminalExecutionResult } from './terminal-base.js';
+export type { TerminalExecutionResult, TerminalTaskContext } from './terminal-base.js';
 export interface TerminalClaudeOptions {
     model?: string;
     maxTurns?: number;
     timeout?: number;
 }
-export interface TerminalTaskContext {
-    comments?: Array<{
-        authorName: string;
-        content: string;
-        createdAt: string;
-    }>;
-    prUrl?: string;
-    repository?: string;
-}
 /**
  * Simple file-based session store for terminal mode.
  * Stores Claude session IDs for resumption support.
@@ -50,7 +34,7 @@ declare class TerminalSessionStore {
     deleteSession(taskId: string): Promise<void>;
 }
 export declare const terminalSessionStore: TerminalSessionStore;
-export declare class TerminalClaudeExecutor {
+export declare class TerminalClaudeExecutor implements TerminalExecutor {
     private model;
     private maxTurns;
     private timeout;
@@ -76,34 +60,38 @@ export declare class TerminalClaudeExecutor {
     formatCommentHistory(comments?: TerminalTaskContext['comments']): string;
     /**
      * Build prompt from task details
+     *
+     * IMPORTANT: Keep prompts SIMPLE! Claude Code CLI has a bug where complex
+     * markdown prompts with multiple sections cause it to hang indefinitely.
+     * Simple one-line prompts work reliably.
+     *
+     * Claude Code automatically reads CLAUDE.md from the working directory,
+     * so we don't need to include workflow instructions here.
      */
     buildPrompt(session: Session, userMessage?: string, context?: TerminalTaskContext): Promise<string>;
     /**
-     * Start a new Claude Code session
+     * Start a new Claude Code session with retry logic
      */
     startSession(session: Session, prompt?: string, context?: TerminalTaskContext, onProgress?: (message: string) => void): Promise<TerminalExecutionResult>;
     /**
-     * Resume an existing Claude Code session
+     * Resume an existing Claude Code session with retry logic
      */
     resumeSession(session: Session, input: string, context?: TerminalTaskContext, onProgress?: (message: string) => void): Promise<TerminalExecutionResult>;
     /**
      * Execute Claude Code CLI
+     *
+     * Uses stdin for prompt input instead of command-line args to avoid
+     * issues with long prompts, special characters, and newlines.
      */
     private runClaude;
     /**
      * Parse Claude Code output to extract key information
      */
-    parseOutput(output: string): {
-        summary?: string;
-        files?: string[];
-        prUrl?: string;
-        error?: string;
-    };
+    parseOutput(output: string): ParsedOutput;
     /**
      * Check if Claude Code CLI is available
      */
     checkAvailable(): Promise<boolean>;
 }
 export declare const terminalClaudeExecutor: TerminalClaudeExecutor;
-export {};
 //# sourceMappingURL=terminal-claude.d.ts.map

package/dist/executors/terminal-claude.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-claude.d.ts","sourceRoot":"","sources":["../../src/executors/terminal-claude.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"terminal-claude.d.ts","sourceRoot":"","sources":["../../src/executors/terminal-claude.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EAEnB,YAAY,EACZ,uBAAuB,EACxB,MAAM,oBAAoB,CAAA;AAG3B,YAAY,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAMtF,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAMD;;;GAGG;AACH,cAAM,oBAAoB;IACxB,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,MAAM,CAAQ;;IAShB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAWrB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAK/D,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1E,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAOnD;AAGD,eAAO,MAAM,oBAAoB,sBAA6B,CAAA;AAM9D,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,OAAO,CAAQ;gBAEX,OAAO,GAAE,qBAA0B;IAO/C;;OAEG;IACG,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAyCxF;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAkBhD;;OAEG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwB9D;;OAEG;IACH,oBAAoB,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC,UAAU,CAAC,GAAG,MAAM;IAWxE;;;;;;;;;OASG;IACG,WAAW,CACf,OAAO,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,MAAM,CAAC;IAclB;;OAEG;IACG,YAAY,CAChB,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,mBAAmB,EAC7B,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACrC,OAAO,CAAC,uBAAuB,CAAC;IAqEnC;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,mBAAmB,EAC7B,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACrC,OAAO,CAAC,uBAAuB,CAAC;IAsEnC;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IAmKjB;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAsCzC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAezC;AAGD,eAAO,MAAM,sBAAsB,wBAA+B,CAAA"}

package/dist/executors/terminal-claude.js

@@ -200,80 +200,86 @@ class TerminalClaudeExecutor {
     }
     /**
      * Build prompt from task details
+     *
+     * IMPORTANT: Keep prompts SIMPLE! Claude Code CLI has a bug where complex
+     * markdown prompts with multiple sections cause it to hang indefinitely.
+     * Simple one-line prompts work reliably.
+     *
+     * Claude Code automatically reads CLAUDE.md from the working directory,
+     * so we don't need to include workflow instructions here.
      */
     async buildPrompt(session, userMessage, context) {
         if (userMessage) {
-            const history = this.formatCommentHistory(context?.comments);
-            return history ? `${history}\n\n---\n\n## Latest Message\n\n${userMessage}` : userMessage;
+            // For follow-up messages, just return the message directly
+            return userMessage;
         }
-        // Read project context
-        let projectContext = '';
-        if (session.projectPath) {
-            projectContext = await this.readProjectContext(session.projectPath);
-        }
-        const commentHistory = this.formatCommentHistory(context?.comments);
-        return `# Task: ${session.title}
-
-${session.description || ''}
-${commentHistory}
-${projectContext}
-
-## Workflow Requirements
-
-1. Understand the task and verify the platform (iOS = ios-app/, Web = components/, app/)
-2. Locate relevant code and make ONLY the requested changes
-3. Run predeploy tests: \`npm run predeploy\`
-4. Create PR: \`gh pr create\` with a clear title
-
-## Output Requirements
-
-Your response MUST include:
-1. Task understanding: What was requested
-2. Actual changes made: What you changed and WHY
-3. Files modified: List each file path
-4. Test results: Output from \`npm run predeploy\`
-5. PR URL: The pull request URL (REQUIRED)`;
+        // Build a SIMPLE prompt - complex markdown causes Claude CLI to hang!
+        // Claude Code reads CLAUDE.md automatically for workflow instructions.
+        const description = session.description?.trim() || '';
+        const descPart = description ? `: ${description}` : '';
+        return `Complete this task: ${session.title}${descPart}`;
     }
     /**
-     * Start a new Claude Code session
+     * Start a new Claude Code session with retry logic
      */
     async startSession(session, prompt, context, onProgress) {
         const taskPrompt = prompt || await this.buildPrompt(session, undefined, context);
-        const args = [
-            '--print',
-            '--model', this.model,
-            '--max-turns', String(this.maxTurns),
-            '--output-format', 'text',
-            '--dangerously-skip-permissions',
-        ];
         // Truncate prompt if too long (avoid ARG_MAX issues)
         const MAX_PROMPT_LENGTH = 50000;
         let finalPrompt = taskPrompt;
         if (taskPrompt.length > MAX_PROMPT_LENGTH) {
             finalPrompt = taskPrompt.slice(0, MAX_PROMPT_LENGTH) + '\n\n[... prompt truncated ...]';
         }
-        args.push('-p', finalPrompt);
         console.log(`🚀 Starting new Claude Code session for task: ${session.title}`);
         if (session.projectPath) {
             console.log(`📁 Working directory: ${session.projectPath}`);
         }
-        const result = await this.runClaude(args, session, onProgress);
-        // Store session ID for resumption
-        if (result.sessionId) {
-            await exports.terminalSessionStore.setClaudeSessionId(session.taskId, result.sessionId);
-        }
-        // Capture git changes
-        if (session.projectPath) {
-            const changes = await this.captureGitChanges(session.projectPath);
-            result.gitDiff = changes.diff;
-            result.modifiedFiles = changes.files;
+        // Retry logic for intermittent Claude Code hangs
+        const MAX_RETRIES = 3;
+        let lastError;
+        for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+            if (attempt > 1) {
+                const delay = Math.min(1000 * Math.pow(2, attempt - 1), 10000);
+                console.log(`🔄 Retry attempt ${attempt}/${MAX_RETRIES} after ${delay}ms delay...`);
+                await new Promise(resolve => setTimeout(resolve, delay));
+            }
+            // Use stdin for prompt - more reliable than command-line args for long prompts
+            const args = [
+                '--print',
+                '--model', this.model,
+                '--output-format', 'text',
+                '--dangerously-skip-permissions',
+            ];
+            const result = await this.runClaude(args, session, onProgress, finalPrompt);
+            // Check if we got actual output (not a timeout/hang)
+            if (result.stdout.length > 0 || result.exitCode === 0) {
+                // Store session ID for resumption
+                if (result.sessionId) {
+                    await exports.terminalSessionStore.setClaudeSessionId(session.taskId, result.sessionId);
+                }
+                // Capture git changes
+                if (session.projectPath) {
+                    const changes = await this.captureGitChanges(session.projectPath);
+                    result.gitDiff = changes.diff;
+                    result.modifiedFiles = changes.files;
+                }
+                // Extract PR URL
+                result.prUrl = this.extractPrUrl(result.stdout);
+                return result;
+            }
+            console.log(`⚠️ Attempt ${attempt} failed (no output received)`);
+            lastError = new Error(`No output received from Claude Code (attempt ${attempt})`);
         }
-        // Extract PR URL
-        result.prUrl = this.extractPrUrl(result.stdout);
-        return result;
+        // All retries failed, return empty result
+        console.error(`❌ All ${MAX_RETRIES} attempts failed`);
+        return {
+            exitCode: -1,
+            stdout: '',
+            stderr: lastError?.message || 'All retry attempts failed',
+        };
     }
     /**
-     * Resume an existing Claude Code session
+     * Resume an existing Claude Code session with retry logic
      */
     async resumeSession(session, input, context, onProgress) {
         // Get stored Claude session ID
@@ -283,36 +289,61 @@ Your response MUST include:
             return this.startSession(session, input, context, onProgress);
         }
         const promptWithContext = await this.buildPrompt(session, input, context);
-        const args = [
-            '--print',
-            '--resume', claudeSessionId,
-            '--output-format', 'text',
-            '--dangerously-skip-permissions',
-        ];
-        args.push('-p', promptWithContext);
         console.log(`🔄 Resuming Claude Code session ${claudeSessionId}`);
         if (session.projectPath) {
             console.log(`📁 Working directory: ${session.projectPath}`);
         }
-        const result = await this.runClaude(args, session, onProgress);
-        // Update session ID if we got a new one
-        if (result.sessionId) {
-            await exports.terminalSessionStore.setClaudeSessionId(session.taskId, result.sessionId);
-        }
-        // Capture git changes
-        if (session.projectPath) {
-            const changes = await this.captureGitChanges(session.projectPath);
-            result.gitDiff = changes.diff;
-            result.modifiedFiles = changes.files;
+        // Retry logic for intermittent Claude Code hangs
+        const MAX_RETRIES = 3;
+        let lastError;
+        for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+            if (attempt > 1) {
+                const delay = Math.min(1000 * Math.pow(2, attempt - 1), 10000);
+                console.log(`🔄 Retry attempt ${attempt}/${MAX_RETRIES} after ${delay}ms delay...`);
+                await new Promise(resolve => setTimeout(resolve, delay));
+            }
+            // Use stdin for prompt - more reliable than command-line args
+            const args = [
+                '--print',
+                '--resume', claudeSessionId,
+                '--output-format', 'text',
+                '--dangerously-skip-permissions',
+            ];
+            const result = await this.runClaude(args, session, onProgress, promptWithContext);
+            // Check if we got actual output
+            if (result.stdout.length > 0 || result.exitCode === 0) {
+                // Update session ID if we got a new one
+                if (result.sessionId) {
+                    await exports.terminalSessionStore.setClaudeSessionId(session.taskId, result.sessionId);
+                }
+                // Capture git changes
+                if (session.projectPath) {
+                    const changes = await this.captureGitChanges(session.projectPath);
+                    result.gitDiff = changes.diff;
+                    result.modifiedFiles = changes.files;
+                }
+                // Extract PR URL
+                result.prUrl = this.extractPrUrl(result.stdout);
+                return result;
+            }
+            console.log(`⚠️ Attempt ${attempt} failed (no output received)`);
+            lastError = new Error(`No output received from Claude Code (attempt ${attempt})`);
         }
-        // Extract PR URL
-        result.prUrl = this.extractPrUrl(result.stdout);
-        return result;
+        // All retries failed
+        console.error(`❌ All ${MAX_RETRIES} attempts failed`);
+        return {
+            exitCode: -1,
+            stdout: '',
+            stderr: lastError?.message || 'All retry attempts failed',
+        };
     }
     /**
      * Execute Claude Code CLI
+     *
+     * Uses stdin for prompt input instead of command-line args to avoid
+     * issues with long prompts, special characters, and newlines.
      */
-    runClaude(args, session, onProgress) {
+    runClaude(args, session, onProgress, stdinInput) {
         return new Promise((resolve, reject) => {
             let stdout = '';
             let stderr = '';
@@ -323,7 +354,11 @@ Your response MUST include:
             let initialTimeoutHandle = null;
             const INITIAL_TIMEOUT = 120000; // 2 minutes for first output
             const STALL_TIMEOUT = 300000; // 5 minutes of no output = stalled
-            console.log(`🤖 Running: claude ${args.map(a => a.includes(' ') ? `"${a.slice(0, 50)}..."` : a).join(' ')}`);
+            // Log command (without prompt for readability)
+            console.log(`🤖 Running: claude ${args.join(' ')}`);
+            if (stdinInput) {
+                console.log(`📝 Prompt via stdin: ${stdinInput.length} chars (first 100: ${stdinInput.slice(0, 100).replace(/\n/g, '\\n')}...)`);
+            }
             console.log(`⏱️ Timeouts: initial=${INITIAL_TIMEOUT / 1000}s, stall=${STALL_TIMEOUT / 1000}s, max=${this.timeout / 1000}s`);
             const proc = (0, child_process_1.spawn)('claude', args, {
                 cwd: session.projectPath || process.cwd(),
@@ -331,13 +366,20 @@ Your response MUST include:
                     ...process.env,
                     CLAUDE_CODE_ENTRYPOINT: 'cli',
                 },
-                stdio: ['ignore', 'pipe', 'pipe']
+                stdio: [stdinInput ? 'pipe' : 'ignore', 'pipe', 'pipe']
             });
             console.log(`🚀 Claude process spawned with PID: ${proc.pid}`);
             if (!proc.pid) {
                 reject(new Error('Failed to spawn Claude process'));
                 return;
             }
+            // Write prompt to stdin if provided
+            if (stdinInput && proc.stdin) {
+                console.log(`📤 Writing prompt to stdin...`);
+                proc.stdin.write(stdinInput);
+                proc.stdin.end();
+                console.log(`✅ Stdin closed`);
+            }
             // Heartbeat: log status every 30 seconds
             heartbeatInterval = setInterval(() => {
                 const elapsed = Math.round((Date.now() - lastOutputTime) / 1000);
@@ -362,6 +404,11 @@ Your response MUST include:
                 if (initialTimeoutHandle)
                     clearTimeout(initialTimeoutHandle);
             };
+            if (!proc.stdout || !proc.stderr) {
+                cleanup();
+                reject(new Error('Failed to get stdout/stderr pipes from Claude process'));
+                return;
+            }
             proc.stdout.on('data', (data) => {
                 const chunk = data.toString();
                 stdout += chunk;