@epoint-testtech/ep-stage-skill 0.0.4-alpha.1 → 0.0.6
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.
- package/SKILL.md +27 -27
- package/codex-skill/ep-stage/glue-create-project/SKILL.md +223 -206
- package/codex-skill/ep-stage/glue-generate-testcase/SKILL.md +275 -274
- package/codex-skill/ep-stage/glue-generate-testcase/examples/observable-testcase.json +40 -40
- package/codex-skill/ep-stage/glue-generate-testcase/references/testcase-schema.md +95 -112
- package/codex-skill/ep-stage/glue-generate-testcase/references/testcase-tpl.md +72 -72
- package/codex-skill/ep-stage/glue-run-test/SKILL.md +295 -289
- package/codex-skill/ep-stage/glue-run-test/references/ai-runtime-loop.md +30 -0
- package/codex-skill/ep-stage/glue-run-test/references/crud-pipeline.md +132 -145
- package/codex-skill/ep-stage/glue-run-test/references/gap-review-protocol.md +44 -43
- package/codex-skill/ep-stage/glue-run-test/references/harness-principles.md +46 -46
- package/codex-skill/ep-stage/glue-run-test/references/playwright-cli-odav.md +166 -0
- package/codex-skill/ep-stage/glue-run-test/scripts/extract-page-elements-eval.mjs +233 -0
- package/codex-skill/ep-stage/glue-run-test/scripts/generate-crud-spec.mjs +149 -149
- package/codex-skill/ep-stage/page-element-scan/SKILL.md +91 -0
- package/codex-skill/ep-stage/page-element-scan/evals/evals.json +37 -0
- package/codex-skill/ep-stage/page-element-scan/evals/fixtures/sample-list-page.html +85 -0
- package/codex-skill/ep-stage/page-element-scan/references/pagination-controls.md +153 -0
- package/codex-skill/ep-stage/page-element-scan/scripts/extract-page-elements-eval.mjs +233 -0
- package/codex-skill/ep-stage/page-element-scan/scripts/extract-page-elements.mjs +298 -0
- package/codex-skill/ep-stage/page-element-scan/scripts/scan-page.mjs +749 -0
- package/codex-skill/ep-stage/recording-to-glue/SKILL.md +28 -28
- package/codex-skill/ep-stage/scripts/validate-skill.mjs +98 -95
- package/dist/src/cli/generate-testcase.d.ts +17 -51
- package/dist/src/cli/generate-testcase.d.ts.map +1 -1
- package/dist/src/cli/generate-testcase.js +74 -181
- package/dist/src/cli/index.d.ts +3 -2
- package/dist/src/cli/index.d.ts.map +1 -1
- package/dist/src/cli/index.js +51 -17
- package/dist/src/cli/run.d.ts +136 -29
- package/dist/src/cli/run.d.ts.map +1 -1
- package/dist/src/cli/run.js +507 -65
- package/dist/src/cli/spec.d.ts +17 -13
- package/dist/src/cli/spec.d.ts.map +1 -1
- package/dist/src/cli/spec.js +59 -33
- package/dist/src/contracts/crud-business-module.d.ts +6 -0
- package/dist/src/contracts/crud-business-module.d.ts.map +1 -1
- package/dist/src/contracts/glue-contract-v1.d.ts +98 -0
- package/dist/src/contracts/glue-contract-v1.d.ts.map +1 -0
- package/dist/src/contracts/glue-contract-v1.js +9 -0
- package/dist/src/contracts/observable-chain.d.ts +4 -0
- package/dist/src/contracts/observable-chain.d.ts.map +1 -1
- package/dist/src/extractors/code-list-json5.d.ts +192 -0
- package/dist/src/extractors/code-list-json5.d.ts.map +1 -0
- package/dist/src/extractors/code-list-json5.js +91 -0
- package/dist/src/extractors/html-page.d.ts +9 -0
- package/dist/src/extractors/html-page.d.ts.map +1 -1
- package/dist/src/extractors/html-page.js +26 -2
- package/dist/src/extractors/prd-extractor.d.ts +70 -0
- package/dist/src/extractors/prd-extractor.d.ts.map +1 -0
- package/dist/src/extractors/prd-extractor.js +248 -0
- package/dist/src/generators/agent-inferred-workflow-script.js +66 -66
- package/dist/src/generators/stage-skeleton-script.d.ts +87 -20
- package/dist/src/generators/stage-skeleton-script.d.ts.map +1 -1
- package/dist/src/generators/stage-skeleton-script.js +647 -238
- package/dist/src/index.d.ts +2 -2
- package/dist/src/index.d.ts.map +1 -1
- package/dist/src/index.js +1 -1
- package/dist/src/normalizers/crud-contract.d.ts +3 -0
- package/dist/src/normalizers/crud-contract.d.ts.map +1 -1
- package/dist/src/normalizers/crud-contract.js +3 -0
- package/dist/src/runtime/ai-runtime-trace.d.ts +88 -0
- package/dist/src/runtime/ai-runtime-trace.d.ts.map +1 -0
- package/dist/src/runtime/ai-runtime-trace.js +119 -0
- package/dist/src/testcase/button-interaction-inference.d.ts +37 -0
- package/dist/src/testcase/button-interaction-inference.d.ts.map +1 -0
- package/dist/src/testcase/button-interaction-inference.js +385 -0
- package/dist/src/testcase/contract-testcase-assembler.d.ts +44 -0
- package/dist/src/testcase/contract-testcase-assembler.d.ts.map +1 -0
- package/dist/src/testcase/contract-testcase-assembler.js +806 -0
- package/dist/src/testcase/prd-button-mapper.d.ts +72 -0
- package/dist/src/testcase/prd-button-mapper.d.ts.map +1 -0
- package/dist/src/testcase/prd-button-mapper.js +148 -0
- package/dist/src/testcase/runtime-context.d.ts +9 -0
- package/dist/src/testcase/runtime-context.d.ts.map +1 -0
- package/dist/src/testcase/runtime-context.js +1 -0
- package/dist/src/testcase/test-access.d.ts +38 -0
- package/dist/src/testcase/test-access.d.ts.map +1 -0
- package/dist/src/testcase/test-access.js +106 -0
- package/dist/src/testcase/testcase-execution-fields.d.ts +10 -0
- package/dist/src/testcase/testcase-execution-fields.d.ts.map +1 -0
- package/dist/src/testcase/testcase-execution-fields.js +1 -0
- package/dist/src/testcase/testcase-generator.d.ts.map +1 -1
- package/dist/src/testcase/testcase-generator.js +6 -0
- package/dist/src/testcase/testcase-markdown.d.ts +11 -0
- package/dist/src/testcase/testcase-markdown.d.ts.map +1 -0
- package/dist/src/testcase/testcase-markdown.js +181 -0
- package/dist/src/testcase/testcase-skeleton.d.ts +4 -0
- package/dist/src/testcase/testcase-skeleton.d.ts.map +1 -1
- package/dist/src/testcase/testcase-spec-assembly.d.ts +4 -0
- package/dist/src/testcase/testcase-spec-assembly.d.ts.map +1 -1
- package/dist/src/testcase/testcase-v1-draft.d.ts +58 -0
- package/dist/src/testcase/testcase-v1-draft.d.ts.map +1 -0
- package/dist/src/testcase/testcase-v1-draft.js +13 -0
- package/dist/src/validation/contract.d.ts +14 -0
- package/dist/src/validation/contract.d.ts.map +1 -0
- package/dist/src/validation/contract.js +132 -0
- package/dist/src/validation/credentials.d.ts +7 -2
- package/dist/src/validation/credentials.d.ts.map +1 -1
- package/dist/src/validation/credentials.js +15 -4
- package/dist/src/validation/index.d.ts +1 -0
- package/dist/src/validation/index.d.ts.map +1 -1
- package/dist/src/validation/index.js +1 -0
- package/dist/src/validation/testcase.d.ts +9 -7
- package/dist/src/validation/testcase.d.ts.map +1 -1
- package/dist/src/validation/testcase.js +181 -34
- package/docs/README.md +124 -134
- package/docs/mvp-usage-guide.md +298 -298
- package/examples/schemeresource-observable-docs/schemeresource.context.md +20 -20
- package/examples/schemeresource.module-hints.json +38 -38
- package/examples/schemeresource.observable.code_list.md +37 -37
- package/examples/zwplace-observable-docs/zwplace.context.md +16 -16
- package/examples/zwplace-placecategory-validation.json +29 -29
- package/examples/zwplace.module-hints.json +69 -69
- package/examples/zwplace.observable.code_list.md +37 -37
- package/package.json +2 -2
- package/codex-skill/ep-stage/.omc/state/sessions/d636ad35-5fc9-4d5e-85b0-2bcad7d86ee5/pre-tool-advisory-throttle.json +0 -10
- package/dist/test/cli/extract-contract.test.d.ts +0 -2
- package/dist/test/cli/extract-contract.test.d.ts.map +0 -1
- package/dist/test/cli/extract-contract.test.js +0 -32
- package/dist/test/cli/generate-testcase-inference.test.d.ts +0 -2
- package/dist/test/cli/generate-testcase-inference.test.d.ts.map +0 -1
- package/dist/test/cli/generate-testcase-inference.test.js +0 -63
- package/dist/test/cli/generate-testcase-paths.test.d.ts +0 -2
- package/dist/test/cli/generate-testcase-paths.test.d.ts.map +0 -1
- package/dist/test/cli/generate-testcase-paths.test.js +0 -165
- package/dist/test/cli/generate-testcase-requirements.test.d.ts +0 -2
- package/dist/test/cli/generate-testcase-requirements.test.d.ts.map +0 -1
- package/dist/test/cli/generate-testcase-requirements.test.js +0 -229
- package/dist/test/cli/generate-testcase.test.d.ts +0 -2
- package/dist/test/cli/generate-testcase.test.d.ts.map +0 -1
- package/dist/test/cli/generate-testcase.test.js +0 -130
- package/dist/test/cli/index.test.d.ts +0 -2
- package/dist/test/cli/index.test.d.ts.map +0 -1
- package/dist/test/cli/index.test.js +0 -113
- package/dist/test/cli/probe.test.d.ts +0 -2
- package/dist/test/cli/probe.test.d.ts.map +0 -1
- package/dist/test/cli/probe.test.js +0 -31
- package/dist/test/cli/run.test.d.ts +0 -2
- package/dist/test/cli/run.test.d.ts.map +0 -1
- package/dist/test/cli/run.test.js +0 -149
- package/dist/test/cli/spec-boundary.test.d.ts +0 -2
- package/dist/test/cli/spec-boundary.test.d.ts.map +0 -1
- package/dist/test/cli/spec-boundary.test.js +0 -198
- package/dist/test/cli/spec.test.d.ts +0 -2
- package/dist/test/cli/spec.test.d.ts.map +0 -1
- package/dist/test/cli/spec.test.js +0 -196
- package/dist/test/code-list.test.d.ts +0 -2
- package/dist/test/code-list.test.d.ts.map +0 -1
- package/dist/test/code-list.test.js +0 -39
- package/dist/test/crud-contract.test.d.ts +0 -2
- package/dist/test/crud-contract.test.d.ts.map +0 -1
- package/dist/test/crud-contract.test.js +0 -799
- package/dist/test/gap-inference.test.d.ts +0 -2
- package/dist/test/gap-inference.test.d.ts.map +0 -1
- package/dist/test/gap-inference.test.js +0 -597
- package/dist/test/generalization.test.d.ts +0 -2
- package/dist/test/generalization.test.d.ts.map +0 -1
- package/dist/test/generalization.test.js +0 -73
- package/dist/test/inference/module-hints-inference.test.d.ts +0 -2
- package/dist/test/inference/module-hints-inference.test.d.ts.map +0 -1
- package/dist/test/inference/module-hints-inference.test.js +0 -25
- package/dist/test/inference/source-analysis.test.d.ts +0 -2
- package/dist/test/inference/source-analysis.test.d.ts.map +0 -1
- package/dist/test/inference/source-analysis.test.js +0 -23
- package/dist/test/material-inventory.test.d.ts +0 -2
- package/dist/test/material-inventory.test.d.ts.map +0 -1
- package/dist/test/material-inventory.test.js +0 -154
- package/dist/test/observable-chain.test.d.ts +0 -2
- package/dist/test/observable-chain.test.d.ts.map +0 -1
- package/dist/test/observable-chain.test.js +0 -123
- package/dist/test/observable-pipeline.test.d.ts +0 -2
- package/dist/test/observable-pipeline.test.d.ts.map +0 -1
- package/dist/test/observable-pipeline.test.js +0 -470
- package/dist/test/page-structure.test.d.ts +0 -2
- package/dist/test/page-structure.test.d.ts.map +0 -1
- package/dist/test/page-structure.test.js +0 -45
- package/dist/test/scenario-inference.test.d.ts +0 -2
- package/dist/test/scenario-inference.test.d.ts.map +0 -1
- package/dist/test/scenario-inference.test.js +0 -73
- package/dist/test/stage-context.test.d.ts +0 -2
- package/dist/test/stage-context.test.d.ts.map +0 -1
- package/dist/test/stage-context.test.js +0 -395
- package/dist/test/testcase-generator.test.d.ts +0 -2
- package/dist/test/testcase-generator.test.d.ts.map +0 -1
- package/dist/test/testcase-generator.test.js +0 -276
- package/dist/test/testcase-skeleton.test.d.ts +0 -2
- package/dist/test/testcase-skeleton.test.d.ts.map +0 -1
- package/dist/test/testcase-skeleton.test.js +0 -185
- package/dist/test/testcase-spec-assembly.test.d.ts +0 -2
- package/dist/test/testcase-spec-assembly.test.d.ts.map +0 -1
- package/dist/test/testcase-spec-assembly.test.js +0 -105
- package/dist/test/util/credentials.test.d.ts +0 -2
- package/dist/test/util/credentials.test.d.ts.map +0 -1
- package/dist/test/util/credentials.test.js +0 -64
- package/dist/test/util/i18n-testcase.test.d.ts +0 -2
- package/dist/test/util/i18n-testcase.test.d.ts.map +0 -1
- package/dist/test/util/i18n-testcase.test.js +0 -119
- package/dist/test/util/softlink.test.d.ts +0 -2
- package/dist/test/util/softlink.test.d.ts.map +0 -1
- package/dist/test/util/softlink.test.js +0 -82
- package/dist/test/validation/credentials.test.d.ts +0 -2
- package/dist/test/validation/credentials.test.d.ts.map +0 -1
- package/dist/test/validation/credentials.test.js +0 -72
- package/dist/test/validation/projects-index.test.d.ts +0 -2
- package/dist/test/validation/projects-index.test.d.ts.map +0 -1
- package/dist/test/validation/projects-index.test.js +0 -48
- package/dist/test/validation/testcase.test.d.ts +0 -2
- package/dist/test/validation/testcase.test.d.ts.map +0 -1
- package/dist/test/validation/testcase.test.js +0 -129
- package/dist/vitest.config.d.ts +0 -3
- package/dist/vitest.config.d.ts.map +0 -1
- package/dist/vitest.config.js +0 -7
package/dist/src/cli/spec.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* spec
|
|
2
|
+
* spec 子命令参数(新协议 v1-draft,REQ-SPEC-01)。
|
|
3
3
|
*
|
|
4
|
-
* - testcase:testcase.json5 路径(必填,由 testcase
|
|
4
|
+
* - testcase:testcase.json5 路径(必填,由 testcase 子命令产出,v1-draft);
|
|
5
5
|
* - out:.spec.ts 输出路径(必填,通常为 <tests-dir>/crud.spec.ts)。
|
|
6
6
|
*/
|
|
7
7
|
export type SpecArgs = {
|
|
@@ -12,7 +12,7 @@ export type SpecArgs = {
|
|
|
12
12
|
* spec 子命令产物。
|
|
13
13
|
*
|
|
14
14
|
* @property specPath - 写盘后的 .spec.ts 路径。
|
|
15
|
-
* @property version - 'v1' 表示只含
|
|
15
|
+
* @property version - 'v1' 表示只含 glue 骨架部分,待 run 子命令追加 AI 推理段。
|
|
16
16
|
*/
|
|
17
17
|
export type SpecResult = {
|
|
18
18
|
specPath: string;
|
|
@@ -27,19 +27,23 @@ export type SpecResult = {
|
|
|
27
27
|
*/
|
|
28
28
|
export declare function parseSpecArgs(argv: string[]): SpecArgs;
|
|
29
29
|
/**
|
|
30
|
-
* spec
|
|
30
|
+
* spec 子命令主体(新协议 v1-draft,REQ-SPEC-01):只生成 v1 初始版 .spec.ts,不启动浏览器。
|
|
31
31
|
*
|
|
32
|
-
* v1 = 仅
|
|
33
|
-
* run
|
|
32
|
+
* v1 = 仅 glue 骨架部分(顶部注释 `// === 胶水模式生成 ===`);
|
|
33
|
+
* run 子命令后续在底部 `// @stage-gap-append` 处追加 AI 推理段。
|
|
34
34
|
*
|
|
35
|
-
*
|
|
36
|
-
* 1.
|
|
37
|
-
* 2.
|
|
38
|
-
* 3.
|
|
39
|
-
* 4.
|
|
40
|
-
* 5.
|
|
35
|
+
* 流程:
|
|
36
|
+
* 1. JSON5.parse 读 testcase.json5 → validateTestcase(v1-draft schema);
|
|
37
|
+
* 2. 门禁 assertTestcaseReadyForSpec(cases 全 confirmed;不阻断 uncoveredCandidates);
|
|
38
|
+
* 3. 定位 `.ep-stage/contract.json5`(不再是 contract.json;不存在则中文报错引导先跑 testcase 子命令);
|
|
39
|
+
* 4. JSON5.parse + validateContract;
|
|
40
|
+
* 5. 从 `contract.scenario.skeletonSlots.{crud,export}` 取槽位、
|
|
41
|
+
* 从 `testcase.{moduleId,moduleName}` 取模块 → 调
|
|
42
|
+
* {@link generateStageSkeletonCrudSpecFromSlots} 生成基线骨架脚本;
|
|
43
|
+
* 6. 头部插 SKELETON_MARKER_LINE 标记,写盘。
|
|
41
44
|
*
|
|
42
|
-
* 消费边界(REQ-INFER-008):只读 testcase.json5 + contract.
|
|
45
|
+
* 消费边界(REQ-INFER-008):只读 testcase.json5 + contract.json5,不读 inference-trace.json。
|
|
46
|
+
* 新链路零依赖旧 CrudBusinessModuleContract 类型。
|
|
43
47
|
*
|
|
44
48
|
* @param args - 解析后的参数。
|
|
45
49
|
* @returns SpecResult(含 version='v1' 显式标识阶段)。
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../src/cli/spec.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../src/cli/spec.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,IAAI,CAAC;CACf,CAAC;AAiCF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,CActD;AAcD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CA+ClD"}
|
package/dist/src/cli/spec.js
CHANGED
|
@@ -1,32 +1,35 @@
|
|
|
1
1
|
import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
|
|
2
2
|
import path from 'node:path';
|
|
3
3
|
import JSON5 from 'json5';
|
|
4
|
-
import {
|
|
4
|
+
import { generateStageSkeletonCrudSpecFromSlots } from '../generators/stage-skeleton-script.js';
|
|
5
|
+
import { validateContract } from '../validation/contract.js';
|
|
5
6
|
import { validateTestcase } from '../validation/testcase.js';
|
|
6
|
-
const SKELETON_MARKER_LINE = '// === 胶水模式生成(基于 contract + coveredActions)===';
|
|
7
7
|
/**
|
|
8
|
-
* spec
|
|
8
|
+
* 胶水模式生成标记(头部注释,标识本段 spec 由 skeletonSlots + glue cases 组装)。
|
|
9
|
+
*/
|
|
10
|
+
const SKELETON_MARKER_LINE = '// === 胶水模式生成(基于 contract.skeletonSlots + glue cases)===';
|
|
11
|
+
/**
|
|
12
|
+
* spec 组装前的 testcase 就绪门禁(新协议,REQ-INFER-007)。
|
|
9
13
|
*
|
|
10
|
-
* 独立于 validateTestcase(纯 schema
|
|
14
|
+
* 独立于 validateTestcase(纯 schema 校验),这里只判定
|
|
11
15
|
* "testcase 是否已通过人工审阅、可进入 spec 组装阶段"的 readiness 策略,
|
|
12
16
|
* 仅在 runSpec 内调用,不影响 run 子命令。
|
|
13
17
|
*
|
|
14
|
-
*
|
|
15
|
-
* - 任一 cases[].reviewStatus !== 'confirmed'(needs_review / blocked
|
|
16
|
-
*
|
|
18
|
+
* 阻断条件(仅 cases 桶):
|
|
19
|
+
* - 任一 cases[].reviewStatus !== 'confirmed'(needs_review / blocked 均阻断)。
|
|
20
|
+
*
|
|
21
|
+
* **门禁边界**:
|
|
22
|
+
* 不因 uncoveredCandidates 的 ai/blocked/gap 阻断 spec 组装。
|
|
23
|
+
* 理由:gap 候选不影响 glue 骨架组装;blocked 只表示 AI 运行态可能无法补齐。
|
|
17
24
|
*
|
|
18
|
-
* @param testcase - 已通过 validateTestcase 的
|
|
19
|
-
* @throws
|
|
25
|
+
* @param testcase - 已通过 validateTestcase 的 EpStageTestcaseV1Draft。
|
|
26
|
+
* @throws 存在未确认 glue 用例时抛中文错误。
|
|
20
27
|
*/
|
|
21
28
|
function assertTestcaseReadyForSpec(testcase) {
|
|
22
29
|
const unconfirmed = testcase.cases.find((c) => c.reviewStatus !== 'confirmed');
|
|
23
30
|
if (unconfirmed) {
|
|
24
31
|
throw new Error(`testcase.json5 存在未确认用例(needs_review/blocked),请逐条审阅置为 confirmed 后再生成 spec(caseId=${unconfirmed.caseId},reviewStatus=${unconfirmed.reviewStatus})`);
|
|
25
32
|
}
|
|
26
|
-
const unresolvedCandidate = testcase.uncoveredCandidates.find((item) => item.status === 'candidate' || item.status === 'unresolved');
|
|
27
|
-
if (unresolvedCandidate) {
|
|
28
|
-
throw new Error(`testcase.json5 存在 candidate/unresolved 未覆盖项,请处理后再生成 spec(actionId=${unresolvedCandidate.actionId},status=${unresolvedCandidate.status})`);
|
|
29
|
-
}
|
|
30
33
|
}
|
|
31
34
|
/**
|
|
32
35
|
* 解析 spec 子命令参数。
|
|
@@ -53,31 +56,34 @@ export function parseSpecArgs(argv) {
|
|
|
53
56
|
return { testcase: result.testcase, out: result.out };
|
|
54
57
|
}
|
|
55
58
|
/**
|
|
56
|
-
* 定位 testcase 旁挂的 contract.
|
|
57
|
-
*
|
|
58
|
-
* 当前 Sub-step 4 未保存该文件;本函数兜底返回 null,调用方需先用 dev/extract-contract 显式生成)。
|
|
59
|
+
* 定位 testcase 旁挂的 contract.json5(新协议,由 testcase 子命令产出):
|
|
60
|
+
* `<tests-dir>/.ep-stage/contract.json5`。
|
|
59
61
|
*
|
|
60
62
|
* @param testcasePath - testcase.json5 绝对路径。
|
|
61
|
-
* @returns contract.
|
|
63
|
+
* @returns contract.json5 绝对路径或 null。
|
|
62
64
|
*/
|
|
63
65
|
function locateContract(testcasePath) {
|
|
64
|
-
const candidate = path.join(path.dirname(testcasePath), '.ep-stage', 'contract.
|
|
66
|
+
const candidate = path.join(path.dirname(testcasePath), '.ep-stage', 'contract.json5');
|
|
65
67
|
return existsSync(candidate) ? candidate : null;
|
|
66
68
|
}
|
|
67
69
|
/**
|
|
68
|
-
* spec
|
|
70
|
+
* spec 子命令主体(新协议 v1-draft,REQ-SPEC-01):只生成 v1 初始版 .spec.ts,不启动浏览器。
|
|
69
71
|
*
|
|
70
|
-
* v1 = 仅
|
|
71
|
-
* run
|
|
72
|
+
* v1 = 仅 glue 骨架部分(顶部注释 `// === 胶水模式生成 ===`);
|
|
73
|
+
* run 子命令后续在底部 `// @stage-gap-append` 处追加 AI 推理段。
|
|
72
74
|
*
|
|
73
|
-
*
|
|
74
|
-
* 1.
|
|
75
|
-
* 2.
|
|
76
|
-
* 3.
|
|
77
|
-
* 4.
|
|
78
|
-
* 5.
|
|
75
|
+
* 流程:
|
|
76
|
+
* 1. JSON5.parse 读 testcase.json5 → validateTestcase(v1-draft schema);
|
|
77
|
+
* 2. 门禁 assertTestcaseReadyForSpec(cases 全 confirmed;不阻断 uncoveredCandidates);
|
|
78
|
+
* 3. 定位 `.ep-stage/contract.json5`(不再是 contract.json;不存在则中文报错引导先跑 testcase 子命令);
|
|
79
|
+
* 4. JSON5.parse + validateContract;
|
|
80
|
+
* 5. 从 `contract.scenario.skeletonSlots.{crud,export}` 取槽位、
|
|
81
|
+
* 从 `testcase.{moduleId,moduleName}` 取模块 → 调
|
|
82
|
+
* {@link generateStageSkeletonCrudSpecFromSlots} 生成基线骨架脚本;
|
|
83
|
+
* 6. 头部插 SKELETON_MARKER_LINE 标记,写盘。
|
|
79
84
|
*
|
|
80
|
-
* 消费边界(REQ-INFER-008):只读 testcase.json5 + contract.
|
|
85
|
+
* 消费边界(REQ-INFER-008):只读 testcase.json5 + contract.json5,不读 inference-trace.json。
|
|
86
|
+
* 新链路零依赖旧 CrudBusinessModuleContract 类型。
|
|
81
87
|
*
|
|
82
88
|
* @param args - 解析后的参数。
|
|
83
89
|
* @returns SpecResult(含 version='v1' 显式标识阶段)。
|
|
@@ -88,12 +94,32 @@ export function runSpec(args) {
|
|
|
88
94
|
assertTestcaseReadyForSpec(testcase);
|
|
89
95
|
const contractPath = locateContract(args.testcase);
|
|
90
96
|
if (!contractPath) {
|
|
91
|
-
throw new Error(`未找到 ${path.dirname(args.testcase)}/.ep-stage/contract.
|
|
97
|
+
throw new Error(`未找到 ${path.dirname(args.testcase)}/.ep-stage/contract.json5。请先运行 \`ep-stage-skill testcase --code-list <p> --tests-dir <p>\` 生成 contract.json5。`);
|
|
98
|
+
}
|
|
99
|
+
const contractRaw = JSON5.parse(readFileSync(contractPath, 'utf8'));
|
|
100
|
+
const contract = validateContract(contractRaw);
|
|
101
|
+
// skeletonSlots.crud 形态对齐 StageSkeletonCrudFlowSlots(见 glue-contract-v1.ts 注释)。
|
|
102
|
+
const crudSlots = contract.scenario.skeletonSlots.crud;
|
|
103
|
+
const exportSlot = contract.scenario.skeletonSlots.export;
|
|
104
|
+
const childGridSlots = (contract.scenario.skeletonSlots.childGrids ?? []);
|
|
105
|
+
const directUrl = contract.base?.navigation?.directUrl ?? '';
|
|
106
|
+
if (!directUrl) {
|
|
107
|
+
throw new Error('contract.base.navigation.directUrl 缺失。glue 主链路已切换为直达链接模式,请重跑 `/glue-generate-testcase` 补齐 --direct-url 后再生成 spec。');
|
|
108
|
+
}
|
|
109
|
+
const primaryRole = testcase.testAccess?.requiredRoles?.[0];
|
|
110
|
+
if (!primaryRole) {
|
|
111
|
+
throw new Error('testcase.testAccess.requiredRoles 至少需要一个角色作为主执行角色,用于登录 credentials.json5 匹配。');
|
|
92
112
|
}
|
|
93
|
-
const
|
|
94
|
-
const script =
|
|
95
|
-
|
|
96
|
-
|
|
113
|
+
const requirementName = path.basename(path.dirname(args.testcase));
|
|
114
|
+
const script = generateStageSkeletonCrudSpecFromSlots({
|
|
115
|
+
moduleId: testcase.moduleId,
|
|
116
|
+
moduleLabel: testcase.moduleName,
|
|
117
|
+
directUrl,
|
|
118
|
+
primaryRole,
|
|
119
|
+
requirementName,
|
|
120
|
+
crudSlots,
|
|
121
|
+
exportSlot,
|
|
122
|
+
childGridSlots,
|
|
97
123
|
});
|
|
98
124
|
const body = `${SKELETON_MARKER_LINE}\n${script}`;
|
|
99
125
|
mkdirSync(path.dirname(args.out), { recursive: true });
|
|
@@ -1,4 +1,10 @@
|
|
|
1
1
|
/**
|
|
2
|
+
* @deprecated 旧 v2 协议(CrudBusinessModuleContract)残留。
|
|
3
|
+
* 新 glue 链路(generate-testcase / spec / run)已改用 `EpStageContractV1Draft`
|
|
4
|
+
* (见 `src/contracts/glue-contract-v1.ts`),不再引用本文件类型。
|
|
5
|
+
* 本文件仍被 gap-pipeline(src/gap-planner/*、src/cli/run-gap-pipeline.ts、
|
|
6
|
+
* src/cli/dev/extract-contract.ts)作为独立子系统使用,故保留;待该子系统迁移后整体清理。
|
|
7
|
+
*
|
|
2
8
|
* CRUD 业务模块契约类型定义
|
|
3
9
|
*
|
|
4
10
|
* 定义了 crud-business-module/v1 版本契约的所有类型。
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"crud-business-module.d.ts","sourceRoot":"","sources":["../../../src/contracts/crud-business-module.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"crud-business-module.d.ts","sourceRoot":"","sources":["../../../src/contracts/crud-business-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,WAAW,GACX,MAAM,GACN,aAAa,GACb,mBAAmB,GACnB,gBAAgB,CAAC;AAErB;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEnD;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GACxB,kBAAkB,GAClB,WAAW,GACX,gBAAgB,GAChB,aAAa,CAAC;AAElB;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,YAAY,GACpB,YAAY,GACZ,cAAc,GACd,aAAa,GACb,aAAa,GACb,aAAa,GACb,iBAAiB,GACjB,oBAAoB,GACpB,uBAAuB,GACvB,WAAW,GACX,kBAAkB,CAAC;AAEvB;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,YAAY,CAAC;IAChD,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,KAAK,EAAE,CAAC,CAAC;QACT,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,WAAW,EAAE,CAAC;QACxB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE;QACX,MAAM,EAAE,MAAM,CAAC;QACf,gBAAgB,EAAE,WAAW,GAAG,QAAQ,GAAG,gBAAgB,CAAC;QAC5D,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,kBAAkB,CAAC,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC;KAC5D,CAAC;IACF,gBAAgB,CAAC,EAAE,KAAK,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAChC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC;QACjD,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,KAAK,CAAC;YACvB,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,KAAK,EAAE,MAAM,CAAC;SACf,CAAC,CAAC;KACJ,CAAC,CAAC;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAC5B,QAAQ,GAAG,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,EAC/E,MAAM,EAAE,CACT,CAAC,CAAC;IACH,eAAe,CAAC,EAAE,KAAK,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE;QACT,cAAc,CAAC,EAAE,KAAK,CAAC;YACrB,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC;YAChD,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB,CAAC,CAAC;KACJ,CAAC;IACF,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,eAAe,CAAC,EAAE;QAChB,WAAW,CAAC,EAAE,eAAe,GAAG,eAAe,GAAG,MAAM,CAAC;QACzD,WAAW,CAAC,EAAE,eAAe,GAAG,eAAe,GAAG,MAAM,CAAC;QACzD,WAAW,CAAC,EAAE,mBAAmB,GAAG,eAAe,GAAG,MAAM,GAAG,gBAAgB,CAAC;KACjF,CAAC;CACH,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAClC,YAAY,EAAE,gBAAgB,CAAC;IAC/B,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,YAAY,CAAC,KAAK,SAAS,QAAQ,GAAG,QAAQ,IAAI;IAC5D,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,gBAAgB,CAAC;IAC/B,kBAAkB,EACd,kBAAkB,GAClB,aAAa,GACb,oBAAoB,GACpB,gBAAgB,CAAC;IACrB,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,KAAK,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,EAAE,cAAc,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,cAAc,CAAC;IAC3B,cAAc,EAAE,qBAAqB,EAAE,CAAC;CACzC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,EAAE,cAAc,CAAC;IAC5B,aAAa,EAAE,cAAc,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,EAAE,cAAc,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,cAAc,CAAC;IAC5B,UAAU,EAAE,cAAc,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,qBAAqB,GAC7B,gBAAgB,GAChB,0BAA0B,GAC1B,qCAAqC,GACrC,gBAAgB,CAAC;AAErB;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,EAAE,cAAc,CAAC;IAC5B,eAAe,EAAE,qBAAqB,CAAC;IACvC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC;AAEF;;;;;;;;GAQG;AACH,KAAK,qBAAqB,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,gBAAgB,CAAC;IAC/B,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,gCAAgC,GAAG,qBAAqB,GAAG;IACrE,IAAI,EAAE,eAAe,GAAG,mBAAmB,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,KAAK,CAAC;CACzB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,6BAA6B,GAAG,qBAAqB,GAAG;IAClE,IAAI,EAAE,eAAe,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,aAAa,CAAC,EAAE,KAAK,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GACzB,gCAAgC,GAChC,6BAA6B,CAAC;AAElC;;;;;;;;;GASG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,gBAAgB,EAAE,WAAW,GAAG,QAAQ,GAAG,gBAAgB,CAAC;IAC5D,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,eAAe,EAAE,yBAAyB,CAAC;IAC3C,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE;QACL,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;QAC3B,GAAG,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;KACjC,CAAC;IACF,OAAO,EAAE,eAAe,CAAC;IACzB,gBAAgB,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAC7C,KAAK,EAAE;QACL,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAC5B,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAC5B,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAC5B,MAAM,CAAC,EAAE,kBAAkB,CAAC;KAC7B,CAAC;IACF,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,aAAa,EAAE,oBAAoB,EAAE,CAAC;IACtC,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,sBAAsB,CAAC,EAAE,qBAAqB,EAAE,CAAC;CAClD,CAAC"}
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ep-stage-contract/v1-draft 类型定义。
|
|
3
|
+
*
|
|
4
|
+
* 本类型是新协议重构后的契约 schema(破旧立新,不再保留 v2 兼容)。
|
|
5
|
+
* contract.scenario.skeletonSlots.crud 形态对齐生成器渲染层的
|
|
6
|
+
* StageSkeletonCrudFlowSlots(moduleId/searchConditions/frames/locators/assertions),
|
|
7
|
+
* 但本层不跨层 import generators 类型,仅在注释说明对齐关系,避免循环依赖。
|
|
8
|
+
*/
|
|
9
|
+
/**
|
|
10
|
+
* 测试用例生成策略:
|
|
11
|
+
* - glue:骨架命中,胶水编码组装产出
|
|
12
|
+
* - ai:AI Agent 推理产出
|
|
13
|
+
*/
|
|
14
|
+
export type GenerationStrategy = 'glue' | 'ai';
|
|
15
|
+
/**
|
|
16
|
+
* 子表列槽位。
|
|
17
|
+
*/
|
|
18
|
+
export type ChildGridColumnSlot = {
|
|
19
|
+
field: string;
|
|
20
|
+
label: string;
|
|
21
|
+
component: 'input' | 'listbox';
|
|
22
|
+
required: boolean;
|
|
23
|
+
modelRef?: string;
|
|
24
|
+
};
|
|
25
|
+
/**
|
|
26
|
+
* 子表槽位。
|
|
27
|
+
*/
|
|
28
|
+
export type ChildGridFlowSlot = {
|
|
29
|
+
gridId: string;
|
|
30
|
+
label: string;
|
|
31
|
+
pageRole: 'add' | 'edit';
|
|
32
|
+
editMode: 'cell_edit' | 'row_button_dialog' | 'none';
|
|
33
|
+
columns: ChildGridColumnSlot[];
|
|
34
|
+
addRowButtonLabel?: string;
|
|
35
|
+
deleteSelectedButtonLabel?: string;
|
|
36
|
+
locators: {
|
|
37
|
+
container: string;
|
|
38
|
+
addRowButton: string;
|
|
39
|
+
deleteSelectedButton: string;
|
|
40
|
+
grid: string;
|
|
41
|
+
editWrapInput: string;
|
|
42
|
+
editWrapListboxTrigger: string;
|
|
43
|
+
editWrapListboxInput: string;
|
|
44
|
+
rowCheckboxByIndex: string;
|
|
45
|
+
cellByIndexAndField: string;
|
|
46
|
+
cellValueByIndexAndField: string;
|
|
47
|
+
};
|
|
48
|
+
};
|
|
49
|
+
/**
|
|
50
|
+
* contract.json5 v1-draft 顶层类型。
|
|
51
|
+
*
|
|
52
|
+
* 字段语义见 docs/ep-stage-field-dictionary.md 与 SKILL.md。
|
|
53
|
+
* `scenario.skeletonSlots.crud` 形态对齐 StageSkeletonCrudFlowSlots。
|
|
54
|
+
*/
|
|
55
|
+
export type EpStageContractV1Draft = {
|
|
56
|
+
schemaVersion: 'ep-stage-contract/v1-draft';
|
|
57
|
+
contractId: string;
|
|
58
|
+
contractKind: string;
|
|
59
|
+
base: {
|
|
60
|
+
module: {
|
|
61
|
+
id: string;
|
|
62
|
+
label: string;
|
|
63
|
+
};
|
|
64
|
+
navigation: {
|
|
65
|
+
entryMode: 'directUrl' | 'menu';
|
|
66
|
+
menuPath?: string;
|
|
67
|
+
directUrl?: string;
|
|
68
|
+
};
|
|
69
|
+
credentials: {
|
|
70
|
+
source: string;
|
|
71
|
+
};
|
|
72
|
+
};
|
|
73
|
+
scenario: {
|
|
74
|
+
kind: string;
|
|
75
|
+
searchFields: Array<{
|
|
76
|
+
field: string;
|
|
77
|
+
label: string;
|
|
78
|
+
component: string;
|
|
79
|
+
caseExpansion?: string[];
|
|
80
|
+
}>;
|
|
81
|
+
skeletonSlots: {
|
|
82
|
+
crud: Record<string, unknown>;
|
|
83
|
+
export: {
|
|
84
|
+
moduleId: string;
|
|
85
|
+
label: string;
|
|
86
|
+
mode: string;
|
|
87
|
+
};
|
|
88
|
+
childGrids?: ChildGridFlowSlot[];
|
|
89
|
+
};
|
|
90
|
+
gapCandidates: Array<{
|
|
91
|
+
gapId: string;
|
|
92
|
+
label: string;
|
|
93
|
+
generationStrategy: GenerationStrategy;
|
|
94
|
+
}>;
|
|
95
|
+
};
|
|
96
|
+
unresolvedSlots: Array<Record<string, unknown>>;
|
|
97
|
+
};
|
|
98
|
+
//# sourceMappingURL=glue-contract-v1.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"glue-contract-v1.d.ts","sourceRoot":"","sources":["../../../src/contracts/glue-contract-v1.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,GAAG,MAAM,CAAC;IACzB,QAAQ,EAAE,WAAW,GAAG,mBAAmB,GAAG,MAAM,CAAC;IACrD,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,oBAAoB,EAAE,MAAM,CAAC;QAC7B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,wBAAwB,EAAE,MAAM,CAAC;KAClC,CAAC;CACH,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,aAAa,EAAE,4BAA4B,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE;QACJ,MAAM,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QACtC,UAAU,EAAE;YAAE,SAAS,EAAE,WAAW,GAAG,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACvF,WAAW,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KACjC,CAAC;IACF,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,KAAK,CAAC;YAClB,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,EAAE,MAAM,CAAC;YACd,SAAS,EAAE,MAAM,CAAC;YAClB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;SAC1B,CAAC,CAAC;QACH,aAAa,EAAE;YAEb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC9B,MAAM,EAAE;gBAAE,QAAQ,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAA;aAAE,CAAC;YAC1D,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;SAClC,CAAC;QACF,aAAa,EAAE,KAAK,CAAC;YACnB,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,EAAE,MAAM,CAAC;YACd,kBAAkB,EAAE,kBAAkB,CAAC;SACxC,CAAC,CAAC;KACJ,CAAC;IACF,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACjD,CAAC"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ep-stage-contract/v1-draft 类型定义。
|
|
3
|
+
*
|
|
4
|
+
* 本类型是新协议重构后的契约 schema(破旧立新,不再保留 v2 兼容)。
|
|
5
|
+
* contract.scenario.skeletonSlots.crud 形态对齐生成器渲染层的
|
|
6
|
+
* StageSkeletonCrudFlowSlots(moduleId/searchConditions/frames/locators/assertions),
|
|
7
|
+
* 但本层不跨层 import generators 类型,仅在注释说明对齐关系,避免循环依赖。
|
|
8
|
+
*/
|
|
9
|
+
export {};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"observable-chain.d.ts","sourceRoot":"","sources":["../../../src/contracts/observable-chain.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"observable-chain.d.ts","sourceRoot":"","sources":["../../../src/contracts/observable-chain.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* code_list.json5 输入读取器
|
|
3
|
+
*
|
|
4
|
+
* 职责:
|
|
5
|
+
* 1. assertCodeListJson5Path — 路径硬校验,拒绝非 .json5 文件(含 .md)
|
|
6
|
+
* 2. extractCodeListJson5 — 读取并解析 JSON5 文件,校验必填字段,返回强类型产出
|
|
7
|
+
*/
|
|
8
|
+
import { type TestAccessConfig } from '../testcase/test-access.js';
|
|
9
|
+
/** 查询字段 */
|
|
10
|
+
export type QueryField = {
|
|
11
|
+
label: string;
|
|
12
|
+
type?: string;
|
|
13
|
+
component?: string;
|
|
14
|
+
modelRef?: string;
|
|
15
|
+
bind?: string;
|
|
16
|
+
};
|
|
17
|
+
/** 按钮/操作 */
|
|
18
|
+
export type ButtonAction = {
|
|
19
|
+
label: string;
|
|
20
|
+
action: string;
|
|
21
|
+
backendMethod: string | null;
|
|
22
|
+
customAction?: string;
|
|
23
|
+
};
|
|
24
|
+
/** 行级操作 */
|
|
25
|
+
export type RowAction = {
|
|
26
|
+
label: string;
|
|
27
|
+
action: string;
|
|
28
|
+
};
|
|
29
|
+
/** 数据加载方法 */
|
|
30
|
+
export type DataLoadingMethod = {
|
|
31
|
+
method: string;
|
|
32
|
+
description: string;
|
|
33
|
+
};
|
|
34
|
+
export type ChildGridEditMode = 'cell_edit' | 'row_button_dialog' | 'none';
|
|
35
|
+
/** 子表列定义 */
|
|
36
|
+
export type ChildGridColumn = {
|
|
37
|
+
field: string;
|
|
38
|
+
label: string;
|
|
39
|
+
required?: boolean;
|
|
40
|
+
modelRef?: string;
|
|
41
|
+
component?: 'input' | 'listbox';
|
|
42
|
+
};
|
|
43
|
+
/** 子表定义 */
|
|
44
|
+
export type ChildGridItem = {
|
|
45
|
+
id: string;
|
|
46
|
+
label: string;
|
|
47
|
+
actions?: Array<{
|
|
48
|
+
label: string;
|
|
49
|
+
actionName: string;
|
|
50
|
+
}>;
|
|
51
|
+
columns: ChildGridColumn[];
|
|
52
|
+
/** 操作方式覆盖;缺失时由 HTML 信号推断。 */
|
|
53
|
+
editMode?: ChildGridEditMode;
|
|
54
|
+
};
|
|
55
|
+
/** 页面物料 */
|
|
56
|
+
export type PageItem = {
|
|
57
|
+
path: string;
|
|
58
|
+
role: string;
|
|
59
|
+
description: string;
|
|
60
|
+
pageId?: string;
|
|
61
|
+
title?: string;
|
|
62
|
+
directUrl?: string;
|
|
63
|
+
queryFields?: QueryField[];
|
|
64
|
+
formFields?: QueryField[] | string[];
|
|
65
|
+
buttons: ButtonAction[];
|
|
66
|
+
rowActions: RowAction[];
|
|
67
|
+
usedDataModels?: string[];
|
|
68
|
+
dataLoadingMethods?: DataLoadingMethod[];
|
|
69
|
+
childGrids?: ChildGridItem[] | string[];
|
|
70
|
+
};
|
|
71
|
+
/** 业务系统 */
|
|
72
|
+
export type SystemItem = {
|
|
73
|
+
name: string;
|
|
74
|
+
description?: string;
|
|
75
|
+
defaultLoginUrl?: string;
|
|
76
|
+
version?: string;
|
|
77
|
+
frameVersion?: string;
|
|
78
|
+
targetEnd?: string;
|
|
79
|
+
};
|
|
80
|
+
/** 角色 */
|
|
81
|
+
export type RoleItem = {
|
|
82
|
+
systemName?: string;
|
|
83
|
+
role: string;
|
|
84
|
+
loginMethod?: string;
|
|
85
|
+
permission?: string;
|
|
86
|
+
label?: string;
|
|
87
|
+
description?: string;
|
|
88
|
+
menuPath?: string;
|
|
89
|
+
};
|
|
90
|
+
/** 下拉数据模型 */
|
|
91
|
+
export type DataModelItem = {
|
|
92
|
+
ref: string;
|
|
93
|
+
description: string;
|
|
94
|
+
};
|
|
95
|
+
/** 实体字段 */
|
|
96
|
+
export type EntityField = {
|
|
97
|
+
name: string;
|
|
98
|
+
type: string;
|
|
99
|
+
description: string;
|
|
100
|
+
dataKey?: boolean;
|
|
101
|
+
};
|
|
102
|
+
/** 数据实体 */
|
|
103
|
+
export type EntityItem = {
|
|
104
|
+
name: string;
|
|
105
|
+
table: string;
|
|
106
|
+
fields: EntityField[];
|
|
107
|
+
};
|
|
108
|
+
/** 业务规则 */
|
|
109
|
+
export type BusinessRule = {
|
|
110
|
+
rule: string;
|
|
111
|
+
scope: string[];
|
|
112
|
+
assertion: string;
|
|
113
|
+
};
|
|
114
|
+
/** 业务角色事实 */
|
|
115
|
+
export type BusinessRoleItem = {
|
|
116
|
+
label: string;
|
|
117
|
+
targetEnd?: string;
|
|
118
|
+
responsibilities?: string[];
|
|
119
|
+
};
|
|
120
|
+
/** 需求事实摘要 */
|
|
121
|
+
export type RequirementItem = {
|
|
122
|
+
id?: string;
|
|
123
|
+
name?: string;
|
|
124
|
+
businessRoles?: BusinessRoleItem[];
|
|
125
|
+
};
|
|
126
|
+
/** 源码根目录配置(可选,用于解析 pages[].path 等物料路径) */
|
|
127
|
+
export type SourceRootConfig = {
|
|
128
|
+
/** 源码根目录绝对路径 */
|
|
129
|
+
root?: string;
|
|
130
|
+
/** 路径别名标识 */
|
|
131
|
+
pathBase?: string;
|
|
132
|
+
/** 说明 pages[].path 相对哪个根目录解析 */
|
|
133
|
+
sourceFilesAreRelativeTo?: string;
|
|
134
|
+
};
|
|
135
|
+
/** extractCodeListJson5 的完整产出类型 */
|
|
136
|
+
export type ExtractedCodeListJson5 = {
|
|
137
|
+
/** 文件绝对路径 */
|
|
138
|
+
path: string;
|
|
139
|
+
/** 所属需求目录(code_list.json5 所在的 _docs 目录) */
|
|
140
|
+
requirementDir: string;
|
|
141
|
+
/** 模块标识 */
|
|
142
|
+
module: string;
|
|
143
|
+
/** 模块中文名称 */
|
|
144
|
+
moduleName: string;
|
|
145
|
+
/** 模块描述 */
|
|
146
|
+
description?: string;
|
|
147
|
+
/** 需求事实摘要(可选) */
|
|
148
|
+
requirement?: RequirementItem;
|
|
149
|
+
/** 源码根目录配置(可选) */
|
|
150
|
+
sourceRoot?: SourceRootConfig;
|
|
151
|
+
/** 业务系统清单 */
|
|
152
|
+
systems: SystemItem[];
|
|
153
|
+
/** 角色清单 */
|
|
154
|
+
roles: RoleItem[];
|
|
155
|
+
/** 页面物料清单 */
|
|
156
|
+
pages: PageItem[];
|
|
157
|
+
/** 下拉数据模型(可选) */
|
|
158
|
+
dataModels?: DataModelItem[];
|
|
159
|
+
/** 数据实体(可选) */
|
|
160
|
+
entities?: EntityItem[];
|
|
161
|
+
/** 业务规则(可选) */
|
|
162
|
+
businessRules?: BusinessRule[];
|
|
163
|
+
/** 开发阶段测试访问配置(可选) */
|
|
164
|
+
testAccess?: TestAccessConfig;
|
|
165
|
+
};
|
|
166
|
+
/**
|
|
167
|
+
* 校验 filePath 是否为合法的 code_list.json5 路径。
|
|
168
|
+
* 拒绝非 .json5 后缀的文件(包括 .md)。
|
|
169
|
+
*
|
|
170
|
+
* @param filePath - 待校验的文件路径
|
|
171
|
+
* @throws Error 当文件后缀不是 .json5 时抛出中文错误
|
|
172
|
+
*/
|
|
173
|
+
export declare function assertCodeListJson5Path(filePath: string): void;
|
|
174
|
+
/**
|
|
175
|
+
* 读取并解析 code_list.json5 文件,返回强类型产出。
|
|
176
|
+
* 校验必填字段 module / moduleName / systems / pages,缺失时抛出中文错误。
|
|
177
|
+
*
|
|
178
|
+
* @param filePath - code_list.json5 文件的绝对路径
|
|
179
|
+
* @returns 解析后的强类型数据
|
|
180
|
+
* @throws Error 路径非法 / 文件不存在 / 必填字段缺失
|
|
181
|
+
*/
|
|
182
|
+
export declare function extractCodeListJson5Object(raw: unknown): Omit<ExtractedCodeListJson5, 'path' | 'requirementDir'>;
|
|
183
|
+
/**
|
|
184
|
+
* 读取并解析 code_list.json5 文件,返回强类型产出。
|
|
185
|
+
* 校验必填字段 module / moduleName / systems / pages,缺失时抛出中文错误。
|
|
186
|
+
*
|
|
187
|
+
* @param filePath - code_list.json5 文件的绝对路径
|
|
188
|
+
* @returns 解析后的强类型数据
|
|
189
|
+
* @throws Error 路径非法 / 文件不存在 / 必填字段缺失
|
|
190
|
+
*/
|
|
191
|
+
export declare function extractCodeListJson5(filePath: string): ExtractedCodeListJson5;
|
|
192
|
+
//# sourceMappingURL=code-list-json5.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"code-list-json5.d.ts","sourceRoot":"","sources":["../../../src/extractors/code-list-json5.ts"],"names":[],"mappings":"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"}
|