autosnippet 3.0.1 → 3.0.2

package/lib/service/cursor/SkillsSyncer.js

@@ -25,21 +25,44 @@ const SKILL_NAME_MAP = {
   'project-objc-deep-scan': 'autosnippet-objc-deep-scan',
   'project-category-scan': 'autosnippet-category-scan',
   'project-best-practice': 'autosnippet-best-practice',
+  // 新语言维度
+  'project-module-exports': 'autosnippet-module-exports',
+  'project-framework-conventions': 'autosnippet-framework-conventions',
+  'project-python-structure': 'autosnippet-python-structure',
+  'project-jvm-annotations': 'autosnippet-jvm-annotations',
 };
 
 /**
  * 用途描述模板（英文，Cursor 优先）
  */
 const SKILL_DESC_MAP = {
-  'autosnippet-architecture': 'Architecture patterns, module boundaries, and dependency rules for {project}. Use when creating new modules, reviewing architecture, or understanding dependencies.',
-  'autosnippet-code-standard': 'Coding standards and style conventions for {project}. Use when writing new code, reviewing formatting, or enforcing naming conventions.',
-  'autosnippet-profile': 'Project overview and profile for {project}. Use when needing background on the project, its tech stack, or structure.',
-  'autosnippet-guidelines': 'Agent interaction guidelines for {project}. Use when understanding how to work with this specific project.',
-  'autosnippet-data-flow': 'Event and data flow patterns for {project}. Use when working with events, state management, or data pipelines.',
-  'autosnippet-code-pattern': 'Common code patterns and idioms for {project}. Use when implementing features following project conventions.',
-  'autosnippet-objc-deep-scan': 'Objective-C deep scan results for {project}. Use when working with Objective-C code, method swizzling, or runtime features.',
-  'autosnippet-category-scan': 'Category and extension analysis for {project}. Use when working with categories or finding existing utility methods.',
-  'autosnippet-best-practice': 'Best practices and proven patterns for {project}. Use when making design decisions or code review.',
+  'autosnippet-architecture':
+    'Architecture patterns, module boundaries, and dependency rules for {project}. Use when creating new modules, reviewing architecture, or understanding dependencies.',
+  'autosnippet-code-standard':
+    'Coding standards and style conventions for {project}. Use when writing new code, reviewing formatting, or enforcing naming conventions.',
+  'autosnippet-profile':
+    'Project overview and profile for {project}. Use when needing background on the project, its tech stack, or structure.',
+  'autosnippet-guidelines':
+    'Agent interaction guidelines for {project}. Use when understanding how to work with this specific project.',
+  'autosnippet-data-flow':
+    'Event and data flow patterns for {project}. Use when working with events, state management, or data pipelines.',
+  'autosnippet-code-pattern':
+    'Common code patterns and idioms for {project}. Use when implementing features following project conventions.',
+  'autosnippet-objc-deep-scan':
+    'Objective-C deep scan results for {project}. Use when working with Objective-C code, method swizzling, or runtime features.',
+  'autosnippet-category-scan':
+    'Category and extension analysis for {project}. Use when working with categories or finding existing utility methods.',
+  'autosnippet-best-practice':
+    'Best practices and proven patterns for {project}. Use when making design decisions or code review.',
+  // 新语言维度
+  'autosnippet-module-exports':
+    'Module export structure, barrel exports, and public API surface for {project}. Use when working with imports/exports or module boundaries.',
+  'autosnippet-framework-conventions':
+    'Framework-specific conventions (component structure, routing, state management) for {project}. Use when following framework patterns.',
+  'autosnippet-python-structure':
+    'Python package structure, __init__.py exports, import patterns and type hint coverage for {project}. Use when working with Python modules.',
+  'autosnippet-jvm-annotations':
+    'Annotation patterns (DI, ORM, API, custom) and meta-programming for {project}. Use when working with Spring, Jakarta, or framework annotations.',
 };
 
 export class SkillsSyncer {
@@ -69,9 +92,10 @@ export class SkillsSyncer {
     }
 
     // 扫描源目录
-    const skillDirs = fs.readdirSync(this.sourceDir, { withFileTypes: true })
-      .filter(d => d.isDirectory())
-      .map(d => d.name);
+    const skillDirs = fs
+      .readdirSync(this.sourceDir, { withFileTypes: true })
+      .filter((d) => d.isDirectory())
+      .map((d) => d.name);
 
     for (const dirName of skillDirs) {
       try {
@@ -81,7 +105,8 @@ export class SkillsSyncer {
           continue;
         }
 
-        const targetName = SKILL_NAME_MAP[dirName] || `autosnippet-${dirName.replace(/^project-/, '')}`;
+        const targetName =
+          SKILL_NAME_MAP[dirName] || `autosnippet-${dirName.replace(/^project-/, '')}`;
         const targetSkillDir = path.join(this.targetDir, targetName);
 
         // 创建目标目录
@@ -118,7 +143,9 @@ export class SkillsSyncer {
     const body = bodyMatch ? bodyMatch[1].trim() : source.trim();
 
     // 获取描述
-    const descTemplate = SKILL_DESC_MAP[targetName] || `Knowledge and patterns from {project}. Use when working with ${sourceDirName.replace(/^project-/, '')} related code.`;
+    const descTemplate =
+      SKILL_DESC_MAP[targetName] ||
+      `Knowledge and patterns from {project}. Use when working with ${sourceDirName.replace(/^project-/, '')} related code.`;
     const description = descTemplate.replace(/\{project\}/g, this.projectName);
 
     // 构建 Cursor 标准格式
@@ -147,7 +174,7 @@ export class SkillsSyncer {
       '',
       'See `references/RECIPES.md` for related recipe summaries.',
     ];
-    return lines.join('\n') + '\n';
+    return `${lines.join('\n')}\n`;
   }
 
   /**
@@ -168,7 +195,9 @@ export class SkillsSyncer {
           { page: 1, pageSize: 50 }
         );
         recipes = result?.items || result?.data || [];
-        if (Array.isArray(result)) recipes = result;
+        if (Array.isArray(result)) {
+          recipes = result;
+        }
       } catch {
         // 忽略查询错误
       }
@@ -176,10 +205,7 @@ export class SkillsSyncer {
 
     // 生成 RECIPES.md
     const dimensionLabel = sourceDirName.replace(/^project-/, '').replace(/-/g, ' ');
-    const lines = [
-      `# ${this._capitalizeWords(dimensionLabel)} Recipes`,
-      '',
-    ];
+    const lines = [`# ${this._capitalizeWords(dimensionLabel)} Recipes`, ''];
 
     if (recipes.length > 0) {
       lines.push('| Title | Trigger | Summary |');
@@ -187,7 +213,9 @@ export class SkillsSyncer {
       for (const entry of recipes.slice(0, 20)) {
         const title = (entry.title || '').replace(/\|/g, '/');
         const trigger = entry.trigger || '-';
-        const summary = (entry.summaryCn || entry.description || '').replace(/\|/g, '/').slice(0, 80);
+        const summary = (entry.summaryCn || entry.description || '')
+          .replace(/\|/g, '/')
+          .slice(0, 80);
         lines.push(`| ${title} | ${trigger} | ${summary} |`);
       }
     } else {
@@ -197,7 +225,7 @@ export class SkillsSyncer {
     lines.push('');
     lines.push(`For full content, use: \`autosnippet_search("${dimensionLabel}")\``);
 
-    fs.writeFileSync(path.join(refsDir, 'RECIPES.md'), lines.join('\n') + '\n', 'utf8');
+    fs.writeFileSync(path.join(refsDir, 'RECIPES.md'), `${lines.join('\n')}\n`, 'utf8');
   }
 
   /**
@@ -250,18 +278,40 @@ export class SkillsSyncer {
         '- Code review and quality improvements',
         '- Choosing between implementation approaches',
       ],
+      'project-module-exports': [
+        '- Working with module imports and exports',
+        '- Understanding the public API surface',
+        '- Refactoring barrel exports or re-export chains',
+      ],
+      'project-framework-conventions': [
+        '- Following framework-specific patterns (React/Vue/Angular)',
+        '- Organizing components and routes',
+        '- Implementing state management patterns',
+      ],
+      'project-python-structure': [
+        '- Working with Python modules and packages',
+        '- Understanding import patterns and __init__.py exports',
+        '- Adding type hints or decorators',
+      ],
+      'project-jvm-annotations': [
+        '- Working with dependency injection annotations',
+        '- Configuring ORM entities and API endpoints',
+        '- Using or creating custom annotations',
+      ],
     };
-    return casesMap[sourceDirName] || [
-      '- Working with code related to this dimension',
-      '- Need guidance on project-specific patterns',
-    ];
+    return (
+      casesMap[sourceDirName] || [
+        '- Working with code related to this dimension',
+        '- Need guidance on project-specific patterns',
+      ]
+    );
   }
 
   /**
    * @private
    */
   _capitalizeWords(str) {
-    return str.replace(/\b\w/g, c => c.toUpperCase());
+    return str.replace(/\b\w/g, (c) => c.toUpperCase());
   }
 }
 

package/lib/service/cursor/TokenBudget.js

@@ -10,10 +10,10 @@ export { estimateTokens };
 
 /** 默认预算配置 */
 export const BUDGET = {
-  CHANNEL_A_MAX: 400,        // Always-On Rules 最大 token
+  CHANNEL_A_MAX: 400, // Always-On Rules 最大 token
   CHANNEL_B_MAX_PER_FILE: 750, // Smart Rules 每个主题文件最大 token
   CHANNEL_B_MAX_PATTERNS: 5, // Smart Rules 每个主题最多模式数
-  CHANNEL_A_MAX_RULES: 8,    // Always-On Rules 最多规则数
+  CHANNEL_A_MAX_RULES: 8, // Always-On Rules 最多规则数
 };
 
 /**

package/lib/service/cursor/TopicClassifier.js

@@ -14,23 +14,28 @@
 const TOPIC_MAP = {
   networking: {
     dimensions: ['event-and-data-flow'],
-    descriptionKeywords: 'network, HTTP, API, request, response, URL, fetch, socket, REST, download, upload, error handling, retry, timeout',
+    descriptionKeywords:
+      'network, HTTP, API, request, response, URL, fetch, socket, REST, download, upload, error handling, retry, timeout',
   },
   ui: {
     dimensions: ['code-pattern'],
-    descriptionKeywords: 'view, controller, UI, layout, animation, cell, table, collection, button, scroll, navigation, auto layout, gesture, storyboard',
+    descriptionKeywords:
+      'view, controller, UI, layout, animation, cell, table, collection, button, scroll, navigation, auto layout, gesture, storyboard',
   },
   data: {
     dimensions: ['code-pattern', 'architecture'],
-    descriptionKeywords: 'model, storage, database, cache, CoreData, Realm, SQLite, keychain, UserDefaults, JSON, parsing, serialization, persistence',
+    descriptionKeywords:
+      'model, storage, database, cache, CoreData, Realm, SQLite, keychain, UserDefaults, JSON, parsing, serialization, persistence',
   },
   architecture: {
     dimensions: ['architecture', 'best-practice'],
-    descriptionKeywords: 'singleton, delegate, factory, observer, protocol, manager, service, dependency injection, module, MVVM, MVC, coordinator, router, design pattern',
+    descriptionKeywords:
+      'singleton, delegate, factory, observer, protocol, manager, service, dependency injection, module, MVVM, MVC, coordinator, router, design pattern',
   },
   conventions: {
     dimensions: ['code-standard'],
-    descriptionKeywords: 'naming, format, style, import, header, prefix, convention, documentation, file organization, constants, enum, typedef, pragma mark',
+    descriptionKeywords:
+      'naming, format, style, import, header, prefix, convention, documentation, file organization, constants, enum, typedef, pragma mark',
   },
 };
 
@@ -54,7 +59,9 @@ export class TopicClassifier {
     for (const entry of entries) {
       const topic = this._classifyEntry(entry);
       if (topic) {
-        if (!grouped[topic]) grouped[topic] = [];
+        if (!grouped[topic]) {
+          grouped[topic] = [];
+        }
         grouped[topic].push(entry);
       } else {
         unmatched.push(entry);
@@ -79,13 +86,13 @@ export class TopicClassifier {
     const topicDef = TOPIC_MAP[topic];
     const baseKeywords = topicDef
       ? topicDef.descriptionKeywords
-      : entries.map(e => (e.title || '')).filter(Boolean).join(', ');
+      : entries
+          .map((e) => e.title || '')
+          .filter(Boolean)
+          .join(', ');
 
     // 从 entries 提取额外关键词
-    const entryKeywords = entries
-      .map(e => this._extractKeywords(e))
-      .flat()
-      .filter(Boolean);
+    const entryKeywords = entries.flatMap((e) => this._extractKeywords(e)).filter(Boolean);
     const unique = [...new Set(entryKeywords)].slice(0, 10);
     const extra = unique.length > 0 ? `, ${unique.join(', ')}` : '';
 
@@ -97,7 +104,7 @@ export class TopicClassifier {
    * @private
    */
   _classifyEntry(entry) {
-    return entry.topicHint || null;    // AI 没给 → null → 归入 general
+    return entry.topicHint || null; // AI 没给 → null → 归入 general
   }
 
   /**
@@ -105,12 +112,10 @@ export class TopicClassifier {
    * @private
    */
   _extractKeywords(entry) {
-    const text = (entry.title || '') + ' ' + (entry.description || '');
+    const text = `${entry.title || ''} ${entry.description || ''}`;
     // 提取英文关键词（3+ 字母）
     const words = text.match(/[a-zA-Z]{3,}/g) || [];
-    const filtered = words
-      .map(w => w.toLowerCase())
-      .filter(w => !STOP_WORDS.has(w));
+    const filtered = words.map((w) => w.toLowerCase()).filter((w) => !STOP_WORDS.has(w));
     return [...new Set(filtered)].slice(0, 5);
   }
 
@@ -132,10 +137,39 @@ export class TopicClassifier {
 
 /** @type {Set<string>} */
 const STOP_WORDS = new Set([
-  'the', 'and', 'for', 'this', 'that', 'with', 'from', 'use', 'using',
-  'when', 'not', 'all', 'are', 'has', 'have', 'been', 'will', 'can',
-  'should', 'must', 'may', 'each', 'which', 'their', 'your', 'its',
-  'project', 'code', 'file', 'class', 'method', 'function', 'bootstrap',
+  'the',
+  'and',
+  'for',
+  'this',
+  'that',
+  'with',
+  'from',
+  'use',
+  'using',
+  'when',
+  'not',
+  'all',
+  'are',
+  'has',
+  'have',
+  'been',
+  'will',
+  'can',
+  'should',
+  'must',
+  'may',
+  'each',
+  'which',
+  'their',
+  'your',
+  'its',
+  'project',
+  'code',
+  'file',
+  'class',
+  'method',
+  'function',
+  'bootstrap',
 ]);
 
 export default TopicClassifier;

package/lib/service/guard/ComplianceReporter.js

@@ -13,8 +13,8 @@
  */
 
 import Logger from '../../infrastructure/logging/Logger.js';
-import { collectSourceFilesWithContent } from './SourceFileCollector.js';
 import { COMPLIANCE_SCORING, QUALITY_GATE } from '../../shared/constants.js';
+import { collectSourceFilesWithContent } from './SourceFileCollector.js';
 
 /**
  * Quality Gate 评分算法
@@ -30,11 +30,15 @@ function computeScore(summary, ruleHealth = []) {
   // 加分：规则平均 F1 > 阈值加分
   if (ruleHealth.length > 0) {
     const avgF1 = ruleHealth.reduce((s, r) => s + (r.f1 || 0), 0) / ruleHealth.length;
-    if (avgF1 > COMPLIANCE_SCORING.HIGH_F1_THRESHOLD) score += COMPLIANCE_SCORING.HIGH_F1_BONUS;
+    if (avgF1 > COMPLIANCE_SCORING.HIGH_F1_THRESHOLD) {
+      score += COMPLIANCE_SCORING.HIGH_F1_BONUS;
+    }
   }
 
   // 扣分：高误报规则每条扣分
-  const problematic = ruleHealth.filter(r => (r.precision || 1) < COMPLIANCE_SCORING.LOW_PRECISION_THRESHOLD);
+  const problematic = ruleHealth.filter(
+    (r) => (r.precision || 1) < COMPLIANCE_SCORING.LOW_PRECISION_THRESHOLD
+  );
   score -= problematic.length * COMPLIANCE_SCORING.PROBLEMATIC_RULE_PENALTY;
 
   return Math.max(0, Math.min(100, Math.round(score)));
@@ -44,11 +48,21 @@ function computeScore(summary, ruleHealth = []) {
  * 判定 Quality Gate 状态
  */
 function evaluateGate(summary, score, thresholds) {
-  const { maxErrors = QUALITY_GATE.MAX_ERRORS, maxWarnings = QUALITY_GATE.MAX_WARNINGS, minScore = QUALITY_GATE.MIN_SCORE } = thresholds;
-
-  if (summary.errors > maxErrors) return 'FAIL';
-  if (score < minScore) return 'FAIL';
-  if (summary.warnings > maxWarnings) return 'WARN';
+  const {
+    maxErrors = QUALITY_GATE.MAX_ERRORS,
+    maxWarnings = QUALITY_GATE.MAX_WARNINGS,
+    minScore = QUALITY_GATE.MIN_SCORE,
+  } = thresholds;
+
+  if (summary.errors > maxErrors) {
+    return 'FAIL';
+  }
+  if (score < minScore) {
+    return 'FAIL';
+  }
+  if (summary.warnings > maxWarnings) {
+    return 'WARN';
+  }
   return 'PASS';
 }
 
@@ -60,7 +74,13 @@ export class ComplianceReporter {
    * @param {import('./ExclusionManager.js').ExclusionManager} exclusionManager
    * @param {object} qualityGateConfig - { maxErrors, maxWarnings, minScore }
    */
-  constructor(guardCheckEngine, violationsStore, ruleLearner, exclusionManager, qualityGateConfig = {}) {
+  constructor(
+    guardCheckEngine,
+    violationsStore,
+    ruleLearner,
+    exclusionManager,
+    qualityGateConfig = {}
+  ) {
     this.engine = guardCheckEngine;
     this.violationsStore = violationsStore;
     this.ruleLearner = ruleLearner;
@@ -96,11 +116,15 @@ export class ComplianceReporter {
     // 3. 通过 ExclusionManager 过滤被排除的项
     const filteredFiles = [];
     for (const fileResult of auditResult.files || []) {
-      if (this.exclusionManager?.isPathExcluded?.(fileResult.filePath)) continue;
+      if (this.exclusionManager?.isPathExcluded?.(fileResult.filePath)) {
+        continue;
+      }
 
-      const filteredViolations = fileResult.violations.filter(v => {
+      const filteredViolations = fileResult.violations.filter((v) => {
         // isRuleExcluded 内部已检查全局排除
-        if (this.exclusionManager?.isRuleExcluded?.(v.ruleId, fileResult.filePath)) return false;
+        if (this.exclusionManager?.isRuleExcluded?.(v.ruleId, fileResult.filePath)) {
+          return false;
+        }
         return true;
       });
 
@@ -109,9 +133,9 @@ export class ComplianceReporter {
         violations: filteredViolations,
         summary: {
           total: filteredViolations.length,
-          errors: filteredViolations.filter(v => v.severity === 'error').length,
-          warnings: filteredViolations.filter(v => v.severity === 'warning').length,
-          infos: filteredViolations.filter(v => v.severity === 'info').length,
+          errors: filteredViolations.filter((v) => v.severity === 'error').length,
+          warnings: filteredViolations.filter((v) => v.severity === 'warning').length,
+          infos: filteredViolations.filter((v) => v.severity === 'info').length,
         },
       });
     }
@@ -151,14 +175,14 @@ export class ComplianceReporter {
     }
 
     const topViolations = [...ruleAgg.values()]
-      .map(v => ({ ...v, fileCount: v.fileCount.size }))
+      .map((v) => ({ ...v, fileCount: v.fileCount.size }))
       .sort((a, b) => b.occurrences - a.occurrences)
       .slice(0, 20);
 
     // 6. 文件热点
     const fileHotspots = filteredFiles
-      .filter(f => f.summary.total > 0)
-      .map(f => ({
+      .filter((f) => f.summary.total > 0)
+      .map((f) => ({
         filePath: f.filePath,
         violationCount: f.summary.total,
         errorCount: f.summary.errors,
@@ -201,8 +225,8 @@ export class ComplianceReporter {
     // 10. 写入 ViolationsStore（记录本次运行）
     try {
       if (this.violationsStore?.appendRun) {
-        const allViolations = filteredFiles.flatMap(f =>
-          f.violations.map(v => ({ ...v, filePath: f.filePath }))
+        const allViolations = filteredFiles.flatMap((f) =>
+          f.violations.map((v) => ({ ...v, filePath: f.filePath }))
         );
         this.violationsStore.appendRun({
           filePath: projectRoot,
@@ -239,7 +263,6 @@ export class ComplianceReporter {
     const { format = 'text' } = options;
 
     if (format === 'json') {
-      console.log(JSON.stringify(report, null, 2));
       return;
     }
 
@@ -253,38 +276,27 @@ export class ComplianceReporter {
   }
 
   _printText(report) {
-    const { qualityGate, summary, topViolations, fileHotspots, trend } = report;
+    const { qualityGate, topViolations, fileHotspots, trend } = report;
 
-    const gateIcon = qualityGate.status === 'PASS' ? '✅' : qualityGate.status === 'WARN' ? '⚠️' : '❌';
-    console.log(`\n${'═'.repeat(60)}`);
-    console.log(`  🛡️  Guard Compliance Report`);
-    console.log(`${'═'.repeat(60)}`);
-    console.log(`  ${gateIcon} Quality Gate: ${qualityGate.status}  (Score: ${qualityGate.score}/100)`);
-    console.log(`  📁 Files Scanned: ${summary.filesScanned}`);
-    console.log(`  📊 Violations: ${summary.errors} errors, ${summary.warnings} warnings, ${summary.infos || 0} infos`);
+    const _gateIcon =
+      qualityGate.status === 'PASS' ? '✅' : qualityGate.status === 'WARN' ? '⚠️' : '❌';
 
     if (trend.hasHistory) {
-      const errTrend = trend.errorsChange > 0 ? `+${trend.errorsChange}` : `${trend.errorsChange}`;
-      const warnTrend = trend.warningsChange > 0 ? `+${trend.warningsChange}` : `${trend.warningsChange}`;
-      console.log(`  📈 Trend: errors ${errTrend}, warnings ${warnTrend}`);
+      const _errTrend = trend.errorsChange > 0 ? `+${trend.errorsChange}` : `${trend.errorsChange}`;
+      const _warnTrend =
+        trend.warningsChange > 0 ? `+${trend.warningsChange}` : `${trend.warningsChange}`;
     }
 
     if (topViolations.length > 0) {
-      console.log(`\n  Top Violations:`);
       for (const v of topViolations.slice(0, 10)) {
-        const fix = v.fixRecipeId ? ` → 🔧 recipe:${v.fixRecipeId}` : '';
-        console.log(`    [${v.severity}] ${v.ruleId} — ${v.occurrences} hits in ${v.fileCount} files${fix}`);
+        const _fix = v.fixRecipeId ? ` → 🔧 recipe:${v.fixRecipeId}` : '';
       }
     }
 
     if (fileHotspots.length > 0) {
-      console.log(`\n  File Hotspots:`);
-      for (const f of fileHotspots.slice(0, 10)) {
-        console.log(`    📄 ${f.filePath} — ${f.violationCount} violations (${f.errorCount} errors)`);
+      for (const _f of fileHotspots.slice(0, 10)) {
       }
     }
-
-    console.log(`${'═'.repeat(60)}\n`);
   }
 
   _printMarkdown(report) {
@@ -303,7 +315,9 @@ export class ComplianceReporter {
 
     if (trend.hasHistory) {
       lines.push(`| Errors Trend | ${trend.errorsChange > 0 ? '+' : ''}${trend.errorsChange} |`);
-      lines.push(`| Warnings Trend | ${trend.warningsChange > 0 ? '+' : ''}${trend.warningsChange} |`);
+      lines.push(
+        `| Warnings Trend | ${trend.warningsChange > 0 ? '+' : ''}${trend.warningsChange} |`
+      );
     }
 
     if (topViolations.length > 0) {
@@ -328,8 +342,6 @@ export class ComplianceReporter {
         lines.push(`| ${f.filePath} | ${f.violationCount} | ${f.errorCount} |`);
       }
     }
-
-    console.log(lines.join('\n'));
   }
 }