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

package/dist/src/inference/source-analysis.js

@@ -0,0 +1,258 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+/**
+ * 判断 docsDir 下是否存在 PRD markdown 文件。
+ *
+ * PRD 判定规则（满足任一）：
+ * - 文件名包含 `prd`（大小写不敏感）。
+ * - 文件正文包含 `## 4. 功能需求` 标题。
+ *
+ * @param docsDir - 需求文档目录。
+ * @returns PRD 文件绝对路径；不存在时返回 undefined。
+ */
+function findPrdMarkdown(docsDir) {
+    if (!existsSync(docsDir)) {
+        return undefined;
+    }
+    const candidates = readdirSync(docsDir).filter((file) => file.endsWith('.md'));
+    for (const file of candidates) {
+        const fullPath = path.join(docsDir, file);
+        if (/prd/i.test(file)) {
+            return fullPath;
+        }
+    }
+    // 文件名不含 prd 时回落到正文匹配。
+    for (const file of candidates) {
+        const fullPath = path.join(docsDir, file);
+        const content = readFileSync(fullPath, 'utf8');
+        if (/##\s*4\.\s*功能需求/.test(content)) {
+            return fullPath;
+        }
+    }
+    return undefined;
+}
+/**
+ * 判断 docsDir 或 code_list 物料引用中是否存在 spec.yaml。
+ *
+ * @param codeList - code_list 摘要。
+ * @param docsDir - 需求文档目录。
+ * @returns spec.yaml 绝对路径；不存在时返回 undefined。
+ */
+function findSpecYaml(codeList, docsDir) {
+    const fromRefs = codeList.materialRefs.find((ref) => ref.kind === 'spec' && ref.exists);
+    if (fromRefs) {
+        return fromRefs.path;
+    }
+    if (existsSync(docsDir)) {
+        const direct = readdirSync(docsDir).find((file) => file.endsWith('spec.yaml'));
+        if (direct) {
+            return path.join(docsDir, direct);
+        }
+    }
+    return undefined;
+}
+/**
+ * 把 HTML 页面字段登记为 UI 信号。
+ *
+ * @param pages - 已抽取的 HTML 页面列表。
+ * @returns UI 信号数组（字段、按钮、表格列、弹窗）。
+ */
+function collectUiSignals(pages) {
+    const signals = [];
+    for (const page of pages) {
+        for (const field of page.fields) {
+            signals.push({
+                pageId: page.pageId,
+                kind: 'field',
+                label: field.label,
+                value: field.name
+            });
+        }
+        for (const button of page.buttons) {
+            signals.push({
+                pageId: page.pageId,
+                kind: 'button',
+                label: button.label
+            });
+        }
+        for (const grid of page.grids) {
+            for (const column of grid.dataColumns) {
+                signals.push({
+                    pageId: page.pageId,
+                    kind: 'gridColumn',
+                    label: column.headerText || column.field,
+                    value: column.field
+                });
+            }
+        }
+        for (const dialog of page.dialogs) {
+            signals.push({
+                pageId: page.pageId,
+                kind: 'dialog',
+                label: dialog.title,
+                value: dialog.pagePath
+            });
+        }
+    }
+    return signals;
+}
+/**
+ * 把 Java Action 登记为后端信号。
+ *
+ * @param actions - 已抽取的 Java Action 列表。
+ * @returns 后端信号数组（方法名、callback 消息）。
+ */
+function collectBackendSignals(actions) {
+    const signals = [];
+    for (const action of actions) {
+        for (const method of action.methods) {
+            signals.push({
+                controllerName: action.controllerName,
+                kind: 'method',
+                value: method
+            });
+        }
+        for (const message of action.messages) {
+            signals.push({
+                controllerName: action.controllerName,
+                kind: 'callbackMessage',
+                value: message
+            });
+        }
+    }
+    return signals;
+}
+/**
+ * 跨页面汇总字段名候选（去重）。
+ *
+ * @param pages - 已抽取的 HTML 页面列表。
+ * @returns 去重后的字段名数组。
+ */
+function collectFieldNames(pages) {
+    const names = new Set();
+    for (const page of pages) {
+        for (const field of page.fields) {
+            if (field.name) {
+                names.add(field.name);
+            }
+        }
+        for (const grid of page.grids) {
+            for (const column of grid.dataColumns) {
+                if (column.field) {
+                    names.add(column.field);
+                }
+            }
+        }
+    }
+    return Array.from(names);
+}
+/**
+ * 从 Java callback 消息中提取业务规则线索。
+ *
+ * @param actions - 已抽取的 Java Action 列表。
+ * @returns 业务规则描述数组。
+ */
+function collectBusinessRules(actions) {
+    const rules = [];
+    for (const action of actions) {
+        for (const message of action.messages) {
+            if (/不可删除|不允许删除|禁止删除/.test(message)) {
+                rules.push(`删除受业务规则限制：${message}`);
+            }
+        }
+    }
+    return Array.from(new Set(rules));
+}
+/**
+ * 构建 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 function buildSourceAnalysis(input) {
+    const sources = [];
+    const unresolved = [];
+    const prdPath = findPrdMarkdown(input.docsDir);
+    if (prdPath) {
+        sources.push({
+            kind: 'prd_markdown',
+            path: prdPath,
+            provides: ['businessRules', 'featureList', 'fieldDescriptions']
+        });
+    }
+    else {
+        unresolved.push('docsDir 下未找到 PRD markdown');
+    }
+    const specYamlPath = findSpecYaml(input.codeList, input.docsDir);
+    if (specYamlPath) {
+        sources.push({
+            kind: 'spec_yaml',
+            path: specYamlPath,
+            provides: ['contractSlots', 'fieldContracts', 'flowContracts']
+        });
+    }
+    for (const page of input.pages) {
+        sources.push({
+            kind: 'html',
+            path: page.path,
+            provides: ['searchFields', 'gridColumns', 'buttons', 'dialogs']
+        });
+    }
+    for (const action of input.actions) {
+        sources.push({
+            kind: 'java_action',
+            path: action.path,
+            provides: ['backendMethods', 'callbackMessages', 'deletePolicyEvidence']
+        });
+    }
+    const uiSignals = collectUiSignals(input.pages);
+    const backendSignals = collectBackendSignals(input.actions);
+    const fields = collectFieldNames(input.pages);
+    const businessRules = collectBusinessRules(input.actions);
+    const hasPrd = Boolean(prdPath);
+    const hasHtml = input.pages.length > 0;
+    const hasJava = input.actions.length > 0;
+    const hasSpec = Boolean(specYamlPath);
+    let mode;
+    if (hasSpec) {
+        mode = 'extracted';
+    }
+    else if (hasPrd && hasHtml && hasJava) {
+        mode = 'prd+html+java';
+    }
+    else if (hasHtml || hasJava) {
+        mode = 'inferred';
+    }
+    else {
+        mode = 'mixed';
+    }
+    let confidence;
+    if (hasSpec) {
+        confidence = 'high';
+    }
+    else if (hasPrd && hasHtml && hasJava) {
+        confidence = 'medium';
+    }
+    else if (hasHtml || hasJava) {
+        confidence = 'medium';
+    }
+    else {
+        confidence = 'low';
+    }
+    return {
+        mode,
+        confidence,
+        sources,
+        fields,
+        businessRules,
+        uiSignals,
+        backendSignals,
+        unresolved
+    };
+}

package/dist/src/testcase/testcase-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testcase-generator.d.ts","sourceRoot":"","sources":["../../../src/testcase/testcase-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EAEb,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAOvF;;;;;;;;;GASG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,kBAAkB,CAAC,EAAE,YAAY,EAAE,CAAC;IACpC,YAAY,EAAE,iBAAiB,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,2BAA2B,CA2GpG"}
+{"version":3,"file":"testcase-generator.d.ts","sourceRoot":"","sources":["../../../src/testcase/testcase-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EAEb,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAOvF;;;;;;;;;GASG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,kBAAkB,CAAC,EAAE,YAAY,EAAE,CAAC;IACpC,YAAY,EAAE,iBAAiB,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;GAUG;AAKH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,2BAA2B,CA2GpG"}

package/dist/src/testcase/testcase-generator.js

@@ -11,6 +11,10 @@ import { mapContractToCrudTestcaseSlots, renderGlueTestcaseSkeleton, selectTestc
  * @param input - 用例生成入参。
  * @returns 用例 JSON + Markdown。
  */
+// TODO(Task 3.1 convergence)：本函数当前产 v1 形态 testcase 文档（仍被 run-gap-pipeline.ts 使用）。
+// Task 1.6 的新 testcase 子命令改走 src/cli/probe.ts.assembleTestcaseV2 产 v2 形态。两条产线
+// 必然在 Task 3.1（升级 testcase-schema.md 到 v2）合并：届时本函数签名升级为 v2，删除
+// assembleTestcaseV2。在那之前任何对本函数的修改务必同步检视 probe.assembleTestcaseV2。
 export function generateGlueTestcases(input) {
     if (!input.contract || !input.menu) {
         throw new Error('生成胶水测试用例必须提供 contract 和 menu，不能再由 moduleId/moduleName 自由拼装');

package/dist/src/testcase/testcase-v2.d.ts

@@ -0,0 +1,50 @@
+/** testcase.json5 v2 顶层结构（REQ-DATA-02）。字段名永远英文（机器格式）。 */
+export type TestcaseV2 = {
+    schemaVersion: 'v2';
+    scenario: string;
+    moduleId: string;
+    moduleName: string;
+    menuPath: string;
+    requiredSystems: Array<{
+        url: string;
+        systemName?: string;
+    }>;
+    requiredRoles: Array<{
+        role: string;
+        hint?: string;
+    }>;
+    coveredActions: Array<{
+        actionId: string;
+        kind: string;
+        evidence: string[];
+    }>;
+    uncoveredCandidates: Array<{
+        actionId: string;
+        label: string;
+        status: 'planned' | 'candidate' | 'unresolved' | 'resolved';
+        requiredRole: string;
+        businessIntent: string;
+        assertionExpectation: string;
+        evidence: string[];
+    }>;
+    cases: Array<{
+        caseId: string;
+        title: string;
+        scenario: string;
+        reviewStatus: 'confirmed' | 'needs_review' | 'blocked';
+        requiredRole: string;
+        evidence: string[];
+        steps: string[];
+        assertions: string[];
+        unresolved: string[];
+    }>;
+    reasoningSummary: {
+        conclusion: string;
+        evidenceChain: string[];
+        alternatives: string[];
+        confidence: 'high' | 'medium' | 'low';
+        risks: string[];
+        needsHumanReview: boolean;
+    };
+};
+//# sourceMappingURL=testcase-v2.d.ts.map

package/dist/src/testcase/testcase-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testcase-v2.d.ts","sourceRoot":"","sources":["../../../src/testcase/testcase-v2.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG;IACvB,aAAa,EAAE,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,cAAc,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC9E,mBAAmB,EAAE,KAAK,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,CAAC;QAC5D,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC,CAAC;IACH,KAAK,EAAE,KAAK,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,WAAW,GAAG,cAAc,GAAG,SAAS,CAAC;QACvD,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC,CAAC;IACH,gBAAgB,EAAE;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;QACtC,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,gBAAgB,EAAE,OAAO,CAAC;KAC3B,CAAC;CACH,CAAC"}

package/dist/src/testcase/testcase-v2.js

@@ -0,0 +1 @@
+export {};

package/dist/src/util/credentials.d.ts

@@ -0,0 +1,12 @@
+import { type Credential } from '../validation/credentials.js';
+/**
+ * 从需求目录读取 credentials.json5 数组形态凭据（REQ-ENV-02 / REQ-ENV-03）。
+ *
+ * 供 run 子命令按 cases[].requiredRole 匹配登录凭据。
+ *
+ * @param credentialsPath - <需求名>/credentials.json5 绝对路径。
+ * @returns 校验后的凭据数组。
+ * @throws 文件不存在或 schema 校验失败时抛结构化错误。
+ */
+export declare function loadCredentials(credentialsPath: string): Credential[];
+//# sourceMappingURL=credentials.d.ts.map

package/dist/src/util/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../../src/util/credentials.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAEpF;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG,UAAU,EAAE,CAQrE"}

package/dist/src/util/credentials.js

@@ -0,0 +1,19 @@
+import { readFileSync, existsSync } from 'node:fs';
+import JSON5 from 'json5';
+import { validateCredentials } from '../validation/credentials.js';
+/**
+ * 从需求目录读取 credentials.json5 数组形态凭据（REQ-ENV-02 / REQ-ENV-03）。
+ *
+ * 供 run 子命令按 cases[].requiredRole 匹配登录凭据。
+ *
+ * @param credentialsPath - <需求名>/credentials.json5 绝对路径。
+ * @returns 校验后的凭据数组。
+ * @throws 文件不存在或 schema 校验失败时抛结构化错误。
+ */
+export function loadCredentials(credentialsPath) {
+    if (!existsSync(credentialsPath)) {
+        throw new Error(`credentials.json5 不存在: ${credentialsPath}（请先填好凭据，或重跑 glue-generate-testcase 交互输入）`);
+    }
+    const raw = JSON5.parse(readFileSync(credentialsPath, 'utf8'));
+    return validateCredentials(raw);
+}

package/dist/src/util/i18n-testcase.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 把 testcase.json5 中的英文字段名 / 状态值翻译成中文 testcase.md 显示文案。
+ *
+ * @param value - testcase.json5 中的英文 token（字段名 / 状态值 / 推荐动作 / 场景值）。
+ * @returns 对应中文文案；未在映射表中的 token 原样返回（兜底）。
+ */
+export declare function i18nTestcase(value: string): string;
+//# sourceMappingURL=i18n-testcase.d.ts.map

package/dist/src/util/i18n-testcase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-testcase.d.ts","sourceRoot":"","sources":["../../../src/util/i18n-testcase.ts"],"names":[],"mappings":"AA+CA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/src/util/i18n-testcase.js

@@ -0,0 +1,55 @@
+/**
+ * REQ-UX-03：testcase.json5 字段名 / 状态值 → testcase.md 中文显示文案。
+ *
+ * 设计原则（spec §4.6 约束）：
+ * - testcase.json5 内部字段名 / 状态值永远英文（TypeScript types 一致 + AI Agent 解析稳定）。
+ * - testcase.md 是人类视图，CLI 写 .md 时调用本 util 把英文 token 翻译成中文。
+ * - 纯查表函数，无副作用，无 I/O；未知 token 原样返回（兜底保证可显示）。
+ *
+ * 已知 trade-off：spec §4.6 中 `unresolved` 同时是字段名（未确认项）和状态值（未解决）。
+ * 扁平 lookup 表无法同时持有两个映射 —— 当前实现保留「状态值 = 未解决」（后定义覆盖前者）。
+ * 字段名场景下 CLI 可在调用前对 key 做硬编码标签替换（如 `'unresolved'` 字段标题写死「未确认项」）。
+ */
+const I18N_MAP = {
+    // 字段名
+    caseId: '用例 ID',
+    actionId: '动作 ID',
+    scenario: '场景类型',
+    menuPath: '菜单路径',
+    requiredRole: '操作角色',
+    requiredSystems: '需求系统集',
+    requiredRoles: '需求角色集',
+    coveredActions: '骨架已命中动作',
+    uncoveredCandidates: '骨架未命中候选',
+    businessIntent: '业务意图',
+    assertionExpectation: '预期断言',
+    recommendedAction: '推荐动作',
+    reviewStatus: '审阅状态',
+    evidence: '证据',
+    // 状态值
+    confirmed: '已确认',
+    needs_review: '待审阅',
+    blocked: '已阻断',
+    planned: '已计划',
+    candidate: '候选',
+    unresolved: '未解决',
+    resolved: '已解决',
+    // 推荐动作
+    infer: '推理',
+    'supplement-hints': '补充 hints',
+    skip: '跳过',
+    // 场景值
+    'crud.single-page': '单页 CRUD',
+    'crud.nested': '嵌套 CRUD',
+    statistic: '统计视图',
+    approval: '审批流',
+};
+/**
+ * 把 testcase.json5 中的英文字段名 / 状态值翻译成中文 testcase.md 显示文案。
+ *
+ * @param value - testcase.json5 中的英文 token（字段名 / 状态值 / 推荐动作 / 场景值）。
+ * @returns 对应中文文案；未在映射表中的 token 原样返回（兜底）。
+ */
+export function i18nTestcase(value) {
+    return I18N_MAP[value] ?? value;
+}

package/dist/src/util/softlink.d.ts

@@ -0,0 +1,33 @@
+import { symlinkSync, linkSync, copyFileSync, existsSync, lstatSync, unlinkSync } from 'node:fs';
+/**
+ * 软链 fallback 返回结果。
+ * - strategy: 实际采用的链接策略；
+ * - warned: 仅在 copy fallback 时为 true，提示「上游更新不会自动同步到链接落点」。
+ */
+export type SoftlinkResult = {
+    strategy: 'symlink' | 'hardlink' | 'copy';
+    warned?: boolean;
+};
+/**
+ * 内部 fs 操作集合。抽象为对象是为了在测试中可替换具体实现，
+ * 绕开 ESM namespace 不可写带来的 vi.spyOn 限制（REQ-FILE-02 测试需要模拟 EPERM）。
+ * 生产代码不应替换此对象。
+ */
+export declare const softlinkFs: {
+    symlinkSync: typeof symlinkSync;
+    linkSync: typeof linkSync;
+    copyFileSync: typeof copyFileSync;
+    existsSync: typeof existsSync;
+    lstatSync: typeof lstatSync;
+    unlinkSync: typeof unlinkSync;
+};
+/**
+ * 跨平台创建「指向 target 的 link」，三档 fallback（REQ-FILE-02）：
+ * symlink（macOS/Linux）→ hardlink → copy + 时间戳警示（Windows 无管理员权限）。
+ *
+ * @param target - 被链接的源文件绝对路径（上游 code_list.md）。
+ * @param linkPath - 链接落点（需求目录下的 code_list.md）。
+ * @returns 实际采用的策略；copy 时 warned=true。
+ */
+export declare function createSoftlinkWithFallback(target: string, linkPath: string): SoftlinkResult;
+//# sourceMappingURL=softlink.d.ts.map

package/dist/src/util/softlink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"softlink.d.ts","sourceRoot":"","sources":["../../../src/util/softlink.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjG;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;;;;;CAOtB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAiB3F"}

package/dist/src/util/softlink.js

@@ -0,0 +1,43 @@
+import { symlinkSync, linkSync, copyFileSync, existsSync, lstatSync, unlinkSync } from 'node:fs';
+/**
+ * 内部 fs 操作集合。抽象为对象是为了在测试中可替换具体实现，
+ * 绕开 ESM namespace 不可写带来的 vi.spyOn 限制（REQ-FILE-02 测试需要模拟 EPERM）。
+ * 生产代码不应替换此对象。
+ */
+export const softlinkFs = {
+    symlinkSync,
+    linkSync,
+    copyFileSync,
+    existsSync,
+    lstatSync,
+    unlinkSync,
+};
+/**
+ * 跨平台创建「指向 target 的 link」，三档 fallback（REQ-FILE-02）：
+ * symlink（macOS/Linux）→ hardlink → copy + 时间戳警示（Windows 无管理员权限）。
+ *
+ * @param target - 被链接的源文件绝对路径（上游 code_list.md）。
+ * @param linkPath - 链接落点（需求目录下的 code_list.md）。
+ * @returns 实际采用的策略；copy 时 warned=true。
+ */
+export function createSoftlinkWithFallback(target, linkPath) {
+    if (softlinkFs.existsSync(linkPath)) {
+        const st = softlinkFs.lstatSync(linkPath);
+        if (st.isSymbolicLink() || st.isFile())
+            softlinkFs.unlinkSync(linkPath);
+    }
+    try {
+        softlinkFs.symlinkSync(target, linkPath, 'file');
+        return { strategy: 'symlink' };
+    }
+    catch {
+        try {
+            softlinkFs.linkSync(target, linkPath);
+            return { strategy: 'hardlink' };
+        }
+        catch {
+            softlinkFs.copyFileSync(target, linkPath);
+            return { strategy: 'copy', warned: true };
+        }
+    }
+}

package/dist/src/validation/credentials.d.ts

@@ -0,0 +1,19 @@
+/** credentials.json5 单条凭据（REQ-ENV-03）。 */
+export type Credential = {
+    url: string;
+    username: string;
+    password: string;
+    role?: string;
+    systemName?: string;
+};
+/**
+ * 校验 credentials.json5 数组形态（REQ-ENV-02 / REQ-ENV-03）。
+ *
+ * 不变量：数组至少 1 条；必填 url/username/password 非空；同 (url, role) 组合唯一。
+ *
+ * @param obj - 从 JSON5 解析出来的原始对象。
+ * @returns 归一化后的凭据数组。
+ * @throws 违反不变量时抛结构化错误。
+ */
+export declare function validateCredentials(obj: unknown): Credential[];
+//# sourceMappingURL=credentials.d.ts.map

package/dist/src/validation/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../../src/validation/credentials.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,EAAE,CAyB9D"}

package/dist/src/validation/credentials.js

@@ -0,0 +1,38 @@
+/**
+ * 校验 credentials.json5 数组形态（REQ-ENV-02 / REQ-ENV-03）。
+ *
+ * 不变量：数组至少 1 条；必填 url/username/password 非空；同 (url, role) 组合唯一。
+ *
+ * @param obj - 从 JSON5 解析出来的原始对象。
+ * @returns 归一化后的凭据数组。
+ * @throws 违反不变量时抛结构化错误。
+ */
+export function validateCredentials(obj) {
+    if (!Array.isArray(obj))
+        throw new Error('credentials.json5 顶层必须是数组');
+    if (obj.length === 0)
+        throw new Error('credentials.json5 至少需要 1 条凭据');
+    const seen = new Set();
+    const result = [];
+    for (let i = 0; i < obj.length; i++) {
+        const e = obj[i];
+        for (const f of ['url', 'username', 'password']) {
+            if (typeof e[f] !== 'string' || !e[f].trim()) {
+                throw new Error(`credentials.json5 第 ${i + 1} 条缺必填字段 ${f}`);
+            }
+        }
+        const role = typeof e.role === 'string' ? e.role : '';
+        const key = `${e.url}|${role}`;
+        if (seen.has(key))
+            throw new Error(`credentials.json5 同 (url, role) 重复: ${key}`);
+        seen.add(key);
+        result.push({
+            url: e.url,
+            username: e.username,
+            password: e.password,
+            ...(role ? { role } : {}),
+            ...(typeof e.systemName === 'string' ? { systemName: e.systemName } : {}),
+        });
+    }
+    return result;
+}

package/dist/src/validation/index.d.ts

@@ -0,0 +1,6 @@
+export { validateProjectsIndex } from './projects-index.js';
+export { validateTestcase } from './testcase.js';
+export { validateCredentials } from './credentials.js';
+export { validateInferenceTrace } from './inference-trace.js';
+export type { Credential } from './credentials.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/src/validation/index.js

@@ -0,0 +1,4 @@
+export { validateProjectsIndex } from './projects-index.js';
+export { validateTestcase } from './testcase.js';
+export { validateCredentials } from './credentials.js';
+export { validateInferenceTrace } from './inference-trace.js';

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

@@ -0,0 +1,13 @@
+import type { InferenceTraceV1 } from '../contracts/inference-trace.js';
+/**
+ * 校验 inference-trace.json 的顶层结构（REQ-INFER-006）。
+ *
+ * 最小校验：只保证 schemaVersion 正确且 5 个必需顶层章节存在。
+ * 章节内部证据数组 / reason 允许扩展（spec §8），不做深校验。
+ *
+ * @param obj - 从 JSON.parse 得到的任意值。
+ * @returns 类型收窄后的 InferenceTraceV1。
+ * @throws 顶层非对象、schemaVersion 不符或缺章节时抛错。
+ */
+export declare function validateInferenceTrace(obj: unknown): InferenceTraceV1;
+//# sourceMappingURL=inference-trace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inference-trace.d.ts","sourceRoot":"","sources":["../../../src/validation/inference-trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAExE;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAoBrE"}

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

@@ -0,0 +1,31 @@
+/**
+ * 校验 inference-trace.json 的顶层结构（REQ-INFER-006）。
+ *
+ * 最小校验：只保证 schemaVersion 正确且 5 个必需顶层章节存在。
+ * 章节内部证据数组 / reason 允许扩展（spec §8），不做深校验。
+ *
+ * @param obj - 从 JSON.parse 得到的任意值。
+ * @returns 类型收窄后的 InferenceTraceV1。
+ * @throws 顶层非对象、schemaVersion 不符或缺章节时抛错。
+ */
+export function validateInferenceTrace(obj) {
+    const raw = obj;
+    if (!raw || typeof raw !== 'object') {
+        throw new Error('inference-trace.json 顶层必须是对象');
+    }
+    if (raw.schemaVersion !== 'inference-trace/v1') {
+        throw new Error('inference-trace.json schemaVersion 必须是 inference-trace/v1');
+    }
+    for (const key of [
+        'materialInventory',
+        'sourceAnalysis',
+        'moduleHintsInference',
+        'coverageDiff',
+        'reasoningSummary',
+    ]) {
+        if (!raw[key]) {
+            throw new Error(`inference-trace.json 缺 ${key}`);
+        }
+    }
+    return raw;
+}

package/dist/src/validation/projects-index.d.ts

@@ -0,0 +1,13 @@
+import type { ProjectsIndex } from '../context/stage-context.js';
+/**
+ * 校验 ~/.ep-stage/projects.index.json5 的顶层结构（REQ-DATA-01 修订）。
+ *
+ * 必含 projects[] 与 systems[]；projects[] 条目必含 stageCreateVersion；
+ * 拒绝 stage-context.md 砍掉后遗留的 stageContextPath/envPath/knowledgeRoot/codeListPaths 字段。
+ *
+ * @param obj - 从 JSON5 解析出来的原始对象。
+ * @returns 归一化后的 ProjectsIndex。
+ * @throws 缺字段或含已废弃字段时抛结构化错误。
+ */
+export declare function validateProjectsIndex(obj: unknown): ProjectsIndex;
+//# sourceMappingURL=projects-index.d.ts.map