evolcore 0.0.43-test.6 → 0.0.43-test.8

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 (249) hide show
  1. package/CHANGELOG.md +95 -0
  2. package/bin/ecmsg.js +188 -58
  3. package/dist/agent-template/jobs.js +62 -0
  4. package/dist/agent-template/runtime.js +214 -0
  5. package/dist/agent-template/service.js +465 -0
  6. package/dist/agent-template/tool-runner.js +45 -0
  7. package/dist/agent-template/types.js +5 -0
  8. package/dist/agents/baseagent-availability.js +1 -1
  9. package/dist/agents/claude-runner.js +1 -1
  10. package/dist/agents/codex/app-server-client.js +22 -0
  11. package/dist/agents/codex-runner.js +69 -2
  12. package/dist/aun/aid/agentmd.js +56 -1
  13. package/dist/aun/aid/client.js +3 -1
  14. package/dist/aun/menu/client.js +3 -2
  15. package/dist/aun/msg/p2p.js +6 -1
  16. package/dist/channels/aun.js +277 -49
  17. package/dist/cli/agent-command.js +5 -0
  18. package/dist/cli/agent-create.js +7 -3
  19. package/dist/cli/agent-template.js +124 -0
  20. package/dist/cli/aun-commands.js +2 -2
  21. package/dist/cli/ctl-command.js +2 -1
  22. package/dist/cli/daemon-commands.js +11 -66
  23. package/dist/cli/daemon-lifecycle-client.js +61 -0
  24. package/dist/cli/ecmsg-gateway.js +35 -2
  25. package/dist/cli/events-command.js +109 -0
  26. package/dist/cli/index.js +60 -14
  27. package/dist/cli/invoke-command.js +182 -0
  28. package/dist/cli/managed-command-guard.js +6 -1
  29. package/dist/cli/net-check.js +1 -1
  30. package/dist/cli/restart-monitor.js +160 -83
  31. package/dist/cli/services-command.js +137 -0
  32. package/dist/cli/team-workspace-command.js +134 -0
  33. package/dist/cli/thread-command.js +103 -13
  34. package/dist/cli/watch-msg.js +1 -1
  35. package/dist/config/boot-log.js +8 -8
  36. package/dist/config/config-field-policy.js +2 -2
  37. package/dist/config/config-manager.js +0 -7
  38. package/dist/config/invoke-ipc-service.js +118 -0
  39. package/dist/config/schema-migration.js +45 -15
  40. package/dist/config-store.js +2 -1
  41. package/dist/core/agent-ipc-registration.js +25 -4
  42. package/dist/core/agent-reload-coordinator.js +6 -4
  43. package/dist/core/agent-runtime.js +106 -10
  44. package/dist/core/auth/delegation-authorization.js +66 -0
  45. package/dist/core/auth/operation-authorizer.js +2 -0
  46. package/dist/core/auth/operation-catalog.js +29 -0
  47. package/dist/core/baseagent-loader.js +60 -130
  48. package/dist/core/channel-loader.js +10 -1
  49. package/dist/core/channel-runtime.js +20 -12
  50. package/dist/core/command/agent-control.js +12 -2
  51. package/dist/core/command/agent-storage-menu.js +1 -1
  52. package/dist/core/command/agent-template-menu.js +147 -0
  53. package/dist/core/command/chatmode-config.js +2 -36
  54. package/dist/core/command/command-handler.js +80 -17
  55. package/dist/core/command/data-root-resolver.js +32 -23
  56. package/dist/core/command/eventcenter-menu.js +468 -0
  57. package/dist/core/command/menu-catalog.js +15 -0
  58. package/dist/core/command/menu-handler.js +216 -90
  59. package/dist/core/command/menu-protocol.js +71 -13
  60. package/dist/core/command/menu-query-batch.js +194 -0
  61. package/dist/core/command/slash-gate.js +1 -1
  62. package/dist/core/command/slash-handler.js +34 -42
  63. package/dist/core/command/team-workspace-bootstrap.js +350 -0
  64. package/dist/core/command/{pa-workspace-calendar.js → team-workspace-calendar.js} +7 -7
  65. package/dist/core/command/team-workspace-initializer.js +2 -0
  66. package/dist/core/command/{pa-workspace-items.js → team-workspace-items.js} +83 -68
  67. package/dist/core/command/team-workspace-job-store.js +88 -0
  68. package/dist/core/command/team-workspace-management-service.js +2 -0
  69. package/dist/core/command/team-workspace-management-store.js +96 -0
  70. package/dist/core/command/team-workspace-management.js +265 -0
  71. package/dist/core/command/team-workspace-members-menu.js +88 -0
  72. package/dist/core/command/team-workspace-store.js +612 -0
  73. package/dist/core/command/team-workspace-team.js +193 -0
  74. package/dist/core/daemon-control.js +22 -5
  75. package/dist/core/daemon-lifecycle.js +323 -191
  76. package/dist/core/handoff/runtime.js +45 -13
  77. package/dist/core/invoke/executors/index.js +13 -0
  78. package/dist/core/invoke/executors/media.js +283 -0
  79. package/dist/core/invoke/executors/text.js +198 -0
  80. package/dist/core/invoke/invoke-service.js +157 -0
  81. package/dist/core/invoke/style-router.js +48 -0
  82. package/dist/core/invoke/types.js +19 -0
  83. package/dist/core/ipc-registration.js +50 -7
  84. package/dist/core/legacy-rename.js +41 -0
  85. package/dist/core/memory/consolidation.js +7 -5
  86. package/dist/core/message/aun-ipc-sender.js +252 -17
  87. package/dist/core/message/im-renderer.js +116 -85
  88. package/dist/core/message/message-bridge.js +4 -0
  89. package/dist/core/message/message-queue.js +66 -15
  90. package/dist/core/message/message-utils.js +10 -2
  91. package/dist/core/message/peer-mode.js +7 -34
  92. package/dist/core/message/pending-hints.js +29 -5
  93. package/dist/core/message/response-engine.js +194 -61
  94. package/dist/core/message/send-options.js +7 -4
  95. package/dist/core/message/send-routing.js +50 -5
  96. package/dist/core/ownership/owner-resolver.js +7 -0
  97. package/dist/core/pack-auth.js +94 -0
  98. package/dist/core/pack-install.js +194 -0
  99. package/dist/core/permission/ec-command-parser.js +51 -17
  100. package/dist/core/permission/protected-paths.js +12 -2
  101. package/dist/core/permission/shell-environment.js +9 -0
  102. package/dist/core/rate-window.js +48 -0
  103. package/dist/core/relation/peer-identity.js +28 -0
  104. package/dist/core/session/session-file-health.js +243 -0
  105. package/dist/core/session/session-fs-store.js +67 -28
  106. package/dist/core/session/session-idle-monitor.js +59 -19
  107. package/dist/core/session/session-manager.js +13 -4
  108. package/dist/core/task/task-recovery-service.js +13 -2
  109. package/dist/core/thread/command-parser.js +9 -2
  110. package/dist/core/thread/thread-operation.js +21 -2
  111. package/dist/core/thread/thread-route.js +13 -2
  112. package/dist/core/thread/thread-service.js +52 -3
  113. package/dist/directory/owner-directory-admission.js +40 -53
  114. package/dist/directory/owner-directory-cache.js +89 -113
  115. package/dist/directory/owner-directory-query-operation.js +8 -10
  116. package/dist/eck/kit-renderer.js +7 -5
  117. package/dist/eck/message-renderer.js +2 -0
  118. package/dist/ecweb/basic-settings-service.js +1 -1
  119. package/dist/ecweb/message-context-service.js +0 -4
  120. package/dist/ecweb/runtime/lifecycle.js +6 -2
  121. package/dist/ecweb/runtime/supervisor.js +19 -4
  122. package/dist/event-center/admission-materializer.js +124 -0
  123. package/dist/event-center/bus-gate.js +154 -0
  124. package/dist/event-center/bus-host.js +307 -0
  125. package/dist/event-center/bus-resolver.js +120 -0
  126. package/dist/event-center/center-config.js +127 -0
  127. package/dist/event-center/daemon.js +44 -0
  128. package/dist/event-center/directory-source.js +55 -0
  129. package/dist/event-center/dispatcher.js +157 -0
  130. package/dist/event-center/event-log.js +110 -0
  131. package/dist/event-center/index-generator.js +73 -0
  132. package/dist/event-center/ipc-operation.js +423 -0
  133. package/dist/event-center/ledger.js +52 -0
  134. package/dist/event-center/pack-loader.js +207 -0
  135. package/dist/event-center/pack-manager.js +85 -0
  136. package/dist/event-center/registry.js +463 -0
  137. package/dist/event-center/runtime.js +837 -0
  138. package/dist/event-center/script-runner.js +356 -0
  139. package/dist/event-center/types.js +51 -0
  140. package/dist/event-center/validation.js +435 -0
  141. package/dist/index.js +424 -135
  142. package/dist/ipc.js +106 -12
  143. package/dist/paths.js +20 -0
  144. package/dist/product.js +14 -0
  145. package/dist/proxy/manager.js +5 -1
  146. package/dist/proxy/service-supervisor.js +13 -4
  147. package/dist/response-system/engines/v1/index.js +0 -1
  148. package/dist/response-system/engines/v1/proactive-flow.js +4 -2
  149. package/dist/response-system/modes/single-session/index.js +1 -1
  150. package/dist/services/dispatcher.js +100 -0
  151. package/dist/services/idempotency.js +90 -0
  152. package/dist/services/identity.js +52 -0
  153. package/dist/services/index-generator.js +70 -0
  154. package/dist/services/index.js +449 -0
  155. package/dist/services/ipc-operation.js +550 -0
  156. package/dist/services/ledger.js +52 -0
  157. package/dist/services/message-log.js +112 -0
  158. package/dist/services/pack-manager.js +215 -0
  159. package/dist/services/reply.js +55 -0
  160. package/dist/services/router.js +98 -0
  161. package/dist/services/script-runner.js +422 -0
  162. package/dist/services/service-payload.js +70 -0
  163. package/dist/services/types.js +18 -0
  164. package/dist/services/validation.js +297 -0
  165. package/dist/trigger/application-service.js +18 -0
  166. package/dist/trigger/event-source.js +1 -1
  167. package/dist/trigger/ipc-service.js +3 -1
  168. package/dist/trigger/scheduler.js +38 -0
  169. package/dist/trigger/script-sandbox.js +170 -24
  170. package/dist/utils/cross-platform.js +24 -10
  171. package/dist/utils/evolcore-version.js +69 -27
  172. package/dist/utils/instance-registry.js +19 -13
  173. package/dist/utils/npm-ops.js +2 -1
  174. package/dist/utils/package-version-info.js +6 -3
  175. package/dist/utils/process-introspect.js +45 -9
  176. package/dist/utils/startup-trace.js +74 -37
  177. package/dist/utils/windows-shell-trust.js +80 -6
  178. package/kits/docs/INDEX.md +2 -2
  179. package/kits/docs/aun/ABILITY_CALLING.md +9 -15
  180. package/kits/docs/context-assembly.md +1 -1
  181. package/kits/docs/evolcore/INDEX.md +3 -1
  182. package/kits/docs/evolcore/ability.md +4 -0
  183. package/kits/docs/evolcore/agent.md +22 -1
  184. package/kits/docs/evolcore/aid.md +1 -1
  185. package/kits/docs/evolcore/event-center.md +227 -0
  186. package/kits/docs/evolcore/file-navigation.md +10 -264
  187. package/kits/docs/evolcore/fs.md +5 -3
  188. package/kits/docs/evolcore/group.md +1 -1
  189. package/kits/docs/evolcore/memory-architecture.md +2 -0
  190. package/kits/docs/evolcore/menu-protocol.md +28 -1
  191. package/kits/docs/evolcore/msg.md +21 -9
  192. package/kits/docs/evolcore/provider.md +3 -1
  193. package/kits/docs/evolcore/response.md +5 -5
  194. package/kits/docs/evolcore/services.md +294 -0
  195. package/kits/docs/evolcore/task.md +2 -0
  196. package/kits/docs/evolcore/team-workspace.md +41 -0
  197. package/kits/docs/evolcore/thread-chain.md +15 -3
  198. package/kits/eck_manifest.json +26 -0
  199. package/kits/rules/02-navigation.md +10 -1
  200. package/kits/rules/06-channel.md +1 -0
  201. package/kits/schemas/_meta.json +17 -6
  202. package/kits/schemas/agent-config.schema.19.json +5 -7
  203. package/kits/schemas/agent-config.schema.20.json +936 -0
  204. package/kits/schemas/relation-config.schema.12.json +2 -3
  205. package/kits/schemas/role-config.schema.2.json +4 -4
  206. package/kits/skills/.switches.json +1 -5
  207. package/kits/skills/ability/SKILL.md +56 -0
  208. package/kits/skills/ability/references/calling.md +56 -0
  209. package/kits/skills/{ec-ability → ability}/references/contract-checklist.md +1 -1
  210. package/kits/skills/{ec-ability → ability}/references/development.md +9 -33
  211. package/kits/skills/{ec-ability → ability}/references/management.md +2 -2
  212. package/kits/skills/{ec-ability → ability}/references/recovery.md +1 -1
  213. package/kits/skills/{ec-ability → ability}/references/runtime-protocol.md +2 -0
  214. package/kits/skills/ec-agent-create/SKILL.md +0 -1
  215. package/kits/skills/ec-group/SKILL.md +5 -8
  216. package/kits/skills/ec-group-collaboration/SKILL.md +7 -7
  217. package/kits/skills/ec-service-proxy/SKILL.md +34 -5
  218. package/kits/skills/ec-trigger/SKILL.md +4 -4
  219. package/kits/skills/personal-assistant/SKILL.md +6 -6
  220. package/kits/skills/personal-assistant/references/02-bootstrap.md +4 -4
  221. package/kits/skills/personal-assistant/scripts/clean.mjs +4 -4
  222. package/kits/skills/personal-assistant/scripts/init.mjs +2 -2
  223. package/kits/skills/personal-assistant/scripts/pa.mjs +4 -4
  224. package/kits/skills/thread-ops/SKILL.md +10 -10
  225. package/kits/templates/message-fragments/item.md +1 -1
  226. package/kits/templates/system-fragments/channel.md +3 -3
  227. package/kits/templates/system-fragments/commands.md +5 -3
  228. package/kits/templates/system-fragments/reply.md +1 -5
  229. package/kits/templates/system-fragments/thread.md +13 -10
  230. package/package.json +5 -6
  231. package/scripts/agent-template/index.mjs +40 -0
  232. package/scripts/agent-template/inspect.mjs +240 -0
  233. package/scripts/agent-template/overlay.mjs +71 -0
  234. package/scripts/agent-template/pack.mjs +169 -0
  235. package/scripts/agent-template/shared/common.mjs +235 -0
  236. package/scripts/agent-template/shared/evolcore.mjs +75 -0
  237. package/scripts/agent-template/shared/plan.mjs +129 -0
  238. package/scripts/agent-template/shared/team-schema.json +70 -0
  239. package/scripts/agent-template/shared/template-contract.mjs +154 -0
  240. package/scripts/agent-template/shared/template-package.mjs +265 -0
  241. package/scripts/agent-template/shared/template-runtime.mjs +80 -0
  242. package/scripts/agent-template/shared/template.mjs +142 -0
  243. package/dist/cli/pa-workspace-command.js +0 -225
  244. package/dist/core/command/pa-workspace-store.js +0 -468
  245. package/dist/core/relation/pa-team.js +0 -132
  246. package/kits/docs/evolcore/pa-workspace.md +0 -51
  247. package/kits/skills/aid-ability/SKILL.md +0 -244
  248. package/kits/skills/ec-ability/SKILL.md +0 -67
  249. package/kits/skills/ec-ability/references/workflows.md +0 -15
@@ -0,0 +1,423 @@
1
+ /**
2
+ * `ec events` 的 daemon 侧 IPC 操作(events.op)。
3
+ * daemon-control 风格(不走 delegation argv 哈希);CLI 透传 argv,daemon 解析执行。
4
+ */
5
+ import { logger } from '../utils/logger.js';
6
+ import { Ledger, centerLedger } from './ledger.js';
7
+ import { EventLog } from './event-log.js';
8
+ import { loadPackDir } from './pack-loader.js';
9
+ import { toSdkCatalog } from './pack-manager.js';
10
+ import { materializeAllowlist } from './admission-materializer.js';
11
+ import { EventCenterError, errorMessage } from './types.js';
12
+ import { installPack, listPackDirs, removePack } from '../core/pack-install.js';
13
+ import { CenterConfigStore } from './center-config.js';
14
+ import { agentEventsDir } from '../paths.js';
15
+ import { authorizePackTarget, isManagingEventsCommand } from '../core/pack-auth.js';
16
+ const HELP = `ec events — 事件中心运维
17
+
18
+ 用法:
19
+ ec events status [<包名>] [--aid <aid>] 每包状态
20
+ ec events ledger <包名> [--tail N] 台账
21
+ ec events tail <包名> [--tail N] 事件日志
22
+ ec events doctor <包名> 诊断
23
+ ec events reload [<包名>] 重载(重新扫描目录并重建订阅)
24
+ ec events rules add <事件> --publish <aid> [--subscribe <aid>] [--deny]
25
+ ec events rules remove <事件> --publish <aid> [--subscribe <aid>] [--deny]
26
+ ec events rules show [--event <事件>]
27
+ ec events publish <包名> <事件> --data '<json>' [--ttl <秒>]
28
+
29
+ 安装与卸载(L 类目录只能由 daemon 代写):
30
+ ec events pack add <包名> --from <源目录> [--aid <aid>]
31
+ ec events pack remove <包名> [--aid <aid>] [--purge]
32
+ ec events pack list [--aid <aid>]
33
+
34
+ add 遇到已安装的包直接报错,先 remove 再装。
35
+ remove 默认把日志与台账归档到 <包>/logs/archive-<时间戳>/;--purge 连归档一起删。`;
36
+ export function parseEventsArgv(argv) {
37
+ const args = [...argv];
38
+ if (args.length === 0 || args[0] === 'help' || args[0] === '--help')
39
+ return { command: 'help', aids: {} };
40
+ const command = args.shift();
41
+ const parsed = { command, aids: {} };
42
+ const consumeValue = (flag) => {
43
+ const index = args.indexOf(flag);
44
+ if (index < 0)
45
+ return undefined;
46
+ const value = args[index + 1];
47
+ if (value === undefined)
48
+ return undefined;
49
+ args.splice(index, 2);
50
+ return value;
51
+ };
52
+ const consumeList = (flag) => {
53
+ const values = [];
54
+ for (;;) {
55
+ const value = consumeValue(flag);
56
+ if (value === undefined)
57
+ break;
58
+ values.push(value);
59
+ }
60
+ return values.length ? values : undefined;
61
+ };
62
+ parsed.aid = consumeValue('--aid');
63
+ const tailRaw = consumeValue('--tail');
64
+ if (tailRaw !== undefined) {
65
+ const tail = Number(tailRaw);
66
+ if (!Number.isInteger(tail) || tail < 1 || tail > 10_000)
67
+ return { error: '--tail must be a positive integer' };
68
+ parsed.tail = tail;
69
+ }
70
+ const ttlRaw = consumeValue('--ttl');
71
+ if (ttlRaw !== undefined) {
72
+ const ttl = Number(ttlRaw);
73
+ if (!Number.isInteger(ttl) || ttl < 1 || ttl > 3600)
74
+ return { error: '--ttl must be an integer in [1, 3600]' };
75
+ parsed.ttl = ttl;
76
+ }
77
+ const dataRaw = consumeValue('--data');
78
+ if (dataRaw !== undefined) {
79
+ try {
80
+ parsed.data = JSON.parse(dataRaw);
81
+ }
82
+ catch {
83
+ return { error: `--data is not valid JSON: ${dataRaw.slice(0, 80)}` };
84
+ }
85
+ }
86
+ const denyIndex = args.indexOf('--deny');
87
+ if (denyIndex >= 0) {
88
+ parsed.rule = 'deny';
89
+ args.splice(denyIndex, 1);
90
+ }
91
+ parsed.event = consumeValue('--event');
92
+ const publish = consumeList('--publish');
93
+ if (publish)
94
+ parsed.aids.publish = publish;
95
+ const subscribe = consumeList('--subscribe');
96
+ if (subscribe)
97
+ parsed.aids.subscribe = subscribe;
98
+ parsed.from = consumeValue('--from');
99
+ if (args.includes('--purge')) {
100
+ parsed.purge = true;
101
+ args.splice(args.indexOf('--purge'), 1);
102
+ }
103
+ if (args.includes('--force')) {
104
+ // `pack add` 不再支持覆盖:重装前必须先 `pack remove`。识别出来只为给出明确提示,
105
+ // 而不是当成未知参数静默忽略。
106
+ return { error: '--force is no longer supported; run "pack remove <包名>" before reinstalling' };
107
+ }
108
+ const positional = args.filter(item => !item.startsWith('-'));
109
+ if (command === 'pack') {
110
+ parsed.action = positional[0];
111
+ parsed.pack = positional[1];
112
+ }
113
+ else if (command === 'status' || command === 'ledger' || command === 'tail' || command === 'doctor'
114
+ || command === 'reload' || command === 'publish') {
115
+ parsed.pack = positional[0];
116
+ if (command === 'publish')
117
+ parsed.event = parsed.event ?? positional[1];
118
+ }
119
+ else if (command === 'rules') {
120
+ parsed.command = `rules:${positional[0] ?? ''}`;
121
+ parsed.event = parsed.event ?? positional[1];
122
+ }
123
+ return parsed;
124
+ }
125
+ function resolveAid(deps, parsed, opts = {}) {
126
+ if (parsed.aid)
127
+ return { aid: parsed.aid };
128
+ // pack 安装/卸载在单元还没起时也要能用(装完才 reload),此时默认 AID 优先于
129
+ // "恰好只有一个已启动单元"——否则全新 agent 永远装不上第一个包。
130
+ if (opts.preferDefault) {
131
+ const preferred = deps.defaultAid?.();
132
+ if (preferred)
133
+ return { aid: preferred };
134
+ }
135
+ const units = [...deps.registry.values()];
136
+ if (units.length === 1)
137
+ return { aid: units[0].aid };
138
+ const fallback = deps.defaultAid?.();
139
+ if (fallback && units.some(unit => unit.aid === fallback))
140
+ return { aid: fallback };
141
+ if (units.length === 0) {
142
+ return { error: { ok: false, code: 'NO_AGENT', error: 'no event center units started; pass --aid <aid>' } };
143
+ }
144
+ return { error: { ok: false, code: 'AGENT_REQUIRED', error: `multiple agents: ${units.map(unit => unit.aid).join(', ')}; pass --aid <aid>` } };
145
+ }
146
+ export function createEventsOperationExecutor(deps) {
147
+ return async (request) => {
148
+ let parsed;
149
+ try {
150
+ parsed = parseEventsArgv(request.argv ?? []);
151
+ }
152
+ catch (error) {
153
+ return { ok: false, code: 'INVALID_ARGV', error: errorMessage(error) };
154
+ }
155
+ if ('error' in parsed)
156
+ return { ok: false, code: 'INVALID_ARGV', error: parsed.error };
157
+ // 调用方身份随请求传入,不参与 argv 解析(argv 来自 agent,可伪造)。
158
+ parsed.caller = request.caller;
159
+ try {
160
+ return await execute(deps, parsed);
161
+ }
162
+ catch (error) {
163
+ if (error instanceof EventCenterError) {
164
+ return { ok: false, code: error.code, error: error.message };
165
+ }
166
+ const message = errorMessage(error);
167
+ const code = /\b([A-Z][A-Z0-9_]{3,})\b/.exec(message)?.[1] ?? 'INTERNAL_ERROR';
168
+ logger.warn(`[EventCenter] events.op failed: ${code}: ${message}`);
169
+ return { ok: false, code, error: message };
170
+ }
171
+ };
172
+ }
173
+ async function execute(deps, parsed) {
174
+ const { command } = parsed;
175
+ if (command === 'help')
176
+ return { ok: true, result: { help: HELP } };
177
+ if (command === 'reload') {
178
+ const target = resolveAid(deps, parsed);
179
+ if (target.error)
180
+ return target.error;
181
+ await deps.registry.reload(target.aid);
182
+ const unit = deps.registry.get(target.aid);
183
+ return { ok: true, result: { aid: target.aid, packs: unit?.state.enabledPacks.map(pack => pack.id) ?? [] } };
184
+ }
185
+ const target = resolveAid(deps, parsed, { preferDefault: command === 'pack' });
186
+ if (target.error)
187
+ return target.error;
188
+ const aid = target.aid;
189
+ const auth = authorizePackTarget({
190
+ caller: parsed.caller ?? { kind: 'local-control' },
191
+ targetAid: aid,
192
+ ...(deps.daemonAid?.() ? { daemonAid: deps.daemonAid() } : {}),
193
+ requiresManagement: isManagingEventsCommand(parsed.command.startsWith('rules:') ? 'rules' : parsed.command),
194
+ });
195
+ if (!auth.allowed)
196
+ return { ok: false, code: auth.code, error: auth.error };
197
+ // ── 包安装/卸载:不需要 unit 已启动(装完再 reload 即可生效)──
198
+ if (command === 'pack') {
199
+ const eventsDir = agentEventsDir(aid);
200
+ if (parsed.action === 'list') {
201
+ return { ok: true, result: { aid, eventsDir, packs: listPackDirs(eventsDir, 'pack.json') } };
202
+ }
203
+ if (!parsed.pack)
204
+ return { ok: false, code: 'INVALID_ARGV', error: `${command} ${parsed.action ?? ''} requires <包名>` };
205
+ if (parsed.action === 'add') {
206
+ if (!parsed.from)
207
+ return { ok: false, code: 'INVALID_ARGV', error: 'pack add requires --from <源目录>' };
208
+ const installed = installPack({
209
+ sourceDir: parsed.from,
210
+ targetRoot: eventsDir,
211
+ name: parsed.pack,
212
+ manifestFile: 'pack.json',
213
+ legacyManifestFile: '关注的事件.json',
214
+ });
215
+ // 总闸必须在 reload **之前**建好:reload 会按磁盘状态一次性重建运行时,
216
+ // 建完再 reload 会让 Bus/Sub/Pub 三条连接白连一次(服务端记 4009
217
+ // "Connection replaced by new session"),既不干净也拖慢安装。
218
+ // 没有 events-config.json 时 Bus 永远 stopped,包 active 却收不到事件。
219
+ const centerStoreBefore = new CenterConfigStore({ eventsDir });
220
+ let createdCenter = false;
221
+ if (!centerStoreBefore.read().exists) {
222
+ centerStoreBefore.write({
223
+ enabled: true,
224
+ authMode: 'allowlist',
225
+ admission: { coupling: 'on', rematerializeMs: 300_000 },
226
+ rules: {},
227
+ rateLimit: { perMinute: 60, perHour: 600 },
228
+ });
229
+ createdCenter = true;
230
+ }
231
+ await deps.registry.reload(aid);
232
+ return { ok: true, result: { aid, ...installed, ...(createdCenter ? { createdCenter: true } : {}) } };
233
+ }
234
+ if (parsed.action === 'remove') {
235
+ const removed = removePack({ pack: parsed.pack, targetRoot: eventsDir, purge: parsed.purge === true });
236
+ await deps.registry.reload(aid);
237
+ return { ok: true, result: { aid, ...removed } };
238
+ }
239
+ return { ok: false, code: 'UNKNOWN_COMMAND', error: `unknown pack action: ${parsed.action ?? '(none)'}
240
+ ${HELP}` };
241
+ }
242
+ const unit = deps.registry.get(aid);
243
+ if (!unit)
244
+ return { ok: false, code: 'AGENT_NOT_STARTED', error: `event center not started for ${aid}` };
245
+ switch (command) {
246
+ case 'status': {
247
+ if (parsed.pack) {
248
+ const pack = unit.state.enabledPacks.find(candidate => candidate.id === parsed.pack);
249
+ if (!pack)
250
+ return { ok: false, code: 'PACK_NOT_FOUND', error: `pack not found or invalid: ${parsed.pack}` };
251
+ return { ok: true, result: { aid, pack: packStatus(unit, pack.id) } };
252
+ }
253
+ const runtimeStatus = unit.runtime.status();
254
+ // 配置非法时运行态是"按缺省值起的"(Bus 可能根本没起),这一点必须和状态一起显示。
255
+ const { errors: configErrors = [] } = unit.centerStore.read();
256
+ return {
257
+ ok: true,
258
+ result: {
259
+ aid,
260
+ ...(configErrors.length > 0 ? { configErrors } : {}),
261
+ bus: runtimeStatus.bus,
262
+ subscriptions: runtimeStatus.subscriptions,
263
+ pendingSubscriptions: runtimeStatus.pendingSubscriptions,
264
+ publishers: runtimeStatus.publishers,
265
+ packs: [
266
+ ...unit.state.enabledPacks.map(pack => packStatus(unit, pack.id)),
267
+ ...unit.state.disabledPacks.map(id => ({ id, status: 'disabled' })),
268
+ ...unit.state.invalidPacks.map(item => ({ id: item.id, status: 'invalid', errors: item.errors })),
269
+ ],
270
+ },
271
+ };
272
+ }
273
+ case 'ledger': {
274
+ // 不传包名 = 读中心台账(bus.start/stop、gate、allowlist.update 在这里,
275
+ // 包级 ledger 只有 pack.load/subscribe)。
276
+ if (!parsed.pack) {
277
+ const lines = centerLedger(unit.eventsDir).tail(parsed.tail ?? 20);
278
+ return { ok: true, result: { aid, scope: 'center', lines } };
279
+ }
280
+ const pack = requirePack(unit, parsed.pack);
281
+ if ('ok' in pack)
282
+ return pack;
283
+ const lines = new Ledger(pack.paths.ledger).tail(parsed.tail ?? 20);
284
+ return { ok: true, result: { aid, pack: pack.id, lines } };
285
+ }
286
+ case 'tail': {
287
+ const pack = requirePack(unit, parsed.pack);
288
+ if ('ok' in pack)
289
+ return pack;
290
+ const lines = EventLog.forPack(pack).tail(parsed.tail ?? 20);
291
+ return { ok: true, result: { aid, pack: pack.id, lines } };
292
+ }
293
+ case 'doctor': {
294
+ const pack = requirePack(unit, parsed.pack);
295
+ if ('ok' in pack)
296
+ return pack;
297
+ const findings = await doctor(unit, pack.id);
298
+ return { ok: true, result: { aid, pack: pack.id, findings } };
299
+ }
300
+ case 'rules:show': {
301
+ const { config, errors: configErrors = [] } = unit.centerStore.read();
302
+ const entries = parsed.event
303
+ ? { [parsed.event]: config.rules[parsed.event] ?? { allow: { publish: [], subscribe: [] }, deny: { publish: [], subscribe: [] } } }
304
+ : config.rules;
305
+ // errors 非空时 `rules` 是缺省值而不是磁盘内容——必须让调用方看得见,
306
+ // 否则会误以为"规则被清空了"。
307
+ return {
308
+ ok: true,
309
+ result: {
310
+ aid, enabled: config.enabled, authMode: config.authMode, rules: entries,
311
+ ...(configErrors.length > 0 ? { configErrors } : {}),
312
+ },
313
+ };
314
+ }
315
+ case 'rules:add':
316
+ case 'rules:remove': {
317
+ if (!parsed.event)
318
+ return { ok: false, code: 'INVALID_ARGV', error: 'rules add/remove requires <event>' };
319
+ if (!unit.state.catalog.some(entry => entry.event === parsed.event))
320
+ return { ok: false, code: 'EVENT_NOT_FOUND', error: `event is not registered: ${parsed.event}` };
321
+ if (!parsed.aids.publish && !parsed.aids.subscribe) {
322
+ return { ok: false, code: 'INVALID_ARGV', error: 'rules add/remove requires --publish <aid> and/or --subscribe <aid>' };
323
+ }
324
+ const action = command === 'rules:add' ? 'add' : 'remove';
325
+ const applied = {};
326
+ for (const role of ['publish', 'subscribe']) {
327
+ const aids = parsed.aids[role];
328
+ if (!aids)
329
+ continue;
330
+ const result = unit.centerStore.mutateAllowlist({ event: parsed.event, action, role, rule: parsed.rule, aids });
331
+ applied[role] = { added: result.added, removed: result.removed };
332
+ // 联动 Bus:白名单变更立即生效(updateConfig)。
333
+ const materialized = materializeAllowlist(result.config, unit.agentDir, unit.aid);
334
+ if (result.config.enabled && unit.state.catalog.length > 0 && !materialized.degraded) {
335
+ await unit.runtime.busHost.apply({
336
+ catalog: toSdkCatalog(unit.state.catalog),
337
+ allowlist: materialized.allowlist,
338
+ });
339
+ }
340
+ }
341
+ return { ok: true, result: { aid, event: parsed.event, applied } };
342
+ }
343
+ case 'publish': {
344
+ if (!parsed.pack || !parsed.event)
345
+ return { ok: false, code: 'INVALID_ARGV', error: 'publish requires <pack> <event>' };
346
+ if (parsed.data === undefined)
347
+ return { ok: false, code: 'INVALID_ARGV', error: 'publish requires --data <json>' };
348
+ if (typeof parsed.data !== 'object' || parsed.data === null || Array.isArray(parsed.data)) {
349
+ return { ok: false, code: 'INVALID_ARGV', error: '--data must be a JSON object' };
350
+ }
351
+ // 发布方身份用于限流计数:托管会话用其 agent,主机终端用本机 AID。
352
+ const publisherAid = parsed.caller?.kind === 'managed' ? parsed.caller.selfAid : undefined;
353
+ const eventId = await unit.runtime.publish(parsed.pack, parsed.event, parsed.data, parsed.ttl, publisherAid);
354
+ return { ok: true, result: { aid, pack: parsed.pack, event: parsed.event, eventId } };
355
+ }
356
+ default:
357
+ return { ok: false, code: 'UNKNOWN_COMMAND', error: `unknown events command: ${command}\n${HELP}` };
358
+ }
359
+ }
360
+ function packStatus(unit, packId) {
361
+ const pack = unit.state.enabledPacks.find(candidate => candidate.id === packId);
362
+ if (!pack)
363
+ return { id: packId, status: 'invalid' };
364
+ const resolution = unit.runtime.resolutions.get(packId);
365
+ return {
366
+ id: pack.id,
367
+ name: pack.name,
368
+ status: 'active',
369
+ registers: pack.register.map(entry => entry.event),
370
+ publishes: pack.publish.map(entry => ({ bus: entry.bus, resolved: resolution?.get(entry.bus) ?? entry.busResolved, event: entry.event })),
371
+ subscribes: pack.subscribe.map(entry => ({ bus: entry.bus, resolved: resolution?.get(entry.bus) ?? entry.busResolved, event: entry.event })),
372
+ };
373
+ }
374
+ function requirePack(unit, packId) {
375
+ if (!packId)
376
+ return { ok: false, code: 'INVALID_ARGV', error: 'command requires <pack>' };
377
+ const pack = unit.state.enabledPacks.find(candidate => candidate.id === packId);
378
+ if (!pack)
379
+ return { ok: false, code: 'PACK_NOT_FOUND', error: `pack not found or invalid: ${packId}` };
380
+ return pack;
381
+ }
382
+ /** 诊断:重新加载包目录 + 检查脚本/解析/白名单。 */
383
+ async function doctor(unit, packId) {
384
+ const findings = [];
385
+ const pack = unit.state.enabledPacks.find(candidate => candidate.id === packId);
386
+ if (!pack) {
387
+ const invalid = unit.state.invalidPacks.find(item => item.id === packId);
388
+ return invalid
389
+ ? [{ level: 'error', check: 'pack.json', detail: invalid.errors.join('; ') }]
390
+ : [{ level: 'error', check: 'pack', detail: 'pack not found' }];
391
+ }
392
+ findings.push({ level: 'ok', check: 'pack.json', detail: 'valid' });
393
+ // 重新加载做文件系统复查(脚本存在性 / realpath 越界)。
394
+ const errors = [];
395
+ loadPackDir(pack.dir, errors);
396
+ findings.push(errors.length
397
+ ? { level: 'error', check: 'scripts', detail: errors.join('; ') }
398
+ : { level: 'ok', check: 'scripts', detail: 'all scripts present' });
399
+ const resolution = unit.runtime.resolutions.get(packId);
400
+ const unresolved = [...pack.subscribe, ...pack.publish]
401
+ .filter(entry => !(resolution?.get(entry.bus) ?? entry.busResolved))
402
+ .map(entry => entry.bus);
403
+ findings.push(unresolved.length
404
+ ? { level: 'error', check: 'bus-resolve', detail: `unresolved: ${unresolved.join(', ')}` }
405
+ : { level: 'ok', check: 'bus-resolve', detail: 'all buses resolved' });
406
+ const { config, errors: configErrors } = unit.centerStore.read();
407
+ // 配置非法时 read() 会退回缺省值;不把错误报出来,用户只会看到"规则没了"。
408
+ if (configErrors.length > 0) {
409
+ findings.push({ level: 'error', check: 'events-config.json', detail: configErrors.join('; ') });
410
+ }
411
+ if (pack.register.length > 0 && !config.enabled) {
412
+ findings.push({ level: 'warn', check: 'config', detail: 'register entries exist but events-config.json enabled=false; bus not started' });
413
+ }
414
+ for (const entry of pack.register) {
415
+ const rule = config.rules[entry.event];
416
+ // 没有 rules 条目是**正常默认**:此时按联系人准入放行(自 AID / Owner / 联系人),
417
+ // 不是"没人能发"。只有当条目存在且 deny 把自 AID 也挡了才是真问题。
418
+ if (rule && rule.deny.publish.includes(unit.aid) && rule.deny.subscribe.includes(unit.aid)) {
419
+ findings.push({ level: 'warn', check: 'rules', detail: `${entry.event} denies the local AID in both directions; it cannot publish or subscribe` });
420
+ }
421
+ }
422
+ return findings;
423
+ }
@@ -0,0 +1,52 @@
1
+ /**
2
+ * 台账(ledger.jsonl / .center-ledger.jsonl):append-only,只记生命周期,不记事件正文。
3
+ * 行结构按 docs/event-center/schema/ledger.schema.json(additionalProperties: false)。
4
+ */
5
+ import fs from 'node:fs';
6
+ import path from 'node:path';
7
+ export class Ledger {
8
+ filePath;
9
+ constructor(filePath) {
10
+ this.filePath = filePath;
11
+ }
12
+ /** 追加一行;IO 失败吞掉(台账不应中断运行时)。 */
13
+ append(line) {
14
+ const { ts, action, ...rest } = line;
15
+ const full = { ts: ts ?? Date.now(), action, ...rest };
16
+ try {
17
+ fs.mkdirSync(path.dirname(this.filePath), { recursive: true });
18
+ fs.appendFileSync(this.filePath, `${JSON.stringify(full)}\n`, 'utf8');
19
+ }
20
+ catch {
21
+ // 台账写失败不致命:运行继续,`ec events ledger` 读不到时再排查磁盘。
22
+ }
23
+ }
24
+ /** 读最后 N 行(CLI tail 用)。 */
25
+ tail(count) {
26
+ let text;
27
+ try {
28
+ text = fs.readFileSync(this.filePath, 'utf8');
29
+ }
30
+ catch {
31
+ return [];
32
+ }
33
+ const lines = text.split('\n').filter(Boolean).slice(-count);
34
+ const out = [];
35
+ for (const line of lines) {
36
+ try {
37
+ out.push(JSON.parse(line));
38
+ }
39
+ catch {
40
+ // 跳过坏行
41
+ }
42
+ }
43
+ return out;
44
+ }
45
+ }
46
+ export function packLedger(pack) {
47
+ return new Ledger(pack.paths.ledger);
48
+ }
49
+ /** center 级动作(bus.start / bus.stop / allowlist.update)的台账,放 events/ 根。 */
50
+ export function centerLedger(eventsDir) {
51
+ return new Ledger(path.join(eventsDir, '.center-ledger.jsonl'));
52
+ }
@@ -0,0 +1,207 @@
1
+ /**
2
+ * 事件包目录扫描与加载:events/<pack>/pack.json 与 events/events-config.json。
3
+ * 每个东西只有一个名字,不接受别名(包主要由 agent 生成,多一个写法就多一次选错的机会)。
4
+ * 脚本路径做 realpath 全级校验,防符号链接逃逸出包目录。
5
+ */
6
+ import fs from 'node:fs';
7
+ import path from 'node:path';
8
+ import { sha256 } from '../trigger/validation.js';
9
+ import { validateCenterConfig, validatePackJson } from './validation.js';
10
+ import { migrateLegacyFileName } from '../core/legacy-rename.js';
11
+ import { PACK_ARCHIVED_MARKER as ARCHIVED_MARKER } from '../core/pack-install.js';
12
+ import { atomicWriteJson } from '../utils/atomic-write.js';
13
+ import { logger } from '../utils/logger.js';
14
+ /**
15
+ * 事件包与服务包的文件名一一对应,且**每个东西只有一个名字**(不留别名):
16
+ *
17
+ * | 位置 | 文件名 |
18
+ * | --- | --- |
19
+ * | AID 级配置 | `events-config.json` / `services-config.json` |
20
+ * | 包声明 | `pack.json`(两侧同名) |
21
+ * | 包台账 | `ledger.jsonl`(两侧同名) |
22
+ * | 脚本目录 | `scripts/`(两侧同名) |
23
+ * | 日志目录 | `logs/`(两侧同名) |
24
+ *
25
+ * 不设别名的理由:包主要由 agent 生成,多一个可接受的写法就多一次选错的机会。
26
+ */
27
+ export const PACK_JSON = 'pack.json';
28
+ export const LEDGER_FILE = 'ledger.jsonl';
29
+ export const SCRIPTS_DIR = 'scripts';
30
+ export const LOGS_DIR = 'logs';
31
+ export const EVENTS_CONFIG_JSON = 'events-config.json';
32
+ /** realpath 全级校验:目标真实路径必须仍在包目录内(防中间目录符号链接逃逸)。 */
33
+ function assertInsidePackDir(packDir, target, errors, field) {
34
+ let realTarget;
35
+ try {
36
+ realTarget = fs.realpathSync(target);
37
+ }
38
+ catch {
39
+ errors.push(`${field} not found: ${path.relative(packDir, target)}`);
40
+ return false;
41
+ }
42
+ const realPackDir = fs.realpathSync(packDir);
43
+ if (realTarget !== realPackDir && !realTarget.startsWith(realPackDir + path.sep)) {
44
+ errors.push(`${field} escapes pack directory via symlink`);
45
+ return false;
46
+ }
47
+ return true;
48
+ }
49
+ /** 加载单个包目录。返回 null 表示该包 invalid(errors 已填)。 */
50
+ export function loadPackDir(packDir, errors) {
51
+ const packId = path.basename(packDir);
52
+ // 旧名 关注的事件.json / 会议关注的事件.json 曾作为 pack.json 的别名,
53
+ // 已取消别名:首次加载时一次性迁移成 pack.json,之后只认规范名。
54
+ for (const legacy of ['关注的事件.json', '会议关注的事件.json']) {
55
+ migrateLegacyFileName(packDir, legacy, PACK_JSON, `events pack ${packId}`);
56
+ }
57
+ const packJsonPath = path.join(packDir, PACK_JSON);
58
+ if (!fs.existsSync(packJsonPath)) {
59
+ errors.push(`missing ${PACK_JSON}`);
60
+ return null;
61
+ }
62
+ let rawText;
63
+ try {
64
+ rawText = fs.readFileSync(packJsonPath, 'utf8');
65
+ }
66
+ catch (error) {
67
+ errors.push(`cannot read ${path.basename(packJsonPath)}: ${error instanceof Error ? error.message : String(error)}`);
68
+ return null;
69
+ }
70
+ let raw;
71
+ try {
72
+ raw = JSON.parse(rawText);
73
+ }
74
+ catch (error) {
75
+ errors.push(`${path.basename(packJsonPath)} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
76
+ return null;
77
+ }
78
+ const validated = validatePackJson(raw);
79
+ if (!validated.ok) {
80
+ errors.push(...validated.errors);
81
+ return null;
82
+ }
83
+ // 脚本目录:只认 scripts/。声明了 subscribe 却没有该目录即 invalid。
84
+ let scriptsDir;
85
+ const canonicalScripts = path.join(packDir, SCRIPTS_DIR);
86
+ if (fs.existsSync(canonicalScripts))
87
+ scriptsDir = canonicalScripts;
88
+ else if (validated.value.subscribe.length > 0) {
89
+ errors.push(`scripts directory not found: expected ${SCRIPTS_DIR}/`);
90
+ return null;
91
+ }
92
+ // 脚本存在性 + realpath 越界校验(realpath 覆盖全路径各级目录的符号链接)。
93
+ for (const entry of validated.value.subscribe) {
94
+ const relativeUnderScripts = entry.handler.script.slice(SCRIPTS_DIR.length + 1);
95
+ const scriptPath = path.join(scriptsDir ?? canonicalScripts, relativeUnderScripts);
96
+ if (!assertInsidePackDir(packDir, scriptPath, errors, `handler.script "${entry.handler.script}"`))
97
+ continue;
98
+ const stat = fs.lstatSync(fs.realpathSync(scriptPath));
99
+ if (!stat.isFile()) {
100
+ errors.push(`handler.script "${entry.handler.script}" is not a regular file`);
101
+ }
102
+ }
103
+ const ledgerPath = path.join(packDir, LEDGER_FILE);
104
+ const logsDir = path.join(packDir, LOGS_DIR);
105
+ if (!fs.existsSync(logsDir)) {
106
+ try {
107
+ fs.mkdirSync(logsDir, { recursive: true });
108
+ }
109
+ catch {
110
+ errors.push(`cannot create logs directory: ${logsDir}`);
111
+ }
112
+ }
113
+ if (errors.length)
114
+ return null;
115
+ const paths = {
116
+ packJson: packJsonPath,
117
+ scriptsDir: scriptsDir ?? canonicalScripts,
118
+ ledger: ledgerPath,
119
+ logsDir,
120
+ };
121
+ return {
122
+ id: packId,
123
+ dir: packDir,
124
+ name: validated.value.name,
125
+ enabled: validated.value.enabled,
126
+ busResolve: validated.value.busResolve,
127
+ register: validated.value.register,
128
+ publish: validated.value.publish,
129
+ subscribe: validated.value.subscribe,
130
+ revision: sha256(rawText),
131
+ paths,
132
+ };
133
+ }
134
+ /** 扫描 events/ 下全部包目录。单包失败只废该包。 */
135
+ export function loadPacks(eventsDir) {
136
+ const valid = [];
137
+ const invalid = [];
138
+ let entries;
139
+ try {
140
+ entries = fs.readdirSync(eventsDir, { withFileTypes: true });
141
+ }
142
+ catch {
143
+ return { valid: [], invalid: [] };
144
+ }
145
+ for (const entry of entries) {
146
+ if (!entry.isDirectory())
147
+ continue;
148
+ if (entry.name.startsWith('.') || entry.name.startsWith('_'))
149
+ continue;
150
+ const packDir = path.join(eventsDir, entry.name);
151
+ // 已卸载但保留归档的目录(`pack remove` 留下 .archived):不是包,也不是坏包。
152
+ // 必须在这里跳过而不是靠 loadPackDir 返回 null —— 那个 null 在下面会被
153
+ // 记成 invalid 并往它的 ledger 里写一条 pack.invalid。
154
+ if (fs.existsSync(path.join(packDir, ARCHIVED_MARKER)))
155
+ continue;
156
+ const errors = [];
157
+ const pack = loadPackDir(packDir, errors);
158
+ if (pack)
159
+ valid.push(pack);
160
+ else
161
+ invalid.push({ dir: packDir, packId: entry.name, errors });
162
+ }
163
+ return { valid, invalid };
164
+ }
165
+ /** 读取 events/events-config.json;不存在返回缺省(enabled=false)。 */
166
+ export function loadCenterConfig(eventsDir) {
167
+ // 旧名 center.json 一次性迁移成 events-config.json(只搬运,不双读)。
168
+ migrateLegacyFileName(eventsDir, 'center.json', EVENTS_CONFIG_JSON, 'events config');
169
+ const filePath = path.join(eventsDir, EVENTS_CONFIG_JSON);
170
+ let rawText;
171
+ try {
172
+ rawText = fs.readFileSync(filePath, 'utf8');
173
+ }
174
+ catch {
175
+ return { config: { enabled: false, authMode: 'allowlist', admission: { coupling: 'on', rematerializeMs: 300_000 }, rules: {}, rateLimit: { perMinute: 60, perHour: 600 } }, exists: false, errors: [] };
176
+ }
177
+ let raw;
178
+ try {
179
+ raw = JSON.parse(rawText);
180
+ }
181
+ catch (error) {
182
+ return {
183
+ config: { enabled: false, authMode: 'allowlist', admission: { coupling: 'on', rematerializeMs: 300_000 }, rules: {}, rateLimit: { perMinute: 60, perHour: 600 } },
184
+ exists: true,
185
+ errors: [`${EVENTS_CONFIG_JSON} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`],
186
+ };
187
+ }
188
+ // 旧键名 `allowlist` 一次性迁移成 `rules`(它同时装 allow 与 deny,叫 allowlist 会误导)。
189
+ // 只搬运、不双读:迁移后写回时只有 rules。authMode 的 'allowlist' 是协议取值,不动。
190
+ if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
191
+ const record = raw;
192
+ if (!('rules' in record) && 'allowlist' in record) {
193
+ record.rules = record.allowlist;
194
+ delete record.allowlist;
195
+ try {
196
+ atomicWriteJson(filePath, record);
197
+ logger.info(`[migration] ${EVENTS_CONFIG_JSON}: allowlist → rules`);
198
+ }
199
+ catch { /* 写回失败不影响本次读取 */ }
200
+ }
201
+ }
202
+ const validated = validateCenterConfig(raw);
203
+ if (!validated.ok) {
204
+ return { config: { enabled: false, authMode: 'allowlist', admission: { coupling: 'on', rematerializeMs: 300_000 }, rules: {}, rateLimit: { perMinute: 60, perHour: 600 } }, exists: true, errors: validated.errors };
205
+ }
206
+ return { config: validated.value, exists: true, errors: [] };
207
+ }