autosnippet 3.2.18 → 3.2.20

package/dist/lib/service/guard/GuardCheckEngine.js

@@ -460,9 +460,9 @@ export class GuardCheckEngine {
         this._astRulesCache = null;
         this._cacheTime = 0;
         this._cacheTTL = options.cacheTTL || 60_000; // 1min
-        /** @type {Map<string, object>} Enhancement Pack 注入的外部规则 */
+        /** Enhancement Pack 注入的外部规则 */
         this._externalRules = new Map();
-        /** @type {boolean} EP 规则是否已注入（幂等标记，避免每次请求重复注入） */
+        /** EP 规则是否已注入（幂等标记，避免每次请求重复注入） */
         this._epInjected = false;
         /** Guard 配置 — 允许禁用特定规则或调整 Code-Level 检查阈值 */
         this._guardConfig = options.guardConfig || {};
@@ -470,7 +470,7 @@ export class GuardCheckEngine {
     /**
      * 注入 Enhancement Pack 外部规则（支持 RegExp 和 string pattern）
      * 与 BUILT_IN_RULES 合并检查，自动跳过 ruleId 重复的规则
-     * @param {Array<{ruleId: string, pattern: RegExp|string, severity: string, message: string, category?: string, dimension?: string, languages?: string[], fixSuggestion?: string}>} rules
+     * @param rules
      */
     injectExternalRules(rules) {
         if (!Array.isArray(rules)) {
@@ -855,7 +855,7 @@ export class GuardCheckEngine {
     }
     /**
      * 将 Guard 命中计数回写到对应 Recipe 的 guard_hit_count
-     * @param {Array<{ruleId: string}>} violations
+     * @param violations
      */
     trackGuardHits(violations) {
         if (!violations?.length || !this.db) {
@@ -915,7 +915,7 @@ export class GuardCheckEngine {
     }
     /**
      * 批量文件审计
-     * @param {Array<{path: string, content: string}>} files
+     * @param files
      * @param options {scope: 'file'|'target'|'project'}
      * @returns }
      */

package/dist/lib/service/guard/GuardCrossFileChecks.d.ts

@@ -14,7 +14,7 @@ export declare function resolveImportPath(fromDir: string, importPath: string):
 export declare function normalizeFilePath(filePath: string): string;
 /**
  * 跨文件检查 — 需要多文件上下文才能发现的问题
- * @param {Array<{path: string, content: string}>} files
+ * @param files
  * @param [options.disabledRules] 禁用的规则 ID 列表
  * @returns >}
  */

package/dist/lib/service/guard/GuardFeedbackLoop.d.ts

@@ -46,20 +46,20 @@ export declare class GuardFeedbackLoop {
     });
     /**
      * 对比当前和历史 violations，检测已修复的违规
-     * @param {{ violations: Array<{ruleId: string}> }} currentResult 本次检查结果
+     * @param currentResult 本次检查结果
      * @param filePath 文件路径
      * @returns >} 已修复且有 Recipe 关联的列表
      */
     detectFixedViolations(currentResult: CheckResult, filePath: string): FixedViolation[];
     /**
      * 对已修复的违规自动确认使用
-     * @param {Array<{ ruleId: string, filePath: string, fixRecipeId: string }>} fixedList
+     * @param fixedList
      */
     autoConfirmUsage(fixedList: FixedViolation[]): void;
     /**
      * 一站式处理：检测修复 + 自动确认
      * 供 MCP handler、GuardHandler、HTTP guard/file 端点集成调用
-     * @param {{ violations: Array }} currentResult
+     * @param currentResult
      */
     processFixDetection(currentResult: CheckResult, filePath: string): FixedViolation[];
     /**

package/dist/lib/service/guard/GuardFeedbackLoop.js

@@ -21,7 +21,7 @@ export class GuardFeedbackLoop {
     }
     /**
      * 对比当前和历史 violations，检测已修复的违规
-     * @param {{ violations: Array<{ruleId: string}> }} currentResult 本次检查结果
+     * @param currentResult 本次检查结果
      * @param filePath 文件路径
      * @returns >} 已修复且有 Recipe 关联的列表
      */
@@ -57,7 +57,7 @@ export class GuardFeedbackLoop {
     }
     /**
      * 对已修复的违规自动确认使用
-     * @param {Array<{ ruleId: string, filePath: string, fixRecipeId: string }>} fixedList
+     * @param fixedList
      */
     autoConfirmUsage(fixedList) {
         if (!this.feedbackCollector || !fixedList?.length) {
@@ -81,7 +81,7 @@ export class GuardFeedbackLoop {
     /**
      * 一站式处理：检测修复 + 自动确认
      * 供 MCP handler、GuardHandler、HTTP guard/file 端点集成调用
-     * @param {{ violations: Array }} currentResult
+     * @param currentResult
      */
     processFixDetection(currentResult, filePath) {
         const fixed = this.detectFixedViolations(currentResult, filePath);

package/dist/lib/service/guard/GuardPatternUtils.js

@@ -9,7 +9,7 @@
  * - detectLanguage: 文件扩展名推断语言
  */
 import { LanguageService } from '../../shared/LanguageService.js';
-/** @type {Map<string, RegExp>} 已编译的正则缓存 (pattern string → RegExp) */
+/** 已编译的正则缓存 (pattern string → RegExp) */
 const _regexCache = new Map();
 /** 编译正则模式（支持 RegExp 对象和 string，带缓存） */
 export function compilePattern(pattern) {

package/dist/lib/service/guard/GuardService.d.ts

@@ -158,22 +158,8 @@ export declare class GuardService {
     }[]>;
     /**
      * 仅 DB 规则的简化检查（降级路径）
-     * @private
      */
-    _checkCodeDbOnly(code: string, options?: {
-        language?: string | null;
-    }): Promise<{
-        ruleId: string;
-        ruleName: string;
-        severity: string;
-        message: string;
-        matches: {
-            match: string;
-            index: number | undefined;
-            line: number;
-        }[];
-        matchCount: number;
-    }[]>;
+    private _checkCodeDbOnly;
     /** 查询规则列表 (kind='rule' + knowledgeType='boundary-constraint') */
     listRules(filters?: Record<string, unknown>, pagination?: {
         page?: number;

package/dist/lib/service/guard/GuardService.js

@@ -184,7 +184,6 @@ export class GuardService {
     }
     /**
      * 仅 DB 规则的简化检查（降级路径）
-     * @private
      */
     async _checkCodeDbOnly(code, options = {}) {
         const { language = null } = options;

package/dist/lib/service/guard/RuleLearner.d.ts

@@ -20,7 +20,7 @@ export declare class RuleLearner {
     });
     /**
      * 记录规则触发
-     * @param {{ filePath?: string, message?: string }} context
+     * @param context
      */
     recordTrigger(ruleId: string, _context?: Record<string, unknown>): void;
     /** 记录用户反馈 */

package/dist/lib/service/guard/RuleLearner.js

@@ -25,7 +25,7 @@ export class RuleLearner {
     }
     /**
      * 记录规则触发
-     * @param {{ filePath?: string, message?: string }} context
+     * @param context
      */
     recordTrigger(ruleId, _context = {}) {
         const stat = this.#ensureStat(ruleId);

package/dist/lib/service/knowledge/CodeEntityGraph.d.ts

@@ -186,7 +186,7 @@ export declare class CodeEntityGraph {
     /**
      * 从候选的 Relations 字段提取边写入图谱 (Phase 5/6)
      *
-     * @param {Array<{title: string, relations: object}>} candidates 扁平关系数组或 Relations 对象
+     * @param candidates 扁平关系数组或 Relations 对象
      */
     populateFromCandidateRelations(candidates: CandidateWithRelations[] | null): GraphPopulateResult;
     /** 获取单个实体信息 */
@@ -273,8 +273,8 @@ export declare class CodeEntityGraph {
     /**
      * 从解析后的调用边填充图谱 (Phase 5)
      *
-     * @param {Array<{ caller: string, callee: string, callType: string, resolveMethod: string, line: number, file: string, isAwait: boolean }>} callEdges
-     * @param {Array<{ from: string, to: string, flowType: string, direction: string }>} dataFlowEdges
+     * @param callEdges
+     * @param dataFlowEdges
      */
     populateCallGraph(callEdges: CallEdge[], dataFlowEdges: DataFlowEdge[]): GraphPopulateResult;
     /**

package/dist/lib/service/knowledge/CodeEntityGraph.js

@@ -182,7 +182,7 @@ export class CodeEntityGraph {
     /**
      * 从候选的 Relations 字段提取边写入图谱 (Phase 5/6)
      *
-     * @param {Array<{title: string, relations: object}>} candidates 扁平关系数组或 Relations 对象
+     * @param candidates 扁平关系数组或 Relations 对象
      */
     populateFromCandidateRelations(candidates) {
         if (!candidates?.length) {
@@ -588,8 +588,8 @@ export class CodeEntityGraph {
     /**
      * 从解析后的调用边填充图谱 (Phase 5)
      *
-     * @param {Array<{ caller: string, callee: string, callType: string, resolveMethod: string, line: number, file: string, isAwait: boolean }>} callEdges
-     * @param {Array<{ from: string, to: string, flowType: string, direction: string }>} dataFlowEdges
+     * @param callEdges
+     * @param dataFlowEdges
      */
     populateCallGraph(callEdges, dataFlowEdges) {
         const t0 = Date.now();

package/dist/lib/service/knowledge/KnowledgeService.d.ts

@@ -101,7 +101,6 @@ export declare class KnowledgeService {
     publish(id: string, context: ServiceContext): Promise<KnowledgeEntry>;
     /**
      * 触发 Cursor Delivery Pipeline（非阻塞、容错）
-     * @private
      */
     _triggerCursorDeliveryAsync(): void;
     /** 弃用 (pending|active → deprecated) */

package/dist/lib/service/knowledge/KnowledgeService.js

@@ -307,7 +307,6 @@ export class KnowledgeService {
     }
     /**
      * 触发 Cursor Delivery Pipeline（非阻塞、容错）
-     * @private
      */
     _triggerCursorDeliveryAsync() {
         import('../../injection/ServiceContainer.js')

package/dist/lib/service/module/ModuleService.d.ts

@@ -30,7 +30,7 @@ export declare class ModuleService {
     }[]>;
     /**
      * 获取依赖关系图
-     * @param {{ level?: 'package'|'target' }} [options]
+     * @param [options]
      * @returns [] }>}
      */
     getDependencyGraph(options?: {

package/dist/lib/service/module/ModuleService.js

@@ -65,7 +65,7 @@ const SOURCE_CODE_EXTS = new Set([
 export class ModuleService {
     #projectRoot;
     #registry;
-    /** @type {Array<{ discoverer: import('../../core/discovery/ProjectDiscoverer.js').ProjectDiscoverer, confidence: number }>} */
+    /** >} */
     #activeDiscoverers = [];
     #loaded = false;
     #logger;
@@ -233,7 +233,7 @@ export class ModuleService {
     }
     /**
      * 获取依赖关系图
-     * @param {{ level?: 'package'|'target' }} [options]
+     * @param [options]
      * @returns [] }>}
      */
     async getDependencyGraph(options = {}) {

package/dist/lib/service/search/HybridRetriever.d.ts

@@ -42,8 +42,8 @@ export declare class HybridRetriever {
      * Dense: vectorStore 向量搜索 (HNSW or brute-force)
      * Sparse: BM25 关键词搜索 (由外部传入结果)
      *
-     * @param {Array<{ id: string, score: number, [key: string]: unknown }>} params.denseResults - 向量搜索结果
-     * @param {Array<{ id: string, score: number, [key: string]: unknown }>} params.sparseResults - 关键词搜索结果
+     * @param params.denseResults - 向量搜索结果
+     * @param params.sparseResults - 关键词搜索结果
      * @param [params.alpha=0.5] Dense 权重
      * @returns >}
      */

package/dist/lib/service/search/HybridRetriever.js

@@ -31,8 +31,8 @@ export class HybridRetriever {
      * Dense: vectorStore 向量搜索 (HNSW or brute-force)
      * Sparse: BM25 关键词搜索 (由外部传入结果)
      *
-     * @param {Array<{ id: string, score: number, [key: string]: unknown }>} params.denseResults - 向量搜索结果
-     * @param {Array<{ id: string, score: number, [key: string]: unknown }>} params.sparseResults - 关键词搜索结果
+     * @param params.denseResults - 向量搜索结果
+     * @param params.sparseResults - 关键词搜索结果
      * @param [params.alpha=0.5] Dense 权重
      * @returns >}
      */

package/dist/lib/service/search/SearchEngine.d.ts

@@ -130,7 +130,7 @@ export declare class SearchEngine {
      *     - 已删除    → scorer.removeDocument()
      *  3. 清空缓存以确保搜索结果刷新
      *
-     * @param {{ force?: boolean }} [opts] - force=true 强制全量重建
+     * @param [opts] - force=true 强制全量重建
      */
     refreshIndex(opts?: {
         force?: boolean;
@@ -141,12 +141,10 @@ export declare class SearchEngine {
      * 使用 BM25F 思想：高价值字段（title, trigger）重复出现以提升 TF 权重
      * — title ×3, trigger ×2, description ×1.5（通过重复 token 实现）
      * 这确保标题匹配的文档获得显著更高的 BM25 分数
-     * @private
      */
     _buildDocText(r: DbRow): string;
     /**
      * 从 DB 行构建文档 meta
-     * @private
      */
     _buildDocMeta(r: DbRow): {
         type: string;

package/dist/lib/service/search/SearchEngine.js

@@ -636,7 +636,7 @@ export class SearchEngine {
      *     - 已删除    → scorer.removeDocument()
      *  3. 清空缓存以确保搜索结果刷新
      *
-     * @param {{ force?: boolean }} [opts] - force=true 强制全量重建
+     * @param [opts] - force=true 强制全量重建
      */
     refreshIndex(opts = {}) {
         if (opts.force || !this._indexed || !this._lastIndexTime) {
@@ -689,7 +689,6 @@ export class SearchEngine {
      * 使用 BM25F 思想：高价值字段（title, trigger）重复出现以提升 TF 权重
      * — title ×3, trigger ×2, description ×1.5（通过重复 token 实现）
      * 这确保标题匹配的文档获得显著更高的 BM25 分数
-     * @private
      */
     _buildDocText(r) {
         let contentText = '';
@@ -731,7 +730,6 @@ export class SearchEngine {
     }
     /**
      * 从 DB 行构建文档 meta
-     * @private
      */
     _buildDocMeta(r) {
         let parsedTags = [];

package/dist/lib/service/search/contextBoost.d.ts

@@ -11,7 +11,7 @@
  */
 /**
  * @param items 已排序的候选列表（需有 rankerScore / coarseScore / score）
- * @param {Array<{content?: string, rawInput?: string}>} [context.sessionHistory]
+ * @param [context.sessionHistory]
  * @returns 含 contextScore / contextBoost 字段的排序列表
  */
 export interface SearchItem {

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

@@ -22,9 +22,9 @@ const DEFAULT_WINDOW_MS = 5000; // 5 秒聚合窗口
 const DEFAULT_MAX_BATCH = 50; // 单次 batch 最大事件数
 const DEFAULT_DEDUPE_MS = 60_000; // 60 秒去重窗口
 export class EventAggregator {
-    /** @type {Map<string, { events: Record<string, unknown>[], timer: ReturnType<typeof setTimeout> | null }>} */
+    /** >} */
     #buckets = new Map();
-    /** @type {Map<string, number>} 已处理事件的 hash → 最后处理时间 */
+    /** 已处理事件的 hash → 最后处理时间 */
     #dedupeMap = new Map();
     #listeners = new Map();
     #windowMs;

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

@@ -60,7 +60,7 @@ export class SignalCollector {
     #snapshotPath;
     #snapshot;
     #onSuggestions;
-    /** @type {EventAggregator} 信号聚类引擎 */
+    /** 信号聚类引擎 */
     #aggregator;
     /**
      * @param opts.projectRoot 用户项目根目录

package/dist/lib/service/snippet/codecs/VSCodeCodec.js

@@ -61,7 +61,7 @@ export class VSCodeCodec extends SnippetCodec {
     getBundleFilename() {
         return BUNDLE_FILENAME;
     }
-    /** @private SnippetSpec → VSCode snippet entry */
+    /** SnippetSpec → VSCode snippet entry */
     #specToEntry(spec) {
         const code = Array.isArray(spec.code) ? spec.code.join('\n') : spec.code || '';
         // 自动将 Xcode 占位符转为 VSCode 格式

package/dist/lib/service/task/TaskGraphService.d.ts

@@ -211,15 +211,12 @@ export declare class TaskGraphService {
      * P2: 获取决策过期阈值（秒）
      * 默认 30 天 = 2592000 秒。可通过容器内 'config' 服务配置。
      * 返回 0 表示禁用过期检测。
-     * @private
      */
     _getDecisionStaleThreshold(): number;
     /**
      * 查找因 closedTaskId 完成而新解除阻塞的任务
-     * @private
      */
     _checkNewlyUnblocked(closedTaskId: string): string[];
-    /** @private */
     _logEvent(taskId: string, eventType: string, oldValue: string | null, newValue: string | null): void;
 }
 export default TaskGraphService;

package/dist/lib/service/task/TaskGraphService.js

@@ -542,7 +542,6 @@ export class TaskGraphService {
      * P2: 获取决策过期阈值（秒）
      * 默认 30 天 = 2592000 秒。可通过容器内 'config' 服务配置。
      * 返回 0 表示禁用过期检测。
-     * @private
      */
     _getDecisionStaleThreshold() {
         try {
@@ -565,7 +564,6 @@ export class TaskGraphService {
     }
     /**
      * 查找因 closedTaskId 完成而新解除阻塞的任务
-     * @private
      */
     _checkNewlyUnblocked(closedTaskId) {
         const dependents = this.repo.getDependents(closedTaskId);
@@ -587,7 +585,6 @@ export class TaskGraphService {
         }
         return newlyReady;
     }
-    /** @private */
     _logEvent(taskId, eventType, oldValue, newValue) {
         try {
             this.repo.logEvent(taskId, eventType, oldValue, newValue);

package/dist/lib/service/task/TaskKnowledgeBridge.d.ts

@@ -1,4 +1,3 @@
-import { type SlimSearchResult } from '#service/search/SearchTypes.js';
 import type { Task } from '../../domain/task/Task.js';
 import Logger from '../../infrastructure/logging/Logger.js';
 /** 知识注入的上下文选项（从 prime / ready / claim 透传） */
@@ -10,8 +9,6 @@ export interface KnowledgeEnrichOptions {
     /** 当前编程语言 */
     language?: string;
 }
-/** 投影后的知识条目（返回给 Agent）— 使用统一投影类型 */
-type SlimKnowledgeItem = SlimSearchResult;
 /**
  * TaskKnowledgeBridge — 任务 ↔ 知识桥接服务
  *
@@ -54,13 +51,8 @@ export declare class TaskKnowledgeBridge {
     }): Promise<Record<string, unknown> | null>;
     /**
      * 为单个任务构建知识上下文（v2 — multi-query + 上下文 + 缓存）
-     * @private
      */
-    _buildContext(task: Task, options?: KnowledgeEnrichOptions): Promise<Record<string, unknown> | {
-        relatedKnowledge: SlimSearchResult[];
-        guardRules: SlimSearchResult[];
-        searchQuery: string;
-    } | null>;
+    private _buildContext;
     /**
      * P2: 构建多条互补搜索查询
      *
@@ -69,45 +61,34 @@ export declare class TaskKnowledgeBridge {
      *   Q2 (语义): 用户输入 — 包含更丰富的自然语义
      *   Q3 (关键词): 从描述/用户输入提取技术术语
      *
-     * @private
      */
-    _buildSearchQueries(task: Task, userQuery?: string): string[];
+    private _buildSearchQueries;
     /**
      * P2: 从文本中提取技术术语（类名、文件名、API 名等）
-     * @private
      */
-    _extractTechTerms(text: string): string[];
+    private _extractTechTerms;
     /**
      * P2 + P3: Multi-Query 搜索 + 合并去重
      *
      * 对每个 query 执行搜索（并行），合并结果并按 score 去重保留最高分。
-     * @private
      */
-    _multiQuerySearch(queries: string[], options: {
-        language?: string;
-    }): Promise<Array<Record<string, unknown>>>;
+    private _multiQuerySearch;
     /**
      * 执行单次搜索（含 P3 上下文透传）
-     * @private
      */
-    _singleSearch(query: string, options: {
-        language?: string;
-    }): Promise<Array<Record<string, unknown>>>;
+    private _singleSearch;
     /**
      * P4: 相关性阈值判断
-     * @private
      */
-    _aboveThreshold(item: Record<string, unknown>): boolean;
+    private _aboveThreshold;
     /**
      * P4: 增强投影 — 使用统一 slimSearchResult() 投影函数
-     * @private
      */
-    _projectItem(item: Record<string, unknown>): SlimKnowledgeItem;
+    private _projectItem;
     /**
      * P6: 缓存键 — 基于 taskQuery + userQuery 的内容指纹
-     * @private
      */
-    _contentKey(taskQuery: string, userQuery?: string): string;
+    private _contentKey;
     /** 清除全部缓存（测试 / 索引重建后使用） */
     clearCache(): void;
 }

package/dist/lib/service/task/TaskKnowledgeBridge.js

@@ -112,7 +112,6 @@ export class TaskKnowledgeBridge {
     // ═══ 私有方法 ═══════════════════════════════════════
     /**
      * 为单个任务构建知识上下文（v2 — multi-query + 上下文 + 缓存）
-     * @private
      */
     async _buildContext(task, options) {
         const taskQuery = `${task.title} ${task.description}`.trim();
@@ -174,7 +173,6 @@ export class TaskKnowledgeBridge {
      *   Q2 (语义): 用户输入 — 包含更丰富的自然语义
      *   Q3 (关键词): 从描述/用户输入提取技术术语
      *
-     * @private
      */
     _buildSearchQueries(task, userQuery) {
         const queries = [];
@@ -209,7 +207,6 @@ export class TaskKnowledgeBridge {
     }
     /**
      * P2: 从文本中提取技术术语（类名、文件名、API 名等）
-     * @private
      */
     _extractTechTerms(text) {
         if (!text) {
@@ -234,7 +231,6 @@ export class TaskKnowledgeBridge {
      * P2 + P3: Multi-Query 搜索 + 合并去重
      *
      * 对每个 query 执行搜索（并行），合并结果并按 score 去重保留最高分。
-     * @private
      */
     async _multiQuerySearch(queries, options) {
         if (queries.length === 0) {
@@ -262,7 +258,6 @@ export class TaskKnowledgeBridge {
     }
     /**
      * 执行单次搜索（含 P3 上下文透传）
-     * @private
      */
     async _singleSearch(query, options) {
         const searchResult = await this._search.search(query, {
@@ -278,7 +273,6 @@ export class TaskKnowledgeBridge {
     }
     /**
      * P4: 相关性阈值判断
-     * @private
      */
     _aboveThreshold(item) {
         const score = item.score || 0;
@@ -286,14 +280,12 @@ export class TaskKnowledgeBridge {
     }
     /**
      * P4: 增强投影 — 使用统一 slimSearchResult() 投影函数
-     * @private
      */
     _projectItem(item) {
         return slimSearchResult(item);
     }
     /**
      * P6: 缓存键 — 基于 taskQuery + userQuery 的内容指纹
-     * @private
      */
     _contentKey(taskQuery, userQuery) {
         return `${taskQuery}||${userQuery || ''}`;

package/dist/lib/service/task/TaskReadyEngine.d.ts

@@ -15,8 +15,7 @@ export declare class TaskReadyEngine {
     _readyStmt: ReturnType<import('better-sqlite3').Database['prepare']>;
     /** @param db raw SQLite handle */
     constructor(db: import('better-sqlite3').Database);
-    /** @private */
-    _prepareStatements(): void;
+    private _prepareStatements;
     /**
      * 获取就绪任务（核心方法）
      *

package/dist/lib/service/task/TaskReadyEngine.js

@@ -18,7 +18,6 @@ export class TaskReadyEngine {
         this._db = db;
         this._prepareStatements();
     }
-    /** @private */
     _prepareStatements() {
         // ── 核心: 递归 CTE 计算传递性阻塞 ──
         this._readyStmt = this._db.prepare(`

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

@@ -1100,7 +1100,6 @@ export function renderGettingStarted(project, modules, ast, isZh) {
 const BUILD_SYSTEM_FILES = Object.fromEntries(LanguageService.buildSystemMarkers.map((m) => [m.buildTool, m.file]));
 /**
  * 按生态系统输出构建步骤
- * @private
  */
 function _pushBuildSteps(lines, buildSys, projectName, isZh) {
     const { eco, buildTool } = buildSys;

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

@@ -548,7 +548,7 @@ export function profileFolders(projectInfo, options = {}) {
     const root = projectInfo.root;
     const sourceFiles = projectInfo.sourceFiles || [];
     // ── 1. 按文件夹分组源文件 ──
-    /** @type {Map<string, string[]>} relDir → [relFilePath, ...] */
+    /** relDir → [relFilePath, ...] */
     const folderFiles = new Map();
     for (const relFile of sourceFiles) {
         const dir = path.dirname(relFile);
@@ -558,7 +558,7 @@ export function profileFolders(projectInfo, options = {}) {
         folderFiles.get(dir).push(relFile);
     }
     // ── 2. 聚合: 将子文件夹的文件计入父文件夹 (递归) ──
-    /** @type {Map<string, string[]>} relDir → 所有递归子文件 */
+    /** relDir → 所有递归子文件 */
     const folderRecursive = new Map();
     for (const [dir, files] of folderFiles) {
         // 把文件计入 dir 本身及所有祖先
@@ -612,7 +612,6 @@ export function profileFolders(projectInfo, options = {}) {
 }
 /**
  * 修剪冗余文件夹: 如果子目录文件数与父目录接近 (>80%), 仅保留父目录
- * @private
  */
 function _pruneRedundantFolders(candidates, maxFolders) {
     const kept = [];
@@ -649,7 +648,6 @@ function _pruneRedundantFolders(candidates, maxFolders) {
 }
 /**
  * 为单个文件夹构建 FolderProfile
- * @private
  */
 function _buildFolderProfile(relDir, files, depth, projectRoot, sampleLines) {
     const fullDir = path.join(projectRoot, relDir);
@@ -735,7 +733,6 @@ function _buildFolderProfile(relDir, files, depth, projectRoot, sampleLines) {
 }
 /**
  * 从文件名列表检测命名约定
- * @private
  * @param fileNames basename 列表
  */
 function _detectNamingPatterns(fileNames) {
@@ -781,7 +778,6 @@ function _detectNamingPatterns(fileNames) {
 }
 /**
  * 从文件顶部提取 import/require 语句，推断文件夹级依赖
- * @private
  */
 function _extractImports(keyFiles, projectRoot, sampleLines, currentDir) {
     const importTargets = new Set();
@@ -883,7 +879,6 @@ function _extractImports(keyFiles, projectRoot, sampleLines, currentDir) {
 }
 /**
  * 提取文件头部注释 (第一个注释块)
- * @private
  */
 function _extractHeaderComment(fullPath) {
     try {