sdd-flow-kit 1.3.15 → 1.3.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/dist/cli.js +16 -0
  2. package/dist/core/acAssertionBinding.js +180 -0
  3. package/dist/core/apiFieldContract.js +90 -0
  4. package/dist/core/apiFieldCoverage.js +335 -0
  5. package/dist/core/componentSubstance.js +172 -0
  6. package/dist/core/demoImplementationCoverage.js +244 -0
  7. package/dist/core/e2eAssertionDepth.js +237 -0
  8. package/dist/core/e2eDemoSignalClicks.js +90 -0
  9. package/dist/core/prdArtifacts.js +12 -1
  10. package/dist/core/prdCoverage.js +52 -36
  11. package/dist/core/prdSemanticDiff.js +7 -4
  12. package/dist/core/snakeCamel.js +93 -0
  13. package/dist/core/syncSourcePrd.js +181 -0
  14. package/dist/core/techDocQuality.js +91 -0
  15. package/dist/core/testAssertionAnalysis.js +213 -0
  16. package/dist/core/visualRegression.js +243 -0
  17. package/dist/core/writeNext.js +1 -1
  18. package/dist/index.js +6 -1
  19. package/dist/steps/runGate.js +49 -5
  20. package/dist/steps/runSyncSourcePrd.js +38 -0
  21. package/dist/steps/runValidate.js +4 -2
  22. package/dist/steps/setupProject.js +3 -0
  23. package/dist/steps/startFlow.js +9 -2
  24. package/package.json +2 -1
  25. package/scripts/assert-active-openspec-change.sh +114 -0
  26. package/scripts/assess-ac-assertion-binding.mjs +104 -0
  27. package/scripts/assess-api-field-contract.mjs +119 -0
  28. package/scripts/assess-api-field-coverage.mjs +88 -0
  29. package/scripts/assess-component-substance.mjs +87 -0
  30. package/scripts/assess-demo-implementation-coverage.mjs +188 -0
  31. package/scripts/assess-e2e-assertion-depth.mjs +162 -0
  32. package/scripts/assess-playwright-e2e-coverage.mjs +244 -0
  33. package/scripts/assess-tech-doc-quality.mjs +98 -0
  34. package/scripts/assess-visual-regression.mjs +92 -0
  35. package/scripts/install-git-hooks.sh +27 -0
  36. package/scripts/lib/ac-assertion-binding.mjs +119 -0
  37. package/scripts/lib/api-field-coverage.mjs +238 -0
  38. package/scripts/lib/component-substance.mjs +117 -0
  39. package/scripts/lib/demo-reference-parse.mjs +55 -0
  40. package/scripts/lib/e2e-demo-signal-clicks.mjs +43 -0
  41. package/scripts/lib/snake-camel.mjs +74 -0
  42. package/scripts/lib/test-assertion-analysis.mjs +148 -0
  43. package/scripts/lib/visual-regression.mjs +191 -0
  44. package/scripts/resolve-playwright-e2e-scope.mjs +248 -0
  45. package/src/templates/artifacts/01-adi-doc-skill-/346/214/207/345/274/225.template.md +6 -2
  46. package/src/templates/artifacts/02-/351/234/200/346/261/202/345/210/206/346/236/220/346/217/220/347/244/272/350/257/215.template.md +5 -0
  47. package/src/templates/artifacts/04-/346/212/200/346/234/257/346/226/207/346/241/243.template.md +22 -0
  48. package/src/templates/artifacts/05-/351/252/214/346/224/266/346/270/205/345/215/225.template.md +4 -3
  49. package/src/templates/artifacts/06-openspec-/346/217/220/346/241/210/350/215/211/347/250/277.template.md +2 -2
  50. package/src/templates/artifacts/07-opsx-auto-chain.template.md +2 -2
  51. package/src/templates/artifacts/08-PRD/344/270/200/350/207/264/346/200/247/345/244/215/346/237/245/346/212/245/345/221/212.template.md +2 -0
  52. package/src/templates/artifacts/design-demo-reference.template.md +24 -0
  53. package/src/templates/artifacts/tests-fixtures-readme.template.md +19 -0
  54. package/src/templates/artifacts/visual-baseline-readme.template.md +28 -0
  55. package/src/templates/prompts/02-sdd-loop-prompt.md +25 -11
  56. package/src/templates/prompts/04-tech-doc-fill-prompt.md +76 -0
  57. package/src/templates/skills/confluence-doc.py.template +64 -25
  58. package/src/templates/skills/demo-reference-mandatory-workflow.md +79 -0
  59. package/src/templates/skills/doc-skill.SKILL.md.template +13 -6
  60. package/src/templates/skills/layered-testing-strategy.md +15 -6
@@ -4,12 +4,21 @@
4
4
 
5
5
  ## 四层模型
6
6
 
7
- | 层级 | 覆盖范围 | 典型断言 | 缺失风险 |
8
- |------|---------|---------|---------|
9
- | **L1 能力** | API、状态机、mapper、脏数据 | 接口封装、枚举映射、mutation 参数 | 主流程不通 |
10
- | **L2 交互契约** | 列序、disabled、toast、tooltip、placeholder | **完整字符串**(禁止 `toContain('成功')`) | PRD 细节漏项 |
11
- | **L3 路径** | 每页面/每主链路一条 E2E | 登录 → 设规则结果页重审 | 只 smoke 一条路径 |
12
- | **L4 视觉** | 原型图 / Figma / `playwright-pic` | 列位置、紫色摘要、布局两行限制 | UI 与原型偏差 |
7
+ | 层级 | 覆盖范围 | 典型断言 | 缺失风险 | 门禁 |
8
+ |------|---------|---------|---------|------|
9
+ | **L1 能力** | API、状态机、mapper、脏数据 | 接口封装、枚举映射、mutation 参数、**snake/camel normalize** + **fixture 字段覆盖** | 主流程不通、列表空数据 | `assess-api-field-contract.mjs` + `assess-api-field-coverage.mjs` + unit |
10
+ | **L2 交互契约** | 列序、disabled、toast、tooltip、placeholder | **完整字符串**(禁止 `toContain('成功')`) | PRD 细节漏项 | AC 映射须 test 块内 `expect` |
11
+ | **L3 路径** | 每页面/每主链路一条 E2E | 登录 → 列表有数据点详情 → **演示映射中的按钮/区块** | 只 smoke placeholder | `assess-e2e-assertion-depth.mjs` |
12
+ | **L3.5 演示迁移** | 演示模块 生产组件 1:1 | design 映射表每行在生产代码有「关键交互信号」+ **非空壳组件** | 单文件只读骨架代替演示 | `assess-demo-implementation-coverage.mjs` + `assess-component-substance.mjs` |
13
+ | **L3.6 AC 断言绑定** | P0 验收标准字面量 | test expect 含 05 原文(禁止模糊 toContain('成功')) | PRD 文案漏测 | `assess-ac-assertion-binding.mjs` |
14
+ | **L3.7 E2E 演示点击** | 映射表中可点击信号 | spec 中 click/getByText 覆盖「编辑/保存/导入」等 | 有按钮无点击 | `assess-e2e-assertion-depth.mjs`(含 demo signal) |
15
+ | **L4 视觉** | 原型图 / PRD 截图 / `visual-baseline` | `toHaveScreenshot` + 基线图 diff≤N% | UI 与原型偏差 | `assess-visual-regression.mjs`(v1.3.21) |
16
+
17
+ ## 禁止伪覆盖
18
+
19
+ - **禁止** `prd-atoms-coverage.spec.ts` 等仅 `toBeGreaterThan(0)` 或注释登记 PRD-ID 的文件计入 semantic/e2e 覆盖。
20
+ - **禁止** 仅 `getByPlaceholder` 可见即宣布列表类 AC 通过;须 `waitForResponse` / `getByRole('cell')` / `toContainText` 等数据断言。
21
+ - **禁止** 用单个 DetailDrawer 只读骨架代替演示中的 BD预估/红票/可编辑金额等子模块;须遵循 `demo-reference-mandatory-workflow` skill。
13
22
 
14
23
  ## 与 05-验收清单的绑定
15
24