@tulex-cli/tulex-code 0.1.1

package/dist/src/config/migration/scheduler.test.js

@@ -0,0 +1,129 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { MigrationScheduler } from './scheduler.js';
+describe('MigrationScheduler', () => {
+    // Mock migration for testing
+    const createMockMigration = (fromVersion, toVersion, shouldMigrateResult) => ({
+        fromVersion,
+        toVersion,
+        shouldMigrate: vi.fn().mockReturnValue(shouldMigrateResult),
+        migrate: vi.fn((settings) => ({
+            settings: {
+                ...settings,
+                $version: toVersion,
+            },
+            warnings: [],
+        })),
+    });
+    it('should execute migrations in order when shouldMigrate returns true', () => {
+        const migration1 = createMockMigration(1, 2, true);
+        const migration2 = createMockMigration(2, 3, true);
+        const scheduler = new MigrationScheduler([migration1, migration2], 'user');
+        const result = scheduler.migrate({ $version: 1, someKey: 'value' });
+        expect(migration1.shouldMigrate).toHaveBeenCalledTimes(1);
+        expect(migration1.migrate).toHaveBeenCalledTimes(1);
+        expect(migration2.shouldMigrate).toHaveBeenCalledTimes(1);
+        expect(migration2.migrate).toHaveBeenCalledTimes(1);
+        expect(result.executedMigrations).toHaveLength(2);
+        expect(result.executedMigrations[0]).toEqual({
+            fromVersion: 1,
+            toVersion: 2,
+        });
+        expect(result.executedMigrations[1]).toEqual({
+            fromVersion: 2,
+            toVersion: 3,
+        });
+        expect(result.finalVersion).toBe(3);
+    });
+    it('should skip migrations when shouldMigrate returns false', () => {
+        const migration1 = createMockMigration(1, 2, false);
+        const migration2 = createMockMigration(2, 3, true);
+        const scheduler = new MigrationScheduler([migration1, migration2], 'user');
+        const result = scheduler.migrate({ $version: 2, someKey: 'value' });
+        expect(migration1.shouldMigrate).toHaveBeenCalledTimes(1);
+        expect(migration1.migrate).not.toHaveBeenCalled();
+        expect(migration2.shouldMigrate).toHaveBeenCalledTimes(1);
+        expect(migration2.migrate).toHaveBeenCalledTimes(1);
+        expect(result.executedMigrations).toHaveLength(1);
+        expect(result.executedMigrations[0]).toEqual({
+            fromVersion: 2,
+            toVersion: 3,
+        });
+    });
+    it('should be idempotent - running migrations twice produces same result', () => {
+        // Create a migration that checks the version to determine if migration is needed
+        const migration1 = {
+            fromVersion: 1,
+            toVersion: 2,
+            shouldMigrate: vi.fn((settings) => {
+                const s = settings;
+                return s['$version'] !== 2;
+            }),
+            migrate: vi.fn((settings) => ({
+                settings: {
+                    ...settings,
+                    $version: 2,
+                },
+                warnings: [],
+            })),
+        };
+        const scheduler = new MigrationScheduler([migration1], 'user');
+        const input = { theme: 'dark' };
+        const result1 = scheduler.migrate(input);
+        const result2 = scheduler.migrate(result1.settings);
+        expect(result1.executedMigrations).toHaveLength(1);
+        expect(result2.executedMigrations).toHaveLength(0);
+        expect(result1.finalVersion).toBe(result2.finalVersion);
+    });
+    it('should pass updated settings to each migration', () => {
+        const migration1 = {
+            fromVersion: 1,
+            toVersion: 2,
+            shouldMigrate: vi.fn().mockReturnValue(true),
+            migrate: vi.fn(() => ({
+                settings: { $version: 2, transformed: true },
+                warnings: [],
+            })),
+        };
+        const migration2 = {
+            fromVersion: 2,
+            toVersion: 3,
+            shouldMigrate: vi.fn().mockReturnValue(true),
+            migrate: vi.fn((s) => ({ settings: s, warnings: [] })),
+        };
+        const scheduler = new MigrationScheduler([migration1, migration2], 'user');
+        scheduler.migrate({ $version: 1 });
+        expect(migration2.shouldMigrate).toHaveBeenCalledWith(expect.objectContaining({ $version: 2, transformed: true }));
+    });
+    it('should handle empty migrations array', () => {
+        const scheduler = new MigrationScheduler([], 'user');
+        const result = scheduler.migrate({ $version: 1, key: 'value' });
+        expect(result.executedMigrations).toHaveLength(0);
+        expect(result.finalVersion).toBe(1);
+        expect(result.settings).toEqual({ $version: 1, key: 'value' });
+    });
+    it('should throw error when migration fails', () => {
+        const migration1 = {
+            fromVersion: 1,
+            toVersion: 2,
+            shouldMigrate: vi.fn().mockReturnValue(true),
+            migrate: vi.fn().mockImplementation(() => {
+                throw new Error('Migration failed');
+            }),
+        };
+        const scheduler = new MigrationScheduler([migration1], 'user');
+        expect(() => scheduler.migrate({ $version: 1 })).toThrow('Migration failed');
+    });
+    it('should handle settings without version field', () => {
+        const migration1 = createMockMigration(1, 2, true);
+        const scheduler = new MigrationScheduler([migration1], 'user');
+        const result = scheduler.migrate({ theme: 'dark' });
+        expect(result.finalVersion).toBe(2);
+        expect(result.executedMigrations).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=scheduler.test.js.map

package/dist/src/config/migration/scheduler.test.js.map

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

package/dist/src/config/migration/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Interface that all settings migrations must implement.
+ * Each migration handles a single version transition (N → N+1).
+ */
+export interface SettingsMigration {
+    /** Source version number */
+    readonly fromVersion: number;
+    /** Target version number */
+    readonly toVersion: number;
+    /**
+     * Determines whether this migration should be applied to the given settings.
+     * The migration inspects the settings object to detect its current version
+     * and returns true if this migration is applicable.
+     *
+     * @param settings - The current settings object
+     * @returns true if this migration should be applied, false otherwise
+     */
+    shouldMigrate(settings: unknown): boolean;
+    /**
+     * Executes the migration transformation.
+     * This should be a pure function that does not modify the input object.
+     *
+     * @param settings - The current settings object of version N
+     * @param scope - The scope of settings being migrated
+     * @returns The migrated settings object of version N+1 with optional warnings
+     * @throws Error if the migration fails
+     */
+    migrate(settings: unknown, scope: string): {
+        settings: unknown;
+        warnings: string[];
+    };
+}
+/**
+ * Result of a migration execution by MigrationScheduler.
+ */
+export interface MigrationResult {
+    /** The final settings object after all applicable migrations */
+    settings: unknown;
+    /** The final version number after migrations */
+    finalVersion: number;
+    /** List of migrations that were executed */
+    executedMigrations: Array<{
+        fromVersion: number;
+        toVersion: number;
+    }>;
+    /** List of warning messages generated during migration */
+    warnings: string[];
+}

package/dist/src/config/migration/types.js

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/config/migration/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/config/migration/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/src/config/migration/versions/v1-to-v2-shared.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Structural mapping table for V1 -> V2.
+ *
+ * Used by:
+ * - v1->v2 migration execution
+ * - warnings for residual legacy keys in latest-version settings files
+ */
+export declare const V1_TO_V2_MIGRATION_MAP: Record<string, string>;
+/**
+ * Top-level keys that are V2/V3 containers.
+ * If one of these keys already has object value, treat it as latest-format data.
+ */
+export declare const V2_CONTAINER_KEYS: Set<string>;
+/**
+ * Legacy disable* keys that remain in disable* form for V2.
+ */
+export declare const V1_TO_V2_PRESERVE_DISABLE_MAP: Record<string, string>;
+export declare const CONSOLIDATED_DISABLE_KEYS: Set<string>;
+/**
+ * Keys that indicate V1-like top-level structure when holding primitive values.
+ */
+export declare const V1_INDICATOR_KEYS: string[];

package/dist/src/config/migration/versions/v1-to-v2-shared.js

@@ -0,0 +1,174 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Structural mapping table for V1 -> V2.
+ *
+ * Used by:
+ * - v1->v2 migration execution
+ * - warnings for residual legacy keys in latest-version settings files
+ */
+export const V1_TO_V2_MIGRATION_MAP = {
+    accessibility: 'ui.accessibility',
+    allowedTools: 'tools.allowed',
+    allowMCPServers: 'mcp.allowed',
+    autoAccept: 'tools.autoAccept',
+    autoConfigureMaxOldSpaceSize: 'advanced.autoConfigureMemory',
+    bugCommand: 'advanced.bugCommand',
+    chatCompression: 'model.chatCompression',
+    checkpointing: 'general.checkpointing',
+    coreTools: 'tools.core',
+    contextFileName: 'context.fileName',
+    customThemes: 'ui.customThemes',
+    customWittyPhrases: 'ui.customWittyPhrases',
+    debugKeystrokeLogging: 'general.debugKeystrokeLogging',
+    dnsResolutionOrder: 'advanced.dnsResolutionOrder',
+    enforcedAuthType: 'security.auth.enforcedType',
+    excludeTools: 'tools.exclude',
+    excludeMCPServers: 'mcp.excluded',
+    excludedProjectEnvVars: 'advanced.excludedEnvVars',
+    extensions: 'extensions',
+    fileFiltering: 'context.fileFiltering',
+    folderTrustFeature: 'security.folderTrust.featureEnabled',
+    folderTrust: 'security.folderTrust.enabled',
+    hasSeenIdeIntegrationNudge: 'ide.hasSeenNudge',
+    hideWindowTitle: 'ui.hideWindowTitle',
+    showStatusInTitle: 'ui.showStatusInTitle',
+    hideTips: 'ui.hideTips',
+    showLineNumbers: 'ui.showLineNumbers',
+    showCitations: 'ui.showCitations',
+    ideMode: 'ide.enabled',
+    includeDirectories: 'context.includeDirectories',
+    loadMemoryFromIncludeDirectories: 'context.loadFromIncludeDirectories',
+    maxSessionTurns: 'model.maxSessionTurns',
+    mcpServers: 'mcpServers',
+    mcpServerCommand: 'mcp.serverCommand',
+    memoryImportFormat: 'context.importFormat',
+    model: 'model.name',
+    preferredEditor: 'general.preferredEditor',
+    sandbox: 'tools.sandbox',
+    selectedAuthType: 'security.auth.selectedType',
+    shouldUseNodePtyShell: 'tools.shell.enableInteractiveShell',
+    shellPager: 'tools.shell.pager',
+    shellShowColor: 'tools.shell.showColor',
+    skipNextSpeakerCheck: 'model.skipNextSpeakerCheck',
+    telemetry: 'telemetry',
+    theme: 'ui.theme',
+    toolDiscoveryCommand: 'tools.discoveryCommand',
+    toolCallCommand: 'tools.callCommand',
+    usageStatisticsEnabled: 'privacy.usageStatisticsEnabled',
+    useExternalAuth: 'security.auth.useExternal',
+    useRipgrep: 'tools.useRipgrep',
+    vimMode: 'general.vimMode',
+    enableWelcomeBack: 'ui.enableWelcomeBack',
+    approvalMode: 'tools.approvalMode',
+    sessionTokenLimit: 'model.sessionTokenLimit',
+    contentGenerator: 'model.generationConfig',
+    skipLoopDetection: 'model.skipLoopDetection',
+    skipStartupContext: 'model.skipStartupContext',
+    enableOpenAILogging: 'model.enableOpenAILogging',
+    tavilyApiKey: 'advanced.tavilyApiKey',
+};
+/**
+ * Top-level keys that are V2/V3 containers.
+ * If one of these keys already has object value, treat it as latest-format data.
+ */
+export const V2_CONTAINER_KEYS = new Set([
+    'ui',
+    'tools',
+    'mcp',
+    'advanced',
+    'model',
+    'general',
+    'context',
+    'security',
+    'ide',
+    'privacy',
+    'telemetry',
+    'extensions',
+]);
+/**
+ * Legacy disable* keys that remain in disable* form for V2.
+ */
+export const V1_TO_V2_PRESERVE_DISABLE_MAP = {
+    disableAutoUpdate: 'general.disableAutoUpdate',
+    disableUpdateNag: 'general.disableUpdateNag',
+    disableLoadingPhrases: 'ui.accessibility.disableLoadingPhrases',
+    disableFuzzySearch: 'context.fileFiltering.disableFuzzySearch',
+    disableCacheControl: 'model.generationConfig.disableCacheControl',
+};
+export const CONSOLIDATED_DISABLE_KEYS = new Set([
+    'disableAutoUpdate',
+    'disableUpdateNag',
+]);
+/**
+ * Keys that indicate V1-like top-level structure when holding primitive values.
+ */
+export const V1_INDICATOR_KEYS = [
+    // From V1_TO_V2_MIGRATION_MAP - keys that map to different paths in V2
+    'theme',
+    'model',
+    'autoAccept',
+    'hideTips',
+    'vimMode',
+    'checkpointing',
+    'accessibility',
+    'allowedTools',
+    'allowMCPServers',
+    'autoConfigureMaxOldSpaceSize',
+    'bugCommand',
+    'chatCompression',
+    'coreTools',
+    'contextFileName',
+    'customThemes',
+    'customWittyPhrases',
+    'debugKeystrokeLogging',
+    'dnsResolutionOrder',
+    'enforcedAuthType',
+    'excludeTools',
+    'excludeMCPServers',
+    'excludedProjectEnvVars',
+    'fileFiltering',
+    'folderTrustFeature',
+    'folderTrust',
+    'hasSeenIdeIntegrationNudge',
+    'hideWindowTitle',
+    'showStatusInTitle',
+    'showLineNumbers',
+    'showCitations',
+    'ideMode',
+    'includeDirectories',
+    'loadMemoryFromIncludeDirectories',
+    'maxSessionTurns',
+    'mcpServerCommand',
+    'memoryImportFormat',
+    'preferredEditor',
+    'sandbox',
+    'selectedAuthType',
+    'shouldUseNodePtyShell',
+    'shellPager',
+    'shellShowColor',
+    'skipNextSpeakerCheck',
+    'toolDiscoveryCommand',
+    'toolCallCommand',
+    'usageStatisticsEnabled',
+    'useExternalAuth',
+    'useRipgrep',
+    'enableWelcomeBack',
+    'approvalMode',
+    'sessionTokenLimit',
+    'contentGenerator',
+    'skipLoopDetection',
+    'skipStartupContext',
+    'enableOpenAILogging',
+    'tavilyApiKey',
+    // From V1_TO_V2_PRESERVE_DISABLE_MAP - disable* keys that get nested in V2
+    'disableAutoUpdate',
+    'disableUpdateNag',
+    'disableLoadingPhrases',
+    'disableFuzzySearch',
+    'disableCacheControl',
+];
+//# sourceMappingURL=v1-to-v2-shared.js.map

package/dist/src/config/migration/versions/v1-to-v2-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1-to-v2-shared.js","sourceRoot":"","sources":["../../../../../src/config/migration/versions/v1-to-v2-shared.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA2B;IAC5D,aAAa,EAAE,kBAAkB;IACjC,YAAY,EAAE,eAAe;IAC7B,eAAe,EAAE,aAAa;IAC9B,UAAU,EAAE,kBAAkB;IAC9B,4BAA4B,EAAE,8BAA8B;IAC5D,UAAU,EAAE,qBAAqB;IACjC,eAAe,EAAE,uBAAuB;IACxC,aAAa,EAAE,uBAAuB;IACtC,SAAS,EAAE,YAAY;IACvB,eAAe,EAAE,kBAAkB;IACnC,YAAY,EAAE,iBAAiB;IAC/B,kBAAkB,EAAE,uBAAuB;IAC3C,qBAAqB,EAAE,+BAA+B;IACtD,kBAAkB,EAAE,6BAA6B;IACjD,gBAAgB,EAAE,4BAA4B;IAC9C,YAAY,EAAE,eAAe;IAC7B,iBAAiB,EAAE,cAAc;IACjC,sBAAsB,EAAE,0BAA0B;IAClD,UAAU,EAAE,YAAY;IACxB,aAAa,EAAE,uBAAuB;IACtC,kBAAkB,EAAE,qCAAqC;IACzD,WAAW,EAAE,8BAA8B;IAC3C,0BAA0B,EAAE,kBAAkB;IAC9C,eAAe,EAAE,oBAAoB;IACrC,iBAAiB,EAAE,sBAAsB;IACzC,QAAQ,EAAE,aAAa;IACvB,eAAe,EAAE,oBAAoB;IACrC,aAAa,EAAE,kBAAkB;IACjC,OAAO,EAAE,aAAa;IACtB,kBAAkB,EAAE,4BAA4B;IAChD,gCAAgC,EAAE,oCAAoC;IACtE,eAAe,EAAE,uBAAuB;IACxC,UAAU,EAAE,YAAY;IACxB,gBAAgB,EAAE,mBAAmB;IACrC,kBAAkB,EAAE,sBAAsB;IAC1C,KAAK,EAAE,YAAY;IACnB,eAAe,EAAE,yBAAyB;IAC1C,OAAO,EAAE,eAAe;IACxB,gBAAgB,EAAE,4BAA4B;IAC9C,qBAAqB,EAAE,oCAAoC;IAC3D,UAAU,EAAE,mBAAmB;IAC/B,cAAc,EAAE,uBAAuB;IACvC,oBAAoB,EAAE,4BAA4B;IAClD,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,UAAU;IACjB,oBAAoB,EAAE,wBAAwB;IAC9C,eAAe,EAAE,mBAAmB;IACpC,sBAAsB,EAAE,gCAAgC;IACxD,eAAe,EAAE,2BAA2B;IAC5C,UAAU,EAAE,kBAAkB;IAC9B,OAAO,EAAE,iBAAiB;IAC1B,iBAAiB,EAAE,sBAAsB;IACzC,YAAY,EAAE,oBAAoB;IAClC,iBAAiB,EAAE,yBAAyB;IAC5C,gBAAgB,EAAE,wBAAwB;IAC1C,iBAAiB,EAAE,yBAAyB;IAC5C,kBAAkB,EAAE,0BAA0B;IAC9C,mBAAmB,EAAE,2BAA2B;IAChD,YAAY,EAAE,uBAAuB;CACtC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IACvC,IAAI;IACJ,OAAO;IACP,KAAK;IACL,UAAU;IACV,OAAO;IACP,SAAS;IACT,SAAS;IACT,UAAU;IACV,KAAK;IACL,SAAS;IACT,WAAW;IACX,YAAY;CACb,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAA2B;IACnE,iBAAiB,EAAE,2BAA2B;IAC9C,gBAAgB,EAAE,0BAA0B;IAC5C,qBAAqB,EAAE,wCAAwC;IAC/D,kBAAkB,EAAE,0CAA0C;IAC9D,mBAAmB,EAAE,4CAA4C;CAClE,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC;IAC/C,mBAAmB;IACnB,kBAAkB;CACnB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,uEAAuE;IACvE,OAAO;IACP,OAAO;IACP,YAAY;IACZ,UAAU;IACV,SAAS;IACT,eAAe;IACf,eAAe;IACf,cAAc;IACd,iBAAiB;IACjB,8BAA8B;IAC9B,YAAY;IACZ,iBAAiB;IACjB,WAAW;IACX,iBAAiB;IACjB,cAAc;IACd,oBAAoB;IACpB,uBAAuB;IACvB,oBAAoB;IACpB,kBAAkB;IAClB,cAAc;IACd,mBAAmB;IACnB,wBAAwB;IACxB,eAAe;IACf,oBAAoB;IACpB,aAAa;IACb,4BAA4B;IAC5B,iBAAiB;IACjB,mBAAmB;IACnB,iBAAiB;IACjB,eAAe;IACf,SAAS;IACT,oBAAoB;IACpB,kCAAkC;IAClC,iBAAiB;IACjB,kBAAkB;IAClB,oBAAoB;IACpB,iBAAiB;IACjB,SAAS;IACT,kBAAkB;IAClB,uBAAuB;IACvB,YAAY;IACZ,gBAAgB;IAChB,sBAAsB;IACtB,sBAAsB;IACtB,iBAAiB;IACjB,wBAAwB;IACxB,iBAAiB;IACjB,YAAY;IACZ,mBAAmB;IACnB,cAAc;IACd,mBAAmB;IACnB,kBAAkB;IAClB,mBAAmB;IACnB,oBAAoB;IACpB,qBAAqB;IACrB,cAAc;IACd,2EAA2E;IAC3E,mBAAmB;IACnB,kBAAkB;IAClB,uBAAuB;IACvB,oBAAoB;IACpB,qBAAqB;CACtB,CAAC"}

package/dist/src/config/migration/versions/v1-to-v2.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { SettingsMigration } from '../types.js';
+/**
+ * Heuristic indicators for deciding whether an object is "V1-like".
+ *
+ * Detection strategy:
+ * - A file is considered migratable as V1 when:
+ *   1) It is not explicitly versioned as V2+ (`$version` is missing or invalid), and
+ *   2) At least one indicator key appears in a legacy-compatible top-level shape.
+ * - Indicator list intentionally excludes keys that are valid top-level entries in
+ *   both old and new structures to reduce false positives.
+ *
+ * Shape rule:
+ * - Object values for indicator keys are treated as already-nested V2-like content
+ *   and do not alone trigger migration.
+ * - Primitive/array/null values on indicator keys are treated as legacy V1 signals.
+ */
+/**
+ * V1 -> V2 migration (structural normalization stage).
+ *
+ * Migration contract:
+ * - Input: settings in legacy V1-like shape (mostly flat, may contain mixed partial V2).
+ * - Output: V2-compatible nested structure with `$version: 2`.
+ * - No semantic inversion of disable* naming in this stage.
+ *
+ * Data-preservation strategy:
+ * - Prefer transforming known keys into canonical V2 locations.
+ * - Preserve unrecognized keys verbatim.
+ * - Preserve parent-path scalar values when nested writes would collide with them.
+ * - Preserve/merge existing partial V2 objects where safe.
+ *
+ * This class intentionally optimizes for backward compatibility and non-destructive
+ * behavior over aggressive normalization.
+ */
+export declare class V1ToV2Migration implements SettingsMigration {
+    readonly fromVersion = 1;
+    readonly toVersion = 2;
+    /**
+     * Determines whether this migration should execute.
+     *
+     * Decision strategy:
+     * - Hard-stop when `$version` is a number >= 2 (already V2+).
+     * - Otherwise, scan indicator keys and trigger only when at least one indicator is
+     *   still in legacy top-level shape (primitive/array/null).
+     *
+     * Mixed-shape tolerance:
+     * - Files that are partially migrated are supported; V2-like object-valued indicators
+     *   are ignored while legacy-shaped indicators can still trigger migration.
+     */
+    shouldMigrate(settings: unknown): boolean;
+    /**
+     * Performs non-destructive V1 -> V2 transformation.
+     *
+     * Detailed strategy:
+     * 1) Relocate known V1 keys using `V1_TO_V2_MIGRATION_MAP`.
+     *    - If a source value is already an object and maps to a child path of itself
+     *      (partial V2 shape), merge child properties into target path.
+     * 2) Relocate disable* keys into V2 disable* locations.
+     *    - Consolidated keys (`disableAutoUpdate`, `disableUpdateNag`): normalize to
+     *      boolean with stable-compatible presence semantics (`value === true`).
+     *    - Other disable* keys: migrate only boolean values.
+     * 3) Preserve `mcpServers` top-level placement.
+     * 4) Carry over remaining keys:
+     *    - If a key is parent of migrated nested paths, merge unprocessed object children.
+     *    - If parent value is non-object, preserve that scalar/array/null as-is.
+     *    - Otherwise copy untouched key/value.
+     * 5) Stamp `$version = 2`.
+     *
+     * The method is pure with respect to input mutation.
+     */
+    migrate(settings: unknown, _scope: string): {
+        settings: unknown;
+        warnings: string[];
+    };
+}
+/** Singleton instance of V1→V2 migration */
+export declare const v1ToV2Migration: V1ToV2Migration;