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/inbox.js ADDED
@@ -0,0 +1,438 @@
1
+ 'use strict';
2
+
3
+ /**
4
+ * inbox.js — 任务收件箱:候选池 CRUD + 确认/拒绝流 + 误识率统计(PRD 任务雷达 §5/§7)
5
+ *
6
+ * - 确认入库:按(可编辑后的)字段建看板任务,task.origin = {type:'inbox', refId, quote} 溯源;
7
+ * rememberAlias=true 且候选带说话人原文 → 别名(speakerRaw)写入 speakerMemberId(说话人身份
8
+ * 映射目标,v1.7 修订:与 memberId 任务负责人彻底解耦——负责人 ≠ 说话人);目标为 Gitea 派生
9
+ * id 时自动创建关联手工条目(v1.5 P1-C),响应 rememberedAlias 带落点;speakerMemberId 为空
10
+ * (含旧客户端只传 memberId)→ 不写任何别名,rememberedAlias:null + reason:'SPEAKER_UNRESOLVED'
11
+ * (不报错——宁可不学,不可错学)
12
+ * - v1.9 任务更新提案(kind==='update',存量无 kind 字段按任务候选容错):确认 → 不建任务、
13
+ * 不改任务字段;往 existingTaskId 事件流写 type:"memo" 节点(纪要标题 + 原文引用),
14
+ * 并把该纪要追加进任务 origin.relatedMemos[](origin 缺失则创建兜底形态);
15
+ * existingTaskId 已失效 → 400 TASK_NOT_FOUND(候选保持待决);done-already 不适用 → 409
16
+ * - 拒绝(v1.7 起原因必选):reason ∈ duplicate/wont_do/invalid/other,落 rejectReason/rejectNote
17
+ * (v1.9:更新提案与任务候选同一闸门,拒绝照常可用)
18
+ * - 已完成处置(v1.7 新增):POST /:id/done-already → state='done_already',不入看板
19
+ * - 误识率仪表(v1.7 口径):近 30 天 rejected/(confirmed+done_already+rejected)(数据从第一天起攒);
20
+ * v1.9:更新提案确认计入 confirmed30d(算「已采纳」,口径不变)
21
+ */
22
+
23
+ const store = require('./store');
24
+ const membersMod = require('./members');
25
+ const taskEvents = require('./taskEvents');
26
+ const { HttpError, sendJSON } = require('./router');
27
+
28
+ const PRIORITIES = new Set(['high', 'medium', 'low']);
29
+ const DUE_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
30
+
31
+ // v1.7:拒绝原因必选枚举
32
+ const REJECT_REASONS = ['duplicate', 'wont_do', 'invalid', 'other'];
33
+
34
+ /** YYYY-MM-DD + 真实日历回读(与 server.js 任务 dueDate 同规则:V8 会把 02-30 滚动到 3 月) */
35
+ function validDueDate(v) {
36
+ if (typeof v !== 'string' || !DUE_DATE_RE.test(v)) return false;
37
+ const [y, m, d] = v.split('-').map(Number);
38
+ const dt = new Date(y, m - 1, d);
39
+ return dt.getFullYear() === y && dt.getMonth() === m - 1 && dt.getDate() === d;
40
+ }
41
+
42
+ function candidateView(c) {
43
+ const v = store.clone(c);
44
+ // 五类卡点(源自数字员工文五类卡点分类,2026-10-25 增):
45
+ // cognitive=认知/歧义 risk=风险/敏感 relation=关系/真人 system=系统/工具 strategy=策略/新话术
46
+ v.blockerType = v.blockerType || 'cognitive';
47
+ return v;
48
+ }
49
+
50
+ /**
51
+ * 候选决定附言(reject 的 note / done-already 的 note):可省略;提供时必须为 ≤500 字符字符串;
52
+ * null 视为未填(宽松,与 memberId 等可空字段风格一致)。
53
+ */
54
+ function optionalNote(v) {
55
+ if (v === undefined || v === null || v === '') return '';
56
+ if (typeof v !== 'string' || v.length > 500) {
57
+ throw new HttpError(400, 'FIELD_INVALID', 'note 可省略,提供时必须为不超过 500 字符的字符串');
58
+ }
59
+ return v;
60
+ }
61
+
62
+ /** 近 30 天误识率(v1.7 口径)= rejected30d/(confirmed30d+doneAlready30d+rejected30d),
63
+ * 分母 0 时 null(还没数据不显示数字)。「已顺手做完」的 done_already 属于正确处置,
64
+ * 计入分母(AI 识别为任务而实际无需建任务),分子仍只算 rejected。 */
65
+ function computeStats(candidates) {
66
+ const cutoff = Date.now() - 30 * 86400 * 1000;
67
+ const counts = { pending: 0, confirmed: 0, rejected: 0, done_already: 0, merged: 0 };
68
+ let confirmed30 = 0;
69
+ let rejected30 = 0;
70
+ let doneAlready30 = 0;
71
+ let merged30 = 0;
72
+ for (const c of candidates) {
73
+ if (counts[c.state] !== undefined) counts[c.state] += 1;
74
+ if (c.decidedAt && Date.parse(c.decidedAt) >= cutoff) {
75
+ if (c.state === 'confirmed') confirmed30 += 1;
76
+ else if (c.state === 'rejected') rejected30 += 1;
77
+ else if (c.state === 'done_already') doneAlready30 += 1;
78
+ else if (c.state === 'merged') merged30 += 1;
79
+ }
80
+ }
81
+ const denominator = confirmed30 + doneAlready30 + rejected30;
82
+ return {
83
+ pending: counts.pending,
84
+ confirmed: counts.confirmed,
85
+ rejected: counts.rejected,
86
+ doneAlready: counts.done_already,
87
+ merged: counts.merged,
88
+ confirmed30d: confirmed30,
89
+ rejected30d: rejected30,
90
+ doneAlready30d: doneAlready30,
91
+ merged30d: merged30,
92
+ rejectRate30d: denominator > 0 ? Math.round((rejected30 / denominator) * 10000) / 10000 : null,
93
+ };
94
+ }
95
+
96
+ /**
97
+ * 记住说话人映射:别名追加到成员(大小写不敏感去重)。v1.7 修订起 memberId 参数
98
+ * 语义 = speakerMemberId(说话人身份映射目标),与任务负责人无关。
99
+ * v1.5(goose 验收 P1-C):目标 id 不在手工名册但命中 Gitea 成员缓存时,自动创建
100
+ * 关联手工条目({id:login, name:full_name, giteaLogin:login})再写别名——确认弹层
101
+ * 下拉展示的是聚合名册,映射必须能挂到派生成员,否则该组合服务端必 404。
102
+ * @returns {{memberId:string, alias:string|null, memberCreated:boolean}}
103
+ */
104
+ function rememberAlias(ctx, memberId, raw) {
105
+ const { members, member, created } = membersMod.resolveAliasTarget(ctx, memberId);
106
+ if (!member) {
107
+ throw new HttpError(404, 'MEMBER_NOT_FOUND', '「记住此映射」目标成员不存在于手工名册与 Gitea 成员缓存');
108
+ }
109
+ let aliasWritten = false;
110
+ const alias = String(raw || '').trim();
111
+ if (alias && alias.length <= 50) {
112
+ if (!Array.isArray(member.aliases)) member.aliases = [];
113
+ const dup = member.aliases.some((a) => typeof a === 'string' && a.trim().toLowerCase() === alias.toLowerCase());
114
+ if (!dup) {
115
+ member.aliases.push(alias);
116
+ aliasWritten = true;
117
+ }
118
+ }
119
+ // 新建条目即便本次没有别名可写也要落盘(映射目标已扩展,丢掉即回退成派生孤儿)
120
+ if (created || aliasWritten) store.saveMembers(ctx.membersPath, members);
121
+ return { memberId: member.id, alias: alias || null, memberCreated: created };
122
+ }
123
+
124
+ /** 已决候选的重复决定提示文案(v1.7 增 done_already 态) */
125
+ function stateLabel(state) {
126
+ if (state === 'confirmed') return '确认';
127
+ if (state === 'done_already') return '标记为已完成';
128
+ return '拒绝';
129
+ }
130
+
131
+ function registerInboxRoutes(router, ctx) {
132
+ router.add('GET', '/api/inbox', (c) => {
133
+ const state = c.query.get('state');
134
+ let list = store.loadInbox(ctx);
135
+ if (state) list = list.filter((x) => x.state === state);
136
+ // 待确认按置信度降序(PRD §6);已决按决定时间倒序
137
+ list = list.slice().sort((a, b) => {
138
+ if (a.state === 'pending' && b.state === 'pending') {
139
+ return b.confidence - a.confidence || Date.parse(b.createdAt) - Date.parse(a.createdAt);
140
+ }
141
+ return Date.parse(b.decidedAt || b.createdAt) - Date.parse(a.decidedAt || a.createdAt);
142
+ });
143
+ sendJSON(c.res, 200, list.map(candidateView));
144
+ });
145
+
146
+ router.add('GET', '/api/inbox/stats', (c) => {
147
+ sendJSON(c.res, 200, computeStats(store.loadInbox(ctx)));
148
+ });
149
+
150
+ router.add('POST', '/api/inbox/:id/confirm', (c) => {
151
+ const inbox = store.loadInbox(ctx);
152
+ const cand = inbox.find((x) => x.id === c.params.id);
153
+ if (!cand) throw new HttpError(404, 'CANDIDATE_NOT_FOUND', '候选卡不存在');
154
+ if (cand.state !== 'pending') throw new HttpError(409, 'ALREADY_DECIDED', `该候选已${stateLabel(cand.state)},不可重复决定`);
155
+
156
+ // v1.9 任务更新提案分支:确认 = 采纳这条讨论/进展,挂到已有任务的时间轴。
157
+ // 不建任务、不改任务业务字段(title/status 等一概不动);确认前先校验目标任务仍在,
158
+ // 已失效(被删)→ 400 TASK_NOT_FOUND 且候选保持待决(不产生半截状态)。
159
+ if (cand.kind === 'update') {
160
+ const data = store.loadTasks(ctx);
161
+ const task = data.tasks.find((t) => t.id === cand.existingTaskId);
162
+ if (!task) {
163
+ throw new HttpError(400, 'TASK_NOT_FOUND', `关联任务 ${cand.existingTaskId || '(空)'} 不存在或已删除,无法确认更新提案`);
164
+ }
165
+ const now = new Date().toISOString();
166
+ // memo 事件:时间轴上的「纪要节点」(detail = 纪要标题 + 引用原句)
167
+ taskEvents.appendEvents(ctx, [
168
+ taskEvents.makeEvent(task.id, 'memo', null, null, `纪要《${cand.messageTitle}》:${cand.quote}`, now),
169
+ ]);
170
+ // origin.relatedMemos 追加 → 任务 × 听记 天然 N:N;origin 缺失(老任务)创建兜底形态
171
+ if (!store.isPlainObject(task.origin)) {
172
+ task.origin = { type: 'inbox', refId: cand.messageId, quote: '', relatedMemos: [] };
173
+ }
174
+ if (!Array.isArray(task.origin.relatedMemos)) task.origin.relatedMemos = [];
175
+ task.origin.relatedMemos.push({
176
+ refId: cand.messageId,
177
+ title: cand.messageTitle,
178
+ quote: cand.quote || '',
179
+ at: now,
180
+ });
181
+ store.saveTasks(ctx, data);
182
+
183
+ cand.state = 'confirmed';
184
+ cand.decidedAt = now;
185
+ cand.confirmedTaskId = task.id;
186
+ store.saveInbox(ctx, inbox);
187
+ return sendJSON(c.res, 200, { task: store.clone(task), candidate: candidateView(cand) });
188
+ }
189
+
190
+ const body = c.body || {};
191
+ // 字段校验(确认时允许编辑;全部字段可省略 = 按 AI 建议原样入库)
192
+ const title = body.title !== undefined ? String(body.title).trim() : cand.title;
193
+ if (!title || title.length < 1 || title.length > 200) {
194
+ throw new HttpError(400, 'FIELD_INVALID', 'title 必填且为 1..200 字符');
195
+ }
196
+ let desc = body.desc !== undefined ? body.desc : cand.desc;
197
+ if (typeof desc !== 'string' || desc.length > 2000) {
198
+ throw new HttpError(400, 'FIELD_INVALID', 'desc 必须为不超过 2000 字符的字符串');
199
+ }
200
+ let priority = body.priority !== undefined ? body.priority : cand.priority;
201
+ if (priority === 'unset' || priority === undefined || priority === null || priority === '') priority = 'medium';
202
+ if (!PRIORITIES.has(priority)) {
203
+ throw new HttpError(400, 'FIELD_INVALID', 'priority 必须为 high/medium/low 之一');
204
+ }
205
+ let memberId = body.memberId !== undefined ? body.memberId : cand.suggestedMemberId;
206
+ if (memberId === undefined || memberId === null || memberId === '') memberId = null;
207
+ else if (typeof memberId !== 'string' || memberId.length > 64) {
208
+ throw new HttpError(400, 'FIELD_INVALID', 'memberId 必须为不超过 64 字符的字符串或 null');
209
+ }
210
+ // v1.7 修订:speakerMemberId = 说话人身份映射目标(「这个说话人是名册里的谁」),
211
+ // 与 memberId(任务负责人)解耦。可省略/null/空串 = 不做身份映射
212
+ let speakerMemberId = body.speakerMemberId !== undefined ? body.speakerMemberId : null;
213
+ if (speakerMemberId === '') speakerMemberId = null;
214
+ if (speakerMemberId !== null && (typeof speakerMemberId !== 'string' || speakerMemberId.length > 64)) {
215
+ throw new HttpError(400, 'FIELD_INVALID', 'speakerMemberId 必须为不超过 64 字符的字符串或 null');
216
+ }
217
+ let dueDate = body.dueDate !== undefined ? body.dueDate : null;
218
+ if (dueDate === '') dueDate = null;
219
+ if (dueDate !== null && !validDueDate(dueDate)) {
220
+ throw new HttpError(400, 'FIELD_INVALID', 'dueDate 必须为 YYYY-MM-DD 格式字符串或 null');
221
+ }
222
+ const remember = body.rememberAlias === true;
223
+
224
+ // 前置校验别名目标(避免任务已建而别名写入失败的不一致)。
225
+ // v1.7 修订:只校验 speakerMemberId(映射目标);memberId 是任务负责人,与记别名无关,
226
+ // 不再要求「记住映射必须先指定负责成员」。speakerMemberId 为空 → 不写别名(宁可不学,
227
+ // 不可错学——旧客户端只传 memberId 时绝不把说话人昵称挂到负责人名下)。
228
+ // v1.5(P1-C):只读解析不落盘——手工名册或 Gitea 缓存任一命中即放行,落盘延后到 rememberAlias
229
+ if (remember) {
230
+ if (!cand.speakerRaw) throw new HttpError(400, 'FIELD_INVALID', '该候选没有说话人原文,无法记住映射');
231
+ if (speakerMemberId) {
232
+ const target = membersMod.resolveAliasTarget(ctx, speakerMemberId);
233
+ if (!target.member) {
234
+ throw new HttpError(404, 'MEMBER_NOT_FOUND', '「记住此映射」目标成员不存在于手工名册与 Gitea 成员缓存');
235
+ }
236
+ }
237
+ }
238
+
239
+ // 建任务(带 origin 溯源)
240
+ const data = store.loadTasks(ctx);
241
+ const now = new Date().toISOString();
242
+ const task = {
243
+ id: store.genTaskId(data.tasks),
244
+ title,
245
+ status: 'todo',
246
+ agentId: null,
247
+ memberId,
248
+ repo: null,
249
+ branch: null,
250
+ prUrl: null,
251
+ notes: '',
252
+ desc,
253
+ dueDate,
254
+ priority,
255
+ artifacts: [], // v1.9:Gitea 成果挂接(与手工建任务同构;存量任务无字段容错)
256
+ createdAt: now,
257
+ updatedAt: now,
258
+ origin: { type: 'inbox', refId: cand.id, quote: cand.quote || '' },
259
+ };
260
+ data.tasks.push(task);
261
+ store.saveTasks(ctx, data);
262
+ // v1.7:收件箱确认入库也记 created 事件(detail 含 origin 来源描述)
263
+ taskEvents.appendEvents(ctx, [taskEvents.createdEvent(task, now)]);
264
+
265
+ // v1.7 修订:别名只写 speakerMemberId 名下;为空(含旧客户端只传 memberId)不写任何别名,
266
+ // 响应 rememberedAlias:null + reason:'SPEAKER_UNRESOLVED'(不报错——用户有权不映射)
267
+ let remembered = null;
268
+ let aliasReason = null;
269
+ if (remember) {
270
+ if (speakerMemberId) {
271
+ remembered = rememberAlias(ctx, speakerMemberId, cand.speakerRaw);
272
+ } else {
273
+ aliasReason = 'SPEAKER_UNRESOLVED';
274
+ }
275
+ }
276
+
277
+ cand.state = 'confirmed';
278
+ cand.decidedAt = now;
279
+ cand.confirmedTaskId = task.id;
280
+ // 编辑后字段回写候选(审计留痕:AI 建议 → 人工定稿)
281
+ cand.title = title;
282
+ cand.desc = desc;
283
+ cand.priority = priority;
284
+ cand.suggestedMemberId = memberId;
285
+ cand.dueDate = dueDate;
286
+ store.saveInbox(ctx, inbox);
287
+
288
+ // v1.5:rememberedAlias 带映射落点(memberId = 映射目标 speakerMemberId,
289
+ // memberCreated=true = 由派生 id 自动建的关联手工条目);
290
+ // v1.7 修订:请求了记住映射但未写别名时附 reason:'SPEAKER_UNRESOLVED'(映射目标未指定)
291
+ const confirmRes = { task: store.clone(task), candidate: candidateView(cand), rememberedAlias: remembered };
292
+ if (aliasReason) confirmRes.reason = aliasReason;
293
+ sendJSON(c.res, 200, confirmRes);
294
+ });
295
+
296
+ // v2.9.12 合并入库:多条候选 → 一个人工命名的新任务。标题/描述全人工填(不做智能
297
+ // 拼装),N 条候选全部转 merged(不进误识率分母,单独 merged30d 观测拆解粒度),
298
+ // 并各自以 memo 事件 + relatedMemos 记入任务时间轴(原文可溯)。
299
+ // 原子性:先全量校验后落盘,tasks/inbox 两次原子写之间无用户可达中间态。
300
+ router.add('POST', '/api/inbox/confirm-merged', (c) => {
301
+ const body = c.body || {};
302
+ const ids = body.ids;
303
+ if (!Array.isArray(ids) || ids.length < 2 || ids.length > 50 || ids.some((x) => typeof x !== 'string' || !x.trim())) {
304
+ throw new HttpError(400, 'FIELD_INVALID', 'ids 必须为 2..50 个候选 id 的数组');
305
+ }
306
+ const title = String(body.title === undefined ? '' : body.title).trim();
307
+ if (!title || title.length < 1 || title.length > 200) {
308
+ throw new HttpError(400, 'FIELD_INVALID', 'title 必填且为 1..200 字符(合并后任务由人工命名)');
309
+ }
310
+ let desc = body.desc;
311
+ if (desc === undefined || desc === null) desc = '';
312
+ if (typeof desc !== 'string' || desc.length > 2000) {
313
+ throw new HttpError(400, 'FIELD_INVALID', 'desc 必须为不超过 2000 字符的字符串');
314
+ }
315
+ let priority = body.priority === undefined || body.priority === null || body.priority === '' ? 'medium' : body.priority;
316
+ if (!PRIORITIES.has(priority)) {
317
+ throw new HttpError(400, 'FIELD_INVALID', 'priority 必须为 high/medium/low 之一');
318
+ }
319
+ let memberId = body.memberId === undefined || body.memberId === null || body.memberId === '' ? null : body.memberId;
320
+ if (memberId !== null && (typeof memberId !== 'string' || memberId.length > 64)) {
321
+ throw new HttpError(400, 'FIELD_INVALID', 'memberId 必须为不超过 64 字符的字符串或 null');
322
+ }
323
+ let dueDate = body.dueDate === undefined || body.dueDate === '' ? null : body.dueDate;
324
+ if (dueDate !== null && !validDueDate(dueDate)) {
325
+ throw new HttpError(400, 'FIELD_INVALID', 'dueDate 必须为 YYYY-MM-DD 格式字符串或 null');
326
+ }
327
+
328
+ const inbox = store.loadInbox(ctx);
329
+ const targets = [];
330
+ for (const id of ids) {
331
+ const cand = inbox.find((x) => x.id === id);
332
+ if (!cand) throw new HttpError(404, 'CANDIDATE_NOT_FOUND', `候选卡 ${id} 不存在`);
333
+ if (cand.state !== 'pending') throw new HttpError(409, 'ALREADY_DECIDED', `候选「${cand.title || id}」已${stateLabel(cand.state)},不可再合并`);
334
+ if (cand.kind === 'update') throw new HttpError(400, 'UPDATE_KIND_UNSUPPORTED', '任务更新提案不能参与合并,请单独确认或拒绝');
335
+ targets.push(cand);
336
+ }
337
+ if (new Set(targets.map((x) => x.id)).size !== targets.length) {
338
+ throw new HttpError(400, 'FIELD_INVALID', 'ids 存在重复');
339
+ }
340
+
341
+ const now = new Date().toISOString();
342
+ const main = targets[0]; // 主候选:origin 溯源锚点(前端按置信度降序传参)
343
+ const data = store.loadTasks(ctx);
344
+ const task = {
345
+ id: store.genTaskId(data.tasks),
346
+ title,
347
+ status: 'todo',
348
+ agentId: null,
349
+ memberId,
350
+ repo: null,
351
+ branch: null,
352
+ prUrl: null,
353
+ notes: '',
354
+ desc,
355
+ dueDate,
356
+ priority,
357
+ artifacts: [],
358
+ createdAt: now,
359
+ updatedAt: now,
360
+ origin: { type: 'inbox', refId: main.id, quote: main.quote || '', relatedMemos: [] },
361
+ };
362
+ const memoEvents = targets.map((cand) =>
363
+ taskEvents.makeEvent(task.id, 'memo', null, null, `纪要《${cand.messageTitle}》:${cand.quote}`, now));
364
+ taskEvents.appendEvents(ctx, memoEvents);
365
+ for (const cand of targets) {
366
+ task.origin.relatedMemos.push({
367
+ refId: cand.messageId,
368
+ title: cand.messageTitle,
369
+ quote: cand.quote || '',
370
+ at: now,
371
+ });
372
+ }
373
+ data.tasks.push(task);
374
+ store.saveTasks(ctx, data);
375
+
376
+ for (const cand of targets) {
377
+ cand.state = 'merged';
378
+ cand.mergedInto = task.id;
379
+ cand.mergedAt = now;
380
+ cand.decidedAt = now;
381
+ }
382
+ // 主候选回写人工定稿字段(审计留痕,与单条确认同口径)
383
+ main.title = title;
384
+ main.desc = desc;
385
+ main.priority = priority;
386
+ main.suggestedMemberId = memberId;
387
+ main.dueDate = dueDate;
388
+ main.confirmedTaskId = task.id;
389
+ store.saveInbox(ctx, inbox);
390
+
391
+ sendJSON(c.res, 200, {
392
+ task: store.clone(task),
393
+ merged: targets.map((x) => x.id),
394
+ candidate: candidateView(main),
395
+ });
396
+ });
397
+
398
+ // v1.7:拒绝原因必选——缺 reason 或取值不在枚举 → 400 REASON_REQUIRED;
399
+ // 落 rejectReason/rejectNote,state=rejected
400
+ router.add('POST', '/api/inbox/:id/reject', (c) => {
401
+ const inbox = store.loadInbox(ctx);
402
+ const cand = inbox.find((x) => x.id === c.params.id);
403
+ if (!cand) throw new HttpError(404, 'CANDIDATE_NOT_FOUND', '候选卡不存在');
404
+ if (cand.state !== 'pending') throw new HttpError(409, 'ALREADY_DECIDED', `该候选已${stateLabel(cand.state)},不可重复决定`);
405
+ const reason = (c.body || {}).reason;
406
+ if (!REJECT_REASONS.includes(reason)) {
407
+ throw new HttpError(400, 'REASON_REQUIRED', `reason 必填,且为 ${REJECT_REASONS.join('/')} 之一`);
408
+ }
409
+ const note = optionalNote((c.body || {}).note);
410
+ cand.state = 'rejected';
411
+ cand.decidedAt = new Date().toISOString();
412
+ cand.rejectReason = reason;
413
+ cand.rejectNote = note;
414
+ store.saveInbox(ctx, inbox);
415
+ sendJSON(c.res, 200, candidateView(cand));
416
+ });
417
+
418
+ // v1.7:「其实早就做完了」处置——state=done_already、decidedAt;不入看板(不建任务)。
419
+ // 统计口径:done_already 计入误识率分母(识别为任务但实际无需建任务)。
420
+ // v1.9:对更新提案不适用——提案要么确认(写关联任务时间轴)要么拒绝,409 NOT_APPLICABLE
421
+ router.add('POST', '/api/inbox/:id/done-already', (c) => {
422
+ const inbox = store.loadInbox(ctx);
423
+ const cand = inbox.find((x) => x.id === c.params.id);
424
+ if (!cand) throw new HttpError(404, 'CANDIDATE_NOT_FOUND', '候选卡不存在');
425
+ if (cand.state !== 'pending') throw new HttpError(409, 'ALREADY_DECIDED', `该候选已${stateLabel(cand.state)},不可重复决定`);
426
+ if (cand.kind === 'update') {
427
+ throw new HttpError(409, 'NOT_APPLICABLE', '任务更新提案不适用「已完成」处置:确认后写入关联任务时间轴,或改用拒绝');
428
+ }
429
+ const note = optionalNote((c.body || {}).note);
430
+ cand.state = 'done_already';
431
+ cand.decidedAt = new Date().toISOString();
432
+ cand.doneNote = note;
433
+ store.saveInbox(ctx, inbox);
434
+ sendJSON(c.res, 200, candidateView(cand));
435
+ });
436
+ }
437
+
438
+ module.exports = { registerInboxRoutes, computeStats, REJECT_REASONS };
@@ -0,0 +1,122 @@
1
+ 'use strict';
2
+
3
+ /**
4
+ * instanceLock.js — v2.9.43 单实例登记(检测 + 告警,不硬拦)
5
+ *
6
+ * 背景(真事故,不是假想):v2.9.25 桌面版 DSH 与 CLI 实例同跑、共享同一份 data/,
7
+ * 桌面版内存里的旧代码每 60s 继续写脏归因(16:04 一次 65 条,累计清理 156 条)。
8
+ * 当时的结论是「杀干净一个实例不等于修复完成,修复必须以全部实例都跑新代码为完成态」。
9
+ *
10
+ * 本模块只解决**知情**问题:启动时登记自己,同时看有没有别的存活实例共用同一个 base 目录。
11
+ * 刻意**不硬拦**——插件跑在宿主进程里,拒绝启动会连带把整个 DSH 拖下水;正确做法是
12
+ * 启动日志 + 顶栏告警 + /api/instance 查询,让人自己决定杀哪一个。
13
+ *
14
+ * 落点:`<base>/.instance.json`(base = 配置目录,通常是 ~/.dsh/fde-console)。
15
+ * 形如 {updatedAt, instances:[{pid, startedAt, version, port}]},只保留存活条目。
16
+ * 写入走 store.writeJSON(tmp+rename 原子写),与其它数据文件同一纪律。
17
+ */
18
+
19
+ const fs = require('node:fs');
20
+ const path = require('node:path');
21
+
22
+ const store = require('./store');
23
+
24
+ const LOCK_FILE = '.instance.json';
25
+
26
+ function lockPath(baseDir) {
27
+ return path.join(baseDir, LOCK_FILE);
28
+ }
29
+
30
+ /** pid 是否存活:EPERM 视为存活(存在但无权限,Windows 同用户极少见) */
31
+ function isAlive(pid) {
32
+ if (!Number.isInteger(pid) || pid <= 0) return false;
33
+ try {
34
+ process.kill(pid, 0);
35
+ return true;
36
+ } catch (e) {
37
+ return !!(e && e.code === 'EPERM');
38
+ }
39
+ }
40
+
41
+ function readLock(baseDir) {
42
+ try {
43
+ const d = store.readJSON(lockPath(baseDir), null);
44
+ if (!store.isPlainObject(d)) return { updatedAt: null, instances: [] };
45
+ const list = Array.isArray(d.instances) ? d.instances : [];
46
+ return {
47
+ updatedAt: typeof d.updatedAt === 'string' ? d.updatedAt : null,
48
+ instances: list.filter((x) => x && Number.isInteger(x.pid)),
49
+ };
50
+ } catch (e) {
51
+ return { updatedAt: null, instances: [] };
52
+ }
53
+ }
54
+
55
+ /** 当前存活的其它实例(不含自己) */
56
+ function othersLive(baseDir, selfPid) {
57
+ const self = selfPid || process.pid;
58
+ return readLock(baseDir).instances.filter((x) => x.pid !== self && isAlive(x.pid));
59
+ }
60
+
61
+ /**
62
+ * 登记自己并返回 {self, others}:
63
+ * - 先清掉已死条目(进程被强杀后残留的 pid 不制造假告警)
64
+ * - others = 登记时刻仍然存活的其它实例(启动日志据此告警)
65
+ */
66
+ function acquire(baseDir, meta) {
67
+ const m = meta || {};
68
+ const now = new Date().toISOString();
69
+ const self = {
70
+ pid: process.pid,
71
+ startedAt: now,
72
+ version: typeof m.version === 'string' ? m.version : null,
73
+ port: Number.isInteger(m.port) ? m.port : null,
74
+ };
75
+ const alive = othersLive(baseDir); // 只保留存活者(含自己之外的)
76
+ const others = alive.filter((x) => x.pid !== self.pid);
77
+ const next = {
78
+ updatedAt: now,
79
+ instances: [...others, self],
80
+ };
81
+ try {
82
+ store.writeJSON(lockPath(baseDir), next);
83
+ } catch (e) {
84
+ // 登记失败不该阻断启动:退回「不登记」状态,但把原因留给调用方
85
+ return { self, others, error: String((e && e.message) || e) };
86
+ }
87
+ return { self, others };
88
+ }
89
+
90
+ /** 退出时把自己摘掉;没有别人的话顺手删文件(不给下一次启动留垃圾) */
91
+ function release(baseDir, pid) {
92
+ const me = pid || process.pid;
93
+ try {
94
+ const lock = readLock(baseDir);
95
+ const rest = lock.instances.filter((x) => x.pid !== me && isAlive(x.pid));
96
+ if (rest.length === 0) {
97
+ fs.rmSync(lockPath(baseDir), { force: true });
98
+ return { released: true, remaining: 0 };
99
+ }
100
+ store.writeJSON(lockPath(baseDir), { updatedAt: new Date().toISOString(), instances: rest });
101
+ return { released: true, remaining: rest.length };
102
+ } catch (e) {
103
+ return { released: false, error: String((e && e.message) || e) };
104
+ }
105
+ }
106
+
107
+ /** 运行期查询:{self, others, multiInstance}(不写盘) */
108
+ function status(baseDir, selfPid) {
109
+ const me = selfPid || process.pid;
110
+ const lock = readLock(baseDir);
111
+ const self = lock.instances.find((x) => x.pid === me) || null;
112
+ const others = lock.instances.filter((x) => x.pid !== me && isAlive(x.pid));
113
+ return {
114
+ self,
115
+ others,
116
+ multiInstance: others.length > 0,
117
+ startedAt: self ? self.startedAt : null,
118
+ lockPath: lockPath(baseDir),
119
+ };
120
+ }
121
+
122
+ module.exports = { LOCK_FILE, lockPath, isAlive, acquire, release, status, othersLive };
package/lib/jobs.js ADDED
@@ -0,0 +1,56 @@
1
+ 'use strict';
2
+
3
+ /**
4
+ * jobs.js — 雷达后台任务注册表(进程内内存态,单用户语义)
5
+ *
6
+ * 为什么进程内不落盘:任务只是"进度指示器",其产物(消息池 analyzedAt、候选卡、
7
+ * ANALYZE_FAILED 标记)全部落盘。服务重启丢掉的只是进行中任务的进度视图,
8
+ * 重放安全——同一批 messageIds 重新 POST /api/radar/analyze 即可续跑。
9
+ *
10
+ * 滚动保留最近 MAX_JOBS 个;id 形如 job-<base36ms>-<seq>。
11
+ */
12
+
13
+ const jobs = new Map();
14
+ let seq = 0;
15
+ const MAX_JOBS = 50;
16
+
17
+ function createJob(kind, total) {
18
+ const id = `job-${Date.now().toString(36)}-${++seq}`;
19
+ const job = {
20
+ id,
21
+ kind, // 'sync' | 'analyze'
22
+ state: 'running', // running | done | partial | failed
23
+ total: Number(total) || 0,
24
+ done: 0,
25
+ current: null, // 正在处理的条目描述
26
+ results: [], // {item, ok, ...详情, error?}
27
+ startedAt: new Date().toISOString(),
28
+ finishedAt: null,
29
+ error: null,
30
+ };
31
+ jobs.set(id, job);
32
+ while (jobs.size > MAX_JOBS) {
33
+ jobs.delete(jobs.keys().next().value);
34
+ }
35
+ return job;
36
+ }
37
+
38
+ function getJob(id) {
39
+ return jobs.get(String(id)) || null;
40
+ }
41
+
42
+ /** 任务收尾:全 ok → done;部分失败 → partial;外层异常 → failed */
43
+ function finishJob(job) {
44
+ if (job.state === 'running') {
45
+ job.state = job.results.length > 0 && job.results.every((r) => r.ok) ? 'done' : 'partial';
46
+ if (job.results.length === 0 && job.total === 0) job.state = 'done';
47
+ }
48
+ job.finishedAt = new Date().toISOString();
49
+ }
50
+
51
+ /** 任务视图(对外输出前克隆,防调用方改内部态) */
52
+ function jobView(job) {
53
+ return JSON.parse(JSON.stringify(job));
54
+ }
55
+
56
+ module.exports = { createJob, getJob, finishJob, jobView };