metame-cli 1.4.17 → 1.4.19

package/scripts/daemon-admin-commands.js

@@ -1,5 +1,11 @@
 'use strict';
 
+const {
+  USAGE_CATEGORY_ORDER,
+  CORE_USAGE_CATEGORIES,
+  USAGE_CATEGORY_LABEL,
+} = require('./usage-classifier');
+
 function createAdminCommandHandler(deps) {
   const {
     fs,
@@ -18,8 +24,70 @@ function createAdminCommandHandler(deps) {
     dispatchTask,
     log,
     skillEvolution,
+    taskBoard,
+    taskEnvelope,
   } = deps;
 
+  function resolveProjectKey(targetName, projects) {
+    if (!targetName || !projects) return null;
+    for (const [key, proj] of Object.entries(projects || {})) {
+      const nicknames = Array.isArray(proj.nicknames)
+        ? proj.nicknames
+        : (proj.nicknames ? [proj.nicknames] : []);
+      if (key === targetName || nicknames.some(n => n === targetName)) return key;
+    }
+    return null;
+  }
+
+  function resolveSenderKey(chatId, config) {
+    const map = {
+      ...(config && config.feishu ? config.feishu.chat_agent_map : {}),
+      ...(config && config.telegram ? config.telegram.chat_agent_map : {}),
+    };
+    return map[String(chatId)] || 'user';
+  }
+
+  function popFlag(input, flagName) {
+    const src = String(input || '');
+    const re = new RegExp(`(?:^|\\s)--${flagName}\\s+(\\S+)`, 'i');
+    const m = src.match(re);
+    if (!m) return { text: src.trim(), value: '' };
+    const value = String(m[1] || '').trim();
+    const text = src.replace(m[0], ' ').replace(/\s+/g, ' ').trim();
+    return { text, value };
+  }
+
+  function parseTeamTaskArgs(raw) {
+    const src = String(raw || '').trim();
+    const first = src.match(/^(\S+)\s+([\s\S]+)$/);
+    if (!first) return null;
+    const targetName = first[1];
+    let rest = first[2].trim();
+    const scopePop = popFlag(rest, 'scope');
+    rest = scopePop.text;
+    const parentPop = popFlag(rest, 'parent');
+    rest = parentPop.text;
+    return {
+      targetName,
+      goal: rest,
+      scopeId: scopePop.value || '',
+      parentTaskId: parentPop.value || '',
+    };
+  }
+
+  function formatTaskSchedule(task) {
+    const at = typeof task.at === 'string' ? task.at.trim() : '';
+    if (at) {
+      const rawDays = task.days !== undefined ? task.days : task.weekdays;
+      let daysLabel = '';
+      if (Array.isArray(rawDays)) daysLabel = rawDays.join(',');
+      else if (typeof rawDays === 'string') daysLabel = rawDays.trim();
+      return daysLabel ? `at ${at} ${daysLabel}` : `at ${at}`;
+    }
+    if (task.interval) return `every ${task.interval}`;
+    return 'unspecified';
+  }
+
   async function handleAdminCommand(ctx) {
     const { bot, chatId, text } = ctx;
     const state = ctx.state || {};
@@ -138,7 +206,7 @@ function createAdminCommandHandler(deps) {
         msg += '📋 General:\n';
         for (const t of general) {
           const ts = state.tasks[t.name] || {};
-          msg += `${t.enabled !== false ? '✅' : '⏸'} ${t.name} (${t.interval}) ${ts.status || 'never_run'}\n`;
+          msg += `${t.enabled !== false ? '✅' : '⏸'} ${t.name} (${formatTaskSchedule(t)}) ${ts.status || 'never_run'}\n`;
         }
       }
       // Project tasks grouped by _project
@@ -152,7 +220,7 @@ function createAdminCommandHandler(deps) {
         msg += `\n${proj.icon} ${proj.name}:\n`;
         for (const t of tasks) {
           const ts = state.tasks[t.name] || {};
-          msg += `${t.enabled !== false ? '✅' : '⏸'} ${t.name} (${t.interval}) ${ts.status || 'never_run'}\n`;
+          msg += `${t.enabled !== false ? '✅' : '⏸'} ${t.name} (${formatTaskSchedule(t)}) ${ts.status || 'never_run'}\n`;
         }
       }
       if (!msg) {
@@ -163,6 +231,216 @@ function createAdminCommandHandler(deps) {
       return { handled: true, config };
     }
 
+    // /TeamTask — create/list/detail/resume team collaboration tasks
+    const teamTaskCmdMatch = text.match(/^\/teamtask(?:\s+([\s\S]+))?$/i);
+    if (teamTaskCmdMatch) {
+      const args = String(teamTaskCmdMatch[1] || '').trim();
+      if (/^create$/i.test(args)) {
+        await bot.sendMessage(chatId, '❌ 用法: /TeamTask create <agent> <目标> [--scope <scopeId>] [--parent <taskId>]');
+        return { handled: true, config };
+      }
+      const createMatch = args.match(/^create\s+([\s\S]+)$/i);
+      if (createMatch) {
+        if (!taskEnvelope) {
+          await bot.sendMessage(chatId, '❌ task protocol 不可用');
+          return { handled: true, config };
+        }
+        const parsed = parseTeamTaskArgs(createMatch[1]);
+        if (!parsed || !parsed.targetName || !parsed.goal) {
+          await bot.sendMessage(chatId, '❌ 用法: /TeamTask create <agent> <目标> [--scope <scopeId>] [--parent <taskId>]');
+          return { handled: true, config };
+        }
+        const { targetName, goal, scopeId, parentTaskId } = parsed;
+        const targetKey = resolveProjectKey(targetName, config.projects || {});
+        if (!targetKey) {
+          await bot.sendMessage(chatId, `未找到 agent: ${targetName}\n可用: ${Object.keys(config.projects || {}).join(', ')}`);
+          return { handled: true, config };
+        }
+        const senderKey = resolveSenderKey(chatId, config);
+        const participants = (scopeId && taskBoard && taskBoard.listScopeParticipants)
+          ? taskBoard.listScopeParticipants(scopeId)
+          : [];
+        participants.push(senderKey, targetKey);
+        const envelope = taskEnvelope.normalizeTaskEnvelope({
+          from_agent: senderKey,
+          to_agent: targetKey,
+          scope_id: scopeId || '',
+          parent_task_id: parentTaskId || null,
+          participants,
+          goal,
+          task_kind: 'team',
+          definition_of_done: [
+            '输出可执行结果和关键结论',
+            '必要时给出产物路径与下一步建议',
+          ],
+          inputs: {
+            source_chat_id: String(chatId),
+            source: 'mobile_teamtask',
+          },
+          priority: 'normal',
+          status: 'queued',
+        });
+        const checked = taskEnvelope.validateTaskEnvelope(envelope);
+        if (!checked.ok) {
+          await bot.sendMessage(chatId, `❌ TeamTask 无效: ${checked.error}`);
+          return { handled: true, config };
+        }
+        const result = dispatchTask(targetKey, {
+          from: senderKey,
+          type: 'task',
+          priority: envelope.priority,
+          payload: {
+            title: goal.slice(0, 60),
+            prompt: goal,
+            task_envelope: envelope,
+          },
+          callback: false,
+        }, config);
+        if (result.success) {
+          await bot.sendMessage(chatId, [
+            `✅ 已创建 TeamTask 并派发: ${envelope.task_id}`,
+            `Scope: ${envelope.scope_id || envelope.task_id}`,
+            `查看: /TeamTask ${envelope.task_id}`,
+          ].join('\n'));
+        } else {
+          await bot.sendMessage(chatId, `❌ 创建 TeamTask 失败: ${result.error}`);
+        }
+        return { handled: true, config };
+      }
+
+      if (!taskBoard) {
+        await bot.sendMessage(chatId, '❌ Task Board 不可用');
+        return { handled: true, config };
+      }
+
+      if (!args || /^list$/i.test(args)) {
+        const recent = taskBoard.listRecentTasks(10, null, 'team');
+        if (recent.length === 0) {
+          await bot.sendMessage(chatId, '暂无 TeamTask。\n使用 /TeamTask create <agent> <goal> 创建。');
+          return { handled: true, config };
+        }
+        let msg = '🧩 TeamTask (最近10条)\n';
+        for (const t of recent) {
+          msg += `\n- ${t.task_id} [${t.status}] scope=${t.scope_id || t.task_id}\n  ${t.from_agent}→${t.to_agent} · ${t.goal.slice(0, 80)}`;
+        }
+        msg += '\n\n查看详情: /TeamTask <task_id>\n续跑: /TeamTask resume <task_id>';
+        await bot.sendMessage(chatId, msg);
+        return { handled: true, config };
+      }
+
+      const resumeMatch = args.match(/^resume\s+(\S+)$/i);
+      if (resumeMatch) {
+        const taskId = resumeMatch[1];
+        const task = taskBoard.getTask(taskId);
+        if (!task || task.task_kind !== 'team') {
+          await bot.sendMessage(chatId, `❌ 未找到 TeamTask: ${taskId}`);
+          return { handled: true, config };
+        }
+        const targetKey = task.to_agent;
+        if (!config.projects || !config.projects[targetKey]) {
+          await bot.sendMessage(chatId, `❌ 目标 agent 不存在: ${targetKey}`);
+          return { handled: true, config };
+        }
+        const envelope = taskEnvelope && taskEnvelope.normalizeTaskEnvelope
+          ? taskEnvelope.normalizeTaskEnvelope({
+            ...task,
+            status: 'queued',
+            updated_at: new Date().toISOString(),
+            task_kind: 'team',
+            participants: taskBoard.listScopeParticipants(task.scope_id || task.task_id),
+          }, {
+            from_agent: task.from_agent || resolveSenderKey(chatId, config),
+            to_agent: targetKey,
+            scope_id: task.scope_id || task.task_id,
+          })
+          : {
+            task_id: task.task_id,
+            scope_id: task.scope_id || task.task_id,
+            from_agent: task.from_agent || resolveSenderKey(chatId, config),
+            to_agent: targetKey,
+            participants: taskBoard.listScopeParticipants(task.scope_id || task.task_id),
+            goal: task.goal,
+            definition_of_done: task.definition_of_done || [],
+            inputs: task.inputs || {},
+            artifacts: task.artifacts || [],
+            owned_paths: task.owned_paths || [],
+            priority: task.priority || 'normal',
+            status: 'queued',
+            task_kind: 'team',
+            created_at: task.created_at,
+            updated_at: new Date().toISOString(),
+          };
+
+        const result = dispatchTask(targetKey, {
+          from: envelope.from_agent || 'user',
+          type: 'task',
+          priority: envelope.priority || 'normal',
+          payload: {
+            title: envelope.goal.slice(0, 60),
+            prompt: envelope.goal,
+            task_envelope: envelope,
+          },
+          callback: false,
+          new_session: false,
+        }, config);
+
+        if (result.success) {
+          taskBoard.appendTaskEvent(task.task_id, 'task_resume_requested', String(chatId), { by: String(chatId) });
+          await bot.sendMessage(chatId, `✅ 已续跑 TeamTask: ${task.task_id}`);
+        } else {
+          await bot.sendMessage(chatId, `❌ 续跑失败: ${result.error}`);
+        }
+        return { handled: true, config };
+      }
+
+      if (/^resume$/i.test(args)) {
+        await bot.sendMessage(chatId, '❌ 用法: /TeamTask resume <task_id>');
+        return { handled: true, config };
+      }
+
+      const task = taskBoard.getTask(args);
+      if (!task || task.task_kind !== 'team') {
+        await bot.sendMessage(chatId, `❌ 未找到 TeamTask: ${args}`);
+        return { handled: true, config };
+      }
+      const events = taskBoard.listTaskEvents(task.task_id, 8);
+      const scopeId = task.scope_id || task.task_id;
+      const scopeTasks = taskBoard.listScopeTasks(scopeId, 12);
+      const scopeParticipants = taskBoard.listScopeParticipants(scopeId);
+      let detail = [
+        `🧩 TeamTask: ${task.task_id}`,
+        `Scope: ${scopeId}`,
+        `状态: ${task.status}`,
+        `优先级: ${task.priority}`,
+        `流向: ${task.from_agent} → ${task.to_agent}`,
+        `目标: ${task.goal}`,
+      ];
+      if (scopeParticipants.length > 0) {
+        detail.push(`参与者: ${scopeParticipants.join(', ')}`);
+      }
+      if (Array.isArray(task.definition_of_done) && task.definition_of_done.length > 0) {
+        detail.push('DoD:');
+        for (const d of task.definition_of_done.slice(0, 6)) detail.push(`- ${d}`);
+      }
+      if (Array.isArray(task.artifacts) && task.artifacts.length > 0) {
+        detail.push('产物:');
+        for (const a of task.artifacts.slice(0, 6)) detail.push(`- ${a}`);
+      }
+      if (task.last_error) detail.push(`错误: ${task.last_error.slice(0, 180)}`);
+      if (events.length > 0) {
+        detail.push('最近事件:');
+        for (const ev of events.slice(0, 5)) detail.push(`- [${ev.event_type}] ${ev.actor} @ ${ev.created_at}`);
+      }
+      if (scopeTasks.length > 1) {
+        detail.push('同 Scope 相关任务:');
+        for (const st of scopeTasks.filter(x => x.task_id !== task.task_id).slice(0, 5)) {
+          detail.push(`- ${st.task_id} [${st.status}] ${st.from_agent}→${st.to_agent}`);
+        }
+      }
+      await bot.sendMessage(chatId, detail.join('\n'));
+      return { handled: true, config };
+    }
+
     // /dispatch — inter-agent task dispatch
     if (text.startsWith('/dispatch')) {
       const args = text.slice('/dispatch'.length).trim();
@@ -216,21 +494,14 @@ function createAdminCommandHandler(deps) {
         const prompt = toMatch[2].trim();
 
         // Resolve target by project key or nickname
-        let targetKey = null;
-        for (const [key, proj] of Object.entries(config.projects || {})) {
-          if (key === targetName || (proj.nicknames || []).some(n => n === targetName)) {
-            targetKey = key;
-            break;
-          }
-        }
+        const targetKey = resolveProjectKey(targetName, config.projects || {});
         if (!targetKey) {
           await bot.sendMessage(chatId, `未找到 agent: ${targetName}\n可用: ${Object.keys(config.projects || {}).join(', ')}`);
           return { handled: true, config };
         }
 
         // Determine sender from current chat's project mapping
-        const chatAgentMap = (config.feishu && config.feishu.chat_agent_map) || {};
-        const senderKey = chatAgentMap[chatId] || 'user';
+        const senderKey = resolveSenderKey(chatId, config);
 
         const projInfo = config.projects[targetKey] || {};
         // Find the target project's own Feishu chat (reverse lookup of chat_agent_map)
@@ -263,7 +534,14 @@ function createAdminCommandHandler(deps) {
         return { handled: true, config };
       }
 
-      await bot.sendMessage(chatId, '用法:\n/dispatch status — 查看状态\n/dispatch log — 查看记录\n/dispatch to <agent> <任务内容>');
+      await bot.sendMessage(chatId, [
+        '用法:',
+        '/dispatch status — 查看状态',
+        '/dispatch log — 查看记录',
+        '/dispatch to <agent> <任务内容> — 直接跨 agent 派发',
+        '/TeamTask create <agent> <目标> [--scope <id>] [--parent <id>] — 创建/续接 TeamTask',
+        '/TeamTask — 查看 TeamTask 列表',
+      ].join('\n'));
       return { handled: true, config };
     }
 
@@ -274,6 +552,66 @@ function createAdminCommandHandler(deps) {
       return { handled: true, config };
     }
 
+    if (text === '/usage' || text.startsWith('/usage ')) {
+      const arg = text.slice('/usage'.length).trim() || 'today';
+      const usage = state.usage || {};
+      const daily = usage.daily || {};
+      const categories = usage.categories || {};
+      const limit = (config.budget && config.budget.daily_limit) || 50000;
+      const todayIso = new Date().toISOString().slice(0, 10);
+
+      // Resolve date range
+      let days = 1;
+      if (arg === 'week') days = 7;
+      else if (arg === 'month') days = 30;
+      else if (/^\d+d$/.test(arg)) days = Math.min(90, parseInt(arg, 10));
+
+      const dates = [];
+      for (let i = days - 1; i >= 0; i--) {
+        const d = new Date(`${todayIso}T00:00:00.000Z`);
+        d.setUTCDate(d.getUTCDate() - i);
+        dates.push(d.toISOString().slice(0, 10));
+      }
+
+      // Aggregate tokens by category across the date window
+      const totals = {};
+      let grandTotal = 0;
+      for (const date of dates) {
+        const bucket = daily[date] || {};
+        for (const [key, val] of Object.entries(bucket)) {
+          if (key === 'total') continue;
+          const n = Math.max(0, Math.floor(Number(val) || 0));
+          totals[key] = (totals[key] || 0) + n;
+          grandTotal += n;
+        }
+      }
+      // Fallback: if no daily breakdown yet, use categories totals for today
+      if (grandTotal === 0 && days === 1) {
+        for (const [key, meta] of Object.entries(categories)) {
+          const n = Math.max(0, Math.floor(Number(meta && meta.total) || 0));
+          if (n > 0) { totals[key] = n; grandTotal += n; }
+        }
+      }
+
+      const label = days === 1 ? `今日 (${todayIso})` : `近 ${days} 天`;
+      const budgetPct = limit > 0 ? ((grandTotal / limit) * 100).toFixed(1) : '—';
+      let lines = [`📊 Token 用量 — ${label}`, `合计: ${grandTotal.toLocaleString()} / ${limit.toLocaleString()} tokens (${budgetPct}%)`];
+
+      // Render by canonical order, then extras
+      const orderedKeys = [...USAGE_CATEGORY_ORDER, ...Object.keys(totals).filter(k => !USAGE_CATEGORY_ORDER.includes(k))];
+      for (const key of orderedKeys) {
+        const n = totals[key] || 0;
+        if (n === 0 && !CORE_USAGE_CATEGORIES.includes(key)) continue;
+        const pct = grandTotal > 0 ? ((n / grandTotal) * 100).toFixed(1) : '0.0';
+        const lbl = USAGE_CATEGORY_LABEL[key] || key;
+        const bar = '█'.repeat(Math.round(Number(pct) / 10)).padEnd(10, '░');
+        lines.push(`${lbl}: ${n.toLocaleString()} tokens (${pct}%) ${bar}`);
+      }
+
+      await bot.sendMessage(chatId, lines.join('\n'));
+      return { handled: true, config };
+    }
+
     if (text === '/quiet') {
       try {
         const doc = yaml.load(fs.readFileSync(BRAIN_FILE, 'utf8')) || {};