autosnippet 3.0.11 → 3.1.0

package/dashboard/dist/index.html

@@ -5,7 +5,7 @@
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>AutoSnippet Dashboard</title>
-    <script type="module" crossorigin src="/assets/index-I2ySoCmF.js"></script>
+    <script type="module" crossorigin src="/assets/index-Bnm26ulL.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/yaml-qRaU8Ldn.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-CEnWn7aV.js">
     <link rel="modulepreload" crossorigin href="/assets/axios-C0Zqfgkc.js">

package/lib/bootstrap.js

@@ -57,7 +57,7 @@ export class Bootstrap {
       // 2. 初始化日志系统
       await this.initializeLogger();
 
-      this.components.logger.info('AutoSnippet 2.0 - Starting initialization...');
+      this.components.logger.info('AutoSnippet - Starting initialization...');
 
       // 3. 连接数据库
       await this.initializeDatabase();
@@ -75,7 +75,7 @@ export class Bootstrap {
       // await this.registerRoutes();
 
       const duration = Date.now() - startTime;
-      this.components.logger.info(`AutoSnippet 2.0 initialized successfully (${duration}ms)`);
+      this.components.logger.info(`AutoSnippet initialized successfully (${duration}ms)`);
 
       return this.components;
     } catch (error) {
@@ -200,14 +200,14 @@ export class Bootstrap {
    * 关闭应用程序
    */
   async shutdown() {
-    this.components.logger?.info('AutoSnippet 2.0 - Shutting down...');
+    this.components.logger?.info('AutoSnippet - Shutting down...');
 
     // 关闭数据库连接
     if (this.components.db) {
       await this.components.db.close();
     }
 
-    this.components.logger?.info('AutoSnippet 2.0 - Shutdown complete');
+    this.components.logger?.info('AutoSnippet - Shutdown complete');
   }
 
   /**

package/lib/cli/SetupService.js

@@ -53,6 +53,7 @@ import {
 } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { checkWriteSafety } from '../service/cursor/FileProtection.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -102,21 +103,15 @@ export class SetupService {
     const results = [];
     const total = steps.length;
 
-    console.log('');
-    console.log(`  ⚙ AutoSnippet Setup — ${this.projectName}`);
-    console.log(`  ${'─'.repeat(44)}`);
-
     for (let i = 0; i < total; i++) {
       const { label, fn } = steps[i];
       const tag = `[${i + 1}/${total}]`;
       process.stdout.write(`  ${tag} ${label}...`);
       try {
         const r = await fn();
-        const detail = this._formatStepDetail(r);
-        console.log(` ✅${detail}`);
+        const _detail = this._formatStepDetail(r);
         results.push({ step: i + 1, label, ok: true, ...(r || {}) });
       } catch (err) {
-        console.log(` ❌`);
         console.error(`       ${err.message}`);
         results.push({ step: i + 1, label, ok: false, error: err.message });
       }
@@ -128,7 +123,9 @@ export class SetupService {
 
   /** @private 格式化步骤结果的简要信息 */
   _formatStepDetail(r) {
-    if (!r) return '';
+    if (!r) {
+      return '';
+    }
     const parts = [];
     if (r.configured) {
       parts.push(r.configured.join(', '));
@@ -144,17 +141,8 @@ export class SetupService {
 
   printSummary() {
     const results = this._results || [];
-    const ok = results.filter((r) => r.ok).length;
-    const fail = results.filter((r) => !r.ok).length;
-
-    console.log(`  ${'─'.repeat(44)}`);
-    console.log(`  ✨ Setup 完成: ${ok} 成功${fail > 0 ? `, ${fail} 失败` : ''}`);
-    console.log('');
-    console.log('  后续操作:');
-    console.log('    asd coldstart        扫描项目、AI 生成知识库');
-    console.log('    asd ui               启动 Dashboard + API Server');
-    console.log('    asd watch            启动 Xcode 文件监听');
-    console.log('');
+    const _ok = results.filter((r) => r.ok).length;
+    const _fail = results.filter((r) => !r.ok).length;
   }
 
   /* ═══ Step 1: 运行时目录与配置 ═══════════════════════ */
@@ -451,10 +439,10 @@ export class SetupService {
     this._configureVSCodeMCP(mcpServerPath);
     this._configureCursorMCP(mcpServerPath);
     this._copyCopilotInstructions();
+    this._generateAgentInstructionFiles();
     this._copyCursorRules();
     this._copySkillsTemplate();
-    this._mirrorCursorToIDE('.qoder');
-    this._mirrorCursorToIDE('.trae');
+    // NOTE: .qoder/ .trae/ 不再自动创建，用户可通过 `asd mirror` 按需生成
 
     const extResult = this._installVSCodeExtension();
 
@@ -462,10 +450,9 @@ export class SetupService {
       'vscode-mcp',
       'cursor-mcp',
       'copilot-instructions',
+      'agent-instructions',
       'cursor-rules',
       'skills-template',
-      'qoder-rules',
-      'trae-rules',
     ];
     if (extResult) {
       configured.push(...extResult);
@@ -577,7 +564,12 @@ export class SetupService {
     const whichCmd = process.platform === 'win32' ? 'where' : 'which';
     for (const cmd of ['code', 'cursor', 'codex', 'code-insiders']) {
       try {
-        const p = execSync(`${whichCmd} ${cmd}`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'ignore'] }).trim().split(/\r?\n/)[0];
+        const p = execSync(`${whichCmd} ${cmd}`, {
+          encoding: 'utf8',
+          stdio: ['pipe', 'pipe', 'ignore'],
+        })
+          .trim()
+          .split(/\r?\n/)[0];
         if (p) {
           candidates.push({ name: cmd, cli: p });
         }
@@ -591,7 +583,11 @@ export class SetupService {
       // macOS: /Applications/xxx.app/Contents/Resources/app/bin/
       const appPaths = [
         { name: 'vscode', app: '/Applications/Visual Studio Code.app', bin: 'code' },
-        { name: 'vscode-insiders', app: '/Applications/Visual Studio Code - Insiders.app', bin: 'code-insiders' },
+        {
+          name: 'vscode-insiders',
+          app: '/Applications/Visual Studio Code - Insiders.app',
+          bin: 'code-insiders',
+        },
         { name: 'cursor', app: '/Applications/Cursor.app', bin: 'cursor' },
         { name: 'codex', app: '/Applications/Codex.app', bin: 'codex' },
       ];
@@ -603,10 +599,15 @@ export class SetupService {
       }
     } else if (process.platform === 'win32') {
       // Windows: %LOCALAPPDATA%\Programs\xxx
-      const localAppData = process.env.LOCALAPPDATA || join(process.env.USERPROFILE || '', 'AppData', 'Local');
+      const localAppData =
+        process.env.LOCALAPPDATA || join(process.env.USERPROFILE || '', 'AppData', 'Local');
       const winPaths = [
         { name: 'vscode', dir: 'Microsoft VS Code', bin: 'bin/code.cmd' },
-        { name: 'vscode-insiders', dir: 'Microsoft VS Code Insiders', bin: 'bin/code-insiders.cmd' },
+        {
+          name: 'vscode-insiders',
+          dir: 'Microsoft VS Code Insiders',
+          bin: 'bin/code-insiders.cmd',
+        },
         { name: 'cursor', dir: 'cursor', bin: 'cursor.exe' },
       ];
       for (const { name, dir, bin } of winPaths) {
@@ -639,7 +640,9 @@ export class SetupService {
       } catch {
         /* use as-is */
       }
-      if (seen.has(realPath)) return false;
+      if (seen.has(realPath)) {
+        return false;
+      }
       seen.add(realPath);
       return true;
     });
@@ -706,7 +709,7 @@ export class SetupService {
     writeFileSync(configPath, JSON.stringify(existing, null, 2));
   }
 
-  /** @private .github/copilot-instructions.md */
+  /** @private .github/copilot-instructions.md (static template fallback) */
   _copyCopilotInstructions() {
     const src = join(REPO_ROOT, 'templates', 'copilot-instructions.md');
     if (!existsSync(src)) {
@@ -719,10 +722,94 @@ export class SetupService {
       return;
     }
 
+    // 即使 --force，也不覆盖用户原有的非 AutoSnippet 文件
+    const { canWrite } = checkWriteSafety(dest);
+    if (!canWrite) {
+      return;
+    }
+
     mkdirSync(destDir, { recursive: true });
     copyFileSync(src, dest);
   }
 
+  /**
+   * @private 生成 AGENTS.md + CLAUDE.md 静态骨架
+   * setup 阶段没有知识库数据，所以只生成指向 MCP 的基础版本。
+   * bootstrap / delivery pipeline 完成后会用动态版本覆盖。
+   */
+  _generateAgentInstructionFiles() {
+    const projectName = this.projectRoot.split('/').pop();
+
+    // AGENTS.md
+    const agentsPath = join(this.projectRoot, 'AGENTS.md');
+    if (!existsSync(agentsPath) || this.force) {
+      const { canWrite } = checkWriteSafety(agentsPath);
+      if (canWrite) {
+        const agentsContent = [
+          `# ${projectName} — Agent Instructions`,
+          '',
+          '> Auto-generated by AutoSnippet. Will be enriched after `asd bootstrap`.',
+          '',
+          '## Project Knowledge Base',
+          '',
+          'This project uses **AutoSnippet** for knowledge management.',
+          'Run `asd bootstrap` to populate the knowledge base, then this file will be',
+          'regenerated with coding standards, patterns, and tool references.',
+          '',
+          '## MCP Tools',
+          '',
+          'Use these MCP tools to access the full knowledge base:',
+          '- `autosnippet_search` — Search knowledge (mode: auto/context/keyword/semantic)',
+          '- `autosnippet_knowledge` — Browse/get recipes (operation: list/get/insights)',
+          '- `autosnippet_submit_knowledge` — Submit candidate (strict validation)',
+          '- `autosnippet_guard` — Code compliance check',
+          '- `autosnippet_health` — Service health & KB stats',
+          '',
+          '## Mandatory Constraints',
+          '',
+          '1. **Do NOT modify** knowledge base files directly (`AutoSnippet/`, `.autosnippet/`).',
+          '2. Create or update knowledge **only** through MCP tools.',
+          '3. **Prefer Recipes** as project standards; source code is supplementary.',
+          '',
+        ].join('\n');
+        writeFileSync(agentsPath, agentsContent);
+      } else {
+      }
+    }
+
+    // CLAUDE.md
+    const claudePath = join(this.projectRoot, 'CLAUDE.md');
+    if (!existsSync(claudePath) || this.force) {
+      const { canWrite } = checkWriteSafety(claudePath);
+      if (canWrite) {
+        const claudeContent = [
+          `# ${projectName} — Claude Code Instructions`,
+          '',
+          '> Auto-generated by AutoSnippet. Will be enriched after `asd bootstrap`.',
+          '',
+          '## MCP Integration',
+          '',
+          'This project has an AutoSnippet MCP server configured.',
+          'Use the following tools to access project knowledge:',
+          '- `autosnippet_search` — Search knowledge (mode: auto/context/keyword/semantic)',
+          '- `autosnippet_knowledge` — Browse/get recipes (operation: list/get/insights)',
+          '- `autosnippet_submit_knowledge` — Submit candidate (strict validation)',
+          '- `autosnippet_guard` — Code compliance check',
+          '- `autosnippet_health` — Service health & KB stats',
+          '',
+          '## Mandatory Constraints',
+          '',
+          '1. **Do NOT modify** knowledge base files directly (`AutoSnippet/`, `.autosnippet/`).',
+          '2. Create or update knowledge **only** through MCP tools.',
+          '3. **Prefer Recipes** as project standards; source code is supplementary.',
+          '',
+        ].join('\n');
+        writeFileSync(claudePath, claudeContent);
+      } else {
+      }
+    }
+  }
+
   /** @private .cursor/rules/autosnippet-conventions.mdc */
   _copyCursorRules() {
     const src = join(REPO_ROOT, 'templates', 'cursor-rules', 'autosnippet-conventions.mdc');

package/lib/cli/UpgradeService.js

@@ -5,7 +5,7 @@
  *   ① MCP 配置（.cursor/mcp.json + .vscode/mcp.json）
  *   ② Cursor Skills（.cursor/skills/）
  *   ③ Cursor Rules（.cursor/rules/autosnippet-conventions.mdc + autosnippet-skills.mdc）
- *   ④ Copilot Instructions（.github/copilot-instructions.md）
+ *   ④ Agent Instructions（AGENTS.md + CLAUDE.md + .github/copilot-instructions.md — 通过 Channel F 动态生成）
  *   ⑤ Constitution（AutoSnippet/constitution.yaml）
  *   ⑥ .gitignore（升级规则 + 清理旧版本残留）
  *   ⑦ Skills 路径迁移（.autosnippet/skills/ → AutoSnippet/skills/）
@@ -24,6 +24,7 @@ import {
 } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { safeCopyFile } from '../service/cursor/FileProtection.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -47,8 +48,7 @@ export class UpgradeService {
     }
     if (!skillsOnly && !mcpOnly) {
       results.push(this._upgradeCursorRules());
-      results.push(this._upgradeMirrorIDE('.qoder'));
-      results.push(this._upgradeMirrorIDE('.trae'));
+      // NOTE: .qoder/ .trae/ 不再自动镜像，用户可通过 `asd mirror` 按需同步
       results.push(this._upgradeSkillsTemplate());
       results.push(this._upgradeCopilotInstructions());
       results.push(this._upgradeConstitution());
@@ -169,6 +169,7 @@ export class UpgradeService {
 
   /**
    * 触发 Cursor Delivery Pipeline 动态生成
+   * 包含 Channel A-D + Channel F (AGENTS.md / CLAUDE.md / copilot-instructions)
    * 非阻塞 — 失败不影响 upgrade 流程
    */
   _triggerCursorDelivery() {
@@ -180,7 +181,9 @@ export class UpgradeService {
           pipeline
             .deliver()
             .then((_result) => {})
-            .catch((_err) => {});
+            .catch((_err) => {
+              /* fire-and-forget: delivery failure is non-critical during upgrade */
+            });
         }
       })
       .catch(() => {
@@ -247,8 +250,13 @@ export class UpgradeService {
     }
   }
 
-  /* ═══ Copilot Instructions ══════════════════════════ */
+  /* ═══ Copilot Instructions (fallback static copy) ══════════════════ */
 
+  /**
+   * 静态模板回退 — 当 _triggerCursorDelivery() 无法运行时
+   * （无 DB 环境），至少保证有一份基础模板。
+   * Channel F 动态生成会覆盖此文件。
+   */
   _upgradeCopilotInstructions() {
     const src = join(REPO_ROOT, 'templates', 'copilot-instructions.md');
     if (!existsSync(src)) {
@@ -258,7 +266,9 @@ export class UpgradeService {
     const destDir = join(this.projectRoot, '.github');
     const dest = join(destDir, 'copilot-instructions.md');
     mkdirSync(destDir, { recursive: true });
-    copyFileSync(src, dest);
+    const { written } = safeCopyFile(src, dest);
+    if (!written) {
+    }
   }
 
   /* ═══ Constitution ══════════════════════════════════ */

package/lib/core/AstAnalyzer.js

@@ -128,7 +128,7 @@ function analyzeProject(files, lang, options) {
 
     // SFC 预处理: .vue / .svelte 等文件 → 提取 <script> 块再交给 AST
     if (preprocessFile) {
-      const ext = file.name ? ('.' + file.name.split('.').pop()) : '';
+      const ext = file.name ? `.${file.name.split('.').pop()}` : '';
       const result = preprocessFile(content, ext);
       if (result) {
         content = result.content;

package/lib/core/ast/ensure-grammars.js

@@ -88,7 +88,7 @@ export async function ensureGrammars(detectedLanguages, options = {}) {
   if (result.failed.length > 0) {
     logger?.warn?.(
       `[ensure-grammars] ${result.failed.length} grammar(s) missing. ` +
-      `Expected in: ${GRAMMARS_DIR}`
+        `Expected in: ${GRAMMARS_DIR}`
     );
   } else {
     logger?.info?.('[ensure-grammars] All required grammar .wasm files available');

package/lib/core/ast/index.js

@@ -20,7 +20,7 @@
  */
 
 import { registerLanguage } from '../AstAnalyzer.js';
-import { initParser, loadLanguageWasm, isParserReady } from './parser-init.js';
+import { initParser, isParserReady, loadLanguageWasm } from './parser-init.js';
 
 let _loaded = false;
 
@@ -36,17 +36,68 @@ export function _resetForReload() {
  * 语言注册表 — langId → { wasmFile, module, setGrammarFn, langId, tsxWasmFile?, setTsxGrammarFn? }
  */
 const LANG_REGISTRY = [
-  { langId: 'objectivec', wasmFile: 'tree-sitter-objc.wasm', module: './lang-objc.js', setFn: 'setGrammar' },
-  { langId: 'swift', wasmFile: 'tree-sitter-swift.wasm', module: './lang-swift.js', setFn: 'setGrammar' },
-  { langId: 'typescript', wasmFile: 'tree-sitter-typescript.wasm', module: './lang-typescript.js', setFn: 'setGrammar' },
-  { langId: 'tsx', wasmFile: 'tree-sitter-tsx.wasm', module: './lang-typescript.js', setFn: 'setTsxGrammar', pluginKey: 'tsxPlugin' },
-  { langId: 'javascript', wasmFile: 'tree-sitter-javascript.wasm', module: './lang-javascript.js', setFn: 'setGrammar' },
-  { langId: 'python', wasmFile: 'tree-sitter-python.wasm', module: './lang-python.js', setFn: 'setGrammar' },
-  { langId: 'java', wasmFile: 'tree-sitter-java.wasm', module: './lang-java.js', setFn: 'setGrammar' },
-  { langId: 'kotlin', wasmFile: 'tree-sitter-kotlin.wasm', module: './lang-kotlin.js', setFn: 'setGrammar' },
+  {
+    langId: 'objectivec',
+    wasmFile: 'tree-sitter-objc.wasm',
+    module: './lang-objc.js',
+    setFn: 'setGrammar',
+  },
+  {
+    langId: 'swift',
+    wasmFile: 'tree-sitter-swift.wasm',
+    module: './lang-swift.js',
+    setFn: 'setGrammar',
+  },
+  {
+    langId: 'typescript',
+    wasmFile: 'tree-sitter-typescript.wasm',
+    module: './lang-typescript.js',
+    setFn: 'setGrammar',
+  },
+  {
+    langId: 'tsx',
+    wasmFile: 'tree-sitter-tsx.wasm',
+    module: './lang-typescript.js',
+    setFn: 'setTsxGrammar',
+    pluginKey: 'tsxPlugin',
+  },
+  {
+    langId: 'javascript',
+    wasmFile: 'tree-sitter-javascript.wasm',
+    module: './lang-javascript.js',
+    setFn: 'setGrammar',
+  },
+  {
+    langId: 'python',
+    wasmFile: 'tree-sitter-python.wasm',
+    module: './lang-python.js',
+    setFn: 'setGrammar',
+  },
+  {
+    langId: 'java',
+    wasmFile: 'tree-sitter-java.wasm',
+    module: './lang-java.js',
+    setFn: 'setGrammar',
+  },
+  {
+    langId: 'kotlin',
+    wasmFile: 'tree-sitter-kotlin.wasm',
+    module: './lang-kotlin.js',
+    setFn: 'setGrammar',
+  },
   { langId: 'go', wasmFile: 'tree-sitter-go.wasm', module: './lang-go.js', setFn: 'setGrammar' },
-  { langId: 'dart', wasmFile: 'tree-sitter-dart.wasm', module: './lang-dart.js', setFn: 'setGrammar' },
-  { langId: 'rust', wasmFile: 'tree-sitter-rust.wasm', module: './lang-rust.js', setFn: 'setGrammar' },
+  {
+    langId: 'dart',
+    wasmFile: 'tree-sitter-dart.wasm',
+    module: './lang-dart.js',
+    setFn: 'setGrammar',
+  },
+  {
+    langId: 'rust',
+    wasmFile: 'tree-sitter-rust.wasm',
+    module: './lang-rust.js',
+    setFn: 'setGrammar',
+  },
 ];
 
 /**

package/lib/core/ast/lang-dart.js

@@ -146,8 +146,12 @@ function _parseClassDef(node, ctx) {
   }
 
   let kind = 'class';
-  if (isAbstract) kind = 'abstract-class';
-  if (isSealed) kind = 'sealed-class';
+  if (isAbstract) {
+    kind = 'abstract-class';
+  }
+  if (isSealed) {
+    kind = 'sealed-class';
+  }
 
   ctx.classes.push({
     name,
@@ -227,7 +231,9 @@ function _parseMixinDecl(node, ctx) {
   );
   const name = nameNode?.text || 'Unknown';
 
-  const onClause = node.namedChildren.find((c) => c.type === 'on_clause' || c.type === 'superclass');
+  const onClause = node.namedChildren.find(
+    (c) => c.type === 'on_clause' || c.type === 'superclass'
+  );
   const constraints = [];
   if (onClause) {
     for (let i = 0; i < onClause.namedChildCount; i++) {
@@ -262,9 +268,7 @@ function _parseExtensionDecl(node, ctx) {
   const name = nameNode?.text || 'anonymous_extension';
 
   // on Type
-  const onType = node.namedChildren.find(
-    (c) => c.type === 'type_identifier' && c !== nameNode
-  );
+  const onType = node.namedChildren.find((c) => c.type === 'type_identifier' && c !== nameNode);
 
   ctx.categories.push({
     name,
@@ -273,7 +277,9 @@ function _parseExtensionDecl(node, ctx) {
     endLine: node.endPosition.row + 1,
   });
 
-  const body = node.namedChildren.find((c) => c.type === 'class_body' || c.type === 'extension_body');
+  const body = node.namedChildren.find(
+    (c) => c.type === 'class_body' || c.type === 'extension_body'
+  );
   if (body) {
     _walkClassBody(body, ctx, name);
   }
@@ -310,9 +316,7 @@ function _parseFunctionDef(node, className) {
   const isAsync = node.text.includes('async') || node.text.includes('async*');
   const isOverride = node.text.includes('@override');
 
-  const body = node.namedChildren.find(
-    (c) => c.type === 'function_body' || c.type === 'block'
-  );
+  const body = node.namedChildren.find((c) => c.type === 'function_body' || c.type === 'block');
   const bodyLines = body ? body.endPosition.row - body.startPosition.row + 1 : 0;
   const complexity = body ? _estimateComplexity(body) : 1;
   const nestingDepth = body ? _maxNesting(body, 0) : 0;
@@ -372,13 +376,17 @@ function detectDartPatterns(root, lang, methods, properties, classes) {
   const classPropMap = {};
   for (const m of methods) {
     if (m.className) {
-      if (!classMethodMap[m.className]) classMethodMap[m.className] = [];
+      if (!classMethodMap[m.className]) {
+        classMethodMap[m.className] = [];
+      }
       classMethodMap[m.className].push(m);
     }
   }
   for (const p of properties) {
     if (p.className) {
-      if (!classPropMap[p.className]) classPropMap[p.className] = [];
+      if (!classPropMap[p.className]) {
+        classPropMap[p.className] = [];
+      }
       classPropMap[p.className].push(p);
     }
   }
@@ -430,10 +438,7 @@ function detectDartPatterns(root, lang, methods, properties, classes) {
     }
 
     // ChangeNotifier (Provider pattern)
-    if (
-      cls.superclass === 'ChangeNotifier' ||
-      (cls.mixins && cls.mixins.includes('ChangeNotifier'))
-    ) {
+    if (cls.superclass === 'ChangeNotifier' || cls.mixins?.includes('ChangeNotifier')) {
       patterns.push({
         type: 'change-notifier',
         className: cls.name,
@@ -448,9 +453,7 @@ function detectDartPatterns(root, lang, methods, properties, classes) {
     const hasPrivateConstructor = classMethods.some(
       (m) => m.kind === 'constructor' && m.name.startsWith('_')
     );
-    const hasStaticInstance = classProps.some(
-      (p) => p.isStatic && (p.isFinal || p.isConst)
-    );
+    const hasStaticInstance = classProps.some((p) => p.isStatic && (p.isFinal || p.isConst));
     const hasFactoryConstructor = classMethods.some((m) => m.kind === 'factory');
 
     if (hasPrivateConstructor && (hasStaticInstance || hasFactoryConstructor)) {
@@ -493,7 +496,7 @@ function detectDartPatterns(root, lang, methods, properties, classes) {
     }
 
     // Freezed pattern — @freezed/@Freezed annotation + with _$ClassName mixin
-    if (cls.mixins && cls.mixins.some((m) => m.startsWith('_$'))) {
+    if (cls.mixins?.some((m) => m.startsWith('_$'))) {
       patterns.push({
         type: 'freezed',
         className: cls.name,
@@ -548,7 +551,10 @@ function _detectStreamUsage(root, patterns) {
     if (node.type === 'type_identifier' && node.text === 'Stream') {
       streamCount++;
     }
-    if (node.type === 'identifier' && (node.text === 'StreamController' || node.text === 'StreamSubscription')) {
+    if (
+      node.type === 'identifier' &&
+      (node.text === 'StreamController' || node.text === 'StreamSubscription')
+    ) {
       streamCount++;
     }
     for (let i = 0; i < node.namedChildCount; i++) {

package/lib/core/ast/lang-go.js

@@ -39,9 +39,7 @@ function walkGo(root, ctx) {
           // 单行 import
           const spec = child.namedChildren.find((c) => c.type === 'import_spec');
           if (spec) {
-            const strLit = spec.namedChildren.find(
-              (c) => c.type === 'interpreted_string_literal'
-            );
+            const strLit = spec.namedChildren.find((c) => c.type === 'interpreted_string_literal');
             if (strLit) {
               ctx.imports.push(strLit.text.replace(/"/g, ''));
             }
@@ -117,7 +115,7 @@ function _walkTypeDeclaration(node, ctx) {
 
 function _parseStruct(name, structNode, specNode, ctx) {
   const fields = [];
-  let embeddedTypes = [];
+  const embeddedTypes = [];
 
   const fieldList = structNode.namedChildren.find((c) => c.type === 'field_declaration_list');
   if (fieldList) {
@@ -326,14 +324,9 @@ function detectGoPatterns(root, lang, methods, properties, classes) {
       continue;
     }
     // 检查是否有 package-level var 指向此 struct
-    const hasPackageVar = properties.some(
-      (p) => !p.className && !p.isConst && !p.isExported
-    );
+    const hasPackageVar = properties.some((p) => !p.className && !p.isConst && !p.isExported);
     const hasNewFunc = methods.some(
-      (m) =>
-        !m.className &&
-        /^(?:New|Get|Default)/.test(m.name) &&
-        m.isExported
+      (m) => !m.className && /^(?:New|Get|Default)/.test(m.name) && m.isExported
     );
     if (hasPackageVar && hasNewFunc) {
       patterns.push({
@@ -346,11 +339,7 @@ function detectGoPatterns(root, lang, methods, properties, classes) {
 
   // Factory: New* / Create* package-level functions
   for (const m of methods) {
-    if (
-      !m.className &&
-      m.isExported &&
-      /^(?:New|Create|Make|Build|Open|Connect)/.test(m.name)
-    ) {
+    if (!m.className && m.isExported && /^(?:New|Create|Make|Build|Open|Connect)/.test(m.name)) {
       patterns.push({
         type: 'factory',
         methodName: m.name,
@@ -446,10 +435,7 @@ function _countParams(paramList) {
   let count = 0;
   for (let i = 0; i < paramList.namedChildCount; i++) {
     const child = paramList.namedChild(i);
-    if (
-      child.type === 'parameter_declaration' ||
-      child.type === 'variadic_parameter_declaration'
-    ) {
+    if (child.type === 'parameter_declaration' || child.type === 'variadic_parameter_declaration') {
       // Each identifier in the same declaration is a parameter
       const ids = child.namedChildren.filter((c) => c.type === 'identifier');
       count += Math.max(ids.length, 1);