@git.zone/cli 1.15.5 → 1.16.1

package/ts/mod_format/classes.formatcontext.ts

@@ -0,0 +1,65 @@
+import * as plugins from './mod.plugins.js';
+import { RollbackManager } from './classes.rollbackmanager.js';
+import { ChangeCache } from './classes.changecache.js';
+import { FormatStats } from './classes.formatstats.js';
+import type { IFormatOperation, IFormatPlan } from './interfaces.format.js';
+
+export class FormatContext {
+  private rollbackManager: RollbackManager;
+  private currentOperation: IFormatOperation | null = null;
+  private changeCache: ChangeCache;
+  private formatStats: FormatStats;
+  
+  constructor() {
+    this.rollbackManager = new RollbackManager();
+    this.changeCache = new ChangeCache();
+    this.formatStats = new FormatStats();
+  }
+  
+  async beginOperation(): Promise<void> {
+    this.currentOperation = await this.rollbackManager.createOperation();
+  }
+  
+  async trackFileChange(filepath: string): Promise<void> {
+    if (!this.currentOperation) {
+      throw new Error('No operation in progress. Call beginOperation() first.');
+    }
+    await this.rollbackManager.backupFile(filepath, this.currentOperation.id);
+  }
+  
+  async commitOperation(): Promise<void> {
+    if (!this.currentOperation) {
+      throw new Error('No operation in progress. Call beginOperation() first.');
+    }
+    await this.rollbackManager.markComplete(this.currentOperation.id);
+    this.currentOperation = null;
+  }
+  
+  async rollbackOperation(): Promise<void> {
+    if (!this.currentOperation) {
+      throw new Error('No operation in progress. Call beginOperation() first.');
+    }
+    await this.rollbackManager.rollback(this.currentOperation.id);
+    this.currentOperation = null;
+  }
+  
+  async rollbackTo(operationId: string): Promise<void> {
+    await this.rollbackManager.rollback(operationId);
+  }
+  
+  getRollbackManager(): RollbackManager {
+    return this.rollbackManager;
+  }
+  
+  getChangeCache(): ChangeCache {
+    return this.changeCache;
+  }
+  
+  async initializeCache(): Promise<void> {
+    await this.changeCache.initialize();
+  }
+  
+  getFormatStats(): FormatStats {
+    return this.formatStats;
+  }
+}

package/ts/mod_format/classes.formatplanner.ts

@@ -0,0 +1,184 @@
+import * as plugins from './mod.plugins.js';
+import { FormatContext } from './classes.formatcontext.js';
+import { BaseFormatter } from './classes.baseformatter.js';
+import type { IFormatPlan, IPlannedChange } from './interfaces.format.js';
+import { logger } from '../gitzone.logging.js';
+import { DependencyAnalyzer } from './classes.dependency-analyzer.js';
+import { DiffReporter } from './classes.diffreporter.js';
+
+export class FormatPlanner {
+  private plannedChanges: Map<string, IPlannedChange[]> = new Map();
+  private dependencyAnalyzer = new DependencyAnalyzer();
+  private diffReporter = new DiffReporter();
+  
+  async planFormat(modules: BaseFormatter[]): Promise<IFormatPlan> {
+    const plan: IFormatPlan = {
+      summary: {
+        totalFiles: 0,
+        filesAdded: 0,
+        filesModified: 0,
+        filesRemoved: 0,
+        estimatedTime: 0
+      },
+      changes: [],
+      warnings: []
+    };
+    
+    for (const module of modules) {
+      try {
+        const changes = await module.analyze();
+        this.plannedChanges.set(module.name, changes);
+        
+        for (const change of changes) {
+          plan.changes.push(change);
+          
+          // Update summary
+          switch (change.type) {
+            case 'create':
+              plan.summary.filesAdded++;
+              break;
+            case 'modify':
+              plan.summary.filesModified++;
+              break;
+            case 'delete':
+              plan.summary.filesRemoved++;
+              break;
+          }
+        }
+      } catch (error) {
+        plan.warnings.push({
+          level: 'error',
+          message: `Failed to analyze module ${module.name}: ${error.message}`,
+          module: module.name
+        });
+      }
+    }
+    
+    plan.summary.totalFiles = plan.summary.filesAdded + plan.summary.filesModified + plan.summary.filesRemoved;
+    plan.summary.estimatedTime = plan.summary.totalFiles * 100; // 100ms per file estimate
+    
+    return plan;
+  }
+  
+  async executePlan(plan: IFormatPlan, modules: BaseFormatter[], context: FormatContext, parallel: boolean = true): Promise<void> {
+    await context.beginOperation();
+    const startTime = Date.now();
+    
+    try {
+      if (parallel) {
+        // Get execution groups based on dependencies
+        const executionGroups = this.dependencyAnalyzer.getExecutionGroups(modules);
+        
+        logger.log('info', `Executing formatters in ${executionGroups.length} groups...`);
+        
+        for (let i = 0; i < executionGroups.length; i++) {
+          const group = executionGroups[i];
+          logger.log('info', `Executing group ${i + 1}: ${group.map(m => m.name).join(', ')}`);
+          
+          // Execute modules in this group in parallel
+          const promises = group.map(async (module) => {
+            const changes = this.plannedChanges.get(module.name) || [];
+            if (changes.length > 0) {
+              logger.log('info', `Executing ${module.name} formatter...`);
+              await module.execute(changes);
+            }
+          });
+          
+          await Promise.all(promises);
+        }
+      } else {
+        // Sequential execution (original implementation)
+        for (const module of modules) {
+          const changes = this.plannedChanges.get(module.name) || [];
+          
+          if (changes.length > 0) {
+            logger.log('info', `Executing ${module.name} formatter...`);
+            await module.execute(changes);
+          }
+        }
+      }
+      
+      const endTime = Date.now();
+      const duration = endTime - startTime;
+      logger.log('info', `Format operations completed in ${duration}ms`);
+      
+      await context.commitOperation();
+    } catch (error) {
+      await context.rollbackOperation();
+      throw error;
+    }
+  }
+  
+  async displayPlan(plan: IFormatPlan, detailed: boolean = false): Promise<void> {
+    console.log('\nFormat Plan:');
+    console.log('━'.repeat(50));
+    console.log(`Summary: ${plan.summary.totalFiles} files will be changed`);
+    console.log(`  • ${plan.summary.filesAdded} new files`);
+    console.log(`  • ${plan.summary.filesModified} modified files`);
+    console.log(`  • ${plan.summary.filesRemoved} deleted files`);
+    console.log('');
+    console.log('Changes by module:');
+    
+    // Group changes by module
+    const changesByModule = new Map<string, IPlannedChange[]>();
+    for (const change of plan.changes) {
+      const moduleChanges = changesByModule.get(change.module) || [];
+      moduleChanges.push(change);
+      changesByModule.set(change.module, moduleChanges);
+    }
+    
+    for (const [module, changes] of changesByModule) {
+      console.log(`\n${this.getModuleIcon(module)} ${module} (${changes.length} ${changes.length === 1 ? 'file' : 'files'})`);
+      
+      for (const change of changes) {
+        const icon = this.getChangeIcon(change.type);
+        console.log(`  ${icon} ${change.path} - ${change.description}`);
+        
+        // Show diff for modified files if detailed view is requested
+        if (detailed && change.type === 'modify') {
+          const diff = await this.diffReporter.generateDiffForChange(change);
+          if (diff) {
+            this.diffReporter.displayDiff(change.path, diff);
+          }
+        }
+      }
+    }
+    
+    if (plan.warnings.length > 0) {
+      console.log('\nWarnings:');
+      for (const warning of plan.warnings) {
+        const icon = warning.level === 'error' ? '❌' : '⚠️';
+        console.log(`  ${icon} ${warning.message}`);
+      }
+    }
+    
+    console.log('\n' + '━'.repeat(50));
+  }
+  
+  private getModuleIcon(module: string): string {
+    const icons: Record<string, string> = {
+      'packagejson': '📦',
+      'license': '📝',
+      'tsconfig': '🔧',
+      'cleanup': '🚮',
+      'gitignore': '🔒',
+      'prettier': '✨',
+      'readme': '📖',
+      'templates': '📄',
+      'npmextra': '⚙️',
+      'copy': '📋'
+    };
+    return icons[module] || '📁';
+  }
+  
+  private getChangeIcon(type: 'create' | 'modify' | 'delete'): string {
+    switch (type) {
+      case 'create':
+        return '✅';
+      case 'modify':
+        return '✏️';
+      case 'delete':
+        return '❌';
+    }
+  }
+}

package/ts/mod_format/classes.formatstats.ts

@@ -0,0 +1,209 @@
+import * as plugins from './mod.plugins.js';
+import { logger } from '../gitzone.logging.js';
+
+export interface IModuleStats {
+  name: string;
+  filesProcessed: number;
+  executionTime: number;
+  errors: number;
+  successes: number;
+  filesCreated: number;
+  filesModified: number;
+  filesDeleted: number;
+}
+
+export interface IFormatStats {
+  totalExecutionTime: number;
+  startTime: number;
+  endTime: number;
+  moduleStats: Map<string, IModuleStats>;
+  overallStats: {
+    totalFiles: number;
+    totalCreated: number;
+    totalModified: number;
+    totalDeleted: number;
+    totalErrors: number;
+    cacheHits: number;
+    cacheMisses: number;
+  };
+}
+
+export class FormatStats {
+  private stats: IFormatStats;
+  
+  constructor() {
+    this.stats = {
+      totalExecutionTime: 0,
+      startTime: Date.now(),
+      endTime: 0,
+      moduleStats: new Map(),
+      overallStats: {
+        totalFiles: 0,
+        totalCreated: 0,
+        totalModified: 0,
+        totalDeleted: 0,
+        totalErrors: 0,
+        cacheHits: 0,
+        cacheMisses: 0
+      }
+    };
+  }
+  
+  startModule(moduleName: string): void {
+    this.stats.moduleStats.set(moduleName, {
+      name: moduleName,
+      filesProcessed: 0,
+      executionTime: 0,
+      errors: 0,
+      successes: 0,
+      filesCreated: 0,
+      filesModified: 0,
+      filesDeleted: 0
+    });
+  }
+  
+  moduleStartTime(moduleName: string): number {
+    return Date.now();
+  }
+  
+  endModule(moduleName: string, startTime: number): void {
+    const moduleStats = this.stats.moduleStats.get(moduleName);
+    if (moduleStats) {
+      moduleStats.executionTime = Date.now() - startTime;
+    }
+  }
+  
+  recordFileOperation(moduleName: string, operation: 'create' | 'modify' | 'delete', success: boolean = true): void {
+    const moduleStats = this.stats.moduleStats.get(moduleName);
+    if (!moduleStats) return;
+    
+    moduleStats.filesProcessed++;
+    
+    if (success) {
+      moduleStats.successes++;
+      this.stats.overallStats.totalFiles++;
+      
+      switch (operation) {
+        case 'create':
+          moduleStats.filesCreated++;
+          this.stats.overallStats.totalCreated++;
+          break;
+        case 'modify':
+          moduleStats.filesModified++;
+          this.stats.overallStats.totalModified++;
+          break;
+        case 'delete':
+          moduleStats.filesDeleted++;
+          this.stats.overallStats.totalDeleted++;
+          break;
+      }
+    } else {
+      moduleStats.errors++;
+      this.stats.overallStats.totalErrors++;
+    }
+  }
+  
+  recordCacheHit(): void {
+    this.stats.overallStats.cacheHits++;
+  }
+  
+  recordCacheMiss(): void {
+    this.stats.overallStats.cacheMisses++;
+  }
+  
+  finish(): void {
+    this.stats.endTime = Date.now();
+    this.stats.totalExecutionTime = this.stats.endTime - this.stats.startTime;
+  }
+  
+  displayStats(): void {
+    console.log('\n📊 Format Operation Statistics:');
+    console.log('═'.repeat(50));
+    
+    // Overall stats
+    console.log('\nOverall Summary:');
+    console.log(`  Total Execution Time: ${this.formatDuration(this.stats.totalExecutionTime)}`);
+    console.log(`  Files Processed: ${this.stats.overallStats.totalFiles}`);
+    console.log(`    • Created: ${this.stats.overallStats.totalCreated}`);
+    console.log(`    • Modified: ${this.stats.overallStats.totalModified}`);
+    console.log(`    • Deleted: ${this.stats.overallStats.totalDeleted}`);
+    console.log(`  Errors: ${this.stats.overallStats.totalErrors}`);
+    
+    if (this.stats.overallStats.cacheHits > 0 || this.stats.overallStats.cacheMisses > 0) {
+      const cacheHitRate = this.stats.overallStats.cacheHits / 
+        (this.stats.overallStats.cacheHits + this.stats.overallStats.cacheMisses) * 100;
+      console.log(`  Cache Hit Rate: ${cacheHitRate.toFixed(1)}%`);
+      console.log(`    • Hits: ${this.stats.overallStats.cacheHits}`);
+      console.log(`    • Misses: ${this.stats.overallStats.cacheMisses}`);
+    }
+    
+    // Module stats
+    console.log('\nModule Breakdown:');
+    console.log('─'.repeat(50));
+    
+    const sortedModules = Array.from(this.stats.moduleStats.values())
+      .sort((a, b) => b.filesProcessed - a.filesProcessed);
+    
+    for (const moduleStats of sortedModules) {
+      console.log(`\n${this.getModuleIcon(moduleStats.name)} ${moduleStats.name}:`);
+      console.log(`  Execution Time: ${this.formatDuration(moduleStats.executionTime)}`);
+      console.log(`  Files Processed: ${moduleStats.filesProcessed}`);
+      
+      if (moduleStats.filesCreated > 0) {
+        console.log(`    • Created: ${moduleStats.filesCreated}`);
+      }
+      if (moduleStats.filesModified > 0) {
+        console.log(`    • Modified: ${moduleStats.filesModified}`);
+      }
+      if (moduleStats.filesDeleted > 0) {
+        console.log(`    • Deleted: ${moduleStats.filesDeleted}`);
+      }
+      
+      if (moduleStats.errors > 0) {
+        console.log(`  ❌ Errors: ${moduleStats.errors}`);
+      }
+    }
+    
+    console.log('\n' + '═'.repeat(50));
+  }
+  
+  async saveReport(outputPath: string): Promise<void> {
+    const report = {
+      timestamp: new Date().toISOString(),
+      executionTime: this.stats.totalExecutionTime,
+      overallStats: this.stats.overallStats,
+      moduleStats: Array.from(this.stats.moduleStats.values())
+    };
+    
+    await plugins.smartfile.memory.toFs(JSON.stringify(report, null, 2), outputPath);
+    logger.log('info', `Statistics report saved to ${outputPath}`);
+  }
+  
+  private formatDuration(ms: number): string {
+    if (ms < 1000) {
+      return `${ms}ms`;
+    } else if (ms < 60000) {
+      return `${(ms / 1000).toFixed(1)}s`;
+    } else {
+      const minutes = Math.floor(ms / 60000);
+      const seconds = Math.floor((ms % 60000) / 1000);
+      return `${minutes}m ${seconds}s`;
+    }
+  }
+  
+  private getModuleIcon(module: string): string {
+    const icons: Record<string, string> = {
+      'packagejson': '📦',
+      'license': '📝',
+      'tsconfig': '🔧',
+      'cleanup': '🚮',
+      'gitignore': '🔒',
+      'prettier': '✨',
+      'readme': '📖',
+      'templates': '📄',
+      'npmextra': '⚙️',
+      'copy': '📋'
+    };
+    return icons[module] || '📁';
+  }
+}

package/ts/mod_format/classes.rollbackmanager.ts

@@ -0,0 +1,218 @@
+import * as plugins from './mod.plugins.js';
+import * as paths from '../paths.js';
+import type { IFormatOperation } from './interfaces.format.js';
+
+export class RollbackManager {
+  private backupDir: string;
+  private manifestPath: string;
+  
+  constructor() {
+    this.backupDir = plugins.path.join(paths.cwd, '.nogit', 'gitzone-backups');
+    this.manifestPath = plugins.path.join(this.backupDir, 'manifest.json');
+  }
+  
+  async createOperation(): Promise<IFormatOperation> {
+    await this.ensureBackupDir();
+    
+    const operation: IFormatOperation = {
+      id: this.generateOperationId(),
+      timestamp: Date.now(),
+      files: [],
+      status: 'pending'
+    };
+    
+    await this.updateManifest(operation);
+    return operation;
+  }
+  
+  async backupFile(filepath: string, operationId: string): Promise<void> {
+    const operation = await this.getOperation(operationId);
+    if (!operation) {
+      throw new Error(`Operation ${operationId} not found`);
+    }
+    
+    const absolutePath = plugins.path.isAbsolute(filepath) 
+      ? filepath 
+      : plugins.path.join(paths.cwd, filepath);
+    
+    // Check if file exists
+    const exists = await plugins.smartfile.fs.fileExists(absolutePath);
+    if (!exists) {
+      // File doesn't exist yet (will be created), so we skip backup
+      return;
+    }
+    
+    // Read file content and metadata
+    const content = await plugins.smartfile.fs.toStringSync(absolutePath);
+    const stats = await plugins.smartfile.fs.stat(absolutePath);
+    const checksum = this.calculateChecksum(content);
+    
+    // Create backup
+    const backupPath = this.getBackupPath(operationId, filepath);
+    await plugins.smartfile.fs.ensureDir(plugins.path.dirname(backupPath));
+    await plugins.smartfile.memory.toFs(content, backupPath);
+    
+    // Update operation
+    operation.files.push({
+      path: filepath,
+      originalContent: content,
+      checksum,
+      permissions: stats.mode.toString(8)
+    });
+    
+    await this.updateManifest(operation);
+  }
+  
+  async rollback(operationId: string): Promise<void> {
+    const operation = await this.getOperation(operationId);
+    if (!operation) {
+      throw new Error(`Operation ${operationId} not found`);
+    }
+    
+    if (operation.status === 'rolled-back') {
+      throw new Error(`Operation ${operationId} has already been rolled back`);
+    }
+    
+    // Restore files in reverse order
+    for (let i = operation.files.length - 1; i >= 0; i--) {
+      const file = operation.files[i];
+      const absolutePath = plugins.path.isAbsolute(file.path) 
+        ? file.path 
+        : plugins.path.join(paths.cwd, file.path);
+      
+      // Verify backup integrity
+      const backupPath = this.getBackupPath(operationId, file.path);
+      const backupContent = await plugins.smartfile.fs.toStringSync(backupPath);
+      const backupChecksum = this.calculateChecksum(backupContent);
+      
+      if (backupChecksum !== file.checksum) {
+        throw new Error(`Backup integrity check failed for ${file.path}`);
+      }
+      
+      // Restore file
+      await plugins.smartfile.memory.toFs(file.originalContent, absolutePath);
+      
+      // Restore permissions
+      const mode = parseInt(file.permissions, 8);
+      // Note: Permissions restoration may not work on all platforms
+    }
+    
+    // Update operation status
+    operation.status = 'rolled-back';
+    await this.updateManifest(operation);
+  }
+  
+  async markComplete(operationId: string): Promise<void> {
+    const operation = await this.getOperation(operationId);
+    if (!operation) {
+      throw new Error(`Operation ${operationId} not found`);
+    }
+    
+    operation.status = 'completed';
+    await this.updateManifest(operation);
+  }
+  
+  async cleanOldBackups(retentionDays: number): Promise<void> {
+    const manifest = await this.getManifest();
+    const cutoffTime = Date.now() - (retentionDays * 24 * 60 * 60 * 1000);
+    
+    const operationsToDelete = manifest.operations.filter(op => 
+      op.timestamp < cutoffTime && op.status === 'completed'
+    );
+    
+    for (const operation of operationsToDelete) {
+      // Remove backup files
+      const operationDir = plugins.path.join(this.backupDir, 'operations', operation.id);
+      await plugins.smartfile.fs.remove(operationDir);
+      
+      // Remove from manifest
+      manifest.operations = manifest.operations.filter(op => op.id !== operation.id);
+    }
+    
+    await this.saveManifest(manifest);
+  }
+  
+  async verifyBackup(operationId: string): Promise<boolean> {
+    const operation = await this.getOperation(operationId);
+    if (!operation) {
+      return false;
+    }
+    
+    for (const file of operation.files) {
+      const backupPath = this.getBackupPath(operationId, file.path);
+      const exists = await plugins.smartfile.fs.fileExists(backupPath);
+      
+      if (!exists) {
+        return false;
+      }
+      
+      const content = await plugins.smartfile.fs.toStringSync(backupPath);
+      const checksum = this.calculateChecksum(content);
+      
+      if (checksum !== file.checksum) {
+        return false;
+      }
+    }
+    
+    return true;
+  }
+  
+  async listBackups(): Promise<IFormatOperation[]> {
+    const manifest = await this.getManifest();
+    return manifest.operations;
+  }
+  
+  private async ensureBackupDir(): Promise<void> {
+    await plugins.smartfile.fs.ensureDir(this.backupDir);
+    await plugins.smartfile.fs.ensureDir(plugins.path.join(this.backupDir, 'operations'));
+  }
+  
+  private generateOperationId(): string {
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const random = Math.random().toString(36).substring(2, 8);
+    return `${timestamp}-${random}`;
+  }
+  
+  private getBackupPath(operationId: string, filepath: string): string {
+    const filename = plugins.path.basename(filepath);
+    const dir = plugins.path.dirname(filepath);
+    const safeDir = dir.replace(/[/\\]/g, '__');
+    return plugins.path.join(this.backupDir, 'operations', operationId, 'files', safeDir, `${filename}.backup`);
+  }
+  
+  private calculateChecksum(content: string | Buffer): string {
+    return plugins.crypto.createHash('sha256').update(content).digest('hex');
+  }
+  
+  private async getManifest(): Promise<{ operations: IFormatOperation[] }> {
+    const exists = await plugins.smartfile.fs.fileExists(this.manifestPath);
+    if (!exists) {
+      return { operations: [] };
+    }
+    
+    const content = await plugins.smartfile.fs.toStringSync(this.manifestPath);
+    return JSON.parse(content);
+  }
+  
+  private async saveManifest(manifest: { operations: IFormatOperation[] }): Promise<void> {
+    await plugins.smartfile.memory.toFs(JSON.stringify(manifest, null, 2), this.manifestPath);
+  }
+  
+  private async getOperation(operationId: string): Promise<IFormatOperation | null> {
+    const manifest = await this.getManifest();
+    return manifest.operations.find(op => op.id === operationId) || null;
+  }
+  
+  private async updateManifest(operation: IFormatOperation): Promise<void> {
+    const manifest = await this.getManifest();
+    const existingIndex = manifest.operations.findIndex(op => op.id === operation.id);
+    
+    if (existingIndex !== -1) {
+      manifest.operations[existingIndex] = operation;
+    } else {
+      manifest.operations.push(operation);
+    }
+    
+    await this.saveManifest(manifest);
+  }
+}