fde-console 0.0.0-stage → 2.9.68

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 (85) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +128 -2
  3. package/README.zh-CN.md +130 -0
  4. package/assets/icon.svg +9 -0
  5. package/cordis.patch.yml +7 -0
  6. package/lib/agentActivity.js +1180 -0
  7. package/lib/agentContext.js +146 -0
  8. package/lib/agentTranscript.js +1398 -0
  9. package/lib/analyze.js +625 -0
  10. package/lib/attribute.js +205 -0
  11. package/lib/backup.js +366 -0
  12. package/lib/desktopAgents.js +123 -0
  13. package/lib/diary.js +333 -0
  14. package/lib/dingtalk.js +412 -0
  15. package/lib/feishu.js +580 -0
  16. package/lib/giteaClient.js +810 -0
  17. package/lib/giteeClient.js +372 -0
  18. package/lib/githubClient.js +361 -0
  19. package/lib/heatmap.js +99 -0
  20. package/lib/imNotify.js +378 -0
  21. package/lib/inbox.js +438 -0
  22. package/lib/instanceLock.js +122 -0
  23. package/lib/jobs.js +56 -0
  24. package/lib/learn.js +1388 -0
  25. package/lib/learnImport.js +283 -0
  26. package/lib/learnSeeds.js +97 -0
  27. package/lib/learnSeedsAiEng.js +77 -0
  28. package/lib/mcpCore.js +135 -0
  29. package/lib/members.js +160 -0
  30. package/lib/migration.js +403 -0
  31. package/lib/overview.js +376 -0
  32. package/lib/postmortem.js +148 -0
  33. package/lib/radarIgnore.js +134 -0
  34. package/lib/redact.js +76 -0
  35. package/lib/router.js +246 -0
  36. package/lib/routes-gitea.js +262 -0
  37. package/lib/routes-setup.js +40 -0
  38. package/lib/scorecard.js +111 -0
  39. package/lib/sessionRef.js +227 -0
  40. package/lib/sessionSnapshot.js +67 -0
  41. package/lib/sessionSuggest.js +186 -0
  42. package/lib/settings.js +783 -0
  43. package/lib/setupCheck.js +330 -0
  44. package/lib/ssrfGuard.js +145 -0
  45. package/lib/store.js +564 -0
  46. package/lib/storeDb.js +418 -0
  47. package/lib/taskEvents.js +243 -0
  48. package/lib/webhookOut.js +125 -0
  49. package/lib/weekly.js +439 -0
  50. package/lib/workSearch.js +220 -0
  51. package/locale/en.json +6 -0
  52. package/locale/zh.json +6 -0
  53. package/package.json +46 -4
  54. package/plugin/adapter.js +157 -0
  55. package/plugin/client.js +282 -0
  56. package/plugin/index.mjs +116 -0
  57. package/plugin/static.js +99 -0
  58. package/scripts/backup-data.js +41 -0
  59. package/scripts/mcp-server.mjs +68 -0
  60. package/scripts/migrate-data.js +301 -0
  61. package/scripts/migrate-storage.js +47 -0
  62. package/scripts/seed-demo.js +200 -0
  63. package/scripts/write-agent-context.js +43 -0
  64. package/test/helpers/appAssembler.js +1078 -0
  65. package/web/client/fde-client.js +292 -0
  66. package/web/css/app.css +1510 -0
  67. package/web/index.html +69 -0
  68. package/web/js/api.js +72 -0
  69. package/web/js/app.js +313 -0
  70. package/web/js/icons.js +48 -0
  71. package/web/js/mock.js +1150 -0
  72. package/web/js/state.js +7 -0
  73. package/web/js/ui.js +276 -0
  74. package/web/js/views/activity.js +410 -0
  75. package/web/js/views/agents.js +892 -0
  76. package/web/js/views/board.js +1656 -0
  77. package/web/js/views/learn.js +530 -0
  78. package/web/js/views/members.js +344 -0
  79. package/web/js/views/onboarding.js +103 -0
  80. package/web/js/views/overview.js +508 -0
  81. package/web/js/views/radar.js +1359 -0
  82. package/web/js/views/search.js +149 -0
  83. package/web/js/views/settings.js +1351 -0
  84. package/web/js/views/topology.js +471 -0
  85. package/web/mock.json +2363 -0
package/lib/store.js ADDED
@@ -0,0 +1,564 @@
1
+ 'use strict';
2
+
3
+ /**
4
+ * store.js — JSON 文件存储层
5
+ * - 原子写:tmp 文件 + renameSync(进程崩溃不损坏目标文件)
6
+ * - data/ 目录惰性创建:读操作不落盘,首次写操作时 mkdir -p
7
+ * - 配置/注册表缺省时按 SPEC §5 引导生成
8
+ */
9
+
10
+ const fs = require('fs');
11
+ const path = require('path');
12
+ const { HttpError } = require('./router');
13
+ const storeDb = require('./storeDb');
14
+
15
+ /**
16
+ * 损坏隔离(qoder #2):readJSON 解析失败时先把原文件改名 *.corrupt-<时间戳> 保全,
17
+ * 再回退默认值并登记 degraded;degraded 期间对该文件的写操作一律 503 DATA_DEGRADED,
18
+ * 防止一次成功写把原数据永久覆盖。恢复(文件被修复/删除且重新读取成功)后自动解除。
19
+ */
20
+ const degradedFiles = new Set();
21
+
22
+ function markDegraded(file, reason) {
23
+ degradedFiles.add(path.resolve(file));
24
+ console.warn(`[store] ${file} 已进入降级态: ${reason}(写操作将返回 503,恢复合法文件并重新读取后解除)`);
25
+ }
26
+
27
+ function isDegraded(file) {
28
+ return degradedFiles.has(path.resolve(file));
29
+ }
30
+
31
+ function readDegraded() {
32
+ return degradedFiles;
33
+ }
34
+
35
+ // ---------- 内置默认 ----------
36
+
37
+ const DEFAULT_COLUMNS = [
38
+ { id: 'todo', name: '待分配', order: 1 },
39
+ { id: 'doing', name: '进行中', order: 2 },
40
+ { id: 'review', name: '待验证', order: 3 },
41
+ { id: 'done', name: '已完成', order: 4 },
42
+ ];
43
+
44
+ // SPEC §5:内置 9 项 id 固定;commandTemplate 一律 "<command> \"{briefing}\""
45
+ const BUILTIN_AGENT_DEFS = [
46
+ ['opencode', 'opencode'],
47
+ ['crush', 'Crush'],
48
+ ['kilo', 'Kilo'],
49
+ ['mcode', 'mcode'],
50
+ ['goose', 'Goose'],
51
+ ['codex', 'Codex'],
52
+ ['claude', 'Claude Code'],
53
+ ['dsh', 'DSH'],
54
+ ['demo-team', 'DemoBot'],
55
+ ];
56
+
57
+ function builtinAgents() {
58
+ return BUILTIN_AGENT_DEFS.map(([id, name]) => ({
59
+ id,
60
+ name,
61
+ command: id,
62
+ commandTemplate: `${id} "{briefing}"`,
63
+ builtin: true,
64
+ enabled: true,
65
+ }));
66
+ }
67
+
68
+ const DEFAULT_CONFIG = {
69
+ port: 7788,
70
+ host: '127.0.0.1',
71
+ dataDir: 'data',
72
+ webDir: 'web',
73
+ gitea: {
74
+ baseUrl: 'https://gitea.example.com',
75
+ apiPrefix: '/api/v1',
76
+ org: 'example-org',
77
+ pollIntervalSec: 60,
78
+ staleWarnSec: 14400,
79
+ staleDangerSec: 86400,
80
+ hostWhitelist: ['gitea.example.com'],
81
+ // feeds 词表(giteaClient activities/feeds 数据源):与 giteaClient.DEFAULTS 同步
82
+ activityTypes: ['pr', 'commit', 'branch_created', 'branch_deleted'],
83
+ feedsLimit: 50,
84
+ maxActivities: 500,
85
+ // v2.9.2 忽略账号:Gitea 组织接口派生成员时的排除名单(默认过滤 admin,大小写不敏感)
86
+ ignoreLogins: ['admin'],
87
+ },
88
+ // v2.9 GitHub 组织动态源(lib/githubClient.js):默认关闭零出网;开启需 config.json 手改
89
+ // (org + enabled),凭据走 git config http.https://api.github.com/.extraheader(零落盘纪律同 Gitea)
90
+ github: {
91
+ enabled: false,
92
+ baseUrl: 'https://api.github.com',
93
+ org: '',
94
+ eventsPages: 3, // 每页 per_page=100,3 页 = GitHub org events 上限 300 条
95
+ hostWhitelist: ['api.github.com'],
96
+ },
97
+ // v2.9.18 Gitee(gitee.com)组织动态源:默认关闭零出网;开启经设置页或 config.json 手改
98
+ // (org + enabled),凭据走 git config http.https://gitee.com/.extraheader(值=私人令牌原文)
99
+ gitee: {
100
+ enabled: false,
101
+ baseUrl: 'https://gitee.com',
102
+ org: '',
103
+ eventsPages: 3,
104
+ hostWhitelist: ['gitee.com'],
105
+ },
106
+ security: {
107
+ allowedProtocols: ['https'],
108
+ credentialSource: 'git-config-extraheader',
109
+ redactKeys: ['Authorization', 'extraheader'],
110
+ },
111
+ // v2.9.27 Webhook 事件出口:默认关闭零出网;url 可含下游令牌(config.json 为既有配置落点,
112
+ // 同钉钉 dws 凭据先例;错误出口 scrubUrl+redact 双防线);仅 config.json 手改(暂不进设置页)
113
+ webhookOut: {
114
+ enabled: false,
115
+ url: '',
116
+ },
117
+ // v2.9.39 IM 通知出口(飞书/钉钉自定义机器人):默认关闭零出网。url 内含机器人 token,属凭据——
118
+ // 与 webhookOut 同落点(config.json)同纪律:设置页只回显 host+尾号,错误出口 scrubUrl+redact;
119
+ // secret(加签密钥)只在本进程内存里参与 HMAC,不进日志、不进响应。
120
+ // digest.at 为本地时间 HH:MM;events 只开「待验收/已完成」两类(其余事件不打扰)。
121
+ im: {
122
+ enabled: false,
123
+ digest: { enabled: false, at: '09:10' },
124
+ events: { review: false, completed: false },
125
+ targets: [],
126
+ },
127
+ // v2.9.41 数据备份;v2.9.42 **默认关闭**(业主判断:本地单机数据,不值得每天备一份;
128
+ // 本地备份也防不住盘坏,真要有异地保护应把整个 fde-console 目录挂同步盘)。
129
+ // 需要时改 config.json 的 backup.enabled=true,或直接跑 scripts/backup-data.js。
130
+ backup: {
131
+ enabled: false,
132
+ keep: 14,
133
+ at: '09:05',
134
+ },
135
+ // v2.9.44 知识库学习模式:**默认关闭**(未配置 = 功能不存在)。root 为本地知识库绝对路径,
136
+ // **只读**(只 readdir/stat/readFile,绝不写 vault);scope 限定扫描目录,exclude 是减压阀。
137
+ // 契约见 docs/SPEC-LEARN.md。
138
+ learn: {
139
+ enabled: false,
140
+ root: '',
141
+ scope: ['wiki'],
142
+ exclude: [],
143
+ // v2.9.52 内置主题(工程侧基础概念,随插件走;与 vault 抽出的知识点按单双日交替出题)。
144
+ // 空数组 = 完全只用知识库;可选主题名见 lib/learnSeeds.js
145
+ seeds: ['模型与推理', 'AI 工程', 'Java', 'Agent 开发', 'Python'],
146
+ dailyNew: 1,
147
+ dailyReview: 3,
148
+ minutes: 15,
149
+ engine: { mode: 'auto', timeoutSec: 180, reasoningEffort: 'off', maxTokens: 1200 },
150
+ },
151
+ // 任务雷达(PRD-task-inbox §4):钉钉听记通道 + AI 拆解引擎
152
+ // dwsBin/dshBin 缺省空串 = 运行时按已知安装位置自动解析(见 lib/dingtalk.js resolveDwsBin / lib/analyze.js resolveDshBin)
153
+ dingtalk: {
154
+ enabled: true,
155
+ dwsBin: '',
156
+ dwsTimeoutSec: 60,
157
+ maxMessages: 200,
158
+ hostWhitelist: ['dingtalk.com'],
159
+ },
160
+ // 飞书妙记通道(2026-11-03,lark-cli 桥接,与 dingtalk 同构):enabled 默认 false——
161
+ // 未装 lark-cli/未授权的机器 = 功能不存在(learn 节同款口径);larkBin 空串 = 运行时自动解析
162
+ //(lib/feishu.js resolveLarkBin);lookbackDays 回溯期按 ≤31 天分窗搜索(飞书官方约束)
163
+ feishu: {
164
+ enabled: false,
165
+ larkBin: '',
166
+ larkTimeoutSec: 60,
167
+ maxMessages: 200,
168
+ lookbackDays: 90,
169
+ hostWhitelist: ['feishu.cn', 'larksuite.com'],
170
+ },
171
+ analyze: {
172
+ dshBin: '',
173
+ // v1.5(goose 验收 P1-B):120s 在真实听记下最短条(55 段)都有 2/3 概率超时,缺省提到 300s;
174
+ // 长会上不封顶但可观测——重试自动升压 ×2 且 job 记录 attempt/timeoutSec(见 lib/analyze.js)
175
+ timeoutSec: 300,
176
+ maxTasksPerMessage: 10,
177
+ maxPromptChars: 24000,
178
+ },
179
+ };
180
+ // v2.2:DEFAULT_CONFIG.gateway 已随 网关集成整体移除(业主 2026-10-20;
181
+ // 磁盘旧 config.json 的遗留 gateway 节由 mergeConfigDefaults 静默剥除)
182
+ // 智能体工作观测(v2.2):四源适配器节默认值统一取自 lib/agentActivity.js
183
+ //(路径留空串 = 运行时回退本机默认位置 ~/.zcode/cli、~/.claude/projects、~/.dsh/sessions、~/.workbuddy/workbuddy.db)
184
+ DEFAULT_CONFIG.agentActivity = require('./agentActivity').DEFAULT_AGENT_ACTIVITY;
185
+
186
+ // ---------- 基础工具 ----------
187
+
188
+ function clone(v) {
189
+ return v === undefined ? v : JSON.parse(JSON.stringify(v));
190
+ }
191
+
192
+ function isPlainObject(v) {
193
+ return v !== null && typeof v === 'object' && !Array.isArray(v);
194
+ }
195
+
196
+ function randomToken(n) {
197
+ let s = '';
198
+ while (s.length < n) s += Math.random().toString(36).slice(2);
199
+ return s.slice(0, n);
200
+ }
201
+
202
+ /** 原子写:tmp + renameSync(finally 清理 tmp);目录不存在则惰性创建;degraded 文件拒绝写 */
203
+ function writeJSON(file, data) {
204
+ const resolved = path.resolve(file);
205
+ if (degradedFiles.has(resolved)) {
206
+ throw new HttpError(
207
+ 503,
208
+ 'DATA_DEGRADED',
209
+ `${path.basename(file)} 此前损坏已隔离为 *.corrupt-* 备份,请先恢复该文件再写(详见服务日志)`
210
+ );
211
+ }
212
+ fs.mkdirSync(path.dirname(file), { recursive: true });
213
+ const tmp = `${file}.tmp-${process.pid}-${Date.now().toString(36)}-${randomToken(6)}`;
214
+ let done = false;
215
+ try {
216
+ fs.writeFileSync(tmp, JSON.stringify(data, null, 2) + '\n', 'utf8');
217
+ fs.renameSync(tmp, file);
218
+ done = true;
219
+ } finally {
220
+ if (!done) {
221
+ try {
222
+ fs.unlinkSync(tmp);
223
+ } catch (e) { /* tmp 不存在 */ }
224
+ }
225
+ }
226
+ }
227
+
228
+ /** 读取 JSON;缺失回退;损坏时隔离原文件为 *.corrupt-<时间戳> 后回退(qoder #2) */
229
+ function readJSON(file, fallback) {
230
+ const resolved = path.resolve(file);
231
+ let raw;
232
+ try {
233
+ raw = fs.readFileSync(file, 'utf8');
234
+ } catch (e) {
235
+ // 注意:ENOENT 不解除降级——隔离正是通过改名使文件暂缺,此处清标志会让写保护失效;
236
+ // 唯一解除途径是恢复的合法文件被成功解析
237
+ if (e && e.code === 'ENOENT') return clone(fallback);
238
+ throw e;
239
+ }
240
+ try {
241
+ const parsed = JSON.parse(raw);
242
+ degradedFiles.delete(resolved); // 真实文件解析成功,解除降级
243
+ return parsed;
244
+ } catch (e) {
245
+ const stamp = new Date().toISOString().replace(/[:.]/g, '-');
246
+ const backup = `${file}.corrupt-${stamp}`;
247
+ try {
248
+ fs.renameSync(file, backup);
249
+ console.warn(`[store] ${file} 解析失败,原文件已保全为 ${backup}`);
250
+ } catch (renameErr) {
251
+ console.error(`[store] ${file} 解析失败且隔离失败: ${renameErr.message}`);
252
+ }
253
+ markDegraded(file, e.message);
254
+ return clone(fallback);
255
+ }
256
+ }
257
+
258
+ // ---------- config.json ----------
259
+
260
+ function mergeConfigDefaults(cfg) {
261
+ const d = clone(DEFAULT_CONFIG);
262
+ const out = {};
263
+ for (const k of ['port', 'host', 'dataDir', 'webDir']) {
264
+ out[k] = cfg && cfg[k] !== undefined ? cfg[k] : d[k];
265
+ }
266
+ out.gitea = Object.assign(d.gitea, isPlainObject(cfg && cfg.gitea) ? cfg.gitea : {});
267
+ // v2.9 GitHub 源节(不并入会被这里的显式键名单静默剥掉——历史教训见 gitea 老词表事故)
268
+ out.github = Object.assign(d.github, isPlainObject(cfg && cfg.github) ? cfg.github : {});
269
+ // v2.9.18 Gitee 源节(同款显式键名单纪律——不并入会被静默剥掉)
270
+ out.gitee = Object.assign(d.gitee, isPlainObject(cfg && cfg.gitee) ? cfg.gitee : {});
271
+ out.security = Object.assign(d.security, isPlainObject(cfg && cfg.security) ? cfg.security : {});
272
+ out.dingtalk = Object.assign(d.dingtalk, isPlainObject(cfg && cfg.dingtalk) ? cfg.dingtalk : {});
273
+ // 飞书妙记通道节(同款显式键名单纪律——不并入会被静默剥掉)
274
+ out.feishu = Object.assign(d.feishu, isPlainObject(cfg && cfg.feishu) ? cfg.feishu : {});
275
+ out.analyze = Object.assign(d.analyze, isPlainObject(cfg && cfg.analyze) ? cfg.analyze : {});
276
+ // v2.9.27 Webhook 事件出口(同款显式键名单纪律——不并入会被静默剥掉)
277
+ out.webhookOut = Object.assign(d.webhookOut, isPlainObject(cfg && cfg.webhookOut) ? cfg.webhookOut : {});
278
+ // v2.9.39 IM 通知(同纪律;digest/events 子节深合并,targets 数组整体替换)
279
+ const im = isPlainObject(cfg && cfg.im) ? cfg.im : {};
280
+ out.im = Object.assign({}, d.im, im, {
281
+ digest: Object.assign({}, d.im.digest, isPlainObject(im.digest) ? im.digest : {}),
282
+ events: Object.assign({}, d.im.events, isPlainObject(im.events) ? im.events : {}),
283
+ targets: Array.isArray(im.targets) ? im.targets : [],
284
+ });
285
+ // v2.9.41 数据备份(同款显式键名单纪律——不并入会被静默剥掉)
286
+ out.backup = Object.assign(d.backup, isPlainObject(cfg && cfg.backup) ? cfg.backup : {});
287
+ // v2.9.44 知识库学习(engine 子节深合并;scope/exclude 数组直取,防部分配置丢默认值)
288
+ const learn = isPlainObject(cfg && cfg.learn) ? cfg.learn : {};
289
+ out.learn = Object.assign({}, d.learn, learn, {
290
+ scope: Array.isArray(learn.scope) && learn.scope.length ? learn.scope : d.learn.scope,
291
+ exclude: Array.isArray(learn.exclude) ? learn.exclude : [],
292
+ seeds: Array.isArray(learn.seeds) ? learn.seeds : d.learn.seeds.slice(),
293
+ engine: Object.assign({}, d.learn.engine, isPlainObject(learn.engine) ? learn.engine : {}),
294
+ });
295
+ // v2.2:网关集成已移除——磁盘遗留 gateway 节不并入运行期 config(静默剥除)
296
+ // v2.2 智能体工作观测:sources 子节需深合并(局部配置不得丢其他源默认开关/路径)
297
+ out.agentActivity = require('./agentActivity').normalizeAgentActivity(cfg && cfg.agentActivity);
298
+ return out;
299
+ }
300
+
301
+ /** 读取配置;文件缺失则按 §5 默认值引导生成 */
302
+ function loadOrCreateConfig(configPath) {
303
+ if (!fs.existsSync(configPath)) {
304
+ writeJSON(configPath, DEFAULT_CONFIG);
305
+ console.log(`[config] 已生成默认 config.json: ${configPath}`);
306
+ }
307
+ const raw = readJSON(configPath, null);
308
+ if (!isPlainObject(raw)) {
309
+ throw new Error(`config.json 无法解析为对象: ${configPath}`);
310
+ }
311
+ return mergeConfigDefaults(raw);
312
+ }
313
+
314
+ // ---------- agents.json ----------
315
+
316
+ function loadAgents(agentsPath) {
317
+ const d = readJSON(agentsPath, null);
318
+ if (d && Array.isArray(d.agents)) {
319
+ return d.agents.filter((a) => a && typeof a.id === 'string');
320
+ }
321
+ return builtinAgents();
322
+ }
323
+
324
+ function saveAgents(agentsPath, agents) {
325
+ writeJSON(agentsPath, { agents });
326
+ }
327
+
328
+ /** 首次运行引导生成 agents.json(内置 9 项) */
329
+ function loadOrCreateAgentsFile(agentsPath) {
330
+ if (!fs.existsSync(agentsPath)) {
331
+ const agents = builtinAgents();
332
+ saveAgents(agentsPath, agents);
333
+ console.log(`[agents] 已生成默认 agents.json(内置 ${agents.length} 项): ${agentsPath}`);
334
+ return agents;
335
+ }
336
+ return loadAgents(agentsPath);
337
+ }
338
+
339
+ // ---------- members.json(v1.2 手工名册;项目根配置文件,API 写回) ----------
340
+
341
+ /** 容错读取手工名册:缺失/形态不符回退 [];损坏时走 readJSON 的隔离+降级保护 */
342
+ function loadMembers(membersPath) {
343
+ const d = readJSON(membersPath, null);
344
+ let list = [];
345
+ if (isPlainObject(d) && Array.isArray(d.members)) list = d.members;
346
+ else if (Array.isArray(d)) list = d; // 容忍裸数组形态
347
+ return list.filter((m) => m && isPlainObject(m) && typeof m.id === 'string' && typeof m.name === 'string');
348
+ }
349
+
350
+ function saveMembers(membersPath, members) {
351
+ writeJSON(membersPath, { members });
352
+ }
353
+
354
+ /**
355
+ * 聚合名册快照(v1.5 goose 验收 P1-A):说话人映射与负责人建议的统一匹配源——
356
+ * 手工名册(enabled≠false 的条目,aliases/name)∪ Gitea 成员缓存(id=login,name=full_name)。
357
+ * 智能体不入册(负责人建议只对人);手工条目已认领的 giteaLogin 吸收为其别名(与
358
+ * overview 的 claimedLogins 归因口径一致,防同人双 id 分裂),该派生条目不再重复出现。
359
+ * @returns [{id, name, aliases, source:'manual'|'gitea'}]
360
+ * analyze 的 prompt 名册 / resolveSpeaker 匹配 / coerceResult 校验共用此快照,勿在调用方各自拼装。
361
+ */
362
+ function aggregateRoster(ctx) {
363
+ const out = [];
364
+ const seen = new Set();
365
+ const claimedLogins = new Map(); // 小写 login → 手工条目(吸收为别名)
366
+ if (ctx.membersPath) {
367
+ for (const m of loadMembers(ctx.membersPath)) {
368
+ if (m.enabled === false) continue; // 停用成员不参与匹配(与 v1.5 前行为一致)
369
+ const entry = {
370
+ id: m.id,
371
+ name: m.name,
372
+ aliases: Array.isArray(m.aliases) ? m.aliases.filter((a) => typeof a === 'string') : [],
373
+ source: 'manual',
374
+ };
375
+ const login = typeof m.giteaLogin === 'string' ? m.giteaLogin.trim().toLowerCase() : '';
376
+ if (login) claimedLogins.set(login, entry);
377
+ seen.add(m.id);
378
+ out.push(entry);
379
+ }
380
+ }
381
+ for (const h of ctx.giteaMembersPath ? loadGiteaMembers(ctx) : []) {
382
+ if (!h.id || seen.has(h.id)) continue;
383
+ const key = String(h.id).toLowerCase();
384
+ const claimed = claimedLogins.get(key);
385
+ if (claimed) {
386
+ // 手工条目认领了该 login:把 login 吸收为别名,派生条目不出现(同人单 id)
387
+ if (!claimed.aliases.some((a) => String(a).trim().toLowerCase() === key)) {
388
+ claimed.aliases.push(h.id);
389
+ }
390
+ continue;
391
+ }
392
+ seen.add(h.id);
393
+ out.push({ id: h.id, name: h.name || h.id, aliases: [], source: 'gitea' });
394
+ }
395
+ return out;
396
+ }
397
+
398
+ // ---------- data/*.json ----------
399
+
400
+ function loadTasks(ctx) {
401
+ // v2.9.33 批次 2 存储路由:tasks 迁移 → SQLite(data 列真源,投影列只写不读)
402
+ if (storeDb.unitBackend(path.dirname(ctx.tasksPath), 'tasks').backend === 'sqlite') {
403
+ const d = readJSON(columnsPathOf(ctx), null);
404
+ const columns = Array.isArray(d) && d.length > 0 ? d : clone(DEFAULT_COLUMNS);
405
+ return { columns, tasks: storeDb.loadTasks(storeDb.dbPathFor(path.dirname(ctx.tasksPath))) };
406
+ }
407
+ const d = readJSON(ctx.tasksPath, null);
408
+ if (!isPlainObject(d)) return { columns: clone(DEFAULT_COLUMNS), tasks: [] };
409
+ const columns = Array.isArray(d.columns) && d.columns.length > 0 ? d.columns : clone(DEFAULT_COLUMNS);
410
+ const tasks = Array.isArray(d.tasks) ? d.tasks : [];
411
+ return { columns, tasks };
412
+ }
413
+
414
+ /** 列定义恒走 JSON 伴生文件(配置型小数据,SPEC-STORAGE §1.3);仅 db 路径使用 */
415
+ function columnsPathOf(ctx) {
416
+ return path.join(path.dirname(ctx.tasksPath), 'columns.json');
417
+ }
418
+
419
+ function saveTasks(ctx, data) {
420
+ if (storeDb.unitBackend(path.dirname(ctx.tasksPath), 'tasks').backend === 'sqlite') {
421
+ // 列定义伴生 JSON 原样写(不入库);任务行进 db(全量替换事务)
422
+ writeJSON(columnsPathOf(ctx), Array.isArray(data.columns) && data.columns.length > 0 ? data.columns : clone(DEFAULT_COLUMNS));
423
+ return storeDb.saveTasks(storeDb.dbPathFor(path.dirname(ctx.tasksPath)), data);
424
+ }
425
+ writeJSON(ctx.tasksPath, data);
426
+ }
427
+
428
+ // v2.3:loadSessions/saveSessions 已随会话登记表退役移除(规格 §6;
429
+ // 会话观测唯一入口 = GET /api/agent-sessions / /api/agent-session)
430
+
431
+ /** SPEC §4:activities.json 按数组存储;容忍 {activities:[...]} 包装。
432
+ * v2.9.33 批次 2:activities 迁移 → SQLite(写路由经 saveActivities 统一出口,三 poller 客户端共用) */
433
+ function loadActivities(ctx) {
434
+ if (storeDb.unitBackend(path.dirname(ctx.activitiesPath), 'activities').backend === 'sqlite') {
435
+ return storeDb.loadActivities(storeDb.dbPathFor(path.dirname(ctx.activitiesPath)));
436
+ }
437
+ const d = readJSON(ctx.activitiesPath, null);
438
+ if (Array.isArray(d)) return d;
439
+ if (isPlainObject(d) && Array.isArray(d.activities)) return d.activities;
440
+ return [];
441
+ }
442
+
443
+ /** v2.9.33 批次 2:activities 写统一出口(gitea/github/gitee 三 poller 与测试共用) */
444
+ function saveActivities(ctx, activities) {
445
+ if (storeDb.unitBackend(path.dirname(ctx.activitiesPath), 'activities').backend === 'sqlite') {
446
+ return storeDb.saveActivities(storeDb.dbPathFor(path.dirname(ctx.activitiesPath)), activities);
447
+ }
448
+ writeJSON(ctx.activitiesPath, activities);
449
+ }
450
+
451
+ /** gitea 健康状态:mcode 的 B3 写入,本侧只读;缺失时返回未轮询默认值 */
452
+ function loadGiteaStatus(ctx) {
453
+ const d = readJSON(ctx.giteaStatusPath, null);
454
+ if (!isPlainObject(d)) return { ok: false, lastPollAt: null, lastError: '尚未轮询' };
455
+ return {
456
+ ok: !!d.ok,
457
+ lastPollAt: typeof d.lastPollAt === 'string' ? d.lastPollAt : null,
458
+ lastError: d.lastError === undefined || d.lastError === null ? (d.ok ? null : '尚未轮询') : String(d.lastError),
459
+ };
460
+ }
461
+
462
+ /** Gitea 组织成员缓存(B3 轮询时顺带缓存);缺失返回 [];容忍多种形态 */
463
+ function loadGiteaMembers(ctx) {
464
+ const d = readJSON(ctx.giteaMembersPath, null);
465
+ let list = [];
466
+ if (Array.isArray(d)) list = d;
467
+ else if (isPlainObject(d) && Array.isArray(d.members)) list = d.members;
468
+ const out = [];
469
+ for (const m of list) {
470
+ if (typeof m === 'string') out.push({ id: m, name: m, role: '' });
471
+ else if (isPlainObject(m) && typeof m.login === 'string') {
472
+ out.push({
473
+ id: m.login,
474
+ name: m.full_name || m.name || m.login,
475
+ role: m.role || '',
476
+ });
477
+ } else if (isPlainObject(m) && typeof m.id === 'string') {
478
+ out.push({ id: m.id, name: m.name || m.id, role: m.role || '' });
479
+ }
480
+ }
481
+ return out;
482
+ }
483
+
484
+ // ---------- 任务雷达(PRD-task-inbox §4):雷达池 messages.json + 候选池 inbox.json ----------
485
+
486
+ /** 雷达池:{messages:[...]} 或裸数组均容忍;缺失回退空池 */
487
+ function loadMessages(ctx) {
488
+ // v2.9.33 存储后端路由(红线 3 修订):台账标记 messages 已迁移 → SQLite 路径
489
+ //(形状与 JSON 后端同构;ctx.messagesPath 在 sqlite 路径下仅用于推导 data 目录)
490
+ if (storeDb.unitBackend(path.dirname(ctx.messagesPath), 'messages').backend === 'sqlite') {
491
+ return storeDb.loadMessages(storeDb.dbPathFor(path.dirname(ctx.messagesPath)));
492
+ }
493
+ const d = readJSON(ctx.messagesPath, null);
494
+ if (Array.isArray(d)) return d;
495
+ if (isPlainObject(d) && Array.isArray(d.messages)) return d.messages;
496
+ return [];
497
+ }
498
+
499
+ function saveMessages(ctx, messages) {
500
+ if (storeDb.unitBackend(path.dirname(ctx.messagesPath), 'messages').backend === 'sqlite') {
501
+ return storeDb.saveMessages(storeDb.dbPathFor(path.dirname(ctx.messagesPath)), messages);
502
+ }
503
+ writeJSON(ctx.messagesPath, messages);
504
+ }
505
+
506
+ /** 候选池:{candidates:[...]} 或裸数组均容忍;缺失回退空池。
507
+ * v2.9.33 批次 2:inbox 迁移 → SQLite */
508
+ function loadInbox(ctx) {
509
+ if (storeDb.unitBackend(path.dirname(ctx.inboxPath), 'inbox').backend === 'sqlite') {
510
+ return storeDb.loadInbox(storeDb.dbPathFor(path.dirname(ctx.inboxPath)));
511
+ }
512
+ const d = readJSON(ctx.inboxPath, null);
513
+ if (Array.isArray(d)) return d;
514
+ if (isPlainObject(d) && Array.isArray(d.candidates)) return d.candidates;
515
+ return [];
516
+ }
517
+
518
+ function saveInbox(ctx, candidates) {
519
+ if (storeDb.unitBackend(path.dirname(ctx.inboxPath), 'inbox').backend === 'sqlite') {
520
+ return storeDb.saveInbox(storeDb.dbPathFor(path.dirname(ctx.inboxPath)), candidates);
521
+ }
522
+ // JSON 形态保持 {candidates:[...]} 包装(历史契约)
523
+ writeJSON(ctx.inboxPath, { candidates });
524
+ }
525
+
526
+ /** 任务 id:t-<base36 时间戳>-<4 位随机>(与 server.js genTaskId 同构;候选确认入库用) */
527
+ function genTaskId(existing) {
528
+ const taken = new Set((existing || []).map((t) => t.id));
529
+ let id;
530
+ do {
531
+ id = `t-${Date.now().toString(36)}-${randomToken(4)}`;
532
+ } while (taken.has(id));
533
+ return id;
534
+ }
535
+
536
+ module.exports = {
537
+ DEFAULT_COLUMNS,
538
+ DEFAULT_CONFIG,
539
+ mergeConfigDefaults,
540
+ builtinAgents,
541
+ clone,
542
+ isPlainObject,
543
+ randomToken,
544
+ writeJSON,
545
+ readJSON,
546
+ loadOrCreateConfig,
547
+ loadAgents,
548
+ saveAgents,
549
+ loadOrCreateAgentsFile,
550
+ loadMembers,
551
+ saveMembers,
552
+ aggregateRoster,
553
+ loadTasks,
554
+ saveTasks,
555
+ loadActivities,
556
+ saveActivities,
557
+ loadGiteaStatus,
558
+ loadGiteaMembers,
559
+ loadMessages,
560
+ saveMessages,
561
+ loadInbox,
562
+ saveInbox,
563
+ genTaskId,
564
+ };