create-vasvibe 2.4.0 → 2.5.0

package/src/prompts.mjs

@@ -1,113 +1,113 @@
-// src/prompts.mjs
-// Interactive prompts. Skipped when --yes is passed.
-
-import prompts from 'prompts';
-import { isValidProjectName } from './utils.mjs';
-
-export async function runPrompts({ argName, flags }) {
-  if (flags.yes) {
-    return {
-      projectName: argName || 'my-vasvibe-project',
-      includeOpencode: flags.opencode !== false,
-      includeClaude: flags.claude !== false,
-      includeGithub: flags.github !== false,
-      includeWorkflows: flags.workflows !== false,
-      initGit: flags.git !== false,
-      workDepth: flags.depth || 'standard',
-    };
-  }
-
-  const onCancel = () => {
-    console.log('\nAborted.');
-    process.exit(1);
-  };
-
-  const answers = await prompts(
-    [
-      {
-        type: argName ? null : 'text',
-        name: 'projectName',
-        message: 'Project name:',
-        initial: 'my-vasvibe-project',
-        validate: (v) =>
-          isValidProjectName(v) ||
-          'Use letters, numbers, dot, underscore, or dash. Cannot start with a dot.',
-      },
-      {
-        type: flags.opencode === false ? null : 'toggle',
-        name: 'includeOpencode',
-        message: 'Include OpenCode commands & skills (.opencode/)?',
-        initial: true,
-        active: 'yes',
-        inactive: 'no',
-      },
-      {
-        type: flags.claude === false ? null : 'toggle',
-        name: 'includeClaude',
-        message: 'Include Claude agents & skills (.claude/, .agents/)?',
-        initial: true,
-        active: 'yes',
-        inactive: 'no',
-      },
-      {
-        type: flags.github === false ? null : 'toggle',
-        name: 'includeGithub',
-        message: 'Include GitHub Copilot prompts (.github/prompts/)?',
-        initial: true,
-        active: 'yes',
-        inactive: 'no',
-      },
-      {
-        type: flags.workflows === false ? null : 'toggle',
-        name: 'includeWorkflows',
-        message: 'Include generic agent workflows (agent/workflows/)?',
-        initial: true,
-        active: 'yes',
-        inactive: 'no',
-      },
-      {
-        type: flags.git === false ? null : 'toggle',
-        name: 'initGit',
-        message: 'Initialize a git repository?',
-        initial: true,
-        active: 'yes',
-        inactive: 'no',
-      },
-      {
-        type: flags.depth ? null : 'select',
-        name: 'workDepth',
-        message: 'Default work depth for all agents?',
-        hint: 'Can be changed anytime in project_overview.md → ## 7. Project Settings',
-        choices: [
-          {
-            title: 'standard (recommended)',
-            description: 'Full spec, unit tests, code review — the default for everyday production development.',
-            value: 'standard',
-          },
-          {
-            title: 'fast',
-            description: 'Core feature only, skip optional steps (unit tests, full docs, edge cases) — good for prototypes and MVPs.',
-            value: 'fast',
-          },
-          {
-            title: 'deep',
-            description: 'Maximum thoroughness — full security review, all edge cases, strict validation — for critical systems.',
-            value: 'deep',
-          },
-        ],
-        initial: 0,
-      },
-    ],
-    { onCancel },
-  );
-
-  return {
-    projectName: argName || answers.projectName,
-    includeOpencode: flags.opencode === false ? false : answers.includeOpencode ?? true,
-    includeClaude: flags.claude === false ? false : answers.includeClaude ?? true,
-    includeGithub: flags.github === false ? false : answers.includeGithub ?? true,
-    includeWorkflows: flags.workflows === false ? false : answers.includeWorkflows ?? true,
-    initGit: flags.git === false ? false : answers.initGit ?? true,
-    workDepth: flags.depth || answers.workDepth || 'standard',
-  };
-}
+// src/prompts.mjs
+// Interactive prompts. Skipped when --yes is passed.
+
+import prompts from 'prompts';
+import { isValidProjectName } from './utils.mjs';
+
+export async function runPrompts({ argName, flags }) {
+  if (flags.yes) {
+    return {
+      projectName: argName || 'my-vasvibe-project',
+      includeOpencode: flags.opencode !== false,
+      includeClaude: flags.claude !== false,
+      includeGithub: flags.github !== false,
+      includeWorkflows: flags.workflows !== false,
+      initGit: flags.git !== false,
+      workDepth: flags.depth || 'standard',
+    };
+  }
+
+  const onCancel = () => {
+    console.log('\nAborted.');
+    process.exit(1);
+  };
+
+  const answers = await prompts(
+    [
+      {
+        type: argName ? null : 'text',
+        name: 'projectName',
+        message: 'Project name:',
+        initial: 'my-vasvibe-project',
+        validate: (v) =>
+          isValidProjectName(v) ||
+          'Use letters, numbers, dot, underscore, or dash. Cannot start with a dot.',
+      },
+      {
+        type: flags.opencode === false ? null : 'toggle',
+        name: 'includeOpencode',
+        message: 'Include OpenCode commands & skills (.opencode/)?',
+        initial: true,
+        active: 'yes',
+        inactive: 'no',
+      },
+      {
+        type: flags.claude === false ? null : 'toggle',
+        name: 'includeClaude',
+        message: 'Include Claude agents & skills (.claude/, .agents/)?',
+        initial: true,
+        active: 'yes',
+        inactive: 'no',
+      },
+      {
+        type: flags.github === false ? null : 'toggle',
+        name: 'includeGithub',
+        message: 'Include GitHub Copilot prompts (.github/prompts/)?',
+        initial: true,
+        active: 'yes',
+        inactive: 'no',
+      },
+      {
+        type: flags.workflows === false ? null : 'toggle',
+        name: 'includeWorkflows',
+        message: 'Include generic agent workflows (agent/workflows/)?',
+        initial: true,
+        active: 'yes',
+        inactive: 'no',
+      },
+      {
+        type: flags.git === false ? null : 'toggle',
+        name: 'initGit',
+        message: 'Initialize a git repository?',
+        initial: true,
+        active: 'yes',
+        inactive: 'no',
+      },
+      {
+        type: flags.depth ? null : 'select',
+        name: 'workDepth',
+        message: 'Default work depth for all agents?',
+        hint: 'Can be changed anytime in project_overview.md → ## 7. Project Settings',
+        choices: [
+          {
+            title: 'standard (recommended)',
+            description: 'Full spec, unit tests, code review — the default for everyday production development.',
+            value: 'standard',
+          },
+          {
+            title: 'fast',
+            description: 'Core feature only, skip optional steps (unit tests, full docs, edge cases) — good for prototypes and MVPs.',
+            value: 'fast',
+          },
+          {
+            title: 'deep',
+            description: 'Maximum thoroughness — full security review, all edge cases, strict validation — for critical systems.',
+            value: 'deep',
+          },
+        ],
+        initial: 0,
+      },
+    ],
+    { onCancel },
+  );
+
+  return {
+    projectName: argName || answers.projectName,
+    includeOpencode: flags.opencode === false ? false : answers.includeOpencode ?? true,
+    includeClaude: flags.claude === false ? false : answers.includeClaude ?? true,
+    includeGithub: flags.github === false ? false : answers.includeGithub ?? true,
+    includeWorkflows: flags.workflows === false ? false : answers.includeWorkflows ?? true,
+    initGit: flags.git === false ? false : answers.initGit ?? true,
+    workDepth: flags.depth || answers.workDepth || 'standard',
+  };
+}

package/src/scaffold.mjs

@@ -1,74 +1,74 @@
-// src/scaffold.mjs
-// Copy the bundled template into the target directory, applying selective
-// includes and small file transforms (rename, placeholder replacement).
-
-import { promises as fs } from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { copyDir, removePath, replaceInFile, pathExists } from './utils.mjs';
-import { writeVersionFile } from './upgrade.mjs';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-// packages/create-vasvibe/src → packages/create-vasvibe/template
-const TEMPLATE_DIR = path.resolve(__dirname, '..', 'template');
-
-const TOOLCHAIN_PATHS = {
-  opencode: ['.opencode'],
-  claude: ['.claude', '.agents'],
-  github: ['.github'],
-  workflows: ['agent'],
-};
-
-export async function scaffold({
-  targetDir,
-  projectName,
-  version,
-  workDepth = 'standard',
-  includeOpencode,
-  includeClaude,
-  includeGithub,
-  includeWorkflows,
-}) {
-  if (!(await pathExists(TEMPLATE_DIR))) {
-    throw new Error(
-      `Template directory not found at ${TEMPLATE_DIR}. ` +
-        `If you are running from source, run "npm run sync-template" first.`,
-    );
-  }
-
-  await fs.mkdir(targetDir, { recursive: true });
-
-  // 1. Copy entire template tree.
-  await copyDir(TEMPLATE_DIR, targetDir);
-
-  // 2. Apply toolchain filters (delete excluded folders).
-  if (!includeOpencode) await removeAll(targetDir, TOOLCHAIN_PATHS.opencode);
-  if (!includeClaude) await removeAll(targetDir, TOOLCHAIN_PATHS.claude);
-  if (!includeGithub) await removeAll(targetDir, TOOLCHAIN_PATHS.github);
-  if (!includeWorkflows) await removeAll(targetDir, TOOLCHAIN_PATHS.workflows);
-
-  // 3. Rename _gitignore -> .gitignore (npm strips real .gitignore from packages).
-  const gi = path.join(targetDir, '_gitignore');
-  if (await pathExists(gi)) {
-    await fs.rename(gi, path.join(targetDir, '.gitignore'));
-  }
-
-  // 4. Replace placeholders in well-known files.
-  const year = String(new Date().getFullYear());
-  const replacements = { projectName, year, workDepth };
-  for (const rel of ['README.md', 'PROJECT_README.example.md', '.gitignore', 'AGENT_PERSONAS.md', 'GIT_STRUCTURE_GUIDE.md', 'project_overview_example.md']) {
-    const f = path.join(targetDir, rel);
-    if (await pathExists(f)) await replaceInFile(f, replacements);
-  }
-
-  // 5. Write version tracking file.
-  if (version) {
-    await writeVersionFile(targetDir, version);
-  }
-}
-
-async function removeAll(targetDir, relPaths) {
-  for (const rel of relPaths) {
-    await removePath(path.join(targetDir, rel));
-  }
-}
+// src/scaffold.mjs
+// Copy the bundled template into the target directory, applying selective
+// includes and small file transforms (rename, placeholder replacement).
+
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { copyDir, removePath, replaceInFile, pathExists } from './utils.mjs';
+import { writeVersionFile } from './upgrade.mjs';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+// packages/create-vasvibe/src → packages/create-vasvibe/template
+const TEMPLATE_DIR = path.resolve(__dirname, '..', 'template');
+
+const TOOLCHAIN_PATHS = {
+  opencode: ['.opencode'],
+  claude: ['.claude', '.agents'],
+  github: ['.github'],
+  workflows: ['agent'],
+};
+
+export async function scaffold({
+  targetDir,
+  projectName,
+  version,
+  workDepth = 'standard',
+  includeOpencode,
+  includeClaude,
+  includeGithub,
+  includeWorkflows,
+}) {
+  if (!(await pathExists(TEMPLATE_DIR))) {
+    throw new Error(
+      `Template directory not found at ${TEMPLATE_DIR}. ` +
+        `If you are running from source, run "npm run sync-template" first.`,
+    );
+  }
+
+  await fs.mkdir(targetDir, { recursive: true });
+
+  // 1. Copy entire template tree.
+  await copyDir(TEMPLATE_DIR, targetDir);
+
+  // 2. Apply toolchain filters (delete excluded folders).
+  if (!includeOpencode) await removeAll(targetDir, TOOLCHAIN_PATHS.opencode);
+  if (!includeClaude) await removeAll(targetDir, TOOLCHAIN_PATHS.claude);
+  if (!includeGithub) await removeAll(targetDir, TOOLCHAIN_PATHS.github);
+  if (!includeWorkflows) await removeAll(targetDir, TOOLCHAIN_PATHS.workflows);
+
+  // 3. Rename _gitignore -> .gitignore (npm strips real .gitignore from packages).
+  const gi = path.join(targetDir, '_gitignore');
+  if (await pathExists(gi)) {
+    await fs.rename(gi, path.join(targetDir, '.gitignore'));
+  }
+
+  // 4. Replace placeholders in well-known files.
+  const year = String(new Date().getFullYear());
+  const replacements = { projectName, year, workDepth };
+  for (const rel of ['README.md', 'PROJECT_README.example.md', '.gitignore', 'AGENT_PERSONAS.md', 'GIT_STRUCTURE_GUIDE.md', 'project_overview_example.md']) {
+    const f = path.join(targetDir, rel);
+    if (await pathExists(f)) await replaceInFile(f, replacements);
+  }
+
+  // 5. Write version tracking file.
+  if (version) {
+    await writeVersionFile(targetDir, version);
+  }
+}
+
+async function removeAll(targetDir, relPaths) {
+  for (const rel of relPaths) {
+    await removePath(path.join(targetDir, rel));
+  }
+}

package/src/upgrade.mjs

@@ -1,121 +1,121 @@
-// src/upgrade.mjs
-// Upgrade an existing vasvibe project: re-copy framework files (agents, schemas,
-// workflows) without touching user-generated content (codes/, specifications/,
-// task/, state/, project_overview.md, etc.).
-
-import { promises as fs } from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { copyDir, pathExists, log } from './utils.mjs';
-import pc from 'picocolors';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const TEMPLATE_DIR = path.resolve(__dirname, '..', 'template');
-const VERSION_FILE = '.vasvibe-version';
-
-// Only these paths are safe to overwrite on upgrade.
-// User content (codes/, specifications/, task/, state/, project_overview.md) is never touched.
-const FRAMEWORK_PATHS = [
-  { src: '.opencode', dest: '.opencode' },
-  { src: '.claude', dest: '.claude' },
-  { src: '.agents', dest: '.agents' },
-  { src: '.github/prompts', dest: '.github/prompts' },
-  { src: 'agent', dest: 'agent' },
-  { src: 'schemas', dest: 'schemas' },
-];
-
-export async function readVersionFile(projectDir) {
-  const versionPath = path.join(projectDir, VERSION_FILE);
-  try {
-    const content = await fs.readFile(versionPath, 'utf8');
-    return content.trim();
-  } catch {
-    return null;
-  }
-}
-
-export async function writeVersionFile(projectDir, version) {
-  await fs.writeFile(path.join(projectDir, VERSION_FILE), version + '\n', 'utf8');
-}
-
-export async function isVasvibeProject(projectDir) {
-  // A vasvibe project has either .vasvibe-version or at least one agent directory.
-  if (await pathExists(path.join(projectDir, VERSION_FILE))) return true;
-  if (await pathExists(path.join(projectDir, 'agent/workflows'))) return true;
-  if (await pathExists(path.join(projectDir, '.opencode/agents'))) return true;
-  return false;
-}
-
-export async function upgrade({ targetDir, currentVersion, newVersion, dryRun = false }) {
-  if (!(await pathExists(TEMPLATE_DIR))) {
-    throw new Error(`Template directory not found at ${TEMPLATE_DIR}.`);
-  }
-
-  const updated = [];
-  const skipped = [];
-
-  for (const { src, dest } of FRAMEWORK_PATHS) {
-    const srcPath = path.join(TEMPLATE_DIR, src);
-    const destPath = path.join(targetDir, dest);
-
-    if (!(await pathExists(srcPath))) {
-      skipped.push(src);
-      continue;
-    }
-    // Only update if the destination already exists in the project
-    // (respect the user's original toolchain choices).
-    if (!(await pathExists(destPath))) {
-      skipped.push(dest + ' (not in project)');
-      continue;
-    }
-
-    if (!dryRun) {
-      await copyDir(srcPath, destPath);
-    }
-    updated.push(dest);
-  }
-
-  if (!dryRun) {
-    await writeVersionFile(targetDir, newVersion);
-  }
-
-  return { updated, skipped };
-}
-
-export async function runUpgrade({ targetDir, newVersion, dryRun }) {
-  const currentVersion = await readVersionFile(targetDir);
-
-  log.blank();
-  if (currentVersion) {
-    log.info(`Current version: ${pc.yellow(currentVersion)}`);
-  } else {
-    log.warn('No .vasvibe-version file found — project may have been created before version tracking was added.');
-  }
-  log.info(`Upgrading to:    ${pc.green(newVersion)}`);
-  log.blank();
-
-  if (dryRun) {
-    log.step('Dry run — no files will be changed.');
-    log.blank();
-  }
-
-  const { updated, skipped } = await upgrade({ targetDir, currentVersion, newVersion, dryRun });
-
-  for (const p of updated) {
-    log.success(`Updated: ${pc.cyan(p)}`);
-  }
-  for (const p of skipped) {
-    log.step(`Skipped: ${pc.dim(p)}`);
-  }
-
-  log.blank();
-  if (dryRun) {
-    log.info('Run without --dry-run to apply the upgrade.');
-  } else {
-    log.success(`Upgraded to ${pc.green(newVersion)}`);
-    log.blank();
-    log.step('Review the changes with ' + pc.cyan('git diff') + ' before committing.');
-    log.step('Your codes/, specifications/, task/, and state/ directories were not touched.');
-  }
-  log.blank();
-}
+// src/upgrade.mjs
+// Upgrade an existing vasvibe project: re-copy framework files (agents, schemas,
+// workflows) without touching user-generated content (codes/, specifications/,
+// task/, state/, project_overview.md, etc.).
+
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { copyDir, pathExists, log } from './utils.mjs';
+import pc from 'picocolors';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const TEMPLATE_DIR = path.resolve(__dirname, '..', 'template');
+const VERSION_FILE = '.vasvibe-version';
+
+// Only these paths are safe to overwrite on upgrade.
+// User content (codes/, specifications/, task/, state/, project_overview.md) is never touched.
+const FRAMEWORK_PATHS = [
+  { src: '.opencode', dest: '.opencode' },
+  { src: '.claude', dest: '.claude' },
+  { src: '.agents', dest: '.agents' },
+  { src: '.github/prompts', dest: '.github/prompts' },
+  { src: 'agent', dest: 'agent' },
+  { src: 'schemas', dest: 'schemas' },
+];
+
+export async function readVersionFile(projectDir) {
+  const versionPath = path.join(projectDir, VERSION_FILE);
+  try {
+    const content = await fs.readFile(versionPath, 'utf8');
+    return content.trim();
+  } catch {
+    return null;
+  }
+}
+
+export async function writeVersionFile(projectDir, version) {
+  await fs.writeFile(path.join(projectDir, VERSION_FILE), version + '\n', 'utf8');
+}
+
+export async function isVasvibeProject(projectDir) {
+  // A vasvibe project has either .vasvibe-version or at least one agent directory.
+  if (await pathExists(path.join(projectDir, VERSION_FILE))) return true;
+  if (await pathExists(path.join(projectDir, 'agent/workflows'))) return true;
+  if (await pathExists(path.join(projectDir, '.opencode/agents'))) return true;
+  return false;
+}
+
+export async function upgrade({ targetDir, currentVersion, newVersion, dryRun = false }) {
+  if (!(await pathExists(TEMPLATE_DIR))) {
+    throw new Error(`Template directory not found at ${TEMPLATE_DIR}.`);
+  }
+
+  const updated = [];
+  const skipped = [];
+
+  for (const { src, dest } of FRAMEWORK_PATHS) {
+    const srcPath = path.join(TEMPLATE_DIR, src);
+    const destPath = path.join(targetDir, dest);
+
+    if (!(await pathExists(srcPath))) {
+      skipped.push(src);
+      continue;
+    }
+    // Only update if the destination already exists in the project
+    // (respect the user's original toolchain choices).
+    if (!(await pathExists(destPath))) {
+      skipped.push(dest + ' (not in project)');
+      continue;
+    }
+
+    if (!dryRun) {
+      await copyDir(srcPath, destPath);
+    }
+    updated.push(dest);
+  }
+
+  if (!dryRun) {
+    await writeVersionFile(targetDir, newVersion);
+  }
+
+  return { updated, skipped };
+}
+
+export async function runUpgrade({ targetDir, newVersion, dryRun }) {
+  const currentVersion = await readVersionFile(targetDir);
+
+  log.blank();
+  if (currentVersion) {
+    log.info(`Current version: ${pc.yellow(currentVersion)}`);
+  } else {
+    log.warn('No .vasvibe-version file found — project may have been created before version tracking was added.');
+  }
+  log.info(`Upgrading to:    ${pc.green(newVersion)}`);
+  log.blank();
+
+  if (dryRun) {
+    log.step('Dry run — no files will be changed.');
+    log.blank();
+  }
+
+  const { updated, skipped } = await upgrade({ targetDir, currentVersion, newVersion, dryRun });
+
+  for (const p of updated) {
+    log.success(`Updated: ${pc.cyan(p)}`);
+  }
+  for (const p of skipped) {
+    log.step(`Skipped: ${pc.dim(p)}`);
+  }
+
+  log.blank();
+  if (dryRun) {
+    log.info('Run without --dry-run to apply the upgrade.');
+  } else {
+    log.success(`Upgraded to ${pc.green(newVersion)}`);
+    log.blank();
+    log.step('Review the changes with ' + pc.cyan('git diff') + ' before committing.');
+    log.step('Your codes/, specifications/, task/, and state/ directories were not touched.');
+  }
+  log.blank();
+}