npm - @epoint-testtech/ep-stage-skill - Versions diffs - 0.0.3-alpha.1 - Mend

@epoint-testtech/ep-stage-skill 0.0.3-alpha.1

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 (151) hide show

package/SKILL.md +27 -0
package/codex-skill/ep-stage/create-project/SKILL.md +59 -0
package/codex-skill/ep-stage/glue-test/SKILL.md +258 -0
package/codex-skill/ep-stage/glue-test/references/crud-pipeline.md +139 -0
package/codex-skill/ep-stage/glue-test/references/gap-review-protocol.md +43 -0
package/codex-skill/ep-stage/glue-test/references/harness-principles.md +46 -0
package/codex-skill/ep-stage/glue-test/scripts/generate-crud-spec.mjs +149 -0
package/codex-skill/ep-stage/glue-testcase/SKILL.md +31 -0
package/codex-skill/ep-stage/glue-testcase/examples/observable-testcase.json +40 -0
package/codex-skill/ep-stage/glue-testcase/references/testcase-schema.md +67 -0
package/codex-skill/ep-stage/recording-to-glue/SKILL.md +27 -0
package/codex-skill/ep-stage/scripts/validate-skill.mjs +73 -0
package/dist/src/capability/coverage-diff.d.ts +34 -0
package/dist/src/capability/coverage-diff.d.ts.map +1 -0
package/dist/src/capability/coverage-diff.js +91 -0
package/dist/src/capability/page-structure.d.ts +31 -0
package/dist/src/capability/page-structure.d.ts.map +1 -0
package/dist/src/capability/page-structure.js +50 -0
package/dist/src/capability/scenario-inference.d.ts +36 -0
package/dist/src/capability/scenario-inference.d.ts.map +1 -0
package/dist/src/capability/scenario-inference.js +114 -0
package/dist/src/cli/generate-crud-contract.d.ts +2 -0
package/dist/src/cli/generate-crud-contract.d.ts.map +1 -0
package/dist/src/cli/generate-crud-contract.js +77 -0
package/dist/src/cli/generate-playwright-tests.d.ts +30 -0
package/dist/src/cli/generate-playwright-tests.d.ts.map +1 -0
package/dist/src/cli/generate-playwright-tests.js +81 -0
package/dist/src/cli/run-gap-pipeline.d.ts +256 -0
package/dist/src/cli/run-gap-pipeline.d.ts.map +1 -0
package/dist/src/cli/run-gap-pipeline.js +1468 -0
package/dist/src/context/stage-context.d.ts +63 -0
package/dist/src/context/stage-context.d.ts.map +1 -0
package/dist/src/context/stage-context.js +297 -0
package/dist/src/contracts/crud-business-module.d.ts +645 -0
package/dist/src/contracts/crud-business-module.d.ts.map +1 -0
package/dist/src/contracts/crud-business-module.js +1 -0
package/dist/src/contracts/gap-inference.d.ts +213 -0
package/dist/src/contracts/gap-inference.d.ts.map +1 -0
package/dist/src/contracts/gap-inference.js +11 -0
package/dist/src/contracts/observable-chain.d.ts +250 -0
package/dist/src/contracts/observable-chain.d.ts.map +1 -0
package/dist/src/contracts/observable-chain.js +1 -0
package/dist/src/extractors/code-list.d.ts +40 -0
package/dist/src/extractors/code-list.d.ts.map +1 -0
package/dist/src/extractors/code-list.js +225 -0
package/dist/src/extractors/html-page.d.ts +67 -0
package/dist/src/extractors/html-page.d.ts.map +1 -0
package/dist/src/extractors/html-page.js +195 -0
package/dist/src/extractors/java-action.d.ts +8 -0
package/dist/src/extractors/java-action.d.ts.map +1 -0
package/dist/src/extractors/java-action.js +53 -0
package/dist/src/extractors/spec-yaml.d.ts +28 -0
package/dist/src/extractors/spec-yaml.d.ts.map +1 -0
package/dist/src/extractors/spec-yaml.js +29 -0
package/dist/src/gap-planner/action-candidates.d.ts +9 -0
package/dist/src/gap-planner/action-candidates.d.ts.map +1 -0
package/dist/src/gap-planner/action-candidates.js +66 -0
package/dist/src/gap-planner/list-gap-workflows.d.ts +17 -0
package/dist/src/gap-planner/list-gap-workflows.d.ts.map +1 -0
package/dist/src/gap-planner/list-gap-workflows.js +47 -0
package/dist/src/gap-planner/plan-agent-workflows.d.ts +26 -0
package/dist/src/gap-planner/plan-agent-workflows.d.ts.map +1 -0
package/dist/src/gap-planner/plan-agent-workflows.js +116 -0
package/dist/src/gap-planner/skeleton-coverage.d.ts +9 -0
package/dist/src/gap-planner/skeleton-coverage.d.ts.map +1 -0
package/dist/src/gap-planner/skeleton-coverage.js +41 -0
package/dist/src/gap-planner/stable-id.d.ts +16 -0
package/dist/src/gap-planner/stable-id.d.ts.map +1 -0
package/dist/src/gap-planner/stable-id.js +19 -0
package/dist/src/generalization/generalization-eval.d.ts +71 -0
package/dist/src/generalization/generalization-eval.d.ts.map +1 -0
package/dist/src/generalization/generalization-eval.js +53 -0
package/dist/src/generators/agent-inferred-workflow-script.d.ts +22 -0
package/dist/src/generators/agent-inferred-workflow-script.d.ts.map +1 -0
package/dist/src/generators/agent-inferred-workflow-script.js +230 -0
package/dist/src/generators/stage-skeleton-script.d.ts +107 -0
package/dist/src/generators/stage-skeleton-script.d.ts.map +1 -0
package/dist/src/generators/stage-skeleton-script.js +607 -0
package/dist/src/index.d.ts +52 -0
package/dist/src/index.d.ts.map +1 -0
package/dist/src/index.js +26 -0
package/dist/src/material/material-inventory.d.ts +92 -0
package/dist/src/material/material-inventory.d.ts.map +1 -0
package/dist/src/material/material-inventory.js +191 -0
package/dist/src/normalizers/crud-contract.d.ts +107 -0
package/dist/src/normalizers/crud-contract.d.ts.map +1 -0
package/dist/src/normalizers/crud-contract.js +1068 -0
package/dist/src/testcase/testcase-generator.d.ts +43 -0
package/dist/src/testcase/testcase-generator.d.ts.map +1 -0
package/dist/src/testcase/testcase-generator.js +152 -0
package/dist/src/testcase/testcase-skeleton.d.ts +91 -0
package/dist/src/testcase/testcase-skeleton.d.ts.map +1 -0
package/dist/src/testcase/testcase-skeleton.js +121 -0
package/dist/src/testcase/testcase-spec-assembly.d.ts +11 -0
package/dist/src/testcase/testcase-spec-assembly.d.ts.map +1 -0
package/dist/src/testcase/testcase-spec-assembly.js +24 -0
package/dist/src/trace/review-summary.d.ts +17 -0
package/dist/src/trace/review-summary.d.ts.map +1 -0
package/dist/src/trace/review-summary.js +34 -0
package/dist/src/trace/trace-writer.d.ts +17 -0
package/dist/src/trace/trace-writer.d.ts.map +1 -0
package/dist/src/trace/trace-writer.js +81 -0
package/dist/test/crud-contract.test.d.ts +2 -0
package/dist/test/crud-contract.test.d.ts.map +1 -0
package/dist/test/crud-contract.test.js +819 -0
package/dist/test/gap-inference.test.d.ts +2 -0
package/dist/test/gap-inference.test.d.ts.map +1 -0
package/dist/test/gap-inference.test.js +597 -0
package/dist/test/generalization.test.d.ts +2 -0
package/dist/test/generalization.test.d.ts.map +1 -0
package/dist/test/generalization.test.js +73 -0
package/dist/test/material-inventory.test.d.ts +2 -0
package/dist/test/material-inventory.test.d.ts.map +1 -0
package/dist/test/material-inventory.test.js +141 -0
package/dist/test/observable-chain.test.d.ts +2 -0
package/dist/test/observable-chain.test.d.ts.map +1 -0
package/dist/test/observable-chain.test.js +123 -0
package/dist/test/observable-pipeline.test.d.ts +2 -0
package/dist/test/observable-pipeline.test.d.ts.map +1 -0
package/dist/test/observable-pipeline.test.js +461 -0
package/dist/test/page-structure.test.d.ts +2 -0
package/dist/test/page-structure.test.d.ts.map +1 -0
package/dist/test/page-structure.test.js +45 -0
package/dist/test/scenario-inference.test.d.ts +2 -0
package/dist/test/scenario-inference.test.d.ts.map +1 -0
package/dist/test/scenario-inference.test.js +73 -0
package/dist/test/stage-context.test.d.ts +2 -0
package/dist/test/stage-context.test.d.ts.map +1 -0
package/dist/test/stage-context.test.js +263 -0
package/dist/test/testcase-generator.test.d.ts +2 -0
package/dist/test/testcase-generator.test.d.ts.map +1 -0
package/dist/test/testcase-generator.test.js +276 -0
package/dist/test/testcase-skeleton.test.d.ts +2 -0
package/dist/test/testcase-skeleton.test.d.ts.map +1 -0
package/dist/test/testcase-skeleton.test.js +185 -0
package/dist/test/testcase-spec-assembly.test.d.ts +2 -0
package/dist/test/testcase-spec-assembly.test.d.ts.map +1 -0
package/dist/test/testcase-spec-assembly.test.js +105 -0
package/dist/vitest.config.d.ts +3 -0
package/dist/vitest.config.d.ts.map +1 -0
package/dist/vitest.config.js +7 -0
package/docs/README.md +134 -0
package/docs/mvp-usage-guide.md +298 -0
package/examples/schemeresource-observable-docs/schemeresource.context.md +20 -0
package/examples/schemeresource.module-hints.json +38 -0
package/examples/schemeresource.observable.code_list.md +37 -0
package/examples/zwplace-observable-docs/zwplace.context.md +16 -0
package/examples/zwplace-placecategory-validation.json +29 -0
package/examples/zwplace.module-hints.json +69 -0
package/examples/zwplace.observable.code_list.md +37 -0
package/package.json +38 -0

package/dist/test/observable-pipeline.test.js ADDED Viewed

@@ -0,0 +1,461 @@
+import { mkdirSync, mkdtempSync, writeFileSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { applyCodeListWriteBack, collectCodeListMaterialRefsFromPath, extractLoginSystemUrlFromEnvFile, extractCodeListSummary, createRuntimeFailureSummary, isProtectedKnowledgeProjectPath, parseRuntimeSummaryOutput, parseObservablePipelineArgs, resolveMenuRouteForPipeline, runtimeSummaryToTrace, glueSpecAssemblyToTrace, playwrightExecutionToTrace, glueReportToTrace, } from '../src/index.js';
+function createMenuContract() {
+    return {
+        contractVersion: 'crud-business-module/v1',
+        module: {
+            id: 'zwplace',
+            label: '场所窗口信息管理',
+        },
+        pages: {
+            list: {
+                role: 'list',
+                pageId: 'gxhzwplacelist',
+                title: '场所窗口信息列表',
+                iframeSrcKeyword: 'gxhzwplacelist',
+                fields: [],
+                buttons: [],
+                grids: [],
+                dialogs: [],
+                sources: [],
+            },
+        },
+        dataKey: {
+            field: 'windowname',
+            label: '窗口名称',
+            availability: 'derivable',
+            generationStrategy: 'timestamp_prefix',
+            sources: [],
+        },
+        flows: {},
+        assertions: [],
+        businessRules: [],
+        unresolvedSlots: [],
+    };
+}
+describe('observable pipeline material inventory', () => {
+    it('extracts material refs from code_list markdown', () => {
+        const root = mkdtempSync(path.join(os.tmpdir(), 'ep-stage-code-list-'));
+        const codeListPath = path.join(root, 'code_list.md');
+        mkdirSync(path.join(root, 'src', 'main', 'webapp', 'perpage', 'zwplace'), { recursive: true });
+        writeFileSync(codeListPath, [
+            '# 场所窗口信息管理代码清单',
+            '',
+            '| 类型 | 路径 |',
+            '| --- | --- |',
+            '| HTML | `src/main/webapp/perpage/zwplace/gxhzwplacelist.html` |',
+            '| Action | `src/main/java/com/epoint/zwplace/action/GxhZwPlaceListAction.java` |',
+            '| 文档 | `_docs/003-场所窗口信息管理-20260518/spec.yaml` |',
+            '',
+        ].join('\n'), 'utf8');
+        const summary = extractCodeListSummary(codeListPath);
+        // 【opus-4.8修订 N1】extractMaterialRefs 现返回 exists 字段；toEqual 为严格深比较，期望值必须带 exists，否则用例无法转绿。
+        // 本用例中三条物料文件均未实际写入（仅建了 webapp 目录），故 exists 均为 false。
+        expect(summary.materialRefs).toEqual([
+            {
+                kind: 'html',
+                rawPath: 'src/main/webapp/perpage/zwplace/gxhzwplacelist.html',
+                path: path.join(root, 'src/main/webapp/perpage/zwplace/gxhzwplacelist.html'),
+                exists: false,
+            },
+            {
+                kind: 'java_action',
+                rawPath: 'src/main/java/com/epoint/zwplace/action/GxhZwPlaceListAction.java',
+                path: path.join(root, 'src/main/java/com/epoint/zwplace/action/GxhZwPlaceListAction.java'),
+                exists: false,
+            },
+            {
+                kind: 'spec',
+                rawPath: '_docs/003-场所窗口信息管理-20260518/spec.yaml',
+                path: path.join(root, '_docs/003-场所窗口信息管理-20260518/spec.yaml'),
+                exists: false,
+            },
+        ]);
+    });
+    it('resolves paths relative to knowledge root when code_list is under _docs', () => {
+        const root = mkdtempSync(path.join(os.tmpdir(), 'ep-stage-knowledge-root-'));
+        const docsDir = path.join(root, '_docs');
+        const htmlPath = path.join(root, 'src', 'main', 'webapp', 'perpage', 'zwplace', 'gxhzwplacelist.html');
+        const codeListPath = path.join(docsDir, 'code_list.md');
+        mkdirSync(path.dirname(htmlPath), { recursive: true });
+        mkdirSync(docsDir, { recursive: true });
+        writeFileSync(htmlPath, '<html></html>');
+        writeFileSync(codeListPath, '| HTML | `src/main/webapp/perpage/zwplace/gxhzwplacelist.html` |', 'utf8');
+        const summary = extractCodeListSummary(codeListPath);
+        expect(summary.materialRefs[0]).toMatchObject({
+            kind: 'html',
+            path: htmlPath,
+            exists: true,
+        });
+    });
+    it('uses explicit knowledgeRoot when code_list is outside the knowledge project', () => {
+        const root = mkdtempSync(path.join(os.tmpdir(), 'ep-stage-explicit-knowledge-root-'));
+        const knowledgeRoot = path.join(root, 'knowledge-project', 'zwplace');
+        const externalDir = path.join(root, 'agent-input');
+        const htmlPath = path.join(knowledgeRoot, 'src', 'main', 'webapp', 'perpage', 'zwplace', 'gxhzwplacelist.html');
+        const codeListPath = path.join(externalDir, 'code_list.md');
+        mkdirSync(path.dirname(htmlPath), { recursive: true });
+        mkdirSync(externalDir, { recursive: true });
+        writeFileSync(htmlPath, '<html></html>');
+        writeFileSync(codeListPath, '| HTML | `src/main/webapp/perpage/zwplace/gxhzwplacelist.html` |', 'utf8');
+        const summary = extractCodeListSummary(codeListPath, { knowledgeRoot });
+        expect(summary.materialRefs[0]).toMatchObject({
+            kind: 'html',
+            path: htmlPath,
+            exists: true,
+        });
+    });
+    it('uses knowledgeRoot declared inside an external code_list as the material root', () => {
+        const root = mkdtempSync(path.join(os.tmpdir(), 'ep-stage-code-list-declared-root-'));
+        const knowledgeRoot = path.join(root, 'knowledge-project', 'zwplace');
+        const externalDir = path.join(root, 'agent-input');
+        const htmlPath = path.join(knowledgeRoot, 'src', 'main', 'webapp', 'perpage', 'zwplace', 'gxhzwplacelist.html');
+        const codeListPath = path.join(externalDir, 'code_list.md');
+        mkdirSync(path.dirname(htmlPath), { recursive: true });
+        mkdirSync(externalDir, { recursive: true });
+        writeFileSync(htmlPath, '<html></html>');
+        writeFileSync(codeListPath, [
+            '# 场所窗口信息管理代码清单',
+            '',
+            `knowledgeRoot: ${knowledgeRoot}`,
+            '',
+            '| HTML | `src/main/webapp/perpage/zwplace/gxhzwplacelist.html` |',
+            '',
+        ].join('\n'), 'utf8');
+        const summary = extractCodeListSummary(codeListPath);
+        expect(summary.knowledgeRoot).toBe(knowledgeRoot);
+        expect(summary.knowledgeRootSource).toBe('code_list');
+        expect(summary.materialRefs[0]).toMatchObject({
+            kind: 'html',
+            path: htmlPath,
+            exists: true,
+        });
+    });
+    it('fails fast when code_list declares a missing knowledgeRoot', () => {
+        const root = mkdtempSync(path.join(os.tmpdir(), 'ep-stage-code-list-missing-root-'));
+        const codeListPath = path.join(root, 'code_list.md');
+        const missingKnowledgeRoot = path.join(root, 'missing-knowledge');
+        writeFileSync(codeListPath, [
+            '# 场所窗口信息管理代码清单',
+            '',
+            `knowledgeRoot: ${missingKnowledgeRoot}`,
+            '',
+            '| HTML | `src/main/webapp/perpage/zwplace/gxhzwplacelist.html` |',
+            '',
+        ].join('\n'), 'utf8');
+        expect(() => extractCodeListSummary(codeListPath)).toThrow('code_list.md 声明的 knowledgeRoot 不存在');
+    });
+});
+/**
+ * 可观测 pipeline 参数解析测试。
+ *
+ * 验证默认入口只需 --code-list，--scenario 为场景 gate 人工确认值，
+ * 调试覆盖参数可并存。
+ */
+describe('observable pipeline args', () => {
+    it('accepts code-list as the only required user entry', () => {
+        const args = parseObservablePipelineArgs([
+            '--code-list', '/repo/knowledge/_docs/code_list.md',
+        ]);
+        expect(args.codeList).toBe('/repo/knowledge/_docs/code_list.md');
+        expect(args.debugOverrides).toEqual({});
+        expect(args.scenario).toBeUndefined();
+    });
+    it('accepts --scenario as the human confirmation for the scenario gate', () => {
+        const args = parseObservablePipelineArgs([
+            '--code-list', '/repo/knowledge/_docs/code_list.md',
+            '--scenario', 'crud.single-page',
+        ]);
+        expect(args.scenario).toBe('crud.single-page');
+    });
+    it('accepts --confirm-testcases as the human confirmation for testcase gate', () => {
+        const args = parseObservablePipelineArgs([
+            '--code-list', '/repo/knowledge/_docs/code_list.md',
+            '--scenario', 'crud.nested',
+            '--confirm-testcases', 'true',
+        ]);
+        expect(args.confirmTestcases).toBe(true);
+    });
+    it('accepts code-list as default entry and keeps debug overrides', () => {
+        const args = parseObservablePipelineArgs([
+            '--code-list', '/repo/knowledge/_docs/code_list.md',
+            '--docs', '/repo/knowledge/_docs/003',
+            '--webapp', '/repo/knowledge/src/main/webapp/perpage/zwplace',
+            '--java-actions', '/repo/knowledge/src/main/java/com/epoint/zwplace/action',
+            '--module-id', 'zwplace',
+            '--menu', '场所窗口信息管理>场所窗口信息列表',
+            '--headless', 'false',
+        ]);
+        expect(args.codeList).toBe('/repo/knowledge/_docs/code_list.md');
+        expect(args.debugOverrides.docs).toBe('/repo/knowledge/_docs/003');
+        expect(args.debugOverrides.webapp).toBe('/repo/knowledge/src/main/webapp/perpage/zwplace');
+        expect(args.headless).toBe(false);
+    });
+});
+describe('interactive code_list write-back helpers', () => {
+    it('writes knowledgeRoot/menu and appends missing material refs into code_list markdown', () => {
+        const nextContent = applyCodeListWriteBack([
+            '# 场所窗口信息管理代码清单',
+            '',
+            '## 前端文件',
+            '',
+            '- `src/main/webapp/perpage/zwplace/gxhzwplacelist.html`',
+            '',
+        ].join('\n'), {
+            knowledgeRoot: '../knowledge-project/epoint-web-v9.5.2',
+            menu: '场所窗口信息管理>场所窗口信息列表',
+            materialRefs: [
+                './zwplace.module-hints.json',
+                'src/main/java/com/epoint/zwplace/action/GxhZwPlaceListAction.java',
+            ],
+        });
+        expect(nextContent).toContain('knowledgeRoot: "../knowledge-project/epoint-web-v9.5.2"');
+        expect(nextContent).toContain('menu: "场所窗口信息管理>场所窗口信息列表"');
+        expect(nextContent).toContain('## 交互补齐物料');
+        expect(nextContent).toContain('`./zwplace.module-hints.json`');
+        expect(nextContent).toContain('`src/main/java/com/epoint/zwplace/action/GxhZwPlaceListAction.java`');
+    });
+    it('expands a directory into sorted html and action refs for code_list write-back', () => {
+        const root = mkdtempSync(path.join(os.tmpdir(), 'ep-stage-writeback-refs-'));
+        const codeListPath = path.join(root, 'agent-input', 'code_list.md');
+        const htmlDir = path.join(root, 'knowledge', 'src', 'main', 'webapp', 'perpage', 'zwplace');
+        const actionDir = path.join(root, 'knowledge', 'src', 'main', 'java', 'com', 'epoint', 'zwplace', 'action');
+        mkdirSync(path.dirname(codeListPath), { recursive: true });
+        mkdirSync(htmlDir, { recursive: true });
+        mkdirSync(actionDir, { recursive: true });
+        writeFileSync(codeListPath, '# 场所窗口信息管理代码清单\n');
+        writeFileSync(path.join(htmlDir, 'b.html'), '<html></html>');
+        writeFileSync(path.join(htmlDir, 'a.html'), '<html></html>');
+        writeFileSync(path.join(actionDir, 'BAction.java'), 'class BAction {}');
+        writeFileSync(path.join(actionDir, 'AAction.java'), 'class AAction {}');
+        expect(collectCodeListMaterialRefsFromPath(codeListPath, htmlDir, 'html')).toEqual([
+            '../knowledge/src/main/webapp/perpage/zwplace/a.html',
+            '../knowledge/src/main/webapp/perpage/zwplace/b.html',
+        ]);
+        expect(collectCodeListMaterialRefsFromPath(codeListPath, actionDir, 'java_action')).toEqual([
+            '../knowledge/src/main/java/com/epoint/zwplace/action/AAction.java',
+            '../knowledge/src/main/java/com/epoint/zwplace/action/BAction.java',
+        ]);
+    });
+    it('marks main-repo knowledge-project paths as protected for write-back', () => {
+        expect(isProtectedKnowledgeProjectPath('/Users/taurus/0-ws/01-work-repo/eai-method-qa/ep-stage/knowledge-project/epoint-web-v9.5.2/_docs/code_list.md')).toBe(true);
+        expect(isProtectedKnowledgeProjectPath('/Users/taurus/0-ws/01-work-repo/eai-method-qa/ep-stage/packages/ep-stage-skill/examples/zwplace.observable.code_list.md')).toBe(false);
+    });
+});
+describe('pipeline menu resolution', () => {
+    it('prefers resolved menu inputs over inferred candidates', () => {
+        const resolution = resolveMenuRouteForPipeline({
+            menu: { status: 'resolved', value: '显式菜单>目标页', evidence: 'menu 来自 code_list.md 扎口字段' },
+            contract: createMenuContract(),
+        });
+        expect(resolution).toMatchObject({
+            status: 'resolved',
+            value: '显式菜单>目标页',
+        });
+    });
+    it('infers a reviewable menu candidate from contract module label and list page title', () => {
+        const resolution = resolveMenuRouteForPipeline({
+            menu: { status: 'missing', reason: '未提供 menu' },
+            contract: createMenuContract(),
+        });
+        expect(resolution.status).toBe('candidate');
+        if (resolution.status !== 'candidate') {
+            throw new Error('expected candidate menu resolution');
+        }
+        expect(resolution.candidates).toContain('场所窗口信息管理>场所窗口信息列表');
+    });
+});
+/**
+ * runtime gap 推理 trace 转换测试。
+ *
+ * 验证 runtimeSummaryToTrace 把 runtime 摘要转为可审阅 trace payload，
+ * 存在 needsReview workflow 时 gate 为 needs_review。
+ */
+describe('runtime gap trace', () => {
+    it('parses sentinel runtime JSON without being confused by nested objects', () => {
+        const summary = parseRuntimeSummaryOutput([
+            'runtime log before json',
+            '@@EP_STAGE_RUNTIME_SUMMARY@@',
+            JSON.stringify({
+                specPath: '/repo/e2e/glue-code-mvp/src/tests/generated-zwplace.gap.spec.ts',
+                resolvedWorkflows: ['zwplace.syncWindow'],
+                skippedWorkflows: [],
+                needsReviewWorkflows: [],
+                pageStructureSignals: [
+                    {
+                        selector: "div[class*='mini-datagrid']",
+                        staticPresent: true,
+                        runtimeVisible: true,
+                        runtimeMismatch: false,
+                        evidenceText: '列表可见',
+                    },
+                ],
+            }, null, 2),
+        ].join('\n'));
+        expect(summary.pageStructureSignals?.[0]).toMatchObject({
+            selector: "div[class*='mini-datagrid']",
+            runtimeVisible: true,
+        });
+    });
+    it('converts runtime summary into reviewable trace payload', () => {
+        const trace = runtimeSummaryToTrace({
+            specPath: '/repo/e2e/glue-code-mvp/src/tests/generated-zwplace.gap.spec.ts',
+            resolvedWorkflows: ['zwplace.syncWindow'],
+            skippedWorkflows: ['zwplace.export'],
+            needsReviewWorkflows: ['zwplace.addWindow'],
+        });
+        expect(trace.stage).toBe('runtime-gap-inference');
+        expect(trace.reasoningSummary).toMatchObject({
+            conclusion: '运行时已解决 1 个 workflow，1 个仍需人工审阅。',
+            needsHumanReview: true,
+        });
+        expect(trace.gate.status).toBe('needs_review');
+    });
+    it('records per-workflow runtime failure reasons in reviewable trace payload', () => {
+        const trace = runtimeSummaryToTrace({
+            specPath: '/repo/e2e/glue-code-mvp/src/tests/generated-zwplace.gap.spec.ts',
+            resolvedWorkflows: [],
+            skippedWorkflows: [],
+            needsReviewWorkflows: ['zwplace.addWindow'],
+            needsReviewWorkflowReasons: [
+                {
+                    workflowId: 'zwplace.addWindow',
+                    reason: '定位器未在业务 iframe 中可见',
+                },
+            ],
+        });
+        expect(trace.reasoningSummary?.evidenceChain).toContainEqual({
+            source: 'runtime',
+            path: '/repo/e2e/glue-code-mvp/src/tests/generated-zwplace.gap.spec.ts',
+            text: 'needs_review=zwplace.addWindow reason=定位器未在业务 iframe 中可见',
+        });
+        expect(trace.reasoningSummary?.risks).toContain('zwplace.addWindow 仍需人工审阅：定位器未在业务 iframe 中可见');
+    });
+    it('records runtime page structure signals in trace outputs', () => {
+        const trace = runtimeSummaryToTrace({
+            specPath: '/repo/e2e/glue-code-mvp/src/tests/generated-zwplace.gap.spec.ts',
+            resolvedWorkflows: ['zwplace.syncWindow'],
+            skippedWorkflows: [],
+            needsReviewWorkflows: [],
+            pageStructureSignals: [
+                {
+                    selector: "div[class*='mini-datagrid']",
+                    staticPresent: true,
+                    runtimeVisible: true,
+                    runtimeMismatch: false,
+                    evidenceText: '列表 iframe 中 mini-datagrid 可见',
+                },
+            ],
+        });
+        expect(trace.outputs).toContainEqual({
+            kind: 'runtime_page_structure',
+            path: "div[class*='mini-datagrid']",
+            description: 'visible',
+        });
+    });
+    it('keeps runtime implementation failures observable instead of classifying all failures as environment issues', () => {
+        const runtimeSummary = createRuntimeFailureSummary({
+            plannedWorkflows: ['zwplace.addWindow'],
+            specPath: '/repo/e2e/glue-code-mvp/src/tests/generated-zwplace.gap.spec.ts',
+            status: 1,
+            stdout: '',
+            stderr: 'SyntaxError: Unexpected token in runtime-runner.ts',
+        });
+        const trace = runtimeSummaryToTrace(runtimeSummary);
+        expect(runtimeSummary.runtimeStatus).toBe('failed');
+        expect(runtimeSummary.runtimePageStructureStatus).toBe('failed');
+        expect(trace.gate.status).toBe('needs_review');
+        expect(trace.reasoningSummary?.risks[0]).toContain('SyntaxError');
+    });
+});
+/**
+ * 尾段（spec assembly / playwright execution / glue-report）trace 转换测试。
+ */
+describe('observable pipeline tail traces', () => {
+    it('extracts LOGIN_SYSTEM_URL from a project env file', () => {
+        const root = mkdtempSync(path.join(os.tmpdir(), 'ep-stage-login-env-'));
+        const envPath = path.join(root, '.env');
+        writeFileSync(envPath, [
+            '# Stage 环境变量配置',
+            'LOGIN_SYSTEM_URL=http://192.168.203.46:8100/epoint-web/frame/pages/login/login',
+            'LOGIN_USERNAME=yz',
+        ].join('\n'), 'utf8');
+        expect(extractLoginSystemUrlFromEnvFile(envPath)).toBe('http://192.168.203.46:8100/epoint-web/frame/pages/login/login');
+    });
+    it('converts spec assembly, playwright execution and glue report into trace payloads', () => {
+        const specTrace = glueSpecAssemblyToTrace({
+            contractPath: '/repo/packages/ep-stage-skill/output/zwplace.crud.contract.json',
+            specPath: '/repo/e2e/glue-code-mvp/src/tests/generated-zwplace.gap.spec.ts',
+            menu: '场所窗口信息管理>场所窗口信息列表',
+            testcasePath: '/repo/e2e/glue-code-mvp/testcases/zwplace.glue-testcase.json',
+            generated: true,
+        });
+        expect(specTrace).toMatchObject({
+            stage: 'glue-spec-assembly',
+            gate: { status: 'confirmed' },
+            reasoningSummary: { needsHumanReview: false },
+        });
+        const playwrightTrace = playwrightExecutionToTrace({
+            specPath: '/repo/e2e/glue-code-mvp/src/tests/generated-zwplace.gap.spec.ts',
+            project: 'chromium',
+            status: 'environment_unavailable',
+            exitCode: 1,
+            stderr: 'page.goto: net::ERR_EMPTY_RESPONSE',
+            loginUrl: 'http://192.168.203.46:8100/epoint-web/frame/pages/login/login',
+            environmentEvidence: 'curl -I: Empty reply from server',
+        });
+        expect(playwrightTrace.gate.status).toBe('needs_review');
+        expect(playwrightTrace.reasoningSummary?.risks[0]).toContain('ERR_EMPTY_RESPONSE');
+        expect(playwrightTrace.reasoningSummary?.evidenceChain).toContainEqual({
+            source: 'runtime',
+            path: 'http://192.168.203.46:8100/epoint-web/frame/pages/login/login',
+            text: '环境预检：curl -I: Empty reply from server',
+        });
+        const reportTrace = glueReportToTrace({
+            projectDir: '/repo/e2e/glue-code-mvp',
+            runTimeStamp: '2026-06-16T12:00:00.000Z',
+            stageGlueReportJsonPath: '/repo/e2e/glue-code-mvp/glue-report/report.json',
+            stageGlueReportHtmlPath: '/repo/e2e/glue-code-mvp/glue-report/index.html',
+        });
+        expect(reportTrace.outputs).toContainEqual({
+            kind: 'glue_report_json',
+            path: '/repo/e2e/glue-code-mvp/glue-report/report.json',
+        });
+    });
+    it('surfaces feature_incomplete gap findings from glue-report in trace evidence', () => {
+        const reportTrace = glueReportToTrace({
+            projectDir: '/repo/e2e/glue-code-mvp',
+            stageGlueReportJsonPath: '/repo/e2e/glue-code-mvp/glue-report/report.json',
+            failedWorkflowSummaries: [
+                'zwplace.custom_da3d238e(同步窗口管理系统): 同步窗口管理系统未达成业务预期',
+            ],
+            gapFindingSummaries: [
+                'zwplace.custom_da3d238e: feature_incomplete - 运行态推理发现「同步窗口管理系统」未满足业务预期。',
+            ],
+        });
+        expect(reportTrace.reasoningSummary?.conclusion).toContain('业务缺口');
+        expect(reportTrace.reasoningSummary?.evidenceChain).toContainEqual({
+            source: 'runtime',
+            path: '/repo/e2e/glue-code-mvp/glue-report/report.json',
+            text: 'zwplace.custom_da3d238e: feature_incomplete - 运行态推理发现「同步窗口管理系统」未满足业务预期。',
+        });
+        expect(reportTrace.reasoningSummary?.risks).toContain('zwplace.custom_da3d238e: feature_incomplete - 运行态推理发现「同步窗口管理系统」未满足业务预期。');
+    });
+    it('records spec assembly failure as a reviewable trace payload', () => {
+        const trace = glueSpecAssemblyToTrace({
+            contractPath: '/repo/packages/ep-stage-skill/output/zwplace.crud.contract.json',
+            specPath: '/repo/e2e/glue-code-mvp/src/tests/generated-zwplace.gap.spec.ts',
+            menu: '场所窗口信息管理>场所窗口信息列表',
+            testcasePath: '/repo/e2e/glue-code-mvp/testcases/zwplace.glue-testcase.json',
+            generated: false,
+            exitCode: 1,
+            stderr: 'generate:playwright-tests failed',
+        });
+        expect(trace.outputs).toEqual([]);
+        expect(trace.gate.status).toBe('needs_review');
+        expect(trace.reasoningSummary?.risks[0]).toContain('generate:playwright-tests failed');
+    });
+});

package/dist/test/page-structure.test.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export {};
2	+ //# sourceMappingURL=page-structure.test.d.ts.map

package/dist/test/page-structure.test.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"page-structure.test.d.ts","sourceRoot":"","sources":["../../test/page-structure.test.ts"],"names":[],"mappings":""}

package/dist/test/page-structure.test.js ADDED Viewed

@@ -0,0 +1,45 @@
+import { mkdtempSync, writeFileSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { extractHtmlPage, summarizePageStructure } from '../src/index.js';
+/**
+ * 页面结构信号抽取与场景归纳测试。
+ *
+ * 验证 extractHtmlPage 能从 HTML 静态结构钻探出 mini-datagrid / fui-condition /
+ * mini-grid-pager 等结构信号，且 summarizePageStructure 能据此识别嵌套 CRUD 候选。
+ */
+describe('page structure signals', () => {
+    it('extracts MiniUI grid, condition, pager and nested crud signals', () => {
+        const dir = mkdtempSync(path.join(os.tmpdir(), 'ep-stage-html-'));
+        const htmlPath = path.join(dir, 'gxhzwplaceadd.html');
+        writeFileSync(htmlPath, [
+            '<html><head><title>新增场所信息管理</title></head><body>',
+            '<div class="fui-condition"><input /></div>',
+            '<a class="mini-button" onclick="addWindow()">添加窗口</a>',
+            '<a class="mini-button" onclick="deleteWindow()">删除选中</a>',
+            '<div id="windowGrid" class="mini-datagrid">',
+            '  <div property="columns">',
+            '    <div type="checkcolumn"></div>',
+            '    <div type="indexcolumn">序</div>',
+            '    <div field="windowname">窗口名称</div>',
+            '    <div field="windowtype">窗口类型</div>',
+            '    <div field="windowaddr">窗口地址</div>',
+            '  </div>',
+            '</div>',
+            '<div class="mini-grid-pager"></div>',
+            '<script>function openChild(){ epoint.openTopDialog("新增窗口", "gxhwindowadd.html"); }</script>',
+            '</body></html>',
+        ].join('\n'), 'utf8');
+        const page = extractHtmlPage(htmlPath);
+        expect(page.pageStructureSignals).toMatchObject({
+            dataGrid: { staticPresent: true, selector: "div[class*='mini-datagrid']" },
+            searchCondition: { staticPresent: true, selector: "div[class*='fui-condition']" },
+            pager: { staticPresent: true, selector: "div[class*='mini-grid-pager']" },
+        });
+        const summary = summarizePageStructure(page);
+        expect(summary.nestedCrudCandidate).toBe(true);
+        expect(summary.evidenceLabels).toContain('可见 mini-datagrid 结构存在');
+        expect(summary.evidenceLabels).toContain('可见 mini-grid-pager 结构存在');
+    });
+});

package/dist/test/scenario-inference.test.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export {};
2	+ //# sourceMappingURL=scenario-inference.test.d.ts.map

package/dist/test/scenario-inference.test.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"scenario-inference.test.d.ts","sourceRoot":"","sources":["../../test/scenario-inference.test.ts"],"names":[],"mappings":""}

package/dist/test/scenario-inference.test.js ADDED Viewed

@@ -0,0 +1,73 @@
+import { describe, expect, it } from 'vitest';
+import { applyScenarioHumanCorrection, inferPageScenarios, } from '../src/index.js';
+/**
+ * 场景推理门禁测试。
+ *
+ * 验证 inferPageScenarios 能从页面结构候选推出嵌套 CRUD 候选并停在 needs_review gate，
+ * 且 applyScenarioHumanCorrection 能记录人工纠偏并要求重跑。
+ */
+describe('scenario inference gate', () => {
+    it('infers nested CRUD candidate and requires human confirmation', () => {
+        const pages = [
+            {
+                pageId: 'gxhzwplacelist',
+                readSearchCandidate: true,
+                createCandidate: true,
+                deleteCandidate: true,
+                updateOrDetailCandidate: true,
+                nestedCrudCandidate: false,
+                evidenceLabels: ['可见 mini-datagrid 结构存在', '可见 mini-grid-pager 结构存在'],
+                risks: [],
+            },
+            {
+                pageId: 'gxhzwplaceadd',
+                readSearchCandidate: true,
+                createCandidate: true,
+                deleteCandidate: true,
+                updateOrDetailCandidate: false,
+                nestedCrudCandidate: true,
+                evidenceLabels: ['弹窗页面存在 mini-datagrid', '按钮 添加窗口', '按钮 删除选中'],
+                risks: ['嵌套 CRUD 断言和保存边界需要人工确认'],
+            },
+        ];
+        const result = inferPageScenarios({
+            moduleId: 'zwplace',
+            pages,
+            skeletonCapabilities: ['crud.create', 'crud.read', 'crud.update', 'crud.delete', 'export.run'],
+        });
+        expect(result.candidates[0]).toMatchObject({
+            scenario: 'crud.nested',
+            confidence: 'medium',
+            matchedSkeletonCapabilities: ['crud.create', 'crud.read', 'crud.delete'],
+            unresolved: ['嵌套 CRUD 断言和保存边界需要人工确认'],
+        });
+        expect(result.gate.status).toBe('needs_review');
+        expect(result.reasoningSummary.needsHumanReview).toBe(true);
+    });
+    it('records human correction and requires rerun', () => {
+        const corrected = applyScenarioHumanCorrection({
+            inference: {
+                moduleId: 'zwplace',
+                candidates: [],
+                gate: { status: 'needs_review', reason: '未识别到场景' },
+                reasoningSummary: {
+                    conclusion: '未识别到稳定场景。',
+                    evidenceChain: [],
+                    alternatives: ['unknown'],
+                    confidence: 'low',
+                    risks: ['证据不足'],
+                    needsHumanReview: true,
+                },
+            },
+            correction: '弹窗 iframe 中存在窗口明细嵌套 CRUD，重点检查添加窗口和删除选中。',
+        });
+        expect(corrected.conversationReview).toMatchObject({
+            status: 'corrected',
+            rerunRequired: true,
+        });
+        expect(corrected.reasoningSummary.evidenceChain[0]).toMatchObject({
+            source: 'human',
+            text: '弹窗 iframe 中存在窗口明细嵌套 CRUD，重点检查添加窗口和删除选中。',
+        });
+    });
+});

package/dist/test/stage-context.test.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export {};
2	+ //# sourceMappingURL=stage-context.test.d.ts.map

package/dist/test/stage-context.test.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"stage-context.test.d.ts","sourceRoot":"","sources":["../../test/stage-context.test.ts"],"names":[],"mappings":""}