chore: add three-branch parity baseline

Author: loong10k

scripts/check-branch-parity.sh

@@ -0,0 +1,32 @@
+#!/bin/sh
+set -eu
+
+ROOT="$(git rev-parse --show-toplevel)"
+TMP="$(mktemp -d)"
+trap 'rm -rf "$TMP"' EXIT
+
+git fetch --no-tags origin \
+  feature/1.0.x:refs/remotes/origin/feature/1.0.x \
+  feature/2.0.x:refs/remotes/origin/feature/2.0.x \
+  feature/3.0.x:refs/remotes/origin/feature/3.0.x
+
+extract_branch() {
+  ref="$1"
+  dir="$2"
+  mkdir -p "$TMP/$dir"
+  git archive --format=tar "$ref" src/main/java src/test/java src/test/resources/comfy-parity-manifest.json \
+    | tar -xf - -C "$TMP/$dir"
+  find "$TMP/$dir" -type f -name '*.java' -print | while IFS= read -r file; do
+    sed 's/tools\.jackson/com.fasterxml.jackson/g' "$file" > "$file.norm"
+    mv "$file.norm" "$file"
+  done
+}
+
+extract_branch origin/feature/1.0.x b1
+extract_branch origin/feature/2.0.x b2
+extract_branch origin/feature/3.0.x b3
+
+diff -ru "$TMP/b1/src" "$TMP/b2/src"
+diff -ru "$TMP/b2/src" "$TMP/b3/src"
+
+echo "three-branch source and capability parity: OK"

src/main/java/io/github/easy4j/comfy/ComfyClient.java

@@ -25,7 +25,7 @@
  */
 public class ComfyClient implements AutoCloseable {
 
-    private static final JsonMapper MAPPER = new JsonMapper();
+    private static final JsonMapper MAPPER = JsonMapper.builder().build();
 
     private final ComfyClientConfig config;
     private final ComfyCli cli;

src/main/java/io/github/easy4j/comfy/cli/ComfyCliStreamExecutor.java

@@ -30,7 +30,7 @@
  */
 public final class ComfyCliStreamExecutor {
     private final ComfyClientConfig config;
-    private final ObjectMapper mapper = new JsonMapper();
+    private final ObjectMapper mapper = JsonMapper.builder().build();
 
     public ComfyCliStreamExecutor(ComfyClientConfig config) {
         this.config = Objects.requireNonNull(config, "config");

src/test/resources/comfy-parity-manifest.json

@@ -0,0 +1,39 @@
+{
+  "schema": "comfy-java-sdk-parity/1",
+  "reviewedAt": "2026-09-20",
+  "cliSource": "Comfy-Org/comfy-cli@b08adc50cca24f2d29d2115e80719cb8299e6ddf",
+  "mcpSource": "Comfy-Org/comfy-mcp@e5f768d31de21ea32829381cebdda5336492a8ac",
+  "branches": ["feature/1.0.x", "feature/2.0.x", "feature/3.0.x"],
+  "cliFamilies": [
+    "setup","install","update","outdated","launch","stop","logs","run","validate",
+    "upload","download","system-stats","free","which","env","discover","set-default",
+    "generate","run-template","preview","jobs","templates","workflow","node","nodes",
+    "model","models","cloud","auth","project","assets","knowledge","build","deploy",
+    "agent","manager","pr-cache","code-search","tracking","skills","feedback",
+    "agent-review","dependency","standalone"
+  ],
+  "mcpTools": [
+    "server_info","auth_status","billing_status","auth_login","run_workflow",
+    "generate_image","list_partner_models","partner_model_schema","partner_generate",
+    "emit_partner_workflow","run_template","job","system_stats","free_memory",
+    "fetch_outputs","launch_comfyui","stop_comfyui","restart_comfyui","update_comfyui",
+    "switch_comfyui_version","install_node","get_logs","discover","which","project",
+    "search_templates","get_template","fetch_template","nodes","node_dependencies",
+    "workflow_deps","search_models","download_model","download","upload_file",
+    "validate_workflow","list_workflow_slots","list_workflow_notes","set_workflow_slot",
+    "vary_workflow"
+  ],
+  "skillsOperations": ["install","uninstall","list","show","status","validate"],
+  "invariants": [
+    "shell-free argv execution",
+    "independent probe timeout",
+    "bounded stdout/stderr",
+    "streaming NDJSON API",
+    "bounded MCP frame/content/stderr",
+    "pending RPC cleanup on every terminal path",
+    "notification/progress delivery",
+    "optional elicitation capability",
+    "deterministic process/thread/timer cleanup",
+    "real JaCoCo gate"
+  ]
+}