@take-out/cli 0.0.39

package/dist/cjs/commands/docs.cjs

@@ -0,0 +1,388 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf,
+  __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+    for (var name in all) __defProp(target, name, {
+      get: all[name],
+      enumerable: !0
+    });
+  },
+  __copyProps = (to, from, except, desc) => {
+    if (from && typeof from == "object" || typeof from == "function") for (let key of __getOwnPropNames(from)) !__hasOwnProp.call(to, key) && key !== except && __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+    return to;
+  };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+    value: mod,
+    enumerable: !0
+  }) : target, mod)),
+  __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+    value: !0
+  }), mod);
+var docs_exports = {};
+__export(docs_exports, {
+  docsCommand: () => docsCommand
+});
+module.exports = __toCommonJS(docs_exports);
+var import_node_fs = require("node:fs"),
+  import_node_path = require("node:path"),
+  import_citty = require("citty"),
+  import_picocolors = __toESM(require("picocolors"), 1),
+  import_sync = require("../utils/sync.cjs");
+const import_meta = {};
+function findPackageRoot(startDir) {
+  let dir = startDir;
+  for (; dir !== (0, import_node_path.parse)(dir).root;) {
+    if ((0, import_node_fs.existsSync)((0, import_node_path.join)(dir, "package.json")) && JSON.parse((0, import_node_fs.readFileSync)((0, import_node_path.join)(dir, "package.json"), "utf-8")).name === "@take-out/cli") return dir;
+    dir = (0, import_node_path.join)(dir, "..");
+  }
+  throw new Error("Could not find @take-out/cli package root");
+}
+const PACKAGE_ROOT = findPackageRoot(import_meta.dirname),
+  DOCS_DIR = (0, import_node_path.join)(PACKAGE_ROOT, "docs"),
+  listCommand = (0, import_citty.defineCommand)({
+    meta: {
+      name: "list",
+      description: "List all available documentation files"
+    },
+    async run() {
+      (0, import_node_fs.existsSync)(DOCS_DIR) || (console.error(import_picocolors.default.red("\u2717 Docs directory not found")), process.exit(1));
+      const files = (0, import_node_fs.readdirSync)(DOCS_DIR).filter(f => f.endsWith(".md")).sort();
+      console.info(), console.info(import_picocolors.default.bold(import_picocolors.default.cyan("\u{1F4DA} Available Documentation"))), console.info();
+      for (const file of files) {
+        const name = file.replace(/\.md$/, ""),
+          path = (0, import_node_path.join)(DOCS_DIR, file);
+        let description = "";
+        try {
+          const match = (0, import_node_fs.readFileSync)(path, "utf-8").match(/^#\s+(.+)$/m);
+          match?.[1] && (description = match[1]);
+        } catch {}
+        description ? (console.info(`  ${import_picocolors.default.green(name)}`), console.info(`    ${import_picocolors.default.dim(description)}`)) : console.info(`  ${import_picocolors.default.green(name)}`);
+      }
+      console.info(), console.info(import_picocolors.default.dim("Use 'takeout docs get <name>' to view a document")), console.info();
+    }
+  }),
+  getCommand = (0, import_citty.defineCommand)({
+    meta: {
+      name: "get",
+      description: "Get the content of one or more documentation files"
+    },
+    args: {
+      name: {
+        type: "positional",
+        description: "Name(s) of the doc files (without .md extension)",
+        required: !0,
+        valueHint: "name..."
+      }
+    },
+    async run({
+      args
+    }) {
+      const names = args._.length > 0 ? args._ : [args.name],
+        results = [],
+        errors = [],
+        cwd = process.cwd(),
+        localDocsDir = (0, import_node_path.join)(cwd, "docs");
+      for (const name of names) {
+        const fileName = name.endsWith(".md") ? name : `${name}.md`,
+          localFilePath = (0, import_node_path.join)(localDocsDir, fileName),
+          packageFilePath = (0, import_node_path.join)(DOCS_DIR, fileName);
+        let filePath = null;
+        if ((0, import_node_fs.existsSync)(localFilePath) ? filePath = localFilePath : (0, import_node_fs.existsSync)(packageFilePath) && (filePath = packageFilePath), !filePath) {
+          errors.push({
+            name,
+            error: "File not found"
+          });
+          continue;
+        }
+        try {
+          const content = (0, import_node_fs.readFileSync)(filePath, "utf-8");
+          results.push({
+            name,
+            content
+          });
+        } catch (err) {
+          errors.push({
+            name,
+            error: String(err)
+          });
+        }
+      }
+      if (errors.length > 0) {
+        for (const {
+          name,
+          error
+        } of errors) console.error(import_picocolors.default.red(`\u2717 Doc file not found: ${name}`));
+        console.info(), console.info(import_picocolors.default.dim("Use 'takeout docs list' to see available docs")), results.length === 0 && process.exit(1), console.info();
+      }
+      for (let i = 0; i < results.length; i++) {
+        const result = results[i];
+        result && (console.info(`# ${result.name}`), console.info(), console.info(result.content), i < results.length - 1 && (console.info(), console.info("---"), console.info()));
+      }
+    }
+  }),
+  pathCommand = (0, import_citty.defineCommand)({
+    meta: {
+      name: "path",
+      description: "Get the absolute path to a documentation file"
+    },
+    args: {
+      name: {
+        type: "positional",
+        description: "Name of the doc file (without .md extension)",
+        required: !1
+      }
+    },
+    async run({
+      args
+    }) {
+      if (!args.name) {
+        console.info(DOCS_DIR);
+        return;
+      }
+      const fileName = args.name.endsWith(".md") ? args.name : `${args.name}.md`,
+        filePath = (0, import_node_path.join)(DOCS_DIR, fileName);
+      (0, import_node_fs.existsSync)(filePath) || (console.error(import_picocolors.default.red(`\u2717 Doc file not found: ${args.name}`)), process.exit(1)), console.info(filePath);
+    }
+  }),
+  ejectCommand = (0, import_citty.defineCommand)({
+    meta: {
+      name: "eject",
+      description: "Eject Takeout documentation files into your project"
+    },
+    args: {
+      yes: {
+        type: "boolean",
+        description: "Skip confirmations and eject all files",
+        default: !1
+      }
+    },
+    async run({
+      args
+    }) {
+      const cwd = process.cwd(),
+        targetDocsDir = (0, import_node_path.join)(cwd, "docs"),
+        sourceDocsDir = DOCS_DIR;
+      console.info(), console.info(import_picocolors.default.bold(import_picocolors.default.cyan("\u{1F4DA} Eject Docs"))), console.info(), console.info(import_picocolors.default.dim(`Source: ${sourceDocsDir}`)), console.info(import_picocolors.default.dim(`Target: ${targetDocsDir}`)), console.info(), (0, import_node_fs.existsSync)(sourceDocsDir) || (console.error(import_picocolors.default.red("\u2717 Source docs directory not found in Takeout package")), process.exit(1)), (0, import_node_fs.existsSync)(targetDocsDir) || (console.info(import_picocolors.default.yellow("\u26A0 Target docs directory does not exist, will create it")), (0, import_node_fs.mkdirSync)(targetDocsDir, {
+        recursive: !0
+      }));
+      const sourceFiles = (0, import_node_fs.readdirSync)(sourceDocsDir).filter(f => f.endsWith(".md"));
+      if (sourceFiles.length === 0) {
+        console.info(import_picocolors.default.yellow("No markdown files found in Takeout docs"));
+        return;
+      }
+      const filesToSync = [],
+        stats = {
+          new: 0,
+          modified: 0,
+          identical: 0
+        };
+      for (const file of sourceFiles) {
+        const sourcePath = (0, import_node_path.join)(sourceDocsDir, file),
+          targetPath = (0, import_node_path.join)(targetDocsDir, file),
+          status = (0, import_sync.compareFiles)(sourcePath, targetPath);
+        stats[status]++, filesToSync.push({
+          name: file,
+          sourcePath,
+          targetPath,
+          status,
+          sourceSize: (0, import_sync.getFileSize)(sourcePath),
+          targetSize: (0, import_sync.getFileSize)(targetPath)
+        });
+      }
+      if (console.info(import_picocolors.default.bold("Summary:")), console.info(`  ${import_picocolors.default.green(`${stats.new} new`)}`), console.info(`  ${import_picocolors.default.yellow(`${stats.modified} modified`)}`), console.info(`  ${import_picocolors.default.dim(`${stats.identical} identical`)}`), console.info(), stats.new === 0 && stats.modified === 0) {
+        console.info(import_picocolors.default.green("\u2713 All docs are already up to date!"));
+        return;
+      }
+      const sortOrder = {
+        new: 0,
+        modified: 1,
+        identical: 2
+      };
+      filesToSync.sort((a, b) => sortOrder[a.status] - sortOrder[b.status]);
+      let syncedCount = 0;
+      for (const file of filesToSync) if (args.yes && file.status !== "identical") {
+        const targetDir = (0, import_node_path.join)(targetDocsDir);
+        (0, import_node_fs.existsSync)(targetDir) || (0, import_node_fs.mkdirSync)(targetDir, {
+          recursive: !0
+        });
+        const content = (0, import_node_fs.readFileSync)(file.sourcePath);
+        (0, import_node_fs.writeFileSync)(file.targetPath, content), console.info(import_picocolors.default.green(`  \u2713 ${file.name}`)), syncedCount++;
+      } else (await (0, import_sync.syncFileWithConfirmation)(file)) && syncedCount++;
+      console.info(), console.info(import_picocolors.default.bold(import_picocolors.default.green(`\u2713 Complete: ${syncedCount} file(s) ejected`))), console.info();
+    }
+  });
+function hasSkillFrontmatter(content) {
+  if (!content.startsWith("---")) return !1;
+  const endIndex = content.indexOf("---", 3);
+  if (endIndex === -1) return !1;
+  const frontmatter = content.slice(3, endIndex);
+  return frontmatter.includes("name:") && frontmatter.includes("description:");
+}
+function extractDocMeta(content) {
+  const lines = content.split(`
+`);
+  let title = "",
+    description = "",
+    startLine = 0;
+  if (lines[0]?.trim() === "---") {
+    for (let i = 1; i < lines.length; i++) if (lines[i]?.trim() === "---") {
+      startLine = i + 1;
+      break;
+    }
+  }
+  for (let i = startLine; i < lines.length; i++) {
+    const trimmed = lines[i]?.trim() || "";
+    if (!title && trimmed.startsWith("# ")) {
+      title = trimmed.slice(2).trim();
+      continue;
+    }
+    if (title && trimmed && !trimmed.startsWith("#")) {
+      description = trimmed;
+      break;
+    }
+  }
+  return {
+    title,
+    description
+  };
+}
+function toSkillName(name) {
+  return name.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 64);
+}
+function collectAllDocs(cwd) {
+  const docs = [],
+    seen = /* @__PURE__ */new Set(),
+    localDocsDir = (0, import_node_path.join)(cwd, "docs");
+  if ((0, import_node_fs.existsSync)(localDocsDir)) {
+    const files = (0, import_node_fs.readdirSync)(localDocsDir).filter(f => f.endsWith(".md"));
+    for (const file of files) {
+      const name = file.replace(/\.md$/, "");
+      docs.push({
+        name,
+        path: (0, import_node_path.join)(localDocsDir, file),
+        source: "local"
+      }), seen.add(name);
+    }
+  }
+  if ((0, import_node_fs.existsSync)(DOCS_DIR)) {
+    const files = (0, import_node_fs.readdirSync)(DOCS_DIR).filter(f => f.endsWith(".md"));
+    for (const file of files) {
+      const name = file.replace(/\.md$/, "");
+      seen.has(name) || docs.push({
+        name,
+        path: (0, import_node_path.join)(DOCS_DIR, file),
+        source: "package"
+      });
+    }
+  }
+  return docs;
+}
+const SKILL_PREFIX = "takeout-",
+  skillsCommand = (0, import_citty.defineCommand)({
+    meta: {
+      name: "skills",
+      description: "Generate Claude Code skills from documentation"
+    },
+    args: {
+      clean: {
+        type: "boolean",
+        description: "Remove existing skills before generating",
+        default: !1
+      }
+    },
+    async run({
+      args
+    }) {
+      const cwd = process.cwd(),
+        skillsDir = (0, import_node_path.join)(cwd, ".claude", "skills");
+      console.info(), console.info(import_picocolors.default.bold(import_picocolors.default.cyan("\u{1F9E0} Generate Claude Code Skills"))), console.info();
+      const docs = collectAllDocs(cwd);
+      if (docs.length === 0) {
+        console.info(import_picocolors.default.yellow("No documentation files found"));
+        return;
+      }
+      if (console.info(import_picocolors.default.dim(`Found ${docs.length} documentation files`)), console.info(), args.clean && (0, import_node_fs.existsSync)(skillsDir)) {
+        console.info(import_picocolors.default.yellow("Cleaning existing takeout skills..."));
+        const existing = (0, import_node_fs.readdirSync)(skillsDir);
+        for (const dir of existing) dir.startsWith(SKILL_PREFIX) && (0, import_node_fs.rmSync)((0, import_node_path.join)(skillsDir, dir), {
+          recursive: !0
+        });
+      }
+      (0, import_node_fs.existsSync)(skillsDir) || (0, import_node_fs.mkdirSync)(skillsDir, {
+        recursive: !0
+      });
+      let symlinked = 0,
+        generated = 0,
+        unchanged = 0;
+      for (const doc of docs) {
+        const baseName = toSkillName(doc.name),
+          skillName = `${SKILL_PREFIX}${baseName}`,
+          skillDir = (0, import_node_path.join)(skillsDir, skillName),
+          skillFile = (0, import_node_path.join)(skillDir, "SKILL.md"),
+          content = (0, import_node_fs.readFileSync)(doc.path, "utf-8"),
+          hasFrontmatter = hasSkillFrontmatter(content);
+        if ((0, import_node_fs.existsSync)(skillDir) || (0, import_node_fs.mkdirSync)(skillDir, {
+          recursive: !0
+        }), hasFrontmatter) {
+          const relativePath = (0, import_node_path.relative)(skillDir, doc.path);
+          if ((0, import_node_fs.existsSync)(skillFile)) try {
+            if ((0, import_node_fs.lstatSync)(skillFile).isSymbolicLink() && (0, import_node_fs.readFileSync)(skillFile, "utf-8") === content) {
+              unchanged++;
+              continue;
+            }
+            (0, import_node_fs.unlinkSync)(skillFile);
+          } catch {}
+          (0, import_node_fs.symlinkSync)(relativePath, skillFile), symlinked++;
+          const sourceLabel = doc.source === "local" ? import_picocolors.default.blue("local") : import_picocolors.default.dim("package");
+          console.info(`  ${import_picocolors.default.green("\u27F7")} ${skillName} ${sourceLabel} ${import_picocolors.default.dim("(symlink)")}`);
+        } else {
+          const {
+              title,
+              description
+            } = extractDocMeta(content),
+            skillDescription = description ? `${title}. ${description}`.slice(0, 1024) : title.slice(0, 1024),
+            skillContent = `---
+name: ${skillName}
+description: ${skillDescription}
+---
+
+${content}
+`;
+          if ((0, import_node_fs.existsSync)(skillFile)) try {
+            if ((0, import_node_fs.lstatSync)(skillFile).isSymbolicLink()) (0, import_node_fs.unlinkSync)(skillFile);else if ((0, import_node_fs.readFileSync)(skillFile, "utf-8") === skillContent) {
+              unchanged++;
+              continue;
+            }
+          } catch {}
+          (0, import_node_fs.writeFileSync)(skillFile, skillContent), generated++;
+          const sourceLabel = doc.source === "local" ? import_picocolors.default.blue("local") : import_picocolors.default.dim("package");
+          console.info(`  ${import_picocolors.default.green("\u2713")} ${skillName} ${sourceLabel} ${import_picocolors.default.dim("(generated)")}`);
+        }
+      }
+      console.info(), console.info(import_picocolors.default.bold("Summary:")), symlinked > 0 && console.info(`  ${import_picocolors.default.green(`${symlinked} symlinked`)}`), generated > 0 && console.info(`  ${import_picocolors.default.yellow(`${generated} generated`)} ${import_picocolors.default.dim("(add frontmatter to source to enable symlink)")}`), unchanged > 0 && console.info(`  ${import_picocolors.default.dim(`${unchanged} unchanged`)}`), console.info(), console.info(import_picocolors.default.dim(`Skills in ${skillsDir}`)), console.info();
+    }
+  }),
+  docsCommand = (0, import_citty.defineCommand)({
+    meta: {
+      name: "docs",
+      description: "List and retrieve Takeout documentation"
+    },
+    subCommands: {
+      list: listCommand,
+      get: getCommand,
+      path: pathCommand,
+      eject: ejectCommand,
+      skills: skillsCommand
+    }
+  });