@tulex-cli/tulex-code 0.1.1

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

@@ -0,0 +1,185 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { deleteNestedPropertySafe, getNestedProperty, setNestedPropertySafe, } from '../../../utils/settingsUtils.js';
+/**
+ * Path mapping for boolean polarity migration (V2 disable* -> V3 enable*).
+ *
+ * Strategy:
+ * - For each mapped path, values are normalized before migration:
+ *   - boolean values are accepted directly
+ *   - string values "true"/"false" (case-insensitive, trim-aware) are coerced
+ *   - all other present values are treated as invalid
+ * - Transformation is inversion-based: disable=true -> enable=false, disable=false -> enable=true.
+ * - Deprecated disable* keys are removed whenever present (valid or invalid).
+ * - Invalid values do not create enable* keys and produce warnings.
+ */
+const V2_TO_V3_BOOLEAN_MAP = {
+    'general.disableAutoUpdate': 'general.enableAutoUpdate',
+    'general.disableUpdateNag': 'general.enableAutoUpdate',
+    'ui.accessibility.disableLoadingPhrases': 'ui.accessibility.enableLoadingPhrases',
+    'context.fileFiltering.disableFuzzySearch': 'context.fileFiltering.enableFuzzySearch',
+    'model.generationConfig.disableCacheControl': 'model.generationConfig.enableCacheControl',
+};
+/**
+ * Consolidated old paths that collapse into one V3 field.
+ *
+ * Current policy:
+ * - `general.disableAutoUpdate` and `general.disableUpdateNag` both drive
+ *   `general.enableAutoUpdate`.
+ * - If any valid normalized source is true, target becomes false.
+ * - If at least one valid normalized source exists, consolidated target is emitted.
+ * - Invalid present values are removed and warned, and do not contribute to target calculation.
+ */
+const CONSOLIDATED_V2_PATHS = {
+    'general.enableAutoUpdate': [
+        'general.disableAutoUpdate',
+        'general.disableUpdateNag',
+    ],
+};
+/**
+ * Normalizes deprecated disable* values for migration.
+ *
+ * Returns:
+ * - `isPresent=false` when the path does not exist
+ * - `isPresent=true, isValid=true` when value is boolean or coercible string
+ * - `isPresent=true, isValid=false` for invalid values (number/object/array/null/other strings)
+ */
+function normalizeDisableValue(value) {
+    if (value === undefined) {
+        return { isPresent: false, isValid: false };
+    }
+    if (typeof value === 'boolean') {
+        return { isPresent: true, isValid: true, booleanValue: value };
+    }
+    if (typeof value === 'string') {
+        const normalized = value.trim().toLowerCase();
+        if (normalized === 'true') {
+            return { isPresent: true, isValid: true, booleanValue: true };
+        }
+        if (normalized === 'false') {
+            return { isPresent: true, isValid: true, booleanValue: false };
+        }
+    }
+    return { isPresent: true, isValid: false };
+}
+/**
+ * V2 -> V3 migration (boolean polarity normalization stage).
+ *
+ * Migration contract:
+ * - Input: V2 settings object (`$version: 2`).
+ * - Output: `$version: 3` with deprecated disable* fields removed and
+ *   valid values migrated to enable* equivalents.
+ *
+ * Compatibility strategy:
+ * - Accept boolean values and coercible strings "true"/"false".
+ * - Remove invalid deprecated values (rather than preserving them).
+ * - Emit warnings for each removed invalid deprecated key.
+ * - Always bump version to 3 so future loads are idempotent and skip repeated checks.
+ */
+export class V2ToV3Migration {
+    fromVersion = 2;
+    toVersion = 3;
+    /**
+     * Migration trigger rule.
+     *
+     * Execute only when `$version === 2`.
+     * This includes V2 files with no migratable disable* booleans so that version
+     * metadata still advances to 3.
+     */
+    shouldMigrate(settings) {
+        if (typeof settings !== 'object' || settings === null) {
+            return false;
+        }
+        const s = settings;
+        // Migrate if $version is 2
+        return s['$version'] === 2;
+    }
+    /**
+     * Applies V2 -> V3 transformation with deterministic deprecated-key cleanup.
+     *
+     * Detailed strategy:
+     * 1) Clone input.
+     * 2) Process consolidated paths first:
+     *    - Inspect each source path.
+     *    - Normalize each present value (boolean / coercible string / invalid).
+     *    - Always delete present deprecated source key.
+     *    - Valid normalized values contribute to aggregate.
+     *    - Invalid values emit warnings.
+     *    - Emit consolidated target when at least one valid source was consumed.
+     * 3) Process remaining one-to-one mappings:
+     *    - For each unmapped source, normalize value.
+     *    - If valid -> delete old key and write inverted target.
+     *    - If invalid -> delete old key and emit warning.
+     * 4) Set `$version = 3`.
+     *
+     * Guarantees:
+     * - Input object is not mutated.
+     * - Valid migration and invalid cleanup are deterministic.
+     * - Deprecated disable* keys are not retained after migration.
+     */
+    migrate(settings, scope) {
+        if (typeof settings !== 'object' || settings === null) {
+            throw new Error('Settings must be an object');
+        }
+        // Deep clone to avoid mutating input
+        const result = structuredClone(settings);
+        const processedPaths = new Set();
+        const warnings = [];
+        // Step 1: Handle consolidated paths (multiple old paths → single new path)
+        // Policy: if ANY of the old disable* settings is true, the new enable* should be false
+        for (const [newPath, oldPaths] of Object.entries(CONSOLIDATED_V2_PATHS)) {
+            let hasAnyDisable = false;
+            let hasAnyBooleanValue = false;
+            for (const oldPath of oldPaths) {
+                const oldValue = getNestedProperty(result, oldPath);
+                const normalized = normalizeDisableValue(oldValue);
+                if (!normalized.isPresent) {
+                    continue;
+                }
+                deleteNestedPropertySafe(result, oldPath);
+                processedPaths.add(oldPath);
+                if (normalized.isValid) {
+                    hasAnyBooleanValue = true;
+                    if (normalized.booleanValue === true) {
+                        hasAnyDisable = true;
+                    }
+                }
+                else {
+                    warnings.push(`Removed deprecated setting '${oldPath}' from ${scope} settings because the value is invalid. Expected boolean.`);
+                }
+            }
+            if (hasAnyBooleanValue) {
+                // enableAutoUpdate = !hasAnyDisable (if any disable* was true, enable should be false)
+                setNestedPropertySafe(result, newPath, !hasAnyDisable);
+            }
+        }
+        // Step 2: Handle remaining individual disable* → enable* mappings
+        for (const [oldPath, newPath] of Object.entries(V2_TO_V3_BOOLEAN_MAP)) {
+            if (processedPaths.has(oldPath)) {
+                continue;
+            }
+            const oldValue = getNestedProperty(result, oldPath);
+            const normalized = normalizeDisableValue(oldValue);
+            if (!normalized.isPresent) {
+                continue;
+            }
+            deleteNestedPropertySafe(result, oldPath);
+            if (normalized.isValid) {
+                // Set new property with inverted value
+                setNestedPropertySafe(result, newPath, !normalized.booleanValue);
+            }
+            else {
+                warnings.push(`Removed deprecated setting '${oldPath}' from ${scope} settings because the value is invalid. Expected boolean or string "true"/"false".`);
+            }
+        }
+        // Step 3: Always update version to 3
+        result['$version'] = 3;
+        return { settings: result, warnings };
+    }
+}
+/** Singleton instance of V2→V3 migration */
+export const v2ToV3Migration = new V2ToV3Migration();
+//# sourceMappingURL=v2-to-v3.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/config/migration/versions/v2-to-v3.test.js

@@ -0,0 +1,337 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { V2ToV3Migration } from './v2-to-v3.js';
+describe('V2ToV3Migration', () => {
+    const migration = new V2ToV3Migration();
+    describe('shouldMigrate', () => {
+        it('should return true for V2 settings with deprecated disable* keys', () => {
+            const v2Settings = {
+                $version: 2,
+                general: { disableAutoUpdate: true },
+            };
+            expect(migration.shouldMigrate(v2Settings)).toBe(true);
+        });
+        it('should return true for V2 settings with ui.accessibility.disableLoadingPhrases', () => {
+            const v2Settings = {
+                $version: 2,
+                ui: { accessibility: { disableLoadingPhrases: false } },
+            };
+            expect(migration.shouldMigrate(v2Settings)).toBe(true);
+        });
+        it('should return false for V3 settings', () => {
+            const v3Settings = {
+                $version: 3,
+                general: { enableAutoUpdate: true },
+            };
+            expect(migration.shouldMigrate(v3Settings)).toBe(false);
+        });
+        it('should return false for V1 settings without version', () => {
+            const v1Settings = {
+                theme: 'dark',
+                disableAutoUpdate: true,
+            };
+            expect(migration.shouldMigrate(v1Settings)).toBe(false);
+        });
+        it('should return true for V2 settings without deprecated keys', () => {
+            const cleanV2Settings = {
+                $version: 2,
+                ui: { theme: 'dark' },
+                general: { enableAutoUpdate: true },
+            };
+            // V2 settings should always be migrated to V3 to update the version number
+            expect(migration.shouldMigrate(cleanV2Settings)).toBe(true);
+        });
+        it('should return false for null input', () => {
+            expect(migration.shouldMigrate(null)).toBe(false);
+        });
+        it('should return false for non-object input', () => {
+            expect(migration.shouldMigrate('string')).toBe(false);
+            expect(migration.shouldMigrate(123)).toBe(false);
+        });
+    });
+    describe('migrate', () => {
+        it('should migrate disableAutoUpdate to enableAutoUpdate with inverted value', () => {
+            const v2Settings = {
+                $version: 2,
+                general: { disableAutoUpdate: true },
+            };
+            const { settings: result } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            expect(result['general']['enableAutoUpdate']).toBe(false);
+            expect(result['general']['disableAutoUpdate']).toBeUndefined();
+        });
+        it('should migrate disableLoadingPhrases to enableLoadingPhrases', () => {
+            const v2Settings = {
+                $version: 2,
+                ui: { accessibility: { disableLoadingPhrases: true } },
+            };
+            const { settings: result } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            expect(result['ui']['accessibility']).toEqual({
+                enableLoadingPhrases: false,
+            });
+        });
+        it('should migrate disableFuzzySearch to enableFuzzySearch', () => {
+            const v2Settings = {
+                $version: 2,
+                context: { fileFiltering: { disableFuzzySearch: false } },
+            };
+            const { settings: result } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            expect(result['context']['fileFiltering']).toEqual({
+                enableFuzzySearch: true,
+            });
+        });
+        it('should migrate disableCacheControl to enableCacheControl', () => {
+            const v2Settings = {
+                $version: 2,
+                model: { generationConfig: { disableCacheControl: true } },
+            };
+            const { settings: result } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            expect(result['model']['generationConfig']).toEqual({
+                enableCacheControl: false,
+            });
+        });
+        it('should handle consolidated disableAutoUpdate and disableUpdateNag', () => {
+            const v2Settings = {
+                $version: 2,
+                general: {
+                    disableAutoUpdate: true,
+                    disableUpdateNag: false,
+                },
+            };
+            const { settings: result } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            // If ANY disable* is true, enable should be false
+            expect(result['general']['enableAutoUpdate']).toBe(false);
+            expect(result['general']['disableAutoUpdate']).toBeUndefined();
+            expect(result['general']['disableUpdateNag']).toBeUndefined();
+        });
+        it('should set enableAutoUpdate to true when both disable* are false', () => {
+            const v2Settings = {
+                $version: 2,
+                general: {
+                    disableAutoUpdate: false,
+                    disableUpdateNag: false,
+                },
+            };
+            const { settings: result } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            expect(result['general']['enableAutoUpdate']).toBe(true);
+        });
+        it('should preserve other settings during migration', () => {
+            const v2Settings = {
+                $version: 2,
+                ui: {
+                    theme: 'dark',
+                    accessibility: { disableLoadingPhrases: true },
+                },
+                model: {
+                    name: 'gemini',
+                },
+            };
+            const { settings: result } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            expect(result['ui']['theme']).toBe('dark');
+            expect(result['model']['name']).toBe('gemini');
+            expect(result['ui']['accessibility']).toEqual({
+                enableLoadingPhrases: false,
+            });
+        });
+        it('should not modify the input object', () => {
+            const v2Settings = {
+                $version: 2,
+                general: { disableAutoUpdate: true },
+            };
+            const result = migration.migrate(v2Settings, 'user');
+            expect(v2Settings.general).toEqual({ disableAutoUpdate: true });
+            expect(result).not.toBe(v2Settings);
+        });
+        it('should throw error for non-object input', () => {
+            expect(() => migration.migrate(null, 'user')).toThrow('Settings must be an object');
+            expect(() => migration.migrate('string', 'user')).toThrow('Settings must be an object');
+        });
+        it('should handle multiple deprecated keys in one migration', () => {
+            const v2Settings = {
+                $version: 2,
+                general: { disableAutoUpdate: false },
+                ui: { accessibility: { disableLoadingPhrases: false } },
+                context: { fileFiltering: { disableFuzzySearch: false } },
+            };
+            const { settings: result } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            expect(result['general']['enableAutoUpdate']).toBe(true);
+            expect(result['ui']['accessibility']).toEqual({
+                enableLoadingPhrases: true,
+            });
+            expect(result['context']['fileFiltering']).toEqual({
+                enableFuzzySearch: true,
+            });
+        });
+        it('should coerce string "true" and remove deprecated key', () => {
+            const v2Settings = {
+                $version: 2,
+                general: { disableAutoUpdate: 'true' },
+            };
+            const { settings: result, warnings } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            expect(result['general']['disableAutoUpdate']).toBeUndefined();
+            expect(result['general']['enableAutoUpdate']).toBe(false);
+            expect(warnings).toHaveLength(0);
+        });
+        it('should coerce string "false" and remove deprecated key', () => {
+            const v2Settings = {
+                $version: 2,
+                general: { disableAutoUpdate: 'false' },
+            };
+            const { settings: result, warnings } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            expect(result['general']['disableAutoUpdate']).toBeUndefined();
+            expect(result['general']['enableAutoUpdate']).toBe(true);
+            expect(warnings).toHaveLength(0);
+        });
+        it('should coerce case-insensitive strings for consolidated keys', () => {
+            const v2Settings = {
+                $version: 2,
+                general: {
+                    disableAutoUpdate: 'TRUE',
+                    disableUpdateNag: 'FALSE',
+                },
+            };
+            const { settings: result, warnings } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            expect(result['general']['disableAutoUpdate']).toBeUndefined();
+            expect(result['general']['disableUpdateNag']).toBeUndefined();
+            expect(result['general']['enableAutoUpdate']).toBe(false);
+            expect(warnings).toHaveLength(0);
+        });
+        it('should remove number value and emit warning', () => {
+            const v2Settings = {
+                $version: 2,
+                general: { disableAutoUpdate: 123 },
+            };
+            const { settings: result, warnings } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            expect(result['general']['disableAutoUpdate']).toBeUndefined();
+            expect(result['general']['enableAutoUpdate']).toBeUndefined();
+            expect(warnings).toHaveLength(1);
+            expect(warnings[0]).toContain('general.disableAutoUpdate');
+        });
+        it('should remove invalid string value and emit warning', () => {
+            const v2Settings = {
+                $version: 2,
+                general: { disableAutoUpdate: 'invalid-string' },
+            };
+            const { settings: result, warnings } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            expect(result['general']['disableAutoUpdate']).toBeUndefined();
+            expect(result['general']['enableAutoUpdate']).toBeUndefined();
+            expect(warnings).toHaveLength(1);
+            expect(warnings[0]).toContain('general.disableAutoUpdate');
+        });
+        it('should coerce disableCacheControl string "true"', () => {
+            const v2Settings = {
+                $version: 2,
+                model: { generationConfig: { disableCacheControl: 'true' } },
+            };
+            const { settings: result, warnings } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            expect(result['model']['generationConfig']).toEqual({
+                enableCacheControl: false,
+            });
+            expect(warnings).toHaveLength(0);
+        });
+        it('should coerce disableCacheControl string "false"', () => {
+            const v2Settings = {
+                $version: 2,
+                model: { generationConfig: { disableCacheControl: 'false' } },
+            };
+            const { settings: result, warnings } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            expect(result['model']['generationConfig']).toEqual({
+                enableCacheControl: true,
+            });
+            expect(warnings).toHaveLength(0);
+        });
+        it('should remove disableCacheControl number value and emit warning', () => {
+            const v2Settings = {
+                $version: 2,
+                model: { generationConfig: { disableCacheControl: 456 } },
+            };
+            const { settings: result, warnings } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            expect(result['model']['generationConfig']).toEqual({});
+            expect(result['model']['generationConfig']['enableCacheControl']).toBeUndefined();
+            expect(warnings).toHaveLength(1);
+            expect(warnings[0]).toContain('model.generationConfig.disableCacheControl');
+        });
+        it('should handle mixed valid and invalid disableAutoUpdate and disableUpdateNag', () => {
+            const v2Settings = {
+                $version: 2,
+                general: {
+                    disableAutoUpdate: true,
+                    disableUpdateNag: 'invalid',
+                },
+            };
+            const { settings: result, warnings } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            // Only valid values should contribute to the consolidated result
+            // Since disableAutoUpdate is true, enableAutoUpdate should be false
+            expect(result['general']['enableAutoUpdate']).toBe(false);
+            expect(result['general']['disableAutoUpdate']).toBeUndefined();
+            expect(result['general']['disableUpdateNag']).toBeUndefined();
+            expect(warnings).toHaveLength(1);
+            expect(warnings[0]).toContain('general.disableUpdateNag');
+        });
+        it('should remove object value for disable key and emit warning', () => {
+            const v2Settings = {
+                $version: 2,
+                general: { disableAutoUpdate: { nested: 'value' } },
+            };
+            const { settings: result, warnings } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            expect(result['general']['disableAutoUpdate']).toBeUndefined();
+            expect(result['general']['enableAutoUpdate']).toBeUndefined();
+            expect(warnings).toHaveLength(1);
+            expect(warnings[0]).toContain('general.disableAutoUpdate');
+        });
+        it('should remove array value for disable key and emit warning', () => {
+            const v2Settings = {
+                $version: 2,
+                general: { disableAutoUpdate: [1, 2, 3] },
+            };
+            const { settings: result, warnings } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            expect(result['general']['disableAutoUpdate']).toBeUndefined();
+            expect(result['general']['enableAutoUpdate']).toBeUndefined();
+            expect(warnings).toHaveLength(1);
+            expect(warnings[0]).toContain('general.disableAutoUpdate');
+        });
+        it('should remove null value for disable key and emit warning', () => {
+            const v2Settings = {
+                $version: 2,
+                general: { disableAutoUpdate: null },
+            };
+            const { settings: result, warnings } = migration.migrate(v2Settings, 'user');
+            expect(result['$version']).toBe(3);
+            expect(result['general']['disableAutoUpdate']).toBeUndefined();
+            expect(result['general']['enableAutoUpdate']).toBeUndefined();
+            expect(warnings).toHaveLength(1);
+            expect(warnings[0]).toContain('general.disableAutoUpdate');
+        });
+    });
+    describe('version properties', () => {
+        it('should have correct fromVersion', () => {
+            expect(migration.fromVersion).toBe(2);
+        });
+        it('should have correct toVersion', () => {
+            expect(migration.toVersion).toBe(3);
+        });
+    });
+});
+//# sourceMappingURL=v2-to-v3.test.js.map

package/dist/src/config/migration/versions/v2-to-v3.test.js.map

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

package/dist/src/config/migration/versions/v3-to-v4.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { SettingsMigration } from '../types.js';
+/**
+ * V3 -> V4 migration (gitCoAuthor boolean → object expansion).
+ *
+ * Before V4, `general.gitCoAuthor` was a single boolean that governed both
+ * commit message attribution and PR body attribution. V4 splits those into
+ * two independent sub-toggles so users can disable one without losing the
+ * other. This migration rewrites any stored boolean into `{ commit: v,
+ * pr: v }` so the user's prior choice carries over to both new toggles and
+ * the settings dialog reads the expected object shape.
+ *
+ * Compatibility strategy:
+ * - Boolean values are expanded in place.
+ * - Object values with `commit`/`pr` keys are left untouched (forward-
+ *   compatible — a user who edited their settings.json by hand to the new
+ *   shape is already on V4-equivalent data).
+ * - Any other present value (string, number, array, null) is dropped with
+ *   a warning so the caller sees an actionable message.
+ */
+export declare class V3ToV4Migration implements SettingsMigration {
+    readonly fromVersion = 3;
+    readonly toVersion = 4;
+    shouldMigrate(settings: unknown): boolean;
+    migrate(settings: unknown, scope: string): {
+        settings: unknown;
+        warnings: string[];
+    };
+}
+export declare const v3ToV4Migration: V3ToV4Migration;