claudedesk 1.0.0

package/dist/core/insights-extractor.js

@@ -0,0 +1,402 @@
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
+/**
+ * Extracts insights from Claude's output to explain what was done and why.
+ * Parses the conversational output and structures it into actionable insights.
+ */
+export class InsightsExtractor {
+    /**
+     * Extract insights from a job's Claude output
+     */
+    extractFromJob(artifactsDir, changedFiles) {
+        const claudeOutputPath = join(artifactsDir, 'claude', 'output.txt');
+        const promptPath = join(artifactsDir, 'claude', 'prompt.md');
+        if (!existsSync(claudeOutputPath)) {
+            console.log('[InsightsExtractor] No Claude output found');
+            return null;
+        }
+        const output = readFileSync(claudeOutputPath, 'utf-8');
+        const prompt = existsSync(promptPath) ? readFileSync(promptPath, 'utf-8') : '';
+        if (!output || output.trim().length === 0) {
+            console.log('[InsightsExtractor] Claude output is empty');
+            return null;
+        }
+        console.log(`[InsightsExtractor] Extracting insights from ${output.length} chars of output`);
+        const insights = this.parseOutput(output, prompt, changedFiles || []);
+        // Save insights to file
+        const insightsPath = join(artifactsDir, 'insights.json');
+        writeFileSync(insightsPath, JSON.stringify(insights, null, 2));
+        console.log(`[InsightsExtractor] Saved insights to ${insightsPath}`);
+        return insights;
+    }
+    /**
+     * Extract insights from a create-repo workflow (scaffolded projects)
+     */
+    extractFromCreateRepo(artifactsDir, params) {
+        const claudeOutputPath = join(artifactsDir, 'claude', 'output.txt');
+        if (!existsSync(claudeOutputPath)) {
+            console.log('[InsightsExtractor] No Claude output found for create-repo');
+            return null;
+        }
+        const output = readFileSync(claudeOutputPath, 'utf-8');
+        if (!output || output.trim().length === 0) {
+            console.log('[InsightsExtractor] Claude output is empty');
+            return null;
+        }
+        console.log(`[InsightsExtractor] Extracting creation insights from ${output.length} chars of output`);
+        const templateId = params?.templateId || 'unknown';
+        const repoName = params?.repoName || 'new project';
+        const featureDescription = params?.featureDescription || params?.prompt || '';
+        const insights = {
+            summary: `Created ${repoName} using ${templateId} template`,
+            problem: featureDescription || `Scaffold a new ${templateId} project`,
+            solution: this.extractCreationSolution(output, templateId),
+            reasoning: this.extractCreationReasoning(output, templateId),
+            filesChanged: this.extractCreatedFiles(output),
+            patterns: ['Project scaffolding', 'Template-based setup'],
+        };
+        // Save insights to file
+        const insightsPath = join(artifactsDir, 'insights.json');
+        writeFileSync(insightsPath, JSON.stringify(insights, null, 2));
+        console.log(`[InsightsExtractor] Saved creation insights to ${insightsPath}`);
+        return insights;
+    }
+    /**
+     * Extract what was created in a scaffolded project
+     */
+    extractCreationSolution(output, templateId) {
+        const solutions = [];
+        // Look for file creation patterns
+        const filePatterns = [
+            /(?:created?|wrote?|generated?|added?)\s+(?:file\s+)?[`']?([^\s`']+\.[a-z]+)[`']?/gi,
+            /(?:setting up|configured?|initialized?)\s+(.+?)(?:\.|$)/gi,
+        ];
+        for (const pattern of filePatterns) {
+            let match;
+            while ((match = pattern.exec(output)) !== null) {
+                const item = match[1].trim();
+                if (item.length > 3 && item.length < 100 && !solutions.includes(item)) {
+                    solutions.push(`Created ${item}`);
+                }
+            }
+        }
+        // Add template-specific defaults if nothing found
+        if (solutions.length === 0) {
+            const templateDefaults = {
+                'nextjs-web': [
+                    'Set up Next.js project structure',
+                    'Configured TypeScript',
+                    'Added Tailwind CSS styling',
+                    'Created initial page components',
+                ],
+                'default': [
+                    'Scaffolded project structure',
+                    'Created configuration files',
+                    'Set up development environment',
+                ],
+            };
+            return templateDefaults[templateId] || templateDefaults['default'];
+        }
+        return solutions.slice(0, 5);
+    }
+    /**
+     * Extract reasoning for architectural decisions in scaffolded project
+     */
+    extractCreationReasoning(output, templateId) {
+        // Look for reasoning patterns
+        const reasoningPatterns = [
+            /(?:because|since|to)\s+(.+?)(?:\.|$)/gi,
+            /(?:this|the)\s+(?:template|setup|structure)\s+(?:provides?|enables?|allows?)\s+(.+?)(?:\.|$)/gi,
+        ];
+        for (const pattern of reasoningPatterns) {
+            const match = output.match(pattern);
+            if (match) {
+                const reason = match[1].trim();
+                if (reason.length > 20 && reason.length < 200) {
+                    return this.capitalizeFirst(reason);
+                }
+            }
+        }
+        // Template-specific default reasoning
+        const defaultReasoning = {
+            'nextjs-web': 'Next.js provides server-side rendering, file-based routing, and excellent TypeScript support for modern web applications',
+            'default': 'Template provides a solid foundation with best practices and common configurations pre-configured',
+        };
+        return defaultReasoning[templateId] || defaultReasoning['default'];
+    }
+    /**
+     * Extract list of created files from output
+     */
+    extractCreatedFiles(output) {
+        const files = [];
+        // Look for file paths in output
+        const filePattern = /(?:created?|wrote?|generated?)\s+[`']?([^\s`']+\.[a-z]+)[`']?/gi;
+        let match;
+        while ((match = filePattern.exec(output)) !== null) {
+            const filePath = match[1];
+            if (!files.find(f => f.path === filePath)) {
+                files.push({
+                    path: filePath,
+                    changes: this.generateFileChangeDescription(filePath),
+                });
+            }
+        }
+        return files.slice(0, 10);
+    }
+    /**
+     * Parse Claude's output and extract structured insights
+     */
+    parseOutput(output, prompt, changedFiles) {
+        // Extract problem from prompt
+        const problem = this.extractProblem(prompt, output);
+        // Extract what was done
+        const solution = this.extractSolution(output);
+        // Extract reasoning
+        const reasoning = this.extractReasoning(output);
+        // Generate summary
+        const summary = this.generateSummary(problem, solution);
+        // Extract per-file changes
+        const filesChanged = this.extractFileChanges(output, changedFiles);
+        // Identify patterns
+        const patterns = this.identifyPatterns(output, problem);
+        // Generate prevention tips
+        const preventionTips = this.generatePreventionTips(patterns, problem);
+        return {
+            summary,
+            problem,
+            solution,
+            reasoning,
+            filesChanged,
+            patterns: patterns.length > 0 ? patterns : undefined,
+            preventionTips: preventionTips.length > 0 ? preventionTips : undefined,
+        };
+    }
+    /**
+     * Extract the problem description from prompt and output
+     */
+    extractProblem(prompt, output) {
+        // Try to extract from prompt first
+        const promptMatch = prompt.match(/## Failed Step Output[\s\S]*?```([\s\S]*?)```/);
+        if (promptMatch) {
+            const errorLog = promptMatch[1].trim();
+            // Extract first meaningful error line
+            const errorLines = errorLog.split('\n').filter(line => line.includes('error') ||
+                line.includes('Error') ||
+                line.includes('failed') ||
+                line.includes('Failed') ||
+                line.includes('TypeError') ||
+                line.includes('ReferenceError') ||
+                line.includes('SyntaxError'));
+            if (errorLines.length > 0) {
+                return this.cleanErrorMessage(errorLines[0]);
+            }
+        }
+        // Try to extract from Claude's analysis in output
+        const analysisPatterns = [
+            /(?:the (?:issue|problem|error|bug) (?:is|was))\s+(.+?)(?:\.|$)/i,
+            /(?:found|identified|discovered)\s+(?:a|an|the)?\s*(.+?)(?:error|issue|problem|bug)(.+?)(?:\.|$)/i,
+            /(?:this|the)\s+(?:error|issue|problem|bug)\s+(?:is|was)\s+(?:caused by|due to)\s+(.+?)(?:\.|$)/i,
+        ];
+        for (const pattern of analysisPatterns) {
+            const match = output.match(pattern);
+            if (match) {
+                return this.cleanErrorMessage(match[1] + (match[2] || ''));
+            }
+        }
+        return 'Issue identified and resolved by Claude';
+    }
+    /**
+     * Extract what Claude did to fix the issue
+     */
+    extractSolution(output) {
+        const solutions = [];
+        // Look for explicit "I did X" or "Fixed by" patterns
+        const actionPatterns = [
+            /(?:I |I've |I have )?(added|created|updated|modified|fixed|changed|removed|replaced|implemented|refactored)\s+(.+?)(?:\.|$)/gi,
+            /(?:by |through )(adding|creating|updating|modifying|fixing|changing|removing|replacing|implementing)\s+(.+?)(?:\.|$)/gi,
+        ];
+        for (const pattern of actionPatterns) {
+            let match;
+            while ((match = pattern.exec(output)) !== null) {
+                const action = match[1].toLowerCase();
+                const target = match[2].trim();
+                if (target.length > 5 && target.length < 150) {
+                    solutions.push(`${this.capitalizeFirst(action)} ${target}`);
+                }
+            }
+        }
+        // Look for bullet-point style lists
+        const bulletMatches = output.match(/^[\s]*[-•*]\s+(.+?)$/gm);
+        if (bulletMatches) {
+            for (const bullet of bulletMatches) {
+                const text = bullet.replace(/^[\s]*[-•*]\s+/, '').trim();
+                if (text.length > 10 && text.length < 150 && !solutions.includes(text)) {
+                    solutions.push(text);
+                }
+            }
+        }
+        // Deduplicate and limit
+        const uniqueSolutions = [...new Set(solutions)].slice(0, 5);
+        if (uniqueSolutions.length === 0) {
+            return ['Applied fixes based on error analysis'];
+        }
+        return uniqueSolutions;
+    }
+    /**
+     * Extract reasoning for why this approach was chosen
+     */
+    extractReasoning(output) {
+        const reasoningPatterns = [
+            /(?:because|since|as)\s+(.+?)(?:\.|$)/gi,
+            /(?:this approach|this solution|this fix)\s+(?:is|was)\s+(?:chosen|used|preferred)\s+(?:because|since|as)\s+(.+?)(?:\.|$)/gi,
+            /(?:the reason|reasoning)\s+(?:is|was|for this)\s+(.+?)(?:\.|$)/gi,
+            /(?:I chose|I decided|I opted)\s+(?:to|for)\s+(.+?)\s+(?:because|since|as)\s+(.+?)(?:\.|$)/gi,
+        ];
+        for (const pattern of reasoningPatterns) {
+            const match = output.match(pattern);
+            if (match) {
+                const reason = (match[1] + (match[2] || '')).trim();
+                if (reason.length > 20 && reason.length < 300) {
+                    return this.capitalizeFirst(reason);
+                }
+            }
+        }
+        return 'Minimal changes applied to fix the identified issue while preserving existing functionality';
+    }
+    /**
+     * Extract per-file change explanations
+     */
+    extractFileChanges(output, changedFiles) {
+        const fileChanges = [];
+        for (const file of changedFiles) {
+            const fileName = file.split('/').pop() || file;
+            const filePattern = new RegExp(`(?:in|to|for|modified|updated|changed|edited)\\s+[\`']?${this.escapeRegex(fileName)}[\`']?[^.]*?(?:to|by|:)?\\s*([^.]+)`, 'i');
+            const match = output.match(filePattern);
+            if (match) {
+                fileChanges.push({
+                    path: file,
+                    changes: this.capitalizeFirst(match[1].trim()),
+                });
+            }
+            else {
+                // Generate generic description based on file type
+                fileChanges.push({
+                    path: file,
+                    changes: this.generateFileChangeDescription(file),
+                });
+            }
+        }
+        return fileChanges;
+    }
+    /**
+     * Identify common patterns/issues from the output
+     */
+    identifyPatterns(output, problem) {
+        const patterns = [];
+        const combined = (output + ' ' + problem).toLowerCase();
+        const patternKeywords = {
+            'null': 'Null/undefined check',
+            'undefined': 'Null/undefined check',
+            'type error': 'Type mismatch',
+            'typeerror': 'Type mismatch',
+            'missing import': 'Missing import',
+            'import': 'Import issue',
+            'async': 'Async/await handling',
+            'await': 'Async/await handling',
+            'race condition': 'Race condition',
+            'timeout': 'Timeout handling',
+            'memory': 'Memory management',
+            'syntax': 'Syntax error',
+            'lint': 'Linting issue',
+            'deprecated': 'Deprecated API usage',
+            'version': 'Version compatibility',
+            'dependency': 'Dependency issue',
+            'circular': 'Circular dependency',
+            'permission': 'Permission issue',
+            'authentication': 'Authentication issue',
+            'authorization': 'Authorization issue',
+        };
+        for (const [keyword, pattern] of Object.entries(patternKeywords)) {
+            if (combined.includes(keyword) && !patterns.includes(pattern)) {
+                patterns.push(pattern);
+            }
+        }
+        return patterns.slice(0, 3);
+    }
+    /**
+     * Generate prevention tips based on identified patterns
+     */
+    generatePreventionTips(patterns, problem) {
+        const tips = [];
+        const tipMap = {
+            'Null/undefined check': 'Use optional chaining (?.) and nullish coalescing (??) operators for safer property access',
+            'Type mismatch': 'Enable strict TypeScript mode and add explicit type annotations',
+            'Missing import': 'Configure your IDE to auto-import and catch missing imports at lint time',
+            'Import issue': 'Organize imports consistently and use absolute imports where possible',
+            'Async/await handling': 'Always handle promise rejections with try/catch or .catch()',
+            'Race condition': 'Use proper synchronization mechanisms or sequential execution for dependent operations',
+            'Timeout handling': 'Implement retry logic with exponential backoff for network operations',
+            'Memory management': 'Clean up subscriptions and event listeners in component unmount/cleanup',
+            'Syntax error': 'Enable auto-formatting and lint-on-save in your editor',
+            'Linting issue': 'Run linter as part of your pre-commit hooks',
+            'Deprecated API usage': 'Keep dependencies up to date and monitor deprecation warnings',
+            'Version compatibility': 'Pin dependency versions and test upgrades in isolation',
+            'Dependency issue': 'Regularly audit and update dependencies with npm audit',
+            'Circular dependency': 'Use dependency injection or restructure modules to break cycles',
+            'Permission issue': 'Implement proper role-based access control from the start',
+            'Authentication issue': 'Use established auth libraries and follow security best practices',
+            'Authorization issue': 'Implement authorization checks at both API and UI layers',
+        };
+        for (const pattern of patterns) {
+            if (tipMap[pattern]) {
+                tips.push(tipMap[pattern]);
+            }
+        }
+        return tips.slice(0, 2);
+    }
+    /**
+     * Generate a one-line summary
+     */
+    generateSummary(problem, solution) {
+        if (solution.length > 0) {
+            return `${solution[0]} to resolve: ${problem.slice(0, 80)}${problem.length > 80 ? '...' : ''}`;
+        }
+        return `Resolved: ${problem.slice(0, 100)}${problem.length > 100 ? '...' : ''}`;
+    }
+    /**
+     * Generate generic file change description based on file type
+     */
+    generateFileChangeDescription(filePath) {
+        const ext = filePath.split('.').pop()?.toLowerCase();
+        const descriptions = {
+            'ts': 'Updated TypeScript code',
+            'tsx': 'Updated React component',
+            'js': 'Updated JavaScript code',
+            'jsx': 'Updated React component',
+            'json': 'Updated configuration',
+            'css': 'Updated styles',
+            'scss': 'Updated styles',
+            'html': 'Updated markup',
+            'md': 'Updated documentation',
+            'yml': 'Updated configuration',
+            'yaml': 'Updated configuration',
+        };
+        return descriptions[ext || ''] || 'Modified file';
+    }
+    // Utility functions
+    cleanErrorMessage(msg) {
+        return msg
+            .replace(/^\s*(?:error|Error|ERROR):\s*/i, '')
+            .replace(/\s+/g, ' ')
+            .trim()
+            .slice(0, 200);
+    }
+    capitalizeFirst(str) {
+        return str.charAt(0).toUpperCase() + str.slice(1);
+    }
+    escapeRegex(str) {
+        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+}
+export const insightsExtractor = new InsightsExtractor();
+//# sourceMappingURL=insights-extractor.js.map

package/dist/core/insights-extractor.js.map

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

package/dist/core/logger.d.ts

@@ -0,0 +1,27 @@
+/**
+ * OPS-01: Simple structured logger for better observability.
+ * Provides consistent log formatting with timestamps and levels.
+ *
+ * Usage:
+ *   import { logger } from './logger.js';
+ *   logger.info('Server started', { port: 8787 });
+ *   logger.error('Failed to connect', { error: err.message });
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Create a logger instance for a specific module.
+ * This provides consistent logging with the module name automatically included.
+ */
+export declare function createLogger(module: string): {
+    debug: (message: string, data?: Record<string, unknown>) => void;
+    info: (message: string, data?: Record<string, unknown>) => void;
+    warn: (message: string, data?: Record<string, unknown>) => void;
+    error: (message: string, data?: Record<string, unknown>) => void;
+};
+export declare const logger: {
+    debug: (message: string, data?: Record<string, unknown>) => void;
+    info: (message: string, data?: Record<string, unknown>) => void;
+    warn: (message: string, data?: Record<string, unknown>) => void;
+    error: (message: string, data?: Record<string, unknown>) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAiE3D;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM;qBAEtB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;oBACvC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;oBACtC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;qBACrC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAE1D;AAGD,eAAO,MAAM,MAAM;qBARE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;oBACvC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;oBACtC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;qBACrC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKlB,CAAC"}

package/dist/core/logger.js

@@ -0,0 +1,70 @@
+/**
+ * OPS-01: Simple structured logger for better observability.
+ * Provides consistent log formatting with timestamps and levels.
+ *
+ * Usage:
+ *   import { logger } from './logger.js';
+ *   logger.info('Server started', { port: 8787 });
+ *   logger.error('Failed to connect', { error: err.message });
+ */
+// Log level priority (lower = more verbose)
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+// Current log level from environment (default: info)
+const currentLevel = process.env.LOG_LEVEL || 'info';
+const currentLevelPriority = LOG_LEVELS[currentLevel] ?? LOG_LEVELS.info;
+// Output format: 'json' for structured, 'text' for human-readable
+const outputFormat = process.env.LOG_FORMAT || 'text';
+function formatLogEntry(entry) {
+    if (outputFormat === 'json') {
+        return JSON.stringify(entry);
+    }
+    // Text format: [timestamp] [LEVEL] [module] message {data}
+    const levelStr = entry.level.toUpperCase().padEnd(5);
+    const dataStr = entry.data ? ` ${JSON.stringify(entry.data)}` : '';
+    return `[${entry.timestamp}] [${levelStr}] [${entry.module}] ${entry.message}${dataStr}`;
+}
+function log(level, module, message, data) {
+    // Skip if below current log level
+    if (LOG_LEVELS[level] < currentLevelPriority) {
+        return;
+    }
+    const entry = {
+        timestamp: new Date().toISOString(),
+        level,
+        module,
+        message,
+        ...(data && { data }),
+    };
+    const formatted = formatLogEntry(entry);
+    // Use appropriate console method
+    switch (level) {
+        case 'error':
+            console.error(formatted);
+            break;
+        case 'warn':
+            console.warn(formatted);
+            break;
+        default:
+            console.log(formatted);
+    }
+}
+/**
+ * Create a logger instance for a specific module.
+ * This provides consistent logging with the module name automatically included.
+ */
+export function createLogger(module) {
+    return {
+        debug: (message, data) => log('debug', module, message, data),
+        info: (message, data) => log('info', module, message, data),
+        warn: (message, data) => log('warn', module, message, data),
+        error: (message, data) => log('error', module, message, data),
+    };
+}
+// Default logger for quick usage
+export const logger = createLogger('app');
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,4CAA4C;AAC5C,MAAM,UAAU,GAA6B;IAC3C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,qDAAqD;AACrD,MAAM,YAAY,GAAI,OAAO,CAAC,GAAG,CAAC,SAAsB,IAAI,MAAM,CAAC;AACnE,MAAM,oBAAoB,GAAG,UAAU,CAAC,YAAY,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC;AAEzE,kEAAkE;AAClE,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,MAAM,CAAC;AAEtD,SAAS,cAAc,CAAC,KAAe;IACrC,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,2DAA2D;IAC3D,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,OAAO,IAAI,KAAK,CAAC,SAAS,MAAM,QAAQ,MAAM,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,OAAO,GAAG,OAAO,EAAE,CAAC;AAC3F,CAAC;AAED,SAAS,GAAG,CAAC,KAAe,EAAE,MAAc,EAAE,OAAe,EAAE,IAA8B;IAC3F,kCAAkC;IAClC,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,oBAAoB,EAAE,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAa;QACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,KAAK;QACL,MAAM;QACN,OAAO;QACP,GAAG,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC;KACtB,CAAC;IAEF,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAExC,iCAAiC;IACjC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO;YACV,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACzB,MAAM;QACR,KAAK,MAAM;YACT,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,MAAM;QACR;YACE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO;QACL,KAAK,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;QAC/F,IAAI,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;QAC7F,IAAI,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;QAC7F,KAAK,EAAE,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;KAChG,CAAC;AACJ,CAAC;AAED,iCAAiC;AACjC,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC"}

package/dist/core/process-runner.d.ts

@@ -0,0 +1,27 @@
+import { ChildProcess } from 'child_process';
+export interface RunOptions {
+    cwd: string;
+    timeout?: number;
+    logFile?: string;
+    env?: Record<string, string>;
+}
+export interface RunResult {
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    killed: boolean;
+    error?: string;
+}
+export declare class ProcessRunner {
+    private runningProcesses;
+    run(command: string, options: RunOptions): Promise<RunResult>;
+    startServer(command: string, options: RunOptions): {
+        processId: string;
+        process: ChildProcess;
+    };
+    killProcess(processId: string): Promise<void>;
+    killAllProcesses(): Promise<void[]>;
+    getRunningProcessIds(): string[];
+}
+export declare const processRunner: ProcessRunner;
+//# sourceMappingURL=process-runner.d.ts.map

package/dist/core/process-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-runner.d.ts","sourceRoot":"","sources":["../../src/core/process-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,YAAY,EAAE,MAAM,eAAe,CAAC;AAKpD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,gBAAgB,CAAwC;IAE1D,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAsFnE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,YAAY,CAAA;KAAE;IA0C/F,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B7C,gBAAgB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAOnC,oBAAoB,IAAI,MAAM,EAAE;CAGjC;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}