opkg 0.9.0 → 0.9.2

package/packages/core/dist/core/flows/flow-execution-coordinator.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Flow Execution Coordinator
+ *
+ * Coordinates flow execution for discovered source files.
+ * Handles target path resolution, context building, and result aggregation.
+ */
+import type { Flow, FlowContext } from '../../types/flows.js';
+import type { FlowExecutor } from '../../types/flows.js';
+import type { Platform } from '../platforms.js';
+import type { WorkspaceIndexFileMapping } from '../../types/workspace-index.js';
+/**
+ * Execution result with enhanced metadata
+ */
+export interface ExecutionResult {
+    success: boolean;
+    filesProcessed: number;
+    filesWritten: number;
+    targetPaths: string[];
+    fileMapping: Record<string, (string | WorkspaceIndexFileMapping)[]>;
+    conflicts: Array<{
+        path: string;
+        winner: string;
+        losers: string[];
+    }>;
+    errors: Array<{
+        flow: Flow;
+        sourcePath: string;
+        error: Error;
+        message: string;
+    }>;
+}
+/**
+ * Execution context for coordinating flow execution
+ */
+export interface CoordinatorContext extends FlowContext {
+    /**
+     * Flow executor instance to use
+     */
+    executor?: FlowExecutor;
+}
+/**
+ * Execute flows for discovered source files
+ *
+ * @param flowSources - Map of flows to source files
+ * @param context - Execution context
+ * @returns Execution result with aggregated metrics
+ */
+export declare function executeFlowsForSources(flowSources: Map<Flow, string[]>, context: CoordinatorContext): Promise<ExecutionResult>;
+/**
+ * Resolve target path from glob patterns
+ * Strips platform suffixes from filenames (e.g. read-specs.claude.md -> read-specs.md)
+ *
+ * @param sourceAbsPath - Absolute source path
+ * @param fromPattern - Source pattern from flow
+ * @param toPattern - Target pattern from flow
+ * @param context - Flow context
+ * @returns Resolved absolute target path
+ */
+export declare function resolveTargetFromGlob(sourceAbsPath: string, fromPattern: string, toPattern: string, context: FlowContext): string;
+/**
+ * Build flow context with standard variables
+ *
+ * @param baseContext - Base context properties
+ * @param platformDef - Platform definition (for rootFile, rootDir)
+ * @returns Complete flow context
+ */
+export declare function buildFlowContext(baseContext: {
+    workspaceRoot: string;
+    packageRoot: string;
+    platform: Platform;
+    packageName: string;
+    packageVersion: string;
+    priority: number;
+    dryRun: boolean;
+    direction: 'install' | 'save';
+}, platformDef: {
+    rootFile?: string;
+    rootDir?: string;
+}): FlowContext;
+/**
+ * Aggregate results from multiple executions
+ *
+ * @param results - Array of execution results
+ * @returns Combined result
+ */
+export declare function aggregateExecutionResults(results: ExecutionResult[]): ExecutionResult;
+//# sourceMappingURL=flow-execution-coordinator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flow-execution-coordinator.d.ts","sourceRoot":"","sources":["../../../src/core/flows/flow-execution-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAgC,MAAM,sBAAsB,CAAC;AAC5F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAYhF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,yBAAyB,CAAC,EAAE,CAAC,CAAC;IACpE,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC,CAAC;IACH,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,IAAI,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD;;OAEG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAChC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAyE1B;AAwKD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,GACnB,MAAM,CAkCR;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC;CAC/B,EACD,WAAW,EAAE;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,WAAW,CAgBb;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,eAAe,CAgCrF"}

package/packages/core/dist/core/flows/flow-execution-coordinator.js

@@ -0,0 +1,294 @@
+/**
+ * Flow Execution Coordinator
+ *
+ * Coordinates flow execution for discovered source files.
+ * Handles target path resolution, context building, and result aggregation.
+ */
+import { join, dirname, basename, relative, extname } from 'path';
+import { createFlowExecutor } from './flow-executor.js';
+import { resolvePattern, extractCapturedName, getFirstFromPattern } from './flow-source-discovery.js';
+import { resolveRecursiveGlobTargetRelativePath } from '../glob-target-mapping.js';
+import { stripPlatformSuffixFromFilename } from './platform-suffix-handler.js';
+import { resolveSwitchExpression } from './switch-resolver.js';
+/**
+ * Execute flows for discovered source files
+ *
+ * @param flowSources - Map of flows to source files
+ * @param context - Execution context
+ * @returns Execution result with aggregated metrics
+ */
+export async function executeFlowsForSources(flowSources, context) {
+    const result = {
+        success: true,
+        filesProcessed: 0,
+        filesWritten: 0,
+        targetPaths: [],
+        fileMapping: {},
+        conflicts: [],
+        errors: []
+    };
+    const executor = context.executor || createFlowExecutor();
+    for (const [flow, sources] of flowSources) {
+        for (const sourceRel of sources) {
+            try {
+                const sourceResult = await processSourceFile(flow, sourceRel, context, executor);
+                // Aggregate results
+                if (sourceResult.processed) {
+                    result.filesProcessed++;
+                }
+                if (sourceResult.written && !context.dryRun) {
+                    result.filesWritten++;
+                }
+                if (sourceResult.targetPath) {
+                    result.targetPaths.push(sourceResult.targetPath);
+                }
+                if (sourceResult.fileMapping) {
+                    const key = sourceResult.mappingKey || sourceRel;
+                    if (!result.fileMapping[key]) {
+                        result.fileMapping[key] = [];
+                    }
+                    result.fileMapping[key].push(...sourceResult.fileMapping);
+                }
+                if (sourceResult.conflicts) {
+                    result.conflicts.push(...sourceResult.conflicts);
+                }
+                if (!sourceResult.success) {
+                    result.success = false;
+                    if (sourceResult.error) {
+                        result.errors.push({
+                            flow,
+                            sourcePath: sourceRel,
+                            error: sourceResult.error,
+                            message: sourceResult.error.message
+                        });
+                    }
+                }
+            }
+            catch (error) {
+                result.success = false;
+                result.errors.push({
+                    flow,
+                    sourcePath: sourceRel,
+                    error: error,
+                    message: `Error processing ${sourceRel}: ${error.message}`
+                });
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Check if a value is a switch expression
+ */
+function isSwitchExpression(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '$switch' in value);
+}
+/**
+ * Process a single source file through a flow
+ *
+ * @param flow - Flow to execute
+ * @param sourceRel - Source file path (relative to package root)
+ * @param context - Execution context
+ * @param executor - Flow executor instance
+ * @returns Processing result
+ */
+async function processSourceFile(flow, sourceRel, context, executor) {
+    const sourceAbs = join(context.packageRoot, sourceRel);
+    // Extract captured name from pattern
+    const firstPattern = getFirstFromPattern(flow.from);
+    const capturedName = extractCapturedName(sourceRel, firstPattern);
+    // Build source-specific context
+    const sourceContext = {
+        ...context,
+        variables: {
+            ...context.variables,
+            sourcePath: sourceRel,
+            sourceDir: dirname(sourceRel),
+            sourceFile: basename(sourceRel),
+            ...(capturedName ? { capturedName } : {})
+        }
+    };
+    // Resolve target path - handle switch expressions and FlowPattern
+    let rawToPattern;
+    if (typeof flow.to === 'string') {
+        rawToPattern = flow.to;
+    }
+    else if (isSwitchExpression(flow.to)) {
+        // Resolve switch expression to concrete target path
+        rawToPattern = resolveSwitchExpression(flow.to, sourceContext);
+    }
+    else if (typeof flow.to === 'object' && flow.to !== null && 'pattern' in flow.to) {
+        // FlowPattern { pattern: "...", schema?: "..." } - use pattern, not Object.keys
+        rawToPattern = flow.to.pattern;
+    }
+    else {
+        // Multi-target flows - use first target path key
+        rawToPattern = Object.keys(flow.to)[0] ?? '';
+    }
+    const resolvedToPattern = resolvePattern(rawToPattern, sourceContext, capturedName);
+    const targetAbs = resolveTargetFromGlob(sourceAbs, firstPattern, resolvedToPattern, sourceContext);
+    const targetRel = relative(context.workspaceRoot, targetAbs);
+    // Create concrete flow with resolved paths
+    const concreteFlow = {
+        ...flow,
+        from: sourceRel,
+        to: targetRel
+    };
+    // Execute flow
+    const flowResult = await executor.executeFlow(concreteFlow, sourceContext);
+    // Check if flow was skipped
+    const wasSkipped = flowResult.warnings?.includes('Flow skipped due to condition');
+    if (wasSkipped) {
+        return {
+            success: true,
+            processed: false,
+            written: false
+        };
+    }
+    if (!flowResult.success) {
+        return {
+            success: false,
+            processed: true,
+            written: false,
+            error: flowResult.error || new Error('Flow execution failed')
+        };
+    }
+    // Process successful result
+    const target = typeof flowResult.target === 'string'
+        ? flowResult.target
+        : flowResult.target;
+    if (typeof target !== 'string') {
+        return {
+            success: true,
+            processed: true,
+            written: false
+        };
+    }
+    const targetRelFromWorkspace = relative(context.workspaceRoot, target);
+    const normalizedTargetRel = targetRelFromWorkspace.replace(/\\/g, '/');
+    // Build file mapping
+    const isKeyTrackedMerge = (flowResult.merge === 'deep' || flowResult.merge === 'shallow') &&
+        Array.isArray(flowResult.keys);
+    const fileMapping = [];
+    if (isKeyTrackedMerge) {
+        fileMapping.push({
+            target: normalizedTargetRel,
+            merge: flowResult.merge,
+            keys: flowResult.keys
+        });
+    }
+    else {
+        fileMapping.push(normalizedTargetRel);
+    }
+    // Extract conflicts
+    const conflicts = flowResult.conflicts?.map(conflict => ({
+        path: conflict.path,
+        winner: conflict.winner,
+        losers: conflict.losers
+    })) || [];
+    return {
+        success: true,
+        processed: true,
+        written: true,
+        targetPath: target,
+        fileMapping,
+        mappingKey: sourceRel,
+        conflicts
+    };
+}
+/**
+ * Resolve target path from glob patterns
+ * Strips platform suffixes from filenames (e.g. read-specs.claude.md -> read-specs.md)
+ *
+ * @param sourceAbsPath - Absolute source path
+ * @param fromPattern - Source pattern from flow
+ * @param toPattern - Target pattern from flow
+ * @param context - Flow context
+ * @returns Resolved absolute target path
+ */
+export function resolveTargetFromGlob(sourceAbsPath, fromPattern, toPattern, context) {
+    const sourceRelFromPackage = relative(context.packageRoot, sourceAbsPath);
+    // If 'to' pattern has glob, map the structure
+    if (toPattern.includes('*')) {
+        // Handle ** recursive patterns
+        if (toPattern.includes('**')) {
+            const targetRel = resolveRecursiveGlobTargetRelativePath(sourceRelFromPackage, fromPattern, toPattern);
+            return join(context.workspaceRoot, targetRel);
+        }
+        // Single-level * patterns
+        const sourceExt = extname(sourceAbsPath);
+        const sourceBase = basename(sourceAbsPath, sourceExt);
+        const toParts = toPattern.split('*');
+        const toPrefix = toParts[0];
+        const toSuffix = toParts[1] || '';
+        const targetExt = toSuffix.startsWith('.') ? toSuffix : (sourceExt + toSuffix);
+        const targetFileName = sourceBase + targetExt;
+        // Strip platform suffix from the final target filename
+        const strippedTargetFileName = stripPlatformSuffixFromFilename(targetFileName);
+        return join(context.workspaceRoot, toPrefix + strippedTargetFileName);
+    }
+    // No glob in target - use as-is
+    return join(context.workspaceRoot, toPattern);
+}
+/**
+ * Build flow context with standard variables
+ *
+ * @param baseContext - Base context properties
+ * @param platformDef - Platform definition (for rootFile, rootDir)
+ * @returns Complete flow context
+ */
+export function buildFlowContext(baseContext, platformDef) {
+    return {
+        workspaceRoot: baseContext.workspaceRoot,
+        packageRoot: baseContext.packageRoot,
+        platform: baseContext.platform,
+        packageName: baseContext.packageName,
+        direction: baseContext.direction,
+        variables: {
+            name: baseContext.packageName,
+            version: baseContext.packageVersion,
+            priority: baseContext.priority,
+            rootFile: platformDef.rootFile,
+            rootDir: platformDef.rootDir
+        },
+        dryRun: baseContext.dryRun
+    };
+}
+/**
+ * Aggregate results from multiple executions
+ *
+ * @param results - Array of execution results
+ * @returns Combined result
+ */
+export function aggregateExecutionResults(results) {
+    const aggregated = {
+        success: true,
+        filesProcessed: 0,
+        filesWritten: 0,
+        targetPaths: [],
+        fileMapping: {},
+        conflicts: [],
+        errors: []
+    };
+    for (const result of results) {
+        aggregated.filesProcessed += result.filesProcessed;
+        aggregated.filesWritten += result.filesWritten;
+        aggregated.targetPaths.push(...result.targetPaths);
+        aggregated.conflicts.push(...result.conflicts);
+        aggregated.errors.push(...result.errors);
+        // Merge file mappings
+        for (const [source, targets] of Object.entries(result.fileMapping)) {
+            if (!aggregated.fileMapping[source]) {
+                aggregated.fileMapping[source] = [];
+            }
+            aggregated.fileMapping[source].push(...targets);
+        }
+        if (!result.success) {
+            aggregated.success = false;
+        }
+    }
+    return aggregated;
+}
+//# sourceMappingURL=flow-execution-coordinator.js.map

package/packages/core/dist/core/flows/flow-execution-coordinator.js.map

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

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

@@ -0,0 +1,190 @@
+/**
+ * Flow Executor
+ *
+ * Executes flows through a multi-stage pipeline:
+ * 1. Load source file and parse format
+ * 2. Extract JSONPath (if specified)
+ * 3. Pick/omit keys
+ * 4. Map keys (with transforms)
+ * 5. Apply pipe transforms
+ * 6. Embed in target structure
+ * 7. Merge with existing target (priority-based)
+ * 8. Write to target file
+ */
+import type { Flow, FlowContext, FlowResult, FlowExecutor, ValidationResult, ParsedContent, FileFormat } from '../../types/flows.js';
+import { TransformRegistry } from './flow-transforms.js';
+/**
+ * Default flow executor implementation
+ */
+export declare class DefaultFlowExecutor implements FlowExecutor {
+    private transformRegistry;
+    private sourceResolver;
+    constructor(transformRegistry?: TransformRegistry);
+    /**
+     * Execute a single flow (now supports glob patterns and switch expressions)
+     */
+    executeFlow(flow: Flow, context: FlowContext): Promise<FlowResult>;
+    /**
+     * Execute multiple flows
+     */
+    executeFlows(flows: Flow[], context: FlowContext): Promise<FlowResult[]>;
+    /**
+     * Execute a multi-target flow
+     */
+    executeMultiTarget(flow: Flow, context: FlowContext): Promise<FlowResult[]>;
+    /**
+     * Validate a flow configuration
+     */
+    validateFlow(flow: Flow): ValidationResult;
+    /**
+     * Check if a value is a switch expression
+     */
+    private isSwitchExpression;
+    /**
+     * Execute the transformation pipeline
+     */
+    private executePipeline;
+    /**
+     * Execute pipeline with pre-loaded content (for multi-target flows)
+     */
+    private executePipelineWithContent;
+    /**
+     * Load and parse source file
+     */
+    loadSourceFile(filePath: string, context?: FlowContext): Promise<ParsedContent>;
+    /**
+     * Write transformed content to target file
+     */
+    writeTargetFile(filePath: string, content: any, sourceFormat: FileFormat): Promise<void>;
+    /**
+     * Determine if parsing is needed for this flow
+     * Returns false for simple pass-through copies with no transformations
+     */
+    private needsParsing;
+    /**
+     * Execute a pass-through copy without parsing
+     * Used for simple file copies with no transformations
+     */
+    private executePassThroughCopy;
+    /**
+     * Parse source content based on format
+     */
+    parseSourceContent(content: string, format: FileFormat): any;
+    /**
+     * Serialize content to target format
+     */
+    serializeTargetContent(content: any, format: FileFormat): string;
+    /**
+     * Detect format from file extension or content
+     */
+    private detectFormat;
+    /**
+     * Extract data using JSONPath
+     */
+    private extractJSONPath;
+    /**
+     * Pick specified keys
+     */
+    private pickKeys;
+    /**
+     * Omit specified keys
+     */
+    private omitKeys;
+    /**
+     * Apply pipe transforms
+     */
+    private applyPipeTransforms;
+    /**
+     * Parse transform specification
+     * Examples: "trim", "number", "pick-keys(keys=[a,b,c])"
+     */
+    private parseTransformSpec;
+    /**
+     * Embed content under a key
+     */
+    private embedContent;
+    /**
+     * Merge content with priority-based conflict resolution
+     */
+    private mergeContent;
+    /**
+     * Deep merge two objects
+     */
+    private deepMerge;
+    /**
+     * Evaluate condition
+     */
+    private evaluateCondition;
+    /**
+     * Resolve a value, handling $$variable references
+     */
+    private resolveValue;
+    /**
+     * Resolve pattern with glob support and priority-based array matching
+     * Returns resolved file paths (glob patterns return multiple files)
+     */
+    private resolveSourcePattern;
+    /**
+     * Resolve target path from source path and patterns
+     * Handles single-level (*) and recursive (**) globs
+     * Strips platform suffixes from filenames (e.g. read-specs.claude.md -> read-specs.md)
+     */
+    private resolveTargetFromGlob;
+    /**
+     * Get pipeline description
+     */
+    private getPipeline;
+    /**
+     * Normalize from pattern for display in results
+     * Converts array to comma-separated string
+     */
+    private normalizeFromPattern;
+    /**
+     * Normalize to pattern for display in results
+     * Handles string, multi-target, and switch expressions
+     */
+    private normalizeToPattern;
+    /**
+     * Get the first pattern from a pattern or array of patterns
+     * Used for path resolution when multiple sources are specified
+     */
+    private getFirstPattern;
+    /**
+     * Aggregate multi-target results
+     */
+    private aggregateResults;
+    /**
+     * Parse markdown with frontmatter
+     */
+    private parseMarkdown;
+    /**
+     * Serialize markdown with frontmatter
+     */
+    private serializeMarkdown;
+    /**
+     * Strip JSON comments
+     */
+    private stripJSONComments;
+    /**
+     * Get nested value using dot notation (delegates to key mapper)
+     */
+    private getNestedValue;
+    /**
+     * Set nested value using dot notation (delegates to key mapper)
+     */
+    private setNestedValue;
+    /**
+     * Delete nested value using dot notation (delegates to key mapper)
+     */
+    private deleteNestedValue;
+    /**
+     * Apply Codex-specific TOML formatting
+     * Converts nested table sections to inline format for http_headers and env_http_headers
+     */
+    private applyCodexTomlFormatting;
+}
+/**
+ * Create a flow executor instance
+ */
+export declare function createFlowExecutor(): FlowExecutor;
+//# sourceMappingURL=flow-executor.d.ts.map

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

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