@lumerahq/cli 0.8.0 → 0.9.0

package/dist/chunk-UP3GV4HN.js

@@ -0,0 +1,151 @@
+import {
+  getBaseUrl
+} from "./chunk-D2BLSEGR.js";
+
+// src/lib/skills.ts
+import { createHash } from "crypto";
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import pc from "picocolors";
+function slugToFilename(slug) {
+  const normalizedSlug = slug.startsWith("lumera-") ? slug : `lumera-${slug}`;
+  return `${normalizedSlug.replace(/-/g, "_")}.md`;
+}
+function filenameToSlug(filename) {
+  return filename.replace(/\.md$/, "").replace(/_/g, "-");
+}
+function hashContent(content) {
+  return createHash("md5").update(content).digest("hex");
+}
+async function fetchSkillsList() {
+  const baseUrl = getBaseUrl();
+  const skillsApiUrl = `${baseUrl}/api/public/skills`;
+  const listRes = await fetch(skillsApiUrl);
+  if (!listRes.ok) {
+    throw new Error(`Failed to fetch skills list: ${listRes.status}`);
+  }
+  return listRes.json();
+}
+async function fetchSkillContent(slug) {
+  const baseUrl = getBaseUrl();
+  const skillsApiUrl = `${baseUrl}/api/public/skills`;
+  const mdRes = await fetch(`${skillsApiUrl}/${slug}.md`);
+  if (!mdRes.ok) {
+    return null;
+  }
+  return mdRes.text();
+}
+function getLocalSkills(skillsDir) {
+  const localSkills = /* @__PURE__ */ new Map();
+  if (!existsSync(skillsDir)) {
+    return localSkills;
+  }
+  for (const file of readdirSync(skillsDir)) {
+    if (file.endsWith(".md")) {
+      const content = readFileSync(join(skillsDir, file), "utf-8");
+      const slug = filenameToSlug(file);
+      localSkills.set(slug, hashContent(content));
+    }
+  }
+  return localSkills;
+}
+function parseSkillSummary(content) {
+  const parts = content.split("\n---\n");
+  const header = parts[0];
+  const lines = header.split("\n");
+  let title = "";
+  const summaryLines = [];
+  let inSummary = false;
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (trimmed.startsWith("# ")) {
+      title = trimmed.slice(2).trim();
+      inSummary = true;
+      continue;
+    }
+    if (!inSummary || summaryLines.length === 0 && trimmed === "") continue;
+    if (trimmed === "" && summaryLines.length > 0) break;
+    summaryLines.push(trimmed);
+  }
+  return { title, summary: summaryLines.join(" ") };
+}
+async function installAllSkills(targetDir, options) {
+  const verbose = options?.verbose ?? false;
+  const skills = await fetchSkillsList();
+  const skillsDir = join(targetDir, ".claude", "skills");
+  mkdirSync(skillsDir, { recursive: true });
+  const results = await Promise.allSettled(
+    skills.map(async (skill) => {
+      const content = await fetchSkillContent(skill.slug);
+      return { skill, content };
+    })
+  );
+  let installed = 0;
+  let failed = 0;
+  for (const result of results) {
+    if (result.status === "fulfilled" && result.value.content) {
+      const { skill, content } = result.value;
+      const filename = slugToFilename(skill.slug);
+      writeFileSync(join(skillsDir, filename), content);
+      if (verbose) {
+        console.log(pc.green("  \u2713"), pc.dim(filename));
+      }
+      installed++;
+    } else {
+      if (verbose) {
+        const slug = result.status === "fulfilled" ? result.value.skill.slug : "unknown";
+        console.log(pc.yellow("  \u26A0"), pc.dim(`Failed to fetch ${slug}`));
+      }
+      failed++;
+    }
+  }
+  return { installed, failed };
+}
+var SKILLS_START_MARKER = "<!-- LUMERA_SKILLS_START -->";
+var SKILLS_END_MARKER = "<!-- LUMERA_SKILLS_END -->";
+function syncClaudeMd(projectRoot) {
+  const claudeMdPath = join(projectRoot, "CLAUDE.md");
+  const skillsDir = join(projectRoot, ".claude", "skills");
+  if (!existsSync(claudeMdPath)) {
+    return;
+  }
+  const claudeMd = readFileSync(claudeMdPath, "utf-8");
+  const startIdx = claudeMd.indexOf(SKILLS_START_MARKER);
+  const endIdx = claudeMd.indexOf(SKILLS_END_MARKER);
+  if (startIdx === -1 || endIdx === -1) {
+    console.log(pc.dim("  Skipping CLAUDE.md sync (no skill markers found)"));
+    return;
+  }
+  const skillEntries = [];
+  if (existsSync(skillsDir)) {
+    for (const file of readdirSync(skillsDir).sort()) {
+      if (!file.endsWith(".md")) continue;
+      const content = readFileSync(join(skillsDir, file), "utf-8");
+      const { title, summary } = parseSkillSummary(content);
+      const slug = filenameToSlug(file);
+      skillEntries.push({ slug, title, summary });
+    }
+  }
+  let generated;
+  if (skillEntries.length === 0) {
+    generated = "_No skills installed. Run `lumera skills install` to add skills._";
+  } else {
+    generated = skillEntries.map((s) => `**${s.slug}** \u2014 ${s.summary}`).join("\n\n");
+  }
+  const before = claudeMd.slice(0, startIdx + SKILLS_START_MARKER.length);
+  const after = claudeMd.slice(endIdx);
+  const updated = `${before}
+${generated}
+${after}`;
+  writeFileSync(claudeMdPath, updated);
+}
+
+export {
+  slugToFilename,
+  hashContent,
+  fetchSkillsList,
+  fetchSkillContent,
+  getLocalSkills,
+  installAllSkills,
+  syncClaudeMd
+};

package/dist/index.js

@@ -118,7 +118,7 @@ async function main() {
         break;
       // Project
       case "init":
-        await import("./init-OQCIET53.js").then((m) => m.init(args.slice(1)));
+        await import("./init-WQ4DQWXY.js").then((m) => m.init(args.slice(1)));
         break;
       case "status":
         await import("./status-E4IHEUKO.js").then((m) => m.status(args.slice(1)));
@@ -128,7 +128,7 @@ async function main() {
         break;
       // Skills
       case "skills":
-        await import("./skills-56EUKHGY.js").then((m) => m.skills(subcommand, args.slice(2)));
+        await import("./skills-MMDJDUGC.js").then((m) => m.skills(subcommand, args.slice(2)));
         break;
       // Auth
       case "login":

package/dist/{init-OQCIET53.js → init-WQ4DQWXY.js}

@@ -1,6 +1,8 @@
 import {
-  getBaseUrl
-} from "./chunk-D2BLSEGR.js";
+  installAllSkills,
+  syncClaudeMd
+} from "./chunk-UP3GV4HN.js";
+import "./chunk-D2BLSEGR.js";
 
 // src/commands/init.ts
 import pc from "picocolors";
@@ -113,28 +115,6 @@ function createPythonVenv(targetDir) {
     return false;
   }
 }
-async function installSkills(targetDir) {
-  const baseUrl = getBaseUrl();
-  const skillsApiUrl = `${baseUrl}/api/public/skills`;
-  const listRes = await fetch(skillsApiUrl);
-  if (!listRes.ok) {
-    throw new Error(`Failed to fetch skills list: ${listRes.status}`);
-  }
-  const skills = await listRes.json();
-  const skillsDir = join(targetDir, ".claude", "skills");
-  mkdirSync(skillsDir, { recursive: true });
-  for (const skill of skills) {
-    const mdRes = await fetch(`${skillsApiUrl}/${skill.slug}.md`);
-    if (!mdRes.ok) {
-      console.log(pc.yellow("  \u26A0"), pc.dim(`Failed to fetch skill ${skill.slug}`));
-      continue;
-    }
-    const content = await mdRes.text();
-    const slug = skill.slug.startsWith("lumera-") ? skill.slug : `lumera-${skill.slug}`;
-    const filename = `${slug.replace(/-/g, "_")}.md`;
-    writeFileSync(join(skillsDir, filename), content);
-  }
-}
 function parseArgs(args) {
   const result = {
     projectName: void 0,
@@ -342,8 +322,13 @@ async function init(args) {
   console.log();
   console.log(pc.dim("  Installing Lumera skills for AI agents..."));
   try {
-    await installSkills(targetDir);
-    console.log(pc.green("  \u2713"), pc.dim("Lumera skills installed"));
+    const { installed, failed } = await installAllSkills(targetDir);
+    if (failed > 0) {
+      console.log(pc.yellow("  \u26A0"), pc.dim(`Installed ${installed} skills (${failed} failed)`));
+    } else {
+      console.log(pc.green("  \u2713"), pc.dim(`${installed} Lumera skills installed`));
+    }
+    syncClaudeMd(targetDir);
   } catch (err) {
     console.log(pc.yellow("  \u26A0"), pc.dim(`Failed to install skills: ${err}`));
   }

package/dist/{skills-56EUKHGY.js → skills-MMDJDUGC.js}

@@ -1,11 +1,17 @@
 import {
-  getBaseUrl
-} from "./chunk-D2BLSEGR.js";
+  fetchSkillContent,
+  fetchSkillsList,
+  getLocalSkills,
+  hashContent,
+  installAllSkills,
+  slugToFilename,
+  syncClaudeMd
+} from "./chunk-UP3GV4HN.js";
+import "./chunk-D2BLSEGR.js";
 
 // src/commands/skills.ts
 import pc from "picocolors";
-import { createHash } from "crypto";
-import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from "fs";
+import { existsSync, readdirSync, rmSync, writeFileSync } from "fs";
 import { join, resolve } from "path";
 function findProjectRoot() {
   let dir = process.cwd();
@@ -17,48 +23,6 @@ function findProjectRoot() {
   }
   return null;
 }
-function slugToFilename(slug) {
-  const normalizedSlug = slug.startsWith("lumera-") ? slug : `lumera-${slug}`;
-  return `${normalizedSlug.replace(/-/g, "_")}.md`;
-}
-function filenameToSlug(filename) {
-  return filename.replace(/\.md$/, "").replace(/_/g, "-");
-}
-function hashContent(content) {
-  return createHash("md5").update(content).digest("hex");
-}
-async function fetchSkillsList() {
-  const baseUrl = getBaseUrl();
-  const skillsApiUrl = `${baseUrl}/api/public/skills`;
-  const listRes = await fetch(skillsApiUrl);
-  if (!listRes.ok) {
-    throw new Error(`Failed to fetch skills list: ${listRes.status}`);
-  }
-  return listRes.json();
-}
-async function fetchSkillContent(slug) {
-  const baseUrl = getBaseUrl();
-  const skillsApiUrl = `${baseUrl}/api/public/skills`;
-  const mdRes = await fetch(`${skillsApiUrl}/${slug}.md`);
-  if (!mdRes.ok) {
-    return null;
-  }
-  return mdRes.text();
-}
-function getLocalSkills(skillsDir) {
-  const localSkills = /* @__PURE__ */ new Map();
-  if (!existsSync(skillsDir)) {
-    return localSkills;
-  }
-  for (const file of readdirSync(skillsDir)) {
-    if (file.endsWith(".md")) {
-      const content = readFileSync(join(skillsDir, file), "utf-8");
-      const slug = filenameToSlug(file);
-      localSkills.set(slug, hashContent(content));
-    }
-  }
-  return localSkills;
-}
 async function computeDiff(skillsDir, filterSlug) {
   const skills2 = await fetchSkillsList();
   const localSkills = getLocalSkills(skillsDir);
@@ -69,28 +33,31 @@ async function computeDiff(skillsDir, filterSlug) {
     removed: [],
     unchanged: []
   };
-  for (const skill of skills2) {
-    if (filterSlug) {
-      const normalizedFilter = filterSlug.startsWith("lumera-") ? filterSlug : `lumera-${filterSlug}`;
-      const normalizedSlug2 = skill.slug.startsWith("lumera-") ? skill.slug : `lumera-${skill.slug}`;
-      if (normalizedSlug2 !== normalizedFilter && skill.slug !== filterSlug) {
-        continue;
-      }
-    }
+  const skillsToCheck = filterSlug ? skills2.filter((skill) => {
+    const normalizedFilter = filterSlug.startsWith("lumera-") ? filterSlug : `lumera-${filterSlug}`;
+    const normalizedSlug = skill.slug.startsWith("lumera-") ? skill.slug : `lumera-${skill.slug}`;
+    return normalizedSlug === normalizedFilter || skill.slug === filterSlug;
+  }) : skills2;
+  const remoteResults = await Promise.allSettled(
+    skillsToCheck.map(async (skill) => {
+      const content = await fetchSkillContent(skill.slug);
+      return { skill, content };
+    })
+  );
+  for (const result of remoteResults) {
+    if (result.status !== "fulfilled" || !result.value.content) continue;
+    const { skill, content } = result.value;
     const normalizedSlug = skill.slug.startsWith("lumera-") ? skill.slug : `lumera-${skill.slug}`;
     remoteSkillSlugs.add(normalizedSlug);
     const localHash = localSkills.get(normalizedSlug);
     if (!localHash) {
       diff.added.push(skill);
     } else {
-      const remoteContent = await fetchSkillContent(skill.slug);
-      if (remoteContent) {
-        const remoteHash = hashContent(remoteContent);
-        if (localHash !== remoteHash) {
-          diff.updated.push(skill);
-        } else {
-          diff.unchanged.push(skill.slug);
-        }
+      const remoteHash = hashContent(content);
+      if (localHash !== remoteHash) {
+        diff.updated.push(skill);
+      } else {
+        diff.unchanged.push(skill.slug);
       }
     }
   }
@@ -103,6 +70,43 @@ async function computeDiff(skillsDir, filterSlug) {
   }
   return diff;
 }
+function parseFlags(args) {
+  const result = {};
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg.startsWith("--")) {
+      const key = arg.slice(2);
+      const next = args[i + 1];
+      if (next && !next.startsWith("-")) {
+        result[key] = next;
+        i++;
+      } else {
+        result[key] = true;
+      }
+    } else if (arg.startsWith("-") && arg.length === 2) {
+      const key = arg.slice(1);
+      result[key] = true;
+    }
+  }
+  return result;
+}
+function getPositionalArgs(args) {
+  const positional = [];
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg.startsWith("-")) {
+      if (arg.startsWith("--")) {
+        const next = args[i + 1];
+        if (next && !next.startsWith("-")) {
+          i++;
+        }
+      }
+      continue;
+    }
+    positional.push(arg);
+  }
+  return positional;
+}
 function showHelp() {
   console.log(`
 ${pc.dim("Usage:")}
@@ -156,43 +160,6 @@ async function skills(subcommand, args) {
       process.exit(1);
   }
 }
-function parseFlags(args) {
-  const result = {};
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (arg.startsWith("--")) {
-      const key = arg.slice(2);
-      const next = args[i + 1];
-      if (next && !next.startsWith("-")) {
-        result[key] = next;
-        i++;
-      } else {
-        result[key] = true;
-      }
-    } else if (arg.startsWith("-") && arg.length === 2) {
-      const key = arg.slice(1);
-      result[key] = true;
-    }
-  }
-  return result;
-}
-function getPositionalArgs(args) {
-  const positional = [];
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (arg.startsWith("-")) {
-      if (arg.startsWith("--")) {
-        const next = args[i + 1];
-        if (next && !next.startsWith("-")) {
-          i++;
-        }
-      }
-      continue;
-    }
-    positional.push(arg);
-  }
-  return positional;
-}
 async function list(flags) {
   const verbose = Boolean(flags.verbose || flags.v);
   console.log();
@@ -247,36 +214,17 @@ async function install(flags) {
   }
   if (verbose) {
     console.log(pc.dim(`  Project root: ${projectRoot}`));
-    console.log(pc.dim(`  Fetching skills from ${getBaseUrl()}...`));
+    console.log(pc.dim(`  Fetching skills...`));
   }
-  try {
-    const skills2 = await fetchSkillsList();
-    mkdirSync(skillsDir, { recursive: true });
-    if (force && existsSync(skillsDir)) {
-      for (const file of readdirSync(skillsDir)) {
-        if (file.endsWith(".md")) {
-          rmSync(join(skillsDir, file));
-        }
-      }
-    }
-    let installed = 0;
-    let failed = 0;
-    for (const skill of skills2) {
-      const content = await fetchSkillContent(skill.slug);
-      if (!content) {
-        if (verbose) {
-          console.log(pc.yellow("  \u26A0"), pc.dim(`Failed to fetch ${skill.slug}`));
-        }
-        failed++;
-        continue;
+  if (force && existsSync(skillsDir)) {
+    for (const file of readdirSync(skillsDir)) {
+      if (file.endsWith(".md")) {
+        rmSync(join(skillsDir, file));
       }
-      const filename = slugToFilename(skill.slug);
-      writeFileSync(join(skillsDir, filename), content);
-      if (verbose) {
-        console.log(pc.green("  \u2713"), pc.dim(filename));
-      }
-      installed++;
     }
+  }
+  try {
+    const { installed, failed } = await installAllSkills(projectRoot, { verbose });
     console.log();
     if (failed > 0) {
       console.log(pc.yellow("  \u26A0"), `Installed ${installed} skills (${failed} failed)`);
@@ -284,6 +232,7 @@ async function install(flags) {
       console.log(pc.green("  \u2713"), `Installed ${installed} skills`);
     }
     console.log(pc.dim(`  Location: .claude/skills/`));
+    syncClaudeMd(projectRoot);
     console.log();
   } catch (err) {
     console.log(pc.red("  Error:"), String(err));
@@ -377,19 +326,22 @@ async function update(args, flags) {
     }
     console.log(pc.dim("  Applying changes..."));
     console.log();
-    for (const skill of diff.added) {
-      const content = await fetchSkillContent(skill.slug);
-      if (content) {
-        const filename = slugToFilename(skill.slug);
-        writeFileSync(join(skillsDir, filename), content);
+    const toFetch = [...diff.added, ...diff.updated];
+    const fetchResults = await Promise.allSettled(
+      toFetch.map(async (skill) => {
+        const content = await fetchSkillContent(skill.slug);
+        return { skill, content };
+      })
+    );
+    for (const result of fetchResults) {
+      if (result.status !== "fulfilled" || !result.value.content) continue;
+      const { skill, content } = result.value;
+      const filename = slugToFilename(skill.slug);
+      writeFileSync(join(skillsDir, filename), content);
+      const isNew = diff.added.includes(skill);
+      if (isNew) {
         console.log(pc.green("  +"), `Added ${skill.name}`);
-      }
-    }
-    for (const skill of diff.updated) {
-      const content = await fetchSkillContent(skill.slug);
-      if (content) {
-        const filename = slugToFilename(skill.slug);
-        writeFileSync(join(skillsDir, filename), content);
+      } else {
         console.log(pc.yellow("  ~"), `Updated ${skill.name}`);
       }
     }
@@ -403,6 +355,7 @@ async function update(args, flags) {
     }
     console.log();
     console.log(pc.green("  \u2713"), `Update complete (${changes.join(", ")})`);
+    syncClaudeMd(projectRoot);
     console.log();
   } catch (err) {
     console.log(pc.red("  Error:"), String(err));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumerahq/cli",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "CLI for building and deploying Lumera apps",
   "type": "module",
   "engines": {

package/templates/default/CLAUDE.md

@@ -6,26 +6,19 @@
 
 ## AI Agent Skills
 
-This project includes Lumera skills for AI coding agents. Skills provide detailed documentation for building on the Lumera platform.
+This project includes Lumera skills for AI coding agents in `.claude/skills/`. Read the relevant skill file when you need detailed API docs and usage patterns for that capability.
 
-**Installed skills** (in `.claude/skills/`):
-- **lumera-collections** - Collections and Records API
-- **lumera-automations** - Python automation scripts
-- **lumera-webhooks** - Receiving external webhooks
-- **write-hooks** - Server-side JavaScript hooks
-- **lumera-sdk** - Python SDK reference
-- **using-lumera** - Platform overview and patterns
+<!-- LUMERA_SKILLS_START -->
+_Run `lumera skills install` to populate skill descriptions._
+<!-- LUMERA_SKILLS_END -->
 
-### Installing/Updating Skills
-
-Skills are auto-installed when creating the app. To manually install or update:
+### Managing Skills
 
 ```bash
-npx skills add git@github.com:lumerahq/lumera-skills.git
+lumera skills update              # Update all skills to latest
+lumera skills install --force     # Re-install from scratch
 ```
 
-> **Note:** Requires SSH access to the lumerahq GitHub organization.
-
 ---
 
 ## Quick Reference