agent-configs 1.0.0

package/bundles/continuous-learning/.claude/lib/learning.js

@@ -0,0 +1,559 @@
+/**
+ * Continuous Learning - 核心学习模块
+ * 
+ * 提供 patterns/skills/instincts 的存储、检索、管理功能
+ */
+
+const fs = require('fs');
+const path = require('path');
+const {
+  ensureDir,
+  findFiles,
+  readFile,
+  writeFile,
+  appendJsonl,
+  readJsonl,
+  getFileSizeMB,
+  getDateString,
+  getTimestamp,
+  getWorkspaceRoot,
+  getHomeDir,
+  expandPath,
+  toSafeFilename
+} = require('./utils');
+
+// ============== 默认配置 ==============
+
+const DEFAULT_CONFIG = {
+  // v1 配置 - 简单版 (Stop hook)
+  v1: {
+    min_session_length: 10,
+    extraction_threshold: 'medium',
+    auto_approve: false,
+    learned_skills_path: '~/.claude/skills/learned/',
+    patterns_to_detect: [
+      'error_resolution',
+      'user_corrections',
+      'workarounds',
+      'debugging_techniques',
+      'project_specific'
+    ],
+    ignore_patterns: [
+      'simple_typos',
+      'one_time_fixes',
+      'external_api_issues'
+    ]
+  },
+  
+  // v2 配置 - 高级版 (PreToolUse/PostToolUse hooks)
+  v2: {
+    observation: {
+      enabled: true,
+      store_path: '~/.claude/homunculus/observations.jsonl',
+      max_file_size_mb: 10,
+      archive_after_days: 7,
+      capture_tools: ['Edit', 'Write', 'Bash', 'Read', 'Grep', 'Glob'],
+      ignore_tools: ['TodoWrite']
+    },
+    instincts: {
+      personal_path: '~/.claude/homunculus/instincts/personal/',
+      inherited_path: '~/.claude/homunculus/instincts/inherited/',
+      min_confidence: 0.3,
+      auto_approve_threshold: 0.7,
+      confidence_decay_rate: 0.02,
+      max_instincts: 100
+    },
+    evolution: {
+      cluster_threshold: 3,
+      evolved_path: '~/.claude/homunculus/evolved/',
+      auto_evolve: false
+    }
+  }
+};
+
+// ============== 路径管理 ==============
+
+/**
+ * 获取 learned skills 目录
+ */
+function getLearnedSkillsDir(config = DEFAULT_CONFIG.v1) {
+  return expandPath(config.learned_skills_path);
+}
+
+/**
+ * 获取 homunculus 根目录 (v2)
+ */
+function getHomunculusDir() {
+  return expandPath('~/.claude/homunculus');
+}
+
+/**
+ * 获取 observations 文件路径 (v2)
+ */
+function getObservationsPath(config = DEFAULT_CONFIG.v2) {
+  return expandPath(config.observation.store_path);
+}
+
+/**
+ * 获取 instincts 目录 (v2)
+ */
+function getInstinctsDir(type = 'personal', config = DEFAULT_CONFIG.v2) {
+  if (type === 'inherited') {
+    return expandPath(config.instincts.inherited_path);
+  }
+  return expandPath(config.instincts.personal_path);
+}
+
+/**
+ * 获取 evolved 目录 (v2)
+ */
+function getEvolvedDir(type, config = DEFAULT_CONFIG.v2) {
+  const base = expandPath(config.evolution.evolved_path);
+  if (type) {
+    return path.join(base, type);
+  }
+  return base;
+}
+
+/**
+ * 确保所有学习目录存在
+ */
+function ensureLearningDirs(config = DEFAULT_CONFIG) {
+  // v1 目录
+  ensureDir(getLearnedSkillsDir(config.v1));
+  
+  // v2 目录
+  ensureDir(getHomunculusDir());
+  ensureDir(getInstinctsDir('personal', config.v2));
+  ensureDir(getInstinctsDir('inherited', config.v2));
+  ensureDir(getEvolvedDir('skills', config.v2));
+  ensureDir(getEvolvedDir('commands', config.v2));
+  ensureDir(getEvolvedDir('agents', config.v2));
+  ensureDir(path.dirname(getObservationsPath(config.v2)));
+}
+
+// ============== Learned Skills (v1) ==============
+
+/**
+ * 生成 learned skill 文件名
+ */
+function generateSkillFilename(name) {
+  return `${toSafeFilename(name)}.md`;
+}
+
+/**
+ * 生成 learned skill 内容
+ */
+function generateSkillContent(data) {
+  const {
+    name,
+    context = '',
+    problem = '',
+    solution = '',
+    example = '',
+    triggers = []
+  } = data;
+  
+  const date = getDateString();
+  
+  return `# ${name}
+
+**Extracted:** ${date}
+**Context:** ${context}
+
+## Problem
+${problem}
+
+## Solution
+${solution}
+
+## Example
+${example || '(No example provided)'}
+
+## When to Use
+${triggers.length > 0 ? triggers.map(t => `- ${t}`).join('\n') : '(Trigger conditions not specified)'}
+`;
+}
+
+/**
+ * 保存 learned skill
+ */
+function saveLearnedSkill(data, config = DEFAULT_CONFIG.v1) {
+  try {
+    const skillsDir = getLearnedSkillsDir(config);
+    ensureDir(skillsDir);
+    
+    const filename = generateSkillFilename(data.name);
+    const filePath = path.join(skillsDir, filename);
+    const content = generateSkillContent(data);
+    
+    writeFile(filePath, content);
+    
+    return {
+      success: true,
+      path: filePath,
+      filename
+    };
+  } catch (err) {
+    return {
+      success: false,
+      error: err.message
+    };
+  }
+}
+
+/**
+ * 列出所有 learned skills
+ */
+function listLearnedSkills(config = DEFAULT_CONFIG.v1) {
+  const skillsDir = getLearnedSkillsDir(config);
+  const files = findFiles(skillsDir, '*.md');
+  
+  return files.map(file => {
+    const content = readFile(file.path);
+    const nameMatch = content?.match(/^#\s+(.+)$/m);
+    const contextMatch = content?.match(/\*\*Context:\*\*\s*(.+)$/m);
+    
+    return {
+      path: file.path,
+      filename: path.basename(file.path),
+      name: nameMatch ? nameMatch[1] : path.basename(file.path, '.md'),
+      context: contextMatch ? contextMatch[1] : '',
+      mtime: file.mtime
+    };
+  });
+}
+
+// ============== Observations (v2) ==============
+
+/**
+ * 记录观察
+ */
+function recordObservation(data, config = DEFAULT_CONFIG.v2) {
+  const obsPath = getObservationsPath(config);
+  
+  // 检查文件大小，必要时归档
+  const sizeMB = getFileSizeMB(obsPath);
+  if (sizeMB >= config.observation.max_file_size_mb) {
+    archiveObservations(config);
+  }
+  
+  const observation = {
+    timestamp: getTimestamp(),
+    ...data
+  };
+  
+  appendJsonl(obsPath, observation);
+  return observation;
+}
+
+/**
+ * 归档旧的 observations
+ */
+function archiveObservations(config = DEFAULT_CONFIG.v2) {
+  const obsPath = getObservationsPath(config);
+  if (!fs.existsSync(obsPath)) return;
+  
+  const archiveDir = path.join(getHomunculusDir(), 'observations.archive');
+  ensureDir(archiveDir);
+  
+  const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+  const archivePath = path.join(archiveDir, `observations-${timestamp}.jsonl`);
+  
+  fs.renameSync(obsPath, archivePath);
+}
+
+/**
+ * 读取近期 observations
+ */
+function getRecentObservations(limit = 100, config = DEFAULT_CONFIG.v2) {
+  const obsPath = getObservationsPath(config);
+  const observations = readJsonl(obsPath);
+  
+  return observations.slice(-limit);
+}
+
+// ============== Instincts (v2) ==============
+
+/**
+ * 生成 instinct 文件名
+ */
+function generateInstinctFilename(id) {
+  return `${toSafeFilename(id)}.md`;
+}
+
+/**
+ * 生成 instinct 内容
+ */
+function generateInstinctContent(data) {
+  const {
+    id,
+    trigger = '',
+    confidence = 0.5,
+    domain = 'general',
+    source = 'session-observation',
+    action = '',
+    evidence = []
+  } = data;
+  
+  return `---
+id: ${id}
+trigger: "${trigger}"
+confidence: ${confidence}
+domain: "${domain}"
+source: "${source}"
+---
+
+# ${id.split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ')}
+
+## Action
+${action}
+
+## Evidence
+${evidence.length > 0 ? evidence.map(e => `- ${e}`).join('\n') : '- Initial observation'}
+`;
+}
+
+/**
+ * 保存 instinct
+ */
+function saveInstinct(data, config = DEFAULT_CONFIG.v2) {
+  try {
+    const instinctsDir = getInstinctsDir('personal', config);
+    ensureDir(instinctsDir);
+    
+    const filename = generateInstinctFilename(data.id);
+    const filePath = path.join(instinctsDir, filename);
+    const content = generateInstinctContent(data);
+    
+    writeFile(filePath, content);
+    
+    return {
+      success: true,
+      path: filePath,
+      filename
+    };
+  } catch (err) {
+    return {
+      success: false,
+      error: err.message
+    };
+  }
+}
+
+/**
+ * 解析 instinct 文件
+ */
+function parseInstinctFile(filePath) {
+  const content = readFile(filePath);
+  if (!content) return null;
+  
+  const instinct = {
+    path: filePath,
+    filename: path.basename(filePath)
+  };
+  
+  // 解析 frontmatter
+  const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+  if (frontmatterMatch) {
+    const frontmatter = frontmatterMatch[1];
+    
+    const idMatch = frontmatter.match(/^id:\s*(.+)$/m);
+    const triggerMatch = frontmatter.match(/^trigger:\s*"?(.+?)"?$/m);
+    const confidenceMatch = frontmatter.match(/^confidence:\s*(.+)$/m);
+    const domainMatch = frontmatter.match(/^domain:\s*"?(.+?)"?$/m);
+    const sourceMatch = frontmatter.match(/^source:\s*"?(.+?)"?$/m);
+    
+    if (idMatch) instinct.id = idMatch[1];
+    if (triggerMatch) instinct.trigger = triggerMatch[1];
+    if (confidenceMatch) instinct.confidence = parseFloat(confidenceMatch[1]);
+    if (domainMatch) instinct.domain = domainMatch[1];
+    if (sourceMatch) instinct.source = sourceMatch[1];
+  }
+  
+  // 解析 action
+  const actionMatch = content.match(/## Action\n([\s\S]*?)(?=\n## |$)/);
+  if (actionMatch) {
+    instinct.action = actionMatch[1].trim();
+  }
+  
+  // 解析 evidence
+  const evidenceMatch = content.match(/## Evidence\n([\s\S]*?)(?=\n## |$)/);
+  if (evidenceMatch) {
+    instinct.evidence = evidenceMatch[1]
+      .split('\n')
+      .filter(l => l.startsWith('- '))
+      .map(l => l.slice(2).trim());
+  }
+  
+  return instinct;
+}
+
+/**
+ * 列出所有 instincts
+ */
+function listInstincts(config = DEFAULT_CONFIG.v2) {
+  const personalDir = getInstinctsDir('personal', config);
+  const inheritedDir = getInstinctsDir('inherited', config);
+  
+  const personal = findFiles(personalDir, '*.md').map(f => ({
+    ...parseInstinctFile(f.path),
+    type: 'personal',
+    mtime: f.mtime
+  }));
+  
+  const inherited = findFiles(inheritedDir, '*.md').map(f => ({
+    ...parseInstinctFile(f.path),
+    type: 'inherited',
+    mtime: f.mtime
+  }));
+  
+  return [...personal, ...inherited].filter(Boolean);
+}
+
+/**
+ * 更新 instinct 置信度
+ */
+function updateInstinctConfidence(id, delta, config = DEFAULT_CONFIG.v2) {
+  const instinctsDir = getInstinctsDir('personal', config);
+  const filePath = path.join(instinctsDir, generateInstinctFilename(id));
+  
+  const instinct = parseInstinctFile(filePath);
+  if (!instinct) return null;
+  
+  const newConfidence = Math.max(0, Math.min(1, instinct.confidence + delta));
+  instinct.confidence = newConfidence;
+  
+  const content = generateInstinctContent(instinct);
+  writeFile(filePath, content);
+  
+  return instinct;
+}
+
+// ============== Evolution (v2) ==============
+
+/**
+ * 按 domain 分组 instincts
+ */
+function groupInstinctsByDomain(instincts) {
+  const groups = {};
+  
+  for (const instinct of instincts) {
+    const domain = instinct.domain || 'general';
+    if (!groups[domain]) {
+      groups[domain] = [];
+    }
+    groups[domain].push(instinct);
+  }
+  
+  return groups;
+}
+
+/**
+ * 查找可进化的 instinct 集群
+ */
+function findEvolvableClusters(instincts, config = DEFAULT_CONFIG.v2) {
+  const threshold = config.evolution.cluster_threshold;
+  const groups = groupInstinctsByDomain(instincts);
+  const clusters = [];
+  
+  for (const [domain, domainInstincts] of Object.entries(groups)) {
+    if (domainInstincts.length >= threshold) {
+      // 计算平均置信度
+      const avgConfidence = domainInstincts.reduce((sum, i) => sum + (i.confidence || 0.5), 0) / domainInstincts.length;
+      
+      // 确定进化类型
+      let evolutionType = 'skill';
+      const triggers = domainInstincts.map(i => i.trigger || '').join(' ');
+      
+      if (triggers.includes('user asks') || triggers.includes('when creating')) {
+        evolutionType = 'command';
+      } else if (domainInstincts.length >= 4 && avgConfidence >= 0.7) {
+        evolutionType = 'agent';
+      }
+      
+      clusters.push({
+        domain,
+        instincts: domainInstincts,
+        count: domainInstincts.length,
+        avgConfidence,
+        evolutionType,
+        suggestedName: `${domain}-${evolutionType}`
+      });
+    }
+  }
+  
+  return clusters;
+}
+
+// ============== 会话评估 ==============
+
+/**
+ * 检查会话是否值得评估
+ */
+function shouldEvaluateSession(messageCount, config = DEFAULT_CONFIG.v1) {
+  return messageCount >= config.min_session_length;
+}
+
+/**
+ * 获取学习状态摘要
+ */
+function getLearningStatus(config = DEFAULT_CONFIG) {
+  const learnedSkills = listLearnedSkills(config.v1);
+  const instincts = listInstincts(config.v2);
+  const observations = getRecentObservations(100, config.v2);
+  const clusters = findEvolvableClusters(instincts, config.v2);
+  
+  return {
+    v1: {
+      learnedSkillsCount: learnedSkills.length,
+      skills: learnedSkills
+    },
+    v2: {
+      instinctsCount: instincts.length,
+      instincts,
+      recentObservationsCount: observations.length,
+      evolvableClusters: clusters
+    }
+  };
+}
+
+module.exports = {
+  // 配置
+  DEFAULT_CONFIG,
+  
+  // 路径
+  getLearnedSkillsDir,
+  getHomunculusDir,
+  getObservationsPath,
+  getInstinctsDir,
+  getEvolvedDir,
+  ensureLearningDirs,
+  
+  // Learned Skills (v1)
+  generateSkillFilename,
+  generateSkillContent,
+  saveLearnedSkill,
+  listLearnedSkills,
+  
+  // Observations (v2)
+  recordObservation,
+  archiveObservations,
+  getRecentObservations,
+  
+  // Instincts (v2)
+  generateInstinctFilename,
+  generateInstinctContent,
+  saveInstinct,
+  parseInstinctFile,
+  listInstincts,
+  updateInstinctConfidence,
+  
+  // Evolution (v2)
+  groupInstinctsByDomain,
+  findEvolvableClusters,
+  
+  // 评估
+  shouldEvaluateSession,
+  getLearningStatus
+};