opkg 0.9.0 → 0.9.2

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

@@ -0,0 +1,126 @@
+import { join } from 'path';
+import { promises as fs } from 'fs';
+import { exists, readTextFile } from '../../utils/fs.js';
+import { logger } from '../../utils/logger.js';
+import { DIR_PATTERNS, FILE_PATTERNS } from '../../constants/index.js';
+/**
+ * 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 async function detectPluginType(dirPath) {
+    const pluginDir = join(dirPath, DIR_PATTERNS.CLAUDE_PLUGIN);
+    // Check for individual plugin
+    const pluginManifestPath = join(pluginDir, FILE_PATTERNS.PLUGIN_JSON);
+    if (await exists(pluginManifestPath)) {
+        logger.info('Detected individual Claude Code plugin', { path: pluginManifestPath });
+        return {
+            isPlugin: true,
+            type: 'individual',
+            manifestPath: pluginManifestPath
+        };
+    }
+    // Check for marketplace
+    const marketplaceManifestPath = join(pluginDir, FILE_PATTERNS.MARKETPLACE_JSON);
+    if (await exists(marketplaceManifestPath)) {
+        logger.info('Detected Claude Code plugin marketplace', { path: marketplaceManifestPath });
+        return {
+            isPlugin: true,
+            type: 'marketplace',
+            manifestPath: marketplaceManifestPath
+        };
+    }
+    // Not a plugin
+    return { isPlugin: false };
+}
+/**
+ * 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 async function detectPluginWithMarketplace(dirPath, marketplaceEntry) {
+    // First try standard detection
+    const standardDetection = await detectPluginType(dirPath);
+    if (standardDetection.isPlugin) {
+        return standardDetection;
+    }
+    // If no plugin.json and marketplace entry with strict:false, check for plugin content
+    if (marketplaceEntry?.strict === false) {
+        const hasContent = await hasPluginContent(dirPath);
+        if (hasContent) {
+            logger.info('Detected marketplace-defined plugin (strict:false)', {
+                dirPath,
+                pluginName: marketplaceEntry.name
+            });
+            return {
+                isPlugin: true,
+                type: 'marketplace-defined'
+            };
+        }
+    }
+    return { isPlugin: false };
+}
+/**
+ * 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 async function hasPluginContent(dirPath) {
+    const pluginContentDirs = ['commands', 'agents', 'skills', 'hooks'];
+    const pluginContentFiles = ['.mcp.json', '.lsp.json'];
+    // Check for plugin content directories
+    for (const subdir of pluginContentDirs) {
+        const subdirPath = join(dirPath, subdir);
+        if (await exists(subdirPath)) {
+            // Check if directory is not empty
+            try {
+                const items = await fs.readdir(subdirPath);
+                if (items.length > 0) {
+                    return true;
+                }
+            }
+            catch {
+                // Ignore errors reading directory
+            }
+        }
+    }
+    // Check for plugin content files
+    for (const file of pluginContentFiles) {
+        const filePath = join(dirPath, file);
+        if (await exists(filePath)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Validate that a plugin manifest can be parsed.
+ * Returns true if the manifest is valid JSON.
+ */
+export async function validatePluginManifest(manifestPath) {
+    try {
+        const content = await readTextFile(manifestPath);
+        JSON.parse(content);
+        return true;
+    }
+    catch (error) {
+        logger.error('Failed to parse plugin manifest', { manifestPath, error });
+        return false;
+    }
+}
+//# sourceMappingURL=plugin-detector.js.map

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

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

package/packages/core/dist/core/install/plugin-metadata-resolver.d.ts

@@ -0,0 +1,62 @@
+import type { MarketplacePluginEntry } from './marketplace-handler.js';
+/**
+ * Claude Code plugin manifest schema (from plugin.json)
+ */
+export interface ClaudePluginManifest {
+    name: string;
+    version?: string;
+    description?: string;
+    author?: {
+        name?: string;
+        email?: string;
+        url?: string;
+    };
+    homepage?: string;
+    repository?: string | {
+        type?: string;
+        url?: string;
+    };
+    license?: string;
+    keywords?: string[];
+    commands?: string | string[];
+    agents?: string | string[];
+    hooks?: string | object;
+    mcpServers?: string | object;
+    lspServers?: string | object;
+}
+/**
+ * Metadata resolution result with source information
+ */
+interface ResolvedPluginMetadata {
+    /** Resolved plugin manifest */
+    manifest: ClaudePluginManifest;
+    /** Source of metadata */
+    source: 'plugin.json' | 'marketplace' | 'merged';
+}
+/**
+ * Resolve plugin metadata from multiple sources with priority handling.
+ *
+ * Resolution logic:
+ * 1. Check if plugin.json exists
+ * 2. If exists AND strict !== false:
+ *    - Use plugin.json as primary
+ *    - Merge marketplace entry fields (as defaults)
+ *    - Return with source: 'merged'
+ * 3. If exists AND strict === false:
+ *    - Log warning (misconfiguration - strict:false but plugin.json exists)
+ *    - Use plugin.json anyway (safest fallback)
+ *    - Return with source: 'plugin.json'
+ * 4. If NOT exists AND strict === false:
+ *    - Use marketplace entry as full definition
+ *    - Return with source: 'marketplace'
+ * 5. If NOT exists AND strict !== false:
+ *    - Throw error (plugin.json required)
+ *
+ * @param pluginDir - Absolute path to plugin directory
+ * @param marketplaceEntry - Optional marketplace entry for this plugin
+ * @returns Resolved metadata and source
+ * @throws ValidationError if plugin.json is required but missing or invalid
+ */
+export declare function resolvePluginMetadata(pluginDir: string, marketplaceEntry?: MarketplacePluginEntry): Promise<ResolvedPluginMetadata>;
+export {};
+//# sourceMappingURL=plugin-metadata-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-metadata-resolver.d.ts","sourceRoot":"","sources":["../../../src/core/install/plugin-metadata-resolver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,UAAU,sBAAsB;IAC9B,+BAA+B;IAC/B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,yBAAyB;IACzB,MAAM,EAAE,aAAa,GAAG,aAAa,GAAG,QAAQ,CAAC;CAClD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,sBAAsB,GACxC,OAAO,CAAC,sBAAsB,CAAC,CAqEjC"}

package/packages/core/dist/core/install/plugin-metadata-resolver.js

@@ -0,0 +1,125 @@
+import { join } from 'path';
+import { exists, readTextFile } from '../../utils/fs.js';
+import { logger } from '../../utils/logger.js';
+import { ValidationError } from '../../utils/errors.js';
+import { CLAUDE_PLUGIN_PATHS } from '../../constants/index.js';
+/**
+ * Resolve plugin metadata from multiple sources with priority handling.
+ *
+ * Resolution logic:
+ * 1. Check if plugin.json exists
+ * 2. If exists AND strict !== false:
+ *    - Use plugin.json as primary
+ *    - Merge marketplace entry fields (as defaults)
+ *    - Return with source: 'merged'
+ * 3. If exists AND strict === false:
+ *    - Log warning (misconfiguration - strict:false but plugin.json exists)
+ *    - Use plugin.json anyway (safest fallback)
+ *    - Return with source: 'plugin.json'
+ * 4. If NOT exists AND strict === false:
+ *    - Use marketplace entry as full definition
+ *    - Return with source: 'marketplace'
+ * 5. If NOT exists AND strict !== false:
+ *    - Throw error (plugin.json required)
+ *
+ * @param pluginDir - Absolute path to plugin directory
+ * @param marketplaceEntry - Optional marketplace entry for this plugin
+ * @returns Resolved metadata and source
+ * @throws ValidationError if plugin.json is required but missing or invalid
+ */
+export async function resolvePluginMetadata(pluginDir, marketplaceEntry) {
+    const manifestPath = join(pluginDir, CLAUDE_PLUGIN_PATHS.PLUGIN_MANIFEST);
+    const hasPluginJson = await exists(manifestPath);
+    const isStrictFalse = marketplaceEntry?.strict === false;
+    // Case 1 & 2: plugin.json exists
+    if (hasPluginJson) {
+        let pluginManifest;
+        try {
+            const content = await readTextFile(manifestPath);
+            pluginManifest = JSON.parse(content);
+        }
+        catch (error) {
+            throw new ValidationError(`Failed to parse plugin manifest at ${manifestPath}: ${error}`);
+        }
+        // Case 2: strict:false but plugin.json exists (misconfiguration)
+        if (isStrictFalse) {
+            logger.warn(`Plugin at '${pluginDir}' has strict:false in marketplace but contains plugin.json. ` +
+                `Using plugin.json as primary source. Consider removing plugin.json or setting strict:true.`);
+            return {
+                manifest: pluginManifest,
+                source: 'plugin.json'
+            };
+        }
+        // Case 1: strict is true or undefined - merge with marketplace entry
+        if (marketplaceEntry) {
+            const merged = mergePluginMetadata(pluginManifest, marketplaceEntry);
+            return {
+                manifest: merged,
+                source: 'merged'
+            };
+        }
+        // No marketplace entry, just use plugin.json
+        return {
+            manifest: pluginManifest,
+            source: 'plugin.json'
+        };
+    }
+    // Case 4: No plugin.json, strict:false - use marketplace entry
+    if (isStrictFalse && marketplaceEntry) {
+        const manifest = marketplaceEntryToManifest(marketplaceEntry);
+        return {
+            manifest,
+            source: 'marketplace'
+        };
+    }
+    // Case 5: No plugin.json and not strict:false - error
+    if (marketplaceEntry) {
+        throw new ValidationError(`Plugin '${marketplaceEntry.name}' at '${pluginDir}' is missing plugin.json. ` +
+            `Either add .claude-plugin/plugin.json or set "strict": false in marketplace entry.`);
+    }
+    else {
+        throw new ValidationError(`Plugin at '${pluginDir}' is missing plugin.json at ${CLAUDE_PLUGIN_PATHS.PLUGIN_MANIFEST}`);
+    }
+}
+/**
+ * Merge plugin.json with marketplace entry.
+ * Plugin.json fields take priority, marketplace entry provides defaults.
+ */
+function mergePluginMetadata(pluginManifest, marketplaceEntry) {
+    return {
+        name: pluginManifest.name, // Always use plugin.json name
+        version: pluginManifest.version ?? marketplaceEntry.version,
+        description: pluginManifest.description ?? marketplaceEntry.description,
+        author: pluginManifest.author ?? marketplaceEntry.author,
+        homepage: pluginManifest.homepage ?? marketplaceEntry.homepage,
+        repository: pluginManifest.repository ?? marketplaceEntry.repository,
+        license: pluginManifest.license ?? marketplaceEntry.license,
+        keywords: pluginManifest.keywords ?? marketplaceEntry.keywords,
+        commands: pluginManifest.commands ?? marketplaceEntry.commands,
+        agents: pluginManifest.agents ?? marketplaceEntry.agents,
+        hooks: pluginManifest.hooks ?? marketplaceEntry.hooks,
+        mcpServers: pluginManifest.mcpServers ?? marketplaceEntry.mcpServers,
+        lspServers: pluginManifest.lspServers ?? marketplaceEntry.lspServers,
+    };
+}
+/**
+ * Convert marketplace entry to plugin manifest (for strict:false plugins)
+ */
+function marketplaceEntryToManifest(entry) {
+    return {
+        name: entry.name,
+        version: entry.version,
+        description: entry.description,
+        author: entry.author,
+        homepage: entry.homepage,
+        repository: entry.repository,
+        license: entry.license,
+        keywords: entry.keywords,
+        commands: entry.commands,
+        agents: entry.agents,
+        hooks: entry.hooks,
+        mcpServers: entry.mcpServers,
+        lspServers: entry.lspServers,
+    };
+}
+//# sourceMappingURL=plugin-metadata-resolver.js.map

package/packages/core/dist/core/install/plugin-metadata-resolver.js.map

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

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

@@ -0,0 +1,59 @@
+/**
+ * Plugin source type definitions and normalization.
+ * Implements Claude Code marketplace plugin source specification.
+ *
+ * See: https://code.claude.com/docs/en/plugin-marketplaces#plugin-sources
+ */
+/**
+ * Structured source object types from Claude Code spec.
+ *
+ * Supported source types:
+ * - Relative paths: string like "./plugins/my-plugin"
+ * - GitHub: { source: 'github', repo: 'owner/repo', ref?, path? }
+ * - Git URL: { source: 'url', url: 'https://...', ref?, path? }
+ */
+export type PluginSourceSpec = string | PluginSourceObject;
+export type PluginSourceObject = GitHubSource | GitUrlSource;
+export interface GitHubSource {
+    source: 'github';
+    repo: string;
+    ref?: string;
+    path?: string;
+}
+export interface GitUrlSource {
+    source: 'url';
+    url: string;
+    ref?: string;
+    path?: string;
+}
+/**
+ * Normalized plugin source for internal use.
+ * All source types are converted to this common format.
+ */
+export interface NormalizedPluginSource {
+    type: 'relative-path' | 'git';
+    relativePath?: string;
+    gitUrl?: string;
+    gitRef?: string;
+    gitPath?: string;
+    rawSource: PluginSourceSpec;
+}
+/**
+ * Normalize a plugin source spec into a consistent internal format.
+ * Handles all source types from the Claude Code marketplace spec.
+ *
+ * @param source - Plugin source from marketplace manifest
+ * @param pluginName - Plugin name for error messages
+ * @returns Normalized source
+ * @throws ValidationError if source is invalid
+ */
+export declare function normalizePluginSource(source: PluginSourceSpec, pluginName: string): NormalizedPluginSource;
+/**
+ * Check if a normalized source is a relative path.
+ */
+export declare function isRelativePathSource(source: NormalizedPluginSource): boolean;
+/**
+ * Check if a normalized source is a git source (GitHub or Git URL).
+ */
+export declare function isGitSource(source: NormalizedPluginSource): boolean;
+//# sourceMappingURL=plugin-sources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-sources.d.ts","sourceRoot":"","sources":["../../../src/core/install/plugin-sources.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,kBAAkB,CAAC;AAE3D,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,YAAY,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,KAAK,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,eAAe,GAAG,KAAK,CAAC;IAG9B,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,GACjB,sBAAsB,CAkCxB;AAyGD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAE5E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAEnE"}

package/packages/core/dist/core/install/plugin-sources.js

@@ -0,0 +1,122 @@
+/**
+ * Plugin source type definitions and normalization.
+ * Implements Claude Code marketplace plugin source specification.
+ *
+ * See: https://code.claude.com/docs/en/plugin-marketplaces#plugin-sources
+ */
+import { parseGitUrl } from '../../utils/git-url-parser.js';
+import { ValidationError } from '../../utils/errors.js';
+/**
+ * Normalize a plugin source spec into a consistent internal format.
+ * Handles all source types from the Claude Code marketplace spec.
+ *
+ * @param source - Plugin source from marketplace manifest
+ * @param pluginName - Plugin name for error messages
+ * @returns Normalized source
+ * @throws ValidationError if source is invalid
+ */
+export function normalizePluginSource(source, pluginName) {
+    if (!source) {
+        throw new ValidationError(`Plugin '${pluginName}' missing required 'source' field`);
+    }
+    // Case 1: String source (relative path)
+    if (typeof source === 'string') {
+        return normalizeRelativePathSource(source, pluginName);
+    }
+    // Case 2: Structured source object
+    const sourceObj = source;
+    if (!sourceObj.source) {
+        throw new ValidationError(`Plugin '${pluginName}' has invalid source object: missing 'source' field`);
+    }
+    switch (sourceObj.source) {
+        case 'github':
+            return normalizeGitHubSource(sourceObj, pluginName);
+        case 'url':
+            return normalizeGitUrlSource(sourceObj, pluginName);
+        default:
+            throw new ValidationError(`Plugin '${pluginName}' has unsupported source type: '${sourceObj.source}'. ` +
+                `Supported types: 'github', 'url', or relative path string`);
+    }
+}
+/**
+ * Normalize a relative path source.
+ */
+function normalizeRelativePathSource(path, pluginName) {
+    // Validate path doesn't traverse upward beyond marketplace root
+    if (path.includes('..')) {
+        throw new ValidationError(`Plugin '${pluginName}' source path contains '..' which is not allowed for security reasons`);
+    }
+    // Validate path is not absolute
+    if (path.startsWith('/')) {
+        throw new ValidationError(`Plugin '${pluginName}' source path must be relative to marketplace root, not absolute`);
+    }
+    // Normalize path: strip leading ./ if present
+    const normalizedPath = path.startsWith('./') ? path.substring(2) : path;
+    return {
+        type: 'relative-path',
+        relativePath: normalizedPath,
+        rawSource: path
+    };
+}
+/**
+ * Normalize a GitHub source.
+ */
+function normalizeGitHubSource(source, pluginName) {
+    // Validate repo format
+    if (!source.repo) {
+        throw new ValidationError(`Plugin '${pluginName}' GitHub source missing 'repo' field`);
+    }
+    if (!source.repo.includes('/')) {
+        throw new ValidationError(`Plugin '${pluginName}' GitHub source 'repo' must be in 'owner/repo' format, got: '${source.repo}'`);
+    }
+    const parts = source.repo.split('/');
+    if (parts.length !== 2 || !parts[0] || !parts[1]) {
+        throw new ValidationError(`Plugin '${pluginName}' GitHub source 'repo' must be in 'owner/repo' format, got: '${source.repo}'`);
+    }
+    // Convert to full git URL
+    const gitUrl = `https://github.com/${source.repo}.git`;
+    return {
+        type: 'git',
+        gitUrl,
+        gitRef: source.ref,
+        gitPath: source.path,
+        rawSource: source
+    };
+}
+/**
+ * Normalize a Git URL source.
+ */
+function normalizeGitUrlSource(source, pluginName) {
+    // Validate URL field exists
+    if (!source.url) {
+        throw new ValidationError(`Plugin '${pluginName}' Git URL source missing 'url' field`);
+    }
+    // Validate URL format by attempting to parse it
+    try {
+        parseGitUrl(source.url);
+    }
+    catch (error) {
+        throw new ValidationError(`Plugin '${pluginName}' has invalid Git URL: ${source.url}. ` +
+            `Error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return {
+        type: 'git',
+        gitUrl: source.url,
+        gitRef: source.ref,
+        gitPath: source.path,
+        rawSource: source
+    };
+}
+/**
+ * Check if a normalized source is a relative path.
+ */
+export function isRelativePathSource(source) {
+    return source.type === 'relative-path';
+}
+/**
+ * Check if a normalized source is a git source (GitHub or Git URL).
+ */
+export function isGitSource(source) {
+    return source.type === 'git';
+}
+//# sourceMappingURL=plugin-sources.js.map

package/packages/core/dist/core/install/plugin-sources.js.map

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

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

@@ -0,0 +1,29 @@
+import type { PackageWithContext } from '../../types/index.js';
+import type { MarketplacePluginEntry } from './marketplace-handler.js';
+/**
+ * Retrieve a cached transformed plugin package with context.
+ */
+export declare function getTransformedPlugin(name: string, version: string): PackageWithContext | undefined;
+/**
+ * Context for transforming a plugin with naming information.
+ */
+interface PluginTransformContext {
+    gitUrl?: string;
+    path?: string;
+    resourcePath?: string;
+    repoPath?: string;
+    marketplaceEntry?: MarketplacePluginEntry;
+}
+/**
+ * Transform a Claude Code plugin to an OpenPackage Package with conversion context.
+ *
+ * Resolves plugin metadata from plugin.json or marketplace entry, converts it to
+ * OpenPackage format, and collects all plugin files.
+ *
+ * @param pluginDir - Absolute path to plugin directory
+ * @param context - Optional context for scoped naming and marketplace entry
+ * @returns Package object with conversion context
+ */
+export declare function transformPluginToPackage(pluginDir: string, context?: PluginTransformContext): Promise<PackageWithContext>;
+export {};
+//# sourceMappingURL=plugin-transformer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-transformer.d.ts","sourceRoot":"","sources":["../../../src/core/install/plugin-transformer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAoC,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAMjG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAmBvE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAGlG;AAED;;GAEG;AACH,UAAU,sBAAsB;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C;AAED;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CA+E7B"}