@noemuch/bridge-ds 2.1.0 → 2.2.0

package/lib/cli.js

@@ -1,5 +1,5 @@
 const path = require('path');
-const { scaffold } = require('./scaffold');
+const { scaffold, update } = require('./scaffold');
 const { checkMcp, setupMcp } = require('./mcp-setup');
 
 // ── Branding ──────────────────────────────────────────────
@@ -113,6 +113,35 @@ async function cmdInit() {
   print('');
 }
 
+async function cmdUpdate() {
+  banner();
+  header('Updating Bridge DS skill files');
+
+  const cwd = process.cwd();
+
+  step(1, 2, 'Updating skill files');
+  const spinner = new Spinner('Updating SKILL.md, actions, rules, schemas, templates...').start();
+  const result = update(cwd);
+
+  if (result.error) {
+    spinner.stop();
+    error(result.error);
+    process.exit(1);
+  }
+
+  spinner.stop(`${result.updated.length} files updated`);
+
+  for (const f of result.updated) {
+    muted(f);
+  }
+
+  step(2, 2, 'Done!');
+  print('');
+  success('Skill files updated. Your knowledge base (registries, guides) was preserved.');
+  info('No need to re-run /design-workflow setup.');
+  print('');
+}
+
 function cmdHelp() {
   banner();
   print(`${C.bold}  Commands:${C.reset}`);
@@ -120,13 +149,17 @@ function cmdHelp() {
   print(`    ${C.orange}init${C.reset}       Initialize Bridge DS in current project`);
   print(`               Scaffolds skills, commands, and specs directories`);
   print('');
+  print(`    ${C.orange}update${C.reset}     Update skill files to latest version`);
+  print(`               Preserves your knowledge base (registries, guides)`);
+  print('');
   print(`    ${C.orange}help${C.reset}       Show this help message`);
   print(`    ${C.orange}version${C.reset}    Show version`);
   print('');
   print(`${C.bold}  Usage:${C.reset}`);
   print('');
-  print(`    ${C.dim}npx bridge-ds init${C.reset}     # Initialize in current project`);
-  print(`    ${C.dim}bridge-ds help${C.reset}          # Show help`);
+  print(`    ${C.dim}npx @noemuch/bridge-ds init${C.reset}     # Initialize in current project`);
+  print(`    ${C.dim}npx @noemuch/bridge-ds update${C.reset}   # Update skill files only`);
+  print(`    ${C.dim}bridge-ds help${C.reset}                  # Show help`);
   print('');
   print(`${C.bold}  After init:${C.reset}`);
   print('');
@@ -152,6 +185,9 @@ async function run(args) {
     case 'init':
       await cmdInit();
       break;
+    case 'update':
+      await cmdUpdate();
+      break;
     case 'help':
     case '--help':
     case '-h':

package/lib/scaffold.js

@@ -3,8 +3,9 @@ const path = require('path');
 
 /**
  * Recursively copy a directory, preserving structure.
+ * @param {string[]} skipDirs - directory names to skip (e.g., ['registries', 'guides', 'ui-references'])
  */
-function copyDir(src, dest) {
+function copyDir(src, dest, skipDirs = []) {
   const created = [];
   if (!fs.existsSync(dest)) {
     fs.mkdirSync(dest, { recursive: true });
@@ -13,7 +14,8 @@ function copyDir(src, dest) {
     const srcPath = path.join(src, entry.name);
     const destPath = path.join(dest, entry.name);
     if (entry.isDirectory()) {
-      created.push(...copyDir(srcPath, destPath));
+      if (skipDirs.includes(entry.name)) continue;
+      created.push(...copyDir(srcPath, destPath, skipDirs));
     } else {
       fs.copyFileSync(srcPath, destPath);
       created.push(destPath);
@@ -117,4 +119,37 @@ function scaffold(projectDir) {
   return { created };
 }
 
-module.exports = { scaffold };
+/**
+ * Update only the skill files (SKILL.md, actions, rules, schemas, templates).
+ * Preserves all user-generated data (registries, guides, ui-references, specs).
+ * Returns { updated: string[] } with relative paths of updated files.
+ */
+function update(projectDir) {
+  const updated = [];
+  const pkgRoot = path.resolve(__dirname, '..');
+
+  const skillsSrc = path.join(pkgRoot, 'skills', 'design-workflow');
+  const skillsDest = path.join(projectDir, '.claude', 'skills', 'design-workflow');
+
+  if (!fs.existsSync(skillsDest)) {
+    return { updated: [], error: 'Bridge DS not initialized. Run: npx @noemuch/bridge-ds init' };
+  }
+
+  // Copy skill files, skipping user-generated KB data
+  const userDataDirs = ['registries', 'guides', 'ui-references'];
+  const files = copyDir(skillsSrc, skillsDest, userDataDirs);
+  updated.push(...files.map(f => path.relative(projectDir, f)));
+
+  // Update command file
+  const cmdSrc = path.join(pkgRoot, 'commands', 'design-workflow.md');
+  const cmdDest = path.join(projectDir, '.claude', 'commands', 'design-workflow.md');
+  if (fs.existsSync(cmdSrc)) {
+    fs.mkdirSync(path.dirname(cmdDest), { recursive: true });
+    fs.copyFileSync(cmdSrc, cmdDest);
+    updated.push(path.relative(projectDir, cmdDest));
+  }
+
+  return { updated };
+}
+
+module.exports = { scaffold, update };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noemuch/bridge-ds",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "AI-powered design generation in Figma — 100% design system compliant. Connects Claude Code to Figma via MCP for spec-first, token-bound, component-native design.",
   "main": "lib/cli.js",
   "bin": {