@waq666/pneuma 0.8.0 → 0.8.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.
Files changed (84) hide show
  1. package/README.md +10 -5
  2. package/lib/adapter/transcript.js +12 -1
  3. package/lib/app/Composer.js +14 -2
  4. package/lib/contract/plugin.d.ts +8 -0
  5. package/lib/contract/session.d.ts +8 -0
  6. package/lib/contract/snapshot.d.ts +5 -0
  7. package/lib/core/agent-roles.js +3 -2
  8. package/lib/core/commands-completion.d.ts +17 -0
  9. package/lib/core/commands-completion.js +56 -3
  10. package/lib/core/compact.d.ts +36 -6
  11. package/lib/core/compact.js +89 -17
  12. package/lib/core/events.d.ts +5 -0
  13. package/lib/core/git-info.d.ts +127 -15
  14. package/lib/core/git-info.js +307 -32
  15. package/lib/core/host-methods.d.ts +1 -1
  16. package/lib/core/host-methods.js +1 -0
  17. package/lib/core/llm.d.ts +9 -0
  18. package/lib/core/llm.js +1 -0
  19. package/lib/core/loop.js +8 -2
  20. package/lib/core/permission-scope.d.ts +12 -1
  21. package/lib/core/permission-scope.js +26 -1
  22. package/lib/core/presets.js +30 -2
  23. package/lib/core/session.d.ts +48 -7
  24. package/lib/core/session.js +263 -9
  25. package/lib/core/ui-methods.d.ts +1 -1
  26. package/lib/core/ui-methods.js +6 -0
  27. package/lib/plugins/agent.js +47 -6
  28. package/lib/plugins/commands.js +118 -14
  29. package/lib/plugins/compact.d.ts +2 -2
  30. package/lib/plugins/compact.js +150 -22
  31. package/lib/plugins/git.js +15 -1
  32. package/lib/plugins/goal.js +8 -4
  33. package/lib/plugins/host-stdio.js +11 -1
  34. package/lib/plugins/microcompact.d.ts +3 -0
  35. package/lib/plugins/microcompact.js +26 -0
  36. package/lib/plugins/remote.js +7 -1
  37. package/lib/plugins/runtime.js +5 -0
  38. package/lib/plugins/session.js +81 -7
  39. package/lib/plugins/skills.js +16 -0
  40. package/lib/plugins/subagent.js +47 -11
  41. package/lib/services/types.d.ts +66 -8
  42. package/lib/ui/assets/{app-MhfBFsp-.js → app-B-Jx5dnh.js} +60 -59
  43. package/lib/ui/assets/{chunk-Cq7xGE-D.js → chunk-Bfdlo8Me.js} +1 -1
  44. package/lib/ui/assets/{chunk-CA5f1pGf.js → chunk-DGX-i4eb.js} +1 -1
  45. package/lib/ui/assets/index.html +2 -2
  46. package/lib/ui/assets/style-WzxwEPaE.css +1 -0
  47. package/lib/ui/plugins/actions/bundle.json +2 -2
  48. package/lib/ui/plugins/ask/bundle.json +2 -2
  49. package/lib/ui/plugins/browser/bundle.json +2 -2
  50. package/lib/ui/plugins/composer/bundle.json +2 -2
  51. package/lib/ui/plugins/composer/client.js +57 -4
  52. package/lib/ui/plugins/files/bundle.json +2 -2
  53. package/lib/ui/plugins/manifest.json +1 -1
  54. package/lib/ui/plugins/palette/bundle.json +2 -2
  55. package/lib/ui/plugins/plugins/bundle.json +2 -2
  56. package/lib/ui/plugins/preview/bundle.json +2 -2
  57. package/lib/ui/plugins/prompt/bundle.json +2 -2
  58. package/lib/ui/plugins/sessions/bundle.json +2 -2
  59. package/lib/ui/plugins/sessions/client.js +41 -13
  60. package/lib/ui/plugins/settings/bundle.json +2 -2
  61. package/lib/ui/plugins/skills/bundle.json +2 -2
  62. package/lib/ui/plugins/status/bundle.json +2 -2
  63. package/lib/ui/plugins/status/client.js +162 -9
  64. package/lib/ui/plugins/statusbar/bundle.json +2 -2
  65. package/lib/ui/plugins/tasks/bundle.json +2 -2
  66. package/lib/ui/plugins/team/bundle.json +2 -2
  67. package/lib/ui/plugins/terminal/bundle.json +2 -2
  68. package/lib/ui/plugins/trace/bundle.json +2 -2
  69. package/lib/ui/plugins/transcript/bundle.json +2 -2
  70. package/lib/ui/plugins/transcript/client.js +156 -96
  71. package/lib/ui/sdk/@dsc/ui/package.json +1 -1
  72. package/lib/ui/sdk/@dsc/ui-core/package.json +1 -1
  73. package/lib/ui/sdk/@dsc/ui-dockkit/package.json +1 -1
  74. package/lib/ui/sdk/@dsc/ui-layout/package.json +1 -1
  75. package/lib/ui/sdk/@dsc/ui-primitives/icons.d.ts +13 -2
  76. package/lib/ui/sdk/@dsc/ui-primitives/image-lightbox.d.ts +21 -0
  77. package/lib/ui/sdk/@dsc/ui-primitives/index.d.ts +3 -0
  78. package/lib/ui/sdk/@dsc/ui-primitives/package.json +1 -1
  79. package/lib/ui/sdk/@dsc/ui-primitives/review-findings-card.d.ts +25 -0
  80. package/lib/ui/sdk/@dsc/ui-primitives/review-findings.d.ts +64 -0
  81. package/lib/ui/sdk/@dsc/ui-renderer/package.json +1 -1
  82. package/lib/ui/sdk/@dsc/ui-slots/package.json +1 -1
  83. package/package.json +1 -1
  84. package/lib/ui/assets/style-CIJVQKkj.css +0 -1
@@ -1,26 +1,137 @@
1
+ import type { ReviewStatusView } from '../services/types.js';
1
2
  import { type FileChangeSummary } from './tools.js';
2
- /** 审查 diff 塞进上下文的字符预算(约 1.5 万 token;超了从尾部截,头部是改动清单更值钱)。 */
3
- export declare const REVIEW_DIFF_BUDGET = 60000;
4
3
  /** 受控执行 git(execFile 固定首参字面量 + 参数数组;无 shell)。 */
5
4
  export declare function gitExec(cwd: string, args: string[]): Promise<string>;
6
5
  /**
7
- * 收集工作区未提交改动(codex /review 的 UncommittedChanges 目标):
8
- * `git diff HEAD` 含已暂存改动;untracked 不进 diff(`git diff` 本来就不含它们),
9
- * 只列名单让模型自己 read。不是 git 仓库时返回 null。
6
+ * 校验用户给的分支 / 提交引用。
7
+ *
8
+ * 为什么非校验不可:`git show <ref>` 的 ref 来自 `/review` 后面的自由输入,而
9
+ * `execFile` 只挡得住 shell 拼接、挡不住**选项注入**——填 `--output=D:\\任意路径` 时
10
+ * git 会把它当选项执行(把补丁写进那个文件)。所以只放行正常引用字符,并且不许以
11
+ * `-` 开头(那就是选项的地盘)。`~`、`^`、`@{` 这些 rev 语法照常可用。
12
+ *
13
+ * @param ref - 用户输入或候选里的原始值
14
+ * @returns 去掉首尾空白的引用
10
15
  */
11
- export declare function collectWorkingTree(cwd: string): Promise<{
12
- diff: string;
16
+ export declare function assertReviewRef(ref: string): string;
17
+ /** /review 的审查范围。 */
18
+ export type ReviewTarget = {
19
+ kind: 'worktree';
20
+ } | {
21
+ kind: 'base';
22
+ ref: string;
23
+ } | {
24
+ kind: 'commit';
25
+ ref: string;
26
+ title?: string;
27
+ } | {
28
+ kind: 'custom';
29
+ instructions: string;
30
+ };
31
+ /** 一次审查的取数结果:范围描述 + 完整 diff 落盘路径 + 改动清单 + 未跟踪名单。 */
32
+ export interface ReviewScope {
33
+ target: ReviewTarget;
34
+ /** 给用户与队友看的一句话范围(「未提交改动」「对比基准分支 main 的差异(共同祖先 abc1234)」)。 */
35
+ label: string;
36
+ /** 完整 diff 落盘的绝对路径。 */
37
+ diffPath: string;
38
+ /** 落盘 diff 的字节数(不是字符数——中文一个字 3 字节,按字节算才知道文件多大)。 */
39
+ diffBytes: number;
40
+ /** `git diff --stat` 的原文:给队友一眼看清单。 */
41
+ stat: string;
42
+ /** 未跟踪文件(diff 里本来就没有它们,只列名单让队友自己 read)。 */
13
43
  untracked: string[];
14
- } | null>;
44
+ /** base 范围算出来的共同祖先提交(完整 SHA)。 */
45
+ base?: string;
46
+ }
15
47
  /**
16
- * /review 的审查消息组装(T18:主会话回落轮与审查队友的任务描述共用这一份)。
17
- * 独立成纯函数便于脱离命令体系直测;挪进本模块是因为「收集」与「组装」同域,
18
- * 而 commands.js 的顶层不许出现 node 内置模块 import。
48
+ * 按范围取一次审查的完整数据(不截断)。
49
+ *
50
+ * 取数口径(`--no-textconv --no-ext-diff` 防文本转换与外部 diff driver 当场跑程序):
51
+ * - worktree / custom:`git diff HEAD`(含已暂存;未跟踪只列名单);
52
+ * - base:先 `git merge-base HEAD <ref>` 拿到共同祖先,再 `git diff <祖先>`;
53
+ * - commit:`git show <ref> --format=fuller`(连提交信息一起给队友)。
54
+ *
55
+ * @param cwd - 会话工作目录
56
+ * @param target - 审查范围
57
+ * @param sessionId - 会话 id(只用于 diff 文件名;不传就按 cwd 哈希,探针里两参调用即可)
58
+ * @returns 不是 git 仓库时 null;ref 不存在等 git 报错按异常抛出(调用方给用户看原文)
19
59
  */
20
- export declare function reviewMessage(collected: {
21
- diff: string;
22
- untracked: string[];
23
- }, focus: string): string;
60
+ export declare function collectReviewScope(cwd: string, target: ReviewTarget, sessionId?: string): Promise<ReviewScope | null>;
61
+ /** 本地分支清单(「对比基准分支」的候选项);不是 git 仓库或没有分支时给空数组。 */
62
+ export declare function listReviewBranches(cwd: string): Promise<string[]>;
63
+ /** 最近 100 条提交(「审查某次提交」的候选项);取不到给空数组,用户仍可手填 SHA。 */
64
+ export declare function listReviewCommits(cwd: string): Promise<{
65
+ sha: string;
66
+ subject: string;
67
+ }[]>;
68
+ /**
69
+ * 给审查队友的任务书(/review 的唯一组装点:派队友走它,回落主会话轮也走它)。
70
+ *
71
+ * 为什么要把「diff 已落盘」写进任务书:队友只有读类工具,不知道文件在哪就只能
72
+ * 在上下文里找,而完整 diff 可能几十 MB——先告诉它路径与读法,它才可能读全。
73
+ *
74
+ * @param scope - 取数结果
75
+ * @param focus - 用户写在 /review 后面的关注点(空串 = 不限)
76
+ */
77
+ export declare function reviewTaskText(scope: ReviewScope, focus: string): string;
78
+ /** 取消之后记进记录文件的那句话(/review-status 会原样回看)。 */
79
+ export declare const REVIEW_CANCELED_TEXT = "\u5BA1\u67E5\u88AB\u53D6\u6D88\u3002";
80
+ /** 一次正在跑的审查:记下队友名字与开始时间,取消与收工都用得上。 */
81
+ interface ReviewRun {
82
+ startedAt: number;
83
+ target: string;
84
+ /** 队友名(取消时要按它叫停)。 */
85
+ handle: string;
86
+ /** 已经被用户取消:收工记录里要保留「审查被取消」,不许被队友状态覆盖。 */
87
+ cancelled: boolean;
88
+ }
89
+ /**
90
+ * /review 的会话账本:内存里记「这个会话有没有在跑的审查」,磁盘上留「最近一次长什么样」。
91
+ *
92
+ * 为什么放在这里:命令侧(派审查前写 running)、审查通道(收工写 findings、取消时改状态)
93
+ * 与自检探针要共用同一份读写口径。各自拼路径、各自猜字段,重启后就对不上了。
94
+ * 记录文件 `<数据目录>/code-review/<会话 id>.json`,一个会话一份,后一次覆盖前一次。
95
+ */
96
+ export declare class ReviewJournal {
97
+ private readonly runs;
98
+ private readonly views;
99
+ private readonly home;
100
+ /** @param home - 数据目录(`ctx.settings.about().home`,与 DSC_HOME 同一个) */
101
+ constructor(home: string);
102
+ /** 这个会话的记录文件路径(会话 id 先洗一遍,别让奇怪的 id 拼出目录穿越)。 */
103
+ recordPath(sessionId: string): string;
104
+ /** 读记录文件;没有、读不动、字段对不上都算「没有记录」。 */
105
+ read(sessionId: string): ReviewStatusView | null;
106
+ /** 写记录文件(写不下去只让 /review-status 回看少一份,不影响审查本身)。 */
107
+ private write;
108
+ /** 最近一次审查的状态;没有记录返回 null。 */
109
+ status(sessionId: string): ReviewStatusView | null;
110
+ /** 这个会话正在跑的那次审查;没有返回 undefined(取消要按它拿队友名)。 */
111
+ running(sessionId: string): ReviewRun | undefined;
112
+ /** 派出去之后登记「在跑」并落一份 running 记录。 */
113
+ begin(sessionId: string, input: {
114
+ target: string;
115
+ handle: string;
116
+ startedAt?: number;
117
+ }): void;
118
+ /**
119
+ * 标记取消:记录立刻变成 finished +「审查被取消」,但**保留** runs 里那条,
120
+ * 好让随后的收工回调还知道这次审查的起始时间与范围(它会把同一句话再写一遍)。
121
+ * @returns 没有在跑的审查时 false
122
+ */
123
+ cancel(sessionId: string): boolean;
124
+ /** 这次审查是不是被用户取消的(收工时用来决定写哪句话)。 */
125
+ wasCancelled(sessionId: string): boolean;
126
+ /**
127
+ * 收工:把 findings 写进记录并清掉「在跑」那一笔。
128
+ * @param handle - 收工的是哪个队友;同一会话里前一次没收工又派了新的时,
129
+ * 旧那次收工不能把新那次的状态改成 finished(传了就按它比对,不传一律照写)
130
+ */
131
+ finish(sessionId: string, findings: string, handle?: string): void;
132
+ }
133
+ /** `/review-status` 上屏的那段文本(命令与探针共用一份,不许各写一套)。 */
134
+ export declare function reviewStatusText(view: ReviewStatusView | null): string;
24
135
  /**
25
136
  * 回合起点的 git 状态快照:仓库根 + porcelain 一行一条。非 git 仓库、git 跑不动
26
137
  * (超时/没装)一律返回 null——兜底只在确定拿得到的时候参与,绝不挡回合本身。
@@ -45,3 +156,4 @@ export declare function collectGitTurnChanges(cwd: string, before: {
45
156
  root: string;
46
157
  lines: string[];
47
158
  } | null, already: readonly string[]): Promise<FileChangeSummary[]>;
159
+ export {};
@@ -9,19 +9,33 @@
9
9
  * 安全姿势照 codex /diff:execFile 固定子命令数组(无 shell、无拼接);
10
10
  * `--no-textconv --no-ext-diff` 防文本转换与外部 diff driver 当场执行程序。
11
11
  *
12
+ * 本模块同时放 /review 的「审查范围 + 完整 diff 落盘 + 会话账本(状态/取消)」:
13
+ * 这三件事是同一个功能的宿主侧基础设施,命令侧(派审查前后)与审查通道(收工/叫停)
14
+ * 都要读写同一份口径;分开两个文件只会多出一处「记录字段与谁对得上」的维护负担。
15
+ *
12
16
  * @module dsc/core/git-info
13
17
  */
14
18
  import { execFile } from 'node:child_process';
15
- import { promises as fsp } from 'node:fs';
16
- import { join } from 'node:path';
19
+ import { createHash } from 'node:crypto';
20
+ import { mkdirSync, promises as fsp, readFileSync, writeFileSync } from 'node:fs';
21
+ import { dirname, join } from 'node:path';
22
+ import { dscPath } from './path-policy.js';
17
23
  import { stripBaseline } from './tools.js';
18
24
  import { summarizeChange } from './tools/fs-tools.js';
19
- /** 审查 diff 塞进上下文的字符预算(约 1.5 万 token;超了从尾部截,头部是改动清单更值钱)。 */
20
- export const REVIEW_DIFF_BUDGET = 60_000;
21
25
  /** 受控执行 git(execFile 固定首参字面量 + 参数数组;无 shell)。 */
22
26
  export function gitExec(cwd, args) {
27
+ return runGit(cwd, args, 8 * 1024 * 1024, 15000);
28
+ }
29
+ /**
30
+ * 受控执行 git 的唯一实现({@link gitExec} 与取数那几次调用都走它)。
31
+ *
32
+ * 为什么缓冲与超时要能传:一次审查的 diff 不再截断(截断会把「后面还有问题」的改动
33
+ * 整段藏起来),8 MB 的默认上限在中等规模仓库里就会 ENOBUFS 当场失败,而不是「慢一点」。
34
+ * 128 MB 的上限是防跑飞的闸,不是预期用量;超过它的 diff 本来也不该一次读进内存。
35
+ */
36
+ function runGit(cwd, args, maxBuffer, timeout) {
23
37
  return new Promise((resolveDone, rejectDone) => {
24
- execFile('git', args, { cwd, maxBuffer: 8 * 1024 * 1024, windowsHide: true, timeout: 15000, killSignal: 'SIGKILL' }, (error, stdout, stderr) => {
38
+ execFile('git', args, { cwd, maxBuffer, windowsHide: true, timeout, killSignal: 'SIGKILL' }, (error, stdout, stderr) => {
25
39
  if (error !== undefined && error !== null)
26
40
  rejectDone(new Error(String(stderr || error.message).slice(0, 400)));
27
41
  else
@@ -29,12 +43,69 @@ export function gitExec(cwd, args) {
29
43
  });
30
44
  });
31
45
  }
46
+ /** 取 diff 那几次 git 调用共用:缓冲 128 MB、超时 5 分钟(大仓库的一次 diff 就够慢)。 */
47
+ const gitForDiff = (cwd, args) => runGit(cwd, args, 128 * 1024 * 1024, 300_000);
48
+ /** 超过这个字节数的 diff 在「改动清单」末尾补一句读法提示(20 MB,见下)。 */
49
+ const HUGE_DIFF_BYTES = 20 * 1024 * 1024;
32
50
  /**
33
- * 收集工作区未提交改动(codex /review 的 UncommittedChanges 目标):
34
- * `git diff HEAD` 含已暂存改动;untracked 不进 diff(`git diff` 本来就不含它们),
35
- * 只列名单让模型自己 read。不是 git 仓库时返回 null。
51
+ * 校验用户给的分支 / 提交引用。
52
+ *
53
+ * 为什么非校验不可:`git show <ref>` 的 ref 来自 `/review` 后面的自由输入,而
54
+ * `execFile` 只挡得住 shell 拼接、挡不住**选项注入**——填 `--output=D:\\任意路径` 时
55
+ * git 会把它当选项执行(把补丁写进那个文件)。所以只放行正常引用字符,并且不许以
56
+ * `-` 开头(那就是选项的地盘)。`~`、`^`、`@{` 这些 rev 语法照常可用。
57
+ *
58
+ * @param ref - 用户输入或候选里的原始值
59
+ * @returns 去掉首尾空白的引用
36
60
  */
37
- export async function collectWorkingTree(cwd) {
61
+ export function assertReviewRef(ref) {
62
+ const trimmed = ref.trim();
63
+ if (trimmed === '' || trimmed.startsWith('-') || !/^[A-Za-z0-9._~^@{}/:-]+$/.test(trimmed)) {
64
+ throw new Error(`不像一个分支或提交引用:${ref}`);
65
+ }
66
+ return trimmed;
67
+ }
68
+ /** 未跟踪文件名单:`git status --porcelain` 里 `??` 那几行。 */
69
+ async function listUntracked(cwd) {
70
+ const porcelain = await gitExec(cwd, ['-c', 'core.quotePath=false', 'status', '--porcelain=v1']);
71
+ return porcelain
72
+ .split('\n')
73
+ .filter((line) => line.startsWith('??'))
74
+ .map((line) => line.slice(3).trim())
75
+ .filter((file) => file !== '');
76
+ }
77
+ /** 短哈希:会话 id 或工作目录都行,只用来让同一个会话的 diff 文件名彼此认得出来。 */
78
+ function shortHash(seed) {
79
+ return createHash('sha256').update(seed).digest('hex').slice(0, 8);
80
+ }
81
+ /**
82
+ * 把完整 diff 写进 `<数据目录>/cache/review/<会话短哈希>-<时间戳>.diff`,返回绝对路径。
83
+ *
84
+ * 为什么落盘而不是塞进任务描述:审查队友的上下文有预算,塞进去就得截断;落盘之后
85
+ * 它可以按需 `read` 的 offset/limit 分批看完整内容,截断这件事就不存在了。
86
+ * 数据目录复用 path-policy 的 DSC_HOME(`DSC_HOME` 环境变量优先),与配置、会话同一处。
87
+ */
88
+ async function writeReviewDiff(seed, diff) {
89
+ const dir = dscPath('cache', 'review');
90
+ await fsp.mkdir(dir, { recursive: true });
91
+ const file = join(dir, `${shortHash(seed)}-${String(Date.now())}.diff`);
92
+ await fsp.writeFile(file, diff, 'utf8');
93
+ return file;
94
+ }
95
+ /**
96
+ * 按范围取一次审查的完整数据(不截断)。
97
+ *
98
+ * 取数口径(`--no-textconv --no-ext-diff` 防文本转换与外部 diff driver 当场跑程序):
99
+ * - worktree / custom:`git diff HEAD`(含已暂存;未跟踪只列名单);
100
+ * - base:先 `git merge-base HEAD <ref>` 拿到共同祖先,再 `git diff <祖先>`;
101
+ * - commit:`git show <ref> --format=fuller`(连提交信息一起给队友)。
102
+ *
103
+ * @param cwd - 会话工作目录
104
+ * @param target - 审查范围
105
+ * @param sessionId - 会话 id(只用于 diff 文件名;不传就按 cwd 哈希,探针里两参调用即可)
106
+ * @returns 不是 git 仓库时 null;ref 不存在等 git 报错按异常抛出(调用方给用户看原文)
107
+ */
108
+ export async function collectReviewScope(cwd, target, sessionId) {
38
109
  try {
39
110
  const inside = (await gitExec(cwd, ['rev-parse', '--is-inside-work-tree'])).trim();
40
111
  if (inside !== 'true')
@@ -43,36 +114,240 @@ export async function collectWorkingTree(cwd) {
43
114
  catch {
44
115
  return null;
45
116
  }
46
- const porcelain = await gitExec(cwd, ['status', '--porcelain=v1']);
47
- const untracked = porcelain
48
- .split('\n')
49
- .filter((line) => line.startsWith('??'))
50
- .map((line) => line.slice(3).trim())
51
- .filter((file) => file !== '');
52
- const raw = await gitExec(cwd, ['diff', 'HEAD', '--no-textconv', '--no-ext-diff']);
53
- const diff = raw.length > REVIEW_DIFF_BUDGET ? `${raw.slice(0, REVIEW_DIFF_BUDGET)}\n…(diff 过长,已从 ${String(REVIEW_DIFF_BUDGET)} 字符处截断)` : raw;
54
- return { diff, untracked };
117
+ let diff;
118
+ let stat;
119
+ let label;
120
+ let base;
121
+ // 未跟踪文件只在「工作区」口径里有意义:对比分支与某次提交看的是已入库的改动。
122
+ const untracked = target.kind === 'worktree' || target.kind === 'custom' ? await listUntracked(cwd) : [];
123
+ if (target.kind === 'commit') {
124
+ const ref = assertReviewRef(target.ref);
125
+ diff = await gitForDiff(cwd, ['show', ref, '--no-textconv', '--no-ext-diff', '--format=fuller']);
126
+ stat = await gitForDiff(cwd, ['show', ref, '--stat', '--format=']);
127
+ const sha = (await gitExec(cwd, ['rev-parse', ref])).trim();
128
+ const title = target.title ?? (await gitExec(cwd, ['log', '-1', '--format=%s', ref])).trim();
129
+ label = `提交 ${sha.slice(0, 10)}${title === '' ? '' : ` ${title}`}`;
130
+ }
131
+ else if (target.kind === 'base') {
132
+ const ref = assertReviewRef(target.ref);
133
+ base = (await gitExec(cwd, ['merge-base', 'HEAD', ref])).trim();
134
+ diff = await gitForDiff(cwd, ['diff', base, '--no-textconv', '--no-ext-diff']);
135
+ stat = await gitForDiff(cwd, ['diff', base, '--stat']);
136
+ label = `对比基准分支 ${ref} 的差异(共同祖先 ${base.slice(0, 10)})`;
137
+ }
138
+ else {
139
+ diff = await gitForDiff(cwd, ['diff', 'HEAD', '--no-textconv', '--no-ext-diff']);
140
+ stat = await gitForDiff(cwd, ['diff', 'HEAD', '--stat']);
141
+ label = target.kind === 'custom' ? '未提交改动(自定义审查要求)' : '未提交改动';
142
+ }
143
+ const diffBytes = Buffer.byteLength(diff, 'utf8');
144
+ // 超大 diff 照样写全(写文件没有上下文压力),只在清单末尾教队友怎么读。
145
+ if (diffBytes > HUGE_DIFF_BYTES) {
146
+ stat = `${stat.trimEnd()}\n\ndiff 很大(${(diffBytes / 1024 / 1024).toFixed(1)} MB),用 read 的 offset/limit 分批读,别一次全读。`;
147
+ }
148
+ const diffPath = await writeReviewDiff(sessionId ?? cwd, diff);
149
+ return {
150
+ target,
151
+ label,
152
+ diffPath,
153
+ diffBytes,
154
+ stat,
155
+ untracked,
156
+ ...(base === undefined ? {} : { base }),
157
+ };
158
+ }
159
+ /** 本地分支清单(「对比基准分支」的候选项);不是 git 仓库或没有分支时给空数组。 */
160
+ export async function listReviewBranches(cwd) {
161
+ try {
162
+ const text = await gitExec(cwd, ['for-each-ref', '--format=%(refname:short)', 'refs/heads']);
163
+ return text.split('\n').map((line) => line.trim()).filter((line) => line !== '');
164
+ }
165
+ catch {
166
+ return [];
167
+ }
168
+ }
169
+ /** 最近 100 条提交(「审查某次提交」的候选项);取不到给空数组,用户仍可手填 SHA。 */
170
+ export async function listReviewCommits(cwd) {
171
+ try {
172
+ const text = await gitExec(cwd, ['log', '-n', '100', '--format=%H%x09%s']);
173
+ return text
174
+ .split('\n')
175
+ .filter((line) => line !== '')
176
+ .map((line) => {
177
+ const at = line.indexOf('\t');
178
+ return at < 0
179
+ ? { sha: line, subject: '' }
180
+ : { sha: line.slice(0, at), subject: line.slice(at + 1) };
181
+ });
182
+ }
183
+ catch {
184
+ return [];
185
+ }
55
186
  }
56
187
  /**
57
- * /review 的审查消息组装(T18:主会话回落轮与审查队友的任务描述共用这一份)。
58
- * 独立成纯函数便于脱离命令体系直测;挪进本模块是因为「收集」与「组装」同域,
59
- * 而 commands.js 的顶层不许出现 node 内置模块 import。
188
+ * 给审查队友的任务书(/review 的唯一组装点:派队友走它,回落主会话轮也走它)。
189
+ *
190
+ * 为什么要把「diff 已落盘」写进任务书:队友只有读类工具,不知道文件在哪就只能
191
+ * 在上下文里找,而完整 diff 可能几十 MB——先告诉它路径与读法,它才可能读全。
192
+ *
193
+ * @param scope - 取数结果
194
+ * @param focus - 用户写在 /review 后面的关注点(空串 = 不限)
60
195
  */
61
- export function reviewMessage(collected, focus) {
196
+ export function reviewTaskText(scope, focus) {
62
197
  const lines = [
63
- '请审查当前工作区的未提交改动。逐个文件过 diff:正确性问题、边界条件、安全问题、'
64
- + '与项目既有约定(如 AGENTS.md)冲突的地方;给出具体文件与行级的意见。没有问题就明说没有。',
198
+ '你是一次代码审查的审查员:只读代码,不改任何文件。',
199
+ '',
200
+ '## 本次审查范围',
201
+ scope.label,
65
202
  ];
66
- if (focus !== '')
67
- lines.push(`关注点:${focus}`);
68
- if (collected.diff !== '') {
69
- lines.push('', '## 未提交改动(git diff HEAD --no-textconv --no-ext-diff)', '', collected.diff);
203
+ if (scope.target.kind === 'custom') {
204
+ lines.push('', '## 自定义审查要求', scope.target.instructions);
70
205
  }
71
- else {
72
- lines.push('', '## 未提交改动', '', '(没有已跟踪文件的改动,只有未跟踪的新文件)');
206
+ lines.push('', '## 完整 diff 已落盘', scope.diffPath, `用 read 分批读(offset / limit),别只看开头:这份 diff 共 ${String(scope.diffBytes)} 字节。`);
207
+ if (scope.diffBytes === 0) {
208
+ lines.push('(这个范围里没有已跟踪文件的改动,只有下面列出的未跟踪新文件。)');
209
+ }
210
+ if (scope.stat.trim() !== '') {
211
+ lines.push('', '## 改动清单', scope.stat.trimEnd());
212
+ }
213
+ if (scope.untracked.length > 0) {
214
+ lines.push('', '## 未跟踪文件(diff 里没有,逐个 read 再评)', ...scope.untracked.map((file) => `- ${file}`));
215
+ }
216
+ if (focus !== '') {
217
+ lines.push('', '## 关注点', focus);
218
+ }
219
+ lines.push('', '## 输出要求', '按 P0–P3 分级:P0 = 必须修(必然出错、安全漏洞、数据丢失);'
220
+ + 'P1 = 正确性或安全问题;P2 = 边界、健壮性、性能问题;P3 = 可读性、风格、更好的写法。', '每条按这个格式写(渲染层按它解析成卡片,字段一个都不能少):', '', '### [P0] 一句话标题', '位置:相对路径:行号', '说明:问题是什么、证据是什么', '建议:怎么改', '', '最后单起一段给整体结论,只能二选一:`整体结论:可提交` 或 `整体结论:需修改后提交`。', '没有发现问题就明说没有,并交代你查过的文件与维度。');
221
+ return lines.join('\n');
222
+ }
223
+ // ── /review 的会话账本(状态回看 / 取消)────────────────────────────────────
224
+ /** 取消之后记进记录文件的那句话(/review-status 会原样回看)。 */
225
+ export const REVIEW_CANCELED_TEXT = '审查被取消。';
226
+ /**
227
+ * /review 的会话账本:内存里记「这个会话有没有在跑的审查」,磁盘上留「最近一次长什么样」。
228
+ *
229
+ * 为什么放在这里:命令侧(派审查前写 running)、审查通道(收工写 findings、取消时改状态)
230
+ * 与自检探针要共用同一份读写口径。各自拼路径、各自猜字段,重启后就对不上了。
231
+ * 记录文件 `<数据目录>/code-review/<会话 id>.json`,一个会话一份,后一次覆盖前一次。
232
+ */
233
+ export class ReviewJournal {
234
+ runs = new Map();
235
+ views = new Map();
236
+ home;
237
+ /** @param home - 数据目录(`ctx.settings.about().home`,与 DSC_HOME 同一个) */
238
+ constructor(home) {
239
+ this.home = home;
240
+ }
241
+ /** 这个会话的记录文件路径(会话 id 先洗一遍,别让奇怪的 id 拼出目录穿越)。 */
242
+ recordPath(sessionId) {
243
+ const safe = sessionId.replace(/[^A-Za-z0-9_-]/g, '_');
244
+ return join(this.home, 'code-review', `${safe}.json`);
245
+ }
246
+ /** 读记录文件;没有、读不动、字段对不上都算「没有记录」。 */
247
+ read(sessionId) {
248
+ try {
249
+ const parsed = JSON.parse(readFileSync(this.recordPath(sessionId), 'utf8'));
250
+ if (typeof parsed !== 'object' || parsed === null)
251
+ return null;
252
+ const record = parsed;
253
+ if (record['version'] !== 1)
254
+ return null;
255
+ const state = record['state'];
256
+ if (state !== 'running' && state !== 'finished')
257
+ return null;
258
+ if (typeof record['startedAt'] !== 'number' || typeof record['target'] !== 'string')
259
+ return null;
260
+ const findings = record['findings'];
261
+ return {
262
+ state,
263
+ startedAt: record['startedAt'],
264
+ target: record['target'],
265
+ ...(typeof findings === 'string' ? { findings } : {}),
266
+ };
267
+ }
268
+ catch {
269
+ return null;
270
+ }
271
+ }
272
+ /** 写记录文件(写不下去只让 /review-status 回看少一份,不影响审查本身)。 */
273
+ write(sessionId, view) {
274
+ this.views.set(sessionId, view);
275
+ try {
276
+ const path = this.recordPath(sessionId);
277
+ mkdirSync(dirname(path), { recursive: true });
278
+ writeFileSync(path, `${JSON.stringify({ version: 1, ...view }, null, 2)}\n`, 'utf8');
279
+ }
280
+ catch {
281
+ // 记录落盘失败不该让审查失败:内存里那份还在,本进程内的 /review-status 照常能看
282
+ }
283
+ }
284
+ /** 最近一次审查的状态;没有记录返回 null。 */
285
+ status(sessionId) {
286
+ return this.views.get(sessionId) ?? this.read(sessionId);
287
+ }
288
+ /** 这个会话正在跑的那次审查;没有返回 undefined(取消要按它拿队友名)。 */
289
+ running(sessionId) {
290
+ return this.runs.get(sessionId);
73
291
  }
74
- if (collected.untracked.length > 0) {
75
- lines.push('', '## 未跟踪文件(diff 里没有,逐个 read 后再评)', ...collected.untracked.map((file) => `- ${file}`));
292
+ /** 派出去之后登记「在跑」并落一份 running 记录。 */
293
+ begin(sessionId, input) {
294
+ const startedAt = input.startedAt ?? Date.now();
295
+ this.runs.set(sessionId, { startedAt, target: input.target, handle: input.handle, cancelled: false });
296
+ this.write(sessionId, { state: 'running', startedAt, target: input.target });
297
+ }
298
+ /**
299
+ * 标记取消:记录立刻变成 finished +「审查被取消」,但**保留** runs 里那条,
300
+ * 好让随后的收工回调还知道这次审查的起始时间与范围(它会把同一句话再写一遍)。
301
+ * @returns 没有在跑的审查时 false
302
+ */
303
+ cancel(sessionId) {
304
+ const run = this.runs.get(sessionId);
305
+ if (run === undefined)
306
+ return false;
307
+ run.cancelled = true;
308
+ this.write(sessionId, {
309
+ state: 'finished',
310
+ startedAt: run.startedAt,
311
+ target: run.target,
312
+ findings: REVIEW_CANCELED_TEXT,
313
+ });
314
+ return true;
315
+ }
316
+ /** 这次审查是不是被用户取消的(收工时用来决定写哪句话)。 */
317
+ wasCancelled(sessionId) {
318
+ return this.runs.get(sessionId)?.cancelled === true;
319
+ }
320
+ /**
321
+ * 收工:把 findings 写进记录并清掉「在跑」那一笔。
322
+ * @param handle - 收工的是哪个队友;同一会话里前一次没收工又派了新的时,
323
+ * 旧那次收工不能把新那次的状态改成 finished(传了就按它比对,不传一律照写)
324
+ */
325
+ finish(sessionId, findings, handle) {
326
+ const run = this.runs.get(sessionId);
327
+ if (handle !== undefined && run !== undefined && run.handle !== handle)
328
+ return;
329
+ this.runs.delete(sessionId);
330
+ this.write(sessionId, {
331
+ state: 'finished',
332
+ startedAt: run?.startedAt ?? Date.now(),
333
+ target: run?.target ?? '(范围未知)',
334
+ findings: run?.cancelled === true ? REVIEW_CANCELED_TEXT : findings,
335
+ });
336
+ }
337
+ }
338
+ /** `/review-status` 上屏的那段文本(命令与探针共用一份,不许各写一套)。 */
339
+ export function reviewStatusText(view) {
340
+ if (view === null)
341
+ return '还没有审查记录。';
342
+ const when = new Date(view.startedAt).toLocaleString('zh-CN', { hour12: false });
343
+ const lines = [
344
+ view.state === 'running' ? `审查进行中(开始于 ${when})` : `审查已完成(开始于 ${when})`,
345
+ `范围:${view.target}`,
346
+ ];
347
+ if (view.state === 'running')
348
+ lines.push('用 /review-cancel 可以取消这次审查。');
349
+ if (view.findings !== undefined && view.findings.trim() !== '') {
350
+ lines.push('', '结论:', view.findings.trimEnd());
76
351
  }
77
352
  return lines.join('\n');
78
353
  }
@@ -19,7 +19,7 @@ export type InvokableMethod = Exclude<keyof DscRuntime, LocalOnlyMethod>;
19
19
  * 这份清单就是协议的全部可调用面:写成 `satisfies` 是为了让编译器逐条核对方法名,
20
20
  * 拼错一个字母当场报错,而不是等到运行时才「协议不允许调用」。
21
21
  */
22
- export declare const INVOKABLE_METHODS: readonly ["submit", "interrupt", "editQueued", "removeQueued", "steerQueued", "openSession", "newSessionIn", "compact", "setModel", "setEffort", "refreshSessions", "listModels", "listPlugins", "setPluginEnabled", "listTeammates", "stopTeammate", "messageTeammate", "removeTeammate", "stopBackground", "readBackground", "peekTranscript", "runCommand", "listUiCommands", "runUiCommand", "setPolicy", "setReviewer", "listPermissionPresets", "usePermissionPreset", "setDefaultPermissionPreset", "dock", "answerApproval", "setMode", "listPresets", "readPreset", "usePreset", "savePreset", "removePreset", "setDefaultPreset", "listTools", "clearTodos", "goalAction", "answerQuestion", "answerPlan", "archiveSessions", "listArchivedSessions", "usageStats", "sideAsk", "sideAskCancel", "restoreSessions", "purgeSessions", "renameSession", "setSessionPinned", "listUserMessages", "forkSession", "getUiPrefs", "setUiPrefs", "listSkills", "readSkill", "setSkillEnabled", "browseMarket", "installMarketSkill", "setMarketSources", "listUiTrust", "setUiTrust", "getSettingsSections", "getSectionValues", "setSettingValue", "runSettingAction", "getModelConfig", "saveProvider", "discoverModels", "testConnection", "removeProvider", "setProviderKey", "setDefaultModel", "setConfigFile"];
22
+ export declare const INVOKABLE_METHODS: readonly ["submit", "interrupt", "editQueued", "removeQueued", "steerQueued", "openSession", "newSessionIn", "compact", "setModel", "setEffort", "refreshSessions", "listModels", "listPlugins", "setPluginEnabled", "listTeammates", "stopTeammate", "messageTeammate", "removeTeammate", "stopBackground", "readBackground", "peekTranscript", "runCommand", "listUiCommands", "runUiCommand", "setPolicy", "setReviewer", "listPermissionPresets", "usePermissionPreset", "setDefaultPermissionPreset", "dock", "answerApproval", "setMode", "listPresets", "readPreset", "usePreset", "savePreset", "removePreset", "setDefaultPreset", "listTools", "clearTodos", "goalAction", "answerQuestion", "answerPlan", "archiveSessions", "listArchivedSessions", "usageStats", "sideAsk", "sideAskCancel", "restoreSessions", "purgeSessions", "renameSession", "setSessionPinned", "listUserMessages", "forkSession", "rewindSession", "getUiPrefs", "setUiPrefs", "listSkills", "readSkill", "setSkillEnabled", "browseMarket", "installMarketSkill", "setMarketSources", "listUiTrust", "setUiTrust", "getSettingsSections", "getSectionValues", "setSettingValue", "runSettingAction", "getModelConfig", "saveProvider", "discoverModels", "testConnection", "removeProvider", "setProviderKey", "setDefaultModel", "setConfigFile"];
23
23
  /** 把线上来的方法名收窄成「协议允许调用的方法」。 */
24
24
  export declare const isInvokableMethod: (method: string) => method is InvokableMethod;
25
25
  export {};
@@ -68,6 +68,7 @@ export const INVOKABLE_METHODS = [
68
68
  'setSessionPinned',
69
69
  'listUserMessages',
70
70
  'forkSession',
71
+ 'rewindSession',
71
72
  'getUiPrefs',
72
73
  'setUiPrefs',
73
74
  // 技能中心
package/lib/core/llm.d.ts CHANGED
@@ -52,6 +52,15 @@ export interface ChatMessage {
52
52
  * (见 `core/attachments.ts` 的 `fileHandleText`)。
53
53
  */
54
54
  files?: UserFileAttachment[];
55
+ /**
56
+ * 这条 user 消息是谁发起的:人打的字(缺省)还是机器投递的唤醒(`'notice'`:
57
+ * 后台作业完成、定时补投、目标续跑、记忆复盘……)。
58
+ *
59
+ * 与 `ts` / `files` 同一条纪律:只在内存与 jsonl 里活着,协议里没有这一项,
60
+ * {@link serializeMessages} 发请求前会剥掉。它存在的唯一理由是**重放也要认得出机器消息**——
61
+ * 界面据此把这类消息画成一行内部触发行,而不是一个可编辑的用户气泡(见 adapter/transcript)。
62
+ */
63
+ origin?: 'user' | 'notice';
55
64
  }
56
65
  /**
57
66
  * 一次模型请求的路由:端点连接信息 + 协议字段。
package/lib/core/llm.js CHANGED
@@ -435,6 +435,7 @@ export function serializeMessages(messages) {
435
435
  const wire = { ...message };
436
436
  delete wire.ts;
437
437
  delete wire.files;
438
+ delete wire.origin;
438
439
  if (wire.role !== 'assistant')
439
440
  return wire;
440
441
  return {
package/lib/core/loop.js CHANGED
@@ -120,12 +120,15 @@ export class MiniAgent {
120
120
  this.deps.emit({ type: 'inbox' });
121
121
  return;
122
122
  }
123
- this.session.appendUser(text, images, files);
123
+ this.session.appendUser(text, images, files, origin);
124
124
  this.deps.emit({
125
125
  type: 'user',
126
126
  text,
127
127
  ...(images !== undefined && images.length > 0 ? { images } : {}),
128
128
  ...(files !== undefined && files.length > 0 ? { files } : {}),
129
+ // 机器投递的要带上来源:界面据此画内部触发行,而不是一个能编辑的用户气泡。
130
+ // 日志里同一条记录也写了 origin,重放时走同一条判据(见 adapter/transcript)。
131
+ ...(origin === 'notice' ? { origin } : {}),
129
132
  });
130
133
  this.enqueueTurn();
131
134
  }
@@ -222,13 +225,16 @@ export class MiniAgent {
222
225
  if (items.length === 0)
223
226
  return;
224
227
  for (const item of items) {
225
- this.session.appendUser(item.text, item.images, item.files);
228
+ this.session.appendUser(item.text, item.images, item.files, item.origin);
226
229
  this.deps.emit({
227
230
  type: 'user',
228
231
  text: item.text,
229
232
  ...(item.images !== undefined && item.images.length > 0 ? { images: item.images } : {}),
230
233
  ...(item.files !== undefined && item.files.length > 0 ? { files: item.files } : {}),
231
234
  ...(midTurn ? { steering: true } : {}),
235
+ // 来源跟着出账(出账前它只用来分「队列条 / 通知条」两种排队画法):机器投递的
236
+ // 那几条出账后仍是内部触发行,不会变成用户气泡(2026-11-02 报障)。
237
+ ...(item.origin === 'notice' ? { origin: item.origin } : {}),
232
238
  });
233
239
  }
234
240
  if (!midTurn)