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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-dy/vibecoding-cli",
-  "version": "0.0.1-beta.4",
+  "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",

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/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`