@paircode/tool-project-info 1.0.0 → 1.0.2

package/index.js

@@ -1,8 +1,8 @@
 // ═══════════════════════════════════════════════════════════════
 // tool-project-info — 项目知识库（project_info_write/read/list/search/delete/explore）
 //
-// 生成来源（2026-08-16）：内置 Go 工具组 → 磁盘外置插件（tool_plugin_gen.go
-// 自动生成，schema 完整外置拷贝）。api 声明在插件，execute 调 ctx.binary 复用本插件目录 bin/ 下的独立二进制（源码 plugins-src/plugins/<name>/，改实现重编译即更换）。
+// ★ 2026-08-22 JS 原生化：调用实现（JS 编排 ctx.fs 读写 .pair/project-info/、
+//   目录扫描建树、explore 结构概览）完全在插件内——不再依赖独立二进制。
 // 工具清单：project_info_write、project_info_read、project_info_list、project_info_tree、project_info_search、project_info_delete、project_info_explore
 // ═══════════════════════════════════════════════════════════════
 const tools = [
@@ -139,9 +139,243 @@ const tools = [
   }
 ];
 
+// ─── JS 原生化实现（ctx.fs 读写 .pair/project-info/） ─────────
+
+// 知识库根：project 非空 → ../<project>/.pair/project-info（多根归属由 resolve 检查）；绝对路径直接传。
+function infoRoot(ctx, args) {
+  const project = args.project
+  if (!project) return '.pair/project-info'
+  if (/^[a-zA-Z]:[\\/]/.test(project) || project.startsWith('/')) {
+    return String(project).replace(/[\\/]+$/, '') + '/.pair/project-info'
+  }
+  return '../' + String(project).replace(/[\\/]+$/, '') + '/.pair/project-info'
+}
+
+const infoBranches = { 目标: 1, 架构: 1, 实现: 1, 关键点: 1, 设计思想: 1 }
+function isInfoBranch(head) { return !!infoBranches[head] }
+
+// safeInfoPath 规范化条目路径：去 .md、清理、禁路径穿越（..、绝对路径），允许 / 嵌套。
+function safeInfoPath(p) {
+  p = String(p || '').replace(/\.md$/, '').trim().replace(/\\/g, '/')
+  // path.Clean 近似：拆段抵消 ...
+  const segs = []
+  for (const s of p.split('/')) {
+    if (s === '' || s === '.') continue
+    if (s === '..') { segs.pop(); continue }
+    segs.push(s)
+  }
+  return segs.join('/')
+}
+
+function infoLevel(rel) {
+  const low = String(rel).toLowerCase()
+  if (low === 'overview' || rel === '概览' || rel === '项目概览') return 'overview'
+  if ((rel.match(/\//g) || []).length >= 2) return 'detail'
+  return 'module'
+}
+
+function firstHeading(md, fallback) {
+  for (const ln of String(md).split('\n')) {
+    const s = ln.trim()
+    if (s.startsWith('# ')) return s.slice(2).trim()
+  }
+  return fallback
+}
+
+// notesToBranchRel 参考项目决策树路径 → 知识库树分支路径（与 Go 版同映射）。
+function notesToBranchRel(n) {
+  n = String(n).replace(/^notes\//, '').replace(/^\//, '')
+  if (!n) return null
+  const segs = n.split('/')
+  const leaf = segs[segs.length - 1]
+  let branch
+  if (segs.length >= 2 && segs[0] === 'implemented' && segs[1] === 'architecture') branch = '架构'
+  else if (segs.length >= 2 && segs[0] === 'implemented' && (segs[1] === 'decision' || segs[1] === 'decisions')) branch = '设计思想'
+  else if (segs.length >= 2 && segs[0] === 'implemented' && segs[1] === 'feature') branch = '实现'
+  else if (segs.length >= 2 && segs[0] === 'implemented') branch = '关键点'
+  else if (segs[0] === 'decision' || segs[0] === 'decisions') branch = '设计思想'
+  else if (segs.length >= 2 && segs[0] === 'inbox') branch = '实现'
+  else branch = '实现'
+  return branch + '/' + leaf
+}
+
+// scanInfoEntries 递归扫描知识库目录（.md），返回 [{path,title,level,content}]。
+// 附加源：工作区 .agents/notes/ 存在时并入（路径前缀 notes/；树中已有镜像则跳过）。
+function scanInfoEntries(ctx, args) {
+  const rootDir = infoRoot(ctx, args)
+  const out = []
+  const walkDir = (base, prefix, skip) => {
+    let names = []
+    try { names = ctx.fs.readdir(base) } catch { return }
+    for (const n of names.sort()) {
+      const p = base + '/' + n
+      let st
+      try { st = ctx.fs.stat(p) } catch { continue }
+      const rel = (prefix ? prefix + '/' : '') + n.replace(/\.md$/, '')
+      if (st.isDir) {
+        walkDir(p, rel, skip)
+      } else if (n.endsWith('.md')) {
+        if (skip && skip(rel)) continue
+        const content = ctx.fs.readFile(p)
+        out.push({ path: rel, title: firstHeading(content, rel), level: infoLevel(rel), content })
+      }
+    }
+  }
+  walkDir(rootDir, '', null)
+  // .agents/notes 附加源：rootDir 为 <projRoot>/.pair/project-info → 项目根 = 去掉该尾缀
+  const projRoot = rootDir.replace(/\/\.pair\/project-info$/, '')
+  const notes = (projRoot ? projRoot + '/' : '') + '.agents/notes'
+  if (notes !== rootDir) {
+    walkDir(notes, 'notes', (nrel) => {
+      const br = notesToBranchRel(nrel)
+      if (!br) return false
+      try { ctx.fs.exists(rootDir + '/' + br + '.md'); return ctx.fs.exists(rootDir + '/' + br + '.md') } catch { return false }
+    })
+  }
+  out.sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0))
+  return out
+}
+
+// infoTree 构建知识库缩进树文本（分支=目录，叶子=条目）。showLevel 时叶子带分级标记。
+function infoTree(entries, showLevel) {
+  const root = { children: {}, entry: null }
+  const ensure = (node, name) => {
+    if (!node.children[name]) node.children[name] = { children: {}, entry: null, name }
+    return node.children[name]
+  }
+  for (const e of entries) {
+    const parts = e.path.split('/')
+    let cur = root
+    for (let i = 0; i < parts.length - 1; i++) cur = ensure(cur, parts[i])
+    const leaf = parts[parts.length - 1]
+    const n = ensure(cur, leaf)
+    n.entry = e
+  }
+  let text = ''
+  const walk = (node, prefix) => {
+    const keys = Object.keys(node.children).sort()
+    keys.forEach((k, i) => {
+      const ch = node.children[k]
+      const last = i === keys.length - 1
+      const conn = last ? '└── ' : '├── '
+      const nextPrefix = prefix + (last ? '    ' : '│   ')
+      if (ch.entry) {
+        let mark = ''
+        if (showLevel) mark = ' [' + ch.entry.level + ']'
+        let title = ch.entry.title
+        const leaf = ch.entry.path.split('/').pop()
+        if (leaf && leaf !== title) title += '（' + leaf + '）'
+        text += prefix + conn + title + mark + '\n'
+      } else {
+        text += prefix + conn + k + '/\n'
+      }
+      walk(ch, nextPrefix)
+    })
+  }
+  walk(root, '')
+  return text
+}
+
+const infoKeyFiles = { 'go.mod': 1, 'package.json': 1, 'cargo.toml': 1, 'pyproject.toml': 1, 'pom.xml': 1, 'main.go': 1, 'agents.md': 1, 'claude.md': 1, 'go.sum': 1, 'tsconfig.json': 1 }
+
+// exploreProjectStructure 轻量项目结构概览（根目录关键文件 + 顶层目录及文件数）。
+function exploreProjectStructure(ctx) {
+  let names = []
+  try { names = ctx.fs.readdir('.') } catch (e) { return '无法读取项目根目录：' + e.message }
+  let out = '# 项目结构概览（供分析后写入知识库）\n\n## 根目录关键文件\n'
+  for (const n of names.sort()) {
+    let st
+    try { st = ctx.fs.stat(n) } catch { continue }
+    if (!st.isDir && (/(readme|makefile)/i.test(n) || infoKeyFiles[n.toLowerCase()])) out += '- ' + n + '\n'
+  }
+  out += '\n## 顶层目录（文件数）\n'
+  const dirs = []
+  for (const n of names.sort()) {
+    let st
+    try { st = ctx.fs.stat(n) } catch { continue }
+    if (st.isDir) {
+      let cnt = 0
+      try { cnt = (ctx.fs.readdir(n) || []).length } catch { cnt = 0 }
+      dirs.push(n + ' (' + cnt + ')')
+    }
+  }
+  if (dirs.length) out += '- ' + dirs.join('\n- ') + '\n'
+  return out
+}
+
+const impls = {
+  project_info_write(ctx, args) {
+    const dir = infoRoot(ctx, args)
+    let rel = safeInfoPath(args.path)
+    if (!rel) throw new Error('path 不能为空')
+    let branchRel = rel, mirrorRel = ''
+    if (rel.startsWith('notes/')) {
+      if (notesToBranchRel(rel)) branchRel = notesToBranchRel(rel)
+      mirrorRel = rel.replace(/^notes\//, '')
+    }
+    const fp = dir + '/' + branchRel + '.md'
+    const parentDir = fp.slice(0, fp.lastIndexOf('/'))
+    if (parentDir && !ctx.fs.exists(parentDir)) ctx.fs.mkdir(parentDir, true)
+    const updating = ctx.fs.exists(fp)
+    ctx.fs.writeFile(fp, String(args.content || ''))
+    if (mirrorRel) {
+      // 镜像 .agents/notes/<原相对路径>.md（项目根 = dir 去掉尾缀）
+      const projRoot = dir.replace(/\/\.pair\/project-info$/, '')
+      const nfp = (projRoot ? projRoot + '/' : '') + '.agents/notes/' + mirrorRel + '.md'
+      const npd = nfp.slice(0, nfp.lastIndexOf('/'))
+      if (npd && !ctx.fs.exists(npd)) ctx.fs.mkdir(npd, true)
+      ctx.fs.writeFile(nfp, String(args.content || ''))
+    }
+    const head = branchRel.includes('/') ? branchRel.slice(0, branchRel.indexOf('/')) : branchRel
+    let hint = ''
+    if (!rel.startsWith('notes/') && head !== '概览' && !isInfoBranch(head)) {
+      hint = '（提示：知识库是树，建议用顶层分支 目标/架构/实现/关键点/设计思想 开头，如 架构/' + branchRel + '）'
+    }
+    const verb = updating ? '已更新知识库' : '已写入知识库'
+    if (mirrorRel) return verb + '：' + branchRel + '（notes/ 参考路径已镜像 .agents/notes/' + mirrorRel + '）'
+    return verb + '：' + branchRel + hint
+  },
+  project_info_read(ctx, args) {
+    const rel = safeInfoPath(args.path)
+    const fp = infoRoot(ctx, args) + '/' + rel + '.md'
+    if (!ctx.fs.exists(fp)) throw new Error('无此知识库条目：' + rel + '（用 project_info_list 看全部）')
+    return ctx.fs.readFile(fp)
+  },
+  project_info_list(ctx, args) {
+    const entries = scanInfoEntries(ctx, args)
+    if (entries.length === 0) return '（知识库为空。用 project_info_explore 起步、project_info_write 写入，或菜单「探索项目知识库」。）'
+    return infoTree(entries, true)
+  },
+  project_info_tree(ctx, args) {
+    const entries = scanInfoEntries(ctx, args)
+    if (entries.length === 0) return '（知识库为空）'
+    return '# 项目知识库（树）\n' + infoTree(entries, false)
+  },
+  project_info_search(ctx, args) {
+    const q = String(args.query || '').trim().toLowerCase()
+    if (!q) throw new Error('query 不能为空')
+    const lines = []
+    for (const e of scanInfoEntries(ctx, args)) {
+      if ((e.path + e.title + e.content).toLowerCase().includes(q)) lines.push('- ' + e.title + '（' + e.path + '）')
+    }
+    return lines.length === 0 ? '（无匹配条目）' : lines.join('\n')
+  },
+  project_info_delete(ctx, args) {
+    const rel = safeInfoPath(args.path)
+    const fp = infoRoot(ctx, args) + '/' + rel + '.md'
+    if (!ctx.fs.exists(fp)) throw new Error('无此知识库条目：' + rel)
+    ctx.fs.rm(fp, false)
+    return '已删除知识库条目：' + rel
+  },
+  project_info_explore(ctx, args) {
+    return exploreProjectStructure(ctx)
+  },
+}
+
 return {
   name: 'tool-project-info',
-  purpose: '项目知识库（project_info_write/read/list/search/delete/explore）（自动生成，迁移自内置 Go 工具组）',
+  inject: ['fs'],
+  purpose: '项目知识库（project_info_write/read/list/search/delete/explore）——2026-08-22 JS 原生化：调用实现（JS 编排 ctx.fs）完全在插件内，不再依赖独立二进制',
   apply(ctx) {
     for (const t of tools) {
       ctx.tools.register({
@@ -153,7 +387,7 @@ return {
         requiresApproval: t.requiresApproval,
         systemTool: t.systemTool,
         parameters: t.parameters,
-        execute: (args) => ctx.binary.exec(t.name, args || {}),
+        execute: (args) => impls[t.name](ctx, args || {}),
       })
     }
   },

package/package.json

@@ -3,7 +3,7 @@
   "name": "@paircode/tool-project-info",
   "scope": "global",
   "type": "plugin",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "项目知识库（project_info_write/read/list/search/delete/explore）（自动生成，迁移自内置 Go 工具组）",
   "keywords": [
     "paircode"