opkg 0.9.0 → 0.9.2

package/packages/core/dist/core/flows/platform-suffix-handler.js

@@ -0,0 +1,212 @@
+/**
+ * Platform Suffix Handler
+ *
+ * Handles platform-specific file suffix detection and manipulation.
+ * Supports naming conventions like:
+ * - mcp.claude.jsonc (root-level platform-specific file)
+ * - commands/test.claude.md (universal subdir with platform suffix)
+ */
+import { basename, dirname, join } from 'path';
+import { isPlatformId } from '../platforms.js';
+import { parseUniversalPath } from '../platform/platform-file.js';
+/**
+ * Extract platform suffix from filename
+ *
+ * @param filename - Filename or path to check
+ * @returns Platform ID if suffix found, null otherwise
+ *
+ * @example
+ * extractPlatformSuffixFromFilename('mcp.claude.jsonc') // => 'claude'
+ * extractPlatformSuffixFromFilename('commands/test.cursor.md') // => 'cursor'
+ * extractPlatformSuffixFromFilename('mcp.jsonc') // => null
+ */
+export function extractPlatformSuffixFromFilename(filename) {
+    const baseName = basename(filename);
+    const parts = baseName.split('.');
+    // Need at least 3 parts: name.platform.ext
+    if (parts.length >= 3) {
+        const possiblePlatform = parts[parts.length - 2];
+        if (isPlatformId(possiblePlatform)) {
+            return possiblePlatform;
+        }
+    }
+    return null;
+}
+/**
+ * Strip platform suffix from filename
+ *
+ * @param filename - Filename or path to process
+ * @returns Filename with platform suffix removed
+ *
+ * @example
+ * stripPlatformSuffixFromFilename('mcp.claude.jsonc') // => 'mcp.jsonc'
+ * stripPlatformSuffixFromFilename('commands/test.cursor.md') // => 'commands/test.md'
+ * stripPlatformSuffixFromFilename('mcp.jsonc') // => 'mcp.jsonc' (unchanged)
+ */
+export function stripPlatformSuffixFromFilename(filename) {
+    const platformSuffix = extractPlatformSuffixFromFilename(filename);
+    if (!platformSuffix) {
+        return filename;
+    }
+    const dir = dirname(filename);
+    const baseName = basename(filename);
+    const parts = baseName.split('.');
+    // Remove platform suffix (second-to-last part)
+    const strippedParts = [...parts.slice(0, -2), parts[parts.length - 1]];
+    const strippedBaseName = strippedParts.join('.');
+    return dir === '.' ? strippedBaseName : join(dir, strippedBaseName);
+}
+/**
+ * Build a map of base paths to platforms that have override files
+ *
+ * This is used to determine when universal files should be skipped because
+ * platform-specific overrides exist.
+ *
+ * @param sources - Array of source file paths
+ * @returns Map of base path to Set of platforms with overrides
+ *
+ * @example
+ * // Input: ['commands/test.md', 'commands/test.claude.md', 'mcp.jsonc', 'mcp.cursor.jsonc']
+ * // Output: Map {
+ * //   'commands/test.md' => Set(['claude']),
+ * //   'mcp.jsonc' => Set(['cursor'])
+ * // }
+ */
+export function buildOverrideMap(sources) {
+    const overridesByBasePath = new Map();
+    for (const sourceRel of sources) {
+        const parsed = parseUniversalPath(sourceRel, { allowPlatformSuffix: true });
+        const platformSuffix = parsed?.platformSuffix || extractPlatformSuffixFromFilename(sourceRel);
+        if (platformSuffix) {
+            // For universal subdir files, use the parsed baseKey
+            // For root-level files, use the stripped filename as the baseKey
+            const baseKey = parsed
+                ? `${parsed.universalSubdir}/${parsed.relPath}`
+                : stripPlatformSuffixFromFilename(sourceRel);
+            if (!overridesByBasePath.has(baseKey)) {
+                overridesByBasePath.set(baseKey, new Set());
+            }
+            overridesByBasePath.get(baseKey).add(platformSuffix);
+        }
+    }
+    return overridesByBasePath;
+}
+/**
+ * Check if a universal file should be skipped due to platform-specific override
+ *
+ * @param sourceRel - Source file path (relative)
+ * @param targetPlatform - Target platform to check
+ * @param sources - All source files (for building override map)
+ * @param overrideMap - Pre-built override map (optional, for performance)
+ * @returns True if file should be skipped
+ */
+export function shouldSkipUniversalFile(sourceRel, targetPlatform, sources, overrideMap) {
+    // Parse to check if it's a universal subdir file
+    const parsed = parseUniversalPath(sourceRel, { allowPlatformSuffix: true });
+    // If file has platform suffix, it's not universal
+    const platformSuffix = parsed?.platformSuffix || extractPlatformSuffixFromFilename(sourceRel);
+    if (platformSuffix) {
+        return false;
+    }
+    // Build override map if not provided
+    const overrides = overrideMap || buildOverrideMap(sources);
+    // Check for override
+    if (parsed) {
+        // Universal subdir file
+        const baseKey = `${parsed.universalSubdir}/${parsed.relPath}`;
+        const overridePlatforms = overrides.get(baseKey);
+        return overridePlatforms?.has(targetPlatform) ?? false;
+    }
+    else {
+        // Root-level file
+        const strippedFileName = stripPlatformSuffixFromFilename(sourceRel);
+        // Check if any file in sources is a platform-specific override for this file
+        return sources.some(s => {
+            const sSuffix = extractPlatformSuffixFromFilename(s);
+            const sStripped = stripPlatformSuffixFromFilename(s);
+            return sSuffix === targetPlatform && sStripped === strippedFileName;
+        });
+    }
+}
+/**
+ * Check if a platform-specific file is for the target platform
+ *
+ * @param sourceRel - Source file path (relative)
+ * @param targetPlatform - Target platform to check
+ * @returns True if file is for target platform
+ */
+export function isPlatformSpecificFileForTarget(sourceRel, targetPlatform) {
+    const parsed = parseUniversalPath(sourceRel, { allowPlatformSuffix: true });
+    const platformSuffix = parsed?.platformSuffix || extractPlatformSuffixFromFilename(sourceRel);
+    if (!platformSuffix) {
+        return false;
+    }
+    return platformSuffix === targetPlatform;
+}
+/**
+ * Get all platform-specific variants of a file
+ *
+ * @param baseFile - Base filename (without platform suffix)
+ * @param sources - All source files
+ * @returns Array of platform-specific variants
+ *
+ * @example
+ * getPlatformVariants('mcp.jsonc', ['mcp.jsonc', 'mcp.claude.jsonc', 'mcp.cursor.jsonc'])
+ * // => ['mcp.claude.jsonc', 'mcp.cursor.jsonc']
+ */
+export function getPlatformVariants(baseFile, sources) {
+    const variants = [];
+    const baseStripped = stripPlatformSuffixFromFilename(baseFile);
+    for (const source of sources) {
+        const platformSuffix = extractPlatformSuffixFromFilename(source);
+        if (platformSuffix) {
+            const sourceStripped = stripPlatformSuffixFromFilename(source);
+            if (sourceStripped === baseStripped) {
+                variants.push({
+                    platform: platformSuffix,
+                    path: source
+                });
+            }
+        }
+    }
+    return variants;
+}
+/**
+ * Normalize a source path for canonical key generation
+ *
+ * This handles the case where a dot-prefixed file (.mcp.json) is discovered
+ * but the flow pattern array includes other patterns. Returns the canonical
+ * form preferred for file mapping keys.
+ *
+ * @param sourceRel - Source file path (relative)
+ * @param flowPatterns - Flow patterns that could match
+ * @param packageRoot - Package root directory
+ * @returns Canonical source path
+ */
+export function normalizeSourceForMapping(sourceRel, flowPatterns, packageRoot) {
+    // If not a dot-prefixed root-level file, return as-is
+    if (!sourceRel.startsWith('.') || sourceRel.includes('/')) {
+        return sourceRel;
+    }
+    // Not an array pattern, return as-is
+    if (!Array.isArray(flowPatterns)) {
+        return sourceRel;
+    }
+    // For dot-prefixed files, prefer explicit pattern match over dot-prefix pattern
+    // This prevents duplicate keys in file mapping
+    const patterns = flowPatterns;
+    for (const pattern of patterns) {
+        // Skip dot-prefixed patterns and the current sourceRel
+        if (pattern.startsWith('.') || pattern === sourceRel) {
+            continue;
+        }
+        // Check if pattern could match this file
+        // Simple heuristic: if stripping dot from sourceRel matches pattern structure
+        const withoutDot = sourceRel.substring(1);
+        if (withoutDot === pattern) {
+            return pattern;
+        }
+    }
+    return sourceRel;
+}
+//# sourceMappingURL=platform-suffix-handler.js.map

package/packages/core/dist/core/flows/platform-suffix-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-suffix-handler.js","sourceRoot":"","sources":["../../../src/core/flows/platform-suffix-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE/C,OAAO,EAAmB,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iCAAiC,CAAC,QAAgB;IAChE,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAElC,2CAA2C;IAC3C,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,gBAAgB,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACjD,IAAI,YAAY,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACnC,OAAO,gBAAgB,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,+BAA+B,CAAC,QAAgB;IAC9D,MAAM,cAAc,GAAG,iCAAiC,CAAC,QAAQ,CAAC,CAAC;IACnE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAElC,+CAA+C;IAC/C,MAAM,aAAa,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,gBAAgB,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEjD,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAiB;IAChD,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE7D,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,MAAM,cAAc,GAAG,MAAM,EAAE,cAAc,IAAI,iCAAiC,CAAC,SAAS,CAAC,CAAC;QAE9F,IAAI,cAAc,EAAE,CAAC;YACnB,qDAAqD;YACrD,iEAAiE;YACjE,MAAM,OAAO,GAAG,MAAM;gBACpB,CAAC,CAAC,GAAG,MAAM,CAAC,eAAe,IAAI,MAAM,CAAC,OAAO,EAAE;gBAC/C,CAAC,CAAC,+BAA+B,CAAC,SAAS,CAAC,CAAC;YAE/C,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtC,mBAAmB,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YAC9C,CAAC;YACD,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,GAAG,CAAC,cAA0B,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CACrC,SAAiB,EACjB,cAAwB,EACxB,OAAiB,EACjB,WAAwC;IAExC,iDAAiD;IACjD,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5E,kDAAkD;IAClD,MAAM,cAAc,GAAG,MAAM,EAAE,cAAc,IAAI,iCAAiC,CAAC,SAAS,CAAC,CAAC;IAC9F,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,qCAAqC;IACrC,MAAM,SAAS,GAAG,WAAW,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAE3D,qBAAqB;IACrB,IAAI,MAAM,EAAE,CAAC;QACX,wBAAwB;QACxB,MAAM,OAAO,GAAG,GAAG,MAAM,CAAC,eAAe,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAC9D,MAAM,iBAAiB,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjD,OAAO,iBAAiB,EAAE,GAAG,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,kBAAkB;QAClB,MAAM,gBAAgB,GAAG,+BAA+B,CAAC,SAAS,CAAC,CAAC;QAEpE,6EAA6E;QAC7E,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;YACtB,MAAM,OAAO,GAAG,iCAAiC,CAAC,CAAC,CAAC,CAAC;YACrD,MAAM,SAAS,GAAG,+BAA+B,CAAC,CAAC,CAAC,CAAC;YACrD,OAAO,OAAO,KAAK,cAAc,IAAI,SAAS,KAAK,gBAAgB,CAAC;QACtE,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,+BAA+B,CAC7C,SAAiB,EACjB,cAAwB;IAExB,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,MAAM,cAAc,GAAG,MAAM,EAAE,cAAc,IAAI,iCAAiC,CAAC,SAAS,CAAC,CAAC;IAE9F,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,cAAc,KAAK,cAAc,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,OAAiB;IAEjB,MAAM,QAAQ,GAAgD,EAAE,CAAC;IAEjE,MAAM,YAAY,GAAG,+BAA+B,CAAC,QAAQ,CAAC,CAAC;IAE/D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,cAAc,GAAG,iCAAiC,CAAC,MAAM,CAAC,CAAC;QACjE,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,cAAc,GAAG,+BAA+B,CAAC,MAAM,CAAC,CAAC;YAC/D,IAAI,cAAc,KAAK,YAAY,EAAE,CAAC;gBACpC,QAAQ,CAAC,IAAI,CAAC;oBACZ,QAAQ,EAAE,cAA0B;oBACpC,IAAI,EAAE,MAAM;iBACb,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,yBAAyB,CACvC,SAAiB,EACjB,YAA+B,EAC/B,WAAmB;IAEnB,sDAAsD;IACtD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,qCAAqC;IACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,gFAAgF;IAChF,+CAA+C;IAC/C,MAAM,QAAQ,GAAG,YAAY,CAAC;IAE9B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,uDAAuD;QACvD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACrD,SAAS;QACX,CAAC;QAED,yCAAyC;QACzC,8EAA8E;QAC9E,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1C,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;YAC3B,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/packages/core/dist/core/flows/source-resolver.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Source Pattern Resolver
+ *
+ * Resolves source file patterns (including arrays with priority) to actual file paths.
+ * Supports glob patterns and priority-based pattern selection.
+ */
+/**
+ * Result of source pattern resolution
+ */
+export interface SourceResolutionResult {
+    /** Resolved file paths that matched */
+    paths: string[];
+    /** Warnings generated during resolution */
+    warnings: string[];
+    /** Pattern that matched (for multi-pattern scenarios) */
+    matchedPattern?: string;
+    /** Patterns that were skipped due to lower priority */
+    skippedPatterns?: string[];
+}
+/**
+ * Options for source resolution
+ */
+export interface SourceResolutionOptions {
+    /** Base directory for resolving relative patterns */
+    baseDir: string;
+    /** Whether to log warnings for skipped patterns */
+    logWarnings?: boolean;
+}
+/**
+ * Source Pattern Resolver
+ *
+ * Handles resolution of single patterns, arrays of patterns (with priority),
+ * and glob patterns to actual file paths.
+ */
+export declare class SourcePatternResolver {
+    /**
+     * Resolve source pattern(s) to file paths
+     *
+     * For single patterns: returns all matching files
+     * For array patterns: returns files from first matching pattern only (priority order)
+     *
+     * @param pattern - Single pattern or array of patterns with priority
+     * @param options - Resolution options
+     * @returns Resolution result with paths and warnings
+     */
+    resolve(pattern: string | string[], options: SourceResolutionOptions): Promise<SourceResolutionResult>;
+    /**
+     * Resolve array of patterns with priority (first match wins)
+     *
+     * Iterates through patterns in order, returning files from first matching pattern.
+     * Logs warnings if lower-priority patterns also match.
+     *
+     * @param patterns - Array of patterns in priority order
+     * @param options - Resolution options
+     * @returns Resolution result
+     */
+    private resolveWithPriority;
+    /**
+     * Resolve a single pattern to file paths
+     *
+     * Handles both glob patterns and literal file paths.
+     *
+     * @param pattern - File pattern (may contain globs)
+     * @param baseDir - Base directory for resolution
+     * @returns Array of resolved file paths
+     */
+    private resolveSinglePattern;
+    /**
+     * Check if pattern contains glob wildcards
+     *
+     * @param pattern - Pattern to check
+     * @returns True if pattern contains glob syntax
+     */
+    private isGlobPattern;
+    /**
+     * Resolve glob pattern to matching files
+     *
+     * @param pattern - Glob pattern
+     * @param baseDir - Base directory
+     * @returns Array of matching file paths
+     */
+    private resolveGlobPattern;
+    /**
+     * Recursively find files matching glob pattern
+     *
+     * Supports ** for recursive directory matching.
+     *
+     * @param dir - Current directory
+     * @param pattern - Pattern to match
+     * @param baseDir - Base directory for relative paths
+     * @param matches - Array to accumulate matches
+     */
+    private findMatchingFiles;
+}
+/**
+ * Create a source pattern resolver instance
+ */
+export declare function createSourceResolver(): SourcePatternResolver;
+//# sourceMappingURL=source-resolver.d.ts.map

package/packages/core/dist/core/flows/source-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-resolver.d.ts","sourceRoot":"","sources":["../../../src/core/flows/source-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,uCAAuC;IACvC,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAEhB,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,qBAAa,qBAAqB;IAChC;;;;;;;;;OASG;IACG,OAAO,CACX,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAC1B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC;IAclC;;;;;;;;;OASG;YACW,mBAAmB;IAuDjC;;;;;;;;OAQG;YACW,oBAAoB;IAalC;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAIrB;;;;;;OAMG;YACW,kBAAkB;IA2BhC;;;;;;;;;OASG;YACW,iBAAiB;CAiChC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,qBAAqB,CAE5D"}

package/packages/core/dist/core/flows/source-resolver.js

@@ -0,0 +1,192 @@
+/**
+ * Source Pattern Resolver
+ *
+ * Resolves source file patterns (including arrays with priority) to actual file paths.
+ * Supports glob patterns and priority-based pattern selection.
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import { minimatch } from 'minimatch';
+import * as fsUtils from '../../utils/fs.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * Source Pattern Resolver
+ *
+ * Handles resolution of single patterns, arrays of patterns (with priority),
+ * and glob patterns to actual file paths.
+ */
+export class SourcePatternResolver {
+    /**
+     * Resolve source pattern(s) to file paths
+     *
+     * For single patterns: returns all matching files
+     * For array patterns: returns files from first matching pattern only (priority order)
+     *
+     * @param pattern - Single pattern or array of patterns with priority
+     * @param options - Resolution options
+     * @returns Resolution result with paths and warnings
+     */
+    async resolve(pattern, options) {
+        // Handle array of patterns with priority
+        if (Array.isArray(pattern)) {
+            return this.resolveWithPriority(pattern, options);
+        }
+        // Single pattern
+        const paths = await this.resolveSinglePattern(pattern, options.baseDir);
+        return {
+            paths,
+            warnings: [],
+        };
+    }
+    /**
+     * Resolve array of patterns with priority (first match wins)
+     *
+     * Iterates through patterns in order, returning files from first matching pattern.
+     * Logs warnings if lower-priority patterns also match.
+     *
+     * @param patterns - Array of patterns in priority order
+     * @param options - Resolution options
+     * @returns Resolution result
+     */
+    async resolveWithPriority(patterns, options) {
+        if (patterns.length === 0) {
+            return { paths: [], warnings: ['Empty pattern array provided'] };
+        }
+        const warnings = [];
+        const skippedPatterns = [];
+        // Try each pattern in priority order
+        for (let i = 0; i < patterns.length; i++) {
+            const currentPattern = patterns[i];
+            const matches = await this.resolveSinglePattern(currentPattern, options.baseDir);
+            if (matches.length > 0) {
+                // Found matches - check if lower-priority patterns also match
+                for (let j = i + 1; j < patterns.length; j++) {
+                    const lowerPriorityPattern = patterns[j];
+                    const lowerMatches = await this.resolveSinglePattern(lowerPriorityPattern, options.baseDir);
+                    if (lowerMatches.length > 0) {
+                        const warning = `Pattern "${currentPattern}" matched (priority ${i + 1}). ` +
+                            `Ignoring lower-priority pattern "${lowerPriorityPattern}" (priority ${j + 1}) ` +
+                            `which also matched ${lowerMatches.length} file(s).`;
+                        warnings.push(warning);
+                        skippedPatterns.push(lowerPriorityPattern);
+                        if (options.logWarnings !== false) {
+                            logger.debug(warning);
+                        }
+                    }
+                }
+                return {
+                    paths: matches,
+                    warnings,
+                    matchedPattern: currentPattern,
+                    skippedPatterns: skippedPatterns.length > 0 ? skippedPatterns : undefined,
+                };
+            }
+        }
+        // No patterns matched
+        return {
+            paths: [],
+            warnings: [`No files matched any of the ${patterns.length} pattern(s): ${patterns.join(', ')}`],
+        };
+    }
+    /**
+     * Resolve a single pattern to file paths
+     *
+     * Handles both glob patterns and literal file paths.
+     *
+     * @param pattern - File pattern (may contain globs)
+     * @param baseDir - Base directory for resolution
+     * @returns Array of resolved file paths
+     */
+    async resolveSinglePattern(pattern, baseDir) {
+        // Check if pattern contains glob wildcard
+        if (this.isGlobPattern(pattern)) {
+            return this.resolveGlobPattern(pattern, baseDir);
+        }
+        // Literal file path - check if it exists
+        const resolved = path.join(baseDir, pattern);
+        const exists = await fsUtils.exists(resolved);
+        return exists ? [resolved] : [];
+    }
+    /**
+     * Check if pattern contains glob wildcards
+     *
+     * @param pattern - Pattern to check
+     * @returns True if pattern contains glob syntax
+     */
+    isGlobPattern(pattern) {
+        return pattern.includes('*') || pattern.includes('?') || pattern.includes('[');
+    }
+    /**
+     * Resolve glob pattern to matching files
+     *
+     * @param pattern - Glob pattern
+     * @param baseDir - Base directory
+     * @returns Array of matching file paths
+     */
+    async resolveGlobPattern(pattern, baseDir) {
+        const matches = [];
+        // Extract directory and file pattern
+        const parts = pattern.split('/');
+        const globPart = parts.findIndex(p => this.isGlobPattern(p));
+        if (globPart === -1) {
+            // No glob found (shouldn't happen, but handle gracefully)
+            return [path.join(baseDir, pattern)];
+        }
+        // Build directory path up to first glob
+        const dirPath = path.join(baseDir, ...parts.slice(0, globPart));
+        const filePattern = parts.slice(globPart).join('/');
+        // Check if directory exists
+        if (!await fsUtils.exists(dirPath)) {
+            return [];
+        }
+        // Recursively find matching files
+        await this.findMatchingFiles(dirPath, filePattern, baseDir, matches);
+        return matches;
+    }
+    /**
+     * Recursively find files matching glob pattern
+     *
+     * Supports ** for recursive directory matching.
+     *
+     * @param dir - Current directory
+     * @param pattern - Pattern to match
+     * @param baseDir - Base directory for relative paths
+     * @param matches - Array to accumulate matches
+     */
+    async findMatchingFiles(dir, pattern, baseDir, matches) {
+        try {
+            const entries = await fs.readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                const relativePath = path.relative(baseDir, fullPath);
+                if (entry.isDirectory()) {
+                    // Always recurse for ** patterns
+                    if (pattern.startsWith('**') || pattern.includes('/**/')) {
+                        await this.findMatchingFiles(fullPath, pattern, baseDir, matches);
+                    }
+                    else if (pattern.includes('/')) {
+                        // For patterns with subdirs, continue searching
+                        await this.findMatchingFiles(fullPath, pattern, baseDir, matches);
+                    }
+                }
+                else if (entry.isFile()) {
+                    // Test file against pattern
+                    if (minimatch(relativePath, pattern, { dot: false })) {
+                        matches.push(fullPath);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            // Ignore errors (directory not accessible, etc.)
+            logger.debug(`Error reading directory ${dir}: ${error}`);
+        }
+    }
+}
+/**
+ * Create a source pattern resolver instance
+ */
+export function createSourceResolver() {
+    return new SourcePatternResolver();
+}
+//# sourceMappingURL=source-resolver.js.map

package/packages/core/dist/core/flows/source-resolver.js.map

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

package/packages/core/dist/core/flows/switch-resolver.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Switch Expression Resolver
+ *
+ * Resolves $switch expressions in flow configurations to concrete target paths.
+ * Inspired by MongoDB's $switch aggregation operator.
+ */
+import type { SwitchExpression, FlowContext } from '../../types/flows.js';
+/**
+ * Result of resolving a switch expression
+ * Contains both the resolved pattern string and optional schema
+ */
+export interface SwitchResolutionResult {
+    /** Resolved pattern string */
+    pattern: string;
+    /** Optional schema path (if value was a FlowPattern with schema) */
+    schema?: string;
+}
+/**
+ * Resolve a switch expression to a concrete target path
+ *
+ * Evaluates cases in order and returns the value of the first matching case.
+ * If no cases match and a default is provided, returns the default.
+ * If no cases match and no default exists, throws an error.
+ *
+ * @param switchExpr - The switch expression to resolve
+ * @param context - Flow execution context with variables
+ * @returns Resolved target path string (for backward compatibility)
+ * @throws Error if no cases match and no default is provided
+ */
+export declare function resolveSwitchExpression(switchExpr: SwitchExpression, context: FlowContext): string;
+/**
+ * Resolve a switch expression to a full result with pattern and optional schema
+ *
+ * @param switchExpr - The switch expression to resolve
+ * @param context - Flow execution context with variables
+ * @returns Full resolution result with pattern and optional schema
+ * @throws Error if no cases match and no default is provided
+ */
+export declare function resolveSwitchExpressionFull(switchExpr: SwitchExpression, context: FlowContext): SwitchResolutionResult;
+/**
+ * Validate a switch expression
+ * Returns validation result with error messages
+ */
+export declare function validateSwitchExpression(switchExpr: SwitchExpression): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=switch-resolver.d.ts.map

package/packages/core/dist/core/flows/switch-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch-resolver.d.ts","sourceRoot":"","sources":["../../../src/core/flows/switch-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAA+B,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGvG;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAsBD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,WAAW,GACnB,MAAM,CAER;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,WAAW,GACnB,sBAAsB,CA2BxB;AA2ED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,gBAAgB,GAC3B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAqDtC"}