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

package/dist/src/index.d.ts

@@ -9,8 +9,8 @@ export { extractJavaAction } from './extractors/java-action.js';
 export type { ExtractedJavaAction } from './extractors/java-action.js';
 export { buildCrudBusinessModuleContract } from './normalizers/crud-contract.js';
 export type { BuildCrudContractInput, ButtonLabelConfig } from './normalizers/crud-contract.js';
-export { generateStageSkeletonCrudSpec, mapContractToStageSkeletonCrudSlots, renderStageSkeletonCrudSlots } from './generators/stage-skeleton-script.js';
-export type { StageSkeletonCrudDataValueStrategy, StageSkeletonCrudDeletePolicy, StageSkeletonCrudFlowSlots, StageSkeletonScriptOptions } from './generators/stage-skeleton-script.js';
+export { generateStageSkeletonCrudSpecFromSlots, renderStageSkeletonCrudSlots } from './generators/stage-skeleton-script.js';
+export type { GenerateStageSkeletonCrudSpecFromSlotsOptions, StageSkeletonCrudDataValueStrategy, StageSkeletonCrudDeletePolicy, StageSkeletonCrudFlowSlots } from './generators/stage-skeleton-script.js';
 export type { ActionCandidate, AgentInferredWorkflow, GapActionType, GapExplorationResult, GapInferDraft, GapListItem, GapSignalType, GapWorkflowStatus, SkeletonCoverage } from './contracts/gap-inference.js';
 export type { ObservableArtifactRef, ObservableGate, ObservableStageName, ObservableStagePayload, ObservableStageSummary, ReasoningEvidence, ReasoningSummary, TraceWriterOptions } from './contracts/observable-chain.js';
 export { createTraceWriter, } from './trace/trace-writer.js';
@@ -49,4 +49,9 @@ export { glueReportToTrace, glueSpecAssemblyToTrace, playwrightExecutionToTrace,
 export type { GlueReportSummary, GlueSpecAssemblySummary, PlaywrightExecutionSummary, } from './cli/run-gap-pipeline.js';
 export { compareObservableRuns, summarizeGeneralizationRun, } from './generalization/generalization-eval.js';
 export type { GeneralizationComparison, GeneralizationRunMetrics, MaterialResolutionStatus, SummarizeGeneralizationRunInput, } from './generalization/generalization-eval.js';
+export { buildSourceAnalysis } from './inference/source-analysis.js';
+export type { BuildSourceAnalysisInput } from './inference/source-analysis.js';
+export { inferModuleHintsFromMaterials } from './inference/module-hints-inference.js';
+export type { InferModuleHintsInput } from './inference/module-hints-inference.js';
+export type { BackendSignal, CustomWorkflowInference, DataKeyInference, DeletePolicyInference, InferenceTraceV1, MaterialInventoryTrace, MaterialSlotStatus, ModuleHintsInference, SearchConditionInference, SourceAnalysis, SourceAnalysisEntry, SourceAnalysisMode, UiSignal } from './contracts/inference-trace.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/index.js

@@ -3,7 +3,7 @@ export { extractSpecYaml } from './extractors/spec-yaml.js';
 export { extractCodeListSummary } from './extractors/code-list.js';
 export { extractJavaAction } from './extractors/java-action.js';
 export { buildCrudBusinessModuleContract } from './normalizers/crud-contract.js';
-export { generateStageSkeletonCrudSpec, mapContractToStageSkeletonCrudSlots, renderStageSkeletonCrudSlots } from './generators/stage-skeleton-script.js';
+export { generateStageSkeletonCrudSpecFromSlots, renderStageSkeletonCrudSlots } from './generators/stage-skeleton-script.js';
 export { createTraceWriter, } from './trace/trace-writer.js';
 export { lookupProjectByRequirement, readStageContext, resolveStageContext, writeProjectIndex, } from './context/stage-context.js';
 export { renderReviewSummary, } from './trace/review-summary.js';
@@ -24,3 +24,5 @@ export { applyCodeListWriteBack, collectCodeListMaterialRefsFromPath, isProtecte
 export { createRuntimeFailureSummary, extractLoginSystemUrlFromEnvFile, parseRuntimeSummaryOutput, runtimeSummaryToTrace, } from './cli/run-gap-pipeline.js';
 export { glueReportToTrace, glueSpecAssemblyToTrace, playwrightExecutionToTrace, } from './cli/run-gap-pipeline.js';
 export { compareObservableRuns, summarizeGeneralizationRun, } from './generalization/generalization-eval.js';
+export { buildSourceAnalysis } from './inference/source-analysis.js';
+export { inferModuleHintsFromMaterials } from './inference/module-hints-inference.js';

package/dist/src/inference/module-hints-inference.d.ts

@@ -0,0 +1,30 @@
+import type { ExtractedHtmlPage, ExtractedJavaAction } from '../index.js';
+import type { ModuleHints } from '../contracts/crud-business-module.js';
+import type { ModuleHintsInference, SourceAnalysis } from '../contracts/inference-trace.js';
+/**
+ * inferModuleHintsFromMaterials 的输入参数。
+ */
+export type InferModuleHintsInput = {
+    sourceAnalysis: SourceAnalysis;
+    pages: ExtractedHtmlPage[];
+    actions: ExtractedJavaAction[];
+    explicitHints?: ModuleHints;
+};
+/**
+ * 基于上游物料推理 ModuleHints 动态槽位。
+ *
+ * 推理规则：
+ * - dataKey.selectedField 优先选同时出现在列表页搜索区、表格列、新增/编辑页表单的 input 字段。
+ * - searchConditions 至少包含 dataKey input 条件；listbox 条件缺取值时只进 unresolved。
+ * - buttonAliases 从页面按钮标签归类（新增、搜索、修改、删除、确定、导出）。
+ * - deletePolicy 若 Java messages 含"不可删除"，推为 blocked_by_business_rule。
+ * - customWorkflows 收集 CRUD/Export 骨架之外的工具栏按钮；有 Java callback 时填 assertion，否则 unresolved。
+ *
+ * @param input - 输入参数（sourceAnalysis、pages、actions、可选 explicitHints）。
+ * @returns 推理出的 hints 与推理过程。
+ */
+export declare function inferModuleHintsFromMaterials(input: InferModuleHintsInput): {
+    hints: ModuleHints;
+    inference: ModuleHintsInference;
+};
+//# sourceMappingURL=module-hints-inference.d.ts.map

package/dist/src/inference/module-hints-inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-hints-inference.d.ts","sourceRoot":"","sources":["../../../src/inference/module-hints-inference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,WAAW,EAEZ,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAIV,oBAAoB,EAEpB,cAAc,EACf,MAAM,iCAAiC,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,cAAc,EAAE,cAAc,CAAC;IAC/B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE,WAAW,CAAC;CAC7B,CAAC;AA4UF;;;;;;;;;;;;GAYG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,qBAAqB,GAAG;IAC3E,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,oBAAoB,CAAC;CACjC,CAoEA"}

package/dist/src/inference/module-hints-inference.js

@@ -0,0 +1,363 @@
+/** CRUD 骨架与导出覆盖的标准按钮标签集合（归类用）。 */
+const CRUD_BUTTON_LABELS = {
+    create: ['新增', '增加', '添加', '新建'],
+    search: ['搜索', '查询', '检索'],
+    edit: ['修改', '编辑'],
+    delete: ['删除', '删除选定', '批量删除'],
+    confirm: ['确定', '确认', '保存', '保存并关闭'],
+    export: ['导出', '导出选定', '批量导出']
+};
+/**
+ * 识别列表页。
+ *
+ * 优先选 pageId 以 `list` 结尾的页面（文件名约定）；无则回落到第一个含 datagrid 的页面。
+ * 不能只用 grids.length > 0，因为 add/edit/detail 页也可能内嵌 datagrid（如 014 场景），
+ * 会导致搜索条件误从表单页抽取（regression：windowname 被当作搜索条件）。
+ *
+ * @param pages - 已抽取的 HTML 页面列表。
+ * @returns 列表页；无则返回 undefined。
+ */
+function findListPage(pages) {
+    const byId = pages.find((page) => /list$/i.test(page.pageId));
+    if (byId)
+        return byId;
+    return pages.find((page) => page.grids.length > 0);
+}
+/**
+ * 收集列表页搜索区字段名（fui-condition 区的 input bind）。
+ *
+ * @param listPage - 列表页。
+ * @returns 搜索区字段名集合。
+ */
+function collectSearchFields(listPage) {
+    const fields = new Set();
+    if (!listPage)
+        return fields;
+    for (const field of listPage.fields) {
+        fields.add(field.name);
+    }
+    return fields;
+}
+/**
+ * 收集列表页表格数据列 field。
+ *
+ * @param listPage - 列表页。
+ * @returns 表格列 field 集合。
+ */
+function collectGridFields(listPage) {
+    const fields = new Set();
+    if (!listPage)
+        return fields;
+    for (const grid of listPage.grids) {
+        for (const column of grid.dataColumns) {
+            if (column.field) {
+                fields.add(column.field);
+            }
+        }
+    }
+    return fields;
+}
+/**
+ * 收集新增/编辑页表单字段名。
+ *
+ * @param pages - 所有页面。
+ * @returns 表单字段名集合。
+ */
+function collectFormFields(pages) {
+    const fields = new Set();
+    for (const page of pages) {
+        for (const field of page.fields) {
+            if (field.name) {
+                fields.add(field.name);
+            }
+        }
+    }
+    return fields;
+}
+/**
+ * 推理 dataKey.selectedField。
+ *
+ * 规则：优先选同时出现在列表页搜索区、表格列、新增/编辑页表单的 input 字段。
+ * 若无三方交集，回落到搜索区与表格列的交集；再无则取表格第一列。
+ *
+ * @param listPage - 列表页。
+ * @param pages - 所有页面。
+ * @returns dataKey 推理过程。
+ */
+function inferDataKey(listPage, pages) {
+    const searchFields = collectSearchFields(listPage);
+    const gridFields = collectGridFields(listPage);
+    const formFields = collectFormFields(pages);
+    // 三方交集
+    const tripleIntersection = Array.from(searchFields).filter((field) => gridFields.has(field) && formFields.has(field));
+    if (tripleIntersection.length > 0) {
+        return {
+            selectedField: tripleIntersection[0],
+            reason: '列表页搜索区、表格列、新增/编辑页表单同时出现该字段',
+            evidence: tripleIntersection.map((field) => `${field} 出现在搜索区+表格列+表单`)
+        };
+    }
+    // 搜索区与表格列交集
+    const dualIntersection = Array.from(searchFields).filter((field) => gridFields.has(field));
+    if (dualIntersection.length > 0) {
+        return {
+            selectedField: dualIntersection[0],
+            reason: '列表页搜索区与表格列同时出现该字段（表单未覆盖）',
+            evidence: dualIntersection.map((field) => `${field} 出现在搜索区+表格列`)
+        };
+    }
+    // 回落到表格第一列
+    if (listPage && listPage.grids.length > 0) {
+        const firstColumn = listPage.grids[0].dataColumns[0];
+        if (firstColumn?.field) {
+            return {
+                selectedField: firstColumn.field,
+                reason: '搜索区与表格列无交集，回落到表格第一列',
+                evidence: [`表格第一列 field=${firstColumn.field}`]
+            };
+        }
+    }
+    return {
+        reason: '无法从物料中推理出 dataKey',
+        evidence: []
+    };
+}
+/**
+ * 推理搜索条件。
+ *
+ * 规则：至少包含 dataKey input 条件；listbox 条件缺取值时只进 unresolved。
+ *
+ * @param listPage - 列表页。
+ * @param dataKeyField - 选定的 dataKey 字段。
+ * @returns 搜索条件推理过程数组。
+ */
+function inferSearchConditions(listPage, dataKeyField) {
+    const conditions = [];
+    if (!listPage)
+        return conditions;
+    for (const field of listPage.fields) {
+        const isInput = field.controlType.includes('textbox') || field.controlType.includes('input');
+        const isListbox = field.controlType.includes('combobox') || field.controlType.includes('listbox');
+        if (isInput) {
+            conditions.push({
+                field: field.name,
+                component: 'input',
+                resolved: true
+            });
+        }
+        else if (isListbox) {
+            // listbox 缺取值时只进 unresolved，不阻断
+            conditions.push({
+                field: field.name,
+                component: 'listbox',
+                resolved: false,
+                reason: 'listbox 取值需人工或后续补齐'
+            });
+        }
+    }
+    // 确保 dataKey 字段在搜索条件中
+    if (dataKeyField && !conditions.some((condition) => condition.field === dataKeyField)) {
+        conditions.unshift({
+            field: dataKeyField,
+            component: 'input',
+            resolved: true
+        });
+    }
+    return conditions;
+}
+/**
+ * 从按钮标签归类 buttonAliases。
+ *
+ * @param pages - 所有页面。
+ * @returns 按钮别名归类映射。
+ */
+function inferButtonAliases(pages) {
+    const aliases = {};
+    const allLabels = new Set();
+    for (const page of pages) {
+        for (const button of page.buttons) {
+            allLabels.add(button.label);
+        }
+    }
+    for (const [alias, patterns] of Object.entries(CRUD_BUTTON_LABELS)) {
+        const matched = Array.from(allLabels).filter((label) => patterns.some((pattern) => label.includes(pattern)));
+        if (matched.length > 0) {
+            aliases[alias] = matched;
+        }
+    }
+    return aliases;
+}
+/**
+ * 推理删除策略。
+ *
+ * 规则：Java messages 含"不可删除"类提示时推为 blocked_by_business_rule。
+ *
+ * @param actions - Java Action 列表。
+ * @returns 删除策略推理过程。
+ */
+function inferDeletePolicy(actions) {
+    const blockMessages = [];
+    for (const action of actions) {
+        for (const message of action.messages) {
+            if (/不可删除|不允许删除|禁止删除/.test(message)) {
+                blockMessages.push(message);
+            }
+        }
+    }
+    if (blockMessages.length > 0) {
+        return {
+            value: 'blocked_by_business_rule',
+            reason: 'Java Action 存在不可删除提示',
+            evidence: blockMessages
+        };
+    }
+    return {
+        reason: '未发现删除限制证据，默认允许删除',
+        evidence: []
+    };
+}
+/** 已被 CRUD 骨架与导出覆盖的按钮标签模式（customWorkflows 排除用）。 */
+const SKELETON_BUTTON_PATTERNS = [
+    ...CRUD_BUTTON_LABELS.create,
+    ...CRUD_BUTTON_LABELS.search,
+    ...CRUD_BUTTON_LABELS.edit,
+    ...CRUD_BUTTON_LABELS.delete,
+    ...CRUD_BUTTON_LABELS.confirm,
+    ...CRUD_BUTTON_LABELS.export,
+    '重置', '关闭', '返回', '取消', '刷新'
+];
+/**
+ * 收集 CRUD/Export 骨架之外的自定义工作流（工具栏按钮）。
+ *
+ * 规则：有 Java callback message 时填 assertion，否则 unresolved。
+ *
+ * @param pages - 所有页面。
+ * @param actions - Java Action 列表。
+ * @returns 自定义工作流推理过程数组。
+ */
+function inferCustomWorkflows(pages, actions) {
+    // 收集所有 Java callback 消息，用于匹配断言
+    const allMessages = [];
+    for (const action of actions) {
+        allMessages.push(...action.messages);
+    }
+    const workflows = [];
+    const seen = new Set();
+    for (const page of pages) {
+        for (const button of page.buttons) {
+            const label = button.label;
+            if (seen.has(label))
+                continue;
+            const isSkeleton = SKELETON_BUTTON_PATTERNS.some((pattern) => label.includes(pattern));
+            if (isSkeleton)
+                continue;
+            seen.add(label);
+            // 尝试从 Java messages 中找到与按钮相关的断言
+            const relatedMessage = allMessages.find((message) => {
+                // 按钮标签的关键词出现在消息里，或消息里的动作动词与按钮相关
+                const keywords = label.replace(/管理系统|信息管理|数据/g, '').trim();
+                return keywords.length > 0 && message.includes(keywords);
+            });
+            if (relatedMessage) {
+                workflows.push({
+                    label,
+                    actionAlias: button.onclick ? [button.onclick] : undefined,
+                    expectedIntent: label,
+                    expectedAssertion: relatedMessage,
+                    resolved: true,
+                    evidence: [
+                        `按钮 onclick=${button.onclick ?? '(未声明)'}`,
+                        `Java callback: ${relatedMessage}`
+                    ]
+                });
+            }
+            else {
+                workflows.push({
+                    label,
+                    actionAlias: button.onclick ? [button.onclick] : undefined,
+                    expectedIntent: label,
+                    resolved: false,
+                    reason: '未找到对应 Java callback 断言',
+                    evidence: [`按钮 onclick=${button.onclick ?? '(未声明)'}`]
+                });
+            }
+        }
+    }
+    return workflows;
+}
+/**
+ * 基于上游物料推理 ModuleHints 动态槽位。
+ *
+ * 推理规则：
+ * - dataKey.selectedField 优先选同时出现在列表页搜索区、表格列、新增/编辑页表单的 input 字段。
+ * - searchConditions 至少包含 dataKey input 条件；listbox 条件缺取值时只进 unresolved。
+ * - buttonAliases 从页面按钮标签归类（新增、搜索、修改、删除、确定、导出）。
+ * - deletePolicy 若 Java messages 含"不可删除"，推为 blocked_by_business_rule。
+ * - customWorkflows 收集 CRUD/Export 骨架之外的工具栏按钮；有 Java callback 时填 assertion，否则 unresolved。
+ *
+ * @param input - 输入参数（sourceAnalysis、pages、actions、可选 explicitHints）。
+ * @returns 推理出的 hints 与推理过程。
+ */
+export function inferModuleHintsFromMaterials(input) {
+    const listPage = findListPage(input.pages);
+    const dataKeyInference = inferDataKey(listPage, input.pages);
+    const searchConditionInferences = inferSearchConditions(listPage, dataKeyInference.selectedField);
+    const buttonAliases = inferButtonAliases(input.pages);
+    const deletePolicyInference = inferDeletePolicy(input.actions);
+    const customWorkflows = inferCustomWorkflows(input.pages, input.actions);
+    // 组装 hints（与 ModuleHints 类型对齐）
+    const hints = {
+        dataKey: dataKeyInference.selectedField
+            ? {
+                selectedField: dataKeyInference.selectedField,
+                candidateFields: input.sourceAnalysis.fields
+            }
+            : undefined,
+        searchConditions: searchConditionInferences
+            .filter((condition) => condition.resolved)
+            .map((condition) => ({
+            field: condition.field,
+            component: condition.component
+        })),
+        buttonAliases,
+        deletePolicy: deletePolicyInference.value,
+        customWorkflows: customWorkflows.map((workflow) => ({
+            label: workflow.label,
+            actionAlias: workflow.actionAlias,
+            expectedIntent: workflow.expectedIntent,
+            expectedAssertion: workflow.expectedAssertion,
+            include: workflow.resolved,
+            excludeReason: workflow.resolved ? undefined : '未找到对应断言证据'
+        }))
+    };
+    // 组装 unresolved
+    const unresolved = [];
+    if (!dataKeyInference.selectedField) {
+        unresolved.push('dataKey.selectedField');
+    }
+    for (const condition of searchConditionInferences) {
+        if (!condition.resolved) {
+            unresolved.push(`searchConditions.${condition.field}`);
+        }
+    }
+    for (const workflow of customWorkflows) {
+        if (!workflow.resolved) {
+            unresolved.push(`customWorkflows.${workflow.label}`);
+        }
+    }
+    // 合并显式 hints（若有）
+    const mode = input.explicitHints ? 'merged' : 'inferred';
+    const confidence = unresolved.length === 0 ? 'high' : unresolved.length <= 2 ? 'medium' : 'low';
+    const inference = {
+        mode,
+        confidence,
+        dataKey: dataKeyInference,
+        searchConditions: searchConditionInferences,
+        buttonAliases,
+        deletePolicy: deletePolicyInference,
+        assertionPolicy: {},
+        customWorkflows,
+        unresolved
+    };
+    return { hints, inference };
+}

package/dist/src/inference/source-analysis.d.ts

@@ -0,0 +1,26 @@
+import type { ExtractedCodeListSummary, ExtractedHtmlPage, ExtractedJavaAction } from '../index.js';
+import type { SourceAnalysis } from '../contracts/inference-trace.js';
+/**
+ * buildSourceAnalysis 的输入参数。
+ */
+export type BuildSourceAnalysisInput = {
+    codeListPath: string;
+    docsDir: string;
+    codeList: ExtractedCodeListSummary;
+    pages: ExtractedHtmlPage[];
+    actions: ExtractedJavaAction[];
+};
+/**
+ * 构建 sourceAnalysis 章节。
+ *
+ * 实现规则：
+ * - docsDir 下存在 PRD markdown（文件名含 prd 或正文含 `## 4. 功能需求`）时登记 prd_markdown source。
+ * - HTML 页面登记为 uiSignals（字段、按钮、表格列、弹窗）。
+ * - Java Action 登记为 backendSignals（方法名、callback 消息）。
+ * - 无 spec.yaml 时 mode='prd+html+java'；有 spec.yaml 时 mode='extracted'。
+ *
+ * @param input - 输入参数（codeListPath、docsDir、codeList、pages、actions）。
+ * @returns 源分析快照。
+ */
+export declare function buildSourceAnalysis(input: BuildSourceAnalysisInput): SourceAnalysis;
+//# sourceMappingURL=source-analysis.d.ts.map

package/dist/src/inference/source-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-analysis.d.ts","sourceRoot":"","sources":["../../../src/inference/source-analysis.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAEV,cAAc,EAGf,MAAM,iCAAiC,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,wBAAwB,CAAC;IACnC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC,CAAC;AAgLF;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,cAAc,CAkFnF"}