coding-friend-cli 1.9.1 → 1.11.0

package/README.md

@@ -16,10 +16,18 @@ npm i -g coding-friend-cli
 ## Commands
 
 ```bash
-cf install           # Install the Coding Friend plugin into Claude Code
-                     # 💡 Safe to run multiple times (idempotent).
-cf uninstall         # Completely remove plugin, marketplace, statusline, completion
-                     # 💡 Interactive — asks for confirmation before acting.
+cf install              # Install plugin (interactive scope chooser)
+cf install --user       # Install at user scope (all projects)
+cf install --global     # Same as --user
+cf install --project    # Install at project scope (shared via git)
+cf install --local      # Install at local scope (this machine only)
+                        # 💡 Safe to run multiple times (idempotent).
+cf uninstall            # Uninstall plugin (interactive scope chooser)
+cf uninstall --user     # Uninstall from user scope (full cleanup)
+cf uninstall --global   # Same as --user
+cf uninstall --project  # Uninstall from project scope only
+cf uninstall --local    # Uninstall from local scope only
+                        # 💡 Interactive — asks for confirmation before acting.
 cf init              # Initialize workspace (interactive)
                      # 💡 You can run this anywhere, anytime.
 cf config            # Manage Coding Friend configuration (interactive menu)
@@ -29,11 +37,15 @@ cf host [path]       # Build and serve learning docs at localhost:3333
 cf mcp [path]        # Setup MCP server for LLM integration
                      # [path] is optional, default is `docs/learn`
                      # This prints a JSON config snippet to add to your client's MCP
+cf permission        # Manage Claude Code permission rules for Coding Friend
+cf permission --all  # Apply all recommended permissions without prompts
 cf statusline        # Setup coding-friend statusline
-cf update            # Update plugin + CLI + statusline
-cf update --cli      # Update only the CLI (npm package)
-cf update --plugin   # Update only the Claude Code plugin
+cf update               # Update plugin + CLI + statusline
+cf update --cli         # Update only the CLI (npm package)
+cf update --plugin      # Update only the Claude Code plugin
 cf update --statusline  # Update only the statusline
+cf update --project     # Update plugin at project scope
+cf update --local       # Update plugin at local scope
 cf dev on [path]     # Switch to local plugin source for development
 cf dev off           # Switch back to remote marketplace
 cf dev status        # Show current dev mode (local or remote)

package/dist/{chunk-7N64TDZ6.js → chunk-4JL3SR5V.js}

@@ -21,7 +21,9 @@ ${MARKER_START}
 _cf_completions() {
   local cur="\${COMP_WORDS[COMP_CWORD]}"
   local prev="\${COMP_WORDS[COMP_CWORD-1]}"
-  local commands="install uninstall init config host mcp statusline update dev session"
+  local commands="install uninstall init config host mcp permission statusline update dev session"
+  local scope_flags="--user --global --project --local"
+  local update_flags="--cli --plugin --statusline --user --global --project --local"
 
   # Subcommands for 'dev'
   if [[ "\${COMP_WORDS[1]}" == "dev" && \${COMP_CWORD} -eq 2 ]]; then
@@ -41,6 +43,18 @@ _cf_completions() {
     return
   fi
 
+  # Flag completion for install/uninstall
+  if [[ "\${COMP_WORDS[1]}" == "install" || "\${COMP_WORDS[1]}" == "uninstall" ]] && [[ "$cur" == -* ]]; then
+    COMPREPLY=($(compgen -W "$scope_flags" -- "$cur"))
+    return
+  fi
+
+  # Flag completion for update
+  if [[ "\${COMP_WORDS[1]}" == "update" && "$cur" == -* ]]; then
+    COMPREPLY=($(compgen -W "$update_flags" -- "$cur"))
+    return
+  fi
+
   COMPREPLY=($(compgen -W "$commands" -- "$cur"))
 }
 complete -o default -F _cf_completions cf
@@ -55,14 +69,38 @@ var ZSH_FUNCTION_BODY = `_cf() {
     'config:Manage Coding Friend configuration'
     'host:Build and serve learning docs as a static website'
     'mcp:Setup MCP server for learning docs'
+    'permission:Manage Claude Code permission rules for Coding Friend'
     'statusline:Setup coding-friend statusline in Claude Code'
     'update:Update coding-friend plugin and refresh statusline'
     'dev:Switch between local and remote plugin for development'
     'session:Save and load Claude Code sessions across machines'
   )
 
+  local -a scope_flags
+  scope_flags=(
+    '--user[Install at user scope (all projects)]'
+    '--global[Install at user scope (all projects)]'
+    '--project[Install at project scope (shared via git)]'
+    '--local[Install at local scope (this machine only)]'
+  )
+
+  local -a update_flags
+  update_flags=(
+    '--cli[Update only the CLI (npm package)]'
+    '--plugin[Update only the Claude Code plugin]'
+    '--statusline[Update only the statusline]'
+    '--user[Update plugin at user scope (all projects)]'
+    '--global[Update plugin at user scope (all projects)]'
+    '--project[Update plugin at project scope]'
+    '--local[Update plugin at local scope]'
+  )
+
   if (( CURRENT == 2 )); then
     _describe 'command' commands
+  elif (( CURRENT >= 3 )) && [[ "\${words[2]}" == "install" || "\${words[2]}" == "uninstall" ]]; then
+    _values 'flags' $scope_flags
+  elif (( CURRENT >= 3 )) && [[ "\${words[2]}" == "update" ]]; then
+    _values 'flags' $update_flags
   elif (( CURRENT == 3 )) && [[ "\${words[2]}" == "dev" ]]; then
     local -a subcommands
     subcommands=(
@@ -103,16 +141,32 @@ complete -c cf -n "__fish_use_subcommand" -a init -d "Initialize coding-friend i
 complete -c cf -n "__fish_use_subcommand" -a config -d "Manage Coding Friend configuration"
 complete -c cf -n "__fish_use_subcommand" -a host -d "Build and serve learning docs as a static website"
 complete -c cf -n "__fish_use_subcommand" -a mcp -d "Setup MCP server for learning docs"
+complete -c cf -n "__fish_use_subcommand" -a permission -d "Manage Claude Code permission rules"
 complete -c cf -n "__fish_use_subcommand" -a statusline -d "Setup coding-friend statusline in Claude Code"
 complete -c cf -n "__fish_use_subcommand" -a update -d "Update coding-friend plugin and refresh statusline"
 complete -c cf -n "__fish_use_subcommand" -a dev -d "Switch between local and remote plugin for development"
 complete -c cf -n "__fish_use_subcommand" -a session -d "Save and load Claude Code sessions across machines"
+# Scope flags for install/uninstall
+complete -c cf -n "__fish_seen_subcommand_from install uninstall" -l user -d "User scope (all projects)"
+complete -c cf -n "__fish_seen_subcommand_from install uninstall" -l global -d "User scope (all projects)"
+complete -c cf -n "__fish_seen_subcommand_from install uninstall" -l project -d "Project scope (shared via git)"
+complete -c cf -n "__fish_seen_subcommand_from install uninstall" -l local -d "Local scope (this machine only)"
+# Flags for update
+complete -c cf -n "__fish_seen_subcommand_from update" -l cli -d "Update only the CLI"
+complete -c cf -n "__fish_seen_subcommand_from update" -l plugin -d "Update only the plugin"
+complete -c cf -n "__fish_seen_subcommand_from update" -l statusline -d "Update only the statusline"
+complete -c cf -n "__fish_seen_subcommand_from update" -l user -d "User scope (all projects)"
+complete -c cf -n "__fish_seen_subcommand_from update" -l global -d "User scope (all projects)"
+complete -c cf -n "__fish_seen_subcommand_from update" -l project -d "Project scope"
+complete -c cf -n "__fish_seen_subcommand_from update" -l local -d "Local scope"
+# Dev subcommands
 complete -c cf -n "__fish_seen_subcommand_from dev" -a on -d "Switch to local plugin source"
 complete -c cf -n "__fish_seen_subcommand_from dev" -a off -d "Switch back to remote marketplace"
 complete -c cf -n "__fish_seen_subcommand_from dev" -a status -d "Show current dev mode"
 complete -c cf -n "__fish_seen_subcommand_from dev" -a restart -d "Restart dev mode"
 complete -c cf -n "__fish_seen_subcommand_from dev" -a sync -d "Sync local plugin files"
 complete -c cf -n "__fish_seen_subcommand_from dev" -a update -d "Update local dev plugin"
+# Session subcommands
 complete -c cf -n "__fish_seen_subcommand_from session" -a save -d "Save current session to docs/sessions/"
 complete -c cf -n "__fish_seen_subcommand_from session" -a load -d "Load a saved session from docs/sessions/"
 `;
@@ -121,9 +175,11 @@ var POWERSHELL_BLOCK = `
 ${MARKER_START}
 Register-ArgumentCompleter -Native -CommandName cf -ScriptBlock {
   param($wordToComplete, $commandAst, $cursorPosition)
-  $commands = @('install','uninstall','init','config','host','mcp','statusline','update','dev','session')
+  $commands = @('install','uninstall','init','config','host','mcp','permission','statusline','update','dev','session')
   $devSubcommands = @('on','off','status','restart','sync','update')
   $sessionSubcommands = @('save','load')
+  $scopeFlags = @('--user','--global','--project','--local')
+  $updateFlags = @('--cli','--plugin','--statusline','--user','--global','--project','--local')
   $words = $commandAst.CommandElements
   if ($words.Count -ge 2 -and $words[1].ToString() -eq 'dev') {
     $devSubcommands | Where-Object { $_ -like "$wordToComplete*" } |
@@ -131,6 +187,12 @@ Register-ArgumentCompleter -Native -CommandName cf -ScriptBlock {
   } elseif ($words.Count -ge 2 -and $words[1].ToString() -eq 'session') {
     $sessionSubcommands | Where-Object { $_ -like "$wordToComplete*" } |
       ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+  } elseif ($words.Count -ge 2 -and ($words[1].ToString() -eq 'install' -or $words[1].ToString() -eq 'uninstall')) {
+    $scopeFlags | Where-Object { $_ -like "$wordToComplete*" } |
+      ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+  } elseif ($words.Count -ge 2 -and $words[1].ToString() -eq 'update') {
+    $updateFlags | Where-Object { $_ -like "$wordToComplete*" } |
+      ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
   } else {
     $commands | Where-Object { $_ -like "$wordToComplete*" } |
       ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }

package/dist/{chunk-HFLBFX6J.js → chunk-E2XX5MIM.js}

@@ -2,7 +2,7 @@ import {
   installedPluginsPath,
   knownMarketplacesPath,
   readJson
-} from "./chunk-TPRZHSFS.js";
+} from "./chunk-ZS7BLEYT.js";
 
 // src/lib/plugin-state.ts
 var MARKETPLACE_NAME = "coding-friend-marketplace";

package/dist/chunk-EL6BAAKL.js

@@ -0,0 +1,198 @@
+import {
+  readJson,
+  writeJson
+} from "./chunk-ZS7BLEYT.js";
+
+// src/lib/permissions.ts
+var PERMISSION_RULES = [
+  // Core (hooks & infrastructure)
+  {
+    rule: "Bash(cat:*)",
+    description: "[read-only] Read file contents (\u26A0 system-wide scope, project boundary enforced by Claude Code) \xB7 Used by: session-init hook",
+    category: "Core",
+    recommended: true
+  },
+  {
+    rule: "Bash(grep:*)",
+    description: "[read-only] Search file contents (\u26A0 system-wide scope, project boundary enforced by Claude Code) \xB7 Used by: session-init hook, skills",
+    category: "Core",
+    recommended: true
+  },
+  {
+    rule: "Bash(sed:*)",
+    description: "[modify] Text transformation \xB7 Used by: session-init hook",
+    category: "Core",
+    recommended: true
+  },
+  {
+    rule: "Bash(tr:*)",
+    description: "[read-only] Character translation \xB7 Used by: session-init hook",
+    category: "Core",
+    recommended: true
+  },
+  {
+    rule: "Bash(wc:*)",
+    description: "[read-only] Count lines/words \xB7 Used by: cf-verification, skills",
+    category: "Core",
+    recommended: true
+  },
+  {
+    rule: "Bash(mkdir:*)",
+    description: "[write] Create directories \xB7 Used by: docs folder setup",
+    category: "Core",
+    recommended: true
+  },
+  // Git Operations
+  {
+    rule: "Bash(git add:*)",
+    description: "[modify] Stage files for commit \xB7 Used by: /cf-commit, /cf-ship",
+    category: "Git",
+    recommended: true
+  },
+  {
+    rule: "Bash(git commit:*)",
+    description: "[modify] Create commits \xB7 Used by: /cf-commit, /cf-ship",
+    category: "Git",
+    recommended: true
+  },
+  {
+    rule: "Bash(git status:*)",
+    description: "[read-only] Check working tree status \xB7 Used by: /cf-commit, /cf-review, cf-verification",
+    category: "Git",
+    recommended: true
+  },
+  {
+    rule: "Bash(git diff:*)",
+    description: "[read-only] View file changes \xB7 Used by: /cf-commit, /cf-review, cf-verification",
+    category: "Git",
+    recommended: true
+  },
+  {
+    rule: "Bash(git log:*)",
+    description: "[read-only] View commit history \xB7 Used by: /cf-commit, /cf-review, cf-sys-debug",
+    category: "Git",
+    recommended: true
+  },
+  {
+    rule: "Bash(git push:*)",
+    description: "[remote] Push commits to remote \xB7 Used by: /cf-ship",
+    category: "Git",
+    recommended: true
+  },
+  {
+    rule: "Bash(git pull:*)",
+    description: "[remote] Pull changes from remote \xB7 Used by: /cf-ship",
+    category: "Git",
+    recommended: true
+  },
+  {
+    rule: "Bash(gh pr create:*)",
+    description: "[remote] Create GitHub pull requests \xB7 Used by: /cf-ship",
+    category: "Git",
+    recommended: true
+  },
+  // Testing & Build
+  {
+    rule: "Bash(npm test:*)",
+    description: "[execute] Run test suites \xB7 Used by: cf-verification, /cf-fix, cf-tdd",
+    category: "Testing & Build",
+    recommended: true
+  },
+  {
+    rule: "Bash(npm run:*)",
+    description: "[execute] Run npm scripts (build, lint, format) \xB7 Used by: cf-verification",
+    category: "Testing & Build",
+    recommended: true
+  },
+  // Web & Research
+  {
+    rule: "WebSearch",
+    description: "[network] Perform web searches \xB7 Used by: /cf-research",
+    category: "Web & Research",
+    recommended: false
+  },
+  {
+    rule: "WebFetch(domain:*)",
+    description: "[network] Fetch content from web pages \xB7 Used by: /cf-research",
+    category: "Web & Research",
+    recommended: false
+  }
+];
+function getExistingRules(settingsPath) {
+  const settings = readJson(settingsPath);
+  if (!settings) return [];
+  const permissions = settings.permissions;
+  return permissions?.allow ?? [];
+}
+function getMissingRules(existing, rules) {
+  return rules.filter((r) => !existing.includes(r.rule));
+}
+function buildLearnDirRules(learnPath, autoCommit) {
+  const rules = [
+    {
+      rule: `Read(${learnPath}/**)`,
+      description: "[read-only] Read learning docs \xB7 Used by: /cf-learn",
+      category: "External Learn Directory",
+      recommended: true
+    },
+    {
+      rule: `Edit(${learnPath}/**)`,
+      description: "[modify] Edit learning docs \xB7 Used by: /cf-learn",
+      category: "External Learn Directory",
+      recommended: true
+    },
+    {
+      rule: `Write(${learnPath}/**)`,
+      description: "[write] Write learning docs \xB7 Used by: /cf-learn",
+      category: "External Learn Directory",
+      recommended: true
+    }
+  ];
+  if (autoCommit) {
+    const quoted = learnPath.includes(" ") ? `"${learnPath}"` : learnPath;
+    rules.push({
+      rule: `Bash(cd ${quoted} && git add:*)`,
+      description: "[modify] Stage learning docs for commit \xB7 Used by: /cf-learn auto-commit",
+      category: "External Learn Directory",
+      recommended: true
+    });
+    rules.push({
+      rule: `Bash(cd ${quoted} && git commit:*)`,
+      description: "[modify] Commit learning docs \xB7 Used by: /cf-learn auto-commit",
+      category: "External Learn Directory",
+      recommended: true
+    });
+  }
+  return rules;
+}
+function applyPermissions(settingsPath, toAdd, toRemove) {
+  const settings = readJson(settingsPath) ?? {};
+  const permissions = settings.permissions ?? {};
+  const existing = permissions.allow ?? [];
+  const afterRemove = existing.filter((r) => !toRemove.includes(r));
+  const afterAdd = [
+    ...afterRemove,
+    ...toAdd.filter((r) => !afterRemove.includes(r))
+  ];
+  permissions.allow = afterAdd;
+  settings.permissions = permissions;
+  writeJson(settingsPath, settings);
+}
+function groupByCategory(rules) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const rule of rules) {
+    const list = groups.get(rule.category) ?? [];
+    list.push(rule);
+    groups.set(rule.category, list);
+  }
+  return groups;
+}
+
+export {
+  PERMISSION_RULES,
+  getExistingRules,
+  getMissingRules,
+  buildLearnDirRules,
+  applyPermissions,
+  groupByCategory
+};

package/dist/{chunk-QQ5SVZET.js → chunk-GJLNN6X5.js}

@@ -5,7 +5,7 @@ import {
   globalConfigPath,
   localConfigPath,
   readJson
-} from "./chunk-TPRZHSFS.js";
+} from "./chunk-ZS7BLEYT.js";
 import {
   log
 } from "./chunk-W5CD7WTX.js";
@@ -26,13 +26,58 @@ async function askScope(label = "Save to:") {
   return select({
     message: label,
     choices: [
-      { name: "Global (all projects)", value: "global" },
       { name: "This project only", value: "local" },
+      { name: "Global (all projects)", value: "global" },
       new Separator(),
       { name: "Back", value: "back" }
     ]
   });
 }
+async function askPluginScope() {
+  return select({
+    message: "Where should the plugin be installed?",
+    choices: [
+      {
+        name: "User / Global \u2014 available in all projects",
+        value: "user"
+      },
+      {
+        name: "Project \u2014 shared with team via .claude/settings.json",
+        value: "project"
+      },
+      {
+        name: "Local \u2014 this machine only, not shared (gitignored)",
+        value: "local"
+      }
+    ]
+  });
+}
+async function resolveScope(opts) {
+  const flags = [
+    { key: "user", scope: "user" },
+    { key: "global", scope: "user" },
+    { key: "project", scope: "project" },
+    { key: "local", scope: "local" }
+  ];
+  const active = flags.filter((f) => opts[f.key] === true);
+  const uniqueScopes = new Set(active.map((f) => f.scope));
+  if (uniqueScopes.size > 1) {
+    log.error(
+      "Only one scope flag can be used at a time: --user, --global, --project, or --local"
+    );
+    process.exit(1);
+  }
+  if (uniqueScopes.size === 1) {
+    return active[0].scope;
+  }
+  if (!process.stdin.isTTY) {
+    log.error(
+      "No scope flag provided and stdin is not interactive. Use --user (or --global), --project, or --local."
+    );
+    process.exit(1);
+  }
+  return askPluginScope();
+}
 function showConfigHint() {
   console.log(chalk.dim("Config files:"));
   console.log(chalk.dim("  Global: ~/.coding-friend/config.json"));
@@ -127,6 +172,7 @@ export {
   BACK,
   injectBackChoice,
   askScope,
+  resolveScope,
   showConfigHint,
   getScopeLabel,
   formatScopeLabel,

package/dist/{chunk-BPLN4LDL.js → chunk-HYLS67T7.js}

@@ -10,7 +10,7 @@ import {
   pluginCachePath,
   readJson,
   writeJson
-} from "./chunk-TPRZHSFS.js";
+} from "./chunk-ZS7BLEYT.js";
 
 // src/lib/statusline.ts
 import { existsSync, readdirSync } from "fs";

package/dist/{chunk-VYMXERKM.js → chunk-RN5UYDIT.js}

@@ -1,10 +1,13 @@
 import {
   ensureStatusline,
   getInstalledVersion
-} from "./chunk-BPLN4LDL.js";
+} from "./chunk-HYLS67T7.js";
+import {
+  resolveScope
+} from "./chunk-GJLNN6X5.js";
 import {
   ensureShellCompletion
-} from "./chunk-7N64TDZ6.js";
+} from "./chunk-4JL3SR5V.js";
 import {
   commandExists,
   run,
@@ -13,7 +16,7 @@ import {
 import {
   claudeSettingsPath,
   readJson
-} from "./chunk-TPRZHSFS.js";
+} from "./chunk-ZS7BLEYT.js";
 import {
   log
 } from "./chunk-W5CD7WTX.js";
@@ -86,6 +89,13 @@ async function updateCommand(opts) {
   const doCli = updateAll || !!opts.cli;
   const doPlugin = updateAll || !!opts.plugin;
   const doStatusline = updateAll || !!opts.statusline;
+  const hasScopeFlag = !!(opts.user || opts.global || opts.project || opts.local);
+  let scope;
+  if (doPlugin && hasScopeFlag) {
+    scope = await resolveScope(opts);
+  } else if (doPlugin && !hasScopeFlag) {
+    scope = "user";
+  }
   console.log("=== \u{1F33F} Coding Friend Update \u{1F33F} ===");
   console.log();
   const currentVersion = getInstalledVersion();
@@ -135,12 +145,18 @@ async function updateCommand(opts) {
             "Claude CLI not found. Install it first, or run: claude plugin update coding-friend@coding-friend-marketplace"
           );
         } else {
-          log.step("Updating plugin...");
-          const result = run("claude", [
+          log.step(
+            `Updating plugin${scope && scope !== "user" ? ` (${scope} scope)` : ""}...`
+          );
+          const updateArgs = [
             "plugin",
             "update",
             "coding-friend@coding-friend-marketplace"
-          ]);
+          ];
+          if (scope) {
+            updateArgs.push("--scope", scope);
+          }
+          const result = run("claude", updateArgs);
           if (result === null) {
             log.error(
               "Plugin update failed. Try manually: claude plugin update coding-friend@coding-friend-marketplace"

package/dist/{chunk-FYHHNX7K.js → chunk-XIZJ64JK.js}

@@ -6,7 +6,7 @@ import {
   localConfigPath,
   readJson,
   resolvePath
-} from "./chunk-TPRZHSFS.js";
+} from "./chunk-ZS7BLEYT.js";
 
 // src/lib/config.ts
 function loadConfig() {

package/dist/{chunk-TPRZHSFS.js → chunk-ZS7BLEYT.js}

@@ -1,26 +1,3 @@
-// src/lib/json.ts
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
-import { dirname } from "path";
-function readJson(filePath) {
-  try {
-    const content = readFileSync(filePath, "utf-8");
-    return JSON.parse(content);
-  } catch {
-    return null;
-  }
-}
-function writeJson(filePath, data) {
-  const dir = dirname(filePath);
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-  writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n", "utf-8");
-}
-function mergeJson(filePath, data) {
-  const existing = readJson(filePath) ?? {};
-  writeJson(filePath, { ...existing, ...data });
-}
-
 // src/lib/paths.ts
 import { homedir } from "os";
 import { resolve, join } from "path";
@@ -38,6 +15,9 @@ function globalConfigPath() {
 function claudeSettingsPath() {
   return join(homedir(), ".claude", "settings.json");
 }
+function claudeLocalSettingsPath() {
+  return resolve(process.cwd(), ".claude", "settings.local.json");
+}
 function installedPluginsPath() {
   return join(homedir(), ".claude", "plugins", "installed_plugins.json");
 }
@@ -88,14 +68,35 @@ function claudeSessionDir(encodedPath) {
   return join(claudeProjectsDir(), encodedPath);
 }
 
+// src/lib/json.ts
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { dirname } from "path";
+function readJson(filePath) {
+  try {
+    const content = readFileSync(filePath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+function writeJson(filePath, data) {
+  const dir = dirname(filePath);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n", "utf-8");
+}
+function mergeJson(filePath, data) {
+  const existing = readJson(filePath) ?? {};
+  writeJson(filePath, { ...existing, ...data });
+}
+
 export {
-  readJson,
-  writeJson,
-  mergeJson,
   resolvePath,
   localConfigPath,
   globalConfigPath,
   claudeSettingsPath,
+  claudeLocalSettingsPath,
   installedPluginsPath,
   pluginCachePath,
   devStatePath,
@@ -104,5 +105,8 @@ export {
   marketplaceClonePath,
   globalConfigDir,
   encodeProjectPath,
-  claudeSessionDir
+  claudeSessionDir,
+  readJson,
+  writeJson,
+  mergeJson
 };

package/dist/{config-VAML7F7K.js → config-GYJGDXGV.js}

@@ -1,3 +1,10 @@
+import {
+  findStatuslineHookPath,
+  isStatuslineConfigured,
+  saveStatuslineConfig,
+  selectStatuslineComponents,
+  writeStatuslineSettings
+} from "./chunk-HYLS67T7.js";
 import {
   BACK,
   applyDocsDirChange,
@@ -7,19 +14,12 @@ import {
   getScopeLabel,
   injectBackChoice,
   showConfigHint
-} from "./chunk-QQ5SVZET.js";
-import {
-  findStatuslineHookPath,
-  isStatuslineConfigured,
-  saveStatuslineConfig,
-  selectStatuslineComponents,
-  writeStatuslineSettings
-} from "./chunk-BPLN4LDL.js";
+} from "./chunk-GJLNN6X5.js";
 import {
   ensureShellCompletion,
   hasShellCompletion,
   removeShellCompletion
-} from "./chunk-7N64TDZ6.js";
+} from "./chunk-4JL3SR5V.js";
 import {
   ALL_COMPONENT_IDS,
   DEFAULT_CONFIG
@@ -33,7 +33,7 @@ import {
   mergeJson,
   readJson,
   resolvePath
-} from "./chunk-TPRZHSFS.js";
+} from "./chunk-ZS7BLEYT.js";
 import {
   log
 } from "./chunk-W5CD7WTX.js";