@qazuor/claude-code-config 0.3.0 → 0.4.0

package/README.md

@@ -45,7 +45,8 @@ A comprehensive CLI tool to install and manage Claude Code configurations in you
 
 ### Core Capabilities
 
-- **Interactive Wizard**: Step-by-step configuration with intelligent defaults
+- **Interactive Wizard**: Step-by-step configuration with intelligent defaults and **back navigation**
+- **Back Navigation**: Return to previous steps at any time to modify your choices
 - **Auto-Detection**: Automatically detects project type, package manager, and tech stack
 - **23 Bundles**: Pre-grouped module sets organized by category (stacks, testing, quality, etc.)
 - **Bundle Categories**: Stack bundles (React+TanStack, Astro, Next.js), API bundles (Hono, Express), testing, quality, and more
@@ -169,6 +170,8 @@ The wizard will guide you through:
 8. **Code Style** - EditorConfig, Biome, Prettier, Commitlint
 9. **Template Configuration** - Auto-detected command/path/target values
 
+> **Tip**: You can go back to any previous step using the "← Back" option to modify your choices.
+
 ### Bundle-based Setup
 
 ```bash

package/dist/bin.cjs

@@ -30,10 +30,10 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// node_modules/.pnpm/tsup@8.5.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js
+// node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js
 var getImportMetaUrl, importMetaUrl;
 var init_cjs_shims = __esm({
-  "node_modules/.pnpm/tsup@8.5.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js"() {
+  "node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js"() {
     "use strict";
     getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
     importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
@@ -226,6 +226,7 @@ var init_fs = __esm({
 
 // src/bin.ts
 init_cjs_shims();
+var import_node_module = require("module");
 
 // src/cli/index.ts
 init_cjs_shims();
@@ -4823,9 +4824,9 @@ async function readPackageJson(projectPath) {
     return null;
   }
 }
-async function writePackageJson(projectPath, packageJson) {
+async function writePackageJson(projectPath, packageJson2) {
   const packageJsonPath = joinPath(projectPath, "package.json");
-  const content = `${JSON.stringify(packageJson, null, 2)}
+  const content = `${JSON.stringify(packageJson2, null, 2)}
 `;
   await writeFile(packageJsonPath, content);
 }
@@ -4905,13 +4906,13 @@ async function updatePackageJson(projectPath, changes, options = {}) {
     skippedDevDependencies: []
   };
   try {
-    let packageJson = await readPackageJson(projectPath);
-    if (!packageJson) {
+    let packageJson2 = await readPackageJson(projectPath);
+    if (!packageJson2) {
       if (!createIfMissing) {
         result.error = "package.json not found and createIfMissing is false";
         return result;
       }
-      packageJson = createMinimalPackageJson({
+      packageJson2 = createMinimalPackageJson({
         name: changes.metadata?.name,
         description: changes.metadata?.description,
         author: typeof changes.metadata?.author === "string" ? changes.metadata.author : void 0,
@@ -4921,46 +4922,46 @@ async function updatePackageJson(projectPath, changes, options = {}) {
     }
     if (backup2 && !dryRun && !result.created) {
       const backupPath = joinPath(projectPath, "package.json.backup");
-      await writeFile(backupPath, JSON.stringify(packageJson, null, 2));
+      await writeFile(backupPath, JSON.stringify(packageJson2, null, 2));
     }
     if (changes.metadata) {
-      if (changes.metadata.name && !packageJson.name) {
-        packageJson.name = changes.metadata.name;
+      if (changes.metadata.name && !packageJson2.name) {
+        packageJson2.name = changes.metadata.name;
         result.modified = true;
       }
-      if (changes.metadata.description && !packageJson.description) {
-        packageJson.description = changes.metadata.description;
+      if (changes.metadata.description && !packageJson2.description) {
+        packageJson2.description = changes.metadata.description;
         result.modified = true;
       }
-      if (changes.metadata.author && !packageJson.author) {
-        packageJson.author = changes.metadata.author;
+      if (changes.metadata.author && !packageJson2.author) {
+        packageJson2.author = changes.metadata.author;
         result.modified = true;
       }
-      if (changes.metadata.license && !packageJson.license) {
-        packageJson.license = changes.metadata.license;
+      if (changes.metadata.license && !packageJson2.license) {
+        packageJson2.license = changes.metadata.license;
         result.modified = true;
       }
-      if (changes.metadata.repository && !packageJson.repository) {
-        packageJson.repository = changes.metadata.repository;
+      if (changes.metadata.repository && !packageJson2.repository) {
+        packageJson2.repository = changes.metadata.repository;
         result.modified = true;
       }
-      if (changes.metadata.type && !packageJson.type) {
-        packageJson.type = changes.metadata.type;
+      if (changes.metadata.type && !packageJson2.type) {
+        packageJson2.type = changes.metadata.type;
         result.modified = true;
       }
-      if (changes.metadata.engines && !packageJson.engines) {
-        packageJson.engines = changes.metadata.engines;
+      if (changes.metadata.engines && !packageJson2.engines) {
+        packageJson2.engines = changes.metadata.engines;
         result.modified = true;
       }
-      if (changes.metadata.packageManager && !packageJson.packageManager) {
-        packageJson.packageManager = changes.metadata.packageManager;
+      if (changes.metadata.packageManager && !packageJson2.packageManager) {
+        packageJson2.packageManager = changes.metadata.packageManager;
         result.modified = true;
       }
     }
     if (changes.scripts) {
-      packageJson.scripts = packageJson.scripts || {};
+      packageJson2.scripts = packageJson2.scripts || {};
       for (const [name, command] of Object.entries(changes.scripts)) {
-        const exists = name in packageJson.scripts;
+        const exists = name in packageJson2.scripts;
         if (exists) {
           if (scriptsMerge === "skip-existing") {
             result.skippedScripts.push(name);
@@ -4971,15 +4972,15 @@ async function updatePackageJson(projectPath, changes, options = {}) {
             continue;
           }
         }
-        packageJson.scripts[name] = command;
+        packageJson2.scripts[name] = command;
         result.addedScripts.push(name);
         result.modified = true;
       }
     }
     if (changes.dependencies) {
-      packageJson.dependencies = packageJson.dependencies || {};
+      packageJson2.dependencies = packageJson2.dependencies || {};
       for (const [name, version] of Object.entries(changes.dependencies)) {
-        const exists = name in packageJson.dependencies;
+        const exists = name in packageJson2.dependencies;
         if (exists) {
           if (dependenciesMerge === "skip-existing") {
             result.skippedDependencies.push(name);
@@ -4990,15 +4991,15 @@ async function updatePackageJson(projectPath, changes, options = {}) {
             continue;
           }
         }
-        packageJson.dependencies[name] = version;
+        packageJson2.dependencies[name] = version;
         result.addedDependencies.push(name);
         result.modified = true;
       }
     }
     if (changes.devDependencies) {
-      packageJson.devDependencies = packageJson.devDependencies || {};
+      packageJson2.devDependencies = packageJson2.devDependencies || {};
       for (const [name, version] of Object.entries(changes.devDependencies)) {
-        const exists = name in packageJson.devDependencies;
+        const exists = name in packageJson2.devDependencies;
         if (exists) {
           if (dependenciesMerge === "skip-existing") {
             result.skippedDevDependencies.push(name);
@@ -5009,13 +5010,13 @@ async function updatePackageJson(projectPath, changes, options = {}) {
             continue;
           }
         }
-        packageJson.devDependencies[name] = version;
+        packageJson2.devDependencies[name] = version;
         result.addedDevDependencies.push(name);
         result.modified = true;
       }
     }
     if (!dryRun && (result.created || result.modified)) {
-      await writePackageJson(projectPath, packageJson);
+      await writePackageJson(projectPath, packageJson2);
     }
     result.success = true;
     return result;
@@ -5959,7 +5960,7 @@ async function detectProject(projectPath) {
     };
   }
   signals.push({ file: "package.json", exists: true, indicates: "Node.js project" });
-  const packageJson = await readJson(packageJsonPath).catch(() => ({}));
+  const packageJson2 = await readJson(packageJsonPath).catch(() => ({}));
   const packageManager = await detectPackageManager(projectPath);
   if (packageManager) {
     signals.push({
@@ -5968,11 +5969,11 @@ async function detectProject(projectPath) {
       indicates: `${packageManager} package manager`
     });
   }
-  const typeResult = await detectProjectType(projectPath, packageJson);
+  const typeResult = await detectProjectType(projectPath, packageJson2);
   const projectType = typeResult.type;
   signals.push(...typeResult.signals);
   const confidence = projectType && packageManager ? "high" : projectType || packageManager ? "medium" : "low";
-  const suggestedBundles = suggestBundles(projectType, packageJson);
+  const suggestedBundles = suggestBundles(projectType, packageJson2);
   return {
     detected: true,
     projectType,
@@ -5996,10 +5997,10 @@ async function detectPackageManager(projectPath) {
   }
   return void 0;
 }
-async function detectProjectType(projectPath, packageJson) {
+async function detectProjectType(projectPath, packageJson2) {
   const signals = [];
-  const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
-  if (await pathExists(joinPath(projectPath, "turbo.json")) || await pathExists(joinPath(projectPath, "pnpm-workspace.yaml")) || packageJson.workspaces) {
+  const deps = { ...packageJson2.dependencies, ...packageJson2.devDependencies };
+  if (await pathExists(joinPath(projectPath, "turbo.json")) || await pathExists(joinPath(projectPath, "pnpm-workspace.yaml")) || packageJson2.workspaces) {
     signals.push({ file: "turbo.json/pnpm-workspace.yaml", exists: true, indicates: "monorepo" });
     return { type: "monorepo", signals };
   }
@@ -6026,8 +6027,8 @@ async function detectProjectType(projectPath, packageJson) {
   }
   return { type: "node", signals };
 }
-function suggestBundles(projectType, packageJson) {
-  const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
+function suggestBundles(projectType, packageJson2) {
+  const deps = { ...packageJson2.dependencies, ...packageJson2.devDependencies };
   const suggestedBundles = [];
   const hasHono = deps.hono || deps["@hono/node-server"];
   const hasExpress = deps.express;
@@ -6110,8 +6111,8 @@ function suggestBundles(projectType, packageJson) {
 }
 async function getProjectName(projectPath) {
   try {
-    const packageJson = await readJson(joinPath(projectPath, "package.json"));
-    return packageJson.name;
+    const packageJson2 = await readJson(joinPath(projectPath, "package.json"));
+    return packageJson2.name;
   } catch {
     const parts = projectPath.split("/");
     return parts[parts.length - 1];
@@ -6119,8 +6120,8 @@ async function getProjectName(projectPath) {
 }
 async function getProjectDescription(projectPath) {
   try {
-    const packageJson = await readJson(joinPath(projectPath, "package.json"));
-    return packageJson.description;
+    const packageJson2 = await readJson(joinPath(projectPath, "package.json"));
+    return packageJson2.description;
   } catch {
     return void 0;
   }
@@ -9694,6 +9695,10 @@ async function promptMcpConfig(options) {
       skippedConfigs: []
     };
   }
+  const projectPath = options?.projectPath || process.cwd();
+  const installedServers = await getInstalledMcpServers(projectPath);
+  const userInstalledSet = new Set(installedServers.user);
+  const projectInstalledSet = new Set(installedServers.project);
   const level = await select({
     message: "Where should MCP servers be configured?",
     choices: [
@@ -9714,13 +9719,44 @@ async function promptMcpConfig(options) {
   const selectedServerIds = [];
   logger.newline();
   logger.info("Select MCP servers to install:");
+  const totalInstalled = userInstalledSet.size + projectInstalledSet.size;
+  if (totalInstalled > 0) {
+    const parts = [];
+    if (userInstalledSet.size > 0) {
+      parts.push(`${userInstalledSet.size} at user level`);
+    }
+    if (projectInstalledSet.size > 0) {
+      parts.push(`${projectInstalledSet.size} at project level`);
+    }
+    logger.info(colors.muted(`  (${parts.join(", ")} already installed)`));
+  }
   logger.newline();
   for (const [category, servers] of Object.entries(serversByCategory)) {
-    const choices = servers.map((s) => ({
-      name: `${s.name} - ${s.description}`,
-      value: s.id,
-      checked: options?.defaults?.servers?.some((i) => i.serverId === s.id) ?? false
-    }));
+    const choices = servers.map((s) => {
+      const isInstalledAtUserLevel = userInstalledSet.has(s.id);
+      const isInstalledAtProjectLevel = projectInstalledSet.has(s.id);
+      if (isInstalledAtUserLevel) {
+        return {
+          name: `${s.name} - ${s.description} ${colors.muted("(already installed at user level)")}`,
+          value: s.id,
+          checked: false,
+          disabled: "already installed at user level"
+        };
+      }
+      if (isInstalledAtProjectLevel) {
+        return {
+          name: `${s.name} - ${s.description} ${colors.muted("(already installed at project level)")}`,
+          value: s.id,
+          checked: false,
+          disabled: "already installed at project level"
+        };
+      }
+      return {
+        name: `${s.name} - ${s.description}`,
+        value: s.id,
+        checked: options?.defaults?.servers?.some((i) => i.serverId === s.id) ?? false
+      };
+    });
     const categoryLabel = formatCategory(category);
     const selected = await checkbox({
       message: `${categoryLabel}:`,
@@ -10127,7 +10163,7 @@ async function promptBashPermissions(defaults) {
 async function promptWebPermissions(defaults) {
   logger.newline();
   logger.info(colors.bold("\u{1F310} Web Operations"));
-  const fetch = await confirm({
+  const fetch2 = await confirm({
     message: "Allow WebFetch (fetch web pages)?",
     default: defaults?.fetch ?? true
   });
@@ -10136,7 +10172,7 @@ async function promptWebPermissions(defaults) {
     default: defaults?.search ?? true
   });
   return {
-    fetch,
+    fetch: fetch2,
     search
   };
 }
@@ -11218,7 +11254,7 @@ function createMcpConfigStep() {
       required: false
     },
     computeDefaults: (ctx) => ctx.mcpConfig,
-    execute: async (_ctx, defaults) => {
+    execute: async (ctx, defaults) => {
       const goBack = await promptBackOption(5, "Configure MCP servers or go back?");
       if (goBack) {
         return createResult(
@@ -11226,7 +11262,7 @@ function createMcpConfigStep() {
           "back"
         );
       }
-      const result = await promptMcpConfig();
+      const result = await promptMcpConfig({ projectPath: ctx.projectPath });
       return createResult(result, "next");
     }
   };
@@ -12935,7 +12971,8 @@ async function handleConfigUpdates(projectPath, config, _options) {
   }
   if (reconfigureOptions.includes("mcp")) {
     const mcpResult = await promptMcpConfig({
-      defaults: config.mcp
+      defaults: config.mcp,
+      projectPath
     });
     config.mcp = mcpResult.config;
     await installMcpServers(projectPath, mcpResult.config);
@@ -13276,7 +13313,7 @@ program.addCommand(createConfigureCommand());
 init_cjs_shims();
 var import_chalk3 = __toESM(require("chalk"), 1);
 var import_figlet = __toESM(require("figlet"), 1);
-function showBanner() {
+function showBanner(version) {
   const bannerText = import_figlet.default.textSync("Qazuor", {
     font: "Standard",
     horizontalLayout: "default",
@@ -13302,18 +13339,105 @@ function showBanner() {
     return colors2[colorIndex](line);
   }).join("\n");
   console.log(coloredBanner);
-  console.log(import_chalk3.default.gray("  Claude Code Configuration & Project Setup"));
+  const versionText = version ? import_chalk3.default.cyan(` v${version}`) : "";
+  console.log(import_chalk3.default.gray("  Claude Code Configuration & Project Setup") + versionText);
   console.log(import_chalk3.default.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
   console.log();
 }
 
+// src/lib/utils/version-check.ts
+init_cjs_shims();
+var import_chalk4 = __toESM(require("chalk"), 1);
+var PACKAGE_NAME = "@qazuor/claude-code-config";
+var NPM_REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+var CHECK_TIMEOUT_MS = 3e3;
+function compareVersions(a, b) {
+  const partsA = a.replace(/^v/, "").split(".").map(Number);
+  const partsB = b.replace(/^v/, "").split(".").map(Number);
+  for (let i = 0; i < Math.max(partsA.length, partsB.length); i++) {
+    const numA = partsA[i] || 0;
+    const numB = partsB[i] || 0;
+    if (numA > numB) return 1;
+    if (numA < numB) return -1;
+  }
+  return 0;
+}
+async function fetchLatestVersion() {
+  try {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), CHECK_TIMEOUT_MS);
+    const response = await fetch(NPM_REGISTRY_URL, {
+      signal: controller.signal,
+      headers: {
+        Accept: "application/json"
+      }
+    });
+    clearTimeout(timeoutId);
+    if (!response.ok) {
+      return null;
+    }
+    const data = await response.json();
+    return data.version || null;
+  } catch {
+    return null;
+  }
+}
+async function checkForUpdates(currentVersion) {
+  try {
+    const latestVersion = await fetchLatestVersion();
+    if (!latestVersion) {
+      return;
+    }
+    if (compareVersions(latestVersion, currentVersion) > 0) {
+      displayUpdateNotification(currentVersion, latestVersion);
+    }
+  } catch {
+  }
+}
+function displayUpdateNotification(currentVersion, latestVersion) {
+  const boxWidth = 50;
+  const border = import_chalk4.default.yellow("\u2502");
+  const topBorder = import_chalk4.default.yellow(`\u256D${"\u2500".repeat(boxWidth)}\u256E`);
+  const bottomBorder = import_chalk4.default.yellow(`\u2570${"\u2500".repeat(boxWidth)}\u256F`);
+  const padLine = (text, rawLength) => {
+    const padding = boxWidth - rawLength;
+    const leftPad = Math.floor(padding / 2);
+    const rightPad = padding - leftPad;
+    return border + " ".repeat(leftPad) + text + " ".repeat(rightPad) + border;
+  };
+  const emptyLine = border + " ".repeat(boxWidth) + border;
+  const updateText = "Update available!";
+  const versionText = `${import_chalk4.default.gray(currentVersion)} \u2192 ${import_chalk4.default.green(latestVersion)}`;
+  const versionRawLength = currentVersion.length + " \u2192 ".length + latestVersion.length;
+  const commandText = `npm i -g ${PACKAGE_NAME}`;
+  const runText = `Run: ${import_chalk4.default.cyan(commandText)}`;
+  const runRawLength = "Run: ".length + commandText.length;
+  console.log();
+  console.log(topBorder);
+  console.log(emptyLine);
+  console.log(padLine(import_chalk4.default.yellow.bold(updateText), updateText.length));
+  console.log(padLine(versionText, versionRawLength));
+  console.log(emptyLine);
+  console.log(padLine(runText, runRawLength));
+  console.log(emptyLine);
+  console.log(bottomBorder);
+  console.log();
+}
+function startBackgroundVersionCheck(currentVersion) {
+  return checkForUpdates(currentVersion);
+}
+
 // src/bin.ts
+var require2 = (0, import_node_module.createRequire)(importMetaUrl);
+var packageJson = require2("../package.json");
+var VERSION3 = packageJson.version;
 setupGracefulCancellation();
 var args = process.argv.slice(2);
 var showBannerCommands = ["init", "help", "--help", "-h", ""];
 var shouldShowBanner = args.length === 0 || showBannerCommands.includes(args[0] || "");
 if (shouldShowBanner) {
-  showBanner();
+  showBanner(VERSION3);
+  void startBackgroundVersionCheck(VERSION3);
 }
 program.parse(process.argv);
 //# sourceMappingURL=bin.cjs.map