autosnippet 3.2.18 → 3.2.20

package/dist/lib/service/delivery/CursorDeliveryPipeline.d.ts

@@ -91,12 +91,15 @@ export declare class CursorDeliveryPipeline {
         };
         channelC: {
             synced: number;
+            builtinSynced: number;
+            projectSynced: number;
             skipped: number;
             errors: number;
             details: {
                 synced: string[];
                 skipped: string[];
                 errors: string[];
+                builtinSynced: string[];
             };
         };
         channelD: {
@@ -155,18 +158,15 @@ export declare class CursorDeliveryPipeline {
     }>;
     /**
      * 加载知识条目（active + high-confidence pending）
-     * @private
      */
     _loadEntries(): Promise<KnowledgeEntryProps[]>;
     /**
      * 从 KnowledgeService.list() 返回值提取条目数组
-     * @private
      */
     _extractItems(result: unknown): KnowledgeEntryProps[];
     /**
      * 按 kind 分类知识条目
      * dev-document 类型单独分流，不进入 Channel A/B 压缩
-     * @private
      */
     _classify(entries: KnowledgeEntryProps[]): {
         rules: KnowledgeEntryProps[];
@@ -176,17 +176,14 @@ export declare class CursorDeliveryPipeline {
     };
     /**
      * 排序 — 质量分 + 统计使用量
-     * @private
      */
     _rank(entries: KnowledgeEntryProps[]): KnowledgeEntryProps[];
     /**
      * 计算排名分
-     * @private
      */
     _rankScore(entry: KnowledgeEntryProps): number;
     /**
      * Channel A 生成
-     * @private
      */
     _generateChannelA(rules: KnowledgeEntryProps[]): {
         filePath: string;
@@ -201,7 +198,6 @@ export declare class CursorDeliveryPipeline {
      * Channel B 生成（patterns + facts）
      * @param patterns kind='pattern' 的知识条目
      * @param [facts=[]] kind='fact' 的知识条目
-     * @private
      */
     _generateChannelB(patterns: KnowledgeEntryProps[], facts?: KnowledgeEntryProps[]): {
         topicCount: number;
@@ -217,7 +213,6 @@ export declare class CursorDeliveryPipeline {
     /**
      * Channel B+ — Call Graph Architecture Rules (Phase 5.2)
      * 从调用图拓扑分析架构分层，生成 architecture smart rule
-     * @private
      * @returns |null}
      */
     _generateCallGraphArchitectureRules(): {
@@ -227,28 +222,28 @@ export declare class CursorDeliveryPipeline {
     } | null;
     /**
      * 从文件路径中提取层级目录 (第一或第二级有意义的目录)
-     * @private
      */
     _extractLayerDir(filePath: string): string | null;
     /**
      * Channel C 生成
-     * @private
      */
     _generateChannelC(): Promise<{
         synced: number;
+        builtinSynced: number;
+        projectSynced: number;
         skipped: number;
         errors: number;
         details: {
             synced: string[];
             skipped: string[];
             errors: string[];
+            builtinSynced: string[];
         };
     }>;
     /**
      * Channel D — Dev Documents 生成
      * 将 knowledgeType='dev-document' 的条目以原始 MD 写入
      * .cursor/skills/autosnippet-devdocs/references/ 目录
-     * @private
      */
     _generateChannelD(documents: KnowledgeEntryProps[]): {
         documentsCount: number;
@@ -258,7 +253,6 @@ export declare class CursorDeliveryPipeline {
     /**
      * Channel F — Agent Instructions 生成
      * 生成 AGENTS.md / CLAUDE.md / .github/copilot-instructions.md
-     * @private
      */
     _generateChannelF(rules: KnowledgeEntryProps[], patterns: KnowledgeEntryProps[]): {
         filesWritten: number;
@@ -279,24 +273,20 @@ export declare class CursorDeliveryPipeline {
     };
     /**
      * 文件名安全 slug 化
-     * @private
      */
     _slugify(text: string): string;
     /**
      * 镜像 .cursor/ 交付物料到目标 IDE 目录（Qoder / Trae 等兼容 IDE）
      * 只复制 autosnippet- 前缀的文件/目录，不触碰用户自定义内容
      * @param targetDirName 目标目录名，如 '.qoder' 或 '.trae'
-     * @private
      */
     _mirrorToIDE(targetDirName: string): void;
     /**
      * 递归复制目录
-     * @private
      */
     _copyDirRecursive(src: string, dest: string): void;
     /**
      * 从项目路径推断项目名称
-     * @private
      */
     _inferProjectName(projectRoot: string): string;
 }

package/dist/lib/service/delivery/CursorDeliveryPipeline.js

@@ -88,6 +88,12 @@ export class CursorDeliveryPipeline {
             // ── Channel A: Always-On Rules ──
             const channelA = this._generateChannelA(rules);
             stats.channelA = channelA;
+            // ── Baseline: 零知识库时注入基础引导 ──
+            if (entries.length === 0 && channelA.rulesCount === 0) {
+                const baseline = this.rulesGenerator.writeBaselineRules();
+                stats.channelA = { rulesCount: 0, tokensUsed: baseline.tokensUsed };
+                this.logger.info?.('[CursorDelivery] Baseline rules written (zero knowledge entries)');
+            }
             // ── Channel B: Smart Rules (by topic) + Facts ──
             const channelB = this._generateChannelB(patterns, facts);
             stats.channelB = channelB;
@@ -132,7 +138,6 @@ export class CursorDeliveryPipeline {
     // ─── 内部方法 ───────────────────────────────────────
     /**
      * 加载知识条目（active + high-confidence pending）
-     * @private
      */
     async _loadEntries() {
         const allEntries = [];
@@ -164,7 +169,6 @@ export class CursorDeliveryPipeline {
     }
     /**
      * 从 KnowledgeService.list() 返回值提取条目数组
-     * @private
      */
     _extractItems(result) {
         if (Array.isArray(result)) {
@@ -182,7 +186,6 @@ export class CursorDeliveryPipeline {
     /**
      * 按 kind 分类知识条目
      * dev-document 类型单独分流，不进入 Channel A/B 压缩
-     * @private
      */
     _classify(entries) {
         const rules = [], patterns = [], facts = [], documents = [];
@@ -204,7 +207,6 @@ export class CursorDeliveryPipeline {
     }
     /**
      * 排序 — 质量分 + 统计使用量
-     * @private
      */
     _rank(entries) {
         return [...entries].sort((a, b) => {
@@ -215,7 +217,6 @@ export class CursorDeliveryPipeline {
     }
     /**
      * 计算排名分
-     * @private
      */
     _rankScore(entry) {
         const qual = entry.quality;
@@ -233,7 +234,6 @@ export class CursorDeliveryPipeline {
     }
     /**
      * Channel A 生成
-     * @private
      */
     _generateChannelA(rules) {
         const topRules = this._rank(rules).slice(0, BUDGET.CHANNEL_A_MAX_RULES);
@@ -250,7 +250,6 @@ export class CursorDeliveryPipeline {
      * Channel B 生成（patterns + facts）
      * @param patterns kind='pattern' 的知识条目
      * @param [facts=[]] kind='fact' 的知识条目
-     * @private
      */
     _generateChannelB(patterns, facts = []) {
         const result = { topicCount: 0, patternsCount: 0, factsCount: 0, totalTokens: 0, topics: {} };
@@ -304,7 +303,6 @@ export class CursorDeliveryPipeline {
     /**
      * Channel B+ — Call Graph Architecture Rules (Phase 5.2)
      * 从调用图拓扑分析架构分层，生成 architecture smart rule
-     * @private
      * @returns |null}
      */
     _generateCallGraphArchitectureRules() {
@@ -435,7 +433,6 @@ export class CursorDeliveryPipeline {
     }
     /**
      * 从文件路径中提取层级目录 (第一或第二级有意义的目录)
-     * @private
      */
     _extractLayerDir(filePath) {
         if (!filePath) {
@@ -453,15 +450,17 @@ export class CursorDeliveryPipeline {
     }
     /**
      * Channel C 生成
-     * @private
      */
     async _generateChannelC() {
         try {
             const syncResult = await this.skillsSyncer.sync();
-            this.logger.info?.(`[CursorDelivery] Channel C: ${syncResult.synced.length} synced, ` +
+            this.logger.info?.(`[CursorDelivery] Channel C: ${syncResult.builtinSynced.length} builtin + ` +
+                `${syncResult.synced.length} project synced, ` +
                 `${syncResult.skipped.length} skipped, ${syncResult.errors.length} errors`);
             return {
-                synced: syncResult.synced.length,
+                synced: syncResult.builtinSynced.length + syncResult.synced.length,
+                builtinSynced: syncResult.builtinSynced.length,
+                projectSynced: syncResult.synced.length,
                 skipped: syncResult.skipped.length,
                 errors: syncResult.errors.length,
                 details: syncResult,
@@ -471,9 +470,11 @@ export class CursorDeliveryPipeline {
             this.logger.error?.(`[CursorDelivery] Channel C error: ${err.message}`);
             return {
                 synced: 0,
+                builtinSynced: 0,
+                projectSynced: 0,
                 skipped: 0,
                 errors: 1,
-                details: { synced: [], skipped: [], errors: [err.message] },
+                details: { synced: [], skipped: [], builtinSynced: [], errors: [err.message] },
             };
         }
     }
@@ -481,7 +482,6 @@ export class CursorDeliveryPipeline {
      * Channel D — Dev Documents 生成
      * 将 knowledgeType='dev-document' 的条目以原始 MD 写入
      * .cursor/skills/autosnippet-devdocs/references/ 目录
-     * @private
      */
     _generateChannelD(documents) {
         const result = { documentsCount: 0, filesWritten: 0, filePaths: [] };
@@ -554,7 +554,6 @@ export class CursorDeliveryPipeline {
     /**
      * Channel F — Agent Instructions 生成
      * 生成 AGENTS.md / CLAUDE.md / .github/copilot-instructions.md
-     * @private
      */
     _generateChannelF(rules, patterns) {
         try {
@@ -594,7 +593,6 @@ export class CursorDeliveryPipeline {
     }
     /**
      * 文件名安全 slug 化
-     * @private
      */
     _slugify(text) {
         return (text
@@ -607,7 +605,6 @@ export class CursorDeliveryPipeline {
      * 镜像 .cursor/ 交付物料到目标 IDE 目录（Qoder / Trae 等兼容 IDE）
      * 只复制 autosnippet- 前缀的文件/目录，不触碰用户自定义内容
      * @param targetDirName 目标目录名，如 '.qoder' 或 '.trae'
-     * @private
      */
     _mirrorToIDE(targetDirName) {
         try {
@@ -650,7 +647,6 @@ export class CursorDeliveryPipeline {
     }
     /**
      * 递归复制目录
-     * @private
      */
     _copyDirRecursive(src, dest) {
         fs.mkdirSync(dest, { recursive: true });
@@ -667,7 +663,6 @@ export class CursorDeliveryPipeline {
     }
     /**
      * 从项目路径推断项目名称
-     * @private
      */
     _inferProjectName(projectRoot) {
         return path.basename(projectRoot);

package/dist/lib/service/delivery/KnowledgeCompressor.d.ts

@@ -65,7 +65,7 @@ export declare class KnowledgeCompressor {
     }[];
     /**
      * 将 Fact 压缩结果格式化为 Markdown 字符串
-     * @param {Array<{ title: string, summary: string }>} factLines
+     * @param factLines
      */
     formatFactLines(factLines: Array<{
         title: string;

package/dist/lib/service/delivery/KnowledgeCompressor.js

@@ -144,7 +144,7 @@ export class KnowledgeCompressor {
     }
     /**
      * 将 Fact 压缩结果格式化为 Markdown 字符串
-     * @param {Array<{ title: string, summary: string }>} factLines
+     * @param factLines
      */
     formatFactLines(factLines) {
         if (factLines.length === 0) {

package/dist/lib/service/delivery/RulesGenerator.d.ts

@@ -42,11 +42,18 @@ export declare class RulesGenerator {
      * 保留静态模板文件（autosnippet-conventions.mdc, autosnippet-skills.mdc）
      */
     cleanDynamicFiles(): void;
-    /** @private */
     _renderChannelA(ruleLines: string[]): string;
-    /** @private */
     _renderChannelB(topic: string, body: string, description: string): string;
-    /** @private */
+    /**
+     * Baseline Rules — 零知识库时写入基础引导文件
+     * 告知 Agent 可用的 MCP 工具和推荐工作流
+     */
+    writeBaselineRules(): {
+        filePath: string;
+        tokensUsed: number;
+        rulesCount: number;
+    };
+    _renderBaseline(): string;
     _ensureDir(): void;
 }
 export default RulesGenerator;

package/dist/lib/service/delivery/RulesGenerator.js

@@ -108,7 +108,6 @@ export class RulesGenerator {
         }
     }
     // ─── 渲染方法 ───────────────────────────────────────
-    /** @private */
     _renderChannelA(ruleLines) {
         const desc = `${this.projectName} mandatory rules — coding constraints that must never be violated. Auto-generated by AutoSnippet.`;
         const lines = [
@@ -127,7 +126,6 @@ export class RulesGenerator {
         ];
         return `${lines.join('\n')}\n`;
     }
-    /** @private */
     _renderChannelB(topic, body, description) {
         const topicLabel = topic.charAt(0).toUpperCase() + topic.slice(1);
         const lines = [
@@ -144,7 +142,49 @@ export class RulesGenerator {
         ];
         return `${lines.join('\n')}\n`;
     }
-    /** @private */
+    /**
+     * Baseline Rules — 零知识库时写入基础引导文件
+     * 告知 Agent 可用的 MCP 工具和推荐工作流
+     */
+    writeBaselineRules() {
+        this._ensureDir();
+        const content = this._renderBaseline();
+        const filePath = path.join(this.rulesDir, 'autosnippet-project-rules.mdc');
+        fs.writeFileSync(filePath, content, 'utf8');
+        return {
+            filePath,
+            tokensUsed: estimateTokens(content),
+            rulesCount: 0,
+        };
+    }
+    _renderBaseline() {
+        const lines = [
+            '---',
+            `description: "${this.projectName} — AutoSnippet baseline guidance. Available MCP tools and recommended workflows."`,
+            'alwaysApply: true',
+            '---',
+            '',
+            `# ${this.projectName} — AutoSnippet Baseline`,
+            '',
+            'This project has AutoSnippet enabled but no knowledge entries yet.',
+            'Use the following MCP tools to build and query the knowledge base:',
+            '',
+            '## Available MCP Tools',
+            '',
+            '- `autosnippet_bootstrap` — Cold-start: analyze the project and generate initial knowledge entries',
+            '- `autosnippet_search({ query })` — Search knowledge base (BM25 + semantic)',
+            '- `autosnippet_create_recipe` — Create a new coding recipe from current context',
+            '- `autosnippet_guard` — Run compliance review on current changes',
+            '- `autosnippet_task_start` / `autosnippet_task_close` — Track coding tasks with automatic knowledge capture',
+            '',
+            '## Recommended First Steps',
+            '',
+            '1. Run `autosnippet_bootstrap` to analyze the codebase and generate initial recipes',
+            '2. Use `autosnippet_search` to query knowledge while coding',
+            '3. Run `autosnippet_guard` before committing to check compliance',
+        ];
+        return `${lines.join('\n')}\n`;
+    }
     _ensureDir() {
         if (!fs.existsSync(this.rulesDir)) {
             fs.mkdirSync(this.rulesDir, { recursive: true });

package/dist/lib/service/delivery/SkillsSyncer.d.ts

@@ -1,10 +1,12 @@
 /**
  * SkillsSyncer — AutoSnippet Skills to .cursor/skills/ 同步器
  *
- * Channel C: 将 AutoSnippet/skills/ 下的项目级 SKILL.md 同步到
- * .cursor/skills/autosnippet-{name}/ 目录，适配 Cursor Agent Skills 标准格式。
+ * Channel C: 将内置 Skills 和项目级 Skills 统一同步到
+ * .cursor/skills/ 目录，适配 Cursor Agent Skills 标准格式。
  *
- * 同时为每个 Skill 生成 references/RECIPES.md（相关 Recipe 摘要）。
+ * - 内置 Skills：从 AutoSnippet 包 skills/ 目录直接复制（autosnippet-create 等）
+ * - 项目级 Skills：从 AutoSnippet/skills/ 转换格式后写入（project-* → autosnippet-*）
+ * - 同时为项目级 Skill 生成 references/RECIPES.md（相关 Recipe 摘要）
  */
 export declare class SkillsSyncer {
     knowledgeService: {
@@ -36,23 +38,35 @@ export declare class SkillsSyncer {
         synced: string[];
         skipped: string[];
         errors: string[];
+        builtinSynced: string[];
     }>;
+    /**
+     * 同步内置 Skills：从 AutoSnippet 包 skills/ 目录直接复制到 .cursor/skills/
+     */
+    _syncBuiltinSkills(result: {
+        builtinSynced: string[];
+        errors: string[];
+    }): void;
+    /**
+     * 同步项目级 Skills：从 AutoSnippet/skills/ 转换格式后写入 .cursor/skills/
+     */
+    _syncProjectSkills(result: {
+        synced: string[];
+        skipped: string[];
+        errors: string[];
+    }): Promise<void>;
     /**
      * 转换 SKILL.md 格式 — 从 AutoSnippet 格式到 Cursor Agent Skills 标准
-     * @private
      */
     _convertSkillMd(source: string, targetName: string, sourceDirName: string): string;
     /**
      * 生成 references/RECIPES.md
-     * @private
      */
     _generateRecipes(targetSkillDir: string, sourceDirName: string): Promise<void>;
     /**
      * 生成使用场景列表
-     * @private
      */
     _generateUseCases(sourceDirName: string): string[];
-    /** @private */
     _capitalizeWords(str: string): string;
 }
 export default SkillsSyncer;

package/dist/lib/service/delivery/SkillsSyncer.js

@@ -1,14 +1,17 @@
 /**
  * SkillsSyncer — AutoSnippet Skills to .cursor/skills/ 同步器
  *
- * Channel C: 将 AutoSnippet/skills/ 下的项目级 SKILL.md 同步到
- * .cursor/skills/autosnippet-{name}/ 目录，适配 Cursor Agent Skills 标准格式。
+ * Channel C: 将内置 Skills 和项目级 Skills 统一同步到
+ * .cursor/skills/ 目录，适配 Cursor Agent Skills 标准格式。
  *
- * 同时为每个 Skill 生成 references/RECIPES.md（相关 Recipe 摘要）。
+ * - 内置 Skills：从 AutoSnippet 包 skills/ 目录直接复制（autosnippet-create 等）
+ * - 项目级 Skills：从 AutoSnippet/skills/ 转换格式后写入（project-* → autosnippet-*）
+ * - 同时为项目级 Skill 生成 references/RECIPES.md（相关 Recipe 摘要）
  */
 import fs from 'node:fs';
 import path from 'node:path';
 import { DEFAULT_KNOWLEDGE_BASE_DIR } from '../../shared/ProjectMarkers.js';
+import { SKILLS_DIR as BUILTIN_SKILLS_DIR } from '../../shared/package-root.js';
 /**
  * 技能名称映射：AutoSnippet/skills/ → .cursor/skills/
  * AutoSnippet/skills/ 下面是 bootstrap 动态生成的项目级 skills，
@@ -70,10 +73,48 @@ export class SkillsSyncer {
      * @returns >}
      */
     async sync() {
-        const result = { synced: [], skipped: [], errors: [] };
+        const result = {
+            synced: [],
+            skipped: [],
+            errors: [],
+            builtinSynced: [],
+        };
+        // ── Phase 1: 同步内置 Skills ──
+        this._syncBuiltinSkills(result);
+        // ── Phase 2: 同步项目级 Skills ──
+        await this._syncProjectSkills(result);
+        return result;
+    }
+    /**
+     * 同步内置 Skills：从 AutoSnippet 包 skills/ 目录直接复制到 .cursor/skills/
+     */
+    _syncBuiltinSkills(result) {
+        if (!fs.existsSync(BUILTIN_SKILLS_DIR)) {
+            return;
+        }
+        const builtinDirs = fs
+            .readdirSync(BUILTIN_SKILLS_DIR, { withFileTypes: true })
+            .filter((d) => d.isDirectory())
+            .map((d) => d.name);
+        for (const name of builtinDirs) {
+            try {
+                const src = path.join(BUILTIN_SKILLS_DIR, name);
+                const dest = path.join(this.targetDir, name);
+                fs.cpSync(src, dest, { recursive: true, force: true });
+                result.builtinSynced.push(name);
+            }
+            catch (err) {
+                result.errors.push(`builtin/${name}: ${err.message}`);
+            }
+        }
+    }
+    /**
+     * 同步项目级 Skills：从 AutoSnippet/skills/ 转换格式后写入 .cursor/skills/
+     */
+    async _syncProjectSkills(result) {
         // 检查源目录是否存在
         if (!fs.existsSync(this.sourceDir)) {
-            return result;
+            return;
         }
         // 扫描源目录
         const skillDirs = fs
@@ -106,11 +147,9 @@ export class SkillsSyncer {
                 result.errors.push(`${dirName}: ${err.message}`);
             }
         }
-        return result;
     }
     /**
      * 转换 SKILL.md 格式 — 从 AutoSnippet 格式到 Cursor Agent Skills 标准
-     * @private
      */
     _convertSkillMd(source, targetName, sourceDirName) {
         // 提取原始内容（去掉 frontmatter）
@@ -150,7 +189,6 @@ export class SkillsSyncer {
     }
     /**
      * 生成 references/RECIPES.md
-     * @private
      */
     async _generateRecipes(targetSkillDir, sourceDirName) {
         const refsDir = path.join(targetSkillDir, 'references');
@@ -201,7 +239,6 @@ export class SkillsSyncer {
     }
     /**
      * 生成使用场景列表
-     * @private
      */
     _generateUseCases(sourceDirName) {
         const casesMap = {
@@ -275,7 +312,6 @@ export class SkillsSyncer {
             '- Need guidance on project-specific patterns',
         ]);
     }
-    /** @private */
     _capitalizeWords(str) {
         return str.replace(/\b\w/g, (c) => c.toUpperCase());
     }

package/dist/lib/service/delivery/TopicClassifier.d.ts

@@ -25,15 +25,12 @@ export declare class TopicClassifier {
     buildDescription(topic: string, entries: KnowledgeEntryProps[]): string;
     /**
      * 分类单个 entry 到主题 — 直读 AI 预计算的 topicHint
-     * @private
      */
-    _classifyEntry(entry: KnowledgeEntryProps): string | null;
+    private _classifyEntry;
     /**
      * 从 entry 提取关键词
-     * @private
      */
-    _extractKeywords(entry: KnowledgeEntryProps): string[];
-    /** @private */
-    _topicLabel(topic: string): string;
+    private _extractKeywords;
+    private _topicLabel;
 }
 export default TopicClassifier;

package/dist/lib/service/delivery/TopicClassifier.js

@@ -99,14 +99,12 @@ export class TopicClassifier {
     }
     /**
      * 分类单个 entry 到主题 — 直读 AI 预计算的 topicHint
-     * @private
      */
     _classifyEntry(entry) {
         return entry.topicHint || null; // AI 没给 → null → 归入 general
     }
     /**
      * 从 entry 提取关键词
-     * @private
      */
     _extractKeywords(entry) {
         const text = `${entry.title || ''} ${entry.description || ''}`;
@@ -115,7 +113,6 @@ export class TopicClassifier {
         const filtered = words.map((w) => w.toLowerCase()).filter((w) => !STOP_WORDS.has(w));
         return [...new Set(filtered)].slice(0, 5);
     }
-    /** @private */
     _topicLabel(topic) {
         const labels = {
             networking: 'Networking',

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

@@ -47,7 +47,7 @@ export declare class ExclusionManager {
     });
     /**
      * 添加路径排除 (glob 或精确路径)
-     * @param {{ reason?: string }} meta
+     * @param meta
      */
     addPathExclusion(pattern: string, meta?: ExclusionMeta): void;
     /** 检查文件路径是否被排除 */

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

@@ -22,7 +22,7 @@ export class ExclusionManager {
     // ─── Path 排除 ───────────────────────────────────────
     /**
      * 添加路径排除 (glob 或精确路径)
-     * @param {{ reason?: string }} meta
+     * @param meta
      */
     addPathExclusion(pattern, meta = {}) {
         if (!pattern) {

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

@@ -113,7 +113,7 @@ export declare 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: ExternalRuleInput[]): void;
     /** EP 注入幂等标记 — 调用者可用此判断是否已完成注入，避免重复加载 EnhancementRegistry */
@@ -159,7 +159,7 @@ export declare class GuardCheckEngine {
     _getAstAnalyzer(): typeof AstAnalyzerModule;
     /**
      * 将 Guard 命中计数回写到对应 Recipe 的 guard_hit_count
-     * @param {Array<{ruleId: string}>} violations
+     * @param violations
      */
     trackGuardHits(violations: GuardViolation[]): void;
     /**
@@ -173,7 +173,7 @@ export declare class GuardCheckEngine {
     }): AuditFileResult;
     /**
      * 批量文件审计
-     * @param {Array<{path: string, content: string}>} files
+     * @param files
      * @param options {scope: 'file'|'target'|'project'}
      * @returns }
      */