autosnippet 3.0.1 → 3.0.2

package/lib/service/knowledge/KnowledgeFileWriter.js

@@ -18,10 +18,10 @@
  * 落盘目录：isCandidate() → candidates/  |  isActive()/deprecated → recipes/
  */
 
+import { createHash } from 'node:crypto';
 import fs from 'node:fs';
 import path from 'node:path';
-import { createHash } from 'node:crypto';
-import { RECIPES_DIR, CANDIDATES_DIR } from '../../infrastructure/config/Defaults.js';
+import { CANDIDATES_DIR, RECIPES_DIR } from '../../infrastructure/config/Defaults.js';
 import Logger from '../../infrastructure/logging/Logger.js';
 import pathGuard from '../../shared/PathGuard.js';
 
@@ -30,13 +30,35 @@ import pathGuard from '../../shared/PathGuard.js';
  * ═══════════════════════════════════════════════════════════ */
 
 const SCALAR_FIELDS = [
-  'id', 'title', 'trigger', 'lifecycle', 'language', 'category',
-  'kind', 'knowledgeType', 'complexity', 'scope', 'difficulty',
-  'description', 'source', 'moduleName',
-  'topicHint', 'whenClause', 'doClause', 'dontClause', 'coreCode',
-  'createdBy', 'createdAt', 'updatedAt',
-  'publishedAt', 'publishedBy', 'reviewedBy', 'reviewedAt',
-  'rejectionReason', 'sourceFile', 'sourceCandidateId',
+  'id',
+  'title',
+  'trigger',
+  'lifecycle',
+  'language',
+  'category',
+  'kind',
+  'knowledgeType',
+  'complexity',
+  'scope',
+  'difficulty',
+  'description',
+  'source',
+  'moduleName',
+  'topicHint',
+  'whenClause',
+  'doClause',
+  'dontClause',
+  'coreCode',
+  'createdBy',
+  'createdAt',
+  'updatedAt',
+  'publishedAt',
+  'publishedBy',
+  'reviewedBy',
+  'reviewedAt',
+  'rejectionReason',
+  'sourceFile',
+  'sourceCandidateId',
 ];
 
 /* ═══════════════════════════════════════════════════════════
@@ -48,10 +70,10 @@ export class KnowledgeFileWriter {
    * @param {string} projectRoot 项目根目录
    */
   constructor(projectRoot) {
-    this.projectRoot   = projectRoot;
-    this.recipesDir    = path.join(projectRoot, RECIPES_DIR);
+    this.projectRoot = projectRoot;
+    this.recipesDir = path.join(projectRoot, RECIPES_DIR);
     this.candidatesDir = path.join(projectRoot, CANDIDATES_DIR);
-    this.logger        = Logger.getInstance();
+    this.logger = Logger.getInstance();
   }
 
   /* ═══ 序列化 ═══════════════════════════════════════════ */
@@ -74,20 +96,30 @@ export class KnowledgeFileWriter {
     }
 
     // ── 简单数组字段（行内 JSON）──
-    if (json.tags?.length)        lines.push(`tags: ${JSON.stringify(json.tags)}`);
-    if (json.headers?.length)     lines.push(`headers: ${JSON.stringify(json.headers)}`);
-    if (json.headerPaths?.length) lines.push(`headerPaths: ${JSON.stringify(json.headerPaths)}`);
-    if (json.includeHeaders)      lines.push(`includeHeaders: true`);
-    if (json.autoApprovable)      lines.push(`autoApprovable: true`);
+    if (json.tags?.length) {
+      lines.push(`tags: ${JSON.stringify(json.tags)}`);
+    }
+    if (json.headers?.length) {
+      lines.push(`headers: ${JSON.stringify(json.headers)}`);
+    }
+    if (json.headerPaths?.length) {
+      lines.push(`headerPaths: ${JSON.stringify(json.headerPaths)}`);
+    }
+    if (json.includeHeaders) {
+      lines.push(`includeHeaders: true`);
+    }
+    if (json.autoApprovable) {
+      lines.push(`autoApprovable: true`);
+    }
 
     // ── JSON 值对象（_ 前缀，单行 JSON）──
     const JSON_FIELDS = [
-      ['_content',          json.content],
-      ['_relations',        json.relations],
-      ['_constraints',      json.constraints],
-      ['_reasoning',        json.reasoning],
-      ['_quality',          json.quality],
-      ['_stats',            json.stats],
+      ['_content', json.content],
+      ['_relations', json.relations],
+      ['_constraints', json.constraints],
+      ['_reasoning', json.reasoning],
+      ['_quality', json.quality],
+      ['_stats', json.stats],
       ['_lifecycleHistory', json.lifecycleHistory],
     ];
     for (const [key, val] of JSON_FIELDS) {
@@ -99,8 +131,12 @@ export class KnowledgeFileWriter {
         }
       }
     }
-    if (json.agentNotes) lines.push(`_agentNotes: ${JSON.stringify(json.agentNotes)}`);
-    if (json.aiInsight)  lines.push(`_aiInsight: ${JSON.stringify(json.aiInsight)}`);
+    if (json.agentNotes) {
+      lines.push(`_agentNotes: ${JSON.stringify(json.agentNotes)}`);
+    }
+    if (json.aiInsight) {
+      lines.push(`_aiInsight: ${JSON.stringify(json.aiInsight)}`);
+    }
 
     // _contentHash 占位（后续替换为真实 hash）
     const hashPlaceholder = '__HASH_PLACEHOLDER__';
@@ -144,7 +180,7 @@ export class KnowledgeFileWriter {
       }
 
       if (c.pattern) {
-        lines.push('```' + (entry.language || 'swift'));
+        lines.push(`\`\`\`${entry.language || 'text'}`);
         lines.push(c.pattern);
         lines.push('```');
         lines.push('');
@@ -165,7 +201,7 @@ export class KnowledgeFileWriter {
             lines.push(`${i + 1}. ${step}`);
           } else {
             const title = step.title || '步骤';
-            const desc  = step.description || '';
+            const desc = step.description || '';
             lines.push(`${i + 1}. **${title}**: ${desc}`);
             if (step.code) {
               lines.push('');
@@ -265,7 +301,9 @@ export class KnowledgeFileWriter {
    * @returns {boolean}
    */
   remove(entry) {
-    if (!entry?.id) return false;
+    if (!entry?.id) {
+      return false;
+    }
 
     // 先尝试 sourceFile 精确删除
     if (entry.sourceFile) {
@@ -308,9 +346,7 @@ export class KnowledgeFileWriter {
    * @returns {string|null} 新的文件路径
    */
   moveOnLifecycleChange(entry) {
-    const oldPath = entry.sourceFile
-      ? path.join(this.projectRoot, entry.sourceFile)
-      : null;
+    const oldPath = entry.sourceFile ? path.join(this.projectRoot, entry.sourceFile) : null;
 
     const { dir: newDir, filename } = this._resolveFilePath(entry);
     const newPath = path.join(newDir, filename);
@@ -351,7 +387,9 @@ export class KnowledgeFileWriter {
    * 清理旧文件（category 变更或 lifecycle 切换场景）
    */
   _cleanupOldFile(entry, newPath) {
-    if (!entry.sourceFile) return;
+    if (!entry.sourceFile) {
+      return;
+    }
     const oldPath = path.join(this.projectRoot, entry.sourceFile);
     if (oldPath !== newPath && fs.existsSync(oldPath)) {
       fs.unlinkSync(oldPath);
@@ -368,14 +406,18 @@ export class KnowledgeFileWriter {
    */
   _removeByIdScan(id) {
     for (const baseDir of [this.candidatesDir, this.recipesDir]) {
-      if (!fs.existsSync(baseDir)) continue;
+      if (!fs.existsSync(baseDir)) {
+        continue;
+      }
       try {
         const found = _walkAndRemoveById(baseDir, id);
         if (found) {
           this.logger.info('Knowledge entry file removed by id scan', { id });
           return true;
         }
-      } catch { /* ignore scan errors */ }
+      } catch {
+        /* ignore scan errors */
+      }
     }
     return false;
   }
@@ -413,11 +455,15 @@ export function parseKnowledgeMarkdown(content, relPath) {
     for (let i = 0; i < fmLines.length; i++) {
       const line = fmLines[i];
       const colonIdx = line.indexOf(':');
-      if (colonIdx <= 0) continue;
+      if (colonIdx <= 0) {
+        continue;
+      }
 
       const key = line.slice(0, colonIdx).trim();
       // 跳过带空格的非正常 key
-      if (/\s/.test(key)) continue;
+      if (/\s/.test(key)) {
+        continue;
+      }
 
       let value = line.slice(colonIdx + 1).trim();
 
@@ -439,7 +485,9 @@ export function parseKnowledgeMarkdown(content, relPath) {
               try {
                 data[dataKey] = JSON.parse(jsonStr);
                 break;
-              } catch { /* continue concatenating */ }
+              } catch {
+                /* continue concatenating */
+              }
             }
             continue;
           }
@@ -450,29 +498,60 @@ export function parseKnowledgeMarkdown(content, relPath) {
           try {
             data[dataKey] = JSON.parse(value);
             continue;
-          } catch { /* fall through to plain string */ }
+          } catch {
+            /* fall through to plain string */
+          }
         }
 
         // 纯标量值（如 _content_hash: abc123）
-        if (/^\d+$/.test(value)) { data[dataKey] = parseInt(value, 10); continue; }
-        if (/^\d+\.\d+$/.test(value)) { data[dataKey] = parseFloat(value); continue; }
-        if (value === 'true')  { data[dataKey] = true; continue; }
-        if (value === 'false') { data[dataKey] = false; continue; }
+        if (/^\d+$/.test(value)) {
+          data[dataKey] = parseInt(value, 10);
+          continue;
+        }
+        if (/^\d+\.\d+$/.test(value)) {
+          data[dataKey] = parseFloat(value);
+          continue;
+        }
+        if (value === 'true') {
+          data[dataKey] = true;
+          continue;
+        }
+        if (value === 'false') {
+          data[dataKey] = false;
+          continue;
+        }
         data[dataKey] = value;
         continue;
       }
 
       // ── 布尔 ──
-      if (value === 'true')  { data[key] = true; continue; }
-      if (value === 'false') { data[key] = false; continue; }
+      if (value === 'true') {
+        data[key] = true;
+        continue;
+      }
+      if (value === 'false') {
+        data[key] = false;
+        continue;
+      }
 
       // ── 数值（整数或浮点） ──
-      if (/^\d+$/.test(value)) { data[key] = parseInt(value, 10); continue; }
-      if (/^\d+\.\d+$/.test(value)) { data[key] = parseFloat(value); continue; }
+      if (/^\d+$/.test(value)) {
+        data[key] = parseInt(value, 10);
+        continue;
+      }
+      if (/^\d+\.\d+$/.test(value)) {
+        data[key] = parseFloat(value);
+        continue;
+      }
 
       // ── JSON 数组（非 _ 前缀） ──
       if (value.startsWith('[')) {
-        try { data[key] = JSON.parse(value); continue; } catch { /* fallthrough */ }
+        try {
+          data[key] = JSON.parse(value);
+          continue;
+        } catch {
+          /* fallthrough */
+        }
       }
 
       // ── 去引号 ──
@@ -500,8 +579,8 @@ export function parseKnowledgeMarkdown(content, relPath) {
 
     // 如果 content 中没有 markdown 且 body 看起来是 Markdown 文章
     if (!data.content?.markdown && !data.content?.pattern) {
-      const isMarkdownArticle = body.includes('— 项目特写') ||
-        (body.startsWith('#') && body.length > 200);
+      const isMarkdownArticle =
+        body.includes('— 项目特写') || (body.startsWith('#') && body.length > 200);
       if (isMarkdownArticle) {
         data.content = data.content || {};
         data.content.markdown = body;
@@ -517,7 +596,9 @@ export function parseKnowledgeMarkdown(content, relPath) {
   // ── fallback: title 从 body heading 提取 ──
   if (!data.title) {
     const headingMatch = content.match(/^##?\s+(.+)$/m);
-    if (headingMatch) data.title = headingMatch[1].trim();
+    if (headingMatch) {
+      data.title = headingMatch[1].trim();
+    }
   }
 
   return data;
@@ -539,7 +620,9 @@ function _slugFilename(trigger, title, id) {
       .replace(/^@/, '')
       .replace(/[^a-zA-Z0-9_-]/g, '_')
       .slice(0, 60);
-    if (clean.length >= 2) return `${clean}.md`;
+    if (clean.length >= 2) {
+      return `${clean}.md`;
+    }
   }
 
   // 其次用 title
@@ -551,7 +634,9 @@ function _slugFilename(trigger, title, id) {
       .replace(/-{2,}/g, '-')
       .replace(/^-|-$/g, '')
       .slice(0, 60);
-    if (slug.length >= 3) return `${slug}.md`;
+    if (slug.length >= 3) {
+      return `${slug}.md`;
+    }
   }
 
   // 最后用 id 前 8 位
@@ -562,10 +647,12 @@ function _slugFilename(trigger, title, id) {
  * 将 YAML 值安全序列化
  */
 function _yamlValue(key, val) {
-  if (typeof val === 'number' || typeof val === 'boolean') return String(val);
+  if (typeof val === 'number' || typeof val === 'boolean') {
+    return String(val);
+  }
   const str = String(val);
   // 含特殊字符时加引号
-  if (/[:#\[\]{}&*!|>'"`,@\n]/.test(str) || str.trim() !== str) {
+  if (/[:#[\]{}&*!|>'"`,@\n]/.test(str) || str.trim() !== str) {
     return `"${str.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n')}"`;
   }
   return str;
@@ -576,11 +663,15 @@ function _yamlValue(key, val) {
  * @returns {boolean}
  */
 function _walkAndRemoveById(dir, id) {
-  if (!fs.existsSync(dir)) return false;
+  if (!fs.existsSync(dir)) {
+    return false;
+  }
   for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
     const full = path.join(dir, entry.name);
     if (entry.isDirectory()) {
-      if (_walkAndRemoveById(full, id)) return true;
+      if (_walkAndRemoveById(full, id)) {
+        return true;
+      }
     } else if (entry.name.endsWith('.md') && !entry.name.startsWith('_')) {
       const head = fs.readFileSync(full, 'utf8').slice(0, 500);
       if (head.includes(`id: ${id}`)) {

package/lib/service/knowledge/KnowledgeGraphService.js

@@ -1,12 +1,12 @@
 /**
  * KnowledgeGraphService - 知识图谱服务
- * 
+ *
  * 管理 Recipe 之间的关系（统一模型，包含所有知识类型）
  * 支持关系查询、路径分析、PageRank 权重计算
  */
 
-import Logger from '../../infrastructure/logging/Logger.js';
 import { RelationType } from '../../domain/index.js';
+import Logger from '../../infrastructure/logging/Logger.js';
 
 // Re-export unified RelationType for backward compatibility
 export { RelationType };
@@ -23,10 +23,22 @@ export class KnowledgeGraphService {
   addEdge(fromId, fromType, toId, toType, relation, metadata = {}) {
     const now = Math.floor(Date.now() / 1000);
     try {
-      this.db.prepare(`
+      this.db
+        .prepare(`
         INSERT OR REPLACE INTO knowledge_edges (from_id, from_type, to_id, to_type, relation, weight, metadata_json, created_at, updated_at)
         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
-      `).run(fromId, fromType, toId, toType, relation, metadata.weight || 1.0, JSON.stringify(metadata), now, now);
+      `)
+        .run(
+          fromId,
+          fromType,
+          toId,
+          toType,
+          relation,
+          metadata.weight || 1.0,
+          JSON.stringify(metadata),
+          now,
+          now
+        );
 
       return { success: true };
     } catch (error) {
@@ -39,22 +51,30 @@ export class KnowledgeGraphService {
    * 删除关系边
    */
   removeEdge(fromId, fromType, toId, toType, relation) {
-    this.db.prepare(`
+    this.db
+      .prepare(`
       DELETE FROM knowledge_edges WHERE from_id = ? AND from_type = ? AND to_id = ? AND to_type = ? AND relation = ?
-    `).run(fromId, fromType, toId, toType, relation);
+    `)
+      .run(fromId, fromType, toId, toType, relation);
   }
 
   /**
    * 查询某个节点的所有关系
    */
   getEdges(nodeId, nodeType, direction = 'both') {
-    const outgoing = direction === 'both' || direction === 'out'
-      ? this.db.prepare(`SELECT * FROM knowledge_edges WHERE from_id = ? AND from_type = ?`).all(nodeId, nodeType)
-      : [];
-
-    const incoming = direction === 'both' || direction === 'in'
-      ? this.db.prepare(`SELECT * FROM knowledge_edges WHERE to_id = ? AND to_type = ?`).all(nodeId, nodeType)
-      : [];
+    const outgoing =
+      direction === 'both' || direction === 'out'
+        ? this.db
+            .prepare(`SELECT * FROM knowledge_edges WHERE from_id = ? AND from_type = ?`)
+            .all(nodeId, nodeType)
+        : [];
+
+    const incoming =
+      direction === 'both' || direction === 'in'
+        ? this.db
+            .prepare(`SELECT * FROM knowledge_edges WHERE to_id = ? AND to_type = ?`)
+            .all(nodeId, nodeType)
+        : [];
 
     return {
       outgoing: outgoing.map(this._mapEdge),
@@ -66,11 +86,13 @@ export class KnowledgeGraphService {
    * 查询指定关系类型的连接
    */
   getRelated(nodeId, nodeType, relation) {
-    const rows = this.db.prepare(`
+    const rows = this.db
+      .prepare(`
       SELECT * FROM knowledge_edges WHERE from_id = ? AND from_type = ? AND relation = ?
       UNION ALL
       SELECT * FROM knowledge_edges WHERE to_id = ? AND to_type = ? AND relation = ?
-    `).all(nodeId, nodeType, relation, nodeId, nodeType, relation);
+    `)
+      .all(nodeId, nodeType, relation, nodeId, nodeType, relation);
 
     return rows.map(this._mapEdge);
   }
@@ -84,19 +106,32 @@ export class KnowledgeGraphService {
 
     while (queue.length > 0) {
       const { id, type, path } = queue.shift();
-      
-      if (path.length >= maxDepth) continue;
-      
+
+      if (path.length >= maxDepth) {
+        continue;
+      }
+
       const key = `${type}:${id}`;
-      if (visited.has(key)) continue;
+      if (visited.has(key)) {
+        continue;
+      }
       visited.add(key);
 
-      const neighbors = this.db.prepare(`
+      const neighbors = this.db
+        .prepare(`
         SELECT to_id, to_type, relation, weight FROM knowledge_edges WHERE from_id = ? AND from_type = ?
-      `).all(id, type);
+      `)
+        .all(id, type);
 
       for (const neighbor of neighbors) {
-        const newPath = [...path, { from: { id, type }, to: { id: neighbor.to_id, type: neighbor.to_type }, relation: neighbor.relation }];
+        const newPath = [
+          ...path,
+          {
+            from: { id, type },
+            to: { id: neighbor.to_id, type: neighbor.to_type },
+            relation: neighbor.relation,
+          },
+        ];
 
         if (neighbor.to_id === toId && neighbor.to_type === toType) {
           return { found: true, path: newPath, depth: newPath.length };
@@ -118,12 +153,16 @@ export class KnowledgeGraphService {
 
     while (queue.length > 0) {
       const { id, type, depth } = queue.shift();
-      if (depth >= maxDepth) continue;
+      if (depth >= maxDepth) {
+        continue;
+      }
 
-      const dependents = this.db.prepare(`
+      const dependents = this.db
+        .prepare(`
         SELECT from_id, from_type, relation FROM knowledge_edges 
         WHERE to_id = ? AND to_type = ? AND relation IN ('requires', 'extends', 'enforces', 'depends_on', 'inherits', 'implements', 'calls', 'prerequisite')
-      `).all(id, type);
+      `)
+        .all(id, type);
 
       for (const dep of dependents) {
         const key = `${dep.from_type}:${dep.from_id}`;
@@ -149,20 +188,28 @@ export class KnowledgeGraphService {
    * @param {string} [nodeType] 过滤节点类型（如 'recipe'），为空则返回全部
    */
   getStats(nodeType) {
-    const typeFilter = nodeType ? ` WHERE from_type = '${nodeType}' AND to_type = '${nodeType}'` : '';
-    const edgeCount = this.db.prepare(`SELECT COUNT(*) as total FROM knowledge_edges${typeFilter}`).get();
-    const byRelation = this.db.prepare(
-      `SELECT relation, COUNT(*) as count FROM knowledge_edges${typeFilter} GROUP BY relation`
-    ).all();
-    const byType = this.db.prepare(
-      `SELECT from_type as type, COUNT(DISTINCT from_id) as count FROM knowledge_edges${typeFilter} GROUP BY from_type
+    const typeFilter = nodeType
+      ? ` WHERE from_type = '${nodeType}' AND to_type = '${nodeType}'`
+      : '';
+    const edgeCount = this.db
+      .prepare(`SELECT COUNT(*) as total FROM knowledge_edges${typeFilter}`)
+      .get();
+    const byRelation = this.db
+      .prepare(
+        `SELECT relation, COUNT(*) as count FROM knowledge_edges${typeFilter} GROUP BY relation`
+      )
+      .all();
+    const byType = this.db
+      .prepare(
+        `SELECT from_type as type, COUNT(DISTINCT from_id) as count FROM knowledge_edges${typeFilter} GROUP BY from_type
        UNION
        SELECT to_type as type, COUNT(DISTINCT to_id) as count FROM knowledge_edges${typeFilter} GROUP BY to_type`
-    ).all();
+      )
+      .all();
 
     return {
       totalEdges: edgeCount.total,
-      byRelation: Object.fromEntries(byRelation.map(r => [r.relation, r.count])),
+      byRelation: Object.fromEntries(byRelation.map((r) => [r.relation, r.count])),
       nodeTypes: byType,
     };
   }