@lumenflow/core 2.10.0 → 2.11.0

package/dist/beacon-migration.js

@@ -1,101 +0,0 @@
-/**
- * @file beacon-migration.ts
- * @description Migration utility for renaming .beacon directories to .lumenflow (WU-1075)
- *
- * This module provides a one-time migration function that renames the legacy
- * .beacon directory to .lumenflow. It's safe to run multiple times - it will
- * only migrate if .beacon exists and .lumenflow does not.
- *
- * @example
- * ```typescript
- * import { migrateBeaconToLumenflow } from '@lumenflow/core';
- *
- * // Run migration in project root
- * const result = migrateBeaconToLumenflow();
- * if (result.migrated) {
- *   console.log('Successfully migrated .beacon/ → .lumenflow/');
- * }
- * ```
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import { LUMENFLOW_PATHS } from './wu-constants.js';
-/** Legacy directory name that was used before v1.5.0 */
-const LEGACY_BEACON_DIR = '.beacon';
-/**
- * Migrate .beacon directory to .lumenflow
- *
- * This function safely renames the legacy .beacon directory to .lumenflow.
- * It handles the following scenarios:
- *
- * - .beacon exists, .lumenflow does not → Migrate (rename)
- * - .beacon does not exist, .lumenflow exists → Already migrated (no-op)
- * - Neither exists → No legacy directory (no-op)
- * - Both exist → Conflict, manual resolution needed
- *
- * @param {string} [baseDir=process.cwd()] - Base directory to check for migration
- * @returns {MigrationResult} Result of the migration attempt
- */
-export function migrateBeaconToLumenflow(baseDir = process.cwd()) {
-    const legacyPath = path.join(baseDir, LEGACY_BEACON_DIR);
-    const newPath = path.join(baseDir, LUMENFLOW_PATHS.BASE);
-    const legacyExists = fs.existsSync(legacyPath);
-    const newExists = fs.existsSync(newPath);
-    // Both exist - conflict
-    if (legacyExists && newExists) {
-        return {
-            migrated: false,
-            reason: 'both_exist',
-            fromPath: legacyPath,
-            toPath: newPath,
-            error: 'Both .beacon and .lumenflow directories exist. ' +
-                'Please manually resolve by removing or merging .beacon into .lumenflow.',
-        };
-    }
-    // Already migrated
-    if (!legacyExists && newExists) {
-        return {
-            migrated: false,
-            reason: 'already_migrated',
-            toPath: newPath,
-        };
-    }
-    // No legacy directory
-    if (!legacyExists && !newExists) {
-        return {
-            migrated: false,
-            reason: 'no_legacy_dir',
-        };
-    }
-    // Migrate: rename .beacon → .lumenflow
-    try {
-        fs.renameSync(legacyPath, newPath);
-        return {
-            migrated: true,
-            reason: 'migrated',
-            fromPath: legacyPath,
-            toPath: newPath,
-        };
-    }
-    catch (err) {
-        const error = err instanceof Error ? err.message : String(err);
-        return {
-            migrated: false,
-            reason: 'migrated',
-            fromPath: legacyPath,
-            toPath: newPath,
-            error: `Failed to rename: ${error}`,
-        };
-    }
-}
-/**
- * Check if migration is needed without performing it
- *
- * @param {string} [baseDir=process.cwd()] - Base directory to check
- * @returns {boolean} True if .beacon exists and .lumenflow does not
- */
-export function needsMigration(baseDir = process.cwd()) {
-    const legacyPath = path.join(baseDir, LEGACY_BEACON_DIR);
-    const newPath = path.join(baseDir, LUMENFLOW_PATHS.BASE);
-    return fs.existsSync(legacyPath) && !fs.existsSync(newPath);
-}