@geekbeer/minion 3.50.0 → 3.51.2

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

@@ -0,0 +1,101 @@
+/**
+ * DAG Cron Poller
+ *
+ * Polling daemon that asks HQ to fire any due cron-scheduled DAG workflows
+ * for projects where this minion is the PM. The actual claim, trigger, and
+ * next_run_at advancement are all done in HQ — the poller is just a clock
+ * source. Multiple PMs in the same project are race-safe via a conditional
+ * UPDATE on dag_workflows.next_run_at inside the HQ handler.
+ *
+ * The minimum cron interval (5 min) makes a 60s polling cadence more than
+ * precise enough; cron precision is bounded by max(poll_interval, 60s).
+ */
+
+const { config, isHqConfigured } = require('../config')
+
+const POLL_INTERVAL_MS = 60_000
+
+let polling = false
+let pollTimer = null
+let lastPollAt = null
+let lastFiredCount = 0
+
+async function pollOnce() {
+  if (!isHqConfigured()) return
+  if (polling) return
+
+  polling = true
+  try {
+    const url = `${config.HQ_URL}/api/dag/minion/dag-cron-tick`
+    const resp = await fetch(url, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${config.API_TOKEN}`,
+      },
+    })
+
+    if (!resp.ok) {
+      throw new Error(`dag-cron-tick failed: ${resp.status}`)
+    }
+
+    const data = await resp.json()
+    const fired = Array.isArray(data.fired) ? data.fired : []
+    const skipped = Array.isArray(data.skipped) ? data.skipped : []
+    const errors = Array.isArray(data.errors) ? data.errors : []
+
+    lastFiredCount = fired.length
+
+    if (fired.length > 0 || errors.length > 0) {
+      console.log(
+        `[DagCronPoller] Fired ${fired.length}, skipped ${skipped.length}, errors ${errors.length}`
+      )
+      for (const f of fired) {
+        console.log(`[DagCronPoller]   fired: ${f.name} (workflow ${f.workflow_id} → execution ${f.execution_id})`)
+      }
+      for (const e of errors) {
+        console.error(`[DagCronPoller]   error on ${e.workflow_id}: ${e.error}`)
+      }
+    }
+  } catch (err) {
+    if (err.message?.includes('fetch failed') || err.message?.includes('ECONNREFUSED')) {
+      console.log('[DagCronPoller] HQ unreachable, will retry next cycle')
+    } else {
+      console.error(`[DagCronPoller] Poll error: ${err.message}`)
+    }
+  } finally {
+    polling = false
+    lastPollAt = new Date().toISOString()
+  }
+}
+
+function start() {
+  if (!isHqConfigured()) {
+    console.log('[DagCronPoller] HQ not configured, cron poller disabled')
+    return
+  }
+
+  // Stagger initial poll so the three pollers (step / dag-step / cron) do
+  // not all hit HQ in the same second on minion startup.
+  setTimeout(() => pollOnce(), 12_000)
+  pollTimer = setInterval(() => pollOnce(), POLL_INTERVAL_MS)
+  console.log(`[DagCronPoller] Started (polling every ${POLL_INTERVAL_MS / 1000}s)`)
+}
+
+function stop() {
+  if (pollTimer) {
+    clearInterval(pollTimer)
+    pollTimer = null
+    console.log('[DagCronPoller] Stopped')
+  }
+}
+
+function getStatus() {
+  return {
+    running: pollTimer !== null,
+    last_poll_at: lastPollAt,
+    last_fired_count: lastFiredCount,
+  }
+}
+
+module.exports = { start, stop, pollOnce, getStatus }

package/docs/api-reference.md

@@ -1275,8 +1275,7 @@ PUT `/api/minion/dag-workflows/:id` body（全フィールド optional、省略
   "content": "...",
   "change_summary": "Updated fan-out branch",
   "name": "renamed-dag",
-  "is_active": true,
-  "maturity": "preview|stable|..."
+  "is_active": true
 }
 ```
 
@@ -1338,7 +1337,7 @@ POST `/api/minion/dag-workflows/:id/publish` (body なし):
 |------|---------------|------|
 | `start` / `end` | なし | |
 | `skill` | `skill_id`, `skill_version_id`, `assigned_role` | |
-| `review` | `review: { reviewer_type, criteria, revision_target }` | `revision` エッジと `approved` エッジが**自動生成**される |
+| `review` | `assigned_role`, `review: { criteria, revision_target }` | `assigned_role: 'human'` でダッシュボードからの人間レビュー、`'pm'`/`'engineer'`/`'accountant'` で将来の minion レビュー枠（現在は未実装、`waiting` で停止）。`revision` / `approved` エッジは自動生成 |
 | `fan_out` | `fan_out_source`, `template` | `template` は sub-graph `{ nodes, edges }` |
 | `join` | `join_mode`, `aggregation` | |
 | `conditional` | `condition_type`, `branches` or `default_branch` | |
@@ -1351,13 +1350,24 @@ POST `/api/minion/dag-workflows/:id/publish` (body なし):
   "label": "Quality Check",
   "after": "skill_1",
   "before": "end",
+  "assigned_role": "human",
   "review": {
-    "reviewer_type": "human",
     "criteria": "成果物の品質を確認",
-    "revision_target": "skill_1"
+    "revision_target": "skill_1",
+    "preferred_reviewer_id": "<user UUID（任意・指定なしの場合は全プロジェクトメンバーに通知）>"
   }
 }
 ```
+
+`assigned_role` の値:
+- `human` — ダッシュボードから人間が承認 (`workflow.review_requested` 通知が送信される)
+- `pm` / `engineer` / `accountant` — 将来の minion レビュー枠 (現在は未実装、`waiting` で停止)
+
+`preferred_reviewer_id` (任意):
+- `assigned_role === 'human'` の場合: `profiles.user_id` を指定すると通知をその人に絞る。脱退済みなら全メンバーにフォールバック
+- `assigned_role !== 'human'` の場合: `minions.id` を指定（現在は未実装）
+
+> 互換性: 旧形式 `review: { reviewer_type, reviewer_id }` も読み取り可能ですが、新規作成時は `assigned_role` + `preferred_reviewer_id` を使ってください。
 → `skill_1 → end` のエッジが削除され、以下が自動生成:
 - `skill_1 → review_1` (normal)
 - `review_1 → end` (approved)
@@ -1634,7 +1644,6 @@ GET `/api/minion/dag-workflows/:id` Response:
   "project_id": "uuid",
   "name": "my-dag",
   "is_active": true,
-  "maturity": "draft|stable|...",
   "current_version_id": "uuid",
   "draft_graph": { "nodes": [...], "edges": [...] } ,
   "draft_content": "markdown|null",
@@ -1693,9 +1702,12 @@ GET `/api/minion/dag-executions/:id` Response:
 | GET | `/api/dag/minion/pending-nodes` | 自分が実行すべき pending ノード一覧（ロール一致・依存解決済み） |
 | POST | `/api/dag/minion/claim-node` | ノードを楽観ロックで取得（排他実行） |
 | POST | `/api/dag/minion/node-complete` | ノード完了を報告し、下流ノードへカスケード |
+| POST | `/api/dag/minion/dag-cron-tick` | PMロールのミニオン専用。所属プロジェクトのcron-enabled DAGワークフローを発火 |
 
 ミニオンの `dag-step-poller` デーモンが30秒ごとに `pending-nodes` を叩き、最大2並列で claim → skill/transform 実行 → node-complete の流れを回す。`skill`・`transform` 以外のノード（start/end/review/fan_out/join/conditional）はHQ内部のカスケードエンジンが処理するため、ミニオンには返されない。
 
+`dag-cron-poller` デーモン（v3.51.0〜）は60秒ごとに `dag-cron-tick` を叩く。HQ側で「呼び出しミニオンがPMロールであるプロジェクトのDAGワークフロー」のうち `cron_enabled AND next_run_at <= now()` を atomic claim → triggerDagExecution。Push型ではないので、PMミニオンが offline ならcron発火が遅延する。
+
 #### GET /api/dag/minion/pending-nodes
 
 Response:
@@ -1774,6 +1786,32 @@ Response:
 { "success": true, "review_pending": true }
 ```
 
+#### POST /api/dag/minion/dag-cron-tick
+
+PMロールのミニオン専用。所属プロジェクトのcron-enabled DAGワークフローを発火させる。`dag-cron-poller` が60秒間隔で叩くため、AI側から直接呼ぶ必要はない。
+
+Body: なし
+
+Response:
+```json
+{
+  "fired": [
+    { "workflow_id": "uuid", "execution_id": "uuid", "name": "Daily Report" }
+  ],
+  "skipped": [
+    { "workflow_id": "uuid", "reason": "claimed_by_other|already_running" }
+  ],
+  "errors": [
+    { "workflow_id": "uuid", "error": "..." }
+  ]
+}
+```
+
+- 呼び出しミニオンがPMロールでないプロジェクトのワークフローは対象外（HQ側で `project_members.role='pm'` でフィルタ）
+- 同一プロジェクトに複数のPMミニオンが居る場合、条件付き UPDATE で先勝ちclaim。負けた側は `skipped: claimed_by_other` で返る
+- `cron_skip_if_running=true` のワークフローで前回実行が `pending`/`running` のままなら `skipped: already_running` で返る
+- 発火後の経路は手動トリガーと同じ。`dag_executions` 行作成 → start auto-complete → cascade → 各ミニオンの `dag-step-poller` が pending node を pull
+
 ### DAG Graph Structure
 
 DAG ワークフローの graph は以下の構造で保存される（`dag_workflow_versions.graph` / `dag_executions.graph_snapshot`）:

package/docs/task-guides.md

@@ -154,6 +154,8 @@ DAG ワークフローは有向非巡回グラフでスキル間の依存関係
 
 **HQダッシュボードの DAG エディタ（プロジェクト画面 → 「DAG (beta)」タブ）で GUI 編集**できるほか、**ミニオンからは JSON ベースで編集可能**（PMロールのみ）。ミニオンは実行ランタイムも担当し、`dag-step-poller` デーモンが pending ノードを自動で処理します。
 
+**cronスケジュール (v3.51.0〜):** DAGワークフローは cron 式による定期実行をサポート。設定はHQダッシュボードのDAGビューにある SchedulePanel から行う（最小実行間隔 5分）。発火主体はそのプロジェクトのPMロールのミニオンで、`dag-cron-poller` デーモンが60秒間隔で `/api/dag/minion/dag-cron-tick` を叩いて発火させる。PM不在のプロジェクトでは cron は発火しない。
+
 ### DAG ワークフロー一覧の取得
 
 ```bash
@@ -164,7 +166,7 @@ hq list dag-workflows
 hq list dag-workflows <project-uuid>
 ```
 
-レスポンスには各ワークフローの `id`, `name`, `is_active`, `maturity`, `my_role` 等が含まれる。個別の graph 詳細は `hq fetch dag-workflow <id>` で取得する。
+レスポンスには各ワークフローの `id`, `name`, `is_active`, `my_role` 等が含まれる。個別の graph 詳細は `hq fetch dag-workflow <id>` で取得する。
 
 ### ミニオンによる DAG ワークフロー編集 (PM のみ)
 
@@ -307,8 +309,8 @@ cat > /tmp/n.json <<'EOF'
   "label": "Quality Check",
   "after": "skill_1",
   "before": "end_1",
+  "assigned_role": "human",
   "review": {
-    "reviewer_type": "human",
     "criteria": "成果物の品質を確認",
     "revision_target": "skill_1"
   }

package/linux/bin/hq

@@ -275,7 +275,7 @@ case "${1:-}" in
         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
+          echo "  body.json may contain { graph, content, change_summary, name, is_active }" >&2
           exit 1
         fi
         validate_json_file "$body_file"

package/linux/server.js

@@ -60,6 +60,7 @@ const { getConfigWarnings } = require('../core/lib/config-warnings')
 // Pull-model daemons (from core/)
 const stepPoller = require('../core/lib/step-poller')
 const dagStepPoller = require('../core/lib/dag-step-poller')
+const dagCronPoller = require('../core/lib/dag-cron-poller')
 const boardTaskPoller = require('../core/lib/board-task-poller')
 const revisionWatcher = require('../core/lib/revision-watcher')
 const reflectionScheduler = require('../core/lib/reflection-scheduler')
@@ -407,6 +408,7 @@ async function start() {
       // Start Pull-model daemons
       stepPoller.start()
       dagStepPoller.start()
+      dagCronPoller.start()
       boardTaskPoller.setRunner(boardTaskRunner)
       boardTaskPoller.start()
       revisionWatcher.start()

package/package.json

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

package/rules/core.md

@@ -176,7 +176,9 @@ Note: Codex CLI の `.codex/` ディレクトリはLLMからの直接編集が
 
 主なカテゴリ: Projects, Context, Workflows, DAG Workflows, Skills, Executions, Routines, Reports
 
-DAG ワークフローのランタイム API は `$HQ_URL/api/dag/minion/*`（pending-nodes / claim-node / node-complete）。`dag-step-poller` デーモンが自動でポーリングするため、通常ミニオンのAI側から直接叩くことは無い。
+DAG ワークフローのランタイム API は `$HQ_URL/api/dag/minion/*`（pending-nodes / claim-node / node-complete / dag-cron-tick）。`dag-step-poller` と `dag-cron-poller` デーモンが自動でポーリングするため、通常ミニオンのAI側から直接叩くことは無い。
+
+**DAG Cron Trigger (v3.51.0〜):** `dag_workflows.cron_enabled = true` が設定されたDAGワークフローは、所属プロジェクトのPMミニオンの `dag-cron-poller` が60秒間隔で `POST /api/dag/minion/dag-cron-tick` を叩いて発火する。発火主体はPMロールのミニオンに限定（HQ側で `project_members.role='pm'` でフィルタ）。最小実行間隔は5分（HQ側 `validateCronExpression` で enforce）。発火後の経路は手動トリガーと同じで、`dag_executions` 行が作成され、通常通り各ミニオンの `dag-step-poller` がpendingノードをclaimする。
 
 ## Environment Variables
 

package/win/bin/hq.ps1

@@ -237,7 +237,7 @@ switch ($Command) {
                 $BodyFile = $Arg3
                 if (-not $Id -or -not $BodyFile) {
                     Write-Error "Usage: hq put dag-workflow <id> <body.json>"
-                    Write-Error "  body.json may contain { graph, content, change_summary, name, is_active, maturity }"
+                    Write-Error "  body.json may contain { graph, content, change_summary, name, is_active }"
                     exit 1
                 }
                 Assert-ValidJsonFile -Path $BodyFile

package/win/server.js

@@ -36,6 +36,7 @@ const { getConfigWarnings } = require('../core/lib/config-warnings')
 // Pull-model daemons (from core/)
 const stepPoller = require('../core/lib/step-poller')
 const dagStepPoller = require('../core/lib/dag-step-poller')
+const dagCronPoller = require('../core/lib/dag-cron-poller')
 const boardTaskPoller = require('../core/lib/board-task-poller')
 const revisionWatcher = require('../core/lib/revision-watcher')
 const reflectionScheduler = require('../core/lib/reflection-scheduler')
@@ -374,6 +375,7 @@ async function start() {
       // Start Pull-model daemons
       stepPoller.start()
       dagStepPoller.start()
+      dagCronPoller.start()
       boardTaskPoller.setRunner(boardTaskRunner)
       boardTaskPoller.start()
       revisionWatcher.start()