@bitcobblers/wod-wiki-tools 0.42.2148 → 0.43.2150

package/dist/bin/wod.cjs

@@ -1029,7 +1029,7 @@ var init_compiler = __esm({
 var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
-    VERSION = "0.42.2148";
+    VERSION = "0.43.2150";
   }
 });
 
@@ -1238,6 +1238,63 @@ directory, \`https://owner.github.io/repo/\`, e.g.
   }
 });
 
+// src/cli/skills.ts
+var skills_exports = {};
+__export(skills_exports, {
+  bundledSkillsRoot: () => bundledSkillsRoot,
+  installSkills: () => installSkills,
+  listBundledSkills: () => listBundledSkills
+});
+function frontmatterField(source, key) {
+  const match = source.match(new RegExp(`^${key}:[ 	]*(.*)$`, "m"));
+  return match?.[1].trim().replace(/^(['"])(.*)\1$/, "$2") || void 0;
+}
+function listBundledSkills(root) {
+  if (!fs.existsSync(root)) return [];
+  return fs.readdirSync(root, { withFileTypes: true }).filter((entry) => entry.isDirectory() && fs.existsSync(path.join(root, entry.name, "SKILL.md"))).sort((a, b) => a.name.localeCompare(b.name)).map((entry) => {
+    const source = fs.readFileSync(path.join(root, entry.name, "SKILL.md"), "utf-8");
+    return {
+      name: entry.name,
+      description: frontmatterField(source, "description") ?? "",
+      path: path.join(root, entry.name)
+    };
+  });
+}
+function bundledSkillsRoot() {
+  const scriptDir = path.dirname(fs.realpathSync(process.argv[1] ?? process.cwd()));
+  const candidates = ["skills", "../skills", "../../skills", "../../../skills", "../../../../skills"].map(
+    (rel) => path.resolve(scriptDir, rel)
+  );
+  return candidates.find((candidate) => listBundledSkills(candidate).length > 0);
+}
+function installSkills(options = {}) {
+  const root = options.root ?? bundledSkillsRoot();
+  if (!root) {
+    throw new Error("no bundled skills found next to this CLI \u2014 reinstall the package or run from the wod-wiki checkout");
+  }
+  const skills = listBundledSkills(root);
+  if (skills.length === 0) throw new Error(`no skills under ${root}`);
+  const target = path.join(path.resolve(options.dir ?? process.cwd()), ".agents", "skills");
+  const installed = [];
+  const skipped = [];
+  for (const skill of skills) {
+    const destination = path.join(target, skill.name);
+    if (fs.existsSync(destination) && options.force !== true) {
+      skipped.push(skill.name);
+      continue;
+    }
+    fs.rmSync(destination, { recursive: true, force: true });
+    fs.mkdirSync(target, { recursive: true });
+    fs.cpSync(skill.path, destination, { recursive: true });
+    installed.push(skill.name);
+  }
+  return { root, target, installed, skipped };
+}
+var init_skills = __esm({
+  "src/cli/skills.ts"() {
+  }
+});
+
 // src/server/errors.ts
 var HttpError;
 var init_errors = __esm({
@@ -1541,13 +1598,13 @@ __export(server_exports, {
   runCliServer: () => runCliServer
 });
 function withResolvers() {
-  let resolve3;
+  let resolve4;
   let reject;
   const promise = new Promise((res, rej) => {
-    resolve3 = res;
+    resolve4 = res;
     reject = rej;
   });
-  return { promise, resolve: resolve3, reject };
+  return { promise, resolve: resolve4, reject };
 }
 function startHttpServer(handler, host, port) {
   const b = globalThis.Bun;
@@ -1555,7 +1612,7 @@ function startHttpServer(handler, host, port) {
     const s = b.serve({ port, hostname: host, fetch: handler });
     return Promise.resolve({ stop: () => s.stop() });
   }
-  const { promise, resolve: resolve3, reject } = withResolvers();
+  const { promise, resolve: resolve4, reject } = withResolvers();
   const server = http__default.default.createServer(async (req, res) => {
     try {
       const url = new URL(req.url || "/", `http://${req.headers.host || `${host}:${port}`}`);
@@ -1580,7 +1637,7 @@ function startHttpServer(handler, host, port) {
   });
   server.once("error", reject);
   server.listen(port, host, () => {
-    resolve3({
+    resolve4({
       stop: () => {
         const close = withResolvers();
         server.close(() => close.resolve());
@@ -1724,8 +1781,8 @@ async function loadLanguagePack(moduleSpec) {
   try {
     let importPath = moduleSpec;
     if (moduleSpec.startsWith(".") || moduleSpec.startsWith("/") || moduleSpec.includes("\\") || moduleSpec.endsWith(".ts") || moduleSpec.endsWith(".js") || moduleSpec.endsWith(".mjs")) {
-      const { resolve: resolve3, pathToFileURL } = getPathUtils();
-      const resolved = resolve3(process.cwd(), moduleSpec);
+      const { resolve: resolve4, pathToFileURL } = getPathUtils();
+      const resolved = resolve4(process.cwd(), moduleSpec);
       importPath = pathToFileURL(resolved).href;
     }
     const imported = await import(
@@ -3944,7 +4001,7 @@ function parseCliArgs(args) {
       if (Number.isSafeInteger(v) && v >= 0) result.seedVersion = v;
       i++;
     } else if (!result.subcommand) {
-      if (arg === "parse" || arg === "run" || arg === "query" || arg === "download" || arg === "export" || arg === "import" || arg === "publish" || arg === "build" || arg === "seed" || arg === "reset" || arg === "init" || arg === "db" || arg === "server" || arg === "serve" || arg === "playground" || arg === "init-catalog" || arg === "help" || arg === "version") {
+      if (arg === "parse" || arg === "run" || arg === "query" || arg === "download" || arg === "export" || arg === "import" || arg === "publish" || arg === "build" || arg === "seed" || arg === "reset" || arg === "init" || arg === "db" || arg === "server" || arg === "serve" || arg === "playground" || arg === "init-catalog" || arg === "skills" || arg === "help" || arg === "version") {
         result.subcommand = arg;
       } else {
         result.target = arg;
@@ -3984,13 +4041,13 @@ function readBunStdinText() {
 async function readStdin() {
   const bunText = readBunStdinText();
   if (bunText) return bunText();
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve4, reject) => {
     const chunks = [];
     process.stdin.on("data", (chunk) => {
       chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
     });
     process.stdin.on("end", () => {
-      resolve3(Buffer.concat(chunks).toString("utf-8"));
+      resolve4(Buffer.concat(chunks).toString("utf-8"));
     });
     process.stdin.on("error", (err) => {
       reject(err);
@@ -4014,6 +4071,13 @@ USAGE:
                       Scaffold a new catalog repository (package.json, example
                       collection, GitHub Actions Pages workflow). Refuses an
                       existing destination.
+  wod skills <list | install> [options]
+                      Agent skills bundled with this CLI \u2014 the Whiteboard
+                      Script extraction rules an agent needs to parse and write
+                      correct workouts. install copies them to
+                      <dir>/.agents/skills/ (no network); they are also
+                      publishable via npx skills add bitcobblers/wod-wiki.
+  wod skills install [--dir <path>] [--force]
   wod seed [options]
   wod reset [options]
   wod init            Initialize the configured database (idempotent)
@@ -4268,12 +4332,47 @@ async function cliMain(argv = process.argv.slice(2), io = {}) {
         const result = scaffoldCatalog2(parsed.target);
         writeOut(`[wod init-catalog] Created ${result.dir} (${result.files.length} files)`);
         writeOut(`Next: cd ${parsed.target} && bun install && bunx wod build . --output dist`);
+        writeOut(`Agents: wod skills install --dir ${parsed.target}  (Whiteboard Script extraction rules \u2192 .agents/skills/)`);
         return 0;
       } catch (error) {
         writeErr(`[wod init-catalog] ${error.message}`);
         return 1;
       }
     }
+    if (parsed.subcommand === "skills") {
+      const action = parsed.target ?? "list";
+      const { bundledSkillsRoot: bundledSkillsRoot2, installSkills: installSkills2, listBundledSkills: listBundledSkills2 } = await Promise.resolve().then(() => (init_skills(), skills_exports));
+      try {
+        if (action === "list") {
+          const root = bundledSkillsRoot2();
+          if (!root) {
+            writeErr("[wod skills] No bundled skills found next to this CLI");
+            return 1;
+          }
+          const skills = listBundledSkills2(root);
+          for (const skill of skills) writeOut(`${skill.name} \u2014 ${skill.description}`);
+          writeOut(`[wod skills] ${skills.length} skill(s) from ${root}`);
+          return 0;
+        }
+        if (action === "install") {
+          const result = installSkills2({ dir: parsed.dir, force: parsed.force === true });
+          for (const name of result.installed) writeOut(`[wod skills] installed ${name} \u2192 ${nodePath().join(result.target, name)}`);
+          for (const name of result.skipped) writeOut(`[wod skills] ${name} already installed (use --force to replace)`);
+          writeOut(`[wod skills] ${result.installed.length} installed, ${result.skipped.length} kept \u2014 source ${result.root}`);
+          if (result.installed.length === 0 && result.skipped.length === 0) {
+            writeErr("[wod skills] No bundled skills found");
+            return 1;
+          }
+          writeOut("[wod skills] Agents read .agents/skills/; use `npx skills add bitcobblers/wod-wiki` for per-agent links.");
+          return 0;
+        }
+        writeErr(`[wod skills] Unknown action '${action}' (expected: list | install)`);
+        return 1;
+      } catch (error) {
+        writeErr(`[wod skills] ${error.message}`);
+        return 1;
+      }
+    }
     if (parsed.subcommand === "parse") {
       if (!parsed.target) {
         writeErr('[wod parse] Error: Missing input file or "-" for stdin');