fg-devkit 1.24.0 → 1.24.1

package/README.md

@@ -96,9 +96,10 @@ pnpm exec fgd setup-ai-rules
 ```
 
 It enables the `fg-core` and `fg-frontend` plugins in `.claude/settings.json`, adds the `fg` marketplace
-to Claude Code if it is missing, and installs the plugins for the repo. Claude Code doesn't install them from
-the settings file on its own, so every developer runs it once per repo; commit `.claude/settings.json`
-the first time. Needs Claude Code and SSH access to `feelgood/fg-ai-rules`.
+to Claude Code if it is missing, and installs the plugins once for the user, disabled at user scope. The
+repo's `.claude/settings.json` then switches them on, so every repo that commits that file gets the rules
+and other repos don't. Each developer runs it once on their machine; commit `.claude/settings.json` in
+each repo. Needs Claude Code and SSH access to `feelgood/fg-ai-rules`.
 
 Run full consumer setup in one command:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fg-devkit",
-  "version": "1.24.0",
+  "version": "1.24.1",
   "description": "Shared configs, scripts, and DX tooling for Vue / TypeScript frontend repos",
   "type": "module",
   "license": "UNLICENSED",

package/scaffold/vue/package.json

@@ -32,7 +32,7 @@
     "@intlify/unplugin-vue-i18n": "11.2.6",
     "@tanstack/vue-query-devtools": "6.3.3",
     "@types/node": "22.16.5",
-    "fg-devkit": "1.24.0",
+    "fg-devkit": "1.24.1",
     "@vitejs/plugin-vue": "6.0.10",
     "tailwindcss": "4.3.3",
     "tsx": "4.23.15",

package/scripts/fg-devkit.mjs

@@ -577,7 +577,7 @@ Commands:
   sync-vite-plugin-vue-inspector  Add/pin vite-plugin-vue-inspector, wire vite.config, install, commit
   sync-consumer-scripts           Enforce standard fgd scripts in consumer package.json
   setup-lefthook                  Write lefthook.yml and install the git hooks
-  setup-ai-rules                  Enable the fg-ai-rules Claude Code plugins in this repo and install them
+  setup-ai-rules                  Enable the fg-ai-rules Claude Code plugins in this repo, install them once per machine
   full-consumer-setup             Run: scripts -> lefthook -> step 3 -> step 2 -> pnpm install -> AI rules
   create-release [release|candidate] [patch|minor|major] [--skip-release-notes]
                                  Stable release or candidate (X.Y.Z-rc.N); omit = interactive menu

package/scripts/setup-ai-rules.mjs

@@ -5,12 +5,13 @@
  *   1. Add the `fg` marketplace and enable fg-core and fg-frontend in .claude/settings.json,
  *      keeping every other setting.
  *   2. Add the marketplace to Claude Code on this machine if it is missing.
- *   3. Install the plugins for this repo (`claude plugin install … --scope project`). Claude Code
- *      does not install them from the settings file on its own, and without the install they don't
- *      load at session start.
+ *   3. Install the plugins once for the user (`--scope user`) and disable them at user scope.
+ *      Claude Code doesn't install plugins from a repo's settings file on its own, and a
+ *      project-scope install only covers one repo. A user-scope install covers every repo, and
+ *      disabling it at user scope leaves the repo's .claude/settings.json to switch it on.
  *
- * Safe to run again: it only changes what is missing. Commit .claude/settings.json afterwards so
- * teammates get the same plugins; each of them still runs this once.
+ * Safe to run again: it only changes what is missing. Once a developer has run it in any repo,
+ * every other repo that commits the same .claude/settings.json works without running it again.
  *
  * Usage:
  *   pnpm exec fg-devkit setup-ai-rules
@@ -38,6 +39,16 @@ function claude(args, { capture = false } = {}) {
   return { status: result.status ?? 1, stdout: result.stdout ?? '' }
 }
 
+/** Last JSON line of a command that prints one result line with --json. */
+function claudeJsonLine(args) {
+  const lines = claude([...args, '--json'], { capture: true }).stdout.trim().split('\n')
+  try {
+    return JSON.parse(lines.at(-1))
+  } catch {
+    return null
+  }
+}
+
 function claudeJson(args) {
   const result = claude([...args, '--json'], { capture: true })
   if (result.status !== 0) return null
@@ -77,7 +88,10 @@ function updateSettings() {
 function printManualSteps() {
   console.log(`${TAG} Run these from the repo root, then restart Claude Code:`)
   console.log(`  claude plugin marketplace add ${MARKETPLACE_REPO}`)
-  for (const plugin of PLUGINS) console.log(`  claude plugin install ${plugin}@${MARKETPLACE} --scope project`)
+  for (const plugin of PLUGINS) {
+    console.log(`  claude plugin install ${plugin}@${MARKETPLACE} --scope user`)
+    console.log(`  claude plugin disable ${plugin}@${MARKETPLACE} --scope user`)
+  }
 }
 
 function main() {
@@ -106,21 +120,24 @@ function main() {
   }
 
   const installed = claudeJson(['plugin', 'list']) ?? []
-  const isInstalledHere = (plugin) =>
-    installed.some(
-      (entry) =>
-        entry.id === `${plugin}@${MARKETPLACE}` &&
-        (entry.scope === 'user' || (entry.projectPath && fs.realpathSync(entry.projectPath) === projectRoot)),
-    )
-
   let failed = false
   for (const plugin of PLUGINS) {
-    if (isInstalledHere(plugin)) {
-      console.log(`${TAG} ${plugin} is already installed for this repo.`)
-      continue
+    const id = `${plugin}@${MARKETPLACE}`
+    if (installed.some((entry) => entry.id === id && entry.scope === 'user')) {
+      console.log(`${TAG} ${plugin} is already installed.`)
+    } else {
+      console.log(`${TAG} Installing ${plugin}…`)
+      if (claude(['plugin', 'install', id, '--scope', 'user']).status !== 0) {
+        failed = true
+        continue
+      }
+    }
+    // Off at user scope, so only repos whose .claude/settings.json enables it load it.
+    const disabled = claudeJsonLine(['plugin', 'disable', id, '--scope', 'user'])
+    if (!disabled || (disabled.outcome !== 'ok' && !disabled.alreadyInGoalState)) {
+      console.error(`${TAG} Could not disable ${plugin} at user scope: ${disabled?.message ?? 'unknown error'}`)
+      failed = true
     }
-    console.log(`${TAG} Installing ${plugin}…`)
-    if (claude(['plugin', 'install', `${plugin}@${MARKETPLACE}`, '--scope', 'project']).status !== 0) failed = true
   }
   if (failed) {
     printManualSteps()
@@ -128,7 +145,7 @@ function main() {
   }
 
   console.log(`${TAG} Done. Restart Claude Code to load the rules.`)
-  if (settingsChanged) console.log(`${TAG} Commit .claude/settings.json so teammates get the same plugins.`)
+  if (settingsChanged) console.log(`${TAG} Commit .claude/settings.json so other repos and teammates get the same plugins.`)
   return 0
 }