@twinsearth/w2m-dsh-plugin 0.4.8 → 0.4.9

package/CHANGELOG.md

@@ -4,6 +4,25 @@ All notable changes to this project are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.9] — 2026-10-10
+
+### Fixed
+
+* **The Windows supervisor silently dropped every `-AgentArgs` value.** `install-service.ps1` writes
+  `agentArgs` into `agent.json`, and `ConvertTo-Json` collapses a single-element array to a string —
+  while the supervisor's passthrough only handled an array. So `-AgentArgs '--p2p-mode auto'` was
+  accepted, written, and then ignored, and the agent ran on its defaults. Nothing failed; the field
+  simply had no effect. It now accepts both shapes (a string is split on whitespace) — the same class
+  of bug as the camelCase key mismatch fixed in v0.4.4: **a config field that is read but not
+  understood is indistinguishable from one that was never set.**
+* Found while pinning this machine's punch port (`--p2p-port 51820`), which was the first agent
+  argument whose absence would have been visible — that is what exposed the dropped-arguments path.
+
+### Notes
+
+* No protocol change, and no behavioural change for an `agentArgs` that was already an array (what
+  the installer writes for two or more arguments). This makes the documented `-AgentArgs` real.
+
 ## [0.4.8] — 2026-10-09
 
 ### Added

package/deploy/windows/w2m-agent-supervisor.mjs

@@ -128,7 +128,12 @@ const consumed = new Set([
 ]);
 const passthrough = [];
 const fileAgentArgs = file.agentArgs ?? file['agent-args'];
+// BOTH SHAPES, because both happen. The installer writes an array, but `ConvertTo-Json` collapses a
+// single-element array to a string -- and this only handled the array, so `--p2p-mode auto` was
+// silently dropped and the agent ran on its defaults. Silent, because an ignored field is not an
+// error. A string is split on whitespace instead.
 if (Array.isArray(fileAgentArgs)) passthrough.push(...fileAgentArgs.map(String));
+else if (typeof fileAgentArgs === 'string') passthrough.push(...fileAgentArgs.split(/\s+/).filter(Boolean));
 if (typeof args['agent-args'] === 'string') passthrough.push(...args['agent-args'].split(/\s+/).filter(Boolean));
 for (const [key, value] of Object.entries(args)) {
   if (consumed.has(key)) continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@twinsearth/w2m-dsh-plugin",
-  "version": "0.4.8",
+  "version": "0.4.9",
   "description": "DSH: Windows2MacOS — drive the same project on online Windows and macOS machines from one DeepSeek account, across networks and regions. P2P hole punching is the default path (relay + shared server as rendezvous, ledger and fallback), with a bundled STUN responder, Tailscale/public-VPS/tunnel shapes, Rabbit relay + per-machine Localside + eight DSH tools (replicate / split), nine aggregate verdicts and signed requests.",
   "type": "module",
   "main": "lib/index.js",

package/src/plugin/tools.mjs

@@ -110,7 +110,7 @@ const MAX_STAGES = 16;
  * `package.json` during `scripts/pack.mjs` rather than hand-maintained, and `W2M_PLUGIN_VERSION`
  * overrides it at runtime for tests and packagers.
  */
-const PLUGIN_VERSION = '0.4.8';
+const PLUGIN_VERSION = '0.4.9';
 
 /** How long any single HTTP call may take before it is aborted, in milliseconds. */
 const DEFAULT_REQUEST_TIMEOUT_MS = 15_000;