@anh3d0nic/qwen-code-termux-ice 14.0.0 → 16.0.0

package/packages/cli/src/config/migration/index.ts

@@ -1,106 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-// Export types
-export type { SettingsMigration, MigrationResult } from './types.js';
-
-// Export scheduler
-export { MigrationScheduler } from './scheduler.js';
-
-// Export migrations
-export { v1ToV2Migration, V1ToV2Migration } from './versions/v1-to-v2.js';
-export { v2ToV3Migration, V2ToV3Migration } from './versions/v2-to-v3.js';
-
-// Import settings version from single source of truth
-import { SETTINGS_VERSION } from '../settings.js';
-
-// Ordered array of all migrations for use with MigrationScheduler
-// Each migration handles one version transition (N → N+1)
-// Order matters: migrations must be sorted by ascending version
-import { v1ToV2Migration } from './versions/v1-to-v2.js';
-import { v2ToV3Migration } from './versions/v2-to-v3.js';
-import { MigrationScheduler } from './scheduler.js';
-import type { MigrationResult } from './types.js';
-
-/**
- * Ordered array of all settings migrations.
- * Use this with MigrationScheduler to run the full migration chain.
- *
- * @example
- * ```typescript
- * const scheduler = new MigrationScheduler(ALL_MIGRATIONS);
- * const result = scheduler.migrate(settings);
- * ```
- */
-export const ALL_MIGRATIONS = [v1ToV2Migration, v2ToV3Migration] as const;
-
-/**
- * Convenience function that runs all migrations on the given settings.
- * This is the primary entry point for settings migration.
- *
- * @param settings - The settings object to migrate
- * @param scope - The scope of settings being migrated
- * @returns MigrationResult containing the final settings, version, and execution log
- *
- * @example
- * ```typescript
- * const result = runMigrations(settings, 'User');
- * if (result.executedMigrations.length > 0) {
- *   console.log(`Migrated from version ${result.executedMigrations[0].fromVersion} to ${result.finalVersion}`);
- * }
- * ```
- */
-export function runMigrations(
-  settings: unknown,
-  scope: string,
-): MigrationResult {
-  const scheduler = new MigrationScheduler([...ALL_MIGRATIONS], scope);
-  return scheduler.migrate(settings);
-}
-
-/**
- * Checks if the given settings need migration.
- * Returns true only if at least one registered migration would be applied.
- *
- * This function checks:
- * 1. If $version field exists and is a number:
- *    - Returns false if $version >= SETTINGS_VERSION
- *    - Returns true only when $version < SETTINGS_VERSION AND at least one
- *      migration can execute for the current settings shape
- * 2. If $version field is missing or invalid:
- *    - Uses fallback logic by checking individual migrations
- *
- * Note:
- * - Legacy numeric versions that have no executable migrations are handled by
- *   the settings loader via version normalization (bump metadata to current).
- *
- * @param settings - The settings object to check
- * @returns true if migration is needed, false otherwise
- */
-export function needsMigration(settings: unknown): boolean {
-  if (typeof settings !== 'object' || settings === null) {
-    return false;
-  }
-
-  const s = settings as Record<string, unknown>;
-  const version = s['$version'];
-  const hasApplicableMigration = ALL_MIGRATIONS.some((migration) =>
-    migration.shouldMigrate(settings),
-  );
-
-  // If $version is a valid number, use version comparison
-  if (typeof version === 'number') {
-    if (version >= SETTINGS_VERSION) {
-      return false;
-    }
-    // Guardrail: only report migration-needed if at least one migration can execute.
-    return hasApplicableMigration;
-  }
-
-  // If $version exists but is not a number (invalid), or is missing:
-  // Use fallback logic - check if any migration would be applied
-  return hasApplicableMigration;
-}

package/packages/cli/src/config/migration/scheduler.test.ts

@@ -1,164 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import { describe, it, expect, vi } from 'vitest';
-import { MigrationScheduler } from './scheduler.js';
-
-import type { SettingsMigration } from './types.js';
-
-describe('MigrationScheduler', () => {
-  // Mock migration for testing
-  const createMockMigration = (
-    fromVersion: number,
-    toVersion: number,
-    shouldMigrateResult: boolean,
-  ): SettingsMigration => ({
-    fromVersion,
-    toVersion,
-    shouldMigrate: vi.fn().mockReturnValue(shouldMigrateResult),
-    migrate: vi.fn((settings) => ({
-      settings: {
-        ...(settings as Record<string, unknown>),
-        $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: SettingsMigration = {
-      fromVersion: 1,
-      toVersion: 2,
-      shouldMigrate: vi.fn((settings) => {
-        const s = settings as Record<string, unknown>;
-        return s['$version'] !== 2;
-      }),
-      migrate: vi.fn((settings) => ({
-        settings: {
-          ...(settings as Record<string, unknown>),
-          $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: SettingsMigration = {
-      fromVersion: 1,
-      toVersion: 2,
-      shouldMigrate: vi.fn().mockReturnValue(true),
-      migrate: vi.fn(() => ({
-        settings: { $version: 2, transformed: true },
-        warnings: [],
-      })),
-    };
-
-    const migration2: SettingsMigration = {
-      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: SettingsMigration = {
-      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);
-  });
-});

package/packages/cli/src/config/migration/scheduler.ts

@@ -1,115 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import { createDebugLogger } from '@mmmbuto/qwen-code-termux-core';
-import type { SettingsMigration, MigrationResult } from './types.js';
-
-const debugLogger = createDebugLogger('SETTINGS_MIGRATION');
-
-/**
- * Formats a SettingScope enum value to a human-readable string.
- * - Converts to lowercase
- * - Special case: 'SystemDefaults' -> 'system default'
- */
-export function formatScope(scope: string): string {
-  if (scope === 'SystemDefaults') {
-    return 'system default';
-  }
-  return scope.toLowerCase();
-}
-
-/**
- * Chain scheduler for settings migrations.
- *
- * The MigrationScheduler orchestrates multiple migrations in sequence,
- * delegating version detection to each individual migration via `shouldMigrate`.
- * It has no centralized version logic - migrations self-determine applicability.
- *
- * Key characteristics:
- * - Linear chain execution: migrations are applied in registration order
- * - Idempotent: already-migrated versions return false from shouldMigrate
- * - Adjacent versions only: each migration handles N → N+1
- * - Pure functions: migrations don't modify input objects
- */
-export class MigrationScheduler {
-  /**
-   * Creates a new MigrationScheduler with the given migrations.
-   *
-   * @param migrations - Array of migrations in execution order (typically ascending version)
-   * @param scope - The scope of settings being migrated
-   */
-  constructor(
-    private readonly migrations: SettingsMigration[],
-    private readonly scope: string,
-  ) {}
-
-  /**
-   * Executes the migration chain on the given settings.
-   *
-   * Iterates through all registered migrations in order. For each migration:
-   * 1. Calls `shouldMigrate` with the current settings
-   * 2. If true, calls `migrate` to transform the settings
-   * 3. Records the execution
-   *
-   * The scheduler itself has no version awareness - all version detection
-   * is delegated to the individual migrations.
-   *
-   * @param settings - The settings object to migrate
-   * @returns MigrationResult containing the final settings, version, and execution log
-   */
-  migrate(settings: unknown): MigrationResult {
-    debugLogger.debug('MigrationScheduler: Starting migration chain');
-
-    let current = settings;
-    const executed: Array<{ fromVersion: number; toVersion: number }> = [];
-    const allWarnings: string[] = [];
-
-    for (const migration of this.migrations) {
-      try {
-        if (migration.shouldMigrate(current)) {
-          debugLogger.debug(
-            `MigrationScheduler: Executing migration ${migration.fromVersion} → ${migration.toVersion}`,
-          );
-
-          const formattedScope = formatScope(this.scope);
-          const result = migration.migrate(current, formattedScope);
-          current = result.settings;
-          allWarnings.push(...result.warnings);
-
-          executed.push({
-            fromVersion: migration.fromVersion,
-            toVersion: migration.toVersion,
-          });
-
-          debugLogger.debug(
-            `MigrationScheduler: Migration ${migration.fromVersion} → ${migration.toVersion} completed successfully`,
-          );
-        }
-      } catch (error) {
-        debugLogger.error(
-          `MigrationScheduler: Migration ${migration.fromVersion} → ${migration.toVersion} failed:`,
-          error,
-        );
-        throw error;
-      }
-    }
-
-    // Determine final version from the settings object
-    const finalVersion =
-      ((current as Record<string, unknown>)['$version'] as number) ?? 1;
-
-    debugLogger.debug(
-      `MigrationScheduler: Migration chain complete. Final version: ${finalVersion}, Executed: ${executed.length} migrations`,
-    );
-
-    return {
-      settings: current,
-      finalVersion,
-      executedMigrations: executed,
-      warnings: allWarnings,
-    };
-  }
-}

package/packages/cli/src/config/migration/types.ts

@@ -1,58 +0,0 @@
-/**
- * @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/packages/cli/src/config/migration/versions/v1-to-v2-shared.ts

@@ -1,180 +0,0 @@
-/**
- * @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: Record<string, string> = {
-  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',
-  summarizeToolOutput: 'model.summarizeToolOutput',
-  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: Record<string, string> = {
-  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',
-  'summarizeToolOutput',
-  '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',
-];