@xylabs/ts-scripts-common 7.5.0

package/dist/xy/common/index.mjs

@@ -0,0 +1,1874 @@
+// src/lib/checkResult.ts
+import chalk from "chalk";
+var checkResult = (name, result, level = "error", exitOnFail = false) => {
+  if (result) {
+    const exiting = exitOnFail ? "[Exiting Process]" : "[Continuing]";
+    const chalkFunc = level === "error" ? chalk.red : chalk.yellow;
+    console[level](chalkFunc(`${name} had ${result} failures ${exiting}`));
+    if (exitOnFail) {
+      process.exit(result);
+    }
+  }
+};
+
+// src/lib/claudeMdTemplate.ts
+import {
+  readdirSync,
+  readFileSync,
+  statSync
+} from "fs";
+import { createRequire } from "module";
+import PATH from "path";
+var require2 = createRequire(import.meta.url);
+var packageRoot = PATH.dirname(require2.resolve("@xylabs/ts-scripts-common/package.json"));
+var templatesDir = PATH.resolve(packageRoot, "templates", "claude");
+var XYLABS_RULES_PREFIX = "xylabs-";
+var XYLABS_COMMANDS_PREFIX = "xy-";
+var LEGACY_COMMANDS_PREFIX = "xylabs-";
+var XYLABS_SKILLS_PREFIX = "xylabs-";
+var claudeMdRuleTemplates = () => {
+  const rulesDir = PATH.resolve(templatesDir, "rules");
+  const files = readdirSync(rulesDir).filter((f) => f.startsWith(XYLABS_RULES_PREFIX) && f.endsWith(".md"));
+  const result = {};
+  for (const file of files) {
+    result[file] = readFileSync(PATH.resolve(rulesDir, file), "utf8");
+  }
+  return result;
+};
+var claudeCommandTemplates = () => {
+  const commandsDir = PATH.resolve(templatesDir, "commands");
+  const files = readdirSync(commandsDir).filter((f) => f.startsWith(XYLABS_COMMANDS_PREFIX) && f.endsWith(".md"));
+  const result = {};
+  for (const file of files) {
+    result[file] = readFileSync(PATH.resolve(commandsDir, file), "utf8");
+  }
+  return result;
+};
+var claudeSkillTemplates = () => {
+  const skillsDir = PATH.resolve(templatesDir, "skills");
+  const dirs = readdirSync(skillsDir).filter(
+    (f) => f.startsWith(XYLABS_SKILLS_PREFIX) && statSync(PATH.resolve(skillsDir, f)).isDirectory()
+  );
+  const result = {};
+  for (const dir of dirs) {
+    const dirPath = PATH.resolve(skillsDir, dir);
+    const files = readdirSync(dirPath, { recursive: true, encoding: "utf8" });
+    result[dir] = {};
+    for (const file of files) {
+      if (statSync(PATH.resolve(dirPath, file)).isFile()) {
+        result[dir][file] = readFileSync(PATH.resolve(dirPath, file), "utf8");
+      }
+    }
+  }
+  return result;
+};
+var claudeMdLocalTemplate = () => readFileSync(PATH.resolve(templatesDir, "CLAUDE-local.md"), "utf8");
+
+// src/lib/deleteGlob.ts
+import fs from "fs";
+import { glob } from "glob";
+var deleteGlob = (globPath) => {
+  const files = glob.sync(globPath);
+  for (const file of files) {
+    fs.rmSync(file, { recursive: true, force: true });
+  }
+};
+
+// src/pm/detectPackageManager.ts
+import { existsSync } from "fs";
+function detectPackageManager() {
+  if (existsSync("pnpm-lock.yaml") || existsSync("pnpm-workspace.yaml")) return "pnpm";
+  return "yarn";
+}
+
+// src/pm/registry.ts
+var implementations = /* @__PURE__ */ new Map();
+function getPackageManager(name) {
+  const pmName = name ?? detectPackageManager();
+  const pm = implementations.get(pmName);
+  if (!pm) {
+    throw new Error(
+      `No package manager implementation registered for "${pmName}". Install @xylabs/ts-scripts-${pmName === "yarn" ? "yarn3" : pmName} and ensure it is imported.`
+    );
+  }
+  return pm;
+}
+
+// src/lib/processEx.ts
+import chalk2 from "chalk";
+
+// src/lib/withError.ts
+var withError = (ex, closure, predicate = (ex2) => !!ex2.name && !!ex2.message) => {
+  return predicate(ex) ? closure(ex) : void 0;
+};
+
+// src/lib/withErrnoException.ts
+var withErrnoException = (ex, closure) => {
+  return withError(ex, closure, (ex2) => ex2.errno !== void 0);
+};
+
+// src/lib/processEx.ts
+var processEx = (ex) => {
+  const error = typeof ex === "string" ? new Error(ex) : ex;
+  const exitCode = withErrnoException(error, (error2) => {
+    if (error2.code === "ENOENT") {
+      console.error(chalk2.red(`'${error2.path}' not found.`));
+    } else {
+      console.error(chalk2.red(`Errno: ${error2.code}`));
+    }
+    return error2.errno ?? -1;
+  }) ?? withError(error, (error2) => {
+    console.error(chalk2.red(`${error2.name}: ${error2.message}`));
+    return -1;
+  }) ?? (() => {
+    console.error(chalk2.red(`Unexpected Error: ${JSON.stringify(ex, null, 2)}`));
+    return -1;
+  })();
+  process.exit(process.exitCode ?? exitCode);
+};
+
+// src/lib/safeExit.ts
+var safeExit = (func, exitOnFail = true) => {
+  try {
+    const result = func();
+    if (result && exitOnFail) {
+      process.exit(result);
+    }
+    return result;
+  } catch (ex) {
+    return processEx(ex);
+  }
+};
+
+// src/lib/file/constants.ts
+var WINDOWS_NEWLINE_REGEX = /\r\n/g;
+var CROSS_PLATFORM_NEWLINE = "\n";
+
+// src/lib/file/fileLines.ts
+import {
+  existsSync as existsSync2,
+  readFileSync as readFileSync2,
+  writeFileSync
+} from "fs";
+
+// src/lib/string/empty.ts
+var empty = (value) => value?.trim().length === 0;
+var notEmpty = (value) => !empty(value);
+
+// src/lib/string/union.ts
+var union = (a, b) => /* @__PURE__ */ new Set([...new Set(a), ...new Set(b)]);
+
+// src/lib/file/ReadFileSyncOptions.ts
+var defaultReadFileSyncOptions = { encoding: "utf8" };
+
+// src/lib/file/fileLines.ts
+var readLines = (uri, options = defaultReadFileSyncOptions) => existsSync2(uri) ? readFileSync2(uri, options).replace(WINDOWS_NEWLINE_REGEX, CROSS_PLATFORM_NEWLINE).split(CROSS_PLATFORM_NEWLINE) : [];
+var readNonEmptyLines = (uri, options = defaultReadFileSyncOptions) => readLines(uri, options).filter(notEmpty);
+var writeLines = (uri, lines, options = defaultReadFileSyncOptions) => {
+  const existing = existsSync2(uri) ? readFileSync2(uri, options) : void 0;
+  const desired = lines.join(CROSS_PLATFORM_NEWLINE);
+  if (existing !== desired) writeFileSync(uri, desired, options);
+};
+
+// src/lib/generateIgnoreFiles.ts
+import chalk3 from "chalk";
+
+// src/lib/initCwd.ts
+function INIT_CWD() {
+  if (!process.env.INIT_CWD) console.error("Missing INIT_CWD");
+  return process.env.INIT_CWD;
+}
+
+// src/lib/generateIgnoreFiles.ts
+var localeCompare = (a, b) => a.localeCompare(b);
+var mergeEntries = (a, b) => [...union(a, b)].toSorted(localeCompare);
+var generateIgnoreFiles = (filename2, pkg) => {
+  console.log(chalk3.green(`Generate ${filename2} Files`));
+  const cwd = INIT_CWD() ?? ".";
+  const pm = getPackageManager();
+  const singleWorkspace = pkg ? pm.findWorkspace(pkg) : void 0;
+  const workspaces = singleWorkspace ? [singleWorkspace] : pm.listWorkspaces();
+  const readEntries = (location) => readNonEmptyLines(`${location}/${filename2}`);
+  const writeEntries = (location, entries) => writeLines(`${location}/${filename2}`, entries);
+  const results = workspaces.map(({ location, name }) => {
+    try {
+      writeEntries(location, mergeEntries(readEntries(cwd), readEntries(location)));
+      return 0;
+    } catch (ex) {
+      const error = ex;
+      console.error(`Generate ${filename2} Files [${name}] [${error.message}]`);
+      return 1;
+    }
+  });
+  const succeeded = results.every((result) => result === 0);
+  return succeeded ? 0 : 1;
+};
+
+// src/lib/generateReadmeFiles.ts
+import { execSync } from "child_process";
+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-common/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()] ?? "");
+}
+function generateTypedoc(packageLocation, entryPoints) {
+  const tempDir = PATH2.join(packageLocation, ".temp-typedoc");
+  try {
+    if (!FS.existsSync(tempDir)) {
+      FS.mkdirSync(tempDir, { recursive: true });
+    }
+    const typedocConfig = {
+      disableSources: true,
+      entryPointStrategy: "expand",
+      entryPoints: entryPoints.map((ep) => PATH2.resolve(packageLocation, ep)),
+      excludeExternals: true,
+      excludeInternal: true,
+      excludePrivate: true,
+      githubPages: false,
+      hideBreadcrumbs: true,
+      hideGenerator: true,
+      hidePageTitle: true,
+      out: tempDir,
+      plugin: ["typedoc-plugin-markdown"],
+      readme: "none",
+      skipErrorChecking: true,
+      sort: ["source-order"],
+      theme: "markdown",
+      useCodeBlocks: true
+    };
+    const typedocJsonPath = PATH2.join(tempDir, "typedoc.json");
+    FS.writeFileSync(typedocJsonPath, JSON.stringify(typedocConfig, null, 2));
+    try {
+      execSync(`npx typedoc --options ${typedocJsonPath}`, {
+        cwd: process.cwd(),
+        stdio: ["ignore", "pipe", "pipe"]
+      });
+    } catch {
+      return "";
+    }
+    return consolidateMarkdown(tempDir);
+  } catch {
+    return "";
+  } finally {
+    try {
+      FS.rmSync(tempDir, { force: true, recursive: true });
+    } catch {
+    }
+  }
+}
+function consolidateMarkdown(tempDir) {
+  let consolidated = "## Reference\n\n";
+  const mainReadmePath = PATH2.join(tempDir, "README.md");
+  if (FS.existsSync(mainReadmePath)) {
+    const mainContent = FS.readFileSync(mainReadmePath, "utf8").replace(/^---(.|\n)*?---\n/, "").replace(/^# .+\n/, "").replaceAll(/\]\((.+?)\.md\)/g, "](#$1)");
+    consolidated += mainContent + "\n\n";
+  }
+  consolidated += processDirectory(tempDir);
+  return consolidated.replaceAll(/\n\n\n+/g, "\n\n").replaceAll(/^#### /gm, "### ").replaceAll(/^##### /gm, "#### ").replaceAll(/^###### /gm, "##### ");
+}
+function processDirectory(dir, level = 0) {
+  const indent = "  ".repeat(level);
+  let content = "";
+  try {
+    const items = FS.readdirSync(dir, { withFileTypes: true });
+    for (const item of items) {
+      if (item.isDirectory()) continue;
+      if (item.name === "README.md" || !item.name.endsWith(".md")) continue;
+      const fileContent = FS.readFileSync(PATH2.join(dir, item.name), "utf8").replace(/^---(.|\n)*?---\n/, "");
+      const moduleName = item.name.replace(".md", "");
+      content += `
+
+${indent}### <a id="${moduleName}"></a>${moduleName}
+
+`;
+      content += fileContent.replace(/^# .+\n/, "").replaceAll(/\]\((.+?)\.md\)/g, "](#$1)");
+    }
+    for (const item of items) {
+      if (!item.isDirectory()) continue;
+      if (item.name === "spec" || item.name.includes(".spec")) continue;
+      content += `
+
+${indent}### ${item.name}
+`;
+      content += processDirectory(PATH2.join(dir, item.name), level + 1);
+    }
+  } catch {
+  }
+  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 = false
+}) {
+  console.log(chalk4.green("Generate README Files"));
+  const resolvedTemplatePath = resolveTemplatePath(templatePath);
+  let template;
+  let templateCreated;
+  try {
+    ({ template, created: templateCreated } = await loadOrCreateTemplate(resolvedTemplatePath));
+  } catch {
+    return 1;
+  }
+  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 pm = getPackageManager();
+  const singleWorkspace = pkg && !templateCreated ? pm.findWorkspace(pkg) : void 0;
+  const workspaces = singleWorkspace ? [singleWorkspace] : pm.listWorkspaces();
+  let failed = false;
+  for (const { location, name } of workspaces) {
+    const success = await generateReadmeForWorkspace(location, name, template, defaultBody, typedoc, verbose);
+    if (!success) failed = true;
+  }
+  return failed ? 1 : 0;
+}
+
+// src/lib/gitignoreTemplate.ts
+import { readFileSync as readFileSync4 } from "fs";
+import { createRequire as createRequire3 } from "module";
+import PATH3 from "path";
+var require4 = createRequire3(import.meta.url);
+var packageRoot3 = PATH3.dirname(require4.resolve("@xylabs/ts-scripts-common/package.json"));
+var templatesDir2 = PATH3.resolve(packageRoot3, "templates", "gitignore");
+var gitignoreTemplate = () => readFileSync4(PATH3.resolve(templatesDir2, "template.gitignore"), "utf8");
+
+// 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 } from "child_process";
+import { existsSync as existsSync3 } from "fs";
+import chalk6 from "chalk";
+var runSteps = (name, steps, exitOnFail = true, messages) => {
+  return safeExit(() => {
+    const pkgName = process.env.npm_package_name;
+    console.log(chalk6.green(`${name} [${pkgName}]`));
+    let totalStatus = 0;
+    for (const [i, [command, args, config2]] of steps.entries()) {
+      if (messages?.[i]) {
+        console.log(chalk6.gray(messages?.[i]));
+      }
+      const argList = Array.isArray(args) ? args : args.split(" ");
+      if (command === "node" && !existsSync3(argList[0])) {
+        throw new Error(`File not found [${argList[0]}]`);
+      }
+      const status = spawnSync(command, Array.isArray(args) ? args : args.split(" "), {
+        ...config2,
+        encoding: "utf8",
+        env: { FORCE_COLOR: "3", ...process.env },
+        shell: true,
+        stdio: "inherit"
+      }).status ?? 0;
+      checkResult(name, status, "error", exitOnFail);
+      totalStatus += status ?? 0;
+    }
+    return totalStatus;
+  }, !!exitOnFail);
+};
+
+// src/actions/claude-clean.ts
+import {
+  existsSync as existsSync4,
+  readdirSync as readdirSync2,
+  rmSync,
+  unlinkSync
+} from "fs";
+import PATH4 from "path";
+import chalk7 from "chalk";
+function removeFile(filePath, label) {
+  if (existsSync4(filePath)) {
+    unlinkSync(filePath);
+    console.log(chalk7.yellow(`  Removed ${label}`));
+    return true;
+  }
+  return false;
+}
+function removeDir(dirPath, label) {
+  if (existsSync4(dirPath)) {
+    rmSync(dirPath, { recursive: true });
+    console.log(chalk7.yellow(`  Removed ${label}`));
+    return true;
+  }
+  return false;
+}
+function claudeClean() {
+  console.log(chalk7.green("Clean Claude configuration"));
+  const cwd = INIT_CWD() ?? process.cwd();
+  let removed = 0;
+  const rootFiles = ["CLAUDE.md", "CLAUDE.local.md"];
+  for (const file of rootFiles) {
+    if (removeFile(PATH4.resolve(cwd, file), file)) removed++;
+  }
+  if (removeDir(PATH4.resolve(cwd, ".claude"), ".claude/")) removed++;
+  const packagesDir = PATH4.resolve(cwd, "packages");
+  if (existsSync4(packagesDir)) {
+    const findClaudeFiles = (dir, prefix) => {
+      const entries = readdirSync2(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        const fullPath = PATH4.resolve(dir, entry.name);
+        const label = `${prefix}${entry.name}`;
+        if (entry.isFile() && (entry.name === "CLAUDE.md" || entry.name === "CLAUDE.local.md")) {
+          if (removeFile(fullPath, label)) removed++;
+        } else if (entry.isDirectory() && entry.name === ".claude") {
+          if (removeDir(fullPath, `${label}/`)) removed++;
+        } else if (entry.isDirectory() && entry.name !== "node_modules" && entry.name !== "dist") {
+          findClaudeFiles(fullPath, `${label}/`);
+        }
+      }
+    };
+    findClaudeFiles(packagesDir, "packages/");
+  }
+  if (removed > 0) {
+    console.log(chalk7.green(`  Removed ${removed} item(s)`));
+  } else {
+    console.log(chalk7.gray("  Nothing to clean"));
+  }
+  return 0;
+}
+
+// src/actions/claude-commands.ts
+import {
+  existsSync as existsSync5,
+  mkdirSync,
+  readdirSync as readdirSync3,
+  readFileSync as readFileSync5,
+  unlinkSync as unlinkSync2,
+  writeFileSync as writeFileSync2
+} from "fs";
+import PATH5 from "path";
+import chalk8 from "chalk";
+var syncCommandFiles = (commandsDir) => {
+  const templates = claudeCommandTemplates();
+  const templateNames = new Set(Object.keys(templates));
+  let updated = 0;
+  let created = 0;
+  for (const [filename2, content] of Object.entries(templates)) {
+    const targetPath = PATH5.resolve(commandsDir, filename2);
+    const existing = existsSync5(targetPath) ? readFileSync5(targetPath, "utf8") : void 0;
+    if (existing === content) continue;
+    writeFileSync2(targetPath, content, "utf8");
+    if (existing) {
+      updated++;
+    } else {
+      created++;
+    }
+  }
+  return {
+    created,
+    templateNames,
+    updated
+  };
+};
+var removeStaleCommands = (commandsDir, templateNames) => {
+  const existingCommands = readdirSync3(commandsDir).filter((f) => f.startsWith(XYLABS_COMMANDS_PREFIX) && f.endsWith(".md"));
+  let removed = 0;
+  for (const file of existingCommands) {
+    if (!templateNames.has(file)) {
+      unlinkSync2(PATH5.resolve(commandsDir, file));
+      removed++;
+    }
+  }
+  return removed;
+};
+var removeLegacyCommands = (commandsDir) => {
+  const legacyFiles = readdirSync3(commandsDir).filter((f) => f.startsWith(LEGACY_COMMANDS_PREFIX) && f.endsWith(".md"));
+  for (const file of legacyFiles) {
+    unlinkSync2(PATH5.resolve(commandsDir, file));
+  }
+  return legacyFiles.length;
+};
+var logCommandsResult = (created, updated, removed) => {
+  if (created || updated || removed) {
+    const parts = [
+      created ? `${created} created` : "",
+      updated ? `${updated} updated` : "",
+      removed ? `${removed} removed` : ""
+    ].filter(Boolean);
+    console.log(chalk8.green(`.claude/commands/${XYLABS_COMMANDS_PREFIX}*.md: ${parts.join(", ")}`));
+  } else {
+    console.log(chalk8.gray(`.claude/commands/${XYLABS_COMMANDS_PREFIX}*.md: already up to date`));
+  }
+};
+var claudeCommands = () => {
+  const cwd = INIT_CWD() ?? process.cwd();
+  const commandsDir = PATH5.resolve(cwd, ".claude", "commands");
+  mkdirSync(commandsDir, { recursive: true });
+  const legacy = removeLegacyCommands(commandsDir);
+  const {
+    created,
+    templateNames,
+    updated
+  } = syncCommandFiles(commandsDir);
+  const removed = removeStaleCommands(commandsDir, templateNames);
+  logCommandsResult(created, updated, removed + legacy);
+  return 0;
+};
+
+// src/actions/claude-rules.ts
+import { spawnSync as spawnSync2 } from "child_process";
+import {
+  existsSync as existsSync6,
+  mkdirSync as mkdirSync2,
+  readdirSync as readdirSync4,
+  readFileSync as readFileSync6,
+  unlinkSync as unlinkSync3,
+  writeFileSync as writeFileSync3
+} from "fs";
+import PATH6 from "path";
+import chalk9 from "chalk";
+var syncRuleFiles = (rulesDir) => {
+  const templates = claudeMdRuleTemplates();
+  const templateNames = new Set(Object.keys(templates));
+  let updated = 0;
+  let created = 0;
+  for (const [filename2, content] of Object.entries(templates)) {
+    const targetPath = PATH6.resolve(rulesDir, filename2);
+    const existing = existsSync6(targetPath) ? readFileSync6(targetPath, "utf8") : void 0;
+    if (existing === content) continue;
+    writeFileSync3(targetPath, content, "utf8");
+    if (existing) {
+      updated++;
+    } else {
+      created++;
+    }
+  }
+  return {
+    created,
+    templateNames,
+    updated
+  };
+};
+var removeStaleRules = (rulesDir, templateNames) => {
+  const existingRules = readdirSync4(rulesDir).filter((f) => f.startsWith(XYLABS_RULES_PREFIX) && f.endsWith(".md"));
+  let removed = 0;
+  for (const file of existingRules) {
+    if (!templateNames.has(file)) {
+      unlinkSync3(PATH6.resolve(rulesDir, file));
+      removed++;
+    }
+  }
+  return removed;
+};
+var logRulesResult = (created, updated, removed) => {
+  if (created || updated || removed) {
+    const parts = [
+      created ? `${created} created` : "",
+      updated ? `${updated} updated` : "",
+      removed ? `${removed} removed` : ""
+    ].filter(Boolean);
+    console.log(chalk9.green(`.claude/rules/${XYLABS_RULES_PREFIX}*.md: ${parts.join(", ")}`));
+  } else {
+    console.log(chalk9.gray(`.claude/rules/${XYLABS_RULES_PREFIX}*.md: already up to date`));
+  }
+};
+var ensureProjectClaudeMd = (cwd, force) => {
+  const projectPath = PATH6.resolve(cwd, "CLAUDE.md");
+  if (!existsSync6(projectPath) || force) {
+    if (force && existsSync6(projectPath)) {
+      console.log(chalk9.yellow("Regenerating CLAUDE.md"));
+    }
+    console.log(chalk9.green("Generating CLAUDE.md via claude /init..."));
+    const result = spawnSync2("claude", ["-p", "/init", "--allowedTools", "Read", "Write", "Glob", "Grep"], {
+      cwd,
+      shell: true,
+      stdio: "inherit"
+    });
+    if (result.status !== 0) {
+      console.error(chalk9.red("claude /init failed \u2014 is Claude Code installed?"));
+      return 1;
+    }
+  } else {
+    console.log(chalk9.gray("CLAUDE.md already exists (skipped, use --force to regenerate)"));
+  }
+  return 0;
+};
+var ensureLocalClaudeMd = (cwd) => {
+  const localPath = PATH6.resolve(cwd, "CLAUDE.local.md");
+  if (existsSync6(localPath)) {
+    console.log(chalk9.gray("CLAUDE.local.md already exists (skipped)"));
+  } else {
+    writeFileSync3(localPath, claudeMdLocalTemplate(), "utf8");
+    console.log(chalk9.green("Generated CLAUDE.local.md"));
+  }
+};
+var claudeRules = ({ force } = {}) => {
+  const cwd = INIT_CWD() ?? process.cwd();
+  const rulesDir = PATH6.resolve(cwd, ".claude", "rules");
+  mkdirSync2(rulesDir, { recursive: true });
+  const {
+    created,
+    templateNames,
+    updated
+  } = syncRuleFiles(rulesDir);
+  const removed = removeStaleRules(rulesDir, templateNames);
+  logRulesResult(created, updated, removed);
+  const claudeMdResult = ensureProjectClaudeMd(cwd, force);
+  ensureLocalClaudeMd(cwd);
+  return claudeMdResult ?? 0;
+};
+
+// src/actions/claude-settings.ts
+import {
+  existsSync as existsSync7,
+  mkdirSync as mkdirSync3,
+  writeFileSync as writeFileSync4
+} from "fs";
+import PATH7 from "path";
+import { createInterface as createInterface2 } from "readline";
+import chalk10 from "chalk";
+var DEFAULT_SETTINGS = {
+  permissions: {
+    allow: [
+      "Bash(git *)",
+      "Bash(yarn *)",
+      "Bash(npx *)",
+      "Bash(node *)",
+      "Bash(ls *)",
+      "Bash(mkdir *)",
+      "Bash(cp *)",
+      "Bash(mv *)",
+      "Bash(rm *)",
+      "Bash(cat *)",
+      "Bash(head *)",
+      "Bash(tail *)",
+      "Bash(echo *)",
+      "Bash(pwd)",
+      "Bash(which *)",
+      "Bash(grep *)",
+      "Bash(find *)",
+      "Bash(npm view *)",
+      "Bash(gh *)",
+      "Read",
+      "Edit",
+      "Write",
+      "Glob",
+      "Grep",
+      "Skill"
+    ],
+    deny: [
+      "Bash(git push --force *)",
+      "Bash(git reset --hard *)",
+      "Bash(rm -rf /*)"
+    ]
+  }
+};
+function askConfirmation2(question) {
+  const rl = createInterface2({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+    });
+  });
+}
+async function claudeSettings() {
+  const cwd = INIT_CWD() ?? process.cwd();
+  const claudeDir = PATH7.resolve(cwd, ".claude");
+  const settingsPath = PATH7.resolve(claudeDir, "settings.local.json");
+  mkdirSync3(claudeDir, { recursive: true });
+  if (existsSync7(settingsPath)) {
+    const confirmed = await askConfirmation2(
+      chalk10.yellow(`${settingsPath} already exists. Replace it? (y/N) `)
+    );
+    if (!confirmed) {
+      console.log(chalk10.gray("Skipped \u2014 existing settings.local.json preserved"));
+      return 0;
+    }
+  }
+  writeFileSync4(settingsPath, `${JSON.stringify(DEFAULT_SETTINGS, null, 2)}
+`, "utf8");
+  console.log(chalk10.green("Generated .claude/settings.local.json"));
+  return 0;
+}
+
+// src/actions/claude-skills.ts
+import {
+  existsSync as existsSync8,
+  mkdirSync as mkdirSync4,
+  readdirSync as readdirSync5,
+  readFileSync as readFileSync7,
+  rmSync as rmSync2,
+  statSync as statSync2,
+  writeFileSync as writeFileSync5
+} from "fs";
+import PATH8 from "path";
+import chalk11 from "chalk";
+var syncSkillFiles = (skillsDir) => {
+  const templates = claudeSkillTemplates();
+  const templateNames = new Set(Object.keys(templates));
+  let updated = 0;
+  let created = 0;
+  for (const [skillName, files] of Object.entries(templates)) {
+    const skillDir = PATH8.resolve(skillsDir, skillName);
+    mkdirSync4(skillDir, { recursive: true });
+    for (const [filename2, content] of Object.entries(files)) {
+      const targetPath = PATH8.resolve(skillDir, filename2);
+      mkdirSync4(PATH8.dirname(targetPath), { recursive: true });
+      const existing = existsSync8(targetPath) ? readFileSync7(targetPath, "utf8") : void 0;
+      if (existing === content) continue;
+      writeFileSync5(targetPath, content, "utf8");
+      if (existing) {
+        updated++;
+      } else {
+        created++;
+      }
+    }
+  }
+  return {
+    created,
+    templateNames,
+    updated
+  };
+};
+var removeStaleSkills = (skillsDir, templateNames) => {
+  const existingSkills = readdirSync5(skillsDir).filter(
+    (f) => f.startsWith(XYLABS_SKILLS_PREFIX) && statSync2(PATH8.resolve(skillsDir, f)).isDirectory()
+  );
+  let removed = 0;
+  for (const dir of existingSkills) {
+    if (!templateNames.has(dir)) {
+      rmSync2(PATH8.resolve(skillsDir, dir), { recursive: true });
+      removed++;
+    }
+  }
+  return removed;
+};
+var logSkillsResult = (created, updated, removed) => {
+  if (created || updated || removed) {
+    const parts = [
+      created ? `${created} created` : "",
+      updated ? `${updated} updated` : "",
+      removed ? `${removed} removed` : ""
+    ].filter(Boolean);
+    console.log(chalk11.green(`.claude/skills/${XYLABS_SKILLS_PREFIX}*/: ${parts.join(", ")}`));
+  } else {
+    console.log(chalk11.gray(`.claude/skills/${XYLABS_SKILLS_PREFIX}*/: already up to date`));
+  }
+};
+var claudeSkills = () => {
+  const cwd = INIT_CWD() ?? process.cwd();
+  const skillsDir = PATH8.resolve(cwd, ".claude", "skills");
+  mkdirSync4(skillsDir, { recursive: true });
+  const {
+    created,
+    templateNames,
+    updated
+  } = syncSkillFiles(skillsDir);
+  const removed = removeStaleSkills(skillsDir, templateNames);
+  logSkillsResult(created, updated, removed);
+  return 0;
+};
+
+// src/actions/clean-docs.ts
+import path from "path";
+import chalk12 from "chalk";
+var cleanDocs = () => {
+  const pkgName = process.env.npm_package_name;
+  console.log(chalk12.green(`Cleaning Docs [${pkgName}]`));
+  for (const { location } of getPackageManager().listWorkspaces()) deleteGlob(path.join(location, "docs"));
+  return 0;
+};
+
+// src/actions/dead.ts
+var dead = () => {
+  return runSteps("Dead", [["ts-prune", ["-p", "tsconfig.json"]]]);
+};
+
+// src/actions/gen-docs.ts
+var genDocs = ({ pkg, incremental }) => {
+  return pkg ? genDocsPackage({ pkg }) : genDocsAll({ incremental });
+};
+var genDocsPackage = ({ pkg }) => {
+  const pm = getPackageManager();
+  return runSteps(`GenDocs [${pkg}]`, [pm.runInWorkspace(pkg, "package-gen-docs")]);
+};
+var genDocsAll = ({ incremental }) => {
+  const pm = getPackageManager();
+  return runSteps(`GenDocs [All${incremental ? "-Incremental" : ""}]`, [
+    pm.foreachWorkspace("package-gen-docs", [], { incremental })
+  ]);
+};
+
+// src/actions/gitignore.ts
+import { unlinkSync as unlinkSync4 } from "fs";
+import chalk13 from "chalk";
+var COMMENT_PREFIX = "#";
+var isComment = (line) => line.startsWith(COMMENT_PREFIX);
+var isNegation = (line) => line.startsWith("!");
+function parseTemplateSections(lines) {
+  const sections = [];
+  let current = [];
+  for (const line of lines) {
+    if (isComment(line)) {
+      if (current.length > 0) {
+        sections.push(current);
+      }
+      current = [line];
+    } else {
+      current.push(line);
+    }
+  }
+  if (current.length > 0) {
+    sections.push(current);
+  }
+  return sections;
+}
+function mergeWithTemplate(existing, templateContent) {
+  const templateLines = templateContent.split("\n").filter((line) => line.trim().length > 0);
+  const sections = parseTemplateSections(templateLines);
+  const existingEntries = new Set(existing.filter((line) => !isComment(line)));
+  const templateEntries = new Set(templateLines.filter((line) => !isComment(line)));
+  const customEntries = [...existingEntries].filter((entry) => !templateEntries.has(entry));
+  const result = [];
+  for (const section of sections) {
+    for (const line of section) {
+      result.push(line);
+    }
+    result.push("");
+  }
+  if (customEntries.length > 0) {
+    result.push("# Custom");
+    const sorted = [...union(customEntries, [])].toSorted((a, b) => {
+      if (isNegation(a) && !isNegation(b)) return 1;
+      if (!isNegation(a) && isNegation(b)) return -1;
+      return a.localeCompare(b);
+    });
+    for (const entry of sorted) {
+      result.push(entry);
+    }
+    result.push("");
+  }
+  return result;
+}
+function removePackageGitignores(cwd) {
+  let removed = 0;
+  const workspaces = getPackageManager().listWorkspaces();
+  for (const { location } of workspaces) {
+    if (location === ".") continue;
+    const filePath = `${cwd}/${location}/.gitignore`;
+    try {
+      unlinkSync4(filePath);
+      console.log(chalk13.yellow(`  Removed ${location}/.gitignore`));
+      removed++;
+    } catch {
+    }
+  }
+  return removed;
+}
+function gitignore() {
+  console.log(chalk13.green("Generate .gitignore"));
+  const cwd = INIT_CWD() ?? ".";
+  const gitignorePath = `${cwd}/.gitignore`;
+  try {
+    const templateContent = gitignoreTemplate();
+    const existing = readNonEmptyLines(gitignorePath);
+    const merged = mergeWithTemplate(existing, templateContent);
+    writeLines(gitignorePath, merged);
+    console.log(chalk13.green("  Root .gitignore updated"));
+    const removed = removePackageGitignores(cwd);
+    if (removed > 0) {
+      console.log(chalk13.green(`  Removed ${removed} package .gitignore file(s)`));
+    }
+    return 0;
+  } catch (ex) {
+    const error = ex;
+    console.error(chalk13.red(`Generate .gitignore failed: ${error.message}`));
+    return 1;
+  }
+}
+
+// src/actions/gitlint.ts
+import chalk14 from "chalk";
+import ParseGitConfig from "parse-git-config";
+var gitlint = () => {
+  console.log(`
+Gitlint Start [${process.cwd()}]
+`);
+  let valid = 0;
+  let warnings = 0;
+  const errors = 0;
+  const gitConfig = ParseGitConfig.sync();
+  const warn = (message) => {
+    console.warn(chalk14.yellow(`Warning: ${message}`));
+    warnings++;
+  };
+  if (gitConfig.core.ignorecase) {
+    warn("Please set core.ignorecase to FALSE in .git/config file [run yarn gitlint-fix]");
+  } else {
+    valid++;
+  }
+  if (gitConfig.core.autocrlf === false) {
+    valid++;
+  } else {
+    warn("Please set core.autocrlf to FALSE in .git/config file [run yarn gitlint-fix]");
+  }
+  if (gitConfig.core.eol === "lf") {
+    valid++;
+  } else {
+    warn('Please set core.eol to "lf" in .git/config file [run yarn gitlint-fix]');
+  }
+  const resultMessages = [];
+  if (valid > 0) {
+    resultMessages.push(chalk14.green(`Passed: ${valid}`));
+  }
+  if (warnings > 0) {
+    resultMessages.push(chalk14.yellow(`Warnings: ${warnings}`));
+  }
+  if (errors > 0) {
+    resultMessages.push(chalk14.red(` Errors: ${errors}`));
+  }
+  console.warn(`Gitlint Finish [ ${resultMessages.join(" | ")} ]
+`);
+  return warnings + errors === 0 ? 1 : 0;
+};
+
+// src/actions/gitlint-fix.ts
+import { execSync as execSync2 } from "child_process";
+import chalk15 from "chalk";
+import ParseGitConfig2 from "parse-git-config";
+var gitlintFix = () => {
+  console.log(`
+Gitlint Fix Start [${process.cwd()}]
+`);
+  const gitConfig = ParseGitConfig2.sync();
+  if (gitConfig.core.ignorecase) {
+    execSync2("git config core.ignorecase false", { stdio: "inherit" });
+    console.warn(chalk15.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(chalk15.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(chalk15.yellow('\nGitlint Fix: Updated core.eol to be "lf"\n'));
+  }
+  return 1;
+};
+
+// src/actions/license.ts
+import chalk16 from "chalk";
+import { init } from "license-checker";
+var license = async (pkg) => {
+  const workspaces = getPackageManager().listWorkspaces();
+  const workspaceList = workspaces.filter(({ name }) => {
+    return pkg === void 0 || name === pkg;
+  });
+  const exclude = /* @__PURE__ */ new Set([
+    "MIT",
+    "MIT*",
+    "ISC",
+    "Apache-2.0",
+    "BSD",
+    "BSD*",
+    "BSD-2-Clause",
+    "BSD-3-Clause",
+    "CC-BY-4.0",
+    "Unlicense",
+    "CC-BY-3.0",
+    "CC0-1.0",
+    "LGPL-3.0-only",
+    "LGPL-3.0",
+    "LGPL-3.0-or-later",
+    "Python-2.0"
+  ]);
+  console.log(chalk16.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(chalk16.red(`License Checker [${name}] Error`));
+            console.error(chalk16.gray(error));
+            console.log("\n");
+            resolve(1);
+          } else {
+            console.log(chalk16.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];
+              for (let license2 of licenses) {
+                if (license2) {
+                  const processedLicense = license2[0] === "(" && license2.at(-1) === ")" ? license2.slice(1, -2) : license2;
+                  const orLicenses = processedLicense.split(" OR ");
+                  let orLicenseFound = false;
+                  for (const orLicense of orLicenses) {
+                    if (exclude.has(orLicense)) {
+                      orLicenseFound = true;
+                    }
+                  }
+                  if (!orLicenseFound) {
+                    count++;
+                    console.warn(chalk16.yellow(`${name2}: Package License not allowed [${license2}]`));
+                  }
+                }
+              }
+            }
+            console.log("\n");
+            resolve(count);
+          }
+        });
+      });
+    })
+  )).reduce((prev, value) => prev || value, 0);
+};
+
+// src/actions/npmignore-gen.ts
+var filename = ".npmignore";
+var npmignoreGen = (pkg) => generateIgnoreFiles(filename, pkg);
+
+// src/actions/packman/convert.ts
+import {
+  existsSync as existsSync11,
+  readdirSync as readdirSync6,
+  readFileSync as readFileSync10,
+  statSync as statSync3
+} from "fs";
+import PATH11 from "path";
+import chalk19 from "chalk";
+
+// src/actions/packman/convertToPnpm.ts
+import {
+  existsSync as existsSync9,
+  mkdirSync as mkdirSync5,
+  readFileSync as readFileSync8,
+  rmSync as rmSync3,
+  writeFileSync as writeFileSync6
+} from "fs";
+import PATH9 from "path";
+import chalk17 from "chalk";
+
+// src/actions/packman/rewriteScripts.ts
+function rewriteYarnToPnpm(script) {
+  let result = script;
+  result = result.replaceAll(/\byarn workspace (\S+) run /g, "pnpm --filter $1 run ");
+  result = result.replaceAll(/\byarn workspace (\S+) (package-\S+)/g, "pnpm --filter $1 run $2");
+  result = result.replaceAll(/\byarn workspaces foreach\s+(?:[^\s]*\s+)*run /g, "pnpm -r run ");
+  result = result.replaceAll(/\byarn workspaces foreach --all version (\S+) --deferred/g, "pnpm -r exec npm version $1 --no-git-tag-version");
+  result = result.replaceAll(/\byarn version apply --all/g, 'echo "versions applied"');
+  result = result.replaceAll(/\byarn xy\b/g, "pnpm xy");
+  result = result.replaceAll(/\byarn add\b/g, "pnpm add");
+  result = result.replaceAll(/\byarn remove\b/g, "pnpm remove");
+  result = result.replaceAll(/\byarn install\b/g, "pnpm install");
+  result = result.replaceAll(/\byarn dedupe\b/g, "pnpm dedupe");
+  result = result.replaceAll(/\byarn outdated\b/g, "pnpm outdated");
+  result = result.replaceAll(/\byarn run\b/g, "pnpm run");
+  result = result.replaceAll(/\byarn rimraf\b/g, "rimraf");
+  result = result.replaceAll(/\byarn npm\b/g, "npm");
+  result = result.replaceAll(/\byarn\b(?![@/.])/g, "pnpm");
+  return result;
+}
+function rewritePnpmToYarn(script) {
+  let result = script;
+  result = result.replaceAll(/\bpnpm --filter (\S+) run /g, "yarn workspace $1 run ");
+  result = result.replaceAll(/\bpnpm -r run /g, "yarn workspaces foreach -Apt run ");
+  result = result.replaceAll(/\bpnpm -r exec npm version (\S+) --no-git-tag-version/g, "yarn workspaces foreach --all version $1 --deferred");
+  result = result.replaceAll(/\bpnpm xy\b/g, "yarn xy");
+  result = result.replaceAll(/\bpnpm add\b/g, "yarn add");
+  result = result.replaceAll(/\bpnpm remove\b/g, "yarn remove");
+  result = result.replaceAll(/\bpnpm install\b/g, "yarn install");
+  result = result.replaceAll(/\bpnpm dedupe\b/g, "yarn dedupe");
+  result = result.replaceAll(/\bpnpm outdated\b/g, "yarn outdated");
+  result = result.replaceAll(/\bpnpm run\b/g, "yarn run");
+  result = result.replaceAll(/\bpnpm\b(?![@/.])/g, "yarn");
+  return result;
+}
+function rewriteScript(script, direction) {
+  return direction === "yarn-to-pnpm" ? rewriteYarnToPnpm(script) : rewritePnpmToYarn(script);
+}
+function rewriteScriptsInPackageJson(pkg, direction) {
+  const scripts = pkg.scripts;
+  if (!scripts) return pkg;
+  const rewritten = {};
+  for (const [name, script] of Object.entries(scripts)) {
+    rewritten[name] = rewriteScript(script, direction);
+  }
+  return { ...pkg, scripts: rewritten };
+}
+
+// src/actions/packman/convertToPnpm.ts
+var PNPM_VERSION = "10.12.1";
+function createPnpmWorkspaceYaml(cwd, workspacePatterns) {
+  const lines = ["packages:"];
+  for (const pattern of workspacePatterns) {
+    lines.push(`  - '${pattern}'`);
+  }
+  writeFileSync6(PATH9.join(cwd, "pnpm-workspace.yaml"), lines.join("\n") + "\n", "utf8");
+  console.log(chalk17.green("  Created pnpm-workspace.yaml"));
+}
+function updateRootPackageJson(cwd) {
+  const pkgPath = PATH9.join(cwd, "package.json");
+  const pkg = JSON.parse(readFileSync8(pkgPath, "utf8"));
+  const workspacePatterns = pkg.workspaces ?? [];
+  delete pkg.workspaces;
+  pkg.packageManager = `pnpm@${PNPM_VERSION}`;
+  const updated = rewriteScriptsInPackageJson(pkg, "yarn-to-pnpm");
+  writeFileSync6(pkgPath, JSON.stringify(updated, null, 2) + "\n", "utf8");
+  console.log(chalk17.green("  Updated root package.json"));
+  return workspacePatterns;
+}
+function updateGitignore(cwd) {
+  const gitignorePath = PATH9.join(cwd, ".gitignore");
+  if (!existsSync9(gitignorePath)) return;
+  let content = readFileSync8(gitignorePath, "utf8");
+  const yarnLines = [
+    ".pnp.*",
+    ".pnp",
+    ".yarn/*",
+    "!.yarn/patches",
+    "!.yarn/plugins",
+    "!.yarn/releases",
+    "!.yarn/sdks",
+    "!.yarn/versions"
+  ];
+  for (const line of yarnLines) {
+    content = content.replaceAll(new RegExp(String.raw`^${line.replaceAll(".", String.raw`\.`).replaceAll("*", String.raw`\*`).replaceAll("!", String.raw`\!`)}\s*$`, "gm"), "");
+  }
+  content = content.replaceAll(/\n{3,}/g, "\n\n");
+  writeFileSync6(gitignorePath, content, "utf8");
+  console.log(chalk17.green("  Updated .gitignore"));
+}
+function deleteYarnArtifacts(cwd) {
+  const yarnLock = PATH9.join(cwd, "yarn.lock");
+  const yarnrc = PATH9.join(cwd, ".yarnrc.yml");
+  const yarnDir = PATH9.join(cwd, ".yarn");
+  if (existsSync9(yarnLock)) {
+    rmSync3(yarnLock);
+    console.log(chalk17.gray("  Deleted yarn.lock"));
+  }
+  if (existsSync9(yarnrc)) {
+    rmSync3(yarnrc);
+    console.log(chalk17.gray("  Deleted .yarnrc.yml"));
+  }
+  if (existsSync9(yarnDir)) {
+    rmSync3(yarnDir, { force: true, recursive: true });
+    console.log(chalk17.gray("  Deleted .yarn/"));
+  }
+}
+function createNpmrc(cwd) {
+  const npmrcPath = PATH9.join(cwd, ".npmrc");
+  if (existsSync9(npmrcPath)) return;
+  mkdirSync5(PATH9.dirname(npmrcPath), { recursive: true });
+  writeFileSync6(npmrcPath, "", "utf8");
+  console.log(chalk17.green("  Created .npmrc"));
+}
+function convertToPnpm(cwd, workspacePackageJsonPaths) {
+  console.log(chalk17.blue("\nConverting to pnpm...\n"));
+  const workspacePatterns = updateRootPackageJson(cwd);
+  createPnpmWorkspaceYaml(cwd, workspacePatterns);
+  for (const pkgPath of workspacePackageJsonPaths) {
+    const fullPath = PATH9.resolve(cwd, pkgPath, "package.json");
+    if (!existsSync9(fullPath)) continue;
+    const pkg = JSON.parse(readFileSync8(fullPath, "utf8"));
+    const updated = rewriteScriptsInPackageJson(pkg, "yarn-to-pnpm");
+    if (JSON.stringify(pkg) !== JSON.stringify(updated)) {
+      writeFileSync6(fullPath, JSON.stringify(updated, null, 2) + "\n", "utf8");
+    }
+  }
+  console.log(chalk17.green(`  Rewrote scripts in ${workspacePackageJsonPaths.length} workspace package(s)`));
+  updateGitignore(cwd);
+  createNpmrc(cwd);
+  deleteYarnArtifacts(cwd);
+  console.log(chalk17.blue("\nConversion complete. Run `pnpm install` to generate pnpm-lock.yaml.\n"));
+  return 0;
+}
+
+// src/actions/packman/convertToYarn.ts
+import {
+  existsSync as existsSync10,
+  readFileSync as readFileSync9,
+  rmSync as rmSync4,
+  writeFileSync as writeFileSync7
+} from "fs";
+import PATH10 from "path";
+import chalk18 from "chalk";
+var YARN_VERSION = "4.13.0";
+var YARNRC_TEMPLATE = `compressionLevel: mixed
+
+enableGlobalCache: true
+
+enableInlineBuilds: true
+
+nmHoistingLimits: none
+
+nodeLinker: node-modules
+`;
+var YARN_GITIGNORE_ENTRIES = `
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+`;
+function readPnpmWorkspacePatterns(cwd) {
+  const wsPath = PATH10.join(cwd, "pnpm-workspace.yaml");
+  if (!existsSync10(wsPath)) return [];
+  const content = readFileSync9(wsPath, "utf8");
+  const patterns = [];
+  const lines = content.split("\n");
+  let inPackages = false;
+  for (const line of lines) {
+    if (line.trim() === "packages:") {
+      inPackages = true;
+      continue;
+    }
+    if (inPackages && /^\s+-\s+/.test(line)) {
+      const pattern = line.replace(/^\s+-\s+/, "").replaceAll(/['"]/g, "").trim();
+      if (pattern) patterns.push(pattern);
+    } else if (inPackages && !/^\s/.test(line) && line.trim()) {
+      inPackages = false;
+    }
+  }
+  return patterns;
+}
+function updateRootPackageJson2(cwd, workspacePatterns) {
+  const pkgPath = PATH10.join(cwd, "package.json");
+  const pkg = JSON.parse(readFileSync9(pkgPath, "utf8"));
+  pkg.workspaces = workspacePatterns;
+  pkg.packageManager = `yarn@${YARN_VERSION}`;
+  const updated = rewriteScriptsInPackageJson(pkg, "pnpm-to-yarn");
+  writeFileSync7(pkgPath, JSON.stringify(updated, null, 2) + "\n", "utf8");
+  console.log(chalk18.green("  Updated root package.json"));
+}
+function updateGitignore2(cwd) {
+  const gitignorePath = PATH10.join(cwd, ".gitignore");
+  let content = existsSync10(gitignorePath) ? readFileSync9(gitignorePath, "utf8") : "";
+  if (!content.includes(".yarn/*")) {
+    content = content.trimEnd() + "\n" + YARN_GITIGNORE_ENTRIES;
+  }
+  writeFileSync7(gitignorePath, content, "utf8");
+  console.log(chalk18.green("  Updated .gitignore"));
+}
+function deletePnpmArtifacts(cwd) {
+  const lockfile = PATH10.join(cwd, "pnpm-lock.yaml");
+  const workspaceYaml = PATH10.join(cwd, "pnpm-workspace.yaml");
+  const npmrc = PATH10.join(cwd, ".npmrc");
+  if (existsSync10(lockfile)) {
+    rmSync4(lockfile);
+    console.log(chalk18.gray("  Deleted pnpm-lock.yaml"));
+  }
+  if (existsSync10(workspaceYaml)) {
+    rmSync4(workspaceYaml);
+    console.log(chalk18.gray("  Deleted pnpm-workspace.yaml"));
+  }
+  if (existsSync10(npmrc)) {
+    const content = readFileSync9(npmrc, "utf8");
+    if (content.trim() === "" || content.includes("shamefully-hoist") || content.includes("node-linker")) {
+      rmSync4(npmrc);
+      console.log(chalk18.gray("  Deleted .npmrc"));
+    }
+  }
+}
+function createYarnrc(cwd) {
+  const yarnrcPath = PATH10.join(cwd, ".yarnrc.yml");
+  if (existsSync10(yarnrcPath)) return;
+  writeFileSync7(yarnrcPath, YARNRC_TEMPLATE, "utf8");
+  console.log(chalk18.green("  Created .yarnrc.yml"));
+}
+function convertToYarn(cwd, workspacePackageJsonPaths) {
+  console.log(chalk18.blue("\nConverting to yarn...\n"));
+  const workspacePatterns = readPnpmWorkspacePatterns(cwd);
+  if (workspacePatterns.length === 0) {
+    console.warn(chalk18.yellow("  No workspace patterns found in pnpm-workspace.yaml"));
+  }
+  updateRootPackageJson2(cwd, workspacePatterns);
+  for (const pkgPath of workspacePackageJsonPaths) {
+    const fullPath = PATH10.resolve(cwd, pkgPath, "package.json");
+    if (!existsSync10(fullPath)) continue;
+    const pkg = JSON.parse(readFileSync9(fullPath, "utf8"));
+    const updated = rewriteScriptsInPackageJson(pkg, "pnpm-to-yarn");
+    if (JSON.stringify(pkg) !== JSON.stringify(updated)) {
+      writeFileSync7(fullPath, JSON.stringify(updated, null, 2) + "\n", "utf8");
+    }
+  }
+  console.log(chalk18.green(`  Rewrote scripts in ${workspacePackageJsonPaths.length} workspace package(s)`));
+  updateGitignore2(cwd);
+  createYarnrc(cwd);
+  deletePnpmArtifacts(cwd);
+  console.log(chalk18.blue("\nConversion complete. Run `corepack enable yarn && yarn set version stable && yarn install` to finish setup.\n"));
+  return 0;
+}
+
+// src/actions/packman/convert.ts
+function detectCurrentPM(cwd) {
+  if (existsSync11(PATH11.join(cwd, "pnpm-lock.yaml")) || existsSync11(PATH11.join(cwd, "pnpm-workspace.yaml"))) {
+    return "pnpm";
+  }
+  if (existsSync11(PATH11.join(cwd, "yarn.lock")) || existsSync11(PATH11.join(cwd, ".yarnrc.yml"))) {
+    return "yarn";
+  }
+  return "unknown";
+}
+function findWorkspacePackagePaths(cwd) {
+  const pkgPath = PATH11.join(cwd, "package.json");
+  const pkg = JSON.parse(readFileSync10(pkgPath, "utf8"));
+  let patterns = pkg.workspaces ?? [];
+  if (patterns.length === 0) {
+    const wsPath = PATH11.join(cwd, "pnpm-workspace.yaml");
+    if (existsSync11(wsPath)) {
+      const content = readFileSync10(wsPath, "utf8");
+      const lines = content.split("\n");
+      let inPackages = false;
+      for (const line of lines) {
+        if (line.trim() === "packages:") {
+          inPackages = true;
+          continue;
+        }
+        if (inPackages && /^\s+-\s+/.test(line)) {
+          const pattern = line.replace(/^\s+-\s+/, "").replaceAll(/['"]/g, "").trim();
+          if (pattern) patterns.push(pattern);
+        } else if (inPackages && !/^\s/.test(line) && line.trim()) {
+          inPackages = false;
+        }
+      }
+    }
+  }
+  const dirs = [];
+  for (const pattern of patterns) {
+    const resolved = resolveWorkspaceGlob(cwd, pattern);
+    dirs.push(...resolved);
+  }
+  return dirs;
+}
+function resolveWorkspaceGlob(cwd, pattern) {
+  const parts = pattern.split("/");
+  return walkGlob(cwd, parts, "");
+}
+function walkGlob(basePath, parts, currentPath) {
+  if (parts.length === 0) {
+    const fullPath = PATH11.join(basePath, currentPath);
+    if (existsSync11(PATH11.join(fullPath, "package.json"))) {
+      return [currentPath];
+    }
+    return [];
+  }
+  const [part, ...rest] = parts;
+  const dirPath = PATH11.join(basePath, currentPath);
+  if (!existsSync11(dirPath) || !statSync3(dirPath).isDirectory()) {
+    return [];
+  }
+  if (part === "*" || part === "**") {
+    const entries = readdirSync6(dirPath, { withFileTypes: true }).filter((e) => e.isDirectory() && !e.name.startsWith(".") && e.name !== "node_modules" && e.name !== "dist");
+    const results = [];
+    if (part === "**") {
+      results.push(...walkGlob(basePath, rest, currentPath));
+    }
+    for (const entry of entries) {
+      const subPath2 = currentPath ? `${currentPath}/${entry.name}` : entry.name;
+      if (part === "**") {
+        results.push(
+          ...walkGlob(basePath, rest, subPath2),
+          ...walkGlob(basePath, parts, subPath2)
+        );
+      } else {
+        results.push(...walkGlob(basePath, rest, subPath2));
+      }
+    }
+    return results;
+  }
+  const subPath = currentPath ? `${currentPath}/${part}` : part;
+  return walkGlob(basePath, rest, subPath);
+}
+function convert({ target, verbose }) {
+  const validTargets = ["pnpm", "yarn"];
+  if (!validTargets.includes(target)) {
+    console.error(chalk19.red(`Invalid target "${target}". Must be one of: ${validTargets.join(", ")}`));
+    return 1;
+  }
+  const cwd = process.cwd();
+  const currentPM = detectCurrentPM(cwd);
+  if (verbose) {
+    console.log(chalk19.gray(`Current package manager: ${currentPM}`));
+    console.log(chalk19.gray(`Target package manager: ${target}`));
+  }
+  if (currentPM === target) {
+    console.error(chalk19.red(`Already using ${target}. No conversion needed.`));
+    return 1;
+  }
+  if (currentPM === "unknown") {
+    console.error(chalk19.red("Could not detect current package manager. No yarn.lock or pnpm-lock.yaml found."));
+    return 1;
+  }
+  const workspacePaths = findWorkspacePackagePaths(cwd);
+  if (verbose) {
+    console.log(chalk19.gray(`Found ${workspacePaths.length} workspace packages`));
+  }
+  if (target === "pnpm") {
+    return convertToPnpm(cwd, workspacePaths);
+  }
+  return convertToYarn(cwd, workspacePaths);
+}
+
+// src/actions/readme-gen.ts
+async function readmeGen({
+  pkg,
+  templatePath,
+  typedoc,
+  verbose
+}) {
+  const config2 = await loadConfig();
+  return await generateReadmeFiles({
+    logoLinkUrl: config2.readme?.logoLinkUrl,
+    logoUrl: config2.readme?.logoUrl,
+    pkg,
+    templatePath,
+    typedoc,
+    verbose
+  });
+}
+
+// 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 = ({ target } = {}) => {
+  const pm = getPackageManager();
+  if (target && pm.findWorkspace(target)) {
+    return runSteps(`Re-Test [${target}]`, [
+      pm.runInWorkspace(target, "vitest", ["--clearCache"]),
+      pm.runInWorkspace(target, "vitest", ["."])
+    ]);
+  }
+  const path2 = target ?? ".";
+  return runSteps("Re-Test", [
+    ["vitest", ["--clearCache"]],
+    ["vitest", [path2]]
+  ]);
+};
+
+// src/actions/test.ts
+var test = ({ target } = {}) => {
+  const pm = getPackageManager();
+  if (target && pm.findWorkspace(target)) {
+    return runSteps(`Test [${target}]`, [pm.runInWorkspace(target, "vitest", ["."])]);
+  }
+  const path2 = target ?? ".";
+  return runSteps("Test", [["vitest", [path2]]]);
+};
+
+// src/xy/common/claude/cleanCommand.ts
+var cleanCommand = {
+  command: "clean",
+  describe: "Remove all Claude configuration files from the repo",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Claude Clean");
+    process.exitCode = claudeClean();
+  }
+};
+
+// 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/skillsCommand.ts
+var skillsCommand = {
+  builder: (yargs) => yargs,
+  command: "skills",
+  describe: "Sync XY Labs standard Claude skills to .claude/skills/",
+  handler: (argv) => {
+    if (argv.verbose) console.log("Claude Skills");
+    process.exitCode = claudeSkills();
+  }
+};
+
+// src/xy/common/claude/index.ts
+var claudeCommand = {
+  builder: (yargs) => {
+    return yargs.command(cleanCommand).command(commandsCommand).command(initCommand).command(rulesCommand).command(settingsCommand).command(skillsCommand).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/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/gitignoreCommand.ts
+var gitignoreCommand = {
+  command: "gitignore",
+  describe: "GitIgnore - Generate root .gitignore and remove package .gitignore files",
+  handler: (argv) => {
+    if (argv.verbose) console.log("GitIgnore");
+    process.exitCode = gitignore();
+  }
+};
+
+// 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/packmanCommand.ts
+var convertCommand = {
+  command: "convert <target>",
+  describe: "Convert repo to a different package manager (pnpm or yarn)",
+  builder: (yargs) => {
+    return yargs.positional("target", {
+      choices: ["pnpm", "yarn"],
+      describe: "Target package manager",
+      type: "string"
+    });
+  },
+  handler: (argv) => {
+    process.exitCode = convert({
+      target: argv.target,
+      verbose: !!argv.verbose
+    });
+  }
+};
+var packmanCommand = {
+  builder: (yargs) => {
+    return yargs.command(convertCommand).demandCommand(1, "Please specify a packman subcommand");
+  },
+  command: "packman",
+  describe: "Package Manager - Conversion utilities",
+  handler: () => {
+  }
+};
+
+// 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 [target]",
+  describe: "Re-Test - Run Vitest Tests with cleaned cache",
+  builder: (yargs) => {
+    return yargs.positional("target", { describe: "Package name or file/folder path to test" });
+  },
+  handler: (argv) => {
+    if (argv.verbose) console.log(`Re-Testing: ${argv.target ?? "all"}`);
+    process.exitCode = retest({ target: argv.target });
+  }
+};
+
+// src/xy/common/testCommand.ts
+var testCommand = {
+  command: "test [target]",
+  describe: "Test - Run Vitest Tests",
+  builder: (yargs) => {
+    return yargs.positional("target", { describe: "Package name or file/folder path to test" });
+  },
+  handler: (argv) => {
+    if (argv.verbose) console.log(`Testing: ${argv.target ?? "all"}`);
+    process.exitCode = test({ target: argv.target });
+  }
+};
+
+// src/xy/common/index.ts
+var xyCommonCommands = (args) => {
+  return args.command(claudeCommand).command(licenseCommand).command(deadCommand).command(genDocsCommand).command(cleanDocsCommand).command(gitlintCommand).command(gitignoreCommand).command(npmignoreGenCommand).command(packmanCommand).command(readmeCommand).command(retestCommand).command(testCommand);
+};
+export {
+  xyCommonCommands
+};
+//# sourceMappingURL=index.mjs.map