@geekbeer/minion 3.49.1 → 3.51.1

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/core/lib/note-mentions.js

@@ -0,0 +1,54 @@
+/**
+ * Helpers for the note user-mention syntax: `@[Display Name](user:UUID)`.
+ *
+ * HQ stores notes as Markdown. When humans write `@[Yuno](user:abc-...)` in
+ * the note editor (via Ctrl+I), the minion needs to read it as a normal
+ * `@Yuno`-style attribution rather than the raw bracket form. These helpers
+ * normalize and parse that syntax so skills/runners do not have to reinvent it.
+ *
+ * The UUID is the stable identity; the display name is a snapshot at insertion
+ * time and is the human-friendly handle.
+ */
+
+// Allow short test ids too (>= 8 chars) so the helper is usable in fixtures
+// even when the canonical 36-char UUID is not present.
+const USER_MENTION_REGEX = /@\[([^\]\n]+?)\]\(user:([0-9a-fA-F-]{8,})\)/g
+
+/**
+ * Replace `@[Display Name](user:UUID)` with `@Display Name`.
+ * Pass minion-bound markdown through this before injecting into a prompt or
+ * task payload so Claude does not see the raw bracket syntax.
+ *
+ * @param {string} markdown
+ * @returns {string}
+ */
+function normalizeNoteMentions(markdown) {
+  if (typeof markdown !== 'string' || markdown.length === 0) return markdown
+  return markdown.replace(USER_MENTION_REGEX, (_match, name) => `@${name}`)
+}
+
+/**
+ * Extract every user mention as { userId, displayName } in document order.
+ * Useful when a workflow step needs to know "who wrote this note" without
+ * round-tripping through HQ.
+ *
+ * @param {string} markdown
+ * @returns {Array<{ userId: string, displayName: string }>}
+ */
+function extractNoteMentions(markdown) {
+  if (typeof markdown !== 'string' || markdown.length === 0) return []
+  const out = []
+  // RegExp.exec with /g maintains lastIndex on the regex itself, so use a fresh copy.
+  const re = new RegExp(USER_MENTION_REGEX.source, 'g')
+  let match
+  while ((match = re.exec(markdown)) !== null) {
+    out.push({ displayName: match[1], userId: match[2] })
+  }
+  return out
+}
+
+module.exports = {
+  USER_MENTION_REGEX,
+  normalizeNoteMentions,
+  extractNoteMentions,
+}

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
 }
 ```
 
@@ -1634,7 +1633,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 +1691,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 +1775,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 のみ)
 

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.49.1",
+  "version": "3.51.1",
   "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
 
@@ -390,6 +392,30 @@ hq note get <project_id> <note_id>
 hq note search <project_id> "キーワード"
 ```
 
+### ノート内のユーザーメンション
+
+人間ユーザーがノート編集UIで `Ctrl+I` を押すと、自分の発言を示すアバター付きチップが行頭に挿入される。マークダウン上は次の形式で永続化される:
+
+```
+@[Display Name](user:UUID)
+```
+
+ミニオンがノートを読む場合、この記法はそのままだと冗長なので、`@/Display Name` 表記に正規化してから処理する。`packages/minion/core/lib/note-mentions.js` のヘルパを使う:
+
+```js
+const { normalizeNoteMentions, extractNoteMentions } = require('./core/lib/note-mentions')
+
+// 例: ノート本文を読み取って正規化
+const normalized = normalizeNoteMentions(noteMarkdown)
+// "@Yuno が書きました。"
+
+// 例: 誰の発言かを抽出
+const mentions = extractNoteMentions(noteMarkdown)
+// [{ displayName: 'Yuno', userId: 'abc-...' }, ...]
+```
+
+UUIDは安定IDなので、表示名が変わっても発言者の同一性を判定できる。書き戻す側のミニオンは原則この記法を生成しないこと(人間専用の発言マーカー)。
+
 ### `~/files/` への保存
 
 バイナリファイルやユーザーがダウンロードする必要があるファイルは `~/files/` に配置する。

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()