@etavioxy/wocingflow-mcp-server 0.0.2 → 0.0.3

package/bin/wocingflow-mcp-server.js

@@ -1,200 +1,205 @@
-#!/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");
-
-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() {
-  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 wocingflow 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) {
-  const child = spawn(command, args, {
-    stdio: ["ignore", "pipe", "pipe"],
-    env,
-    shell: false,
-    windowsHide: true,
-  });
-  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) {
-  let command;
-  let args;
-  if (isWindows()) {
-    command = "cmd.exe";
-    args = ["/d", "/s", "/c", `npx -y mcp-remote@latest ${endpoint}`];
-  } else {
-    command = "npx";
-    args = ["-y", "mcp-remote@latest", endpoint];
-  }
-
-  const child = spawn(command, args, {
-    stdio: ["pipe", "pipe", "pipe"],
-    env,
-    shell: false,
-    windowsHide: true,
-  });
-
-  process.stdin.pipe(child.stdin);
-  child.stdout.pipe(process.stdout);
-  child.stderr.pipe(process.stderr);
-  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}`;
-  const serviceDataDir = resolveServiceDataDir();
-  const launch = resolveServerLaunch();
-
-  const backendEnv = { ...process.env };
-  if (serviceDataDir) {
-    backendEnv.WF_SERVICE_DATA_DIR = serviceDataDir;
-  }
-
-  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(`[wocingflow-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(`[wocingflow-mcp] ${error.message}`);
-  process.exit(1);
-});
+#!/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");
+
+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 wocingflow 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) {
+  const child = spawn(command, args, {
+    stdio: ["ignore", "pipe", "pipe"],
+    env,
+    shell: false,
+    windowsHide: true,
+  });
+  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) {
+  let command;
+  let args;
+  if (isWindows()) {
+    command = "cmd.exe";
+    args = ["/d", "/s", "/c", `npx -y mcp-remote@latest ${endpoint}`];
+  } else {
+    command = "npx";
+    args = ["-y", "mcp-remote@latest", endpoint];
+  }
+
+  const child = spawn(command, args, {
+    stdio: ["pipe", "pipe", "pipe"],
+    env,
+    shell: false,
+    windowsHide: true,
+  });
+
+  process.stdin.pipe(child.stdin);
+  child.stdout.pipe(process.stdout);
+  child.stderr.pipe(process.stderr);
+  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}`;
+  const serviceDataDir = resolveServiceDataDir();
+  const launch = resolveServerLaunch();
+
+  const backendEnv = { ...process.env };
+  if (serviceDataDir) {
+    backendEnv.WF_SERVICE_DATA_DIR = serviceDataDir;
+  }
+
+  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(`[wocingflow-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(`[wocingflow-mcp] ${error.message}`);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@etavioxy/wocingflow-mcp-server",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "MCP stdio launcher for WocingFlow service mcp_server",
   "type": "commonjs",
   "bin": {

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-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" cherry-pick --no-commit "${shared_head}..${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/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,215 @@
+{
+  "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 操作的基础配置，包含共享仓库本地状态以及补丁/特性整理流程。"
+  },
+  "storageFields": [
+    {
+      "key": "repoPaths",
+      "type": "stringList",
+      "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 使用的共享源仓库路径。"
+      }
+    }
+  ],
+  "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": "patch-broadcast",
+      "name": "Patch Broadcast",
+      "nameI18n": {
+        "en-US": "Patch Broadcast",
+        "zh-CN": "补丁分发"
+      },
+      "paramBindings": [
+        {
+          "paramKey": "SHARED_REPO_PATH",
+          "storageKey": "sharedRepoPath",
+          "valueSource": "storageDirect"
+        },
+        {
+          "paramKey": "TARGET_REPOS",
+          "storageKey": "repoPaths",
+          "valueSource": "storageDirect"
+        }
+      ],
+      "script": "04-patch-broadcast.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": "feature-retract",
+      "name": "Feature Retract",
+      "nameI18n": {
+        "en-US": "Feature Retract",
+        "zh-CN": "特性撤回"
+      },
+      "script": "06-feature-retract.sh"
+    },
+    {
+      "id": "rebase-origin",
+      "name": "Rebase Origin",
+      "nameI18n": {
+        "en-US": "Rebase Origin",
+        "zh-CN": "同步远端基线"
+      },
+      "paramBindings": [
+        {
+          "paramKey": "SHARED_REPO_PATH",
+          "storageKey": "sharedRepoPath",
+          "valueSource": "storageDirect"
+        },
+        {
+          "paramKey": "TARGET_REPOS",
+          "storageKey": "repoPaths",
+          "valueSource": "storageDirect"
+        }
+      ],
+      "script": "07-rebase-origin.sh"
+    },
+    {
+      "id": "push-origin",
+      "name": "Push Origin",
+      "nameI18n": {
+        "en-US": "Push Origin",
+        "zh-CN": "推送提交"
+      },
+      "script": "08-push-origin.sh"
+    },
+    {
+      "id": "generate-patches",
+      "name": "Generate Patches",
+      "nameI18n": {
+        "en-US": "Generate Patches",
+        "zh-CN": "生成补丁"
+      },
+      "paramBindings": [
+        {
+          "paramKey": "TARGET_FOLDER",
+          "storageKey": "lastTargetFolder",
+          "uiControl": "select",
+          "optionsFromStorageKey": "repoPaths",
+          "placeholderI18n": {
+            "en-US": "Select a target folder",
+            "zh-CN": "请选择目标目录"
+          }
+        }
+      ],
+      "script": "09-generate-patches.sh"
+    }
+  ]
+}

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,79 @@
+{
+  "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": "用于交互式合并或分割提交的实验配置。"
+  },
+  "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/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,61 @@
+{
+  "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": "按目录导出补丁序列，用于评审或归档。"
+  },
+  "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"
+    }
+  ]
+}