@axiomatic-labs/claudeflow 2.35.14 → 2.35.16

package/lib/install.js

@@ -10,10 +10,12 @@ const ui = require('./ui.js');
 // claudeflow installs a small, namespaced footprint. Most of it is self-contained files that are simply
 // PLACED (playbooks, scripts, skills) — those can't conflict with the user's project. The only things
 // that need a MERGE (never a clobber) are .claude/settings.json (register our hooks alongside theirs)
-// and CLAUDE.md (append our guidance block). That merge lives here, in Node, so install works on every
+// and CLAUDE.md (upsert our guidance block between markers — user content outside stays untouched). That
+// merge lives here, in Node, so install works on every
 // platform with no shell dependency. The GitHub auth gate (auth.js/download.js) is untouched.
 
 const CLAUDE_MARK = '<!-- claudeflow:begin -->';
+const CLAUDE_END = '<!-- claudeflow:end -->';
 const HOOK_TAG = 'scripts/claudeflow/hook_';            // identifies OUR hook entries in settings.json
 const PER_PROJECT_CONFIGS = ['brand.json', 'risk-signals.json'];  // create-if-absent, never clobber
 const SHARED_CONFIGS = ['playbook-map.json', 'agent-map.json'];   // always refreshed (shared system)
@@ -60,13 +62,32 @@ function mergeSettings(cwd, payloadSettings) {
   fs.writeFileSync(sp, JSON.stringify(data, null, 2) + '\n');
 }
 
-function appendClaudeMd(cwd, snippetPath) {
+// UPSERT the claudeflow guidance block. The snippet is a self-contained `<!-- claudeflow:begin -->…<!-- end -->`
+// region; everything OUTSIDE the markers is the user's own CLAUDE.md and is never touched. Behavior:
+//   • no CLAUDE.md            → create it with the block
+//   • CLAUDE.md, no block yet → append the block (preserve the user's content)
+//   • CLAUDE.md WITH the block → REPLACE the marked region in place, so guidance updates PROPAGATE on `update`
+//     (the old code appended-once and never refreshed → a stale project never got new disciplines).
+//   • begin marker but no end (corrupted) → leave it untouched (don't risk eating user content)
+function syncClaudeMd(cwd, snippetPath) {
   if (!fs.existsSync(snippetPath)) return false;
   const target = path.join(cwd, 'CLAUDE.md');
-  if (fs.existsSync(target) && fs.readFileSync(target, 'utf8').includes(CLAUDE_MARK)) return false;
-  const snippet = fs.readFileSync(snippetPath, 'utf8');
-  const prefix = fs.existsSync(target) ? '\n' : '';
-  fs.appendFileSync(target, prefix + snippet);
+  const block = fs.readFileSync(snippetPath, 'utf8').trim();
+  if (!fs.existsSync(target)) {
+    fs.writeFileSync(target, block + '\n');
+    return true;
+  }
+  const cur = fs.readFileSync(target, 'utf8');
+  const b = cur.indexOf(CLAUDE_MARK);
+  if (b === -1) {
+    fs.writeFileSync(target, cur.replace(/\s*$/, '') + '\n\n' + block + '\n');
+    return true;
+  }
+  const e = cur.indexOf(CLAUDE_END, b);
+  if (e === -1) return false;  // begin without end → corrupt region; don't clobber
+  const updated = cur.slice(0, b) + block + cur.slice(e + CLAUDE_END.length);
+  if (updated === cur) return false;  // already current
+  fs.writeFileSync(target, updated);
   return true;
 }
 
@@ -131,8 +152,8 @@ function installFromPayload(src, cwd) {
     try { mergeSettings(cwd, JSON.parse(fs.readFileSync(srcSettings, 'utf8'))); } catch {}
   }
 
-  // 6) CLAUDE.md — append the guidance block (idempotent).
-  out.claudeMd = appendClaudeMd(cwd, path.join(src, 'assets', 'CLAUDE.snippet.md'));
+  // 6) CLAUDE.md — upsert the managed guidance block between markers (idempotent; updates propagate on re-install).
+  out.claudeMd = syncClaudeMd(cwd, path.join(src, 'assets', 'CLAUDE.snippet.md'));
 
   return out;
 }
@@ -170,10 +191,11 @@ async function run() {
 
   ui.success(`claudeflow v${version} installed`);
   ui.info(`  ${summary.playbooks} playbooks · ${summary.scripts} scripts · ${summary.skills} skills`
-    + (summary.claudeMd ? ' · CLAUDE.md guidance added' : ''));
+    + (summary.claudeMd ? ' · CLAUDE.md guidance synced' : ''));
   ui.done(`Describe a change and the ${ui.BOLD}claudeflow-implement${ui.RESET} skill will drive it.`);
 }
 
 module.exports = run;
 module.exports.installFromPayload = installFromPayload;
 module.exports.mergeSettings = mergeSettings;
+module.exports.syncClaudeMd = syncClaudeMd;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiomatic-labs/claudeflow",
-  "version": "2.35.14",
+  "version": "2.35.16",
   "description": "Claudeflow — AI-powered development toolkit for Claude Code. Skills, agents, hooks, and quality gates that ship production apps.",
   "bin": {
     "claudeflow": "./bin/cli.js"