@aiti-ai/ext-shared 0.0.0-stage → 0.1.11

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.
Files changed (131) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +36 -2
  3. package/agent-accounts.test.mjs +227 -0
  4. package/agent-accounts.ts +324 -0
  5. package/agent-capability-contract.test.mjs +129 -0
  6. package/agent-interaction.test.mjs +194 -0
  7. package/agent-interaction.ts +340 -0
  8. package/agent-launch.test.mjs +262 -0
  9. package/agent-spawn-env.test.mjs +169 -0
  10. package/agent-spawn-env.ts +548 -0
  11. package/aiti-editor-inject.mjs +49 -0
  12. package/backend-queue.test.mjs +336 -0
  13. package/backend-queue.ts +469 -0
  14. package/blob-save-route.ts +128 -0
  15. package/cbc-model-catalog.ts +86 -0
  16. package/check-client.mjs +273 -0
  17. package/check-ext-globals.mjs +144 -0
  18. package/controlled-login-dialog.mjs +270 -0
  19. package/controlled-login.mjs +398 -0
  20. package/controlled-login.test.mjs +466 -0
  21. package/convert-saveas.test.mjs +39 -0
  22. package/convert-saveas.ts +170 -0
  23. package/copy-client-bundle.mjs +39 -0
  24. package/cursor-cli-store.ts +377 -0
  25. package/dedupe-fetch.test.mjs +71 -0
  26. package/dedupe-fetch.ts +58 -0
  27. package/deploy-commit.mjs +52 -0
  28. package/dev-pack.mjs +246 -0
  29. package/dock-icons.ts +127 -0
  30. package/esbuild-bin.test.mjs +53 -0
  31. package/esbuild-bin.ts +66 -0
  32. package/exec-async.test.mjs +86 -0
  33. package/exec-async.ts +179 -0
  34. package/ext-display-names.ts +91 -0
  35. package/ext-entry-contracts.test.mjs +131 -0
  36. package/ext-float-dock-core.test.mjs +348 -0
  37. package/ext-float-dock-core.ts +783 -0
  38. package/ext-float-dock-lite.ts +52 -0
  39. package/ext-float-dock.test.mjs +286 -0
  40. package/ext-float-dock.ts +740 -0
  41. package/ext-icons-deploy.mjs +24 -0
  42. package/ext-lazy.test.mjs +186 -0
  43. package/ext-lazy.tsx +183 -0
  44. package/ext-model-state.test.mjs +272 -0
  45. package/ext-model-state.ts +324 -0
  46. package/ext-protocol.mjs +113 -0
  47. package/ext-protocol.test.mjs +88 -0
  48. package/ext-session-usage.test.mjs +219 -0
  49. package/ext-session-usage.ts +507 -0
  50. package/external-cli-governance.ts +153 -0
  51. package/git-ops-client/api.mjs +56 -0
  52. package/git-ops-client/branch-panel.tsx +987 -0
  53. package/git-ops-client/i18n.mjs +328 -0
  54. package/host-tools-allow.test.mjs +46 -0
  55. package/host-tools-allow.ts +84 -0
  56. package/icons/alert.svg +1 -0
  57. package/icons/bookmark.svg +1 -0
  58. package/icons/bot.svg +1 -0
  59. package/icons/chart-column.svg +1 -0
  60. package/icons/check-circle.svg +1 -0
  61. package/icons/clipboard-list.svg +1 -0
  62. package/icons/clock.svg +1 -0
  63. package/icons/coffee.svg +1 -0
  64. package/icons/edit.svg +1 -0
  65. package/icons/eye.svg +1 -0
  66. package/icons/git-branch.svg +1 -0
  67. package/icons/git-commit-horizontal.svg +1 -0
  68. package/icons/globe.svg +1 -0
  69. package/icons/history.svg +1 -0
  70. package/icons/import.svg +1 -0
  71. package/icons/inbox.svg +1 -0
  72. package/icons/key-round.svg +1 -0
  73. package/icons/layout-grid.svg +1 -0
  74. package/icons/mail.svg +1 -0
  75. package/icons/message-circle.svg +1 -0
  76. package/icons/message-square.svg +1 -0
  77. package/icons/meter-vertical.svg +1 -0
  78. package/icons/mic.svg +1 -0
  79. package/icons/monitor.svg +1 -0
  80. package/icons/pen-line.svg +1 -0
  81. package/icons/plug.svg +1 -0
  82. package/icons/radio-dot.svg +1 -0
  83. package/icons/radio.svg +1 -0
  84. package/icons/refresh.svg +1 -0
  85. package/icons/rocket.svg +1 -0
  86. package/icons/search.svg +1 -0
  87. package/icons/shield.svg +1 -0
  88. package/icons/sparkles.svg +1 -0
  89. package/icons/square-kanban.svg +1 -0
  90. package/icons/terminal.svg +1 -0
  91. package/icons/users.svg +1 -0
  92. package/icons/volume-2.svg +1 -0
  93. package/icons/wand.svg +1 -0
  94. package/icons/wrench.svg +1 -0
  95. package/icons/x-circle.svg +1 -0
  96. package/icons/x.svg +1 -0
  97. package/ignore-semantics.ts +76 -0
  98. package/lazy-loading-metrics.mjs +61 -0
  99. package/new-session-cwd.test.mjs +389 -0
  100. package/new-session-cwd.ts +253 -0
  101. package/open-viewer-window.ts +65 -0
  102. package/overlay-back-client.test.mjs +123 -0
  103. package/overlay-back-client.ts +87 -0
  104. package/package.json +65 -4
  105. package/pi-fork-rpc/README.md +12 -0
  106. package/pi-fork-rpc/cli-resolve.test.mjs +42 -0
  107. package/pi-fork-rpc/cli-resolve.ts +79 -0
  108. package/pi-fork-rpc/remote-queue.test.mjs +100 -0
  109. package/pi-fork-rpc/remote-queue.ts +140 -0
  110. package/pi-fork-rpc/spec.ts +106 -0
  111. package/pi-fork-rpc/wire.test.mjs +260 -0
  112. package/pi-fork-rpc/wire.ts +367 -0
  113. package/popup-anchor.ts +45 -0
  114. package/provider-priority-contract.test.mjs +55 -0
  115. package/reconcile-deps.mjs +41 -0
  116. package/reload-instances.mjs +60 -0
  117. package/seed-tool.test.mjs +95 -0
  118. package/seed-tool.ts +88 -0
  119. package/session-recycle.ts +109 -0
  120. package/shared-copy-sync.test.mjs +115 -0
  121. package/soffice-locate.ts +171 -0
  122. package/soffice-panel.ts +239 -0
  123. package/sync-dir.mjs +91 -0
  124. package/sync-dir.test.mjs +101 -0
  125. package/sync-gate.test.mjs +93 -0
  126. package/sync-mirror.test.mjs +85 -0
  127. package/task-list.test.mjs +91 -0
  128. package/task-list.ts +118 -0
  129. package/test-rm-rf.mjs +33 -0
  130. package/ui-dialogs.test.mjs +198 -0
  131. package/ui-dialogs.ts +310 -0
@@ -0,0 +1,262 @@
1
+ /**
2
+ * agent-launch 单测 —— _shared/agent-spawn-env.ts 的 P0 launch 解析层
3
+ * (resolveCliLaunch / parseArgsLines / parseCustomAgents / spawn.command / spawn.argsPrefix)。
4
+ *
5
+ * 覆盖 docs/aiti-custom-agent-plan.md §3.3 合并规则:
6
+ * command 覆盖、argv 拼装、$VAR/${cwd} 展开(未定义=空串+warning)、
7
+ * env 合并优先级(基底 < 自动 bridge < 成员 env)、bridge 四档重写、
8
+ * agents.json 校验(非法跳过/去重/行式 env 兼容)。
9
+ *
10
+ * Run: node --experimental-strip-types --test pi-web-ext/_shared/agent-launch.test.mjs
11
+ */
12
+ import { test } from "node:test";
13
+ import assert from "node:assert/strict";
14
+ import {
15
+ resolveCliLaunch,
16
+ parseArgsLines,
17
+ parseCustomAgents,
18
+ parseEnvList,
19
+ spawnCommand,
20
+ spawnArgsPrefix,
21
+ spawnCommandFeature,
22
+ spawnArgsPrefixFeature,
23
+ captureSpawnEnvFeatures,
24
+ } from "./agent-spawn-env.ts";
25
+
26
+ const PROC_ENV = { PORT: "30142", PI_WEB_BASE_PATH: "/dev", HOME: "/home/pi", PATH: "/usr/bin" };
27
+
28
+ test("resolveCliLaunch:缺省 command=defaultCommand,args=[...prefix, ...driverArgs]", () => {
29
+ const r = resolveCliLaunch({
30
+ defaultCommand: "claude",
31
+ argsPrefix: ["wrap", "-i"],
32
+ driverArgs: ["-p", "--verbose"],
33
+ processEnv: PROC_ENV,
34
+ });
35
+ assert.equal(r.command, "claude");
36
+ assert.deepEqual(r.args, ["wrap", "-i", "-p", "--verbose"]);
37
+ assert.equal(r.warnings.length, 0);
38
+ });
39
+
40
+ test("resolveCliLaunch:command 覆盖生效(driverArgs 不含原 CLI 名由调用方保证)", () => {
41
+ const r = resolveCliLaunch({
42
+ defaultCommand: "claude",
43
+ command: "docker",
44
+ argsPrefix: ["run", "--rm"],
45
+ driverArgs: ["-p"],
46
+ processEnv: PROC_ENV,
47
+ });
48
+ assert.equal(r.command, "docker");
49
+ assert.deepEqual(r.args, ["run", "--rm", "-p"]);
50
+ assert.equal(r.warnings.length, 0);
51
+ });
52
+
53
+ test("resolveCliLaunch:generic 路径自动注入 AITI_BRIDGE_URL(本机实例推导)", () => {
54
+ const r = resolveCliLaunch({ defaultCommand: "job", processEnv: PROC_ENV });
55
+ assert.equal(r.env.AITI_BRIDGE_URL, "http://127.0.0.1:30142/dev/api/extensions/aiti-devtools");
56
+ });
57
+
58
+ test("resolveCliLaunch:显式 env 已带 AITI_BRIDGE_URL 则保持(不重复注入)", () => {
59
+ const r = resolveCliLaunch({
60
+ defaultCommand: "claude",
61
+ env: { AITI_BRIDGE_URL: "http://10.0.0.9:1/x", ONLY_THIS: "1" },
62
+ processEnv: PROC_ENV,
63
+ });
64
+ assert.equal(r.env.AITI_BRIDGE_URL, "http://10.0.0.9:1/x");
65
+ assert.equal(r.env.ONLY_THIS, "1");
66
+ assert.equal(r.env.PORT, undefined, "显式 env 是基底,不混入 processEnv");
67
+ });
68
+
69
+ test("resolveCliLaunch:$VAR / ${cwd} 展开(argsPrefix + memberEnv;工作 env 优先)", () => {
70
+ const r = resolveCliLaunch({
71
+ defaultCommand: "docker",
72
+ argsPrefix: ["-v", "${cwd}:${cwd}", "-w", "${cwd}", "-e", "K=$PORT"],
73
+ memberEnv: { WORK: "${cwd}/x", FROM_ENV: "$HOME/y" },
74
+ processEnv: PROC_ENV,
75
+ cwd: "/tmp/proj",
76
+ });
77
+ assert.deepEqual(r.args, ["-v", "/tmp/proj:/tmp/proj", "-w", "/tmp/proj", "-e", "K=30142"]);
78
+ assert.equal(r.env.WORK, "/tmp/proj/x");
79
+ assert.equal(r.env.FROM_ENV, "/home/pi/y");
80
+ assert.equal(r.warnings.length, 0);
81
+ });
82
+
83
+ test("resolveCliLaunch:成员 env 覆盖基底 env(最高优先)", () => {
84
+ const r = resolveCliLaunch({
85
+ defaultCommand: "x",
86
+ env: { A: "base", B: "base" },
87
+ memberEnv: { A: "member", REF: "$B/2" },
88
+ processEnv: PROC_ENV,
89
+ });
90
+ assert.equal(r.env.A, "member");
91
+ assert.equal(r.env.B, "base");
92
+ assert.equal(r.env.REF, "base/2", "成员 env 引用先取工作 env 当前值");
93
+ });
94
+
95
+ test("resolveCliLaunch:未定义引用 → 空串 + warning(argsPrefix 与 memberEnv 各记一条)", () => {
96
+ const r = resolveCliLaunch({
97
+ defaultCommand: "x",
98
+ argsPrefix: ["$NOPE_1"],
99
+ memberEnv: { E: "$NOPE_2" },
100
+ processEnv: PROC_ENV,
101
+ });
102
+ assert.equal(r.args[0], "");
103
+ assert.equal(r.env.E, "");
104
+ assert.equal(r.warnings.length, 2);
105
+ assert.ok(r.warnings.some((w) => w.includes("$NOPE_1")));
106
+ assert.ok(r.warnings.some((w) => w.includes("$NOPE_2")));
107
+ });
108
+
109
+ test("resolveCliLaunch:bridge=host.docker.internal 替换主机保留端口路径", () => {
110
+ const r = resolveCliLaunch({
111
+ defaultCommand: "claude",
112
+ env: { AITI_BRIDGE_URL: "http://127.0.0.1:30142/dev/api/extensions/aiti-devtools" },
113
+ bridge: "host.docker.internal",
114
+ processEnv: PROC_ENV,
115
+ });
116
+ assert.equal(r.env.AITI_BRIDGE_URL, "http://host.docker.internal:30142/dev/api/extensions/aiti-devtools");
117
+ });
118
+
119
+ test("resolveCliLaunch:bridge=off 移除;显式 URL 直接采用(支持 ${cwd})", () => {
120
+ const off = resolveCliLaunch({ defaultCommand: "x", bridge: "off", processEnv: PROC_ENV });
121
+ assert.equal("AITI_BRIDGE_URL" in off.env, false);
122
+ const url = resolveCliLaunch({
123
+ defaultCommand: "x",
124
+ bridge: "http://bridge.local:8777",
125
+ memberEnv: { HINT: "$AITI_BRIDGE_URL" },
126
+ processEnv: PROC_ENV,
127
+ });
128
+ assert.equal(url.env.AITI_BRIDGE_URL, "http://bridge.local:8777");
129
+ assert.equal(url.env.HINT, "http://127.0.0.1:30142/dev/api/extensions/aiti-devtools",
130
+ "成员 env 在 bridge 重写前展开,看到的是重写前值(自动注入默认)");
131
+ });
132
+
133
+ test("resolveCliLaunch:非法 bridge 模式按 inherit + warning;warn 回调与返回值双通道", () => {
134
+ const viaCb = [];
135
+ const r = resolveCliLaunch({
136
+ defaultCommand: "x",
137
+ bridge: "kubernetes",
138
+ processEnv: PROC_ENV,
139
+ warn: (m) => viaCb.push(m),
140
+ });
141
+ assert.equal(r.env.AITI_BRIDGE_URL, "http://127.0.0.1:30142/dev/api/extensions/aiti-devtools");
142
+ assert.equal(r.warnings.length, 1);
143
+ assert.equal(viaCb.length, 1);
144
+ });
145
+
146
+ test("parseArgsLines:每行一个参数,注释/空行忽略,$VAR 不在此展开", () => {
147
+ const { args, warnings } = parseArgsLines("run\n --rm \n# comment\n\n-i\n$HOME");
148
+ assert.deepEqual(args, ["run", "--rm", "-i", "$HOME"]);
149
+ assert.equal(warnings.length, 0);
150
+ });
151
+
152
+ test("parseCustomAgents:合法条目全字段规整(默认值补齐 + target 透传)", () => {
153
+ const { agents, warnings } = parseCustomAgents({
154
+ agents: [
155
+ {
156
+ id: "claude-docker",
157
+ label: "Claude Code (Docker)",
158
+ command: "docker",
159
+ argsPrefix: "run\n--rm\n-i",
160
+ env: { FOO: "bar" },
161
+ bridge: "host.docker.internal",
162
+ target: "claude-code",
163
+ order: "50",
164
+ },
165
+ ],
166
+ });
167
+ assert.equal(warnings.length, 0);
168
+ assert.deepEqual(agents, [{
169
+ id: "claude-docker",
170
+ label: "Claude Code (Docker)",
171
+ driver: "generic",
172
+ command: "docker",
173
+ argsPrefix: ["run", "--rm", "-i"],
174
+ env: { FOO: "bar" },
175
+ bridge: "host.docker.internal",
176
+ target: "claude-code",
177
+ probe: "",
178
+ order: 50,
179
+ enabled: true,
180
+ }]);
181
+ assert.deepEqual(parseCustomAgents({ agents: [{ id: "t2", label: "T", command: "c" }] }).agents[0].target, "",
182
+ "缺省 target 空串");
183
+ });
184
+
185
+ test("parseCustomAgents:JSON 字符串输入 + 行式 env 兼容(KEY=VALUE / -NAME)", () => {
186
+ const { agents, warnings } = parseCustomAgents(JSON.stringify({
187
+ agents: [{ id: "a1", label: "A", command: "cmd", env: "K=1\n-BAD\n# c" }],
188
+ }));
189
+ assert.equal(warnings.length, 0);
190
+ assert.deepEqual(agents[0].env, { K: "1" });
191
+ });
192
+
193
+ test("parseCustomAgents:非法 id / 重复 id / 缺 label / generic 缺 command / 非法 driver 逐条跳过;协议型缺 command 合法", () => {
194
+ const { agents, warnings } = parseCustomAgents({
195
+ agents: [
196
+ { id: "bad/slash", label: "X", command: "c" },
197
+ { id: "dup", label: "first", command: "c1" },
198
+ { id: "dup", label: "second", command: "c2" },
199
+ { id: "nolabel", command: "c" },
200
+ { id: "nocmd", label: "N" },
201
+ { id: "ok", label: "OK", command: "c" },
202
+ { id: "proto", label: "P", driver: "claude", command: "" },
203
+ { id: "baddriver", label: "B", command: "c", driver: "claude code!" },
204
+ ],
205
+ });
206
+ assert.equal(agents.length, 3);
207
+ assert.equal(agents[0].label, "first", "重复 id 先到先得");
208
+ assert.equal(agents[1].id, "ok");
209
+ assert.equal(agents[2].id, "proto", "协议型 driver 接受、command 可空(可解析性由注册侧裁决)");
210
+ assert.equal(warnings.length, 5);
211
+ });
212
+
213
+ test("parseCustomAgents:坏 JSON / agents 缺失 / 非数组 → 空配置 + warning 不抛错", () => {
214
+ assert.deepEqual(parseCustomAgents("{broken").agents, []);
215
+ assert.equal(parseCustomAgents("{broken").warnings.length, 1);
216
+ assert.deepEqual(parseCustomAgents({}).agents, []);
217
+ assert.deepEqual(parseCustomAgents({ agents: "nope" }).warnings.length, 1);
218
+ assert.deepEqual(parseCustomAgents(null).agents, []);
219
+ });
220
+
221
+ test("parseCustomAgents:非法变量名忽略 + enabled:false 保留 + argsPrefix 数组形态", () => {
222
+ const { agents, warnings } = parseCustomAgents({
223
+ agents: [{ id: "e1", label: "E", command: "c", env: { GOOD: "1", "1BAD": "x" }, enabled: false, argsPrefix: ["a", "b"] }],
224
+ });
225
+ assert.equal(warnings.length, 1);
226
+ assert.ok(warnings[0].includes("1BAD"));
227
+ assert.equal(agents[0].enabled, false);
228
+ assert.deepEqual(agents[0].argsPrefix, ["a", "b"]);
229
+ });
230
+
231
+ test("extman feature 读取:captureSpawnEnvFeatures 后 spawnCommand/spawnArgsPrefix 生效", () => {
232
+ captureSpawnEnvFeatures({
233
+ get: (extId, fid) => {
234
+ if (extId === "aiti-x-agent" && fid === "spawn.command") return "docker";
235
+ if (extId === "aiti-x-agent" && fid === "spawn.argsPrefix") return "run\n--rm";
236
+ return undefined;
237
+ },
238
+ });
239
+ try {
240
+ assert.equal(spawnCommand("aiti-x-agent"), "docker");
241
+ assert.equal(spawnArgsPrefix("aiti-x-agent"), "run\n--rm");
242
+ assert.equal(spawnCommand("aiti-other"), "");
243
+ } finally {
244
+ captureSpawnEnvFeatures(null);
245
+ }
246
+ });
247
+
248
+ test("extman feature 声明:spawn.command=string / spawn.argsPrefix=textlist,id 与读取对齐", () => {
249
+ const cmd = spawnCommandFeature("启动包装");
250
+ const pre = spawnArgsPrefixFeature("启动包装");
251
+ assert.equal(cmd.id, "spawn.command");
252
+ assert.equal(cmd.type, "string");
253
+ assert.equal(cmd.group, "启动包装");
254
+ assert.equal(pre.id, "spawn.argsPrefix");
255
+ assert.equal(pre.type, "textlist");
256
+ assert.ok(pre.description.includes("${cwd}"));
257
+ });
258
+
259
+ test("parseEnvList 回归:既有语义不受 launch 层新增影响", () => {
260
+ const { ops } = parseEnvList("A=$B");
261
+ assert.deepEqual(ops, [{ key: "A", value: "$B" }]);
262
+ });
@@ -0,0 +1,169 @@
1
+ /**
2
+ * agent-spawn-env 单测(node --test,直跑 TS:node ≥ 22.6 --experimental-strip-types)。
3
+ *
4
+ * 覆盖 parseEnvList/applyEnvList/resolveEnvList 全分支(含 -NAME 排除)、
5
+ * agentSpawnEnv 合并优先级(白名单 < 自动 bridge < 扩展注册 < 用户列表)、
6
+ * piWebSelfBase 推导(方案 docs/pi-web-ext-agent-spawn-env-plan.md 验证计划 §1)。
7
+ */
8
+ import { test } from "node:test";
9
+ import assert from "node:assert/strict";
10
+ // 复制同步模式下,测试权威源本体(副本由 sync 检查保证一致)
11
+ import {
12
+ piWebSelfBase,
13
+ bridgeEnv,
14
+ parseEnvList,
15
+ applyEnvList,
16
+ resolveEnvList,
17
+ agentSpawnEnv,
18
+ registerSpawnEnvDefaults,
19
+ spawnEnvList,
20
+ spawnEnvFeature,
21
+ captureSpawnEnvFeatures,
22
+ resolveCliLaunch,
23
+ } from "./agent-spawn-env.ts";
24
+
25
+ test("piWebSelfBase:PORT + PI_WEB_BASE_PATH 归一(尾斜杠剥除)", () => {
26
+ assert.equal(piWebSelfBase({ PORT: "30142", PI_WEB_BASE_PATH: "/dev/" }), "http://127.0.0.1:30142/dev");
27
+ assert.equal(piWebSelfBase({ PORT: "20341", PI_WEB_BASE_PATH: "" }), "http://127.0.0.1:20341");
28
+ assert.equal(piWebSelfBase({ PI_WEB_BASE_PATH: "/dev" }), "http://127.0.0.1:3000/dev", "缺 PORT 回落 3000");
29
+ });
30
+
31
+ test("bridgeEnv:端点带扩展路径签名", () => {
32
+ assert.equal(bridgeEnv({ PORT: "20341" }).AITI_BRIDGE_URL, "http://127.0.0.1:20341/api/extensions/aiti-devtools");
33
+ });
34
+
35
+ test("parseEnvList:设置/排除/注释/非法行", () => {
36
+ const { ops, warnings } = parseEnvList("A=1\n -B \n# c\nbroken\n1BAD=x\n-C=x");
37
+ assert.deepEqual(ops, [
38
+ { key: "A", value: "1" },
39
+ { key: "B", value: null },
40
+ ]);
41
+ assert.equal(warnings.length, 3, "broken / 1BAD=x / -C=x 各一条");
42
+ });
43
+
44
+ test("applyEnvList:$引用查工作 env 再回退 base;移除幂等;移除后可重设", () => {
45
+ const env = { HOME: "/h", GONE: "g" };
46
+ const { ops } = parseEnvList("A=$HOME/1\n-GONE\nB=$GONE\nGONE=again");
47
+ const warnings = [];
48
+ applyEnvList(ops, env, { base: { HOME: "/h" }, onWarning: (w) => warnings.push(w) });
49
+ assert.equal(env.A, "/h/1");
50
+ assert.equal("GONE" in env, true);
51
+ assert.equal(env.GONE, "again", "移除行之后可被后续行重新设置");
52
+ assert.equal(env.B, "", "引用时 GONE 已被移除且 base 无 → 空串 + warning");
53
+ assert.equal(warnings.length, 1);
54
+ });
55
+
56
+ test("resolveEnvList:列表内互引 b=$a 就地解析", () => {
57
+ const { env, warnings } = resolveEnvList("A=hello\nB=$A/world\nC=${A}-${B}");
58
+ assert.deepEqual(env, { A: "hello", B: "hello/world", C: "hello-hello/world" });
59
+ assert.equal(warnings.length, 0);
60
+ });
61
+
62
+ test("resolveEnvList:回退父进程 env,未定义置空并记 warning", () => {
63
+ const { env, warnings } = resolveEnvList("X=$HOME/y\nY=$NOPE_zzz", { HOME: "/home/pi" });
64
+ assert.equal(env.X, "/home/pi/y");
65
+ assert.equal(env.Y, "", "未定义 → 空串,不保留字面量");
66
+ assert.ok(warnings.some((w) => w.includes("$NOPE_zzz")));
67
+ });
68
+
69
+ test("resolveEnvList:-NAME 排除(对空白 env 是无害幂等)", () => {
70
+ const { env, warnings } = resolveEnvList("A=1\n-A\n-A");
71
+ assert.deepEqual(env, {});
72
+ assert.equal(warnings.length, 0, "排除未设置的变量幂等无害");
73
+ });
74
+
75
+ test("resolveEnvList:不做引号剥离/%VAR%/命令替换(按字面量)", () => {
76
+ const { env } = resolveEnvList('Q="quoted"\nP=%PATH%\nC=`date`');
77
+ assert.equal(env.Q, '"quoted"');
78
+ assert.equal(env.P, "%PATH%");
79
+ assert.equal(env.C, "`date`");
80
+ });
81
+
82
+ test("agentSpawnEnv:白名单 < 自动 bridge < 用户列表(可覆盖自动值)", () => {
83
+ const governance = (_cli, extra) => ({ PATH: "/bin", ...(extra || {}) });
84
+ const out = agentSpawnEnv({
85
+ cli: "zcode",
86
+ governance,
87
+ envList: "AITI_BRIDGE_URL=http://override:1/mcp\nUSERV=$UNDEF2",
88
+ processEnv: { PORT: "20341", UNDEF2: "pv" },
89
+ warn: () => {},
90
+ });
91
+ assert.equal(out.PATH, "/bin");
92
+ assert.equal(out.AITI_BRIDGE_URL, "http://override:1/mcp", "用户列表覆盖自动注入");
93
+ assert.equal(out.USERV, "pv", "列表引用回退父进程 env");
94
+ });
95
+
96
+ test("agentSpawnEnv:-NAME 急救——拔掉透传漏进来的变量,也可去掉自动注入", () => {
97
+ const governance = (_cli, extra) => ({ PATH: "/bin", LEAKY: "oops", ...(extra || {}) });
98
+ const out = agentSpawnEnv({
99
+ cli: "zcode",
100
+ governance,
101
+ envList: "-LEAKY\n-AITI_BRIDGE_URL",
102
+ processEnv: { PORT: "20341" },
103
+ warn: () => {},
104
+ });
105
+ assert.equal("LEAKY" in out, false, "排除治理透传变量");
106
+ assert.equal("AITI_BRIDGE_URL" in out, false, "排除自动注入项");
107
+ assert.equal(out.PATH, "/bin", "未排除的照常保留");
108
+ });
109
+
110
+ test("agentSpawnEnv:扩展注册列表 < 用户列表;注册侧排除同样生效", () => {
111
+ registerSpawnEnvDefaults("aiti-test-ext", "REG=1\n-LEAKY");
112
+ try {
113
+ const out = agentSpawnEnv({
114
+ extId: "aiti-test-ext",
115
+ envList: "REG=2",
116
+ processEnv: { LEAKY: "x" },
117
+ warn: () => {},
118
+ });
119
+ assert.equal(out.REG, "2", "用户覆盖注册默认");
120
+ assert.equal("LEAKY" in out, false, "注册侧排除生效");
121
+ assert.match(out.AITI_BRIDGE_URL, /api\/extensions\/aiti-devtools$/);
122
+ } finally {
123
+ registerSpawnEnvDefaults("aiti-test-ext", "");
124
+ }
125
+ });
126
+
127
+ test("agentSpawnEnv:引用可解析治理透传(工作 env 优先于 base)", () => {
128
+ const governance = (_cli, extra) => ({ MARK: "m1", ...(extra || {}) });
129
+ const out = agentSpawnEnv({ cli: "x", governance, envList: "USE=$MARK", processEnv: { MARK: "base" }, warn: () => {} });
130
+ assert.equal(out.USE, "m1", "工作 env(透传值)优先");
131
+ });
132
+
133
+ test("agentSpawnEnv:无 governance 派(cursor/qoder)= processEnv 基底 + bridge + 列表", () => {
134
+ const out = agentSpawnEnv({ envList: "K=1", processEnv: { FOO: "f" }, warn: () => {} });
135
+ assert.equal(out.FOO, "f");
136
+ assert.equal(out.K, "1");
137
+ assert.match(out.AITI_BRIDGE_URL, /api\/extensions\/aiti-devtools$/);
138
+ });
139
+
140
+ test("agentSpawnEnv:warning 不抛错(未传 warn 走 console.warn)", () => {
141
+ assert.doesNotThrow(() => agentSpawnEnv({ envList: "bad line", processEnv: {} }));
142
+ });
143
+
144
+ test("spawnEnvList:ctx.features 优先,非字符串按空列表", () => {
145
+ captureSpawnEnvFeatures({ get: (_e, fid) => (fid === "spawn.env" ? "A=1" : undefined) });
146
+ assert.equal(spawnEnvList("aiti-x"), "A=1");
147
+ captureSpawnEnvFeatures({ get: () => true });
148
+ assert.equal(spawnEnvList("aiti-x"), "", "boolean 值(旧 host)按空列表");
149
+ captureSpawnEnvFeatures(null);
150
+ });
151
+
152
+ test("spawnEnvFeature:声明形状(id/type=textlist,含 -NAME 语法说明)", () => {
153
+ const f = spawnEnvFeature("G");
154
+ assert.equal(f.id, "spawn.env");
155
+ assert.equal(f.type, "textlist");
156
+ assert.equal(f.group, "G");
157
+ assert.ok(f.description.includes("-NAME"));
158
+ });
159
+
160
+ test("resolveCliLaunch:win32 下 .cmd/.bat command → shell:true(lessons §0.1 欠账收口)", () => {
161
+ const r = resolveCliLaunch({ defaultCommand: "cli", command: process.platform === "win32" ? "C:\tools\agent.cmd" : "cli", driverArgs: ["--flag"] });
162
+ if (process.platform === "win32") {
163
+ assert.equal(r.shell, true, ".cmd 必须提示 shell:true");
164
+ } else {
165
+ assert.ok(!r.shell, "POSIX 不设 shell 标记");
166
+ }
167
+ const r2 = resolveCliLaunch({ defaultCommand: "claude", driverArgs: [] });
168
+ assert.ok(!r2.shell, "裸名/无扩展名 command 不设 shell 标记");
169
+ });