@liendev/core 0.19.5

package/README.md

@@ -0,0 +1,336 @@
+# @liendev/core
+
+Core indexing and analysis engine for Lien. This package provides the low-level APIs for semantic code search, complexity analysis, and framework detection.
+
+## Installation
+
+```bash
+npm install @liendev/core
+```
+
+## Usage
+
+```typescript
+import {
+  indexCodebase,
+  VectorDB,
+  ComplexityAnalyzer,
+  loadConfig,
+} from '@liendev/core';
+
+// Index a codebase
+await indexCodebase({
+  rootDir: '/path/to/project',
+});
+
+// Load the vector database
+const db = await VectorDB.load('/path/to/project');
+
+// Run semantic search
+const results = await db.search('authentication logic', { limit: 10 });
+
+// Analyze complexity
+const config = await loadConfig('/path/to/project');
+const analyzer = new ComplexityAnalyzer(db, config);
+const report = await analyzer.analyze();
+
+console.log(`Found ${report.summary.totalViolations} complexity violations`);
+```
+
+## API Reference
+
+### Indexing
+
+#### `indexCodebase(options: IndexingOptions): Promise<IndexingResult>`
+
+Index a codebase for semantic search.
+
+```typescript
+interface IndexingOptions {
+  rootDir?: string;           // Root directory (default: cwd)
+  force?: boolean;            // Force full reindex (default: false)
+  verbose?: boolean;          // Verbose output (default: false)
+  embeddings?: EmbeddingService;  // Pre-initialized embeddings
+  config?: LienConfig;        // Pre-loaded config
+  onProgress?: (progress: IndexingProgress) => void;  // Progress callback
+}
+
+interface IndexingResult {
+  filesIndexed: number;
+  chunksCreated: number;
+  timeMs: number;
+}
+```
+
+**Example:**
+```typescript
+const result = await indexCodebase({
+  rootDir: './my-project',
+  force: true,
+  onProgress: (progress) => {
+    console.log(`Indexed ${progress.filesCompleted}/${progress.totalFiles} files`);
+  },
+});
+
+console.log(`Indexed ${result.filesIndexed} files in ${result.timeMs}ms`);
+```
+
+### Vector Database
+
+#### `VectorDB.load(rootDir: string): Promise<VectorDB>`
+
+Load an existing vector database.
+
+```typescript
+const db = await VectorDB.load('./my-project');
+```
+
+#### `db.search(query: string, options?: SearchOptions): Promise<SearchResult[]>`
+
+Perform semantic search.
+
+```typescript
+interface SearchOptions {
+  limit?: number;              // Max results (default: 5)
+  minScore?: number;          // Min similarity score (default: 0.5)
+  fileFilter?: string[];      // Filter by file paths
+}
+
+const results = await db.search('error handling', {
+  limit: 10,
+  minScore: 0.7,
+  fileFilter: ['src/utils/**'],
+});
+```
+
+### Complexity Analysis
+
+#### `new ComplexityAnalyzer(db: VectorDB, config: LienConfig)`
+
+Create a complexity analyzer.
+
+```typescript
+const config = await loadConfig('./my-project');
+const analyzer = new ComplexityAnalyzer(db, config);
+```
+
+#### `analyzer.analyze(files?: string[]): Promise<ComplexityReport>`
+
+Analyze code complexity. Optionally filter to specific files.
+
+```typescript
+// Analyze all files
+const report = await analyzer.analyze();
+
+// Analyze specific files
+const report = await analyzer.analyze(['src/utils.ts', 'src/parser.ts']);
+
+console.log(`${report.summary.totalViolations} violations found`);
+console.log(`Average complexity: ${report.summary.avgComplexity}`);
+```
+
+#### Complexity Report Structure
+
+```typescript
+interface ComplexityReport {
+  summary: {
+    filesAnalyzed: number;
+    totalViolations: number;
+    bySeverity: { error: number; warning: number };
+    avgComplexity: number;
+    maxComplexity: number;
+  };
+  files: Record<string, FileComplexityData>;
+}
+
+interface FileComplexityData {
+  violations: ComplexityViolation[];
+  dependents: string[];        // Files that import this file
+  testAssociations: string[];  // Test files covering this file
+  riskLevel: 'low' | 'medium' | 'high' | 'critical';
+}
+
+interface ComplexityViolation {
+  filepath: string;
+  startLine: number;
+  endLine: number;
+  symbolName: string;
+  symbolType: 'function' | 'method' | 'class' | 'file';
+  language: string;
+  complexity: number;
+  threshold: number;
+  severity: 'warning' | 'error';
+  metricType: 'cyclomatic' | 'cognitive' | 'halstead_effort' | 'halstead_bugs';
+  halsteadDetails?: HalsteadDetails;
+}
+```
+
+### Configuration
+
+#### `loadConfig(rootDir?: string): Promise<LienConfig>`
+
+Load Lien configuration from `.lien.config.json`.
+
+```typescript
+const config = await loadConfig('./my-project');
+```
+
+#### `saveConfig(rootDir: string, config: LienConfig): Promise<void>`
+
+Save configuration to `.lien.config.json`.
+
+```typescript
+await saveConfig('./my-project', {
+  ...config,
+  complexity: {
+    enabled: true,
+    thresholds: {
+      testPaths: 15,
+      mentalLoad: 15,
+    },
+  },
+});
+```
+
+#### `createDefaultConfig(): LienConfig`
+
+Create a default configuration.
+
+```typescript
+const config = createDefaultConfig();
+```
+
+### Framework Detection
+
+#### `detectAllFrameworks(rootDir: string): Promise<FrameworkInstance[]>`
+
+Detect frameworks in a project.
+
+```typescript
+import { detectAllFrameworks } from '@liendev/core';
+
+const frameworks = await detectAllFrameworks('./my-project');
+
+for (const fw of frameworks) {
+  console.log(`Found ${fw.name} at ${fw.path}`);
+}
+```
+
+### Git Utilities
+
+```typescript
+import {
+  isGitRepo,
+  getCurrentBranch,
+  getCurrentCommit,
+  getChangedFiles,
+} from '@liendev/core';
+
+const isGit = await isGitRepo('./my-project');
+const branch = await getCurrentBranch('./my-project');
+const commit = await getCurrentCommit('./my-project');
+const changed = await getChangedFiles('./my-project');
+```
+
+## Advanced Usage
+
+### Warm Workers (Cloud/Action Use)
+
+Keep embeddings loaded between requests for better performance:
+
+```typescript
+import { LocalEmbeddings, indexCodebase } from '@liendev/core';
+
+// Initialize once
+const embeddings = new LocalEmbeddings();
+await embeddings.initialize();
+
+// Reuse across multiple indexing operations
+for (const project of projects) {
+  await indexCodebase({
+    rootDir: project.path,
+    embeddings,  // Reuse warm embeddings
+  });
+}
+```
+
+### Custom Embedding Service
+
+Implement `EmbeddingService` interface for custom embeddings:
+
+```typescript
+interface EmbeddingService {
+  initialize(): Promise<void>;
+  embed(texts: string[]): Promise<number[][]>;
+  getDimension(): number;
+}
+
+class CustomEmbeddings implements EmbeddingService {
+  async initialize() { /* ... */ }
+  async embed(texts: string[]) { /* ... */ }
+  getDimension() { return 768; }
+}
+
+await indexCodebase({
+  embeddings: new CustomEmbeddings(),
+});
+```
+
+### Progress Tracking
+
+Monitor indexing progress in real-time:
+
+```typescript
+await indexCodebase({
+  rootDir: './large-project',
+  onProgress: (progress) => {
+    const pct = (progress.filesCompleted / progress.totalFiles * 100).toFixed(1);
+    console.log(`[${pct}%] ${progress.filesCompleted}/${progress.totalFiles} files`);
+  },
+});
+```
+
+## Supported Languages
+
+- TypeScript / JavaScript
+- Python
+- PHP
+
+More languages coming soon!
+
+## Performance
+
+- **Embeddings**: Local transformer model (~50ms per chunk)
+- **Vector DB**: LanceDB (Apache Arrow, SIMD-optimized)
+- **Chunking**: AST-based with fallback to line-based
+- **Indexing**: ~1000 LOC/sec on typical hardware
+
+## Architecture
+
+```
+@liendev/core
+├── indexer/         # Code scanning, chunking, AST parsing
+├── embeddings/      # Local embeddings (transformers.js)
+├── vectordb/        # LanceDB wrapper
+├── insights/        # Complexity analysis
+├── config/          # Configuration management
+├── frameworks/      # Framework detection
+└── git/             # Git utilities
+```
+
+## Who Uses This?
+
+- **@liendev/cli** - CLI and MCP server
+- **@liendev/action** - GitHub Action
+- **@liendev/cloud** - Cloud backend (private)
+- **Third-party integrations** - Your custom tools!
+
+## License
+
+MIT
+
+## Links
+
+- [Main Lien Repository](https://github.com/getlien/lien)
+- [Documentation](https://lien.dev)
+- [Issues](https://github.com/getlien/lien/issues)

package/dist/config/loader.d.ts

@@ -0,0 +1,12 @@
+import { LienConfig } from './schema.js';
+/**
+ * @deprecated Use ConfigService.load() instead. This function is kept for backward compatibility.
+ * @see ConfigService
+ */
+export declare function loadConfig(rootDir?: string): Promise<LienConfig>;
+/**
+ * @deprecated Use ConfigService.exists() instead. This function is kept for backward compatibility.
+ * @see ConfigService
+ */
+export declare function configExists(rootDir?: string): Promise<boolean>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAiB,MAAM,aAAa,CAAC;AAIxD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,MAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CAuBrF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,MAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAQpF"}

package/dist/config/loader.js

@@ -0,0 +1,46 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { defaultConfig } from './schema.js';
+import { deepMergeConfig } from './merge.js';
+import { MigrationManager } from './migration-manager.js';
+/**
+ * @deprecated Use ConfigService.load() instead. This function is kept for backward compatibility.
+ * @see ConfigService
+ */
+export async function loadConfig(rootDir = process.cwd()) {
+    const configPath = path.join(rootDir, '.lien.config.json');
+    try {
+        const configContent = await fs.readFile(configPath, 'utf-8');
+        const userConfig = JSON.parse(configContent);
+        // Check if migration is needed
+        const migrationManager = new MigrationManager(rootDir);
+        if (await migrationManager.needsMigration()) {
+            console.log('🔄 Migrating config from v0.2.0 to v0.3.0...');
+            return await migrationManager.autoMigrate();
+        }
+        // Use the shared merge function for consistency
+        return deepMergeConfig(defaultConfig, userConfig);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            // Config doesn't exist, return defaults
+            return defaultConfig;
+        }
+        throw error;
+    }
+}
+/**
+ * @deprecated Use ConfigService.exists() instead. This function is kept for backward compatibility.
+ * @see ConfigService
+ */
+export async function configExists(rootDir = process.cwd()) {
+    const configPath = path.join(rootDir, '.lien.config.json');
+    try {
+        await fs.access(configPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAc,aAAa,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAkB,OAAO,CAAC,GAAG,EAAE;IAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;IAE3D,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAE7C,+BAA+B;QAC/B,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,MAAM,gBAAgB,CAAC,cAAc,EAAE,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;YAC5D,OAAO,MAAM,gBAAgB,CAAC,WAAW,EAAE,CAAC;QAC9C,CAAC;QAED,gDAAgD;QAChD,OAAO,eAAe,CAAC,aAAa,EAAE,UAAiC,CAAC,CAAC;IAC3E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,wCAAwC;YACxC,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAkB,OAAO,CAAC,GAAG,EAAE;IAChE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/config/merge.d.ts

@@ -0,0 +1,20 @@
+import { LienConfig } from './schema.js';
+/**
+ * Deep merges user config with defaults, preserving user customizations.
+ * User values always take precedence over defaults.
+ *
+ * @param defaults - The default configuration
+ * @param user - The user's partial configuration
+ * @returns Complete merged configuration
+ */
+export declare function deepMergeConfig(defaults: LienConfig, user: Partial<LienConfig>): LienConfig;
+/**
+ * Detects new fields that exist in the 'after' config but not in the 'before' config.
+ * Returns a list of human-readable field paths.
+ *
+ * @param before - The existing config (potentially missing fields)
+ * @param after - The complete config with all fields
+ * @returns Array of new field paths (e.g., ["mcp.autoIndexOnFirstRun", "gitDetection"])
+ */
+export declare function detectNewFields(before: Record<string, any>, after: Record<string, any>): string[];
+//# sourceMappingURL=merge.d.ts.map

package/dist/config/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/config/merge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAgC3F;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE,CAwBjG"}

package/dist/config/merge.js

@@ -0,0 +1,71 @@
+/**
+ * Deep merges user config with defaults, preserving user customizations.
+ * User values always take precedence over defaults.
+ *
+ * @param defaults - The default configuration
+ * @param user - The user's partial configuration
+ * @returns Complete merged configuration
+ */
+export function deepMergeConfig(defaults, user) {
+    return {
+        version: user.version ?? defaults.version,
+        core: {
+            ...defaults.core,
+            ...user.core,
+        },
+        chunking: {
+            ...defaults.chunking,
+            ...user.chunking,
+        },
+        mcp: {
+            ...defaults.mcp,
+            ...user.mcp,
+        },
+        gitDetection: {
+            ...defaults.gitDetection,
+            ...user.gitDetection,
+        },
+        fileWatching: {
+            ...defaults.fileWatching,
+            ...user.fileWatching,
+        },
+        complexity: user.complexity ? {
+            enabled: user.complexity.enabled ?? defaults.complexity?.enabled ?? true,
+            thresholds: {
+                ...defaults.complexity?.thresholds,
+                ...(user.complexity.thresholds || {}),
+            },
+        } : defaults.complexity,
+        frameworks: user.frameworks ?? defaults.frameworks,
+    };
+}
+/**
+ * Detects new fields that exist in the 'after' config but not in the 'before' config.
+ * Returns a list of human-readable field paths.
+ *
+ * @param before - The existing config (potentially missing fields)
+ * @param after - The complete config with all fields
+ * @returns Array of new field paths (e.g., ["mcp.autoIndexOnFirstRun", "gitDetection"])
+ */
+export function detectNewFields(before, after) {
+    const newFields = [];
+    // Check top-level sections
+    for (const key of Object.keys(after)) {
+        if (!(key in before)) {
+            newFields.push(key);
+            continue;
+        }
+        // Check nested fields for object sections
+        if (typeof after[key] === 'object' && after[key] !== null && !Array.isArray(after[key])) {
+            const beforeSection = before[key] || {};
+            const afterSection = after[key];
+            for (const nestedKey of Object.keys(afterSection)) {
+                if (!(nestedKey in beforeSection)) {
+                    newFields.push(`${key}.${nestedKey}`);
+                }
+            }
+        }
+    }
+    return newFields;
+}
+//# sourceMappingURL=merge.js.map

package/dist/config/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../src/config/merge.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,QAAoB,EAAE,IAAyB;IAC7E,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO;QACzC,IAAI,EAAE;YACJ,GAAG,QAAQ,CAAC,IAAI;YAChB,GAAG,IAAI,CAAC,IAAI;SACb;QACD,QAAQ,EAAE;YACR,GAAG,QAAQ,CAAC,QAAQ;YACpB,GAAG,IAAI,CAAC,QAAQ;SACjB;QACD,GAAG,EAAE;YACH,GAAG,QAAQ,CAAC,GAAG;YACf,GAAG,IAAI,CAAC,GAAG;SACZ;QACD,YAAY,EAAE;YACZ,GAAG,QAAQ,CAAC,YAAY;YACxB,GAAG,IAAI,CAAC,YAAY;SACrB;QACD,YAAY,EAAE;YACZ,GAAG,QAAQ,CAAC,YAAY;YACxB,GAAG,IAAI,CAAC,YAAY;SACrB;QACD,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAC5B,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,IAAI,QAAQ,CAAC,UAAU,EAAE,OAAO,IAAI,IAAI;YACxE,UAAU,EAAE;gBACV,GAAG,QAAQ,CAAC,UAAU,EAAE,UAAU;gBAClC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,IAAI,EAAE,CAAC;aACtC;SACF,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU;QACvB,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU;KACnD,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,MAA2B,EAAE,KAA0B;IACrF,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,2BAA2B;IAC3B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,EAAE,CAAC;YACrB,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpB,SAAS;QACX,CAAC;QAED,0CAA0C;QAC1C,IAAI,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACxF,MAAM,aAAa,GAAI,MAAM,CAAC,GAAG,CAAyB,IAAI,EAAE,CAAC;YACjE,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAwB,CAAC;YAEvD,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBAClD,IAAI,CAAC,CAAC,SAAS,IAAI,aAAa,CAAC,EAAE,CAAC;oBAClC,SAAS,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/config/migration-manager.d.ts

@@ -0,0 +1,46 @@
+import { LienConfig } from './schema.js';
+/**
+ * Result of a migration operation
+ */
+export interface MigrationResult {
+    migrated: boolean;
+    backupPath?: string;
+    config: LienConfig;
+}
+/**
+ * Centralized migration orchestration service
+ *
+ * Handles all config migration scenarios:
+ * - Auto-migration during config loading
+ * - Interactive upgrade via CLI
+ * - Migration status checking
+ */
+export declare class MigrationManager {
+    private readonly rootDir;
+    private readonly targetVersion;
+    constructor(rootDir?: string, targetVersion?: string);
+    /**
+     * Get the config file path
+     */
+    private getConfigPath;
+    /**
+     * Check if the current config needs migration
+     */
+    needsMigration(): Promise<boolean>;
+    /**
+     * Perform silent migration (for auto-migration during load)
+     * Returns the migrated config without user interaction
+     */
+    autoMigrate(): Promise<LienConfig>;
+    /**
+     * Perform interactive upgrade (for CLI upgrade command)
+     * Provides detailed feedback and handles edge cases
+     */
+    upgradeInteractive(): Promise<void>;
+    /**
+     * Perform migration and return result
+     * Used when programmatic access to migration result is needed
+     */
+    migrate(): Promise<MigrationResult>;
+}
+//# sourceMappingURL=migration-manager.d.ts.map

package/dist/config/migration-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-manager.d.ts","sourceRoot":"","sources":["../../src/config/migration-manager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAiB,MAAM,aAAa,CAAC;AAKxD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa;gBADb,OAAO,GAAE,MAAsB,EAC/B,aAAa,GAAE,MAA+B;IAGjE;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAYxC;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,UAAU,CAAC;IAYxC;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IA+DzC;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC;CAG1C"}

package/dist/config/migration-manager.js

@@ -0,0 +1,119 @@
+import fs from 'fs/promises';
+import path from 'path';
+import chalk from 'chalk';
+import { defaultConfig } from './schema.js';
+import { needsMigration, migrateConfig, migrateConfigFile } from './migration.js';
+import { deepMergeConfig, detectNewFields } from './merge.js';
+import { CURRENT_CONFIG_VERSION } from '../constants.js';
+/**
+ * Centralized migration orchestration service
+ *
+ * Handles all config migration scenarios:
+ * - Auto-migration during config loading
+ * - Interactive upgrade via CLI
+ * - Migration status checking
+ */
+export class MigrationManager {
+    rootDir;
+    targetVersion;
+    constructor(rootDir = process.cwd(), targetVersion = CURRENT_CONFIG_VERSION) {
+        this.rootDir = rootDir;
+        this.targetVersion = targetVersion;
+    }
+    /**
+     * Get the config file path
+     */
+    getConfigPath() {
+        return path.join(this.rootDir, '.lien.config.json');
+    }
+    /**
+     * Check if the current config needs migration
+     */
+    async needsMigration() {
+        try {
+            const configPath = this.getConfigPath();
+            const content = await fs.readFile(configPath, 'utf-8');
+            const config = JSON.parse(content);
+            return needsMigration(config);
+        }
+        catch (error) {
+            // If config doesn't exist or can't be read, no migration needed
+            return false;
+        }
+    }
+    /**
+     * Perform silent migration (for auto-migration during load)
+     * Returns the migrated config without user interaction
+     */
+    async autoMigrate() {
+        const result = await migrateConfigFile(this.rootDir);
+        if (result.migrated && result.backupPath) {
+            const backupFilename = path.basename(result.backupPath);
+            console.log(`✅ Migration complete! Backup saved as ${backupFilename}`);
+            console.log('📝 Your config now uses the framework-based structure.');
+        }
+        return result.config;
+    }
+    /**
+     * Perform interactive upgrade (for CLI upgrade command)
+     * Provides detailed feedback and handles edge cases
+     */
+    async upgradeInteractive() {
+        const configPath = this.getConfigPath();
+        try {
+            // 1. Read existing config
+            const existingContent = await fs.readFile(configPath, 'utf-8');
+            const existingConfig = JSON.parse(existingContent);
+            // 2. Check if any changes are needed
+            const migrationNeeded = needsMigration(existingConfig);
+            const newFields = migrationNeeded ? [] : detectNewFields(existingConfig, defaultConfig);
+            const hasChanges = migrationNeeded || newFields.length > 0;
+            if (!hasChanges) {
+                console.log(chalk.green('✓ Config is already up to date'));
+                console.log(chalk.dim('No changes needed'));
+                return;
+            }
+            // 3. Backup existing config (only if changes are needed)
+            const backupPath = `${configPath}.backup`;
+            await fs.copyFile(configPath, backupPath);
+            // 4. Perform upgrade
+            let upgradedConfig;
+            let migrated = false;
+            if (migrationNeeded) {
+                console.log(chalk.blue(`🔄 Migrating config from v0.2.0 to v${this.targetVersion}...`));
+                upgradedConfig = migrateConfig(existingConfig, this.targetVersion);
+                migrated = true;
+            }
+            else {
+                // Just merge with defaults for current version configs
+                upgradedConfig = deepMergeConfig(defaultConfig, existingConfig);
+                console.log(chalk.dim('\nNew options added:'));
+                newFields.forEach(field => console.log(chalk.dim('  •'), chalk.bold(field)));
+            }
+            // 5. Write upgraded config
+            await fs.writeFile(configPath, JSON.stringify(upgradedConfig, null, 2) + '\n', 'utf-8');
+            // 6. Show results
+            console.log(chalk.green('✓ Config upgraded successfully'));
+            console.log(chalk.dim('Backup saved to:'), backupPath);
+            if (migrated) {
+                console.log(chalk.dim('\n📝 Your config now uses the framework-based structure.'));
+            }
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                console.log(chalk.red('Error: No config file found'));
+                console.log(chalk.dim('Run'), chalk.bold('lien init'), chalk.dim('to create a config file'));
+                return;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Perform migration and return result
+     * Used when programmatic access to migration result is needed
+     */
+    async migrate() {
+        return migrateConfigFile(this.rootDir);
+    }
+}
+//# sourceMappingURL=migration-manager.js.map

package/dist/config/migration-manager.js.map

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