opkg 0.9.0 → 0.9.2

package/packages/core/dist/core/flows/platform-converter.js

@@ -0,0 +1,366 @@
+/**
+ * Platform Converter Module
+ *
+ * High-level orchestration for converting packages between formats:
+ * - Platform-specific → Universal → Platform-specific
+ * - Direct installation when source = target platform
+ */
+import { join, relative } from 'path';
+import { promises as fs } from 'fs';
+import { detectPackageFormat, isPlatformSpecific, needsConversion } from '../install/format-detector.js';
+import { getPlatformDefinition, getGlobalImportFlows } from '../platforms.js';
+import { createFlowExecutor } from './flow-executor.js';
+import { logger } from '../../utils/logger.js';
+import { ensureDir, writeTextFile, readTextFile } from '../../utils/fs.js';
+import { tmpdir } from 'os';
+import { mkdtemp, rm } from 'fs/promises';
+import { minimatch } from 'minimatch';
+import { createContextFromPackage, updateContextAfterConversion, withTargetPlatform } from '../conversion-context/index.js';
+/**
+ * Platform Converter
+ *
+ * Orchestrates multi-stage conversions between package formats
+ */
+export class PlatformConverter {
+    constructor(workspaceRoot) {
+        this.workspaceRoot = workspaceRoot;
+    }
+    /**
+     * Convert a package to target platform format with conversion context
+     *
+     * @param pkg - Package to convert
+     * @param context - Conversion context (optional, will be created if not provided)
+     * @param targetPlatform - Target platform
+     * @param options - Conversion options
+     * @returns Conversion result with updated context
+     */
+    async convert(pkg, context, targetPlatform, options) {
+        logger.info('Starting platform conversion', {
+            package: pkg.metadata.name,
+            targetPlatform,
+            hasContext: !!context
+        });
+        // Create or use provided context
+        const conversionContext = context || createContextFromPackage(pkg);
+        // Set target platform
+        const contextWithTarget = withTargetPlatform(conversionContext, targetPlatform);
+        // Use provided format if available, otherwise detect from files
+        const sourceFormat = pkg._format || detectPackageFormat(pkg.files);
+        logger.debug('Source format', {
+            type: sourceFormat.type,
+            platform: sourceFormat.platform,
+            confidence: sourceFormat.confidence,
+            source: pkg._format ? 'provided' : 'detected',
+            contextOriginal: conversionContext.originalFormat.platform
+        });
+        // Build conversion pipeline
+        const pipeline = this.buildPipeline(sourceFormat, targetPlatform);
+        if (!pipeline.needsConversion) {
+            logger.info('No conversion needed - formats match');
+            return {
+                success: true,
+                convertedPackage: pkg,
+                updatedContext: contextWithTarget,
+                stages: []
+            };
+        }
+        // Execute pipeline with context
+        return await this.executePipeline(pkg, contextWithTarget, pipeline, options);
+    }
+    /**
+     * Build conversion pipeline based on source and target formats
+     */
+    buildPipeline(sourceFormat, targetPlatform) {
+        const stages = [];
+        const needsConv = needsConversion(sourceFormat, targetPlatform);
+        logger.info('Checking if conversion needed', {
+            sourceType: sourceFormat.type,
+            sourcePlatform: sourceFormat.platform,
+            targetPlatform,
+            needsConversion: needsConv
+        });
+        if (!needsConv) {
+            return {
+                source: sourceFormat,
+                target: targetPlatform,
+                stages: [],
+                needsConversion: false
+            };
+        }
+        // Platform-specific → Universal
+        if (isPlatformSpecific(sourceFormat) && sourceFormat.platform) {
+            const sourcePlatform = sourceFormat.platform;
+            // Get source platform import flows (these transform workspace → package)
+            const platformDef = getPlatformDefinition(sourcePlatform, this.workspaceRoot);
+            const platformImportFlows = platformDef.import || [];
+            const globalImportFlows = getGlobalImportFlows(this.workspaceRoot) || [];
+            const allImportFlows = [...globalImportFlows, ...platformImportFlows];
+            logger.info(`Building conversion stage with ${allImportFlows.length} import flows`, {
+                sourcePlatform,
+                flowCount: allImportFlows.length
+            });
+            // IMPORTANT:
+            // These "import" flows are defined to read platform-specific paths (e.g. ".claude-plugin/plugin.json")
+            // from the source package and write universal outputs (e.g. "openpackage.yml").
+            //
+            // We should NOT strip the platform prefix here. Doing so turns ".claude-plugin/plugin.json" into
+            // "plugin.json", which will not exist in a real Claude plugin repository and makes the
+            // platform-to-universal stage a no-op (causing infinite re-detection/re-conversion loops).
+            const adjustedFlows = allImportFlows;
+            stages.push({
+                name: 'platform-to-universal',
+                description: `Convert from ${sourcePlatform} format to universal format`,
+                flows: adjustedFlows,
+                inverted: false // Not inverted - using import flows directly
+            });
+        }
+        // Universal → Target Platform
+        // Note: This stage will be handled by the normal flow-based installer
+        // We only need to convert TO universal here; the installer handles universal → platform
+        return {
+            source: sourceFormat,
+            target: targetPlatform,
+            stages,
+            needsConversion: true
+        };
+    }
+    /**
+     * Execute conversion pipeline with context
+     */
+    async executePipeline(pkg, context, pipeline, options) {
+        const result = {
+            success: true,
+            stages: []
+        };
+        let currentPackage = pkg;
+        let currentContext = context;
+        const dryRun = options?.dryRun ?? false;
+        // Create temporary directory for intermediate files
+        let tempDir = null;
+        try {
+            tempDir = await mkdtemp(join(tmpdir(), 'opkg-convert-'));
+            for (const stage of pipeline.stages) {
+                logger.info(`Executing conversion stage: ${stage.name}`);
+                const stageResult = await this.executeStage(currentPackage, currentContext, stage, tempDir, dryRun, pipeline.target);
+                result.stages.push({
+                    stage: stage.name,
+                    filesProcessed: stageResult.filesProcessed,
+                    success: stageResult.success,
+                    error: stageResult.error
+                });
+                if (!stageResult.success) {
+                    result.success = false;
+                    result.updatedContext = currentContext;
+                    return result;
+                }
+                // Update package with converted files
+                if (stageResult.convertedFiles) {
+                    currentPackage = {
+                        ...currentPackage,
+                        files: stageResult.convertedFiles,
+                        // Update format to universal (source platform tracked in context)
+                        _format: {
+                            type: 'universal',
+                            platform: undefined,
+                            confidence: 1.0,
+                            analysis: {
+                                universalFiles: stageResult.convertedFiles.length,
+                                platformSpecificFiles: 0,
+                                detectedPlatforms: new Map(),
+                                totalFiles: stageResult.convertedFiles.length,
+                                samplePaths: {
+                                    universal: stageResult.convertedFiles.slice(0, 3).map(f => f.path),
+                                    platformSpecific: []
+                                }
+                            }
+                        }
+                    };
+                    // Update context after conversion
+                    currentContext = updateContextAfterConversion(currentContext, { type: 'universal', platform: undefined }, pipeline.target);
+                }
+            }
+            result.convertedPackage = currentPackage;
+            result.updatedContext = currentContext;
+            return result;
+        }
+        catch (error) {
+            logger.error('Conversion pipeline failed', { error });
+            result.success = false;
+            result.updatedContext = currentContext;
+            result.stages.push({
+                stage: 'pipeline',
+                filesProcessed: 0,
+                success: false,
+                error: error.message
+            });
+            return result;
+        }
+        finally {
+            // Cleanup temp directory
+            if (tempDir) {
+                try {
+                    await rm(tempDir, { recursive: true, force: true });
+                }
+                catch (error) {
+                    logger.warn('Failed to cleanup temp directory', { tempDir, error });
+                }
+            }
+        }
+    }
+    /**
+     * Discover files matching a glob pattern
+     */
+    async discoverMatchingFiles(pattern, baseDir) {
+        // Handle switch expressions
+        if (typeof pattern === 'object' && '$switch' in pattern) {
+            throw new Error('Cannot discover files from SwitchExpression - expression must be resolved first');
+        }
+        const patterns = Array.isArray(pattern) ? pattern : [pattern];
+        const matches = [];
+        // Walk all files in baseDir
+        async function* walkFiles(dir) {
+            const entries = await fs.readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    yield* walkFiles(fullPath);
+                }
+                else if (entry.isFile()) {
+                    yield fullPath;
+                }
+            }
+        }
+        // Check each file against the patterns
+        for await (const filePath of walkFiles(baseDir)) {
+            const relativePath = relative(baseDir, filePath);
+            // Check if file matches any pattern (with priority - first match wins for arrays)
+            for (const p of patterns) {
+                // IMPORTANT: conversion must match dotfiles like ".claude-plugin/plugin.json".
+                // If dotfiles don't match, platform-to-universal stages can become no-ops and loop forever.
+                if (minimatch(relativePath, p, { dot: true })) {
+                    matches.push(filePath);
+                    break; // Only match once per file
+                }
+            }
+        }
+        return matches;
+    }
+    /**
+     * Execute a single conversion stage with context
+     */
+    async executeStage(pkg, context, stage, tempDir, dryRun, targetPlatform) {
+        try {
+            const executor = createFlowExecutor();
+            const convertedFiles = [];
+            let filesProcessed = 0;
+            const matchedSources = new Set();
+            // Create isolated input/output roots for this stage
+            const stageRoot = join(tempDir, stage.name);
+            const packageRoot = join(stageRoot, 'in');
+            const outputRoot = join(stageRoot, 'out');
+            await ensureDir(packageRoot);
+            await ensureDir(outputRoot);
+            // Write package files to temp directory
+            for (const file of pkg.files) {
+                const filePath = join(packageRoot, file.path);
+                await ensureDir(join(filePath, '..'));
+                await writeTextFile(filePath, file.content);
+            }
+            // Build flow context with proper platform variables for conditional evaluation
+            // During conversion, we set:
+            // - $$platform = target platform (for conditionals like "$eq": ["$$platform", "claude"])
+            // - $$source = original source format (for conditionals like "$eq": ["$$source", "claude-plugin"])
+            const flowContext = {
+                workspaceRoot: outputRoot, // Write outputs away from inputs
+                packageRoot,
+                platform: targetPlatform, // Use target platform for conditional evaluation
+                packageName: pkg.metadata.name,
+                direction: 'install', // Always use 'install' direction for conversion
+                variables: {
+                    name: pkg.metadata.name,
+                    version: pkg.metadata.version || '0.0.0',
+                    platform: targetPlatform, // For conditional: "$eq": ["$$platform", "claude"]
+                    source: context.originalFormat.platform || 'openpackage', // Use context for $$source
+                    sourcePlatform: context.originalFormat.platform || 'openpackage', // Use context for sourcePlatform
+                    targetPlatform: targetPlatform
+                },
+                dryRun
+            };
+            // Execute flows for each matching file
+            for (const flow of stage.flows) {
+                // Discover files that match the flow's 'from' pattern
+                const matchingFiles = await this.discoverMatchingFiles(flow.from, packageRoot);
+                logger.info(`Flow pattern matching`, {
+                    pattern: flow.from,
+                    matchCount: matchingFiles.length,
+                    matches: matchingFiles.map(f => relative(packageRoot, f))
+                });
+                if (matchingFiles.length === 0) {
+                    logger.debug('No files match flow pattern', {
+                        pattern: flow.from,
+                        packageRoot
+                    });
+                    continue;
+                }
+                // Execute flow for each matching file
+                for (const sourceFile of matchingFiles) {
+                    const sourceRelative = relative(packageRoot, sourceFile);
+                    matchedSources.add(sourceRelative);
+                    // Create concrete flow with specific file path
+                    const concreteFlow = {
+                        ...flow,
+                        from: sourceRelative
+                    };
+                    const flowResult = await executor.executeFlow(concreteFlow, flowContext);
+                    if (!flowResult.success) {
+                        return {
+                            success: false,
+                            filesProcessed,
+                            error: `Flow execution failed for ${sourceRelative}: ${flowResult.error?.message}`
+                        };
+                    }
+                    filesProcessed++;
+                    // Collect transformed files
+                    if (typeof flowResult.target === 'string') {
+                        const targetPath = relative(outputRoot, flowResult.target);
+                        // Read transformed file content
+                        try {
+                            const content = await readTextFile(flowResult.target);
+                            convertedFiles.push({
+                                path: targetPath,
+                                content,
+                                encoding: 'utf8'
+                            });
+                        }
+                        catch (error) {
+                            logger.warn('Failed to read converted file', {
+                                target: flowResult.target,
+                                error
+                            });
+                        }
+                    }
+                }
+            }
+            return {
+                success: true,
+                filesProcessed,
+                convertedFiles: convertedFiles.length > 0 ? convertedFiles : undefined
+            };
+        }
+        catch (error) {
+            logger.error('Stage execution failed', { stage: stage.name, error });
+            return {
+                success: false,
+                filesProcessed: 0,
+                error: error.message
+            };
+        }
+    }
+}
+/**
+ * Create a platform converter instance
+ */
+export function createPlatformConverter(workspaceRoot) {
+    return new PlatformConverter(workspaceRoot);
+}
+//# sourceMappingURL=platform-converter.js.map

package/packages/core/dist/core/flows/platform-converter.js.map

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

package/packages/core/dist/core/flows/platform-suffix-handler.d.ts

@@ -0,0 +1,97 @@
+/**
+ * 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 type { Platform } from '../platforms.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 declare function extractPlatformSuffixFromFilename(filename: string): string | 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 declare function stripPlatformSuffixFromFilename(filename: string): string;
+/**
+ * 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 declare function buildOverrideMap(sources: string[]): Map<string, Set<Platform>>;
+/**
+ * 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 declare function shouldSkipUniversalFile(sourceRel: string, targetPlatform: Platform, sources: string[], overrideMap?: Map<string, Set<Platform>>): boolean;
+/**
+ * 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 declare function isPlatformSpecificFileForTarget(sourceRel: string, targetPlatform: Platform): boolean;
+/**
+ * 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 declare function getPlatformVariants(baseFile: string, sources: string[]): Array<{
+    platform: Platform;
+    path: string;
+}>;
+/**
+ * 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 declare function normalizeSourceForMapping(sourceRel: string, flowPatterns: string | string[], packageRoot: string): string;
+//# sourceMappingURL=platform-suffix-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform-suffix-handler.d.ts","sourceRoot":"","sources":["../../../src/core/flows/platform-suffix-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAIhD;;;;;;;;;;GAUG;AACH,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAajF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAexE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAsB9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,QAAQ,EACxB,OAAO,EAAE,MAAM,EAAE,EACjB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,GACvC,OAAO,CA8BT;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,QAAQ,GACvB,OAAO,CAST;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EAAE,GAChB,KAAK,CAAC;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAmB7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,EAC/B,WAAW,EAAE,MAAM,GAClB,MAAM,CA8BR"}