dsh-desktop-kit 0.0.0-stage → 1.0.0

package/plugins/dsh-profile-transfer/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: profile-transfer
+      name: dsh-profile-transfer

package/plugins/dsh-profile-transfer/icon.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="Transfer and backups">
+  <defs>
+    <linearGradient id="tr-a" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#2f7df6"/>
+      <stop offset="1" stop-color="#173a8f"/>
+    </linearGradient>
+  </defs>
+  <rect x="2" y="2" width="60" height="60" rx="14" fill="url(#tr-a)"/>
+  <path d="M15 24h27l-6-6" fill="none" stroke="#ffffff" stroke-width="3.4" stroke-linecap="round" stroke-linejoin="round" opacity=".95"/>
+  <path d="M49 40H22l6 6" fill="none" stroke="#ffffff" stroke-width="3.4" stroke-linecap="round" stroke-linejoin="round" opacity=".95"/>
+  <rect x="13" y="30" width="13" height="4" rx="2" fill="#ffffff" opacity=".5"/>
+  <rect x="38" y="30" width="13" height="4" rx="2" fill="#ffffff" opacity=".5"/>
+</svg>

package/plugins/dsh-profile-transfer/index.js

@@ -0,0 +1,375 @@
+/**
+ * dsh-profile-transfer — Host half.
+ *
+ * Authenticated Connection RPC routes for the Settings page:
+ *   options   — what can be exported and how big it is
+ *   export    — build a .tar.gz transfer archive
+ *   inspect   — read an archive manifest without applying it
+ *   import    — restore an archive into <DSH_HOME> with a backup
+ *   install   — run `pnpm install` in the restored profile
+ *   reveal    — open the archive folder in the OS file manager
+ *
+ * All file work lives in transfer.js (pure Node, testable on temporary homes).
+ */
+
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import {
+  applyBundle,
+  defaultHome,
+  describeSources,
+  exportBundle,
+  humanSize,
+  inspectBundle,
+  normalizeSelection,
+} from "./transfer.js";
+
+const ROUTE_BASE = "/api/dsh-profile-transfer";
+const RPC_NAMESPACE = "dsh-profile-transfer";
+const INSTALL_TIMEOUT_MS = 5 * 60 * 1000;
+
+export const inject = ["connection"];
+
+class TransferError extends Error {
+  constructor(code, message, details = {}) {
+    super(message);
+    this.code = code;
+    this.details = details;
+  }
+}
+
+function environment(ctx) {
+  const home = defaultHome();
+  let profileName = process.env.DSH_PROFILE ?? "desktop";
+  if (typeof profileName !== "string" || profileName.length === 0) profileName = "desktop";
+  const profileDir = path.join(home, "profiles", profileName);
+  return { home, profileName, profileDir };
+}
+
+function suggestedDestination() {
+  return path.join(os.homedir(), "Documents", "DSH-обмены");
+}
+
+function lastSummary(home) {
+  try {
+    return JSON.parse(fs.readFileSync(path.join(home, "profile-transfer-last.json"), "utf8"));
+  } catch {
+    return undefined;
+  }
+}
+
+/** Candidate pnpm invocations, most portable first: bundled runtime of the Desktop app, then PATH. */
+function pnpmCandidates() {
+  const candidates = [];
+  const configured = process.env.PNPM_EXECUTABLE ?? process.env.DSH_PNPM;
+  if (typeof configured === "string" && configured.trim().length > 0) {
+    candidates.push({ command: configured.trim(), prefix: [], shell: false, label: "env" });
+  }
+  try {
+    // The Desktop app bundles pnpm and runs it through its own Electron binary
+    // with ELECTRON_RUN_AS_NODE, exactly like resources/runtime/bin/node.cmd does.
+    const resources = path.join(path.dirname(process.execPath), "resources");
+    const pnpmCjs = path.join(resources, "runtime", "primary-runtime", "dependencies", "pnpm", "bin", "pnpm.cjs");
+    if (fs.existsSync(pnpmCjs)) {
+      candidates.push({ command: process.execPath, prefix: [pnpmCjs], shell: false, label: "bundled", env: { ELECTRON_RUN_AS_NODE: "1" } });
+    }
+  } catch {
+    /* non-Desktop installs have no bundled runtime */
+  }
+  candidates.push({ command: "pnpm", prefix: [], shell: process.platform === "win32", label: "path" });
+  return candidates;
+}
+
+function runPnpmInstall(profileDir) {
+  const candidates = pnpmCandidates();
+  return new Promise((resolve) => {
+    const started = Date.now();
+    let output = "";
+    let index = 0;
+    const attempt = () => {
+      const candidate = candidates[index];
+      if (candidate === undefined) {
+        resolve({ ok: false, code: "spawn-failed", output: `${output}\nни один из pnpm-кандидатов не запустился`, ms: Date.now() - started });
+        return;
+      }
+      let child;
+      try {
+        child = spawn(candidate.command, [...candidate.prefix, "install"], {
+          cwd: profileDir,
+          shell: candidate.shell,
+          windowsHide: true,
+          env: { ...process.env, ...(candidate.env ?? {}) },
+        });
+      } catch (error) {
+        output += `\n[${candidate.label}] ${String(error)}`;
+        index += 1;
+        attempt();
+        return;
+      }
+      let settled = false;
+      const timer = setTimeout(() => {
+        try {
+          child.kill();
+        } catch {
+          /* ignore */
+        }
+      }, INSTALL_TIMEOUT_MS);
+      const finish = (result) => {
+        if (settled) return;
+        settled = true;
+        clearTimeout(timer);
+        resolve({ ...result, executable: candidate.command, via: candidate.label });
+      };
+      const push = (chunk) => {
+        output += chunk.toString();
+        if (output.length > 20000) output = output.slice(-20000);
+      };
+      child.stdout?.on("data", push);
+      child.stderr?.on("data", push);
+      child.on("error", (error) => {
+        output += `\n[${candidate.label}] ${String(error)}`;
+        clearTimeout(timer);
+        if (settled) return;
+        settled = true;
+        index += 1;
+        attempt();
+      });
+      child.on("close", (code) => {
+        finish({ ok: code === 0, code: String(code), output: output.slice(-6000), ms: Date.now() - started });
+      });
+    };
+    attempt();
+  });
+}
+
+function runReveal(target) {
+  try {
+    const platform = process.platform;
+    let child;
+    if (platform === "win32") {
+      child = spawn("explorer.exe", [fs.existsSync(target) && fs.statSync(target).isFile() ? `/select,${target}` : target], {
+        detached: true,
+        stdio: "ignore",
+      });
+    } else if (platform === "darwin") {
+      child = spawn("open", [fs.existsSync(target) && fs.statSync(target).isFile() ? path.dirname(target) : target], { detached: true, stdio: "ignore" });
+    } else {
+      child = spawn("xdg-open", [fs.existsSync(target) && fs.statSync(target).isFile() ? path.dirname(target) : target], { detached: true, stdio: "ignore" });
+    }
+    child.unref?.();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/* ------------------------------------------------------------------ */
+/* handlers                                                           */
+/* ------------------------------------------------------------------ */
+
+async function handleOptions(ctx) {
+  const { home, profileName, profileDir } = environment(ctx);
+  const description = describeSources({ home, profile: profileName });
+  return {
+    home,
+    profile: profileName,
+    profileExists: fs.existsSync(profileDir),
+    destination: suggestedDestination(),
+    selection: description.selection,
+    groups: description.groups,
+    last: lastSummary(home),
+    platform: process.platform,
+  };
+}
+
+async function handleExport(ctx, payload) {
+  const { home, profileName } = environment(ctx);
+  const selection = normalizeSelection(payload?.selection);
+  const destinationDirectory = typeof payload?.destinationDirectory === "string" && payload.destinationDirectory.trim().length > 0
+    ? path.resolve(payload.destinationDirectory.trim())
+    : suggestedDestination();
+  const result = exportBundle({ home, profile: profileName, selection, destinationDirectory });
+  return {
+    ok: true,
+    archivePath: result.archivePath,
+    human: result.human,
+    bytes: result.bytes,
+    manifest: {
+      createdAt: result.manifest.createdAt,
+      totals: result.manifest.totals,
+      selection: result.manifest.selection,
+    },
+  };
+}
+
+async function handleInspect(ctx, payload) {
+  const archivePath = typeof payload?.archivePath === "string" ? payload.archivePath.trim() : "";
+  if (archivePath.length === 0) throw new TransferError("transfer/bad-request", "укажите путь к архиву");
+  if (!fs.existsSync(archivePath)) throw new TransferError("transfer/not-found", `архив не найден: ${archivePath}`);
+  const inspected = inspectBundle(archivePath);
+  return {
+    ok: true,
+    archivePath,
+    human: inspected.human,
+    manifest: {
+      createdAt: inspected.manifest.createdAt,
+      host: inspected.manifest.host,
+      platform: inspected.manifest.platform,
+      dshVersion: inspected.manifest.dshVersion,
+      profile: inspected.manifest.profile,
+      selection: inspected.manifest.selection,
+      totals: inspected.manifest.totals,
+      localPlugins: inspected.manifest.localPlugins,
+    },
+    files: inspected.files.length,
+  };
+}
+
+async function handleImport(ctx, payload) {
+  const { home, profileName } = environment(ctx);
+  const archivePath = typeof payload?.archivePath === "string" ? payload.archivePath.trim() : "";
+  if (archivePath.length === 0) throw new TransferError("transfer/bad-request", "укажите путь к архиву");
+  if (!fs.existsSync(archivePath)) throw new TransferError("transfer/not-found", `архив не найден: ${archivePath}`);
+  const apply = applyBundle({
+    home,
+    profile: profileName,
+    archivePath,
+    selection: payload?.selection,
+    backup: payload?.backup !== false,
+  });
+  let install;
+  if (payload?.installDependencies === true) {
+    install = await runPnpmInstall(path.join(home, "profiles", profileName));
+  }
+  return {
+    ok: true,
+    archivePath,
+    restored: apply.restored,
+    backupDir: apply.backupDir,
+    needsPnpm: apply.needsPnpm,
+    warnings: apply.warnings,
+    manifest: { createdAt: apply.manifest.createdAt, totals: apply.manifest.totals, host: apply.manifest.host },
+    install,
+    summaryPath: apply.summaryPath,
+    restartRequired: true,
+  };
+}
+
+async function handleInstall(ctx) {
+  const { home, profileName, profileDir } = environment(ctx);
+  if (!fs.existsSync(profileDir)) throw new TransferError("transfer/not-found", `профиль не найден: ${profileDir}`);
+  const result = await runPnpmInstall(profileDir);
+  return { ok: result.ok, code: result.code, ms: result.ms, output: result.output, profileDir, home, profile: profileName };
+}
+
+async function handleReveal(ctx, payload) {
+  const target = typeof payload?.path === "string" ? payload.path.trim() : "";
+  if (target.length === 0) throw new TransferError("transfer/bad-request", "укажите путь");
+  if (!fs.existsSync(target)) throw new TransferError("transfer/not-found", `путь не найден: ${target}`);
+  const opened = runReveal(target);
+  return { ok: opened, path: target };
+}
+
+async function handleDiagnose(ctx) {
+  const { home, profileName, profileDir } = environment(ctx);
+  const manifest = (() => {
+    try {
+      return JSON.parse(fs.readFileSync(path.join(profileDir, "package.json"), "utf8"));
+    } catch {
+      return undefined;
+    }
+  })();
+  return {
+    home,
+    profile: profileName,
+    profileExists: fs.existsSync(profileDir),
+    profileDependencies: manifest?.dependencies === null || typeof manifest?.dependencies !== "object" ? {} : manifest.dependencies,
+    nodeModules: fs.existsSync(path.join(profileDir, "node_modules")),
+    destination: suggestedDestination(),
+    last: lastSummary(home),
+    platform: process.platform,
+    node: process.version,
+    pnpmCandidates: pnpmCandidates().map((candidate) => candidate.label + ":" + candidate.command),
+  };
+}
+
+/* ------------------------------------------------------------------ */
+/* wire                                                               */
+/* ------------------------------------------------------------------ */
+
+function okEnvelope(rpcId, value) {
+  return Response.json({ type: "server-response", rpcId, result: { ok: true, value } });
+}
+
+function errorEnvelope(rpcId, code, message, details = {}) {
+  return Response.json({ type: "server-response", rpcId, result: { ok: false, error: { code, message, details } } });
+}
+
+async function readEnvelope(request) {
+  let body;
+  try {
+    body = await request.json();
+  } catch {
+    throw new TransferError("transfer/bad-request", "тело запроса не JSON");
+  }
+  if (body === null || typeof body !== "object" || body.type !== "client-request" || typeof body.rpcId !== "string" || typeof body.method !== "string") {
+    throw new TransferError("transfer/bad-request", "некорректный конверт Connection");
+  }
+  return { rpcId: body.rpcId, method: body.method, payload: body.payload ?? {} };
+}
+
+function registerOperation(ctx, operation, handler) {
+  const route = {
+    path: `${ROUTE_BASE}/${operation}`,
+    methods: ["POST"],
+    requestBody: "buffered",
+    fetch: async (request) => {
+      let rpcId = "invalid-request";
+      try {
+        const envelope = await readEnvelope(request);
+        rpcId = envelope.rpcId;
+        if (envelope.method !== `${RPC_NAMESPACE}/${operation}`) {
+          return errorEnvelope(rpcId, "transfer/bad-request", "метод конверта не совпадает с endpoint", {});
+        }
+        const value = await handler(ctx, envelope.payload);
+        return okEnvelope(rpcId, value);
+      } catch (error) {
+        const code = typeof error?.code === "string" ? error.code : "transfer/internal";
+        if (code === "transfer/internal") ctx.logger?.warn?.(`[profile-transfer] ${operation} failed: ${String(error)}`);
+        return errorEnvelope(rpcId, code, error instanceof Error ? error.message : String(error));
+      }
+    },
+  };
+  ctx.effect(() => {
+    const dispose = ctx.connection.fetch.register(route);
+    return () => {
+      try {
+        void Promise.resolve(dispose()).catch(() => {});
+      } catch {
+        /* carrier already unloading */
+      }
+    };
+  }, `profile-transfer: ${operation} route`);
+}
+
+export function apply(ctx) {
+  const logger = ctx.logger;
+  const { home, profileName } = environment(ctx);
+  try {
+    fs.mkdirSync(home, { recursive: true });
+  } catch (error) {
+    logger?.warn?.(`[profile-transfer] cannot prepare ${home}: ${String(error)}`);
+  }
+  registerOperation(ctx, "options", (context) => handleOptions(context));
+  registerOperation(ctx, "export", (context, payload) => handleExport(context, payload));
+  registerOperation(ctx, "inspect", (context, payload) => handleInspect(context, payload));
+  registerOperation(ctx, "import", (context, payload) => handleImport(context, payload));
+  registerOperation(ctx, "install", (context) => handleInstall(context));
+  registerOperation(ctx, "reveal", (context, payload) => handleReveal(context, payload));
+  registerOperation(ctx, "diagnose", (context) => handleDiagnose(context));
+  logger?.info?.(`[profile-transfer] ready: home ${home}, profile ${profileName}`);
+}
+
+export { humanSize, normalizeSelection };

package/plugins/dsh-profile-transfer/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Transfer and backups",
+    "description": "Pack the whole DSH setup into one archive and restore it on another machine: profile and configs, skills, project memory, local plugins, sessions, secrets — with a backup before restore."
+  }
+}

package/plugins/dsh-profile-transfer/locale/ru.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Перенос и резервные копии",
+    "description": "Собрать всю настройку DSH в один архив и развернуть на другой машине: профиль и конфиги, навыки, память проектов, локальные плагины, сессии, секреты — с бэкапом перед восстановлением."
+  }
+}

package/plugins/dsh-profile-transfer/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "迁移与备份",
+    "description": "把整套 DSH 配置打包成一个归档并在另一台机器上恢复：配置与档案、技能、项目记忆、本地插件、会话、密钥——恢复前自动备份。"
+  }
+}

package/plugins/dsh-profile-transfer/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "dsh-profile-transfer",
+  "version": "1.3.0",
+  "private": true,
+  "description": "Move a complete DSH setup between machines: pick what to export (profile, skills, memory, local plugins, sessions, secrets), pack one archive, restore it on a fresh install.",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./transfer": "./transfer.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "transfer.js",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg",
+    "README.md",
+    "bootstrap/*"
+  ],
+  "dsh": {
+    "manifestVersion": 1,
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": []
+    }
+  }
+}