@epoint-testtech/ep-stage-skill 0.0.9 → 0.5.0-alpha.2

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

@@ -24,8 +24,6 @@ export type AssembleInput = {
     codeList: ExtractedCodeListJson5;
     /** 待测列表页直达地址，由 skill 交互或运行配置显式传入。 */
     directUrl?: string;
-    /** 源码根目录覆盖（可选），用于解析 pages.list.path。 */
-    sourceRoot?: string;
 };
 /** assembler 输出：契约 + 用例 + 推理过程账本（后两者供 generate-testcase 落盘）。 */
 export type AssembleResult = {
@@ -34,31 +32,6 @@ export type AssembleResult = {
     /** inference-trace 的 reasoningSummary + skeletonSlots 默认策略来源账本。 */
     inferenceTrace: Record<string, unknown>;
 };
-/** glue 用例动作类型。 */
-type GlueActionKind = 'create' | 'read' | 'update' | 'delete' | 'export';
-/**
- * 单条 CRUD 用例的阶段计划（用例装配与 spec 生成共用的单一事实来源）。
- */
-export type CrudCaseStage = {
-    actionKind: GlueActionKind;
-    queryKeyLabel: string;
-    component: 'input' | 'listbox';
-};
-/**
- * 按查询字段推导 CRUD 用例阶段序列。
- *
- * 规则：在新增表单中出现的查询字段（可写）产出完整 create/read/update/delete 四条；
- * 不在表单中的字段（如系统管理的状态）只产出 read 一条。
- * export 不在此计划内，由装配器单独追加。
- *
- * @param searchFields - 列表页查询字段（有序）。
- * @param formFieldLabels - 新增表单字段标签集合。
- * @returns 有序阶段计划，顺序与 buildGlueCases 产出的用例顺序一一对应。
- */
-export declare function planCrudCaseStages(searchFields: Array<{
-    label: string;
-    component: 'input' | 'listbox';
-}>, formFieldLabels: string[]): CrudCaseStage[];
 /**
  * 装配 contract + testcase + inference-trace 账本。
  *
@@ -66,5 +39,4 @@ export declare function planCrudCaseStages(searchFields: Array<{
  * @returns contract / testcase / inferenceTrace。
  */
 export declare function assembleJson5ContractAndTestcase(input: AssembleInput): AssembleResult;
-export {};
 //# sourceMappingURL=contract-testcase-assembler.d.ts.map

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;AAiZD;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAiKrF"}
+{"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,EAAY,MAAM,kCAAkC,CAAC;AACzF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGrE,oBAAoB;AACpB,MAAM,MAAM,aAAa,GAAG;IAC1B,iCAAiC;IACjC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,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;AAofF;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAkKrF"}

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

@@ -15,10 +15,6 @@
  * - locators：用 014 草案已确认的框架默认（MiniUI 默认规则 + text=确定 等），不进 unresolvedSlots
  * - assertions.deletePolicy='success_delete'（MiniUI 默认删除成功策略）
  */
-import { extractHtmlPage } from '../extractors/html-page.js';
-import { inferButtonInteractions, } from './button-interaction-inference.js';
-import { existsSync } from 'node:fs';
-import path from 'node:path';
 /**
  * 框架默认 locator 策略（014 草案已确认，交接文档 §4.2）。
  * 这些值不进 unresolvedSlots，在 inference-trace 记账「框架默认」。
@@ -100,180 +96,6 @@ function resolveFrameKeywords(codeList) {
 function isDataKeyField(codeList, field) {
     return (codeList.entities ?? []).some((e) => (e.fields ?? []).some((f) => f.name === field && f.dataKey));
 }
-/**
- * 选择并返回可用的源码根目录。
- *
- * 优先级：sourceRootOverride -> process.env.EP_STAGE_SOURCE_ROOT -> codeList.sourceRoot.root
- */
-function resolveSourceRoot(codeList, sourceRootOverride) {
-    const candidates = [
-        sourceRootOverride,
-        process.env.EP_STAGE_SOURCE_ROOT,
-        codeList.sourceRoot?.root,
-    ].filter((item) => Boolean(item));
-    return candidates[0];
-}
-/**
- * 解析页面 HTML 文件绝对路径。
- */
-function resolvePageHtmlPath(codeList, page, sourceRootOverride) {
-    const sourceRoot = resolveSourceRoot(codeList, sourceRootOverride);
-    if (!sourceRoot || !page.path)
-        return undefined;
-    return path.resolve(sourceRoot, page.path);
-}
-/**
- * 解析 pages[*].childGrids 中的 same_as_pages.<role>.childGrids 引用。
- */
-function resolveChildGrids(page, pages) {
-    const raw = page.childGrids;
-    if (!raw || !Array.isArray(raw) || raw.length === 0)
-        return undefined;
-    if (raw.every((item) => typeof item === 'string')) {
-        const resolved = [];
-        for (const ref of raw) {
-            const match = ref.match(/^same_as_pages\.([^.]+)\.childGrids$/);
-            if (!match)
-                continue;
-            const role = match[1];
-            const targetPage = pages.find((p) => p.role === role);
-            if (!targetPage)
-                continue;
-            const targetGrids = resolveChildGrids(targetPage, pages);
-            if (targetGrids)
-                resolved.push(...targetGrids);
-        }
-        return resolved.length > 0 ? resolved : undefined;
-    }
-    return raw;
-}
-/**
- * 将 HTML 中提取的子表列 editor.type 映射为 skeleton 组件类型。
- * 缺失或未知时默认 input，避免上游 HTML 不规范时直接阻塞整条产线。
- */
-function mapEditorTypeToComponent(editorType) {
-    if (editorType === 'combobox')
-        return 'listbox';
-    return 'input';
-}
-/**
- * 构建子表操作所需的定位表达式。
- */
-function buildChildGridLocators(grid, addAction, deleteAction) {
-    const label = grid.label;
-    const gridId = grid.id;
-    const buttonLocator = (action, defaultLabel) => {
-        const buttonLabel = action?.label ?? defaultLabel;
-        return `xpath=//div[@label='${label}']//a[contains(@class,'mini-button')][normalize-space()='${buttonLabel}']`;
-    };
-    return {
-        container: `xpath=//div[@label='${label}']`,
-        addRowButton: buttonLocator(addAction, '添加'),
-        deleteSelectedButton: buttonLocator(deleteAction, '删除选中'),
-        grid: `#${gridId}`,
-        editWrapInput: '.mini-grid-editwrap input.mini-textbox-input',
-        editWrapListboxTrigger: '.mini-grid-editwrap .mini-buttonedit-trigger',
-        editWrapListboxInput: '.mini-grid-editwrap input.mini-buttonedit-input',
-        rowCheckboxByIndex: `xpath=//*[@id='${gridId}']//tr[contains(@class,'mini-grid-row')][{{rowIndex}}]//td[contains(@class,'checkcolumn')]//span`,
-        cellByIndexAndField: `xpath=//*[@id='${gridId}']//tr[contains(@class,'mini-grid-row')][{{rowIndex}}]//td[{{colIndex}}]`,
-        cellValueByIndexAndField: `xpath=//*[@id='${gridId}']//tr[contains(@class,'mini-grid-row')][{{rowIndex}}]//td[{{colIndex}}]//div[contains(@class,'mini-grid-cell-inner')]`,
-    };
-}
-/**
- * 推断子表操作方式。
- * 优先级：code_list 显式 editMode > HTML 信号（allowCellEdit / editor 列） > 默认 none。
- */
-function inferChildGridEditMode(grid, htmlGrid) {
-    if (grid.editMode) {
-        return grid.editMode;
-    }
-    if (!htmlGrid) {
-        // HTML 不可用时，根据 code_list 已有信息保守回退：
-        // 只要声明了列组件或动作，就默认按 cell_edit 处理，保持与旧行为兼容。
-        const hasEditableColumn = grid.columns.some((c) => c.component === 'input' || c.component === 'listbox');
-        return hasEditableColumn || (grid.actions && grid.actions.length > 0) ? 'cell_edit' : 'none';
-    }
-    const hasCellEditSignal = htmlGrid.allowCellEdit === true ||
-        htmlGrid.cellEditAction != null ||
-        htmlGrid.allowCellSelect === true ||
-        htmlGrid.editNextOnEnterKey === true ||
-        htmlGrid.oncellbeginedit === true ||
-        htmlGrid.onrowdblclick === true;
-    const hasEditableColumn = htmlGrid.dataColumns.some((c) => Boolean(c.editorType));
-    if (hasCellEditSignal || hasEditableColumn) {
-        return 'cell_edit';
-    }
-    const hasRowEditSignal = htmlGrid.rowActions.some((a) => /openEdit|openDetail|openWindow|edit/i.test(a.onclick ?? a.label)) || htmlGrid.onrowdblclick === true;
-    if (hasRowEditSignal) {
-        return 'row_button_dialog';
-    }
-    return 'none';
-}
-/**
- * 从 code_list 的 pages[].childGrids 构建 contract.skeletonSlots.childGrids。
- *
- * 设计取舍：
- * - 优先使用 code_list 中已手写的 component；缺失时读取对应 HTML 的 editor.type 推导。
- * - 对 same_as_pages.<role>.childGrids 引用进行解析。
- * - 同一 gridId 在多个页面出现时只保留第一份（通常是 add 页）。
- */
-function buildChildGridSlots(codeList, sourceRootOverride) {
-    const pagesWithChildGrids = codeList.pages.filter((p) => Boolean(p.childGrids));
-    if (pagesWithChildGrids.length === 0)
-        return undefined;
-    const slots = [];
-    const seenGridIds = new Set();
-    const extractedPageCache = new Map();
-    for (const page of pagesWithChildGrids) {
-        const childGrids = resolveChildGrids(page, codeList.pages);
-        if (!childGrids)
-            continue;
-        let htmlPage;
-        const htmlPath = resolvePageHtmlPath(codeList, page, sourceRootOverride);
-        if (htmlPath && existsSync(htmlPath)) {
-            try {
-                if (!extractedPageCache.has(htmlPath)) {
-                    extractedPageCache.set(htmlPath, extractHtmlPage(htmlPath));
-                }
-                htmlPage = extractedPageCache.get(htmlPath);
-            }
-            catch {
-                htmlPage = undefined;
-            }
-        }
-        for (const grid of childGrids) {
-            if (seenGridIds.has(grid.id))
-                continue;
-            seenGridIds.add(grid.id);
-            const htmlGrid = htmlPage?.grids.find((g) => g.id === grid.id);
-            const columns = grid.columns.map((col) => {
-                const htmlColumn = htmlGrid?.dataColumns.find((c) => c.field === col.field);
-                const component = col.component ?? mapEditorTypeToComponent(htmlColumn?.editorType);
-                return {
-                    field: col.field,
-                    label: col.label,
-                    component,
-                    required: col.required ?? false,
-                    modelRef: col.modelRef ?? htmlColumn?.editorAction,
-                };
-            });
-            const addAction = grid.actions?.find((a) => a.actionName === 'addWindow' || a.label.includes('添加')) ?? grid.actions?.[0];
-            const deleteAction = grid.actions?.find((a) => a.actionName === 'deleteSelectedWindow' || a.label.includes('删除')) ?? grid.actions?.[1];
-            const editMode = inferChildGridEditMode(grid, htmlGrid);
-            slots.push({
-                gridId: grid.id,
-                label: grid.label,
-                pageRole: page.role === 'edit' ? 'edit' : 'add',
-                editMode,
-                columns,
-                addRowButtonLabel: addAction?.label,
-                deleteSelectedButtonLabel: deleteAction?.label,
-                locators: buildChildGridLocators(grid, addAction, deleteAction),
-            });
-        }
-    }
-    return slots.length > 0 ? slots : undefined;
-}
 /**
  * 把 list 页 queryFields 映射成 skeletonSlots.crud.searchConditions（input/listbox 二分）。
  *
@@ -282,9 +104,7 @@ function buildChildGridSlots(codeList, sourceRootOverride) {
  * @returns 对齐 StageSkeletonCrudSearchConditionSlot 的槽位数组。
  */
 function buildSearchConditionSlots(codeList, listPage, addOrEditPage) {
-    const addFormLabels = new Set((addOrEditPage?.formFields ?? [])
-        .filter((f) => typeof f !== 'string')
-        .map((f) => f.label));
+    const addFormLabels = new Set((addOrEditPage?.formFields ?? []).map((f) => f.label));
     return (listPage.queryFields ?? []).map((fieldInfo) => {
         const field = mapQueryFieldToField(fieldInfo);
         const component = normalizeQueryComponent(fieldInfo);
@@ -359,29 +179,6 @@ function normalizeQueryComponent(fieldInfo) {
         return 'input';
     return 'listbox';
 }
-/**
- * 按查询字段推导 CRUD 用例阶段序列。
- *
- * 规则：在新增表单中出现的查询字段（可写）产出完整 create/read/update/delete 四条；
- * 不在表单中的字段（如系统管理的状态）只产出 read 一条。
- * export 不在此计划内，由装配器单独追加。
- *
- * @param searchFields - 列表页查询字段（有序）。
- * @param formFieldLabels - 新增表单字段标签集合。
- * @returns 有序阶段计划，顺序与 buildGlueCases 产出的用例顺序一一对应。
- */
-export function planCrudCaseStages(searchFields, formFieldLabels) {
-    const stages = [];
-    for (const field of searchFields) {
-        if (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 {
-            stages.push({ actionKind: 'read', queryKeyLabel: field.label, component: field.component });
-        }
-    }
-    return stages;
-}
 /**
  * 生成正式用例编号。
  *
@@ -507,8 +304,8 @@ function buildGlueExecutionFields(actionKind, queryKeyLabel, queryComponent, que
     };
 }
 /**
- * 装配 glue cases：由 {@link planCrudCaseStages} 驱动（可写字段 CRUD 四条、只读字段 read 一条），
- * 外加 export 一条，与交接文档 §4.3 一致。
+ * 装配 10 条 glue cases（placename/placecategory 各 CRUD + status.read + export.all），
+ * 与交接文档 §4.3 一致。
  *
  * @param moduleId - 模块标识（用作 caseId 前缀）。
  * @param searchFieldLabels - 列表页查询字段标签集合。
@@ -529,110 +326,51 @@ function buildGlueCases(moduleName, searchFields, formFieldLabels, sequence, dat
         reviewStatus: 'confirmed',
         ...buildGlueExecutionFields(actionKind, queryKeyLabel, componentForLabel(queryKeyLabel), queryKeyInForm(queryKeyLabel), searchFieldLabels, dataKeyLabel),
     });
-    // 计划驱动：保证用例条数/顺序与 spec 生成器逐条渲染的 test 一一对应。
-    // listbox 键的 read 已由骨架强制断言行锚点命中，不再是 partial。
-    const cases = planCrudCaseStages(searchFields, formFieldLabels).map((stage) => mk(stage.actionKind, stage.queryKeyLabel, 'covered'));
-    cases.push(mk('export', dataKeyLabel ?? searchFieldLabels[0] ?? '不适用', 'covered'));
-    return cases;
+    return [
+        mk('create', '场所名称', 'covered'),
+        mk('read', '场所名称', 'covered'),
+        mk('update', '场所名称', 'covered'),
+        mk('delete', '场所名称', 'covered'),
+        mk('create', '场所分类', 'covered'),
+        mk('read', '场所分类', 'partial'),
+        mk('update', '场所分类', 'covered'),
+        mk('delete', '场所分类', 'covered'),
+        mk('read', '状态', 'partial'),
+        mk('export', dataKeyLabel ?? searchFieldLabels[0] ?? '不适用', 'covered'),
+    ];
 }
 /**
- * 为子表（childGrids）装配 glue cases。
- *
- * 每个子表生成 4 条用例：新增行、编辑行、删除行、必填校验。
- * 删除行标记为 gap：子表行删除通常依赖 confirm 弹窗与后端接口，运行态稳定性差，
- * 需要真实环境验证后才能提升为 covered。
+ * 装配 uncoveredCandidates：统一 generationStrategy='ai'；
+ * 运行态阻断用 coverageStatus='blocked' 表达。
  *
- * @param childGrids - 子表槽位清单。
- * @param firstRole - 首个角色（用作前置条件）。
- * @param sequence - 用例编号上下文。
- * @returns cases 数组（generationStrategy 全 glue）。
- */
-function buildChildGridCases(childGrids, firstRole, sequence) {
-    const smokeEntry = `1. 使用角色：${firstRole}。 2. 完成系统登录并进入目标新增页面。`;
-    return childGrids.flatMap((grid) => {
-        const label = grid.label;
-        const addRowButtonLabel = grid.addRowButtonLabel ?? '添加';
-        const deleteSelectedButtonLabel = grid.deleteSelectedButtonLabel ?? '删除选中';
-        const requiredColumns = grid.columns.filter((c) => c.required);
-        const requiredLabels = requiredColumns.map((c) => c.label).join('、') || '必填字段';
-        const allColumnLabels = grid.columns.map((c) => c.label).join('、');
-        const canAddRow = Boolean(grid.addRowButtonLabel);
-        const canDeleteRow = Boolean(grid.deleteSelectedButtonLabel);
-        const canEditCell = grid.editMode === 'cell_edit';
-        const hasRequiredColumn = requiredColumns.length > 0;
-        const mk = (title, coverageStatus, precondition, steps, assertion) => ({
-            caseId: nextCaseId(sequence),
-            title,
-            generationStrategy: 'glue',
-            coverageStatus,
-            reviewStatus: 'confirmed',
-            queryKey: '不适用',
-            precondition,
-            steps,
-            assertion,
-        });
-        const cases = [];
-        if (canAddRow) {
-            cases.push(mk(`${label}-新增行`, 'covered', smokeEntry, `1. 在新增页定位到「${label}」子表。 2. 点击子表工具栏的「${addRowButtonLabel}」按钮。 3. 在新增行中填写 ${allColumnLabels} 等字段。 4. 点击主表「保存并关闭」。 5. 观察保存结果。`, `保存后主表成功提交，子表新增数据随主表持久化；重新打开详情或编辑页可看到新增的行。`));
-        }
-        if (canEditCell) {
-            cases.push(mk(`${label}-编辑行`, 'covered', `${smokeEntry} 3. 子表中已存在至少一行数据。`, `1. 在新增页定位到「${label}」子表。 2. 选中或双击待编辑行进入编辑状态。 3. 修改 ${allColumnLabels} 等字段。 4. 点击主表「保存并关闭」。 5. 观察保存结果。`, `保存后子表修改内容持久化；重新打开详情或编辑页可看到更新后的值。`));
-        }
-        if (canDeleteRow) {
-            cases.push(mk(`${label}-删除行`, 'covered', `${smokeEntry} 3. 子表中已存在至少一行数据。`, `1. 在新增页定位到「${label}」子表。 2. 勾选要删除的数据行。 3. 点击子表工具栏的「${deleteSelectedButtonLabel}」按钮。 4. 在确认弹窗中点击「确定」。 5. 观察并记录最终反馈。`, `点击「${deleteSelectedButtonLabel}」并确认后，子表对应行应被删除；重新加载页面后该行数据不再存在。`));
-        }
-        if (canEditCell && hasRequiredColumn) {
-            cases.push(mk(`${label}-必填校验`, 'covered', smokeEntry, `1. 在新增页点击「${addRowButtonLabel}」新增一行。 2. 将 ${requiredLabels} 留空或选择空值。 3. 点击主表「保存并关闭」。 4. 观察校验提示。`, `保存时系统应阻断提交并提示「第N行${requiredLabels}不能为空！」等校验信息。`));
-        }
-        return cases;
-    });
-}
-/**
- * 把 contract.scenario.gapCandidates 映射为 testcase.uncoveredCandidates。
- * 当前仅处理控件类 custom 按钮，按 code_list 中真实的 label / customAction / backendMethod
- * 生成精确步骤、前置条件与断言；若 button-interaction-inference 成功识别交互模式，
- * 则使用对应的精确步骤/断言，否则回退到通用描述。
- *
- * @param gapCandidates - contract 中已推导的控件类 gap 候选。
  * @param firstRole - 首个角色（用作 requiredRole）。
- * @param sequence - 用例编号上下文。
- * @param codeList - 解析后的 code_list，用于反查按钮原始元数据。
- * @param buttonInferences - 按钮交互推理结果映射（label -> inference）。
  */
-function buildUncoveredCandidates(gapCandidates, firstRole, sequence, codeList, buttonInferences) {
-    const listPage = codeList.pages.find((p) => p.role === 'list');
-    return gapCandidates.map((candidate) => {
-        // 从 code_list.pages[list].buttons 中反查该 custom 按钮的元数据。
-        const btn = (listPage?.buttons ?? []).find((b) => {
-            const anyB = b;
-            return anyB.action === 'custom'
-                && (anyB.label === candidate.label || anyB.customAction === candidate.gapId);
-        });
-        const label = btn?.label ?? candidate.label;
-        const customAction = btn?.customAction ?? candidate.gapId;
-        // 优先使用前端行为推理结果；若不可用则回退到通用描述。
-        const inference = buttonInferences.get(label);
-        const steps = inference?.steps ?? [
-            `1. 在列表页定位并点击「${label}」按钮。`,
-            `2. 观察并记录页面反馈（如弹窗、提示信息、列表刷新等）。`,
-            `3. 确认页面状态与按钮功能预期一致。`,
-        ].join(' ');
-        const assertion = inference?.assertion
-            ?? `点击「${label}」按钮后，页面应出现与该功能对应的可见响应（如提示信息、弹窗确认或数据刷新）。`;
-        return {
-            caseId: nextCaseId(sequence),
-            label,
-            generationStrategy: 'ai',
-            coverageStatus: 'gap',
-            requiredRole: firstRole,
-            businessIntent: `覆盖列表页「${label}」按钮的控件功能（customAction=${customAction}）。`,
-            assertionExpectation: assertion,
-            queryKey: '不适用',
-            precondition: `1. 使用角色：${firstRole}。 2. 完成系统登录并进入目标待测页面。`,
-            steps,
-            assertion,
-        };
+function buildUncoveredCandidates(firstRole, sequence) {
+    const mk = (label, coverageStatus, businessIntent, assertionExpectation) => ({
+        caseId: nextCaseId(sequence),
+        label,
+        generationStrategy: 'ai',
+        coverageStatus,
+        requiredRole: firstRole,
+        businessIntent,
+        assertionExpectation,
+        queryKey: '不适用',
+        precondition: `1. 使用角色：${firstRole}。 2. 完成系统登录并进入目标待测页面。`,
+        steps: [
+            '1. 由 AI Runtime Task 观察页面当前状态和可交互入口。',
+            `2. 围绕「${businessIntent}」做决策并执行页面动作。`,
+            '3. 记录观察、决策、行动和验证结果到 ai-runtime-trace.json5。',
+        ].join(' '),
+        assertion: assertionExpectation,
     });
+    return [
+        mk('状态流转（草稿→在用→归档）', 'gap', '覆盖在用不可删除等业务规则边界', '在用状态场所执行删除时应被业务规则阻断，提示拒绝信息'),
+        mk('同步窗口管理系统（custom 按钮）', 'gap', '覆盖 code_list.buttons 中 action=custom 的同步窗口操作', '点击同步窗口管理系统按钮后应触发后端 syncWindowSystem 并返回成功'),
+        mk('查看详情（rowAction=detail）', 'gap', '覆盖 rowActions 中查看详情入口', '点击查看按钮应打开只读详情页，展示窗口子表'),
+        mk('窗口子表嵌套 datagrid（add/edit 页内嵌）', 'gap', '覆盖 add/edit 页内嵌的窗口子表增删改', '窗口子表行应可增删改并随主表保存'),
+        mk('统计看板（无入口）', 'blocked', 'code_list.json5 标记 PRD 提到统计大屏，但本次出码未发现对应实现文件', '运行态推理若仍无入口则记录 blocked，不生成胶水骨架步骤'),
+        mk('移动端查询（无入口）', 'blocked', 'code_list.json5 标记 PRD 提到移动端查询，但本次出码未发现对应实现文件', '运行态推理若仍无入口则记录 blocked，不生成胶水骨架步骤'),
+    ];
 }
 /**
  * 按 code_list 里的系统与角色事实生成 testcase.testAccess 占位。
@@ -696,9 +434,7 @@ export function assembleJson5ContractAndTestcase(input) {
     }));
     const searchFieldLabels = searchFields.map((fieldInfo) => fieldInfo.label);
     const addOrEditPage = codeList.pages.find((p) => p.role === 'add') ?? codeList.pages.find((p) => p.role === 'edit');
-    const formFieldLabels = (addOrEditPage?.formFields ?? [])
-        .filter((fieldInfo) => typeof fieldInfo !== 'string')
-        .map((fieldInfo) => fieldInfo.label);
+    const formFieldLabels = (addOrEditPage?.formFields ?? []).map((fieldInfo) => fieldInfo.label);
     const dataKeyLabel = (listPage.queryFields ?? []).find((fieldInfo) => {
         const field = mapQueryFieldToField(fieldInfo);
         return isDataKeyField(codeList, field);
@@ -725,11 +461,21 @@ export function assembleJson5ContractAndTestcase(input) {
             blockedDeleteMessage,
         },
     };
-    const childGridSlots = buildChildGridSlots(codeList, input.sourceRoot);
-    // 动态推导 gapCandidates：当前阶段只保留控件类 custom 按钮。
-    // 状态流转、子表、详情、统计看板/移动端等 PRD-only/业务类场景暂不进 gapCandidates，
-    // 后续可通过 code_list.gapHints 让业务人工声明后再扩展。
+    // 动态推导 gapCandidates（原为 014 专用硬编码 6 条），从 code_list 结构信号出发：
+    //   - businessRules[scope 含 delete/create/update] → 状态流转类 gap
+    //   - pages[list].buttons.action='custom' → 每个 custom 按钮独立 gap
+    //   - rowActions 含 detail/openDetail 或 label 含"查看"/"详情" → 查看详情 gap
+    //   - pages[add/edit].childGrids → 每个子表 gap
+    // 若 code_list 无对应信号则输出空数组。统计看板 / 移动端等 PRD-only 场景无稳定 code_list
+    // 提取路径，暂不进 gapCandidates（后续可通过 code_list.gapHints 让业务人工声明）。
     const gapCandidates = [];
+    const stateRule = (codeList.businessRules ?? []).find((r) => {
+        const rec = r;
+        return Array.isArray(rec.scope) && rec.scope.some((s) => ['delete', 'create', 'update'].includes(s));
+    });
+    if (stateRule) {
+        gapCandidates.push({ gapId: 'businessState.transitions', label: '状态流转', generationStrategy: 'ai' });
+    }
     (listPage.buttons ?? [])
         .filter((b) => b.action === 'custom')
         .forEach((btn) => {
@@ -740,6 +486,23 @@ export function assembleJson5ContractAndTestcase(input) {
             generationStrategy: 'ai',
         });
     });
+    const detailRow = (listPage.rowActions ?? []).find((r) => {
+        const rec = r;
+        return rec.action === 'detail' || rec.actionName === 'openDetail'
+            || (rec.label ?? '').includes('查看') || (rec.label ?? '').includes('详情');
+    });
+    if (detailRow) {
+        const anyRow = detailRow;
+        gapCandidates.push({ gapId: 'detail', label: anyRow.label ?? '查看详情', generationStrategy: 'ai' });
+    }
+    const childGrids = addOrEditPage?.childGrids ?? [];
+    childGrids.forEach((grid) => {
+        gapCandidates.push({
+            gapId: grid.id ?? grid.label ?? 'childGrid',
+            label: grid.label ? `${grid.label} 子表` : '子表',
+            generationStrategy: 'ai',
+        });
+    });
     const contract = {
         schemaVersion: 'ep-stage-contract/v1-draft',
         contractId: `${module}-contract`,
@@ -758,7 +521,6 @@ export function assembleJson5ContractAndTestcase(input) {
             skeletonSlots: {
                 crud: skeletonSlotsCrud,
                 export: { moduleId: module, label: '导出', mode: 'all' },
-                childGrids: childGridSlots,
             },
             gapCandidates,
         },
@@ -766,12 +528,7 @@ export function assembleJson5ContractAndTestcase(input) {
     };
     const caseIdSequence = { pageIndex: 1, nextCaseIndex: 1 };
     const cases = buildGlueCases(moduleName, searchFields, formFieldLabels, caseIdSequence, dataKeyLabel);
-    const childGridCases = childGridSlots ? buildChildGridCases(childGridSlots, firstRole, caseIdSequence) : [];
-    cases.push(...childGridCases);
-    const buttonInferences = inferButtonInteractions(codeList, {
-        sourceRootOverride: input.sourceRoot,
-    });
-    const uncoveredCandidates = buildUncoveredCandidates(gapCandidates, firstRole, caseIdSequence, codeList, buttonInferences);
+    const uncoveredCandidates = buildUncoveredCandidates(firstRole, caseIdSequence);
     const testcase = {
         schemaVersion: 'ep-stage-testcase/v1-draft',
         testcaseId: `${module}-testcase`,
@@ -804,19 +561,8 @@ export function assembleJson5ContractAndTestcase(input) {
                 source: 'code-list-derived',
                 reason: 'placename 为 dataKey 用 timestamp_prefix；listbox 取首项作 value',
             },
-            childGrids: {
-                source: 'html-derived',
-                reason: '从 add/edit 页 HTML 的 datagrid 列 editor.type 推导 component；locators 按 MiniUI 子表默认规则生成',
-            },
         },
         unresolvedSlotsCount: 0,
-        customButtonInferences: Array.from(buttonInferences.values()).map((inf) => ({
-            label: inf.label,
-            pattern: inf.pattern,
-            functionName: inf.functionName,
-            fallbackReason: inf.fallbackReason,
-            evidence: inf.evidence,
-        })),
     };
     return { contract, testcase, inferenceTrace };
 }

package/dist/src/validation/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/validation/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAsB,MAAM,kCAAkC,CAAC;AAcnG;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,sBAAsB,CAuHrE"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/validation/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAsB,MAAM,kCAAkC,CAAC;AAcnG;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,sBAAsB,CAuFrE"}

package/dist/src/validation/contract.js

@@ -80,39 +80,10 @@ export function validateContract(obj) {
     if (!slotsRec.export || typeof slotsRec.export !== 'object') {
         throw new Error('contract.json5 缺 scenario.skeletonSlots.export');
     }
-    if (!slotsRec.export || typeof slotsRec.export !== 'object') {
-        throw new Error('contract.json5 缺 scenario.skeletonSlots.export');
-    }
     const exportSlot = slotsRec.export;
     requireString(exportSlot.moduleId, 'scenario.skeletonSlots.export.moduleId');
     requireString(exportSlot.label, 'scenario.skeletonSlots.export.label');
     requireString(exportSlot.mode, 'scenario.skeletonSlots.export.mode');
-    // scenario.skeletonSlots.childGrids（可选）
-    if (slotsRec.childGrids !== undefined) {
-        if (!Array.isArray(slotsRec.childGrids)) {
-            throw new Error('contract.json5 scenario.skeletonSlots.childGrids 必须是数组');
-        }
-        for (const [i, grid] of slotsRec.childGrids.entries()) {
-            if (!grid || typeof grid !== 'object') {
-                throw new Error(`contract.json5 scenario.skeletonSlots.childGrids[${i}] 必须是对象`);
-            }
-            requireString(grid.gridId, `scenario.skeletonSlots.childGrids[${i}].gridId`);
-            requireString(grid.label, `scenario.skeletonSlots.childGrids[${i}].label`);
-            if (!Array.isArray(grid.columns)) {
-                throw new Error(`contract.json5 scenario.skeletonSlots.childGrids[${i}].columns 必须是数组`);
-            }
-            for (const [j, col] of grid.columns.entries()) {
-                if (!col || typeof col !== 'object') {
-                    throw new Error(`contract.json5 scenario.skeletonSlots.childGrids[${i}].columns[${j}] 必须是对象`);
-                }
-                requireString(col.field, `scenario.skeletonSlots.childGrids[${i}].columns[${j}].field`);
-                requireString(col.label, `scenario.skeletonSlots.childGrids[${i}].columns[${j}].label`);
-                if (col.component !== 'input' && col.component !== 'listbox') {
-                    throw new Error(`contract.json5 scenario.skeletonSlots.childGrids[${i}].columns[${j}].component 必须为 input 或 listbox`);
-                }
-            }
-        }
-    }
     // scenario.gapCandidates[]
     if (!Array.isArray(sc.gapCandidates)) {
         throw new Error('contract.json5 缺 scenario.gapCandidates[]');

package/dist/test/cli/generate-testcase-json5.test.d.ts

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

package/dist/test/cli/generate-testcase-json5.test.d.ts.map

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