opkg 0.9.0 → 0.9.2

package/packages/core/dist/core/install/helpers/conflict-detection.js

@@ -0,0 +1,71 @@
+/**
+ * Conflict Detection Helpers
+ *
+ * Utilities for detecting conflicts when multiple packages write to the same target files.
+ * Used for multi-package priority-based conflict detection (e.g. in tests).
+ */
+import { discoverFlowSources } from '../../flows/flow-source-discovery.js';
+import { resolvePattern } from '../../flows/flow-source-discovery.js';
+/**
+ * Track target files written by a package for conflict detection
+ *
+ * Discovers which files a package will write to and tracks them in the fileTargets map.
+ * Multiple packages writing to the same target will be detected as conflicts.
+ *
+ * @param fileTargets - Map tracking which packages write to which targets (mutated)
+ * @param packageName - Name of the package
+ * @param priority - Priority of the package (higher priority wins conflicts)
+ * @param packageRoot - Root directory of the package
+ * @param flows - Applicable flows for this installation
+ * @param flowContext - Flow execution context
+ */
+export async function trackTargetFiles(fileTargets, packageName, priority, packageRoot, flows, flowContext) {
+    const flowSources = await discoverFlowSources(flows, packageRoot, flowContext);
+    for (const [flow, sources] of flowSources) {
+        if (sources.length > 0) {
+            // Determine target path from flow
+            const targetPath = typeof flow.to === 'string'
+                ? resolvePattern(flow.to, flowContext)
+                : Object.keys(flow.to)[0];
+            // Track this package writing to this target
+            if (!fileTargets.has(targetPath)) {
+                fileTargets.set(targetPath, []);
+            }
+            fileTargets.get(targetPath).push({
+                packageName,
+                priority
+            });
+        }
+    }
+}
+/**
+ * Generate conflict reports from tracked file targets
+ *
+ * Analyzes the fileTargets map to find files written by multiple packages.
+ * The package with the highest priority wins; others are reported as overwritten.
+ *
+ * @param fileTargets - Map of target paths to packages that write to them
+ * @returns Array of conflict reports
+ */
+export function generateConflictReports(fileTargets) {
+    const conflicts = [];
+    for (const [targetPath, writers] of fileTargets) {
+        if (writers.length > 1) {
+            // Sort by priority to determine winner (higher priority wins)
+            const sortedWriters = [...writers].sort((a, b) => b.priority - a.priority);
+            const winner = sortedWriters[0];
+            const losers = sortedWriters.slice(1);
+            conflicts.push({
+                targetPath,
+                packages: sortedWriters.map((w, i) => ({
+                    packageName: w.packageName,
+                    priority: w.priority,
+                    chosen: i === 0
+                })),
+                message: `Conflict in ${targetPath}: ${winner.packageName} (priority ${winner.priority}) overwrites ${losers.map(w => w.packageName).join(', ')}`
+            });
+        }
+    }
+    return conflicts;
+}
+//# sourceMappingURL=conflict-detection.js.map

package/packages/core/dist/core/install/helpers/conflict-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-detection.js","sourceRoot":"","sources":["../../../../src/core/install/helpers/conflict-detection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAUtE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAA4C,EAC5C,WAAmB,EACnB,QAAgB,EAChB,WAAmB,EACnB,KAAa,EACb,WAAwB;IAExB,MAAM,WAAW,GAAG,MAAM,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IAE/E,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,WAAW,EAAE,CAAC;QAC1C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,kCAAkC;YAClC,MAAM,UAAU,GAAG,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ;gBAC5C,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC;gBACtC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAE5B,4CAA4C;YAC5C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBACjC,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YAClC,CAAC;YACD,WAAW,CAAC,GAAG,CAAC,UAAU,CAAE,CAAC,IAAI,CAAC;gBAChC,WAAW;gBACX,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAA4C;IAE5C,MAAM,SAAS,GAAyB,EAAE,CAAC;IAE3C,KAAK,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,WAAW,EAAE,CAAC;QAChD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,8DAA8D;YAC9D,MAAM,aAAa,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC3E,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAEtC,SAAS,CAAC,IAAI,CAAC;gBACb,UAAU;gBACV,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;oBACrC,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,MAAM,EAAE,CAAC,KAAK,CAAC;iBAChB,CAAC,CAAC;gBACH,OAAO,EAAE,eAAe,UAAU,KAAK,MAAM,CAAC,WAAW,cAAc,MAAM,CAAC,QAAQ,gBAAgB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAClJ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/packages/core/dist/core/install/helpers/file-discovery.d.ts

@@ -0,0 +1,9 @@
+import type { PackageFile } from '../../../types/index.js';
+import type { Platform } from '../../platforms.js';
+export interface CategorizedInstallFiles {
+    pathBasedFiles: PackageFile[];
+    rootFiles: Map<string, string>;
+    rootCopyFiles: PackageFile[];
+}
+export declare function discoverAndCategorizeFiles(packageName: string, version: string, platforms: Platform[], contentRoot?: string, matchedPattern?: string): Promise<CategorizedInstallFiles>;
+//# sourceMappingURL=file-discovery.d.ts.map

package/packages/core/dist/core/install/helpers/file-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-discovery.d.ts","sourceRoot":"","sources":["../../../../src/core/install/helpers/file-discovery.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAQnD,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,WAAW,EAAE,CAAC;IAC9B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,aAAa,EAAE,WAAW,EAAE,CAAC;CAC9B;AAED,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,QAAQ,EAAE,EACrB,WAAW,CAAC,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,uBAAuB,CAAC,CA6DlC"}

package/packages/core/dist/core/install/helpers/file-discovery.js

@@ -0,0 +1,63 @@
+import { packageManager } from '../../package.js';
+import { FILE_PATTERNS, PACKAGE_PATHS } from '../../../constants/index.js';
+import { isManifestPath, normalizePackagePath } from '../../../utils/manifest-paths.js';
+import { getPlatformRootFileNames, stripRootCopyPrefix } from '../../platform/platform-root-files.js';
+import { minimatch } from 'minimatch';
+import { join } from 'path';
+import { exists } from '../../../utils/fs.js';
+import { hasPluginContent } from '../plugin-detector.js';
+export async function discoverAndCategorizeFiles(packageName, version, platforms, contentRoot, matchedPattern // Phase 4: Pattern for filtering
+) {
+    // Root file discovery only works for OpenPackage dirs or Claude plugins.
+    // Also treat directories with plugin content (commands/agents/skills/hooks or .mcp.json/.lsp.json)
+    // as loadable so marketplace-defined plugins without plugin.json can install.
+    if (contentRoot) {
+        const hasOpenPackageYml = await exists(join(contentRoot, 'openpackage.yml'));
+        const hasClaudePluginJson = await exists(join(contentRoot, '.claude-plugin', 'plugin.json'));
+        const hasClaudeMarketplaceJson = await exists(join(contentRoot, '.claude-plugin', 'marketplace.json'));
+        const hasPluginContentDirs = await hasPluginContent(contentRoot);
+        const isLoadableRoot = hasOpenPackageYml || hasClaudePluginJson || hasClaudeMarketplaceJson || hasPluginContentDirs;
+        if (!isLoadableRoot) {
+            return { pathBasedFiles: [], rootFiles: new Map(), rootCopyFiles: [] };
+        }
+    }
+    // Load once
+    const pkg = await packageManager.loadPackage(packageName, version, {
+        packageRootDir: contentRoot
+    });
+    // Phase 4: Build include filter that considers matchedPattern
+    const shouldInclude = (path) => {
+        // Check matched pattern (from base detection or resource scoping)
+        if (matchedPattern && !minimatch(path, matchedPattern)) {
+            return false;
+        }
+        return true;
+    };
+    // Precompute platform root filenames
+    const platformRootNames = getPlatformRootFileNames(platforms);
+    // Single pass classification
+    const pathBasedFiles = [];
+    const rootFiles = new Map();
+    const rootCopyFiles = [];
+    for (const file of pkg.files) {
+        const p = file.path;
+        const normalized = normalizePackagePath(p);
+        // Never install registry package metadata files
+        if (isManifestPath(p) || normalized === PACKAGE_PATHS.INDEX_RELATIVE)
+            continue;
+        if (!shouldInclude(p))
+            continue;
+        // root/** copy-to-root handling
+        const stripped = stripRootCopyPrefix(normalized);
+        if (stripped !== null) {
+            rootCopyFiles.push({ ...file, path: stripped });
+            continue;
+        }
+        pathBasedFiles.push(file);
+        if (normalized === FILE_PATTERNS.AGENTS_MD || platformRootNames.has(normalized)) {
+            rootFiles.set(normalized, file.content);
+        }
+    }
+    return { pathBasedFiles, rootFiles, rootCopyFiles };
+}
+//# sourceMappingURL=file-discovery.js.map

package/packages/core/dist/core/install/helpers/file-discovery.js.map

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

package/packages/core/dist/core/install/helpers/format-detection.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Format Detection Helpers
+ *
+ * Shared utilities for detecting package formats from directories.
+ * Extracts common logic used by both flow-based-installer and flow-index-installer.
+ */
+import { type PackageFormat } from '../format-detector.js';
+import type { PackageConversionContext } from '../../../types/conversion-context.js';
+/**
+ * Load file list from package directory for format detection
+ * Excludes .git directories
+ *
+ * @param packageRoot - Root directory of the package
+ * @returns Array of file paths with empty content strings
+ */
+export declare function loadPackageFileList(packageRoot: string): Promise<Array<{
+    path: string;
+    content: string;
+}>>;
+/**
+ * Detect package format from directory
+ *
+ * Convenience wrapper that loads file list and detects format.
+ *
+ * @param packageRoot - Root directory of the package
+ * @returns Detected package format
+ */
+export declare function detectFormatFromDirectory(packageRoot: string): Promise<PackageFormat>;
+/**
+ * Detect package format with conversion context from directory
+ *
+ * Convenience wrapper that loads file list and detects format with context.
+ * Use this when you need both format and conversion context for the installation pipeline.
+ *
+ * @param packageRoot - Root directory of the package
+ * @returns Detected format and conversion context
+ */
+export declare function detectFormatWithContextFromDirectory(packageRoot: string): Promise<{
+    format: PackageFormat;
+    context: PackageConversionContext;
+}>;
+//# sourceMappingURL=format-detection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format-detection.d.ts","sourceRoot":"","sources":["../../../../src/core/install/helpers/format-detection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAGrF;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAyBnD;AAED;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,CAAC,CAGxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,oCAAoC,CACxD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,wBAAwB,CAAA;CAAE,CAAC,CAGvE"}

package/packages/core/dist/core/install/helpers/format-detection.js

@@ -0,0 +1,66 @@
+/**
+ * Format Detection Helpers
+ *
+ * Shared utilities for detecting package formats from directories.
+ * Extracts common logic used by both flow-based-installer and flow-index-installer.
+ */
+import { relative } from 'path';
+import { walkFiles } from '../../../utils/file-walker.js';
+import { detectPackageFormat, detectPackageFormatWithContext } from '../format-detector.js';
+import { logger } from '../../../utils/logger.js';
+/**
+ * Load file list from package directory for format detection
+ * Excludes .git directories
+ *
+ * @param packageRoot - Root directory of the package
+ * @returns Array of file paths with empty content strings
+ */
+export async function loadPackageFileList(packageRoot) {
+    const files = [];
+    try {
+        for await (const fullPath of walkFiles(packageRoot)) {
+            const relativePath = relative(packageRoot, fullPath);
+            // Skip git metadata
+            if (relativePath.startsWith('.git/') || relativePath === '.git') {
+                continue;
+            }
+            files.push({
+                path: relativePath,
+                content: ''
+            });
+        }
+    }
+    catch (error) {
+        logger.error('Failed to read package directory for format detection', {
+            packageRoot,
+            error
+        });
+    }
+    return files;
+}
+/**
+ * Detect package format from directory
+ *
+ * Convenience wrapper that loads file list and detects format.
+ *
+ * @param packageRoot - Root directory of the package
+ * @returns Detected package format
+ */
+export async function detectFormatFromDirectory(packageRoot) {
+    const files = await loadPackageFileList(packageRoot);
+    return detectPackageFormat(files);
+}
+/**
+ * Detect package format with conversion context from directory
+ *
+ * Convenience wrapper that loads file list and detects format with context.
+ * Use this when you need both format and conversion context for the installation pipeline.
+ *
+ * @param packageRoot - Root directory of the package
+ * @returns Detected format and conversion context
+ */
+export async function detectFormatWithContextFromDirectory(packageRoot) {
+    const files = await loadPackageFileList(packageRoot);
+    return detectPackageFormatWithContext(files);
+}
+//# sourceMappingURL=format-detection.js.map

package/packages/core/dist/core/install/helpers/format-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-detection.js","sourceRoot":"","sources":["../../../../src/core/install/helpers/format-detection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAE/B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAmB;IAEnB,MAAM,KAAK,GAA6C,EAAE,CAAC;IAE3D,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,QAAQ,IAAI,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;YACpD,MAAM,YAAY,GAAG,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YAErD,oBAAoB;YACpB,IAAI,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;gBAChE,SAAS;YACX,CAAC;YAED,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,EAAE;aACZ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,uDAAuD,EAAE;YACpE,WAAW;YACX,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,WAAmB;IAEnB,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC;IACrD,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oCAAoC,CACxD,WAAmB;IAEnB,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC;IACrD,OAAO,8BAA8B,CAAC,KAAK,CAAC,CAAC;AAC/C,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Install Helpers
+ * Helper utilities specific to installation
+ */
+export { discoverAndCategorizeFiles } from './file-discovery.js';
+export { loadPackageFileList, detectFormatFromDirectory, detectFormatWithContextFromDirectory } from './format-detection.js';
+export { logConflicts, logErrors, logConflictMessages, logErrorMessages, logInstallationResult } from './result-logging.js';
+export { mergeFileMappings, mergeWorkspaceFileMappings, aggregateFlowResults, collectConflictMessages, collectErrorMessages } from './result-aggregation.js';
+export { trackTargetFiles, generateConflictReports, type FileTargetWriter } from './conflict-detection.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/install/helpers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAGjE,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,oCAAoC,EACrC,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * Install Helpers
+ * Helper utilities specific to installation
+ */
+export { discoverAndCategorizeFiles } from './file-discovery.js';
+// Format detection
+export { loadPackageFileList, detectFormatFromDirectory, detectFormatWithContextFromDirectory } from './format-detection.js';
+// Result logging
+export { logConflicts, logErrors, logConflictMessages, logErrorMessages, logInstallationResult } from './result-logging.js';
+// Result aggregation
+export { mergeFileMappings, mergeWorkspaceFileMappings, aggregateFlowResults, collectConflictMessages, collectErrorMessages } from './result-aggregation.js';
+// Conflict detection
+export { trackTargetFiles, generateConflictReports } from './conflict-detection.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/install/helpers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAEjE,mBAAmB;AACnB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,oCAAoC,EACrC,MAAM,uBAAuB,CAAC;AAE/B,iBAAiB;AACjB,OAAO,EACL,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,qBAAqB,CAAC;AAE7B,qBAAqB;AACrB,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,yBAAyB,CAAC;AAEjC,qBAAqB;AACrB,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EAExB,MAAM,yBAAyB,CAAC"}

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

@@ -0,0 +1,58 @@
+/**
+ * Result Aggregation Helpers
+ *
+ * Shared utilities for aggregating installation results across multiple packages or platforms.
+ * Handles merging of file mappings, conflicts, errors, and statistics.
+ */
+import type { FlowInstallResult } from '../strategies/types.js';
+import type { WorkspaceIndexFileMapping } from '../../../types/workspace-index.js';
+/**
+ * Merge file mappings from multiple results
+ * Simple deduplication by concatenating unique targets
+ *
+ * @param target - Target mapping to merge into (mutated)
+ * @param source - Source mapping to merge from
+ */
+export declare function mergeFileMappings(target: Record<string, (string | WorkspaceIndexFileMapping)[]>, source: Record<string, (string | WorkspaceIndexFileMapping)[]>): void;
+/**
+ * Merge file mappings with workspace index format
+ * Prefers complex mappings over simple strings, deduplicates by target path
+ *
+ * This is used by flow-index-installer which needs to handle both string and
+ * WorkspaceIndexFileMapping formats.
+ *
+ * @param target - Target mapping to merge into (mutated)
+ * @param source - Source mapping to merge from
+ */
+export declare function mergeWorkspaceFileMappings(target: Record<string, (string | WorkspaceIndexFileMapping)[]>, source: Record<string, (string | WorkspaceIndexFileMapping)[]>): void;
+/**
+ * Aggregate flow install results
+ *
+ * Merges statistics, errors, conflicts, target paths, and file mappings from
+ * source into target. Target is mutated.
+ *
+ * @param target - Target result to aggregate into (mutated)
+ * @param source - Source result to aggregate from
+ */
+export declare function aggregateFlowResults(target: FlowInstallResult, source: FlowInstallResult): void;
+/**
+ * Collect unique conflict messages
+ *
+ * Converts FlowConflictReport objects to strings and adds unique messages to target array.
+ * Used by flow-index-installer to aggregate conflicts across platforms.
+ *
+ * @param target - Target array to add messages to (mutated)
+ * @param conflicts - Source conflicts to convert and add
+ */
+export declare function collectConflictMessages(target: string[], conflicts: FlowInstallResult['conflicts']): void;
+/**
+ * Collect unique error messages
+ *
+ * Converts FlowInstallError objects to strings and adds unique messages to target array.
+ * Used by flow-index-installer to aggregate errors across platforms.
+ *
+ * @param target - Target array to add messages to (mutated)
+ * @param errors - Source errors to convert and add
+ */
+export declare function collectErrorMessages(target: string[], errors: FlowInstallResult['errors']): void;
+//# sourceMappingURL=result-aggregation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"result-aggregation.d.ts","sourceRoot":"","sources":["../../../../src/core/install/helpers/result-aggregation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAEnF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,yBAAyB,CAAC,EAAE,CAAC,EAC9D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,yBAAyB,CAAC,EAAE,CAAC,GAC7D,IAAI,CAKN;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,yBAAyB,CAAC,EAAE,CAAC,EAC9D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,yBAAyB,CAAC,EAAE,CAAC,GAC7D,IAAI,CA0BN;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,iBAAiB,GACxB,IAAI,CAYN;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EAAE,EAChB,SAAS,EAAE,iBAAiB,CAAC,WAAW,CAAC,GACxC,IAAI,CAON;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAClC,IAAI,CAON"}

package/packages/core/dist/core/install/helpers/result-aggregation.js

@@ -0,0 +1,107 @@
+/**
+ * Result Aggregation Helpers
+ *
+ * Shared utilities for aggregating installation results across multiple packages or platforms.
+ * Handles merging of file mappings, conflicts, errors, and statistics.
+ */
+/**
+ * Merge file mappings from multiple results
+ * Simple deduplication by concatenating unique targets
+ *
+ * @param target - Target mapping to merge into (mutated)
+ * @param source - Source mapping to merge from
+ */
+export function mergeFileMappings(target, source) {
+    for (const [sourceKey, targets] of Object.entries(source)) {
+        const existing = target[sourceKey] ?? [];
+        target[sourceKey] = Array.from(new Set([...existing, ...targets])).sort();
+    }
+}
+/**
+ * Merge file mappings with workspace index format
+ * Prefers complex mappings over simple strings, deduplicates by target path
+ *
+ * This is used by flow-index-installer which needs to handle both string and
+ * WorkspaceIndexFileMapping formats.
+ *
+ * @param target - Target mapping to merge into (mutated)
+ * @param source - Source mapping to merge from
+ */
+export function mergeWorkspaceFileMappings(target, source) {
+    for (const [sourceKey, targets] of Object.entries(source)) {
+        const existing = target[sourceKey] ?? [];
+        // Deduplicate by target path, prefer complex mapping over string
+        const byTarget = new Map();
+        for (const m of existing) {
+            const targetPath = typeof m === 'string' ? m : m.target;
+            byTarget.set(targetPath, m);
+        }
+        for (const m of targets) {
+            const targetPath = typeof m === 'string' ? m : m.target;
+            const prior = byTarget.get(targetPath);
+            if (!prior) {
+                byTarget.set(targetPath, m);
+            }
+            else if (typeof prior === 'string' && typeof m !== 'string') {
+                // Prefer complex mapping over string
+                byTarget.set(targetPath, m);
+            }
+        }
+        target[sourceKey] = Array.from(byTarget.values());
+    }
+}
+/**
+ * Aggregate flow install results
+ *
+ * Merges statistics, errors, conflicts, target paths, and file mappings from
+ * source into target. Target is mutated.
+ *
+ * @param target - Target result to aggregate into (mutated)
+ * @param source - Source result to aggregate from
+ */
+export function aggregateFlowResults(target, source) {
+    target.filesProcessed += source.filesProcessed;
+    target.filesWritten += source.filesWritten;
+    target.errors.push(...source.errors);
+    target.conflicts.push(...source.conflicts);
+    target.targetPaths.push(...(source.targetPaths ?? []));
+    mergeFileMappings(target.fileMapping, source.fileMapping ?? {});
+    if (!source.success) {
+        target.success = false;
+    }
+}
+/**
+ * Collect unique conflict messages
+ *
+ * Converts FlowConflictReport objects to strings and adds unique messages to target array.
+ * Used by flow-index-installer to aggregate conflicts across platforms.
+ *
+ * @param target - Target array to add messages to (mutated)
+ * @param conflicts - Source conflicts to convert and add
+ */
+export function collectConflictMessages(target, conflicts) {
+    for (const conflict of conflicts) {
+        const msg = `${conflict.targetPath}: ${conflict.message}`;
+        if (!target.includes(msg)) {
+            target.push(msg);
+        }
+    }
+}
+/**
+ * Collect unique error messages
+ *
+ * Converts FlowInstallError objects to strings and adds unique messages to target array.
+ * Used by flow-index-installer to aggregate errors across platforms.
+ *
+ * @param target - Target array to add messages to (mutated)
+ * @param errors - Source errors to convert and add
+ */
+export function collectErrorMessages(target, errors) {
+    for (const error of errors) {
+        const msg = `${error.sourcePath}: ${error.message}`;
+        if (!target.includes(msg)) {
+            target.push(msg);
+        }
+    }
+}
+//# sourceMappingURL=result-aggregation.js.map

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

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

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

@@ -0,0 +1,47 @@
+/**
+ * Result Logging Helpers
+ *
+ * Shared utilities for logging installation results, conflicts, and errors.
+ * Provides consistent logging behavior across installation modules.
+ */
+import type { FlowInstallResult, FlowConflictReport, FlowInstallError } from '../strategies/types.js';
+/**
+ * Log conflicts from FlowInstallResult
+ *
+ * @param conflicts - Array of conflict reports
+ */
+export declare function logConflicts(conflicts: FlowConflictReport[]): void;
+/**
+ * Log errors from FlowInstallResult
+ *
+ * @param errors - Array of installation errors
+ */
+export declare function logErrors(errors: FlowInstallError[]): void;
+/**
+ * Log conflict messages (string array format)
+ *
+ * Used by flow-index-installer which aggregates conflicts across platforms.
+ *
+ * @param conflicts - Array of conflict message strings
+ */
+export declare function logConflictMessages(conflicts: string[]): void;
+/**
+ * Log error messages (string array format)
+ *
+ * Used by flow-index-installer which aggregates errors across platforms.
+ *
+ * @param errors - Array of error message strings
+ */
+export declare function logErrorMessages(errors: string[]): void;
+/**
+ * Log complete installation result with processing summary
+ *
+ * Logs files processed/written and then delegates to conflict/error logging.
+ *
+ * @param result - Flow installation result
+ * @param packageName - Package being installed
+ * @param platform - Target platform
+ * @param dryRun - Whether this is a dry run
+ */
+export declare function logInstallationResult(result: FlowInstallResult, packageName: string, platform: string, dryRun: boolean): void;
+//# sourceMappingURL=result-logging.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"result-logging.d.ts","sourceRoot":"","sources":["../../../../src/core/install/helpers/result-logging.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEtG;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAWlE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAO1D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAO7D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAOvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GACd,IAAI,CAUN"}

package/packages/core/dist/core/install/helpers/result-logging.js

@@ -0,0 +1,85 @@
+/**
+ * Result Logging Helpers
+ *
+ * Shared utilities for logging installation results, conflicts, and errors.
+ * Provides consistent logging behavior across installation modules.
+ */
+import { logger } from '../../../utils/logger.js';
+import { toTildePath } from '../../../utils/path-resolution.js';
+/**
+ * Log conflicts from FlowInstallResult
+ *
+ * @param conflicts - Array of conflict reports
+ */
+export function logConflicts(conflicts) {
+    if (conflicts.length === 0)
+        return;
+    logger.warn(`Detected ${conflicts.length} conflicts during installation`);
+    for (const conflict of conflicts) {
+        const winner = conflict.packages.find(p => p.chosen);
+        const loser = conflict.packages.find(p => !p.chosen);
+        logger.warn(`  ${toTildePath(conflict.targetPath)}: ${winner?.packageName} (priority ${winner?.priority}) overwrites ${loser?.packageName}`);
+    }
+}
+/**
+ * Log errors from FlowInstallResult
+ *
+ * @param errors - Array of installation errors
+ */
+export function logErrors(errors) {
+    if (errors.length === 0)
+        return;
+    logger.error(`Encountered ${errors.length} errors during installation`);
+    for (const error of errors) {
+        logger.error(`  ${error.sourcePath}: ${error.message}`);
+    }
+}
+/**
+ * Log conflict messages (string array format)
+ *
+ * Used by flow-index-installer which aggregates conflicts across platforms.
+ *
+ * @param conflicts - Array of conflict message strings
+ */
+export function logConflictMessages(conflicts) {
+    if (conflicts.length === 0)
+        return;
+    logger.warn(`Detected ${conflicts.length} conflicts during installation:`);
+    for (const conflict of conflicts) {
+        logger.warn(`  ${conflict}`);
+    }
+}
+/**
+ * Log error messages (string array format)
+ *
+ * Used by flow-index-installer which aggregates errors across platforms.
+ *
+ * @param errors - Array of error message strings
+ */
+export function logErrorMessages(errors) {
+    if (errors.length === 0)
+        return;
+    logger.error(`Encountered ${errors.length} errors during installation:`);
+    for (const error of errors) {
+        logger.error(`  ${error}`);
+    }
+}
+/**
+ * Log complete installation result with processing summary
+ *
+ * Logs files processed/written and then delegates to conflict/error logging.
+ *
+ * @param result - Flow installation result
+ * @param packageName - Package being installed
+ * @param platform - Target platform
+ * @param dryRun - Whether this is a dry run
+ */
+export function logInstallationResult(result, packageName, platform, dryRun) {
+    if (result.filesProcessed > 0) {
+        logger.info(`Processed ${result.filesProcessed} files for ${packageName} on platform ${platform}` +
+            (dryRun ? ' (dry run)' : `, wrote ${result.filesWritten} files`));
+    }
+    logConflicts(result.conflicts);
+    logErrors(result.errors);
+}
+//# sourceMappingURL=result-logging.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"result-logging.js","sourceRoot":"","sources":["../../../../src/core/install/helpers/result-logging.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAGhE;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,SAA+B;IAC1D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEnC,MAAM,CAAC,IAAI,CAAC,YAAY,SAAS,CAAC,MAAM,gCAAgC,CAAC,CAAC;IAC1E,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACrD,MAAM,CAAC,IAAI,CACT,KAAK,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,MAAM,EAAE,WAAW,cAAc,MAAM,EAAE,QAAQ,gBAAgB,KAAK,EAAE,WAAW,EAAE,CAChI,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,MAA0B;IAClD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEhC,MAAM,CAAC,KAAK,CAAC,eAAe,MAAM,CAAC,MAAM,6BAA6B,CAAC,CAAC;IACxE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,UAAU,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAmB;IACrD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEnC,MAAM,CAAC,IAAI,CAAC,YAAY,SAAS,CAAC,MAAM,iCAAiC,CAAC,CAAC;IAC3E,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAgB;IAC/C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEhC,MAAM,CAAC,KAAK,CAAC,eAAe,MAAM,CAAC,MAAM,8BAA8B,CAAC,CAAC;IACzE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAyB,EACzB,WAAmB,EACnB,QAAgB,EAChB,MAAe;IAEf,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,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/B,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC"}