sillyspec 3.26.10 → 3.26.13

package/src/knowledge-match.js

@@ -1,130 +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 }
-}
+/**
+ * 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/local-detect.js

@@ -1,120 +1,128 @@
-/**
- * Local Detect — 纯 fs 项目类型嗅探
- *
- * 把"生成本地配置"里的项目类型判定从 scan（半小时 + 大量 token）抽出来，
- * 变成纯 fs 同步读几秒可完成的独立探测。create/gate 只需 project.type +
- * commands，不该被迫跑完整 scan。
- *
- * 纯函数：不 spawn 任何子进程、不调用任何 AI/LLM、不消耗 token。
- * 不写 local.yaml 到磁盘——只返回数据结构，落盘由调用方（CLI 路由 / scan.js）负责。
- * 不引 yaml 依赖。
- */
-
-import { existsSync, readFileSync } from 'fs'
-import { join } from 'path'
-
-/**
- * 从 Makefile 文本提取 test 目标的命令（轻量正则，与 verify-postcheck 同风格）。
- * 支持两种常见写法：
- *   - 同行命令：`test: pytest`            → 'pytest'
- *   - tab 续行：`test:\n\tpytest\n`        → 'pytest'（命令在下一 tab 开头行）
- * 边界：
- *   - 纯空目标（`test:` 无同行命令、无 tab 续行）→ 回退 'make test'
- *   - 命令行内 `#` 注释截断；取第一个非空命令行
- * @param {string} makefileText
- * @returns {string}
- */
-function parseMakefileTestCommand(makefileText) {
-  if (!makefileText) return 'make test'
-  // 定位 `test:` 行；捕获 `:` 后同行内容（同行命令或空）
-  const head = makefileText.match(/^test:\s*([^\n#]*?)\s*(?:#.*)?$/m)
-  if (!head) return 'make test'
-  const inline = (head[1] || '').trim()
-  if (inline) return inline
-  // 同行为空 → 找该行之后第一个 tab 续行命令（`\tcmd` 或 `    cmd`）
-  const after = makefileText.slice(head.index + head[0].length)
-  const cont = after.match(/^[ \t]+([^\n#]+?)\s*(?:#.*)?$/m)
-  if (cont && cont[1]) return cont[1].trim()
-  return 'make test'
-}
-
-/**
- * 嗅探 workdir 的项目类型与默认 commands（纯 fs，零 AI / 零 token）。
- *
- * 嗅探规则（按顺序，命中即返回）：
- *   - package.json → nodejs（核验 scripts.{build,test,lint} 存在才写对应键；缺失不写）
- *   - pom.xml → maven（mvn compile / mvn test / mvn checkstyle:check）
- *   - build.gradle → gradle（gradlew 存在用 ./gradlew 否则 gradle；build / test / check）
- *   - Makefile → make（test 命令从 test: 目标解析；build/lint 无则不写）
- *   - 都没有 → generic（commands 为空对象）
- *
- * @param {string} workdir - 项目根目录
- * @returns {{
- *   project: { type: 'nodejs'|'maven'|'gradle'|'make'|'generic' },
- *   commands: { build?: string, test?: string, lint?: string }
- * }}
- */
-export function detectLocalYaml(workdir) {
-  // 1. nodejs
-  if (existsSync(join(workdir, 'package.json'))) {
-    const pkgPath = join(workdir, 'package.json')
-    const raw = readFileSync(pkgPath, 'utf8')
-    let pkg
-    try {
-      pkg = JSON.parse(raw)
-    } catch (e) {
-      throw new Error('package.json 解析失败：' + pkgPath)
-    }
-    const scripts = (pkg && pkg.scripts) || {}
-    const commands = {}
-    if (scripts.build) commands.build = 'npm run build'
-    if (scripts.test) commands.test = 'npm test'
-    if (scripts.lint) commands.lint = 'npm run lint'
-    return {
-      project: { type: 'nodejs' },
-      commands,
-    }
-  }
-
-  // 2. maven
-  if (existsSync(join(workdir, 'pom.xml'))) {
-    return {
-      project: { type: 'maven' },
-      commands: {
-        build: 'mvn compile',
-        test: 'mvn test',
-        lint: 'mvn checkstyle:check',
-      },
-    }
-  }
-
-  // 3. gradle
-  if (existsSync(join(workdir, 'build.gradle'))) {
-    const gradlePrefix = existsSync(join(workdir, 'gradlew')) ? './gradlew' : 'gradle'
-    return {
-      project: { type: 'gradle' },
-      commands: {
-        build: `${gradlePrefix} build`,
-        test: `${gradlePrefix} test`,
-        lint: `${gradlePrefix} check`,
-      },
-    }
-  }
-
-  // 4. make（test 命令从 Makefile 解析；build/lint 无则省略）
-  const makefilePath = join(workdir, 'Makefile')
-  if (existsSync(makefilePath)) {
-    const makefileText = readFileSync(makefilePath, 'utf8')
-    const test = parseMakefileTestCommand(makefileText)
-    return {
-      project: { type: 'make' },
-      commands: { test },
-    }
-  }
-
-  // 5. generic
-  return {
-    project: { type: 'generic' },
-    commands: {},
-  }
-}
+/**
+ * Local Detect — 纯 fs 项目类型嗅探
+ *
+ * 把"生成本地配置"里的项目类型判定从 scan（半小时 + 大量 token）抽出来，
+ * 变成纯 fs 同步读几秒可完成的独立探测。create/gate 只需 project.type +
+ * commands，不该被迫跑完整 scan。
+ *
+ * 纯函数：不 spawn 任何子进程、不调用任何 AI/LLM、不消耗 token。
+ * 不写 local.yaml 到磁盘——只返回数据结构，落盘由调用方（CLI 路由 / scan.js）负责。
+ * 不引 yaml 依赖。
+ */
+
+import { existsSync, readFileSync } from 'fs'
+import { join } from 'path'
+
+/**
+ * 从 Makefile 文本提取 test 目标的命令（轻量正则，与 verify-postcheck 同风格）。
+ * 支持两种常见写法：
+ *   - 同行命令：`test: pytest`            → 'pytest'
+ *   - tab 续行：`test:\n\tpytest\n`        → 'pytest'（命令在下一 tab 开头行）
+ * 边界：
+ *   - 纯空目标（`test:` 无同行命令、无 tab 续行）→ 回退 'make test'
+ *   - 命令行内 `#` 注释截断；取第一个非空命令行
+ * @param {string} makefileText
+ * @returns {string}
+ */
+function parseMakefileTestCommand(makefileText) {
+  if (!makefileText) return 'make test'
+  // 定位 `test:` 行；捕获 `:` 后同行内容（同行命令或空）
+  const head = makefileText.match(/^test:\s*([^\n#]*?)\s*(?:#.*)?$/m)
+  if (!head) return 'make test'
+  const inline = (head[1] || '').trim()
+  if (inline) return inline
+  // 同行为空 → 找该行之后第一个 tab 续行命令（`\tcmd` 或 `    cmd`）
+  const after = makefileText.slice(head.index + head[0].length)
+  const cont = after.match(/^[ \t]+([^\n#]+?)\s*(?:#.*)?$/m)
+  if (cont && cont[1]) return cont[1].trim()
+  return 'make test'
+}
+
+/**
+ * 嗅探 workdir 的项目类型与默认 commands（纯 fs，零 AI / 零 token）。
+ *
+ * 嗅探规则（按顺序，命中即返回）：
+ *   - package.json → nodejs（核验 scripts.{build,test,lint} 存在才写对应键；缺失不写）
+ *   - pom.xml → maven（mvn compile / mvn test / mvn checkstyle:check）
+ *   - build.gradle → gradle（gradlew 存在用 ./gradlew 否则 gradle；build / test / check）
+ *   - Makefile → make（test 命令从 test: 目标解析；build/lint 无则不写）
+ *   - 都没有 → generic（commands 为空对象）
+ *
+ * @param {string} workdir - 项目根目录
+ * @returns {{
+ *   project: { type: 'nodejs'|'maven'|'gradle'|'make'|'generic' },
+ *   commands: { build?: string, test?: string, lint?: string }
+ * }}
+ */
+export function detectLocalYaml(workdir) {
+  // 1. nodejs
+  if (existsSync(join(workdir, 'package.json'))) {
+    const pkgPath = join(workdir, 'package.json')
+    const raw = readFileSync(pkgPath, 'utf8')
+    let pkg
+    try {
+      pkg = JSON.parse(raw)
+    } catch (e) {
+      throw new Error('package.json 解析失败：' + pkgPath)
+    }
+    const scripts = (pkg && pkg.scripts) || {}
+    const commands = {}
+    if (scripts.build) commands.build = 'npm run build'
+    if (scripts.test) commands.test = 'npm test'
+    if (scripts.lint) commands.lint = 'npm run lint'
+    return {
+      project: { type: 'nodejs' },
+      commands,
+    }
+  }
+
+  // 2. maven
+  if (existsSync(join(workdir, 'pom.xml'))) {
+    return {
+      project: { type: 'maven' },
+      commands: {
+        build: 'mvn compile',
+        test: 'mvn test',
+        lint: 'mvn checkstyle:check',
+      },
+    }
+  }
+
+  // 3. gradle
+  if (existsSync(join(workdir, 'build.gradle'))) {
+    // Windows 上 cmd.exe 执行不了 ./gradlew（shell 脚本）——优先 gradlew.bat；
+    // 仅有 POSIX gradlew 且在 win32 时退回全局 gradle（体检 BUG-08）
+    const isWin = process.platform === 'win32'
+    let gradlePrefix = 'gradle'
+    if (isWin) {
+      gradlePrefix = existsSync(join(workdir, 'gradlew.bat')) ? 'gradlew.bat' : 'gradle'
+    } else {
+      gradlePrefix = existsSync(join(workdir, 'gradlew')) ? './gradlew' : 'gradle'
+    }
+    return {
+      project: { type: 'gradle' },
+      commands: {
+        build: `${gradlePrefix} build`,
+        test: `${gradlePrefix} test`,
+        lint: `${gradlePrefix} check`,
+      },
+    }
+  }
+
+  // 4. make（test 命令从 Makefile 解析；build/lint 无则省略）
+  const makefilePath = join(workdir, 'Makefile')
+  if (existsSync(makefilePath)) {
+    const makefileText = readFileSync(makefilePath, 'utf8')
+    const test = parseMakefileTestCommand(makefileText)
+    return {
+      project: { type: 'make' },
+      commands: { test },
+    }
+  }
+
+  // 5. generic
+  return {
+    project: { type: 'generic' },
+    commands: {},
+  }
+}