# 路线图

按可独立提交、可独立验证的顺序拆分，每步都应有对应的测试。

## M0 骨架（已完成）

- [x] `moon new` 初始化模块，确定包名与元数据
- [x] 协议层最小公开 API：opcode、默认块大小、默认端口
- [x] 双仓 CI 骨架（CNB 流水线 + GitHub Actions）
- [x] 文档：协议速览 / 架构 / 路线图 / 参考实现

## M1 报文层

- [x] 报文字节编解码：RRQ / WRQ / DATA / ACK / ERROR / OACK（`encode` / `decode`）
- [x] 往返测试 + 畸形报文（截断、非法 opcode、超长字段、缺 `\0`）处理
      —— 四类原因各有自己的 `DecodeError`：`Truncated` / `UnknownOpcode` /
      `MissingTerminator` / `FieldTooLong`。超长字段是**被 `\0` 终结但超过
      `max_field_length`** 的那种，不再与「缺 `\0`」共用一个变体；
      文件名、mode、选项名 / 值、ERROR 报文统一走同一把尺子
- [x] 通道模式枚举：netascii / octet（mail 只留枚举值，`decode` 拒绝）
- [x] 选项 `Option\0Value\0` 拆分（取值校验留给 M2）

## M2 选项协商（已完成）

- [x] 解析 `Option\0Value\0` 序列
- [x] `blksize` / `timeout` / `tsize` 的取值校验与缺省回退
- [x] 服务端 OACK 生成与拒绝路径（ERROR 8）

## M3 客户端（已完成）

- [x] 传输抽象与内存实现（便于离线测试）
- [x] `get` / `put` 停等状态机
- [x] 超时重传 + 重复包去重（Sorcerer's Apprentice）
- [x] block 号 u16 回绕
- [x] netascii 转换
- [x] 选项被拒（ERROR 8）的去 options 重发一次，与无 OACK 的缺省回退

## M4 服务端（已完成）

- [x] 69 端口请求接收与 TID 会话分发（`Dispatcher` + `TidAllocator`）
- [x] 并发会话生命周期管理（每会话独立 TID，`step_write` 不主动发送，
      调用方掌握时序）
- [x] 根目录约束与路径穿越防护（`resolve_path`，拒绝 `..`）
- [x] netascii 服务端支持：读请求编码后发送、写请求解码后落盘，
      `tsize` 按线上字节数回答
- [x] 错误码语义（文件不存在 1 / 访问违规 2 / 磁盘满 3 / 非法操作 4 /
      已存在 6 / 协商失败 8 / 超时 0）
- [x] 畸形请求回 ERROR 4 而非静默丢弃（`Dispatcher::route` 里 `decode` 失败
      即拒，客户端不必重传到预算耗尽）

## M5 CLI 与收尾（已完成）

- [x] `cmd/main`：`get` / `put` / `serve` 子命令
- [x] 真实 UDP 套接字上的客户端传输（`transport_socket.mbt`），并让服务端
      会话传输实现 `Transport`（`server_fs.mbt`），使 CLI 复用库的状态机
- [x] 端到端示例与 README 补全（用法、平台支持：仅 native）
- [x] 覆盖率检查与边界用例补齐（`scripts/ci.sh` 用 `moon coverage report -f summary` 汇总，
      再跑 `moon coverage analyze` 把未覆盖行写进 `_build/uncovered.log`）
- [x] 与 curl 的互操作对拍，并据此修复两个真实对端才暴露的问题
      （见 `docs/interop.md`）
- [x] roadmap 里 M0~M5 的勾选框回填

## 覆盖率

`scripts/ci.sh` 跑两步：`moon coverage report -f summary` 给汇总数字，
`moon coverage analyze` 把未覆盖行写进 `_build/uncovered.log`。前者按
「已编译 + 已覆盖 / 已编译」算，没被任何测试加载过的文件会被整份漏掉，
所以要两步都跑才能既看到比例又看到名单。

具体数字与逐文件清单不写在这里：它们每次改动都会变，写进文档只会变成
一份需要同步维护的过期账本。要看现状就跑上面两条命令。

门槛（比如「覆盖率不得低于 N%」）暂不设置：本仓库能在 CI 里跑的测试集里，
有相当一部分行为只能靠 `scripts/ci.sh` 里的真实进程对拍，单看行覆盖率
容易逼出为了数字而写的测试。

## 待定

- DHCP / BOOTP 组合（作为「网络引导工具链」的可选扩展）
- 与 tftp-hpa / atftp 的对拍（环境暂无这两个程序）
- 平台支持仅限 native（需要真实网络栈，js / wasm / wasm-gc 不支持）