instar 1.3.196 → 1.3.197

package/dist/commands/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAwSH,UAAU,YAAY;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;2DACuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA+wDD,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAo2PtE;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuD5E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAwSH,UAAU,YAAY;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;2DACuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA+wDD,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAk3PtE;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuD5E"}

package/dist/commands/server.js

@@ -38,7 +38,7 @@ import { AutoUpdater } from '../core/AutoUpdater.js';
 import { UpdateRestartHandshake, verifyRestartHandshake } from '../core/UpdateRestartHandshake.js';
 import { AutoDispatcher } from '../core/AutoDispatcher.js';
 import { DispatchExecutor } from '../core/DispatchExecutor.js';
-import { registerAgent, unregisterAgent, startHeartbeat } from '../core/AgentRegistry.js';
+import { registerAgent, unregisterAgent, startHeartbeat, isFetchBlockedPort } from '../core/AgentRegistry.js';
 import { TelegraphService } from '../publishing/TelegraphService.js';
 import { PrivateViewer } from '../publishing/PrivateViewer.js';
 import { TunnelManager } from '../tunnel/TunnelManager.js';
@@ -1978,6 +1978,17 @@ export async function startServer(options) {
     // not via npm auto-updates. The migration was forcing autoApply: true
     // which overwrites our intentional autoApply: false setting.
     const serverSessionName = `${config.projectName}-server`;
+    // Migration-parity warning: an EXISTING agent whose port predates the
+    // fetch-blocked-port allocator guard (or was set by hand) silently can't mesh —
+    // node fetch refuses WHATWG bad ports (e.g. 4045 = NFS lockd). New agents now
+    // skip these at allocation; surface it loudly for ones already on a bad port so
+    // the operator can re-port. (2026-06-02 incident.)
+    if (typeof config.port === 'number' && isFetchBlockedPort(config.port)) {
+        console.warn(pc.yellow(`  ⚠ Port ${config.port} is on the WHATWG fetch "bad ports" list — multi-machine ` +
+            `mesh (pairing/lease/heartbeat use node fetch) CANNOT reach this agent on this port. ` +
+            `Change "port" in .instar/config.json to a non-blocked port (e.g. 4040–4044, 4046–4099) ` +
+            `and restart if you use multi-machine.`));
+    }
     if (options.foreground) {
         // Run in foreground — useful for development
         console.log(pc.bold(`Starting instar server for ${pc.cyan(config.projectName)}`));