spec-first-claude 0.5.0-beta.6 → 0.5.0-beta.7

package/bin/cli.js

@@ -2,26 +2,35 @@
 
 const path = require('path');
 const { init } = require('../lib/init');
+const { update } = require('../lib/update');
 
 const args = process.argv.slice(2);
 const command = args[0];
 
 function printUsage() {
-  console.log('Usage: spec-first-claude init --name=<project-name> [--target=<path>]');
+  console.log('Usage:');
+  console.log('  spec-first-claude init --name=<project-name> [--target=<path>]');
+  console.log('  spec-first-claude update [--target=<path>] [--force]');
   console.log('');
-  console.log('Creates a new spec-first project configured for Claude Code.');
+  console.log('Commands:');
+  console.log('  init     Create a new spec-first project');
+  console.log('  update   Update an existing project with new framework files');
+  console.log('           (adds missing files, updates framework files like commands/adapters/agents)');
   console.log('');
   console.log('Options:');
-  console.log('  --name=<name>    Project name (required)');
-  console.log('  --target=<path>  Target directory (defaults to ./<name>)');
+  console.log('  --name=<name>    Project name (required for init)');
+  console.log('  --target=<path>  Target directory (defaults to ./<name> for init, cwd for update)');
+  console.log('  --force          Force update all files, not just framework files (use with caution)');
 }
 
 function parseArgs(args) {
-  const parsed = {};
+  const parsed = { flags: [] };
   for (const arg of args) {
     const match = arg.match(/^--(\w+)=(.+)$/);
     if (match) {
       parsed[match[1]] = match[2];
+    } else if (arg.startsWith('--')) {
+      parsed.flags.push(arg.slice(2));
     }
   }
   return parsed;
@@ -43,6 +52,15 @@ if (command === 'init') {
     templatesDir,
     targetDir: opts.target || undefined,
   });
+} else if (command === 'update') {
+  const opts = parseArgs(args.slice(1));
+  const templatesDir = path.join(__dirname, '..', 'templates');
+
+  update({
+    templatesDir,
+    targetDir: opts.target || undefined,
+    force: opts.flags.includes('force'),
+  });
 } else {
   printUsage();
   if (command) {

package/lib/update.js

@@ -0,0 +1,131 @@
+const fs = require('fs');
+const path = require('path');
+
+const FRAMEWORK_DIRS = [
+  path.join('.claude', 'adapters'),
+  path.join('.claude', 'commands'),
+  path.join('.claude', 'agents'),
+  path.join('.claude', 'templates'),
+];
+
+const FRAMEWORK_FILES = [
+  path.join('.claude', 'rules.md'),
+  'sfw.config.yml.example',
+];
+
+function update({ templatesDir, targetDir, force }) {
+  const dest = targetDir || process.cwd();
+
+  if (!fs.existsSync(dest)) {
+    console.error(`Error: directory "${dest}" does not exist.`);
+    console.error('Run "spec-first-claude init --name=<name>" first to create a project.');
+    process.exit(1);
+  }
+
+  const claudeDir = path.join(dest, '.claude');
+  if (!fs.existsSync(claudeDir)) {
+    console.error('Error: not a spec-first project (missing .claude/ directory).');
+    console.error('Run "spec-first-claude init --name=<name>" first.');
+    process.exit(1);
+  }
+
+  console.log(`\nUpdating project in ${dest}\n`);
+
+  const stats = { added: [], updated: [], skipped: 0 };
+  syncDir(templatesDir, dest, force, stats, dest);
+
+  console.log('');
+  if (stats.added.length > 0) {
+    console.log(`Added (${stats.added.length}):`);
+    for (const f of stats.added) console.log(`  + ${f}`);
+  }
+  if (stats.updated.length > 0) {
+    console.log(`Updated (${stats.updated.length}):`);
+    for (const f of stats.updated) console.log(`  ~ ${f}`);
+  }
+  if (stats.added.length === 0 && stats.updated.length === 0) {
+    console.log('Already up to date — no new files to add.');
+  } else {
+    console.log(`\n${stats.added.length} added, ${stats.updated.length} updated, ${stats.skipped} unchanged`);
+  }
+  console.log('');
+}
+
+function syncDir(src, dest, force, stats, root) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      syncDir(srcPath, destPath, force, stats, root);
+    } else {
+      syncFile(srcPath, destPath, force, stats, root);
+    }
+  }
+}
+
+function syncFile(src, dest, force, stats, root) {
+  const rel = path.relative(root, dest);
+  const exists = fs.existsSync(dest);
+
+  if (exists && !force) {
+    // File exists and not forcing — check if it's a framework file we should update
+    const isFramework = isFrameworkPath(rel);
+    if (!isFramework) {
+      stats.skipped++;
+      return;
+    }
+    // Framework file — check if content differs
+    const srcContent = fs.readFileSync(src, 'utf-8');
+    const destContent = fs.readFileSync(dest, 'utf-8');
+    if (srcContent === destContent) {
+      stats.skipped++;
+      return;
+    }
+    // Framework file with different content — update it
+    fs.writeFileSync(dest, srcContent, 'utf-8');
+    stats.updated.push(rel);
+    return;
+  }
+
+  if (exists && force) {
+    const srcContent = fs.readFileSync(src, 'utf-8');
+    const destContent = fs.readFileSync(dest, 'utf-8');
+    if (srcContent === destContent) {
+      stats.skipped++;
+      return;
+    }
+    fs.writeFileSync(dest, srcContent, 'utf-8');
+    stats.updated.push(rel);
+    return;
+  }
+
+  // File doesn't exist — add it
+  const textExtensions = ['.md', '.yaml', '.yml', '.json', '.js', '.ts', '.gitignore', '.gitkeep', ''];
+  const ext = path.extname(src).toLowerCase();
+  const basename = path.basename(src);
+  const isText = textExtensions.includes(ext) || basename.startsWith('.');
+
+  if (isText) {
+    const content = fs.readFileSync(src, 'utf-8');
+    fs.writeFileSync(dest, content, 'utf-8');
+  } else {
+    fs.copyFileSync(src, dest);
+  }
+  stats.added.push(rel);
+}
+
+function isFrameworkPath(rel) {
+  const normalized = rel.split(path.sep).join('/');
+  for (const dir of FRAMEWORK_DIRS) {
+    const normalizedDir = dir.split(path.sep).join('/');
+    if (normalized.startsWith(normalizedDir + '/')) return true;
+  }
+  for (const file of FRAMEWORK_FILES) {
+    const normalizedFile = file.split(path.sep).join('/');
+    if (normalized === normalizedFile) return true;
+  }
+  return false;
+}
+
+module.exports = { update };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-first-claude",
-  "version": "0.5.0-beta.6",
+  "version": "0.5.0-beta.7",
   "description": "Spec-first workflow kit for Claude Code — AI-driven development with specs, not guesswork",
   "bin": {
     "spec-first-claude": "bin/cli.js"