@mawaru/sdk 0.23.0 → 0.25.0

package/_schemas/graph.test.ts

@@ -160,17 +160,25 @@ describe("aiConfigSchema", () => {
 })
 
 describe("humanConfigSchema", () => {
-  it("既定値を補う（fixed・any・units 空＝tenant の誰でも）", () => {
-    expect(humanConfigSchema.parse({ assignment: {} })).toEqual({
-      assignment: { strategy: "fixed", approval_mode: "any", units: [] },
+  it("strategy / approval_mode の既定値を補う（fixed・any）", () => {
+    const u1 = uuid()
+    expect(humanConfigSchema.parse({ assignment: { units: [[u1]] } })).toEqual({
+      assignment: { strategy: "fixed", approval_mode: "any", units: [[u1]] },
     })
   })
 
+  it("担当なし（units 空・省略）を拒否する（「誰でも」は無い）", () => {
+    expect(() => humanConfigSchema.parse({ assignment: {} })).toThrow()
+    expect(() =>
+      humanConfigSchema.parse({ assignment: { units: [] } }),
+    ).toThrow(/担当/)
+  })
+
   // 承認ビューは不透明なキー（program_dir / ai_dir と同じ）。実在するか・そのテナントが
   // 選べるかは mawaru 側のカタログ（非公開）と保存 API が見るので、ここは形だけ
   it("承認ビューを受け付ける", () => {
     const parsed = humanConfigSchema.parse({
-      assignment: {},
+      assignment: { units: [[uuid()]] },
       view: "acme/invoice",
     })
     expect(parsed.view).toBe("acme/invoice")
@@ -178,7 +186,7 @@ describe("humanConfigSchema", () => {
 
   it("空のビューキーは拒否する", () => {
     expect(() =>
-      humanConfigSchema.parse({ assignment: {}, view: "" }),
+      humanConfigSchema.parse({ assignment: { units: [[uuid()]] }, view: "" }),
     ).toThrow()
   })
 
@@ -513,6 +521,8 @@ const humanNode = () => ({
     port("out", "reject"),
   ]),
   kind: "human" as const,
+  // 担当は必須（「担当なし＝誰でも」は無い）
+  human: { assignment: { units: [[uuid()]] } },
 })
 const aiNode = () => ({
   ...makeNode([
@@ -538,6 +548,13 @@ const outByKey = (node: TestNode, key: string): GraphPort => {
 }
 
 describe("saveGraphBodySchema（kind 別ポート構成）", () => {
+  it("human の担当なし（human 設定の省略）を拒否する", () => {
+    const { human: _human, ...noAssign } = humanNode()
+    expect(() =>
+      saveGraphBodySchema.parse({ nodes: [noAssign], connections: [] }),
+    ).toThrow(/担当/)
+  })
+
   it("human の旧 ok/ng 構成を拒否し、in/approve/reject を受け付ける", () => {
     expect(() =>
       saveGraphBodySchema.parse({ nodes: [humanNode()], connections: [] }),

package/_schemas/graph.ts

@@ -135,7 +135,8 @@ export type AssignMember = z.infer<typeof assignMemberSchema>
 
 // Human ノードの kind 別設定（node_humans ＋ node_human_assignees に対応）。
 // 担当 ＝ ユニット（1人以上のメンバー）の順序付きリスト ＋ 承認モード ＋ 選出戦略。
-// units[i] はメンバーの配列（1人＝個人・複数＝グループ）。units 空 = tenant の誰でも。
+// units[i] はメンバーの配列（1人＝個人・複数＝グループ）。**担当は必ず明示する**
+// （「担当なし＝tenant の誰でも」は無い。Human担当の必須化（誰でもの廃止）.md）。
 // approval_mode はノード単位（any=誰か1人 / all=全員。差し戻しは1人で成立＝veto）。
 // メンバーが tenant の membership であることの検証は保存 API 側で行う
 // （docs/tasks/backlog/Human担当者の高度化（複数人承認とラウンドロビン）.md）
@@ -148,7 +149,9 @@ export const humanConfigSchema = z.object({
     .object({
       strategy: z.enum(["fixed", "round_robin"]).default("fixed"),
       approval_mode: z.enum(["any", "all"]).default("any"),
-      units: z.array(z.array(assignMemberSchema).min(1)).default([]),
+      units: z
+        .array(z.array(assignMemberSchema).min(1))
+        .min(1, "担当を1人以上指定してください"),
     })
     .superRefine((assignment, ctx) => {
       if (assignment.strategy === "fixed" && assignment.units.length > 1) {
@@ -199,6 +202,9 @@ export type HumanConfig = z.infer<typeof humanConfigSchema>
 // （docs/tasks/done/コンポーネント（ループの部品化と再利用）.md）
 export const componentConfigSchema = z.object({
   component_loop_id: z.uuid(),
+  // 親が pin する子の版。省略＝子の最新 published（グループは owner の draft と対）。
+  // 版管理（draftとpublish）.md
+  component_loop_version_id: z.uuid().optional(),
   // 配置の設定値：子 loop の refs 定義（default/required）への上書き。
   // 子 run 起動時の起動時指定として渡る（省略＝上書きなし。検証は保存 API と
   // 起動時の mergeRefs が行う。コンポーネントの設定値（refs）と1ノードのコンポーネント化.md）
@@ -259,7 +265,10 @@ export const NODE_ICON_PRESETS = [
 export type NodeIconPresetKey = (typeof NODE_ICON_PRESETS)[number]["key"]
 
 export const graphNodeSchema = z.object({
+  // 版の行 id（新規ノードは client 採番）。既存ノードの突き合わせは node_key で行う
   id: z.uuid(),
+  // 版を跨いだ「同一ノード」の識別子。省略＝新規ノード（サーバーが発行）
+  node_key: z.uuid().optional(),
   kind: graphNodeKindSchema,
   name: z.string().min(1),
   ports: z.array(graphPortSchema),
@@ -397,6 +406,16 @@ export const saveGraphBodySchema = z
         hookDirs.add(hook.hook_dir)
       })
 
+      // human は担当を必ず明示する（「担当なし＝tenant の誰でも」は無い。
+      // Human担当の必須化（誰でもの廃止）.md）
+      if (node.kind === "human" && node.human === undefined) {
+        ctx.addIssue({
+          code: "custom",
+          path: ["nodes", i, "human"],
+          message: "human ノードには担当（assignment.units）が必要です",
+        })
+      }
+
       // component は参照先が無いと成立しない（他 kind の設定はデフォルトで補えるが
       // component_loop_id は補えない）
       if (node.kind === "component" && node.component === undefined) {

package/dist/_schemas/graph.d.ts

@@ -58,12 +58,13 @@ export declare const humanConfigSchema: z.ZodObject<{
             any: "any";
             all: "all";
         }>>;
-        units: z.ZodDefault<z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodUUID, z.ZodLiteral<"run_starter">]>>>>;
+        units: z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodUUID, z.ZodLiteral<"run_starter">]>>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type HumanConfig = z.infer<typeof humanConfigSchema>;
 export declare const componentConfigSchema: z.ZodObject<{
     component_loop_id: z.ZodUUID;
+    component_loop_version_id: z.ZodOptional<z.ZodUUID>;
     refs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 export type ComponentConfig = z.infer<typeof componentConfigSchema>;
@@ -126,6 +127,7 @@ export declare const NODE_ICON_PRESETS: readonly [{
 export type NodeIconPresetKey = (typeof NODE_ICON_PRESETS)[number]["key"];
 export declare const graphNodeSchema: z.ZodObject<{
     id: z.ZodUUID;
+    node_key: z.ZodOptional<z.ZodUUID>;
     kind: z.ZodEnum<{
         start: "start";
         ai: "ai";
@@ -197,11 +199,12 @@ export declare const graphNodeSchema: z.ZodObject<{
                 any: "any";
                 all: "all";
             }>>;
-            units: z.ZodDefault<z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodUUID, z.ZodLiteral<"run_starter">]>>>>;
+            units: z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodUUID, z.ZodLiteral<"run_starter">]>>>;
         }, z.core.$strip>;
     }, z.core.$strip>>;
     component: z.ZodOptional<z.ZodObject<{
         component_loop_id: z.ZodUUID;
+        component_loop_version_id: z.ZodOptional<z.ZodUUID>;
         refs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -223,6 +226,7 @@ export type GraphConnection = z.infer<typeof graphConnectionSchema>;
 export declare const saveGraphBodySchema: z.ZodObject<{
     nodes: z.ZodArray<z.ZodObject<{
         id: z.ZodUUID;
+        node_key: z.ZodOptional<z.ZodUUID>;
         kind: z.ZodEnum<{
             start: "start";
             ai: "ai";
@@ -294,11 +298,12 @@ export declare const saveGraphBodySchema: z.ZodObject<{
                     any: "any";
                     all: "all";
                 }>>;
-                units: z.ZodDefault<z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodUUID, z.ZodLiteral<"run_starter">]>>>>;
+                units: z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodUUID, z.ZodLiteral<"run_starter">]>>>;
             }, z.core.$strip>;
         }, z.core.$strip>>;
         component: z.ZodOptional<z.ZodObject<{
             component_loop_id: z.ZodUUID;
+            component_loop_version_id: z.ZodOptional<z.ZodUUID>;
             refs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;

package/dist/_schemas/graph.js

@@ -96,7 +96,8 @@ export const RUN_STARTER = "run_starter";
 export const assignMemberSchema = z.union([z.uuid(), z.literal(RUN_STARTER)]);
 // Human ノードの kind 別設定（node_humans ＋ node_human_assignees に対応）。
 // 担当 ＝ ユニット（1人以上のメンバー）の順序付きリスト ＋ 承認モード ＋ 選出戦略。
-// units[i] はメンバーの配列（1人＝個人・複数＝グループ）。units 空 = tenant の誰でも。
+// units[i] はメンバーの配列（1人＝個人・複数＝グループ）。**担当は必ず明示する**
+// （「担当なし＝tenant の誰でも」は無い。Human担当の必須化（誰でもの廃止）.md）。
 // approval_mode はノード単位（any=誰か1人 / all=全員。差し戻しは1人で成立＝veto）。
 // メンバーが tenant の membership であることの検証は保存 API 側で行う
 // （docs/tasks/backlog/Human担当者の高度化（複数人承認とラウンドロビン）.md）
@@ -109,7 +110,9 @@ export const humanConfigSchema = z.object({
         .object({
         strategy: z.enum(["fixed", "round_robin"]).default("fixed"),
         approval_mode: z.enum(["any", "all"]).default("any"),
-        units: z.array(z.array(assignMemberSchema).min(1)).default([]),
+        units: z
+            .array(z.array(assignMemberSchema).min(1))
+            .min(1, "担当を1人以上指定してください"),
     })
         .superRefine((assignment, ctx) => {
         if (assignment.strategy === "fixed" && assignment.units.length > 1) {
@@ -154,6 +157,9 @@ export const humanConfigSchema = z.object({
 // （docs/tasks/done/コンポーネント（ループの部品化と再利用）.md）
 export const componentConfigSchema = z.object({
     component_loop_id: z.uuid(),
+    // 親が pin する子の版。省略＝子の最新 published（グループは owner の draft と対）。
+    // 版管理（draftとpublish）.md
+    component_loop_version_id: z.uuid().optional(),
     // 配置の設定値：子 loop の refs 定義（default/required）への上書き。
     // 子 run 起動時の起動時指定として渡る（省略＝上書きなし。検証は保存 API と
     // 起動時の mergeRefs が行う。コンポーネントの設定値（refs）と1ノードのコンポーネント化.md）
@@ -203,7 +209,10 @@ export const NODE_ICON_PRESETS = [
     { key: "sentry", name: "Sentry" },
 ];
 export const graphNodeSchema = z.object({
+    // 版の行 id（新規ノードは client 採番）。既存ノードの突き合わせは node_key で行う
     id: z.uuid(),
+    // 版を跨いだ「同一ノード」の識別子。省略＝新規ノード（サーバーが発行）
+    node_key: z.uuid().optional(),
     kind: graphNodeKindSchema,
     name: z.string().min(1),
     ports: z.array(graphPortSchema),
@@ -329,6 +338,15 @@ export const saveGraphBodySchema = z
             }
             hookDirs.add(hook.hook_dir);
         });
+        // human は担当を必ず明示する（「担当なし＝tenant の誰でも」は無い。
+        // Human担当の必須化（誰でもの廃止）.md）
+        if (node.kind === "human" && node.human === undefined) {
+            ctx.addIssue({
+                code: "custom",
+                path: ["nodes", i, "human"],
+                message: "human ノードには担当（assignment.units）が必要です",
+            });
+        }
         // component は参照先が無いと成立しない（他 kind の設定はデフォルトで補えるが
         // component_loop_id は補えない）
         if (node.kind === "component" && node.component === undefined) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mawaru/sdk",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "description": "mawaru 実行 repo の開発 SDK。契約スキーマ（config.json 規約・ループ graph API）の正 ＋ typegen / validate CLI",
   "type": "module",
   "bin": {