ADR-0001：测试先行阶段的技术栈与接口边界（2026-07-30）

状态

已通过，阶段01作为基线构建时采用。

决策

• 核心语言与运行时：TypeScript + Node.js 22 LTS。
• 测试框架：Vitest（统一执行 npm run test 与 npm run test:baseline）。
• 属性测试：fast-check（用于阶段01属性断言与基线数据生成）。
• 模块边界：src/ 放核心领域与公共契约，tests/ 放预写测试与失败清单验证。
• 数据目录初始化和可执行命令：通过 npm scripts 管理。
• 端口策略：文件系统、时钟、uuid 与故障注入作为可替换端口，先做确定性实现并纳入基线测试。

背景

阶段01目标是先冻结完整测试基线，不能在该阶段混入生产行为实现。当前技术栈强调：

• 领域契约可以快速编译；
• 测试可复现、可断言；
• 与目标产品路线（TypeScript SDK、Local Server、CLI、Web UI）一致。