@dafish/gogo-meta 1.2.0 → 1.4.0

package/dist/cli.js

@@ -3,7 +3,8 @@ import { Command } from 'commander';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join, basename } from 'path';
-import { mkdir, appendFile, access, writeFile, readFile, unlink, symlink } from 'fs/promises';
+import { unlink, mkdir, appendFile, access, writeFile, readFile, symlink } from 'fs/promises';
+import { stringify, parse } from 'yaml';
 import { z } from 'zod';
 import pc from 'picocolors';
 import { homedir } from 'os';
@@ -208,6 +209,7 @@ var LoopRcSchema = z.object({
 // src/core/config.ts
 var META_FILE = ".gogo";
 var LOOPRC_FILE = ".looprc";
+var META_FILE_CANDIDATES = [".gogo", ".gogo.yaml", ".gogo.yml"];
 var ConfigError = class extends Error {
   constructor(message, path) {
     super(message);
@@ -215,6 +217,21 @@ var ConfigError = class extends Error {
     this.name = "ConfigError";
   }
 };
+function detectFormat(filePath) {
+  if (filePath.endsWith(".yaml") || filePath.endsWith(".yml")) {
+    return "yaml";
+  }
+  return "json";
+}
+function filenameForFormat(format) {
+  return format === "yaml" ? ".gogo.yaml" : ".gogo";
+}
+function parseContent(content, format) {
+  return format === "yaml" ? parse(content) : JSON.parse(content);
+}
+function serializeContent(data, format) {
+  return format === "yaml" ? stringify(data, { indent: 2 }) : JSON.stringify(data, null, 2) + "\n";
+}
 async function fileExists(path) {
   try {
     await access(path);
@@ -237,31 +254,53 @@ async function findFileUp(filename, startDir) {
     currentDir = parentDir;
   }
 }
+async function findMetaFileUp(startDir) {
+  let currentDir = startDir;
+  while (true) {
+    for (const candidate of META_FILE_CANDIDATES) {
+      const filePath = join(currentDir, candidate);
+      if (await fileExists(filePath)) {
+        return filePath;
+      }
+    }
+    const parentDir = dirname(currentDir);
+    if (parentDir === currentDir) {
+      return null;
+    }
+    currentDir = parentDir;
+  }
+}
 async function readMetaConfig(cwd) {
-  const metaPath = await findFileUp(META_FILE, cwd);
+  const metaPath = await findMetaFileUp(cwd);
   if (!metaPath) {
     throw new ConfigError(
       `No ${META_FILE} file found. Run 'gogo init' to create one, or navigate to a directory with a ${META_FILE} file.`
     );
   }
+  const format = detectFormat(metaPath);
   try {
     const content = await readFile(metaPath, "utf-8");
-    const parsed = JSON.parse(content);
-    return MetaConfigSchema.parse(parsed);
+    const parsed = parseContent(content, format);
+    const config = MetaConfigSchema.parse(parsed);
+    return { config, format, metaDir: dirname(metaPath) };
   } catch (error2) {
     if (error2 instanceof SyntaxError) {
-      throw new ConfigError(`Invalid JSON in ${META_FILE} file`, metaPath);
+      throw new ConfigError(`Invalid JSON in config file`, metaPath);
+    }
+    if (error2 instanceof Error && error2.name === "YAMLParseError") {
+      throw new ConfigError(`Invalid YAML in config file`, metaPath);
     }
     if (error2 instanceof Error && error2.name === "ZodError") {
-      throw new ConfigError(`Invalid ${META_FILE} file structure: ${error2.message}`, metaPath);
+      throw new ConfigError(`Invalid config file structure: ${error2.message}`, metaPath);
     }
     throw error2;
   }
 }
-async function writeMetaConfig(cwd, config) {
-  const metaPath = join(cwd, META_FILE);
+async function writeMetaConfig(cwd, config, format = "json") {
+  const filename = filenameForFormat(format);
+  const metaPath = join(cwd, filename);
   const validated = MetaConfigSchema.parse(config);
-  const content = JSON.stringify(validated, null, 2) + "\n";
+  const content = serializeContent(validated, format);
   await writeFile(metaPath, content, "utf-8");
 }
 async function readLoopRc(cwd) {
@@ -278,7 +317,7 @@ async function readLoopRc(cwd) {
   }
 }
 function getMetaDir(cwd) {
-  return findFileUp(META_FILE, cwd).then((path) => path ? dirname(path) : null);
+  return findMetaFileUp(cwd).then((path) => path ? dirname(path) : null);
 }
 function createDefaultConfig() {
   return {
@@ -398,22 +437,36 @@ function summary(results) {
 // src/commands/init.ts
 async function initCommand(options = {}) {
   const cwd = process.cwd();
-  const metaPath = join(cwd, META_FILE);
-  if (await fileExists(metaPath)) {
+  const format = options.format === "yaml" ? "yaml" : "json";
+  const existingFiles = [];
+  for (const candidate of META_FILE_CANDIDATES) {
+    const candidatePath = join(cwd, candidate);
+    if (await fileExists(candidatePath)) {
+      existingFiles.push(candidate);
+    }
+  }
+  if (existingFiles.length > 0) {
     if (!options.force) {
       throw new Error(
-        `${META_FILE} file already exists. Use --force to overwrite.`
+        `${existingFiles[0]} file already exists. Use --force to overwrite.`
       );
     }
-    warning(`Overwriting existing ${META_FILE} file`);
+    for (const candidate of existingFiles) {
+      await unlink(join(cwd, candidate));
+    }
+    warning(`Overwriting existing config file`);
   }
   const config = createDefaultConfig();
-  await writeMetaConfig(cwd, config);
-  success(`Created ${META_FILE} file in ${cwd}`);
+  await writeMetaConfig(cwd, config, format);
+  const filename = filenameForFormat(format);
+  success(`Created ${filename} file in ${cwd}`);
   info("Add projects with: gogo project import <folder> <repo-url>");
 }
 function registerInitCommand(program) {
-  program.command("init").description("Initialize a new gogo-meta repository").option("-f, --force", "Overwrite existing .gogo file").action(async (options) => {
+  program.command("init").description("Initialize a new gogo-meta repository").option("-f, --force", "Overwrite existing config file").option("--format <format>", "Config file format (json or yaml)", "json").action(async (options) => {
+    if (options.format && !["json", "yaml"].includes(options.format)) {
+      throw new Error(`Invalid format "${options.format}". Use "json" or "yaml".`);
+    }
     await initCommand(options);
   });
 }
@@ -571,7 +624,7 @@ async function execCommand(command, options = {}) {
   if (!metaDir) {
     throw new Error('Not in a gogo-meta repository. Run "gogo init" first.');
   }
-  const config = await readMetaConfig(cwd);
+  const { config } = await readMetaConfig(cwd);
   const filterOptions = createFilterOptions(options);
   info(`Executing: ${bold(command)}`);
   const results = await loop(command, { config, metaDir }, {
@@ -613,7 +666,7 @@ async function runCommand(name, options = {}) {
   if (!metaDir) {
     throw new Error('Not in a gogo-meta repository. Run "gogo init" first.');
   }
-  const config = await readMetaConfig(cwd);
+  const { config } = await readMetaConfig(cwd);
   if (options.list || name === void 0) {
     formatCommandList(listCommands(config));
     return;
@@ -749,12 +802,12 @@ async function cloneCommand(url, options = {}) {
     return;
   }
   success(`Cloned meta repository to ${repoName}`);
-  const metaPath = join(targetDir, ".gogo");
-  if (!await fileExists(metaPath)) {
-    warning("No .gogo file found in cloned repository");
+  const metaPath = await findMetaFileUp(targetDir);
+  if (!metaPath) {
+    warning("No config file found in cloned repository");
     return;
   }
-  const config = await readMetaConfig(targetDir);
+  const { config } = await readMetaConfig(targetDir);
   const projects = Object.entries(config.projects);
   if (projects.length === 0) {
     info("No child repositories defined in .gogo");
@@ -804,7 +857,7 @@ async function updateCommand(options = {}) {
   if (!metaDir) {
     throw new Error('Not in a gogo-meta repository. Run "gogo init" first.');
   }
-  const config = await readMetaConfig(cwd);
+  const { config } = await readMetaConfig(cwd);
   const filterOptions = createFilterOptions(options);
   let projectEntries = Object.entries(config.projects);
   const projectPaths = projectEntries.map(([path]) => path);
@@ -884,7 +937,7 @@ async function statusCommand(options = {}) {
   if (!metaDir) {
     throw new Error('Not in a gogo-meta repository. Run "gogo init" first.');
   }
-  const config = await readMetaConfig(cwd);
+  const { config } = await readMetaConfig(cwd);
   const filterOptions = createFilterOptions(options);
   info("Checking git status across repositories...");
   const results = await loop("git status --short --branch", { config, metaDir }, {
@@ -904,7 +957,7 @@ async function pullCommand(options = {}) {
   if (!metaDir) {
     throw new Error('Not in a gogo-meta repository. Run "gogo init" first.');
   }
-  const config = await readMetaConfig(cwd);
+  const { config } = await readMetaConfig(cwd);
   const filterOptions = createFilterOptions(options);
   info("Pulling changes across repositories...");
   const results = await loop("git pull", { config, metaDir }, {
@@ -925,7 +978,7 @@ async function pushCommand(options = {}) {
   if (!metaDir) {
     throw new Error('Not in a gogo-meta repository. Run "gogo init" first.');
   }
-  const config = await readMetaConfig(cwd);
+  const { config } = await readMetaConfig(cwd);
   const filterOptions = createFilterOptions(options);
   info("Pushing changes across repositories...");
   const results = await loop("git push", { config, metaDir }, {
@@ -945,7 +998,7 @@ async function branchCommand(name, options = {}) {
   if (!metaDir) {
     throw new Error('Not in a gogo-meta repository. Run "gogo init" first.');
   }
-  const config = await readMetaConfig(cwd);
+  const { config } = await readMetaConfig(cwd);
   const filterOptions = createFilterOptions(options);
   let command;
   let actionMessage;
@@ -979,7 +1032,7 @@ async function checkoutCommand(branch, options = {}) {
   if (!metaDir) {
     throw new Error('Not in a gogo-meta repository. Run "gogo init" first.');
   }
-  const config = await readMetaConfig(cwd);
+  const { config } = await readMetaConfig(cwd);
   const filterOptions = createFilterOptions(options);
   const flag = options.create ? "-b " : "";
   const command = `git checkout ${flag}"${branch}"`;
@@ -1002,7 +1055,7 @@ async function commitCommand(options) {
   if (!metaDir) {
     throw new Error('Not in a gogo-meta repository. Run "gogo init" first.');
   }
-  const config = await readMetaConfig(cwd);
+  const { config } = await readMetaConfig(cwd);
   const filterOptions = createFilterOptions(options);
   const escapedMessage = options.message.replace(/"/g, '\\"');
   const command = `git commit -m "${escapedMessage}"`;
@@ -1068,9 +1121,9 @@ async function createCommand(folder, url) {
   if (remoteResult.exitCode !== 0) {
     throw new Error(`Failed to add remote: ${remoteResult.stderr}`);
   }
-  const config = await readMetaConfig(metaDir);
+  const { config, format } = await readMetaConfig(metaDir);
   const updatedConfig = addProject(config, folder, url);
-  await writeMetaConfig(metaDir, updatedConfig);
+  await writeMetaConfig(metaDir, updatedConfig, format);
   const gitignorePath = join(metaDir, ".gitignore");
   if (await fileExists(gitignorePath)) {
     await appendFile(gitignorePath, `
@@ -1112,9 +1165,9 @@ async function importCommand(folder, url, options = {}) {
       info(`Existing: ${existingUrl}`);
       info(`Provided: ${url}`);
     }
-    const config = await readMetaConfig(metaDir);
+    const { config, format } = await readMetaConfig(metaDir);
     const updatedConfig = addProject(config, folder, finalUrl);
-    await writeMetaConfig(metaDir, updatedConfig);
+    await writeMetaConfig(metaDir, updatedConfig, format);
     success(`Imported existing project "${folder}"`);
     info(`Repository URL: ${finalUrl}`);
   } else {
@@ -1122,9 +1175,9 @@ async function importCommand(folder, url, options = {}) {
       throw new Error("URL is required when importing a non-existent project");
     }
     if (options.noClone) {
-      const config2 = await readMetaConfig(metaDir);
+      const { config: config2, format: format2 } = await readMetaConfig(metaDir);
       const updatedConfig2 = addProject(config2, folder, url);
-      await writeMetaConfig(metaDir, updatedConfig2);
+      await writeMetaConfig(metaDir, updatedConfig2, format2);
       const added2 = await addToGitignore(metaDir, folder);
       success(`Registered project "${folder}" (not cloned)`);
       if (added2) {
@@ -1142,9 +1195,9 @@ async function importCommand(folder, url, options = {}) {
     if (cloneResult.exitCode !== 0) {
       throw new Error(`Failed to clone repository: ${cloneResult.stderr}`);
     }
-    const config = await readMetaConfig(metaDir);
+    const { config, format } = await readMetaConfig(metaDir);
     const updatedConfig = addProject(config, folder, url);
-    await writeMetaConfig(metaDir, updatedConfig);
+    await writeMetaConfig(metaDir, updatedConfig, format);
     success(`Imported project "${folder}"`);
   }
   const added = await addToGitignore(metaDir, folder);
@@ -1171,7 +1224,7 @@ async function installCommand(variant, options = {}) {
   if (!metaDir) {
     throw new Error('Not in a gogo-meta repository. Run "gogo init" first.');
   }
-  const config = await readMetaConfig(cwd);
+  const { config } = await readMetaConfig(cwd);
   const filterOptions = createFilterOptions(options);
   const command = `npm ${variant}`;
   info(`Running "${command}" across repositories...`);
@@ -1217,7 +1270,7 @@ async function linkCommand(options = {}) {
   if (!metaDir) {
     throw new Error('Not in a gogo-meta repository. Run "gogo init" first.');
   }
-  const config = await readMetaConfig(cwd);
+  const { config } = await readMetaConfig(cwd);
   const filterOptions = createFilterOptions(options);
   let projectPaths = Object.keys(config.projects);
   projectPaths = applyFilters(projectPaths, filterOptions);
@@ -1295,7 +1348,7 @@ async function runCommand2(script, options = {}) {
   if (!metaDir) {
     throw new Error('Not in a gogo-meta repository. Run "gogo init" first.');
   }
-  const config = await readMetaConfig(cwd);
+  const { config } = await readMetaConfig(cwd);
   const filterOptions = createFilterOptions(options);
   info(`Running "npm run ${script}" across repositories...`);
   const command = options.ifPresent ? async (dir, _projectPath) => {