Function copyCanonicalSources

src/init.js:286–341

(targetDir, { overwrite = false, backupFn = null, protectedFn = null } = {})

}

export async function copyCanonicalSources(targetDir, { overwrite = false, backupFn = null, protectedFn = null } = {}) {
  let count = 0;

  for (const { src, dest } of CANONICAL_SOURCES) {
    const isDashboard = dest === 'dashboard';
    let entries;
    try {
      entries = await getTemplateEntries(src);
    } catch {
      continue; // source dir doesn't exist (e.g., running from a partial install)
    }

    for (const entry of entries) {
      const relativeToSrc = entry.slice(src.length + 1);
      const normalizedRel = relativeToSrc.replace(/\\/g, '/');

      // Skip dashboard-local artifacts
      if (isDashboard && DASHBOARD_EXCLUDES.some(ex => normalizedRel === ex || normalizedRel.startsWith(ex + '/'))) {
        continue;
      }

      const relativePath = join(dest, relativeToSrc);
      const normalizedPath = relativePath.replace(/\\/g, '/');

      // Skip protected paths (update mode)
      if (protectedFn && protectedFn(normalizedPath)) continue;

      const destPath = join(targetDir, relativePath);
      await mkdir(dirname(destPath), { recursive: true });

      if (!overwrite) {
        // Init mode: skip existing files
        try {
          await stat(destPath);
          continue;
        } catch {
          // does not exist — copy it
        }
        await cp(entry, destPath);
        console.log(`  ${t('createdFile', { path: normalizedPath })}`);
      } else {
        // Update mode: backup then overwrite
        const backed = backupFn ? await backupFn(destPath) : false;
        await cp(entry, destPath);
        if (backed) {
          console.log(`  ${t('updatedFile', { path: normalizedPath })} (backup: ${normalizedPath}.bak)`);
        } else {
          console.log(`  ${t('updatedFile', { path: normalizedPath })}`);
        }
      }
      count++;
    }
  }

  return count;
}