From 4c20d44e6bb2260bba97ebd09e4cc17e2253f031 Mon Sep 17 00:00:00 2001
From: dante01yoon <bunggl@naver.com>
Date: Wed, 13 May 2026 12:46:46 +0900
Subject: [PATCH] docs(validation): convert zLinearInput comment to JSDoc

---
 .../validation/schemas/workflowSchema.ts      | 20 +++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/src/platform/workflow/validation/schemas/workflowSchema.ts b/src/platform/workflow/validation/schemas/workflowSchema.ts
index 186e1ba0a8..485ae995d5 100644
--- a/src/platform/workflow/validation/schemas/workflowSchema.ts
+++ b/src/platform/workflow/validation/schemas/workflowSchema.ts
@@ -286,14 +286,18 @@ const zLinearInputConfig = z
   .object({ height: z.number().optional() })
   .passthrough()
 
-// Permissive parser for a single `linearData.inputs` entry.
-// Stored shapes seen in the wild (legacy clients, forks, future fields):
-//   [nodeId, name]
-//   [nodeId, name, { height? }]
-//   [nodeId, name, <number>]        — legacy: raw height
-//   [nodeId, name, <anything else>] — unknown trailing data
-// Reject only entries that don't start with [nodeId, string]; normalize
-// the rest so a single bad entry doesn't fail the whole workflow load.
+/**
+ * Permissive parser for a single `linearData.inputs` entry.
+ *
+ * Stored shapes seen in the wild (legacy clients, forks, future fields):
+ * - `[nodeId, name]`
+ * - `[nodeId, name, { height? }]`
+ * - `[nodeId, name, <number>]` — legacy: raw height
+ * - `[nodeId, name, <anything else>]` — unknown trailing data
+ *
+ * Rejects only entries that don't start with `[nodeId, string]`; normalizes
+ * the rest so a single bad entry doesn't fail the whole workflow load.
+ */
 const zLinearInput = z
   .tuple([zNodeId, z.string()])
   .rest(z.unknown())