@litmers/cursorflow-orchestrator 0.1.2 → 0.1.5

package/src/utils/{config.js → config.ts}

@@ -1,17 +1,18 @@
-#!/usr/bin/env node
 /**
  * Configuration loader for CursorFlow
  * 
  * Finds project root and loads user configuration with defaults
  */
 
-const path = require('path');
-const fs = require('fs');
+import * as path from 'path';
+import * as fs from 'fs';
+import { CursorFlowConfig } from './types';
+export { CursorFlowConfig };
 
 /**
  * Find project root by looking for package.json
  */
-function findProjectRoot(cwd = process.cwd()) {
+export function findProjectRoot(cwd = process.cwd()): string {
   let current = cwd;
   
   while (current !== path.parse(current).root) {
@@ -28,7 +29,7 @@ function findProjectRoot(cwd = process.cwd()) {
 /**
  * Load configuration with defaults
  */
-function loadConfig(projectRoot = null) {
+export function loadConfig(projectRoot: string | null = null): CursorFlowConfig {
   if (!projectRoot) {
     projectRoot = findProjectRoot();
   }
@@ -36,7 +37,7 @@ function loadConfig(projectRoot = null) {
   const configPath = path.join(projectRoot, 'cursorflow.config.js');
   
   // Default configuration
-  const defaults = {
+  const defaults: CursorFlowConfig = {
     // Directories
     tasksDir: '_cursorflow/tasks',
     logsDir: '_cursorflow/logs',
@@ -46,8 +47,8 @@ function loadConfig(projectRoot = null) {
     branchPrefix: 'feature/',
     
     // Execution
-    executor: 'cursor-agent',  // 'cursor-agent' | 'cloud'
-    pollInterval: 60,          // seconds
+    executor: 'cursor-agent',
+    pollInterval: 60,
     
     // Dependencies
     allowDependencyChange: false,
@@ -60,12 +61,12 @@ function loadConfig(projectRoot = null) {
     
     // Lane defaults
     defaultLaneConfig: {
-      devPort: 3001,           // 3000 + laneNumber
+      devPort: 3001,
       autoCreatePr: false,
     },
     
     // Logging
-    logLevel: 'info',          // 'error' | 'warn' | 'info' | 'debug'
+    logLevel: 'info',
     verboseGit: false,
     
     // Advanced
@@ -81,7 +82,7 @@ function loadConfig(projectRoot = null) {
     try {
       const userConfig = require(configPath);
       return { ...defaults, ...userConfig, projectRoot };
-    } catch (error) {
+    } catch (error: any) {
       console.warn(`Warning: Failed to load config from ${configPath}: ${error.message}`);
       console.warn('Using default configuration...');
     }
@@ -93,22 +94,22 @@ function loadConfig(projectRoot = null) {
 /**
  * Get absolute path for tasks directory
  */
-function getTasksDir(config) {
+export function getTasksDir(config: CursorFlowConfig): string {
   return path.join(config.projectRoot, config.tasksDir);
 }
 
 /**
  * Get absolute path for logs directory
  */
-function getLogsDir(config) {
+export function getLogsDir(config: CursorFlowConfig): string {
   return path.join(config.projectRoot, config.logsDir);
 }
 
 /**
  * Validate configuration
  */
-function validateConfig(config) {
-  const errors = [];
+export function validateConfig(config: CursorFlowConfig): boolean {
+  const errors: string[] = [];
   
   if (!config.tasksDir) {
     errors.push('tasksDir is required');
@@ -136,7 +137,7 @@ function validateConfig(config) {
 /**
  * Create default config file
  */
-function createDefaultConfig(projectRoot, force = false) {
+export function createDefaultConfig(projectRoot: string, force = false): string {
   const configPath = path.join(projectRoot, 'cursorflow.config.js');
   
   if (fs.existsSync(configPath) && !force) {
@@ -184,12 +185,3 @@ function createDefaultConfig(projectRoot, force = false) {
   fs.writeFileSync(configPath, template, 'utf8');
   return configPath;
 }
-
-module.exports = {
-  findProjectRoot,
-  loadConfig,
-  getTasksDir,
-  getLogsDir,
-  validateConfig,
-  createDefaultConfig,
-};

package/src/utils/{cursor-agent.js → cursor-agent.ts}

@@ -1,17 +1,16 @@
-#!/usr/bin/env node
 /**
  * Cursor Agent CLI wrapper and utilities
  */
 
-const { execSync, spawnSync } = require('child_process');
+import { execSync, spawnSync } from 'child_process';
 
 /**
  * Check if cursor-agent CLI is installed
  */
-function checkCursorAgentInstalled() {
+export function checkCursorAgentInstalled(): boolean {
   try {
-    execSync('cursor-agent --version', { stdio: 'pipe' });
-    return true;
+    const result = spawnSync('cursor-agent', ['--version'], { stdio: 'pipe' });
+    return result.status === 0;
   } catch {
     return false;
   }
@@ -20,13 +19,13 @@ function checkCursorAgentInstalled() {
 /**
  * Get cursor-agent version
  */
-function getCursorAgentVersion() {
+export function getCursorAgentVersion(): string | null {
   try {
-    const version = execSync('cursor-agent --version', {
+    const result = spawnSync('cursor-agent', ['--version'], {
       encoding: 'utf8',
       stdio: 'pipe',
-    }).trim();
-    return version;
+    });
+    return result.status === 0 ? result.stdout.trim() : null;
   } catch {
     return null;
   }
@@ -35,7 +34,7 @@ function getCursorAgentVersion() {
 /**
  * Ensure cursor-agent is installed, exit with error message if not
  */
-function ensureCursorAgent() {
+export function ensureCursorAgent(): void {
   if (!checkCursorAgentInstalled()) {
     console.error(`
 ❌ cursor-agent CLI is not installed
@@ -56,7 +55,7 @@ More info: https://docs.cursor.com/agent
 /**
  * Print installation guide
  */
-function printInstallationGuide() {
+export function printInstallationGuide(): void {
   console.log(`
 📦 cursor-agent CLI Installation Guide
 
@@ -83,15 +82,15 @@ After installation, run your command again.
 /**
  * Check if CURSOR_API_KEY is set (for cloud execution)
  */
-function checkCursorApiKey() {
-  return !!process.env.CURSOR_API_KEY;
+export function checkCursorApiKey(): boolean {
+  return !!process.env['CURSOR_API_KEY'];
 }
 
 /**
  * Validate cursor-agent setup for given executor type
  */
-function validateSetup(executor = 'cursor-agent') {
-  const errors = [];
+export function validateSetup(executor = 'cursor-agent'): { valid: boolean; errors: string[] } {
+  const errors: string[] = [];
   
   if (executor === 'cursor-agent') {
     if (!checkCursorAgentInstalled()) {
@@ -114,20 +113,18 @@ function validateSetup(executor = 'cursor-agent') {
 /**
  * Get available models (if cursor-agent supports it)
  */
-function getAvailableModels() {
+export function getAvailableModels(): string[] {
   try {
     // This is a placeholder - actual implementation depends on cursor-agent API
-    const result = execSync('cursor-agent --model invalid "test"', {
-      encoding: 'utf8',
-      stdio: 'pipe',
-    });
+    // execSync('cursor-agent --model invalid "test"', {
+    //   encoding: 'utf8',
+    //   stdio: 'pipe',
+    // });
     
-    // Parse models from error message
-    // This is an example - actual parsing depends on cursor-agent output
     return [];
-  } catch (error) {
+  } catch (error: any) {
     // Parse from error message
-    const output = error.stderr || error.stdout || '';
+    const output = (error.stderr || error.stdout || '').toString();
     // Extract model names from output
     return parseModelsFromOutput(output);
   }
@@ -136,10 +133,10 @@ function getAvailableModels() {
 /**
  * Parse model names from cursor-agent output
  */
-function parseModelsFromOutput(output) {
+export function parseModelsFromOutput(output: string): string[] {
   // This is a placeholder implementation
   // Actual parsing depends on cursor-agent CLI output format
-  const models = [];
+  const models: string[] = [];
   
   // Example parsing logic
   const lines = output.split('\n');
@@ -147,7 +144,7 @@ function parseModelsFromOutput(output) {
     if (line.includes('sonnet') || line.includes('opus') || line.includes('gpt')) {
       const match = line.match(/['"]([^'"]+)['"]/);
       if (match) {
-        models.push(match[1]);
+        models.push(match[1]!);
       }
     }
   }
@@ -158,7 +155,7 @@ function parseModelsFromOutput(output) {
 /**
  * Test cursor-agent with a simple command
  */
-function testCursorAgent() {
+export function testCursorAgent(): { success: boolean; output?: string; error?: string } {
   try {
     const result = spawnSync('cursor-agent', ['--help'], {
       encoding: 'utf8',
@@ -170,7 +167,7 @@ function testCursorAgent() {
       output: result.stdout,
       error: result.stderr,
     };
-  } catch (error) {
+  } catch (error: any) {
     return {
       success: false,
       error: error.message,
@@ -178,10 +175,18 @@ function testCursorAgent() {
   }
 }
 
+export interface AuthCheckResult {
+  authenticated: boolean;
+  message: string;
+  details?: string;
+  help?: string;
+  error?: string;
+}
+
 /**
  * Check cursor-agent authentication
  */
-function checkCursorAuth() {
+export function checkCursorAuth(): AuthCheckResult {
   try {
     const result = spawnSync('cursor-agent', ['create-chat'], {
       encoding: 'utf8',
@@ -196,7 +201,7 @@ function checkCursorAuth() {
       };
     }
     
-    const errorMsg = result.stderr?.trim() || result.stdout?.trim() || '';
+    const errorMsg = (result.stderr?.trim() || result.stdout?.trim() || '').toString();
     
     // Check for authentication errors
     if (errorMsg.includes('not authenticated') || 
@@ -227,7 +232,7 @@ function checkCursorAuth() {
       message: 'Unknown error',
       details: errorMsg,
     };
-  } catch (error) {
+  } catch (error: any) {
     if (error.code === 'ETIMEDOUT') {
       return {
         authenticated: false,
@@ -247,7 +252,7 @@ function checkCursorAuth() {
 /**
  * Print authentication help
  */
-function printAuthHelp() {
+export function printAuthHelp(): void {
   console.log(`
 🔐 Cursor Authentication Required
 
@@ -268,19 +273,5 @@ Common issues:
   • VPN or firewall blocking Cursor API
 
 For more help, visit: https://docs.cursor.com
-
   `);
 }
-
-module.exports = {
-  checkCursorAgentInstalled,
-  getCursorAgentVersion,
-  ensureCursorAgent,
-  printInstallationGuide,
-  checkCursorApiKey,
-  validateSetup,
-  getAvailableModels,
-  testCursorAgent,
-  checkCursorAuth,
-  printAuthHelp,
-};

package/src/utils/{git.js → git.ts}

@@ -1,24 +1,59 @@
-#!/usr/bin/env node
 /**
  * Git utilities for CursorFlow
  */
 
-const { execSync, spawnSync } = require('child_process');
-const path = require('path');
+import { execSync, spawnSync } from 'child_process';
+
+export interface GitRunOptions {
+  cwd?: string;
+  silent?: boolean;
+}
+
+export interface GitResult {
+  exitCode: number;
+  stdout: string;
+  stderr: string;
+  success: boolean;
+}
+
+export interface WorktreeInfo {
+  path: string;
+  branch?: string;
+  head?: string;
+}
+
+export interface ChangedFile {
+  status: string;
+  file: string;
+}
+
+export interface CommitInfo {
+  hash: string;
+  shortHash: string;
+  author: string;
+  authorEmail: string;
+  timestamp: number;
+  subject: string;
+}
 
 /**
  * Run git command and return output
  */
-function runGit(args, options = {}) {
+export function runGit(args: string[], options: GitRunOptions = {}): string {
   const { cwd, silent = false } = options;
   
   try {
-    const result = execSync(`git ${args.join(' ')}`, {
+    const result = spawnSync('git', args, {
       cwd: cwd || process.cwd(),
       encoding: 'utf8',
       stdio: silent ? 'pipe' : 'inherit',
     });
-    return result ? result.trim() : '';
+    
+    if (result.status !== 0 && !silent) {
+      throw new Error(`Git command failed: git ${args.join(' ')}\n${result.stderr || ''}`);
+    }
+    
+    return result.stdout ? result.stdout.trim() : '';
   } catch (error) {
     if (silent) {
       return '';
@@ -30,7 +65,7 @@ function runGit(args, options = {}) {
 /**
  * Run git command and return result object
  */
-function runGitResult(args, options = {}) {
+export function runGitResult(args: string[], options: GitRunOptions = {}): GitResult {
   const { cwd } = options;
   
   const result = spawnSync('git', args, {
@@ -41,8 +76,8 @@ function runGitResult(args, options = {}) {
   
   return {
     exitCode: result.status ?? 1,
-    stdout: (result.stdout || '').trim(),
-    stderr: (result.stderr || '').trim(),
+    stdout: (result.stdout || '').toString().trim(),
+    stderr: (result.stderr || '').toString().trim(),
     success: result.status === 0,
   };
 }
@@ -50,21 +85,21 @@ function runGitResult(args, options = {}) {
 /**
  * Get current branch name
  */
-function getCurrentBranch(cwd) {
+export function getCurrentBranch(cwd?: string): string {
   return runGit(['rev-parse', '--abbrev-ref', 'HEAD'], { cwd, silent: true });
 }
 
 /**
  * Get repository root directory
  */
-function getRepoRoot(cwd) {
+export function getRepoRoot(cwd?: string): string {
   return runGit(['rev-parse', '--show-toplevel'], { cwd, silent: true });
 }
 
 /**
  * Check if directory is a git repository
  */
-function isGitRepo(cwd) {
+export function isGitRepo(cwd?: string): boolean {
   const result = runGitResult(['rev-parse', '--git-dir'], { cwd });
   return result.success;
 }
@@ -72,7 +107,7 @@ function isGitRepo(cwd) {
 /**
  * Check if worktree exists
  */
-function worktreeExists(worktreePath, cwd) {
+export function worktreeExists(worktreePath: string, cwd?: string): boolean {
   const result = runGitResult(['worktree', 'list'], { cwd });
   if (!result.success) return false;
   
@@ -82,7 +117,7 @@ function worktreeExists(worktreePath, cwd) {
 /**
  * Create worktree
  */
-function createWorktree(worktreePath, branchName, options = {}) {
+export function createWorktree(worktreePath: string, branchName: string, options: { cwd?: string; baseBranch?: string } = {}): string {
   const { cwd, baseBranch = 'main' } = options;
   
   // Check if branch already exists
@@ -102,7 +137,7 @@ function createWorktree(worktreePath, branchName, options = {}) {
 /**
  * Remove worktree
  */
-function removeWorktree(worktreePath, options = {}) {
+export function removeWorktree(worktreePath: string, options: { cwd?: string; force?: boolean } = {}): void {
   const { cwd, force = false } = options;
   
   const args = ['worktree', 'remove', worktreePath];
@@ -116,18 +151,18 @@ function removeWorktree(worktreePath, options = {}) {
 /**
  * List all worktrees
  */
-function listWorktrees(cwd) {
+export function listWorktrees(cwd?: string): WorktreeInfo[] {
   const result = runGitResult(['worktree', 'list', '--porcelain'], { cwd });
   if (!result.success) return [];
   
-  const worktrees = [];
+  const worktrees: WorktreeInfo[] = [];
   const lines = result.stdout.split('\n');
-  let current = {};
+  let current: Partial<WorktreeInfo> = {};
   
   for (const line of lines) {
     if (line.startsWith('worktree ')) {
       if (current.path) {
-        worktrees.push(current);
+        worktrees.push(current as WorktreeInfo);
       }
       current = { path: line.slice(9) };
     } else if (line.startsWith('branch ')) {
@@ -138,7 +173,7 @@ function listWorktrees(cwd) {
   }
   
   if (current.path) {
-    worktrees.push(current);
+    worktrees.push(current as WorktreeInfo);
   }
   
   return worktrees;
@@ -147,7 +182,7 @@ function listWorktrees(cwd) {
 /**
  * Check if there are uncommitted changes
  */
-function hasUncommittedChanges(cwd) {
+export function hasUncommittedChanges(cwd?: string): boolean {
   const result = runGitResult(['status', '--porcelain'], { cwd });
   return result.success && result.stdout.length > 0;
 }
@@ -155,7 +190,7 @@ function hasUncommittedChanges(cwd) {
 /**
  * Get list of changed files
  */
-function getChangedFiles(cwd) {
+export function getChangedFiles(cwd?: string): ChangedFile[] {
   const result = runGitResult(['status', '--porcelain'], { cwd });
   if (!result.success) return [];
   
@@ -172,7 +207,7 @@ function getChangedFiles(cwd) {
 /**
  * Create commit
  */
-function commit(message, options = {}) {
+export function commit(message: string, options: { cwd?: string; addAll?: boolean } = {}): void {
   const { cwd, addAll = true } = options;
   
   if (addAll) {
@@ -185,7 +220,7 @@ function commit(message, options = {}) {
 /**
  * Push to remote
  */
-function push(branchName, options = {}) {
+export function push(branchName: string, options: { cwd?: string; force?: boolean; setUpstream?: boolean } = {}): void {
   const { cwd, force = false, setUpstream = false } = options;
   
   const args = ['push'];
@@ -206,7 +241,7 @@ function push(branchName, options = {}) {
 /**
  * Fetch from remote
  */
-function fetch(options = {}) {
+export function fetch(options: { cwd?: string; prune?: boolean } = {}): void {
   const { cwd, prune = true } = options;
   
   const args = ['fetch', 'origin'];
@@ -220,7 +255,7 @@ function fetch(options = {}) {
 /**
  * Check if branch exists (local or remote)
  */
-function branchExists(branchName, options = {}) {
+export function branchExists(branchName: string, options: { cwd?: string; remote?: boolean } = {}): boolean {
   const { cwd, remote = false } = options;
   
   if (remote) {
@@ -235,7 +270,7 @@ function branchExists(branchName, options = {}) {
 /**
  * Delete branch
  */
-function deleteBranch(branchName, options = {}) {
+export function deleteBranch(branchName: string, options: { cwd?: string; force?: boolean; remote?: boolean } = {}): void {
   const { cwd, force = false, remote = false } = options;
   
   if (remote) {
@@ -249,7 +284,7 @@ function deleteBranch(branchName, options = {}) {
 /**
  * Merge branch
  */
-function merge(branchName, options = {}) {
+export function merge(branchName: string, options: { cwd?: string; noFf?: boolean; message?: string | null } = {}): void {
   const { cwd, noFf = false, message = null } = options;
   
   const args = ['merge'];
@@ -270,7 +305,7 @@ function merge(branchName, options = {}) {
 /**
  * Get commit info
  */
-function getCommitInfo(commitHash, options = {}) {
+export function getCommitInfo(commitHash: string, options: { cwd?: string } = {}): CommitInfo | null {
   const { cwd } = options;
   
   const format = '--format=%H%n%h%n%an%n%ae%n%at%n%s';
@@ -280,32 +315,11 @@ function getCommitInfo(commitHash, options = {}) {
   
   const lines = result.stdout.split('\n');
   return {
-    hash: lines[0],
-    shortHash: lines[1],
-    author: lines[2],
-    authorEmail: lines[3],
-    timestamp: parseInt(lines[4]),
-    subject: lines[5],
+    hash: lines[0] || '',
+    shortHash: lines[1] || '',
+    author: lines[2] || '',
+    authorEmail: lines[3] || '',
+    timestamp: parseInt(lines[4] || '0'),
+    subject: lines[5] || '',
   };
 }
-
-module.exports = {
-  runGit,
-  runGitResult,
-  getCurrentBranch,
-  getRepoRoot,
-  isGitRepo,
-  worktreeExists,
-  createWorktree,
-  removeWorktree,
-  listWorktrees,
-  hasUncommittedChanges,
-  getChangedFiles,
-  commit,
-  push,
-  fetch,
-  branchExists,
-  deleteBranch,
-  merge,
-  getCommitInfo,
-};