@geekbeer/minion 2.16.5 → 2.23.0

package/.env.example

@@ -15,8 +15,8 @@ API_TOKEN=
 # Minion ID (optional) - The minion's UUID assigned by HQ
 MINION_ID=
 
-# Agent port (optional, default: 3001)
-AGENT_PORT=3001
+# Agent port (optional, default: 8080)
+AGENT_PORT=8080
 
 # Heartbeat interval in seconds (optional, default: 30)
 HEARTBEAT_INTERVAL=30

package/README.md

@@ -57,7 +57,7 @@ await reportIssue({
 | `HQ_URL` | Minion HQ server URL | - |
 | `API_TOKEN` | Authentication token | - |
 | `MINION_ID` | Minion UUID | - |
-| `AGENT_PORT` | Agent API listen port | `3001` |
+| `AGENT_PORT` | Agent API listen port | `8080` |
 | `HEARTBEAT_INTERVAL` | Heartbeat interval (ms) | `30000` |
 
 ## License

package/api.js

@@ -53,7 +53,7 @@ async function reportExecution(data) {
 /**
  * Report a single workflow step completion to HQ.
  * Called by the post-execution hook after a dispatched skill finishes.
- * @param {object} data - { workflow_execution_id, step_index, status }
+ * @param {object} data - { workflow_execution_id, step_index, status, output_summary? }
  */
 async function reportStepComplete(data) {
   return request('/step-complete', {

package/config.js

@@ -10,7 +10,7 @@
  * (no HQ communication).
  *
  * Other optional environment variables:
- * - AGENT_PORT: Port for the local agent server (default: 3001)
+ * - AGENT_PORT: Port for the local agent server (default: 8080)
  * - MINION_USER: System user running the agent (used to resolve home directory)
  */
 
@@ -44,10 +44,17 @@ const config = {
   MINION_ID: process.env.MINION_ID || '',
 
   // Server settings
-  AGENT_PORT: parseInt(process.env.AGENT_PORT, 10) || 3001,
+  AGENT_PORT: parseInt(process.env.AGENT_PORT, 10) || 8080,
 
   // Resolved home directory (safe for supervisord environments)
   HOME_DIR: resolveHomeDir(),
+
+  // LLM command template (user-configured)
+  // Use {prompt} as placeholder for the prompt text.
+  // Examples:
+  //   LLM_COMMAND="claude -p '{prompt}'"
+  //   LLM_COMMAND="gemini-cli --prompt '{prompt}'"
+  LLM_COMMAND: process.env.LLM_COMMAND || '',
 }
 
 /**
@@ -68,4 +75,11 @@ function validate() {
   }
 }
 
-module.exports = { config, validate, isHqConfigured }
+/**
+ * Check if LLM command is configured
+ */
+function isLlmConfigured() {
+  return !!config.LLM_COMMAND
+}
+
+module.exports = { config, validate, isHqConfigured, isLlmConfigured }

package/docs/api-reference.md

@@ -5,7 +5,7 @@ HQのソースコードを読む必要はありません — 必要な情報は
 
 ---
 
-## Agent API Endpoints (http://localhost:3001)
+## Agent API Endpoints (http://localhost:8080)
 
 Authentication: `Authorization: Bearer $API_TOKEN` header (except where noted).
 

package/docs/task-guides.md

@@ -87,11 +87,11 @@ curl -s -X POST "$HQ_URL/api/minion/workflows" \
 
 ```bash
 # HQからワークフローを取得 (不足スキルも自動fetch)
-curl -s -X POST "http://localhost:3001/api/workflows/fetch/<name>" \
+curl -s -X POST "http://localhost:8080/api/workflows/fetch/<name>" \
   -H "Authorization: Bearer $API_TOKEN"
 
 # ローカルワークフローをHQにpush (スキルも自動push)
-curl -s -X POST "http://localhost:3001/api/workflows/push/<name>" \
+curl -s -X POST "http://localhost:8080/api/workflows/push/<name>" \
   -H "Authorization: Bearer $API_TOKEN"
 ```
 
@@ -128,18 +128,18 @@ curl -s -X PUT "$HQ_URL/api/minion/me/project/<project-id>/context" \
 
 ```bash
 # 最近の実行一覧
-curl -s "http://localhost:3001/api/executions?limit=10" \
+curl -s "http://localhost:8080/api/executions?limit=10" \
   -H "Authorization: Bearer $API_TOKEN"
 
 # 特定の実行ログ
-curl -s "http://localhost:3001/api/executions/<id>/log" \
+curl -s "http://localhost:8080/api/executions/<id>/log" \
   -H "Authorization: Bearer $API_TOKEN"
 ```
 
 ### 実行結果の報告
 
 ```bash
-curl -s -X POST "http://localhost:3001/api/executions/<id>/outcome" \
+curl -s -X POST "http://localhost:8080/api/executions/<id>/outcome" \
   -H "Content-Type: application/json" \
   -d '{
     "outcome": "success",
@@ -199,11 +199,11 @@ minion-cli skill fetch <name>
 
 ```bash
 # ローカルワークフロー一覧 (next_run を確認)
-curl -s "http://localhost:3001/api/workflows" \
+curl -s "http://localhost:8080/api/workflows" \
   -H "Authorization: Bearer $API_TOKEN"
 
 # 手動トリガー
-curl -s -X POST "http://localhost:3001/api/workflows/trigger" \
+curl -s -X POST "http://localhost:8080/api/workflows/trigger" \
   -H "Authorization: Bearer $API_TOKEN" \
   -H "Content-Type: application/json" \
   -d '{ "workflow_id": "<workflow-uuid>" }'

package/lib/llm-checker.js

@@ -2,12 +2,13 @@
  * LLM Service authentication checker
  *
  * Detects whether supported LLM CLIs are authenticated and ready to use.
- * CLIs are pre-installed on all minions; this module only checks auth status.
+ * Also checks whether LLM_COMMAND is configured for workflow/routine execution.
  * Results are cached in memory for 60 seconds to avoid excessive filesystem checks.
  */
 
 const fs = require('fs')
 const path = require('path')
+const { execSync } = require('child_process')
 const { config } = require('../config')
 
 const CACHE_TTL_MS = 60000
@@ -15,11 +16,28 @@ const CACHE_TTL_MS = 60000
 let cachedResult = null
 let cachedAt = 0
 
+/**
+ * Build extended PATH that includes common Claude CLI installation locations
+ */
+function getExtendedPath() {
+  const additionalPaths = [
+    path.join(config.HOME_DIR, '.local', 'bin'),
+    path.join(config.HOME_DIR, 'bin'),
+    path.join(config.HOME_DIR, '.npm-global', 'bin'),
+    path.join(config.HOME_DIR, '.claude', 'bin'),
+    '/usr/local/bin',
+  ]
+  return [...additionalPaths, process.env.PATH || '/usr/bin:/bin'].join(':')
+}
+
 /**
  * Check Claude Code authentication.
- * Claude stores OAuth credentials in ~/.claude/.credentials.json
+ * First checks known credential file locations (fast path),
+ * then falls back to `claude auth whoami` CLI command for newer CLI versions
+ * that may store credentials differently.
  */
 function isClaudeAuthenticated() {
+  // Fast path: check known credential file locations
   const candidates = [
     path.join(config.HOME_DIR, '.claude', '.credentials.json'),
     path.join(config.HOME_DIR, '.claude', 'credentials.json'),
@@ -35,7 +53,24 @@ function isClaudeAuthenticated() {
       // Invalid JSON or read error — not authenticated
     }
   }
-  return false
+
+  // Fallback: check via claude CLI command (handles newer credential storage)
+  try {
+    const claudePath = path.join(config.HOME_DIR, '.local', 'bin', 'claude')
+    const claudeBin = fs.existsSync(claudePath) ? claudePath : 'claude'
+    execSync(`${claudeBin} auth whoami`, {
+      encoding: 'utf-8',
+      timeout: 5000,
+      stdio: 'pipe',
+      env: {
+        HOME: config.HOME_DIR,
+        PATH: getExtendedPath(),
+      },
+    })
+    return true
+  } catch {
+    return false
+  }
 }
 
 /**
@@ -89,10 +124,18 @@ const SERVICE_DEFINITIONS = [
   { name: 'codex', display_name: 'Codex', check: isCodexAuthenticated },
 ]
 
+/**
+ * Check if LLM_COMMAND is configured for workflow/routine execution.
+ */
+function isLlmCommandConfigured() {
+  return !!config.LLM_COMMAND
+}
+
 /**
  * Get authenticated LLM services (cached for 60s).
- * Returns all services with their authentication status.
- * @returns {{ name: string, display_name: string, authenticated: boolean }[]}
+ * Returns all services with their authentication status,
+ * plus whether LLM_COMMAND is configured.
+ * @returns {{ services: { name: string, display_name: string, authenticated: boolean }[], llm_command_configured: boolean }}
  */
 function getLlmServices() {
   const now = Date.now()
@@ -117,4 +160,4 @@ function clearLlmCache() {
   cachedAt = 0
 }
 
-module.exports = { getLlmServices, clearLlmCache }
+module.exports = { getLlmServices, clearLlmCache, isLlmCommandConfigured }

package/minion-cli.sh

@@ -86,7 +86,7 @@ svc_control() {
   esac
 }
 
-AGENT_URL="${MINION_AGENT_URL:-http://localhost:3001}"
+AGENT_URL="${MINION_AGENT_URL:-http://localhost:8080}"
 
 # Auto-load .env so that API_TOKEN etc. are available in interactive shells
 ENV_FILE="/opt/minion-agent/.env"
@@ -279,11 +279,12 @@ do_setup() {
     ENV_CONTENT+="MINION_ID=${MINION_ID}\n"
   fi
 
-  ENV_CONTENT+="AGENT_PORT=3001\n"
+  ENV_CONTENT+="AGENT_PORT=8080\n"
   ENV_CONTENT+="HEARTBEAT_INTERVAL=30\n"
   ENV_CONTENT+="MINION_USER=${TARGET_USER}\n"
 
   echo -e "$ENV_CONTENT" | $SUDO tee /opt/minion-agent/.env > /dev/null
+  $SUDO chown "${TARGET_USER}:${TARGET_USER}" /opt/minion-agent/.env
   echo "  -> /opt/minion-agent/.env generated"
 
   # Step 5: Configure sudoers for agent user
@@ -581,7 +582,7 @@ SUPEOF
   local SUCCESS=false
 
   for i in $(seq 1 $RETRIES); do
-    if curl -sf http://localhost:3001/api/health > /dev/null 2>&1; then
+    if curl -sf http://localhost:8080/api/health > /dev/null 2>&1; then
       SUCCESS=true
       break
     fi
@@ -649,10 +650,12 @@ SUPEOF
       exit 1
     fi
 
-    # Install cloudflared if not present
+    # Install cloudflared if not present (architecture-aware)
     if ! command -v cloudflared &>/dev/null; then
       echo "  Installing cloudflared..."
-      curl -fsSL https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb \
+      local CF_ARCH
+      CF_ARCH=$(dpkg --print-architecture 2>/dev/null || echo "amd64")
+      curl -fsSL "https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-${CF_ARCH}.deb" \
         -o /tmp/cloudflared.deb
       $SUDO dpkg -i /tmp/cloudflared.deb
       rm -f /tmp/cloudflared.deb
@@ -688,10 +691,36 @@ SUPEOF
       echo "$CONFIG_YML" | $SUDO tee /etc/cloudflared/config.yml > /dev/null
       echo "  -> /etc/cloudflared/config.yml saved"
 
-      # Install and start cloudflared service
-      $SUDO cloudflared service install 2>/dev/null || true
-      $SUDO systemctl enable cloudflared 2>/dev/null || true
-      $SUDO systemctl start cloudflared 2>/dev/null || true
+      # Install and start cloudflared service (process-manager aware)
+      case "$PROC_MGR" in
+        systemd)
+          $SUDO cloudflared service install 2>/dev/null || true
+          $SUDO systemctl enable cloudflared 2>/dev/null || true
+          $SUDO systemctl start cloudflared 2>/dev/null || true
+          ;;
+        supervisord)
+          # Create supervisord config for cloudflared
+          $SUDO tee /etc/supervisor/conf.d/cloudflared.conf > /dev/null <<CFEOF
+[program:cloudflared]
+command=/usr/bin/cloudflared tunnel --config /etc/cloudflared/config.yml run
+autorestart=true
+priority=150
+startsecs=5
+stdout_logfile=/var/log/supervisor/cloudflared.log
+stderr_logfile=/var/log/supervisor/cloudflared.log
+CFEOF
+          # Reload supervisord if running
+          if $SUDO supervisorctl status &>/dev/null; then
+            $SUDO supervisorctl reread
+            $SUDO supervisorctl update
+          fi
+          ;;
+        *)
+          echo "  WARNING: No supported process manager for cloudflared"
+          echo "  You may need to start cloudflared manually:"
+          echo "  cloudflared tunnel --config /etc/cloudflared/config.yml run"
+          ;;
+      esac
       echo "  -> cloudflared tunnel configured and started"
     fi
   fi
@@ -701,10 +730,12 @@ SUPEOF
     echo ""
     echo "Notifying HQ of setup completion..."
     local NOTIFY_RESPONSE
+    local HOSTNAME_VAL
+    HOSTNAME_VAL=$(hostname 2>/dev/null || echo "")
     NOTIFY_RESPONSE=$(curl -sfL -X POST "${HQ_URL}/api/minion/setup-complete" \
       -H "Content-Type: application/json" \
       -H "Authorization: Bearer ${API_TOKEN}" \
-      -d "{}" 2>&1) || true
+      -d "{\"internal_ip_address\":\"${HOSTNAME_VAL}\"}" 2>&1) || true
 
     if echo "$NOTIFY_RESPONSE" | grep -q '"success":true' 2>/dev/null; then
       echo "  -> HQ notified successfully"
@@ -854,6 +885,6 @@ case "${1:-}" in
     echo "Status values: online, offline, busy"
     echo ""
     echo "Environment:"
-    echo "  MINION_AGENT_URL  Agent URL (default: http://localhost:3001)"
+    echo "  MINION_AGENT_URL  Agent URL (default: http://localhost:8080)"
     ;;
 esac

package/package.json

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

package/roles/pm.md

@@ -25,7 +25,7 @@
 ポイント:
 - HQの責務は「executionレコードを作る（指示書発行）」だけ
 - 各ミニオンは自分の担当ステップだけをポーリングして実行
-- ミニオンエージェント（Port 3001）が軽量HTTPポーリングを行い、pending検知時のみClaude Codeを起動
+- ミニオンエージェント（Port 8080）が軽量HTTPポーリングを行い、pending検知時のみClaude Codeを起動
 
 ## Workflow 管理