@geekbeer/minion 3.17.0 → 3.23.0

package/core/routes/todos.js

@@ -40,12 +40,13 @@ async function todoRoutes(fastify) {
       return { success: false, error: 'Unauthorized' }
     }
 
-    const { status, priority, project_id, source_type, limit } = request.query || {}
+    const { status, priority, project_id, source_type, session_id, limit } = request.query || {}
     const todos = todoStore.list({
       status,
       priority,
       project_id,
       source_type,
+      session_id,
       limit: limit ? parseInt(limit, 10) : undefined,
     })
 
@@ -75,14 +76,14 @@ async function todoRoutes(fastify) {
       return { success: false, error: 'Unauthorized' }
     }
 
-    const { title, description, priority, source_type, source_id, project_id, due_at, data } = request.body || {}
+    const { title, description, priority, source_type, source_id, project_id, due_at, data, session_id } = request.body || {}
     if (!title) {
       reply.code(400)
       return { success: false, error: 'title is required' }
     }
 
     try {
-      const todo = todoStore.add({ title, description, priority, source_type, source_id, project_id, due_at, data })
+      const todo = todoStore.add({ title, description, priority, source_type, source_id, project_id, due_at, data, session_id })
       console.log(`[Todos] Created: ${todo.id} "${todo.title}"`)
       reply.code(201)
       return { success: true, todo }

package/core/stores/todo-store.js

@@ -19,6 +19,11 @@ const VALID_SOURCE_TYPES = ['thread', 'workflow', 'directive', 'user', 'self']
 // Auto-prune completed todos older than this
 const PRUNE_DAYS = 30
 
+// Max number of times an incomplete todo gets auto-injected into the chat
+// prompt before we give up and stop injecting it (to avoid infinite loops
+// when Claude cannot finish a task).
+const MAX_INJECTION_COUNT = 5
+
 /**
  * Create a new TODO.
  * @param {object} todo - { title, description?, priority?, source_type?, source_id?, project_id?, due_at?, data? }
@@ -50,12 +55,14 @@ function add(todo) {
     created_at: now,
     updated_at: now,
     completed_at: null,
+    session_id: todo.session_id || null,
+    injection_count: 0,
     ...(todo.data ? { data: todo.data } : {}),
   }
 
   db.prepare(`
-    INSERT INTO todos (id, title, description, status, priority, source_type, source_id, project_id, due_at, created_at, updated_at, completed_at, data)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    INSERT INTO todos (id, title, description, status, priority, source_type, source_id, project_id, due_at, created_at, updated_at, completed_at, data, session_id, injection_count)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
   `).run(
     record.id,
     record.title,
@@ -69,7 +76,9 @@ function add(todo) {
     record.created_at,
     record.updated_at,
     record.completed_at,
-    record.data ? JSON.stringify(record.data) : null
+    record.data ? JSON.stringify(record.data) : null,
+    record.session_id,
+    record.injection_count
   )
 
   console.log(`[TodoStore] Added: "${record.title}" (${record.priority}, source=${record.source_type || 'none'})`)
@@ -115,7 +124,8 @@ function update(id, updates) {
   db.prepare(`
     UPDATE todos SET title = ?, description = ?, status = ?, priority = ?,
       source_type = ?, source_id = ?, project_id = ?, due_at = ?,
-      updated_at = ?, completed_at = ?, data = ?
+      updated_at = ?, completed_at = ?, data = ?,
+      session_id = ?, injection_count = ?
     WHERE id = ?
   `).run(
     merged.title,
@@ -129,6 +139,8 @@ function update(id, updates) {
     merged.updated_at,
     merged.completed_at,
     merged.data ? JSON.stringify(merged.data) : null,
+    merged.session_id ?? null,
+    merged.injection_count ?? 0,
     id
   )
 
@@ -160,9 +172,50 @@ function getById(id) {
   return row ? parseRow(row) : null
 }
 
+/**
+ * List incomplete (pending/in_progress) todos linked to a chat session that
+ * still have remaining injection budget. Used by the chat route to remind
+ * Claude of unfinished work even after context compaction.
+ * @param {string} sessionId
+ * @returns {Array}
+ */
+function listActiveForSession(sessionId) {
+  if (!sessionId) return []
+  const db = getDb()
+  const rows = db.prepare(`
+    SELECT * FROM todos
+    WHERE session_id = ?
+      AND status IN ('pending', 'in_progress')
+      AND injection_count < ?
+    ORDER BY
+      CASE priority WHEN 'urgent' THEN 0 WHEN 'high' THEN 1 WHEN 'normal' THEN 2 WHEN 'low' THEN 3 END,
+      created_at ASC
+  `).all(sessionId, MAX_INJECTION_COUNT)
+  return rows.map(parseRow)
+}
+
+/**
+ * Increment injection_count for the given todo IDs. Should be called once
+ * the reminder has been actually written into the outgoing prompt.
+ * @param {string[]} ids
+ */
+function markInjected(ids) {
+  if (!Array.isArray(ids) || ids.length === 0) return
+  const db = getDb()
+  const now = new Date().toISOString()
+  const stmt = db.prepare(`
+    UPDATE todos
+    SET injection_count = injection_count + 1, updated_at = ?
+    WHERE id = ?
+  `)
+  for (const id of ids) {
+    stmt.run(now, id)
+  }
+}
+
 /**
  * List TODOs with optional filters.
- * @param {object} opts - { status?, priority?, project_id?, source_type?, limit? }
+ * @param {object} opts - { status?, priority?, project_id?, source_type?, session_id?, limit? }
  * @returns {Array}
  */
 function list(opts = {}) {
@@ -186,6 +239,10 @@ function list(opts = {}) {
     conditions.push('source_type = ?')
     params.push(opts.source_type)
   }
+  if (opts.session_id) {
+    conditions.push('session_id = ?')
+    params.push(opts.session_id)
+  }
 
   const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : ''
   const limit = opts.limit || 100
@@ -260,6 +317,9 @@ module.exports = {
   remove,
   getById,
   list,
+  listActiveForSession,
+  markInjected,
   getSummary,
   pruneCompleted,
+  MAX_INJECTION_COUNT,
 }

package/docs/api-reference.md

@@ -229,6 +229,38 @@ curl -X PUT /api/config/env \
 The scheduler starts automatically on server boot if `REFLECTION_TIME` is configured.
 Changes via the config API take effect immediately (no restart required).
 
+### Todos
+
+ミニオンローカルのToDoリスト。SQLiteに永続化され、HQにも同期される。
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/todos` | List todos. Query: `status`, `priority`, `project_id`, `source_type`, `session_id`, `limit` |
+| GET | `/api/todos/summary` | Status counts |
+| GET | `/api/todos/:id` | Get single todo |
+| POST | `/api/todos` | Create. Body: `{title, description?, priority?, source_type?, source_id?, project_id?, due_at?, session_id?, data?}` |
+| PUT | `/api/todos/:id` | Update any field including `status` |
+| DELETE | `/api/todos/:id` | Delete |
+
+**フィールド**:
+- `status`: `pending` / `in_progress` / `done` / `cancelled`
+- `priority`: `low` / `normal` / `high` / `urgent`
+- `session_id`: チャットセッションID（任意）。**設定すると圧縮を跨いだ自動再掲の対象になる** — 次ターン以降のプロンプト冒頭で未完了Todoが自動表示される。
+- `injection_count`: 自動再掲された回数（読み取り専用）。一定回数を超えたTodoは再掲が停止する。
+
+**セッション紐づけ例**:
+```bash
+# 作成時にsession_idを指定すると、このセッションのチャットに自動で再掲される
+curl -X POST -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application/json" \
+  http://localhost:8080/api/todos \
+  -d '{"title": "レポートを保存", "session_id": "'$SESSION_ID'", "priority": "high"}'
+
+# 完了マーク（即座に更新すること）
+curl -X PUT -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application/json" \
+  http://localhost:8080/api/todos/$TODO_ID \
+  -d '{"status": "done"}'
+```
+
 ### Config
 
 | Method | Endpoint | Description |
@@ -240,6 +272,42 @@ Changes via the config API take effect immediately (no restart required).
 
 Allowed keys: `LLM_COMMAND`, `REFLECTION_TIME`
 
+### LLM Plugins (opt-in)
+
+プラグイン方式の LLM 設定。`primary` を設定すると有効化される。未設定の場合は従来の `LLM_COMMAND` 経路で動作する。設定は `~/minion/llm/config.json` にファイルとして保存される (env var に依存しないため quote 破損バグの影響を受けない)。
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/llm/plugins` | List available plugins with capabilities & auth status |
+| GET | `/api/llm/config` | Get current primary/enabled selection |
+| PUT | `/api/llm/config` | Update primary/enabled. Body: `{primary?, enabled?}` |
+
+**GET /api/llm/plugins response**:
+```json
+{
+  "success": true,
+  "plugins": [
+    {
+      "name": "claude",
+      "displayName": "Claude Code",
+      "capabilities": {
+        "toolUse": true,
+        "streaming": true,
+        "vision": true,
+        "imageGeneration": false,
+        "sessionResume": true
+      },
+      "authenticated": true,
+      "builtin": true,
+      "enabled": true,
+      "primary": true
+    }
+  ]
+}
+```
+
+**PUT /api/llm/config** body: `{ "primary": "claude", "enabled": ["claude", "gemini", "codex"] }`
+
 ### Permissions
 
 CLIツール（Claude Code, Gemini CLI, Codex CLI）のパーミッション管理。
@@ -853,6 +921,408 @@ POST `/api/minion/execution` body:
 }
 ```
 
+### Pending Revisions (PM のみ)
+
+レビューで `revision_requested` になったステップを検知する。ミニオンの `revision-watcher` デーモンが30秒ごとにポーリングし、LLM で差し戻し先ステップを判断した上で `/api/minion/revision-reset` を呼び出す。
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/minion/pending-revisions` | `revision_requested` 状態のステップ一覧（PMのプロジェクトのみ） |
+| POST | `/api/minion/revision-reset` | 差し戻し対象ステップを `pending` に戻す |
+
+GET Response:
+```json
+{
+  "revisions": [
+    {
+      "execution_id": "uuid",
+      "workflow_name": "daily-check",
+      "revision_step_index": 2,
+      "review_comment": "string (レビュアーのフィードバック)",
+      "pipeline": [
+        {
+          "step_index": 0,
+          "skill_version_id": "uuid",
+          "skill_name": "string|null",
+          "assigned_role": "pm|engineer|accountant"
+        }
+      ]
+    }
+  ]
+}
+```
+
+POST `/api/minion/revision-reset` body:
+```json
+{
+  "execution_id": "uuid",
+  "target_step_index": 0,
+  "revision_step_index": 2,
+  "revision_feedback": "string (省略可、target step の review_comment に保存)"
+}
+```
+
+- `target_step_index` は差し戻し先（やり直し起点）のインデックス
+- `revision_step_index` は差し戻しを要求されたレビューステップのインデックス（`target_step_index <= revision_step_index`）
+- target から revision までのステップが `pending` に戻り、`revision_feedback` が再実行時のコンテキストとして注入される
+
+Response:
+```json
+{
+  "success": true,
+  "reset_count": 3,
+  "target_step_index": 0,
+  "revision_step_index": 2
+}
+```
+
+---
+
+## DAG Workflows (HQ, ノード/エッジ方式)
+
+DAG ワークフローは従来の線形パイプラインを拡張した有向非巡回グラフ方式のワークフローです。HQダッシュボードの DAG エディタで作成・編集できるほか、ミニオンAPI経由でも JSON ベースで編集可能（PMロールのみ）。ミニオンはプルベースのポーリングで pending ノードを検出・実行します。
+
+### 編集エンドポイント (PMロール限定)
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| POST | `/api/minion/dag-workflows` | 新規 DAG ワークフローを作成（ドラフトとして保存） |
+| PUT | `/api/minion/dag-workflows/:id` | ドラフト graph / メタデータを更新 |
+| POST | `/api/minion/dag-workflows/:id/publish` | ドラフトをバリデーションし新バージョンとして公開 |
+
+いずれも Bearer 認証 + プロジェクトメンバーシップが `role='pm'` のミニオンに限定。非PMは 403。PUT / POST はドラフト保存時にセマンティックバリデーションを行わない（`graph` が object で `nodes` / `edges` 配列を持つことの構造チェックのみ）。パブリッシュ時には `validateDagGraph` によるフル検証（ノードID重複・エッジの参照整合性・サイクル検出・必須フィールド等）が走る。
+
+**推奨ワークフロー**: create → put で graph を整える → publish、または既存ワークフローに対して put → publish。
+
+POST `/api/minion/dag-workflows` body:
+```json
+{
+  "project_id": "uuid",
+  "name": "my-dag",
+  "graph": { "nodes": [], "edges": [] },
+  "content": "Markdown description (optional)",
+  "change_summary": "initial draft (optional)"
+}
+```
+
+- `name` は `/^[a-z0-9-]+$/`
+- `graph` は省略可。省略時はドラフト無しで作成される
+- レスポンスは作成された DAG ワークフロー全体（`current_version_id` は null のまま、ドラフトに保存）
+
+PUT `/api/minion/dag-workflows/:id` body（全フィールド optional、省略したものは変更しない）:
+```json
+{
+  "graph": { "nodes": [...], "edges": [...] },
+  "content": "...",
+  "change_summary": "Updated fan-out branch",
+  "name": "renamed-dag",
+  "is_active": true,
+  "maturity": "preview|stable|..."
+}
+```
+
+- `graph` を渡すと draft_graph が上書きされる（構造チェックのみ、セマンティックチェック無し）
+- `content` / `change_summary` は `graph` と併せて draft スロットに保存される
+
+POST `/api/minion/dag-workflows/:id/publish` (body なし):
+- 現在の draft_graph を `validateDagGraph` でフル検証
+- OK なら新バージョン行を `dag_workflow_versions` に追加し、`current_version_id` を更新、ドラフトをクリア
+- NG なら 400 で `{ error, details: [...] }` を返却
+
+### ミニオン CLI ラッパー
+
+以下の `hq` サブコマンドが上記エンドポイントを呼び出す。いずれもリクエスト送信前にローカルで JSON 構文検証を行う。
+
+```bash
+hq create dag-workflow <body.json>           # POST /api/minion/dag-workflows
+hq put dag-workflow <id> <body.json>         # PUT  /api/minion/dag-workflows/:id
+hq publish dag-workflow <id>                 # POST /api/minion/dag-workflows/:id/publish
+hq fetch dag-workflow <id>                   # GET  /api/minion/dag-workflows/:id
+hq fetch dag-execution <id>                  # GET  /api/minion/dag-executions/:id
+```
+
+### DAG Read Endpoints (チャットコンテキスト用)
+
+ユーザーがHQダッシュボードでDAGエディタ/実行詳細を閲覧中にチャットした場合、チャットコンテキストに `context.type = 'dag-workflow'` または `'dag-execution'` が注入される。以下の `hq` CLI コマンドで詳細を取得できる（内部的に `/api/minion/dag-workflows/:id` / `/api/minion/dag-executions/:id` を叩く）。
+
+| コマンド | 対応エンドポイント | 用途 |
+|---------|-------------------|------|
+| `hq fetch dag-workflow <id>` | GET `/api/minion/dag-workflows/:id` | DAG ワークフロー定義（published graph + draft）取得 |
+| `hq fetch dag-execution <id>` | GET `/api/minion/dag-executions/:id` | DAG 実行詳細（graph_snapshot + node_executions）取得 |
+
+いずれもミニオンのプロジェクトメンバーシップでスコープされる。ミニオンが参加していないプロジェクトのDAGは 404。
+
+GET `/api/minion/dag-workflows/:id` Response:
+```json
+{
+  "id": "uuid",
+  "project_id": "uuid",
+  "name": "my-dag",
+  "is_active": true,
+  "maturity": "draft|stable|...",
+  "current_version_id": "uuid",
+  "draft_graph": { "nodes": [...], "edges": [...] } ,
+  "draft_content": "markdown|null",
+  "draft_change_summary": "string|null",
+  "draft_updated_at": "ISO|null",
+  "current_version": {
+    "id": "uuid",
+    "version": 3,
+    "graph": { "nodes": [...], "edges": [...] },
+    "content": "markdown",
+    "change_summary": "string",
+    "created_at": "ISO"
+  },
+  "my_role": "pm|engineer|accountant|null"
+}
+```
+
+GET `/api/minion/dag-executions/:id` Response:
+```json
+{
+  "id": "uuid",
+  "dag_workflow_id": "uuid",
+  "dag_workflow_name": "my-dag",
+  "dag_workflow_version_id": "uuid",
+  "dag_workflow_version": 3,
+  "project_id": "uuid",
+  "status": "pending|running|completed|failed",
+  "graph_snapshot": { "nodes": [...], "edges": [...] },
+  "started_at": "ISO|null",
+  "completed_at": "ISO|null",
+  "created_at": "ISO",
+  "node_executions": [
+    {
+      "id": "uuid",
+      "node_id": "n2",
+      "scope_path": "",
+      "status": "pending|waiting|running|completed|failed|skipped",
+      "outcome": "success|failure|null",
+      "input_data": {},
+      "output_data": {},
+      "output_summary": "string|null",
+      "requires_review": false,
+      "review_status": "review_pending|approved|rejected|revision_requested|null",
+      "revision_count": 0,
+      "started_at": "ISO|null",
+      "completed_at": "ISO|null"
+    }
+  ]
+}
+```
+
+### DAG Runtime Endpoints (ミニオン向け)
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/dag/minion/pending-nodes` | 自分が実行すべき pending ノード一覧（ロール一致・依存解決済み） |
+| POST | `/api/dag/minion/claim-node` | ノードを楽観ロックで取得（排他実行） |
+| POST | `/api/dag/minion/node-complete` | ノード完了を報告し、下流ノードへカスケード |
+
+ミニオンの `dag-step-poller` デーモンが30秒ごとに `pending-nodes` を叩き、最大2並列で claim → skill/transform 実行 → node-complete の流れを回す。`skill`・`transform` 以外のノード（start/end/review/fan_out/join/conditional）はHQ内部のカスケードエンジンが処理するため、ミニオンには返されない。
+
+#### GET /api/dag/minion/pending-nodes
+
+Response:
+```json
+{
+  "nodes": [
+    {
+      "node_execution_id": "uuid",
+      "execution_id": "uuid",
+      "dag_workflow_name": "my-dag",
+      "node_id": "node-abc",
+      "scope_path": "",
+      "node_type": "skill",
+      "skill_version_id": "uuid|null",
+      "skill_name": "skill-1|null",
+      "assigned_role": "pm|engineer|accountant",
+      "input_data": { "...": "..." },
+      "revision_feedback": "string|null",
+      "transform_instruction": "string|null"
+    }
+  ]
+}
+```
+
+返却条件:
+- `assigned_role` がミニオンのプロジェクトロールと一致
+- ノードの `status` が `pending`
+- `node_type` が `skill` または `transform`
+- スコープ内の全依存ノードが `completed`（`requires_review` の場合は `approved` も必要）
+
+`scope_path` は fan-out 内のインスタンスを示す（ルートは空文字列、1段のfan-outでは `fan_out_A:0`、ネストでは `fan_out_A:2/fan_out_B:1`）。依存解決は同じ scope_path 内で閉じる。
+
+#### POST /api/dag/minion/claim-node
+
+Body:
+```json
+{ "node_execution_id": "uuid" }
+```
+
+Response (成功 / 201):
+```json
+{ "success": true, "node_execution_id": "uuid" }
+```
+
+Response (競合 / 409): 他ミニオンが既に claim 済み、または状態が pending でない場合。
+```json
+{ "error": "Node already claimed or not pending" }
+```
+
+409 を受け取った場合は `pending-nodes` を取り直して次のノードに進むこと。
+
+#### POST /api/dag/minion/node-complete
+
+Body:
+```json
+{
+  "node_execution_id": "uuid",
+  "status": "completed|failed",
+  "output_data": { "...": "..." },
+  "output_summary": "string (省略可、レポート/サマリー)"
+}
+```
+
+- `status: completed` で `requires_review` なノードはサーバ側で `review_status=review_pending` になりカスケードは停止（レビュー承認まで下流は生成されない）
+- `status: failed` でもカスケードは走る（fan-out join が `on_failure=ignore|collect` で集約できるため）
+- `output_data` は下流ノードの `input_data` に伝播する。**スキル実行時はスキル本文の「## Output Data」セクションの JSON コードブロックを抽出して `output_data` に載せる規約**（ミニオンの `dag-node-executor` がこの抽出を行う）
+
+Response:
+```json
+{ "success": true }
+```
+
+レビュー待ち状態の場合:
+```json
+{ "success": true, "review_pending": true }
+```
+
+### DAG Graph Structure
+
+DAG ワークフローの graph は以下の構造で保存される（`dag_workflow_versions.graph` / `dag_executions.graph_snapshot`）:
+
+```json
+{
+  "nodes": [
+    { "id": "n1", "type": "start", "label": "Start", "position": { "x": 0, "y": 0 } },
+    {
+      "id": "n2",
+      "type": "skill",
+      "label": "Fetch data",
+      "skill_version_id": "uuid",
+      "assigned_role": "engineer"
+    },
+    {
+      "id": "n3",
+      "type": "fan_out",
+      "label": "Per item",
+      "fan_out_source": ".items",
+      "template": { "nodes": [ ... ], "edges": [ ... ] },
+      "join_mode": "all",
+      "on_failure": "collect",
+      "max_concurrency": 3
+    },
+    {
+      "id": "n4",
+      "type": "join",
+      "label": "Collect",
+      "join_mode": "all",
+      "aggregation": "array"
+    },
+    { "id": "n5", "type": "end", "label": "End" }
+  ],
+  "edges": [
+    { "id": "e1", "source": "n1", "target": "n2", "kind": "normal" },
+    { "id": "e2", "source": "n2", "target": "n3" },
+    { "id": "e3", "source": "n3", "target": "n4" },
+    { "id": "e4", "source": "n4", "target": "n5" }
+  ]
+}
+```
+
+#### Node Types
+
+| `type` | 役割 | ミニオン実行 |
+|--------|------|---------------|
+| `start` | エントリポイント | ❌ (内部) |
+| `end` | 終端 | ❌ (内部) |
+| `skill` | スキル実行。`skill_version_id` と `assigned_role` が必須 | ✅ |
+| `transform` | LLM によるデータ変換。`transform_instruction` が必須 | ✅ |
+| `review` | レビューゲート。`approved` / `revision_requested` で分岐 | ❌ (内部) |
+| `fan_out` | 配列入力をテンプレートsub-graphに展開して並列実行。子が全て settle すると自ノードが completed に遷移 | ❌ (内部) |
+| `join` | N本の上流エッジを待ち合わせる汎用バリア。fan_out とは独立 | ❌ (内部) |
+| `conditional` | 条件分岐（`llm` / `regex` / `jq`） | ❌ (内部) |
+
+#### DagNode 主要フィールド
+
+| Field | Type | 説明 |
+|-------|------|------|
+| `id` | string | グラフ内ユニークなノードID |
+| `type` | DagNodeType | 上記ノード種別 |
+| `label` | string | 表示名 |
+| `skill_version_id` | string? | skill ノードで使用するスキルバージョンUUID |
+| `assigned_role` | `pm`\|`engineer`\|`accountant` | 実行ロール |
+| `fan_out_source` | string? | fan_out: 入力から配列を取り出すドット記法（例 `.items`） |
+| `template` | DagGraph? | fan_out: 各要素ごとに展開するsub-graph |
+| `max_concurrency` | number? | fan_out: 並列インスタンス上限 |
+| `join_mode` | `all`\|`any`\|`majority` | fan_out / join: 完了判定 |
+| `on_failure` | `fail_all`\|`ignore`\|`collect` | fan_out / join: 失敗時の挙動 |
+| `aggregation` | `array`\|`merge` | join: 上流出力の束ね方（デフォルト `array`） |
+| `condition_type` | `llm`\|`regex`\|`jq` | conditional: 条件評価方式 |
+| `condition_expression` | string | conditional: 条件式 |
+| `branches` | Record<string,string> | conditional: 条件出力→遷移先ノードID |
+| `default_branch` | string? | conditional: マッチしなかった場合の遷移先 |
+| `transform_instruction` | string | transform: LLMへの変換指示 |
+| `review` | object | review: レビュー設定 |
+
+#### DagEdge
+
+| Field | Type | 説明 |
+|-------|------|------|
+| `id` | string | エッジID |
+| `source` | string | 起点ノードID |
+| `target` | string | 終点ノードID |
+| `kind` | `normal`\|`approved`\|`revision` | `normal`=通常、`approved`=review承認時、`revision`=review差し戻し時（サイクル検出では無視される） |
+| `condition_label` | string? | 表示ラベル |
+
+### DAG Execution API (読み取り)
+
+| Method | Endpoint | Auth | 用途 |
+|--------|----------|------|------|
+| GET | `/api/dag/executions/:execId` | セッション | 実行詳細 (graph_snapshot + node_executions) 取得。UI用、ミニオンは通常使わない |
+
+Response:
+```json
+{
+  "id": "uuid",
+  "dag_workflow_id": "uuid",
+  "dag_workflow_name": "my-dag",
+  "dag_workflow_version_id": "uuid",
+  "status": "pending|running|completed|failed",
+  "graph_snapshot": { "nodes": [...], "edges": [...] },
+  "started_at": "ISO",
+  "completed_at": "ISO|null",
+  "node_executions": [
+    {
+      "id": "uuid",
+      "node_id": "n2",
+      "scope_path": "",
+      "status": "pending|waiting|running|completed|failed|skipped",
+      "outcome": "success|failure|null",
+      "input_data": {},
+      "output_data": {},
+      "output_summary": "string|null",
+      "requires_review": false,
+      "review_status": "review_pending|approved|rejected|revision_requested|null",
+      "revision_count": 0,
+      "started_at": "ISO|null",
+      "completed_at": "ISO|null"
+    }
+  ]
+}
+```
+
 ### Issue Reporting (GitHub Issue 起票)
 
 | Method | Endpoint | Description |