@open-dy/vibecoding-cli 0.0.1-beta.3 → 0.0.1-beta.5

package/README.md

@@ -18,8 +18,6 @@ vibecoding verify --target taro --auto-start --full
 
 主要命令：`dev`、`build`、`lint`、`verify`、`pack`、`docs`、`turbo`、`init-mysql-db`，以及 `validate feed-card|routes|empty|opencard-structure`。
 
-`verify --full --auto-start` 在等待依赖安装日志前启动 dev；已有 dev 正在启动或运行时复用，一次校验最多启动一次。安装就绪只认最近一次启动的日志，安装失败直接报错；之后仍按静态检查、端口检查、API 与浏览器检查执行。`--static-only` 不启动 dev，也不等待 dev 日志。
-
 `vibecoding docs --target taro`（OpenCard 使用 `--target opencard`，可指定 `--cwd <工程目录>`）只读定位实际安装的 SDK，输出 JSON：依赖键、版本、包位置、文档索引及公开类型路径。`ready` 时沿 `index` 查阅；`docs-missing` 表示已安装的旧包没有索引，按 `exports` / `types` 查公开入口。业务导入使用 `imports`，npm 别名以依赖键为前缀，不能换成包的 `name`。包尚不可用时最多等待 `--timeout` 秒（默认 90），超时返回 `SDK_NOT_INSTALLED`，应检查工程安装结果。命令不会安装、重建 SDK 或启动服务。
 
 Turbo 构建应通过 CLI 包装命令执行，例如 `vibecoding turbo --target opencard run build:raw`。CLI 会读取项目的 `turbo.json`，合并版本化默认配置，并将结果写入项目内的 `.vibecoding/cache/turbo.json`；封闭域状态和 `config/card-routing.json` 也会参与构建环境与缓存输入。`--root-turbo-json` 由 CLI 管理，不能由业务命令覆盖；需要传递其他 Turbo 参数时，放在 `--` 后面。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-dy/vibecoding-cli",
-  "version": "0.0.1-beta.3",
+  "version": "0.0.1-beta.5",
   "description": "Command orchestration, validation and packaging for Douyin vibecoding Taro and OpenCard projects.",
   "type": "module",
   "bin": {
@@ -28,7 +28,7 @@
   ],
   "scripts": {
     "ci:check": "pnpm run build && pnpm run test",
-    "build": "node ./scripts/verify-package.mjs",
+    "build": "node ./scripts/check-package-files.mjs",
     "test": "node ../scripts/run-package-tests.mjs cli",
     "pack:local": "pnpm pack --pack-destination ./artifacts",
     "pack:ppe": "node ./scripts/pack-ppe.mjs",
@@ -42,8 +42,8 @@
     "ajv": "^8.18.0"
   },
   "peerDependencies": {
-    "@open-dy/vibecoding-sdk-taro": "0.0.1-beta.3",
-    "@open-dy/vibecoding-sdk-opencard": "0.0.1-beta.3"
+    "@open-dy/vibecoding-sdk-taro": "0.0.1-beta.4",
+    "@open-dy/vibecoding-sdk-opencard": "0.0.1-beta.4"
   },
   "peerDependenciesMeta": {
     "@open-dy/vibecoding-sdk-taro": {

package/src/adapters/interest-card/opencard/dev-watch.mjs

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import { spawn } from 'node:child_process';
 import { startRoutingPreview } from '../../../preview/watch-card-routing.mjs';
+import { loadPreviewRunner } from '../../../preview/preview-runner.mjs';
 import fs from 'node:fs';
-import { createRequire } from 'node:module';
 import path from 'node:path';
-import { fileURLToPath, pathToFileURL } from 'node:url';
+import { fileURLToPath } from 'node:url';
 
 const __dirname = path.join(process.env.VIBECODING_OPENCARD_ROOT || process.cwd(), 'scripts');
 const root = path.resolve(__dirname, '..');
@@ -17,7 +17,6 @@ const META_PATH = '/opt/gem/ai_coding_app/.meta/ai_coding_app_meta.json';
 const READY_TIMEOUT_MS = 5 * 60 * 1000;
 const READY_POLL_MS = 500;
 const DEFAULT_PORT = 10087;
-const AI_CODING_BUILTIN_PACKAGES_DIR = process.env.AI_CODING_BUILTIN_PACKAGES_DIR;
 
 const children = [];
 let shuttingDown = false;
@@ -29,22 +28,6 @@ function log(message) {
     console.log(`[opencard-dev-watch] ${message}`);
 }
 
-async function loadPreviewRunner() {
-    const manifest = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'));
-    const offlineRunner = manifest.devDependencies?.['@byted/microapp-preview-runner']?.startsWith('file:patches/') === true;
-    if (offlineRunner || !AI_CODING_BUILTIN_PACKAGES_DIR) {
-        return import(pathToFileURL(createRequire(path.join(root, 'package.json')).resolve('@byted/microapp-preview-runner')).href);
-    }
-
-    const requireFromTarget = createRequire(
-        path.join(path.resolve(AI_CODING_BUILTIN_PACKAGES_DIR), 'package.json'),
-    );
-    const runnerEntry = requireFromTarget.resolve('@byted/microapp-preview-runner');
-
-    log(`using preview runner from ${AI_CODING_BUILTIN_PACKAGES_DIR}`);
-    return import(pathToFileURL(runnerEntry).href);
-}
-
 function readMeta() {
     try {
         return JSON.parse(fs.readFileSync(META_PATH, 'utf-8'));
@@ -151,7 +134,7 @@ for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
 }
 
 async function startCycle(env, signal) {
-    const { startRspuckPreview } = await loadPreviewRunner();
+    const { startRspuckPreview } = await loadPreviewRunner(root);
 
     fs.rmSync(path.join(root, TT_OUTPUT_DIR), { recursive: true, force: true });
     fs.rmSync(RSPUCK_OUTPUT_DIR, { recursive: true, force: true });

package/src/commands/verify.mjs

@@ -6,7 +6,6 @@ import { CliError } from '../core/errors.mjs'
 import { readRuntimeEnvironment } from '../core/environment.mjs'
 import { waitForPorts } from '../core/ports.mjs'
 import { runCaptured, runTasks } from '../core/runner.mjs'
-import { devProcessMatches, inspectDevProcess } from '../core/dev-process.mjs'
 import { packageUses, validateDependencies } from '../validators/dependencies.mjs'
 import { validateFeedCard } from '../validators/feed-card.mjs'
 import { readCardRouting } from '../build/opencard-environment.mjs'
@@ -61,32 +60,14 @@ export function startDevDetached(context, spawnProcess = spawn) {
   })
 }
 
-function resolveDevRuntimeRoot(context, env = process.env) {
-  // Match the supervisor: standalone OpenCard shares its host's runtime files.
-  const root = context.taroRoot ?? (context.target === 'opencard' ? path.dirname(context.root) : context.root)
-  return env.VIBECODING_RUNTIME_ROOT || (
+export function resolveDevLogPath(context, env = process.env) {
+  if (env.LOG_FILE) return env.LOG_FILE
+  const runtimeRoot = env.VIBECODING_RUNTIME_ROOT || (
     process.platform === 'linux'
       ? '/workspace/tmp'
-      : path.join(root, '.tmp/microapp-dev')
+      : path.join(context.root, '.tmp/microapp-dev')
   )
-}
-
-export function resolveDevLogPath(context, env = process.env) {
-  return env.LOG_FILE || path.join(resolveDevRuntimeRoot(context, env), 'microapp-logs/dev.log')
-}
-
-function readDevLog(context) {
-  try { return readFileSync(resolveDevLogPath(context), 'utf8') } catch { return '' }
-}
-
-function hasRunningDev(context) {
-  return ['microapp-dev-script.pid', 'microapp-dev-run.pid'].some(name => {
-    let pid
-    try { pid = readFileSync(path.join(resolveDevRuntimeRoot(context), name), 'utf8').trim() } catch { return false }
-    if (!/^[1-9][0-9]*$/.test(pid) || !Number.isSafeInteger(Number(pid))) return false
-    try { process.kill(Number(pid), 0) } catch (error) { if (error.code !== 'EPERM') return false }
-    return devProcessMatches(context, inspectDevProcess(Number(pid)))
-  })
+  return path.join(runtimeRoot, 'microapp-logs/dev.log')
 }
 
 function printLastRunErrors(logFile, log) {
@@ -108,15 +89,7 @@ export async function waitForDevInstall(context, timeoutSeconds, options = {}) {
   const sleepFn = options.sleepFn ?? sleep
   const deadline = Date.now() + timeoutSeconds * 1000
   while (Date.now() < deadline) {
-    // Exclude previous runs, including the old log before a new supervisor has
-    // appended its separator. A newly launched run supplies its starting offset.
-    const newLog = readLog().slice(options.logOffset ?? 0)
-    const sections = newLog.split('--- DEV_RUN_START ---')
-    const section = options.logOffset !== undefined && sections.length === 1 ? '' : sections.at(-1) || ''
-    const failure = section.split('\n').find(line =>
-      /(?:pnpm install failed|Dependency installation failed|CLI installation did not create)/i.test(line))
-    if (failure) throw new CliError(`Dev dependency installation failed: ${failure.trim()}. Full log: ${logFile}`)
-    if (section.includes('Dependencies installed successfully')) return
+    if (readLog().includes('Dependencies installed successfully')) return
     await sleepFn(options.pollMs ?? 1_000)
   }
   printLastRunErrors(logFile, readLog())
@@ -126,25 +99,19 @@ export async function waitForDevInstall(context, timeoutSeconds, options = {}) {
   )
 }
 
-async function prepareDev(context, options, frontendUrl) {
-  if (!options.autoStart || options.staticOnly) return {}
-  const ports = targetPorts(context, frontendUrl, options.full)
-  const status = await waitForPorts(ports, 1)
-  if (status.every(entry => entry.listening) || hasRunningDev(context)) return {}
-  const logOffset = readDevLog(context).length
-  const pid = await startDevDetached(context)
-  console.log(`[vibecoding:verify] started dev (PID ${pid}); waiting for dependency installation`)
-  return { logOffset }
-}
-
 async function verifyPorts(context, options, frontendUrl) {
   const ports = targetPorts(context, frontendUrl, options.full)
-  const status = await waitForPorts(ports, options.autoStart ? options.timeoutSeconds : 1)
+  let status = await waitForPorts(ports, 1)
+  if (status.every((entry) => entry.listening)) return
+  if (!options.autoStart) {
+    throw new CliError(`Ports not listening: ${status.filter((entry) => !entry.listening).map((entry) => `${entry.label}:${entry.port}`).join(', ')}`)
+  }
+  const pid = await startDevDetached(context)
+  console.log(`[vibecoding:verify] started dev (PID ${pid}); waiting for ports`)
+  await waitForDevInstall(context, options.timeoutSeconds)
+  status = await waitForPorts(ports, options.timeoutSeconds)
   const missing = status.filter((entry) => !entry.listening)
   if (missing.length > 0) {
-    if (!options.autoStart) {
-      throw new CliError(`Ports not listening: ${missing.map(entry => `${entry.label}:${entry.port}`).join(', ')}`)
-    }
     printLastRunErrors(resolveDevLogPath(context))
     throw new CliError(`Ports not ready after ${options.timeoutSeconds}s: ${missing.map((entry) => `${entry.label}:${entry.port}`).join(', ')}`)
   }
@@ -619,8 +586,7 @@ export async function runVerify(context, options = {}) {
   options = { timeoutSeconds: 90, ...options, full }
   const frontendUrl = resolveFrontendUrl(context, options)
   parseHttpUrl(frontendUrl, 'frontend')
-  const installOptions = await prepareDev(context, options, frontendUrl)
-  if (full && !options.staticOnly) await waitForDevInstall(context, options.timeoutSeconds, installOptions)
+  if (full) await waitForDevInstall(context, options.timeoutSeconds)
   if (full || options.staticOnly) await runStatic(context)
   if (options.staticOnly) return
 

package/src/preview/preview-runner.mjs

@@ -0,0 +1,37 @@
+import { readFileSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import path from 'node:path'
+import { pathToFileURL } from 'node:url'
+import { CliError } from '../core/errors.mjs'
+
+/**
+ * @desc 加载工程明确声明的预览运行时；未声明时优先使用沙箱内置运行时。
+ * @params {string} projectRoot 当前工程根目录。
+ * @params {object} env 运行环境，可通过 AI_CODING_BUILTIN_PACKAGES_DIR 指定内置包目录。
+ * @return {Promise<object>} 已加载的 Preview Runner 模块；所选包缺失时抛出错误。
+ * @example await loadPreviewRunner(projectRoot, process.env)
+ */
+export async function loadPreviewRunner(projectRoot, env = process.env) {
+  let declaredRunner = false
+  try {
+    const manifest = JSON.parse(readFileSync(path.join(projectRoot, 'package.json'), 'utf8'))
+    const specifier = manifest.devDependencies?.['@byted/microapp-preview-runner']
+      ?? manifest.dependencies?.['@byted/microapp-preview-runner']
+    declaredRunner = typeof specifier === 'string' && specifier.trim().length > 0
+  } catch {}
+  const builtin = !declaredRunner && env.AI_CODING_BUILTIN_PACKAGES_DIR
+  const base = path.resolve(builtin || projectRoot)
+  const requireFromTarget = createRequire(path.join(base, 'package.json'))
+  let entry
+  try {
+    entry = requireFromTarget.resolve('@byted/microapp-preview-runner')
+  } catch {
+    throw new CliError(
+      `Cannot resolve @byted/microapp-preview-runner from ${base}. `
+      + (declaredRunner ? 'Run pnpm install in the project.'
+        : 'Set AI_CODING_BUILTIN_PACKAGES_DIR or install it in the project.'),
+    )
+  }
+  console.log(`[preview-runner] using ${builtin ? 'builtin' : 'project'} package: ${entry}`)
+  return import(pathToFileURL(entry).href)
+}

package/src/preview/start-preview.mjs

@@ -1,9 +1,8 @@
 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 { loadPreviewRunner } from './preview-runner.mjs'
 import { CliError } from '../core/errors.mjs'
 import { attachLabeledOutput } from '../core/process-output.mjs'
 import { resolveSdkTaroEntry } from '../core/runner.mjs'
@@ -12,30 +11,12 @@ 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 { loadPreviewRunner } from './preview-runner.mjs'
+
 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
@@ -59,9 +40,8 @@ export function waitForFile(file, label, { signal, timeoutMs = READY_TIMEOUT_MS,
 }
 
 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
+  // Match the card service's port; the runner consumes this single target URL.
   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`

package/src/core/dev-process.mjs

@@ -1,53 +0,0 @@
-import { execFileSync } from 'node:child_process'
-import { readFileSync, readlinkSync, realpathSync } from 'node:fs'
-import path from 'node:path'
-import { resolveProjectContext } from './context.mjs'
-
-/** Read only the recorded PID; never search processes or other projects. */
-export function inspectDevProcess(pid) {
-  try {
-    const command = execFileSync('ps', ['-ww', '-p', String(pid), '-o', 'args='],
-      { encoding: 'utf8', timeout: 1_000 }).trim()
-    const cwd = process.platform === 'linux' ? readlinkSync(`/proc/${pid}/cwd`)
-      : execFileSync('lsof', ['-a', '-p', String(pid), '-d', 'cwd', '-Fn'],
-        { encoding: 'utf8', timeout: 1_000 }).split('\n').find(line => line.startsWith('n'))?.slice(1)
-    // Bootstrap may override its script's default root. Read just that field
-    // from Linux process metadata; never expose process environment contents.
-    let workspacePath
-    if (process.platform === 'linux') {
-      try { workspacePath = readFileSync(`/proc/${pid}/environ`, 'utf8')
-        .split('\0').find(entry => entry.startsWith('WORKSPACE_PATH='))?.slice('WORKSPACE_PATH='.length) } catch {}
-    }
-    return { command, cwd, workspacePath }
-  } catch { return null }
-}
-
-const flag = (command, name) => command.match(new RegExp(
-  `(?:^|\\s)--${name}(?:=|\\s+)(.*?)(?=\\s+--[\\w-]+(?:[=\\s]|$)|$)`,
-))?.[1]?.trim().replace(/^(['"])(.*)\1$/, '$2')
-const canonical = directory => {
-  try { return realpathSync(directory) } catch { return path.resolve(directory) }
-}
-
-/** A live PID is reusable only when its dev entry, project and target match. */
-export function devProcessMatches(context, state) {
-  if (!state?.cwd) return false
-  const { command, cwd } = state
-  const launcher = /(?:^|\s)(?:\S*\/)?vibecoding(?:-dev|\.mjs)?\s/.test(command)
-    && /(?:^|\s)dev(?:\s|$)/.test(command)
-  const bootstrap = command.match(/^(?:\S*\/)?bash\s+(.*?scripts\/dev_run\.sh)(?:\s|$)/)
-  if (!launcher && !bootstrap) return false
-  const target = launcher ? flag(command, 'target') : 'taro'
-  if (!['taro', 'opencard'].includes(target)) return false
-  let root = path.resolve(cwd, launcher ? flag(command, 'cwd') || '.'
-    : state.workspacePath || path.join(path.dirname(bootstrap[1]), '..'))
-  if (launcher) {
-    // The public CLI can start from a project subdirectory without --cwd.
-    try { root = resolveProjectContext({ cwd: root, target }).root } catch {}
-  }
-  root = canonical(root)
-  const expected = canonical(context.root)
-  return root === expected && target === context.target
-    || context.target === 'opencard' && target === 'taro'
-      && canonical(path.join(root, 'opencard')) === expected
-}