@within-7/minto 0.3.5 → 0.3.9

package/dist/utils/migration/migrateTodos.js

@@ -0,0 +1,323 @@
+import {
+  existsSync,
+  readFileSync,
+  writeFileSync,
+  mkdirSync,
+  readdirSync,
+  renameSync,
+  unlinkSync
+} from "fs";
+import { join, resolve } from "path";
+import crypto from "crypto";
+import { CONFIG_PATHS, ensureConfigDirs } from "../configPaths.js";
+import { debug as debugLogger } from "../debugLogger.js";
+const MIGRATION_MARKER_FILE = ".todos-migration-completed";
+const MIGRATION_VERSION = "1.0.0";
+const LEGACY_FILE_PATTERN = /^default-session-agent-([a-f0-9-]{36})\.json$/;
+const ORPHAN_PROJECT_HASH = "_orphaned";
+function getMigrationMarkerPath() {
+  return join(CONFIG_PATHS.base, MIGRATION_MARKER_FILE);
+}
+function checkMigrationNeeded() {
+  const markerPath = getMigrationMarkerPath();
+  return !existsSync(markerPath);
+}
+function getMigrationStatus() {
+  const markerPath = getMigrationMarkerPath();
+  if (!existsSync(markerPath)) {
+    return {
+      completed: false,
+      version: MIGRATION_VERSION,
+      migratedFiles: 0,
+      errors: []
+    };
+  }
+  try {
+    const content = readFileSync(markerPath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return {
+      completed: false,
+      version: MIGRATION_VERSION,
+      migratedFiles: 0,
+      errors: []
+    };
+  }
+}
+function writeMigrationMarker(result) {
+  const markerPath = getMigrationMarkerPath();
+  const status = {
+    completed: true,
+    timestamp: Date.now(),
+    version: MIGRATION_VERSION,
+    migratedFiles: result.migrated,
+    errors: result.errors.slice(0, 10)
+    // Keep only first 10 errors
+  };
+  try {
+    writeFileSync(markerPath, JSON.stringify(status, null, 2), "utf-8");
+    debugLogger.info("MIGRATION_MARKER_WRITTEN", {
+      path: markerPath,
+      migrated: result.migrated
+    });
+  } catch (error) {
+    debugLogger.error("MIGRATION_MARKER_WRITE_FAILED", {
+      error: error instanceof Error ? error.message : String(error)
+    });
+  }
+}
+function scanLegacyTodoFiles() {
+  const configDir = CONFIG_PATHS.base;
+  const files = [];
+  if (!existsSync(configDir)) {
+    return files;
+  }
+  try {
+    const entries = readdirSync(configDir);
+    for (const entry of entries) {
+      const match = entry.match(LEGACY_FILE_PATTERN);
+      if (match) {
+        const sessionId = match[1];
+        if (sessionId) {
+          files.push({
+            filename: entry,
+            filepath: join(configDir, entry),
+            sessionId
+          });
+        }
+      }
+    }
+    debugLogger.info("MIGRATION_SCAN_COMPLETE", {
+      found: files.length,
+      directory: configDir
+    });
+  } catch (error) {
+    debugLogger.error("MIGRATION_SCAN_FAILED", {
+      error: error instanceof Error ? error.message : String(error)
+    });
+  }
+  return files;
+}
+function findTranscriptForSession(sessionId) {
+  const transcriptsDir = join(CONFIG_PATHS.base, "transcripts");
+  if (!existsSync(transcriptsDir)) {
+    return null;
+  }
+  try {
+    const files = readdirSync(transcriptsDir);
+    const exactMatch = `${sessionId}.json`;
+    if (files.includes(exactMatch)) {
+      const content = readFileSync(join(transcriptsDir, exactMatch), "utf-8");
+      return JSON.parse(content);
+    }
+    for (const file of files) {
+      if (!file.endsWith(".json")) continue;
+      try {
+        const content = readFileSync(join(transcriptsDir, file), "utf-8");
+        const transcript = JSON.parse(content);
+        if (transcript.metadata?.cwd || transcript.metadata?.projectPath) {
+          return transcript;
+        }
+      } catch {
+        continue;
+      }
+    }
+  } catch {
+  }
+  return null;
+}
+function hashPath(path) {
+  const normalized = resolve(path).toLowerCase();
+  return crypto.createHash("sha256").update(normalized).digest("hex").slice(0, 16);
+}
+function getProjectHashFromTranscript(transcript) {
+  if (!transcript) {
+    return ORPHAN_PROJECT_HASH;
+  }
+  const projectPath = transcript.metadata?.projectPath || transcript.metadata?.cwd || null;
+  if (!projectPath) {
+    return ORPHAN_PROJECT_HASH;
+  }
+  return hashPath(projectPath);
+}
+function migrateSingleFile(file, log) {
+  try {
+    const content = readFileSync(file.filepath, "utf-8");
+    const todoData = JSON.parse(content);
+    if (!Array.isArray(todoData)) {
+      return {
+        success: false,
+        error: `Invalid todo file format: ${file.filename} (not an array)`
+      };
+    }
+    if (todoData.length === 0) {
+      log.push(`Skipped empty file: ${file.filename}`);
+      try {
+        unlinkSync(file.filepath);
+        log.push(`Deleted empty file: ${file.filename}`);
+      } catch {
+      }
+      return { success: true };
+    }
+    const transcript = findTranscriptForSession(file.sessionId);
+    const projectHash = getProjectHashFromTranscript(transcript);
+    const targetDir = join(CONFIG_PATHS.sessions, projectHash, file.sessionId);
+    const targetPath = join(targetDir, "todos.json");
+    if (existsSync(targetPath)) {
+      log.push(`Target exists, skipping: ${file.filename} -> ${targetPath}`);
+      const backupPath2 = file.filepath + ".migrated";
+      renameSync(file.filepath, backupPath2);
+      return { success: true };
+    }
+    if (!existsSync(targetDir)) {
+      mkdirSync(targetDir, { recursive: true });
+    }
+    writeFileSync(targetPath, JSON.stringify(todoData, null, 2), "utf-8");
+    const backupPath = file.filepath + ".migrated";
+    renameSync(file.filepath, backupPath);
+    log.push(
+      `Migrated: ${file.filename} -> sessions/${projectHash}/${file.sessionId}/todos.json (${todoData.length} items)`
+    );
+    debugLogger.trace("MIGRATION_FILE_SUCCESS", {
+      source: file.filename,
+      target: targetPath,
+      items: todoData.length,
+      projectHash
+    });
+    return { success: true };
+  } catch (error) {
+    const errorMsg = error instanceof Error ? error.message : String(error);
+    return {
+      success: false,
+      error: `Failed to migrate ${file.filename}: ${errorMsg}`
+    };
+  }
+}
+async function migrateTodos() {
+  const result = {
+    migrated: 0,
+    skipped: 0,
+    errors: [],
+    log: []
+  };
+  if (!checkMigrationNeeded()) {
+    const status = getMigrationStatus();
+    result.log.push(
+      `Migration already completed at ${status.timestamp ? new Date(status.timestamp).toISOString() : "unknown"}`
+    );
+    result.log.push(`Previously migrated ${status.migratedFiles} files`);
+    debugLogger.info("MIGRATION_ALREADY_COMPLETE", { status });
+    return result;
+  }
+  debugLogger.info("MIGRATION_START", { version: MIGRATION_VERSION });
+  result.log.push(`Starting todo migration (version ${MIGRATION_VERSION})`);
+  ensureConfigDirs();
+  const legacyFiles = scanLegacyTodoFiles();
+  if (legacyFiles.length === 0) {
+    result.log.push("No legacy todo files found");
+    debugLogger.info("MIGRATION_NO_FILES", {});
+    writeMigrationMarker(result);
+    return result;
+  }
+  result.log.push(`Found ${legacyFiles.length} legacy todo files to migrate`);
+  for (const file of legacyFiles) {
+    const migrationResult = migrateSingleFile(file, result.log);
+    if (migrationResult.success) {
+      result.migrated++;
+    } else if (migrationResult.error) {
+      result.errors.push(migrationResult.error);
+      result.log.push(`ERROR: ${migrationResult.error}`);
+      debugLogger.error("MIGRATION_FILE_FAILED", {
+        file: file.filename,
+        error: migrationResult.error
+      });
+    } else {
+      result.skipped++;
+    }
+  }
+  writeMigrationMarker(result);
+  debugLogger.info("MIGRATION_COMPLETE", {
+    migrated: result.migrated,
+    skipped: result.skipped,
+    errors: result.errors.length
+  });
+  result.log.push("");
+  result.log.push("=== Migration Summary ===");
+  result.log.push(`Migrated: ${result.migrated}`);
+  result.log.push(`Skipped: ${result.skipped}`);
+  result.log.push(`Errors: ${result.errors.length}`);
+  return result;
+}
+function cleanupMigrationBackups() {
+  const configDir = CONFIG_PATHS.base;
+  let cleaned = 0;
+  if (!existsSync(configDir)) {
+    return 0;
+  }
+  try {
+    const entries = readdirSync(configDir);
+    for (const entry of entries) {
+      if (entry.endsWith(".migrated")) {
+        const filepath = join(configDir, entry);
+        try {
+          unlinkSync(filepath);
+          cleaned++;
+          debugLogger.trace("MIGRATION_BACKUP_CLEANED", { file: entry });
+        } catch {
+        }
+      }
+    }
+    debugLogger.info("MIGRATION_CLEANUP_COMPLETE", { cleaned });
+  } catch (error) {
+    debugLogger.error("MIGRATION_CLEANUP_FAILED", {
+      error: error instanceof Error ? error.message : String(error)
+    });
+  }
+  return cleaned;
+}
+async function forceMigration() {
+  const markerPath = getMigrationMarkerPath();
+  if (existsSync(markerPath)) {
+    try {
+      unlinkSync(markerPath);
+      debugLogger.info("MIGRATION_MARKER_REMOVED", { path: markerPath });
+    } catch {
+    }
+  }
+  return migrateTodos();
+}
+async function runStartupMigration() {
+  if (!checkMigrationNeeded()) {
+    debugLogger.trace("STARTUP_MIGRATION_SKIPPED", {
+      reason: "already completed"
+    });
+    return;
+  }
+  debugLogger.info("STARTUP_MIGRATION_RUNNING", {});
+  try {
+    const result = await migrateTodos();
+    if (result.errors.length > 0) {
+      debugLogger.warn("STARTUP_MIGRATION_ERRORS", {
+        errors: result.errors.slice(0, 5),
+        totalErrors: result.errors.length
+      });
+    }
+    debugLogger.info("STARTUP_MIGRATION_DONE", {
+      migrated: result.migrated,
+      skipped: result.skipped
+    });
+  } catch (error) {
+    debugLogger.error("STARTUP_MIGRATION_FAILED", {
+      error: error instanceof Error ? error.message : String(error)
+    });
+  }
+}
+export {
+  checkMigrationNeeded,
+  cleanupMigrationBackups,
+  forceMigration,
+  getMigrationStatus,
+  migrateTodos,
+  runStartupMigration
+};
+//# sourceMappingURL=migrateTodos.js.map

package/dist/utils/migration/migrateTodos.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/migration/migrateTodos.ts"],
+  "sourcesContent": ["/**\n * Todo Files Migration Tool\n *\n * Migrates legacy todo files from ~/.minto/ root directory to the new\n * structured sessions directory hierarchy.\n *\n * Legacy format: ~/.minto/default-session-agent-{uuid}.json\n * New format:    ~/.minto/sessions/{project-hash}/{session-id}/todos.json\n *\n * Migration process:\n * 1. Scan for legacy todo files matching the pattern\n * 2. Extract session ID from filename\n * 3. Attempt to find associated transcript to get project context\n * 4. Move to new location or use fallback directory\n * 5. Write migration log\n */\n\nimport {\n  existsSync,\n  readFileSync,\n  writeFileSync,\n  mkdirSync,\n  readdirSync,\n  renameSync,\n  unlinkSync,\n} from 'fs'\nimport { join, resolve } from 'path'\nimport crypto from 'crypto'\nimport { CONFIG_PATHS, ensureConfigDirs } from '../configPaths'\nimport { debug as debugLogger } from '../debugLogger'\n\n/**\n * Result of a migration operation\n */\nexport interface MigrationResult {\n  /** Number of files successfully migrated */\n  migrated: number\n  /** Number of files skipped (already migrated or invalid) */\n  skipped: number\n  /** Error messages for failed migrations */\n  errors: string[]\n  /** Detailed log of all operations */\n  log: string[]\n}\n\n/**\n * Migration status stored in marker file\n */\nexport interface MigrationStatus {\n  completed: boolean\n  timestamp?: number\n  version: string\n  migratedFiles: number\n  errors: string[]\n}\n\n/**\n * Legacy todo file info\n */\ninterface LegacyTodoFile {\n  filename: string\n  filepath: string\n  sessionId: string\n}\n\n/**\n * Transcript metadata used for project association\n */\ninterface TranscriptMetadata {\n  agentId: string\n  prompt?: string\n  metadata?: {\n    cwd?: string\n    projectPath?: string\n  }\n}\n\n// Migration marker file path\nconst MIGRATION_MARKER_FILE = '.todos-migration-completed'\nconst MIGRATION_VERSION = '1.0.0'\n\n// Legacy file pattern: default-session-agent-{uuid}.json\nconst LEGACY_FILE_PATTERN = /^default-session-agent-([a-f0-9-]{36})\\.json$/\n\n// Fallback project hash for orphan todos (no associated transcript)\nconst ORPHAN_PROJECT_HASH = '_orphaned'\n\n/**\n * Get the path to the migration marker file\n */\nfunction getMigrationMarkerPath(): string {\n  return join(CONFIG_PATHS.base, MIGRATION_MARKER_FILE)\n}\n\n/**\n * Check if migration has already been completed\n */\nexport function checkMigrationNeeded(): boolean {\n  const markerPath = getMigrationMarkerPath()\n  return !existsSync(markerPath)\n}\n\n/**\n * Get the current migration status\n */\nexport function getMigrationStatus(): MigrationStatus {\n  const markerPath = getMigrationMarkerPath()\n\n  if (!existsSync(markerPath)) {\n    return {\n      completed: false,\n      version: MIGRATION_VERSION,\n      migratedFiles: 0,\n      errors: [],\n    }\n  }\n\n  try {\n    const content = readFileSync(markerPath, 'utf-8')\n    return JSON.parse(content) as MigrationStatus\n  } catch {\n    return {\n      completed: false,\n      version: MIGRATION_VERSION,\n      migratedFiles: 0,\n      errors: [],\n    }\n  }\n}\n\n/**\n * Write migration completion marker\n */\nfunction writeMigrationMarker(result: MigrationResult): void {\n  const markerPath = getMigrationMarkerPath()\n  const status: MigrationStatus = {\n    completed: true,\n    timestamp: Date.now(),\n    version: MIGRATION_VERSION,\n    migratedFiles: result.migrated,\n    errors: result.errors.slice(0, 10), // Keep only first 10 errors\n  }\n\n  try {\n    writeFileSync(markerPath, JSON.stringify(status, null, 2), 'utf-8')\n    debugLogger.info('MIGRATION_MARKER_WRITTEN', {\n      path: markerPath,\n      migrated: result.migrated,\n    })\n  } catch (error) {\n    debugLogger.error('MIGRATION_MARKER_WRITE_FAILED', {\n      error: error instanceof Error ? error.message : String(error),\n    })\n  }\n}\n\n/**\n * Scan for legacy todo files in ~/.minto/\n */\nfunction scanLegacyTodoFiles(): LegacyTodoFile[] {\n  const configDir = CONFIG_PATHS.base\n  const files: LegacyTodoFile[] = []\n\n  if (!existsSync(configDir)) {\n    return files\n  }\n\n  try {\n    const entries = readdirSync(configDir)\n\n    for (const entry of entries) {\n      const match = entry.match(LEGACY_FILE_PATTERN)\n      if (match) {\n        const sessionId = match[1]\n        if (sessionId) {\n          files.push({\n            filename: entry,\n            filepath: join(configDir, entry),\n            sessionId,\n          })\n        }\n      }\n    }\n\n    debugLogger.info('MIGRATION_SCAN_COMPLETE', {\n      found: files.length,\n      directory: configDir,\n    })\n  } catch (error) {\n    debugLogger.error('MIGRATION_SCAN_FAILED', {\n      error: error instanceof Error ? error.message : String(error),\n    })\n  }\n\n  return files\n}\n\n/**\n * Try to find transcript file for a session ID\n */\nfunction findTranscriptForSession(\n  sessionId: string,\n): TranscriptMetadata | null {\n  const transcriptsDir = join(CONFIG_PATHS.base, 'transcripts')\n\n  if (!existsSync(transcriptsDir)) {\n    return null\n  }\n\n  try {\n    const files = readdirSync(transcriptsDir)\n\n    // Try exact match first (agent ID might be the session ID)\n    const exactMatch = `${sessionId}.json`\n    if (files.includes(exactMatch)) {\n      const content = readFileSync(join(transcriptsDir, exactMatch), 'utf-8')\n      return JSON.parse(content) as TranscriptMetadata\n    }\n\n    // Search through transcripts for matching metadata\n    for (const file of files) {\n      if (!file.endsWith('.json')) continue\n\n      try {\n        const content = readFileSync(join(transcriptsDir, file), 'utf-8')\n        const transcript = JSON.parse(content) as TranscriptMetadata\n\n        // Check if this transcript is related to the session\n        if (transcript.metadata?.cwd || transcript.metadata?.projectPath) {\n          // Return any transcript with project info as a reasonable default\n          return transcript\n        }\n      } catch {\n        // Skip invalid transcript files\n        continue\n      }\n    }\n  } catch {\n    // Silently fail if we can't read transcripts\n  }\n\n  return null\n}\n\n/**\n * Hash a path to create a safe directory name\n * Same algorithm as SessionMemoryManager\n */\nfunction hashPath(path: string): string {\n  const normalized = resolve(path).toLowerCase()\n  return crypto\n    .createHash('sha256')\n    .update(normalized)\n    .digest('hex')\n    .slice(0, 16)\n}\n\n/**\n * Get project hash from transcript or return orphan hash\n */\nfunction getProjectHashFromTranscript(\n  transcript: TranscriptMetadata | null,\n): string {\n  if (!transcript) {\n    return ORPHAN_PROJECT_HASH\n  }\n\n  const projectPath =\n    transcript.metadata?.projectPath || transcript.metadata?.cwd || null\n\n  if (!projectPath) {\n    return ORPHAN_PROJECT_HASH\n  }\n\n  return hashPath(projectPath)\n}\n\n/**\n * Migrate a single todo file to the new location\n */\nfunction migrateSingleFile(\n  file: LegacyTodoFile,\n  log: string[],\n): { success: boolean; error?: string } {\n  try {\n    // Read the legacy todo file\n    const content = readFileSync(file.filepath, 'utf-8')\n    const todoData = JSON.parse(content)\n\n    // Validate that it's actually a todo file (array of todo items)\n    if (!Array.isArray(todoData)) {\n      return {\n        success: false,\n        error: `Invalid todo file format: ${file.filename} (not an array)`,\n      }\n    }\n\n    // Skip empty todo files\n    if (todoData.length === 0) {\n      log.push(`Skipped empty file: ${file.filename}`)\n      // Delete empty files\n      try {\n        unlinkSync(file.filepath)\n        log.push(`Deleted empty file: ${file.filename}`)\n      } catch {\n        // Ignore delete errors\n      }\n      return { success: true }\n    }\n\n    // Try to find associated transcript for project context\n    const transcript = findTranscriptForSession(file.sessionId)\n    const projectHash = getProjectHashFromTranscript(transcript)\n\n    // Create target directory\n    const targetDir = join(CONFIG_PATHS.sessions, projectHash, file.sessionId)\n    const targetPath = join(targetDir, 'todos.json')\n\n    // Check if target already exists\n    if (existsSync(targetPath)) {\n      log.push(`Target exists, skipping: ${file.filename} -> ${targetPath}`)\n      // Rename old file as backup\n      const backupPath = file.filepath + '.migrated'\n      renameSync(file.filepath, backupPath)\n      return { success: true }\n    }\n\n    // Create directory structure\n    if (!existsSync(targetDir)) {\n      mkdirSync(targetDir, { recursive: true })\n    }\n\n    // Write to new location\n    writeFileSync(targetPath, JSON.stringify(todoData, null, 2), 'utf-8')\n\n    // Remove original file (or rename to .migrated for safety)\n    const backupPath = file.filepath + '.migrated'\n    renameSync(file.filepath, backupPath)\n\n    log.push(\n      `Migrated: ${file.filename} -> sessions/${projectHash}/${file.sessionId}/todos.json (${todoData.length} items)`,\n    )\n\n    debugLogger.trace('MIGRATION_FILE_SUCCESS', {\n      source: file.filename,\n      target: targetPath,\n      items: todoData.length,\n      projectHash,\n    })\n\n    return { success: true }\n  } catch (error) {\n    const errorMsg = error instanceof Error ? error.message : String(error)\n    return {\n      success: false,\n      error: `Failed to migrate ${file.filename}: ${errorMsg}`,\n    }\n  }\n}\n\n/**\n * Main migration function\n *\n * Scans for legacy todo files and migrates them to the new\n * structured sessions directory.\n *\n * @returns Migration result with statistics and logs\n */\nexport async function migrateTodos(): Promise<MigrationResult> {\n  const result: MigrationResult = {\n    migrated: 0,\n    skipped: 0,\n    errors: [],\n    log: [],\n  }\n\n  // Check if migration is needed\n  if (!checkMigrationNeeded()) {\n    const status = getMigrationStatus()\n    result.log.push(\n      `Migration already completed at ${status.timestamp ? new Date(status.timestamp).toISOString() : 'unknown'}`,\n    )\n    result.log.push(`Previously migrated ${status.migratedFiles} files`)\n    debugLogger.info('MIGRATION_ALREADY_COMPLETE', { status })\n    return result\n  }\n\n  debugLogger.info('MIGRATION_START', { version: MIGRATION_VERSION })\n  result.log.push(`Starting todo migration (version ${MIGRATION_VERSION})`)\n\n  // Ensure required directories exist\n  ensureConfigDirs()\n\n  // Scan for legacy files\n  const legacyFiles = scanLegacyTodoFiles()\n\n  if (legacyFiles.length === 0) {\n    result.log.push('No legacy todo files found')\n    debugLogger.info('MIGRATION_NO_FILES', {})\n    // Still write marker to prevent future scans\n    writeMigrationMarker(result)\n    return result\n  }\n\n  result.log.push(`Found ${legacyFiles.length} legacy todo files to migrate`)\n\n  // Migrate each file\n  for (const file of legacyFiles) {\n    const migrationResult = migrateSingleFile(file, result.log)\n\n    if (migrationResult.success) {\n      result.migrated++\n    } else if (migrationResult.error) {\n      result.errors.push(migrationResult.error)\n      result.log.push(`ERROR: ${migrationResult.error}`)\n      debugLogger.error('MIGRATION_FILE_FAILED', {\n        file: file.filename,\n        error: migrationResult.error,\n      })\n    } else {\n      result.skipped++\n    }\n  }\n\n  // Write completion marker\n  writeMigrationMarker(result)\n\n  debugLogger.info('MIGRATION_COMPLETE', {\n    migrated: result.migrated,\n    skipped: result.skipped,\n    errors: result.errors.length,\n  })\n\n  result.log.push('')\n  result.log.push('=== Migration Summary ===')\n  result.log.push(`Migrated: ${result.migrated}`)\n  result.log.push(`Skipped: ${result.skipped}`)\n  result.log.push(`Errors: ${result.errors.length}`)\n\n  return result\n}\n\n/**\n * Clean up backup files created during migration\n * Call this after verifying migration was successful\n */\nexport function cleanupMigrationBackups(): number {\n  const configDir = CONFIG_PATHS.base\n  let cleaned = 0\n\n  if (!existsSync(configDir)) {\n    return 0\n  }\n\n  try {\n    const entries = readdirSync(configDir)\n\n    for (const entry of entries) {\n      if (entry.endsWith('.migrated')) {\n        const filepath = join(configDir, entry)\n        try {\n          unlinkSync(filepath)\n          cleaned++\n          debugLogger.trace('MIGRATION_BACKUP_CLEANED', { file: entry })\n        } catch {\n          // Ignore individual cleanup errors\n        }\n      }\n    }\n\n    debugLogger.info('MIGRATION_CLEANUP_COMPLETE', { cleaned })\n  } catch (error) {\n    debugLogger.error('MIGRATION_CLEANUP_FAILED', {\n      error: error instanceof Error ? error.message : String(error),\n    })\n  }\n\n  return cleaned\n}\n\n/**\n * Force re-run migration (for debugging/recovery)\n * Removes the migration marker and runs migration again\n */\nexport async function forceMigration(): Promise<MigrationResult> {\n  const markerPath = getMigrationMarkerPath()\n\n  if (existsSync(markerPath)) {\n    try {\n      unlinkSync(markerPath)\n      debugLogger.info('MIGRATION_MARKER_REMOVED', { path: markerPath })\n    } catch {\n      // Ignore errors\n    }\n  }\n\n  return migrateTodos()\n}\n\n/**\n * Check and run migration at application startup\n * Should be called early in the application lifecycle\n */\nexport async function runStartupMigration(): Promise<void> {\n  if (!checkMigrationNeeded()) {\n    debugLogger.trace('STARTUP_MIGRATION_SKIPPED', {\n      reason: 'already completed',\n    })\n    return\n  }\n\n  debugLogger.info('STARTUP_MIGRATION_RUNNING', {})\n\n  try {\n    const result = await migrateTodos()\n\n    if (result.errors.length > 0) {\n      debugLogger.warn('STARTUP_MIGRATION_ERRORS', {\n        errors: result.errors.slice(0, 5),\n        totalErrors: result.errors.length,\n      })\n    }\n\n    debugLogger.info('STARTUP_MIGRATION_DONE', {\n      migrated: result.migrated,\n      skipped: result.skipped,\n    })\n  } catch (error) {\n    debugLogger.error('STARTUP_MIGRATION_FAILED', {\n      error: error instanceof Error ? error.message : String(error),\n    })\n    // Don't throw - migration failures shouldn't block application startup\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["backupPath"]
+}

package/dist/utils/pasteCache.js

@@ -0,0 +1,309 @@
+import {
+  existsSync,
+  readFileSync,
+  writeFileSync,
+  mkdirSync,
+  readdirSync,
+  unlinkSync
+} from "fs";
+import { join } from "path";
+import crypto from "crypto";
+import { CONFIG_PATHS } from "./configPaths.js";
+import { debug as debugLogger } from "./debugLogger.js";
+const DEFAULT_THRESHOLD = 1e3;
+const DEFAULT_TTL = 7 * 24 * 60 * 60 * 1e3;
+const MAX_CACHE_SIZE = 100;
+function getPasteCacheDir() {
+  return CONFIG_PATHS.pasteCache;
+}
+function ensureCacheDir() {
+  const cacheDir = getPasteCacheDir();
+  if (!existsSync(cacheDir)) {
+    mkdirSync(cacheDir, { recursive: true });
+  }
+}
+function hashContent(content) {
+  return crypto.createHash("sha256").update(content, "utf-8").digest("hex");
+}
+function getCacheFilePath(hash) {
+  return join(getPasteCacheDir(), `${hash}.txt`);
+}
+function getMetadataFilePath(hash) {
+  return join(getPasteCacheDir(), `${hash}.meta.json`);
+}
+function countLines(content) {
+  return (content.match(/\r\n|\r|\n/g) || []).length + 1;
+}
+function cachePaste(content, options = {}) {
+  const { threshold = DEFAULT_THRESHOLD } = options;
+  if (content.length < threshold) {
+    return null;
+  }
+  try {
+    ensureCacheDir();
+    const hash = hashContent(content);
+    const filePath = getCacheFilePath(hash);
+    const metadataPath = getMetadataFilePath(hash);
+    const entry = {
+      hash,
+      length: content.length,
+      lineCount: countLines(content),
+      timestamp: Date.now()
+    };
+    if (!existsSync(filePath)) {
+      writeFileSync(filePath, content, "utf-8");
+      writeFileSync(metadataPath, JSON.stringify(entry, null, 2), "utf-8");
+      debugLogger.trace("PASTE_CACHE_STORED", {
+        hash: hash.slice(0, 16),
+        length: content.length,
+        lineCount: entry.lineCount
+      });
+    } else {
+      const existingMeta = getMetadata(hash);
+      if (existingMeta) {
+        existingMeta.timestamp = Date.now();
+        writeFileSync(
+          metadataPath,
+          JSON.stringify(existingMeta, null, 2),
+          "utf-8"
+        );
+      }
+      debugLogger.trace("PASTE_CACHE_HIT", {
+        hash: hash.slice(0, 16)
+      });
+    }
+    return entry;
+  } catch (error) {
+    debugLogger.error("PASTE_CACHE_STORE_FAILED", {
+      error: error instanceof Error ? error.message : String(error),
+      contentLength: content.length
+    });
+    return null;
+  }
+}
+function getPaste(hash) {
+  const filePath = getCacheFilePath(hash);
+  if (!existsSync(filePath)) {
+    debugLogger.trace("PASTE_CACHE_MISS", { hash: hash.slice(0, 16) });
+    return null;
+  }
+  try {
+    const content = readFileSync(filePath, "utf-8");
+    debugLogger.trace("PASTE_CACHE_RETRIEVED", {
+      hash: hash.slice(0, 16),
+      length: content.length
+    });
+    return content;
+  } catch (error) {
+    debugLogger.error("PASTE_CACHE_READ_FAILED", {
+      error: error instanceof Error ? error.message : String(error),
+      hash: hash.slice(0, 16)
+    });
+    return null;
+  }
+}
+function getMetadata(hash) {
+  const metadataPath = getMetadataFilePath(hash);
+  if (!existsSync(metadataPath)) {
+    return null;
+  }
+  try {
+    const content = readFileSync(metadataPath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+function isCached(content) {
+  const hash = hashContent(content);
+  return existsSync(getCacheFilePath(hash));
+}
+function getContentHash(content) {
+  return hashContent(content);
+}
+function createPlaceholder(entry) {
+  return `[Cached paste: ${entry.lineCount} lines, ${entry.length} chars, hash:${entry.hash.slice(0, 8)}]`;
+}
+function parsePlaceholder(placeholder) {
+  const match = placeholder.match(/hash:([a-f0-9]{8,64})\]/);
+  return match ? match[1] : null;
+}
+function expandPlaceholder(placeholder) {
+  const hash = parsePlaceholder(placeholder);
+  if (!hash) {
+    return placeholder;
+  }
+  const cacheDir = getPasteCacheDir();
+  if (!existsSync(cacheDir)) {
+    return placeholder;
+  }
+  try {
+    const files = readdirSync(cacheDir);
+    const matchingFile = files.find(
+      (f) => f.startsWith(hash) && f.endsWith(".txt")
+    );
+    if (matchingFile) {
+      const fullHash = matchingFile.replace(".txt", "");
+      const content = getPaste(fullHash);
+      if (content) {
+        return content;
+      }
+    }
+  } catch {
+  }
+  return placeholder;
+}
+function listCachedEntries() {
+  const cacheDir = getPasteCacheDir();
+  if (!existsSync(cacheDir)) {
+    return [];
+  }
+  const entries = [];
+  try {
+    const files = readdirSync(cacheDir);
+    for (const file of files) {
+      if (file.endsWith(".meta.json")) {
+        const metadataPath = join(cacheDir, file);
+        try {
+          const content = readFileSync(metadataPath, "utf-8");
+          const entry = JSON.parse(content);
+          entries.push(entry);
+        } catch {
+        }
+      }
+    }
+  } catch {
+  }
+  return entries.sort((a, b) => b.timestamp - a.timestamp);
+}
+function cleanupExpiredEntries(options = {}) {
+  const { ttl = DEFAULT_TTL } = options;
+  const cacheDir = getPasteCacheDir();
+  const now = Date.now();
+  let removed = 0;
+  if (!existsSync(cacheDir)) {
+    return 0;
+  }
+  try {
+    const entries = listCachedEntries();
+    for (const entry of entries) {
+      if (now - entry.timestamp > ttl) {
+        try {
+          const filePath = getCacheFilePath(entry.hash);
+          const metadataPath = getMetadataFilePath(entry.hash);
+          if (existsSync(filePath)) {
+            unlinkSync(filePath);
+          }
+          if (existsSync(metadataPath)) {
+            unlinkSync(metadataPath);
+          }
+          removed++;
+          debugLogger.trace("PASTE_CACHE_EXPIRED_REMOVED", {
+            hash: entry.hash.slice(0, 16),
+            age: now - entry.timestamp
+          });
+        } catch {
+        }
+      }
+    }
+    if (removed > 0) {
+      debugLogger.info("PASTE_CACHE_CLEANUP_COMPLETE", {
+        removed,
+        remaining: entries.length - removed
+      });
+    }
+  } catch (error) {
+    debugLogger.error("PASTE_CACHE_CLEANUP_FAILED", {
+      error: error instanceof Error ? error.message : String(error)
+    });
+  }
+  return removed;
+}
+function enforceMaxCacheSize() {
+  const entries = listCachedEntries();
+  if (entries.length <= MAX_CACHE_SIZE) {
+    return 0;
+  }
+  const toRemove = entries.sort((a, b) => a.timestamp - b.timestamp).slice(0, entries.length - MAX_CACHE_SIZE);
+  let removed = 0;
+  for (const entry of toRemove) {
+    try {
+      const filePath = getCacheFilePath(entry.hash);
+      const metadataPath = getMetadataFilePath(entry.hash);
+      if (existsSync(filePath)) {
+        unlinkSync(filePath);
+      }
+      if (existsSync(metadataPath)) {
+        unlinkSync(metadataPath);
+      }
+      removed++;
+    } catch {
+    }
+  }
+  if (removed > 0) {
+    debugLogger.info("PASTE_CACHE_SIZE_ENFORCED", {
+      removed,
+      maxSize: MAX_CACHE_SIZE
+    });
+  }
+  return removed;
+}
+function getCacheStats() {
+  const entries = listCachedEntries();
+  if (entries.length === 0) {
+    return {
+      entryCount: 0,
+      totalSize: 0,
+      oldestEntry: null,
+      newestEntry: null
+    };
+  }
+  const totalSize = entries.reduce((sum, e) => sum + e.length, 0);
+  const timestamps = entries.map((e) => e.timestamp);
+  return {
+    entryCount: entries.length,
+    totalSize,
+    oldestEntry: Math.min(...timestamps),
+    newestEntry: Math.max(...timestamps)
+  };
+}
+function clearCache() {
+  const cacheDir = getPasteCacheDir();
+  let removed = 0;
+  if (!existsSync(cacheDir)) {
+    return 0;
+  }
+  try {
+    const files = readdirSync(cacheDir);
+    for (const file of files) {
+      try {
+        unlinkSync(join(cacheDir, file));
+        removed++;
+      } catch {
+      }
+    }
+    debugLogger.info("PASTE_CACHE_CLEARED", { removed });
+  } catch (error) {
+    debugLogger.error("PASTE_CACHE_CLEAR_FAILED", {
+      error: error instanceof Error ? error.message : String(error)
+    });
+  }
+  return removed;
+}
+export {
+  cachePaste,
+  cleanupExpiredEntries,
+  clearCache,
+  createPlaceholder,
+  enforceMaxCacheSize,
+  expandPlaceholder,
+  getCacheStats,
+  getContentHash,
+  getMetadata,
+  getPaste,
+  getPasteCacheDir,
+  isCached,
+  listCachedEntries,
+  parsePlaceholder
+};
+//# sourceMappingURL=pasteCache.js.map