@geekbeer/minion 3.30.0 → 3.34.0

package/core/lib/dag-step-poller.js

@@ -385,7 +385,8 @@ function buildTransformSkillContent(instruction, inputData, outputContracts) {
       lines.push('| Field | Type | Required | Description |')
       lines.push('|-------|------|----------|-------------|')
       for (const f of oc.contract.fields || []) {
-        lines.push(`| ${f.key} | ${f.type} | ${f.required ? 'Yes' : 'No'} | ${f.description || ''} |`)
+        const typeDisplay = f.type === 'array' && f.items ? `array<${f.items}>` : f.type
+        lines.push(`| ${f.key} | ${typeDisplay} | ${f.required ? 'Yes' : 'No'} | ${f.description || ''} |`)
       }
     }
   }

package/core/llm-plugins/claude/stream.js

@@ -35,7 +35,7 @@ function streamClaude(input, onEvent, ctx = {}) {
     const child = spawn(bin, args, {
       cwd: config.HOME_DIR,
       stdio: ['pipe', 'pipe', 'pipe'],
-      timeout: input.timeoutMs || 600000,
+      timeout: input.timeoutMs || 3600000, // 60 min default
       env: {
         ...process.env,
         HOME: config.HOME_DIR,

package/docs/api-reference.md

@@ -1048,8 +1048,13 @@ PUT `/api/minion/dag-workflows/:id` body（全フィールド optional、省略
 }
 ```
 
-- `graph` を渡すと draft_graph が上書きされる（構造チェックのみ、セマンティックチェック無し）
+- `graph` を渡すと draft_graph が上書きされる（構造チェック + structural validation: contract参照の型整合性チェックは実行、ノード完全性チェックは `publish` 時のみ）
 - `content` / `change_summary` は `graph` と併せて draft スロットに保存される
+- **推奨**: graph 全文PUTは**原則使用しない**。代わりに個別APIの `/nodes` `/edges` `/contracts` を使ってインクリメンタルに編集すること。全文PUTは型の取り違え（例: `edge.contract` に配列を渡す）が発生しやすく、バリデーションエラーで400が返る
+- 具体的な制約:
+  - `edge.contract` は**単一の**Contract名（string）。配列は不可
+  - `contract.fields[].items` は Contract名（string）で、`graph.contracts` 内に存在するものを参照
+  - 不整合があると `{ "error": "...", "details": [...] }` の形式で400エラー
 
 POST `/api/minion/dag-workflows/:id/publish` (body なし):
 - 現在の draft_graph を `validateDagGraph` でフル検証
@@ -1206,15 +1211,48 @@ POST `/api/minion/dag-workflows/:id/publish` (body なし):
     type: "string" | "number" | "boolean" | "url" | "array" | "object"  // フィールド型
     description: string        // フィールドの説明
     required?: boolean         // 必須フラグ (省略時 false)
+    items?: string             // type='array' 時のみ。要素の型を表す別Contract名
   }]
 }
 ```
 
 **注意:**
 - エッジに設定する `contract` は `graph.contracts` に存在する名前でなければならない（存在しない名前を指定すると 400 エラー）
+- **エッジが参照できる Contract は 1 つのみ**。`edge.contract` に配列を渡すことは不可（400エラー）。複数の型構造を束ねたい場合は、それらを束ねた複合Contractを1つ定義してから参照すること
 - contract を削除すると、参照しているエッジの `contract` フィールドが自動でクリアされる（DELETE / PUT 共通）
 - `validate` エンドポイントはダングリング参照（存在しない contract への参照）をエラーとして報告する
 
+**Contract内で List<別Contract> を表現する方法 (items):**
+
+`type: 'array'` のフィールドに `items` プロパティを設定すると、配列要素の型を別Contractで記述できる。`items` の値は `graph.contracts` 内のContract名。
+
+```json
+{
+  "contracts": {
+    "Article": {
+      "description": "個別の記事",
+      "fields": [
+        { "key": "title", "type": "string", "required": true, "description": "タイトル" },
+        { "key": "url", "type": "url", "description": "記事URL" }
+      ]
+    },
+    "NewsCollection": {
+      "description": "収集されたニュース全体",
+      "fields": [
+        { "key": "articles", "type": "array", "items": "Article", "required": true, "description": "記事リスト" },
+        { "key": "collected_at", "type": "string", "required": true, "description": "収集日時" },
+        { "key": "count", "type": "number", "required": true, "description": "件数" }
+      ]
+    }
+  },
+  "edges": [
+    { "id": "edge_1", "source": "a", "target": "b", "contract": "NewsCollection" }
+  ]
+}
+```
+
+この構造で「エッジは単一Contract (`NewsCollection`) を参照し、その内部で `articles` フィールドが `Article[]` 型」という意味になる。
+
 ##### GET `/api/minion/dag-workflows/:id/contracts` — 全contracts取得
 
 レスポンス: `{ "contracts": { "name": { "description": "...", "fields": [...] }, ... } }`

package/linux/minion-cli.sh

@@ -1096,13 +1096,28 @@ SUPEOF
   HOSTNAME_VAL=$(hostname 2>/dev/null || echo "")
   LAN_IP=$(detect_lan_ip)
 
+  # Collect machine specs
+  local CPU_MODEL CPU_CORES MEMORY_MB DISK_GB OS_INFO ARCH_INFO
+  CPU_MODEL=$(grep -m1 'model name' /proc/cpuinfo 2>/dev/null | cut -d: -f2 | sed 's/^ //' || echo "unknown")
+  CPU_CORES=$(nproc 2>/dev/null || grep -c '^processor' /proc/cpuinfo 2>/dev/null || echo "0")
+  MEMORY_MB=$(awk '/MemTotal/ {printf "%.0f", $2/1024}' /proc/meminfo 2>/dev/null || echo "0")
+  DISK_GB=$(df -BG / 2>/dev/null | awk 'NR==2 {gsub("G",""); print $2}' || echo "0")
+  OS_INFO=$(. /etc/os-release 2>/dev/null && echo "${PRETTY_NAME}" || uname -s 2>/dev/null || echo "unknown")
+  ARCH_INFO=$(uname -m 2>/dev/null || echo "unknown")
+
+  local MACHINE_SPECS
+  MACHINE_SPECS=$(cat <<SPECEOF
+{"cpu_model":"${CPU_MODEL}","cpu_cores":${CPU_CORES},"memory_mb":${MEMORY_MB},"disk_gb":${DISK_GB},"os":"${OS_INFO}","arch":"${ARCH_INFO}"}
+SPECEOF
+  )
+
   local BODY
   if [ -f /.dockerenv ]; then
-    BODY="{\"internal_ip_address\":\"${HOSTNAME_VAL}\"}"
+    BODY="{\"internal_ip_address\":\"${HOSTNAME_VAL}\",\"machine_specs\":${MACHINE_SPECS}}"
   elif [ -n "$LAN_IP" ]; then
-    BODY="{\"internal_ip_address\":\"${LAN_IP}\",\"ip_address\":\"${LAN_IP}\"}"
+    BODY="{\"internal_ip_address\":\"${LAN_IP}\",\"ip_address\":\"${LAN_IP}\",\"machine_specs\":${MACHINE_SPECS}}"
   else
-    BODY="{\"internal_ip_address\":\"${HOSTNAME_VAL}\"}"
+    BODY="{\"internal_ip_address\":\"${HOSTNAME_VAL}\",\"machine_specs\":${MACHINE_SPECS}}"
   fi
 
   NOTIFY_RESPONSE=$(curl -sfL -X POST "${HQ_URL}/api/minion/setup-complete" \

package/linux/routes/chat.js

@@ -353,6 +353,36 @@ async function buildContextPrefix(message, context, sessionId, workspaceId) {
     )
   }
 
+  // Task planning guidance — instruct Claude to create TODOs before starting work
+  if (!sessionId) {
+    const port = require('../../core/config').config.AGENT_PORT
+    parts.push(
+      '[作業手順 — 必ず守ること]',
+      '依頼された作業に着手する**前に**、以下の手順を踏むこと:',
+      '',
+      '1. 依頼内容を分析し、必要なステップをToDoとして登録する',
+      '2. 各ステップを完了するたびに、ToDoのstatusを `done` に更新する',
+      '3. すべてのToDoが完了したら、ユーザーに完了報告する',
+      '',
+      'ToDo APIの使い方:',
+      '```bash',
+      '# ToDo作成（session_idは後でセッションIDが判明してから設定）',
+      `curl -X POST http://localhost:${port}/api/todos \\`,
+      '  -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application/json" \\',
+      '  -d \'{"title": "ステップの説明", "session_id": "SESSION_ID", "priority": "normal"}\'',
+      '',
+      '# ToDo完了',
+      `curl -X PUT http://localhost:${port}/api/todos/{id} \\`,
+      '  -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application/json" \\',
+      '  -d \'{"status": "done"}\'',
+      '```',
+      '',
+      'ToDoを先に作成する理由: チャットのコンテキストが圧縮されても、未完了のToDoは次のターンで自動的に再表示されます。',
+      'これにより、長時間の作業でも途中で何をすべきか見失うことがありません。',
+      ''
+    )
+  }
+
   if (context) {
     switch (context.type) {
       case 'skill':
@@ -403,7 +433,7 @@ async function buildContextPrefix(message, context, sessionId, workspaceId) {
             `  hq fetch dag-workflow ${context.dagWorkflowId}`,
             `プロジェクトコンテキスト:`,
             `  hq fetch project-context ${context.projectId}`,
-            `PMロールの場合、ノード/エッジ操作APIでインクリメンタルに編集できます（推奨）:`,
+            `PMロールの場合、ノード/エッジ操作APIでインクリメンタルに編集してください（**強く推奨**、全文PUTは型取り違えが起きやすいためエラーになりがち）:`,
             `  hq dag add-node ${context.dagWorkflowId} <body.json>              # ノード追加`,
             `  hq dag update-node ${context.dagWorkflowId} <node-id> <body.json> # ノード更新`,
             `  hq dag remove-node ${context.dagWorkflowId} <node-id>             # ノード削除`,
@@ -411,7 +441,8 @@ async function buildContextPrefix(message, context, sessionId, workspaceId) {
             `  hq dag remove-edge ${context.dagWorkflowId} <edge-id>             # エッジ削除`,
             `  hq dag validate ${context.dagWorkflowId}                          # ドラフト検証（公開せず）`,
             `  hq publish dag-workflow ${context.dagWorkflowId}                  # 公開`,
-            `graph JSON 全文操作も可能: hq put dag-workflow ${context.dagWorkflowId} <body.json>`,
+            `Contract編集時の重要な規則: edge.contract は単一Contract名（string）のみ、配列不可。List<X> は type:"array" + items:"X" で表現。詳細は ~/.minion/docs/api-reference.md の「Contracts API」参照。`,
+            `graph JSON 全文PUTは非推奨: hq put dag-workflow ${context.dagWorkflowId} <body.json>`,
             `新規作成は: hq create dag-workflow <body.json>`,
             `プロジェクト内の DAG ワークフロー一覧: hq list dag-workflows ${context.projectId}`,
             `DAG の構造（nodes/edges/node types/scope_path 等）や実行フローの詳細は ~/.minion/docs/api-reference.md の「DAG Workflows」セクション、および ~/.minion/docs/task-guides.md の「DAG ワークフロー」セクションを参照してください。`,
@@ -568,7 +599,7 @@ function streamViaLegacyLlmCommand(res, prompt, sessionId, workspaceId, original
     const child = spawn(binary, args, {
       cwd: config.HOME_DIR,
       stdio: ['pipe', 'pipe', 'pipe'],
-      timeout: 600000, // 10 min
+      timeout: 3600000, // 60 min — allow long-running tasks to complete
     })
 
     // Track active child process for abort

package/linux/workflow-runner.js

@@ -106,7 +106,8 @@ async function executeWorkflowSession(workflow, executionId, skillNames, options
       contractContext += `### ${ic.contract_name}\n${ic.contract.description || ''}\n`
       contractContext += '| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n'
       for (const f of ic.contract.fields || []) {
-        contractContext += `| ${f.key} | ${f.type} | ${f.required ? 'Yes' : 'No'} | ${f.description || ''} |\n`
+        const typeDisplay = f.type === 'array' && f.items ? `array<${f.items}>` : f.type
+        contractContext += `| ${f.key} | ${typeDisplay} | ${f.required ? 'Yes' : 'No'} | ${f.description || ''} |\n`
       }
     }
     contractContext += '\n'
@@ -117,7 +118,8 @@ async function executeWorkflowSession(workflow, executionId, skillNames, options
       contractContext += `### ${oc.contract_name}\n${oc.contract.description || ''}\n`
       contractContext += '| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n'
       for (const f of oc.contract.fields || []) {
-        contractContext += `| ${f.key} | ${f.type} | ${f.required ? 'Yes' : 'No'} | ${f.description || ''} |\n`
+        const typeDisplay = f.type === 'array' && f.items ? `array<${f.items}>` : f.type
+        contractContext += `| ${f.key} | ${typeDisplay} | ${f.required ? 'Yes' : 'No'} | ${f.description || ''} |\n`
       }
     }
     contractContext += '\n'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekbeer/minion",
-  "version": "3.30.0",
+  "version": "3.34.0",
   "description": "AI Agent runtime for Minion - manages status and skill deployment on VPS",
   "main": "linux/server.js",
   "bin": {

package/rules/core.md

@@ -28,6 +28,10 @@ Minion
 
 - **Workflow**: プロジェクトスコープ。線形パイプライン形式のバージョン管理ワークフロー。ミニオンAPIで push/fetch 可能。
 - **DAG Workflow**: プロジェクトスコープ。ノード/エッジで依存関係を表現する新方式。fan-out / join / conditional / transform / review をサポート。作成・編集はHQダッシュボードのみ、ミニオンは `dag-step-poller` で自動実行。詳細は `~/.minion/docs/api-reference.md` の「DAG Workflows」と `~/.minion/docs/task-guides.md` の「DAG ワークフロー」を参照。
+  - **PMロールで編集する場合の重要な規則**:
+    - ノード/エッジ/contract の追加・更新は**個別API** (`/nodes` `/edges` `/contracts`) を使うこと。`PUT /dag-workflows/:id` による graph 全文PUTは型の取り違えが起きやすく、バリデーションエラーで 400 が返る
+    - `edge.contract` は**単一のContract名（string）**のみ。配列は不可。複数の型構造を束ねたい場合は、それらを内包する複合Contractを1つ定義する
+    - Contract内で `List<別Contract>` を表現するには `type: 'array'` + `items: "別Contract名"` を使う（詳細は `~/.minion/docs/api-reference.md` の「Contracts API」を参照）
 - **Routine**: ミニオンスコープ。ミニオンローカルの定期タスク。
 - **Workspace**: ミニオンは複数のワークスペースに所属でき、スキルやプロジェクトはワークスペース単位でスコープされる。チャットセッションもワークスペース別に分離される。所属ワークスペースはハートビートで自動同期され、`hq list workspaces` で確認できる。
 - ミニオンは複数プロジェクトに `pm`、`engineer`、`accountant` として参加できる。

package/win/minion-cli.ps1

@@ -1522,7 +1522,21 @@ function Invoke-Configure {
         $bodyHash = @{}
         if ($lanIp) { $bodyHash['ip_address'] = $lanIp; $bodyHash['internal_ip_address'] = $lanIp }
         else { $bodyHash['internal_ip_address'] = [System.Net.Dns]::GetHostName() }
-        $body = $bodyHash | ConvertTo-Json
+
+        # Collect machine specs
+        $cpuInfo = Get-CimInstance Win32_Processor -ErrorAction SilentlyContinue | Select-Object -First 1
+        $osInfo = Get-CimInstance Win32_OperatingSystem -ErrorAction SilentlyContinue
+        $diskInfo = Get-CimInstance Win32_LogicalDisk -Filter "DeviceID='C:'" -ErrorAction SilentlyContinue
+        $bodyHash['machine_specs'] = @{
+            cpu_model  = if ($cpuInfo) { $cpuInfo.Name } else { 'unknown' }
+            cpu_cores  = if ($cpuInfo) { $cpuInfo.NumberOfLogicalProcessors } else { 0 }
+            memory_mb  = if ($osInfo) { [math]::Round($osInfo.TotalVisibleMemorySize / 1024) } else { 0 }
+            disk_gb    = if ($diskInfo) { [math]::Round($diskInfo.Size / 1GB) } else { 0 }
+            os         = if ($osInfo) { $osInfo.Caption } else { 'Windows' }
+            arch       = $env:PROCESSOR_ARCHITECTURE
+        }
+
+        $body = $bodyHash | ConvertTo-Json -Depth 3
         Invoke-RestMethod -Uri "$HqUrl/api/minion/setup-complete" -Method Post -Headers $headers -Body $body -ErrorAction Stop | Out-Null
         Write-Detail "HQ notified"
     }

package/win/routes/chat.js

@@ -416,6 +416,36 @@ async function buildContextPrefix(message, context, sessionId, workspaceId) {
     )
   }
 
+  // Task planning guidance — instruct Claude to create TODOs before starting work
+  if (!sessionId) {
+    const port = require('../../core/config').config.AGENT_PORT
+    parts.push(
+      '[作業手順 — 必ず守ること]',
+      '依頼された作業に着手する**前に**、以下の手順を踏むこと:',
+      '',
+      '1. 依頼内容を分析し、必要なステップをToDoとして登録する',
+      '2. 各ステップを完了するたびに、ToDoのstatusを `done` に更新する',
+      '3. すべてのToDoが完了したら、ユーザーに完了報告する',
+      '',
+      'ToDo APIの使い方:',
+      '```bash',
+      '# ToDo作成（session_idは後でセッションIDが判明してから設定）',
+      `curl -X POST http://localhost:${port}/api/todos \\`,
+      '  -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application/json" \\',
+      '  -d \'{"title": "ステップの説明", "session_id": "SESSION_ID", "priority": "normal"}\'',
+      '',
+      '# ToDo完了',
+      `curl -X PUT http://localhost:${port}/api/todos/{id} \\`,
+      '  -H "Authorization: Bearer $API_TOKEN" -H "Content-Type: application/json" \\',
+      '  -d \'{"status": "done"}\'',
+      '```',
+      '',
+      'ToDoを先に作成する理由: チャットのコンテキストが圧縮されても、未完了のToDoは次のターンで自動的に再表示されます。',
+      'これにより、長時間の作業でも途中で何をすべきか見失うことがありません。',
+      ''
+    )
+  }
+
   if (context) {
     switch (context.type) {
       case 'skill':
@@ -464,7 +494,7 @@ async function buildContextPrefix(message, context, sessionId, workspaceId) {
             `  hq fetch dag-workflow ${context.dagWorkflowId}`,
             `プロジェクトコンテキスト:`,
             `  hq fetch project-context ${context.projectId}`,
-            `PMロールの場合、ノード/エッジ操作APIでインクリメンタルに編集できます（推奨）:`,
+            `PMロールの場合、ノード/エッジ操作APIでインクリメンタルに編集してください（**強く推奨**、全文PUTは型取り違えが起きやすいためエラーになりがち）:`,
             `  hq dag add-node ${context.dagWorkflowId} <body.json>              # ノード追加`,
             `  hq dag update-node ${context.dagWorkflowId} <node-id> <body.json> # ノード更新`,
             `  hq dag remove-node ${context.dagWorkflowId} <node-id>             # ノード削除`,
@@ -472,7 +502,8 @@ async function buildContextPrefix(message, context, sessionId, workspaceId) {
             `  hq dag remove-edge ${context.dagWorkflowId} <edge-id>             # エッジ削除`,
             `  hq dag validate ${context.dagWorkflowId}                          # ドラフト検証（公開せず）`,
             `  hq publish dag-workflow ${context.dagWorkflowId}                  # 公開`,
-            `graph JSON 全文操作も可能: hq put dag-workflow ${context.dagWorkflowId} <body.json>`,
+            `Contract編集時の重要な規則: edge.contract は単一Contract名（string）のみ、配列不可。List<X> は type:"array" + items:"X" で表現。詳細は ~/.minion/docs/api-reference.md の「Contracts API」参照。`,
+            `graph JSON 全文PUTは非推奨: hq put dag-workflow ${context.dagWorkflowId} <body.json>`,
             `新規作成は: hq create dag-workflow <body.json>`,
             `プロジェクト内の DAG ワークフロー一覧: hq list dag-workflows ${context.projectId}`,
             `DAG の構造（nodes/edges/node types/scope_path 等）や実行フローの詳細は ~/.minion/docs/api-reference.md の「DAG Workflows」セクション、および ~/.minion/docs/task-guides.md の「DAG ワークフロー」セクションを参照してください。`,
@@ -602,7 +633,7 @@ function streamViaLegacyLlmCommand(res, prompt, sessionId, workspaceId, original
     const child = spawn(binary, args, {
       cwd: config.HOME_DIR,
       stdio: ['pipe', 'pipe', 'pipe'],
-      timeout: 600000,
+      timeout: 3600000, // 60 min — allow long-running tasks to complete
       shell: true, // Required on Windows to resolve .cmd shims (e.g. claude.cmd)
     })
 

package/win/workflow-runner.js

@@ -113,7 +113,8 @@ async function executeWorkflowSession(workflow, executionId, skillNames, options
       contractContext += `### ${ic.contract_name}\n${ic.contract.description || ''}\n`
       contractContext += '| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n'
       for (const f of ic.contract.fields || []) {
-        contractContext += `| ${f.key} | ${f.type} | ${f.required ? 'Yes' : 'No'} | ${f.description || ''} |\n`
+        const typeDisplay = f.type === 'array' && f.items ? `array<${f.items}>` : f.type
+        contractContext += `| ${f.key} | ${typeDisplay} | ${f.required ? 'Yes' : 'No'} | ${f.description || ''} |\n`
       }
     }
     contractContext += '\n'
@@ -124,7 +125,8 @@ async function executeWorkflowSession(workflow, executionId, skillNames, options
       contractContext += `### ${oc.contract_name}\n${oc.contract.description || ''}\n`
       contractContext += '| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n'
       for (const f of oc.contract.fields || []) {
-        contractContext += `| ${f.key} | ${f.type} | ${f.required ? 'Yes' : 'No'} | ${f.description || ''} |\n`
+        const typeDisplay = f.type === 'array' && f.items ? `array<${f.items}>` : f.type
+        contractContext += `| ${f.key} | ${typeDisplay} | ${f.required ? 'Yes' : 'No'} | ${f.description || ''} |\n`
       }
     }
     contractContext += '\n'

package/win/wsl-session-server.js

@@ -187,7 +187,7 @@ function streamLlmResponse(res, prompt, sessionId) {
     const child = spawn(binary, args, {
       cwd: HOME_DIR,
       stdio: ['pipe', 'pipe', 'pipe'],
-      timeout: 600000,
+      timeout: 3600000, // 60 min — allow long-running tasks to complete
       shell: true,
     })