@sparkelf/dsh-plugin-backup 0.2.1-alpha.2 → 0.2.1-alpha.21

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/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",
@@ -51,13 +52,14 @@
   "name": "@sparkelf/dsh-plugin-backup",
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.1",
-    "@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-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"
+    "@deepseek-ai/dsh-client-locale": ">=0.1.6-alpha.1",
+    "@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"
   },
   "publishConfig": {
     "access": "public"
@@ -73,5 +75,5 @@
   },
   "type": "module",
   "types": "lib/types/index.d.ts",
-  "version": "0.2.1-alpha.2"
+  "version": "0.2.1-alpha.21"
 }