sillyspec 3.20.3 → 3.20.5

package/src/knowledge-match.js

@@ -0,0 +1,130 @@
+/**
+ * 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/migrate.js

@@ -1,117 +1,117 @@
-import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, renameSync, copyFileSync } from 'fs';
-import { join, resolve } from 'path';
-import chalk from 'chalk';
-
-/**
- * Migrate old .sillyspec/ structure to unified docs/<project>/ structure
- * @param {string} projectDir - Path to the project directory
- */
-export function migrateDocs(projectDir) {
-  const sillyspecDir = join(projectDir, '.sillyspec');
-  if (!existsSync(sillyspecDir)) {
-    console.error('❌ .sillyspec/ 目录不存在');
-    process.exit(1);
-  }
-
-  // Determine project name from projects/*.yaml or directory name
-  let projectName = projectDir.split('/').pop();
-  const projectsDir = join(sillyspecDir, 'projects');
-  if (existsSync(projectsDir)) {
-    const yamlFiles = readdirSync(projectsDir).filter(f => f.endsWith('.yaml'));
-    if (yamlFiles.length > 0) {
-      projectName = yamlFiles[0].replace('.yaml', '');
-    }
-  }
-
-  console.log(chalk.cyan(`📦 迁移项目: ${projectName}`));
-  console.log('');
-
-  const docsBase = join(sillyspecDir, 'docs', projectName);
-  let migrated = 0;
-
-  // 1. codebase/ → docs/<project>/scan/
-  const codebaseDir = join(sillyspecDir, 'codebase');
-  if (existsSync(codebaseDir)) {
-    const targetDir = join(docsBase, 'scan');
-    mkdirSync(targetDir, { recursive: true });
-    const files = readdirSync(codebaseDir).filter(f => f.endsWith('.md'));
-    for (const file of files) {
-      const src = join(codebaseDir, file);
-      const dest = join(targetDir, file);
-      if (!existsSync(dest)) {
-        copyFileSync(src, dest);
-        console.log(chalk.green('  ✅') + ` scan/${file}`);
-        migrated++;
-      } else {
-        console.log(chalk.yellow('  ⏭️') + ` scan/${file} (已存在)`);
-      }
-    }
-  }
-
-  // 2. specs/ is deprecated — designs live in changes/<变更名>/design.md
-
-  // 3. changes/archive/ → docs/<project>/archive/
-  const archiveDir = join(sillyspecDir, 'changes', 'archive');
-  if (existsSync(archiveDir)) {
-    const targetDir = join(docsBase, 'archive');
-    mkdirSync(targetDir, { recursive: true });
-    const entries = readdirSync(archiveDir);
-    for (const entry of entries) {
-      const src = join(archiveDir, entry);
-      const dest = join(targetDir, entry);
-      if (!existsSync(dest)) {
-        copyFileSync(src, dest);
-        console.log(chalk.green('  ✅') + ` archive/${entry}`);
-        migrated++;
-      } else {
-        console.log(chalk.yellow('  ⏭️') + ` archive/${entry} (已存在)`);
-      }
-    }
-  }
-
-  // 4. knowledge/ → docs/<project>/archive/ (append knowledge files)
-  const knowledgeDir = join(sillyspecDir, 'knowledge');
-  if (existsSync(knowledgeDir)) {
-    const targetDir = join(docsBase, 'archive');
-    mkdirSync(targetDir, { recursive: true });
-    const files = readdirSync(knowledgeDir).filter(f => f.endsWith('.md'));
-    for (const file of files) {
-      const src = join(knowledgeDir, file);
-      const dest = join(targetDir, `knowledge-${file}`);
-      if (!existsSync(dest)) {
-        copyFileSync(src, dest);
-        console.log(chalk.green('  ✅') + ` archive/knowledge-${file}`);
-        migrated++;
-      } else {
-        console.log(chalk.yellow('  ⏭️') + ` archive/knowledge-${file} (已存在)`);
-      }
-    }
-  }
-
-  // 5. quicklog/ → docs/<project>/quicklog/
-  const quicklogDir = join(sillyspecDir, 'quicklog');
-  if (existsSync(quicklogDir)) {
-    const targetDir = join(docsBase, 'quicklog');
-    mkdirSync(targetDir, { recursive: true });
-    const files = readdirSync(quicklogDir).filter(f => f.endsWith('.md'));
-    for (const file of files) {
-      const src = join(quicklogDir, file);
-      const dest = join(targetDir, file);
-      if (!existsSync(dest)) {
-        copyFileSync(src, dest);
-        console.log(chalk.green('  ✅') + ` quicklog/${file}`);
-        migrated++;
-      } else {
-        console.log(chalk.yellow('  ⏭️') + ` quicklog/${file} (已存在)`);
-      }
-    }
-  }
-
-  console.log('');
-  if (migrated > 0) {
-    console.log(chalk.green(`  ✅ 迁移完成，共迁移 ${migrated} 个文件`));
-    console.log(chalk.dim('  旧文件保留在原位，确认无误后可手动删除'));
-  } else {
-    console.log(chalk.yellow('  没有需要迁移的文件'));
-  }
-}
+import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, renameSync, copyFileSync } from 'fs';
+import { basename, join, resolve } from 'path';
+import chalk from 'chalk';
+
+/**
+ * Migrate old .sillyspec/ structure to unified .sillyspec/docs/<project>/ structure
+ * @param {string} projectDir - Path to the project directory
+ */
+export function migrateDocs(projectDir) {
+  const sillyspecDir = join(projectDir, '.sillyspec');
+  if (!existsSync(sillyspecDir)) {
+    console.error('❌ .sillyspec/ 目录不存在');
+    process.exit(1);
+  }
+
+  // Determine project name from projects/*.yaml or directory name
+  let projectName = basename(resolve(projectDir));
+  const projectsDir = join(sillyspecDir, 'projects');
+  if (existsSync(projectsDir)) {
+    const yamlFiles = readdirSync(projectsDir).filter(f => f.endsWith('.yaml'));
+    if (yamlFiles.length > 0) {
+      projectName = yamlFiles[0].replace('.yaml', '');
+    }
+  }
+
+  console.log(chalk.cyan(`📦 迁移项目: ${projectName}`));
+  console.log('');
+
+  const docsBase = join(sillyspecDir, 'docs', projectName);
+  let migrated = 0;
+
+  // 1. codebase/ → .sillyspec/docs/<project>/scan/
+  const codebaseDir = join(sillyspecDir, 'codebase');
+  if (existsSync(codebaseDir)) {
+    const targetDir = join(docsBase, 'scan');
+    mkdirSync(targetDir, { recursive: true });
+    const files = readdirSync(codebaseDir).filter(f => f.endsWith('.md'));
+    for (const file of files) {
+      const src = join(codebaseDir, file);
+      const dest = join(targetDir, file);
+      if (!existsSync(dest)) {
+        copyFileSync(src, dest);
+        console.log(chalk.green('  ✅') + ` scan/${file}`);
+        migrated++;
+      } else {
+        console.log(chalk.yellow('  ⏭️') + ` scan/${file} (已存在)`);
+      }
+    }
+  }
+
+  // 2. specs/ is deprecated — designs live in changes/<变更名>/design.md
+
+  // 3. changes/archive/ → .sillyspec/docs/<project>/archive/
+  const archiveDir = join(sillyspecDir, 'changes', 'archive');
+  if (existsSync(archiveDir)) {
+    const targetDir = join(docsBase, 'archive');
+    mkdirSync(targetDir, { recursive: true });
+    const entries = readdirSync(archiveDir);
+    for (const entry of entries) {
+      const src = join(archiveDir, entry);
+      const dest = join(targetDir, entry);
+      if (!existsSync(dest)) {
+        copyFileSync(src, dest);
+        console.log(chalk.green('  ✅') + ` archive/${entry}`);
+        migrated++;
+      } else {
+        console.log(chalk.yellow('  ⏭️') + ` archive/${entry} (已存在)`);
+      }
+    }
+  }
+
+  // 4. knowledge/ → .sillyspec/docs/<project>/archive/ (append knowledge files)
+  const knowledgeDir = join(sillyspecDir, 'knowledge');
+  if (existsSync(knowledgeDir)) {
+    const targetDir = join(docsBase, 'archive');
+    mkdirSync(targetDir, { recursive: true });
+    const files = readdirSync(knowledgeDir).filter(f => f.endsWith('.md'));
+    for (const file of files) {
+      const src = join(knowledgeDir, file);
+      const dest = join(targetDir, `knowledge-${file}`);
+      if (!existsSync(dest)) {
+        copyFileSync(src, dest);
+        console.log(chalk.green('  ✅') + ` archive/knowledge-${file}`);
+        migrated++;
+      } else {
+        console.log(chalk.yellow('  ⏭️') + ` archive/knowledge-${file} (已存在)`);
+      }
+    }
+  }
+
+  // 5. quicklog/ → .sillyspec/docs/<project>/quicklog/
+  const quicklogDir = join(sillyspecDir, 'quicklog');
+  if (existsSync(quicklogDir)) {
+    const targetDir = join(docsBase, 'quicklog');
+    mkdirSync(targetDir, { recursive: true });
+    const files = readdirSync(quicklogDir).filter(f => f.endsWith('.md'));
+    for (const file of files) {
+      const src = join(quicklogDir, file);
+      const dest = join(targetDir, file);
+      if (!existsSync(dest)) {
+        copyFileSync(src, dest);
+        console.log(chalk.green('  ✅') + ` quicklog/${file}`);
+        migrated++;
+      } else {
+        console.log(chalk.yellow('  ⏭️') + ` quicklog/${file} (已存在)`);
+      }
+    }
+  }
+
+  console.log('');
+  if (migrated > 0) {
+    console.log(chalk.green(`  ✅ 迁移完成，共迁移 ${migrated} 个文件`));
+    console.log(chalk.dim('  旧文件保留在原位，确认无误后可手动删除'));
+  } else {
+    console.log(chalk.yellow('  没有需要迁移的文件'));
+  }
+}