@litmers/cursorflow-orchestrator 0.1.18 → 0.1.26

package/dist/utils/logger.js

@@ -1,128 +1,146 @@
 "use strict";
 /**
  * Logging utilities for CursorFlow
+ *
+ * 통일된 로그 형식: [HH:MM:SS] emoji TYPE message
+ * 컨텍스트 포함 시: [HH:MM:SS] [context] emoji TYPE message
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.COLORS = exports.LogLevel = void 0;
+exports.LogLevel = exports.COLORS = void 0;
 exports.setLogLevel = setLogLevel;
+exports.getLogLevel = getLogLevel;
 exports.error = error;
 exports.warn = warn;
 exports.info = info;
 exports.success = success;
 exports.debug = debug;
 exports.progress = progress;
+exports.withContext = withContext;
 exports.section = section;
+exports.raw = raw;
 exports.log = log;
-exports.json = json;
 exports.createSpinner = createSpinner;
-var LogLevel;
-(function (LogLevel) {
-    LogLevel[LogLevel["error"] = 0] = "error";
-    LogLevel[LogLevel["warn"] = 1] = "warn";
-    LogLevel[LogLevel["info"] = 2] = "info";
-    LogLevel[LogLevel["debug"] = 3] = "debug";
-})(LogLevel || (exports.LogLevel = LogLevel = {}));
-exports.COLORS = {
-    reset: '\x1b[0m',
-    red: '\x1b[31m',
-    yellow: '\x1b[33m',
-    green: '\x1b[32m',
-    blue: '\x1b[34m',
-    cyan: '\x1b[36m',
-    magenta: '\x1b[35m',
-    gray: '\x1b[90m',
-    bold: '\x1b[1m',
-};
-let currentLogLevel = LogLevel.info;
+const log_constants_1 = require("./log-constants");
+Object.defineProperty(exports, "COLORS", { enumerable: true, get: function () { return log_constants_1.COLORS; } });
+Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return log_constants_1.LogLevel; } });
+const log_formatter_1 = require("./log-formatter");
+let currentLogLevel = log_constants_1.LogLevel.info;
 /**
  * Set log level
  */
 function setLogLevel(level) {
     if (typeof level === 'string') {
-        currentLogLevel = LogLevel[level] ?? LogLevel.info;
+        currentLogLevel = log_constants_1.LogLevel[level] ?? log_constants_1.LogLevel.info;
     }
     else {
         currentLogLevel = level;
     }
 }
 /**
- * Format message with timestamp
+ * Get current log level
  */
-function formatMessage(level, message, emoji = '') {
-    const timestamp = new Date().toISOString();
-    const prefix = emoji ? `${emoji} ` : '';
-    const lines = String(message).split('\n');
-    return lines.map(line => `[${timestamp}] [${level.toUpperCase()}] ${prefix}${line}`).join('\n');
+function getLogLevel() {
+    return currentLogLevel;
 }
 /**
- * Log with color
+ * Internal log function that uses formatMessageForConsole
  */
-function logWithColor(color, level, message, emoji = '') {
-    if (LogLevel[level] > currentLogLevel) {
+function logInternal(type, message, options = {}) {
+    const level = log_constants_1.LogLevel[type] ?? log_constants_1.LogLevel.info;
+    if (level > currentLogLevel) {
         return;
     }
-    const formatted = formatMessage(level, message, emoji);
-    console.log(`${color}${formatted}${exports.COLORS.reset}`);
+    const formatted = (0, log_formatter_1.formatMessageForConsole)({
+        type: type,
+        role: 'system',
+        content: message,
+        timestamp: Date.now(),
+    }, {
+        includeTimestamp: !options.noTimestamp,
+        context: options.context,
+        compact: !options.box
+    });
+    console.log(formatted);
 }
+// ============================================================================
+// Primary Logging Functions
+// ============================================================================
 /**
  * Error log
  */
-function error(message, emoji = '❌') {
-    logWithColor(exports.COLORS.red, 'error', message, emoji);
+function error(message, options = {}) {
+    const opts = typeof options === 'string' ? { emoji: options } : options;
+    logInternal('error', message, opts);
 }
 /**
  * Warning log
  */
-function warn(message, emoji = '⚠️') {
-    logWithColor(exports.COLORS.yellow, 'warn', message, emoji);
+function warn(message, options = {}) {
+    const opts = typeof options === 'string' ? { emoji: options } : options;
+    logInternal('warn', message, opts);
 }
 /**
  * Info log
  */
-function info(message, emoji = 'ℹ️') {
-    logWithColor(exports.COLORS.cyan, 'info', message, emoji);
+function info(message, options = {}) {
+    const opts = typeof options === 'string' ? { emoji: options } : options;
+    logInternal('info', message, opts);
 }
 /**
  * Success log
  */
-function success(message, emoji = '✅') {
-    logWithColor(exports.COLORS.green, 'info', message, emoji);
+function success(message, options = {}) {
+    const opts = typeof options === 'string' ? { emoji: options } : options;
+    logInternal('success', message, opts);
 }
 /**
  * Debug log
  */
-function debug(message, emoji = '🔍') {
-    logWithColor(exports.COLORS.gray, 'debug', message, emoji);
+function debug(message, options = {}) {
+    const opts = typeof options === 'string' ? { emoji: options } : options;
+    logInternal('debug', message, opts);
 }
 /**
  * Progress log
  */
-function progress(message, emoji = '🔄') {
-    logWithColor(exports.COLORS.blue, 'info', message, emoji);
+function progress(message, options = {}) {
+    const opts = typeof options === 'string' ? { emoji: options } : options;
+    logInternal('progress', message, opts);
+}
+/**
+ * Create a context-bound logger
+ */
+function withContext(context) {
+    return {
+        error: (message, options) => error(message, { ...options, context }),
+        warn: (message, options) => warn(message, { ...options, context }),
+        info: (message, options) => info(message, { ...options, context }),
+        success: (message, options) => success(message, { ...options, context }),
+        debug: (message, options) => debug(message, { ...options, context }),
+        progress: (message, options) => progress(message, { ...options, context }),
+    };
 }
 /**
  * Section header
  */
 function section(message) {
     console.log('');
-    console.log(`${exports.COLORS.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${exports.COLORS.reset}`);
-    console.log(`${exports.COLORS.cyan}  ${message}${exports.COLORS.reset}`);
-    console.log(`${exports.COLORS.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${exports.COLORS.reset}`);
+    console.log(`${log_constants_1.COLORS.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${log_constants_1.COLORS.reset}`);
+    console.log(`${log_constants_1.COLORS.cyan}  ${message}${log_constants_1.COLORS.reset}`);
+    console.log(`${log_constants_1.COLORS.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${log_constants_1.COLORS.reset}`);
     console.log('');
 }
 /**
- * Simple log without formatting
+ * Raw output (direct to stdout)
  */
-function log(message) {
-    console.log(message);
+function raw(message) {
+    process.stdout.write(message);
 }
 /**
- * Log JSON data (pretty print in debug mode)
+ * Simple log without formatting
  */
-function json(data) {
-    if (currentLogLevel >= LogLevel.debug) {
-        console.log(JSON.stringify(data, null, 2));
-    }
+function log(message) {
+    console.log(message);
 }
 /**
  * Create spinner (simple implementation)
@@ -131,12 +149,13 @@ function createSpinner(message) {
     const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
     let i = 0;
     let interval = null;
+    let currentMessage = message;
     const spinner = {
         start() {
-            process.stdout.write(`${message} ${frames[0]}`);
+            process.stdout.write(`${currentMessage} ${frames[0]}`);
             interval = setInterval(() => {
                 i = (i + 1) % frames.length;
-                process.stdout.write(`\r${message} ${frames[i]}`);
+                process.stdout.write(`\r${currentMessage} ${frames[i]}`);
             }, 80);
         },
         stop(finalMessage = null) {
@@ -150,10 +169,13 @@ function createSpinner(message) {
             }
         },
         succeed(message) {
-            this.stop(`${exports.COLORS.green}✓${exports.COLORS.reset} ${message}`);
+            this.stop(`${log_constants_1.COLORS.green}✓${log_constants_1.COLORS.reset} ${message}`);
         },
         fail(message) {
-            this.stop(`${exports.COLORS.red}✗${exports.COLORS.reset} ${message}`);
+            this.stop(`${log_constants_1.COLORS.red}✗${log_constants_1.COLORS.reset} ${message}`);
+        },
+        update(message) {
+            currentMessage = message;
         },
     };
     return spinner;

package/dist/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAYH,kCAMC;AAKD,kCAEC;AAoDD,sBAGC;AAKD,oBAGC;AAKD,oBAGC;AAKD,0BAGC;AAKD,sBAGC;AAKD,4BAGC;AAKD,kCASC;AAKD,0BAMC;AAKD,kBAEC;AAKD,kBAEC;AAiBD,sCAwCC;AAtND,mDAAmD;AAG1C,uFAHA,sBAAM,OAGA;AAAE,yFAHA,wBAAQ,OAGA;AAFzB,mDAA0D;AAI1D,IAAI,eAAe,GAAW,wBAAQ,CAAC,IAAI,CAAC;AAE5C;;GAEG;AACH,SAAgB,WAAW,CAAC,KAAsB;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,eAAe,GAAI,wBAAgB,CAAC,KAAK,CAAC,IAAI,wBAAQ,CAAC,IAAI,CAAC;IAC9D,CAAC;SAAM,CAAC;QACN,eAAe,GAAG,KAAK,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW;IACzB,OAAO,eAAe,CAAC;AACzB,CAAC;AAkBD;;GAEG;AACH,SAAS,WAAW,CAClB,IAAY,EACZ,OAAe,EACf,UAAsB,EAAE;IAExB,MAAM,KAAK,GAAI,wBAAgB,CAAC,IAAI,CAAC,IAAI,wBAAQ,CAAC,IAAI,CAAC;IACvD,IAAI,KAAK,GAAG,eAAe,EAAE,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,IAAA,uCAAuB,EAAC;QACxC,IAAI,EAAE,IAAW;QACjB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,OAAO;QAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,EAAE;QACD,gBAAgB,EAAE,CAAC,OAAO,CAAC,WAAW;QACtC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG;KACtB,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACzB,CAAC;AAED,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E;;GAEG;AACH,SAAgB,KAAK,CAAC,OAAe,EAAE,UAA+B,EAAE;IACtE,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IACxE,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,SAAgB,IAAI,CAAC,OAAe,EAAE,UAA+B,EAAE;IACrE,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IACxE,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,SAAgB,IAAI,CAAC,OAAe,EAAE,UAA+B,EAAE;IACrE,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IACxE,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,SAAgB,OAAO,CAAC,OAAe,EAAE,UAA+B,EAAE;IACxE,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IACxE,WAAW,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,SAAgB,KAAK,CAAC,OAAe,EAAE,UAA+B,EAAE;IACtE,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IACxE,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,SAAgB,QAAQ,CAAC,OAAe,EAAE,UAA+B,EAAE;IACzE,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IACxE,WAAW,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,OAAe;IACzC,OAAO;QACL,KAAK,EAAE,CAAC,OAAe,EAAE,OAAqC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC;QAC1G,IAAI,EAAE,CAAC,OAAe,EAAE,OAAqC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC;QACxG,IAAI,EAAE,CAAC,OAAe,EAAE,OAAqC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC;QACxG,OAAO,EAAE,CAAC,OAAe,EAAE,OAAqC,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC;QAC9G,KAAK,EAAE,CAAC,OAAe,EAAE,OAAqC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC;QAC1G,QAAQ,EAAE,CAAC,OAAe,EAAE,OAAqC,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC;KACjH,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,GAAG,sBAAM,CAAC,IAAI,2DAA2D,sBAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACrG,OAAO,CAAC,GAAG,CAAC,GAAG,sBAAM,CAAC,IAAI,KAAK,OAAO,GAAG,sBAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,GAAG,sBAAM,CAAC,IAAI,2DAA2D,sBAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACrG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAgB,GAAG,CAAC,OAAe;IACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,SAAgB,GAAG,CAAC,OAAe;IACjC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACvB,CAAC;AAcD;;GAEG;AACH,SAAgB,aAAa,CAAC,OAAe;IAC3C,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAClE,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,QAAQ,GAA0B,IAAI,CAAC;IAC3C,IAAI,cAAc,GAAG,OAAO,CAAC;IAE7B,MAAM,OAAO,GAAY;QACvB,KAAK;YACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,cAAc,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACvD,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;gBAC1B,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;gBAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,cAAc,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC3D,CAAC,EAAE,EAAE,CAAC,CAAC;QACT,CAAC;QAED,IAAI,CAAC,eAA8B,IAAI;YACrC,IAAI,QAAQ,EAAE,CAAC;gBACb,aAAa,CAAC,QAAQ,CAAC,CAAC;gBACxB,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa;YAC/C,IAAI,YAAY,EAAE,CAAC;gBACjB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,OAAO,CAAC,OAAe;YACrB,IAAI,CAAC,IAAI,CAAC,GAAG,sBAAM,CAAC,KAAK,IAAI,sBAAM,CAAC,KAAK,IAAI,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,CAAC,OAAe;YAClB,IAAI,CAAC,IAAI,CAAC,GAAG,sBAAM,CAAC,GAAG,IAAI,sBAAM,CAAC,KAAK,IAAI,OAAO,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,CAAC,OAAe;YACpB,cAAc,GAAG,OAAO,CAAC;QAC3B,CAAC;KACF,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/utils/path.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Ensures that a path is safe and stays within a base directory.
+ * Prevents path traversal attacks.
+ */
+export declare function isSafePath(baseDir: string, ...parts: string[]): boolean;
+/**
+ * Safely joins path parts and ensures the result is within the base directory.
+ * Throws an error if path traversal is detected.
+ *
+ * @param baseDir The base directory that the resulting path must be within
+ * @param parts Path parts to join
+ * @returns The joined path
+ * @throws Error if the resulting path is outside the base directory
+ */
+export declare function safeJoin(baseDir: string, ...parts: string[]): string;
+/**
+ * Normalizes a path and checks if it's absolute or relative to project root.
+ */
+export declare function normalizePath(p: string, projectRoot: string): string;

package/dist/utils/path.js

@@ -0,0 +1,77 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSafePath = isSafePath;
+exports.safeJoin = safeJoin;
+exports.normalizePath = normalizePath;
+const path = __importStar(require("path"));
+/**
+ * Ensures that a path is safe and stays within a base directory.
+ * Prevents path traversal attacks.
+ */
+function isSafePath(baseDir, ...parts) {
+    const joined = path.join(baseDir, ...parts); // nosemgrep
+    const resolvedBase = path.resolve(baseDir); // nosemgrep
+    const resolvedJoined = path.resolve(joined); // nosemgrep
+    return resolvedJoined.startsWith(resolvedBase);
+}
+/**
+ * Safely joins path parts and ensures the result is within the base directory.
+ * Throws an error if path traversal is detected.
+ *
+ * @param baseDir The base directory that the resulting path must be within
+ * @param parts Path parts to join
+ * @returns The joined path
+ * @throws Error if the resulting path is outside the base directory
+ */
+function safeJoin(baseDir, ...parts) {
+    const joined = path.join(baseDir, ...parts); // nosemgrep
+    const resolvedBase = path.resolve(baseDir); // nosemgrep
+    const resolvedJoined = path.resolve(joined); // nosemgrep
+    if (!resolvedJoined.startsWith(resolvedBase)) {
+        throw new Error(`Potential path traversal detected: ${joined} is outside of ${baseDir}`);
+    }
+    return joined;
+}
+/**
+ * Normalizes a path and checks if it's absolute or relative to project root.
+ */
+function normalizePath(p, projectRoot) {
+    if (path.isAbsolute(p)) {
+        return path.normalize(p);
+    }
+    return path.join(projectRoot, p); // nosemgrep
+}
+//# sourceMappingURL=path.js.map

package/dist/utils/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,gCAMC;AAWD,4BAUC;AAKD,sCAKC;AA3CD,2CAA6B;AAE7B;;;GAGG;AACH,SAAgB,UAAU,CAAC,OAAe,EAAE,GAAG,KAAe;IAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,YAAY;IACzD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY;IACxD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY;IAEzD,OAAO,cAAc,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,QAAQ,CAAC,OAAe,EAAE,GAAG,KAAe;IAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,YAAY;IACzD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY;IACxD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY;IAEzD,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,kBAAkB,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,CAAS,EAAE,WAAmB;IAC1D,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY;AAChD,CAAC"}

package/dist/utils/process-manager.d.ts

@@ -0,0 +1,21 @@
+export declare class ProcessManager {
+    /**
+     * Check if a process is running by its PID
+     */
+    static isProcessRunning(pid: number): boolean;
+    /**
+     * Kill a process by its PID
+     * @param pid Process ID
+     * @param signal Signal to send (default: SIGTERM)
+     */
+    static killProcess(pid: number, signal?: string): boolean;
+    /**
+     * Kill a process and all its child processes
+     * Cross-platform implementation
+     */
+    static killProcessTree(pid: number): boolean;
+    /**
+     * Find cursorflow related processes using pgrep (Linux/macOS only)
+     */
+    static findCursorFlowProcesses(): number[];
+}

package/dist/utils/process-manager.js

@@ -0,0 +1,138 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcessManager = void 0;
+const child_process_1 = require("child_process");
+const os = __importStar(require("os"));
+class ProcessManager {
+    /**
+     * Check if a process is running by its PID
+     */
+    static isProcessRunning(pid) {
+        try {
+            // Signal 0 checks for process existence without killing it
+            process.kill(pid, 0);
+            return true;
+        }
+        catch (e) {
+            return false;
+        }
+    }
+    /**
+     * Kill a process by its PID
+     * @param pid Process ID
+     * @param signal Signal to send (default: SIGTERM)
+     */
+    static killProcess(pid, signal = 'SIGTERM') {
+        try {
+            if (os.platform() === 'win32') {
+                // Windows doesn't support signals in the same way, use taskkill
+                const result = (0, child_process_1.spawnSync)('taskkill', ['/F', '/PID', String(pid)]);
+                return result.status === 0;
+            }
+            else {
+                process.kill(pid, signal);
+                return true;
+            }
+        }
+        catch (e) {
+            return false;
+        }
+    }
+    /**
+     * Kill a process and all its child processes
+     * Cross-platform implementation
+     */
+    static killProcessTree(pid) {
+        try {
+            if (os.platform() === 'win32') {
+                // Windows: /T flag kills child processes too
+                const result = (0, child_process_1.spawnSync)('taskkill', ['/F', '/T', '/PID', String(pid)]);
+                return result.status === 0;
+            }
+            else {
+                // Linux/macOS: Find and kill children recursively or use pkill
+                // A simple approach is to use pgrep to find children
+                const result = (0, child_process_1.spawnSync)('pgrep', ['-P', String(pid)], { encoding: 'utf8' });
+                if (result.status === 0 && result.stdout) {
+                    const children = result.stdout.split('\n').map(s => parseInt(s.trim())).filter(n => !isNaN(n));
+                    for (const child of children) {
+                        this.killProcessTree(child);
+                    }
+                }
+                // Kill the process itself
+                return this.killProcess(pid);
+            }
+        }
+        catch (e) {
+            // Fallback to simple kill
+            return this.killProcess(pid);
+        }
+    }
+    /**
+     * Find cursorflow related processes using pgrep (Linux/macOS only)
+     */
+    static findCursorFlowProcesses() {
+        if (os.platform() === 'win32') {
+            // Basic Windows implementation using tasklist if needed, 
+            // but for now focusing on core requirements
+            return [];
+        }
+        try {
+            // Find processes with 'cursorflow' in their command line, 
+            // avoiding unrelated matches by looking for specific execution patterns
+            const result = (0, child_process_1.spawnSync)('pgrep', ['-f', 'cursorflow.*(index|runner|orchestrator)'], { encoding: 'utf8' });
+            if (result.status !== 0) {
+                // Fallback to simpler pattern
+                const fallback = (0, child_process_1.spawnSync)('pgrep', ['-f', 'cursorflow'], { encoding: 'utf8' });
+                if (fallback.status !== 0)
+                    return [];
+                return fallback.stdout
+                    .split('\n')
+                    .map(s => parseInt(s.trim()))
+                    .filter(n => !isNaN(n) && n !== process.pid);
+            }
+            return result.stdout
+                .split('\n')
+                .map(s => parseInt(s.trim()))
+                .filter(n => !isNaN(n) && n !== process.pid);
+        }
+        catch (e) {
+            return [];
+        }
+    }
+}
+exports.ProcessManager = ProcessManager;
+//# sourceMappingURL=process-manager.js.map

package/dist/utils/process-manager.js.map

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

package/dist/utils/retry.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Enhanced retry logic with exponential backoff and circuit breaker
+ */
+export interface RetryConfig {
+    /** Maximum number of retries */
+    maxRetries: number;
+    /** Base delay in milliseconds */
+    baseDelayMs: number;
+    /** Maximum delay in milliseconds */
+    maxDelayMs: number;
+    /** Backoff multiplier */
+    backoffFactor: number;
+    /** Add random jitter to delays */
+    jitter: boolean;
+    /** Timeout for each attempt in milliseconds */
+    attemptTimeoutMs?: number;
+}
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+export interface CircuitBreakerConfig {
+    /** Number of consecutive failures before opening circuit */
+    failureThreshold: number;
+    /** Time in milliseconds before attempting to close circuit */
+    resetTimeoutMs: number;
+    /** Number of successful calls needed to close circuit */
+    successThreshold: number;
+}
+export declare const DEFAULT_CIRCUIT_BREAKER_CONFIG: CircuitBreakerConfig;
+export declare enum CircuitState {
+    CLOSED = "CLOSED",// Normal operation
+    OPEN = "OPEN",// Blocking calls
+    HALF_OPEN = "HALF_OPEN"
+}
+/**
+ * Circuit breaker implementation for managing service availability
+ */
+export declare class CircuitBreaker {
+    private state;
+    private failureCount;
+    private successCount;
+    private lastFailureTime;
+    private readonly config;
+    private readonly name;
+    constructor(name: string, config?: Partial<CircuitBreakerConfig>);
+    /**
+     * Check if circuit allows a call
+     */
+    canCall(): boolean;
+    /**
+     * Record a successful call
+     */
+    recordSuccess(): void;
+    /**
+     * Record a failed call
+     */
+    recordFailure(): void;
+    /**
+     * Get current circuit state
+     */
+    getState(): CircuitState;
+    /**
+     * Get time until circuit might close (for OPEN state)
+     */
+    getTimeUntilRetry(): number;
+    /**
+     * Force reset the circuit breaker
+     */
+    reset(): void;
+    /**
+     * Get circuit breaker status for monitoring
+     */
+    getStatus(): {
+        state: CircuitState;
+        failureCount: number;
+        timeUntilRetry: number;
+    };
+}
+/**
+ * Get or create a circuit breaker by name
+ */
+export declare function getCircuitBreaker(name: string, config?: Partial<CircuitBreakerConfig>): CircuitBreaker;
+/**
+ * Calculate delay with exponential backoff and optional jitter
+ */
+export declare function calculateDelay(attempt: number, config: RetryConfig): number;
+/**
+ * Sleep for specified milliseconds
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Wrap a promise with timeout
+ */
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, message?: string): Promise<T>;
+export interface RetryResult<T> {
+    success: boolean;
+    result?: T;
+    error?: Error;
+    attempts: number;
+    totalTimeMs: number;
+}
+/**
+ * Execute a function with enhanced retry logic
+ */
+export declare function withEnhancedRetry<T>(fn: () => Promise<T>, options?: {
+    config?: Partial<RetryConfig>;
+    circuitBreaker?: CircuitBreaker | string;
+    shouldRetry?: (error: Error, attempt: number) => boolean;
+    onRetry?: (error: Error, attempt: number, delayMs: number) => void;
+    label?: string;
+}): Promise<RetryResult<T>>;
+/**
+ * Check if an error is transient and worth retrying
+ */
+export declare function isTransientError(error: Error): boolean;
+/**
+ * Check if an error is permanent and should not be retried
+ */
+export declare function isPermanentError(error: Error): boolean;
+/**
+ * Default retry predicate
+ */
+export declare function defaultShouldRetry(error: Error, attempt: number): boolean;