happy-stacks 0.1.2 → 0.3.0

package/scripts/stop.mjs

@@ -1,16 +1,16 @@
-import './utils/env.mjs';
+import './utils/env/env.mjs';
 import { join } from 'node:path';
 import { existsSync } from 'node:fs';
 
-import { parseArgs } from './utils/args.mjs';
-import { printResult, wantsHelp, wantsJson } from './utils/cli.mjs';
-import { run, runCapture } from './utils/proc.mjs';
-import { getRootDir, resolveStackEnvPath } from './utils/paths.mjs';
+import { parseArgs } from './utils/cli/args.mjs';
+import { printResult, wantsHelp, wantsJson } from './utils/cli/cli.mjs';
+import { run, runCapture } from './utils/proc/proc.mjs';
+import { getRootDir, resolveStackEnvPath } from './utils/paths/paths.mjs';
 
 function usage() {
   return [
     '[stop] usage:',
-    '  happys stop [--except-stacks=main,exp1] [--yes] [--aggressive] [--no-docker] [--no-service] [--json]',
+    '  happys stop [--except-stacks=main,exp1] [--yes] [--aggressive] [--sweep-owned] [--no-docker] [--no-service] [--json]',
     '',
     'Stops stacks and related local processes (server, daemon, Expo, managed infra) using stack-scoped commands.',
     '',
@@ -18,6 +18,7 @@ function usage() {
     '  happys stop --except-stacks=main --yes',
     '  happys stop --yes --no-docker',
     '  happys stop --except-stacks=main --yes --aggressive',
+    '  happys stop --except-stacks=main --yes --aggressive --sweep-owned',
   ].join('\n');
 }
 
@@ -59,6 +60,7 @@ async function main() {
   const exceptStacks = new Set(parseCsv(kv.get('--except-stacks')));
   const yes = flags.has('--yes');
   const aggressive = flags.has('--aggressive');
+  const sweepOwned = flags.has('--sweep-owned');
   const noDocker = flags.has('--no-docker');
   const noService = flags.has('--no-service');
 
@@ -108,6 +110,7 @@ async function main() {
         'stop',
         stackName,
         ...(aggressive ? ['--aggressive'] : []),
+        ...(sweepOwned ? ['--sweep-owned'] : []),
         ...(noDocker ? ['--no-docker'] : []),
       ];
       if (json) {

package/scripts/tailscale.mjs

@@ -1,7 +1,10 @@
-import './utils/env.mjs';
-import { parseArgs } from './utils/args.mjs';
-import { run, runCapture } from './utils/proc.mjs';
-import { printResult, wantsHelp, wantsJson } from './utils/cli.mjs';
+import './utils/env/env.mjs';
+import { parseArgs } from './utils/cli/args.mjs';
+import { run, runCapture } from './utils/proc/proc.mjs';
+import { printResult, wantsHelp, wantsJson } from './utils/cli/cli.mjs';
+import { isSandboxed, sandboxAllowsGlobalSideEffects } from './utils/env/sandbox.mjs';
+import { getInternalServerUrl } from './utils/server/urls.mjs';
+import { resolveCommandPath } from './utils/proc/commands.mjs';
 import { constants } from 'node:fs';
 import { access } from 'node:fs/promises';
 
@@ -20,11 +23,6 @@ import { access } from 'node:fs/promises';
  * - url (print the first https:// URL from status output)
  */
 
-function getInternalServerUrl() {
-  const port = process.env.HAPPY_LOCAL_SERVER_PORT?.trim() ? Number(process.env.HAPPY_LOCAL_SERVER_PORT) : 3005;
-  return `http://127.0.0.1:${port}`;
-}
-
 function getServeConfig(internalServerUrl) {
   const upstream = process.env.HAPPY_LOCAL_TAILSCALE_UPSTREAM?.trim()
     ? process.env.HAPPY_LOCAL_TAILSCALE_UPSTREAM.trim()
@@ -133,7 +131,7 @@ async function resolveTailscaleCmd() {
 
   // Try PATH first (without executing `tailscale`, which can hang in some environments).
   try {
-    const found = (await runCapture('sh', ['-lc', 'command -v tailscale 2>/dev/null || true'], { env: tailscaleEnv(), timeoutMs: tailscaleProbeTimeoutMs() })).trim();
+    const found = await resolveCommandPath('tailscale', { env: tailscaleEnv(), timeoutMs: tailscaleProbeTimeoutMs() });
     if (found) {
       return found;
     }
@@ -341,7 +339,7 @@ async function main() {
     return;
   }
 
-  const internalServerUrl = getInternalServerUrl();
+  const internalServerUrl = getInternalServerUrl({ env: process.env, defaultPort: 3005 }).internalServerUrl;
   if (flags.has('--upstream') || kv.get('--upstream')) {
     process.env.HAPPY_LOCAL_TAILSCALE_UPSTREAM = kv.get('--upstream') ?? internalServerUrl;
   }
@@ -369,6 +367,13 @@ async function main() {
       return;
     }
     case 'enable': {
+      if (isSandboxed() && !sandboxAllowsGlobalSideEffects()) {
+        throw new Error(
+          '[tailscale] enable is disabled in sandbox mode.\n' +
+            'Reason: Tailscale Serve is global machine state.\n' +
+            'If you really want this, set: HAPPY_STACKS_SANDBOX_ALLOW_GLOBAL=1'
+        );
+      }
       const res = await tailscaleServeEnable({ internalServerUrl });
       if (res?.enableUrl && !res?.httpsUrl) {
         printResult({
@@ -387,6 +392,13 @@ async function main() {
     }
     case 'disable':
     case 'reset': {
+      if (isSandboxed() && !sandboxAllowsGlobalSideEffects()) {
+        throw new Error(
+          '[tailscale] disable/reset is disabled in sandbox mode.\n' +
+            'Reason: Tailscale Serve is global machine state.\n' +
+            'If you really want this, set: HAPPY_STACKS_SANDBOX_ALLOW_GLOBAL=1'
+        );
+      }
       await tailscaleServeReset();
       printResult({ json, data: { ok: true }, text: '[local] tailscale serve reset' });
       return;

package/scripts/test.mjs

@@ -0,0 +1,123 @@
+import './utils/env/env.mjs';
+import { parseArgs } from './utils/cli/args.mjs';
+import { printResult, wantsHelp, wantsJson } from './utils/cli/cli.mjs';
+import { getComponentDir, getRootDir } from './utils/paths/paths.mjs';
+import { ensureDepsInstalled } from './utils/proc/pm.mjs';
+import { pathExists } from './utils/fs/fs.mjs';
+import { run } from './utils/proc/proc.mjs';
+import { detectPackageManagerCmd, pickFirstScript, readPackageJsonScripts } from './utils/proc/package_scripts.mjs';
+
+const DEFAULT_COMPONENTS = ['happy', 'happy-cli', 'happy-server-light', 'happy-server'];
+
+function pickTestScript(scripts) {
+  const candidates = [
+    'test',
+    'tst',
+    'test:ci',
+    'test:unit',
+    'check:test',
+  ];
+  return pickFirstScript(scripts, candidates);
+}
+
+async function main() {
+  const argv = process.argv.slice(2);
+  const { flags } = parseArgs(argv);
+  const json = wantsJson(argv, { flags });
+
+  if (wantsHelp(argv, { flags })) {
+    printResult({
+      json,
+      data: { components: DEFAULT_COMPONENTS, flags: ['--json'] },
+      text: [
+        '[test] usage:',
+        '  happys test [component...] [--json]',
+        '',
+        'components:',
+        `  ${DEFAULT_COMPONENTS.join(' | ')}`,
+        '',
+        'examples:',
+        '  happys test',
+        '  happys test happy happy-cli',
+      ].join('\n'),
+    });
+    return;
+  }
+
+  const positionals = argv.filter((a) => !a.startsWith('--'));
+  const requested = positionals.length ? positionals : ['all'];
+  const wantAll = requested.includes('all');
+  const components = wantAll ? DEFAULT_COMPONENTS : requested;
+
+  const rootDir = getRootDir(import.meta.url);
+
+  const results = [];
+  for (const component of components) {
+    if (!DEFAULT_COMPONENTS.includes(component)) {
+      results.push({ component, ok: false, skipped: false, error: `unknown component (expected one of: ${DEFAULT_COMPONENTS.join(', ')})` });
+      continue;
+    }
+
+    const dir = getComponentDir(rootDir, component);
+    if (!(await pathExists(dir))) {
+      results.push({ component, ok: false, skipped: false, dir, error: `missing component dir: ${dir}` });
+      continue;
+    }
+
+    const scripts = await readPackageJsonScripts(dir);
+    if (!scripts) {
+      results.push({ component, ok: true, skipped: true, dir, reason: 'no package.json' });
+      continue;
+    }
+
+    const script = pickTestScript(scripts);
+    if (!script) {
+      results.push({ component, ok: true, skipped: true, dir, reason: 'no test script found in package.json' });
+      continue;
+    }
+
+    await ensureDepsInstalled(dir, component);
+    const pm = await detectPackageManagerCmd(dir);
+
+    try {
+      // eslint-disable-next-line no-console
+      console.log(`[test] ${component}: running ${pm.name} ${script}`);
+      await run(pm.cmd, pm.argsForScript(script), { cwd: dir, env: process.env });
+      results.push({ component, ok: true, skipped: false, dir, pm: pm.name, script });
+    } catch (e) {
+      results.push({ component, ok: false, skipped: false, dir, pm: pm.name, script, error: String(e?.message ?? e) });
+    }
+  }
+
+  const ok = results.every((r) => r.ok);
+  if (json) {
+    printResult({ json, data: { ok, results } });
+    return;
+  }
+
+  const lines = ['[test] results:'];
+  for (const r of results) {
+    if (r.ok && r.skipped) {
+      lines.push(`- ↪ ${r.component}: skipped (${r.reason})`);
+    } else if (r.ok) {
+      lines.push(`- ✅ ${r.component}: ok (${r.pm} ${r.script})`);
+    } else {
+      lines.push(`- ❌ ${r.component}: failed (${r.pm ?? 'unknown'} ${r.script ?? ''})`);
+      if (r.error) lines.push(`  - ${r.error}`);
+    }
+  }
+  if (!ok) {
+    lines.push('');
+    lines.push('[test] failed');
+  }
+  printResult({ json: false, text: lines.join('\n') });
+  if (!ok) {
+    process.exit(1);
+  }
+}
+
+main().catch((err) => {
+  console.error('[test] failed:', err);
+  process.exit(1);
+});
+