Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions SECURITY.md

Large diffs are not rendered by default.

12 changes: 12 additions & 0 deletions dsh-mneme/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,18 @@

## [Unreleased]

- **日记静默失败现在会落盘:总账、触发侧失败、面板可见(#760)**。#758 复盘时发现一个比 bug 本身更麻烦的事:那 24 小时里日记一次没写,磁盘上**一个字节的痕迹都没有**——`runs.jsonl` 连一行 skip 都没有,报告人只能靠「今天怎么没日记」发现。根因是诊断面全挂在落点上:桶内账本的位置由「算出来的目录」决定,而最需要留痕的两种失败恰好是**目录算不出来**(`project-unknown` 项目标签缺失、`agent-invalid` 身份形状不合法)。`root` 为 null ⇒ `auditFile` 也是 null ⇒ `audit()` 直接 return。桌面端又没有控制台可看(`app.asar` 里读不到,`%APPDATA%` 下只有十月的 crash 日志),于是失败真正变成了静默。

现在多加一本**总账**,落点固定在日记根目录(`<memoryDir>/diaries/runs.jsonl`),与落点算不算得出来无关。写入口收在一处:`compose.js` 的 `recordRoot(record)` 负责补 `v`/`ts` 与换行,`diaryRootAuditPath()` 负责算路径,三层(compose 自身、触发侧、接口)都走它,不各拼一份格式。三类此前无声的失败各自补上:① 落点算不出来时记 `skipped` + `agent-invalid`/`project-unknown`,带上 agentId、projectRoot、chatId/sessionId——**这条分支以前连 skip 都不写**;② compose 抛出未捕获异常时记 `failed` + `compose-threw`,然后**原样把异常抛回去**(不能吞,调用方还要靠这次 reject 判失败);③ 触发侧的三种失败(`agent-resolve-failed`、`timer-scan-failed`、`timer-tick-failed`)走新增的 `composer.noteFailure()`——它们根本到不了 compose,以前只有一行 `log?.warn`。`auto.js` 里另三处(`runOne` 的 compose failed、`catchUp` 的 agent/project 两条)**故意保持只 warn**:compose 出口已经记了 `compose-threw`,同一次失败记两行会让「跑过几次」失去意义。

面板跟着能看到原因:`GET /diary` 的返回体多一个 `rootAudit`(按 `projectRoot` 精确过滤,不回退成「全库都给你看」;老 composer 没实现时退回空数组而不是 500),日记页 footer 现在画两本账——「最近运行」与「没写成的原因」,各取末 6 条。日期用本地时区拼,不能 `toISOString()`(UTC 会让北京时间早八点前显示成前一天)。控制台日志文案**保持旧措辞**:`record()` 的第四参 `logText` 让 kebab reason 只进磁盘,`log?.warn` 照旧打 "diary timer scan failed"——旧日志和既有测试都按那句话搜。

**只接项目页救不了 #758 现场**(这条是自查出来的设计漏洞)。项目日记页读 `GET /diary`,而 #758 出事的是 **agent 日记页**:`DiaryLibraryPanel` 读 `/diary/library`,根本不碰 `/diary`;更关键的是 `/diary` 第一件事就要 `project`,而 agent 桶的落点是 `agents/<agentId>/`、**没有 projectRoot**——照原方案,最需要看原因的那一页一行都拿不到。于是 `readRootAudit` 的问法扩成三种:给 `agentId` 按 agent 过滤、`agentOnly` 只取 `agentMode === true` 的行、都不给返回空(绝不退成「全库都给你看」);另开一条 `GET /diary/agent-audit`,**「不带 agent」是合法问法**(#758 现场 `diaries/agents/` 下只有 `sessions.json`、页面根本拿不到 agentId,这种「一次都没跑起来」正是要看的情况),给了 agent 就用 `isBucketName` 校验、路径语义的名字回 400 `agent-invalid`。面板侧选中 agent 桶时带 `?agent=`、选中项目桶时改问 `GET /diary?project=`、一本都没选中(或压根没有桶)时问 agent 域,读失败只置空不显示假的「一切正常」。**只问 agent 域同样不够**——那会让项目桶上摆一排人格的失败,比不显示更误导;两种桶问的是两个问题,就得分两路问。另修一处会漏记的:`agent-resolve-failed` 发生在「还不知道身份」的时候,原先不带 `projectRoot`,于是 `readRootAudit({ projectRoot })` 永远过滤不到它、项目页看不到真正让今天没写的那一下。现在先从会话的 `header.cwd` 取(读失败也只是不记这一字段,不许因诊断自己抛错而丢整条记录),取不到就不写这个键——宁缺,不把失败记到别人项目头上。

**第二轮评审又四条,全部核实属实。**① 聚合视图不分人:一本桶都没有时页面问的是「agent 域全部」,`alice` 和 `bob` 同一天都没写成,页脚只有两行一模一样的「身份解析失败」,用户分不清哪条是谁的——`diaryAuditLine` 加 `showAgent`,只在聚合视图把 `agentId` 写进行内,单本视图保持紧凑。② 切桶会串账:从 A 桶切到 B 桶时旧的 `rootAudit` 还躺在 state 里,`dead` 只挡迟到的响应、管不了已经存下来的那批,于是 B 的响应回来之前页脚把 A 的失败当成 B 的摆出来——改成把结果**与它对应的问法一起存**(`{key, rows}`),只画 key 与当前问法一致的那批,不一致就短暂空着。③ **写入失败后不刷新**:服务端刚记下 `compose-threw`,客户端却在非 2xx 分支 `return` 掉了、`tick` 不动,于是「为什么没写成」要等用户手动重读才出现,等于白记——`runCompose` 与 `DiaryPane` 的失败分支(含网络异常)都补上刷新。④ 触发侧失败缺运行域:`agentResolver` 抛错那行没有 `agentMode`,`readRootAudit({ agentOnly: true })` 直接把它排除掉,而那正是「连桶都没有时最该看到的原因」;`timer-scan-failed`/`timer-tick-failed` 同样按这一轮实际扫的是不是 agent 名单补上(项目模式的记录仍不带这个字段,两边不串)。

**测试** 3,723 → **3,736**:先前所有日记用例只验「写成功」与「桶内账本写了 skip」,没有一条验「落点算不出来时磁盘有东西」——这正是 #758 能潜伏 24 小时的原因。新增 6 条锁总账(项目根为空 / agentId 不合法 / 正常写入不重复记 / compose 抛出时记完再抛 / 触发侧失败也进总账 / 没有 noteFailure 时退回只 warn),2 条锁项目维度(身份解析失败带上 `projectRoot`;没有 cwd 时**不硬填假路径**,宁缺也别记到别人项目头上),2 条锁本轮第 ④ 条(解析失败与 agent 名单扫描各自标上 `agentMode`,且**从真实触发走到 `readRootAudit({ agentOnly: true })` 真的读得回**——桩 composer 只能证明「传了什么」,证明不了「按 agent 域问得到」,而 #758 现场坏的正是后者),1 条锁 `readRootAudit` 的项目过滤(读得回自己那行、不同项目互不串、什么都不问时返回空而不退成「全库都给你看」)。`test/api.test.js` +4 锁接口(`/diary` 两本账都按项目过滤且带 limit、老 composer 不 500、agent 页按 agentId 与按 agent 域各一次问对参数、路径语义的 agent 名一律 400 而老 composer 仍 200)。变异自证五处各一次:删掉 `!root` 分支的 `recordRoot` → 前两条红;删掉 `compose-threw` 记录 → 第三条红;删掉 `composer.noteFailure(...)` 调用 → 触发侧那条红;抹掉解析失败的 `agentMode` → 项目那条与 agent 域读回那条一起红;抹掉定时扫描的 `agentMode` → agent 名单扫描那条红。跨层验证另跑一次:`src`/`lib` 五对文件 md5 逐对一致(`npm run sync` 在 `dsh-mneme/` 子目录里跑),`node --check` 过六个改动文件。新路由同时进 `SECURITY.md` 的开放读清单——`test/security-doc.test.js` 拿装配出来的真实路由双向比对,漏登记会直接红(这次就是它先响的)。

- **agent 日记桶第一天永远开不了张:名单来源、身份丢失、桶键三处(#758)**。现场是 `diaries/agents/` 下只有 `sessions.json`(3 条会话 → agent `standard`),一个 `<agentId>/` 桶都没有;此后 24 小时零写入,连 `runs.jsonl` 的 skip 记录都没有——素材经 SQL 复算完全够(11-17 58 条 / 11-18 71 条 / 11-19 44 条),模型一次没被叫。

三处各自独立,缺一条都还是哑的:① **名单来源错了**。`knownAgents()` 只扫「已经写过日记的桶」,而建桶发生在写入时,于是桶不存在 ⇒ 名单为空 ⇒ 定时巡检与启动补写都 `Promise.all([])` 直接 resolve,不建桶、不写账本、不留痕迹。权威来源改成 `agents/sessions.json` 的映射值(`settleAgent` 在 turn/end 时就写下了),并与已有桶取**并集**——手工建的桶、旧版遗留的桶即便不在映射里也该继续被巡检,收紧成「只看映射」会让那些书从此不再更新而界面上看不出来;空目录不进名单(建了一半的不该让巡检每天白跑)。② **身份在调度层就丢了**(这条不是「没建桶」,建桶治不了)。`scheduleAgent(agentId, …)` 把 `payload` 原样放进 `pending`,却没把 `agentId` 存进去,而 `runOne` 恰恰从 `payload.agentId` 取身份——一路 `undefined` 下去,`diaryAgentDir` 拿空 id 返回 null,`compose` 落 `agent-invalid`;更糟的是 root 为 null 时 `auditFile` 也是 null,连那条 skip 都写不出来。这就是「手工建好桶之后仍然毫无动静」的原因。③ **桶键两套口径**。清单给 agent 桶的键是 `agents/<agentId>`,而 `library/entry` 路由拿 `isBucketName` 直接校验——那把尺按「单层目录名」设计、显式禁 `/`,必然 400 `bucket-required`,面板永远卡在「正在读…」。桶键解析现在抽成 `resolveBucketDir` 一处:剥掉 `agents/` 前缀后同一把尺量剩下的那段,清单、单篇读取、路由白名单三层同一个判据,`agents/../x` 一类仍然照样 400。
Expand Down
45 changes: 43 additions & 2 deletions dsh-mneme/lib/api.js
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,9 @@ import {
// 桶键解析也走同一处:清单、单篇读取、路由白名单三层必须用同一道判据,否则会
// 出现「列得出来、点进去 400」——#758 就是这么坏的(`agents/<id>` 键过不了
// 按单层目录名设计的 isBucketName)。
listDiaryLibrary, readLibraryEntry, resolveBucketDir
listDiaryLibrary, readLibraryEntry, resolveBucketDir,
// agent 诊断口按 agentId 校验:agent 身份是单层目录名,与桶名同一把尺。
isBucketName
} from "./diary/index.js";
import { readCandidateDoc } from "./candidates.js";
// M.O. 自动沉淀:/nudge 是 pipeline-nudge.js 的第一个运行时消费者(此前它只有测试在用,
Expand Down Expand Up @@ -3760,8 +3762,12 @@ export function createApi(ctx, service, settings, commands, embedder, semantic =
try {
const dir = diaryDir({ memoryDir: config.memoryDir, projectRoot: project, configured: config.diaryDir });
// 账本一起带走:面板要回答「今天为什么没有日记」时必须读它,不能靠猜。
// #760:两本都要——桶内那本记「落点算出来之后的失败」,总账记「连落点都
// 没算出来的那些」(compose 在落点之前抛掉)。只读前者,用户看到的仍是
// 「今天没写」,而真正的原因一直躺在总账里没人看。
const audit = diary.readAudit({ projectRoot: project, limit: 20 });
sendJson(res, 200, { contract: "mneme.diary/v1", project, dir, diaries: listDiaries(dir), audit });
const rootAudit = typeof diary.readRootAudit === "function" ? diary.readRootAudit({ projectRoot: project, limit: 20 }) : [];
sendJson(res, 200, { contract: "mneme.diary/v1", project, dir, diaries: listDiaries(dir), audit, rootAudit });
} catch (error) {
sendJson(res, 500, { error: "diary-unreadable", detail: String((error && error.message) || error) });
}
Expand Down Expand Up @@ -3796,6 +3802,41 @@ export function createApi(ctx, service, settings, commands, embedder, semantic =
}
});

// #760:agent 日记页的诊断口。
//
// 为什么不能复用 `GET /diary`:那条路由第一件事就是 `diaryProject` 要 `project`,
// 而 agent 桶**没有 projectRoot**(agentMode 的落点是 `agents/<agentId>/`)。
// 于是 agent 页要么传一个假 project(读到的全是别人的账),要么根本读不到——
// 而 #758 出事的恰恰就是 agent 桶第一天开不了张。按 agentId 单独给一个口,
// 页面才可能在「一篇都没有」的时候说清「一次都没跑起来」还是「跑了但没写」。
register({
kind: "exact",
path: "/api/dsh-mneme/diary/agent-audit",
policy: "open",
handler(req, res) {
if (!diaryGate(req, res)) return;
const agentId = new URL(req.url, "http://localhost").searchParams.get("agent");
// 不给 agent 是**合法**的第三种问法:agent 桶一个都还没建起来时(#758 现场
// 就是 `diaries/agents/` 下只有 sessions.json),页面连一本书都列不出来,
// 也就拿不到 agentId。那时候要回答的正是「一次都没跑起来,为什么」。
if (agentId !== null && agentId !== "" && !isBucketName(agentId)) {
sendJson(res, 400, { error: "agent-invalid", detail: agentId });
return;
}
try {
const query = agentId === null || agentId === ""
? { agentOnly: true, limit: 20 }
: { agentId, limit: 20 };
const rootAudit = typeof diary.readRootAudit === "function"
? diary.readRootAudit(query)
: [];
sendJson(res, 200, { contract: "mneme.diary/v1", agent: agentId || null, rootAudit });
} catch (error) {
sendJson(res, 500, { error: "diary-unreadable", detail: String((error && error.message) || error) });
}
}
});

register({
kind: "exact",
path: "/api/dsh-mneme/diary/compose",
Expand Down
Loading