Skip to content

A local-first multi-agent app development platform, built on PenguinHarness

docs: 记第三十九轮(5.18 一次性日程项派发失败后重试,#852 移植)

lmlihengc461f86dfb5b
diff --git a/docs/FORK-PROGRESS.md b/docs/FORK-PROGRESS.md
index 20971750..d97afdc1 100644
--- a/docs/FORK-PROGRESS.md
+++ b/docs/FORK-PROGRESS.md
@@ -251,10 +251,10 @@
(2026-10-11 第三十六轮拉到时);它比 `60f34c47` 多出三笔,**三笔如今都已落地**:`#1002`(第三十五轮
落进 5.14)、`#1003`(`penguin chat` 用 OSC 133 标记提示符,第三十七轮落进 5.16)与 `#1001`
(Task 跑着时的粘贴不再被丢掉,第三十六轮落进 5.15)。`c65d407a` 自己带来的那五笔里,`#853`(一个会话
-排队的 follow-up 上限 16)**第三十八轮落进 5.17**;`#1027`(公司模式:在职员工不能删、被删员工不再开
-新对话、开发模式下员工分组)、`#852`(失败的一次性日历事件重试)、`#850`(org store 写入改原子)、
-`#851`(阻塞工单的 by 主键进图)**还没落地**——四笔都核过 `git apply -3 --check`,都能干净应用,只是
-`#1027` 是 32 文件 / +1680(三处冲突、界面与品牌面大),`#850` / `#851` / `#852` 三笔同居 org 运行时的
+排队的 follow-up 上限 16)**第三十八轮落进 5.17**、`#852`(失败的一次性日历事件重试)**第三十九轮落进
+5.18**;`#1027`(公司模式:在职员工不能删、被删员工不再开新对话、开发模式下员工分组)、`#850`(org store
+写入改原子)、`#851`(阻塞工单的 by 主键进图)**还没落地**——三笔都核过 `git apply -3 --check`,都能干净应用,只是
+`#1027` 是 32 文件 / +1680(三处冲突、界面与品牌面大),`#850` / `#851` 两笔同居 org 运行时的
同一份用例文件、宜一条一条来。更早的 `#1000`(Agent API 与 `@prismshadow/amsp` 客户端)与 `#956`
(五个内置 Benchmark)**尚未落地**,理由见 5.13 与下面各项。
@@ -474,6 +474,17 @@
changelog、`git apply -3` 干净、不需要新依赖、不碰桌面壳 / 包名 / 流水线」的(`#1027` 是 32 文件 /
+1680 且三处冲突、品牌与界面面大;`#850` / `#851` / `#852` 都改 org 运行时与同一份
`organization-runtime.test.ts`,量过但本轮只做一条)。
+- [x] **5.18 派发失败的一次性日程项在下一轮重新触发**(上游 `adfa2a19` `#852`,**2026-10-11 第三十九轮
+ 落地**,提交见该节):日程对账在派发**之前**就把时间槽消耗掉(那里的注释写着「无论接下来发生什么,
+ 都不再重试」),而工位通知队列只由那一次派发排空 —— 派发返回 skipped(开不出工位、或 Task 无法入队)
+ 时通知被放回队列,可一次性日程项那个被消耗的槽永远不会再来:员工的工单变化无限期留在队列里,
+ 错误面板上只有那一次派发失败。现在一次性日程项在 skipped 时把自己的槽退回(`markCalendarSlot`
+ 接受 `null`,这一列本来就允许),下一轮对账重新触发该事件、并带上重新入队的通知;重试是安全的
+ (运行从未开始,`markCalendarFired` 没到过),持续失败则每轮都以 `mark("error")` 显露,而不是把
+ 通知悄悄压住。周期日程项不需要退槽(下一槽照常触发);因员工被预算暂停而跳过的一次性日程项
+ 仍是有意的边界、不补发。**为什么是这一条**:`c65d407a` 上剩下那几笔里最小的一笔(2 个源文件 +
+ 1 份用例 + 一对 changelog)、`git apply -3` 三点全干净、不引入新依赖、不碰桌面壳 / 包名 / 流水线,
+ 而且第三十八轮写下的 changelog 里正好点名「本仓尚未移植 #852」,落完这条差别就没了。
- **不学**:阿里云 OSS 分发(`feat/aliyun-oss-release-distribution`)、模型库「官方推荐」与 TokenDance
推荐分组(`FORK.md` 已写明不搬)、`web-mod-1…12` 那类大模块化重构(与我们改过的 77 个文件重叠,
现在合进来是净亏)。
@@ -1043,6 +1054,7 @@ v0.2.2」——它只加台账里 v0.2.2 那一节与两行表格,**跟本轮
| 2026-10-11 | 5.16 | **`penguin chat` 用 OSC 133 标记提示符**(上游 `c95ef950` `#1003` 移植,照改动落、不是合分支;6 文件 / +200,含 changelog 一对):终端里 `> ` 提示符前写 `A`、其后输入起点写 `B`,提交的 Prompt 开始一轮写 `C`、结束写 `D;0`(抛错路径写 `D;1`);续行提示符 / 审批询问 / 退出确认不标记,`/thinking`、`/verbose` 这类本地应答的命令不包围;只有 stdin 与 stdout 都是终端且 `TERM` 不是 `dumb` 时才写。**为什么是这一条**:第三十六轮末尾写明它是「下一轮的第一顺位」 | 六包 `typecheck` **`EXIT=0`** · `oxlint` 0 警告 0 错误(2140 文件)· `prettier --check .` 干净 · 逐包 test 全绿:cli **539**(37 文件,+5 正是本笔新用例)· core **1395**/6 跳过(68)· server **195 文件 / 2814 通过 / 4 跳过** · web **3096**/2 跳过(252)· ui **1021**(128)· docs **62**(8,本轮改了它的 cli 两版)· hmr 无测试文件 · **反证**:把 `chat.ts` 换回 `HEAD` 那一版只跑新用例 → **2 失败 / 3 通过**(3 条「不标记」用例本就该通过),换回本笔 → **5 全过** · **真 pty 真跑**:`script` 给的真终端上 `penguin chat --server http://localhost:4291`(一次性数据根 `/root/adelie-fork-data/r37-marks`,模型顶仓库自带 `e2e/mock-llm.mjs` 于 4292),原始输出里的标记序列是 **`A B C D;0 A B`**:`A`→`B` 之间正是 `> ` 提示符、`C` 在第一个 chunk 之前、`D;0` 在 `[stats]` 之后、第二次 `A B` 是下一个提示符、`/exit` 不被包围 · **反证(真终端)**:同一条命令把 stdout 接 `| cat` → 标记 **0 个**,而整轮回复照样跑完(`chunk-40` 在) | `3713a9aa` |
| 2026-10-11 | 5.17 | **一个会话排队的 follow-up 上限 16**(上游 `092a595c` `#853` 移植,照改动落、不是合分支;4 文件 / +81 −1,含 changelog 一对):`SessionManager` 新增导出的 `FOLLOW_UP_QUEUE_LIMIT = 16`,`startTask` 的 `queueIfBusy` 分支入队前先判满 —— 满了就抛 `HttpError(429, "queue_full", …)`,不再无上限 `entry.followUps.push`;不带 `queueIfBusy` 的 `409 task_in_progress`、排出一条空出一个位置都不变。上游只带 manager 级用例(队列填满 16 每条都 `queued: true`、第 17 条 429 `queue_full` 且计数不变、排出一条后可再入一条),本仓额外**在真 HTTP 层核过一次**(一次性用例,未入库)。changelog 按本仓惯例改名到本轮日期、去上游 PR 行、写明移植出处,并写明与上游的一处差别:本仓未移植 `#852`,派发被拒的一次性日程项仍会消耗它的时间槽。**为什么是这一条**:`c65d407a` 上那五笔里唯一「两个源文件 + 一对 changelog、`git apply -3` 干净、不要新依赖、不碰桌面壳 / 包名 / 流水线」的一笔 | 六包 `typecheck` **`EXIT=0`**(六个 `Done`;`gen:ifaces` 报 **`src/ifaces.json unchanged`(189 接口 / 580 类型)**,本笔不动服务契约)· `oxlint` **0 警告 0 错误**(2140 文件)· `prettier --check .` 干净 · `git diff --check` 干净 · 逐包 test **全绿、0 失败**:core **1395**/6 跳过(68 文件)· ui **1021**(128)· cli **539**(37 文件)· web **3096**/2 跳过(252 文件)· server **195 文件 / 2815 通过 / 4 跳过**(+1 正是本笔新用例)· hmr 无测试文件 · **反证**:把 `session-manager.ts` 换回 `HEAD` 那一版、只跑新用例 → **1 失败**(`FOLLOW_UP_QUEUE_LIMIT` 不存在,循环一次不跑、计数 0),换回本笔 → **48 全过** · **真 HTTP 层核过**(一次性用例 `zz-tmp-queue-cap-wire.test.ts`,跑完即删、未入库):借 `createTestApp` + `apiClient` 起真 App,会话停在一次审批上保持 running,`POST …/tasks` 连发 16 条都是 `202 queued:true`、第 17 条 **`429`** 且响应体是 `{"error":{"code":"queue_full","message":"Session … already has 16 queued follow-ups (cap 16); wait for the session to drain."}}`(计数仍是 16)· 本笔不碰界面,未起浏览器、未起服务;3003 / 3004 / 4000 / 7364 / 7369 一个没碰 | `bdc1633d` |
+| 2026-10-11 | 5.18 | **派发失败的一次性日程项在下一轮重新触发**(上游 `adfa2a19` `#852` 移植,照改动落、不是合分支;5 文件 / +104 −2,含 changelog 一对与对第三十八轮那篇 changelog 结尾一句的更正):`markCalendarSlot` 的 `slotMs` 放宽成 `number \| null`(那一列本来就允许空),`reconcileCalendar` 在派发返回 skipped 那一支、把通知放回队列并 `mark("error")` 之后,**若 `def.periodMs === undefined`(一次性日程项)就把 `state.lastSlotMs` 退回** —— 下一轮对账重新触发该事件并把重新入队的工位通知一并带走;周期日程项不退槽(下一槽照常触发),因员工被预算暂停而跳过的一次性日程项仍按原规则消耗、不补发。上游那条用例照落(真 SQLite 的 `OrgCacheRepo` + 真 `OrgStore` 文件 + 假 runner:一次性事件打进会抛的 runner → 通知仍在队列、结果是 `error`,下一轮成功触发并带上「For HR」通知,再下一轮不重复触发)。第三十八轮那篇 changelog 结尾原写着「本仓尚未移植 #852」,改为「截至那一笔尚未移植、现已落地」并指向本轮的 changelog。**为什么是这一条**:`c65d407a` 剩下那几笔里最小、`git apply -3` 三点全干净、不引入新依赖、不碰桌面壳 / 包名 / 流水线的一笔 | 六包 `typecheck` **`EXIT=0`**(六个 `Done`;`gen:ifaces` 报 **`src/ifaces.json unchanged`(189 接口 / 580 类型)**,本笔不动服务契约)· `oxlint` **0 警告 0 错误**(2140 文件)· `prettier --check .` 干净 · `git diff --check` 干净 · 逐包 test **`EXIT=0`、0 失败**:core **1395**/6 跳过(68 文件)· ui **1021**(128)· cli **539**(37 文件)· web **3096**/2 跳过(252)· server **195 文件 / 2816 通过 / 4 跳过**(+1 正是本笔新用例)· hmr 无测试文件 · **反证**:把 `reconcile.ts` 换回 `HEAD` 那一版、只跑新用例 → **1 失败**(`started` 是 0:槽没退回,下一轮什么都不会触发),换回本笔 → 该用例通过、`organization-runtime.test.ts` **90 条全绿** · 本笔不碰界面,未起服务、未开浏览器;3003 / 3004 / 4000 / 7364 / 7369 一个没碰 | `dcb7faef` |
> **2026-10-11 与另一条线的交汇(第三十七轮)**:定时任务触发时(07:00)`git status --short` **不干净**
> —— 另一条线(会话 `session-2026-10-05-20-32-50-2ee69aba`)正在做**用户点单**的「回复能复制成纯文本」
@@ -5748,3 +5760,88 @@ org 运行时并同居同一份 `organization-runtime.test.ts`,一条一条来
「已发送」再补发、发完就删掉自己),没有另开新任务。另外照第三十六轮末尾记下的那条替代通道,
**同时用飞书发了一条三五句话的简报到用户**(`message_id=om_x100b639ba73874a0dd81725dce7efab`),
所以这一轮的结果不是只躺在队列里。
+
+## 第三十九轮:派发失败的一次性日程项在下一轮重新触发(2026-10-11,条目 5.18)
+
+一次无人值守的自主推进,只做这一条。**没有切版本号、没发 npm、没发安装包、没发发布汇总**;
+`legacy/main`、`/root/Adelie` 工作区、`/root/penguin-harness`、`/root/AgentCode`、3003 / 3004 / 4000 /
+7364 / 7369 全程没碰;按本轮纪律**没有碰 `packages/desktop` 与 electron**。
+
+### 开工自检
+
+根工作区 `/root/adelie-fork`:`git status --short` **干净**,分支 `main`;`git fetch origin &&
+git merge --ff-only origin/main` → `Already up to date.`(头是 `878644cc`,即第三十八轮的台账收尾)。
+(轮次 prompt 里那串 `--filter @prismshadow/penguin-*` 仍已过时,本仓包名是 `@lmliheng/penguin-*`;
+台账路径仍是 `docs/FORK-PROGRESS.md`。)
+
+### 为什么是这一条
+
+表上最靠前的未勾选条目照旧是 **2.2c**,本轮再核一遍仍然没有可做的:非桌面壳、非发布面剩下的就是画廊
+mock 的演示路径与 `packages/docs` 的环境表,台账里写明了它们留到发布期(第十三轮的口径);**3.5** 要用户
+拍板取哪个桌面壳、且本轮不许碰 desktop,**3.6** 要模型 key(卡点),**4.1–4.3** 明令不动,**5.3** 的②③④
+要第二台机器,**5.6** 与 **5.10** 等用户拍板(促销搬进 Project 配置 / 接不接受 `mermaid` 这个新依赖)。
+
+第三十八轮末尾写明这一轮的**第一顺位是上游 `#852`**(它的 changelog 里正好点名本仓尚未移植这一笔)。
+`c65d407a` 剩下三笔都量过:`#852`(`adfa2a19`)与 `#850` / `#851` 一样改 org 运行时,但它是最小的一笔
+(2 个源文件 + 1 份用例 + 一对 changelog)、`git apply -3 --check` **三点全干净**、不引入新依赖、不碰
+桌面壳 / 包名 / 流水线;`#1027` 是 32 文件 / +1680(三处冲突、界面与品牌面大),留给有整块时间的一轮。
+
+### 改了什么(5 个文件 / +104 −2,含 changelog 一对)
+
+照上游 `adfa2a19` 的改动落,不是合分支:
+
+- **`packages/server/src/db/repos/organizations.ts`**:`markCalendarSlot` 的 `slotMs` 从 `number` 放宽成
+ `number | null`(那一列本来就允许空,退槽就是把它写回空)。
+- **`packages/server/src/runtime/organization/reconcile.ts`**:派发返回 skipped 那一支,在把通知放回队列
+ 并 `mark("error")` 之后,**若 `def.periodMs === undefined`(一次性日程项)就把 `state.lastSlotMs` 退回**。
+ 上游那段注释照落(「一次性日程项不退槽的话,这次失败就是最后一句话」):这条派发是排空刚重新入队的那批
+ 工位通知的唯一途径,而被消耗的一次性槽不会再来;重试是安全的,因为运行从未开始 —— `markCalendarFired`
+ 还没到过 —— 而持续失败会每轮以 `mark("error")` 显露,不再把通知无声地压住。周期日程项**不需要**退槽。
+- **`packages/server/test/organization-runtime.test.ts`**:上游那条用例照落 —— 派发打进一个会抛的 runner,
+ 通知留在队列、结果是 `error`;下一轮触发成功并带上「For HR」这条通知;再下一轮**不重复触发**。
+- **changelog 一对**:按本仓惯例改名到本轮日期(`2026-10-11-calendar-one-shot-retry{,.zh}.md`)、去掉
+ 上游 PR 行、写明「移植自上游 PenguinHarness(#852,提交 `adfa2a19`)」。
+- **一处更正**:第三十八轮那篇 `2026-10-11-follow-up-queue-cap.md` 结尾原写着「本仓尚未移植 #852,所以
+ 一次性日程项仍会消耗它的时间槽」,现在这句不再成立,改成「截至那一笔尚未移植、现已落地」并指向本轮的
+ changelog(同一批未发布条目,读者把两篇放在一起看时不该自相矛盾)。
+- **本地化**:这一笔一处都不用改 —— 补丁只 import 相对路径,改动本身不碰包名。
+
+### 验证(都不是推测)
+
+- 六包 `typecheck` **`EXIT=0`**(六个 `Done`;`gen:ifaces` 报 **`src/ifaces.json unchanged`(189 接口 /
+ 580 类型)**,本笔不动服务契约)。
+- `npx oxlint` **0 警告 0 错误**(2140 文件)· `npx prettier --check .` 干净 · `git diff --check` 干净。
+- 逐包 test **`EXIT=0`、0 失败**:core **1395** / 6 跳过(68 文件)· ui **1021**(128 文件)·
+ cli **539**(37 文件)· web **3096** / 2 跳过(252 文件)· server **195 文件 / 2816 通过 / 4 跳过**
+ (**+1 正是本笔新增的那条**)· hmr 无测试文件。
+- **反证(新用例真的钉住行为)**:`git show HEAD:packages/server/src/runtime/organization/reconcile.ts`
+ 换回改动前那一版、只跑新用例 → **1 失败**(`started` 是 0:槽没退回,下一轮什么都不会触发);换回本笔 →
+ 该用例通过、`organization-runtime.test.ts` **90 条全绿**。
+- **这条用例本身就是真库取证**:它用真 SQLite(`openDatabase(":memory:")` + 真 `OrgCacheRepo`)与真
+ `OrgStore` 写出的日程文件,只有「起会话」是 double —— 所以退槽这一步确实走了 `org_calendar` 那张表,
+ 不是内存里的假象。
+- 本笔**不碰界面**,因此没起服务、没开浏览器;端口一个没动。
+
+### 没做 / 还差什么
+
+- **没有切版本号、没发 npm、没发安装包** —— 这一笔随下一版发出;是否现在发版等用户点头。
+- 上游 tip `c65d407a` 上还剩三笔**未落**(都量过、都能干净应用):`#1027`(公司模式,32 文件 / +1680、
+ 三处冲突)、`#850`(org store 写入改原子)、`#851`(阻塞工单的 by 主键进图)。**下一轮的建议**:按
+ 第三十八轮记下的顺序先落 `#850` —— `#850` / `#851` 同居 `organization-runtime.test.ts`,一条一条来。
+- **2.2c / 3.5 / 3.6 / 5.6 / 5.10 / 5.3** 照旧停在原地,原因同前几轮(其中 5.6 与 5.10 等用户拍板:
+ 促销要不要搬进 Project 自己的配置、接不接受 `mermaid` 作为新渲染依赖)。
+- `refs/adelie-tmp/*`:本轮没有动它(`upstream-main` 仍是 `c65d407a`)。
+- 中间物:会话 scratchpad 的 `r39/`(`typecheck.log`、`test-*.log`、`reconcile.patched.ts`、
+ `mail-round39.txt`)。都未入库。
+
+### 收尾:提交、推送与汇报
+
+- **代码提交 `dcb7faef`**(5 个文件,见「已完成的轮次」那一行);台账这一笔另起一笔。
+- **推送**:`git push origin main`。
+- **汇报邮件没发出去(第 22–38 轮同一处卡点,与凭据无关)**:`python3 scripts/mail.py check`
+ (csu-mail 技能目录下,`timeout 90`)**一行输出都没有就退出 124**;裸 socket 探 `smtp.csu.edu.cn:465` /
+ `imap.csu.edu.cn:993` / `mail.csu.edu.cn:443` 三个都是立刻失败/超时。凭据本身正常(`CSU_MAIL_ADDR` 21 字符 /
+ `CSU_MAIL_AUTHCODE` 16 字符,只打印长度)。按技能纪律**只试这一次、没有重试登录**。本轮的正文写在会话
+ scratchpad 的 `r39/mail-round39.txt`;把第 39 轮的正文路径与主题**加进**既有的周期重发任务
+ `csu-mail-retry`(现覆盖第 22–39 共十八封),没有另开新任务。另外照第三十六轮末尾记下的替代通道,
+ **同时用飞书发了一条三五句话的简报到用户**,所以这一轮的结果不是只躺在队列里。