happy-stacks 0.4.0 → 0.5.0

package/scripts/review_pr.mjs

@@ -15,35 +15,20 @@ import { randomToken } from './utils/crypto/tokens.mjs';
 import { inferPrStackBaseName } from './utils/stack/pr_stack_name.mjs';
 import { sanitizeStackName } from './utils/stack/names.mjs';
 import { listReviewPrSandboxes, reviewPrSandboxPrefixPath, writeReviewPrSandboxMeta } from './utils/sandbox/review_pr_sandbox.mjs';
+import { bold, cyan, dim } from './utils/ui/ansi.mjs';
  
-function supportsAnsi() {
-  if (!process.stdout.isTTY) return false;
-  if (process.env.NO_COLOR) return false;
-  if ((process.env.TERM ?? '').toLowerCase() === 'dumb') return false;
-  return true;
-}
-
-function bold(s) {
-  return supportsAnsi() ? `\x1b[1m${s}\x1b[0m` : String(s);
-}
-
-function dim(s) {
-  return supportsAnsi() ? `\x1b[2m${s}\x1b[0m` : String(s);
-}
-
-function cyan(s) {
-  return supportsAnsi() ? `\x1b[36m${s}\x1b[0m` : String(s);
-}
-
 function usage() {
   return [
     '[review-pr] usage:',
-    '  happys review-pr --happy=<pr-url|number> [--happy-cli=<pr-url|number>] [--happy-server=<pr-url|number>|--happy-server-light=<pr-url|number>] [--name=<stack>] [--dev|--start] [--mobile|--no-mobile] [--forks|--upstream] [--seed-auth|--no-seed-auth] [--copy-auth-from=<stack>] [--link-auth|--copy-auth] [--update] [--force] [--keep-sandbox] [--json] [-- <stack dev/start args...>]',
+    '  happys review-pr --happy=<pr-url|number> [--happy-server-light=<pr-url|number>] [--name=<stack>] [--dev|--start] [--mobile|--no-mobile] [--forks|--upstream] [--seed-auth|--no-seed-auth] [--copy-auth-from=<stack>] [--link-auth|--copy-auth] [--update] [--force] [--keep-sandbox] [--json] [-- <stack dev/start args...>]',
     '',
     'What it does:',
     '- creates a temporary sandbox dir',
     '- runs `happys setup-pr ...` inside that sandbox (fully isolated state)',
     '- on exit (including Ctrl+C): stops sandbox processes and deletes the sandbox dir',
+    '',
+    'legacy note:',
+    '- `--happy-cli` / `--happy-server` are legacy split-repo flags; in monorepo mode, use `--happy` only.',
   ].join('\n');
 }
  

package/scripts/run.mjs

@@ -13,6 +13,7 @@ import { maybeResetTailscaleServe } from './tailscale.mjs';
 import { isDaemonRunning, startLocalDaemonWithAuth, stopLocalDaemon } from './daemon.mjs';
 import { printResult, wantsHelp, wantsJson } from './utils/cli/cli.mjs';
 import { assertServerComponentDirMatches, assertServerPrismaProviderMatches } from './utils/server/validate.mjs';
+import { resolveServerStartScript } from './utils/server/flavor_scripts.mjs';
 import { applyHappyServerMigrations, ensureHappyServerManagedInfra } from './utils/server/infra/happy_server_infra.mjs';
 import { getAccountCountForServerComponent, prepareDaemonAuthSeedIfNeeded, resolveAutoCopyFromMainEnabled } from './utils/stack/startup.mjs';
 import { recordStackRuntimeStart, recordStackRuntimeUpdate } from './utils/stack/runtime_state.mjs';
@@ -20,16 +21,17 @@ import { resolveStackContext } from './utils/stack/context.mjs';
 import { getPublicServerUrlEnvOverride, resolveServerPortFromEnv, resolveServerUrls } from './utils/server/urls.mjs';
 import { preferStackLocalhostUrl } from './utils/paths/localhost_host.mjs';
 import { openUrlInBrowser } from './utils/ui/browser.mjs';
-import { ensureDevExpoServer } from './utils/dev/expo_dev.mjs';
+import { ensureDevExpoServer, resolveExpoTailscaleEnabled } from './utils/dev/expo_dev.mjs';
 import { maybeRunInteractiveStackAuthSetup } from './utils/auth/interactive_stack_auth.mjs';
 import { getInvokedCwd, inferComponentFromCwd } from './utils/cli/cwd_scope.mjs';
 import { daemonStartGate, formatDaemonAuthRequiredError } from './utils/auth/daemon_gate.mjs';
+import { resolveServerUiEnv } from './utils/server/ui_env.mjs';
 
 /**
  * Run the local stack in "production-like" mode:
- * - happy-server-light
+ * - server (happy-server-light by default)
  * - happy-cli daemon
- * - serve prebuilt UI via happy-server-light (/)
+ * - optionally serve prebuilt UI (via server or gateway)
  *
  * Optional: Expo dev-client Metro for mobile reviewers (`--mobile`).
  */
@@ -41,10 +43,12 @@ async function main() {
   if (wantsHelp(argv, { flags })) {
     printResult({
       json,
-      data: { flags: ['--server=happy-server|happy-server-light', '--no-ui', '--no-daemon', '--restart', '--no-browser', '--mobile'], json: true },
+      data: { flags: ['--server=happy-server|happy-server-light', '--no-ui', '--no-daemon', '--restart', '--no-browser', '--mobile', '--expo-tailscale'], json: true },
       text: [
         '[start] usage:',
         '  happys start [--server=happy-server|happy-server-light] [--restart] [--json]',
+        '  happys start --mobile        # also start Expo dev-client Metro for mobile',
+        '  happys start --expo-tailscale # forward Expo to Tailscale interface for remote access',
         '  (legacy in a cloned repo): pnpm start [-- --server=happy-server|happy-server-light] [--json]',
         '  note: --json prints the resolved config (dry-run) and exits.',
         '',
@@ -89,6 +93,7 @@ async function main() {
   const serveUiWanted = !flags.has('--no-ui') && (process.env.HAPPY_LOCAL_SERVE_UI ?? '1') !== '0';
   const serveUi = serveUiWanted;
   const startMobile = flags.has('--mobile') || flags.has('--with-mobile');
+  const expoTailscale = flags.has('--expo-tailscale') || resolveExpoTailscaleEnabled({ env: process.env });
   const noBrowser = flags.has('--no-browser') || (process.env.HAPPY_STACKS_NO_BROWSER ?? process.env.HAPPY_LOCAL_NO_BROWSER ?? '').toString().trim() === '1';
   const uiPrefix = process.env.HAPPY_LOCAL_UI_PREFIX?.trim() ? process.env.HAPPY_LOCAL_UI_PREFIX.trim() : '/';
   const autostart = getDefaultAutostartPaths();
@@ -101,6 +106,7 @@ async function main() {
   const serverDir = getComponentDir(rootDir, serverComponentName);
   const cliDir = getComponentDir(rootDir, 'happy-cli');
   const uiDir = getComponentDir(rootDir, 'happy');
+  const serverStartScript = resolveServerStartScript({ serverComponentName, serverDir });
 
   assertServerComponentDirMatches({ rootDir, serverComponentName, serverDir });
   assertServerPrismaProviderMatches({ serverComponentName, serverDir });
@@ -141,12 +147,13 @@ async function main() {
     return;
   }
 
-  if (serveUi && !(await pathExists(uiBuildDir))) {
+  const uiBuildDirExists = await pathExists(uiBuildDir);
+  if (serveUi && !uiBuildDirExists) {
     if (serverComponentName === 'happy-server-light') {
       throw new Error(`[local] UI build directory not found at ${uiBuildDir}. Run: happys build (legacy in a cloned repo: pnpm build)`);
     }
-    // For happy-server, UI serving is optional via the UI gateway.
-    console.log(`[local] UI build directory not found at ${uiBuildDir}; UI gateway will be disabled`);
+    // For happy-server, UI serving is optional.
+    console.log(`[local] UI build directory not found at ${uiBuildDir}; UI serving will be disabled`);
   }
 
   const children = [];
@@ -215,12 +222,7 @@ async function main() {
     // Avoid noisy failures if a previous run left the metrics port busy.
     // You can override with METRICS_ENABLED=true if you want it.
     METRICS_ENABLED: baseEnv.METRICS_ENABLED ?? 'false',
-    ...(serveUi && serverComponentName === 'happy-server-light'
-      ? {
-          HAPPY_SERVER_LIGHT_UI_DIR: uiBuildDir,
-          HAPPY_SERVER_LIGHT_UI_PREFIX: uiPrefix,
-        }
-      : {}),
+    ...resolveServerUiEnv({ serveUi, uiBuildDir, uiPrefix, uiBuildDirExists }),
   };
   let serverLightAccountCount = null;
   let happyServerAccountCount = null;
@@ -319,7 +321,7 @@ async function main() {
   // Default server start (happy-server-light, or happy-server without managed infra).
   if (!(serverComponentName === 'happy-server' && (baseEnv.HAPPY_STACKS_MANAGED_INFRA ?? baseEnv.HAPPY_LOCAL_MANAGED_INFRA ?? '1') !== '0')) {
     if (!serverAlreadyRunning || restart) {
-      const server = await pmSpawnScript({ label: 'server', dir: serverDir, script: 'start', env: serverEnv });
+      const server = await pmSpawnScript({ label: 'server', dir: serverDir, script: serverStartScript, env: serverEnv });
       children.push(server);
       if (stackMode && runtimeStatePath) {
         await recordStackRuntimeUpdate(runtimeStatePath, { processes: { serverPid: server.pid } }).catch(() => {});
@@ -433,7 +435,7 @@ async function main() {
 
   // Optional: start Expo dev-client Metro for mobile reviewers.
   if (startMobile) {
-    await ensureDevExpoServer({
+    const expoRes = await ensureDevExpoServer({
       startUi: false,
       startMobile: true,
       uiDir,
@@ -446,7 +448,11 @@ async function main() {
       stackName,
       envPath,
       children,
+      expoTailscale,
     });
+    if (expoRes?.tailscale?.ok && expoRes.tailscale.tailscaleIp && expoRes.port) {
+      console.log(`[local] expo tailscale: http://${expoRes.tailscale.tailscaleIp}:${expoRes.port}`);
+    }
   }
 
   const shutdown = async () => {

package/scripts/setup.mjs

@@ -4,8 +4,8 @@ import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { parseArgs } from './utils/cli/args.mjs';
 import { printResult, wantsHelp, wantsJson } from './utils/cli/cli.mjs';
-import { getRootDir, resolveStackEnvPath } from './utils/paths/paths.mjs';
-import { isTty, promptSelect, withRl } from './utils/cli/wizard.mjs';
+import { getHappyStacksHomeDir, getRootDir, resolveStackEnvPath } from './utils/paths/paths.mjs';
+import { isTty, prompt, promptSelect, withRl } from './utils/cli/wizard.mjs';
 import { getCanonicalHomeDir } from './utils/env/config.mjs';
 import { ensureEnvLocalUpdated } from './utils/env/env_local.mjs';
 import { run, runCapture } from './utils/proc/proc.mjs';
@@ -24,6 +24,24 @@ import { commandExists } from './utils/proc/commands.mjs';
 import { readEnvValueFromFile } from './utils/env/read.mjs';
 import { readServerPortFromEnvFile, resolveServerPortFromEnv } from './utils/server/port.mjs';
 import { guidedStackWebSignupThenLogin } from './utils/auth/guided_stack_web_login.mjs';
+import { getVerbosityLevel } from './utils/cli/verbosity.mjs';
+import { runCommandLogged } from './utils/cli/progress.mjs';
+import { bold, cyan, dim, green } from './utils/ui/ansi.mjs';
+import { expandHome } from './utils/paths/canonical_home.mjs';
+
+function resolveWorkspaceDirDefault() {
+  const explicit = (process.env.HAPPY_STACKS_WORKSPACE_DIR ?? process.env.HAPPY_LOCAL_WORKSPACE_DIR ?? '').toString().trim();
+  if (explicit) return expandHome(explicit);
+  return join(getHappyStacksHomeDir(process.env), 'workspace');
+}
+
+function normalizeWorkspaceDirInput(raw, { homeDir }) {
+  const trimmed = String(raw ?? '').trim();
+  const expanded = expandHome(trimmed);
+  if (!expanded) return '';
+  // If relative, treat it as relative to the home dir (same rule as init.mjs).
+  return expanded.startsWith('/') ? expanded : join(homeDir, expanded);
+}
 
 async function resolveMainWebappUrlForAuth({ rootDir, port }) {
   try {
@@ -272,6 +290,7 @@ async function cmdSetup({ rootDir, argv }) {
         flags: [
           '--profile=selfhost|dev',
           '--server=happy-server-light|happy-server',
+          '--workspace-dir=/absolute/path   # dev profile only',
           '--install-path',
           '--start-now',
           '--auth|--no-auth',
@@ -286,7 +305,8 @@ async function cmdSetup({ rootDir, argv }) {
         '  happys setup',
         '  happys setup --profile=selfhost',
         '  happys setup --profile=dev',
-        '  happys setup pr --happy=<pr-url|number> [--happy-cli=<pr-url|number>]',
+        '  happys setup --profile=dev --workspace-dir=~/Development/happy',
+        '  happys setup pr --happy=<pr-url|number> [--happy-server-light=<pr-url|number>]',
         '  happys setup --auth',
         '  happys setup --no-auth',
         '',
@@ -304,10 +324,10 @@ async function cmdSetup({ rootDir, argv }) {
   if (!profile && interactive) {
     profile = await withRl(async (rl) => {
       return await promptSelect(rl, {
-        title: 'What is your goal?',
+        title: bold(`✨ ${cyan('Happy Stacks')} setup ✨\n\nWhat is your goal?`),
         options: [
-          { label: 'Use Happy on this machine (self-host)', value: 'selfhost' },
-          { label: 'Develop Happy (worktrees/stacks)', value: 'dev' },
+          { label: `${cyan('Self-host')}: use Happy on this machine`, value: 'selfhost' },
+          { label: `${cyan('Development')}: worktrees + stacks + contributor workflows`, value: 'dev' },
         ],
         defaultIndex: 0,
       });
@@ -317,6 +337,71 @@ async function cmdSetup({ rootDir, argv }) {
     profile = 'selfhost';
   }
 
+  const verbosity = getVerbosityLevel(process.env);
+  const quietUi = interactive && verbosity === 0 && !json;
+
+  async function runNodeScriptMaybeQuiet({ label, rel, args = [], env = process.env }) {
+    if (!quietUi) {
+      await run(process.execPath, [join(rootDir, rel), ...args], { cwd: rootDir, env });
+      return;
+    }
+    const baseLogDir = join(getHappyStacksHomeDir(process.env), 'logs', 'setup');
+    const logPath = join(baseLogDir, `${label.replace(/[^a-z0-9]+/gi, '-').toLowerCase()}.${Date.now()}.log`);
+    try {
+      await runCommandLogged({
+        label,
+        cmd: process.execPath,
+        args: [join(rootDir, rel), ...args],
+        cwd: rootDir,
+        env,
+        logPath,
+        quiet: true,
+        showSteps: true,
+      });
+    } catch (e) {
+      const lp = e?.logPath ? String(e.logPath) : logPath;
+      // eslint-disable-next-line no-console
+      console.error(`[setup] failed: ${label}`);
+      // eslint-disable-next-line no-console
+      console.error(`${dim('log:')} ${lp}`);
+      throw e;
+    }
+  }
+
+  function printProfileIntro({ profile }) {
+    if (!process.stdout.isTTY || json) return;
+    const header = profile === 'selfhost' ? `${cyan('Self-host')} setup` : `${cyan('Development')} setup`;
+    const lines = [
+      '',
+      bold(header),
+      profile === 'selfhost'
+        ? dim('Run Happy locally (optionally with Tailscale + autostart).')
+        : dim('Prepare a contributor workspace (components + worktrees + stacks).'),
+      '',
+      bold('What will happen:'),
+      profile === 'selfhost'
+        ? [
+            `- ${cyan('init')}: set up Happy Stacks home + shims`,
+            `- ${cyan('bootstrap')}: clone/install components`,
+            `- ${cyan('start')}: (optional) start Happy now`,
+            `- ${cyan('login')}: (optional) authenticate`,
+          ]
+        : [
+            `- ${cyan('workspace')}: choose where components + worktrees live`,
+            `- ${cyan('init')}: set up Happy Stacks home + shims`,
+            `- ${cyan('bootstrap')}: clone/install components + dev tooling`,
+            `- ${cyan('stacks')}: (optional) create an isolated dev stack`,
+          ],
+      '',
+    ].flat();
+    // eslint-disable-next-line no-console
+    console.log(lines.join('\n'));
+  }
+
+  if (interactive) {
+    printProfileIntro({ profile });
+  }
+
   const platform = process.platform;
   const supportsAutostart = platform === 'darwin' || platform === 'linux';
   const supportsMenubar = platform === 'darwin';
@@ -326,7 +411,7 @@ async function cmdSetup({ rootDir, argv }) {
   if (profile === 'selfhost' && interactive && !serverFromArg) {
     serverComponent = await withRl(async (rl) => {
       const picked = await promptSelect(rl, {
-        title: 'Select server flavor:',
+        title: bold('Server flavor'),
         options: [
           { label: 'happy-server-light (recommended; simplest local install)', value: 'happy-server-light' },
           { label: 'happy-server (full server; managed infra via Docker)', value: 'happy-server' },
@@ -337,6 +422,34 @@ async function cmdSetup({ rootDir, argv }) {
     });
   }
 
+  // Dev profile: pick where to store components + worktrees.
+  const workspaceDirFlagRaw = (kv.get('--workspace-dir') ?? '').toString().trim();
+  const homeDirForWorkspace = getHappyStacksHomeDir(process.env);
+  let workspaceDirWanted = workspaceDirFlagRaw ? normalizeWorkspaceDirInput(workspaceDirFlagRaw, { homeDir: homeDirForWorkspace }) : '';
+  if (profile === 'dev' && interactive && !workspaceDirWanted) {
+    const defaultWorkspaceDir = resolveWorkspaceDirDefault();
+    const suggested = defaultWorkspaceDir;
+    const helpLines = [
+      bold('Workspace location'),
+      dim('This is where Happy Stacks will keep:'),
+      `- ${dim('components')}: ${cyan(join(suggested, 'components'))}`,
+      `- ${dim('worktrees')}:  ${cyan(join(suggested, 'components', '.worktrees'))}`,
+      '',
+      dim('Pick a stable folder that is easy to open in your editor (example: ~/Development/happy).'),
+      '',
+    ].join('\n');
+    // eslint-disable-next-line no-console
+    console.log(helpLines);
+    const raw = await withRl(async (rl) => {
+      return await prompt(rl, `Workspace dir (default: ${suggested}): `, { defaultValue: suggested });
+    });
+    workspaceDirWanted = normalizeWorkspaceDirInput(raw, { homeDir: homeDirForWorkspace });
+  }
+  if (profile === 'dev' && workspaceDirWanted) {
+    // eslint-disable-next-line no-console
+    console.log(`${dim('Workspace:')} ${cyan(workspaceDirWanted)}`);
+  }
+
   const defaultTailscale = false;
   const defaultAutostart = false;
   const defaultMenubar = false;
@@ -361,7 +474,7 @@ async function cmdSetup({ rootDir, argv }) {
     if (profile === 'selfhost') {
       tailscaleWanted = await withRl(async (rl) => {
         const v = await promptSelect(rl, {
-          title: 'Enable remote access with Tailscale Serve (recommended for mobile)?',
+          title: bold('Remote access'),
           options: [
             { label: 'no (default)', value: false },
             { label: 'yes', value: true },
@@ -374,7 +487,7 @@ async function cmdSetup({ rootDir, argv }) {
       if (supportsAutostart) {
         autostartWanted = await withRl(async (rl) => {
           const v = await promptSelect(rl, {
-            title: 'Enable autostart at login?',
+            title: bold('Autostart'),
             options: [
               { label: 'no (default)', value: false },
               { label: 'yes', value: true },
@@ -390,7 +503,7 @@ async function cmdSetup({ rootDir, argv }) {
       if (supportsMenubar) {
         menubarWanted = await withRl(async (rl) => {
           const v = await promptSelect(rl, {
-            title: 'Install the macOS menubar (SwiftBar) control panel?',
+            title: bold('Menu bar (macOS)'),
             options: [
               { label: 'no (default)', value: false },
               { label: 'yes', value: true },
@@ -405,7 +518,7 @@ async function cmdSetup({ rootDir, argv }) {
 
       startNow = await withRl(async (rl) => {
         const v = await promptSelect(rl, {
-          title: 'Start Happy now?',
+          title: bold('Start now'),
           options: [
             { label: 'yes (default)', value: true },
             { label: 'no', value: false },
@@ -417,7 +530,7 @@ async function cmdSetup({ rootDir, argv }) {
 
       authWanted = await withRl(async (rl) => {
         const v = await promptSelect(rl, {
-          title: 'Authenticate now? (recommended)',
+          title: bold('Authentication'),
           options: [
             { label: 'yes (default) — enables Happy UI + mobile access', value: true },
             { label: 'no — I will authenticate later', value: false },
@@ -436,7 +549,7 @@ async function cmdSetup({ rootDir, argv }) {
       // If you choose to auth now, we’ll also start Happy in the background so login can complete.
       const authNow = await withRl(async (rl) => {
         const v = await promptSelect(rl, {
-          title: 'Complete authentication now? (optional)',
+          title: bold('Authentication (optional)'),
           options: [
             { label: 'no (default) — I will do this later', value: false },
             { label: 'yes — start Happy in background and login', value: true },
@@ -453,10 +566,10 @@ async function cmdSetup({ rootDir, argv }) {
 
     installPath = await withRl(async (rl) => {
       const v = await promptSelect(rl, {
-        title: `Add ${join(getCanonicalHomeDir(), 'bin')} to your shell PATH?`,
+        title: bold('Shell PATH'),
         options: [
-          { label: 'no (default)', value: false },
-          { label: 'yes', value: true },
+          { label: `no (default) — you can run via npx / full path`, value: false },
+          { label: `yes — add ${join(getCanonicalHomeDir(), 'bin')} to your PATH`, value: true },
         ],
         defaultIndex: installPath ? 1 : 0,
       });
@@ -489,11 +602,12 @@ async function cmdSetup({ rootDir, argv }) {
   }
 
   // 1) Ensure plumbing exists (runtime + shims + pointer env). Avoid auto-bootstrap here; setup drives bootstrap explicitly.
-  await runNodeScript({
-    rootDir,
+  await runNodeScriptMaybeQuiet({
+    label: 'init happy-stacks home',
     rel: 'scripts/init.mjs',
     args: [
       '--no-bootstrap',
+      ...(profile === 'dev' && workspaceDirWanted ? [`--workspace-dir=${workspaceDirWanted}`] : []),
       ...(installPath ? ['--install-path'] : []),
     ],
     env: { ...process.env, HAPPY_STACKS_SETUP_CHILD: '1' },
@@ -511,13 +625,13 @@ async function cmdSetup({ rootDir, argv }) {
   // 3) Bootstrap components. Selfhost defaults to upstream; dev defaults to existing bootstrap wizard (forks by default).
   if (profile === 'dev') {
     // Developer setup: keep the existing bootstrap wizard.
-    await runNodeScript({ rootDir, rel: 'scripts/install.mjs', args: ['--interactive'] });
+    await runNodeScriptMaybeQuiet({ label: 'bootstrap components', rootDir, rel: 'scripts/install.mjs', args: ['--interactive'] });
 
     // Optional: offer to create a dedicated dev stack (keeps main stable).
     if (interactive) {
       const createStack = await withRl(async (rl) => {
         return await promptSelect(rl, {
-          title: 'Create an additional isolated stack for development?',
+          title: bold('Stacks'),
           options: [
             { label: 'no (default)', value: false },
             { label: 'yes', value: true },
@@ -526,7 +640,7 @@ async function cmdSetup({ rootDir, argv }) {
         });
       });
       if (createStack) {
-        await runNodeScript({ rootDir, rel: 'scripts/stack.mjs', args: ['new', '--interactive'] });
+        await runNodeScriptMaybeQuiet({ label: 'create dev stack', rootDir, rel: 'scripts/stack.mjs', args: ['new', '--interactive'] });
       }
 
       // Guided maintainer-friendly auth defaults (dev key → main → legacy).
@@ -535,7 +649,8 @@ async function cmdSetup({ rootDir, argv }) {
   } else {
     // Selfhost setup: run non-interactively and keep it simple.
     const repoFlag = serverComponent === 'happy-server-light' ? '--forks' : '--upstream';
-    await runNodeScript({
+    await runNodeScriptMaybeQuiet({
+      label: 'bootstrap components',
       rootDir,
       rel: 'scripts/install.mjs',
       args: [`--server=${serverComponent}`, repoFlag],
@@ -661,7 +776,11 @@ async function cmdSetup({ rootDir, argv }) {
   // Final tips (keep short).
   if (profile === 'selfhost') {
     // eslint-disable-next-line no-console
-    console.log('[setup] done. Useful commands:');
+    console.log('');
+    // eslint-disable-next-line no-console
+    console.log(green('✓ Setup complete'));
+    // eslint-disable-next-line no-console
+    console.log(dim('Useful commands:'));
     // eslint-disable-next-line no-console
     console.log('  happys start');
     // eslint-disable-next-line no-console
@@ -670,7 +789,11 @@ async function cmdSetup({ rootDir, argv }) {
     console.log('  happys service install   # macOS/Linux autostart');
   } else {
     // eslint-disable-next-line no-console
-    console.log('[setup] done. Useful commands:');
+    console.log('');
+    // eslint-disable-next-line no-console
+    console.log(green('✓ Setup complete'));
+    // eslint-disable-next-line no-console
+    console.log(dim('Useful commands:'));
     // eslint-disable-next-line no-console
     console.log('  happys dev');
     // eslint-disable-next-line no-console
@@ -690,4 +813,3 @@ main().catch((err) => {
   console.error('[setup] failed:', err);
   process.exit(1);
 });
-

package/scripts/setup_pr.mjs

@@ -22,29 +22,8 @@ import { homedir } from 'node:os';
 import { resolveMobileQrPayload } from './utils/mobile/dev_client_links.mjs';
 import { renderQrAscii } from './utils/ui/qr.mjs';
 import { inferPrStackBaseName } from './utils/stack/pr_stack_name.mjs';
-
-function supportsAnsi() {
-  if (!process.stdout.isTTY) return false;
-  if (process.env.NO_COLOR) return false;
-  if ((process.env.TERM ?? '').toLowerCase() === 'dumb') return false;
-  return true;
-}
-
-function bold(s) {
-  return supportsAnsi() ? `\x1b[1m${s}\x1b[0m` : String(s);
-}
-
-function dim(s) {
-  return supportsAnsi() ? `\x1b[2m${s}\x1b[0m` : String(s);
-}
-
-function cyan(s) {
-  return supportsAnsi() ? `\x1b[36m${s}\x1b[0m` : String(s);
-}
-
-function green(s) {
-  return supportsAnsi() ? `\x1b[32m${s}\x1b[0m` : String(s);
-}
+import { bold, cyan, dim, green } from './utils/ui/ansi.mjs';
+import { coerceHappyMonorepoRootFromPath, getComponentDir } from './utils/paths/paths.mjs';
 
 function pickReviewerMobileSchemeEnv(env) {
   // For review-pr flows, reviewers typically have the standard Happy dev build on their phone,
@@ -236,12 +215,12 @@ async function main() {
       json,
       data: {
         usage:
-          'happys setup-pr --happy=<pr-url|number> [--happy-cli=<pr-url|number>] [--happy-server=<pr-url|number>|--happy-server-light=<pr-url|number>] [--name=<stack>] [--dev|--start] [--mobile] [--deps=none|link|install|link-or-install] [--forks|--upstream] [--seed-auth|--no-seed-auth] [--copy-auth-from=<stack>] [--link-auth|--copy-auth] [--update] [--force] [--json] [-- <stack dev/start args...>]',
+          'happys setup-pr --happy=<pr-url|number> [--happy-server-light=<pr-url|number>] [--name=<stack>] [--dev|--start] [--mobile] [--deps=none|link|install|link-or-install] [--forks|--upstream] [--seed-auth|--no-seed-auth] [--copy-auth-from=<stack>] [--link-auth|--copy-auth] [--update] [--force] [--json] [-- <stack dev/start args...>]',
       },
       text: [
         '[setup-pr] usage:',
-        '  happys setup-pr --happy=<pr-url|number> [--happy-cli=<pr-url|number>] [--dev]',
-        '  happys setup pr --happy=<pr-url|number> [--happy-cli=<pr-url|number>] [--dev]   # alias',
+        '  happys setup-pr --happy=<pr-url|number> [--dev]',
+        '  happys setup pr --happy=<pr-url|number> [--dev]   # alias',
         '',
         'What it does (idempotent):',
         '- ensures happy-stacks home exists (init)',
@@ -257,7 +236,11 @@ async function main() {
         'example:',
         '  happys setup-pr \\',
         '    --happy=https://github.com/slopus/happy/pull/123 \\',
-        '    --happy-cli=https://github.com/slopus/happy-cli/pull/456',
+        '    --dev',
+        '',
+        'legacy note:',
+        '  In the pre-monorepo split-repo era, happy-cli/happy-server had separate PRs.',
+        '  In monorepo mode, use --happy only (it covers UI + CLI + server).',
       ].join('\n'),
     });
     return;
@@ -276,6 +259,15 @@ async function main() {
     throw new Error('[setup-pr] cannot specify both --happy-server and --happy-server-light');
   }
 
+  const happyMonorepoActive = Boolean(coerceHappyMonorepoRootFromPath(getComponentDir(rootDir, 'happy', process.env)));
+  if (happyMonorepoActive && (prCli || prServer)) {
+    throw new Error(
+      '[setup-pr] this workspace uses the slopus/happy monorepo.\n' +
+        'Fix: use --happy=<pr> only (it covers UI + CLI + server).\n' +
+        'Note: --happy-cli/--happy-server are legacy flags for the pre-monorepo split repos.'
+    );
+  }
+
   const wantsDev = flags.has('--dev') || (!flags.has('--start') && !flags.has('--prod'));
   const wantsStart = flags.has('--start') || flags.has('--prod');
   if (wantsDev && wantsStart) {
@@ -719,4 +711,3 @@ main().catch((err) => {
   console.error('[setup-pr] failed:', err);
   process.exit(1);
 });
-