dsh-config-manager 0.1.0

package/lib/adapters/providers.js

@@ -0,0 +1,143 @@
+/**
+ * providers 分区 adapter（设计 §3.3/§13.1）：
+ * 数据源 = settings.yaml 的 llm-deepseek / llm-pi-ai section（providers 与 models 天然同 section，不拆文件）。
+ *
+ * 导入走 settings 写通道（replace llm-* namespace + 乐观锁）：
+ * 每项携带 raw（该 namespace 的完整 redacted 值）用于整体写回，apiKey 值经 credentials 状态占位（不导出值）。
+ */
+import { isDeepStrictEqual } from 'node:util';
+import { resolveNamespaces } from "./settings.js";
+export const DEFAULT_PROVIDER_NAMESPACES = ['llm-deepseek', 'llm-pi-ai'];
+/** 无 raw 时的兜底重建：只取 ProviderEntry 已知字段 */
+function stripEntry(entry) {
+    const out = {};
+    for (const key of ['apiKeyEnv', 'displayName', 'baseURL', 'models', 'modelOverrides', 'reasoning', 'transport', 'retryPolicy']) {
+        if (entry[key] !== undefined)
+            out[key] = entry[key];
+    }
+    return out;
+}
+export class ProvidersAdapter {
+    id = 'providers';
+    displayName = 'Providers & Models';
+    defaultIncluded = true;
+    portability = 'portable';
+    namespaces;
+    constructor(namespaces = DEFAULT_PROVIDER_NAMESPACES) {
+        this.namespaces = namespaces;
+    }
+    async export(ctx, _options) {
+        const providers = {};
+        const warnings = [];
+        for (const ns of await resolveNamespaces(this.namespaces, ctx)) {
+            let info;
+            try {
+                info = await ctx.settings.describe(ns, { redactSecrets: true });
+            }
+            catch (err) {
+                warnings.push(`provider namespace ${ns} 读取失败（可能未配置）: ${err instanceof Error ? err.message : String(err)}`);
+                continue;
+            }
+            const value = (info.value ?? {});
+            // llm-pi-ai 形态：value.providers = { route: {...} }；llm-deepseek 形态：value 即单 provider 配置
+            const routes = value.providers !== null && typeof value.providers === 'object'
+                ? Object.entries(value.providers)
+                : [[ns, value]];
+            for (const [route, pv] of routes) {
+                // 每个 route 独立深拷贝 secrets / pv / raw：同一 namespace 的多 route 若共享引用，
+                // m4 强化版 createSecretScanner 的 visited 循环检测会误判「检测到循环引用」（见 providers.test.ts）。
+                providers[route] = {
+                    route,
+                    namespace: ns,
+                    revision: info.revision,
+                    secrets: structuredClone(info.secrets),
+                    ...structuredClone(pv),
+                    raw: structuredClone(value),
+                };
+            }
+        }
+        return {
+            sectionId: 'providers',
+            data: { version: 1, providers },
+            counts: { providers: Object.keys(providers).length },
+            warnings,
+        };
+    }
+    async analyzeImport(data, ctx) {
+        const items = [];
+        for (const [route, entry] of Object.entries(data.providers)) {
+            const id = `provider:${route}`;
+            let current = null;
+            try {
+                current = await ctx.target.settings.describe(entry.namespace, { redactSecrets: true });
+            }
+            catch {
+                current = null;
+            }
+            if (current === null) {
+                items.push({
+                    id, kind: 'Create', adapter: 'providers',
+                    description: `创建 Provider ${route}（namespace ${entry.namespace}）`, severity: 'info',
+                    target: { adapter: 'providers', ref: entry.namespace },
+                });
+            }
+            else if (isDeepStrictEqual(current.value, entry.raw ?? stripEntry(entry))) {
+                items.push({ id, kind: 'Skip', adapter: 'providers', description: `Provider ${route} 已一致`, severity: 'info' });
+            }
+            else {
+                items.push({
+                    id, kind: 'Conflict', adapter: 'providers',
+                    description: `Provider ${route} 与目标不同`,
+                    detail: `namespace=${entry.namespace} current=${JSON.stringify(current.value)} imported=${JSON.stringify(entry.raw ?? stripEntry(entry))}`.slice(0, 200),
+                    severity: 'warning', target: { adapter: 'providers', ref: entry.namespace },
+                });
+            }
+        }
+        return items;
+    }
+    async applyItem(item, ctx) {
+        const route = item.id.replace(/^provider:/, '');
+        const data = ctx.sections.get('providers');
+        const entry = data?.providers[route];
+        if (!entry)
+            return { ok: false, message: `导入数据缺少 provider ${route}` };
+        const value = entry.raw ?? stripEntry(entry);
+        let expected;
+        try {
+            expected = (await ctx.target.settings.describe(entry.namespace, { redactSecrets: true })).revision;
+        }
+        catch {
+            expected = undefined; // 目标 namespace 不存在（Create）
+        }
+        await ctx.target.settings.replace(entry.namespace, value, expected);
+        return { ok: true };
+    }
+    async validate(data) {
+        const issues = [];
+        if (data === null || typeof data !== 'object') {
+            return { valid: false, issues: [{ path: '$', message: 'providers 数据必须是对象', severity: 'error' }] };
+        }
+        if (data.version !== 1) {
+            issues.push({ path: 'version', message: `version 必须为 1（收到 ${String(data.version)}）`, severity: 'error' });
+        }
+        if (data.providers === null || typeof data.providers !== 'object') {
+            issues.push({ path: 'providers', message: '缺少 providers 对象', severity: 'error' });
+        }
+        else {
+            for (const [route, entry] of Object.entries(data.providers)) {
+                if (entry === null || typeof entry !== 'object') {
+                    issues.push({ path: `providers.${route}`, message: 'provider 记录必须是对象', severity: 'error' });
+                    continue;
+                }
+                if (typeof entry.namespace !== 'string' || entry.namespace === '') {
+                    issues.push({ path: `providers.${route}.namespace`, message: '缺少来源 namespace', severity: 'error' });
+                }
+                if (typeof entry.revision !== 'number') {
+                    issues.push({ path: `providers.${route}.revision`, message: 'revision 必须是数字', severity: 'error' });
+                }
+            }
+        }
+        return { valid: issues.filter((i) => i.severity === 'error').length === 0, issues };
+    }
+}
+//# sourceMappingURL=providers.js.map

package/lib/adapters/providers.js.map

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

package/lib/adapters/sessions.d.ts

@@ -0,0 +1,14 @@
+/**
+ * sessions 分区 adapter（默认关，设计 §3.3/§15）：
+ * 数据源 = ~/.dsh/sessions/<projectKey>/<sessionId>/…（zstd jsonl，含敏感信息）。
+ * defaultIncluded=false：Quick Export 不包含，用户显式勾选才导出（v1 文件级复制）。
+ * 研究报告 §4.9：DSH 无会话批量导出 API，逐会话文件复制是唯一通道。
+ */
+import { FileCollectionAdapter } from './file-collection.ts';
+export declare class SessionsAdapter extends FileCollectionAdapter {
+    readonly id: "sessions";
+    readonly displayName = "Sessions";
+    readonly defaultIncluded = false;
+    readonly portability: "deviceSpecific";
+    readonly baseDir = "sessions";
+}

package/lib/adapters/sessions.js

@@ -0,0 +1,15 @@
+/**
+ * sessions 分区 adapter（默认关，设计 §3.3/§15）：
+ * 数据源 = ~/.dsh/sessions/<projectKey>/<sessionId>/…（zstd jsonl，含敏感信息）。
+ * defaultIncluded=false：Quick Export 不包含，用户显式勾选才导出（v1 文件级复制）。
+ * 研究报告 §4.9：DSH 无会话批量导出 API，逐会话文件复制是唯一通道。
+ */
+import { FileCollectionAdapter } from "./file-collection.js";
+export class SessionsAdapter extends FileCollectionAdapter {
+    id = 'sessions';
+    displayName = 'Sessions';
+    defaultIncluded = false;
+    portability = 'deviceSpecific';
+    baseDir = 'sessions';
+}
+//# sourceMappingURL=sessions.js.map

package/lib/adapters/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/adapters/sessions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,OAAO,eAAgB,SAAQ,qBAAqB;IAC/C,EAAE,GAAG,UAAmB,CAAC;IACzB,WAAW,GAAG,UAAU,CAAC;IACzB,eAAe,GAAG,KAAK,CAAC;IACxB,WAAW,GAAG,gBAAyB,CAAC;IACxC,OAAO,GAAG,UAAU,CAAC;CAC/B"}

package/lib/adapters/settings.d.ts

@@ -0,0 +1,23 @@
+import type { NamespaceRecord, SettingsSection } from '../schema/types.ts';
+import type { ApplyResult, ConfigAdapter, ExportOptions, ExportSection, HostContext, ImportContext, PlanItem, ValidationResult } from '../core/types.ts';
+/** namespace 清单提供者：宿主从 settings.yaml 顶层 key / 插件注册表获得 */
+export type NamespaceProvider = (ctx: HostContext) => Promise<string[]> | string[];
+export declare function resolveNamespaces(namespaces: string[] | NamespaceProvider, ctx: HostContext): Promise<string[]>;
+/** 批量读取 namespace 的 redacted 记录（settings/ui 共用；单项失败跳过并告警） */
+export declare function collectNamespaceRecords(ctx: HostContext, names: string[], warnings: string[]): Promise<Record<string, NamespaceRecord>>;
+/** 对比导入记录与目标当前值：不存在 → Create；一致 → Skip；不同 → Conflict（纯计算，零写入） */
+export declare function planNamespaceItems(data: Record<string, NamespaceRecord>, adapter: 'settings' | 'ui', ctx: ImportContext): Promise<PlanItem[]>;
+/** 写入单个 namespace（settings/ui 共用）：读时锁 + expectedRevision 乐观锁，防覆盖并发修改 */
+export declare function applyNamespaceItem(item: PlanItem, sectionId: 'settings' | 'ui', ctx: ImportContext): Promise<ApplyResult>;
+export declare class SettingsAdapter implements ConfigAdapter<SettingsSection> {
+    readonly id: "settings";
+    readonly displayName = "Settings";
+    readonly defaultIncluded = true;
+    readonly portability: "portable";
+    private readonly namespaces;
+    constructor(namespaces?: string[] | NamespaceProvider);
+    export(ctx: HostContext, _options: ExportOptions): Promise<ExportSection<SettingsSection>>;
+    analyzeImport(data: SettingsSection, ctx: ImportContext): Promise<PlanItem[]>;
+    applyItem(item: PlanItem, ctx: ImportContext): Promise<ApplyResult>;
+    validate(data: SettingsSection): Promise<ValidationResult>;
+}

package/lib/adapters/settings.js

@@ -0,0 +1,142 @@
+/**
+ * settings 分区 adapter（设计 §3.3/§4.1/§4.2）：
+ * 数据源 = ~/.dsh/settings.yaml 中「非 UI 类」namespace（经 ctx.settings.describe({redactSecrets:true})）。
+ *
+ * 说明：DSH settings 服务没有「枚举全部 namespace」的 API（研究报告 §3.2），
+ * 因此 namespace 清单由宿主注入（真实实现可从 settings.yaml 顶层 key 解析）。
+ * 默认只导出名单内且不属于 UI 类（isUiNamespace）的 namespace，与 ui adapter 互斥并集 = 全部设置。
+ */
+import { isDeepStrictEqual } from 'node:util';
+import { isUiNamespace } from "./ui.js";
+export async function resolveNamespaces(namespaces, ctx) {
+    return typeof namespaces === 'function' ? namespaces(ctx) : namespaces;
+}
+/** 批量读取 namespace 的 redacted 记录（settings/ui 共用；单项失败跳过并告警） */
+export async function collectNamespaceRecords(ctx, names, warnings) {
+    const namespaces = {};
+    for (const name of names) {
+        try {
+            const info = await ctx.settings.describe(name, { redactSecrets: true });
+            namespaces[name] = {
+                value: info.value,
+                base: info.base,
+                revision: info.revision,
+                applies: info.applies,
+                secrets: info.secrets,
+            };
+        }
+        catch (err) {
+            warnings.push(`设置 namespace ${name} 读取失败: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return namespaces;
+}
+/** 对比导入记录与目标当前值：不存在 → Create；一致 → Skip；不同 → Conflict（纯计算，零写入） */
+export async function planNamespaceItems(data, adapter, ctx) {
+    const items = [];
+    for (const [name, rec] of Object.entries(data)) {
+        let current = null;
+        try {
+            current = await ctx.target.settings.describe(name, { redactSecrets: true });
+        }
+        catch {
+            current = null;
+        }
+        const id = `${adapter}:${name}`;
+        if (current === null) {
+            items.push({
+                id, kind: 'Create', adapter, description: `创建设置 ${name}`, severity: 'info',
+                target: { adapter, ref: name },
+            });
+        }
+        else if (isDeepStrictEqual(current.value, rec.value)) {
+            items.push({ id, kind: 'Skip', adapter, description: `设置 ${name} 已一致`, severity: 'info' });
+        }
+        else {
+            items.push({
+                id, kind: 'Conflict', adapter, description: `设置 ${name} 与目标不同`,
+                detail: `current=${JSON.stringify(current.value)} imported=${JSON.stringify(rec.value)}`.slice(0, 200),
+                severity: 'warning', target: { adapter, ref: name },
+            });
+        }
+    }
+    return items;
+}
+/** 写入单个 namespace（settings/ui 共用）：读时锁 + expectedRevision 乐观锁，防覆盖并发修改 */
+export async function applyNamespaceItem(item, sectionId, ctx) {
+    const ref = item.target?.ref;
+    if (!ref)
+        return { ok: false, message: '缺少 target.ref' };
+    const data = ctx.sections.get(sectionId);
+    const rec = data?.namespaces?.[ref];
+    if (!rec)
+        return { ok: false, message: `导入数据缺少 namespace ${ref}` };
+    // 写入前读当前 revision 作为 expectedRevision（读时锁）：目标不存在（Create）则不带锁提交
+    let expected;
+    try {
+        expected = (await ctx.target.settings.describe(ref, { redactSecrets: true })).revision;
+    }
+    catch {
+        expected = undefined;
+    }
+    await ctx.target.settings.replace(ref, rec.value, expected);
+    return { ok: true };
+}
+export class SettingsAdapter {
+    id = 'settings';
+    displayName = 'Settings';
+    defaultIncluded = true;
+    portability = 'portable';
+    namespaces;
+    constructor(namespaces = []) {
+        this.namespaces = namespaces;
+    }
+    async export(ctx, _options) {
+        const warnings = [];
+        const all = await resolveNamespaces(this.namespaces, ctx);
+        const nonUi = all.filter((n) => !isUiNamespace(n));
+        if (nonUi.length === 0)
+            warnings.push('未配置 settings namespace 清单，settings 分区为空');
+        const namespaces = await collectNamespaceRecords(ctx, nonUi, warnings);
+        return {
+            sectionId: 'settings',
+            data: { version: 1, namespaces },
+            counts: { namespaces: Object.keys(namespaces).length },
+            warnings,
+        };
+    }
+    async analyzeImport(data, ctx) {
+        return planNamespaceItems(data.namespaces, 'settings', ctx);
+    }
+    async applyItem(item, ctx) {
+        return applyNamespaceItem(item, 'settings', ctx);
+    }
+    async validate(data) {
+        const issues = [];
+        if (data === null || typeof data !== 'object') {
+            return { valid: false, issues: [{ path: '$', message: 'settings 数据必须是对象', severity: 'error' }] };
+        }
+        if (data.version !== 1) {
+            issues.push({ path: 'version', message: `version 必须为 1（收到 ${String(data.version)}）`, severity: 'error' });
+        }
+        if (data.namespaces === null || typeof data.namespaces !== 'object') {
+            issues.push({ path: 'namespaces', message: '缺少 namespaces 对象', severity: 'error' });
+        }
+        else {
+            for (const [name, rec] of Object.entries(data.namespaces)) {
+                if (rec === null || typeof rec !== 'object') {
+                    issues.push({ path: `namespaces.${name}`, message: 'namespace 记录必须是对象', severity: 'error' });
+                    continue;
+                }
+                if (typeof rec.revision !== 'number') {
+                    issues.push({ path: `namespaces.${name}.revision`, message: 'revision 必须是数字', severity: 'error' });
+                }
+                if (!('value' in rec)) {
+                    issues.push({ path: `namespaces.${name}.value`, message: '缺少 value', severity: 'error' });
+                }
+            }
+        }
+        return { valid: issues.filter((i) => i.severity === 'error').length === 0, issues };
+    }
+}
+//# sourceMappingURL=settings.js.map

package/lib/adapters/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/adapters/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAM9C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAKxC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAwC,EACxC,GAAgB;IAEhB,OAAO,OAAO,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;AACzE,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,GAAgB,EAChB,KAAe,EACf,QAAkB;IAElB,MAAM,UAAU,GAAoC,EAAE,CAAC;IACvD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACxE,UAAU,CAAC,IAAI,CAAC,GAAG;gBACjB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,gBAAgB,IAAI,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClG,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAqC,EACrC,OAA0B,EAC1B,GAAkB;IAElB,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,IAAI,OAAO,GAAyB,IAAI,CAAC;QACzC,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,MAAM,EAAE,GAAG,GAAG,OAAO,IAAI,IAAI,EAAE,CAAC;QAChC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM;gBAC1E,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE;aAC/B,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACvD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,IAAI,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7F,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,IAAI,QAAQ;gBAC9D,MAAM,EAAE,WAAW,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBACtG,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE;aACpD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAc,EACd,SAA4B,EAC5B,GAAkB;IAElB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC;IAC7B,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IACzD,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAiE,CAAC;IACzG,MAAM,GAAG,GAAG,IAAI,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,oBAAoB,GAAG,EAAE,EAAE,CAAC;IACnE,+DAA+D;IAC/D,IAAI,QAA4B,CAAC;IACjC,IAAI,CAAC;QACH,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IACzF,CAAC;IAAC,MAAM,CAAC;QACP,QAAQ,GAAG,SAAS,CAAC;IACvB,CAAC;IACD,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC5D,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,OAAO,eAAe;IACjB,EAAE,GAAG,UAAmB,CAAC;IACzB,WAAW,GAAG,UAAU,CAAC;IACzB,eAAe,GAAG,IAAI,CAAC;IACvB,WAAW,GAAG,UAAmB,CAAC;IAC1B,UAAU,CAA+B;IAE1D,YAAY,aAA2C,EAAE;QACvD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAgB,EAAE,QAAuB;QACpD,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACjF,MAAM,UAAU,GAAG,MAAM,uBAAuB,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QACvE,OAAO;YACL,SAAS,EAAE,UAAU;YACrB,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE;YAChC,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE;YACtD,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAAqB,EAAE,GAAkB;QAC3D,OAAO,kBAAkB,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAc,EAAE,GAAkB;QAChD,OAAO,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAqB;QAClC,MAAM,MAAM,GAA+B,EAAE,CAAC;QAC9C,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QACnG,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,oBAAoB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5G,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YACpE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACtF,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC1D,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;oBAC5C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,IAAI,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;oBAC7F,SAAS;gBACX,CAAC;gBACD,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;oBACrC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,IAAI,WAAW,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;gBACrG,CAAC;gBACD,IAAI,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC,EAAE,CAAC;oBACtB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,IAAI,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC5F,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACtF,CAAC;CACF"}

package/lib/adapters/skills.d.ts

@@ -0,0 +1,13 @@
+/**
+ * skills 分区 adapter（设计 §3.3）：
+ * 数据源 = ~/.dsh/skills/（flat .md + 目录 bundle；dsh-skill-filesystem 发现）。
+ * 仅迁移用户主目录技能；~/.agents/skills、项目级技能默认不迁（研究报告 §2.2）。
+ */
+import { FileCollectionAdapter } from './file-collection.ts';
+export declare class SkillsAdapter extends FileCollectionAdapter {
+    readonly id: "skills";
+    readonly displayName = "Skills";
+    readonly defaultIncluded = true;
+    readonly portability: "portable";
+    readonly baseDir = "skills";
+}

package/lib/adapters/skills.js

@@ -0,0 +1,14 @@
+/**
+ * skills 分区 adapter（设计 §3.3）：
+ * 数据源 = ~/.dsh/skills/（flat .md + 目录 bundle；dsh-skill-filesystem 发现）。
+ * 仅迁移用户主目录技能；~/.agents/skills、项目级技能默认不迁（研究报告 §2.2）。
+ */
+import { FileCollectionAdapter } from "./file-collection.js";
+export class SkillsAdapter extends FileCollectionAdapter {
+    id = 'skills';
+    displayName = 'Skills';
+    defaultIncluded = true;
+    portability = 'portable';
+    baseDir = 'skills';
+}
+//# sourceMappingURL=skills.js.map

package/lib/adapters/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/adapters/skills.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,OAAO,aAAc,SAAQ,qBAAqB;IAC7C,EAAE,GAAG,QAAiB,CAAC;IACvB,WAAW,GAAG,QAAQ,CAAC;IACvB,eAAe,GAAG,IAAI,CAAC;IACvB,WAAW,GAAG,UAAmB,CAAC;IAClC,OAAO,GAAG,QAAQ,CAAC;CAC7B"}

package/lib/adapters/test-helpers.d.ts

@@ -0,0 +1,99 @@
+import { type Logger } from '../utils/logger.ts';
+import { sha256Hex } from '../utils/hashing.ts';
+import type { CredentialsFacade, FileSystemFacade, HostContext, ImportContext, NamespaceInfo, PatchFileFacade, PluginInfo, PluginsFacade, SettingsFacade, Snapshot, SnapshotStore, WorkspaceFacade } from '../core/types.ts';
+import type { Manifest, WorkspaceRecord } from '../schema/types.ts';
+export declare class MemFs implements FileSystemFacade {
+    files: Map<string, Uint8Array<ArrayBufferLike>>;
+    private readonly homeDir;
+    constructor(homeDir: string);
+    private key;
+    readFile(relPath: string): Promise<Uint8Array>;
+    writeFile(relPath: string, data: Uint8Array): Promise<void>;
+    exists(relPath: string): Promise<boolean>;
+    copy(from: string, to: string): Promise<void>;
+    remove(relPath: string): Promise<void>;
+    listRecursive(dir: string): Promise<string[]>;
+    mkdir(): Promise<void>;
+}
+export declare class MemSettings implements SettingsFacade {
+    ns: Map<string, {
+        value: unknown;
+        base?: unknown;
+        revision: number;
+        applies?: string[];
+        secrets: {
+            path: string[];
+            set: boolean;
+        }[];
+    }>;
+    describe(namespace: string, _opts?: {
+        redactSecrets?: boolean;
+    }): Promise<NamespaceInfo>;
+    replace(namespace: string, value: unknown, expectedRevision?: number): Promise<void>;
+    update?(namespace: string, patch: unknown, expectedRevision?: number): Promise<void>;
+}
+export declare class MemCredentials implements CredentialsFacade {
+    values: Map<string, string>;
+    describe(ref: string): Promise<{
+        configured: boolean;
+        source?: string;
+        writable?: boolean;
+    }>;
+    set(ref: string, value: string): Promise<void>;
+    unset(ref: string): Promise<void>;
+}
+export declare class MemPlugins implements PluginsFacade {
+    installed: Map<string, PluginInfo>;
+    listInstalled(): Promise<PluginInfo[]>;
+    install(pkg: string): Promise<{
+        needsRestart: boolean;
+    }>;
+}
+export declare class MemWorkspace implements WorkspaceFacade {
+    records: Map<string, WorkspaceRecord>;
+    listRecords(): Promise<WorkspaceRecord[]>;
+    writeRecord(r: WorkspaceRecord): Promise<void>;
+    removeRecord(id: string): Promise<void>;
+}
+export declare class MemPatch implements PatchFileFacade {
+    lines: Map<string, {
+        lineId: string;
+        raw: unknown;
+    }>;
+    readPatchLines(_file: string): Promise<{
+        lineId: string;
+        raw: unknown;
+    }[]>;
+    applyPatchChanges(_file: string, changes: {
+        lineId: string;
+        raw: unknown;
+        action: 'insert' | 'update' | 'remove';
+    }[]): Promise<void>;
+}
+export declare class MemSnapshotStore implements SnapshotStore {
+    snapshots: Map<string, Snapshot>;
+    blobs: Map<string, Uint8Array<ArrayBufferLike>>;
+    save(snapshot: Snapshot, blobs?: Map<string, Uint8Array>): Promise<string>;
+    load(id: string): Promise<Snapshot>;
+    readBlob(id: string, blobPath: string): Promise<Uint8Array>;
+}
+export declare class MockHostContext implements HostContext {
+    platform: string;
+    arch: string;
+    homeDir: string;
+    dshVersion: string;
+    log: Logger;
+    settings: MemSettings;
+    credentials: MemCredentials;
+    plugins: MemPlugins;
+    workspace: MemWorkspace;
+    patchFile: MemPatch;
+    fs: MemFs;
+    constructor(platform: string, homeDir: string);
+}
+export declare function makeContext(platform: string, homeDir: string): MockHostContext;
+/** 构造最小合法 manifest（adapter 单测用；真实 manifest 由 exporter 生成） */
+export declare function makeManifest(platform?: string): Manifest;
+/** 构造 ImportContext（adapter 单测用；sections 键运行时即 SectionId 字符串） */
+export declare function makeImportContext(target: HostContext, sections: ReadonlyMap<string, unknown>, overrides?: Partial<ImportContext>): ImportContext;
+export { sha256Hex };