autosnippet 3.0.0 → 3.0.2

package/lib/core/enhancement/spring-enhancement.js

@@ -0,0 +1,112 @@
+/**
+ * Spring Enhancement Pack
+ * 条件: { languages: ['java', 'kotlin'], frameworks: ['spring'] }
+ */
+
+import { EnhancementPack } from './EnhancementPack.js';
+
+class SpringEnhancement extends EnhancementPack {
+  get id() {
+    return 'spring';
+  }
+  get displayName() {
+    return 'Spring Boot Enhancement';
+  }
+  get conditions() {
+    return { languages: ['java', 'kotlin'], frameworks: ['spring'] };
+  }
+
+  getExtraDimensions() {
+    return [
+      {
+        id: 'spring-di-scan',
+        label: 'Spring DI 分析',
+        guide:
+          'DI 容器依赖注入拓扑分析、@Component/@Service/@Repository 分层、@Configuration + @Bean 工厂',
+        knowledgeTypes: ['architecture', 'code-pattern'],
+        skillWorthy: true,
+        dualOutput: true,
+        skillMeta: {
+          name: 'project-spring-di',
+          description:
+            'Spring dependency injection topology and bean configuration (auto-generated by enhancement)',
+        },
+      },
+      {
+        id: 'spring-api-scan',
+        label: 'REST API 分析',
+        guide: '@RestController + @RequestMapping endpoint 清单、请求/响应 DTO、异常处理策略',
+        knowledgeTypes: ['architecture'],
+        skillWorthy: true,
+        dualOutput: true,
+        skillMeta: {
+          name: 'project-spring-api',
+          description:
+            'Spring REST API endpoints, DTOs and error handling (auto-generated by enhancement)',
+        },
+      },
+    ];
+  }
+
+  getGuardRules() {
+    return [
+      {
+        ruleId: 'spring-field-injection',
+        severity: 'warning',
+        languages: ['java', 'kotlin'],
+        pattern: /@Autowired\s+(?:private|protected)\s/,
+        message: '建议使用构造函数注入替代字段注入（@Autowired on field）',
+      },
+    ];
+  }
+
+  detectPatterns(astSummary) {
+    const patterns = [];
+    for (const cls of astSummary.classes || []) {
+      const annos = cls.annotations || [];
+      if (annos.some((a) => /@RestController/.test(a))) {
+        patterns.push({
+          type: 'spring-rest-controller',
+          className: cls.name,
+          line: cls.line,
+          confidence: 0.95,
+        });
+      }
+      if (annos.some((a) => /@Service/.test(a))) {
+        patterns.push({
+          type: 'spring-service',
+          className: cls.name,
+          line: cls.line,
+          confidence: 0.95,
+        });
+      }
+      if (annos.some((a) => /@Repository/.test(a))) {
+        patterns.push({
+          type: 'spring-repository',
+          className: cls.name,
+          line: cls.line,
+          confidence: 0.95,
+        });
+      }
+      if (annos.some((a) => /@Entity/.test(a))) {
+        patterns.push({
+          type: 'jpa-entity',
+          className: cls.name,
+          line: cls.line,
+          confidence: 0.95,
+        });
+      }
+      if (annos.some((a) => /@Configuration/.test(a))) {
+        patterns.push({
+          type: 'spring-configuration',
+          className: cls.name,
+          line: cls.line,
+          confidence: 0.95,
+        });
+      }
+    }
+    return patterns;
+  }
+}
+
+export const pack = new SpringEnhancement();

package/lib/core/enhancement/vue-enhancement.js

@@ -0,0 +1,96 @@
+/**
+ * Vue Enhancement Pack
+ * 条件: { languages: ['typescript', 'javascript'], frameworks: ['vue', 'nuxt'] }
+ */
+
+import { EnhancementPack } from './EnhancementPack.js';
+
+class VueEnhancement extends EnhancementPack {
+  get id() {
+    return 'vue';
+  }
+  get displayName() {
+    return 'Vue / Nuxt Enhancement';
+  }
+  get conditions() {
+    return { languages: ['typescript', 'javascript'], frameworks: ['vue', 'nuxt'] };
+  }
+
+  getExtraDimensions() {
+    return [
+      {
+        id: 'composable-scan',
+        label: 'Composable 函数分析',
+        guide: 'Composable 函数（useXxx）+ 内部 ref/computed/watch 调用、provide/inject 模式',
+        knowledgeTypes: ['code-pattern'],
+        skillWorthy: true,
+        dualOutput: true,
+        skillMeta: {
+          name: 'project-vue-composables',
+          description:
+            'Vue Composable patterns and composition API usage (auto-generated by enhancement)',
+        },
+      },
+    ];
+  }
+
+  getGuardRules() {
+    return [
+      {
+        ruleId: 'vue-no-v-html',
+        severity: 'warning',
+        languages: ['typescript', 'javascript'],
+        pattern: /v-html/,
+        message: '避免使用 v-html，存在 XSS 风险',
+      },
+      {
+        ruleId: 'vue-composable-naming',
+        severity: 'info',
+        languages: ['typescript', 'javascript'],
+        pattern: /export\s+function\s+(?!use)[a-z]/,
+        message: 'Composable 函数建议以 use 前缀命名',
+      },
+    ];
+  }
+
+  /**
+   * .vue SFC 预处理 → 提取 <script> / <script setup> 块
+   */
+  preprocessFile(content, ext) {
+    if (ext !== '.vue') {
+      return null;
+    }
+    // 优先提取 <script setup>
+    const setupMatch = content.match(
+      /<script\s+setup(?:\s+lang="(ts|typescript)")?\s*>([\s\S]*?)<\/script>/i
+    );
+    if (setupMatch) {
+      return { content: setupMatch[2], lang: setupMatch[1] ? 'typescript' : 'javascript' };
+    }
+    // 退 fallback 到普通 <script>
+    const scriptMatch = content.match(
+      /<script(?:\s+lang="(ts|typescript)")?\s*>([\s\S]*?)<\/script>/i
+    );
+    if (scriptMatch) {
+      return { content: scriptMatch[2], lang: scriptMatch[1] ? 'typescript' : 'javascript' };
+    }
+    return null;
+  }
+
+  detectPatterns(astSummary) {
+    const patterns = [];
+    for (const m of astSummary.methods || []) {
+      if (m.name && /^use[A-Z]/.test(m.name) && !m.className) {
+        patterns.push({
+          type: 'vue-composable',
+          methodName: m.name,
+          line: m.line,
+          confidence: 0.9,
+        });
+      }
+    }
+    return patterns;
+  }
+}
+
+export const pack = new VueEnhancement();

package/lib/core/gateway/Gateway.js

@@ -1,4 +1,4 @@
-import EventEmitter from 'events';
+import EventEmitter from 'node:events';
 import { v4 as uuidv4 } from 'uuid';
 import Logger from '../../infrastructure/logging/Logger.js';
 import { InternalError } from '../../shared/errors/BaseError.js';
@@ -28,12 +28,7 @@ export class Gateway extends EventEmitter {
   /**
    * 设置依赖
    */
-  setDependencies({
-    constitution,
-    constitutionValidator,
-    permissionManager,
-    auditLogger,
-  }) {
+  setDependencies({ constitution, constitutionValidator, permissionManager, auditLogger }) {
     this.constitution = constitution;
     this.constitutionValidator = constitutionValidator;
     this.permissionManager = permissionManager;
@@ -218,7 +213,9 @@ export class Gateway extends EventEmitter {
    * audit — 记录成功
    */
   async auditSuccess(context, result) {
-    if (!this.auditLogger) return;
+    if (!this.auditLogger) {
+      return;
+    }
 
     const entry = {
       requestId: context.requestId,
@@ -242,7 +239,9 @@ export class Gateway extends EventEmitter {
    * audit — 记录失败
    */
   async auditFailure(context, error) {
-    if (!this.auditLogger) return;
+    if (!this.auditLogger) {
+      return;
+    }
 
     const entry = {
       requestId: context.requestId,

package/lib/core/gateway/GatewayActionRegistry.js

@@ -1,6 +1,6 @@
 /**
  * GatewayActionRegistry - 将所有服务操作注册为 Gateway 路由
- * 
+ *
  * 这是连接 Gateway ↔ Service 的桥梁：
  * - 路由层格式化 Gateway 请求 {actor, action, resource, data}
  * - Gateway 执行权限/宪法/审计

package/lib/core/permission/PermissionManager.js

@@ -1,5 +1,5 @@
-import { PermissionDenied } from '../../shared/errors/BaseError.js';
 import Logger from '../../infrastructure/logging/Logger.js';
+import { PermissionDenied } from '../../shared/errors/BaseError.js';
 
 /**
  * PermissionManager - 权限管理器
@@ -43,10 +43,10 @@ export class PermissionManager {
     const normalizedAction = action.includes(':') ? action : this._normalizeAction(action);
 
     // 4. 检查精确匹配：action:resource
-    const requiredPermission = normalizedAction.includes(':') 
-      ? normalizedAction 
+    const requiredPermission = normalizedAction.includes(':')
+      ? normalizedAction
       : `${normalizedAction}:${resourceType}`;
-    
+
     if (permissions.includes(requiredPermission)) {
       return {
         allowed: true,
@@ -140,7 +140,7 @@ export class PermissionManager {
         // 尝试找到 action 部分（常见的 action 包括 read, create, delete, submit, approve, reject）
         const commonActions = ['read', 'create', 'delete', 'submit', 'approve', 'reject', 'write'];
         const actionIndex = parts.findIndex((p, i) => i > 1 && commonActions.includes(p));
-        
+
         if (actionIndex !== -1) {
           // 提取从 action 开始的部分，用冒号连接
           const actionParts = parts.slice(actionIndex);
@@ -151,7 +151,7 @@ export class PermissionManager {
 
     // 仅将第一个下划线替换为冒号
     // read_recipes -> read:recipes
-    // create_candidate -> create:candidate  
+    // create_candidate -> create:candidate
     return action.replace('_', ':');
   }
 
@@ -180,9 +180,13 @@ export class PermissionManager {
     if (typeof resource === 'string') {
       // 处理路径： /recipes/123 → recipes
       const match = resource.match(/^\/([^/]+)/);
-      if (match) return match[1];
+      if (match) {
+        return match[1];
+      }
       // 处理纯字符串资源名：candidates, guard_rules 等
-      if (resource && !resource.includes('/')) return resource;
+      if (resource && !resource.includes('/')) {
+        return resource;
+      }
       return 'unknown';
     }
 

package/lib/domain/index.js

@@ -5,21 +5,25 @@
 
 // Knowledge 统一知识实体 (V3)
 export {
-  KnowledgeEntry,
-  Lifecycle,
-  isValidTransition,
-  isValidLifecycle,
-  isCandidate as isLifecycleCandidate,
   CANDIDATE_STATES,
   inferKind as inferKindV3,
+  isCandidate as isLifecycleCandidate,
+  isValidLifecycle,
+  isValidTransition,
+  KnowledgeEntry,
+  Lifecycle,
 } from './knowledge/index.js';
-export { Content } from './knowledge/values/Content.js';
-export { Relations, RELATION_BUCKETS, RELATION_BUCKETS as RelationType } from './knowledge/values/Relations.js';
+export { KnowledgeRepository } from './knowledge/KnowledgeRepository.js';
 export { Constraints } from './knowledge/values/Constraints.js';
-export { Reasoning as ReasoningV3 } from './knowledge/values/Reasoning.js';
+export { Content } from './knowledge/values/Content.js';
 export { Quality } from './knowledge/values/Quality.js';
+export { Reasoning as ReasoningV3 } from './knowledge/values/Reasoning.js';
+export {
+  RELATION_BUCKETS,
+  RELATION_BUCKETS as RelationType,
+  Relations,
+} from './knowledge/values/Relations.js';
 export { Stats } from './knowledge/values/Stats.js';
-export { KnowledgeRepository } from './knowledge/KnowledgeRepository.js';
 
 // Snippet 相关
 export { Snippet } from './snippet/Snippet.js';

package/lib/domain/knowledge/KnowledgeEntry.js

@@ -1,6 +1,12 @@
 import { v4 as uuidv4 } from 'uuid';
-import { Lifecycle, isValidTransition, isCandidate as isLifecycleCandidate, inferKind, normalizeLifecycle } from './Lifecycle.js';
-import { Content, Relations, Constraints, Reasoning, Quality, Stats } from './values/index.js';
+import {
+  inferKind,
+  isCandidate as isLifecycleCandidate,
+  isValidTransition,
+  Lifecycle,
+  normalizeLifecycle,
+} from './Lifecycle.js';
+import { Constraints, Content, Quality, Reasoning, Relations, Stats } from './values/index.js';
 
 /* ═══════════════════════════════════════════════════════════
  * KnowledgeEntry — 统一知识实体
@@ -17,65 +23,65 @@ export class KnowledgeEntry {
    */
   constructor(props = {}) {
     // ── 标识 ──
-    this.id          = props.id          || uuidv4();
-    this.title       = props.title       || '';
+    this.id = props.id || uuidv4();
+    this.title = props.title || '';
     this.description = props.description || '';
 
     // ── 生命周期 ──
-    this.lifecycle        = normalizeLifecycle(props.lifecycle || Lifecycle.PENDING);
-    this.lifecycleHistory = props.lifecycleHistory  || [];
-    this.autoApprovable   = props.autoApprovable    ?? false;
+    this.lifecycle = normalizeLifecycle(props.lifecycle || Lifecycle.PENDING);
+    this.lifecycleHistory = props.lifecycleHistory || [];
+    this.autoApprovable = props.autoApprovable ?? false;
 
     // ── 语言与分类 ──
-    this.language      = props.language      || '';
-    this.category      = props.category      || '';
-    this.knowledgeType = props.knowledgeType  || 'code-pattern';
-    this.kind          = props.kind          || inferKind(this.knowledgeType);
-    this.complexity    = props.complexity    || 'intermediate';
-    this.scope         = props.scope         || 'universal';
-    this.difficulty    = props.difficulty    || null;
-    this.tags          = props.tags          || [];
+    this.language = props.language || '';
+    this.category = props.category || '';
+    this.knowledgeType = props.knowledgeType || 'code-pattern';
+    this.kind = props.kind || inferKind(this.knowledgeType);
+    this.complexity = props.complexity || 'intermediate';
+    this.scope = props.scope || 'universal';
+    this.difficulty = props.difficulty || null;
+    this.tags = props.tags || [];
 
     // ── Cursor 交付字段（AI 直接产出）──
-    this.trigger     = props.trigger     || '';
-    this.topicHint   = props.topicHint   || '';
-    this.whenClause  = props.whenClause  || '';
-    this.doClause    = props.doClause    || '';
-    this.dontClause  = props.dontClause  || '';
-    this.coreCode    = props.coreCode    || '';
+    this.trigger = props.trigger || '';
+    this.topicHint = props.topicHint || '';
+    this.whenClause = props.whenClause || '';
+    this.doClause = props.doClause || '';
+    this.dontClause = props.dontClause || '';
+    this.coreCode = props.coreCode || '';
 
     // ── 值对象 ──
-    this.content     = Content.from(props.content);
-    this.relations   = Relations.from(props.relations);
+    this.content = Content.from(props.content);
+    this.relations = Relations.from(props.relations);
     this.constraints = Constraints.from(props.constraints);
-    this.reasoning   = Reasoning.from(props.reasoning);
-    this.quality     = Quality.from(props.quality);
-    this.stats       = Stats.from(props.stats);
+    this.reasoning = Reasoning.from(props.reasoning);
+    this.quality = Quality.from(props.quality);
+    this.stats = Stats.from(props.stats);
 
     // ── 代码头文件 (ObjC/Swift) ──
-    this.headers        = props.headers        || [];
-    this.headerPaths    = props.headerPaths    || [];
-    this.moduleName     = props.moduleName     || '';
+    this.headers = props.headers || [];
+    this.headerPaths = props.headerPaths || [];
+    this.moduleName = props.moduleName || '';
     this.includeHeaders = props.includeHeaders ?? false;
 
     // ── AI 润色 ──
     this.agentNotes = props.agentNotes || null;
-    this.aiInsight  = props.aiInsight  || null;
+    this.aiInsight = props.aiInsight || null;
 
     // ── 审核 ──
-    this.reviewedBy      = props.reviewedBy      || null;
-    this.reviewedAt      = props.reviewedAt      || null;
-    this.rejectionReason = props.rejectionReason  || null;
+    this.reviewedBy = props.reviewedBy || null;
+    this.reviewedAt = props.reviewedAt || null;
+    this.rejectionReason = props.rejectionReason || null;
 
     // ── 来源 ──
-    this.source            = props.source            || 'manual';
-    this.sourceFile        = props.sourceFile        || null;
+    this.source = props.source || 'manual';
+    this.sourceFile = props.sourceFile || null;
     this.sourceCandidateId = props.sourceCandidateId || null;
 
     // ── 时间 ──
-    this.createdBy   = props.createdBy   || 'system';
-    this.createdAt   = props.createdAt   || Math.floor(Date.now() / 1000);
-    this.updatedAt   = props.updatedAt   || Math.floor(Date.now() / 1000);
+    this.createdBy = props.createdBy || 'system';
+    this.createdAt = props.createdAt || Math.floor(Date.now() / 1000);
+    this.updatedAt = props.updatedAt || Math.floor(Date.now() / 1000);
     this.publishedAt = props.publishedAt || null;
     this.publishedBy = props.publishedBy || null;
   }
@@ -165,29 +171,31 @@ export class KnowledgeEntry {
    * @returns {Array<Object>}
    */
   getGuardRules() {
-    if (!this.isActive() || !this.isRule()) return [];
-
-    const regexRules = this.constraints.getRegexGuards().map(g => ({
-      id:            g.id || this.id,
-      type:          'regex',
-      name:          g.message || this.title,
-      message:       g.message || this.description || this.title,
-      pattern:       g.pattern,
-      languages:     this.language ? [this.language] : [],
-      severity:      g.severity || 'warning',
-      source:        'knowledge_entry',
+    if (!this.isActive() || !this.isRule()) {
+      return [];
+    }
+
+    const regexRules = this.constraints.getRegexGuards().map((g) => ({
+      id: g.id || this.id,
+      type: 'regex',
+      name: g.message || this.title,
+      message: g.message || this.description || this.title,
+      pattern: g.pattern,
+      languages: this.language ? [this.language] : [],
+      severity: g.severity || 'warning',
+      source: 'knowledge_entry',
       fixSuggestion: g.fix_suggestion || null,
     }));
 
-    const astRules = this.constraints.getAstGuards().map(g => ({
-      id:            g.id || `${this.id}:ast`,
-      type:          'ast',
-      name:          g.message || this.title,
-      message:       g.message,
-      astQuery:      g.ast_query,
-      languages:     g.ast_query?.language ? [g.ast_query.language] : [],
-      severity:      g.severity || 'warning',
-      source:        'knowledge_entry',
+    const astRules = this.constraints.getAstGuards().map((g) => ({
+      id: g.id || `${this.id}:ast`,
+      type: 'ast',
+      name: g.message || this.title,
+      message: g.message,
+      astQuery: g.ast_query,
+      languages: g.ast_query?.language ? [g.ast_query.language] : [],
+      severity: g.severity || 'warning',
+      source: 'knowledge_entry',
       fixSuggestion: g.fix_suggestion || null,
     }));
 
@@ -201,49 +209,49 @@ export class KnowledgeEntry {
    */
   toJSON() {
     return {
-      id:                this.id,
-      title:             this.title,
-      description:       this.description,
-      lifecycle:         this.lifecycle,
-      lifecycleHistory:  this.lifecycleHistory,
-      autoApprovable:    this.autoApprovable,
-      language:          this.language,
-      category:          this.category,
-      kind:              this.kind,
-      knowledgeType:     this.knowledgeType,
-      complexity:        this.complexity,
-      scope:             this.scope,
-      difficulty:        this.difficulty,
-      tags:              this.tags,
-      trigger:           this.trigger,
-      topicHint:         this.topicHint,
-      whenClause:        this.whenClause,
-      doClause:          this.doClause,
-      dontClause:        this.dontClause,
-      coreCode:          this.coreCode,
-      content:           this.content.toJSON(),
-      relations:         this.relations.toJSON(),
-      constraints:       this.constraints.toJSON(),
-      reasoning:         this.reasoning.toJSON(),
-      quality:           this.quality.toJSON(),
-      stats:             this.stats.toJSON(),
-      headers:           this.headers,
-      headerPaths:       this.headerPaths,
-      moduleName:        this.moduleName,
-      includeHeaders:    this.includeHeaders,
-      agentNotes:        this.agentNotes,
-      aiInsight:         this.aiInsight,
-      reviewedBy:        this.reviewedBy,
-      reviewedAt:        this.reviewedAt,
-      rejectionReason:   this.rejectionReason,
-      source:            this.source,
-      sourceFile:        this.sourceFile,
+      id: this.id,
+      title: this.title,
+      description: this.description,
+      lifecycle: this.lifecycle,
+      lifecycleHistory: this.lifecycleHistory,
+      autoApprovable: this.autoApprovable,
+      language: this.language,
+      category: this.category,
+      kind: this.kind,
+      knowledgeType: this.knowledgeType,
+      complexity: this.complexity,
+      scope: this.scope,
+      difficulty: this.difficulty,
+      tags: this.tags,
+      trigger: this.trigger,
+      topicHint: this.topicHint,
+      whenClause: this.whenClause,
+      doClause: this.doClause,
+      dontClause: this.dontClause,
+      coreCode: this.coreCode,
+      content: this.content.toJSON(),
+      relations: this.relations.toJSON(),
+      constraints: this.constraints.toJSON(),
+      reasoning: this.reasoning.toJSON(),
+      quality: this.quality.toJSON(),
+      stats: this.stats.toJSON(),
+      headers: this.headers,
+      headerPaths: this.headerPaths,
+      moduleName: this.moduleName,
+      includeHeaders: this.includeHeaders,
+      agentNotes: this.agentNotes,
+      aiInsight: this.aiInsight,
+      reviewedBy: this.reviewedBy,
+      reviewedAt: this.reviewedAt,
+      rejectionReason: this.rejectionReason,
+      source: this.source,
+      sourceFile: this.sourceFile,
       sourceCandidateId: this.sourceCandidateId,
-      createdBy:         this.createdBy,
-      createdAt:         this.createdAt,
-      updatedAt:         this.updatedAt,
-      publishedAt:       this.publishedAt,
-      publishedBy:       this.publishedBy,
+      createdBy: this.createdBy,
+      createdAt: this.createdAt,
+      updatedAt: this.updatedAt,
+      publishedAt: this.publishedAt,
+      publishedBy: this.publishedBy,
     };
   }
 
@@ -253,7 +261,9 @@ export class KnowledgeEntry {
    * @returns {KnowledgeEntry}
    */
   static fromJSON(data) {
-    if (!data) return new KnowledgeEntry();
+    if (!data) {
+      return new KnowledgeEntry();
+    }
     return new KnowledgeEntry(data);
   }
 

package/lib/domain/knowledge/KnowledgeRepository.js

@@ -5,7 +5,6 @@
  * 实现类见 lib/repository/knowledge/KnowledgeRepository.impl.js
  */
 export class KnowledgeRepository {
-
   /**
    * 创建 KnowledgeEntry
    * @param {import('./KnowledgeEntry.js').KnowledgeEntry} entry