opkg 0.9.0 → 0.9.2

package/packages/core/dist/core/install/format-detector.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Format Detector Module
+ *
+ * Detects package format (universal vs platform-specific) by analyzing file structure.
+ * Used to determine conversion strategy during installation.
+ */
+import type { Platform } from '../platforms.js';
+import type { PackageFile } from '../../types/index.js';
+import type { PackageConversionContext } from '../../types/conversion-context.js';
+import type { EnhancedPackageFormat } from './detection-types.js';
+/**
+ * Package format classification
+ */
+export interface PackageFormat {
+    /**
+     * Format type: universal (commands/, agents/) or platform-specific (.claude/, .cursor/)
+     */
+    type: 'universal' | 'platform-specific';
+    /**
+     * If platform-specific, which platform?
+     */
+    platform?: Platform;
+    /**
+     * Confidence score (0-1) based on file analysis
+     */
+    confidence: number;
+    /**
+     * Detailed file analysis for debugging
+     */
+    analysis: FormatAnalysis;
+}
+export interface FormatAnalysis {
+    universalFiles: number;
+    platformSpecificFiles: number;
+    detectedPlatforms: Map<Platform, number>;
+    totalFiles: number;
+    samplePaths: {
+        universal: string[];
+        platformSpecific: string[];
+    };
+}
+/**
+ * Detect package format from file list
+ */
+export declare function detectPackageFormat(files: PackageFile[]): PackageFormat;
+/**
+ * Check if a package format indicates platform-specific content
+ */
+export declare function isPlatformSpecific(format: PackageFormat): boolean;
+/**
+ * Check if conversion is needed for target platform
+ */
+export declare function needsConversion(format: PackageFormat, targetPlatform: Platform): boolean;
+/**
+ * Detect package format and create conversion context
+ *
+ * Convenience function that combines format detection with context creation.
+ * Use this at package loading time to get both format and context together.
+ */
+export declare function detectPackageFormatWithContext(files: PackageFile[]): {
+    format: PackageFormat;
+    context: PackageConversionContext;
+};
+/**
+ * Enhanced Package Format Detection (Two-Tier Strategy)
+ *
+ * Implements comprehensive format detection with two tiers:
+ *
+ * Tier 1 (Fast Path): Package-Level Markers
+ * - Checks for explicit format markers from platforms.jsonc (e.g., .claude-plugin/plugin.json)
+ * - Returns immediately if clear marker found
+ * - Fastest path for well-structured packages
+ *
+ * Tier 2 (Detailed Path): Per-File Detection
+ * - Falls back when no clear markers exist
+ * - Analyzes each file's frontmatter against platform schemas
+ * - Groups files by detected format
+ * - Determines overall package format from distribution
+ *
+ * @param files - List of package files (with optional content/frontmatter)
+ * @param targetDir - Optional target directory for local platform config
+ * @returns Enhanced package format with comprehensive analysis
+ */
+export declare function detectEnhancedPackageFormat(files: PackageFile[], targetDir?: string): Promise<EnhancedPackageFormat>;
+//# sourceMappingURL=format-detector.d.ts.map

package/packages/core/dist/core/install/format-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-detector.d.ts","sourceRoot":"","sources":["../../../src/core/install/format-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAKlE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,EAAE,WAAW,GAAG,mBAAmB,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE;QACX,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;CACH;AAiCD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,aAAa,CAyDvE;AAqHD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,cAAc,EAAE,QAAQ,GACvB,OAAO,CAYT;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG;IACpE,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,wBAAwB,CAAC;CACnC,CAKA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,WAAW,EAAE,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,qBAAqB,CAAC,CAqGhC"}

package/packages/core/dist/core/install/format-detector.js

@@ -0,0 +1,327 @@
+/**
+ * Format Detector Module
+ *
+ * Detects package format (universal vs platform-specific) by analyzing file structure.
+ * Used to determine conversion strategy during installation.
+ */
+import { isPlatformId } from '../platforms.js';
+import { createContextFromFormat } from '../conversion-context/index.js';
+/**
+ * Known universal subdirectories in OpenPackage format
+ */
+const UNIVERSAL_SUBDIRS = [
+    'commands',
+    'agents',
+    'rules',
+    'skills',
+    'hooks'
+];
+/**
+ * Known platform-specific root directories
+ */
+const PLATFORM_ROOT_DIRS = {
+    '.claude': 'claude',
+    '.claude-plugin': 'claude-plugin',
+    '.cursor': 'cursor',
+    '.opencode': 'opencode',
+    '.codex': 'codex',
+    '.factory': 'factory',
+    '.kilocode': 'kilo',
+    '.kiro': 'kiro',
+    '.qwen': 'qwen',
+    '.roo': 'roo',
+    '.warp': 'warp',
+    '.windsurf': 'windsurf',
+    '.augment': 'augment',
+    '.agent': 'antigravity'
+};
+/**
+ * Detect package format from file list
+ */
+export function detectPackageFormat(files) {
+    // Check for claude-plugin first (highest priority)
+    const hasClaudePluginManifest = files.some(f => f.path === '.claude-plugin/plugin.json');
+    if (hasClaudePluginManifest) {
+        return {
+            type: 'platform-specific',
+            platform: 'claude-plugin',
+            confidence: 1.0,
+            analysis: {
+                universalFiles: 0,
+                platformSpecificFiles: files.length,
+                detectedPlatforms: new Map([['claude-plugin', files.length]]),
+                totalFiles: files.length,
+                samplePaths: {
+                    universal: [],
+                    platformSpecific: ['.claude-plugin/plugin.json']
+                }
+            }
+        };
+    }
+    const analysis = {
+        universalFiles: 0,
+        platformSpecificFiles: 0,
+        detectedPlatforms: new Map(),
+        totalFiles: files.length,
+        samplePaths: {
+            universal: [],
+            platformSpecific: []
+        }
+    };
+    // Analyze each file
+    for (const file of files) {
+        const classification = classifyFile(file.path);
+        if (classification.type === 'universal') {
+            analysis.universalFiles++;
+            if (analysis.samplePaths.universal.length < 5) {
+                analysis.samplePaths.universal.push(file.path);
+            }
+        }
+        else if (classification.type === 'platform-specific' && classification.platform) {
+            analysis.platformSpecificFiles++;
+            const count = analysis.detectedPlatforms.get(classification.platform) || 0;
+            analysis.detectedPlatforms.set(classification.platform, count + 1);
+            if (analysis.samplePaths.platformSpecific.length < 5) {
+                analysis.samplePaths.platformSpecific.push(file.path);
+            }
+        }
+    }
+    // Determine format based on analysis
+    return determineFormat(analysis);
+}
+/**
+ * Classify a single file path
+ */
+function classifyFile(path) {
+    const parts = path.split('/');
+    const firstPart = parts[0];
+    // Check for platform-specific root directory
+    if (firstPart in PLATFORM_ROOT_DIRS) {
+        return {
+            type: 'platform-specific',
+            platform: PLATFORM_ROOT_DIRS[firstPart]
+        };
+    }
+    // Check for platform suffix in filename BEFORE universal subdir
+    // (e.g. agents/git/foo.opencode.md is platform-specific, not universal)
+    const platformSuffix = extractPlatformSuffixFromPath(path);
+    if (platformSuffix) {
+        return {
+            type: 'platform-specific',
+            platform: platformSuffix
+        };
+    }
+    // Check for universal subdirectory
+    if (UNIVERSAL_SUBDIRS.includes(firstPart)) {
+        return { type: 'universal' };
+    }
+    // Root-level files or other directories
+    return { type: 'other' };
+}
+/**
+ * Extract platform suffix from filename (e.g., "mcp.claude.jsonc" -> "claude")
+ */
+function extractPlatformSuffixFromPath(path) {
+    const parts = path.split('/');
+    const filename = parts[parts.length - 1];
+    const nameParts = filename.split('.');
+    // Need at least 3 parts: name.platform.ext
+    if (nameParts.length >= 3) {
+        const possiblePlatform = nameParts[nameParts.length - 2];
+        if (isPlatformId(possiblePlatform)) {
+            return possiblePlatform;
+        }
+    }
+    return null;
+}
+/**
+ * Determine overall format from analysis
+ */
+function determineFormat(analysis) {
+    const { universalFiles, platformSpecificFiles, detectedPlatforms, totalFiles } = analysis;
+    // No files analyzed
+    if (totalFiles === 0) {
+        return {
+            type: 'universal',
+            confidence: 0,
+            analysis
+        };
+    }
+    // Calculate ratios
+    const universalRatio = universalFiles / totalFiles;
+    const platformRatio = platformSpecificFiles / totalFiles;
+    // Strong universal signal: >70% universal files
+    if (universalRatio > 0.7) {
+        return {
+            type: 'universal',
+            confidence: universalRatio,
+            analysis
+        };
+    }
+    // Strong platform-specific signal: >70% platform files
+    if (platformRatio > 0.7) {
+        // Determine dominant platform
+        let dominantPlatform;
+        let maxCount = 0;
+        for (const [platform, count] of detectedPlatforms) {
+            if (count > maxCount) {
+                maxCount = count;
+                dominantPlatform = platform;
+            }
+        }
+        if (dominantPlatform) {
+            return {
+                type: 'platform-specific',
+                platform: dominantPlatform,
+                confidence: platformRatio,
+                analysis
+            };
+        }
+    }
+    // Mixed or unclear: default to universal with low confidence
+    return {
+        type: 'universal',
+        confidence: Math.max(universalRatio, 0.3),
+        analysis
+    };
+}
+/**
+ * Check if a package format indicates platform-specific content
+ */
+export function isPlatformSpecific(format) {
+    return format.type === 'platform-specific' && format.platform !== undefined;
+}
+/**
+ * Check if conversion is needed for target platform
+ */
+export function needsConversion(format, targetPlatform) {
+    // Universal format always uses standard flows (no conversion)
+    if (format.type === 'universal') {
+        return false;
+    }
+    // Platform-specific: needs conversion if target differs from source
+    if (format.type === 'platform-specific' && format.platform) {
+        return format.platform !== targetPlatform;
+    }
+    return false;
+}
+/**
+ * Detect package format and create conversion context
+ *
+ * Convenience function that combines format detection with context creation.
+ * Use this at package loading time to get both format and context together.
+ */
+export function detectPackageFormatWithContext(files) {
+    const format = detectPackageFormat(files);
+    const context = createContextFromFormat(format);
+    return { format, context };
+}
+/**
+ * Enhanced Package Format Detection (Two-Tier Strategy)
+ *
+ * Implements comprehensive format detection with two tiers:
+ *
+ * Tier 1 (Fast Path): Package-Level Markers
+ * - Checks for explicit format markers from platforms.jsonc (e.g., .claude-plugin/plugin.json)
+ * - Returns immediately if clear marker found
+ * - Fastest path for well-structured packages
+ *
+ * Tier 2 (Detailed Path): Per-File Detection
+ * - Falls back when no clear markers exist
+ * - Analyzes each file's frontmatter against platform schemas
+ * - Groups files by detected format
+ * - Determines overall package format from distribution
+ *
+ * @param files - List of package files (with optional content/frontmatter)
+ * @param targetDir - Optional target directory for local platform config
+ * @returns Enhanced package format with comprehensive analysis
+ */
+export async function detectEnhancedPackageFormat(files, targetDir) {
+    // Import detection modules dynamically to avoid circular deps
+    const { detectPlatformMarkers, getPrimaryPlatformFromMarkers, isPurePlatformSpecific } = await import('./package-marker-detector.js');
+    const { detectFileFormats } = await import('./file-format-detector.js');
+    const { analyzeFormatDistribution, calculatePackageConfidence, determinePackageFormat: determineFromDistribution, groupFilesByPlatform } = await import('./format-distribution-analyzer.js');
+    // Tier 1: Check for package-level markers (fast path)
+    const markers = detectPlatformMarkers(files, targetDir);
+    // Pure platform-specific package with single marker
+    if (isPurePlatformSpecific(markers)) {
+        const primaryPlatform = getPrimaryPlatformFromMarkers(markers);
+        return {
+            packageFormat: primaryPlatform,
+            detectionMethod: 'package-marker',
+            confidence: 1.0,
+            // For marker fast-path, we still need format groups so conversion can run.
+            // Group everything under the detected platform; individual files can be no-ops
+            // if no import flow matches (e.g. plugin manifests).
+            formatGroups: new Map([[primaryPlatform, files.map(f => f.path)]]),
+            markers: {
+                matchedPatterns: markers.matches.map(m => ({
+                    platformId: m.platformId,
+                    pattern: m.matchedPattern
+                })),
+                hasOpenPackageYml: markers.hasOpenPackageYml,
+                hasPackageYml: markers.hasPackageYml
+            },
+            analysis: {
+                totalFiles: files.length,
+                analyzedFiles: 0, // Fast path - didn't analyze files
+                skippedFiles: files.length,
+                formatDistribution: new Map([[primaryPlatform, files.length]])
+            }
+        };
+    }
+    // Pure universal package: openpackage.yml at root, no platform markers
+    // Skip per-file detection; all files are already in universal format
+    if ((markers.hasOpenPackageYml || markers.hasPackageYml) && markers.matches.length === 0) {
+        return {
+            packageFormat: 'universal',
+            detectionMethod: 'package-marker',
+            confidence: 1.0,
+            formatGroups: new Map([['universal', files.map(f => f.path)]]),
+            markers: {
+                matchedPatterns: [],
+                hasOpenPackageYml: markers.hasOpenPackageYml,
+                hasPackageYml: markers.hasPackageYml
+            },
+            analysis: {
+                totalFiles: files.length,
+                analyzedFiles: 0,
+                skippedFiles: files.length,
+                formatDistribution: new Map([['universal', files.length]])
+            }
+        };
+    }
+    // Tier 2: Per-file detection (detailed path)
+    // Detect format for each file
+    const fileFormats = detectFileFormats(files, targetDir);
+    // Analyze distribution
+    const distribution = analyzeFormatDistribution(fileFormats);
+    const confidence = calculatePackageConfidence(distribution, fileFormats);
+    const packageFormat = determineFromDistribution(distribution);
+    const formatGroups = groupFilesByPlatform(fileFormats);
+    // Count analyzed vs skipped files
+    const analyzedFiles = fileFormats.size;
+    const skippedFiles = files.length - analyzedFiles;
+    return {
+        packageFormat,
+        detectionMethod: 'per-file',
+        confidence,
+        fileFormats,
+        formatGroups,
+        markers: markers.matches.length > 0 ? {
+            matchedPatterns: markers.matches.map(m => ({
+                platformId: m.platformId,
+                pattern: m.matchedPattern
+            })),
+            hasOpenPackageYml: markers.hasOpenPackageYml,
+            hasPackageYml: markers.hasPackageYml
+        } : undefined,
+        analysis: {
+            totalFiles: files.length,
+            analyzedFiles,
+            skippedFiles,
+            formatDistribution: distribution.counts
+        }
+    };
+}
+//# sourceMappingURL=format-detector.js.map

package/packages/core/dist/core/install/format-detector.js.map

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

package/packages/core/dist/core/install/format-distribution-analyzer.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Format Distribution Analyzer Module
+ *
+ * Analyzes format distribution across files in a package.
+ * Determines dominant platforms and package-level format from per-file detections.
+ */
+import type { FileFormat, PlatformId, SpecialFormat } from './detection-types.js';
+/**
+ * Format distribution analysis result
+ */
+export interface FormatDistribution {
+    /** Count of files per platform (dynamic keys from platforms.jsonc) */
+    counts: Map<PlatformId | SpecialFormat, number>;
+    /** Percentage of total files per platform */
+    percentages: Map<PlatformId | SpecialFormat, number>;
+    /** Total files analyzed */
+    total: number;
+    /** Platform with highest count (if any) */
+    dominant?: PlatformId | SpecialFormat;
+    /** Dominant platform percentage (if dominant exists) */
+    dominantPercentage?: number;
+}
+/**
+ * Analyze format distribution from per-file detections
+ *
+ * Counts how many files were detected as each platform format
+ * and calculates percentages.
+ *
+ * @param fileFormats - Map of file path -> detected format
+ * @returns Distribution analysis
+ */
+export declare function analyzeFormatDistribution(fileFormats: Map<string, FileFormat>): FormatDistribution;
+/**
+ * Calculate overall package confidence from format distribution
+ *
+ * Higher confidence when:
+ * - All files are the same format
+ * - One format is clearly dominant (>70%)
+ * - Detected formats have high individual confidence
+ *
+ * Lower confidence when:
+ * - Many different formats detected
+ * - No clear dominant format
+ * - Individual file detections have low confidence
+ *
+ * @param distribution - Format distribution analysis
+ * @param fileFormats - Map of file path -> detected format (for confidence)
+ * @returns Overall confidence score (0-1)
+ */
+export declare function calculatePackageConfidence(distribution: FormatDistribution, fileFormats: Map<string, FileFormat>): number;
+/**
+ * Get dominant platform if one exists above threshold
+ *
+ * @param distribution - Format distribution analysis
+ * @param threshold - Minimum percentage to be considered dominant (default 0.7)
+ * @returns Dominant platform ID or null
+ */
+export declare function getDominantPlatform(distribution: FormatDistribution, threshold?: number): PlatformId | SpecialFormat | null;
+/**
+ * Check if format distribution indicates mixed format package
+ *
+ * A package is considered mixed if:
+ * - Multiple platforms detected with no dominant (>70%) platform
+ * - At least 20% of files are in a secondary format
+ *
+ * @param distribution - Format distribution analysis
+ * @returns True if package has mixed formats
+ */
+export declare function isMixedFormatDistribution(distribution: FormatDistribution): boolean;
+/**
+ * Determine package format from distribution analysis
+ *
+ * Returns the overall package format based on distribution patterns:
+ * - Single format → That platform ID
+ * - Dominant format (>70%) → That platform ID
+ * - Mixed formats → 'mixed'
+ * - All unknown → 'unknown'
+ * - No schemas matched → 'universal'
+ *
+ * @param distribution - Format distribution analysis
+ * @returns Package format identifier
+ */
+export declare function determinePackageFormat(distribution: FormatDistribution): PlatformId | SpecialFormat;
+/**
+ * Group files by their detected platform
+ *
+ * @param fileFormats - Map of file path -> detected format
+ * @returns Map of platform -> file paths
+ */
+export declare function groupFilesByPlatform(fileFormats: Map<string, FileFormat>): Map<PlatformId | SpecialFormat, string[]>;
+/**
+ * Get detailed format breakdown for logging/debugging
+ *
+ * @param distribution - Format distribution analysis
+ * @returns Human-readable breakdown string
+ */
+export declare function formatDistributionSummary(distribution: FormatDistribution): string;
+//# sourceMappingURL=format-distribution-analyzer.d.ts.map

package/packages/core/dist/core/install/format-distribution-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-distribution-analyzer.d.ts","sourceRoot":"","sources":["../../../src/core/install/format-distribution-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,MAAM,EAAE,GAAG,CAAC,UAAU,GAAG,aAAa,EAAE,MAAM,CAAC,CAAC;IAEhD,6CAA6C;IAC7C,WAAW,EAAE,GAAG,CAAC,UAAU,GAAG,aAAa,EAAE,MAAM,CAAC,CAAC;IAErD,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IAEd,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC;IAEtC,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GACnC,kBAAkB,CAqCpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,kBAAkB,EAChC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GACnC,MAAM,CAwBR;AAoBD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,kBAAkB,EAChC,SAAS,GAAE,MAAY,GACtB,UAAU,GAAG,aAAa,GAAG,IAAI,CAYnC;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,kBAAkB,GAC/B,OAAO,CAoBT;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,kBAAkB,GAC/B,UAAU,GAAG,aAAa,CAqB5B;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GACnC,GAAG,CAAC,UAAU,GAAG,aAAa,EAAE,MAAM,EAAE,CAAC,CAW3C;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,kBAAkB,GAC/B,MAAM,CAsBR"}