moon-ical · 内部开发手册

开发手册:iCal 解析库 + CalDAV 服务器

记录项目范围、架构、里程碑与验收证据。当前状态见 §02,历史步骤见 §04,能力证据见 §11;跨会话交接由本地 docs/PROGRESS.md 负责。

更新日期 2026-10-31 进度 S0–S37 / R1–R14 已入库(0.4.0 与 0.5.0 均已发布 mooncakes;S36 = moonc v0.10.20 工具链迁移,S37 = 递归/变更语义四处修复) 工具链 moon 0.1.20261104 / moonc v0.10.20(rr_moon_mod + rr_moon_pkg;S10 后源码已按新 formatter 迁移 Int→Int32,S10.5 起 .mbti 也直接渲染 Int32,S36 起 #derive 前置与 to_string_view()/clamped_view() 视图转换) 依赖 moonbitlang/async@0.22.5 · moonbitlang/x@0.5.6 状态 严格四目标 251/234/251/261;S5 24、S6 39;新 HTTP 求值另计

01定位与证据链

一句话定位:纯 MoonBit 的 iCalendar(RFC 5545)解析 / 重复事件展开库,附带最小 CalDAV(RFC 4791)服务端。计算限定为支持的规则与可靠固定时区,不承诺完整协议栈或任意来源的语义处理。

立项调研记录(2026-09-08;不是今日全生态排名或提交稿):

当时调研的差异:① 端到端——从网络取件到客户端可连,而非纯计算库;② 真实数据——RFC 5545 附录 A 对拍 + 真实客户端联调矩阵,当时调查的 fixture 情况不代表全部外部数据能力;③ RECURRENCE-ID 单实例改期合并——五家共同空白(调研矩阵 ④b 行)。

02进度快照

包内容源码行数(含注释)测试状态
ical/text折行展开(§3.1)、内容行解析(引号参数)、文本反转义、带行号 ParseError36426 测试声明已落地
ical/model组件树(BEGIN/END 嵌套、未知组件保留)、IcalDateTime(四态时间,Eq)、ZoneTable(显式固定绑定;内嵌 VTIMEZONE 须能证明固定,动态/无效/冲突引用拒绝)、Event 类型化视图(S1:parse_events / Component::events / Component::event,RRULE 原文、EXDATE、RDATE、RECURRENCE-ID)126074 测试声明已落地
demo可运行入口:内嵌真实形态 fixture(折叠/转义/TZID/RRULE/EXDATE/全天/改期覆盖),打印事件清单(moon run demo)1070 测试声明S1 起步
ical/fetch取件层:fetch_ics(url, timeout_seconds?=30)(@http.get 薄层 + 状态检查,非 200 抛 FetchError::BadStatus;上游无任何超时,本包以 with_timeout 兜底,到点抛 TimedOut——S20);demo 支持 URL 参数端到端691 测试声明已落地
ical/rrule限定日历级 RRULE 展开(S2/S3/S8):四档 FREQ × INTERVAL/COUNT/UNTIL、序数 BYDAY、正负 BYMONTHDAY、BYMONTH、BYSETPOS、WKST;expand_series 合并 RDATE、EXDATE、RECURRENCE-ID 改期/取消/THISANDFUTURE;生成完整性独立记录,周期预算不足报错132266 测试声明已落地
ical/serialize组件树 → .ics 文本(S4):CRLF、75-octets 折行(多字节不劈开)、参数值按需重引号;@text.escape_value 与 unescape 对称;roundtrip 组件树相等且幂等18112 测试声明已落地
ical/storevdir 存储(S5/S10):每事件一个 .ics 文件,每个日历集合一个子目录;FNV-1a 内容寻址 ETag(同字节同 tag);名字白名单(字母数字._- 且非点开头)防路径逃逸;get 缺失返回 None;集合能力 = collections/create_collection/collection/remove_collection,list 只返回事件3475 测试声明已落地
ical/httpdHTTP/1.1 请求层(S5):手解析请求行/头/Content-Length 体,方法是 token(WebDAV 方法天然可读);chunked 拒收(411);裸 socket 读写(ServerConnection 是帧化 reader 不适用);S6 在此之上加 WebDAV/CalDAV 语义46517 测试声明请求层已落地
ical/caldavWebDAV/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),存储内容永不毒化报告182555 测试声明已落地

合计:严格全目标测试为 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 未跑。

03架构与数据流

请求自上而下流经六层,每层一个包、单向依赖;层与层之间只经公开接口(.mbti)通信:

cal clientThunderbird / curl(DAVx5 / Apple 未跑)
→
ical/httpdHTTP/1.1 请求层:accept + 手解析请求行/头/体;响应由 respond 写裸连接
已落地
→
WebDAV/CalDAVPROPFIND / REPORT / MKCALENDAR / ETag;XML 为本地最小形状解析器
已落地
→
ical/storevdir:每事件一个 .ics 文件,目录即日历集合
已落地
ical/serialize · serialize组件树 → 折行 .ics 文本
已落地
←
ical/model · Component / IcalDateTime / ZoneTable组件树 + 四态时间 + 偏移表
已落地
←
ical/text · unfold / parse_content_line物理行 → 逻辑行 → 内容行
已落地

当前接口(按源码与 pkg.generated.mbti 核对)

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 子包,不是根门面重导出。

设计立场:保真优先——未知组件/属性一律保留(竞品 mooncal 是固定字段清单);时间四态显式建模;类型化计算不能完成时失败;组件树保留不等于所有数据可计算。这三条是后续所有包必须继承的基线。

04里程碑与历史 S0–S73

下表保留各步骤当时的验收数字与行为。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()(映射层,无新算法)~150demo 读本地 fixture .ics 打印事件清单完成(S1)
S1.5取件切片:ical/fetch(@http.get 薄层,非 200 抛 FetchError)+ demo 支持 URL 输入:URL → 事件清单 端到端。网络测试不进 CI(Google 源本网络不可达,演示用 calendarlabs)~130给真实可达 .ics URL,打印解析后事件清单;CI 仍走本地 fixture完成(S1.5)
S2RRULE 解析(不展开):第一档子句 → Rule;不支持子句显式报错~200graham 32 个用例的 rule 串全部按档位解析或报错完成(S2)
S3第一档展开:DAILY/WEEKLY/MONTHLY + INTERVAL/COUNT/UNTIL/BYDAY(无offset)/BYMONTHDAY(正) + DTSTART 回退特例~400RFC 附录 A 第一档 ~20 用例对拍全绿(语料:graham/rrule 测试套件,见 THIRD-PARTY-NOTICES.md)完成(S3)
S4iCalendar 序列化写回:fold(75 octets)/escape/组件树→ics(库层写回;服务端 calendar-data 读取存储原文)~200parse → serialize → parse 往返不变完成(S4)
S5HTTP/1.1 请求层 + vdir 存储:accept + 手解析请求行/头/Content-Length 体;OPTIONS/GET/PUT/DELETE~350curl 完成事件 PUT/GET/DELETE 往返,ETag 正确变化;chunked 请求回 411完成(S5)
S6WebDAV/CalDAV 核心:PROPFIND(Depth 0/1)、REPORT(calendar-query/multiget)、MKCALENDAR、well-known 重定向、发现链、If-Match/If-None-Match~450curl 模拟 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 门面、互操作矩阵进 README0.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~1002000 occurrences + 500 无关 overrides 的 native release 基准由 20.27 ms 降至 1.64 ms;语义回归与全目标测试通过完成(约 12.4×)
R2CalDAV REPORT 热路径:StringView 零拷贝扫描 + href 哈希选择~100500 hrefs × 500 resources 的 native release 基准由 68.17 ms 降至 3.87 ms;命名空间前缀回归与全目标测试通过完成(约 17.6×)
R30.2 根门面收口:新增整文档 parse_calendar,顶层只暴露完整 parse / recurrence / serialize 工作流~50pkg.generated.mbti 明确移除协议与文本层拼装 API;子包高级入口保留;门面往返测试通过完成(0.2.0 已发布)
R4通用 ICS 解析链 StringView 化:unfold、内容行、参数和 EXDATE 列表仅在所有权边界分配~1201000 VEVENT 的 native release 基准由 25.83 ms 降至 15.10 ms;既有 Unicode 折行与全目标回归通过完成(约 1.71×)
R5RRULE 预归一化:排序 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 保持不变~1100S6 活体验收由 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~+300S6 活体 +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 决策)~+70S6 当时报 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 可靠送达)~+40S5 活体 +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(双事件资源假阳性)~+45filter 差分测试(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 全部带斜杠,存量客户端不受影响~+25serve 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~+80K3 差分(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完成
S220.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~+60K5a 差分(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 零变化完成
S230.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完成
S240.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 复跑无回归完成
S250.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完成
S260.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完成
S270.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 兜底交互)逐项核对无新发现~+25F1 差分测试(19 位 CL → 413);全目标 201/184/201/210、S5 23/23、S6 39/39完成
S280.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完成
S290.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完成
S300.5.0 批次第二项(身份定界改写后的 MKCALENDAR 任务):新增 parse_mkcalendar——MKCALENDAR 请求体的类型化解析(displayname/calendar-description/calendar-color,实体解码,浅者胜),仅解析不持久化(jev 身份定界 0.02:存储格式是嵌入方的部署决策,库不替嵌入方定默认);服务端行为不变(集合名即 displayname 的边界声明保持)~+90R5 机械转写 RFC 4791 §5.3.1 示例体 + set-prop 拼写/实体解码 + 空/非 XML 体三种差分;本步测试数未单列,后续快照见 S31;caldav .mbti 预期 +parse_mkcalendar +MkCalendarProps完成
S310.5.0 批次第三项(身份定界 0.86 健壮性项):存储层名字白名单拒绝 Windows 保留设备名(CON/PRN/AUX/NUL/COM1-9/LPT1-9,带不带扩展名都算——Windows 保留的是基名);全平台拒绝而非仅运行平台——vdir 的存在理由是跨工具可移植,Windows 读不了的文件会在拷贝/同步时破坏它;路由层以 404 作答(与非法名同路径)~+4011 形态差分(4 基名 + 2 带扩展 + 2 COM/LPT + 3 普通名不受影响);s5 活体 +1(PUT /cal/CON → 404);全目标 211/194/211/221、S5 24/24、S6 39/39完成
S320.5.0 批次第四项(身份定界 0.95 卫生项):覆盖率审计(caret 模式绕过 coverage 解析器对 xml.mbt 的诊断)——抓到文档与实现不一致:README 声明双顶层「第一根胜」,实现实为最后一根覆盖第一根(追加第二根可伪装 REPORT 判型);对齐为第一根胜(root 已设即不覆盖,两处赋值点加守卫);补三个判别测试(声明/注释/DOCTYPE/双顶层整体行为、超长十进制与空十六进制引用)~+45差分:双顶层第一根胜(修复前该测试红——审计即判别);全目标 212/195/212/222、S5 24/24、S6 39/39;.mbti 零变化完成
S330.5.0 批次例行项(身份定界 0.91 供应链卫生):依赖升级 async 0.22.4→0.22.5、x 0.5.5→0.5.6(moon search 实证有新版);升级后全门闸 + 活体复跑全绿、.mbti 不变~0check/test all deny-warn 212/195/212/222、fmt、info 零 diff、S5 24/24、S6 39/39完成
S340.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 行~+90dateutil 差分 +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+S54PUT 前置校验(RFC 4791 §5.3.2 + Radicale 式门前拒绝):读不了的 body 403 不落盘,门=求值器等宽(VTODO 状态、系列类型一致性镜像)~+150毒 PUT 全 403、被拒体 404、canary 201;s5/s6 全绿完成
S55sabre/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 广告等宽~+30JEV 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完成

05每步工作流(Definition of Done)

每个里程碑严格走同一循环,禁止「先写一大坨再补测试」:

  1. 写测试先行或同步:每块新行为至少一个 assert_eq / assert_true(pattern is …) 级别的断言测试;边界(空输入、畸形输入、行号)必须覆盖。
  2. 实现:块式组织,///| 分隔,每块带一句话文档注释说明「为什么」。
  3. 验证链:moon fmt && moon check && moon test && moon info,然后检查 .mbti diff——接口变化必须是预期内的,意外的 diff 说明改坏了边界。
  4. 提交:一次提交一个里程碑,消息格式 S<n>: <一句话>,正文列改动点 + 验收证据(测试数、对拍结果)。命令必须是 git -c core.hooksPath=.githooks commit …——项目钩子会跑 moon check 并拒绝「改源码但不更新 PROGRESS.md」的提交。
  5. 更新跟进文档:docs/PROGRESS.md(跨会话状态源:本地文件,不入库——§1 快照、§2 里程碑、§3 会话日志)与本手册 §02/§04/§07。钩子会校验它在上次提交后被更新过。
规模红线:单步新增代码超过计划规模 1.5 倍(如 S1 超过 ~220 行)即视为范围蔓延——停下来检查是不是把下一步的活提前做了,砍回去。
验收有效性红线(S10 复盘,见 §11):本循环第 1 条「至少一个断言测试」不足以构成验收。凡「接收输入并据此决定输出」的操作,必须额外满足 §11 的 R1–R7——尤其 R1(一对只差输入的请求必须给出不同结果) 与 R2(选择类操作必须有空结果用例)。只断言「预期的东西回来了」的用例不算证据:全量返回同样能通过它,S10 的两条缺陷就是这么漏过全部闸门的。

06MoonBit 工程约定与踩坑清单

新格式(rr_moon_mod + rr_moon_pkg)下的硬规则,违反即编译失败或静默 bug:

07上游接缝登记(活文档)

当前实现与历史接缝更正见 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 的上游无超时核查有版本范围,升级需重查。

08明确不做(边界)

09风险与对策

风险等级对策
验收断言不判别——「预期的东西回来了」被当成证据,忽略输入的实现同样能通过,于是缺陷可以穿过全部闸门高已发生(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,判断以实际源码和判别性测试为准;不为达到行数堆无关功能

10提交与验收映射

八月场验收硬标准 → 里程碑映射(九月场以官方章程为准):

验收项满足于
MoonBit 为主语言全程
可运行示例S1 起有 fixture demo,S5 起服务器可 moon run,S7 起真实客户端 demo
核心路径测试S1–S6 各自带测试;S3/S8 附录 A 对拍;S6 curl 序列集成测试
CIS9(moon check/test --target all + fmt + info,参考 moonbit-community/.github 的 check.yml)
发布 mooncakes.ioS9 起已发布;最新发布版 0.5.0(2026-10-31),0.4.0 发布于 2026-10-26
默认分支 ≥5 真实提交S0–S9 每步一提交,自然 ≥10
申报书(一页 Markdown)S9 曾有旧稿;其通用/任意来源承诺已被驳回,不再视为可提交材料。现文件仅范围修订核对素材,待本人定稿
AI 辅助合规工程 AI 辅助须可解释、可测试、来源明确;此前九月表单要求申报书本人撰写,不以 AI 新稿替代本人提交稿

11验收有效性:为什么缺陷能过验收(S10 复盘)

背景: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 例子机械抽取请求体」,请求体全部手写,于是继承了实现者的盲区。

硬性规则(并入 §05 的 Definition of Done)

#规则判定方式
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 四态 / ZoneTablemodel 用例—四态各一条;未绑定 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 用例S5chunked → 411、畸形 → 400、Content-Length 按字节;头行 64KB / 头数 100 封顶 → 400;非数字 Content-Length → 400 而非 413(S14)
取件层 fetch_icsfetch 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 存储 / ETagstore 用例S5同字节同 tag、改一字节即变、非法名拒绝
集合创建 / 枚举 S10store + serve 用例S6建两次第二次为 false;嵌套集合的事件不计入父集合
发现链 / well-knowncaldav 用例S6301 且 Location: /cal/
PROPFIND Depth 0/1caldav 用例S6depth 0 不含事件、depth 1 含;S15 起 S6 活体含 Depth 0 与不可解析 Depth 的差分(桩 hardcode depth=1 会挂)
calendar-query filter 求值 S10filter 19 例S6区间内选中 vs 区间外空结果(R1+R2);i;octet 大小写敏感 vs 默认折叠
calendar-multigetcaldav 用例S6只返回被请求的 href;缺失 href 回其独立 404 response(S26 更正了 S15 的空答);已知/缺失混合请求同时有 200 与 404
DAV:prop 属性选择 S34caldav 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-Matchcaldav 用例S6陈旧 tag → 412(PUT 与 DELETE 双路径,S15);If-None-Match: * 重复建 → 412
MKCALENDAR 建集合 S10store + 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.mbttools/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.9caldav/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.mbtS5/S6(不证明属性落盘)DURATION 合法/乱序/重复形态差分与事件时长继承;MKCALENDAR 请求体按 RFC 4791 §5.3.1 转写,实体解码与非法形状差分。属性仅类型化解析。

当前已知的未验证 / 未支持面(诚实清单)

每次改能力声明时问三句:①这条能力在「能力 → 证据矩阵」里定位得到判别性证据吗?②证据里有没有一对只差输入的请求?③新增的失败路径(包括 500)有没有对应的拒绝用例?三句有任何一句答不上来,就先补证据再改声明。