@g1cloud/bpmn-modeler-next 5.0.0-alpha.1 → 5.0.0-alpha.3

package/dist/agent/resolver/issues.d.ts

@@ -6,8 +6,23 @@
  * `opIndex` 는 배치 내 위치(0-기준) — 어느 op 가 문제인지 LLM 에게 되짚어 준다.
  */
 export type ResolveIssue = 
-/** 신규 id 가 XML NCName 규칙 위반 (선두 숫자·콜론·공백 등) */
+/**
+ * op 의 필수 페이로드가 없거나 타입이 어긋남 (`field` = 점 경로, 배열 원소는 `lanes[0].id` 형태).
+ *
+ * 구조 검증은 본래 JSON Schema(M2-1) 몫이지만 **그 검증을 강제하는 층이 실재하지 않는다** —
+ * 호스트 라우트는 `body.ops as SymbolicOp[]` 로 캐스트만 하고(시블 uiModelV2 도 동형), 스키마는
+ * 에이전트에게 *보여주는* 계약일 뿐 서버가 집행하지 않는다. 그 상태로 `op.participant.id` 를 읽으면
+ * TypeError 가 하강 밖으로 새어 500 이 되고, LLM 은 교정 단서 대신 스택트레이스를 받는다
+ * (M4 ⑥ 실측). 그래서 validator 가 **자기방어**한다 — 의미 검증 이전에 최소 shape 을 확인해
+ * 구조화 issue 로 떨어뜨린다(수용 기준 "resolve 실패는 throw 가 아닌 구조화 결과").
+ */
 {
+    kind: 'payload-invalid';
+    opIndex: number;
+    field: string;
+}
+/** 신규 id 가 XML NCName 규칙 위반 (선두 숫자·콜론·공백 등) */
+ | {
     kind: 'id-invalid';
     opIndex: number;
     id: string;