fg-devkit 1.24.2 → 1.24.4

package/README.md

@@ -95,8 +95,10 @@ To use the shared AI rules from [feelgood/fg-ai-rules](https://github.com/feelgo
 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 once for the user, disabled at user scope. The
+It adds the `fg` marketplace to Claude Code if it is missing and asks which of its plugins the repo
+should use (the repo's current choice, or `fg-core` and `fg-frontend`, is preselected; pass
+`--plugins=fg-core,fg-backend` to skip the question). It enables those in `.claude/settings.json` and
+installs them 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. When `.claude/settings.json` changed it commits that file on its own
 (`chore(repo): enable fg-ai-rules Claude Code plugins`). Each developer runs it once on their machine. Needs Claude Code and SSH access to `feelgood/fg-ai-rules`.

package/configs/dependency-policy.vue-workspace.json

@@ -17,7 +17,7 @@
       "@lexical/rich-text": "0.52.0",
       "@lexical/link": "0.52.0",
       "@piwikpro/vue-piwik-pro": "2.0.0",
-      "@sentry/vue": "11.7.0",
+      "@sentry/vue": "11.8.0",
       "@tanstack/vue-query": "5.104.3",
       "@types/leaflet": "1.9.22",
       "@unhead/vue": "2.0.5",
@@ -30,13 +30,13 @@
       "content-disposition-header": "0.6.0",
       "date-fns": "4.4.0",
       "element-plus": "2.14.7",
-      "fds-vue-core": "8.11.0",
+      "fds-vue-core": "8.11.2",
       "imask": "7.6.1",
       "leaflet": "1.9.4",
       "lexical": "0.52.0",
       "lodash": "4.18.1",
       "lodash-es": "4.18.1",
-      "markdown-it": "15.0.2",
+      "markdown-it": "15.0.3",
       "pinia": "4.1.0",
       "playwright": "1.64.1",
       "quill": "2.0.3",
@@ -67,7 +67,7 @@
       "@tsconfig/node22": "22.0.6",
       "@types/lodash-es": "4.17.12",
       "@types/node": "22.16.5",
-      "@vitest/browser": "5.0.4",
+      "@vitest/browser": "5.0.5",
       "@vue/compiler-dom": "3.5.44",
       "@vue/eslint-config-standard": "8.0.1",
       "@vue/server-renderer": "3.5.44",
@@ -76,15 +76,15 @@
       "babel-eslint": "10.1.0",
       "eslint-plugin-storybook": "10.6.2",
       "globals": "15.11.0",
-      "jsdom": "30.1.2",
-      "sass": "1.105.1",
+      "jsdom": "30.1.3",
+      "sass": "1.105.2",
       "storybook": "10.6.2",
       "tsx": "4.23.15",
       "vega": "6.4.0",
       "vite-plugin-dts": "5.1.2",
       "vite-plugin-vue-devtools": "8.2.1",
       "vite-plugin-vue-inspector": "7.0.0",
-      "vitest": "5.0.4",
+      "vitest": "5.0.5",
       "yaml": "2.9.1"
     }
   },

package/package.json

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

package/scaffold/vue/package.json

@@ -21,7 +21,7 @@
     "content-disposition-header": "0.6.0",
     "date-fns": "4.4.0",
     "dotenv": "18.0.8",
-    "fds-vue-core": "8.11.0",
+    "fds-vue-core": "8.11.2",
     "pinia": "4.1.0",
     "qrcode.vue": "3.11.0",
     "vue": "3.5.44",
@@ -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.2",
+    "fg-devkit": "1.24.4",
     "@vitejs/plugin-vue": "6.0.10",
     "tailwindcss": "4.3.3",
     "tsx": "4.23.15",

package/scripts/audit-override-commit.mjs

@@ -195,8 +195,15 @@ function assertCleanGitState() {
   }
 }
 
+let gitPrefix
+
+function repoPath(file) {
+  gitPrefix ??= runOrFail('git', ['rev-parse', '--show-prefix'], { capture: true }).stdout.trim()
+  return `${gitPrefix}${file}`
+}
+
 function headContent(file) {
-  const result = run('git', ['show', `HEAD:${file}`], { capture: true })
+  const result = run('git', ['show', `HEAD:${repoPath(file)}`], { capture: true })
   return result.status === 0 ? result.stdout : undefined
 }
 
@@ -205,11 +212,11 @@ function stageContents(contents) {
   let staged = 0
   for (const [file, content] of Object.entries(contents)) {
     if (content === undefined || content === headContent(file)) continue
-    const sha = runOrFail('git', ['hash-object', '-w', '--stdin', `--path=${file}`], {
+    const sha = runOrFail('git', ['hash-object', '-w', '--stdin', `--path=${repoPath(file)}`], {
       capture: true,
       input: content,
     }).stdout.trim()
-    runOrFail('git', ['update-index', '--add', '--cacheinfo', `100644,${sha},${file}`])
+    runOrFail('git', ['update-index', '--add', '--cacheinfo', `100644,${sha},${repoPath(file)}`])
     staged += 1
   }
   return staged

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, install them once per machine, commit
+  setup-ai-rules [--plugins=a,b]  Pick the fg-ai-rules Claude Code plugins for this repo, install them once per machine, commit
   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
@@ -1091,9 +1091,9 @@ async function runInteractiveMenu() {
             description: 'Write lefthook.yml and install the git hooks',
           },
           {
-            name: autoCommit('AI rules'),
+            name: tagged('AI rules', { interactive: true, autoCommit: true }),
             value: 'ai-rules',
-            description: 'Enable the fg-ai-rules plugins in .claude/settings.json, install them for Claude Code and commit the file',
+            description: 'Pick the fg-ai-rules plugins for this repo, install them for Claude Code and commit .claude/settings.json',
           },
           {
             name: 'Full setup',

package/scripts/setup-ai-rules.mjs

@@ -2,9 +2,10 @@
 /**
  * Set up the shared AI rules from feelgood/fg-ai-rules for Claude Code in the current repo:
  *
- *   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.
+ *   1. Add the `fg` marketplace to Claude Code on this machine if it is missing, or refresh it.
+ *   2. Ask which of its plugins the repo should use (a checklist; the repo's current choice, or
+ *      fg-core and fg-frontend, is preselected) and write them to .claude/settings.json, keeping
+ *      every other setting. --plugins=fg-core,fg-backend picks them without asking.
  *   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
@@ -16,19 +17,20 @@
  * every other repo that commits the same .claude/settings.json works without running it again.
  *
  * Usage:
- *   pnpm exec fg-devkit setup-ai-rules
+ *   pnpm exec fg-devkit setup-ai-rules [--plugins=fg-core,fg-frontend]
  */
 
 import { spawnSync } from 'node:child_process'
 import fs from 'node:fs'
 import path from 'node:path'
 
-import { fileDiffersFromHead, runGit } from './lib/common.mjs'
+import { fileDiffersFromHead, readJson, runGit } from './lib/common.mjs'
 
 const TAG = '[setup-ai-rules]'
 const MARKETPLACE = 'fg'
 const MARKETPLACE_REPO = 'feelgood/fg-ai-rules'
-const PLUGINS = ['fg-core', 'fg-frontend']
+const DEFAULT_PLUGINS = ['fg-core', 'fg-frontend']
+const pluginsArg = process.argv.slice(2).find((arg) => arg.startsWith('--plugins='))
 
 const projectRoot = fs.realpathSync(process.cwd())
 const SETTINGS_FILE = '.claude/settings.json'
@@ -66,26 +68,71 @@ function claudeJson(args) {
   }
 }
 
-/** Add the marketplace and enabled plugins to .claude/settings.json. Returns true when it changed. */
-function updateSettings() {
-  let settings = {}
-  if (fs.existsSync(settingsPath)) {
-    try {
-      settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'))
-    } catch (err) {
-      console.error(`${TAG} Could not parse ${settingsPath}: ${err.message}`)
-      process.exit(1)
+function readSettings() {
+  if (!fs.existsSync(settingsPath)) return {}
+  try {
+    return JSON.parse(fs.readFileSync(settingsPath, 'utf8'))
+  } catch (err) {
+    console.error(`${TAG} Could not parse ${settingsPath}: ${err.message}`)
+    process.exit(1)
+  }
+}
+
+/** Plugins this repo enables from the marketplace. */
+function enabledInRepo(settings) {
+  return Object.entries(settings.enabledPlugins ?? {})
+    .filter(([id, enabled]) => enabled && id.endsWith(`@${MARKETPLACE}`))
+    .map(([id]) => id.slice(0, -`@${MARKETPLACE}`.length))
+}
+
+/** Plugins listed in the marketplace on this machine: `[{ name, description }]`. */
+function marketplacePlugins(installLocation) {
+  try {
+    return readJson(path.join(installLocation, '.claude-plugin', 'marketplace.json')).plugins ?? []
+  } catch {
+    return []
+  }
+}
+
+async function choosePlugins(available, settings) {
+  const names = available.map((plugin) => plugin.name)
+  if (pluginsArg) {
+    const chosen = pluginsArg.slice('--plugins='.length).split(',').filter(Boolean)
+    const unknown = chosen.filter((name) => !names.includes(name))
+    if (unknown.length > 0) {
+      console.error(`${TAG} Unknown plugin(s): ${unknown.join(', ')}. Available: ${names.join(', ')}`)
+      return null
     }
+    return chosen
   }
+  const current = enabledInRepo(settings).filter((name) => names.includes(name))
+  const preselected = current.length > 0 ? current : DEFAULT_PLUGINS.filter((name) => names.includes(name))
+  if (!process.stdin.isTTY) return preselected
+  const checkbox = (await import('@inquirer/checkbox')).default
+  return checkbox({
+    message: 'Which fg-ai-rules plugins should this repo use?',
+    choices: available.map((plugin) => ({
+      name: plugin.name,
+      value: plugin.name,
+      description: plugin.description,
+      checked: preselected.includes(plugin.name),
+    })),
+    required: true,
+  })
+}
+
+/** Enable the chosen plugins in .claude/settings.json and drop the other fg ones. Returns true when it changed. */
+function updateSettings(settings, plugins) {
   const before = JSON.stringify(settings)
   settings.extraKnownMarketplaces = {
     ...settings.extraKnownMarketplaces,
     [MARKETPLACE]: { source: { source: 'github', repo: MARKETPLACE_REPO }, autoUpdate: true },
   }
-  settings.enabledPlugins = {
-    ...settings.enabledPlugins,
-    ...Object.fromEntries(PLUGINS.map((plugin) => [`${plugin}@${MARKETPLACE}`, true])),
-  }
+  const others = Object.entries(settings.enabledPlugins ?? {}).filter(([id]) => !id.endsWith(`@${MARKETPLACE}`))
+  settings.enabledPlugins = Object.fromEntries([
+    ...others,
+    ...plugins.map((plugin) => [`${plugin}@${MARKETPLACE}`, true]),
+  ])
   if (JSON.stringify(settings) === before) return false
   fs.mkdirSync(path.dirname(settingsPath), { recursive: true })
   fs.writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}\n`)
@@ -106,43 +153,62 @@ function commitSettings() {
   return status
 }
 
-function printManualSteps() {
-  console.log(`${TAG} Run these from the repo root, then restart Claude Code:`)
+function printManualSteps(plugins) {
+  console.log(`${TAG} Run these, then restart Claude Code:`)
   console.log(`  claude plugin marketplace add ${MARKETPLACE_REPO}`)
-  for (const plugin of PLUGINS) {
+  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() {
+async function main() {
   if (!fs.existsSync(path.join(projectRoot, 'package.json'))) {
     console.error(`${TAG} Run from the repo root (no package.json in ${projectRoot}).`)
     return 1
   }
 
-  const settingsChanged = updateSettings()
-  console.log(`${TAG} ${settingsChanged ? 'Updated' : 'Already up to date:'} .claude/settings.json`)
-
   const marketplaces = claudeJson(['plugin', 'marketplace', 'list'])
   if (marketplaces === null) {
     const missing = claude(['--version'], { capture: true }).missing
     console.error(`${TAG} ${missing ? 'Claude Code (claude) is not installed.' : 'Could not read Claude Code plugins.'}`)
-    printManualSteps()
+    printManualSteps(DEFAULT_PLUGINS)
     return 1
   }
 
-  if (!marketplaces.some((marketplace) => marketplace.name === MARKETPLACE)) {
+  let marketplace = marketplaces.find((entry) => entry.name === MARKETPLACE)
+  if (marketplace) {
+    // Refresh so the checklist shows plugins added to fg-ai-rules since the last update.
+    claude(['plugin', 'marketplace', 'update', MARKETPLACE], { capture: true })
+  } else {
     console.log(`${TAG} Adding the ${MARKETPLACE} marketplace (${MARKETPLACE_REPO})…`)
     if (claude(['plugin', 'marketplace', 'add', MARKETPLACE_REPO]).status !== 0) {
       console.error(`${TAG} Could not add the marketplace. Check that you can clone ${MARKETPLACE_REPO} over SSH.`)
       return 1
     }
+    marketplace = claudeJson(['plugin', 'marketplace', 'list'])?.find((entry) => entry.name === MARKETPLACE)
   }
 
+  const available = marketplacePlugins(marketplace?.installLocation ?? '')
+  if (available.length === 0) {
+    console.error(`${TAG} Could not read the plugins in the ${MARKETPLACE} marketplace.`)
+    return 1
+  }
+
+  const settings = readSettings()
+  const plugins = await choosePlugins(available, settings)
+  if (!plugins) return 1
+  if (plugins.length === 0) {
+    console.error(`${TAG} No plugins chosen.`)
+    return 1
+  }
+
+  const settingsChanged = updateSettings(settings, plugins)
+  console.log(`${TAG} ${settingsChanged ? 'Updated' : 'Already up to date:'} ${SETTINGS_FILE} (${plugins.join(', ')})`)
+
   const installed = claudeJson(['plugin', 'list']) ?? []
   let failed = false
-  for (const plugin of PLUGINS) {
+  for (const plugin of plugins) {
     const id = `${plugin}@${MARKETPLACE}`
     if (installed.some((entry) => entry.id === id && entry.scope === 'user')) {
       console.log(`${TAG} ${plugin} is already installed.`)
@@ -161,7 +227,7 @@ function main() {
     }
   }
   if (failed) {
-    printManualSteps()
+    printManualSteps(plugins)
     return 1
   }
 
@@ -170,4 +236,4 @@ function main() {
   return 0
 }
 
-process.exit(main())
+process.exit(await main())