@zhiyueyun/cli 0.2.19 → 0.2.20

package/README.md

@@ -82,6 +82,12 @@ M2M 应用还需获授 `open-platform:publishUnifiedSkill`。`OPEN_PLATFORM_BASE
 
 CLI 自动版本以 npm 已发布的最高稳定版本为基准，优先递增 patch：`0.2.16 → 0.2.17 → … → 0.2.100 → 0.3.0`。patch 已达到或超过 100 时，下一版本递增 minor 并将 patch 归零；minor 和 major 不自动设置上限。不受仓库中未发布版本或 npm `latest` 标签回退影响；例如仓库为未发布的 `0.3.0`、npm 最高稳定版本为 `0.2.16` 时，重建 `0.2.17`。发布失败重试不会消耗新版本；npm 尚无稳定版本时使用仓库初始版本。此规则仅用于 CLI，平台套件保留独立版本规则。
 
+npm 返回上传成功后，服务进入 `wait-npm`，每 30 秒核验指定版本及候选来源，最长等待约 10 分钟；只有 npm 可见且来源匹配才调用套件发布。平台自身仍查不到新版本时也在该窗口内重试；权限、来源冲突等错误直接报错。超时返回 `state: pending`、`result.action: pending`，不会误报整条发布成功。
+
+上传前通过 GitLab Commits API 保存 `cli-release-pending.json`，只记录版本、候选来源和时间。后续任务（包括 Pod 重启后）优先核验此记录，不重复构建上传；确认并补发套件成功后删除记录。如果等待期间平台契约已变化，则先确认旧候选已上线，再为新契约构建新版本。明确的 npm 认证或发布拒绝会清除记录以允许重试；网络中断、进程中断等上传结果不确定时保留记录，若长期不可见，需要先人工核对 npm 状态再处理记录。
+
+任务结束时输出 `sync completed`，包含状态、CLI 版本及套件决策（`published` 或 `unchanged`），方便区分实际发布和幂等检查。
+
 直接调用本机服务时的定时器请求示例：
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhiyueyun/cli",
-  "version": "0.2.19",
+  "version": "0.2.20",
   "description": "Official Zhiyue Open Platform CLI with embedded command metadata and Agent Skills",
   "keywords": [
     "cli",
@@ -111,8 +111,8 @@
       },
       {
         "serviceCode": "form-engine",
-        "version": "0.2.0",
-        "checksum": "1cc2d7c413b73ef42e8e13f71c0a45aabb94df2045017c6c1eadbbfa686faeda"
+        "version": "0.5.0",
+        "checksum": "cac07f227c61bae40628e455694e75d548593dcf467ccd120d3e9ef5f266e9e3"
       },
       {
         "serviceCode": "greenplant-server",
@@ -271,8 +271,8 @@
       }
     ],
     "runtimeChecksum": "7e70283697bc0c68824ddf64e902ae4feaeef0d5ec7d3e6df4d2550a53d51931",
-    "inputChecksum": "b50c93e5ca50883c3466870ddf0d4b274924b615a5ca8b4a56c6c203fc33153a",
-    "sourceChecksum": "f2ffb7d84101227bbfb43183acf3ac6cb8ceb5ad5a8414b0363f55ffa9dde925",
-    "contentChecksum": "6c81daa2744cbd3335eab0e2ea3d32c1578bee3916530c273e9fb7db10a2f912"
+    "inputChecksum": "d8d9228784a182de917a78f344370616fbd04138ba925bed8fb644f53867929b",
+    "sourceChecksum": "6d828864fe72ff9fdf2ca8adc581a024e5954d250c1a7a26b96b887b8d05d43b",
+    "contentChecksum": "6d6c6c8804055f2f08ccebe103211082dd5b60478f79d478af8a62ef26d3552c"
   }
 }