feat(test-suite): warn user when selecting services that share a database

Author: PanGan21

test-suite/fhevm/README.md

@@ -180,6 +180,11 @@ Use the short service suffix after the colon (e.g., `host-listener` not `coproce
 Multiple services are comma-separated. Services that share a Docker image are automatically
 co-selected (e.g., `host-listener` includes `host-listener-poller`).
 
+> **Note:** `coprocessor` and `kms-connector` services share a database. Per-service overrides
+> work when your local changes don't include DB migrations. If your changes add or alter
+> migrations, non-overridden services will fail against the mismatched schema — use
+> `--override coprocessor` (full group) instead.
+
 Available suffixes per group:
 
 | Group | Suffixes |

test-suite/fhevm/src/layout.ts

@@ -125,6 +125,9 @@ for (const group of SIBLING_GROUPS) {
   }
 }
 
+/** Groups where all services share a database — per-service override requires schema compatibility. */
+export const SCHEMA_COUPLED_GROUPS: OverrideGroup[] = ["coprocessor", "kms-connector"];
+
 export const suffixToServiceName = (group: OverrideGroup, suffix: string): string => {
   const fullName = GROUP_PREFIX[group] + suffix;
   if (!GROUP_BUILD_SERVICES[group].includes(fullName)) {

test-suite/fhevm/src/runtime.ts

@@ -17,6 +17,7 @@ import {
   COMPONENT_BY_STEP,
   COMPONENTS,
   GROUP_SERVICE_SUFFIXES,
+  SCHEMA_COUPLED_GROUPS,
   LOCK_DIR,
   LOG_TARGETS,
   PORTS,
@@ -615,6 +616,15 @@ const printPlan = (state: Pick<State, "target" | "overrides" | "topology">, from
   log(`[plan] target=${state.target}`);
   if (state.overrides.length) {
     log(`[plan] overrides=${state.overrides.map(describeOverride).join(", ")}`);
+    for (const o of state.overrides) {
+      if (o.services?.length && SCHEMA_COUPLED_GROUPS.includes(o.group)) {
+        log(
+          `[warn] ${o.group}: per-service override with a shared database. ` +
+            `If your changes include DB migrations, non-overridden services may fail. ` +
+            `Use --override ${o.group} (full group) in that case.`,
+        );
+      }
+    }
   }
   log(`[plan] topology=n${state.topology.count}/t${state.topology.threshold}`);
   log(`[plan] steps=${STEP_NAMES.slice(stateStepIndex(fromStep ?? STEP_NAMES[0])).join(" -> ")}`);