@dommaker/harness 0.16.6 → 0.16.8

package/src/monitoring/performance-analyzer.ts

@@ -13,8 +13,6 @@
  * - PerformanceAnalyzer: 分析操作耗时
  */
 
-import * as fs from 'fs';
-import * as path from 'path';
 import type {
   PerformanceTrace,
   PerformanceSummary,
@@ -22,6 +20,16 @@ import type {
   PerformanceAnalyzerConfig,
 } from '../types/performance';
 import { PerformanceCollector } from './performance-collector';
+import {
+  groupByKey,
+  timeRangeOf,
+  calcAverage,
+  calcPercentile,
+  splitByTime,
+  writeSummaryJson,
+  readSummaryJson,
+  MIN_TREND_SAMPLES,
+} from './analyzer-base';
 
 /**
  * 默认配置
@@ -62,17 +70,13 @@ export class PerformanceAnalyzer {
    */
   summarize(traces: PerformanceTrace[]): PerformanceSummary[] {
     // 按操作类型分组
-    const grouped = this.groupByOperation(traces);
+    const grouped = groupByKey(traces, t => t.operation);
 
     const summaries: PerformanceSummary[] = [];
 
     for (const [operation, group] of grouped) {
       // 计算时间范围
-      const timestamps = group.map(t => t.timestamp);
-      const timeRange = {
-        start: Math.min(...timestamps),
-        end: Math.max(...timestamps),
-      };
+      const timeRange = timeRangeOf(group.map(t => t.timestamp));
 
       // 单次遍历计算核心统计
       const totalCalls = group.length;
@@ -90,11 +94,11 @@ export class PerformanceAnalyzer {
 
       // 计算耗时统计
       const durations = group.map(t => t.duration);
-      const avgDuration = this.calcAverage(durations);
+      const avgDuration = calcAverage(durations);
       const maxDuration = Math.max(...durations);
       const minDuration = Math.min(...durations);
-      const p95Duration = this.calcPercentile(durations, 95);
-      const p99Duration = this.calcPercentile(durations, 99);
+      const p95Duration = calcPercentile(durations, 95);
+      const p99Duration = calcPercentile(durations, 99);
 
       // 计算趋势
       const recentTrend = this.calculateTrend(group);
@@ -255,42 +259,22 @@ export class PerformanceAnalyzer {
     });
   }
 
-  /**
-   * 按操作类型分组
-   */
-  private groupByOperation(traces: PerformanceTrace[]): Map<string, PerformanceTrace[]> {
-    const grouped = new Map<string, PerformanceTrace[]>();
-
-    for (const trace of traces) {
-      const existing = grouped.get(trace.operation) || [];
-      existing.push(trace);
-      grouped.set(trace.operation, existing);
-    }
-
-    return grouped;
-  }
-
   /**
    * 计算趋势
    *
    * 对比前半段和后半段的平均耗时
    */
   private calculateTrend(traces: PerformanceTrace[]): 'stable' | 'rising' | 'falling' {
-    if (traces.length < 10) {
+    if (traces.length < MIN_TREND_SAMPLES) {
       return 'stable';
     }
 
-    // 按时间排序
-    const sorted = [...traces].sort((a, b) => a.timestamp - b.timestamp);
-
-    // 分成前后两半
-    const half = Math.floor(sorted.length / 2);
-    const firstHalf = sorted.slice(0, half);
-    const secondHalf = sorted.slice(half);
+    // 分成前后两半（按时间排序）
+    const [firstHalf, secondHalf] = splitByTime(traces);
 
     // 计算前半段和后半段的平均耗时
-    const firstAvg = this.calcAverage(firstHalf.map(t => t.duration));
-    const secondAvg = this.calcAverage(secondHalf.map(t => t.duration));
+    const firstAvg = calcAverage(firstHalf.map(t => t.duration));
+    const secondAvg = calcAverage(secondHalf.map(t => t.duration));
 
     // 计算变化率
     const delta = secondAvg - firstAvg;
@@ -306,52 +290,18 @@ export class PerformanceAnalyzer {
     }
   }
 
-  /**
-   * 计算平均值
-   */
-  private calcAverage(values: number[]): number {
-    if (values.length === 0) return 0;
-    return values.reduce((sum, v) => sum + v, 0) / values.length;
-  }
-
-  /**
-   * 计算百分位数
-   */
-  private calcPercentile(values: number[], percentile: number): number {
-    if (values.length === 0) return 0;
-
-    const sorted = [...values].sort((a, b) => a - b);
-    const index = Math.ceil((percentile / 100) * sorted.length) - 1;
-
-    return sorted[Math.max(0, index)];
-  }
-
   /**
    * 保存汇总结果
    */
   saveSummary(summaries: PerformanceSummary[]): void {
-    const dir = path.dirname(this.config.summaryFile!);
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-    }
-
-    fs.writeFileSync(
-      this.config.summaryFile!,
-      JSON.stringify(summaries, null, 2),
-      'utf-8'
-    );
+    writeSummaryJson(this.config.summaryFile!, summaries);
   }
 
   /**
    * 加载上次汇总结果
    */
   loadSummary(): PerformanceSummary[] | null {
-    if (!fs.existsSync(this.config.summaryFile!)) {
-      return null;
-    }
-
-    const content = fs.readFileSync(this.config.summaryFile!, 'utf-8');
-    return JSON.parse(content) as PerformanceSummary[];
+    return readSummaryJson<PerformanceSummary[]>(this.config.summaryFile!);
   }
 
   /**

package/src/monitoring/performance-collector.ts

@@ -324,25 +324,3 @@ export class PerformanceCollector {
     };
   }
 }
-
-/**
- * 全局单例（可选）
- */
-let globalCollector: PerformanceCollector | null = null;
-
-/**
- * 获取全局收集器
- */
-export function getPerformanceCollector(): PerformanceCollector {
-  if (!globalCollector) {
-    globalCollector = new PerformanceCollector();
-  }
-  return globalCollector;
-}
-
-/**
- * 配置全局收集器
- */
-export function configurePerformanceCollector(config: Partial<PerformanceCollectorConfig>): void {
-  globalCollector = new PerformanceCollector(config);
-}

package/src/monitoring/trace-analyzer.ts

@@ -9,16 +9,22 @@
  * - 趋势分析（对比上一周期）
  */
 
-import * as fs from 'fs';
-import * as path from 'path';
 import type {
   ExecutionTrace,
   TraceSummary,
   TraceAnomaly,
-  TraceFilter,
   TraceAnalyzerConfig,
 } from '../types/trace';
 import { TraceCollector } from './traces';
+import {
+  groupByKey,
+  timeRangeOf,
+  findMostCommon,
+  splitByTime,
+  writeSummaryJson,
+  readSummaryJson,
+  MIN_TREND_SAMPLES,
+} from './analyzer-base';
 
 /**
  * 默认配置
@@ -59,7 +65,7 @@ export class TraceAnalyzer {
    */
   summarize(traces: ExecutionTrace[]): TraceSummary[] {
     // 按约束 ID 分组
-    const grouped = this.groupByConstraint(traces);
+    const grouped = groupByKey(traces, t => t.constraintId);
 
     const summaries: TraceSummary[] = [];
 
@@ -68,11 +74,7 @@ export class TraceAnalyzer {
       const level = group[0].level;
 
       // 计算时间范围
-      const timestamps = group.map(t => t.timestamp);
-      const timeRange = {
-        start: Math.min(...timestamps),
-        end: Math.max(...timestamps),
-      };
+      const timeRange = timeRangeOf(group.map(t => t.timestamp));
 
       // 单次遍历计算核心统计
       const totalChecks = group.length;
@@ -93,7 +95,7 @@ export class TraceAnalyzer {
       const exceptionTraces = group.filter(t => t.exceptionApplied);
       const exceptionCount = exceptionTraces.length;
       const exceptionTypes = exceptionTraces.map(t => t.exceptionApplied!);
-      const mostCommonException = this.findMostCommon(exceptionTypes);
+      const mostCommonException = findMostCommon(exceptionTypes);
 
       // 计算趋势
       const recentTrend = this.calculateTrend(group);
@@ -265,38 +267,18 @@ export class TraceAnalyzer {
     });
   }
 
-  /**
-   * 按约束 ID 分组
-   */
-  private groupByConstraint(traces: ExecutionTrace[]): Map<string, ExecutionTrace[]> {
-    const grouped = new Map<string, ExecutionTrace[]>();
-
-    for (const trace of traces) {
-      const existing = grouped.get(trace.constraintId) || [];
-      existing.push(trace);
-      grouped.set(trace.constraintId, existing);
-    }
-
-    return grouped;
-  }
-
   /**
    * 计算趋势
  *
    * 对比前半段和后半段的通过率
    */
   private calculateTrend(traces: ExecutionTrace[]): 'stable' | 'rising' | 'falling' {
-    if (traces.length < 10) {
+    if (traces.length < MIN_TREND_SAMPLES) {
       return 'stable';
     }
 
-    // 按时间排序
-    const sorted = [...traces].sort((a, b) => a.timestamp - b.timestamp);
-
-    // 分成前后两半
-    const half = Math.floor(sorted.length / 2);
-    const firstHalf = sorted.slice(0, half);
-    const secondHalf = sorted.slice(half);
+    // 分成前后两半（按时间排序）
+    const [firstHalf, secondHalf] = splitByTime(traces);
 
     // 计算前半段和后半段的通过率
     const firstPassRate = this.calcPassRate(firstHalf);
@@ -324,56 +306,18 @@ export class TraceAnalyzer {
     return passCount / traces.length;
   }
 
-  /**
-   * 找出最常见元素
-   */
-  private findMostCommon(items: string[]): string | undefined {
-    if (items.length === 0) return undefined;
-
-    const counts = new Map<string, number>();
-    for (const item of items) {
-      counts.set(item, (counts.get(item) || 0) + 1);
-    }
-
-    let maxCount = 0;
-    let mostCommon: string | undefined;
-
-    for (const [item, count] of counts) {
-      if (count > maxCount) {
-        maxCount = count;
-        mostCommon = item;
-      }
-    }
-
-    return mostCommon;
-  }
-
   /**
    * 保存汇总结果
    */
   saveSummary(summaries: TraceSummary[]): void {
-    const dir = path.dirname(this.config.summaryFile!);
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-    }
-
-    fs.writeFileSync(
-      this.config.summaryFile!,
-      JSON.stringify(summaries, null, 2),
-      'utf-8'
-    );
+    writeSummaryJson(this.config.summaryFile!, summaries);
   }
 
   /**
    * 加载上次汇总结果
    */
   loadSummary(): TraceSummary[] | null {
-    if (!fs.existsSync(this.config.summaryFile!)) {
-      return null;
-    }
-
-    const content = fs.readFileSync(this.config.summaryFile!, 'utf-8');
-    return JSON.parse(content) as TraceSummary[];
+    return readSummaryJson<TraceSummary[]>(this.config.summaryFile!);
   }
 
   /**

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

@@ -1,10 +1,10 @@
 /**
- * Tests for standard.ts — applyPreset, getPreset, getIronLawPreset
+ * Tests for standard.ts — applyPreset, getPreset
  *
  * Pure logic, no I/O — tests preset selection and constraint filtering.
  */
 
-import { applyPreset, getPreset, getIronLawPreset } from '../standard';
+import { applyPreset, getPreset } from '../standard';
 
 describe('getPreset', () => {
   it('returns strict preset', () => {
@@ -87,18 +87,3 @@ describe('applyPreset with PresetConfig object', () => {
     expect(config.disabled.length).toBeGreaterThan(0);
   });
 });
-
-describe('getIronLawPreset (deprecated)', () => {
-  it('returns iron law config for strict preset', () => {
-    const config = getIronLawPreset('strict');
-    expect(config.preset).toBe('strict');
-    expect(config.enabled).toBe(true);
-    expect(config.ironLaws.length).toBeGreaterThan(5);
-  });
-
-  it('returns iron law config for relaxed preset', () => {
-    const config = getIronLawPreset('relaxed');
-    expect(config.preset).toBe('relaxed');
-    expect(config.ironLaws).toHaveLength(3);
-  });
-});

package/src/presets/index.ts

@@ -8,9 +8,7 @@ export {
   RELAXED_PRESET,
   getPreset,
   applyPreset,
-  // 向后兼容
-  STANDARD_IRON_LAWS_CONFIG,
-  getIronLawPreset,
+
 } from './standard';
 
 export type { PresetConfig } from './standard';

package/src/presets/standard.ts

@@ -4,7 +4,7 @@
  * 预设定义哪些约束被启用
  */
 
-import type { ConstraintLevel, Constraint } from '../types/constraint';
+import type { Constraint } from '../types/constraint';
 import type { MergedConstraintsConfig } from '../types/project-config';
 import { IRON_LAWS, GUIDELINES, TIPS } from '../core/constraints/definitions';
 
@@ -135,29 +135,4 @@ export function getPreset(name: string): PresetConfig {
     default:
       return STANDARD_PRESET;
   }
-}
-
-// ========================================
-// 向后兼容
-// ========================================
-
-import type { IronLawConfig } from '../types/iron-law';
-
-/**
- * @deprecated 使用 PresetConfig 代替
- */
-export { STANDARD_PRESET as STANDARD_IRON_LAWS_CONFIG };
-
-/**
- * @deprecated 使用 getPreset 代替
- */
-export function getIronLawPreset(preset: string): IronLawConfig {
-  const config = getPreset(preset);
-  return {
-    preset: preset as 'strict' | 'standard' | 'relaxed',
-    enabled: true,
-    ironLaws: config.ironLaws 
-      ? Object.values(IRON_LAWS).filter(c => config.ironLaws!.includes(c.id))
-      : Object.values(IRON_LAWS),
-  };
 }

package/src/safety/output-guardrail.ts

@@ -26,16 +26,12 @@ const DEFAULT_SENSITIVE_PATTERNS: RegExp[] = [
   /(?:mongodb|postgres|mysql|redis):\/\/[^\s'"]+/gi,
 ];
 
-const DEFAULT_MIN_QUALITY_SCORE = 0.6;
-
 export class OutputGuardrail {
   private sensitivePatterns: RegExp[];
-  private minQualityScore: number;
   private checkKnowledgeRefs: boolean;
 
   constructor(config?: OutputGuardrailConfig) {
     this.sensitivePatterns = config?.sensitivePatterns ?? DEFAULT_SENSITIVE_PATTERNS;
-    this.minQualityScore = config?.minQualityScore ?? DEFAULT_MIN_QUALITY_SCORE;
     this.checkKnowledgeRefs = config?.checkKnowledgeRefs ?? false;
   }
 

package/src/tools/registry.ts

@@ -4,7 +4,7 @@
  * 工具注册/发现/执行
  */
 
-import type { ToolDefinition, ToolCategory, ToolHandler, ToolResult } from './types';
+import type { ToolDefinition, ToolCategory, ToolResult } from './types';
 
 export class ToolRegistry {
   private tools: Map<string, ToolDefinition>;

package/src/types/__tests__/types.test.ts

@@ -5,29 +5,13 @@
 import { describe, it, expect } from '@jest/globals';
 
 // 从 barrel index.ts 导入，覆盖 re-export 行
-import {
-  ConstraintViolationError,
-  IronLawViolationError,
-} from '..';
-
-// 从 iron-law.ts 导入，覆盖 value re-export
-import { IronLawViolationError as IronLawViolationErrorDirect } from '../iron-law';
+import { ConstraintViolationError } from '..';
 
 describe('types barrel exports', () => {
   it('ConstraintViolationError 应该可从 index 导入', () => {
     expect(ConstraintViolationError).toBeDefined();
     expect(typeof ConstraintViolationError).toBe('function');
   });
-
-  it('IronLawViolationError 应该可从 index 导入（向后兼容）', () => {
-    expect(IronLawViolationError).toBeDefined();
-    expect(IronLawViolationError.prototype).toBeInstanceOf(ConstraintViolationError);
-  });
-
-  it('IronLawViolationError 应该可从 iron-law.ts 直接导入', () => {
-    expect(IronLawViolationErrorDirect).toBeDefined();
-    expect(IronLawViolationErrorDirect).toBe(ConstraintViolationError);
-  });
 });
 
 describe('ConstraintViolationError', () => {
@@ -68,19 +52,3 @@ describe('ConstraintViolationError', () => {
     expect(error.message).toBe('Constraint violation');
   });
 });
-
-describe('IronLawViolationError', () => {
-  it('应该继承 ConstraintViolationError', () => {
-    const error = new IronLawViolationError({
-      id: 'test',
-      level: 'iron_law',
-      satisfied: false,
-      message: '铁律违规',
-      checkedAt: new Date(),
-    });
-
-    expect(error).toBeInstanceOf(ConstraintViolationError);
-    expect(error.name).toBe('IronLawViolationError');
-    expect(error.message).toBe('铁律违规');
-  });
-});

package/src/types/constraint.ts

@@ -18,35 +18,11 @@ export type ConstraintId = string;
 export type ConstraintLevel = 'iron_law' | 'guideline' | 'tip';
 
 /**
- * 约束触发条件
- */
-/**
- * 约束触发器（开放扩展）
+ * 约束触发条件（开放扩展）
  *
  * 从硬编码 union type 改为 string，consumer 可传入任意 trigger。
  * 无需修改 harness 即可添加领域特定 trigger。
- *
- * 以下为推荐的抽象 trigger 常量。领域概念（如 deploy、
- * config_update 等）由 consumer 自行管理。
  */
-
-export const CODE_IMPLEMENTATION = 'code_implementation' as const;
-export const FILE_MODIFICATION = 'file_modification' as const;
-export const FILE_CREATION = 'file_creation' as const;
-export const FILE_DELETION = 'file_deletion' as const;
-export const MODULE_CREATION = 'module_creation' as const;
-export const MODULE_MODIFICATION = 'module_modification' as const;
-export const MODULE_DELETION = 'module_deletion' as const;
-export const MODULE_EXTENSION = 'module_extension' as const;
-export const API_CHANGE = 'api_change' as const;
-export const EXPORT_CHANGE = 'export_change' as const;
-export const TEST_CREATION = 'test_creation' as const;
-export const COMMIT = 'commit' as const;
-export const PUSH = 'push' as const;
-export const MERGE = 'merge' as const;
-export const DESIGN_REQUEST = 'design_request' as const;
-export const ARCHITECTURE_CHANGE = 'architecture_change' as const;
-
 export type ConstraintTrigger = string;
 
 /**
@@ -87,33 +63,6 @@ export interface Constraint {
   exceptions?: string[];
 }
 
-// ========================================
-// 向后兼容的类型别名
-// ========================================
-
-/**
- * @deprecated 使用 ConstraintId 代替
- */
-export type IronLawId = ConstraintId;
-
-/**
- * @deprecated 使用 ConstraintLevel 代替
- */
-export type IronLawSeverity = 'error' | 'warning' | 'info';
-
-/**
- * @deprecated 使用 ConstraintTrigger 代替
- */
-export type IronLawTrigger = ConstraintTrigger;
-
-/**
- * @deprecated 使用 Constraint 代替
- */
-export interface IronLaw extends Constraint {
-  /** @deprecated 使用 level 代替 */
-  severity?: IronLawSeverity;
-}
-
 /**
  * 约束检查结果
  */
@@ -140,14 +89,6 @@ export interface ConstraintResult {
   checkedAt: Date;
 }
 
-/**
- * @deprecated 使用 ConstraintResult 代替
- */
-export interface IronLawResult extends ConstraintResult {
-  /** @deprecated */
-  law?: Constraint;
-}
-
 /**
  * 约束检查上下文
  */
@@ -283,11 +224,6 @@ export interface ConstraintContext {
   executionContext?: any;
 }
 
-/**
- * @deprecated 使用 ConstraintContext 代替
- */
-export type IronLawContext = ConstraintContext;
-
 /**
  * 约束违规错误
  */
@@ -301,16 +237,6 @@ export class ConstraintViolationError extends Error {
   }
 }
 
-/**
- * @deprecated 使用 ConstraintViolationError 代替
- */
-export class IronLawViolationError extends ConstraintViolationError {
-  constructor(result: ConstraintResult) {
-    super(result);
-    this.name = 'IronLawViolationError';
-  }
-}
-
 /**
  * 三层约束检查结果
  */
@@ -333,3 +259,8 @@ export interface ConstraintCheckResult {
   /** 提示数量 */
   tipCount: number;
 }
+
+/**
+ * studio 兼容别名(P0 护栏):等价于 ConstraintContext
+ */
+export type IronLawContext = ConstraintContext;