evolcore 0.0.43-test.5 → 0.0.43-test.7
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.
- package/CHANGELOG.md +95 -0
- package/bin/ecmsg.js +281 -81
- package/dist/agents/baseagent-availability.js +20 -5
- package/dist/agents/baseagent.js +2 -2
- package/dist/agents/claude-runner.js +19 -4
- package/dist/agents/codex/app-server-client.js +36 -3
- package/dist/agents/codex-runner.js +75 -8
- package/dist/aun/group/invite-service.js +3 -2
- package/dist/aun/msg/p2p.js +6 -1
- package/dist/aun/service-proxy.js +18 -6
- package/dist/channels/aun.js +306 -30
- package/dist/cli/agent-create.js +18 -8
- package/dist/cli/aun-commands.js +9 -1
- package/dist/cli/daemon-commands.js +34 -65
- package/dist/cli/daemon-lifecycle-client.js +61 -0
- package/dist/cli/ecmsg-gateway.js +38 -3
- package/dist/cli/events-command.js +73 -0
- package/dist/cli/index.js +31 -14
- package/dist/cli/init.js +75 -0
- package/dist/cli/invoke-command.js +182 -0
- package/dist/cli/managed-command-guard.js +6 -1
- package/dist/cli/provider-command.js +1 -1
- package/dist/cli/restart-monitor.js +67 -50
- package/dist/cli/services-command.js +111 -0
- package/dist/cli/task-context.js +38 -1
- package/dist/cli/team-workspace-command.js +134 -0
- package/dist/cli/thread-command.js +6 -2
- package/dist/cli/watch-logs.js +6 -4
- package/dist/cli/watch-msg.js +1 -1
- package/dist/config/boot-log.js +6 -4
- package/dist/config/builtin-roles.js +2 -2
- package/dist/config/config-field-policy.js +2 -2
- package/dist/config/config-manager.js +1 -8
- package/dist/config/invoke-ipc-service.js +118 -0
- package/dist/config/peer-role-resolver.js +1 -1
- package/dist/config/provider-identity-migration.js +92 -17
- package/dist/config/provider-local-sync.js +2 -0
- package/dist/config/providers-config.js +13 -0
- package/dist/config/providers-management.js +100 -10
- package/dist/config/role-service.js +8 -8
- package/dist/config/role-store.js +22 -22
- package/dist/config/schema-migration.js +86 -88
- package/dist/config/snapshot.js +70 -41
- package/dist/config-store.js +2 -1
- package/dist/core/agent-reload-coordinator.js +6 -4
- package/dist/core/agent-runtime.js +146 -15
- package/dist/core/auth/delegation-authorization.js +66 -0
- package/dist/core/auth/operation-catalog.js +20 -0
- package/dist/core/baseagent-loader.js +75 -42
- package/dist/core/channel-loader.js +45 -13
- package/dist/core/channel-runtime.js +116 -45
- package/dist/core/command/agent-control.js +1 -1
- package/dist/core/command/agent-storage-menu.js +1 -1
- package/dist/core/command/chatmode-config.js +2 -36
- package/dist/core/command/command-handler.js +58 -16
- package/dist/core/command/data-root-resolver.js +32 -23
- package/dist/core/command/eventcenter-menu.js +338 -0
- package/dist/core/command/menu-catalog.js +8 -0
- package/dist/core/command/menu-handler.js +206 -87
- package/dist/core/command/menu-protocol.js +142 -22
- package/dist/core/command/menu-query-batch.js +194 -0
- package/dist/core/command/role-menu.js +27 -15
- package/dist/core/command/slash-gate.js +1 -1
- package/dist/core/command/slash-handler.js +34 -42
- package/dist/core/command/team-workspace-bootstrap.js +350 -0
- package/dist/core/command/{pa-workspace-calendar.js → team-workspace-calendar.js} +7 -7
- package/dist/core/command/team-workspace-initializer.js +2 -0
- package/dist/core/command/{pa-workspace-items.js → team-workspace-items.js} +83 -68
- package/dist/core/command/team-workspace-job-store.js +88 -0
- package/dist/core/command/team-workspace-management-service.js +2 -0
- package/dist/core/command/team-workspace-management-store.js +96 -0
- package/dist/core/command/team-workspace-management.js +265 -0
- package/dist/core/command/team-workspace-members-menu.js +88 -0
- package/dist/core/command/team-workspace-store.js +612 -0
- package/dist/core/command/team-workspace-team.js +193 -0
- package/dist/core/daemon-control.js +45 -15
- package/dist/core/daemon-lifecycle.js +478 -75
- package/dist/core/handoff/dispatcher.js +9 -3
- package/dist/core/handoff/runtime.js +130 -42
- package/dist/core/handoff/store.js +190 -2
- package/dist/core/handoff/types.js +5 -0
- package/dist/core/initialization/service.js +4 -4
- package/dist/core/invoke/executors/index.js +13 -0
- package/dist/core/invoke/executors/media.js +283 -0
- package/dist/core/invoke/executors/text.js +198 -0
- package/dist/core/invoke/invoke-service.js +157 -0
- package/dist/core/invoke/style-router.js +48 -0
- package/dist/core/invoke/types.js +19 -0
- package/dist/core/ipc-registration.js +51 -11
- package/dist/core/lifecycle-notice.js +10 -4
- package/dist/core/memory/consolidation.js +7 -5
- package/dist/core/message/aun-ipc-sender.js +149 -19
- package/dist/core/message/im-renderer.js +28 -84
- package/dist/core/message/message-bridge.js +57 -4
- package/dist/core/message/message-queue.js +46 -4
- package/dist/core/message/message-utils.js +10 -2
- package/dist/core/message/peer-mode.js +7 -34
- package/dist/core/message/pending-hints.js +4 -10
- package/dist/core/message/response-engine.js +163 -52
- package/dist/core/message/send-options.js +7 -4
- package/dist/core/message/send-routing.js +55 -7
- package/dist/core/ownership/owner-resolver.js +8 -0
- package/dist/core/permission/ec-command-parser.js +14 -3
- package/dist/core/permission/protected-paths.js +12 -2
- package/dist/core/permission/shell-environment.js +9 -0
- package/dist/core/session/adapters/claude-session-file-adapter.js +24 -0
- package/dist/core/session/adapters/codex-session-file-adapter.js +80 -0
- package/dist/core/session/adapters/ecagent-session-file-adapter.js +22 -0
- package/dist/core/session/adapters/gemini-session-file-adapter.js +39 -0
- package/dist/core/session/session-file-health.js +243 -0
- package/dist/core/session/session-fs-store.js +163 -3
- package/dist/core/session/session-idle-monitor.js +9 -1
- package/dist/core/session/session-manager.js +36 -2
- package/dist/core/task/task-recovery-service.js +13 -2
- package/dist/core/thread/command-parser.js +9 -2
- package/dist/core/thread/thread-operation.js +21 -2
- package/dist/core/thread/thread-route.js +13 -2
- package/dist/directory/owner-directory-admission.js +42 -30
- package/dist/directory/owner-directory-cache.js +143 -126
- package/dist/directory/owner-directory-query-operation.js +9 -8
- package/dist/eck/kit-renderer.js +7 -5
- package/dist/ecweb/basic-settings-service.js +1 -1
- package/dist/ecweb/message-context-service.js +0 -4
- package/dist/ecweb/runtime/lifecycle.js +14 -8
- package/dist/ecweb/runtime/supervisor.js +62 -30
- package/dist/event-center/admission-materializer.js +114 -0
- package/dist/event-center/bus-gate.js +136 -0
- package/dist/event-center/bus-host.js +290 -0
- package/dist/event-center/bus-resolver.js +120 -0
- package/dist/event-center/center-config.js +100 -0
- package/dist/event-center/client-factory.js +50 -0
- package/dist/event-center/daemon.js +45 -0
- package/dist/event-center/directory-source.js +53 -0
- package/dist/event-center/dispatcher.js +157 -0
- package/dist/event-center/event-log.js +110 -0
- package/dist/event-center/index-generator.js +63 -0
- package/dist/event-center/ipc-operation.js +308 -0
- package/dist/event-center/ledger.js +52 -0
- package/dist/event-center/pack-loader.js +202 -0
- package/dist/event-center/pack-manager.js +85 -0
- package/dist/event-center/registry.js +238 -0
- package/dist/event-center/runtime.js +641 -0
- package/dist/event-center/script-runner.js +356 -0
- package/dist/event-center/types.js +35 -0
- package/dist/event-center/validation.js +413 -0
- package/dist/index.js +751 -268
- package/dist/ipc.js +66 -12
- package/dist/paths.js +20 -0
- package/dist/product.js +14 -0
- package/dist/proxy/manager.js +43 -18
- package/dist/proxy/service-supervisor.js +78 -35
- package/dist/response-system/engines/v1/index.js +0 -1
- package/dist/response-system/modes/single-session/index.js +1 -1
- package/dist/services/dispatcher.js +100 -0
- package/dist/services/idempotency.js +90 -0
- package/dist/services/identity.js +52 -0
- package/dist/services/index-generator.js +70 -0
- package/dist/services/index.js +449 -0
- package/dist/services/ipc-operation.js +458 -0
- package/dist/services/ledger.js +52 -0
- package/dist/services/message-log.js +112 -0
- package/dist/services/pack-manager.js +204 -0
- package/dist/services/reply.js +55 -0
- package/dist/services/router.js +95 -0
- package/dist/services/script-runner.js +422 -0
- package/dist/services/service-payload.js +70 -0
- package/dist/services/types.js +18 -0
- package/dist/services/validation.js +297 -0
- package/dist/trigger/application-service.js +21 -1
- package/dist/trigger/audit.js +19 -4
- package/dist/trigger/authorization.js +14 -5
- package/dist/trigger/event-source.js +1 -1
- package/dist/trigger/history.js +176 -7
- package/dist/trigger/ipc-service.js +3 -1
- package/dist/trigger/manager.js +1 -3
- package/dist/trigger/scheduler.js +78 -5
- package/dist/trigger/script-sandbox.js +118 -22
- package/dist/utils/cross-platform.js +175 -13
- package/dist/utils/evolcore-version.js +69 -27
- package/dist/utils/host-info.js +11 -8
- package/dist/utils/instance-registry.js +19 -13
- package/dist/utils/npm-ops.js +48 -0
- package/dist/utils/process-introspect.js +109 -10
- package/dist/utils/startup-trace.js +222 -44
- package/dist/utils/windows-shell-trust.js +80 -6
- package/kits/docs/INDEX.md +2 -2
- package/kits/docs/aun/ABILITY_CALLING.md +10 -17
- package/kits/docs/context-assembly.md +1 -1
- package/kits/docs/evolcore/INDEX.md +5 -2
- package/kits/docs/evolcore/ability.md +4 -0
- package/kits/docs/evolcore/aid.md +1 -1
- package/kits/docs/evolcore/ctl.md +2 -1
- package/kits/docs/evolcore/event-center.md +207 -0
- package/kits/docs/evolcore/file-navigation.md +10 -264
- package/kits/docs/evolcore/fs.md +3 -2
- package/kits/docs/evolcore/group.md +2 -2
- package/kits/docs/evolcore/memory-architecture.md +2 -0
- package/kits/docs/evolcore/menu-exec-schema-commands.md +1 -1
- package/kits/docs/evolcore/menu-protocol.md +21 -0
- package/kits/docs/evolcore/msg.md +27 -8
- package/kits/docs/evolcore/provider.md +23 -3
- package/kits/docs/evolcore/response.md +5 -5
- package/kits/docs/evolcore/services.md +277 -0
- package/kits/docs/evolcore/task.md +2 -0
- package/kits/docs/evolcore/team-workspace.md +41 -0
- package/kits/eck_manifest.json +45 -7
- package/kits/eck_message_manifest.json +3 -3
- package/kits/rules/02-navigation.md +10 -1
- package/kits/rules/06-channel.md +5 -6
- package/kits/schemas/_meta.json +17 -6
- package/kits/schemas/agent-config.schema.19.json +5 -7
- package/kits/schemas/agent-config.schema.20.json +936 -0
- package/kits/schemas/daemon.schema.1.json +5 -0
- package/kits/schemas/daemon.schema.2.json +5 -0
- package/kits/schemas/daemon.schema.3.json +2 -1
- package/kits/schemas/daemon.schema.4.json +2 -1
- package/kits/schemas/daemon.schema.5.json +2 -1
- package/kits/schemas/daemon.schema.6.json +1 -1
- package/kits/schemas/daemon.schema.7.json +1 -1
- package/kits/schemas/daemon.schema.8.json +2 -1
- package/kits/schemas/daemon.schema.9.json +2 -1
- package/kits/schemas/relation-config.schema.12.json +2 -3
- package/kits/schemas/role-config.schema.2.json +4 -4
- package/kits/schemas/role-registry.schema.1.json +2 -2
- package/kits/schemas/single-session.schema.1.json +1 -1
- package/kits/schemas/single-session.schema.2.json +1 -1
- package/kits/schemas/single-session.schema.3.json +1 -1
- package/kits/skills/.switches.json +1 -5
- package/kits/skills/ability/SKILL.md +56 -0
- package/kits/skills/ability/references/calling.md +56 -0
- package/kits/skills/{ec-ability → ability}/references/contract-checklist.md +1 -1
- package/kits/skills/{ec-ability → ability}/references/development.md +9 -33
- package/kits/skills/{ec-ability → ability}/references/management.md +2 -2
- package/kits/skills/{ec-ability → ability}/references/recovery.md +1 -1
- package/kits/skills/{ec-ability → ability}/references/runtime-protocol.md +2 -0
- package/kits/skills/ec-agent-create/SKILL.md +0 -1
- package/kits/skills/ec-group/SKILL.md +8 -5
- package/kits/skills/ec-group-collaboration/SKILL.md +7 -7
- package/kits/skills/ec-service-proxy/SKILL.md +34 -5
- package/kits/skills/ec-trigger/SKILL.md +4 -4
- package/kits/skills/personal-assistant/SKILL.md +6 -6
- package/kits/skills/personal-assistant/references/02-bootstrap.md +4 -4
- package/kits/skills/personal-assistant/scripts/clean.mjs +4 -4
- package/kits/skills/personal-assistant/scripts/init.mjs +2 -2
- package/kits/skills/personal-assistant/scripts/pa.mjs +4 -4
- package/kits/skills/thread-ops/SKILL.md +10 -10
- package/kits/templates/system-fragments/channel.md +3 -3
- package/kits/templates/system-fragments/commands.md +9 -7
- package/kits/templates/system-fragments/reply.md +2 -6
- package/kits/templates/system-fragments/session.md +1 -1
- package/kits/templates/system-fragments/thread.md +11 -9
- package/package.json +5 -6
- package/dist/cli/pa-workspace-command.js +0 -225
- package/dist/core/command/pa-workspace-store.js +0 -468
- package/dist/core/relation/pa-team.js +0 -132
- package/kits/docs/evolcore/pa-workspace.md +0 -51
- package/kits/skills/aid-ability/SKILL.md +0 -244
- package/kits/skills/ec-ability/SKILL.md +0 -67
- package/kits/skills/ec-ability/references/workflows.md +0 -15
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 事件分发:SDK 事件 → 匹配包订阅 → received 日志 → filter → 队列 → 并发执行脚本 → handled 日志。
|
|
3
|
+
* 队列键 = 包:事件,每队列独立容量;全局并发上限。
|
|
4
|
+
*/
|
|
5
|
+
import { logger } from '../utils/logger.js';
|
|
6
|
+
import { matchTriggerEvent } from '../trigger/event-source.js';
|
|
7
|
+
import { EventLog } from './event-log.js';
|
|
8
|
+
export const DEFAULT_DISPATCHER_LIMITS = { maxConcurrency: 5, queueSize: 100 };
|
|
9
|
+
/**
|
|
10
|
+
* 包内一条 subscribe 条目实际指向的 bus AID。
|
|
11
|
+
* 顺序与 handleEvent 一致:resolutions(占位符解析结果)→ busResolved → 字面 bus。
|
|
12
|
+
*/
|
|
13
|
+
function resolveEntryBus(resolutions, packId, entry) {
|
|
14
|
+
return resolutions.get(packId)?.get(entry.bus) ?? entry.busResolved ?? entry.bus;
|
|
15
|
+
}
|
|
16
|
+
export class EventDispatcher {
|
|
17
|
+
scriptRunner;
|
|
18
|
+
limits;
|
|
19
|
+
queues = new Map();
|
|
20
|
+
running = 0;
|
|
21
|
+
closed = false;
|
|
22
|
+
idleResolvers = [];
|
|
23
|
+
constructor(scriptRunner, limits = DEFAULT_DISPATCHER_LIMITS) {
|
|
24
|
+
this.scriptRunner = scriptRunner;
|
|
25
|
+
this.limits = limits;
|
|
26
|
+
}
|
|
27
|
+
setLimits(limits) {
|
|
28
|
+
this.limits = { ...this.limits, ...limits };
|
|
29
|
+
}
|
|
30
|
+
/** SDK onEvent 回调入口;必须非阻塞(SDK 内按 bus 串行派发)。 */
|
|
31
|
+
handleEvent(packs, resolutions, event) {
|
|
32
|
+
if (this.closed)
|
|
33
|
+
return;
|
|
34
|
+
for (const pack of packs) {
|
|
35
|
+
for (const entry of pack.subscribe) {
|
|
36
|
+
const busAid = resolutions.get(pack.id)?.get(entry.bus) ?? entry.busResolved;
|
|
37
|
+
if (busAid !== event.busAid || entry.event !== event.eventName)
|
|
38
|
+
continue;
|
|
39
|
+
const log = EventLog.forPack(pack);
|
|
40
|
+
// 写前日志:received 一定先落盘。
|
|
41
|
+
log.writeReceived(event);
|
|
42
|
+
if (entry.filter && !this.matches(entry.filter, event)) {
|
|
43
|
+
log.writeFiltered(event, 'filter_mismatch');
|
|
44
|
+
continue;
|
|
45
|
+
}
|
|
46
|
+
const key = `${pack.id}\u0000${entry.event}`;
|
|
47
|
+
const queue = this.queues.get(key) ?? [];
|
|
48
|
+
if (queue.length >= this.limits.queueSize) {
|
|
49
|
+
log.writeDropped(event, 'queue_full');
|
|
50
|
+
continue;
|
|
51
|
+
}
|
|
52
|
+
queue.push({ pack, event, resolutions });
|
|
53
|
+
this.queues.set(key, queue);
|
|
54
|
+
void this.tick();
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
/** filter 求值复用 trigger 语义:伪事件 = 事件正文字段展开 + type=事件名(type 保留,正文里的同名键被覆盖)。 */
|
|
59
|
+
matches(filter, event) {
|
|
60
|
+
const pseudo = typeof event.data === 'object' && event.data !== null && !Array.isArray(event.data)
|
|
61
|
+
? { ...event.data, type: event.eventName }
|
|
62
|
+
: { type: event.eventName };
|
|
63
|
+
return matchTriggerEvent({ type: 'event', eventPattern: '*', filter }, pseudo).matched;
|
|
64
|
+
}
|
|
65
|
+
async tick() {
|
|
66
|
+
while (this.running < this.limits.maxConcurrency) {
|
|
67
|
+
const item = this.dequeue();
|
|
68
|
+
if (!item)
|
|
69
|
+
break;
|
|
70
|
+
this.running++;
|
|
71
|
+
try {
|
|
72
|
+
await this.execute(item);
|
|
73
|
+
}
|
|
74
|
+
finally {
|
|
75
|
+
this.running--;
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
if (this.running === 0 && this.isEmpty()) {
|
|
79
|
+
const waiters = [...this.idleResolvers];
|
|
80
|
+
this.idleResolvers.length = 0;
|
|
81
|
+
for (const resolve of waiters)
|
|
82
|
+
resolve();
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
dequeue() {
|
|
86
|
+
for (const [key, queue] of this.queues) {
|
|
87
|
+
if (queue.length === 0)
|
|
88
|
+
continue;
|
|
89
|
+
const item = queue.shift();
|
|
90
|
+
if (queue.length === 0)
|
|
91
|
+
this.queues.delete(key);
|
|
92
|
+
return item;
|
|
93
|
+
}
|
|
94
|
+
return null;
|
|
95
|
+
}
|
|
96
|
+
isEmpty() {
|
|
97
|
+
for (const queue of this.queues.values()) {
|
|
98
|
+
if (queue.length > 0)
|
|
99
|
+
return false;
|
|
100
|
+
}
|
|
101
|
+
return true;
|
|
102
|
+
}
|
|
103
|
+
async execute(item) {
|
|
104
|
+
const log = EventLog.forPack(item.pack);
|
|
105
|
+
// 热重载后订阅 handler 可能已变:从当前包配置重新取 handler。
|
|
106
|
+
//
|
|
107
|
+
// bus 的解析结果在 `resolutions` 里,`$self` / `$owner` 这类占位符**不会**写回
|
|
108
|
+
// `entry.busResolved`。只比 `busResolved` 会让占位符写法的包全部匹配失败,
|
|
109
|
+
// 表现是 received 有、handled 没有、脚本静默不跑。这里用与 handleEvent 相同的
|
|
110
|
+
// `resolutions → busResolved → bus` 链路解析。
|
|
111
|
+
const entry = item.pack.subscribe.find(candidate => resolveEntryBus(item.resolutions, item.pack.id, candidate) === item.event.busAid
|
|
112
|
+
&& candidate.event === item.event.eventName);
|
|
113
|
+
if (!entry)
|
|
114
|
+
return; // 包已改,事件不再处理(received 已落盘)
|
|
115
|
+
try {
|
|
116
|
+
const outcome = await this.scriptRunner.run(item.pack, entry.handler, item.event);
|
|
117
|
+
log.writeHandled(item.event, {
|
|
118
|
+
cmd: outcome.cmd,
|
|
119
|
+
exit: outcome.exitCode,
|
|
120
|
+
ms: outcome.durationMs,
|
|
121
|
+
outcome: outcome.outcome,
|
|
122
|
+
...(outcome.error ? { reason: `${outcome.error.code}: ${outcome.error.message}`.slice(0, 240) } : {}),
|
|
123
|
+
// 无沙箱执行必须留痕:事后排查「这个脚本为什么能读到不该读的东西」靠它。
|
|
124
|
+
...(outcome.sandboxAbsent ? { sandboxAbsent: outcome.sandboxAbsent } : {}),
|
|
125
|
+
});
|
|
126
|
+
if (outcome.outcome === 'error' || outcome.outcome === 'timeout') {
|
|
127
|
+
logger.warn(`[EventCenter] ${item.pack.id} handler for ${item.event.eventName} ${outcome.outcome}: ${outcome.error?.code ?? ''} ${outcome.error?.message ?? ''}`);
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
catch (error) {
|
|
131
|
+
// 执行器自身异常(不应发生):按 error 记,不中断队列。
|
|
132
|
+
log.writeHandled(item.event, {
|
|
133
|
+
cmd: 'unavailable',
|
|
134
|
+
exit: -1,
|
|
135
|
+
ms: 0,
|
|
136
|
+
outcome: 'error',
|
|
137
|
+
reason: `DISPATCHER_ERROR: ${error instanceof Error ? error.message : String(error)}`.slice(0, 240),
|
|
138
|
+
});
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
/** 关闭:停止接收;已排队事件丢弃(volatile 语义),等待运行中脚本结束。 */
|
|
142
|
+
async close(drainTimeoutMs = 5_000) {
|
|
143
|
+
this.closed = true;
|
|
144
|
+
this.queues.clear();
|
|
145
|
+
if (this.running > 0) {
|
|
146
|
+
await Promise.race([
|
|
147
|
+
new Promise(resolve => {
|
|
148
|
+
this.idleResolvers.push(resolve);
|
|
149
|
+
}),
|
|
150
|
+
new Promise(resolve => {
|
|
151
|
+
const timer = setTimeout(resolve, drainTimeoutMs);
|
|
152
|
+
timer.unref?.();
|
|
153
|
+
}),
|
|
154
|
+
]);
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
}
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 事件日志(logs/events-YYYYMMDD.jsonl):写前日志,先 received 再执行脚本,结束补 handled。
|
|
3
|
+
* 行结构按 docs/event-center/schema/event-log.schema.json(additionalProperties: false)。
|
|
4
|
+
* P0 恒落 data 原文(dataHash 逻辑留接口)。
|
|
5
|
+
*/
|
|
6
|
+
import fs from 'node:fs';
|
|
7
|
+
import path from 'node:path';
|
|
8
|
+
/** data 只在是 JSON 对象时按原样落盘(Schema 要求 object),其它形态包成 {@raw: string}。 */
|
|
9
|
+
function normalizeData(data) {
|
|
10
|
+
if (data !== null && typeof data === 'object' && !Array.isArray(data))
|
|
11
|
+
return data;
|
|
12
|
+
return { '@raw': JSON.stringify(data) };
|
|
13
|
+
}
|
|
14
|
+
export class EventLog {
|
|
15
|
+
logsDir;
|
|
16
|
+
constructor(logsDir) {
|
|
17
|
+
this.logsDir = logsDir;
|
|
18
|
+
}
|
|
19
|
+
static forPack(pack) {
|
|
20
|
+
return new EventLog(pack.paths.logsDir);
|
|
21
|
+
}
|
|
22
|
+
writeReceived(event) {
|
|
23
|
+
this.write({
|
|
24
|
+
ts: Date.now(),
|
|
25
|
+
kind: 'received',
|
|
26
|
+
eventId: event.eventId,
|
|
27
|
+
event: event.eventName,
|
|
28
|
+
bus: event.busAid,
|
|
29
|
+
publisher: event.publisher,
|
|
30
|
+
data: normalizeData(event.data),
|
|
31
|
+
});
|
|
32
|
+
}
|
|
33
|
+
writeHandled(event, detail) {
|
|
34
|
+
this.write({
|
|
35
|
+
ts: Date.now(),
|
|
36
|
+
kind: 'handled',
|
|
37
|
+
eventId: event.eventId,
|
|
38
|
+
event: event.eventName,
|
|
39
|
+
bus: event.busAid,
|
|
40
|
+
cmd: detail.cmd,
|
|
41
|
+
exit: detail.exit,
|
|
42
|
+
ms: detail.ms,
|
|
43
|
+
outcome: detail.outcome,
|
|
44
|
+
...(detail.reason !== undefined ? { reason: detail.reason } : {}),
|
|
45
|
+
...(detail.sandboxAbsent !== undefined ? { sandbox_absent: detail.sandboxAbsent } : {}),
|
|
46
|
+
});
|
|
47
|
+
}
|
|
48
|
+
writeDropped(event, reason) {
|
|
49
|
+
this.write({
|
|
50
|
+
ts: Date.now(),
|
|
51
|
+
kind: 'dropped',
|
|
52
|
+
eventId: event.eventId,
|
|
53
|
+
event: event.eventName,
|
|
54
|
+
bus: event.busAid,
|
|
55
|
+
reason,
|
|
56
|
+
});
|
|
57
|
+
}
|
|
58
|
+
writeFiltered(event, reason) {
|
|
59
|
+
this.write({
|
|
60
|
+
ts: Date.now(),
|
|
61
|
+
kind: 'filtered',
|
|
62
|
+
eventId: event.eventId,
|
|
63
|
+
event: event.eventName,
|
|
64
|
+
bus: event.busAid,
|
|
65
|
+
reason,
|
|
66
|
+
});
|
|
67
|
+
}
|
|
68
|
+
/** 按天分文件(本地日期);IO 失败吞掉。 */
|
|
69
|
+
write(line) {
|
|
70
|
+
const now = new Date();
|
|
71
|
+
const date = `${now.getFullYear()}${String(now.getMonth() + 1).padStart(2, '0')}${String(now.getDate()).padStart(2, '0')}`;
|
|
72
|
+
try {
|
|
73
|
+
fs.mkdirSync(this.logsDir, { recursive: true });
|
|
74
|
+
fs.appendFileSync(path.join(this.logsDir, `events-${date}.jsonl`), `${JSON.stringify(line)}\n`, 'utf8');
|
|
75
|
+
}
|
|
76
|
+
catch {
|
|
77
|
+
// 日志写失败不中断事件处理。
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
/** 读某包最近的事件日志行(CLI tail 用)。 */
|
|
81
|
+
tail(count) {
|
|
82
|
+
let files;
|
|
83
|
+
try {
|
|
84
|
+
files = fs.readdirSync(this.logsDir).filter(name => /^events-\d{8}\.jsonl$/.test(name)).sort();
|
|
85
|
+
}
|
|
86
|
+
catch {
|
|
87
|
+
return [];
|
|
88
|
+
}
|
|
89
|
+
const lines = [];
|
|
90
|
+
for (const file of [...files].reverse()) {
|
|
91
|
+
try {
|
|
92
|
+
const text = fs.readFileSync(path.join(this.logsDir, file), 'utf8');
|
|
93
|
+
lines.unshift(...text.split('\n').filter(Boolean));
|
|
94
|
+
}
|
|
95
|
+
catch {
|
|
96
|
+
break;
|
|
97
|
+
}
|
|
98
|
+
if (lines.length >= count)
|
|
99
|
+
break;
|
|
100
|
+
}
|
|
101
|
+
return lines.slice(-count).map(line => {
|
|
102
|
+
try {
|
|
103
|
+
return JSON.parse(line);
|
|
104
|
+
}
|
|
105
|
+
catch {
|
|
106
|
+
return { ts: 0, kind: 'dropped', reason: 'unparseable log line' };
|
|
107
|
+
}
|
|
108
|
+
});
|
|
109
|
+
}
|
|
110
|
+
}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 生成 `$AGENT_DIR/events/.index.md`:本机已启用事件包的订阅/发布清单。
|
|
3
|
+
*
|
|
4
|
+
* 只列 enabled 且无冲突的包(PackState.enabledPacks)。空集时删除文件而不是写空文件——
|
|
5
|
+
* 让 manifest 的 `optional` 判定与文件存在性始终一致。
|
|
6
|
+
*
|
|
7
|
+
* 格式见 docs/eck/services-and-events-manifest.md §五。
|
|
8
|
+
*/
|
|
9
|
+
import fs from 'node:fs';
|
|
10
|
+
import path from 'node:path';
|
|
11
|
+
import { logger } from '../utils/logger.js';
|
|
12
|
+
export const EVENTS_INDEX_FILE = '.index.md';
|
|
13
|
+
/**
|
|
14
|
+
* @param eventsDir `$AGENT_DIR/events`
|
|
15
|
+
* @param enabledPacks 已启用且无冲突的包
|
|
16
|
+
* @param resolutions 包 → (bus 引用 → 解析后的 AID);用于把 `$owner` 等占位符渲染成真实值
|
|
17
|
+
*/
|
|
18
|
+
export function writeEventsIndex(eventsDir, enabledPacks, resolutions) {
|
|
19
|
+
const filePath = path.join(eventsDir, EVENTS_INDEX_FILE);
|
|
20
|
+
if (enabledPacks.length === 0) {
|
|
21
|
+
try {
|
|
22
|
+
if (fs.existsSync(filePath)) {
|
|
23
|
+
fs.unlinkSync(filePath);
|
|
24
|
+
logger.debug(`[events-index] ${EVENTS_INDEX_FILE} 已删除(无启用事件包)`);
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
catch (error) {
|
|
28
|
+
logger.warn(`[events-index] cannot remove stale index: ${error instanceof Error ? error.message : String(error)}`);
|
|
29
|
+
}
|
|
30
|
+
return;
|
|
31
|
+
}
|
|
32
|
+
const lines = [];
|
|
33
|
+
lines.push(`[events] 本 Agent 已启用 ${enabledPacks.length} 个事件包,订阅以下事件。`);
|
|
34
|
+
lines.push('');
|
|
35
|
+
lines.push('事件是 TTL 内的在线通知,可能丢失;需要不丢的语义用普通消息。');
|
|
36
|
+
lines.push('');
|
|
37
|
+
for (const pack of enabledPacks) {
|
|
38
|
+
lines.push(`- ${pack.id}(${pack.name})`);
|
|
39
|
+
const resolution = resolutions?.get(pack.id);
|
|
40
|
+
for (const entry of pack.subscribe) {
|
|
41
|
+
const bus = resolution?.get(entry.bus) ?? entry.busResolved ?? entry.bus;
|
|
42
|
+
lines.push(` 订阅: ${bus} 的 ${entry.event} → ${entry.handler.script}`);
|
|
43
|
+
}
|
|
44
|
+
for (const entry of pack.publish) {
|
|
45
|
+
const bus = resolution?.get(entry.bus) ?? entry.busResolved ?? entry.bus;
|
|
46
|
+
lines.push(` 发布: ${bus} 的 ${entry.event}(本机可发)`);
|
|
47
|
+
}
|
|
48
|
+
if (pack.subscribe.length === 0 && pack.publish.length === 0) {
|
|
49
|
+
lines.push(' (仅登记事件目录,无订阅或发布)');
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
lines.push('');
|
|
53
|
+
lines.push('本机管理: ec events status / ledger / tail');
|
|
54
|
+
lines.push('');
|
|
55
|
+
try {
|
|
56
|
+
fs.mkdirSync(eventsDir, { recursive: true });
|
|
57
|
+
fs.writeFileSync(filePath, lines.join('\n'), 'utf8');
|
|
58
|
+
logger.debug(`[events-index] ${EVENTS_INDEX_FILE} 已生成(${enabledPacks.length} 个包)`);
|
|
59
|
+
}
|
|
60
|
+
catch (error) {
|
|
61
|
+
logger.warn(`[events-index] cannot write index: ${error instanceof Error ? error.message : String(error)}`);
|
|
62
|
+
}
|
|
63
|
+
}
|
|
@@ -0,0 +1,308 @@
|
|
|
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 } 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
|
+
const HELP = `ec events — 事件中心运维
|
|
13
|
+
|
|
14
|
+
用法:
|
|
15
|
+
ec events status [<包名>] [--aid <aid>] 每包状态
|
|
16
|
+
ec events ledger <包名> [--tail N] 台账
|
|
17
|
+
ec events tail <包名> [--tail N] 事件日志
|
|
18
|
+
ec events doctor <包名> 诊断
|
|
19
|
+
ec events reload [<包名>] 重载(重新扫描目录并重建订阅)
|
|
20
|
+
ec events allowlist add <事件> --publish <aid> [--subscribe <aid>]
|
|
21
|
+
ec events allowlist remove <事件> --publish <aid> [--subscribe <aid>]
|
|
22
|
+
ec events allowlist show [--event <事件>]
|
|
23
|
+
ec events publish <包名> <事件> --data '<json>' [--ttl <秒>]`;
|
|
24
|
+
export function parseEventsArgv(argv) {
|
|
25
|
+
const args = [...argv];
|
|
26
|
+
if (args.length === 0 || args[0] === 'help' || args[0] === '--help')
|
|
27
|
+
return { command: 'help', aids: {} };
|
|
28
|
+
const command = args.shift();
|
|
29
|
+
const parsed = { command, aids: {} };
|
|
30
|
+
const consumeValue = (flag) => {
|
|
31
|
+
const index = args.indexOf(flag);
|
|
32
|
+
if (index < 0)
|
|
33
|
+
return undefined;
|
|
34
|
+
const value = args[index + 1];
|
|
35
|
+
if (value === undefined)
|
|
36
|
+
return undefined;
|
|
37
|
+
args.splice(index, 2);
|
|
38
|
+
return value;
|
|
39
|
+
};
|
|
40
|
+
const consumeList = (flag) => {
|
|
41
|
+
const values = [];
|
|
42
|
+
for (;;) {
|
|
43
|
+
const value = consumeValue(flag);
|
|
44
|
+
if (value === undefined)
|
|
45
|
+
break;
|
|
46
|
+
values.push(value);
|
|
47
|
+
}
|
|
48
|
+
return values.length ? values : undefined;
|
|
49
|
+
};
|
|
50
|
+
parsed.aid = consumeValue('--aid');
|
|
51
|
+
const tailRaw = consumeValue('--tail');
|
|
52
|
+
if (tailRaw !== undefined) {
|
|
53
|
+
const tail = Number(tailRaw);
|
|
54
|
+
if (!Number.isInteger(tail) || tail < 1 || tail > 10_000)
|
|
55
|
+
return { error: '--tail must be a positive integer' };
|
|
56
|
+
parsed.tail = tail;
|
|
57
|
+
}
|
|
58
|
+
const ttlRaw = consumeValue('--ttl');
|
|
59
|
+
if (ttlRaw !== undefined) {
|
|
60
|
+
const ttl = Number(ttlRaw);
|
|
61
|
+
if (!Number.isInteger(ttl) || ttl < 1 || ttl > 3600)
|
|
62
|
+
return { error: '--ttl must be an integer in [1, 3600]' };
|
|
63
|
+
parsed.ttl = ttl;
|
|
64
|
+
}
|
|
65
|
+
const dataRaw = consumeValue('--data');
|
|
66
|
+
if (dataRaw !== undefined) {
|
|
67
|
+
try {
|
|
68
|
+
parsed.data = JSON.parse(dataRaw);
|
|
69
|
+
}
|
|
70
|
+
catch {
|
|
71
|
+
return { error: `--data is not valid JSON: ${dataRaw.slice(0, 80)}` };
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
const denyIndex = args.indexOf('--deny');
|
|
75
|
+
if (denyIndex >= 0) {
|
|
76
|
+
parsed.rule = 'deny';
|
|
77
|
+
args.splice(denyIndex, 1);
|
|
78
|
+
}
|
|
79
|
+
parsed.event = consumeValue('--event');
|
|
80
|
+
const publish = consumeList('--publish');
|
|
81
|
+
if (publish)
|
|
82
|
+
parsed.aids.publish = publish;
|
|
83
|
+
const subscribe = consumeList('--subscribe');
|
|
84
|
+
if (subscribe)
|
|
85
|
+
parsed.aids.subscribe = subscribe;
|
|
86
|
+
const positional = args.filter(item => !item.startsWith('-'));
|
|
87
|
+
if (command === 'status' || command === 'ledger' || command === 'tail' || command === 'doctor'
|
|
88
|
+
|| command === 'reload' || command === 'publish') {
|
|
89
|
+
parsed.pack = positional[0];
|
|
90
|
+
if (command === 'publish')
|
|
91
|
+
parsed.event = parsed.event ?? positional[1];
|
|
92
|
+
}
|
|
93
|
+
else if (command === 'allowlist') {
|
|
94
|
+
parsed.command = `allowlist:${positional[0] ?? ''}`;
|
|
95
|
+
parsed.event = parsed.event ?? positional[1];
|
|
96
|
+
}
|
|
97
|
+
return parsed;
|
|
98
|
+
}
|
|
99
|
+
function resolveAid(deps, parsed) {
|
|
100
|
+
if (parsed.aid)
|
|
101
|
+
return { aid: parsed.aid };
|
|
102
|
+
const units = [...deps.registry.values()];
|
|
103
|
+
if (units.length === 1)
|
|
104
|
+
return { aid: units[0].aid };
|
|
105
|
+
const fallback = deps.defaultAid?.();
|
|
106
|
+
if (fallback && units.some(unit => unit.aid === fallback))
|
|
107
|
+
return { aid: fallback };
|
|
108
|
+
if (units.length === 0) {
|
|
109
|
+
return { error: { ok: false, code: 'NO_AGENT', error: 'no event center units started; pass --aid <aid>' } };
|
|
110
|
+
}
|
|
111
|
+
return { error: { ok: false, code: 'AGENT_REQUIRED', error: `multiple agents: ${units.map(unit => unit.aid).join(', ')}; pass --aid <aid>` } };
|
|
112
|
+
}
|
|
113
|
+
export function createEventsOperationExecutor(deps) {
|
|
114
|
+
return async (request) => {
|
|
115
|
+
let parsed;
|
|
116
|
+
try {
|
|
117
|
+
parsed = parseEventsArgv(request.argv ?? []);
|
|
118
|
+
}
|
|
119
|
+
catch (error) {
|
|
120
|
+
return { ok: false, code: 'INVALID_ARGV', error: errorMessage(error) };
|
|
121
|
+
}
|
|
122
|
+
if ('error' in parsed)
|
|
123
|
+
return { ok: false, code: 'INVALID_ARGV', error: parsed.error };
|
|
124
|
+
try {
|
|
125
|
+
return await execute(deps, parsed);
|
|
126
|
+
}
|
|
127
|
+
catch (error) {
|
|
128
|
+
if (error instanceof EventCenterError) {
|
|
129
|
+
return { ok: false, code: error.code, error: error.message };
|
|
130
|
+
}
|
|
131
|
+
const message = errorMessage(error);
|
|
132
|
+
const code = /\b([A-Z][A-Z0-9_]{3,})\b/.exec(message)?.[1] ?? 'INTERNAL_ERROR';
|
|
133
|
+
logger.warn(`[EventCenter] events.op failed: ${code}: ${message}`);
|
|
134
|
+
return { ok: false, code, error: message };
|
|
135
|
+
}
|
|
136
|
+
};
|
|
137
|
+
}
|
|
138
|
+
async function execute(deps, parsed) {
|
|
139
|
+
const { command } = parsed;
|
|
140
|
+
if (command === 'help')
|
|
141
|
+
return { ok: true, result: { help: HELP } };
|
|
142
|
+
if (command === 'reload') {
|
|
143
|
+
const target = resolveAid(deps, parsed);
|
|
144
|
+
if (target.error)
|
|
145
|
+
return target.error;
|
|
146
|
+
await deps.registry.reload(target.aid);
|
|
147
|
+
const unit = deps.registry.get(target.aid);
|
|
148
|
+
return { ok: true, result: { aid: target.aid, packs: unit?.state.enabledPacks.map(pack => pack.id) ?? [] } };
|
|
149
|
+
}
|
|
150
|
+
const target = resolveAid(deps, parsed);
|
|
151
|
+
if (target.error)
|
|
152
|
+
return target.error;
|
|
153
|
+
const aid = target.aid;
|
|
154
|
+
const unit = deps.registry.get(aid);
|
|
155
|
+
if (!unit)
|
|
156
|
+
return { ok: false, code: 'AGENT_NOT_STARTED', error: `event center not started for ${aid}` };
|
|
157
|
+
switch (command) {
|
|
158
|
+
case 'status': {
|
|
159
|
+
if (parsed.pack) {
|
|
160
|
+
const pack = unit.state.enabledPacks.find(candidate => candidate.id === parsed.pack);
|
|
161
|
+
if (!pack)
|
|
162
|
+
return { ok: false, code: 'PACK_NOT_FOUND', error: `pack not found or invalid: ${parsed.pack}` };
|
|
163
|
+
return { ok: true, result: { aid, pack: packStatus(unit, pack.id) } };
|
|
164
|
+
}
|
|
165
|
+
const runtimeStatus = unit.runtime.status();
|
|
166
|
+
return {
|
|
167
|
+
ok: true,
|
|
168
|
+
result: {
|
|
169
|
+
aid,
|
|
170
|
+
bus: runtimeStatus.bus,
|
|
171
|
+
subscriptions: runtimeStatus.subscriptions,
|
|
172
|
+
publishers: runtimeStatus.publishers,
|
|
173
|
+
packs: [
|
|
174
|
+
...unit.state.enabledPacks.map(pack => packStatus(unit, pack.id)),
|
|
175
|
+
...unit.state.disabledPacks.map(id => ({ id, status: 'disabled' })),
|
|
176
|
+
...unit.state.invalidPacks.map(item => ({ id: item.id, status: 'invalid', errors: item.errors })),
|
|
177
|
+
],
|
|
178
|
+
},
|
|
179
|
+
};
|
|
180
|
+
}
|
|
181
|
+
case 'ledger': {
|
|
182
|
+
const pack = requirePack(unit, parsed.pack);
|
|
183
|
+
if ('ok' in pack)
|
|
184
|
+
return pack;
|
|
185
|
+
const lines = new Ledger(pack.paths.ledger).tail(parsed.tail ?? 20);
|
|
186
|
+
return { ok: true, result: { aid, pack: pack.id, lines } };
|
|
187
|
+
}
|
|
188
|
+
case 'tail': {
|
|
189
|
+
const pack = requirePack(unit, parsed.pack);
|
|
190
|
+
if ('ok' in pack)
|
|
191
|
+
return pack;
|
|
192
|
+
const lines = EventLog.forPack(pack).tail(parsed.tail ?? 20);
|
|
193
|
+
return { ok: true, result: { aid, pack: pack.id, lines } };
|
|
194
|
+
}
|
|
195
|
+
case 'doctor': {
|
|
196
|
+
const pack = requirePack(unit, parsed.pack);
|
|
197
|
+
if ('ok' in pack)
|
|
198
|
+
return pack;
|
|
199
|
+
const findings = await doctor(unit, pack.id);
|
|
200
|
+
return { ok: true, result: { aid, pack: pack.id, findings } };
|
|
201
|
+
}
|
|
202
|
+
case 'allowlist:show': {
|
|
203
|
+
const { config } = unit.centerStore.read();
|
|
204
|
+
const entries = parsed.event
|
|
205
|
+
? { [parsed.event]: config.allowlist[parsed.event] ?? { allow: { publish: [], subscribe: [] }, deny: { publish: [], subscribe: [] } } }
|
|
206
|
+
: config.allowlist;
|
|
207
|
+
return { ok: true, result: { aid, enabled: config.enabled, authMode: config.authMode, allowlist: entries } };
|
|
208
|
+
}
|
|
209
|
+
case 'allowlist:add':
|
|
210
|
+
case 'allowlist:remove': {
|
|
211
|
+
if (!parsed.event)
|
|
212
|
+
return { ok: false, code: 'INVALID_ARGV', error: 'allowlist add/remove requires <event>' };
|
|
213
|
+
if (!unit.state.catalog.some(entry => entry.event === parsed.event))
|
|
214
|
+
return { ok: false, code: 'EVENT_NOT_FOUND', error: `event is not registered: ${parsed.event}` };
|
|
215
|
+
if (!parsed.aids.publish && !parsed.aids.subscribe) {
|
|
216
|
+
return { ok: false, code: 'INVALID_ARGV', error: 'allowlist add/remove requires --publish <aid> and/or --subscribe <aid>' };
|
|
217
|
+
}
|
|
218
|
+
const action = command === 'allowlist:add' ? 'add' : 'remove';
|
|
219
|
+
const applied = {};
|
|
220
|
+
for (const role of ['publish', 'subscribe']) {
|
|
221
|
+
const aids = parsed.aids[role];
|
|
222
|
+
if (!aids)
|
|
223
|
+
continue;
|
|
224
|
+
const result = unit.centerStore.mutateAllowlist({ event: parsed.event, action, role, rule: parsed.rule, aids });
|
|
225
|
+
applied[role] = { added: result.added, removed: result.removed };
|
|
226
|
+
// 联动 Bus:白名单变更立即生效(updateConfig)。
|
|
227
|
+
const materialized = materializeAllowlist(result.config, unit.agentDir, unit.aid);
|
|
228
|
+
if (result.config.enabled && unit.state.catalog.length > 0 && !materialized.degraded) {
|
|
229
|
+
await unit.runtime.busHost.apply({
|
|
230
|
+
catalog: toSdkCatalog(unit.state.catalog),
|
|
231
|
+
allowlist: materialized.allowlist,
|
|
232
|
+
});
|
|
233
|
+
}
|
|
234
|
+
}
|
|
235
|
+
return { ok: true, result: { aid, event: parsed.event, applied } };
|
|
236
|
+
}
|
|
237
|
+
case 'publish': {
|
|
238
|
+
if (!parsed.pack || !parsed.event)
|
|
239
|
+
return { ok: false, code: 'INVALID_ARGV', error: 'publish requires <pack> <event>' };
|
|
240
|
+
if (parsed.data === undefined)
|
|
241
|
+
return { ok: false, code: 'INVALID_ARGV', error: 'publish requires --data <json>' };
|
|
242
|
+
if (typeof parsed.data !== 'object' || parsed.data === null || Array.isArray(parsed.data)) {
|
|
243
|
+
return { ok: false, code: 'INVALID_ARGV', error: '--data must be a JSON object' };
|
|
244
|
+
}
|
|
245
|
+
const eventId = await unit.runtime.publish(parsed.pack, parsed.event, parsed.data, parsed.ttl);
|
|
246
|
+
return { ok: true, result: { aid, pack: parsed.pack, event: parsed.event, eventId } };
|
|
247
|
+
}
|
|
248
|
+
default:
|
|
249
|
+
return { ok: false, code: 'UNKNOWN_COMMAND', error: `unknown events command: ${command}\n${HELP}` };
|
|
250
|
+
}
|
|
251
|
+
}
|
|
252
|
+
function packStatus(unit, packId) {
|
|
253
|
+
const pack = unit.state.enabledPacks.find(candidate => candidate.id === packId);
|
|
254
|
+
if (!pack)
|
|
255
|
+
return { id: packId, status: 'invalid' };
|
|
256
|
+
const resolution = unit.runtime.resolutions.get(packId);
|
|
257
|
+
return {
|
|
258
|
+
id: pack.id,
|
|
259
|
+
name: pack.name,
|
|
260
|
+
status: 'active',
|
|
261
|
+
registers: pack.register.map(entry => entry.event),
|
|
262
|
+
publishes: pack.publish.map(entry => ({ bus: entry.bus, resolved: resolution?.get(entry.bus) ?? entry.busResolved, event: entry.event })),
|
|
263
|
+
subscribes: pack.subscribe.map(entry => ({ bus: entry.bus, resolved: resolution?.get(entry.bus) ?? entry.busResolved, event: entry.event })),
|
|
264
|
+
};
|
|
265
|
+
}
|
|
266
|
+
function requirePack(unit, packId) {
|
|
267
|
+
if (!packId)
|
|
268
|
+
return { ok: false, code: 'INVALID_ARGV', error: 'command requires <pack>' };
|
|
269
|
+
const pack = unit.state.enabledPacks.find(candidate => candidate.id === packId);
|
|
270
|
+
if (!pack)
|
|
271
|
+
return { ok: false, code: 'PACK_NOT_FOUND', error: `pack not found or invalid: ${packId}` };
|
|
272
|
+
return pack;
|
|
273
|
+
}
|
|
274
|
+
/** 诊断:重新加载包目录 + 检查脚本/解析/白名单。 */
|
|
275
|
+
async function doctor(unit, packId) {
|
|
276
|
+
const findings = [];
|
|
277
|
+
const pack = unit.state.enabledPacks.find(candidate => candidate.id === packId);
|
|
278
|
+
if (!pack) {
|
|
279
|
+
const invalid = unit.state.invalidPacks.find(item => item.id === packId);
|
|
280
|
+
return invalid
|
|
281
|
+
? [{ level: 'error', check: 'pack.json', detail: invalid.errors.join('; ') }]
|
|
282
|
+
: [{ level: 'error', check: 'pack', detail: 'pack not found' }];
|
|
283
|
+
}
|
|
284
|
+
findings.push({ level: 'ok', check: 'pack.json', detail: 'valid' });
|
|
285
|
+
// 重新加载做文件系统复查(脚本存在性 / realpath 越界)。
|
|
286
|
+
const errors = [];
|
|
287
|
+
loadPackDir(pack.dir, errors);
|
|
288
|
+
findings.push(errors.length
|
|
289
|
+
? { level: 'error', check: 'scripts', detail: errors.join('; ') }
|
|
290
|
+
: { level: 'ok', check: 'scripts', detail: 'all scripts present' });
|
|
291
|
+
const resolution = unit.runtime.resolutions.get(packId);
|
|
292
|
+
const unresolved = [...pack.subscribe, ...pack.publish]
|
|
293
|
+
.filter(entry => !(resolution?.get(entry.bus) ?? entry.busResolved))
|
|
294
|
+
.map(entry => entry.bus);
|
|
295
|
+
findings.push(unresolved.length
|
|
296
|
+
? { level: 'error', check: 'bus-resolve', detail: `unresolved: ${unresolved.join(', ')}` }
|
|
297
|
+
: { level: 'ok', check: 'bus-resolve', detail: 'all buses resolved' });
|
|
298
|
+
const { config } = unit.centerStore.read();
|
|
299
|
+
if (pack.register.length > 0 && !config.enabled) {
|
|
300
|
+
findings.push({ level: 'warn', check: 'center', detail: 'register entries exist but center.json enabled=false; bus not started' });
|
|
301
|
+
}
|
|
302
|
+
for (const entry of pack.register) {
|
|
303
|
+
if (!config.allowlist[entry.event]) {
|
|
304
|
+
findings.push({ level: 'warn', check: 'allowlist', detail: `no allowlist entry for ${entry.event}; nobody may publish/subscribe` });
|
|
305
|
+
}
|
|
306
|
+
}
|
|
307
|
+
return findings;
|
|
308
|
+
}
|