@spardutti/claude-skills 2.33.7 → 2.34.0

package/README.md

@@ -169,7 +169,13 @@ Every install writes a manifest at `.claude/.claude-skills.json` recording what
 npx @spardutti/claude-skills --sync
 ```
 
-`--sync` refreshes every tracked item to the latest catalog and prunes stale ones in one shot — no menu. For a project that predates the manifest, the first normal run offers a one-time cleanup of `.claude/` content no longer in the catalog.
+`--sync` refreshes every tracked item, and any hooks the project already has, to the latest catalog and prunes stale ones in one shot — no menu. For a project that predates the manifest, the first normal run offers a one-time cleanup of `.claude/` content no longer in the catalog.
+
+`--sync-all[=dir]` does the same for every project under `dir` (default: your home folder) that has a manifest, fetching the catalog once:
+
+```bash
+npx @spardutti/claude-skills --sync-all
+```
 
 `--local[=path]` reads the catalog from a working copy instead of GitHub, so an unreleased change can be installed and tried without publishing it first:
 

package/bin/cli.mjs

@@ -4,12 +4,14 @@ import { confirm } from "@inquirer/prompts";
 import chalk from "chalk";
 import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
-import { dirname, join } from "node:path";
+import { dirname, join, resolve } from "node:path";
+import { homedir } from "node:os";
 import { fetchSkills, fetchCommands, fetchAgents } from "../lib/github.mjs";
 import { promptSkillSelection, promptCommandSelection, promptRemoval } from "../lib/prompt.mjs";
 import { installSkills, installCommands, installRequiredAgents } from "../lib/install.mjs";
 import { makeLocalSource } from "../lib/local.mjs";
 import { runPostInstall } from "../lib/post-install.mjs";
+import { runSync, runSyncAll } from "../lib/sync.mjs";
 import {
   readManifest, writeManifest, computeOrphans, computeRemovals, scanInstalled, removeArtifacts,
   MANIFEST_FILE,
@@ -19,37 +21,11 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
 const CWD = process.cwd();
 
-// `--sync`: re-install everything the manifest records (refreshed to the latest
-// catalog) and prune anything removed upstream — no interactive menu.
-async function runSync(manifest, catalog) {
-  if (!manifest) {
-    console.log(`  ${chalk.yellow("Nothing to sync")} — no manifest in this project. Run without --sync first.\n`);
-    return;
-  }
-  const orphans = computeOrphans(manifest, catalog);
-  const orphanCount = orphans.skills.length + orphans.commands.length + orphans.agents.length;
-  if (orphanCount > 0) {
-    await removeArtifacts(CWD, orphans);
-    console.log(`  ${chalk.green("✔")} Pruned ${orphanCount} item(s) removed from the catalog.`);
-  }
-
-  const skills = catalog.skills.filter((s) => manifest.skills.includes(s.dirName));
-  const commands = catalog.commands.filter((c) => manifest.commands.includes(c.fileName));
-  if (skills.length > 0) { console.log(); await installSkills(skills); }
-  if (commands.length > 0) { console.log(); await installCommands(commands); }
-  const { installed } = await installRequiredAgents(commands, catalog.agents, CWD);
-
-  await writeManifest(CWD, {
-    catalogVersion: pkg.version,
-    skills: skills.map((s) => s.dirName),
-    commands: commands.map((c) => c.fileName),
-    agents: installed.map((a) => a.fileName),
-  });
-  console.log(`\n  ${chalk.green("✔")} ${chalk.bold(`Synced to catalog v${pkg.version}.`)}\n`);
-}
-
 async function main() {
   const isSync = process.argv.includes("--sync");
+  // --sync-all[=dir] syncs every project under dir (default: home) from one catalog fetch.
+  const syncAllArg = process.argv.find((a) => a === "--sync-all" || a.startsWith("--sync-all="));
+  const syncAllRoot = syncAllArg ? resolve(syncAllArg.split("=")[1] || homedir()) : null;
 
   // --local[=path] reads the catalog from a working copy instead of GitHub, so an
   // unreleased change can be installed and tried without publishing it first.
@@ -69,10 +45,10 @@ async function main() {
     fetchers.fetchSkills(), fetchers.fetchCommands(), fetchers.fetchAgents(),
   ]);
   const catalog = { skills, commands, agents };
+  if (syncAllRoot) return runSyncAll(syncAllRoot, catalog, pkg.version);
+  if (isSync) return runSync(CWD, catalog, pkg.version);
   const manifest = await readManifest(CWD);
 
-  if (isSync) return runSync(manifest, catalog);
-
   // --- Prune items renamed or removed from the catalog upstream ---
   const orphans = computeOrphans(manifest, catalog);
   const orphanNames = [...orphans.skills, ...orphans.commands, ...orphans.agents];

package/lib/sync.mjs

@@ -0,0 +1,81 @@
+import chalk from "chalk";
+import { existsSync } from "node:fs";
+import { readdir } from "node:fs/promises";
+import { join, basename } from "node:path";
+import { installSkills, installCommands, installRequiredAgents } from "./install.mjs";
+import { setupHook } from "./setup-hook.mjs";
+import { readManifest, writeManifest, computeOrphans, removeArtifacts, MANIFEST_FILE } from "./manifest.mjs";
+
+const SEARCH_DEPTH = 5;
+
+// Re-install everything the manifest records (refreshed to the latest catalog),
+// refresh hooks the project already has, and prune anything removed upstream.
+export async function runSync(dir, catalog, version) {
+  const manifest = await readManifest(dir);
+  if (!manifest) {
+    console.log(`  ${chalk.yellow("Nothing to sync")} — no manifest in this project. Run without --sync first.\n`);
+    return false;
+  }
+  const orphans = computeOrphans(manifest, catalog);
+  const orphanCount = orphans.skills.length + orphans.commands.length + orphans.agents.length;
+  if (orphanCount > 0) {
+    await removeArtifacts(dir, orphans);
+    console.log(`  ${chalk.green("✔")} Pruned ${orphanCount} item(s) removed from the catalog.`);
+  }
+
+  const skills = catalog.skills.filter((s) => manifest.skills.includes(s.dirName));
+  const commands = catalog.commands.filter((c) => manifest.commands.includes(c.fileName));
+  if (skills.length > 0) { console.log(); await installSkills(skills, dir); }
+  if (commands.length > 0) { console.log(); await installCommands(commands, dir); }
+  const { installed } = await installRequiredAgents(commands, catalog.agents, dir);
+  if (existsSync(join(dir, ".claude", "hooks", "skill-gate.sh"))) { console.log(); await setupHook(dir); }
+
+  await writeManifest(dir, {
+    catalogVersion: version,
+    skills: skills.map((s) => s.dirName),
+    commands: commands.map((c) => c.fileName),
+    agents: installed.map((a) => a.fileName),
+  });
+  console.log(`\n  ${chalk.green("✔")} ${chalk.bold(`Synced to catalog v${version}.`)}\n`);
+  return true;
+}
+
+export async function findProjects(root, depth = SEARCH_DEPTH) {
+  if (existsSync(join(root, ".claude", MANIFEST_FILE))) return [root];
+  if (depth === 0) return [];
+  let entries;
+  try {
+    entries = await readdir(root, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+  const found = [];
+  for (const e of entries) {
+    if (!e.isDirectory() || e.name.startsWith(".") || e.name === "node_modules") continue;
+    found.push(...(await findProjects(join(root, e.name), depth - 1)));
+  }
+  return found;
+}
+
+export async function runSyncAll(root, catalog, version) {
+  const projects = await findProjects(root);
+  if (projects.length === 0) {
+    console.log(`  ${chalk.yellow("No projects found")} under ${root} with .claude/${MANIFEST_FILE}.\n`);
+    return;
+  }
+  const failed = [];
+  for (const dir of projects) {
+    console.log(chalk.bold.cyan(`── ${dir}`));
+    try {
+      await runSync(dir, catalog, version);
+    } catch (err) {
+      failed.push(basename(dir));
+      console.log(`  ${chalk.red("Error:")} ${err.message}\n`);
+    }
+  }
+  const ok = projects.length - failed.length;
+  console.log(`  ${chalk.green("✔")} ${chalk.bold(`${ok} of ${projects.length} project(s) synced to v${version}.`)}`);
+  if (failed.length > 0) console.log(`  ${chalk.red("✘")} Failed: ${failed.join(", ")}`);
+  console.log();
+  if (failed.length > 0) process.exitCode = 1;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spardutti/claude-skills",
-  "version": "2.33.7",
+  "version": "2.34.0",
   "description": "Guardrails for Claude Code — best-practice skills, planning commands, and delivery gates.",
   "type": "module",
   "repository": {