@xylabs/ts-scripts-yarn3 7.4.18 → 7.4.20

package/dist/lib/claudeMdTemplate.mjs

@@ -1,12 +1,17 @@
 // src/lib/claudeMdTemplate.ts
-import { readdirSync, readFileSync } from "fs";
+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-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 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"));
@@ -25,12 +30,32 @@ var claudeCommandTemplates = () => {
   }
   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 claudeMdProjectTemplate = () => readFileSync(PATH.resolve(templatesDir, "CLAUDE-project.md"), "utf8");
 export {
   XYLABS_COMMANDS_PREFIX,
   XYLABS_RULES_PREFIX,
+  XYLABS_SKILLS_PREFIX,
   claudeCommandTemplates,
   claudeMdProjectTemplate,
-  claudeMdRuleTemplates
+  claudeMdRuleTemplates,
+  claudeSkillTemplates
 };
 //# sourceMappingURL=claudeMdTemplate.mjs.map

package/dist/lib/claudeMdTemplate.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/claudeMdTemplate.ts"],"sourcesContent":["import { readdirSync, readFileSync } from 'node:fs'\nimport { createRequire } from 'node:module'\nimport PATH from 'node:path'\n\nconst require = createRequire(import.meta.url)\nconst packageRoot = PATH.dirname(require.resolve('@xylabs/ts-scripts-yarn3/package.json'))\nconst templatesDir = PATH.resolve(packageRoot, 'templates')\n\nexport const XYLABS_RULES_PREFIX = 'xylabs-'\nexport const XYLABS_COMMANDS_PREFIX = 'xylabs-'\n\nexport const claudeMdRuleTemplates = (): Record<string, string> => {\n  const rulesDir = PATH.resolve(templatesDir, 'rules')\n  const files = readdirSync(rulesDir).filter(f => f.startsWith(XYLABS_RULES_PREFIX) && f.endsWith('.md'))\n  const result: Record<string, string> = {}\n  for (const file of files) {\n    result[file] = readFileSync(PATH.resolve(rulesDir, file), 'utf8')\n  }\n  return result\n}\n\nexport const claudeCommandTemplates = (): Record<string, string> => {\n  const commandsDir = PATH.resolve(templatesDir, 'commands')\n  const files = readdirSync(commandsDir).filter(f => f.startsWith(XYLABS_COMMANDS_PREFIX) && f.endsWith('.md'))\n  const result: Record<string, string> = {}\n  for (const file of files) {\n    result[file] = readFileSync(PATH.resolve(commandsDir, file), 'utf8')\n  }\n  return result\n}\n\nexport const claudeMdProjectTemplate = (): string =>\n  readFileSync(PATH.resolve(templatesDir, 'CLAUDE-project.md'), 'utf8')\n"],"mappings":";AAAA,SAAS,aAAa,oBAAoB;AAC1C,SAAS,qBAAqB;AAC9B,OAAO,UAAU;AAEjB,IAAMA,WAAU,cAAc,YAAY,GAAG;AAC7C,IAAM,cAAc,KAAK,QAAQA,SAAQ,QAAQ,uCAAuC,CAAC;AACzF,IAAM,eAAe,KAAK,QAAQ,aAAa,WAAW;AAEnD,IAAM,sBAAsB;AAC5B,IAAM,yBAAyB;AAE/B,IAAM,wBAAwB,MAA8B;AACjE,QAAM,WAAW,KAAK,QAAQ,cAAc,OAAO;AACnD,QAAM,QAAQ,YAAY,QAAQ,EAAE,OAAO,OAAK,EAAE,WAAW,mBAAmB,KAAK,EAAE,SAAS,KAAK,CAAC;AACtG,QAAM,SAAiC,CAAC;AACxC,aAAW,QAAQ,OAAO;AACxB,WAAO,IAAI,IAAI,aAAa,KAAK,QAAQ,UAAU,IAAI,GAAG,MAAM;AAAA,EAClE;AACA,SAAO;AACT;AAEO,IAAM,yBAAyB,MAA8B;AAClE,QAAM,cAAc,KAAK,QAAQ,cAAc,UAAU;AACzD,QAAM,QAAQ,YAAY,WAAW,EAAE,OAAO,OAAK,EAAE,WAAW,sBAAsB,KAAK,EAAE,SAAS,KAAK,CAAC;AAC5G,QAAM,SAAiC,CAAC;AACxC,aAAW,QAAQ,OAAO;AACxB,WAAO,IAAI,IAAI,aAAa,KAAK,QAAQ,aAAa,IAAI,GAAG,MAAM;AAAA,EACrE;AACA,SAAO;AACT;AAEO,IAAM,0BAA0B,MACrC,aAAa,KAAK,QAAQ,cAAc,mBAAmB,GAAG,MAAM;","names":["require"]}
+{"version":3,"sources":["../../src/lib/claudeMdTemplate.ts"],"sourcesContent":["import {\n  readdirSync, readFileSync, statSync,\n} from 'node:fs'\nimport { createRequire } from 'node:module'\nimport PATH from 'node:path'\n\nconst require = createRequire(import.meta.url)\nconst packageRoot = PATH.dirname(require.resolve('@xylabs/ts-scripts-yarn3/package.json'))\nconst templatesDir = PATH.resolve(packageRoot, 'templates', 'claude')\n\nexport const XYLABS_RULES_PREFIX = 'xylabs-'\nexport const XYLABS_COMMANDS_PREFIX = 'xylabs-'\nexport const XYLABS_SKILLS_PREFIX = 'xylabs-'\n\nexport const claudeMdRuleTemplates = (): Record<string, string> => {\n  const rulesDir = PATH.resolve(templatesDir, 'rules')\n  const files = readdirSync(rulesDir).filter(f => f.startsWith(XYLABS_RULES_PREFIX) && f.endsWith('.md'))\n  const result: Record<string, string> = {}\n  for (const file of files) {\n    result[file] = readFileSync(PATH.resolve(rulesDir, file), 'utf8')\n  }\n  return result\n}\n\nexport const claudeCommandTemplates = (): Record<string, string> => {\n  const commandsDir = PATH.resolve(templatesDir, 'commands')\n  const files = readdirSync(commandsDir).filter(f => f.startsWith(XYLABS_COMMANDS_PREFIX) && f.endsWith('.md'))\n  const result: Record<string, string> = {}\n  for (const file of files) {\n    result[file] = readFileSync(PATH.resolve(commandsDir, file), 'utf8')\n  }\n  return result\n}\n\n// Returns { 'xylabs-foo': { 'SKILL.md': '...', 'other.ts': '...' } }\nexport const claudeSkillTemplates = (): Record<string, Record<string, string>> => {\n  const skillsDir = PATH.resolve(templatesDir, 'skills')\n  const dirs = readdirSync(skillsDir).filter(\n    f => f.startsWith(XYLABS_SKILLS_PREFIX) && statSync(PATH.resolve(skillsDir, f)).isDirectory(),\n  )\n  const result: Record<string, Record<string, string>> = {}\n  for (const dir of dirs) {\n    const dirPath = PATH.resolve(skillsDir, dir)\n    const files = readdirSync(dirPath, { recursive: true, encoding: 'utf8' }) as string[]\n    result[dir] = {}\n    for (const file of files) {\n      if (statSync(PATH.resolve(dirPath, file)).isFile()) {\n        result[dir][file] = readFileSync(PATH.resolve(dirPath, file), 'utf8')\n      }\n    }\n  }\n  return result\n}\n\nexport const claudeMdProjectTemplate = (): string =>\n  readFileSync(PATH.resolve(templatesDir, 'CLAUDE-project.md'), 'utf8')\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EAAa;AAAA,EAAc;AAAA,OACtB;AACP,SAAS,qBAAqB;AAC9B,OAAO,UAAU;AAEjB,IAAMA,WAAU,cAAc,YAAY,GAAG;AAC7C,IAAM,cAAc,KAAK,QAAQA,SAAQ,QAAQ,uCAAuC,CAAC;AACzF,IAAM,eAAe,KAAK,QAAQ,aAAa,aAAa,QAAQ;AAE7D,IAAM,sBAAsB;AAC5B,IAAM,yBAAyB;AAC/B,IAAM,uBAAuB;AAE7B,IAAM,wBAAwB,MAA8B;AACjE,QAAM,WAAW,KAAK,QAAQ,cAAc,OAAO;AACnD,QAAM,QAAQ,YAAY,QAAQ,EAAE,OAAO,OAAK,EAAE,WAAW,mBAAmB,KAAK,EAAE,SAAS,KAAK,CAAC;AACtG,QAAM,SAAiC,CAAC;AACxC,aAAW,QAAQ,OAAO;AACxB,WAAO,IAAI,IAAI,aAAa,KAAK,QAAQ,UAAU,IAAI,GAAG,MAAM;AAAA,EAClE;AACA,SAAO;AACT;AAEO,IAAM,yBAAyB,MAA8B;AAClE,QAAM,cAAc,KAAK,QAAQ,cAAc,UAAU;AACzD,QAAM,QAAQ,YAAY,WAAW,EAAE,OAAO,OAAK,EAAE,WAAW,sBAAsB,KAAK,EAAE,SAAS,KAAK,CAAC;AAC5G,QAAM,SAAiC,CAAC;AACxC,aAAW,QAAQ,OAAO;AACxB,WAAO,IAAI,IAAI,aAAa,KAAK,QAAQ,aAAa,IAAI,GAAG,MAAM;AAAA,EACrE;AACA,SAAO;AACT;AAGO,IAAM,uBAAuB,MAA8C;AAChF,QAAM,YAAY,KAAK,QAAQ,cAAc,QAAQ;AACrD,QAAM,OAAO,YAAY,SAAS,EAAE;AAAA,IAClC,OAAK,EAAE,WAAW,oBAAoB,KAAK,SAAS,KAAK,QAAQ,WAAW,CAAC,CAAC,EAAE,YAAY;AAAA,EAC9F;AACA,QAAM,SAAiD,CAAC;AACxD,aAAW,OAAO,MAAM;AACtB,UAAM,UAAU,KAAK,QAAQ,WAAW,GAAG;AAC3C,UAAM,QAAQ,YAAY,SAAS,EAAE,WAAW,MAAM,UAAU,OAAO,CAAC;AACxE,WAAO,GAAG,IAAI,CAAC;AACf,eAAW,QAAQ,OAAO;AACxB,UAAI,SAAS,KAAK,QAAQ,SAAS,IAAI,CAAC,EAAE,OAAO,GAAG;AAClD,eAAO,GAAG,EAAE,IAAI,IAAI,aAAa,KAAK,QAAQ,SAAS,IAAI,GAAG,MAAM;AAAA,MACtE;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAEO,IAAM,0BAA0B,MACrC,aAAa,KAAK,QAAQ,cAAc,mBAAmB,GAAG,MAAM;","names":["require"]}

package/dist/lib/generateReadmeFiles.mjs

@@ -1,8 +1,14 @@
 // src/lib/generateReadmeFiles.ts
 import { execSync } from "child_process";
-import FS from "fs";
-import { readFile, writeFile } from "fs/promises";
+import FS, { readFileSync } from "fs";
+import {
+  mkdir,
+  readFile,
+  writeFile
+} from "fs/promises";
+import { createRequire } from "module";
 import PATH from "path";
+import { createInterface } from "readline";
 import chalk from "chalk";
 
 // src/lib/yarn/workspace/yarnWorkspaces.ts
@@ -31,6 +37,9 @@ var INIT_CWD = () => {
 };
 
 // src/lib/generateReadmeFiles.ts
+var require2 = createRequire(import.meta.url);
+var packageRoot = PATH.dirname(require2.resolve("@xylabs/ts-scripts-yarn3/package.json"));
+var readmeTemplatesDir = PATH.resolve(packageRoot, "templates", "readme");
 function fillTemplate(template, data) {
   const additionalData = { ...data, safeName: data.name.replaceAll("/", "__").replaceAll("@", "") };
   return template.replaceAll(/\{\{(.*?)\}\}/g, (_, key) => additionalData[key.trim()] ?? "");
@@ -120,41 +129,129 @@ ${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 = readFileSync(PATH.resolve(readmeTemplatesDir, "README.template.md"), "utf8");
+var DEFAULT_README_BODY = readFileSync(PATH.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 ?? PATH.join(cwd, ".xy", "README.template.md");
+}
+async function loadOrCreateTemplate(resolvedTemplatePath) {
+  try {
+    const template = await readFile(resolvedTemplatePath, "utf8");
+    return { created: false, template };
+  } catch {
+    console.log(chalk.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 = PATH.dirname(resolvedTemplatePath);
+  await mkdir(xyDir, { recursive: true });
+  await writeFile(resolvedTemplatePath, template);
+  console.log(chalk.green(`Created template: ${resolvedTemplatePath}`));
+  const bodyPath = PATH.join(xyDir, "README.body.md");
+  await writeFile(bodyPath, DEFAULT_README_BODY);
+  console.log(chalk.green(`Created body template: ${bodyPath}`));
+}
+async function resolveBody(location, defaultBody) {
+  const localBodyPath = PATH.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 = PATH.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(PATH.join(location, "README.md"), readmeContent);
+    if (verbose) console.log(chalk.green(`  ${name}`));
+    return true;
+  } catch (ex) {
+    const error = ex;
+    console.warn(chalk.yellow(`  Skipped ${location}: ${error.message}`));
+    return false;
+  }
+}
 async function generateReadmeFiles({
+  logoLinkUrl,
+  logoUrl,
   pkg,
   templatePath,
   typedoc = false,
-  verbose
+  verbose = false
 }) {
   console.log(chalk.green("Generate README Files"));
-  const cwd = INIT_CWD() ?? ".";
-  const resolvedTemplatePath = templatePath ?? PATH.join(cwd, "scripts", "README.template.md");
+  const resolvedTemplatePath = resolveTemplatePath(templatePath);
   let template;
+  let templateCreated;
   try {
-    template = await readFile(resolvedTemplatePath, "utf8");
+    ({ template, created: templateCreated } = await loadOrCreateTemplate(resolvedTemplatePath));
   } catch {
-    console.error(chalk.red(`Template not found: ${resolvedTemplatePath}`));
     return 1;
   }
-  const workspaces = pkg ? [yarnWorkspace(pkg)] : yarnWorkspaces();
+  template = applyLogoConfig(template, logoUrl, logoLinkUrl);
+  if (templateCreated) {
+    console.log(chalk.green("Generating README files for all packages..."));
+  }
+  const xyDir = PATH.dirname(resolvedTemplatePath);
+  const xyBodyPath = PATH.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 = PATH.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(PATH.join(location, "README.md"), readmeContent);
-      if (verbose) console.log(chalk.green(`  ${name}`));
-    } catch (ex) {
-      const error = ex;
-      console.warn(chalk.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;
 }
 export {
-  generateReadmeFiles
+  DEFAULT_README_BODY,
+  DEFAULT_README_TEMPLATE,
+  applyLogoConfig,
+  generateReadmeFiles,
+  resolveTemplatePath,
+  scaffoldTemplate
 };
 //# sourceMappingURL=generateReadmeFiles.mjs.map

package/dist/lib/generateReadmeFiles.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/generateReadmeFiles.ts","../../src/lib/yarn/workspace/yarnWorkspaces.ts","../../src/lib/yarn/workspace/yarnWorkspace.ts","../../src/lib/yarn/yarnInitCwd.ts"],"sourcesContent":["import { execSync } from 'node:child_process'\nimport FS from 'node:fs'\nimport { readFile, writeFile } from 'node:fs/promises'\nimport PATH from 'node:path'\n\nimport chalk from 'chalk'\n\nimport {\n  INIT_CWD, yarnWorkspace, yarnWorkspaces,\n} from './yarn/index.ts'\n\ninterface GenerateReadmeFilesParams {\n  pkg?: string\n  templatePath?: string\n  typedoc?: boolean\n  verbose?: boolean\n}\n\nfunction fillTemplate(template: string, data: Record<string, string>): string {\n  const additionalData: Record<string, string> = { ...data, safeName: data.name.replaceAll('/', '__').replaceAll('@', '') }\n  return template.replaceAll(/\\{\\{(.*?)\\}\\}/g, (_, key: string) => additionalData[key.trim()] ?? '')\n}\n\nfunction generateTypedoc(packageLocation: string, entryPoints: string[]): string {\n  const tempDir = PATH.join(packageLocation, '.temp-typedoc')\n\n  try {\n    if (!FS.existsSync(tempDir)) {\n      FS.mkdirSync(tempDir, { recursive: true })\n    }\n\n    const typedocConfig = {\n      disableSources: true,\n      entryPointStrategy: 'expand',\n      entryPoints: entryPoints.map(ep => PATH.resolve(packageLocation, ep)),\n      excludeExternals: true,\n      excludeInternal: true,\n      excludePrivate: true,\n      githubPages: false,\n      hideBreadcrumbs: true,\n      hideGenerator: true,\n      hidePageTitle: true,\n      out: tempDir,\n      plugin: ['typedoc-plugin-markdown'],\n      readme: 'none',\n      skipErrorChecking: true,\n      sort: ['source-order'],\n      theme: 'markdown',\n      useCodeBlocks: true,\n    }\n\n    const typedocJsonPath = PATH.join(tempDir, 'typedoc.json')\n    FS.writeFileSync(typedocJsonPath, JSON.stringify(typedocConfig, null, 2))\n\n    try {\n      execSync(`npx typedoc --options ${typedocJsonPath}`, {\n        cwd: process.cwd(),\n        stdio: ['ignore', 'pipe', 'pipe'],\n      })\n    } catch {\n      return ''\n    }\n\n    return consolidateMarkdown(tempDir)\n  } catch {\n    return ''\n  } finally {\n    try {\n      FS.rmSync(tempDir, { force: true, recursive: true })\n    } catch {\n      // ignore cleanup errors\n    }\n  }\n}\n\nfunction consolidateMarkdown(tempDir: string): string {\n  let consolidated = '## Reference\\n\\n'\n\n  const mainReadmePath = PATH.join(tempDir, 'README.md')\n  if (FS.existsSync(mainReadmePath)) {\n    const mainContent = FS.readFileSync(mainReadmePath, 'utf8')\n      .replace(/^---(.|\\n)*?---\\n/, '')\n      .replace(/^# .+\\n/, '')\n      .replaceAll(/\\]\\((.+?)\\.md\\)/g, '](#$1)')\n\n    consolidated += mainContent + '\\n\\n'\n  }\n\n  consolidated += processDirectory(tempDir)\n\n  return consolidated\n    .replaceAll(/\\n\\n\\n+/g, '\\n\\n')\n    .replaceAll(/^#### /gm, '### ')\n    .replaceAll(/^##### /gm, '#### ')\n    .replaceAll(/^###### /gm, '##### ')\n}\n\nfunction processDirectory(dir: string, level = 0): string {\n  const indent = '  '.repeat(level)\n  let content = ''\n\n  try {\n    const items = FS.readdirSync(dir, { withFileTypes: true })\n\n    for (const item of items) {\n      if (item.isDirectory()) continue\n      if (item.name === 'README.md' || !item.name.endsWith('.md')) continue\n\n      const fileContent = FS.readFileSync(PATH.join(dir, item.name), 'utf8')\n        .replace(/^---(.|\\n)*?---\\n/, '')\n      const moduleName = item.name.replace('.md', '')\n\n      content += `\\n\\n${indent}### <a id=\"${moduleName}\"></a>${moduleName}\\n\\n`\n      content += fileContent\n        .replace(/^# .+\\n/, '')\n        .replaceAll(/\\]\\((.+?)\\.md\\)/g, '](#$1)')\n    }\n\n    for (const item of items) {\n      if (!item.isDirectory()) continue\n      if (item.name === 'spec' || item.name.includes('.spec')) continue\n\n      content += `\\n\\n${indent}### ${item.name}\\n`\n      content += processDirectory(PATH.join(dir, item.name), level + 1)\n    }\n  } catch {\n    // skip unreadable directories\n  }\n\n  return content\n}\n\nexport async function generateReadmeFiles({\n  pkg, templatePath, typedoc = false, verbose,\n}: GenerateReadmeFilesParams): Promise<number> {\n  console.log(chalk.green('Generate README Files'))\n  const cwd = INIT_CWD() ?? '.'\n  const resolvedTemplatePath = templatePath ?? PATH.join(cwd, 'scripts', 'README.template.md')\n\n  let template: string\n  try {\n    template = await readFile(resolvedTemplatePath, 'utf8')\n  } catch {\n    console.error(chalk.red(`Template not found: ${resolvedTemplatePath}`))\n    return 1\n  }\n\n  const workspaces = pkg ? [yarnWorkspace(pkg)] : yarnWorkspaces()\n  let failed = false\n\n  for (const { location, name } of workspaces) {\n    try {\n      const pkgJsonPath = PATH.join(location, 'package.json')\n      const pkgJson = JSON.parse(await readFile(pkgJsonPath, 'utf8'))\n      const typedocContent = typedoc ? generateTypedoc(location, ['src/index*.ts']) : ''\n      const readmeContent = fillTemplate(template, { ...pkgJson, typedoc: typedocContent })\n      await writeFile(PATH.join(location, 'README.md'), readmeContent)\n      if (verbose) console.log(chalk.green(`  ${name}`))\n    } catch (ex) {\n      const error = ex as Error\n      console.warn(chalk.yellow(`  Skipped ${location}: ${error.message}`))\n      failed = true\n    }\n  }\n\n  return failed ? 1 : 0\n}\n","import { spawnSync } from 'node:child_process'\n\nimport type { Workspace } from './Workspace.ts'\n\nexport const yarnWorkspaces = (): Workspace[] => {\n  const result = spawnSync('yarn', ['workspaces', 'list', '--json', '--recursive'], { encoding: 'utf8', shell: true })\n  if (result.error) {\n    throw result.error\n  }\n  return (\n    result.stdout\n      .toString()\n      // NOTE: This probably doesn't work on Windows\n      // TODO: Replace /r/n with /n first\n      .split('\\n')\n      .slice(0, -1)\n      .map((item) => {\n        return JSON.parse(item)\n      })\n  )\n}\n","import type { Workspace } from './Workspace.ts'\nimport { yarnWorkspaces } from './yarnWorkspaces.ts'\n\nexport const yarnWorkspace = (pkg: string): Workspace => {\n  const workspace = yarnWorkspaces().find(({ name }) => name === pkg)\n  if (!workspace) throw new Error(`Workspace ${pkg} not found`)\n  return workspace\n}\n","export const INIT_CWD = () => {\n  if (!process.env.INIT_CWD) console.error('Missing INIT_CWD')\n  return process.env.INIT_CWD\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/lib/generateReadmeFiles.ts","../../src/lib/yarn/workspace/yarnWorkspaces.ts","../../src/lib/yarn/workspace/yarnWorkspace.ts","../../src/lib/yarn/yarnInitCwd.ts"],"sourcesContent":["import { execSync } from 'node:child_process'\nimport FS, { readFileSync } from 'node:fs'\nimport {\n  mkdir, readFile, writeFile,\n} from 'node:fs/promises'\nimport { createRequire } from 'node:module'\nimport PATH from 'node:path'\nimport { createInterface } from 'node:readline'\n\nimport chalk from 'chalk'\n\nimport {\n  INIT_CWD, yarnWorkspace, yarnWorkspaces,\n} from './yarn/index.ts'\n\nconst require = createRequire(import.meta.url)\nconst packageRoot = PATH.dirname(require.resolve('@xylabs/ts-scripts-yarn3/package.json'))\nconst readmeTemplatesDir = PATH.resolve(packageRoot, 'templates', 'readme')\n\ninterface GenerateReadmeFilesParams {\n  logoLinkUrl?: string\n  logoUrl?: string\n  pkg?: string\n  templatePath?: string\n  typedoc?: boolean\n  verbose?: boolean\n}\n\nfunction fillTemplate(template: string, data: Record<string, string>): string {\n  const additionalData: Record<string, string> = { ...data, safeName: data.name.replaceAll('/', '__').replaceAll('@', '') }\n  return template.replaceAll(/\\{\\{(.*?)\\}\\}/g, (_, key: string) => additionalData[key.trim()] ?? '')\n}\n\nfunction generateTypedoc(packageLocation: string, entryPoints: string[]): string {\n  const tempDir = PATH.join(packageLocation, '.temp-typedoc')\n\n  try {\n    if (!FS.existsSync(tempDir)) {\n      FS.mkdirSync(tempDir, { recursive: true })\n    }\n\n    const typedocConfig = {\n      disableSources: true,\n      entryPointStrategy: 'expand',\n      entryPoints: entryPoints.map(ep => PATH.resolve(packageLocation, ep)),\n      excludeExternals: true,\n      excludeInternal: true,\n      excludePrivate: true,\n      githubPages: false,\n      hideBreadcrumbs: true,\n      hideGenerator: true,\n      hidePageTitle: true,\n      out: tempDir,\n      plugin: ['typedoc-plugin-markdown'],\n      readme: 'none',\n      skipErrorChecking: true,\n      sort: ['source-order'],\n      theme: 'markdown',\n      useCodeBlocks: true,\n    }\n\n    const typedocJsonPath = PATH.join(tempDir, 'typedoc.json')\n    FS.writeFileSync(typedocJsonPath, JSON.stringify(typedocConfig, null, 2))\n\n    try {\n      execSync(`npx typedoc --options ${typedocJsonPath}`, {\n        cwd: process.cwd(),\n        stdio: ['ignore', 'pipe', 'pipe'],\n      })\n    } catch {\n      return ''\n    }\n\n    return consolidateMarkdown(tempDir)\n  } catch {\n    return ''\n  } finally {\n    try {\n      FS.rmSync(tempDir, { force: true, recursive: true })\n    } catch {\n      // ignore cleanup errors\n    }\n  }\n}\n\nfunction consolidateMarkdown(tempDir: string): string {\n  let consolidated = '## Reference\\n\\n'\n\n  const mainReadmePath = PATH.join(tempDir, 'README.md')\n  if (FS.existsSync(mainReadmePath)) {\n    const mainContent = FS.readFileSync(mainReadmePath, 'utf8')\n      .replace(/^---(.|\\n)*?---\\n/, '')\n      .replace(/^# .+\\n/, '')\n      .replaceAll(/\\]\\((.+?)\\.md\\)/g, '](#$1)')\n\n    consolidated += mainContent + '\\n\\n'\n  }\n\n  consolidated += processDirectory(tempDir)\n\n  return consolidated\n    .replaceAll(/\\n\\n\\n+/g, '\\n\\n')\n    .replaceAll(/^#### /gm, '### ')\n    .replaceAll(/^##### /gm, '#### ')\n    .replaceAll(/^###### /gm, '##### ')\n}\n\nfunction processDirectory(dir: string, level = 0): string {\n  const indent = '  '.repeat(level)\n  let content = ''\n\n  try {\n    const items = FS.readdirSync(dir, { withFileTypes: true })\n\n    for (const item of items) {\n      if (item.isDirectory()) continue\n      if (item.name === 'README.md' || !item.name.endsWith('.md')) continue\n\n      const fileContent = FS.readFileSync(PATH.join(dir, item.name), 'utf8')\n        .replace(/^---(.|\\n)*?---\\n/, '')\n      const moduleName = item.name.replace('.md', '')\n\n      content += `\\n\\n${indent}### <a id=\"${moduleName}\"></a>${moduleName}\\n\\n`\n      content += fileContent\n        .replace(/^# .+\\n/, '')\n        .replaceAll(/\\]\\((.+?)\\.md\\)/g, '](#$1)')\n    }\n\n    for (const item of items) {\n      if (!item.isDirectory()) continue\n      if (item.name === 'spec' || item.name.includes('.spec')) continue\n\n      content += `\\n\\n${indent}### ${item.name}\\n`\n      content += processDirectory(PATH.join(dir, item.name), level + 1)\n    }\n  } catch {\n    // skip unreadable directories\n  }\n\n  return content\n}\n\nfunction askConfirmation(question: string): Promise<boolean> {\n  const rl = createInterface({ input: process.stdin, output: process.stdout })\n  return new Promise((resolve) => {\n    rl.question(question, (answer) => {\n      rl.close()\n      resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes')\n    })\n  })\n}\n\nexport const DEFAULT_README_TEMPLATE = readFileSync(PATH.resolve(readmeTemplatesDir, 'README.template.md'), 'utf8')\nexport const DEFAULT_README_BODY = readFileSync(PATH.resolve(readmeTemplatesDir, 'README.body.md'), 'utf8')\n\nexport function applyLogoConfig(template: string, logoUrl?: string, logoLinkUrl?: string): string {\n  let result = template\n  if (logoUrl) {\n    result = result.replace(/\\[logo]: .+/, `[logo]: ${logoUrl}`)\n    if (logoLinkUrl) {\n      result = result.replace(/\\[!\\[logo]\\[]][^)]*\\)/, `[![logo][]](${logoLinkUrl})`)\n    }\n  } else {\n    result = result.replace(/\\[!\\[logo]\\[]][^\\n]*\\n*/, '')\n    result = result.replace(/\\[logo]: [^\\n]*\\n?/, '')\n  }\n  return result\n}\n\nexport function resolveTemplatePath(templatePath: string | undefined): string {\n  const cwd = INIT_CWD() ?? '.'\n  return templatePath ?? PATH.join(cwd, '.xy', 'README.template.md')\n}\n\nasync function loadOrCreateTemplate(resolvedTemplatePath: string): Promise<{\n  created: boolean\n  template: string\n}> {\n  try {\n    const template = await readFile(resolvedTemplatePath, 'utf8')\n    return { created: false, template }\n  } catch {\n    console.log(chalk.yellow(`Template not found: ${resolvedTemplatePath}`))\n    const shouldCreate = await askConfirmation('Would you like to create a stock template? (y/N) ')\n    if (!shouldCreate) {\n      throw new Error('Template creation declined')\n    }\n    const template = DEFAULT_README_TEMPLATE\n    await scaffoldTemplate(resolvedTemplatePath, template)\n    return { created: true, template }\n  }\n}\n\nexport async function scaffoldTemplate(resolvedTemplatePath: string, template: string): Promise<void> {\n  const xyDir = PATH.dirname(resolvedTemplatePath)\n  await mkdir(xyDir, { recursive: true })\n  await writeFile(resolvedTemplatePath, template)\n  console.log(chalk.green(`Created template: ${resolvedTemplatePath}`))\n  const bodyPath = PATH.join(xyDir, 'README.body.md')\n  await writeFile(bodyPath, DEFAULT_README_BODY)\n  console.log(chalk.green(`Created body template: ${bodyPath}`))\n}\n\nasync function resolveBody(location: string, defaultBody: string): Promise<string> {\n  const localBodyPath = PATH.join(location, 'README.body.md')\n  try {\n    return await readFile(localBodyPath, 'utf8')\n  } catch {\n    return defaultBody\n  }\n}\n\nasync function generateReadmeForWorkspace(\n  location: string,\n  name: string,\n  template: string,\n  defaultBody: string,\n  typedoc: boolean,\n  verbose: boolean,\n): Promise<boolean> {\n  try {\n    const pkgJsonPath = PATH.join(location, 'package.json')\n    const pkgJson = JSON.parse(await readFile(pkgJsonPath, 'utf8'))\n    const body = await resolveBody(location, defaultBody)\n    const typedocContent = typedoc ? generateTypedoc(location, ['src/index*.ts']) : ''\n    const readmeContent = fillTemplate(template, {\n      ...pkgJson, body, typedoc: typedocContent,\n    })\n    await writeFile(PATH.join(location, 'README.md'), readmeContent)\n    if (verbose) console.log(chalk.green(`  ${name}`))\n    return true\n  } catch (ex) {\n    const error = ex as Error\n    console.warn(chalk.yellow(`  Skipped ${location}: ${error.message}`))\n    return false\n  }\n}\n\nexport async function generateReadmeFiles({\n  logoLinkUrl, logoUrl, pkg, templatePath, typedoc = false, verbose = false,\n}: GenerateReadmeFilesParams): Promise<number> {\n  console.log(chalk.green('Generate README Files'))\n  const resolvedTemplatePath = resolveTemplatePath(templatePath)\n\n  let template: string\n  let templateCreated: boolean\n  try {\n    ({ template, created: templateCreated } = await loadOrCreateTemplate(resolvedTemplatePath))\n  } catch {\n    return 1\n  }\n\n  template = applyLogoConfig(template, logoUrl, logoLinkUrl)\n\n  if (templateCreated) {\n    console.log(chalk.green('Generating README files for all packages...'))\n  }\n\n  const xyDir = PATH.dirname(resolvedTemplatePath)\n  const xyBodyPath = PATH.join(xyDir, 'README.body.md')\n  let defaultBody: string\n  try {\n    defaultBody = await readFile(xyBodyPath, 'utf8')\n  } catch {\n    defaultBody = DEFAULT_README_BODY\n  }\n\n  const workspaces = pkg && !templateCreated ? [yarnWorkspace(pkg)] : yarnWorkspaces()\n  let failed = false\n\n  for (const { location, name } of workspaces) {\n    const success = await generateReadmeForWorkspace(location, name, template, defaultBody, typedoc, verbose)\n    if (!success) failed = true\n  }\n\n  return failed ? 1 : 0\n}\n","import { spawnSync } from 'node:child_process'\n\nimport type { Workspace } from './Workspace.ts'\n\nexport const yarnWorkspaces = (): Workspace[] => {\n  const result = spawnSync('yarn', ['workspaces', 'list', '--json', '--recursive'], { encoding: 'utf8', shell: true })\n  if (result.error) {\n    throw result.error\n  }\n  return (\n    result.stdout\n      .toString()\n      // NOTE: This probably doesn't work on Windows\n      // TODO: Replace /r/n with /n first\n      .split('\\n')\n      .slice(0, -1)\n      .map((item) => {\n        return JSON.parse(item)\n      })\n  )\n}\n","import type { Workspace } from './Workspace.ts'\nimport { yarnWorkspaces } from './yarnWorkspaces.ts'\n\nexport const yarnWorkspace = (pkg: string): Workspace => {\n  const workspace = yarnWorkspaces().find(({ name }) => name === pkg)\n  if (!workspace) throw new Error(`Workspace ${pkg} not found`)\n  return workspace\n}\n","export const INIT_CWD = () => {\n  if (!process.env.INIT_CWD) console.error('Missing INIT_CWD')\n  return process.env.INIT_CWD\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AACzB,OAAO,MAAM,oBAAoB;AACjC;AAAA,EACE;AAAA,EAAO;AAAA,EAAU;AAAA,OACZ;AACP,SAAS,qBAAqB;AAC9B,OAAO,UAAU;AACjB,SAAS,uBAAuB;AAEhC,OAAO,WAAW;;;ACTlB,SAAS,iBAAiB;AAInB,IAAM,iBAAiB,MAAmB;AAC/C,QAAM,SAAS,UAAU,QAAQ,CAAC,cAAc,QAAQ,UAAU,aAAa,GAAG,EAAE,UAAU,QAAQ,OAAO,KAAK,CAAC;AACnH,MAAI,OAAO,OAAO;AAChB,UAAM,OAAO;AAAA,EACf;AACA,SACE,OAAO,OACJ,SAAS,EAGT,MAAM,IAAI,EACV,MAAM,GAAG,EAAE,EACX,IAAI,CAAC,SAAS;AACb,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB,CAAC;AAEP;;;ACjBO,IAAM,gBAAgB,CAAC,QAA2B;AACvD,QAAM,YAAY,eAAe,EAAE,KAAK,CAAC,EAAE,KAAK,MAAM,SAAS,GAAG;AAClE,MAAI,CAAC,UAAW,OAAM,IAAI,MAAM,aAAa,GAAG,YAAY;AAC5D,SAAO;AACT;;;ACPO,IAAM,WAAW,MAAM;AAC5B,MAAI,CAAC,QAAQ,IAAI,SAAU,SAAQ,MAAM,kBAAkB;AAC3D,SAAO,QAAQ,IAAI;AACrB;;;AHYA,IAAMA,WAAU,cAAc,YAAY,GAAG;AAC7C,IAAM,cAAc,KAAK,QAAQA,SAAQ,QAAQ,uCAAuC,CAAC;AACzF,IAAM,qBAAqB,KAAK,QAAQ,aAAa,aAAa,QAAQ;AAW1E,SAAS,aAAa,UAAkB,MAAsC;AAC5E,QAAM,iBAAyC,EAAE,GAAG,MAAM,UAAU,KAAK,KAAK,WAAW,KAAK,IAAI,EAAE,WAAW,KAAK,EAAE,EAAE;AACxH,SAAO,SAAS,WAAW,kBAAkB,CAAC,GAAG,QAAgB,eAAe,IAAI,KAAK,CAAC,KAAK,EAAE;AACnG;AAEA,SAAS,gBAAgB,iBAAyB,aAA+B;AAC/E,QAAM,UAAU,KAAK,KAAK,iBAAiB,eAAe;AAE1D,MAAI;AACF,QAAI,CAAC,GAAG,WAAW,OAAO,GAAG;AAC3B,SAAG,UAAU,SAAS,EAAE,WAAW,KAAK,CAAC;AAAA,IAC3C;AAEA,UAAM,gBAAgB;AAAA,MACpB,gBAAgB;AAAA,MAChB,oBAAoB;AAAA,MACpB,aAAa,YAAY,IAAI,QAAM,KAAK,QAAQ,iBAAiB,EAAE,CAAC;AAAA,MACpE,kBAAkB;AAAA,MAClB,iBAAiB;AAAA,MACjB,gBAAgB;AAAA,MAChB,aAAa;AAAA,MACb,iBAAiB;AAAA,MACjB,eAAe;AAAA,MACf,eAAe;AAAA,MACf,KAAK;AAAA,MACL,QAAQ,CAAC,yBAAyB;AAAA,MAClC,QAAQ;AAAA,MACR,mBAAmB;AAAA,MACnB,MAAM,CAAC,cAAc;AAAA,MACrB,OAAO;AAAA,MACP,eAAe;AAAA,IACjB;AAEA,UAAM,kBAAkB,KAAK,KAAK,SAAS,cAAc;AACzD,OAAG,cAAc,iBAAiB,KAAK,UAAU,eAAe,MAAM,CAAC,CAAC;AAExE,QAAI;AACF,eAAS,yBAAyB,eAAe,IAAI;AAAA,QACnD,KAAK,QAAQ,IAAI;AAAA,QACjB,OAAO,CAAC,UAAU,QAAQ,MAAM;AAAA,MAClC,CAAC;AAAA,IACH,QAAQ;AACN,aAAO;AAAA,IACT;AAEA,WAAO,oBAAoB,OAAO;AAAA,EACpC,QAAQ;AACN,WAAO;AAAA,EACT,UAAE;AACA,QAAI;AACF,SAAG,OAAO,SAAS,EAAE,OAAO,MAAM,WAAW,KAAK,CAAC;AAAA,IACrD,QAAQ;AAAA,IAER;AAAA,EACF;AACF;AAEA,SAAS,oBAAoB,SAAyB;AACpD,MAAI,eAAe;AAEnB,QAAM,iBAAiB,KAAK,KAAK,SAAS,WAAW;AACrD,MAAI,GAAG,WAAW,cAAc,GAAG;AACjC,UAAM,cAAc,GAAG,aAAa,gBAAgB,MAAM,EACvD,QAAQ,qBAAqB,EAAE,EAC/B,QAAQ,WAAW,EAAE,EACrB,WAAW,oBAAoB,QAAQ;AAE1C,oBAAgB,cAAc;AAAA,EAChC;AAEA,kBAAgB,iBAAiB,OAAO;AAExC,SAAO,aACJ,WAAW,YAAY,MAAM,EAC7B,WAAW,YAAY,MAAM,EAC7B,WAAW,aAAa,OAAO,EAC/B,WAAW,cAAc,QAAQ;AACtC;AAEA,SAAS,iBAAiB,KAAa,QAAQ,GAAW;AACxD,QAAM,SAAS,KAAK,OAAO,KAAK;AAChC,MAAI,UAAU;AAEd,MAAI;AACF,UAAM,QAAQ,GAAG,YAAY,KAAK,EAAE,eAAe,KAAK,CAAC;AAEzD,eAAW,QAAQ,OAAO;AACxB,UAAI,KAAK,YAAY,EAAG;AACxB,UAAI,KAAK,SAAS,eAAe,CAAC,KAAK,KAAK,SAAS,KAAK,EAAG;AAE7D,YAAM,cAAc,GAAG,aAAa,KAAK,KAAK,KAAK,KAAK,IAAI,GAAG,MAAM,EAClE,QAAQ,qBAAqB,EAAE;AAClC,YAAM,aAAa,KAAK,KAAK,QAAQ,OAAO,EAAE;AAE9C,iBAAW;AAAA;AAAA,EAAO,MAAM,cAAc,UAAU,SAAS,UAAU;AAAA;AAAA;AACnE,iBAAW,YACR,QAAQ,WAAW,EAAE,EACrB,WAAW,oBAAoB,QAAQ;AAAA,IAC5C;AAEA,eAAW,QAAQ,OAAO;AACxB,UAAI,CAAC,KAAK,YAAY,EAAG;AACzB,UAAI,KAAK,SAAS,UAAU,KAAK,KAAK,SAAS,OAAO,EAAG;AAEzD,iBAAW;AAAA;AAAA,EAAO,MAAM,OAAO,KAAK,IAAI;AAAA;AACxC,iBAAW,iBAAiB,KAAK,KAAK,KAAK,KAAK,IAAI,GAAG,QAAQ,CAAC;AAAA,IAClE;AAAA,EACF,QAAQ;AAAA,EAER;AAEA,SAAO;AACT;AAEA,SAAS,gBAAgB,UAAoC;AAC3D,QAAM,KAAK,gBAAgB,EAAE,OAAO,QAAQ,OAAO,QAAQ,QAAQ,OAAO,CAAC;AAC3E,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,OAAG,SAAS,UAAU,CAAC,WAAW;AAChC,SAAG,MAAM;AACT,cAAQ,OAAO,YAAY,MAAM,OAAO,OAAO,YAAY,MAAM,KAAK;AAAA,IACxE,CAAC;AAAA,EACH,CAAC;AACH;AAEO,IAAM,0BAA0B,aAAa,KAAK,QAAQ,oBAAoB,oBAAoB,GAAG,MAAM;AAC3G,IAAM,sBAAsB,aAAa,KAAK,QAAQ,oBAAoB,gBAAgB,GAAG,MAAM;AAEnG,SAAS,gBAAgB,UAAkB,SAAkB,aAA8B;AAChG,MAAI,SAAS;AACb,MAAI,SAAS;AACX,aAAS,OAAO,QAAQ,eAAe,WAAW,OAAO,EAAE;AAC3D,QAAI,aAAa;AACf,eAAS,OAAO,QAAQ,yBAAyB,eAAe,WAAW,GAAG;AAAA,IAChF;AAAA,EACF,OAAO;AACL,aAAS,OAAO,QAAQ,2BAA2B,EAAE;AACrD,aAAS,OAAO,QAAQ,sBAAsB,EAAE;AAAA,EAClD;AACA,SAAO;AACT;AAEO,SAAS,oBAAoB,cAA0C;AAC5E,QAAM,MAAM,SAAS,KAAK;AAC1B,SAAO,gBAAgB,KAAK,KAAK,KAAK,OAAO,oBAAoB;AACnE;AAEA,eAAe,qBAAqB,sBAGjC;AACD,MAAI;AACF,UAAM,WAAW,MAAM,SAAS,sBAAsB,MAAM;AAC5D,WAAO,EAAE,SAAS,OAAO,SAAS;AAAA,EACpC,QAAQ;AACN,YAAQ,IAAI,MAAM,OAAO,uBAAuB,oBAAoB,EAAE,CAAC;AACvE,UAAM,eAAe,MAAM,gBAAgB,mDAAmD;AAC9F,QAAI,CAAC,cAAc;AACjB,YAAM,IAAI,MAAM,4BAA4B;AAAA,IAC9C;AACA,UAAM,WAAW;AACjB,UAAM,iBAAiB,sBAAsB,QAAQ;AACrD,WAAO,EAAE,SAAS,MAAM,SAAS;AAAA,EACnC;AACF;AAEA,eAAsB,iBAAiB,sBAA8B,UAAiC;AACpG,QAAM,QAAQ,KAAK,QAAQ,oBAAoB;AAC/C,QAAM,MAAM,OAAO,EAAE,WAAW,KAAK,CAAC;AACtC,QAAM,UAAU,sBAAsB,QAAQ;AAC9C,UAAQ,IAAI,MAAM,MAAM,qBAAqB,oBAAoB,EAAE,CAAC;AACpE,QAAM,WAAW,KAAK,KAAK,OAAO,gBAAgB;AAClD,QAAM,UAAU,UAAU,mBAAmB;AAC7C,UAAQ,IAAI,MAAM,MAAM,0BAA0B,QAAQ,EAAE,CAAC;AAC/D;AAEA,eAAe,YAAY,UAAkB,aAAsC;AACjF,QAAM,gBAAgB,KAAK,KAAK,UAAU,gBAAgB;AAC1D,MAAI;AACF,WAAO,MAAM,SAAS,eAAe,MAAM;AAAA,EAC7C,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,eAAe,2BACb,UACA,MACA,UACA,aACA,SACA,SACkB;AAClB,MAAI;AACF,UAAM,cAAc,KAAK,KAAK,UAAU,cAAc;AACtD,UAAM,UAAU,KAAK,MAAM,MAAM,SAAS,aAAa,MAAM,CAAC;AAC9D,UAAM,OAAO,MAAM,YAAY,UAAU,WAAW;AACpD,UAAM,iBAAiB,UAAU,gBAAgB,UAAU,CAAC,eAAe,CAAC,IAAI;AAChF,UAAM,gBAAgB,aAAa,UAAU;AAAA,MAC3C,GAAG;AAAA,MAAS;AAAA,MAAM,SAAS;AAAA,IAC7B,CAAC;AACD,UAAM,UAAU,KAAK,KAAK,UAAU,WAAW,GAAG,aAAa;AAC/D,QAAI,QAAS,SAAQ,IAAI,MAAM,MAAM,KAAK,IAAI,EAAE,CAAC;AACjD,WAAO;AAAA,EACT,SAAS,IAAI;AACX,UAAM,QAAQ;AACd,YAAQ,KAAK,MAAM,OAAO,aAAa,QAAQ,KAAK,MAAM,OAAO,EAAE,CAAC;AACpE,WAAO;AAAA,EACT;AACF;AAEA,eAAsB,oBAAoB;AAAA,EACxC;AAAA,EAAa;AAAA,EAAS;AAAA,EAAK;AAAA,EAAc,UAAU;AAAA,EAAO,UAAU;AACtE,GAA+C;AAC7C,UAAQ,IAAI,MAAM,MAAM,uBAAuB,CAAC;AAChD,QAAM,uBAAuB,oBAAoB,YAAY;AAE7D,MAAI;AACJ,MAAI;AACJ,MAAI;AACF,KAAC,EAAE,UAAU,SAAS,gBAAgB,IAAI,MAAM,qBAAqB,oBAAoB;AAAA,EAC3F,QAAQ;AACN,WAAO;AAAA,EACT;AAEA,aAAW,gBAAgB,UAAU,SAAS,WAAW;AAEzD,MAAI,iBAAiB;AACnB,YAAQ,IAAI,MAAM,MAAM,6CAA6C,CAAC;AAAA,EACxE;AAEA,QAAM,QAAQ,KAAK,QAAQ,oBAAoB;AAC/C,QAAM,aAAa,KAAK,KAAK,OAAO,gBAAgB;AACpD,MAAI;AACJ,MAAI;AACF,kBAAc,MAAM,SAAS,YAAY,MAAM;AAAA,EACjD,QAAQ;AACN,kBAAc;AAAA,EAChB;AAEA,QAAM,aAAa,OAAO,CAAC,kBAAkB,CAAC,cAAc,GAAG,CAAC,IAAI,eAAe;AACnF,MAAI,SAAS;AAEb,aAAW,EAAE,UAAU,KAAK,KAAK,YAAY;AAC3C,UAAM,UAAU,MAAM,2BAA2B,UAAU,MAAM,UAAU,aAAa,SAAS,OAAO;AACxG,QAAI,CAAC,QAAS,UAAS;AAAA,EACzB;AAEA,SAAO,SAAS,IAAI;AACtB;","names":["require"]}

package/dist/lib/index.mjs

@@ -12,14 +12,19 @@ var checkResult = (name, result, level = "error", exitOnFail = false) => {
 };
 
 // src/lib/claudeMdTemplate.ts
-import { readdirSync, readFileSync } from "fs";
+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-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 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"));
@@ -38,6 +43,24 @@ var claudeCommandTemplates = () => {
   }
   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 claudeMdProjectTemplate = () => readFileSync(PATH.resolve(templatesDir, "CLAUDE-project.md"), "utf8");
 
 // src/lib/createBuildConfig.ts
@@ -378,10 +401,19 @@ var generateIgnoreFiles = (filename, 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()] ?? "");
@@ -471,37 +503,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 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(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 cwd = INIT_CWD() ?? ".";
-  const resolvedTemplatePath = templatePath ?? PATH2.join(cwd, "scripts", "README.template.md");
+  const resolvedTemplatePath = resolveTemplatePath(templatePath);
   let template;
+  let templateCreated;
   try {
-    template = await readFile(resolvedTemplatePath, "utf8");
+    ({ template, created: templateCreated } = await loadOrCreateTemplate(resolvedTemplatePath));
   } catch {
-    console.error(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;
 }
@@ -528,10 +643,10 @@ var loadConfig = async (params) => {
 };
 
 // src/lib/parsedPackageJSON.ts
-import { readFileSync as readFileSync5 } from "fs";
+import { readFileSync as readFileSync6 } from "fs";
 var parsedPackageJSON = (path) => {
   const pathToPackageJSON = path ?? process.env.npm_package_json ?? "";
-  const packageJSON = readFileSync5(pathToPackageJSON).toString();
+  const packageJSON = readFileSync6(pathToPackageJSON).toString();
   return JSON.parse(packageJSON);
 };
 
@@ -633,15 +748,20 @@ var runXyWithWarning = (command) => {
 };
 export {
   CROSS_PLATFORM_NEWLINE,
+  DEFAULT_README_BODY,
+  DEFAULT_README_TEMPLATE,
   DuplicateDetector,
   INIT_CWD,
   WINDOWS_NEWLINE_REGEX,
   XYLABS_COMMANDS_PREFIX,
   XYLABS_RULES_PREFIX,
+  XYLABS_SKILLS_PREFIX,
+  applyLogoConfig,
   checkResult,
   claudeCommandTemplates,
   claudeMdProjectTemplate,
   claudeMdRuleTemplates,
+  claudeSkillTemplates,
   createBuildConfig,
   defaultBuildConfig,
   defaultReadFileSyncOptions,
@@ -658,6 +778,7 @@ export {
   processEx,
   readLines,
   readNonEmptyLines,
+  resolveTemplatePath,
   runStepAsync,
   runSteps,
   runStepsAsync,
@@ -665,6 +786,7 @@ export {
   runXyWithWarning,
   safeExit,
   safeExitAsync,
+  scaffoldTemplate,
   tryReadFileSync,
   union,
   withErrnoException,