metame-cli 1.4.17 → 1.4.18

package/README.md

@@ -64,7 +64,7 @@ Claude:       ✏️ Edit: api/login.ts
               ✅ Fixed. 3 tests passing.
 ```
 
-Start on your laptop, continue on the train. `/stop` to interrupt, `/undo` to rollback, `/sh ls` for raw shell access when everything else breaks.
+Start on your laptop, continue on the train. `/stop` to interrupt, `/undo` to rollback, `/mac check` for macOS automation diagnostics, and `/sh ls` for raw shell access when everything else breaks.
 
 ### 3. Layered Memory That Works While You Sleep
 
@@ -124,7 +124,8 @@ projects:
     heartbeat_tasks:
       - name: "daily-draft"
         prompt: "Research top AI news and write an article"
-        interval: "24h"
+        at: "09:30"
+        days: "weekdays"
         model: "sonnet"
         notify: true
 
@@ -132,7 +133,7 @@ heartbeat:
   tasks:
     - name: "morning-brief"
       prompt: "Summarize my git activity from yesterday"
-      interval: "24h"
+      at: "09:00"
       notify: true
 ```
 
@@ -150,7 +151,7 @@ Chain skills into multi-step workflows — research → write → publish — fu
           prompt: "Publish it"
 ```
 
-Task options: `require_idle` (defer when you're active, retry on next heartbeat tick), `precondition` (shell guard — skip if false, zero tokens), `notify` (push result to phone), `model`, `cwd`, `allowedTools`, `timeout`.
+Task options: `interval` (every N seconds/minutes/hours/days), `at` (fixed local `HH:MM`), `days` (optional day filter), `require_idle` (defer when you're active, retry on next heartbeat tick), `precondition` (shell guard — skip if false, zero tokens), `notify` (push result to phone), `model`, `cwd`, `allowedTools`, `timeout`.
 
 ### 5. Skills That Evolve Themselves
 
@@ -208,7 +209,7 @@ npm install -g metame-cli && metame
 | **Browser Automation** | Built-in Playwright MCP. Browser control out of the box for every user. |
 | **Provider Relay** | Route through any Anthropic-compatible API. Use GPT-4, DeepSeek, Gemini — zero config file mutation. |
 | **Metacognition** | Detects behavioral patterns (decision style, comfort zones, goal drift) and injects mirror observations. Zero extra API cost. |
-| **Emergency Tools** | `/doctor` diagnostics, `/sh` raw shell, `/fix` config restore, `/undo` git-based rollback. |
+| **Emergency Tools** | `/doctor` diagnostics, `/mac` macOS control helpers, `/sh` raw shell, `/fix` config restore, `/undo` git-based rollback. |
 
 ## Defining Your Agents
 
@@ -263,7 +264,8 @@ projects:
     heartbeat_tasks:
       - name: "daily-review"
         prompt: "Review yesterday's commits and flag any issues"
-        interval: "24h"
+        at: "20:30"
+        days: [mon, tue, wed, thu, fri]
         notify: true
 
 feishu:
@@ -294,6 +296,7 @@ All agents share your cognitive profile (`~/.claude_profile.yaml`) — they all
 | `/list` | Browse & download project files |
 | `/model` | Switch model (sonnet/opus/haiku) |
 | `/agent bind <name> [dir]` | Register group as dedicated agent |
+| `/mac` | macOS control helper: permissions check/open + AppleScript/JXA execution |
 | `/sh <cmd>` | Raw shell — bypasses Claude |
 | `/memory` | Memory stats: fact count, session tags, DB size |
 | `/memory <keyword>` | Search long-term facts by keyword |

package/index.js

@@ -30,7 +30,7 @@ if (!fs.existsSync(METAME_DIR)) {
 // Auto-deploy bundled scripts to ~/.metame/
 // IMPORTANT: daemon.yaml is USER CONFIG — never overwrite it. Only daemon-default.yaml (template) is synced.
 const scriptsDir = path.join(__dirname, 'scripts');
-const BUNDLED_BASE_SCRIPTS = ['signal-capture.js', 'distill.js', 'schema.js', 'pending-traits.js', 'migrate-v2.js', 'daemon.js', 'telegram-adapter.js', 'feishu-adapter.js', 'daemon-default.yaml', 'providers.js', 'session-analytics.js', 'resolve-yaml.js', 'utils.js', 'skill-evolution.js', 'memory.js', 'memory-extract.js', 'qmd-client.js', 'session-summarize.js'];
+const BUNDLED_BASE_SCRIPTS = ['signal-capture.js', 'distill.js', 'schema.js', 'pending-traits.js', 'migrate-v2.js', 'daemon.js', 'telegram-adapter.js', 'feishu-adapter.js', 'daemon-default.yaml', 'providers.js', 'session-analytics.js', 'resolve-yaml.js', 'utils.js', 'skill-evolution.js', 'memory.js', 'memory-extract.js', 'memory-search.js', 'qmd-client.js', 'session-summarize.js', 'check-macos-control-capabilities.sh'];
 const DAEMON_MODULE_SCRIPTS = (() => {
   try {
     return fs.readdirSync(scriptsDir).filter((f) => /^daemon-[\w-]+\.js$/.test(f));
@@ -1755,15 +1755,22 @@ if (!isKnownUser) {
 // RAG: inject relevant facts based on current project (desktop-side equivalent of daemon RAG)
 try {
   const memory = require(path.join(__dirname, 'scripts', 'memory.js'));
-  // Derive project key from git repo name or cwd basename
-  let projectQuery = path.basename(process.cwd());
+  const { projectScopeFromCwd } = require(path.join(__dirname, 'scripts', 'utils.js'));
+  // Keep cwd basename as authoritative project filter for legacy rows (scope IS NULL).
+  const cwdProject = path.basename(process.cwd());
+  let repoProject = cwdProject;
   try {
     const { execSync } = require('child_process');
     const remote = execSync('git remote get-url origin 2>/dev/null || true', { encoding: 'utf8', stdio: 'pipe' }).trim();
-    if (remote) projectQuery = path.basename(remote, '.git');
+    if (remote) repoProject = path.basename(remote, '.git');
   } catch { /* not a git repo, use dirname */ }
 
-  const facts = memory.searchFacts(projectQuery, { limit: 5 });
+  const factQuery = repoProject === cwdProject ? cwdProject : `${repoProject} ${cwdProject}`;
+  const facts = memory.searchFacts(factQuery, {
+    limit: 5,
+    project: cwdProject || undefined,
+    scope: projectScopeFromCwd(process.cwd()) || undefined,
+  });
   if (facts.length > 0) {
     const factBlock = facts.map(f => `- [${f.relation}] ${f.value}`).join('\n');
     launchArgs.push(

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "metame-cli",
-    "version": "1.4.17",
+    "version": "1.4.18",
     "description": "The Cognitive Profile Layer for Claude Code. Knows how you think, not just what you said.",
     "main": "index.js",
     "bin": {
@@ -13,7 +13,7 @@
     "scripts": {
         "test": "node --test scripts/*.test.js",
         "start": "node index.js",
-        "sync:plugin": "cp scripts/schema.js scripts/pending-traits.js scripts/signal-capture.js scripts/distill.js scripts/daemon.js scripts/daemon-agent-commands.js scripts/daemon-session-commands.js scripts/daemon-admin-commands.js scripts/daemon-exec-commands.js scripts/daemon-ops-commands.js scripts/daemon-session-store.js scripts/daemon-checkpoints.js scripts/daemon-bridges.js scripts/daemon-file-browser.js scripts/daemon-runtime-lifecycle.js scripts/daemon-notify.js scripts/daemon-claude-engine.js scripts/daemon-command-router.js scripts/daemon-agent-tools.js scripts/daemon-task-scheduler.js scripts/telegram-adapter.js scripts/feishu-adapter.js scripts/daemon-default.yaml scripts/providers.js scripts/utils.js scripts/resolve-yaml.js scripts/memory.js scripts/memory-extract.js scripts/qmd-client.js scripts/session-summarize.js scripts/session-analytics.js scripts/skill-evolution.js plugin/scripts/ && echo '✅ Plugin scripts synced'",
+        "sync:plugin": "cp scripts/schema.js scripts/pending-traits.js scripts/signal-capture.js scripts/distill.js scripts/daemon.js scripts/daemon-agent-commands.js scripts/daemon-session-commands.js scripts/daemon-admin-commands.js scripts/daemon-exec-commands.js scripts/daemon-ops-commands.js scripts/daemon-session-store.js scripts/daemon-checkpoints.js scripts/daemon-bridges.js scripts/daemon-file-browser.js scripts/daemon-runtime-lifecycle.js scripts/daemon-notify.js scripts/daemon-claude-engine.js scripts/daemon-command-router.js scripts/daemon-agent-tools.js scripts/daemon-task-scheduler.js scripts/daemon-task-envelope.js scripts/task-board.js scripts/telegram-adapter.js scripts/feishu-adapter.js scripts/daemon-default.yaml scripts/providers.js scripts/utils.js scripts/usage-classifier.js scripts/resolve-yaml.js scripts/memory.js scripts/memory-extract.js scripts/qmd-client.js scripts/session-summarize.js scripts/session-analytics.js scripts/skill-evolution.js scripts/check-macos-control-capabilities.sh plugin/scripts/ && echo '✅ Plugin scripts synced'",
         "restart:daemon": "node index.js stop 2>/dev/null; sleep 1; node index.js start 2>/dev/null || echo '⚠️  Daemon not running or restart failed'",
         "precommit": "npm run sync:plugin && npm run restart:daemon"
     },

package/scripts/check-macos-control-capabilities.sh

@@ -0,0 +1,77 @@
+#!/usr/bin/env bash
+set -u
+set -o pipefail
+
+PASS=0
+FAIL=0
+WARN=0
+
+print_line() {
+  printf '%s\n' "$1"
+}
+
+run_check() {
+  local name="$1"
+  local mode="$2"
+  local cmd="$3"
+
+  local output
+  output="$(bash -o pipefail -lc "$cmd" 2>&1)"
+  local code=$?
+
+  if [ "$mode" = "pass_on_zero" ]; then
+    if [ $code -eq 0 ]; then
+      PASS=$((PASS + 1))
+      print_line "[PASS] $name"
+      [ -n "$output" ] && print_line "  $output"
+    else
+      FAIL=$((FAIL + 1))
+      print_line "[FAIL] $name"
+      [ -n "$output" ] && print_line "  $output"
+    fi
+    return
+  fi
+
+  if [ "$mode" = "warn_on_nonzero" ]; then
+    if [ $code -eq 0 ]; then
+      PASS=$((PASS + 1))
+      print_line "[PASS] $name"
+      [ -n "$output" ] && print_line "  $output"
+    else
+      WARN=$((WARN + 1))
+      print_line "[WARN] $name"
+      [ -n "$output" ] && print_line "  $output"
+    fi
+    return
+  fi
+
+  FAIL=$((FAIL + 1))
+  print_line "[FAIL] $name"
+  print_line "  invalid mode: $mode"
+}
+
+print_line "MetaMe macOS control capability check"
+print_line "Timestamp: $(date '+%Y-%m-%d %H:%M:%S %z')"
+print_line ""
+
+run_check "osascript binary available" "pass_on_zero" "which osascript"
+run_check "AppleScript baseline" "pass_on_zero" "osascript -e 'return \"ok\"'"
+run_check "Finder automation" "pass_on_zero" "osascript -e 'tell application \"Finder\" to get name of startup disk'"
+run_check "System Events accessibility" "pass_on_zero" "osascript -e 'tell application \"System Events\" to get UI elements enabled'"
+run_check "GUI app launch/control (Calculator)" "pass_on_zero" "open -a Calculator >/dev/null 2>&1; sleep 1; osascript -e 'tell application \"System Events\" to tell process \"Calculator\" to return {frontmost, (count of windows)}'; osascript -e 'tell application \"Calculator\" to quit' >/dev/null 2>&1"
+
+SHOT_PATH="/tmp/metame_gui_test_$$.png"
+run_check "Screenshot capability (screencapture)" "pass_on_zero" "screencapture -x '$SHOT_PATH' && ls -lh '$SHOT_PATH'"
+rm -f "$SHOT_PATH" >/dev/null 2>&1
+
+run_check "Full Disk probe: read ~/Library/Mail" "warn_on_nonzero" "ls '$HOME/Library/Mail' | head -n 3"
+run_check "Full Disk probe: query Safari History.db" "warn_on_nonzero" "sqlite3 '$HOME/Library/Safari/History.db' 'select count(*) from history_items;'"
+
+print_line ""
+print_line "Summary: pass=$PASS warn=$WARN fail=$FAIL"
+
+if [ $FAIL -gt 0 ]; then
+  exit 1
+fi
+
+exit 0

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')) || {};