@lark-apaas/fullstack-cli 1.1.59-alpha.20260719171717 → 1.1.59-alpha.20260720184331

package/package.json

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

package/templates/scripts/dev.js

@@ -8,7 +8,9 @@ const readline = require('readline');
 const {
   applyPreviewArtifactHostOverrides,
   buildListeningPortLookupArgs,
+  closePreviewPhaseReporterWithRetry,
   createDeferredTypecheckGate,
+  createPreviewPhaseFrameDecoder,
   createPreviewPhaseReporter,
   normalizeTcpPort,
   parseTscWatchSummary,
@@ -199,6 +201,7 @@ function startProcess({
   args,
   cleanupPort,
   phaseDetail = {},
+  phaseChannel = false,
   onReady,
   onOutputLine,
 }) {
@@ -236,12 +239,23 @@ function startProcess({
     }
 
     while (!stopping) {
+      const childEnv = { ...process.env };
+      // The parent is the only outbox writer. Child processes receive a narrow
+      // producer channel, never the filesystem destination.
+      delete childEnv.MIAODA_PREVIEW_PHASE_OUTBOX_ROOT;
+      if (phaseChannel) {
+        childEnv.MIAODA_PREVIEW_PHASE_FD = '3';
+      } else {
+        delete childEnv.MIAODA_PREVIEW_PHASE_FD;
+      }
       const child = spawn(command, args, {
         detached: true,
-        stdio: ['ignore', 'pipe', 'pipe'],
+        stdio: phaseChannel
+          ? ['ignore', 'pipe', 'pipe', 'pipe']
+          : ['ignore', 'pipe', 'pipe'],
         shell: true,
         cwd: PROJECT_ROOT,
-        env: { ...process.env },
+        env: childEnv,
       });
 
       entry.pid = child.pid;
@@ -307,13 +321,24 @@ function startProcess({
 
       // Pipe stdout and stderr through readline for timestamped logging
       let typecheckSummaryReported = false;
-      const pipeLines = stream => {
+      let phaseReported = false;
+      const pipeLines = (stream, allowPhaseFallback = false) => {
         const rl = readline.createInterface({
           input: stream,
           crlfDelay: Infinity,
         });
         rl.on('line', line => {
           if (onOutputLine) onOutputLine(line);
+          const legacyPhaseCandidate =
+            allowPhaseFallback && line.startsWith('[MiaodaPreviewPhase] ');
+          if (legacyPhaseCandidate && !phaseReported) {
+            phaseReported = previewPhaseReporter.ingest(line, {
+              producer: 'vite_plugin',
+              allowed_phases: ['vite_http_listening'],
+              attempt,
+              allow_legacy_stdout: true,
+            });
+          }
           if (name === 'server-typecheck' && !typecheckSummaryReported) {
             const summary = parseTscWatchSummary(line);
             if (summary) {
@@ -334,11 +359,38 @@ function startProcess({
           try {
             fs.writeSync(logFd, msg);
           } catch {}
-          writeOutput(msg);
+          // Phase fallbacks are normalized by the parent reporter before they
+          // enter the shared log. Keep the raw child claim quarantined in the
+          // component log so collectors never observe two representations.
+          if (!legacyPhaseCandidate) writeOutput(msg);
         });
       };
-      if (child.stdout) pipeLines(child.stdout);
+      if (child.stdout) pipeLines(child.stdout, phaseChannel);
       if (child.stderr) pipeLines(child.stderr);
+      if (phaseChannel && child.stdio[3]) {
+        let oversizedPhaseFrameReported = false;
+        const phaseDecoder = createPreviewPhaseFrameDecoder({
+          max_bytes: 16 * 1024,
+          on_oversized_frame: () => {
+            if (oversizedPhaseFrameReported) return;
+            oversizedPhaseFrameReported = true;
+            logEvent(
+              'WARN',
+              name,
+              'Dropped an oversized preview phase producer frame'
+            );
+          },
+          on_frame: line => {
+            if (phaseReported) return;
+            phaseReported = previewPhaseReporter.ingest(line, {
+              producer: 'vite_plugin',
+              allowed_phases: ['vite_http_listening'],
+              attempt,
+            });
+          },
+        });
+        child.stdio[3].on('data', chunk => phaseDecoder.push(chunk));
+      }
 
       // Wait for the direct child to exit.
       // NOTE: must use 'exit', not 'close'. With shell:true, grandchild processes
@@ -468,6 +520,16 @@ async function cleanup() {
 
   logEvent('INFO', 'main', 'All processes stopped');
 
+  const previewPhaseSealed =
+    await closePreviewPhaseReporterWithRetry(previewPhaseReporter);
+  if (!previewPhaseSealed) {
+    logEvent(
+      'ERROR',
+      'main',
+      'Preview phase outbox did not seal after bounded shutdown retries'
+    );
+  }
+
   try {
     fs.closeSync(devStdLogFd);
   } catch {}
@@ -475,7 +537,7 @@ async function cleanup() {
     fs.closeSync(devLogFd);
   } catch {}
 
-  process.exit(0);
+  process.exit(previewPhaseSealed ? 0 : 1);
 }
 
 process.on('SIGTERM', cleanup);
@@ -644,6 +706,7 @@ async function main() {
     command: 'npm',
     args: ['run', 'dev:client'],
     cleanupPort: CLIENT_DEV_PORT,
+    phaseChannel: true,
   });
 
   writeOutput(`📋 Dev processes running. Press Ctrl+C to stop.\n`);
@@ -657,7 +720,14 @@ async function main() {
   }
 }
 
-main().catch(err => {
+main().catch(async err => {
   console.error('Fatal error:', err);
+  const previewPhaseSealed =
+    await closePreviewPhaseReporterWithRetry(previewPhaseReporter);
+  if (!previewPhaseSealed) {
+    console.error(
+      'Preview phase outbox did not seal after bounded fatal-exit retries'
+    );
+  }
   process.exit(1);
 });