@epoint-testtech/ep-stage-skill 0.0.4-alpha.0 → 0.0.5

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 (206) hide show
  1. package/SKILL.md +27 -27
  2. package/codex-skill/ep-stage/glue-create-project/SKILL.md +223 -186
  3. package/codex-skill/ep-stage/glue-generate-testcase/SKILL.md +275 -199
  4. package/codex-skill/ep-stage/glue-generate-testcase/examples/observable-testcase.json +40 -40
  5. package/codex-skill/ep-stage/glue-generate-testcase/references/testcase-schema.md +95 -112
  6. package/codex-skill/ep-stage/glue-generate-testcase/references/testcase-tpl.md +72 -0
  7. package/codex-skill/ep-stage/glue-run-test/SKILL.md +292 -249
  8. package/codex-skill/ep-stage/glue-run-test/references/ai-runtime-loop.md +30 -0
  9. package/codex-skill/ep-stage/glue-run-test/references/crud-pipeline.md +132 -145
  10. package/codex-skill/ep-stage/glue-run-test/references/gap-review-protocol.md +44 -43
  11. package/codex-skill/ep-stage/glue-run-test/references/harness-principles.md +46 -46
  12. package/codex-skill/ep-stage/glue-run-test/references/playwright-cli-odav.md +166 -0
  13. package/codex-skill/ep-stage/glue-run-test/scripts/extract-page-elements-eval.mjs +233 -0
  14. package/codex-skill/ep-stage/glue-run-test/scripts/generate-crud-spec.mjs +149 -149
  15. package/codex-skill/ep-stage/page-element-scan/SKILL.md +91 -0
  16. package/codex-skill/ep-stage/page-element-scan/evals/evals.json +37 -0
  17. package/codex-skill/ep-stage/page-element-scan/evals/fixtures/sample-list-page.html +85 -0
  18. package/codex-skill/ep-stage/page-element-scan/references/pagination-controls.md +153 -0
  19. package/codex-skill/ep-stage/page-element-scan/scripts/extract-page-elements-eval.mjs +233 -0
  20. package/codex-skill/ep-stage/page-element-scan/scripts/extract-page-elements.mjs +298 -0
  21. package/codex-skill/ep-stage/page-element-scan/scripts/scan-page.mjs +749 -0
  22. package/codex-skill/ep-stage/recording-to-glue/SKILL.md +28 -28
  23. package/codex-skill/ep-stage/scripts/validate-skill.mjs +98 -95
  24. package/dist/src/cli/generate-testcase.d.ts +18 -51
  25. package/dist/src/cli/generate-testcase.d.ts.map +1 -1
  26. package/dist/src/cli/generate-testcase.js +127 -131
  27. package/dist/src/cli/index.d.ts +11 -2
  28. package/dist/src/cli/index.d.ts.map +1 -1
  29. package/dist/src/cli/index.js +49 -16
  30. package/dist/src/cli/probe.d.ts +2 -0
  31. package/dist/src/cli/probe.d.ts.map +1 -1
  32. package/dist/src/cli/probe.js +239 -13
  33. package/dist/src/cli/run.d.ts +136 -29
  34. package/dist/src/cli/run.d.ts.map +1 -1
  35. package/dist/src/cli/run.js +494 -65
  36. package/dist/src/cli/spec.d.ts +18 -11
  37. package/dist/src/cli/spec.d.ts.map +1 -1
  38. package/dist/src/cli/spec.js +74 -20
  39. package/dist/src/contracts/crud-business-module.d.ts +6 -0
  40. package/dist/src/contracts/crud-business-module.d.ts.map +1 -1
  41. package/dist/src/contracts/glue-contract-v1.d.ts +98 -0
  42. package/dist/src/contracts/glue-contract-v1.d.ts.map +1 -0
  43. package/dist/src/contracts/glue-contract-v1.js +9 -0
  44. package/dist/src/contracts/inference-trace.d.ts +223 -0
  45. package/dist/src/contracts/inference-trace.d.ts.map +1 -0
  46. package/dist/src/contracts/inference-trace.js +12 -0
  47. package/dist/src/contracts/observable-chain.d.ts +4 -0
  48. package/dist/src/contracts/observable-chain.d.ts.map +1 -1
  49. package/dist/src/extractors/code-list-json5.d.ts +192 -0
  50. package/dist/src/extractors/code-list-json5.d.ts.map +1 -0
  51. package/dist/src/extractors/code-list-json5.js +91 -0
  52. package/dist/src/extractors/code-list.d.ts +3 -3
  53. package/dist/src/extractors/code-list.d.ts.map +1 -1
  54. package/dist/src/extractors/code-list.js +46 -11
  55. package/dist/src/extractors/html-page.d.ts +9 -0
  56. package/dist/src/extractors/html-page.d.ts.map +1 -1
  57. package/dist/src/extractors/html-page.js +26 -2
  58. package/dist/src/extractors/prd-extractor.d.ts +70 -0
  59. package/dist/src/extractors/prd-extractor.d.ts.map +1 -0
  60. package/dist/src/extractors/prd-extractor.js +248 -0
  61. package/dist/src/generators/agent-inferred-workflow-script.js +66 -66
  62. package/dist/src/generators/stage-skeleton-script.d.ts +87 -20
  63. package/dist/src/generators/stage-skeleton-script.d.ts.map +1 -1
  64. package/dist/src/generators/stage-skeleton-script.js +656 -238
  65. package/dist/src/index.d.ts +7 -2
  66. package/dist/src/index.d.ts.map +1 -1
  67. package/dist/src/index.js +3 -1
  68. package/dist/src/inference/module-hints-inference.d.ts +30 -0
  69. package/dist/src/inference/module-hints-inference.d.ts.map +1 -0
  70. package/dist/src/inference/module-hints-inference.js +363 -0
  71. package/dist/src/inference/source-analysis.d.ts +26 -0
  72. package/dist/src/inference/source-analysis.d.ts.map +1 -0
  73. package/dist/src/inference/source-analysis.js +258 -0
  74. package/dist/src/normalizers/crud-contract.d.ts +3 -0
  75. package/dist/src/normalizers/crud-contract.d.ts.map +1 -1
  76. package/dist/src/normalizers/crud-contract.js +3 -0
  77. package/dist/src/runtime/ai-runtime-trace.d.ts +88 -0
  78. package/dist/src/runtime/ai-runtime-trace.d.ts.map +1 -0
  79. package/dist/src/runtime/ai-runtime-trace.js +119 -0
  80. package/dist/src/testcase/button-interaction-inference.d.ts +37 -0
  81. package/dist/src/testcase/button-interaction-inference.d.ts.map +1 -0
  82. package/dist/src/testcase/button-interaction-inference.js +385 -0
  83. package/dist/src/testcase/contract-testcase-assembler.d.ts +44 -0
  84. package/dist/src/testcase/contract-testcase-assembler.d.ts.map +1 -0
  85. package/dist/src/testcase/contract-testcase-assembler.js +806 -0
  86. package/dist/src/testcase/prd-button-mapper.d.ts +72 -0
  87. package/dist/src/testcase/prd-button-mapper.d.ts.map +1 -0
  88. package/dist/src/testcase/prd-button-mapper.js +148 -0
  89. package/dist/src/testcase/runtime-context.d.ts +9 -0
  90. package/dist/src/testcase/runtime-context.d.ts.map +1 -0
  91. package/dist/src/testcase/runtime-context.js +1 -0
  92. package/dist/src/testcase/test-access.d.ts +38 -0
  93. package/dist/src/testcase/test-access.d.ts.map +1 -0
  94. package/dist/src/testcase/test-access.js +106 -0
  95. package/dist/src/testcase/testcase-execution-fields.d.ts +10 -0
  96. package/dist/src/testcase/testcase-execution-fields.d.ts.map +1 -0
  97. package/dist/src/testcase/testcase-execution-fields.js +1 -0
  98. package/dist/src/testcase/testcase-generator.d.ts.map +1 -1
  99. package/dist/src/testcase/testcase-generator.js +6 -0
  100. package/dist/src/testcase/testcase-markdown.d.ts +11 -0
  101. package/dist/src/testcase/testcase-markdown.d.ts.map +1 -0
  102. package/dist/src/testcase/testcase-markdown.js +181 -0
  103. package/dist/src/testcase/testcase-skeleton.d.ts +4 -0
  104. package/dist/src/testcase/testcase-skeleton.d.ts.map +1 -1
  105. package/dist/src/testcase/testcase-spec-assembly.d.ts +4 -0
  106. package/dist/src/testcase/testcase-spec-assembly.d.ts.map +1 -1
  107. package/dist/src/testcase/testcase-v1-draft.d.ts +58 -0
  108. package/dist/src/testcase/testcase-v1-draft.d.ts.map +1 -0
  109. package/dist/src/testcase/testcase-v1-draft.js +13 -0
  110. package/dist/src/validation/contract.d.ts +14 -0
  111. package/dist/src/validation/contract.d.ts.map +1 -0
  112. package/dist/src/validation/contract.js +132 -0
  113. package/dist/src/validation/credentials.d.ts +7 -2
  114. package/dist/src/validation/credentials.d.ts.map +1 -1
  115. package/dist/src/validation/credentials.js +15 -4
  116. package/dist/src/validation/index.d.ts +2 -0
  117. package/dist/src/validation/index.d.ts.map +1 -1
  118. package/dist/src/validation/index.js +2 -0
  119. package/dist/src/validation/inference-trace.d.ts +13 -0
  120. package/dist/src/validation/inference-trace.d.ts.map +1 -0
  121. package/dist/src/validation/inference-trace.js +31 -0
  122. package/dist/src/validation/testcase.d.ts +9 -7
  123. package/dist/src/validation/testcase.d.ts.map +1 -1
  124. package/dist/src/validation/testcase.js +181 -34
  125. package/docs/README.md +124 -134
  126. package/docs/mvp-usage-guide.md +298 -298
  127. package/examples/schemeresource-observable-docs/schemeresource.context.md +20 -20
  128. package/examples/schemeresource.module-hints.json +38 -38
  129. package/examples/schemeresource.observable.code_list.md +37 -37
  130. package/examples/zwplace-observable-docs/zwplace.context.md +16 -16
  131. package/examples/zwplace-placecategory-validation.json +29 -29
  132. package/examples/zwplace.module-hints.json +69 -69
  133. package/examples/zwplace.observable.code_list.md +37 -37
  134. package/package.json +2 -2
  135. package/dist/test/cli/extract-contract.test.d.ts +0 -2
  136. package/dist/test/cli/extract-contract.test.d.ts.map +0 -1
  137. package/dist/test/cli/extract-contract.test.js +0 -32
  138. package/dist/test/cli/generate-testcase.test.d.ts +0 -2
  139. package/dist/test/cli/generate-testcase.test.d.ts.map +0 -1
  140. package/dist/test/cli/generate-testcase.test.js +0 -130
  141. package/dist/test/cli/index.test.d.ts +0 -2
  142. package/dist/test/cli/index.test.d.ts.map +0 -1
  143. package/dist/test/cli/index.test.js +0 -93
  144. package/dist/test/cli/run.test.d.ts +0 -2
  145. package/dist/test/cli/run.test.d.ts.map +0 -1
  146. package/dist/test/cli/run.test.js +0 -149
  147. package/dist/test/cli/spec.test.d.ts +0 -2
  148. package/dist/test/cli/spec.test.d.ts.map +0 -1
  149. package/dist/test/cli/spec.test.js +0 -196
  150. package/dist/test/crud-contract.test.d.ts +0 -2
  151. package/dist/test/crud-contract.test.d.ts.map +0 -1
  152. package/dist/test/crud-contract.test.js +0 -819
  153. package/dist/test/gap-inference.test.d.ts +0 -2
  154. package/dist/test/gap-inference.test.d.ts.map +0 -1
  155. package/dist/test/gap-inference.test.js +0 -597
  156. package/dist/test/generalization.test.d.ts +0 -2
  157. package/dist/test/generalization.test.d.ts.map +0 -1
  158. package/dist/test/generalization.test.js +0 -73
  159. package/dist/test/material-inventory.test.d.ts +0 -2
  160. package/dist/test/material-inventory.test.d.ts.map +0 -1
  161. package/dist/test/material-inventory.test.js +0 -141
  162. package/dist/test/observable-chain.test.d.ts +0 -2
  163. package/dist/test/observable-chain.test.d.ts.map +0 -1
  164. package/dist/test/observable-chain.test.js +0 -123
  165. package/dist/test/observable-pipeline.test.d.ts +0 -2
  166. package/dist/test/observable-pipeline.test.d.ts.map +0 -1
  167. package/dist/test/observable-pipeline.test.js +0 -461
  168. package/dist/test/page-structure.test.d.ts +0 -2
  169. package/dist/test/page-structure.test.d.ts.map +0 -1
  170. package/dist/test/page-structure.test.js +0 -45
  171. package/dist/test/scenario-inference.test.d.ts +0 -2
  172. package/dist/test/scenario-inference.test.d.ts.map +0 -1
  173. package/dist/test/scenario-inference.test.js +0 -73
  174. package/dist/test/stage-context.test.d.ts +0 -2
  175. package/dist/test/stage-context.test.d.ts.map +0 -1
  176. package/dist/test/stage-context.test.js +0 -395
  177. package/dist/test/testcase-generator.test.d.ts +0 -2
  178. package/dist/test/testcase-generator.test.d.ts.map +0 -1
  179. package/dist/test/testcase-generator.test.js +0 -276
  180. package/dist/test/testcase-skeleton.test.d.ts +0 -2
  181. package/dist/test/testcase-skeleton.test.d.ts.map +0 -1
  182. package/dist/test/testcase-skeleton.test.js +0 -185
  183. package/dist/test/testcase-spec-assembly.test.d.ts +0 -2
  184. package/dist/test/testcase-spec-assembly.test.d.ts.map +0 -1
  185. package/dist/test/testcase-spec-assembly.test.js +0 -105
  186. package/dist/test/util/credentials.test.d.ts +0 -2
  187. package/dist/test/util/credentials.test.d.ts.map +0 -1
  188. package/dist/test/util/credentials.test.js +0 -64
  189. package/dist/test/util/i18n-testcase.test.d.ts +0 -2
  190. package/dist/test/util/i18n-testcase.test.d.ts.map +0 -1
  191. package/dist/test/util/i18n-testcase.test.js +0 -119
  192. package/dist/test/util/softlink.test.d.ts +0 -2
  193. package/dist/test/util/softlink.test.d.ts.map +0 -1
  194. package/dist/test/util/softlink.test.js +0 -82
  195. package/dist/test/validation/credentials.test.d.ts +0 -2
  196. package/dist/test/validation/credentials.test.d.ts.map +0 -1
  197. package/dist/test/validation/credentials.test.js +0 -72
  198. package/dist/test/validation/projects-index.test.d.ts +0 -2
  199. package/dist/test/validation/projects-index.test.d.ts.map +0 -1
  200. package/dist/test/validation/projects-index.test.js +0 -48
  201. package/dist/test/validation/testcase.test.d.ts +0 -2
  202. package/dist/test/validation/testcase.test.d.ts.map +0 -1
  203. package/dist/test/validation/testcase.test.js +0 -129
  204. package/dist/vitest.config.d.ts +0 -3
  205. package/dist/vitest.config.d.ts.map +0 -1
  206. package/dist/vitest.config.js +0 -7
@@ -1,9 +1,14 @@
1
- import { mkdirSync, writeFileSync } from 'node:fs';
1
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
2
+ import os from 'node:os';
2
3
  import path from 'node:path';
3
4
  import JSON5 from 'json5';
4
- import { runProbeAndCoverage } from './probe.js';
5
5
  import { createSoftlinkWithFallback } from '../util/softlink.js';
6
- import { i18nTestcase } from '../util/i18n-testcase.js';
6
+ import { extractCodeListJson5, assertCodeListJson5Path } from '../extractors/code-list-json5.js';
7
+ import { assembleJson5ContractAndTestcase } from '../testcase/contract-testcase-assembler.js';
8
+ import { renderUnifiedTestcaseMarkdown } from '../testcase/testcase-markdown.js';
9
+ import { validateContract } from '../validation/contract.js';
10
+ import { validateTestcase } from '../validation/testcase.js';
11
+ import { writeProjectIndex } from '../context/stage-context.js';
7
12
  /**
8
13
  * 解析 testcase 子命令参数。
9
14
  *
@@ -29,169 +34,160 @@ export function parseGenerateTestcaseArgs(argv) {
29
34
  return {
30
35
  codeList: result['code-list'],
31
36
  testsDir: result['tests-dir'],
32
- scenario: result.scenario,
33
- hints: result.hints,
34
37
  projectDir: result['project-dir'],
35
38
  requirementDir: result['requirement-dir'],
39
+ directUrl: result['direct-url'],
40
+ sourceRoot: result['source-root'],
36
41
  };
37
42
  }
38
43
  /**
39
- * scenario 3 档决策(REQ-SCENE-01):
40
- * 1. --scenario CLI 参数(最高优先级)
41
- * 2. ModuleHints 文件路径包含 `scenario=<value>` 字串(粗推断)
42
- * 3. 默认 "crud.single-page"(与 i18n 表 / skeleton scenario 一致)
44
+ * 渲染 credentials.template.json5 数组内容。
45
+ * 每条对应一个 role,url/systemName 复用 code_list.systems[0](多系统场景由用户补齐)。
43
46
  *
44
- * @param args - 解析后的参数。
45
- * @returns 决策结果。
47
+ * @param codeList - code_list 解析产出。
48
+ * @returns JSON5 字符串。
46
49
  */
47
- export function decideScenario(args) {
48
- if (args.scenario)
49
- return args.scenario;
50
- if (args.hints && args.hints.includes('scenario=')) {
51
- const inferred = args.hints.split('scenario=')[1]?.split(/\s|,/)[0];
52
- if (inferred)
53
- return inferred;
54
- }
55
- return 'crud.single-page';
50
+ function renderCredentialsTemplate(codeList, directUrl) {
51
+ const baseSystem = codeList.systems[0]?.name ?? '';
52
+ // 字段命名对齐 stage-core Credential type:`url` = 登录页 URL(stage-core 消费入口,
53
+ // 用于 process.env.LOGIN_SYSTEM_URL);`directUrl` = 待测页面直达链接(应用侧读,
54
+ // spec openModule 用 loginPage.gotoDirectUrl 消费)。旧 template 用 loginUrl 会
55
+ // 导致 stage-core loadCredentials 解析到的 credential.url=undefined、下游 goto("undefined") 失败。
56
+ const loginUrl = codeList.systems[0]?.defaultLoginUrl ?? '';
57
+ const entries = codeList.roles.length > 0
58
+ ? codeList.roles.map((role) => ({
59
+ directUrl,
60
+ url: loginUrl,
61
+ systemName: role.systemName || baseSystem,
62
+ role: role.role,
63
+ username: '',
64
+ password: '',
65
+ }))
66
+ : (codeList.requirement?.businessRoles ?? []).map((role) => ({
67
+ directUrl,
68
+ url: loginUrl,
69
+ systemName: baseSystem,
70
+ role: role.label,
71
+ username: '',
72
+ password: '',
73
+ }));
74
+ return `${JSON5.stringify(entries, null, 2)}\n`;
56
75
  }
57
76
  /**
58
- * TestcaseV2 渲染成中文 testcase.md(REQ-UX-03)。
77
+ * projects.index.json5 对应 project 的 requirements[] 追加(去重)一条需求条目。
59
78
  *
60
79
  * 设计:
61
- * - 字段名 / 状态值通过 i18nTestcase() 翻译;
62
- * - `unresolved` 字段标题硬编码「未确认项」(i18n 表中 `unresolved` 解析为状态值「未解决」);
63
- * - 每次重跑覆盖(REQ-DATA-03 由调用方 writeFileSync 触发)。
80
+ * - index 时同时保留 systems[](writeProjectIndex 整体覆写,丢失 systems 会丢凭据缓存);
81
+ * - projectDir 精确匹配 project,找不到抛中文错误引导先跑 /glue-create-project;
82
+ * - name requirement 去重:存在则更新 requirementDir/testsDir/lastRunStatus,不存在则追加。
64
83
  *
65
- * @param testcase - TestcaseV2 顶层结构。
66
- * @returns Markdown 文本。
84
+ * @param input - projectDir / requirementName / requirementDir / testsDir / homeDir。
85
+ * @returns 写入后的索引文件路径。
86
+ * @throws projectDir 不在 index 时抛中文错误。
67
87
  */
68
- export function renderTestcaseMarkdown(testcase) {
69
- const lines = [];
70
- lines.push(`# ${testcase.moduleName} 胶水测试用例`);
71
- lines.push('');
72
- lines.push(`- 模块 ID:${testcase.moduleId}`);
73
- lines.push(`- ${i18nTestcase('scenario')}:${i18nTestcase(testcase.scenario)}`);
74
- lines.push(`- ${i18nTestcase('menuPath')}:${testcase.menuPath || '(未填写)'}`);
75
- lines.push(`- ${i18nTestcase('requiredSystems')}:${testcase.requiredSystems.map((s) => s.url || '(待填写)').join(',')}`);
76
- lines.push(`- ${i18nTestcase('requiredRoles')}:${testcase.requiredRoles.map((r) => r.role).join(',')}`);
77
- lines.push('');
78
- lines.push(`## ${i18nTestcase('coveredActions')}`);
79
- if (testcase.coveredActions.length === 0)
80
- lines.push('(无)');
81
- for (const action of testcase.coveredActions) {
82
- lines.push(`- ${action.actionId}(${action.kind})证据:${action.evidence.join(' / ')}`);
88
+ function appendRequirementToProjectIndex(input) {
89
+ const homeDir = input.homeDir ?? os.homedir();
90
+ const indexPath = path.join(homeDir, '.ep-stage', 'projects.index.json5');
91
+ let parsed;
92
+ if (existsSync(indexPath)) {
93
+ parsed = JSON5.parse(readFileSync(indexPath, 'utf8'));
94
+ parsed.projects = parsed.projects ?? [];
95
+ parsed.systems = parsed.systems ?? [];
83
96
  }
84
- lines.push('');
85
- lines.push(`## ${i18nTestcase('uncoveredCandidates')}`);
86
- if (testcase.uncoveredCandidates.length === 0)
87
- lines.push('(无)');
88
- for (const cand of testcase.uncoveredCandidates) {
89
- lines.push(`- ${cand.actionId} ${cand.label}|状态:${i18nTestcase(cand.status)}|${i18nTestcase('requiredRole')}:${cand.requiredRole}`);
90
- lines.push(` - ${i18nTestcase('businessIntent')}:${cand.businessIntent}`);
91
- lines.push(` - ${i18nTestcase('assertionExpectation')}:${cand.assertionExpectation}`);
92
- lines.push(` - ${i18nTestcase('evidence')}:${cand.evidence.join(' / ')}`);
97
+ else {
98
+ parsed = { projects: [], systems: [] };
93
99
  }
94
- lines.push('');
95
- lines.push('## 用例');
96
- for (const c of testcase.cases) {
97
- lines.push(`### ${c.title}(${i18nTestcase('caseId')}:${c.caseId})`);
98
- lines.push(`- ${i18nTestcase('scenario')}:${i18nTestcase(c.scenario)}|${i18nTestcase('reviewStatus')}:${i18nTestcase(c.reviewStatus)}|${i18nTestcase('requiredRole')}:${c.requiredRole}`);
99
- lines.push(`- ${i18nTestcase('evidence')}:${c.evidence.join(' / ')}`);
100
- lines.push('- 步骤:');
101
- for (const s of c.steps)
102
- lines.push(` 1. ${s}`);
103
- lines.push('- 断言:');
104
- for (const a of c.assertions)
105
- lines.push(` - ${a}`);
106
- // 硬编码标题「未确认项」:i18nTestcase('unresolved') 返回状态值「未解决」(spec §4.6 trade-off)。
107
- lines.push(`- 未确认项:${c.unresolved.length === 0 ? '(无)' : c.unresolved.join(';')}`);
108
- lines.push('');
100
+ const targetProjectDir = path.resolve(input.projectDir);
101
+ const projectIdx = parsed.projects.findIndex((p) => path.resolve(p.projectDir) === targetProjectDir);
102
+ if (projectIdx === -1) {
103
+ throw new Error(`未在 ~/.ep-stage/projects.index.json5 找到 projectDir=${input.projectDir} 的 glue 项目,请先跑 /glue-create-project 创建脚手架`);
109
104
  }
110
- lines.push('## 推理摘要');
111
- lines.push(testcase.reasoningSummary.conclusion);
112
- lines.push('');
113
- lines.push('证据链:');
114
- for (const ev of testcase.reasoningSummary.evidenceChain)
115
- lines.push(`- ${ev}`);
116
- return `${lines.join('\n').trimEnd()}\n`;
117
- }
118
- /**
119
- * 渲染 credentials.template.json5 数组内容。每条对应 requiredRoles[i],
120
- * url/systemName 复用 requiredSystems[0](多系统场景由用户手工补齐)。
121
- *
122
- * @param testcase - TestcaseV2。
123
- * @returns JSON5 字符串。
124
- */
125
- function renderCredentialsTemplate(testcase) {
126
- const baseUrl = testcase.requiredSystems[0]?.url ?? '';
127
- const baseSystem = testcase.requiredSystems[0]?.systemName ?? '';
128
- const entries = testcase.requiredRoles.map((roleEntry) => ({
129
- url: baseUrl,
130
- username: '',
131
- password: '',
132
- role: roleEntry.role,
133
- systemName: baseSystem,
134
- }));
135
- return `${JSON5.stringify(entries, null, 2)}\n`;
105
+ const projects = parsed.projects;
106
+ const project = projects[projectIdx];
107
+ project.requirements = project.requirements ?? [];
108
+ const entry = {
109
+ name: input.requirementName,
110
+ requirementDir: input.requirementDir,
111
+ testsDir: input.testsDir,
112
+ lastRunStatus: 'never',
113
+ };
114
+ const existIdx = project.requirements.findIndex((r) => r.name === entry.name);
115
+ if (existIdx >= 0) {
116
+ project.requirements[existIdx] = entry;
117
+ }
118
+ else {
119
+ project.requirements.push(entry);
120
+ }
121
+ return writeProjectIndex({ homeDir, projects, systems: parsed.systems });
136
122
  }
137
123
  /**
138
- * testcase 子命令主体(REQ-CHAIN-01 / REQ-CHAIN-02 / REQ-SCENE-01 / REQ-DATA-02)。
124
+ * testcase 子命令主体(JSON5 新产线,Task 3)。
139
125
  *
140
126
  * 流程:
141
- * 1. 决定 scenario(3 档优先级,写入 testcase 顶层 scenario 字段);
142
- * 2. runProbeAndCoverage 钻探上游物料 + 装配 TestcaseV2
143
- * 3. 落盘 testcase.json5 + testcase.md(中文 i18n) + credentials.template.json5;
144
- * 4. 软链上游 code_list.md <tests-dir>/code_list.md;
145
- * 5. 返回推断结果(供 skill Step 5 交互确认 systemUrl / credentialsCache 命中)。
146
- *
147
- * 注意:contract 提取通过 probe 内部完成,不直接复用 dev/extract-contract.ts 的 CLI 入口
148
- * (probe + extract-contract 共享同一组 buildCrudBusinessModuleContract + extractor 依赖,
149
- * 二者各自负责自己的 I/O 边界,保持职责单一)。
127
+ * 1. extractCodeListJson5 解析 code_list.json5;
128
+ * 2. assembleJson5ContractAndTestcase 装配 contract + testcase + inference-trace
129
+ * 3. validateContract / validateTestcase schema 门禁;
130
+ * 4. 落盘 .ep-stage/contract.json5 + testcase.json5 + .ep-stage/inference-trace.json +
131
+ * credentials.template.json5 + testcase.md;软链 code_list.json5;
132
+ * 5. 可选回写 projects.index.json5(仅当显式传入 projectDir)。
150
133
  *
151
134
  * @param args - 已解析参数。
152
- * @returns 产物路径 + 推断结果。
135
+ * @returns 产物路径。
153
136
  */
154
137
  export function runGenerateTestcase(args) {
155
- const scenario = decideScenario(args);
138
+ // 路径硬校验:必须是 .json5(拒绝旧 code_list.md)。
139
+ assertCodeListJson5Path(args.codeList);
156
140
  mkdirSync(args.testsDir, { recursive: true });
157
141
  const requirementDir = args.requirementDir ?? path.dirname(args.codeList);
158
- const docsDir = requirementDir;
159
- const webappDir = path.join(requirementDir, 'src/main/webapp');
160
- const javaActionsDir = path.join(requirementDir, 'src/main/java');
161
- const moduleId = path.basename(args.testsDir);
162
- const { contract, testcaseV2 } = runProbeAndCoverage({
163
- moduleId,
164
- codeListPath: args.codeList,
165
- docsDir,
166
- webappDir,
167
- javaActionsDir,
168
- hintsPath: args.hints,
169
- scenario,
142
+ const codeList = extractCodeListJson5(args.codeList);
143
+ const listPage = codeList.pages.find((page) => page.role === 'list');
144
+ const directUrl = args.directUrl ?? listPage?.directUrl;
145
+ if (!directUrl) {
146
+ throw new Error('缺少待测页面 directUrl:请在 /glue-generate-testcase 交互中提供列表页直达地址,或在 code_list.json5 的 pages[role=list].directUrl 中提供。');
147
+ }
148
+ const { contract, testcase, inferenceTrace } = assembleJson5ContractAndTestcase({
149
+ codeList,
150
+ directUrl,
151
+ sourceRoot: args.sourceRoot,
170
152
  });
153
+ if (args.projectDir) {
154
+ testcase.runtimeContext = {
155
+ testProjectDir: args.projectDir,
156
+ caseDir: args.testsDir,
157
+ specPath: path.join(args.testsDir, 'crud.spec.ts'),
158
+ };
159
+ }
160
+ // schema 门禁(破旧立新,结构错直接抛)。
161
+ validateContract(contract);
162
+ validateTestcase(testcase);
171
163
  const epStageDir = path.join(args.testsDir, '.ep-stage');
172
164
  mkdirSync(epStageDir, { recursive: true });
173
- const contractPath = path.join(epStageDir, 'contract.json');
165
+ const contractPath = path.join(epStageDir, 'contract.json5');
166
+ const inferenceTracePath = path.join(epStageDir, 'inference-trace.json');
174
167
  const testcasePath = path.join(args.testsDir, 'testcase.json5');
175
168
  const testcaseMdPath = path.join(args.testsDir, 'testcase.md');
176
169
  const credentialsTemplatePath = path.join(args.testsDir, 'credentials.template.json5');
177
- const credentialsActualPath = path.join(args.testsDir, 'credentials.json5');
178
- // 落盘 contract.json spec / run 子命令复用(避免重复钻探)。
179
- writeFileSync(contractPath, `${JSON.stringify(contract, null, 2)}\n`, 'utf8');
180
- writeFileSync(testcasePath, `${JSON5.stringify(testcaseV2, null, 2)}\n`, 'utf8');
181
- writeFileSync(credentialsTemplatePath, renderCredentialsTemplate(testcaseV2), 'utf8');
182
- writeFileSync(testcaseMdPath, renderTestcaseMarkdown(testcaseV2), 'utf8');
183
- createSoftlinkWithFallback(args.codeList, path.join(args.testsDir, 'code_list.md'));
170
+ writeFileSync(contractPath, `${JSON5.stringify(contract, null, 2)}\n`, 'utf8');
171
+ writeFileSync(inferenceTracePath, `${JSON.stringify(inferenceTrace, null, 2)}\n`, 'utf8');
172
+ writeFileSync(testcasePath, `${JSON5.stringify(testcase, null, 2)}\n`, 'utf8');
173
+ writeFileSync(credentialsTemplatePath, renderCredentialsTemplate(codeList, directUrl), 'utf8');
174
+ writeFileSync(testcaseMdPath, renderUnifiedTestcaseMarkdown(testcase, contract), 'utf8');
175
+ // 软链 code_list.json5 → testsDir/code_list.json5(保留 code_list 旁路访问)。
176
+ createSoftlinkWithFallback(args.codeList, path.join(args.testsDir, 'code_list.json5'));
177
+ // 仅当显式传入 projectDir 时回写 projects.index.json5(不反推,避免静默写入错误 project)。
178
+ if (args.projectDir) {
179
+ appendRequirementToProjectIndex({
180
+ projectDir: args.projectDir,
181
+ requirementName: path.basename(args.testsDir),
182
+ requirementDir,
183
+ testsDir: args.testsDir,
184
+ });
185
+ }
184
186
  return {
185
187
  testcasePath,
186
188
  testcaseMdPath,
187
189
  credentialsTemplatePath,
188
- inference: {
189
- scenario,
190
- requiredSystems: testcaseV2.requiredSystems,
191
- requiredRoles: testcaseV2.requiredRoles,
192
- credentialsTemplatePath,
193
- credentialsActualPath,
194
- cachedSystemsHit: [],
195
- },
190
+ inferenceTracePath,
191
+ contractPath,
196
192
  };
197
193
  }
@@ -3,9 +3,10 @@
3
3
  * ep-stage-skill CLI 统一入口(REQ-CLI-02 修订):1 bin + 3 子命令。
4
4
  *
5
5
  * 用法:
6
- * ep-stage-skill testcase --code-list <p> --tests-dir <p> [--scenario <v>] [--hints <p>]
6
+ * ep-stage-skill testcase --code-list <p> --tests-dir <p> --direct-url <url> [--project-dir <p>] [--requirement-dir <p>]
7
7
  * ep-stage-skill spec --testcase <p> --out <p>
8
- * ep-stage-skill run --spec <p> --testcase <p> [--headless false]
8
+ * ep-stage-skill prepare-tasks --testcase <p>
9
+ * ep-stage-skill run --testcase <p> [--ai-snippets <p>] [--headless false]
9
10
  *
10
11
  * 无 contract 子命令(contract 提取作为 testcase 子命令内部步骤;
11
12
  * 开发期独立调试入口为 dev/extract-contract.ts,被 pnpm generate:crud-contract 调用)。
@@ -15,4 +16,12 @@ export declare function main(argv?: string[]): Promise<unknown>;
15
16
  * 打印 CLI help(仅 testcase / spec / run 3 子命令,无 contract)。
16
17
  */
17
18
  export declare function printHelp(): void;
19
+ /**
20
+ * 判断当前 CLI 文件是否以“直接执行”方式启动。
21
+ *
22
+ * @param importMetaUrl - 当前模块的 import.meta.url。
23
+ * @param argv1 - 进程入口参数,可能是 npm bin 软链路径。
24
+ * @returns 若当前模块就是实际执行入口则返回 true。
25
+ */
26
+ export declare function isDirectExecution(importMetaUrl: string, argv1: string | undefined): boolean;
18
27
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";AAKA;;;;;;;;;;GAUG;AACH,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAmB1E;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAYhC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";AAOA;;;;;;;;;;;GAWG;AACH,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CA+B1E;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAchC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAS3F"}
@@ -1,14 +1,17 @@
1
1
  #!/usr/bin/env node
2
+ import { realpathSync } from 'node:fs';
3
+ import { fileURLToPath } from 'node:url';
2
4
  import { parseGenerateTestcaseArgs, runGenerateTestcase } from './generate-testcase.js';
3
5
  import { parseSpecArgs, runSpec } from './spec.js';
4
- import { parseRunArgs, runRun } from './run.js';
6
+ import { parseRunArgs, prepareAiRuntimeTasks, runRun } from './run.js';
5
7
  /**
6
8
  * ep-stage-skill CLI 统一入口(REQ-CLI-02 修订):1 bin + 3 子命令。
7
9
  *
8
10
  * 用法:
9
- * ep-stage-skill testcase --code-list <p> --tests-dir <p> [--scenario <v>] [--hints <p>]
11
+ * ep-stage-skill testcase --code-list <p> --tests-dir <p> --direct-url <url> [--project-dir <p>] [--requirement-dir <p>]
10
12
  * ep-stage-skill spec --testcase <p> --out <p>
11
- * ep-stage-skill run --spec <p> --testcase <p> [--headless false]
13
+ * ep-stage-skill prepare-tasks --testcase <p>
14
+ * ep-stage-skill run --testcase <p> [--ai-snippets <p>] [--headless false]
12
15
  *
13
16
  * 无 contract 子命令(contract 提取作为 testcase 子命令内部步骤;
14
17
  * 开发期独立调试入口为 dev/extract-contract.ts,被 pnpm generate:crud-contract 调用)。
@@ -21,6 +24,16 @@ export async function main(argv = process.argv) {
21
24
  return runGenerateTestcase(parseGenerateTestcaseArgs(args));
22
25
  case 'spec':
23
26
  return runSpec(parseSpecArgs(args));
27
+ case 'prepare-tasks': {
28
+ const result = prepareAiRuntimeTasks(parseRunArgs(args).testcase);
29
+ console.log([
30
+ `trace: ${result.tracePath}`,
31
+ `spec: ${result.specPath}`,
32
+ `ai tasks: ${result.taskCount}`,
33
+ `blocked: ${result.blockedCount}`,
34
+ ].join('\n'));
35
+ return result;
36
+ }
24
37
  case 'run':
25
38
  return runRun(parseRunArgs(args));
26
39
  case undefined:
@@ -29,7 +42,7 @@ export async function main(argv = process.argv) {
29
42
  printHelp();
30
43
  return;
31
44
  default:
32
- console.error(`未知子命令: ${subcommand}。可用: testcase / spec / run`);
45
+ console.error(`未知子命令: ${subcommand}。可用: testcase / spec / prepare-tasks / run`);
33
46
  process.exit(1);
34
47
  }
35
48
  }
@@ -37,19 +50,39 @@ export async function main(argv = process.argv) {
37
50
  * 打印 CLI help(仅 testcase / spec / run 3 子命令,无 contract)。
38
51
  */
39
52
  export function printHelp() {
40
- console.log(`ep-stage-skill — 胶水测试链路 CLI
41
-
42
- 用法:
43
- ep-stage-skill testcase --code-list <path> --tests-dir <path> [--scenario <value>] [--hints <path>]
44
- ep-stage-skill spec --testcase <path> --out <path>
45
- ep-stage-skill run --spec <path> --testcase <path> [--headless false]
46
-
47
- 子命令:
48
- testcase 钻探上游物料 + 生成 testcase v2 + credentials.template + 软链 code_list
49
- spec 基于 testcase + contract 生成 v1 初始版 .spec.ts(只生成不执行)
50
- run 启动 Playwright 跑胶水部分 + AI 推理追加 uncoveredCandidates v2 + 报告`);
53
+ console.log(`ep-stage-skill — 胶水测试链路 CLI
54
+
55
+ 用法:
56
+ ep-stage-skill testcase --code-list <path> --tests-dir <path> --direct-url <url> [--project-dir <path>] [--requirement-dir <path>]
57
+ ep-stage-skill spec --testcase <path> --out <path>
58
+ ep-stage-skill prepare-tasks --testcase <path>
59
+ ep-stage-skill run --testcase <path> [--ai-snippets <path>] [--headless false]
60
+
61
+ 子命令:
62
+ testcase 读取 _docs/code_list.json5 + 生成 contract.json5 / testcase.json5 / inference-trace.json
63
+ spec 基于 testcase.json5 + contract.json5 glue cases 生成初始版 .spec.ts(只生成不执行)
64
+ prepare-tasks 组装 glue 骨架并输出 AI Runtime 任务包
65
+ run 合并 Agent 产出的 ai-snippets.json5 并执行完整 spec`);
66
+ }
67
+ /**
68
+ * 判断当前 CLI 文件是否以“直接执行”方式启动。
69
+ *
70
+ * @param importMetaUrl - 当前模块的 import.meta.url。
71
+ * @param argv1 - 进程入口参数,可能是 npm bin 软链路径。
72
+ * @returns 若当前模块就是实际执行入口则返回 true。
73
+ */
74
+ export function isDirectExecution(importMetaUrl, argv1) {
75
+ try {
76
+ if (!argv1) {
77
+ return false;
78
+ }
79
+ return realpathSync(fileURLToPath(importMetaUrl)) === realpathSync(argv1);
80
+ }
81
+ catch {
82
+ return false;
83
+ }
51
84
  }
52
85
  // 直接执行时调用 main;作为模块 import 时由调用方决定是否执行。
53
- if (import.meta.url === `file://${process.argv[1]}`) {
86
+ if (isDirectExecution(import.meta.url, process.argv[1])) {
54
87
  await main();
55
88
  }
@@ -1,6 +1,7 @@
1
1
  import type { CrudBusinessModuleContract } from '../contracts/crud-business-module.js';
2
2
  import type { CoverageDiffTrace } from '../contracts/observable-chain.js';
3
3
  import type { TestcaseV2 } from '../testcase/testcase-v2.js';
4
+ import type { InferenceTraceV1 } from '../contracts/inference-trace.js';
4
5
  /**
5
6
  * probe 子模块入参(REQ-CHAIN-01)。
6
7
  *
@@ -28,6 +29,7 @@ export type ProbeAndCoverageResult = {
28
29
  contract: CrudBusinessModuleContract;
29
30
  coverageDiff: CoverageDiffTrace;
30
31
  testcaseV2: TestcaseV2;
32
+ inferenceTrace: InferenceTraceV1;
31
33
  };
32
34
  /**
33
35
  * probe + coverage + testcase v2 装配的统一入口(REQ-CHAIN-01)。
@@ -1 +1 @@
1
- {"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../../src/cli/probe.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,0BAA0B,EAAe,MAAM,sCAAsC,CAAC;AACpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAG7D;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,YAAY,EAAE,iBAAiB,CAAC;IAChC,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AA+LF;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,sBAAsB,CAkCtF"}
1
+ {"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../../src/cli/probe.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,0BAA0B,EAAe,MAAM,sCAAsC,CAAC;AACpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAI7D,OAAO,KAAK,EAAE,gBAAgB,EAAoE,MAAM,iCAAiC,CAAC;AAI1I;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,YAAY,EAAE,iBAAiB,CAAC;IAChC,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,EAAE,gBAAgB,CAAC;CAClC,CAAC;AAoYF;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,sBAAsB,CAuFtF"}