acdev 1.0.0

package/src/paths.js

@@ -0,0 +1,128 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+/** Product data directory inside the target repo (config, state, .env). */
+export const DATA_DIR = '.acdev';
+/** Older product data dirs — migrated once if present (newest first). */
+export const LEGACY_DATA_DIRS = ['.codepilot', '.agent-mcp'];
+
+/** Sibling worktrees root (next to the target repo). */
+export const WORKTREES_DIR = '.acdev-worktrees';
+export const LEGACY_WORKTREES_DIRS = ['.codepilot-worktrees', '.agent-mcp-worktrees'];
+
+/** @deprecated use LEGACY_DATA_DIRS */
+export const LEGACY_DATA_DIR = LEGACY_DATA_DIRS[LEGACY_DATA_DIRS.length - 1];
+/** @deprecated use LEGACY_WORKTREES_DIRS */
+export const LEGACY_WORKTREES_DIR = LEGACY_WORKTREES_DIRS[LEGACY_WORKTREES_DIRS.length - 1];
+
+/** @type {Set<string>} */
+const dataMigrationChecked = new Set();
+/** @type {Set<string>} */
+const worktreesMigrationChecked = new Set();
+
+/**
+ * @param {string} src
+ * @param {string} dest
+ */
+function copyDirRecursive(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const from = path.join(src, entry.name);
+    const to = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDirRecursive(from, to);
+    } else {
+      fs.copyFileSync(from, to);
+    }
+  }
+}
+
+/**
+ * Prefer rename; fall back to recursive copy (e.g. cross-device).
+ * @param {string} from
+ * @param {string} to
+ */
+function renameOrCopyDir(from, to) {
+  try {
+    fs.renameSync(from, to);
+  } catch {
+    copyDirRecursive(from, to);
+  }
+}
+
+/**
+ * If `.acdev/` is missing but a legacy data dir exists, migrate once (best-effort).
+ * Prefers `.codepilot/` over `.agent-mcp/` when both exist.
+ * @param {string} repoRoot
+ * @returns {boolean} true if migration ran
+ */
+export function migrateLegacyDataDir(repoRoot) {
+  if (dataMigrationChecked.has(repoRoot)) return false;
+  dataMigrationChecked.add(repoRoot);
+
+  const next = path.join(repoRoot, DATA_DIR);
+  if (fs.existsSync(next)) {
+    return false;
+  }
+
+  for (const legacyName of LEGACY_DATA_DIRS) {
+    const legacy = path.join(repoRoot, legacyName);
+    if (!fs.existsSync(legacy)) continue;
+    renameOrCopyDir(legacy, next);
+    console.log(`[acdev] Migrated ${legacyName}/ → ${DATA_DIR}/`);
+    return true;
+  }
+  return false;
+}
+
+/**
+ * If `.acdev-worktrees/` is missing but a legacy worktrees dir exists, migrate once.
+ * Worktrees live as a sibling of the repo root.
+ * @param {string} repoRoot
+ * @returns {boolean} true if migration ran
+ */
+export function migrateLegacyWorktreesDir(repoRoot) {
+  if (worktreesMigrationChecked.has(repoRoot)) return false;
+  worktreesMigrationChecked.add(repoRoot);
+
+  const next = path.join(repoRoot, '..', WORKTREES_DIR);
+  if (fs.existsSync(next)) {
+    return false;
+  }
+
+  for (const legacyName of LEGACY_WORKTREES_DIRS) {
+    const legacy = path.join(repoRoot, '..', legacyName);
+    if (!fs.existsSync(legacy)) continue;
+    renameOrCopyDir(legacy, next);
+    console.log(`[acdev] Migrated ${legacyName}/ → ${WORKTREES_DIR}/`);
+    return true;
+  }
+  return false;
+}
+
+/**
+ * Ensure legacy data is migrated, then return `.acdev` absolute path.
+ * Does not create the directory.
+ * @param {string} repoRoot
+ */
+export function dataDir(repoRoot) {
+  migrateLegacyDataDir(repoRoot);
+  return path.join(repoRoot, DATA_DIR);
+}
+
+/**
+ * Absolute path to the worktrees root (migrates legacy name if needed).
+ * @param {string} repoRoot
+ */
+export function worktreesRoot(repoRoot) {
+  migrateLegacyWorktreesDir(repoRoot);
+  return path.join(repoRoot, '..', WORKTREES_DIR);
+}
+
+/**
+ * Reset migration caches (tests only).
+ */
+export function _resetMigrationCachesForTests() {
+  dataMigrationChecked.clear();
+  worktreesMigrationChecked.clear();
+}