@happier-dev/stack 0.1.0 → 0.2.0-preview.1775370152.55749

package/scripts/tui.mjs

@@ -1,9 +1,11 @@
 import './utils/env/env.mjs';
 import { spawn } from 'node:child_process';
 import { mkdir } from 'node:fs/promises';
+import * as os from 'node:os';
 import { join, resolve, sep } from 'node:path';
 
 import { printResult } from './utils/cli/cli.mjs';
+import { resolveCommandInvocation } from './utils/process/resolveCommandInvocation.mjs';
 import { readEnvObjectFromFile } from './utils/env/read.mjs';
 import { getComponentDir, getRepoDir, getRootDir, resolveStackEnvPath } from './utils/paths/paths.mjs';
 import { getStackRuntimeStatePath, readStackRuntimeStateFile } from './utils/stack/runtime_state.mjs';
@@ -16,13 +18,21 @@ import { resolveMobileQrPayload } from './utils/mobile/dev_client_links.mjs';
 import { worktreeSpecFromDir } from './utils/git/worktrees.mjs';
 import { stopStackForTuiExit } from './utils/tui/cleanup.mjs';
 import {
+  extractTuiLaunchOptions,
   inferTuiStackName,
   isTuiHelpRequest,
   isTuiRestartableForwardedArgs,
   isTuiStartLikeForwardedArgs,
-  normalizeTuiForwardedArgs,
 } from './utils/tui/args.mjs';
+import {
+  buildTuiChildArgs,
+  buildTauriPaneEnv,
+  resolveTauriPaneSpawnConfig,
+  shouldStartTauriPane,
+} from './utils/tui/tauri_mode.mjs';
 import { terminateProcessGroup } from './utils/proc/terminate.mjs';
+import { getProcessGroupId } from './utils/proc/ownership.mjs';
+import { killPid } from './utils/expo/expo.mjs';
 import { getInvokedCwd, inferComponentFromCwd } from './utils/cli/cwd_scope.mjs';
 import { mergeEnvForTuiSummary } from './utils/tui/summary_env.mjs';
 import { hasStackCredentials } from './utils/auth/daemon_gate.mjs';
@@ -34,6 +44,10 @@ import { buildTuiAuthArgs, buildTuiDaemonStartArgs, shouldHoldAfterAuthExit } fr
 import { shouldAttemptTuiDaemonAutostart } from './utils/tui/daemon_autostart.mjs';
 import { reconcileDaemonPaneAfterDaemonStarts } from './utils/tui/daemon_pane_reconcile.mjs';
 import { buildScriptPtyArgs } from './utils/tui/script_pty_command.mjs';
+import { resolveTuiChildTerminationPlan } from './utils/tui/child_termination_plan.mjs';
+import { installTuiStdinErrorGuard } from './utils/tui/stdin_error_guard.mjs';
+import { checkDaemonState } from './daemon.mjs';
+import { getObservedStackDaemon } from './utils/stack/runtime_daemon_state.mjs';
 
 function nowTs() {
   const d = new Date();
@@ -202,12 +216,16 @@ async function preflightCorepackYarnForStack({ envPath }) {
   await mkdir(env.COREPACK_HOME, { recursive: true }).catch(() => {});
 
   await new Promise((resolvePromise) => {
-    const proc = spawn('yarn', ['--version'], {
+    const invocation = resolveCommandInvocation({ command: 'yarn', args: ['--version'], env });
+    const proc = spawn(invocation.command, invocation.args, {
       env,
       cwd: baseDir,
       // Non-tty stdio: Corepack typically won't prompt; if it does, we still provide "y\n".
       stdio: ['pipe', 'ignore', 'ignore'],
       shell: false,
+      ...(process.platform === 'win32'
+        ? { windowsHide: true, windowsVerbatimArguments: invocation.windowsVerbatimArguments }
+        : null),
     });
     try {
       proc.stdin?.write('y\n');
@@ -331,6 +349,14 @@ async function buildStackSummaryLines({ rootDir, stackName }) {
     ? hasStackCredentials({ cliHomeDir, serverUrl: internalServerUrl, env: authScopeEnv })
     : hasStackCredentials({ cliHomeDir, serverUrl: '', env: authScopeEnv });
   const startDaemon = parseStartDaemonFlagFromEnv(env);
+  const observedDaemon = getObservedStackDaemon({
+    cliHomeDir,
+    internalServerUrl,
+    runtimeDaemonPid: processes?.daemonPid ?? null,
+    env: authScopeEnv,
+  }, {
+    checkDaemonStateImpl: checkDaemonState,
+  });
 
   const lines = [];
   lines.push(`stack: ${stackName}`);
@@ -346,7 +372,8 @@ async function buildStackSummaryLines({ rootDir, stackName }) {
   const notice = buildDaemonAuthNotice({
     stackName,
     internalServerUrl,
-    daemonPid: processes?.daemonPid ?? null,
+    daemonPid: observedDaemon.pid,
+    daemonRunning: observedDaemon.running,
     authed,
     startDaemon,
   });
@@ -373,7 +400,7 @@ async function buildStackSummaryLines({ rootDir, stackName }) {
   lines.push('pids:');
   if (processes?.serverPid) lines.push(`  serverPid: ${processes.serverPid}`);
   if (processes?.expoPid) lines.push(`  expoPid: ${processes.expoPid}`);
-  if (processes?.daemonPid) lines.push(`  daemonPid: ${processes.daemonPid}`);
+  if (observedDaemon.pid) lines.push(`  daemonPid: ${observedDaemon.pid}`);
   if (processes?.uiGatewayPid) lines.push(`  uiGatewayPid: ${processes.uiGatewayPid}`);
 
   lines.push('');
@@ -426,7 +453,9 @@ async function buildExpoQrPaneLines({ stackName }) {
 
 async function main() {
   const argvRaw = process.argv.slice(2);
-  const argv = normalizeTuiForwardedArgs(argvRaw);
+  const { forwardedArgs: rawForwardedArgs, withTauri } = extractTuiLaunchOptions(argvRaw);
+  const forwarded = rawForwardedArgs;
+  const childForwarded = buildTuiChildArgs({ forwardedArgs: forwarded, withTauri });
 
   if (isTuiHelpRequest(argvRaw)) {
     printResult({
@@ -434,10 +463,12 @@ async function main() {
       data: { usage: 'hstack tui [<hstack args...>]', json: false, defaultCommand: 'dev' },
       text: [
         '[tui] usage:',
-        '  hstack tui [<hstack args...>]',
+        '  hstack tui [<hstack args...>] [--tauri]',
         '',
         'defaults:',
         '  hstack tui                 => hstack tui dev',
+        '  hstack tui --tauri         => hstack tui dev with a Tauri pane',
+        '  hstack tui --tauri --mobile => hstack tui dev --mobile with a Tauri pane',
         '',
         'examples:',
         '  hstack tui stack dev resume-upstream',
@@ -476,8 +507,6 @@ async function main() {
 
   const rootDir = getRootDir(import.meta.url);
   const happysBin = join(rootDir, 'bin', 'hstack.mjs');
-  const forwarded = argv;
-
   const stackName = inferTuiStackName(forwarded, process.env);
   const stackEnvPath = stackName ? resolveStackEnvPath(stackName).envPath : null;
   const summaryTitle = stackName ? `stack summary (${stackName})` : 'session summary (stackless)';
@@ -485,6 +514,7 @@ async function main() {
   const panes = [
     mkPane('orch', 'orchestration', { visible: true, kind: 'log' }),
     mkPane('summary', summaryTitle, { visible: true, kind: 'summary' }),
+    mkPane('tauri', 'tauri', { visible: withTauri, kind: 'log' }),
     // Data-only pane: we render QR inside the Expo pane (no separate box).
     mkPane('qr', 'expo QR', { visible: false, kind: 'qr' }),
     mkPane('local', 'local', { visible: true, kind: 'log' }),
@@ -521,6 +551,16 @@ async function main() {
     pushLine(panes[paneIndexById.get('orch')], `[${nowTs()}] ${msg}`);
   };
 
+  // Prevent rare TTY `read EIO` crashes during restart/shutdown transitions.
+  // Without an 'error' listener, Node treats stdin errors as unhandled and aborts the TUI.
+  installTuiStdinErrorGuard({
+    stdin: process.stdin,
+    onError: (err) => {
+      const code = err && typeof err === 'object' ? String(err.code ?? '') : '';
+      logOrch(`stdin error ignored${code ? ` (${code})` : ''}`);
+    },
+  });
+
   // Preflight Yarn/Corepack for this stack before spawning the pty child.
   // This prevents Corepack "download yarn? [Y/n]" prompts from deadlocking the TUI.
   await preflightCorepackYarnForStack({ envPath: stackEnvPath });
@@ -537,12 +577,7 @@ async function main() {
   // In TUI mode, we intentionally do not forward keyboard input to the child process (stdin is ignored),
   // so any interactive prompts inside the child would deadlock.
   // Mark the child env so dependency installers can auto-approve safe prompts (Corepack yarn downloads).
-  const childEnv = {
-    ...process.env,
-    HAPPIER_STACK_TUI: '1',
-    // Avoid Corepack mutating package.json automatically.
-    COREPACK_ENABLE_AUTO_PIN: '0',
-  };
+  const childEnv = buildTauriPaneEnv({ env: process.env });
   let child = null;
 
   const spawnForwardedChild = () => {
@@ -550,7 +585,7 @@ async function main() {
       ? buildScriptPtyArgs({
           platform: process.platform,
           file: '/dev/null',
-          command: [process.execPath, happysBin, ...forwarded],
+          command: [process.execPath, happysBin, ...childForwarded],
         })
       : null;
     const proc = wantsPty
@@ -562,7 +597,7 @@ async function main() {
           stdio: ['ignore', 'pipe', 'pipe'],
           detached: process.platform !== 'win32',
         })
-      : spawn(process.execPath, [happysBin, ...forwarded], {
+      : spawn(process.execPath, [happysBin, ...childForwarded], {
           cwd: rootDir,
           env: childEnv,
           stdio: ['ignore', 'pipe', 'pipe'],
@@ -570,7 +605,7 @@ async function main() {
         });
 
     logOrch(
-      `spawned: ${wantsPty ? `${pty.cmd} ${pty.args.join(' ')} ` : ''}node ${happysBin} ${forwarded.join(' ')} (pid=${proc.pid})`
+      `spawned: ${wantsPty ? `${pty.cmd} ${pty.args.join(' ')} ` : ''}node ${happysBin} ${childForwarded.join(' ')} (pid=${proc.pid})`
     );
 
     const buf = { out: '', err: '' };
@@ -605,7 +640,58 @@ async function main() {
     return proc;
   };
 
+  const spawnTauriChild = () => {
+    if (!withTauri || !shouldStartTauriPane(rawForwardedArgs)) {
+      return null;
+    }
+
+    const { invocation, env: tauriEnv } = resolveTauriPaneSpawnConfig({
+      rootDir,
+      env: childEnv,
+      resolveUserHomeDir: () => {
+        try {
+          return String(os.userInfo()?.homedir ?? '').trim();
+        } catch {
+          return String(os.homedir() ?? '').trim();
+        }
+      },
+    });
+    const proc = spawn(invocation.command, invocation.args, {
+      cwd: invocation.cwd,
+      env: tauriEnv,
+      stdio: ['ignore', 'pipe', 'pipe'],
+      detached: process.platform !== 'win32',
+      ...(process.platform === 'win32' ? { windowsHide: true, windowsVerbatimArguments: invocation.windowsVerbatimArguments } : null),
+    });
+
+    logOrch(`spawned: node apps/stack/scripts/tauri_dev.mjs (pid=${proc.pid})`);
+    const tauriIdx = paneIndexById.get('tauri');
+    const tauriPane = panes[tauriIdx];
+    const write = (chunk) => {
+      const s = String(chunk ?? '');
+      for (const line of s.split(/\r?\n/)) {
+        if (!line.trim()) continue;
+        pushLine(tauriPane, line);
+      }
+      scheduleRender();
+    };
+
+    proc.stdout?.on('data', write);
+    proc.stderr?.on('data', write);
+    proc.on('exit', (code, sig) => {
+      pushLine(tauriPane, `tauri exited (code=${code}, sig=${sig ?? 'null'})`);
+      scheduleRender();
+    });
+    proc.on('error', (error) => {
+      pushLine(tauriPane, `tauri error: ${error instanceof Error ? error.message : String(error)}`);
+      scheduleRender();
+    });
+
+    return proc;
+  };
+
   child = spawnForwardedChild();
+  let tauriChild = spawnTauriChild();
 
   async function refreshSummary() {
     const idx = paneIndexById.get('summary');
@@ -620,30 +706,38 @@ async function main() {
 	    // and clear stale guidance once the daemon starts.
 	    try {
 	      const daemonIdx = paneIndexById.get('daemon');
-	      if (stackName) {
-	        const runtimePath = getStackRuntimeStatePath(stackName);
-	        const runtime = await readStackRuntimeStateFile(runtimePath);
-	        const daemonPid = Number(runtime?.processes?.daemonPid);
-
-	        const { baseDir } = resolveStackEnvPath(stackName);
-	        const serverPort = Number(runtime?.ports?.server);
-	        const internalServerUrl =
-	          Number.isFinite(serverPort) && serverPort > 0 ? `http://127.0.0.1:${serverPort}` : '';
+		      if (stackName) {
+		        const runtimePath = getStackRuntimeStatePath(stackName);
+		        const runtime = await readStackRuntimeStateFile(runtimePath);
+
+		        const { baseDir } = resolveStackEnvPath(stackName);
+		        const serverPort = Number(runtime?.ports?.server);
+		        const internalServerUrl =
+		          Number.isFinite(serverPort) && serverPort > 0 ? `http://127.0.0.1:${serverPort}` : '';
 	        const cliHomeDir = join(baseDir, 'cli');
 
 	        const scopedEnv = applyTuiStackAuthScopeEnv({ env: process.env, stackName });
-	        const authed = internalServerUrl
-	          ? hasStackCredentials({ cliHomeDir, serverUrl: internalServerUrl, env: scopedEnv })
-	          : hasStackCredentials({ cliHomeDir, serverUrl: '', env: scopedEnv });
-
-	        const startDaemon = parseStartDaemonFlagFromEnv(process.env);
-	        const notice = buildDaemonAuthNotice({
-	          stackName,
-	          internalServerUrl,
-	          daemonPid: Number.isFinite(daemonPid) && daemonPid > 1 ? daemonPid : null,
-	          authed,
-	          startDaemon,
-	        });
+		        const authed = internalServerUrl
+		          ? hasStackCredentials({ cliHomeDir, serverUrl: internalServerUrl, env: scopedEnv })
+		          : hasStackCredentials({ cliHomeDir, serverUrl: '', env: scopedEnv });
+		        const observedDaemon = getObservedStackDaemon({
+		          cliHomeDir,
+		          internalServerUrl,
+		          runtimeDaemonPid: runtime?.processes?.daemonPid ?? null,
+		          env: scopedEnv,
+		        }, {
+		          checkDaemonStateImpl: checkDaemonState,
+		        });
+
+		        const startDaemon = parseStartDaemonFlagFromEnv(process.env);
+		        const notice = buildDaemonAuthNotice({
+		          stackName,
+		          internalServerUrl,
+		          daemonPid: observedDaemon.pid,
+		          daemonRunning: observedDaemon.running,
+		          authed,
+		          startDaemon,
+		        });
 
 	        if (notice.show) {
 	          panes[daemonIdx].visible = true;
@@ -661,28 +755,30 @@ async function main() {
 	            }
 	          }
 	        } else {
-	          const reconciled = reconcileDaemonPaneAfterDaemonStarts({
-	            title: panes[daemonIdx].title,
-	            lines: panes[daemonIdx].lines,
-	            daemonPid,
-	          });
-	          panes[daemonIdx].title = reconciled.title;
-	          panes[daemonIdx].lines = reconciled.lines;
+		          const reconciled = reconcileDaemonPaneAfterDaemonStarts({
+		            title: panes[daemonIdx].title,
+		            lines: panes[daemonIdx].lines,
+		            daemonPid: observedDaemon.pid,
+		            daemonRunning: observedDaemon.running,
+		          });
+		          panes[daemonIdx].title = reconciled.title;
+		          panes[daemonIdx].lines = reconciled.lines;
 	        }
 
-	        const isStartLike = isTuiStartLikeForwardedArgs(forwarded);
+          const isStartLike = isTuiStartLikeForwardedArgs(forwarded);
 	        const minIntervalRaw = (process.env.HAPPIER_STACK_TUI_DAEMON_AUTOSTART_MIN_INTERVAL_MS ?? '').toString().trim();
 	        const minIntervalMs = minIntervalRaw ? Number(minIntervalRaw) : 12_000;
 	        const shouldAutostart = shouldAttemptTuiDaemonAutostart({
 	          stackName,
 	          isStartLike,
-	          startDaemon,
-	          internalServerUrl,
-	          authed,
-	          daemonPid: Number.isFinite(daemonPid) && daemonPid > 1 ? daemonPid : null,
-	          inProgress: daemonAutostartInProgress,
-	          lastAttemptAtMs: daemonAutostartLastAttemptAtMs,
-	          nowMs: Date.now(),
+		          startDaemon,
+		          internalServerUrl,
+		          authed,
+		          daemonPid: observedDaemon.pid,
+		          daemonRunning: observedDaemon.running,
+		          inProgress: daemonAutostartInProgress,
+		          lastAttemptAtMs: daemonAutostartLastAttemptAtMs,
+		          nowMs: Date.now(),
 	          minIntervalMs,
 	        });
 
@@ -877,8 +973,15 @@ async function main() {
 
         if (startDaemon) {
           const runtime = await readStackRuntimeStateFile(runtimePath);
-          const daemonPid = Number(runtime?.processes?.daemonPid);
-          const daemonRunning = Number.isFinite(daemonPid) && daemonPid > 1;
+          const observedDaemon = getObservedStackDaemon({
+            cliHomeDir: join(resolveStackEnvPath(stackName).baseDir, 'cli'),
+            internalServerUrl,
+            runtimeDaemonPid: runtime?.processes?.daemonPid ?? null,
+            env: { ...process.env, ...envFromFile },
+          }, {
+            checkDaemonStateImpl: checkDaemonState,
+          });
+          const daemonRunning = observedDaemon.running;
           if (!daemonRunning) {
             process.stdout.write(`\n[daemon] starting...\n`);
             const daemonArgs = buildTuiDaemonStartArgs({ happysBin, stackName });
@@ -942,7 +1045,23 @@ async function main() {
 
     const childPid = Number(child?.pid);
     if (child && child.exitCode == null && Number.isFinite(childPid) && childPid > 1) {
-      await terminateProcessGroup(childPid, { graceMs: 900 });
+      const [childPgid, selfPgid] = await Promise.all([getProcessGroupId(childPid), getProcessGroupId(process.pid)]);
+      const plan = resolveTuiChildTerminationPlan({ childPid, childPgid, selfPgid });
+      if (plan.strategy === 'pgid') {
+        await terminateProcessGroup(plan.target, { graceMs: 900 });
+      } else if (plan.strategy === 'pid') {
+        await killPid(plan.target);
+      }
+    }
+    const tauriPid = Number(tauriChild?.pid);
+    if (tauriChild && tauriChild.exitCode == null && Number.isFinite(tauriPid) && tauriPid > 1) {
+      const [tauriPgid, selfPgid] = await Promise.all([getProcessGroupId(tauriPid), getProcessGroupId(process.pid)]);
+      const plan = resolveTuiChildTerminationPlan({ childPid: tauriPid, childPgid: tauriPgid, selfPgid });
+      if (plan.strategy === 'pgid') {
+        await terminateProcessGroup(plan.target, { graceMs: 900 });
+      } else if (plan.strategy === 'pid') {
+        await killPid(plan.target);
+      }
     }
 
     try {
@@ -979,6 +1098,7 @@ async function main() {
 
     process.stdout.write(`[restart] starting stack...\n\n`);
     child = spawnForwardedChild();
+    tauriChild = spawnTauriChild();
 
     paused = false;
     handoff.restoreForTui();
@@ -1053,7 +1173,7 @@ async function main() {
 
     const focusPane = panes[focused];
     const focusLabel = focusPane ? `${focusPane.id} (${focusPane.title})` : String(focused);
-    const header = `hstack tui | ${forwarded.join(' ')} | layout=${layout} | focus=${focusLabel}`;
+    const header = `hstack tui | ${forwarded.join(' ')}${withTauri ? ' +tauri' : ''} | layout=${layout} | focus=${focusLabel}`;
     process.stdout.write(padRight(header, cols) + '\n');
 
     const bodyY = 1;
@@ -1323,7 +1443,23 @@ async function main() {
     if (child.exitCode == null && Number.isFinite(childPid) && childPid > 1) {
       // Ensure the child is actually gone before stack infra cleanup, otherwise a still-running
       // watch process can immediately respawn server/daemon and re-lock the DB.
-      await terminateProcessGroup(childPid, { graceMs: 900 });
+      const [childPgid, selfPgid] = await Promise.all([getProcessGroupId(childPid), getProcessGroupId(process.pid)]);
+      const plan = resolveTuiChildTerminationPlan({ childPid, childPgid, selfPgid });
+      if (plan.strategy === 'pgid') {
+        await terminateProcessGroup(plan.target, { graceMs: 900 });
+      } else if (plan.strategy === 'pid') {
+        await killPid(plan.target);
+      }
+    }
+    const tauriPid = Number(tauriChild?.pid);
+    if (tauriChild && tauriChild.exitCode == null && Number.isFinite(tauriPid) && tauriPid > 1) {
+      const [tauriPgid, selfPgid] = await Promise.all([getProcessGroupId(tauriPid), getProcessGroupId(process.pid)]);
+      const plan = resolveTuiChildTerminationPlan({ childPid: tauriPid, childPgid: tauriPgid, selfPgid });
+      if (plan.strategy === 'pgid') {
+        await terminateProcessGroup(plan.target, { graceMs: 900 });
+      } else if (plan.strategy === 'pid') {
+        await killPid(plan.target);
+      }
     }
 
     // Best-effort cleanup: when the TUI runs a long-lived `dev/start` command, ensure all

package/scripts/tui_args_default_cmd.test.mjs

@@ -38,4 +38,5 @@ test('tui help remains explicit', async () => {
   assert.match(res.stdout, /\[tui\] usage:/);
   assert.match(res.stdout, /hstack tui \[\<hstack args\.\.\.\>\]/);
   assert.match(res.stdout, /hstack tui\s+=> hstack tui dev/);
+  assert.match(res.stdout, /hstack tui --tauri\s+=> hstack tui dev with a Tauri pane/);
 });

package/scripts/utils/auth/clearStackForceLoginCredentialPaths.mjs

@@ -0,0 +1,20 @@
+import { resolveStackCredentialPaths } from './credentials_paths.mjs';
+import { removeFileOrSymlinkIfExists } from './files.mjs';
+
+export async function clearStackForceLoginCredentialPaths({
+  cliHomeDir,
+  serverUrl,
+  env = process.env,
+}) {
+  const resolved = resolveStackCredentialPaths({ cliHomeDir, serverUrl, env });
+  const attemptedPaths = [...new Set(resolved.paths.map((path) => String(path ?? '').trim()).filter(Boolean))];
+  const removedPaths = [];
+
+  for (const path of attemptedPaths) {
+    // eslint-disable-next-line no-await-in-loop
+    const removed = await removeFileOrSymlinkIfExists(path);
+    if (removed) removedPaths.push(path);
+  }
+
+  return { attemptedPaths, removedPaths };
+}