Files

1.8 KiB
Raw Permalink Blame History

Delivery Report 工程验收样本

这是有意保留缺失功能的Node工程,用于验证“失败→跨文件修复→实际测试→审查→Git交付”。本目录是封存输入,不是已完成产品。

仅修改 src/normalize.mjs、src/summary.mjs、src/render.mjs、src/cli.mjs。测试、fixtures、构建脚本、package.json与本文保持原字节。没有第三方依赖。

  1. normalizeTasks接受最多10000项的数组;每项必须是对象,id/title为非空字符串且trim,trim后的id唯一。
  2. status严格限定todo/doing/done/blocked;minutes必须是0到1000000之间的安全整数,拒绝文本、NaN、负数或越界;返回独立的四字段记录,不改变输入对象。
  3. summarize返回total、counts(四种状态都出现)、completedPercent(done/total四舍五入到整数,空数组为0)、remainingMinutes(所有非done记录分钟数之和)。空数组计数全部为0。
  4. renderText精确输出三行:交付进度:D/T(P%)、待办 A · 进行中 B · 已完成 D · 阻塞 C、剩余预计:M 分钟,保持中文可读。
  5. CLI用法 node src/cli.mjs <JSON文件> [--json]。默认输出上述三行加尾换行,--json输出同一个summary的可解析JSON加换行。
  6. 参数缺失、未知选项、无效JSON、无效数据或文件读取失败均以退出码2和stderr中文前缀“输入错误:”报告;stdout为空。成功退出0。
  7. build核对四模块语法并复制到dist。node dist/cli.mjs fixtures/tasks.json --json与源码入口结果一致。

先运行npm test保存真实失败,再修改四个模块;应用提案后重跑npm test与npm run build。验收器另核对保护文件hash、源文件diff和构建入口,不把修改测试或只输出“成功”当交付。