@dommaker/harness 1.10.0 → 1.12.0

package/src/knowledge/lint.ts

@@ -13,6 +13,7 @@
 import type { KnowledgeStore } from './store';
 import { ReferenceTracker } from './reference-tracker';
 import type { KnowledgeEntry, LintIssue, LintIssueType, MaturityLevel } from './types';
+import { MATURITY_LEVELS, STORAGE_LAYERS } from './types';
 
 const MAX_SOURCE_REFS = 20;
 
@@ -46,6 +47,7 @@ export class KnowledgeLinter {
     issues.push(...this.checkOutdated(entries));
     issues.push(...this.checkDuplicates(entries));
     issues.push(...this.checkContradictions(entries));
+    issues.push(...this.checkInvalidEnums(entries));
 
     // 自动修复
     let fixed = 0;
@@ -60,6 +62,7 @@ export class KnowledgeLinter {
       outdated: 0,
       duplicate: 0,
       index_inconsistent: 0,
+      invalid_enum: 0,
     };
     for (const issue of issues) {
       summary[issue.type]++;
@@ -204,6 +207,55 @@ export class KnowledgeLinter {
     return issues;
   }
 
+  /**
+   * 检查存量条目的 maturity/layer 枚举值域（E1 复盘修正 M1 收口：
+   * 写入闸只挡新写，存量脏值由本检查进 lint 报告；缺字段在存量侧算脏值）。
+   * 与 validateEntry 共用同一判定正本（invalidEnumIssues），autoFix 不动此类
+   * issue——枚举映射需人工裁定，不自动改。
+   */
+  checkInvalidEnums(entries: KnowledgeEntry[]): LintIssue[] {
+    const issues: LintIssue[] = [];
+    for (const entry of entries) {
+      issues.push(...this.invalidEnumIssues(entry, true, entry.id));
+    }
+    return issues;
+  }
+
+  /**
+   * maturity/layer 枚举判定正本。missingIsDirty=false 时字段缺省跳过
+   * （pre-ingest 调用方只传四字段的兼容面）；存量扫描传 true（缺字段即脏）。
+   */
+  private invalidEnumIssues(
+    fields: { maturity?: string; layer?: string },
+    missingIsDirty: boolean,
+    entryId?: string
+  ): LintIssue[] {
+    const issues: LintIssue[] = [];
+    if ((missingIsDirty || fields.maturity !== undefined) && !(MATURITY_LEVELS as readonly string[]).includes(fields.maturity as string)) {
+      issues.push({
+        type: 'invalid_enum',
+        entryId,
+        severity: 'high',
+        description: fields.maturity === undefined
+          ? `maturity is missing (declared values: ${MATURITY_LEVELS.join(' | ')}).`
+          : `maturity "${fields.maturity}" is not a declared value (${MATURITY_LEVELS.join(' | ')}).`,
+        suggestion: 'Map to a declared maturity (e.g. pending → draft) before writing; the store write gate rejects undeclared values.',
+      });
+    }
+    if ((missingIsDirty || fields.layer !== undefined) && !(STORAGE_LAYERS as readonly string[]).includes(fields.layer as string)) {
+      issues.push({
+        type: 'invalid_enum',
+        entryId,
+        severity: 'high',
+        description: fields.layer === undefined
+          ? `layer is missing (declared values: ${STORAGE_LAYERS.join(' | ')}).`
+          : `layer "${fields.layer}" is not a declared value (${STORAGE_LAYERS.join(' | ')}).`,
+        suggestion: 'Map to a declared layer or drop the field; the store write gate rejects undeclared values.',
+      });
+    }
+    return issues;
+  }
+
   /**
    * 检查矛盾（同主题相反结论）
    *
@@ -260,10 +312,17 @@ export class KnowledgeLinter {
    * - Title too vague (common stop words only) → flag
    * - Contradicts a proven entry with same tags → reject
    * - Near-duplicate of existing entry (title similarity > 80%) → flag merge
+   * - maturity/layer 未声明枚举值 → reject（E1 复盘修正 M1；字段缺省则跳过，
+   *   兼容只传 title/content/tags/type 的 pre-ingest 调用方；存量报告由调用方
+   *   把条目字段显式传入触发）
    */
-  validateEntry(entry: { title: string; content: string; tags: string[]; type: string }): LintIssue[] {
+  validateEntry(entry: { title: string; content: string; tags: string[]; type: string; maturity?: string; layer?: string }): LintIssue[] {
     const issues: LintIssue[] = [];
 
+    // Undeclared maturity/layer enum values（判定正本 = invalidEnumIssues；字段缺省跳过，
+    // 兼容只传四字段的 pre-ingest 调用方；存量扫描走 run() → checkInvalidEnums）
+    issues.push(...this.invalidEnumIssues(entry, false));
+
     // Content too short
     if ((entry.content || '').length < 20) {
       issues.push({

package/src/knowledge/store.ts

@@ -18,6 +18,7 @@ import type {
   SnapshotSurvival,
   StoreUpdate,
 } from './types';
+import { MATURITY_LEVELS, STORAGE_LAYERS } from './types';
 
 const DEFAULT_DIR = '.harness/knowledge';
 const INDEX_FILE = 'index.json';
@@ -109,12 +110,36 @@ export class FileKnowledgeStore implements KnowledgeStore {
   }
 
   save(entry: KnowledgeEntry): void {
+    this.assertEnumFields(entry);
     this.writeEntryFile(entry);
     this.updateIndexEntry(entry);
   }
 
+  /**
+   * 写入闸（E1 复盘修正 M1）：maturity/layer 是声明枚举（值域正本在 types.ts），
+   * 未声明值拒写报错，不静默降级。save/saveAll/applyAll 三条落盘路径共用；
+   * update 经 save 继承同一闸。存量脏条目（绕过本 store 直写文件的）在被
+   * 任一写入路径触及时抛错——先修脏值再写。
+   */
+  private assertEnumFields(entry: KnowledgeEntry): void {
+    if (!MATURITY_LEVELS.includes(entry.maturity)) {
+      throw new Error(
+        `[harness] 知识条目 ${entry.id} 的 maturity 值 "${entry.maturity}" 未声明` +
+        `（允许: ${MATURITY_LEVELS.join(' | ')}），拒写`
+      );
+    }
+    if (!STORAGE_LAYERS.includes(entry.layer)) {
+      throw new Error(
+        `[harness] 知识条目 ${entry.id} 的 layer 值 "${entry.layer}" 未声明` +
+        `（允许: ${STORAGE_LAYERS.join(' | ')}），拒写`
+      );
+    }
+  }
+
   saveAll(entries: KnowledgeEntry[]): void {
     if (entries.length === 0) return;
+    // 整批预校验（写入闸）：任一脏值全批拒写，不落半个批次
+    for (const entry of entries) this.assertEnumFields(entry);
     const index = this.readIndex();
     const position = new Map(index.map((e, i) => [e.id, i]));
     for (const entry of entries) {
@@ -133,25 +158,37 @@ export class FileKnowledgeStore implements KnowledgeStore {
 
   applyAll(updates: StoreUpdate[]): void {
     if (updates.length === 0) return;
+    // 先合并再整批预校验（写入闸）：任一合并结果脏值全批拒写，不落半个批次。
+    // 批内同 id 多条按序累积合并（后者基于前者的合并结果，与逐条 update 同语义）。
+    const merged: KnowledgeEntry[] = [];
+    const pending = new Map<string, number>(); // id → merged 下标
+    for (const { id, partial } of updates) {
+      const idx = pending.get(id);
+      const base = idx !== undefined ? merged[idx] : this.get(id);
+      if (!base) continue;
+      const next: KnowledgeEntry = { ...base, ...partial, id };
+      if (idx !== undefined) {
+        merged[idx] = next;
+      } else {
+        pending.set(id, merged.length);
+        merged.push(next);
+      }
+    }
+    if (merged.length === 0) return;
+    for (const entry of merged) this.assertEnumFields(entry);
     const index = this.readIndex();
     const position = new Map(index.map((e, i) => [e.id, i]));
-    let applied = 0;
-    for (const { id, partial } of updates) {
-      const existing = this.get(id);
-      if (!existing) continue;
-      const updated: KnowledgeEntry = { ...existing, ...partial, id };
-      this.writeEntryFile(updated);
-      const indexEntry = this.toIndexEntry(updated);
-      const idx = position.get(id);
+    for (const entry of merged) {
+      this.writeEntryFile(entry);
+      const indexEntry = this.toIndexEntry(entry);
+      const idx = position.get(entry.id);
       if (idx !== undefined) {
         index[idx] = indexEntry;
       } else {
-        position.set(id, index.length);
+        position.set(entry.id, index.length);
         index.push(indexEntry);
       }
-      applied++;
     }
-    if (applied === 0) return;
     this.writeIndex(index);
   }
 

package/src/knowledge/types.ts

@@ -15,6 +15,12 @@ export type MaturityLevel = 'draft' | 'verified' | 'proven' | 'archived' | 'acti
 
 export type StorageLayer = 'personal' | 'team' | 'tech' | 'domain' | 'project' | 'system';
 
+/** MaturityLevel 的运行时值域正本（store 写入闸与 lint 枚举校验共用） */
+export const MATURITY_LEVELS: readonly MaturityLevel[] = ['draft', 'verified', 'proven', 'archived', 'active', 'deprecated'];
+
+/** StorageLayer 的运行时值域正本（store 写入闸与 lint 枚举校验共用） */
+export const STORAGE_LAYERS: readonly StorageLayer[] = ['personal', 'team', 'tech', 'domain', 'project', 'system'];
+
 /** How agent consumes this knowledge — drives injection strategy and lifecycle */
 export type ConsumptionMode = 'rule' | 'reference' | 'context' | 'signal';
 
@@ -101,7 +107,7 @@ export interface QueryFilter {
 
 // ── Lint ────────────────────────────────────────────────────
 
-export type LintIssueType = 'orphan' | 'contradiction' | 'outdated' | 'duplicate' | 'index_inconsistent';
+export type LintIssueType = 'orphan' | 'contradiction' | 'outdated' | 'duplicate' | 'index_inconsistent' | 'invalid_enum';
 
 export interface LintIssue {
   type: LintIssueType;

package/src/monitoring/CONTEXT.md

@@ -22,7 +22,7 @@
 - 零 Token 成本：不调用 LLM
 - **凡以 `skip` 策略读 JSONL，坏行计数必须到达该消费面的用户可见输出，或在该调用点显式记名豁免并写明理由（harness#100）**——静默吞掉「数据不全」不是一种可选项。承载方式纯增量：新报告入口带计数，旧入口退化为丢计数的薄包装（#82 裁决 4 的兼容约束继续成立），不另立第二份计数概念、不把 `JsonlReadResult` 提升进包根（ADR-0003）
   - 机器可检：`src/utils/__tests__/jsonl-skip-disposition.test.ts` 三道闸——每个 `readJsonl` 调用点必须判得出策略（判不出即形状逃逸，失败）、skip 读点集合冻结（新增未声明即失败，站点消失却不删条目也失败）、每个读点上方 6 行内有 `计数去向：` 声明且邻居声明不得顶替
-  - 三类去向（逐条对得上代码）：**报告体内部的降级位**随报告体走 stdout——`constraints report` 的坏行提示紧挨既有的 `traceFileExists` 说明；**不挤动既有输出的诊断告知**走 stderr——`status`（`logError`，stdout 的 `记录数` 口径与字节不变）、`failure list`（#96 定稿的 `console.error`）、`constraints retire`（交互与 `--yes` 直达两条路径各自告知）；**结构化面用字段**——`constraints report --json` 的 `skippedLines`、`--export` markdown 的警示行、studio 端点响应体（配套票 studio#451）
+  - 三类去向（逐条对得上代码）：**报告体内部的降级位**随报告体走 stdout——`constraints report` 的坏行提示紧挨既有的 `traceFileExists` 说明；**不挤动既有输出的诊断告知**走 stderr——`status`（`logError`，stdout 的 `记录数` 口径与字节不变）、`failure list`（#96 定稿的 `console.error`）、`constraints retire`（交互与 `--yes` 直达两条路径各自告知）；**结构化面用字段**——`constraints report --json-output` 的 `skippedLines`、`--export` markdown 的警示行、studio 端点响应体（配套票 studio#451）
 
 ## 注意事项
 - 追踪数据供 `harness constraints report` 统计与退役候选诊断消费（观测用途，不做自动降级）

package/src/presets/__tests__/standard.test.ts

@@ -32,16 +32,17 @@ describe('预设数据', () => {
   describe('RELAXED_PRESET', () => {
     it('应该只启用核心约束', () => {
       expect(RELAXED_PRESET.name).toBe('relaxed');
-      expect(RELAXED_PRESET.errors).toHaveLength(1);
-      expect(RELAXED_PRESET.warnings).toHaveLength(1);
+      expect(RELAXED_PRESET.errors).toHaveLength(2);
+      expect(RELAXED_PRESET.warnings).toHaveLength(0);
     });
 
     it('应该包含 no_completion_without_verification', () => {
       expect(RELAXED_PRESET.errors).toContain('no_completion_without_verification');
     });
 
-    it('应该包含 no_hardcoded_credentials', () => {
-      expect(RELAXED_PRESET.warnings).toContain('no_hardcoded_credentials');
+    it('应该包含 no_hardcoded_credentials（ADR-0032 起为 error 级，同桶）', () => {
+      expect(RELAXED_PRESET.errors).toContain('no_hardcoded_credentials');
+      expect(RELAXED_PRESET.warnings).toEqual([]);
     });
   });
 

package/src/presets/standard.ts

@@ -47,16 +47,15 @@ export const STANDARD_PRESET: PresetConfig = {
 /**
  * 宽松预设
  *
- * 仅启用核心 error 级与凭证扫描
+ * 仅启用核心 error 级与凭证扫描（ADR-0032 起凭证扫描为 error 级，同桶）
  */
 export const RELAXED_PRESET: PresetConfig = {
   name: 'relaxed',
   errors: [
     'no_completion_without_verification',
-  ],
-  warnings: [
     'no_hardcoded_credentials',
   ],
+  warnings: [],
 };
 
 /**

package/src/types/constraint.ts

@@ -32,6 +32,15 @@ export type ConstraintSeverity = 'error' | 'warning' | 'info';
  */
 export type ConstraintTrigger = string;
 
+/**
+ * 约束来源（ADR-0033 两层约束模型）
+ *
+ * - builtin：内置约束（definitions/ 字面量定义，checker 按约束 id 注册查找）
+ * - app：应用层约束（应用仓 `.harness/constraints.yml` 定义，checker 按模板 id +
+ *   params 实例化）；缺省 builtin
+ */
+export type ConstraintSource = 'builtin' | 'app';
+
 /**
  * 约束定义
  */
@@ -65,6 +74,25 @@ export interface Constraint {
 
   /** 是否启用 */
   enabled?: boolean;
+
+  /**
+   * 约束来源（ADR-0033）：缺省 builtin
+   *
+   * app = 应用层约束（应用仓 `.harness/constraints.yml` 定义）；
+   * report/退休/提案据此区分来源
+   */
+  source?: ConstraintSource;
+
+  /**
+   * 填空式 checker 模板 id（仅 source='app' 使用）
+   *
+   * 内置约束省略 = checker 按约束 id 在内置注册表查找；应用层约束按模板 id
+   * 在模板注册表（checkers/index.ts TEMPLATES）查找并带 params 实例化
+   */
+  checker?: string;
+
+  /** 模板参数（仅 source='app' 使用，形状由各模板的 validateParams 校验） */
+  params?: Record<string, unknown>;
 }
 
 /**

package/dist/cli/commands/posteval-plan.d.ts

@@ -1,15 +0,0 @@
-/**
- * harness posteval-plan 命令
- *
- * 调用 Studio PostEval API，验证 plan 文件的 checklist items 是否都有对应的 staged diff。
- * pre-commit hook 使用此命令防止"假装完成"。
- *
- * 判定经返回值外溢（架构评审候选7）：API 不可用/5xx 属"未判定"→ skip（退出码面 0 不变）；
- * 覆盖率不足与 4xx → fail，reason 指明是哪一项否决。
- */
-import { type CommandIO, type CommandResult } from '../command-contract';
-export interface PostEvalPlanOptions {
-    planPath: string;
-}
-export declare function postevalPlan(options: PostEvalPlanOptions, io?: CommandIO): Promise<CommandResult>;
-//# sourceMappingURL=posteval-plan.d.ts.map

package/dist/cli/commands/posteval-plan.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"posteval-plan.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/posteval-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAA4B,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEnG,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB;AA6BD,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,EAC5B,EAAE,GAAE,SAAqB,GACxB,OAAO,CAAC,aAAa,CAAC,CAkDxB"}

package/dist/cli/commands/posteval-plan.js

@@ -1,86 +0,0 @@
-"use strict";
-/**
- * harness posteval-plan 命令
- *
- * 调用 Studio PostEval API，验证 plan 文件的 checklist items 是否都有对应的 staged diff。
- * pre-commit hook 使用此命令防止"假装完成"。
- *
- * 判定经返回值外溢（架构评审候选7）：API 不可用/5xx 属"未判定"→ skip（退出码面 0 不变）；
- * 覆盖率不足与 4xx → fail，reason 指明是哪一项否决。
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.postevalPlan = postevalPlan;
-const chalk_1 = __importDefault(require("chalk"));
-const command_contract_1 = require("../command-contract");
-const MAX_RETRIES = 3;
-const RETRY_DELAY_MS = 2000;
-async function fetchWithRetry(url, body, retries) {
-    let lastError;
-    for (let i = 0; i < retries; i++) {
-        try {
-            const controller = new AbortController();
-            const timeout = setTimeout(() => controller.abort(), 5000);
-            const res = await fetch(url, {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
-                body,
-                signal: controller.signal,
-            });
-            clearTimeout(timeout);
-            return res;
-        }
-        catch (error) {
-            lastError = error;
-            if (i < retries - 1) {
-                await new Promise(resolve => setTimeout(resolve, RETRY_DELAY_MS * (i + 1))); // exponential backoff
-            }
-        }
-    }
-    throw lastError;
-}
-async function postevalPlan(options, io = command_contract_1.processIO) {
-    const apiPort = process.env.API_PORT || '3001';
-    const url = `http://localhost:${apiPort}/api/v1/agents/post-eval/plan-coverage`;
-    try {
-        const res = await fetchWithRetry(url, JSON.stringify({ planPath: options.planPath }), MAX_RETRIES);
-        if (!res.ok) {
-            if (res.status >= 500) {
-                // Server error — allow commit with warning (don't block on infrastructure failure)
-                (0, command_contract_1.logError)(io, chalk_1.default.yellow(`⚠️  PostEval API unavailable (${res.status}), allowing commit with warning`));
-                (0, command_contract_1.logError)(io, chalk_1.default.yellow(`   Plan: ${options.planPath}`));
-                return { kind: 'skip', reason: `PostEval API 服务端错误 ${res.status}，未判定` };
-            }
-            (0, command_contract_1.logError)(io, chalk_1.default.red(`❌ PostEval API error: ${res.status} ${res.statusText}`));
-            return { kind: 'fail', reason: `PostEval API error: ${res.status} ${res.statusText}` };
-        }
-        const report = await res.json();
-        const pct = Math.round(report.completeness * 100);
-        if (report.completeness < 1) {
-            (0, command_contract_1.logError)(io, chalk_1.default.red(`❌ Plan coverage: ${pct}% (${report.matchedAcs.length}/${report.matchedAcs.length + report.missedAcs.length})`));
-            if (report.missedAcs.length > 0) {
-                (0, command_contract_1.logError)(io, chalk_1.default.red('Missed items:'));
-                report.missedAcs.forEach((item) => (0, command_contract_1.logError)(io, chalk_1.default.red(`  - ${item}`)));
-            }
-            return {
-                kind: 'fail',
-                reason: `plan coverage ${pct}% < 100%，缺 ${report.missedAcs.length} 项: ${report.missedAcs.join('; ')}`,
-            };
-        }
-        (0, command_contract_1.log)(io, chalk_1.default.green(`✅ Plan coverage: ${pct}%`));
-        return { kind: 'ok' };
-    }
-    catch (error) {
-        // API unreachable after all retries — allow with warning (don't block commits on infra)
-        (0, command_contract_1.logError)(io, chalk_1.default.yellow(`⚠️  Studio API unreachable after ${MAX_RETRIES} retries, allowing commit with warning`));
-        (0, command_contract_1.logError)(io, chalk_1.default.yellow(`   Plan: ${options.planPath}`));
-        (0, command_contract_1.logError)(io, chalk_1.default.yellow(`   Error: ${error?.code || error?.message || String(error)}`));
-        return {
-            kind: 'skip',
-            reason: `Studio API 不可达（${error?.code || error?.message || String(error)}），未判定`,
-        };
-    }
-}
-//# sourceMappingURL=posteval-plan.js.map

package/dist/cli/commands/posteval-plan.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"posteval-plan.js","sourceRoot":"","sources":["../../../src/cli/commands/posteval-plan.ts"],"names":[],"mappings":"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"}

package/src/cli/commands/__tests__/posteval-plan.test.ts

@@ -1,204 +0,0 @@
-/**
- * posteval-plan 命令测试
- */
-
-import * as fs from 'fs';
-import { captureIO, type CapturingIO } from '../../command-contract';
-import * as path from 'path';
-import * as os from 'os';
-
-let io: CapturingIO;
-beforeEach(() => {
-  io = captureIO();
-});
-
-describe('postevalPlan', () => {
-  jest.setTimeout(30000); // Retry-based tests with exponential backoff need longer timeout
-  let tempDir: string;
-  let planPath: string;
-  let originalFetch: typeof fetch;
-  let originalEnv: NodeJS.ProcessEnv;
-
-  beforeAll(() => {
-    tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'temp-test-posteval-'));
-    planPath = path.join(tempDir, 'plan.md');
-    fs.writeFileSync(planPath, '# Test plan\n- [AC-001] Task 1\n- [AC-002] Task 2');
-  });
-
-  afterAll(() => {
-    try {
-      fs.rmSync(tempDir, { recursive: true, force: true });
-    } catch {
-      // ignore
-    }
-  });
-
-  beforeEach(() => {
-    jest.clearAllMocks();
-    originalFetch = global.fetch;
-    originalEnv = { ...process.env };
-    delete process.env.API_PORT;
-    delete process.env.POSTEVAL_GRACE_MS;
-  });
-
-  afterEach(() => {
-    global.fetch = originalFetch;
-    process.env = originalEnv;
-    jest.useRealTimers();
-  });
-
-  it('应该成功验证 plan 覆盖率并打印绿色信息', async () => {
-    global.fetch = jest.fn().mockResolvedValue({
-      ok: true,
-      json: () => Promise.resolve({
-        completeness: 1,
-        matchedAcs: ['AC-001', 'AC-002'],
-        missedAcs: [],
-      }),
-    }) as any;
-
-    const { postevalPlan } = await import('../posteval-plan');
-    await postevalPlan({ planPath }, io);
-
-    expect(io.outText()).toContain('100%');
-  });
-
-  it('completeness < 1：fail（覆盖率不足，含缺失项）', async () => {
-    global.fetch = jest.fn().mockResolvedValue({
-      ok: true,
-      json: () => Promise.resolve({
-        completeness: 0.5,
-        matchedAcs: ['AC-001'],
-        missedAcs: ['AC-002'],
-      }),
-    }) as any;
-
-    const { postevalPlan } = await import('../posteval-plan');
-    const result = await postevalPlan({ planPath }, io);
-
-    expect(result).toEqual({ kind: 'fail', reason: expect.stringContaining('plan coverage 50% < 100%') });
-    expect(io.errText()).toContain('50%');
-  });
-
-  it('completeness < 1 时应该列出缺失项', async () => {
-    global.fetch = jest.fn().mockResolvedValue({
-      ok: true,
-      json: () => Promise.resolve({
-        completeness: 0.33,
-        matchedAcs: ['AC-001'],
-        missedAcs: ['AC-002', 'AC-003'],
-      }),
-    }) as any;
-
-    const { postevalPlan } = await import('../posteval-plan');
-    const result = await postevalPlan({ planPath }, io);
-
-    expect(result).toEqual({
-      kind: 'fail',
-      reason: 'plan coverage 33% < 100%，缺 2 项: AC-002; AC-003',
-    });
-    expect(io.errText()).toContain('AC-002');
-  });
-
-  it('4xx 错误应该 exit(1)', async () => {
-    global.fetch = jest.fn().mockResolvedValue({
-      ok: false,
-      status: 400,
-      statusText: 'Bad Request',
-    }) as any;
-
-    const { postevalPlan } = await import('../posteval-plan');
-    const result = await postevalPlan({ planPath }, io);
-
-    expect(result).toEqual({ kind: 'fail', reason: 'PostEval API error: 400 Bad Request' });
-    expect(io.errText()).toContain('400');
-  });
-
-  it('5xx 错误：skip（未判定，允许提交；退出码面 0 不变）', async () => {
-    global.fetch = jest.fn().mockResolvedValue({
-      ok: false,
-      status: 503,
-      statusText: 'Service Unavailable',
-    }) as any;
-
-    const { postevalPlan } = await import('../posteval-plan');
-    const result = await postevalPlan({ planPath }, io);
-
-    expect(result).toEqual({ kind: 'skip', reason: expect.stringContaining('服务端错误 503') });
-    expect(io.errText()).toContain('unavailable');
-  });
-
-  it('网络错误重试耗尽：skip（未判定，允许提交）', async () => {
-    global.fetch = jest.fn().mockRejectedValue(new Error('ECONNREFUSED'));
-
-    const { postevalPlan } = await import('../posteval-plan');
-    const result = await postevalPlan({ planPath }, io);
-
-    expect(result).toEqual({ kind: 'skip', reason: expect.stringContaining('Studio API 不可达') });
-    expect(io.errText()).toContain('unreachable');
-  });
-
-  it('应该支持自定义 API_PORT', async () => {
-    process.env.API_PORT = '3999';
-    global.fetch = jest.fn().mockResolvedValue({
-      ok: true,
-      json: () => Promise.resolve({
-        completeness: 1,
-        matchedAcs: ['AC-001'],
-        missedAcs: [],
-      }),
-    }) as any;
-
-    const { postevalPlan } = await import('../posteval-plan');
-    await postevalPlan({ planPath }, io);
-
-    // Verify the fetch was called with port 3999
-    const fetchCall = (global.fetch as jest.Mock).mock.calls[0][0];
-    expect(fetchCall).toContain(':3999');
-  });
-
-  it('网络错误重试后成功应该不退出', async () => {
-    // First 2 calls fail, 3rd succeeds
-    const mockFetch = jest.fn()
-      .mockRejectedValueOnce(new Error('ECONNREFUSED'))
-      .mockRejectedValueOnce(new Error('ECONNREFUSED'))
-      .mockResolvedValueOnce({
-        ok: true,
-        json: () => Promise.resolve({
-          completeness: 1,
-          matchedAcs: ['AC-001'],
-          missedAcs: [],
-        }),
-      });
-
-    global.fetch = mockFetch as any;
-
-    const { postevalPlan } = await import('../posteval-plan');
-    const result = await postevalPlan({ planPath }, io);
-
-    // Should have been called 3 times
-    expect(mockFetch).toHaveBeenCalledTimes(3);
-    expect(io.outText()).toContain('100%');
-    expect(result.kind).toBe('ok');
-  });
-
-  it('completeness 为 0 时应该正确显示 0%', async () => {
-    global.fetch = jest.fn().mockResolvedValue({
-      ok: true,
-      json: () => Promise.resolve({
-        completeness: 0,
-        matchedAcs: [],
-        missedAcs: ['AC-001'],
-      }),
-    }) as any;
-
-    const { postevalPlan } = await import('../posteval-plan');
-    const result = await postevalPlan({ planPath }, io);
-
-    expect(result).toEqual({
-      kind: 'fail',
-      reason: 'plan coverage 0% < 100%，缺 1 项: AC-001',
-    });
-    expect(io.errText()).toContain('0%');
-  });
-});