@chenguangyao/devflow-kit 0.1.43

package/src/templates/files/proposal.md

@@ -0,0 +1,33 @@
+---
+slug: ${slug}
+title: ${title}
+level: ${level}
+source: ${source}
+created: ${date}
+status: draft
+---
+
+# ${title}
+
+## 已知信息
+
+- 来源类型:${sourceType}
+- 来源引用:${sourceRef}
+- 建议级别:${level}
+
+## 摘要
+
+> 由 devflow ingest/new 生成的轻量问题卡。这里只保留已知信息，不预先塞空模板。
+
+${summary}
+
+## 待确认问题
+
+- 范围边界是否已经明确？
+- 验收口径是否能用可验证语言表达？
+- 是否已确认涉及项目、接口、数据或配置变更？
+
+## 下一步
+
+- 确认 problem_card checkpoint 后运行 \`devflow requirement\`
+- 有历史背景时再运行 \`devflow knowledge query "<keywords>"\`

package/src/templates/files/reports/contract-test.md

@@ -0,0 +1,40 @@
+---
+slug: ${slug}
+kind: contract
+status: ${status}
+failureType: ${failureType}
+total: ${total}
+passed: ${passed}
+failed: ${failed}
+coverage: ${coverage}
+ts: ${date}
+---
+
+# 调用链一致性验证报告
+
+## 环境信息
+
+| 项 | 值 |
+| --- | --- |
+| API Base URL | ${apiBaseUrl} |
+| 后端地址 | ${backendUrl} |
+| 前端地址 | ${frontendUrl} |
+
+## 命令
+
+```bash
+${command}
+```
+
+## 验证重点
+
+- 接口提供方与调用方字段、枚举、状态语义一致。
+- returnUrl / callback / redirect / query 参数在链路中不丢失、不被错误复用。
+- traceId / requestId 可贯穿入口、服务调用、异步回调和日志检索。
+- YAPI / OpenAPI 契约与实现、测试用例保持一致。
+
+## 输出
+
+```text
+${output}
+```

package/src/templates/files/reports/e2e-test.md

@@ -0,0 +1,30 @@
+---
+slug: ${slug}
+kind: e2e
+status: ${status}
+failureType: ${failureType}
+total: ${total}
+passed: ${passed}
+failed: ${failed}
+ts: ${date}
+---
+
+# 端到端测试报告
+
+## 场景
+
+| ID | 场景 | 结果 | 截图 |
+|----|------|------|------|
+| E-1 | | 通过 / 失败 | screenshots/E-1.png |
+
+## 命令
+
+```
+${command}
+```
+
+## 输出
+
+```
+${output}
+```

package/src/templates/files/reports/integration-test.md

@@ -0,0 +1,36 @@
+---
+slug: ${slug}
+kind: integration
+status: ${status}
+failureType: ${failureType}
+total: ${total}
+passed: ${passed}
+failed: ${failed}
+ts: ${date}
+---
+
+# 集成测试报告
+
+## 环境
+
+- 服务:
+- 数据:
+- 第三方:
+
+## 命令
+
+```
+${command}
+```
+
+## 摘要
+
+- 用例:${total} 通过 ${passed} 失败 ${failed}
+
+## 输出
+
+```
+${output}
+```
+
+## 失败 / 抖动用例

package/src/templates/files/reports/joint-test.md

@@ -0,0 +1,58 @@
+---
+slug: ${slug}
+kind: joint
+status: ${status}
+failureType: ${failureType}
+total: ${total}
+passed: ${passed}
+failed: ${failed}
+ts: ${date}
+---
+
+# 联调测试报告
+
+## 环境信息
+
+| 项目 | 值 |
+|------|-----|
+| 后端地址 | ${backendUrl} |
+| 前端地址 | ${frontendUrl} |
+| 数据库 / Mock | ${database} |
+| 浏览器工具 | ${preflightTool} |
+| 预检结果 | ${preflightStatus} |
+
+## 预检详情
+
+```
+${preflightDetail}
+```
+
+## 执行结果
+
+| 指标 | 值 |
+|------|-----|
+| 总用例数 | ${total} |
+| 通过 | ${passed} |
+| 失败 | ${failed} |
+
+## 用例执行详情
+
+| 测试用例 | 操作步骤 | 结果 | 截图 |
+|----------|----------|------|------|
+| TC-JOINT-1 | 打开页面 -> 操作 -> 验证结果 | 通过 / 失败 | screenshots/TC-JOINT-1.png |
+
+## 命令
+
+```
+${command}
+```
+
+## 输出
+
+```
+${output}
+```
+
+## 失败详情
+
+(若 failed > 0,在此列出失败用例的页面截图、期望行为 vs 实际行为、后端日志定位线索)

package/src/templates/files/reports/perf.md

@@ -0,0 +1,24 @@
+---
+slug: ${slug}
+kind: perf
+status: ${status}
+failureType: ${failureType}
+ts: ${date}
+---
+
+# 性能测试报告
+
+## 指标
+
+| 指标 | 目标 | 实测 | 是否达标 |
+|------|------|------|---------|
+| QPS | | | |
+| P99 | | | |
+| 错误率 | | | |
+
+## 测试脚本 / 输出
+
+```
+${command}
+${output}
+```

package/src/templates/files/reports/regression.md

@@ -0,0 +1,20 @@
+---
+slug: ${slug}
+kind: regression
+status: ${status}
+failureType: ${failureType}
+ts: ${date}
+---
+
+# 回归测试报告
+
+## 范围
+
+- 受影响的旧功能:
+
+## 命令 / 输出
+
+```
+${command}
+${output}
+```

package/src/templates/files/reports/remote-test.md

@@ -0,0 +1,55 @@
+---
+slug: ${slug}
+kind: remote
+status: ${status}
+failureType: ${failureType}
+total: ${total}
+passed: ${passed}
+failed: ${failed}
+ts: ${date}
+---
+
+# 远程 API 测试报告
+
+## 环境信息
+
+| 项目 | 值 |
+|------|-----|
+| 测试环境地址 | ${apiBaseUrl} |
+| 预检结果 | ${preflightStatus} |
+
+## 预检详情
+
+```
+${preflightDetail}
+```
+
+## 执行结果
+
+| 指标 | 值 |
+|------|-----|
+| 总用例数 | ${total} |
+| 通过 | ${passed} |
+| 失败 | ${failed} |
+
+## 用例执行详情
+
+| 测试用例 | 接口 | 方法 | 结果 |
+|----------|------|------|------|
+| TC-REMOTE-1 | /api/example | GET / POST | 通过 / 失败 |
+
+## 命令
+
+```
+${command}
+```
+
+## 输出
+
+```
+${output}
+```
+
+## 失败详情
+
+(若 failed > 0,在此列出失败用例的请求信息、响应状态码、响应体、期望值 vs 实际值)

package/src/templates/files/reports/self-test.md

@@ -0,0 +1,43 @@
+---
+slug: ${slug}
+kind: self-test
+status: ${status}
+ts: ${date}
+acceptance_pass: ${acceptancePass}
+acceptance_total: ${acceptanceTotal}
+---
+
+# 提测自测报告 — ${title}
+
+> 本文件由 \`devflow report self-test\` 生成,会被 \`devflow deliver\` 自动嵌入提测/PR 描述中。
+
+## 一、需求验收
+
+| 验收项 | 结果 | 证据 |
+|--------|------|------|
+| (来自 requirement.md / proposal.md) | 通过 / 失败 | reports/xxx.md |
+
+## 二、测试覆盖
+
+| 类型 | 报告 | 通过率 |
+|------|------|--------|
+| 单元测试 | reports/test-report.md#unit | ${unitPassRate} |
+| 集成测试 | reports/test-report.md#integration | ${integrationPassRate} |
+| 端到端测试 | reports/test-report.md#e2e | ${e2ePassRate} |
+| 联调测试 | reports/test-report.md#joint | ${jointPassRate} |
+| 远程 API | reports/test-report.md#remote | ${remotePassRate} |
+| 冒烟测试 | reports/test-report.md#smoke | ${smokePassRate} |
+
+## 三、风险与遗留
+
+- (已知问题、降级策略、回滚方案)
+
+## 四、配置 / DDL / 环境差异
+
+- DDL:见 \`design.md#ddl\`
+- 配置:列出新增配置项与默认值
+
+## 五、提测结论
+
+- [ ] 通过自测,可提测
+- [ ] 待修复后再次自测

package/src/templates/files/reports/smoke-test.md

@@ -0,0 +1,22 @@
+---
+slug: ${slug}
+kind: smoke
+status: ${status}
+failureType: ${failureType}
+ts: ${date}
+---
+
+# 冒烟测试报告
+
+## 检查项
+
+- [ ] 服务可启动
+- [ ] 关键路径可调通(列出具体接口)
+- [ ] 健康检查 200
+
+## 命令 / 输出
+
+```
+${command}
+${output}
+```

package/src/templates/files/reports/unit-test.md

@@ -0,0 +1,36 @@
+---
+slug: ${slug}
+kind: unit
+status: ${status}
+failureType: ${failureType}
+total: ${total}
+passed: ${passed}
+failed: ${failed}
+coverage: ${coverage}
+ts: ${date}
+---
+
+# 单元测试报告
+
+## 命令
+
+```
+${command}
+```
+
+## 摘要
+
+- 用例总数:${total}
+- 通过:${passed}
+- 失败:${failed}
+- 覆盖率:${coverage}
+
+## 输出
+
+```
+${output}
+```
+
+## 失败用例
+
+(若 failed > 0,在此列出每个失败用例的名称、断言、根因)

package/src/templates/files/requirement.md

@@ -0,0 +1,51 @@
+---
+slug: ${slug}
+phase: requirement
+status: draft
+---
+
+# 结构化需求 — ${title}
+
+## 1. 业务背景
+
+(由 proposal 复用 + 双轮澄清补全)
+
+## 2. 用户故事 / 使用场景
+
+- 作为 ___,我希望 ___,以便 ___
+
+## 3. 功能需求
+
+| ID | 描述 | 优先级 | 验收标准 |
+|----|------|--------|---------|
+| F-1 | | P0 | |
+
+## 4. 非功能需求
+
+- 性能:
+- 安全:
+- 可用性:
+- 可观测:
+
+## 5. 数据/接口影响
+
+- 数据库 DDL:[ ] 无 / [ ] 见 \`design.md#ddl\`
+- 接口契约:[ ] 无 / [ ] 见 \`design.md#contracts\`
+
+## 6. 第一轮澄清(业务)
+
+> 与产品/业务方对齐,Q&A 形式记录
+
+- Q:
+  - A:
+
+## 7. 第二轮澄清(实现)
+
+> 基于代码侦察后,与设计/开发方对齐
+
+- Q:
+  - A:
+
+## 8. 风险与待决项
+
+- [ ]

package/src/templates/files/review.md

@@ -0,0 +1,38 @@
+---
+slug: ${slug}
+phase: review
+status: draft
+iteration: 0
+---
+
+# 代码审查 — ${title}
+
+## 第 0 轮:初始提交
+
+- commit: (待填)
+- 摘要:
+
+## 审查发现
+
+| ID | 等级 | 文件 | 描述 | 状态 |
+|----|------|------|------|------|
+| R-1 | 阻断 / 严重 / 轻微 | | | 未处理 / 已解决 |
+
+## 第 1~3 轮迭代
+
+> 最多 3 轮 review-bugfix 闭环,超过即升级 design.md 重新评审
+
+### 第 1 轮
+
+- 修复了:R-1, R-2
+- 引入新发现:
+
+### 第 2 轮
+
+### 第 3 轮
+
+## 验收
+
+- [ ] 所有阻断问题已修复
+- [ ] 所有测试通过
+- [ ] 无新增技术债

package/src/templates/files/tests.md

@@ -0,0 +1,36 @@
+---
+slug: ${slug}
+phase: tests
+status: draft
+---
+
+# 测试用例 — ${title}
+
+## 用例索引
+
+| ID | 类型 | 名称 | 优先级 |
+|----|------|------|--------|
+| TC-001 | 单元测试 | | P0 |
+| TC-002 | 集成测试 | | P0 |
+| TC-003 | 端到端测试 | | P1 |
+
+## TC-001 (用例名)
+
+- 类型:单元测试
+- 前置条件:
+- 步骤:
+  1. ...
+- 预期:
+- 关联需求:F-1
+
+## TC-002
+
+(同上)
+
+## 数据准备
+
+- (sql/mock 数据描述)
+
+## 环境
+
+- (依赖服务、版本)

package/src/templates/files/verify.md

@@ -0,0 +1,32 @@
+---
+slug: ${slug}
+phase: verify
+status: draft
+overall: pending
+---
+
+# 验证报告 — ${title}
+
+## 总结
+
+| 维度 | 状态 | 报告 |
+|------|------|------|
+| 单元测试 | – | reports/test-report.md#unit |
+| 集成测试 | – | reports/test-report.md#integration |
+| 端到端 | – | reports/test-report.md#e2e |
+| 冒烟 | – | reports/test-report.md#smoke |
+| 自测(提测) | – | reports/test-report.md#self-test |
+| 回归 | – | reports/test-report.md#regression |
+| 性能 | – | reports/test-report.md#perf |
+
+## 验收清单(对齐 requirement.md)
+
+- [ ] F-1
+- [ ] F-2
+
+## 风险与遗留
+
+## 结论
+
+- [ ] 通过,可进入 \`devflow deliver\`
+- [ ] 不通过,回退到:

package/src/templates/index.js

@@ -0,0 +1,21 @@
+'use strict';
+const fs = require('fs/promises');
+const path = require('path');
+
+const ROOT = __dirname;
+
+function render(tpl, vars) {
+  return tpl.replace(/\$\{(\w+)\}/g, (m, k) => (vars && vars[k] !== undefined ? String(vars[k]) : ''));
+}
+
+async function load(name) {
+  const file = path.join(ROOT, 'files', name);
+  return fs.readFile(file, 'utf8');
+}
+
+async function renderFile(name, vars) {
+  const tpl = await load(name);
+  return render(tpl, vars || {});
+}
+
+module.exports = { render, load, renderFile, ROOT };

package/src/utils/log.js

@@ -0,0 +1,37 @@
+'use strict';
+// Minimal ANSI-colored logger. No external deps.
+
+const isTTY = process.stdout && process.stdout.isTTY;
+const NO_COLOR = process.env.NO_COLOR === '1' || process.env.NO_COLOR === 'true';
+const useColor = isTTY && !NO_COLOR;
+
+function paint(code, msg) {
+  if (!useColor) return msg;
+  return `\x1b[${code}m${msg}\x1b[0m`;
+}
+
+const colors = {
+  dim: (s) => paint('2', s),
+  red: (s) => paint('31', s),
+  green: (s) => paint('32', s),
+  yellow: (s) => paint('33', s),
+  blue: (s) => paint('34', s),
+  magenta: (s) => paint('35', s),
+  cyan: (s) => paint('36', s),
+  bold: (s) => paint('1', s),
+};
+
+function tag(label, color) {
+  return `[${colors[color](label)}]`;
+}
+
+module.exports = {
+  colors,
+  info: (msg) => console.log(`${tag('df', 'cyan')} ${msg}`),
+  ok: (msg) => console.log(`${tag('ok', 'green')} ${msg}`),
+  warn: (msg) => console.warn(`${tag('warn', 'yellow')} ${msg}`),
+  error: (msg) => console.error(`${tag('error', 'red')} ${msg}`),
+  step: (label, msg) => console.log(`${tag(label, 'magenta')} ${msg}`),
+  dim: (msg) => console.log(colors.dim(msg)),
+  raw: (msg) => console.log(msg),
+};