opkg 0.9.0 → 0.9.2

package/packages/core/dist/core/flows/flow-source-discovery.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Flow Source Discovery
+ *
+ * Discovers source files that match flow patterns.
+ * Handles glob patterns, {name} placeholders, and priority-based pattern matching.
+ */
+import type { Flow, FlowContext, SwitchExpression } from '../../types/flows.js';
+/**
+ * Discovery result for a single flow
+ */
+export interface FlowSourceDiscovery {
+    flow: Flow;
+    sources: string[];
+}
+/**
+ * Discovery options
+ */
+export interface DiscoveryOptions {
+    /**
+     * Enable caching of pattern matches (default: false)
+     */
+    enableCache?: boolean;
+    /**
+     * Prefer dot-prefixed files for root-level patterns (default: true)
+     * When true, checks .mcp.json before mcp.jsonc
+     */
+    preferDotPrefixed?: boolean;
+    /**
+     * Include platform-specific file variants (default: true)
+     */
+    includePlatformVariants?: boolean;
+}
+/**
+ * Discover source files that match flow patterns
+ *
+ * @param flows - Flows to discover sources for
+ * @param packageRoot - Package root directory
+ * @param context - Flow execution context
+ * @param options - Discovery options
+ * @returns Map of flow to discovered source paths
+ */
+export declare function discoverFlowSources(flows: Flow[], packageRoot: string, context: FlowContext, options?: DiscoveryOptions): Promise<Map<Flow, string[]>>;
+/**
+ * Resolve pattern placeholders like {name}
+ *
+ * Note: {name} is reserved for pattern matching and is NOT replaced
+ * unless explicitly provided in the context variables via capturedName
+ *
+ * @param pattern - Pattern with placeholders
+ * @param context - Flow context with variables
+ * @param capturedName - Captured {name} value (optional)
+ * @returns Resolved pattern
+ */
+export declare function resolvePattern(pattern: any, context: FlowContext, capturedName?: string): string;
+/**
+ * Extract the captured {name} value from a source path that matched a pattern
+ *
+ * @param sourcePath - Source path that matched
+ * @param pattern - Pattern with {name} placeholder
+ * @returns Captured name value, or undefined if no match
+ *
+ * @example
+ * extractCapturedName('rules/typescript.md', 'rules/{name}.md') // => 'typescript'
+ */
+export declare function extractCapturedName(sourcePath: string, pattern: string): string | undefined;
+/**
+ * Get the first pattern from a flow's from field
+ *
+ * @param from - Flow from field (string, array, or switch expression)
+ * @returns First pattern
+ */
+export declare function getFirstFromPattern(from: string | string[] | SwitchExpression): string;
+/**
+ * Match files against a pattern
+ *
+ * Supports:
+ * - Simple exact paths
+ * - {name} placeholders
+ * - * wildcards
+ * - ** recursive globs
+ * - Platform-specific variant discovery
+ *
+ * @param pattern - Pattern to match
+ * @param baseDir - Base directory to search in
+ * @returns Array of matched file paths (relative to baseDir)
+ */
+export declare function matchPattern(pattern: string, baseDir: string): Promise<string[]>;
+/**
+ * Batch discover sources for multiple flows
+ * Returns flat array of all discoveries
+ *
+ * @param flows - Flows to discover sources for
+ * @param packageRoot - Package root directory
+ * @param context - Flow execution context
+ * @param options - Discovery options
+ * @returns Array of flow source discoveries
+ */
+export declare function batchDiscoverFlowSources(flows: Flow[], packageRoot: string, context: FlowContext, options?: DiscoveryOptions): Promise<FlowSourceDiscovery[]>;
+/**
+ * Count total discovered sources across all flows
+ *
+ * @param flowSources - Map of flows to sources
+ * @returns Total number of unique source files
+ */
+export declare function countDiscoveredSources(flowSources: Map<Flow, string[]>): number;
+//# sourceMappingURL=flow-source-discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flow-source-discovery.d.ts","sourceRoot":"","sources":["../../../src/core/flows/flow-source-discovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAmBhF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,IAAI,EAAE,EACb,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,WAAW,EACpB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CA4D9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,WAAW,EACpB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CA6BR;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAe3F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,gBAAgB,GAAG,MAAM,CAStF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA8DtF;AAgFD;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,IAAI,EAAE,EACb,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,WAAW,EACpB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAShC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAU/E"}

package/packages/core/dist/core/flows/flow-source-discovery.js

@@ -0,0 +1,311 @@
+/**
+ * Flow Source Discovery
+ *
+ * Discovers source files that match flow patterns.
+ * Handles glob patterns, {name} placeholders, and priority-based pattern matching.
+ */
+import { promises as fs } from 'fs';
+import { join, dirname, basename, relative } from 'path';
+import { minimatch } from 'minimatch';
+import { exists } from '../../utils/fs.js';
+import { getAllPlatforms } from '../platforms.js';
+import { logger } from '../../utils/logger.js';
+function isFlowPatternValue(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'pattern' in value &&
+        typeof value.pattern === 'string');
+}
+function unwrapPatternValue(value) {
+    return isFlowPatternValue(value) ? value.pattern : value;
+}
+/**
+ * Discover source files that match flow patterns
+ *
+ * @param flows - Flows to discover sources for
+ * @param packageRoot - Package root directory
+ * @param context - Flow execution context
+ * @param options - Discovery options
+ * @returns Map of flow to discovered source paths
+ */
+export async function discoverFlowSources(flows, packageRoot, context, options = {}) {
+    const flowSources = new Map();
+    const { preferDotPrefixed = true, includePlatformVariants = true } = options;
+    for (const flow of flows) {
+        // Handle array patterns: check all patterns, not just the first
+        const patterns = Array.isArray(flow.from) ? flow.from : [flow.from];
+        const allSourcePaths = new Set();
+        // Track dot-prefixed files found to avoid duplicates
+        const dotPrefixedPathsFound = new Set();
+        const dotPrefixedBaseNames = new Set();
+        // First pass: check for dot-prefixed variants (if enabled)
+        if (preferDotPrefixed) {
+            for (const pattern of patterns) {
+                const sourcePattern = resolvePattern(pattern, context);
+                // Check for dot-prefixed variants for root-level files only
+                if (!sourcePattern.includes('/') && !sourcePattern.startsWith('.')) {
+                    const dotPrefixedPattern = `.${sourcePattern}`;
+                    const dotPrefixedPaths = await matchPattern(dotPrefixedPattern, packageRoot);
+                    for (const path of dotPrefixedPaths) {
+                        dotPrefixedPathsFound.add(path);
+                        // Extract base name for similarity matching
+                        const baseName = path.replace(/^\./, '').split('.')[0];
+                        dotPrefixedBaseNames.add(baseName);
+                        allSourcePaths.add(path);
+                    }
+                }
+            }
+        }
+        // Second pass: check non-dot patterns
+        for (const pattern of patterns) {
+            const sourcePattern = resolvePattern(pattern, context);
+            // Skip non-dot pattern if dot-prefixed variant with same base was found
+            if (!sourcePattern.includes('/') && !sourcePattern.startsWith('.')) {
+                const patternBaseName = sourcePattern.split('.')[0];
+                if (dotPrefixedBaseNames.has(patternBaseName)) {
+                    continue;
+                }
+            }
+            const sourcePaths = await matchPattern(sourcePattern, packageRoot);
+            for (const path of sourcePaths) {
+                allSourcePaths.add(path);
+            }
+        }
+        flowSources.set(flow, Array.from(allSourcePaths));
+    }
+    return flowSources;
+}
+/**
+ * Resolve pattern placeholders like {name}
+ *
+ * Note: {name} is reserved for pattern matching and is NOT replaced
+ * unless explicitly provided in the context variables via capturedName
+ *
+ * @param pattern - Pattern with placeholders
+ * @param context - Flow context with variables
+ * @param capturedName - Captured {name} value (optional)
+ * @returns Resolved pattern
+ */
+export function resolvePattern(pattern, context, capturedName) {
+    pattern = unwrapPatternValue(pattern);
+    // Handle switch expressions
+    if (typeof pattern === 'object' && '$switch' in pattern) {
+        throw new Error('Cannot resolve SwitchExpression in resolvePattern - expression must be resolved first');
+    }
+    if (typeof pattern !== 'string') {
+        throw new Error(`Invalid flow pattern type: expected string, got ${typeof pattern}`);
+    }
+    return pattern.replace(/{(\w+)}/g, (match, key) => {
+        // If capturedName is provided and this is {name}, use the captured value
+        if (key === 'name' && capturedName !== undefined) {
+            return capturedName;
+        }
+        // Otherwise, reserve {name} for pattern matching - don't substitute it
+        if (key === 'name') {
+            return match;
+        }
+        if (key in context.variables) {
+            return String(context.variables[key]);
+        }
+        return match;
+    });
+}
+/**
+ * Extract the captured {name} value from a source path that matched a pattern
+ *
+ * @param sourcePath - Source path that matched
+ * @param pattern - Pattern with {name} placeholder
+ * @returns Captured name value, or undefined if no match
+ *
+ * @example
+ * extractCapturedName('rules/typescript.md', 'rules/{name}.md') // => 'typescript'
+ */
+export function extractCapturedName(sourcePath, pattern) {
+    // Convert pattern to regex with capture group for {name}
+    const regexPattern = pattern
+        .replace(/\{name\}/g, '([^/]+)')
+        .replace(/\*/g, '.*')
+        .replace(/\./g, '\\.');
+    const regex = new RegExp('^' + regexPattern + '$');
+    const match = sourcePath.match(regex);
+    if (match && match[1]) {
+        return match[1];
+    }
+    return undefined;
+}
+/**
+ * Get the first pattern from a flow's from field
+ *
+ * @param from - Flow from field (string, array, or switch expression)
+ * @returns First pattern
+ */
+export function getFirstFromPattern(from) {
+    const value = unwrapPatternValue(Array.isArray(from) ? from[0] : from);
+    if (typeof value === 'object' && value !== null && '$switch' in value) {
+        throw new Error('Cannot get first pattern from SwitchExpression - expression must be resolved first');
+    }
+    if (typeof value !== 'string') {
+        throw new Error(`Invalid flow.from pattern type: expected string, got ${typeof value}`);
+    }
+    return value;
+}
+/**
+ * Match files against a pattern
+ *
+ * Supports:
+ * - Simple exact paths
+ * - {name} placeholders
+ * - * wildcards
+ * - ** recursive globs
+ * - Platform-specific variant discovery
+ *
+ * @param pattern - Pattern to match
+ * @param baseDir - Base directory to search in
+ * @returns Array of matched file paths (relative to baseDir)
+ */
+export async function matchPattern(pattern, baseDir) {
+    const matches = [];
+    // Fast path: no wildcards/placeholders, check exact file and platform variants
+    if (!pattern.includes('*') && !pattern.includes('{')) {
+        const exactPath = join(baseDir, pattern);
+        // Check for exact match
+        if (await exists(exactPath)) {
+            matches.push(relative(baseDir, exactPath));
+        }
+        // Also check for platform-specific variants
+        const variants = await findPlatformVariants(exactPath, baseDir);
+        matches.push(...variants);
+        return matches;
+    }
+    // Globs: recursive walk with pattern matching
+    const parts = pattern.split('/');
+    const globPart = parts.findIndex(p => p.includes('*'));
+    // No glob segment (e.g., {name}.md): scan the parent dir and filter
+    if (globPart === -1) {
+        const dirRel = dirname(pattern);
+        const filePattern = basename(pattern);
+        const searchDir = join(baseDir, dirRel);
+        if (!(await exists(searchDir))) {
+            return [];
+        }
+        const entries = await fs.readdir(searchDir, { withFileTypes: true });
+        const regex = new RegExp('^' +
+            filePattern
+                .replace(/\{name\}/g, '([^/]+)')
+                .replace(/\./g, '\\.')
+                .replace(/\*/g, '.*') +
+            '$');
+        for (const entry of entries) {
+            if (!entry.isFile())
+                continue;
+            if (!regex.test(entry.name))
+                continue;
+            matches.push(relative(baseDir, join(searchDir, entry.name)));
+        }
+        return matches;
+    }
+    // Pattern has glob segments
+    const dirPath = join(baseDir, ...parts.slice(0, globPart));
+    const filePattern = parts.slice(globPart).join('/');
+    if (!(await exists(dirPath))) {
+        return [];
+    }
+    await findMatchingFiles(dirPath, filePattern, baseDir, matches);
+    return matches;
+}
+/**
+ * Find platform-specific variants of a file
+ *
+ * @param exactPath - Exact file path (absolute)
+ * @param baseDir - Base directory for relative path calculation
+ * @returns Array of platform-specific variant paths (relative to baseDir)
+ */
+async function findPlatformVariants(exactPath, baseDir) {
+    const matches = [];
+    const dirPath = dirname(exactPath);
+    const fileName = basename(exactPath);
+    const nameParts = fileName.split('.');
+    if (nameParts.length < 2 || !(await exists(dirPath))) {
+        return matches;
+    }
+    // Get all known platforms
+    const knownPlatforms = getAllPlatforms({ includeDisabled: true });
+    // For each platform, check if a platform-specific variant exists
+    const ext = nameParts[nameParts.length - 1];
+    const baseName = nameParts.slice(0, -1).join('.');
+    for (const platform of knownPlatforms) {
+        const platformFileName = `${baseName}.${platform}.${ext}`;
+        const platformPath = join(dirPath, platformFileName);
+        if (await exists(platformPath)) {
+            matches.push(relative(baseDir, platformPath));
+        }
+    }
+    return matches;
+}
+/**
+ * Recursively find files matching a pattern
+ *
+ * @param dir - Directory to search in
+ * @param pattern - Pattern to match (may contain globs)
+ * @param baseDir - Base directory for relative path calculation
+ * @param matches - Array to accumulate matches
+ */
+async function findMatchingFiles(dir, pattern, baseDir, matches) {
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(dir, entry.name);
+            const rel = relative(baseDir, fullPath);
+            if (entry.isDirectory()) {
+                await findMatchingFiles(fullPath, pattern, baseDir, matches);
+            }
+            else if (entry.isFile()) {
+                const matched = minimatch(rel, pattern, { dot: false });
+                if (matched) {
+                    matches.push(rel);
+                }
+            }
+        }
+    }
+    catch (error) {
+        // Ignore permission errors
+        if (error.code !== 'EACCES' &&
+            error.code !== 'EPERM') {
+            logger.debug('Error reading directory during pattern matching', { dir, error });
+        }
+    }
+}
+/**
+ * Batch discover sources for multiple flows
+ * Returns flat array of all discoveries
+ *
+ * @param flows - Flows to discover sources for
+ * @param packageRoot - Package root directory
+ * @param context - Flow execution context
+ * @param options - Discovery options
+ * @returns Array of flow source discoveries
+ */
+export async function batchDiscoverFlowSources(flows, packageRoot, context, options = {}) {
+    const discoveries = [];
+    const flowSourcesMap = await discoverFlowSources(flows, packageRoot, context, options);
+    for (const [flow, sources] of flowSourcesMap) {
+        discoveries.push({ flow, sources });
+    }
+    return discoveries;
+}
+/**
+ * Count total discovered sources across all flows
+ *
+ * @param flowSources - Map of flows to sources
+ * @returns Total number of unique source files
+ */
+export function countDiscoveredSources(flowSources) {
+    const allSources = new Set();
+    for (const sources of flowSources.values()) {
+        for (const source of sources) {
+            allSources.add(source);
+        }
+    }
+    return allSources.size;
+}
+//# sourceMappingURL=flow-source-discovery.js.map

package/packages/core/dist/core/flows/flow-source-discovery.js.map

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

package/packages/core/dist/core/flows/flow-transforms.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Flow Transforms
+ *
+ * Transform implementations for the flow execution pipeline.
+ * Organized by category: Format Converters, Merge Strategies, Content Filters,
+ * Markdown Processors, Value Transforms, Validation.
+ */
+/**
+ * Transform function interface
+ */
+export interface Transform {
+    name: string;
+    execute(input: any, options?: any): any;
+    validate?(options?: any): boolean;
+}
+/**
+ * Transform registry for managing and executing transforms
+ */
+export declare class TransformRegistry {
+    private transforms;
+    /**
+     * Register a transform
+     */
+    register(transform: Transform): void;
+    /**
+     * Get a transform by name
+     */
+    get(name: string): Transform | undefined;
+    /**
+     * Check if transform exists
+     */
+    has(name: string): boolean;
+    /**
+     * Execute a transform by name
+     */
+    execute(name: string, input: any, options?: any): any;
+    /**
+     * List all registered transform names
+     */
+    list(): string[];
+}
+/**
+ * Parse JSONC (JSON with comments) to object
+ */
+export declare const jsoncTransform: Transform;
+/**
+ * Convert between YAML and object
+ */
+export declare const yamlTransform: Transform;
+/**
+ * Convert between TOML and object
+ *
+ * Uses smol-toml for TOML v1.0.0 compliant serialization and parsing.
+ */
+export declare const tomlTransform: Transform;
+/**
+ * Convert JSON object to TOML string
+ */
+export declare const jsonToTomlTransform: Transform;
+/**
+ * Convert TOML string to JSON object
+ */
+export declare const tomlToJsonTransform: Transform;
+/**
+ * Remove comments from JSONC/YAML strings
+ */
+export declare const filterCommentsTransform: Transform;
+/**
+ * Remove empty strings, arrays, and objects
+ */
+export declare const filterEmptyTransform: Transform;
+/**
+ * Remove null and undefined values
+ */
+export declare const filterNullTransform: Transform;
+/**
+ * Split markdown by section headers
+ */
+export declare const sectionsTransform: Transform;
+/**
+ * Extract YAML frontmatter from markdown
+ */
+export declare const frontmatterTransform: Transform;
+/**
+ * Extract markdown body (without frontmatter)
+ */
+export declare const bodyTransform: Transform;
+/**
+ * Type Converters
+ */
+export declare const numberTransform: Transform;
+export declare const stringTransform: Transform;
+export declare const booleanTransform: Transform;
+export declare const jsonTransform: Transform;
+export declare const dateTransform: Transform;
+/**
+ * String Transforms
+ */
+export declare const uppercaseTransform: Transform;
+export declare const lowercaseTransform: Transform;
+export declare const trimTransform: Transform;
+export declare const titleCaseTransform: Transform;
+export declare const camelCaseTransform: Transform;
+export declare const kebabCaseTransform: Transform;
+export declare const snakeCaseTransform: Transform;
+export declare const slugifyTransform: Transform;
+/**
+ * Array Transforms
+ */
+export declare const arrayAppendTransform: Transform;
+export declare const arrayUniqueTransform: Transform;
+export declare const arrayFlattenTransform: Transform;
+/**
+ * Object Transforms
+ */
+export declare const flattenTransform: Transform;
+export declare const unflattenTransform: Transform;
+export declare const pickKeysTransform: Transform;
+export declare const omitKeysTransform: Transform;
+export declare const validateTransform: Transform;
+/**
+ * Create and populate default transform registry
+ */
+export declare function createDefaultTransformRegistry(): TransformRegistry;
+/**
+ * Global transform registry instance
+ */
+export declare const defaultTransformRegistry: TransformRegistry;
+//# sourceMappingURL=flow-transforms.d.ts.map

package/packages/core/dist/core/flows/flow-transforms.d.ts.map

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