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

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

@@ -0,0 +1,192 @@
+/**
+ * code_list.json5 输入读取器
+ *
+ * 职责：
+ * 1. assertCodeListJson5Path — 路径硬校验，拒绝非 .json5 文件（含 .md）
+ * 2. extractCodeListJson5 — 读取并解析 JSON5 文件，校验必填字段，返回强类型产出
+ */
+import { type TestAccessConfig } from '../testcase/test-access.js';
+/** 查询字段 */
+export type QueryField = {
+    label: string;
+    type?: string;
+    component?: string;
+    modelRef?: string;
+    bind?: string;
+};
+/** 按钮/操作 */
+export type ButtonAction = {
+    label: string;
+    action: string;
+    backendMethod: string | null;
+    customAction?: string;
+};
+/** 行级操作 */
+export type RowAction = {
+    label: string;
+    action: string;
+};
+/** 数据加载方法 */
+export type DataLoadingMethod = {
+    method: string;
+    description: string;
+};
+export type ChildGridEditMode = 'cell_edit' | 'row_button_dialog' | 'none';
+/** 子表列定义 */
+export type ChildGridColumn = {
+    field: string;
+    label: string;
+    required?: boolean;
+    modelRef?: string;
+    component?: 'input' | 'listbox';
+};
+/** 子表定义 */
+export type ChildGridItem = {
+    id: string;
+    label: string;
+    actions?: Array<{
+        label: string;
+        actionName: string;
+    }>;
+    columns: ChildGridColumn[];
+    /** 操作方式覆盖；缺失时由 HTML 信号推断。 */
+    editMode?: ChildGridEditMode;
+};
+/** 页面物料 */
+export type PageItem = {
+    path: string;
+    role: string;
+    description: string;
+    pageId?: string;
+    title?: string;
+    directUrl?: string;
+    queryFields?: QueryField[];
+    formFields?: QueryField[] | string[];
+    buttons: ButtonAction[];
+    rowActions: RowAction[];
+    usedDataModels?: string[];
+    dataLoadingMethods?: DataLoadingMethod[];
+    childGrids?: ChildGridItem[] | string[];
+};
+/** 业务系统 */
+export type SystemItem = {
+    name: string;
+    description?: string;
+    defaultLoginUrl?: string;
+    version?: string;
+    frameVersion?: string;
+    targetEnd?: string;
+};
+/** 角色 */
+export type RoleItem = {
+    systemName?: string;
+    role: string;
+    loginMethod?: string;
+    permission?: string;
+    label?: string;
+    description?: string;
+    menuPath?: string;
+};
+/** 下拉数据模型 */
+export type DataModelItem = {
+    ref: string;
+    description: string;
+};
+/** 实体字段 */
+export type EntityField = {
+    name: string;
+    type: string;
+    description: string;
+    dataKey?: boolean;
+};
+/** 数据实体 */
+export type EntityItem = {
+    name: string;
+    table: string;
+    fields: EntityField[];
+};
+/** 业务规则 */
+export type BusinessRule = {
+    rule: string;
+    scope: string[];
+    assertion: string;
+};
+/** 业务角色事实 */
+export type BusinessRoleItem = {
+    label: string;
+    targetEnd?: string;
+    responsibilities?: string[];
+};
+/** 需求事实摘要 */
+export type RequirementItem = {
+    id?: string;
+    name?: string;
+    businessRoles?: BusinessRoleItem[];
+};
+/** 源码根目录配置（可选，用于解析 pages[].path 等物料路径） */
+export type SourceRootConfig = {
+    /** 源码根目录绝对路径 */
+    root?: string;
+    /** 路径别名标识 */
+    pathBase?: string;
+    /** 说明 pages[].path 相对哪个根目录解析 */
+    sourceFilesAreRelativeTo?: string;
+};
+/** extractCodeListJson5 的完整产出类型 */
+export type ExtractedCodeListJson5 = {
+    /** 文件绝对路径 */
+    path: string;
+    /** 所属需求目录（code_list.json5 所在的 _docs 目录） */
+    requirementDir: string;
+    /** 模块标识 */
+    module: string;
+    /** 模块中文名称 */
+    moduleName: string;
+    /** 模块描述 */
+    description?: string;
+    /** 需求事实摘要（可选） */
+    requirement?: RequirementItem;
+    /** 源码根目录配置（可选） */
+    sourceRoot?: SourceRootConfig;
+    /** 业务系统清单 */
+    systems: SystemItem[];
+    /** 角色清单 */
+    roles: RoleItem[];
+    /** 页面物料清单 */
+    pages: PageItem[];
+    /** 下拉数据模型（可选） */
+    dataModels?: DataModelItem[];
+    /** 数据实体（可选） */
+    entities?: EntityItem[];
+    /** 业务规则（可选） */
+    businessRules?: BusinessRule[];
+    /** 开发阶段测试访问配置（可选） */
+    testAccess?: TestAccessConfig;
+};
+/**
+ * 校验 filePath 是否为合法的 code_list.json5 路径。
+ * 拒绝非 .json5 后缀的文件（包括 .md）。
+ *
+ * @param filePath - 待校验的文件路径
+ * @throws Error 当文件后缀不是 .json5 时抛出中文错误
+ */
+export declare function assertCodeListJson5Path(filePath: string): void;
+/**
+ * 读取并解析 code_list.json5 文件，返回强类型产出。
+ * 校验必填字段 module / moduleName / systems / pages，缺失时抛出中文错误。
+ *
+ * @param filePath - code_list.json5 文件的绝对路径
+ * @returns 解析后的强类型数据
+ * @throws Error 路径非法 / 文件不存在 / 必填字段缺失
+ */
+export declare function extractCodeListJson5Object(raw: unknown): Omit<ExtractedCodeListJson5, 'path' | 'requirementDir'>;
+/**
+ * 读取并解析 code_list.json5 文件，返回强类型产出。
+ * 校验必填字段 module / moduleName / systems / pages，缺失时抛出中文错误。
+ *
+ * @param filePath - code_list.json5 文件的绝对路径
+ * @returns 解析后的强类型数据
+ * @throws Error 路径非法 / 文件不存在 / 必填字段缺失
+ */
+export declare function extractCodeListJson5(filePath: string): ExtractedCodeListJson5;
+//# sourceMappingURL=code-list-json5.d.ts.map

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

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

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

@@ -0,0 +1,91 @@
+/**
+ * code_list.json5 输入读取器
+ *
+ * 职责：
+ * 1. assertCodeListJson5Path — 路径硬校验，拒绝非 .json5 文件（含 .md）
+ * 2. extractCodeListJson5 — 读取并解析 JSON5 文件，校验必填字段，返回强类型产出
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import JSON5 from 'json5';
+import { normalizeTestAccessConfig, } from '../testcase/test-access.js';
+/* ──────── 路径硬校验 ──────── */
+/**
+ * 校验 filePath 是否为合法的 code_list.json5 路径。
+ * 拒绝非 .json5 后缀的文件（包括 .md）。
+ *
+ * @param filePath - 待校验的文件路径
+ * @throws Error 当文件后缀不是 .json5 时抛出中文错误
+ */
+export function assertCodeListJson5Path(filePath) {
+    if (!filePath.endsWith('.json5')) {
+        throw new Error('glue-generate-testcase 只接受 _docs/code_list.json5');
+    }
+}
+/* ──────── JSON5 读取与解析 ──────── */
+/**
+ * 读取并解析 code_list.json5 文件，返回强类型产出。
+ * 校验必填字段 module / moduleName / systems / pages，缺失时抛出中文错误。
+ *
+ * @param filePath - code_list.json5 文件的绝对路径
+ * @returns 解析后的强类型数据
+ * @throws Error 路径非法 / 文件不存在 / 必填字段缺失
+ */
+export function extractCodeListJson5Object(raw) {
+    if (!raw || typeof raw !== 'object') {
+        throw new Error('code_list.json5 顶层必须为对象');
+    }
+    const data = raw;
+    // 必填字段校验
+    if (!data.module) {
+        throw new Error('code_list.json5 缺少必填字段: module');
+    }
+    if (!data.moduleName) {
+        throw new Error('code_list.json5 缺少必填字段: moduleName');
+    }
+    if (!Array.isArray(data.systems)) {
+        throw new Error('code_list.json5 缺少必填字段: systems');
+    }
+    if (!Array.isArray(data.pages)) {
+        throw new Error('code_list.json5 缺少必填字段: pages');
+    }
+    return {
+        module: data.module,
+        moduleName: data.moduleName,
+        description: data.description,
+        requirement: data.requirement,
+        sourceRoot: data.sourceRoot,
+        systems: data.systems,
+        roles: (data.roles ?? []),
+        pages: data.pages,
+        dataModels: data.dataModels,
+        entities: data.entities,
+        businessRules: data.businessRules,
+        testAccess: data.testAccess === undefined
+            ? undefined
+            : normalizeTestAccessConfig(data.testAccess, 'code_list.json5.testAccess'),
+    };
+}
+/**
+ * 读取并解析 code_list.json5 文件，返回强类型产出。
+ * 校验必填字段 module / moduleName / systems / pages，缺失时抛出中文错误。
+ *
+ * @param filePath - code_list.json5 文件的绝对路径
+ * @returns 解析后的强类型数据
+ * @throws Error 路径非法 / 文件不存在 / 必填字段缺失
+ */
+export function extractCodeListJson5(filePath) {
+    assertCodeListJson5Path(filePath);
+    const absPath = path.resolve(filePath);
+    if (!existsSync(absPath)) {
+        throw new Error(`code_list.json5 文件不存在: ${absPath}`);
+    }
+    const raw = readFileSync(absPath, 'utf-8');
+    const parsed = JSON5.parse(raw);
+    const extracted = extractCodeListJson5Object(parsed);
+    return {
+        path: absPath,
+        requirementDir: path.dirname(absPath),
+        ...extracted,
+    };
+}

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/extractors/html-page.d.ts

@@ -23,6 +23,8 @@ export type ExtractedHtmlGridColumn = {
     field: string;
     headerText: string;
     columnType: string;
+    editorType?: string;
+    editorAction?: string;
 };
 export type ExtractedHtmlRowAction = {
     label: string;
@@ -36,6 +38,13 @@ export type ExtractedHtmlGrid = {
     selectionColumn?: ExtractedHtmlGridColumn;
     indexColumn?: ExtractedHtmlGridColumn;
     rowActions: ExtractedHtmlRowAction[];
+    /** MiniUI cell-edit 信号 */
+    allowCellEdit?: boolean;
+    cellEditAction?: string;
+    allowCellSelect?: boolean;
+    editNextOnEnterKey?: boolean;
+    oncellbeginedit?: boolean;
+    onrowdblclick?: boolean;
 };
 export type ExtractedPageStructureSignal = {
     staticPresent: boolean;

package/dist/src/extractors/html-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-page.d.ts","sourceRoot":"","sources":["../../../src/extractors/html-page.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,uBAAuB,EAAE,CAAC;IACnC,WAAW,EAAE,uBAAuB,EAAE,CAAC;IACvC,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,UAAU,EAAE,sBAAsB,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,EAAE,4BAA4B,CAAC;IACvC,eAAe,EAAE,4BAA4B,CAAC;IAC9C,KAAK,EAAE,4BAA4B,CAAC;IACpC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,oBAAoB,EAAE,6BAA6B,CAAC;CACrD,CAAC;AAgFF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CA0InE"}
+{"version":3,"file":"html-page.d.ts","sourceRoot":"","sources":["../../../src/extractors/html-page.ts"],"names":[],"mappings":"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"}

package/dist/src/extractors/html-page.js

@@ -38,6 +38,17 @@ function buildButtonLocator(label, tagName) {
     }
     return `xpath=//a[contains(@class,'mini-button')][normalize-space()='${label}'] | //button[contains(@class,'mini-button')][normalize-space()='${label}']`;
 }
+function parseEditorAttribute(editorAttribute) {
+    const normalized = normalizeAttribute(editorAttribute);
+    if (!normalized)
+        return {};
+    const typeMatch = normalized.match(/type\s*:\s*['"]([^'"]+)['"]/i);
+    const actionMatch = normalized.match(/action\s*:\s*['"]([^'"]+)['"]/i);
+    return {
+        type: typeMatch?.[1],
+        action: actionMatch?.[1],
+    };
+}
 function buildFieldLocator(label, controlType) {
     if (controlType === 'mini-textbox') {
         return `//div[@label='${label}']//input[@class='mini-textbox-input']`;
@@ -116,7 +127,14 @@ export function extractHtmlPage(filePath) {
             const field = column.attr('field') ?? '';
             const columnType = column.attr('type') ?? (field ? 'data' : 'unknown');
             const headerText = normalizeText(column.clone().children().remove().end().text());
-            const extractedColumn = { field, headerText, columnType };
+            const editor = parseEditorAttribute(column.attr('editor'));
+            const extractedColumn = {
+                field,
+                headerText,
+                columnType,
+                editorType: editor.type,
+                editorAction: editor.action,
+            };
             if (columnType === 'checkcolumn') {
                 selectionColumn = extractedColumn;
                 return;
@@ -149,7 +167,13 @@ export function extractHtmlPage(filePath) {
             dataColumns,
             selectionColumn,
             indexColumn,
-            rowActions
+            rowActions,
+            allowCellEdit: booleanAttribute(grid.attr('allowCellEdit')) || undefined,
+            cellEditAction: normalizeAttribute(grid.attr('cellEditAction')) || undefined,
+            allowCellSelect: booleanAttribute(grid.attr('allowCellSelect')) || undefined,
+            editNextOnEnterKey: booleanAttribute(grid.attr('editNextOnEnterKey')) || undefined,
+            oncellbeginedit: normalizeAttribute(grid.attr('oncellbeginedit')) ? true : undefined,
+            onrowdblclick: normalizeAttribute(grid.attr('onrowdblclick')) ? true : undefined,
         });
     });
     const scriptContent = $('script')

package/dist/src/extractors/prd-extractor.d.ts

@@ -0,0 +1,70 @@
+/**
+ * PRD markdown 解析器。
+ *
+ * 职责：
+ * 1. 在需求目录中发现 PRD markdown 文件。
+ * 2. 解析 PRD 章节 4.1（功能列表）和 4.2.x（功能详细说明）。
+ * 3. 输出结构化的 PrdFunctionEntry[]，供 testcase 装配阶段确定性使用。
+ *
+ * 设计取舍：
+ * - 全程使用正则/行解析，不调用 LLM，保证幂等性。
+ * - 只识别当前观察到的 PRD 结构（`4.1` 表格 + `4.2.x` 子章节 + 粗体字段标题）。
+ * - 解析失败时返回空数组并在 inferenceTrace 中记录，不阻断 pipeline。
+ */
+/** PRD 中的单个功能条目。 */
+export type PrdFunctionEntry = {
+    /** 功能编号，如 F001。 */
+    featureId: string;
+    /** 功能名称，如「同步窗口管理系统」。 */
+    featureName: string;
+    /** 功能模块，如「大厅地址管理」。 */
+    featureModule?: string;
+    /** 功能描述。 */
+    description: string;
+    /** 输入条件。 */
+    inputConditions?: string;
+    /** 处理逻辑，保留列表顺序。 */
+    processingLogic: string[];
+    /** 输出结果，保留列表顺序。 */
+    outputResult: string[];
+    /** 业务规则，保留列表顺序。 */
+    businessRules: string[];
+    /** 约束条件，保留列表顺序。 */
+    constraints: string[];
+};
+/** PRD 提取产物。 */
+export type PrdExtraction = {
+    /** PRD 文件绝对路径。 */
+    prdPath: string;
+    /** 解析出的功能条目，按 PRD 顺序排列。 */
+    functions: PrdFunctionEntry[];
+    /** 解析时间 ISO 字符串，仅用于审计，不影响 testcase 生成。 */
+    generatedAt: string;
+};
+/**
+ * 在目录中查找 PRD markdown 文件。
+ *
+ * 规则（满足任一即返回）：
+ * 1. 文件名包含 `prd`（大小写不敏感）且以 `.md` 结尾。
+ * 2. 文件正文包含 `## 4. 功能需求` 标题。
+ *
+ * @param dir - 需求文档目录。
+ * @returns PRD 文件绝对路径；不存在时返回 undefined。
+ */
+export declare function findPrdMarkdown(dir: string): string | undefined;
+/**
+ * 读取 PRD 文件并提取功能条目。
+ *
+ * @param prdPath - PRD markdown 文件绝对路径。
+ * @param now - 可选的解析时间戳，用于测试冻结。
+ * @returns PRD 提取产物。
+ */
+export declare function loadPrdExtraction(prdPath: string, now?: string): PrdExtraction;
+/**
+ * 解析 PRD markdown 文本，提取功能列表 + 功能详细说明。
+ *
+ * @param markdown - PRD 完整 markdown 文本。
+ * @returns 按 PRD 顺序排列的功能条目数组。
+ */
+export declare function extractPrdFunctions(markdown: string): PrdFunctionEntry[];
+//# sourceMappingURL=prd-extractor.d.ts.map

package/dist/src/extractors/prd-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prd-extractor.d.ts","sourceRoot":"","sources":["../../../src/extractors/prd-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,oBAAoB;AACpB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,mBAAmB;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,mBAAmB;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mBAAmB;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,aAAa,GAAG;IAC1B,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAsB/D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAA2B,GAAG,aAAa,CAIhG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAqBxE"}