docrev 0.11.2 → 0.12.0

package/lib/commands/file-ops.ts

@@ -1,372 +0,0 @@
-/**
- * File operation commands: backup, archive, export, clean
- *
- * Commands that create, move, or delete project files.
- */
-
-import type { Command } from 'commander';
-import {
-  chalk,
-  fs,
-  path,
-  fmt,
-  findFiles,
-  loadBuildConfig,
-} from './context.js';
-
-// Use the actual BuildConfig from build.ts which allows string|Author[]
-type BuildConfig = ReturnType<typeof loadBuildConfig>;
-
-interface ZipLike {
-  addLocalFile(localPath: string, zipPath?: string): void;
-}
-
-/**
- * Recursively add directory contents to a zip archive, filtering by predicate
- */
-function addDirToZip(
-  zip: ZipLike,
-  dir: string,
-  shouldInclude: (name: string) => boolean,
-  zipPath = '',
-): void {
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = path.join(dir, entry.name);
-    const entryZipPath = path.join(zipPath, entry.name);
-
-    if (!shouldInclude(entry.name)) continue;
-
-    if (entry.isDirectory()) {
-      addDirToZip(zip, fullPath, shouldInclude, entryZipPath);
-    } else {
-      zip.addLocalFile(fullPath, zipPath || undefined);
-    }
-  }
-}
-
-// Options interfaces
-interface BackupOptions {
-  name?: string;
-  output?: string;
-}
-
-interface ArchiveOptions {
-  dir?: string;
-  by?: string;
-  rename?: boolean;
-  dryRun?: boolean;
-}
-
-interface ExportOptions {
-  output?: string;
-  includeOutput?: boolean;
-}
-
-interface CleanOptions {
-  dryRun?: boolean;
-  all?: boolean;
-}
-
-/**
- * Register file-ops commands with the program
- */
-export function register(program: Command): void {
-  // ==========================================================================
-  // BACKUP command - Timestamped project backup
-  // ==========================================================================
-
-  program
-    .command('backup')
-    .description('Create timestamped project backup')
-    .option('-n, --name <name>', 'Custom backup name')
-    .option('-o, --output <dir>', 'Output directory', '.')
-    .action(async (options: BackupOptions) => {
-      const { default: AdmZip } = await import('adm-zip');
-      const zip = new AdmZip();
-
-      const date = new Date().toISOString().slice(0, 10);
-      const name = options.name || `backup-${date}`;
-      const outputPath = path.join(options.output || '.', `${name}.zip`);
-
-      // Files to exclude
-      const excludePatterns = [
-        'node_modules', '.git', '.DS_Store', '*.zip',
-        'paper.md' // Generated file
-      ];
-
-      const shouldInclude = (file: string): boolean => {
-        for (const pattern of excludePatterns) {
-          if (file.includes(pattern.replace('*', ''))) return false;
-        }
-        return true;
-      };
-
-      addDirToZip(zip, '.', shouldInclude);
-
-      zip.writeZip(outputPath);
-      console.log(fmt.status('success', `Backup created: ${outputPath}`));
-    });
-
-  // ==========================================================================
-  // ARCHIVE command - Archive reviewer docx files
-  // ==========================================================================
-
-  program
-    .command('archive')
-    .description('Move reviewer .docx files to archive folder')
-    .argument('[files...]', 'Specific files to archive (default: all .docx)')
-    .option('-d, --dir <folder>', 'Archive folder name', 'archive')
-    .option('--by <name>', 'Reviewer name (auto-detected if single commenter)')
-    .option('--no-rename', 'Keep original filenames')
-    .option('--dry-run', 'Preview without moving files')
-    .action(async (files: string[] | undefined, options: ArchiveOptions) => {
-      const { extractWordComments } = await import('../import.js');
-      const { default: YAML } = await import('yaml');
-
-      // Find docx files to archive
-      let docxFiles = files && files.length > 0
-        ? files.filter(f => f.endsWith('.docx') && fs.existsSync(f))
-        : findFiles('.docx');
-
-      // Exclude our own build outputs
-      let projectSlug: string | null = null;
-      const configPath = path.join(process.cwd(), 'rev.yaml');
-      if (fs.existsSync(configPath)) {
-        try {
-          const config = YAML.parse(fs.readFileSync(configPath, 'utf-8'));
-          if (config.title) {
-            projectSlug = config.title
-              .toLowerCase()
-              .replace(/[^a-z0-9]+/g, '-')
-              .replace(/^-|-$/g, '')
-              .slice(0, 50);
-          }
-        } catch (e) {
-          // Ignore config errors
-        }
-      }
-
-      // Filter out build outputs
-      if (projectSlug && (!files || files.length === 0)) {
-        const buildPatterns = [
-          `${projectSlug}.docx`,
-          `${projectSlug}_comments.docx`,
-          `${projectSlug}-changes.docx`,
-          'paper.docx',
-          'paper_comments.docx',
-          'paper-changes.docx',
-        ];
-        const excluded: string[] = [];
-        docxFiles = docxFiles.filter(f => {
-          const base = path.basename(f).toLowerCase();
-          const isBuilt = buildPatterns.includes(base);
-          if (isBuilt) excluded.push(f);
-          return !isBuilt;
-        });
-        if (excluded.length > 0) {
-          console.log(chalk.dim(`  Skipping build outputs: ${excluded.join(', ')}`));
-          console.log();
-        }
-      }
-
-      if (docxFiles.length === 0) {
-        console.log(fmt.status('info', 'No .docx files to archive.'));
-        return;
-      }
-
-      const projectTitle = projectSlug;
-
-      // Create archive folder
-      const archiveDir = path.resolve(options.dir || 'archive');
-      if (!options.dryRun && !fs.existsSync(archiveDir)) {
-        fs.mkdirSync(archiveDir, { recursive: true });
-      }
-
-      console.log(fmt.header('Archive'));
-      console.log();
-
-      const moved: string[] = [];
-      for (const file of docxFiles) {
-        const stat = fs.statSync(file);
-        const mtime = stat.mtime;
-        const timestamp = mtime.toISOString().slice(0, 19).replace(/[-:]/g, '').replace('T', '_');
-
-        // Determine reviewer name
-        let reviewer: string | null = options.by || null;
-        if (!reviewer && options.rename !== false) {
-          try {
-            const comments = await extractWordComments(file);
-            const authors = [...new Set(comments.map(c => c.author).filter(a => a && a !== 'Unknown'))];
-            if (authors.length === 1) {
-              reviewer = authors[0].replace(/[^a-zA-Z0-9]/g, '-').replace(/^-|-$/g, '');
-            }
-          } catch (e) {
-            // Ignore extraction errors
-          }
-        }
-
-        // Generate new name
-        let newName: string;
-        if (options.rename === false) {
-          newName = path.basename(file);
-        } else {
-          const base = path.basename(file, '.docx');
-          if (/^\d{8}_\d{6}_/.test(base)) {
-            newName = path.basename(file);
-          } else {
-            const namePart = projectTitle || base;
-            if (reviewer) {
-              newName = `${timestamp}_${reviewer}_${namePart}.docx`;
-            } else {
-              newName = `${timestamp}_${namePart}.docx`;
-            }
-          }
-        }
-
-        const destPath = path.join(archiveDir, newName);
-
-        if (options.dryRun) {
-          console.log(`  ${chalk.dim(file)} → ${chalk.cyan(path.join(options.dir || 'archive', newName))}`);
-        } else {
-          // Handle name collision
-          let finalPath = destPath;
-          let counter = 1;
-          while (fs.existsSync(finalPath)) {
-            const ext = path.extname(newName);
-            const base = path.basename(newName, ext);
-            finalPath = path.join(archiveDir, `${base}_${counter}${ext}`);
-            counter++;
-          }
-          fs.renameSync(file, finalPath);
-          console.log(`  ${chalk.dim(file)} → ${chalk.green(path.relative(process.cwd(), finalPath))}`);
-        }
-        moved.push(file);
-      }
-
-      console.log();
-      if (options.dryRun) {
-        console.log(fmt.status('info', `Would archive ${moved.length} file(s). Run without --dry-run to proceed.`));
-      } else {
-        console.log(fmt.status('success', `Archived ${moved.length} file(s) to ${options.dir || 'archive'}/`));
-      }
-    });
-
-  // ==========================================================================
-  // EXPORT command - Export project as distributable zip
-  // ==========================================================================
-
-  program
-    .command('export')
-    .description('Export project as distributable zip')
-    .option('-o, --output <file>', 'Output filename')
-    .option('--include-output', 'Include built PDF/DOCX files')
-    .action(async (options: ExportOptions) => {
-      const { default: AdmZip } = await import('adm-zip');
-      const { build } = await import('../build.js');
-
-      let config: Partial<BuildConfig> = {};
-      try {
-        config = loadBuildConfig('.') || {};
-      } catch {
-        // Not in a rev project, that's ok
-      }
-
-      // Build first if including output
-      if (options.includeOutput) {
-        console.log(chalk.dim('Building documents...'));
-        await build('.', ['pdf', 'docx']);
-      }
-
-      const zip = new AdmZip();
-      const projectName = config.title?.replace(/[^a-zA-Z0-9]/g, '-').toLowerCase() || 'project';
-      const outputPath = options.output || `${projectName}-export.zip`;
-
-      const exclude = ['node_modules', '.git', '.DS_Store', '*.zip'];
-
-      const shouldInclude = (name: string): boolean => {
-        if (!options.includeOutput && (name.endsWith('.pdf') || name.endsWith('.docx'))) {
-          return false;
-        }
-        for (const pattern of exclude) {
-          if (name === pattern || name.includes(pattern.replace('*', ''))) return false;
-        }
-        return true;
-      };
-
-      addDirToZip(zip, '.', shouldInclude);
-
-      zip.writeZip(outputPath);
-      console.log(fmt.status('success', `Exported: ${outputPath}`));
-    });
-
-  // ==========================================================================
-  // CLEAN command - Remove generated files
-  // ==========================================================================
-
-  program
-    .command('clean')
-    .description('Remove generated files (paper.md, PDFs, DOCXs)')
-    .option('-n, --dry-run', 'Show what would be deleted without deleting')
-    .option('--all', 'Also remove backup and export zips')
-    .action((options: CleanOptions) => {
-      let config: Partial<BuildConfig> = {};
-      try {
-        config = loadBuildConfig('.') || {};
-      } catch {
-        // Not in a rev project, that's ok
-      }
-
-      const projectName = config.title?.toLowerCase().replace(/\s+/g, '-') || 'paper';
-
-      // Files to clean
-      const patterns = [
-        'paper.md',
-        '*.pdf',
-        `${projectName}.docx`,
-        `${projectName}.pdf`,
-        `${projectName}.tex`,
-        '.paper-*.md', // Temp build files
-      ];
-
-      if (options.all) {
-        patterns.push('*.zip', 'backup-*.zip', '*-export.zip');
-      }
-
-      const toDelete: string[] = [];
-
-      for (const pattern of patterns) {
-        if (pattern.includes('*')) {
-          const regex = new RegExp('^' + pattern.replace(/\./g, '\\.').replace(/\*/g, '.*') + '$');
-          const files = fs.readdirSync('.').filter(f => regex.test(f));
-          toDelete.push(...files);
-        } else if (fs.existsSync(pattern)) {
-          toDelete.push(pattern);
-        }
-      }
-
-      if (toDelete.length === 0) {
-        console.log(chalk.dim('No generated files to clean.'));
-        return;
-      }
-
-      console.log(fmt.header('Clean'));
-      console.log();
-
-      for (const file of toDelete) {
-        if (options.dryRun) {
-          console.log(chalk.dim(`  Would delete: ${file}`));
-        } else {
-          fs.unlinkSync(file);
-          console.log(chalk.red(`  Deleted: ${file}`));
-        }
-      }
-
-      console.log();
-      if (options.dryRun) {
-        console.log(chalk.dim(`Would delete ${toDelete.length} file(s). Run without --dry-run to delete.`));
-      } else {
-        console.log(fmt.status('success', `Cleaned ${toDelete.length} file(s)`));
-      }
-    });
-}

package/lib/commands/history.ts

@@ -1,320 +0,0 @@
-/**
- * History commands: diff, history, contributors
- *
- * Commands for git-based revision tracking and author statistics.
- */
-
-import type { Command } from 'commander';
-import {
-  chalk,
-  fs,
-  path,
-  fmt,
-  loadBuildConfig,
-} from './context.js';
-
-interface DiffOptions {
-  files?: string;
-  stat?: boolean;
-}
-
-interface HistoryOptions {
-  limit: string;
-}
-
-interface ContributorsOptions {
-  blame?: boolean;
-}
-
-/**
- * Register history commands with the program
- */
-export function register(program: Command): void {
-  // ==========================================================================
-  // DIFF command - Compare sections against git history
-  // ==========================================================================
-
-  program
-    .command('diff')
-    .description('Compare sections against git history')
-    .argument('[ref]', 'Git reference to compare against (default: main/master)')
-    .option('-f, --files <files>', 'Specific files to compare (comma-separated)')
-    .option('--stat', 'Show only statistics, not full diff')
-    .action(async (ref: string | undefined, options: DiffOptions) => {
-      const {
-        isGitRepo,
-        getDefaultBranch,
-        getCurrentBranch,
-        getChangedFiles,
-        getWordCountDiff,
-        compareFileVersions,
-      } = await import('../git.js');
-
-      if (!isGitRepo()) {
-        console.error(fmt.status('error', 'Not a git repository'));
-        process.exit(1);
-      }
-
-      const compareRef = ref || getDefaultBranch();
-      const currentBranch = getCurrentBranch();
-
-      console.log(fmt.header('Git Diff'));
-      console.log(chalk.dim(`  Comparing: ${compareRef} → ${currentBranch || 'HEAD'}`));
-      console.log();
-
-      // Get files to compare
-      let filesToCompare: string[];
-      if (options.files) {
-        filesToCompare = options.files.split(',').map(f => f.trim());
-      } else {
-        // Default to markdown section files
-        filesToCompare = fs.readdirSync('.').filter(f =>
-          f.endsWith('.md') && !['README.md', 'CLAUDE.md'].includes(f)
-        );
-      }
-
-      if (filesToCompare.length === 0) {
-        console.log(fmt.status('info', 'No markdown files found'));
-        return;
-      }
-
-      // Get changed files from git
-      const changedFiles = getChangedFiles(compareRef);
-      const changedSet = new Set(changedFiles.map(f => f.file));
-
-      // Get word count differences
-      const { total, byFile } = getWordCountDiff(filesToCompare, compareRef);
-
-      // Show results
-      const rows: string[][] = [];
-      for (const file of filesToCompare) {
-        const stats = byFile[file];
-        if (stats && (stats.added > 0 || stats.removed > 0)) {
-          const status = changedSet.has(file)
-            ? changedFiles.find(f => f.file === file)?.status || 'modified'
-            : 'unchanged';
-          rows.push([
-            file,
-            status,
-            chalk.green(`+${stats.added}`),
-            chalk.red(`-${stats.removed}`),
-          ]);
-        }
-      }
-
-      if (rows.length === 0) {
-        console.log(fmt.status('success', 'No changes detected'));
-        return;
-      }
-
-      console.log(fmt.table(['File', 'Status', 'Added', 'Removed'], rows));
-      console.log();
-      console.log(chalk.dim(`Total: ${chalk.green(`+${total.added}`)} words, ${chalk.red(`-${total.removed}`)} words`));
-
-      // Show detailed diff if not --stat
-      if (!options.stat && rows.length > 0) {
-        console.log();
-        console.log(chalk.cyan('Changed sections:'));
-        for (const file of filesToCompare) {
-          const stats = byFile[file];
-          if (stats && (stats.added > 0 || stats.removed > 0)) {
-            const { changes } = compareFileVersions(file, compareRef);
-            console.log(chalk.bold(`\n  ${file}:`));
-
-            // Show first few significant changes
-            let shown = 0;
-            for (const change of changes) {
-              if (shown >= 3) {
-                console.log(chalk.dim('    ...'));
-                break;
-              }
-              const preview = change.value.slice(0, 60).replace(/\n/g, ' ');
-              if (change.added) {
-                console.log(chalk.green(`    + "${preview}..."`));
-              } else if (change.removed) {
-                console.log(chalk.red(`    - "${preview}..."`));
-              }
-              shown++;
-            }
-          }
-        }
-      }
-    });
-
-  // ==========================================================================
-  // HISTORY command - Show revision history
-  // ==========================================================================
-
-  program
-    .command('history')
-    .description('Show revision history for section files')
-    .argument('[file]', 'Specific file (default: all sections)')
-    .option('-n, --limit <count>', 'Number of commits to show', '10')
-    .action(async (file: string | undefined, options: HistoryOptions) => {
-      const {
-        isGitRepo,
-        getFileHistory,
-        getRecentCommits,
-        hasUncommittedChanges,
-      } = await import('../git.js');
-
-      if (!isGitRepo()) {
-        console.error(fmt.status('error', 'Not a git repository'));
-        process.exit(1);
-      }
-
-      const limit = parseInt(options.limit) || 10;
-
-      console.log(fmt.header('Revision History'));
-      console.log();
-
-      if (file) {
-        // Show history for specific file
-        if (!fs.existsSync(file)) {
-          console.error(fmt.status('error', `File not found: ${file}`));
-          process.exit(1);
-        }
-
-        const history = getFileHistory(file, limit);
-
-        if (history.length === 0) {
-          console.log(fmt.status('info', 'No history found (file may not be committed)'));
-          return;
-        }
-
-        console.log(chalk.cyan(`History for ${file}:`));
-        console.log();
-
-        for (const commit of history) {
-          const date = new Date(commit.date).toLocaleDateString();
-          console.log(`  ${chalk.yellow(commit.hash)} ${chalk.dim(date)}`);
-          console.log(`    ${commit.message}`);
-        }
-      } else {
-        // Show recent commits affecting any file
-        const commits = getRecentCommits(limit);
-
-        if (commits.length === 0) {
-          console.log(fmt.status('info', 'No commits found'));
-          return;
-        }
-
-        if (hasUncommittedChanges()) {
-          console.log(chalk.yellow('  * Uncommitted changes'));
-          console.log();
-        }
-
-        for (const commit of commits) {
-          const date = new Date(commit.date).toLocaleDateString();
-          console.log(`  ${chalk.yellow(commit.hash)} ${chalk.dim(date)} ${chalk.blue(commit.author)}`);
-          console.log(`    ${commit.message}`);
-        }
-      }
-    });
-
-  // ==========================================================================
-  // CONTRIBUTORS command - Show who wrote what
-  // ==========================================================================
-
-  program
-    .command('contributors')
-    .alias('authors')
-    .description('Show author contributions across section files')
-    .argument('[file]', 'Specific file (default: all sections)')
-    .option('--blame', 'Show detailed line-by-line blame for a file')
-    .action(async (file: string | undefined, options: ContributorsOptions) => {
-      const { isGitRepo, getAuthorStats, getContributors, getFileBlame } = await import('../git.js');
-
-      if (!isGitRepo()) {
-        console.error(fmt.status('error', 'Not a git repository'));
-        process.exit(1);
-      }
-
-      console.log(fmt.header('Contributors'));
-      console.log();
-
-      if (file) {
-        // Show stats for specific file
-        if (!fs.existsSync(file)) {
-          console.error(fmt.status('error', `File not found: ${file}`));
-          process.exit(1);
-        }
-
-        if (options.blame) {
-          // Detailed blame output
-          const blame = getFileBlame(file);
-          if (blame.length === 0) {
-            console.log(fmt.status('info', 'No git history (file may not be committed)'));
-            return;
-          }
-
-          console.log(chalk.cyan(`Blame for ${file}:`));
-          console.log();
-
-          for (const entry of blame) {
-            const authorShort = entry.author.slice(0, 15).padEnd(15);
-            const content = entry.content.length > 60 ? entry.content.slice(0, 60) + '...' : entry.content;
-            console.log(`  ${chalk.dim(entry.hash)} ${chalk.blue(authorShort)} ${chalk.dim(`L${String(entry.line).padStart(3)}`)} ${content}`);
-          }
-        } else {
-          // Summary stats
-          const stats = getAuthorStats(file);
-          if (Object.keys(stats).length === 0) {
-            console.log(fmt.status('info', 'No git history (file may not be committed)'));
-            return;
-          }
-
-          console.log(chalk.cyan(`Authors for ${file}:`));
-          console.log();
-
-          const sorted = Object.entries(stats).sort((a, b) => b[1].lines - a[1].lines);
-          for (const [author, data] of sorted) {
-            const bar = '█'.repeat(Math.ceil(data.percentage / 5));
-            console.log(`  ${chalk.blue(author.padEnd(25))} ${chalk.dim(String(data.lines).padStart(4))} lines ${chalk.green(bar)} ${data.percentage}%`);
-          }
-        }
-      } else {
-        // Show contributors across all sections
-        let config: { sections?: string[] } = {};
-        try {
-          config = loadBuildConfig(process.cwd()) || {};
-        } catch {
-          // Not in a rev project
-        }
-
-        let sections = config.sections || [];
-        if (sections.length === 0) {
-          sections = fs.readdirSync('.').filter(f =>
-            f.endsWith('.md') && !['README.md', 'CLAUDE.md', 'paper.md'].includes(f)
-          );
-        }
-
-        if (sections.length === 0) {
-          console.error(fmt.status('error', 'No section files found'));
-          process.exit(1);
-        }
-
-        const contributors = getContributors(sections);
-
-        if (Object.keys(contributors).length === 0) {
-          console.log(fmt.status('info', 'No git history found'));
-          return;
-        }
-
-        const sorted = Object.entries(contributors).sort((a, b) => b[1].lines - a[1].lines);
-        const totalLines = sorted.reduce((sum, [, data]) => sum + data.lines, 0);
-
-        console.log(chalk.cyan('Project contributors:'));
-        console.log();
-
-        for (const [author, data] of sorted) {
-          const pct = Math.round((data.lines / totalLines) * 100);
-          const bar = '█'.repeat(Math.ceil(pct / 5));
-          console.log(`  ${chalk.blue(author.padEnd(25))} ${chalk.dim(String(data.lines).padStart(5))} lines  ${chalk.dim(String(data.files))} files ${chalk.green(bar)} ${pct}%`);
-        }
-
-        console.log();
-        console.log(chalk.dim(`  Total: ${totalLines} lines across ${sections.length} files`));
-      }
-    });
-}