role-os 1.0.1 → 1.0.2

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 1.0.2
+
+### Fixed
+- Fix double-nested `.claude/.claude/` directory created by `roleos init` — `starter-pack/.claude/workflows/full-treatment.md` moved to `starter-pack/workflows/`
+- Read VERSION from `package.json` at runtime instead of hardcoded constant — prevents version drift between CLI and package metadata
+
+### Added
+- `roleos init --force` — update canonical scaffolded files while always protecting user-filled `context/` files
+- 4 regression tests: no double-nesting, correct workflow placement, version sync, --force context protection
+
 ## 1.0.0
 
 ### Added

package/bin/roleos.mjs

@@ -1,12 +1,16 @@
 #!/usr/bin/env node
 
+import { readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
 import { initCommand } from "../src/init.mjs";
 import { packetCommand } from "../src/packet.mjs";
 import { routeCommand } from "../src/route.mjs";
 import { reviewCommand } from "../src/review.mjs";
 import { statusCommand } from "../src/status.mjs";
 
-const VERSION = "1.0.0";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const VERSION = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8")).version;
 
 function printHelp() {
   console.log(`
@@ -14,6 +18,7 @@ roleos v${VERSION} — Role OS bootstrap CLI
 
 Usage:
   roleos init                        Scaffold Role OS into .claude/
+  roleos init --force                Update canonical files (protects context/)
   roleos packet new <type>           Create a new packet (feature|integration|identity)
   roleos route <packet-file>         Recommend the smallest valid chain
   roleos review <packet-file> <verdict>  Record a review verdict

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "role-os",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Role OS — a repo-native operating layer where specialized roles execute work through contracts, handoffs, review, and escalation",
   "type": "module",
   "bin": {

package/src/fs-utils.mjs

@@ -3,11 +3,14 @@ import { join, dirname, relative } from "node:path";
 
 /**
  * Recursively copy a directory, skipping files that already exist at the target.
- * Returns { created: string[], skipped: string[] } with relative paths.
+ * With force=true, overwrites existing files (except those matching protectedPaths).
+ * Returns { created: string[], skipped: string[], updated: string[] } with relative paths.
  */
-export function copyDirSafe(srcDir, destDir, baseDir = destDir) {
+export function copyDirSafe(srcDir, destDir, { baseDir, force = false, protectedPaths = [] } = {}) {
+  const root = baseDir || destDir;
   const created = [];
   const skipped = [];
+  const updated = [];
 
   if (!existsSync(srcDir)) {
     throw new Error(`Source directory does not exist: ${srcDir}`);
@@ -18,15 +21,23 @@ export function copyDirSafe(srcDir, destDir, baseDir = destDir) {
   for (const entry of entries) {
     const srcPath = join(srcDir, entry.name);
     const destPath = join(destDir, entry.name);
-    const relPath = relative(baseDir, destPath);
+    const relPath = relative(root, destPath);
 
     if (entry.isDirectory()) {
-      const sub = copyDirSafe(srcPath, destPath, baseDir);
+      const sub = copyDirSafe(srcPath, destPath, { baseDir: root, force, protectedPaths });
       created.push(...sub.created);
       skipped.push(...sub.skipped);
+      updated.push(...sub.updated);
     } else {
       if (existsSync(destPath)) {
-        skipped.push(relPath);
+        const normalizedRel = relPath.replace(/\\/g, "/");
+        if (force && !protectedPaths.some(p => normalizedRel.startsWith(p))) {
+          mkdirSync(dirname(destPath), { recursive: true });
+          copyFileSync(srcPath, destPath);
+          updated.push(relPath);
+        } else {
+          skipped.push(relPath);
+        }
       } else {
         mkdirSync(dirname(destPath), { recursive: true });
         copyFileSync(srcPath, destPath);
@@ -35,7 +46,7 @@ export function copyDirSafe(srcDir, destDir, baseDir = destDir) {
     }
   }
 
-  return { created, skipped };
+  return { created, skipped, updated };
 }
 
 /**

package/src/init.mjs

@@ -5,13 +5,23 @@ import { copyDirSafe } from "./fs-utils.mjs";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const STARTER_PACK_DIR = join(__dirname, "..", "starter-pack");
 
+// Paths that --force must never overwrite (user-filled content)
+const PROTECTED_PATHS = [
+  "context/",
+];
+
 export async function initCommand(args) {
-  const targetDir = args[0] || ".";
+  const force = args.includes("--force");
+  const positional = args.filter(a => !a.startsWith("--"));
+  const targetDir = positional[0] || ".";
   const claudeDir = join(targetDir, ".claude");
 
-  console.log("roleos init — scaffolding Role OS into .claude/\n");
+  console.log(`roleos init${force ? " --force" : ""} — scaffolding Role OS into .claude/\n`);
 
-  const { created, skipped } = copyDirSafe(STARTER_PACK_DIR, claudeDir);
+  const { created, skipped, updated } = copyDirSafe(STARTER_PACK_DIR, claudeDir, {
+    force,
+    protectedPaths: PROTECTED_PATHS,
+  });
 
   if (created.length > 0) {
     console.log(`Created (${created.length}):`);
@@ -20,6 +30,13 @@ export async function initCommand(args) {
     }
   }
 
+  if (updated.length > 0) {
+    console.log(`\nUpdated (${updated.length}):`);
+    for (const f of updated) {
+      console.log(`  ~ ${f}`);
+    }
+  }
+
   if (skipped.length > 0) {
     console.log(`\nSkipped (${skipped.length} — already exist):`);
     for (const f of skipped) {
@@ -27,8 +44,11 @@ export async function initCommand(args) {
     }
   }
 
-  if (created.length === 0 && skipped.length > 0) {
+  if (created.length === 0 && updated.length === 0 && skipped.length > 0) {
     console.log("\nRole OS is already scaffolded. No files were overwritten.");
+    if (!force) {
+      console.log("Use --force to update canonical files (context/ files are always protected).");
+    }
   } else {
     console.log(`\nDone. Fill the context/ files for your project, then run:`);
     console.log(`  roleos packet new feature`);