buildwright 0.0.3 → 0.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "buildwright",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "Agent-first autonomous development workflow. Ship code you don't read.",
   "license": "MIT",
   "engines": {

package/src/commands/init.js

@@ -46,11 +46,15 @@ function init() {
     const stat = fs.statSync(fs.realpathSync(src));
 
     if (stat.isDirectory()) {
-      console.log(`  Copying ${entry}/`);
-      copyDir(src, dest);
+      console.log(`  Copying ${entry}/ (adding new files only)`);
+      copyDir(src, dest, { skipExisting: true });
     } else {
-      console.log(`  Copying ${entry}`);
-      fs.copyFileSync(fs.realpathSync(src), dest);
+      if (fs.existsSync(dest)) {
+        console.log(`  Skipping ${entry} (already exists)`);
+      } else {
+        console.log(`  Copying ${entry}`);
+        fs.copyFileSync(fs.realpathSync(src), dest);
+      }
     }
   }
 

package/src/commands/update.js

@@ -62,6 +62,26 @@ async function downloadAndExtract() {
   return { tmpDir, extractedRoot };
 }
 
+/**
+ * Copy files from src to dest, but only files that exist in src.
+ * Files in dest that have no counterpart in src are left untouched.
+ */
+function copyUpstreamOnly(src, dest) {
+  for (const entry of fs.readdirSync(src)) {
+    const srcEntry = path.join(src, entry);
+    const destEntry = path.join(dest, entry);
+    const stat = fs.statSync(srcEntry);
+    if (stat.isDirectory()) {
+      fs.mkdirSync(destEntry, { recursive: true });
+      copyUpstreamOnly(srcEntry, destEntry);
+    } else {
+      if (!fs.existsSync(destEntry)) {
+        fs.copyFileSync(srcEntry, destEntry);  // only new files
+      }
+    }
+  }
+}
+
 async function update() {
   const cwd = process.cwd();
 
@@ -86,7 +106,8 @@ async function update() {
       throw new Error('Downloaded archive is missing .buildwright/ directory');
     }
 
-    // Update only the specified directories
+    // Update only the specified directories — overwrite upstream files only,
+    // never delete files the user added that don't exist in the upstream source.
     for (const dir of UPDATE_DIRS) {
       const src = path.join(srcBuildwright, dir);
       const dest = path.join(cwd, '.buildwright', dir);
@@ -94,17 +115,18 @@ async function update() {
         console.log(`  ${YELLOW}Skipping ${dir}/ (not found in latest release)${RESET}`);
         continue;
       }
-      console.log(`  Updating .buildwright/${dir}/`);
-      // Remove old and replace
-      fs.rmSync(dest, { recursive: true, force: true });
-      copyDir(src, dest);
+      console.log(`  Updating .buildwright/${dir}/ (adding new files only)`);
+      fs.mkdirSync(dest, { recursive: true });
+      // Copy only files that exist in upstream — preserves user-added files
+      copyUpstreamOnly(src, dest);
     }
 
-    // Also update CLAUDE.md if it exists in the download
+    // Also add CLAUDE.md if it doesn't already exist locally
     const srcClaude = path.join(extractedRoot, 'CLAUDE.md');
-    if (fs.existsSync(srcClaude)) {
-      console.log(`  Updating CLAUDE.md`);
-      fs.copyFileSync(srcClaude, path.join(cwd, 'CLAUDE.md'));
+    const destClaude = path.join(cwd, 'CLAUDE.md');
+    if (fs.existsSync(srcClaude) && !fs.existsSync(destClaude)) {
+      console.log(`  Adding CLAUDE.md`);
+      fs.copyFileSync(srcClaude, destClaude);
     }
 
     console.log('');
@@ -118,8 +140,8 @@ async function update() {
 
     console.log('');
     console.log(`${GREEN}${BOLD}Update complete!${RESET}`);
-    console.log('commands, agents, and claws are now up to date.');
-    console.log('Your steering docs (.buildwright/steering/) are unchanged.\n');
+    console.log('commands, agents, and claws: new files added. Existing files unchanged.');
+    console.log('Your custom files and steering docs are unchanged.\n');
 
   } catch (err) {
     console.error(`\nUpdate failed: ${err.message}`);

package/src/utils/copy-files.js

@@ -10,9 +10,11 @@ const path = require('path');
  * @param {string} dest - Destination directory path
  * @param {object} [opts]
  * @param {string[]} [opts.skip] - Relative paths (from src) to skip
+ * @param {boolean} [opts.skipExisting] - Skip files that already exist at dest
  */
 function copyDir(src, dest, opts = {}) {
   const skip = opts.skip || [];
+  const skipExisting = opts.skipExisting || false;
   const entries = fs.readdirSync(src, { withFileTypes: true });
   fs.mkdirSync(dest, { recursive: true });
 
@@ -32,7 +34,11 @@ function copyDir(src, dest, opts = {}) {
     if (stat.isDirectory()) {
       copyDir(realSrcPath, destPath, opts);
     } else {
-      fs.copyFileSync(realSrcPath, destPath);
+      if (skipExisting && fs.existsSync(destPath)) {
+        // leave existing file untouched
+      } else {
+        fs.copyFileSync(realSrcPath, destPath);
+      }
     }
   }
 }