@clawos-dev/clawd 0.2.490 → 0.2.492

package/dist/app-builder-plugin/mcp-server.cjs

@@ -21360,6 +21360,8 @@ var DeployFileSchema = external_exports.object({
   version: external_exports.literal(1),
   manifest: EnvironmentManifestSchema
 }).strict();
+var SCAN_BASE_KINDS = ["hard", "soft"];
+var ScanBaseKindSchema = external_exports.enum(SCAN_BASE_KINDS);
 var DeployScanStatusSchema = external_exports.enum(["scanning", "done", "failed"]);
 var DeployScanSchema = external_exports.object({
   /** 干这次扫描的 butler 会话，「看它怎么干的」入口 */
@@ -21379,6 +21381,26 @@ var DeployScanSchema = external_exports.object({
    * 缺席 = 旧版 clawd 扫的记录。**一律当过时**：没有第三种情况，重扫一次就有了。
    */
   head: external_exports.string().min(1).optional(),
+  /**
+   * 上次**发布**推的那个 commit ——「线上正跑的是哪一版」在本机唯一的答案，
+   * 也就是软扫的基准。只有 `deploy:release` 写它，扫描不动。
+   *
+   * 为什么不能用 `head` 顶替：`head` 被扫描和发布轮流覆盖（扫描前落存一版、发布后又挪一版），
+   * 它回答的是「清单绑在哪个 commit 上」，回答不了「上次发布是哪一版」。
+   *
+   * 缺席 = 这个 persona 还从没发布过，没有线上版本可比，软扫退硬扫。
+   */
+  releasedHead: external_exports.string().min(1).optional(),
+  /**
+   * 这次**实际**怎么扫的。是结果不是入参——`deploy:start` 收到的 mode 可能因为没有可比的
+   * 基准而退成硬扫，页面要显示的是真正发生的那个。
+   *
+   * `.default('hard')` 而不是必填：这个文件是 strict 解析的，存量记录没有这个字段，
+   * 定成必填会让 `readScan` 当场抛、上云页面直接打不开。而老记录确实都是从零扫的。
+   */
+  baseKind: ScanBaseKindSchema.default("hard"),
+  /** 软扫比的那个 commit（= `releasedHead`）。硬扫时缺席 */
+  base: external_exports.string().min(1).optional(),
   startedAt: external_exports.number(),
   finishedAt: external_exports.number().optional(),
   error: external_exports.string().optional()
@@ -21444,6 +21466,13 @@ var DeployReleaseResultSchema = external_exports.object({
 var DeployPersonaArgsSchema = external_exports.object({
   personaId: external_exports.string().min(1)
 }).strict();
+var DeployStartArgsSchema = DeployPersonaArgsSchema.extend({
+  /**
+   * 缺省 soft。真正用哪一档由 daemon 定（软扫比不了时会退硬扫），结果看 `DeployScan.baseKind`。
+   * 复用上面那个中央定义的字面量，不在这里手抄一份。
+   */
+  mode: ScanBaseKindSchema.optional()
+}).strict();
 var DeployPatchArgsSchema = external_exports.object({
   personaId: external_exports.string().min(1),
   patch: external_exports.object({

package/dist/cli.cjs

@@ -6045,7 +6045,7 @@ function cloudEngineOk(tool) {
 function repoSlug(url) {
   return url.trim().replace(/^git@[^:]+:/, "").replace(/^https?:\/\/[^/]+\//, "").replace(/\.git$/, "");
 }
-var DeployFileSchema, DeployScanStatusSchema, DeployScanSchema, DeployRepoSchema, DeploySecretPresenceSchema, DEPLOY_STAGE_STATUSES, DeployStageStatusSchema, DEPLOY_STAGE_KEYS, DeployStageKeySchema, DeployJobSchema, DeployRunSchema, DeployStateSchema, DeployReleaseResultSchema, DeployPersonaArgsSchema, DeployPatchArgsSchema, DeployPutSecretArgsSchema, DeployRerunJobArgsSchema, DeployReportFindingArgsSchema, DeployFinishScanArgsSchema, PERSONA_REPO_ORG;
+var DeployFileSchema, SCAN_BASE_KINDS, ScanBaseKindSchema, DeployScanStatusSchema, DeployScanSchema, DeployRepoSchema, DeploySecretPresenceSchema, DEPLOY_STAGE_STATUSES, DeployStageStatusSchema, DEPLOY_STAGE_KEYS, DeployStageKeySchema, DeployJobSchema, DeployRunSchema, DeployStateSchema, DeployReleaseResultSchema, DeployPersonaArgsSchema, DeployStartArgsSchema, DeployPatchArgsSchema, DeployPutSecretArgsSchema, DeployRerunJobArgsSchema, DeployReportFindingArgsSchema, DeployFinishScanArgsSchema, PERSONA_REPO_ORG;
 var init_deploy_schemas = __esm({
   "../protocol/src/deploy-schemas.ts"() {
     "use strict";
@@ -6055,6 +6055,8 @@ var init_deploy_schemas = __esm({
       version: external_exports.literal(1),
       manifest: EnvironmentManifestSchema
     }).strict();
+    SCAN_BASE_KINDS = ["hard", "soft"];
+    ScanBaseKindSchema = external_exports.enum(SCAN_BASE_KINDS);
     DeployScanStatusSchema = external_exports.enum(["scanning", "done", "failed"]);
     DeployScanSchema = external_exports.object({
       /** 干这次扫描的 butler 会话，「看它怎么干的」入口 */
@@ -6074,6 +6076,26 @@ var init_deploy_schemas = __esm({
        * 缺席 = 旧版 clawd 扫的记录。**一律当过时**：没有第三种情况，重扫一次就有了。
        */
       head: external_exports.string().min(1).optional(),
+      /**
+       * 上次**发布**推的那个 commit ——「线上正跑的是哪一版」在本机唯一的答案，
+       * 也就是软扫的基准。只有 `deploy:release` 写它，扫描不动。
+       *
+       * 为什么不能用 `head` 顶替：`head` 被扫描和发布轮流覆盖（扫描前落存一版、发布后又挪一版），
+       * 它回答的是「清单绑在哪个 commit 上」，回答不了「上次发布是哪一版」。
+       *
+       * 缺席 = 这个 persona 还从没发布过，没有线上版本可比，软扫退硬扫。
+       */
+      releasedHead: external_exports.string().min(1).optional(),
+      /**
+       * 这次**实际**怎么扫的。是结果不是入参——`deploy:start` 收到的 mode 可能因为没有可比的
+       * 基准而退成硬扫，页面要显示的是真正发生的那个。
+       *
+       * `.default('hard')` 而不是必填：这个文件是 strict 解析的，存量记录没有这个字段，
+       * 定成必填会让 `readScan` 当场抛、上云页面直接打不开。而老记录确实都是从零扫的。
+       */
+      baseKind: ScanBaseKindSchema.default("hard"),
+      /** 软扫比的那个 commit（= `releasedHead`）。硬扫时缺席 */
+      base: external_exports.string().min(1).optional(),
       startedAt: external_exports.number(),
       finishedAt: external_exports.number().optional(),
       error: external_exports.string().optional()
@@ -6139,6 +6161,13 @@ var init_deploy_schemas = __esm({
     DeployPersonaArgsSchema = external_exports.object({
       personaId: external_exports.string().min(1)
     }).strict();
+    DeployStartArgsSchema = DeployPersonaArgsSchema.extend({
+      /**
+       * 缺省 soft。真正用哪一档由 daemon 定（软扫比不了时会退硬扫），结果看 `DeployScan.baseKind`。
+       * 复用上面那个中央定义的字面量，不在这里手抄一份。
+       */
+      mode: ScanBaseKindSchema.optional()
+    }).strict();
     DeployPatchArgsSchema = external_exports.object({
       personaId: external_exports.string().min(1),
       patch: external_exports.object({
@@ -55466,6 +55495,11 @@ async function listSecrets(exec, dir) {
     return { env: x.name, ...Number.isFinite(at2) ? { setAt: at2 } : {} };
   });
 }
+async function hasCommit(exec, dir, sha) {
+  if (!sha) return false;
+  const r = await git(exec, dir, ["cat-file", "-e", `${sha}^{commit}`]);
+  return !r.spawnError && r.code === 0;
+}
 async function commitAndPush(exec, args) {
   await mustGit(exec, args.dir, ["add", "-A"], "\u6682\u5B58\u6587\u4EF6");
   const staged = await git(exec, args.dir, ["diff", "--cached", "--quiet"]);
@@ -55489,6 +55523,17 @@ async function release(exec, args) {
   return { sha, actionsUrl: `https://github.com/${repoSlug(info.url)}/actions` };
 }
 
+// src/deploy/scan-base.ts
+function pickScanBase(args) {
+  if (args.mode === "hard") return { kind: "hard" };
+  if (!args.hasUsableManifest || !args.releasedHead) return { kind: "hard" };
+  return { kind: "soft", base: args.releasedHead };
+}
+var SCAN_BASE_LABEL = {
+  hard: "\u786C\u626B",
+  soft: "\u8F6F\u626B"
+};
+
 // src/deploy/run-status.ts
 init_protocol();
 var TIMEOUT_MS = 8e3;
@@ -55701,7 +55746,7 @@ function buildDeployHandlers(deps) {
   });
   const start = async (frame, _client, ctx) => {
     ensureOwner(ctx);
-    const { personaId: personaId2 } = parseArgs2(DeployPersonaArgsSchema, frame, "deploy:start");
+    const { personaId: personaId2, mode } = parseArgs2(DeployStartArgsSchema, frame, "deploy:start");
     const dir = mustPersona(personaId2);
     const wrong = wrongEngine(deps.personaEngine(personaId2)?.tool);
     if (wrong) throw invalid(wrong);
@@ -55724,11 +55769,35 @@ function buildDeployHandlers(deps) {
       throw toClawdError(err);
     }
     runCache.delete(personaId2);
-    await writeDeployFile(dir, emptyDeployFile());
+    const prevManifest = await readDeployFile(dir).catch(() => void 0);
+    const scanBase = pickScanBase({
+      mode,
+      // **文件在 ≠ 清单能用**：硬扫一开头就写了一份空清单，那一轮没跑完（OTA 重启 / butler 崩，
+      // 见 scan-task.ts 的收尾判定）的话文件在、内容是空的。所以判据连上「上一轮扫完了」。
+      hasUsableManifest: prevManifest !== void 0 && current?.status === "done",
+      releasedHead: await hasCommit(deps.exec, dir, current?.releasedHead) ? current?.releasedHead : void 0
+    });
+    if (scanBase.kind === "hard") await writeDeployFile(dir, emptyDeployFile());
     const startedAt = deps.now();
-    const base = { evidence: [], notes: [], scannedAssets: [], startedAt, head };
+    const base = {
+      evidence: scanBase.kind === "hard" ? [] : current?.evidence ?? [],
+      // notes 反过来不沿用：它是「这次扫描要老板判断的事」，沿用会把上次的存疑项一直复读
+      notes: [],
+      scannedAssets: [],
+      startedAt,
+      head,
+      // 发布记的那个 commit 跟扫描无关，原样带过去，别让重扫把软扫的基准弄丢。
+      //
+      // **哪怕上面 hasCommit 刚判定它已经不在仓库里，也照样留着**：探测失败也包括 git 没跑起来
+      // 这种一过性情况，据此把它抹掉就等于「一次 git 抽风 → 永久失去软扫，直到下次发布」，
+      // 比留一个死 sha 糟得多。留着的代价只是 UI 上「从零重扫」多显示一阵子（那期间两个按钮
+      // 都退硬扫、行为一致不出错），下次发布就自愈。
+      ...current?.releasedHead ? { releasedHead: current.releasedHead } : {},
+      baseKind: scanBase.kind,
+      ...scanBase.base ? { base: scanBase.base } : {}
+    };
     await writeScan(dir, { status: "scanning", ...base });
-    const started = deps.startScan(personaId2);
+    const started = deps.startScan(personaId2, scanBase);
     if ("sessionId" in started) {
       await writeScan(dir, { status: "scanning", scanSessionId: started.sessionId, ...base });
     } else {
@@ -55856,7 +55925,7 @@ function buildDeployHandlers(deps) {
       const result = await release(deps.exec, { dir, now: deps.now });
       runCache.delete(personaId2);
       const scanned = await readScan(dir);
-      if (scanned) await writeScan(dir, { ...scanned, head: result.sha });
+      if (scanned) await writeScan(dir, { ...scanned, head: result.sha, releasedHead: result.sha });
       return { response: { type: "deploy:release", ...result } };
     } catch (err) {
       throw toClawdError(err);
@@ -65534,7 +65603,7 @@ function computeMethodAccess(args) {
 }
 
 // src/version.ts
-var version = "0.2.490".length > 0 ? "0.2.490" : "dev";
+var version = "0.2.492".length > 0 ? "0.2.492" : "dev";
 
 // src/cli-probe/probe.ts
 var fs72 = __toESM(require("fs"), 1);
@@ -70747,14 +70816,24 @@ async function startDaemon(config) {
     exec: runCommand,
     org: PERSONA_REPO_ORG,
     now: () => Date.now(),
-    startScan: (personaId2) => {
+    startScan: (personaId2, scanBase) => {
       const assetLines = SCANNABLE_ASSETS.map(
         (a) => `  - ${a.name}${a.path ? `\uFF08${a.path(config.dataDir)}\uFF09` : ""}\uFF1A${a.what}`
       ).join("\n");
+      const baseLines = scanBase.base ? [
+        `\u672C\u6B21\u662F**${SCAN_BASE_LABEL[scanBase.kind]}**\uFF1A\u53EA\u770B\u8DDF\u7EBF\u4E0A\u6B63\u8DD1\u90A3\u7248\u7684\u5DEE\u522B\uFF0C`,
+        `\u90A3\u4E00\u7248\u662F commit ${scanBase.base}\u3002`,
+        `\u5148\u5728 persona \u76EE\u5F55\u8DD1 \`git diff --name-only ${scanBase.base} -- .\` \u62FF\u5230\u6539\u52A8\u6E05\u5355\uFF0C`,
+        "\u53EA\u91CD\u770B\u8FD9\u4E9B\u6587\u4EF6\uFF08\u53CA\u5B83\u4EEC\u5F15\u51FA\u53BB\u7684\u90A3\u4E00\u8DF3\uFF09\uFF0C\u6E05\u5355\u91CC\u5176\u4F59\u6761\u76EE\u539F\u6837\u7559\u7740\u4E0D\u7528\u91CD\u62A5\u3002"
+      ] : [
+        `\u672C\u6B21\u662F**${SCAN_BASE_LABEL[scanBase.kind]}**\uFF1A\u4ECE\u96F6\u628A persona \u6574\u4E2A\u8BFB\u4E00\u904D\uFF0C\u6E05\u5355\u662F\u7A7A\u7684\u3002`
+      ];
       const prompt = [
         `\u626B\u63CF persona\u300C${personaId2}\u300D\u7684\u90E8\u7F72\u73AF\u5883\uFF0CpersonaId=${personaId2}\u3002`,
         "",
         `persona \u76EE\u5F55\uFF1A${personaStore.personaDirPath(personaId2)}`,
+        ...baseLines,
+        "",
         "\u53EF\u4EE5\u58F0\u660E\u7684 persona \u76EE\u5F55\u4E4B\u5916\u7684\u5171\u4EAB\u8D44\u4EA7\uFF08\u7528\u5230\u54EA\u6761\u5C31\u62A5\u54EA\u6761\uFF09\uFF1A",
         assetLines || "  \uFF08\u65E0\uFF09",
         "",

package/dist/dispatch/mcp-server.cjs

@@ -21353,6 +21353,8 @@ var DeployFileSchema = external_exports.object({
   version: external_exports.literal(1),
   manifest: EnvironmentManifestSchema
 }).strict();
+var SCAN_BASE_KINDS = ["hard", "soft"];
+var ScanBaseKindSchema = external_exports.enum(SCAN_BASE_KINDS);
 var DeployScanStatusSchema = external_exports.enum(["scanning", "done", "failed"]);
 var DeployScanSchema = external_exports.object({
   /** 干这次扫描的 butler 会话，「看它怎么干的」入口 */
@@ -21372,6 +21374,26 @@ var DeployScanSchema = external_exports.object({
    * 缺席 = 旧版 clawd 扫的记录。**一律当过时**：没有第三种情况，重扫一次就有了。
    */
   head: external_exports.string().min(1).optional(),
+  /**
+   * 上次**发布**推的那个 commit ——「线上正跑的是哪一版」在本机唯一的答案，
+   * 也就是软扫的基准。只有 `deploy:release` 写它，扫描不动。
+   *
+   * 为什么不能用 `head` 顶替：`head` 被扫描和发布轮流覆盖（扫描前落存一版、发布后又挪一版），
+   * 它回答的是「清单绑在哪个 commit 上」，回答不了「上次发布是哪一版」。
+   *
+   * 缺席 = 这个 persona 还从没发布过，没有线上版本可比，软扫退硬扫。
+   */
+  releasedHead: external_exports.string().min(1).optional(),
+  /**
+   * 这次**实际**怎么扫的。是结果不是入参——`deploy:start` 收到的 mode 可能因为没有可比的
+   * 基准而退成硬扫，页面要显示的是真正发生的那个。
+   *
+   * `.default('hard')` 而不是必填：这个文件是 strict 解析的，存量记录没有这个字段，
+   * 定成必填会让 `readScan` 当场抛、上云页面直接打不开。而老记录确实都是从零扫的。
+   */
+  baseKind: ScanBaseKindSchema.default("hard"),
+  /** 软扫比的那个 commit（= `releasedHead`）。硬扫时缺席 */
+  base: external_exports.string().min(1).optional(),
   startedAt: external_exports.number(),
   finishedAt: external_exports.number().optional(),
   error: external_exports.string().optional()
@@ -21437,6 +21459,13 @@ var DeployReleaseResultSchema = external_exports.object({
 var DeployPersonaArgsSchema = external_exports.object({
   personaId: external_exports.string().min(1)
 }).strict();
+var DeployStartArgsSchema = DeployPersonaArgsSchema.extend({
+  /**
+   * 缺省 soft。真正用哪一档由 daemon 定（软扫比不了时会退硬扫），结果看 `DeployScan.baseKind`。
+   * 复用上面那个中央定义的字面量，不在这里手抄一份。
+   */
+  mode: ScanBaseKindSchema.optional()
+}).strict();
 var DeployPatchArgsSchema = external_exports.object({
   personaId: external_exports.string().min(1),
   patch: external_exports.object({

package/dist/persona-defaults/persona-clawd-butler/.claude/skills/scan-persona-for-deploy/SKILL.md

@@ -5,10 +5,39 @@ description: 老板要把某个 persona 发布到云上时触发——把这个
 
 # 扫 persona 的上云环境
 
-老板在界面上点了「发布到云上」，现在这个 persona 的部署文件（`.clawd/deploy.json`，会随 persona
-一起进 git 仓库）还是空的，等着你填。**页面是随你干活一点点长出来的**——他正看着，你查明白一条
+老板在界面上点了「发布到云上」，这个 persona 的部署文件（`.clawd/deploy.json`，会随 persona
+一起进 git 仓库）等着你填。**页面是随你干活一点点长出来的**——他正看着，你查明白一条
 就报一条，别攒到最后一次性倒出来。
 
+## 先看这次是硬扫还是软扫
+
+**任务里会写明，照它做，不要自己另判。** 是硬是软由 daemon 定（它知道线上正跑的是哪一版、
+那个 commit 还在不在、清单读不读得出来），你手上那份记录看不出这些。
+
+| 档 | 任务里会说 | 你要做什么 |
+|---|---|---|
+| **硬扫** | 「从零把 persona 整个读一遍」 | 清单是空的，从零填 |
+| **软扫** | 「只看跟线上正跑那版的差别，那一版是 commit `<sha>`」 | 在**已有清单**上打补丁 |
+
+软扫的第一件事，在 persona 目录里跑：
+
+```
+git diff --name-only <任务里给的 sha> -- .
+```
+
+拿到的就是要重看的文件——**这就是「线上那版跟现在」的全部差别**。清单里其余条目原样有效，
+不用重报：重报没变的东西不但白花时间，还会让本来稳定的字段（比如凭据的命名引用）无谓地变来变去。
+
+两件最容易做错的事：
+
+- **改动列表是空的，不等于没活干。** 老板点了重扫，页面正卡在「分析中」，你照样要走到收尾那步
+  调 `deploy:finishScan`，只是中间什么都不用报。
+- **diff 给的是入口，不是边界。** 改的可能只是 `CLAUDE.md` 里一行命令，而那行命令背后的脚本
+  带着一整串工具依赖。**改动文件引出去的那一跳照样要跟**，规则同下面「读什么」那节。
+
+两档都一样：任务里列出的**共享资产都要照判据过一遍**——那部分判据就写在任务里，不用读
+persona 目录，很便宜，漏了的话资产进不了镜像，容器里那条能力就是空的。
+
 ## 你要回答的问题
 
 这个 persona 如果被搬到一台**干净的 Linux 容器**里跑（没有任何人的 home 目录、没有预装工具、
@@ -134,6 +163,30 @@ call({ method: "deploy:reportFinding", args: {
 
 ## 收尾
 
+### 先删掉不该再在清单里的条目（只有软扫需要）
+
+`deploy:reportFinding` 只会新增和覆盖，**删不掉东西**。硬扫不用管——清单本来就是空的重填。
+软扫下清单是上一轮留下来的，如果线上那版之后**删掉了某个依赖的来源**（skill 被删了、脚本不再
+调那个工具、`.mcp.json` 里那个 server 撤了），那条会一直赖在清单里：镜像继续装没用的东西，
+如果是凭据还会一直拦着老板发布。
+
+确认某条该删，就在 `finishScan` **之前**调一次，交出**完整**的 manifest（不是只交要删的）：
+
+```
+call({ method: "deploy:patch", args: {
+  personaId: "<任务里给的>",
+  patch: { manifest: { version: 1, clis: [...], secrets: [...], assets: [...], connectors: [...] } }
+}})
+```
+
+先把 `.clawd/deploy.json` 读出来，去掉该去的那几条，其余原样带上。**没有要删的就别调**——
+整份改写是有风险的动作，没必要时不做。
+
+判「该删」要有依据：来源文件在这次 diff 里被删了，或者你读了改动后的文件、确认它不再引用那个
+东西。**光是「这次没重报它」不是依据**——软扫下没重报是常态。
+
+### 然后收尾
+
 全部查完，调一次：
 
 ```