spectra-cli 4.1.1

package/dist/batch/directory-classifier.js

@@ -0,0 +1,270 @@
+/**
+ * 目录分类器
+ * 基于三信号组合（目录名模式 + 文件内容特征 + Import 反向引用）
+ * 对目录进行分类：source / test / example / vendor / config / docs
+ * 支持用户通过项目配置覆盖自动分类结果（FR-005, FR-006, FR-013）
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// ============================================================
+// 目录名称模式
+// ============================================================
+/** 测试目录名称模式（高权重） */
+const TEST_DIR_PATTERNS = [
+    'test', 'tests', '__tests__', 'spec', 'specs', '__spec__',
+    'e2e', 'integration', 'unit', 'jest', 'mocha', 'pytest',
+];
+/** 示例/演示目录名称模式（高权重） */
+const EXAMPLE_DIR_PATTERNS = [
+    'example', 'examples', 'demo', 'demos', 'sample', 'samples',
+    'worked', 'worked-example', 'worked-examples', 'tutorial', 'tutorials',
+    'playground', 'sandbox',
+];
+/** vendor/第三方目录名称模式（高权重） */
+const VENDOR_DIR_PATTERNS = [
+    'vendor', 'vendors', 'third_party', 'third-party', 'thirdparty',
+    'node_modules', '__pycache__', '.venv', 'venv', 'env',
+    'site-packages', 'dist', 'build', 'out', '.next', '.nuxt',
+    'generated', 'gen', 'dist-cjs', 'dist-esm',
+];
+/** 配置目录名称模式（中权重） */
+const CONFIG_DIR_PATTERNS = [
+    'config', 'configs', 'conf', 'settings', 'configuration',
+    '.github', '.circleci', '.jenkins',
+];
+/** 文档目录名称模式（中权重） */
+const DOCS_DIR_PATTERNS = [
+    'docs', 'doc', 'documentation', 'wiki', 'pages', 'website',
+    'gh-pages', 'site', 'manual',
+];
+/** fixtures/测试数据目录名称模式（高权重） */
+const FIXTURE_DIR_PATTERNS = [
+    'fixtures', '__fixtures__', 'testdata', 'test-fixtures',
+    'testfiles', 'test-data', 'snapshots', '__snapshots__',
+];
+// ============================================================
+// 辅助函数
+// ============================================================
+/**
+ * 根据目录名称判断分类信号
+ * 返回置信度最高的信号（若无匹配则返回 null）
+ */
+function getNamePatternSignal(dirName) {
+    const lowerName = dirName.toLowerCase().replace(/[-_.]/g, '');
+    // 优先级：vendor > example/fixture > test > config > docs
+    const checks = [
+        { patterns: VENDOR_DIR_PATTERNS, category: 'vendor', weight: 0.9 },
+        { patterns: EXAMPLE_DIR_PATTERNS, category: 'example', weight: 0.85 },
+        { patterns: FIXTURE_DIR_PATTERNS, category: 'test', weight: 0.85 },
+        { patterns: TEST_DIR_PATTERNS, category: 'test', weight: 0.8 },
+        { patterns: DOCS_DIR_PATTERNS, category: 'docs', weight: 0.75 },
+        { patterns: CONFIG_DIR_PATTERNS, category: 'config', weight: 0.7 },
+    ];
+    for (const { patterns, category, weight } of checks) {
+        for (const pattern of patterns) {
+            const normalizedPattern = pattern.replace(/[-_.]/g, '');
+            if (lowerName === normalizedPattern || lowerName.startsWith(normalizedPattern)) {
+                return {
+                    type: 'name_pattern',
+                    suggestedCategory: category,
+                    weight,
+                    description: `目录名 "${dirName}" 匹配 ${category} 模式 "${pattern}"`,
+                };
+            }
+        }
+    }
+    return null;
+}
+/**
+ * 检测目录内是否含有 minified/打包产物（vendor 信号）
+ * 采样检测：只读前 3 个文件
+ */
+function getContentFeatureSignal(dirPath) {
+    try {
+        const entries = fs.readdirSync(dirPath).slice(0, 10);
+        let minifiedCount = 0;
+        let checkedCount = 0;
+        for (const entry of entries) {
+            const fullPath = path.join(dirPath, entry);
+            try {
+                const stat = fs.statSync(fullPath);
+                if (!stat.isFile())
+                    continue;
+                // 只检测 JS/CSS 文件
+                if (!/\.(js|css|mjs|cjs)$/.test(entry))
+                    continue;
+                // 采样：只读前 2KB
+                const fd = fs.openSync(fullPath, 'r');
+                const buf = Buffer.alloc(2048);
+                const bytesRead = fs.readSync(fd, buf, 0, 2048, 0);
+                fs.closeSync(fd);
+                const content = buf.toString('utf-8', 0, bytesRead);
+                const lines = content.split('\n').filter((l) => l.length > 0);
+                if (lines.length > 0) {
+                    const longLineCount = lines.filter((l) => l.length > 500).length;
+                    if (longLineCount / lines.length > 0.5) {
+                        minifiedCount++;
+                    }
+                    checkedCount++;
+                }
+                if (checkedCount >= 3)
+                    break;
+            }
+            catch {
+                // 单文件读取失败时跳过
+            }
+        }
+        if (checkedCount > 0 && minifiedCount / checkedCount > 0.5) {
+            return {
+                type: 'content_feature',
+                suggestedCategory: 'vendor',
+                weight: 0.85,
+                description: `目录 "${path.basename(dirPath)}" 含 ${minifiedCount}/${checkedCount} 个 minified 文件`,
+            };
+        }
+    }
+    catch {
+        // 目录读取失败时跳过
+    }
+    return null;
+}
+/**
+ * 根据 Import 反向引用判断是否为核心源码目录
+ * 如果该目录被其他目录的文件 import，则为 source 的强信号
+ *
+ * @param dirPath - 目标目录路径（相对路径）
+ * @param importingFiles - 所有导入了该目录模块的文件路径集合
+ */
+function getImportReferenceSignal(dirPath, importingFiles) {
+    if (importingFiles.size === 0)
+        return null;
+    // 被多处导入 → 强 source 信号
+    const weight = Math.min(0.95, 0.6 + importingFiles.size * 0.05);
+    return {
+        type: 'import_reference',
+        suggestedCategory: 'source',
+        weight,
+        description: `目录 "${path.basename(dirPath)}" 被 ${importingFiles.size} 个外部文件 import`,
+    };
+}
+/**
+ * 综合多信号，计算最终分类结果
+ * 规则：
+ * 1. import_reference（source 信号）可以覆盖名称判定（除非权重差距 > 0.3）
+ * 2. 同类别信号权重叠加
+ * 3. 最高权重类别获胜
+ */
+function aggregateSignals(signals, defaultCategory = 'source') {
+    if (signals.length === 0) {
+        return { category: defaultCategory, confidence: 0.5 };
+    }
+    // 按类别聚合权重（取最大值，而非求和，避免多弱信号压倒强信号）
+    const categoryWeights = new Map();
+    for (const signal of signals) {
+        const current = categoryWeights.get(signal.suggestedCategory) ?? 0;
+        categoryWeights.set(signal.suggestedCategory, Math.max(current, signal.weight));
+    }
+    // 找最高权重类别
+    let bestCategory = defaultCategory;
+    let bestWeight = 0;
+    for (const [cat, weight] of categoryWeights) {
+        if (weight > bestWeight) {
+            bestWeight = weight;
+            bestCategory = cat;
+        }
+    }
+    return { category: bestCategory, confidence: bestWeight };
+}
+// ============================================================
+// 核心 API
+// ============================================================
+/**
+ * 对单个目录进行分类
+ *
+ * @param dirPath - 目录路径
+ * @param importingFiles - 外部文件对该目录的 import 引用集合（用于 import 信号）
+ * @param options - 分类选项（用户覆盖等）
+ * @returns 目录分类结果
+ */
+export function classifyDirectory(dirPath, importingFiles = new Set(), options = {}) {
+    const dirName = path.basename(dirPath);
+    const { excludeDirs = [], includeDirs = [], minConfidence = 0.6 } = options;
+    // 目录规则匹配辅助函数
+    const matchesDirRule = (dp, dn, rule) => dp.endsWith(rule) || dn === rule || dp.includes(`/${rule}/`) || dp.includes(`\\${rule}\\`);
+    // 用户 includeDirs 优先级最高：强制 source（即使同时出现在 excludeDirs 中）
+    if (includeDirs.some((d) => matchesDirRule(dirPath, dirName, d))) {
+        return {
+            dirPath,
+            category: 'source',
+            confidence: 1.0,
+            signals: [{ type: 'name_pattern', suggestedCategory: 'source', weight: 1.0, description: '用户配置 includeDirs 强制包含' }],
+            isUserOverride: true,
+        };
+    }
+    // 用户 excludeDirs：强制非 source（includeDirs 之后检查）
+    if (excludeDirs.some((d) => matchesDirRule(dirPath, dirName, d))) {
+        return {
+            dirPath,
+            category: 'example',
+            confidence: 1.0,
+            signals: [{ type: 'name_pattern', suggestedCategory: 'example', weight: 1.0, description: '用户配置 excludeDirs 强制排除' }],
+            isUserOverride: true,
+        };
+    }
+    // 收集信号
+    const signals = [];
+    // 信号 1：目录名模式
+    const nameSignal = getNamePatternSignal(dirName);
+    if (nameSignal)
+        signals.push(nameSignal);
+    // 信号 2：文件内容特征（仅对可访问目录）
+    if (fs.existsSync(dirPath)) {
+        const contentSignal = getContentFeatureSignal(dirPath);
+        if (contentSignal)
+            signals.push(contentSignal);
+    }
+    // 信号 3：Import 反向引用
+    const importSignal = getImportReferenceSignal(dirPath, importingFiles);
+    if (importSignal)
+        signals.push(importSignal);
+    // 综合信号
+    const { category, confidence } = aggregateSignals(signals);
+    // 置信度低于阈值时保守归为 source
+    const finalCategory = confidence >= minConfidence ? category : 'source';
+    return {
+        dirPath,
+        category: finalCategory,
+        confidence,
+        signals,
+        isUserOverride: false,
+    };
+}
+/**
+ * 批量对目录列表进行分类
+ *
+ * @param dirPaths - 目录路径数组
+ * @param importGraphEdges - 模块间 import 边（{from: 导入方文件路径, to: 被导入目录路径}）
+ * @param options - 分类选项
+ * @returns 每个目录的分类结果
+ */
+export function classifyDirectories(dirPaths, importGraphEdges = [], options = {}) {
+    // 构建 dirPath → 导入该目录的外部文件集合
+    // 优化：先对每条 edge 确定属于哪个目录，避免 O(m²*n) 嵌套遍历
+    const importerMap = new Map();
+    for (const dirPath of dirPaths) {
+        importerMap.set(dirPath, new Set());
+    }
+    // 按路径长度降序排列，确保最深匹配优先（子目录优先于父目录）
+    const sortedDirs = [...dirPaths].sort((a, b) => b.length - a.length);
+    for (const edge of importGraphEdges) {
+        if (!edge.from || !edge.to)
+            continue;
+        // 找到 edge.to 所属的目录（O(k) 其中 k = 目录数）
+        const targetDir = sortedDirs.find(d => edge.to.startsWith(d));
+        if (targetDir && !edge.from.startsWith(targetDir)) {
+            importerMap.get(targetDir)?.add(edge.from);
+        }
+    }
+    return dirPaths.map((dirPath) => classifyDirectory(dirPath, importerMap.get(dirPath) ?? new Set(), options));
+}
+//# sourceMappingURL=directory-classifier.js.map

package/dist/batch/directory-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-classifier.js","sourceRoot":"","sources":["../../src/batch/directory-classifier.ts"],"names":[],"mappings":"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"}

package/dist/batch/language-grouper.d.ts

@@ -0,0 +1,28 @@
+/** 按语言分组后的文件集合 */
+export interface LanguageGroup {
+    /** 语言标识（即 adapter.id） */
+    adapterId: string;
+    /** 语言显示名称 */
+    languageName: string;
+    /** 该语言的文件路径列表（相对于项目根目录） */
+    files: string[];
+}
+/** 语言分组结果 */
+export interface LanguageGroupResult {
+    /** 语言分组列表 */
+    groups: LanguageGroup[];
+    /** 警告信息（如指定的过滤语言不存在） */
+    warnings: string[];
+}
+/**
+ * 按语言对文件列表进行分组
+ *
+ * 遍历文件列表，通过 LanguageAdapterRegistry.getAdapter() 按语言分组。
+ * 未注册扩展名的文件被忽略不纳入任何分组。
+ *
+ * @param files - scanFiles() 返回的文件路径列表
+ * @param filterLanguages - 可选的语言过滤列表（adapter.id 或语言名称）
+ * @returns 分组结果和警告信息
+ */
+export declare function groupFilesByLanguage(files: string[], filterLanguages?: string[]): LanguageGroupResult;
+//# sourceMappingURL=language-grouper.d.ts.map

package/dist/batch/language-grouper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-grouper.d.ts","sourceRoot":"","sources":["../../src/batch/language-grouper.ts"],"names":[],"mappings":"AAUA,kBAAkB;AAClB,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,aAAa;AACb,MAAM,WAAW,mBAAmB;IAClC,aAAa;IACb,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EAAE,EACf,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,mBAAmB,CAwDrB"}

package/dist/batch/language-grouper.js

@@ -0,0 +1,67 @@
+/**
+ * 语言分组器
+ * 按语言对文件列表进行分组，支持可选的语言过滤（Feature 031）
+ */
+import { LanguageAdapterRegistry } from '../adapters/language-adapter-registry.js';
+// ============================================================
+// 核心 API
+// ============================================================
+/**
+ * 按语言对文件列表进行分组
+ *
+ * 遍历文件列表，通过 LanguageAdapterRegistry.getAdapter() 按语言分组。
+ * 未注册扩展名的文件被忽略不纳入任何分组。
+ *
+ * @param files - scanFiles() 返回的文件路径列表
+ * @param filterLanguages - 可选的语言过滤列表（adapter.id 或语言名称）
+ * @returns 分组结果和警告信息
+ */
+export function groupFilesByLanguage(files, filterLanguages) {
+    const registry = LanguageAdapterRegistry.getInstance();
+    const warnings = [];
+    // 步骤 1：按语言分组
+    const groupMap = new Map();
+    for (const file of files) {
+        const adapter = registry.getAdapter(file);
+        if (!adapter)
+            continue;
+        if (!groupMap.has(adapter.id)) {
+            groupMap.set(adapter.id, {
+                adapterId: adapter.id,
+                languageName: adapter.languages[0] ?? adapter.id,
+                files: [],
+            });
+        }
+        groupMap.get(adapter.id).files.push(file);
+    }
+    let groups = Array.from(groupMap.values());
+    // 步骤 2：应用语言过滤
+    if (filterLanguages && filterLanguages.length > 0) {
+        // 构建已知适配器 ID 集合（用于匹配 filter 参数）
+        const adapterIdSet = new Set(groups.map((g) => g.adapterId));
+        // 解析 filterLanguages 到 adapter.id
+        const allowedIds = new Set();
+        for (const lang of filterLanguages) {
+            // 直接匹配 adapter.id
+            if (adapterIdSet.has(lang)) {
+                allowedIds.add(lang);
+                continue;
+            }
+            // 尝试通过语言名称匹配
+            let found = false;
+            for (const group of groups) {
+                if (group.languageName === lang) {
+                    allowedIds.add(group.adapterId);
+                    found = true;
+                    break;
+                }
+            }
+            if (!found) {
+                warnings.push(`指定的语言 '${lang}' 在项目中不存在`);
+            }
+        }
+        groups = groups.filter((g) => allowedIds.has(g.adapterId));
+    }
+    return { groups, warnings };
+}
+//# sourceMappingURL=language-grouper.js.map

package/dist/batch/language-grouper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-grouper.js","sourceRoot":"","sources":["../../src/batch/language-grouper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAwBnF,+DAA+D;AAC/D,SAAS;AACT,+DAA+D;AAE/D;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAe,EACf,eAA0B;IAE1B,MAAM,QAAQ,GAAG,uBAAuB,CAAC,WAAW,EAAE,CAAC;IACvD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,aAAa;IACb,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IAElD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YAC9B,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE;gBACvB,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,EAAE;gBAChD,KAAK,EAAE,EAAE;aACV,CAAC,CAAC;QACL,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAE3C,cAAc;IACd,IAAI,eAAe,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,gCAAgC;QAChC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QAE7D,kCAAkC;QAClC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;YACnC,kBAAkB;YAClB,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3B,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,aAAa;YACb,IAAI,KAAK,GAAG,KAAK,CAAC;YAClB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;oBAChC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;oBAChC,KAAK,GAAG,IAAI,CAAC;oBACb,MAAM;gBACR,CAAC;YACH,CAAC;YAED,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,QAAQ,CAAC,IAAI,CAAC,UAAU,IAAI,WAAW,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC"}

package/dist/batch/model-override-decision.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 模块 spec 主调用的 model override 决策（Fix 134 提取）
+ *
+ * 三种触发条件，任一为真即覆盖默认 model 为 sonnet：
+ * - 小模块优化（isSmallModule）：文件数 ≤ 2 且总行数 < 200，sonnet 质量足够
+ * - 预算 gate 降级（budgetCheaperModelAll）：预算 gate 决定全部模块走更便宜的模型
+ * - reading / code-only 模式（effectiveMode !== 'full'）：Fix 134 P0-3 — reading
+ *   模式 SC-001 < 120s 的硬指标必须始终满足，与用户配置默认 model 解耦
+ */
+import type { BatchMode } from '../panoramic/qa/types.js';
+export interface ModelOverrideDecisionInput {
+    /** 是否为小模块（文件数 ≤ 2 且总行数 < 200） */
+    isSmallModule: boolean;
+    /** 预算 gate 是否决定全部模块走更便宜的模型 */
+    budgetCheaperModelAll: boolean;
+    /** 当前 batch 运行模式（full / reading / code-only） */
+    effectiveMode: BatchMode;
+    /** 用作 override 的 sonnet 模型 ID（由 resolveReverseSpecModel 解析） */
+    sonnetModelId: string;
+}
+/**
+ * 决策模块 spec 主调用是否需要 model override。
+ *
+ * @returns sonnetModelId 表示需要 override；undefined 表示沿用默认 model
+ */
+export declare function decideModelOverride(input: ModelOverrideDecisionInput): string | undefined;
+//# sourceMappingURL=model-override-decision.d.ts.map

package/dist/batch/model-override-decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-override-decision.d.ts","sourceRoot":"","sources":["../../src/batch/model-override-decision.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,WAAW,0BAA0B;IACzC,iCAAiC;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,8BAA8B;IAC9B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,gDAAgD;IAChD,aAAa,EAAE,SAAS,CAAC;IACzB,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,0BAA0B,GAAG,MAAM,GAAG,SAAS,CAOzF"}

package/dist/batch/model-override-decision.js

@@ -0,0 +1,14 @@
+/**
+ * 决策模块 spec 主调用是否需要 model override。
+ *
+ * @returns sonnetModelId 表示需要 override；undefined 表示沿用默认 model
+ */
+export function decideModelOverride(input) {
+    const { isSmallModule, budgetCheaperModelAll, effectiveMode, sonnetModelId } = input;
+    const isReadingOrCodeOnly = effectiveMode !== 'full';
+    if (isSmallModule || budgetCheaperModelAll || isReadingOrCodeOnly) {
+        return sonnetModelId;
+    }
+    return undefined;
+}
+//# sourceMappingURL=model-override-decision.js.map

package/dist/batch/model-override-decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-override-decision.js","sourceRoot":"","sources":["../../src/batch/model-override-decision.ts"],"names":[],"mappings":"AAsBA;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAiC;IACnE,MAAM,EAAE,aAAa,EAAE,qBAAqB,EAAE,aAAa,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IACrF,MAAM,mBAAmB,GAAG,aAAa,KAAK,MAAM,CAAC;IACrD,IAAI,aAAa,IAAI,qBAAqB,IAAI,mBAAmB,EAAE,CAAC;QAClE,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/batch/module-grouper.d.ts

@@ -0,0 +1,59 @@
+import type { DependencyGraph } from '../models/dependency-graph.js';
+import type { DirectoryClassifierOptions } from './directory-classifier.js';
+/** 模块分组 */
+export interface ModuleGroup {
+    /** 模块名称（如 'agents'、'config'、'root'） */
+    name: string;
+    /** 模块对应的目录路径（相对于项目根，如 'src/agents'） */
+    dirPath: string;
+    /** 模块内包含的文件路径 */
+    files: string[];
+    /** 该模块的主要语言（仅语言感知分组模式下设置） */
+    language?: string;
+}
+/** 分组结果 */
+export interface ModuleGroupResult {
+    /** 按模块分组的结果 */
+    groups: ModuleGroup[];
+    /** 模块级拓扑排序（叶子模块优先） */
+    moduleOrder: string[];
+    /** 模块间的聚合依赖边 */
+    moduleEdges: Array<{
+        from: string;
+        to: string;
+    }>;
+}
+/** 分组选项 */
+export interface GroupingOptions {
+    /** 分组策略的基准目录前缀（默认自动检测） */
+    basePrefix?: string;
+    /** 分组深度（basePrefix 之后取几级目录，默认 1） */
+    depth?: number;
+    /** 根目录散文件的模块名（默认 'root'） */
+    rootModuleName?: string;
+    /** 启用语言感知分组（同目录不同语言拆分为子模块） */
+    languageAware?: boolean;
+    /**
+     * 启用目录语义分类，自动过滤非 source 类别目录（FR-005）
+     * 开启后，example/vendor/test 等目录的模块不会进入 moduleOrder
+     */
+    classifyDirectories?: boolean;
+    /**
+     * 目录分类器选项（仅在 classifyDirectories: true 时生效）
+     */
+    directoryClassifierOptions?: DirectoryClassifierOptions;
+    /**
+     * 项目根目录绝对路径（用于目录分类器解析目录路径）
+     */
+    projectRoot?: string;
+}
+/**
+ * 将文件级依赖图聚合为模块级分组
+ *
+ * 分组规则：
+ * 1. 以 basePrefix（默认 'src/'）开头的文件，按其后第 depth 级目录分组
+ * 2. basePrefix 根目录下的散文件归入 rootModuleName 模块
+ * 3. 无 src/ 目录时按项目根目录下第一级目录分组
+ */
+export declare function groupFilesToModules(graph: DependencyGraph, options?: GroupingOptions): ModuleGroupResult;
+//# sourceMappingURL=module-grouper.d.ts.map

package/dist/batch/module-grouper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-grouper.d.ts","sourceRoot":"","sources":["../../src/batch/module-grouper.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGrE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAM5E,WAAW;AACX,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,WAAW;AACX,MAAM,WAAW,iBAAiB;IAChC,eAAe;IACf,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,sBAAsB;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB;IAChB,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED,WAAW;AACX,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;OAEG;IACH,0BAA0B,CAAC,EAAE,0BAA0B,CAAC;IACxD;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,OAAO,GAAE,eAAoB,GAC5B,iBAAiB,CAwMnB"}