@jsonstudio/rcc 0.90.429 → 0.90.701

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsonstudio/rcc",
-  "version": "0.90.429",
+  "version": "0.90.701",
   "description": "Multi-provider OpenAI proxy server with anthropic/responses/chat support (release)",
   "type": "module",
   "main": "dist/index.js",
@@ -104,6 +104,7 @@
     "llmswitch:ensure": "node scripts/ensure-llmswitch-mode.mjs",
     "llmswitch:link": "node scripts/link-llmswitch.mjs",
     "llmswitch:unlink": "node scripts/link-llmswitch.mjs unlink",
+    "llmswitch:link:global": "node scripts/link-global-llms-local.mjs --require-target",
     "dry-run:responses-provider": "node scripts/tests/responses-provider-dry-run.mjs",
     "start:verify:fg": "node scripts/start-verify.mjs --mode fg --timeout 90",
     "rc-config": "node scripts/rc-config.mjs",
@@ -159,7 +160,7 @@
     "@ai-sdk/anthropic": "^3.0.58",
     "@ai-sdk/openai": "^3.0.41",
     "@anthropic-ai/sdk": "^0.65.0",
-    "@jsonstudio/llms": "0.6.3952",
+    "@jsonstudio/llms": "0.6.4291",
     "@lmstudio/sdk": "^1.5.0",
     "@radix-ui/react-switch": "^1.2.6",
     "@types/socket.io": "^3.0.1",

package/scripts/ci/repo-sanity.mjs

@@ -27,7 +27,7 @@ function listRootEntries() {
 
 function isForbiddenRootFile(p) {
   const base = path.posix.basename(p);
-  const allow = new Set(['AGENTS.md', 'README.md', 'MEMORY.md', 'task.md']);
+  const allow = new Set(['AGENTS.md', 'README.md', 'MEMORY.md', 'HEARTBEAT.md', 'DELIVERY.md', 'task.md']);
   if (allow.has(base)) return false;
   if (/^test-.*\.(mjs|js|ts|py)$/i.test(base)) return true;
   if (/^debug-.*\.(mjs|js|ts)$/i.test(base)) return true;
@@ -73,6 +73,8 @@ function checkRootLayout() {
    '.gitattributes',
    '.gitignore',
    'AGENTS.md',
+   'HEARTBEAT.md',
+   'DELIVERY.md',
    'README.md',
    'MEMORY.md',
    'config',

package/scripts/install-global.sh

@@ -45,6 +45,21 @@ check_node() {
     echo "✅ Node.js: $(node -v)"
 }
 
+check_tmux() {
+    if command -v tmux &> /dev/null; then
+        echo "✅ tmux: $(tmux -V 2>/dev/null || echo tmux)"
+        return
+    fi
+
+    echo "❌ tmux 未安装"
+    echo "💡 RouteCodex 的 tmux 会话管理 / 注入 / heartbeat 依赖 tmux"
+    echo "💡 请先安装 tmux 后再执行全局安装，例如："
+    echo "   macOS(Homebrew): brew install tmux"
+    echo "   Ubuntu/Debian: apt-get install -y tmux"
+    echo "   CentOS/RHEL: yum install -y tmux"
+    exit 1
+}
+
 # 构建项目
 build_project() {
     echo "🔨 构建项目..."
@@ -140,46 +155,7 @@ global_install() {
 
 link_global_llms_dev() {
     echo "🔗 链接全局 @jsonstudio/llms 到本地 sharedmodule (dev 模式)..."
-
-    local npm_prefix
-    local global_node_modules
-    npm_prefix=$(npm config get prefix)
-    global_node_modules=$(npm root -g 2>/dev/null || true)
-    if [ -z "${global_node_modules:-}" ]; then
-        global_node_modules="$npm_prefix/lib/node_modules"
-    fi
-
-    local global_routecodex
-    local local_llms
-    local global_llms_parent
-    local global_llms_link
-
-    global_routecodex="$global_node_modules/routecodex"
-    local_llms="$PWD/sharedmodule/llmswitch-core"
-    global_llms_parent="$global_routecodex/node_modules/@jsonstudio"
-    global_llms_link="$global_llms_parent/llms"
-
-    if [ ! -d "$global_routecodex" ]; then
-        echo "❌ 未找到全局 routecodex 安装目录: $global_routecodex"
-        exit 1
-    fi
-    if [ ! -d "$local_llms" ] || [ ! -f "$local_llms/package.json" ]; then
-        echo "❌ 未找到本地 llmswitch-core: $local_llms"
-        exit 1
-    fi
-    if [ ! -d "$local_llms/dist" ]; then
-        echo "❌ 本地 llmswitch-core 尚未构建 (缺少 dist/): $local_llms"
-        echo "💡 请先在 sharedmodule/llmswitch-core 执行 npm run build"
-        exit 1
-    fi
-
-    mkdir -p "$global_llms_parent"
-    rm -rf "$global_llms_link"
-    ln -s "$local_llms" "$global_llms_link"
-
-    local resolved_target
-    resolved_target=$(readlink "$global_llms_link" || true)
-    echo "✅ 全局 llms 已链接: $global_llms_link -> $resolved_target"
+    node scripts/link-global-llms-local.mjs --package routecodex --require-target
 }
 
 # 验证安装
@@ -266,6 +242,7 @@ cleanup_old_install() {
 # 主函数
 main() {
     check_node
+    check_tmux
     cleanup_old_install
     node scripts/cleanup-stale-server-pids.mjs --quiet || true
     build_project

package/scripts/install-release.sh

@@ -14,6 +14,18 @@ fi
 VERSION=$(node -p "require('./package.json').version" 2>/dev/null || echo "0.0.0")
 echo "📦 当前源码版本: routecodex@${VERSION}"
 
+if command -v tmux >/dev/null 2>&1; then
+  echo "✅ tmux: $(tmux -V 2>/dev/null || echo tmux)"
+else
+  echo "❌ tmux 未安装"
+  echo "💡 RouteCodex/RCC 的 tmux 会话管理 / 注入 / heartbeat 依赖 tmux"
+  echo "💡 请先安装 tmux 后再执行 release 安装，例如："
+  echo "   macOS(Homebrew): brew install tmux"
+  echo "   Ubuntu/Debian: apt-get install -y tmux"
+  echo "   CentOS/RHEL: yum install -y tmux"
+  exit 1
+fi
+
 echo "🔨 构建源码..."
 # release 包：显式使用 BUILD_MODE=release 以便在编译期区分 dev/release
 BUILD_MODE=release npm run build
@@ -75,10 +87,14 @@ npm uninstall -g @jsonstudio/rcc >/dev/null 2>&1 || true
 echo "🌍 全局安装 @jsonstudio/rcc (release)..."
 npm install -g "${RCC_TARBALL}" --no-audit --no-fund
 
+echo "🔗 固定全局 rcc 的 @jsonstudio/llms 到本地 sharedmodule/llmswitch-core..."
+node scripts/link-global-llms-local.mjs --package @jsonstudio/rcc --require-target
+
 echo "🔍 验证 rcc 安装..."
 if command -v rcc >/dev/null 2>&1; then
   echo "✅ @jsonstudio/rcc 已全局安装：$(command -v rcc)"
   rcc --version || true
+  node -e "const fs=require('fs');const path=require('path');const cp=require('child_process');const root=cp.execSync('npm root -g').toString().trim();const llmsPath=path.join(root,'@jsonstudio','rcc','node_modules','@jsonstudio','llms');const pkgPath=path.join(llmsPath,'package.json');const link=fs.existsSync(llmsPath)&&fs.lstatSync(llmsPath).isSymbolicLink();const target=link?fs.readlinkSync(llmsPath):'(not-symlink)';const version=fs.existsSync(pkgPath)?JSON.parse(fs.readFileSync(pkgPath,'utf8')).version:'unknown';console.log('🔎 全局 rcc @jsonstudio/llms:',version,'link=',link,'target=',target);"
 else
   echo "❌ 未找到 rcc 命令，请检查 npm 全局安装路径"
   exit 1

package/scripts/link-global-llms-local.mjs

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const projectRoot = path.resolve(__dirname, '..');
+const localLlms = path.join(projectRoot, 'sharedmodule', 'llmswitch-core');
+
+function parseArgs(argv) {
+  const out = {
+    packageNames: [],
+    requireTarget: false
+  };
+  for (let i = 2; i < argv.length; i += 1) {
+    const arg = String(argv[i] || '').trim();
+    if (!arg) continue;
+    if (arg === '--require-target') {
+      out.requireTarget = true;
+      continue;
+    }
+    if (arg === '--package' || arg === '-p') {
+      const value = String(argv[i + 1] || '').trim();
+      i += 1;
+      if (value) out.packageNames.push(value);
+      continue;
+    }
+    if (arg.startsWith('--package=')) {
+      const value = arg.slice('--package='.length).trim();
+      if (value) out.packageNames.push(value);
+      continue;
+    }
+  }
+  return out;
+}
+
+function npmRootGlobal() {
+  const res = spawnSync('npm', ['root', '-g'], { encoding: 'utf8' });
+  if ((res.status ?? 1) === 0) {
+    const value = String(res.stdout || '').trim();
+    if (value) return value;
+  }
+  const prefix = spawnSync('npm', ['config', 'get', 'prefix'], { encoding: 'utf8' });
+  const fallbackPrefix = (prefix.status ?? 1) === 0 ? String(prefix.stdout || '').trim() : '';
+  if (!fallbackPrefix) {
+    throw new Error('unable to resolve npm global root');
+  }
+  return path.join(fallbackPrefix, 'lib', 'node_modules');
+}
+
+function ensureLocalLlmsReady() {
+  if (!fs.existsSync(localLlms) || !fs.existsSync(path.join(localLlms, 'package.json'))) {
+    throw new Error(`local llmswitch-core not found: ${localLlms}`);
+  }
+  if (!fs.existsSync(path.join(localLlms, 'dist'))) {
+    throw new Error(`local llmswitch-core dist missing: ${path.join(localLlms, 'dist')}`);
+  }
+}
+
+function linkForPackage(globalRoot, packageName) {
+  const pkgRoot = path.join(globalRoot, ...packageName.split('/'));
+  if (!fs.existsSync(pkgRoot)) {
+    return { packageName, changed: false, skipped: true, reason: 'package-not-installed' };
+  }
+  const scopeDir = path.join(pkgRoot, 'node_modules', '@jsonstudio');
+  const linkPath = path.join(scopeDir, 'llms');
+  fs.mkdirSync(scopeDir, { recursive: true });
+  fs.rmSync(linkPath, { recursive: true, force: true });
+  fs.symlinkSync(localLlms, linkPath, 'junction');
+  const linkedTo = fs.readlinkSync(linkPath);
+  return { packageName, changed: true, skipped: false, linkPath, linkedTo };
+}
+
+function main() {
+  const args = parseArgs(process.argv);
+  const targets = args.packageNames.length > 0 ? args.packageNames : ['@jsonstudio/rcc', 'routecodex'];
+  ensureLocalLlmsReady();
+  const globalRoot = npmRootGlobal();
+  const results = targets.map((name) => linkForPackage(globalRoot, name));
+  const changed = results.filter((it) => it.changed);
+
+  if (args.requireTarget && changed.length <= 0) {
+    const detail = results
+      .map((it) => `${it.packageName}:${it.skipped ? it.reason : 'unknown'}`)
+      .join(', ');
+    throw new Error(`no eligible global package found to link @jsonstudio/llms (${detail})`);
+  }
+
+  for (const row of results) {
+    if (row.changed) {
+      console.log(
+        `[link-global-llms-local] linked ${row.packageName} -> ${row.linkPath} => ${row.linkedTo}`
+      );
+    } else if (row.skipped) {
+      console.log(`[link-global-llms-local] skip ${row.packageName} (${row.reason})`);
+    }
+  }
+}
+
+try {
+  main();
+} catch (error) {
+  const reason = error instanceof Error ? error.message : String(error);
+  console.error(`[link-global-llms-local] failed: ${reason}`);
+  process.exit(1);
+}
+