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

package/dist/writers/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - Writer barrel 导出
+ *
+ * 统一管理 Writer 实例注册与获取
+ */
+import type { WriterType } from '../types.js';
+import type { Writer } from './types.js';
+export type { Writer, ApplyInjectionResult } from './types.js';
+export { markdownWriter } from './markdown-writer.js';
+export { mcpJsonWriter } from './mcp-json-writer.js';
+export { stripInjectedSections, computeHash, removeStaleInjectedFiles } from './markdown-writer.js';
+export declare function getWriter(type: WriterType): Writer;
+/** 所有已注册的 Writer 实例 */
+export declare function getAllWriters(): Writer[];
+//# sourceMappingURL=index.d.ts.map

package/dist/writers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/writers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAIxC,YAAY,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AASnG,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAElD;AAED,uBAAuB;AACvB,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC"}

package/dist/writers/index.js

@@ -0,0 +1,23 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - Writer barrel 导出
+ *
+ * 统一管理 Writer 实例注册与获取
+ */
+import { markdownWriter } from './markdown-writer.js';
+import { mcpJsonWriter } from './mcp-json-writer.js';
+export { markdownWriter } from './markdown-writer.js';
+export { mcpJsonWriter } from './mcp-json-writer.js';
+export { stripInjectedSections, computeHash, removeStaleInjectedFiles } from './markdown-writer.js';
+// ─── Writer Registry ──────
+const WRITER_REGISTRY = {
+    markdown: markdownWriter,
+    'mcp-json': mcpJsonWriter,
+};
+export function getWriter(type) {
+    return WRITER_REGISTRY[type];
+}
+/** 所有已注册的 Writer 实例 */
+export function getAllWriters() {
+    return Object.values(WRITER_REGISTRY);
+}
+//# sourceMappingURL=index.js.map

package/dist/writers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/writers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAEnG,6BAA6B;AAE7B,MAAM,eAAe,GAA+B;IAClD,QAAQ,EAAE,cAAc;IACxB,UAAU,EAAE,aAAa;CAC1B,CAAA;AAED,MAAM,UAAU,SAAS,CAAC,IAAgB;IACxC,OAAO,eAAe,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,aAAa;IAC3B,OAAO,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAA;AACvC,CAAC"}

package/dist/writers/markdown-writer.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - Markdown Writer
+ *
+ * 处理 Markdown 系列文件的同步写入：
+ * - 合并文件（AGENTS.md / CLAUDE.md）：多 item 拼接到同一文件
+ * - 独立文件（.mdc / .instructions.md）：每 item 一个文件
+ * - 注入标记块：动态注入内容用 HTML 注释标记包裹
+ */
+import type { Writer } from './types.js';
+export declare const markdownWriter: Writer;
+export declare function stripInjectedSections(content: string): string;
+export declare function computeHash(content: string): string;
+/** 清理历史注入独立文件（不在当前列表中的旧文件） */
+export declare function removeStaleInjectedFiles(projectRoot: string, prevPaths: Set<string>, currentPaths: Set<string>): Promise<number>;
+//# sourceMappingURL=markdown-writer.d.ts.map

package/dist/writers/markdown-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-writer.d.ts","sourceRoot":"","sources":["../../src/writers/markdown-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,OAAO,KAAK,EAAwB,MAAM,EAAE,MAAM,YAAY,CAAA;AAY9D,eAAO,MAAM,cAAc,EAAE,MAmH5B,CAAA;AAiJD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAa7D;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,8BAA8B;AAC9B,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"}

package/dist/writers/markdown-writer.js

@@ -0,0 +1,249 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - Markdown Writer
+ *
+ * 处理 Markdown 系列文件的同步写入：
+ * - 合并文件（AGENTS.md / CLAUDE.md）：多 item 拼接到同一文件
+ * - 独立文件（.mdc / .instructions.md）：每 item 一个文件
+ * - 注入标记块：动态注入内容用 HTML 注释标记包裹
+ */
+import { createHash } from 'node:crypto';
+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';
+// ─── 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 -->';
+// ─── Markdown Writer ──────
+export const markdownWriter = {
+    plan(target, items) {
+        const mergeMap = new Map();
+        const individualFiles = [];
+        distributeItems(target, items, mergeMap, individualFiles);
+        const files = buildMergeFiles(mergeMap);
+        files.push(...individualFiles);
+        return files;
+    },
+    appendInjections(config, files, injections) {
+        if (injections.size === 0)
+            return;
+        const mdInjections = filterMarkdownInjections(injections);
+        if (mdInjections.size === 0)
+            return;
+        const injectedBlock = buildInjectedBlock(mdInjections);
+        if (!injectedBlock)
+            return;
+        const mergeFilePaths = collectMergeFilePaths(config);
+        for (const file of files) {
+            if (file.writerType !== 'markdown')
+                continue;
+            if (!mergeFilePaths.has(file.relativePath))
+                continue;
+            file.content = file.content.trimEnd() + '\n\n' + injectedBlock + '\n';
+        }
+        const injectedIndividualFiles = generateInjectedIndividualFiles(config, mdInjections);
+        files.push(...injectedIndividualFiles.map((f) => ({
+            ...f,
+            action: 'write',
+            source: 'injection',
+            writerType: 'markdown',
+        })));
+    },
+    async detectConflict(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];
+        const hasLocalChanges = !knownHash || localHash !== knownHash;
+        return hasLocalChanges ? { ...file, action: 'conflict' } : file;
+    },
+    async write(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));
+    },
+    async applyInjections(config, projectRoot, injections) {
+        const mdInjections = filterMarkdownInjections(injections);
+        const injectedBlock = buildInjectedBlock(mdInjections);
+        const mergeFilePaths = collectMergeFilePaths(config);
+        let written = 0;
+        let removed = 0;
+        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');
+            written++;
+        }
+        const hashes = {};
+        for (const file of individualFiles) {
+            hashes[file.relativePath] = computeHash(file.content);
+        }
+        return { written, removed, hashes };
+    },
+    gitignoreEntries(target) {
+        return [...target.gitignoreEntries];
+    },
+};
+// ─── Plan Helpers ──────
+function distributeItems(target, items, mergeMap, individualFiles) {
+    const byType = groupByType(items);
+    for (const [type, typeItems] of byType) {
+        if (type === SyncItemType.McpServer)
+            continue;
+        const pathTemplate = resolvePathTemplate(target, type);
+        if (isIndividualSlot(pathTemplate)) {
+            for (const item of typeItems) {
+                const filePath = pathTemplate.replace('{id}', item.id);
+                individualFiles.push({
+                    relativePath: filePath,
+                    content: formatOutputFile(filePath, item),
+                    action: 'write',
+                    source: 'sync',
+                    writerType: 'markdown',
+                });
+            }
+        }
+        else {
+            const content = typeItems.map((r) => `# ${r.name}\n\n${r.content}`).join('\n\n---\n\n');
+            const existing = mergeMap.get(pathTemplate);
+            mergeMap.set(pathTemplate, existing ? existing + '\n\n---\n\n' + content : content);
+        }
+    }
+}
+function buildMergeFiles(mergeMap) {
+    const files = [];
+    for (const [relativePath, content] of mergeMap) {
+        files.push({
+            relativePath,
+            content: AUTO_GENERATED_HEADER + '\n\n' + content + '\n',
+            action: 'write',
+            source: 'sync',
+            writerType: 'markdown',
+        });
+    }
+    return files;
+}
+function groupByType(items) {
+    const map = new Map();
+    for (const item of items) {
+        const list = map.get(item.type) ?? [];
+        list.push(item);
+        map.set(item.type, list);
+    }
+    return map;
+}
+// ─── Injection Helpers ──────
+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 itemsContent = items.map((item) => `## ${item.name}\n\n${item.content}`).join('\n\n---\n\n');
+        sections.push([INJECTED_SOURCE_BEGIN(source), '', itemsContent, '', 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;
+}
+// ─── Marker Block Utilities ──────
+export function stripInjectedSections(content) {
+    const beginIdx = content.indexOf(INJECTED_BEGIN);
+    const endIdx = content.indexOf(INJECTED_END);
+    const found = beginIdx !== -1 && endIdx !== -1;
+    if (!found)
+        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;
+}
+export function computeHash(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+/** 清理历史注入独立文件（不在当前列表中的旧文件） */
+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;
+}
+//# sourceMappingURL=markdown-writer.js.map

package/dist/writers/markdown-writer.js.map

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

package/dist/writers/mcp-json-writer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - MCP JSON Writer
+ *
+ * 处理 MCP 配置文件（.vscode/mcp.json、.cursor/mcp.json、.mcp.json）的同步写入：
+ * - 使用 `xfe:` 前缀隔离 xfe 管理的 server 条目与用户自定义条目
+ * - 写入时保留非 xfe 前缀的用户条目，仅覆盖 xfe 前缀条目
+ * - 不做冲突检测（前缀隔离已足够）
+ */
+import type { Writer } from './types.js';
+export declare const mcpJsonWriter: Writer;
+//# sourceMappingURL=mcp-json-writer.d.ts.map

package/dist/writers/mcp-json-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-json-writer.d.ts","sourceRoot":"","sources":["../../src/writers/mcp-json-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,OAAO,KAAK,EAAwB,MAAM,EAAE,MAAM,YAAY,CAAA;AAQ9D,eAAO,MAAM,aAAa,EAAE,MAsI3B,CAAA"}

package/dist/writers/mcp-json-writer.js

@@ -0,0 +1,185 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - MCP JSON Writer
+ *
+ * 处理 MCP 配置文件（.vscode/mcp.json、.cursor/mcp.json、.mcp.json）的同步写入：
+ * - 使用 `xfe:` 前缀隔离 xfe 管理的 server 条目与用户自定义条目
+ * - 写入时保留非 xfe 前缀的用户条目，仅覆盖 xfe 前缀条目
+ * - 不做冲突检测（前缀隔离已足够）
+ */
+import { createHash } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { SyncItemType } from '../types.js';
+import { getTarget } from '../targets.js';
+// ─── Constants ──────
+const MCP_SERVER_PREFIX = 'xfe:';
+// ─── MCP JSON Writer ──────
+export const mcpJsonWriter = {
+    plan(target, items) {
+        const mcpItems = items.filter((item) => item.type === SyncItemType.McpServer);
+        if (mcpItems.length === 0 || !target.mcp)
+            return [];
+        const servers = buildServerEntries(mcpItems);
+        const content = buildMcpJsonContent(target, servers);
+        return [
+            {
+                relativePath: target.mcp,
+                content,
+                action: 'write',
+                source: 'sync',
+                writerType: 'mcp-json',
+            },
+        ];
+    },
+    appendInjections(config, files, injections) {
+        if (injections.size === 0)
+            return;
+        const mcpItems = collectMcpInjectionItems(injections);
+        if (mcpItems.length === 0)
+            return;
+        const servers = buildServerEntries(mcpItems);
+        for (const targetId of config.targets) {
+            const target = getTarget(targetId);
+            if (!target?.mcp)
+                continue;
+            const existing = files.find((f) => f.writerType === 'mcp-json' && f.relativePath === target.mcp);
+            if (existing) {
+                const parsed = JSON.parse(existing.content);
+                const rootKey = target.mcpRootKey ?? 'mcpServers';
+                Object.assign(parsed[rootKey] ?? {}, servers);
+                existing.content = JSON.stringify(parsed, null, 2) + '\n';
+            }
+            else {
+                files.push({
+                    relativePath: target.mcp,
+                    content: buildMcpJsonContent(target, servers),
+                    action: 'write',
+                    source: 'injection',
+                    writerType: 'mcp-json',
+                });
+            }
+        }
+    },
+    async detectConflict(file) {
+        // MCP JSON 使用前缀隔离，不做冲突检测
+        return file;
+    },
+    async write(file, projectRoot) {
+        const absPath = path.join(projectRoot, file.relativePath);
+        await mkdir(path.dirname(absPath), { recursive: true });
+        const newServers = extractServers(file.content);
+        const merged = await mergeWithExisting(absPath, file.content, newServers);
+        await writeFile(absPath, merged, 'utf-8');
+        return computeHash(merged);
+    },
+    async applyInjections(config, projectRoot, injections) {
+        const mcpItems = collectMcpInjectionItems(injections);
+        const servers = buildServerEntries(mcpItems);
+        const isEmpty = Object.keys(servers).length === 0;
+        let written = 0;
+        let removed = 0;
+        for (const targetId of config.targets) {
+            const target = getTarget(targetId);
+            if (!target?.mcp)
+                continue;
+            const absPath = path.join(projectRoot, target.mcp);
+            if (!existsSync(absPath)) {
+                if (!isEmpty) {
+                    await mkdir(path.dirname(absPath), { recursive: true });
+                    await writeFile(absPath, buildMcpJsonContent(target, servers), 'utf-8');
+                    written++;
+                }
+                continue;
+            }
+            const content = await readFile(absPath, 'utf-8');
+            const rootKey = target.mcpRootKey ?? 'mcpServers';
+            const parsed = JSON.parse(content);
+            const existingServers = parsed[rootKey] ?? {};
+            // 移除旧的 xfe 前缀条目
+            const userServers = {};
+            for (const [key, value] of Object.entries(existingServers)) {
+                if (!key.startsWith(MCP_SERVER_PREFIX)) {
+                    userServers[key] = value;
+                }
+            }
+            if (isEmpty) {
+                const hadXfeServers = Object.keys(existingServers).some((k) => k.startsWith(MCP_SERVER_PREFIX));
+                if (hadXfeServers) {
+                    parsed[rootKey] = userServers;
+                    await writeFile(absPath, JSON.stringify(parsed, null, 2) + '\n', 'utf-8');
+                    removed++;
+                }
+            }
+            else {
+                parsed[rootKey] = { ...userServers, ...servers };
+                await writeFile(absPath, JSON.stringify(parsed, null, 2) + '\n', 'utf-8');
+                written++;
+            }
+        }
+        return { written, removed, hashes: {} };
+    },
+    gitignoreEntries(target) {
+        if (!target.mcp)
+            return [];
+        return [target.mcp];
+    },
+};
+// ─── Helpers ──────
+function buildServerEntries(items) {
+    const servers = {};
+    for (const item of items) {
+        if (!item.serverConfig)
+            continue;
+        const key = `${MCP_SERVER_PREFIX}${item.id}`;
+        servers[key] = item.serverConfig;
+    }
+    return servers;
+}
+function buildMcpJsonContent(target, servers) {
+    const rootKey = target.mcpRootKey ?? 'mcpServers';
+    return JSON.stringify({ [rootKey]: servers }, null, 2) + '\n';
+}
+function extractServers(content) {
+    const parsed = JSON.parse(content);
+    return Object.values(parsed)[0] ?? {};
+}
+async function mergeWithExisting(absPath, newContent, newServers) {
+    if (!existsSync(absPath))
+        return newContent;
+    const existingRaw = await readFile(absPath, 'utf-8');
+    let existing;
+    try {
+        existing = JSON.parse(existingRaw);
+    }
+    catch {
+        return newContent;
+    }
+    const newParsed = JSON.parse(newContent);
+    const rootKey = Object.keys(newParsed)[0];
+    const existingServers = existing[rootKey] ?? {};
+    // 保留非 xfe 前缀的用户条目
+    const userServers = {};
+    for (const [key, value] of Object.entries(existingServers)) {
+        if (!key.startsWith(MCP_SERVER_PREFIX)) {
+            userServers[key] = value;
+        }
+    }
+    existing[rootKey] = { ...userServers, ...newServers };
+    return JSON.stringify(existing, null, 2) + '\n';
+}
+function collectMcpInjectionItems(injections) {
+    const items = [];
+    for (const sourceItems of injections.values()) {
+        for (const item of sourceItems) {
+            if (item.type === SyncItemType.McpServer) {
+                items.push(item);
+            }
+        }
+    }
+    return items;
+}
+function computeHash(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+//# sourceMappingURL=mcp-json-writer.js.map

package/dist/writers/mcp-json-writer.js.map

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

package/dist/writers/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - Writer 接口定义
+ *
+ * Writer 负责将 SyncItem 转换为具体文件格式并执行读写
+ * pipeline 编排层按 WriterType 委派给对应实现
+ */
+import type { AiConfig, InjectionRegistry, PlannedFile, SyncItem } from '../types.js';
+import type { TargetConfig } from '../targets.js';
+export interface Writer {
+    /** 将同步项按 target 配置转换为 PlannedFile 列表（纯函数） */
+    plan(target: TargetConfig, items: SyncItem[]): PlannedFile[];
+    /** 将注入项追加到已有的 PlannedFile 列表中（纯函数，原地修改 files） */
+    appendInjections(config: AiConfig, files: PlannedFile[], injections: InjectionRegistry): void;
+    /** 检测单个 PlannedFile 是否与本地文件冲突（只读 IO） */
+    detectConflict(file: PlannedFile, projectRoot: string, lastHashes: Record<string, string>): Promise<PlannedFile>;
+    /** 执行单个 PlannedFile 的写入，返回内容 hash（写 IO） */
+    write(file: PlannedFile, projectRoot: string): Promise<string>;
+    /** 将注入注册表立即应用到已有文件（独立注入路径，不走完整 sync） */
+    applyInjections(config: AiConfig, projectRoot: string, injections: InjectionRegistry): Promise<ApplyInjectionResult>;
+    /** 收集该 target 需要加入 .gitignore 的条目 */
+    gitignoreEntries(target: TargetConfig): string[];
+}
+export interface ApplyInjectionResult {
+    written: number;
+    removed: number;
+    /** 注入产生的独立文件路径 → hash 映射 */
+    hashes: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/writers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/writers/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAIjD,MAAM,WAAW,MAAM;IACrB,6CAA6C;IAC7C,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,CAAA;IAE5D,iDAAiD;IACjD,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAE7F,wCAAwC;IACxC,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAEhH,2CAA2C;IAC3C,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAE9D,wCAAwC;IACxC,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAEpH,qCAAqC;IACrC,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAAA;CACjD;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B"}

package/dist/writers/types.js

@@ -0,0 +1,8 @@
+/**
+ * @xfe-repo/cli-plugin-ai-rules - Writer 接口定义
+ *
+ * Writer 负责将 SyncItem 转换为具体文件格式并执行读写
+ * pipeline 编排层按 WriterType 委派给对应实现
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/writers/types.js.map

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

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@xfe-repo/cli-plugin-ai-rules",
+  "version": "2.0.0",
+  "description": "XFE AI Rules plugin - sync AI coding rules from remote repo to IDE configs",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "gray-matter": "^4.0.3",
+    "zod": "^4.3.6",
+    "@xfe-repo/cli-core": "2.0.0",
+    "@xfe-repo/cli-plugin-git": "2.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "typescript": "^5.9.2"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "ISC",
+  "scripts": {
+    "dev": "tsc -p tsconfig.json -w",
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist"
+  }
+}