@axiomatic-labs/claudeflow 2.12.84 → 2.12.85

package/lib/install.js

@@ -13,6 +13,8 @@ const TEMPLATE_AGENTS = new Set(['claudeflow-explorer', 'claudeflow-planner', 'e
 const TEMPLATE_MANAGED_MANIFEST = path.join('.claudeflow', 'config', 'template-managed-manifest.json');
 const CLAUDE_BACKUP_ROOT = '.claudeflow-backups';
 const REQUIRED_TEMPLATE_RULES = ['claudeflow-implementation.md'];
+const TEMPLATE_MANAGED_SETTINGS_KEYS = ['$schema', 'enabledMcpjsonServers', 'env', 'permissions', 'hooks'];
+const TEMPLATE_SEEDED_SETTINGS_KEYS = new Set(['statusLine']);
 
 async function run() {
   const current = readLocalVersion();
@@ -71,12 +73,13 @@ async function run() {
     const staleManagedPaths = [...previousManagedPaths].filter((relPath) => !nextManagedPaths.has(relPath));
     staleRemovedCount = pruneStaleManagedPaths(cwd, staleManagedPaths);
 
-    // Copy settings.json
+    // Merge settings.json so template-managed keys refresh on update while
+    // preserving user customizations like custom statusLine commands.
     const srcSettings = path.join(srcClaude, 'settings.json');
     const dstSettings = path.join(cwd, '.claude', 'settings.json');
     fs.mkdirSync(path.join(cwd, '.claude'), { recursive: true });
     if (fs.existsSync(srcSettings)) {
-      fs.copyFileSync(srcSettings, dstSettings);
+      syncClaudeSettings(srcSettings, dstSettings);
     }
 
     // Upsert playwright entry in .mcp.json with project-specific CDP port.
@@ -247,6 +250,7 @@ async function run() {
     ui.success(`${docCount} docs updated`);
     ui.success(`${staleRemovedCount} stale template-managed files removed`);
     ui.success(`Template-managed manifest updated (${managedPathCount} paths)`);
+    ui.info('Default Claude Code status line is seeded when missing. Existing custom statusLine settings are preserved on update and can be overridden in .claude/settings.local.json.');
     if (backupPath) {
       ui.success(`Backup created: ${path.relative(cwd, backupPath)}`);
     }
@@ -261,6 +265,7 @@ async function run() {
     ui.success(`${hookCount} hooks installed`);
     ui.success(`${docCount} docs installed`);
     ui.success(`Template-managed manifest written (${managedPathCount} paths)`);
+    ui.info('Default Claude Code status line installed. Override it in .claude/settings.json or .claude/settings.local.json.');
     if (backupPath) {
       ui.success(`Backup created: ${path.relative(cwd, backupPath)}`);
     }
@@ -333,6 +338,73 @@ function showGettingStarted(cwd) {
   console.log('');
 }
 
+function syncClaudeSettings(srcSettingsPath, dstSettingsPath) {
+  const templateSettings = readJsonObject(srcSettingsPath, {
+    label: 'template .claude/settings.json',
+    throwOnInvalid: true,
+  });
+  const existingSettings = readJsonObject(dstSettingsPath, {
+    label: 'existing .claude/settings.json',
+    warnOnInvalid: true,
+  }) || {};
+  const mergedSettings = mergeClaudeSettings(templateSettings, existingSettings);
+  fs.writeFileSync(dstSettingsPath, `${JSON.stringify(mergedSettings, null, 2)}\n`);
+}
+
+function mergeClaudeSettings(templateSettings, existingSettings = {}) {
+  const template = isPlainObject(templateSettings) ? templateSettings : {};
+  const existing = isPlainObject(existingSettings) ? existingSettings : {};
+  const merged = {};
+
+  for (const [key, value] of Object.entries(template)) {
+    if (TEMPLATE_MANAGED_SETTINGS_KEYS.includes(key)) {
+      merged[key] = cloneJson(value);
+      continue;
+    }
+    if (TEMPLATE_SEEDED_SETTINGS_KEYS.has(key)) {
+      merged[key] = Object.prototype.hasOwnProperty.call(existing, key)
+        ? cloneJson(existing[key])
+        : cloneJson(value);
+    }
+  }
+
+  for (const [key, value] of Object.entries(existing)) {
+    if (Object.prototype.hasOwnProperty.call(merged, key)) continue;
+    if (TEMPLATE_MANAGED_SETTINGS_KEYS.includes(key)) continue;
+    merged[key] = cloneJson(value);
+  }
+
+  return merged;
+}
+
+function readJsonObject(filePath, options = {}) {
+  if (!fs.existsSync(filePath)) return null;
+  const { label = filePath, throwOnInvalid = false, warnOnInvalid = false } = options;
+
+  try {
+    const parsed = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    if (isPlainObject(parsed)) return parsed;
+
+    const message = `${label} must contain a top-level JSON object`;
+    if (throwOnInvalid) throw new Error(message);
+    if (warnOnInvalid) ui.warn(`${message}. Replacing it with template-managed defaults.`);
+    return null;
+  } catch (error) {
+    if (throwOnInvalid) throw error;
+    if (warnOnInvalid) ui.warn(`${label} is invalid JSON. Replacing it with template-managed defaults.`);
+    return null;
+  }
+}
+
+function isPlainObject(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+
+function cloneJson(value) {
+  if (value === undefined) return undefined;
+  return JSON.parse(JSON.stringify(value));
+}
+
 // Install ast-grep CLI, uv, and Serena MCP for runtime and analysis.
 // All steps are best-effort — failures warn but never block the install.
 function installAnalysisTools() {
@@ -756,4 +828,5 @@ function copyDirSync(src, dst, skipNames) {
 
 module.exports = Object.assign(run, {
   assertRequiredTemplateRules,
+  mergeClaudeSettings,
 });

package/package.json

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