@yemi33/minions 0.1.565 → 0.1.567

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.567 (2026-04-08)
+
+### Features
+-  add ccModel/ccEffort settings and agent runtime tracking
+
+### Other
+- refactor: use safeJson/safeWrite for spawn-agent cache, remove unused checkedAt
+
 ## 0.1.565 (2026-04-08)
 
 ### Fixes

package/dashboard/js/render-other.js

@@ -59,11 +59,20 @@ function renderMetrics(metrics) {
       merged.prsApproved += tm.prsApproved || 0;
       merged.prsRejected += tm.prsRejected || 0;
       merged.reviewsDone += tm.reviewsDone || 0;
+      merged.totalRuntimeMs = (merged.totalRuntimeMs || 0) + (tm.totalRuntimeMs || 0);
     }
     rows.push(['Temp Agents (' + temps.length + ')', merged]);
   }
 
-  let html = '<table class="pr-table"><thead><tr><th>Agent</th><th>Done</th><th>Errors</th><th>PRs</th><th>Approved</th><th>Rejected</th><th>Rate</th><th>Reviews</th></tr></thead><tbody>';
+  function fmtAvgRuntime(m) {
+    const total = m.totalRuntimeMs || 0;
+    const count = (m.tasksCompleted || 0) + (m.tasksErrored || 0);
+    if (!count || !total) return '-';
+    const avgMin = total / count / 60000;
+    return avgMin < 1 ? '<1m' : Math.round(avgMin) + 'm';
+  }
+
+  let html = '<table class="pr-table"><thead><tr><th>Agent</th><th>Done</th><th>Errors</th><th>PRs</th><th>Approved</th><th>Rejected</th><th>Rate</th><th>Reviews</th><th>Avg Runtime</th></tr></thead><tbody>';
   for (const [id, m] of rows) {
     const rate = m.prsCreated > 0 ? Math.round((m.prsApproved / m.prsCreated) * 100) + '%' : '-';
     const rateColor = m.prsCreated > 0 ? (m.prsApproved / m.prsCreated >= 0.7 ? 'var(--green)' : 'var(--red)') : 'var(--muted)';
@@ -76,6 +85,7 @@ function renderMetrics(metrics) {
       '<td style="color:' + (m.prsRejected > 0 ? 'var(--red)' : 'var(--muted)') + '">' + (m.prsRejected || 0) + '</td>' +
       '<td style="color:' + rateColor + ';font-weight:600">' + rate + '</td>' +
       '<td>' + (m.reviewsDone || 0) + '</td>' +
+      '<td style="color:var(--muted)">' + fmtAvgRuntime(m) + '</td>' +
     '</tr>';
   }
   html += '</tbody></table>';

package/dashboard.js

@@ -368,6 +368,8 @@ function getStatus() {
       decompose: CONFIG.engine?.autoDecompose !== false,
       tempAgents: !!CONFIG.engine?.allowTempAgents,
       inboxThreshold: CONFIG.engine?.inboxConsolidateThreshold || shared.ENGINE_DEFAULTS.inboxConsolidateThreshold,
+      ccModel: CONFIG.engine?.ccModel || shared.ENGINE_DEFAULTS.ccModel,
+      ccEffort: CONFIG.engine?.ccEffort || shared.ENGINE_DEFAULTS.ccEffort,
     },
     initialized: !!(CONFIG.agents && Object.keys(CONFIG.agents).length > 0),
     installId: safeRead(path.join(MINIONS_DIR, '.install-id')).trim() || null,
@@ -568,7 +570,7 @@ Available action types:
 - **schedule**: Create or update a scheduled task. Fields: id (unique slug), title, cron (3-field: minute hour dayOfWeek), workType (implement/test/explore/ask/review/fix), project (optional), agent (optional), description (optional), priority (optional), enabled (default true). Example cron: "0 9 2" = every Tuesday at 9am.
 - **delete-schedule**: Delete a scheduled task. Fields: id.
 - **create-meeting**: Start a team meeting. Fields: title (short meeting name), agenda (detailed text — what agents should investigate/debate, numbered items work best), agents (array of agent IDs), rounds (optional, default 3), project (optional).
-- **set-config**: Update engine settings. Fields: setting (setting name), value (new value). Valid settings: autoApprovePlans (bool), autoDecompose (bool), allowTempAgents (bool), maxConcurrent (number), maxTurns (number). Example: { "type": "set-config", "setting": "autoApprovePlans", "value": true }
+- **set-config**: Update engine settings. Fields: setting (setting name), value (new value). Valid settings: autoApprovePlans (bool), autoDecompose (bool), allowTempAgents (bool), maxConcurrent (number), maxTurns (number), ccModel (sonnet/haiku/opus), ccEffort (null/low/medium/high). Example: { "type": "set-config", "setting": "autoApprovePlans", "value": true }
 - **edit-pipeline**: Update an existing pipeline. Fields: id (pipeline ID), title (optional), stages (optional, JSON array — omit "agent" on stages unless the user specifically requests one; the engine routes to any available agent by default), trigger (optional, { cron: "minute hour dow" } or null for manual).
 - **unpin**: Remove a pinned note. Fields: title (exact title of the pinned note to remove)
 - **archive-plan**: Archive a completed/paused plan. Fields: file (PRD .json or plan .md filename)
@@ -801,7 +803,9 @@ function updateSession(store, key, sessionId, existing) {
  * @param {number} opts.maxTurns - Max tool-use turns
  * @param {string} opts.allowedTools - Comma-separated tool list
  */
-async function ccCall(message, { store = 'cc', sessionKey, extraContext, label = 'command-center', timeout = 900000, maxTurns = 50, allowedTools = 'Bash,Read,Write,Edit,Glob,Grep,WebFetch,WebSearch', skipStatePreamble = false, model = 'sonnet' } = {}) {
+async function ccCall(message, { store = 'cc', sessionKey, extraContext, label = 'command-center', timeout = 900000, maxTurns = 50, allowedTools = 'Bash,Read,Write,Edit,Glob,Grep,WebFetch,WebSearch', skipStatePreamble = false, model } = {}) {
+  if (!model) model = CONFIG.engine?.ccModel || shared.ENGINE_DEFAULTS.ccModel;
+  const ccEffort = CONFIG.engine?.ccEffort || shared.ENGINE_DEFAULTS.ccEffort;
   const existing = resolveSession(store, sessionKey);
   let sessionId = existing ? existing.sessionId : null;
 
@@ -817,7 +821,7 @@ async function ccCall(message, { store = 'cc', sessionKey, extraContext, label =
   // Attempt 1: resume existing session — skip preamble (session already has context)
   if (sessionId && maxTurns > 1) {
     result = await llm.callLLM(buildPrompt({ includePreamble: false }), '', {
-      timeout, label, model, maxTurns, allowedTools, sessionId,
+      timeout, label, model, maxTurns, allowedTools, sessionId, effort: ccEffort,
     });
     llm.trackEngineUsage(label, result.usage);
 
@@ -852,7 +856,7 @@ async function ccCall(message, { store = 'cc', sessionKey, extraContext, label =
   // Attempt 2: fresh session (include preamble for full context)
   const freshPrompt = buildPrompt();
   result = await llm.callLLM(freshPrompt, CC_STATIC_SYSTEM_PROMPT, {
-    timeout, label, model, maxTurns, allowedTools,
+    timeout, label, model, maxTurns, allowedTools, effort: ccEffort,
   });
   llm.trackEngineUsage(label, result.usage);
 
@@ -866,7 +870,7 @@ async function ccCall(message, { store = 'cc', sessionKey, extraContext, label =
   console.log(`[${label}] Fresh call also failed (code=${result.code}, empty=${!result.text}), retrying once more...`);
   await new Promise(r => setTimeout(r, 2000));
   result = await llm.callLLM(freshPrompt, CC_STATIC_SYSTEM_PROMPT, {
-    timeout, label, model, maxTurns, allowedTools,
+    timeout, label, model, maxTurns, allowedTools, effort: ccEffort,
   });
   llm.trackEngineUsage(label, result.usage);
 
@@ -3374,10 +3378,12 @@ What would you like to discuss or change? When you're happy, say "approve" and I
         const prompt = preamble + '\n\n---\n\n' + body.message;
 
         const { callLLMStreaming, trackEngineUsage: trackUsage } = require('./engine/llm');
+        const streamModel = CONFIG.engine?.ccModel || shared.ENGINE_DEFAULTS.ccModel;
+        const streamEffort = CONFIG.engine?.ccEffort || shared.ENGINE_DEFAULTS.ccEffort;
         const llmPromise = callLLMStreaming(prompt, CC_STATIC_SYSTEM_PROMPT, {
-          timeout: 900000, label: 'command-center', model: 'sonnet', maxTurns: 50,
+          timeout: 900000, label: 'command-center', model: streamModel, maxTurns: 50,
           allowedTools: 'Bash,Read,Write,Edit,Glob,Grep,WebFetch,WebSearch',
-          sessionId,
+          sessionId, effort: streamEffort,
           onChunk: (text) => {
             try { res.write('data: ' + JSON.stringify({ type: 'chunk', text }) + '\n\n'); } catch {}
           },
@@ -3582,6 +3588,15 @@ What would you like to discuss or change? When you're happy, say "approve" and I
         }
         // String fields
         if (e.worktreeRoot !== undefined) config.engine.worktreeRoot = String(e.worktreeRoot || D.worktreeRoot);
+        // CC model/effort
+        if (e.ccModel !== undefined) {
+          const valid = ['sonnet', 'haiku', 'opus'];
+          config.engine.ccModel = valid.includes(e.ccModel) ? e.ccModel : D.ccModel;
+        }
+        if (e.ccEffort !== undefined) {
+          const valid = [null, 'low', 'medium', 'high'];
+          config.engine.ccEffort = valid.includes(e.ccEffort) ? e.ccEffort : null;
+        }
         // Boolean fields
         for (const key of ['autoApprovePlans', 'evalLoop', 'autoDecompose', 'allowTempAgents']) {
           if (e[key] !== undefined) config.engine[key] = !!e[key];

package/engine/lifecycle.js

@@ -1019,6 +1019,12 @@ function updateMetrics(agentId, dispatchItem, result, taskUsage, prsCreatedCount
     m.lastTask = dispatchItem.task;
     m.lastCompleted = ts();
     if (model) m.model = model;
+    // Track runtime (wall-clock duration from dispatch start to completion)
+    const runtimeMs = (dispatchItem.started_at && dispatchItem.completed_at)
+      ? new Date(dispatchItem.completed_at).getTime() - new Date(dispatchItem.started_at).getTime()
+      : 0;
+    if (runtimeMs > 0) m.totalRuntimeMs = (m.totalRuntimeMs || 0) + runtimeMs;
+
     if (result === DISPATCH_RESULT.SUCCESS) {
       m.tasksCompleted++;
       if (prsCreatedCount > 0) m.prsCreated = (m.prsCreated || 0) + prsCreatedCount;
@@ -1036,9 +1042,10 @@ function updateMetrics(agentId, dispatchItem, result, taskUsage, prsCreatedCount
     }
     const today = dateStamp();
     if (!metrics._daily) metrics._daily = {};
-    if (!metrics._daily[today]) metrics._daily[today] = { costUsd: 0, inputTokens: 0, outputTokens: 0, cacheRead: 0, tasks: 0 };
+    if (!metrics._daily[today]) metrics._daily[today] = { costUsd: 0, inputTokens: 0, outputTokens: 0, cacheRead: 0, tasks: 0, runtimeMs: 0 };
     const daily = metrics._daily[today];
     daily.tasks++;
+    if (runtimeMs > 0) daily.runtimeMs = (daily.runtimeMs || 0) + runtimeMs;
     if (taskUsage) {
       daily.costUsd += taskUsage.costUsd || 0;
       daily.inputTokens += taskUsage.inputTokens || 0;

package/engine/llm.js

@@ -44,7 +44,7 @@ function trackEngineUsage(category, usage) {
 
 // ── Core LLM Call ───────────────────────────────────────────────────────────
 
-function callLLM(promptText, sysPromptText, { timeout = 120000, label = 'llm', model = 'sonnet', maxTurns = 1, allowedTools = '', sessionId = null } = {}) {
+function callLLM(promptText, sysPromptText, { timeout = 120000, label = 'llm', model = 'sonnet', maxTurns = 1, allowedTools = '', sessionId = null, effort = null } = {}) {
   return new Promise((resolve) => {
     const id = uid();
     const tmpDir = path.join(ENGINE_DIR, 'tmp');
@@ -61,6 +61,7 @@ function callLLM(promptText, sysPromptText, { timeout = 120000, label = 'llm', m
       '--verbose',
     ];
     if (allowedTools) args.push('--allowedTools', allowedTools);
+    if (effort) args.push('--effort', effort);
     args.push('--permission-mode', 'bypassPermissions');
 
     if (sessionId) args.push('--resume', sessionId);
@@ -113,7 +114,7 @@ function isResumeSessionStillValid(result) {
  * Returns the same result object as callLLM when the process completes.
  * onChunk(text) is called for each assistant text block as it arrives.
  */
-function callLLMStreaming(promptText, sysPromptText, { timeout = 120000, label = 'llm', model = 'sonnet', maxTurns = 1, allowedTools = '', sessionId = null, onChunk = () => {}, onToolUse = null } = {}) {
+function callLLMStreaming(promptText, sysPromptText, { timeout = 120000, label = 'llm', model = 'sonnet', maxTurns = 1, allowedTools = '', sessionId = null, onChunk = () => {}, onToolUse = null, effort = null } = {}) {
   let _abort = null;
   const promise = new Promise((resolve) => {
     const id = uid();
@@ -131,6 +132,7 @@ function callLLMStreaming(promptText, sysPromptText, { timeout = 120000, label =
       '--verbose',
     ];
     if (allowedTools) args.push('--allowedTools', allowedTools);
+    if (effort) args.push('--effort', effort);
     args.push('--permission-mode', 'bypassPermissions');
     if (sessionId) args.push('--resume', sessionId);
 

package/engine/shared.js

@@ -529,6 +529,8 @@ const ENGINE_DEFAULTS = {
   lockRetries: 2, // retry lock acquisition this many times after initial timeout (total attempts = 1 + lockRetries)
   lockRetryBackoffMs: 500, // base backoff between lock retries (doubles each attempt: 500ms, 1s, 2s, ...)
   maxBuildFixAttempts: 3, // max consecutive auto-fix dispatch cycles per PR before escalation to human
+  ccModel: 'sonnet', // model for Command Center and doc-chat (sonnet, haiku, opus)
+  ccEffort: null, // effort level for CC/doc-chat (null, 'low', 'medium', 'high')
 };
 
 // ─── Status & Type Constants ─────────────────────────────────────────────────
@@ -572,6 +574,7 @@ const DEFAULT_AGENT_METRICS = {
   reviewsDone: 0,
   lastTask: null, lastCompleted: null,
   totalCostUsd: 0, totalInputTokens: 0, totalOutputTokens: 0, totalCacheRead: 0,
+  totalRuntimeMs: 0, // cumulative agent runtime across all tasks
 };
 
 const DEFAULT_AGENTS = {

package/engine/spawn-agent.js

@@ -8,7 +8,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const { exec, runFile, cleanChildEnv, killGracefully, killImmediate, ts } = require('./shared');
+const { exec, runFile, cleanChildEnv, killGracefully, killImmediate, ts, safeJson, safeWrite } = require('./shared');
 
 const [,, promptFile, sysPromptFile, ...extraArgs] = process.argv;
 
@@ -29,14 +29,12 @@ const capsCachePath = path.join(__dirname, 'claude-caps.json');
 let _sysPromptFileSupported = null;
 
 // Fast path: use cached binary path if it still exists on disk
-try {
-  const caps = JSON.parse(fs.readFileSync(capsCachePath, 'utf8'));
-  if (caps.claudeBin && fs.existsSync(caps.claudeBin)) {
-    claudeBin = caps.claudeBin;
-    claudeIsNative = !!caps.claudeIsNative;
-    _sysPromptFileSupported = caps.sysPromptFile ?? null;
-  }
-} catch {}
+const caps = safeJson(capsCachePath);
+if (caps?.claudeBin && fs.existsSync(caps.claudeBin)) {
+  claudeBin = caps.claudeBin;
+  claudeIsNative = !!caps.claudeIsNative;
+  _sysPromptFileSupported = caps.sysPromptFile ?? null;
+}
 
 // Strategy 1: Check if `claude` is on PATH (native installer or npm global bin)
 if (!claudeBin) try {
@@ -127,7 +125,7 @@ if (_sysPromptFileSupported === null) {
     _sysPromptFileSupported = (testResult.stdout || '').includes('system-prompt-file');
   } catch { _sysPromptFileSupported = true; /* assume supported */ }
   // Save binary path + capability flag together
-  try { fs.writeFileSync(capsCachePath, JSON.stringify({ claudeBin, claudeIsNative, sysPromptFile: _sysPromptFileSupported, checkedAt: ts() })); } catch {}
+  try { safeWrite(capsCachePath, { claudeBin, claudeIsNative, sysPromptFile: _sysPromptFileSupported }); } catch {}
 }
 if (!isResume) try {
   if (!_sysPromptFileSupported) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yemi33/minions",
-  "version": "0.1.565",
+  "version": "0.1.567",
   "description": "Multi-agent AI dev team that runs from ~/.minions/ — five autonomous agents share a single engine, dashboard, and knowledge base",
   "bin": {
     "minions": "bin/minions.js"