opkg 0.9.0 → 0.9.2

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

@@ -0,0 +1,93 @@
+/**
+ * Package Marker Detector Module
+ *
+ * Detects package-level format markers using patterns from platforms.jsonc.
+ * This is the "fast path" for package format detection.
+ *
+ * All platform IDs and detection patterns are data-driven from platforms.jsonc -
+ * no hardcoded platform checks.
+ */
+import type { PackageFile, PlatformId } from './detection-types.js';
+/**
+ * A matched platform marker
+ */
+export interface MarkerMatch {
+    /** Platform ID from platforms.jsonc (e.g., 'claude', 'cursor', 'opencode') */
+    platformId: PlatformId;
+    /** Detection pattern that matched (e.g., '.claude-plugin/plugin.json') */
+    matchedPattern: string;
+    /** Confidence (1.0 for explicit markers) */
+    confidence: number;
+}
+/**
+ * Package marker detection result
+ */
+export interface PackageMarkers {
+    /** All matched platform markers */
+    matches: MarkerMatch[];
+    /** Whether openpackage.yml exists (universal format indicator) */
+    hasOpenPackageYml: boolean;
+    /** Whether package.yml exists (legacy universal format) */
+    hasPackageYml: boolean;
+}
+/**
+ * Detect platform markers in a package using patterns from platforms.jsonc
+ *
+ * This is a data-driven approach - all platform IDs and detection patterns
+ * come from the platform registry, with no hardcoded platform checks.
+ *
+ * @param files - List of package files
+ * @param targetDir - Optional target directory for local platform config
+ * @returns Detection results with all matched platforms
+ */
+export declare function detectPlatformMarkers(files: PackageFile[], targetDir?: string): PackageMarkers;
+/**
+ * Check if a detection pattern matches any file in the package
+ *
+ * Handles both exact file paths and glob patterns.
+ *
+ * @param filePaths - Set of file paths in package
+ * @param pattern - Detection pattern (e.g., '.claude', '*.json', 'AGENTS.md')
+ * @returns True if pattern matches at least one file
+ */
+export declare function matchDetectionPattern(filePaths: Set<string>, pattern: string): boolean;
+/**
+ * Check if openpackage.yml or package.yml exists
+ *
+ * These files indicate universal format but don't prevent per-file detection
+ * (the package may still contain mixed platform-specific content).
+ */
+export declare function hasOpenPackageMarker(files: PackageFile[]): boolean;
+/**
+ * Get primary platform from marker matches
+ *
+ * Determines the primary platform when multiple markers are found.
+ * Uses priority ordering to resolve ambiguity.
+ *
+ * @param markers - Package marker detection results
+ * @returns Primary platform ID, or null if none/ambiguous
+ */
+export declare function getPrimaryPlatformFromMarkers(markers: PackageMarkers): PlatformId | null;
+/**
+ * Check if markers indicate a pure platform-specific package
+ *
+ * A pure platform-specific package has:
+ * - Exactly one platform marker
+ * - No universal format marker (openpackage.yml)
+ *
+ * @param markers - Package marker detection results
+ * @returns True if package is pure platform-specific
+ */
+export declare function isPurePlatformSpecific(markers: PackageMarkers): boolean;
+/**
+ * Check if markers indicate a mixed format package
+ *
+ * A mixed format package has either:
+ * - Multiple platform markers
+ * - Both platform and universal markers
+ *
+ * @param markers - Package marker detection results
+ * @returns True if package has mixed format indicators
+ */
+export declare function isMixedFormat(markers: PackageMarkers): boolean;
+//# sourceMappingURL=package-marker-detector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"package-marker-detector.d.ts","sourceRoot":"","sources":["../../../src/core/install/package-marker-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,UAAU,EAAE,UAAU,CAAC;IAEvB,0EAA0E;IAC1E,cAAc,EAAE,MAAM,CAAC;IAEvB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,OAAO,EAAE,WAAW,EAAE,CAAC;IAEvB,kEAAkE;IAClE,iBAAiB,EAAE,OAAO,CAAC;IAE3B,2DAA2D;IAC3D,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,WAAW,EAAE,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,cAAc,CAoChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CA4BT;AAcD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAElE;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,cAAc,GACtB,UAAU,GAAG,IAAI,CA8BnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAcvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAc9D"}

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

@@ -0,0 +1,185 @@
+/**
+ * Package Marker Detector Module
+ *
+ * Detects package-level format markers using patterns from platforms.jsonc.
+ * This is the "fast path" for package format detection.
+ *
+ * All platform IDs and detection patterns are data-driven from platforms.jsonc -
+ * no hardcoded platform checks.
+ */
+import { minimatch } from 'minimatch';
+import { logger } from '../../utils/logger.js';
+import { getPlatformDefinitions } from '../platforms.js';
+/**
+ * Detect platform markers in a package using patterns from platforms.jsonc
+ *
+ * This is a data-driven approach - all platform IDs and detection patterns
+ * come from the platform registry, with no hardcoded platform checks.
+ *
+ * @param files - List of package files
+ * @param targetDir - Optional target directory for local platform config
+ * @returns Detection results with all matched platforms
+ */
+export function detectPlatformMarkers(files, targetDir) {
+    const matches = [];
+    const platforms = getPlatformDefinitions(targetDir);
+    // Extract file paths for efficient matching
+    const filePaths = new Set(files.map(f => f.path));
+    // Check each platform's detection patterns
+    for (const [platformId, definition] of Object.entries(platforms)) {
+        const detectionPatterns = definition.detection;
+        if (!detectionPatterns || detectionPatterns.length === 0) {
+            continue;
+        }
+        // Check each detection pattern for this platform
+        for (const pattern of detectionPatterns) {
+            if (matchDetectionPattern(filePaths, pattern)) {
+                matches.push({
+                    platformId,
+                    matchedPattern: pattern,
+                    confidence: 1.0
+                });
+            }
+        }
+    }
+    // Check for universal format markers
+    const hasOpenPackageYml = filePaths.has('openpackage.yml');
+    const hasPackageYml = filePaths.has('package.yml');
+    return {
+        matches,
+        hasOpenPackageYml,
+        hasPackageYml
+    };
+}
+/**
+ * Check if a detection pattern matches any file in the package
+ *
+ * Handles both exact file paths and glob patterns.
+ *
+ * @param filePaths - Set of file paths in package
+ * @param pattern - Detection pattern (e.g., '.claude', '*.json', 'AGENTS.md')
+ * @returns True if pattern matches at least one file
+ */
+export function matchDetectionPattern(filePaths, pattern) {
+    // Try exact match first (optimization for non-glob patterns)
+    if (filePaths.has(pattern)) {
+        return true;
+    }
+    // Check if pattern contains glob characters
+    const isGlob = pattern.includes('*') || pattern.includes('?') || pattern.includes('[');
+    if (isGlob) {
+        // Use glob matching
+        for (const filePath of filePaths) {
+            if (matchGlob(filePath, pattern)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    // For non-glob patterns, check if any file starts with this path
+    // This handles directory markers like '.claude' matching '.claude/agents/foo.md'
+    for (const filePath of filePaths) {
+        if (filePath === pattern || filePath.startsWith(pattern + '/')) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Match a file path against a glob pattern
+ */
+function matchGlob(filePath, pattern) {
+    try {
+        return minimatch(filePath, pattern);
+    }
+    catch (error) {
+        logger.warn(`Invalid glob pattern: ${pattern}`, error);
+        return false;
+    }
+}
+/**
+ * Check if openpackage.yml or package.yml exists
+ *
+ * These files indicate universal format but don't prevent per-file detection
+ * (the package may still contain mixed platform-specific content).
+ */
+export function hasOpenPackageMarker(files) {
+    return files.some(f => f.path === 'openpackage.yml' || f.path === 'package.yml');
+}
+/**
+ * Get primary platform from marker matches
+ *
+ * Determines the primary platform when multiple markers are found.
+ * Uses priority ordering to resolve ambiguity.
+ *
+ * @param markers - Package marker detection results
+ * @returns Primary platform ID, or null if none/ambiguous
+ */
+export function getPrimaryPlatformFromMarkers(markers) {
+    const { matches, hasOpenPackageYml, hasPackageYml } = markers;
+    // No matches
+    if (matches.length === 0) {
+        return null;
+    }
+    // Single match - return that platform
+    if (matches.length === 1) {
+        return matches[0].platformId;
+    }
+    // Multiple matches - use priority
+    // Priority order (highest to lowest):
+    // 1. claude-plugin (explicit plugin manifest)
+    // 2. Other platforms by detection pattern specificity
+    // Check for claude-plugin first
+    const claudePluginMatch = matches.find(m => m.platformId === 'claude-plugin');
+    if (claudePluginMatch) {
+        return 'claude-plugin';
+    }
+    // For other platforms, prefer more specific patterns (longer paths)
+    const sorted = [...matches].sort((a, b) => b.matchedPattern.length - a.matchedPattern.length);
+    return sorted[0].platformId;
+}
+/**
+ * Check if markers indicate a pure platform-specific package
+ *
+ * A pure platform-specific package has:
+ * - Exactly one platform marker
+ * - No universal format marker (openpackage.yml)
+ *
+ * @param markers - Package marker detection results
+ * @returns True if package is pure platform-specific
+ */
+export function isPurePlatformSpecific(markers) {
+    const { matches, hasOpenPackageYml, hasPackageYml } = markers;
+    // Must have exactly one platform match
+    if (matches.length !== 1) {
+        return false;
+    }
+    // Must not have universal markers
+    if (hasOpenPackageYml || hasPackageYml) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Check if markers indicate a mixed format package
+ *
+ * A mixed format package has either:
+ * - Multiple platform markers
+ * - Both platform and universal markers
+ *
+ * @param markers - Package marker detection results
+ * @returns True if package has mixed format indicators
+ */
+export function isMixedFormat(markers) {
+    const { matches, hasOpenPackageYml, hasPackageYml } = markers;
+    // Multiple platform markers
+    if (matches.length > 1) {
+        return true;
+    }
+    // Platform marker + universal marker
+    if (matches.length > 0 && (hasOpenPackageYml || hasPackageYml)) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=package-marker-detector.js.map

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

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

package/packages/core/dist/core/install/path-package-loader.d.ts

@@ -0,0 +1,42 @@
+import { Package } from '../../types/index.js';
+import type { MarketplacePluginEntry } from './marketplace-handler.js';
+export type PathSourceType = 'directory' | 'tarball';
+/**
+ * Context for loading packages with naming information and marketplace metadata.
+ */
+export interface PackageLoadContext {
+    gitUrl?: string;
+    path?: string;
+    resourcePath?: string;
+    repoPath?: string;
+    packageName?: string;
+    marketplaceEntry?: MarketplacePluginEntry;
+}
+/**
+ * Infer the source type from a path string.
+ */
+export declare function inferSourceType(path: string): PathSourceType;
+/**
+ * Load a package from a local directory.
+ * Reads all files from the directory and loads openpackage.yml.
+ *
+ * If the directory is a Claude Code plugin, transforms it to OpenPackage format.
+ *
+ * @param dirPath - Path to directory
+ * @param context - Optional context for scoped naming (GitHub URL, subdirectory)
+ */
+export declare function loadPackageFromDirectory(dirPath: string, context?: PackageLoadContext): Promise<Package>;
+/**
+ * Load a package from a tarball file.
+ * Extracts to a temporary location, reads files, then cleans up.
+ */
+export declare function loadPackageFromTarball(tarballPath: string): Promise<Package>;
+/**
+ * Load a package from either a directory or tarball path.
+ * Automatically detects the source type.
+ *
+ * @param path - Path to package
+ * @param context - Optional context for scoped naming
+ */
+export declare function loadPackageFromPath(path: string, context?: PackageLoadContext): Promise<Package>;
+//# sourceMappingURL=path-package-loader.d.ts.map

package/packages/core/dist/core/install/path-package-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-package-loader.d.ts","sourceRoot":"","sources":["../../../src/core/install/path-package-loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAA2B,MAAM,sBAAsB,CAAC;AAUxE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAIvE,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,SAAS,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAE5D;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAgHlB;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAsClF;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAQlB"}

package/packages/core/dist/core/install/path-package-loader.js

@@ -0,0 +1,173 @@
+import { relative, basename } from 'path';
+import { readFile } from 'fs/promises';
+import { loadPackageConfig } from '../package-context.js';
+import { extractPackageFromTarball } from '../../utils/tarball.js';
+import { walkFiles, readTextFile } from '../../utils/fs.js';
+import { isJunk } from 'junk';
+import { logger } from '../../utils/logger.js';
+import { ValidationError } from '../../utils/errors.js';
+import { FILE_PATTERNS, PACKAGE_PATHS, CLAUDE_PLUGIN_PATHS } from '../../constants/index.js';
+import { detectPluginWithMarketplace, hasPluginContent } from './plugin-detector.js';
+import { transformPluginToPackage } from './plugin-transformer.js';
+import { generateGitHubPackageName } from '../../utils/plugin-naming.js';
+import * as yaml from 'js-yaml';
+/**
+ * Infer the source type from a path string.
+ */
+export function inferSourceType(path) {
+    return path.endsWith(FILE_PATTERNS.TGZ_FILES) || path.endsWith(FILE_PATTERNS.TAR_GZ_FILES) ? 'tarball' : 'directory';
+}
+/**
+ * Load a package from a local directory.
+ * Reads all files from the directory and loads openpackage.yml.
+ *
+ * If the directory is a Claude Code plugin, transforms it to OpenPackage format.
+ *
+ * @param dirPath - Path to directory
+ * @param context - Optional context for scoped naming (GitHub URL, subdirectory)
+ */
+export async function loadPackageFromDirectory(dirPath, context) {
+    // Check if this is a Claude Code plugin (with marketplace context if available)
+    const pluginDetection = await detectPluginWithMarketplace(dirPath, context?.marketplaceEntry);
+    if (pluginDetection.isPlugin && (pluginDetection.type === 'individual' || pluginDetection.type === 'marketplace-defined')) {
+        logger.info(`Detected Claude Code plugin (${pluginDetection.type}), transforming to OpenPackage format`, { dirPath });
+        const { package: pkg } = await transformPluginToPackage(dirPath, context);
+        return pkg;
+    }
+    // If it's a marketplace, we need to handle plugin selection (done upstream in install command)
+    if (pluginDetection.isPlugin && pluginDetection.type === 'marketplace') {
+        throw new ValidationError(`Directory '${dirPath}' is a Claude Code plugin marketplace. ` +
+            `Marketplace installation requires plugin selection and should be handled by the install command.`);
+    }
+    // Load openpackage.yml for regular packages
+    let config = await loadPackageConfig(dirPath);
+    if (!config) {
+        // Marketplace-defined plugins (no plugin.json) may have only plugin content (commands/agents/skills).
+        // Treat as loadable so install can proceed without marketplace selection.
+        const hasContent = await hasPluginContent(dirPath);
+        if (hasContent) {
+            const syntheticEntry = {
+                strict: false,
+                name: context?.packageName ?? basename(dirPath),
+                source: '.' // minimal spec for marketplace-defined plugin without marketplace manifest
+            };
+            const marketplaceDefined = await detectPluginWithMarketplace(dirPath, syntheticEntry);
+            if (marketplaceDefined.isPlugin && marketplaceDefined.type === 'marketplace-defined') {
+                const { package: pkg } = await transformPluginToPackage(dirPath, {
+                    ...context,
+                    marketplaceEntry: syntheticEntry
+                });
+                return pkg;
+            }
+        }
+        // Resource-centric installs (Phase 3) can operate on directories without openpackage.yml,
+        // as long as they match installable patterns (base detection ensures this upstream).
+        if (!context?.resourcePath) {
+            throw new ValidationError(`Directory '${dirPath}' is not a valid OpenPackage directory or Claude Code plugin. ` +
+                `Missing ${FILE_PATTERNS.OPENPACKAGE_YML} or ${CLAUDE_PLUGIN_PATHS.PLUGIN_MANIFEST}`);
+        }
+        const fallbackBaseName = basename(dirPath);
+        const fallbackName = context?.gitUrl
+            ? generateGitHubPackageName({
+                gitUrl: context.gitUrl,
+                path: context.path,
+                resourcePath: context.resourcePath,
+                packageName: fallbackBaseName,
+                repoPath: context.repoPath
+            })
+            : fallbackBaseName;
+        config = {
+            name: fallbackName,
+            version: '0.0.0'
+        };
+    }
+    // Apply GitHub scoping for packages from GitHub sources
+    // This ensures consistent naming: gh@username/repo or gh@username/repo/path
+    if (context?.gitUrl) {
+        const originalName = config.name;
+        const scopedName = generateGitHubPackageName({
+            gitUrl: context.gitUrl,
+            path: context.path,
+            resourcePath: context.resourcePath,
+            packageName: originalName, // Pass original name for non-GitHub sources
+            repoPath: context.repoPath
+        });
+        // Only override if GitHub scoping was applied (name changed)
+        if (scopedName !== originalName) {
+            config.name = scopedName;
+        }
+    }
+    // Discover all files in the directory
+    const files = [];
+    try {
+        for await (const fullPath of walkFiles(dirPath)) {
+            const relativePath = relative(dirPath, fullPath);
+            // Filter out junk files
+            if (isJunk(basename(relativePath))) {
+                continue;
+            }
+            const content = await readTextFile(fullPath);
+            files.push({
+                path: relativePath,
+                content,
+                encoding: 'utf8'
+            });
+        }
+        return {
+            metadata: config,
+            files
+        };
+    }
+    catch (error) {
+        logger.error(`Failed to load package from directory: ${dirPath}`, { error });
+        throw new ValidationError(`Failed to load package from directory: ${error}`);
+    }
+}
+/**
+ * Load a package from a tarball file.
+ * Extracts to a temporary location, reads files, then cleans up.
+ */
+export async function loadPackageFromTarball(tarballPath) {
+    // Read tarball file
+    let tarballBuffer;
+    try {
+        tarballBuffer = await readFile(tarballPath);
+    }
+    catch (error) {
+        throw new ValidationError(`Failed to read tarball file '${tarballPath}': ${error}`);
+    }
+    // Extract tarball
+    const extracted = await extractPackageFromTarball(tarballBuffer);
+    // Find openpackage.yml in extracted files
+    const packageYmlFile = extracted.files.find(f => f.path === PACKAGE_PATHS.MANIFEST_RELATIVE || f.path === 'openpackage.yml');
+    if (!packageYmlFile) {
+        throw new ValidationError(`Tarball '${tarballPath}' does not contain a valid ${FILE_PATTERNS.OPENPACKAGE_YML} file`);
+    }
+    // Parse openpackage.yml content
+    const config = yaml.load(packageYmlFile.content);
+    if (!config.name) {
+        throw new ValidationError(`Tarball '${tarballPath}' contains invalid ${FILE_PATTERNS.OPENPACKAGE_YML}: missing name field`);
+    }
+    logger.debug(`Loaded package ${config.name}@${config.version} from tarball: ${tarballPath}`);
+    return {
+        metadata: config,
+        files: extracted.files
+    };
+}
+/**
+ * Load a package from either a directory or tarball path.
+ * Automatically detects the source type.
+ *
+ * @param path - Path to package
+ * @param context - Optional context for scoped naming
+ */
+export async function loadPackageFromPath(path, context) {
+    const sourceType = inferSourceType(path);
+    if (sourceType === 'tarball') {
+        return await loadPackageFromTarball(path);
+    }
+    else {
+        return await loadPackageFromDirectory(path, context);
+    }
+}
+//# sourceMappingURL=path-package-loader.js.map

package/packages/core/dist/core/install/path-package-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-package-loader.js","sourceRoot":"","sources":["../../../src/core/install/path-package-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC7F,OAAO,EAAoB,2BAA2B,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACvG,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAgBhC;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;AACvH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAe,EACf,OAA4B;IAE5B,gFAAgF;IAChF,MAAM,eAAe,GAAG,MAAM,2BAA2B,CAAC,OAAO,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAE9F,IAAI,eAAe,CAAC,QAAQ,IAAI,CAAC,eAAe,CAAC,IAAI,KAAK,YAAY,IAAI,eAAe,CAAC,IAAI,KAAK,qBAAqB,CAAC,EAAE,CAAC;QAC1H,MAAM,CAAC,IAAI,CAAC,gCAAgC,eAAe,CAAC,IAAI,uCAAuC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACtH,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,wBAAwB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1E,OAAO,GAAG,CAAC;IACb,CAAC;IAED,+FAA+F;IAC/F,IAAI,eAAe,CAAC,QAAQ,IAAI,eAAe,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QACvE,MAAM,IAAI,eAAe,CACvB,cAAc,OAAO,yCAAyC;YAC9D,kGAAkG,CACnG,CAAC;IACJ,CAAC;IAED,4CAA4C;IAC5C,IAAI,MAAM,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,sGAAsG;QACtG,0EAA0E;QAC1E,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,cAAc,GAA2B;gBAC7C,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,OAAO,EAAE,WAAW,IAAI,QAAQ,CAAC,OAAO,CAAC;gBAC/C,MAAM,EAAE,GAAG,CAAC,2EAA2E;aACxF,CAAC;YACF,MAAM,kBAAkB,GAAG,MAAM,2BAA2B,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACtF,IAAI,kBAAkB,CAAC,QAAQ,IAAI,kBAAkB,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;gBACrF,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,wBAAwB,CAAC,OAAO,EAAE;oBAC/D,GAAG,OAAO;oBACV,gBAAgB,EAAE,cAAc;iBACjC,CAAC,CAAC;gBACH,OAAO,GAAG,CAAC;YACb,CAAC;QACH,CAAC;QACD,0FAA0F;QAC1F,qFAAqF;QACrF,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC;YAC3B,MAAM,IAAI,eAAe,CACvB,cAAc,OAAO,gEAAgE;gBACrF,WAAW,aAAa,CAAC,eAAe,OAAO,mBAAmB,CAAC,eAAe,EAAE,CACrF,CAAC;QACJ,CAAC;QAED,MAAM,gBAAgB,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAG,OAAO,EAAE,MAAM;YAClC,CAAC,CAAC,yBAAyB,CAAC;gBACxB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,WAAW,EAAE,gBAAgB;gBAC7B,QAAQ,EAAE,OAAO,CAAC,QAAQ;aAC3B,CAAC;YACJ,CAAC,CAAC,gBAAgB,CAAC;QAErB,MAAM,GAAG;YACP,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,OAAO;SACI,CAAC;IACzB,CAAC;IAED,wDAAwD;IACxD,4EAA4E;IAC5E,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;QACpB,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC;QACjC,MAAM,UAAU,GAAG,yBAAyB,CAAC;YAC3C,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,YAAY,EAAG,4CAA4C;YACxE,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;QAEH,6DAA6D;QAC7D,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;YAChC,MAAM,CAAC,IAAI,GAAG,UAAU,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,MAAM,KAAK,GAAkB,EAAE,CAAC;IAEhC,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,QAAQ,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAChD,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAEjD,wBAAwB;YACxB,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;gBACnC,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;YAE7C,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,YAAY;gBAClB,OAAO;gBACP,QAAQ,EAAE,MAAM;aACjB,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,MAAM;YAChB,KAAK;SACN,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,0CAA0C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7E,MAAM,IAAI,eAAe,CAAC,0CAA0C,KAAK,EAAE,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,WAAmB;IAC9D,oBAAoB;IACpB,IAAI,aAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,aAAa,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,eAAe,CAAC,gCAAgC,WAAW,MAAM,KAAK,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,kBAAkB;IAClB,MAAM,SAAS,GAAG,MAAM,yBAAyB,CAAC,aAAa,CAAC,CAAC;IAEjE,0CAA0C;IAC1C,MAAM,cAAc,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CACzC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,iBAAiB,IAAI,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAChF,CAAC;IAEF,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,eAAe,CACvB,YAAY,WAAW,8BAA8B,aAAa,CAAC,eAAe,OAAO,CAC1F,CAAC;IACJ,CAAC;IAED,gCAAgC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAe,CAAC;IAE/D,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,eAAe,CACvB,YAAY,WAAW,sBAAsB,aAAa,CAAC,eAAe,sBAAsB,CACjG,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,kBAAkB,WAAW,EAAE,CAAC,CAAC;IAE7F,OAAO;QACL,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,SAAS,CAAC,KAAK;KACvB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAY,EACZ,OAA4B;IAE5B,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAEzC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,MAAM,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;SAAM,CAAC;QACN,OAAO,MAAM,wBAAwB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;AACH,CAAC"}

package/packages/core/dist/core/install/platform-resolution.d.ts

@@ -0,0 +1,15 @@
+import { type Platform } from '../platforms.js';
+import type { OutputPort } from '../ports/output.js';
+import type { PromptPort } from '../ports/prompt.js';
+/**
+ * Resolve platforms for an operation.
+ * - Uses specified platforms if provided (validated against known platforms)
+ * - Otherwise auto-detects
+ * - If none detected and interactive=true, prompts user to select
+ */
+export declare function resolvePlatforms(cwd: string, specified: string[] | undefined, options?: {
+    interactive?: boolean;
+    output?: OutputPort;
+    prompt?: PromptPort;
+}): Promise<Platform[]>;
+//# sourceMappingURL=platform-resolution.d.ts.map

package/packages/core/dist/core/install/platform-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-resolution.d.ts","sourceRoot":"","sources":["../../../src/core/install/platform-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,EAC/B,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAAO,GAChF,OAAO,CAAC,QAAQ,EAAE,CAAC,CAuBrB"}

package/packages/core/dist/core/install/platform-resolution.js

@@ -0,0 +1,31 @@
+import { resolvePlatformName } from '../platforms.js';
+import { normalizePlatforms } from '../platform/platform-mapper.js';
+import { detectPlatforms, promptForPlatformSelection } from './package-installation.js';
+/**
+ * Resolve platforms for an operation.
+ * - Uses specified platforms if provided (validated against known platforms)
+ * - Otherwise auto-detects
+ * - If none detected and interactive=true, prompts user to select
+ */
+export async function resolvePlatforms(cwd, specified, options = {}) {
+    const interactive = options.interactive === true;
+    const normalized = normalizePlatforms(specified);
+    if (normalized && normalized.length > 0) {
+        const resolved = normalized.map(name => resolvePlatformName(name));
+        const invalidIndex = resolved.findIndex(platform => !platform);
+        if (invalidIndex !== -1) {
+            throw new Error(`platform ${normalized[invalidIndex]} not found`);
+        }
+        return resolved;
+    }
+    const auto = await detectPlatforms(cwd);
+    if (auto.length > 0)
+        return auto;
+    if (interactive) {
+        const selected = await promptForPlatformSelection(options.output, options.prompt);
+        return selected;
+    }
+    // Non-interactive with no detected platforms: default to cursor so installs are not silently no-ops.
+    return ['cursor'];
+}
+//# sourceMappingURL=platform-resolution.js.map

package/packages/core/dist/core/install/platform-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-resolution.js","sourceRoot":"","sources":["../../../src/core/install/platform-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAiB,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAIxF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAW,EACX,SAA+B,EAC/B,UAA+E,EAAE;IAEjF,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,KAAK,IAAI,CAAC;IAEjD,MAAM,UAAU,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;QACnE,MAAM,YAAY,GAAG,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC/D,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,YAAY,UAAU,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,QAAsB,CAAC;IAChC,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjC,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAClF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,qGAAqG;IACrG,OAAO,CAAC,QAAQ,CAAe,CAAC;AAClC,CAAC"}

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

@@ -0,0 +1,46 @@
+import type { MarketplacePluginEntry } from './marketplace-handler.js';
+export type PluginType = 'individual' | 'marketplace' | 'marketplace-defined';
+export interface PluginDetectionResult {
+    isPlugin: boolean;
+    type?: PluginType;
+    manifestPath?: string;
+}
+/**
+ * Detect if a directory contains a Claude Code plugin.
+ *
+ * Detection order:
+ * 1. Check for .claude-plugin/plugin.json (individual plugin)
+ * 2. Check for .claude-plugin/marketplace.json (marketplace)
+ *
+ * @param dirPath - Absolute path to directory to check
+ * @returns Detection result with plugin type if found
+ */
+export declare function detectPluginType(dirPath: string): Promise<PluginDetectionResult>;
+/**
+ * Detect if a directory contains a Claude Code plugin, with marketplace context.
+ *
+ * This enhanced detection supports marketplace-defined plugins (strict:false) that
+ * may not have their own plugin.json file.
+ *
+ * Detection order:
+ * 1. Check for .claude-plugin/plugin.json (individual plugin)
+ * 2. Check for .claude-plugin/marketplace.json (marketplace)
+ * 3. If marketplaceEntry exists AND strict:false, check for plugin content
+ *
+ * @param dirPath - Absolute path to directory to check
+ * @param marketplaceEntry - Optional marketplace entry for this plugin
+ * @returns Detection result with plugin type if found
+ */
+export declare function detectPluginWithMarketplace(dirPath: string, marketplaceEntry?: MarketplacePluginEntry): Promise<PluginDetectionResult>;
+/**
+ * Check if a directory has plugin content (commands, agents, etc.)
+ * Used to validate marketplace-defined plugins that don't have plugin.json.
+ * Exported for use in file-discovery and path-package-loader.
+ */
+export declare function hasPluginContent(dirPath: string): Promise<boolean>;
+/**
+ * Validate that a plugin manifest can be parsed.
+ * Returns true if the manifest is valid JSON.
+ */
+export declare function validatePluginManifest(manifestPath: string): Promise<boolean>;
+//# sourceMappingURL=plugin-detector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-detector.d.ts","sourceRoot":"","sources":["../../../src/core/install/plugin-detector.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,aAAa,GAAG,qBAAqB,CAAC;AAE9E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA2BtF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,EACf,gBAAgB,CAAC,EAAE,sBAAsB,GACxC,OAAO,CAAC,qBAAqB,CAAC,CA0BhC;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA6BxE;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASnF"}