@xylabs/ts-scripts-yarn3 7.4.18 → 7.4.19

package/dist/xy/{xyCommonCommands.mjs → common/index.mjs}

@@ -17,7 +17,7 @@ import { createRequire } from "module";
 import PATH from "path";
 var require2 = createRequire(import.meta.url);
 var packageRoot = PATH.dirname(require2.resolve("@xylabs/ts-scripts-yarn3/package.json"));
-var templatesDir = PATH.resolve(packageRoot, "templates");
+var templatesDir = PATH.resolve(packageRoot, "templates", "claude");
 var XYLABS_RULES_PREFIX = "xylabs-";
 var XYLABS_COMMANDS_PREFIX = "xylabs-";
 var claudeMdRuleTemplates = () => {
@@ -194,10 +194,19 @@ var generateIgnoreFiles = (filename3, pkg) => {
 
 // src/lib/generateReadmeFiles.ts
 import { execSync } from "child_process";
-import FS from "fs";
-import { readFile, writeFile } from "fs/promises";
+import FS, { readFileSync as readFileSync3 } from "fs";
+import {
+  mkdir,
+  readFile,
+  writeFile
+} from "fs/promises";
+import { createRequire as createRequire2 } from "module";
 import PATH2 from "path";
+import { createInterface } from "readline";
 import chalk4 from "chalk";
+var require3 = createRequire2(import.meta.url);
+var packageRoot2 = PATH2.dirname(require3.resolve("@xylabs/ts-scripts-yarn3/package.json"));
+var readmeTemplatesDir = PATH2.resolve(packageRoot2, "templates", "readme");
 function fillTemplate(template, data) {
   const additionalData = { ...data, safeName: data.name.replaceAll("/", "__").replaceAll("@", "") };
   return template.replaceAll(/\{\{(.*?)\}\}/g, (_, key) => additionalData[key.trim()] ?? "");
@@ -287,60 +296,164 @@ ${indent}### ${item.name}
   }
   return content;
 }
+function askConfirmation(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+    });
+  });
+}
+var DEFAULT_README_TEMPLATE = readFileSync3(PATH2.resolve(readmeTemplatesDir, "README.template.md"), "utf8");
+var DEFAULT_README_BODY = readFileSync3(PATH2.resolve(readmeTemplatesDir, "README.body.md"), "utf8");
+function applyLogoConfig(template, logoUrl, logoLinkUrl) {
+  let result = template;
+  if (logoUrl) {
+    result = result.replace(/\[logo]: .+/, `[logo]: ${logoUrl}`);
+    if (logoLinkUrl) {
+      result = result.replace(/\[!\[logo]\[]][^)]*\)/, `[![logo][]](${logoLinkUrl})`);
+    }
+  } else {
+    result = result.replace(/\[!\[logo]\[]][^\n]*\n*/, "");
+    result = result.replace(/\[logo]: [^\n]*\n?/, "");
+  }
+  return result;
+}
+function resolveTemplatePath(templatePath) {
+  const cwd = INIT_CWD() ?? ".";
+  return templatePath ?? PATH2.join(cwd, ".xy", "README.template.md");
+}
+async function loadOrCreateTemplate(resolvedTemplatePath) {
+  try {
+    const template = await readFile(resolvedTemplatePath, "utf8");
+    return { created: false, template };
+  } catch {
+    console.log(chalk4.yellow(`Template not found: ${resolvedTemplatePath}`));
+    const shouldCreate = await askConfirmation("Would you like to create a stock template? (y/N) ");
+    if (!shouldCreate) {
+      throw new Error("Template creation declined");
+    }
+    const template = DEFAULT_README_TEMPLATE;
+    await scaffoldTemplate(resolvedTemplatePath, template);
+    return { created: true, template };
+  }
+}
+async function scaffoldTemplate(resolvedTemplatePath, template) {
+  const xyDir = PATH2.dirname(resolvedTemplatePath);
+  await mkdir(xyDir, { recursive: true });
+  await writeFile(resolvedTemplatePath, template);
+  console.log(chalk4.green(`Created template: ${resolvedTemplatePath}`));
+  const bodyPath = PATH2.join(xyDir, "README.body.md");
+  await writeFile(bodyPath, DEFAULT_README_BODY);
+  console.log(chalk4.green(`Created body template: ${bodyPath}`));
+}
+async function resolveBody(location, defaultBody) {
+  const localBodyPath = PATH2.join(location, "README.body.md");
+  try {
+    return await readFile(localBodyPath, "utf8");
+  } catch {
+    return defaultBody;
+  }
+}
+async function generateReadmeForWorkspace(location, name, template, defaultBody, typedoc, verbose) {
+  try {
+    const pkgJsonPath = PATH2.join(location, "package.json");
+    const pkgJson = JSON.parse(await readFile(pkgJsonPath, "utf8"));
+    const body = await resolveBody(location, defaultBody);
+    const typedocContent = typedoc ? generateTypedoc(location, ["src/index*.ts"]) : "";
+    const readmeContent = fillTemplate(template, {
+      ...pkgJson,
+      body,
+      typedoc: typedocContent
+    });
+    await writeFile(PATH2.join(location, "README.md"), readmeContent);
+    if (verbose) console.log(chalk4.green(`  ${name}`));
+    return true;
+  } catch (ex) {
+    const error = ex;
+    console.warn(chalk4.yellow(`  Skipped ${location}: ${error.message}`));
+    return false;
+  }
+}
 async function generateReadmeFiles({
+  logoLinkUrl,
+  logoUrl,
   pkg,
   templatePath,
   typedoc = false,
-  verbose
+  verbose = false
 }) {
   console.log(chalk4.green("Generate README Files"));
-  const cwd = INIT_CWD() ?? ".";
-  const resolvedTemplatePath = templatePath ?? PATH2.join(cwd, "scripts", "README.template.md");
+  const resolvedTemplatePath = resolveTemplatePath(templatePath);
   let template;
+  let templateCreated;
   try {
-    template = await readFile(resolvedTemplatePath, "utf8");
+    ({ template, created: templateCreated } = await loadOrCreateTemplate(resolvedTemplatePath));
   } catch {
-    console.error(chalk4.red(`Template not found: ${resolvedTemplatePath}`));
     return 1;
   }
-  const workspaces = pkg ? [yarnWorkspace(pkg)] : yarnWorkspaces();
+  template = applyLogoConfig(template, logoUrl, logoLinkUrl);
+  if (templateCreated) {
+    console.log(chalk4.green("Generating README files for all packages..."));
+  }
+  const xyDir = PATH2.dirname(resolvedTemplatePath);
+  const xyBodyPath = PATH2.join(xyDir, "README.body.md");
+  let defaultBody;
+  try {
+    defaultBody = await readFile(xyBodyPath, "utf8");
+  } catch {
+    defaultBody = DEFAULT_README_BODY;
+  }
+  const workspaces = pkg && !templateCreated ? [yarnWorkspace(pkg)] : yarnWorkspaces();
   let failed = false;
   for (const { location, name } of workspaces) {
-    try {
-      const pkgJsonPath = PATH2.join(location, "package.json");
-      const pkgJson = JSON.parse(await readFile(pkgJsonPath, "utf8"));
-      const typedocContent = typedoc ? generateTypedoc(location, ["src/index*.ts"]) : "";
-      const readmeContent = fillTemplate(template, { ...pkgJson, typedoc: typedocContent });
-      await writeFile(PATH2.join(location, "README.md"), readmeContent);
-      if (verbose) console.log(chalk4.green(`  ${name}`));
-    } catch (ex) {
-      const error = ex;
-      console.warn(chalk4.yellow(`  Skipped ${location}: ${error.message}`));
-      failed = true;
-    }
+    const success = await generateReadmeForWorkspace(location, name, template, defaultBody, typedoc, verbose);
+    if (!success) failed = true;
   }
   return failed ? 1 : 0;
 }
 
+// src/lib/loadConfig.ts
+import chalk5 from "chalk";
+import { cosmiconfig } from "cosmiconfig";
+import { TypeScriptLoader } from "cosmiconfig-typescript-loader";
+import deepmerge from "deepmerge";
+var config;
+var loadConfig = async (params) => {
+  if (config === void 0) {
+    const cosmicConfigResult = await cosmiconfig("xy", { cache: true, loaders: { ".ts": TypeScriptLoader() } }).search();
+    config = cosmicConfigResult?.config;
+    const configFilePath = cosmicConfigResult?.filepath;
+    if (configFilePath !== void 0) {
+      console.log(chalk5.green(`Loaded config from ${configFilePath}`));
+      if (config.verbose) {
+        console.log(chalk5.gray(`${JSON.stringify(config, null, 2)}`));
+      }
+    }
+  }
+  return deepmerge(config, params ?? {});
+};
+
 // src/lib/runSteps.ts
 import { spawnSync as spawnSync3 } from "child_process";
 import { existsSync as existsSync2 } from "fs";
-import chalk5 from "chalk";
+import chalk6 from "chalk";
 var runSteps = (name, steps, exitOnFail = true, messages) => {
   return safeExit(() => {
     const pkgName = process.env.npm_package_name;
-    console.log(chalk5.green(`${name} [${pkgName}]`));
+    console.log(chalk6.green(`${name} [${pkgName}]`));
     let totalStatus = 0;
-    for (const [i, [command, args, config]] of steps.entries()) {
+    for (const [i, [command, args, config2]] of steps.entries()) {
       if (messages?.[i]) {
-        console.log(chalk5.gray(messages?.[i]));
+        console.log(chalk6.gray(messages?.[i]));
       }
       const argList = Array.isArray(args) ? args : args.split(" ");
       if (command === "node" && !existsSync2(argList[0])) {
         throw new Error(`File not found [${argList[0]}]`);
       }
       const status = spawnSync3(command, Array.isArray(args) ? args : args.split(" "), {
-        ...config,
+        ...config2,
         encoding: "utf8",
         env: { FORCE_COLOR: "3", ...process.env },
         shell: true,
@@ -358,12 +471,12 @@ import {
   existsSync as existsSync3,
   mkdirSync,
   readdirSync as readdirSync2,
-  readFileSync as readFileSync3,
+  readFileSync as readFileSync4,
   unlinkSync,
   writeFileSync as writeFileSync2
 } from "fs";
 import PATH3 from "path";
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 var syncCommandFiles = (commandsDir) => {
   const templates = claudeCommandTemplates();
   const templateNames = new Set(Object.keys(templates));
@@ -371,7 +484,7 @@ var syncCommandFiles = (commandsDir) => {
   let created = 0;
   for (const [filename3, content] of Object.entries(templates)) {
     const targetPath = PATH3.resolve(commandsDir, filename3);
-    const existing = existsSync3(targetPath) ? readFileSync3(targetPath, "utf8") : void 0;
+    const existing = existsSync3(targetPath) ? readFileSync4(targetPath, "utf8") : void 0;
     if (existing === content) continue;
     writeFileSync2(targetPath, content, "utf8");
     if (existing) {
@@ -404,9 +517,9 @@ var logCommandsResult = (created, updated, removed) => {
       updated ? `${updated} updated` : "",
       removed ? `${removed} removed` : ""
     ].filter(Boolean);
-    console.log(chalk6.green(`.claude/commands/${XYLABS_COMMANDS_PREFIX}*.md: ${parts.join(", ")}`));
+    console.log(chalk7.green(`.claude/commands/${XYLABS_COMMANDS_PREFIX}*.md: ${parts.join(", ")}`));
   } else {
-    console.log(chalk6.gray(`.claude/commands/${XYLABS_COMMANDS_PREFIX}*.md: already up to date`));
+    console.log(chalk7.gray(`.claude/commands/${XYLABS_COMMANDS_PREFIX}*.md: already up to date`));
   }
 };
 var claudeCommands = () => {
@@ -428,12 +541,12 @@ import {
   existsSync as existsSync4,
   mkdirSync as mkdirSync2,
   readdirSync as readdirSync3,
-  readFileSync as readFileSync4,
+  readFileSync as readFileSync5,
   unlinkSync as unlinkSync2,
   writeFileSync as writeFileSync3
 } from "fs";
 import PATH4 from "path";
-import chalk7 from "chalk";
+import chalk8 from "chalk";
 var syncRuleFiles = (rulesDir) => {
   const templates = claudeMdRuleTemplates();
   const templateNames = new Set(Object.keys(templates));
@@ -441,7 +554,7 @@ var syncRuleFiles = (rulesDir) => {
   let created = 0;
   for (const [filename3, content] of Object.entries(templates)) {
     const targetPath = PATH4.resolve(rulesDir, filename3);
-    const existing = existsSync4(targetPath) ? readFileSync4(targetPath, "utf8") : void 0;
+    const existing = existsSync4(targetPath) ? readFileSync5(targetPath, "utf8") : void 0;
     if (existing === content) continue;
     writeFileSync3(targetPath, content, "utf8");
     if (existing) {
@@ -474,21 +587,21 @@ var logRulesResult = (created, updated, removed) => {
       updated ? `${updated} updated` : "",
       removed ? `${removed} removed` : ""
     ].filter(Boolean);
-    console.log(chalk7.green(`.claude/rules/${XYLABS_RULES_PREFIX}*.md: ${parts.join(", ")}`));
+    console.log(chalk8.green(`.claude/rules/${XYLABS_RULES_PREFIX}*.md: ${parts.join(", ")}`));
   } else {
-    console.log(chalk7.gray(`.claude/rules/${XYLABS_RULES_PREFIX}*.md: already up to date`));
+    console.log(chalk8.gray(`.claude/rules/${XYLABS_RULES_PREFIX}*.md: already up to date`));
   }
 };
 var ensureProjectClaudeMd = (cwd, force) => {
   const projectPath = PATH4.resolve(cwd, "CLAUDE.md");
   if (!existsSync4(projectPath) || force) {
     if (force && existsSync4(projectPath)) {
-      console.log(chalk7.yellow("Overwriting existing CLAUDE.md"));
+      console.log(chalk8.yellow("Overwriting existing CLAUDE.md"));
     }
     writeFileSync3(projectPath, claudeMdProjectTemplate(), "utf8");
-    console.log(chalk7.green("Generated CLAUDE.md"));
+    console.log(chalk8.green("Generated CLAUDE.md"));
   } else {
-    console.log(chalk7.gray("CLAUDE.md already exists (skipped)"));
+    console.log(chalk8.gray("CLAUDE.md already exists (skipped)"));
   }
 };
 var claudeRules = ({ force } = {}) => {
@@ -513,8 +626,8 @@ import {
   writeFileSync as writeFileSync4
 } from "fs";
 import PATH5 from "path";
-import { createInterface } from "readline";
-import chalk8 from "chalk";
+import { createInterface as createInterface2 } from "readline";
+import chalk9 from "chalk";
 var DEFAULT_SETTINGS = {
   permissions: {
     allow: [
@@ -548,8 +661,8 @@ var DEFAULT_SETTINGS = {
     ]
   }
 };
-function askConfirmation(question) {
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
+function askConfirmation2(question) {
+  const rl = createInterface2({ input: process.stdin, output: process.stdout });
   return new Promise((resolve) => {
     rl.question(question, (answer) => {
       rl.close();
@@ -563,26 +676,26 @@ async function claudeSettings() {
   const settingsPath = PATH5.resolve(claudeDir, "settings.local.json");
   mkdirSync3(claudeDir, { recursive: true });
   if (existsSync5(settingsPath)) {
-    const confirmed = await askConfirmation(
-      chalk8.yellow(`${settingsPath} already exists. Replace it? (y/N) `)
+    const confirmed = await askConfirmation2(
+      chalk9.yellow(`${settingsPath} already exists. Replace it? (y/N) `)
     );
     if (!confirmed) {
-      console.log(chalk8.gray("Skipped \u2014 existing settings.local.json preserved"));
+      console.log(chalk9.gray("Skipped \u2014 existing settings.local.json preserved"));
       return 0;
     }
   }
   writeFileSync4(settingsPath, `${JSON.stringify(DEFAULT_SETTINGS, null, 2)}
 `, "utf8");
-  console.log(chalk8.green("Generated .claude/settings.local.json"));
+  console.log(chalk9.green("Generated .claude/settings.local.json"));
   return 0;
 }
 
 // src/actions/clean-docs.ts
 import path from "path";
-import chalk9 from "chalk";
+import chalk10 from "chalk";
 var cleanDocs = () => {
   const pkgName = process.env.npm_package_name;
-  console.log(chalk9.green(`Cleaning Docs [${pkgName}]`));
+  console.log(chalk10.green(`Cleaning Docs [${pkgName}]`));
   for (const { location } of yarnWorkspaces()) deleteGlob(path.join(location, "docs"));
   return 0;
 };
@@ -611,7 +724,7 @@ var filename = ".gitignore";
 var gitignoreGen = (pkg) => generateIgnoreFiles(filename, pkg);
 
 // src/actions/gitlint.ts
-import chalk10 from "chalk";
+import chalk11 from "chalk";
 import ParseGitConfig from "parse-git-config";
 var gitlint = () => {
   console.log(`
@@ -622,7 +735,7 @@ Gitlint Start [${process.cwd()}]
   const errors = 0;
   const gitConfig = ParseGitConfig.sync();
   const warn = (message) => {
-    console.warn(chalk10.yellow(`Warning: ${message}`));
+    console.warn(chalk11.yellow(`Warning: ${message}`));
     warnings++;
   };
   if (gitConfig.core.ignorecase) {
@@ -642,13 +755,13 @@ Gitlint Start [${process.cwd()}]
   }
   const resultMessages = [];
   if (valid > 0) {
-    resultMessages.push(chalk10.green(`Passed: ${valid}`));
+    resultMessages.push(chalk11.green(`Passed: ${valid}`));
   }
   if (warnings > 0) {
-    resultMessages.push(chalk10.yellow(`Warnings: ${warnings}`));
+    resultMessages.push(chalk11.yellow(`Warnings: ${warnings}`));
   }
   if (errors > 0) {
-    resultMessages.push(chalk10.red(` Errors: ${errors}`));
+    resultMessages.push(chalk11.red(` Errors: ${errors}`));
   }
   console.warn(`Gitlint Finish [ ${resultMessages.join(" | ")} ]
 `);
@@ -657,7 +770,7 @@ Gitlint Start [${process.cwd()}]
 
 // src/actions/gitlint-fix.ts
 import { execSync as execSync2 } from "child_process";
-import chalk11 from "chalk";
+import chalk12 from "chalk";
 import ParseGitConfig2 from "parse-git-config";
 var gitlintFix = () => {
   console.log(`
@@ -666,21 +779,21 @@ Gitlint Fix Start [${process.cwd()}]
   const gitConfig = ParseGitConfig2.sync();
   if (gitConfig.core.ignorecase) {
     execSync2("git config core.ignorecase false", { stdio: "inherit" });
-    console.warn(chalk11.yellow("\nGitlint Fix: Updated core.ignorecase to be false\n"));
+    console.warn(chalk12.yellow("\nGitlint Fix: Updated core.ignorecase to be false\n"));
   }
   if (gitConfig.core.autocrlf !== false) {
     execSync2("git config core.autocrlf false", { stdio: "inherit" });
-    console.warn(chalk11.yellow("\nGitlint Fix: Updated core.autocrlf to be false\n"));
+    console.warn(chalk12.yellow("\nGitlint Fix: Updated core.autocrlf to be false\n"));
   }
   if (gitConfig.core.eol !== "lf") {
     execSync2("git config core.eol lf", { stdio: "inherit" });
-    console.warn(chalk11.yellow('\nGitlint Fix: Updated core.eol to be "lf"\n'));
+    console.warn(chalk12.yellow('\nGitlint Fix: Updated core.eol to be "lf"\n'));
   }
   return 1;
 };
 
 // src/actions/license.ts
-import chalk12 from "chalk";
+import chalk13 from "chalk";
 import { init } from "license-checker";
 var license = async (pkg) => {
   const workspaces = yarnWorkspaces();
@@ -705,18 +818,18 @@ var license = async (pkg) => {
     "LGPL-3.0-or-later",
     "Python-2.0"
   ]);
-  console.log(chalk12.green("License Checker"));
+  console.log(chalk13.green("License Checker"));
   return (await Promise.all(
     workspaceList.map(({ location, name }) => {
       return new Promise((resolve) => {
         init({ production: true, start: location }, (error, packages) => {
           if (error) {
-            console.error(chalk12.red(`License Checker [${name}] Error`));
-            console.error(chalk12.gray(error));
+            console.error(chalk13.red(`License Checker [${name}] Error`));
+            console.error(chalk13.gray(error));
             console.log("\n");
             resolve(1);
           } else {
-            console.log(chalk12.green(`License Checker [${name}]`));
+            console.log(chalk13.green(`License Checker [${name}]`));
             let count = 0;
             for (const [name2, info] of Object.entries(packages)) {
               const licenses = Array.isArray(info.licenses) ? info.licenses : [info.licenses];
@@ -732,7 +845,7 @@ var license = async (pkg) => {
                   }
                   if (!orLicenseFound) {
                     count++;
-                    console.warn(chalk12.yellow(`${name2}: Package License not allowed [${license2}]`));
+                    console.warn(chalk13.yellow(`${name2}: Package License not allowed [${license2}]`));
                   }
                 }
               }
@@ -757,7 +870,10 @@ async function readmeGen({
   typedoc,
   verbose
 }) {
+  const config2 = await loadConfig();
   return await generateReadmeFiles({
+    logoLinkUrl: config2.readme?.logoLinkUrl,
+    logoUrl: config2.readme?.logoUrl,
     pkg,
     templatePath,
     typedoc,
@@ -765,11 +881,20 @@ async function readmeGen({
   });
 }
 
+// src/actions/readme-init.ts
+async function readmeInit({ templatePath }) {
+  const config2 = await loadConfig();
+  const template = applyLogoConfig(DEFAULT_README_TEMPLATE, config2.readme?.logoUrl, config2.readme?.logoLinkUrl);
+  const resolvedTemplatePath = resolveTemplatePath(templatePath);
+  await scaffoldTemplate(resolvedTemplatePath, template);
+  return 0;
+}
+
 // src/actions/retest.ts
 var retest = () => {
   return runSteps("Test", [
-    ["yarn", ["jest", "--clearCache"]],
-    ["yarn", ["jest", "."]]
+    ["yarn", ["vitest", "--clearCache"]],
+    ["yarn", ["vitest", "."]]
   ]);
 };
 
@@ -802,188 +927,273 @@ var yarn3Only = () => {
   return 0;
 };
 
+// src/xy/common/claude/commandsCommand.ts
+var commandsCommand = {
+  command: "commands",
+  describe: "Sync XY Labs standard Claude slash commands to .claude/commands/",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Claude Commands");
+    process.exitCode = claudeCommands();
+  }
+};
+
+// src/xy/common/claude/initCommand.ts
+var initCommand = {
+  builder: (yargs) => {
+    return yargs.option("force", {
+      alias: "f",
+      default: false,
+      description: "Overwrite existing CLAUDE.md",
+      type: "boolean"
+    });
+  },
+  command: "init",
+  describe: "Initialize all Claude configuration (commands, rules, settings)",
+  handler: async (argv) => {
+    if (argv.verbose) console.log("Claude Init");
+    const commandsResult = claudeCommands();
+    const rulesResult = claudeRules({ force: argv.force });
+    const settingsResult = await claudeSettings();
+    process.exitCode = commandsResult || rulesResult || settingsResult;
+  }
+};
+
+// src/xy/common/claude/rulesCommand.ts
+var rulesCommand = {
+  builder: (yargs) => {
+    return yargs.option("force", {
+      alias: "f",
+      default: false,
+      description: "Overwrite existing CLAUDE.md",
+      type: "boolean"
+    });
+  },
+  command: "rules",
+  describe: "Sync XY Labs standard Claude rules to .claude/rules/",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Claude Rules");
+    process.exitCode = claudeRules({ force: argv.force });
+  }
+};
+
+// src/xy/common/claude/settingsCommand.ts
+var settingsCommand = {
+  command: "settings",
+  describe: "Initialize .claude/settings.local.json with XY Labs defaults",
+  handler: async (argv) => {
+    if (argv.verbose) console.log("Claude Settings");
+    process.exitCode = await claudeSettings();
+  }
+};
+
+// src/xy/common/claude/index.ts
+var claudeCommand = {
+  builder: (yargs) => {
+    return yargs.command(commandsCommand).command(initCommand).command(rulesCommand).command(settingsCommand).demandCommand(1, "Please specify a claude subcommand");
+  },
+  command: "claude",
+  describe: "Claude - Claude Code configuration utilities",
+  handler: () => {
+  }
+};
+
+// src/xy/common/cleanDocsCommand.ts
+var cleanDocsCommand = {
+  command: "clean-docs",
+  describe: "CleanDocs - Clean TypeDocs",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Cleaning TypeDocs: all");
+    process.exitCode = cleanDocs();
+  }
+};
+
 // src/xy/param.ts
 var packagePositionalParam = (yargs) => {
   return yargs.positional("package", { describe: "Specific package to target", type: "string" });
 };
 
-// src/xy/xyCommonCommands.ts
+// src/xy/common/deadCommand.ts
+var deadCommand = {
+  builder: (yargs) => {
+    return packagePositionalParam(yargs);
+  },
+  command: "dead [package]",
+  describe: "Dead - Check for dead code",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Dead");
+    process.exitCode = dead();
+  }
+};
+
+// src/xy/common/genDocsCommand.ts
+var genDocsCommand = {
+  builder: (yargs) => {
+    return packagePositionalParam(yargs);
+  },
+  command: "gen-docs [package]",
+  describe: "GenDocs - Generate TypeDocs",
+  handler: (argv) => {
+    if (argv.verbose) console.log(`Generating TypeDocs: ${argv.package ?? "all"}`);
+    process.exitCode = genDocs({ incremental: !!argv.incremental, pkg: argv.package });
+  }
+};
+
+// src/xy/common/gitignoreGenCommand.ts
+var gitignoreGenCommand = {
+  command: "gitignore-gen",
+  describe: "GitIgnore Gen - Generate .gitignore files",
+  handler: (argv) => {
+    if (argv.verbose) console.log("GitIgnore Gen");
+    process.exitCode = gitignoreGen();
+  }
+};
+
+// src/xy/common/gitlintCommand.ts
+var gitlintCommand = {
+  command: "gitlint [package]",
+  describe: "Gitlint - Lint your git config",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Gitlint");
+    process.exitCode = argv.fix ? gitlintFix() : gitlint();
+  }
+};
+
+// src/xy/common/licenseCommand.ts
+var licenseCommand = {
+  builder: (yargs) => {
+    return packagePositionalParam(yargs);
+  },
+  command: "license [package]",
+  describe: "License - Check licenses of dependencies",
+  handler: async (argv) => {
+    if (argv.verbose) console.log(`License: ${argv.package ?? "all"}`);
+    process.exitCode = await license();
+  }
+};
+
+// src/xy/common/npmignoreGenCommand.ts
+var npmignoreGenCommand = {
+  command: "npmignore-gen",
+  describe: "NpmIgnore Gen - Generate .npmignore files",
+  handler: (argv) => {
+    if (argv.verbose) console.log("NpmIgnore Gen");
+    process.exitCode = npmignoreGen();
+  }
+};
+
+// src/xy/common/readme/genCommand.ts
+var genCommand = {
+  builder: (yargs) => {
+    return packagePositionalParam(yargs).option("template", {
+      alias: "t",
+      description: "Path to README.template.md",
+      type: "string"
+    }).option("typedoc", {
+      default: false,
+      description: "Generate TypeDoc reference sections",
+      type: "boolean"
+    });
+  },
+  aliases: ["$0"],
+  command: "gen [package]",
+  describe: "Generate README.md files from template",
+  handler: async (argv) => {
+    if (argv.verbose) console.log("Readme Gen");
+    process.exitCode = await readmeGen({
+      pkg: argv.package,
+      templatePath: argv.template,
+      typedoc: argv.typedoc,
+      verbose: !!argv.verbose
+    });
+  }
+};
+
+// src/xy/common/readme/initCommand.ts
+var initCommand2 = {
+  builder: (yargs) => {
+    return yargs.option("template", {
+      alias: "t",
+      description: "Path to README.template.md",
+      type: "string"
+    });
+  },
+  command: "init",
+  describe: "Initialize README template and logo files",
+  handler: async (argv) => {
+    if (argv.verbose) console.log("Readme Init");
+    process.exitCode = await readmeInit({
+      templatePath: argv.template,
+      verbose: !!argv.verbose
+    });
+  }
+};
+
+// src/xy/common/readme/index.ts
+var readmeCommand = {
+  builder: (yargs) => {
+    return yargs.command(genCommand).command(initCommand2);
+  },
+  command: "readme",
+  describe: "Readme - README file utilities",
+  handler: () => {
+  }
+};
+
+// src/xy/common/retestCommand.ts
+var retestCommand = {
+  command: "retest",
+  describe: "Re-Test - Run Jest Tests with cleaned cache",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Re-Testing");
+    process.exitCode = retest();
+  }
+};
+
+// src/xy/common/testCommand.ts
+var testCommand = {
+  command: "test",
+  describe: "Test - Run Jest Tests",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Testing");
+    process.exitCode = test();
+  }
+};
+
+// src/xy/common/upplugCommand.ts
+var upplugCommand = {
+  command: "upplug",
+  describe: "UpPlug - Update Yarn Plugins",
+  handler: (argv) => {
+    if (argv.verbose) console.log("UpPlug");
+    process.exitCode = updateYarnPlugins();
+  }
+};
+
+// src/xy/common/upyarnCommand.ts
+var upyarnCommand = {
+  command: "upyarn",
+  describe: "UpYarn - Update Yarn Version",
+  handler: (argv) => {
+    if (argv.verbose) console.log("UpYarn");
+    process.exitCode = updateYarnVersion();
+  }
+};
+
+// src/xy/common/yarn3OnlyCommand.ts
+var yarn3OnlyCommand = {
+  command: "yarn3only",
+  describe: "Yarn3Only - Check if using Yarn v3",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Yarn 3 Check");
+    process.exitCode = yarn3Only();
+  }
+};
+
+// src/xy/common/index.ts
 var xyCommonCommands = (args) => {
-  return args.command(
-    "claude-commands",
-    "Claude Commands - Sync XY Labs standard Claude slash commands to .claude/commands/",
-    (yargs) => yargs,
-    (argv) => {
-      if (argv.verbose) console.log("Claude Commands");
-      process.exitCode = claudeCommands();
-    }
-  ).command(
-    "claude-settings",
-    "Claude Settings - Initialize .claude/settings.local.json with XY Labs defaults",
-    (yargs) => yargs,
-    async (argv) => {
-      if (argv.verbose) console.log("Claude Settings");
-      process.exitCode = await claudeSettings();
-    }
-  ).command(
-    "claude-rules",
-    "Claude Rules - Sync XY Labs standard Claude rules to .claude/rules/",
-    (yargs) => {
-      return yargs.option("force", {
-        alias: "f",
-        default: false,
-        description: "Overwrite existing CLAUDE.md",
-        type: "boolean"
-      });
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Claude Rules");
-      process.exitCode = claudeRules({ force: argv.force });
-    }
-  ).command(
-    "license [package]",
-    "License - Check licenses of dependencies",
-    (yargs) => {
-      return packagePositionalParam(yargs);
-    },
-    async (argv) => {
-      if (argv.verbose) console.log(`License: ${argv.package ?? "all"}`);
-      process.exitCode = await license();
-    }
-  ).command(
-    "dead [package]",
-    "Dead - Check for dead code",
-    (yargs) => {
-      return packagePositionalParam(yargs);
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Dead");
-      process.exitCode = dead();
-    }
-  ).command(
-    "gen-docs [package]",
-    "GenDocs - Generate TypeDocs",
-    (yargs) => {
-      return packagePositionalParam(yargs);
-    },
-    (argv) => {
-      if (argv.verbose) console.log(`Generating TypeDocs: ${argv.package ?? "all"}`);
-      process.exitCode = genDocs({ incremental: !!argv.incremental, pkg: argv.package });
-    }
-  ).command(
-    "clean-docs",
-    "CleanDocs - Clean TypeDocs",
-    (yargs) => yargs,
-    (argv) => {
-      if (argv.verbose) console.log("Cleaning TypeDocs: all");
-      process.exitCode = cleanDocs();
-    }
-  ).command(
-    "gitlint [package]",
-    "Gitlint - Lint your git config",
-    (yargs) => {
-      return yargs;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Gitlint");
-      process.exitCode = argv.fix ? gitlintFix() : gitlint();
-    }
-  ).command(
-    "gitignore-gen",
-    "GitIgnore Gen - Generate .gitignore files",
-    (yargs) => {
-      return yargs;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("GitIgnore Gen");
-      process.exitCode = gitignoreGen();
-    }
-  ).command(
-    "npmignore-gen",
-    "NpmIgnore Gen - Generate .npmignore files",
-    (yargs) => {
-      return yargs;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("NpmIgnore Gen");
-      process.exitCode = npmignoreGen();
-    }
-  ).command(
-    "readme-gen [package]",
-    "Readme Gen - Generate README.md files from template",
-    (yargs) => {
-      return packagePositionalParam(yargs).option("template", {
-        alias: "t",
-        description: "Path to README.template.md",
-        type: "string"
-      }).option("typedoc", {
-        default: false,
-        description: "Generate TypeDoc reference sections",
-        type: "boolean"
-      });
-    },
-    async (argv) => {
-      if (argv.verbose) console.log("Readme Gen");
-      process.exitCode = await readmeGen({
-        pkg: argv.package,
-        templatePath: argv.template,
-        typedoc: argv.typedoc,
-        verbose: !!argv.verbose
-      });
-    }
-  ).command(
-    "retest",
-    "Re-Test - Run Jest Tests with cleaned cache",
-    (yargs) => {
-      return yargs;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Re-Testing");
-      process.exitCode = retest();
-    }
-  ).command(
-    "test",
-    "Test - Run Jest Tests",
-    (yargs) => {
-      return yargs;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Testing");
-      process.exitCode = test();
-    }
-  ).command(
-    "upplug",
-    "UpPlug - Update Yarn Plugins",
-    (yargs) => {
-      return yargs;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("UpPlug");
-      process.exitCode = updateYarnPlugins();
-    }
-  ).command(
-    "upyarn",
-    "UpYarn - Update Yarn Version",
-    (yargs) => {
-      return yargs;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("UpYarn");
-      process.exitCode = updateYarnVersion();
-    }
-  ).command(
-    "yarn3only",
-    "Yarn3Only - Check if using Yarn v3",
-    (yargs) => {
-      return yargs;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Yarn 3 Check");
-      process.exitCode = yarn3Only();
-    }
-  );
+  return args.command(claudeCommand).command(licenseCommand).command(deadCommand).command(genDocsCommand).command(cleanDocsCommand).command(gitlintCommand).command(gitignoreGenCommand).command(npmignoreGenCommand).command(readmeCommand).command(retestCommand).command(testCommand).command(upplugCommand).command(upyarnCommand).command(yarn3OnlyCommand);
 };
 export {
   xyCommonCommands
 };
-//# sourceMappingURL=xyCommonCommands.mjs.map
+//# sourceMappingURL=index.mjs.map