sillyspec 3.20.2 → 3.20.3

package/src/knowledge-match.js

@@ -1,130 +0,0 @@
-/**
- * knowledge-match.js — knowledge 关键词匹配引擎
- * 从 INDEX.md 解析知识条目，按任务上下文匹配并生成 hit report
- */
-
-import { existsSync, readFileSync } from 'fs'
-import { join } from 'path'
-
-/**
- * 从 INDEX.md 解析所有知识条目
- * @param {string} indexDir - knowledge 目录路径
- * @returns {{ category: string, keywords: string[], file: string, anchor: string, display: string, line: string }[]}
- */
-export function parseKnowledgeIndex(indexDir) {
-  const indexPath = join(indexDir, 'INDEX.md')
-  if (!existsSync(indexPath)) return []
-
-  const content = readFileSync(indexPath, 'utf8')
-  const entries = []
-  let currentCategory = ''
-
-  for (const line of content.split('\n')) {
-    // 匹配 ## Category 行
-    const catMatch = line.match(/^##\s+(.+)/)
-    if (catMatch) {
-      currentCategory = catMatch[1].trim()
-      continue
-    }
-
-    // 匹配条目行：- 关键词1|关键词2 → [显示名](文件名#锚点)
-    const entryMatch = line.match(/^-\s+(.+?)\s*→\s*\[(.+?)\]\(([^#)]+)(?:#([^)]+))?\)/)
-    if (entryMatch) {
-      const keywords = entryMatch[1].split('|').map(k => k.trim()).filter(Boolean)
-      const display = entryMatch[2].trim()
-      const file = entryMatch[3].trim()
-      const anchor = entryMatch[4] ? entryMatch[4].trim() : ''
-      entries.push({ category: currentCategory, keywords, file, anchor, display, line })
-    }
-  }
-
-  return entries
-}
-
-function escapeRegex(s) {
-  return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
-}
-
-/**
- * 单个关键词是否命中上下文。
- * - 过短关键词（<2 字符）视为噪音，不参与匹配
- * - 非 ASCII（中文等）用子串匹配
- * - ASCII 关键词用词边界匹配，避免子串误命中（如 "DB" 不命中 "dashboard"）
- */
-function keywordMatchesContext(keyword, contextLower) {
-  const kw = keyword.toLowerCase().trim()
-  if (kw.length < 2) return false
-  if (/[^\x00-\x7f]/.test(kw)) return contextLower.includes(kw)
-  return new RegExp(`(^|[^a-z0-9])${escapeRegex(kw)}([^a-z0-9]|$)`).test(contextLower)
-}
-
-/**
- * 用任务上下文匹配知识条目
- * @param {string} indexDir - knowledge 目录路径
- * @param {string} taskContext - 任务上下文（task 名称 + 描述，用于关键词匹配）
- * @returns {{ matched: boolean, entries: Array, report: string, json: object }}
- */
-export function matchKnowledge(indexDir, taskContext) {
-  const indexPath = join(indexDir, 'INDEX.md')
-
-  // INDEX.md 不存在
-  if (!existsSync(indexPath)) {
-    return {
-      matched: false,
-      entries: [],
-      report: 'Status: no matches (INDEX.md not found)',
-      json: { matched: false, entry_count: 0, entries: [] }
-    }
-  }
-
-  const allEntries = parseKnowledgeIndex(indexDir)
-  if (allEntries.length === 0 || !taskContext) {
-    return {
-      matched: false,
-      entries: [],
-      report: 'Status: no matches',
-      json: { matched: false, entry_count: 0, entries: [] }
-    }
-  }
-
-  const contextLower = taskContext.toLowerCase()
-  const matched = allEntries.filter(entry => {
-    return entry.keywords.some(kw => keywordMatchesContext(kw, contextLower))
-  })
-
-  if (matched.length === 0) {
-    return {
-      matched: false,
-      entries: [],
-      report: 'Status: no matches',
-      json: { matched: false, entry_count: 0, entries: [] }
-    }
-  }
-
-  const sources = matched.map(e => {
-    const base = e.anchor ? `${e.file}#${e.anchor}` : e.file
-    return ` - ${base}`
-  }).join('\n')
-
-  const report = [
-    'Knowledge Context',
-    '─────────────────',
-    `Status: matched`,
-    `Entries: ${matched.length}`,
-    'Sources:',
-    sources
-  ].join('\n')
-
-  const json = {
-    matched: true,
-    entry_count: matched.length,
-    entries: matched.map(e => ({
-      file: e.file,
-      anchor: e.anchor,
-      keywords: e.keywords,
-      category: e.category
-    }))
-  }
-
-  return { matched: true, entries: matched, report, json }
-}

package/src/modules.js

@@ -1,482 +0,0 @@
-import { existsSync, readdirSync, readFileSync, writeFileSync } from 'fs';
-import { join } from 'path';
-import { DB } from './db.js';
-
-/**
- * 查找项目下的 _module-map.yaml 路径
- */
-function findModuleMapPath(cwd) {
-  // 查找 .sillyspec/docs/<project>/modules/_module-map.yaml
-  const docsDir = join(cwd, '.sillyspec', 'docs');
-  if (!existsSync(docsDir)) return null;
-
-  const projects = readdirSync(docsDir, { withFileTypes: true })
-    .filter(e => e.isDirectory());
-
-  for (const proj of projects) {
-    const mapPath = join(docsDir, proj.name, 'modules', '_module-map.yaml');
-    if (existsSync(mapPath)) return mapPath;
-  }
-
-  // 如果没有找到已有的，返回第一个项目的路径（用于创建）
-  if (projects.length > 0) {
-    return join(docsDir, projects[0].name, 'modules', '_module-map.yaml');
-  }
-
-  return null;
-}
-
-/**
- * 从模块卡片文件名提取 module_id
- */
-function parseModuleIdFromFilename(filename) {
-  return filename.replace(/\.md$/, '');
-}
-
-/**
- * 从模块卡片读取 frontmatter 中的 module_id
- */
-function parseModuleCardFrontmatter(content) {
-  const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
-  if (!fmMatch) return {};
-  const fm = fmMatch[1];
-  const moduleIdMatch = fm.match(/^module_id:\s*(.+)$/m);
-  return {
-    module_id: moduleIdMatch ? moduleIdMatch[1].trim() : null
-  };
-}
-
-/**
- * 从模块卡片 + 源码重建 _module-map.yaml
- *
- * schema_version 2 扩展字段：
- *   - role: 模块职责描述
- *   - core_files: 核心源文件列表
- *   - test_files: 测试文件列表
- *   - entrypoints: 入口点
- *   - depends_on: 依赖的其他模块
- *   - used_by: 被哪些模块使用
- *   - risk_level: 风险等级（low/medium/high）
- *   - verify_commands: 验证命令（build/test/lint）
- *   - related_docs: 关联文档路径
- */
-export async function rebuildModuleMap(cwd) {
-  const mapPath = findModuleMapPath(cwd);
-  if (!mapPath) {
-    console.error('❌ 未找到 .sillyspec/docs/<project>/modules/ 目录');
-    console.log('   提示：先运行 sillyspec run scan 生成模块文档');
-    return;
-  }
-
-  const modulesDir = join(mapPath, '..');
-  const existingMap = existsSync(mapPath) ? readFileSync(mapPath, 'utf8') : null;
-
-  // 收集现有模块卡片
-  const cards = [];
-  if (existsSync(modulesDir)) {
-    const files = readdirSync(modulesDir).filter(f => f.endsWith('.md') && f !== '_module-map.yaml');
-    for (const f of files) {
-      const content = readFileSync(join(modulesDir, f), 'utf8');
-      const fm = parseModuleCardFrontmatter(content);
-      const moduleId = fm.module_id || parseModuleIdFromFilename(f);
-      cards.push({ filename: f, moduleId });
-    }
-  }
-
-  // 解析现有 _module-map.yaml 保留已有字段
-  let existingModules = {};
-  if (existingMap) {
-    // 简单解析：提取 modules: 下的条目
-    const lines = existingMap.split('\n');
-    let currentModule = null;
-    let inModules = false;
-    for (const line of lines) {
-      if (line.startsWith('modules:')) { inModules = true; continue; }
-      if (!inModules) continue;
-      if (line.startsWith('  ') === false && line.trim() !== '') break;
-      const moduleMatch = line.match(/^  ([a-zA-Z0-9_-]+):/);
-      if (moduleMatch) {
-        currentModule = moduleMatch[1];
-        existingModules[currentModule] = existingModules[currentModule] || { paths: [] };
-      }
-    }
-  }
-
-  // 如果没有模块卡片也没有已有映射
-  if (cards.length === 0 && Object.keys(existingModules).length === 0) {
-    console.log('📭 没有模块卡片，也没有已有的模块映射');
-    console.log('   提示：先运行 sillyspec run scan 生成模块文档');
-    return;
-  }
-
-  // 生成新的 _module-map.yaml
-  // 保留已有的完整字段，补齐新卡片
-  const now = new Date().toISOString().replace('T', ' ').slice(0, 19);
-  let headCommit = '';
-  try {
-    const { execSync } = await import('child_process');
-    headCommit = execSync('git rev-parse --short HEAD', { cwd, encoding: 'utf8', timeout: 5000 }).trim();
-  } catch { /* ignore */ }
-
-  let yaml = `schema_version: 2\n`;
-  yaml += `generated_at: ${now}\n`;
-  yaml += `generator: sillyspec-modules-rebuild\n`;
-  if (headCommit) yaml += `source_commit: ${headCommit}\n`;
-  yaml += `\n# Module Context Index — 机器可读的模块上下文索引\n`;
-  yaml += `# scan 阶段自动生成，brainstorm/plan/execute 阶段按任务命中模块精准注入上下文\n`;
-  yaml += `\nmodules:\n`;
-
-  // 合并：已有映射 + 新卡片
-  const allModuleIds = new Set([
-    ...Object.keys(existingModules),
-    ...cards.map(c => c.moduleId)
-  ]);
-
-  for (const moduleId of allModuleIds) {
-    const card = cards.find(c => c.moduleId === moduleId);
-    const cardContent = card ? readFileSync(join(modulesDir, card.filename), 'utf8') : '';
-
-    // 从模块卡片提取 context index 字段
-    const role = extractSection(cardContent, '定位') || '';
-    const contract = extractSection(cardContent, '契约摘要') || '';
-    const logic = extractSection(cardContent, '关键逻辑') || '';
-    const notes = extractSection(cardContent, '注意事项') || '';
-
-    yaml += `  ${moduleId}:\n`;
-    yaml += `    status: active\n`;
-    if (card) yaml += `    doc: modules/${card.filename}\n`;
-    else yaml += `    doc: modules/${moduleId}.md\n`;
-    yaml += `    needs_review: false\n`;
-    yaml += `    review_reasons: []\n`;
-    // context index 字段（v2）
-    if (role) yaml += `    role: "${escapeYamlString(role)}"\n`;
-    // core_files / test_files / entrypoints 从已有 _module-map 保留，或从卡片文件名推导
-    const existingPaths = existingModules[moduleId]?.paths || [];
-    if (existingPaths.length > 0) {
-      yaml += `    core_files:\n`;
-      for (const p of existingPaths) yaml += `      - ${p}\n`;
-    }
-    if (card) yaml += `    verify_commands: []\n`;
-    yaml += `    risk_level: low\n`;
-    if (contract || logic) yaml += `    related_docs: []\n`;
-    yaml += `\n`;
-  }
-
-  writeFileSync(mapPath, yaml, 'utf8');
-  console.log(`✅ _module-map.yaml 已重建：${mapPath}`);
-  console.log(`   模块数量：${allModuleIds.size}`);
-  for (const id of allModuleIds) {
-    console.log(`   - ${id}`);
-  }
-  console.log(`\n⚠️  注意：rebuild 只重建骨架。tags/entrypoints/main_symbols/depends_on/used_by 需要重新运行 scan 或手动补充。`);
-  console.log(`ℹ️  schema 已升级到 v2，支持 role/core_files/test_files/entrypoints/depends_on/risk_level/verify_commands 等字段。`);
-}
-
-/**
- * status: 显示模块索引状态
- */
-export async function showModuleStatus(cwd) {
-  const mapPath = findModuleMapPath(cwd);
-  if (!mapPath || !existsSync(mapPath)) {
-    console.log('📭 未找到 _module-map.yaml');
-    console.log('   提示：先运行 sillyspec run scan 生成模块文档');
-    return;
-  }
-
-  const content = readFileSync(mapPath, 'utf8');
-
-  // 简单解析
-  const lines = content.split('\n');
-  const modules = [];
-  let currentModule = null;
-  let needsReview = false;
-
-  for (const line of lines) {
-    const moduleMatch = line.match(/^  ([a-zA-Z0-9_-]+):$/);
-    if (moduleMatch) {
-      if (currentModule) modules.push(currentModule);
-      currentModule = { id: moduleMatch[1], hasTags: false, hasEntryPoints: false, hasDepends: false, needsReview: false, hasRole: false, hasCoreFiles: false, hasRisk: false, hasVerify: false };
-    }
-    if (currentModule) {
-      if (line.includes('tags:')) currentModule.hasTags = true;
-      if (line.includes('entrypoints:')) currentModule.hasEntryPoints = true;
-      if (line.includes('depends_on:')) currentModule.hasDepends = true;
-      if (line.includes('needs_review: true')) { currentModule.needsReview = true; needsReview = true; }
-      if (line.includes('role:')) currentModule.hasRole = true;
-      if (line.includes('core_files:')) currentModule.hasCoreFiles = true;
-      if (line.includes('risk_level:')) currentModule.hasRisk = true;
-      if (line.includes('verify_commands:')) currentModule.hasVerify = true;
-    }
-  }
-  if (currentModule) modules.push(currentModule);
-
-  console.log(`\n_module-map.yaml: ${mapPath}`);
-  console.log(`模块数量：${modules.length}\n`);
-
-  const maxId = Math.max(5, ...modules.map(m => m.id.length));
-  console.log(`  ${'模块'.padEnd(maxId)}  tags  entry  deps  role  core  risk  review`);
-  console.log(`  ${''.padEnd(maxId, '─')}  ────  ─────  ────  ────  ────  ────  ──────`);
-  for (const m of modules) {
-    const tags = m.hasTags ? '✅' : '⬜';
-    const entry = m.hasEntryPoints ? '✅' : '⬜';
-    const deps = m.hasDepends ? '✅' : '⬜';
-    const role = m.hasRole ? '✅' : '⬜';
-    const core = m.hasCoreFiles ? '✅' : '⬜';
-    const risk = m.hasRisk ? '✅' : '⬜';
-    const verify = m.hasVerify ? '✅' : '⬜';
-    const review = m.needsReview ? '⚠️' : '✅';
-    console.log(`  ${m.id.padEnd(maxId)}  ${tags}     ${entry}     ${deps}     ${role}     ${core}     ${risk}     ${verify}     ${review}`);
-  }
-
-  if (needsReview) {
-    console.log(`\n⚠️  有模块标记为 needs_review，建议检查或重新 scan`);
-  }
-}
-
-/**
- * 从模块卡片提取指定 section 的内容
- */
-function extractSection(content, sectionName) {
-  const match = content.match(new RegExp(`## ${escapeRegExp(sectionName)}\\n([\\s\\S]*?)(?=\\n##|$)`));
-  return match ? match[1].trim().split('\n')[0] : '';  // 只取第一行作为摘要
-}
-
-function escapeRegExp(s) {
-  return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-
-function escapeYamlString(s) {
-  return s.replace(/"/g, '\\"').replace(/\n/g, ' ').slice(0, 200);  // 截断避免过长
-}
-
-/**
- */
-export async function generateDependenciesMd(cwd) {
-  const mapPath = findModuleMapPath(cwd);
-  if (!mapPath || !existsSync(mapPath)) return;
-
-  const content = readFileSync(mapPath, 'utf8');
-  const modules = parseModuleMapSimple(content);
-
-  if (Object.keys(modules).length === 0) return;
-
-  const depsPath = join(mapPath, '..', 'dependencies.md');
-  const maxName = Math.max(6, ...Object.keys(modules).map(k => k.length));
-
-  let md = `# Module Dependencies\n\n`;
-  md += `> 自动生成，由 sillyspec 维护\n\n`;
-  md += `| ${'Module'.padEnd(maxName)} | Depends On | Used By |\n`;
-  md += `| ${''.padEnd(maxName, '-')}:--- | :--- | :--- |\n`;
-
-  for (const [id, data] of Object.entries(modules)) {
-    const depends = (data.depends_on || []).join(', ') || '—';
-    const usedBy = (data.used_by || []).join(', ') || '—';
-    md += `| ${id.padEnd(maxName)} | ${depends} | ${usedBy} |\n`;
-  }
-
-  writeFileSync(depsPath, md, 'utf8');
-  console.log(`✅ dependencies.md 已生成`);
-}
-
-function parseModuleMapSimple(content) {
-  const modules = {};
-  let currentModule = null;
-  let currentKey = null;
-  let currentArray = null;
-
-  for (const line of content.split('\n')) {
-    const moduleMatch = line.match(/^  ([a-zA-Z0-9_-]+):$/);
-    if (moduleMatch) {
-      if (currentArray && currentModule && currentKey) {
-        modules[currentModule][currentKey] = currentArray;
-      }
-      currentModule = moduleMatch[1];
-      modules[currentModule] = {};
-      currentKey = null;
-      currentArray = null;
-      continue;
-    }
-    if (!currentModule) continue;
-
-    // Array field like depends_on:\n  - xxx
-    const arrayFieldMatch = line.match(/^    (depends_on|used_by|paths|tags|aliases|entrypoints|main_symbols|review_reasons):$/);
-    if (arrayFieldMatch) {
-      if (currentArray && currentKey) modules[currentModule][currentKey] = currentArray;
-      currentKey = arrayFieldMatch[1];
-      currentArray = [];
-      continue;
-    }
-
-    // Inline array like tags: [a, b]
-    const inlineArrayMatch = line.match(/^    (depends_on|used_by|paths|tags|aliases|entrypoints|main_symbols|review_reasons): \[(.*)\]$/);
-    if (inlineArrayMatch) {
-      if (currentArray && currentKey) modules[currentModule][currentKey] = currentArray;
-      const vals = inlineArrayMatch[2].split(',').map(v => v.trim()).filter(Boolean);
-      modules[currentModule][inlineArrayMatch[1]] = vals;
-      currentKey = null;
-      currentArray = null;
-      continue;
-    }
-
-    // Scalar field
-    const scalarMatch = line.match(/^    (status|doc|needs_review): (.+)$/);
-    if (scalarMatch) {
-      if (currentArray && currentKey) { modules[currentModule][currentKey] = currentArray; currentArray = null; currentKey = null; }
-      modules[currentModule][scalarMatch[1]] = scalarMatch[2];
-      continue;
-    }
-
-    // Array item
-    const itemMatch = line.match(/^      - (.+)$/);
-    if (itemMatch && currentArray !== null) {
-      currentArray.push(itemMatch[1].trim());
-      continue;
-    }
-  }
-
-  // Flush last
-  if (currentArray && currentModule && currentKey) {
-    modules[currentModule][currentKey] = currentArray;
-  }
-
-  return modules;
-}
-
-/**
- * migrate: 旧格式模块文档迁移到新格式
- */
-export async function migrateModuleDocs(cwd) {
-  const mapPath = findModuleMapPath(cwd);
-  if (!mapPath || !existsSync(mapPath)) {
-    console.error('❌ 未找到 _module-map.yaml');
-    return;
-  }
-
-  const modulesDir = join(mapPath, '..');
-  const files = readdirSync(modulesDir).filter(f => f.endsWith('.md') && f !== '_module-map.yaml');
-
-  if (files.length === 0) {
-    console.log('📭 没有模块文档需要迁移');
-    return;
-  }
-
-  let migrated = 0;
-  let skipped = 0;
-
-  for (const f of files) {
-    const filePath = join(modulesDir, f);
-    const content = readFileSync(filePath, 'utf8');
-
-    // 检查是否已经是新格式（有 schema_version + doc_type: module-card）
-    if (content.includes('schema_version:') && content.includes('doc_type: module-card')) {
-      skipped++;
-      continue;
-    }
-
-    // 提取模块名（从 H1 或文件名）
-    const h1Match = content.match(/^# (.+)$/m);
-    const moduleId = h1Match ? h1Match[1].trim().replace(/\s+/g, '-').toLowerCase() : f.replace('.md', '');
-
-    // 提取旧的“职责”和“注意事项”作为语义内容保留
-    const dutyMatch = content.match(/## 职责\n([\s\S]*?)(?=\n##|$)/);
-    const notesMatch = content.match(/## 注意事项\n([\s\S]*?)(?=\n##|$)/);
-    const designMatch = content.match(/## 当前设计\n([\s\S]*?)(?=\n##|$)/);
-    const interfaceMatch = content.match(/## 对外接口[\s\S]*?(?=\n##|$)/);
-
-    const duty = dutyMatch ? dutyMatch[1].trim() : '';
-    const notes = notesMatch ? notesMatch[1].trim() : '';
-    const design = designMatch ? designMatch[1].trim() : '';
-
-    // 检查是否有人工备注
-    const manualMatch = content.match(/<!-- MANUAL_NOTES_START -->([\s\S]*?)<!-- MANUAL_NOTES_END -->/);
-    const manualContent = manualMatch ? manualMatch[1].trim() : '';
-
-    // 生成新格式
-    let newContent = `---
-schema_version: 1
-doc_type: module-card
-module_id: ${moduleId}
----
-
-# ${moduleId}
-
-`;
-
-    if (duty) {
-      newContent += `## 定位
-
-${duty}
-
-`;
-    } else {
-      newContent += `## 定位
-
-（待补充）
-
-`;
-    }
-
-    if (design || interfaceMatch) {
-      newContent += `## 契约摘要
-
-`;
-      if (interfaceMatch) newContent += `${interfaceMatch[0].replace('## 对外接口', '').trim()}
-
-`;
-      else newContent += `（待从源码提取）
-
-`;
-    } else {
-      newContent += `## 契约摘要
-
-（待从源码提取）
-
-`;
-    }
-
-    if (design) {
-      newContent += `## 关键逻辑
-
-${design}
-
-`;
-    } else {
-      newContent += `## 关键逻辑
-
-（待补充）
-
-`;
-    }
-
-    if (notes) {
-      newContent += `## 注意事项
-
-${notes}
-
-`;
-    } else {
-      newContent += `## 注意事项
-
-（待补充）
-
-`;
-    }
-
-    newContent += `## 人工备注
-
-<!-- MANUAL_NOTES_START -->
-${manualContent}
-<!-- MANUAL_NOTES_END -->
-`;
-
-    writeFileSync(filePath, newContent, 'utf8');
-    migrated++;
-  }
-
-  console.log(`✅ 迁移完成`);
-  console.log(`   已迁移：${migrated} 个`);
-  console.log(`   已跳过（新格式）：${skipped} 个`);
-  if (migrated > 0) {
-    console.log(`\n⚠️  迁移后的卡片可能需要补充内容，建议检查并运行 sillyspec modules status`);
-  }
-}