@lark-apaas/fullstack-cli 1.1.66-alpha.20260902172318 → 1.1.66-alpha.20260902192310

package/package.json

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

package/templates/scripts/dev.js

@@ -42,6 +42,17 @@ const MAX_DELAY = 8;
 const LEGACY_SERVER_PORT = process.env.SERVER_PORT || '3000';
 const PLATFORM_HANDOFF_PUBLIC_PORT = 3000;
 const MAX_HANDOFF_READINESS_RESPONSE_BYTES = 64 * 1024;
+const CLIENT_BASE_PATH =
+  process.env.CLIENT_BASE_PATH?.startsWith('/') &&
+  !process.env.CLIENT_BASE_PATH.startsWith('//')
+    ? process.env.CLIENT_BASE_PATH.replace(/\/+$/, '')
+    : '';
+const HANDOFF_READINESS_PATHS = [
+  '/__innerapi__/capability/list',
+  ...(CLIENT_BASE_PATH
+    ? [`${CLIENT_BASE_PATH}/__innerapi__/capability/list`]
+    : []),
+];
 const CLIENT_DEV_PORT = process.env.CLIENT_DEV_PORT || '8080';
 // This is an ownership receipt, not the raw TCC flag.  The sandbox entrypoint
 // sets it only after the handoff runtime has bound the public port and
@@ -334,7 +345,7 @@ function readStrictHandoffOwner() {
   return owner;
 }
 
-function publicServerReachable() {
+function publicServerPathReachable(requestPath) {
   return new Promise(resolve => {
     let settled = false;
     const finish = reachable => {
@@ -346,7 +357,7 @@ function publicServerReachable() {
       {
         host: '127.0.0.1',
         port: PUBLIC_SERVER_PORT,
-        path: '/__innerapi__/capability/list',
+        path: requestPath,
       },
       response => {
         if (response.statusCode !== 200) {
@@ -393,6 +404,13 @@ function publicServerReachable() {
   });
 }
 
+async function publicServerReachable() {
+  for (const requestPath of HANDOFF_READINESS_PATHS) {
+    if (await publicServerPathReachable(requestPath)) return true;
+  }
+  return false;
+}
+
 function registryMatchesOwner(registry, owner) {
   if (
     !hasExactKeys(registry, [

package/templates/scripts/server-handoff-runtime.mjs

@@ -72,6 +72,16 @@ const publicPort = Number(process.env.SERVER_PORT || 3000);
 const logDir = path.resolve(projectRoot, process.env.LOG_DIR || 'logs');
 const readinessPath =
   process.env.MIAODA_NEST_READINESS_PATH || '/__innerapi__/capability/list';
+function resolveSourceReadinessPath(baseEnv) {
+  const clientBasePath =
+    baseEnv.CLIENT_BASE_PATH?.startsWith('/') &&
+    !baseEnv.CLIENT_BASE_PATH.startsWith('//')
+      ? baseEnv.CLIENT_BASE_PATH.replace(/\/+$/, '')
+      : '';
+  return clientBasePath
+    ? `${clientBasePath}/__innerapi__/capability/list`
+    : readinessPath;
+}
 const sourceReadyTimeoutMs = positiveDuration(
   'MIAODA_NEST_SOURCE_READY_TIMEOUT_MS',
   60_000
@@ -837,7 +847,13 @@ async function terminateOwned(record) {
   publishProcessRegistry();
 }
 
-function waitForHttp(record, upstream, timeoutMs, expectedCapabilityIds) {
+function waitForHttp(
+  record,
+  upstream,
+  timeoutMs,
+  expectedCapabilityIds,
+  requestPath = readinessPath
+) {
   const deadline = Date.now() + timeoutMs;
   return new Promise((resolve, reject) => {
     let settled = false;
@@ -872,7 +888,7 @@ function waitForHttp(record, upstream, timeoutMs, expectedCapabilityIds) {
         {
           host: upstream.host,
           port: upstream.port,
-          path: readinessPath,
+          path: requestPath,
         },
         response => {
           if (attemptSettled || settled) {
@@ -1652,7 +1668,8 @@ async function startAndPromoteSource(baseEnv, expectedCapabilityIds) {
       sourceRecord,
       candidate,
       sourceReadyTimeoutMs,
-      expectedCapabilityIds
+      expectedCapabilityIds,
+      resolveSourceReadinessPath(baseEnv)
     );
   } catch (error) {
     try {