autosnippet 3.3.6 → 3.3.8

package/dist/lib/core/discovery/DiscovererPreference.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @module DiscovererPreference
+ * @description Discoverer 用户偏好持久化 + 冲突检测
+ *
+ * 当多个 Discoverer 匹配且置信度接近时，允许用户确认选择并持久化。
+ * CLI 上下文使用 readline 交互，MCP/HTTP 上下文返回 ambiguous 标记。
+ */
+export interface DiscovererPreferenceData {
+    selectedDiscoverer: string;
+    selectedAt: string;
+    alternatives: string[];
+    userConfirmed: boolean;
+}
+export interface DetectMatch {
+    discovererId: string;
+    displayName: string;
+    confidence: number;
+}
+export interface ConflictResult {
+    ambiguous: boolean;
+    reason?: string;
+    matches: DetectMatch[];
+    recommended?: DetectMatch;
+}
+/**
+ * 检测 Discoverer 匹配结果是否存在冲突/模糊
+ */
+export declare function detectConflict(matches: DetectMatch[]): ConflictResult;
+/**
+ * 加载已保存的 Discoverer 偏好
+ * @returns 偏好数据，或 null（无偏好/文件不存在/损坏）
+ */
+export declare function loadPreference(projectRoot: string): DiscovererPreferenceData | null;
+/**
+ * 保存 Discoverer 偏好
+ */
+export declare function savePreference(projectRoot: string, discovererId: string, alternatives: string[], userConfirmed: boolean): void;
+/**
+ * CLI 交互式确认 Discoverer 选择
+ * 仅在 CLI 终端上下文（stdin 可用）时有效
+ *
+ * @returns 用户选择的 Discoverer ID，或 null（非交互环境/超时）
+ */
+export declare function promptDiscovererChoice(matches: DetectMatch[], recommended?: DetectMatch): Promise<string | null>;

package/dist/lib/core/discovery/DiscovererPreference.js

@@ -0,0 +1,141 @@
+/**
+ * @module DiscovererPreference
+ * @description Discoverer 用户偏好持久化 + 冲突检测
+ *
+ * 当多个 Discoverer 匹配且置信度接近时，允许用户确认选择并持久化。
+ * CLI 上下文使用 readline 交互，MCP/HTTP 上下文返回 ambiguous 标记。
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+// ── Constants ───────────────────────────────────────
+const PREFERENCE_DIR = '.autosnippet';
+const PREFERENCE_FILE = 'discoverer-preference.json';
+/** 两个 Discoverer confidence 差值低于此阈值视为模糊 */
+const AMBIGUITY_THRESHOLD = 0.1;
+/** 最高 confidence 低于此值视为启发式不确定 */
+const HEURISTIC_UNCERTAIN_THRESHOLD = 0.6;
+// ── Conflict Detection ──────────────────────────────
+/**
+ * 检测 Discoverer 匹配结果是否存在冲突/模糊
+ */
+export function detectConflict(matches) {
+    if (matches.length === 0) {
+        return { ambiguous: false, matches };
+    }
+    if (matches.length === 1) {
+        return { ambiguous: false, matches, recommended: matches[0] };
+    }
+    const top = matches[0];
+    const second = matches[1];
+    // 条件 1: 多个高置信度结果 (≥ 0.60)
+    const highConfCount = matches.filter((m) => m.confidence >= 0.6).length;
+    // 条件 2: top-1 与 top-2 差距 < 阈值
+    const closeDelta = top.confidence - second.confidence < AMBIGUITY_THRESHOLD;
+    // 条件 3: 最高分仍低于阈值（仅启发式命中）
+    const heuristicOnly = top.confidence < HEURISTIC_UNCERTAIN_THRESHOLD;
+    if (highConfCount >= 2 && closeDelta) {
+        return {
+            ambiguous: true,
+            reason: `Multiple build systems detected with similar confidence (${top.displayName}: ${top.confidence.toFixed(2)} vs ${second.displayName}: ${second.confidence.toFixed(2)})`,
+            matches,
+            recommended: top,
+        };
+    }
+    if (heuristicOnly) {
+        return {
+            ambiguous: true,
+            reason: `No definitive build system identified (highest: ${top.displayName} at ${top.confidence.toFixed(2)})`,
+            matches,
+            recommended: top,
+        };
+    }
+    return { ambiguous: false, matches, recommended: top };
+}
+// ── Preference Persistence ──────────────────────────
+/**
+ * 获取偏好文件路径
+ */
+function getPreferencePath(projectRoot) {
+    return join(projectRoot, PREFERENCE_DIR, PREFERENCE_FILE);
+}
+/**
+ * 加载已保存的 Discoverer 偏好
+ * @returns 偏好数据，或 null（无偏好/文件不存在/损坏）
+ */
+export function loadPreference(projectRoot) {
+    const prefPath = getPreferencePath(projectRoot);
+    if (!existsSync(prefPath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(prefPath, 'utf8');
+        const data = JSON.parse(content);
+        // 基本结构校验
+        if (typeof data.selectedDiscoverer !== 'string' || typeof data.userConfirmed !== 'boolean') {
+            return null;
+        }
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 保存 Discoverer 偏好
+ */
+export function savePreference(projectRoot, discovererId, alternatives, userConfirmed) {
+    const prefPath = getPreferencePath(projectRoot);
+    const prefDir = join(projectRoot, PREFERENCE_DIR);
+    if (!existsSync(prefDir)) {
+        mkdirSync(prefDir, { recursive: true });
+    }
+    const data = {
+        selectedDiscoverer: discovererId,
+        selectedAt: new Date().toISOString(),
+        alternatives,
+        userConfirmed,
+    };
+    writeFileSync(prefPath, JSON.stringify(data, null, 2), 'utf8');
+}
+// ── CLI Interactive Prompt ──────────────────────────
+/**
+ * CLI 交互式确认 Discoverer 选择
+ * 仅在 CLI 终端上下文（stdin 可用）时有效
+ *
+ * @returns 用户选择的 Discoverer ID，或 null（非交互环境/超时）
+ */
+export async function promptDiscovererChoice(matches, recommended) {
+    // 检测是否在可交互终端
+    if (!process.stdin.isTTY) {
+        return null;
+    }
+    const { createInterface } = await import('node:readline');
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const question = (prompt) => new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            resolve(answer.trim());
+        });
+    });
+    try {
+        console.log('\n⚠️  项目构建系统识别需要确认\n');
+        console.log('检测到以下构建系统配置：');
+        for (let i = 0; i < matches.length; i++) {
+            const m = matches[i];
+            const rec = recommended && m.discovererId === recommended.discovererId ? '  ← 推荐' : '';
+            console.log(`  [${i + 1}] ${m.displayName}  confidence: ${m.confidence.toFixed(2)}${rec}`);
+        }
+        const defaultIdx = recommended
+            ? matches.findIndex((m) => m.discovererId === recommended.discovererId) + 1
+            : 1;
+        const answer = await question(`\n请选择主要构建系统 [1-${matches.length}]，或按回车使用推荐 (${defaultIdx}): `);
+        const choice = answer === '' ? defaultIdx : Number.parseInt(answer, 10);
+        if (choice >= 1 && choice <= matches.length) {
+            return matches[choice - 1].discovererId;
+        }
+        // 无效输入, 使用推荐
+        return recommended?.discovererId ?? matches[0].discovererId;
+    }
+    finally {
+        rl.close();
+    }
+}

package/dist/lib/core/discovery/DiscovererRegistry.d.ts

@@ -4,7 +4,10 @@
  *
  * 检测顺序：按 confidence 降序。多个匹配时取最高 confidence。
  * 若全部未命中，回退到 GenericDiscoverer（目录扫描兜底）。
+ *
+ * 支持用户偏好持久化: 当匹配模糊时，保存/加载用户选择。
  */
+import type { ConflictResult } from './DiscovererPreference.js';
 import type { ProjectDiscoverer } from './ProjectDiscoverer.js';
 export declare class DiscovererRegistry {
     #private;
@@ -17,12 +20,18 @@ export declare class DiscovererRegistry {
     detect(projectRoot: string): Promise<ProjectDiscoverer>;
     /**
      * 检测所有匹配的 Discoverer（用于混合项目）
-     * @returns >>}
+     * 若存在用户偏好，将偏好 Discoverer 提升到首位。
+     * @returns 按 confidence 降序排列的匹配结果（偏好优先）
      */
     detectAll(projectRoot: string): Promise<{
         discoverer: ProjectDiscoverer;
         confidence: number;
     }[]>;
+    /**
+     * 分析检测结果的冲突/模糊性
+     * @returns 冲突分析结果，含 ambiguous 标记和推荐
+     */
+    analyzeConflict(projectRoot: string): Promise<ConflictResult>;
     /** 获取所有已注册的 Discoverer */
     getAll(): ProjectDiscoverer[];
 }

package/dist/lib/core/discovery/DiscovererRegistry.js

@@ -4,7 +4,10 @@
  *
  * 检测顺序：按 confidence 降序。多个匹配时取最高 confidence。
  * 若全部未命中，回退到 GenericDiscoverer（目录扫描兜底）。
+ *
+ * 支持用户偏好持久化: 当匹配模糊时，保存/加载用户选择。
  */
+import { detectConflict, loadPreference } from './DiscovererPreference.js';
 export class DiscovererRegistry {
     #discoverers = [];
     /**
@@ -38,7 +41,8 @@ export class DiscovererRegistry {
     }
     /**
      * 检测所有匹配的 Discoverer（用于混合项目）
-     * @returns >>}
+     * 若存在用户偏好，将偏好 Discoverer 提升到首位。
+     * @returns 按 confidence 降序排列的匹配结果（偏好优先）
      */
     async detectAll(projectRoot) {
         const results = await Promise.all(this.#discoverers.map(async (d) => ({
@@ -47,10 +51,46 @@ export class DiscovererRegistry {
                 .detect(projectRoot)
                 .catch(() => ({ match: false, confidence: 0, reason: 'detect error' })),
         })));
-        return results
+        const matched = results
             .filter((r) => r.result.match)
             .sort((a, b) => b.result.confidence - a.result.confidence)
             .map((r) => ({ discoverer: r.discoverer, confidence: r.result.confidence }));
+        // 如果有用户持久化偏好，将偏好 Discoverer 提升到首位
+        const preference = loadPreference(projectRoot);
+        if (preference?.userConfirmed) {
+            const prefIdx = matched.findIndex((m) => m.discoverer.id === preference.selectedDiscoverer);
+            if (prefIdx > 0) {
+                const [preferred] = matched.splice(prefIdx, 1);
+                matched.unshift(preferred);
+            }
+        }
+        return matched;
+    }
+    /**
+     * 分析检测结果的冲突/模糊性
+     * @returns 冲突分析结果，含 ambiguous 标记和推荐
+     */
+    async analyzeConflict(projectRoot) {
+        const results = await Promise.all(this.#discoverers.map(async (d) => ({
+            discoverer: d,
+            result: await d
+                .detect(projectRoot)
+                .catch(() => ({ match: false, confidence: 0, reason: 'detect error' })),
+        })));
+        const matches = results
+            .filter((r) => r.result.match)
+            .sort((a, b) => b.result.confidence - a.result.confidence)
+            .map((r) => ({
+            discovererId: r.discoverer.id,
+            displayName: r.discoverer.displayName,
+            confidence: r.result.confidence,
+        }));
+        // 如果有用户偏好，直接信任
+        const preference = loadPreference(projectRoot);
+        if (preference?.userConfirmed) {
+            return { ambiguous: false, matches, recommended: matches[0] };
+        }
+        return detectConflict(matches);
     }
     /** 获取所有已注册的 Discoverer */
     getAll() {

package/dist/lib/core/discovery/ProjectDiscoverer.d.ts

@@ -25,6 +25,17 @@ export interface DependencyEdge {
     from: string;
     to: string;
     type: string;
+    /** 依赖作用域 (如 CMake PUBLIC/PRIVATE, Gradle implementation/api) */
+    scope?: string;
+    /** 构建配置 (如 Gradle configuration) */
+    configuration?: string;
+    /** 跨语言桥接类型 (如 flutter-engine / native-module / cinterop) */
+    bridgeType?: string;
+}
+export interface DependencyGraphLayer {
+    name: string;
+    order: number;
+    accessibleLayers: string[];
 }
 export interface DependencyGraph {
     nodes: (string | {
@@ -33,9 +44,17 @@ export interface DependencyGraph {
         type?: string;
         fullPath?: string;
         indirect?: boolean;
+        /** 标签 (如 Nx tags, Bazel visibility) */
+        tags?: string[];
+        /** 可见性 (如 Bazel //visibility:public) */
+        visibility?: string[];
+        /** Convention 角色 (如 Gradle convention plugin 推断的角色) */
+        conventionRole?: string;
         [key: string]: unknown;
     })[];
     edges: DependencyEdge[];
+    /** 层级元数据（来自自研构建系统的分层声明） */
+    layers?: DependencyGraphLayer[];
 }
 export declare class ProjectDiscoverer {
     /** 检测此 Discoverer 是否适用于给定项目 */

package/dist/lib/core/discovery/index.d.ts

@@ -7,7 +7,9 @@ import { DiscovererRegistry } from './DiscovererRegistry.js';
 export declare function getDiscovererRegistry(): DiscovererRegistry;
 /** 重置 Registry（仅用于测试） */
 export declare function resetDiscovererRegistry(): void;
+export { CustomConfigDiscoverer } from './CustomConfigDiscoverer.js';
 export { DartDiscoverer } from './DartDiscoverer.js';
+export { type ConflictResult, type DetectMatch, type DiscovererPreferenceData, detectConflict, loadPreference, promptDiscovererChoice, savePreference, } from './DiscovererPreference.js';
 export { DiscovererRegistry } from './DiscovererRegistry.js';
 export { GenericDiscoverer } from './GenericDiscoverer.js';
 export { GoDiscoverer } from './GoDiscoverer.js';

package/dist/lib/core/discovery/index.js

@@ -2,6 +2,7 @@
  * @module discovery/index
  * @description ProjectDiscoverer 系统入口 - 初始化 Registry 并注册所有 Discoverer
  */
+import { CustomConfigDiscoverer } from './CustomConfigDiscoverer.js';
 import { DartDiscoverer } from './DartDiscoverer.js';
 import { DiscovererRegistry } from './DiscovererRegistry.js';
 import { GenericDiscoverer } from './GenericDiscoverer.js';
@@ -24,6 +25,7 @@ export function getDiscovererRegistry() {
             .register(new GoDiscoverer())
             .register(new DartDiscoverer())
             .register(new RustDiscoverer())
+            .register(new CustomConfigDiscoverer())
             .register(new GenericDiscoverer());
     }
     return _registry;
@@ -32,7 +34,9 @@ export function getDiscovererRegistry() {
 export function resetDiscovererRegistry() {
     _registry = null;
 }
+export { CustomConfigDiscoverer } from './CustomConfigDiscoverer.js';
 export { DartDiscoverer } from './DartDiscoverer.js';
+export { detectConflict, loadPreference, promptDiscovererChoice, savePreference, } from './DiscovererPreference.js';
 export { DiscovererRegistry } from './DiscovererRegistry.js';
 export { GenericDiscoverer } from './GenericDiscoverer.js';
 export { GoDiscoverer } from './GoDiscoverer.js';

package/dist/lib/core/discovery/parsers/CMakeParser.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @module CMakeParser
+ * @description CMake 轻量解析器 — 从 CMakeLists.txt 提取项目拓扑
+ *
+ * 支持解析：
+ *  - project() — 项目名和版本
+ *  - add_subdirectory() — 子目录发现
+ *  - add_library() / add_executable() — 目标声明
+ *  - target_link_libraries() — 依赖关系
+ *
+ * 设计策略: 仅解析顶层调用，不跟踪控制流 (if/else/macro)
+ */
+export interface ParsedCMakeProject {
+    projectName: string;
+    version?: string;
+    subdirectories: string[];
+    targets: CMakeTarget[];
+}
+export interface CMakeTarget {
+    name: string;
+    type: 'executable' | 'static-library' | 'shared-library' | 'interface-library';
+    sources: string[];
+    linkDependencies: CMakeLinkDep[];
+}
+export interface CMakeLinkDep {
+    target: string;
+    scope: 'PUBLIC' | 'PRIVATE' | 'INTERFACE';
+}
+/**
+ * 解析 CMakeLists.txt 内容
+ */
+export declare function parseCMakeProject(content: string): ParsedCMakeProject;

package/dist/lib/core/discovery/parsers/CMakeParser.js

@@ -0,0 +1,148 @@
+/**
+ * @module CMakeParser
+ * @description CMake 轻量解析器 — 从 CMakeLists.txt 提取项目拓扑
+ *
+ * 支持解析：
+ *  - project() — 项目名和版本
+ *  - add_subdirectory() — 子目录发现
+ *  - add_library() / add_executable() — 目标声明
+ *  - target_link_libraries() — 依赖关系
+ *
+ * 设计策略: 仅解析顶层调用，不跟踪控制流 (if/else/macro)
+ */
+// ── 正则模式 ────────────────────────────────────────
+const PROJECT_RE = /project\(\s*(\w+)(?:\s+VERSION\s+([\d.]+))?/;
+const ADD_SUBDIRECTORY_RE = /add_subdirectory\(\s*(\S+)\s*\)/g;
+// add_library(name STATIC src1.cpp src2.cpp) — 允许多行
+const ADD_LIBRARY_RE = /add_library\(\s*(\w+)\s+(STATIC|SHARED|INTERFACE|MODULE|OBJECT)?\s*([\s\S]*?)\)/g;
+const ADD_EXECUTABLE_RE = /add_executable\(\s*(\w+)\s*([\s\S]*?)\)/g;
+// target_link_libraries(target PUBLIC|PRIVATE|INTERFACE dep1 dep2)
+const TARGET_LINK_RE = /target_link_libraries\(\s*(\w+)\s+([\s\S]*?)\)/g;
+// ── 公开 API ────────────────────────────────────────
+/**
+ * 解析 CMakeLists.txt 内容
+ */
+export function parseCMakeProject(content) {
+    const result = {
+        projectName: '',
+        subdirectories: [],
+        targets: [],
+    };
+    // 移除注释
+    const cleaned = removeComments(content);
+    // 解析 project()
+    const projMatch = cleaned.match(PROJECT_RE);
+    if (projMatch) {
+        result.projectName = projMatch[1];
+        result.version = projMatch[2];
+    }
+    // 解析 add_subdirectory()
+    const subdirRe = new RegExp(ADD_SUBDIRECTORY_RE.source, 'g');
+    let m;
+    while ((m = subdirRe.exec(cleaned)) !== null) {
+        result.subdirectories.push(m[1]);
+    }
+    // 解析 add_library()
+    const targetMap = new Map();
+    const libRe = new RegExp(ADD_LIBRARY_RE.source, 'gs');
+    while ((m = libRe.exec(cleaned)) !== null) {
+        const name = m[1];
+        const typeStr = (m[2] ?? 'STATIC').toUpperCase();
+        const sourcesStr = m[3] ?? '';
+        const typeMap = {
+            STATIC: 'static-library',
+            SHARED: 'shared-library',
+            INTERFACE: 'interface-library',
+            MODULE: 'shared-library',
+            OBJECT: 'static-library',
+        };
+        const target = {
+            name,
+            type: typeMap[typeStr] ?? 'static-library',
+            sources: extractSourceFiles(sourcesStr),
+            linkDependencies: [],
+        };
+        targetMap.set(name, target);
+    }
+    // 解析 add_executable()
+    const exeRe = new RegExp(ADD_EXECUTABLE_RE.source, 'gs');
+    while ((m = exeRe.exec(cleaned)) !== null) {
+        const name = m[1];
+        const sourcesStr = m[2] ?? '';
+        const target = {
+            name,
+            type: 'executable',
+            sources: extractSourceFiles(sourcesStr),
+            linkDependencies: [],
+        };
+        targetMap.set(name, target);
+    }
+    // 解析 target_link_libraries()
+    const linkRe = new RegExp(TARGET_LINK_RE.source, 'gs');
+    while ((m = linkRe.exec(cleaned)) !== null) {
+        const targetName = m[1];
+        const depsStr = m[2];
+        const target = targetMap.get(targetName);
+        if (!target) {
+            continue;
+        }
+        target.linkDependencies = parseLinkDependencies(depsStr);
+    }
+    result.targets = [...targetMap.values()];
+    return result;
+}
+// ── 内部函数 ────────────────────────────────────────
+function removeComments(content) {
+    return content
+        .split('\n')
+        .map((line) => {
+        const commentIdx = line.indexOf('#');
+        if (commentIdx === -1) {
+            return line;
+        }
+        // 简单处理：不检查字符串内的 #
+        return line.substring(0, commentIdx);
+    })
+        .join('\n');
+}
+function extractSourceFiles(str) {
+    const sources = [];
+    // 提取非关键字的 token
+    const tokens = str.trim().split(/\s+/);
+    for (const token of tokens) {
+        const clean = token.trim();
+        if (clean === '' ||
+            clean === 'STATIC' ||
+            clean === 'SHARED' ||
+            clean === 'INTERFACE' ||
+            clean === 'MODULE' ||
+            clean === 'OBJECT' ||
+            clean === 'PUBLIC' ||
+            clean === 'PRIVATE' ||
+            clean === 'IMPORTED' ||
+            clean === 'ALIAS' ||
+            clean === 'EXCLUDE_FROM_ALL' ||
+            clean.startsWith('$')) {
+            continue;
+        }
+        sources.push(clean);
+    }
+    return sources;
+}
+function parseLinkDependencies(str) {
+    const deps = [];
+    const tokens = str.trim().split(/\s+/);
+    let currentScope = 'PUBLIC';
+    for (const token of tokens) {
+        const clean = token.trim();
+        if (clean === 'PUBLIC' || clean === 'PRIVATE' || clean === 'INTERFACE') {
+            currentScope = clean;
+            continue;
+        }
+        if (clean === '' || clean.startsWith('$') || clean.startsWith('#')) {
+            continue;
+        }
+        deps.push({ target: clean, scope: currentScope });
+    }
+    return deps;
+}

package/dist/lib/core/discovery/parsers/GradleDslParser.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @module GradleDslParser
+ * @description Gradle DSL 轻量解析器 — 从 settings.gradle.kts / build.gradle.kts 提取项目拓扑
+ *
+ * 支持解析：
+ *  - settings.gradle.kts: rootProject.name + include() 模块声明
+ *  - build.gradle.kts: plugins {} + dependencies {} (project-to-project)
+ *  - settings.gradle (Groovy 语法)
+ *
+ * 同时支持 Kotlin DSL 和 Groovy DSL 的正则模式。
+ */
+export interface ParsedGradleProject {
+    rootProjectName: string;
+    includedModules: GradleModule[];
+    versionCatalog?: string;
+}
+export interface GradleModule {
+    path: string;
+    directory: string;
+    conventionPlugin?: string;
+    dependencies: GradleDep[];
+}
+export interface GradleDep {
+    configuration: string;
+    target: string;
+    isProject: boolean;
+}
+/**
+ * 解析 settings.gradle.kts / settings.gradle 内容
+ * 提取 rootProject 名和所有 include 模块
+ *
+ * 当传入 build 文件内容时（附带 module 参数），解析 plugins 和 dependencies 到该模块上
+ */
+export declare function parseGradleProject(content: string, existingModule?: GradleModule): ParsedGradleProject;
+/**
+ * 检测 build 文件中是否使用了 Kotlin Multiplatform 插件
+ */
+export declare function isKmpBuildFile(content: string): boolean;
+/**
+ * 从 convention plugin id 推断模块角色
+ * 例: "myapp.android.feature" → "feature"
+ */
+export declare function inferConventionRole(pluginId: string): string | undefined;