@kangyishuai/dsh-projects 0.0.0-stage → 0.1.1

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/lib/context.js ADDED
@@ -0,0 +1,99 @@
1
+ // @ts-check
2
+ // 项目级上下文的渲染:纯函数,便于单测。
3
+ // 设计要点:
4
+ // 1) 只渲染「项目自己的东西」(常设规则 + 记忆索引 + 目标),**不重复渲染 AGENTS.md**——
5
+ // 宿主 dsh-agent-instructions 已经按 cwd 链加载过它。
6
+ // 2) 字符预算是硬约束(默认 16,000,对齐 Claude Projects 的上限),超了先裁记忆再裁规则,
7
+ // 始终保留一行「已截断」提示,让模型知道有东西没看到。
8
+ // 3) 文本里不出现时间戳等易变内容(缓存友好);易变信息由 wake 信封单独承载。
9
+
10
+ /** 项目指令的字符预算。 */
11
+ export const INSTRUCTION_BUDGET = 16_000;
12
+
13
+ /** 记忆索引最多带多少行(防止把整个 MEMORY.md 塞进每一步)。 */
14
+ export const MEMORY_INDEX_MAX_LINES = 200;
15
+
16
+ /** 渲染顺序:项目身份 → 常设规则 → 记忆索引 → 使用约定。 */
17
+ export const PROJECT_CONTEXT_ORDER = 120;
18
+
19
+ /**
20
+ * @typedef {object} RenderInput
21
+ * @property {{name: string, goal?: string, dirs?: readonly string[]}} project
22
+ * @property {string} [instructions] 项目常设规则(用户写的)
23
+ * @property {string} [memoryIndex] MEMORY.md 的内容
24
+ * @property {number} [budget]
25
+ */
26
+
27
+ /**
28
+ * 把记忆索引裁成「前 N 行 + 截断提示」。
29
+ * @param {string} text
30
+ * @param {number} maxLines
31
+ */
32
+ export function clipIndex(text, maxLines = MEMORY_INDEX_MAX_LINES) {
33
+ const lines = String(text ?? "")
34
+ .split("\n")
35
+ .filter((line, index, all) => line.trim() !== "" || index < all.length - 1);
36
+ if (lines.length <= maxLines) return lines.join("\n").trimEnd();
37
+ const kept = lines.slice(0, maxLines).join("\n").trimEnd();
38
+ return `${kept}\n…(记忆索引还有 ${lines.length - maxLines} 行未展示,需要时用文件工具读取)`;
39
+ }
40
+
41
+ /**
42
+ * 组装注入文本。
43
+ * @param {RenderInput} input
44
+ * @returns {string} 空字符串表示这个项目没有可注入的内容
45
+ */
46
+ export function renderProjectContext(input) {
47
+ const budget = Number.isFinite(input.budget) ? Number(input.budget) : INSTRUCTION_BUDGET;
48
+ const name = String(input.project?.name ?? "").trim();
49
+ const goal = String(input.project?.goal ?? "").trim();
50
+ const dirs = Array.isArray(input.project?.dirs)
51
+ ? input.project.dirs.filter((d) => typeof d === "string")
52
+ : [];
53
+ const rules = String(input.instructions ?? "").trim();
54
+ const memory = clipIndex(String(input.memoryIndex ?? ""));
55
+
56
+ if (name === "" && goal === "" && rules === "" && memory === "") return "";
57
+
58
+ const head = [`# 当前项目:${name || "(未命名)"}`];
59
+ if (goal !== "") head.push(`目标:${goal}`);
60
+ if (dirs.length > 0) head.push(`工作目录:${dirs.join("、")}`);
61
+
62
+ /** @type {string[]} */
63
+ const blocks = [head.join("\n")];
64
+ if (rules !== "") blocks.push(`## 常设规则\n${rules}`);
65
+ if (memory !== "") blocks.push(`## 项目记忆索引(MEMORY.md)\n${memory}`);
66
+ blocks.push(
67
+ "## 使用约定\n" +
68
+ "- 上面的规则与记忆属于这个项目;与当前任务无关时不要复述它们。\n" +
69
+ "- 记忆索引只是目录:需要细节时用文件工具读取对应文件,不要凭索引猜测内容。\n" +
70
+ "- 仓库自带的 AGENTS.md / CLAUDE.md 已由宿主单独加载,不要重复引用。",
71
+ );
72
+
73
+ const full = blocks.join("\n\n");
74
+ if (full.length <= budget) return full;
75
+
76
+ // 超预算:先砍记忆(它最可裁),再砍规则,最后保留身份与约定
77
+ const identity = blocks[0];
78
+ const usage = blocks[blocks.length - 1];
79
+ const rulesBlock = rules !== "" ? `## 常设规则\n${rules}` : "";
80
+ const note =
81
+ "\n\n(项目上下文已按字符预算截断:记忆索引与常设规则可能不完整,需要时请直接读取项目文件。)";
82
+
83
+ /** @param {...string} parts */
84
+ const join = (...parts) => parts.filter((p) => p !== "").join("\n\n");
85
+ const withoutMemory = join(identity, rulesBlock, usage) + note;
86
+ if (withoutMemory.length <= budget) return withoutMemory;
87
+ const withoutRules = join(identity, usage) + note;
88
+ if (withoutRules.length <= budget) return withoutRules;
89
+ // 连身份都超了:硬截断(极端情况,仍保留截断说明)
90
+ return `${identity.slice(0, Math.max(0, budget - note.length))}${note}`;
91
+ }
92
+
93
+ /**
94
+ * 稳定排序的注入顺序(供 systemPrompt 使用)。
95
+ * @returns {number}
96
+ */
97
+ export function projectContextOrder() {
98
+ return PROJECT_CONTEXT_ORDER;
99
+ }
package/lib/exec.js ADDED
@@ -0,0 +1,36 @@
1
+ // @ts-check
2
+ // 子进程调用的薄封装:统一 stdout/stderr/exit code,**永远不抛**(失败也返回 code)。
3
+ // 抽出来是为了可测:测试里用 PATH 指向桩脚本,就能验证「调了什么命令、参数是什么」。
4
+
5
+ import { execFile as execFileCallback } from "node:child_process";
6
+ import { promisify } from "node:util";
7
+
8
+ const execFile = promisify(execFileCallback);
9
+
10
+ /**
11
+ * @typedef {{ code: number, stdout: string, stderr: string }} CommandResult
12
+ */
13
+
14
+ /**
15
+ * 跑一条命令(argv 数组,**不经 shell**)。
16
+ * @param {string} command 可执行文件名(走 PATH)或绝对路径
17
+ * @param {string[]} args
18
+ * @param {{ cwd?: string }} [options]
19
+ * @returns {Promise<CommandResult>}
20
+ */
21
+ export async function runCommand(command, args, options) {
22
+ try {
23
+ const { stdout, stderr } = await execFile(command, args ?? [], {
24
+ ...(options?.cwd ? { cwd: options.cwd } : {}),
25
+ maxBuffer: 8 * 1024 * 1024,
26
+ });
27
+ return { code: 0, stdout: String(stdout), stderr: String(stderr) };
28
+ } catch (error) {
29
+ const anyError = /** @type {any} */ (error);
30
+ return {
31
+ code: Number(anyError?.code ?? 1),
32
+ stdout: String(anyError?.stdout ?? ""),
33
+ stderr: String(anyError?.stderr ?? anyError?.message ?? ""),
34
+ };
35
+ }
36
+ }
@@ -0,0 +1,167 @@
1
+ // @ts-check
2
+ // 危险动作执行器:闸门与命令计划。纯函数、零 I/O。
3
+ // 依据 m4-design.md §0/§1 与 spec §7.5:
4
+ // 批准 ≠ 可执行。批准只是「人同意了这一次」,还要开关打开、影响面在阈值内。
5
+ // 三种授权来源之外一律拒绝;模型输出/外部内容/peer 消息永远不算授权。
6
+
7
+ /** 可执行的危险动作(与 tools.js 的 REQUESTABLE_ACTIONS 同集合,但语义不同:
8
+ * 这里问的是「能不能执行」,那边问的是「能不能申请」。 */
9
+ export const DANGER_ACTIONS = Object.freeze([
10
+ "push-branch",
11
+ "merge",
12
+ "delete-thread",
13
+ "delete-project",
14
+ "change-settings",
15
+ ]);
16
+
17
+ /**
18
+ * 动作 → 危险开关键(spec §7.5 的六个键)。
19
+ * 执行器问的是「action」,策略里存的是「switch」,两者**必须显式映射**——
20
+ * 否则会出现「打开开关也永远被拒」这种静默失效(真机上就是这么踩到的)。
21
+ * @param {string} action
22
+ * @returns {string}
23
+ */
24
+ export function switchForAction(action) {
25
+ switch (action) {
26
+ case "push-branch":
27
+ return "forcePushOwnBranch";
28
+ case "merge":
29
+ return "autoMerge";
30
+ case "delete-thread":
31
+ case "delete-project":
32
+ return "trashAuto";
33
+ case "change-settings":
34
+ return "editProfile";
35
+ default:
36
+ return "";
37
+ }
38
+ }
39
+
40
+ /** 结构性硬边:**不提供、不可配置**(spec §7.6)。 */
41
+ export const STRUCTURALLY_FORBIDDEN = Object.freeze([
42
+ "force-push-others-branch",
43
+ "coordinator-permanent-delete",
44
+ "edit-constraint-switches",
45
+ ]);
46
+
47
+ /** merge 的默认阈值(spec §7.5)。 */
48
+ export const DEFAULT_MERGE_LIMITS = Object.freeze({ maxDiffFiles: 20, maxDiffLines: 600 });
49
+
50
+ /**
51
+ * 判断一条申请现在能不能执行。
52
+ * @param {object} input
53
+ * @param {{ status?: string, action?: string }} input.approval
54
+ * @param {Record<string, boolean>} [input.danger] 项目的危险开关
55
+ * @param {{ maxDiffFiles?: number, maxDiffLines?: number }} [input.limits]
56
+ * @param {{ diffFiles?: number, diffLines?: number, baseBranch?: string|null, worktreeClean?: boolean|null }} [input.impact]
57
+ * @returns {{ ok: boolean, reason: string }}
58
+ */
59
+ export function checkExecutable(input) {
60
+ const approval = input?.approval ?? {};
61
+ const action = String(approval.action ?? "");
62
+
63
+ if (String(approval.status ?? "") !== "approved") return { ok: false, reason: "not-approved" };
64
+ if (!DANGER_ACTIONS.includes(action))
65
+ return { ok: false, reason: `action-not-executable: ${action || "(empty)"}` };
66
+ const switchKey = switchForAction(action);
67
+ if (switchKey === "" || input?.danger?.[switchKey] !== true)
68
+ return { ok: false, reason: "switch-off" };
69
+
70
+ const limits = { ...DEFAULT_MERGE_LIMITS, ...(input?.limits ?? {}) };
71
+ const impact = input?.impact ?? {};
72
+
73
+ if (action === "merge") {
74
+ // 只合并自己开的 PR、基分支必须是项目主线;影响面必须落在阈值内
75
+ if (
76
+ Number.isFinite(impact.diffFiles) &&
77
+ Number(impact.diffFiles) > Number(limits.maxDiffFiles)
78
+ ) {
79
+ return { ok: false, reason: "merge/too-many-files" };
80
+ }
81
+ if (
82
+ Number.isFinite(impact.diffLines) &&
83
+ Number(impact.diffLines) > Number(limits.maxDiffLines)
84
+ ) {
85
+ return { ok: false, reason: "merge/too-many-lines" };
86
+ }
87
+ }
88
+
89
+ if (action === "delete-thread" && impact.worktreeClean === false) {
90
+ // worktree 不干净时不许借"删除线程"顺手删掉未提交内容(M2 三重判据的延续)
91
+ return { ok: false, reason: "delete-thread/worktree-dirty" };
92
+ }
93
+
94
+ return { ok: true, reason: "" };
95
+ }
96
+
97
+ /**
98
+ * 生成执行命令(argv 数组,**不做 shell 插值**)。
99
+ * 拒绝任何越界参数:分支名/PR 号必须是我们自己记录过的。
100
+ * @param {string} action
101
+ * @param {any} args
102
+ * @returns {{ argv: string[] } | { error: string }}
103
+ */
104
+ export function planCommand(action, args) {
105
+ const nonEmpty = (/** @type {unknown} */ value) =>
106
+ typeof value === "string" && value.trim() !== "";
107
+
108
+ if (action === "push-branch") {
109
+ const branch = String(args?.branch ?? "").trim();
110
+ if (!nonEmpty(branch)) return { error: "branch-required" };
111
+ // 只推自己建的分支,且名字必须落在我们的字符集内(纵深防御:argv 虽无注入,
112
+ // 但分支名会被写进审计、URL 与 PR 描述,宽白名单没有好处)
113
+ if (!/^dsh\/[A-Za-z0-9._/-]+$/u.test(branch)) return { error: "branch-not-ours" };
114
+ return { argv: ["git", "push", "-u", "origin", branch] };
115
+ }
116
+
117
+ if (action === "merge") {
118
+ const prNumber = Number(args?.prNumber);
119
+ if (!Number.isInteger(prNumber) || prNumber <= 0) return { error: "pr-required" };
120
+ return { argv: ["gh", "pr", "merge", String(prNumber), "--squash"] };
121
+ }
122
+
123
+ if (action === "delete-thread") {
124
+ const sessionId = String(args?.sessionId ?? "").trim();
125
+ if (!nonEmpty(sessionId)) return { error: "session-required" };
126
+ return { argv: ["reclaim-worktree", sessionId] }; // 内部动作,不是外部命令
127
+ }
128
+
129
+ if (action === "delete-project") {
130
+ const projectId = String(args?.projectId ?? "").trim();
131
+ if (!nonEmpty(projectId)) return { error: "project-required" };
132
+ return { argv: ["trash-project", projectId] };
133
+ }
134
+
135
+ return { error: `no-command-for: ${action || "(empty)"}` };
136
+ }
137
+
138
+ /**
139
+ * 恢复证据:每个不可逆动作都要能说清"怎么退回去"。
140
+ * @param {string} action
141
+ * @param {any} args
142
+ * @param {any} [result]
143
+ * @returns {Record<string, string|number|null>}
144
+ */
145
+ export function recoveryEvidence(action, args, result) {
146
+ const base = {
147
+ action,
148
+ at: new Date().toISOString(),
149
+ };
150
+ if (action === "push-branch")
151
+ return { ...base, branch: String(args?.branch ?? ""), remote: "origin" };
152
+ if (action === "merge") {
153
+ return { ...base, prNumber: Number(args?.prNumber) || null, revertHint: "gh pr revert <n>" };
154
+ }
155
+ if (action === "delete-thread")
156
+ return { ...base, sessionId: String(args?.sessionId ?? ""), restorable: "trash/manifest" };
157
+ if (action === "delete-project") {
158
+ return {
159
+ ...base,
160
+ projectId: String(args?.projectId ?? ""),
161
+ trashDir: String(result?.trashDir ?? ""),
162
+ };
163
+ }
164
+ if (action === "change-settings")
165
+ return { ...base, before: String(result?.before ?? ""), after: String(result?.after ?? "") };
166
+ return base;
167
+ }
package/lib/index.js ADDED
@@ -0,0 +1,5 @@
1
+ // @ts-check
2
+ // host 半入口:导出 Typert Remote Service 类本身(Cordis 插件形态)。
3
+ // Remote 方法声明在 ./service.js 里这个被导出类的自身原型上;
4
+ // 不要在别处包一层子类,否则 /api/projects/* 会 404(docs/runtime/0.2.1-rc.5.md §6.10)。
5
+ export { ProjectsService, ProjectsService as default } from "./service.js";
package/lib/memory.js ADDED
@@ -0,0 +1,53 @@
1
+ // @ts-check
2
+ // 项目记忆的写入逻辑:纯函数、零 I/O,方便单测;真正的写盘在 service 里。
3
+ // 布局与 project-files.js 一致:<dataRoot>/<projectId>/memory/MEMORY.md。
4
+ // 设计取向:记忆是**索引**不是仓库——单文件有上限、条目去重、只追加不改写。
5
+
6
+ /** 记忆文件上限(字符):超过就拒绝写入,让人自己整理,而不是悄悄截断内容。 */
7
+ export const MEMORY_MAX_CHARS = 32 * 1024;
8
+
9
+ /** 单条记忆上限(字符)。 */
10
+ export const MEMORY_ENTRY_MAX_CHARS = 2_000;
11
+
12
+ /**
13
+ * 把一条新记忆规范化成单段落文本:去首尾空白、压掉多余空行、截断单条上限。
14
+ * @param {unknown} text
15
+ * @returns {string}
16
+ */
17
+ export function normalizeEntry(text) {
18
+ const value = String(text ?? "")
19
+ .replace(/\r\n/gu, "\n")
20
+ .replace(/\n{3,}/gu, "\n\n")
21
+ .trim();
22
+ if (value === "") return "";
23
+ return value.length > MEMORY_ENTRY_MAX_CHARS
24
+ ? `${value.slice(0, MEMORY_ENTRY_MAX_CHARS)}\n…(已截断)`
25
+ : value;
26
+ }
27
+
28
+ /**
29
+ * 把一条记忆追加到索引文本。
30
+ * 规则:完全相同的内容不重复追加(幂等);超上限则拒绝并给出原因。
31
+ * @param {string} existing
32
+ * @param {unknown} entry
33
+ * @param {{ at?: string, maxChars?: number }} [options]
34
+ * @returns {{ ok: boolean, text: string, reason: string, added: boolean }}
35
+ */
36
+ export function appendEntry(existing, entry, options) {
37
+ const base = String(existing ?? "")
38
+ .replace(/\r\n/gu, "\n")
39
+ .trimEnd();
40
+ const normalized = normalizeEntry(entry);
41
+ if (normalized === "") return { ok: false, text: base, reason: "empty-entry", added: false };
42
+ if (base.includes(normalized)) return { ok: true, text: base, reason: "duplicate", added: false };
43
+
44
+ const requestedMax = options?.maxChars;
45
+ const maxChars = Number.isFinite(requestedMax) ? Number(requestedMax) : MEMORY_MAX_CHARS;
46
+ const at = typeof options?.at === "string" && options.at !== "" ? options.at : "";
47
+ const block = at === "" ? normalized : `${normalized}\n<!-- ${at} -->`;
48
+ const candidate = base === "" ? block : `${base}\n\n${block}`;
49
+ if (candidate.length > maxChars) {
50
+ return { ok: false, text: base, reason: "memory-full", added: false };
51
+ }
52
+ return { ok: true, text: `${candidate}\n`, reason: "", added: true };
53
+ }
package/lib/notify.js ADDED
@@ -0,0 +1,50 @@
1
+ // @ts-check
2
+ // 通知的判定逻辑:纯函数、零 I/O。
3
+ // 只关心「新出现的需要人处理的东西」,避免同一件事反复弹。
4
+
5
+ /**
6
+ * @typedef {object} Snapshot
7
+ * @property {Record<string, { state: string, projectId?: string }>} threads 按 sessionId 的线程状态
8
+ * @property {string[]} projects 活跃项目 id(用于发现项目被删)
9
+ */
10
+
11
+ /**
12
+ * 比较两次快照,算出「这次新冒出来的」提醒。
13
+ * 规则:
14
+ * - 线程从非 failed 变成 failed → 一条 failed 提醒
15
+ * - 线程从非 waiting-user 变成 waiting-user → 一条 waiting 提醒
16
+ * - 已知线程消失(归档/删除)→ 不提醒
17
+ * @param {Snapshot} previous
18
+ * @param {Snapshot} next
19
+ * @returns {{ kind: "failed" | "waiting-user", projectId: string, sessionId: string }[]}
20
+ */
21
+ export function diffAttention(previous, next) {
22
+ const before = previous?.threads ?? {};
23
+ const after = next?.threads ?? {};
24
+ /** @type {{ kind: "failed" | "waiting-user", projectId: string, sessionId: string }[]} */
25
+ const out = [];
26
+ for (const [sessionId, entry] of Object.entries(after)) {
27
+ const was = before[sessionId]?.state;
28
+ if (entry.state === "failed" && was !== "failed") {
29
+ out.push({ kind: "failed", projectId: String(entry.projectId ?? ""), sessionId });
30
+ } else if (entry.state === "waiting-user" && was !== "waiting-user") {
31
+ out.push({ kind: "waiting-user", projectId: String(entry.projectId ?? ""), sessionId });
32
+ }
33
+ }
34
+ return out;
35
+ }
36
+
37
+ /**
38
+ * 把多条提醒压成一句可读文案(同一项目内按类型计数)。
39
+ * @param {{ kind: string }[]} items
40
+ * @returns {{ failed: number, waiting: number, text: string }}
41
+ */
42
+ export function summarize(items) {
43
+ const list = Array.isArray(items) ? items : [];
44
+ const failed = list.filter((item) => item.kind === "failed").length;
45
+ const waiting = list.filter((item) => item.kind === "waiting-user").length;
46
+ const parts = [];
47
+ if (failed > 0) parts.push(`${failed} 个线程失败`);
48
+ if (waiting > 0) parts.push(`${waiting} 个线程在等你`);
49
+ return { failed, waiting, text: parts.join(" · ") };
50
+ }
@@ -0,0 +1,199 @@
1
+ // @ts-check
2
+ // Overview 状态机:纯函数、零 I/O。
3
+ // 设计依据见 notes/projects/m2-design.md §2:
4
+ // 优先级 waiting-user > failed > working > done > idle
5
+ // 全部从持久事件推导,不自己计时、不看模型自报。
6
+ // 已知坑(docs/runtime/0.2.2-rc.3.md §4):turn/start 先于 user/message,
7
+ // 所以「这一轮是否失败」只能在 turn/end 收尾,不能在 turn/start 清理。
8
+
9
+ /** 线程在面板上的状态。M4 会再加 ready-for-review / landing。 */
10
+ export const THREAD_STATES = Object.freeze(["waiting-user", "failed", "working", "done", "idle"]);
11
+
12
+ /**
13
+ * 面板排序权重:数字越小越靠上。
14
+ * @type {Readonly<Record<string, number>>}
15
+ */
16
+ export const STATE_RANK = Object.freeze({
17
+ "waiting-user": 0,
18
+ failed: 1,
19
+ working: 2,
20
+ done: 3,
21
+ idle: 4,
22
+ });
23
+
24
+ /**
25
+ * @typedef {object} ThreadView
26
+ * @property {string} state
27
+ * @property {number} turn 最近一次看到的 turn 号(0 表示还没跑过)
28
+ * @property {boolean} awaitingUser 是否有待处理的交互(审批/提问/计划审阅)
29
+ * @property {boolean} lastTurnFailed 最近一轮是否以错误结束
30
+ * @property {boolean} lastAttemptFailed 本轮里是否出现过带 error 的 assistant/attempt
31
+ * @property {number} lastActivityAt 最近一次活动时间(毫秒时间戳,0 表示未知)
32
+ * @property {boolean} unread 是否有未读完成
33
+ */
34
+
35
+ /** @returns {ThreadView} */
36
+ export function initialView() {
37
+ return {
38
+ state: "idle",
39
+ turn: 0,
40
+ awaitingUser: false,
41
+ lastTurnFailed: false,
42
+ lastAttemptFailed: false,
43
+ lastActivityAt: 0,
44
+ unread: false,
45
+ };
46
+ }
47
+
48
+ /**
49
+ * 由「当前已知的原始事实」推导状态。纯函数:同样的输入永远同样的输出。
50
+ * 这样重启后只要把持久事件重放一遍就能重建,不依赖内存里的中间态。
51
+ * @param {ThreadView} view
52
+ * @returns {string}
53
+ */
54
+ export function deriveState(view) {
55
+ if (view.awaitingUser) return "waiting-user";
56
+ if (view.lastTurnFailed) return "failed";
57
+ if (view.state === "working") return "working";
58
+ if (view.unread) return "done";
59
+ return "idle";
60
+ }
61
+
62
+ /**
63
+ * 归约一个事件。不认识的事件原样返回(前向兼容,硬性约定 1)。
64
+ * @param {ThreadView} view
65
+ * @param {{ type?: string, at?: number, data?: any }} event
66
+ * @returns {ThreadView}
67
+ */
68
+ export function reduce(view, event) {
69
+ const type = String(event?.type ?? "");
70
+ const at = Number.isFinite(event?.at) ? Number(event.at) : view.lastActivityAt;
71
+ /** @type {ThreadView} */
72
+ let next = { ...view, lastActivityAt: at };
73
+
74
+ switch (type) {
75
+ case "turn/start": {
76
+ const turn = Number(event?.data?.turn);
77
+ next = {
78
+ ...next,
79
+ turn: Number.isFinite(turn) ? turn : view.turn,
80
+ state: "working",
81
+ lastTurnFailed: false,
82
+ lastAttemptFailed: false,
83
+ unread: false,
84
+ };
85
+ break;
86
+ }
87
+ case "assistant/attempt": {
88
+ // 失败信息在这里,不在 turn/end:rc.3 实测 turn/end 只带 { turn }。
89
+ if (hasErrorFinish(event?.data)) next = { ...next, lastAttemptFailed: true };
90
+ break;
91
+ }
92
+ case "interaction/pending": {
93
+ // 审批 / 提问 / 计划审阅:宿主投影里出现待处理交互
94
+ next = { ...next, awaitingUser: true };
95
+ break;
96
+ }
97
+ case "interaction/cleared": {
98
+ next = { ...next, awaitingUser: false };
99
+ break;
100
+ }
101
+ case "turn/end": {
102
+ const failed = isFailureEnd(event) || view.lastAttemptFailed === true;
103
+ next = {
104
+ ...next,
105
+ awaitingUser: false,
106
+ lastTurnFailed: failed,
107
+ state: failed ? "failed" : "done",
108
+ lastAttemptFailed: false,
109
+ unread: !failed,
110
+ };
111
+ break;
112
+ }
113
+ case "session/opened": {
114
+ // 用户正在看这个会话:清未读,但失败态保留(失败要人处理)
115
+ next = { ...next, unread: false, state: view.lastTurnFailed ? "failed" : "idle" };
116
+ break;
117
+ }
118
+ case "session/activity": {
119
+ if (view.state !== "working") next = { ...next, state: "working" };
120
+ break;
121
+ }
122
+ default:
123
+ return view;
124
+ }
125
+
126
+ return { ...next, state: deriveState(next) };
127
+ }
128
+
129
+ /**
130
+ * assistant/attempt 的 stream 里是否出现 error 结束。
131
+ * 形状(rc.3 实测):{ stream: [{ chunk: { type: "finish", reason: { kind: "error", failure } } }] }
132
+ * @param {any} data
133
+ * @returns {boolean}
134
+ */
135
+ export function hasErrorFinish(data) {
136
+ const stream = Array.isArray(data?.stream) ? data.stream : [];
137
+ for (const entry of stream) {
138
+ const chunk = entry?.chunk ?? entry;
139
+ if (String(chunk?.type ?? "") !== "finish") continue;
140
+ const reason = chunk?.reason;
141
+ if (reason && typeof reason === "object" && String(reason.kind ?? "") === "error") return true;
142
+ if (typeof reason === "string" && /error|fail/iu.test(reason)) return true;
143
+ }
144
+ return false;
145
+ }
146
+
147
+ /**
148
+ * 一轮是否以错误结束。
149
+ * 依据 rc.3 实测:失败信息在 assistant/attempt 的 finish reason 里,
150
+ * 但 turn/end 也可能带 reason —— 两处都认,任一为 error 即失败。
151
+ * @param {{ data?: any }} event
152
+ * @returns {boolean}
153
+ */
154
+ export function isFailureEnd(event) {
155
+ const data = event?.data ?? {};
156
+ const reason = data.reason ?? data.finishReason ?? data.outcome;
157
+ if (reason && typeof reason === "object" && String(reason.kind ?? "") === "error") return true;
158
+ if (typeof reason === "string" && /error|fail|cancel|abort/iu.test(reason)) return true;
159
+ if (data.error) return true;
160
+ return false;
161
+ }
162
+
163
+ /**
164
+ * 重放一串持久事件,得到当前视图(重启重建用)。
165
+ * @param {readonly { type?: string, at?: number, data?: any }[]} events
166
+ * @returns {ThreadView}
167
+ */
168
+ export function replay(events) {
169
+ /** @type {ThreadView} */
170
+ let view = initialView();
171
+ for (const event of events ?? []) view = reduce(view, event);
172
+ return view;
173
+ }
174
+
175
+ /**
176
+ * 面板排序:先按状态权重,再按最近活动时间降序,最后按 id 稳定排序。
177
+ * @param {{ sessionId: string, view: ThreadView }[]} rows
178
+ * @returns {{ sessionId: string, view: ThreadView }[]}
179
+ */
180
+ export function sortRows(rows) {
181
+ return [...(rows ?? [])].sort((left, right) => {
182
+ const rank = (STATE_RANK[left.view.state] ?? 99) - (STATE_RANK[right.view.state] ?? 99);
183
+ if (rank !== 0) return rank;
184
+ const byTime = (right.view.lastActivityAt ?? 0) - (left.view.lastActivityAt ?? 0);
185
+ if (byTime !== 0) return byTime;
186
+ return String(left.sessionId).localeCompare(String(right.sessionId));
187
+ });
188
+ }
189
+
190
+ /**
191
+ * 「需要我」的线程(waiting-user 或 failed)。
192
+ * @param {{ sessionId: string, view: ThreadView }[]} rows
193
+ * @returns {{ sessionId: string, view: ThreadView }[]}
194
+ */
195
+ export function needsAttention(rows) {
196
+ return sortRows(rows).filter(
197
+ (row) => row.view.state === "waiting-user" || row.view.state === "failed",
198
+ );
199
+ }
package/lib/paths.js ADDED
@@ -0,0 +1,28 @@
1
+ // @ts-check
2
+ // 数据根解析(**纯函数**,便于 node --test 直接引用)。
3
+ //
4
+ // 优先级与 btw / session-delete 一致:config.dataRoot → DSH_HOME(+ /projects)→ ~/.dsh/projects。
5
+ //
6
+ // 为什么必须有 ~/.dsh 回落:DSH 桌面版的进程环境里**不导出 DSH_HOME**(实测 2026-11-18:
7
+ // 主进程 env 只有 HOME),此前这里直接抛错,结果 projects 面板在真实桌面里显示
8
+ // `projects: store is unavailable`,只有 web 冒烟(显式设了 DSH_HOME)才是好的。
9
+ import { homedir } from "node:os";
10
+ import { join, resolve } from "node:path";
11
+
12
+ /**
13
+ * 解析 projects 的数据根(`projects.json` 所在目录)。
14
+ * @param {{ dataRoot?: unknown } | Record<string, unknown> | undefined} [config]
15
+ * @param {NodeJS.ProcessEnv} [env]
16
+ * @param {string} [home]
17
+ * @returns {string}
18
+ */
19
+ export function resolveDataRoot(config, env = process.env, home = homedir()) {
20
+ const configured =
21
+ config !== null && typeof config === "object" && "dataRoot" in config
22
+ ? config.dataRoot
23
+ : undefined;
24
+ if (typeof configured === "string" && configured.trim() !== "") return resolve(configured);
25
+ const fromEnv = typeof env?.DSH_HOME === "string" ? env.DSH_HOME.trim() : "";
26
+ if (fromEnv !== "") return resolve(join(fromEnv, "projects"));
27
+ return resolve(join(home, ".dsh", "projects"));
28
+ }