@clawos-dev/clawd 0.2.468 → 0.2.469

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -21385,6 +21385,16 @@ var DeployReceiptSchema = external_exports.object({
21385
21385
  evidence: external_exports.array(EnvEvidenceSchema).optional(),
21386
21386
  smokeTask: external_exports.string().optional(),
21387
21387
  notes: external_exports.array(external_exports.string()).default([]),
21388
+ /**
21389
+ * 这次扫描**被告知有哪些共享资产**(daemon 的 `SCANNABLE_ASSETS` 在 finishScan 那一刻的名单)。
21390
+ *
21391
+ * 记它是为了回答一个只有它答得了的问题:「这张单据是不是用还不知道某个资产的扫描器扫的」。
21392
+ * 没有它就只能拿「当前资产表 ⊄ 单据的 assets」当判据——而一个 persona 本来就可能真的用不到
21393
+ * 某个资产,那会变成对每张单据的常态唠叨。
21394
+ *
21395
+ * 缺席 = M1b 及以前扫的老单据(那时候扫描器只被告知了 deploy-kit 一条)。
21396
+ */
21397
+ scannedAssets: external_exports.array(external_exports.string()).optional(),
21388
21398
  /**
21389
21399
  * 每条凭据的履约选择:secret name → 'deployer' | 'user'。
21390
21400
  * **只记「谁出」,不记值。** 没做选择的凭据不在这个 map 里(缺席即未定),
@@ -64,6 +64,16 @@ call({ method: "deploy:reportFinding", args: {
64
64
 
65
65
  版本:拿得准精确版本填 `version`,只知道下限填 `min`,都不确定就都不填。**不要猜版本号**。
66
66
 
67
+ **`.mcp.json` 里 `npx` / `uvx` 现拉现跑的 MCP server,也要报一条 `cli`。** 它看着像一条配置
68
+ 不像一个命令行工具,但语义是一样的:容器里没有这个包时,MCP 首次启动要连 registry 现拉,
69
+ 离线或抖动就直接起不来,persona 少一整块能力。所以它必须预装进镜像。
70
+
71
+ - `name` 写它装完**落在 PATH 上的可执行名**,常常跟包名不一样——
72
+ `@aliyun-rds/supabase-mcp-server` 的 bin 是 `supabase-mcp`。名字拿不准就去看那个包的
73
+ `package.json` 的 `bin` 字段(或官方文档),别拿包名顶上。
74
+ - `from` 写 `npm:<完整包名>`(`npm:@aliyun-rds/supabase-mcp-server`)。
75
+ - `evidence.quote` 引 `.mcp.json` 里那两行 `"command": "npx"` / `"args": [...]` 就够。
76
+
67
77
  ### kind: "secret" —— 需要的凭据
68
78
 
69
79
  `item` 字段:`name`(命名引用,短横线小写)、`env`(字符串数组,这份凭据要落进哪些环境变量)。
@@ -75,10 +85,19 @@ call({ method: "deploy:reportFinding", args: {
75
85
 
76
86
  ### kind: "asset" —— persona 目录之外的共享资产
77
87
 
78
- `item` 字段只有 `name`。任务里列的共享资产里,这个 persona 确实用到的才报。
88
+ `item` 字段只有 `name`。任务里会把可以声明的资产**逐条列出来,每条带一句判据**;
89
+ 照那句判据看这个 persona 用没用到,用到才报。
79
90
 
80
91
  资产是从本机整包带走的,**没有「装法」这回事**,不要给它编 `from`。
81
92
 
93
+ 两件容易漏的:
94
+
95
+ - **有的资产在盘上没有可读的路径**(比如 daemon 自己的构建产物)。任务里给了路径的可以读进去
96
+ 查证,没给路径的照判据判——**不能因为「读不到就当它不存在」而不报**:没报的资产不会进镜像,
97
+ 容器里那条能力就是空的。
98
+ - 判据往往落在「这个动作在云上由谁提供」。persona 在本机走 daemon 提供的 MCP 干的活,
99
+ 云上容器里没有 daemon,靠的就是那份随行资产。
100
+
82
101
  ### evidence —— 每条的来历
83
102
 
84
103
  - `reason`:**一句人话**,说清「为什么需要它 + 你从哪看出来的」,写给不熟悉这个 persona 的人看。