@sparkelf/dsh-plugin-backup 0.2.1-alpha.3 → 0.2.1-alpha.4

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/plus/backup/README.md
-README.md: 9779790a882ee3c85bda21914a77bf9048ec76b0
-README.zh.md: 9570b2eee62259f48ec41e9f0229b7116547dbbf
+README.md: 543f8bc850fc01e68d03735450a99372e7c68455
+README.zh.md: 090bd8e8cfec3776cdda407446a8baf35a05f39e

package/README.md

@@ -23,7 +23,7 @@ This complete Host and Client plugin exports and restores three explicit user-da
 <a id="use-this-package"></a>
 ## Use this package
 
-Mount the Host entry after `connection`, `webServer`, `settings`, and `workspaceRegistry`, and mount the Client entry after locale and Settings. The file-backed Settings provider supplies `settings.documentPath`; `maxUploadBytes` defaults to 2147483648 bytes.
+Mount the Host entry after `connection`, `webServer`, `settings`, and `workspaceRegistry`, and mount the Client entry after locale and Settings. The file-backed Settings provider supplies `settings.documentPath`; the archive covers the Harness home, and `maxUploadBytes` defaults to 2147483648 bytes.
 
 The Settings section uses a three-way segmented control. **Everything** is the union of configuration and sessions; it does not archive generated profiles, releases, logs, Supervisor files, cached packages, or other runtime output. **Configuration** restores only configuration files and leaves Session/Workspace storage open. **Sessions** restores `sessions`, `attachments`, and `storages` together inside the Workspace storage-restore transaction. The archive manifest records the scope and active Settings filename; configuration-bearing archives require the same Settings filename at import.
 

package/README.zh.md

@@ -23,7 +23,7 @@ kind: "package-reference"
 <a id="use-this-package"></a>
 ## 使用此软件包
 
-Host entry需mount在`connection`、`webServer`、`settings`及`workspaceRegistry`之后，Client entry需mount在locale及Settings之后。file-backed Settings provider提供`settings.documentPath`；`maxUploadBytes`默认为2147483648 bytes。
+Host entry需mount在`connection`、`webServer`、`settings`及`workspaceRegistry`之后，Client entry需mount在locale及Settings之后。file-backed Settings provider提供`settings.documentPath`；归档覆盖Harness home，`maxUploadBytes`默认为2147483648 bytes。
 
 Settings section使用三段segmented control。**全部**是配置与会话的并集；它不归档generated profiles、releases、logs、Supervisor files、cached packages或其他runtime output。**配置**只恢复配置文件，不关闭Session/Workspace storage。**会话**把`sessions`、`attachments`及`storages`一起放进Workspace storage-restore transaction恢复。Archive manifest记录scope与active Settings filename；含配置的archive在import时要求相同Settings filename。
 

package/lib/client.js

@@ -4,8 +4,8 @@ window.__ModuleLoader__.load({
 		var module = { exports: {} };
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-		let react_jsx_runtime = require("react/jsx-runtime");
 		let react = require("react");
+		let react_jsx_runtime = require("react/jsx-runtime");
 		let _deepseek_ai_dsh_client_store = require("@deepseek-ai/dsh-client-store");
 		//#region \0dsh-css:/root/projects/deepseek-harness-plus/packages/plus/backup/src/client/BackupSection.module.css.mjs
 		const css = ".pZQljq_section{flex-direction:column;gap:16px;display:flex}.pZQljq_title{color:var(--dsw-alias-label-primary);margin:0;font-size:16px;font-weight:600}.pZQljq_desc{color:var(--dsw-alias-label-secondary);margin:0;font-size:13px}.pZQljq_scopeGroup{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2);border-radius:6px;align-self:flex-start;padding:2px;display:inline-flex}.pZQljq_scopeButton{min-width:72px;height:28px;color:var(--dsw-alias-label-secondary);cursor:pointer;background:0 0;border:0;border-radius:4px;padding:0 10px;font-size:13px}.pZQljq_scopeButton:hover:not(:disabled){color:var(--dsw-alias-label-primary)}.pZQljq_scopeButton[aria-checked=true]{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-1);box-shadow:0 1px 2px #0000001f}.pZQljq_scopeButton:focus-visible{outline:1px solid var(--dsw-alias-state-business-primary);outline-offset:1px}.pZQljq_scopeButton:disabled{color:var(--dsw-alias-label-dimmed);cursor:default}.pZQljq_actions{flex-wrap:wrap;align-items:center;gap:12px;display:flex}.pZQljq_button{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);cursor:pointer;border-radius:8px;padding:8px 14px;font-size:13px}.pZQljq_button:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}.pZQljq_button:disabled{opacity:.6;cursor:default}.pZQljq_fileInput{display:none}.pZQljq_progress{flex-direction:column;gap:8px;width:min(100%,480px);display:flex}.pZQljq_progressLabel,.pZQljq_progressDetail{margin:0;font-size:13px}.pZQljq_progressLabel{color:var(--dsw-alias-label-primary);font-weight:500}.pZQljq_progressDetail{color:var(--dsw-alias-label-secondary)}.pZQljq_progressTrack{width:100%;height:8px;accent-color:var(--dsw-alias-state-business-primary);border:0}.pZQljq_progressTrack::-webkit-progress-bar{background:var(--dsw-alias-border-l2);border-radius:4px}.pZQljq_progressTrack::-webkit-progress-value{background:var(--dsw-alias-state-business-primary);border-radius:4px}.pZQljq_progressTrack::-moz-progress-bar{background:var(--dsw-alias-state-business-primary);border-radius:4px}.pZQljq_status{color:var(--dsw-alias-state-success-primary);margin:0;font-size:13px}.pZQljq_error{color:var(--dsw-alias-state-error-primary);margin:0;font-size:13px}.pZQljq_warning{color:var(--dsw-alias-state-warn-primary);margin:0;font-size:12px}";
@@ -35,7 +35,7 @@ window.__ModuleLoader__.load({
 			"warning": "pZQljq_warning"
 		};
 		//#endregion
-		//#region lib/types/client/BackupSection.js
+		//#region src/client/BackupSection.tsx
 		/**
 		* Backup settings section: exact Host routes stream archive bytes and progress;
 		* the slot store survives settings-driven component remounts.
@@ -176,18 +176,18 @@ window.__ModuleLoader__.load({
 			};
 			const percent = operation === null ? void 0 : progressPercent(operation.progress);
 			const progressText = operation === null ? "" : t(progressTextKey(operation.progress)) + (percent === void 0 ? "" : " " + String(percent) + "%");
-			return (0, react_jsx_runtime.jsxs)("section", {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 				className: BackupSection_module_css_default.section,
 				children: [
-					(0, react_jsx_runtime.jsx)("h2", {
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h2", {
 						className: BackupSection_module_css_default.title,
 						children: t("title")
 					}),
-					(0, react_jsx_runtime.jsx)("p", {
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 						className: BackupSection_module_css_default.desc,
 						children: t("desc")
 					}),
-					(0, react_jsx_runtime.jsx)("div", {
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 						className: BackupSection_module_css_default.scopeGroup,
 						role: "radiogroup",
 						"aria-label": t("scopeLabel"),
@@ -195,7 +195,7 @@ window.__ModuleLoader__.load({
 							"all",
 							"configuration",
 							"sessions"
-						].map((value) => (0, react_jsx_runtime.jsx)("button", {
+						].map((value) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 							type: "button",
 							role: "radio",
 							"aria-checked": scope === value,
@@ -207,10 +207,10 @@ window.__ModuleLoader__.load({
 							children: t(value === "all" ? "scopeAll" : value === "configuration" ? "scopeConfiguration" : "scopeSessions")
 						}, value))
 					}),
-					(0, react_jsx_runtime.jsxs)("div", {
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: BackupSection_module_css_default.actions,
 						children: [
-							(0, react_jsx_runtime.jsx)("button", {
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 								type: "button",
 								className: BackupSection_module_css_default.button,
 								disabled: operation !== null || reloadRequired,
@@ -219,7 +219,7 @@ window.__ModuleLoader__.load({
 								},
 								children: operation?.kind === "export" ? t("busyExport") : t("exportButton")
 							}),
-							(0, react_jsx_runtime.jsx)("button", {
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 								type: "button",
 								className: BackupSection_module_css_default.button,
 								disabled: operation !== null || reloadRequired,
@@ -228,7 +228,7 @@ window.__ModuleLoader__.load({
 								},
 								children: operation?.kind === "import" ? t("busyImport") : t("importButton")
 							}),
-							operation !== null && canCancel(operation.progress) ? (0, react_jsx_runtime.jsx)("button", {
+							operation !== null && canCancel(operation.progress) ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 								type: "button",
 								className: BackupSection_module_css_default.button,
 								disabled: cancelling,
@@ -238,7 +238,7 @@ window.__ModuleLoader__.load({
 								},
 								children: t(cancelling ? "cancellingButton" : "cancelButton")
 							}) : null,
-							(0, react_jsx_runtime.jsx)("input", {
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
 								ref: fileRef,
 								type: "file",
 								accept: ".zip,application/zip",
@@ -247,38 +247,38 @@ window.__ModuleLoader__.load({
 							})
 						]
 					}),
-					operation !== null ? (0, react_jsx_runtime.jsxs)("div", {
+					operation !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: BackupSection_module_css_default.progress,
 						role: "status",
 						"aria-live": "polite",
 						children: [
-							(0, react_jsx_runtime.jsx)("p", {
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 								className: BackupSection_module_css_default.progressLabel,
 								children: progressText
 							}),
-							percent === void 0 ? (0, react_jsx_runtime.jsx)("progress", {
+							percent === void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("progress", {
 								className: BackupSection_module_css_default.progressTrack,
 								"aria-label": t(operation.kind === "export" ? "exportProgressLabel" : "importProgressLabel"),
 								"aria-valuetext": progressText
-							}) : (0, react_jsx_runtime.jsx)("progress", {
+							}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("progress", {
 								className: BackupSection_module_css_default.progressTrack,
 								max: 100,
 								value: percent,
 								"aria-label": t(operation.kind === "export" ? "exportProgressLabel" : "importProgressLabel"),
 								"aria-valuetext": progressText
 							}),
-							(0, react_jsx_runtime.jsx)("p", {
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 								className: BackupSection_module_css_default.progressDetail,
 								children: t("progressDetail")
 							})
 						]
 					}) : null,
-					result !== null ? (0, react_jsx_runtime.jsx)("p", {
+					result !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 						className: BackupSection_module_css_default.status,
 						role: "status",
 						children: t(resultTextKey(result))
 					}) : null,
-					reloadRequired ? (0, react_jsx_runtime.jsx)("button", {
+					reloadRequired ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 						type: "button",
 						className: BackupSection_module_css_default.button,
 						onClick: () => {
@@ -286,12 +286,12 @@ window.__ModuleLoader__.load({
 						},
 						children: t("reloadButton")
 					}) : null,
-					error !== null ? (0, react_jsx_runtime.jsx)("p", {
+					error !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 						className: BackupSection_module_css_default.error,
 						role: "alert",
 						children: t(error)
 					}) : null,
-					(0, react_jsx_runtime.jsx)("p", {
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 						className: BackupSection_module_css_default.warning,
 						children: t("warning")
 					})
@@ -299,7 +299,7 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
-		//#region lib/types/client/store.js
+		//#region src/client/store.ts
 		/**
 		* Declare the Backup section operation and result state.
 		* @returns the root-scoped store handle.
@@ -351,7 +351,7 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
-		//#region lib/types/client/locales.js
+		//#region src/client/locales.ts
 		/** Settings Backup section dictionaries (zh product copy, en twin). */
 		const zh = {
 			nav: "备份",
@@ -427,12 +427,7 @@ window.__ModuleLoader__.load({
 			warning: "The backup archive contains sensitive data such as API keys; store it carefully."
 		};
 		//#endregion
-		//#region lib/types/client/index.js
-		/**
-		* Settings Backup section plugin, browser half. Archive bytes use exact Host
-		* routes; preparation and restore state arrive as validated NDJSON progress
-		* lines, outside the unary RPC carrier.
-		*/
+		//#region src/client/index.ts
 		const NS = "settingsBackup";
 		const inject = ["slots", "locale"];
 		/** Resolve a Host logical path beneath the runtime-injected document base. */

package/lib/index.js

@@ -1,5 +1,6 @@
 import { basename, dirname, join } from "node:path";
 import Schema from "@deepseek-ai/schemastery";
+import { resolveDshHome } from "@deepseek-ai/dsh-home-paths";
 import { randomUUID } from "node:crypto";
 import { once } from "node:events";
 import { createReadStream, createWriteStream } from "node:fs";
@@ -783,7 +784,14 @@ const DEFAULT_MAX_UPLOAD_BYTES = 2 * 1024 * 1024 * 1024;
 /** Validate Backup Host resource policy. */
 const Config = Schema.object({ maxUploadBytes: Schema.number().step(1).min(1).default(DEFAULT_MAX_UPLOAD_BYTES) });
 /**
-* Register authenticated archive routes against a file-backed DSH home.
+* Register authenticated archive routes against the Harness home.
+*
+* The archived user data lives under the Harness home, not beside the settings document: Session
+* logs, attachments, Workspace storage, credentials, and identity are all written there. Only the
+* profile's patch file sits beside the document, so deriving the root from the document archived
+* that one file and silently dropped every other planned entry — a Sessions export produced an
+* archive holding nothing but its manifest.
+*
 * @param ctx - Host services plus the temporary patched Workspace restore operation.
 * @param config - Upload resource policy resolved by Cordis.
 */
@@ -793,7 +801,7 @@ function apply(ctx, config = {}) {
 	registerBackupRoutes(ctx, {
 		maxUploadBytes: config.maxUploadBytes ?? DEFAULT_MAX_UPLOAD_BYTES,
 		settingsFile: basename(documentPath)
-	}, dirname(documentPath));
+	}, resolveDshHome());
 }
 //#endregion
 export { Config, apply, inject, name };

package/lib/types/index.d.ts

@@ -11,7 +11,14 @@ export interface Config {
 /** Validate Backup Host resource policy. */
 export declare const Config: Schema<Config>;
 /**
- * Register authenticated archive routes against a file-backed DSH home.
+ * Register authenticated archive routes against the Harness home.
+ *
+ * The archived user data lives under the Harness home, not beside the settings document: Session
+ * logs, attachments, Workspace storage, credentials, and identity are all written there. Only the
+ * profile's patch file sits beside the document, so deriving the root from the document archived
+ * that one file and silently dropped every other planned entry — a Sessions export produced an
+ * archive holding nothing but its manifest.
+ *
  * @param ctx - Host services plus the temporary patched Workspace restore operation.
  * @param config - Upload resource policy resolved by Cordis.
  */

package/package.json

@@ -13,6 +13,7 @@
     "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.1",
     "@deepseek-ai/dsh-client-ui-settings": "^0.1.6-alpha.1",
     "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-home-paths": "^0.1.6-alpha.1",
     "@deepseek-ai/dsh-host-webserver": "^0.1.6-alpha.1",
     "@deepseek-ai/dsh-settings": "^0.1.6-alpha.1",
     "@deepseek-ai/dsh-workspace": "^0.1.6-alpha.1",
@@ -55,6 +56,7 @@
     "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.1",
     "@deepseek-ai/dsh-client-ui-settings": "^0.1.6-alpha.1",
     "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-home-paths": "^0.1.6-alpha.1",
     "@deepseek-ai/dsh-host-webserver": "^0.1.6-alpha.1",
     "@deepseek-ai/dsh-settings": "^0.1.6-alpha.1",
     "@deepseek-ai/dsh-workspace": "^0.1.6-alpha.1"
@@ -73,5 +75,5 @@
   },
   "type": "module",
   "types": "lib/types/index.d.ts",
-  "version": "0.2.1-alpha.3"
+  "version": "0.2.1-alpha.4"
 }