@xfe-repo/cli-plugin-ai-rules 2.0.0

package/dist/mcp-writer.js

@@ -0,0 +1,131 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - MCP 配置写入
+ *
+ * 将 MCP 服务器配置写入各 IDE 的 MCP 配置文件
+ * 支持 VS Code (.vscode/mcp.json)、Cursor (.cursor/mcp.json)、Claude Code (.mcp.json)
+ *
+ * xfe 管理的 server key 使用 `xfe--` 前缀，与用户手动配置隔离
+ */
+import { existsSync } from 'node:fs';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { getTarget } from './targets.js';
+// ─── Constants ──────
+const XFE_SERVER_PREFIX = 'xfe--';
+// ─── Public ──────
+/**
+ * 将静态 + 动态 MCP 服务器配置写入各 IDE 的 MCP 配置文件
+ *
+ * - 静态条目：源仓库 mcp.json 中用户选中的 servers
+ * - 动态注入：其他插件通过 mcpInjections 注册的 servers（如 xfe-cli-mcp）
+ * - 保留用户手动添加的 servers（无 xfe-- 前缀的 key）
+ */
+export async function applyMcpConfigs(ctx, config, staticEntries, mcpInjections) {
+    const xfeServers = buildXfeServerMap(staticEntries, mcpInjections);
+    const targets = collectMcpTargets(config);
+    let written = 0;
+    for (const target of targets) {
+        const didWrite = await writeTargetMcpConfig(ctx.projectRoot, target, xfeServers);
+        if (didWrite)
+            written++;
+    }
+    return { written, removed: 0 };
+}
+/**
+ * 清理所有 IDE MCP 配置文件中 xfe 管理的条目
+ */
+export async function cleanMcpConfigs(ctx, config) {
+    const targets = collectMcpTargets(config);
+    let removed = 0;
+    for (const target of targets) {
+        const didClean = await cleanTargetMcpConfig(ctx.projectRoot, target);
+        if (didClean)
+            removed++;
+    }
+    return { written: 0, removed };
+}
+// ─── Target 写入 ──────
+async function writeTargetMcpConfig(projectRoot, target, xfeServers) {
+    if (!target.mcpConfigPath)
+        return false;
+    const absPath = path.join(projectRoot, target.mcpConfigPath);
+    const existing = await readMcpConfigFile(absPath);
+    const serverKey = target.mcpServerKey;
+    const currentServers = (existing[serverKey] ?? {});
+    const userServers = filterUserServers(currentServers);
+    const merged = { ...userServers, ...xfeServers };
+    if (Object.keys(merged).length === 0 && !existsSync(absPath))
+        return false;
+    const output = { ...existing, [serverKey]: merged };
+    await mkdir(path.dirname(absPath), { recursive: true });
+    await writeFile(absPath, JSON.stringify(output, null, 2) + '\n', 'utf-8');
+    return true;
+}
+async function cleanTargetMcpConfig(projectRoot, target) {
+    if (!target.mcpConfigPath)
+        return false;
+    const absPath = path.join(projectRoot, target.mcpConfigPath);
+    if (!existsSync(absPath))
+        return false;
+    const existing = await readMcpConfigFile(absPath);
+    const serverKey = target.mcpServerKey;
+    const currentServers = (existing[serverKey] ?? {});
+    const userServers = filterUserServers(currentServers);
+    if (Object.keys(userServers).length === 0) {
+        const { [serverKey]: _, ...rest } = existing;
+        if (Object.keys(rest).length === 0) {
+            const { unlink } = await import('node:fs/promises');
+            await unlink(absPath);
+        }
+        else {
+            await writeFile(absPath, JSON.stringify(rest, null, 2) + '\n', 'utf-8');
+        }
+    }
+    else {
+        await writeFile(absPath, JSON.stringify({ ...existing, [serverKey]: userServers }, null, 2) + '\n', 'utf-8');
+    }
+    return true;
+}
+// ─── Helpers ──────
+function buildXfeServerMap(staticEntries, mcpInjections) {
+    const result = {};
+    for (const entry of staticEntries) {
+        result[`${XFE_SERVER_PREFIX}${entry.id}`] = entry.config;
+    }
+    for (const entries of mcpInjections.values()) {
+        for (const entry of entries) {
+            result[`${XFE_SERVER_PREFIX}${entry.id}`] = entry.config;
+        }
+    }
+    return result;
+}
+function collectMcpTargets(config) {
+    const targets = [];
+    for (const targetId of config.targets) {
+        const target = getTarget(targetId);
+        if (target?.mcpConfigPath)
+            targets.push(target);
+    }
+    return targets;
+}
+function filterUserServers(servers) {
+    const result = {};
+    for (const [key, value] of Object.entries(servers)) {
+        if (!key.startsWith(XFE_SERVER_PREFIX)) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+async function readMcpConfigFile(absPath) {
+    if (!existsSync(absPath))
+        return {};
+    try {
+        const raw = await readFile(absPath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=mcp-writer.js.map

package/dist/mcp-writer.js.map

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

package/dist/merge.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - 标记段落合并
+ *
+ * 管理共享文件中的标记区域，保留用户手写内容
+ */
+import type { SyncItem } from './types.js';
+/**
+ * 将多个 SyncItem 合并到文件内容中
+ *
+ * - 标记块外的用户内容完全保留
+ * - 标记块内按 section 替换
+ */
+export declare function mergeMarkedSections(existingContent: string, items: SyncItem[]): string;
+//# sourceMappingURL=merge.d.ts.map

package/dist/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAY1C;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAQtF"}

package/dist/merge.js

@@ -0,0 +1,35 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - 标记段落合并
+ *
+ * 管理共享文件中的标记区域，保留用户手写内容
+ */
+import { spliceMarkerBlock } from './injection.js';
+// ─── Constants ──────
+const MARKER_BEGIN = '<!-- xfe:ai-rules:begin -->';
+const MARKER_END = '<!-- xfe:ai-rules:end -->';
+const SECTION_PREFIX = '<!-- xfe:section:';
+const SECTION_SUFFIX = ' -->';
+// ─── Public ──────
+/**
+ * 将多个 SyncItem 合并到文件内容中
+ *
+ * - 标记块外的用户内容完全保留
+ * - 标记块内按 section 替换
+ */
+export function mergeMarkedSections(existingContent, items) {
+    if (items.length === 0)
+        return existingContent;
+    const managedBlock = buildManagedBlock(items);
+    if (!existingContent.trim())
+        return managedBlock + '\n';
+    return spliceMarkerBlock(existingContent, MARKER_BEGIN, MARKER_END, managedBlock);
+}
+// ─── Helpers ──────
+function buildManagedBlock(items) {
+    const sections = items.map((item) => {
+        const sectionMarker = `${SECTION_PREFIX}${item.id}${SECTION_SUFFIX}`;
+        return `${sectionMarker}\n## ${item.name}\n\n${item.content}`;
+    });
+    return [MARKER_BEGIN, '', ...sections, '', MARKER_END].join('\n');
+}
+//# sourceMappingURL=merge.js.map

package/dist/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAElD,uBAAuB;AAEvB,MAAM,YAAY,GAAG,6BAA6B,CAAA;AAClD,MAAM,UAAU,GAAG,2BAA2B,CAAA;AAC9C,MAAM,cAAc,GAAG,mBAAmB,CAAA;AAC1C,MAAM,cAAc,GAAG,MAAM,CAAA;AAE7B,oBAAoB;AAEpB;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,eAAuB,EAAE,KAAiB;IAC5E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,eAAe,CAAA;IAE9C,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;IAE7C,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE;QAAE,OAAO,YAAY,GAAG,IAAI,CAAA;IAEvD,OAAO,iBAAiB,CAAC,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,CAAC,CAAA;AACnF,CAAC;AAED,qBAAqB;AAErB,SAAS,iBAAiB,CAAC,KAAiB;IAC1C,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAClC,MAAM,aAAa,GAAG,GAAG,cAAc,GAAG,IAAI,CAAC,EAAE,GAAG,cAAc,EAAE,CAAA;QAEpE,OAAO,GAAG,aAAa,QAAQ,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,OAAO,EAAE,CAAA;IAC/D,CAAC,CAAC,CAAA;IAEF,OAAO,CAAC,YAAY,EAAE,EAAE,EAAE,GAAG,QAAQ,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACnE,CAAC"}

package/dist/pipeline.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - 同步管道
+ *
+ * 四步管道: planSync → detectConflicts → resolveConflicts → executePlan
+ * 前两步为纯函数 / 只读 IO，后两步为交互 + 写 IO
+ * applyInjections 为独立路径，供外部插件即时注入使用
+ */
+import type { PluginContext } from '@xfe-repo/cli-core';
+import type { AiConfig, ApplyResult, InjectionRegistry, SyncPlan, SyncResult, SyncEntry } from './types.js';
+export declare function planSync(config: AiConfig, items: SyncEntry[], injections?: InjectionRegistry): SyncPlan;
+export declare function detectConflicts(plan: SyncPlan, projectRoot: string, lastHashes: Record<string, string>): Promise<SyncPlan>;
+export declare function resolveConflicts(plan: SyncPlan, ctx: PluginContext): Promise<SyncPlan>;
+export declare function executePlan(plan: SyncPlan, projectRoot: string): Promise<SyncResult>;
+export declare function checkSyncStatus(ctx: PluginContext, config: AiConfig): Promise<boolean>;
+export declare function applyInjections(ctx: PluginContext, config: AiConfig, injections: InjectionRegistry): Promise<ApplyResult>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGvD,OAAO,KAAK,EACV,QAAQ,EAER,WAAW,EACX,iBAAiB,EAGjB,QAAQ,EACR,UAAU,EACV,SAAS,EACV,MAAM,YAAY,CAAA;AAuBnB,wBAAgB,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,QAAQ,CAmBvG;AAID,wBAAsB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAmBhI;AAID,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,CAgC5F;AAID,wBAAsB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAiC1F;AAID,wBAAsB,eAAe,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CA0B5F;AAID,wBAAsB,eAAe,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAkB/H"}

package/dist/pipeline.js

@@ -0,0 +1,165 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - 同步管道
+ *
+ * 四步管道: planSync → detectConflicts → resolveConflicts → executePlan
+ * 前两步为纯函数 / 只读 IO，后两步为交互 + 写 IO
+ * applyInjections 为独立路径，供外部插件即时注入使用
+ */
+import { existsSync } from 'node:fs';
+import { readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { getTarget } from './targets.js';
+import { getCachePath, hasCachedRepo } from './repo-cache.js';
+import { computeHash, spliceMarkerBlock } from './formats/shared.js';
+import { planMarkdownFiles, detectMarkdownConflict, writeMarkdownFile, patchMarkdownInjections, getMarkdownGitignore, stripInjectedSections, removeStaleInjectedFiles, } from './formats/agent-md.js';
+import { planMcpJsonFiles, writeMcpJsonFile, patchMcpJsonInjections, getMcpJsonGitignore } from './formats/mcp-json.js';
+import { planSkillDirs, writeSkillDir, patchSkillDirInjections } from './formats/skill-dir.js';
+// ─── Constants ──────
+const GITIGNORE_BLOCK_START = '# xfe-ai-rules (auto-generated, do not edit)';
+const GITIGNORE_BLOCK_END = '# end xfe-ai-rules';
+// ─── Pipeline Step 1: Plan ──────
+export function planSync(config, items, injections) {
+    const files = [];
+    const skillDirs = [];
+    const gitignoreEntries = new Set();
+    for (const targetId of config.targets) {
+        const target = getTarget(targetId);
+        if (!target)
+            continue;
+        files.push(...planMarkdownFiles(target, items, injections));
+        files.push(...planMcpJsonFiles(target, items, injections));
+        skillDirs.push(...planSkillDirs(target, items));
+        getMarkdownGitignore(target).forEach((e) => gitignoreEntries.add(e));
+        getMcpJsonGitignore(target).forEach((e) => gitignoreEntries.add(e));
+    }
+    return { files, skillDirs, gitignoreEntries: [...gitignoreEntries] };
+}
+// ─── Pipeline Step 2: Detect Conflicts ──────
+export async function detectConflicts(plan, projectRoot, lastHashes) {
+    const updatedFiles = [];
+    for (const file of plan.files) {
+        if (file.source !== 'sync') {
+            updatedFiles.push(file);
+            continue;
+        }
+        // MCP JSON 使用前缀隔离，不做冲突检测
+        if (file.format === 'mcp-json') {
+            updatedFiles.push(file);
+            continue;
+        }
+        updatedFiles.push(await detectMarkdownConflict(file, projectRoot, lastHashes));
+    }
+    return { ...plan, files: updatedFiles };
+}
+// ─── Pipeline Step 3: Resolve Conflicts ──────
+export async function resolveConflicts(plan, ctx) {
+    const updatedFiles = [];
+    for (const file of plan.files) {
+        if (file.action !== 'conflict') {
+            updatedFiles.push(file);
+            continue;
+        }
+        const prefilledAction = ctx.prefilled?.conflictAction;
+        let action;
+        if (prefilledAction === 'overwrite' || prefilledAction === 'skip') {
+            action = prefilledAction === 'overwrite' ? 'write' : 'skip';
+        }
+        else {
+            const { conflictAction } = await ctx.prompt.ask({
+                type: 'list',
+                name: 'conflictAction',
+                message: `文件 ${file.relativePath} 已被本地修改，如何处理？`,
+                choices: [
+                    { name: '覆盖（使用远程版本）', value: 'overwrite' },
+                    { name: '跳过（保留本地版本）', value: 'skip' },
+                ],
+            });
+            action = conflictAction === 'overwrite' ? 'write' : 'skip';
+        }
+        updatedFiles.push({ ...file, action });
+    }
+    return { ...plan, files: updatedFiles };
+}
+// ─── Pipeline Step 4: Execute ──────
+export async function executePlan(plan, projectRoot) {
+    let written = 0;
+    let skipped = 0;
+    const fileHashes = {};
+    const injectedHashes = {};
+    const skillDirPaths = [];
+    for (const file of plan.files) {
+        if (file.action === 'skip') {
+            skipped++;
+            continue;
+        }
+        const hash = file.format === 'mcp-json' ? await writeMcpJsonFile(file, projectRoot) : await writeMarkdownFile(file, projectRoot);
+        written++;
+        if (file.source === 'sync') {
+            fileHashes[file.relativePath] = hash;
+        }
+        else {
+            injectedHashes[file.relativePath] = hash;
+        }
+    }
+    for (const skillDir of plan.skillDirs) {
+        await writeSkillDir(skillDir, projectRoot);
+        skillDirPaths.push(skillDir.targetDir);
+        written++;
+    }
+    await updateGitignore(projectRoot, plan.gitignoreEntries);
+    return { written, skipped, fileHashes, injectedHashes, skillDirPaths };
+}
+// ─── Sync Status Check ──────
+export async function checkSyncStatus(ctx, config) {
+    const storeState = (ctx.store.getState()['ai-rules'] ?? {});
+    if (!storeState.lastSyncTime)
+        return false;
+    if (!hasCachedRepo(config.source))
+        return false;
+    const git = ctx.inject('git');
+    const cachePath = getCachePath(config.source);
+    await git.pull(ctx, { cwd: cachePath });
+    if ((await git.latestHash({ cwd: cachePath })) !== storeState.lastRemoteHash)
+        return false;
+    const lastHashes = storeState.lastSyncHash ?? {};
+    for (const [relativePath, expectedHash] of Object.entries(lastHashes)) {
+        const absPath = path.join(ctx.projectRoot, relativePath);
+        if (!existsSync(absPath))
+            return false;
+        const content = await readFile(absPath, 'utf-8');
+        if (computeHash(stripInjectedSections(content)) !== expectedHash)
+            return false;
+    }
+    return true;
+}
+// ─── Standalone Injection ──────
+export async function applyInjections(ctx, config, injections) {
+    const mdResult = await patchMarkdownInjections(config, ctx.projectRoot, injections);
+    const mcpResult = await patchMcpJsonInjections(config, ctx.projectRoot, injections);
+    const skillResult = await patchSkillDirInjections(config, ctx.projectRoot, injections);
+    const written = mdResult.written + mcpResult.written + skillResult.written;
+    const removed = mdResult.removed + mcpResult.removed;
+    const allHashes = { ...mdResult.hashes, ...mcpResult.hashes };
+    // 删除历史注入独立文件
+    const storeState = (ctx.store.getState()['ai-rules'] ?? {});
+    const prevPaths = new Set(Object.keys(storeState.lastInjectedHash ?? {}));
+    const currentPaths = new Set(Object.keys(allHashes));
+    const staleRemoved = await removeStaleInjectedFiles(ctx.projectRoot, prevPaths, currentPaths);
+    ctx.store.setPluginState('ai-rules', { ...storeState, lastInjectedHash: allHashes });
+    return { written, removed: removed + staleRemoved };
+}
+// ─── .gitignore ──────
+async function updateGitignore(projectRoot, entries) {
+    if (entries.length === 0)
+        return;
+    const gitignorePath = path.join(projectRoot, '.gitignore');
+    const newBlock = [GITIGNORE_BLOCK_START, ...entries, GITIGNORE_BLOCK_END].join('\n');
+    if (!existsSync(gitignorePath)) {
+        await writeFile(gitignorePath, newBlock + '\n', 'utf-8');
+        return;
+    }
+    const content = await readFile(gitignorePath, 'utf-8');
+    const updated = spliceMarkerBlock(content, GITIGNORE_BLOCK_START, GITIGNORE_BLOCK_END, newBlock);
+    await writeFile(gitignorePath, updated, 'utf-8');
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/pipeline.js.map

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

package/dist/pipeline.new.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - 同步管道
+ *
+ * 声明式四步管道: planSync → detectConflicts → resolveConflicts → executePlan
+ * 前两步为纯函数 / 只读 IO，后两步为交互 + 写 IO
+ *
+ * 管道为纯编排层，格式相关逻辑委派给 Writer 实现（MarkdownWriter / McpJsonWriter）
+ * applyInjections 为独立路径，供外部插件即时注入使用
+ */
+export {};
+//# sourceMappingURL=pipeline.new.d.ts.map

package/dist/pipeline.new.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.new.d.ts","sourceRoot":"","sources":["../src/pipeline.new.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/pipeline.new.js

@@ -0,0 +1,11 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - 同步管道
+ *
+ * 声明式四步管道: planSync → detectConflicts → resolveConflicts → executePlan
+ * 前两步为纯函数 / 只读 IO，后两步为交互 + 写 IO
+ *
+ * 管道为纯编排层，格式相关逻辑委派给 Writer 实现（MarkdownWriter / McpJsonWriter）
+ * applyInjections 为独立路径，供外部插件即时注入使用
+ */
+export {};
+//# sourceMappingURL=pipeline.new.js.map

package/dist/pipeline.new.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.new.js","sourceRoot":"","sources":["../src/pipeline.new.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/repo-cache.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - 仓库缓存管理
+ *
+ * 管理远程 Git 仓库的本地缓存
+ * 缓存在 ~/.xfe/ai-rules-cache/<url-hash>/ 下，全局共享
+ */
+import type { PluginContext } from '@xfe-repo/cli-core';
+import type { GitCapability } from '@xfe-repo/cli-plugin-git';
+import type { AiConfig } from './types.js';
+/**
+ * 获取或更新远程仓库的本地缓存，返回缓存目录路径
+ *
+ * 首次访问时 clone，后续访问时 pull 更新
+ */
+export declare function fetchCachedRepo(ctx: PluginContext, git: GitCapability, config: AiConfig): Promise<string>;
+/**
+ * 获取缓存路径（不触发 clone/pull）
+ */
+export declare function getCachePath(source: string): string;
+/**
+ * 检查缓存是否已存在
+ */
+export declare function hasCachedRepo(source: string): boolean;
+//# sourceMappingURL=repo-cache.d.ts.map

package/dist/repo-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-cache.d.ts","sourceRoot":"","sources":["../src/repo-cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAE7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAM1C;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB/G;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAInD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAIrD"}

package/dist/repo-cache.js

@@ -0,0 +1,51 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - 仓库缓存管理
+ *
+ * 管理远程 Git 仓库的本地缓存
+ * 缓存在 ~/.xfe/ai-rules-cache/<url-hash>/ 下，全局共享
+ */
+import { createHash } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import path from 'node:path';
+const CACHE_ROOT = path.join(homedir(), '.xfe', 'ai-rules-cache');
+// ─── Public ──────
+/**
+ * 获取或更新远程仓库的本地缓存，返回缓存目录路径
+ *
+ * 首次访问时 clone，后续访问时 pull 更新
+ */
+export async function fetchCachedRepo(ctx, git, config) {
+    const cachePath = getCachePath(config.source);
+    await mkdir(CACHE_ROOT, { recursive: true });
+    const isCloned = existsSync(path.join(cachePath, '.git'));
+    if (!isCloned) {
+        ctx.logger.log(`首次拉取规则仓库: ${config.source}`);
+        const success = await git.clone(ctx, { url: config.source, destination: cachePath });
+        if (!success) {
+            throw new Error(`无法克隆仓库: ${config.source}`);
+        }
+        return cachePath;
+    }
+    const success = await git.pull(ctx, { cwd: cachePath });
+    if (!success) {
+        ctx.logger.warn('远程更新失败，将使用本地缓存');
+    }
+    return cachePath;
+}
+/**
+ * 获取缓存路径（不触发 clone/pull）
+ */
+export function getCachePath(source) {
+    const hash = createHash('sha256').update(source).digest('hex').slice(0, 12);
+    return path.join(CACHE_ROOT, hash);
+}
+/**
+ * 检查缓存是否已存在
+ */
+export function hasCachedRepo(source) {
+    const cachePath = getCachePath(source);
+    return existsSync(path.join(cachePath, '.git'));
+}
+//# sourceMappingURL=repo-cache.js.map

package/dist/repo-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-cache.js","sourceRoot":"","sources":["../src/repo-cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,IAAI,MAAM,WAAW,CAAA;AAO5B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAA;AAEjE,oBAAoB;AAEpB;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAkB,EAAE,GAAkB,EAAE,MAAgB;IAC5F,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAE7C,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAE5C,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAA;IAEzD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;QAC5C,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAA;QAEpF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;QAC7C,CAAC;QAED,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAA;IAEvD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;IACnC,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAE3E,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;IAEtC,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAA;AACjD,CAAC"}

package/dist/scanner.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - 远程仓库扫描
+ *
+ * 扫描 rules/ agents/ skills/ 目录下的 MD 文件和 mcp.json，
+ * 从 YAML frontmatter 中读取元数据
+ */
+import type { AiConfig, SyncEntry } from './types.js';
+/** 扫描缓存目录，返回所有可用条目（MD 文件 + MCP servers） */
+export declare function scanRemoteEntries(cachePath: string): Promise<SyncEntry[]>;
+/** 根据选中 ID 列表加载内容，返回可写入的 SyncItem */
+export declare function loadSelectedItems(cachePath: string, entries: SyncEntry[], selectedIds: Set<string>, config?: AiConfig): Promise<SyncEntry[]>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAWrD,2CAA2C;AAC3C,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA6C/E;AAED,qCAAqC;AACrC,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,SAAS,EAAE,EACpB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EACxB,MAAM,CAAC,EAAE,QAAQ,GAChB,OAAO,CAAC,SAAS,EAAE,CAAC,CAmCtB"}