autosnippet 3.0.0 → 3.0.2

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

@@ -0,0 +1,63 @@
+/**
+ * FastAPI Enhancement Pack
+ * 条件: { languages: ['python'], frameworks: ['fastapi'] }
+ */
+
+import { EnhancementPack } from './EnhancementPack.js';
+
+class FastAPIEnhancement extends EnhancementPack {
+  get id() {
+    return 'fastapi';
+  }
+  get displayName() {
+    return 'FastAPI Enhancement';
+  }
+  get conditions() {
+    return { languages: ['python'], frameworks: ['fastapi'] };
+  }
+
+  getExtraDimensions() {
+    return [
+      {
+        id: 'fastapi-route-scan',
+        label: 'FastAPI 路由分析',
+        guide: 'Route 装饰器(@app.get/post/put/delete)、Pydantic Model/Schema、DI (Depends())',
+        knowledgeTypes: ['architecture', 'code-pattern'],
+        skillWorthy: true,
+        dualOutput: true,
+        skillMeta: {
+          name: 'project-fastapi-routes',
+          description:
+            'FastAPI route definitions, Pydantic schemas and dependency injection (auto-generated by enhancement)',
+        },
+      },
+    ];
+  }
+
+  detectPatterns(astSummary) {
+    const patterns = [];
+    for (const cls of astSummary.classes || []) {
+      if (cls.superclass && /BaseModel/.test(cls.superclass)) {
+        patterns.push({
+          type: 'pydantic-model',
+          className: cls.name,
+          line: cls.line,
+          confidence: 0.9,
+        });
+      }
+    }
+    for (const m of astSummary.methods || []) {
+      if (m.decorators?.some((d) => /@app\.(get|post|put|delete|patch)/.test(d))) {
+        patterns.push({
+          type: 'fastapi-route',
+          methodName: m.name,
+          line: m.line,
+          confidence: 0.95,
+        });
+      }
+    }
+    return patterns;
+  }
+}
+
+export const pack = new FastAPIEnhancement();

package/lib/core/enhancement/go-grpc-enhancement.js

@@ -0,0 +1,152 @@
+/**
+ * Go gRPC Enhancement Pack
+ * 条件: { languages: ['go'], frameworks: ['grpc'] }
+ *
+ * 覆盖 gRPC Go 微服务项目:
+ *   - protobuf service 实现
+ *   - Unimplemented*Server 嵌入
+ *   - 流式/一元 RPC 方法
+ *   - interceptor 链
+ */
+
+import { EnhancementPack } from './EnhancementPack.js';
+
+class GoGrpcEnhancement extends EnhancementPack {
+  get id() {
+    return 'go-grpc';
+  }
+  get displayName() {
+    return 'Go gRPC Enhancement';
+  }
+  get conditions() {
+    return { languages: ['go'], frameworks: ['grpc'] };
+  }
+
+  getExtraDimensions() {
+    return [
+      {
+        id: 'go-grpc-service-scan',
+        label: 'gRPC Service 分析',
+        guide:
+          'gRPC Service 实现分析 — Protobuf 生成代码与手写代码分离、Unimplemented*Server 嵌入、一元/流式方法分布、错误码使用规范',
+        knowledgeTypes: ['architecture', 'code-pattern'],
+        skillWorthy: true,
+        dualOutput: true,
+        skillMeta: {
+          name: 'project-go-grpc',
+          description:
+            'Go gRPC service implementations, streaming patterns and error code usage (auto-generated by enhancement)',
+        },
+      },
+      {
+        id: 'go-grpc-interceptor-scan',
+        label: 'gRPC Interceptor 分析',
+        guide:
+          'gRPC Interceptor 链路分析 — UnaryServerInterceptor / StreamServerInterceptor 注册顺序、日志/认证/限流拦截器',
+        knowledgeTypes: ['architecture'],
+        skillWorthy: true,
+        dualOutput: true,
+        skillMeta: {
+          name: 'project-go-grpc-interceptors',
+          description:
+            'Go gRPC interceptor chain ordering and middleware patterns (auto-generated by enhancement)',
+        },
+      },
+    ];
+  }
+
+  getGuardRules() {
+    return [
+      {
+        ruleId: 'go-grpc-unimplemented-embed',
+        severity: 'warning',
+        languages: ['go'],
+        pattern: /Unimplemented\w+Server\b/,
+        message:
+          'gRPC service 应嵌入 Unimplemented*Server 以保证前向兼容（新增 RPC 方法时不会编译失败）',
+      },
+      {
+        ruleId: 'go-grpc-status-error',
+        severity: 'info',
+        languages: ['go'],
+        pattern: /fmt\.Errorf|errors\.New/,
+        message:
+          'gRPC handler 中应使用 status.Errorf/status.Error 返回标准 gRPC 错误码，而非 fmt.Errorf',
+      },
+    ];
+  }
+
+  detectPatterns(astSummary) {
+    const patterns = [];
+
+    // ── gRPC Service Implementations ──
+    for (const cls of astSummary.classes || []) {
+      if (cls.kind !== 'struct') {
+        continue;
+      }
+      // Structs embedding Unimplemented*Server
+      if (cls.embeddedTypes?.some((t) => /^Unimplemented\w+Server$/.test(t))) {
+        patterns.push({
+          type: 'go-grpc-service-impl',
+          className: cls.name,
+          embeds: cls.embeddedTypes.filter((t) => /Unimplemented/.test(t)),
+          line: cls.line,
+          confidence: 0.95,
+        });
+      }
+      // Server structs (name ends with Server)
+      if (/Server$/.test(cls.name) && cls.fieldCount > 0) {
+        patterns.push({
+          type: 'go-grpc-server-struct',
+          className: cls.name,
+          line: cls.line,
+          confidence: 0.6,
+        });
+      }
+    }
+
+    // ── gRPC Interfaces (generated *Server interfaces) ──
+    for (const proto of astSummary.protocols || []) {
+      if (/Server$/.test(proto.name) && !proto.name.startsWith('Unimplemented')) {
+        patterns.push({
+          type: 'go-grpc-service-interface',
+          className: proto.name,
+          methods: proto.methods,
+          line: proto.line,
+          confidence: 0.8,
+        });
+      }
+    }
+
+    // ── Interceptor functions ──
+    for (const m of astSummary.methods || []) {
+      if (!m.className && m.isExported) {
+        const nameLower = m.name.toLowerCase();
+        if (nameLower.includes('interceptor') || nameLower.includes('middleware')) {
+          patterns.push({
+            type: 'go-grpc-interceptor',
+            methodName: m.name,
+            line: m.line,
+            confidence: 0.8,
+          });
+        }
+      }
+    }
+
+    // ── Protobuf imports ──
+    const pbImports = (astSummary.imports || []).filter(
+      (imp) => imp.includes('/pb') || imp.includes('/proto') || imp.includes('google.golang.org/grpc')
+    );
+    if (pbImports.length > 0) {
+      patterns.push({
+        type: 'go-grpc-proto-usage',
+        importCount: pbImports.length,
+        confidence: 0.85,
+      });
+    }
+
+    return patterns;
+  }
+}
+
+export const pack = new GoGrpcEnhancement();

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

@@ -0,0 +1,201 @@
+/**
+ * Go Web Enhancement Pack
+ * 条件: { languages: ['go'], frameworks: ['gin', 'echo', 'fiber', 'chi', 'gorilla', 'beego'] }
+ *
+ * 覆盖所有主流 Go HTTP 框架:
+ *   - Gin, Echo, Fiber, Chi, Gorilla Mux, Beego
+ */
+
+import { EnhancementPack } from './EnhancementPack.js';
+
+class GoWebEnhancement extends EnhancementPack {
+  get id() {
+    return 'go-web';
+  }
+  get displayName() {
+    return 'Go Web (Gin/Echo/Fiber/Chi) Enhancement';
+  }
+  get conditions() {
+    return {
+      languages: ['go'],
+      frameworks: ['gin', 'echo', 'fiber', 'chi', 'gorilla', 'beego'],
+    };
+  }
+
+  getExtraDimensions() {
+    return [
+      {
+        id: 'go-handler-scan',
+        label: 'HTTP Handler 分析',
+        guide:
+          'Go HTTP Handler 与 Middleware 链路分析 — handler 签名规范、中间件注册顺序、Context 传播、错误级联',
+        knowledgeTypes: ['architecture', 'code-pattern'],
+        skillWorthy: true,
+        dualOutput: true,
+        skillMeta: {
+          name: 'project-go-handlers',
+          description:
+            'Go HTTP handler patterns, middleware chains and context propagation (auto-generated by enhancement)',
+        },
+      },
+      {
+        id: 'go-route-scan',
+        label: 'API Route 结构',
+        guide:
+          'Go 路由结构分析 — 路由分组 (Group)、URI 命名规范、HTTP 方法分布、路由参数与通配符',
+        knowledgeTypes: ['architecture'],
+        skillWorthy: true,
+        dualOutput: true,
+        skillMeta: {
+          name: 'project-go-routes',
+          description:
+            'Go API route structure, grouping and URI naming conventions (auto-generated by enhancement)',
+        },
+      },
+    ];
+  }
+
+  getGuardRules() {
+    return [
+      {
+        ruleId: 'go-handler-abort-return',
+        severity: 'warning',
+        languages: ['go'],
+        pattern: /\.Abort\w*\([^)]*\)[^}]*\n\s*[^}\s/]/,
+        message: 'Abort/AbortWithStatus 后应立即 return，否则后续逻辑仍会执行',
+      },
+      {
+        ruleId: 'go-no-naked-goroutine',
+        severity: 'warning',
+        languages: ['go'],
+        pattern: /go\s+func\s*\(/,
+        message:
+          'HTTP handler 中启动 goroutine 应包含 recover() 防止 panic 导致整个进程崩溃',
+      },
+      {
+        ruleId: 'go-context-first-param',
+        severity: 'info',
+        languages: ['go'],
+        pattern:
+          /func\s+\w+\([^)]*\)\s*\([^)]*context\.Context/,
+        message: 'context.Context 应作为函数的第一个参数，而非放在返回值或中间位置',
+      },
+    ];
+  }
+
+  detectPatterns(astSummary) {
+    const patterns = [];
+
+    // ── Struct-based Handler / Controller ──
+    for (const cls of astSummary.classes || []) {
+      if (cls.kind !== 'struct') {
+        continue;
+      }
+      const nameLower = cls.name.toLowerCase();
+      if (
+        nameLower.includes('handler') ||
+        nameLower.includes('controller') ||
+        nameLower.includes('server') ||
+        nameLower.includes('api')
+      ) {
+        patterns.push({
+          type: 'go-handler-struct',
+          className: cls.name,
+          line: cls.line,
+          confidence: 0.8,
+        });
+      }
+    }
+
+    // ── HTTP Handler Interfaces ──
+    for (const proto of astSummary.protocols || []) {
+      if (proto.methods?.includes('ServeHTTP')) {
+        patterns.push({
+          type: 'go-http-handler-interface',
+          className: proto.name,
+          line: proto.line,
+          confidence: 0.95,
+        });
+      }
+    }
+
+    // ── Handler / Middleware methods ──
+    for (const m of astSummary.methods || []) {
+      // Exported methods on structs — likely handlers
+      if (m.className && m.isExported && !m.isClassMethod) {
+        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')
+        ) {
+          patterns.push({
+            type: 'go-handler-method',
+            className: m.className,
+            methodName: m.name,
+            line: m.line,
+            confidence: 0.7,
+          });
+        }
+      }
+      // Middleware pattern: package-level function returning HandlerFunc-like
+      if (!m.className && m.isClassMethod && m.isExported) {
+        const nameLower = m.name.toLowerCase();
+        if (
+          nameLower.includes('middleware') ||
+          nameLower.includes('logger') ||
+          nameLower.includes('recovery') ||
+          nameLower.includes('cors') ||
+          nameLower.includes('auth') ||
+          nameLower.includes('ratelimit') ||
+          nameLower.includes('timeout')
+        ) {
+          patterns.push({
+            type: 'go-middleware',
+            methodName: m.name,
+            line: m.line,
+            confidence: 0.75,
+          });
+        }
+      }
+    }
+
+    // ── Engine / Router struct (framework core) ──
+    for (const cls of astSummary.classes || []) {
+      if (cls.kind !== 'struct') {
+        continue;
+      }
+      if (/^(?:Engine|Router|App|Server|Mux|Group)$/.test(cls.name)) {
+        patterns.push({
+          type: 'go-router-core',
+          className: cls.name,
+          line: cls.line,
+          confidence: 0.85,
+        });
+      }
+    }
+
+    // ── Concurrency in web context ──
+    // goroutine + channel patterns from lang-go.js
+    for (const p of astSummary.patterns || []) {
+      if (p.type === 'goroutine' && p.count > 0) {
+        patterns.push({
+          type: 'go-web-concurrency',
+          goroutineCount: p.count,
+          confidence: 0.7,
+        });
+      }
+    }
+
+    return patterns;
+  }
+}
+
+export const pack = new GoWebEnhancement();

package/lib/core/enhancement/index.js

@@ -0,0 +1,65 @@
+/**
+ * @module enhancement/index
+ * @description Enhancement Pack 自动加载器与 Registry 初始化
+ *
+ * 使用方式:
+ *   import { getEnhancementRegistry } from '../core/enhancement/index.js';
+ *   const registry = getEnhancementRegistry();
+ *   const packs = registry.resolve(primaryLang, detectedFrameworks);
+ */
+
+import { EnhancementRegistry } from './EnhancementRegistry.js';
+
+let _instance = null;
+
+/**
+ * 获取全局 EnhancementRegistry 单例
+ * 注意: 首次访问前必须调用 initEnhancementRegistry() 完成异步加载
+ * 如果未初始化, 返回空 Registry（不会抛错, 但 resolve() 结果为空）
+ * @returns {EnhancementRegistry}
+ */
+export function getEnhancementRegistry() {
+  if (_instance) {
+    return _instance;
+  }
+  _instance = new EnhancementRegistry();
+  // 同步路径无法加载 ESM 动态 import — 返回空 Registry
+  // 使用方应确保先调用 initEnhancementRegistry()
+  return _instance;
+}
+
+/**
+ * 异步初始化 — 加载所有增强包
+ * 需要在使用 resolve() 之前调用
+ */
+export async function initEnhancementRegistry() {
+  if (_instance && _instance.all().length > 0) {
+    return _instance;
+  }
+  _instance = new EnhancementRegistry();
+
+  const packImports = [
+    import('./react-enhancement.js'),
+    import('./vue-enhancement.js'),
+    import('./node-server-enhancement.js'),
+    import('./django-enhancement.js'),
+    import('./fastapi-enhancement.js'),
+    import('./spring-enhancement.js'),
+    import('./android-enhancement.js'),
+    import('./go-web-enhancement.js'),
+    import('./go-grpc-enhancement.js'),
+  ];
+
+  const results = await Promise.allSettled(packImports);
+  for (const result of results) {
+    if (result.status === 'fulfilled' && result.value.pack) {
+      _instance.register(result.value.pack);
+    }
+  }
+
+  return _instance;
+}
+
+// Re-exports
+export { EnhancementPack } from './EnhancementPack.js';
+export { EnhancementRegistry } from './EnhancementRegistry.js';

package/lib/core/enhancement/node-server-enhancement.js

@@ -0,0 +1,88 @@
+/**
+ * Node.js Server Enhancement Pack
+ * 条件: { languages: ['typescript', 'javascript'], frameworks: ['node-server', 'nestjs'] }
+ */
+
+import { EnhancementPack } from './EnhancementPack.js';
+
+class NodeServerEnhancement extends EnhancementPack {
+  get id() {
+    return 'node-server';
+  }
+  get displayName() {
+    return 'Node.js Server (Express/NestJS) Enhancement';
+  }
+  get conditions() {
+    return { languages: ['typescript', 'javascript'], frameworks: ['node-server', 'nestjs'] };
+  }
+
+  getExtraDimensions() {
+    return [
+      {
+        id: 'middleware-analysis',
+        label: '中间件链分析',
+        guide: 'Middleware 链路分析、错误处理中间件、路由守卫、认证/鉴权中间件',
+        knowledgeTypes: ['architecture', 'code-pattern'],
+        skillWorthy: true,
+        dualOutput: true,
+        skillMeta: {
+          name: 'project-node-middleware',
+          description:
+            'Node.js middleware chain and error handling patterns (auto-generated by enhancement)',
+        },
+      },
+    ];
+  }
+
+  getGuardRules() {
+    return [
+      {
+        ruleId: 'node-no-sync-io',
+        severity: 'warning',
+        languages: ['typescript', 'javascript'],
+        pattern:
+          /(?:readFileSync|writeFileSync|appendFileSync|mkdirSync|readdirSync|statSync|existsSync|unlinkSync|renameSync|copyFileSync|accessSync)/,
+        message: '避免在请求路径中使用同步 IO 操作',
+      },
+      {
+        ruleId: 'node-error-handler',
+        severity: 'info',
+        languages: ['typescript', 'javascript'],
+        pattern: /app\.use\(\s*\(\s*err\s*,\s*req\s*,\s*res\s*,\s*next\s*\)/,
+        message: 'Express 应用需要注册 4 参数错误处理中间件',
+      },
+    ];
+  }
+
+  detectPatterns(astSummary) {
+    const patterns = [];
+    for (const m of astSummary.methods || []) {
+      // Middleware: (req, res, next) => 签名
+      if (!m.className && m.paramCount === 3) {
+        patterns.push({ type: 'middleware', methodName: m.name, line: m.line, confidence: 0.6 });
+      }
+    }
+    // NestJS decorators
+    for (const cls of astSummary.classes || []) {
+      if (cls.decorators?.some((d) => /@Controller/.test(d))) {
+        patterns.push({
+          type: 'nestjs-controller',
+          className: cls.name,
+          line: cls.line,
+          confidence: 0.95,
+        });
+      }
+      if (cls.decorators?.some((d) => /@Injectable/.test(d))) {
+        patterns.push({
+          type: 'nestjs-injectable',
+          className: cls.name,
+          line: cls.line,
+          confidence: 0.95,
+        });
+      }
+    }
+    return patterns;
+  }
+}
+
+export const pack = new NodeServerEnhancement();

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

@@ -0,0 +1,86 @@
+/**
+ * React Enhancement Pack
+ * 条件: { languages: ['typescript', 'javascript'], frameworks: ['react', 'nextjs'] }
+ */
+
+import { EnhancementPack } from './EnhancementPack.js';
+
+class ReactEnhancement extends EnhancementPack {
+  get id() {
+    return 'react';
+  }
+  get displayName() {
+    return 'React / Next.js Enhancement';
+  }
+  get conditions() {
+    return { languages: ['typescript', 'javascript'], frameworks: ['react', 'nextjs'] };
+  }
+
+  getExtraDimensions() {
+    return [
+      {
+        id: 'hook-pattern-scan',
+        label: '自定義 Hook 分析',
+        guide:
+          '自定义 Hook 提取（useXxx 函数 + 内部状态/副作用分析）、Hook 组合模式、Hook 依赖关系',
+        knowledgeTypes: ['code-pattern'],
+        skillWorthy: true,
+        dualOutput: true,
+        skillMeta: {
+          name: 'project-react-hooks',
+          description: 'Custom React Hook patterns and composition (auto-generated by enhancement)',
+        },
+      },
+      {
+        id: 'component-structure-scan',
+        label: '组件结构约定',
+        guide: '组件目录结构约定（文件组织、barrel export、props/state 命名规范）',
+        knowledgeTypes: ['code-standard', 'architecture'],
+        skillWorthy: true,
+        dualOutput: true,
+        skillMeta: {
+          name: 'project-react-components',
+          description: 'React component structure conventions (auto-generated by enhancement)',
+        },
+      },
+    ];
+  }
+
+  getGuardRules() {
+    return [
+      {
+        ruleId: 'react-no-direct-dom',
+        severity: 'warning',
+        languages: ['typescript', 'javascript'],
+        pattern: /document\.(getElementById|querySelector|getElementsBy)/,
+        message: '避免直接 DOM 操作，使用 React ref 或状态管理',
+      },
+      {
+        ruleId: 'react-no-index-key',
+        severity: 'warning',
+        languages: ['typescript', 'javascript'],
+        pattern:
+          /\.map\s*\([^)]*,\s*(?:index|i|idx)\s*\)\s*=>\s*[\s\S]*?key\s*=\s*\{?\s*(?:index|i|idx)/,
+        message: '避免使用 index 作为 key，使用稳定的唯一标识符',
+      },
+    ];
+  }
+
+  detectPatterns(astSummary) {
+    const patterns = [];
+    for (const m of astSummary.methods || []) {
+      if (m.name && /^use[A-Z]/.test(m.name) && !m.className) {
+        patterns.push({ type: 'custom-hook', methodName: m.name, line: m.line, confidence: 0.9 });
+      }
+    }
+    // HOC: function withXxx(Component)
+    for (const m of astSummary.methods || []) {
+      if (m.name && /^with[A-Z]/.test(m.name) && !m.className) {
+        patterns.push({ type: 'hoc', methodName: m.name, line: m.line, confidence: 0.8 });
+      }
+    }
+    return patterns;
+  }
+}
+
+export const pack = new ReactEnhancement();