dsh-config-manager 0.1.12 → 0.1.13

package/lib/core/restore.js

@@ -0,0 +1,505 @@
+/**
+ * 离线恢复引擎（M2，criterion m2-restore-restores；设计 §8 / 规范 §27）。
+ *
+ * 与 rollback.ts 的区别：rollback 是导入失败时的自动补偿（在线，经 HostContext
+ * 调 DSH 服务）；本模块是用户主动的「恢复到导入前状态」——纯离线，零 DSH 运行时
+ * 依赖（仅 node 内置 + 本项目零依赖工具），直接操作文件系统与官方 dsh plugin CLI：
+ *
+ *  1. 宿主整文件还原：hostFileBackups（settings.yaml / settings.json / 用户层与
+ *     profile 层 cordis.patch.yml）的 blob 写回 $DSH_HOME；快照时不存在、现已出现
+ *     的文件删除（restore = 还原到快照那一刻的状态，含移除导入期间新增激活行）；
+ *  2. pre-restore 双保险：任何覆盖/删除前，把当前文件复制到
+ *     <snapshotDir>/pre-restore/（可人工反悔）；
+ *  3. 插件撤销：beforePlugins（导入前基线）与当前已装对比 → 导入期间新增的插件
+ *     走官方 `dsh plugin --profile <p> remove <pkg>`（runDshPlugin 通道，零新子进程代码）；
+ *  4. file 类条目补偿：skills/agentPresets/pluginFiles/sessions 原文件 blob 写回 /
+ *     快照时不存在则删除（与 rollback.ts 语义一致）；
+ *  5. credentials：DSH 不回读值 → existed=true 只生成 manualHint，绝不自动改写。
+ *
+ * settingsNamespace / patchLine 条目由宿主整文件还原覆盖（settings.yaml /
+ * cordis.patch.yml）；workspaceRecord 离线无法经 DSH storages 恢复 → 如实提示。
+ * 旧快照（无 beforePlugins / hostFileBackups）兼容：缺基线的部分只提示不动作。
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { resolveFileTarget } from "./backup.js";
+import { classifyDshPluginFailure, readInstalled, resolveProfileDir, runDshPlugin, } from "./plugin-cli.js";
+import { parseJsonSafe } from "../utils/json.js";
+/* ------------------------------------------------------------ 工具 */
+/** 快照目录内读取 snapshot.json（深度保护解析） */
+async function loadSnapshot(snapshotDir) {
+    const parsed = parseJsonSafe(await fs.readFile(path.join(snapshotDir, 'snapshot.json'), 'utf8'));
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error(`快照 ${snapshotDir} 的 snapshot.json 不是合法对象`);
+    }
+    return parsed;
+}
+async function fileExists(p) {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 越界防御：abs 必须等于 homeDir 或在 homeDir 之内 */
+function isWithinHome(homeDir, abs) {
+    const root = path.resolve(homeDir);
+    return abs === root || abs.startsWith(root + path.sep);
+}
+/** homeDir 内绝对路径（越界抛错） */
+function homeAbs(homeDir, relPath) {
+    const abs = path.resolve(homeDir, relPath);
+    if (!isWithinHome(homeDir, abs))
+        throw new Error(`路径越界: ${relPath}`);
+    return abs;
+}
+/** 快照目录内 blob 绝对路径（防 snapshot.json 里伪造 ../ 越界读） */
+function blobAbs(snapshotDir, blobPath) {
+    const abs = path.resolve(snapshotDir, blobPath);
+    if (!isWithinHome(snapshotDir, abs))
+        throw new Error(`blob 路径越界: ${blobPath}`);
+    return abs;
+}
+/** 绝对路径 → 相对 $DSH_HOME（跨平台归一为 / 分隔；越界返回空串） */
+function toRelPath(homeDir, abs) {
+    if (!isWithinHome(homeDir, abs))
+        return '';
+    return path.relative(homeDir, abs).split(path.sep).join('/');
+}
+/** file 类条目的目标绝对路径（复用 backup.ts 的基准目录规则；仅读 homeDir） */
+function resolveFileAbs(homeDir, adapter, ref) {
+    return resolveFileTarget({ homeDir }, adapter, ref);
+}
+/** settings 文件 relPath：settingsPath 覆盖优先，否则探测 settings.yaml → settings.json */
+async function resolveSettingsRelPath(homeDir, settingsPath) {
+    if (settingsPath !== undefined && settingsPath !== '') {
+        const rel = toRelPath(homeDir, path.resolve(homeDir, settingsPath));
+        return rel === '' ? undefined : rel;
+    }
+    for (const cand of ['settings.yaml', 'settings.json']) {
+        if (await fileExists(path.join(homeDir, cand)))
+            return cand;
+    }
+    return undefined;
+}
+/** 把当前文件复制到 <snapshotDir>/pre-restore/（双保险，命名含序号防碰撞） */
+async function copyToPreRestore(preDir, absPath, label, seq) {
+    const safe = label.replace(/[\\/:*?"<>|]/g, '_');
+    await fs.mkdir(preDir, { recursive: true });
+    await fs.copyFile(absPath, path.join(preDir, `${String(seq).padStart(4, '0')}-${safe}`));
+}
+/** 默认插件卸载器：官方 dsh plugin remove 通道 + 失败分类诊断 */
+async function defaultPluginUninstaller(name, profileDir, profile) {
+    const result = await runDshPlugin(profileDir, profile, ['remove', name]);
+    if (result.exitCode === 0)
+        return { ok: true };
+    const output = `${result.stderr}\n${result.stdout}`.trim();
+    const failure = classifyDshPluginFailure(output);
+    if (failure !== null) {
+        return { ok: false, message: `dsh plugin remove ${name} 失败（${failure.code}）：${failure.message}` };
+    }
+    const tail = output.split('\n').slice(-8).join('\n') || '无输出';
+    return { ok: false, message: `dsh plugin remove ${name} 失败（exit ${String(result.exitCode)}）：${tail}` };
+}
+/* ------------------------------------------------------------ planRestore */
+/**
+ * 生成恢复动作计划（dry-run 预览的唯一入口；零写入）：
+ * 读快照 + 探测当前文件/已装插件状态，输出按执行顺序排列的动作清单。
+ */
+export async function planRestore(opts) {
+    const { snapshotDir, homeDir, profile } = opts;
+    const snapshot = await loadSnapshot(snapshotDir);
+    const settingsRel = await resolveSettingsRelPath(homeDir, opts.settingsPath);
+    const actions = [];
+    // 1) 宿主整文件还原（hostFileBackups）
+    const hostBackups = snapshot.hostFileBackups ?? [];
+    for (const backup of hostBackups) {
+        let abs;
+        try {
+            abs = homeAbs(homeDir, backup.relPath);
+        }
+        catch {
+            actions.push({
+                kind: 'skip',
+                description: `宿主文件路径越界，跳过: ${backup.relPath}`,
+                target: backup.relPath,
+                detail: '快照登记路径越界，拒绝恢复',
+            });
+            continue;
+        }
+        const currentExists = await fileExists(abs);
+        if (backup.existed) {
+            if (backup.blobPath === '') {
+                actions.push({
+                    kind: 'skip',
+                    description: `宿主文件 ${backup.relPath} 缺少 blob 副本，跳过`,
+                    target: backup.relPath,
+                });
+                continue;
+            }
+            if (!(await fileExists(blobAbs(snapshotDir, backup.blobPath)))) {
+                actions.push({
+                    kind: 'skip',
+                    description: `宿主文件 ${backup.relPath} 的 blob 缺失，跳过`,
+                    target: backup.relPath,
+                });
+                continue;
+            }
+            actions.push({
+                kind: 'hostFileRestore',
+                description: `整文件还原 ${backup.relPath}`,
+                target: backup.relPath,
+                blobPath: backup.blobPath,
+                isSettings: backup.relPath === settingsRel,
+                detail: currentExists ? '还原前将备份当前文件到 pre-restore/' : '当前文件不存在，直接写入',
+            });
+        }
+        else if (currentExists) {
+            actions.push({
+                kind: 'hostFileRemove',
+                description: `移除快照时不存在、现已出现的文件 ${backup.relPath}`,
+                target: backup.relPath,
+                isSettings: backup.relPath === settingsRel,
+                detail: '删除前将备份当前文件到 pre-restore/',
+            });
+        }
+        else {
+            actions.push({
+                kind: 'skip',
+                description: `宿主文件 ${backup.relPath} 快照时不存在且当前也不存在，无动作`,
+                target: backup.relPath,
+            });
+        }
+    }
+    // settings 覆盖提示：settingsPath 指定的文件未被快照登记 → 无法整文件还原
+    if (settingsRel !== undefined && !hostBackups.some((b) => b.relPath === settingsRel)) {
+        actions.push({
+            kind: 'skip',
+            description: `settings 文件 ${settingsRel} 未被快照登记，无法整文件还原`,
+            isSettings: true,
+            detail: '该快照未备份此 settings 文件（可能当时不存在或宿主未暴露 profile）',
+        });
+    }
+    // 2) 插件撤销：beforePlugins 基线 vs 当前已装 → 导入期间新增
+    const profileDir = resolveProfileDir(homeDir, profile);
+    const baseline = snapshot.beforePlugins;
+    if (baseline === undefined) {
+        actions.push({
+            kind: 'skip',
+            description: '旧快照无 beforePlugins 基线，无法自动卸载插件',
+            detail: '请人工核对导入期间新增的插件并逐个移除',
+        });
+    }
+    else {
+        const beforeNames = new Set(baseline.map((p) => p.name));
+        const added = Object.keys(readInstalled(profileDir)).filter((name) => !beforeNames.has(name));
+        for (const name of added) {
+            actions.push({
+                kind: 'pluginRemove',
+                description: `卸载导入期间新增插件 ${name}`,
+                target: name,
+                pluginName: name,
+                detail: baseline.length === 0 ? '快照基线为空（导入前可能未捕获插件清单），请确认后执行' : undefined,
+            });
+        }
+        if (added.length === 0) {
+            actions.push({
+                kind: 'skip',
+                description: '无导入期间新增插件（当前已装插件 ⊆ 快照基线）',
+            });
+        }
+    }
+    // 3) file 类条目补偿 + credentials 提示（聚合计数供报告）
+    let namespaceCount = 0;
+    let patchLineCount = 0;
+    let workspaceCount = 0;
+    let credentialAbsentCount = 0;
+    for (const entry of snapshot.entries) {
+        switch (entry.kind) {
+            case 'file': {
+                const rel = toRelPath(homeDir, resolveFileAbs(homeDir, entry.adapter, entry.ref));
+                if (rel === '') {
+                    actions.push({
+                        kind: 'skip',
+                        description: `文件条目路径越界，跳过: ${entry.adapter}:${entry.ref}`,
+                        target: entry.ref,
+                    });
+                    continue;
+                }
+                const abs = homeAbs(homeDir, rel);
+                const currentExists = await fileExists(abs);
+                if (entry.existed && entry.copiedTo) {
+                    if (!(await fileExists(blobAbs(snapshotDir, entry.copiedTo)))) {
+                        actions.push({
+                            kind: 'skip',
+                            description: `文件 ${rel} 的 blob 缺失，跳过`,
+                            target: rel,
+                        });
+                        continue;
+                    }
+                    actions.push({
+                        kind: 'fileRestore',
+                        description: `还原文件 ${rel}（${entry.adapter}）`,
+                        target: rel,
+                        blobPath: entry.copiedTo,
+                        detail: currentExists ? '还原前将备份当前文件到 pre-restore/' : '当前文件不存在，直接写入',
+                    });
+                }
+                else if (!entry.existed) {
+                    if (currentExists) {
+                        actions.push({
+                            kind: 'fileRemove',
+                            description: `删除导入写入的文件 ${rel}（${entry.adapter}）`,
+                            target: rel,
+                            detail: '删除前将备份当前文件到 pre-restore/',
+                        });
+                    }
+                    else {
+                        actions.push({
+                            kind: 'skip',
+                            description: `文件 ${rel} 快照时不存在且当前也不存在，无动作`,
+                            target: rel,
+                        });
+                    }
+                }
+                else {
+                    actions.push({
+                        kind: 'skip',
+                        description: `文件 ${rel} 缺少 blob 副本信息，跳过`,
+                        target: rel,
+                    });
+                }
+                break;
+            }
+            case 'credential':
+                if (entry.existed) {
+                    actions.push({
+                        kind: 'credentialHint',
+                        description: `凭据 ${entry.ref} 需人工补录`,
+                        target: entry.ref,
+                        manualHint: `凭据 "${entry.ref}" 请人工重新填写（DSH 不回读凭据值）`,
+                    });
+                }
+                else {
+                    credentialAbsentCount += 1;
+                }
+                break;
+            case 'settingsNamespace':
+                namespaceCount += 1;
+                break;
+            case 'patchLine':
+                patchLineCount += 1;
+                break;
+            case 'workspaceRecord':
+                workspaceCount += 1;
+                break;
+            default:
+                break;
+        }
+    }
+    // 聚合提示：整文件还原覆盖不了的条目如实说明
+    const settingsBacked = hostBackups.some((b) => b.relPath === 'settings.yaml' || b.relPath === 'settings.json');
+    const patchBacked = hostBackups.some((b) => b.relPath === 'cordis.patch.yml');
+    if (namespaceCount > 0 && !settingsBacked) {
+        actions.push({
+            kind: 'skip',
+            description: `${namespaceCount} 条 settings namespace 条目：快照无 settings 整文件备份，离线无法恢复`,
+            detail: '需经在线回滚（rollback.ts）或人工核对 settings.yaml',
+        });
+    }
+    if (patchLineCount > 0 && !patchBacked) {
+        actions.push({
+            kind: 'skip',
+            description: `${patchLineCount} 条 patch 行条目：快照无 cordis.patch.yml 整文件备份，离线无法恢复`,
+            detail: '需经在线回滚（rollback.ts）或人工核对 patch 文件',
+        });
+    }
+    if (workspaceCount > 0) {
+        actions.push({
+            kind: 'skip',
+            description: `${workspaceCount} 条 workspace 记录条目：离线无法恢复（数据在 DSH storages）`,
+            detail: '需经在线回滚（rollback.ts）或人工核对 workspace 注册表',
+        });
+    }
+    if (credentialAbsentCount > 0) {
+        actions.push({
+            kind: 'skip',
+            description: `${credentialAbsentCount} 条凭据快照时未配置：若导入已创建，需人工在 DSH 中删除`,
+        });
+    }
+    return {
+        snapshotId: snapshot.id,
+        createdAt: snapshot.createdAt,
+        sourceZip: snapshot.sourceZip,
+        actions,
+        summary: summarizeActions(actions),
+        pluginBaselineConfirmed: baseline !== undefined,
+    };
+}
+function summarizeActions(actions) {
+    const summary = {
+        hostFileRestores: 0, hostFileRemoves: 0, pluginRemoves: 0,
+        fileRestores: 0, fileRemoves: 0, credentialHints: 0, skips: 0,
+    };
+    for (const a of actions) {
+        switch (a.kind) {
+            case 'hostFileRestore':
+                summary.hostFileRestores += 1;
+                break;
+            case 'hostFileRemove':
+                summary.hostFileRemoves += 1;
+                break;
+            case 'pluginRemove':
+                summary.pluginRemoves += 1;
+                break;
+            case 'fileRestore':
+                summary.fileRestores += 1;
+                break;
+            case 'fileRemove':
+                summary.fileRemoves += 1;
+                break;
+            case 'credentialHint':
+                summary.credentialHints += 1;
+                break;
+            case 'skip':
+                summary.skips += 1;
+                break;
+        }
+    }
+    return summary;
+}
+/* ------------------------------------------------------------ restore */
+/**
+ * 执行恢复：按计划顺序 整文件还原 → 插件卸载 → file 补偿，
+ * 覆盖/删除前全部先复制到 <snapshotDir>/pre-restore/（双保险），
+ * 逐项 try/catch（单项失败不拖垮其余），输出诚实报告。
+ */
+export async function restore(opts) {
+    const plan = await planRestore(opts);
+    const { snapshotDir, homeDir, profile } = opts;
+    const preDir = path.join(snapshotDir, 'pre-restore');
+    const profileDir = resolveProfileDir(homeDir, profile);
+    const uninstaller = opts.pluginUninstaller ?? defaultPluginUninstaller;
+    const report = {
+        snapshotId: plan.snapshotId,
+        restored: [],
+        removedPlugins: [],
+        manualHints: [],
+        failed: [],
+        skipped: [],
+    };
+    let seq = 0;
+    for (const action of plan.actions) {
+        try {
+            switch (action.kind) {
+                case 'hostFileRestore': {
+                    const abs = homeAbs(homeDir, action.target);
+                    if (await fileExists(abs))
+                        await copyToPreRestore(preDir, abs, action.target, ++seq);
+                    const data = await fs.readFile(blobAbs(snapshotDir, action.blobPath));
+                    await fs.mkdir(path.dirname(abs), { recursive: true });
+                    await fs.writeFile(abs, data);
+                    report.restored.push(action.target);
+                    break;
+                }
+                case 'hostFileRemove': {
+                    const abs = homeAbs(homeDir, action.target);
+                    if (await fileExists(abs)) {
+                        await copyToPreRestore(preDir, abs, action.target, ++seq);
+                        await fs.rm(abs, { force: true });
+                    }
+                    report.restored.push(action.target);
+                    break;
+                }
+                case 'fileRestore': {
+                    const abs = homeAbs(homeDir, action.target);
+                    if (await fileExists(abs))
+                        await copyToPreRestore(preDir, abs, action.target, ++seq);
+                    const data = await fs.readFile(blobAbs(snapshotDir, action.blobPath));
+                    await fs.mkdir(path.dirname(abs), { recursive: true });
+                    await fs.writeFile(abs, data);
+                    report.restored.push(action.target);
+                    break;
+                }
+                case 'fileRemove': {
+                    const abs = homeAbs(homeDir, action.target);
+                    if (await fileExists(abs)) {
+                        await copyToPreRestore(preDir, abs, action.target, ++seq);
+                        await fs.rm(abs, { force: true });
+                    }
+                    report.restored.push(action.target);
+                    break;
+                }
+                case 'pluginRemove': {
+                    const result = await uninstaller(action.pluginName, profileDir, profile);
+                    if (result.ok) {
+                        report.removedPlugins.push(action.pluginName);
+                    }
+                    else {
+                        report.failed.push({ item: `plugin:${action.pluginName}`, reason: result.message ?? '卸载失败' });
+                    }
+                    break;
+                }
+                case 'credentialHint':
+                    report.manualHints.push(action.manualHint ?? action.description);
+                    break;
+                case 'skip':
+                    report.skipped.push(action.description);
+                    break;
+                default:
+                    report.skipped.push(`未知动作 ${String(action.kind)}: ${action.description}`);
+            }
+        }
+        catch (err) {
+            report.failed.push({
+                item: action.target ?? action.pluginName ?? action.description,
+                reason: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return report;
+}
+/* ------------------------------------------------------------ listSnapshots */
+/**
+ * 扫描快照根目录下每个子目录的 snapshot.json，返回按 createdAt 倒序的元信息。
+ * 目录缺失/条目损坏自动跳过（不阻断其他快照）。
+ */
+export async function listSnapshots(dir) {
+    let entries;
+    try {
+        entries = await fs.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const metas = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        try {
+            const parsed = parseJsonSafe(await fs.readFile(path.join(dir, entry.name, 'snapshot.json'), 'utf8'));
+            if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
+                continue;
+            const snapshot = parsed;
+            if (typeof snapshot.id !== 'string' || snapshot.id === '')
+                continue;
+            metas.push({
+                id: snapshot.id,
+                createdAt: snapshot.createdAt,
+                sourceZip: snapshot.sourceZip,
+                status: snapshot.status,
+                entryCount: snapshot.entries?.length ?? 0,
+                hostFileBackupCount: snapshot.hostFileBackups?.length ?? 0,
+                beforePluginCount: snapshot.beforePlugins?.length ?? 0,
+            });
+        }
+        catch {
+            // 损坏 / 非快照目录：跳过
+        }
+    }
+    metas.sort((a, b) => (a.createdAt < b.createdAt ? 1 : a.createdAt > b.createdAt ? -1 : 0));
+    return metas;
+}
+//# sourceMappingURL=restore.js.map

package/lib/core/restore.js.map

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

package/lib/core/run-registry.d.ts

@@ -0,0 +1,65 @@
+/** run 类型：导出 / 导入。 */
+export type RunKind = 'export' | 'import';
+/** run 状态：进行中 / 完成 / 失败。 */
+export type RunStatus = 'running' | 'done' | 'failed';
+/** 单个 run 的实时状态（/progress 返回体；纯 JSON 可序列化）。 */
+export interface RunState {
+    /** 不可猜测的 run id（32 hex 字符）。 */
+    runId: string;
+    kind: RunKind;
+    status: RunStatus;
+    /** 当前分区（adapter id 或导入阶段名）；无则 null。 */
+    section: string | null;
+    /** 分区总数（导出 = 选中分区数；导入无此语义 = null）。 */
+    sectionTotal: number | null;
+    /** 已完成的内部计数（导出 = 当前分区序号；导入 = 已处理计划项数）。 */
+    item: number | null;
+    /** 内部计数总数（导出 = 分区总数；导入 = 计划项总数）。 */
+    itemTotal: number | null;
+    /** 非敏感进度摘要（当前分区 / 当前计划项 id）。 */
+    detail: string | null;
+    /** 完成时的业务结果（仅 JSON 可序列化、不含秘密值）。 */
+    result?: unknown;
+    /** 失败时的错误消息（非敏感）。 */
+    error?: string;
+    createdAt: number;
+    updatedAt: number;
+}
+/** 进行中同 kind 已有 run 时注册被拒（宿主路由 → 409）。 */
+export declare class RunConflictError extends Error {
+    /** 已在进行中的 run id（供客户端定位既有任务）。 */
+    readonly runId: string;
+    constructor(runId: string, kind: RunKind);
+}
+/** 完成/失败后的默认保留时长（30 分钟）。 */
+export declare const DEFAULT_RUN_RETENTION_MS: number;
+export interface RunRegistryOptions {
+    /** 完成/失败后保留时长（默认 30 分钟）；超期 run 在下次访问时清理。 */
+    retentionMs?: number;
+    /** 时间源（测试注入）。 */
+    now?: () => number;
+}
+/**
+ * 内存 run 注册表。Node 单线程 + 同步 Map 读写，无并发竞争；
+ * 所有公开读方法返回状态副本，防止外部直接篡改内部状态。
+ */
+export declare class RunRegistry {
+    private readonly runs;
+    private readonly retentionMs;
+    private readonly now;
+    constructor(opts?: RunRegistryOptions);
+    /** 注册新 run；同 kind 已有 running 时抛 RunConflictError。 */
+    register(kind: RunKind): RunState;
+    /** 更新进度；run 不存在返回 undefined；已完成/失败后的晚到更新被忽略（防御异步回调竞态）。 */
+    update(runId: string, patch: Partial<Pick<RunState, 'section' | 'sectionTotal' | 'item' | 'itemTotal' | 'detail'>>): RunState | undefined;
+    /** 读单个 run；超过保留期或不存在返回 undefined。 */
+    get(runId: string): RunState | undefined;
+    /** 列出活跃（running）run（刷新恢复时经 /runs 重订阅用）。 */
+    listActive(): RunState[];
+    /** 标记完成并写入业务结果；run 不存在返回 undefined。 */
+    finish(runId: string, result: unknown): RunState | undefined;
+    /** 标记失败并写入错误消息；run 不存在返回 undefined。 */
+    fail(runId: string, error: string): RunState | undefined;
+    /** 惰性清理：超过保留期的 run（含长期 running 的僵死任务）全部移除。 */
+    private prune;
+}