@oxmumu3/dsh-project-companion 0.22.1 → 0.23.0

package/docs/verification.md

@@ -1,3 +1,16 @@
+# 0.23.0 验证增量
+
+2026-11-04，把项目工具的 30 个动作收敛为 `look` / `manage` 两个首选入口（旧名保留兼容）。
+
+- `node --max-old-space-size=256 --test --test-concurrency=1 test/*.test.mjs`：2,343 项 / 2,306 通过 / 0 失败 / 37 跳过（跳过项均需 Family 源码树）。
+- `node --test test/contract-guidance.test.mjs test/guidance.test.mjs test/action-surface.test.mjs test/routing-surface.test.mjs`：15/15。
+- `npm run report:routing`：动作 32（入口 2 + 兼容旧名 30）、look 视角 6、manage 动作 12、策略提示词 3,112 字符、`project_companion` 描述 722 字符、四个工具描述合计 1,367 字符、40 句语料 40 句可解析到入口。
+- 契约测试固定三件事：入口只能翻译成已声明的动作；语料覆盖每个 view/op；描述写明全部取值。
+
+**本版没有验证的**：没有用真实模型跑这 40 句，所以"入口收敛是否让模型选得更准"仍未证实——本版只证明入口集合更小、映射正确、语料可解析。旧动作名仍在 enum 中，模型理论上仍可直接调用它们。界面上的首屏简报与诊断码可视化未做。
+
+---
+
 # 0.22.1 验证增量
 
 2026-11-04，把 0.21 私有线独有的 3 个诊断模块移植到发布线并接回 9 个引用点（另补上私有线清单里漏掉的 `news-model.js` 与 `review-runtime-health.js`）。

package/index.js

@@ -7,6 +7,7 @@ import {defineDomain,domainTable} from '@deepseek-ai/dsh-storage-domain';
 import {createUserMessage} from '@deepseek-ai/dsh-llm';
 import {createService,parseCommand} from './src/service.js';
 import {registerGuidance} from './src/guidance.js';
+import {normalizeSurfaceAction,LOOK_VIEWS,MANAGE_OPS,SURFACE_COPY} from './src/action-surface.js';
 import {createWechatRecoveryGuard} from './src/wechat-recovery.js';
 import {createCoordinator,effectiveCwd} from './src/coordination.js';
 import {createFamilyProjectAdmission} from './src/family-project-admission.js';
@@ -1025,9 +1026,11 @@ export async function installCompanion(ctx,options={}){
   }));
   ctx.tools.register(defineTool({
     name:'project_companion',
-    description:'项目与交办。list/watch/unwatch 按友好项目名称查询或关注；digest 看进展与卡点（detail:analysis 读有界材料）；project_update 只回答“相比上次有什么变化”；memory/remember/correct_memory/forget_memory 管项目记忆；context_brief/context_status/context_handoff/context_check/context_forget 走个人资料简报闭环；check_once/once_status/cancel_once 是一次检查，configure_followup/cancel_followup/followup_status 是周期跟进，configure_daily/cancel_daily 是每日汇报；remind/cancel_reminder 是提醒；coordinate/task_status 是交办与结果查询；pause/resume 管自动跟进。查询不派工。',
+    description:'项目与交办。两类入口优先用：【看】action:look + view：progress=进展与卡点｜change=相比上次的变化（本人明确问了才传 userRequested:true）｜status=总状态｜task=交办到哪了｜once=一次检查｜followup=周期跟进。【管】action:manage + op：watch/unwatch=关注或取消｜memory/remember/correct_memory/forget_memory=项目记忆｜pause/resume=暂停或恢复自动跟进｜daily/cancel_daily=每日汇报｜followup/cancel_followup=周期跟进配置。【做】保持独立动作：coordinate=明确要求执行或继续；remind=提醒；personal_context 读外部资料；personal_review 做回顾；ai_digest 做资讯。【兼容】旧动作名仍可用，不删是为了不破坏已安装：list、digest、project_update、status、task_status、once_status、cancel_once、followup_status、check_once、configure_daily、cancel_daily、configure_followup、cancel_followup、link_github、context_brief、context_status、context_handoff、context_check、context_forget，提醒取消用 cancel_reminder。新调用优先用 look/manage。',
     parameters:{
-      action:{type:'string',required:true,enum:['watch','unwatch','list','digest','project_update','context_brief','context_status','context_handoff','context_check','context_forget','memory','remember','correct_memory','forget_memory','check_once','once_status','cancel_once','configure_followup','cancel_followup','followup_status','configure_daily','cancel_daily','pause','resume','remind','cancel_reminder','link_github','status','coordinate','task_status']},
+      action:{type:'string',required:true,enum:['look','manage','watch','unwatch','list','digest','project_update','context_brief','context_status','context_handoff','context_check','context_forget','memory','remember','correct_memory','forget_memory','check_once','once_status','cancel_once','configure_followup','cancel_followup','followup_status','configure_daily','cancel_daily','pause','resume','remind','cancel_reminder','link_github','status','coordinate','task_status']},
+      view:{type:'string',enum:LOOK_VIEWS,description:'look 的视角。'+SURFACE_COPY.look},
+      op:{type:'string',enum:MANAGE_OPS,description:'manage 的动作。'+SURFACE_COPY.manage},
       reviewItemId:{type:'string',description:'coordinate可选：仅当本人任务全文明确引用个人回顾「事项原题」时，从prepare结果映射稳定itemId。目标须在该事项原回顾项目范围内；不自行添加源正文或宣称已处理。'},
       objective:{type:'string',description:'context_brief：用户明确想推进的目标，最多160字；沿用同一目标时可省略。'},
       queries:{type:'array',items:{type:'object',additionalProperties:false,properties:{source:{type:'string',enum:CONTEXT_SOURCES,required:true},operation:{type:'string',required:true},query:{type:'string'},id:{type:'string'},ids:{type:'array',items:{type:'string'}},projectId:{type:'string'},range:{type:'string'},from:{type:'string'},to:{type:'string'},calendarId:{type:'string'},limit:{type:'number'}}},description:'context_brief：用户明确限定的最多5项来源查询（每个来源一次），每项最多3条。每源独立参数，沿用当前简报范围时省略；不因已连接而扫描全部账号。'},
@@ -1091,6 +1094,7 @@ export async function installCompanion(ctx,options={}){
     }},
     async execute(args,execution){
       if(disposed)return{status:'blocked',accepted:false,text:'项目助理正在关闭，暂不接收新的交办。'};
+      args=normalizeSurfaceAction(args);
       try{return await withFamily(execution,args,async admittedArgs=>{args=admittedArgs;try{
         if(args.action.startsWith('context_')){
           try{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxmumu3/dsh-project-companion",
-  "version": "0.22.1",
+  "version": "0.23.0",
   "description": "DSH Dot: WeChat personal agent, project memory and proactive follow-up for DeepSeek Harness",
   "author": "牛村木木山",
   "license": "MIT",
@@ -25,7 +25,9 @@
     "docs/comparison.md",
     "scripts/demo.mjs",
     "scripts/prompt-report.mjs",
+    "scripts/routing-report.mjs",
     "test/",
+    "test/routing-corpus.mjs",
     "docs/developer-commands.md",
     "vendor/",
     "THIRD_PARTY_NOTICES.md",
@@ -58,7 +60,8 @@
     "test": "node --max-old-space-size=128 --test --test-concurrency=1 test/*.test.mjs",
     "demo": "node --max-old-space-size=128 scripts/demo.mjs",
     "report:prompt": "node scripts/prompt-report.mjs",
-    "verify": "node --max-old-space-size=256 --test --test-concurrency=1 test/*.test.mjs && node scripts/prompt-report.mjs"
+    "verify": "node --max-old-space-size=256 --test --test-concurrency=1 test/*.test.mjs && node scripts/prompt-report.mjs",
+    "report:routing": "node scripts/routing-report.mjs"
   },
   "dependencies": {
     "zod": "4.6.7"

package/scripts/routing-report.mjs

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+/** Report the model-facing routing surface and the phrasing corpus coverage.
+ *  Run after changing the tool surface: `npm run report:routing`. */
+import {readFile} from 'node:fs/promises';
+import {registerGuidance} from '../src/guidance.js';
+import {LOOK_VIEWS,MANAGE_OPS,normalizeSurfaceAction} from '../src/action-surface.js';
+import {CORPUS} from '../test/routing-corpus.mjs';
+
+const source=await readFile(new URL('../index.js',import.meta.url),'utf8');
+function surface(tool){
+  const at=source.indexOf(`name:'${tool}',\n    description:'`);
+  const description=/description:'([^']*)'/.exec(source.slice(at,at+4000))[1];
+  const list=/action:\{type:'string',required:true,enum:\[([^\]]*)\]/.exec(source.slice(at,at+8000))[1]
+    .split(',').map(value=>value.trim().replace(/^'|'$/g,'')).filter(Boolean);
+  return {description,list};
+}
+let section;
+registerGuidance({systemPrompt:{section:value=>{section=value;}},tools:{get:()=>({})}},{clock:()=>new Date(),hostTimeZone:()=>Intl.DateTimeFormat().resolvedOptions().timeZone});
+const promptText=section.text({scope:{id:'synthetic-report'}});
+const project=surface('project_companion');
+const composites=project.list.filter(name=>name==='look'||name==='manage');
+const legacy=project.list.filter(name=>!composites.includes(name));
+
+const routed=CORPUS.filter(([,entry,key])=>{
+  const args=entry==='look'?{action:'look',view:key,project:'p'}:{action:'manage',op:key,project:'p'};
+  try{return normalizeSurfaceAction(args).action!==entry;}catch{return false;}
+});
+
+console.log('模型可见路由面报告');
+console.log(`工具动作数        ${project.list.length}（入口 ${composites.length} 个：${composites.join('、')}；兼容旧名 ${legacy.length} 个）`);
+console.log(`look 视角          ${LOOK_VIEWS.length} 个：${LOOK_VIEWS.join('、')}`);
+console.log(`manage 动作        ${MANAGE_OPS.length} 个：${MANAGE_OPS.join('、')}`);
+console.log(`策略提示词         ${promptText.length} 字符`);
+console.log(`工具描述           ${project.description.length} 字符`);
+console.log(`评测语料           ${CORPUS.length} 句，可解析到入口 ${routed.length} 句`);
+console.log('');
+console.log('说明：入口数决定模型一次要在几个名字里选；兼容旧名不删是为了不破坏已安装。');

package/src/action-surface.js

@@ -0,0 +1,56 @@
+/** Two composite entries over the project tool's long legacy action list.
+ *
+ *  The model picks between `look` and `manage` (plus the safety-critical
+ *  standalone actions it already had); this module translates the chosen
+ *  view/op back into the exact legacy action so every existing handler,
+ *  guard and test keeps working unchanged. Old action names stay valid.
+ */
+export const LOOK_VIEWS = ['progress', 'change', 'status', 'task', 'once', 'followup'];
+export const MANAGE_OPS = ['watch', 'unwatch', 'memory', 'remember', 'correct_memory', 'forget_memory', 'pause', 'resume', 'daily', 'cancel_daily', 'followup', 'cancel_followup'];
+
+const LOOK = {
+  progress: a => ({ action: 'digest', project: a.project, ...(a.detail ? { detail: a.detail } : {}) }),
+  change: a => ({ action: 'project_update', project: a.project, userRequested: a.userRequested === true }),
+  status: () => ({ action: 'status' }),
+  task: a => ({ action: 'task_status', ...(a.id ? { id: a.id } : {}) }),
+  once: a => ({ action: 'once_status', ...(a.project ? { project: a.project } : {}) }),
+  followup: a => ({ action: 'followup_status', ...(a.project ? { project: a.project } : {}) }),
+};
+
+const MANAGE = {
+  watch: a => ({ action: 'watch', ...(a.project ? { project: a.project } : {}) }),
+  unwatch: a => ({ action: 'unwatch', ...(a.project ? { project: a.project } : {}) }),
+  memory: a => ({ action: 'memory', project: a.project }),
+  remember: a => ({ action: 'remember', project: a.project, memoryKind: a.memoryKind, memoryText: a.memoryText, sourceKind: a.sourceKind, ...(a.sourceReference ? { sourceReference: a.sourceReference } : {}), userRequested: a.userRequested === true }),
+  correct_memory: a => ({ action: 'correct_memory', project: a.project, memoryId: a.memoryId, memoryText: a.memoryText, userRequested: a.userRequested === true }),
+  forget_memory: a => ({ action: 'forget_memory', project: a.project, memoryId: a.memoryId, userRequested: a.userRequested === true }),
+  pause: () => ({ action: 'pause' }),
+  resume: () => ({ action: 'resume' }),
+  daily: a => ({ action: 'configure_daily', time: a.time, ...(a.timeZone ? { timeZone: a.timeZone } : {}), ...(a.project ? { project: a.project } : {}) }),
+  cancel_daily: () => ({ action: 'cancel_daily' }),
+  followup: a => ({ action: 'configure_followup', everyMinutes: a.everyMinutes, ...(a.project ? { project: a.project } : {}) }),
+  cancel_followup: a => ({ action: 'cancel_followup', ...(a.project ? { project: a.project } : {}) }),
+};
+
+/** Pure translation. Unknown view/op or a missing discriminator throws, so a
+ *  malformed call fails loudly instead of silently doing something else. */
+export function normalizeSurfaceAction(args) {
+  if (!args || typeof args !== 'object') return args;
+  if (args.action === 'look') {
+    const view = args.view;
+    if (!Object.hasOwn(LOOK, view)) throw Error(`look 需要 view，可选：${LOOK_VIEWS.join('、')}`);
+    return LOOK[view](args);
+  }
+  if (args.action === 'manage') {
+    const op = args.op;
+    if (!Object.hasOwn(MANAGE, op)) throw Error(`manage 需要 op，可选：${MANAGE_OPS.join('、')}`);
+    return MANAGE[op](args);
+  }
+  return args;
+}
+
+/** What each composite view/op means, for the tool description and reports. */
+export const SURFACE_COPY = {
+  look: 'progress=进展与卡点｜change=相比上次的变化（需本人明确问了才传 userRequested:true）｜status=助理总状态｜task=交办到哪了｜once=一次检查的状态｜followup=周期跟进的状态',
+  manage: 'watch=关注项目｜unwatch=取消关注｜memory=读项目记忆｜remember=记一条｜correct_memory=改一条｜forget_memory=忘一条｜pause=暂停自动跟进｜resume=恢复｜daily=每日汇报时间｜cancel_daily=取消日报｜followup=设置周期跟进（要分钟数）｜cancel_followup=取消周期跟进',
+};

package/src/guidance.js

@@ -7,7 +7,7 @@ const RULES = [
   '能读能做的直接做，不先给用户递菜单；只有真实缺项（名称、时间、来源范围、明确授权）才问一个必要问题。',
   '回复用简洁Markdown，一句话先给结果；必要时短标题、少量加粗、短列表，段间留空行。不用宽表格、emoji或整段加粗，不把工具原文、内部ID、绝对路径、ISO时间、英文状态码堆给用户。',
 
-  '【项目】找项目或关注用 project_companion 的 list|watch|unwatch，名称唯一就直接处理。进展与卡点用 digest，要细读传 detail:analysis，短摘要不等于全部资料。只有本人明确问“相比上次有什么变化”才用 project_update；本人明确给出公开 GitHub 仓库时才用 link_github。',
+  '【项目】优先用两个入口：action=look（view=progress|change|status|task|once|followup）和 action=manage（op=watch|unwatch|memory|remember|correct_memory|forget_memory|pause|resume|daily|cancel_daily|followup|cancel_followup），旧的细分动作名仍可用。名称唯一就直接处理（按名字检索仍可用 list）。进展用 progress；只有本人明确问“相比上次有什么变化”才用 change 并传 userRequested:true；本人给出公开 GitHub 仓库时才用 link_github。',
   '【记忆】读用 memory，记用 remember；sourceKind 分清 user/assistant/file，只有本人明确表达才用 user 并传 userRequested:true，模型推断标 assistant。本人说“记住这点”就保存，并用一句话回执说清存了什么。',
   '【纠错】本人明确纠正或要求忘记时，先用 memory 在同一项目准确选定已有记录，内部填 memoryId，再用 correct_memory 或 forget_memory 并传 userRequested:true；不要求用户提供 ID，内容有歧义才用简短描述澄清，不跨项目猜测或批量删除。保留原始来源并标明本轮用户纠正，不把文件或助手记录改称用户原话；回执只说纠正或移除的具体记忆，不声称已验证或业务验收。',
   '【资料简报】结合个人资料排下一步用 context_brief（给 objective 和逐来源 queries，最多5源、每源最多3条）；查状态用 context_status；把简报第几项交给项目用 context_handoff（当次 revision+itemId）。事项按普通编号说，不展示内部ID。',

package/test/action-surface.test.mjs

@@ -0,0 +1,69 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import {readFile} from 'node:fs/promises';
+import {normalizeSurfaceAction,LOOK_VIEWS,MANAGE_OPS,SURFACE_COPY} from '../src/action-surface.js';
+
+const source=await readFile(new URL('../index.js',import.meta.url),'utf8');
+function enumOf(tool){
+  const at=source.indexOf(`name:'${tool}',\n    description:'`);
+  assert.ok(at>0,tool);
+  const match=/action:\{type:'string',required:true,enum:\[([^\]]*)\]/.exec(source.slice(at,at+8000));
+  assert.ok(match,`${tool} action enum`);
+  return match[1].split(',').map(value=>value.trim().replace(/^'|'$/g,'')).filter(Boolean);
+}
+const TOOLS=enumOf('project_companion');
+
+// The composite entries must only ever translate into actions that the tool
+// actually declares; a typo here would ship a call that the schema rejects.
+test('every composite view and op translates into a declared legacy action',()=>{
+  for(const view of LOOK_VIEWS){
+    const target=normalizeSurfaceAction({action:'look',view,project:'/synthetic/p'});
+    assert.ok(TOOLS.includes(target.action),`look.${view} -> ${target.action} must be declared`);
+  }
+  for(const op of MANAGE_OPS){
+    const target=normalizeSurfaceAction({action:'manage',op,project:'/synthetic/p',time:'09:00',everyMinutes:60,memoryKind:'goal',memoryText:'x',sourceKind:'assistant'});
+    assert.ok(TOOLS.includes(target.action),`manage.${op} -> ${target.action} must be declared`);
+  }
+  assert.ok(TOOLS.includes('look')&&TOOLS.includes('manage'),'both entries stay declared');
+});
+
+test('look views keep the parameters the legacy handlers already rely on',()=>{
+  assert.deepEqual(normalizeSurfaceAction({action:'look',view:'progress',project:'p',detail:'analysis'}),
+    {action:'digest',project:'p',detail:'analysis'});
+  assert.equal(normalizeSurfaceAction({action:'look',view:'progress',project:'p'}).detail,undefined);
+  assert.deepEqual(normalizeSurfaceAction({action:'look',view:'task',id:'job-1'}),{action:'task_status',id:'job-1'});
+  assert.deepEqual(normalizeSurfaceAction({action:'look',view:'status'}),{action:'status'});
+});
+
+// project_update is gated on the user asking; the composite must not widen it.
+test('look.change never invents the user request flag',()=>{
+  assert.equal(normalizeSurfaceAction({action:'look',view:'change',project:'p'}).userRequested,false);
+  assert.equal(normalizeSurfaceAction({action:'look',view:'change',project:'p',userRequested:true}).userRequested,true);
+});
+
+test('manage ops keep authorization flags exactly as the caller passed them',()=>{
+  const remember=normalizeSurfaceAction({action:'manage',op:'remember',project:'p',memoryKind:'decision',memoryText:'t',sourceKind:'user'});
+  assert.deepEqual(remember,{action:'remember',project:'p',memoryKind:'decision',memoryText:'t',sourceKind:'user',userRequested:false});
+  const correct=normalizeSurfaceAction({action:'manage',op:'correct_memory',project:'p',memoryId:'m',memoryText:'t',userRequested:true});
+  assert.equal(correct.action,'correct_memory');
+  assert.equal(correct.userRequested,true);
+  const daily=normalizeSurfaceAction({action:'manage',op:'daily',time:'09:10',timeZone:'America/Mexico_City'});
+  assert.deepEqual(daily,{action:'configure_daily',time:'09:10',timeZone:'America/Mexico_City'});
+});
+
+test('a malformed composite fails loudly instead of guessing',()=>{
+  assert.throws(()=>normalizeSurfaceAction({action:'look'}),/look 需要 view/);
+  assert.throws(()=>normalizeSurfaceAction({action:'look',view:'nope'}),/look 需要 view/);
+  assert.throws(()=>normalizeSurfaceAction({action:'manage',op:'nope'}),/manage 需要 op/);
+  assert.equal(normalizeSurfaceAction({action:'digest',project:'p'}).action,'digest','legacy names pass through untouched');
+});
+
+test('the tool description teaches both entries and every discriminator',()=>{
+  const at=source.indexOf("name:'project_companion',\n    description:'");
+  const description=/description:'([^']*)'/.exec(source.slice(at,at+4000))[1];
+  assert.match(description,/look/);
+  assert.match(description,/manage/);
+  for(const view of LOOK_VIEWS)assert.ok(description.includes(view),`description must name view ${view}`);
+  for(const op of MANAGE_OPS)assert.ok(description.includes(op),`description must name op ${op}`);
+  assert.equal(Object.keys(SURFACE_COPY).sort().join(','),'look,manage');
+});

package/test/guidance.test.mjs

@@ -11,7 +11,8 @@ function guidance(){
 
 test('memory guidance offers natural correction and forgetting with exact internal selection and an honest receipt',()=>{
   const prompt=guidance();
-  const memory=prompt.split('\n').find(line=>line.includes('correct_memory'));
+  const memory=prompt.split('\n').find(line=>line.includes('memoryId'));
+  assert.ok(memory&&memory.includes('correct_memory'),'the memory-editing policy line must name the tools');
   assert.ok(memory,'natural-language memory editing must be discoverable');
   for(const term of ['forget_memory','userRequested:true','memory','memoryId'])assert.ok(memory.includes(term),term);
   assert.match(memory,/同一项目|当前项目/);assert.match(memory,/准确|精确/);assert.match(memory,/歧义/);

package/test/routing-corpus.mjs

@@ -0,0 +1,44 @@
+/** Natural phrasings a user actually types, and the entry each should land on.
+ *  Kept as data so both the test and scripts/routing-report.mjs read one list. */
+export const CORPUS = [
+  ['这个项目最近推进到哪了', 'look', 'progress'],
+  ['看看有什么卡住的', 'look', 'progress'],
+  ['把资料再读细一点说', 'look', 'progress'],
+  ['跟上次比有什么变化', 'look', 'change'],
+  ['这两天有什么新动静', 'look', 'change'],
+  ['助理现在什么状态', 'look', 'status'],
+  ['上次那个任务成了吗', 'look', 'task'],
+  ['交办的事有结果了吗', 'look', 'task'],
+  ['那次检查跑完了吗', 'look', 'once'],
+  ['周期跟进的还开着吗', 'look', 'followup'],
+  ['把 DSH 关注一下', 'manage', 'watch'],
+  ['别再盯这个项目了', 'manage', 'unwatch'],
+  ['之前记过什么', 'manage', 'memory'],
+  ['记住这个决定', 'manage', 'remember'],
+  ['这条记错了，改一下', 'manage', 'correct_memory'],
+  ['这条别再记着了', 'manage', 'forget_memory'],
+  ['先别自动跑了', 'manage', 'pause'],
+  ['恢复自动跟进吧', 'manage', 'resume'],
+  ['以后每天早上九点汇报', 'manage', 'daily'],
+  ['日报先停掉', 'manage', 'cancel_daily'],
+  ['每小时看一次这个项目', 'manage', 'followup'],
+  ['这个跟进取消掉', 'manage', 'cancel_followup'],
+  ['帮我梳理一下这周的进展', 'look', 'progress'],
+  ['现在有哪些风险', 'look', 'progress'],
+  ['上周到现在变了什么', 'look', 'change'],
+  ['上次看到哪儿了', 'look', 'change'],
+  ['你还记得我上次说的目标吗', 'manage', 'memory'],
+  ['这个约束记一下', 'manage', 'remember'],
+  ['把那条阻塞删掉', 'manage', 'forget_memory'],
+  ['我记得你记错了', 'manage', 'correct_memory'],
+  ['这个项目不用再跟了', 'manage', 'unwatch'],
+  ['把工作区加进来', 'manage', 'watch'],
+  ['每天九点半发一次', 'manage', 'daily'],
+  ['每天早上那封先别发了', 'manage', 'cancel_daily'],
+  ['二十分钟看一次就行', 'manage', 'followup'],
+  ['别再看这个项目了', 'manage', 'unwatch'],
+  ['交办那个跑完了没', 'look', 'task'],
+  ['检查有结果了吗', 'look', 'once'],
+  ['跟进还在跑吗', 'look', 'followup'],
+  ['现在整体状态怎么样', 'look', 'status'],
+];

package/test/routing-surface.test.mjs

@@ -0,0 +1,17 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import {LOOK_VIEWS,MANAGE_OPS,normalizeSurfaceAction} from '../src/action-surface.js';
+import {CORPUS} from './routing-corpus.mjs';
+
+test('every natural phrasing in the corpus resolves to a real composite entry',()=>{
+  assert.ok(CORPUS.length>=40,'corpus must stay at least 40 phrasings');
+  const seen=new Set();
+  for(const [utterance,entry,key] of CORPUS){
+    const args=entry==='look'?{action:'look',view:key,project:'p'}:{action:'manage',op:key,project:'p',time:'09:00',everyMinutes:60,memoryKind:'goal',memoryText:'x',sourceKind:'assistant'};
+    const target=normalizeSurfaceAction(args);
+    assert.ok(target.action&&target.action!==entry,`${utterance} must translate`);
+    seen.add(`${entry}.${key}`);
+  }
+  for(const view of LOOK_VIEWS)assert.ok(seen.has(`look.${view}`),`corpus misses look.${view}`);
+  for(const op of MANAGE_OPS)assert.ok(seen.has(`manage.${op}`),`corpus misses manage.${op}`);
+});