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

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

@@ -15,8 +15,8 @@ export type { ActionCandidate, AgentInferredWorkflow, GapActionType, GapExplorat
 export type { ObservableArtifactRef, ObservableGate, ObservableStageName, ObservableStagePayload, ObservableStageSummary, ReasoningEvidence, ReasoningSummary, TraceWriterOptions } from './contracts/observable-chain.js';
 export { createTraceWriter, } from './trace/trace-writer.js';
 export type { TraceWriter, } from './trace/trace-writer.js';
-export { readStageContext, resolveStageContext, writeProjectIndex, } from './context/stage-context.js';
-export type { ProjectIndex, ProjectIndexEntry, ResolveStageContextInput, ResolveStageContextResult, StageContext, StageContextMode, } from './context/stage-context.js';
+export { lookupProjectByRequirement, readStageContext, resolveStageContext, writeProjectIndex, } from './context/stage-context.js';
+export type { LookupProjectByRequirementInput, ProjectIndex, ProjectIndexEntry, ProjectsIndex, RequirementEntry, ResolveStageContextInput, ResolveStageContextResult, StageContext, StageContextMode, SystemEntry, } from './context/stage-context.js';
 export { renderReviewSummary, } from './trace/review-summary.js';
 export type { ReviewSummaryInput, } from './trace/review-summary.js';
 export { collectActionCandidates, } from './gap-planner/action-candidates.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":"AAAA,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,QAAQ,EACR,gCAAgC,EAChC,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,SAAS,EACT,6BAA6B,EAC7B,cAAc,EACd,kBAAkB,EACnB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACL,eAAe,EAChB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,eAAe,EAChB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,yBAAyB,EACzB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,sBAAsB,EACvB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,wBAAwB,EACzB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,mBAAmB,EACpB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,+BAA+B,EAChC,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,6BAA6B,EAC7B,mCAAmC,EACnC,4BAA4B,EAC7B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,kCAAkC,EAClC,6BAA6B,EAC7B,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,uCAAuC,CAAC;AAE/C,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EACV,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,WAAW,GACZ,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,+BAA+B,EAC/B,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,EACzB,YAAY,EACZ,gBAAgB,EAChB,WAAW,GACZ,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,uBAAuB,GACxB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,0BAA0B,GAC3B,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EACL,gBAAgB,GACjB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,gDAAgD,CAAC;AAExD,OAAO,EACL,wBAAwB,GACzB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EACV,kBAAkB,EAClB,yBAAyB,EACzB,6BAA6B,EAC7B,8BAA8B,EAC9B,eAAe,GAChB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,sBAAsB,GACvB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EACV,uBAAuB,GACxB,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,qBAAqB,GACtB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,2CAA2C,GAC5C,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EACV,iBAAiB,EACjB,mCAAmC,EACnC,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,YAAY,EACZ,oBAAoB,GACrB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,sBAAsB,EACtB,mCAAmC,EACnC,+BAA+B,EAC/B,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,sBAAsB,EACtB,8BAA8B,EAC9B,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,2BAA2B,EAC3B,gCAAgC,EAChC,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,yCAAyC,CAAC;AACjD,YAAY,EACV,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EACL,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,wBAAwB,EACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,6BAA6B,EAC9B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,qBAAqB,EACtB,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,aAAa,EACb,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,QAAQ,EACT,MAAM,gCAAgC,CAAC"}

package/dist/src/index.js

@@ -5,7 +5,7 @@ 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 { createTraceWriter, } from './trace/trace-writer.js';
-export { readStageContext, resolveStageContext, writeProjectIndex, } from './context/stage-context.js';
+export { lookupProjectByRequirement, readStageContext, resolveStageContext, writeProjectIndex, } from './context/stage-context.js';
 export { renderReviewSummary, } from './trace/review-summary.js';
 export { collectActionCandidates, } from './gap-planner/action-candidates.js';
 export { createSkeletonCoverage, } from './gap-planner/skeleton-coverage.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"}