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

package/codex-skill/ep-stage/glue-test/scripts/generate-crud-spec.mjs

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const skillRoot = path.resolve(__dirname, '..');
+const packageRoot = path.resolve(skillRoot, '../..');
+const repoRoot = path.resolve(packageRoot, '../..');
+
+function help() {
+  console.log(`Usage:
+  node scripts/generate-crud-spec.mjs \\
+    --module-id <module-id> \\
+    --docs <docs-dir> \\
+    --code-list <code-list-md> \\
+    --webapp <html-dir> \\
+    --java-actions <java-action-dir> \\
+    --hints <module-hints-json> \\
+    --contract-out <package-output-json> \\
+    --spec-out <glue-project-spec-ts> \\
+    --menu <menu-path>
+
+Notes:
+  - Relative upstream paths are resolved from the repository root.
+  - The contract path is passed to @epoint/ep-stage-skill relative to its package root.
+  - The script fails when unresolvedSlots is non-empty.
+`);
+}
+
+function parseArgs(argv) {
+  const args = {};
+  for (let index = 0; index < argv.length; index += 2) {
+    const key = argv[index];
+    const value = argv[index + 1];
+    if (key === '--help' || key === '-h') {
+      help();
+      process.exit(0);
+    }
+    if (!key?.startsWith('--') || !value) {
+      throw new Error(`Invalid argument near ${key ?? '<empty>'}`);
+    }
+    args[key.slice(2)] = value;
+  }
+  return args;
+}
+
+function resolveFromRepo(value) {
+  return path.isAbsolute(value) ? value : path.resolve(repoRoot, value);
+}
+
+function requirePath(label, value) {
+  if (!value) throw new Error(`Missing --${label}`);
+  const resolved = resolveFromRepo(value);
+  if (!existsSync(resolved)) throw new Error(`Path for --${label} does not exist: ${resolved}`);
+  return resolved;
+}
+
+function run(commandArgs) {
+  const result = spawnSync('pnpm', commandArgs, {
+    cwd: repoRoot,
+    stdio: 'inherit',
+    shell: false
+  });
+  if (result.status !== 0) {
+    process.exit(result.status ?? 1);
+  }
+}
+
+const args = parseArgs(process.argv.slice(2));
+const moduleId = args['module-id'];
+if (!moduleId) throw new Error('Missing --module-id');
+const docs = requirePath('docs', args.docs);
+const codeList = requirePath('code-list', args['code-list']);
+const webapp = requirePath('webapp', args.webapp);
+const javaActions = requirePath('java-actions', args['java-actions']);
+const hints = requirePath('hints', args.hints);
+const contractOut = args['contract-out'] ?? `packages/ep-stage-skill/output/${moduleId}.crud.contract.json`;
+const specOut = args['spec-out'];
+const menu = args.menu;
+if (!specOut) throw new Error('Missing --spec-out');
+if (!menu) throw new Error('Missing --menu');
+
+const contractAbs = resolveFromRepo(contractOut);
+const contractForPackage = path.relative(packageRoot, contractAbs);
+mkdirSync(path.dirname(contractAbs), { recursive: true });
+
+run([
+  '--filter',
+  '@epoint/ep-stage-skill',
+  'generate:crud-contract',
+  '--',
+  '--module-id',
+  moduleId,
+  '--docs',
+  docs,
+  '--code-list',
+  codeList,
+  '--webapp',
+  webapp,
+  '--java-actions',
+  javaActions,
+  '--hints',
+  hints,
+  '--out',
+  contractForPackage
+]);
+
+const contract = JSON.parse(readFileSync(contractAbs, 'utf8'));
+if (contract.unresolvedSlots?.length) {
+  console.error(JSON.stringify({
+    error: 'Contract has unresolvedSlots; update ModuleHints before generating a final spec.',
+    unresolvedSlots: contract.unresolvedSlots.map(({ slotId, reason, suggestedFormat }) => ({
+      slotId,
+      reason,
+      suggestedFormat
+    }))
+  }, null, 2));
+  process.exit(2);
+}
+
+const specAbs = resolveFromRepo(specOut);
+mkdirSync(path.dirname(specAbs), { recursive: true });
+
+run([
+  '--filter',
+  '@epoint/ep-stage-skill',
+  'generate:playwright-tests',
+  '--',
+  '--contract',
+  contractForPackage,
+  '--out',
+  specAbs,
+  '--menu',
+  menu
+]);
+
+console.log(JSON.stringify({
+  module: contract.module,
+  searchConditions: contract.searchConditions?.map(({ field, label, component, value }) => ({
+    field,
+    label,
+    component,
+    value
+  })),
+  contract: contractAbs,
+  spec: specAbs
+}, null, 2));

package/codex-skill/ep-stage/glue-testcase/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: glue-testcase
+description: 使用时机：当需要基于 ep-stage 可观测 trace、场景推理结果和 coverage diff 先生成可人工审阅的胶水测试用例中间产物，再供 glue-test 组装 Playwright spec 时使用。
+---
+
+# ep-stage: glue-testcase
+
+本 skill 只负责测试用例中间产物（`glue-testcase.json` / `.md`），不直接生成或执行 Playwright spec。
+
+## 工作流
+
+```text
+读取 .stage/trace
+  -> 检查 scenario-inference 是否已确认（--scenario）
+  -> 读取 coverage-diff
+  -> 生成 testcase JSON / Markdown（testcases/<module>.glue-testcase.*）
+  -> 展示推理摘要和未确认项
+  -> 人工确认后供 glue-test 消费
+```
+
+## 关键约束
+
+- 未确认的 `scenario-inference` 不得生成可执行 spec。
+- `candidate` 和 `unresolved` 必须写入 testcase 的 `reviewStatus` 和 `unresolved`。
+- 嵌套 CRUD 一期只能作为候选用例进入 testcase，不写入正式 CRUD 契约。
+- 对话中展示的是可审阅推理摘要和证据链，不展示原始隐式思维链。
+
+## 按需加载
+
+- 用例 schema：`references/testcase-schema.md`
+- 样例产物：`examples/observable-testcase.json`

package/codex-skill/ep-stage/glue-testcase/examples/observable-testcase.json

@@ -0,0 +1,40 @@
+{
+  "moduleId": "zwplace",
+  "moduleName": "场所窗口信息管理",
+  "cases": [
+    {
+      "caseId": "zwplace-crud-single-page-smoke",
+      "title": "标准 CRUD 冒烟用例",
+      "scenario": "crud.single-page",
+      "reviewStatus": "confirmed",
+      "evidence": ["新增、查询、修改、删除动作被当前骨架覆盖"],
+      "steps": ["登录系统", "进入菜单", "执行 CRUD 骨架流程"],
+      "assertions": ["创建和修改后的记录可查询"],
+      "unresolved": []
+    },
+    {
+      "caseId": "zwplace-nested-crud-candidate",
+      "title": "嵌套 CRUD 候选用例",
+      "scenario": "crud.nested",
+      "reviewStatus": "needs_review",
+      "evidence": ["新增页面中存在 mini-datagrid 与 添加窗口 按钮"],
+      "steps": ["打开新增页面", "定位窗口明细子表", "验证添加窗口候选动作"],
+      "assertions": [],
+      "unresolved": ["子表保存后断言需要人工确认"]
+    }
+  ],
+  "reasoningSummary": {
+    "conclusion": "生成 2 条用例，其中 1 条需要人工确认。",
+    "evidenceChain": [
+      {
+        "source": "html",
+        "path": "gxhzwplaceadd.html",
+        "text": "mini-datagrid + 添加窗口"
+      }
+    ],
+    "alternatives": ["crud.single-page", "crud.nested"],
+    "confidence": "medium",
+    "risks": ["子表保存后断言需要人工确认"],
+    "needsHumanReview": true
+  }
+}

package/codex-skill/ep-stage/glue-testcase/references/testcase-schema.md

@@ -0,0 +1,67 @@
+# glue-testcase schema
+
+`glue-testcase` 的 JSON 顶层结构：
+
+```json
+{
+  "moduleId": "zwplace",
+  "moduleName": "场所窗口信息管理",
+  "cases": [
+    {
+      "caseId": "zwplace.create",
+      "title": "新增场所窗口信息管理",
+      "scenario": "crud.single-page",
+      "reviewStatus": "confirmed",
+      "evidence": ["skeleton=crud.skeleton-testcase/v1", "contract=crud-business-module/v1"],
+      "steps": ["进入菜单", "点击新增", "填写并保存测试数据"],
+      "assertions": ["新增后可查询到记录"],
+      "unresolved": []
+    },
+    {
+      "caseId": "zwplace.read",
+      "title": "查询场所窗口信息管理",
+      "scenario": "crud.single-page",
+      "reviewStatus": "confirmed",
+      "evidence": ["skeleton=crud.skeleton-testcase/v1", "contract=crud-business-module/v1"],
+      "steps": ["进入菜单", "输入查询字段", "提交查询"],
+      "assertions": ["查询结果包含测试记录"],
+      "unresolved": []
+    },
+    {
+      "caseId": "zwplace.update",
+      "title": "修改场所窗口信息管理",
+      "scenario": "crud.single-page",
+      "reviewStatus": "confirmed",
+      "evidence": ["skeleton=crud.skeleton-testcase/v1", "contract=crud-business-module/v1"],
+      "steps": ["定位测试记录", "点击修改", "保存更新值"],
+      "assertions": ["修改后可查询到更新记录"],
+      "unresolved": []
+    },
+    {
+      "caseId": "zwplace.delete",
+      "title": "删除场所窗口信息管理",
+      "scenario": "crud.single-page",
+      "reviewStatus": "confirmed",
+      "evidence": ["skeleton=crud.skeleton-testcase/v1", "contract=crud-business-module/v1"],
+      "steps": ["定位测试记录", "点击删除", "确认删除策略"],
+      "assertions": ["删除结果符合契约断言策略"],
+      "unresolved": []
+    }
+  ],
+  "reasoningSummary": {
+    "conclusion": "生成 4 条 CRUD 胶水测试用例。",
+    "evidenceChain": [],
+    "alternatives": ["crud.single-page"],
+    "confidence": "high",
+    "risks": [],
+    "needsHumanReview": false
+  }
+}
+```
+
+## 字段说明
+
+- `reviewStatus`：`confirmed` / `needs_review` / `blocked`。`needs_review` 的用例不得进入 spec assembly。
+- `caseId`：spec assembly 需要与生成脚本工作流粒度一致，CRUD 用例固定为 `<moduleId>.create`、`<moduleId>.read`、`<moduleId>.update`、`<moduleId>.delete`。
+- `unresolved`：未确认项（如嵌套 CRUD 子表保存后断言）。必须落盘，不能只在对话解释。
+- `reasoningSummary`：与 `.stage/trace/<run-id>/testcase-generation.json` 同构。

package/codex-skill/ep-stage/recording-to-glue/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: recording-to-glue
+description: 使用时机：当用户讨论或规划「将录制产出的 Playwright 脚本转换为 ep-stage 胶水骨架（glue skeleton）或组件（component）候选代码」时使用。
+---
+
+# ep-stage: recording-to-glue
+
+本 skill 是一个规划中的能力入口。
+
+## 当前状态
+
+转换工作流在本期尚未实现。
+
+## 预期输入（未来）
+
+- 来自 `stage-recorder-ext` 或其他录制器的原始 Playwright 脚本。
+- 标识页面、iframe（frame）、选择器（selector）以及用户动作意图的录制元数据。
+
+## 预期产出（未来）
+
+- 候选胶水骨架代码（glue skeleton code）。
+- 候选组件动作（component actions）。
+- 关于代码应归入骨架、组件、测试 spec 还是 `ModuleHints` 的评审意见。
+
+## 当前行为
+
+当用户调用本 skill 时，应说明实现尚未开始，并提议为该转换工作流创建设计或实施计划，而不是在本期从录制产物生成生产级胶水代码。

package/codex-skill/ep-stage/scripts/validate-skill.mjs

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+import { lstatSync, readFileSync, realpathSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const epStageRoot = path.resolve(__dirname, '..');
+const packageRoot = path.resolve(epStageRoot, '../..');
+const repoRoot = path.resolve(packageRoot, '../..');
+
+function readFrontmatter(skillRoot) {
+  const skillPath = path.join(skillRoot, 'SKILL.md');
+  const text = readFileSync(skillPath, 'utf8');
+  const match = text.match(/^---\n([\s\S]*?)\n---\n/);
+  if (!match) throw new Error(`${skillPath} missing YAML frontmatter`);
+
+  const frontmatter = match[1];
+  return {
+    name: frontmatter.match(/^name:\s*(.+)$/m)?.[1]?.trim(),
+    description: frontmatter.match(/^description:\s*(.+)$/m)?.[1]?.trim(),
+    skillPath,
+  };
+}
+
+function assertSkill(skillRoot, expectedName) {
+  const { name, description, skillPath } = readFrontmatter(skillRoot);
+  if (name !== expectedName) throw new Error(`Expected name ${expectedName} in ${skillPath}, got ${name ?? 'missing'}`);
+  if (!description?.startsWith('使用时机') && !description?.startsWith('Use when')) throw new Error(`${skillPath} description 必须以「使用时机」或「Use when」开头`);
+  if (description.length > 1024) throw new Error(`${skillPath} description exceeds 1024 characters`);
+  if (path.basename(skillRoot) !== name) throw new Error(`${skillPath} directory basename must match name`);
+  return { name, descriptionLength: description.length, skillRoot };
+}
+
+function assertSymlink(linkPath, targetPath) {
+  const linkStat = lstatSync(linkPath);
+  if (!linkStat.isSymbolicLink()) throw new Error(`${linkPath} must be a symlink`);
+  if (realpathSync(linkPath) !== realpathSync(targetPath)) {
+    throw new Error(`${linkPath} does not point at ${targetPath}`);
+  }
+}
+
+// ep-stage scope 下四个 skill 的包内真相源目录。
+const skillSources = [
+  { name: 'create-project', source: path.join(epStageRoot, 'create-project') },
+  { name: 'glue-test', source: path.join(epStageRoot, 'glue-test') },
+  { name: 'glue-testcase', source: path.join(epStageRoot, 'glue-testcase') },
+  { name: 'recording-to-glue', source: path.join(epStageRoot, 'recording-to-glue') },
+];
+
+// 校验每个源 skill 的 SKILL.md frontmatter。
+const checks = skillSources.map(({ name, source }) => assertSkill(source, name));
+
+// 发现目录：Claude Code 扫 .claude/skills/，Codex 扫 .agents/skills/。
+// 两个工具都只扫直接子目录，每个子目录是一个 skill；用 symlink 指向包内源。
+const discoveryDirs = [
+  path.join(repoRoot, '.claude/skills'),
+  path.join(repoRoot, '.agents/skills'),
+];
+
+const symlinks = [];
+for (const dir of discoveryDirs) {
+  for (const { name, source } of skillSources) {
+    assertSymlink(path.join(dir, name), source);
+    symlinks.push({ dir: path.relative(repoRoot, dir), name, pointsTo: path.relative(repoRoot, source) });
+  }
+}
+
+console.log(JSON.stringify({
+  ok: true,
+  packageRoot,
+  checks,
+  symlinks,
+}, null, 2));

package/dist/src/capability/coverage-diff.d.ts

@@ -0,0 +1,34 @@
+import type { ActionCandidate, AgentInferredWorkflow, SkeletonCoverage } from '../contracts/gap-inference.js';
+import type { CoverageDiffTrace } from '../contracts/observable-chain.js';
+import type { PageStructureSummary } from './page-structure.js';
+/**
+ * createCoverageDiff 的入参。
+ *
+ * @property moduleId - 当前模块 id。
+ * @property actionCandidates - 动作候选列表（来自确定性 extractor）。
+ * @property skeletonCoverage - 当前骨架能力模型。
+ * @property baselineWorkflows - 现有 gap planner 的基线 workflow。
+ * @property pageStructures - 页面结构摘要列表。
+ */
+export type CreateCoverageDiffInput = {
+    moduleId: string;
+    actionCandidates: ActionCandidate[];
+    skeletonCoverage: SkeletonCoverage;
+    baselineWorkflows: AgentInferredWorkflow[];
+    pageStructures: PageStructureSummary[];
+};
+/**
+ * 把动作候选、骨架覆盖、基线 workflow 与页面结构组合成 coverage diff trace。
+ *
+ * - covered：动作标签已被骨架覆盖。
+ * - gapCandidates：动作不在骨架覆盖标签中，需证据或人工确认。
+ * - nestedCrudCandidates：页面结构标记的嵌套 CRUD 候选。
+ * - comparison：基线 workflow 与泛化 gap 候选的集合差异。
+ *
+ * 不删除现有 gap planner 基线，新旧 diff 并行输出。
+ *
+ * @param input - coverage diff 入参。
+ * @returns coverage diff trace。
+ */
+export declare function createCoverageDiff(input: CreateCoverageDiffInput): CoverageDiffTrace;
+//# sourceMappingURL=coverage-diff.d.ts.map

package/dist/src/capability/coverage-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage-diff.d.ts","sourceRoot":"","sources":["../../../src/capability/coverage-diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAC9G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE;;;;;;;;GAQG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,iBAAiB,EAAE,qBAAqB,EAAE,CAAC;IAC3C,cAAc,EAAE,oBAAoB,EAAE,CAAC;CACxC,CAAC;AAYF;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,iBAAiB,CAuEpF"}

package/dist/src/capability/coverage-diff.js

@@ -0,0 +1,91 @@
+/**
+ * 汇总骨架覆盖的所有动作标签为集合。
+ *
+ * @param coverage - 骨架能力模型。
+ * @returns 所有 coveredActionLabels 的扁平集合。
+ */
+function allCoveredLabels(coverage) {
+    return new Set(Object.values(coverage.coveredActionLabels).flatMap((labels) => labels ?? []));
+}
+/**
+ * 把动作候选、骨架覆盖、基线 workflow 与页面结构组合成 coverage diff trace。
+ *
+ * - covered：动作标签已被骨架覆盖。
+ * - gapCandidates：动作不在骨架覆盖标签中，需证据或人工确认。
+ * - nestedCrudCandidates：页面结构标记的嵌套 CRUD 候选。
+ * - comparison：基线 workflow 与泛化 gap 候选的集合差异。
+ *
+ * 不删除现有 gap planner 基线，新旧 diff 并行输出。
+ *
+ * @param input - coverage diff 入参。
+ * @returns coverage diff trace。
+ */
+export function createCoverageDiff(input) {
+    const coveredLabels = allCoveredLabels(input.skeletonCoverage);
+    const covered = input.actionCandidates
+        .filter((candidate) => coveredLabels.has(candidate.label))
+        .map((candidate) => ({
+        actionId: candidate.actionId,
+        label: candidate.label,
+        pageId: candidate.pageId,
+        status: 'covered',
+        reason: '动作标签已被当前骨架能力覆盖。',
+    }));
+    const gapCandidates = input.actionCandidates
+        .filter((candidate) => !coveredLabels.has(candidate.label))
+        .map((candidate) => ({
+        actionId: candidate.actionId,
+        label: candidate.label,
+        pageId: candidate.pageId,
+        status: 'gap-candidate',
+        reason: '动作不在当前骨架覆盖标签中，需要证据或人工确认。',
+    }));
+    const nestedCrudCandidates = input.pageStructures
+        .filter((page) => page.nestedCrudCandidate)
+        .map((page) => ({
+        pageId: page.pageId,
+        evidence: page.evidenceLabels,
+        supportedActions: [
+            ...(page.createCandidate ? ['create'] : []),
+            ...(page.deleteCandidate ? ['delete'] : []),
+            ...(page.updateOrDetailCandidate ? ['update-or-detail'] : []),
+        ],
+        unresolvedReason: page.risks[0] ?? '嵌套 CRUD 操作边界需要人工确认',
+    }));
+    const baseline = {
+        plannedWorkflows: input.baselineWorkflows
+            .filter((item) => item.status === 'planned')
+            .map((item) => item.workflowId),
+        candidateWorkflows: input.baselineWorkflows
+            .filter((item) => item.status === 'candidate')
+            .map((item) => item.workflowId),
+        unresolvedWorkflows: input.baselineWorkflows
+            .filter((item) => item.status === 'unresolved')
+            .map((item) => item.workflowId),
+    };
+    const generalizedIds = gapCandidates.map((item) => item.actionId);
+    const baselineIds = input.baselineWorkflows.map((item) => item.workflowId);
+    return {
+        moduleId: input.moduleId,
+        skeletonCoverageId: input.skeletonCoverage.coverageId,
+        baseline,
+        covered,
+        partiallyCovered: [],
+        gapCandidates,
+        unresolved: [],
+        nestedCrudCandidates,
+        comparison: {
+            both: baselineIds.filter((id) => generalizedIds.includes(id)),
+            onlyBaseline: baselineIds.filter((id) => !generalizedIds.includes(id)),
+            onlyGeneralized: generalizedIds.filter((id) => !baselineIds.includes(id)),
+        },
+        reasoningSummary: {
+            conclusion: `识别 covered=${covered.length}，gap-candidate=${gapCandidates.length}，nested-crud=${nestedCrudCandidates.length}；基线 workflow=${baselineIds.length}。`,
+            evidenceChain: nestedCrudCandidates.flatMap((candidate) => candidate.evidence.map((text) => ({ source: 'html', path: candidate.pageId, text }))),
+            alternatives: ['当前 gap planner 基线', '泛化 coverage diff'],
+            confidence: 'medium',
+            risks: nestedCrudCandidates.map((candidate) => candidate.unresolvedReason),
+            needsHumanReview: gapCandidates.length > 0 || nestedCrudCandidates.length > 0,
+        },
+    };
+}

package/dist/src/capability/page-structure.d.ts

@@ -0,0 +1,31 @@
+import type { ExtractedHtmlPage } from '../extractors/html-page.js';
+/**
+ * 页面结构摘要：把静态结构信号归纳为 CRUD 场景候选的布尔判断与可审阅证据标签。
+ *
+ * 结构信号只提升候选置信度，不直接生成测试（遵守 dev-rules：通用优先，业务后移）。
+ */
+export type PageStructureSummary = {
+    pageId: string;
+    readSearchCandidate: boolean;
+    createCandidate: boolean;
+    deleteCandidate: boolean;
+    updateOrDetailCandidate: boolean;
+    nestedCrudCandidate: boolean;
+    evidenceLabels: string[];
+    risks: string[];
+};
+/**
+ * 把 ExtractedHtmlPage 的 pageStructureSignals 归纳为场景候选摘要。
+ *
+ * 判定规则：
+ * - readSearchCandidate：存在 datagrid 且（condition 或 pager）。
+ * - createCandidate：工具栏按钮含 新增/添加。
+ * - deleteCandidate：存在 checkcolumn 选择列且工具栏含 删除。
+ * - updateOrDetailCandidate：存在 actioncolumn 行操作。
+ * - nestedCrudCandidate：datagrid + (create/delete) + 页面 id 以 add/edit 结尾或存在弹窗入口。
+ *
+ * @param page - 已抽取的 HTML 页面结构。
+ * @returns 场景候选摘要，含证据标签与风险。
+ */
+export declare function summarizePageStructure(page: ExtractedHtmlPage): PageStructureSummary;
+//# sourceMappingURL=page-structure.d.ts.map

package/dist/src/capability/page-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-structure.d.ts","sourceRoot":"","sources":["../../../src/capability/page-structure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,uBAAuB,EAAE,OAAO,CAAC;IACjC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAaF;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,iBAAiB,GAAG,oBAAoB,CA8BpF"}

package/dist/src/capability/page-structure.js

@@ -0,0 +1,50 @@
+/**
+ * 判断 values 中是否存在任一包含 keywords 中关键词的项。
+ *
+ * @param values - 待检文本列表（如工具栏按钮标签）。
+ * @param keywords - 触发关键词列表。
+ * @returns 是否命中任一关键词。
+ */
+function includesAny(values, keywords) {
+    return values.some((value) => keywords.some((keyword) => value.includes(keyword)));
+}
+/**
+ * 把 ExtractedHtmlPage 的 pageStructureSignals 归纳为场景候选摘要。
+ *
+ * 判定规则：
+ * - readSearchCandidate：存在 datagrid 且（condition 或 pager）。
+ * - createCandidate：工具栏按钮含 新增/添加。
+ * - deleteCandidate：存在 checkcolumn 选择列且工具栏含 删除。
+ * - updateOrDetailCandidate：存在 actioncolumn 行操作。
+ * - nestedCrudCandidate：datagrid + (create/delete) + 页面 id 以 add/edit 结尾或存在弹窗入口。
+ *
+ * @param page - 已抽取的 HTML 页面结构。
+ * @returns 场景候选摘要，含证据标签与风险。
+ */
+export function summarizePageStructure(page) {
+    const signals = page.pageStructureSignals;
+    const evidenceLabels = [
+        ...(signals.dataGrid.staticPresent ? ['可见 mini-datagrid 结构存在'] : []),
+        ...(signals.searchCondition.staticPresent ? ['可见 fui-condition 结构存在'] : []),
+        ...(signals.pager.staticPresent ? ['可见 mini-grid-pager 结构存在'] : []),
+        ...(signals.hasSelectionColumn ? ['表格存在 checkcolumn 选择列'] : []),
+        ...(signals.hasActionColumn ? ['表格存在 actioncolumn 行操作'] : []),
+    ];
+    const createCandidate = includesAny(signals.toolbarButtonLabels, ['新增', '添加']);
+    const deleteCandidate = signals.hasSelectionColumn && includesAny(signals.toolbarButtonLabels, ['删除']);
+    const updateOrDetailCandidate = signals.hasActionColumn;
+    const readSearchCandidate = signals.dataGrid.staticPresent && (signals.searchCondition.staticPresent || signals.pager.staticPresent);
+    const nestedCrudCandidate = signals.dataGrid.staticPresent &&
+        (createCandidate || deleteCandidate) &&
+        (page.pageId.endsWith('add') || page.pageId.endsWith('edit') || signals.dialogTargets.length > 0);
+    return {
+        pageId: page.pageId,
+        readSearchCandidate,
+        createCandidate,
+        deleteCandidate,
+        updateOrDetailCandidate,
+        nestedCrudCandidate,
+        evidenceLabels,
+        risks: nestedCrudCandidate ? ['嵌套 CRUD 断言和保存边界需要人工确认'] : [],
+    };
+}

package/dist/src/capability/scenario-inference.d.ts

@@ -0,0 +1,36 @@
+import type { ScenarioInferenceTrace } from '../contracts/observable-chain.js';
+import type { PageStructureSummary } from './page-structure.js';
+/**
+ * inferPageScenarios 的入参。
+ *
+ * @property moduleId - 当前模块 id。
+ * @property pages - 参与推理的页面结构摘要列表。
+ * @property skeletonCapabilities - 当前骨架已覆盖的能力（如 crud.create）。
+ */
+export type InferPageScenariosInput = {
+    moduleId: string;
+    pages: PageStructureSummary[];
+    skeletonCapabilities: string[];
+};
+/**
+ * 根据页面结构候选生成场景推理结果。
+ *
+ * 候选优先级：嵌套 CRUD > 单页 CRUD > unknown。嵌套 CRUD 存在时单页 CRUD 降为中置信。
+ * 场景推理 gate 恒为 needs_review，需人工 confirm / correct / add-evidence / skip。
+ *
+ * @param input - 模块 id、页面结构摘要、骨架能力列表。
+ * @returns 场景推理 trace，含候选列表、gate 与推理摘要。
+ */
+export declare function inferPageScenarios(input: InferPageScenariosInput): ScenarioInferenceTrace;
+/**
+ * 记录人工对场景推理的纠偏，标记需要重新推理。
+ *
+ * @param input.inference - 原始场景推理 trace。
+ * @param input.correction - 人工纠偏文本。
+ * @returns 更新后的 trace，gate 为 corrected，推理摘要追加人工证据。
+ */
+export declare function applyScenarioHumanCorrection(input: {
+    inference: ScenarioInferenceTrace;
+    correction: string;
+}): ScenarioInferenceTrace;
+//# sourceMappingURL=scenario-inference.d.ts.map

package/dist/src/capability/scenario-inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-inference.d.ts","sourceRoot":"","sources":["../../../src/capability/scenario-inference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,sBAAsB,EACvB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC;AA2CF;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,sBAAsB,CAgDzF;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,SAAS,EAAE,sBAAsB,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,sBAAsB,CAsBzB"}