@lark-apaas/fullstack-cli 1.1.59-alpha.20260719094042 → 1.1.59-alpha.20260719124023

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/fullstack-cli",
-  "version": "1.1.59-alpha.20260719094042",
+  "version": "1.1.59-alpha.20260719124023",
   "description": "CLI tool for fullstack template management",
   "type": "module",
   "main": "dist/index.js",

package/templates/scripts/dev.js

@@ -6,6 +6,7 @@ const path = require('path');
 const { spawn, execFileSync, execSync } = require('child_process');
 const readline = require('readline');
 const {
+  applyPreviewArtifactHostOverrides,
   buildListeningPortLookupArgs,
   createDeferredTypecheckGate,
   createPreviewPhaseReporter,
@@ -64,6 +65,7 @@ const previewArtifactPorts = resolvePreviewArtifactPorts({
   server_port: configuredServerPort,
   client_port: configuredClientDevPort,
 });
+applyPreviewArtifactHostOverrides(previewArtifactPorts, process.env);
 const SERVER_PORT = previewArtifactPorts.server_port;
 const CLIENT_DEV_PORT = previewArtifactPorts.client_port;
 process.env.SERVER_PORT = String(SERVER_PORT);

package/templates/scripts/preview-startup-timing.cjs

@@ -107,6 +107,16 @@ function resolvePreviewArtifactPorts(options) {
   }
 }
 
+function applyPreviewArtifactHostOverrides(ports, environment) {
+  if (!ports.cache_active) return false;
+  // Cached runtime and switcher use an explicit IPv4 loopback endpoint. Pin
+  // both shadow services to the same address family; Linux commonly resolves
+  // `localhost` to IPv6-only ::1, which otherwise makes cutover impossible.
+  environment.SERVER_HOST = '127.0.0.1';
+  environment.CLIENT_DEV_HOST = '127.0.0.1';
+  return true;
+}
+
 function hasRuntimeCompilerPluginConsumer(projectRoot, sourceRoot) {
   const root = path.resolve(projectRoot, sourceRoot || 'src');
   const stack = [root];
@@ -437,6 +447,7 @@ async function waitForTcpReady(options) {
 }
 
 module.exports = {
+  applyPreviewArtifactHostOverrides,
   buildListeningPortLookupArgs,
   createDeferredTypecheckGate,
   createPreviewPhaseReporter,