@plusplusoneplusplus/coc 1.0.1 → 1.0.3

package/node_modules/@plusplusoneplusplus/forge/dist/utils/file-utils.js

@@ -0,0 +1,419 @@
+"use strict";
+/**
+ * File Utilities
+ *
+ * Centralized file I/O utilities with consistent error handling.
+ * Cross-platform compatible (Linux/Mac/Windows).
+ *
+ * These utilities provide:
+ * - Consistent error handling across all file operations
+ * - Type-safe return values with explicit error states
+ * - YAML file reading/writing with proper parsing
+ * - Directory operations with recursive support
+ */
+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.safeExists = safeExists;
+exports.safeIsDirectory = safeIsDirectory;
+exports.safeIsFile = safeIsFile;
+exports.safeReadFile = safeReadFile;
+exports.safeWriteFile = safeWriteFile;
+exports.ensureDirectoryExists = ensureDirectoryExists;
+exports.safeReadDir = safeReadDir;
+exports.safeStats = safeStats;
+exports.readYAML = readYAML;
+exports.writeYAML = writeYAML;
+exports.safeCopyFile = safeCopyFile;
+exports.safeRename = safeRename;
+exports.safeRemove = safeRemove;
+exports.getFileErrorMessage = getFileErrorMessage;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+/**
+ * Safely checks if a file or directory exists.
+ *
+ * @param filePath - Path to check
+ * @returns True if the path exists, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (safeExists('/path/to/file.txt')) {
+ *     // File exists
+ * }
+ * ```
+ */
+function safeExists(filePath) {
+    try {
+        return fs.existsSync(filePath);
+    }
+    catch {
+        // If we can't even check existence, treat as non-existent
+        return false;
+    }
+}
+/**
+ * Safely checks if a path is a directory.
+ *
+ * @param dirPath - Path to check
+ * @returns True if the path is a directory, false otherwise
+ */
+function safeIsDirectory(dirPath) {
+    try {
+        const stats = fs.statSync(dirPath);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Safely checks if a path is a file.
+ *
+ * @param filePath - Path to check
+ * @returns True if the path is a file, false otherwise
+ */
+function safeIsFile(filePath) {
+    try {
+        const stats = fs.statSync(filePath);
+        return stats.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Safely reads a file and returns its contents.
+ *
+ * @param filePath - Path to the file to read
+ * @param options - Optional read options
+ * @returns FileOperationResult with the file contents or error information
+ *
+ * @example
+ * ```typescript
+ * const result = safeReadFile('/path/to/file.txt');
+ * if (result.success) {
+ *     console.log(result.data);
+ * } else {
+ *     console.error('Failed to read:', result.error?.message);
+ * }
+ * ```
+ */
+function safeReadFile(filePath, options = {}) {
+    const { encoding = 'utf8' } = options;
+    try {
+        const data = fs.readFileSync(filePath, encoding);
+        return { success: true, data };
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        const errorCode = extractErrorCode(err);
+        return { success: false, error: err, errorCode };
+    }
+}
+/**
+ * Safely writes content to a file.
+ *
+ * @param filePath - Path to the file to write
+ * @param content - Content to write
+ * @param options - Optional write options
+ * @returns FileOperationResult indicating success or failure
+ *
+ * @example
+ * ```typescript
+ * const result = safeWriteFile('/path/to/file.txt', 'Hello, World!');
+ * if (!result.success) {
+ *     console.error('Failed to write:', result.error?.message);
+ * }
+ * ```
+ */
+function safeWriteFile(filePath, content, options = {}) {
+    const { encoding = 'utf8', createDirs = true } = options;
+    try {
+        // Ensure parent directory exists if requested
+        if (createDirs) {
+            const dirResult = ensureDirectoryExists(path.dirname(filePath));
+            if (!dirResult.success) {
+                return dirResult;
+            }
+        }
+        fs.writeFileSync(filePath, content, encoding);
+        return { success: true };
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        const errorCode = extractErrorCode(err);
+        return { success: false, error: err, errorCode };
+    }
+}
+/**
+ * Ensures a directory exists, creating it recursively if necessary.
+ *
+ * @param dirPath - Path to the directory
+ * @returns FileOperationResult indicating success or failure
+ *
+ * @example
+ * ```typescript
+ * const result = ensureDirectoryExists('/path/to/new/directory');
+ * if (result.success) {
+ *     // Directory now exists
+ * }
+ * ```
+ */
+function ensureDirectoryExists(dirPath) {
+    try {
+        if (!fs.existsSync(dirPath)) {
+            fs.mkdirSync(dirPath, { recursive: true });
+        }
+        return { success: true };
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        const errorCode = extractErrorCode(err);
+        return { success: false, error: err, errorCode };
+    }
+}
+function safeReadDir(dirPath, withFileTypes) {
+    try {
+        if (withFileTypes) {
+            const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+            return { success: true, data: entries };
+        }
+        else {
+            const entries = fs.readdirSync(dirPath);
+            return { success: true, data: entries };
+        }
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        const errorCode = extractErrorCode(err);
+        return { success: false, error: err, errorCode };
+    }
+}
+/**
+ * Safely gets file stats.
+ *
+ * @param filePath - Path to the file
+ * @returns FileOperationResult with fs.Stats or error information
+ */
+function safeStats(filePath) {
+    try {
+        const stats = fs.statSync(filePath);
+        return { success: true, data: stats };
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        const errorCode = extractErrorCode(err);
+        return { success: false, error: err, errorCode };
+    }
+}
+/**
+ * Reads and parses a YAML file.
+ *
+ * @param filePath - Path to the YAML file
+ * @returns FileOperationResult with parsed YAML content or error information
+ *
+ * @example
+ * ```typescript
+ * interface Config {
+ *     name: string;
+ *     version: number;
+ * }
+ *
+ * const result = readYAML<Config>('/path/to/config.yaml');
+ * if (result.success && result.data) {
+ *     console.log(result.data.name);
+ * }
+ * ```
+ */
+function readYAML(filePath) {
+    const readResult = safeReadFile(filePath);
+    if (!readResult.success) {
+        return {
+            success: false,
+            error: readResult.error,
+            errorCode: readResult.errorCode
+        };
+    }
+    try {
+        const parsed = yaml.load(readResult.data);
+        return { success: true, data: parsed };
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        // Enhance error message for YAML parse errors
+        const yamlError = new Error(`YAML parse error in ${filePath}: ${err.message}`);
+        return { success: false, error: yamlError, errorCode: 'YAML_PARSE_ERROR' };
+    }
+}
+/**
+ * Writes data to a YAML file.
+ *
+ * @param filePath - Path to the YAML file
+ * @param data - Data to serialize and write
+ * @param options - Optional YAML serialization options
+ * @returns FileOperationResult indicating success or failure
+ *
+ * @example
+ * ```typescript
+ * const config = { name: 'MyApp', version: 1 };
+ * const result = writeYAML('/path/to/config.yaml', config);
+ * if (!result.success) {
+ *     console.error('Failed to write YAML:', result.error?.message);
+ * }
+ * ```
+ */
+function writeYAML(filePath, data, options = {}) {
+    const { indent = 2, lineWidth = -1, noRefs = true } = options;
+    try {
+        const yamlContent = yaml.dump(data, { indent, lineWidth, noRefs });
+        return safeWriteFile(filePath, yamlContent);
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        const yamlError = new Error(`YAML serialization error: ${err.message}`);
+        return { success: false, error: yamlError, errorCode: 'YAML_DUMP_ERROR' };
+    }
+}
+/**
+ * Safely copies a file from source to destination.
+ *
+ * @param srcPath - Source file path
+ * @param destPath - Destination file path
+ * @param createDirs - Create parent directories if they don't exist (default: true)
+ * @returns FileOperationResult indicating success or failure
+ */
+function safeCopyFile(srcPath, destPath, createDirs = true) {
+    try {
+        if (createDirs) {
+            const dirResult = ensureDirectoryExists(path.dirname(destPath));
+            if (!dirResult.success) {
+                return dirResult;
+            }
+        }
+        fs.copyFileSync(srcPath, destPath);
+        return { success: true };
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        const errorCode = extractErrorCode(err);
+        return { success: false, error: err, errorCode };
+    }
+}
+/**
+ * Safely renames/moves a file or directory.
+ *
+ * @param oldPath - Current path
+ * @param newPath - New path
+ * @returns FileOperationResult indicating success or failure
+ */
+function safeRename(oldPath, newPath) {
+    try {
+        fs.renameSync(oldPath, newPath);
+        return { success: true };
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        const errorCode = extractErrorCode(err);
+        return { success: false, error: err, errorCode };
+    }
+}
+/**
+ * Safely removes a file or directory.
+ *
+ * @param targetPath - Path to remove
+ * @param options - Options for removal
+ * @returns FileOperationResult indicating success or failure
+ */
+function safeRemove(targetPath, options = {}) {
+    const { recursive = false, force = false } = options;
+    try {
+        fs.rmSync(targetPath, { recursive, force });
+        return { success: true };
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        const errorCode = extractErrorCode(err);
+        return { success: false, error: err, errorCode };
+    }
+}
+/**
+ * Extracts error code from a Node.js error.
+ *
+ * @param error - The error to extract code from
+ * @returns The error code or 'UNKNOWN'
+ */
+function extractErrorCode(error) {
+    // Node.js file system errors have a 'code' property
+    const nodeError = error;
+    return nodeError.code || 'UNKNOWN';
+}
+/**
+ * Gets a user-friendly error message for common file operation errors.
+ *
+ * @param errorCode - The error code from a file operation
+ * @param context - Optional context about what operation was being performed
+ * @returns A user-friendly error message
+ */
+function getFileErrorMessage(errorCode, context) {
+    const prefix = context ? `${context}: ` : '';
+    switch (errorCode) {
+        case 'ENOENT':
+            return `${prefix}File or directory not found`;
+        case 'EACCES':
+        case 'EPERM':
+            return `${prefix}Permission denied`;
+        case 'EEXIST':
+            return `${prefix}File or directory already exists`;
+        case 'ENOTDIR':
+            return `${prefix}Not a directory`;
+        case 'EISDIR':
+            return `${prefix}Is a directory`;
+        case 'ENOSPC':
+            return `${prefix}No space left on device`;
+        case 'EMFILE':
+        case 'ENFILE':
+            return `${prefix}Too many open files`;
+        case 'EBUSY':
+            return `${prefix}Resource busy or locked`;
+        case 'YAML_PARSE_ERROR':
+            return `${prefix}Invalid YAML syntax`;
+        case 'YAML_DUMP_ERROR':
+            return `${prefix}Failed to serialize data to YAML`;
+        default:
+            return `${prefix}File operation failed`;
+    }
+}
+//# sourceMappingURL=file-utils.js.map

package/node_modules/@plusplusoneplusplus/forge/dist/utils/file-utils.js.map

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

package/node_modules/@plusplusoneplusplus/forge/dist/utils/filter-executor.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Filter Executor
+ *
+ * Implements rule-based, AI-based, and hybrid filtering for pipeline items.
+ * The filter phase reduces the number of items before the expensive map phase.
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+import type { AIFilterConfig, FilterConfig, FilterResult, RuleFilterConfig } from '../workflow/pipeline-compat';
+import type { AIInvoker, ProcessTracker, PromptItem } from '../ai/types';
+/**
+ * Options for filter execution
+ */
+export interface FilterExecuteOptions {
+    /** AI invoker function (required for ai/hybrid filters) */
+    aiInvoker?: AIInvoker;
+    /** Optional process tracker for AI process manager integration */
+    processTracker?: ProcessTracker;
+    /** Progress callback */
+    onProgress?: (progress: FilterProgress) => void;
+    /** Optional cancellation check function */
+    isCancelled?: () => boolean;
+}
+/**
+ * Progress information for filter execution
+ */
+export interface FilterProgress {
+    /** Current phase */
+    phase: 'rule' | 'ai';
+    /** Items processed so far */
+    processed: number;
+    /** Total items to process */
+    total: number;
+    /** Number of items included so far */
+    included: number;
+    /** Number of items excluded so far */
+    excluded: number;
+}
+/**
+ * Execute filter phase on input items
+ *
+ * @param items Input items to filter
+ * @param filterConfig Filter configuration
+ * @param options Execution options
+ * @returns Filtered items with metadata
+ */
+export declare function executeFilter(items: PromptItem[], filterConfig: FilterConfig, options: FilterExecuteOptions): Promise<FilterResult>;
+/**
+ * Execute rule-based filter (synchronous, fast)
+ */
+export declare function executeRuleFilter(items: PromptItem[], config: RuleFilterConfig, options: FilterExecuteOptions): Promise<FilterResult>;
+/**
+ * Execute AI-based filter (asynchronous, uses AI calls)
+ */
+export declare function executeAIFilter(items: PromptItem[], config: AIFilterConfig, options: FilterExecuteOptions): Promise<FilterResult>;
+/**
+ * Execute hybrid filter (rule-based pre-filter + AI confirmation)
+ */
+export declare function executeHybridFilter(items: PromptItem[], config: FilterConfig, options: FilterExecuteOptions): Promise<FilterResult>;
+//# sourceMappingURL=filter-executor.d.ts.map

package/node_modules/@plusplusoneplusplus/forge/dist/utils/filter-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-executor.d.ts","sourceRoot":"","sources":["../../src/utils/filter-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACR,cAAc,EACd,YAAY,EACZ,YAAY,EAGZ,gBAAgB,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACR,SAAS,EACT,cAAc,EACd,UAAU,EACb,MAAM,aAAa,CAAC;AAIrB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,2DAA2D;IAC3D,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,kEAAkE;IAClE,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,wBAAwB;IACxB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAChD,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,oBAAoB;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAC/B,KAAK,EAAE,UAAU,EAAE,EACnB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,oBAAoB,GAC9B,OAAO,CAAC,YAAY,CAAC,CA6BvB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACnC,KAAK,EAAE,UAAU,EAAE,EACnB,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,oBAAoB,GAC9B,OAAO,CAAC,YAAY,CAAC,CA2CvB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACjC,KAAK,EAAE,UAAU,EAAE,EACnB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,oBAAoB,GAC9B,OAAO,CAAC,YAAY,CAAC,CAmDvB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACrC,KAAK,EAAE,UAAU,EAAE,EACnB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,oBAAoB,GAC9B,OAAO,CAAC,YAAY,CAAC,CAsCvB"}