@qfeius/everyline-cli 0.1.5 → 0.1.6

package/bin/checksums.txt

@@ -1,6 +1,6 @@
-af353cfbd86324b8648364b825e1b818fa80b6ddc5baef42bc82ef4234e00339  bin/darwin-amd64/everyline-cli
-50a2d1f486de58fec995be15f4e88ed1d9f389429384e78f161a40723cb8d045  bin/darwin-arm64/everyline-cli
-593314210b4803a8c489676d8f72a7b69d0cee84c214fa1e895e734cdb143357  bin/linux-amd64/everyline-cli
-0cf8a8cf32efea14bb86151f440e9a391d1d8463c3c62bd47b2164009d4f118c  bin/linux-arm64/everyline-cli
-51efebd5d0c64b30543ecef7cc9e0dbc076171abf0703cdd38ec19de39c1bf51  bin/windows-amd64/everyline-cli.exe
-f06572abf1f8ea30bf6c1d8a9118ba7eebbd58be72901de330a4278f1e6f1b85  bin/windows-arm64/everyline-cli.exe
+42972378fcae2b729ce992ccc9d07af56980537956d46bca71cd5dcb7c0040a6  bin/darwin-amd64/everyline-cli
+21e6f194166a29efd88702a77b0b75f0870040cdf3da0360907f3699fb959e78  bin/darwin-arm64/everyline-cli
+0436b26cf2efd8d0a9745cfd17fd95781381a18d7a0480af9b6e9c81eeb6d297  bin/linux-amd64/everyline-cli
+12262192b44e3178d732b27c39a16473995061605e3219bde8c72406568b4903  bin/linux-arm64/everyline-cli
+a2dc6aaf804744a8a1905b32919255d8ce5be0fa5263bed57b048ac458af5f5e  bin/windows-amd64/everyline-cli.exe
+bc0af994fac92aa8624f3a96bce1ccc5198f09d713642ddf2d1ba55f9441208e  bin/windows-arm64/everyline-cli.exe

package/docs/everyline-cli-skill-guide.md

@@ -641,3 +641,13 @@ Windows PowerShell 使用自定义 prefix 时：
 $EverylineNpmPrefix = Join-Path $HOME ".local"
 npm uninstall -g --prefix $EverylineNpmPrefix @qfeius/everyline-cli
 ```
+
+### 恢复缺失的命令入口
+
+macOS/Linux 全局包仍存在但 `everyline-cli` 命令入口缺失时，使用原安装 prefix 执行：
+
+```bash
+npm rebuild -g --foreground-scripts --allow-scripts=@qfeius/everyline-cli @qfeius/everyline-cli
+```
+
+安装脚本会按包实际所在 prefix 检查并恢复缺失链接；显式设置 `--bin-links=false` 时跳过恢复。已有文件或链接保持原样；Windows 的命令 shim 由 npm rebuild 管理。入口后来再次被删除时，需要重新执行恢复命令，不会在后台自动重建。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qfeius/everyline-cli",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "EveryLine CLI 工具的 npm/npx 薄包装",
   "license": "UNLICENSED",
   "repository": {

package/scripts/install.js

@@ -346,6 +346,40 @@ function ensureFirstInstallState(packageRoot, environment, userHome, platform, r
   return { path: statePath, ...JSON.parse(output) };
 }
 
+/**
+ * restoreGlobalCommand 恢复 macOS/Linux 全局包缺失的命令链接，保留已有入口。
+ * 入参：packageRoot（string）为包目录；platform（string）为平台；environment（object）为 npm 环境。
+ * 返回值：void；禁用命令链接、非全局、Windows 或非标准全局布局直接返回，文件系统错误向上传递。
+ */
+function restoreGlobalCommand(packageRoot, platform, environment) {
+  // 尊重 npm 显式禁用命令链接的选择，避免 postinstall 重新创建已被 npm 跳过的入口。
+  if (environment.npm_config_bin_links === "false" ||
+      environment.npm_config_global !== "true" || platform === "win32") return;
+  // 从包实际所在位置推导 prefix，避免使用另一个 Node/npm 的全局目录。
+  const root = resolve(packageRoot);
+  const modules = dirname(dirname(root));
+  if (basename(root) !== "everyline-cli" || basename(dirname(root)) !== "@qfeius" ||
+      basename(modules) !== "node_modules" || basename(dirname(modules)) !== "lib") return;
+  const source = join(root, "scripts", "run.js");
+  if (!existsSync(source)) throw new Error(`npm 包缺少命令入口: ${source}`);
+  const target = join(dirname(dirname(modules)), "bin", "everyline-cli");
+  try {
+    // lstat 也能识别失效链接；已有入口交给 npm 管理，绝不覆盖用户文件。
+    lstatSync(target);
+    return;
+  } catch (error) {
+    if (error.code !== "ENOENT") throw error;
+  }
+  mkdirSync(dirname(target), { recursive: true });
+  chmodSync(source, 0o755);
+  try {
+    symlinkSync(source, target);
+  } catch (error) {
+    // 并发 npm 已创建入口时保留其结果。
+    if (error.code !== "EEXIST") throw error;
+  }
+}
+
 /**
  * installPackage 保留首次安装意图，将三宿主同步、废弃入口迁出和最终安装状态提交放在同一恢复流程中。
  * 入参：options（object，可选），可注入 packageRoot、platform、architecture、environment 和 userHome 供安装与测试使用。
@@ -368,6 +402,8 @@ function installPackage(options = {}) {
     chmodSync(binary, 0o755);
   }
 
+  restoreGlobalCommand(packageRoot, platform, environment);
+
   if (!shouldInstallCodexSkill(environment)) {
     return {
       binary,
@@ -492,6 +528,7 @@ if (require.main === module) {
 }
 
 module.exports = {
+  restoreGlobalCommand,
   formatInstallOutput,
   installPackage,
   ensureFirstInstallState,

package/skills/everyline-review/SKILL.md

@@ -2,7 +2,7 @@
 name: everyline-review
 description: "负责 EveryLine CLI 安装配置、身份授权与恢复；使用 EveryLine CLI 发起或继续单份合同智能审查，包括沙箱附件、审查主体、清单、强度、任务状态和完整签名结果链接；合同起草、一般法律咨询及规则维护不使用本 Skill。"
 metadata:
-  version: "0.1.5"
+  version: "0.1.6"
   requires:
     bins: ["everyline-cli"]
   cliHelp: "everyline-cli --help;everyline-cli auth --help;everyline-cli review file upload --help;everyline-cli review task start --help;everyline-cli review task result --help"

package/skills/everyline-review-config/SKILL.md

@@ -2,7 +2,7 @@
 name: everyline-review-config
 description: "使用 EveryLine CLI 查询或管理审查清单、审查规则和规则分组，包括新增、修改、调整归属和删除；仅在合同审查中选择已有清单时不使用本 Skill。"
 metadata:
-  version: "0.1.5"
+  version: "0.1.6"
   requires:
     bins: ["everyline-cli"]
     skills: ["everyline-review"]