@agentic15.com/agentic15-claude-zen 5.0.5 → 5.0.7

package/README.md

@@ -220,6 +220,7 @@ Starts next task
 | `npx agentic15 task status` | View current progress |
 | `npx agentic15 commit` | Commit, push, and create PR |
 | `npx agentic15 sync` | Sync with main branch after PR merge |
+| `npx agentic15 update-settings` | Update `.claude/settings.json` from latest framework |
 | `npx agentic15 visual-test <url>` | Capture UI screenshots and console errors |
 | `npx agentic15 auth` | Configure GitHub authentication |
 
@@ -291,8 +292,12 @@ Framework files live in `node_modules` and are automatically updated:
 # Upgrade to latest version
 npm install @agentic15.com/agentic15-claude-zen@latest
 
+# Update settings.json to latest framework version
+npx agentic15 update-settings
+
 # Or to a specific version
 npm install @agentic15.com/agentic15-claude-zen@5.0.0
+npx agentic15 update-settings
 ```
 
 **What gets updated:**
@@ -305,6 +310,8 @@ npm install @agentic15.com/agentic15-claude-zen@5.0.0
 - ✅ Your plans and tasks in `.claude/plans/`
 - ✅ Your local settings in `.claude/settings.local.json`
 
+**Note:** After upgrading, run `npx agentic15 update-settings` to update your `.claude/settings.json` with the latest framework configuration. Your existing settings will be backed up to `.claude/settings.json.backup`.
+
 </td>
 </tr>
 </table>

package/bin/agentic15.js

@@ -8,6 +8,7 @@ import { StatusCommand } from '../src/cli/StatusCommand.js';
 import { PlanCommand } from '../src/cli/PlanCommand.js';
 import { VisualTestCommand } from '../src/cli/VisualTestCommand.js';
 import { SyncCommand } from '../src/cli/SyncCommand.js';
+import { UpdateSettingsCommand } from '../src/cli/UpdateSettingsCommand.js';
 
 const program = new Command();
 
@@ -62,4 +63,10 @@ program
   .description('Switch to main branch, pull latest changes, and cleanup feature branch')
   .action(() => SyncCommand.execute());
 
+// Update settings.json from framework
+program
+  .command('update-settings')
+  .description('Update .claude/settings.json from latest framework version')
+  .action(() => UpdateSettingsCommand.execute());
+
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentic15.com/agentic15-claude-zen",
-  "version": "5.0.5",
+  "version": "5.0.7",
   "description": "Structured AI-assisted development framework for Claude Code with enforced quality standards",
   "main": "src/index.js",
   "bin": {
@@ -55,6 +55,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
+    "@octokit/rest": "^21.0.2",
     "commander": "^12.1.0"
   },
   "devDependencies": {

package/src/cli/UpdateSettingsCommand.js

@@ -0,0 +1,50 @@
+import { cpSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+/**
+ * UpdateSettingsCommand - Update .claude/settings.json from framework
+ *
+ * Copies the latest framework settings.json to user's .claude directory
+ */
+export class UpdateSettingsCommand {
+  static async execute() {
+    console.log('\n🔄 Updating .claude/settings.json from framework\n');
+
+    const targetPath = join(process.cwd(), '.claude', 'settings.json');
+    const frameworkPath = join(__dirname, '..', '..', 'framework', 'settings.json');
+
+    // Check if framework settings exists
+    if (!existsSync(frameworkPath)) {
+      console.log('❌ Framework settings.json not found');
+      console.log('   Expected: node_modules/@agentic15.com/agentic15-claude-zen/framework/settings.json\n');
+      process.exit(1);
+    }
+
+    // Check if target directory exists
+    if (!existsSync(join(process.cwd(), '.claude'))) {
+      console.log('❌ .claude directory not found');
+      console.log('   Are you in the project root directory?\n');
+      process.exit(1);
+    }
+
+    // Backup existing settings if it exists
+    if (existsSync(targetPath)) {
+      const backupPath = join(process.cwd(), '.claude', 'settings.json.backup');
+      console.log('📦 Backing up current settings.json to settings.json.backup');
+      cpSync(targetPath, backupPath);
+    }
+
+    // Copy framework settings
+    console.log('📋 Copying latest framework settings.json');
+    cpSync(frameworkPath, targetPath);
+
+    console.log('\n✅ Settings updated successfully!');
+    console.log('   Updated: .claude/settings.json');
+    console.log('   Backup: .claude/settings.json.backup (if previous file existed)\n');
+    console.log('💡 Note: Your .claude/settings.local.json overrides are preserved\n');
+  }
+}