@logictan/dsh-config-manager 0.1.60

package/lib/adapters/index.js

@@ -0,0 +1,55 @@
+import { SettingsAdapter } from './settings.js';
+import { UiAdapter } from './ui.js';
+import { ProvidersAdapter } from './providers.js';
+import { PluginsAdapter } from './plugins.js';
+import { McpAdapter } from './mcp.js';
+import { PromptsAdapter } from './prompts.js';
+import { SkillsAdapter } from './skills.js';
+import { AgentPresetsAdapter } from './agent-presets.js';
+import { AgentInstructionsAdapter } from './agent-instructions.js';
+import { WorkspacesAdapter } from './workspaces.js';
+import { CredentialsAdapter } from './credentials.js';
+import { PluginFilesAdapter } from './plugin-files.js';
+import { SessionsAdapter } from './sessions.js';
+import { SelfAdapter } from './self.js';
+/** 组装默认 adapter 列表（pluginFiles/sessions 恒挂载但 defaultIncluded=false，用户勾选才导出） */
+export function createAdapters(options = {}) {
+    const namespaces = options.namespaces ?? [];
+    const adapters = [
+        new SettingsAdapter(namespaces),
+        new UiAdapter(namespaces),
+        new ProvidersAdapter(),
+        new PluginsAdapter(options.selfPluginName, options.localPluginPack),
+        new McpAdapter(),
+        new PromptsAdapter(),
+        new SkillsAdapter(),
+        new AgentPresetsAdapter(),
+        new AgentInstructionsAdapter(),
+        new WorkspacesAdapter(),
+        new CredentialsAdapter({ namespaces, refs: options.credentialsRefs }),
+        new PluginFilesAdapter(options.pluginFiles, options.pluginFilesDir),
+    ];
+    // self 分区：插件自身配置（同步/市场/偏好），portable 默认包含；'' = 不挂载
+    if (options.selfDir !== '') {
+        adapters.push(new SelfAdapter(options.selfDir ?? 'dsh-config-manager'));
+    }
+    if (options.includeSessions)
+        adapters.push(new SessionsAdapter());
+    return adapters;
+}
+export { SettingsAdapter } from './settings.js';
+export { UiAdapter, isUiNamespace, KNOWN_UI_NAMESPACE_PREFIXES, UI_MIGRATION_NOTES } from './ui.js';
+export { ProvidersAdapter, DEFAULT_PROVIDER_NAMESPACES } from './providers.js';
+export { PluginsAdapter, USER_PATCH_FILE } from './plugins.js';
+export { McpAdapter, extractMcpServers, buildMcpPatchLine } from './mcp.js';
+export { PromptsAdapter, extractPrompts, mergePromptIntoLine, buildPromptLine } from './prompts.js';
+export { SkillsAdapter } from './skills.js';
+export { AgentPresetsAdapter } from './agent-presets.js';
+export { AgentInstructionsAdapter } from './agent-instructions.js';
+export { WorkspacesAdapter } from './workspaces.js';
+export { CredentialsAdapter, defaultCredentialRefs } from './credentials.js';
+export { PluginFilesAdapter, DEFAULT_PLUGIN_FILE_WHITELIST } from './plugin-files.js';
+export { SessionsAdapter } from './sessions.js';
+export { SelfAdapter, SELF_CONFIG_FILES } from './self.js';
+export { FileCollectionAdapter } from './file-collection.js';
+//# sourceMappingURL=index.js.map

package/lib/adapters/link-report.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 文件类分区的「链接目录」报告（issue #37）。
+ *
+ * 背景：备份静默跳过 junction/符号链接，用户拿到的仍是「成功」，却少了整块内容。
+ * 修复分两步：① `utils/recursive-walk.ts` 跟随链接收集内容；② 本模块把「跟随了什么、
+ * 跳过了什么、为什么跳过」变成备份报告里可见的告警 —— 缺了 ②，用户依然无从察觉缺失。
+ *
+ * 纯函数（除 listFilesDetailed 的 IO 委托外），两个 adapter 共用，避免文案再次漂移。
+ */
+import type { FileSystemFacade } from '../core/types.ts';
+import type { MsgFunc } from '../core/messages.ts';
+import type { RecursiveListing } from '../utils/recursive-walk.ts';
+/** 取遍历结果：宿主未实现 listRecursiveDetailed（旧版/测试 mock）时回退，行为与旧版一致。 */
+export declare function listFilesDetailed(fs: FileSystemFacade, dir: string): Promise<RecursiveListing>;
+/** 把遍历结果转成告警行（无链接时返回空数组 —— 不制造噪音）。 */
+export declare function linkWarnings(msg: MsgFunc, type: string, listing: RecursiveListing): string[];

package/lib/adapters/link-report.js

@@ -0,0 +1,47 @@
+/** 跳过原因 → 消息 key（与 SkippedLink.reason 一一对应，穷尽映射） */
+const REASON_KEY = {
+    loop: 'adapter.linkReason.loop',
+    'outside-home': 'adapter.linkReason.outsideHome',
+    broken: 'adapter.linkReason.broken',
+    unreadable: 'adapter.linkReason.unreadable',
+    'too-deep': 'adapter.linkReason.tooDeep',
+};
+/** 单条原因下最多列出的路径数（其余折叠为计数，避免把报告撑爆） */
+const MAX_PATHS_PER_REASON = 5;
+/** 取遍历结果：宿主未实现 listRecursiveDetailed（旧版/测试 mock）时回退，行为与旧版一致。 */
+export async function listFilesDetailed(fs, dir) {
+    if (fs.listRecursiveDetailed !== undefined)
+        return fs.listRecursiveDetailed(dir);
+    return { paths: await fs.listRecursive(dir), skippedLinks: [], followedLinks: 0, unreadableDirs: [] };
+}
+/** 把遍历结果转成告警行（无链接时返回空数组 —— 不制造噪音）。 */
+export function linkWarnings(msg, type, listing) {
+    const out = [];
+    if (listing.followedLinks > 0) {
+        out.push(msg('adapter.linksFollowed', { type, count: String(listing.followedLinks) }));
+    }
+    if (listing.skippedLinks.length > 0) {
+        const byReason = new Map();
+        for (const s of listing.skippedLinks) {
+            const arr = byReason.get(s.reason) ?? [];
+            arr.push(s.path);
+            byReason.set(s.reason, arr);
+        }
+        const detail = [...byReason.entries()].map(([reason, paths]) => {
+            const shown = paths.slice(0, MAX_PATHS_PER_REASON).join(', ');
+            const more = paths.length > MAX_PATHS_PER_REASON ? ` (+ ${paths.length - MAX_PATHS_PER_REASON})` : '';
+            return `${msg(REASON_KEY[reason])} ${paths.length} 个: ${shown}${more}`;
+        }).join('；');
+        out.push(msg('adapter.linksSkipped', { type, count: String(listing.skippedLinks.length), detail }));
+    }
+    if (listing.unreadableDirs.length > 0) {
+        const shown = listing.unreadableDirs.slice(0, MAX_PATHS_PER_REASON).join(', ');
+        const more = listing.unreadableDirs.length > MAX_PATHS_PER_REASON
+            ? ` (+ ${listing.unreadableDirs.length - MAX_PATHS_PER_REASON})` : '';
+        out.push(msg('adapter.dirsUnreadable', {
+            type, count: String(listing.unreadableDirs.length), detail: `${shown}${more}`,
+        }));
+    }
+    return out;
+}
+//# sourceMappingURL=link-report.js.map

package/lib/adapters/mcp.d.ts

@@ -0,0 +1,28 @@
+import type { MsgFunc } from '../core/messages.ts';
+import type { McpServerEntry } from '../schema/types.ts';
+import type { ApplyResult, ConfigAdapter, ExportOptions, ExportSection, HostContext, ImportContext, PlanItem, ValidationResult } from '../core/types.ts';
+/** 导出记录：McpServerEntry 之外附加来源 patch 行 id（导入写回定位用） */
+export interface McpExportEntry extends McpServerEntry {
+    sourceLineId: string;
+}
+export interface McpExportSection {
+    version: 1;
+    servers: McpExportEntry[];
+}
+/** 从 patch 行数组中提取 MCP server 条目（以 config.serverName 存在为判定） */
+export declare function extractMcpServers(lines: {
+    lineId: string;
+    raw: unknown;
+}[]): McpExportEntry[];
+/** 由导出条目构造写回 patch 行 raw（单行形态，与 dsh-mcp-client 组合 config 语义一致） */
+export declare function buildMcpPatchLine(lineId: string, server: McpServerEntry): Record<string, unknown>;
+export declare class McpAdapter implements ConfigAdapter<McpExportSection> {
+    readonly id: 'mcp';
+    readonly displayName = "MCP Servers";
+    readonly defaultIncluded = true;
+    readonly portability: 'platformSpecific';
+    export(ctx: HostContext, _options: ExportOptions): Promise<ExportSection<McpExportSection>>;
+    analyzeImport(data: McpExportSection, ctx: ImportContext): Promise<PlanItem[]>;
+    applyItem(item: PlanItem, ctx: ImportContext): Promise<ApplyResult>;
+    validate(data: McpExportSection, msg?: MsgFunc): Promise<ValidationResult>;
+}

package/lib/adapters/mcp.js

@@ -0,0 +1,178 @@
+/**
+ * mcp 分区 adapter（设计 §3.3/§1.2/§15）：
+ * 数据源 = 组合 patch 中 dsh-mcp-client 行的 config（研究报告 §2.2：MCP 无 settings 面/无管理 API）。
+ * 导入 = 写 profile cordis.patch.yml 插行（needsRestart 生效）；依赖检测（npx 等）由 analyzer 的
+ * dependencyChecker 执行（§15：缺失不阻塞，标记 Requires Attention）。
+ *
+ * patch 行 raw 支持两种形态：单行 { id, name, config } 与块 { insert: [{ id, name, config }] }。
+ */
+import { isDeepStrictEqual } from 'node:util';
+import { msgOf, zhMsg } from '../core/messages.js';
+import { USER_PATCH_FILE } from './plugins.js';
+/** 从 patch 行数组中提取 MCP server 条目（以 config.serverName 存在为判定） */
+export function extractMcpServers(lines) {
+    const servers = [];
+    for (const line of lines) {
+        for (const entry of entriesOf(line.raw)) {
+            const config = entry.config;
+            if (config === null || typeof config !== 'object')
+                continue;
+            const c = config;
+            const serverName = c['serverName'];
+            if (typeof serverName !== 'string' || serverName === '')
+                continue;
+            const type = typeof c['url'] === 'string' && c['url'] !== '' ? 'streamable-http' : 'stdio';
+            servers.push({
+                serverName,
+                type,
+                command: typeof c['command'] === 'string' ? c['command'] : undefined,
+                args: Array.isArray(c['args']) ? c['args'] : undefined,
+                env: c['env'] !== null && typeof c['env'] === 'object' ? c['env'] : undefined,
+                cwd: typeof c['cwd'] === 'string' ? c['cwd'] : undefined,
+                url: typeof c['url'] === 'string' ? c['url'] : undefined,
+                headers: c['headers'] !== null && typeof c['headers'] === 'object' ? c['headers'] : undefined,
+                sourceLineId: line.lineId,
+            });
+        }
+    }
+    return servers;
+}
+/** patch 行 → 可枚举的 entry 列表（兼容单行与 insert 块） */
+function entriesOf(raw) {
+    if (raw === null || typeof raw !== 'object')
+        return [];
+    const obj = raw;
+    if (Array.isArray(obj['insert'])) {
+        return obj['insert']
+            .filter((e) => e !== null && typeof e === 'object')
+            .map((e) => e);
+    }
+    if (obj['id'] !== undefined || obj['name'] !== undefined) {
+        return [obj];
+    }
+    return [];
+}
+/** 由导出条目构造写回 patch 行 raw（单行形态，与 dsh-mcp-client 组合 config 语义一致） */
+export function buildMcpPatchLine(lineId, server) {
+    const config = { serverName: server.serverName };
+    if (server.type === 'streamable-http') {
+        config['url'] = server.url;
+        if (server.headers !== undefined)
+            config['headers'] = server.headers;
+    }
+    else {
+        config['command'] = server.command;
+        if (server.args !== undefined)
+            config['args'] = server.args;
+        if (server.env !== undefined)
+            config['env'] = server.env;
+        if (server.cwd !== undefined)
+            config['cwd'] = server.cwd;
+    }
+    return { id: lineId, name: 'dsh-mcp-client', config };
+}
+function newLineId(serverName) {
+    const slug = serverName.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+    return `mcp-${slug || 'server'}`;
+}
+export class McpAdapter {
+    id = 'mcp';
+    displayName = 'MCP Servers';
+    defaultIncluded = true;
+    portability = 'platformSpecific';
+    async export(ctx, _options) {
+        const warnings = [];
+        let lines = [];
+        try {
+            lines = await ctx.patchFile.readPatchLines(USER_PATCH_FILE);
+        }
+        catch (err) {
+            warnings.push(msgOf(ctx)('adapter.patchReadFailedMCP', { reason: err instanceof Error ? err.message : String(err) }));
+        }
+        const servers = extractMcpServers(lines);
+        return {
+            sectionId: 'mcp',
+            data: { version: 1, servers },
+            counts: { servers: servers.length },
+            warnings,
+        };
+    }
+    async analyzeImport(data, ctx) {
+        const msg = ctx.msg;
+        const items = [];
+        const targetLines = await ctx.target.patchFile.readPatchLines(USER_PATCH_FILE);
+        const targetServers = extractMcpServers(targetLines);
+        for (const server of data.servers) {
+            const id = `mcp:${server.serverName}`;
+            const existing = targetServers.find((s) => s.serverName === server.serverName);
+            const comparable = { ...server };
+            delete comparable.sourceLineId;
+            if (!existing) {
+                const lineId = server.sourceLineId && targetLines.some((l) => l.lineId === server.sourceLineId)
+                    ? `${server.sourceLineId}-imported`
+                    : (server.sourceLineId ?? newLineId(server.serverName));
+                items.push({
+                    id, kind: 'Create', adapter: 'mcp',
+                    description: msg('adapter.mcpCreate', { serverName: server.serverName }),
+                    detail: `${server.type === 'stdio' ? `${server.command} ${(server.args ?? []).join(' ')}` : server.url}`,
+                    severity: 'info',
+                    target: { adapter: 'mcp', ref: lineId },
+                });
+            }
+            else {
+                const existingComparable = { ...existing };
+                delete existingComparable.sourceLineId;
+                if (isDeepStrictEqual(existingComparable, comparable)) {
+                    items.push({ id, kind: 'Skip', adapter: 'mcp', description: msg('adapter.mcpSame', { serverName: server.serverName }), severity: 'info' });
+                }
+                else {
+                    items.push({
+                        id, kind: 'Conflict', adapter: 'mcp',
+                        description: msg('adapter.mcpDiff', { serverName: server.serverName }),
+                        detail: `current=${JSON.stringify(existingComparable)} imported=${JSON.stringify(comparable)}`.slice(0, 200),
+                        severity: 'warning',
+                        target: { adapter: 'mcp', ref: existing.sourceLineId },
+                    });
+                }
+            }
+        }
+        return items;
+    }
+    async applyItem(item, ctx) {
+        const msg = ctx.msg;
+        const serverName = item.id.replace(/^mcp:/, '');
+        const data = ctx.sections.get('mcp');
+        const server = data?.servers.find((s) => s.serverName === serverName);
+        if (!server)
+            return { ok: false, message: msg('adapter.mcpMissing', { serverName }) };
+        const ref = item.target?.ref;
+        if (!ref)
+            return { ok: false, message: msg('adapter.missingTargetRef') };
+        const raw = buildMcpPatchLine(ref, server);
+        await ctx.target.patchFile.applyPatchChanges(USER_PATCH_FILE, [
+            { lineId: ref, raw, action: item.kind === 'Create' ? 'insert' : 'update' },
+        ]);
+        return { ok: true, needsRestart: true, message: msg('adapter.mcpWritten', { serverName }) };
+    }
+    async validate(data, msg = zhMsg) {
+        const issues = [];
+        if (data === null || typeof data !== 'object') {
+            return { valid: false, issues: [{ path: '$', message: msg('adapter.validate.object', { subject: 'mcp' }), severity: 'error' }] };
+        }
+        if (data.version !== 1) {
+            issues.push({ path: 'version', message: msg('adapter.validate.version', { value: String(data.version) }), severity: 'error' });
+        }
+        if (!Array.isArray(data.servers)) {
+            issues.push({ path: 'servers', message: msg('adapter.validate.array', { subject: 'servers' }), severity: 'error' });
+        }
+        else {
+            for (const s of data.servers) {
+                if (s === null || typeof s !== 'object' || typeof s.serverName !== 'string' || s.serverName === '') {
+                    issues.push({ path: 'servers[]', message: msg('adapter.validate.serverName'), severity: 'error' });
+                }
+            }
+        }
+        return { valid: issues.filter((i) => i.severity === 'error').length === 0, issues };
+    }
+}
+//# sourceMappingURL=mcp.js.map

package/lib/adapters/plugin-files.d.ts

@@ -0,0 +1,18 @@
+import type { MsgFunc } from '../core/messages.ts';
+import type { FilesSection } from '../schema/types.ts';
+import type { ApplyResult, ConfigAdapter, ExportOptions, ExportSection, HostContext, ImportContext, PlanItem, ValidationResult } from '../core/types.ts';
+export declare const DEFAULT_PLUGIN_FILE_WHITELIST: readonly string[];
+export declare class PluginFilesAdapter implements ConfigAdapter<FilesSection> {
+    readonly id: 'pluginFiles';
+    readonly displayName = "Plugin Files";
+    readonly defaultIncluded = false;
+    readonly portability: 'deviceSpecific';
+    private readonly whitelist;
+    /** 约定配置目录（相对 ~/.dsh 根，如 'plugin-config'）；递归收集其下所有文件。undefined = 不收集。 */
+    private readonly collectDir?;
+    constructor(whitelist?: string[], collectDir?: string);
+    export(ctx: HostContext, _options: ExportOptions): Promise<ExportSection<FilesSection>>;
+    analyzeImport(data: FilesSection, ctx: ImportContext): Promise<PlanItem[]>;
+    applyItem(item: PlanItem, ctx: ImportContext): Promise<ApplyResult>;
+    validate(data: FilesSection, msg?: MsgFunc): Promise<ValidationResult>;
+}

package/lib/adapters/plugin-files.js

@@ -0,0 +1,142 @@
+/**
+ * pluginFiles 分区 adapter（可选，设计 §3.3/§1.2）：
+ * 数据源 = 插件自有配置文件（相对 ~/.dsh 根）：
+ *   1. 白名单固定文件（dsh-ssh.json、pet.json 等，避免扫描整个主目录）；
+ *   2. 约定的插件配置目录（collectDir，如 plugin-config/）递归收集其下所有文件。
+ * relativePath 一律是「相对 ~/.dsh 根」的完整路径（与白名单文件一致），
+ * 导入时按同一相对路径写回原位置。默认关闭（defaultIncluded=false，用户显式勾选才导出）。
+ */
+import { sha256Hex } from '../utils/hashing.js';
+import { msgOf, zhMsg } from '../core/messages.js';
+import { linkWarnings, listFilesDetailed } from './link-report.js';
+import { isPathSafe, isReservedInternalRel } from '../utils/paths.js';
+export const DEFAULT_PLUGIN_FILE_WHITELIST = ['dsh-ssh.json', 'pet.json'];
+export class PluginFilesAdapter {
+    id = 'pluginFiles';
+    displayName = 'Plugin Files';
+    defaultIncluded = false;
+    portability = 'deviceSpecific';
+    whitelist;
+    /** 约定配置目录（相对 ~/.dsh 根，如 'plugin-config'）；递归收集其下所有文件。undefined = 不收集。 */
+    collectDir;
+    constructor(whitelist = [...DEFAULT_PLUGIN_FILE_WHITELIST], collectDir) {
+        this.whitelist = whitelist;
+        if (collectDir !== undefined && collectDir !== '' && !isPathSafe(collectDir)) {
+            throw new Error(`pluginFiles collectDir 非法（须为相对 ~/.dsh 根的安全路径）: ${collectDir}`);
+        }
+        this.collectDir = collectDir === '' ? undefined : collectDir;
+    }
+    async export(ctx, _options) {
+        const files = [];
+        const seen = new Set();
+        // 1) 白名单固定文件（不存在则跳过，dsh-ssh.json 等为按需创建）
+        for (const rel of this.whitelist) {
+            try {
+                const data = await ctx.fs.readFile(rel);
+                files.push({ relativePath: rel, data, contentHash: sha256Hex(data) });
+                seen.add(rel);
+            }
+            catch {
+                /* 白名单文件不存在则跳过 */
+            }
+        }
+        // 2) 约定配置目录递归收集（相对 ~/.dsh 根的完整路径；与白名单文件去重）
+        // issue #37：与 skills 等同一条遍历（跟随 junction/符号链接 + 跳过留痕）
+        let listing = { paths: [], skippedLinks: [], followedLinks: 0, unreadableDirs: [] };
+        if (this.collectDir !== undefined) {
+            try {
+                listing = await listFilesDetailed(ctx.fs, this.collectDir);
+            }
+            catch {
+                // 目录不存在视为空
+            }
+            const rels = listing.paths;
+            for (const rel of rels) {
+                if (seen.has(rel))
+                    continue;
+                try {
+                    const data = await ctx.fs.readFile(rel);
+                    files.push({ relativePath: rel, data, contentHash: sha256Hex(data) });
+                }
+                catch {
+                    continue;
+                }
+            }
+        }
+        return {
+            sectionId: 'pluginFiles',
+            data: { version: 1, files },
+            counts: { files: files.length },
+            warnings: linkWarnings(msgOf(ctx), this.displayName, listing),
+        };
+    }
+    async analyzeImport(data, ctx) {
+        const msg = ctx.msg;
+        const items = [];
+        for (const file of data.files) {
+            const id = `pluginFile:${file.relativePath}`;
+            // F23 修复：不可信 import 不得写内部 control-plane namespace（snapshots/transactions/locks/safe-mode）
+            if (isReservedInternalRel(file.relativePath)) {
+                items.push({
+                    id, kind: 'Error', adapter: 'pluginFiles',
+                    description: msg('adapter.pluginFileReserved', { path: file.relativePath }), severity: 'error',
+                });
+                continue;
+            }
+            let current = null;
+            try {
+                current = await ctx.target.fs.readFile(file.relativePath);
+            }
+            catch {
+                current = null;
+            }
+            if (current === null) {
+                items.push({
+                    id, kind: 'Create', adapter: 'pluginFiles',
+                    description: msg('adapter.pluginFileCreate', { path: file.relativePath }), severity: 'info',
+                    target: { adapter: 'pluginFiles', ref: file.relativePath },
+                });
+            }
+            else if (sha256Hex(current) === file.contentHash) {
+                items.push({ id, kind: 'Skip', adapter: 'pluginFiles', description: msg('adapter.fileSame', { path: file.relativePath }), severity: 'info' });
+            }
+            else {
+                items.push({
+                    id, kind: 'Conflict', adapter: 'pluginFiles',
+                    description: msg('adapter.fileDiff', { path: file.relativePath }), severity: 'warning',
+                    target: { adapter: 'pluginFiles', ref: file.relativePath },
+                });
+            }
+        }
+        return items;
+    }
+    async applyItem(item, ctx) {
+        const ref = item.target?.ref;
+        if (!ref)
+            return { ok: false, message: ctx.msg('adapter.missingTargetRef') };
+        // F23 修复：apply 前拒绝写内部 control-plane namespace（纵深防御，analyzeImport 已标 Error）
+        if (isReservedInternalRel(ref)) {
+            return { ok: false, message: ctx.msg('adapter.pluginFileReserved', { path: ref }) };
+        }
+        const data = ctx.sections.get('pluginFiles');
+        const file = data?.files.find((f) => f.relativePath === ref);
+        if (!file)
+            return { ok: false, message: ctx.msg('adapter.dataMissingFile', { ref }) };
+        await ctx.target.fs.writeFile(ref, file.data);
+        return { ok: true };
+    }
+    async validate(data, msg = zhMsg) {
+        const issues = [];
+        if (data === null || typeof data !== 'object') {
+            return { valid: false, issues: [{ path: '$', message: msg('adapter.validate.object', { subject: 'pluginFiles' }), severity: 'error' }] };
+        }
+        if (data.version !== 1) {
+            issues.push({ path: 'version', message: msg('adapter.validate.version', { value: String(data.version) }), severity: 'error' });
+        }
+        if (!Array.isArray(data.files)) {
+            issues.push({ path: 'files', message: msg('adapter.validate.array', { subject: 'files' }), severity: 'error' });
+        }
+        return { valid: issues.filter((i) => i.severity === 'error').length === 0, issues };
+    }
+}
+//# sourceMappingURL=plugin-files.js.map

package/lib/adapters/plugins.d.ts

@@ -0,0 +1,41 @@
+import type { PackLocalPluginsResult } from '../core/local-plugin-pack.ts';
+import type { MsgFunc } from '../core/messages.ts';
+import type { PluginEntry, PluginsSection } from '../schema/types.ts';
+import type { ApplyResult, ConfigAdapter, ExportOptions, ExportSection, HostContext, ImportContext, PlanItem, ValidationResult } from '../core/types.ts';
+export declare const USER_PATCH_FILE = "cordis.patch.yml";
+/**
+ * 本地源插件打包钩子（由宿主注入，见 src/index.ts createAdapters）。
+ * 返回打包结果（含字节与重写后的 spec）；不注入 = 不做本地源打包（保持旧行为）。
+ */
+export type LocalPluginPackHook = (plugins: PluginEntry[], ctx: HostContext) => Promise<PackLocalPluginsResult>;
+/** 本地插件 tarball 解包到 homeDir 内的固定缓存目录（相对 $DSH_HOME）。 */
+export declare const LOCAL_TARBALL_CACHE_REL = "dsh-config-manager/local-plugins";
+/** 归档内相对路径 → 缓存目录下的安全文件名（拒绝任何路径穿越）。 */
+export declare function localTarballCacheName(relativePath: string): string;
+/** profile 目录相对 $DSH_HOME 的路径（patches/ 与 pnpm-workspace.yaml 都挂在这里）。 */
+export declare const PNPM_PROFILE_DIR: (profile: string | undefined) => string;
+/** pnpm-workspace.yaml 相对 $DSH_HOME 的路径（plugins 分区内按「插件安装配置」管理）。 */
+export declare const PNPM_WORKSPACE_REL: (profile: string | undefined) => string;
+/** 单个 patch 文件随备份迁移的体积上限（issue #35；patch 是纯文本，超过说明放错了东西）。 */
+export declare const MAX_PATCH_FILE_BYTES: number;
+export declare class PluginsAdapter implements ConfigAdapter<PluginsSection> {
+    readonly id: 'plugins';
+    readonly displayName = "Plugins";
+    readonly defaultIncluded = true;
+    readonly portability: 'portable';
+    /** 插件自身包名：导出 plugins 分区时不列自己（避免备份里出现「当前正在生成备份的插件」的自引用条目） */
+    private readonly selfName;
+    /** T1：本地源（link:/file:）插件打包钩子；未注入 = 不打包（保持改造前行为） */
+    private readonly localPack;
+    constructor(selfName?: string, localPack?: LocalPluginPackHook);
+    export(ctx: HostContext, _options: ExportOptions): Promise<ExportSection<PluginsSection>>;
+    /**
+     * 导入后目标机**可能**存在的 patch 文件集合（相对 profile 目录）——issue #35。
+     * = 备份携带的 patchFiles ∪ 目标机本来就有的文件。只用于判定「声明能否被满足」，
+     * 不做任何写入（写入在 applyItem 内、且先于 pnpm-workspace.yaml）。
+     */
+    private patchAvailability;
+    analyzeImport(data: PluginsSection, ctx: ImportContext): Promise<PlanItem[]>;
+    applyItem(item: PlanItem, ctx: ImportContext): Promise<ApplyResult>;
+    validate(data: PluginsSection, msg?: MsgFunc): Promise<ValidationResult>;
+}