@qfeius/everyline-cli 0.1.4 → 0.1.6

package/bin/checksums.txt

@@ -1,6 +1,6 @@
-9dc852a86aea9ae39a8c386c294a9d5fde07ec6a4133187d0fe136d1411df30c  bin/darwin-amd64/everyline-cli
-c8d11032ff5779b4c891699ed71c895d2071df3ee6d281860c3571fb74616147  bin/darwin-arm64/everyline-cli
-9132cacb338ecea9fd2d8d60d10a33c4a1a99839003d2d57c380769fbb78515f  bin/linux-amd64/everyline-cli
-12e239482566e8a73c75d2515ec650aaea3ceef795eba2eae0513c55d4f256bc  bin/linux-arm64/everyline-cli
-14e775a284c4e9fcbe9ce3ca2b98770175bbf62f4d8035bc2bdfca8c401ae74b  bin/windows-amd64/everyline-cli.exe
-23a2122126cd74deffbe59958ef785e0bcd9ae1b9033c7342f012048f0ee5f76  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/docs/npm-release.md

@@ -4,8 +4,8 @@ npm 包名为 `@qfeius/everyline-cli`，终端命令和两项 Skill 名称保持
 
 ## 一次性配置
 
-1. 确认 npm 账号有 `@qfeius` 下此包的发布权限。首次发布前先检查组织权限和包名归属。
-2. 在 GitHub 仓库 `qfeius/everyline-cli` 的 **Settings → Secrets and variables → Actions** 中添加 `NPM_TOKEN`。使用具有包写权限、允许非交互发布的 granular access token；按 npm 当前规则配置 Bypass 2FA，不将 token 写入仓库。
+1. 在 npm 包的 Trusted Publisher 中配置 GitHub 仓库 `qfeius/everyline-cli` 和工作流 `npm-publish.yml`，供 OIDC 发布。确认 npm 账号有 `@qfeius` 下此包的发布权限。首次发布前先检查组织权限和包名归属。
+2. npm 发布使用 OIDC 临时身份，无需为 GitHub Release 配置 `NPM_TOKEN`。
 3. 将 `.github/workflows/release.yml` 推送到 GitHub。工作流使用 GitHub 自动提供的 token 创建 Release，无需另配 GitHub token。
 
 Token 权限说明：[npm CI/CD 文档](https://docs.npmjs.com/using-private-packages-in-a-ci-cd-workflow/)。
@@ -24,7 +24,7 @@ git push github v0.0.8
 
 上例中的版本须替换为本次版本。`github` 为本仓库指向 GitHub 的远端名称。
 
-标签触发的工作流依次校验版本与 npm 登录、运行测试和安装校验、发布 GitHub 原生二进制制品、上传 npm 安装包和两项 Skill ZIP、发布 npm 包，最后回查 npm 渠道版本。正式版发布到 `latest`；含预发布后缀的版本发布到 `beta`，不覆盖 `latest`。
+标签触发两条独立工作流：`release.yml` 校验版本、运行测试和安装校验，发布 GitHub 原生二进制制品、npm 安装包和两项 Skill ZIP；`npm-publish.yml` 通过 OIDC 发布 npm。GitHub 制品发布不依赖 NPM_TOKEN。正式版发布到 `latest`；预发布版使用版本后缀首段作为 dist-tag，例如 `test.1` 使用 `test`。
 
 GitLab 流水线继续负责测试、构建和保存 `.tgz`，不重复发布 npm。
 
@@ -37,7 +37,7 @@ npm install -g --foreground-scripts --allow-scripts=@qfeius/everyline-cli @qfeiu
 everyline-cli version --output json
 ```
 
-预发布版将 `@latest` 替换为 `@beta`。安装包内含六个平台的二进制，不需要再次从 GitHub 下载。
+预发布版将 `@latest` 替换为对应 dist-tag，例如 `@test`。安装包内含六个平台的二进制，不需要再次从 GitHub 下载。
 
 尚未发布到 npm 时，使用构建后的本地包：
 
@@ -64,7 +64,7 @@ everyline-cli version --output json
 
 ## 发布失败
 
-- 缺少 `NPM_TOKEN`：工作流在发布前明确报错，配置 GitHub Secret 后重跑。
+- npm OIDC 身份校验失败：核对 npm Trusted Publisher 配置的仓库与 `npm-publish.yml` 工作流名称。
 - npm 403：核对 scope、包写权限、token 有效期及非交互发布权限。
 - 版本已存在：不要覆盖；核对已发布结果，需要变更时提升版本并创建新标签。
 - GitHub Release 已生成但 npm 发布失败：npm 包尚未发布成功；解决错误后可安装 Release 中的 `.tgz`，再处理 npm 发布。不要仅凭 Release 存在宣称 npm 已可安装。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qfeius/everyline-cli",
-  "version": "0.1.4",
+  "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.4"
+  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.4"
+  version: "0.1.6"
   requires:
     bins: ["everyline-cli"]
     skills: ["everyline-review"]