@happier-dev/stack 0.1.0-preview.142.1 → 0.1.0-preview.21.1

package/node_modules/@happier-dev/cli-common/dist/service/launchd.d.ts

@@ -11,5 +11,9 @@ export declare function buildLaunchdPlistXml(params: Readonly<{
     workingDirectory?: string;
     keepAliveOnFailure?: boolean;
     startIntervalSec?: number;
+    startCalendarInterval?: Readonly<{
+        hour: number;
+        minute: number;
+    }>;
 }>): string;
 //# sourceMappingURL=launchd.d.ts.map

package/node_modules/@happier-dev/cli-common/dist/service/launchd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"launchd.d.ts","sourceRoot":"","sources":["../../src/service/launchd.ts"],"names":[],"mappings":"AASA,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,QAAQ,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAM,GAAG,MAAM,CAmBxG;AAWD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,CAAC;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC,GAAG,MAAM,CAmEV"}
+{"version":3,"file":"launchd.d.ts","sourceRoot":"","sources":["../../src/service/launchd.ts"],"names":[],"mappings":"AASA,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,QAAQ,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAM,GAAG,MAAM,CAmBxG;AAWD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,CAAC;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,QAAQ,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE,CAAC,GAAG,MAAM,CA0FV"}

package/node_modules/@happier-dev/cli-common/dist/service/launchd.js

@@ -65,6 +65,26 @@ export function buildLaunchdPlistXml(params) {
     const startInterval = interval
         ? `\n    <key>StartInterval</key>\n    <integer>${interval}</integer>\n`
         : '';
+    const calendar = params.startCalendarInterval;
+    const calHourRaw = Number(calendar?.hour);
+    const calMinuteRaw = Number(calendar?.minute);
+    const calHour = Number.isFinite(calHourRaw) ? Math.floor(calHourRaw) : NaN;
+    const calMinute = Number.isFinite(calMinuteRaw) ? Math.floor(calMinuteRaw) : NaN;
+    const hasCalendar = Number.isFinite(calHour)
+        && Number.isFinite(calMinute)
+        && calHour >= 0
+        && calHour <= 23
+        && calMinute >= 0
+        && calMinute <= 59;
+    const startCalendarInterval = hasCalendar
+        ? (`\n    <key>StartCalendarInterval</key>\n` +
+            `    <dict>\n` +
+            `      <key>Hour</key>\n` +
+            `      <integer>${calHour}</integer>\n` +
+            `      <key>Minute</key>\n` +
+            `      <integer>${calMinute}</integer>\n` +
+            `    </dict>\n`)
+        : '';
     return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
@@ -80,7 +100,7 @@ ${programArgsXml}
     <key>RunAtLoad</key>
     <true/>
 ${keepAlive}
-${startInterval}
+${startCalendarInterval || startInterval}
 ${workingDirXml}    <key>StandardOutPath</key>
     <string>${xmlEscape(stdoutPath)}</string>
     <key>StandardErrorPath</key>

package/node_modules/@happier-dev/cli-common/dist/service/launchd.js.map

@@ -1 +1 @@
-{"version":3,"file":"launchd.js","sourceRoot":"","sources":["../../src/service/launchd.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"launchd.js","sourceRoot":"","sources":["../../src/service/launchd.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@happier-dev/stack",
   "type": "module",
-  "version": "0.1.0-preview.142.1",
+  "version": "0.1.0-preview.21.1",
   "repository": "happier-dev/happier",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",

package/scripts/auth_login_guided_server_no_expo.test.mjs

@@ -119,6 +119,8 @@ test('guided auth login fails closed when Expo web UI is not ready (does not fal
       /guid(ed)? login web UI is still not ready|startup failed/i,
       `stderr:\n${res.stderr}`
     );
+    assert.match(res.stderr, /Stack runtime path:/i, `stderr:\n${res.stderr}`);
+    assert.match(res.stderr, /server health:/i, `stderr:\n${res.stderr}`);
     assert.doesNotMatch(res.stdout, new RegExp(`URL: http://localhost:${fixture.port}\\b`), `stdout:\n${res.stdout}`);
   } finally {
     if (fixture) await fixture.cleanup();

package/scripts/bundleWorkspaceDeps.test.mjs

@@ -2,10 +2,13 @@ import test from 'node:test';
 import assert from 'node:assert/strict';
 import { mkdtempSync, mkdirSync, writeFileSync, readFileSync, existsSync, rmSync } from 'node:fs';
 import { tmpdir } from 'node:os';
-import { join, resolve } from 'node:path';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
 
 import { bundleWorkspaceDeps } from './bundleWorkspaceDeps.mjs';
 
+const repoRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..', '..');
+
 function writeJson(path, value) {
   writeFileSync(path, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
 }
@@ -91,3 +94,25 @@ test('bundleWorkspaceDeps throws when cli-common package.json is malformed', ()
     rmSync(repoRoot, { recursive: true, force: true });
   }
 });
+
+test('declares external runtime dependencies required by bundled workspace packages', () => {
+  const stackPackageJson = JSON.parse(readFileSync(resolve(repoRoot, 'apps', 'stack', 'package.json'), 'utf8'));
+  const bundledWorkspacePackagePaths = [
+    resolve(repoRoot, 'packages', 'cli-common', 'package.json'),
+    resolve(repoRoot, 'packages', 'release-runtime', 'package.json'),
+  ];
+
+  const stackDependencyNames = new Set(Object.keys(stackPackageJson.dependencies ?? {}));
+  const requiredExternalDependencies = new Set();
+  for (const packageJsonPath of bundledWorkspacePackagePaths) {
+    const bundledPackageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+    for (const dependencyName of Object.keys(bundledPackageJson.dependencies ?? {})) {
+      if (!dependencyName.startsWith('@happier-dev/')) {
+        requiredExternalDependencies.add(dependencyName);
+      }
+    }
+  }
+
+  const missingDependencies = [...requiredExternalDependencies].filter((name) => !stackDependencyNames.has(name));
+  assert.deepEqual(missingDependencies, []);
+});

package/scripts/mobile.mjs

@@ -130,8 +130,8 @@ async function main() {
   const stackCtx = resolveStackContext({ env, autostart });
   const { stackMode, runtimeStatePath, stackName, envPath } = stackCtx;
 
-  // Expo/React Native native build steps can probe the Metro port even when we pass `--no-bundler`.
-  // Defaulting to 8081 makes builds much more likely to fail late if another Metro/Expo starts on the same port.
+  // Expo CLI resolves a Metro port early, but it won't actually bind it until late in the native build.
+  // If we stick to the default 8081, builds are much more likely to fail late if another Metro/Expo claims 8081 mid-build.
   //
   // Strategy:
   // - If the user explicitly sets --port or HAPPIER_STACK_MOBILE_PORT, honor it.
@@ -333,11 +333,8 @@ async function main() {
     }
 
     const configuration = kv.get('--configuration') ?? 'Debug';
-    const buildMetroPort = (env.RCT_METRO_PORT ?? env.EXPO_PACKAGER_PORT ?? '').toString().trim();
-    const args = ['run:ios', '--no-bundler', '--no-build-cache', '--configuration', configuration];
-    if (buildMetroPort) {
-      args.push('-p', buildMetroPort);
-    }
+    const metroPort = String(env.RCT_METRO_PORT ?? portRaw ?? '8081');
+    const args = ['run:ios', '--port', metroPort, '--no-build-cache', '--configuration', configuration];
     if (device) {
       args.push('-d', device);
     }

package/scripts/mobile_dev_client.mjs

@@ -3,11 +3,10 @@ import { parseArgs } from './utils/cli/args.mjs';
 import { printResult, wantsHelp, wantsJson } from './utils/cli/cli.mjs';
 import { run } from './utils/proc/proc.mjs';
 import { getRootDir } from './utils/paths/paths.mjs';
-import { join } from 'node:path';
 import { banner, cmd, sectionTitle } from './utils/ui/layout.mjs';
 import { cyan, dim, yellow } from './utils/ui/ansi.mjs';
 
-import { defaultDevClientIdentity } from './utils/mobile/identifiers.mjs';
+import { buildMobileDevClientInstallInvocation } from './utils/mobile/dev_client_install_invocation.mjs';
 
 async function main() {
   const argv = process.argv.slice(2);
@@ -18,13 +17,13 @@ async function main() {
     printResult({
       json,
       data: {
-        flags: ['--device=<id-or-name>', '--clean', '--configuration=Debug|Release', '--json'],
+        flags: ['--device=<id-or-name>', '--port=<port>', '--clean', '--configuration=Debug|Release', '--json'],
       },
       text: [
         banner('mobile-dev-client', { subtitle: 'Install the shared iOS dev-client app (one-time).' }),
         '',
         sectionTitle('usage:'),
-        `  ${cyan('hstack mobile-dev-client')} --install [--device=...] [--clean] [--configuration=Debug|Release] [--json]`,
+        `  ${cyan('hstack mobile-dev-client')} --install [--device=...] [--port=...] [--clean] [--configuration=Debug|Release] [--json]`,
         '',
         sectionTitle('notes:'),
         `- Installs a dedicated ${cyan('hstack Dev')} Expo dev-client app on your iPhone.`,
@@ -45,39 +44,15 @@ async function main() {
   }
 
   const rootDir = getRootDir(import.meta.url);
-  const mobileScript = join(rootDir, 'scripts', 'mobile.mjs');
-
-  const device = kv.get('--device') ?? '';
-  const clean = flags.has('--clean');
-  const configuration = kv.get('--configuration') ?? 'Debug';
-
-  const id = defaultDevClientIdentity({ user: process.env.USER ?? process.env.USERNAME ?? 'user' });
-
-  const args = [
-    mobileScript,
-    '--app-env=development',
-    `--ios-app-name=${id.iosAppName}`,
-    `--ios-bundle-id=${id.iosBundleId}`,
-    `--scheme=${id.scheme}`,
-    '--prebuild',
-    ...(clean ? ['--clean'] : []),
-    '--run-ios',
-    `--configuration=${configuration}`,
-    '--no-metro',
-    ...(device ? [`--device=${device}`] : []),
-  ];
+  const invocation = buildMobileDevClientInstallInvocation({ rootDir, argv, baseEnv: process.env });
 
   const env = {
-    ...process.env,
-    // Ensure Expo app config uses the dev-client scheme.
-    EXPO_APP_SCHEME: id.scheme,
-    // Ensure per-stack storage isolation is available during dev-client usage.
-    EXPO_PUBLIC_HAPPY_STORAGE_SCOPE: process.env.EXPO_PUBLIC_HAPPY_STORAGE_SCOPE ?? '',
+    ...invocation.env,
   };
 
-  const out = await run(process.execPath, args, { cwd: rootDir, env });
+  const out = await run(process.execPath, invocation.nodeArgs, { cwd: rootDir, env });
   if (json) {
-    printResult({ json, data: { ok: true, installed: true, identity: id, out } });
+    printResult({ json, data: { ok: true, installed: true, identity: invocation.identity, out } });
   }
 }
 

package/scripts/mobile_dev_client_help_smoke.test.mjs

@@ -0,0 +1,24 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { runNodeCapture } from './testkit/auth_testkit.mjs';
+
+test('mobile-dev-client --help runs without syntax errors', async () => {
+  const scriptsDir = dirname(fileURLToPath(import.meta.url));
+  const rootDir = dirname(scriptsDir);
+  const script = join(rootDir, 'scripts', 'mobile_dev_client.mjs');
+
+  const env = {
+    ...process.env,
+    // Prevent env.mjs from selecting a real stack env file (keeps the test fast and hermetic).
+    HAPPIER_STACK_ENV_FILE: join(rootDir, 'scripts', 'nonexistent-env'),
+  };
+
+  const res = await runNodeCapture([script, '--help'], { cwd: rootDir, env });
+  assert.equal(res.code, 0, `expected exit 0, got ${res.code}\nstderr:\n${res.stderr}\nstdout:\n${res.stdout}`);
+  assert.match(res.stdout, /\bmobile-dev-client\b/, `expected help to mention command name\nstdout:\n${res.stdout}`);
+  assert.match(res.stdout, /--port(?:=|\b)/, `expected help to mention --port\nstdout:\n${res.stdout}`);
+});
+

package/scripts/mobile_run_ios_passes_port.integration.test.mjs

@@ -18,7 +18,7 @@ function parseKeyValueLines(text) {
   return out;
 }
 
-test('hstack mobile --run-ios passes -p/--port to Expo (avoids default 8081)', async () => {
+test('hstack mobile --run-ios passes --port to Expo so the native build and dev server use the same Metro port', async () => {
   const rootDir = getStackRootFromMeta(import.meta.url);
   const mobileScript = join(rootDir, 'scripts', 'mobile.mjs');
 
@@ -72,7 +72,8 @@ process.exit(0);
     const env = {
       ...process.env,
       // Ensure xcrun runs fast/deterministically in tests.
-      PATH: binDir,
+      // Include system paths so env.mjs won't prepend /usr/bin ahead of our stub.
+      PATH: `${binDir}:/usr/bin:/bin`,
       HAPPIER_STACK_REPO_DIR: repoDir,
       HAPPIER_STACK_HOME_DIR: join(tmp, 'home'),
       HAPPIER_STACK_STORAGE_DIR: storageDir,
@@ -90,12 +91,13 @@ process.exit(0);
 
     assert.ok(port, `expected RCT_METRO_PORT to be set\nstdout:\n${res.stdout}\nstderr:\n${res.stderr}`);
     assert.equal(kv.EXPO_PACKAGER_PORT, port, `expected EXPO_PACKAGER_PORT to match\nstdout:\n${res.stdout}\nstderr:\n${res.stderr}`);
-    assert.ok(args.includes('-p') || args.includes('--port'), `expected expo args to include -p/--port\nstdout:\n${res.stdout}\nstderr:\n${res.stderr}`);
-    const pIdx = args.indexOf('-p') !== -1 ? args.indexOf('-p') : args.indexOf('--port');
-    assert.equal(args[pIdx + 1], port, `expected expo -p to match RCT_METRO_PORT\nstdout:\n${res.stdout}\nstderr:\n${res.stderr}`);
+    assert.ok(!args.includes('-p'), `expected expo args to not include -p\nstdout:\n${res.stdout}\nstderr:\n${res.stderr}`);
+    assert.ok(!args.includes('--no-bundler'), `expected expo args to not include --no-bundler\nstdout:\n${res.stdout}\nstderr:\n${res.stderr}`);
+    assert.ok(args.includes('--port'), `expected expo args to include --port\nstdout:\n${res.stdout}\nstderr:\n${res.stderr}`);
+    const portIdx = args.indexOf('--port');
+    assert.ok(portIdx >= 0 && args[portIdx + 1] === port, `expected --port to match RCT_METRO_PORT\nstdout:\n${res.stdout}\nstderr:\n${res.stderr}`);
     assert.notEqual(port, '8081', `expected non-default port to reduce collisions\nstdout:\n${res.stdout}\nstderr:\n${res.stderr}`);
   } finally {
     await rm(tmp, { recursive: true, force: true });
   }
 });
-

package/scripts/mobile_run_ios_uses_long_port_flag.test.mjs

@@ -0,0 +1,106 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { chmod, mkdtemp, mkdir, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+
+import { getStackRootFromMeta, runNodeCapture } from './testkit/auth_testkit.mjs';
+
+function parseKeyValueLines(text) {
+  const out = {};
+  for (const line of String(text ?? '').split(/\r?\n/)) {
+    const idx = line.indexOf('=');
+    if (idx === -1) continue;
+    const key = line.slice(0, idx).trim();
+    const value = line.slice(idx + 1).trim();
+    if (key) out[key] = value;
+  }
+  return out;
+}
+
+test('hstack mobile --run-ios passes --port (long flag) so Expo uses the requested Metro port', async () => {
+  const rootDir = getStackRootFromMeta(import.meta.url);
+  const mobileScript = join(rootDir, 'scripts', 'mobile.mjs');
+
+  const tmp = await mkdtemp(join(tmpdir(), 'hstack-mobile-runios-longport-'));
+  const repoDir = join(tmp, 'repo');
+  const storageDir = join(tmp, 'storage');
+
+  try {
+    const binDir = join(tmp, 'bin');
+    await mkdir(binDir, { recursive: true });
+    const xcrunStub = join(binDir, 'xcrun');
+    await writeFile(
+      xcrunStub,
+      `#!/bin/bash
+set -euo pipefail
+if [[ "\${1:-}" == "xcdevice" && "\${2:-}" == "list" ]]; then
+  echo "[]"
+  exit 0
+fi
+echo "xcrun stub: unsupported args: $*" >&2
+exit 1
+`,
+      'utf-8'
+    );
+    if (process.platform !== 'win32') {
+      await chmod(xcrunStub, 0o755);
+    }
+
+    const uiDir = join(repoDir, 'apps', 'ui');
+    const expoBin = join(uiDir, 'node_modules', '.bin', 'expo');
+    await mkdir(join(uiDir, 'node_modules', '.bin'), { recursive: true });
+
+    await writeFile(
+      expoBin,
+      `#!${process.execPath}
+console.log('ARGS=' + JSON.stringify(process.argv.slice(2)));
+console.log('RCT_METRO_PORT=' + (process.env.RCT_METRO_PORT ?? ''));
+console.log('EXPO_PACKAGER_PORT=' + (process.env.EXPO_PACKAGER_PORT ?? ''));
+process.exit(0);
+`,
+      'utf-8'
+    );
+    if (process.platform !== 'win32') {
+      await chmod(expoBin, 0o755);
+    }
+
+    await mkdir(join(storageDir, 'main'), { recursive: true });
+
+    const env = {
+      ...process.env,
+      // Ensure our xcrun stub wins over /usr/bin/xcrun even after env.mjs normalizes PATH.
+      PATH: `${binDir}:/usr/bin:/bin`,
+      HAPPIER_STACK_REPO_DIR: repoDir,
+      HAPPIER_STACK_HOME_DIR: join(tmp, 'home'),
+      HAPPIER_STACK_STORAGE_DIR: storageDir,
+      HAPPIER_STACK_STACK: 'main',
+      HAPPIER_STACK_TAILSCALE_PREFER_PUBLIC_URL: '0',
+      HAPPIER_STACK_TAILSCALE_SERVE: '0',
+      HAPPIER_STACK_ENV_FILE: join(tmp, 'nonexistent-env'),
+    };
+
+    const res = await runNodeCapture([mobileScript, '--run-ios', '--no-metro', '--port=14362'], { cwd: rootDir, env });
+    assert.equal(res.code, 0, `expected exit 0, got ${res.code}\nstderr:\n${res.stderr}\nstdout:\n${res.stdout}`);
+    const kv = parseKeyValueLines(res.stdout);
+    const args = JSON.parse(kv.ARGS ?? '[]');
+
+    assert.ok(!args.includes('--no-bundler'), `expected expo args to not include --no-bundler\nstdout:\n${res.stdout}\nstderr:\n${res.stderr}`);
+    assert.ok(args.includes('--port'), `expected expo args to include --port\nstdout:\n${res.stdout}\nstderr:\n${res.stderr}`);
+    assert.ok(!args.includes('-p'), `expected expo args to not include -p\nstdout:\n${res.stdout}\nstderr:\n${res.stderr}`);
+    const portIdx = args.indexOf('--port');
+    assert.ok(portIdx >= 0 && args[portIdx + 1] === '14362', `expected --port 14362\nstdout:\n${res.stdout}\nstderr:\n${res.stderr}`);
+    assert.equal(
+      kv.RCT_METRO_PORT,
+      '14362',
+      `expected RCT_METRO_PORT to be set from hstack --port\nstdout:\n${res.stdout}\nstderr:\n${res.stderr}`
+    );
+    assert.equal(
+      kv.EXPO_PACKAGER_PORT,
+      '14362',
+      `expected EXPO_PACKAGER_PORT to match\nstdout:\n${res.stdout}\nstderr:\n${res.stderr}`
+    );
+  } finally {
+    await rm(tmp, { recursive: true, force: true });
+  }
+});

package/scripts/remote_cmd.mjs

@@ -84,10 +84,16 @@ function usageText() {
     '    [--server-url=<url>] [--webapp-url=<url>] [--public-server-url=<url>]',
     '    [--json]',
     '',
+    '  hstack remote server setup --ssh <user@host> [--preview|--stable] [--channel <stable|preview>]',
+    '    [--mode <user|system>]',
+    '    [--env KEY=VALUE]...',
+    '    [--json]',
+    '',
     'notes:',
     '  - This command runs remote operations over ssh.',
     '  - It installs the Happier CLI on the remote host, pairs credentials, and optionally installs/starts the daemon service.',
     '  - Default service mode is user; set --service none to skip daemon service setup.',
+    '  - Remote server setup installs the self-host runtime as a service (default: user mode).',
   ].join('\n');
 }
 
@@ -117,6 +123,43 @@ function resolveService(argv) {
   return v || 'user';
 }
 
+function resolveMode(argv) {
+  if (argv.includes('--system')) return 'system';
+  if (argv.includes('--user')) return 'user';
+  const picked = argv.find((a) => a === '--mode' || a.startsWith('--mode='));
+  if (!picked) return 'user';
+  if (picked === '--mode') {
+    const idx = argv.indexOf('--mode');
+    const v = String(argv[idx + 1] ?? '').trim().toLowerCase();
+    return v || 'user';
+  }
+  const v = String(picked.slice('--mode='.length)).trim().toLowerCase();
+  return v || 'user';
+}
+
+function collectEnvValues(argv) {
+  const args = Array.isArray(argv) ? argv.map(String) : [];
+  const values = [];
+  for (let i = 0; i < args.length; i += 1) {
+    const a = args[i] ?? '';
+    if (a === '--env') {
+      const next = args[i + 1] ?? '';
+      if (!next || next.startsWith('--')) {
+        throw new Error('[remote] missing value for --env (expected KEY=VALUE)');
+      }
+      values.push(String(next));
+      i += 1;
+      continue;
+    }
+    if (a.startsWith('--env=')) {
+      const raw = a.slice('--env='.length);
+      if (!raw) throw new Error('[remote] missing value for --env (expected KEY=VALUE)');
+      values.push(String(raw));
+    }
+  }
+  return values;
+}
+
 async function runRemoteDaemonSetup(argvRaw) {
   const argv0 = argvRaw.slice();
   const json = wantsJson(argv0);
@@ -209,6 +252,71 @@ async function runRemoteDaemonSetup(argvRaw) {
   });
 }
 
+async function runRemoteServerSetup(argvRaw) {
+  const argv0 = argvRaw.slice();
+  const json = wantsJson(argv0);
+
+  let args = argv0.slice();
+  const ssh = takeFlagValue(args, '--ssh');
+  args = ssh.rest;
+  if (!ssh.value) {
+    process.stderr.write('Missing required flag: --ssh <user@host>\n');
+    process.exit(2);
+  }
+
+  const channel = resolveChannel(argv0);
+  if (channel !== 'stable' && channel !== 'preview') {
+    throw new Error(`[remote] invalid --channel value: ${channel}`);
+  }
+
+  const mode = resolveMode(argv0);
+  if (mode !== 'user' && mode !== 'system') {
+    throw new Error(`[remote] invalid --mode value: ${mode} (expected user or system)`);
+  }
+
+  const envValues = collectEnvValues(argv0);
+
+  const installUrl = 'https://happier.dev/install';
+  const remoteHstack = '$HOME/.happier/bin/hstack';
+
+  // Always disable auto-service setup in the installer so this command controls remote service behavior.
+  const installCmd = [
+    `curl -fsSL ${installUrl} |`,
+    `HAPPIER_CHANNEL=${channel} HAPPIER_WITH_DAEMON=0 HAPPIER_NONINTERACTIVE=1 bash`,
+  ].join(' ');
+
+  await runSsh({ target: ssh.value, command: installCmd });
+
+  const envArgs = envValues.map((value) => `--env ${safeBashSingleQuote(value)}`).join(' ');
+  const baseSelfHostCmd = [
+    remoteHstack,
+    'self-host',
+    'install',
+    `--channel=${channel}`,
+    `--mode=${mode}`,
+    '--without-cli',
+    '--non-interactive',
+    '--json',
+  ].join(' ');
+  const selfHostCmd = `${mode === 'system' ? 'sudo -E ' : ''}${baseSelfHostCmd}${envArgs ? ` ${envArgs}` : ''}`;
+
+  await runSsh({ target: ssh.value, command: selfHostCmd });
+
+  printResult({
+    json,
+    data: { ok: true, ssh: ssh.value, channel, mode, env: envValues },
+    text: json
+      ? null
+      : [
+          '✓ Remote server setup complete',
+          `- ssh: ${ssh.value}`,
+          `- channel: ${channel}`,
+          `- mode: ${mode}`,
+          `- env: ${envValues.length ? envValues.join(', ') : '(none)'}`,
+        ].join('\n'),
+  });
+}
+
 async function main() {
   const argvRaw = process.argv.slice(2);
   if (argvRaw.length === 0 || wantsHelp(argvRaw)) {
@@ -224,6 +332,10 @@ async function main() {
     await runRemoteDaemonSetup(argvRaw);
     return;
   }
+  if (top === 'server' && sub === 'setup') {
+    await runRemoteServerSetup(argvRaw);
+    return;
+  }
 
   printResult({
     json: wantsJson(argvRaw),