metame-cli 1.5.21 → 1.5.22

package/scripts/daemon-team-workflow.js

@@ -0,0 +1,146 @@
+'use strict';
+
+const VALID_TEAM_COLORS = ['green', 'yellow', 'red', 'blue', 'purple', 'orange', 'pink', 'indigo'];
+
+function parseTeamMembers(input, teamName) {
+  const memberLines = String(input || '').split(/[,，\n]/).filter(line => line.trim());
+  const members = [];
+
+  for (const line of memberLines) {
+    const parts = line.trim().split(':');
+    const name = parts[0] && parts[0].trim();
+    if (!name) continue;
+
+    const icon = (parts[1] && parts[1].trim()) || '🤖';
+    const rawColor = parts[2] && parts[2].trim().toLowerCase();
+    const color = VALID_TEAM_COLORS.includes(rawColor)
+      ? rawColor
+      : VALID_TEAM_COLORS[members.length % VALID_TEAM_COLORS.length];
+
+    members.push({
+      key: name,
+      name: `${teamName} · ${name}`,
+      icon,
+      color,
+      nicknames: [name],
+    });
+  }
+
+  return members;
+}
+
+function findParentProjectKey({ projects, dirPath, normalizeCwd }) {
+  if (!projects || !dirPath) return null;
+  const targetDir = normalizeCwd(dirPath);
+
+  for (const [projKey, proj] of Object.entries(projects)) {
+    if (normalizeCwd(proj && proj.cwd ? proj.cwd : '') === targetDir) {
+      return projKey;
+    }
+  }
+
+  return null;
+}
+
+function ensureTeamMemberWorkspace({ fs, path, execSync, teamDir, teamName, member }) {
+  const memberDir = path.join(teamDir, member.key);
+  if (!fs.existsSync(memberDir)) fs.mkdirSync(memberDir, { recursive: true });
+
+  const claudeMdPath = path.join(memberDir, 'CLAUDE.md');
+  if (!fs.existsSync(claudeMdPath)) {
+    fs.writeFileSync(claudeMdPath, `# ${member.name}\n\n（团队成员：${teamName}）\n`, 'utf8');
+  }
+
+  try {
+    if (typeof execSync === 'function') execSync('git init -q', { cwd: memberDir, stdio: 'ignore' });
+  } catch {
+    // Git init is a best-effort enhancement for checkpoints.
+  }
+
+  return {
+    ...member,
+    cwd: memberDir,
+  };
+}
+
+function registerTeamMembers({
+  cfg,
+  parentProjectKey,
+  members,
+  writeConfigSafe,
+  backupConfig,
+}) {
+  if (!parentProjectKey || !cfg.projects || !cfg.projects[parentProjectKey]) return null;
+
+  const proj = cfg.projects[parentProjectKey];
+  if (!Array.isArray(proj.team)) proj.team = [];
+
+  for (const member of members) {
+    if (proj.team.some(existing => existing && existing.key === member.key)) continue;
+    proj.team.push({
+      key: member.key,
+      name: member.name,
+      icon: member.icon,
+      color: member.color,
+      cwd: member.cwd,
+      nicknames: member.nicknames,
+    });
+  }
+
+  if (typeof writeConfigSafe === 'function') writeConfigSafe(cfg);
+  if (typeof backupConfig === 'function') backupConfig();
+  return parentProjectKey;
+}
+
+function createTeamWorkspace({
+  fs,
+  path,
+  execSync,
+  dirPath,
+  teamName,
+  members,
+  loadConfig,
+  normalizeCwd,
+  writeConfigSafe,
+  backupConfig,
+  HOME,
+}) {
+  const teamDir = path.join(dirPath, 'team');
+  if (!fs.existsSync(teamDir)) fs.mkdirSync(teamDir, { recursive: true });
+
+  const createdMembers = members.map((member) => ensureTeamMemberWorkspace({
+    fs,
+    path,
+    execSync,
+    teamDir,
+    teamName,
+    member,
+  }));
+
+  const cfg = typeof loadConfig === 'function' ? loadConfig() : { projects: {} };
+  const parentProjectKey = findParentProjectKey({
+    projects: cfg.projects,
+    dirPath,
+    normalizeCwd,
+  });
+
+  registerTeamMembers({
+    cfg,
+    parentProjectKey,
+    members: createdMembers,
+    writeConfigSafe,
+    backupConfig,
+  });
+
+  return {
+    teamDir,
+    parentProjectKey,
+    memberLines: createdMembers.map((member) => `${member.icon} ${member.key}: ${member.cwd.replace(HOME, '~')}`),
+  };
+}
+
+module.exports = {
+  VALID_TEAM_COLORS,
+  parseTeamMembers,
+  createTeamWorkspace,
+};

package/scripts/daemon.js

@@ -507,6 +507,7 @@ function createNullBot(onOutput) {
     deleteMessage: async () => { },
     sendFile: noop,
     downloadFile: noop,
+    notifyFinalOutput: async (text) => { if (onOutput) onOutput({ body: text, final: true }); return { message_id: '_virtual' }; },
   };
 }
 
@@ -610,6 +611,7 @@ function createStreamForwardBot(realBot, chatId, onOutput = null, opts = {}) {
     deleteMessage: async (_, msgId) => { await waitUntilReady(); return realBot.deleteMessage(chatId, msgId); },
     sendFile: async (_, filePath, caption) => { await waitUntilReady(); return realBot.sendFile(chatId, filePath, caption); },
     downloadFile: async (...args) => realBot.downloadFile(...args),
+    notifyFinalOutput: async (text) => { if (onOutput) onOutput({ body: text, final: true }); return { message_id: '_virtual' }; },
   };
 }
 
@@ -897,10 +899,11 @@ function dispatchTask(targetProject, message, config, replyFn, streamOptions = n
 
   let _taskFinalized = false;
   const outputHandler = (output) => {
+    const isFinalOutput = !!(output && typeof output === 'object' && output.final);
     const outStr = typeof output === 'object' ? (output.body || JSON.stringify(output)) : String(output);
     const displayOut = envelope ? appendTeamTaskResumeHint(outStr, envelope.task_id, envelope.scope_id) : outStr;
     log('INFO', `Dispatch output from ${targetProject}: ${outStr.slice(0, 200)}`);
-    if (envelope && taskBoard && !_taskFinalized && outStr.trim().length > 2) {
+    if (!isFinalOutput && envelope && taskBoard && !_taskFinalized && outStr.trim().length > 2) {
       const status = inferTaskStatusFromOutput(outStr);
       const artifacts = extractArtifactPaths(outStr);
       const update = {
@@ -916,9 +919,9 @@ function dispatchTask(targetProject, message, config, replyFn, streamOptions = n
       });
       _taskFinalized = true;
     }
-    if (replyFn && outStr.trim().length > 2) {
+    if (!isFinalOutput && replyFn && outStr.trim().length > 2) {
       replyFn(displayOut);
-    } else if (!replyFn && fullMsg.callback && fullMsg.from && config) {
+    } else if (!isFinalOutput && !replyFn && fullMsg.callback && fullMsg.from && config) {
       // Write result to sender's inbox before dispatching callback
       try {
         const inboxDir = path.join(os.homedir(), '.metame', 'memory', 'inbox', fullMsg.from);
@@ -954,6 +957,7 @@ function dispatchTask(targetProject, message, config, replyFn, streamOptions = n
 
     // ── Reactive lifecycle hook ──
     try {
+      if (!isFinalOutput) return;
       handleReactiveOutput(targetProject, outStr, loadConfig(), {
         log,
         loadState,

package/scripts/docs/hook-config.md

@@ -1,4 +1,4 @@
-# MetaMe Hook / Intent Engine 配置手册
+# MetaMe Intent 配置手册
 
 > 自动部署到 `~/.metame/docs/hook-config.md`。源文件：`scripts/docs/hook-config.md`。只编辑 `scripts/`，不要直接改 `~/.metame/`。
 
@@ -8,15 +8,17 @@
 
 ```
 UserPromptSubmit (每轮用户输入)
-  ├── signal-capture.js      → 捕获用户偏好信号（写文件，不注入）
-  └── intent-engine.js       → 意图检测 + 按需注入 additionalSystemPrompt
+  └── signal-capture.js      → 捕获用户偏好信号（写文件，不注入）
+
+Daemon runtime (每轮真正发给引擎前)
+  └── intent-registry.js     → 意图检测 + 按需拼接提示块
 
 Stop (每轮结束)
   └── stop-session-capture.js → session 事件日志 + 工具失败捕获
 ```
 
 `scripts/intent-registry.js` 是单一维护源，负责调用各意图模块并返回提示块。
-`intent-engine.js` 是 Claude hook adapter；daemon 里的 Codex 路径也复用同一 registry。
+daemon 在运行时直接复用同一 registry，Claude / Codex 共用这一条注入路径。
 零匹配 → 零输出（不浪费 token）。
 
 ---
@@ -25,13 +27,20 @@ Stop (每轮结束)
 
 | 模块 key | 文件 | 触发条件 | 注入内容 |
 |---------|------|---------|---------|
+| `agent_capability` | `intent-agent-capability.js` | 明确的 Agent 创建/绑定/激活/分身/团队/角色/Soul 管理语境 | 当前真实支持的 `/agent ...` `/activate` 能力提示 |
 | `team_dispatch` | `intent-team-dispatch.js` | 检测到"告诉/让/发给 + 成员名"等联络意图 | `dispatch_to` 命令提示（仅匹配成员） |
 | `ops_assist` | `intent-ops-assist.js` | 回退/日志/重启/gc/状态 相关语境 | `/undo` `/restart` `/logs` `/gc` `/status` 命令提示 |
-| `task_create` | `intent-task-create.js` | 定时/提醒/每天X点 等调度语境 | `/task-add` 命令用法提示 |
 | `file_transfer` | `intent-file-transfer.js` | "发给我/发过来/导出" 等文件传输语境 | `[[FILE:...]]` 协议 + 收发规则 |
 | `weixin_bridge` | `intent-weixin-bridge.js` | "帮我绑定微信/配置微信桥接/开启微信接入/开始微信扫码登录" 等明确桥接语境 | 开启 `weixin.enabled` + `/weixin` 绑定流程提示 |
-| `memory_recall` | `intent-memory-recall.js` | "上次/之前/还记得" 等跨会话回忆语境 | `memory-search.js` 命令用法 |
-| `doc_router` | `intent-doc-router.js` | "创建/绑定 Agent"、"代码结构/脚本入口"、"hook/intent 配置" 等文档导向语境 | 统一 doc-router 文档指引 |
+| `memory_recall` | `intent-memory-recall.js` | "上次/之前/还记得" 等跨会话回忆语境 | `memory-search.js` CLI 召回提示 |
+| `doc_router` | `intent-doc-router.js` | "代码结构/脚本入口"、"hook/intent 配置" 等文档导向语境 | 统一 doc-router 文档指引 |
+| `perpetual` | `intent-perpetual.js` | 永续/reactive 任务语境 | `dispatch_to` / `/status perpetual` 等永续协议提示 |
+| `research` | `intent-research.js` | `paper_rev` 项目下的研究语境 | 研究方法与文件落点提示 |
+
+注入策略：
+- 零匹配 → 零输出
+- 多模块命中时按优先级裁剪，默认最多注入 2 个 hint、总长不超过约 1200 字符
+- `doc_router` 只作为 fallback；只要已有真实能力提示命中，就不再额外塞文档路由
 ---
 
 ## 开关控制
@@ -40,13 +49,13 @@ Stop (每轮结束)
 
 ```yaml
 hooks:
+  agent_capability: true
   team_dispatch: true   # 改为 false 可禁用
   ops_assist: true
-  task_create: false    # 禁用任务调度提示
   weixin_bridge: true   # 默认开启；只匹配明确的微信配置/绑定语境
 ```
 
-改完立即生效（intent-engine 每次运行时读取）。
+改完立即生效（daemon 每次发请求前都会读取）。
 **不需要重启 daemon。**
 
 ---
@@ -70,19 +79,20 @@ module.exports = function detect<Name>(prompt, config, projectKey) {
 };
 ```
 
-2. **注册到 intent-engine.js**：
+2. **注册到 intent-registry.js**：
 
 ```js
-// scripts/hooks/intent-engine.js
+// scripts/intent-registry.js
 const INTENT_MODULES = {
-  team_dispatch: './intent-team-dispatch',
-  ops_assist:    './intent-ops-assist',
-  task_create:   './intent-task-create',
-  your_name:     './intent-<name>',   // ← 加这行
+  agent_capability: require('./hooks/intent-agent-capability'),
+  team_dispatch: require('./hooks/intent-team-dispatch'),
+  ops_assist: require('./hooks/intent-ops-assist'),
+  your_name: require('./hooks/intent-<name>'), // ← 加这行
 };
 
 const DEFAULTS = {
   // ...
+  agent_capability: true,
   your_name: true,  // ← 加这行（默认开启）
 };
 ```
@@ -96,11 +106,14 @@ hooks:
   your_name: true
 ```
 
-4. **部署**：`node index.js`（同步文件到 `~/.metame/hooks/`）
+4. **部署**：`node index.js`
 
 5. **验证**：
 ```bash
-echo '{"prompt":"触发词"}' | node ~/.metame/hooks/intent-engine.js
+node - <<'EOF'
+const { buildIntentHintBlock } = require('./scripts/intent-registry');
+console.log(buildIntentHintBlock('触发词', {}, ''));
+EOF
 ```
 
 ---
@@ -109,7 +122,16 @@ echo '{"prompt":"触发词"}' | node ~/.metame/hooks/intent-engine.js
 
 ```bash
 # 测试某个 prompt 是否触发意图
-echo '{"prompt":"告诉工匠去做这个"}' | METAME_PROJECT=business node ~/.metame/hooks/intent-engine.js | python3 -m json.tool
+node - <<'EOF'
+const { buildIntentHintBlock } = require('./scripts/intent-registry');
+console.log(buildIntentHintBlock('告诉工匠去做这个', {
+  projects: {
+    business: {
+      team: [{ key: 'builder', name: '工匠', nicknames: ['工匠'] }],
+    },
+  },
+}, 'business'));
+EOF
 
 # 查看当前已注册的 hooks
 python3 -c "
@@ -128,9 +150,7 @@ for k, v in s.get('hooks', {}).items():
 
 | 文件 | 说明 |
 |------|------|
-| `scripts/intent-registry.js` | 共享意图注册表（Claude hook / Codex runtime 共用） |
-| `scripts/hooks/intent-engine.js` | Claude hook adapter（源文件） |
-| `~/.metame/hooks/intent-engine.js` | 部署副本（copy） |
+| `scripts/intent-registry.js` | 共享意图注册表（daemon 运行时唯一入口） |
 | `scripts/hooks/intent-*.js` | 各意图模块（源文件） |
 | `~/.metame/daemon.yaml` | 用户配置（包含 `hooks:` 开关） |
 | `~/.claude/settings.json` | Claude Code hook 注册表 |

package/scripts/docs/maintenance-manual.md

@@ -179,7 +179,7 @@ feishu:
 
 在手机端（飞书/Telegram）发送以下任一方式触发创建向导：
 
-- 自然语言：`创建团队`、`新建工作组`、`建个团队` 等（`_detectTeamIntent` 识别，位于 `daemon-command-router.js`）
+- 自然语言：`创建团队`、`新建工作组`、`建个团队` 等（`daemon-agent-intent.js` 统一识别并路由）
 - 命令：`/agent new team`
 
 向导分三步，全部在 `daemon-agent-commands.js` 中实现：
@@ -354,7 +354,7 @@ Claude 看到 hook 注入:
 | `daemon-admin-commands.js` | `/dispatch peers` 查看配置 + `/dispatch to peer:project` 手动派发 |
 | `scripts/bin/dispatch_to` | 支持 `peer:project` 格式 → 写 `remote-pending.jsonl` |
 | `daemon-team-dispatch.js` | `buildTeamRosterHint()` 为远端成员生成 `peer:key` 格式命令 |
-| `hooks/team-context.js` | intent hook 注入远端 `peer:key` dispatch 命令 |
+| `hooks/intent-team-dispatch.js` | daemon 意图注入远端 `peer:key` dispatch 命令 |
 
 ### 管理命令
 

package/scripts/docs/orphan-files-review.md

@@ -13,7 +13,7 @@
 |------|--------|------|
 | `session-analytics.js` | daemon-claude-engine, distill, memory-extract | 会话分析核心库 |
 | `mentor-engine.js` | daemon-claude-engine, daemon-admin-commands | AI 导师引擎 |
-| `intent-registry.js` | daemon-claude-engine, hooks/intent-engine | 意图识别注册表 |
+| `intent-registry.js` | daemon-claude-engine | 意图识别注册表（daemon 运行时注入） |
 | `daemon-command-session-route.js` | daemon-exec-commands, daemon-ops-commands | 会话路由解析 |
 | `daemon-siri-bridge.js` | daemon-bridges.js | Siri HTTP 桥接 |
 | `daemon-siri-imessage.js` | daemon-siri-bridge.js | iMessage 数据库读取 |

package/scripts/docs/pointer-map.md

@@ -53,7 +53,7 @@
   - `scripts/daemon-agent-tools.js`
   - 关键点：自然语言提取 `codex` 关键词；默认 `claude` 不写 `engine` 字段，仅 `codex` 持久化 `engine: codex`；
     `bindAgentToChat()` 自动调用 `ensureAgentMetadata()` 建立 soul 层；
-    `_detectTeamIntent()` 自然语言意图识别（含负样本过滤），识别"建团队"意图后自动路由到 `/agent new team` 向导
+    `daemon-agent-intent.js` 统一处理 Agent/团队自然语言入口（含负样本过滤、Windows 路径识别、显式动作优先）
 
 - 会话命令与兼容边界：
   - `scripts/daemon-exec-commands.js`
@@ -113,7 +113,7 @@
     按昵称解析到远端 member 时自动走 `sendRemoteDispatch`
 
 - Intent Hook：
-  - `scripts/hooks/team-context.js`
+  - `scripts/hooks/intent-team-dispatch.js`
   - 关键点：检测通信意图 → 注入 dispatch_to 命令提示；远端成员自动带 `peer:key` 前缀
 
 ## Mentor Mode（Step 1-4）定位

package/scripts/hooks/intent-agent-capability.js

@@ -0,0 +1,51 @@
+'use strict';
+
+const { classifyAgentIntent } = require('../agent-intent-shared');
+
+function buildLines(action) {
+  switch (action) {
+    case 'create':
+      return [
+        '- 创建并绑定当前群：直接用自然语言说“给这个群创建一个 Agent，目录是 ~/repo”',
+        '- 创建待激活 Agent：说“创建一个 codex agent，目录是 ~/repo”，再去目标群发 `/activate`',
+      ];
+    case 'bind':
+      return [
+        '- 绑定现有 Agent：`/agent bind <名称> <目录>`',
+        '- 也可直接说“给这个群绑定一个 Agent，目录是 ~/repo”',
+      ];
+    case 'list':
+      return ['- 查看已配置 Agent：`/agent list`'];
+    case 'unbind':
+      return ['- 解绑当前群：`/agent unbind`'];
+    case 'edit_role':
+      return ['- 修改当前 Agent 角色：`/agent edit <描述>`，或直接用自然语言说“把当前 agent 角色改成 ...”'];
+    case 'reset':
+      return ['- 清空当前 Agent 的角色定义：`/agent reset`'];
+    case 'soul':
+      return [
+        '- 查看当前 Soul：`/agent soul`',
+        '- 修复 Soul 文件：`/agent soul repair`',
+        '- 覆盖编辑 Soul：`/agent soul edit <内容>`',
+      ];
+    case 'activate':
+      return ['- 在新群完成绑定：进入目标群发送 `/activate`'];
+    case 'wizard_clone':
+      return ['- 创建当前 Agent 的分身：`/agent new clone`'];
+    case 'wizard_team':
+      return ['- 创建团队工作区：`/agent new team`'];
+    case 'agent_doc':
+      return ['- Agent 配置/管理文档：先看 `~/.metame/docs/agent-guide.md`'];
+    default:
+      return [];
+  }
+}
+
+module.exports = function detectAgentCapability(prompt) {
+  const intent = classifyAgentIntent(prompt);
+  if (!intent) return null;
+
+  const lines = buildLines(intent.action);
+  if (lines.length === 0) return null;
+  return ['[Agent 能力提示]', ...lines].join('\n');
+};

package/scripts/hooks/intent-doc-router.js

@@ -12,16 +12,18 @@
 
 const { createDocRoute } = require('./doc-router');
 
+const AGENT_DOC_PATTERNS = [
+  /(?:agent|智能体|机器人|bot).{0,12}(文档|手册|说明|guide)/i,
+  /(?:怎么|如何|手册|文档|说明).{0,12}(配置|管理|使用).{0,12}(agent|智能体|机器人|bot)/i,
+  /(?:agent|智能体|机器人|bot).{0,12}(怎么|如何).{0,12}(配置|管理|使用)/i,
+];
+
 const routes = [
   createDocRoute({
-    patterns: [
-      /(?:创建|新建|添加|注册|绑定|配置|管理).{0,8}(?:agent|机器人|bot|智能体)/i,
-      /(?:agent|bot|智能体).{0,8}(?:创建|新建|添加|注册|绑定|配置|管理)/i,
-      /\b(?:create|add|register|bind|manage|setup|configure)\s+(?:an?\s+)?agent\b/i,
-    ],
-    title: 'Agent 管理提示',
+    patterns: AGENT_DOC_PATTERNS,
+    title: 'Agent 文档提示',
     docPath: '~/.metame/docs/agent-guide.md',
-    summary: '创建/管理/绑定 Agent',
+    summary: 'Agent 配置/管理/使用说明',
   }),
   createDocRoute({
     patterns: [
@@ -34,8 +36,8 @@ const routes = [
   }),
   createDocRoute({
     patterns: [
-      /(?:hook|intent|意图).{0,10}(?:配置|设置|开关|新增|添加|修改|怎么配|怎么设置|怎么改)/i,
-      /(?:配置|设置|开关|新增|添加|修改).{0,10}(?:hook|intent|意图)/i,
+      /(?:hook|intent|意图).{0,10}(?:配置|设置|开关|新增|添加|修改|怎么配|怎么设置|怎么改|原理)/i,
+      /(?:配置|设置|开关|新增|添加|修改|原理).{0,10}(?:hook|intent|意图)/i,
       /intent.?engine/i,
       /意图引擎|意图模块/,
     ],
@@ -45,10 +47,20 @@ const routes = [
   }),
 ];
 
-module.exports = function detectDocRouter(prompt) {
+function hasExplicitDocIntent(prompt) {
+  const text = String(prompt || '').trim();
+  if (!text) return false;
+  return AGENT_DOC_PATTERNS.some((pattern) => pattern.test(text)) ||
+    /(?:文档|手册|说明|guide|readme)/i.test(text);
+}
+
+function detectDocRouter(prompt) {
   const hints = routes
     .map((detect) => detect(prompt))
     .filter(Boolean);
 
   return hints.length ? hints.join('\n') : null;
-};
+}
+
+module.exports = detectDocRouter;
+module.exports.hasExplicitDocIntent = hasExplicitDocIntent;

package/scripts/hooks/intent-memory-recall.js

@@ -17,8 +17,6 @@ const RECALL_PATTERNS = [
   /之前.{0,4}(?:说过|讨论过|聊过|提到过|商量过|做过的)/,
   // "还记得/记不记得" — asking if AI remembers (exclude "你记得" which is often imperative)
   /(?:还记得|记不记得|记得吗)/,
-  // "之前那个/上次那个" — referencing past artifacts
-  /(?:之前|上次|前几天)那个/,
   // English recall patterns
   /\b(?:last time|previously|remember when|do you remember|earlier we)\b/i,
 ];
@@ -31,6 +29,6 @@ module.exports = function detectMemoryRecall(prompt) {
     '- 搜索记忆: `node ~/.metame/memory-search.js "关键词1" "keyword2"`',
     '- 一次传 3-4 个关键词（中文+英文+函数名）',
     '- `--facts` 只搜事实，`--sessions` 只搜会话',
-    '- 统一召回: `require("./memory").assembleContext({ query, scope: { project, agent } })`',
+    '- 不要假设工作区里存在 `./memory` 模块；优先走 `memory-search.js` CLI 做召回',
   ].join('\n');
 };

package/scripts/hooks/intent-team-dispatch.js

@@ -4,7 +4,7 @@
  * Team Dispatch Intent Module
  *
  * Detects communication intent towards team members in the prompt.
- * Extracted from team-context.js — same logic, pure function interface.
+ * Daemon-side intent module for team dispatch hints.
  *
  * @param {string} prompt        - sanitized user prompt
  * @param {object} config        - daemon.yaml config

package/scripts/intent-registry.js

@@ -1,5 +1,7 @@
 'use strict';
 
+const detectDocRouter = require('./hooks/intent-doc-router');
+
 /**
  * Shared intent registry for all MetaMe runtime adapters.
  *
@@ -8,9 +10,9 @@
  */
 
 const DEFAULTS = Object.freeze({
+  agent_capability: true,
   team_dispatch: true,
   ops_assist: true,
-  task_create: true,
   file_transfer: true,
   weixin_bridge: true,
   memory_recall: true,
@@ -20,17 +22,54 @@ const DEFAULTS = Object.freeze({
 });
 
 const INTENT_MODULES = Object.freeze({
+  agent_capability: {
+    detect: require('./hooks/intent-agent-capability'),
+    priority: 100,
+  },
   team_dispatch: require('./hooks/intent-team-dispatch'),
-  ops_assist: require('./hooks/intent-ops-assist'),
-  task_create: require('./hooks/intent-task-create'),
-  file_transfer: require('./hooks/intent-file-transfer'),
-  weixin_bridge: require('./hooks/intent-weixin-bridge'),
-  memory_recall: require('./hooks/intent-memory-recall'),
-  doc_router: require('./hooks/intent-doc-router'),
-  perpetual: require('./hooks/intent-perpetual'),
-  research: require('./hooks/intent-research'),
+  ops_assist: {
+    detect: require('./hooks/intent-ops-assist'),
+    priority: 80,
+  },
+  file_transfer: {
+    detect: require('./hooks/intent-file-transfer'),
+    priority: 95,
+  },
+  weixin_bridge: {
+    detect: require('./hooks/intent-weixin-bridge'),
+    priority: 90,
+  },
+  memory_recall: {
+    detect: require('./hooks/intent-memory-recall'),
+    priority: 70,
+  },
+  doc_router: {
+    detect: detectDocRouter,
+    priority: 10,
+    fallbackOnly: true,
+  },
+  perpetual: {
+    detect: require('./hooks/intent-perpetual'),
+    priority: 60,
+  },
+  research: {
+    detect: require('./hooks/intent-research'),
+    priority: 55,
+  },
 });
 
+const DEFAULT_MAX_HINTS = 2;
+const DEFAULT_MAX_HINT_CHARS = 1200;
+
+function normalizeIntentModule(entry) {
+  if (typeof entry === 'function') return { detect: entry, priority: 50, fallbackOnly: false };
+  return {
+    detect: entry.detect,
+    priority: Number.isFinite(entry.priority) ? entry.priority : 50,
+    fallbackOnly: !!entry.fallbackOnly,
+  };
+}
+
 function resolveEnabledIntents(config = {}) {
   const hooksCfg = (config.hooks && typeof config.hooks === 'object') ? config.hooks : {};
   return { ...DEFAULTS, ...hooksCfg };
@@ -42,18 +81,43 @@ function collectIntentHints(prompt, config = {}, projectKey = '') {
 
   const enabled = resolveEnabledIntents(config);
   const hints = [];
-  for (const [key, detect] of Object.entries(INTENT_MODULES)) {
+  for (const [key, rawEntry] of Object.entries(INTENT_MODULES)) {
     if (enabled[key] === false) continue;
-    const hint = detect(text, config, projectKey);
+    const entry = normalizeIntentModule(rawEntry);
+    const hint = entry.detect(text, config, projectKey);
     if (hint) hints.push({ key, hint });
   }
   return hints;
 }
 
 function buildIntentHintBlock(prompt, config = {}, projectKey = '') {
-  return collectIntentHints(prompt, config, projectKey)
-    .map(item => item.hint)
-    .join('\n\n');
+  const maxHints = Number.isInteger(config && config.intent_max_hints) && config.intent_max_hints > 0
+    ? config.intent_max_hints
+    : DEFAULT_MAX_HINTS;
+  const maxChars = Number.isInteger(config && config.intent_max_hint_chars) && config.intent_max_hint_chars > 0
+    ? config.intent_max_hint_chars
+    : DEFAULT_MAX_HINT_CHARS;
+
+  let hits = collectIntentHints(prompt, config, projectKey)
+    .map((item) => ({ ...item, ...normalizeIntentModule(INTENT_MODULES[item.key]) }));
+
+  if (hits.some(item => !item.fallbackOnly) && !(typeof detectDocRouter.hasExplicitDocIntent === 'function' && detectDocRouter.hasExplicitDocIntent(prompt))) {
+    hits = hits.filter(item => !item.fallbackOnly);
+  }
+
+  hits.sort((a, b) => b.priority - a.priority);
+
+  const selected = [];
+  let usedChars = 0;
+  for (const item of hits) {
+    if (selected.length >= maxHints) break;
+    const nextChars = usedChars + item.hint.length;
+    if (selected.length > 0 && nextChars > maxChars) continue;
+    selected.push(item);
+    usedChars = nextChars;
+  }
+
+  return selected.map(item => item.hint).join('\n\n');
 }
 
 module.exports = {