@coze-arch/cli 0.1.8-alpha.53dd57 → 0.1.8-alpha.5d5f9d

package/lib/__templates__/expo/.cozeproj/scripts/prepare-node-modules.sh

@@ -119,7 +119,9 @@ cleanup_legacy_workspace() {
   done < <(find "$workspace_dir" -mindepth 1 -maxdepth 1 -print0)
 }
 
-# Preserve existing project caches during dependency preparation.
+# caches is reserved for the sibling prepare scripts of this project. They keep
+# regenerable framework output there (the Next helper points .next/dev into it), and that
+# output has to outlive an install, so this cleanup must not read it as leftover.
 cleanup_legacy_shadow_project() {
   local entry name
   while IFS= read -r -d '' entry; do

package/lib/__templates__/native-static/.coze

@@ -5,10 +5,10 @@ project_type = "web"
 
 [dev]
 build = []
-run = [ "sh", "-c", "exec python3 -m http.server ${DEPLOY_RUN_PORT} --bind 0.0.0.0" ]
+run = ["python3", "-m", "http.server", "${DEPLOY_RUN_PORT}", "--bind", "0.0.0.0"]
 run_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", "./scripts/serve.ps1"]
 
 [deploy]
 build = []
-run = [ "sh", "-c", "exec python3 -m http.server ${DEPLOY_RUN_PORT} --bind 0.0.0.0" ]
+run = ["python3", "-m", "http.server", "${DEPLOY_RUN_PORT}", "--bind", "0.0.0.0"]
 run_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", "./scripts/serve.ps1"]

package/lib/__templates__/nextjs/scripts/build.sh

@@ -6,7 +6,7 @@ COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
 cd "${COZE_WORKSPACE_PATH}"
 
 echo "Installing dependencies..."
-pnpm install --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
+bash "$COZE_WORKSPACE_PATH/scripts/prepare-node-modules.sh" --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
 
 echo "Building the Next.js project..."
 pnpm next build --webpack

package/lib/__templates__/nextjs/scripts/prepare-next-dev-output.sh

@@ -0,0 +1,122 @@
+#!/usr/bin/env bash
+# Keep Next development output off Coze Drive without moving production output.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
+if [ "$(basename "$(dirname "$SCRIPT_DIR")")" = ".cozeproj" ]; then
+  PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd -P)"
+else
+  PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd -P)"
+fi
+
+DRIVE_ROOT="${COZE_DRIVE_ROOT:-/Coze/Drive}"
+if [ -d "$DRIVE_ROOT" ]; then
+  DRIVE_ROOT="$(cd "$DRIVE_ROOT" && pwd -P)"
+else
+  DRIVE_ROOT="${DRIVE_ROOT%/}"
+fi
+case "$PROJECT_ROOT" in
+  "$DRIVE_ROOT"|"$DRIVE_ROOT"/*) ;;
+  *) exit 0 ;;
+esac
+
+# Next writes every on-demand development build into .next/dev. On Coze Drive each of
+# those writes goes through the sync daemon, so only that subtree moves to local disk.
+# Production output stays in the project directory, which keeps `next build` and
+# deployment unchanged.
+#
+# One local directory per project, shared with prepare-node-modules.sh: node_modules and
+# this cache sit side by side under WORK_DIR. The caches subdirectory is the slot that
+# script reserves for output that must survive an install, so nothing here is cleaned up
+# behind our back. PROJECT_ID has to stay identical to the one it computes.
+NM_ROOT="/tmp/nm"
+PROJECT_ID="$(basename "$PROJECT_ROOT")-$(printf '%s' "$PROJECT_ROOT" | cksum | awk '{print $1}')"
+WORK_DIR="$NM_ROOT/$PROJECT_ID"
+NEXT_ROOT="$PROJECT_ROOT/.next"
+NEXT_DEV="$NEXT_ROOT/dev"
+LEGACY_NEXT_ROOT="$WORK_DIR/.next"
+LOCAL_NEXT_DEV="$WORK_DIR/caches/next-dev"
+
+case "$LOCAL_NEXT_DEV" in
+  "$DRIVE_ROOT"|"$DRIVE_ROOT"/*)
+    echo "[next] local development output must not be on Coze Drive: $LOCAL_NEXT_DEV" >&2
+    exit 1
+    ;;
+esac
+
+# Coze Drive sync does not preserve symlinks: a synced copy of a link arrives as a
+# regular file holding the link target. Recognize the links this scheme creates so a
+# project that came back from sync repairs itself instead of failing to start.
+is_flattened_managed_link() {
+  local candidate="$1" content=""
+  [ -f "$candidate" ] || return 1
+  [ ! -L "$candidate" ] || return 1
+  [ "$(wc -c < "$candidate")" -le 4096 ] || return 1
+  content="$(tr -d '\r\n' < "$candidate")"
+  case "$content" in
+    "$NM_ROOT"/*) return 0 ;;
+  esac
+  return 1
+}
+
+# Earlier versions linked the whole .next directory. Bring any production build made
+# back then into the project; from here on only .next/dev is redirected.
+restore_legacy_next_root() {
+  local entry
+  rm -f "$NEXT_ROOT"
+  mkdir -p "$NEXT_ROOT"
+  if [ -d "$LEGACY_NEXT_ROOT" ]; then
+    while IFS= read -r -d '' entry; do
+      mv "$entry" "$NEXT_ROOT/"
+    done < <(find -P "$LEGACY_NEXT_ROOT" -mindepth 1 -maxdepth 1 -print0)
+    rmdir "$LEGACY_NEXT_ROOT" 2>/dev/null || true
+  fi
+}
+
+if [ -L "$NEXT_ROOT" ]; then
+  case "$(readlink "$NEXT_ROOT")" in
+    "$NM_ROOT"/*)
+      echo "[next] Restoring legacy .next output to the project directory."
+      restore_legacy_next_root
+      ;;
+    *)
+      echo "[next] refusing to replace unmanaged .next symlink: $NEXT_ROOT" >&2
+      exit 1
+      ;;
+  esac
+elif is_flattened_managed_link "$NEXT_ROOT"; then
+  echo "[next] Recovering .next flattened by Coze Drive sync."
+  restore_legacy_next_root
+elif [ -e "$NEXT_ROOT" ] && [ ! -d "$NEXT_ROOT" ]; then
+  echo "[next] refusing to replace non-directory Next output: $NEXT_ROOT" >&2
+  exit 1
+fi
+
+mkdir -p "$NEXT_ROOT" "$LOCAL_NEXT_DEV"
+
+if [ -L "$NEXT_DEV" ]; then
+  if [ "$(readlink "$NEXT_DEV")" = "$LOCAL_NEXT_DEV" ]; then
+    exit 0
+  fi
+  case "$(readlink "$NEXT_DEV")" in
+    "$NM_ROOT"/*) rm "$NEXT_DEV" ;;
+    *)
+      echo "[next] refusing to replace unmanaged .next/dev symlink: $NEXT_DEV" >&2
+      exit 1
+      ;;
+  esac
+elif [ -e "$NEXT_DEV" ]; then
+  # .next/dev holds development output only, and Next regenerates it on demand.
+  rm -rf "$NEXT_DEV"
+fi
+
+# A second dev start can win the race between the removal above and this link.
+if ! ln -s "$LOCAL_NEXT_DEV" "$NEXT_DEV" 2>/dev/null; then
+  if [ -L "$NEXT_DEV" ] && [ "$(readlink "$NEXT_DEV")" = "$LOCAL_NEXT_DEV" ]; then
+    exit 0
+  fi
+  echo "[next] failed to link development output: $NEXT_DEV" >&2
+  exit 1
+fi
+
+echo "[next] Development output linked to $LOCAL_NEXT_DEV"

package/lib/__templates__/nextjs/scripts/prepare-node-modules.sh

@@ -119,7 +119,9 @@ cleanup_legacy_workspace() {
   done < <(find "$workspace_dir" -mindepth 1 -maxdepth 1 -print0)
 }
 
-# Preserve existing project caches during dependency preparation.
+# caches is reserved for the sibling prepare scripts of this project. They keep
+# regenerable framework output there (the Next helper points .next/dev into it), and that
+# output has to outlive an install, so this cleanup must not read it as leftover.
 cleanup_legacy_shadow_project() {
   local entry name
   while IFS= read -r -d '' entry; do

package/lib/__templates__/nuxt-vue/scripts/build.sh

@@ -6,7 +6,7 @@ COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
 cd "${COZE_WORKSPACE_PATH}"
 
 echo "Installing dependencies..."
-pnpm install --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
+bash "$COZE_WORKSPACE_PATH/scripts/prepare-node-modules.sh" --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
 
 echo "Building the Nuxt.js project..."
 pnpm nuxt build

package/lib/__templates__/nuxt-vue/scripts/prepare-node-modules.sh

@@ -119,7 +119,9 @@ cleanup_legacy_workspace() {
   done < <(find "$workspace_dir" -mindepth 1 -maxdepth 1 -print0)
 }
 
-# Preserve existing project caches during dependency preparation.
+# caches is reserved for the sibling prepare scripts of this project. They keep
+# regenerable framework output there (the Next helper points .next/dev into it), and that
+# output has to outlive an install, so this cleanup must not read it as leftover.
 cleanup_legacy_shadow_project() {
   local entry name
   while IFS= read -r -d '' entry; do

package/lib/__templates__/taro/.coze

@@ -8,7 +8,7 @@ build = ["bash", ".cozeproj/scripts/dev_build.sh"]
 build_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", ".cozeproj/scripts/dev_build.ps1"]
 run = ["bash", ".cozeproj/scripts/dev_run.sh"]
 run_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", ".cozeproj/scripts/dev_run.ps1"]
-deps = ["git", "rsync"] # -> apt install git rsync
+deps = ["git"] # -> apt install git
 pack = ["bash", ".cozeproj/scripts/pack.sh"]
 pack_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", ".cozeproj/scripts/pack.ps1"]
 validate = ["bash", ".cozeproj/scripts/validate.sh"]
@@ -17,4 +17,4 @@ validate_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-
 [deploy]
 build = ["bash", ".cozeproj/scripts/deploy_build.sh"]
 run = ["bash", ".cozeproj/scripts/deploy_run.sh"]
-deps = ["git", "rsync"] # -> apt install git rsync
+deps = ["git"] # -> apt install git

package/lib/__templates__/taro/.cozeproj/scripts/deploy_build.sh

@@ -2,9 +2,6 @@
 set -Eeuo pipefail
 
 ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
-if [[ "${COZE_TARO_LOCAL_ACTIVE:-}" != "${ROOT_DIR}" ]]; then
-    exec node "$ROOT_DIR/.cozeproj/scripts/local-workspace.cjs" build "$@"
-fi
 COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-${ROOT_DIR}}"
 export COZE_WORKSPACE_PATH
 
@@ -18,9 +15,7 @@ else
 fi
 echo "Installing dependencies..."
 # 安装所有依赖（包含 Taro 核心和 React）
-if [[ "${COZE_TARO_LOCAL_MIRROR:-}" != "1" ]]; then
-    bash "$ROOT_DIR/.cozeproj/scripts/prepare-node-modules.sh" --prefer-frozen-lockfile --prefer-offline
-fi
+bash "$ROOT_DIR/.cozeproj/scripts/prepare-node-modules.sh" --prefer-frozen-lockfile --prefer-offline
 
 echo "Building the Taro project..."
 pnpm build

package/lib/__templates__/taro/.cozeproj/scripts/dev_build.sh

@@ -2,13 +2,4 @@
 set -Eeuo pipefail
 
 ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
-if [[ "${COZE_TARO_LOCAL_ACTIVE:-}" != "${ROOT_DIR}" ]]; then
-  exec node "$ROOT_DIR/.cozeproj/scripts/local-workspace.cjs" prepare "$@"
-fi
-COZE_WORKSPACE_PATH="${ROOT_DIR}"
-export COZE_WORKSPACE_PATH
-
-cd "${COZE_WORKSPACE_PATH}"
-if [[ "${COZE_TARO_LOCAL_MIRROR:-}" != "1" ]]; then
-    bash "$ROOT_DIR/.cozeproj/scripts/prepare-node-modules.sh" --prefer-frozen-lockfile --prefer-offline
-fi
+bash "$ROOT_DIR/.cozeproj/scripts/prepare-node-modules.sh" --prefer-frozen-lockfile --prefer-offline

package/lib/__templates__/taro/.cozeproj/scripts/dev_run.sh

@@ -3,9 +3,6 @@ echo "⚙️ dev_run.sh 开始运行"
 set -Eeuo pipefail
 
 ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
-if [[ "${COZE_TARO_LOCAL_ACTIVE:-}" != "${ROOT_DIR}" ]]; then
-    exec node "$ROOT_DIR/.cozeproj/scripts/local-workspace.cjs" dev "$@"
-fi
 COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-${ROOT_DIR}}"
 export COZE_WORKSPACE_PATH
 cd "${COZE_WORKSPACE_PATH}"
@@ -13,7 +10,7 @@ cd "${COZE_WORKSPACE_PATH}"
 # ---------------------------------------------------------
 # 项目级日志目录
 # ---------------------------------------------------------
-LOG_DIR="${COZE_LOG_DIR:-${COZE_WORKSPACE_PATH}/logs}"
+LOG_DIR="${COZE_WORKSPACE_PATH}/logs"
 LOG_FILE="${LOG_DIR}/dev.log"
 PID_FILE="${LOG_DIR}/dev.pid"
 DEV_PID=""
@@ -122,15 +119,8 @@ process_belongs_to_workspace() {
 
     case "${cwd}" in
         "${COZE_WORKSPACE_PATH}"|"${COZE_WORKSPACE_PATH}"/*) return 0 ;;
+        *) return 1 ;;
     esac
-
-    if [[ -n "${COZE_TARO_SOURCE_PATH:-}" ]]; then
-        case "${cwd}" in
-            "${COZE_TARO_SOURCE_PATH}"|"${COZE_TARO_SOURCE_PATH}"/*) return 0 ;;
-        esac
-    fi
-
-    return 1
 }
 
 process_group_belongs_to_workspace() {
@@ -224,9 +214,7 @@ cleanup_previous_run() {
 # ---------------------------------------------------------
 echo "📦 Installing dependencies..."
 PNPM_BIN="$(command -v pnpm)"
-if [[ "${COZE_TARO_LOCAL_MIRROR:-}" != "1" ]]; then
-    bash "$ROOT_DIR/.cozeproj/scripts/prepare-node-modules.sh" --prefer-frozen-lockfile --prefer-offline
-fi
+bash "$ROOT_DIR/.cozeproj/scripts/prepare-node-modules.sh" --prefer-frozen-lockfile --prefer-offline
 echo "✅ Dependencies installed successfully!"
 
 # ---------------------------------------------------------
@@ -268,7 +256,7 @@ start_service() {
     DEV_PID="$(spawn_detached \
         "${COZE_WORKSPACE_PATH}" \
         "${LOG_FILE}" \
-        "$(command -v node)" "$ROOT_DIR/.cozeproj/scripts/local-workspace.cjs" watch "${PNPM_BIN}" dev)"
+        "${PNPM_BIN}" dev)"
     if [[ -z "${DEV_PID}" ]]; then
         echo "❌ 无法获取 dev 后台进程 PID"
         return 1
@@ -291,45 +279,5 @@ start_service() {
     echo "PID file: ${PID_FILE}"
 }
 
-warmup_preview() {
-    local base="http://127.0.0.1:${PORT}"
-    local waited=0
-
-    if ! command -v curl >/dev/null 2>&1; then
-        echo "Warmup skipped: curl is not available."
-        return 0
-    fi
-
-    echo "🔥 Warmup: waiting for web server to accept connections..."
-    while (( waited < 60 )); do
-        if curl -s -o /dev/null --max-time 3 "${base}/"; then
-            break
-        fi
-        sleep 2
-        waited=$(( waited + 2 ))
-    done
-
-    local app_config="${COZE_WORKSPACE_PATH}/src/app.config.ts"
-    local pages=""
-    if [[ -f "${app_config}" ]]; then
-        pages=$(grep -oE "[\"']pages/[^\"']+[\"']" "${app_config}" | tr -d "\"'" | sort -u || true)
-    fi
-
-    local p
-    for p in "/" "/app.config.ts"; do
-        echo "🔥 Warmup ${p}"
-        curl -s -o /dev/null --max-time 300 "${base}${p}" || echo "Warmup ${p} timed out or failed (ignored)."
-    done
-    for p in ${pages}; do
-        echo "🔥 Warmup /${p}.tsx"
-        curl -s -o /dev/null --max-time 300 "${base}/${p}.tsx" || echo "Warmup /${p}.tsx timed out or failed (ignored)."
-    done
-}
-
 echo "Starting HTTP services on port ${PORT} (web) and ${SERVER_PORT} (server)..."
 start_service
-
-if [[ "${COZE_TARO_LOCAL_MIRROR:-}" = "1" && "${COZE_DEV_SKIP_WARMUP:-0}" != "1" ]]; then
-    warmup_preview || true
-    echo "✅ Warmup finished (or timed out). Preview should load fast now."
-fi

package/lib/__templates__/taro/.cozeproj/scripts/pack.sh

@@ -1,18 +1,13 @@
 #!/bin/bash
-set -Eeuo pipefail
 
 ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
-if [[ "${COZE_TARO_LOCAL_ACTIVE:-}" != "${ROOT_DIR}" ]]; then
-    exec node "$ROOT_DIR/.cozeproj/scripts/local-workspace.cjs" pack "$@"
-fi
 COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-${ROOT_DIR}}"
 export COZE_WORKSPACE_PATH
 
 cd "${COZE_WORKSPACE_PATH}"
 
-LOG_DIR="${COZE_LOG_DIR:-/tmp}"
-mkdir -p "$LOG_DIR"
-PID_FILE="$LOG_DIR/coze-build_weapp.pid"
+# build_weapp.sh - 通过 PID 文件精确杀掉自己上次的构建进程
+PID_FILE="/tmp/coze-build_weapp.pid"
 
 # 杀掉上次的构建进程组
 if [ -f "$PID_FILE" ]; then
@@ -26,16 +21,11 @@ if [ -f "$PID_FILE" ]; then
     rm -f "$PID_FILE"
 fi
 
-# 用 setsid 创建新的进程组，方便下次整组杀掉；无 setsid 的环境退化为普通后台进程。
-if command -v setsid >/dev/null 2>&1; then
-    setsid pnpm build:pack &
-else
-    pnpm build:pack &
-fi
-BUILD_PID=$!
-echo "$BUILD_PID" > "$PID_FILE"
+# 用 setsid 创建新的进程组，方便下次整组杀掉
+setsid pnpm build:pack &
+echo $! > "$PID_FILE"
 
 echo "构建已启动 (PID: $(cat $PID_FILE))"
 
-wait "$BUILD_PID"
+wait $!
 rm -f "$PID_FILE"

package/lib/__templates__/taro/.cozeproj/scripts/prepare-node-modules.sh

@@ -119,7 +119,9 @@ cleanup_legacy_workspace() {
   done < <(find "$workspace_dir" -mindepth 1 -maxdepth 1 -print0)
 }
 
-# Preserve existing project caches during dependency preparation.
+# caches is reserved for the sibling prepare scripts of this project. They keep
+# regenerable framework output there (the Next helper points .next/dev into it), and that
+# output has to outlive an install, so this cleanup must not read it as leftover.
 cleanup_legacy_shadow_project() {
   local entry name
   while IFS= read -r -d '' entry; do

package/lib/__templates__/taro/.cozeproj/scripts/validate.sh

@@ -2,9 +2,6 @@
 set -Eeuo pipefail
 
 ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
-if [[ "${COZE_TARO_LOCAL_ACTIVE:-}" != "${ROOT_DIR}" ]]; then
-    exec node "$ROOT_DIR/.cozeproj/scripts/local-workspace.cjs" validate "$@"
-fi
 COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-${ROOT_DIR}}"
 export COZE_WORKSPACE_PATH
 

package/lib/__templates__/vite/scripts/build.sh

@@ -6,7 +6,7 @@ COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
 cd "${COZE_WORKSPACE_PATH}"
 
 echo "Installing dependencies..."
-pnpm install --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
+bash "$COZE_WORKSPACE_PATH/scripts/prepare-node-modules.sh" --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
 
 echo "Building frontend with Vite..."
 pnpm vite build

package/lib/__templates__/vite/scripts/prepare-node-modules.sh

@@ -119,7 +119,9 @@ cleanup_legacy_workspace() {
   done < <(find "$workspace_dir" -mindepth 1 -maxdepth 1 -print0)
 }
 
-# Preserve existing project caches during dependency preparation.
+# caches is reserved for the sibling prepare scripts of this project. They keep
+# regenerable framework output there (the Next helper points .next/dev into it), and that
+# output has to outlive an install, so this cleanup must not read it as leftover.
 cleanup_legacy_shadow_project() {
   local entry name
   while IFS= read -r -d '' entry; do

package/lib/cli.js

@@ -2114,7 +2114,7 @@ const EventBuilder = {
 };
 
 var name = "@coze-arch/cli";
-var version = "0.1.8-alpha.53dd57";
+var version = "0.1.8-alpha.5d5f9d";
 var description = "coze coding devtools cli";
 var license = "MIT";
 var author = "fanwenjie.fe@bytedance.com";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coze-arch/cli",
-  "version": "0.1.8-alpha.53dd57",
+  "version": "0.1.8-alpha.5d5f9d",
   "private": false,
   "description": "coze coding devtools cli",
   "license": "MIT",

package/lib/__templates__/taro/.cozeproj/scripts/local-workspace.cjs

@@ -1,317 +0,0 @@
-#!/usr/bin/env node
-// Taro source is owned by Drive. Only these wrappers may write to the local workspace.
-/* eslint-disable @typescript-eslint/no-require-imports -- Standalone CommonJS runtime shipped without CLI dependencies. */
-const fs = require('node:fs');
-const path = require('node:path');
-const os = require('node:os');
-const { createHash } = require('node:crypto');
-const { spawn, execFileSync } = require('node:child_process');
-const { setTimeout: delay } = require('node:timers/promises');
-
-const scriptRoot = fs.realpathSync(path.resolve(__dirname, '..', '..'));
-const source = fs.realpathSync(
-  process.env.COZE_TARO_LOCAL_ACTIVE === scriptRoot && process.env.COZE_TARO_SOURCE_PATH
-    ? process.env.COZE_TARO_SOURCE_PATH : scriptRoot,
-);
-const drivePath = path.resolve(process.env.COZE_DRIVE_ROOT || '/Coze/Drive');
-const drive = fs.existsSync(drivePath) ? fs.realpathSync(drivePath) : drivePath;
-const inside = (root, candidate) => candidate === root || candidate.startsWith(`${root}${path.sep}`);
-const onDrive = inside(drive, source);
-const digest = value => createHash('sha256').update(value).digest('hex');
-// Separate from /tmp/nm: older dependency helpers clean unknown entries there.
-const cacheRoot = path.join(os.tmpdir(), `coze-taro-${process.getuid()}`);
-const projectCache = path.join(cacheRoot, digest(source));
-const exclusions = [
-  'node_modules', '.git', '/logs', '.pnpm-store', '.next', '.nuxt', '.output',
-  '/dist', '/dist-web', '/dist-tt', '/server/dist', '/dist-server', '.cache', '.turbo', '*.tsbuildinfo',
-  '.eslintcache', '.stylelintcache', '/next-env.d.ts',
-];
-const outputDirs = ['dist', 'dist-web', 'dist-tt', 'server/dist'];
-const installArgs = ['install', '--prefer-frozen-lockfile', '--prefer-offline'];
-let interrupted = false;
-const children = new Set();
-
-function stopTree(child) {
-  if (!child.pid || child.exitCode !== null) return;
-  // Keep descendants in the detached launcher's group so readiness ownership works.
-  // Also stop grandchildren when the test/foreground path is signalled directly.
-  let rows = [];
-  try {
-    rows = execFileSync('ps', ['-axo', 'pid=,ppid='], { encoding: 'utf8' })
-      .trim().split('\n').map(line => line.trim().split(/\s+/).map(Number));
-  } catch { /* The launcher still owns and reaps its process group. */ }
-  const pids = [child.pid];
-  for (let i = 0; i < pids.length; i++) {
-    for (const [pid, parent] of rows) if (parent === pids[i]) pids.push(pid);
-  }
-  for (const pid of pids.reverse()) {
-    try { process.kill(pid, 'SIGTERM'); } catch { /* Already exited. */ }
-  }
-  const timer = setTimeout(() => {
-    for (const pid of pids) {
-      try { process.kill(pid, 'SIGKILL'); } catch { /* Already exited. */ }
-    }
-  }, 2000);
-  timer.unref();
-}
-
-for (const signal of ['SIGINT', 'SIGTERM']) {
-  process.on(signal, () => {
-    interrupted = true;
-    process.exitCode = signal === 'SIGINT' ? 130 : 143;
-    for (const child of children) stopTree(child);
-  });
-}
-
-function run(command, args, cwd, env = process.env) {
-  if (interrupted) return Promise.reject(new Error('Interrupted'));
-  return new Promise((resolve, reject) => {
-    const child = spawn(command, args, { cwd, env, stdio: 'inherit' });
-    children.add(child);
-    child.once('error', error => { children.delete(child); reject(error); });
-    child.once('exit', (code, signal) => {
-      children.delete(child);
-      if (code === 0) resolve();
-      else reject(new Error(`${command} exited with ${signal || code}`));
-    });
-  });
-}
-
-function ensureCache() {
-  for (const dir of [cacheRoot, projectCache]) {
-    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
-    if (fs.lstatSync(dir).isSymbolicLink() || fs.statSync(dir).uid !== process.getuid()) {
-      throw new Error(`Refusing unmanaged workspace directory: ${dir}`);
-    }
-    if (inside(drive, fs.realpathSync(dir))) {
-      throw new Error(`Local workspace must be outside Coze Drive: ${dir}`);
-    }
-  }
-}
-
-async function locked(action, name = 'sync') {
-  const lock = path.join(projectCache, `${name}.lock`);
-  const started = Date.now();
-  let missingOwner = 0;
-  while (true) {
-    if (interrupted) throw new Error('Interrupted');
-    try { fs.mkdirSync(lock); break; } catch (error) {
-      if (error.code !== 'EEXIST') throw error;
-    }
-    let alive = false;
-    try {
-      const pid = Number(fs.readFileSync(path.join(lock, 'pid'), 'utf8'));
-      if (Number.isInteger(pid) && pid > 0) { process.kill(pid, 0); alive = true; }
-    } catch (error) { if (error.code === 'EPERM') alive = true; }
-    missingOwner = alive ? 0 : missingOwner + 1;
-    if (missingOwner >= 2) {
-      const stale = `${lock}.stale-${process.pid}`;
-      try {
-        fs.renameSync(lock, stale);
-        fs.rmSync(stale, { recursive: true });
-      } catch (error) { if (error.code !== 'ENOENT') throw error; }
-      missingOwner = 0;
-      continue;
-    }
-    if (Date.now() - started > 120000) throw new Error(`Timed out waiting for ${lock}`);
-    await delay(500);
-  }
-  fs.writeFileSync(path.join(lock, 'pid'), String(process.pid));
-  try { return await action(); }
-  finally { fs.rmSync(lock, { recursive: true, force: true }); }
-}
-
-async function sync(local) {
-  if (!fs.existsSync(path.join(source, 'package.json'))) {
-    throw new Error(`Source project is unavailable: ${source}`);
-  }
-  fs.mkdirSync(local, { recursive: true });
-  if (fs.realpathSync(local) !== local) throw new Error(`Refusing workspace symlink: ${local}`);
-  // Checksums catch same-size edits with unchanged/epoch Drive mtimes. Do not use -t:
-  // changed local files get fresh mtimes and unchanged files retain watcher snapshots.
-  // Materialize source links so the framework never follows them back onto Drive.
-  await run('rsync', [
-    '-rLp', '--checksum', '--delete', '--delay-updates',
-    ...exclusions.map(entry => `--exclude=${entry}`), `${source}/`, `${local}/`,
-  ], source);
-}
-
-function readOptional(file) {
-  try { return fs.readFileSync(file); }
-  catch (error) { if (error.code === 'ENOENT') return Buffer.alloc(0); throw error; }
-}
-
-function installInput(root) {
-  const hash = createHash('sha256');
-  const visit = (dir, all = false) => {
-    for (const entry of fs.readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
-      if (['node_modules', '.git', 'logs', '.pnpm-store', '.next', '.nuxt', '.output', 'dist', 'dist-web', 'dist-tt', 'dist-server', '.cache', '.turbo'].includes(entry.name)) continue;
-      const file = path.join(dir, entry.name);
-      // Follow source links just as rsync -L does, while detecting loops explicitly.
-      const real = fs.realpathSync(file);
-      if (entry.isDirectory() || (entry.isSymbolicLink() && fs.statSync(file).isDirectory())) {
-        if (ancestors.has(real)) throw new Error(`Source symlink cycle: ${file}`);
-        ancestors.add(real);
-        visit(file, all || entry.name === 'patches');
-        ancestors.delete(real);
-      }
-      else if (all || ['package.json', 'pnpm-lock.yaml', 'pnpm-workspace.yaml', '.npmrc', '.pnpmfile.cjs', '.pnpmfile.js'].includes(entry.name)) {
-        hash.update(path.relative(root, file)).update('\0').update(readOptional(file)).update('\0');
-      }
-    }
-  };
-  const ancestors = new Set([fs.realpathSync(root)]);
-  visit(root);
-  return hash.digest('hex');
-}
-
-function localEnv(local) {
-  return {
-    ...process.env,
-    COZE_TARO_LOCAL_ACTIVE: local,
-    COZE_TARO_SOURCE_PATH: source,
-    COZE_TARO_LOCAL_MIRROR: onDrive ? '1' : '',
-    COZE_WORKSPACE_PATH: local,
-    // Keep the existing discoverable log/PID location in the source project.
-    COZE_LOG_DIR: process.env.COZE_LOG_DIR || path.join(source, 'logs'),
-    PWD: local,
-    INIT_CWD: local,
-    ...(onDrive ? { npm_config_store_dir: path.join(cacheRoot, 'store') } : {}),
-  };
-}
-
-async function install(local, mode) {
-  const state = path.join(projectCache, `${mode}.install`);
-  const version = execFileSync('pnpm', ['--version'], { encoding: 'utf8' }).trim();
-  const fingerprint = () => digest([
-    installInput(local), version, process.version, process.env.NODE_ENV,
-    process.env.npm_config_production, process.env.NPM_CONFIG_PRODUCTION,
-    process.env.PNPM_CONFIG_PRODUCTION,
-  ].join('\n'));
-  // Lifecycle scripts may generate files from arbitrary source, so do not reuse
-  // their install based on dependency metadata alone. Read manifests as text here
-  // (no executable hooks or private CLI dependencies in the standalone helper).
-  const manifest = readOptional(path.join(local, 'package.json')).toString();
-  const hasLifecycle = /"(?:install|postinstall|prepare)"\s*:/.test(manifest);
-  const hasHooks = ['.pnpmfile.cjs', '.pnpmfile.js'].some(file => fs.existsSync(path.join(local, file))) ||
-    /^\s*pnpmfile\s*=/m.test(readOptional(path.join(local, '.npmrc')).toString());
-  if (!hasLifecycle && !hasHooks && readOptional(state).toString() === fingerprint() &&
-      fs.existsSync(path.join(local, 'node_modules', '.modules.yaml'))) return;
-  fs.rmSync(state, { force: true });
-  const before = installInput(source);
-  if (before !== installInput(local)) {
-    throw new Error('Dependency inputs changed during sync; rerun dev_build.sh.');
-  }
-  await run('pnpm', [...installArgs, '--store-dir', path.join(cacheRoot, 'store')], local, localEnv(local));
-  if (before !== installInput(source)) {
-    throw new Error('Dependency inputs changed on Drive during installation; rerun dev_build.sh. Lockfile was not overwritten.');
-  }
-  const lockfile = path.join(local, 'pnpm-lock.yaml');
-  if (fs.existsSync(lockfile) && !readOptional(lockfile).equals(readOptional(path.join(source, 'pnpm-lock.yaml')))) {
-    const temporary = path.join(source, `.pnpm-lock.yaml.${process.pid}.tmp`);
-    try {
-      fs.copyFileSync(lockfile, temporary);
-      fs.renameSync(temporary, path.join(source, 'pnpm-lock.yaml'));
-    } finally { fs.rmSync(temporary, { force: true }); }
-  }
-  fs.writeFileSync(state, fingerprint());
-}
-
-async function watch(args) {
-  const local = fs.realpathSync(process.env.COZE_TARO_LOCAL_ACTIVE || path.resolve(__dirname, '..', '..'));
-  if (!onDrive) return run(args[0], args.slice(1), local);
-  ensureCache();
-  if (local !== path.join(fs.realpathSync(projectCache), 'dev')) {
-    throw new Error(`Refusing to watch an unmanaged workspace: ${local}`);
-  }
-  const preparedInput = installInput(local);
-  let running = true;
-  let syncError;
-  const command = run(args[0], args.slice(1), local).finally(() => { running = false; });
-  const poll = (async () => {
-    while (running && !interrupted) {
-      await delay(1000);
-      if (!running || interrupted) break;
-      try {
-        await locked(async () => {
-          await sync(local);
-          if (installInput(local) !== preparedInput) {
-            throw new Error('Dependency inputs changed; rerun dev_build.sh and dev_run.sh before previewing.');
-          }
-        });
-      }
-      catch (error) {
-        syncError = error;
-        for (const child of children) stopTree(child);
-        break;
-      }
-    }
-  })();
-  const results = await Promise.allSettled([command, poll]);
-  if (syncError) throw syncError;
-  if (results[0].status === 'rejected') throw results[0].reason;
-}
-
-async function syncOutputBack(local) {
-  for (const output of outputDirs) {
-    const localOutput = path.join(local, output);
-    const sourceOutput = path.join(source, output);
-    if (!fs.existsSync(localOutput)) continue;
-    fs.rmSync(sourceOutput, { recursive: true, force: true });
-    fs.mkdirSync(path.dirname(sourceOutput), { recursive: true });
-    await run('rsync', ['-a', '--delete', `${localOutput}/`, `${sourceOutput}/`], local);
-  }
-}
-
-function cleanOutputs(local) {
-  for (const output of outputDirs) {
-    fs.rmSync(path.join(local, output), { recursive: true, force: true });
-  }
-}
-
-async function main() {
-  const [action, ...args] = process.argv.slice(2);
-  if (action === 'watch') return watch(args);
-  if (!['prepare', 'dev', 'build', 'pack', 'validate'].includes(action)) throw new Error(`Unknown Taro action: ${action}`);
-  const scriptByAction = {
-    prepare: 'dev_build.sh',
-    dev: 'dev_run.sh',
-    build: 'deploy_build.sh',
-    pack: 'pack.sh',
-    validate: 'validate.sh',
-  };
-  if (!onDrive) {
-    return run('bash', [path.join(source, '.cozeproj', 'scripts', scriptByAction[action]), ...args], source, localEnv(source));
-  }
-  ensureCache();
-  const mode = action === 'validate' ? 'check' : action === 'build' || action === 'pack' ? 'build' : 'dev';
-  const local = path.join(fs.realpathSync(projectCache), mode);
-  console.log(`[taro] Source: ${source}\n[taro] Local ${mode} workspace: ${local}`);
-  if (action === 'validate') {
-    return locked(async () => {
-      await locked(async () => {
-        await sync(local);
-        await install(local, mode);
-      });
-      await run('bash', [path.join(local, '.cozeproj', 'scripts', 'validate.sh'), ...args], local, localEnv(local));
-    }, 'check');
-  }
-  await locked(async () => {
-    await sync(local);
-    await install(local, mode);
-  }, mode);
-  if (action === 'build' || action === 'pack') {
-    cleanOutputs(local);
-  }
-  await run('bash', [path.join(local, '.cozeproj', 'scripts', scriptByAction[action]), ...args], local, localEnv(local));
-  if (action === 'build' || action === 'pack') {
-    await locked(async () => {
-      await syncOutputBack(local);
-    }, 'output');
-  }
-}
-
-main().catch(error => {
-  console.error(`[taro] ${error.message}`);
-  process.exitCode = process.exitCode || 1;
-});