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

package/dist/src/gap-planner/action-candidates.js

@@ -0,0 +1,66 @@
+/**
+ * 从 CrudBusinessModuleContract 的页面按钮、行操作、弹窗动作归一化 ActionCandidate。
+ *
+ * 只收集事实，不判断是否生成测试。证据来源通过 sourceRefToEvidenceRef 转换保障类型安全。
+ */
+import { stableActionId } from './stable-id.js';
+/**
+ * 将 SourceRef 转换为 EvidenceRef，确保类型安全。
+ */
+function sourceRefToEvidenceRef(source, overrides) {
+    return {
+        kind: overrides.kind,
+        path: source.path,
+        locator: overrides.locator,
+        evidenceText: overrides.evidenceText ?? source.evidence,
+        confidence: source.confidence,
+    };
+}
+function pageCandidates(moduleId, page) {
+    const buttonCandidates = page.buttons.map((button) => ({
+        actionId: stableActionId({
+            moduleId,
+            pageId: page.pageId,
+            actionType: 'page_button',
+            label: button.label,
+        }),
+        moduleId,
+        pageId: page.pageId,
+        pageRole: page.role,
+        actionType: 'page_button',
+        label: button.label,
+        onclick: button.onclick,
+        locator: button.locator,
+        evidence: button.sources.map((source) => sourceRefToEvidenceRef(source, {
+            kind: 'html_button',
+            locator: button.locator,
+            evidenceText: button.label,
+        })),
+        sourceRefs: button.sources,
+    }));
+    const rowActionCandidates = page.grids.flatMap((grid) => (grid.rowActions ?? []).map((action) => ({
+        actionId: stableActionId({
+            moduleId,
+            pageId: page.pageId,
+            actionType: 'row_action',
+            label: action.label,
+        }),
+        moduleId,
+        pageId: page.pageId,
+        pageRole: page.role,
+        actionType: 'row_action',
+        label: action.label,
+        onclick: action.onclick,
+        locator: action.locator,
+        evidence: action.sources.map((source) => sourceRefToEvidenceRef(source, {
+            kind: 'grid_row_action',
+            locator: action.locator,
+            evidenceText: action.label,
+        })),
+        sourceRefs: action.sources,
+    })));
+    return [...buttonCandidates, ...rowActionCandidates];
+}
+export function collectActionCandidates(contract) {
+    return Object.values(contract.pages).flatMap((page) => pageCandidates(contract.module.id, page));
+}

package/dist/src/gap-planner/list-gap-workflows.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Gap 清单生成：把契约中的 agentInferredWorkflows 整理为可供人工筛选的清单。
+ *
+ * 这是「gap 人工筛选 gate」的离线纯逻辑：物料钻探后、进入 runtime 推理前，
+ * 列出每个 gap 的状态、是否已有业务意图、建议进入的推理模式，供人工剔除无效 gap。
+ *
+ * @module gap-planner/list-gap-workflows
+ */
+import type { CrudBusinessModuleContract } from '../contracts/crud-business-module.js';
+import type { GapListItem } from '../contracts/gap-inference.js';
+/**
+ * 把契约中的 gap 工作流整理为人工筛选清单。
+ * @param contract CRUD 业务模块契约
+ * @returns gap 清单条目数组
+ */
+export declare function listGapWorkflows(contract: CrudBusinessModuleContract): GapListItem[];
+//# sourceMappingURL=list-gap-workflows.d.ts.map

package/dist/src/gap-planner/list-gap-workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-gap-workflows.d.ts","sourceRoot":"","sources":["../../../src/gap-planner/list-gap-workflows.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,KAAK,EAAyB,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAoBxF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,0BAA0B,GAAG,WAAW,EAAE,CAgBpF"}

package/dist/src/gap-planner/list-gap-workflows.js

@@ -0,0 +1,47 @@
+/**
+ * Gap 清单生成：把契约中的 agentInferredWorkflows 整理为可供人工筛选的清单。
+ *
+ * 这是「gap 人工筛选 gate」的离线纯逻辑：物料钻探后、进入 runtime 推理前，
+ * 列出每个 gap 的状态、是否已有业务意图、建议进入的推理模式，供人工剔除无效 gap。
+ *
+ * @module gap-planner/list-gap-workflows
+ */
+/**
+ * 根据 gap 状态建议进入的 runtime 模式。
+ * - 已处理（resolved/generated/passed/failed）→ skip
+ * - 有业务意图（planned）→ infer（引导模式）
+ * - 其余（candidate/unresolved/needs_review）→ explore（探索模式）
+ * @param workflow gap 工作流
+ * @returns 建议模式
+ */
+function suggestMode(workflow) {
+    if (['resolved', 'generated', 'passed', 'failed'].includes(workflow.status)) {
+        return 'skip';
+    }
+    if (workflow.status === 'planned') {
+        return 'infer';
+    }
+    return 'explore';
+}
+/**
+ * 把契约中的 gap 工作流整理为人工筛选清单。
+ * @param contract CRUD 业务模块契约
+ * @returns gap 清单条目数组
+ */
+export function listGapWorkflows(contract) {
+    return (contract.agentInferredWorkflows ?? []).map((workflow) => {
+        const candidate = workflow.actionCandidates[0];
+        return {
+            workflowId: workflow.workflowId,
+            label: candidate?.label ?? workflow.workflowId,
+            status: workflow.status,
+            actionType: candidate?.actionType ?? 'page_button',
+            pageRole: candidate?.pageRole ?? 'unknown',
+            hasIntent: workflow.businessIntent.status === 'resolved',
+            hasAssertion: workflow.assertionExpectation.status === 'resolved',
+            suggestedMode: suggestMode(workflow),
+            evidenceSummary: Array.from(new Set(workflow.evidence.map((item) => item.kind))).join(', '),
+            triggerReason: workflow.triggerReason,
+        };
+    });
+}

package/dist/src/gap-planner/plan-agent-workflows.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Gap Planner：执行 coverage diff，输出 AgentInferredWorkflow[]。
+ *
+ * 核心逻辑：
+ * 1. 从契约收集全部 ActionCandidate
+ * 2. 构造 SkeletonCoverage 获取已覆盖标签
+ * 3. 差集 = 未覆盖动作
+ * 4. 按证据强度分级：planned / candidate / unresolved
+ *
+ * 证据组合规则（设计文档 §6.1）：
+ * - HTML 按钮 + ModuleHints(expectedIntent + expectedAssertion) → planned
+ * - HTML 按钮 + Java Action messages → planned（断言来自 Java）
+ * - 只有 HTML 按钮 → candidate
+ * - ModuleHints include: false → 排除
+ */
+import type { CrudBusinessModuleContract, ModuleHints } from '../contracts/crud-business-module.js';
+import type { AgentInferredWorkflow } from '../contracts/gap-inference.js';
+import type { ExtractedJavaAction } from '../extractors/java-action.js';
+type PlanInput = {
+    contract: CrudBusinessModuleContract;
+    actions: ExtractedJavaAction[];
+    hints?: ModuleHints;
+};
+export declare function planAgentInferredWorkflows(input: PlanInput): AgentInferredWorkflow[];
+export {};
+//# sourceMappingURL=plan-agent-workflows.d.ts.map

package/dist/src/gap-planner/plan-agent-workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-agent-workflows.d.ts","sourceRoot":"","sources":["../../../src/gap-planner/plan-agent-workflows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAe,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACjH,OAAO,KAAK,EAAE,qBAAqB,EAAqC,MAAM,+BAA+B,CAAC;AAC9G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAKxE,KAAK,SAAS,GAAG;IACf,QAAQ,EAAE,0BAA0B,CAAC;IACrC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAsHF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,SAAS,GAAG,qBAAqB,EAAE,CASpF"}

package/dist/src/gap-planner/plan-agent-workflows.js

@@ -0,0 +1,116 @@
+/**
+ * Gap Planner：执行 coverage diff，输出 AgentInferredWorkflow[]。
+ *
+ * 核心逻辑：
+ * 1. 从契约收集全部 ActionCandidate
+ * 2. 构造 SkeletonCoverage 获取已覆盖标签
+ * 3. 差集 = 未覆盖动作
+ * 4. 按证据强度分级：planned / candidate / unresolved
+ *
+ * 证据组合规则（设计文档 §6.1）：
+ * - HTML 按钮 + ModuleHints(expectedIntent + expectedAssertion) → planned
+ * - HTML 按钮 + Java Action messages → planned（断言来自 Java）
+ * - 只有 HTML 按钮 → candidate
+ * - ModuleHints include: false → 排除
+ */
+import { collectActionCandidates } from './action-candidates.js';
+import { createSkeletonCoverage } from './skeleton-coverage.js';
+import { stableWorkflowId } from './stable-id.js';
+function allCoveredLabels(coverage) {
+    return new Set(Object.values(coverage.coveredActionLabels).flatMap((labels) => labels ?? []));
+}
+function hintForCandidate(candidate, hints) {
+    return hints?.customWorkflows?.find((workflow) => workflow.label === candidate.label || workflow.actionAlias?.includes(candidate.label));
+}
+function hintEvidence(label) {
+    return {
+        kind: 'test_policy_hint',
+        path: 'ModuleHints.customWorkflows',
+        evidenceText: label,
+        confidence: 'high',
+    };
+}
+/**
+ * 从 Java Action 中提取与候选动作匹配的回调消息证据。
+ * 优先使用 HTML 中的 onclick 方法名绑定 Java Action，避免中文标签模糊匹配。
+ */
+function onclickMethodNames(onclick) {
+    if (!onclick) {
+        return [];
+    }
+    return Array.from(new Set(Array.from(onclick.matchAll(/([A-Za-z_][A-Za-z0-9_]*)\s*\(/g), (match) => match[1])));
+}
+function matchesJavaMethod(methodName, action) {
+    return action.methods.some((method) => method === methodName);
+}
+function javaActionEvidence(candidate, actions) {
+    const methodNames = onclickMethodNames(candidate.onclick);
+    if (methodNames.length === 0) {
+        return [];
+    }
+    const matchedActions = actions.filter((action) => methodNames.some((methodName) => matchesJavaMethod(methodName, action)));
+    return matchedActions.flatMap((action) => [
+        ...methodNames
+            .filter((methodName) => matchesJavaMethod(methodName, action))
+            .map((methodName) => ({
+            kind: 'java_action_method',
+            path: action.path,
+            evidenceText: methodName,
+            confidence: 'high',
+        })),
+        ...action.messages.map((message) => ({
+            kind: 'java_callback_message',
+            path: action.path,
+            evidenceText: message,
+            confidence: 'medium',
+        })),
+    ]);
+}
+function buildWorkflow(candidate, javaEvidence, hints) {
+    const hint = hintForCandidate(candidate, hints);
+    if (hint?.include === false) {
+        return undefined;
+    }
+    const hasIntent = Boolean(hint?.expectedIntent);
+    const javaAssertion = javaEvidence.find((item) => item.kind === 'java_callback_message')?.evidenceText;
+    const hasAssertion = Boolean(hint?.expectedAssertion ?? javaAssertion);
+    const status = hasIntent && hasAssertion ? 'planned' : 'candidate';
+    const evidence = [
+        ...candidate.evidence,
+        ...(hint ? [hintEvidence(candidate.label)] : []),
+        ...javaEvidence,
+    ];
+    return {
+        workflowId: stableWorkflowId({
+            moduleId: candidate.moduleId,
+            pageId: candidate.pageId,
+            actionType: candidate.actionType,
+            label: candidate.label,
+        }),
+        workflowKind: 'custom',
+        executionSource: 'agent_inferred',
+        status,
+        businessIntent: hasIntent
+            ? { status: 'resolved', value: hint.expectedIntent }
+            : { status: 'unresolved', unresolved: { reason: '缺少业务意图证据', expectedProvider: 'tester', suggestedFormat: '{ "customWorkflows": [{ "expectedIntent": "..." }] }' } },
+        elementActions: { status: 'resolved', value: [`点击「${candidate.label}」按钮`] },
+        assertionExpectation: hasAssertion
+            ? { status: 'resolved', value: hint?.expectedAssertion ?? javaAssertion }
+            : { status: 'unresolved', unresolved: { reason: '缺少断言预期证据', expectedProvider: 'tester', suggestedFormat: '{ "customWorkflows": [{ "expectedAssertion": "..." }] }' } },
+        actionCandidates: [candidate],
+        triggerReason: '该动作不属于 CRUD + Export 骨架覆盖范围。',
+        evidence,
+        reviewReason: status === 'planned'
+            ? '由 gap-planner 基于上游物料和 ModuleHints 识别为自定义业务动作。'
+            : `已发现「${candidate.label}」动作，但缺少业务意图或断言预期证据。`,
+    };
+}
+export function planAgentInferredWorkflows(input) {
+    const coverage = createSkeletonCoverage(input.contract, input.hints);
+    const coveredLabels = allCoveredLabels(coverage);
+    const candidates = collectActionCandidates(input.contract);
+    return candidates
+        .filter((candidate) => !coveredLabels.has(candidate.label))
+        .map((candidate) => buildWorkflow(candidate, javaActionEvidence(candidate, input.actions), input.hints))
+        .filter((workflow) => Boolean(workflow));
+}

package/dist/src/gap-planner/skeleton-coverage.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 从标准 flow、ModuleHints.buttonAliases、内置辅助动作集合构造 SkeletonCoverage。
+ *
+ * 覆盖模型不绑定具体系统页面，只描述能力边界。
+ */
+import type { SkeletonCoverage } from '../contracts/gap-inference.js';
+import type { CrudBusinessModuleContract, ModuleHints } from '../contracts/crud-business-module.js';
+export declare function createSkeletonCoverage(contract: CrudBusinessModuleContract, hints?: ModuleHints): SkeletonCoverage;
+//# sourceMappingURL=skeleton-coverage.d.ts.map

package/dist/src/gap-planner/skeleton-coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton-coverage.d.ts","sourceRoot":"","sources":["../../../src/gap-planner/skeleton-coverage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,0BAA0B,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAMpG,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,0BAA0B,EACpC,KAAK,CAAC,EAAE,WAAW,GAClB,gBAAgB,CAgClB"}

package/dist/src/gap-planner/skeleton-coverage.js

@@ -0,0 +1,41 @@
+/**
+ * 从标准 flow、ModuleHints.buttonAliases、内置辅助动作集合构造 SkeletonCoverage。
+ *
+ * 覆盖模型不绑定具体系统页面，只描述能力边界。
+ */
+function compact(values) {
+    return Array.from(new Set(values.filter((value) => Boolean(value))));
+}
+export function createSkeletonCoverage(contract, hints) {
+    return {
+        coverageId: 'crud-plus-export/v1',
+        coveredWorkflows: ['crud.create', 'crud.read', 'crud.update', 'crud.delete', 'export.run'],
+        coveredActionLabels: {
+            create: compact([
+                contract.flows.create?.entryButton.label,
+                ...(hints?.buttonAliases?.create ?? []),
+            ]),
+            read: compact([
+                contract.flows.search?.submitControl.label,
+                ...(hints?.buttonAliases?.search ?? []),
+            ]),
+            update: compact([
+                contract.flows.update?.entryAction.label,
+                ...(hints?.buttonAliases?.edit ?? []),
+            ]),
+            delete: compact([
+                contract.flows.delete?.entryButton.label,
+                ...(hints?.buttonAliases?.delete ?? []),
+            ]),
+            export: compact(hints?.buttonAliases?.export ?? ['导出']),
+            internal: compact([
+                '保存并关闭',
+                '确定',
+                '取消',
+                '关闭',
+                ...(hints?.buttonAliases?.saveAndClose ?? []),
+                ...(hints?.buttonAliases?.confirm ?? []),
+            ]),
+        },
+    };
+}

package/dist/src/gap-planner/stable-id.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 稳定主键生成器。
+ *
+ * 基于 moduleId/pageId/actionType/label 生成确定性 SHA1 hash，
+ * 禁止 Agent 自由翻译中文按钮。确保跨运行幂等。
+ */
+export type StableActionIdentity = {
+    moduleId: string;
+    pageId: string;
+    actionType: string;
+    label: string;
+};
+export declare function stableActionHash(input: StableActionIdentity): string;
+export declare function stableActionId(input: StableActionIdentity): string;
+export declare function stableWorkflowId(input: StableActionIdentity): string;
+//# sourceMappingURL=stable-id.d.ts.map

package/dist/src/gap-planner/stable-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-id.d.ts","sourceRoot":"","sources":["../../../src/gap-planner/stable-id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAKpE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAElE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAEpE"}

package/dist/src/gap-planner/stable-id.js

@@ -0,0 +1,19 @@
+/**
+ * 稳定主键生成器。
+ *
+ * 基于 moduleId/pageId/actionType/label 生成确定性 SHA1 hash，
+ * 禁止 Agent 自由翻译中文按钮。确保跨运行幂等。
+ */
+import { createHash } from 'node:crypto';
+export function stableActionHash(input) {
+    return createHash('sha1')
+        .update(`${input.moduleId}|${input.pageId}|${input.actionType}|${input.label}`)
+        .digest('hex')
+        .slice(0, 8);
+}
+export function stableActionId(input) {
+    return `${input.moduleId}.${input.pageId}.${input.actionType}.${stableActionHash(input)}`;
+}
+export function stableWorkflowId(input) {
+    return `${input.moduleId}.custom_${stableActionHash(input)}`;
+}

package/dist/src/generalization/generalization-eval.d.ts

@@ -0,0 +1,71 @@
+import type { CoverageDiffTrace, ScenarioInferenceTrace } from '../contracts/observable-chain.js';
+import type { ResolvedMaterialInventory } from '../material/material-inventory.js';
+/**
+ * 物料解析槽位状态（与 MaterialResolution/ValueResolution 的 status 同构）。
+ */
+export type MaterialResolutionStatus = 'resolved' | 'candidate' | 'missing';
+/**
+ * 单次 run 的泛化指标快照，供跨系统/跨 run 对比。
+ *
+ * @property materialResolution - 四类目录槽位的解析状态。
+ * @property scenarios - 推理出的场景候选。
+ * @property coverage - covered/gapCandidate/nestedCrud 计数。
+ * @property baselineWorkflowCount - 基线 workflow 总数。
+ */
+export type GeneralizationRunMetrics = {
+    moduleId: string;
+    materialResolution: {
+        docsDir: MaterialResolutionStatus;
+        webappDir: MaterialResolutionStatus;
+        javaActionsDir: MaterialResolutionStatus;
+        hintsPath: MaterialResolutionStatus;
+    };
+    scenarios: string[];
+    coverage: {
+        covered: number;
+        gapCandidate: number;
+        nestedCrud: number;
+    };
+    baselineWorkflowCount: number;
+};
+/**
+ * summarizeGeneralizationRun 的入参。
+ */
+export type SummarizeGeneralizationRunInput = {
+    moduleId: string;
+    resolvedInputs: ResolvedMaterialInventory;
+    scenario: ScenarioInferenceTrace;
+    coverageDiff: CoverageDiffTrace;
+};
+/**
+ * 两个系统/两次 run 的泛化差异对比结果。
+ */
+export type GeneralizationComparison = {
+    moduleIds: [string, string];
+    scenariosOnlyInA: string[];
+    scenariosOnlyInB: string[];
+    coverageDelta: {
+        covered: number;
+        gapCandidate: number;
+        nestedCrud: number;
+    };
+    materialResolutionDivergence: string[];
+};
+/**
+ * 把单次 run 的可观测数据汇总为可对比的泛化指标快照。
+ *
+ * 只做指标汇总，不改任何阶段判定；"泛化是否达标"由人工解读对比结果。
+ *
+ * @param input - 物料解析、场景推理、coverage diff。
+ * @returns 泛化指标快照。
+ */
+export declare function summarizeGeneralizationRun(input: SummarizeGeneralizationRunInput): GeneralizationRunMetrics;
+/**
+ * 对比两个系统/两次 run 的泛化指标差异。
+ *
+ * @param a - 系统 A 的指标。
+ * @param b - 系统 B 的指标。
+ * @returns 场景差异、coverage delta（A-B）、物料解析分歧槽位。
+ */
+export declare function compareObservableRuns(a: GeneralizationRunMetrics, b: GeneralizationRunMetrics): GeneralizationComparison;
+//# sourceMappingURL=generalization-eval.d.ts.map

package/dist/src/generalization/generalization-eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generalization-eval.d.ts","sourceRoot":"","sources":["../../../src/generalization/generalization-eval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAE5E;;;;;;;GAOG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE;QAClB,OAAO,EAAE,wBAAwB,CAAC;QAClC,SAAS,EAAE,wBAAwB,CAAC;QACpC,cAAc,EAAE,wBAAwB,CAAC;QACzC,SAAS,EAAE,wBAAwB,CAAC;KACrC,CAAC;IACF,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,yBAAyB,CAAC;IAC1C,QAAQ,EAAE,sBAAsB,CAAC;IACjC,YAAY,EAAE,iBAAiB,CAAC;CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7E,4BAA4B,EAAE,MAAM,EAAE,CAAC;CACxC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,+BAA+B,GAAG,wBAAwB,CAmB3G;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,wBAAwB,EAC3B,CAAC,EAAE,wBAAwB,GAC1B,wBAAwB,CAkB1B"}

package/dist/src/generalization/generalization-eval.js

@@ -0,0 +1,53 @@
+/**
+ * 把单次 run 的可观测数据汇总为可对比的泛化指标快照。
+ *
+ * 只做指标汇总，不改任何阶段判定；"泛化是否达标"由人工解读对比结果。
+ *
+ * @param input - 物料解析、场景推理、coverage diff。
+ * @returns 泛化指标快照。
+ */
+export function summarizeGeneralizationRun(input) {
+    const baseline = input.coverageDiff.baseline;
+    return {
+        moduleId: input.moduleId,
+        materialResolution: {
+            docsDir: input.resolvedInputs.docsDir.status,
+            webappDir: input.resolvedInputs.webappDir.status,
+            javaActionsDir: input.resolvedInputs.javaActionsDir.status,
+            hintsPath: input.resolvedInputs.hintsPath.status,
+        },
+        scenarios: input.scenario.candidates.map((candidate) => candidate.scenario),
+        coverage: {
+            covered: input.coverageDiff.covered.length,
+            gapCandidate: input.coverageDiff.gapCandidates.length,
+            nestedCrud: input.coverageDiff.nestedCrudCandidates.length,
+        },
+        baselineWorkflowCount: baseline.plannedWorkflows.length + baseline.candidateWorkflows.length + baseline.unresolvedWorkflows.length,
+    };
+}
+/**
+ * 对比两个系统/两次 run 的泛化指标差异。
+ *
+ * @param a - 系统 A 的指标。
+ * @param b - 系统 B 的指标。
+ * @returns 场景差异、coverage delta（A-B）、物料解析分歧槽位。
+ */
+export function compareObservableRuns(a, b) {
+    const keys = [
+        'docsDir',
+        'webappDir',
+        'javaActionsDir',
+        'hintsPath',
+    ];
+    return {
+        moduleIds: [a.moduleId, b.moduleId],
+        scenariosOnlyInA: a.scenarios.filter((scenario) => !b.scenarios.includes(scenario)),
+        scenariosOnlyInB: b.scenarios.filter((scenario) => !a.scenarios.includes(scenario)),
+        coverageDelta: {
+            covered: a.coverage.covered - b.coverage.covered,
+            gapCandidate: a.coverage.gapCandidate - b.coverage.gapCandidate,
+            nestedCrud: a.coverage.nestedCrud - b.coverage.nestedCrud,
+        },
+        materialResolutionDivergence: keys.filter((key) => a.materialResolution[key] !== b.materialResolution[key]),
+    };
+}

package/dist/src/generators/agent-inferred-workflow-script.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Agent 推理 Custom workflow 测试片段生成器。
+ *
+ * 渲染 executionSource='agent_inferred' 的 Playwright test 片段，
+ * 并提供幂等追加函数，避免重复追加到同一 spec。
+ */
+import type { AgentInferredWorkflow } from '../contracts/gap-inference.js';
+type RenderOptions = {
+    moduleId: string;
+    suiteTitle: string;
+    workflow: AgentInferredWorkflow;
+};
+type AppendOptions = {
+    source: string;
+    workflowId: string;
+    testTitle: string;
+    testSource: string;
+};
+export declare function renderAgentWorkflowTest(options: RenderOptions): string;
+export declare function appendAgentWorkflowTest(options: AppendOptions): string;
+export {};
+//# sourceMappingURL=agent-inferred-workflow-script.d.ts.map

package/dist/src/generators/agent-inferred-workflow-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-inferred-workflow-script.d.ts","sourceRoot":"","sources":["../../../src/generators/agent-inferred-workflow-script.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,KAAK,aAAa,GAAG;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,qBAAqB,CAAC;CACjC,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AA6LF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CA0DtE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAkBtE"}