记录项目范围、架构、里程碑与验收证据。当前状态见 §02,历史步骤见 §04,能力证据见 §11;跨会话交接由本地 docs/PROGRESS.md 负责。
一句话定位:纯 MoonBit 的 iCalendar(RFC 5545)解析 / 重复事件展开库,附带最小 CalDAV(RFC 4791)服务端。计算限定为支持的规则与可靠固定时区,不承诺完整协议栈或任意来源的语义处理。
立项调研记录(2026-09-08;不是今日全生态排名或提交稿):
caldav / webdav / webcal / calendar-import 均返回 No modules found。| 包 | 内容 | 源码行数(含注释) | 测试 | 状态 |
|---|---|---|---|---|
| ical/text | 折行展开(§3.1)、内容行解析(引号参数)、文本反转义、带行号 ParseError | 364 | 26 测试声明 | 已落地 |
| ical/model | 组件树(BEGIN/END 嵌套、未知组件保留)、IcalDateTime(四态时间,Eq)、ZoneTable(显式固定绑定;内嵌 VTIMEZONE 须能证明固定,动态/无效/冲突引用拒绝)、Event 类型化视图(S1:parse_events / Component::events / Component::event,RRULE 原文、EXDATE、RDATE、RECURRENCE-ID) | 1260 | 74 测试声明 | 已落地 |
| demo | 可运行入口:内嵌真实形态 fixture(折叠/转义/TZID/RRULE/EXDATE/全天/改期覆盖),打印事件清单(moon run demo) | 107 | 0 测试声明 | S1 起步 |
| ical/fetch | 取件层:fetch_ics(url, timeout_seconds?=30)(@http.get 薄层 + 状态检查,非 200 抛 FetchError::BadStatus;上游无任何超时,本包以 with_timeout 兜底,到点抛 TimedOut——S20);demo 支持 URL 参数端到端 | 69 | 1 测试声明 | 已落地 |
| ical/rrule | 限定日历级 RRULE 展开(S2/S3/S8):四档 FREQ × INTERVAL/COUNT/UNTIL、序数 BYDAY、正负 BYMONTHDAY、BYMONTH、BYSETPOS、WKST;expand_series 合并 RDATE、EXDATE、RECURRENCE-ID 改期/取消/THISANDFUTURE;生成完整性独立记录,周期预算不足报错 | 1322 | 66 测试声明 | 已落地 |
| ical/serialize | 组件树 → .ics 文本(S4):CRLF、75-octets 折行(多字节不劈开)、参数值按需重引号;@text.escape_value 与 unescape 对称;roundtrip 组件树相等且幂等 | 181 | 12 测试声明 | 已落地 |
| ical/store | vdir 存储(S5/S10):每事件一个 .ics 文件,每个日历集合一个子目录;FNV-1a 内容寻址 ETag(同字节同 tag);名字白名单(字母数字._- 且非点开头)防路径逃逸;get 缺失返回 None;集合能力 = collections/create_collection/collection/remove_collection,list 只返回事件 | 347 | 5 测试声明 | 已落地 |
| ical/httpd | HTTP/1.1 请求层(S5):手解析请求行/头/Content-Length 体,方法是 token(WebDAV 方法天然可读);chunked 拒收(411);裸 socket 读写(ServerConnection 是帧化 reader 不适用);S6 在此之上加 WebDAV/CalDAV 语义 | 465 | 17 测试声明 | 请求层已落地 |
| ical/caldav | WebDAV/CalDAV 语义(S6/S10):发现链、PROPFIND Depth 0/1(集合与单资源)、calendar-multiget(集合与单资源)、HEAD、XML 安全转义(含 XML 1.0 禁用控制字符→U+FFFD)、If-Match/If-None-Match;calendar-query 真正求值 CALDAV:filter(嵌套 comp-filter / is-not-defined / time-range 受检求值 / prop-filter 的 text-match+param-filter / 两种 collation),filter 前置条件按 §7.8 回 403 valid-filter / supported-filter / supported-collation;最小 XML 形状解析器(xml.mbt);cmd/serve 接入 well-known、MKCALENDAR 集合与201/204/207/403/405/409/412 状态;资源求值失败为 500,不回部分报告;PUT 前置校验与求值同标准(RFC 4791 §5.3.2:读不了的内容 403 valid-calendar-data / valid-calendar-object-resource),存储内容永不毒化报告 | 1825 | 55 测试声明 | 已落地 |
合计:严格全目标测试为 wasm 310、wasm-gc 310、JavaScript 290、native 321(S72 纠偏波后);S5 24 项、S6 91 项、S7 31 项(原始 socket 分帧/条件/竞态,tools/s7_http_acceptance.py)真实活体验收全绿;独立 tools/s6_evaluation_acceptance.mbtx 求值驱动另计。包表统计当前非测试源码行数(含注释)与测试声明,不等同各目标运行数。0.4.0(2026-10-26)与 0.5.0(2026-10-31)已发布到 mooncakes;S36–S73 审计波已随 0.6.0(2026-11-20)发布到 mooncakes。Thunderbird 155.0.1(Windows)已完成发现、读取、创建、原位修改与删除的真实 CalDAV 联调;该历史会话未重新验证本轮语义,DAVx5/Apple 未跑。
请求自上而下流经六层,每层一个包、单向依赖;层与层之间只经公开接口(.mbti)通信:
respond 写裸连接ical/model: parse_calendar(String) -> Array[Component] raise
parse_events(String) -> Array[Event] raise
Component::events(Self, zones~ : ZoneTable) -> Array[Event] raise
Component::event(Self, zones~ : ZoneTable) -> Event? raise
ZoneTable::{empty, builtin_common, with_builtin, insert, lookup, rejection_reason}
Event.rdates : Array[IcalDateTime]
ical/rrule: expand_series(Array[Event], limit? : Int32) -> Array[Occurrence] raise
expand_series_query(Array[Event], limit? : Int32) -> SeriesQueryResult raise
SeriesQueryResult { occurrences, exhausted, generated_through,
has_overrides, budget_exceeded }
ical/caldav: Filter::matches(Self, String) -> Bool raise
ReportOutcome::{Report, UnsupportedReport, PreconditionFailed, EvaluationFailed}
来源:ical/model、ical/rrule、ical/caldav/pkg.generated.mbti 与对应源码。接口里的 limit? 对应源码带标签参数,须按名传。查询完整性接口位于 rrule 子包,不是根门面重导出。
下表保留各步骤当时的验收数字与行为。S29–S33 的“0.5.0 批次”是原计划标签,实际已随 0.4.0 于 2026-10-26 发布。S27 的空/有界预算与 master 兜底行为由 S34 更正,不把新契约改写成旧版行为。
节奏:每步一个最小目标 → 代码 + 测试 → 验收 → 一次提交。单步超过半天就拆。任何一步卡住,先砍范围再加班。
| # | 目标 | 规模 | 验收(过不了的验收不算完成) | 状态 |
|---|---|---|---|---|
| S0 | 清场:删模板/探针,README/moon.mod 就位,登记接缝 | 0 行 | moon check && moon test 全绿,工作区干净 | 完成 0ab8978 |
| S1 | 类型化事件层:Event 结构 + Component::events()(映射层,无新算法) | ~150 | demo 读本地 fixture .ics 打印事件清单 | 完成(S1) |
| S1.5 | 取件切片:ical/fetch(@http.get 薄层,非 200 抛 FetchError)+ demo 支持 URL 输入:URL → 事件清单 端到端。网络测试不进 CI(Google 源本网络不可达,演示用 calendarlabs) | ~130 | 给真实可达 .ics URL,打印解析后事件清单;CI 仍走本地 fixture | 完成(S1.5) |
| S2 | RRULE 解析(不展开):第一档子句 → Rule;不支持子句显式报错 | ~200 | graham 32 个用例的 rule 串全部按档位解析或报错 | 完成(S2) |
| S3 | 第一档展开:DAILY/WEEKLY/MONTHLY + INTERVAL/COUNT/UNTIL/BYDAY(无offset)/BYMONTHDAY(正) + DTSTART 回退特例 | ~400 | RFC 附录 A 第一档 ~20 用例对拍全绿(语料:graham/rrule 测试套件,见 THIRD-PARTY-NOTICES.md) | 完成(S3) |
| S4 | iCalendar 序列化写回:fold(75 octets)/escape/组件树→ics(库层写回;服务端 calendar-data 读取存储原文) | ~200 | parse → serialize → parse 往返不变 | 完成(S4) |
| S5 | HTTP/1.1 请求层 + vdir 存储:accept + 手解析请求行/头/Content-Length 体;OPTIONS/GET/PUT/DELETE | ~350 | curl 完成事件 PUT/GET/DELETE 往返,ETag 正确变化;chunked 请求回 411 | 完成(S5) |
| S6 | WebDAV/CalDAV 核心:PROPFIND(Depth 0/1)、REPORT(calendar-query/multiget)、MKCALENDAR、well-known 重定向、发现链、If-Match/If-None-Match | ~450 | curl 模拟 Thunderbird 发现链 + REPORT 序列全绿(录成集成测试) | 完成(S6) |
| S7 | 真实客户端联调:以 Thunderbird 完整 CRUD 为首版验收;DAVx5 / Apple 日历降为赛后互操作候选 | 0.5–1 天 | ≥1 个真实客户端完整走通;产出互操作矩阵(客户端 × 操作 × 结果) | 完成(Thunderbird 155.0.1 CRUD) |
| S8 | 库层深度:RECURRENCE-ID 覆盖合并(改期/取消/THISANDFUTURE)+ 第二档 BY*(BYSETPOS/WKST/序数 BYDAY/负 BYMONTHDAY)+ ZoneTable 接入展开链 | ~500–700 | 附录 A 全 32 用例按档位通过;RECURRENCE-ID 合并用例通过 | 完成(S8) |
| S9 | 发布打磨:CI(check/test --target all + fmt + info)、mooncakes 发布、申报书、根包 re-export 门面、互操作矩阵进 README | 0.5 天 | CI 绿、moon publish 成功、申报书一页 | 完成(0.1.0 已发布,scope frozen) |
| S36 | 工具链迁移 moonc v0.10.20:尾随 derive 前置 #derive(29 处)、.view()/切片糖 → to_string_view()/clamped_view()(44 处)、.mbti 重渲染(API 零变化);CI 不锁版本,下次 push 三闸将红 | ~0.25 天 | check/test --target all --deny-warn 0 告警、fmt --check、native 构建绿 | 完成(181b6c1) |
| S37 | 递归/变更语义四处修复(JEV 审计 R1-R7 纪律):YEARLY 序号 BYDAY 无 BYMONTH 时按年计数(含负序数,expand.mbt 守卫)、THISANDFUTURE 改时长后 RFC 5545 §3.8.4.4 时长继承(series.mbt)、无 UID VEVENT 单独判定不并组(filter.mbt §9.7.1)、DURATION=0 行起点边界包容(interval_overlaps);+6 差分测试 | ~0.25 天 | 四组差分测试钉死(dateutil 对拍/边界对)、全目标 270/253/270/280 绿、.mbti 零 diff | 完成 |
| R1 | 系列合并性能:一次索引同 UID overrides/EXDATE,按序游标应用 THISANDFUTURE | ~100 | 2000 occurrences + 500 无关 overrides 的 native release 基准由 20.27 ms 降至 1.64 ms;语义回归与全目标测试通过 | 完成(约 12.4×) |
| R2 | CalDAV REPORT 热路径:StringView 零拷贝扫描 + href 哈希选择 | ~100 | 500 hrefs × 500 resources 的 native release 基准由 68.17 ms 降至 3.87 ms;命名空间前缀回归与全目标测试通过 | 完成(约 17.6×) |
| R3 | 0.2 根门面收口:新增整文档 parse_calendar,顶层只暴露完整 parse / recurrence / serialize 工作流 | ~50 | pkg.generated.mbti 明确移除协议与文本层拼装 API;子包高级入口保留;门面往返测试通过 | 完成(0.2.0 已发布) |
| R4 | 通用 ICS 解析链 StringView 化:unfold、内容行、参数和 EXDATE 列表仅在所有权边界分配 | ~120 | 1000 VEVENT 的 native release 基准由 25.83 ms 降至 15.10 ms;既有 Unicode 折行与全目标回归通过 | 完成(约 1.71×) |
| R5 | RRULE 预归一化:排序 BYMONTH/BYMONTHDAY,并缓存 28–31 天月份的实际候选日 | ~80 | 密集月度规则 10000 occurrences 的 native release 基准由 5.83 ms 降至约 5.19 ms;闰年、负月日、原 Rule 不变的回归通过 | 完成(约 11%) |
| R8–R11 | 赛后优化审计落地:测试盲区补齐(15 项)、AI 生成痕迹清理(净 -105 行)、StringView 残余迁移(R4 边界之后的全部值解析)、respond 缓冲 + ZoneTable Map 索引;HttpRequest.meth 经实测确认为避让保留字 method,不改名 | ~-160 | 四目标 150/137/150/155 全绿;基准保持 R 系列基线(parse 15.6 ms、multiget 3.7 ms、series 1.68 ms、monthly 5.5 ms);.mbti 仅 ZoneTable.entries 一处预期变更 | 完成 |
| S10 | 验收缺陷修复:①calendar-query 真正求值 CALDAV:filter(RFC 4791 §9.7 全语法;time-range 走 expand_series 展开判重叠,§7.4/§9.9),filter 前置条件按 §7.8 回 403 valid-filter / supported-filter;②MKCALENDAR 在 /cal/<cal>/ 真正建集合(已存在回 405,§5.3.1),集合可 PROPFIND / REPORT / 读写 / 删除,默认集合路径 /cal/<name>.ics 保持不变 | ~1100 | S6 活体验收由 11 项扩到 23 项并全绿(含区间内/外选择、无 filter 回 403、未知组件回 403、MKCALENDAR 201/405/发现/写入/集合内 REPORT 隔离/非空 409/删空 204);全目标 170/157/170/176;S5 21/21 无回归 | 完成 |
| S11–S12 | 复审修复(库层):负 BYMONTHDAY 在 DAILY/WEEKLY 路径按候选月长度归一化判定(原先静默零匹配);展开步进全 Int64 化、越出 year 9999 视为序列终结(替代 x/time 未类型化 Failure 泄漏与回绕出的「有效但错误」日期);越界日期分量收敛为 BadLine(T240000 按 RFC 5545 拒绝);parse_utc_offset 严格化(+hh/+hhmm/+hhmmss 三形态、分钟秒 ≤59,+05:30 不再半读丢 30 分钟) | ~+270 | 差分测试钉死:DAILY 单负/混合符号/WEEKLY 月末星期、MONTHLY;INTERVAL=100 的 957/958 边界、巨 INTERVAL 巨回绕、四形态坏偏移、五形态坏日期 | 完成 |
| S13–S14 | 复审修复(服务层):集合 URL 无斜杠改 301 规范形式(RFC 4918 §5.2,替代 Windows 500 / POSIX 静默 rmdir);XML 嵌套深度上限 64(替代栈溢出进程死亡,复核实测 5 万层 0xC00000FD);text-match 与 multiget href 解码 XML 实体;请求头改自带缓冲的有界读取(64KB/行、100 头);非数字 Content-Length 回 400;limit≤0 回空;参数值边缘空白序列化加引号;路由剥 query string | ~+300 | S6 活体 +4(301 差分对);S5 +1(query 同字节差分);httpd 单测 10→15(头行/头数封顶、400/413 分流) | 完成 |
| S15 | 审计缺口收口:VALARM time-range 拒绝的单测补齐(§11 矩阵「有单测」声明成真);S6 活体 +6(Depth 0/不可解析 Depth 差分、multiget 未知 href 空结果、PUT /cal/ 405、DELETE 陈旧 If-Match 412);§11 矩阵补 ical/fetch 行(已声明、仅人工验证、网络测试不进 CI 为 S1.5 决策) | ~+70 | S6 当时报 31/31(实际 32,S18 勘误)、S5 22/22 全绿;全目标 185/170/185/192;README×2 与 §02 计数同步 | 完成 |
| S16 | 复审修复第二波(K1):WEEKLY 展开在 9999 年最后一周的天循环补上越界 catch——S12 只守住了「步进到周首」这一步,周内 base+i 越过 year 9999 仍泄漏 x/time 未类型化 Failure;越界日终结该周,与 DAILY/MONTHLY/YEARLY 的地平线语义一致 | ~+30 | 差分测试 ×2(DTSTART 9999-12-30 纯 WEEKLY 恰 1 实例不抛;BYDAY 全周走到 12-31 后自然终结);全目标 187/172/187/194 | 完成 |
| S17 | 复审修复第二波(K5b):413 拒绝分支补上与 411 相同的 drain——客户端还在上传超大 body 时,带未读数据关闭连接的 RST 会吞掉 413 响应(Windows 实测突发/并发两型 6/6 全丢,对照组 411 两型 2/2 可靠送达) | ~+40 | S5 活体 +1:原始 socket 声明 20MB 只发 256KB 的上传中途客户端必须收到 413(修复前该检查失败);S5 23/23、S6 31/31 复跑全绿 | 完成 |
| S18 | 复审修复第二波(K2):comp-filter 的每项测试作用于同一组件实例(RFC 4791 §9.7.1)——VEVENT 的 time-range 改按该组件自身 UID 的系列判重叠(master 与 override 同 UID,展开语义不变),不再用全资源事件判;此前另一事件的区间重叠可以「代通过」本事件的 time-range(双事件资源假阳性) | ~+45 | filter 差分测试(1 月区间 + SUMMARY=Beta 的双事件资源不选中,6 月区间选中 Beta);S6 活体 +2 同型差分对;S5 23/23、S6 34/34 全绿(S6 计数勘误:S15 实加 7 项到 32,文档一直记 31,本轮 +2 并按真实值纠正);全目标 188/173/188/195 | 完成 |
| S19 | 复审修复第二波(K5e,jev 裁决的决策落地):家目录裸形式 /cal 301 到规范 URL /cal/(RFC 4918 §5.2),与 S13 给嵌套集合立的规则统一——此前家目录单独双写法直接服务,且无任何决策记录(S5 以来的未审视继承行为);发现链发出的 href 全部带斜杠,存量客户端不受影响 | ~+25 | serve wbtest 断言更新(/cal 与 /cal?x 归 HomeBare);S6 活体 +2(裸形式 301+Location、带斜杠形式 200 差分对);S5 23/23、S6 36/36 全绿 | 完成 |
| S20 | 复审修复第二波(小项批 K3/K4/K5g):①ResourceView 携带 feed 时区表并贯穿 VTODO/VJOURNAL 区间与 prop-filter 的 time-range(此前只认内置表,feed 私有 TZID 假阴性);②parse_utc_offset 补小时 ≤23 上界(+9900 曾被静默接受为 99h);③fetch_ics 以 with_timeout 兜底超时(上游 async 客户端与 socket 层无任何超时,挂起服务器原先永久阻塞调用方),timeout_seconds?=30、到点抛 FetchError::TimedOut | ~+80 | K3 差分(feed 声明 TZID 的 VTODO 选中 / 撤销声明不选中);K4 差分(+9900 拒绝、+2359 仍合法);K5g 超时单测(本地「接受但永不响应」监听器 + 1s 界,断言恰为 TimedOut——纯本地、进 CI);S5 23/23、S6 36/36;全目标 189/174/189/197;fetch .mbti 预期两处 diff(新参数 + 新变体) | 完成 |
| S21 | 依赖升级(发布前窗口,排期经 jev 裁决):async 0.21.2→0.22.4、x 0.5.1→0.5.5(moon add --upgrade);K5g 的前提在新版 async 复核(HTTP 客户端与 socket 层仍无任何超时,§11 声明补注两版均核) | ~0(仅 moon.mod 与文档) | 升级后全门闸 + 活体复跑:check/test all deny-warn 189/174/189/197、fmt、info 零 diff(.mbti 不变)、S5 23/23、S6 36/36 | 完成 |
| S22 | 0.3.0 发布后的 P3 收口批(复审确认未修的四条,0.4.0 首个提交):①10 位合法大 Content-Length 从 400 归位 413(parse_int 改 Int64 饱和累加,不再按位数拒收);②escape_value 把 CR 归一为 \n 转义(TEXT 值不得携带 CR,裸 CR 会在 unfold 处劈行);③VdirStore::delete 拒绝目录(POSIX 上 fs.remove 即 rmdir,此前可静默删掉空集合回 204);④parse_components 嵌套深度上限 64(与 XML 侧 MAX_XML_DEPTH 同款防线,保护递归的序列化与 filter 遍历)。同提交把版本推进 0.4.0 | ~+60 | K5a 差分(10 位与 9 位超限 CL 都 413、非数字仍 400);K5c 断言 a\rb → a\nb 转义形态;K5d wbtest(delete 目录回 false、集合幸存);K5f 差分(60 层解析成功、100 层整棵拒绝带行号);全目标 192/176/192/201、S5 23/23、S6 36/36;.mbti 零变化 | 完成 |
| S23 | 0.4.0 克制批次第一项(C+D,REPORT 语义收口):①REPORT 判型改读 XML 根元素局部名(同款形状解析器),替代全文大写子串嗅探——text-match 针或 href 提及另一报表名不再误路由;②time-range start≥end 回 403 valid-filter——恒空区间静默匹配空会读作「区间内无事件」 | ~+60 | 差分:query 针含 CALENDAR-MULTIGET 仍按 query 路由并选中目标事件(旧嗅探会误路由成 multiget 空答);反转/相等区间 → 403+valid-filter(parse 层与 report 层各一钉);S6 活体 +2;全目标 195/179/195/204、S5 23/23、S6 38/38 | 完成 |
| S24 | 0.4.0 克制批次第二项(B,可观测性):一行式访问日志 METHOD path -> status + handler 错误落 stderr(此前 500 完全无痕)——刻意无级别无配置;输出走 @stdio 直写 fd(实测 core println 在 native 重定向下块缓冲、永不退出的服务器永远刷不出,此为本项实测发现) | ~+90 | 活体验证:200/404/301/500 各出一行且状态准确;嵌套集合内 PUT 到目录 → 500 + stderr 带具体 OSError;S5 23/23、S6 38/38 复跑无回归 | 完成 |
| S25 | 0.4.0 克制批次第三项(F,健壮性):unfold 折行拼接去平方——每逻辑行独立缓冲,折叠只追加本物理行文本;定性依据 = 服务器 10MB body 上限内单条巨折行会触发二次型放大(PUT 落盘后每次 calendar-query 的 filter 求值都要 unfold 一遍) | ~+35 | 新增常驻基准 bench unfold one folded line folds=10000(native release):修复前 1.68s/次 → 修复后 6.58ms(255×;stash 往返对照);既有 unfold 用例全绿;S5 23/23、S6 38/38 | 完成 |
| S26 | 0.4.0 克制批次第四项(E',语义收口):①find_master 按组自身 UID 取 master(异 UID 的 master 不再被错展开);②override 无 DTEND 继承 master 时长(改期的一小时会面不再变开放结尾);③multiget 缺失 href 回 per-href 404(RFC 4791 示例形态,静默丢弃使客户端无法区分「不存在」与「已删除」);④VALUE=DATE 配 datetime 值改为 BadLine(refuse-rather-than-guess,同 S12);README Boundaries +2(裸顶层 VEVENT / EXDATE 压同槽 override 文档化) | ~+90 | 四条各带差分(异 UID 组空序列 / override 端点 = 起点+master 时长 / 混合 multiget 200+404 并存 / 半读值拒绝 + 正常 DATE 保持);S6 活体 +1(mixed multiget);全目标 199/183/199/208、S5 23/23、S6 39/39 | 完成 |
| S27 | 0.4.0 克制批次第五项(G',strict_raise):展开周期 budget 触达且未到调用方 limit 且规则无界时抛既有 ExpandError::Invalid——稀疏无界序列(月末周规则 budget 内约 2300 实例)原先静默截断成「看起来完整」的前缀;当时的分辨点:永不匹配的规则返回空仍是完整答案(不报错),COUNT/UNTIL 有界与 limit 填满照旧诚实终结;caldav time-range 的 catch-all 照旧兜底(与旧行为等价) | ~+45 | 四向差分:WEEKLY;BYMONTHDAY=-1 limit=5000 → err(真截断场景实证)/ COUNT=7 → ok:7 / limit=50 → ok:50 / BYMONTH=2;BYMONTHDAY=30 → ok:0(空不报错);全目标 200/184/200/209、S5 23/23、S6 39/39;.mbti 零变化 | 完成 |
| R13 | 第三轮复审(S16–S27 增量,自审):抓到并修复 F1——S22 的 parse_int 饱和预检差一个等号,19 位 9223372036854775809 在 Int64::MAX/10 边界乘加回绕成负 length,被当作「无大小问题」吞掉连接缓冲当 body(复现测试先红后绿;修法 = 乘加后检测回绕即饱和);F2 记录不修——handle_connection 500 臂在死连接上 respond 理论可抛逃逸,核实上游 run_forever 的 allow_failure 默认 true(handler 失败只终止该连接任务、defer conn.close() 清理),不致命且失败路径的失败丢弃可接受;其余增量(find_master 空 UID 组、missing_href 去重、unfold 空输入边界、S27 与 caldav 兜底交互)逐项核对无新发现 | ~+25 | F1 差分测试(19 位 CL → 413);全目标 201/184/201/210、S5 23/23、S6 39/39 | 完成 |
| S28 | 0.4.0 克制批次收尾(jev 裁决的三边角):修一处——decode_xml_entities 补数字字符引用解码(&/&,与 S13 预定义实体同型同路径的静默搜索 miss;jev 0.99/1.00 判静默错误+应修),解码域到 BMP(Char 是单个 UTF-16 码元,astral 引用原样保留不匹配而非错配);文档化三处——DOCTYPE 跳首个 > 与双顶层取第一(jev 1.00 文档化即可)、并发连接无上限(jev 0.14 判回环绑定下不需加帽)、drain 10MB 封顶后的 RST 边角(jev 0.97 文档化即可)——README Boundaries +3 | ~+55 | 差分:十进制/十六进制/具名三形态解码等价 + 四种无效引用原样保留 + astral 不匹配;S5 23/23、S6 39/39;本步测试数未单列,后续快照见 S29/S32 | 完成 |
| S29 | 0.5.0 批次第一项(身份定界的「值得实现」清单):解析 DURATION(RFC 5545 §3.3.6,阶段机严格校验组件顺序与组合:W 单用、S 必经 M、组件不重复、T 后必有组件)——VEVENT 无 DTEND 时以其定结束(双置时报错),occurrence 继承时长,VTODO/VFREEBUSY time-range 路径同样兜底;README 边界行改写(DURATION 不再是边界,RDATE/VALUE=PERIOD 成为新声明的边界) | ~+150 | 语法全形态差分(10 合法形态 + 12 拒绝形态含乱序/重复/裸 T/无组件);VEVENT/series/VTODO 三层接线各一差分(override 继承 DURATION 时长);全目标 208/191/208/217;model .mbti 预期 +parse_duration | 完成 |
| S30 | 0.5.0 批次第二项(身份定界改写后的 MKCALENDAR 任务):新增 parse_mkcalendar——MKCALENDAR 请求体的类型化解析(displayname/calendar-description/calendar-color,实体解码,浅者胜),仅解析不持久化(jev 身份定界 0.02:存储格式是嵌入方的部署决策,库不替嵌入方定默认);服务端行为不变(集合名即 displayname 的边界声明保持) | ~+90 | R5 机械转写 RFC 4791 §5.3.1 示例体 + set-prop 拼写/实体解码 + 空/非 XML 体三种差分;本步测试数未单列,后续快照见 S31;caldav .mbti 预期 +parse_mkcalendar +MkCalendarProps | 完成 |
| S31 | 0.5.0 批次第三项(身份定界 0.86 健壮性项):存储层名字白名单拒绝 Windows 保留设备名(CON/PRN/AUX/NUL/COM1-9/LPT1-9,带不带扩展名都算——Windows 保留的是基名);全平台拒绝而非仅运行平台——vdir 的存在理由是跨工具可移植,Windows 读不了的文件会在拷贝/同步时破坏它;路由层以 404 作答(与非法名同路径) | ~+40 | 11 形态差分(4 基名 + 2 带扩展 + 2 COM/LPT + 3 普通名不受影响);s5 活体 +1(PUT /cal/CON → 404);全目标 211/194/211/221、S5 24/24、S6 39/39 | 完成 |
| S32 | 0.5.0 批次第四项(身份定界 0.95 卫生项):覆盖率审计(caret 模式绕过 coverage 解析器对 xml.mbt 的诊断)——抓到文档与实现不一致:README 声明双顶层「第一根胜」,实现实为最后一根覆盖第一根(追加第二根可伪装 REPORT 判型);对齐为第一根胜(root 已设即不覆盖,两处赋值点加守卫);补三个判别测试(声明/注释/DOCTYPE/双顶层整体行为、超长十进制与空十六进制引用) | ~+45 | 差分:双顶层第一根胜(修复前该测试红——审计即判别);全目标 212/195/212/222、S5 24/24、S6 39/39;.mbti 零变化 | 完成 |
| S33 | 0.5.0 批次例行项(身份定界 0.91 供应链卫生):依赖升级 async 0.22.4→0.22.5、x 0.5.5→0.5.6(moon search 实证有新版);升级后全门闸 + 活体复跑全绿、.mbti 不变 | ~0 | check/test all deny-warn 212/195/212/222、fmt、info 零 diff、S5 24/24、S6 39/39 | 完成 |
| S34 | 0.5.0 本轮一致性修复(2026-10-31):RDATE DATE/DATE-TIME 集合与覆盖;PERIOD、跨域及缺 DTSTART 拒绝;可靠固定时区绑定;候选排序去重与严格周期预算;calendar-query 受检求值,无 master/partial 回退;安全 reason;非重复 VTODO RFC §9.9 状态表;request timezone 结构/字段检查与转换边界 | 跨 model/rrule/caldav/serve | 独立审核通过;严格四目标 251/234/251/261,S5 24/24、S6 47/47(S34+R14 合流后复跑);新 HTTP 求值驱动另计。RDATE→EXDATE 空集、合法→不支持时间求值 500、固定→动态 TZID 500、预算不可证明→500、安全正文/日志均有守卫;证据见 §11 | 完成 |
| S35 | 驳回修复波(随 0.5.0 发布):RDATE 集合、严格固定时区绑定、受检求值、非重复 VTODO §9.9 状态表 | 跨 model/rrule/caldav | 随 0.5.0 发布(0c3a1fd);证据见 §11 | 完成 |
| S36 | 工具链迁移 moonc v0.10.20:73 处新弃用告警清零(#derive 前置、to_string_view/clamped_view),CI 工具链不锁版本因此有时限 | ~0 行为变化 | 全闸 264/247/264/274、.mbti 零 API diff;未迁移则下次 push CI 必红 | 完成 |
| S37 | 递归与变更语义四处缺陷(JEV 审计确认):YEARLY 年序号含负序数、THISANDFUTURE 时长继承(§3.8.4.4)、无 UID 单独判定、DURATION=0 行 | ~+90 | dateutil 差分 +6;全目标 270/253/270/280 | 完成 |
| S38–S42 | 黑客轮一批:DAV XML 控制字符加固、冲突重复 Content-Length 400、名字 NAME_MAX 上限、可证空规则预算错误、双根自闭合 PROPFIND 杀进程 | ~+60 | 全部先实证后修复;15+ 攻击形状否证;全目标 277/258/277/288 | 完成 |
| S43–S52 | 方法面一批:文件级 PROPFIND/REPORT/HEAD(etag 探测形状)、scoped Allow、S44 插错分支自纠(S6 验收抓到)、S50 机械审计、S51 并发连接杀进程修复(上游 @stdio 并发写缺陷,workaround stdio_lock,上游 issue moonbitlang/async#732) | ~+120 | 全部全闸 + 活体复验;S44 回归由 s6 钉住 | 完成 |
| S53+S54 | PUT 前置校验(RFC 4791 §5.3.2 + Radicale 式门前拒绝):读不了的 body 403 不落盘,门=求值器等宽(VTODO 状态、系列类型一致性镜像) | ~+150 | 毒 PUT 全 403、被拒体 404、canary 201;s5/s6 全绿 | 完成 |
| S55 | sabre/vobject override 合并语料移植为差分测试(PHP 生态事实标准)——首轮零分歧 | +5 测试 | 全目标 289/270/289/300 | 完成 |
| S56+S57 | 可证空证明推广为形状不相交穷举(修 30s 冻结)+ WEEKLY;BYMONTHDAY 按 §3.3.10 MUST NOT 拒绝(破坏性变更) | ~+40 | 冻结规则 PUT 即时 403;全目标 291/272/291/302 | 完成 |
| S60 | 广告集收窄(用户拍板对齐主流):混合实体类型与 METHOD → 403 valid-calendar-object-resource;非 VEVENT 实体 → 403 supported-calendar-component;VEVENT-only 门与 PROPFIND 广告等宽 | ~+30 | JEV 0.997/0.989/0.6;毒 PUT 全 403 + 精确元素;s6 +10 钉 | 完成 |
| S61–S66 | 安全审计波:no-uid-conflict(403 命名持有者,跨集合放行)、重复属性行门界(MUST 三属性拒/SHOULD 与无注记宽容)、畸形请求排空(70KB 请求行 RST 吞 400)、If-Match 强比较(弱标签 412)、no-uid-conflict TOCTOU 锁、CDATA 按字符数据 | ~+180 | 原始 socket 实测每项;s6 +16 钉;全目标 320/309/309/289 | 完成 |
| S67–S73 | 二轮审计波:条件 GET/HEAD 304(RFC 9110 §13.1.2)、PUT 原子写(dotfile+rename)、流水线缓冲(两连发只答一问的丢字节修复)、comp-filter 大小写、HEAD 错误应答无体(§9.3.2)、Expect: 100-continue(此前阻塞读体,严格客户端无限挂起,JEV 0.991) | ~+150 | 原始 socket 实测;s6 91 项、s7 34 项(新增原始 socket 套件);全目标 321/310/310/290 | 完成 |
每个里程碑严格走同一循环,禁止「先写一大坨再补测试」:
assert_eq / assert_true(pattern is …) 级别的断言测试;边界(空输入、畸形输入、行号)必须覆盖。///| 分隔,每块带一句话文档注释说明「为什么」。moon fmt && moon check && moon test && moon info,然后检查 .mbti diff——接口变化必须是预期内的,意外的 diff 说明改坏了边界。git -c core.hooksPath=.githooks commit …——项目钩子会跑 moon check 并拒绝「改源码但不更新 PROGRESS.md」的提交。docs/PROGRESS.md(跨会话状态源:本地文件,不入库——§1 快照、§2 里程碑、§3 会话日志)与本手册 §02/§04/§07。钩子会校验它在上次提交后被更新过。新格式(rr_moon_mod + rr_moon_pkg)下的硬规则,违反即编译失败或静默 bug:
import { "moonbitlang/async/http" @http } 写在所在目录的 moon.pkg;.mbt 文件里写 import "..." 是硬错误(3001/3002)。测试专用导入用 import { … } for "test"。pub(all) suberror Name { Ctor(field~ : Type) };Error 是内建 opaque 类型不是 trait,impl Error for X 必失败。展示用 pub impl Show for Name with fn output(...)。Ctor(a=1, b=2),匹配 Ctor(a=x, b=y);位置式会报 requires 0 positional arguments。a..<b(右开)/ a..<=b(闭)。旧写法 a..=b 语义等价,但新版 formatter 会归一成 a..<=b;for 头写坏会在下游报假错误(unbound identifier / 类型不匹配)——先修 for 头。String::trim() 接 StringView::data():data() 返回整个原串不是切片,trim 会静默消失。参照当前 ical/text/content_line.mbt 的 StringView 切片与 to_owned() 所有权边界。moon ide doc "Type::method"(搜 core + 已注册依赖),不要凭记忆写 stdlib 名字。async fn main 需要根包 moonbitlang/async 一并导入;可执行包声明 pkgtype(kind: "executable")。Int 与 Int32 是同一个类型:新版 formatter 把源码里的 Int 归一成 Int32;moonc v0.10.15 及以前 .mbti 会归一回 Int,v0.10.17 起直接渲染 Int32(全仓 6 个接口文件 24 行纯渲染 diff,已随 S10.5 入库)——语义完全不变。S10 后仓库源码统一为 Int32,新代码跟随现状即可。name? : T = d 改写成 name~ : T = d。差别在调用方式——~ 形式只能按名字传(f(x, name=1)),不能再按位置传(实测 parse_date_time(line, zones, 7) 报「requires 2 positional arguments, but is given 3」)。仓库内所有调用点都用 name=value,故本次迁移零调用点改动。.mbti 分不清 ? 与 ~:两者在接口文件里都渲染成 name? : T。于是「.mbti 无 diff ⇒ 对外接口无变化」这条判据在新工具链下有盲区——S10 迁移 .mbti 零 diff,但按位置传可选参数的调用方会编译失败。判断接口兼容性时不能只看 .mbti。off 的检查(0073 unnecessary_annotation、0074 missing_doc、0038/0039 证明类等),--deny-warn 不会开启它们。用 moon check --warn-list "+74" 之类的开关按需排查(编号见 moon explain --diagnostic)。derive(Debug, Eq) 须写成声明前 #derive(Debug, Eq),moon fmt 自动迁移;②无参 s.view() 与切片糖 s[a:b] 弃用——规范形态是 s.to_string_view() 与 s.clamped_view(start=a, end=b)。clamped_view 就是切片糖的本体(_[_:_] 别名),行为逐字相同;exact_view 越界会 panic,除非边界已证明合法否则不要用。CI 的 setup-moonbit@v1 不锁版本,工具链升级要当「下次 push 即红」对待。moon run x.mbtx 里 import justinwongcn/moon-ical/ical/rrule 拿到的是注册表缓存的已发布 0.5.0,不是工作区——本地包加语法错误后脚本照常运行可以复现。所有针对工作区的行为验证必须走模块内临时主包(tmpfuzz/ 式 pkgtype(kind: "executable") + moon run tmpfuzz --),用完即删。混用序数与平条目的 BYDAY 对拍还要注意:python-dateutil 对这种列表返回全空(单独各自正常),moon 的逐条目 OR 才是 RFC 5545 §3.3.10 列表语义。当前实现与历史接缝更正见 docs/upstream-seams.md。上游补齐后先验证契约,不承诺“一行切换”。
| 接缝 | 当前实现与边界 |
|---|---|
| native 文件 / HTTP 服务 | ical/store、ical/fetch 与 cmd/serve 限定 native;没有 js_shim、localStorage 或 Fetcher 后端。 |
| 时区 | ZoneTable 仅计算可靠固定绑定;无 IANA tzdb,也未实现动态 VTIMEZONE 转换。这是两项独立能力,不能以无 tzdb 推断内嵌转换不能实现。 |
| WebDAV 方法 | cmd/serve 接受裸 TCP,ical/httpd 手解析任意方法 token 并写响应。S5 实测 ServerConnection Reader 是帧化 body,不能当原始请求流;未使用 send_response/end_response 或外部 XML 库。 |
| 取件超时 | ical/fetch/fetch.mbt 自行 with_timeout;本地永不响应监听器守卫见 fetch_test。S20/S21 的上游无超时核查有版本范围,升级需重查。 |
411 Length Required(没有增加该能力的实测需求证据)。DAV:prop 选择的剩余边角——S34 让 PROPFIND/REPORT 尊重属性选择(裁剪 + 404 propstat + propname + 畸形体 400);仍按 local name 匹配(命名空间不敏感)、404 回显带 DAV: 前缀(形状解析器只留 local name)、calendar-data 的子元素(expand 等)不支持而回全量、allprop 的 include 读为无额外约束。MKCALENDAR 真正建集合,但 body 里的 displayname / calendar-color 等属性不落盘;集合名即 displayname。/cal/ 兼作家目录与默认集合——S10 刻意的兼容取舍:首版已从 /cal/ 直接服务事件且既有客户端按该路径配置,故新建集合并排放在其下(/cal/<cal>/),而不是把事件搬进 /cal/default/。403 supported-filter,不解析相对 trigger。| 风险 | 等级 | 对策 |
|---|---|---|
| 验收断言不判别——「预期的东西回来了」被当成证据,忽略输入的实现同样能通过,于是缺陷可以穿过全部闸门 | 高 | 已发生(S10 两条缺陷)。对策:§11 的 R1–R7 并入 DoD;改能力声明必须同步「能力 → 证据矩阵」;选择类操作强制「空结果」与「拒绝路径」用例 |
| 手解析 HTTP 边界情况(keep-alive、多值头、Expect: 100-continue) | 中 | 按实际 400/411/413 和方法拒绝路径写边界;S7 联调日志驱动补齐;Radicale 哲学「够用即止」 |
| 真实客户端差异不可控(发现链/PROPFIND 形状各家不同) | 中 | S7 独立成步预留整天;优先 Thunderbird(最宽容、文档全),DAVx5 次之;问题→修复→复测记进互操作矩阵 |
| XML 命名空间(客户端前缀任意:D:/d:/默认 ns) | 中 | 当前形状解析器按局部名匹配,非完整 namespace URI 校验;前缀变体不证明命名空间正确,仍是协议边界 |
| RRULE 序号算术(BYSETPOS/负值/序数 BYDAY)正确性 | 中 | 隔离在 S8 独立成步;附录 A 全量对拍;graham/rrule 上游源码(GitHub)随时对照 |
| 九月场规则未确认(本地技能只有八月场章程) | 低 | 章程与已核实九月表单须区分;此前表单要求本人写申报书,旧稿不得直接提交。最新参赛/复审要求由本人向官方确认 |
| 规模与质量(不以旧 962 行快照或参考 LOC 代替验收) | 低 | 当前包规模见 §02,判断以实际源码和判别性测试为准;不为达到行数堆无关功能 |
八月场验收硬标准 → 里程碑映射(九月场以官方章程为准):
| 验收项 | 满足于 |
|---|---|
| MoonBit 为主语言 | 全程 |
| 可运行示例 | S1 起有 fixture demo,S5 起服务器可 moon run,S7 起真实客户端 demo |
| 核心路径测试 | S1–S6 各自带测试;S3/S8 附录 A 对拍;S6 curl 序列集成测试 |
| CI | S9(moon check/test --target all + fmt + info,参考 moonbit-community/.github 的 check.yml) |
| 发布 mooncakes.io | S9 起已发布;最新发布版 0.5.0(2026-10-31),0.4.0 发布于 2026-10-26 |
| 默认分支 ≥5 真实提交 | S0–S9 每步一提交,自然 ≥10 |
| 申报书(一页 Markdown) | S9 曾有旧稿;其通用/任意来源承诺已被驳回,不再视为可提交材料。现文件仅范围修订核对素材,待本人定稿 |
| AI 辅助合规 | 工程 AI 辅助须可解释、可测试、来源明确;此前九月表单要求申报书本人撰写,不以 AI 新稿替代本人提交稿 |
背景:0.2.0 发布、进入验收后被指出两条缺陷——「calendar-query 忽略 filter,关键语义缺失」与「MKCALENDAR 不建集合」。两条都属实,却在此前所有闸门全绿的情况下漏过:全目标测试、S5/S6 活体验收、Thunderbird 真实联调、96% 覆盖率,没有一项报警。本节记录根因,并把它固化成规则,避免再犯。
| # | 根因 | 当时的证据 |
|---|---|---|
| 1 | 断言不判别(最直接原因):用例的请求体里根本不含被检验的输入 | S6 的 calendar-query 请求体没有 <C:filter>,断言是 code == 207 and "UID:s6@moon-ical" in body——只要「把已知存在的事件返回」就通过,全量返回同样满足。该用例在「正确实现」与「完全不实现」两种情况下都是绿的。 |
| 2 | 能力声明先于证据 | README Features 与 §02 把 MKCALENDAR 列为已支持,而全仓(单测 + S5 + S6)零个 MKCALENDAR 用例。声明来自「路由里有个分支回 201」,不是来自任何被验证过的行为。 |
| 3 | 验收按「协议动作清单」组织,而非「语义契约」 | S6 的 11 项按 OPTIONS/PROPFIND/REPORT/PUT/DELETE 排列,每项只问「有没有回预期状态码」。一个回 207 的桩实现能通过状态码清单。 |
| 4 | 全为正例,没有否定例与前置条件例 | 11 项里没有任何一项形如「这个输入必须不返回那个」;403 的 valid-filter / supported-filter 两条前置条件从未被触发过一次。 |
| 5 | 客户端互操作被当成协议完整性 | S7 的 Thunderbird 全绿,是因为它只用单一内建集合、也不依赖服务端时间范围过滤——恰好绕开了这两条缺陷。互操作只证明「该客户端走的那几条路」,不等于协议面完整。 |
| 6 | 边界清单只有「有意不做」,没有「已声明但未验证」 | §08 列的是刻意的省略(tzdb、scheduling、TLS…)。两条缺陷不在其中,于是被隐式当成「已支持」;没有任何机制强制「文档能力 ↔ 证据」的映射。 |
| 7 | 「规范机械对拍」只在库层做了,协议层没做 | RRULE 层从第一天就用 graham 语料机械抽取 40 条串对拍,这条纪律确实有效(第一/二档全部对拍通过);CalDAV 层没有等价的「从 RFC 例子机械抽取请求体」,请求体全部手写,于是继承了实现者的盲区。 |
| # | 规则 | 判定方式 |
|---|---|---|
| R1 | 判别性断言:任何「接收输入并据此决定输出」的操作,验收必须包含一对只差该输入的请求,并断言两者结果不同 | calendar-query:同一集合上两个只有 time-range 不同的 query 必须返回不同的资源集合。反例(禁止):只断言「已知事件出现在响应里」。 |
| R2 | 选择 / 过滤类操作必须有「空结果」用例 | 断言返回空 multistatus,而不是「返回了全部」。区间外、无匹配属性都必须有此例。 |
| R3 | 可拒绝的操作必须有拒绝用例,并断言具体状态码 + 具体错误元素 | 如 403 + <C:valid-filter/>;不能只断言「不是 200」。每条新增的 403/405/409 路径都要有落点。 |
| R4 | 每条对外声明的能力必须有至少一个「因它缺失而失败」的检查 | 做不到就把它从 Features 移进 §08 边界。落地载体 = 下文的「能力 → 证据矩阵」:改能力声明必须同步改矩阵。 |
| R5 | 协议请求体从 RFC 例子机械抽取,与 RRULE 层的 graham 语料同纪律 | 手写请求体只允许作为补充;抽取脚本或逐条抄录都要在用例注释里留下出处(RFC 章节号)。 |
| R6 | 互操作报告必须写明「该客户端未触及的协议面」 | 互操作通过不得用作协议完整性的证据;矩阵要有一列记「未覆盖」。 |
| R7 | 里程碑验收标准必须写成可判否形式 | 「REPORT 序列全绿」不合格;「同一集合上两个只有 time-range 不同的 query 返回不同集合」合格。 |
文件名未加前缀处均位于 ical/ 下;根门面测试在仓库根目录。规则 R4 的载体:凡在 Features / §02 出现的对外能力,都必须能在此表定位到判别性证据;定位不到的一律移入 §08「明确不做」。
| 能力 | 单元测试 | 活体验收 | 判别性证据(关键一条) |
|---|---|---|---|
| 折行展开 / 内容行 / 转义 | text 用例 | — | 带引号参数还原、多字节折行往返 |
| 组件树(未知组件保留) | model 用例 | — | 未知组件仍出现在序列化输出里 |
IcalDateTime 四态 / ZoneTable | model 用例 | — | 四态各一条;未绑定 TZID 报错;内置 UTC/GMT/Z 之外须显式固定绑定,不猜地域标准偏移 |
Event 类型化视图 | model 用例 | demo 实跑 | 畸形属性报错 vs 属性缺失为 None |
| RRULE 解析(三档) | rule/corpus 用例 | — | graham 40 串机械抽取:界内 32 解析 / 界外 8 显式报错 |
| RRULE 展开(第一 / 二档) | expand/tier2/corpus | — | 与 graham 数字逐条对拍(第一档 23 + 第二档 8) |
expand_series 覆盖合并 | series 用例 | — | EXDATE 移除 / 改期 / 取消 / THISANDFUTURE 各一条 |
| 序列化折行与引号 | serialize 用例 | — | roundtrip 相等 + 幂等 + 75 octets 字节边界 |
| HTTP/1.1 请求层 | httpd 用例 | S5 | chunked → 411、畸形 → 400、Content-Length 按字节;头行 64KB / 头数 100 封顶 → 400;非数字 Content-Length → 400 而非 413(S14) |
取件层 fetch_ics | fetch 1 例(native-only) | demo 人工 URL 模式 | 判别性证据 = 超时单测(本地「接受但永不响应」监听器 + timeout_seconds=1,断言恰为 FetchError::TimedOut——上游 async(0.21.2 与 0.22.4 均核实)客户端与 socket 层无任何超时,本包的界是唯一防线,S20 补);demo 对真实 .ics URL 打印解析后事件、非 200 抛 FetchError::BadStatus;外网测试不进 CI 是 S1.5 的既定决策(超时单测纯本地、进 CI) |
| vdir 存储 / ETag | store 用例 | S5 | 同字节同 tag、改一字节即变、非法名拒绝 |
| 集合创建 / 枚举 S10 | store + serve 用例 | S6 | 建两次第二次为 false;嵌套集合的事件不计入父集合 |
| 发现链 / well-known | caldav 用例 | S6 | 301 且 Location: /cal/ |
| PROPFIND Depth 0/1 | caldav 用例 | S6 | depth 0 不含事件、depth 1 含;S15 起 S6 活体含 Depth 0 与不可解析 Depth 的差分(桩 hardcode depth=1 会挂) |
| calendar-query filter 求值 S10 | filter 19 例 | S6 | 区间内选中 vs 区间外空结果(R1+R2);i;octet 大小写敏感 vs 默认折叠 |
| calendar-multiget | caldav 用例 | S6 | 只返回被请求的 href;缺失 href 回其独立 404 response(S26 更正了 S15 的空答);已知/缺失混合请求同时有 200 与 404 |
DAV:prop 属性选择 S34 | caldav 13 例(propfind_test) | S6(+8 项) | 只差 prop 元素的两请求答案不同(R1):getetag-only 不含 calendar-data、加上即恢复;未知属性 → 404 propstat(R3);PROPFIND 里 calendar-data → 404(RFC 4791 §9.6);空体 ≡ allprop;畸形体 → 400 |
| If-Match / If-None-Match | caldav 用例 | S6 | 陈旧 tag → 412(PUT 与 DELETE 双路径,S15);If-None-Match: * 重复建 → 412 |
| MKCALENDAR 建集合 S10 | store + serve 用例 | S6 | 建后 Depth 1 能发现它;重复建 → 405 |
| Thunderbird CRUD | — | S7 人工会话 | 仅默认集合路径;未覆盖 MKCALENDAR 与时间范围过滤(见 R6) |
| RDATE DATE/DATE-TIME 集合 | model/recurrence_dates_test.mbt;rrule/series_query_test.mbt | 独立 HTTP 求值驱动 | RDATE 早于 DTSTART/晚于 UNTIL、不占 COUNT;重复槽去重;同槽 EXDATE 后为空;RDATE 改期/取消/THISANDFUTURE 与时长继承。PERIOD 与 VALUE/域不一致拒绝;serialize_test 保留未解释原始属性。 |
| 严格固定时区 | model/fixed_zone_test.mbt;model/zone_test.mbt;facade_timezone_test.mbt | 独立 HTTP 求值驱动 | 显式固定声明匹配;只新增 DAYLIGHT 后时间查询 500,但 SUMMARY/GET 仍成功。未绑定地域名、重复/冲突声明遮蔽同名默认绑定;未引用声明保留。 |
| 原始候选与预算完整性 | rrule/series_query_test.mbt;rrule/review_regression_test.mbt | 独立 HTTP 求值驱动 | 候选排序去重先于 COUNT;有 COUNT/UNTIL 与零输出走满 10000 周期都标 budget_exceeded,公开 expand/expand_series 抛 Invalid。远 RDATE/EXDATE/override 不伪造 raw frontier 或 exhausted。 |
| calendar-query 无 master / partial 回退 | caldav/evaluation_test.mbt | tools/s6_evaluation_acceptance.mbtx | 合法 RRULE→207,改 HOURLY→500 且无 multistatus;EXDATE/取消全部实例→精确空 207;远期预算与未来负移 override 不能证明空→500。报告先求值再提交,无部分 207;文本筛选和 GET/multiget 对照继续可用。 |
| 安全 reason / REPORT 日志 | caldav/evaluation_test.mbt | 独立 HTTP 求值驱动 | 非法 DURATION 与非法文档均返回 500,reason 带 href 与固定分类,不含 PRIVATE-SENTINEL;HTTP 正文和日志双断言。范围仅本轮 REPORT 求值错误,非所有 handler 日志隐私承诺。 |
| 非重复 VTODO RFC §9.9 | caldav/evaluation_test.mbt(VTODO overlap state table) | 独立 HTTP:重复 VTODO 拒绝 | 按 RFC 状态表实现 DTSTART/DURATION/DUE/CREATED/COMPLETED 组合;单测判别 DURATION 端点、DUE 等边界、CREATED-only 与无时间字段。不是把 VTODO 当 VEVENT 区间;重复计算明确失败。 |
| request timezone 边界与前置条件 | caldav/evaluation_test.mbt | 独立 HTTP 求值驱动 | VERSION/TZID/observance 必需字段唯一、DTSTART floating DATE-TIME 等已检查结构/字段非法→403 valid-calendar-data;合法结构 temporal→500,文本筛选可成功。未实现转换,不声称全 RRULE 验证;未知 collation→403 supported-collation,有精确元素断言。 |
| DURATION / MKCALENDAR 属性解析 | model/duration_test.mbt;caldav/mkcalendar_test.mbt | S5/S6(不证明属性落盘) | DURATION 合法/乱序/重复形态差分与事件时长继承;MKCALENDAR 请求体按 RFC 4791 §5.3.1 转写,实体解码与非法形状差分。属性仅类型化解析。 |
<D:prop> 属性选择:S34 已实现——PROPFIND/REPORT 按选择裁剪、404 propstat、propname、空体 ≡ allprop、畸形体 400;证据见矩阵 caldav 行。剩余边角(local name 匹配、回显前缀、expand 子元素)见 §08。sync-collection / CTag:未支持,返回 400——有单测钉住「不支持」这一事实本身,但没有实现。displayname、calendar-color):不落盘(见 §08)。time-range:显式 403 supported-filter(有单测)。