@geekbeer/minion 3.17.0 → 3.23.0

package/docs/task-guides.md

@@ -144,6 +144,226 @@ curl -s -X POST "http://localhost:8080/api/workflows/push/<name>" \
   -H "Authorization: Bearer $API_TOKEN"
 ```
 
+> **Note**: `/api/workflows/push|fetch` は線形パイプライン形式（`pipeline_skill_names`）の旧式ワークフロー専用です。DAGワークフロー（ノード/エッジ形式）はHQダッシュボードの DAG エディタで作成・編集します。次節を参照。
+
+---
+
+## DAG ワークフロー (ノード/エッジ形式)
+
+DAG ワークフローは有向非巡回グラフでスキル間の依存関係を表現する新方式のワークフローです。fan-out による並列展開、join による集約、conditional による分岐、transform による LLM データ変換、review によるゲーティングをサポートします。
+
+**HQダッシュボードの DAG エディタ（プロジェクト画面 → 「DAG (beta)」タブ）で GUI 編集**できるほか、**ミニオンからは JSON ベースで編集可能**（PMロールのみ）。ミニオンは実行ランタイムも担当し、`dag-step-poller` デーモンが pending ノードを自動で処理します。
+
+### ミニオンによる DAG ワークフロー編集 (PM のみ)
+
+ミニオンは `hq` CLI で DAG ワークフローの graph JSON を直接編集できる。
+
+#### 1. 新規作成
+
+```bash
+# body.json を用意
+cat > /tmp/dag-create.json <<'EOF'
+{
+  "project_id": "<project-uuid>",
+  "name": "my-dag",
+  "content": "Description of this DAG",
+  "change_summary": "initial draft",
+  "graph": {
+    "nodes": [
+      { "id": "start", "type": "start", "label": "Start", "position": { "x": 0, "y": 0 } },
+      { "id": "end",   "type": "end",   "label": "End",   "position": { "x": 300, "y": 0 } }
+    ],
+    "edges": [
+      { "id": "e1", "source": "start", "target": "end" }
+    ]
+  }
+}
+EOF
+
+# 作成（ドラフトとして保存される、まだ v1 にはならない）
+hq create dag-workflow /tmp/dag-create.json
+```
+
+- `name` は `/^[a-z0-9-]+$/`
+- `graph` は省略可。省略時は空で作成してから put で埋めていく
+- レスポンスの `id` を控えて後続の put / publish に使う
+
+#### 2. ドラフト更新
+
+```bash
+# body.json を用意（フィールドは全て optional）
+cat > /tmp/dag-update.json <<'EOF'
+{
+  "graph": {
+    "nodes": [
+      { "id": "start", "type": "start", "label": "Start" },
+      { "id": "fetch", "type": "skill", "label": "Fetch",
+        "skill_version_id": "<skill-version-uuid>", "assigned_role": "engineer" },
+      { "id": "end",   "type": "end", "label": "End" }
+    ],
+    "edges": [
+      { "id": "e1", "source": "start", "target": "fetch" },
+      { "id": "e2", "source": "fetch", "target": "end" }
+    ]
+  },
+  "content": "Description updated",
+  "change_summary": "add fetch skill node"
+}
+EOF
+
+hq put dag-workflow <dag-workflow-id> /tmp/dag-update.json
+```
+
+- ドラフト保存時はセマンティックバリデーション無し（構造チェックのみ）。未完成状態でも保存できる。
+- `hq` CLI は送信前にローカルで JSON 構文を検証する。壊れていれば API を叩かずに `Error: invalid JSON syntax in ...` で停止する。
+
+#### 3. 公開（バリデーション付き）
+
+```bash
+hq publish dag-workflow <dag-workflow-id>
+```
+
+- 現在のドラフトを `validateDagGraph` でフル検証（ノードID重複・エッジ参照整合性・サイクル・必須フィールド等）
+- OK なら新バージョンが `dag_workflow_versions` に追加され、`current_version_id` が更新される
+- NG なら 400 で `{ error, details: [...] }` が返る。エラー詳細を見てドラフトを修正し再試行する
+- 公開後、`dag-step-poller` による実行対象になる
+
+#### 4. 既存ワークフローの取得と編集のラウンドトリップ
+
+```bash
+# 現在の state をダウンロード
+hq fetch dag-workflow <dag-workflow-id> > /tmp/current.json
+
+# jq で graph 部分だけ抜き出して編集用ボディを作る
+jq '{ graph: (.draft_graph // .current_version.graph), content: (.draft_content // .current_version.content), change_summary: "…" }' \
+  /tmp/current.json > /tmp/dag-update.json
+
+# 編集（エディタや AI で graph を変更）
+# ...
+
+# 更新 → 公開
+hq put dag-workflow <dag-workflow-id> /tmp/dag-update.json
+hq publish dag-workflow <dag-workflow-id>
+```
+
+#### 権限と注意事項
+
+- 書き込み（create / put / publish）は **PMロールのみ**。Engineer / accountant では 403 が返る。読み取り（fetch）は全メンバー可。
+- ドラフト保存は軽量（構造チェックのみ）。インクリメンタルに graph を組み立てていくのに適している。
+- セマンティックエラーは publish 時にまとめて検出されるため、途中保存と最終公開を使い分けること。
+
+### 実行フロー（ランタイム側、参考）
+
+```
+HQ側:
+  ユーザーが DAG 実行を開始
+  → dag_executions レコード作成
+  → 初期ノード (start の下流) が status=pending で生成
+
+ミニオン側 (dag-step-poller, 30秒ごと):
+  1. GET /api/dag/minion/pending-nodes
+     → 自分のロールに一致し、依存が解決済みの pending ノードを取得
+  2. POST /api/dag/minion/claim-node
+     → 楽観ロックでノードを取得（409 の場合は他ミニオンが先に処理中）
+  3. スキル実行 (skill ノード) または変換実行 (transform ノード)
+  4. POST /api/dag/minion/node-complete
+     → output_data と output_summary を報告
+
+HQ側 (カスケードエンジン):
+  - completed → 下流ノードを pending で生成 (依存解決後)
+  - fan_out ノード → template を N 個展開、各インスタンスに scope_path 付与
+  - join ノード → fan-out 全インスタンス完了待機・集約
+  - conditional ノード → 条件評価で分岐先を決定
+  - review ノード → review_pending で停止、レビュー承認で再開
+```
+
+### スキルの output_data 出力規約
+
+DAGのスキルノードでは、下流ノードに構造化データを渡すため、スキル本文に「## Output Data」セクションを設けて JSON コードブロックで出力を記述すること。ミニオンの `dag-node-executor` がこのブロックを抽出して `output_data` に載せる。
+
+例（スキル実行結果の末尾）:
+
+````markdown
+## 実行サマリー
+
+検索結果を3件取得しました。
+
+## Output Data
+
+```json
+{
+  "items": [
+    { "id": "a1", "title": "Item A" },
+    { "id": "a2", "title": "Item B" },
+    { "id": "a3", "title": "Item C" }
+  ],
+  "count": 3
+}
+```
+````
+
+- 「## Output Data」セクションが無い、または JSON パースに失敗した場合は `{ _raw: "<出力全文>" }` にフォールバック
+- 失敗時 (`status: failed`) は `output_data` は空オブジェクト `{}` として扱われる
+
+### Fan-out / Join の動作
+
+fan-out ノードは入力から配列を取り出し、template sub-graph を配列要素数だけ並列展開する。
+
+```
+入力 input_data = { "items": [A, B, C] }
+fan_out_source = ".items"
+↓
+3 つのインスタンスを生成:
+  scope_path="<fan_out_id>:0", input=A, 対応する template nodes が pending で出現
+  scope_path="<fan_out_id>:1", input=B, ...
+  scope_path="<fan_out_id>:2", input=C, ...
+↓
+各インスタンスの template 実行完了後、対応する join ノードが集約
+  join_mode=all: 全成功で完了
+  join_mode=any: いずれか成功で完了
+  join_mode=majority: 過半数成功で完了
+  on_failure=collect: 失敗も含め結果を集める
+  on_failure=ignore: 失敗を除外
+  on_failure=fail_all: 1つでも失敗すれば join も失敗
+↓
+集約結果が join の output_data として下流に渡る
+```
+
+ミニオンから見ると、fan-out 内の skill/transform ノードも通常どおり `pending-nodes` に返ってくる（`scope_path` が空でない点だけが違い）。
+
+### Transform ノード
+
+Transform ノードは LLM を使って input_data を output_data に変換する軽量ノード。`transform_instruction` に自然言語で変換指示を書く。ミニオン側では `transform_instruction` を本文とする一時的なスキルを組み立てて実行する。
+
+```
+transform_instruction: "items 配列から title が 'Item B' のエントリを除外し、残りを返してください"
+input_data: { "items": [{ "title": "Item A" }, { "title": "Item B" }, { "title": "Item C" }] }
+↓ (LLM)
+output_data: { "items": [{ "title": "Item A" }, { "title": "Item C" }] }
+```
+
+### Review ノードとリビジョン
+
+Review ノードはレビューゲート。`review_status=review_pending` で下流カスケードが停止する。レビュアーが:
+- `approved` にすると `approved` 種別のエッジで下流に進む
+- `revision_requested` にすると `revision` 種別のエッジで差し戻し先に戻る
+
+レガシー線形パイプラインの差し戻しは `revision-watcher` デーモン + `/api/minion/pending-revisions` + `/api/minion/revision-reset` で処理される。DAGの差し戻しはサーバ側カスケードで自動処理。
+
+### デバッグ
+
+```bash
+# 自分が取得できる pending DAG ノードを確認
+curl -s "$HQ_URL/api/dag/minion/pending-nodes" \
+  -H "Authorization: Bearer $API_TOKEN" | jq
+
+# DAG 実行の詳細（UI用だがデバッグにも使える、セッション認証が必要なため通常はHQダッシュボード側から）
+# ミニオンから実行詳細を直接取得する手段は現時点では無い。pending-nodes で見える範囲で判断する
+
+# dag-step-poller のログを確認
+tail -f ~/.minion/logs/agent.log | grep '\[DAG'
+```
+
 ---
 
 ## プロジェクトコンテキストの操作

package/linux/bin/hq

@@ -10,10 +10,15 @@
 #   API_TOKEN - Minion API token for authentication
 #
 # Usage:
-#   hq fetch skill <name>            - Get skill details (content, description, files)
-#   hq fetch workflow <name>         - Get workflow details (pipeline, cron, etc.)
-#   hq fetch project <id>            - Get project info (name, description, role)
-#   hq fetch project-context <id>    - Get project context (shared Markdown document)
+#   hq fetch skill <name>                 - Get skill details (content, description, files)
+#   hq fetch workflow <name>              - Get workflow details (pipeline, cron, etc.)
+#   hq fetch project <id>                 - Get project info (name, description, role)
+#   hq fetch project-context <id>         - Get project context (shared Markdown document)
+#   hq fetch dag-workflow <id>            - Get DAG workflow details (graph, version)
+#   hq fetch dag-execution <id>           - Get DAG execution details (nodes, status)
+#   hq create dag-workflow <body.json>    - Create a DAG workflow (PM only). Body: {project_id, name, graph?, ...}
+#   hq put dag-workflow <id> <body.json>  - Update DAG workflow draft (PM only). Body: {graph?, content?, ...}
+#   hq publish dag-workflow <id>          - Publish the draft as a new version (PM only, validated)
 
 set -euo pipefail
 
@@ -39,12 +44,36 @@ format_json() {
   fi
 }
 
+# Validate that a file contains syntactically valid JSON. Exits with error on failure.
+validate_json_file() {
+  local file="$1"
+  if [ ! -f "$file" ]; then
+    echo "Error: file not found: $file" >&2
+    exit 1
+  fi
+  if command -v jq &>/dev/null; then
+    if ! jq empty "$file" 2>/dev/null; then
+      echo "Error: invalid JSON syntax in $file" >&2
+      jq empty "$file" || true
+      exit 1
+    fi
+  elif command -v python3 &>/dev/null; then
+    if ! python3 -c "import json,sys; json.load(open(sys.argv[1]))" "$file" 2>/dev/null; then
+      echo "Error: invalid JSON syntax in $file" >&2
+      python3 -c "import json,sys; json.load(open(sys.argv[1]))" "$file" || true
+      exit 1
+    fi
+  else
+    echo "Error: neither jq nor python3 is available to validate JSON" >&2
+    exit 1
+  fi
+}
+
 fetch_resource() {
   local url="$1"
   local response
   local http_code
 
-  # Fetch with HTTP status code
   response=$(curl -s -w "\n%{http_code}" -H "Authorization: Bearer $API_TOKEN" "$url")
   http_code=$(echo "$response" | tail -1)
   body=$(echo "$response" | sed '$d')
@@ -58,6 +87,68 @@ fetch_resource() {
   fi
 }
 
+# Send a JSON request body from a file. Method is POST or PUT.
+send_json_request() {
+  local method="$1"
+  local url="$2"
+  local file="$3"
+  local response
+  local http_code
+
+  response=$(curl -s -w "\n%{http_code}" -X "$method" \
+    -H "Authorization: Bearer $API_TOKEN" \
+    -H "Content-Type: application/json" \
+    --data-binary "@$file" \
+    "$url")
+  http_code=$(echo "$response" | tail -1)
+  body=$(echo "$response" | sed '$d')
+
+  if [ "$http_code" -ge 200 ] && [ "$http_code" -lt 300 ]; then
+    echo "$body" | format_json
+  else
+    echo "Error: HQ API returned HTTP $http_code" >&2
+    echo "$body" >&2
+    exit 1
+  fi
+}
+
+# Send a body-less POST (e.g., publish).
+send_empty_post() {
+  local url="$1"
+  local response
+  local http_code
+
+  response=$(curl -s -w "\n%{http_code}" -X POST \
+    -H "Authorization: Bearer $API_TOKEN" \
+    -H "Content-Length: 0" \
+    "$url")
+  http_code=$(echo "$response" | tail -1)
+  body=$(echo "$response" | sed '$d')
+
+  if [ "$http_code" -ge 200 ] && [ "$http_code" -lt 300 ]; then
+    echo "$body" | format_json
+  else
+    echo "Error: HQ API returned HTTP $http_code" >&2
+    echo "$body" >&2
+    exit 1
+  fi
+}
+
+print_usage() {
+  echo "HQ API helper for minion chat" >&2
+  echo "" >&2
+  echo "Usage:" >&2
+  echo "  hq fetch skill <name>                 - Get skill details" >&2
+  echo "  hq fetch workflow <name>              - Get workflow details" >&2
+  echo "  hq fetch project <id>                 - Get project info" >&2
+  echo "  hq fetch project-context <id>         - Get project context" >&2
+  echo "  hq fetch dag-workflow <id>            - Get DAG workflow details" >&2
+  echo "  hq fetch dag-execution <id>           - Get DAG execution details" >&2
+  echo "  hq create dag-workflow <body.json>    - Create a DAG workflow (PM only)" >&2
+  echo "  hq put dag-workflow <id> <body.json>  - Update DAG workflow draft (PM only)" >&2
+  echo "  hq publish dag-workflow <id>          - Publish the draft as a new version (PM only)" >&2
+}
+
 # Main command dispatch
 case "${1:-}" in
   fetch)
@@ -65,7 +156,7 @@ case "${1:-}" in
     identifier="${3:-}"
 
     if [ -z "$resource" ] || [ -z "$identifier" ]; then
-      echo "Usage: hq fetch {skill|workflow|project|project-context} <identifier>" >&2
+      echo "Usage: hq fetch {skill|workflow|project|project-context|dag-workflow|dag-execution} <identifier>" >&2
       exit 1
     fi
 
@@ -77,7 +168,6 @@ case "${1:-}" in
         fetch_resource "$BASE_URL/workflows/$identifier"
         ;;
       project)
-        # Fetch all projects and filter by ID
         response=$(curl -s -H "Authorization: Bearer $API_TOKEN" "$BASE_URL/me/projects")
         if command -v jq &>/dev/null; then
           echo "$response" | jq --arg id "$identifier" '.projects[] | select(.id == $id)'
@@ -88,21 +178,84 @@ case "${1:-}" in
       project-context)
         fetch_resource "$BASE_URL/me/project/$identifier/context"
         ;;
+      dag-workflow)
+        fetch_resource "$BASE_URL/dag-workflows/$identifier"
+        ;;
+      dag-execution)
+        fetch_resource "$BASE_URL/dag-executions/$identifier"
+        ;;
       *)
         echo "Unknown resource: $resource" >&2
-        echo "Usage: hq fetch {skill|workflow|project|project-context} <identifier>" >&2
+        echo "Usage: hq fetch {skill|workflow|project|project-context|dag-workflow|dag-execution} <identifier>" >&2
+        exit 1
+        ;;
+    esac
+    ;;
+
+  create)
+    resource="${2:-}"
+    case "$resource" in
+      dag-workflow)
+        body_file="${3:-}"
+        if [ -z "$body_file" ]; then
+          echo "Usage: hq create dag-workflow <body.json>" >&2
+          echo "  body.json must contain at least { project_id, name } and optionally { graph, content, change_summary }" >&2
+          exit 1
+        fi
+        validate_json_file "$body_file"
+        send_json_request POST "$BASE_URL/dag-workflows" "$body_file"
+        ;;
+      *)
+        echo "Unknown create resource: $resource" >&2
+        echo "Usage: hq create dag-workflow <body.json>" >&2
         exit 1
         ;;
     esac
     ;;
+
+  put)
+    resource="${2:-}"
+    case "$resource" in
+      dag-workflow)
+        id="${3:-}"
+        body_file="${4:-}"
+        if [ -z "$id" ] || [ -z "$body_file" ]; then
+          echo "Usage: hq put dag-workflow <id> <body.json>" >&2
+          echo "  body.json may contain { graph, content, change_summary, name, is_active, maturity }" >&2
+          exit 1
+        fi
+        validate_json_file "$body_file"
+        send_json_request PUT "$BASE_URL/dag-workflows/$id" "$body_file"
+        ;;
+      *)
+        echo "Unknown put resource: $resource" >&2
+        echo "Usage: hq put dag-workflow <id> <body.json>" >&2
+        exit 1
+        ;;
+    esac
+    ;;
+
+  publish)
+    resource="${2:-}"
+    case "$resource" in
+      dag-workflow)
+        id="${3:-}"
+        if [ -z "$id" ]; then
+          echo "Usage: hq publish dag-workflow <id>" >&2
+          exit 1
+        fi
+        send_empty_post "$BASE_URL/dag-workflows/$id/publish"
+        ;;
+      *)
+        echo "Unknown publish resource: $resource" >&2
+        echo "Usage: hq publish dag-workflow <id>" >&2
+        exit 1
+        ;;
+    esac
+    ;;
+
   *)
-    echo "HQ API helper for minion chat" >&2
-    echo "" >&2
-    echo "Usage:" >&2
-    echo "  hq fetch skill <name>            - Get skill details" >&2
-    echo "  hq fetch workflow <name>          - Get workflow details" >&2
-    echo "  hq fetch project <id>             - Get project info" >&2
-    echo "  hq fetch project-context <id>     - Get project context" >&2
+    print_usage
     exit 1
     ;;
 esac

package/linux/minion-cli.sh

@@ -497,10 +497,20 @@ NVNCEOF
     supervisord)
       # Build environment line from .env values
       # Include HOME and DISPLAY since supervisord does not set them when switching user
+      #
+      # NOTE: Runtime-mutable keys (LLM_COMMAND, REFLECTION_TIME) are intentionally
+      # excluded. supervisord's environment= parser has known quirks with nested
+      # quotes (e.g. LLM_COMMAND="claude -p '{prompt}'" gets the trailing quote
+      # stripped), and values baked into the supervisord conf become stale whenever
+      # the config API updates .env at runtime. These keys are loaded exclusively
+      # by core/config.js loadEnvFile() from the .env file at process startup.
       local ENV_LINE="environment="
       local ENV_PAIRS=("HOME=\"${TARGET_HOME}\"" "DISPLAY=\":99\"")
       while IFS='=' read -r key value; do
         [[ -z "$key" || "$key" == \#* ]] && continue
+        case "$key" in
+          LLM_COMMAND|REFLECTION_TIME) continue ;;
+        esac
         ENV_PAIRS+=("${key}=\"${value}\"")
       done < /opt/minion-agent/.env
 
@@ -1028,8 +1038,12 @@ CFEOF
         SVC_HOME=$(getent passwd "$SVC_USER" | cut -d: -f6 || echo "$HOME")
       fi
       local ENV_PAIRS=("HOME=\"${SVC_HOME}\"" "DISPLAY=\":99\"")
+      # Exclude runtime-mutable keys from supervisord env (see setup path comment)
       while IFS='=' read -r key value; do
         [[ -z "$key" || "$key" == \#* ]] && continue
+        case "$key" in
+          LLM_COMMAND|REFLECTION_TIME) continue ;;
+        esac
         ENV_PAIRS+=("${key}=\"${value}\"")
       done < /opt/minion-agent/.env
       ENV_LINE+="$(IFS=,; echo "${ENV_PAIRS[*]}")"

package/linux/routes/chat.js

@@ -22,8 +22,10 @@ const path = require('path')
 const { verifyToken } = require('../../core/lib/auth')
 const { config } = require('../../core/config')
 const chatStore = require('../../core/stores/chat-store')
+const todoStore = require('../../core/stores/todo-store')
 const { runEndOfDay } = require('../../core/lib/end-of-day')
 const { DATA_DIR } = require('../../core/lib/platform')
+const { getActivePrimary } = require('../../core/llm-plugins/lib/active')
 
 /** @type {import('child_process').ChildProcess | null} */
 let activeChatChild = null
@@ -254,6 +256,33 @@ ${indexed}`
 async function buildContextPrefix(message, context, sessionId) {
   const parts = []
 
+  // Re-inject unfinished todos tied to this session. This is how we survive
+  // context compaction: even if Claude forgot the plan, the outstanding
+  // todos are re-shown on the next turn. Todos past MAX_INJECTION_COUNT are
+  // skipped by the store to prevent infinite loops.
+  if (sessionId) {
+    parts.push(
+      `[現在のチャットセッションID] ${sessionId}`,
+      '新規Todoを作成する際は `session_id` にこの値を含めてください（圧縮を跨いだ自動再掲の対象になります）。',
+      ''
+    )
+    const activeTodos = todoStore.listActiveForSession(sessionId)
+    if (activeTodos.length > 0) {
+      parts.push(
+        '[未完了のToDo（このセッション起点）]',
+        '以下のToDoが未完了のまま残っています。着手前に「既に完了していないか」を確認し、',
+        '完了済みなら `PUT /api/todos/:id` で status=done に更新、未完なら続行してください。',
+        ''
+      )
+      for (const t of activeTodos) {
+        const desc = t.description ? ` — ${t.description}` : ''
+        parts.push(`- [${t.id}] (${t.status}/${t.priority}) ${t.title}${desc}`)
+      }
+      parts.push('')
+      todoStore.markInjected(activeTodos.map(t => t.id))
+    }
+  }
+
   // Tell the LLM how to access memory and daily logs via API
   if (!sessionId) {
     const port = require('../../core/config').config.AGENT_PORT
@@ -336,6 +365,45 @@ async function buildContextPrefix(message, context, sessionId) {
           )
         }
         break
+      case 'dag-workflow':
+        if (context.projectId && context.dagWorkflowId) {
+          parts.push(
+            `ユーザーはHQダッシュボードで DAG ワークフロー (ID: ${context.dagWorkflowId}) のエディタ/詳細を閲覧しています。`,
+            `DAG ワークフローはノード/エッジ形式でスキル間の依存関係を表現し、fan-out / join / conditional / transform / review をサポートします。`,
+            `DAG ワークフロー情報を取得するには以下を実行してください:`,
+            `  hq fetch dag-workflow ${context.dagWorkflowId}`,
+            `プロジェクトコンテキスト:`,
+            `  hq fetch project-context ${context.projectId}`,
+            `PMロールの場合、graph JSON を直接編集できます:`,
+            `  hq put dag-workflow ${context.dagWorkflowId} <body.json>   # ドラフト更新 (構造チェックのみ)`,
+            `  hq publish dag-workflow ${context.dagWorkflowId}           # ドラフトを新バージョンとして公開 (フル検証)`,
+            `新規作成は: hq create dag-workflow <body.json>`,
+            `DAG の構造（nodes/edges/node types/scope_path 等）や実行フローの詳細は ~/.minion/docs/api-reference.md の「DAG Workflows」セクション、および ~/.minion/docs/task-guides.md の「DAG ワークフロー」セクションを参照してください。`,
+            `取得した内容をもとに回答してください。`
+          )
+        }
+        break
+      case 'dag-execution':
+        if (context.projectId && context.dagExecutionId) {
+          parts.push(
+            `ユーザーはHQダッシュボードで DAG 実行 (ID: ${context.dagExecutionId}) の詳細を閲覧しています。`,
+            `DAG 実行の詳細（graph_snapshot + 各 node_executions の状態）を取得するには以下を実行してください:`,
+            `  hq fetch dag-execution ${context.dagExecutionId}`
+          )
+          if (context.dagWorkflowId) {
+            parts.push(
+              `対応するDAGワークフロー定義:`,
+              `  hq fetch dag-workflow ${context.dagWorkflowId}`
+            )
+          }
+          parts.push(
+            `プロジェクトコンテキスト:`,
+            `  hq fetch project-context ${context.projectId}`,
+            `ノード状態の意味（pending/waiting/running/completed/failed/skipped, review_status, scope_path 等）は ~/.minion/docs/api-reference.md の「DAG Workflows」セクションを参照してください。`,
+            `取得した内容をもとに回答してください。`
+          )
+        }
+        break
     }
   }
 
@@ -362,7 +430,76 @@ function getLlmBinary() {
  * Tracks block types to correctly forward tool_use vs text events
  * and counts turns for session management.
  */
-function streamLlmResponse(res, prompt, sessionId, workspaceId, originalMessage) {
+async function streamLlmResponse(res, prompt, sessionId, workspaceId, originalMessage) {
+  // Plugin system path: Primary is set → delegate to plugin
+  const primary = getActivePrimary()
+  if (primary) {
+    return streamViaPlugin(primary, res, prompt, sessionId, workspaceId, originalMessage)
+  }
+  return streamViaLegacyLlmCommand(res, prompt, sessionId, workspaceId, originalMessage)
+}
+
+async function streamViaPlugin(plugin, res, prompt, sessionId, workspaceId, originalMessage) {
+  const input = { prompt }
+  const activeRef = { current: null }
+  activeChatChild = { kill: () => activeRef.current?.kill?.('SIGTERM') }
+
+  let fullResponse = ''
+  let resolvedSessionId = sessionId || null
+  let turnCount = 0
+
+  const emit = event => {
+    if (event.type === 'session') {
+      resolvedSessionId = event.sessionId
+    } else if (event.type === 'delta') {
+      fullResponse += event.content
+      res.write(`data: ${JSON.stringify({ type: 'delta', content: event.content })}\n\n`)
+    } else if (event.type === 'text') {
+      fullResponse += event.content
+      res.write(`data: ${JSON.stringify({ type: 'text', content: event.content })}\n\n`)
+      turnCount++
+    } else {
+      res.write(`data: ${JSON.stringify(event)}\n\n`)
+    }
+  }
+
+  res.on('close', () => { activeRef.current?.kill?.('SIGTERM') })
+
+  try {
+    let output
+    if (plugin.capabilities.streaming && typeof plugin.stream === 'function') {
+      output = await plugin.stream(input, emit, { resumeSessionId: sessionId, activeChildRef: activeRef })
+    } else {
+      output = await plugin.invoke(input)
+      if (output.text) {
+        fullResponse = output.text
+        res.write(`data: ${JSON.stringify({ type: 'text', content: output.text })}\n\n`)
+        turnCount = 1
+      }
+      if (output.error) {
+        res.write(`data: ${JSON.stringify({ type: 'error', error: output.error.message })}\n\n`)
+      }
+    }
+    resolvedSessionId = output?.metadata?.sessionId || resolvedSessionId
+  } finally {
+    activeChatChild = null
+  }
+
+  if (resolvedSessionId) {
+    if (!sessionId) {
+      await chatStore.addMessage(resolvedSessionId, { role: 'user', content: originalMessage || prompt }, undefined, workspaceId)
+    }
+    if (fullResponse) {
+      await chatStore.addMessage(resolvedSessionId, { role: 'assistant', content: fullResponse }, turnCount, workspaceId)
+    }
+  }
+
+  const session = await chatStore.load(workspaceId)
+  const totalTurnCount = session?.turn_count || turnCount
+  res.write(`data: ${JSON.stringify({ type: 'done', session_id: resolvedSessionId, turn_count: totalTurnCount })}\n\n`)
+}
+
+function streamViaLegacyLlmCommand(res, prompt, sessionId, workspaceId, originalMessage) {
   return new Promise((resolve, reject) => {
     const binaryName = getLlmBinary()
     if (!binaryName) {
@@ -587,7 +724,17 @@ function streamLlmResponse(res, prompt, sessionId, workspaceId, originalMessage)
  * @param {string} prompt
  * @returns {Promise<string>} The result text
  */
-function runQuickLlmCall(prompt) {
+async function runQuickLlmCall(prompt) {
+  const primary = getActivePrimary()
+  if (primary) {
+    const output = await primary.invoke({ prompt, model: primary.name === 'claude' ? 'haiku' : undefined, timeoutMs: 30000 })
+    if (output.error) throw new Error(output.error.message)
+    return output.text || ''
+  }
+  return runQuickLlmCallLegacy(prompt)
+}
+
+function runQuickLlmCallLegacy(prompt) {
   return new Promise((resolve, reject) => {
     const binaryName = getLlmBinary()
     if (!binaryName) {