evo-skills 0.1.0

package/src/types/index.ts

@@ -0,0 +1,212 @@
+/**
+ * 全局类型定义入口
+ */
+
+// Origin Skill 类型
+export interface OriginSkill {
+  skill_id: string;
+  origin_path: string;
+  origin_version: string; // file hash
+  source: 'local' | 'marketplace' | 'git';
+  installed_at: string;
+  last_seen_at: string;
+}
+
+// Shadow Skill 状态
+export type ShadowStatus = 'active' | 'frozen' | 'rebasing' | 'needs_attention';
+
+// Project Skill Shadow 类型
+export interface ProjectSkillShadow {
+  project_id: string;
+  skill_id: string;
+  shadow_id: string; // "A@repo-x"
+  origin_skill_id: string;
+  origin_version_at_fork: string;
+  shadow_path: string;
+  current_revision: number;
+  status: ShadowStatus;
+  created_at: string;
+  last_optimized_at: string;
+}
+
+// Shadow Skill 运行状态
+export interface ShadowSkillState {
+  shadow_id: string;
+  current_content_hash: string;
+  current_revision: number;
+  last_hit_at: string;
+  last_optimized_at: string;
+  hit_count: number;
+  success_count: number;
+  manual_override_count: number;
+  health_score: number; // 0-100
+}
+
+// Change Type - Patch 类型
+export type ChangeType =
+  | 'append_context'
+  | 'tighten_trigger'
+  | 'add_fallback'
+  | 'prune_noise'
+  | 'rewrite_section';
+
+// Evolution Record 演化记录
+export interface EvolutionRecord {
+  revision: number;
+  shadow_id: string;
+  timestamp: string;
+  reason: string;
+  source_sessions: string[];
+  change_type: ChangeType;
+  patch: string;
+  before_hash: string;
+  after_hash: string;
+  applied_by: 'auto' | 'manual';
+}
+
+// Snapshot 信息
+export interface SnapshotInfo {
+  revision: number;
+  timestamp: string;
+  file_path: string;
+  content_hash: string;
+}
+
+// Trace 事件类型
+export type TraceEventType =
+  | 'user_input'
+  | 'assistant_output'
+  | 'tool_call'
+  | 'tool_result'
+  | 'file_change'
+  | 'retry'
+  | 'status';
+
+// Trace 状态
+export type TraceStatus = 'success' | 'failure' | 'retry' | 'interrupted';
+
+// Runtime 类型
+export type RuntimeType = 'codex' | 'opencode' | 'claude';
+
+// Trace 数据结构
+export interface Trace {
+  trace_id: string;
+  runtime: RuntimeType;
+  session_id: string;
+  turn_id: string;
+  event_type: TraceEventType;
+  timestamp: string;
+  user_input?: string;
+  assistant_output?: string;
+  tool_name?: string;
+  tool_args?: Record<string, unknown>;
+  tool_result?: Record<string, unknown>;
+  files_changed?: string[];
+  status: TraceStatus;
+  metadata?: Record<string, unknown>;
+}
+
+// Evaluation Result 评估结果
+export interface EvaluationResult {
+  should_patch: boolean;
+  change_type?: ChangeType;
+  reason?: string;
+  source_sessions: string[];
+  confidence: number; // 0-1
+  target_section?: string;
+}
+
+// Patch Result
+export interface PatchResult {
+  success: boolean;
+  patch: string; // unified diff
+  newContent: string;
+  changeType: ChangeType;
+  error?: string;
+}
+
+// Auto Optimize Policy 自动优化策略
+export interface AutoOptimizePolicy {
+  min_signal_count: number;
+  min_source_sessions: number;
+  min_confidence: number;
+  cooldown_hours: number;
+  max_patches_per_day: number;
+  pause_after_rollback_hours: number;
+}
+
+// Session 信息
+export interface Session {
+  session_id: string;
+  runtime: RuntimeType;
+  project_id: string | null;
+  started_at: string;
+  ended_at: string | null;
+  trace_count: number;
+}
+
+// Snapshot 详情（包含内容）
+export interface Snapshot extends SnapshotInfo {
+  shadow_id: string;
+  content: string;
+}
+
+// Journal 查询选项
+export interface JournalQueryOptions {
+  fromRevision?: number;
+  toRevision?: number;
+  limit?: number;
+  changeType?: ChangeType;
+}
+
+// CLI 输出格式
+export interface CliOutput {
+  success: boolean;
+  message: string;
+  data?: unknown;
+  error?: string;
+}
+
+// 配置类型
+export interface EVOConfig {
+  origin_paths: {
+    paths: string[];
+  };
+  observer: {
+    enabled_runtimes: RuntimeType[];
+    trace_retention_days: number;
+  };
+  evaluator: {
+    min_signal_count: number;
+    min_source_sessions: number;
+    min_confidence: number;
+  };
+  patch: {
+    allowed_types: ChangeType[];
+    cooldown_hours: number;
+    max_patches_per_day: number;
+  };
+  journal: {
+    snapshot_interval: number;
+    max_snapshots: number;
+  };
+  daemon: {
+    auto_start: boolean;
+    log_level: 'debug' | 'info' | 'warn' | 'error';
+  };
+}
+
+// 项目配置
+export interface ProjectConfig {
+  project: {
+    name: string;
+    auto_optimize: boolean;
+  };
+  skills: Record<
+    string,
+    {
+      auto_optimize?: boolean;
+      allowed_patch_types?: ChangeType[];
+    }
+  >;
+}

package/src/utils/diff.ts

@@ -0,0 +1,60 @@
+import { diffLines, createPatch } from 'diff';
+
+/**
+ * 计算两个字符串的差异
+ */
+export function computeDiff(oldContent: string, newContent: string): string {
+  const differences = diffLines(oldContent, newContent);
+  return differences
+    .map((part) => {
+      const prefix = part.added ? '+' : part.removed ? '-' : ' ';
+      return part.value
+        .split('\n')
+        .filter((line) => line.length > 0)
+        .map((line) => `${prefix} ${line}`)
+        .join('\n');
+    })
+    .join('\n');
+}
+
+/**
+ * 生成 unified diff 格式的 patch
+ */
+export function createUnifiedDiff(
+  fileName: string,
+  oldContent: string,
+  newContent: string,
+  oldHeader?: string,
+  newHeader?: string
+): string {
+  return createPatch(fileName, oldContent, newContent, oldHeader, newHeader);
+}
+
+/**
+ * 检查内容是否有变化
+ */
+export function hasChanges(oldContent: string, newContent: string): boolean {
+  return oldContent !== newContent;
+}
+
+/**
+ * 统计差异行数
+ */
+export function countChanges(oldContent: string, newContent: string): {
+  added: number;
+  removed: number;
+} {
+  const differences = diffLines(oldContent, newContent);
+  let added = 0;
+  let removed = 0;
+
+  for (const part of differences) {
+    if (part.added) {
+      added += part.count ?? 0;
+    } else if (part.removed) {
+      removed += part.count ?? 0;
+    }
+  }
+
+  return { added, removed };
+}

package/src/utils/hash.ts

@@ -0,0 +1,31 @@
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+
+/**
+ * 计算字符串的 SHA256 哈希
+ */
+export function hashString(content: string): string {
+  return createHash('sha256').update(content).digest('hex');
+}
+
+/**
+ * 计算文件的 SHA256 哈希
+ */
+export function hashFile(filePath: string): string {
+  const content = readFileSync(filePath, 'utf-8');
+  return hashString(content);
+}
+
+/**
+ * 计算 Buffer 的 SHA256 哈希
+ */
+export function hashBuffer(buffer: Buffer): string {
+  return createHash('sha256').update(buffer).digest('hex');
+}
+
+/**
+ * 生成短哈希（前 8 位）
+ */
+export function shortHash(content: string): string {
+  return hashString(content).substring(0, 8);
+}

package/src/utils/index.ts

@@ -0,0 +1,8 @@
+/**
+ * 工具函数库入口
+ */
+
+export * from './hash.js';
+export * from './diff.js';
+export * from './path.js';
+export * from './logger.js';

package/src/utils/logger.ts

@@ -0,0 +1,78 @@
+import winston from 'winston';
+import { join } from 'node:path';
+import { existsSync, mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+
+const LOG_DIR = join(homedir(), '.evo', 'logs');
+
+/**
+ * 创建日志目录
+ */
+function ensureLogDir(): void {
+  if (!existsSync(LOG_DIR)) {
+    mkdirSync(LOG_DIR, { recursive: true });
+  }
+}
+
+/**
+ * 自定义日志格式
+ */
+const logFormat = winston.format.combine(
+  winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
+  winston.format.errors({ stack: true }),
+  winston.format.printf(({ timestamp, level, message, stack }) => {
+    const baseMessage = `[${timestamp}] ${level.toUpperCase()}: ${message}`;
+    return stack ? `${baseMessage}\n${stack}` : baseMessage;
+  })
+);
+
+/**
+ * 创建主 logger
+ */
+function createLogger(): winston.Logger {
+  ensureLogDir();
+
+  return winston.createLogger({
+    level: 'info',
+    format: logFormat,
+    transports: [
+      // 文件日志
+      new winston.transports.File({
+        filename: join(LOG_DIR, 'error.log'),
+        level: 'error',
+        maxsize: 5 * 1024 * 1024, // 5MB
+        maxFiles: 5,
+      }),
+      new winston.transports.File({
+        filename: join(LOG_DIR, 'combined.log'),
+        maxsize: 10 * 1024 * 1024, // 10MB
+        maxFiles: 10,
+      }),
+      // 控制台日志（仅在开发环境）
+      new winston.transports.Console({
+        format: winston.format.combine(
+          winston.format.colorize(),
+          logFormat
+        ),
+        silent: process.env.NODE_ENV === 'production',
+      }),
+    ],
+  });
+}
+
+// 导出单例 logger
+export const logger = createLogger();
+
+/**
+ * 创建带上下文的 logger
+ */
+export function createChildLogger(context: string): winston.Logger {
+  return logger.child({ context });
+}
+
+/**
+ * 设置日志级别
+ */
+export function setLogLevel(level: string): void {
+  logger.level = level;
+}

package/src/utils/path.ts

@@ -0,0 +1,129 @@
+import { join, resolve, relative, dirname, basename, extname } from 'node:path';
+import { existsSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+
+/**
+ * 展开路径中的 ~ 为用户主目录
+ */
+export function expandHome(path: string): string {
+  if (path.startsWith('~/') || path === '~') {
+    return path.replace('~', homedir());
+  }
+  return path;
+}
+
+/**
+ * 获取项目的 .evo 目录路径
+ */
+export function getEvoDir(projectRoot: string): string {
+  return join(projectRoot, '.evo');
+}
+
+/**
+ * 获取项目的 skills 目录路径
+ */
+export function getSkillsDir(projectRoot: string): string {
+  return join(projectRoot, '.evo', 'skills');
+}
+
+/**
+ * 获取项目的 state 目录路径
+ */
+export function getStateDir(projectRoot: string): string {
+  return join(projectRoot, '.evo', 'state');
+}
+
+/**
+ * 获取项目的 config 目录路径
+ */
+export function getConfigDir(projectRoot: string): string {
+  return join(projectRoot, '.evo', 'config');
+}
+
+/**
+ * 获取 shadow skill 的路径
+ */
+export function getShadowSkillPath(projectRoot: string, skillId: string): string {
+  return join(projectRoot, '.evo', 'skills', skillId, 'current.md');
+}
+
+/**
+ * 获取 shadow skill 的 meta.json 路径
+ */
+export function getShadowMetaPath(projectRoot: string, skillId: string): string {
+  return join(projectRoot, '.evo', 'skills', skillId, 'meta.json');
+}
+
+/**
+ * 获取 shadow skill 的 journal 路径
+ */
+export function getShadowJournalPath(projectRoot: string, skillId: string): string {
+  return join(projectRoot, '.evo', 'skills', skillId, 'journal.ndjson');
+}
+
+/**
+ * 获取 shadow skill 的 snapshots 目录路径
+ */
+export function getSnapshotsDir(projectRoot: string, skillId: string): string {
+  return join(projectRoot, '.evo', 'skills', skillId, 'snapshots');
+}
+
+/**
+ * 检查路径是否存在
+ */
+export function pathExists(path: string): boolean {
+  return existsSync(path);
+}
+
+/**
+ * 检查是否是目录
+ */
+export function isDirectory(path: string): boolean {
+  try {
+    return statSync(path).isDirectory();
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 检查是否是文件
+ */
+export function isFile(path: string): boolean {
+  try {
+    return statSync(path).isFile();
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 获取相对路径
+ */
+export function getRelativePath(from: string, to: string): string {
+  return relative(from, to);
+}
+
+/**
+ * 获取文件扩展名
+ */
+export function getExtension(path: string): string {
+  return extname(path);
+}
+
+/**
+ * 获取文件名（不含扩展名）
+ */
+export function getFileNameWithoutExt(path: string): string {
+  return basename(path, extname(path));
+}
+
+/**
+ * 获取目录名
+ */
+export function getDirName(path: string): string {
+  return dirname(path);
+}
+
+// 重新导出常用的 path 函数
+export { join, resolve, relative, dirname, basename, extname };

package/tests/unit/config.test.ts

@@ -0,0 +1,65 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { ConfigManager } from '../../src/config/index.js';
+import { DEFAULT_CONFIG } from '../../src/config/defaults.js';
+
+describe('Config Manager', () => {
+  let configManager: ConfigManager;
+
+  beforeEach(() => {
+    configManager = new ConfigManager();
+  });
+
+  describe('getGlobalConfig', () => {
+    it('should return default config initially', () => {
+      const config = configManager.getGlobalConfig();
+      expect(config).toEqual(DEFAULT_CONFIG);
+    });
+
+    it('should return a copy of config', () => {
+      const config1 = configManager.getGlobalConfig();
+      const config2 = configManager.getGlobalConfig();
+      expect(config1).not.toBe(config2);
+      expect(config1).toEqual(config2);
+    });
+  });
+
+  describe('getEvaluatorConfig', () => {
+    it('should return evaluator config', () => {
+      const config = configManager.getEvaluatorConfig();
+      expect(config).toHaveProperty('min_signal_count');
+      expect(config).toHaveProperty('min_source_sessions');
+      expect(config).toHaveProperty('min_confidence');
+    });
+  });
+
+  describe('getPatchConfig', () => {
+    it('should return patch config', () => {
+      const config = configManager.getPatchConfig();
+      expect(config).toHaveProperty('allowed_types');
+      expect(config).toHaveProperty('cooldown_hours');
+      expect(config).toHaveProperty('max_patches_per_day');
+    });
+  });
+
+  describe('getJournalConfig', () => {
+    it('should return journal config', () => {
+      const config = configManager.getJournalConfig();
+      expect(config).toHaveProperty('snapshot_interval');
+      expect(config).toHaveProperty('max_snapshots');
+    });
+  });
+
+  describe('isSkillFrozen', () => {
+    it('should return false when no project config', () => {
+      const result = configManager.isSkillFrozen('test-skill');
+      expect(result).toBe(false);
+    });
+  });
+
+  describe('getAllowedPatchTypes', () => {
+    it('should return default patch types when no project config', () => {
+      const types = configManager.getAllowedPatchTypes('test-skill');
+      expect(types).toEqual(DEFAULT_CONFIG.patch.allowed_types);
+    });
+  });
+});

package/tests/unit/path.test.ts

@@ -0,0 +1,89 @@
+import { describe, it, expect } from 'vitest';
+import {
+  expandHome,
+  getEvoDir,
+  getSkillsDir,
+  getStateDir,
+  getConfigDir,
+  getShadowSkillPath,
+  getShadowMetaPath,
+  getShadowJournalPath,
+  getSnapshotsDir,
+  join,
+} from '../../src/utils/path.js';
+import { homedir } from 'node:os';
+
+describe('Path Utils', () => {
+  describe('expandHome', () => {
+    it('should expand ~ to home directory', () => {
+      const result = expandHome('~/test');
+      expect(result).toBe(join(homedir(), 'test'));
+    });
+
+    it('should handle ~ alone', () => {
+      const result = expandHome('~');
+      expect(result).toBe(homedir());
+    });
+
+    it('should not modify paths without ~', () => {
+      const result = expandHome('/absolute/path');
+      expect(result).toBe('/absolute/path');
+    });
+  });
+
+  describe('getEvoDir', () => {
+    it('should return .evo directory path', () => {
+      const result = getEvoDir('/project');
+      expect(result).toBe('/project/.evo');
+    });
+  });
+
+  describe('getSkillsDir', () => {
+    it('should return .evo/skills directory path', () => {
+      const result = getSkillsDir('/project');
+      expect(result).toBe('/project/.evo/skills');
+    });
+  });
+
+  describe('getStateDir', () => {
+    it('should return .evo/state directory path', () => {
+      const result = getStateDir('/project');
+      expect(result).toBe('/project/.evo/state');
+    });
+  });
+
+  describe('getConfigDir', () => {
+    it('should return .evo/config directory path', () => {
+      const result = getConfigDir('/project');
+      expect(result).toBe('/project/.evo/config');
+    });
+  });
+
+  describe('getShadowSkillPath', () => {
+    it('should return shadow skill path', () => {
+      const result = getShadowSkillPath('/project', 'my-skill');
+      expect(result).toBe('/project/.evo/skills/my-skill/current.md');
+    });
+  });
+
+  describe('getShadowMetaPath', () => {
+    it('should return shadow meta path', () => {
+      const result = getShadowMetaPath('/project', 'my-skill');
+      expect(result).toBe('/project/.evo/skills/my-skill/meta.json');
+    });
+  });
+
+  describe('getShadowJournalPath', () => {
+    it('should return shadow journal path', () => {
+      const result = getShadowJournalPath('/project', 'my-skill');
+      expect(result).toBe('/project/.evo/skills/my-skill/journal.ndjson');
+    });
+  });
+
+  describe('getSnapshotsDir', () => {
+    it('should return snapshots directory path', () => {
+      const result = getSnapshotsDir('/project', 'my-skill');
+      expect(result).toBe('/project/.evo/skills/my-skill/snapshots');
+    });
+  });
+});