autosnippet 3.0.2 → 3.0.6

package/lib/core/enhancement/rust-tokio-enhancement.js

@@ -0,0 +1,231 @@
+/**
+ * Rust Tokio Async Enhancement Pack
+ * 条件: { languages: ['rust'], frameworks: ['tokio', 'async-std'] }
+ *
+ * 覆盖 Rust 异步运行时生态:
+ *   - Tokio runtime (最主流)
+ *   - async-std
+ *   - 异步任务 spawn / JoinHandle
+ *   - Channel (mpsc/oneshot/broadcast/watch)
+ *   - 同步原语 (Mutex/RwLock/Semaphore)
+ *   - 超时与取消 (select!, timeout)
+ */
+
+import { EnhancementPack } from './EnhancementPack.js';
+
+class RustTokioEnhancement extends EnhancementPack {
+  get id() {
+    return 'rust-tokio';
+  }
+  get displayName() {
+    return 'Rust Tokio/Async Enhancement';
+  }
+  get conditions() {
+    return {
+      languages: ['rust'],
+      frameworks: ['tokio', 'async-std'],
+    };
+  }
+
+  getExtraDimensions() {
+    return [
+      {
+        id: 'rust-async-task-scan',
+        label: 'Async Task 分析',
+        guide:
+          'Rust 异步任务拓扑分析 — tokio::spawn / task::spawn_blocking 使用分布、JoinHandle 收集与 abort 策略、tokio::select! 分支、graceful shutdown 模式',
+        knowledgeTypes: ['architecture', 'code-pattern'],
+        skillWorthy: true,
+        dualOutput: true,
+        skillMeta: {
+          name: 'project-rust-async-tasks',
+          description:
+            'Rust async task spawn/join topology, select branches and shutdown patterns (auto-generated by enhancement)',
+        },
+      },
+      {
+        id: 'rust-channel-sync-scan',
+        label: 'Channel/同步原语分析',
+        guide:
+          'Rust Channel 与同步原语分析 — mpsc/oneshot/broadcast/watch channel 使用、Arc<Mutex>/Arc<RwLock> 共享状态、Semaphore 限流、Notify 事件',
+        knowledgeTypes: ['architecture', 'code-pattern'],
+        skillWorthy: true,
+        dualOutput: true,
+        skillMeta: {
+          name: 'project-rust-concurrency',
+          description:
+            'Rust channel patterns, shared state synchronization and concurrency primitives (auto-generated by enhancement)',
+        },
+      },
+    ];
+  }
+
+  getGuardRules() {
+    return [
+      {
+        ruleId: 'rust-tokio-std-mutex',
+        category: 'correctness',
+        dimension: 'file',
+        severity: 'warning',
+        languages: ['rust'],
+        pattern: /std::sync::Mutex|std::sync::RwLock/,
+        message:
+          '在 async 代码中使用 std::sync::Mutex 会阻塞运行时线程，应使用 tokio::sync::Mutex 或 parking_lot::Mutex（如果临界区极短）',
+      },
+      {
+        ruleId: 'rust-tokio-blocking-in-async',
+        category: 'performance',
+        dimension: 'file',
+        severity: 'warning',
+        languages: ['rust'],
+        pattern: /std::thread::sleep|std::fs::|std::net::TcpStream/,
+        message:
+          'async 上下文中不应使用阻塞操作，使用 tokio::time::sleep / tokio::fs / tokio::net 或 spawn_blocking()',
+      },
+      {
+        ruleId: 'rust-tokio-unbounded-channel',
+        category: 'performance',
+        dimension: 'file',
+        severity: 'info',
+        languages: ['rust'],
+        pattern: /unbounded_channel|mpsc::unbounded/,
+        message:
+          'unbounded channel 在高吞吐场景下可能导致内存无限增长，考虑使用 bounded channel 并处理背压',
+      },
+      {
+        ruleId: 'rust-tokio-spawn-no-handle',
+        category: 'correctness',
+        dimension: 'file',
+        severity: 'info',
+        languages: ['rust'],
+        pattern: /tokio::spawn\([^)]+\)\s*;/,
+        message:
+          'tokio::spawn 返回的 JoinHandle 被丢弃 — 任务 panic 不会传播，考虑使用 JoinSet 或 .await handle',
+      },
+    ];
+  }
+
+  detectPatterns(astSummary) {
+    const patterns = [];
+
+    // ── Async functions (potential task entry points) ──
+    let asyncFnCount = 0;
+    for (const m of astSummary.methods || []) {
+      if (m.isAsync) {
+        asyncFnCount++;
+      }
+    }
+    if (asyncFnCount > 0) {
+      patterns.push({
+        type: 'rust-async-functions',
+        count: asyncFnCount,
+        confidence: 0.85,
+      });
+    }
+
+    // ── Runtime main entry (#[tokio::main]) ──
+    for (const m of astSummary.methods || []) {
+      if (m.name === 'main' && m.isAsync) {
+        patterns.push({
+          type: 'rust-tokio-main',
+          line: m.line,
+          confidence: 0.95,
+        });
+      }
+    }
+
+    // ── Structs wrapping async primitives ──
+    for (const cls of astSummary.classes || []) {
+      if (cls.kind !== 'struct') continue;
+      const nameLower = cls.name.toLowerCase();
+      if (
+        nameLower.includes('worker') ||
+        nameLower.includes('executor') ||
+        nameLower.includes('scheduler') ||
+        nameLower.includes('dispatcher') ||
+        nameLower.includes('runtime') ||
+        nameLower.includes('pool')
+      ) {
+        patterns.push({
+          type: 'rust-async-worker',
+          className: cls.name,
+          line: cls.line,
+          confidence: 0.7,
+        });
+      }
+    }
+
+    // ── Channel / sync wrappers ──
+    for (const cls of astSummary.classes || []) {
+      if (cls.kind !== 'struct') continue;
+      const nameLower = cls.name.toLowerCase();
+      if (
+        nameLower.includes('sender') ||
+        nameLower.includes('receiver') ||
+        nameLower.includes('channel') ||
+        nameLower.includes('notifier') ||
+        nameLower.includes('broker') ||
+        nameLower.includes('bus')
+      ) {
+        patterns.push({
+          type: 'rust-channel-struct',
+          className: cls.name,
+          line: cls.line,
+          confidence: 0.7,
+        });
+      }
+    }
+
+    // ── Trait impls for async patterns ──
+    for (const cls of astSummary.classes || []) {
+      // Look for trait: Future / Stream / Service / Tower Layer
+      if (cls.kind === 'trait_impl') {
+        const traitName = cls.traitName || '';
+        if (
+          traitName === 'Future' ||
+          traitName === 'Stream' ||
+          traitName === 'Service' ||
+          traitName === 'Layer'
+        ) {
+          patterns.push({
+            type: 'rust-async-trait-impl',
+            className: cls.name,
+            traitName,
+            line: cls.line,
+            confidence: 0.85,
+          });
+        }
+      }
+    }
+
+    // ── Tokio/async imports ──
+    const asyncImports = (astSummary.imports || []).filter(
+      (imp) =>
+        imp.includes('tokio') ||
+        imp.includes('async_std') ||
+        imp.includes('futures') ||
+        imp.includes('tower')
+    );
+    if (asyncImports.length > 0) {
+      patterns.push({
+        type: 'rust-async-ecosystem-usage',
+        importCount: asyncImports.length,
+        confidence: 0.9,
+      });
+    }
+
+    // ── Detect common async patterns from lang-rust detectPatterns ──
+    for (const p of astSummary.patterns || []) {
+      if (p.type === 'async-heavy' || p.type === 'unsafe-usage') {
+        patterns.push({
+          type: `rust-tokio-${p.type}`,
+          confidence: p.confidence || 0.7,
+        });
+      }
+    }
+
+    return patterns;
+  }
+}
+
+export const pack = new RustTokioEnhancement();

package/lib/core/enhancement/rust-web-enhancement.js

@@ -0,0 +1,256 @@
+/**
+ * Rust Web Enhancement Pack
+ * 条件: { languages: ['rust'], frameworks: ['actix-web', 'axum', 'rocket', 'warp'] }
+ *
+ * 覆盖主流 Rust HTTP 框架:
+ *   - Axum (tower-based, 最流行)
+ *   - Actix-web (actor 模型)
+ *   - Rocket (宏驱动)
+ *   - Warp (filter 组合)
+ */
+
+import { EnhancementPack } from './EnhancementPack.js';
+
+class RustWebEnhancement extends EnhancementPack {
+  get id() {
+    return 'rust-web';
+  }
+  get displayName() {
+    return 'Rust Web (Axum/Actix-web/Rocket/Warp) Enhancement';
+  }
+  get conditions() {
+    return {
+      languages: ['rust'],
+      frameworks: ['actix-web', 'axum', 'rocket', 'warp'],
+    };
+  }
+
+  getExtraDimensions() {
+    return [
+      {
+        id: 'rust-handler-scan',
+        label: 'HTTP Handler 分析',
+        guide:
+          'Rust Web Handler 与 Middleware/Layer 分析 — handler 函数签名 (Extractor 模式)、State/AppData 共享、Tower Layer/Service 注册顺序、错误响应统一化 (IntoResponse)',
+        knowledgeTypes: ['architecture', 'code-pattern'],
+        skillWorthy: true,
+        dualOutput: true,
+        skillMeta: {
+          name: 'project-rust-handlers',
+          description:
+            'Rust web handler patterns, extractors, state management and middleware layers (auto-generated by enhancement)',
+        },
+      },
+      {
+        id: 'rust-route-scan',
+        label: 'API Route 结构',
+        guide:
+          'Rust 路由结构分析 — Router::new().route() / web::resource() 路由表、路由嵌套与合并 (nest/merge)、HTTP 方法分布、Path/Query/Json Extractor 使用',
+        knowledgeTypes: ['architecture'],
+        skillWorthy: true,
+        dualOutput: true,
+        skillMeta: {
+          name: 'project-rust-routes',
+          description:
+            'Rust API route structure, nesting/merging and extractor usage (auto-generated by enhancement)',
+        },
+      },
+    ];
+  }
+
+  getGuardRules() {
+    return [
+      {
+        ruleId: 'rust-web-unwrap-in-handler',
+        category: 'correctness',
+        dimension: 'file',
+        severity: 'warning',
+        languages: ['rust'],
+        pattern: /\.unwrap\(\)/,
+        message:
+          'Web handler 中避免 .unwrap()，应使用 ? 运算符配合自定义错误类型实现 IntoResponse，防止 500 panic',
+      },
+      {
+        ruleId: 'rust-web-blocking-in-async',
+        category: 'performance',
+        dimension: 'file',
+        severity: 'warning',
+        languages: ['rust'],
+        pattern: /std::fs::|std::net::|std::thread::sleep/,
+        message:
+          'async handler 中不应使用 std 阻塞 I/O，应使用 tokio::fs / tokio::net / tokio::time::sleep 替代',
+      },
+      {
+        ruleId: 'rust-web-clone-state',
+        category: 'performance',
+        dimension: 'file',
+        severity: 'info',
+        languages: ['rust'],
+        pattern: /\.clone\(\)\s*[;,]\s*(?:\/\/.*)?$/m,
+        message:
+          '频繁 .clone() 共享状态可能有性能问题，考虑使用 Arc<T> 或 Axum State extractor / Actix Data<T>',
+      },
+    ];
+  }
+
+  detectPatterns(astSummary) {
+    const patterns = [];
+
+    // ── Handler functions (async fn with web extractor params) ──
+    for (const m of astSummary.methods || []) {
+      if (!m.className && m.isAsync) {
+        const nameLower = m.name.toLowerCase();
+        if (
+          nameLower.startsWith('get_') ||
+          nameLower.startsWith('post_') ||
+          nameLower.startsWith('put_') ||
+          nameLower.startsWith('delete_') ||
+          nameLower.startsWith('patch_') ||
+          nameLower.startsWith('handle_') ||
+          nameLower.startsWith('list_') ||
+          nameLower.startsWith('create_') ||
+          nameLower.startsWith('update_') ||
+          nameLower.startsWith('remove_') ||
+          nameLower === 'index' ||
+          nameLower === 'health' ||
+          nameLower === 'health_check'
+        ) {
+          patterns.push({
+            type: 'rust-web-handler',
+            methodName: m.name,
+            line: m.line,
+            confidence: 0.75,
+          });
+        }
+      }
+    }
+
+    // ── Structs used as State / AppData ──
+    for (const cls of astSummary.classes || []) {
+      if (cls.kind !== 'struct') continue;
+      const nameLower = cls.name.toLowerCase();
+      if (
+        nameLower.includes('state') ||
+        nameLower.includes('appdata') ||
+        nameLower.includes('appstate') ||
+        nameLower.includes('context') ||
+        nameLower.includes('config')
+      ) {
+        patterns.push({
+          type: 'rust-web-state',
+          className: cls.name,
+          line: cls.line,
+          confidence: 0.7,
+        });
+      }
+    }
+
+    // ── Error response types (impl IntoResponse / ResponseError) ──
+    for (const cls of astSummary.classes || []) {
+      const nameLower = cls.name.toLowerCase();
+      if (
+        nameLower.includes('error') ||
+        nameLower.includes('apierror') ||
+        nameLower.includes('appresponse')
+      ) {
+        patterns.push({
+          type: 'rust-web-error-type',
+          className: cls.name,
+          line: cls.line,
+          confidence: 0.7,
+        });
+      }
+    }
+
+    // ── Middleware / Layer structs ──
+    for (const cls of astSummary.classes || []) {
+      if (cls.kind !== 'struct') continue;
+      const nameLower = cls.name.toLowerCase();
+      if (
+        nameLower.includes('middleware') ||
+        nameLower.includes('layer') ||
+        nameLower.includes('auth') ||
+        nameLower.includes('cors') ||
+        nameLower.includes('ratelimit') ||
+        nameLower.includes('logging')
+      ) {
+        patterns.push({
+          type: 'rust-web-middleware',
+          className: cls.name,
+          line: cls.line,
+          confidence: 0.7,
+        });
+      }
+    }
+
+    // ── Extractor structs (used as handler params) ──
+    for (const cls of astSummary.classes || []) {
+      if (cls.kind !== 'struct') continue;
+      // Derive-heavy DTOs used as Json<T>, Query<T>, Path<T>
+      if (cls.derives && cls.derives.length >= 2) {
+        const hasSerdeDerive = cls.derives.some(
+          (d) => d === 'Deserialize' || d === 'Serialize'
+        );
+        if (hasSerdeDerive) {
+          const nameLower = cls.name.toLowerCase();
+          if (
+            nameLower.includes('request') ||
+            nameLower.includes('payload') ||
+            nameLower.includes('params') ||
+            nameLower.includes('query') ||
+            nameLower.includes('body') ||
+            nameLower.includes('form') ||
+            nameLower.includes('dto')
+          ) {
+            patterns.push({
+              type: 'rust-web-extractor-dto',
+              className: cls.name,
+              line: cls.line,
+              confidence: 0.85,
+            });
+          }
+        }
+      }
+    }
+
+    // ── Response structs ──
+    for (const cls of astSummary.classes || []) {
+      if (cls.kind !== 'struct') continue;
+      const nameLower = cls.name.toLowerCase();
+      if (
+        nameLower.includes('response') ||
+        nameLower.endsWith('resp') ||
+        nameLower.endsWith('reply')
+      ) {
+        patterns.push({
+          type: 'rust-web-response-dto',
+          className: cls.name,
+          line: cls.line,
+          confidence: 0.75,
+        });
+      }
+    }
+
+    // ── Web framework imports ──
+    const webImports = (astSummary.imports || []).filter(
+      (imp) =>
+        imp.includes('actix_web') ||
+        imp.includes('axum') ||
+        imp.includes('rocket') ||
+        imp.includes('warp') ||
+        imp.includes('tower') ||
+        imp.includes('tower_http')
+    );
+    if (webImports.length > 0) {
+      patterns.push({
+        type: 'rust-web-framework-usage',
+        importCount: webImports.length,
+        confidence: 0.9,
+      });
+    }
+
+    return patterns;
+  }
+}
+
+export const pack = new RustWebEnhancement();

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

@@ -52,6 +52,8 @@ class SpringEnhancement extends EnhancementPack {
     return [
       {
         ruleId: 'spring-field-injection',
+        category: 'style',
+        dimension: 'file',
         severity: 'warning',
         languages: ['java', 'kotlin'],
         pattern: /@Autowired\s+(?:private|protected)\s/,

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

@@ -1,6 +1,14 @@
 /**
  * Vue Enhancement Pack
  * 条件: { languages: ['typescript', 'javascript'], frameworks: ['vue', 'nuxt'] }
+ *
+ * 覆盖 Vue 3.5+ Composition API 生态:
+ *   - Composable 函数 (useXxx)
+ *   - Pinia Store 模式
+ *   - SFC <script setup> 预处理
+ *   - defineProps / defineEmits / defineModel 宏
+ *   - VueRouter 导航守卫
+ *   - provide/inject 依赖注入
  */
 
 import { EnhancementPack } from './EnhancementPack.js';
@@ -10,7 +18,7 @@ class VueEnhancement extends EnhancementPack {
     return 'vue';
   }
   get displayName() {
-    return 'Vue / Nuxt Enhancement';
+    return 'Vue 3.5 / Nuxt Enhancement';
   }
   get conditions() {
     return { languages: ['typescript', 'javascript'], frameworks: ['vue', 'nuxt'] };
@@ -21,7 +29,7 @@ class VueEnhancement extends EnhancementPack {
       {
         id: 'composable-scan',
         label: 'Composable 函数分析',
-        guide: 'Composable 函数（useXxx）+ 内部 ref/computed/watch 调用、provide/inject 模式',
+        guide: 'Composable 函数（useXxx）+ 内部 ref/computed/watch 调用、Composable 组合链、provide/inject 依赖注入模式',
         knowledgeTypes: ['code-pattern'],
         skillWorthy: true,
         dualOutput: true,
@@ -31,6 +39,34 @@ class VueEnhancement extends EnhancementPack {
             'Vue Composable patterns and composition API usage (auto-generated by enhancement)',
         },
       },
+      {
+        id: 'pinia-store-scan',
+        label: 'Pinia Store 分析',
+        guide:
+          'Pinia Store 拓扑分析 — defineStore 定义、state/getters/actions 结构、Store 间依赖、$subscribe/$onAction 订阅模式、setup vs option 语法',
+        knowledgeTypes: ['architecture', 'code-pattern'],
+        skillWorthy: true,
+        dualOutput: true,
+        skillMeta: {
+          name: 'project-vue-stores',
+          description:
+            'Pinia store definitions, dependencies and subscription patterns (auto-generated by enhancement)',
+        },
+      },
+      {
+        id: 'vue-component-api-scan',
+        label: '组件 API 分析',
+        guide:
+          'Vue 组件 API 分析 — defineProps/defineEmits/defineModel/defineExpose 使用分布、prop 类型定义规范 (runtime vs type-only)、slot 模式、v-model 双向绑定',
+        knowledgeTypes: ['code-pattern', 'code-standard'],
+        skillWorthy: true,
+        dualOutput: true,
+        skillMeta: {
+          name: 'project-vue-component-api',
+          description:
+            'Vue component API conventions — defineProps/defineEmits/defineModel patterns (auto-generated by enhancement)',
+        },
+      },
     ];
   }
 
@@ -38,6 +74,8 @@ class VueEnhancement extends EnhancementPack {
     return [
       {
         ruleId: 'vue-no-v-html',
+        category: 'safety',
+        dimension: 'file',
         severity: 'warning',
         languages: ['typescript', 'javascript'],
         pattern: /v-html/,
@@ -45,11 +83,49 @@ class VueEnhancement extends EnhancementPack {
       },
       {
         ruleId: 'vue-composable-naming',
+        category: 'style',
+        dimension: 'file',
         severity: 'info',
         languages: ['typescript', 'javascript'],
         pattern: /export\s+function\s+(?!use)[a-z]/,
         message: 'Composable 函数建议以 use 前缀命名',
       },
+      {
+        ruleId: 'vue-reactive-destructure',
+        category: 'correctness',
+        dimension: 'file',
+        severity: 'warning',
+        languages: ['typescript', 'javascript'],
+        pattern: /(?:const|let)\s*\{[^}]+\}\s*=\s*(?:reactive|toRefs)\s*\(/,
+        message: '解构 reactive() 对象会失去响应性，使用 toRefs() 或保持引用访问。Vue 3.5 的 Reactive Props Destructure 除外',
+      },
+      {
+        ruleId: 'vue-computed-side-effect',
+        category: 'correctness',
+        dimension: 'file',
+        severity: 'warning',
+        languages: ['typescript', 'javascript'],
+        pattern: /computed\s*\(\s*(?:\(\)|function\s*\(\))\s*(?:=>)?\s*\{[^}]*(?:fetch|axios|console\.log|\.value\s*=)/,
+        message: 'computed 中不应有副作用 (网络请求、修改 ref、console.log) — 使用 watch/watchEffect 代替',
+      },
+      {
+        ruleId: 'vue-v-for-with-v-if',
+        category: 'performance',
+        dimension: 'file',
+        severity: 'warning',
+        languages: ['typescript', 'javascript'],
+        pattern: /v-for=[\s\S]*?v-if=/,
+        message: '避免在同一元素上同时使用 v-for 和 v-if — v-if 优先级高于 v-for（Vue 3），用 computed 过滤或包裹 <template>',
+      },
+      {
+        ruleId: 'vue-no-ref-in-reactive',
+        category: 'correctness',
+        dimension: 'file',
+        severity: 'info',
+        languages: ['typescript', 'javascript'],
+        pattern: /reactive\s*\(\s*\{[^}]*ref\s*\(/,
+        message: '避免在 reactive() 内嵌套 ref() — reactive 会自动解包 ref，但手动嵌套会造成混淆',
+      },
     ];
   }
 
@@ -79,6 +155,8 @@ class VueEnhancement extends EnhancementPack {
 
   detectPatterns(astSummary) {
     const patterns = [];
+
+    // ── Composable functions ──
     for (const m of astSummary.methods || []) {
       if (m.name && /^use[A-Z]/.test(m.name) && !m.className) {
         patterns.push({
@@ -89,6 +167,69 @@ class VueEnhancement extends EnhancementPack {
         });
       }
     }
+
+    // ── Pinia stores (defineStore) ──
+    for (const m of astSummary.methods || []) {
+      if (m.name && /^use\w+Store$/.test(m.name) && !m.className) {
+        patterns.push({
+          type: 'vue-pinia-store',
+          methodName: m.name,
+          line: m.line,
+          confidence: 0.9,
+        });
+      }
+    }
+
+    // ── Vue Router guard patterns ──
+    for (const m of astSummary.methods || []) {
+      if (!m.className && m.name) {
+        const nameLower = m.name.toLowerCase();
+        if (
+          nameLower.includes('beforeeach') ||
+          nameLower.includes('beforeenter') ||
+          nameLower.includes('beforerouteleave') ||
+          nameLower === 'beforeRouteEnter' ||
+          nameLower === 'beforeRouteUpdate'
+        ) {
+          patterns.push({
+            type: 'vue-router-guard',
+            methodName: m.name,
+            line: m.line,
+            confidence: 0.85,
+          });
+        }
+      }
+    }
+
+    // ── Plugin install functions ──
+    for (const m of astSummary.methods || []) {
+      if (m.isExported && m.name === 'install' && !m.className) {
+        patterns.push({
+          type: 'vue-plugin',
+          methodName: m.name,
+          line: m.line,
+          confidence: 0.85,
+        });
+      }
+    }
+
+    // ── Vue ecosystem imports ──
+    const vueImports = (astSummary.imports || []).filter(
+      (imp) =>
+        imp.includes('vue') ||
+        imp.includes('pinia') ||
+        imp.includes('vue-router') ||
+        imp.includes('vueuse') ||
+        imp.includes('@vueuse')
+    );
+    if (vueImports.length > 0) {
+      patterns.push({
+        type: 'vue-ecosystem-usage',
+        importCount: vueImports.length,
+        confidence: 0.85,
+      });
+    }
+
     return patterns;
   }
 }