@benbenwu/zcf 3.6.4 → 3.6.6

package/README.md

@@ -82,6 +82,37 @@ node bin/zcf.mjs i -s -T codex
 
 Bare `npx @benbenwu/zcf` resolves the published npm package, so it will not automatically use your local repository changes.
 
+## 📦 Release to npm
+
+If you want `npx @benbenwu/zcf` to pick up your local changes, you must publish a new npm version. Republishing the same version is not allowed.
+
+Recommended release flow for this repository:
+
+```bash
+# 1. Create a changeset and choose version bump type
+pnpm changeset
+
+# 2. Apply the version bump
+pnpm changeset version
+
+# 3. Run validation
+pnpm lint
+pnpm typecheck
+pnpm test:run
+pnpm build
+
+# 4. Login to npm if needed
+npm login
+
+# 5. Publish using the repo release script
+pnpm release
+```
+
+Notes:
+
+- `package.json` already sets `"publishConfig": { "access": "public" }`, so `pnpm release` / `changeset publish` will publish as a public package.
+- `pnpm publish --access public` can still be used as a manual fallback after you run `pnpm changeset version` and `pnpm build`, but it is not the primary workflow in this repo.
+
 More usage, options, and workflows: see documentation.
 
 ## 📖 Full Documentation

package/dist/chunks/simple-config.mjs

@@ -18,8 +18,8 @@ import { rm, mkdir, copyFile as copyFile$1 } from 'node:fs/promises';
 import i18next from 'i18next';
 import Backend from 'i18next-fs-backend';
 
-const version = "3.6.4";
-const homepage = "https://github.com/UfoMiao/zcf";
+const version = "3.6.6";
+const homepage = "https://github.com/benbenlijie/zcf";
 
 const i18n = i18next.createInstance();
 const NAMESPACES = [
@@ -208,8 +208,8 @@ const MCP_SERVICE_CONFIGS = [
     requiresApiKey: false,
     config: {
       type: "stdio",
-      command: "uvx",
-      args: ["--from", "git+https://github.com/oraios/serena", "serena", "start-mcp-server", "--context", "ide-assistant", "--enable-web-dashboard", "false"],
+      command: "serena",
+      args: ["start-mcp-server", "--context", "ide-assistant", "--enable-web-dashboard", "false"],
       env: {}
     }
   }
@@ -3540,6 +3540,79 @@ async function selectMcpServices() {
   return services;
 }
 
+const UV_INSTALL_ARGS = ["tool", "install", "-p", "3.13", "serena-agent@latest", "--prerelease=allow"];
+function getExecutableCandidates(command) {
+  const home = homedir();
+  const extension = getPlatform() === "windows" ? ".exe" : "";
+  return [
+    join(home, ".local", "bin", `${command}${extension}`),
+    join(home, ".cargo", "bin", `${command}${extension}`)
+  ];
+}
+async function resolveExecutablePath(command) {
+  const discoveredPath = await findCommandPath(command);
+  if (discoveredPath) {
+    return discoveredPath;
+  }
+  for (const candidate of getExecutableCandidates(command)) {
+    if (existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  return null;
+}
+async function installUv() {
+  if (getPlatform() === "windows") {
+    await exec("powershell", ["-ExecutionPolicy", "ByPass", "-c", "irm https://astral.sh/uv/install.ps1 | iex"]);
+    return;
+  }
+  await exec("sh", ["-c", "curl -LsSf https://astral.sh/uv/install.sh | env UV_NO_MODIFY_PATH=1 sh"]);
+}
+async function ensureUvPath() {
+  const existingPath = await resolveExecutablePath("uv");
+  if (existingPath) {
+    return existingPath;
+  }
+  await installUv();
+  const installedPath = await resolveExecutablePath("uv");
+  if (!installedPath) {
+    throw new Error("uv installation completed but the uv executable was not found");
+  }
+  return installedPath;
+}
+async function installSerenaAgent(uvPath) {
+  await exec(uvPath, UV_INSTALL_ARGS);
+}
+async function initializeSerena(serenaPath) {
+  const serenaConfigFile = join(homedir(), ".serena", "serena_config.yml");
+  if (existsSync(serenaConfigFile)) {
+    return;
+  }
+  await exec(serenaPath, ["init"]);
+}
+async function ensureSerenaForCodex() {
+  let serenaPath = await resolveExecutablePath("serena");
+  if (!serenaPath) {
+    const uvPath = await ensureUvPath();
+    await installSerenaAgent(uvPath);
+    serenaPath = await resolveExecutablePath("serena");
+  }
+  if (!serenaPath) {
+    throw new Error("Serena installation completed but the serena executable was not found");
+  }
+  await initializeSerena(serenaPath);
+  return serenaPath;
+}
+async function resolveCodexMcpCommandOverrides(serviceIds) {
+  const normalizedIds = serviceIds.map((id) => id.toLowerCase());
+  if (!normalizedIds.includes("serena")) {
+    return {};
+  }
+  return {
+    serena: await ensureSerenaForCodex()
+  };
+}
+
 function applyCodexPlatformCommand(config) {
   if (isWindows() && config.command) {
     const mcpCmd = getMcpCommand(config.command);
@@ -3691,6 +3764,27 @@ const codexTomlUpdater = {
   upsertCodexProvider: upsertCodexProvider
 };
 
+function buildSerenaArgs() {
+  return ["start-mcp-server", "--context=codex", "--project-from-cwd", "--enable-web-dashboard", "false"];
+}
+function applyCodexSpecificMcpOverrides(id, command, args, env) {
+  const nextCommand = command;
+  let nextArgs = args;
+  let startupTimeoutSec = 30;
+  if (id === "serena") {
+    nextArgs = buildSerenaArgs();
+  }
+  if (id === "spec-workflow") {
+    env.SPEC_WORKFLOW_HOME = join(homedir(), ".codex", "memories", "spec-workflow");
+    startupTimeoutSec = 90;
+  }
+  return {
+    command: nextCommand,
+    args: nextArgs,
+    env,
+    startupTimeoutSec
+  };
+}
 async function configureCodexMcp(options) {
   ensureI18nInitialized();
   const { skipPrompt = false } = options ?? {};
@@ -3707,37 +3801,34 @@ async function configureCodexMcp(options) {
       return;
     }
     const defaultServiceIds = Array.isArray(options?.mcpServices) ? options.mcpServices : MCP_SERVICE_CONFIGS.filter((service) => !service.requiresApiKey).map((service) => service.id);
+    const commandOverrides2 = await resolveCodexMcpCommandOverrides(defaultServiceIds);
     const existingServices2 = existingConfig?.mcpServices || [];
     const selection2 = [];
     for (const id of defaultServiceIds) {
       const configInfo = MCP_SERVICE_CONFIGS.find((service) => service.id === id);
       if (!configInfo)
         continue;
-      let command = configInfo.config.command || id;
+      let command = commandOverrides2[id.toLowerCase()] || configInfo.config.command || id;
       let args = (configInfo.config.args || []).map((arg) => String(arg));
-      if (id === "serena") {
-        const idx = args.indexOf("--context");
-        if (idx >= 0 && idx + 1 < args.length)
-          args[idx + 1] = "codex";
-        else
-          args.push("--context", "codex");
-      }
+      const env = { ...configInfo.config.env || {} };
+      const serviceConfigOverride = applyCodexSpecificMcpOverrides(id, command, args, env);
+      command = serviceConfigOverride.command;
+      args = serviceConfigOverride.args;
       const serviceConfig = { id: id.toLowerCase(), command, args };
       applyCodexPlatformCommand(serviceConfig);
       command = serviceConfig.command;
       args = serviceConfig.args || [];
-      const env = { ...configInfo.config.env || {} };
       if (isWindows()) {
         const systemRoot = getSystemRoot();
         if (systemRoot)
-          env.SYSTEMROOT = systemRoot;
+          serviceConfigOverride.env.SYSTEMROOT = systemRoot;
       }
       selection2.push({
         id: id.toLowerCase(),
         command,
         args,
-        env: Object.keys(env).length > 0 ? env : void 0,
-        startup_timeout_sec: 30
+        env: Object.keys(serviceConfigOverride.env).length > 0 ? serviceConfigOverride.env : void 0,
+        startup_timeout_sec: serviceConfigOverride.startupTimeoutSec
       });
     }
     const mergedMap2 = /* @__PURE__ */ new Map();
@@ -3769,6 +3860,7 @@ async function configureCodexMcp(options) {
   if (!selectedIds)
     return;
   const servicesMeta = await getMcpServices();
+  const commandOverrides = await resolveCodexMcpCommandOverrides(selectedIds);
   const selection = [];
   const existingServices = existingConfig?.mcpServices || [];
   if (selectedIds.length === 0) {
@@ -3797,25 +3889,20 @@ async function configureCodexMcp(options) {
     if (!configInfo)
       continue;
     const serviceMeta = servicesMeta.find((service) => service.id === id);
-    let command = configInfo.config.command || id;
+    let command = commandOverrides[id.toLowerCase()] || configInfo.config.command || id;
     let args = (configInfo.config.args || []).map((arg) => String(arg));
-    if (id === "serena") {
-      const idx = args.indexOf("--context");
-      if (idx >= 0 && idx + 1 < args.length) {
-        args[idx + 1] = "codex";
-      } else {
-        args.push("--context", "codex");
-      }
-    }
+    const env = { ...configInfo.config.env || {} };
+    const serviceConfigOverride = applyCodexSpecificMcpOverrides(id, command, args, env);
+    command = serviceConfigOverride.command;
+    args = serviceConfigOverride.args;
     const serviceConfig = { id: id.toLowerCase(), command, args };
     applyCodexPlatformCommand(serviceConfig);
     command = serviceConfig.command;
     args = serviceConfig.args || [];
-    const env = { ...configInfo.config.env || {} };
     if (isWindows()) {
       const systemRoot = getSystemRoot();
       if (systemRoot)
-        env.SYSTEMROOT = systemRoot;
+        serviceConfigOverride.env.SYSTEMROOT = systemRoot;
     }
     if (configInfo.requiresApiKey && configInfo.apiKeyEnvVar) {
       const promptMessage = serviceMeta?.apiKeyPrompt || i18n.t("mcp:apiKeyPrompt");
@@ -3827,14 +3914,14 @@ async function configureCodexMcp(options) {
       }]);
       if (!apiKey)
         continue;
-      env[configInfo.apiKeyEnvVar] = apiKey;
+      serviceConfigOverride.env[configInfo.apiKeyEnvVar] = apiKey;
     }
     selection.push({
       id: id.toLowerCase(),
       command: serviceConfig.command,
       args: serviceConfig.args,
-      env: Object.keys(env).length > 0 ? env : void 0,
-      startup_timeout_sec: 30
+      env: Object.keys(serviceConfigOverride.env).length > 0 ? serviceConfigOverride.env : void 0,
+      startup_timeout_sec: serviceConfigOverride.startupTimeoutSec
     });
   }
   const mergedMap = /* @__PURE__ */ new Map();

package/package.json

@@ -1,24 +1,23 @@
 {
   "name": "@benbenwu/zcf",
   "type": "module",
-  "version": "3.6.4",
-  "packageManager": "pnpm@10.17.1",
+  "version": "3.6.6",
   "description": "Zero-Config Code Flow - One-click configuration tool for Code Cli",
   "author": {
-    "name": "Miao Da",
-    "email": "ufo025174@gmail.com",
-    "url": "https://github.com/WitMiao"
+    "name": "Wu Yubin",
+    "email": "benbenwyb@gmail.com",
+    "url": "https://github.com/benbenlijie"
   },
   "license": "MIT",
   "publishConfig": {
     "access": "public"
   },
-  "homepage": "https://github.com/UfoMiao/zcf",
+  "homepage": "https://github.com/benbenlijie/zcf",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/UfoMiao/zcf.git"
+    "url": "git+https://github.com/benbenlijie/zcf.git"
   },
-  "bugs": "https://github.com/UfoMiao/zcf/issues",
+  "bugs": "https://github.com/benbenlijie/zcf/issues",
   "keywords": [
     "claude",
     "claude-code",
@@ -46,12 +45,55 @@
     "dist",
     "templates"
   ],
+  "dependencies": {
+    "@rainbowatcher/toml-edit-js": "^0.6.4",
+    "@types/semver": "^7.7.1",
+    "ansis": "^4.1.0",
+    "cac": "^6.7.14",
+    "dayjs": "^1.11.18",
+    "find-up-simple": "^1.0.1",
+    "fs-extra": "^11.3.2",
+    "i18next": "^25.5.2",
+    "i18next-fs-backend": "^2.6.0",
+    "inquirer": "^12.9.6",
+    "inquirer-toggle": "^1.0.1",
+    "ora": "^9.0.0",
+    "pathe": "^2.0.3",
+    "semver": "^7.7.2",
+    "tinyexec": "^1.0.1",
+    "trash": "^10.0.0"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "^5.4.1",
+    "@changesets/cli": "^2.30.0",
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@commitlint/types": "^19.8.1",
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^22.18.6",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
+    "eslint": "^9.36.0",
+    "eslint-plugin-format": "^1.0.2",
+    "glob": "^11.0.3",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.0",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2",
+    "unbuild": "^3.6.1",
+    "vitest": "^3.2.4"
+  },
+  "lint-staged": {
+    "*": [
+      "pnpm lint"
+    ]
+  },
   "scripts": {
     "dev": "tsx ./src/cli.ts",
     "build": "unbuild",
     "start": "node bin/zcf.mjs",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "pnpm build",
     "lint": "eslint",
     "lint:fix": "eslint --fix",
     "test": "vitest",
@@ -63,55 +105,10 @@
     "version": "changeset version",
     "update:deps": "pnpx taze major -r -w",
     "release": "pnpm build && changeset publish",
-    "prepare": "husky",
     "commitlint": "commitlint",
     "commitlint:check": "commitlint --from HEAD~1 --to HEAD --verbose",
     "docs:dev": "pnpm -F @zcf/docs dev",
     "docs:build": "pnpm -F @zcf/docs build",
     "docs:preview": "pnpm -F @zcf/docs preview"
-  },
-  "dependencies": {
-    "@rainbowatcher/toml-edit-js": "catalog:runtime",
-    "@types/semver": "catalog:types",
-    "ansis": "catalog:cli",
-    "cac": "catalog:cli",
-    "dayjs": "catalog:runtime",
-    "find-up-simple": "catalog:runtime",
-    "fs-extra": "catalog:runtime",
-    "i18next": "catalog:runtime",
-    "i18next-fs-backend": "catalog:runtime",
-    "inquirer": "catalog:cli",
-    "inquirer-toggle": "catalog:cli",
-    "ora": "catalog:cli",
-    "pathe": "catalog:runtime",
-    "semver": "catalog:runtime",
-    "tinyexec": "catalog:runtime",
-    "trash": "catalog:runtime"
-  },
-  "devDependencies": {
-    "@antfu/eslint-config": "catalog:build",
-    "@changesets/cli": "catalog:tooling",
-    "@commitlint/cli": "catalog:tooling",
-    "@commitlint/config-conventional": "catalog:tooling",
-    "@commitlint/types": "catalog:tooling",
-    "@types/fs-extra": "catalog:types",
-    "@types/inquirer": "catalog:types",
-    "@types/node": "catalog:types",
-    "@vitest/coverage-v8": "catalog:testing",
-    "@vitest/ui": "catalog:testing",
-    "eslint": "catalog:build",
-    "eslint-plugin-format": "catalog:build",
-    "glob": "catalog:testing",
-    "husky": "catalog:tooling",
-    "lint-staged": "catalog:tooling",
-    "tsx": "catalog:build",
-    "typescript": "catalog:build",
-    "unbuild": "catalog:build",
-    "vitest": "catalog:testing"
-  },
-  "lint-staged": {
-    "*": [
-      "pnpm lint"
-    ]
   }
-}
+}