autosnippet 3.0.13 → 3.1.0

package/lib/service/cursor/AgentInstructionsGenerator.js

@@ -33,10 +33,22 @@ const AGENT_BUDGET = Object.freeze({
  * MCP 工具清单 — 精简版（跟随实际 MCP handler 注册名称）
  */
 const MCP_TOOLS_SUMMARY = [
-  { name: 'autosnippet_search', desc: 'Search knowledge base (mode: auto/context/keyword/semantic)' },
-  { name: 'autosnippet_knowledge', desc: 'Knowledge CRUD (operation: list/get/insights/confirm_usage)' },
-  { name: 'autosnippet_submit_knowledge', desc: 'Submit a knowledge candidate (strict validation)' },
-  { name: 'autosnippet_submit_knowledge_batch', desc: 'Batch submit candidates (with dedup + throttle)' },
+  {
+    name: 'autosnippet_search',
+    desc: 'Search knowledge base (mode: auto/context/keyword/semantic)',
+  },
+  {
+    name: 'autosnippet_knowledge',
+    desc: 'Knowledge CRUD (operation: list/get/insights/confirm_usage)',
+  },
+  {
+    name: 'autosnippet_submit_knowledge',
+    desc: 'Submit a knowledge candidate (strict validation)',
+  },
+  {
+    name: 'autosnippet_submit_knowledge_batch',
+    desc: 'Batch submit candidates (with dedup + throttle)',
+  },
   { name: 'autosnippet_guard', desc: 'Code compliance check (single file or batch audit)' },
   { name: 'autosnippet_structure', desc: 'Project structure discovery (targets/files/metadata)' },
   { name: 'autosnippet_graph', desc: 'Knowledge graph query (query/impact/path/stats)' },
@@ -126,7 +138,9 @@ export class AgentInstructionsGenerator {
           // 有明确否定词的统一为 "Do NOT"，否则保留原文（如 "Avoid ..."）
           const hasNegPrefix = /^(Don't|Do not|Never)\s+/i.test(e.dontClause);
           if (hasNegPrefix) {
-            const stripped = e.dontClause.replace(/^(Don't|Do not|Never)\s+/i, '').replace(/\.+$/, '');
+            const stripped = e.dontClause
+              .replace(/^(Don't|Do not|Never)\s+/i, '')
+              .replace(/\.+$/, '');
             line += `. Do NOT ${stripped}`;
           } else {
             line += `. ${e.dontClause.replace(/\.+$/, '')}`;
@@ -147,14 +161,10 @@ export class AgentInstructionsGenerator {
       });
 
     // Skills 列表
-    const skillLines = skills
-      .slice(0, AGENT_BUDGET.MAX_SKILLS)
-      .map((s) => `- \`${s}\``);
+    const skillLines = skills.slice(0, AGENT_BUDGET.MAX_SKILLS).map((s) => `- \`${s}\``);
 
     // MCP 工具列表
-    const toolLines = MCP_TOOLS_SUMMARY.map(
-      (t) => `- \`${t.name}\` — ${t.desc}`
-    );
+    const toolLines = MCP_TOOLS_SUMMARY.map((t) => `- \`${t.name}\` — ${t.desc}`);
 
     return { ruleLines, patternRows, skillLines, toolLines };
   }
@@ -267,10 +277,18 @@ export class AgentInstructionsGenerator {
 
     // Key tools highlight for Claude
     lines.push('### Recommended Workflow', '');
-    lines.push('1. **Before writing code**: `autosnippet_search({ query: "<topic>" })` to find relevant patterns');
-    lines.push('2. **Check compliance**: `autosnippet_guard({ code: "<your code>" })` before committing');
-    lines.push('3. **Record knowledge**: `autosnippet_submit_knowledge({ ... })` when discovering reusable patterns');
-    lines.push('4. **Confirm adoption**: `autosnippet_knowledge({ operation: "confirm_usage", id: "<id>" })`');
+    lines.push(
+      '1. **Before writing code**: `autosnippet_search({ query: "<topic>" })` to find relevant patterns'
+    );
+    lines.push(
+      '2. **Check compliance**: `autosnippet_guard({ code: "<your code>" })` before committing'
+    );
+    lines.push(
+      '3. **Record knowledge**: `autosnippet_submit_knowledge({ ... })` when discovering reusable patterns'
+    );
+    lines.push(
+      '4. **Confirm adoption**: `autosnippet_knowledge({ operation: "confirm_usage", id: "<id>" })`'
+    );
     lines.push('');
 
     // Skills

package/lib/service/cursor/CursorDeliveryPipeline.js

@@ -101,7 +101,8 @@ export class CursorDeliveryPipeline {
 
       // NOTE: .qoder/ .trae/ 镜像不再自动执行，由 `asd mirror` 按需触发
 
-      stats.totalTokensUsed = channelA.tokensUsed + channelB.totalTokens + (channelF.totalTokens || 0);
+      stats.totalTokensUsed =
+        channelA.tokensUsed + channelB.totalTokens + (channelF.totalTokens || 0);
       stats.duration = Date.now() - startTime;
 
       this.logger.info?.(

package/lib/service/cursor/KnowledgeCompressor.js

@@ -15,16 +15,22 @@
 
 /** 从 rationale 提取首句（≤120 字符），用于 Channel B 的 Why 行 */
 function _extractFirstSentence(rationale) {
-  if (!rationale) return '';
+  if (!rationale) {
+    return '';
+  }
   // 优先按句号或换行分割
   const first = rationale.split(/[.\n。！？!?]/)[0]?.trim();
-  if (!first) return '';
+  if (!first) {
+    return '';
+  }
   return first.length > 120 ? `${first.slice(0, 117)}...` : first;
 }
 
 /** 骨架化 coreCode：去注释 + 截断 ≤ maxLines 行 */
 function _skeletonize(code, maxLines = 15) {
-  if (!code) return '';
+  if (!code) {
+    return '';
+  }
   const lines = code
     .split('\n')
     // 去掉纯注释行（// 或 /* 或 * (JSDoc续行) 或 # 开头）
@@ -37,7 +43,9 @@ function _skeletonize(code, maxLines = 15) {
       acc.push(line);
       return acc;
     }, []);
-  if (lines.length <= maxLines) return lines.join('\n');
+  if (lines.length <= maxLines) {
+    return lines.join('\n');
+  }
   return `${lines.slice(0, maxLines).join('\n')}\n// ... (truncated)`;
 }
 
@@ -56,13 +64,14 @@ export class KnowledgeCompressor {
       .filter((e) => e.doClause) // 无 doClause → 跳过，不猜
       .map((e) => {
         // 可选 language 前缀
-        const langPrefix =
-          e.language && e.scope !== 'universal' ? `[${e.language}] ` : '';
+        const langPrefix = e.language && e.scope !== 'universal' ? `[${e.language}] ` : '';
         const doText = e.doClause.replace(/\.+$/, ''); // 去尾 .
         let line = `${langPrefix}${doText}`;
         if (e.dontClause) {
           // AI 可能返回 "Don't ..." / "Do not ..." / "Never ..." 开头，去掉冗余前缀后统一为 "Do NOT"
-          const stripped = e.dontClause.replace(/^(Don't|Do not|Never)\s+/i, '').replace(/\.+$/, '');
+          const stripped = e.dontClause
+            .replace(/^(Don't|Do not|Never)\s+/i, '')
+            .replace(/\.+$/, '');
           line += `. Do NOT ${stripped}`;
         }
         return `- ${line}.`;

package/lib/service/guard/ComplianceReporter.js

@@ -283,11 +283,14 @@ export class ComplianceReporter {
 
     const lines = [];
     lines.push(`${gateIcon} Quality Gate: ${qualityGate.status}  Score: ${qualityGate.score}/100`);
-    lines.push(`   Files: ${summary.filesScanned}  Errors: ${summary.errors}  Warnings: ${summary.warnings}  Infos: ${summary.infos || 0}`);
+    lines.push(
+      `   Files: ${summary.filesScanned}  Errors: ${summary.errors}  Warnings: ${summary.warnings}  Infos: ${summary.infos || 0}`
+    );
 
     if (trend.hasHistory) {
       const errTrend = trend.errorsChange > 0 ? `+${trend.errorsChange}` : `${trend.errorsChange}`;
-      const warnTrend = trend.warningsChange > 0 ? `+${trend.warningsChange}` : `${trend.warningsChange}`;
+      const warnTrend =
+        trend.warningsChange > 0 ? `+${trend.warningsChange}` : `${trend.warningsChange}`;
       lines.push(`   Trend: Errors ${errTrend}  Warnings ${warnTrend}`);
     }
 

package/lib/service/guard/GuardCheckEngine.js

@@ -8,9 +8,15 @@
 import * as AstAnalyzerModule from '../../core/AstAnalyzer.js';
 import Logger from '../../infrastructure/logging/Logger.js';
 import { LanguageService } from '../../shared/LanguageService.js';
-import { compilePattern, clearPatternCache, buildTestBlockMask, buildCommentMask, detectLanguage } from './GuardPatternUtils.js';
 import { runCodeLevelChecks } from './GuardCodeChecks.js';
 import { runCrossFileChecks } from './GuardCrossFileChecks.js';
+import {
+  buildCommentMask,
+  buildTestBlockMask,
+  clearPatternCache,
+  compilePattern,
+  detectLanguage,
+} from './GuardPatternUtils.js';
 
 /**
  * 内置默认规则集 — 多语言基础规则
@@ -125,7 +131,8 @@ const BUILT_IN_RULES = {
     languages: ['javascript', 'typescript'],
     dimension: 'file',
     category: 'style',
-    excludePaths: /(?:^|[\/\\])(?:test|tests|__tests__|spec|__mocks__|mock|mocks|fixtures?)[\/\\]|[\/\\](?:test_|spec_)[^\/\\]*\.(?:js|ts)$|\.(?:test|spec)\.(?:js|ts)$/,
+    excludePaths:
+      /(?:^|[/\\])(?:test|tests|__tests__|spec|__mocks__|mock|mocks|fixtures?)[/\\]|[/\\](?:test_|spec_)[^/\\]*\.(?:js|ts)$|\.(?:test|spec)\.(?:js|ts)$/,
   },
   'js-no-console-log': {
     message: '生产代码应移除 console.log，使用专用日志库',
@@ -134,7 +141,8 @@ const BUILT_IN_RULES = {
     languages: ['javascript', 'typescript'],
     dimension: 'file',
     category: 'style',
-    excludePaths: /(?:^|[\/\\])(?:test|tests|__tests__|spec|mock|mocks|__mocks__|scripts|tools|debug)[\/\\]|[\/\\](?:test_|spec_|mock)[^\/\\]*\.(?:js|ts)$|\.(?:test|spec)\.(?:js|ts)$/,
+    excludePaths:
+      /(?:^|[/\\])(?:test|tests|__tests__|spec|mock|mocks|__mocks__|scripts|tools|debug)[/\\]|[/\\](?:test_|spec_|mock)[^/\\]*\.(?:js|ts)$|\.(?:test|spec)\.(?:js|ts)$/,
   },
   'js-no-debugger': {
     message: '生产代码中不应包含 debugger 语句',
@@ -204,7 +212,7 @@ const BUILT_IN_RULES = {
     languages: ['python'],
     dimension: 'file',
     category: 'correctness',
-    excludePaths: /(?:^|[\/\\])tests?[\/\\]|[\/\\]test_[^\/\\]*\.py$|_test\.py$/,
+    excludePaths: /(?:^|[/\\])tests?[/\\]|[/\\]test_[^/\\]*\.py$|_test\.py$/,
   },
 
   // ══════════════════════════════════════════════════════════
@@ -272,7 +280,7 @@ const BUILT_IN_RULES = {
     languages: ['go'],
     dimension: 'file',
     category: 'correctness',
-    excludePaths: /(?:^|[\/\\])(?:tests?|testdata|_test)[\/\\]|_test\.go$/,
+    excludePaths: /(?:^|[/\\])(?:tests?|testdata|_test)[/\\]|_test\.go$/,
   },
   'go-no-init-abuse': {
     message: 'init() 函数副作用难以追踪，避免在 init 中执行复杂逻辑',
@@ -289,7 +297,7 @@ const BUILT_IN_RULES = {
     languages: ['go'],
     dimension: 'file',
     category: 'style',
-    excludePaths: /(?:^|[\/\\])(?:tests?|testdata)[\/\\]|_test\.go$/,
+    excludePaths: /(?:^|[/\\])(?:tests?|testdata)[/\\]|_test\.go$/,
   },
 
   // ══════════════════════════════════════════════════════════
@@ -311,7 +319,8 @@ const BUILT_IN_RULES = {
     languages: ['dart'],
     dimension: 'file',
     category: 'style',
-    fixSuggestion: '使用 Object? 或具体类型替代 dynamic；Map<String, dynamic> 用于 JSON 序列化时可保留',
+    fixSuggestion:
+      '使用 Object? 或具体类型替代 dynamic；Map<String, dynamic> 用于 JSON 序列化时可保留',
   },
   'dart-no-set-state-after-dispose': {
     message: 'setState 调用前应检查 mounted 状态，避免 disposed 后调用',
@@ -344,7 +353,7 @@ const BUILT_IN_RULES = {
   'dart-no-relative-import': {
     message: 'lib/ 目录内应使用 package: 形式的绝对导入，避免相对路径导入',
     severity: 'info',
-    pattern: "import\\s+['\"]\\.\\.?/",
+    pattern: 'import\\s+[\'"]\\.\\.?/',
     languages: ['dart'],
     dimension: 'file',
     category: 'style',
@@ -352,7 +361,8 @@ const BUILT_IN_RULES = {
   'dart-dispose-controller': {
     message: 'TextEditingController/AnimationController 等须在 dispose() 中释放',
     severity: 'warning',
-    pattern: '(?:TextEditingController|AnimationController|ScrollController|FocusNode|TabController)\\(',
+    pattern:
+      '(?:TextEditingController|AnimationController|ScrollController|FocusNode|TabController)\\(',
     languages: ['dart'],
     dimension: 'file',
     category: 'correctness',
@@ -380,7 +390,8 @@ const BUILT_IN_RULES = {
     dimension: 'file',
     category: 'correctness',
     fixSuggestion: '使用 ? 操作符传播错误，或 .unwrap_or_default() / .expect("原因")',
-    excludePaths: /(?:^|[\/\\])(?:tests?|test_helpers|benches|examples)[\/\\]|[\/\\]test_[^\/\\]*\.rs$|_test\.rs$/,
+    excludePaths:
+      /(?:^|[/\\])(?:tests?|test_helpers|benches|examples)[/\\]|[/\\]test_[^/\\]*\.rs$|_test\.rs$/,
     skipComments: true,
     skipTestBlocks: true,
   },
@@ -409,7 +420,7 @@ const BUILT_IN_RULES = {
     languages: ['rust'],
     dimension: 'file',
     category: 'correctness',
-    excludePaths: /(?:^|[\/\\])(?:tests?|test_helpers|benches|examples)[\/\\]|_test\.rs$/,
+    excludePaths: /(?:^|[/\\])(?:tests?|test_helpers|benches|examples)[/\\]|_test\.rs$/,
     skipComments: true,
     skipTestBlocks: true,
   },
@@ -421,7 +432,7 @@ const BUILT_IN_RULES = {
     dimension: 'file',
     category: 'performance',
     fixSuggestion: '分析是否可用 &T 借用替代，或使用 Cow<T> 延迟克隆',
-    excludePaths: /(?:^|[\/\\])(?:tests?|test_helpers|benches|examples)[\/\\]|_test\.rs$/,
+    excludePaths: /(?:^|[/\\])(?:tests?|test_helpers|benches|examples)[/\\]|_test\.rs$/,
     skipComments: true,
     skipTestBlocks: true,
   },
@@ -432,7 +443,7 @@ const BUILT_IN_RULES = {
     languages: ['rust'],
     dimension: 'file',
     category: 'correctness',
-    excludePaths: /(?:^|[\/\\])(?:tests?|test_helpers|benches|examples)[\/\\]|main\.rs$/,
+    excludePaths: /(?:^|[/\\])(?:tests?|test_helpers|benches|examples)[/\\]|main\.rs$/,
     skipComments: true,
     skipTestBlocks: true,
   },
@@ -454,7 +465,6 @@ const BUILT_IN_RULES = {
     category: 'performance',
     fixSuggestion: '使用 Vec<&str> 收集后 .join()，或 String::with_capacity 预分配',
   },
-
 };
 
 // 向后兼容: 从 GuardPatternUtils 重新导出 detectLanguage
@@ -489,13 +499,20 @@ export class GuardCheckEngine {
    * @param {Array<{ruleId: string, pattern: RegExp|string, severity: string, message: string, category?: string, dimension?: string, languages?: string[], fixSuggestion?: string}>} rules
    */
   injectExternalRules(rules) {
-    if (!Array.isArray(rules)) return;
+    if (!Array.isArray(rules)) {
+      return;
+    }
     for (const rule of rules) {
-      if (!rule.ruleId) continue;
+      if (!rule.ruleId) {
+        continue;
+      }
       // 已注入的 ruleId 跳过（幂等）
-      if (this._externalRules.has(rule.ruleId)) continue;
+      if (this._externalRules.has(rule.ruleId)) {
+        continue;
+      }
       // 跳过与 BUILT_IN_RULES 重复的模式（通过比较 pattern 源文本）
-      const rulePatternStr = rule.pattern instanceof RegExp ? rule.pattern.source : String(rule.pattern || '');
+      const rulePatternStr =
+        rule.pattern instanceof RegExp ? rule.pattern.source : String(rule.pattern || '');
       const isDuplicate = Object.entries(this._builtInRules).some(([, builtIn]) => {
         return builtIn.pattern === rulePatternStr;
       });
@@ -517,14 +534,20 @@ export class GuardCheckEngine {
         fixSuggestion: rule.fixSuggestion || null,
       });
     }
-    this.logger.debug(`[GuardCheckEngine] External rules injected: ${this._externalRules.size} active`);
+    this.logger.debug(
+      `[GuardCheckEngine] External rules injected: ${this._externalRules.size} active`
+    );
   }
 
   /**
    * EP 注入幂等标记 — 调用者可用此判断是否已完成注入，避免重复加载 EnhancementRegistry
    */
-  isEpInjected() { return this._epInjected; }
-  markEpInjected() { this._epInjected = true; }
+  isEpInjected() {
+    return this._epInjected;
+  }
+  markEpInjected() {
+    this._epInjected = true;
+  }
 
   /**
    * 获取所有启用的规则 (数据库 + 内置)
@@ -665,7 +688,9 @@ export class GuardCheckEngine {
     // 按 excludePaths 过滤（测试文件排除等）
     if (filePath) {
       rules = rules.filter((r) => {
-        if (!r.excludePaths) return true;
+        if (!r.excludePaths) {
+          return true;
+        }
         const re = r.excludePaths instanceof RegExp ? r.excludePaths : new RegExp(r.excludePaths);
         return !re.test(filePath);
       });
@@ -735,10 +760,12 @@ export class GuardCheckEngine {
     }
 
     // Code-level 检查（不依赖正则）
-    violations.push(...runCodeLevelChecks(code, language, lines, {
-      disabledRules: this._guardConfig.disabledRules,
-      codeLevelThresholds: this._guardConfig.codeLevelThresholds,
-    }));
+    violations.push(
+      ...runCodeLevelChecks(code, language, lines, {
+        disabledRules: this._guardConfig.disabledRules,
+        codeLevelThresholds: this._guardConfig.codeLevelThresholds,
+      })
+    );
 
     // AST 语义规则检查
     violations.push(...this._runAstRuleChecks(code, language));