@happier-dev/stack 0.1.0 → 0.2.0

package/scripts/stack/stack_mobile_install_command.mjs

@@ -4,48 +4,114 @@ import { parseEnvToObject } from '../utils/env/dotenv.mjs';
 import { ensureEnvFileUpdated } from '../utils/env/env_file.mjs';
 import { readTextOrEmpty } from '../utils/fs/ops.mjs';
 import { resolveStackEnvPath } from '../utils/paths/paths.mjs';
-import { defaultStackReleaseIdentity } from '../utils/mobile/identifiers.mjs';
+import { defaultDevClientIdentity, defaultStackReleaseIdentity } from '../utils/mobile/identifiers.mjs';
 
 import { runStackScriptWithStackEnv } from './run_script_with_stack_env.mjs';
 
-export async function runStackMobileInstallCommand({ rootDir, stackName, passthrough, json }) {
-  const { flags: mobileFlags, kv: mobileKv } = parseArgs(passthrough);
+function resolveRequestedAppEnv(mobileKv) {
+  const raw = (mobileKv.get('--app-env') ?? '').toString().trim().toLowerCase();
+  return raw === 'development' ? 'development' : 'production';
+}
+
+function resolveInstallConfiguration({ appEnv, mobileKv }) {
+  const explicit = (mobileKv.get('--configuration') ?? '').toString().trim();
+  if (explicit) return explicit;
+  return appEnv === 'development' ? 'Debug' : 'Release';
+}
+
+function buildDevelopmentInstallExtraEnv() {
+  return {
+    HAPPIER_EXPO_DEVCLIENT_LAUNCH_MODE: 'most-recent',
+    HAPPIER_EXPO_DEVCLIENT_SILENT_LAUNCH: 'true',
+    HAPPIER_EXPO_USE_NATIVE_DEBUG: 'true',
+    EX_UPDATES_NATIVE_DEBUG: '1',
+  };
+}
+
+export function resolveStackMobileInstallPlan({ stackName, passthrough, existing, user }) {
+  const { kv: mobileKv } = parseArgs(passthrough);
   const device = (mobileKv.get('--device') ?? '').toString();
   const name = (mobileKv.get('--name') ?? mobileKv.get('--app-name') ?? '').toString().trim();
-  const jsonOut = wantsJson(passthrough, { flags: mobileFlags }) || json;
+  const appEnv = resolveRequestedAppEnv(mobileKv);
+  const configuration = resolveInstallConfiguration({ appEnv, mobileKv });
 
-  const envPath = resolveStackEnvPath(stackName).envPath;
-  const existingRaw = await readTextOrEmpty(envPath);
-  const existing = parseEnvToObject(existingRaw);
-  const priorName = (existing.HAPPIER_STACK_MOBILE_RELEASE_IOS_APP_NAME ?? '').toString().trim();
-  const identity = defaultStackReleaseIdentity({
-    stackName,
-    user: process.env.USER ?? process.env.USERNAME ?? 'user',
-    appName: name || priorName || null,
-  });
+  const priorNameKey =
+    appEnv === 'development'
+      ? 'HAPPIER_STACK_MOBILE_DEVELOPMENT_IOS_APP_NAME'
+      : 'HAPPIER_STACK_MOBILE_RELEASE_IOS_APP_NAME';
+  const priorName = (existing?.[priorNameKey] ?? '').toString().trim();
+  const identity =
+    appEnv === 'development'
+      ? {
+          ...defaultDevClientIdentity({ user }),
+          ...(name || priorName ? { iosAppName: name || priorName } : {}),
+        }
+      : defaultStackReleaseIdentity({
+          stackName,
+          user,
+          appName: name || priorName || null,
+        });
 
-  await ensureEnvFileUpdated({
-    envPath,
-    updates: [
-      { key: 'HAPPIER_STACK_MOBILE_RELEASE_IOS_APP_NAME', value: identity.iosAppName },
-      { key: 'HAPPIER_STACK_MOBILE_RELEASE_IOS_BUNDLE_ID', value: identity.iosBundleId },
-      { key: 'HAPPIER_STACK_MOBILE_RELEASE_SCHEME', value: identity.scheme },
-    ],
-  });
+  const envUpdates =
+    appEnv === 'development'
+      ? [
+          { key: 'HAPPIER_STACK_MOBILE_DEVELOPMENT_IOS_APP_NAME', value: identity.iosAppName },
+          { key: 'HAPPIER_STACK_MOBILE_DEVELOPMENT_IOS_BUNDLE_ID', value: identity.iosBundleId },
+          { key: 'HAPPIER_STACK_MOBILE_DEVELOPMENT_SCHEME', value: identity.scheme },
+        ]
+      : [
+          { key: 'HAPPIER_STACK_MOBILE_RELEASE_IOS_APP_NAME', value: identity.iosAppName },
+          { key: 'HAPPIER_STACK_MOBILE_RELEASE_IOS_BUNDLE_ID', value: identity.iosBundleId },
+          { key: 'HAPPIER_STACK_MOBILE_RELEASE_SCHEME', value: identity.scheme },
+        ];
 
   const args = [
-    '--app-env=production',
+    `--app-env=${appEnv}`,
     `--ios-app-name=${identity.iosAppName}`,
     `--ios-bundle-id=${identity.iosBundleId}`,
     `--scheme=${identity.scheme}`,
     '--prebuild',
     '--run-ios',
-    '--configuration=Release',
+    `--configuration=${configuration}`,
     '--no-metro',
     ...(device ? [`--device=${device}`] : []),
   ];
 
-  await runStackScriptWithStackEnv({ rootDir, stackName, scriptPath: 'mobile.mjs', args });
+  return {
+    appEnv,
+    identity,
+    envUpdates,
+    args,
+    extraEnv: appEnv === 'development' ? buildDevelopmentInstallExtraEnv() : {},
+  };
+}
+
+export async function runStackMobileInstallCommand({ rootDir, stackName, passthrough, json }) {
+  const { flags: mobileFlags, kv: mobileKv } = parseArgs(passthrough);
+  const jsonOut = wantsJson(passthrough, { flags: mobileFlags }) || json;
+
+  const envPath = resolveStackEnvPath(stackName).envPath;
+  const existingRaw = await readTextOrEmpty(envPath);
+  const existing = parseEnvToObject(existingRaw);
+  const plan = resolveStackMobileInstallPlan({
+    stackName,
+    passthrough,
+    existing,
+    user: process.env.USER ?? process.env.USERNAME ?? 'user',
+  });
+
+  await ensureEnvFileUpdated({
+    envPath,
+    updates: plan.envUpdates,
+  });
+
+  await runStackScriptWithStackEnv({
+    rootDir,
+    stackName,
+    scriptPath: 'mobile.mjs',
+    args: plan.args,
+    extraEnv: plan.extraEnv,
+  });
 
   if (jsonOut) {
     printResult({
@@ -54,7 +120,8 @@ export async function runStackMobileInstallCommand({ rootDir, stackName, passthr
         ok: true,
         stackName,
         installed: true,
-        identity,
+        appEnv: plan.appEnv,
+        identity: plan.identity,
       },
     });
   }

package/scripts/stack/stack_mobile_install_command.test.mjs

@@ -0,0 +1,53 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+
+import { defaultDevClientIdentity, defaultStackReleaseIdentity } from '../utils/mobile/identifiers.mjs';
+import { resolveStackMobileInstallPlan } from './stack_mobile_install_command.mjs';
+
+test('resolveStackMobileInstallPlan defaults to the production stack release install flow', () => {
+  const plan = resolveStackMobileInstallPlan({
+    stackName: 'pr272-107',
+    passthrough: ['--device=iPhone 13'],
+    existing: {},
+    user: 'Leeroy',
+  });
+
+  const expectedIdentity = defaultStackReleaseIdentity({ stackName: 'pr272-107', user: 'Leeroy' });
+  assert.equal(plan.appEnv, 'production');
+  assert.deepEqual(plan.identity, expectedIdentity);
+  assert.deepEqual(plan.extraEnv, {});
+  assert.ok(plan.args.includes('--app-env=production'));
+  assert.ok(plan.args.includes('--configuration=Release'));
+  assert.ok(plan.args.includes('--device=iPhone 13'));
+  assert.deepEqual(plan.envUpdates, [
+    { key: 'HAPPIER_STACK_MOBILE_RELEASE_IOS_APP_NAME', value: expectedIdentity.iosAppName },
+    { key: 'HAPPIER_STACK_MOBILE_RELEASE_IOS_BUNDLE_ID', value: expectedIdentity.iosBundleId },
+    { key: 'HAPPIER_STACK_MOBILE_RELEASE_SCHEME', value: expectedIdentity.scheme },
+  ]);
+});
+
+test('resolveStackMobileInstallPlan supports a development install with Expo native-debug update flags', () => {
+  const plan = resolveStackMobileInstallPlan({
+    stackName: 'repo-main',
+    passthrough: ['--app-env=development'],
+    existing: {},
+    user: 'Leeroy',
+  });
+
+  const expectedIdentity = defaultDevClientIdentity({ user: 'Leeroy' });
+  assert.equal(plan.appEnv, 'development');
+  assert.deepEqual(plan.identity, expectedIdentity);
+  assert.deepEqual(plan.extraEnv, {
+    HAPPIER_EXPO_DEVCLIENT_LAUNCH_MODE: 'most-recent',
+    HAPPIER_EXPO_DEVCLIENT_SILENT_LAUNCH: 'true',
+    HAPPIER_EXPO_USE_NATIVE_DEBUG: 'true',
+    EX_UPDATES_NATIVE_DEBUG: '1',
+  });
+  assert.ok(plan.args.includes('--app-env=development'));
+  assert.ok(plan.args.includes('--configuration=Debug'));
+  assert.deepEqual(plan.envUpdates, [
+    { key: 'HAPPIER_STACK_MOBILE_DEVELOPMENT_IOS_APP_NAME', value: expectedIdentity.iosAppName },
+    { key: 'HAPPIER_STACK_MOBILE_DEVELOPMENT_IOS_BUNDLE_ID', value: expectedIdentity.iosBundleId },
+    { key: 'HAPPIER_STACK_MOBILE_DEVELOPMENT_SCHEME', value: expectedIdentity.scheme },
+  ]);
+});

package/scripts/stack.mjs

@@ -41,7 +41,7 @@ import {
   withStackEnv,
   writeStackEnv,
 } from './stack/stack_environment.mjs';
-import { cmdAuth, cmdListStacks, cmdService, cmdSrv, cmdTailscale, cmdWt } from './stack/delegated_script_commands.mjs';
+import { cmdAuth, cmdListStacks, cmdRuntime, cmdService, cmdSrv, cmdTailscale, cmdWt } from './stack/delegated_script_commands.mjs';
 import { runStackDaemonCommand } from './stack/stack_daemon_command.mjs';
 import { runStackHappierPassthroughCommand } from './stack/stack_happier_passthrough_command.mjs';
 import { runStackMobileInstallCommand } from './stack/stack_mobile_install_command.mjs';
@@ -334,7 +334,7 @@ async function cmdNew({ rootDir, argv, emit = true }) {
       throw new Error(
         `[stack] repo checkout does not exist: ${resolved || '(empty)'}\n` +
           `Fix:\n` +
-          `- run: hstack setup --profile=dev (clones the monorepo into the workspace)\n` +
+          `- run: hstack setup-from-source --profile=dev (clones the monorepo into the workspace)\n` +
           `- or pass an explicit --repo=<path|worktreeSpec>\n`
       );
     }
@@ -361,12 +361,19 @@ async function cmdNew({ rootDir, argv, emit = true }) {
       json,
       requireSourceStackExists: kv.has('--copy-auth-from'),
       linkMode: linkAuth,
-    }).catch((err) => {
-      if (!json && emit) {
-        console.warn(`[stack] auth copy skipped: ${err instanceof Error ? err.message : String(err)}`);
-        console.warn(`[stack] tip: you can always run: hstack stack auth ${stackName} login`);
-      }
-    });
+    })
+      .then(() => {
+        if (kv.has('--copy-auth-from') && copyAuthFrom) {
+          stackEnv.HAPPIER_STACK_AUTH_SEED_FROM = copyAuthFrom;
+          stackEnv.HAPPIER_STACK_AUTO_AUTH_SEED = '1';
+        }
+      })
+      .catch((err) => {
+        if (!json && emit) {
+          console.warn(`[stack] auth copy skipped: ${err instanceof Error ? err.message : String(err)}`);
+          console.warn(`[stack] tip: you can always run: hstack stack auth ${stackName} login`);
+        }
+      });
   }
 
   const envPath = await writeStackEnv({ stackName, env: stackEnv });
@@ -981,14 +988,18 @@ async function cmdCreateDevAuthSeed({ rootDir, argv }) {
   const forceAuth = resolveAuthForceFlag({ flags, kv });
 
   if (json) {
-    // Keep JSON mode non-interactive and stable by using the existing stack command output.
-    // (We intentionally don't run the guided login flow in JSON mode.)
-    const createArgs = ['new', name, '--no-copy-auth', '--server', serverComponent, '--json'];
-    const created = await runCapture(process.execPath, [join(rootDir, 'scripts', 'stack.mjs'), ...createArgs], { cwd: rootDir, env: process.env }).catch((e) => {
-      throw new Error(
-        `[stack] create-dev-auth-seed: failed to create auth seed stack "${name}": ${e instanceof Error ? e.message : String(e)}`
-      );
-    });
+    // Keep JSON mode non-interactive and stable by reusing an existing seed stack instead of
+    // recreating it, which would overwrite its pinned repo/worktree selection.
+    let createdPayload = { ok: true, stackName: name, reused: true };
+    if (!stackExistsSync(name)) {
+      const createArgs = ['new', name, '--no-copy-auth', '--server', serverComponent, '--json'];
+      const created = await runCapture(process.execPath, [join(rootDir, 'scripts', 'stack.mjs'), ...createArgs], { cwd: rootDir, env: process.env }).catch((e) => {
+        throw new Error(
+          `[stack] create-dev-auth-seed: failed to create auth seed stack "${name}": ${e instanceof Error ? e.message : String(e)}`
+        );
+      });
+      createdPayload = created.trim() ? JSON.parse(created.trim()) : { ok: true, stackName: name };
+    }
 
     printResult({
       json,
@@ -996,7 +1007,7 @@ async function cmdCreateDevAuthSeed({ rootDir, argv }) {
         ok: true,
         seedStack: name,
         serverComponent,
-        created: created.trim() ? JSON.parse(created.trim()) : { ok: true },
+        created: createdPayload,
         next: {
           login: `hstack stack auth ${name} login`,
           setEnv: `# add to ${getHomeEnvLocalPath()}:\nHAPPIER_STACK_AUTH_SEED_FROM=${name}\nHAPPIER_STACK_AUTO_AUTH_SEED=1`,
@@ -1174,13 +1185,16 @@ async function cmdCreateDevAuthSeed({ rootDir, argv }) {
                 // Prefer localhost for readiness checks (faster/more reliable), even though we
                 // instruct the user to use the stack-scoped *.localhost origin for storage isolation.
                 await waitForHttpOk(uiRootLocalhost || uiRoot, { timeoutMs: 30_000 });
-                try {
-                  await assertExpoWebappBundlesOrThrow({
-                    rootDir,
-                    stackName: name,
-                    webappUrl: uiRootLocalhost || uiRoot,
-                  });
-                } catch (e) {
+	                try {
+	                  const bundleTimeoutRaw = String(process.env.HAPPIER_STACK_AUTH_EXPO_BUNDLE_READY_TIMEOUT_MS ?? '').trim();
+	                  const bundleTimeoutMs = bundleTimeoutRaw ? Number(bundleTimeoutRaw) : null;
+	                  await assertExpoWebappBundlesOrThrow({
+	                    rootDir,
+	                    stackName: name,
+	                    webappUrl: uiRootLocalhost || uiRoot,
+	                    timeoutMs: Number.isFinite(bundleTimeoutMs) && bundleTimeoutMs > 0 ? bundleTimeoutMs : undefined,
+	                  });
+	                } catch (e) {
                   const detail = e instanceof Error ? e.message : String(e);
                   throw new Error(
                     `[stack] temporary UI is reachable, but the Expo web bundle is not ready.\n` +
@@ -2144,7 +2158,7 @@ async function main() {
       cmd === 'service'
         ? [
             '[stack] usage:',
-            '  hstack stack service <name> <install|uninstall|status|start|stop|restart|enable|disable|logs|tail>',
+                  '  hstack stack service <name> <install|uninstall|status|start|stop|restart|enable|disable|logs|tail> [-- ...]',
             '',
             'example:',
             '  hstack stack service exp1 status',
@@ -2165,15 +2179,23 @@ async function main() {
                 'example:',
                 '  hstack stack srv exp1 -- status',
               ]
-            : cmd === 'env'
-              ? [
-                  '[stack] usage:',
-                  '  hstack stack env <name> set KEY=VALUE [KEY2=VALUE2...]',
-                  '  hstack stack env <name> unset KEY [KEY2...]',
-                  '  hstack stack env <name> get KEY',
-                  '  hstack stack env <name> list',
-                  '  hstack stack env <name> path',
-                ]
+              : cmd === 'env'
+                ? [
+                    '[stack] usage:',
+                    '  hstack stack env <name> set KEY=VALUE [KEY2=VALUE2...]',
+                    '  hstack stack env <name> unset KEY [KEY2...]',
+                    '  hstack stack env <name> get KEY',
+                    '  hstack stack env <name> list',
+                    '  hstack stack env <name> path',
+                  ]
+                : cmd === 'runtime'
+                  ? [
+                      '[stack] usage:',
+                      '  hstack stack runtime <name> activate [--web|--server|--daemon|--all] [--json]',
+                      '',
+                      'example:',
+                      '  hstack stack runtime exp1 activate --web',
+                    ]
               : cmd === 'eas'
                 ? [
                     '[stack] usage:',
@@ -2351,7 +2373,7 @@ async function main() {
         data: { ok: false, error: 'missing_service_subcommand', stackName },
         text: [
           '[stack] usage:',
-          '  hstack stack service <name> <install|uninstall|status|start|stop|restart|enable|disable|logs|tail>',
+          '  hstack stack service <name> <install|uninstall|status|start|stop|restart|enable|disable|logs|tail> [-- ...]',
           '',
           'example:',
           `  hstack stack service ${stackName} status`,
@@ -2359,13 +2381,32 @@ async function main() {
       });
       process.exit(1);
     }
-    await cmdService({ rootDir, stackName, svcCmd });
+    await cmdService({ rootDir, stackName, svcCmd, args: passthrough.slice(1) });
+    return;
+  }
+  if (cmd === 'runtime') {
+    const runtimeCmd = passthrough[0];
+    if (runtimeCmd !== 'activate') {
+      printResult({
+        json,
+        data: { ok: false, error: 'missing_runtime_subcommand', stackName },
+        text: [
+          '[stack] usage:',
+          '  hstack stack runtime <name> activate [--web|--server|--daemon|--all] [--json]',
+          '',
+          'example:',
+          `  hstack stack runtime ${stackName} activate --web`,
+        ].join('\n'),
+      });
+      process.exit(1);
+    }
+    await cmdRuntime({ rootDir, stackName, args: passthrough.slice(1) });
     return;
   }
 
   if (cmd.startsWith('service:')) {
     const svcCmd = cmd.slice('service:'.length);
-    await cmdService({ rootDir, stackName, svcCmd });
+    await cmdService({ rootDir, stackName, svcCmd, args: passthrough });
     return;
   }
   if (cmd.startsWith('tailscale:')) {

package/scripts/stack_copy_auth_server_scoped.test.mjs

@@ -7,6 +7,7 @@ import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 import { resolveStackCredentialPaths } from './utils/auth/credentials_paths.mjs';
+import { pickNextFreeTcpPort } from './utils/net/ports.mjs';
 
 function runNode(args, { cwd, env }) {
   return new Promise((resolve, reject) => {
@@ -31,7 +32,7 @@ test('hstack stack new copies server-scoped credentials from source stack', asyn
   const sandboxDir = join(tmp, 'sandbox');
   const sourceStack = 'seed-auth';
   const targetStack = 'exp-copy-auth';
-  const serverPort = 4101;
+  const serverPort = await pickNextFreeTcpPort(4101, { host: '127.0.0.1' });
   const serverUrl = `http://127.0.0.1:${serverPort}`;
 
   const monoRoot = join(workspaceDir, 'tmp', 'leeroy-wip');
@@ -89,6 +90,9 @@ test('hstack stack new copies server-scoped credentials from source stack', asyn
   const targetCred = resolveStackCredentialPaths({ cliHomeDir: targetCliHome, serverUrl, env: targetStableEnv });
   const targetCredRaw = await readFile(targetCred.serverScopedPath, 'utf-8');
   assert.equal(targetCredRaw.trim(), 'seed-credential');
+  const targetEnvRaw = await readFile(join(storageDir, targetStack, 'env'), 'utf-8');
+  assert.match(targetEnvRaw, new RegExp(`^HAPPIER_STACK_AUTH_SEED_FROM=${sourceStack}$`, 'm'));
+  assert.match(targetEnvRaw, /^HAPPIER_STACK_AUTO_AUTH_SEED=1$/m);
 
   await rm(tmp, { recursive: true, force: true });
 });
@@ -104,7 +108,7 @@ test('hstack stack new copy-auth prefers source server-scoped credentials over u
   const sandboxDir = join(tmp, 'sandbox');
   const sourceStack = 'seed-auth';
   const targetStack = 'exp-copy-auth';
-  const serverPort = 4101;
+  const serverPort = await pickNextFreeTcpPort(4101, { host: '127.0.0.1' });
   const serverUrl = `http://127.0.0.1:${serverPort}`;
 
   const monoRoot = join(workspaceDir, 'tmp', 'leeroy-wip');
@@ -178,7 +182,7 @@ test('hstack stack new copy-auth copies stable-scope credentials from source sta
   const sandboxDir = join(tmp, 'sandbox');
   const sourceStack = 'seed-auth';
   const targetStack = 'exp-copy-auth';
-  const serverPort = 4101;
+  const serverPort = await pickNextFreeTcpPort(4101, { host: '127.0.0.1' });
   const serverUrl = `http://127.0.0.1:${serverPort}`;
 
   const monoRoot = join(workspaceDir, 'tmp', 'leeroy-wip');

package/scripts/stack_create_dev_auth_seed_repo_pin.test.mjs

@@ -0,0 +1,43 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { join } from 'node:path';
+
+import { runNodeCapture } from './testkit/core/run_node_capture.mjs';
+import { setupStackNewMonorepoFixture } from './testkit/stack_new_monorepo_testkit.mjs';
+
+test('hstack stack create-dev-auth-seed --json preserves an existing pinned repo dir', async (t) => {
+  const fixture = await setupStackNewMonorepoFixture({
+    importMetaUrl: import.meta.url,
+    t,
+    tmpPrefix: 'hstack-stack-create-dev-auth-seed-repo-pin-',
+  });
+
+  await fixture.createMonorepoCheckout('main');
+  const devRoot = await fixture.createMonorepoCheckout('dev');
+  const stackName = 'exp-dev-auth-seed';
+
+  const created = await fixture.runStackNew([stackName, `--repo=${devRoot}`, '--no-copy-auth', '--json']);
+  assert.equal(created.code, 0, `stack new should succeed\nstdout:\n${created.stdout}\nstderr:\n${created.stderr}`);
+
+  const before = await fixture.readStackEnv(stackName);
+  assert.ok(before.includes(`HAPPIER_STACK_REPO_DIR=${devRoot}\n`), before);
+
+  const reseeded = await runNodeCapture(
+    [join(fixture.rootDir, 'scripts', 'stack.mjs'), 'create-dev-auth-seed', stackName, '--non-interactive', '--json'],
+    {
+      cwd: fixture.rootDir,
+      env: fixture.baseEnv,
+    }
+  );
+  assert.equal(
+    reseeded.code,
+    0,
+    `create-dev-auth-seed --json should succeed\nstdout:\n${reseeded.stdout}\nstderr:\n${reseeded.stderr}`
+  );
+
+  const after = await fixture.readStackEnv(stackName);
+  assert.ok(
+    after.includes(`HAPPIER_STACK_REPO_DIR=${devRoot}\n`),
+    `expected existing repo pin to survive create-dev-auth-seed --json\n${after}`
+  );
+});