@codebehind/agent-workflow 1.0.0 → 1.1.0

package/bin/agent-workflow.mjs

@@ -1,11 +1,16 @@
 #!/usr/bin/env node
-import { existsSync, mkdirSync, copyFileSync, readdirSync, statSync } from 'fs';
+import {
+  existsSync, mkdirSync, copyFileSync, readdirSync, statSync,
+  readFileSync,
+} from 'fs';
 import { join, dirname, relative } from 'path';
 import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+import readline from 'readline';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const TEMPLATES_DIR = join(__dirname, '..', 'templates');
-const VERSION = '1.0.0';
+const VERSION = '1.1.0';
 
 const args = process.argv.slice(2);
 const command = args[0];
@@ -16,44 +21,59 @@ function printUsage() {
 @codebehind/agent-workflow v${VERSION}
 
 Usage:
-  npx @codebehind/agent-workflow init [--force]
+  npx @codebehind/agent-workflow <command> [options]
 
 Commands:
   init      Copy the agent-workflow framework files into the current directory.
-            Skips files that already exist (use --force to overwrite).
+            Skips files that already exist (use --force to overwrite all).
+  upgrade   Update all framework files to the latest version.
+            Prompts before overwriting any file that differs locally.
 
 Options:
-  --force   Overwrite existing files.
+  --force   (init only) Overwrite existing files without prompting.
   --version Print version and exit.
 `);
 }
 
-function walkDir(dir, baseDir, callback) {
+const SKIP_FILES = new Set(['.DS_Store']);
+
+// Async walk — processes files sequentially so prompts work correctly
+async function walkDir(dir, baseDir, callback) {
   for (const entry of readdirSync(dir)) {
+    if (SKIP_FILES.has(entry)) continue;
     const fullPath = join(dir, entry);
     const relPath = relative(baseDir, fullPath);
     if (statSync(fullPath).isDirectory()) {
-      walkDir(fullPath, baseDir, callback);
+      await walkDir(fullPath, baseDir, callback);
     } else {
-      callback(fullPath, relPath);
+      await callback(fullPath, relPath);
     }
   }
 }
 
-function init(targetDir) {
+function getDiff(localPath, templatePath) {
+  try {
+    // diff exits with code 1 when files differ — that's expected, not an error
+    return execSync(`diff -u "${localPath}" "${templatePath}"`, { stdio: ['pipe', 'pipe', 'pipe'] }).toString();
+  } catch (e) {
+    return e.stdout ? e.stdout.toString() : '';
+  }
+}
+
+async function init(targetDir) {
   const copied = [];
   const skipped = [];
 
-  walkDir(TEMPLATES_DIR, TEMPLATES_DIR, (srcPath, relPath) => {
+  await walkDir(TEMPLATES_DIR, TEMPLATES_DIR, async (srcPath, relPath) => {
     const destPath = join(targetDir, relPath);
-    const destDir = dirname(destPath);
+    const destDirPath = dirname(destPath);
 
     if (!force && existsSync(destPath)) {
       skipped.push(relPath);
       return;
     }
 
-    mkdirSync(destDir, { recursive: true });
+    mkdirSync(destDirPath, { recursive: true });
     copyFileSync(srcPath, destPath);
     copied.push(relPath);
   });
@@ -83,12 +103,66 @@ Next steps:
 `);
 }
 
+async function upgrade(targetDir) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const ask = (q) => new Promise(resolve => rl.question(q, resolve));
+
+  let overridden = 0;
+  let skipped = 0;
+  let added = 0;
+
+  console.log(`\nUpgrading to @codebehind/agent-workflow v${VERSION}...\n`);
+
+  await walkDir(TEMPLATES_DIR, TEMPLATES_DIR, async (srcPath, relPath) => {
+    const destPath = join(targetDir, relPath);
+
+    if (!existsSync(destPath)) {
+      mkdirSync(dirname(destPath), { recursive: true });
+      copyFileSync(srcPath, destPath);
+      console.log(`  + ${relPath} (new)`);
+      added++;
+      return;
+    }
+
+    const localContent = readFileSync(destPath);
+    const templateContent = readFileSync(srcPath);
+
+    if (localContent.equals(templateContent)) {
+      console.log(`  ~ ${relPath} (up to date)`);
+      return;
+    }
+
+    // Files differ — show diff and prompt
+    const diff = getDiff(destPath, srcPath);
+    console.log(`\n--- Conflict: ${relPath} ---`);
+    console.log(diff);
+
+    const answer = await ask(`Override local file? [o=override, s=skip] (default: s): `);
+
+    if (answer.trim().toLowerCase() === 'o') {
+      copyFileSync(srcPath, destPath);
+      console.log(`  ✓ ${relPath} (overridden)\n`);
+      overridden++;
+    } else {
+      console.log(`  - ${relPath} (skipped)\n`);
+      skipped++;
+    }
+  });
+
+  rl.close();
+  console.log(`Done. ${added} new, ${overridden} overridden, ${skipped} skipped.`);
+}
+
 // Entry point
 if (command === '--version' || command === '-v') {
   console.log(VERSION);
   process.exit(0);
-} else if (!command || command === 'init') {
-  init(process.cwd());
+} else if (command === 'init') {
+  await init(process.cwd());
+} else if (command === 'upgrade') {
+  await upgrade(process.cwd());
+} else if (!command) {
+  printUsage();
 } else {
   console.error(`Unknown command: ${command}`);
   printUsage();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codebehind/agent-workflow",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Scaffold the agent-workflow spec-driven delivery framework into any repo",
   "type": "module",
   "bin": {