@open-dy/vibecoding-cli 0.0.1-beta.1

package/src/lint/lint-lynx-css.mjs

@@ -0,0 +1,244 @@
+#!/usr/bin/env node
+/**
+ * OpenCard Lynx CSS 静态检查：扫 src 下 CSS，并复用同一规则检查 Text class。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import {
+  formatFinding,
+  isTextContainerDeclaration,
+  lintAtRule,
+  lintDeclaration,
+  lintSelector,
+} from './lynx-css-rules.mjs';
+
+// Keep string literals intact: comment delimiters inside quoted URLs are data.
+function scanComments(source) {
+  const chars = source.split('');
+  const errors = [];
+  let quote = '';
+  for (let i = 0; i < source.length; i += 1) {
+    if (quote) {
+      if (source[i] === '\\') i += 1;
+      else if (source[i] === quote) quote = '';
+      continue;
+    }
+    if (source[i] === '"' || source[i] === "'") {
+      quote = source[i];
+      continue;
+    }
+    if (source.slice(i, i + 2) === '*/') {
+      errors.push({ index: i, message: '孤立的 CSS 注释结束符 */；检查文件是否缺失开头。' });
+      i += 1;
+    } else if (source.slice(i, i + 2) === '/*') {
+      const end = source.indexOf('*/', i + 2);
+      if (end < 0) errors.push({ index: i, message: 'CSS 注释未闭合，缺少 */。' });
+      const stop = end < 0 ? source.length : end + 2;
+      for (let j = i; j < stop; j += 1) {
+        if (chars[j] !== '\n') chars[j] = ' ';
+      }
+      i = stop - 1;
+    }
+  }
+  return { content: chars.join(''), errors };
+}
+
+export function stripCommentsPreservingLines(source) {
+  return scanComments(source).content;
+}
+
+function lineAt(source, index) {
+  const before = source.slice(0, index);
+  return {
+    line: before.split('\n').length,
+    column: index - before.lastIndexOf('\n'),
+  };
+}
+
+function splitTopLevel(source, delimiter) {
+  const parts = [];
+  let current = '';
+  let depth = 0;
+  let quote = '';
+  for (const char of source) {
+    if (quote) {
+      current += char;
+      if (char === quote) quote = '';
+      continue;
+    }
+    if (char === '"' || char === "'") {
+      quote = char;
+      current += char;
+      continue;
+    }
+    if (char === '(') depth += 1;
+    if (char === ')') depth = Math.max(0, depth - 1);
+    if (char === delimiter && depth === 0) {
+      parts.push(current);
+      current = '';
+      continue;
+    }
+    current += char;
+  }
+  if (current) parts.push(current);
+  return parts;
+}
+
+function walkRules(source, onRule, offset = 0) {
+  let index = 0;
+  while (index < source.length) {
+    const open = source.indexOf('{', index);
+    if (open < 0) break;
+    const selector = source.slice(index, open).trim();
+    let depth = 1;
+    let cursor = open + 1;
+    while (cursor < source.length && depth > 0) {
+      if (source[cursor] === '{') depth += 1;
+      if (source[cursor] === '}') depth -= 1;
+      cursor += 1;
+    }
+    const bodyEnd = depth === 0 ? cursor - 1 : source.length;
+    const body = source.slice(open + 1, bodyEnd);
+    onRule({ selector, body, selectorOffset: offset + index, bodyOffset: offset + open + 1 });
+    index = cursor;
+  }
+}
+
+function listFiles(directory, predicate, files = []) {
+  if (!fs.existsSync(directory)) return files;
+  for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+    const target = path.join(directory, entry.name);
+    if (entry.isDirectory()) {
+      listFiles(target, predicate, files);
+    } else if (predicate(target)) {
+      files.push(target);
+    }
+  }
+  return files;
+}
+
+function textClassTokensFromTsx(source) {
+  const names = new Set();
+  for (const match of source.matchAll(/<Text\b[^>]*\bclassName\s*=\s*(?:"([^"]+)"|'([^']+)')/g)) {
+    const value = match[1] ?? match[2] ?? '';
+    for (const className of value.split(/\s+/)) {
+      if (className) names.add(className);
+    }
+  }
+  return names;
+}
+
+export function lintCssText(source, { filename = 'input.css' } = {}) {
+  const { content, errors } = scanComments(source);
+  const findings = errors.map(({ index, message }) => ({
+    file: filename, ...lineAt(source, index), message,
+  }));
+  const textClassRules = new Map();
+
+  walkRules(content, ({ selector, body, selectorOffset, bodyOffset }) => {
+    const selectorLocation = lineAt(content, selectorOffset);
+    if (selector.startsWith('@')) {
+      const name = selector.split(/\s|\{/)[0];
+      for (const item of lintAtRule(name)) {
+        findings.push({ file: filename, ...selectorLocation, message: item.message });
+      }
+      return;
+    }
+
+    const allowRoot = filename.replace(/\\/g, '/').endsWith('/src/app.css') || filename === 'src/app.css';
+    for (const item of lintSelector(selector, { allowRoot })) {
+      findings.push({ file: filename, ...selectorLocation, message: item.message });
+    }
+
+    const classNames = [...selector.matchAll(/\.([A-Za-z0-9_-]+)/g)].map((match) => match[1]);
+    const declarations = [];
+    let consumed = 0;
+    for (const fragment of splitTopLevel(body, ';')) {
+      const colon = fragment.indexOf(':');
+      if (colon < 0) {
+        consumed += fragment.length + 1;
+        continue;
+      }
+      const property = fragment.slice(0, colon).trim();
+      const value = fragment.slice(colon + 1).trim();
+      if (!property || !value) {
+        consumed += fragment.length + 1;
+        continue;
+      }
+      const location = lineAt(content, bodyOffset + consumed);
+      declarations.push({ property, value, location });
+      for (const item of lintDeclaration(property, value)) {
+        findings.push({ file: filename, ...location, message: item.message });
+      }
+      consumed += fragment.length + 1;
+    }
+
+    for (const className of classNames) {
+      textClassRules.set(className, declarations);
+    }
+  });
+
+  return { findings, textClassRules };
+}
+
+export function lintProject(
+  sourceDirectory = path.join(process.cwd(), 'src'),
+  { projectRoot = path.resolve(sourceDirectory, '..') } = {},
+) {
+  const reports = [];
+  const textClasses = new Set();
+  const cssFiles = listFiles(sourceDirectory, (file) => file.endsWith('.css'));
+  const tsxFiles = listFiles(sourceDirectory, (file) => /\.(?:tsx|jsx)$/.test(file));
+  const ruleMap = new Map();
+
+  for (const file of tsxFiles) {
+    for (const className of textClassTokensFromTsx(fs.readFileSync(file, 'utf8'))) {
+      textClasses.add(className);
+    }
+  }
+
+  for (const file of cssFiles) {
+    const relative = path.relative(projectRoot, file).replace(/\\/g, '/');
+    const result = lintCssText(fs.readFileSync(file, 'utf8'), { filename: relative });
+    reports.push(...result.findings);
+    for (const [className, declarations] of result.textClassRules) {
+      ruleMap.set(className, { declarations, filename: relative });
+    }
+  }
+
+  for (const [className, rule] of ruleMap) {
+    if (!textClasses.has(className)) continue;
+    for (const declaration of rule.declarations) {
+      if (!isTextContainerDeclaration(declaration.property)) continue;
+      reports.push({
+        file: rule.filename,
+        ...declaration.location,
+        message: `Text 不是 Flex/Grid 容器，不要写 ${declaration.property}: ${declaration.value}。多个节点的排列由外层 View 承担。`,
+      });
+    }
+  }
+
+  return reports;
+}
+
+export function lintOpenCardProject(projectRoot) {
+  const root = path.resolve(projectRoot);
+  return lintProject(path.join(root, 'src'), { projectRoot: root });
+}
+
+function main() {
+  const reports = lintOpenCardProject(process.cwd());
+  if (reports.length === 0) return;
+  console.error(`ERROR: OpenCard Lynx CSS 检查失败（${reports.length}）`);
+  for (const report of reports) {
+    console.error(formatFinding(report.file, report.line, report.column, report.message));
+  }
+  process.exit(1);
+}
+
+const invoked =
+  process.argv[1] &&
+  import.meta.url === pathToFileURL(path.resolve(process.argv[1])).href;
+
+if (invoked) main();

package/src/lint/lynx-css-rules.mjs

@@ -0,0 +1,138 @@
+/**
+ * OpenCard Lynx CSS 机械检查规则。
+ *
+ * CLI 自己执行 OpenCard lint，因此这里不依赖 SDK；SDK 暴露给项目 ESLint 配置的
+ * 规则仍独立维护在 SDK 内。
+ */
+
+export const HINT = '见 references/opencard/rendering.md';
+
+const FORBIDDEN_AT_RULES = new Set(['media', 'supports', 'layer', 'namespace']);
+
+const FORBIDDEN_PROPERTIES = new Map([
+  ['float', '不要用 float。改用 Flex / Grid。'],
+  ['clear', '不要用 clear。改用 Flex / Grid。'],
+  ['pointer-events', 'Lynx 不支持 pointer-events。用条件渲染或事件层级。'],
+  ['cursor', 'Lynx 不支持 cursor。不要生成。'],
+  ['resize', 'Lynx 不支持 resize。用组件状态或 JS 调尺寸。'],
+  ['scroll-behavior', 'Lynx 不支持 scroll-behavior。不要生成。'],
+  ['overscroll-behavior', '不要用 overscroll-behavior 承接滚动。'],
+  ['content', '不能用伪元素生成内容。增加真实 Taro 节点。'],
+  ['list-style', '列表 marker 不可用。用真实节点表达。'],
+  ['list-style-type', '列表 marker 不可用。用真实节点表达。'],
+  ['word-break', 'Lynx 不支持 word-break。控制文本节点宽度。'],
+  ['overflow-wrap', 'Lynx 不支持 overflow-wrap。控制文本节点宽度。'],
+  ['word-wrap', 'Lynx 不支持 word-wrap。控制文本节点宽度。'],
+  ['-webkit-line-clamp', '不要迁移 -webkit-line-clamp。收敛内容或使用单行省略。'],
+  ['-webkit-box-orient', '不要迁移 -webkit-box。'],
+]);
+
+const TEXT_CONTAINER_PROPS = new Set([
+  'flex-direction',
+  'flex-wrap',
+  'flex-flow',
+  'justify-content',
+  'align-items',
+  'align-content',
+  'gap',
+  'row-gap',
+  'column-gap',
+]);
+
+export function toKebab(value) {
+  return String(value ?? '')
+    .trim()
+    .replace(/[A-Z]/g, (char) => `-${char.toLowerCase()}`)
+    .toLowerCase();
+}
+
+export function formatFinding(file, line, column, message) {
+  return `${file}:${line}:${column} ${message}`;
+}
+
+function issue(message) {
+  return { message: `${message} ${HINT}` };
+}
+
+export function lintAtRule(name) {
+  const normalized = String(name ?? '').trim().replace(/^@/, '').toLowerCase();
+  if (!FORBIDDEN_AT_RULES.has(normalized)) {
+    return [];
+  }
+  if (normalized === 'media') {
+    return [issue('Lynx 的 @media 不生效。容器用 flex、vw/vh 适配。')];
+  }
+  return [issue(`Lynx 不支持 @${normalized}。使用常规 CSS 或运行时 class。`)];
+}
+
+export function lintSelector(selector, { allowRoot = false } = {}) {
+  const normalized = String(selector ?? '');
+  const findings = [];
+  if (/::(?:before|after|first-line|first-letter|marker|backdrop)\b/i.test(normalized)) {
+    findings.push(issue('不要使用 CSS 伪元素。需要内容时增加真实节点。'));
+  }
+  if (/:?(?:first-child|last-child|only-child|nth-child|nth-of-type|has)\b/i.test(normalized)) {
+    findings.push(issue('不要依赖结构伪类。为对应节点添加显式 class。'));
+  }
+  if (!allowRoot && /(?:^|[^A-Za-z0-9_-]):root(?![A-Za-z0-9_-])/i.test(normalized)) {
+    findings.push(issue(':root 只允许出现在 src/app.css。页面和组件变量写在局部 class。'));
+  }
+  return findings;
+}
+
+export function isTextContainerDeclaration(prop) {
+  return TEXT_CONTAINER_PROPS.has(toKebab(prop));
+}
+
+export function lintDeclaration(prop, rawValue) {
+  const property = toKebab(prop);
+  const value = String(rawValue ?? '').trim();
+  const normalized = value.toLowerCase();
+  const findings = [];
+
+  if (property.startsWith('--')) {
+    return findings;
+  }
+
+  const propertyMessage = FORBIDDEN_PROPERTIES.get(property);
+  if (propertyMessage) {
+    findings.push(issue(propertyMessage));
+  }
+
+  if (property.startsWith('scroll-snap-')) {
+    findings.push(issue('Lynx 不支持 scroll-snap。横向轮播使用 Swiper。'));
+  }
+
+  if (property === 'display' && /(?:^|\s)(?:inline|inline-block|table|contents|list-item)(?:\s|$)/i.test(normalized)) {
+    findings.push(issue('不要依赖 inline、table、contents 或 list-item 布局。使用 Flex / Grid。'));
+  }
+
+  if (property === 'position' && /^(?:static|sticky)$/i.test(normalized)) {
+    findings.push(issue(`不要使用 position: ${normalized}。改用普通布局或 fixed / absolute。`));
+  }
+
+  if (
+    (property === 'overflow' || property === 'overflow-y') &&
+    /(?:^|\s)(?:auto|scroll)(?:\s|$)/i.test(normalized)
+  ) {
+    findings.push(issue('固定 widget 不允许纵向滚动。减项、摘要化或切换局部状态。'));
+  }
+
+  if (property === 'white-space' && /(?:pre|pre-wrap|pre-line|break-spaces)/i.test(normalized)) {
+    findings.push(issue('不要使用预格式 white-space。收敛文案并控制节点尺寸。'));
+  }
+
+  if (property === 'flex' && /^\s*\d+(?:\.\d+)?\s*$/i.test(normalized)) {
+    findings.push(issue('不要写 flex: 1。使用完整三值 flex: 1 1 0，并显式设置 min-height / min-width。'));
+  }
+
+  if (/\b(?:min|max|clamp)\s*\(/i.test(value)) {
+    findings.push(issue('Lynx 不支持 min()、max()、clamp()。用 flex、vw/vh 或明确尺寸。'));
+  }
+
+  if (/(?:^|[^\w-])(?:cm|mm|in|pt|pc|ch|ex)(?:$|[^\w-])/i.test(value)) {
+    findings.push(issue('不要使用 cm/mm/in/pt/pc/ch/ex 单位。使用 px、rem、vw 或 vh。'));
+  }
+
+  return findings;
+}

package/src/preview/dev-watch.mjs

@@ -0,0 +1,38 @@
+import { startPreview } from './start-preview.mjs'
+
+// Standalone compatibility entry: preview only, without installing dependencies
+// or starting the backend/database services owned by `vibecoding dev`.
+/**
+ * @desc 启动仅前端预览的开发监听流程，不安装依赖或启动后端服务。
+ * @params {object} options 预览根目录、目标模式及可选退出回调。
+ * @return {Promise<void>} 预览进程结束后的 Promise。
+ * @example runDevWatch({ root: process.cwd(), cardMode: false })
+ */
+export async function runDevWatch(options) {
+  const controller = new AbortController()
+  let preview
+  let failure
+  let finish
+  const lifetime = new Promise((resolve) => { finish = resolve })
+  const stop = (error) => {
+    failure ??= error
+    controller.abort()
+    finish()
+  }
+  const onSignal = () => stop()
+  const signals = ['SIGINT', 'SIGTERM', 'SIGHUP']
+  for (const signal of signals) process.once(signal, onSignal)
+  try {
+    preview = await startPreview({ ...options, signal: controller.signal, onExit: stop })
+    await lifetime
+  } catch (error) {
+    if (!controller.signal.aborted) failure = error
+  } finally {
+    await preview?.close()
+    for (const signal of signals) process.removeListener(signal, onSignal)
+  }
+  if (failure) {
+    console.error(`[dev-watch] ${failure.message}`)
+    process.exitCode = 1
+  }
+}

package/src/preview/start-preview.mjs

@@ -0,0 +1,213 @@
+import { startRoutingPreview } from './watch-card-routing.mjs'
+import { spawn } from 'node:child_process'
+import { existsSync, mkdirSync, readFileSync, rmSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import path from 'node:path'
+import { pathToFileURL } from 'node:url'
+import { CliError } from '../core/errors.mjs'
+import { attachLabeledOutput } from '../core/process-output.mjs'
+import { resolveSdkTaroEntry } from '../core/runner.mjs'
+import { withServiceLogLabel } from '../core/service-log-context.mjs'
+
+const META_PATH = '/opt/gem/ai_coding_app/.meta/ai_coding_app_meta.json'
+const READY_TIMEOUT_MS = 5 * 60 * 1000
+
+export function conversationId() {
+  try { return JSON.parse(readFileSync(META_PATH, 'utf8')).conversation_id ?? '' } catch { return '' }
+}
+
+export async function loadPreviewRunner(projectRoot, env = process.env) {
+  // Only PPE's explicit offline dependency overrides the platform runtime.
+  let offlineRunner = false
+  try {
+    const manifest = JSON.parse(readFileSync(path.join(projectRoot, 'package.json'), 'utf8'))
+    offlineRunner = manifest.devDependencies?.['@byted/microapp-preview-runner']?.startsWith('file:patches/') === true
+  } catch {}
+  const base = offlineRunner ? projectRoot : env.AI_CODING_BUILTIN_PACKAGES_DIR || projectRoot
+  const requireFromTarget = createRequire(path.join(path.resolve(base), 'package.json'))
+  let entry
+  try {
+    entry = requireFromTarget.resolve('@byted/microapp-preview-runner')
+  } catch {
+    throw new CliError(
+      'Cannot resolve @byted/microapp-preview-runner. Set AI_CODING_BUILTIN_PACKAGES_DIR or install it in the project.',
+    )
+  }
+  return import(pathToFileURL(entry).href)
+}
+
+export function waitForFile(file, label, { signal, timeoutMs = READY_TIMEOUT_MS, pollMs = 500 } = {}) {
+  return new Promise((resolve, reject) => {
+    const deadline = Date.now() + timeoutMs
+    const finish = (error) => {
+      clearInterval(timer)
+      signal?.removeEventListener('abort', abort)
+      if (error) reject(error)
+      else resolve()
+    }
+    const abort = () => finish(new CliError('Preview startup cancelled'))
+    const timer = setInterval(() => {
+      if (existsSync(file)) {
+        finish()
+      } else if (Date.now() > deadline) {
+        finish(new CliError(`Timed out waiting for ${label}: ${file}`))
+      }
+    }, pollMs)
+    signal?.addEventListener('abort', abort, { once: true })
+    if (signal?.aborted) abort()
+  })
+}
+
+export function resolveOpenCardPreviewUrl(root, env = process.env, id = conversationId()) {
+  const configured = env.OPEN_CARD_PREVIEW_URL?.trim()
+  if (configured) return configured
+  if (!existsSync(path.join(root, 'opencard/package.json'))) return undefined
+  const localCardPreview = `http://127.0.0.1:${resolvePreviewPort(env.OPENCARD_PORT, 10087)}`
+  return id
+    ? `${localCardPreview}/api/apps/open_ai_coding_chat_server/aio_fe/${id}/card_preview`
+    : localCardPreview
+}
+
+export function resolvePreviewPort(value, fallback) {
+  const port = Number.parseInt(value ?? String(fallback), 10)
+  return Number.isNaN(port) ? fallback : port
+}
+
+function killDetachedChild(child) {
+  if (!child?.pid || child.exitCode !== null || child.signalCode !== null) return
+  return new Promise(resolve => {
+    child.once('exit', resolve)
+    try {
+      process.kill(-child.pid, 'SIGKILL')
+    } catch {
+      try { if (!child.kill?.('SIGKILL')) resolve() } catch { resolve() }
+    }
+  })
+}
+
+export async function startPreview(options) {
+  if (!options.cardMode) return startPreviewOnce(options)
+  let session
+  session = await startRoutingPreview({
+    root: options.root,
+    signal: options.signal,
+    onError: error => options.onExit ? options.onExit(error) : console.error(error),
+    start: (env, signal) => startPreviewOnce({ ...options, signal, env: { ...options.env, ...env },
+      onExit: error => { void session?.close(); options.onExit?.(error) },
+    }),
+  })
+  return session
+}
+
+async function startPreviewOnce({
+  root,
+  cardMode = false,
+  env = {},
+  onExit,
+  label = cardMode ? 'opencard' : 'taro',
+  outputDir: requestedOutputDir,
+  cacheDir: requestedCacheDir,
+  spawnProcess = spawn,
+  loadPreviewRunnerFn = loadPreviewRunner,
+  waitForFileFn = waitForFile,
+  resolveSdkTaroEntryFn = resolveSdkTaroEntry,
+  killChildFn = killDetachedChild,
+  conversationIdFn = conversationId,
+  signal,
+}) {
+  root = path.resolve(root)
+  env = { ...process.env, ...env }
+  const inputName = cardMode ? 'dist-tt' : 'dist'
+  const outputName = cardMode ? 'opencard-dist' : 'app-dist'
+  const port = cardMode
+    ? resolvePreviewPort(env.OPENCARD_PORT, 10087)
+    : resolvePreviewPort(env.DEPLOY_RUN_PORT, 10086)
+  const route = cardMode ? 'card_preview' : 'preview'
+  const outputDir = requestedOutputDir ?? `/tmp/microapp_dist/${outputName}`
+  const cacheDir = requestedCacheDir ?? `/tmp/microapp_dist/${outputName}-cache`
+  const { startRspuckPreview } = await loadPreviewRunnerFn(root, env)
+  if (signal?.aborted) throw new CliError('Preview startup cancelled')
+  mkdirSync(path.join(root, '.home'), { recursive: true })
+  rmSync(path.join(root, inputName), { recursive: true, force: true })
+  rmSync(outputDir, { recursive: true, force: true })
+
+  const child = spawnProcess(cardMode ? process.execPath : 'pnpm', cardMode ? [
+    resolveSdkTaroEntryFn(root), 'build', '--type', 'tt', '--watch', '--mode', 'dev',
+  ] : ['dev:tt'], {
+    cwd: root,
+    env: {
+      ...process.env,
+      ...env,
+      HOME: path.join(root, '.home'),
+      ...(cardMode ? { TT_OUTPUT_ROOT: 'dist-tt' } : {}),
+    },
+    stdio: ['ignore', 'pipe', 'pipe'],
+    detached: true,
+  })
+  let starting = true
+  let cleaningUp = false
+  let rejectEarlyExit
+  const earlyExit = new Promise((_, reject) => { rejectEarlyExit = reject })
+  const waitController = new AbortController()
+  const abort = () => rejectEarlyExit(new CliError('Preview startup cancelled'))
+  signal?.addEventListener('abort', abort, { once: true })
+  if (signal?.aborted) abort()
+  attachLabeledOutput(child, label)
+  child.on('error', (error) => {
+    if (cleaningUp) return
+    onExit?.(error)
+    rejectEarlyExit(error)
+  })
+  child.on('exit', (code, signal) => {
+    if (cleaningUp) return
+    const error = code === 0 && !signal
+      ? null
+      : new CliError(`taro watch exited (${signal ?? code})`)
+    onExit?.(error)
+    if (starting) {
+      rejectEarlyExit(error ?? new CliError('taro watch exited before preview was ready'))
+    }
+  })
+
+  try {
+    await Promise.race([
+      waitForFileFn(path.join(root, inputName, 'app.json'), `${inputName}/app.json`, { signal: waitController.signal }),
+      earlyExit,
+    ])
+    const id = conversationIdFn()
+    const runtimePromise = withServiceLogLabel(label, () => startRspuckPreview({
+      projectRoot: root,
+      inputDir: path.join(root, inputName),
+      outputDir,
+      cacheDir,
+      port,
+      appid: env.APP_ID ?? process.env.APP_ID,
+      previewBasePath: id
+        ? `/api/apps/open_ai_coding_chat_server/aio_fe/${id}/${route}`
+        : '',
+      readyTimeoutMs: READY_TIMEOUT_MS,
+      ...(!cardMode ? { openCardPreviewUrl: resolveOpenCardPreviewUrl(root, env, id) } : {}),
+      ...(!cardMode && env.OPEN_CARD_ID?.trim()
+        ? { associatedCardAppIds: [env.OPEN_CARD_ID.trim()] }
+        : {}),
+      ...(cardMode ? { cardMode: true } : {}),
+    })).then(async (runtime) => {
+      if (cleaningUp) await runtime.close().catch(() => {})
+      return runtime
+    })
+    const runtime = await Promise.race([runtimePromise, earlyExit])
+    starting = false
+    return { child, runtime, port, close: async () => {
+      cleaningUp = true
+      await killChildFn(child)
+      await runtime.close().catch(() => {})
+    } }
+  } catch (error) {
+    cleaningUp = true
+    await killChildFn(child)
+    throw error
+  } finally {
+    waitController.abort()
+    signal?.removeEventListener('abort', abort)
+  }
+}