ai-ide-config 0.1.0 → 0.1.2

package/src/init.mjs

@@ -1,195 +1,195 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { sharedTemplatesDir, stackTemplatesDir } from './paths.mjs';
-import { ensureExactPnpmEngines } from './package-manager.mjs';
-
-const GITIGNORE = '.gitignore';
-const GITIGNORE_ENTRIES = ['.cursor/', '.agents/'];
-
-/**
- * Recursively collect relative file paths under dir.
- * @param {string} dir
- * @param {string} [base]
- * @returns {string[]}
- */
-function listFiles(dir, base = dir) {
-  if (!fs.existsSync(dir)) {
-    return [];
-  }
-
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-  const files = [];
-
-  for (const entry of entries) {
-    const absolute = path.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      files.push(...listFiles(absolute, base));
-    } else if (entry.isFile()) {
-      files.push(path.relative(base, absolute));
-    }
-  }
-
-  return files;
-}
-
-/**
- * @typedef {{ created: string[], skipped: string[], overwritten: string[], updated: string[] }} CopyReport
- */
-
-/**
- * Whether .gitignore already ignores a directory entry (with or without trailing slash).
- * @param {string} content
- * @param {string} entry e.g. ".cursor/" or ".agents/"
- */
-function hasIgnoreEntry(content, entry) {
-  const name = entry.replace(/\/$/, '').replace(/^\./, '\\.');
-  return new RegExp(`(?:^|\\n)\\s*${name}\\/?\\s*(?:\\n|$)`).test(content);
-}
-
-/**
- * Create .gitignore with required entries, or append any that are missing.
- * @param {string} targetDir
- * @param {{ dryRun?: boolean }} options
- * @param {CopyReport} report
- */
-function ensureGitignore(targetDir, options, report) {
-  const filePath = path.join(targetDir, GITIGNORE);
-  const exists = fs.existsSync(filePath);
-
-  if (!exists) {
-    if (options.dryRun) {
-      report.created.push(`${GITIGNORE} (${GITIGNORE_ENTRIES.join(', ')})`);
-      return;
-    }
-    fs.writeFileSync(filePath, `${GITIGNORE_ENTRIES.join('\n')}\n`, 'utf8');
-    report.created.push(GITIGNORE);
-    return;
-  }
-
-  const content = fs.readFileSync(filePath, 'utf8');
-  const missing = GITIGNORE_ENTRIES.filter(
-    (entry) => !hasIgnoreEntry(content, entry),
-  );
-
-  if (missing.length === 0) {
-    report.skipped.push(
-      `${GITIGNORE} (${GITIGNORE_ENTRIES.join(', ')} already listed)`,
-    );
-    return;
-  }
-
-  if (options.dryRun) {
-    report.updated.push(`${GITIGNORE} (append ${missing.join(', ')})`);
-    return;
-  }
-
-  const separator = content.length === 0 || content.endsWith('\n') ? '' : '\n';
-  fs.writeFileSync(
-    filePath,
-    `${content}${separator}${missing.join('\n')}\n`,
-    'utf8',
-  );
-  report.updated.push(`${GITIGNORE} (appended ${missing.join(', ')})`);
-}
-
-/**
- * Copy all files from sourceRoot into targetDir.
- * @param {string} sourceRoot
- * @param {string} targetDir
- * @param {{ force?: boolean, dryRun?: boolean }} options
- * @param {CopyReport} report
- */
-function copyTree(sourceRoot, targetDir, options, report) {
-  const relativeFiles = listFiles(sourceRoot);
-
-  for (const relative of relativeFiles) {
-    const from = path.join(sourceRoot, relative);
-    const to = path.join(targetDir, relative);
-    const exists = fs.existsSync(to);
-
-    if (exists && !options.force) {
-      report.skipped.push(relative);
-      continue;
-    }
-
-    if (options.dryRun) {
-      if (exists) {
-        report.overwritten.push(relative);
-      } else {
-        report.created.push(relative);
-      }
-      continue;
-    }
-
-    fs.mkdirSync(path.dirname(to), { recursive: true });
-    fs.copyFileSync(from, to);
-
-    if (exists) {
-      report.overwritten.push(relative);
-    } else {
-      report.created.push(relative);
-    }
-  }
-}
-
-/**
- * Scaffold shared .cursor config + stack templates into targetDir.
- * @param {{ stack: { id: string, agentsDir: string }, targetDir: string, force?: boolean, dryRun?: boolean }} opts
- * @returns {CopyReport}
- */
-export function initStack(opts) {
-  const { stack, targetDir, force = false, dryRun = false } = opts;
-  const options = { force, dryRun };
-  /** @type {CopyReport} */
-  const report = {
-    created: [],
-    skipped: [],
-    overwritten: [],
-    updated: [],
-  };
-
-  const shared = sharedTemplatesDir();
-  const stackDir = stackTemplatesDir(stack.agentsDir);
-
-  if (!fs.existsSync(shared)) {
-    throw new Error(`Shared templates missing: ${shared}`);
-  }
-  if (!fs.existsSync(stackDir)) {
-    throw new Error(`Stack templates missing for "${stack.id}": ${stackDir}`);
-  }
-
-  copyTree(shared, targetDir, options, report);
-  copyTree(stackDir, targetDir, options, report);
-  ensureGitignore(targetDir, options, report);
-  ensureExactPnpmEngines(targetDir, options, report);
-
-  return report;
-}
-
-export function printReport(report, { dryRun = false } = {}) {
-  const prefix = dryRun ? '[dry-run] ' : '';
-
-  const sections = [
-    ['Created', report.created],
-    ['Updated', report.updated],
-    ['Overwritten', report.overwritten],
-    ['Skipped (already exists)', report.skipped],
-  ];
-
-  for (const [label, files] of sections) {
-    if (!files || files.length === 0) continue;
-    console.log(`${prefix}${label}:`);
-    for (const file of files) {
-      console.log(`  ${file}`);
-    }
-  }
-
-  if (
-    report.created.length === 0 &&
-    report.overwritten.length === 0 &&
-    report.skipped.length === 0 &&
-    (report.updated?.length ?? 0) === 0
-  ) {
-    console.log(`${prefix}Nothing to do.`);
-  }
-}
+import fs from 'node:fs';
+import path from 'node:path';
+import { sharedTemplatesDir, stackTemplatesDir } from './paths.mjs';
+import { ensureExactPnpmEngines } from './package-manager.mjs';
+
+const GITIGNORE = '.gitignore';
+const GITIGNORE_ENTRIES = ['.cursor/', '.agents/'];
+
+/**
+ * Recursively collect relative file paths under dir.
+ * @param {string} dir
+ * @param {string} [base]
+ * @returns {string[]}
+ */
+function listFiles(dir, base = dir) {
+  if (!fs.existsSync(dir)) {
+    return [];
+  }
+
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  const files = [];
+
+  for (const entry of entries) {
+    const absolute = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...listFiles(absolute, base));
+    } else if (entry.isFile()) {
+      files.push(path.relative(base, absolute));
+    }
+  }
+
+  return files;
+}
+
+/**
+ * @typedef {{ created: string[], skipped: string[], overwritten: string[], updated: string[] }} CopyReport
+ */
+
+/**
+ * Whether .gitignore already ignores a directory entry (with or without trailing slash).
+ * @param {string} content
+ * @param {string} entry e.g. ".cursor/" or ".agents/"
+ */
+function hasIgnoreEntry(content, entry) {
+  const name = entry.replace(/\/$/, '').replace(/^\./, '\\.');
+  return new RegExp(`(?:^|\\n)\\s*${name}\\/?\\s*(?:\\n|$)`).test(content);
+}
+
+/**
+ * Create .gitignore with required entries, or append any that are missing.
+ * @param {string} targetDir
+ * @param {{ dryRun?: boolean }} options
+ * @param {CopyReport} report
+ */
+function ensureGitignore(targetDir, options, report) {
+  const filePath = path.join(targetDir, GITIGNORE);
+  const exists = fs.existsSync(filePath);
+
+  if (!exists) {
+    if (options.dryRun) {
+      report.created.push(`${GITIGNORE} (${GITIGNORE_ENTRIES.join(', ')})`);
+      return;
+    }
+    fs.writeFileSync(filePath, `${GITIGNORE_ENTRIES.join('\n')}\n`, 'utf8');
+    report.created.push(GITIGNORE);
+    return;
+  }
+
+  const content = fs.readFileSync(filePath, 'utf8');
+  const missing = GITIGNORE_ENTRIES.filter(
+    (entry) => !hasIgnoreEntry(content, entry),
+  );
+
+  if (missing.length === 0) {
+    report.skipped.push(
+      `${GITIGNORE} (${GITIGNORE_ENTRIES.join(', ')} already listed)`,
+    );
+    return;
+  }
+
+  if (options.dryRun) {
+    report.updated.push(`${GITIGNORE} (append ${missing.join(', ')})`);
+    return;
+  }
+
+  const separator = content.length === 0 || content.endsWith('\n') ? '' : '\n';
+  fs.writeFileSync(
+    filePath,
+    `${content}${separator}${missing.join('\n')}\n`,
+    'utf8',
+  );
+  report.updated.push(`${GITIGNORE} (appended ${missing.join(', ')})`);
+}
+
+/**
+ * Copy all files from sourceRoot into targetDir.
+ * @param {string} sourceRoot
+ * @param {string} targetDir
+ * @param {{ force?: boolean, dryRun?: boolean }} options
+ * @param {CopyReport} report
+ */
+function copyTree(sourceRoot, targetDir, options, report) {
+  const relativeFiles = listFiles(sourceRoot);
+
+  for (const relative of relativeFiles) {
+    const from = path.join(sourceRoot, relative);
+    const to = path.join(targetDir, relative);
+    const exists = fs.existsSync(to);
+
+    if (exists && !options.force) {
+      report.skipped.push(relative);
+      continue;
+    }
+
+    if (options.dryRun) {
+      if (exists) {
+        report.overwritten.push(relative);
+      } else {
+        report.created.push(relative);
+      }
+      continue;
+    }
+
+    fs.mkdirSync(path.dirname(to), { recursive: true });
+    fs.copyFileSync(from, to);
+
+    if (exists) {
+      report.overwritten.push(relative);
+    } else {
+      report.created.push(relative);
+    }
+  }
+}
+
+/**
+ * Scaffold shared .cursor config + stack templates into targetDir.
+ * @param {{ stack: { id: string, agentsDir: string }, targetDir: string, force?: boolean, dryRun?: boolean }} opts
+ * @returns {CopyReport}
+ */
+export function initStack(opts) {
+  const { stack, targetDir, force = false, dryRun = false } = opts;
+  const options = { force, dryRun };
+  /** @type {CopyReport} */
+  const report = {
+    created: [],
+    skipped: [],
+    overwritten: [],
+    updated: [],
+  };
+
+  const shared = sharedTemplatesDir();
+  const stackDir = stackTemplatesDir(stack.agentsDir);
+
+  if (!fs.existsSync(shared)) {
+    throw new Error(`Shared templates missing: ${shared}`);
+  }
+  if (!fs.existsSync(stackDir)) {
+    throw new Error(`Stack templates missing for "${stack.id}": ${stackDir}`);
+  }
+
+  copyTree(shared, targetDir, options, report);
+  copyTree(stackDir, targetDir, options, report);
+  ensureGitignore(targetDir, options, report);
+  ensureExactPnpmEngines(targetDir, options, report);
+
+  return report;
+}
+
+export function printReport(report, { dryRun = false } = {}) {
+  const prefix = dryRun ? '[dry-run] ' : '';
+
+  const sections = [
+    ['Created', report.created],
+    ['Updated', report.updated],
+    ['Overwritten', report.overwritten],
+    ['Skipped (already exists)', report.skipped],
+  ];
+
+  for (const [label, files] of sections) {
+    if (!files || files.length === 0) continue;
+    console.log(`${prefix}${label}:`);
+    for (const file of files) {
+      console.log(`  ${file}`);
+    }
+  }
+
+  if (
+    report.created.length === 0 &&
+    report.overwritten.length === 0 &&
+    report.skipped.length === 0 &&
+    (report.updated?.length ?? 0) === 0
+  ) {
+    console.log(`${prefix}Nothing to do.`);
+  }
+}

package/src/package-manager.mjs

@@ -1,95 +1,95 @@
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { spawnSync } from 'node:child_process';
-
-/**
- * Resolve pnpm version without using the target project as cwd.
- * Running inside a project with `devEngines.packageManager.version: "^…"`
- * makes Corepack/pnpm refuse to start.
- * @returns {string | null} installed pnpm version (e.g. "11.13.0")
- */
-export function detectPnpmVersion() {
-  const result = spawnSync('pnpm --version', {
-    cwd: os.tmpdir(),
-    encoding: 'utf8',
-    shell: true,
-    env: process.env,
-  });
-
-  if (result.status !== 0) {
-    return null;
-  }
-
-  const version = (result.stdout ?? '').trim().split(/\s+/)[0];
-  return /^\d+\.\d+\.\d+/.test(version) ? version : null;
-}
-
-/**
- * True if version is not an exact x.y.z (e.g. ^11.13.0, >=11).
- * @param {string | undefined} version
- */
-function isRangeOrInvalid(version) {
-  if (!version || typeof version !== 'string') return true;
-  return !/^\d+\.\d+\.\d+(-[0-9A-Za-z.-]+)?$/.test(version.trim());
-}
-
-/**
- * Pin packageManager / devEngines to an exact pnpm version so Corepack/pnpm
- * do not fail on ranges like "^11.13.0" (from `pnpm init`).
- *
- * @param {string} targetDir
- * @param {{ dryRun?: boolean }} options
- * @param {{ created: string[], updated: string[], skipped: string[] }} report
- */
-export function ensureExactPnpmEngines(targetDir, options, report) {
-  const pkgPath = path.join(targetDir, 'package.json');
-
-  if (!fs.existsSync(pkgPath)) {
-    report.skipped.push('package.json (missing — skipped packageManager pin)');
-    return;
-  }
-
-  const version = detectPnpmVersion();
-  if (!version) {
-    report.skipped.push('package.json (pnpm not found — skipped packageManager pin)');
-    return;
-  }
-
-  const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-  const expectedPackageManager = `pnpm@${version}`;
-  const currentDevVersion = pkg.devEngines?.packageManager?.version;
-  const needsPackageManager = pkg.packageManager !== expectedPackageManager;
-  const needsDevEngines =
-    !pkg.devEngines?.packageManager ||
-    pkg.devEngines.packageManager.name !== 'pnpm' ||
-    isRangeOrInvalid(currentDevVersion) ||
-    currentDevVersion !== version;
-
-  if (!needsPackageManager && !needsDevEngines) {
-    report.skipped.push('package.json (packageManager already exact)');
-    return;
-  }
-
-  if (options.dryRun) {
-    report.updated.push(
-      `package.json (pin packageManager to ${expectedPackageManager})`,
-    );
-    return;
-  }
-
-  pkg.packageManager = expectedPackageManager;
-  pkg.devEngines = {
-    ...pkg.devEngines,
-    packageManager: {
-      name: 'pnpm',
-      version,
-      onFail: 'download',
-    },
-  };
-
-  fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf8');
-  report.updated.push(
-    `package.json (pinned packageManager to ${expectedPackageManager})`,
-  );
-}
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+
+/**
+ * Resolve pnpm version without using the target project as cwd.
+ * Running inside a project with `devEngines.packageManager.version: "^…"`
+ * makes Corepack/pnpm refuse to start.
+ * @returns {string | null} installed pnpm version (e.g. "11.13.0")
+ */
+export function detectPnpmVersion() {
+  const result = spawnSync('pnpm --version', {
+    cwd: os.tmpdir(),
+    encoding: 'utf8',
+    shell: true,
+    env: process.env,
+  });
+
+  if (result.status !== 0) {
+    return null;
+  }
+
+  const version = (result.stdout ?? '').trim().split(/\s+/)[0];
+  return /^\d+\.\d+\.\d+/.test(version) ? version : null;
+}
+
+/**
+ * True if version is not an exact x.y.z (e.g. ^11.13.0, >=11).
+ * @param {string | undefined} version
+ */
+function isRangeOrInvalid(version) {
+  if (!version || typeof version !== 'string') return true;
+  return !/^\d+\.\d+\.\d+(-[0-9A-Za-z.-]+)?$/.test(version.trim());
+}
+
+/**
+ * Pin packageManager / devEngines to an exact pnpm version so Corepack/pnpm
+ * do not fail on ranges like "^11.13.0" (from `pnpm init`).
+ *
+ * @param {string} targetDir
+ * @param {{ dryRun?: boolean }} options
+ * @param {{ created: string[], updated: string[], skipped: string[] }} report
+ */
+export function ensureExactPnpmEngines(targetDir, options, report) {
+  const pkgPath = path.join(targetDir, 'package.json');
+
+  if (!fs.existsSync(pkgPath)) {
+    report.skipped.push('package.json (missing — skipped packageManager pin)');
+    return;
+  }
+
+  const version = detectPnpmVersion();
+  if (!version) {
+    report.skipped.push('package.json (pnpm not found — skipped packageManager pin)');
+    return;
+  }
+
+  const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+  const expectedPackageManager = `pnpm@${version}`;
+  const currentDevVersion = pkg.devEngines?.packageManager?.version;
+  const needsPackageManager = pkg.packageManager !== expectedPackageManager;
+  const needsDevEngines =
+    !pkg.devEngines?.packageManager ||
+    pkg.devEngines.packageManager.name !== 'pnpm' ||
+    isRangeOrInvalid(currentDevVersion) ||
+    currentDevVersion !== version;
+
+  if (!needsPackageManager && !needsDevEngines) {
+    report.skipped.push('package.json (packageManager already exact)');
+    return;
+  }
+
+  if (options.dryRun) {
+    report.updated.push(
+      `package.json (pin packageManager to ${expectedPackageManager})`,
+    );
+    return;
+  }
+
+  pkg.packageManager = expectedPackageManager;
+  pkg.devEngines = {
+    ...pkg.devEngines,
+    packageManager: {
+      name: 'pnpm',
+      version,
+      onFail: 'download',
+    },
+  };
+
+  fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf8');
+  report.updated.push(
+    `package.json (pinned packageManager to ${expectedPackageManager})`,
+  );
+}

package/src/paths.mjs

@@ -1,20 +1,20 @@
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-export function packageRoot() {
-  return path.resolve(__dirname, '..');
-}
-
-export function templatesRoot() {
-  return path.join(packageRoot(), 'templates');
-}
-
-export function sharedTemplatesDir() {
-  return path.join(templatesRoot(), 'shared');
-}
-
-export function stackTemplatesDir(agentsDir) {
-  return path.join(templatesRoot(), agentsDir);
-}
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export function packageRoot() {
+  return path.resolve(__dirname, '..');
+}
+
+export function templatesRoot() {
+  return path.join(packageRoot(), 'templates');
+}
+
+export function sharedTemplatesDir() {
+  return path.join(templatesRoot(), 'shared');
+}
+
+export function stackTemplatesDir(agentsDir) {
+  return path.join(templatesRoot(), agentsDir);
+}