@schnick371/devsteps-shared 1.0.0 → 1.1.0-next.2

package/dist/core/auto-migrate.d.ts

@@ -1,155 +1,40 @@
 /**
- * Auto-Migration Module
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
  *
- * Provides auto-detection and migration for external DevSteps projects.
+ * Auto-Migration Module — Orchestrator
+ *
+ * Provides auto-detection and migration for DevSteps projects.
  * Safely migrates from legacy index.json to refs-style distributed index.
  *
- * Safe to call repeatedly - only migrates once.
+ * Safe to call repeatedly — only migrates once.
  *
  * @see STORY-073 External Project Migration Auto-Detection
  * @see EPIC-018 Index Architecture Refactoring
  */
+import { type AutoMigrationOptions, type MigrationCheckResult, type MigrationStats, checkMigrationNeeded, getMigrationStatusMessage, needsItemsDirectoryMigration } from './auto-migrate-detect.js';
+import { migrateItemsDirectory, performMigration } from './auto-migrate-impl.js';
+export type { AutoMigrationOptions, MigrationCheckResult, MigrationStats };
+export { checkMigrationNeeded, getMigrationStatusMessage, needsItemsDirectoryMigration };
+export { performMigration, migrateItemsDirectory };
 /**
- * Migration check result
- */
-export interface MigrationCheckResult {
-    /** Whether migration is needed */
-    needed: boolean;
-    /** Whether legacy index exists */
-    hasLegacy: boolean;
-    /** Whether refs-style index exists */
-    hasRefs: boolean;
-    /** Number of items in legacy index (if exists) */
-    itemCount?: number;
-    /** Human-readable status message */
-    message: string;
-}
-/**
- * Auto-migration options
- */
-export interface AutoMigrationOptions {
-    /** Skip backup creation (advanced users only) */
-    skipBackup?: boolean;
-    /** Silent mode - suppress console output */
-    silent?: boolean;
-    /** Dry-run mode - check only, don't migrate */
-    dryRun?: boolean;
-}
-/**
- * Migration statistics
- */
-export interface MigrationStats {
-    totalItems: number;
-    byType: Record<string, number>;
-    byStatus: Record<string, number>;
-    byPriority: Record<string, number>;
-    backupPath?: string;
-    archivePath?: string;
-}
-/**
- * Check if migration is needed
- *
- * Migration is needed when:
- * - Legacy index.json exists
- * - Refs-style index/ doesn't exist
- *
- * @param devstepsDir Path to .devsteps directory
- * @returns Migration check result with details
- *
- * @example
- * ```typescript
- * const result = checkMigrationNeeded('/path/to/.devsteps');
- * if (result.needed) {
- *   console.log(result.message);
- *   await ensureIndexMigrated('/path/to/.devsteps');
- * }
- * ```
- */
-export declare function checkMigrationNeeded(devstepsDir: string): MigrationCheckResult;
-/**
- * Perform index migration (internal implementation)
- *
- * This is the core migration logic without console output.
- * Use ensureIndexMigrated() for auto-migration with user feedback.
- *
- * @param devstepsDir Path to .devsteps directory
- * @param options Migration options
- * @returns Migration statistics
- * @throws Error if migration fails or preconditions not met
- * @internal
- */
-export declare function performMigration(devstepsDir: string, options?: AutoMigrationOptions): Promise<MigrationStats>;
-/**
- * Get user-friendly status message
- *
- * @param devstepsDir Path to .devsteps directory
- * @returns Human-readable status message
- *
- * @example
- * ```typescript
- * console.log(getMigrationStatusMessage('/path/to/.devsteps'));
- * // Output: "📦 DevSteps project using refs-style index ✓"
- * ```
- */
-export declare function getMigrationStatusMessage(devstepsDir: string): string;
-/**
- * Automatically migrate if needed
- *
- * Safe to call repeatedly - only migrates once.
- * Checks if migration is needed and runs it if necessary.
+ * Automatically migrate if needed — safe to call repeatedly.
  *
  * @param devstepsDir Path to .devsteps directory
  * @param options Migration options
  * @returns True if migration was performed, false if not needed
  * @throws Error if migration fails
- *
- * @example
- * ```typescript
- * // Auto-migrate with user feedback
- * const migrated = await ensureIndexMigrated('/path/to/.devsteps');
- * if (migrated) {
- *   console.log('✨ Migration complete!');
- * }
- *
- * // Silent auto-migration (for background tasks)
- * await ensureIndexMigrated('/path/to/.devsteps', { silent: true });
- *
- * // Dry-run (check only)
- * const needed = await ensureIndexMigrated('/path/to/.devsteps', { dryRun: true });
- * ```
  */
 export declare function ensureIndexMigrated(devstepsDir: string, options?: AutoMigrationOptions): Promise<boolean>;
 /**
- * Check if items/ directory migration is needed
- *
- * Returns true if using flat structure (epics/, stories/)
- * instead of nested structure (items/epics/, items/stories/)
- */
-export declare function needsItemsDirectoryMigration(devstepsDir: string): boolean;
-/**
- * Migrate from flat directory structure to items/ subdirectory
- *
- * Moves files from:
- *   .devsteps/epics/EPIC-001.json → .devsteps/items/epics/EPIC-001.json
- *   .devsteps/stories/...         → .devsteps/items/stories/...
- *
- * @param devstepsDir Path to .devsteps directory
- * @param options Migration options
- * @returns Migration statistics
- */
-export declare function migrateItemsDirectory(devstepsDir: string, options?: AutoMigrationOptions): {
-    moved: number;
-    types: Record<string, number>;
-};
-/**
- * Ensure index is migrated AND items are in correct directory structure
+ * Ensure index is migrated AND items are in correct directory structure.
  *
- * Combines both migrations:
+ * Combines:
  * 1. Legacy index.json → refs-style index/ (if needed)
  * 2. Flat structure → items/ subdirectory (if needed)
- * 3. Cleanup: Remove legacy index.json if migration complete
+ * 3. Cleanup orphaned legacy index.json if refs-style is valid
  *
- * Safe to call on every operation - only migrates when needed.
+ * Safe to call on every operation — only migrates when needed.
  */
 export declare function ensureFullMigration(devstepsDir: string, options?: AutoMigrationOptions): Promise<void>;
 //# sourceMappingURL=auto-migrate.d.ts.map

package/dist/core/auto-migrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-migrate.d.ts","sourceRoot":"","sources":["../../src/core/auto-migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAwBH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kCAAkC;IAClC,MAAM,EAAE,OAAO,CAAC;IAEhB,kCAAkC;IAClC,SAAS,EAAE,OAAO,CAAC;IAEnB,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IAEjB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,CA2D9E;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,cAAc,CAAC,CAmGzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAqBrE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,OAAO,CAAC,CAoDlB;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAYzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,oBAAyB,GACjC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAgElD;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAmCf"}
+{"version":3,"file":"auto-migrate.d.ts","sourceRoot":"","sources":["../../src/core/auto-migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,4BAA4B,EAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAGjF,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,cAAc,EAAE,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,4BAA4B,EAAE,CAAC;AAEzF,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,CAAC;AAEnD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,OAAO,CAAC,CAuClB;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/core/auto-migrate.js

@@ -1,249 +1,40 @@
 /**
- * Auto-Migration Module
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
  *
- * Provides auto-detection and migration for external DevSteps projects.
+ * Auto-Migration Module — Orchestrator
+ *
+ * Provides auto-detection and migration for DevSteps projects.
  * Safely migrates from legacy index.json to refs-style distributed index.
  *
- * Safe to call repeatedly - only migrates once.
+ * Safe to call repeatedly — only migrates once.
  *
  * @see STORY-073 External Project Migration Auto-Detection
  * @see EPIC-018 Index Architecture Refactoring
  */
-import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmdirSync, writeFileSync, } from 'node:fs';
-import { join } from 'node:path';
-import { TYPE_TO_DIRECTORY } from '../utils/index.js';
-import { addItemToIndex, getIndexPaths, hasLegacyIndex, hasRefsStyleIndex, initializeRefsStyleIndex, loadAllIndexes, loadLegacyIndex, } from './index-refs.js';
-/**
- * Check if migration is needed
- *
- * Migration is needed when:
- * - Legacy index.json exists
- * - Refs-style index/ doesn't exist
- *
- * @param devstepsDir Path to .devsteps directory
- * @returns Migration check result with details
- *
- * @example
- * ```typescript
- * const result = checkMigrationNeeded('/path/to/.devsteps');
- * if (result.needed) {
- *   console.log(result.message);
- *   await ensureIndexMigrated('/path/to/.devsteps');
- * }
- * ```
- */
-export function checkMigrationNeeded(devstepsDir) {
-    if (!existsSync(devstepsDir)) {
-        return {
-            needed: false,
-            hasLegacy: false,
-            hasRefs: false,
-            message: 'Not a DevSteps project (no .devsteps directory)',
-        };
-    }
-    const hasLegacy = hasLegacyIndex(devstepsDir);
-    const hasRefs = hasRefsStyleIndex(devstepsDir);
-    // Already migrated
-    if (!hasLegacy && hasRefs) {
-        return {
-            needed: false,
-            hasLegacy: false,
-            hasRefs: true,
-            message: 'Project already using refs-style index ✓',
-        };
-    }
-    // Both exist - error state (migration partially completed?)
-    if (hasLegacy && hasRefs) {
-        return {
-            needed: false,
-            hasLegacy: true,
-            hasRefs: true,
-            message: 'Both index formats exist - manual intervention required',
-        };
-    }
-    // No index at all - new project
-    if (!hasLegacy && !hasRefs) {
-        return {
-            needed: false,
-            hasLegacy: false,
-            hasRefs: false,
-            message: 'No index found - new project or not initialized',
-        };
-    }
-    // Migration needed
-    let itemCount;
-    try {
-        const legacy = loadLegacyIndex(devstepsDir);
-        itemCount = legacy.items.length;
-    }
-    catch (_error) {
-        // Ignore - legacy index might be corrupted
-    }
-    return {
-        needed: true,
-        hasLegacy: true,
-        hasRefs: false,
-        itemCount,
-        message: `Migration needed: ${itemCount ?? 'unknown'} items to migrate`,
-    };
-}
-/**
- * Perform index migration (internal implementation)
- *
- * This is the core migration logic without console output.
- * Use ensureIndexMigrated() for auto-migration with user feedback.
- *
- * @param devstepsDir Path to .devsteps directory
- * @param options Migration options
- * @returns Migration statistics
- * @throws Error if migration fails or preconditions not met
- * @internal
- */
-export async function performMigration(devstepsDir, options = {}) {
-    const { skipBackup = false } = options;
-    const paths = getIndexPaths(devstepsDir);
-    // Pre-flight checks
-    if (!existsSync(devstepsDir)) {
-        throw new Error('.devsteps directory not found. Is this a DevSteps project?');
-    }
-    if (!hasLegacyIndex(devstepsDir)) {
-        throw new Error('No index.json found. Nothing to migrate.');
-    }
-    if (hasRefsStyleIndex(devstepsDir)) {
-        throw new Error('Refs-style index already exists. Aborting to prevent data loss.');
-    }
-    const stats = {
-        totalItems: 0,
-        byType: {},
-        byStatus: {},
-        byPriority: {},
-    };
-    // Backup old index
-    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-    if (!skipBackup) {
-        const backupPath = `${paths.legacy}.backup-${timestamp}`;
-        const indexContent = readFileSync(paths.legacy, 'utf-8');
-        writeFileSync(backupPath, indexContent);
-        stats.backupPath = backupPath;
-    }
-    // Load and validate old index
-    const indexContent = readFileSync(paths.legacy, 'utf-8');
-    const legacyIndex = JSON.parse(indexContent);
-    const _itemCount = legacyIndex.items.length;
-    // Initialize new index structure
-    initializeRefsStyleIndex(devstepsDir, legacyIndex.counters || {});
-    // Migrate items
-    for (const item of legacyIndex.items) {
-        // Load full metadata for each item to get eisenhower quadrant
-        const typeFolder = TYPE_TO_DIRECTORY[item.type];
-        const metadataPath = join(devstepsDir, typeFolder, `${item.id}.json`);
-        if (!existsSync(metadataPath)) {
-            // Skip items with missing metadata
-            continue;
-        }
-        const metadata = JSON.parse(readFileSync(metadataPath, 'utf-8'));
-        // Ensure eisenhower field exists (old items don't have it)
-        if (!metadata.eisenhower) {
-            metadata.eisenhower = 'not-urgent-important'; // Default Q2
-        }
-        addItemToIndex(devstepsDir, metadata);
-        stats.totalItems++;
-        stats.byType[item.type] = (stats.byType[item.type] || 0) + 1;
-        stats.byStatus[item.status] = (stats.byStatus[item.status] || 0) + 1;
-        stats.byPriority[metadata.eisenhower] = (stats.byPriority[metadata.eisenhower] || 0) + 1;
-    }
-    // Verify migration
-    const newIndexes = loadAllIndexes(devstepsDir);
-    // Count items in new index
-    let newItemCount = 0;
-    for (const items of newIndexes.byType.values()) {
-        newItemCount += items.length;
-    }
-    if (newItemCount !== stats.totalItems) {
-        throw new Error(`Item count mismatch! Migrated: ${stats.totalItems}, Verified: ${newItemCount}`);
-    }
-    // Check for duplicates
-    const allIds = new Set();
-    for (const items of newIndexes.byType.values()) {
-        for (const id of items) {
-            if (allIds.has(id)) {
-                throw new Error(`Duplicate item detected: ${id}`);
-            }
-            allIds.add(id);
-        }
-    }
-    // Archive old index
-    const archivePath = `${paths.legacy}.archived-${timestamp}`;
-    renameSync(paths.legacy, archivePath);
-    stats.archivePath = archivePath;
-    return stats;
-}
-/**
- * Get user-friendly status message
- *
- * @param devstepsDir Path to .devsteps directory
- * @returns Human-readable status message
- *
- * @example
- * ```typescript
- * console.log(getMigrationStatusMessage('/path/to/.devsteps'));
- * // Output: "📦 DevSteps project using refs-style index ✓"
- * ```
- */
-export function getMigrationStatusMessage(devstepsDir) {
-    const result = checkMigrationNeeded(devstepsDir);
-    if (!existsSync(devstepsDir)) {
-        return '❌ Not a DevSteps project';
-    }
-    if (result.needed) {
-        const count = result.itemCount ?? 'unknown';
-        return `🔄 Migration available: ${count} items can be migrated to refs-style index`;
-    }
-    if (result.hasRefs) {
-        return '✅ Project using refs-style index';
-    }
-    if (result.hasLegacy && result.hasRefs) {
-        return '⚠️  Both index formats detected - manual cleanup needed';
-    }
-    return '📦 DevSteps project (no index yet)';
-}
+import { existsSync, renameSync } from 'node:fs';
+import { getIndexPaths, hasRefsStyleIndex, loadAllIndexes } from './index-refs.js';
+import { checkMigrationNeeded, getMigrationStatusMessage, needsItemsDirectoryMigration, } from './auto-migrate-detect.js';
+import { migrateItemsDirectory, performMigration } from './auto-migrate-impl.js';
+export { checkMigrationNeeded, getMigrationStatusMessage, needsItemsDirectoryMigration };
+// Re-export impl functions (callers may import directly from auto-migrate)
+export { performMigration, migrateItemsDirectory };
 /**
- * Automatically migrate if needed
- *
- * Safe to call repeatedly - only migrates once.
- * Checks if migration is needed and runs it if necessary.
+ * Automatically migrate if needed — safe to call repeatedly.
  *
  * @param devstepsDir Path to .devsteps directory
  * @param options Migration options
  * @returns True if migration was performed, false if not needed
  * @throws Error if migration fails
- *
- * @example
- * ```typescript
- * // Auto-migrate with user feedback
- * const migrated = await ensureIndexMigrated('/path/to/.devsteps');
- * if (migrated) {
- *   console.log('✨ Migration complete!');
- * }
- *
- * // Silent auto-migration (for background tasks)
- * await ensureIndexMigrated('/path/to/.devsteps', { silent: true });
- *
- * // Dry-run (check only)
- * const needed = await ensureIndexMigrated('/path/to/.devsteps', { dryRun: true });
- * ```
  */
 export async function ensureIndexMigrated(devstepsDir, options = {}) {
     const { silent = false, dryRun = false } = options;
-    // Check if migration needed
     const check = checkMigrationNeeded(devstepsDir);
     if (!check.needed) {
-        if (!silent && check.hasRefs) {
+        if (!silent && check.hasRefs)
             console.log('✅ Project already using refs-style index');
-        }
         return false;
     }
-    // Dry-run mode - just report
     if (dryRun) {
         if (!silent) {
             console.log('🔍 Migration Check (Dry-Run)');
@@ -254,7 +45,6 @@ export async function ensureIndexMigrated(devstepsDir, options = {}) {
         }
         return true;
     }
-    // Run migration
     if (!silent) {
         console.log('📦 DevSteps Project Detected');
         console.log(`🔍 Legacy index.json found (${check.itemCount ?? 'unknown'} items)`);
@@ -262,145 +52,53 @@ export async function ensureIndexMigrated(devstepsDir, options = {}) {
         console.log('🔄 Auto-migrating...\n');
     }
     try {
-        // Run migration
         const stats = await performMigration(devstepsDir, options);
         if (!silent) {
-            if (stats.backupPath) {
+            if (stats.backupPath)
                 console.log(`   ✅ Backed up to: ${stats.backupPath}`);
-            }
             console.log(`   ✅ Verified: ${stats.totalItems} items migrated`);
             console.log('✨ Migration complete!\n');
         }
         return true;
     }
     catch (error) {
-        if (!silent) {
+        if (!silent)
             console.error('❌ Migration failed:', error instanceof Error ? error.message : String(error));
-        }
         throw error;
     }
 }
 /**
- * Check if items/ directory migration is needed
- *
- * Returns true if using flat structure (epics/, stories/)
- * instead of nested structure (items/epics/, items/stories/)
- */
-export function needsItemsDirectoryMigration(devstepsDir) {
-    // Check if old flat structure exists
-    const hasOldStructure = existsSync(join(devstepsDir, 'epics')) ||
-        existsSync(join(devstepsDir, 'stories')) ||
-        existsSync(join(devstepsDir, 'tasks'));
-    // Check if new items/ structure exists
-    const hasNewStructure = existsSync(join(devstepsDir, 'items'));
-    // Need migration if old exists and new doesn't
-    return hasOldStructure && !hasNewStructure;
-}
-/**
- * Migrate from flat directory structure to items/ subdirectory
- *
- * Moves files from:
- *   .devsteps/epics/EPIC-001.json → .devsteps/items/epics/EPIC-001.json
- *   .devsteps/stories/...         → .devsteps/items/stories/...
- *
- * @param devstepsDir Path to .devsteps directory
- * @param options Migration options
- * @returns Migration statistics
- */
-export function migrateItemsDirectory(devstepsDir, options = {}) {
-    const { silent = false } = options;
-    if (!silent) {
-        console.log('📂 Migrating to items/ directory structure...');
-    }
-    const oldDirs = [
-        'epics',
-        'stories',
-        'tasks',
-        'bugs',
-        'spikes',
-        'tests',
-        'requirements',
-        'features',
-    ];
-    const stats = { moved: 0, types: {} };
-    // Create items/ directory
-    const itemsDir = join(devstepsDir, 'items');
-    if (!existsSync(itemsDir)) {
-        mkdirSync(itemsDir, { recursive: true });
-    }
-    // Move each type directory
-    for (const dirName of oldDirs) {
-        const oldPath = join(devstepsDir, dirName);
-        const newPath = join(itemsDir, dirName);
-        if (!existsSync(oldPath))
-            continue;
-        // Create new subdirectory
-        mkdirSync(newPath, { recursive: true });
-        // Move all files
-        const files = readdirSync(oldPath);
-        let count = 0;
-        for (const file of files) {
-            const srcPath = join(oldPath, file);
-            const dstPath = join(newPath, file);
-            // Use renameSync for atomic move
-            renameSync(srcPath, dstPath);
-            count++;
-        }
-        stats.types[dirName] = count;
-        stats.moved += count;
-        // Remove old empty directory (best effort)
-        try {
-            rmdirSync(oldPath);
-        }
-        catch {
-            // Directory not empty or other error - ignore
-        }
-    }
-    if (!silent) {
-        console.log(`   ✅ Moved ${stats.moved} files to items/ subdirectories`);
-    }
-    return stats;
-}
-/**
- * Ensure index is migrated AND items are in correct directory structure
+ * Ensure index is migrated AND items are in correct directory structure.
  *
- * Combines both migrations:
+ * Combines:
  * 1. Legacy index.json → refs-style index/ (if needed)
  * 2. Flat structure → items/ subdirectory (if needed)
- * 3. Cleanup: Remove legacy index.json if migration complete
+ * 3. Cleanup orphaned legacy index.json if refs-style is valid
  *
- * Safe to call on every operation - only migrates when needed.
+ * Safe to call on every operation — only migrates when needed.
  */
 export async function ensureFullMigration(devstepsDir, options = {}) {
     const { silent = false } = options;
-    // Step 1: Index migration (legacy → refs-style)
     await ensureIndexMigrated(devstepsDir, options);
-    // Step 2: Directory structure migration (flat → items/)
     if (needsItemsDirectoryMigration(devstepsDir)) {
         migrateItemsDirectory(devstepsDir, options);
     }
-    // Step 3: Cleanup legacy index.json if both exist (partial migration state)
-    // This can happen if index migration completed but archiving failed
+    // Cleanup: archive stale legacy index.json if refs-style is valid
     const paths = getIndexPaths(devstepsDir);
     if (hasRefsStyleIndex(devstepsDir) && existsSync(paths.legacy)) {
-        // Verify refs-style index is valid before removing legacy
         try {
             const indexes = loadAllIndexes(devstepsDir);
             if (indexes.byType.size > 0) {
-                // Refs-style index is valid - safe to remove legacy
                 const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
                 const archivePath = `${paths.legacy}.archived-${timestamp}`;
                 renameSync(paths.legacy, archivePath);
-                if (!silent) {
+                if (!silent)
                     console.log(`   🗑️  Archived legacy index: ${archivePath}`);
-                }
             }
         }
         catch (_error) {
-            // If refs-style index is invalid, keep legacy as fallback
-            if (!silent) {
+            if (!silent)
                 console.warn('   ⚠️  Keeping legacy index.json (refs-style index validation failed)');
-            }
         }
     }
 }

package/dist/core/auto-migrate.js.map

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

package/dist/core/bulk-update.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Bulk update operations
+ * Batch tag management and field patching across multiple work items.
+ */
 import type { ItemMetadata } from '../schemas/index.js';
 export interface BulkUpdateResult {
     success: string[];

package/dist/core/bulk-update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bulk-update.d.ts","sourceRoot":"","sources":["../../src/core/bulk-update.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKxD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAuB3B;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAiD3B;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,gBAAgB,CAAC,CA4C3B"}
+{"version":3,"file":"bulk-update.d.ts","sourceRoot":"","sources":["../../src/core/bulk-update.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKxD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAuB3B;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAiD3B;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,gBAAgB,CAAC,CA4C3B"}

package/dist/core/bulk-update.js

@@ -1,3 +1,10 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Bulk update operations
+ * Batch tag management and field patching across multiple work items.
+ */
 import { existsSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { getCurrentTimestamp } from '../utils/index.js';