@meltstudio/meltctl 5.8.0 → 5.9.0

package/dist/index.js

@@ -7450,7 +7450,7 @@ var CLI_VERSION;
 var init_version = __esm({
   "src/utils/version.ts"() {
     "use strict";
-    CLI_VERSION = "5.8.0";
+    CLI_VERSION = "5.9.0";
   }
 });
 
@@ -42515,6 +42515,253 @@ async function logoutCommand() {
 // src/index.ts
 init_version_check();
 
+// src/utils/skills-sync.ts
+init_source();
+
+// src/utils/debug.ts
+init_source();
+function debugLog(message) {
+  if (process.env["MELTCTL_DEBUG"]) {
+    console.error(source_default.dim(`[debug] ${message}`));
+  }
+}
+
+// src/commands/skills.ts
+init_source();
+var import_fs_extra3 = __toESM(require_lib(), 1);
+import { createHash } from "crypto";
+import os5 from "os";
+import path5 from "path";
+
+// src/utils/api.ts
+init_source();
+async function getToken() {
+  const envToken = process.env["MELTCTL_TOKEN"];
+  if (envToken) {
+    return envToken;
+  }
+  const auth = await getStoredAuth();
+  if (!auth) {
+    console.error(
+      source_default.red(
+        "Not authenticated. Run `npx @meltstudio/meltctl@latest login` or set MELTCTL_TOKEN for CI."
+      )
+    );
+    process.exit(1);
+  }
+  if (new Date(auth.expiresAt) <= /* @__PURE__ */ new Date()) {
+    console.error(
+      source_default.red(
+        "Session expired. Run `npx @meltstudio/meltctl@latest login` to re-authenticate, or set MELTCTL_TOKEN for CI."
+      )
+    );
+    process.exit(1);
+  }
+  return auth.token;
+}
+async function getClient() {
+  const token = await getToken();
+  return createMeltClient({ baseUrl: API_BASE, token });
+}
+
+// src/commands/skills.ts
+var MARKER_FILE = ".melt-skills.json";
+function getSkillsRoot() {
+  return path5.join(os5.homedir(), ".claude", "skills");
+}
+function computeSkillHash(files) {
+  const hash2 = createHash("sha256");
+  for (const filePath of Object.keys(files).sort()) {
+    hash2.update(filePath);
+    hash2.update(files[filePath] ?? "");
+  }
+  return hash2.digest("hex").slice(0, 12);
+}
+function readMarker(skillsRoot) {
+  const markerPath = path5.join(skillsRoot, MARKER_FILE);
+  if (!import_fs_extra3.default.existsSync(markerPath)) return null;
+  try {
+    const raw = import_fs_extra3.default.readJsonSync(markerPath);
+    const skills2 = Array.isArray(raw.skills) ? raw.skills.map((entry) => {
+      if (typeof entry === "string") {
+        return { name: entry, hash: "" };
+      }
+      if (entry && typeof entry === "object") {
+        const e = entry;
+        return {
+          name: typeof e.name === "string" ? e.name : "",
+          hash: typeof e.hash === "string" ? e.hash : ""
+        };
+      }
+      return { name: "", hash: "" };
+    }) : [];
+    return {
+      version: typeof raw.version === "string" ? raw.version : "",
+      installedAt: typeof raw.installedAt === "string" ? raw.installedAt : "",
+      lastCheckedAt: typeof raw.lastCheckedAt === "string" ? raw.lastCheckedAt : void 0,
+      skills: skills2
+    };
+  } catch {
+    return null;
+  }
+}
+function computeDiff(previous, next) {
+  const prevByName = new Map(previous.map((s) => [s.name, s]));
+  const nextNames = new Set(next.map((s) => s.name));
+  const added = [];
+  const changed = [];
+  for (const skill of next) {
+    const prev = prevByName.get(skill.name);
+    if (!prev) {
+      added.push(skill.name);
+      continue;
+    }
+    if (prev.hash && prev.hash !== skill.hash) {
+      changed.push(skill.name);
+    }
+  }
+  const removed = previous.filter((s) => s.name && !nextNames.has(s.name)).map((s) => s.name);
+  return { added, changed, removed };
+}
+function applyDevSkills(manifest, skillsRoot) {
+  const previous = readMarker(skillsRoot)?.skills ?? [];
+  const nextEntries = manifest.skills.map((s) => ({
+    name: s.name,
+    hash: computeSkillHash(s.files)
+  }));
+  const diff = computeDiff(previous, nextEntries);
+  for (const name of diff.removed) {
+    import_fs_extra3.default.removeSync(path5.join(skillsRoot, name));
+  }
+  for (const skill of manifest.skills) {
+    const dir = path5.join(skillsRoot, skill.name);
+    import_fs_extra3.default.removeSync(dir);
+    for (const [relPath, content] of Object.entries(skill.files)) {
+      import_fs_extra3.default.outputFileSync(path5.join(dir, relPath), content);
+    }
+  }
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const marker = {
+    version: manifest.version,
+    installedAt: now,
+    lastCheckedAt: now,
+    skills: nextEntries
+  };
+  import_fs_extra3.default.outputFileSync(path5.join(skillsRoot, MARKER_FILE), `${JSON.stringify(marker, null, 2)}
+`);
+  return diff;
+}
+function touchMarkerLastChecked(skillsRoot) {
+  const marker = readMarker(skillsRoot);
+  if (!marker) return;
+  marker.lastCheckedAt = (/* @__PURE__ */ new Date()).toISOString();
+  import_fs_extra3.default.outputFileSync(path5.join(skillsRoot, MARKER_FILE), `${JSON.stringify(marker, null, 2)}
+`);
+}
+async function skillsInstallCommand(opts) {
+  const client = await getClient();
+  let manifest;
+  try {
+    manifest = await client.skills.getDevSkills();
+  } catch (error48) {
+    console.error(
+      source_default.red(
+        `Failed to fetch Melt dev skills: ${error48 instanceof Error ? error48.message : "Unknown error"}`
+      )
+    );
+    process.exit(1);
+  }
+  const skillsRoot = getSkillsRoot();
+  const existing = readMarker(skillsRoot);
+  if (existing && existing.version === manifest.version && !opts.force) {
+    console.log(
+      source_default.dim(
+        `
+  Melt dev skills already up to date (v${manifest.version}). Use --force to reinstall.
+`
+      )
+    );
+    return;
+  }
+  applyDevSkills(manifest, skillsRoot);
+  console.log(
+    source_default.green(
+      `
+  \u2713 Installed ${manifest.skills.length} Melt dev skills (v${manifest.version}) to ~/.claude/skills/.`
+    )
+  );
+  console.log(
+    source_default.dim(
+      "  Restart Claude Code to load them (they appear as /melt-dev-plan, /melt-dev-review, \u2026).\n"
+    )
+  );
+}
+
+// src/utils/skills-sync.ts
+var TWENTY_FOUR_HOURS_MS = 24 * 60 * 60 * 1e3;
+var SKIP_SYNC_COMMANDS = /* @__PURE__ */ new Set(["skills", "login", "logout", "update", "version"]);
+function formatSyncNotice(oldVersion, newVersion, diff) {
+  const groups = [];
+  if (diff.changed.length > 0) groups.push(`changed ${diff.changed.join(", ")}`);
+  if (diff.added.length > 0) groups.push(`added ${diff.added.join(", ")}`);
+  if (diff.removed.length > 0) groups.push(`removed ${diff.removed.join(", ")}`);
+  const suffix = groups.length > 0 ? `: ${groups.join("; ")}` : "";
+  return `\u2191 Melt dev skills updated (v${oldVersion} \u2192 v${newVersion})${suffix}`;
+}
+function isCheckDue(lastCheckedAt, now) {
+  if (!lastCheckedAt) return true;
+  const last = Date.parse(lastCheckedAt);
+  if (Number.isNaN(last)) return true;
+  return now - last >= TWENTY_FOUR_HOURS_MS;
+}
+async function maybeSyncSkills(commandName) {
+  try {
+    if (process.env["MELTCTL_SKIP_SKILLS_SYNC"]) {
+      debugLog("Skills sync disabled via MELTCTL_SKIP_SKILLS_SYNC");
+      return;
+    }
+    if (commandName && SKIP_SYNC_COMMANDS.has(commandName)) {
+      debugLog(`Skills sync skipped for command "${commandName}"`);
+      return;
+    }
+    const auth = await getStoredAuth();
+    if (!auth || new Date(auth.expiresAt) <= /* @__PURE__ */ new Date()) {
+      debugLog("Skills sync skipped: not authenticated or token expired");
+      return;
+    }
+    const skillsRoot = getSkillsRoot();
+    const marker = readMarker(skillsRoot);
+    if (!marker) {
+      debugLog("Skills sync skipped: no skills marker (not installed)");
+      return;
+    }
+    if (!isCheckDue(marker.lastCheckedAt, Date.now())) {
+      debugLog("Skills sync skipped: checked within the last 24h");
+      return;
+    }
+    const client = createMeltClient({ baseUrl: API_BASE, token: auth.token });
+    let manifest;
+    try {
+      manifest = await client.skills.getDevSkills();
+    } catch (e) {
+      touchMarkerLastChecked(skillsRoot);
+      debugLog(`Skills sync fetch error: ${e instanceof Error ? e.message : e}`);
+      return;
+    }
+    if (manifest.version === marker.version) {
+      touchMarkerLastChecked(skillsRoot);
+      debugLog("Skills sync: already up to date");
+      return;
+    }
+    const oldVersion = marker.version;
+    const diff = applyDevSkills(manifest, skillsRoot);
+    console.log(source_default.dim(source_default.green(formatSyncNotice(oldVersion, manifest.version, diff))));
+    debugLog(`Skills sync: updated ${oldVersion} \u2192 ${manifest.version}`);
+  } catch (e) {
+    debugLog(`Skills sync error: ${e instanceof Error ? e.message : e}`);
+  }
+}
+
 // src/commands/version.ts
 init_source();
 init_version_check();
@@ -42611,39 +42858,6 @@ async function versionCheckCommand() {
 // src/commands/standup.ts
 init_source();
 init_dist11();
-
-// src/utils/api.ts
-init_source();
-async function getToken() {
-  const envToken = process.env["MELTCTL_TOKEN"];
-  if (envToken) {
-    return envToken;
-  }
-  const auth = await getStoredAuth();
-  if (!auth) {
-    console.error(
-      source_default.red(
-        "Not authenticated. Run `npx @meltstudio/meltctl@latest login` or set MELTCTL_TOKEN for CI."
-      )
-    );
-    process.exit(1);
-  }
-  if (new Date(auth.expiresAt) <= /* @__PURE__ */ new Date()) {
-    console.error(
-      source_default.red(
-        "Session expired. Run `npx @meltstudio/meltctl@latest login` to re-authenticate, or set MELTCTL_TOKEN for CI."
-      )
-    );
-    process.exit(1);
-  }
-  return auth.token;
-}
-async function getClient() {
-  const token = await getToken();
-  return createMeltClient({ baseUrl: API_BASE, token });
-}
-
-// src/commands/standup.ts
 var EDITOR_HINT = source_default.dim("(type \\e to open your editor)");
 async function promptField(message, required2) {
   const value = await dist_default7({ message: `${message} ${EDITOR_HINT}` });
@@ -42865,12 +43079,12 @@ async function showLeaderboard() {
 
 // src/commands/audit.ts
 init_source();
-var import_fs_extra4 = __toESM(require_lib(), 1);
-import path6 from "path";
+var import_fs_extra5 = __toESM(require_lib(), 1);
+import path7 from "path";
 
 // src/utils/git.ts
-var import_fs_extra3 = __toESM(require_lib(), 1);
-import path5 from "path";
+var import_fs_extra4 = __toESM(require_lib(), 1);
+import path6 from "path";
 import { execSync as execSync4 } from "child_process";
 function getGitBranch() {
   try {
@@ -42908,34 +43122,34 @@ function getGitRepository() {
 function getProjectName() {
   const cwd = process.cwd();
   try {
-    const pkgPath = path5.join(cwd, "package.json");
-    if (import_fs_extra3.default.pathExistsSync(pkgPath)) {
-      const pkg = import_fs_extra3.default.readJsonSync(pkgPath);
+    const pkgPath = path6.join(cwd, "package.json");
+    if (import_fs_extra4.default.pathExistsSync(pkgPath)) {
+      const pkg = import_fs_extra4.default.readJsonSync(pkgPath);
       if (pkg.name) {
         return pkg.name;
       }
     }
   } catch {
   }
-  return path5.basename(cwd);
+  return path6.basename(cwd);
 }
 function extractTicketId(branch) {
   const match = branch.match(/([A-Z]+-\d+)/i);
   return match ? match[1] : null;
 }
 async function findMdFiles(dir) {
-  if (!await import_fs_extra3.default.pathExists(dir)) {
+  if (!await import_fs_extra4.default.pathExists(dir)) {
     return [];
   }
   const results = [];
   async function walk(current) {
-    const entries = await import_fs_extra3.default.readdir(current, { withFileTypes: true });
+    const entries = await import_fs_extra4.default.readdir(current, { withFileTypes: true });
     for (const entry of entries) {
-      const fullPath = path5.join(current, entry.name);
+      const fullPath = path6.join(current, entry.name);
       if (entry.isDirectory()) {
         await walk(fullPath);
       } else if (entry.isFile() && entry.name.endsWith(".md")) {
-        const stat = await import_fs_extra3.default.stat(fullPath);
+        const stat = await import_fs_extra4.default.stat(fullPath);
         results.push({ path: fullPath, mtime: stat.mtimeMs });
       }
     }
@@ -42954,15 +43168,15 @@ function detectAuditType(filename) {
 }
 async function autoDetectAuditFile() {
   const cwd = process.cwd();
-  const auditsDir = path6.join(cwd, ".audits");
+  const auditsDir = path7.join(cwd, ".audits");
   const auditFiles = await findMdFiles(auditsDir);
   if (auditFiles.length > 0) {
     return auditFiles[0] ?? null;
   }
   const candidates = ["AUDIT.md", "UX-AUDIT.md", "SECURITY-AUDIT.md"];
   for (const name of candidates) {
-    const filePath = path6.join(cwd, name);
-    if (await import_fs_extra4.default.pathExists(filePath)) {
+    const filePath = path7.join(cwd, name);
+    if (await import_fs_extra5.default.pathExists(filePath)) {
       return filePath;
     }
   }
@@ -42972,7 +43186,7 @@ async function auditSubmitCommand(file2) {
   const client = await getClient();
   let filePath;
   if (file2) {
-    filePath = path6.resolve(file2);
+    filePath = path7.resolve(file2);
   } else {
     const detected = await autoDetectAuditFile();
     if (!detected) {
@@ -42984,14 +43198,14 @@ async function auditSubmitCommand(file2) {
       process.exit(1);
     }
     filePath = detected;
-    console.log(source_default.dim(`Auto-detected audit file: ${path6.relative(process.cwd(), filePath)}`));
+    console.log(source_default.dim(`Auto-detected audit file: ${path7.relative(process.cwd(), filePath)}`));
   }
-  if (!await import_fs_extra4.default.pathExists(filePath)) {
+  if (!await import_fs_extra5.default.pathExists(filePath)) {
     console.error(source_default.red(`File not found: ${filePath}`));
     process.exit(1);
   }
-  const content = await import_fs_extra4.default.readFile(filePath, "utf-8");
-  const filename = path6.basename(filePath);
+  const content = await import_fs_extra5.default.readFile(filePath, "utf-8");
+  const filename = path7.basename(filePath);
   const auditType = detectAuditType(filename);
   const project2 = getProjectName();
   const branch = getGitBranch();
@@ -43116,11 +43330,11 @@ async function auditViewCommand(id, options) {
   try {
     const audit2 = await client.audits.get(id);
     if (options.output) {
-      const outputPath = path6.resolve(options.output);
-      await import_fs_extra4.default.ensureDir(path6.dirname(outputPath));
-      await import_fs_extra4.default.writeFile(outputPath, audit2.content, "utf-8");
+      const outputPath = path7.resolve(options.output);
+      await import_fs_extra5.default.ensureDir(path7.dirname(outputPath));
+      await import_fs_extra5.default.writeFile(outputPath, audit2.content, "utf-8");
       console.log(source_default.green(`
-  \u2713 Audit saved to ${path6.relative(process.cwd(), outputPath)}
+  \u2713 Audit saved to ${path7.relative(process.cwd(), outputPath)}
 `));
     } else {
       const typeLabels = {
@@ -43152,8 +43366,8 @@ async function auditViewCommand(id, options) {
 
 // src/commands/plan.ts
 init_source();
-var import_fs_extra5 = __toESM(require_lib(), 1);
-import path7 from "path";
+var import_fs_extra6 = __toESM(require_lib(), 1);
+import path8 from "path";
 function extractFrontmatterStatus(content) {
   const match = content.match(/^---\n([\s\S]*?)\n---/);
   if (!match) return null;
@@ -43162,7 +43376,7 @@ function extractFrontmatterStatus(content) {
 }
 async function autoDetectPlanFile() {
   const cwd = process.cwd();
-  const plansDir = path7.join(cwd, ".plans");
+  const plansDir = path8.join(cwd, ".plans");
   const mdFiles = await findMdFiles(plansDir);
   if (mdFiles.length === 0) {
     return null;
@@ -43171,7 +43385,7 @@ async function autoDetectPlanFile() {
   const ticketId = extractTicketId(branch);
   if (ticketId) {
     const ticketLower = ticketId.toLowerCase();
-    const match = mdFiles.find((f) => path7.basename(f).toLowerCase().includes(ticketLower));
+    const match = mdFiles.find((f) => path8.basename(f).toLowerCase().includes(ticketLower));
     if (match) {
       return match;
     }
@@ -43182,7 +43396,7 @@ async function planSubmitCommand(file2) {
   const client = await getClient();
   let filePath;
   if (file2) {
-    filePath = path7.resolve(file2);
+    filePath = path8.resolve(file2);
   } else {
     const detected = await autoDetectPlanFile();
     if (!detected) {
@@ -43194,14 +43408,14 @@ async function planSubmitCommand(file2) {
       process.exit(1);
     }
     filePath = detected;
-    console.log(source_default.dim(`Auto-detected plan file: ${path7.relative(process.cwd(), filePath)}`));
+    console.log(source_default.dim(`Auto-detected plan file: ${path8.relative(process.cwd(), filePath)}`));
   }
-  if (!await import_fs_extra5.default.pathExists(filePath)) {
+  if (!await import_fs_extra6.default.pathExists(filePath)) {
     console.error(source_default.red(`File not found: ${filePath}`));
     process.exit(1);
   }
-  const content = await import_fs_extra5.default.readFile(filePath, "utf-8");
-  const filename = path7.basename(filePath);
+  const content = await import_fs_extra6.default.readFile(filePath, "utf-8");
+  const filename = path8.basename(filePath);
   const project2 = getProjectName();
   const branch = getGitBranch();
   const commit = getGitCommit();
@@ -43288,84 +43502,9 @@ async function planListCommand(options) {
   }
 }
 
-// src/commands/skills.ts
-init_source();
-var import_fs_extra6 = __toESM(require_lib(), 1);
-import os5 from "os";
-import path8 from "path";
-var MARKER_FILE = ".melt-skills.json";
-function readMarker(skillsRoot) {
-  const markerPath = path8.join(skillsRoot, MARKER_FILE);
-  if (!import_fs_extra6.default.existsSync(markerPath)) return null;
-  try {
-    return import_fs_extra6.default.readJsonSync(markerPath);
-  } catch {
-    return null;
-  }
-}
-async function skillsInstallCommand(opts) {
-  const client = await getClient();
-  let manifest;
-  try {
-    manifest = await client.skills.getDevSkills();
-  } catch (error48) {
-    console.error(
-      source_default.red(
-        `Failed to fetch Melt dev skills: ${error48 instanceof Error ? error48.message : "Unknown error"}`
-      )
-    );
-    process.exit(1);
-  }
-  const skillsRoot = path8.join(os5.homedir(), ".claude", "skills");
-  const existing = readMarker(skillsRoot);
-  if (existing && existing.version === manifest.version && !opts.force) {
-    console.log(
-      source_default.dim(
-        `
-  Melt dev skills already up to date (v${manifest.version}). Use --force to reinstall.
-`
-      )
-    );
-    return;
-  }
-  for (const skill of manifest.skills) {
-    const dir = path8.join(skillsRoot, skill.name);
-    import_fs_extra6.default.removeSync(dir);
-    for (const [relPath, content] of Object.entries(skill.files)) {
-      import_fs_extra6.default.outputFileSync(path8.join(dir, relPath), content);
-    }
-  }
-  const marker = {
-    version: manifest.version,
-    installedAt: (/* @__PURE__ */ new Date()).toISOString(),
-    skills: manifest.skills.map((s) => s.name)
-  };
-  import_fs_extra6.default.outputFileSync(path8.join(skillsRoot, MARKER_FILE), `${JSON.stringify(marker, null, 2)}
-`);
-  console.log(
-    source_default.green(
-      `
-  \u2713 Installed ${manifest.skills.length} Melt dev skills (v${manifest.version}) to ~/.claude/skills/.`
-    )
-  );
-  console.log(
-    source_default.dim(
-      "  Restart Claude Code to load them (they appear as /melt-dev-plan, /melt-dev-review, \u2026).\n"
-    )
-  );
-}
-
 // src/index.ts
 init_update();
 
-// src/utils/debug.ts
-init_source();
-function debugLog(message) {
-  if (process.env["MELTCTL_DEBUG"]) {
-    console.error(source_default.dim(`[debug] ${message}`));
-  }
-}
-
 // src/utils/analytics.ts
 init_version();
 async function trackCommand(command, success2, errorMessage) {
@@ -55777,6 +55916,7 @@ ${source_default.dim("  event track --skill    Track skill usage (called by skil
     cmd = cmd.parent;
   }
   await checkAndEnforceUpdate(cmd.name());
+  await maybeSyncSkills(cmd.name());
 }).hook("postAction", async (_thisCommand, actionCommand) => {
   try {
     const parts = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meltstudio/meltctl",
-  "version": "5.8.0",
+  "version": "5.9.0",
   "description": "AI-first development tooling for Melt teams — companion CLI for the org-distributed Claude Code dev skills",
   "main": "dist/index.js",
   "type": "module",