opkg 0.9.0 → 0.9.2

package/packages/core/dist/core/install/strategies/helpers/platform-filtering.js

@@ -0,0 +1,53 @@
+/**
+ * Platform Filtering Helpers Module
+ *
+ * Utilities for filtering source files based on platform specificity.
+ */
+import { basename } from 'path';
+import { buildOverrideMap, shouldSkipUniversalFile, isPlatformSpecificFileForTarget } from '../../../flows/platform-suffix-handler.js';
+import { isPlatformId } from '../../../platforms.js';
+/**
+ * Filter flow sources by platform, removing files not applicable to target platform
+ *
+ * @param flowSources - Map of flows to source file paths
+ * @param platform - Target platform
+ * @returns Filtered map with only applicable sources
+ */
+export function filterSourcesByPlatform(flowSources, platform) {
+    const filtered = new Map();
+    // Build override map once for all sources
+    const allSources = [];
+    for (const sources of flowSources.values()) {
+        allSources.push(...sources);
+    }
+    const overrideMap = buildOverrideMap(allSources);
+    for (const [flow, sources] of flowSources) {
+        const filteredSourcesForFlow = [];
+        for (const sourceRel of sources) {
+            // Skip platform-specific files not for this platform
+            if (!isPlatformSpecificFileForTarget(sourceRel, platform) &&
+                sourceRel.includes('.') &&
+                sourceRel.split('.').length >= 3) {
+                const parts = basename(sourceRel).split('.');
+                const possiblePlatform = parts[parts.length - 2];
+                if (possiblePlatform !== platform && isPlatformId(possiblePlatform)) {
+                    continue;
+                }
+            }
+            // Skip universal files with platform overrides
+            if (shouldSkipUniversalFile(sourceRel, platform, allSources, overrideMap)) {
+                continue;
+            }
+            filteredSourcesForFlow.push(sourceRel);
+        }
+        if (filteredSourcesForFlow.length > 0) {
+            filtered.set(flow, filteredSourcesForFlow);
+        }
+    }
+    return filtered;
+}
+/**
+ * Re-export utilities for convenience
+ */
+export { buildOverrideMap, shouldSkipUniversalFile, isPlatformSpecificFileForTarget };
+//# sourceMappingURL=platform-filtering.js.map

package/packages/core/dist/core/install/strategies/helpers/platform-filtering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-filtering.js","sourceRoot":"","sources":["../../../../../src/core/install/strategies/helpers/platform-filtering.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAGhC,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,+BAA+B,EAChC,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAAgC,EAChC,QAAkB;IAElB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE3C,0CAA0C;IAC1C,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,OAAO,IAAI,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;QAC3C,UAAU,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,MAAM,WAAW,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAEjD,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,WAAW,EAAE,CAAC;QAC1C,MAAM,sBAAsB,GAAa,EAAE,CAAC;QAE5C,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;YAChC,qDAAqD;YACrD,IAAI,CAAC,+BAA+B,CAAC,SAAS,EAAE,QAAQ,CAAC;gBACrD,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC;gBACvB,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC7C,MAAM,gBAAgB,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACjD,IAAI,gBAAgB,KAAK,QAAQ,IAAI,YAAY,CAAC,gBAAgB,CAAC,EAAE,CAAC;oBACpE,SAAS;gBACX,CAAC;YACH,CAAC;YAED,+CAA+C;YAC/C,IAAI,uBAAuB,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,CAAC;gBAC1E,SAAS;YACX,CAAC;YAED,sBAAsB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,sBAAsB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,+BAA+B,EAAE,CAAC"}

package/packages/core/dist/core/install/strategies/helpers/result-converter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Result Converter Module
+ *
+ * Utilities for converting execution results to installation results.
+ */
+import type { Platform } from '../../../platforms.js';
+import type { FlowInstallResult } from '../types.js';
+/**
+ * Convert execution result from flow coordinator to installation result format
+ *
+ * @param executionResult - Result from flow execution coordinator
+ * @param packageName - Name of package being installed
+ * @param platform - Target platform
+ * @param dryRun - Whether this is a dry run
+ * @returns Formatted installation result
+ */
+export declare function convertToInstallResult(executionResult: any, packageName: string, platform: Platform, dryRun: boolean): FlowInstallResult;
+/**
+ * Create an empty install result (for early returns)
+ */
+export declare function createEmptyResult(): FlowInstallResult;
+//# sourceMappingURL=result-converter.d.ts.map

package/packages/core/dist/core/install/strategies/helpers/result-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-converter.d.ts","sourceRoot":"","sources":["../../../../../src/core/install/strategies/helpers/result-converter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,GAAG,EACpB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,OAAO,GACd,iBAAiB,CA+BnB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,CAYrD"}

package/packages/core/dist/core/install/strategies/helpers/result-converter.js

@@ -0,0 +1,60 @@
+/**
+ * Result Converter Module
+ *
+ * Utilities for converting execution results to installation results.
+ */
+import { logger } from '../../../../utils/logger.js';
+/**
+ * Convert execution result from flow coordinator to installation result format
+ *
+ * @param executionResult - Result from flow execution coordinator
+ * @param packageName - Name of package being installed
+ * @param platform - Target platform
+ * @param dryRun - Whether this is a dry run
+ * @returns Formatted installation result
+ */
+export function convertToInstallResult(executionResult, packageName, platform, dryRun) {
+    const result = {
+        success: executionResult.success,
+        filesProcessed: executionResult.filesProcessed,
+        filesWritten: executionResult.filesWritten,
+        conflicts: executionResult.conflicts.map((c) => ({
+            targetPath: c.path,
+            packages: [
+                { packageName: c.winner, priority: 0, chosen: true },
+                ...c.losers.map((loser) => ({
+                    packageName: loser,
+                    priority: 0,
+                    chosen: false
+                }))
+            ],
+            message: `Conflict in ${c.path}: ${c.winner} overwrites ${c.losers.join(', ')}`
+        })),
+        errors: executionResult.errors,
+        targetPaths: executionResult.targetPaths,
+        fileMapping: executionResult.fileMapping
+    };
+    // Log results
+    if (result.filesProcessed > 0) {
+        logger.info(`Processed ${result.filesProcessed} files for ${packageName} on platform ${platform}` +
+            (dryRun ? ' (dry run)' : `, wrote ${result.filesWritten} files`));
+    }
+    return result;
+}
+/**
+ * Create an empty install result (for early returns)
+ */
+export function createEmptyResult() {
+    return {
+        success: true,
+        filesProcessed: 0,
+        filesWritten: 0,
+        conflicts: [],
+        errors: [],
+        targetPaths: [],
+        fileMapping: {},
+        namespaced: false,
+        relocatedFiles: []
+    };
+}
+//# sourceMappingURL=result-converter.js.map

package/packages/core/dist/core/install/strategies/helpers/result-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-converter.js","sourceRoot":"","sources":["../../../../../src/core/install/strategies/helpers/result-converter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAErD;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,eAAoB,EACpB,WAAmB,EACnB,QAAkB,EAClB,MAAe;IAEf,MAAM,MAAM,GAAsB;QAChC,OAAO,EAAE,eAAe,CAAC,OAAO;QAChC,cAAc,EAAE,eAAe,CAAC,cAAc;QAC9C,YAAY,EAAE,eAAe,CAAC,YAAY;QAC1C,SAAS,EAAE,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;YACpD,UAAU,EAAE,CAAC,CAAC,IAAI;YAClB,QAAQ,EAAE;gBACR,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;gBACpD,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC;oBAClC,WAAW,EAAE,KAAK;oBAClB,QAAQ,EAAE,CAAC;oBACX,MAAM,EAAE,KAAK;iBACd,CAAC,CAAC;aACJ;YACD,OAAO,EAAE,eAAe,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,eAAe,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SAChF,CAAC,CAAC;QACH,MAAM,EAAE,eAAe,CAAC,MAAM;QAC9B,WAAW,EAAE,eAAe,CAAC,WAAW;QACxC,WAAW,EAAE,eAAe,CAAC,WAAW;KACzC,CAAC;IAEF,cAAc;IACd,IAAI,MAAM,CAAC,cAAc,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CACT,aAAa,MAAM,CAAC,cAAc,cAAc,WAAW,gBAAgB,QAAQ,EAAE;YACrF,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,YAAY,QAAQ,CAAC,CACjE,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,OAAO,EAAE,IAAI;QACb,cAAc,EAAE,CAAC;QACjB,YAAY,EAAE,CAAC;QACf,SAAS,EAAE,EAAE;QACb,MAAM,EAAE,EAAE;QACV,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,EAAE;QACf,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,EAAE;KACnB,CAAC;AACJ,CAAC"}

package/packages/core/dist/core/install/strategies/helpers/temp-directory.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Temp Directory Helpers Module
+ *
+ * Utilities for managing temporary directories during package conversion.
+ */
+import type { PackageConversionContext } from '../../../../types/conversion-context.js';
+/**
+ * Create a temporary directory for package conversion
+ *
+ * @param prefix - Prefix for temp directory name
+ * @returns Absolute path to created temp directory
+ */
+export declare function createTempPackageDirectory(prefix?: string): Promise<string>;
+/**
+ * Create a conversion cache directory within git cache location.
+ * This stores converted files alongside the original git cache for reuse.
+ *
+ * @param gitCachePath - Path to git cache directory
+ * @returns Absolute path to conversion cache directory
+ */
+export declare function createConversionCacheDirectory(gitCachePath: string): Promise<string>;
+/**
+ * Write package files to temporary directory
+ *
+ * @param files - Array of files to write
+ * @param tempDir - Temporary directory path
+ */
+export declare function writeTempPackageFiles(files: Array<{
+    path: string;
+    content: string;
+}>, tempDir: string): Promise<void>;
+/**
+ * Write conversion context to temporary directory
+ *
+ * @param context - Conversion context to write
+ * @param tempDir - Temporary directory path
+ */
+export declare function writeConversionContext(context: PackageConversionContext, tempDir: string): Promise<void>;
+/**
+ * Cleanup temporary directory with error handling
+ *
+ * @param tempDir - Directory to cleanup
+ */
+export declare function cleanupTempDirectory(tempDir: string | null): Promise<void>;
+//# sourceMappingURL=temp-directory.d.ts.map

package/packages/core/dist/core/install/strategies/helpers/temp-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temp-directory.d.ts","sourceRoot":"","sources":["../../../../../src/core/install/strategies/helpers/temp-directory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AAGxF;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,GAAE,MAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAGpG;AAED;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAClD,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EAC/C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,wBAAwB,EACjC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAahF"}

package/packages/core/dist/core/install/strategies/helpers/temp-directory.js

@@ -0,0 +1,77 @@
+/**
+ * Temp Directory Helpers Module
+ *
+ * Utilities for managing temporary directories during package conversion.
+ */
+import { join, dirname } from 'path';
+import { mkdtemp, rm } from 'fs/promises';
+import { tmpdir } from 'os';
+import { ensureDir, writeTextFile } from '../../../../utils/fs.js';
+import { logger } from '../../../../utils/logger.js';
+import { contextToJSON } from '../../../conversion-context/index.js';
+/**
+ * Create a temporary directory for package conversion
+ *
+ * @param prefix - Prefix for temp directory name
+ * @returns Absolute path to created temp directory
+ */
+export async function createTempPackageDirectory(prefix = 'opkg-converted-') {
+    const tempDir = await mkdtemp(join(tmpdir(), prefix));
+    return tempDir;
+}
+/**
+ * Create a conversion cache directory within git cache location.
+ * This stores converted files alongside the original git cache for reuse.
+ *
+ * @param gitCachePath - Path to git cache directory
+ * @returns Absolute path to conversion cache directory
+ */
+export async function createConversionCacheDirectory(gitCachePath) {
+    const conversionDir = join(gitCachePath, '.opkg-converted');
+    await ensureDir(conversionDir);
+    return conversionDir;
+}
+/**
+ * Write package files to temporary directory
+ *
+ * @param files - Array of files to write
+ * @param tempDir - Temporary directory path
+ */
+export async function writeTempPackageFiles(files, tempDir) {
+    for (const file of files) {
+        const filePath = join(tempDir, file.path);
+        await ensureDir(dirname(filePath));
+        await writeTextFile(filePath, file.content);
+    }
+}
+/**
+ * Write conversion context to temporary directory
+ *
+ * @param context - Conversion context to write
+ * @param tempDir - Temporary directory path
+ */
+export async function writeConversionContext(context, tempDir) {
+    const contextPath = join(tempDir, '.opkg-conversion-context.json');
+    const contextJson = contextToJSON(context);
+    await writeTextFile(contextPath, contextJson);
+}
+/**
+ * Cleanup temporary directory with error handling
+ *
+ * @param tempDir - Directory to cleanup
+ */
+export async function cleanupTempDirectory(tempDir) {
+    if (!tempDir) {
+        return;
+    }
+    try {
+        await rm(tempDir, { recursive: true, force: true });
+    }
+    catch (error) {
+        logger.warn('Failed to cleanup temp directory', {
+            tempDir,
+            error
+        });
+    }
+}
+//# sourceMappingURL=temp-directory.js.map

package/packages/core/dist/core/install/strategies/helpers/temp-directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temp-directory.js","sourceRoot":"","sources":["../../../../../src/core/install/strategies/helpers/temp-directory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAErE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,SAAiB,iBAAiB;IACjF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,YAAoB;IAEpB,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;IAC5D,MAAM,SAAS,CAAC,aAAa,CAAC,CAAC;IAC/B,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAA+C,EAC/C,OAAe;IAEf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnC,MAAM,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAiC,EACjC,OAAe;IAEf,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,+BAA+B,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,aAAa,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAsB;IAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE;YAC9C,OAAO;YACP,KAAK;SACN,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * Installation Strategies Module
+ *
+ * Public API for installation strategies.
+ *
+ * Exports:
+ * - selectInstallStrategy: Main function for selecting appropriate strategy
+ * - Strategy classes: For testing and advanced usage
+ * - Types: Shared interfaces for strategy implementations
+ */
+export { selectInstallStrategy } from './strategy-selector.js';
+export type { FlowInstallContext, FlowInstallResult, FlowConflictReport, FlowInstallError, InstallationStrategy } from './types.js';
+export { ConversionInstallStrategy } from './conversion-strategy.js';
+export { FlowBasedInstallStrategy } from './flow-based-strategy.js';
+export { BaseStrategy } from './base-strategy.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/install/strategies/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAGpE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * Installation Strategies Module
+ *
+ * Public API for installation strategies.
+ *
+ * Exports:
+ * - selectInstallStrategy: Main function for selecting appropriate strategy
+ * - Strategy classes: For testing and advanced usage
+ * - Types: Shared interfaces for strategy implementations
+ */
+// Main selector function
+export { selectInstallStrategy } from './strategy-selector.js';
+// Strategy implementations (exported for testing/advanced usage)
+export { ConversionInstallStrategy } from './conversion-strategy.js';
+export { FlowBasedInstallStrategy } from './flow-based-strategy.js';
+// Base class (exported for extensibility)
+export { BaseStrategy } from './base-strategy.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/install/strategies/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,yBAAyB;AACzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAW/D,iEAAiE;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,0CAA0C;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/packages/core/dist/core/install/strategies/strategy-selector.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Strategy Selector Module
+ *
+ * Selects the appropriate installation strategy based on package format and target platform.
+ */
+import type { InstallOptions } from '../../../types/index.js';
+import type { FlowInstallContext, InstallationStrategy } from './types.js';
+/**
+ * Select the appropriate installation strategy based on package format and platform
+ *
+ * Strategy selection:
+ * 1. ConversionInstallStrategy - Cross-platform conversion required (source ≠ target)
+ * 2. FlowBasedInstallStrategy - Default for all other cases (universal or same-platform)
+ *
+ * @param context - Installation context with package metadata
+ * @param options - Installation options
+ * @returns Selected installation strategy
+ */
+export declare function selectInstallStrategy(context: FlowInstallContext, options?: InstallOptions): InstallationStrategy;
+//# sourceMappingURL=strategy-selector.d.ts.map

package/packages/core/dist/core/install/strategies/strategy-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-selector.d.ts","sourceRoot":"","sources":["../../../../src/core/install/strategies/strategy-selector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAK3E;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,oBAAoB,CAgBtB"}

package/packages/core/dist/core/install/strategies/strategy-selector.js

@@ -0,0 +1,34 @@
+/**
+ * Strategy Selector Module
+ *
+ * Selects the appropriate installation strategy based on package format and target platform.
+ */
+import { ConversionInstallStrategy } from './conversion-strategy.js';
+import { FlowBasedInstallStrategy } from './flow-based-strategy.js';
+import { needsConversion } from '../format-detector.js';
+/**
+ * Select the appropriate installation strategy based on package format and platform
+ *
+ * Strategy selection:
+ * 1. ConversionInstallStrategy - Cross-platform conversion required (source ≠ target)
+ * 2. FlowBasedInstallStrategy - Default for all other cases (universal or same-platform)
+ *
+ * @param context - Installation context with package metadata
+ * @param options - Installation options
+ * @returns Selected installation strategy
+ */
+export function selectInstallStrategy(context, options) {
+    const format = context.packageFormat;
+    const platform = context.platform;
+    // If no format provided, default to flow-based strategy
+    if (!format) {
+        return new FlowBasedInstallStrategy();
+    }
+    // Check if conversion is needed
+    if (needsConversion(format, platform)) {
+        return new ConversionInstallStrategy();
+    }
+    // Default: flow-based strategy
+    return new FlowBasedInstallStrategy();
+}
+//# sourceMappingURL=strategy-selector.js.map

package/packages/core/dist/core/install/strategies/strategy-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-selector.js","sourceRoot":"","sources":["../../../../src/core/install/strategies/strategy-selector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAA2B,EAC3B,OAAwB;IAExB,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAElC,wDAAwD;IACxD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,wBAAwB,EAAE,CAAC;IACxC,CAAC;IAED,gCAAgC;IAChC,IAAI,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;QACtC,OAAO,IAAI,yBAAyB,EAAE,CAAC;IACzC,CAAC;IAED,+BAA+B;IAC/B,OAAO,IAAI,wBAAwB,EAAE,CAAC;AACxC,CAAC"}

package/packages/core/dist/core/install/strategies/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Strategy Types Module
+ *
+ * Shared types and interfaces for installation strategies.
+ */
+import type { Flow } from '../../../types/flows.js';
+import type { Platform } from '../../platforms.js';
+import type { InstallOptions } from '../../../types/index.js';
+import type { PackageFormat } from '../format-detector.js';
+import type { PackageConversionContext } from '../../../types/conversion-context.js';
+import type { RelocatedFile } from '../conflicts/file-conflict-resolver.js';
+/**
+ * Installation context
+ */
+export interface FlowInstallContext {
+    packageName: string;
+    packageRoot: string;
+    workspaceRoot: string;
+    platform: Platform;
+    packageVersion: string;
+    priority: number;
+    dryRun: boolean;
+    packageFormat?: PackageFormat;
+    /**
+     * Conversion context for tracking package format identity and history
+     *
+     * REQUIRED: Provides canonical source for `$$source` and `$$platform` variables in flow conditionals.
+     * Contains immutable originalFormat and conversion history for auditing.
+     */
+    conversionContext: PackageConversionContext;
+    /**
+     * Pattern that matched for base detection (for pattern-based filtering)
+     */
+    matchedPattern?: string;
+    /**
+     * Optional prompt port for interactive conflict resolution.
+     * Threaded from ExecutionContext to avoid falling back to nonInteractivePrompt.
+     */
+    prompt?: import('../../ports/prompt.js').PromptPort;
+}
+/**
+ * Installation result
+ */
+export interface FlowInstallResult {
+    success: boolean;
+    filesProcessed: number;
+    filesWritten: number;
+    conflicts: FlowConflictReport[];
+    errors: FlowInstallError[];
+    targetPaths: string[];
+    fileMapping: Record<string, any[]>;
+    /** True when namespace conflict resolution was triggered for this package */
+    namespaced?: boolean;
+    /** Files that were physically relocated on disk during namespace resolution */
+    relocatedFiles?: RelocatedFile[];
+}
+export interface FlowConflictReport {
+    targetPath: string;
+    packages: Array<{
+        packageName: string;
+        priority: number;
+        chosen: boolean;
+    }>;
+    message: string;
+}
+export interface FlowInstallError {
+    flow: Flow;
+    sourcePath: string;
+    error: Error;
+    message: string;
+}
+/**
+ * Installation strategy interface
+ */
+export interface InstallationStrategy {
+    /**
+     * Check if this strategy can handle the given format/platform combination
+     */
+    canHandle(format: PackageFormat, platform: Platform): boolean;
+    /**
+     * Execute installation
+     */
+    install(context: FlowInstallContext, options?: InstallOptions, forceOverwrite?: boolean): Promise<FlowInstallResult>;
+    /**
+     * Strategy name for logging
+     */
+    readonly name: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/core/dist/core/install/strategies/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/install/strategies/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAErF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;;;;OAKG;IACH,iBAAiB,EAAE,wBAAwB,CAAC;IAI5C;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,uBAAuB,EAAE,UAAU,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IACnC,6EAA6E;IAC7E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;IAE9D;;OAEG;IACH,OAAO,CACL,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,cAAc,EACxB,cAAc,CAAC,EAAE,OAAO,GACvB,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB"}

package/packages/core/dist/core/install/strategies/types.js

@@ -0,0 +1,7 @@
+/**
+ * Strategy Types Module
+ *
+ * Shared types and interfaces for installation strategies.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/core/dist/core/install/strategies/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/install/strategies/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/packages/core/dist/core/install/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Types for the install flow
+ */
+import type { RemotePullFailureReason } from '../remote-pull.js';
+import type { InstallResolutionMode } from '../../types/install.js';
+export type { InstallResolutionMode };
+export interface PackageRemoteResolutionOutcome {
+    name: string;
+    reason: RemotePullFailureReason;
+    message: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/core/dist/core/install/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/install/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,YAAY,EAAE,qBAAqB,EAAE,CAAC;AAEtC,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,uBAAuB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/packages/core/dist/core/install/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for the install flow
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/core/dist/core/install/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/install/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/packages/core/dist/core/install/unified/context-builders.d.ts

@@ -0,0 +1,52 @@
+import type { InstallOptions, ExecutionContext } from '../../../types/index.js';
+import type { InstallationContext } from './context.js';
+import type { ResourceInstallationSpec } from '../convenience-matchers.js';
+/**
+ * Result of building contexts for bulk install.
+ * Workspace root is separate from dependency contexts so the orchestrator can run it as a distinct stage.
+ */
+export interface BulkInstallContextsResult {
+    workspaceContext: InstallationContext | null;
+    dependencyContexts: InstallationContext[];
+}
+/**
+ * Build context for registry-based installation
+ */
+export declare function buildRegistryInstallContext(execContext: ExecutionContext, packageName: string, options: InstallOptions & {
+    version?: string;
+    registryPath?: string;
+}): Promise<InstallationContext>;
+/**
+ * Build context for path-based installation
+ */
+export declare function buildPathInstallContext(execContext: ExecutionContext, sourcePath: string, options: InstallOptions & {
+    sourceType: 'directory' | 'tarball';
+}): Promise<InstallationContext>;
+/**
+ * Build context for git-based installation
+ */
+export declare function buildGitInstallContext(execContext: ExecutionContext, gitUrl: string, options: InstallOptions & {
+    gitRef?: string;
+    gitPath?: string;
+}): Promise<InstallationContext>;
+/**
+ * Build context for workspace root installation
+ * Used when installing/applying workspace-level files from .openpackage/
+ */
+export declare function buildWorkspaceRootInstallContext(execContext: ExecutionContext, options: InstallOptions, mode?: 'install' | 'apply'): Promise<InstallationContext | null>;
+/**
+ * Build context from package input (auto-detect type)
+ */
+export declare function buildInstallContext(execContext: ExecutionContext, packageInput: string | undefined, options: InstallOptions): Promise<InstallationContext | InstallationContext[] | BulkInstallContextsResult>;
+/**
+ * Build context from a ResourceSpec (Phase 3: Resource Model)
+ */
+export declare function buildResourceInstallContext(execContext: ExecutionContext, resourceSpec: any, // ResourceSpec from resource-arg-parser
+options: InstallOptions): Promise<InstallationContext>;
+/**
+ * Build multiple contexts for resource-centric installations.
+ * For single-file installs from plugins, scopes the package name to the resource path
+ * so the workspace index key is e.g. gh@user/repo/plugin/agents/foo.md rather than the plugin root.
+ */
+export declare function buildResourceInstallContexts(baseContext: InstallationContext, resourceSpecs: ResourceInstallationSpec[], repoRoot: string): InstallationContext[];
+//# sourceMappingURL=context-builders.d.ts.map

package/packages/core/dist/core/install/unified/context-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builders.d.ts","sourceRoot":"","sources":["../../../../src/core/install/unified/context-builders.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,cAAc,CAAC;AASvE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC7C,kBAAkB,EAAE,mBAAmB,EAAE,CAAC;CAC3C;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,gBAAgB,EAC7B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACpE,OAAO,CAAC,mBAAmB,CAAC,CAmB9B;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,gBAAgB,EAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GAAG;IAAE,UAAU,EAAE,WAAW,GAAG,SAAS,CAAA;CAAE,GAChE,OAAO,CAAC,mBAAmB,CAAC,CAqB9B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,gBAAgB,EAC7B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9D,OAAO,CAAC,mBAAmB,CAAC,CAoB9B;AAED;;;GAGG;AACH,wBAAsB,gCAAgC,CACpD,WAAW,EAAE,gBAAgB,EAC7B,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,SAAS,GAAG,OAAmB,GACpC,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CA+CrC;AAID;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,gBAAgB,EAC7B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,mBAAmB,GAAG,mBAAmB,EAAE,GAAG,yBAAyB,CAAC,CA8BlF;AAkJD;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,gBAAgB,EAC7B,YAAY,EAAE,GAAG,EAAE,wCAAwC;AAC3D,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,mBAAmB,CAAC,CA0D9B;AAwBD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,mBAAmB,EAChC,aAAa,EAAE,wBAAwB,EAAE,EACzC,QAAQ,EAAE,MAAM,GACf,mBAAmB,EAAE,CAgDvB"}