opkg 0.9.0 → 0.9.2

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

@@ -0,0 +1,159 @@
+import { relative } from 'path';
+import { readTextFile, walkFiles } from '../../utils/fs.js';
+import { logger } from '../../utils/logger.js';
+import { ValidationError } from '../../utils/errors.js';
+import { isJunk } from 'junk';
+import { detectPackageFormat } from './format-detector.js';
+import { DIR_PATTERNS } from '../../constants/index.js';
+import { generateGitHubPackageName } from '../../utils/plugin-naming.js';
+import { createPlatformContext } from '../conversion-context/index.js';
+import { resolvePluginMetadata } from './plugin-metadata-resolver.js';
+/**
+ * In-memory cache for transformed plugin packages with context.
+ * Key: `${packageName}@${version}`
+ */
+const transformedPluginCache = new Map();
+/**
+ * Cache a transformed plugin package with context for later retrieval.
+ */
+function cacheTransformedPlugin(pkg, context) {
+    const key = `${pkg.metadata.name}@${pkg.metadata.version}`;
+    const cached = context
+        ? { package: pkg, context }
+        : { package: pkg, context: createPlatformContext('claude-plugin', 1.0) };
+    transformedPluginCache.set(key, cached);
+}
+/**
+ * Retrieve a cached transformed plugin package with context.
+ */
+export function getTransformedPlugin(name, version) {
+    const key = `${name}@${version}`;
+    return transformedPluginCache.get(key);
+}
+/**
+ * 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 async function transformPluginToPackage(pluginDir, context) {
+    // Resolve plugin metadata from plugin.json or marketplace entry
+    const resolved = await resolvePluginMetadata(pluginDir, context?.marketplaceEntry);
+    const pluginManifest = resolved.manifest;
+    // Generate scoped name using consistent naming logic
+    // Always generate the name (no override) to ensure consistency
+    const packageName = generateGitHubPackageName({
+        gitUrl: context?.gitUrl,
+        path: context?.path,
+        resourcePath: context?.resourcePath,
+        packageName: pluginManifest.name,
+        repoPath: context?.repoPath
+    });
+    // Transform to OpenPackage metadata
+    const metadata = {
+        name: packageName,
+        // Claude Code plugins often omit version; normalize to a concrete value so:
+        // - logs/install output are consistent
+        // - transformed plugin cache keys remain stable
+        version: pluginManifest.version?.trim() || '0.0.0',
+        description: pluginManifest.description,
+        keywords: pluginManifest.keywords,
+        license: pluginManifest.license,
+        homepage: pluginManifest.homepage
+    };
+    // Extract author name
+    if (pluginManifest.author?.name) {
+        metadata.author = pluginManifest.author.name;
+    }
+    // Extract repository - handle both string and object forms
+    if (pluginManifest.repository) {
+        if (typeof pluginManifest.repository === 'string') {
+            metadata.repository = {
+                type: 'git',
+                url: pluginManifest.repository
+            };
+        }
+        else if (pluginManifest.repository.url) {
+            metadata.repository = {
+                type: pluginManifest.repository.type || 'git',
+                url: pluginManifest.repository.url
+            };
+        }
+    }
+    // Collect all plugin files (preserve entire directory structure)
+    const files = await extractPluginFiles(pluginDir);
+    // Detect package format
+    // Claude plugins are detected as platform-specific 'claude-plugin' format
+    // and will use the claude-plugin flows defined in platforms.jsonc
+    const format = detectPackageFormat(files);
+    const pkg = {
+        metadata,
+        files,
+        // Store format metadata for installation pipeline
+        _format: format
+    };
+    // Create conversion context for claude-plugin
+    const conversionContext = createPlatformContext('claude-plugin', format.confidence);
+    // Cache the transformed plugin with context for later retrieval
+    cacheTransformedPlugin(pkg, conversionContext);
+    logger.info('Transformed Claude Code plugin', {
+        name: metadata.name,
+        version: metadata.version,
+        fileCount: files.length,
+        format: format.type,
+        platform: format.platform,
+        confidence: format.confidence
+    });
+    return { package: pkg, context: conversionContext };
+}
+/**
+ * Extract all files from a plugin directory, preserving structure.
+ *
+ * Plugin files are kept with their original paths (commands/, agents/, etc.)
+ * The OpenPackage platform system will handle installing them to the correct
+ * platform-specific directories (.claude/commands/, .cursor/commands/, etc.)
+ *
+ * Special handling for plugin-specific files:
+ * - .claude-plugin/ → skipped (plugin metadata, not needed in workspace)
+ * - .mcp.json, .lsp.json → kept as root files
+ * - commands/, agents/, skills/, hooks/ → universal subdirs
+ *
+ * @param pluginDir - Absolute path to plugin directory
+ * @returns Array of package files with original paths
+ */
+async function extractPluginFiles(pluginDir) {
+    const files = [];
+    try {
+        for await (const fullPath of walkFiles(pluginDir)) {
+            const relativePath = relative(pluginDir, fullPath);
+            // Skip junk files (e.g., .DS_Store, Thumbs.db)
+            const pathParts = relativePath.split('/');
+            if (pathParts.some(part => isJunk(part))) {
+                continue;
+            }
+            // Skip git metadata
+            if (relativePath.startsWith('.git/') || relativePath === '.git') {
+                continue;
+            }
+            // Skip .claude-plugin directory (plugin metadata, not needed in workspace)
+            if (relativePath.startsWith(`${DIR_PATTERNS.CLAUDE_PLUGIN}/`)) {
+                continue;
+            }
+            const content = await readTextFile(fullPath);
+            files.push({
+                path: relativePath,
+                content,
+                encoding: 'utf8'
+            });
+        }
+        return files;
+    }
+    catch (error) {
+        throw new ValidationError(`Failed to extract files from plugin directory ${pluginDir}: ${error}`);
+    }
+}
+//# sourceMappingURL=plugin-transformer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-transformer.js","sourceRoot":"","sources":["../../../src/core/install/plugin-transformer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,QAAQ,EAAE,MAAM,MAAM,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAA6B,MAAM,+BAA+B,CAAC;AAGjG;;;GAGG;AACH,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAA8B,CAAC;AAErE;;GAEG;AACH,SAAS,sBAAsB,CAAC,GAAY,EAAE,OAAa;IACzD,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC3D,MAAM,MAAM,GAAuB,OAAO;QACxC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE;QAC3B,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,qBAAqB,CAAC,eAAe,EAAE,GAAG,CAAC,EAAE,CAAC;IAC3E,sBAAsB,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,OAAe;IAChE,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC;IACjC,OAAO,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAaD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,SAAiB,EACjB,OAAgC;IAEhC,gEAAgE;IAChE,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,SAAS,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;IACnF,MAAM,cAAc,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAEzC,qDAAqD;IACrD,+DAA+D;IAC/D,MAAM,WAAW,GAAG,yBAAyB,CAAC;QAC5C,MAAM,EAAE,OAAO,EAAE,MAAM;QACvB,IAAI,EAAE,OAAO,EAAE,IAAI;QACnB,YAAY,EAAE,OAAO,EAAE,YAAY;QACnC,WAAW,EAAE,cAAc,CAAC,IAAI;QAChC,QAAQ,EAAE,OAAO,EAAE,QAAQ;KAC5B,CAAC,CAAC;IAEH,oCAAoC;IACpC,MAAM,QAAQ,GAAe;QAC3B,IAAI,EAAE,WAAW;QACjB,4EAA4E;QAC5E,uCAAuC;QACvC,gDAAgD;QAChD,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,OAAO;QAClD,WAAW,EAAE,cAAc,CAAC,WAAW;QACvC,QAAQ,EAAE,cAAc,CAAC,QAAQ;QACjC,OAAO,EAAE,cAAc,CAAC,OAAO;QAC/B,QAAQ,EAAE,cAAc,CAAC,QAAQ;KAClC,CAAC;IAEF,sBAAsB;IACtB,IAAI,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QAChC,QAAQ,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC;IAC/C,CAAC;IAED,2DAA2D;IAC3D,IAAI,cAAc,CAAC,UAAU,EAAE,CAAC;QAC9B,IAAI,OAAO,cAAc,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAClD,QAAQ,CAAC,UAAU,GAAG;gBACpB,IAAI,EAAE,KAAK;gBACX,GAAG,EAAE,cAAc,CAAC,UAAU;aAC/B,CAAC;QACJ,CAAC;aAAM,IAAI,cAAc,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;YACzC,QAAQ,CAAC,UAAU,GAAG;gBACpB,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,IAAI,IAAI,KAAK;gBAC7C,GAAG,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG;aACnC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAElD,wBAAwB;IACxB,0EAA0E;IAC1E,kEAAkE;IAClE,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAE1C,MAAM,GAAG,GAAY;QACnB,QAAQ;QACR,KAAK;QACL,kDAAkD;QAClD,OAAO,EAAE,MAAM;KAChB,CAAC;IAEF,8CAA8C;IAC9C,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,eAAe,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAEpF,gEAAgE;IAChE,sBAAsB,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IAE/C,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE;QAC5C,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,SAAS,EAAE,KAAK,CAAC,MAAM;QACvB,MAAM,EAAE,MAAM,CAAC,IAAI;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;AACtD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,KAAK,UAAU,kBAAkB,CAAC,SAAiB;IACjD,MAAM,KAAK,GAAkB,EAAE,CAAC;IAEhC,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,QAAQ,IAAI,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;YAClD,MAAM,YAAY,GAAG,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAEnD,+CAA+C;YAC/C,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1C,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBACzC,SAAS;YACX,CAAC;YAED,oBAAoB;YACpB,IAAI,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;gBAChE,SAAS;YACX,CAAC;YAED,2EAA2E;YAC3E,IAAI,YAAY,CAAC,UAAU,CAAC,GAAG,YAAY,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;gBAC9D,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,KAAK,CAAC;IAEf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,eAAe,CACvB,iDAAiD,SAAS,KAAK,KAAK,EAAE,CACvE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/packages/core/dist/core/install/preprocessing/base-resolver.d.ts

@@ -0,0 +1,61 @@
+import type { InstallationContext } from '../unified/context.js';
+import type { LoadedPackage } from '../sources/base.js';
+export interface ResourceScopingResult {
+    /** Relative path from the base to the resource. Empty string means resource IS the base. */
+    relPath: string;
+    /** Whether the resource path is a directory on disk. */
+    isDirectory: boolean;
+    /** The computed glob pattern for file matching (e.g. "**", "dir/**", or "file.ts"). */
+    pattern: string;
+}
+export interface ResolveResourceScopingOptions {
+    /**
+     * When true, throws ValidationError if the resource path does not exist on disk.
+     * When false (default), a missing path is treated as a file (isDirectory = false).
+     */
+    strict?: boolean;
+}
+/**
+ * Core computation: resolve a resource path relative to a package base and produce a match pattern.
+ *
+ * This is the single source of truth for the path-math shared by both
+ * `computePathScoping()` (direct installs) and the installation planner (recursive installs).
+ *
+ * @returns A ResourceScopingResult, or `null` if the resource path is outside the base.
+ */
+export declare function resolveResourceScoping(repoRoot: string, baseAbs: string, resourcePath: string, options?: ResolveResourceScopingOptions): Promise<ResourceScopingResult | null>;
+export type SpecialHandling = 'marketplace' | 'ambiguous';
+export interface AmbiguousBaseMatch {
+    pattern: string;
+    base: string;
+    startIndex: number;
+}
+export interface ApplyBaseDetectionResult {
+    specialHandling?: SpecialHandling;
+    ambiguousMatches?: AmbiguousBaseMatch[];
+}
+/**
+ * Apply base detection results from a loader into an InstallationContext.
+ *
+ * This centralizes logic that used to be duplicated in strategies and the
+ * pipeline load phase.
+ *
+ * Includes state tracking to prevent redundant application when called
+ * multiple times (e.g., in strategy preprocessing and load phase).
+ */
+export declare function applyBaseDetection(ctx: InstallationContext, loaded: LoadedPackage): ApplyBaseDetectionResult;
+/**
+ * Compute resource path scoping for installs targeting a concrete resource.
+ *
+ * Updates ctx.matchedPattern to scope the install to the specified resourcePath.
+ *
+ * Includes state tracking to prevent redundant computation when called
+ * multiple times (e.g., in strategy preprocessing and load phase).
+ *
+ * Rules:
+ * - If resource resolves to a directory, pattern becomes `<dir>/**`
+ * - If resource resolves to a file, pattern becomes `<file>`
+ * - If the resource cannot be stat'ed or is outside the detected base, throws ValidationError.
+ */
+export declare function computePathScoping(ctx: InstallationContext, loaded: LoadedPackage, resourcePath: string): Promise<void>;
+//# sourceMappingURL=base-resolver.d.ts.map

package/packages/core/dist/core/install/preprocessing/base-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-resolver.d.ts","sourceRoot":"","sources":["../../../../src/core/install/preprocessing/base-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMxD,MAAM,WAAW,qBAAqB;IACpC,4FAA4F;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,WAAW,EAAE,OAAO,CAAC;IACrB,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,6BAA6B,GACtC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CA+BvC;AAED,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,WAAW,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,gBAAgB,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACzC;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,mBAAmB,EACxB,MAAM,EAAE,aAAa,GACpB,wBAAwB,CA2D1B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,mBAAmB,EACxB,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CA8Bf"}

package/packages/core/dist/core/install/preprocessing/base-resolver.js

@@ -0,0 +1,135 @@
+import { join, relative } from 'path';
+import { stat } from 'fs/promises';
+import { logger } from '../../../utils/logger.js';
+import { ValidationError } from '../../../utils/errors.js';
+/**
+ * Core computation: resolve a resource path relative to a package base and produce a match pattern.
+ *
+ * This is the single source of truth for the path-math shared by both
+ * `computePathScoping()` (direct installs) and the installation planner (recursive installs).
+ *
+ * @returns A ResourceScopingResult, or `null` if the resource path is outside the base.
+ */
+export async function resolveResourceScoping(repoRoot, baseAbs, resourcePath, options) {
+    const absResourcePath = join(repoRoot, resourcePath);
+    const rawRel = relative(baseAbs, absResourcePath).replace(/\\/g, '/');
+    // Resource is outside the detected base — caller decides how to handle.
+    if (rawRel.startsWith('..')) {
+        return null;
+    }
+    // Strip cosmetic "./" prefix (when resource is at the same level as base).
+    const relToBaseRaw = rawRel.replace(/^\.\/?/, '');
+    let isDirectory = false;
+    try {
+        const s = await stat(absResourcePath);
+        isDirectory = s.isDirectory();
+    }
+    catch {
+        if (options?.strict) {
+            throw new ValidationError(`The specified resource path does not exist in the repository: ${resourcePath}\n\n` +
+                `Please verify the path. The file or directory may have been moved, or you may have meant a different path.`);
+        }
+        // Non-strict: best-effort, default to file
+    }
+    // When relToBaseRaw is "" the resource IS the base directory → pattern "**"
+    const prefix = relToBaseRaw.replace(/\/$/, '');
+    const pattern = isDirectory ? (prefix ? `${prefix}/**` : '**') : relToBaseRaw;
+    return { relPath: relToBaseRaw, isDirectory, pattern };
+}
+/**
+ * Apply base detection results from a loader into an InstallationContext.
+ *
+ * This centralizes logic that used to be duplicated in strategies and the
+ * pipeline load phase.
+ *
+ * Includes state tracking to prevent redundant application when called
+ * multiple times (e.g., in strategy preprocessing and load phase).
+ */
+export function applyBaseDetection(ctx, loaded) {
+    const baseDetection = loaded.sourceMetadata?.baseDetection;
+    if (!baseDetection) {
+        return {};
+    }
+    // Check if base detection has already been applied
+    if (ctx.source._baseDetectionPerformed) {
+        logger.debug('Base detection already applied, skipping redundant application');
+        return {};
+    }
+    // If loaders already detected marketplace, surface it for orchestrator routing.
+    if (loaded.pluginMetadata?.pluginType === 'marketplace') {
+        ctx.source._baseDetectionPerformed = true;
+        return { specialHandling: 'marketplace' };
+    }
+    if (baseDetection?.base) {
+        ctx.detectedBase = baseDetection.base;
+        // Keep source.detectedBase in sync
+        ctx.source.detectedBase = baseDetection.base;
+    }
+    if (baseDetection?.matchedPattern && !ctx.matchedPattern) {
+        ctx.matchedPattern = baseDetection.matchedPattern;
+    }
+    if (baseDetection?.matchType) {
+        ctx.baseSource = baseDetection.matchType;
+    }
+    // Keep source contentRoot aligned with detected base (resource model).
+    const effectiveContentRoot = ctx.detectedBase || loaded.contentRoot;
+    if (effectiveContentRoot) {
+        ctx.source.contentRoot = effectiveContentRoot;
+    }
+    // Compute baseRelative when repoRoot is available.
+    const repoRoot = loaded.sourceMetadata?.repoPath;
+    if (!ctx.baseRelative && repoRoot && ctx.detectedBase) {
+        ctx.baseRelative = relative(repoRoot, ctx.detectedBase) || '.';
+    }
+    else if (!ctx.baseRelative && loaded.contentRoot && ctx.detectedBase) {
+        // Fallback (less ideal if contentRoot already equals detectedBase).
+        ctx.baseRelative = relative(loaded.contentRoot, ctx.detectedBase) || '.';
+    }
+    // Mark as performed
+    ctx.source._baseDetectionPerformed = true;
+    if (baseDetection?.matchType === 'marketplace') {
+        return { specialHandling: 'marketplace' };
+    }
+    if (baseDetection?.matchType === 'ambiguous' && Array.isArray(baseDetection.ambiguousMatches)) {
+        return { specialHandling: 'ambiguous', ambiguousMatches: baseDetection.ambiguousMatches };
+    }
+    return {};
+}
+/**
+ * Compute resource path scoping for installs targeting a concrete resource.
+ *
+ * Updates ctx.matchedPattern to scope the install to the specified resourcePath.
+ *
+ * Includes state tracking to prevent redundant computation when called
+ * multiple times (e.g., in strategy preprocessing and load phase).
+ *
+ * Rules:
+ * - If resource resolves to a directory, pattern becomes `<dir>/**`
+ * - If resource resolves to a file, pattern becomes `<file>`
+ * - If the resource cannot be stat'ed or is outside the detected base, throws ValidationError.
+ */
+export async function computePathScoping(ctx, loaded, resourcePath) {
+    // Check if path scoping has already been computed
+    if (ctx._pathScopingPerformed) {
+        logger.debug('Path scoping already computed, skipping redundant computation');
+        return;
+    }
+    const repoRoot = loaded.sourceMetadata?.repoPath || loaded.contentRoot;
+    if (!repoRoot) {
+        return;
+    }
+    const baseAbs = ctx.detectedBase || loaded.contentRoot;
+    if (!baseAbs) {
+        return;
+    }
+    const result = await resolveResourceScoping(repoRoot, baseAbs, resourcePath, { strict: true });
+    if (!result) {
+        // Path is outside the detected package base - invalid for single-file install
+        throw new ValidationError(`The specified resource path is outside the package base: ${resourcePath}\n\n` +
+            `Please verify the path is within the package you are installing.`);
+    }
+    ctx.matchedPattern = result.pattern;
+    // Mark as performed
+    ctx._pathScopingPerformed = true;
+}
+//# sourceMappingURL=base-resolver.js.map

package/packages/core/dist/core/install/preprocessing/base-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-resolver.js","sourceRoot":"","sources":["../../../../src/core/install/preprocessing/base-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAmB3D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAgB,EAChB,OAAe,EACf,YAAoB,EACpB,OAAuC;IAEvC,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEtE,wEAAwE;IACxE,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2EAA2E;IAC3E,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAElD,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,CAAC;QACtC,WAAW,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,eAAe,CACvB,iEAAiE,YAAY,MAAM;gBACnF,4GAA4G,CAC7G,CAAC;QACJ,CAAC;QACD,2CAA2C;IAC7C,CAAC;IAED,4EAA4E;IAC5E,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IAE9E,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AACzD,CAAC;AAeD;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAwB,EACxB,MAAqB;IAErB,MAAM,aAAa,GAAQ,MAAM,CAAC,cAAc,EAAE,aAAa,CAAC;IAChE,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,mDAAmD;IACnD,IAAI,GAAG,CAAC,MAAM,CAAC,uBAAuB,EAAE,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;QAC/E,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,gFAAgF;IAChF,IAAI,MAAM,CAAC,cAAc,EAAE,UAAU,KAAK,aAAa,EAAE,CAAC;QACxD,GAAG,CAAC,MAAM,CAAC,uBAAuB,GAAG,IAAI,CAAC;QAC1C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC;IAC5C,CAAC;IAED,IAAI,aAAa,EAAE,IAAI,EAAE,CAAC;QACxB,GAAG,CAAC,YAAY,GAAG,aAAa,CAAC,IAAI,CAAC;QACtC,mCAAmC;QACnC,GAAG,CAAC,MAAM,CAAC,YAAY,GAAG,aAAa,CAAC,IAAI,CAAC;IAC/C,CAAC;IAED,IAAI,aAAa,EAAE,cAAc,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QACzD,GAAG,CAAC,cAAc,GAAG,aAAa,CAAC,cAAc,CAAC;IACpD,CAAC;IAED,IAAI,aAAa,EAAE,SAAS,EAAE,CAAC;QAC7B,GAAG,CAAC,UAAU,GAAG,aAAa,CAAC,SAAgB,CAAC;IAClD,CAAC;IAED,uEAAuE;IACvE,MAAM,oBAAoB,GAAG,GAAG,CAAC,YAAY,IAAI,MAAM,CAAC,WAAW,CAAC;IACpE,IAAI,oBAAoB,EAAE,CAAC;QACzB,GAAG,CAAC,MAAM,CAAC,WAAW,GAAG,oBAAoB,CAAC;IAChD,CAAC;IAED,mDAAmD;IACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC;IACjD,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,QAAQ,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QACtD,GAAG,CAAC,YAAY,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC;IACjE,CAAC;SAAM,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,MAAM,CAAC,WAAW,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QACvE,oEAAoE;QACpE,GAAG,CAAC,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC;IAC3E,CAAC;IAED,oBAAoB;IACpB,GAAG,CAAC,MAAM,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAE1C,IAAI,aAAa,EAAE,SAAS,KAAK,aAAa,EAAE,CAAC;QAC/C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC;IAC5C,CAAC;IAED,IAAI,aAAa,EAAE,SAAS,KAAK,WAAW,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC9F,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,CAAC,gBAAgB,EAAE,CAAC;IAC5F,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAwB,EACxB,MAAqB,EACrB,YAAoB;IAEpB,kDAAkD;IAClD,IAAI,GAAG,CAAC,qBAAqB,EAAE,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;QAC9E,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,EAAE,QAAQ,IAAI,MAAM,CAAC,WAAW,CAAC;IACvE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,IAAI,MAAM,CAAC,WAAW,CAAC;IACvD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/F,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,8EAA8E;QAC9E,MAAM,IAAI,eAAe,CACvB,4DAA4D,YAAY,MAAM;YAC9E,kEAAkE,CACnE,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC;IAEpC,oBAAoB;IACpB,GAAG,CAAC,qBAAqB,GAAG,IAAI,CAAC;AACnC,CAAC"}

package/packages/core/dist/core/install/preprocessing/convenience-preprocessor.d.ts

@@ -0,0 +1,11 @@
+import type { ConvenienceFilterOptions, ResourceInstallationSpec } from '../convenience-matchers.js';
+/**
+ * Resolve convenience resources (agents/skills) to install.
+ *
+ * This centralizes user-facing error display and "continue with partial matches"
+ * behavior so strategies/handlers don't duplicate it.
+ *
+ * @throws Error if none of the requested resources can be found.
+ */
+export declare function resolveConvenienceResources(basePath: string, repoRoot: string, options: ConvenienceFilterOptions): Promise<ResourceInstallationSpec[]>;
+//# sourceMappingURL=convenience-preprocessor.d.ts.map

package/packages/core/dist/core/install/preprocessing/convenience-preprocessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convenience-preprocessor.d.ts","sourceRoot":"","sources":["../../../../src/core/install/preprocessing/convenience-preprocessor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAIrG;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAcrC"}

package/packages/core/dist/core/install/preprocessing/convenience-preprocessor.js

@@ -0,0 +1,22 @@
+import { applyConvenienceFilters, displayFilterErrors } from '../convenience-matchers.js';
+import { logger } from '../../../utils/logger.js';
+/**
+ * Resolve convenience resources (agents/skills) to install.
+ *
+ * This centralizes user-facing error display and "continue with partial matches"
+ * behavior so strategies/handlers don't duplicate it.
+ *
+ * @throws Error if none of the requested resources can be found.
+ */
+export async function resolveConvenienceResources(basePath, repoRoot, options) {
+    const filterResult = await applyConvenienceFilters(basePath, repoRoot, options);
+    if (filterResult.errors.length > 0) {
+        displayFilterErrors(filterResult.errors);
+        if (filterResult.resources.length === 0) {
+            throw new Error('None of the requested resources were found');
+        }
+        logger.debug(`Continuing with ${filterResult.resources.length} resource(s)`);
+    }
+    return filterResult.resources;
+}
+//# sourceMappingURL=convenience-preprocessor.js.map

package/packages/core/dist/core/install/preprocessing/convenience-preprocessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convenience-preprocessor.js","sourceRoot":"","sources":["../../../../src/core/install/preprocessing/convenience-preprocessor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,QAAgB,EAChB,QAAgB,EAChB,OAAiC;IAEjC,MAAM,YAAY,GAAG,MAAM,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEhF,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,mBAAmB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAEzC,IAAI,YAAY,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,mBAAmB,YAAY,CAAC,SAAS,CAAC,MAAM,cAAc,CAAC,CAAC;IAC/E,CAAC;IAED,OAAO,YAAY,CAAC,SAAS,CAAC;AAChC,CAAC"}

package/packages/core/dist/core/install/preprocessing/index.d.ts

@@ -0,0 +1,6 @@
+export { normalizePluginsOption, normalizeInstallOptions } from './options-normalizer.js';
+export { classifyInput } from './input-classifier.js';
+export { applyBaseDetection, computePathScoping, resolveResourceScoping } from './base-resolver.js';
+export type { ResourceScopingResult, ResolveResourceScopingOptions } from './base-resolver.js';
+export { resolveConvenienceResources } from './convenience-preprocessor.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/core/dist/core/install/preprocessing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/install/preprocessing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACpG,YAAY,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AAC/F,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC"}

package/packages/core/dist/core/install/preprocessing/index.js

@@ -0,0 +1,5 @@
+export { normalizePluginsOption, normalizeInstallOptions } from './options-normalizer.js';
+export { classifyInput } from './input-classifier.js';
+export { applyBaseDetection, computePathScoping, resolveResourceScoping } from './base-resolver.js';
+export { resolveConvenienceResources } from './convenience-preprocessor.js';
+//# sourceMappingURL=index.js.map

package/packages/core/dist/core/install/preprocessing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/install/preprocessing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEpG,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC"}

package/packages/core/dist/core/install/preprocessing/input-classifier.d.ts

@@ -0,0 +1,21 @@
+import type { InputClassification } from '../orchestrator/types.js';
+import type { InstallOptions, ExecutionContext } from '../../../types/index.js';
+/**
+ * Classify package input for routing to appropriate install strategy.
+ *
+ * Uses the shared base classifier and enriches results with install-specific features:
+ * - Convenience filters (--agents, --skills, --rules, --commands)
+ * - Resource path tracking for selective installation
+ *
+ * @param input - Raw user input (undefined for bulk install)
+ * @param options - Install options (to check for convenience filters)
+ * @param execContext - Execution context (uses sourceCwd for resolving inputs)
+ * @returns Unified input classification with install features
+ */
+export declare function classifyInput(input: string | undefined, options: InstallOptions & {
+    agents?: string[];
+    skills?: string[];
+    rules?: string[];
+    commands?: string[];
+}, execContext: ExecutionContext): Promise<InputClassification>;
+//# sourceMappingURL=input-classifier.d.ts.map

package/packages/core/dist/core/install/preprocessing/input-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-classifier.d.ts","sourceRoot":"","sources":["../../../../src/core/install/preprocessing/input-classifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,0BAA0B,CAAC;AACnF,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhF;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,EAAE,cAAc,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,EACzG,WAAW,EAAE,gBAAgB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAc9B"}

package/packages/core/dist/core/install/preprocessing/input-classifier.js

@@ -0,0 +1,66 @@
+import { classifyInputBase } from '../input-classifier-base.js';
+/**
+ * Classify package input for routing to appropriate install strategy.
+ *
+ * Uses the shared base classifier and enriches results with install-specific features:
+ * - Convenience filters (--agents, --skills, --rules, --commands)
+ * - Resource path tracking for selective installation
+ *
+ * @param input - Raw user input (undefined for bulk install)
+ * @param options - Install options (to check for convenience filters)
+ * @param execContext - Execution context (uses sourceCwd for resolving inputs)
+ * @returns Unified input classification with install features
+ */
+export async function classifyInput(input, options, execContext) {
+    // Detect convenience filters
+    const hasConvenienceFilters = !!(options.agents?.length ||
+        options.skills?.length ||
+        options.rules?.length ||
+        options.commands?.length);
+    // Use base classifier
+    const base = await classifyInputBase(input, execContext.sourceCwd);
+    // Convert to install-specific classification with features
+    return enrichWithInstallFeatures(base, hasConvenienceFilters);
+}
+/**
+ * Enrich base classification with install-specific features
+ */
+function enrichWithInstallFeatures(base, hasConvenienceFilters) {
+    const features = {
+        hasConvenienceFilters,
+        hasResourcePath: false
+    };
+    switch (base.type) {
+        case 'bulk':
+            return { type: 'bulk', features };
+        case 'git':
+            return {
+                type: 'git',
+                gitUrl: base.gitUrl,
+                gitRef: base.gitRef,
+                resourcePath: base.gitPath,
+                features: {
+                    ...features,
+                    hasResourcePath: !!base.gitPath
+                }
+            };
+        case 'local-path':
+            return {
+                type: 'path',
+                localPath: base.absolutePath,
+                features
+            };
+        case 'registry':
+            return {
+                type: 'registry',
+                packageName: base.packageName,
+                version: base.version,
+                resourcePath: base.registryPath,
+                features: {
+                    ...features,
+                    hasResourcePath: !!base.registryPath
+                }
+            };
+    }
+}
+//# sourceMappingURL=input-classifier.js.map

package/packages/core/dist/core/install/preprocessing/input-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-classifier.js","sourceRoot":"","sources":["../../../../src/core/install/preprocessing/input-classifier.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAgC,MAAM,6BAA6B,CAAC;AAE9F;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAyB,EACzB,OAAyG,EACzG,WAA6B;IAE7B,6BAA6B;IAC7B,MAAM,qBAAqB,GAAG,CAAC,CAAC,CAC9B,OAAO,CAAC,MAAM,EAAE,MAAM;QACtB,OAAO,CAAC,MAAM,EAAE,MAAM;QACtB,OAAO,CAAC,KAAK,EAAE,MAAM;QACrB,OAAO,CAAC,QAAQ,EAAE,MAAM,CACzB,CAAC;IAEF,sBAAsB;IACtB,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IAEnE,2DAA2D;IAC3D,OAAO,yBAAyB,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAChC,IAA6B,EAC7B,qBAA8B;IAE9B,MAAM,QAAQ,GAAkB;QAC9B,qBAAqB;QACrB,eAAe,EAAE,KAAK;KACvB,CAAC;IAEF,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAEpC,KAAK,KAAK;YACR,OAAO;gBACL,IAAI,EAAE,KAAK;gBACX,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,YAAY,EAAE,IAAI,CAAC,OAAO;gBAC1B,QAAQ,EAAE;oBACR,GAAG,QAAQ;oBACX,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO;iBAChC;aACF,CAAC;QAEJ,KAAK,YAAY;YACf,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,IAAI,CAAC,YAAY;gBAC5B,QAAQ;aACT,CAAC;QAEJ,KAAK,UAAU;YACb,OAAO;gBACL,IAAI,EAAE,UAAU;gBAChB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,QAAQ,EAAE;oBACR,GAAG,QAAQ;oBACX,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY;iBACrC;aACF,CAAC;IACN,CAAC;AACH,CAAC"}

package/packages/core/dist/core/install/preprocessing/options-normalizer.d.ts

@@ -0,0 +1,19 @@
+import type { InstallOptions } from '../../../types/index.js';
+import type { NormalizedInstallOptions } from '../orchestrator/types.js';
+/**
+ * Normalize --plugins option by deduplicating.
+ */
+export declare function normalizePluginsOption(value: string[] | undefined): string[] | undefined;
+/**
+ * Normalize all install options at CLI boundary.
+ * This creates immutable, properly typed options for the install flow.
+ */
+export declare function normalizeInstallOptions(options: InstallOptions & {
+    conflicts?: string;
+    agents?: string[];
+    skills?: string[];
+    rules?: string[];
+    commands?: string[];
+    interactive?: boolean;
+}): NormalizedInstallOptions;
+//# sourceMappingURL=options-normalizer.d.ts.map

package/packages/core/dist/core/install/preprocessing/options-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-normalizer.d.ts","sourceRoot":"","sources":["../../../../src/core/install/preprocessing/options-normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAKzE;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CAMxF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,cAAc,GAAG;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACA,wBAAwB,CA0B1B"}

package/packages/core/dist/core/install/preprocessing/options-normalizer.js

@@ -0,0 +1,41 @@
+import { normalizePlatforms } from '../../platform/platform-mapper.js';
+import { determineResolutionMode } from '../../../utils/resolution-mode.js';
+import { validateConflictStrategy } from '../validators/options-validator.js';
+/**
+ * Normalize --plugins option by deduplicating.
+ */
+export function normalizePluginsOption(value) {
+    if (!value || value.length === 0) {
+        return undefined;
+    }
+    const plugins = [...new Set(value)];
+    return plugins.length > 0 ? plugins : undefined;
+}
+/**
+ * Normalize all install options at CLI boundary.
+ * This creates immutable, properly typed options for the install flow.
+ */
+export function normalizeInstallOptions(options) {
+    // Normalize platforms
+    const platforms = normalizePlatforms(options.platforms);
+    // Normalize plugins
+    const plugins = normalizePluginsOption(options.plugins);
+    // Normalize and validate conflict strategy
+    const rawConflictStrategy = options.conflicts ?? options.conflictStrategy;
+    const conflictStrategy = validateConflictStrategy(rawConflictStrategy) ?? 'namespace';
+    // Determine resolution mode
+    const resolutionMode = determineResolutionMode(options);
+    return {
+        ...options,
+        platforms,
+        plugins,
+        conflictStrategy,
+        resolutionMode,
+        agents: options.agents,
+        skills: options.skills,
+        rules: options.rules,
+        commands: options.commands,
+        interactive: options.interactive,
+    };
+}
+//# sourceMappingURL=options-normalizer.js.map

package/packages/core/dist/core/install/preprocessing/options-normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-normalizer.js","sourceRoot":"","sources":["../../../../src/core/install/preprocessing/options-normalizer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAE9E;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAA2B;IAChE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACpC,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAOC;IAED,sBAAsB;IACtB,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAExD,oBAAoB;IACpB,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAExD,2CAA2C;IAC3C,MAAM,mBAAmB,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAC1E,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,mBAAmB,CAAC,IAAI,WAAW,CAAC;IAEtF,4BAA4B;IAC5B,MAAM,cAAc,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAExD,OAAO;QACL,GAAG,OAAO;QACV,SAAS;QACT,OAAO;QACP,gBAAgB;QAChB,cAAc;QACd,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC;AACJ,CAAC"}