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

package/dist/block-utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - 标记块工具
+ *
+ * 通用的标记块替换/追加/移除逻辑，统一 merge / gitignore / injection 三处复用
+ */
+/**
+ * 在内容中查找标记块并替换；标记块不存在时追加到末尾
+ *
+ * 不传 replacement 时移除标记块及其周围空白
+ */
+//# sourceMappingURL=block-utils.d.ts.map

package/dist/block-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-utils.d.ts","sourceRoot":"","sources":["../src/block-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;GAIG"}

package/dist/block-utils.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * @xfe-repo/cli-plugin-ai-rules - 标记块工具
+ *
+ * 通用的标记块替换/追加/移除逻辑，统一 merge / gitignore / injection 三处复用
+ */
+// ─── Public ──────
+/**
+ * 在内容中查找标记块并替换；标记块不存在时追加到末尾
+ *
+ * 不传 replacement 时移除标记块及其周围空白
+ */
+//# sourceMappingURL=block-utils.js.map

package/dist/block-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-utils.js","sourceRoot":"","sources":["../src/block-utils.ts"],"names":[],"mappings":";AAAA;;;;GAIG;AAEH,oBAAoB;AAEpB;;;;GAIG"}

package/dist/formats/agent-md.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Markdown 格式模块
+ *
+ * 处理 Markdown 系列文件的同步写入：
+ * - 合并文件（AGENTS.md / CLAUDE.md）：多 item 拼接到同一文件
+ * - 独立文件（.mdc / .instructions.md）：每 item 一个文件
+ * - 注入标记块：动态注入内容用 HTML 注释标记包裹
+ */
+import type { AiConfig, InjectionRegistry, PlannedFile, SyncEntry } from '../types.js';
+import type { TargetConfig } from '../targets.js';
+/**
+ * 将同步项按 target 配置转换为 PlannedFile 列表
+ *
+ * 合并文件：多 item 拼到同一文件；独立文件：每 item 一个文件
+ * 可选注入项追加到合并文件末尾，独立注入项生成独立文件
+ */
+export declare function planMarkdownFiles(target: TargetConfig, items: SyncEntry[], injections?: InjectionRegistry): PlannedFile[];
+export declare function detectMarkdownConflict(file: PlannedFile, projectRoot: string, lastHashes: Record<string, string>): Promise<PlannedFile>;
+export declare function writeMarkdownFile(file: PlannedFile, projectRoot: string): Promise<string>;
+export interface PatchResult {
+    written: number;
+    removed: number;
+    hashes: Record<string, string>;
+}
+/**
+ * 将注入注册表中的 Markdown 内容立即写入已有的目标文件
+ *
+ * 合并文件：在已有内容末尾追加/替换注入块
+ * 独立文件：直接写入
+ */
+export declare function patchMarkdownInjections(config: AiConfig, projectRoot: string, injections: InjectionRegistry): Promise<PatchResult>;
+export declare function getMarkdownGitignore(target: TargetConfig): string[];
+export declare function removeStaleInjectedFiles(projectRoot: string, prevPaths: Set<string>, currentPaths: Set<string>): Promise<number>;
+export declare function stripInjectedSections(content: string): string;
+//# sourceMappingURL=agent-md.d.ts.map

package/dist/formats/agent-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-md.d.ts","sourceRoot":"","sources":["../../src/formats/agent-md.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAGtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAajD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,WAAW,EAAE,CAsCzH;AAID,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,OAAO,CAAC,WAAW,CAAC,CAUtB;AAID,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO/F;AAID,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAwCxI;AAID,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAEnE;AAID,wBAAsB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBtI;AAID,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAY7D"}

package/dist/formats/agent-md.js

@@ -0,0 +1,241 @@
+/**
+ * Markdown 格式模块
+ *
+ * 处理 Markdown 系列文件的同步写入：
+ * - 合并文件（AGENTS.md / CLAUDE.md）：多 item 拼接到同一文件
+ * - 独立文件（.mdc / .instructions.md）：每 item 一个文件
+ * - 注入标记块：动态注入内容用 HTML 注释标记包裹
+ */
+import { existsSync } from 'node:fs';
+import { readFile, writeFile, mkdir, unlink } from 'node:fs/promises';
+import path from 'node:path';
+import { SyncItemType } from '../types.js';
+import { getTarget, isIndividualSlot, resolvePathTemplate, formatOutputFile } from '../targets.js';
+import { computeHash } from './shared.js';
+// ─── Constants ──────
+const INJECTED_BEGIN = '<!-- xfe:injected:begin -->';
+const INJECTED_END = '<!-- xfe:injected:end -->';
+const INJECTED_SOURCE_BEGIN = (source) => `<!-- xfe:injected:${source}:begin -->`;
+const INJECTED_SOURCE_END = (source) => `<!-- xfe:injected:${source}:end -->`;
+const AUTO_GENERATED_HEADER = '<!-- Auto-generated by xfe rules sync — do not edit manually -->';
+// ─── Plan ──────
+/**
+ * 将同步项按 target 配置转换为 PlannedFile 列表
+ *
+ * 合并文件：多 item 拼到同一文件；独立文件：每 item 一个文件
+ * 可选注入项追加到合并文件末尾，独立注入项生成独立文件
+ */
+export function planMarkdownFiles(target, items, injections) {
+    const mergeMap = new Map();
+    const files = [];
+    for (const item of items) {
+        if (item.type === SyncItemType.McpServer || item.type === SyncItemType.Skill)
+            continue;
+        const template = resolvePathTemplate(target, item.type);
+        if (isIndividualSlot(template)) {
+            const filePath = template.replace('{id}', item.id);
+            files.push({ relativePath: filePath, content: formatOutputFile(filePath, item), action: 'write', source: 'sync', format: 'markdown' });
+        }
+        else {
+            const section = `# ${item.name}\n\n${item.content}`;
+            const existing = mergeMap.get(template);
+            mergeMap.set(template, existing ? existing + '\n\n---\n\n' + section : section);
+        }
+    }
+    // 合并文件
+    for (const [relativePath, content] of mergeMap) {
+        files.push({
+            relativePath,
+            content: AUTO_GENERATED_HEADER + '\n\n' + content + '\n',
+            action: 'write',
+            source: 'sync',
+            format: 'markdown',
+        });
+    }
+    // 注入项
+    if (injections && injections.size > 0) {
+        appendInjections(target, files, injections);
+    }
+    return files;
+}
+// ─── Conflict Detection ──────
+export async function detectMarkdownConflict(file, projectRoot, lastHashes) {
+    const absPath = path.join(projectRoot, file.relativePath);
+    if (!existsSync(absPath))
+        return file;
+    const localContent = await readFile(absPath, 'utf-8');
+    const localHash = computeHash(stripInjectedSections(localContent));
+    const knownHash = lastHashes[file.relativePath];
+    return !knownHash || localHash !== knownHash ? { ...file, action: 'conflict' } : file;
+}
+// ─── Write ──────
+export async function writeMarkdownFile(file, projectRoot) {
+    const absPath = path.join(projectRoot, file.relativePath);
+    await mkdir(path.dirname(absPath), { recursive: true });
+    await writeFile(absPath, file.content, 'utf-8');
+    return computeHash(stripInjectedSections(file.content));
+}
+/**
+ * 将注入注册表中的 Markdown 内容立即写入已有的目标文件
+ *
+ * 合并文件：在已有内容末尾追加/替换注入块
+ * 独立文件：直接写入
+ */
+export async function patchMarkdownInjections(config, projectRoot, injections) {
+    const mdInjections = filterMarkdownInjections(injections);
+    const injectedBlock = buildInjectedBlock(mdInjections);
+    const mergeFilePaths = collectMergeFilePaths(config);
+    let written = 0;
+    let removed = 0;
+    const hashes = {};
+    // 合并文件：追加/移除注入块
+    for (const relativePath of mergeFilePaths) {
+        const absPath = path.join(projectRoot, relativePath);
+        if (!existsSync(absPath))
+            continue;
+        const content = await readFile(absPath, 'utf-8');
+        const stripped = stripInjectedSections(content);
+        if (injectedBlock) {
+            await writeFile(absPath, stripped.trimEnd() + '\n\n' + injectedBlock + '\n', 'utf-8');
+            written++;
+        }
+        else if (content !== stripped) {
+            await writeFile(absPath, stripped, 'utf-8');
+            removed++;
+        }
+    }
+    // 独立注入文件
+    const individualFiles = generateInjectedIndividualFiles(config, mdInjections);
+    for (const file of individualFiles) {
+        const absPath = path.join(projectRoot, file.relativePath);
+        await mkdir(path.dirname(absPath), { recursive: true });
+        await writeFile(absPath, file.content, 'utf-8');
+        hashes[file.relativePath] = computeHash(file.content);
+        written++;
+    }
+    return { written, removed, hashes };
+}
+// ─── Gitignore ──────
+export function getMarkdownGitignore(target) {
+    return [...target.gitignoreEntries];
+}
+// ─── Stale File Cleanup ──────
+export async function removeStaleInjectedFiles(projectRoot, prevPaths, currentPaths) {
+    let removed = 0;
+    for (const stalePath of prevPaths) {
+        if (currentPaths.has(stalePath))
+            continue;
+        const absPath = path.join(projectRoot, stalePath);
+        if (!existsSync(absPath))
+            continue;
+        try {
+            await unlink(absPath);
+            removed++;
+        }
+        catch {
+            // 删除失败时静默跳过
+        }
+    }
+    return removed;
+}
+// ─── Marker Utilities (pipeline 需要) ──────
+export function stripInjectedSections(content) {
+    const beginIdx = content.indexOf(INJECTED_BEGIN);
+    const endIdx = content.indexOf(INJECTED_END);
+    if (beginIdx === -1 || endIdx === -1)
+        return content;
+    const before = content.slice(0, beginIdx).trimEnd();
+    const after = content.slice(endIdx + INJECTED_END.length).trimStart();
+    if (!after)
+        return before ? before + '\n' : '';
+    return before + '\n\n' + after;
+}
+// ─── Helpers ──────
+function appendInjections(target, files, injections) {
+    const mdInjections = filterMarkdownInjections(injections);
+    if (mdInjections.size === 0)
+        return;
+    const injectedBlock = buildInjectedBlock(mdInjections);
+    if (!injectedBlock)
+        return;
+    // 追加到合并文件
+    const mergeTemplates = new Set();
+    for (const template of [target.agent, target.rules, target.subagents, target.skills]) {
+        if (!isIndividualSlot(template))
+            mergeTemplates.add(template);
+    }
+    for (const file of files) {
+        if (file.format !== 'markdown' || !mergeTemplates.has(file.relativePath))
+            continue;
+        file.content = file.content.trimEnd() + '\n\n' + injectedBlock + '\n';
+    }
+    // 独立注入文件
+    const allItems = [...mdInjections.values()].flat();
+    for (const item of allItems) {
+        const template = resolvePathTemplate(target, item.type);
+        if (!isIndividualSlot(template))
+            continue;
+        const filePath = template.replace('{id}', item.id);
+        files.push({
+            relativePath: filePath,
+            content: formatOutputFile(filePath, item),
+            action: 'write',
+            source: 'injection',
+            format: 'markdown',
+        });
+    }
+}
+function filterMarkdownInjections(injections) {
+    const filtered = new Map();
+    for (const [source, items] of injections) {
+        const mdItems = items.filter((item) => item.type !== SyncItemType.McpServer);
+        if (mdItems.length > 0)
+            filtered.set(source, mdItems);
+    }
+    return filtered;
+}
+function buildInjectedBlock(injections) {
+    const sections = [];
+    for (const [source, items] of injections) {
+        if (items.length === 0)
+            continue;
+        const content = items.map((item) => `## ${item.name}\n\n${item.content}`).join('\n\n---\n\n');
+        sections.push([INJECTED_SOURCE_BEGIN(source), '', content, '', INJECTED_SOURCE_END(source)].join('\n'));
+    }
+    if (sections.length === 0)
+        return '';
+    return [INJECTED_BEGIN, '', ...sections, '', INJECTED_END].join('\n');
+}
+function collectMergeFilePaths(config) {
+    const paths = new Set();
+    for (const targetId of config.targets) {
+        const target = getTarget(targetId);
+        if (!target)
+            continue;
+        for (const template of [target.agent, target.rules, target.subagents, target.skills]) {
+            if (!isIndividualSlot(template))
+                paths.add(template);
+        }
+    }
+    return paths;
+}
+function generateInjectedIndividualFiles(config, injections) {
+    const allItems = [...injections.values()].flat();
+    if (allItems.length === 0)
+        return [];
+    const files = [];
+    for (const targetId of config.targets) {
+        const target = getTarget(targetId);
+        if (!target)
+            continue;
+        for (const item of allItems) {
+            const template = resolvePathTemplate(target, item.type);
+            if (!isIndividualSlot(template))
+                continue;
+            const filePath = template.replace('{id}', item.id);
+            files.push({ relativePath: filePath, content: formatOutputFile(filePath, item) });
+        }
+    }
+    return files;
+}
+//# sourceMappingURL=agent-md.js.map

package/dist/formats/agent-md.js.map

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

package/dist/formats/markdown.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Markdown 格式模块
+ *
+ * 处理 Markdown 系列文件的同步写入：
+ * - 合并文件（AGENTS.md / CLAUDE.md）：多 item 拼接到同一文件
+ * - 独立文件（.mdc / .instructions.md）：每 item 一个文件
+ * - 注入标记块：动态注入内容用 HTML 注释标记包裹
+ */
+import type { AiConfig, InjectionRegistry, PlannedFile, SyncEntry } from '../types.js';
+import type { TargetConfig } from '../targets.js';
+/**
+ * 将同步项按 target 配置转换为 PlannedFile 列表
+ *
+ * 合并文件：多 item 拼到同一文件；独立文件：每 item 一个文件
+ * 可选注入项追加到合并文件末尾，独立注入项生成独立文件
+ */
+export declare function planMarkdownFiles(target: TargetConfig, items: SyncEntry[], injections?: InjectionRegistry): PlannedFile[];
+export declare function detectMarkdownConflict(file: PlannedFile, projectRoot: string, lastHashes: Record<string, string>): Promise<PlannedFile>;
+export declare function writeMarkdownFile(file: PlannedFile, projectRoot: string): Promise<string>;
+export interface PatchResult {
+    written: number;
+    removed: number;
+    hashes: Record<string, string>;
+}
+/**
+ * 将注入注册表中的 Markdown 内容立即写入已有的目标文件
+ *
+ * 合并文件：在已有内容末尾追加/替换注入块
+ * 独立文件：直接写入
+ */
+export declare function patchMarkdownInjections(config: AiConfig, projectRoot: string, injections: InjectionRegistry): Promise<PatchResult>;
+export declare function getMarkdownGitignore(target: TargetConfig): string[];
+export declare function removeStaleInjectedFiles(projectRoot: string, prevPaths: Set<string>, currentPaths: Set<string>): Promise<number>;
+export declare function stripInjectedSections(content: string): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/formats/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/formats/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAGtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAajD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,WAAW,EAAE,CAsCzH;AAID,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,OAAO,CAAC,WAAW,CAAC,CAUtB;AAID,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO/F;AAID,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAwCxI;AAID,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAEnE;AAID,wBAAsB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBtI;AAID,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAY7D"}

package/dist/formats/markdown.js

@@ -0,0 +1,241 @@
+/**
+ * Markdown 格式模块
+ *
+ * 处理 Markdown 系列文件的同步写入：
+ * - 合并文件（AGENTS.md / CLAUDE.md）：多 item 拼接到同一文件
+ * - 独立文件（.mdc / .instructions.md）：每 item 一个文件
+ * - 注入标记块：动态注入内容用 HTML 注释标记包裹
+ */
+import { existsSync } from 'node:fs';
+import { readFile, writeFile, mkdir, unlink } from 'node:fs/promises';
+import path from 'node:path';
+import { SyncItemType } from '../types.js';
+import { getTarget, isIndividualSlot, resolvePathTemplate, formatOutputFile } from '../targets.js';
+import { computeHash } from './shared.js';
+// ─── Constants ──────
+const INJECTED_BEGIN = '<!-- xfe:injected:begin -->';
+const INJECTED_END = '<!-- xfe:injected:end -->';
+const INJECTED_SOURCE_BEGIN = (source) => `<!-- xfe:injected:${source}:begin -->`;
+const INJECTED_SOURCE_END = (source) => `<!-- xfe:injected:${source}:end -->`;
+const AUTO_GENERATED_HEADER = '<!-- Auto-generated by xfe rules sync — do not edit manually -->';
+// ─── Plan ──────
+/**
+ * 将同步项按 target 配置转换为 PlannedFile 列表
+ *
+ * 合并文件：多 item 拼到同一文件；独立文件：每 item 一个文件
+ * 可选注入项追加到合并文件末尾，独立注入项生成独立文件
+ */
+export function planMarkdownFiles(target, items, injections) {
+    const mergeMap = new Map();
+    const files = [];
+    for (const item of items) {
+        if (item.type === SyncItemType.McpServer || item.type === SyncItemType.Skill)
+            continue;
+        const template = resolvePathTemplate(target, item.type);
+        if (isIndividualSlot(template)) {
+            const filePath = template.replace('{id}', item.id);
+            files.push({ relativePath: filePath, content: formatOutputFile(filePath, item), action: 'write', source: 'sync', format: 'markdown' });
+        }
+        else {
+            const section = `# ${item.name}\n\n${item.content}`;
+            const existing = mergeMap.get(template);
+            mergeMap.set(template, existing ? existing + '\n\n---\n\n' + section : section);
+        }
+    }
+    // 合并文件
+    for (const [relativePath, content] of mergeMap) {
+        files.push({
+            relativePath,
+            content: AUTO_GENERATED_HEADER + '\n\n' + content + '\n',
+            action: 'write',
+            source: 'sync',
+            format: 'markdown',
+        });
+    }
+    // 注入项
+    if (injections && injections.size > 0) {
+        appendInjections(target, files, injections);
+    }
+    return files;
+}
+// ─── Conflict Detection ──────
+export async function detectMarkdownConflict(file, projectRoot, lastHashes) {
+    const absPath = path.join(projectRoot, file.relativePath);
+    if (!existsSync(absPath))
+        return file;
+    const localContent = await readFile(absPath, 'utf-8');
+    const localHash = computeHash(stripInjectedSections(localContent));
+    const knownHash = lastHashes[file.relativePath];
+    return !knownHash || localHash !== knownHash ? { ...file, action: 'conflict' } : file;
+}
+// ─── Write ──────
+export async function writeMarkdownFile(file, projectRoot) {
+    const absPath = path.join(projectRoot, file.relativePath);
+    await mkdir(path.dirname(absPath), { recursive: true });
+    await writeFile(absPath, file.content, 'utf-8');
+    return computeHash(stripInjectedSections(file.content));
+}
+/**
+ * 将注入注册表中的 Markdown 内容立即写入已有的目标文件
+ *
+ * 合并文件：在已有内容末尾追加/替换注入块
+ * 独立文件：直接写入
+ */
+export async function patchMarkdownInjections(config, projectRoot, injections) {
+    const mdInjections = filterMarkdownInjections(injections);
+    const injectedBlock = buildInjectedBlock(mdInjections);
+    const mergeFilePaths = collectMergeFilePaths(config);
+    let written = 0;
+    let removed = 0;
+    const hashes = {};
+    // 合并文件：追加/移除注入块
+    for (const relativePath of mergeFilePaths) {
+        const absPath = path.join(projectRoot, relativePath);
+        if (!existsSync(absPath))
+            continue;
+        const content = await readFile(absPath, 'utf-8');
+        const stripped = stripInjectedSections(content);
+        if (injectedBlock) {
+            await writeFile(absPath, stripped.trimEnd() + '\n\n' + injectedBlock + '\n', 'utf-8');
+            written++;
+        }
+        else if (content !== stripped) {
+            await writeFile(absPath, stripped, 'utf-8');
+            removed++;
+        }
+    }
+    // 独立注入文件
+    const individualFiles = generateInjectedIndividualFiles(config, mdInjections);
+    for (const file of individualFiles) {
+        const absPath = path.join(projectRoot, file.relativePath);
+        await mkdir(path.dirname(absPath), { recursive: true });
+        await writeFile(absPath, file.content, 'utf-8');
+        hashes[file.relativePath] = computeHash(file.content);
+        written++;
+    }
+    return { written, removed, hashes };
+}
+// ─── Gitignore ──────
+export function getMarkdownGitignore(target) {
+    return [...target.gitignoreEntries];
+}
+// ─── Stale File Cleanup ──────
+export async function removeStaleInjectedFiles(projectRoot, prevPaths, currentPaths) {
+    let removed = 0;
+    for (const stalePath of prevPaths) {
+        if (currentPaths.has(stalePath))
+            continue;
+        const absPath = path.join(projectRoot, stalePath);
+        if (!existsSync(absPath))
+            continue;
+        try {
+            await unlink(absPath);
+            removed++;
+        }
+        catch {
+            // 删除失败时静默跳过
+        }
+    }
+    return removed;
+}
+// ─── Marker Utilities (pipeline 需要) ──────
+export function stripInjectedSections(content) {
+    const beginIdx = content.indexOf(INJECTED_BEGIN);
+    const endIdx = content.indexOf(INJECTED_END);
+    if (beginIdx === -1 || endIdx === -1)
+        return content;
+    const before = content.slice(0, beginIdx).trimEnd();
+    const after = content.slice(endIdx + INJECTED_END.length).trimStart();
+    if (!after)
+        return before ? before + '\n' : '';
+    return before + '\n\n' + after;
+}
+// ─── Helpers ──────
+function appendInjections(target, files, injections) {
+    const mdInjections = filterMarkdownInjections(injections);
+    if (mdInjections.size === 0)
+        return;
+    const injectedBlock = buildInjectedBlock(mdInjections);
+    if (!injectedBlock)
+        return;
+    // 追加到合并文件
+    const mergeTemplates = new Set();
+    for (const template of [target.agent, target.rules, target.subagents, target.skills]) {
+        if (!isIndividualSlot(template))
+            mergeTemplates.add(template);
+    }
+    for (const file of files) {
+        if (file.format !== 'markdown' || !mergeTemplates.has(file.relativePath))
+            continue;
+        file.content = file.content.trimEnd() + '\n\n' + injectedBlock + '\n';
+    }
+    // 独立注入文件
+    const allItems = [...mdInjections.values()].flat();
+    for (const item of allItems) {
+        const template = resolvePathTemplate(target, item.type);
+        if (!isIndividualSlot(template))
+            continue;
+        const filePath = template.replace('{id}', item.id);
+        files.push({
+            relativePath: filePath,
+            content: formatOutputFile(filePath, item),
+            action: 'write',
+            source: 'injection',
+            format: 'markdown',
+        });
+    }
+}
+function filterMarkdownInjections(injections) {
+    const filtered = new Map();
+    for (const [source, items] of injections) {
+        const mdItems = items.filter((item) => item.type !== SyncItemType.McpServer);
+        if (mdItems.length > 0)
+            filtered.set(source, mdItems);
+    }
+    return filtered;
+}
+function buildInjectedBlock(injections) {
+    const sections = [];
+    for (const [source, items] of injections) {
+        if (items.length === 0)
+            continue;
+        const content = items.map((item) => `## ${item.name}\n\n${item.content}`).join('\n\n---\n\n');
+        sections.push([INJECTED_SOURCE_BEGIN(source), '', content, '', INJECTED_SOURCE_END(source)].join('\n'));
+    }
+    if (sections.length === 0)
+        return '';
+    return [INJECTED_BEGIN, '', ...sections, '', INJECTED_END].join('\n');
+}
+function collectMergeFilePaths(config) {
+    const paths = new Set();
+    for (const targetId of config.targets) {
+        const target = getTarget(targetId);
+        if (!target)
+            continue;
+        for (const template of [target.agent, target.rules, target.subagents, target.skills]) {
+            if (!isIndividualSlot(template))
+                paths.add(template);
+        }
+    }
+    return paths;
+}
+function generateInjectedIndividualFiles(config, injections) {
+    const allItems = [...injections.values()].flat();
+    if (allItems.length === 0)
+        return [];
+    const files = [];
+    for (const targetId of config.targets) {
+        const target = getTarget(targetId);
+        if (!target)
+            continue;
+        for (const item of allItems) {
+            const template = resolvePathTemplate(target, item.type);
+            if (!isIndividualSlot(template))
+                continue;
+            const filePath = template.replace('{id}', item.id);
+            files.push({ relativePath: filePath, content: formatOutputFile(filePath, item) });
+        }
+    }
+    return files;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/formats/markdown.js.map

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

package/dist/formats/mcp-json.d.ts

@@ -0,0 +1,25 @@
+/**
+ * MCP JSON 格式模块
+ *
+ * 处理 MCP 配置文件（.vscode/mcp.json、.cursor/mcp.json、.mcp.json）的同步写入：
+ * - 使用 `xfe:` 前缀隔离 xfe 管理的 server 条目与用户自定义条目
+ * - 写入时保留非 xfe 前缀的用户条目，仅覆盖 xfe 前缀条目
+ * - 不做冲突检测（前缀隔离已足够）
+ */
+import type { AiConfig, InjectionRegistry, PlannedFile, SyncEntry } from '../types.js';
+import type { TargetConfig } from '../targets.js';
+/**
+ * 将 MCP server 项按 target 转换为 PlannedFile
+ *
+ * 可选注入项合并到同一 JSON 文件
+ */
+export declare function planMcpJsonFiles(target: TargetConfig, items: SyncEntry[], injections?: InjectionRegistry): PlannedFile[];
+export declare function writeMcpJsonFile(file: PlannedFile, projectRoot: string): Promise<string>;
+export interface PatchResult {
+    written: number;
+    removed: number;
+    hashes: Record<string, string>;
+}
+export declare function patchMcpJsonInjections(config: AiConfig, projectRoot: string, injections: InjectionRegistry): Promise<PatchResult>;
+export declare function getMcpJsonGitignore(target: TargetConfig): string[];
+//# sourceMappingURL=mcp-json.d.ts.map