opkg 0.9.0 → 0.9.2

package/packages/core/dist/core/save/save-resolution-executor.js

@@ -0,0 +1,197 @@
+import { logger } from '../../utils/logger.js';
+import { getNewestCandidate, sortCandidatesByMtime } from './save-conflict-analyzer.js';
+import { resolveInteractively } from './save-interactive-resolver.js';
+/**
+ * Resolution Strategy Executor
+ *
+ * This module orchestrates the execution of resolution strategies based on conflict analysis.
+ * It delegates to specific resolution functions based on the recommended strategy.
+ *
+ * Strategies:
+ * - skip: No action needed
+ * - write-single: Single workspace candidate (auto-write)
+ * - write-newest: Multiple identical candidates (auto-write newest)
+ * - force-newest: Multiple differing candidates with force flag (auto-select newest)
+ * - interactive: Multiple differing candidates without force flag (prompt user)
+ *
+ * @module save-resolution-executor
+ */
+/**
+ * Execute resolution for a candidate group based on conflict analysis
+ *
+ * This is the primary entry point for resolution execution. It takes the analysis
+ * result and delegates to the appropriate resolution function based on the
+ * recommended strategy.
+ *
+ * **Flow**:
+ * 1. Check if strategy is 'skip' → return null (no action)
+ * 2. Sort candidates by mtime (newest first) for consistency
+ * 3. Dispatch to strategy-specific function
+ * 4. Return ResolutionResult
+ *
+ * @param group - The candidate group being resolved
+ * @param analysis - Conflict analysis with recommended strategy
+ * @param packageRoot - Package source absolute path (for parity checking)
+ * @param workspaceRoot - Workspace root for conversion
+ * @returns ResolutionResult with selection and platform-specific candidates, or null if skip
+ */
+export async function executeResolution(group, analysis, packageRoot, workspaceRoot, output, prompt) {
+    const strategy = analysis.recommendedStrategy;
+    // Skip if no action needed
+    if (strategy === 'skip') {
+        return null;
+    }
+    // Sort candidates by mtime (newest first) for consistent ordering
+    const sortedCandidates = sortCandidatesByMtime(analysis.uniqueWorkspaceCandidates);
+    // Dispatch to appropriate resolution function
+    switch (strategy) {
+        case 'write-single':
+            return resolveSingle(sortedCandidates[0]);
+        case 'write-newest':
+            return resolveIdentical(sortedCandidates);
+        case 'force-newest':
+            return resolveForce(sortedCandidates, group.registryPath);
+        case 'interactive':
+            return resolveInteractive(group.registryPath, sortedCandidates, analysis.isRootFile, group, packageRoot, workspaceRoot, output, prompt);
+        default:
+            logger.warn(`Unknown resolution strategy: ${strategy}`);
+            return null;
+    }
+}
+/**
+ * Resolve single workspace candidate (auto-write)
+ *
+ * This is the simplest case: only one workspace candidate exists,
+ * so we use it without prompting the user.
+ *
+ * @param candidate - The single workspace candidate
+ * @returns ResolutionResult with the candidate as universal selection
+ */
+function resolveSingle(candidate) {
+    return {
+        selection: candidate,
+        platformSpecific: [],
+        strategy: 'write-single',
+        wasInteractive: false
+    };
+}
+/**
+ * Resolve multiple identical candidates (auto-write newest)
+ *
+ * All workspace candidates have identical content (after deduplication).
+ * Pick the newest one by mtime and use it as the universal selection.
+ *
+ * @param candidates - Array of deduplicated identical candidates
+ * @returns ResolutionResult with newest candidate as universal selection
+ */
+function resolveIdentical(candidates) {
+    const newest = getNewestCandidate(candidates);
+    return {
+        selection: newest,
+        platformSpecific: [],
+        strategy: 'write-newest',
+        wasInteractive: false
+    };
+}
+/**
+ * Force-resolve: Auto-select newest without prompting (force mode)
+ *
+ * Multiple differing candidates exist, but --force flag is enabled.
+ * Auto-select the newest by mtime without user interaction.
+ *
+ * **Tie-breaking**: If multiple candidates have the same mtime (unlikely but possible),
+ * the alphabetically first displayPath is selected. This is handled by getNewestCandidate().
+ *
+ * **Logging**: Provides detailed logging to show what was selected and what was skipped,
+ * with special handling for tie situations.
+ *
+ * @param candidates - Array of differing candidates (sorted by mtime)
+ * @param registryPath - The registry path being resolved
+ * @returns ResolutionResult with newest candidate as universal selection
+ */
+function resolveForce(candidates, registryPath) {
+    const newest = getNewestCandidate(candidates);
+    // Check if there are ties (multiple with same mtime as newest)
+    const maxMtime = newest.mtime;
+    const tiedCandidates = candidates.filter(c => c.mtime === maxMtime);
+    if (tiedCandidates.length > 1) {
+        // Tie situation - log detailed explanation
+        logger.info(`Force mode: Multiple files have same modification time (${formatTimestamp(maxMtime)})`);
+        logger.info(`  Auto-selecting first alphabetically: ${newest.displayPath}`);
+        logger.info('  Tied files:');
+        tiedCandidates.forEach(c => {
+            const marker = c === newest ? '→' : ' ';
+            logger.info(`    ${marker} ${c.displayPath}`);
+        });
+        // Log skipped tied files
+        const skippedTied = tiedCandidates.filter(c => c !== newest);
+        skippedTied.forEach(c => {
+            logger.info(`  Skipping: ${c.displayPath} (tied, not alphabetically first)`);
+        });
+        // Log older files
+        const olderFiles = candidates.filter(c => c.mtime < maxMtime);
+        olderFiles.forEach(c => {
+            logger.info(`  Skipping: ${c.displayPath} (older)`);
+        });
+    }
+    else {
+        // Clear winner - simple logging
+        logger.info(`Force mode: Auto-selecting newest (${newest.displayPath})`);
+        // Log what we're skipping
+        const skipped = candidates.filter(c => c !== newest);
+        if (skipped.length > 0) {
+            skipped.forEach(c => {
+                logger.info(`  Skipping: ${c.displayPath} (older)`);
+            });
+        }
+    }
+    return {
+        selection: newest,
+        platformSpecific: [], // Force mode doesn't auto-create platform-specific variants
+        strategy: 'force-newest',
+        wasInteractive: false
+    };
+}
+/**
+ * Interactive resolve: Prompt user for action (interactive mode)
+ *
+ * Multiple differing candidates exist and user interaction is required.
+ * Delegates to the interactive resolver module for UI flow and prompts.
+ *
+ * @param registryPath - The registry path being resolved
+ * @param candidates - Array of differing candidates (sorted by mtime)
+ * @param isRootFile - Whether this is a root package file
+ * @param group - Complete candidate group (for parity checking)
+ * @param packageRoot - Package source absolute path (for parity checking)
+ * @param workspaceRoot - Workspace root for conversion
+ * @returns ResolutionResult with user selections
+ */
+async function resolveInteractive(registryPath, candidates, isRootFile, group, packageRoot, workspaceRoot, output, prompt) {
+    const result = await resolveInteractively({
+        registryPath,
+        workspaceCandidates: candidates,
+        isRootFile,
+        group,
+        packageRoot,
+        workspaceRoot
+    }, output, prompt);
+    return {
+        selection: result.selectedCandidate,
+        platformSpecific: result.platformSpecificCandidates,
+        strategy: 'interactive',
+        wasInteractive: true
+    };
+}
+/**
+ * Format timestamp for human-readable display
+ *
+ * Converts millisecond timestamp to locale-specific date/time string.
+ *
+ * @param mtime - Modification time in milliseconds
+ * @returns Formatted date/time string
+ */
+function formatTimestamp(mtime) {
+    const date = new Date(mtime);
+    return date.toLocaleString();
+}
+//# sourceMappingURL=save-resolution-executor.js.map

package/packages/core/dist/core/save/save-resolution-executor.js.map

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

package/packages/core/dist/core/save/save-result-reporter.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Result Reporter
+ *
+ * This module formats save operation results for user display.
+ * It aggregates write results, conflict analyses, and other pipeline
+ * data into a comprehensive report structure.
+ *
+ * Key responsibilities:
+ * - Build SaveReport from pipeline results
+ * - Format user-friendly messages
+ * - Create CommandResult objects
+ * - Provide helpers for success/error cases
+ *
+ * @module save-result-reporter
+ */
+import type { CommandResult } from '../../types/index.js';
+import type { ConflictAnalysis } from './save-conflict-analyzer.js';
+import type { WriteResult } from './save-types.js';
+/**
+ * SaveReport contains aggregated save operation results
+ *
+ * This structure provides all the data needed to display
+ * a comprehensive summary of the save operation to the user.
+ */
+export interface SaveReport {
+    /** Package name that was saved */
+    packageName: string;
+    /** Total number of candidate groups processed */
+    totalGroups: number;
+    /** Number of groups that required action (not skipped) */
+    groupsWithAction: number;
+    /** Total files written successfully */
+    filesSaved: number;
+    /** Files created (new) */
+    filesCreated: number;
+    /** Files updated (existing) */
+    filesUpdated: number;
+    /** Platform-specific files written */
+    platformSpecificFiles: number;
+    /** Number of interactive resolutions (user prompts) */
+    interactiveResolutions: number;
+    /** Write errors that occurred */
+    errors: Array<{
+        path: string;
+        error: Error;
+    }>;
+    /** All write results (for detailed reporting) */
+    writeResults: WriteResult[];
+}
+/**
+ * Build save report from pipeline results
+ *
+ * Aggregates data from conflict analyses and write results into
+ * a comprehensive SaveReport structure.
+ *
+ * @param packageName - Package that was saved
+ * @param analyses - Array of conflict analyses (one per group)
+ * @param allWriteResults - Array of write result arrays (one array per group)
+ * @returns SaveReport with aggregated statistics
+ */
+export declare function buildSaveReport(packageName: string, analyses: ConflictAnalysis[], allWriteResults: WriteResult[][]): SaveReport;
+/**
+ * Create CommandResult from SaveReport
+ *
+ * Wraps the report in a CommandResult structure with formatted message.
+ *
+ * @param report - Save report to wrap
+ * @returns CommandResult with success status and formatted message
+ */
+export declare function createCommandResult(report: SaveReport): CommandResult;
+/**
+ * Create success result for simple cases
+ *
+ * Helper for early-exit scenarios like "no changes detected".
+ *
+ * @param packageName - Package name
+ * @param message - Success message to display
+ * @returns CommandResult with success status
+ */
+export declare function createSuccessResult(packageName: string, message: string): CommandResult;
+/**
+ * Create error result
+ *
+ * Helper for error cases throughout the pipeline.
+ *
+ * @param error - Error message
+ * @returns CommandResult with failure status
+ */
+export declare function createErrorResult(error: string): CommandResult;
+/**
+ * Format human-readable save message
+ *
+ * Generates a user-friendly message summarizing the save operation.
+ * Includes conditional sections based on what occurred.
+ *
+ * Template:
+ * ```
+ * ✓ Saved {packageName}
+ *   {filesCreated} file(s) created
+ *   {filesUpdated} file(s) updated
+ *   {platformSpecificFiles} platform-specific file(s)
+ *   {interactiveResolutions} interactive resolution(s)
+ * ```
+ *
+ * @param report - Save report to format
+ * @returns Formatted message string
+ */
+export declare function formatSaveMessage(report: SaveReport): string;
+//# sourceMappingURL=save-result-reporter.d.ts.map

package/packages/core/dist/core/save/save-result-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-result-reporter.d.ts","sourceRoot":"","sources":["../../../src/core/save/save-result-reporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IAEpB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IAEpB,0DAA0D;IAC1D,gBAAgB,EAAE,MAAM,CAAC;IAEzB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IAEnB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IAErB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IAErB,sCAAsC;IACtC,qBAAqB,EAAE,MAAM,CAAC;IAE9B,uDAAuD;IACvD,sBAAsB,EAAE,MAAM,CAAC;IAE/B,iCAAiC;IACjC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;IAE9C,iDAAiD;IACjD,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,eAAe,EAAE,WAAW,EAAE,EAAE,GAC/B,UAAU,CAoDZ;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,CAQrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,aAAa,CAQf;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAK9D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CA2D5D"}

package/packages/core/dist/core/save/save-result-reporter.js

@@ -0,0 +1,176 @@
+/**
+ * Result Reporter
+ *
+ * This module formats save operation results for user display.
+ * It aggregates write results, conflict analyses, and other pipeline
+ * data into a comprehensive report structure.
+ *
+ * Key responsibilities:
+ * - Build SaveReport from pipeline results
+ * - Format user-friendly messages
+ * - Create CommandResult objects
+ * - Provide helpers for success/error cases
+ *
+ * @module save-result-reporter
+ */
+/**
+ * Build save report from pipeline results
+ *
+ * Aggregates data from conflict analyses and write results into
+ * a comprehensive SaveReport structure.
+ *
+ * @param packageName - Package that was saved
+ * @param analyses - Array of conflict analyses (one per group)
+ * @param allWriteResults - Array of write result arrays (one array per group)
+ * @returns SaveReport with aggregated statistics
+ */
+export function buildSaveReport(packageName, analyses, allWriteResults) {
+    // Count groups
+    const totalGroups = analyses.length;
+    const groupsWithAction = analyses.filter(a => a.type !== 'no-action-needed' && a.type !== 'no-change-needed').length;
+    // Flatten write results
+    const flatResults = allWriteResults.flat();
+    // Count successful writes
+    const successfulWrites = flatResults.filter(r => r.success);
+    const filesSaved = successfulWrites.length;
+    // Count created vs updated
+    const filesCreated = successfulWrites.filter(r => r.operation.operation === 'create').length;
+    const filesUpdated = successfulWrites.filter(r => r.operation.operation === 'update').length;
+    // Count platform-specific files
+    const platformSpecificFiles = successfulWrites.filter(r => r.operation.isPlatformSpecific).length;
+    // Count interactive resolutions
+    const interactiveResolutions = analyses.filter(a => a.recommendedStrategy === 'interactive' && a.type === 'needs-resolution').length;
+    // Extract errors
+    const errors = flatResults
+        .filter(r => !r.success)
+        .map(r => ({
+        path: r.operation.registryPath,
+        error: r.error || new Error('Unknown write error')
+    }));
+    return {
+        packageName,
+        totalGroups,
+        groupsWithAction,
+        filesSaved,
+        filesCreated,
+        filesUpdated,
+        platformSpecificFiles,
+        interactiveResolutions,
+        errors,
+        writeResults: flatResults
+    };
+}
+/**
+ * Create CommandResult from SaveReport
+ *
+ * Wraps the report in a CommandResult structure with formatted message.
+ *
+ * @param report - Save report to wrap
+ * @returns CommandResult with success status and formatted message
+ */
+export function createCommandResult(report) {
+    return {
+        success: true,
+        data: {
+            message: formatSaveMessage(report),
+            report: report
+        }
+    };
+}
+/**
+ * Create success result for simple cases
+ *
+ * Helper for early-exit scenarios like "no changes detected".
+ *
+ * @param packageName - Package name
+ * @param message - Success message to display
+ * @returns CommandResult with success status
+ */
+export function createSuccessResult(packageName, message) {
+    return {
+        success: true,
+        data: {
+            message: message,
+            packageName: packageName
+        }
+    };
+}
+/**
+ * Create error result
+ *
+ * Helper for error cases throughout the pipeline.
+ *
+ * @param error - Error message
+ * @returns CommandResult with failure status
+ */
+export function createErrorResult(error) {
+    return {
+        success: false,
+        error: error
+    };
+}
+/**
+ * Format human-readable save message
+ *
+ * Generates a user-friendly message summarizing the save operation.
+ * Includes conditional sections based on what occurred.
+ *
+ * Template:
+ * ```
+ * ✓ Saved {packageName}
+ *   {filesCreated} file(s) created
+ *   {filesUpdated} file(s) updated
+ *   {platformSpecificFiles} platform-specific file(s)
+ *   {interactiveResolutions} interactive resolution(s)
+ * ```
+ *
+ * @param report - Save report to format
+ * @returns Formatted message string
+ */
+export function formatSaveMessage(report) {
+    const lines = [];
+    if (report.filesSaved === 0 && report.errors.length === 0) {
+        return `✓ Saved ${report.packageName}\n  No changes detected`;
+    }
+    lines.push(`✓ Saved ${report.packageName}`);
+    if (report.filesCreated > 0) {
+        lines.push(`  ${report.filesCreated} file(s) created`);
+    }
+    if (report.filesUpdated > 0) {
+        lines.push(`  ${report.filesUpdated} file(s) updated`);
+    }
+    if (report.platformSpecificFiles > 0) {
+        lines.push(`  ${report.platformSpecificFiles} platform-specific file(s)`);
+    }
+    if (report.interactiveResolutions > 0) {
+        lines.push(`  ${report.interactiveResolutions} interactive resolution(s)`);
+    }
+    if (report.errors.length > 0) {
+        lines.push('');
+        lines.push(`⚠️  ${report.errors.length} error(s) occurred:`);
+        report.errors.forEach(err => {
+            lines.push(`  • ${err.path}: ${err.error.message}`);
+        });
+    }
+    const successfulWrites = report.writeResults.filter(r => r.success);
+    if (successfulWrites.length > 0) {
+        lines.push('');
+        lines.push('  Files saved:');
+        const sorted = [...successfulWrites].sort((a, b) => a.operation.registryPath.localeCompare(b.operation.registryPath));
+        for (const result of sorted) {
+            const { registryPath, isPlatformSpecific, platform } = result.operation;
+            const label = isPlatformSpecific && platform
+                ? `${registryPath} (${platform})`
+                : `${registryPath} (universal)`;
+            lines.push(`   ├── ${label}`);
+        }
+    }
+    if (report.filesSaved > 0) {
+        lines.push('');
+        lines.push('💡 Changes saved to package source.');
+        lines.push('   To sync changes to workspace, run:');
+        lines.push(`     opkg install ${report.packageName}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=save-result-reporter.js.map

package/packages/core/dist/core/save/save-result-reporter.js.map

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

package/packages/core/dist/core/save/save-to-source-pipeline.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Save To Source Pipeline
+ *
+ * This module orchestrates the complete save operation, integrating all phases:
+ * - Phase 1: Validation
+ * - Phase 2: Candidate Discovery & Grouping
+ * - Phase 3: Platform Pruning & Filtering
+ * - Phase 4: Conflict Analysis & Resolution
+ * - Phase 5: File Writes
+ * - Phase 6: Result Reporting
+ *
+ * This is the main entry point for the enhanced save command.
+ *
+ * @module save-to-source-pipeline
+ */
+import type { CommandResult } from '../../types/index.js';
+import type { ExecutionContext } from '../../types/execution-context.js';
+/**
+ * Options for save-to-source pipeline
+ */
+export interface SaveToSourceOptions {
+    /** Enable force mode (auto-select newest when conflicts occur) */
+    force?: boolean;
+}
+/**
+ * Run the complete save-to-source pipeline
+ *
+ * This is the main orchestrator function that coordinates all phases
+ * of the save operation:
+ *
+ * 1. **Validate preconditions**: Check package exists, is mutable, has files
+ * 2. **Build candidates**: Discover files in workspace and source
+ * 3. **Group candidates**: Organize by registry path
+ * 4. **Prune platform candidates**: Remove candidates with existing platform files
+ * 5. **Filter active groups**: Keep only groups with workspace changes
+ * 6. **Analyze & resolve**: Classify conflicts and execute resolution strategies
+ * 7. **Write files**: Execute file write operations
+ * 8. **Report results**: Build and return comprehensive report
+ *
+ * @param packageName - Package name to save
+ * @param options - Save options (force mode, etc.)
+ * @returns CommandResult with success status and report data
+ */
+export declare function runSaveToSourcePipeline(packageName: string | undefined, options?: SaveToSourceOptions, ctx?: ExecutionContext): Promise<CommandResult>;
+//# sourceMappingURL=save-to-source-pipeline.d.ts.map

package/packages/core/dist/core/save/save-to-source-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-to-source-pipeline.d.ts","sourceRoot":"","sources":["../../../src/core/save/save-to-source-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAuBzE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAaD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,GAAE,mBAAwB,EACjC,GAAG,CAAC,EAAE,gBAAgB,GACrB,OAAO,CAAC,aAAa,CAAC,CAwIxB"}