# MoonCalGuard 调研记录

调研日期：2026-08-04

复核日期：2026-08-20

## Mooncakes 结果

已检索 Mooncakes 上的 `iCalendar`、`ICS`、`calendar parser`、`RFC5545` 等关键词，未发现高度重合的 MoonBit 包。Mooncakes 上已有 HTML、TOML、SQL parser、CLI 参数解析、Wasm runtime 等成熟方向，但没有看到“iCalendar / ICS 解析 + 规则校验 + 规范化导出 + 事件 diff”的同类项目。

可见的相邻项目包括：

- `moonbit-community/html`：HTML5 parser；
- `maria/toml_parser`：TOML parser；
- `moonbit-community/sqlparser`：SQL lexer/parser；
- `TheWaWaR/clap`：命令行参数解析；
- `Milky2018/wasmoon`：WebAssembly runtime，与本项目方向不同。

## 名称搜索

检索关键词包括：

- `MoonCalGuard`
- `mooncalguard`
- `MoonBit iCalendar`
- `MoonBit ICS calendar parser`
- `MoonBit RFC5545`

未发现明显同名 MoonBit/Mooncakes 项目。

## 2026-08-20 公开搜索复核

使用关键词 `MoonCalGuard`、`mooncalguard`、`MoonBit iCalendar ICS parser`、`site:mooncakes.io iCalendar MoonBit ICS calendar parser` 进行公开搜索。未发现已发布的同名项目，也未发现 Mooncakes 上已有“MoonBit 原生 iCalendar / ICS 解析 + 校验 + 导出 + 事件 diff + RRULE + VALARM + 报告”的完整同类包。

公开搜索中看到 MoonBit community 自动贡献流程里存在一个 `icalendar-lite` 方向 issue（https://github.com/moonbit-community/auto-contrib-workflow/issues/32），属于待实现/构想型条目，不是已发布 Mooncakes 包。MoonCalGuard 的差异是已经形成可运行 MoonBit 库，包含嵌套组件解析、RRULE、DURATION、VALARM、属性目录、报告、议程查询、测试、demo 和 CI。

## 原创说明

MoonCalGuard 是原创 MoonBit 实现，不移植第三方项目源码。项目只依据公开 iCalendar / RFC5545 格式规则设计解析、校验和导出逻辑，测试数据为项目内自制 ICS 文本 fixture。