autosnippet 3.3.7 → 3.3.8

package/dist/lib/service/skills/SignalCollector.js

@@ -49,7 +49,8 @@ const MAX_INTERVAL_MS = 24 * 60 * 60 * 1000; // 最长 24 小时
 const SNAPSHOT_FILE = 'signal-snapshot.json';
 export class SignalCollector {
     #projectRoot;
-    #db;
+    #knowledgeRepo;
+    #auditRepo;
     #agentFactory;
     #container;
     #mode;
@@ -74,9 +75,10 @@ export class SignalCollector {
      * @param [opts.intervalMs] 初始收集间隔（毫秒），后续由 AI 动态调整
      * @param [opts.onSuggestions] 新建议回调 (suggestions[]) => void
      */
-    constructor({ projectRoot, database = null, agentFactory = null, container = null, signalBus = null, mode = 'auto', intervalMs = DEFAULT_INTERVAL_MS, onSuggestions = null, }) {
+    constructor({ projectRoot, knowledgeRepo = null, auditRepo = null, agentFactory = null, container = null, signalBus = null, mode = 'auto', intervalMs = DEFAULT_INTERVAL_MS, onSuggestions = null, }) {
         this.#projectRoot = projectRoot;
-        this.#db = database;
+        this.#knowledgeRepo = knowledgeRepo;
+        this.#auditRepo = auditRepo;
         this.#agentFactory = agentFactory;
         this.#container = container;
         this.#mode = ['off', 'suggest', 'auto'].includes(mode) ? mode : 'auto';
@@ -209,11 +211,11 @@ export class SignalCollector {
         try {
             // 1. 多维度收集信号
             const signals = {
-                guard: this.#collectGuardSignals(),
+                guard: await this.#collectGuardSignals(),
                 memory: this.#collectMemorySignals(),
-                recipes: this.#collectRecipeSignals(),
-                candidates: this.#collectCandidateSignals(),
-                actions: this.#collectRecentActions(),
+                recipes: await this.#collectRecipeSignals(),
+                candidates: await this.#collectCandidateSignals(),
+                actions: await this.#collectRecentActions(),
                 codeChanges: this.#collectCodeChangeSignals(),
             };
             // ── 离线 Fallback: 当 AI 不可用时，降级到 SkillAdvisor 规则引擎 ──
@@ -221,7 +223,7 @@ export class SignalCollector {
                 ?.isMock ?? true;
             if (!this.#agentFactory || isMock) {
                 this.#logger.info('[SignalCollector] AI unavailable, falling back to rule-based analysis');
-                return this.#ruleFallback();
+                return await this.#ruleFallback();
             }
             // 2. 构造分析 prompt
             const prompt = this.#buildAnalysisPrompt(signals);
@@ -330,10 +332,13 @@ export class SignalCollector {
      *
      * 零延迟、零 token 消耗 — 确保推荐系统始终有输出
      */
-    #ruleFallback() {
+    async #ruleFallback() {
         try {
-            const advisor = new SkillAdvisor(this.#projectRoot, { database: this.#db });
-            const result = advisor.suggest();
+            const advisor = new SkillAdvisor(this.#projectRoot, {
+                knowledgeRepo: this.#knowledgeRepo,
+                auditRepo: this.#auditRepo,
+            });
+            const result = await advisor.suggest();
             const newSuggestions = result.suggestions.filter((s) => !this.#snapshot.pushedNames.includes(s.name));
             // 更新快照
             this.#snapshot.lastRun = new Date().toISOString();
@@ -389,23 +394,12 @@ export class SignalCollector {
     // ═══════════════════════════════════════════════════════
     //  信号收集器（6 维度）
     // ═══════════════════════════════════════════════════════
-    #collectGuardSignals() {
+    async #collectGuardSignals() {
         try {
-            if (!this.#db) {
+            if (!this.#auditRepo) {
                 return [];
             }
-            // audit_logs 中 action='guard:check' + result='violation' 的记录
-            const rows = this.#db
-                .prepare(`SELECT json_extract(operation_data, '$.ruleName') as ruleName,
-                COUNT(*) as cnt,
-                MAX(timestamp) as last_at
-         FROM audit_logs
-         WHERE action LIKE 'guard%'
-           AND result = 'violation'
-         GROUP BY ruleName
-         HAVING cnt > 0
-         ORDER BY cnt DESC LIMIT 20`)
-                .all();
+            const rows = await this.#auditRepo.findGuardViolationSignals(20);
             return rows;
         }
         catch {
@@ -435,61 +429,40 @@ export class SignalCollector {
             return [];
         }
     }
-    #collectRecipeSignals() {
+    async #collectRecipeSignals() {
         try {
-            if (!this.#db) {
+            if (!this.#knowledgeRepo) {
                 return [];
             }
-            // V3: knowledge_entries 统一表，统计字段在 stats/quality JSON 中
-            const rows = this.#db
-                .prepare(`SELECT id, title, knowledgeType, category, language,
-                json_extract(stats, '$.adoptions') as adoption_count,
-                json_extract(stats, '$.applications') as application_count,
-                json_extract(quality, '$.overall') as quality_overall,
-                updatedAt
-         FROM knowledge_entries
-         WHERE lifecycle = 'active'
-         ORDER BY updatedAt DESC LIMIT 30`)
-                .all();
+            const rows = await this.#knowledgeRepo.findActiveRecipeSignals(30);
             return rows;
         }
         catch {
             return [];
         }
     }
-    #collectCandidateSignals() {
+    async #collectCandidateSignals() {
         try {
-            if (!this.#db) {
+            if (!this.#knowledgeRepo) {
                 return [];
             }
-            // V3: candidates 已合并到 knowledge_entries，lifecycle='pending' 即为候选
-            const rows = this.#db
-                .prepare(`SELECT id, source, lifecycle as status, language, category,
-                title, createdAt
-         FROM knowledge_entries WHERE lifecycle = 'pending'
-         ORDER BY createdAt DESC LIMIT 30`)
-                .all();
+            const rows = await this.#knowledgeRepo.findPendingCandidates(30);
             return rows;
         }
         catch {
             return [];
         }
     }
-    #collectRecentActions() {
+    async #collectRecentActions() {
         try {
-            if (!this.#db) {
+            if (!this.#auditRepo) {
                 return [];
             }
-            // audit_logs.timestamp 是 INTEGER (epoch seconds)
             const sinceStr = this.#snapshot.lastRun;
             const sinceTs = sinceStr
                 ? Math.floor(new Date(sinceStr).getTime() / 1000)
                 : Math.floor((Date.now() - 24 * 3600 * 1000) / 1000);
-            const rows = this.#db
-                .prepare(`SELECT actor, action, resource, result, timestamp
-         FROM audit_logs WHERE timestamp > ?
-         ORDER BY timestamp DESC LIMIT 50`)
-                .all(sinceTs);
+            const rows = await this.#auditRepo.findRecentActions(sinceTs, 50);
             return rows;
         }
         catch {

package/dist/lib/service/skills/SkillAdvisor.d.ts

@@ -14,6 +14,8 @@
  *   - 推荐结果包含 draft 草稿（name + description + rationale），
  *     Agent 可直接调用 create_skill 创建
  */
+import type { AuditRepositoryImpl } from '../../repository/audit/AuditRepository.js';
+import type { KnowledgeRepositoryImpl } from '../../repository/knowledge/KnowledgeRepository.impl.js';
 export interface SkillSuggestion {
     name: string;
     description: string;
@@ -23,20 +25,12 @@ export interface SkillSuggestion {
     signals: Record<string, unknown>;
 }
 interface SkillAdvisorOpts {
-    database?: {
-        prepare(sql: string): {
-            all(...args: unknown[]): Record<string, unknown>[];
-            get(...args: unknown[]): Record<string, unknown> | undefined;
-        };
-    } | null;
+    knowledgeRepo?: KnowledgeRepositoryImpl | null;
+    auditRepo?: AuditRepositoryImpl | null;
 }
 export declare class SkillAdvisor {
     #private;
-    /**
-     * @param projectRoot 用户项目根目录
-     * @param [opts.database] better-sqlite3 实例（可选）
-     */
-    constructor(projectRoot: string, { database }?: SkillAdvisorOpts);
+    constructor(projectRoot: string, { knowledgeRepo, auditRepo }?: SkillAdvisorOpts);
     /**
      * 生成 Skill 推荐列表
      *
@@ -52,11 +46,11 @@ export declare class SkillAdvisor {
      *   analysisContext: object
      * }}
      */
-    suggest(): {
+    suggest(): Promise<{
         suggestions: SkillSuggestion[];
         existingProjectSkills: unknown[];
         analysisContext: Record<string, unknown>;
         hint: string;
-    };
+    }>;
 }
 export default SkillAdvisor;

package/dist/lib/service/skills/SkillAdvisor.js

@@ -19,14 +19,12 @@ import path from 'node:path';
 import { getProjectSkillsPath } from '../../infrastructure/config/Paths.js';
 export class SkillAdvisor {
     #projectRoot;
-    #db;
-    /**
-     * @param projectRoot 用户项目根目录
-     * @param [opts.database] better-sqlite3 实例（可选）
-     */
-    constructor(projectRoot, { database } = {}) {
+    #knowledgeRepo;
+    #auditRepo;
+    constructor(projectRoot, { knowledgeRepo, auditRepo } = {}) {
         this.#projectRoot = projectRoot;
-        this.#db = database || null;
+        this.#knowledgeRepo = knowledgeRepo || null;
+        this.#auditRepo = auditRepo || null;
     }
     /**
      * 生成 Skill 推荐列表
@@ -43,13 +41,13 @@ export class SkillAdvisor {
      *   analysisContext: object
      * }}
      */
-    suggest() {
+    async suggest() {
         const existingSkills = this.#listExistingProjectSkills();
         const suggestions = [];
         const analysisContext = {};
         // ── 维度 1: Guard 违规模式 ──
         try {
-            const guardInsights = this.#analyzeGuardPatterns();
+            const guardInsights = await this.#analyzeGuardPatterns();
             analysisContext.guard = guardInsights.summary;
             suggestions.push(...guardInsights.suggestions.filter((s) => !existingSkills.has(s.name)));
         }
@@ -67,7 +65,7 @@ export class SkillAdvisor {
         }
         // ── 维度 3: Recipe 分布与使用 ──
         try {
-            const recipeInsights = this.#analyzeRecipePatterns();
+            const recipeInsights = await this.#analyzeRecipePatterns();
             analysisContext.recipes = recipeInsights.summary;
             suggestions.push(...recipeInsights.suggestions.filter((s) => !existingSkills.has(s.name)));
         }
@@ -76,7 +74,7 @@ export class SkillAdvisor {
         }
         // ── 维度 4: 候选积压 ──
         try {
-            const candidateInsights = this.#analyzeCandidatePatterns();
+            const candidateInsights = await this.#analyzeCandidatePatterns();
             analysisContext.candidates = candidateInsights.summary;
             suggestions.push(...candidateInsights.suggestions.filter((s) => !existingSkills.has(s.name)));
         }
@@ -99,26 +97,13 @@ export class SkillAdvisor {
     // ═══════════════════════════════════════════════════════
     //  维度 1: Guard 违规模式分析
     // ═══════════════════════════════════════════════════════
-    #analyzeGuardPatterns() {
+    async #analyzeGuardPatterns() {
         const suggestions = [];
-        if (!this.#db) {
-            return { summary: 'DB 不可用', suggestions };
+        if (!this.#auditRepo) {
+            return { summary: 'AuditRepo 不可用', suggestions };
         }
         try {
-            // 查询 Guard 违规记录（audit_logs 中 action LIKE 'guard%' + result='violation'）
-            const rows = this.#db
-                .prepare(`
-        SELECT json_extract(operation_data, '$.ruleName') as ruleName,
-               COUNT(*) as cnt
-        FROM audit_logs
-        WHERE action LIKE 'guard%'
-          AND result = 'violation'
-        GROUP BY ruleName
-        HAVING cnt >= 3
-        ORDER BY cnt DESC
-        LIMIT 5
-      `)
-                .all();
+            const rows = await this.#auditRepo.findTopGuardViolationRules(3, 5);
             if (rows.length > 0) {
                 const topRule = rows[0];
                 suggestions.push({
@@ -192,32 +177,16 @@ export class SkillAdvisor {
     // ═══════════════════════════════════════════════════════
     //  维度 3: Recipe 分布与使用热度
     // ═══════════════════════════════════════════════════════
-    #analyzeRecipePatterns() {
+    async #analyzeRecipePatterns() {
         const suggestions = [];
-        if (!this.#db) {
-            return { summary: 'DB 不可用', suggestions };
+        if (!this.#knowledgeRepo) {
+            return { summary: 'KnowledgeRepo 不可用', suggestions };
         }
         try {
             // 按 category 分布
-            const categories = this.#db
-                .prepare(`
-        SELECT category, COUNT(*) as cnt
-        FROM knowledge_entries
-        WHERE lifecycle = 'active' AND category IS NOT NULL AND category != ''
-        GROUP BY category
-        ORDER BY cnt DESC
-      `)
-                .all();
+            const categories = await this.#knowledgeRepo.countGroupByCategory();
             // 按 language 分布
-            const languages = this.#db
-                .prepare(`
-        SELECT language, COUNT(*) as cnt
-        FROM knowledge_entries
-        WHERE lifecycle = 'active' AND language IS NOT NULL AND language != ''
-        GROUP BY language
-        ORDER BY cnt DESC
-      `)
-                .all();
+            const languages = await this.#knowledgeRepo.countGroupByLanguage();
             // 高频使用但无自定义 Skill 的 category
             const topCategory = categories[0];
             if (topCategory && topCategory.cnt >= 10) {
@@ -235,20 +204,10 @@ export class SkillAdvisor {
                     },
                 });
             }
-            // 高使用量 Recipe 统计（V3: stats JSON 中的 adoptions + applications）
+            // 高使用量 Recipe 统计
             let hotRecipes = [];
             try {
-                hotRecipes = this.#db
-                    .prepare(`
-          SELECT title, category,
-                 (COALESCE(json_extract(stats, '$.adoptions'), 0) + COALESCE(json_extract(stats, '$.applications'), 0)) as total_usage
-          FROM knowledge_entries
-          WHERE lifecycle = 'active'
-            AND (COALESCE(json_extract(stats, '$.adoptions'), 0) + COALESCE(json_extract(stats, '$.applications'), 0)) >= 5
-          ORDER BY total_usage DESC
-          LIMIT 10
-        `)
-                    .all();
+                hotRecipes = await this.#knowledgeRepo.findHotRecipesByUsage(5, 10);
             }
             catch {
                 /* 查询失败时降级为空 */
@@ -265,31 +224,23 @@ export class SkillAdvisor {
     // ═══════════════════════════════════════════════════════
     //  维度 4: 候选积压分析
     // ═══════════════════════════════════════════════════════
-    #analyzeCandidatePatterns() {
+    async #analyzeCandidatePatterns() {
         const suggestions = [];
-        if (!this.#db) {
-            return { summary: 'DB 不可用', suggestions };
+        if (!this.#knowledgeRepo) {
+            return { summary: 'KnowledgeRepo 不可用', suggestions };
         }
         try {
-            // V3: candidates 已合并到 knowledge_entries，ifecycle='pending' 即为候选
-            const stats = this.#db
-                .prepare(`
-        SELECT
-          COUNT(*) as total,
-          SUM(CASE WHEN lifecycle='pending' THEN 1 ELSE 0 END) as pending,
-          SUM(CASE WHEN lifecycle='deprecated' THEN 1 ELSE 0 END) as rejected
-        FROM knowledge_entries
-      `)
-                .get();
+            const stats = await this.#knowledgeRepo.getLifecycleCounts();
+            const rejected = stats?.deprecated ?? 0;
             // 大量被拒绝 → 提示候选质量 Skill
-            if (stats && stats.rejected >= 10) {
+            if (rejected >= 10) {
                 suggestions.push({
                     name: 'project-candidate-quality',
-                    description: `候选提交质量指南 — ${stats.rejected} 条候选被拒，建议创建提交标准 Skill`,
-                    rationale: `已有 ${stats.rejected} 条候选被驳回（总计 ${stats.total} 条）。创建一个 Skill 明确项目的候选提交标准（哪些代码值得提取、必填字段要求、质量标杆），可以减少返工。`,
+                    description: `候选提交质量指南 — ${rejected} 条候选被拒，建议创建提交标准 Skill`,
+                    rationale: `已有 ${rejected} 条候选被驳回（总计 ${stats?.total ?? 0} 条）。创建一个 Skill 明确项目的候选提交标准（哪些代码值得提取、必填字段要求、质量标杆），可以减少返工。`,
                     source: 'candidate_rejection',
-                    priority: stats.rejected >= 20 ? 'high' : 'medium',
-                    signals: { total: stats.total, pending: stats.pending, rejected: stats.rejected },
+                    priority: rejected >= 20 ? 'high' : 'medium',
+                    signals: { total: stats?.total ?? 0, pending: stats?.pending ?? 0, rejected },
                 });
             }
             return {

package/dist/lib/service/vector/SyncCoordinator.d.ts

@@ -11,6 +11,7 @@
  *
  * @module service/vector/SyncCoordinator
  */
+import type { DrizzleDB } from '../../infrastructure/database/drizzle/index.js';
 import type { EventBus } from '../../infrastructure/event/EventBus.js';
 import type { VectorStore } from '../../infrastructure/vector/VectorStore.js';
 import type { ContextualEnricher } from './ContextualEnricher.js';
@@ -21,6 +22,7 @@ export interface SyncCoordinatorConfig {
     contextualEnricher: ContextualEnricher | null;
     debounceMs: number;
     maxBatchSize?: number;
+    drizzle?: DrizzleDB;
 }
 export declare class SyncCoordinator {
     #private;
@@ -37,7 +39,7 @@ export declare class SyncCoordinator {
      * @param db - 数据库连接 (better-sqlite3 style)
      * @returns 对账结果
      */
-    reconcile(db: {
+    reconcile(db?: {
         prepare(sql: string): {
             all(...args: unknown[]): Array<{
                 id: string;

package/dist/lib/service/vector/SyncCoordinator.js

@@ -11,7 +11,10 @@
  *
  * @module service/vector/SyncCoordinator
  */
+import { ne } from 'drizzle-orm';
+import { knowledgeEntries } from '../../infrastructure/database/drizzle/schema.js';
 import Logger from '../../infrastructure/logging/Logger.js';
+import { queryNonDeprecatedEntries } from '../../repository/search/SearchRepoAdapter.js';
 // ── Coordinator ──
 export class SyncCoordinator {
     #vectorStore;
@@ -19,6 +22,7 @@ export class SyncCoordinator {
     #contextualEnricher;
     #debounceMs;
     #maxBatchSize;
+    #drizzle;
     #pendingChanges = new Map();
     #debounceTimer = null;
     #processing = false;
@@ -31,6 +35,7 @@ export class SyncCoordinator {
         this.#contextualEnricher = config.contextualEnricher;
         this.#debounceMs = config.debounceMs;
         this.#maxBatchSize = config.maxBatchSize ?? 20;
+        this.#drizzle = config.drizzle ?? null;
     }
     /** 绑定 EventBus，开始监听知识变更事件 */
     bindEventBus(eventBus) {
@@ -76,9 +81,26 @@ export class SyncCoordinator {
             // 2. 获取 DB 中所有 active 知识条目 ID
             let dbEntries = [];
             try {
-                dbEntries = db
-                    .prepare(`SELECT id, title, content, kind FROM knowledge_entries WHERE lifecycle != 'deprecated'`)
-                    .all();
+                if (this.#drizzle) {
+                    // Drizzle 类型安全查询
+                    dbEntries = this.#drizzle
+                        .select({
+                        id: knowledgeEntries.id,
+                        title: knowledgeEntries.title,
+                        content: knowledgeEntries.content,
+                        kind: knowledgeEntries.kind,
+                    })
+                        .from(knowledgeEntries)
+                        .where(ne(knowledgeEntries.lifecycle, 'deprecated'))
+                        .all();
+                }
+                else if (db) {
+                    // 向后兼容: 测试时可传入 mock db
+                    dbEntries = queryNonDeprecatedEntries(db);
+                }
+                else {
+                    return result;
+                }
             }
             catch {
                 // 表可能不存在

package/dist/lib/service/vector/VectorService.d.ts

@@ -12,6 +12,7 @@
  *
  * @module service/vector/VectorService
  */
+import type { DrizzleDB } from '../../infrastructure/database/drizzle/index.js';
 import type { EventBus } from '../../infrastructure/event/EventBus.js';
 import type { IndexingPipeline } from '../../infrastructure/vector/IndexingPipeline.js';
 import type { VectorStore } from '../../infrastructure/vector/VectorStore.js';
@@ -29,6 +30,7 @@ export interface VectorServiceConfig {
     contextualEnricher: ContextualEnricher | null;
     autoSyncOnCrud: boolean;
     syncDebounceMs: number;
+    drizzle?: DrizzleDB;
 }
 export interface BuildResult {
     scanned: number;

package/dist/lib/service/vector/VectorService.js

@@ -24,6 +24,7 @@ export class VectorService {
     #syncCoordinator = null;
     #autoSyncOnCrud;
     #syncDebounceMs;
+    #drizzle;
     #logger = Logger.getInstance();
     #initialized = false;
     // ── Embed circuit breaker ──
@@ -40,6 +41,7 @@ export class VectorService {
         this.#contextualEnricher = config.contextualEnricher;
         this.#autoSyncOnCrud = config.autoSyncOnCrud;
         this.#syncDebounceMs = config.syncDebounceMs;
+        this.#drizzle = config.drizzle ?? null;
     }
     // ═══ Lifecycle ═══
     /** 初始化: 绑定 EventBus 事件监听 */
@@ -55,6 +57,7 @@ export class VectorService {
                 embedProvider: this.#embedProvider,
                 contextualEnricher: this.#contextualEnricher,
                 debounceMs: this.#syncDebounceMs,
+                drizzle: this.#drizzle ?? undefined,
             });
             this.#syncCoordinator.bindEventBus(this.#eventBus);
             this.#logger.info('[VectorService] SyncCoordinator bound to EventBus');

package/dist/lib/service/wiki/WikiGenerator.js

@@ -291,7 +291,7 @@ export class WikiGenerator {
     /** AST 分析 — 利用已有 ProjectGraph 或重新构建 */
     async _analyzeAST() {
         if (this.projectGraph) {
-            const overview = this.projectGraph.getOverview();
+            const overview = await this.projectGraph.getOverview();
             const allClasses = this.projectGraph.getAllClassNames();
             const allProtocols = this.projectGraph.getAllProtocolNames();
             // 按模块分组类名和协议名 (通过 filePath 推断所属模块)

package/dist/lib/shared/LanguageProfiles.d.ts

@@ -0,0 +1,109 @@
+/**
+ * LanguageProfiles — 全景分析多语言统一注册中心
+ *
+ * 设计原则:
+ *   1. **语言族 (LanguageFamily)** 是核心抽象 — 同族语言共享 import 语法、框架类体系、生态库
+ *   2. **单一数据源** — 新增语言只需添加一条 FamilyProfile，所有消费者自动生效
+ *   3. **与 LanguageService 互补** — LanguageService 管理基础映射 (ext→lang)，
+ *      LanguageProfiles 管理分析知识 (import 解析、角色推断、技术栈分类)
+ *   4. **按关注点暴露 API** — 消费者调用自己需要的访问器，无需了解内部数据结构
+ *
+ * 消费者:
+ *   - CouplingAnalyzer  → importPatterns, sourceExts
+ *   - RoleRefiner        → familyOf, superclassRoles, protocolRoles, importRolePatterns
+ *   - TechStackProfiler  → knownLibraries, keywordCategories
+ *   - ModuleDiscoverer   → skipDirs, artifactSuffixes, vendorDirs, sourceExts
+ *
+ * @module LanguageProfiles
+ */
+/** 模块在软件架构中扮演的角色 */
+export type ModuleRole = 'core' | 'service' | 'ui' | 'networking' | 'storage' | 'test' | 'app' | 'routing' | 'utility' | 'model' | 'auth' | 'config' | 'feature';
+export type LanguageFamily = 'apple' | 'jvm' | 'dart' | 'python' | 'web' | 'go' | 'rust' | 'dotnet';
+/** import 语句解析模式 — 用于依赖边提取 */
+export interface ImportPattern {
+    /** 匹配 import 语句的正则 (对 trimmed 行执行) */
+    regex: RegExp;
+    /** 从匹配结果提取模块名候选列表 */
+    extract: (m: RegExpExecArray) => string[];
+}
+/** import 关键词 → 角色推断模式 */
+export interface RolePattern {
+    regex: RegExp;
+    role: ModuleRole;
+}
+export declare class LanguageProfiles {
+    /** 将规范化语言 ID 映射到语言族 */
+    static familyOf(langId: string): LanguageFamily | undefined;
+    /** 返回所有已注册的语言族 ID */
+    static allFamilies(): LanguageFamily[];
+    /** 根据主语言解析项目涉及的语言族 */
+    static resolveFamilies(primaryLang: string | null): LanguageFamily[];
+    /**
+     * 获取所有 import 解析模式 (合并全部语言族 + C/C++)
+     *
+     * CouplingAnalyzer 对每行代码尝试所有模式，
+     * 按「特异性递减」排列：最特殊的模式在前。
+     */
+    static get importPatterns(): readonly ImportPattern[];
+    /**
+     * 源代码文件扩展名集合 — 委托 LanguageService
+     *
+     * 消除 CouplingAnalyzer / ModuleDiscoverer 自建 SOURCE_EXTS 的重复。
+     */
+    static get sourceExts(): ReadonlySet<string>;
+    /**
+     * 合并指定语言族的超类→角色映射
+     * @param families 项目检测到的语言族
+     */
+    static superclassRoles(families: LanguageFamily[]): Record<string, ModuleRole>;
+    /**
+     * 合并指定语言族的协议/接口→角色映射
+     * @param families 项目检测到的语言族
+     */
+    static protocolRoles(families: LanguageFamily[]): Record<string, ModuleRole>;
+    /**
+     * 合并指定语言族的 import→角色模式 + 通用模式
+     * @param families 项目检测到的语言族
+     */
+    static importRolePatterns(families: LanguageFamily[]): RolePattern[];
+    /**
+     * 获取全量已知库→分类映射 (合并所有族 + 跨平台库)
+     *
+     * TechStackProfiler 不按族过滤 — 外部依赖可能跨生态
+     */
+    static get knownLibraries(): Readonly<Record<string, string>>;
+    /** 关键词启发式分类 — KNOWN_LIBRARIES 未命中时的 fallback */
+    static get keywordCategories(): ReadonlyArray<[RegExp, string]>;
+    /**
+     * 应跳过的目录名集合 (合并 LanguageService.scanSkipDirs + 各族额外目录)
+     */
+    static get skipDirs(): ReadonlySet<string>;
+    /** 构建产物后缀 (合并全部族) */
+    static get artifactSuffixes(): readonly string[];
+    /** Vendor / 第三方目录名集合 (合并通用 + 各族) */
+    static get vendorDirs(): ReadonlySet<string>;
+    /**
+     * 三方库路径正则 — 匹配路径中的 vendor 目录名或已知库名
+     *
+     * 组成:
+     *   1. vendorDirs + 常见 skip 目录 (Pods, Carthage, DerivedData, …)
+     *   2. knownLibraries 中所有库名 (首字母大写形式)
+     *
+     * 用于 Agent 工具层对搜索结果做三方库过滤。
+     */
+    static get thirdPartyPathRegex(): RegExp;
+    /**
+     * 多语言基类/根类型排除集 — 合并所有族的 superclassRoles + protocolRoles + 额外基础类型。
+     *
+     * 用于 getHotNodes() 等入度统计，排除高入度但无信息量的语言根类型。
+     * 新增语言族时自动生效，无需手动维护排除列表。
+     */
+    static get baseClassExclusions(): ReadonlySet<string>;
+    /**
+     * 合法代码语言集合 — 合并 LanguageService.knownLangs + 常见别名。
+     *
+     * QualityScorer 格式评分使用，判断 recipe 的 language 字段是否合法。
+     * 新增语言时只需在 LanguageService 添加，此处自动生效。
+     */
+    static get validCodeLanguages(): ReadonlySet<string>;
+}