@mawaru/sdk 0.21.0 → 0.23.0

package/_schemas/graph.test.ts

@@ -31,24 +31,6 @@ describe("waitConfigSchema", () => {
     }
   })
 
-  it("until: ISO 日時（Z / オフセット）を受け付ける", () => {
-    for (const until_at of [
-      "2026-07-10T09:00:00.000Z",
-      "2026-07-10T09:00:00+09:00",
-    ]) {
-      expect(waitConfigSchema.parse({ wait_type: "until", until_at })).toEqual({
-        wait_type: "until",
-        until_at,
-      })
-    }
-  })
-
-  it("until: 日時でない文字列を拒否する", () => {
-    expect(() =>
-      waitConfigSchema.parse({ wait_type: "until", until_at: "2026-07-10" }),
-    ).toThrow()
-  })
-
   it("cron: 非空の式を受け付ける（式の妥当性検証は保存時）", () => {
     expect(
       waitConfigSchema.parse({ wait_type: "cron", cron_expr: "0 9 * * 1-5" }),
@@ -62,20 +44,26 @@ describe("waitConfigSchema", () => {
   })
 
   it("種別と値カラムの取り違えを拒否する", () => {
-    // duration に until_at だけ、など判別後の必須欠落
+    // duration に cron_expr だけ、など判別後の必須欠落
     expect(() =>
       waitConfigSchema.parse({
         wait_type: "duration",
-        until_at: "2026-07-10T09:00:00.000Z",
+        cron_expr: "0 9 * * *",
       }),
     ).toThrow()
     expect(() =>
-      waitConfigSchema.parse({ wait_type: "until", duration_seconds: 60 }),
+      waitConfigSchema.parse({ wait_type: "cron", duration_seconds: 60 }),
     ).toThrow()
   })
 
-  it("未知の wait_type を拒否する", () => {
+  it("未知の wait_type を拒否する（廃止した until を含む）", () => {
     expect(() => waitConfigSchema.parse({ wait_type: "forever" })).toThrow()
+    expect(() =>
+      waitConfigSchema.parse({
+        wait_type: "until",
+        until_at: "2026-07-10T09:00:00.000Z",
+      }),
+    ).toThrow()
   })
 })
 

package/_schemas/graph.ts

@@ -78,17 +78,15 @@ export const graphNodeKindSchema = nodeKindSchema.extract([
 export type GraphNodeKind = z.infer<typeof graphNodeKindSchema>
 
 // Wait ノードの kind 別設定（node_waits の wait_type に対応する判別ユニオン）。
-// duration=経過秒、until=絶対時刻(ISO)、cron=cron 式（次回発火まで1回待つ）。
+// duration=経過秒、cron=cron 式（次に来る該当時刻まで1回待つ）。
+// wait は到達時に fireAt を1つ決めて1回だけ発火するので、絶対時刻を1点指す種別（旧 until）は
+// 繰り返し回るループの部品にならない＝持たない。
 // cron 式の妥当性は保存時に backend の cron パーサで検証する（ここは非空のみ）
 export const waitConfigSchema = z.discriminatedUnion("wait_type", [
   z.object({
     wait_type: z.literal("duration"),
     duration_seconds: z.number().int().positive(),
   }),
-  z.object({
-    wait_type: z.literal("until"),
-    until_at: z.iso.datetime({ offset: true }),
-  }),
   z.object({
     wait_type: z.literal("cron"),
     cron_expr: z.string().min(1),
@@ -272,12 +270,10 @@ export const graphNodeSchema = z.object({
   icon: nodeIconSchema.optional(),
   // Slack ビュー（全 kind 共通の任意設定。承認待ち・完了メッセージの見せ方）。
   // human の view と同じ「不透明なキー」で、実在・可視性の検証は保存時に mawaru 側が行う
-  // （カタログは非公開。@mawaru/common の slack-view.ts）。省略時は従来表示。
+  // （カタログは非公開。@mawaru/common の slack-view.ts）。
+  // 省略＝承認待ちは承認ボタンだけ・完了は ✅ の1行（データは出さない）。
   // ポートの型には一切影響しない
   slack_view: z.string().min(1).optional(),
-  // Slack の完了メッセージにデータを残すか（false = 1行に畳む）。
-  // 省略時は defaultSlackKeepData(kind) が入る
-  slack_keep_data: z.boolean().optional(),
   // kind 別設定（自 kind のときだけ意味を持つ。省略時は保存側がデフォルトを補う）
   wait: waitConfigSchema.optional(),
   program: programConfigSchema.optional(),
@@ -287,13 +283,6 @@ export const graphNodeSchema = z.object({
 })
 export type GraphNode = z.infer<typeof graphNodeSchema>
 
-// slack_keep_data の省略時の値。エディタのノード雛形と graph 保存の両方がここを見る
-// （DB には常に具体値が入り、「既定に従う」という状態は persist しない）。
-// 構造ノードは run の入力・結果そのものなので残し、それ以外は畳む：中間ノードの完了まで
-// データで埋まるとスレッドが読めなくなる
-export const defaultSlackKeepData = (kind: string): boolean =>
-  kind === "start" || kind === "end"
-
 // 手動ルートの折れ点（loop 座標系の絶対座標）。connection の waypoints に並べる
 // （docs/tasks/wip/connection線ルートの手動編集（ウェイポイント）.md）
 export const waypointSchema = z.object({ x: z.number(), y: z.number() })

package/dist/_cli/resumeSession.d.ts

@@ -9,6 +9,7 @@ export declare const recordedCwds: (transcript: string) => {
     all: string[];
     last: string | null;
 };
+export declare const workspaceRepoName: (cwds: string[]) => string | null;
 export declare const findProjectDir: (cwd: string) => string | null;
 export type TranscriptRef = {
     url: string;

package/dist/_cli/resumeSession.js

@@ -50,6 +50,19 @@ export const recordedCwds = (transcript) => {
     }
     return { all, last };
 };
+// ランナー上の cwd は /home/runner/work/<実行repo>/<実行repo>/workspace/<対象repo>/... の形。
+// エージェントが実際に触ったのは setup.sh が workspace/ 配下に clone した**対象 repo** なので、
+// そのセグメントだけを人間への手がかりとして取り出す（フルパスはローカルでは解決しないので見せない）
+export const workspaceRepoName = (cwds) => {
+    for (const cwd of cwds) {
+        const segments = cwd.split("/");
+        const index = segments.indexOf("workspace");
+        const name = index >= 0 ? segments[index + 1] : undefined;
+        if (name)
+            return name;
+    }
+    return null;
+};
 const projectsRoot = () => join(process.env.CLAUDE_CONFIG_DIR ?? join(homedir(), ".claude"), "projects");
 // 置き先のディレクトリを **規則を再実装せず観測で決める**（agent-runner の
 // _helpers/session.ts と同じ方針）。~/.claude/projects/*/*.jsonl の cwd を読み、

package/dist/_cli/sessionCommand.d.ts

@@ -1,3 +1 @@
-export declare const runSessionResume: (stepUrl: string | undefined, options: {
-    yes: boolean;
-}) => Promise<number>;
+export declare const runSessionResume: (stepUrl: string | undefined) => Promise<number>;

package/dist/_cli/sessionCommand.js

@@ -1,25 +1,22 @@
-import { createInterface } from "node:readline/promises";
+import { homedir } from "node:os";
+import { dirname } from "node:path";
 import { requireCredentials } from "./credentials.js";
-import { downloadTranscript, fetchTranscriptRef, parseStepUrl, placeTranscript, recordedCwds, spawnClaudeResume, } from "./resumeSession.js";
-const confirm = async (question) => {
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    try {
-        const answer = await rl.question(`${question} [y/N] `);
-        return /^y(es)?$/i.test(answer.trim());
-    }
-    finally {
-        rl.close();
-    }
+import { downloadTranscript, fetchTranscriptRef, parseStepUrl, placeTranscript, recordedCwds, spawnClaudeResume, workspaceRepoName, } from "./resumeSession.js";
+// ホーム配下は ~ に畳む（置き先は必ずホーム配下なので実質いつも効く）
+const tilde = (path) => {
+    const home = homedir();
+    return path.startsWith(home) ? `~${path.slice(home.length)}` : path;
 };
-// `mawaru session resume <step URL> [--yes]`
+// `mawaru session resume <step URL>`
 //
-// 取得 → 作業ディレクトリの確認 → 配置 → `claude --resume`。
-// **どこに cd すべきかは mawaru には分からない**（AI ノードの実行 repo と、エージェントが
-// 実際に触った repo は別物で、後者は setup.sh が workspace/ 配下に clone した対象 repo）。
-// なので推定せず、記録された cwd をそのまま見せて人間に判断させる
-export const runSessionResume = async (stepUrl, options) => {
+// **確認は取らない。** 書くのは ~/.claude/projects/<現在地>/<sessionId>.jsonl の新規1ファイルだけで
+// repo には触れないので、場所を間違えても別プロジェクトの履歴に混ざるだけ＝やり直せる。
+// **どこに cd すべきかは mawaru には分からない**（AI ノードの実行 repo と、エージェントが実際に
+// 触った repo は別物で、後者は setup.sh が workspace/ 配下に clone した対象 repo）ので推定して
+// 移動もしない。手がかりとして対象 repo 名だけ見せ、現在地と食い違うときに警告する
+export const runSessionResume = async (stepUrl) => {
     if (!stepUrl) {
-        console.error("使い方: mawaru session resume <step URL> [--yes]\n" +
+        console.error("使い方: mawaru session resume <step URL>\n" +
             "run 詳細の AI ノードにあるコピーボタンで URL を取得できます。");
         return 1;
     }
@@ -28,28 +25,19 @@ export const runSessionResume = async (stepUrl, options) => {
     const credentials = requireCredentials();
     const transcriptRef = await fetchTranscriptRef(credentials, ref);
     const transcript = await downloadTranscript(transcriptRef.url);
-    console.log(`取得: セッション ${transcriptRef.session_id}`);
+    console.log(`取得: セッション ${transcriptRef.session_id.slice(0, 8)}`);
     if (transcriptRef.redacted) {
         console.log(`（退避時に secret を ${transcriptRef.redacted} 箇所マスクしています）`);
     }
-    const { all, last } = recordedCwds(transcript);
     const cwd = process.cwd();
-    if (all.length > 0) {
-        console.log("このセッションの作業ディレクトリ:");
-        for (const dir of all) {
-            console.log(`  ${dir}${dir === last ? "（最後に居た場所）" : ""}`);
+    const repo = workspaceRepoName(recordedCwds(transcript).all);
+    if (repo) {
+        console.log(`実行時の作業対象: ${repo}（ランナー上の workspace/${repo}）`);
+        if (!cwd.includes(repo)) {
+            console.log(`⚠ 現在地に ${repo} が含まれません。別 repo で再開しようとしているかもしれません（このまま続けます）`);
         }
     }
-    console.log(`現在地:\n  ${cwd}`);
-    if (!all.includes(cwd)) {
-        console.log("※ 記録された作業ディレクトリとは違います。記録上の絶対パスはここでは解決しません" +
-            "（エージェントは読めないパスに当たれば自分で見つけ直します）。");
-    }
-    if (!options.yes && !(await confirm("続けますか？"))) {
-        console.log("中止しました。");
-        return 1;
-    }
     const file = placeTranscript(cwd, transcriptRef.session_id, transcript);
-    console.log(`配置: ${file}\n再開します…`);
+    console.log(`復元先: ${tilde(dirname(file))}\n再開します…`);
     return await spawnClaudeResume(transcriptRef.session_id);
 };

package/dist/_schemas/graph.d.ts

@@ -18,20 +18,17 @@ export declare const editableNodeKindSchema: z.ZodEnum<{
 export type EditableNodeKind = z.infer<typeof editableNodeKindSchema>;
 export declare const graphNodeKindSchema: z.ZodEnum<{
     start: "start";
-    end: "end";
     ai: "ai";
     human: "human";
     program: "program";
     wait: "wait";
+    end: "end";
     component: "component";
 }>;
 export type GraphNodeKind = z.infer<typeof graphNodeKindSchema>;
 export declare const waitConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     wait_type: z.ZodLiteral<"duration">;
     duration_seconds: z.ZodNumber;
-}, z.core.$strip>, z.ZodObject<{
-    wait_type: z.ZodLiteral<"until">;
-    until_at: z.ZodISODateTime;
 }, z.core.$strip>, z.ZodObject<{
     wait_type: z.ZodLiteral<"cron">;
     cron_expr: z.ZodString;
@@ -58,8 +55,8 @@ export declare const humanConfigSchema: z.ZodObject<{
             round_robin: "round_robin";
         }>>;
         approval_mode: z.ZodDefault<z.ZodEnum<{
-            all: "all";
             any: "any";
+            all: "all";
         }>>;
         units: z.ZodDefault<z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodUUID, z.ZodLiteral<"run_starter">]>>>>;
     }, z.core.$strip>;
@@ -131,11 +128,11 @@ export declare const graphNodeSchema: z.ZodObject<{
     id: z.ZodUUID;
     kind: z.ZodEnum<{
         start: "start";
-        end: "end";
         ai: "ai";
         human: "human";
         program: "program";
         wait: "wait";
+        end: "end";
         component: "component";
     }>;
     name: z.ZodString;
@@ -174,13 +171,9 @@ export declare const graphNodeSchema: z.ZodObject<{
         image_url: z.ZodURL;
     }, z.core.$strict>]>>;
     slack_view: z.ZodOptional<z.ZodString>;
-    slack_keep_data: z.ZodOptional<z.ZodBoolean>;
     wait: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         wait_type: z.ZodLiteral<"duration">;
         duration_seconds: z.ZodNumber;
-    }, z.core.$strip>, z.ZodObject<{
-        wait_type: z.ZodLiteral<"until">;
-        until_at: z.ZodISODateTime;
     }, z.core.$strip>, z.ZodObject<{
         wait_type: z.ZodLiteral<"cron">;
         cron_expr: z.ZodString;
@@ -201,8 +194,8 @@ export declare const graphNodeSchema: z.ZodObject<{
                 round_robin: "round_robin";
             }>>;
             approval_mode: z.ZodDefault<z.ZodEnum<{
-                all: "all";
                 any: "any";
+                all: "all";
             }>>;
             units: z.ZodDefault<z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodUUID, z.ZodLiteral<"run_starter">]>>>>;
         }, z.core.$strip>;
@@ -213,7 +206,6 @@ export declare const graphNodeSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type GraphNode = z.infer<typeof graphNodeSchema>;
-export declare const defaultSlackKeepData: (kind: string) => boolean;
 export declare const waypointSchema: z.ZodObject<{
     x: z.ZodNumber;
     y: z.ZodNumber;
@@ -233,11 +225,11 @@ export declare const saveGraphBodySchema: z.ZodObject<{
         id: z.ZodUUID;
         kind: z.ZodEnum<{
             start: "start";
-            end: "end";
             ai: "ai";
             human: "human";
             program: "program";
             wait: "wait";
+            end: "end";
             component: "component";
         }>;
         name: z.ZodString;
@@ -276,13 +268,9 @@ export declare const saveGraphBodySchema: z.ZodObject<{
             image_url: z.ZodURL;
         }, z.core.$strict>]>>;
         slack_view: z.ZodOptional<z.ZodString>;
-        slack_keep_data: z.ZodOptional<z.ZodBoolean>;
         wait: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             wait_type: z.ZodLiteral<"duration">;
             duration_seconds: z.ZodNumber;
-        }, z.core.$strip>, z.ZodObject<{
-            wait_type: z.ZodLiteral<"until">;
-            until_at: z.ZodISODateTime;
         }, z.core.$strip>, z.ZodObject<{
             wait_type: z.ZodLiteral<"cron">;
             cron_expr: z.ZodString;
@@ -303,8 +291,8 @@ export declare const saveGraphBodySchema: z.ZodObject<{
                     round_robin: "round_robin";
                 }>>;
                 approval_mode: z.ZodDefault<z.ZodEnum<{
-                    all: "all";
                     any: "any";
+                    all: "all";
                 }>>;
                 units: z.ZodDefault<z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodUUID, z.ZodLiteral<"run_starter">]>>>>;
             }, z.core.$strip>;

package/dist/_schemas/graph.js

@@ -53,17 +53,15 @@ export const graphNodeKindSchema = nodeKindSchema.extract([
     "component",
 ]);
 // Wait ノードの kind 別設定（node_waits の wait_type に対応する判別ユニオン）。
-// duration=経過秒、until=絶対時刻(ISO)、cron=cron 式（次回発火まで1回待つ）。
+// duration=経過秒、cron=cron 式（次に来る該当時刻まで1回待つ）。
+// wait は到達時に fireAt を1つ決めて1回だけ発火するので、絶対時刻を1点指す種別（旧 until）は
+// 繰り返し回るループの部品にならない＝持たない。
 // cron 式の妥当性は保存時に backend の cron パーサで検証する（ここは非空のみ）
 export const waitConfigSchema = z.discriminatedUnion("wait_type", [
     z.object({
         wait_type: z.literal("duration"),
         duration_seconds: z.number().int().positive(),
     }),
-    z.object({
-        wait_type: z.literal("until"),
-        until_at: z.iso.datetime({ offset: true }),
-    }),
     z.object({
         wait_type: z.literal("cron"),
         cron_expr: z.string().min(1),
@@ -216,12 +214,10 @@ export const graphNodeSchema = z.object({
     icon: nodeIconSchema.optional(),
     // Slack ビュー（全 kind 共通の任意設定。承認待ち・完了メッセージの見せ方）。
     // human の view と同じ「不透明なキー」で、実在・可視性の検証は保存時に mawaru 側が行う
-    // （カタログは非公開。@mawaru/common の slack-view.ts）。省略時は従来表示。
+    // （カタログは非公開。@mawaru/common の slack-view.ts）。
+    // 省略＝承認待ちは承認ボタンだけ・完了は ✅ の1行（データは出さない）。
     // ポートの型には一切影響しない
     slack_view: z.string().min(1).optional(),
-    // Slack の完了メッセージにデータを残すか（false = 1行に畳む）。
-    // 省略時は defaultSlackKeepData(kind) が入る
-    slack_keep_data: z.boolean().optional(),
     // kind 別設定（自 kind のときだけ意味を持つ。省略時は保存側がデフォルトを補う）
     wait: waitConfigSchema.optional(),
     program: programConfigSchema.optional(),
@@ -229,11 +225,6 @@ export const graphNodeSchema = z.object({
     human: humanConfigSchema.optional(),
     component: componentConfigSchema.optional(),
 });
-// slack_keep_data の省略時の値。エディタのノード雛形と graph 保存の両方がここを見る
-// （DB には常に具体値が入り、「既定に従う」という状態は persist しない）。
-// 構造ノードは run の入力・結果そのものなので残し、それ以外は畳む：中間ノードの完了まで
-// データで埋まるとスレッドが読めなくなる
-export const defaultSlackKeepData = (kind) => kind === "start" || kind === "end";
 // 手動ルートの折れ点（loop 座標系の絶対座標）。connection の waypoints に並べる
 // （docs/tasks/wip/connection線ルートの手動編集（ウェイポイント）.md）
 export const waypointSchema = z.object({ x: z.number(), y: z.number() });

package/dist/_schemas/hook-manifest.d.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
 export declare const hookEventSchema: z.ZodEnum<{
-    input: "input";
     output: "output";
+    input: "input";
     signal: "signal";
 }>;
 export type HookEvent = z.infer<typeof hookEventSchema>;
@@ -9,8 +9,8 @@ export declare const hookManifestSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
     on: z.ZodArray<z.ZodEnum<{
-        input: "input";
         output: "output";
+        input: "input";
         signal: "signal";
     }>>;
     env: z.ZodDefault<z.ZodArray<z.ZodString>>;

package/dist/_schemas/node.d.ts

@@ -1,12 +1,12 @@
 import { z } from "zod";
 export declare const nodeKindSchema: z.ZodEnum<{
     start: "start";
-    end: "end";
     ai: "ai";
     human: "human";
     program: "program";
     guardrail: "guardrail";
     wait: "wait";
+    end: "end";
     component: "component";
 }>;
 export type NodeKind = z.infer<typeof nodeKindSchema>;

package/dist/cli.js

@@ -15,7 +15,7 @@ const USAGE = `使い方: mawaru <command> [引数]
   validate   リポジトリ規約を検証する（error があれば exit 1。CI 向け）
   login      ブラウザで承認して mawaru にログインする（~/.mawaru/credentials.json）
   logout     保存した資格情報を消す
-  session resume <step URL> [--yes]
+  session resume <step URL>
              AI ノードのセッションを手元に復元して claude --resume で再開する`;
 const [command, ...rest] = process.argv.slice(2);
 // init / typegen / validate は repo ルートを任意で受ける（省略時はカレント）
@@ -81,10 +81,10 @@ switch (command) {
     case "session": {
         const [subcommand, ...args] = rest;
         if (subcommand !== "resume") {
-            fail("使い方: mawaru session resume <step URL> [--yes]");
+            fail("使い方: mawaru session resume <step URL>");
         }
         try {
-            const code = await runSessionResume(args.find((a) => !a.startsWith("-")), { yes: args.includes("--yes") || args.includes("-y") });
+            const code = await runSessionResume(args.find((a) => !a.startsWith("-")));
             process.exit(code);
         }
         catch (e) {

package/docs/development.md

@@ -52,6 +52,10 @@ skills/<dir>/      # AI ノードが参照する skill（SKILL.md）
   読める
 - 実行時はラッパーが Claude Code（headless）を起動し、`outputs` のスキーマに適合する
   output を検証して報告する。出口が複数あれば AI が1つ選ぶ（複数出口＝分岐）
+- **文体の既定は「短く」**：出力の文章は承認画面・Slack・顧客への回答としてそのまま人が読むため、
+  ラッパーが枠組みプロンプトで「結論から・前置きや言い換えや締め文句を書かない・1文は短く」を
+  常に指示している。長い文章（詳細なレポート等）が要るノードだけ `prompt` に長さ・文体を明示する
+  （指示が既定より優先される）
 
 ## フック（`nodes/hook/<dir>/`）
 

package/package.json

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

package/skills/create-loop/SKILL.md

@@ -93,6 +93,16 @@ repo との矛盾・使用中ノードの削除は 409。**graph PUT は冪等
 6. **報告**：エディタ URL `{MAWARU_APP_URL}/loops/{loopId}/edit` をユーザーに渡し、
    見た目の確認と run はユーザーに委ねる。
 
+## AI ノード：出力は短く（既定）
+
+AI ノードの出力の文章は、承認画面・Slack・顧客への回答としてそのまま人が読む。ラッパーの
+枠組みプロンプトが「結論から・前置きや言い換えや締め文句を書かない・1文は短く」を常に指示して
+いるので、**prompt に「簡潔に」と書き足す必要はない**。逆に長い文章（詳細なレポート等）が要る
+ノードだけ、prompt に長さ・文体を明示する（ノードの指示が既定より優先される）。
+
+出力スキーマも同じ方針で最小限にする：人が確認する値に、使われない補足フィールド
+（説明・根拠・メタ情報）を足さない。
+
 ## AI ノード：決定論的な処理は prompt でなく setup.sh に書く
 
 やることが決まっている準備＝**外部 repo の clone / skill の持ち込み / 認証キーのファイル化 /