@epoint-testtech/ep-stage-skill 0.0.15 → 0.0.17

package/dist/src/generators/stage-skeleton-script.js

@@ -334,6 +334,13 @@ function renderOptionalStringProperty(key, value, level) {
         return '';
     return `${' '.repeat(level)}${key}: ${singleQuoted(value)},\n`;
 }
+/** 渲染可选字符串数组属性（如 gridColumns）；缺省/空数组不渲染。 */
+function renderStringArrayProperty(key, values, level) {
+    if (!values || values.length === 0)
+        return '';
+    const items = values.map((value) => singleQuoted(value)).join(', ');
+    return `${' '.repeat(level)}${key}: [${items}],\n`;
+}
 function renderListboxSelections(selections, level) {
     if (!selections) {
         return '';
@@ -367,6 +374,50 @@ function renderListboxSelections(selections, level) {
 function renderSearchCondition(condition, level) {
     const indent = ' '.repeat(level);
     const innerIndent = ' '.repeat(level + 4);
+    if (condition.component === 'datepicker') {
+        const lines = [
+            `${innerIndent}component: 'datepicker',`,
+            `${innerIndent}field: ${singleQuoted(condition.field)},`,
+            `${innerIndent}label: ${singleQuoted(condition.label)},`,
+        ];
+        if (condition.listLocator !== undefined) {
+            lines.push(`${innerIndent}listLocator: ${locatorLiteral(condition.listLocator)},`);
+        }
+        if (condition.searchText !== undefined) {
+            lines.push(`${innerIndent}searchText: ${singleQuoted(condition.searchText)},`);
+        }
+        if (condition.triggerSearch !== undefined) {
+            lines.push(`${innerIndent}triggerSearch: ${condition.triggerSearch},`);
+        }
+        if (condition.searchAssertion !== undefined) {
+            lines.push(`${innerIndent}searchAssertion: ${singleQuoted(condition.searchAssertion)},`);
+        }
+        return `${indent}{
+${lines.join('\n')}
+${indent}}`;
+    }
+    if (condition.component === 'tree') {
+        const lines = [
+            `${innerIndent}component: 'tree',`,
+            `${innerIndent}field: ${singleQuoted(condition.field)},`,
+            `${innerIndent}label: ${singleQuoted(condition.label)},`,
+        ];
+        if (condition.treeLocator !== undefined) {
+            lines.push(`${innerIndent}treeLocator: ${locatorLiteral(condition.treeLocator)},`);
+        }
+        if (condition.nodeStrategy !== undefined) {
+            lines.push(`${innerIndent}nodeStrategy: ${singleQuoted(condition.nodeStrategy)},`);
+        }
+        if (condition.searchOnSelect !== undefined) {
+            lines.push(`${innerIndent}searchOnSelect: ${condition.searchOnSelect},`);
+        }
+        if (condition.searchAssertion !== undefined) {
+            lines.push(`${innerIndent}searchAssertion: ${singleQuoted(condition.searchAssertion)},`);
+        }
+        return `${indent}{
+${lines.join('\n')}
+${indent}}`;
+    }
     if (condition.component === 'listbox') {
         const lines = [
             `${innerIndent}component: 'listbox',`,
@@ -433,8 +484,8 @@ ${renderOptionalStringProperty('deleteConfirmButton', slots.locators.deleteConfi
         assertions: {
             deletePolicy: ${singleQuoted(slots.assertions.deletePolicy)},
 ${renderOptionalStringProperty('blockedDeleteMessage', slots.assertions.blockedDeleteMessage, 12)}
-${slots.assertions.conditionalDelete ? '            conditionalDelete: true,\n' : ''}        },
-    }`;
+${slots.assertions.conditionalDelete ? '            conditionalDelete: true,\n' : ''}${renderOptionalStringProperty('searchResponseUrlKeyword', slots.assertions.searchResponseUrlKeyword, 12)}        },
+${renderStringArrayProperty('gridColumns', slots.gridColumns, 8)}    }`;
 }
 function renderChildGridColumns(columns, level) {
     const indent = ' '.repeat(level);
@@ -793,13 +844,20 @@ function renderCrudCaseTests(cases, context) {
         await crudPage.runCreateWorkflow(data);`;
                 break;
             case 'read':
-                body = `        await openModule(page);
+                // 无 create 用例（只读模块，如纯统计报表）时 read 无 workflowData 可依赖，
+                // 退化为独立查询：操作查询控件并触发搜索，不断言特定数据命中；
+                // 骨架返回执行结论（passed / needs_review 需人工复核），由 body 回传给报告层。
+                body = dataKey === ''
+                    ? `        await openModule(page);
+        const crudPage = new CrudPage(page, crudSlots);
+        return crudPage.runStandaloneReadWorkflowByField(${singleQuoted(key)});`
+                    : `        await openModule(page);
         const data = workflowDataByKey[${singleQuoted(dataKey)}];
         if (!data) {
           throw new Error(${singleQuoted(`${testCase.title} 依赖 create（${dataKey}）用例先行生成 workflowData`)});
         }
         const crudPage = new CrudPage(page, crudSlots);
-        await crudPage.runReadWorkflowByField(data, ${singleQuoted(key)});`;
+        return crudPage.runReadWorkflowByField(data, ${singleQuoted(key)});`;
                 break;
             case 'update':
                 body = `        await openModule(page);
@@ -890,8 +948,8 @@ function renderExportSlotsFromSlot(exportSlot, listIframeSrcKeyword) {
             listIframeSrcKeyword: ${singleQuoted(listIframeSrcKeyword)},
         },
         locators: {
-            exportButton: '.mini-button.mini-dataexport',
-        },
+            exportButton: ${singleQuoted(exportSlot.locators?.exportButton ?? '.mini-button.mini-dataexport')},
+${renderOptionalStringProperty('exportContainer', exportSlot.locators?.exportContainer, 12)}        },
         export: {
             label: ${singleQuoted(exportSlot.label)},
             mode: ${exportSlot.mode === 'all' ? "'all' as const" : singleQuoted(exportSlot.mode)},
@@ -943,9 +1001,13 @@ export function generateStageSkeletonCrudSpecFromSlots(options) {
     const exportCaseRef = (glueCases ?? []).find((testCase) => testCase.title.endsWith(' export'));
     return `import { test, expect, type Page } from '@playwright/test';
 import { loadCredentials, StagePath, type Credential } from '@epoint-testtech/stage-core';
-import { CrudPage, ExportPage, LoginPage${childGridImport}, type CrudFlowSlots, type ExportFlowSlots, type CrudWorkflowData } from '../../skeletons';
+import { CrudPage, ExportPage, LoginPage${childGridImport}, type CrudFlowSlots, type ExportFlowSlots, type CrudWorkflowData, type LoginSlots } from '../../skeletons';
 import { GlueWorkflowRecorder, runRecordedWorkflow, type GlueWorkflowRecordInput } from '../../report/glue-report';
 
+// loginSlots 为 credentials.json5 的可选扩展字段：stage-core 的 loadCredentials 运行时整体透传，
+// 类型由 login 骨架本地定义（不依赖 stage-core 导出），此处做交叉类型补齐。
+type GlueCredential = Credential & { loginSlots?: LoginSlots };
+
 test.describe(${singleQuoted(suiteTitle)}, () => {
   const directListUrl = ${singleQuoted(directUrl)};
   const credentialsPath = \`\${StagePath.projectRootDirPath}/src/tests/${requirementName}/credentials.json5\`;
@@ -973,7 +1035,7 @@ ${childGridSlots?.length ? `  const childGridSlots: ChildGridFlowSlots[] = ${ren
     recorder.writeReport();
   });
 
-  function resolveCredential(role: string): Credential {
+  function resolveCredential(role: string): GlueCredential {
     const [credential] = loadCredentials(credentialsPath, role);
     if (!credential) {
       throw new Error(\`credentials.json5 中未找到角色: \${role}\`);
@@ -981,15 +1043,16 @@ ${childGridSlots?.length ? `  const childGridSlots: ChildGridFlowSlots[] = ${ren
     return credential;
   }
 
-  function applyLoginCredential(credential: Credential): void {
+  function applyLoginCredential(credential: GlueCredential): void {
     process.env.LOGIN_SYSTEM_URL = credential.url;
     process.env.LOGIN_USERNAME = credential.username;
     process.env.LOGIN_PASSWORD = credential.password;
   }
 
   async function openModule(page: Page): Promise<void> {
-    applyLoginCredential(resolveCredential(primaryRole));
-    const loginPage = new LoginPage(page);
+    const credential = resolveCredential(primaryRole);
+    applyLoginCredential(credential);
+    const loginPage = new LoginPage(page, credential.loginSlots);
     await loginPage.login();
     await loginPage.gotoDirectUrl(directListUrl);
   }

package/dist/src/runtime/ai-runtime-trace.d.ts

@@ -22,6 +22,12 @@ export type AiRuntimeResult = {
         source: string;
         note: string;
     }>;
+    /**
+     * 人工复审原因（needs_review 专用）：Agent O-D-A-V 的差异化证据结论
+     * （字段是否在列表列、默认值、尝试值及来源、搜索前后数量）。
+     * CLI 生成的占位 result 无此字段，报告层回退 observation.summary。
+     */
+    reviewReason?: string;
 };
 export type RepairRound = {
     round: number;

package/dist/src/runtime/ai-runtime-trace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-runtime-trace.d.ts","sourceRoot":"","sources":["../../../src/runtime/ai-runtime-trace.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,cAAc,GAAG,QAAQ,CAAC;AAEjG,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,cAAc,CAAC;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,EAAE,8BAA8B,CAAC;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB,GAAG,cAAc,CASjB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAGlF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,OAAO,CAAC;CAC9B,CAmCA;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAyBT"}
+{"version":3,"file":"ai-runtime-trace.d.ts","sourceRoot":"","sources":["../../../src/runtime/ai-runtime-trace.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,cAAc,GAAG,QAAQ,CAAC;AAEjG,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,cAAc,CAAC;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,EAAE,8BAA8B,CAAC;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB,GAAG,cAAc,CASjB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAGlF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,OAAO,CAAC;CAC9B,CAmCA;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAyBT"}

package/dist/src/testcase/contract-testcase-assembler.d.ts

@@ -17,6 +17,7 @@
  */
 import type { ExtractedCodeListJson5 } from '../extractors/code-list-json5.js';
 import type { EpStageContractV1Draft } from '../contracts/glue-contract-v1.js';
+import { type QueryComponentKind } from './query-component-map.js';
 import type { EpStageTestcaseV1Draft } from './testcase-v1-draft.js';
 /** assembler 输入。 */
 export type AssembleInput = {
@@ -42,23 +43,41 @@ type GlueActionKind = 'create' | 'read' | 'update' | 'delete' | 'export';
 export type CrudCaseStage = {
     actionKind: GlueActionKind;
     queryKeyLabel: string;
-    component: 'input' | 'listbox';
+    component: QueryComponentKind;
 };
 /**
  * 按查询字段推导 CRUD 用例阶段序列。
  *
- * 规则：在新增表单中出现的查询字段（可写）产出完整 create/read/update/delete 四条；
+ * 规则：input/listbox 且在新增表单中出现的查询字段（可写）产出完整 create/read/update/delete 四条；
+ * datepicker/tree 不参与 create/update/delete（createSelections 机制只认 listbox），一律只产 read 一条；
  * 不在表单中的字段（如系统管理的状态）只产出 read 一条。
  * export 不在此计划内，由装配器单独追加。
  *
- * @param searchFields - 列表页查询字段（有序）。
+ * @param searchFields - 列表页查询字段（有序，仅含白名单组件）。
  * @param formFieldLabels - 新增表单字段标签集合。
  * @returns 有序阶段计划，顺序与 buildGlueCases 产出的用例顺序一一对应。
  */
 export declare function planCrudCaseStages(searchFields: Array<{
     label: string;
-    component: 'input' | 'listbox';
+    component: QueryComponentKind;
 }>, formFieldLabels: string[]): CrudCaseStage[];
+/**
+ * 生成 glue 用例执行字段。
+ *
+ * @param actionKind - CRUD / Export 动作类型。
+ * @param queryKey - 当前用例查询主键。
+ * @param searchFieldLabels - 列表页查询字段标签集合。
+ * @param dataKeyLabel - dataKey 对应的中文标签。
+ * @param deleteOutcome - 删除策略（与 skeletonSlots.assertions.deletePolicy 同源），
+ *   仅 delete 用例消费；缺省按 success_delete 出文案。
+ * @returns testcase 执行字段。
+ */
+export declare function buildGlueExecutionFields(actionKind: GlueActionKind, queryKeyLabel: string, queryComponent: QueryComponentKind, queryKeyInForm: boolean, searchFieldLabels: string[], dataKeyLabel?: string, deleteOutcome?: {
+    deletePolicy: 'success_delete' | 'blocked_by_business_rule';
+    blockedDeleteMessage?: string;
+    /** 条件性删除（如"草稿可删、在用不可删"）：删除断言写双预期，运行时按实际结果分流 */
+    conditional?: boolean;
+}): Pick<EpStageTestcaseV1Draft['cases'][number], 'queryKey' | 'precondition' | 'steps' | 'assertion'>;
 /**
  * 装配 contract + testcase + inference-trace 账本。
  *

package/dist/src/testcase/contract-testcase-assembler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract-testcase-assembler.d.ts","sourceRoot":"","sources":["../../../src/testcase/contract-testcase-assembler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAA2E,MAAM,kCAAkC,CAAC;AACxJ,OAAO,KAAK,EAAE,sBAAsB,EAAqB,MAAM,kCAAkC,CAAC;AAElG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AASrE,oBAAoB;AACpB,MAAM,MAAM,aAAa,GAAG;IAC1B,iCAAiC;IACjC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,gEAAgE;AAChE,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,sBAAsB,CAAC;IACjC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC,CAAC;AAkZF,mBAAmB;AACnB,KAAK,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,cAAc,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE,CAAC,EACtE,eAAe,EAAE,MAAM,EAAE,GACxB,aAAa,EAAE,CAejB;AAsbD;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAyLrF"}
+{"version":3,"file":"contract-testcase-assembler.d.ts","sourceRoot":"","sources":["../../../src/testcase/contract-testcase-assembler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAA2E,MAAM,kCAAkC,CAAC;AACxJ,OAAO,KAAK,EAAE,sBAAsB,EAA2C,MAAM,kCAAkC,CAAC;AACxH,OAAO,EAAyB,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE1F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AASrE,oBAAoB;AACpB,MAAM,MAAM,aAAa,GAAG;IAC1B,iCAAiC;IACjC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,gEAAgE;AAChE,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,sBAAsB,CAAC;IACjC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC,CAAC;AA2cF,mBAAmB;AACnB,KAAK,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,cAAc,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,kBAAkB,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,kBAAkB,CAAA;CAAE,CAAC,EACrE,eAAe,EAAE,MAAM,EAAE,GACxB,aAAa,EAAE,CAgBjB;AA2CD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,cAAc,EAC1B,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,kBAAkB,EAClC,cAAc,EAAE,OAAO,EACvB,iBAAiB,EAAE,MAAM,EAAE,EAC3B,YAAY,CAAC,EAAE,MAAM,EACrB,aAAa,CAAC,EAAE;IACd,YAAY,EAAE,gBAAgB,GAAG,0BAA0B,CAAC;IAC5D,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACA,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,cAAc,GAAG,OAAO,GAAG,WAAW,CAAC,CA8GpG;AAiTD;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CA6QrF"}

package/dist/src/testcase/contract-testcase-assembler.js

@@ -15,6 +15,7 @@
  * - locators：用 014 草案已确认的框架默认（MiniUI 默认规则 + text=确定 等），不进 unresolvedSlots
  * - assertions.deletePolicy='success_delete'（MiniUI 默认删除成功策略）
  */
+import { resolveQueryComponent } from './query-component-map.js';
 import { extractHtmlPage } from '../extractors/html-page.js';
 import { inferButtonInteractions, } from './button-interaction-inference.js';
 import { existsSync } from 'node:fs';
@@ -72,6 +73,33 @@ function buildCrudLocators(listPage) {
         deleteConfirmButton: 'text=确定',
     };
 }
+/**
+ * 从 list 页事实推导导出按钮定位器。
+ *
+ * 推导优先级（无来源不入契约的落地）：
+ * 1. toolbarActions 中命中导出组件（backendMethod=getExportModel / component=mini-dataexport / label=导出）
+ *    且 elementHints 带 id → `xpath=//*[@id='<id>']`（页面级唯一锚点，最稳）；
+ * 2. 命中导出组件但无 id 线索 → `a.mini-dataexport`（MiniUI 导出组件实际渲染类名，
+ *    历史默认 '.mini-button.mini-dataexport' 多假设了 mini-button 类，实测页面并无该类）；
+ * 3. 页面无导出事实 → 回退历史框架默认 '.mini-button.mini-dataexport'。
+ */
+function buildExportButtonLocator(listPage) {
+    const exportToolbar = (listPage.toolbarActions ?? []).find((t) => {
+        return t.backendMethod === 'getExportModel' || t.component === 'mini-dataexport' || t.label === '导出';
+    });
+    const idHint = exportToolbar?.elementHints?.find((h) => h.attr === 'id' && h.value)?.value;
+    if (idHint) {
+        return `xpath=//*[@id='${idHint}']`;
+    }
+    if (exportToolbar?.component === 'mini-dataexport') {
+        return 'a.mini-dataexport';
+    }
+    const exportButton = (listPage.buttons ?? []).find((b) => b.action === 'export');
+    if (exportButton) {
+        return `xpath=//a[contains(@class,'mini-dataexport')][normalize-space()='${exportButton.label || '导出'}']`;
+    }
+    return '.mini-button.mini-dataexport';
+}
 /**
  * 从 code_list.pages[role=list/add/edit].pageId 提取 iframe src keyword。
  *
@@ -275,19 +303,29 @@ function buildChildGridSlots(codeList, sourceRootOverride) {
     return slots.length > 0 ? slots : undefined;
 }
 /**
- * 把 list 页 queryFields 映射成 skeletonSlots.crud.searchConditions（input/listbox 二分）。
+ * 把 list 页 queryFields 映射成 skeletonSlots.crud.searchConditions。
+ *
+ * 白名单语义（query-component-map.ts 单一事实来源）：
+ * - input/listbox/datepicker/tree → 生成对应槽位；
+ * - 未识别组件（显式写了但不在映射表）→ 返回 null 不进槽位，用例由 AI 桶承载；
+ * - 上游未写 component → 回退 input（保住 CRUD 锚点主链路），由调用方记 inference-trace。
  *
  * @param codeList - 解析后的 code_list。
  * @param listPage - 列表页 page item。
- * @returns 对齐 StageSkeletonCrudSearchConditionSlot 的槽位数组。
+ * @returns 对齐 StageSkeletonCrudSearchConditionSlot 的槽位数组（null 已过滤）。
  */
 function buildSearchConditionSlots(codeList, listPage, addOrEditPage) {
     const addFormLabels = new Set((addOrEditPage?.formFields ?? [])
         .filter((f) => typeof f !== 'string')
         .map((f) => f.label));
-    return (listPage.queryFields ?? []).map((fieldInfo) => {
+    return (listPage.queryFields ?? [])
+        .map((fieldInfo) => {
         const field = mapQueryFieldToField(fieldInfo);
-        const component = normalizeQueryComponent(fieldInfo);
+        const resolution = resolveQueryComponent(fieldInfo);
+        if (resolution.source === 'unrecognized') {
+            return null;
+        }
+        const component = resolution.kind;
         if (component === 'input') {
             // MiniUI mini-textbox 的 name 属性通常是 `dataBean.<field>` 或省略；只有 label 属性稳定。
             // 用 label 定位 outer div (mini-textbox 容器)，再取内部 input.mini-textbox-input。
@@ -303,6 +341,33 @@ function buildSearchConditionSlots(codeList, listPage, addOrEditPage) {
                 listLocator: miniTextboxByLabel,
             };
         }
+        if (component === 'datepicker') {
+            // mini-daterangepicker/mini-datepicker：单输入框形态。优先用 elementHints 的 id 锚点，
+            // 缺省按 label 容器派生；运行态若发现默认值无法形成有效过滤证据，再由 demote/ODAV 接管原用例。
+            const idHint = (fieldInfo.elementHints ?? []).find((h) => h.attr === 'id' && h.value)?.value;
+            return {
+                component: 'datepicker',
+                field,
+                label: fieldInfo.label,
+                listLocator: idHint ? `xpath=//*[@id='${idHint}']` : `xpath=//div[@label='${fieldInfo.label}']//input`,
+                searchAssertion: 'none',
+                triggerSearch: true,
+            };
+        }
+        if (component === 'tree') {
+            // mini-filtertree：左树右表，默认按页面既有 nodeselect 联动执行；若真实页面需要显式搜索，
+            // 由运行失败后的 demote/ODAV 保底接管原用例。
+            const idHint = (fieldInfo.elementHints ?? []).find((h) => h.attr === 'id' && h.value)?.value;
+            return {
+                component: 'tree',
+                field,
+                label: fieldInfo.label,
+                ...(idHint ? { treeLocator: `#${idHint}` } : {}),
+                nodeStrategy: 'first_leaf',
+                searchOnSelect: true,
+                searchAssertion: 'none',
+            };
+        }
         // listbox：真实下拉值来自 dataOptions 字典 (运行时才能确认)，assembler 不猜值；
         // 用 skeleton 支持的 valueStrategy=first_non_placeholder + skipValues=['请选择'] 让运行时
         // 选首个有效项。searchAssertion='none' 表示 Read 工作流不对 listbox 校验命中数（因为选到
@@ -329,7 +394,8 @@ function buildSearchConditionSlots(codeList, listPage, addOrEditPage) {
                 ]
                 : [],
         };
-    });
+    })
+        .filter((slot) => slot !== null);
 }
 /**
  * 把 code_list 中文 label 映射到契约 field（kebab-ish 英文）。
@@ -350,30 +416,23 @@ function mapQueryFieldToField(fieldInfo) {
     const bindMatch = fieldInfo.bind?.match(/dataBean\.([A-Za-z0-9_]+)/);
     return bindMatch?.[1] ?? mapLabelToField(fieldInfo.label);
 }
-/**
- * 归一化 queryFields 的组件类型，支持上游摘要用 component=mini-textbox/mini-combobox。
- */
-function normalizeQueryComponent(fieldInfo) {
-    const raw = fieldInfo.type ?? fieldInfo.component ?? '';
-    if (raw === 'input' || raw === 'mini-textbox')
-        return 'input';
-    return 'listbox';
-}
 /**
  * 按查询字段推导 CRUD 用例阶段序列。
  *
- * 规则：在新增表单中出现的查询字段（可写）产出完整 create/read/update/delete 四条；
+ * 规则：input/listbox 且在新增表单中出现的查询字段（可写）产出完整 create/read/update/delete 四条；
+ * datepicker/tree 不参与 create/update/delete（createSelections 机制只认 listbox），一律只产 read 一条；
  * 不在表单中的字段（如系统管理的状态）只产出 read 一条。
  * export 不在此计划内，由装配器单独追加。
  *
- * @param searchFields - 列表页查询字段（有序）。
+ * @param searchFields - 列表页查询字段（有序，仅含白名单组件）。
  * @param formFieldLabels - 新增表单字段标签集合。
  * @returns 有序阶段计划，顺序与 buildGlueCases 产出的用例顺序一一对应。
  */
 export function planCrudCaseStages(searchFields, formFieldLabels) {
     const stages = [];
     for (const field of searchFields) {
-        if (formFieldLabels.includes(field.label)) {
+        const canWrite = field.component === 'input' || field.component === 'listbox';
+        if (canWrite && formFieldLabels.includes(field.label)) {
             stages.push({ actionKind: 'create', queryKeyLabel: field.label, component: field.component }, { actionKind: 'read', queryKeyLabel: field.label, component: field.component }, { actionKind: 'update', queryKeyLabel: field.label, component: field.component }, { actionKind: 'delete', queryKeyLabel: field.label, component: field.component });
         }
         else {
@@ -425,7 +484,7 @@ function pickQueryKeyLabel(label, searchFieldLabels, dataKeyLabel) {
  *   仅 delete 用例消费；缺省按 success_delete 出文案。
  * @returns testcase 执行字段。
  */
-function buildGlueExecutionFields(actionKind, queryKeyLabel, queryComponent, queryKeyInForm, searchFieldLabels, dataKeyLabel, deleteOutcome) {
+export function buildGlueExecutionFields(actionKind, queryKeyLabel, queryComponent, queryKeyInForm, searchFieldLabels, dataKeyLabel, deleteOutcome) {
     const queryKey = actionKind === 'export'
         ? pickQueryKeyLabel(dataKeyLabel ?? searchFieldLabels[0] ?? '不适用', searchFieldLabels, dataKeyLabel)
         : pickQueryKeyLabel(queryKeyLabel, searchFieldLabels, dataKeyLabel);
@@ -458,7 +517,7 @@ function buildGlueExecutionFields(actionKind, queryKeyLabel, queryComponent, que
                     `1. 在列表页${queryKey}查询条件中输入或选择一个有效查询值。`,
                     '2. 点击{{查询按钮}}。',
                 ].join(' '),
-                assertion: '查询动作应完成，列表刷新或查询请求被触发；本用例不强制断言列表数据命中数量。',
+                assertion: '查询请求应真实发出且成功；搜索前后列表总数应可读取并对比——数据量无变化或查询字段不在列表列时，本用例标记为需人工复核。',
             };
         }
         return {
@@ -659,6 +718,42 @@ function buildUncoveredCandidates(gapCandidates, firstRole, sequence, codeList,
         };
     });
 }
+/**
+ * 为未识别组件的查询字段构建 AI 候选用例。
+ *
+ * 与 buildUncoveredCandidates（custom 按钮路径）分离：查询字段无按钮元数据可反查，
+ * 直接按字段事实生成「操作查询控件并触发查询」的 AI 任务。
+ *
+ * @param queryFieldResolutions - 查询字段与其组件解析结果。
+ * @param firstRole - 首个角色（用作 requiredRole）。
+ * @param sequence - 用例编号上下文。
+ */
+function buildQueryComponentUncoveredCandidates(queryFieldResolutions, firstRole, sequence) {
+    return queryFieldResolutions
+        .filter((r) => r.resolution.source === 'unrecognized')
+        .map(({ fieldInfo, resolution }) => {
+        const raw = resolution.source === 'unrecognized' ? resolution.raw : '';
+        const steps = [
+            `1. 在列表页定位「${fieldInfo.label}」查询控件（原始组件 ${raw}，骨架 glue 白名单未覆盖）。`,
+            '2. 观察控件真实形态并完成一次有效查询值设置（如下拉选项、日期范围、树节点等）。',
+            '3. 触发查询（点击查询按钮或控件自带联动）。',
+        ].join(' ');
+        const assertion = `「${fieldInfo.label}」查询链路应可驱动：查询请求被触发，列表刷新或返回结果。`;
+        return {
+            caseId: nextCaseId(sequence),
+            label: `${fieldInfo.label}查询（组件 ${raw}）`,
+            generationStrategy: 'ai',
+            coverageStatus: 'gap',
+            requiredRole: firstRole,
+            businessIntent: `覆盖查询字段「${fieldInfo.label}」（原始组件 ${raw} 未在 glue 白名单，需运行时观察交互）。`,
+            assertionExpectation: assertion,
+            queryKey: fieldInfo.label,
+            precondition: `1. 使用角色：${firstRole}。 2. 完成系统登录并进入目标待测页面。`,
+            steps,
+            assertion,
+        };
+    });
+}
 /**
  * 按 code_list 里的系统与角色事实生成 testcase.testAccess 占位。
  *
@@ -714,10 +809,27 @@ export function assembleJson5ContractAndTestcase(input) {
         codeList.roles[0]?.role ??
         '业务角色待确认';
     const directUrl = resolveDirectUrl(input, listPage);
-    const searchFields = (listPage.queryFields ?? []).map((fieldInfo) => ({
+    // 组件形态解析：白名单（input/listbox/datepicker/tree）写规范 kind 进契约；
+    // input/listbox 进入 glue，datepicker/tree 的查询语义由 ODAV 保底；
+    // 上游显式写了但未识别的组件保留原始字符串，用例路由 AI 桶，不再静默压扁成 listbox。
+    const queryFieldResolutions = (listPage.queryFields ?? []).map((fieldInfo) => ({
+        fieldInfo,
+        resolution: resolveQueryComponent(fieldInfo),
+    }));
+    const searchFields = queryFieldResolutions.map(({ fieldInfo, resolution }) => ({
         field: mapQueryFieldToField(fieldInfo),
         label: fieldInfo.label,
-        component: normalizeQueryComponent(fieldInfo),
+        component: resolution.source === 'unrecognized'
+            ? resolution.raw
+            : resolution.kind,
+    }));
+    // glue 通道承载所有已识别的通用查询字段；若运行态证明某个字段的骨架动作不足，
+    // 再通过 demote/ODAV 接管原 glue 用例，不在装配期拆成第二条用例。
+    const glueSearchFields = queryFieldResolutions
+        .filter((r) => r.resolution.source !== 'unrecognized')
+        .map(({ fieldInfo, resolution }) => ({
+        label: fieldInfo.label,
+        component: resolution.kind,
     }));
     const searchFieldLabels = searchFields.map((fieldInfo) => fieldInfo.label);
     const addOrEditPage = codeList.pages.find((p) => p.role === 'add') ?? codeList.pages.find((p) => p.role === 'edit');
@@ -766,10 +878,51 @@ export function assembleJson5ContractAndTestcase(input) {
             // 条件性删除标记：骨架 runDeleteWorkflow 据此在运行时按「记录是否仍存在」分流断言
             // （存在 → 断言阻断文案；不存在 → 断言删除成功），而非 slots 级单一预期。
             ...(conditionalDelete ? { conditionalDelete: true } : {}),
+            // 查询请求级断言关键字：FUI 框架的查询请求走 `/rest/<模块路径>/<restController>/page_Refresh`
+            // 通用端点（方法名在加密 body 里，不在 URL——001 运行时实据），因此用 initAction
+            // （restController 名，出现在 URL 路径）作关键字；initAction 缺失时回退 dataGrid.backendMethod。
+            ...((listPage.initAction ?? listPage.dataGrid?.backendMethod)
+                ? { searchResponseUrlKeyword: listPage.initAction ?? listPage.dataGrid?.backendMethod }
+                : {}),
         },
     };
+    // 列表页列头标签：搜索校验的「字段列可见性」判定依据（查询字段不在列中时骨架标记需人工复核）
+    const gridColumns = (listPage.dataGrid?.columns ?? [])
+        .map((column) => column.label)
+        .filter((label) => Boolean(label));
+    if (gridColumns.length > 0) {
+        skeletonSlotsCrud.gridColumns = gridColumns;
+    }
     const childGridSlots = buildChildGridSlots(codeList, input.sourceRoot);
-    // 动态推导 gapCandidates：当前阶段只保留控件类 custom 按钮。
+    // unresolvedSlots：装配期无法确认的槽位显式登记（契约可观测性 gate）。
+    const unresolvedSlots = [];
+    // 1) 未识别查询组件 → AI 通道路由登记
+    for (const { fieldInfo, resolution } of queryFieldResolutions) {
+        if (resolution.source !== 'unrecognized')
+            continue;
+        unresolvedSlots.push({
+            slotPath: `scenario.searchFields[${fieldInfo.label}]`,
+            kind: 'unsupported_query_component',
+            rawComponent: resolution.raw,
+            reason: `查询字段「${fieldInfo.label}」的组件 ${resolution.raw} 不在 glue 白名单映射表（query-component-map.ts），用例改走 AI 通道。`,
+            suggestedAction: 'ai_runtime',
+            detectedAt: 'assemble',
+            evidence: { source: 'code_list', ref: `pages[role=list].queryFields[${fieldInfo.label}]` },
+        });
+    }
+    // 2) 多列表页显式化：当前管线只装配第一个 list 页，其余登记待人工拆分
+    const listPages = codeList.pages.filter((p) => p.role === 'list');
+    if (listPages.length > 1) {
+        unresolvedSlots.push({
+            slotPath: 'scenario.skeletonSlots.crud',
+            kind: 'multi_list_page',
+            reason: `code_list 含 ${listPages.length} 个 role=list 页面，当前管线仅装配第一个（${listPage.pageId ?? listPage.path}），跳过：${listPages.slice(1).map((p) => p.pageId ?? p.path).join('、')}。`,
+            suggestedAction: 'manual_split',
+            detectedAt: 'assemble',
+            evidence: { source: 'code_list', ref: 'pages[role=list]' },
+        });
+    }
+    // 动态推导 gapCandidates：当前阶段保留控件类 custom 按钮 + 未识别组件查询字段。
     // 状态流转、子表、详情、统计看板/移动端等 PRD-only/业务类场景暂不进 gapCandidates，
     // 后续可通过 code_list.gapHints 让业务人工声明后再扩展。
     const gapCandidates = [];
@@ -783,6 +936,16 @@ export function assembleJson5ContractAndTestcase(input) {
             generationStrategy: 'ai',
         });
     });
+    // 未识别组件查询字段进 AI 桶（gapId 规范：query-component:<field>）
+    for (const { fieldInfo, resolution } of queryFieldResolutions) {
+        if (resolution.source !== 'unrecognized')
+            continue;
+        gapCandidates.push({
+            gapId: `query-component:${mapQueryFieldToField(fieldInfo)}`,
+            label: fieldInfo.label,
+            generationStrategy: 'ai',
+        });
+    }
     const contract = {
         schemaVersion: 'ep-stage-contract/v1-draft',
         contractId: `${module}-contract`,
@@ -800,15 +963,20 @@ export function assembleJson5ContractAndTestcase(input) {
             searchFields,
             skeletonSlots: {
                 crud: skeletonSlotsCrud,
-                export: { moduleId: module, label: '导出', mode: 'all' },
+                export: {
+                    moduleId: module,
+                    label: '导出',
+                    mode: 'all',
+                    locators: { exportButton: buildExportButtonLocator(listPage) },
+                },
                 childGrids: childGridSlots,
             },
             gapCandidates,
         },
-        unresolvedSlots: [], // 框架默认策略都已确认，不进 unresolvedSlots
+        unresolvedSlots,
     };
     const caseIdSequence = { pageIndex: 1, nextCaseIndex: 1 };
-    const cases = buildGlueCases(moduleName, searchFields, formFieldLabels, caseIdSequence, dataKeyLabel, {
+    const cases = buildGlueCases(moduleName, glueSearchFields, formFieldLabels, caseIdSequence, dataKeyLabel, {
         deletePolicy,
         blockedDeleteMessage,
         conditional: conditionalDelete,
@@ -819,6 +987,8 @@ export function assembleJson5ContractAndTestcase(input) {
         sourceRootOverride: input.sourceRoot,
     });
     const uncoveredCandidates = buildUncoveredCandidates(gapCandidates, firstRole, caseIdSequence, codeList, buttonInferences);
+    // 未识别组件查询字段的 AI 候选（按钮反查路径不适用，独立构建）
+    uncoveredCandidates.push(...buildQueryComponentUncoveredCandidates(queryFieldResolutions, firstRole, caseIdSequence));
     const testcase = {
         schemaVersion: 'ep-stage-testcase/v1-draft',
         testcaseId: `${module}-testcase`,
@@ -843,20 +1013,27 @@ export function assembleJson5ContractAndTestcase(input) {
                 source: 'framework-default',
                 reason: '014 草案已确认 MiniUI 默认规则 + text=确定 确认按钮 + addAutofillTrigger 默认能力',
             },
+            exportButtonLocator: {
+                source: 'code-list-derived',
+                reason: '优先取 list 页 toolbarActions 导出组件的 elementHints id；无 id 时按 mini-dataexport 实际渲染类名兜底',
+            },
             assertions: {
                 source: 'framework-default',
                 reason: "deletePolicy='success_delete'（MiniUI 默认删除成功策略）",
             },
             queryFields: {
                 source: 'code-list-derived',
-                reason: 'placename 为 dataKey 用 timestamp_prefix；listbox 取首项作 value',
+                reason: '组件形态经 query-component-map.ts 显式映射：白名单（input/listbox/datepicker/tree）进契约槽位；' +
+                    '所有已识别组件进入 glue，用例先走通用骨架；运行态若语义超出骨架，再由同一 caseId 的 ODAV 接管；' +
+                    '未识别组件进 AI 桶并登记 unresolvedSlots；上游未写 component 回退 input（defaulted，待 calibrate 运行时纠正）。' +
+                    'input 的 dataKey 字段用 timestamp_prefix；listbox 取首项作 value',
             },
             childGrids: {
                 source: 'html-derived',
                 reason: '从 add/edit 页 HTML 的 datagrid 列 editor.type 推导 component；locators 按 MiniUI 子表默认规则生成',
             },
         },
-        unresolvedSlotsCount: 0,
+        unresolvedSlotsCount: unresolvedSlots.length,
         customButtonInferences: Array.from(buttonInferences.values()).map((inf) => ({
             label: inf.label,
             pattern: inf.pattern,