@mawaru/sdk 0.31.0 → 0.32.0

package/_schemas/graph.test.ts

@@ -548,6 +548,14 @@ const outByKey = (node: TestNode, key: string): GraphPort => {
 }
 
 describe("saveGraphBodySchema（kind 別ポート構成）", () => {
+  it("human の追加出口を保存できる", () => {
+    const human = humanNode()
+    human.ports.push(port("out", "notion_task"))
+    expect(() =>
+      saveGraphBodySchema.parse({ nodes: [human], connections: [] }),
+    ).not.toThrow()
+  })
+
   it("human の担当なし（human 設定の省略）を拒否する", () => {
     const { human: _human, ...noAssign } = humanNode()
     expect(() =>

package/_schemas/port-spec.test.ts

@@ -90,7 +90,26 @@ describe("kindPortsViolation（kind 別ポート構成）", () => {
     ).toBeNull()
   })
 
-  it("human は in / approve / reject 固定", () => {
+  it("human は追加の出口を持てるが基本ポートは必須", () => {
+    const ports = [
+      port("in", "in"),
+      port("out", "approve"),
+      port("out", "reject"),
+      port("out", "notion_task"),
+    ]
+    expect(kindPortsViolation("human", ports)).toBeNull()
+    expect(
+      kindPortsViolation(
+        "human",
+        ports.filter((p) => p.key !== "reject"),
+      ),
+    ).toMatch(/human/)
+    expect(
+      kindPortsViolation("human", [...ports, port("in", "extra")]),
+    ).toMatch(/human/)
+  })
+
+  it("human は in / approve / reject を持つ", () => {
     expect(
       kindPortsViolation("human", [
         port("in", "in"),
@@ -132,6 +151,35 @@ describe("kindPortsViolation（kind 別ポート構成）", () => {
 })
 
 describe("型伝播（導出ポートの解決）", () => {
+  it.each([
+    "notion_task",
+    "main",
+  ])("Humanの追加出口 %s の宣言型は承認ビューの型で上書きしない", (key) => {
+    const extra = port("out", key, {
+      type: "object",
+      properties: { title: { type: "string" } },
+      required: ["title"],
+    })
+    const human = {
+      id: uuid(),
+      kind: "human",
+      ports: [
+        port("in", "in"),
+        port("out", "approve"),
+        port("out", "reject"),
+        extra,
+      ],
+    }
+    const resolved = resolvePortSchemas([human], [], {
+      viewPortSchemasOf: () => ({
+        in: { type: "string" },
+        approve: { type: "string" },
+        reject: { type: "string" },
+      }),
+    })
+    expect(resolved.get(extra.id)).toEqual(extra.schema)
+  })
+
   // 伝播テスト用の任意の宣言型（中身の形に意味はない）
   const declaredOut = {
     type: "object",

package/_schemas/port-spec.ts

@@ -139,11 +139,10 @@ export const dataFormatOf = (schema: JsonSchema): DataFormat | null => {
 }
 
 // ---- kind 別ポート構成 ----
-// human / wait は構成（数・key・io）が固定。program / ai は in 1つ＋out 1つ以上
+// wait は構成が固定。human は基本ポートを保ち追加 out を持てる。program / ai は out 自由
 // （key 自由。複数 out＝分岐。AIノードの複数出口（分岐）.md）
 
 const FIXED_PORT_KEYS: Record<string, { in: string[]; out: string[] }> = {
-  human: { in: ["in"], out: ["approve", "reject"] },
   wait: { in: ["in"], out: ["main"] },
   // start は in 1つ（run 入力契約）＋ out main 1つの恒等パススルー
   start: { in: ["in"], out: ["main"] },
@@ -199,6 +198,19 @@ export const kindPortsViolation = (
     }
     return null
   }
+  if (kind === "human") {
+    const inKeys = ports.filter((p) => p.io === "in").map((p) => p.key)
+    const outKeys = ports.filter((p) => p.io === "out").map((p) => p.key)
+    if (
+      inKeys.length !== 1 ||
+      inKeys[0] !== "in" ||
+      !outKeys.includes("approve") ||
+      !outKeys.includes("reject")
+    ) {
+      return "human のポート構成は in(in) と out(approve / reject) が必須です（out は追加できます）"
+    }
+    return null
+  }
   const fixed = FIXED_PORT_KEYS[kind]
   if (!fixed) {
     // program / ai（自由 out）：in の構成だけ固定
@@ -334,7 +346,7 @@ const MIRROR_KINDS = new Set(["program", "ai"])
 const isDerivedPort = (kind: string, port: Pick<GraphPort, "io" | "key">) =>
   DERIVED_KINDS.has(kind) &&
   (port.io === "in" ||
-    port.key === "main" ||
+    (kind !== "human" && port.key === "main") ||
     port.key === "approve" ||
     port.key === "reject")
 

package/dist/_schemas/port-spec.js

@@ -118,10 +118,9 @@ export const dataFormatOf = (schema) => {
     return { format: "list", columns };
 };
 // ---- kind 別ポート構成 ----
-// human / wait は構成（数・key・io）が固定。program / ai は in 1つ＋out 1つ以上
+// wait は構成が固定。human は基本ポートを保ち追加 out を持てる。program / ai は out 自由
 // （key 自由。複数 out＝分岐。AIノードの複数出口（分岐）.md）
 const FIXED_PORT_KEYS = {
-    human: { in: ["in"], out: ["approve", "reject"] },
     wait: { in: ["in"], out: ["main"] },
     // start は in 1つ（run 入力契約）＋ out main 1つの恒等パススルー
     start: { in: ["in"], out: ["main"] },
@@ -166,6 +165,17 @@ export const kindPortsViolation = (kind, ports) => {
         }
         return null;
     }
+    if (kind === "human") {
+        const inKeys = ports.filter((p) => p.io === "in").map((p) => p.key);
+        const outKeys = ports.filter((p) => p.io === "out").map((p) => p.key);
+        if (inKeys.length !== 1 ||
+            inKeys[0] !== "in" ||
+            !outKeys.includes("approve") ||
+            !outKeys.includes("reject")) {
+            return "human のポート構成は in(in) と out(approve / reject) が必須です（out は追加できます）";
+        }
+        return null;
+    }
     const fixed = FIXED_PORT_KEYS[kind];
     if (!fixed) {
         // program / ai（自由 out）：in の構成だけ固定
@@ -258,7 +268,7 @@ const DERIVED_KINDS = new Set(["wait", "human", "end", "start"]);
 const MIRROR_KINDS = new Set(["program", "ai"]);
 const isDerivedPort = (kind, port) => DERIVED_KINDS.has(kind) &&
     (port.io === "in" ||
-        port.key === "main" ||
+        (kind !== "human" && port.key === "main") ||
         port.key === "approve" ||
         port.key === "reject");
 // port_id → 解決済みスキーマ。導出は接続を遡って固定点まで反復し、

package/package.json

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