@geekbeer/minion 2.5.1 → 2.10.1

package/rules/minion.md

@@ -3,6 +3,51 @@
 You are running on a Minion VPS managed by the @geekbeer/minion package.
 A local Agent API server runs at `http://localhost:3001` and a CLI tool `minion-cli` is available.
 
+## Architecture: Project / Workflow / Routine
+
+```
+Project (組織・課金単位)
+├── Context (markdown, PMが更新)
+├── Members (minion + role: pm | engineer)
+└── Workflows (何をするか + オプションのcronスケジュール)
+    ├── Versions (pipeline の不変スナップショット)
+    └── Executions (実行履歴, ステップごとの進捗)
+
+Minion
+└── Routines (いつ・何を, cron付き, ミニオンローカルのタスク)
+```
+
+- **Workflow** はプロジェクトスコープ。バージョン管理されたパイプライン（スキル列）を持つ。オプションで `cron_expression` によるスケジュール実行が可能。HQ UIからワンショット実行もできる。
+- **Routine** はミニオンスコープ。ミニオンローカルの定期タスク。cron_expression を持ち自律トリガーする。
+- ミニオンは複数プロジェクトに `pm` または `engineer` として参加できる。
+- ワークフローの各ステップには `assigned_role`（pm/engineer）と `requires_review` フラグがある。
+
+## Workflow Execution Model (DB ステートマシン)
+
+ワークフロー実行はHQのDBがステートマシンとして管理する。ミニオン間通信は不要。
+
+```
+1. Execution 作成 (HQ UIのRunボタン or cronスケジュール)
+   → workflow_execution (status='pending')
+   → workflow_step_executions (全ステップ status='pending')
+
+2. ミニオンエージェントが GET /api/minion/pending-steps をポーリング
+   → 自分のロールに該当 & 前ステップ完了済みのステップを取得
+
+3. ミニオンがステップを実行し完了を報告
+   → POST /api/minion/execution で status/outcome を更新
+
+4. 次ステップが eligible に → 別のミニオンが検知して実行
+   → requires_review=true の場合はHQでレビュー承認後に次へ
+
+5. 全ステップ完了 → execution 全体を completed に
+```
+
+**ポイント:**
+- HQの責務は「executionレコードを作る（指示書発行）」だけ
+- 各ミニオンは自分の担当ステップだけをポーリングして実行
+- ミニオンエージェント（Port 3001）が軽量HTTPポーリングを行い、pending検知時のみClaude Codeを起動（トークン節約）
+
 ## CLI Commands
 
 ```bash
@@ -35,7 +80,7 @@ Authentication: `Authorization: Bearer $API_TOKEN` header (except where noted).
 | Method | Endpoint | Description |
 |--------|----------|-------------|
 | GET | `/api/list-skills` | List local deployed skills |
-| DELETE | `/api/skills/:name` | Delete local skill |
+| DELETE | `/api/skills/:name` | Delete a local skill |
 | POST | `/api/skills/push/:name` | Push local skill to HQ |
 | POST | `/api/skills/fetch/:name` | Fetch skill from HQ and deploy locally |
 | GET | `/api/skills/remote` | List skills on HQ |
@@ -44,23 +89,22 @@ Authentication: `Authorization: Bearer $API_TOKEN` header (except where noted).
 
 | Method | Endpoint | Description |
 |--------|----------|-------------|
-| GET | `/api/workflows` | List all workflows with next_run |
-| POST | `/api/workflows` | Receive/upsert workflows from HQ |
+| GET | `/api/workflows` | List all local workflows with next_run |
+| POST | `/api/workflows` | Receive/upsert workflows (from HQ or local) |
 | POST | `/api/workflows/push/:name` | Push local workflow to HQ |
 | POST | `/api/workflows/fetch/:name` | Fetch workflow from HQ and deploy locally (+ pipeline skills) |
 | GET | `/api/workflows/remote` | List workflows on HQ |
-| PUT | `/api/workflows/:id/schedule` | Update workflow schedule (cron_expression, is_active) |
-| DELETE | `/api/workflows/:id` | Remove workflow |
+| DELETE | `/api/workflows/:id` | Remove a local workflow |
 | POST | `/api/workflows/trigger` | Manual trigger. Body: `{workflow_id}` |
 
 ### Executions
 
 | Method | Endpoint | Description |
 |--------|----------|-------------|
-| GET | `/api/executions` | List execution history (?limit=50) |
+| GET | `/api/executions` | List execution history (`?limit=50`, `?workflow_id=`) |
 | GET | `/api/executions/:id` | Get single execution |
-| GET | `/api/executions/:id/log` | Get execution log content |
-| POST | `/api/executions/:id/outcome` | Report outcome (no auth). Body: `{outcome}` |
+| GET | `/api/executions/:id/log` | Get execution log content (`?tail=N`) |
+| POST | `/api/executions/:id/outcome` | Report outcome (no auth). Body: `{outcome, summary?, details?}` |
 
 Outcome values: `success`, `failure`, `partial`
 
@@ -69,13 +113,25 @@ Outcome values: `success`, `failure`, `partial`
 | Method | Endpoint | Description |
 |--------|----------|-------------|
 | GET | `/api/terminal/sessions` | List tmux sessions |
-| POST | `/api/terminal/send` | Send keys. Body: `{session, keys}` |
-| POST | `/api/terminal/create` | Create session. Body: `{name, command?}` |
+| POST | `/api/terminal/send` | Send keys. Body: `{session, input?, enter?, special?}` |
+| POST | `/api/terminal/create` | Create session. Body: `{name?, command?}` |
 | POST | `/api/terminal/kill` | Kill session. Body: `{session}` |
-| GET | `/api/terminal/capture` | Capture pane content. Query: `?session=` |
+| GET | `/api/terminal/capture` | Capture pane content. Query: `?session=&lines=100` |
 | GET | `/api/terminal/ttyd/status` | ttyd process status |
-| POST | `/api/terminal/ttyd/start` | Start ttyd. Body: `{session}` |
-| POST | `/api/terminal/ttyd/stop` | Stop ttyd. Body: `{session}` |
+| POST | `/api/terminal/ttyd/start` | Start ttyd for session. Body: `{session}` |
+| POST | `/api/terminal/ttyd/stop` | Stop ttyd for session. Body: `{session}` |
+| POST | `/api/terminal/ttyd/stop-all` | Stop all ttyd processes |
+
+### Files
+
+Files are stored in `~/files/`. Max upload size: 50MB.
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/files` | List files in directory. Query: `?path=subdir` |
+| GET | `/api/files/*` | Download a file |
+| POST | `/api/files/*` | Upload a file (Content-Type: `application/octet-stream`) |
+| DELETE | `/api/files/*` | Delete a file or directory |
 
 ### Commands
 
@@ -86,6 +142,229 @@ Outcome values: `success`, `failure`, `partial`
 
 Available commands: `restart-agent`, `update-agent`, `restart-display`, `status-services`
 
+## HQ API Endpoints (https://<HQ_URL>)
+
+Authentication: `Authorization: Bearer $API_TOKEN` header.
+Base path: All endpoints are prefixed with `/api/minion` by the agent's API client.
+
+### Projects
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/minion/me/projects` | 参加プロジェクト一覧（role 含む） |
+
+Response:
+```json
+[
+  {
+    "id": "uuid",
+    "name": "project-name",
+    "description": "...",
+    "github_owner": "org",
+    "github_repo": "repo",
+    "role": "pm",
+    "created_at": "...",
+    "updated_at": "..."
+  }
+]
+```
+
+`role` is either `"pm"` (project manager) or `"engineer"`.
+
+### Project Context
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/minion/me/project/[id]/context` | プロジェクトコンテキスト取得 |
+| PUT | `/api/minion/me/project/[id]/context` | コンテキスト更新（PM のみ） |
+
+PUT body: `{ "content": "markdown string" }`
+
+### Workflows (project-scoped, versioned)
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/minion/workflows` | 参加プロジェクトのアクティブなワークフロー一覧 |
+| POST | `/api/minion/workflows` | ワークフローを push（新規作成 or 新バージョン） |
+
+GET Response:
+```json
+{
+  "workflows": [
+    {
+      "name": "daily-check",
+      "pipeline_skill_names": ["skill-1", "skill-2"],
+      "pipeline": [
+        {
+          "skill_version_id": "uuid",
+          "skill_name": "skill-1",
+          "skill_display_name": "Skill One",
+          "skill_version": 3,
+          "assigned_role": "engineer",
+          "requires_review": false,
+          "is_my_step": true
+        }
+      ],
+      "content": "...",
+      "version": 3,
+      "cron_expression": "0 9 * * *",
+      "project_id": "uuid",
+      "created_at": "..."
+    }
+  ]
+}
+```
+
+各ステップの `is_my_step` はミニオン自身のプロジェクトロールと `assigned_role` の一致を示す。
+
+POST body (push):
+```json
+{
+  "name": "my-workflow",
+  "pipeline_skill_names": ["skill-1", "skill-2"],
+  "content": "Workflow description",
+  "project_id": "uuid",
+  "change_summary": "Added skill-2 to pipeline"
+}
+```
+
+push するとパイプライン内のスキル名が `skill_version_id` に解決され、新バージョンが自動作成される。
+
+### Pending Steps (軽量ポーリング)
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/minion/pending-steps` | 自分が実行すべき pending ステップ一覧 |
+
+**このエンドポイントはミニオンエージェント（非AI）による高頻度ポーリング用。**
+Claude Code（AIスキル実行）はステップ検知時のみ起動する。
+
+Response:
+```json
+{
+  "steps": [
+    {
+      "step_execution_id": "uuid",
+      "execution_id": "uuid",
+      "workflow_name": "daily-check",
+      "step_index": 0,
+      "skill_version_id": "uuid",
+      "assigned_role": "engineer"
+    }
+  ]
+}
+```
+
+返却条件:
+- `assigned_role` がミニオンのプロジェクトロールと一致
+- ステップの `status` が `pending`
+- 前ステップが全て `completed`（`requires_review` の場合は `approved` も必要）
+
+### Workflow Execution Recording
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| POST | `/api/minion/workflow-execution` | 新規 execution 開始を記録 |
+| POST | `/api/minion/execution` | ステップ実行状況を HQ に報告 |
+
+POST `/api/minion/workflow-execution` body:
+```json
+{
+  "workflow_version_id": "uuid"
+}
+```
+
+Response:
+```json
+{
+  "execution_id": "uuid",
+  "status": "running",
+  "steps_count": 3
+}
+```
+
+POST `/api/minion/execution` body:
+```json
+{
+  "workflow_execution_id": "uuid",
+  "steps": [
+    {
+      "step_index": 0,
+      "skill_version_id": "uuid",
+      "assigned_role": "engineer",
+      "status": "completed",
+      "outcome": "success",
+      "started_at": "...",
+      "completed_at": "..."
+    }
+  ],
+  "status": "running",
+  "started_at": "..."
+}
+```
+
+### Issue Reporting (GitHub Issue 起票)
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| POST | `/api/minion/report` | バグや改善提案を GitHub Issue として起票 |
+
+POST `/api/minion/report` body:
+```json
+{
+  "title": "HQ APIで502エラーが発生する",
+  "body": "## 状況\n...\n\n## 再現手順\n...\n\n## エラー情報\n...\n\n## 環境\n...",
+  "labels": ["bug", "critical"]
+}
+```
+
+Response:
+```json
+{
+  "success": true,
+  "issue_url": "https://github.com/owner/repo/issues/42",
+  "issue_number": 42
+}
+```
+
+使用可能なラベル: `bug`, `enhancement`, `critical`, `minor`
+
+**使い方:** サービスのバグや改善点を発見したら、このエンドポイントで GitHub Issue を起票する。報告者のミニオン名と ID が自動で本文に付記される。
+
+### Routines (minion-scoped)
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/minion/routines` | 自分のルーティン一覧 |
+
+Response:
+```json
+[
+  {
+    "id": "uuid",
+    "name": "routine-name",
+    "pipeline_skill_names": ["skill-1", "execution-report"],
+    "content": "...",
+    "is_active": true,
+    "cron_expression": "0 9 * * 1-5",
+    "last_run": "...",
+    "next_run": "...",
+    "created_at": "...",
+    "updated_at": "..."
+  }
+]
+```
+
+### Skills
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/minion/skills` | HQ に登録されたスキル一覧 |
+| GET | `/api/minion/skills/[name]` | スキル詳細取得（content, files 含む） |
+| POST | `/api/minion/skills` | スキル登録/更新（新バージョン自動作成） |
+
+スキルはバージョン管理される。push ごとに新バージョンが作成され、ファイルは Supabase Storage に保存される。
+
 ## Environment Variables
 
 | Variable | Description |
@@ -125,58 +404,52 @@ When not configured, the agent runs in standalone mode and HQ-dependent features
 
 ## Workflow Structure
 
-Workflows are stored locally in `workflows.json`. Each workflow object:
+Workflows are project-scoped and versioned. Each version is an immutable snapshot of the pipeline.
+Fetched from HQ via `GET /api/minion/workflows`. Also stored locally in `workflows.json`.
 
 ```json
 {
-  "id": "uuid",
   "name": "my-workflow",
   "pipeline_skill_names": ["skill-1", "skill-2", "execution-report"],
+  "pipeline": [
+    {
+      "skill_version_id": "uuid",
+      "skill_name": "skill-1",
+      "skill_display_name": "Skill One",
+      "skill_version": 2,
+      "assigned_role": "engineer",
+      "requires_review": false,
+      "is_my_step": true
+    }
+  ],
   "content": "Markdown description of the workflow",
-  "cron_expression": "0 9 * * 1-5",
-  "is_active": true,
-  "last_run": "2026-02-10T00:00:00.000Z"
+  "version": 2,
+  "cron_expression": "0 9 * * *",
+  "project_id": "uuid"
 }
 ```
 
 | Field | Type | Description |
 |-------|------|-------------|
-| `id` | string | UUID (auto-generated) |
 | `name` | string | Slug identifier (`/^[a-z0-9-]+$/`) |
-| `pipeline_skill_names` | string[] | Ordered skill names to execute |
+| `pipeline_skill_names` | string[] | Ordered skill names (for display/push) |
+| `pipeline` | PipelineStep[] | Resolved pipeline with version IDs and roles |
 | `content` | string | Markdown body describing the workflow |
-| `cron_expression` | string | Cron schedule (empty = manual only) |
-| `is_active` | boolean | Whether cron scheduling is enabled |
-| `last_run` | string\|null | ISO timestamp of last execution |
-
-### Creating a workflow locally
+| `version` | number | Current version number (auto-incremented on push) |
+| `cron_expression` | string\|null | Cron schedule (null = manual/one-shot only) |
+| `project_id` | string | UUID of the parent project |
 
-Use `POST /api/workflows` to create/update workflows:
-
-```bash
-curl -X POST http://localhost:3001/api/workflows \
-  -H "Authorization: Bearer $API_TOKEN" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "workflows": [{
-      "id": "'$(uuidgen)'",
-      "name": "my-workflow",
-      "pipeline_skill_names": ["my-skill", "execution-report"],
-      "content": "Description of what this workflow does",
-      "cron_expression": "",
-      "is_active": false
-    }]
-  }'
-```
-
-Then activate with a schedule:
+### Pipeline Step Fields
 
-```bash
-curl -X PUT http://localhost:3001/api/workflows/<id>/schedule \
-  -H "Authorization: Bearer $API_TOKEN" \
-  -H "Content-Type: application/json" \
-  -d '{"cron_expression": "0 9 * * 1-5", "is_active": true}'
-```
+| Field | Type | Description |
+|-------|------|-------------|
+| `skill_version_id` | string | UUID of the specific skill version |
+| `skill_name` | string | Skill slug name |
+| `skill_display_name` | string | Human-readable skill name |
+| `skill_version` | number | Skill version number |
+| `assigned_role` | string | `"pm"` or `"engineer"` — who executes this step |
+| `requires_review` | boolean | If true, human review required after completion |
+| `is_my_step` | boolean | Whether this minion's role matches assigned_role |
 
 ### Syncing workflows with HQ
 
@@ -186,10 +459,73 @@ curl -X PUT http://localhost:3001/api/workflows/<id>/schedule \
 
 Pipeline skills must be deployed locally (in `~/.claude/skills/`) before pushing a workflow.
 
-## Workflow Execution
+## Routine Structure
+
+Routines are minion-scoped and fetched from HQ via `GET /api/minion/routines`.
+They are also stored locally in `routines.json`. Each routine object:
+
+```json
+{
+  "id": "uuid",
+  "name": "morning-work",
+  "pipeline_skill_names": ["project-workflow-check", "execution-report"],
+  "content": "Markdown description of the routine",
+  "cron_expression": "0 9 * * 1-5",
+  "is_active": true,
+  "last_run": "2026-02-10T09:00:00.000Z",
+  "next_run": "2026-02-11T09:00:00.000Z"
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` | string | UUID (auto-generated) |
+| `name` | string | Slug identifier (`/^[a-z0-9-]+$/`) |
+| `pipeline_skill_names` | string[] | Ordered skill names to execute |
+| `content` | string | Markdown body describing the routine |
+| `cron_expression` | string | Cron schedule (empty = manual only) |
+| `is_active` | boolean | Whether cron scheduling is enabled |
+| `last_run` | string\|null | ISO timestamp of last execution |
+| `next_run` | string\|null | ISO timestamp of next scheduled run |
 
-Workflows run on cron schedules. Each execution:
+## Routine Execution
+
+Routines run on cron schedules. Each execution:
 1. Creates a tmux session
 2. Runs skills in pipeline order via `claude --dangerously-skip-permissions`
 3. Appends `execution-report` skill to report outcome
-4. Environment variables `MINION_EXECUTION_ID`, `MINION_WORKFLOW_ID`, `MINION_WORKFLOW_NAME` are available during execution
+4. Environment variables `MINION_EXECUTION_ID`, `MINION_ROUTINE_ID`, `MINION_ROUTINE_NAME` are available during execution
+
+## Workflow Step Execution via Pending Steps
+
+ミニオンエージェントは `GET /api/minion/pending-steps` を定期ポーリングし、
+自分の担当ステップを検知したら Claude Code を起動してスキルを実行する。
+
+```
+ミニオンエージェント (Port 3001, 常駐, トークン不要)
+  │
+  ├── 軽量ポーリング: N秒ごとに GET /api/minion/pending-steps
+  │   → HTTPのみ、AIなし、コストゼロ
+  │   → pendingステップがなければ何もしない
+  │
+  └── ステップ検知時のみ:
+      1. Claude Code 起動 → 該当スキルを実行
+      2. POST /api/minion/execution → ステップ完了を報告
+      3. Claude Code 終了 → トークン消費はここだけ
+```
+
+### Workflow Execution via Routine (従来方式)
+
+ワークフローは `project-workflow-check` システムスキルを通じてルーティンからも実行可能:
+
+```
+ルーティン: "morning-work" (cron: 0 9 * * 1-5)
+  pipeline: [project-workflow-check, execution-report]
+    ↓
+  project-workflow-check:
+    1. GET /api/minion/me/projects → 参加プロジェクト一覧
+    2. GET /api/minion/workflows → active なワークフロー一覧
+    3. 各ワークフローの pipeline を順に実行
+    ↓
+  execution-report → HQ に結果報告
+```

package/server.js

@@ -7,12 +7,13 @@
 
 const fs = require('fs')
 const path = require('path')
-const os = require('os')
 
 const fastify = require('fastify')({ logger: true })
 const { config, validate, isHqConfigured } = require('./config')
 const workflowRunner = require('./workflow-runner')
 const workflowStore = require('./workflow-store')
+const routineRunner = require('./routine-runner')
+const routineStore = require('./routine-store')
 
 const { registerRoutes, setOffline, getProcessManager, getAllowedCommands } = require('./routes')
 const { cleanupTtyd, killStaleTtydProcesses } = require('./routes/terminal')
@@ -31,8 +32,9 @@ async function shutdown(signal) {
 
   setOffline()
 
-  // Stop workflow runner
+  // Stop workflow and routine runners
   workflowRunner.stopAll()
+  routineRunner.stopAll()
 
   // Stop terminal proxy and all ttyd processes
   stopTerminalProxy()
@@ -53,7 +55,7 @@ process.on('SIGINT', () => shutdown('SIGINT'))
  */
 function syncPermissions() {
   const bundledPath = path.join(__dirname, 'settings', 'permissions.json')
-  const settingsDir = path.join(os.homedir(), '.claude')
+  const settingsDir = path.join(config.HOME_DIR, '.claude')
   const settingsPath = path.join(settingsDir, 'settings.json')
 
   try {
@@ -87,7 +89,7 @@ function syncPermissions() {
  */
 function syncTmuxConfig() {
   const bundledPath = path.join(__dirname, 'settings', 'tmux.conf')
-  const destPath = path.join(os.homedir(), '.tmux.conf')
+  const destPath = path.join(config.HOME_DIR, '.tmux.conf')
 
   try {
     if (!fs.existsSync(bundledPath)) return
@@ -105,7 +107,7 @@ function syncTmuxConfig() {
  */
 function syncBundledRules() {
   const bundledRulesDir = path.join(__dirname, 'rules')
-  const targetRulesDir = path.join(os.homedir(), '.claude', 'rules')
+  const targetRulesDir = path.join(config.HOME_DIR, '.claude', 'rules')
 
   try {
     if (!fs.existsSync(bundledRulesDir)) return
@@ -164,6 +166,17 @@ async function start() {
       console.error('[Server] Failed to load cached workflows:', err.message)
     }
 
+    // Load cached routines and start routine runner
+    try {
+      const cachedRoutines = await routineStore.load()
+      if (cachedRoutines.length > 0) {
+        console.log(`[Server] Loading ${cachedRoutines.length} cached routines`)
+        routineRunner.loadRoutines(cachedRoutines)
+      }
+    } catch (err) {
+      console.error('[Server] Failed to load cached routines:', err.message)
+    }
+
     if (isHqConfigured()) {
       console.log(`[Server] HQ URL: ${config.HQ_URL}`)
     } else {

package/settings/permissions.json

@@ -4,6 +4,8 @@
     "Read",
     "Write",
     "Edit",
+    "WebSearch",
+    "WebFetch",
     "mcp__playwright__*"
   ],
   "deny": [

package/workflow-runner.js

@@ -14,11 +14,11 @@ const { Cron } = require('croner')
 const { exec } = require('child_process')
 const { promisify } = require('util')
 const crypto = require('crypto')
-const os = require('os')
 const path = require('path')
 const fs = require('fs').promises
 const execAsync = promisify(exec)
 
+const { config } = require('./config')
 const executionStore = require('./execution-store')
 const workflowStore = require('./workflow-store')
 const logManager = require('./lib/log-manager')
@@ -90,13 +90,17 @@ async function cleanupMarkerFile(sessionName) {
  * @param {object} workflow - Workflow configuration
  * @returns {Promise<{success: boolean, error?: string, sessionName?: string}>}
  */
-async function executeWorkflowSession(workflow, executionId, skillNames) {
-  const homeDir = os.homedir()
+async function executeWorkflowSession(workflow, executionId, skillNames, options = {}) {
+  const homeDir = config.HOME_DIR
   const sessionName = generateSessionName(workflow.id, executionId)
 
-  // Build prompt: run each skill in sequence, then execution-report
+  // Build prompt: run each skill in sequence
+  // When skipExecutionReport is true (dispatched step), the minion server's
+  // post-execution hook handles completion reporting instead of /execution-report.
   const skillCommands = skillNames.map(name => `/${name}`).join(', then ')
-  const prompt = `Run the following skills in order: ${skillCommands}. After completing all skills, run /execution-report to report the results.`
+  const prompt = options.skipExecutionReport
+    ? `Run the following skills in order: ${skillCommands}.`
+    : `Run the following skills in order: ${skillCommands}. After completing all skills, run /execution-report to report the results.`
 
   // Extend PATH to include common CLI installation locations
   const additionalPaths = [
@@ -187,11 +191,10 @@ async function executeWorkflowSession(workflow, executionId, skillNames) {
 
     while (Date.now() - startTime < timeout) {
       try {
-        await execAsync(`tmux has-session -t "${sessionName}" 2>/dev/null`)
-        await sleep(pollInterval)
+        await fs.access(exitCodeFile)
+        break // Exit code file exists — claude -p has finished
       } catch {
-        // Session ended
-        break
+        await sleep(pollInterval)
       }
     }
 
@@ -245,7 +248,7 @@ async function saveExecution(executionData) {
  * @param {object} workflow - Workflow configuration
  * @returns {Promise<{execution_id: string, session_name: string}>}
  */
-async function runWorkflow(workflow) {
+async function runWorkflow(workflow, options = {}) {
   const pipelineSkillNames = workflow.pipeline_skill_names || []
 
   if (pipelineSkillNames.length === 0) {
@@ -285,7 +288,7 @@ async function runWorkflow(workflow) {
   })
 
   // Execute all skills in one session
-  const result = await executeWorkflowSession(workflow, executionId, pipelineSkillNames)
+  const result = await executeWorkflowSession(workflow, executionId, pipelineSkillNames, options)
 
   const completedAt = new Date().toISOString()
   console.log(`[WorkflowRunner] executeWorkflowSession returned: success=${result.success}, error=${result.error || 'none'}`)