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

package/README.md

@@ -0,0 +1,47 @@
+# @open-dy/vibecoding-cli
+
+抖音 Vibecoding Taro 与 OpenCard 项目的命令行工具。它集中提供开发预览、构建、校验、运行时检查和部署打包能力。
+
+除 `turbo` 外的工程命令都必须显式指定 target；CLI 不读取 `.tpl/MANIFEST.json` 做环境判断：
+
+```bash
+vibecoding dev --target taro
+vibecoding build --target opencard
+vibecoding lint --target taro
+vibecoding verify --target taro --auto-start --full
+```
+
+当前 target：
+
+- `taro`：Taro 主应用、Server，以及项目中存在时的 OpenCard。
+- `opencard`：独立 OpenCard 项目。
+
+主要命令：`dev`、`build`、`lint`、`verify`、`pack`、`turbo`、`init-mysql-db`，以及 `validate feed-card|routes|empty|opencard-structure`。
+
+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 参数时，放在 `--` 后面。
+
+`vibecoding validate feed-card --target taro` 与 `verify` 的 Feed 卡片检查共享同一实现。它保留原模板脚本的校验：OpenCard 与 Feed 文件的存在关系、JSON 语法、`TemplateType=5` / `TemplateStyleType=6`、`APP_ID` / `OPEN_CARD_ID`、全部 Schema 错误，以及通过后尽力更新 `__timestamp`。失败时不改写 Feed 文件。
+
+Schema 统一使用 `custom-card-schema.json`。`config/card-routing.json` 的 `cardData.serviceDomain`（`open` / `closed`）是卡片服务域的唯一来源；构建时会据此注入 OpenCard 常量。优先保留项目 `scripts/schemas/`、`feed/` 中的本地 Schema 约束，没有时使用 CLI 内置 Schema。内外场构建后的项目 Schema 仍受支持。
+
+两套模板的 `node scripts/check-routes.js` 与 `node scripts/validate-feed-card.js` 均保留为兼容入口，规则统一来自 CLI 的 CJS validator 导出；CLI 命令本身使用对应的 ESM 外层。程序化调用 `validateFeedCard(context, { touchTimestamp: false })` 可禁用时间戳更新。Ajv 由 CLI 自带；OpenCard Lynx CSS 检查复用 `@open-dy/vibecoding-sdk-opencard/eslint/lint-lynx-css`。
+
+`pack --target taro` 默认先清理 `/tmp/microapp_artifacts`，由 CLI 编排 TT 生产构建、server 生产构建以及存在的封闭域服务和 OpenCard 构建，再生成归档。包含 `microapp.zip`、`server.zip`、`Dockerfile`、`run.sh`；存在封闭域服务时追加 `closed-domain-server.zip`、`closed-domain-Dockerfile`、`closed-domain-run.sh`，存在路由配置时复制 `card-routing.json`，存在 OpenCard 时生成 `opencard.zip`。两个 server 每次均构建，不受卡片域开关影响。旧项目若自行提供 `build:pack`，CLI 仍会传递 `ARTIFACTS_DIR` 兼容其产物；两套当前模板均不依赖该分支。
+
+服务包仅包含 `dist`、生成的 `Dockerfile`、`package.json`、`run.sh` 以及可选的 `sql`、`scripts`。生成 Dockerfile 时按原脚本规则为每条 `COPY package.json` 追加存在的目录，项目源文件不改写。构建/zip 失败保留退出码，临时目录在失败时也会清理。
+
+CLI 支持用 `ARTIFACTS_DIR` 指定专用产物目录；为避免误删，拒绝项目、用户主目录、临时目录根及其上级目录。模板的 `pack.sh` 不加载 `.env.dev` 或 `.bashrc`，未传入该变量时默认写入 `/tmp/microapp_artifacts`。
+
+Taro 构建统一由 CLI 编排，兴趣卡只在业务域规则上扩展：
+
+- 两套 Taro 模板均使用 `vibecoding build --target taro` 和 `vibecoding pack --target taro`。模板不再暴露 `build-all.sh`、`build-pack.sh` 或根项目 `build:pack`。
+- OpenCard 保留独立归档入口：通用小程序使用 `vibecoding pack --target opencard`，兴趣卡使用 `vibecoding-interest-card pack` 注入其 widget / Lynx 域适配；两者都只重建 `opencard.zip`，不清理父项目产物。
+- 兴趣卡自定义导航与 `lucide-taro` 约束位于 SDK 的 `interest-card/eslint/taro` adapter；公共校验规则仍只维护一份。
+- `validate routes --target taro` 保留开放域/封闭域选择、卡片路由单服务归属、前端封闭域开关一致性、Feed 必需接口以及主应用/OpenCard 来源诊断；普通未匹配路由仍只报告，不改为失败。`@open-dy/vibecoding-cli/validators/routes` 支持 CJS/ESM 程序化调用。
+- `@open-dy/vibecoding-cli/preview/dev-watch` 的 `runDevWatch({ root })` 只启动 Taro 预览链路，保留项目 `dev:tt` 脚本、清理旧产物、5 分钟就绪超时、云端/OpenCard 预览地址以及信号退出清理；不会安装依赖或启动数据库。完整开发服务仍使用 `vibecoding dev`。
+
+CLI 对外命令和校验入口的 JSDoc 使用 `@desc`、`@params`、`@return`、`@example` 描述行为；仓库级校验器 `pnpm --dir build comments:check:cli` 会在推送前和 CI 中校验这些入口。校验器同时兼容标准 JSDoc 的 `@description`、`@param`、`@returns` 写法，避免编辑器和 TypeDoc 等工具无法解析。
+
+## 准出测试
+
+在仓库根目录运行 `node packages/scripts/run-release-contracts.mjs`，或在本包目录运行 `pnpm test:release`。该命令构建并验证 SDK、CLI 和隔离消费者；终端进度、JUnit 报告与 push CI 配置见 [packages/TESTING.md](../TESTING.md)。

package/assets/schemas/custom-card-schema.json

@@ -0,0 +1,102 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$comment": "style_url=https://lf3-static.bytednsdoc.com/obj/eden-cn/kuLauvyM-tyvmahsWulwV-upfbvK/ljhwZthlaukjlkulzlp/ai/feed-card/template/custom-card.png; order=1",
+  "title": "自定义卡（TemplateStyleType = 6）",
+  "description": "适用场景：\n- 卡片内容区域的样式可以完全自定义\n- 业务方需要完全自定义卡片视觉与跳转，不复用任何标准模板",
+  "type": "object",
+  "properties": {
+    "AppID": {
+      "type": "string",
+      "description": "执行 `printf '%s' \"$APP_ID\"` 获取环境变量 APP_ID 的值，将命令的标准输出原样填入本字段；若输出为空，则填空字符串"
+    },
+    "CardAppID": {
+      "type": "string",
+      "description": "卡片 AppID，执行 `printf '%s' \"$OPEN_CARD_ID\"` 获取环境变量 OPEN_CARD_ID 的值，将命令的标准输出原样填入本字段；若输出为空，则填空字符串"
+    },
+    "PlanName": {
+      "type": "string",
+      "description": "使用“场景/业务名 - 核心内容投放计划”格式"
+    },
+    "TemplateType": {
+      "const": 5,
+      "description": "⚠️ 必须固定输出 5（动态卡）"
+    },
+    "TemplateStyleType": {
+      "const": 6,
+      "description": "⚠️ 必须固定输出 6（自定义卡）"
+    },
+    "DataFetchMode": {
+      "const": "dynamic",
+      "description": "⚠️ 必须固定输出 \"dynamic\""
+    },
+    "CardBackgroundUrl": {
+      "type": "string",
+      "description": "必须调用图片生成工具获取真实的图片 URL，自动生成符合预期的背景图片。此图片将作为 Feed 流场景的全屏背景底图，画面内容必须延伸至画面边缘，完全铺满整个画布。严禁出现手机设备外框、样机模型、任何形式的边框，严禁将内容仅集中在中间而导致四周留白或黑边。图片宽高比严格为`9:16`竖图。必须完整保留原始 URL 及全部 query 参数，禁止截断、改写或丢弃任何参数（如 x-expires）。",
+      "pattern": "^https://"
+    },
+    "Button": {
+      "type": "string",
+      "minLength": 4,
+      "maxLength": 6,
+      "description": "行动按钮文案，保持 4 到 6 个字，使用符合场景的引导性动作词"
+    },
+    "RecommendReasonPrefix": {
+      "type": "string",
+      "minLength": 2,
+      "maxLength": 4,
+      "pattern": "^[a-zA-Z0-9\\u4e00-\\u9fa5]+$",
+      "description": "结合内容特点生成推荐理由前缀，与 Suffix 拼接后共同表达完整推荐理由，避免重复；Prefix 与 Suffix 拼接后的总长度必须在 2~10 个字之间（即两者长度之和 ≥ 2 且 ≤ 10），仅支持中英文、数字，不可输入特殊符号"
+    },
+    "RecommendReasonSuffix": {
+      "type": "string",
+      "minLength": 2,
+      "maxLength": 6,
+      "pattern": "^[a-zA-Z0-9\\u4e00-\\u9fa5]+$",
+      "description": "结合内容特点生成推荐理由后缀，强调内容的吸引力和浏览价值；Prefix 与 Suffix 拼接后的总长度必须在 2~10 个字之间（即两者长度之和 ≥ 2 且 ≤ 10），仅支持中英文、数字，不可输入特殊符号"
+    },
+    "PrimaryColor": {
+      "type": "string",
+      "description": "主色调。取脚本输出的 baseColor.hex 写入。仅当用户明确指定主色调时才自行覆盖。颜色格式为十六进制，例如：#051328"
+    },
+    "ContentInfoList": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 1,
+      "description": "固定 1 项，仅承载跳转信息",
+      "items": {
+        "type": "object",
+        "properties": {
+          "PageIndex": {
+            "type": "string",
+            "description": "必填，小程序页面路径参数。按以下逻辑判断：\n\nStep 1. 检查AppID值\n  ├─ 如果是 tt07e3715e98c9aac0（默认小程序）→ 执行Step 2\n  └─ 如果是其他值（自定义小程序）→ 如果用户输入了 path 则取用户输入值，没有则直接传 \"\" 空即可\n\nStep 2. 默认小程序场景下，按业务约定生成对应的 pages 路径与 query 参数。不能以 http 开头。",
+            "pattern": "^(?!http).*$"
+          },
+          "PageURL": {
+            "type": "string",
+            "minLength": 1,
+            "description": "必填，必须调用“获取小程序分享链接工具”生成，取结果中的 UgUrl。必填参数配置：AppId；Query 为生成的 PageIndex；ShareChannel 和 Channel 都为 \"copy\"。注意：如果 AppId 或者 PageIndex 发生修改，该字段也需要重新生成。"
+          }
+        },
+        "required": ["PageIndex", "PageURL"],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "AppID",
+    "CardAppID",
+    "PlanName",
+    "TemplateType",
+    "TemplateStyleType",
+    "DataFetchMode",
+    "CardBackgroundUrl",
+    "Button",
+    "RecommendReasonPrefix",
+    "RecommendReasonSuffix",
+    "ContentInfoList"
+  ],
+  "additionalProperties": false,
+  "patternProperties": {
+    "^__timestamp$": {}
+  }
+}

package/bin/vibecoding

@@ -0,0 +1,89 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+
+SOURCE_PATH="${BASH_SOURCE[0]}"
+while [[ -h "${SOURCE_PATH}" ]]; do
+  SOURCE_DIR="$(CDPATH= cd -P -- "$(dirname -- "${SOURCE_PATH}")" && pwd)"
+  SOURCE_PATH="$(readlink "${SOURCE_PATH}")"
+  if [[ "${SOURCE_PATH}" != /* ]]; then
+    SOURCE_PATH="${SOURCE_DIR}/${SOURCE_PATH}"
+  fi
+done
+BIN_DIR="$(CDPATH= cd -P -- "$(dirname -- "${SOURCE_PATH}")" && pwd)"
+CALLER_DIR="$(pwd)"
+ORIGINAL_PATH="${PATH:-}"
+NODE_BIN="$(command -v node || true)"
+
+resolve_env_root() {
+  local requested_cwd="${CALLER_DIR}"
+  local expect_cwd=0
+  local argument
+
+  for argument in "$@"; do
+    if [[ "${expect_cwd}" -eq 1 ]]; then
+      requested_cwd="${argument}"
+      expect_cwd=0
+      continue
+    fi
+    case "${argument}" in
+      --cwd)
+        expect_cwd=1
+        ;;
+      --cwd=*)
+        requested_cwd="${argument#--cwd=}"
+        ;;
+    esac
+  done
+
+  if [[ "${expect_cwd}" -eq 1 ]]; then
+    printf '%s' "${CALLER_DIR}"
+    return
+  fi
+  if [[ "${requested_cwd}" != /* ]]; then
+    requested_cwd="${CALLER_DIR}/${requested_cwd}"
+  fi
+  if [[ -d "${requested_cwd}" ]]; then
+    CDPATH= cd -P -- "${requested_cwd}" && pwd
+    return
+  fi
+  printf '%s' "${requested_cwd}"
+}
+
+if [[ -n "${HOME:-}" && -f "${HOME}/.bashrc" ]]; then
+  set +u
+  # shellcheck disable=SC1090
+  source "${HOME}/.bashrc" >/dev/null 2>&1 || true
+  set -u
+  cd "${CALLER_DIR}"
+fi
+
+ENV_ROOT="$(resolve_env_root "$@")"
+ENV_FILE="${ENV_ROOT}/.env.dev"
+if [[ -f "${ENV_FILE}" ]]; then
+  set -a
+  # shellcheck disable=SC1090
+  source "${ENV_FILE}"
+  set +a
+  cd "${CALLER_DIR}"
+fi
+
+if [[ -n "${ORIGINAL_PATH}" ]]; then
+  PATH="${PATH:-}:${ORIGINAL_PATH}"
+  export PATH
+fi
+
+NODE_BIN_AFTER_SOURCE="$(command -v node || true)"
+if [[ -n "${NODE_BIN_AFTER_SOURCE}" ]]; then
+  NODE_BIN="${NODE_BIN_AFTER_SOURCE}"
+fi
+
+if [[ -z "${NODE_BIN}" ]]; then
+  echo "vibecoding requires node to be available in PATH" >&2
+  exit 127
+fi
+
+if [[ "${1:-}" == "dev" ]]; then
+  exec bash "${BIN_DIR}/vibecoding-dev" "${NODE_BIN}" "${BIN_DIR}/vibecoding.mjs" "$@"
+fi
+
+exec "${NODE_BIN}" "${BIN_DIR}/vibecoding.mjs" "$@"

package/bin/vibecoding-dev

@@ -0,0 +1,308 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+
+NODE_BIN="$1"
+CLI_ENTRY="$2"
+shift 2
+
+resolve_project_root() {
+  local requested_cwd="$(pwd)"
+  local expect_cwd=0
+  local argument
+
+  for argument in "$@"; do
+    if [[ "${expect_cwd}" -eq 1 ]]; then
+      requested_cwd="${argument}"
+      expect_cwd=0
+      continue
+    fi
+    case "${argument}" in
+      --cwd)
+        expect_cwd=1
+        ;;
+      --cwd=*)
+        requested_cwd="${argument#--cwd=}"
+        ;;
+    esac
+  done
+
+  if [[ "${expect_cwd}" -eq 1 ]]; then
+    echo "vibecoding dev requires a value after --cwd" >&2
+    return 2
+  fi
+  CDPATH= cd -P -- "${requested_cwd}" && pwd
+}
+
+PROJECT_ROOT="$(resolve_project_root "$@")"
+resolve_target() {
+  local target=""
+  local expect_target=0
+  local argument
+
+  for argument in "$@"; do
+    if [[ "${expect_target}" -eq 1 ]]; then
+      target="${argument}"
+      expect_target=0
+      continue
+    fi
+    case "${argument}" in
+      --target)
+        expect_target=1
+        ;;
+      --target=*)
+        target="${argument#--target=}"
+        ;;
+    esac
+  done
+  printf '%s' "${target}"
+}
+
+TARGET="$(resolve_target "$@")"
+RUNTIME_PROJECT_ROOT="${PROJECT_ROOT}"
+if [[ "${TARGET}" == "opencard" ]]; then
+  RUNTIME_PROJECT_ROOT="$(CDPATH= cd -P -- "${PROJECT_ROOT}/.." && pwd)"
+fi
+
+if [[ -n "${VIBECODING_RUNTIME_ROOT:-}" ]]; then
+  RUNTIME_ROOT="${VIBECODING_RUNTIME_ROOT}"
+else
+  case "$(uname -s)" in
+    Linux)
+      RUNTIME_ROOT="/workspace/tmp"
+      ;;
+    Darwin)
+      RUNTIME_ROOT="${RUNTIME_PROJECT_ROOT}/.tmp/microapp-dev"
+      ;;
+    *)
+      echo "vibecoding dev only supports Linux and macOS" >&2
+      exit 1
+      ;;
+  esac
+fi
+
+SCRIPT_PID_FILE="${RUNTIME_ROOT}/microapp-dev-script.pid"
+DEV_PID_FILE="${RUNTIME_ROOT}/microapp-dev-run.pid"
+DEFAULT_LOG_FILE="${RUNTIME_ROOT}/microapp-logs/dev.log"
+LOG_FILE="${LOG_FILE:-${DEFAULT_LOG_FILE}}"
+LOG_DIR="$(dirname "${LOG_FILE}")"
+LOG_SEPARATOR="--- DEV_RUN_START ---"
+STDOUT_PIPE="${RUNTIME_ROOT}/microapp-dev-stdout.pipe"
+STDERR_PIPE="${RUNTIME_ROOT}/microapp-dev-stderr.pipe"
+DEV_PID=""
+STDOUT_LOGGER_PID=""
+STDERR_LOGGER_PID=""
+
+is_valid_pid() {
+  [[ "${1:-}" =~ ^[1-9][0-9]*$ ]]
+}
+
+read_pid_file() {
+  local pid_file="$1"
+  local pid=""
+  if [[ -f "${pid_file}" ]]; then
+    pid="$(tr -d '[:space:]' < "${pid_file}" 2>/dev/null || true)"
+  fi
+  if is_valid_pid "${pid}"; then
+    printf '%s' "${pid}"
+  fi
+}
+
+kill_process_group_if_owned() {
+  local pid="$1"
+  # kill(2) only resolves -PID when PID is a process-group leader. For ordinary
+  # descendants this is a harmless no-op; for detached services it kills the
+  # complete group, including descendants that have already been re-parented.
+  kill -KILL -- "-${pid}" 2>/dev/null || true
+}
+
+kill_process_tree() {
+  local pid="$1"
+  local children=""
+  local child
+
+  if ! is_valid_pid "${pid}" || [[ "${pid}" == "$$" || "${pid}" == "${PPID}" ]]; then
+    return
+  fi
+  if ! kill -0 "${pid}" 2>/dev/null; then
+    return
+  fi
+
+  # Freeze each parent before walking its children so it cannot create more work
+  # while the tree is being torn down.
+  kill -STOP "${pid}" 2>/dev/null || true
+  children="$(pgrep -P "${pid}" 2>/dev/null || true)"
+  for child in ${children}; do
+    kill_process_tree "${child}"
+  done
+
+  # The CLI starts long-running services as detached process-group leaders.
+  # Killing their group also covers descendants that changed their parent.
+  kill_process_group_if_owned "${pid}"
+  kill -KILL "${pid}" 2>/dev/null || true
+}
+
+cleanup_previous_run() {
+  local old_script_pid=""
+  local old_dev_pid=""
+
+  old_script_pid="$(read_pid_file "${SCRIPT_PID_FILE}")"
+  old_dev_pid="$(read_pid_file "${DEV_PID_FILE}")"
+
+  if [[ -n "${old_script_pid}" && "${old_script_pid}" != "$$" ]]; then
+    echo "[vibecoding:dev] cleaning previous supervisor process tree (PID ${old_script_pid})"
+    kill_process_tree "${old_script_pid}"
+  fi
+  if [[ -n "${old_dev_pid}" && "${old_dev_pid}" != "${old_script_pid}" && "${old_dev_pid}" != "$$" ]]; then
+    echo "[vibecoding:dev] cleaning previous CLI process tree (PID ${old_dev_pid})"
+    kill_process_tree "${old_dev_pid}"
+  fi
+
+  rm -f "${SCRIPT_PID_FILE}" "${DEV_PID_FILE}"
+}
+
+iso_timestamp() {
+  TZ=Asia/Shanghai date "+%Y-%m-%d %H:%M:%S"
+}
+
+strip_ansi() {
+  printf '%s' "$1" | sed $'s/\x1b\\[[0-9;]*[a-zA-Z]//g'
+}
+
+is_compile_error_start() {
+  local plain="$1"
+  [[ "${plain}" =~ Unexpected[[:space:]]+token ]] && return 0
+  [[ "${plain}" =~ SyntaxError|TypeError|ReferenceError|EvalError ]] && return 0
+  [[ "${plain}" =~ ELIFECYCLE|Failed[[:space:]]+to[[:space:]]+compile|Build[[:space:]]+failed ]] && return 0
+  [[ "${plain}" =~ error[[:space:]]+TS[0-9]+ ]] && return 0
+  [[ "${plain}" =~ ERROR[[:space:]]+in[[:space:]] ]] && return 0
+  [[ "${plain}" =~ Module[[:space:]]+not[[:space:]]+found|Cannot[[:space:]]+find[[:space:]]+module ]] && return 0
+  [[ "${plain}" =~ \[commonjs\].*:[[:space:]].+ ]] && return 0
+  [[ "${plain}" =~ \[vite:[^]]+\].+:[[:space:]].+ ]] && return 0
+  [[ "${plain}" =~ Internal[[:space:]]+server[[:space:]]+error ]] && return 0
+  [[ "${plain}" =~ [Ee]rror:[[:space:]] ]] && return 0
+  return 1
+}
+
+is_compile_error_continuation() {
+  local plain="$1"
+  [[ -z "${plain// }" ]] && return 0
+  [[ "${plain}" =~ [0-9]+[[:space:]]+\| ]] && return 0
+  [[ "${plain}" =~ \>[[:space:]]*[0-9]+[[:space:]]+\| ]] && return 0
+  [[ "${plain}" =~ \|[[:space:]]+\^ ]] && return 0
+  [[ "${plain}" =~ file:[[:space:]]*/ ]] && return 0
+  [[ "${plain}" =~ ^[[:space:]]*\^[[:space:]]*$ ]] && return 0
+  return 1
+}
+
+strip_service_prefix() {
+  local plain="$1"
+  if [[ "${plain}" =~ ^\[(taro|server|opencard|closed-domain-server)\][[:space:]]+(.*)$ ]]; then
+    printf '%s' "${BASH_REMATCH[2]}"
+    return
+  fi
+  printf '%s' "${plain}"
+}
+
+prefix_log_stream() {
+  local stream="$1"
+  local line=""
+  local plain=""
+  local body=""
+  local label="stdout"
+  local in_error_block=0
+
+  while IFS= read -r line || [[ -n "${line}" ]]; do
+    plain="$(strip_ansi "${line}")"
+    body="$(strip_service_prefix "${plain}")"
+    label="stdout"
+    if [[ "${stream}" == "stderr" ]]; then
+      label="error"
+      in_error_block=1
+    elif is_compile_error_start "${body}"; then
+      label="error"
+      in_error_block=1
+    elif [[ "${in_error_block}" -eq 1 ]] && is_compile_error_continuation "${body}"; then
+      label="error"
+    else
+      in_error_block=0
+    fi
+    printf '[%s] [%s] %s\n' "$(iso_timestamp)" "${label}" "${line}"
+  done
+}
+
+init_logging() {
+  mkdir -p "${LOG_DIR}"
+  printf '\n%s\n' "${LOG_SEPARATOR}" | tee -a "${LOG_FILE}"
+  rm -f "${STDOUT_PIPE}" "${STDERR_PIPE}"
+  mkfifo "${STDOUT_PIPE}" "${STDERR_PIPE}"
+
+  exec 3>&1 4>&2
+  prefix_log_stream stdout < "${STDOUT_PIPE}" | tee -a "${LOG_FILE}" >&3 &
+  STDOUT_LOGGER_PID=$!
+  prefix_log_stream stderr < "${STDERR_PIPE}" | tee -a "${LOG_FILE}" >&4 &
+  STDERR_LOGGER_PID=$!
+  exec > "${STDOUT_PIPE}" 2> "${STDERR_PIPE}"
+}
+
+close_logging() {
+  if [[ -z "${STDOUT_LOGGER_PID}" && -z "${STDERR_LOGGER_PID}" ]]; then
+    return
+  fi
+
+  exec 1>&3 2>&4
+  exec 3>&- 4>&-
+  set +e
+  [[ -n "${STDOUT_LOGGER_PID}" ]] && wait "${STDOUT_LOGGER_PID}"
+  [[ -n "${STDERR_LOGGER_PID}" ]] && wait "${STDERR_LOGGER_PID}"
+  set -e
+  rm -f "${STDOUT_PIPE}" "${STDERR_PIPE}"
+}
+
+remove_owned_pid_file() {
+  local pid_file="$1"
+  local expected_pid="$2"
+  local recorded_pid=""
+  recorded_pid="$(read_pid_file "${pid_file}")"
+  if [[ "${recorded_pid}" == "${expected_pid}" ]]; then
+    rm -f "${pid_file}"
+  fi
+}
+
+cleanup_current_run() {
+  local status=$?
+  trap - EXIT INT TERM HUP
+  if [[ -n "${DEV_PID}" ]] && kill -0 "${DEV_PID}" 2>/dev/null; then
+    echo "[vibecoding:dev] stopping CLI process tree (PID ${DEV_PID})"
+    kill_process_tree "${DEV_PID}"
+  fi
+  remove_owned_pid_file "${DEV_PID_FILE}" "${DEV_PID}"
+  remove_owned_pid_file "${SCRIPT_PID_FILE}" "$$"
+  close_logging
+  exit "${status}"
+}
+
+mkdir -p "${RUNTIME_ROOT}"
+cleanup_previous_run
+printf '%s\n' "$$" > "${SCRIPT_PID_FILE}"
+init_logging
+
+if [[ ! "${NODE_OPTIONS:-}" =~ --max[-_]old[-_]space[-_]size ]]; then
+  NODE_OPTIONS="${NODE_OPTIONS:+${NODE_OPTIONS} }--max-old-space-size=6144"
+  export NODE_OPTIONS
+fi
+
+trap cleanup_current_run EXIT
+trap 'exit 130' INT
+trap 'exit 143' TERM
+trap 'exit 129' HUP
+
+VIBECODING_DEV_SUPERVISED=1 "${NODE_BIN}" "${CLI_ENTRY}" "$@" &
+DEV_PID=$!
+printf '%s\n' "${DEV_PID}" > "${DEV_PID_FILE}"
+echo "[vibecoding:dev] supervisor PID $$, CLI PID ${DEV_PID}, log file: ${LOG_FILE}"
+
+set +e
+wait "${DEV_PID}"
+DEV_STATUS=$?
+set -e
+exit "${DEV_STATUS}"

package/bin/vibecoding-interest-card.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import { parseArgs } from '../src/core/args.mjs'
+import { resolveProjectContext } from '../src/core/context.mjs'
+import { UsageError } from '../src/core/errors.mjs'
+import { runInterestCard } from '../src/adapters/interest-card/opencard/commands.mjs'
+
+async function main() {
+  const { positionals, flags } = parseArgs(process.argv.slice(2))
+  const [command, validator] = positionals
+  if (flags.help || !command) {
+    console.log(`Usage: vibecoding-interest-card <dev|dev-watch|dev-tt|build|pack|lint|validate> [options]
+
+Options:
+  --cwd <path>    OpenCard project directory (default: current directory)
+  --incremental  Lint changed files when possible
+
+Validators: opencard-structure, widget-shell, lynx-css`)
+    return
+  }
+  for (const name of Object.keys(flags)) {
+    if (name !== 'cwd' && !(name === 'incremental' && command === 'lint')) {
+      throw new UsageError(`Unsupported option for ${command}: --${name}`)
+    }
+  }
+  if (positionals.length > (command === 'validate' ? 2 : 1)) {
+    throw new UsageError(`Unexpected arguments for ${command}`)
+  }
+  const context = resolveProjectContext({ cwd: flags.cwd, target: 'opencard' })
+  return runInterestCard(context, command, validator, flags)
+}
+
+main().catch(error => {
+  console.error(`[vibecoding-interest-card] ERROR: ${error.message ?? error}`)
+  process.exitCode = typeof error?.exitCode === 'number' ? error.exitCode : 1
+})

package/bin/vibecoding.mjs

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+import { main } from '../src/cli.mjs'
+
+main(process.argv.slice(2)).catch((error) => {
+  const message = error instanceof Error ? error.message : String(error)
+  console.error(`[vibecoding] ERROR: ${message}`)
+  process.exitCode = typeof error?.exitCode === 'number' ? error.exitCode : 1
+})

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@open-dy/vibecoding-cli",
+  "version": "0.0.1-beta.1",
+  "description": "Command orchestration, validation and packaging for Douyin vibecoding Taro and OpenCard projects.",
+  "type": "module",
+  "bin": {
+    "vibecoding": "./bin/vibecoding",
+    "vibecoding-interest-card": "./bin/vibecoding-interest-card.mjs"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    "./preview/dev-watch": "./src/preview/dev-watch.mjs",
+    "./validators/routes": {
+      "import": "./src/validators/routes.mjs",
+      "require": "./src/validators/routes.cjs"
+    },
+    "./validators/feed-card": {
+      "import": "./src/validators/feed-card.mjs",
+      "require": "./src/validators/feed-card.cjs"
+    },
+    "./adapters/interest-card/opencard/*": "./src/adapters/interest-card/opencard/*"
+  },
+  "files": [
+    "bin",
+    "src",
+    "assets",
+    "README.md"
+  ],
+  "scripts": {
+    "ci:check": "pnpm run build && pnpm run test",
+    "build": "node ./scripts/verify-package.mjs",
+    "test": "node ../scripts/run-package-tests.mjs cli",
+    "pack:local": "pnpm pack --pack-destination ./artifacts",
+    "pack:ppe": "node ./scripts/pack-ppe.mjs",
+    "test:release": "node ../scripts/run-release-contracts.mjs",
+    "publish:bnpm:ppe": "node ../scripts/ppe-release/cli.mjs vibecoding-cli",
+    "publish:bnpm:ppe:dry-run": "node ../scripts/ppe-release/cli.mjs vibecoding-cli --dry-run"
+  },
+  "dependencies": {
+    "ajv": "^8.18.0"
+  },
+  "peerDependencies": {
+    "@open-dy/vibecoding-sdk-taro": "0.0.1-beta.1",
+    "@open-dy/vibecoding-sdk-opencard": "0.0.1-beta.1"
+  },
+  "peerDependenciesMeta": {
+    "@open-dy/vibecoding-sdk-taro": {
+      "optional": true
+    },
+    "@open-dy/vibecoding-sdk-opencard": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "UNLICENSED"
+}