@xylabs/ts-scripts-yarn3 7.4.17 → 7.4.19

package/dist/index.mjs

@@ -20,7 +20,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 = () => {
@@ -381,10 +381,19 @@ var generateIgnoreFiles = (filename3, pkg) => {
 
 // src/lib/generateReadmeFiles.ts
 import { execSync as execSync2 } from "child_process";
-import FS from "fs";
-import { readFile, writeFile } from "fs/promises";
+import FS, { readFileSync as readFileSync5 } from "fs";
+import {
+  mkdir,
+  readFile,
+  writeFile
+} from "fs/promises";
+import { createRequire as createRequire2 } from "module";
 import PATH2 from "path";
+import { createInterface } from "readline";
 import chalk5 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()] ?? "");
@@ -474,37 +483,120 @@ ${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 = readFileSync5(PATH2.resolve(readmeTemplatesDir, "README.template.md"), "utf8");
+var DEFAULT_README_BODY = readFileSync5(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 cwd5 = INIT_CWD() ?? ".";
+  return templatePath ?? PATH2.join(cwd5, ".xy", "README.template.md");
+}
+async function loadOrCreateTemplate(resolvedTemplatePath) {
+  try {
+    const template = await readFile(resolvedTemplatePath, "utf8");
+    return { created: false, template };
+  } catch {
+    console.log(chalk5.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(chalk5.green(`Created template: ${resolvedTemplatePath}`));
+  const bodyPath = PATH2.join(xyDir, "README.body.md");
+  await writeFile(bodyPath, DEFAULT_README_BODY);
+  console.log(chalk5.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(chalk5.green(`  ${name}`));
+    return true;
+  } catch (ex) {
+    const error = ex;
+    console.warn(chalk5.yellow(`  Skipped ${location}: ${error.message}`));
+    return false;
+  }
+}
 async function generateReadmeFiles({
+  logoLinkUrl,
+  logoUrl,
   pkg,
   templatePath,
   typedoc = false,
-  verbose
+  verbose = false
 }) {
   console.log(chalk5.green("Generate README Files"));
-  const cwd5 = INIT_CWD() ?? ".";
-  const resolvedTemplatePath = templatePath ?? PATH2.join(cwd5, "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(chalk5.red(`Template not found: ${resolvedTemplatePath}`));
     return 1;
   }
-  const workspaces = pkg ? [yarnWorkspace(pkg)] : yarnWorkspaces();
+  template = applyLogoConfig(template, logoUrl, logoLinkUrl);
+  if (templateCreated) {
+    console.log(chalk5.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(chalk5.green(`  ${name}`));
-    } catch (ex) {
-      const error = ex;
-      console.warn(chalk5.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;
 }
@@ -531,10 +623,10 @@ var loadConfig = async (params) => {
 };
 
 // src/lib/parsedPackageJSON.ts
-import { readFileSync as readFileSync5 } from "fs";
+import { readFileSync as readFileSync6 } from "fs";
 var parsedPackageJSON = (path14) => {
   const pathToPackageJSON = path14 ?? process.env.npm_package_json ?? "";
-  const packageJSON = readFileSync5(pathToPackageJSON).toString();
+  const packageJSON = readFileSync6(pathToPackageJSON).toString();
   return JSON.parse(packageJSON);
 };
 
@@ -667,7 +759,7 @@ import {
   existsSync as existsSync5,
   mkdirSync,
   readdirSync as readdirSync2,
-  readFileSync as readFileSync6,
+  readFileSync as readFileSync7,
   unlinkSync,
   writeFileSync as writeFileSync2
 } from "fs";
@@ -680,7 +772,7 @@ var syncCommandFiles = (commandsDir) => {
   let created = 0;
   for (const [filename3, content] of Object.entries(templates)) {
     const targetPath = PATH3.resolve(commandsDir, filename3);
-    const existing = existsSync5(targetPath) ? readFileSync6(targetPath, "utf8") : void 0;
+    const existing = existsSync5(targetPath) ? readFileSync7(targetPath, "utf8") : void 0;
     if (existing === content) continue;
     writeFileSync2(targetPath, content, "utf8");
     if (existing) {
@@ -737,7 +829,7 @@ import {
   existsSync as existsSync6,
   mkdirSync as mkdirSync2,
   readdirSync as readdirSync3,
-  readFileSync as readFileSync7,
+  readFileSync as readFileSync8,
   unlinkSync as unlinkSync2,
   writeFileSync as writeFileSync3
 } from "fs";
@@ -750,7 +842,7 @@ var syncRuleFiles = (rulesDir) => {
   let created = 0;
   for (const [filename3, content] of Object.entries(templates)) {
     const targetPath = PATH4.resolve(rulesDir, filename3);
-    const existing = existsSync6(targetPath) ? readFileSync7(targetPath, "utf8") : void 0;
+    const existing = existsSync6(targetPath) ? readFileSync8(targetPath, "utf8") : void 0;
     if (existing === content) continue;
     writeFileSync3(targetPath, content, "utf8");
     if (existing) {
@@ -822,7 +914,7 @@ import {
   writeFileSync as writeFileSync4
 } from "fs";
 import PATH5 from "path";
-import { createInterface } from "readline";
+import { createInterface as createInterface2 } from "readline";
 import chalk13 from "chalk";
 var DEFAULT_SETTINGS = {
   permissions: {
@@ -857,8 +949,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();
@@ -872,7 +964,7 @@ async function claudeSettings() {
   const settingsPath = PATH5.resolve(claudeDir, "settings.local.json");
   mkdirSync3(claudeDir, { recursive: true });
   if (existsSync7(settingsPath)) {
-    const confirmed = await askConfirmation(
+    const confirmed = await askConfirmation2(
       chalk13.yellow(`${settingsPath} already exists. Replace it? (y/N) `)
     );
     if (!confirmed) {
@@ -1224,6 +1316,9 @@ function getImportsFromFile(filePath, importPaths, typeImportPaths) {
     ts.forEachChild(node, visit);
   }
   visit(sourceFile);
+  for (const ref of sourceFile.typeReferenceDirectives) {
+    typeImports.push(ref.fileName);
+  }
   const importsStartsWithExcludes = [".", "#", "node:"];
   const isValidImport = (imp) => !importsStartsWithExcludes.some((exc) => imp.startsWith(exc)) && !imp.includes("*") && !imp.includes("!");
   const cleanedImports = imports.filter(isValidImport).map(getBasePackageName);
@@ -1795,11 +1890,11 @@ var deplint = async ({
 };
 
 // src/actions/deploy.ts
-import { readFileSync as readFileSync8 } from "fs";
+import { readFileSync as readFileSync9 } from "fs";
 var privatePackageExcludeList = () => {
   const possibleDeployablePackages = yarnWorkspaces().map((workspace) => [
     workspace,
-    JSON.parse(readFileSync8(`${workspace.location}/package.json`, { encoding: "utf8" }))
+    JSON.parse(readFileSync9(`${workspace.location}/package.json`, { encoding: "utf8" }))
   ]);
   const privatePackages = possibleDeployablePackages.filter(([_, pkg]) => pkg.private).map(([workspace]) => workspace);
   const excludeList = privatePackages.map((workspace) => `--exclude ${workspace.name}`);
@@ -1819,11 +1914,11 @@ var deploy = () => {
 };
 
 // src/actions/deploy-major.ts
-import { readFileSync as readFileSync9 } from "fs";
+import { readFileSync as readFileSync10 } from "fs";
 var privatePackageExcludeList2 = () => {
   const possibleDeployablePackages = yarnWorkspaces().map((workspace) => [
     workspace,
-    JSON.parse(readFileSync9(`${workspace.location}/package.json`, { encoding: "utf8" }))
+    JSON.parse(readFileSync10(`${workspace.location}/package.json`, { encoding: "utf8" }))
   ]);
   const privatePackages = possibleDeployablePackages.filter(([_, pkg]) => pkg.private).map(([workspace]) => workspace);
   const excludeList = privatePackages.map((workspace) => `--exclude ${workspace.name}`);
@@ -1843,11 +1938,11 @@ var deployMajor = () => {
 };
 
 // src/actions/deploy-minor.ts
-import { readFileSync as readFileSync10 } from "fs";
+import { readFileSync as readFileSync11 } from "fs";
 var privatePackageExcludeList3 = () => {
   const possibleDeployablePackages = yarnWorkspaces().map((workspace) => [
     workspace,
-    JSON.parse(readFileSync10(`${workspace.location}/package.json`, { encoding: "utf8" }))
+    JSON.parse(readFileSync11(`${workspace.location}/package.json`, { encoding: "utf8" }))
   ]);
   const privatePackages = possibleDeployablePackages.filter(([_, pkg]) => pkg.private).map(([workspace]) => workspace);
   const excludeList = privatePackages.map((workspace) => `--exclude ${workspace.name}`);
@@ -1867,11 +1962,11 @@ var deployMinor = () => {
 };
 
 // src/actions/deploy-next.ts
-import { readFileSync as readFileSync11 } from "fs";
+import { readFileSync as readFileSync12 } from "fs";
 var privatePackageExcludeList4 = () => {
   const possibleDeployablePackages = yarnWorkspaces().map((workspace) => [
     workspace,
-    JSON.parse(readFileSync11(`${workspace.location}/package.json`, { encoding: "utf8" }))
+    JSON.parse(readFileSync12(`${workspace.location}/package.json`, { encoding: "utf8" }))
   ]);
   const privatePackages = possibleDeployablePackages.filter(([_, pkg]) => pkg.private).map(([workspace]) => workspace);
   const excludeList = privatePackages.map((workspace) => `--exclude ${workspace.name}`);
@@ -2915,7 +3010,10 @@ async function readmeGen({
   typedoc,
   verbose
 }) {
+  const config2 = await loadConfig();
   return await generateReadmeFiles({
+    logoLinkUrl: config2.readme?.logoLinkUrl,
+    logoUrl: config2.readme?.logoUrl,
     pkg,
     templatePath,
     typedoc,
@@ -2923,6 +3021,15 @@ 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/rebuild.ts
 var rebuild = ({ target }) => {
   return runSteps("Rebuild", [
@@ -3079,8 +3186,8 @@ var relintAllPackages = ({ fix: fix2 = false } = {}) => {
 // src/actions/retest.ts
 var retest = () => {
   return runSteps("Test", [
-    ["yarn", ["jest", "--clearCache"]],
-    ["yarn", ["jest", "."]]
+    ["yarn", ["vitest", "--clearCache"]],
+    ["yarn", ["vitest", "."]]
   ]);
 };
 
@@ -3149,105 +3256,200 @@ var loadPackageConfig = async () => {
   return JSON.parse(pkgConfig);
 };
 
-// src/xy/xy.ts
-import chalk43 from "chalk";
-
-// src/xy/xyBuildCommands.ts
-var xyBuildCommands = (args) => {
-  return args.command(
-    "build [package]",
-    "Build - Compile & Lint",
-    (yargs2) => {
-      return yargs2.positional("package", { describe: "Specific package to build" });
-    },
-    async (argv) => {
-      if (argv.verbose) {
-        console.log(`Building: ${argv.package ?? "all"}`);
-      }
-      process.exitCode = await build({
-        incremental: !!argv.incremental,
-        jobs: argv.jobs,
-        pkg: argv.package,
-        target: argv.target,
-        verbose: !!argv.verbose
-      });
-    }
-  ).command(
-    "compile [package]",
-    "Compile with Typescript & Copy Images",
-    (yargs2) => {
-      return yargs2.positional("package", { describe: "Specific package to compile" });
-    },
-    (argv) => {
-      if (argv.verbose) {
-        console.log(`Compiling: ${argv.package ?? "all"}`);
-      }
-      process.exitCode = compile({
-        incremental: !!argv.incremental,
-        jobs: argv.jobs,
-        pkg: argv.package,
-        target: argv.target,
-        verbose: !!argv.verbose
-      });
+// src/xy/build/buildCommand.ts
+var buildCommand = {
+  command: "build [package]",
+  describe: "Build - Compile & Lint",
+  builder: (yargs2) => {
+    return yargs2.positional("package", { describe: "Specific package to build" });
+  },
+  handler: async (argv) => {
+    if (argv.verbose) {
+      console.log(`Building: ${argv.package ?? "all"}`);
     }
-  ).command(
-    "compile-only [package]",
-    "Compile with Typescript & Copy Images (No Publint)",
-    (yargs2) => {
-      return yargs2.positional("package", { describe: "Specific package to compile" });
-    },
-    (argv) => {
-      if (argv.verbose) {
-        console.log(`Compiling: ${argv.package ?? "all"}`);
-      }
-      process.exitCode = compile({
-        incremental: !!argv.incremental,
-        jobs: argv.jobs,
-        pkg: argv.package,
-        publint: false,
-        target: argv.target,
-        verbose: !!argv.verbose
-      });
+    process.exitCode = await build({
+      incremental: !!argv.incremental,
+      jobs: argv.jobs,
+      pkg: argv.package,
+      target: argv.target,
+      verbose: !!argv.verbose
+    });
+  }
+};
+
+// src/xy/build/compileCommand.ts
+var compileCommand = {
+  command: "compile [package]",
+  describe: "Compile with Typescript & Copy Images",
+  builder: (yargs2) => {
+    return yargs2.positional("package", { describe: "Specific package to compile" });
+  },
+  handler: (argv) => {
+    if (argv.verbose) {
+      console.log(`Compiling: ${argv.package ?? "all"}`);
     }
-  ).command(
-    "recompile [package]",
-    "Re-compile with Typescript & Copy Images",
-    (yargs2) => {
-      return yargs2.positional("package", { describe: "Specific package to re-compile" });
-    },
-    async (argv) => {
-      if (argv.verbose) {
-        console.log(`Re-compiling: ${argv.package ?? "all"}`);
-      }
-      process.exitCode = await recompile({
-        incremental: !!argv.incremental,
-        jobs: argv.jobs,
-        pkg: argv.package,
-        target: argv.target,
-        verbose: !!argv.verbose
-      });
+    process.exitCode = compile({
+      incremental: !!argv.incremental,
+      jobs: argv.jobs,
+      pkg: argv.package,
+      target: argv.target,
+      verbose: !!argv.verbose
+    });
+  }
+};
+
+// src/xy/build/compileOnlyCommand.ts
+var compileOnlyCommand = {
+  command: "compile-only [package]",
+  describe: "Compile with Typescript & Copy Images (No Publint)",
+  builder: (yargs2) => {
+    return yargs2.positional("package", { describe: "Specific package to compile" });
+  },
+  handler: (argv) => {
+    if (argv.verbose) {
+      console.log(`Compiling: ${argv.package ?? "all"}`);
     }
-  ).command(
-    "rebuild [package]",
-    "Rebuild - Clean, Compile & Lint",
-    (yargs2) => {
-      return yargs2.positional("package", { describe: "Specific package to rebuild" });
-    },
-    (argv) => {
-      if (argv.verbose) console.log(`Rebuilding: ${argv.package ?? "all"}`);
-      process.exitCode = rebuild({ target: argv.target });
-    }
-  ).command(
-    "copy-assets [package]",
-    "Copy Assets - Copy the assets from src to dist",
-    (yargs2) => {
-      return yargs2.positional("package", { describe: "Specific package to copy assets" });
-    },
-    async (argv) => {
-      if (argv.verbose) console.log(`Copying Assets: ${argv.package ?? "all"}`);
-      process.exitCode = await copyAssets({ target: argv.target });
+    process.exitCode = compile({
+      incremental: !!argv.incremental,
+      jobs: argv.jobs,
+      pkg: argv.package,
+      publint: false,
+      target: argv.target,
+      verbose: !!argv.verbose
+    });
+  }
+};
+
+// src/xy/build/copyAssetsCommand.ts
+var copyAssetsCommand = {
+  command: "copy-assets [package]",
+  describe: "Copy Assets - Copy the assets from src to dist",
+  builder: (yargs2) => {
+    return yargs2.positional("package", { describe: "Specific package to copy assets" });
+  },
+  handler: async (argv) => {
+    if (argv.verbose) console.log(`Copying Assets: ${argv.package ?? "all"}`);
+    process.exitCode = await copyAssets({ target: argv.target });
+  }
+};
+
+// src/xy/build/rebuildCommand.ts
+var rebuildCommand = {
+  command: "rebuild [package]",
+  describe: "Rebuild - Clean, Compile & Lint",
+  builder: (yargs2) => {
+    return yargs2.positional("package", { describe: "Specific package to rebuild" });
+  },
+  handler: (argv) => {
+    if (argv.verbose) console.log(`Rebuilding: ${argv.package ?? "all"}`);
+    process.exitCode = rebuild({ target: argv.target });
+  }
+};
+
+// src/xy/build/recompileCommand.ts
+var recompileCommand = {
+  command: "recompile [package]",
+  describe: "Re-compile with Typescript & Copy Images",
+  builder: (yargs2) => {
+    return yargs2.positional("package", { describe: "Specific package to re-compile" });
+  },
+  handler: async (argv) => {
+    if (argv.verbose) {
+      console.log(`Re-compiling: ${argv.package ?? "all"}`);
     }
-  );
+    process.exitCode = await recompile({
+      incremental: !!argv.incremental,
+      jobs: argv.jobs,
+      pkg: argv.package,
+      target: argv.target,
+      verbose: !!argv.verbose
+    });
+  }
+};
+
+// src/xy/build/index.ts
+var xyBuildCommands = (args) => {
+  return args.command(buildCommand).command(compileCommand).command(compileOnlyCommand).command(recompileCommand).command(rebuildCommand).command(copyAssetsCommand);
+};
+
+// 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: (yargs2) => {
+    return yargs2.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: (yargs2) => {
+    return yargs2.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: (yargs2) => {
+    return yargs2.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
@@ -3255,455 +3457,497 @@ var packagePositionalParam = (yargs2) => {
   return yargs2.positional("package", { describe: "Specific package to target", type: "string" });
 };
 
-// src/xy/xyCommonCommands.ts
+// src/xy/common/deadCommand.ts
+var deadCommand = {
+  builder: (yargs2) => {
+    return packagePositionalParam(yargs2);
+  },
+  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: (yargs2) => {
+    return packagePositionalParam(yargs2);
+  },
+  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: (yargs2) => {
+    return packagePositionalParam(yargs2);
+  },
+  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: (yargs2) => {
+    return packagePositionalParam(yargs2).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: (yargs2) => {
+    return yargs2.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: (yargs2) => {
+    return yargs2.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/",
-    (yargs2) => yargs2,
-    (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",
-    (yargs2) => yargs2,
-    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/",
-    (yargs2) => {
-      return yargs2.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",
-    (yargs2) => {
-      return packagePositionalParam(yargs2);
-    },
-    async (argv) => {
-      if (argv.verbose) console.log(`License: ${argv.package ?? "all"}`);
-      process.exitCode = await license();
-    }
-  ).command(
-    "dead [package]",
-    "Dead - Check for dead code",
-    (yargs2) => {
-      return packagePositionalParam(yargs2);
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Dead");
-      process.exitCode = dead();
-    }
-  ).command(
-    "gen-docs [package]",
-    "GenDocs - Generate TypeDocs",
-    (yargs2) => {
-      return packagePositionalParam(yargs2);
-    },
-    (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",
-    (yargs2) => yargs2,
-    (argv) => {
-      if (argv.verbose) console.log("Cleaning TypeDocs: all");
-      process.exitCode = cleanDocs();
-    }
-  ).command(
-    "gitlint [package]",
-    "Gitlint - Lint your git config",
-    (yargs2) => {
-      return yargs2;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Gitlint");
-      process.exitCode = argv.fix ? gitlintFix() : gitlint();
-    }
-  ).command(
-    "gitignore-gen",
-    "GitIgnore Gen - Generate .gitignore files",
-    (yargs2) => {
-      return yargs2;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("GitIgnore Gen");
-      process.exitCode = gitignoreGen();
-    }
-  ).command(
-    "npmignore-gen",
-    "NpmIgnore Gen - Generate .npmignore files",
-    (yargs2) => {
-      return yargs2;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("NpmIgnore Gen");
-      process.exitCode = npmignoreGen();
-    }
-  ).command(
-    "readme-gen [package]",
-    "Readme Gen - Generate README.md files from template",
-    (yargs2) => {
-      return packagePositionalParam(yargs2).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",
-    (yargs2) => {
-      return yargs2;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Re-Testing");
-      process.exitCode = retest();
-    }
-  ).command(
-    "test",
-    "Test - Run Jest Tests",
-    (yargs2) => {
-      return yargs2;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Testing");
-      process.exitCode = test();
-    }
-  ).command(
-    "upplug",
-    "UpPlug - Update Yarn Plugins",
-    (yargs2) => {
-      return yargs2;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("UpPlug");
-      process.exitCode = updateYarnPlugins();
-    }
-  ).command(
-    "upyarn",
-    "UpYarn - Update Yarn Version",
-    (yargs2) => {
-      return yargs2;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("UpYarn");
-      process.exitCode = updateYarnVersion();
-    }
-  ).command(
-    "yarn3only",
-    "Yarn3Only - Check if using Yarn v3",
-    (yargs2) => {
-      return yargs2;
-    },
-    (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);
+};
+
+// src/xy/deploy/deployCommand.ts
+var deployCommand = {
+  command: "deploy",
+  describe: "Deploy - Deploy patch",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Deploy patch");
+    process.exitCode = deploy();
+  }
+};
+
+// src/xy/deploy/deployMajorCommand.ts
+var deployMajorCommand = {
+  command: "deploy-major",
+  describe: "Deploy - Deploy major",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Deploy major");
+    process.exitCode = deployMajor();
+  }
+};
+
+// src/xy/deploy/deployMinorCommand.ts
+var deployMinorCommand = {
+  command: "deploy-minor",
+  describe: "Deploy - Deploy minor",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Deploy minor");
+    process.exitCode = deployMinor();
+  }
+};
+
+// src/xy/deploy/deployNextCommand.ts
+var deployNextCommand = {
+  command: "deploy-next",
+  describe: "Deploy - Deploy next",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Deploy next");
+    process.exitCode = deployNext();
+  }
+};
+
+// src/xy/deploy/publishCommand.ts
+var publishCommand = {
+  command: "publish",
+  describe: "Publish - Publish packages to npmjs",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Publish packages to npmjs");
+    process.exitCode = publish();
+  }
 };
 
-// src/xy/xyDeployCommands.ts
+// src/xy/deploy/index.ts
 var xyDeployCommands = (args) => {
-  return args.command(
-    "deploy",
-    "Deploy - Deploy patch",
-    (yargs2) => {
-      return yargs2;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Deploy patch");
-      process.exitCode = deploy();
-    }
-  ).command(
-    "deploy-minor",
-    "Deploy - Deploy minor",
-    (yargs2) => {
-      return yargs2;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Deploy minor");
-      process.exitCode = deployMinor();
-    }
-  ).command(
-    "deploy-major",
-    "Deploy - Deploy major",
-    (yargs2) => {
-      return yargs2;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Deploy major");
-      process.exitCode = deployMajor();
-    }
-  ).command(
-    "deploy-next",
-    "Deploy - Deploy next",
-    (yargs2) => {
-      return yargs2;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Deploy next");
-      process.exitCode = deployNext();
-    }
-  ).command(
-    "publish",
-    "Publish - Publish packages to npmjs",
-    (yargs2) => {
-      return yargs2;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Publish packages to npmjs");
-      process.exitCode = publish();
+  return args.command(deployCommand).command(deployMinorCommand).command(deployMajorCommand).command(deployNextCommand).command(publishCommand);
+};
+
+// src/xy/install/cleanCommand.ts
+var cleanCommand = {
+  command: "clean [package]",
+  describe: "Clean",
+  builder: (yargs2) => {
+    return yargs2.positional("package", { describe: "Specific package to clean" });
+  },
+  handler: async (argv) => {
+    if (argv.verbose) {
+      console.log(`Cleaning: ${argv.package ?? "all"}`);
     }
-  );
+    process.exitCode = await clean({
+      pkg: argv.package,
+      verbose: !!argv.verbose
+    });
+  }
 };
 
-// src/xy/xyInstallCommands.ts
+// src/xy/install/dupdepsCommand.ts
+var dupdepsCommand = {
+  command: "dupdeps",
+  describe: "Dupdeps - Duplicate Dependencies in package.json",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Dupdeps");
+    process.exitCode = dupdeps();
+  }
+};
+
+// src/xy/install/reinstallCommand.ts
+var reinstallCommand = {
+  command: "reinstall",
+  describe: "Reinstall - Clean & Install",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Reinstalling");
+    process.exitCode = reinstall();
+  }
+};
+
+// src/xy/install/staticsCommand.ts
+var staticsCommand = {
+  command: "statics",
+  describe: "Statics - Confirming Static Packages",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Statics");
+    process.exitCode = statics();
+  }
+};
+
+// src/xy/install/upCommand.ts
+var upCommand = {
+  command: "up",
+  describe: "Up - Update dependencies",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Up");
+    process.exitCode = up();
+  }
+};
+
+// src/xy/install/updoCommand.ts
+var updoCommand = {
+  command: "updo",
+  describe: "Updo - Update dependencies [Interactive]",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Updo");
+    process.exitCode = updo();
+  }
+};
+
+// src/xy/install/index.ts
 var xyInstallCommands = (args) => {
-  return args.command(
-    "clean [package]",
-    "Clean",
-    (yargs2) => {
-      return yargs2.positional("package", { describe: "Specific package to clean" });
-    },
-    async (argv) => {
-      if (argv.verbose) {
-        console.log(`Cleaning: ${argv.package ?? "all"}`);
-      }
-      process.exitCode = await clean({
-        pkg: argv.package,
-        verbose: !!argv.verbose
-      });
-    }
-  ).command(
-    "reinstall",
-    "Reinstall - Clean & Install",
-    (yargs2) => {
-      return yargs2;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Reinstalling");
-      process.exitCode = reinstall();
-    }
-  ).command(
-    "up",
-    "Up - Update dependencies",
-    (yargs2) => {
-      return yargs2;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Up");
-      process.exitCode = up();
-    }
-  ).command(
-    "updo",
-    "Updo - Update dependencies [Interactive]",
-    (yargs2) => {
-      return yargs2;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Updo");
-      process.exitCode = updo();
-    }
-  ).command(
-    "statics",
-    "Statics - Confirming Static Packages",
-    (yargs2) => {
-      return yargs2;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Statics");
-      process.exitCode = statics();
-    }
-  ).command(
-    "dupdeps",
-    "Dupdeps - Duplicate Dependencies in package.json",
-    (yargs2) => {
-      return yargs2;
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Dupdeps");
-      process.exitCode = dupdeps();
-    }
-  );
+  return args.command(cleanCommand).command(reinstallCommand).command(upCommand).command(updoCommand).command(staticsCommand).command(dupdepsCommand);
 };
 
-// src/xy/xyLintCommands.ts
+// src/xy/lint/cycleCommand.ts
 import chalk42 from "chalk";
+var cycleCommand = {
+  command: "cycle [package]",
+  describe: "Cycle - Check for dependency cycles",
+  builder: (yargs2) => {
+    return packagePositionalParam(yargs2);
+  },
+  handler: async (argv) => {
+    const start = Date.now();
+    if (argv.verbose) console.log("Cycle");
+    process.exitCode = await cycle({ pkg: argv.package });
+    console.log(chalk42.blue(`Finished in ${Date.now() - start}ms`));
+  }
+};
+
+// src/xy/lint/deplintCommand.ts
+import chalk43 from "chalk";
+var deplintCommand = {
+  command: "deplint [package]",
+  describe: "Deplint - Run Deplint",
+  builder: (yargs2) => {
+    return packagePositionalParam(yargs2).option("deps", {
+      alias: "d",
+      default: false,
+      description: "Check dependencies",
+      type: "boolean"
+    }).option("devDeps", {
+      alias: "v",
+      default: false,
+      description: "Check devDependencies",
+      type: "boolean"
+    }).option("peerDeps", {
+      alias: "p",
+      default: false,
+      description: "Check peerDependencies",
+      type: "boolean"
+    }).option("exclude", {
+      alias: "e",
+      description: "Package names to exclude from unused checks (comma-separated or repeated)",
+      type: "array"
+    });
+  },
+  handler: async (argv) => {
+    if (argv.verbose) console.log("Deplint");
+    const start = Date.now();
+    const cliExclude = argv.exclude?.flatMap((v) => String(v).split(",")).map((v) => v.trim()).filter(Boolean);
+    process.exitCode = await deplint({
+      cliExclude,
+      pkg: argv.package,
+      deps: !!argv.deps,
+      devDeps: !!argv.devDeps,
+      peerDeps: !!argv.peerDeps,
+      verbose: !!argv.verbose
+    });
+    console.log(chalk43.blue(`Finished in ${Date.now() - start}ms`));
+  }
+};
+
+// src/xy/lint/fixCommand.ts
+import chalk44 from "chalk";
+var fixCommand = {
+  command: "fix [package]",
+  describe: "Fix - Run Eslint w/fix",
+  builder: (yargs2) => {
+    return packagePositionalParam(yargs2);
+  },
+  handler: (argv) => {
+    const start = Date.now();
+    if (argv.verbose) console.log("Fix");
+    process.exitCode = fix();
+    console.log(chalk44.blue(`Finished in ${Date.now() - start}ms`));
+  }
+};
+
+// src/xy/lint/knipCommand.ts
+import chalk45 from "chalk";
+var knipCommand = {
+  command: "knip",
+  describe: "Knip - Run Knip",
+  builder: (yargs2) => {
+    return packagePositionalParam(yargs2);
+  },
+  handler: (argv) => {
+    if (argv.verbose) console.log("Knip");
+    const start = Date.now();
+    process.exitCode = knip();
+    console.log(chalk45.blue(`Knip finished in ${Date.now() - start}ms`));
+  }
+};
+
+// src/xy/lint/lintCommand.ts
+import chalk46 from "chalk";
+var lintCommand = {
+  command: "lint [package]",
+  describe: "Lint - Run Eslint",
+  builder: (yargs2) => {
+    return packagePositionalParam(yargs2).option("fix", {
+      alias: "f",
+      default: false,
+      description: "Fix fixable issues",
+      type: "boolean"
+    }).option("cache", {
+      alias: "c",
+      default: false,
+      description: "Use caching for performance",
+      type: "boolean"
+    });
+  },
+  handler: (argv) => {
+    if (argv.verbose) console.log("Lint");
+    const start = Date.now();
+    process.exitCode = argv.fix ? fix({
+      pkg: argv.package,
+      cache: argv.cache,
+      verbose: !!argv.verbose
+    }) : lint({
+      pkg: argv.package,
+      cache: argv.cache,
+      verbose: !!argv.verbose
+    });
+    console.log(chalk46.blue(`Finished in ${Date.now() - start}ms`));
+  }
+};
+
+// src/xy/lint/publintCommand.ts
+import chalk47 from "chalk";
+var publintCommand = {
+  command: "publint [package]",
+  describe: "Publint - Run Publint",
+  builder: (yargs2) => {
+    return packagePositionalParam(yargs2);
+  },
+  handler: async (argv) => {
+    if (argv.verbose) console.log("Publint");
+    const start = Date.now();
+    process.exitCode = await publint({ pkg: argv.package, verbose: !!argv.verbose });
+    console.log(chalk47.blue(`Finished in ${Date.now() - start}ms`));
+  }
+};
+
+// src/xy/lint/relintCommand.ts
+import chalk48 from "chalk";
+var relintCommand = {
+  command: "relint [package]",
+  describe: "Relint - Clean & Lint",
+  builder: (yargs2) => {
+    return packagePositionalParam(yargs2);
+  },
+  handler: (argv) => {
+    if (argv.verbose) console.log("Relinting");
+    const start = Date.now();
+    process.exitCode = relint();
+    console.log(chalk48.blue(`Finished in ${Date.now() - start}ms`));
+  }
+};
+
+// src/xy/lint/sonarCommand.ts
+import chalk49 from "chalk";
+var sonarCommand = {
+  command: "sonar",
+  describe: "Sonar - Run Sonar Check",
+  builder: (yargs2) => {
+    return packagePositionalParam(yargs2);
+  },
+  handler: (argv) => {
+    const start = Date.now();
+    if (argv.verbose) console.log("Sonar Check");
+    process.exitCode = sonar();
+    console.log(chalk49.blue(`Finished in ${Date.now() - start}ms`));
+  }
+};
+
+// src/xy/lint/index.ts
 var xyLintCommands = (args) => {
-  return args.command(
-    "cycle [package]",
-    "Cycle - Check for dependency cycles",
-    (yargs2) => {
-      return packagePositionalParam(yargs2);
-    },
-    async (argv) => {
-      const start = Date.now();
-      if (argv.verbose) console.log("Cycle");
-      process.exitCode = await cycle({ pkg: argv.package });
-      console.log(chalk42.blue(`Finished in ${Date.now() - start}ms`));
-    }
-  ).command(
-    "lint [package]",
-    "Lint - Run Eslint",
-    (yargs2) => {
-      return packagePositionalParam(yargs2).option("fix", {
-        alias: "f",
-        default: false,
-        description: "Fix fixable issues",
-        type: "boolean"
-      }).option("cache", {
-        alias: "c",
-        default: false,
-        description: "Use caching for performance",
-        type: "boolean"
-      });
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Lint");
-      const start = Date.now();
-      process.exitCode = argv.fix ? fix({
-        pkg: argv.package,
-        cache: argv.cache,
-        verbose: !!argv.verbose
-      }) : lint({
-        pkg: argv.package,
-        cache: argv.cache,
-        verbose: !!argv.verbose
-      });
-      console.log(chalk42.blue(`Finished in ${Date.now() - start}ms`));
-    }
-  ).command(
-    "deplint [package]",
-    "Deplint - Run Deplint",
-    (yargs2) => {
-      return packagePositionalParam(yargs2).option("deps", {
-        alias: "d",
-        default: false,
-        description: "Check dependencies",
-        type: "boolean"
-      }).option("devDeps", {
-        alias: "v",
-        default: false,
-        description: "Check devDependencies",
-        type: "boolean"
-      }).option("peerDeps", {
-        alias: "p",
-        default: false,
-        description: "Check peerDependencies",
-        type: "boolean"
-      }).option("exclude", {
-        alias: "e",
-        description: "Package names to exclude from unused checks (comma-separated or repeated)",
-        type: "array"
-      });
-    },
-    async (argv) => {
-      if (argv.verbose) console.log("Deplint");
-      const start = Date.now();
-      const cliExclude = argv.exclude?.flatMap((v) => String(v).split(",")).map((v) => v.trim()).filter(Boolean);
-      process.exitCode = await deplint({
-        cliExclude,
-        pkg: argv.package,
-        deps: !!argv.deps,
-        devDeps: !!argv.devDeps,
-        peerDeps: !!argv.peerDeps,
-        verbose: !!argv.verbose
-      });
-      console.log(chalk42.blue(`Finished in ${Date.now() - start}ms`));
-    }
-  ).command(
-    "fix [package]",
-    "Fix - Run Eslint w/fix",
-    (yargs2) => {
-      return packagePositionalParam(yargs2);
-    },
-    (argv) => {
-      const start = Date.now();
-      if (argv.verbose) console.log("Fix");
-      process.exitCode = fix();
-      console.log(chalk42.blue(`Finished in ${Date.now() - start}ms`));
-    }
-  ).command(
-    "relint [package]",
-    "Relint - Clean & Lint",
-    (yargs2) => {
-      return packagePositionalParam(yargs2);
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Relinting");
-      const start = Date.now();
-      process.exitCode = relint();
-      console.log(chalk42.blue(`Finished in ${Date.now() - start}ms`));
-    }
-  ).command(
-    "publint [package]",
-    "Publint - Run Publint",
-    (yargs2) => {
-      return packagePositionalParam(yargs2);
-    },
-    async (argv) => {
-      if (argv.verbose) console.log("Publint");
-      const start = Date.now();
-      process.exitCode = await publint({ pkg: argv.package, verbose: !!argv.verbose });
-      console.log(chalk42.blue(`Finished in ${Date.now() - start}ms`));
-    }
-  ).command(
-    "knip",
-    "Knip - Run Knip",
-    (yargs2) => {
-      return packagePositionalParam(yargs2);
-    },
-    (argv) => {
-      if (argv.verbose) console.log("Knip");
-      const start = Date.now();
-      process.exitCode = knip();
-      console.log(chalk42.blue(`Knip finished in ${Date.now() - start}ms`));
-    }
-  ).command(
-    "sonar",
-    "Sonar - Run Sonar Check",
-    (yargs2) => {
-      return packagePositionalParam(yargs2);
-    },
-    (argv) => {
-      const start = Date.now();
-      if (argv.verbose) console.log("Sonar Check");
-      process.exitCode = sonar();
-      console.log(chalk42.blue(`Finished in ${Date.now() - start}ms`));
-    }
-  );
+  return args.command(cycleCommand).command(lintCommand).command(deplintCommand).command(fixCommand).command(relintCommand).command(publintCommand).command(knipCommand).command(sonarCommand);
 };
 
+// src/xy/xy.ts
+import chalk50 from "chalk";
+
 // src/xy/xyParseOptions.ts
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
@@ -3735,17 +3979,20 @@ var xyParseOptions = () => {
 var xy = async () => {
   const options = xyParseOptions();
   return await xyBuildCommands(xyCommonCommands(xyInstallCommands(xyDeployCommands(xyLintCommands(options))))).demandCommand(1).command("*", "", () => {
-    console.error(chalk43.yellow(`Command not found [${chalk43.magenta(process.argv[2])}]`));
-    console.log(chalk43.gray("Try 'yarn xy --help' for list of commands"));
+    console.error(chalk50.yellow(`Command not found [${chalk50.magenta(process.argv[2])}]`));
+    console.log(chalk50.gray("Try 'yarn xy --help' for list of commands"));
   }).version().help().argv;
 };
 export {
   CROSS_PLATFORM_NEWLINE,
+  DEFAULT_README_BODY,
+  DEFAULT_README_TEMPLATE,
   DuplicateDetector,
   INIT_CWD,
   WINDOWS_NEWLINE_REGEX,
   XYLABS_COMMANDS_PREFIX,
   XYLABS_RULES_PREFIX,
+  applyLogoConfig,
   build,
   bundleDts,
   checkResult,
@@ -3821,6 +4068,7 @@ export {
   readLines,
   readNonEmptyLines,
   readmeGen,
+  readmeInit,
   rebuild,
   recompile,
   recompileAll,
@@ -3829,6 +4077,7 @@ export {
   relint,
   relintAllPackages,
   relintPackage,
+  resolveTemplatePath,
   retest,
   runStepAsync,
   runSteps,
@@ -3837,6 +4086,7 @@ export {
   runXyWithWarning,
   safeExit,
   safeExitAsync,
+  scaffoldTemplate,
   sonar,
   statics,
   test,