@limecloud/lime 1.144.1

package/README.md

@@ -0,0 +1,68 @@
+# `@limecloud/lime`
+
+Lime 的官方命令行入口。CLI、TUI 和 Desktop 共用 App Server JSON-RPC、RuntimeCore 与 canonical Thread/Turn/Item，不包含独立任务 runtime。
+
+## 安装
+
+```bash
+npm install -g @limecloud/lime
+```
+
+根 npm 包只包含 launcher，并通过 optional dependency 安装当前平台的原生载荷；安装阶段不执行网络下载脚本。平台载荷原子包含 `lime`、`app-server`、`code-mode-host`、Windows sandbox helpers 和所需动态库，保证默认 TUI 与 `exec` 都进入同一 App Server 产品链。
+
+当前发布目标为 macOS arm64/x64、Windows x64 与 Linux x64 GNU。尚无真实构建和运行证据的平台会明确拒绝启动，不发布空壳 optional package。
+
+## 命令
+
+```bash
+# 默认启动交互式 TUI
+lime
+
+# 显式启动 TUI
+lime tui
+
+# 非交互运行
+lime exec "review this diff"
+lime exec --json "review this diff"
+lime exec --jsonl "review this diff"
+
+# 只读检查 execpolicy prefix rules
+lime execpolicy check --rules ./rules/policy.rules --pretty git push origin main
+
+# 生成 shell completion
+lime completion zsh > "${fpath[1]}/_lime"
+
+# 恢复 canonical Thread
+lime resume
+lime resume <thread-id>
+
+# App Server read/control surfaces
+lime thread list
+lime thread show <thread-id> --include-turns
+lime mcp list
+lime skills list
+```
+
+`--json` 输出可读的稳定 JSON；`--jsonl` 输出单行 JSON envelope，二者互斥。`completion` 从同一命令树生成 bash、zsh、fish、PowerShell 和 elvish 脚本。
+
+交互式 TUI 支持 `zh-CN`、`zh-TW`、`en-US`、`ja-JP`、`ko-KR`。可通过默认 `lime`、`lime tui` 或 `lime resume` 的 `--locale <LOCALE>` 指定；未指定时按 `LIME_LOCALE`、`LC_ALL`、`LANG` 解析，未知语言回退到 `en-US`。`exec` 与管理命令的 JSON 合同保持语言无关。
+
+本地连接默认启动同目录或 `PATH` 中的 `app-server`。可用 `LIME_APP_SERVER_BIN` 或 `--app-server <PATH>` 覆盖。需要连接远端 App Server 时使用 Codex 形状的参数：
+
+```bash
+lime exec --remote wss://cloud.example/rpc --remote-auth-token-env LIME_REMOTE_TOKEN "review this diff"
+lime tui --remote ws://127.0.0.1:4500
+```
+
+远端 token 只从环境变量读取；token 连接要求 `wss://` 或 loopback `ws://`。当前仅提供 transport foundation，不代表生产 Cloud endpoint、租户或账号能力已启用。
+
+## 发布
+
+```bash
+python3 scripts/build_npm_package.py \
+  --package lime \
+  --release-version 1.140.0 \
+  --pack-output dist/lime-npm-1.140.0.tgz
+```
+
+平台包使用 `--package lime-<platform>-<arch> --vendor-src <vendor-root>` staging。`vendor-root` 必须使用 `vendor/<target-triple>/bin` 布局并包含完整 runtime payload。发布工作流先串行发布四个平台版本，最后发布 `@limecloud/lime` 根版本。

package/bin/lime.js

@@ -0,0 +1,260 @@
+#!/usr/bin/env node
+// Unified entry point for the Lime CLI.
+
+import { spawn } from "node:child_process";
+import { existsSync, readFileSync, realpathSync } from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const require = createRequire(import.meta.url);
+const limePackageRoot = realpathSync(path.join(__dirname, ".."));
+
+const PLATFORM_PACKAGE_BY_TARGET = {
+  "x86_64-unknown-linux-gnu": "@limecloud/lime-linux-x64",
+  "x86_64-apple-darwin": "@limecloud/lime-darwin-x64",
+  "aarch64-apple-darwin": "@limecloud/lime-darwin-arm64",
+  "x86_64-pc-windows-msvc": "@limecloud/lime-win32-x64",
+};
+
+const { platform, arch } = process;
+
+let targetTriple = null;
+switch (platform) {
+  case "linux":
+    if (arch === "x64") {
+      targetTriple = "x86_64-unknown-linux-gnu";
+    }
+    break;
+  case "darwin":
+    if (arch === "x64") {
+      targetTriple = "x86_64-apple-darwin";
+    } else if (arch === "arm64") {
+      targetTriple = "aarch64-apple-darwin";
+    }
+    break;
+  case "win32":
+    if (arch === "x64") {
+      targetTriple = "x86_64-pc-windows-msvc";
+    }
+    break;
+  default:
+    break;
+}
+
+if (!targetTriple) {
+  throw new Error(`Unsupported platform: ${platform} (${arch})`);
+}
+
+const platformPackage = PLATFORM_PACKAGE_BY_TARGET[targetTriple];
+if (!platformPackage) {
+  throw new Error(`Unsupported target triple: ${targetTriple}`);
+}
+
+function findLimeExecutable() {
+  let vendorRoot;
+  try {
+    const packageJsonPath = require.resolve(`${platformPackage}/package.json`);
+    vendorRoot = path.join(path.dirname(packageJsonPath), "vendor");
+  } catch {
+    vendorRoot = path.join(__dirname, "..", "vendor");
+  }
+
+  const limeExecutable = path.join(
+    vendorRoot,
+    targetTriple,
+    "bin",
+    process.platform === "win32" ? "lime.exe" : "lime",
+  );
+  if (existsSync(limeExecutable)) {
+    return limeExecutable;
+  }
+
+  const packageManager = detectPackageManager();
+  const updateCommand =
+    packageManager === "bun"
+      ? "bun install -g @limecloud/lime@latest"
+      : packageManager === "pnpm"
+        ? "pnpm add -g @limecloud/lime@latest"
+        : packageManager === "vite-plus"
+          ? "vp install -g @limecloud/lime@latest"
+          : "npm install -g @limecloud/lime@latest";
+  throw new Error(
+    `Missing optional dependency ${platformPackage}. Reinstall Lime: ${updateCommand}`,
+  );
+}
+
+function isPnpmOwnedLimeInstall(nodeModulesDir) {
+  if (!existsSync(path.join(nodeModulesDir, ".modules.yaml"))) {
+    return false;
+  }
+
+  try {
+    return (
+      realpathSync(path.join(nodeModulesDir, "@limecloud", "lime")) ===
+      limePackageRoot
+    );
+  } catch {
+    return false;
+  }
+}
+
+function isVitePlusOwnedLimeInstall(packagesDir) {
+  if (path.basename(packagesDir) !== "packages") {
+    return false;
+  }
+
+  try {
+    const metadata = JSON.parse(
+      readFileSync(path.join(packagesDir, "@limecloud", "lime.json"), "utf8"),
+    );
+    if (metadata.name !== "@limecloud/lime") {
+      return false;
+    }
+
+    const installId = metadata.installId || "";
+    const installDir = installId.startsWith("#")
+      ? path.join(packagesDir, `@limecloud/lime${installId}`)
+      : path.join(packagesDir, "@limecloud/lime", installId);
+    for (const nodeModulesDir of [
+      path.join(installDir, "lib", "node_modules"),
+      path.join(installDir, "node_modules"),
+    ]) {
+      const packageRoot = path.join(nodeModulesDir, "@limecloud", "lime");
+      if (
+        existsSync(packageRoot) &&
+        realpathSync(packageRoot) === limePackageRoot
+      ) {
+        return true;
+      }
+    }
+  } catch {
+    // Missing ownership metadata must not prevent Lime from starting.
+  }
+  return false;
+}
+
+function detectPackageManager() {
+  const entrypointDir = path.dirname(path.resolve(process.argv[1]));
+  for (const startDir of new Set([limePackageRoot, entrypointDir])) {
+    const filesystemRoot = path.parse(startDir).root;
+    for (
+      let currentDir = startDir;
+      currentDir !== filesystemRoot;
+      currentDir = path.dirname(currentDir)
+    ) {
+      if (isVitePlusOwnedLimeInstall(currentDir)) {
+        return "vite-plus";
+      }
+      if (isPnpmOwnedLimeInstall(path.join(currentDir, "node_modules"))) {
+        return "pnpm";
+      }
+    }
+
+    if (isPnpmOwnedLimeInstall(path.join(filesystemRoot, "node_modules"))) {
+      return "pnpm";
+    }
+  }
+
+  const userAgent = process.env.npm_config_user_agent || "";
+  if (/\bbun\//u.test(userAgent)) {
+    return "bun";
+  }
+
+  const execPath = process.env.npm_execpath || "";
+  if (execPath.includes("bun")) {
+    return "bun";
+  }
+
+  if (
+    __dirname.includes(".bun/install/global") ||
+    __dirname.includes(".bun\\install\\global")
+  ) {
+    return "bun";
+  }
+
+  return userAgent ? "npm" : null;
+}
+
+const binaryPath = findLimeExecutable();
+const packageManager = detectPackageManager();
+const packageManagerEnvVar =
+  packageManager === "bun"
+    ? "LIME_MANAGED_BY_BUN"
+    : packageManager === "pnpm"
+      ? "LIME_MANAGED_BY_PNPM"
+      : packageManager === "vite-plus"
+        ? "LIME_MANAGED_BY_VITE_PLUS"
+        : "LIME_MANAGED_BY_NPM";
+const env = {
+  ...process.env,
+  LIME_MANAGED_PACKAGE_ROOT: limePackageRoot,
+};
+delete env.LIME_MANAGED_BY_NPM;
+delete env.LIME_MANAGED_BY_BUN;
+delete env.LIME_MANAGED_BY_PNPM;
+delete env.LIME_MANAGED_BY_VITE_PLUS;
+env[packageManagerEnvVar] = "1";
+
+// macOS strips DYLD_* variables when Node launches the native child. The
+// bundled App Server loads its @rpath libraries from this directory, so pass
+// the package-local runtime directory explicitly to the native process.
+const nativeRuntimeDir = path.dirname(binaryPath);
+if (process.platform === "darwin") {
+  env.DYLD_LIBRARY_PATH = [nativeRuntimeDir, env.DYLD_LIBRARY_PATH]
+    .filter(Boolean)
+    .join(path.delimiter);
+} else if (process.platform === "linux") {
+  env.LD_LIBRARY_PATH = [nativeRuntimeDir, env.LD_LIBRARY_PATH]
+    .filter(Boolean)
+    .join(path.delimiter);
+}
+
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+  env,
+});
+
+child.on("error", (error) => {
+  console.error(error);
+  process.exit(1);
+});
+
+const forwardSignal = (signal) => {
+  if (child.killed) {
+    return;
+  }
+  try {
+    child.kill(signal);
+  } catch {
+    // The exit handler below remains the single parent termination owner.
+  }
+};
+
+const signalHandlers = new Map();
+for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+  const handler = () => forwardSignal(signal);
+  signalHandlers.set(signal, handler);
+  process.on(signal, handler);
+}
+
+const childResult = await new Promise((resolve) => {
+  child.on("exit", (code, signal) => {
+    if (signal) {
+      resolve({ type: "signal", signal });
+    } else {
+      resolve({ type: "code", exitCode: code ?? 1 });
+    }
+  });
+});
+
+if (childResult.type === "signal") {
+  for (const [signal, handler] of signalHandlers) {
+    process.removeListener(signal, handler);
+  }
+  process.kill(process.pid, childResult.signal);
+} else {
+  process.exit(childResult.exitCode);
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@limecloud/lime",
+  "version": "1.144.1",
+  "packageManager": "pnpm@9.15.9",
+  "description": "Lime CLI is an agent that runs in your terminal.",
+  "bin": {
+    "lime": "bin/lime.js"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/limecloud/lime.git",
+    "directory": "packages/cli"
+  },
+  "license": "MIT",
+  "files": [
+    "bin/lime.js"
+  ],
+  "optionalDependencies": {
+    "@limecloud/lime-linux-x64": "1.144.1-linux-x64",
+    "@limecloud/lime-darwin-x64": "1.144.1-darwin-x64",
+    "@limecloud/lime-darwin-arm64": "1.144.1-darwin-arm64",
+    "@limecloud/lime-win32-x64": "1.144.1-win32-x64"
+  }
+}