@mawaru/sdk 0.30.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/_cli/credentials.js

@@ -58,11 +58,11 @@ export const accessTokenFrom = async (credentials) => {
         body: JSON.stringify({ refresh_token: credentials.refresh_token }),
     });
     if (!res.ok) {
-        throw new Error(`セッションの更新に失敗しました（HTTP ${res.status}）。\`mawaru login\` でログインし直してください。`);
+        throw new Error(`セッションの更新に失敗しました（HTTP ${res.status}）。\`npx mawaru login\` でログインし直してください。`);
     }
     const body = (await res.json());
     if (!body.access_token || !body.refresh_token) {
-        throw new Error("セッションの更新に失敗しました。`mawaru login` でログインし直してください。");
+        throw new Error("セッションの更新に失敗しました。`npx mawaru login` でログインし直してください。");
     }
     saveCredentials({
         ...credentials,
@@ -75,7 +75,7 @@ export const accessTokenFrom = async (credentials) => {
 export const requireCredentials = () => {
     const credentials = loadCredentials();
     if (!credentials) {
-        throw new Error("ログインしていません。`mawaru login` を実行してください。");
+        throw new Error("ログインしていません。`npx mawaru login` を実行してください。");
     }
     return credentials;
 };

package/dist/_cli/sessionCommand.js

@@ -17,7 +17,7 @@ const tilde = (path) => {
 // 移動もしない。手がかりとして対象 repo 名だけ見せ、現在地と食い違うときに警告する
 export const runSessionResume = async (stepUrl) => {
     if (!stepUrl) {
-        console.error("使い方: mawaru session resume <step URL>\n" +
+        console.error("使い方: npx mawaru session resume <step URL>（実行 repo で実行）\n" +
             "run 詳細の AI ノードにあるコピーボタンで URL を取得できます。");
         return 1;
     }

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/dist/cli.js

@@ -81,7 +81,7 @@ switch (command) {
     case "session": {
         const [subcommand, ...args] = rest;
         if (subcommand !== "resume") {
-            fail("使い方: mawaru session resume <step URL>");
+            fail("使い方: npx mawaru session resume <step URL>");
         }
         try {
             const code = await runSessionResume(args.find((a) => !a.startsWith("-")));

package/package.json

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

package/skills/create-loop/SKILL.md

@@ -59,7 +59,7 @@ secret）でも、**足りない値を推測・生成・空文字で代用しな
 
 疎通確認のあと `GET {MAWARU_API_URL}/tenants/{MAWARU_TENANT_ID}/openapi.json`
 （ヘッダ `x-api-key: $MAWARU_API_KEY`）を取得すると、機械 API 面
-（loops の一覧・作成・詳細・graph PUT、runs/start、runs/{runId}/cancel、members、api-keys、steps の end / decision）の
+（loops の一覧・作成・詳細・graph PUT、runs/start、runs/{runId}/cancel、runs/{runId}/complete、members、api-keys、steps の end / decision）の
 パス・メソッド・リクエストボディ（Zod 由来の JSON Schema）が載っている。ここが常に正。
 段階導入中で未掲載のエンドポイントもある（その場合だけ `api/index.ts` 相当を辿る）。