@scorehub/creator-outreach 1.2.0 → 1.2.1

package/.codebuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "tiktok-creator-outreach",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "ScoreHub AI's TikTok creator marketing expert for building clear creator profiles and validating focused collaboration shortlists across Southeast Asia.",
   "author": {
     "name": "Ben",

package/README.en.md

@@ -23,7 +23,7 @@ For the public release, end users only need to:
 
 Tiky uses `npx -y @scorehub/creator-outreach@latest` to run a bootstrap check before every new conversation. When the machine is uninitialized, Tiky explains that the ScoreHub local component is required and waits for explicit confirmation. It then prefetches and self-checks `@scorehub/mcp-server@latest` before updating Tiky's files and the WorkBuddy `scorehub` MCP configuration. WorkBuddy must be fully restarted after the initial installation.
 
-That first confirmation also authorizes future silent creator-outreach updates, so Tiky does not ask again for every release. The MCP command always remains `npx -y @scorehub/mcp-server@latest`; it is never pinned to a specific version.
+That first confirmation also authorizes future silent creator-outreach updates, so Tiky does not ask again for every release. The MCP launcher always resolves `@scorehub/mcp-server@latest`; it is never pinned to a specific version.
 
 The share link only installs Tiky into WorkBuddy. In the normal public path, users do not need to install `@scorehub/mcp-server` manually or edit `mcp.json` themselves.
 
@@ -41,7 +41,7 @@ The installer configures WorkBuddy only. If it does not find WorkBuddy, it exits
 |---|---|---|---|
 | WorkBuddy | `~/.workbuddy/` exists | Plugin files in `~/.workbuddy/plugins/.../`; MCP configuration merged into `~/.workbuddy/mcp.json` | Restart, then select “ScoreHub AI TikTok Creator Marketing Expert” from the Agent list |
 
-Before writing the configuration, Tiky verifies the MCP server with `--self-check --json`. WorkBuddy then starts it through `npx -y @scorehub/mcp-server@latest`. If WorkBuddy provides a working bundled Node.js / npx, Tiky reuses it. Tiky only guides users to the official Node.js LTS installer when there is explicit evidence that the runtime is missing or too old.
+Before writing the configuration, Tiky verifies the MCP server with `--self-check --json`, then WorkBuddy starts it automatically. macOS and Linux use `npx -y @scorehub/mcp-server@latest`. Windows reuses WorkBuddy's managed `node.exe` to load the matching npm `npx-cli.js` directly, avoiding `.cmd` / `.bat` process-launch compatibility problems. Tiky only guides users to the official Node.js LTS installer when the managed runtime is explicitly missing or too old.
 
 ## First Use and Authorization
 

package/README.md

@@ -23,7 +23,7 @@ English version: [README.en.md](./README.en.md)
 
 Tiky 每个新会话都会通过 `npx -y @scorehub/creator-outreach@latest` 执行 bootstrap 检查。未初始化时，她会说明需要安装 ScoreHub 本地组件，并等待你明确确认；确认后预拉取并自检 `@scorehub/mcp-server@latest`，再更新 Tiky 本地文件和 WorkBuddy 的 `scorehub` MCP 配置。安装完成后需要完全重启 WorkBuddy。
 
-首次确认同时授权后续静默更新 creator-outreach，不会对每个新版本重复询问。MCP 配置始终使用 `npx -y @scorehub/mcp-server@latest`，不固定具体版本。
+首次确认同时授权后续静默更新 creator-outreach，不会对每个新版本重复询问。MCP 始终运行 `@scorehub/mcp-server@latest`，不固定具体版本。
 
 分享链接只负责把 Tiky 放进 WorkBuddy。默认情况下，你不需要手工安装 `@scorehub/mcp-server`，也不需要自己编辑 `mcp.json`。
 
@@ -41,7 +41,7 @@ npx -y @scorehub/creator-outreach
 |---|---|---|---|
 | WorkBuddy | `~/.workbuddy/` 存在 | 插件文件写入 `~/.workbuddy/plugins/.../`；MCP 配置合并到 `~/.workbuddy/mcp.json` | 重启后在 Agent 列表选择“ScoreHub AI TikTok达人营销专家” |
 
-MCP Server（`@scorehub/mcp-server`）在写入配置前会先通过 `--self-check --json` 验证可执行性，之后由 `npx -y @scorehub/mcp-server@latest` 在 WorkBuddy 启动时自动拉起。WorkBuddy 若已自带可用 Node.js / npx，会优先复用；只有在存在明确缺失证据时，Tiky 才会引导你安装官方 Node.js LTS。
+MCP Server（`@scorehub/mcp-server`）在写入配置前会先通过 `--self-check --json` 验证可执行性，之后由 WorkBuddy 自动拉起。macOS / Linux 使用 `npx -y @scorehub/mcp-server@latest`；Windows 复用 WorkBuddy 托管的 `node.exe` 直接加载同版本 npm 的 `npx-cli.js`，避免 `.cmd` / `.bat` 的进程启动兼容问题。只有在托管运行时明确缺失或版本过低时，Tiky 才会引导你安装官方 Node.js LTS。
 
 ## 首次使用与授权
 

package/install.js

@@ -48,23 +48,33 @@ function getPaths(homeDir) {
   };
 }
 
-function resolveWorkBuddyNode(workBuddyDir) {
+function resolveWorkBuddyLauncher(workBuddyDir, platform = process.platform) {
   const versionsDir = path.join(workBuddyDir, 'binaries', 'node', 'versions');
-  const npxExecutable = process.platform === 'win32' ? 'npx.cmd' : 'npx';
   try {
-    const versions = fs.readdirSync(versionsDir).sort().reverse();
+    const versions = fs.readdirSync(versionsDir)
+      .sort((left, right) => right.localeCompare(left, undefined, { numeric: true }));
     for (const version of versions) {
       const versionDir = path.join(versionsDir, version);
+      if (platform === 'win32') {
+        const command = path.join(versionDir, 'node.exe');
+        const npxCli = path.join(versionDir, 'node_modules', 'npm', 'bin', 'npx-cli.js');
+        if (fs.existsSync(command) && fs.existsSync(npxCli)) {
+          return { command, argsPrefix: [npxCli], binDir: versionDir };
+        }
+        continue;
+      }
+
       const binDirs = [path.join(versionDir, 'bin'), versionDir];
       for (const binDir of binDirs) {
-        const npxPath = path.join(binDir, npxExecutable);
-        if (fs.existsSync(npxPath)) return { npx: npxPath, binDir };
+        const command = path.join(binDir, 'npx');
+        if (fs.existsSync(command)) return { command, argsPrefix: [], binDir };
       }
     }
   } catch {
     // WorkBuddy or its bundled Node.js is not available at this path.
   }
-  return { npx: 'npx', binDir: null };
+  if (platform === 'win32') return null;
+  return { command: 'npx', argsPrefix: [], binDir: null };
 }
 
 function readJson(filePath) {
@@ -144,11 +154,11 @@ function buildMcpEnvironment(version, binDir) {
   });
 }
 
-function buildMcpConfig(version, npx, binDir) {
+function buildMcpConfig(version, launcher) {
   return {
-    command: npx,
-    args: MCP_CONFIG.args.slice(),
-    env: buildMcpEnvironment(version, binDir),
+    command: launcher.command,
+    args: launcher.argsPrefix.concat(MCP_CONFIG.args),
+    env: buildMcpEnvironment(version, launcher.binDir),
   };
 }
 
@@ -172,6 +182,17 @@ function isManagedMcpConfig(config) {
     && server.env.SCOREHUB_CLIENT_HOST === 'workbuddy';
 }
 
+function needsMcpLauncherMigration(config, platform = process.platform, expectedLauncher) {
+  if (platform !== 'win32' || !isManagedMcpConfig(config)) return false;
+  const server = config.mcpServers.scorehub;
+  const npxCli = server.args.find((arg) => /(?:^|[\\/])npx-cli\.js$/i.test(arg));
+  if (!/(?:^|[\\/])node\.exe$/i.test(server.command || '') || !npxCli) return true;
+  if (expectedLauncher === undefined) return false;
+  if (expectedLauncher === null) return true;
+  return server.command.toLowerCase() !== expectedLauncher.command.toLowerCase()
+    || npxCli.toLowerCase() !== expectedLauncher.argsPrefix[0].toLowerCase();
+}
+
 function mergeMcpConfig(configPath, serverConfig) {
   const current = readMcpConfig(configPath);
   if (current.config === null) throw new Error(current.error);
@@ -228,18 +249,22 @@ function parseSelfCheckOutput(output) {
   throw new Error('mcp-server self-check did not return a valid JSON payload');
 }
 
-function runMcpSelfCheck({ npx, env, selfCheck = defaultMcpSelfCheck } = {}) {
-  return selfCheck({ npx, env });
+function runMcpSelfCheck({ launcher, env, selfCheck = defaultMcpSelfCheck } = {}) {
+  return selfCheck({ launcher, env });
 }
 
-function defaultMcpSelfCheck({ npx, env }) {
+function defaultMcpSelfCheck({ launcher, env, execFile = execFileSync }) {
   try {
-    const output = execFileSync(npx, ['-y', '@scorehub/mcp-server@latest', '--self-check', '--json'], {
-      encoding: 'utf8',
-      env,
-      stdio: ['ignore', 'pipe', 'pipe'],
-      timeout: 30000,
-    });
+    const output = execFile(
+      launcher.command,
+      launcher.argsPrefix.concat(['-y', '@scorehub/mcp-server@latest', '--self-check', '--json']),
+      {
+        encoding: 'utf8',
+        env,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        timeout: 30000,
+      },
+    );
     const payload = parseSelfCheckOutput(output);
     if (!payload.ok) throw new Error(`mcp-server self-check failed for Node.js ${payload.node_version}`);
     return payload;
@@ -268,13 +293,24 @@ function detectStatus({ paths, state, nodeVersion }) {
   return { status: 'ready', reason: null };
 }
 
-function check({ homeDir = os.homedir(), nodeVersion = process.versions.node, now = Date.now() } = {}) {
+function check({
+  homeDir = os.homedir(),
+  nodeVersion = process.versions.node,
+  now = Date.now(),
+  platform = process.platform,
+} = {}) {
   const paths = getPaths(homeDir);
   const state = loadState(paths.bootstrapState);
   const detected = detectStatus({ paths, state, nodeVersion });
   const lastCheckAt = state.last_check_at ? Date.parse(state.last_check_at) : Number.NaN;
+  const mcp = readMcpConfig(paths.workBuddyMcpJson);
+  const expectedLauncher = platform === 'win32'
+    ? resolveWorkBuddyLauncher(paths.workBuddyDir, platform)
+    : undefined;
+  const launcherMigrationDue = mcp.config !== null
+    && needsMcpLauncherMigration(mcp.config, platform, expectedLauncher);
   const updateDue = detected.status === 'ready'
-    && (!Number.isFinite(lastCheckAt) || now - lastCheckAt >= UPDATE_INTERVAL_MS);
+    && (launcherMigrationDue || !Number.isFinite(lastCheckAt) || now - lastCheckAt >= UPDATE_INTERVAL_MS);
   return {
     schema_version: STATE_SCHEMA_VERSION,
     status: detected.status,
@@ -287,11 +323,15 @@ function check({ homeDir = os.homedir(), nodeVersion = process.versions.node, no
   };
 }
 
-function assertInstallable({ homeDir, nodeVersion }) {
+function assertInstallable({ homeDir, nodeVersion, platform }) {
   const paths = getPaths(homeDir);
   if (!isSupportedNode(nodeVersion)) throw new Error(`Node.js ${MIN_NODE_MAJOR}+ is required. Detected ${nodeVersion}.`);
   if (!fs.existsSync(paths.workBuddyDir)) throw new Error('No supported client was found. Launch WorkBuddy once, then retry.');
-  return { paths, node: resolveWorkBuddyNode(paths.workBuddyDir) };
+  const launcher = resolveWorkBuddyLauncher(paths.workBuddyDir, platform);
+  if (!launcher) {
+    throw new Error('WorkBuddy managed Node.js/npm runtime is incomplete: expected node.exe and node_modules/npm/bin/npx-cli.js in the same version directory.');
+  }
+  return { paths, launcher };
 }
 
 function install({
@@ -300,16 +340,17 @@ function install({
   selfCheck = defaultMcpSelfCheck,
   markConsent = true,
   replacePlugin = replacePluginAtomic,
+  platform = process.platform,
 } = {}) {
-  const { paths, node } = assertInstallable({ homeDir, nodeVersion });
-  const env = buildMcpEnvironment(pkg.version, node.binDir);
-  const mcpCheck = runMcpSelfCheck({ npx: node.npx, env, selfCheck });
+  const { paths, launcher } = assertInstallable({ homeDir, nodeVersion, platform });
+  const env = buildMcpEnvironment(pkg.version, launcher.binDir);
+  const mcpCheck = runMcpSelfCheck({ launcher, env, selfCheck });
   const mcpSnapshot = snapshotFile(paths.workBuddyMcpJson);
   const stateSnapshot = snapshotFile(paths.bootstrapState);
   let pluginBackup = null;
   let pluginReplaced = false;
   try {
-    mergeMcpConfig(paths.workBuddyMcpJson, buildMcpConfig(pkg.version, node.npx, node.binDir));
+    mergeMcpConfig(paths.workBuddyMcpJson, buildMcpConfig(pkg.version, launcher));
     pluginBackup = replacePlugin(paths.workBuddyPluginDir);
     pluginReplaced = true;
 
@@ -348,6 +389,7 @@ function update({
   homeDir = os.homedir(),
   nodeVersion = process.versions.node,
   selfCheck = defaultMcpSelfCheck,
+  platform = process.platform,
 } = {}) {
   const paths = getPaths(homeDir);
   const state = loadState(paths.bootstrapState);
@@ -357,7 +399,13 @@ function update({
     return { status: detected.status, reason: detected.reason };
   }
   if (state.restart_required) return { status: 'restart_required', reason: 'WorkBuddy must be restarted to load the updated plugin and MCP configuration.' };
-  if (readInstalledPluginVersion(paths.workBuddyPluginDir) === pkg.version) {
+  const mcp = readMcpConfig(paths.workBuddyMcpJson);
+  const expectedLauncher = platform === 'win32'
+    ? resolveWorkBuddyLauncher(paths.workBuddyDir, platform)
+    : undefined;
+  const launcherMigrationDue = mcp.config !== null
+    && needsMcpLauncherMigration(mcp.config, platform, expectedLauncher);
+  if (readInstalledPluginVersion(paths.workBuddyPluginDir) === pkg.version && !launcherMigrationDue) {
     state.status = 'ready';
     state.creator_outreach_version = pkg.version;
     state.last_check_at = new Date().toISOString();
@@ -365,7 +413,7 @@ function update({
     writeJsonAtomic(paths.bootstrapState, state);
     return { status: 'ready', creator_outreach_version: pkg.version };
   }
-  return install({ homeDir, nodeVersion, selfCheck, markConsent: false });
+  return install({ homeDir, nodeVersion, selfCheck, markConsent: false, platform });
 }
 
 function printJson(value) {
@@ -403,6 +451,7 @@ module.exports = {
   UPDATE_INTERVAL_MS,
   WORKBUDDY_SHARE_URL,
   check,
+  defaultMcpSelfCheck,
   detectStatus,
   getNodeMajorVersion,
   getPaths,
@@ -410,6 +459,8 @@ module.exports = {
   isManagedMcpConfig,
   isSupportedNode,
   markReady,
+  needsMcpLauncherMigration,
+  resolveWorkBuddyLauncher,
   runCli,
   update,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scorehub/creator-outreach",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "ScoreHub AI TikTok达人营销专家 Tiky — Agent 定义 + Skills 配置",
   "engines": {
     "node": ">=18"