@lark-apaas/fullstack-cli 1.1.66-alpha.20260902183957 → 1.1.66-alpha.20260903064712

package/package.json

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

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

@@ -18,6 +18,8 @@ const MAX_MANIFEST_BYTES = 1024 * 1024;
 const MAX_READINESS_RESPONSE_BYTES = 64 * 1024;
 const SOURCE_RETRY_INITIAL_DELAY_MS = 250;
 const SOURCE_RETRY_MAX_DELAY_MS = 5_000;
+const DEFAULT_SOURCE_START_DELAY_MS = 15_000;
+const TEST_SOURCE_START_DELAY_ARG = '--miaoda-test-source-start-delay-ms=';
 const RUNTIME_CONTROL_ENV_KEYS = new Set([
   'MIAODA_COLD_START_DECISION_FILE',
   'MIAODA_DEPENDENCY_READY_FILE',
@@ -72,14 +74,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';
-const clientBasePath =
-  process.env.CLIENT_BASE_PATH?.startsWith('/') &&
-  !process.env.CLIENT_BASE_PATH.startsWith('//')
-    ? process.env.CLIENT_BASE_PATH.replace(/\/+$/, '')
-    : '';
-const sourceReadinessPath = clientBasePath
-  ? `${clientBasePath}/__innerapi__/capability/list`
-  : readinessPath;
+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
@@ -89,6 +93,7 @@ const shutdownTimeoutMs = positiveDuration(
   5_000
 );
 const drainTimeoutMs = positiveDuration('MIAODA_NEST_DRAIN_TIMEOUT_MS', 5_000);
+const sourceStartDelayMs = sourceStartDelayForRuntime();
 const processStartTicks =
   readLinuxProcessStartTicks(process.pid) ||
   String(
@@ -219,12 +224,29 @@ let resolveLifetime;
 const lifetime = new Promise(resolve => {
   resolveLifetime = resolve;
 });
+let firstHtmlTransferredAtMs = 0;
+let resolveFirstHtmlTransferred;
+const firstHtmlTransferred = new Promise(resolve => {
+  resolveFirstHtmlTransferred = resolve;
+});
 
 function positiveDuration(name, fallback) {
   const value = Number(process.env[name] || fallback);
   return Number.isFinite(value) && value > 0 ? value : fallback;
 }
 
+function sourceStartDelayForRuntime() {
+  const testArgument = process.argv
+    .slice(2)
+    .find(argument => argument.startsWith(TEST_SOURCE_START_DELAY_ARG));
+  if (!testArgument) return DEFAULT_SOURCE_START_DELAY_MS;
+  const value = Number(testArgument.slice(TEST_SOURCE_START_DELAY_ARG.length));
+  if (!Number.isFinite(value) || value < 0) {
+    throw new Error('MIAODA_NEST_TEST_SOURCE_START_DELAY_INVALID');
+  }
+  return value;
+}
+
 function validateRuntimeConfiguration() {
   if (process.env.MIAODA_NEST_BUNDLE_HANDOFF_ENABLED !== 'true') {
     throw new Error('MIAODA_NEST_BUNDLE_HANDOFF_DISABLED');
@@ -962,6 +984,36 @@ function retain(upstream) {
   };
 }
 
+function observeFirstCacheHtmlTransfer(request, response, upstreamResponse) {
+  if (
+    firstHtmlTransferredAtMs ||
+    request.method !== 'GET' ||
+    activeUpstream !== cacheUpstream ||
+    upstreamResponse.statusCode < 200 ||
+    upstreamResponse.statusCode >= 400 ||
+    !String(upstreamResponse.headers['content-type'] || '')
+      .toLowerCase()
+      .startsWith('text/html')
+  ) {
+    return;
+  }
+  response.once('finish', () => {
+    if (firstHtmlTransferredAtMs) return;
+    firstHtmlTransferredAtMs = Date.now();
+    resolveFirstHtmlTransferred(firstHtmlTransferredAtMs);
+    process.stderr.write(
+      `${JSON.stringify({
+        event: 'miaoda_nest_html_transferred',
+        bootId,
+        generationId: currentGenerationId,
+        sourceStartDelayMs,
+        atMs: firstHtmlTransferredAtMs,
+        elapsedMs: firstHtmlTransferredAtMs - restoreEpochMs,
+      })}\n`
+    );
+  });
+}
+
 function createProxy() {
   const server = http.createServer((request, response) => {
     const upstream = activeUpstream;
@@ -980,6 +1032,7 @@ function createProxy() {
         headers: request.headers,
       },
       upstreamResponse => {
+        observeFirstCacheHtmlTransfer(request, response, upstreamResponse);
         response.writeHead(
           upstreamResponse.statusCode || 502,
           upstreamResponse.statusMessage || '',
@@ -1588,6 +1641,18 @@ async function waitForReceipt(expectedGenerationId) {
   if (shuttingDown) throw new Error('MIAODA_NEST_RUNTIME_STOPPING');
 }
 
+async function waitForSourceStartWindow() {
+  if (sourceStartDelayMs === 0) return;
+  const htmlTransferredAtMs = await firstHtmlTransferred;
+  const deadline = htmlTransferredAtMs + sourceStartDelayMs;
+  while (!shuttingDown && Date.now() < deadline) {
+    await new Promise(resolve =>
+      setTimeout(resolve, Math.min(50, deadline - Date.now()))
+    );
+  }
+  if (shuttingDown) throw new Error('MIAODA_NEST_RUNTIME_STOPPING');
+}
+
 async function runActionPluginInit(baseEnv) {
   const record = spawnOwned(
     'action-plugin-init',
@@ -1667,7 +1732,7 @@ async function startAndPromoteSource(baseEnv, expectedCapabilityIds) {
       candidate,
       sourceReadyTimeoutMs,
       expectedCapabilityIds,
-      sourceReadinessPath
+      resolveSourceReadinessPath(baseEnv)
     );
   } catch (error) {
     try {
@@ -1706,6 +1771,21 @@ async function startAndPromoteSource(baseEnv, expectedCapabilityIds) {
 
 async function promoteSource(expectedGenerationId, expectedCapabilityIds) {
   await waitForReceipt(expectedGenerationId);
+  await waitForSourceStartWindow();
+  const sourceStartingAtMs = Date.now();
+  process.stderr.write(
+    `${JSON.stringify({
+      event: 'miaoda_nest_source_starting',
+      bootId,
+      generationId: currentGenerationId,
+      sourceStartDelayMs,
+      atMs: sourceStartingAtMs,
+      elapsedMs: sourceStartingAtMs - restoreEpochMs,
+      htmlToSourceStartMs: firstHtmlTransferredAtMs
+        ? sourceStartingAtMs - firstHtmlTransferredAtMs
+        : 0,
+    })}\n`
+  );
   let retryDelayMs = SOURCE_RETRY_INITIAL_DELAY_MS;
   let baseEnv;
   while (!shuttingDown && !baseEnv) {