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

package/dist/src/contracts/inference-trace.d.ts

@@ -0,0 +1,223 @@
+/**
+ * inference-trace.json 的类型定义（Plan Task 2）。
+ *
+ * 本文件只定义 `InferenceTraceV1` 的顶层章节类型：
+ * - {@link MaterialInventoryTrace}：物料清单（Task 3 负责组装，本任务只定义类型）。
+ * - {@link SourceAnalysis}：源分析快照，由 {@link buildSourceAnalysis} 产出。
+ * - {@link ModuleHintsInference}：动态槽位推理过程，由 {@link inferModuleHintsFromMaterials} 产出。
+ * - {@link InferenceTraceV1}：以上章节 + coverageDiff + reasoningSummary 的总账。
+ *
+ * 设计原则（spec §8）：顶层章节稳定，内部证据数组与 reason 允许扩展。
+ */
+import type { DeleteExpectedOutcome } from './crud-business-module.js';
+/**
+ * 单个物料的解析状态。
+ *
+ * @property status - resolved 表示物料存在且可读；missing 表示未找到。
+ * @property value - 物料值（路径或解析结果）；status 为 missing 时省略。
+ * @property reason - status 为 missing 时的缺失原因。
+ * @property evidence - 可选的来源证据（如"HTML 目录名"）。
+ */
+export type MaterialSlotStatus = {
+    status: 'resolved' | 'missing';
+    value?: string;
+    reason?: string;
+    evidence?: string;
+};
+/**
+ * 物料清单章节（spec §7 materialInventory）。
+ *
+ * Task 3 在 probe.ts 中组装，本任务只定义类型。
+ */
+export type MaterialInventoryTrace = {
+    knowledgeRoot: string;
+    moduleId: MaterialSlotStatus;
+    menu: MaterialSlotStatus;
+    htmlFiles: MaterialSlotStatus[];
+    javaActionFiles: MaterialSlotStatus[];
+    docsFiles: MaterialSlotStatus[];
+    missing: string[];
+};
+/**
+ * 源分析模式。
+ *
+ * - `extracted`：存在 spec.yaml，契约从规格抽取。
+ * - `inferred`：无 spec.yaml，契约靠推理。
+ * - `mixed`：部分从规格抽取、部分靠推理。
+ * - `prd+html+java`：基于 PRD markdown + HTML 页面 + Java Action 推理（014 场景）。
+ */
+export type SourceAnalysisMode = 'extracted' | 'inferred' | 'mixed' | 'prd+html+java';
+/**
+ * 源分析中登记的一个证据来源。
+ *
+ * @property kind - 来源类别（prd_markdown / spec_yaml / html / java_action 等）。
+ * @property path - 来源文件绝对路径。
+ * @property provides - 该来源为推理提供的能力（如 searchFields、backendMethods）。
+ */
+export type SourceAnalysisEntry = {
+    kind: string;
+    path: string;
+    provides: string[];
+};
+/**
+ * UI 侧信号（来自 HTML 页面抽取）。
+ *
+ * @property pageId - 所属页面标识。
+ * @property kind - 信号类别（field / button / gridColumn / dialog / structureSignal）。
+ * @property label - 可读标签。
+ * @property value - 信号值（字段名 / 按钮文字 / 列 field 等）。
+ */
+export type UiSignal = {
+    pageId: string;
+    kind: 'field' | 'button' | 'gridColumn' | 'dialog' | 'structureSignal';
+    label: string;
+    value?: string;
+};
+/**
+ * 后端侧信号（来自 Java Action 抽取）。
+ *
+ * @property controllerName - 所属 Controller 名称。
+ * @property kind - 信号类别（method / callbackMessage）。
+ * @property value - 信号值（方法名 / 消息文本）。
+ */
+export type BackendSignal = {
+    controllerName: string;
+    kind: 'method' | 'callbackMessage';
+    value: string;
+};
+/**
+ * 源分析章节（spec §7 sourceAnalysis）。
+ *
+ * @property mode - 源分析模式。
+ * @property confidence - 推理置信度。
+ * @property sources - 登记的证据来源列表。
+ * @property fields - 跨页面汇总的字段名候选。
+ * @property businessRules - 从 PRD/Java 中提取的业务规则线索。
+ * @property uiSignals - UI 侧信号汇总。
+ * @property backendSignals - 后端侧信号汇总。
+ * @property unresolved - 未解析的来源或缺口说明。
+ */
+export type SourceAnalysis = {
+    mode: SourceAnalysisMode;
+    confidence: 'low' | 'medium' | 'high';
+    sources: SourceAnalysisEntry[];
+    fields: string[];
+    businessRules: string[];
+    uiSignals: UiSignal[];
+    backendSignals: BackendSignal[];
+    unresolved: string[];
+};
+/**
+ * dataKey 推理过程记录。
+ *
+ * @property selectedField - 最终选定的主键字段。
+ * @property reason - 选择理由。
+ * @property evidence - 支撑证据（出现该字段的位置）。
+ */
+export type DataKeyInference = {
+    selectedField?: string;
+    reason?: string;
+    evidence: string[];
+};
+/**
+ * 搜索条件推理过程记录。
+ *
+ * @property field - 搜索条件字段名。
+ * @property component - 控件类型（input / listbox）。
+ * @property resolved - 是否已解析到可用值/策略。
+ * @property reason - 未解析时的原因。
+ */
+export type SearchConditionInference = {
+    field: string;
+    component?: 'input' | 'listbox';
+    resolved: boolean;
+    reason?: string;
+};
+/**
+ * 删除策略推理过程记录。
+ *
+ * @property value - 推理出的删除策略。
+ * @property reason - 选择理由。
+ * @property evidence - 支撑证据（Java messages）。
+ */
+export type DeletePolicyInference = {
+    value?: DeleteExpectedOutcome;
+    reason?: string;
+    evidence: string[];
+};
+/**
+ * 自定义工作流推理过程记录。
+ *
+ * @property label - 工作流标签（工具栏按钮文字）。
+ * @property actionAlias - 关联的动作别名。
+ * @property expectedIntent - 预期业务意图。
+ * @property expectedAssertion - 预期断言（有 Java callback 时填）。
+ * @property resolved - 是否已解析到可用断言。
+ * @property reason - 未解析时的原因。
+ * @property evidence - 支撑证据。
+ */
+export type CustomWorkflowInference = {
+    label: string;
+    actionAlias?: string[];
+    expectedIntent?: string;
+    expectedAssertion?: string;
+    resolved: boolean;
+    reason?: string;
+    evidence: string[];
+};
+/**
+ * 动态槽位推理章节（spec §7 moduleHintsInference）。
+ *
+ * @property mode - inferred 表示纯推理；merged 表示与显式 hints 合并。
+ * @property confidence - 推理置信度。
+ * @property dataKey - dataKey 推理过程。
+ * @property searchConditions - 搜索条件推理过程。
+ * @property buttonAliases - 按钮别名归类。
+ * @property deletePolicy - 删除策略推理过程。
+ * @property assertionPolicy - 断言策略推理过程。
+ * @property customWorkflows - 自定义工作流推理过程。
+ * @property unresolved - 未解析槽位列表。
+ */
+export type ModuleHintsInference = {
+    mode: 'inferred' | 'merged' | 'explicit_override';
+    confidence: 'low' | 'medium' | 'high';
+    dataKey: DataKeyInference;
+    searchConditions: SearchConditionInference[];
+    buttonAliases: Record<string, string[]>;
+    deletePolicy: DeletePolicyInference;
+    assertionPolicy: Record<string, string>;
+    customWorkflows: CustomWorkflowInference[];
+    unresolved: string[];
+};
+/**
+ * inference-trace.json 总账类型（schemaVersion: inference-trace/v1）。
+ *
+ * @property schemaVersion - 固定为 'inference-trace/v1'。
+ * @property codeListPath - code_list.md 绝对路径。
+ * @property generatedAt - 生成时间（ISO 8601）。
+ * @property materialInventory - 物料清单章节。
+ * @property sourceAnalysis - 源分析章节。
+ * @property moduleHintsInference - 动态槽位推理章节。
+ * @property coverageDiff - 覆盖差异章节（Task 3 后续 reconcile，本任务用内联形状）。
+ * @property reasoningSummary - 推理摘要章节。
+ */
+export type InferenceTraceV1 = {
+    schemaVersion: 'inference-trace/v1';
+    codeListPath: string;
+    generatedAt: string;
+    materialInventory: MaterialInventoryTrace;
+    sourceAnalysis: SourceAnalysis;
+    moduleHintsInference: ModuleHintsInference;
+    coverageDiff: {
+        coveredActions: unknown[];
+        uncoveredCandidates: unknown[];
+        needsReview: string[];
+    };
+    reasoningSummary: {
+        conclusion: string;
+        confidence: 'low' | 'medium' | 'high';
+        risks: string[];
+        needsHumanReview: boolean;
+    };
+};
+//# sourceMappingURL=inference-trace.d.ts.map

package/dist/src/contracts/inference-trace.d.ts.map

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

package/dist/src/contracts/inference-trace.js

@@ -0,0 +1,12 @@
+/**
+ * inference-trace.json 的类型定义（Plan Task 2）。
+ *
+ * 本文件只定义 `InferenceTraceV1` 的顶层章节类型：
+ * - {@link MaterialInventoryTrace}：物料清单（Task 3 负责组装，本任务只定义类型）。
+ * - {@link SourceAnalysis}：源分析快照，由 {@link buildSourceAnalysis} 产出。
+ * - {@link ModuleHintsInference}：动态槽位推理过程，由 {@link inferModuleHintsFromMaterials} 产出。
+ * - {@link InferenceTraceV1}：以上章节 + coverageDiff + reasoningSummary 的总账。
+ *
+ * 设计原则（spec §8）：顶层章节稳定，内部证据数组与 reason 允许扩展。
+ */
+export {};

package/dist/src/extractors/code-list.d.ts

@@ -2,8 +2,8 @@
  * 从 `code_list.md` 钻探出的单条上游物料引用。
  *
  * @property kind - 物料类别（html / java_action / spec / module_hints / other）。
- * @property rawPath - markdown 中以反引号包裹的原始相对路径。
- * @property path - 解析后的绝对路径（按 knowledge-root / code_list 所在目录 / `_docs/` 父目录优先级）。
+ * @property rawPath - markdown 中以反引号包裹的原始路径。
+ * @property path - 解析后的绝对路径（优先相对 knowledgeRoot，兼容回落到 code_list 所在目录）。
  * @property exists - 解析后的路径是否真实存在，供下游 material-inventory gate 判定。
  */
 export type ExtractedMaterialRef = {
@@ -15,7 +15,7 @@ export type ExtractedMaterialRef = {
 export type ExtractedCodeListSummary = {
     path: string;
     knowledgeRoot?: string;
-    knowledgeRootSource: 'input' | 'code_list' | 'inferred' | 'none';
+    knowledgeRootSource: 'input' | 'code_list' | 'none';
     menu?: string;
     moduleLabel: string;
     pages: string[];

package/dist/src/extractors/code-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-list.d.ts","sourceRoot":"","sources":["../../../src/extractors/code-list.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,CAAC;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,oBAAoB,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAoNF;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,6BAAkC,GAC1C,wBAAwB,CAuC1B"}
+{"version":3,"file":"code-list.d.ts","sourceRoot":"","sources":["../../../src/extractors/code-list.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,CAAC;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,oBAAoB,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAyPF;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,6BAAkC,GAC1C,wBAAwB,CAuC1B"}

package/dist/src/extractors/code-list.js

@@ -57,6 +57,24 @@ function extractDeclaredKnowledgeRoot(content, filePath) {
     const rawValue = cleanScalarValue(match[1]);
     return path.isAbsolute(rawValue) ? rawValue : path.resolve(path.dirname(filePath), rawValue);
 }
+/**
+ * 解析 code_list.md 中“整理目录”声明的上游源码根。
+ *
+ * 支持格式：
+ * - `> 整理目录：`/abs/path``
+ * - `> 整理目录: /abs/path`
+ *
+ * @param content - code_list.md 文本内容。
+ * @returns 整理目录绝对路径；缺失或非绝对路径时返回 undefined。
+ */
+function extractOrganizeRoot(content) {
+    const match = content.match(/^>\s*整理目录[：:]\s*`?(.+?)`?\s*$/m);
+    if (!match?.[1]) {
+        return undefined;
+    }
+    const candidate = cleanScalarValue(match[1]);
+    return path.isAbsolute(candidate) ? candidate : undefined;
+}
 /**
  * 提取 code_list.md 顶层标量字段。
  *
@@ -79,12 +97,27 @@ function cleanScalarValue(value) {
 /**
  * 解析 code_list.md 中声明的菜单路由。
  *
+ * 人工读写约定：code_list.md 用中文键「菜单」，与「整理目录」同风格，
+ * 支持 blockquote 形式 `> 菜单：一级菜单>二级菜单` 与裸行 `菜单: …`（反引号包裹可选）。
+ * 同时向后兼容英文键 menu / menuPath（编码内部字段名仍为 menu）。
+ *
  * @param content - code_list.md 文本内容。
  * @returns 菜单路由；未声明时返回 undefined。
  */
 function extractDeclaredMenu(content) {
-    const match = extractScalar(content, 'menu') ?? extractScalar(content, 'menuPath');
-    return match?.[1] ? cleanScalarValue(match[1]) : undefined;
+    // 优先：中文键「菜单」blockquote 形式（与「整理目录」同风格，反引号包裹可选）
+    const blockquoteMatch = content.match(/^>\s*菜单[：:]\s*`?(.+?)`?\s*$/m);
+    if (blockquoteMatch?.[1]) {
+        const value = cleanScalarValue(blockquoteMatch[1]);
+        if (value) {
+            return value;
+        }
+    }
+    // 裸行标量形式：菜单 / menu / menuPath（向后兼容英文键）
+    const scalarMatch = extractScalar(content, '菜单') ??
+        extractScalar(content, 'menu') ??
+        extractScalar(content, 'menuPath');
+    return scalarMatch?.[1] ? cleanScalarValue(scalarMatch[1]) : undefined;
 }
 /**
  * 解析本次 code_list 应使用的上游物料根路径。
@@ -105,17 +138,20 @@ function resolveKnowledgeRoot(content, filePath, options) {
             source: 'code_list',
         };
     }
-    if (options.knowledgeRoot) {
+    const organizeRoot = extractOrganizeRoot(content);
+    if (organizeRoot) {
+        if (!existsSync(organizeRoot)) {
+            throw new Error(`code_list.md 声明的整理目录不存在：${organizeRoot}`);
+        }
         return {
-            knowledgeRoot: path.resolve(options.knowledgeRoot),
-            source: 'input',
+            knowledgeRoot: organizeRoot,
+            source: 'code_list',
         };
     }
-    const codeListDir = path.dirname(filePath);
-    if (path.basename(codeListDir) === '_docs') {
+    if (options.knowledgeRoot) {
         return {
-            knowledgeRoot: path.dirname(codeListDir),
-            source: 'inferred',
+            knowledgeRoot: path.resolve(options.knowledgeRoot),
+            source: 'input',
         };
     }
     return {
@@ -123,7 +159,7 @@ function resolveKnowledgeRoot(content, filePath, options) {
     };
 }
 /**
- * 按 knowledge-root / code_list 所在目录 / `_docs/` 父目录的顺序产生候选根目录。
+ * 按 knowledgeRoot / code_list 所在目录顺序产生候选根目录。
  *
  * @param filePath - code_list.md 的绝对路径。
  * @param knowledgeRoot - 显式知识库根（可选）。
@@ -134,7 +170,6 @@ function materialRoots(filePath, knowledgeRoot) {
     return [
         ...(knowledgeRoot ? [knowledgeRoot] : []),
         codeListDir,
-        ...(path.basename(codeListDir) === '_docs' ? [path.dirname(codeListDir)] : []),
     ];
 }
 /**

package/dist/src/generators/stage-skeleton-script.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stage-skeleton-script.d.ts","sourceRoot":"","sources":["../../../src/generators/stage-skeleton-script.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAiF,MAAM,sCAAsC,CAAC;AAEtK,MAAM,MAAM,6BAA6B,GAAG,gBAAgB,GAAG,0BAA0B,CAAC;AAC1F,MAAM,MAAM,kCAAkC,GAAG,kBAAkB,GAAG,aAAa,CAAC;AAEpF,MAAM,MAAM,qCAAqC,GAAG;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,yCAAyC,GAAG;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,kCAAkC,CAAC;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,2CAA2C,GAAG;IACxD,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,qCAAqC,EAAE,CAAC;CAC5D,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAC5C,yCAAyC,GACzC,2CAA2C,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,oCAAoC,EAAE,CAAC;IACzD,MAAM,EAAE;QACN,oBAAoB,EAAE,MAAM,CAAC;QAC7B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,QAAQ,EAAE;QACR,YAAY,EAAE,MAAM,CAAC;QACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,8BAA8B,EAAE,MAAM,CAAC;QACvC,6BAA6B,EAAE,MAAM,CAAC;QACtC,cAAc,EAAE,MAAM,CAAC;QACvB,4BAA4B,EAAE,MAAM,CAAC;QACrC,gBAAgB,EAAE,MAAM,CAAC;QACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,UAAU,EAAE;QACV,YAAY,EAAE,6BAA6B,CAAC;QAC5C,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;CACH,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AA+QF;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CAAC,QAAQ,EAAE,0BAA0B,GAAG,0BAA0B,CA0CpH;AA6DD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,0BAA0B,GAAG,MAAM,CAwBtF;AAwBD;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,CAoMzF"}
+{"version":3,"file":"stage-skeleton-script.d.ts","sourceRoot":"","sources":["../../../src/generators/stage-skeleton-script.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAiF,MAAM,sCAAsC,CAAC;AAEtK,MAAM,MAAM,6BAA6B,GAAG,gBAAgB,GAAG,0BAA0B,CAAC;AAC1F,MAAM,MAAM,kCAAkC,GAAG,kBAAkB,GAAG,aAAa,CAAC;AAEpF,MAAM,MAAM,qCAAqC,GAAG;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,yCAAyC,GAAG;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,kCAAkC,CAAC;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,2CAA2C,GAAG;IACxD,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,qCAAqC,EAAE,CAAC;CAC5D,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAC5C,yCAAyC,GACzC,2CAA2C,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,oCAAoC,EAAE,CAAC;IACzD,MAAM,EAAE;QACN,oBAAoB,EAAE,MAAM,CAAC;QAC7B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,QAAQ,EAAE;QACR,YAAY,EAAE,MAAM,CAAC;QACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,8BAA8B,EAAE,MAAM,CAAC;QACvC,6BAA6B,EAAE,MAAM,CAAC;QACtC,cAAc,EAAE,MAAM,CAAC;QACvB,4BAA4B,EAAE,MAAM,CAAC;QACrC,gBAAgB,EAAE,MAAM,CAAC;QACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,UAAU,EAAE;QACV,YAAY,EAAE,6BAA6B,CAAC;QAC5C,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;CACH,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAuRF;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CAAC,QAAQ,EAAE,0BAA0B,GAAG,0BAA0B,CA0CpH;AA6DD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,0BAA0B,GAAG,MAAM,CAwBtF;AAwBD;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,CAoMzF"}

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

@@ -184,6 +184,13 @@ function findBlockedDeleteMessage(contract) {
 /**
  * 将契约中的数据生成策略映射为骨架支持的策略。
  *
+ * 设计取舍：契约把"测试人员定"的策略标成 `human_required`（属于 unresolvedSlots，由 tester 决策）。
+ * 但 spec 组装阶段缺少喂策略的顺滑入口（spec CLI 不收 hints、contract 禁手编），
+ * 若硬抛错会导致测试人员审过用例后仍卡死。
+ * 故 `human_required` / 缺省时统一**默认到 `timestamp_prefix`**——这正是 unresolvedSlots
+ * `suggestedFormat` 自身给出的建议值，也是 CRUD 冒烟造唯一数据的标配；
+ * unresolvedSlots 仍保留作审计标记，测试人员后续可通过 ModuleHints 显式覆盖。
+ *
  * @param strategy 契约数据生成策略
  * @returns 骨架数据生成策略
  */
@@ -192,6 +199,8 @@ function mapDataStrategy(strategy) {
         return 'fixed_value';
     if (strategy === 'timestamp_prefix')
         return 'timestamp_prefix';
+    if (strategy === 'human_required' || strategy === undefined)
+        return 'timestamp_prefix';
     throw new Error(`当前数据生成策略无法自动映射到 CrudFlowSlots: ${strategy}`);
 }
 /**

package/dist/src/index.d.ts

@@ -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

@@ -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"}