cloverflow-mcp-server 0.0.8

package/README.md

@@ -0,0 +1,58 @@
+# cloverflow-mcp-server
+
+CloverFlow MCP launcher package compatible with `install-mcp`.
+
+## What this package does
+
+- Starts CloverFlow backend `mcp_server` over HTTP.
+- Bridges HTTP MCP to stdio using `mcp-remote@latest`.
+- Exposes a bin command: `cloverflow-mcp-server`.
+
+## Configure Your AI Assistant
+
+Use `install-mcp` to add the server to your AI assistant:
+
+```bash
+npx -y install-mcp cloverflow-mcp-server --client cursor --yes
+```
+
+Supported clients: `claude-code`, `cursor`, `windsurf`, `vscode`, `cline`, `roo-cline`, `claude`, `zed`, `goose`, `warp`, `codex`
+
+### Claude Code
+
+```bash
+npx -y install-mcp cloverflow-mcp-server --client claude-code --yes
+```
+
+### Cursor
+
+```bash
+npx -y install-mcp cloverflow-mcp-server --client cursor --yes
+```
+
+### VS Code / Copilot
+
+```bash
+npx -y install-mcp cloverflow-mcp-server --client vscode --yes
+```
+
+### Windsurf
+
+```bash
+npx -y install-mcp cloverflow-mcp-server --client windsurf --yes
+```
+
+### Cline
+
+```bash
+npx -y install-mcp cloverflow-mcp-server --client cline --yes
+```
+
+Restart your AI assistant after adding the configuration.
+
+## Environment variables
+
+- `WF_MCP_SERVER_BIN`: absolute path to `mcp_server` binary (optional)
+- `WF_SERVICE_DATA_DIR`: absolute path to `service/data` (optional)
+- `WF_MCP_HTTP_HOST`: default `127.0.0.1`
+- `WF_MCP_HTTP_PORT`: optional fixed port (if unset, launcher auto-selects a free port)

package/bin/cloverflow-mcp-server.js

@@ -0,0 +1,259 @@
+#!/usr/bin/env node
+const fs = require("node:fs");
+const path = require("node:path");
+const net = require("node:net");
+const { spawn } = require("node:child_process");
+const packageMeta = require("../package.json");
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function isWindows() {
+  return process.platform === "win32";
+}
+
+function fileExists(filePath) {
+  try {
+    return fs.existsSync(filePath);
+  } catch {
+    return false;
+  }
+}
+
+function candidateRoots() {
+  const cwd = process.cwd();
+  return [cwd, path.resolve(cwd, ".."), path.resolve(cwd, "..", "..")];
+}
+
+function resolveServiceDataDir() {
+  const bundledData = path.join(__dirname, "..", "vendor", "service-data");
+  if (fileExists(bundledData)) {
+    return bundledData;
+  }
+
+  if (process.env.WF_SERVICE_DATA_DIR && fileExists(process.env.WF_SERVICE_DATA_DIR)) {
+    return process.env.WF_SERVICE_DATA_DIR;
+  }
+  for (const root of candidateRoots()) {
+    const candidate = path.join(root, "service", "data");
+    if (fileExists(candidate)) {
+      return candidate;
+    }
+  }
+  return "";
+}
+
+function resolveServerLaunch() {
+  if (process.env.WF_MCP_SERVER_BIN && fileExists(process.env.WF_MCP_SERVER_BIN)) {
+    return { command: process.env.WF_MCP_SERVER_BIN, args: [] };
+  }
+
+  const exeName = isWindows() ? "mcp_server.exe" : "mcp_server";
+  const bundledPath = path.join(__dirname, "..", "vendor", exeName);
+  if (fileExists(bundledPath)) {
+    return { command: bundledPath, args: [] };
+  }
+
+  for (const root of candidateRoots()) {
+    const debugPath = path.join(root, "service", "target", "debug", exeName);
+    const releasePath = path.join(root, "service", "target", "release", exeName);
+    if (fileExists(debugPath)) return { command: debugPath, args: [] };
+    if (fileExists(releasePath)) return { command: releasePath, args: [] };
+  }
+
+  for (const root of candidateRoots()) {
+    const manifestPath = path.join(root, "service", "Cargo.toml");
+    if (fileExists(manifestPath)) {
+      return {
+        command: "cargo",
+        args: ["run", "--manifest-path", manifestPath, "--bin", "mcp_server", "--"],
+      };
+    }
+  }
+
+  throw new Error(
+    "Cannot locate cloverflow mcp_server. Build service/bin/mcp_server or set WF_MCP_SERVER_BIN."
+  );
+}
+
+async function resolvePort() {
+  if (process.env.WF_MCP_HTTP_PORT) {
+    return String(process.env.WF_MCP_HTTP_PORT);
+  }
+  return String(
+    await new Promise((resolve, reject) => {
+      const server = net.createServer();
+      server.listen(0, "127.0.0.1", () => {
+        const address = server.address();
+        if (!address || typeof address === "string") {
+          server.close();
+          reject(new Error("Failed to allocate free TCP port."));
+          return;
+        }
+        const freePort = address.port;
+        server.close(() => resolve(freePort));
+      });
+      server.on("error", reject);
+    })
+  );
+}
+
+async function waitHealth(endpoint, timeoutMs) {
+  const started = Date.now();
+  while (Date.now() - started < timeoutMs) {
+    try {
+      const response = await fetch(`${endpoint}/health`);
+      if (response.ok) return;
+    } catch {
+      // keep waiting
+    }
+    await sleep(300);
+  }
+  throw new Error(`mcp_server health check timeout: ${endpoint}/health`);
+}
+
+function spawnBackend(command, args, env) {
+  console.error(`[cloverflow-mcp] backend launch command=${command} args=${JSON.stringify(args)}`);
+  const child = spawn(command, args, {
+    stdio: ["ignore", "pipe", "pipe"],
+    env,
+    shell: false,
+    windowsHide: true,
+  });
+  child.on("error", (error) => {
+    console.error(`[cloverflow-mcp] backend spawn error: ${error.message}`);
+  });
+  child.stdout.on("data", (chunk) => {
+    process.stderr.write(String(chunk));
+  });
+  child.stderr.on("data", (chunk) => {
+    process.stderr.write(String(chunk));
+  });
+  return child;
+}
+
+function spawnBridge(env, endpoint) {
+  const protocolVersion = (process.env.WF_MCP_PROTOCOL_VERSION || "").trim();
+  const transportStrategy = process.env.WF_MCP_TRANSPORT_STRATEGY || "http-first";
+  const authTimeoutSeconds = process.env.WF_MCP_AUTH_TIMEOUT_SECONDS || "120";
+  const remoteArgs = [
+    "-y",
+    "mcp-remote@latest",
+    endpoint,
+    "--allow-http",
+    "--transport",
+    transportStrategy,
+    "--auth-timeout",
+    authTimeoutSeconds,
+  ];
+  if (protocolVersion) {
+    remoteArgs.push("--header", `MCP-Protocol-Version:${protocolVersion}`);
+  }
+  const command = isWindows() ? (process.env.ComSpec || "cmd.exe") : "npx";
+  const args = isWindows()
+    ? ["/d", "/s", "/c", `npx ${remoteArgs.join(" ")}`]
+    : remoteArgs;
+  console.error(`[cloverflow-mcp] bridge launch command=${command} args=${JSON.stringify(args)}`);
+
+  const child = spawn(command, args, {
+    stdio: ["pipe", "pipe", "pipe"],
+    env,
+    shell: false,
+    windowsHide: true,
+  });
+  child.on("error", (error) => {
+    console.error(`[cloverflow-mcp] bridge spawn error: ${error.message}`);
+  });
+
+  let bridgeReady = false;
+  const pendingInputChunks = [];
+  const forwardOrBuffer = (chunk) => {
+    if (bridgeReady) {
+      child.stdin.write(chunk);
+      return;
+    }
+    pendingInputChunks.push(Buffer.from(chunk));
+  };
+  const flushPending = () => {
+    if (!bridgeReady) return;
+    while (pendingInputChunks.length > 0) {
+      const next = pendingInputChunks.shift();
+      child.stdin.write(next);
+    }
+  };
+
+  process.stdin.on("data", forwardOrBuffer);
+  process.stdin.on("end", () => {
+    child.stdin.end();
+  });
+
+  child.stderr.on("data", (chunk) => {
+    const text = String(chunk);
+    process.stderr.write(text);
+    if (!bridgeReady && (text.includes("Local STDIO server running") || text.includes("Proxy established successfully"))) {
+      bridgeReady = true;
+      flushPending();
+    }
+  });
+
+  child.stdout.pipe(process.stdout);
+  return child;
+}
+
+async function main() {
+  const host = process.env.WF_MCP_HTTP_HOST || "127.0.0.1";
+  const port = await resolvePort();
+  const endpoint = `http://${host}:${port}`;
+  console.error(
+    `[cloverflow-mcp] launcher version=${packageMeta.version || "unknown"} package=${packageMeta.name || "unknown"}`
+  );
+  const serviceDataDir = resolveServiceDataDir();
+  const launch = resolveServerLaunch();
+
+  const backendEnv = { ...process.env };
+  if (serviceDataDir) {
+    backendEnv.WF_SERVICE_DATA_DIR = serviceDataDir;
+  }
+  backendEnv.WF_MCP_NPM_PACKAGE = packageMeta.name || "cloverflow-mcp-server";
+  backendEnv.WF_MCP_NPM_VERSION = packageMeta.version || "";
+
+  const backend = spawnBackend(
+    launch.command,
+    [...launch.args, "--host", host, "--port", String(port)],
+    backendEnv
+  );
+
+  let shuttingDown = false;
+  const shutdown = () => {
+    if (shuttingDown) return;
+    shuttingDown = true;
+    if (!backend.killed) {
+      backend.kill();
+    }
+  };
+
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+  process.on("exit", shutdown);
+
+  backend.on("exit", (code) => {
+    if (!shuttingDown && code !== 0) {
+      console.error(`[cloverflow-mcp] backend exited early with code ${code}`);
+      process.exit(code || 1);
+    }
+  });
+
+  await waitHealth(endpoint, 20000);
+
+  const bridge = spawnBridge(process.env, endpoint);
+  bridge.on("exit", (code) => {
+    shutdown();
+    process.exit(code || 0);
+  });
+}
+
+main().catch((error) => {
+  console.error(`[cloverflow-mcp] ${error.message}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "cloverflow-mcp-server",
+  "version": "0.0.8",
+  "description": "MCP stdio launcher for CloverFlow service mcp_server",
+  "type": "commonjs",
+  "bin": {
+    "cloverflow-mcp-server": "bin/cloverflow-mcp-server.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "prepack": "node scripts/prepack.js"
+  },
+  "files": [
+    "bin",
+    "vendor"
+  ]
+}

package/vendor/service-data/workflows/baseline-workflow/00-preflight.sh

@@ -0,0 +1,13 @@
+#!/bin/sh
+
+wf require WF_SHARED_REPO_PATH
+wf require WF_REPO_PATHS
+
+for repo in ${WF_REPO_PATHS}; do
+  if ! wf check is-git-repo "$repo"; then
+    continue
+  fi
+
+  wf test is-git-detached "$repo"
+  wf test is-git-dirty "$repo"
+done

package/vendor/service-data/workflows/baseline-workflow/01-start-feature.sh

@@ -0,0 +1,18 @@
+#!/bin/sh
+wf require WF_TARGET_FOLDER
+wf require WF_SHARED_REPO_PATH
+echo "[Status] Copying shared repo snapshot from: $WF_SHARED_REPO_PATH"
+wf test is-git-repo "$WF_SHARED_REPO_PATH"
+if wf test is-path-exists "$WF_TARGET_FOLDER"; then
+	wf test is-dir "$WF_TARGET_FOLDER"
+	wf test is-empty-dir "$WF_TARGET_FOLDER"
+else
+	mkdir -p "$WF_TARGET_FOLDER"
+fi
+cp -a "$WF_SHARED_REPO_PATH/." "$WF_TARGET_FOLDER/"
+branch_name="feature/$(basename "$WF_TARGET_FOLDER")"
+if git -C "$WF_TARGET_FOLDER" rev-parse --verify --quiet "refs/heads/$branch_name" >/dev/null; then
+	git -C "$WF_TARGET_FOLDER" checkout "$branch_name"
+else
+	git -C "$WF_TARGET_FOLDER" checkout -b "$branch_name"
+fi

package/vendor/service-data/workflows/baseline-workflow/02-select-minimal-patch.sh

@@ -0,0 +1,9 @@
+#!/bin/sh
+wf require WF_TARGET_FOLDER
+wf require WF_PATCH_COMMITS
+first="$(printf '%s\n' "$WF_PATCH_COMMITS" | awk '{print $1}')"
+wf test is-git-repo "$WF_TARGET_FOLDER"
+wf test is-git-commit "$WF_TARGET_FOLDER" "$first"
+echo "[Status] Open rebase todo from: $first^"
+echo "[Hint] Keep earliest hash as pick, change later selected hashes to squash."
+git -C "$WF_TARGET_FOLDER" rebase -i "$first^"

package/vendor/service-data/workflows/baseline-workflow/03-patch-sink.sh

@@ -0,0 +1,26 @@
+#!/bin/sh
+wf require WF_TARGET_FOLDER
+wf require WF_SHARED_REPO_PATH
+wf require WF_COMMIT_HASH
+# Validate repositories and selected commit before rewriting history.
+wf test is-git-repo "$WF_TARGET_FOLDER"
+wf test is-git-repo "$WF_SHARED_REPO_PATH"
+wf test is-git-commit "$WF_TARGET_FOLDER" "$WF_COMMIT_HASH"
+
+# Use merge-base(target HEAD, shared HEAD) as the rebase base.
+shared_head="$(git -C "$WF_SHARED_REPO_PATH" rev-parse HEAD)"
+lcp="$(git -C "$WF_TARGET_FOLDER" merge-base HEAD "$shared_head")"
+if [ "$lcp" != "$shared_head" ]; then
+  echo "[Error] LCP mismatch: lcp($lcp) != shared_head($shared_head)"
+  exit 1
+fi
+selected_short="$(git -C "$WF_TARGET_FOLDER" rev-parse --short "$WF_COMMIT_HASH")"
+
+# Reorder rebase todo: move selected commit line to the top.
+editor_cmd="sh -c 'f=\"\$1\"; awk -v s=\"$selected_short\" '\''/^pick / { h=\$2; if (index(h, s)==1 || index(s, h)==1) { x=\$0; next } } { r = r \$0 ORS } END { if (!x) { print \"[Error] commit not in todo.\" > \"/dev/stderr\"; exit 3 } print x; printf \"%s\", r }'\'' \"\$f\" > \"\$f.tmp\" && mv \"\$f.tmp\" \"\$f\"' _"
+GIT_SEQUENCE_EDITOR="$editor_cmd" git -C "$WF_TARGET_FOLDER" rebase -i "$lcp"
+
+# Sync selected patch to shared branch.
+git -C "$WF_SHARED_REPO_PATH" fetch "$WF_TARGET_FOLDER" "$WF_COMMIT_HASH"
+git -C "$WF_SHARED_REPO_PATH" cherry-pick FETCH_HEAD
+echo "[Status] Patch sink completed."

package/vendor/service-data/workflows/baseline-workflow/04-broadcast-shared-base.sh

@@ -0,0 +1,44 @@
+#!/bin/sh
+# Rebase target repos onto shared base head.
+wf require WF_SHARED_REPO_PATH
+wf require WF_TARGET_REPOS
+wf test is-git-repo "$WF_SHARED_REPO_PATH"
+
+shared_head=""
+handoff_file="$WF_SHARED_REPO_PATH/.cloverflow-last-shared-head"
+if [ -n "${WF_SHARED_HEAD_HINT:-}" ]; then
+  wf test is-git-commit "$WF_SHARED_REPO_PATH" "$WF_SHARED_HEAD_HINT"
+  shared_head="$WF_SHARED_HEAD_HINT"
+  echo "[Status] Broadcast uses pinned shared head from param: $shared_head"
+elif [ -f "$handoff_file" ]; then
+  candidate_head="$(awk 'NR==1 { print; exit }' "$handoff_file")"
+  if [ -n "$candidate_head" ] && git -C "$WF_SHARED_REPO_PATH" rev-parse --verify --quiet "$candidate_head^{commit}" >/dev/null 2>&1; then
+    shared_head="$candidate_head"
+    echo "[Status] Broadcast uses handoff shared head file: $shared_head"
+  fi
+fi
+
+if [ -z "$shared_head" ]; then
+  shared_head="$(git -C "$WF_SHARED_REPO_PATH" rev-parse HEAD)"
+  echo "[Status] Broadcast uses current shared head: $shared_head"
+fi
+
+# Validate all target repos first (fail fast before any mutation).
+printf '%s\n' "$WF_TARGET_REPOS" | while IFS= read -r repo_path; do
+  [ -z "$repo_path" ] && continue
+  [ "$repo_path" = "$WF_SHARED_REPO_PATH" ] && continue
+  wf test is-git-repo "$repo_path"
+done
+
+# Rebase each validated target repo onto shared base.
+printf '%s\n' "$WF_TARGET_REPOS" | while IFS= read -r repo_path; do
+  [ -z "$repo_path" ] && continue
+  [ "$repo_path" = "$WF_SHARED_REPO_PATH" ] && continue
+  git -C "$repo_path" fetch "$WF_SHARED_REPO_PATH" "$shared_head"
+  fetched_shared_head="$(git -C "$repo_path" rev-parse FETCH_HEAD)"
+  lcp="$(git -C "$repo_path" merge-base HEAD "$fetched_shared_head")"
+  [ "$lcp" = "$fetched_shared_head" ] && continue
+  git -C "$repo_path" rebase --onto "$fetched_shared_head" "$lcp"
+done
+
+echo "[Status] Shared base broadcast completed."

package/vendor/service-data/workflows/baseline-workflow/04-patch-broadcast.sh

@@ -0,0 +1,24 @@
+#!/bin/sh
+# Rebase target repos onto latest shared head.
+wf require WF_SHARED_REPO_PATH
+wf require WF_TARGET_REPOS
+wf test is-git-repo "$WF_SHARED_REPO_PATH"
+shared_head="$(git -C "$WF_SHARED_REPO_PATH" rev-parse HEAD)"
+
+# Validate all target repos first (fail fast before any mutation).
+for repo_path in $WF_TARGET_REPOS; do
+  [ "$repo_path" = "$WF_SHARED_REPO_PATH" ] && continue
+  wf test is-git-repo "$repo_path"
+done
+
+# Rebase each validated target repo onto shared latest base.
+for repo_path in $WF_TARGET_REPOS; do
+  [ "$repo_path" = "$WF_SHARED_REPO_PATH" ] && continue
+  git -C "$repo_path" fetch "$WF_SHARED_REPO_PATH" "$shared_head"
+  fetched_shared_head="$(git -C "$repo_path" rev-parse FETCH_HEAD)"
+  lcp="$(git -C "$repo_path" merge-base HEAD "$fetched_shared_head")"
+  [ "$lcp" = "$fetched_shared_head" ] && continue
+  git -C "$repo_path" rebase --onto "$fetched_shared_head" "$lcp"
+done
+
+echo "[Status] Broadcast completed."

package/vendor/service-data/workflows/baseline-workflow/05-squash-feature.sh

@@ -0,0 +1,18 @@
+#!/bin/sh
+wf require WF_TARGET_FOLDER
+wf require WF_SHARED_REPO_PATH
+echo "[Status] Squashing commits from source branch into shared as one commit..."
+wf test is-git-repo "$WF_TARGET_FOLDER"
+wf test is-git-repo "$WF_SHARED_REPO_PATH"
+shared_head="$(git -C "$WF_SHARED_REPO_PATH" rev-parse HEAD)"
+source_head="$(git -C "$WF_TARGET_FOLDER" rev-parse HEAD)"
+git -C "$WF_SHARED_REPO_PATH" fetch "$WF_TARGET_FOLDER" "$source_head"
+fetched_source_head="$(git -C "$WF_SHARED_REPO_PATH" rev-parse FETCH_HEAD)"
+commit_count="$(git -C "$WF_SHARED_REPO_PATH" rev-list --count "${shared_head}..${fetched_source_head}")"
+if [ "$commit_count" -lt 1 ]; then
+  echo "[Error] No commits after shared base to squash."
+  exit 1
+fi
+git -C "$WF_SHARED_REPO_PATH" merge --squash "$fetched_source_head"
+git -C "$WF_SHARED_REPO_PATH" commit -m "squash: from $(basename "$WF_TARGET_FOLDER") after shared base"
+echo "[Status] Shared squash commit created."

package/vendor/service-data/workflows/baseline-workflow/06-feature-retract.sh

@@ -0,0 +1,28 @@
+#!/bin/sh
+wf require WF_COMMIT_HASH
+wf require WF_SHARED_REPO_PATH
+echo "[Status] Dropping latest shared squash commit: $WF_COMMIT_HASH..."
+
+# Ensure shared repo and target commit are valid before any history operation.
+wf test is-git-repo "$WF_SHARED_REPO_PATH"
+wf test is-git-commit "$WF_SHARED_REPO_PATH" "$WF_COMMIT_HASH"
+
+# Step6 must revert the current shared HEAD produced by Step5.
+head_commit="$(git -C "$WF_SHARED_REPO_PATH" rev-parse HEAD)"
+if [ "$head_commit" != "$WF_COMMIT_HASH" ]; then
+  echo "[Error] WF_COMMIT_HASH must be current shared HEAD for retract."
+  exit 1
+fi
+
+# Guard against dropping arbitrary commits: only allow Step5 squash commit pattern.
+commit_subject="$(git -C "$WF_SHARED_REPO_PATH" log -1 --format=%s "$WF_COMMIT_HASH")"
+case "$commit_subject" in
+  squash:*)
+    ;;
+  *)
+    echo "[Error] commit is not a squash commit from Step5."
+    exit 1
+    ;;
+esac
+git -C "$WF_SHARED_REPO_PATH" reset --hard "$WF_COMMIT_HASH^"
+echo "[Status] Shared squash commit dropped."

package/vendor/service-data/workflows/baseline-workflow/06-merge-commit-feature.sh

@@ -0,0 +1,28 @@
+#!/bin/sh
+wf require WF_TARGET_FOLDER
+wf require WF_SHARED_REPO_PATH
+echo "[Status] Push target branch to shared, then merge --no-ff into shared HEAD..."
+wf test is-git-repo "$WF_TARGET_FOLDER"
+wf test is-git-repo "$WF_SHARED_REPO_PATH"
+shared_head="$(git -C "$WF_SHARED_REPO_PATH" rev-parse HEAD)"
+
+source_branch="$(git -C "$WF_TARGET_FOLDER" branch --show-current)"
+if [ -z "$source_branch" ]; then
+  echo "[Error] Target repo is detached; cannot push branch."
+  exit 1
+fi
+shared_branch="$(git -C "$WF_SHARED_REPO_PATH" branch --show-current)"
+if [ "$source_branch" = "$shared_branch" ]; then
+  echo "[Error] Target branch equals current shared branch; refusing to overwrite."
+  exit 1
+fi
+
+git -C "$WF_TARGET_FOLDER" push "$WF_SHARED_REPO_PATH" "HEAD:refs/heads/$source_branch"
+fetched_source_head="$(git -C "$WF_SHARED_REPO_PATH" rev-parse "$source_branch")"
+commit_count="$(git -C "$WF_SHARED_REPO_PATH" rev-list --count "${shared_head}..${fetched_source_head}")"
+if [ "$commit_count" -lt 1 ]; then
+  echo "[Error] No commits after shared base to merge."
+  exit 1
+fi
+git -C "$WF_SHARED_REPO_PATH" merge --no-ff "$fetched_source_head"
+echo "[Status] Shared merge commit created."

package/vendor/service-data/workflows/baseline-workflow/07-feature-retract.sh

@@ -0,0 +1,34 @@
+#!/bin/sh
+wf require WF_COMMIT_HASH
+wf require WF_SHARED_REPO_PATH
+echo "[Status] Retracting latest shared integration commit: $WF_COMMIT_HASH..."
+
+wf test is-git-repo "$WF_SHARED_REPO_PATH"
+wf test is-git-commit "$WF_SHARED_REPO_PATH" "$WF_COMMIT_HASH"
+
+head_commit="$(git -C "$WF_SHARED_REPO_PATH" rev-parse HEAD)"
+if [ "$head_commit" != "$WF_COMMIT_HASH" ]; then
+  echo "[Error] WF_COMMIT_HASH must be current shared HEAD for retract."
+  exit 1
+fi
+
+parent_line="$(git -C "$WF_SHARED_REPO_PATH" rev-list --parents -n 1 "$WF_COMMIT_HASH")"
+parent_count="$(printf '%s\n' "$parent_line" | awk '{print NF - 1}')"
+
+if [ "$parent_count" -ge 2 ]; then
+  git -C "$WF_SHARED_REPO_PATH" reset --hard "$WF_COMMIT_HASH^1"
+  echo "[Status] Shared merge commit dropped."
+  exit 0
+fi
+
+commit_subject="$(git -C "$WF_SHARED_REPO_PATH" log -1 --format=%s "$WF_COMMIT_HASH")"
+case "$commit_subject" in
+  squash:*)
+    git -C "$WF_SHARED_REPO_PATH" reset --hard "$WF_COMMIT_HASH^"
+    echo "[Status] Shared squash commit dropped."
+    ;;
+  *)
+    echo "[Error] commit is neither Step5 squash commit nor Step6 merge commit."
+    exit 1
+    ;;
+esac

package/vendor/service-data/workflows/baseline-workflow/07-rebase-origin.sh

@@ -0,0 +1,27 @@
+#!/bin/sh
+wf require WF_SHARED_REPO_PATH
+wf require WF_TARGET_REPOS
+echo "[Status] Rebasing shared onto origin/main, then rebasing non-shared repos onto shared..."
+
+# Validate all repos first (fail fast before any mutation).
+wf test is-git-repo "$WF_SHARED_REPO_PATH"
+for repo_path in $WF_TARGET_REPOS; do
+  [ "$repo_path" = "$WF_SHARED_REPO_PATH" ] && continue
+  wf test is-git-repo "$repo_path"
+done
+
+# Rebase shared repo to origin/main first.
+git -C "$WF_SHARED_REPO_PATH" fetch origin
+git -C "$WF_SHARED_REPO_PATH" rebase origin/main
+shared_head="$(git -C "$WF_SHARED_REPO_PATH" rev-parse HEAD)"
+
+# Rebase each target repo to the new shared base.
+for repo_path in $WF_TARGET_REPOS; do
+  [ "$repo_path" = "$WF_SHARED_REPO_PATH" ] && continue
+  git -C "$repo_path" fetch "$WF_SHARED_REPO_PATH" "$shared_head"
+  fetched_shared_head="$(git -C "$repo_path" rev-parse FETCH_HEAD)"
+  lcp="$(git -C "$repo_path" merge-base HEAD "$fetched_shared_head")"
+  [ "$lcp" = "$fetched_shared_head" ] && continue
+  git -C "$repo_path" rebase --onto "$fetched_shared_head" "$lcp"
+done
+echo "[Status] Shared and non-shared repos are rebased to latest base."

package/vendor/service-data/workflows/baseline-workflow/08-push-origin.sh

@@ -0,0 +1,5 @@
+#!/bin/sh
+wf test is-git-repo "."
+echo "[Status] Pushing shared branch to origin..."
+git push origin HEAD --force-with-lease
+echo "[Status] Push completed."

package/vendor/service-data/workflows/baseline-workflow/09-generate-patches.sh

@@ -0,0 +1,11 @@
+#!/bin/sh
+wf require WF_TARGET_FOLDER
+wf require WF_TARGET_REPO_PATH
+wf require WF_SHARED_REPO_PATH
+wf test is-git-repo "$WF_TARGET_REPO_PATH"
+wf test is-git-repo "$WF_SHARED_REPO_PATH"
+wf test is-path-exists "$WF_TARGET_FOLDER"
+echo "[Status] Generating exported patch files for $WF_TARGET_FOLDER..."
+mkdir -p "$WF_TARGET_REPO_PATH/patches_out"
+git -C "$WF_TARGET_REPO_PATH" format-patch -o "$WF_TARGET_REPO_PATH/patches_out/" -1 HEAD -- $WF_TARGET_FOLDER
+echo "[Status] Patch sequence generated."

package/vendor/service-data/workflows/baseline-workflow/profile.json

@@ -0,0 +1,196 @@
+{
+  "id": "baseline-workflow",
+  "name": "Baseline Workflow",
+  "nameI18n": {
+    "en-US": "Baseline Workflow",
+    "zh-CN": "基础工作流"
+  },
+  "description": "Default profile for daily Git operations with local shared-repo state and patch/feature handling.",
+  "descriptionI18n": {
+    "en-US": "Default profile for daily Git operations with local shared-repo state and patch/feature handling.",
+    "zh-CN": "用于日常 Git 操作的基础配置，包含共享仓库本地状态以及补丁/特性整理流程。"
+  },
+  "preflightScript": "00-preflight.sh",
+  "storageFields": [
+    {
+      "key": "repoPaths",
+      "type": "pathList",
+      "required": true,
+      "linkSource": "profileState",
+      "description": "Locally persisted repository folder paths used by this profile.",
+      "descriptionI18n": {
+        "en-US": "Locally persisted repository folder paths used by this profile.",
+        "zh-CN": "该 profile 在本地保存的仓库目录路径列表。"
+      }
+    },
+    {
+      "key": "lastTargetFolder",
+      "type": "path",
+      "required": false,
+      "description": "Last target folder used when running steps.",
+      "descriptionI18n": {
+        "en-US": "Last target folder used when running steps.",
+        "zh-CN": "上次执行步骤时使用的目标文件夹。"
+      }
+    },
+    {
+      "key": "sharedRepoPath",
+      "type": "path",
+      "required": true,
+      "description": "Shared source repository used as Step1 baseline.",
+      "descriptionI18n": {
+        "en-US": "Shared source repository used as Step1 baseline.",
+        "zh-CN": "Step1 使用的共享源仓库路径。"
+      }
+    },
+    {
+      "key": "lastSharedHead",
+      "type": "string",
+      "required": false,
+      "description": "Optional pinned shared HEAD used by broadcast step.",
+      "descriptionI18n": {
+        "en-US": "Optional pinned shared HEAD used by broadcast step.",
+        "zh-CN": "广播步骤使用的可选共享基线提交。"
+      }
+    }
+  ],
+  "steps": [
+    {
+      "id": "start-feature",
+      "name": "Start Feature",
+      "nameI18n": {
+        "en-US": "Start Feature",
+        "zh-CN": "创建特性分支"
+      },
+      "description": "Create feature branch and copy full snapshot from shared source repo.",
+      "descriptionI18n": {
+        "en-US": "Create feature branch and copy full snapshot from shared source repo.",
+        "zh-CN": "创建特性分支，并从共享源仓库全量复制快照。"
+      },
+      "paramBindings": [
+        {
+          "paramKey": "TARGET_FOLDER",
+          "storageKey": "lastTargetFolder",
+          "uiControl": "select",
+          "optionsFromStorageKey": "repoPaths",
+          "placeholderI18n": {
+            "en-US": "Select a target folder",
+            "zh-CN": "请选择目标目录"
+          }
+        },
+        {
+          "paramKey": "SHARED_REPO_PATH",
+          "storageKey": "sharedRepoPath",
+          "valueSource": "storageDirect"
+        }
+      ],
+      "script": "01-start-feature.sh"
+    },
+    {
+      "id": "select-minimal-patch",
+      "name": "Select Minimal Patch",
+      "nameI18n": {
+        "en-US": "Select Minimal Patch",
+        "zh-CN": "选定最小修复"
+      },
+      "descriptionI18n": {
+        "en-US": "Select commit hashes and squash them into the earliest one via rebase.",
+        "zh-CN": "输入 commit hash 列表，并在 rebase 中将它们压缩到最早提交。"
+      },
+      "paramBindings": [
+        {
+          "paramKey": "TARGET_FOLDER",
+          "storageKey": "lastTargetFolder",
+          "uiControl": "select",
+          "optionsFromStorageKey": "repoPaths",
+          "placeholderI18n": {
+            "en-US": "Select a target folder",
+            "zh-CN": "请选择目标目录"
+          }
+        }
+      ],
+      "script": "02-select-minimal-patch.sh"
+    },
+    {
+      "id": "patch-sink",
+      "name": "Patch Sink",
+      "nameI18n": {
+        "en-US": "Patch Sink",
+        "zh-CN": "补丁下沉"
+      },
+      "script": "03-patch-sink.sh"
+    },
+    {
+      "id": "broadcast-shared-base",
+      "name": "Broadcast Shared Base",
+      "nameI18n": {
+        "en-US": "Broadcast Shared Base",
+        "zh-CN": "共享基线分发"
+      },
+      "paramBindings": [
+        {
+          "paramKey": "SHARED_REPO_PATH",
+          "storageKey": "sharedRepoPath",
+          "valueSource": "storageDirect"
+        },
+        {
+          "paramKey": "TARGET_REPOS",
+          "storageKey": "repoPaths",
+          "valueSource": "storageDirect"
+        }
+      ],
+      "script": "04-broadcast-shared-base.sh"
+    },
+    {
+      "id": "squash-feature",
+      "name": "Squash Feature",
+      "nameI18n": {
+        "en-US": "Squash Feature",
+        "zh-CN": "特性收敛"
+      },
+      "paramBindings": [
+        {
+          "paramKey": "TARGET_FOLDER",
+          "storageKey": "lastTargetFolder",
+          "uiControl": "select",
+          "optionsFromStorageKey": "repoPaths",
+          "placeholderI18n": {
+            "en-US": "Select a target folder",
+            "zh-CN": "请选择目标目录"
+          }
+        }
+      ],
+      "script": "05-squash-feature.sh"
+    },
+    {
+      "id": "merge-commit-feature",
+      "name": "Merge Commit Feature",
+      "nameI18n": {
+        "en-US": "Merge Commit Feature",
+        "zh-CN": "特性合并提交"
+      },
+      "paramBindings": [
+        {
+          "paramKey": "TARGET_FOLDER",
+          "storageKey": "lastTargetFolder",
+          "uiControl": "select",
+          "optionsFromStorageKey": "repoPaths",
+          "placeholderI18n": {
+            "en-US": "Select a target folder",
+            "zh-CN": "请选择目标目录"
+          }
+        }
+      ],
+      "script": "06-merge-commit-feature.sh"
+    },
+    {
+      "id": "feature-retract",
+      "name": "Feature Retract",
+      "nameI18n": {
+        "en-US": "Feature Retract",
+        "zh-CN": "特性撤回"
+      },
+      "script": "07-feature-retract.sh"
+    }
+  ]
+}

package/vendor/service-data/workflows/commit-merge-split-lab/00-preflight.sh

@@ -0,0 +1,8 @@
+#!/bin/sh
+
+wf require WF_SHARED_REPO_PATH
+wf require WF_REPO_PATHS
+
+for repo in ${WF_REPO_PATHS}; do
+  wf test is-git-repo "${repo}"
+done

package/vendor/service-data/workflows/commit-merge-split-lab/01-show-recent-commits.sh

@@ -0,0 +1,3 @@
+#!/bin/sh
+echo "[Status] Recent commit history (latest 20):"
+git log --oneline -n 20

package/vendor/service-data/workflows/commit-merge-split-lab/02-merge-commits-in-range.sh

@@ -0,0 +1,5 @@
+#!/bin/sh
+wf require WF_BASE_REF
+echo "[Status] Starting interactive rebase from base: $WF_BASE_REF"
+echo "[Hint] Change 'pick' to 'squash'/'fixup' to merge commits as needed."
+git rebase -i "$WF_BASE_REF"

package/vendor/service-data/workflows/commit-merge-split-lab/03-split-commit-to-working-tree.sh

@@ -0,0 +1,6 @@
+#!/bin/sh
+wf require WF_SPLIT_COMMIT_HASH
+echo "[Status] Splitting commit: $WF_SPLIT_COMMIT_HASH"
+echo "[Hint] This resets target commit changes into working tree for manual split."
+git reset --mixed "$WF_SPLIT_COMMIT_HASH^"
+git status --short

package/vendor/service-data/workflows/commit-merge-split-lab/04-recommit-selected-path.sh

@@ -0,0 +1,6 @@
+#!/bin/sh
+wf require WF_TARGET_FOLDER
+wf require WF_COMMIT_MSG
+echo "[Status] Recommitting selected path: $WF_TARGET_FOLDER"
+git add "$WF_TARGET_FOLDER"
+git commit -m "$WF_COMMIT_MSG"

package/vendor/service-data/workflows/commit-merge-split-lab/05-continue-rewrite.sh

@@ -0,0 +1,3 @@
+#!/bin/sh
+echo "[Status] Continue history rewrite flow..."
+git rebase --continue

package/vendor/service-data/workflows/commit-merge-split-lab/profile.json

@@ -0,0 +1,80 @@
+{
+  "id": "commit-merge-split-lab",
+  "name": "Commit Merge and Split Lab",
+  "nameI18n": {
+    "en-US": "Commit Merge and Split Lab",
+    "zh-CN": "提交合并与分割实验室"
+  },
+  "descriptionI18n": {
+    "en-US": "Interactive profile for combining or splitting commits safely.",
+    "zh-CN": "用于交互式合并或分割提交的实验配置。"
+  },
+  "preflightScript": "00-preflight.sh",
+  "storageFields": [
+    {
+      "key": "lastRewriteBaseRef",
+      "type": "string",
+      "required": false,
+      "descriptionI18n": {
+        "en-US": "Last base ref used for interactive rebase.",
+        "zh-CN": "最近一次交互式 rebase 使用的基准引用。"
+      }
+    },
+    {
+      "key": "lastSplitCommitHash",
+      "type": "string",
+      "required": false,
+      "descriptionI18n": {
+        "en-US": "Last commit hash selected for split operation.",
+        "zh-CN": "最近一次用于分割的提交哈希。"
+      }
+    }
+  ],
+  "steps": [
+    {
+      "id": "show-recent-commits",
+      "name": "Show Recent Commits",
+      "nameI18n": {
+        "en-US": "Show Recent Commits",
+        "zh-CN": "查看最近提交"
+      },
+      "script": "01-show-recent-commits.sh"
+    },
+    {
+      "id": "merge-commits-in-range",
+      "name": "Merge Commits In Range",
+      "nameI18n": {
+        "en-US": "Merge Commits In Range",
+        "zh-CN": "范围内合并提交"
+      },
+      "script": "02-merge-commits-in-range.sh"
+    },
+    {
+      "id": "split-commit-to-working-tree",
+      "name": "Split Commit To Working Tree",
+      "nameI18n": {
+        "en-US": "Split Commit To Working Tree",
+        "zh-CN": "将提交拆回工作区"
+      },
+      "script": "03-split-commit-to-working-tree.sh"
+    },
+    {
+      "id": "recommit-selected-path",
+      "name": "Recommit Selected Path",
+      "nameI18n": {
+        "en-US": "Recommit Selected Path",
+        "zh-CN": "按路径重新提交"
+      },
+      "script": "04-recommit-selected-path.sh"
+    },
+    {
+      "id": "continue-rewrite",
+      "name": "Continue Rewrite",
+      "nameI18n": {
+        "en-US": "Continue Rewrite",
+        "zh-CN": "继续历史重写"
+      },
+      "script": "05-continue-rewrite.sh"
+    }
+  ]
+}

package/vendor/service-data/workflows/patch-export-for-review/00-preflight.sh

@@ -0,0 +1,8 @@
+#!/bin/sh
+
+wf require WF_SHARED_REPO_PATH
+wf require WF_REPO_PATHS
+
+for repo in ${WF_REPO_PATHS}; do
+  wf test is-git-repo "${repo}"
+done

package/vendor/service-data/workflows/patch-export-for-review/01-ensure-patch-out-dir.sh

@@ -0,0 +1,4 @@
+#!/bin/sh
+echo "[Status] Ensuring patch output directory exists..."
+mkdir -p patches_out
+echo "[Status] Output directory ready: patches_out"

package/vendor/service-data/workflows/patch-export-for-review/02-format-patch-by-folder.sh

@@ -0,0 +1,6 @@
+#!/bin/sh
+wf require WF_TARGET_FOLDER
+wf require WF_BASE_REF
+echo "[Status] Exporting patch set from $WF_BASE_REF for folder $WF_TARGET_FOLDER..."
+git format-patch "$WF_BASE_REF" -- "$WF_TARGET_FOLDER" -o patches_out/
+echo "[Status] Patch files exported to patches_out"

package/vendor/service-data/workflows/patch-export-for-review/03-list-generated-patches.sh

@@ -0,0 +1,7 @@
+#!/bin/sh
+echo "[Status] Listing generated patches..."
+if [ -d patches_out ]; then
+  ls -1 patches_out
+else
+  echo "[Warn] patches_out does not exist."
+fi

package/vendor/service-data/workflows/patch-export-for-review/profile.json

@@ -0,0 +1,62 @@
+{
+  "id": "patch-export-for-review",
+  "name": "Patch Export For Review",
+  "nameI18n": {
+    "en-US": "Patch Export For Review",
+    "zh-CN": "补丁导出评审"
+  },
+  "descriptionI18n": {
+    "en-US": "Export folder-scoped patch series for review or archival.",
+    "zh-CN": "按目录导出补丁序列，用于评审或归档。"
+  },
+  "preflightScript": "00-preflight.sh",
+  "storageFields": [
+    {
+      "key": "lastPatchBaseRef",
+      "type": "string",
+      "required": false,
+      "descriptionI18n": {
+        "en-US": "Most recently used base ref for format-patch.",
+        "zh-CN": "最近一次生成 patch 使用的基准引用。"
+      }
+    },
+    {
+      "key": "lastPatchTargetFolder",
+      "type": "path",
+      "required": false,
+      "descriptionI18n": {
+        "en-US": "Most recently exported target folder.",
+        "zh-CN": "最近一次导出补丁的目标目录。"
+      }
+    }
+  ],
+  "steps": [
+    {
+      "id": "ensure-patch-out-dir",
+      "name": "Ensure Patch Output Directory",
+      "nameI18n": {
+        "en-US": "Ensure Patch Output Directory",
+        "zh-CN": "准备补丁输出目录"
+      },
+      "script": "01-ensure-patch-out-dir.sh"
+    },
+    {
+      "id": "format-patch-by-folder",
+      "name": "Format Patch By Folder",
+      "nameI18n": {
+        "en-US": "Format Patch By Folder",
+        "zh-CN": "按目录导出补丁"
+      },
+      "script": "02-format-patch-by-folder.sh"
+    },
+    {
+      "id": "list-generated-patches",
+      "name": "List Generated Patches",
+      "nameI18n": {
+        "en-US": "List Generated Patches",
+        "zh-CN": "列出已生成补丁"
+      },
+      "script": "03-list-generated-patches.sh"
+    }
+  ]
+}

package/vendor/service-data/workflows/shared-origin-sync-workflow/00-preflight.sh

@@ -0,0 +1,17 @@
+#!/bin/sh
+
+wf require WF_SHARED_REPO_PATH
+wf test is-git-repo "$WF_SHARED_REPO_PATH"
+wf test is-git-detached "$WF_SHARED_REPO_PATH"
+wf test is-git-dirty "$WF_SHARED_REPO_PATH"
+
+if [ -n "${WF_REPO_PATHS:-}" ]; then
+  printf '%s\n' "$WF_REPO_PATHS" | while IFS= read -r repo; do
+    [ -z "$repo" ] && continue
+    if ! wf check is-git-repo "$repo"; then
+      continue
+    fi
+    wf test is-git-detached "$repo"
+    wf test is-git-dirty "$repo"
+  done
+fi

package/vendor/service-data/workflows/shared-origin-sync-workflow/01-sync-shared-origin.sh

@@ -0,0 +1,17 @@
+#!/bin/sh
+wf require WF_SHARED_REPO_PATH
+wf require WF_REMOTE_BASE_BRANCH
+echo "[Status] Syncing shared repo onto remote base branch..."
+wf test is-git-repo "$WF_SHARED_REPO_PATH"
+
+remote_branch="${WF_REMOTE_BASE_BRANCH:-main}"
+echo "[Status] Sync target remote branch: origin/$remote_branch"
+git -C "$WF_SHARED_REPO_PATH" fetch origin
+wf test is-git-commit "$WF_SHARED_REPO_PATH" "origin/$remote_branch"
+git -C "$WF_SHARED_REPO_PATH" rebase "origin/$remote_branch"
+
+shared_head="$(git -C "$WF_SHARED_REPO_PATH" rev-parse HEAD)"
+handoff_file="$WF_SHARED_REPO_PATH/.cloverflow-last-shared-head"
+printf '%s\n' "$shared_head" > "$handoff_file"
+echo "[Status] Shared repo synced to: $shared_head"
+echo "[Status] Handoff file updated: $handoff_file"

package/vendor/service-data/workflows/shared-origin-sync-workflow/02-push-origin.sh

@@ -0,0 +1,6 @@
+#!/bin/sh
+wf require WF_SHARED_REPO_PATH
+wf test is-git-repo "$WF_SHARED_REPO_PATH"
+echo "[Status] Pushing shared branch to origin..."
+git -C "$WF_SHARED_REPO_PATH" push origin HEAD --force-with-lease
+echo "[Status] Push completed."

package/vendor/service-data/workflows/shared-origin-sync-workflow/03-generate-patches.sh

@@ -0,0 +1,11 @@
+#!/bin/sh
+wf require WF_TARGET_FOLDER
+wf require WF_TARGET_REPO_PATH
+wf require WF_SHARED_REPO_PATH
+wf test is-git-repo "$WF_TARGET_REPO_PATH"
+wf test is-git-repo "$WF_SHARED_REPO_PATH"
+wf test is-path-exists "$WF_TARGET_FOLDER"
+echo "[Status] Generating exported patch files for $WF_TARGET_FOLDER..."
+mkdir -p "$WF_TARGET_REPO_PATH/patches_out"
+git -C "$WF_TARGET_REPO_PATH" format-patch -o "$WF_TARGET_REPO_PATH/patches_out/" -1 HEAD -- "$WF_TARGET_FOLDER"
+echo "[Status] Patch sequence generated."

package/vendor/service-data/workflows/shared-origin-sync-workflow/profile.json

@@ -0,0 +1,156 @@
+{
+  "id": "shared-origin-sync-workflow",
+  "name": "Shared Origin Sync Workflow",
+  "nameI18n": {
+    "en-US": "Shared Origin Sync Workflow",
+    "zh-CN": "共享远端同步工作流"
+  },
+  "description": "Profile for syncing shared repo with origin and handling remote push/export flow.",
+  "descriptionI18n": {
+    "en-US": "Profile for syncing shared repo with origin and handling remote push/export flow.",
+    "zh-CN": "用于同步共享仓库与 origin，并处理推送和补丁导出流程。"
+  },
+  "preflightScript": "00-preflight.sh",
+  "storageFields": [
+    {
+      "key": "repoPaths",
+      "type": "pathList",
+      "required": true,
+      "linkSource": "profileState",
+      "description": "Locally persisted repository folder paths used by this profile.",
+      "descriptionI18n": {
+        "en-US": "Locally persisted repository folder paths used by this profile.",
+        "zh-CN": "该 profile 在本地保存的仓库目录路径列表。"
+      }
+    },
+    {
+      "key": "lastTargetFolder",
+      "type": "path",
+      "required": false,
+      "description": "Last target folder used when running steps.",
+      "descriptionI18n": {
+        "en-US": "Last target folder used when running steps.",
+        "zh-CN": "上次执行步骤时使用的目标文件夹。"
+      }
+    },
+    {
+      "key": "lastTargetRepoPath",
+      "type": "path",
+      "required": false,
+      "description": "Last target repository path used by patch export.",
+      "descriptionI18n": {
+        "en-US": "Last target repository path used by patch export.",
+        "zh-CN": "补丁导出步骤最近使用的目标仓库路径。"
+      }
+    },
+    {
+      "key": "lastPatchScope",
+      "type": "string",
+      "required": false,
+      "description": "Last path scope used by patch export (for example: . or src/module).",
+      "descriptionI18n": {
+        "en-US": "Last path scope used by patch export (for example: . or src/module).",
+        "zh-CN": "补丁导出最近使用的路径范围（例如 . 或 src/module）。"
+      }
+    },
+    {
+      "key": "sharedRepoPath",
+      "type": "path",
+      "required": true,
+      "description": "Shared source repository used as baseline.",
+      "descriptionI18n": {
+        "en-US": "Shared source repository used as baseline.",
+        "zh-CN": "作为共享基线的共享源仓库路径。"
+      }
+    },
+    {
+      "key": "remoteBaseBranch",
+      "type": "string",
+      "required": false,
+      "description": "Remote base branch used for sync (default: main).",
+      "descriptionI18n": {
+        "en-US": "Remote base branch used for sync (default: main).",
+        "zh-CN": "同步使用的远端基线分支（默认 main）。"
+      }
+    },
+    {
+      "key": "lastSharedHead",
+      "type": "string",
+      "required": false,
+      "description": "Optional pinned shared HEAD for cross-profile handoff.",
+      "descriptionI18n": {
+        "en-US": "Optional pinned shared HEAD for cross-profile handoff.",
+        "zh-CN": "跨 profile 交接时可选记录的共享基线提交。"
+      }
+    }
+  ],
+  "steps": [
+    {
+      "id": "sync-shared-origin",
+      "name": "Sync Shared Origin",
+      "nameI18n": {
+        "en-US": "Sync Shared Origin",
+        "zh-CN": "同步共享基线"
+      },
+      "paramBindings": [
+        {
+          "paramKey": "SHARED_REPO_PATH",
+          "storageKey": "sharedRepoPath",
+          "valueSource": "storageDirect"
+        },
+        {
+          "paramKey": "REMOTE_BASE_BRANCH",
+          "storageKey": "remoteBaseBranch",
+          "valueSource": "storageDirect"
+        }
+      ],
+      "script": "01-sync-shared-origin.sh"
+    },
+    {
+      "id": "push-origin",
+      "name": "Push Origin",
+      "nameI18n": {
+        "en-US": "Push Origin",
+        "zh-CN": "推送提交"
+      },
+      "paramBindings": [
+        {
+          "paramKey": "SHARED_REPO_PATH",
+          "storageKey": "sharedRepoPath",
+          "valueSource": "storageDirect"
+        }
+      ],
+      "script": "02-push-origin.sh"
+    },
+    {
+      "id": "generate-patches",
+      "name": "Generate Patches",
+      "nameI18n": {
+        "en-US": "Generate Patches",
+        "zh-CN": "生成补丁"
+      },
+      "paramBindings": [
+        {
+          "paramKey": "TARGET_FOLDER",
+          "storageKey": "lastPatchScope"
+        },
+        {
+          "paramKey": "TARGET_REPO_PATH",
+          "storageKey": "lastTargetRepoPath",
+          "uiControl": "select",
+          "optionsFromStorageKey": "repoPaths",
+          "placeholderI18n": {
+            "en-US": "Select a target repository",
+            "zh-CN": "请选择目标仓库"
+          }
+        },
+        {
+          "paramKey": "SHARED_REPO_PATH",
+          "storageKey": "sharedRepoPath",
+          "valueSource": "storageDirect"
+        }
+      ],
+      "script": "03-generate-patches.sh"
+    }
+  ]
+}