@pie-element/cli 0.1.1 → 0.1.2-next.1

package/src/commands/mathquill/migrate.ts

@@ -1,269 +0,0 @@
-import { Command, Flags } from '@oclif/core';
-import { Logger } from '../../utils/logger.js';
-import { MigrationOrchestrator } from '../../lib/mathquill/migration-orchestrator.js';
-import { existsSync } from 'node:fs';
-import { join } from 'node:path';
-
-export default class MathQuillMigrate extends Command {
-  static override description = `Migrate MathQuill from PIE fork to Desmos fork with patches
-
-Automates the migration from PIE's 2015 MathQuill fork to the modern Desmos fork
-with Khan Academy patches, Learnosity features, and PIE extensions.
-
-This command:
-1. Clones Desmos, Khan, and Learnosity forks to temp directory
-2. Extracts features from each fork:
-   - Khan: Mobile keyboard fixes, i18n ARIA strings
-   - Learnosity: Recurring decimals, nless/ngtr symbols, empty() method
-   - PIE: Matrices (pmatrix, bmatrix, vmatrix), lrnexponent
-3. Generates TypeScript extension modules with source attribution
-4. Creates unified extension loader
-5. Updates package.json to use Desmos fork
-6. Runs automated tests
-
-The migration is repeatable - you can re-run it when forks update.
-
-After migration, review changes and test thoroughly before committing.
-`;
-
-  static override examples = [
-    {
-      description: 'Show what would be migrated (dry run)',
-      command: '<%= config.bin %> <%= command.id %> --dry-run',
-    },
-    {
-      description: 'Run full migration',
-      command: '<%= config.bin %> <%= command.id %>',
-    },
-    {
-      description: 'Verbose output with detailed progress',
-      command: '<%= config.bin %> <%= command.id %> --verbose',
-    },
-    {
-      description: 'Force migration (skip confirmations)',
-      command: '<%= config.bin %> <%= command.id %> --force',
-    },
-    {
-      description: 'Skip tests',
-      command: '<%= config.bin %> <%= command.id %> --skip-tests',
-    },
-  ];
-
-  static override flags = {
-    'dry-run': Flags.boolean({
-      description: 'Show what would be done without making changes',
-      default: false,
-    }),
-    force: Flags.boolean({
-      description: 'Skip confirmation prompts and continue on non-fatal errors',
-      default: false,
-    }),
-    verbose: Flags.boolean({
-      char: 'v',
-      description: 'Show detailed progress output',
-      default: false,
-    }),
-    'skip-tests': Flags.boolean({
-      description: 'Skip running tests after migration',
-      default: false,
-    }),
-    'temp-dir': Flags.string({
-      description: 'Temporary directory for cloning forks',
-      default: '/tmp/mathquill-migration',
-    }),
-    clean: Flags.boolean({
-      description: 'Clean temporary directory before starting',
-      default: false,
-    }),
-  };
-
-  async run(): Promise<void> {
-    const { flags } = await this.parse(MathQuillMigrate);
-    const logger = new Logger(flags.verbose);
-
-    // Validate workspace
-    const workspaceRoot = process.cwd();
-    const mathquillPath = join(workspaceRoot, 'packages/shared/mathquill');
-
-    if (!existsSync(mathquillPath)) {
-      logger.error('MathQuill package not found at: packages/shared/mathquill');
-      logger.info('This command must be run from the workspace root');
-      this.exit(1);
-    }
-
-    // Show banner
-    logger.section('🚀 MathQuill Migration');
-    logger.info('   Migrating from PIE fork to Desmos fork + patches\n');
-
-    if (flags['dry-run']) {
-      logger.warn('🏃 DRY RUN MODE - No changes will be made\n');
-    }
-
-    // Create orchestrator
-    const orchestrator = new MigrationOrchestrator({
-      workspaceRoot,
-      mathquillPath,
-      tempDir: flags['temp-dir'],
-      dryRun: flags['dry-run'],
-      force: flags.force,
-      skipTests: flags['skip-tests'],
-      clean: flags.clean,
-      logger,
-    });
-
-    // Show configuration
-    if (flags.verbose) {
-      logger.section('Configuration');
-      logger.info(`   Workspace:   ${workspaceRoot}`);
-      logger.info(`   MathQuill:   ${mathquillPath}`);
-      logger.info(`   Temp Dir:    ${flags['temp-dir']}`);
-      logger.info(`   Dry Run:     ${flags['dry-run']}`);
-      logger.info(`   Force:       ${flags.force}`);
-      logger.info(`   Skip Tests:  ${flags['skip-tests']}\n`);
-    }
-
-    // Confirm if not in dry-run or force mode
-    if (!flags['dry-run'] && !flags.force) {
-      logger.warn('⚠️  This will modify packages/shared/mathquill');
-      logger.info('   A git commit is recommended before proceeding.\n');
-
-      // In a real implementation, you'd use inquirer or similar
-      // For now, we'll just proceed
-      logger.info('   Proceeding with migration...\n');
-    }
-
-    try {
-      // Run migration
-      const result = await orchestrator.migrate();
-
-      if (flags['dry-run']) {
-        this.showDryRunSummary(result, logger);
-      } else {
-        this.showSuccessSummary(result, logger);
-      }
-
-      if (!result.success) {
-        this.exit(1);
-      }
-    } catch (error) {
-      logger.error('\n❌ Migration failed');
-
-      if (error instanceof Error) {
-        logger.error(`   ${error.message}`);
-        if (flags.verbose && error.stack) {
-          logger.debug(`\n${error.stack}`);
-        }
-      }
-
-      logger.info('\n💡 Troubleshooting:');
-      logger.info('   1. Check internet connectivity for git clones');
-      logger.info('   2. Ensure temp directory is writable');
-      logger.info('   3. Run with --verbose for detailed output');
-      logger.info('   4. Try --clean to remove cached forks');
-      logger.info('   5. Check docs/MATHQUILL_MIGRATION_CLI_PLAN.md');
-
-      this.exit(1);
-    }
-  }
-
-  private showDryRunSummary(result: any, logger: Logger): void {
-    logger.section('📋 Dry Run Summary');
-    logger.info('Would perform the following actions:\n');
-
-    logger.info('📂 Prepare environment:');
-    logger.info(`   • Create temp directory: ${result.tempDir}`);
-    logger.info('   • Create extension directories\n');
-
-    logger.info('🔄 Clone forks:');
-    logger.info('   • Desmos fork (desmosinc/mathquill)');
-    logger.info('   • Khan fork (Khan/mathquill v1.0.3)');
-    logger.info('   • Learnosity fork (Learnosity/mathquill)\n');
-
-    logger.info('📦 Extract features:');
-    logger.info('   Khan Academy:');
-    logger.info('     • mobile-keyboard.ts (Android keyboard fixes)');
-    logger.info('     • i18n-aria.ts (Internationalized ARIA strings)');
-    logger.info('   Learnosity:');
-    logger.info('     • recurring-decimal.ts (Recurring decimal dot)');
-    logger.info('     • not-symbols.ts (nless, ngtr symbols)');
-    logger.info('     • empty-method.ts (Check if field is empty)');
-    logger.info('   PIE:');
-    logger.info('     • matrices.ts (pmatrix, bmatrix, vmatrix)');
-    logger.info('     • lrn-exponent.ts (LRN exponent notation)\n');
-
-    logger.info('🔨 Generate:');
-    logger.info('   • Extension loader (src/extensions/index.ts)\n');
-
-    logger.info('📝 Update:');
-    logger.info('   • Install: mathquill@github:desmosinc/mathquill');
-    logger.info('   • Update: package.json with migration metadata\n');
-
-    logger.info('🧪 Test:');
-    logger.info('   • Run unit tests');
-    logger.info('   • Run integration tests\n');
-
-    logger.success('Dry run complete!');
-    logger.info('\nRun without --dry-run to execute migration.');
-  }
-
-  private showSuccessSummary(result: any, logger: Logger): void {
-    logger.section('✅ Migration Complete!');
-
-    logger.info('\n📊 Summary:');
-    logger.info(`   Base:         Desmos fork (${result.desmos?.commit || 'latest'})`);
-    logger.info(`   + Khan:       ${result.khan?.featuresCount || 0} patches applied`);
-    logger.info(`   + Learnosity: ${result.learnosity?.featuresCount || 0} features added`);
-    logger.info(`   + PIE:        ${result.pie?.featuresCount || 0} extensions ported`);
-
-    if (result.files && result.files.length > 0) {
-      logger.info('\n📂 Generated Files:');
-      logger.info('   packages/shared/mathquill/src/extensions/');
-      logger.info('   ├── khan/');
-      logger.info('   │   ├── mobile-keyboard.ts');
-      logger.info('   │   └── i18n-aria.ts');
-      logger.info('   ├── learnosity/');
-      logger.info('   │   ├── recurring-decimal.ts');
-      logger.info('   │   ├── not-symbols.ts');
-      logger.info('   │   └── empty-method.ts');
-      logger.info('   ├── pie/');
-      logger.info('   │   ├── matrices.ts');
-      logger.info('   │   └── lrn-exponent.ts');
-      logger.info('   └── index.ts (loader)');
-    }
-
-    if (result.tests) {
-      logger.info('\n🧪 Tests:');
-      if (result.tests.unit?.passed) {
-        logger.success(`   Unit tests: ${result.tests.unit.passed} passed`);
-      }
-      if (result.tests.integration?.passed) {
-        logger.success(`   Integration tests: ${result.tests.integration.passed} passed`);
-      }
-      if (result.tests.warnings && result.tests.warnings.length > 0) {
-        logger.warn(`   Warnings: ${result.tests.warnings.length}`);
-      }
-    }
-
-    logger.info('\n📝 Next Steps:');
-    logger.info('   1. Review changes:');
-    logger.info('      git diff packages/shared/mathquill');
-    logger.info('   2. Build package:');
-    logger.info('      cd packages/shared/mathquill && bun run build');
-    logger.info('   3. Test in demo:');
-    logger.info('      bun run dev:demo');
-    logger.info('   4. Verify migration:');
-    logger.info('      pie mathquill:status');
-    logger.info('   5. Run full test suite:');
-    logger.info('      bun test packages/lib-react/math-input');
-    logger.info('      bun test packages/elements-react/math-inline');
-    logger.info('   6. Commit changes:');
-    logger.info('      git add packages/shared/mathquill');
-    logger.info('      git commit -m "Migrate MathQuill to Desmos fork + patches"');
-
-    logger.info('\n💡 Tips:');
-    logger.info('   • Review docs/MATHQUILL_MIGRATION_PLAN.md for details');
-    logger.info('   • Check docs/MATHQUILL_FORK_ANALYSIS.md for fork comparison');
-    logger.info('   • Run "pie mathquill:status" to verify migration state');
-    logger.info('   • Keep /tmp/mathquill-migration for re-running migration\n');
-  }
-}

package/src/commands/mathquill/status.ts

@@ -1,267 +0,0 @@
-import { Command, Flags } from '@oclif/core';
-import { Logger } from '../../utils/logger.js';
-import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-
-export default class MathQuillStatus extends Command {
-  static override description = `Show MathQuill migration status
-
-Displays the current state of the MathQuill migration:
-- Current version and source
-- Migration state (pending, in-progress, complete)
-- Installed fork versions (Desmos, Khan patches, Learnosity features)
-- Extracted features and extensions
-- Test results
-- Next steps
-
-Use this to verify migration success or check what needs to be done.
-`;
-
-  static override examples = [
-    {
-      description: 'Show migration status',
-      command: '<%= config.bin %> <%= command.id %>',
-    },
-    {
-      description: 'Verbose output with file details',
-      command: '<%= config.bin %> <%= command.id %> --verbose',
-    },
-  ];
-
-  static override flags = {
-    verbose: Flags.boolean({
-      char: 'v',
-      description: 'Show detailed information',
-      default: false,
-    }),
-  };
-
-  async run(): Promise<void> {
-    const { flags } = await this.parse(MathQuillStatus);
-    const logger = new Logger(flags.verbose);
-
-    const workspaceRoot = process.cwd();
-    const mathquillPath = join(workspaceRoot, 'packages/shared/mathquill');
-
-    if (!existsSync(mathquillPath)) {
-      logger.error('MathQuill package not found at: packages/shared/mathquill');
-      this.exit(1);
-    }
-
-    logger.section('📊 MathQuill Status');
-
-    // Read package.json
-    const pkgPath = join(mathquillPath, 'package.json');
-    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
-
-    // Determine migration state
-    const isLegacy = existsSync(join(mathquillPath, 'src/legacy/mathquill-bundle.js'));
-    const hasExtensions = existsSync(join(mathquillPath, 'src/extensions'));
-    const hasLoader = existsSync(join(mathquillPath, 'src/extensions/index.ts'));
-    const migrationConfig = this.loadMigrationConfig(mathquillPath);
-
-    // Current state
-    this.log('\n📦 Current Configuration:');
-    this.log(`   Package: ${pkg.name}@${pkg.version}`);
-    this.log(`   Source:  ${this.detectSource(pkg, isLegacy, hasExtensions)}`);
-
-    if (pkg.dependencies?.mathquill) {
-      const dep = pkg.dependencies.mathquill;
-      if (dep.includes('desmosinc')) {
-        this.log(`   Fork:    Desmos (${dep})`);
-      } else if (dep.includes('Khan')) {
-        this.log(`   Fork:    Khan Academy (${dep})`);
-      } else if (dep.includes('Learnosity')) {
-        this.log(`   Fork:    Learnosity (${dep})`);
-      } else {
-        this.log(`   Fork:    ${dep}`);
-      }
-    }
-
-    // Migration state
-    this.log('\n🔄 Migration State:');
-    const migrationState = this.determineMigrationState(
-      isLegacy,
-      hasExtensions,
-      hasLoader,
-      migrationConfig
-    );
-    this.log(`   Status:  ${migrationState.status} ${migrationState.icon}`);
-    if (migrationState.detail) {
-      this.log(`   Detail:  ${migrationState.detail}`);
-    }
-
-    // Extension state
-    if (hasExtensions) {
-      this.log('\n🔧 Extensions:');
-      this.showExtensionStatus(mathquillPath, flags.verbose, logger);
-    }
-
-    // Migration metadata
-    if (migrationConfig) {
-      this.log('\n📋 Migration Metadata:');
-      this.showMigrationMetadata(migrationConfig);
-    }
-
-    // Next steps
-    this.log('\n📝 Next Steps:');
-    this.showNextSteps(migrationState.status, isLegacy, hasExtensions);
-
-    this.log('');
-  }
-
-  private detectSource(_pkg: any, isLegacy: boolean, hasExtensions: boolean): string {
-    if (hasExtensions && !isLegacy) {
-      return 'Desmos fork + patches (migrated)';
-    }
-    if (isLegacy) {
-      return 'PIE fork (legacy - needs migration)';
-    }
-    return 'Unknown';
-  }
-
-  private determineMigrationState(
-    isLegacy: boolean,
-    hasExtensions: boolean,
-    hasLoader: boolean,
-    _config: any
-  ): { status: string; icon: string; detail?: string } {
-    if (!isLegacy && hasExtensions && hasLoader) {
-      return {
-        status: 'Complete',
-        icon: '✅',
-        detail: 'Migration successful',
-      };
-    }
-
-    if (hasExtensions && !hasLoader) {
-      return {
-        status: 'In Progress',
-        icon: '⚠️',
-        detail: 'Extensions exist but loader missing',
-      };
-    }
-
-    if (isLegacy && !hasExtensions) {
-      return {
-        status: 'Pending',
-        icon: '📋',
-        detail: 'Legacy fork still in use',
-      };
-    }
-
-    if (isLegacy && hasExtensions) {
-      return {
-        status: 'Transitioning',
-        icon: '🔄',
-        detail: 'Both legacy and new extensions present',
-      };
-    }
-
-    return {
-      status: 'Unknown',
-      icon: '❓',
-      detail: 'Unexpected state',
-    };
-  }
-
-  private showExtensionStatus(mathquillPath: string, verbose: boolean, _logger: Logger): void {
-    const extensionDirs = [
-      { name: 'Khan', path: 'src/extensions/khan' },
-      { name: 'Learnosity', path: 'src/extensions/learnosity' },
-      { name: 'PIE', path: 'src/extensions/pie' },
-    ];
-
-    for (const ext of extensionDirs) {
-      const fullPath = join(mathquillPath, ext.path);
-      if (existsSync(fullPath)) {
-        const files = this.countTypeScriptFiles(fullPath);
-        this.log(`   ${ext.name}: ${files} file(s) ✓`);
-
-        if (verbose) {
-          const indexExists = existsSync(join(fullPath, 'index.ts'));
-          this.log(`     • index.ts: ${indexExists ? '✓' : '✗'}`);
-        }
-      } else {
-        this.log(`   ${ext.name}: Not found ✗`);
-      }
-    }
-
-    const loaderPath = join(mathquillPath, 'src/extensions/index.ts');
-    if (existsSync(loaderPath)) {
-      this.log(`   Loader:  ✓`);
-    } else {
-      this.log(`   Loader:  ✗ (Missing extension loader)`);
-    }
-  }
-
-  private countTypeScriptFiles(dir: string): number {
-    if (!existsSync(dir)) return 0;
-
-    try {
-      const { readdirSync } = require('node:fs');
-      const files = readdirSync(dir);
-      return files.filter((f: string) => f.endsWith('.ts') || f.endsWith('.tsx')).length;
-    } catch {
-      return 0;
-    }
-  }
-
-  private loadMigrationConfig(mathquillPath: string): any {
-    const configPath = join(mathquillPath, 'migration-config.json');
-    if (!existsSync(configPath)) {
-      return null;
-    }
-
-    try {
-      return JSON.parse(readFileSync(configPath, 'utf-8'));
-    } catch {
-      return null;
-    }
-  }
-
-  private showMigrationMetadata(config: any): void {
-    if (config.version) {
-      this.log(`   Version:      ${config.version}`);
-    }
-    if (config.lastMigration) {
-      this.log(`   Last run:     ${new Date(config.lastMigration).toLocaleString()}`);
-    }
-    if (config.base?.installed) {
-      this.log(`   Base fork:    ${config.base.fork}@${config.base.installed}`);
-    }
-    if (config.migrationState) {
-      this.log(`   State:        ${config.migrationState}`);
-    }
-  }
-
-  private showNextSteps(status: string, isLegacy: boolean, _hasExtensions: boolean): void {
-    if (status === 'Complete') {
-      this.log('   ✅ Migration complete!');
-      this.log('   • Build: cd packages/shared/mathquill && bun run build');
-      this.log('   • Test:  bun test packages/lib-react/math-input');
-      this.log('   • Demo:  bun run dev:demo');
-      return;
-    }
-
-    if (status === 'Pending' && isLegacy) {
-      this.log('   📋 Migration needed');
-      this.log('   1. Run: pie mathquill:migrate --dry-run');
-      this.log('   2. Review the migration plan');
-      this.log('   3. Run: pie mathquill:migrate');
-      this.log('   4. Test thoroughly before committing');
-      return;
-    }
-
-    if (status === 'In Progress' || status === 'Transitioning') {
-      this.log('   ⚠️  Migration incomplete');
-      this.log('   1. Check for errors: pie mathquill:migrate --verbose');
-      this.log('   2. Or re-run: pie mathquill:migrate --force');
-      return;
-    }
-
-    this.log('   ❓ Unknown state - check documentation');
-    this.log('   • See: docs/MATHQUILL_MIGRATION_PLAN.md');
-    this.log('   • See: docs/MATHQUILL_MIGRATION_CLI_PLAN.md');
-  }
-}

package/src/commands/packages/create-controllers.ts

@@ -1,127 +0,0 @@
-import { Command, Flags } from '@oclif/core';
-import { Logger } from '../../utils/logger.js';
-import { extractDependencies } from '../../utils/package-json.js';
-import { existsSync } from 'node:fs';
-import { readdir, readFile, writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
-
-const SHARED_DIR = 'packages/shared';
-
-export default class CreateControllers extends Command {
-  static override description = 'Create package.json files for synced controllers';
-
-  static override examples = ['<%= config.bin %> <%= command.id %>'];
-
-  static override flags = {
-    verbose: Flags.boolean({
-      char: 'v',
-      description: 'Show detailed output',
-      default: false,
-    }),
-  };
-
-  private logger = new Logger();
-
-  public async run(): Promise<void> {
-    const { flags } = await this.parse(CreateControllers);
-
-    this.logger = new Logger(flags.verbose);
-
-    this.logger.section('📦 Creating package.json files for controllers');
-
-    const controllers = await readdir(SHARED_DIR);
-    let created = 0;
-    let skipped = 0;
-
-    for (const controller of controllers) {
-      const controllerDir = join(SHARED_DIR, controller);
-      const packageJsonPath = join(controllerDir, 'package.json');
-
-      // Skip if package.json already exists
-      if (existsSync(packageJsonPath)) {
-        this.logger.info(`  ⏭️  ${controller}: package.json already exists`);
-        skipped++;
-        continue;
-      }
-
-      // Scan for dependencies
-      const deps = await this.scanController(controllerDir);
-
-      // Generate package.json
-      const content = this.generatePackageJson(controller, deps);
-
-      // Write file
-      await writeFile(packageJsonPath, content, 'utf-8');
-      this.logger.success(`  ✅ ${controller}: Created package.json (${deps.length} dependencies)`);
-      created++;
-    }
-
-    this.logger.section(`\n📊 Summary: ${created} created, ${skipped} skipped`);
-  }
-
-  private async scanController(controllerDir: string): Promise<string[]> {
-    const srcDir = join(controllerDir, 'src');
-    const deps = new Set<string>();
-
-    if (!existsSync(srcDir)) {
-      return [];
-    }
-
-    const files = await readdir(srcDir);
-
-    for (const file of files) {
-      if (!file.endsWith('.ts')) continue;
-
-      const filePath = join(srcDir, file);
-      const content = await readFile(filePath, 'utf-8');
-      const fileDeps = extractDependencies(content);
-
-      for (const dep of fileDeps) deps.add(dep);
-    }
-
-    return Array.from(deps).sort();
-  }
-
-  private generatePackageJson(name: string, deps: string[]): string {
-    const dependencies: Record<string, string> = {};
-
-    for (const dep of deps) {
-      // Use * for external dependencies (they're in root package.json)
-      dependencies[dep] = '*';
-    }
-
-    const pkg = {
-      name: `@pie-element/${name}`,
-      version: '0.1.0',
-      description: `Framework-agnostic ${name.replace('-controller', '')} controller synced from pie-elements`,
-      type: 'module',
-      main: './src/index.ts',
-      types: './src/index.ts',
-      exports: {
-        '.': {
-          types: './src/index.ts',
-          default: './src/index.ts',
-        },
-      },
-      files: ['src'],
-      scripts: {
-        build: "echo 'Controllers are consumed as TypeScript source'",
-        lint: 'biome check .',
-        'lint:fix': 'biome check --write .',
-      },
-      dependencies: Object.keys(dependencies).length > 0 ? dependencies : undefined,
-      keywords: ['pie', 'pie-element', 'controller', name.replace('-controller', ''), 'assessment'],
-      license: 'ISC',
-      repository: {
-        type: 'git',
-        url: 'https://github.com/pie-framework/pie-elements-ng.git',
-        directory: `packages/shared/${name}`,
-      },
-    };
-
-    // Remove undefined fields
-    const cleaned = JSON.parse(JSON.stringify(pkg));
-
-    return `${JSON.stringify(cleaned, null, 2)}\n`;
-  }
-}