autosnippet 3.3.6 → 3.3.8

package/dist/lib/service/panorama/RoleRefiner.js

@@ -13,6 +13,7 @@
  *
  * @module RoleRefiner
  */
+import { LanguageProfiles } from '#shared/LanguageProfiles.js';
 /* ═══ Constants ═══════════════════════════════════════════ */
 const WEIGHTS = {
     ast: 0.3,
@@ -21,252 +22,109 @@ const WEIGHTS = {
     entityGraph: 0.1,
     regex: 0.15,
 };
-/** primary_lang / LanguageService 输出 → 语言族 */
-const LANG_TO_FAMILY = {
-    swift: 'apple',
-    objectivec: 'apple',
-    java: 'jvm',
-    kotlin: 'jvm',
-    dart: 'dart',
-    python: 'python',
-    typescript: 'web',
-    javascript: 'web',
-    tsx: 'web',
-    go: 'go',
-    rust: 'rust',
-};
-/* ─── 按语言族分区的超类映射 ─────────────────────────────── */
-const SUPERCLASS_BY_FAMILY = {
-    apple: {
-        UIViewController: 'ui',
-        UIView: 'ui',
-        UITableViewCell: 'ui',
-        UICollectionViewCell: 'ui',
-        UINavigationController: 'routing',
-        UITabBarController: 'routing',
-        UIApplication: 'app',
-        NSObject: 'core',
-        NSManagedObject: 'storage',
-    },
-    jvm: {
-        Activity: 'ui',
-        AppCompatActivity: 'ui',
-        Fragment: 'ui',
-        DialogFragment: 'ui',
-        View: 'ui',
-        RecyclerViewAdapter: 'ui',
-        Service: 'service',
-        IntentService: 'service',
-        BroadcastReceiver: 'service',
-        ContentProvider: 'storage',
-        ViewModel: 'ui',
-        AndroidViewModel: 'ui',
-        Application: 'app',
-    },
-    dart: {
-        StatefulWidget: 'ui',
-        StatelessWidget: 'ui',
-        State: 'ui',
-        ChangeNotifier: 'service',
-        Cubit: 'service',
-        Bloc: 'service',
-    },
-    python: {
-        BaseModel: 'model',
-        Model: 'model',
-        APIView: 'service',
-        ViewSet: 'service',
-        TestCase: 'test',
-    },
-    web: {
-        Component: 'ui',
-        Controller: 'service',
-        Module: 'app',
-    },
-    go: {},
-    rust: {},
-};
-/* ─── 按语言族分区的协议/接口映射 ────────────────────────── */
-const PROTOCOL_BY_FAMILY = {
-    apple: {
-        UITableViewDataSource: 'ui',
-        UITableViewDelegate: 'ui',
-        UICollectionViewDataSource: 'ui',
-        UIApplicationDelegate: 'app',
-        UISceneDelegate: 'app',
-        UIWindowSceneDelegate: 'app',
-        URLSessionDelegate: 'networking',
-        Codable: 'model',
-        Decodable: 'model',
-        Encodable: 'model',
-    },
-    jvm: {
-        Serializable: 'model',
-        Parcelable: 'model',
-        Runnable: 'core',
-        Callable: 'core',
-        OnClickListener: 'ui',
-        Adapter: 'ui',
-        Repository: 'storage',
-    },
-    dart: {
-        Widget: 'ui',
-    },
-    web: {
-        OnInit: 'ui',
-        OnDestroy: 'ui',
-        CanActivate: 'routing',
-        NestMiddleware: 'service',
-    },
-    go: {
-        Handler: 'service',
-        ReadWriter: 'core',
-        Reader: 'core',
-        Writer: 'core',
-        Stringer: 'utility',
-    },
-    rust: {
-        Display: 'utility',
-        Debug: 'utility',
-        Serialize: 'model',
-        Deserialize: 'model',
-        Future: 'core',
-        Stream: 'core',
-        Service: 'service',
-    },
-    python: {},
-};
-const IMPORT_PATTERNS_BY_FAMILY = {
-    apple: [
-        { regex: /alamofire|urlsession|afnetworking|moya/i, role: 'networking' },
-        { regex: /\buikit\b|swiftui|rx.*cocoa|snapkit|masonry/i, role: 'ui' },
-        { regex: /realm|coredata|fmdb|grdb/i, role: 'storage' },
-        { regex: /xctest/i, role: 'test' },
-    ],
-    jvm: [
-        { regex: /retrofit|okhttp|volley/i, role: 'networking' },
-        { regex: /android\.widget|jetpack.*compose|recyclerview/i, role: 'ui' },
-        { regex: /room|hibernate|greendao/i, role: 'storage' },
-        { regex: /junit|espresso|mockito/i, role: 'test' },
-    ],
-    dart: [
-        { regex: /\bdio\b|http_client/i, role: 'networking' },
-        { regex: /flutter|cupertino|material/i, role: 'ui' },
-        { regex: /sqflite|hive|objectbox/i, role: 'storage' },
-        { regex: /flutter_test/i, role: 'test' },
-    ],
-    python: [
-        { regex: /requests|aiohttp|httpx|urllib/i, role: 'networking' },
-        { regex: /tkinter|pyqt|kivy/i, role: 'ui' },
-        { regex: /sqlalchemy|django\.db|peewee|tortoise/i, role: 'storage' },
-        { regex: /pytest|unittest/i, role: 'test' },
-    ],
-    web: [
-        { regex: /axios|fetch|got|superagent/i, role: 'networking' },
-        { regex: /react|angular|vue|svelte|next|nuxt/i, role: 'ui' },
-        { regex: /typeorm|prisma|sequelize|mongoose|knex/i, role: 'storage' },
-        { regex: /jest|mocha|vitest|cypress|playwright/i, role: 'test' },
-        { regex: /express|fastify|nestjs|koa/i, role: 'routing' },
-    ],
-    go: [
-        { regex: /net\/http|resty/i, role: 'networking' },
-        { regex: /gin|echo|fiber|mux|chi/i, role: 'routing' },
-        { regex: /gorm|sqlx|ent/i, role: 'storage' },
-        { regex: /testing/i, role: 'test' },
-    ],
-    rust: [
-        { regex: /reqwest|hyper|surf/i, role: 'networking' },
-        { regex: /actix|axum|warp|rocket/i, role: 'routing' },
-        { regex: /diesel|sqlx|sea-orm/i, role: 'storage' },
-        { regex: /tokio-test/i, role: 'test' },
-    ],
+/**
+ * 配置文件层级名 → 模块角色映射
+ * 当配置文件声明了层级时（如 Boxfile 的 layer），
+ * 层级名是判断模块角色的强信号
+ */
+const CONFIG_LAYER_TO_ROLE = {
+    vendors: 'utility',
+    vendor: 'utility',
+    basics: 'core',
+    basic: 'core',
+    foundation: 'core',
+    core: 'core',
+    services: 'service',
+    service: 'service',
+    components: 'feature',
+    component: 'feature',
+    accessories: 'feature',
+    accessory: 'feature',
+    underlays: 'feature',
+    application: 'app',
+    app: 'app',
+    ui: 'ui',
+    networking: 'networking',
+    network: 'networking',
+    storage: 'storage',
+    model: 'model',
+    test: 'test',
+    tests: 'test',
 };
-/** 通用 import 模式（任何语言都适用） */
-const UNIVERSAL_IMPORT_PATTERNS = [
-    { regex: /network/i, role: 'networking' },
-    { regex: /sqlite/i, role: 'storage' },
-    { regex: /router|routing|navigation/i, role: 'routing' },
-];
 /* ═══ RoleRefiner Class ═══════════════════════════════════ */
 export class RoleRefiner {
-    #db;
+    #bootstrapRepo;
+    #entityRepo;
+    #edgeRepo;
     #projectRoot;
     #families = null;
     #superclassMap = null;
     #protocolMap = null;
     #importPatterns = null;
-    constructor(db, projectRoot) {
-        this.#db = db;
+    constructor(bootstrapRepo, entityRepo, edgeRepo, projectRoot) {
+        this.#bootstrapRepo = bootstrapRepo;
+        this.#entityRepo = entityRepo;
+        this.#edgeRepo = edgeRepo;
         this.#projectRoot = projectRoot;
     }
     /** 检测项目语言族，基于 bootstrap_snapshots.primary_lang */
-    #detectFamilies() {
+    async #detectFamilies() {
         if (this.#families) {
             return this.#families;
         }
-        const row = this.#db
-            .prepare(`SELECT primary_lang FROM bootstrap_snapshots
-         WHERE project_root = ? ORDER BY created_at DESC LIMIT 1`)
-            .get(this.#projectRoot);
-        const primaryLang = row?.primary_lang;
-        if (primaryLang && LANG_TO_FAMILY[primaryLang]) {
-            this.#families = [LANG_TO_FAMILY[primaryLang]];
-        }
-        else {
-            // 无 bootstrap 数据时回退：使用所有语言族
-            this.#families = Object.keys(SUPERCLASS_BY_FAMILY);
-        }
+        const primaryLang = await this.#bootstrapRepo.getLatestPrimaryLang(this.#projectRoot);
+        this.#families = LanguageProfiles.resolveFamilies(primaryLang);
         return this.#families;
     }
     /** 构建当前项目语言族的超类合并映射 */
-    #getSuperclassMap() {
+    async #getSuperclassMap() {
         if (this.#superclassMap) {
             return this.#superclassMap;
         }
-        const merged = {};
-        for (const fam of this.#detectFamilies()) {
-            Object.assign(merged, SUPERCLASS_BY_FAMILY[fam]);
-        }
-        this.#superclassMap = merged;
-        return merged;
+        this.#superclassMap = LanguageProfiles.superclassRoles(await this.#detectFamilies());
+        return this.#superclassMap;
     }
     /** 构建当前项目语言族的协议合并映射 */
-    #getProtocolMap() {
+    async #getProtocolMap() {
         if (this.#protocolMap) {
             return this.#protocolMap;
         }
-        const merged = {};
-        for (const fam of this.#detectFamilies()) {
-            Object.assign(merged, PROTOCOL_BY_FAMILY[fam]);
-        }
-        this.#protocolMap = merged;
-        return merged;
+        this.#protocolMap = LanguageProfiles.protocolRoles(await this.#detectFamilies());
+        return this.#protocolMap;
     }
     /** 构建当前项目语言族的 import 模式列表 */
-    #getImportPatterns() {
+    async #getImportPatterns() {
         if (this.#importPatterns) {
             return this.#importPatterns;
         }
-        const patterns = [...UNIVERSAL_IMPORT_PATTERNS];
-        for (const fam of this.#detectFamilies()) {
-            patterns.push(...IMPORT_PATTERNS_BY_FAMILY[fam]);
-        }
-        this.#importPatterns = patterns;
-        return patterns;
+        this.#importPatterns = LanguageProfiles.importRolePatterns(await this.#detectFamilies());
+        return this.#importPatterns;
     }
     /**
      * 精化单个模块的角色
      */
-    refineRole(module) {
+    async refineRole(module) {
         const signals = [];
         // 1. AST 结构信号 (0.30)
-        signals.push(...this.#extractAstSignals(module));
+        signals.push(...(await this.#extractAstSignals(module)));
         // 2. CallGraph 行为信号 (0.30)
-        signals.push(...this.#extractCallSignals(module));
+        signals.push(...(await this.#extractCallSignals(module)));
         // 3. DataFlow 数据流信号 (0.15)
-        signals.push(...this.#extractFlowSignals(module));
+        signals.push(...(await this.#extractFlowSignals(module)));
         // 4. EntityGraph 拓扑信号 (0.10)
-        signals.push(...this.#extractTopoSignals(module));
+        signals.push(...(await this.#extractTopoSignals(module)));
+        // 4.5. 配置层级信号 — 来自 Boxfile/Tuist 等配置文件的 layer 声明
+        if (module.configLayer) {
+            const layerRole = CONFIG_LAYER_TO_ROLE[module.configLayer.toLowerCase()];
+            if (layerRole) {
+                signals.push({
+                    role: layerRole,
+                    confidence: 0.85,
+                    weight: WEIGHTS.ast, // 与 AST 等权重级别 (0.30)
+                    source: 'config-layer',
+                });
+            }
+        }
         // 5. 正则基线 (0.15)
         signals.push({
             role: module.inferredRole,
@@ -318,31 +176,26 @@ export class RoleRefiner {
     /**
      * 批量精化所有模块
      */
-    refineAll(modules) {
+    async refineAll(modules) {
         const result = new Map();
         for (const m of modules) {
-            result.set(m.name, this.refineRole(m));
+            result.set(m.name, await this.refineRole(m));
         }
         return result;
     }
     /* ─── Signal Extractors ──────────────────────────── */
     /** AST 结构信号: 继承链、协议、import */
-    #extractAstSignals(module) {
+    async #extractAstSignals(module) {
         const signals = [];
         const filePaths = module.files;
         if (filePaths.length === 0) {
             return signals;
         }
         // 查询模块内实体的继承关系
-        const placeholders = filePaths.map(() => '?').join(',');
-        const entities = this.#db
-            .prepare(`SELECT entity_id, entity_type, superclass, protocols, file_path
-         FROM code_entities
-         WHERE project_root = ? AND file_path IN (${placeholders})`)
-            .all(this.#projectRoot, ...filePaths);
+        const entities = await this.#entityRepo.findByProjectAndFilePaths(this.#projectRoot, filePaths);
         const roleCounts = {};
-        const superclassMap = this.#getSuperclassMap();
-        const protocolMap = this.#getProtocolMap();
+        const superclassMap = await this.#getSuperclassMap();
+        const protocolMap = await this.#getProtocolMap();
         for (const entity of entities) {
             // 继承链推断
             const superclass = entity.superclass;
@@ -351,27 +204,19 @@ export class RoleRefiner {
                 roleCounts[role] = (roleCounts[role] ?? 0) + 1;
             }
             // 协议推断
-            try {
-                const protocols = JSON.parse(entity.protocols || '[]');
-                for (const proto of protocols) {
-                    if (protocolMap[proto]) {
-                        const role = protocolMap[proto];
-                        roleCounts[role] = (roleCounts[role] ?? 0) + 0.5;
-                    }
+            const protocols = entity.protocols ?? [];
+            for (const proto of protocols) {
+                if (protocolMap[proto]) {
+                    const role = protocolMap[proto];
+                    roleCounts[role] = (roleCounts[role] ?? 0) + 0.5;
                 }
             }
-            catch {
-                // ignore malformed JSON
-            }
         }
         // import 模式推断
-        const imports = this.#db
-            .prepare(`SELECT DISTINCT to_id FROM knowledge_edges
-         WHERE from_type = 'module' AND from_id = ? AND relation = 'depends_on'`)
-            .all(module.name);
+        const imports = await this.#edgeRepo.findOutgoingByRelation(module.name, 'depends_on');
         for (const imp of imports) {
-            const depName = imp.to_id.toLowerCase();
-            for (const pat of this.#getImportPatterns()) {
+            const depName = imp.toId.toLowerCase();
+            for (const pat of await this.#getImportPatterns()) {
                 if (pat.regex.test(depName)) {
                     roleCounts[pat.role] = (roleCounts[pat.role] ?? 0) + 0.5;
                 }
@@ -392,30 +237,16 @@ export class RoleRefiner {
         return signals;
     }
     /** CallGraph 行为信号: 调用流向分析 */
-    #extractCallSignals(module) {
+    async #extractCallSignals(module) {
         const signals = [];
-        // 查模块实体的 call edge 统计
         const filePaths = module.files;
         if (filePaths.length === 0) {
             return signals;
         }
-        const placeholders = filePaths.map(() => '?').join(',');
         // fan-out: 模块内实体调用外部
-        const outEdges = this.#db
-            .prepare(`SELECT COUNT(*) as cnt FROM knowledge_edges ke
-         JOIN code_entities ce ON ke.from_id = ce.entity_id AND ke.from_type = ce.entity_type
-         WHERE ce.project_root = ? AND ce.file_path IN (${placeholders})
-         AND ke.relation = 'calls'`)
-            .get(this.#projectRoot, ...filePaths);
+        const fanOut = await this.#edgeRepo.countEdgesJoinedByEntityFiles(this.#projectRoot, filePaths, 'calls', 'from');
         // fan-in: 外部调用模块内实体
-        const inEdges = this.#db
-            .prepare(`SELECT COUNT(*) as cnt FROM knowledge_edges ke
-         JOIN code_entities ce ON ke.to_id = ce.entity_id AND ke.to_type = ce.entity_type
-         WHERE ce.project_root = ? AND ce.file_path IN (${placeholders})
-         AND ke.relation = 'calls'`)
-            .get(this.#projectRoot, ...filePaths);
-        const fanOut = Number(outEdges?.cnt ?? 0);
-        const fanIn = Number(inEdges?.cnt ?? 0);
+        const fanIn = await this.#edgeRepo.countEdgesJoinedByEntityFiles(this.#projectRoot, filePaths, 'calls', 'to');
         if (fanIn + fanOut === 0) {
             return signals;
         }
@@ -449,29 +280,16 @@ export class RoleRefiner {
         return signals;
     }
     /** DataFlow 数据流信号: 源/汇分析 */
-    #extractFlowSignals(module) {
+    async #extractFlowSignals(module) {
         const signals = [];
         const filePaths = module.files;
         if (filePaths.length === 0) {
             return signals;
         }
-        const placeholders = filePaths.map(() => '?').join(',');
         // data_flow out (data producer)
-        const outFlow = this.#db
-            .prepare(`SELECT COUNT(*) as cnt FROM knowledge_edges ke
-         JOIN code_entities ce ON ke.from_id = ce.entity_id AND ke.from_type = ce.entity_type
-         WHERE ce.project_root = ? AND ce.file_path IN (${placeholders})
-         AND ke.relation = 'data_flow'`)
-            .get(this.#projectRoot, ...filePaths);
+        const out = await this.#edgeRepo.countEdgesJoinedByEntityFiles(this.#projectRoot, filePaths, 'data_flow', 'from');
         // data_flow in (data consumer)
-        const inFlow = this.#db
-            .prepare(`SELECT COUNT(*) as cnt FROM knowledge_edges ke
-         JOIN code_entities ce ON ke.to_id = ce.entity_id AND ke.to_type = ce.entity_type
-         WHERE ce.project_root = ? AND ce.file_path IN (${placeholders})
-         AND ke.relation = 'data_flow'`)
-            .get(this.#projectRoot, ...filePaths);
-        const out = Number(outFlow?.cnt ?? 0);
-        const _in = Number(inFlow?.cnt ?? 0);
+        const _in = await this.#edgeRepo.countEdgesJoinedByEntityFiles(this.#projectRoot, filePaths, 'data_flow', 'to');
         if (out + _in === 0) {
             return signals;
         }
@@ -496,24 +314,16 @@ export class RoleRefiner {
         return signals;
     }
     /** EntityGraph 拓扑信号: 入度分析/模式检测 */
-    #extractTopoSignals(module) {
+    async #extractTopoSignals(module) {
         const signals = [];
         // 查模块下是否有 singleton / delegate 等设计模式
-        const patterns = this.#db
-            .prepare(`SELECT ke.to_id as pattern_name FROM knowledge_edges ke
-         JOIN code_entities ce ON ke.from_id = ce.entity_id
-         WHERE ce.project_root = ? AND ke.relation = 'uses_pattern'
-         AND ce.entity_id IN (
-           SELECT entity_id FROM code_entities
-           WHERE project_root = ? AND file_path IN (${module.files.map(() => '?').join(',')})
-         )`)
-            .all(this.#projectRoot, this.#projectRoot, ...module.files);
-        for (const p of patterns) {
-            const name = p.pattern_name?.toLowerCase();
-            if (!name) {
+        const patterns = await this.#edgeRepo.findPatternsUsedByEntities(this.#projectRoot, module.files);
+        for (const name of patterns) {
+            const lowerName = name?.toLowerCase();
+            if (!lowerName) {
                 continue;
             }
-            if (name === 'singleton') {
+            if (lowerName === 'singleton') {
                 signals.push({
                     role: 'service',
                     confidence: 0.6,
@@ -521,7 +331,7 @@ export class RoleRefiner {
                     source: 'pattern-singleton',
                 });
             }
-            if (name === 'delegate') {
+            if (lowerName === 'delegate') {
                 signals.push({
                     role: 'ui',
                     confidence: 0.4,

package/dist/lib/service/panorama/TechStackProfiler.d.ts

@@ -0,0 +1,13 @@
+/**
+ * TechStackProfiler — 技术栈画像聚合
+ *
+ * 根据外部依赖名称自动分类，生成项目技术栈画像。
+ * 使用已知库名映射表 + 关键词启发式进行分类。
+ *
+ * @module TechStackProfiler
+ */
+import type { ExternalDepProfile, TechStackProfile } from './PanoramaTypes.js';
+/**
+ * 对外部依赖进行分类，生成技术栈画像
+ */
+export declare function profileTechStack(externalDeps: ExternalDepProfile[]): TechStackProfile;

package/dist/lib/service/panorama/TechStackProfiler.js

@@ -0,0 +1,79 @@
+/**
+ * TechStackProfiler — 技术栈画像聚合
+ *
+ * 根据外部依赖名称自动分类，生成项目技术栈画像。
+ * 使用已知库名映射表 + 关键词启发式进行分类。
+ *
+ * @module TechStackProfiler
+ */
+import { LanguageProfiles } from '#shared/LanguageProfiles.js';
+/* ═══ TechStackProfiler ═══════════════════════════════════ */
+/** Fan-in 阈值：高于此值视为关键依赖热点 */
+const HOTSPOT_THRESHOLD = 3;
+/**
+ * 对外部依赖进行分类，生成技术栈画像
+ */
+export function profileTechStack(externalDeps) {
+    if (externalDeps.length === 0) {
+        return { categories: [], hotspots: [], totalExternalDeps: 0 };
+    }
+    // 1. 分类每个外部依赖
+    const categoryMap = new Map();
+    for (const dep of externalDeps) {
+        const category = classifyDependency(dep.name);
+        dep.category = category;
+        if (!categoryMap.has(category)) {
+            categoryMap.set(category, []);
+        }
+        categoryMap.get(category).push({
+            name: dep.name,
+            fanIn: dep.fanIn,
+            version: dep.version,
+        });
+    }
+    // 2. 按分类排序（每个分类内按 fan-in 降序，分类间按依赖数降序）
+    const categories = [...categoryMap.entries()]
+        .map(([name, deps]) => ({
+        name,
+        deps: deps.sort((a, b) => b.fanIn - a.fanIn),
+    }))
+        .sort((a, b) => b.deps.length - a.deps.length);
+    // 3. 提取热点（fan-in ≥ 阈值）
+    const hotspots = externalDeps
+        .filter((d) => d.fanIn >= HOTSPOT_THRESHOLD)
+        .map((d) => ({ name: d.name, fanIn: d.fanIn, dependedBy: d.dependedBy }))
+        .sort((a, b) => b.fanIn - a.fanIn);
+    return {
+        categories,
+        hotspots,
+        totalExternalDeps: externalDeps.length,
+    };
+}
+/**
+ * 分类单个外部依赖
+ */
+function classifyDependency(name) {
+    const knownLibraries = LanguageProfiles.knownLibraries;
+    // 标准化名称：移除前缀、转小写
+    const normalized = name
+        .replace(/^(BDMV|BDP|FMT|BD|MTL|Bai|Ali|TX|TT)/, '')
+        .toLowerCase()
+        .replace(/[-_]/g, '');
+    // 1. 精确匹配已知库
+    if (knownLibraries[normalized]) {
+        return knownLibraries[normalized];
+    }
+    // 尝试原始名称小写
+    const rawLower = name.toLowerCase().replace(/[-_]/g, '');
+    if (knownLibraries[rawLower]) {
+        return knownLibraries[rawLower];
+    }
+    // 2. 关键词启发式
+    for (const [pattern, category] of LanguageProfiles.keywordCategories) {
+        if (pattern.test(name)) {
+            return category;
+        }
+    }
+    // 3. 默认分类
+    return 'Other';
+}