principles-disciple 1.126.0 → 1.128.0

package/src/core/evolution-logger.ts

@@ -1,357 +0,0 @@
-/**
- * EvolutionLogger - 进化流程日志服务
- *
- * 提供两层日志：
- * - 技术层：结构化 JSON，包含 trace_id、stage、metadata
- * - 用户层：中文摘要，便于小白用户理解
- *
- * 日志写入两个地方：
- * 1. SYSTEM_LOG (system.jsonl) - 技术细节
- * 2. evolution_events 表 (SQLite) - 结构化查询
- */
-
-import { randomBytes } from 'crypto';
-import type { TrajectoryDatabase } from './trajectory.js';
-import { SystemLogger } from './system-logger.js';
-
-export type EvolutionStage =
-  | 'pain_detected'      // 痛点检测到
-  | 'queued'             // 加入进化队列
-  | 'started'            // 任务开始处理
-  | 'analyzing'          // Diagnostician 分析中
-  | 'principle_generated'// 原则生成完成
-  | 'completed'          // 任务完成
-  | 'failed';            // 任务失败
-
-export type EvolutionLogLevel = 'debug' | 'info' | 'warn' | 'error';
-
-export interface EvolutionLogEntry {
-  traceId: string;                   // 关联一次完整进化流程
-  stage: EvolutionStage;             // 进化阶段
-  level: EvolutionLogLevel;          // 日志级别
-  message: string;                   // 技术细节（英文）
-  summary: string;                   // 用户友好摘要（中文）
-  timestamp: string;                 // ISO 8601
-  metadata?: Record<string, unknown>;// 额外上下文
-  taskId?: string;                   // 可选，关联任务 ID
-  sessionId?: string;                // 可选，关联会话 ID
-}
-
-export interface EvolutionLogInput {
-  traceId: string;
-  stage: EvolutionStage;
-  level?: EvolutionLogLevel;
-  message: string;
-  summary: string;
-  metadata?: Record<string, unknown>;
-  taskId?: string;
-  sessionId?: string;
-}
-
-// 阶段对应的中文标签
-export const STAGE_LABELS: Record<EvolutionStage, string> = {
-  pain_detected: '痛点检测',
-  queued: '加入队列',
-  started: '开始处理',
-  analyzing: '分析中',
-  principle_generated: '原则生成',
-  completed: '完成',
-  failed: '失败',
-};
-
-// 阶段对应的颜色（用于 UI）
-export const STAGE_COLORS: Record<EvolutionStage, string> = {
-  pain_detected: '#ef4444',  // 红色
-  queued: '#f59e0b',         // 橙色
-  started: '#3b82f6',        // 蓝色
-  analyzing: '#8b5cf6',      // 紫色
-  principle_generated: '#10b981', // 绿色
-  completed: '#22c55e',      // 绿色
-  failed: '#dc2626',         // 深红色
-};
-
-/**
- * 创建新的 trace_id
- * 格式: ev_{timestamp}_{random}
- * 使用 crypto.randomBytes 确保不可预测性
- */
-export function createTraceId(): string {
-  const timestamp = Date.now().toString(36);
-  const random = randomBytes(3).toString('hex');
-  return `ev_${timestamp}_${random}`;
-}
-
-/**
- * EvolutionLogger 类
- * 管理进化流程的日志记录
- */
-export class EvolutionLogger {
-  private readonly workspaceDir: string;
-  private readonly trajectory: TrajectoryDatabase | null;
-
-  constructor(workspaceDir: string, trajectory?: TrajectoryDatabase) {
-    this.workspaceDir = workspaceDir;
-    this.trajectory = trajectory || null;
-  }
-
-  /**
-   * 记录进化事件
-   * 同时写入 SYSTEM_LOG 和 evolution_events 表
-   */
-  log(input: EvolutionLogInput): void {
-    const entry: EvolutionLogEntry = {
-      ...input,
-      level: input.level || 'info',
-      timestamp: new Date().toISOString(),
-    };
-
-    // 1. 写入 SYSTEM_LOG (技术细节)
-    SystemLogger.log(this.workspaceDir, 'EVOLUTION', JSON.stringify({
-      traceId: entry.traceId,
-      stage: entry.stage,
-      level: entry.level,
-      message: entry.message,
-      taskId: entry.taskId,
-      sessionId: entry.sessionId,
-      metadata: entry.metadata,
-    }));
-
-    // 2. 写入 evolution_events 表 (如果有 trajectory)
-    if (this.trajectory) {
-      try {
-        this.trajectory.recordEvolutionEvent({
-          traceId: entry.traceId,
-          taskId: entry.taskId,
-          stage: entry.stage,
-          level: entry.level,
-          message: entry.message,
-          summary: entry.summary,
-          metadata: entry.metadata,
-          createdAt: entry.timestamp,
-        });
-      } catch (err) {
-        // Database write failure doesn't affect main flow, but log for diagnostics
-         
-        console.error(`[EvolutionLogger] Failed to write to trajectory: ${String(err)}`);
-      }
-    }
-  }
-
-  /**
-   * 记录 pain_detected 事件
-   */
-  logPainDetected(params: {
-    traceId: string;
-    source: string;
-    reason: string;
-    score: number;
-    toolName?: string;
-    filePath?: string;
-    sessionId?: string;
-  }): void {
-    this.log({
-      traceId: params.traceId,
-      stage: 'pain_detected',
-      level: 'info',
-      message: `Pain detected: ${params.source} - ${params.reason}`,
-      summary: `检测到痛点：${params.source} - ${params.reason}`,
-      metadata: {
-        score: params.score,
-        toolName: params.toolName,
-        filePath: params.filePath,
-      },
-      sessionId: params.sessionId,
-    });
-  }
-
-  /**
-   * 记录 queued 事件
-   */
-  logQueued(params: {
-    traceId: string;
-    taskId: string;
-    score: number;
-    source: string;
-    reason: string;
-  }): void {
-    this.log({
-      traceId: params.traceId,
-      taskId: params.taskId,
-      stage: 'queued',
-      level: 'info',
-      message: `Task ${params.taskId} enqueued with score ${params.score}`,
-      summary: `任务 ${params.taskId} 已加入进化队列，优先级分数 ${params.score}`,
-      metadata: {
-        score: params.score,
-        source: params.source,
-        reason: params.reason,
-      },
-    });
-  }
-
-  /**
-   * 记录 started 事件
-   */
-  logStarted(params: {
-    traceId: string;
-    taskId: string;
-  }): void {
-    this.log({
-      traceId: params.traceId,
-      taskId: params.taskId,
-      stage: 'started',
-      level: 'info',
-      message: `Task ${params.taskId} started processing`,
-      summary: `任务 ${params.taskId} 开始处理，Diagnostician 正在分析...`,
-    });
-  }
-
-  /**
-   * 记录 analyzing 事件
-   */
-  logAnalyzing(params: {
-    traceId: string;
-    taskId: string;
-    analysisType?: string;
-  }): void {
-    this.log({
-      traceId: params.traceId,
-      taskId: params.taskId,
-      stage: 'analyzing',
-      level: 'info',
-      message: `Task ${params.taskId} analysis started`,
-      summary: `任务 ${params.taskId} 正在分析根因...`,
-      metadata: {
-        analysisType: params.analysisType,
-      },
-    });
-  }
-
-  /**
-   * 记录 principle_generated 事件
-   */
-  logPrincipleGenerated(params: {
-    traceId: string;
-    taskId: string;
-    principleId: string;
-    principleText: string;
-  }): void {
-    const truncatedText = params.principleText.length > 100
-      ? params.principleText.substring(0, 100) + '...'
-      : params.principleText;
-
-    this.log({
-      traceId: params.traceId,
-      taskId: params.taskId,
-      stage: 'principle_generated',
-      level: 'info',
-      message: `Principle ${params.principleId} generated for task ${params.taskId}`,
-      summary: `生成新原则：${truncatedText}`,
-      metadata: {
-        principleId: params.principleId,
-        principleText: params.principleText,
-      },
-    });
-  }
-
-  /**
-   * 记录 completed 事件
-   */
-  logCompleted(params: {
-    traceId: string;
-    taskId: string;
-    resolution: 'marker_detected' | 'auto_completed_timeout' | 'manual' | 'late_marker_principle_created' | 'late_marker_no_principle' | 'diagnostician_timeout' | 'noise_classified' | 'duplicate' | 'serverDuplicate';
-    durationMs?: number;
-    principlesGenerated?: number;
-  }): void {
-     
-     
-    let summary: string;
-    if (params.resolution === 'marker_detected' || params.resolution === 'late_marker_principle_created') {
-      summary = `任务 ${params.taskId} 完成，已生成 ${params.principlesGenerated || 0} 条原则`;
-    } else if (params.resolution === 'auto_completed_timeout' || params.resolution === 'diagnostician_timeout' || params.resolution === 'late_marker_no_principle') {
-      summary = `任务 ${params.taskId} 超时自动完成`;
-    } else if (params.resolution === 'noise_classified' || params.resolution === 'duplicate' || params.resolution === 'serverDuplicate') {
-      summary = `任务 ${params.taskId} 分类为噪音/重复，已过滤`;
-    } else {
-      summary = `任务 ${params.taskId} 已完成`;
-    }
-
-    this.log({
-      traceId: params.traceId,
-      taskId: params.taskId,
-      stage: 'completed',
-      level: params.resolution === 'auto_completed_timeout' ? 'warn' : 'info',
-      message: `Task ${params.taskId} completed with resolution: ${params.resolution}`,
-      summary,
-      metadata: {
-        resolution: params.resolution,
-        durationMs: params.durationMs,
-        principlesGenerated: params.principlesGenerated,
-      },
-    });
-  }
-
-  /**
-   * 记录 failed 事件
-   */
-  logFailed(params: {
-    traceId: string;
-    taskId: string;
-    error: string;
-    stack?: string;
-  }): void {
-    this.log({
-      traceId: params.traceId,
-      taskId: params.taskId,
-      stage: 'failed',
-      level: 'error',
-      message: `Task ${params.taskId} failed: ${params.error}`,
-      summary: `任务 ${params.taskId} 失败：${params.error}`,
-      metadata: {
-        error: params.error,
-        stack: params.stack,
-      },
-    });
-  }
-}
-
-// 单例缓存：键格式为 "workspaceDir" 或 "workspaceDir::with_trajectory"
-const loggerCache = new Map<string, EvolutionLogger>();
-
-/**
- * 获取 EvolutionLogger 实例（单例）
- * 
- * 注意：带 trajectory 和不带 trajectory 的请求会返回不同的实例，
- * 因为 trajectory 影响事件持久化行为。
- */
-export function getEvolutionLogger(
-  workspaceDir: string,
-  trajectory?: TrajectoryDatabase
-): EvolutionLogger {
-  // 缓存键区分是否带 trajectory，避免持久化行为不一致
-  const cacheKey = trajectory ? `${workspaceDir}::with_trajectory` : workspaceDir;
-  const cached = loggerCache.get(cacheKey);
-  if (cached) {
-    return cached;
-  }
-  const logger = new EvolutionLogger(workspaceDir, trajectory);
-  loggerCache.set(cacheKey, logger);
-  return logger;
-}
-
-/**
- * 清理指定 workspace 的 logger 缓存
- */
-export function disposeEvolutionLogger(workspaceDir: string): boolean {
-  const plain = loggerCache.delete(workspaceDir);
-  const withTrajectory = loggerCache.delete(`${workspaceDir}::with_trajectory`);
-  return plain || withTrajectory;
-}
-
-/**
- * 清理所有 logger 缓存（用于测试或进程退出）
- */
-export function disposeAllEvolutionLoggers(): void {
-  loggerCache.clear();
-}

package/src/core/evolution-migration.ts

@@ -1,77 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import type { EvolutionLoopEvent } from './evolution-types.js';
-import { stableContentHash } from './evolution-reducer.js';
-import { SystemLogger } from './system-logger.js';
-
-export interface MigrationResult {
-  importedEvents: number;
-  streamPath: string;
-}
-
-function appendEvent(streamPath: string, event: EvolutionLoopEvent): void {
-  fs.appendFileSync(streamPath, `${JSON.stringify(event)}\n`, 'utf8');
-}
-
-function loadImportedHashes(streamPath: string, workspaceDir: string): Set<string> {
-  if (!fs.existsSync(streamPath)) return new Set();
-  const raw = fs.readFileSync(streamPath, 'utf8').trim();
-  if (!raw) return new Set();
-
-  const hashes = new Set<string>();
-  for (const line of raw.split('\n')) {
-    try {
-      const event = JSON.parse(line) as EvolutionLoopEvent;
-      if (event.type !== 'legacy_import') continue;
-      const hash = event.data.contentHash;
-      if (typeof hash === 'string') hashes.add(hash);
-    } catch (e) {
-      SystemLogger.log(workspaceDir, 'MIGRATION_WARN', `skip malformed line: ${String(e)}`);
-    }
-  }
-  return hashes;
-}
-
-export function migrateLegacyEvolutionData(workspaceDir: string): MigrationResult {
-  const streamPath = path.join(workspaceDir, 'memory', 'evolution.jsonl');
-  fs.mkdirSync(path.dirname(streamPath), { recursive: true });
-
-  const candidates: string[] = [
-    path.join(workspaceDir, 'memory', 'ISSUE_LOG.md'),
-    path.join(workspaceDir, 'memory', 'DECISIONS.md'),
-    path.join(workspaceDir, '.principles', 'PRINCIPLES.md'),
-  ];
-
-  const existingHashes = loadImportedHashes(streamPath, workspaceDir);
-  let importedEvents = 0;
-
-  for (const sourceFile of candidates) {
-    if (!fs.existsSync(sourceFile)) {
-      continue;
-    }
-
-    const content = fs.readFileSync(sourceFile, 'utf8').trim();
-    if (!content) {
-      continue;
-    }
-
-    const contentHash = stableContentHash(`${sourceFile}:${content}`);
-    if (existingHashes.has(contentHash)) {
-      continue;
-    }
-
-    appendEvent(streamPath, {
-      ts: new Date().toISOString(),
-      type: 'legacy_import',
-      data: {
-        sourceFile: path.relative(workspaceDir, sourceFile),
-        content,
-        contentHash,
-      },
-    });
-    importedEvents += 1;
-    existingHashes.add(contentHash);
-  }
-
-  return { importedEvents, streamPath };
-}