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

package/dist/src/context/stage-context.js

@@ -6,6 +6,9 @@ import YAML from 'yaml';
 /**
  * 读取项目级 stage-context.md，并将相对路径归一到项目目录。
  *
+ * @deprecated stage-context.md 已砍（REQ-ENV-01 修订）；新链路应从 projects.index.json5 反查
+ *             ({@link lookupProjectByRequirement})。本函数保留仅为零回归兼容，
+ *             不要在新代码里调用。
  * @param stageContextPath - stage-context.md 文件路径。
  * @returns 归一化后的项目上下文。
  * @throws 当 frontmatter 缺少必要字段或格式不合法时抛出错误。
@@ -31,20 +34,55 @@ export function readStageContext(stageContextPath) {
     };
 }
 /**
- * 写入用户级 ep-stage 项目索引。
+ * 写入用户级 ep-stage 项目索引（REQ-DATA-01 修订 / spec §4.1）。
  *
- * @param input - HOME 目录和项目列表。
+ * 新 schema：顶层 `{ projects: [...], systems: [...] }`，无 `version` 字段；
+ * projects[] 条目不再写入 envPath/knowledgeRoot/codeListPaths/stageContextPath 等 legacy 字段。
+ *
+ * @param input - HOME 目录、项目列表，以及可选的 systems[]（不传按空数组写入）。
  * @returns 写入后的索引文件路径。
  */
 export function writeProjectIndex(input) {
     const indexPath = getProjectIndexPath(input.homeDir);
     mkdirSync(path.dirname(indexPath), { recursive: true });
-    writeFileSync(indexPath, `${JSON5.stringify({ version: 1, projects: input.projects }, null, 2)}\n`, 'utf8');
+    writeFileSync(indexPath, `${JSON5.stringify({ projects: input.projects, systems: input.systems ?? [] }, null, 2)}\n`, 'utf8');
     return indexPath;
 }
+/**
+ * 从 `~/.ep-stage/projects.index.json5` 反查匹配的 ProjectIndexEntry（REQ-DATA-01 修订 / spec §5.2 §5.3）。
+ *
+ * 匹配优先级：①精确 requirementDir / testsDir 命中；②精确 projectDir 命中。
+ * 用于 glue-generate-testcase / glue-run-test skill 的「反查项目脚手架」步骤——
+ * 给定一个需求目录或项目目录，回到对应的 ProjectIndexEntry（不再依赖砍掉的 stage-context.md）。
+ *
+ * @param input - 需求路径或项目目录 + 可选 homeDir。
+ * @returns 匹配的 ProjectIndexEntry，未匹配返回 null。
+ */
+export function lookupProjectByRequirement(input) {
+    const indexPath = getProjectIndexPath(input.homeDir);
+    if (!existsSync(indexPath))
+        return null;
+    const parsed = JSON5.parse(readFileSync(indexPath, 'utf8'));
+    const target = path.resolve(input.requirementPath);
+    for (const project of parsed.projects ?? []) {
+        for (const requirement of project.requirements ?? []) {
+            if (path.resolve(requirement.requirementDir) === target ||
+                path.resolve(requirement.testsDir) === target) {
+                return project;
+            }
+        }
+        if (path.resolve(project.projectDir) === target) {
+            return project;
+        }
+    }
+    return null;
+}
 /**
  * 按固定优先级解析 ep-stage 项目上下文，并返回可审阅 trace。
  *
+ * @deprecated 旧链路依赖 stage-context.md 与 codeListPaths 匹配，stage-context.md 已砍
+ *             （REQ-ENV-01 修订）。保留实现仅为零回归兼容；新代码请使用
+ *             {@link lookupProjectByRequirement}。
  * @param input - 显式路径、当前目录、code_list 路径和可选 HOME。
  * @returns 解析出的项目上下文与 context-resolution trace。
  * @throws 当无法定位任何上下文来源时抛出错误。
@@ -75,8 +113,8 @@ export function resolveStageContext(input) {
         };
     }
     const indexPath = getProjectIndexPath(input.homeDir);
-    const index = readProjectIndex(indexPath);
-    const matched = index.projects.find((entry) => matchesProjectIndexEntry(entry, {
+    const indexEntries = readProjectIndexRaw(indexPath);
+    const matched = indexEntries.find((entry) => matchesProjectIndexEntry(entry, {
         projectDir: input.projectDir,
         cwd: input.cwd,
         codeListPath: input.codeListPath,
@@ -95,8 +133,9 @@ export function resolveStageContext(input) {
         }
         throw new Error(`stage context not found from ${startDir} or ${indexPath}`);
     }
-    const context = matched.stageContextPath
-        ? readStageContext(resolvePath(path.resolve(matched.projectDir), matched.stageContextPath))
+    const matchedLegacy = matched;
+    const context = matchedLegacy.stageContextPath
+        ? readStageContext(resolvePath(path.resolve(matched.projectDir), matchedLegacy.stageContextPath))
         : normalizeProjectIndexEntry(matched);
     return {
         context,
@@ -140,22 +179,29 @@ function parseStageContextFrontmatter(markdown) {
     return YAML.parse(match[1] ?? '');
 }
 /**
- * 读取用户级 JSON5 项目索引。
+ * 读取用户级 JSON5 项目索引的原始 projects[]（含可能残留的 legacy 字段）。
+ *
+ * 新代码请使用 {@link lookupProjectByRequirement}，本函数仅服务于
+ * {@link resolveStageContext} 的零回归兼容。
  *
  * @param indexPath - 索引文件路径。
- * @returns 项目索引对象。
+ * @returns 原始 projects[] 数组，缺失返回空数组。
  */
-function readProjectIndex(indexPath) {
+function readProjectIndexRaw(indexPath) {
     if (!existsSync(indexPath)) {
-        return { projects: [] };
+        return [];
     }
     const parsed = JSON5.parse(readFileSync(indexPath, 'utf8'));
-    return { projects: parsed.projects ?? [] };
+    return (parsed.projects ?? []);
 }
 /**
- * 将用户索引条目归一为 StageContext。
+ * 将用户索引条目归一为 StageContext（含旧 legacy 字段 graceful read）。
+ *
+ * 新数据条目（spec §4.1）无 envPath/knowledgeRoot/codeListPaths 字段，此函数会回填默认值
+ * （envPath='.env'，knowledgeRoot=undefined，codeListPaths=[]）。
+ * 旧数据条目仍可携带这些字段，按原逻辑归一相对路径。
  *
- * @param entry - 用户索引中的项目条目。
+ * @param entry - 用户索引中的项目条目（可能携带 legacy 字段）。
  * @returns 归一化后的项目上下文。
  */
 function normalizeProjectIndexEntry(entry) {
@@ -175,7 +221,7 @@ function normalizeProjectIndexEntry(entry) {
 /**
  * 判断用户索引条目是否匹配当前 projectDir、cwd 或 code_list 路径。
  *
- * @param entry - 用户索引中的项目条目。
+ * @param entry - 用户索引中的项目条目（可能携带 legacy codeListPaths）。
  * @param input - 当前解析输入。
  * @returns 是否匹配该条目。
  */

package/dist/src/index.d.ts

@@ -15,8 +15,8 @@ export type { ActionCandidate, AgentInferredWorkflow, GapActionType, GapExplorat
 export type { ObservableArtifactRef, ObservableGate, ObservableStageName, ObservableStagePayload, ObservableStageSummary, ReasoningEvidence, ReasoningSummary, TraceWriterOptions } from './contracts/observable-chain.js';
 export { createTraceWriter, } from './trace/trace-writer.js';
 export type { TraceWriter, } from './trace/trace-writer.js';
-export { readStageContext, resolveStageContext, writeProjectIndex, } from './context/stage-context.js';
-export type { ProjectIndex, ProjectIndexEntry, ResolveStageContextInput, ResolveStageContextResult, StageContext, StageContextMode, } from './context/stage-context.js';
+export { lookupProjectByRequirement, readStageContext, resolveStageContext, writeProjectIndex, } from './context/stage-context.js';
+export type { LookupProjectByRequirementInput, ProjectIndex, ProjectIndexEntry, ProjectsIndex, RequirementEntry, ResolveStageContextInput, ResolveStageContextResult, StageContext, StageContextMode, SystemEntry, } from './context/stage-context.js';
 export { renderReviewSummary, } from './trace/review-summary.js';
 export type { ReviewSummaryInput, } from './trace/review-summary.js';
 export { collectActionCandidates, } from './gap-planner/action-candidates.js';

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

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

package/dist/src/index.js

@@ -5,7 +5,7 @@ export { extractJavaAction } from './extractors/java-action.js';
 export { buildCrudBusinessModuleContract } from './normalizers/crud-contract.js';
 export { generateStageSkeletonCrudSpec, mapContractToStageSkeletonCrudSlots, renderStageSkeletonCrudSlots } from './generators/stage-skeleton-script.js';
 export { createTraceWriter, } from './trace/trace-writer.js';
-export { readStageContext, resolveStageContext, writeProjectIndex, } from './context/stage-context.js';
+export { lookupProjectByRequirement, readStageContext, resolveStageContext, writeProjectIndex, } from './context/stage-context.js';
 export { renderReviewSummary, } from './trace/review-summary.js';
 export { collectActionCandidates, } from './gap-planner/action-candidates.js';
 export { createSkeletonCoverage, } from './gap-planner/skeleton-coverage.js';

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,5 @@
+export { validateProjectsIndex } from './projects-index.js';
+export { validateTestcase } from './testcase.js';
+export { validateCredentials } from './credentials.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,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/src/validation/index.js

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects-index.d.ts","sourceRoot":"","sources":["../../../src/validation/projects-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAkC,MAAM,6BAA6B,CAAC;AAEjG;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAqBjE"}

package/dist/src/validation/projects-index.js

@@ -0,0 +1,37 @@
+/**
+ * 校验 ~/.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 function validateProjectsIndex(obj) {
+    if (!obj || typeof obj !== 'object')
+        throw new Error('projects.index.json5 顶层必须是对象');
+    const raw = obj;
+    if (!Array.isArray(raw.projects))
+        throw new Error('projects.index.json5 缺 projects[] 字段');
+    if (!Array.isArray(raw.systems))
+        throw new Error('projects.index.json5 缺 systems[] 字段');
+    const removedFields = ['stageContextPath', 'envPath', 'knowledgeRoot', 'codeListPaths'];
+    for (const entry of raw.projects) {
+        const e = entry;
+        if (typeof e.projectName !== 'string')
+            throw new Error('projects[] 条目缺 projectName');
+        if (typeof e.projectDir !== 'string')
+            throw new Error('projects[] 条目缺 projectDir');
+        if (e.mode !== 'glue')
+            throw new Error('projects[] 条目 mode 必须为 glue');
+        if (typeof e.stageCreateVersion !== 'string' || !e.stageCreateVersion) {
+            throw new Error('projects[] 条目缺 stageCreateVersion（承接砍掉的 stage-context.md 元信息）');
+        }
+        for (const f of removedFields) {
+            if (f in e)
+                throw new Error(`projects[] 条目含已废弃字段 ${f}（stage-context.md 已砍，应 removed）`);
+        }
+    }
+    return { projects: raw.projects, systems: raw.systems };
+}

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

@@ -0,0 +1,13 @@
+import type { TestcaseV2 } from '../testcase/testcase-v2.js';
+/**
+ * 校验 testcase.json5 v2 schema（REQ-DATA-02 / REQ-SCHEMA-01）。
+ *
+ * 必含 schemaVersion:"v2" + scenario + menuPath + requiredSystems[] + requiredRoles[] +
+ * coveredActions[] + uncoveredCandidates[] + cases[]；evidence 元素符合 <kind>=<ref>。
+ *
+ * @param obj - 从 JSON5 解析出来的原始对象。
+ * @returns 归一化后的 TestcaseV2。
+ * @throws 缺字段 / 版本不匹配 / evidence 格式错时抛结构化错误。
+ */
+export declare function validateTestcase(obj: unknown): TestcaseV2;
+//# sourceMappingURL=testcase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testcase.d.ts","sourceRoot":"","sources":["../../../src/validation/testcase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAI7D;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAuCzD"}