agentworkshop 0.8.3 → 0.8.5

package/scripts/test-memory-month-query.mjs

@@ -1,70 +0,0 @@
-/**
- * 回归测试 —— 记忆反思查询下推(P1-3)
- * 断言:listByAgentKindMonth / countByAgentKindMonth 与「全量拉取 + JS filter」结果完全一致,
- * 且跨月/跨年边界正确。
- * 运行: npx tsx scripts/test-memory-month-query.mjs
- */
-import { DatabaseSync } from 'node:sqlite'
-import { readFileSync } from 'node:fs'
-import { createMemoryRepo } from '../server/services/workshop/db/memory.repo.ts'
-
-let pass = 0, fail = 0
-const check = (n, ok, d = '') => {
-  if (ok) {
-    pass++
-    console.log('  PASS  ' + n)
-    return
-  }
-  fail++
-  console.log('  FAIL  ' + n + (d ? '  — ' + d : ''))
-}
-
-// 用真实 schema 建库:保证测试与生产表结构(索引/触发器/唯一约束)完全一致
-const db = new DatabaseSync(':memory:')
-const schemaSql = readFileSync(new URL('../server/services/workshop/db/schema.sql', import.meta.url), 'utf8')
-db.exec(schemaSql)
-
-const repo = createMemoryRepo(db)
-const AGENT = 'a1'
-// 直接写主表以便精确控制 created_at(upsert 不接受时间覆盖)
-// 先建 channel(FK 约束),再插记忆行
-db.prepare(`INSERT INTO channels (id, name, created_at, updated_at) VALUES ('c1','t',?,?)`)
-  .run(new Date().toISOString(), new Date().toISOString())
-const ins = db.prepare(
-  `INSERT INTO agent_memories (id, channel_id, agent_id, kind, title, title_fts, content, importance, dedup_key, access_count, created_at)
-   VALUES (?, 'c1', ?, ?, ?, ?, ?, 1, ?, 0, ?)`,
-)
-for (const [id, kind, at] of [
-  ['m1', 'episodic-task', '2026-09-01T00:00:00.000Z'],
-  ['m2', 'episodic-task', '2026-09-15T12:00:00.000Z'],
-  ['m3', 'episodic-task', '2026-09-30T23:59:59.000Z'],
-  ['m4', 'episodic-task', '2026-10-01T00:00:00.000Z'], // 下月首刻,必须排除
-  ['m5', 'episodic-session', '2026-09-10T00:00:00.000Z'], // 不同 kind,必须排除
-  ['m6', 'episodic-task', '2025-12-31T23:00:00.000Z'], // 去年 12 月
-  ['m7', 'episodic-task', '2026-01-01T00:00:00.000Z'],
-]) {
-  ins.run(id, AGENT, kind, id, id, id, id, at)
-}
-// 另一 agent 的行不得串入
-ins.run('other1', 'a2', 'episodic-task', 'o', 'o', 'o', 'o', '2026-09-05T00:00:00.000Z')
-
-console.log('\n━━━ 1. 与全量 JS filter 语义一致 ━━━')
-const all = repo.listByAgentWithRowid(AGENT, 1_000_000)
-for (const month of ['2026-09', '2026-10', '2025-12', '2026-01', '2027-01']) {
-  const expect = all.filter(r => r.kind === 'episodic-task' && r.createdAt.slice(0, 7) === month).map(r => r.id).sort()
-  const got = repo.listByAgentKindMonth(AGENT, 'episodic-task', month).map(r => r.id).sort()
-  check(`${month}: 行集一致 [${expect.join(',')}]`, JSON.stringify(expect) === JSON.stringify(got), `got [${got.join(',')}]`)
-  check(`${month}: 计数一致 (${expect.length})`, repo.countByAgentKindMonth(AGENT, 'episodic-task', month) === expect.length)
-}
-
-console.log('\n━━━ 2. 边界正确性 ━━━')
-const sep = repo.listByAgentKindMonth(AGENT, 'episodic-task', '2026-09').map(r => r.id)
-check('9 月含首日 m1', sep.includes('m1'))
-check('9 月含末日 23:59:59 的 m3', sep.includes('m3'))
-check('9 月不含 10-01T00:00:00 的 m4', !sep.includes('m4'))
-check('9 月不含 session 类 m5', !sep.includes('m5'))
-check('9 月共 3 条', sep.length === 3, 'len=' + sep.length)
-check('12 月跨年查询正确', repo.listByAgentKindMonth(AGENT, 'episodic-task', '2025-12').map(r => r.id).join(',') === 'm6')
-
-console.log(`\n━━━ 结果:${pass} passed, ${fail} failed ━━━\n`)
-process.exit(fail === 0 ? 0 : 1)

package/scripts/test-memory.ts

@@ -1,431 +0,0 @@
-/**
- * AgentMemory P0 测试:repo(FTS/去重/touch/delete/team 预埋)→ 模块(排序/预算/格式)→ 运行时集成。
- * 运行: npx tsx scripts/test-memory.ts
- */
-import type { DatabaseSync } from 'node:sqlite'
-import { openWorkshopDb } from '../server/services/workshop/db/database'
-import { createMemoryRepo, TEAM_AGENT_ID } from '../server/services/workshop/db/memory.repo'
-import { AgentMemory, buildMatchQuery, estimateTokens, segmentCJK } from '../server/services/workshop/runtime/memory'
-import { randomUUID } from 'node:crypto'
-import { createMessageRepo } from '../server/services/workshop/db/message.repo'
-import { Mailbox } from '../server/services/workshop/runtime/mailbox'
-import { createChannelRepo } from '../server/services/workshop/db/channel.repo'
-import { createAgentRepo } from '../server/services/workshop/db/agent.repo'
-import { createTeamRepo } from '../server/services/workshop/db/team.repo'
-import { createTeamMemberRepo } from '../server/services/workshop/db/team-member.repo'
-import { createChannelAgentRepo } from '../server/services/workshop/db/channel-agent.repo'
-import { createTaskRepo } from '../server/services/workshop/db/task.repo'
-import { createSubscriptionRepo } from '../server/services/workshop/db/subscription.repo'
-import { createAgentChannelManager } from '../server/services/workshop/runtime/manager'
-import type { AppError } from '../server/utils/errors'
-import { AgentRuntime } from '../server/services/workshop/runtime/agent-runtime'
-import type { ChannelBus, TaskEngine } from '../server/services/workshop/runtime/agent-runtime'
-import type {
-  AgentEvent,
-  AgentInterface,
-  AgentInfo,
-  AgentRunContext,
-  AgentRunRequest,
-  SupervisionDecision,
-  SupervisionSnapshot,
-  AgentWorkspace,
-} from '../server/services/workshop/agents/agent-interface'
-import type { WorkspaceTask, TaskState, AgentTaskQueueView } from '../server/services/workshop/types/task'
-import type { Part } from '../server/services/workshop/types/a2a'
-
-let failures = 0
-function check(name: string, ok: boolean, detail = ''): void {
-  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
-  if (!ok) failures += 1
-}
-
-const db: DatabaseSync = openWorkshopDb(':memory:')
-const repo = createMemoryRepo(db)
-const seg = (s: string): string => s.replace(/([\u4e00-\u9fff])/g, ' $1 ')
-
-// ---- repo:写入 + CJK FTS 检索(title 经 titleFts 切分入索引;content 切分传入)----
-repo.upsert({ channelId: 'ch1', agentId: 'a1', kind: 'episodic-task', title: '实现登录页面', titleFts: seg('实现登录页面'), content: seg('用OAuth2方案完成了登录鉴权'), importance: 0.8, taskId: 't1', dedupKey: 'task:t1' })
-repo.upsert({ channelId: 'ch1', agentId: 'a1', kind: 'episodic-task', title: '数据库调研', titleFts: seg('数据库调研'), content: seg('最终选择SQLite因为轻量嵌入式'), importance: 0.8, taskId: 't2', dedupKey: 'task:t2' })
-repo.upsert({ channelId: 'ch1', agentId: 'a2', kind: 'episodic-task', title: '他人记忆', titleFts: seg('他人记忆'), content: seg('别的agent的登录杂事'), importance: 0.8, taskId: 't3', dedupKey: 'task:t3' })
-
-const hit = repo.search('a1', `${seg('登录').trim()} OR oauth`, 5)
-check('FTS 中英混合检索命中(经 titleFts)', hit.length >= 1 && hit[0].title === '实现登录页面', `hits=${hit.length}`)
-check('展示 title 保持原文(未切分)', hit[0]?.title === '实现登录页面')
-check('FTS 不串他人私有记忆', hit.every(r => r.agentId === 'a1'))
-
-// ---- repo:team 域预埋(search 恒含 team 行)----
-repo.upsert({ channelId: 'ch1', agentId: TEAM_AGENT_ID, kind: 'semantic', title: 'channel 代码风格', titleFts: seg('channel 代码风格'), content: seg('全部使用TypeScript strict模式'), importance: 0.9, taskId: null, dedupKey: 'style:ts' })
-const teamQuery = seg('代码风格').trim().split(/\s+/).join(' OR ') // → '代 OR 码 OR 风 OR 格'
-const teamHit = repo.search('a1', teamQuery, 5)
-check('team 记忆对所有 agent 可见(经 titleFts 命中)', teamHit.some(r => r.agentId === TEAM_AGENT_ID))
-check('listRecent 严格本人(不含 team)', !repo.listRecent('a1', 10).some(r => r.agentId === TEAM_AGENT_ID))
-
-// ---- repo:去重 upsert ----
-repo.upsert({ channelId: 'ch1', agentId: 'a1', kind: 'episodic-task', title: '实现登录页面', titleFts: seg('实现登录页面'), content: seg('重跑后改用JWT方案'), importance: 0.8, taskId: 't1', dedupKey: 'task:t1' })
-check('同 dedupKey 去重', repo.listByAgent('a1', 10).length === 2)
-check('upsert 刷新后 FTS 同步', repo.search('a1', 'jwt', 5).length === 1)
-const dedup = repo.findByAgentDedup('ch1', 'a1', 'task:t1')
-check('findByAgentDedup 返回 id+rowid', dedup !== null && typeof dedup.rowid === 'number')
-
-// ---- repo:touch + delete ----
-repo.touch(dedup!.id)
-check('touch 递增 access_count', repo.listByAgent('a1', 10).find(r => r.id === dedup!.id)!.accessCount >= 1)
-const teamDel = repo.findByAgentDedup('ch1', TEAM_AGENT_ID, 'style:ts')!
-check('team 行去重键独立', teamDel !== null)
-check('delete 返回 true 且 FTS 同步清理', repo.delete(dedup!.id) === true && repo.search('a1', 'jwt', 5).length === 0)
-check('listMemoryAgentIds 排除 team', repo.listMemoryAgentIds().includes(TEAM_AGENT_ID) === false)
-
-// ═══════════ 模块:AgentMemory ═══════════
-console.log('\n--- AgentMemory 模块 ---')
-
-check('segmentCJK 汉字间加空格', segmentCJK('登录oauth') === ' 登 录 oauth')
-check('buildMatchQuery OR 连接 + 剔除操作符/保留词(引号包裹)', buildMatchQuery('登录 (页面) AND not') === '"登" OR "录" OR "页" OR "面"')
-check('buildMatchQuery 空查询 null', buildMatchQuery('   ') === null)
-check('buildMatchQuery ASCII 单字词过滤', buildMatchQuery('a b oauth') === '"oauth"')
-check('estimateTokens 中英混合', estimateTokens('登录ab') === 3)
-check('buildMatchQuery 剥除路径标点', buildMatchQuery('读取 D:/codes/x/.tmp-a/input.txt 内容') !== null && !buildMatchQuery('读取 D:/codes/x/.tmp-a/input.txt 内容')!.includes('.'))
-check('buildMatchQuery 词项全部引号包裹', (() => {
-  const q = buildMatchQuery('登录 oauth 页面')
-  return q === null || q.split(' OR ').every(t => t.startsWith('"') && t.endsWith('"'))
-})())
-// 前段 delete 了 task:t1 行,重新播种供模块段使用(fresh insert,access_count=0)
-repo.upsert({ channelId: 'ch1', agentId: 'a1', kind: 'episodic-task', title: '实现登录页面', titleFts: seg('实现登录页面'), content: seg('用OAuth2方案完成了登录鉴权'), importance: 0.8, taskId: 't1', dedupKey: 'task:t1' })
-
-const memA = new AgentMemory(repo, { channelId: 'ch1', agentId: 'a1' })
-await memA.recall('数据库', { touch: false })
-check('touch:false 不改 access_count', repo.listByAgent('a1', 10).find(r => r.title === '数据库调研')!.accessCount === 0)
-
-// 查询同时含本人记忆与 team 记忆的词(两者都经 FTS 命中;listRecent 兜底不含 team)
-const block = await memA.recall('登录页面 代码风格')
-check('recall 含本人相关记忆', block !== null && block.includes('实现登录页面'))
-check('recall 含 team 共享记忆', block !== null && block.includes('channel 代码风格'), block?.slice(0, 100))
-check('recall 不含他人私有记忆', block !== null && !block.includes('他人记忆'))
-const t1row = repo.listByAgent('a1', 10).find(r => r.title === '实现登录页面')
-check('recall 默认 touch', t1row !== undefined && t1row.accessCount >= 1)
-
-const memTiny = new AgentMemory(repo, { channelId: 'ch1', agentId: 'a1', budgetTokens: 5 })
-const tiny = await memTiny.recall('登录 数据库')
-check('极小预算整行取舍', tiny === null || tiny.split('\n').length <= 3)
-
-const memEmpty = new AgentMemory(repo, { channelId: 'ch1', agentId: 'nobody' })
-check('无记忆 recall 返回 null', (await memEmpty.recall('任意')) === null)
-
-const pathResult = await new AgentMemory(repo, { channelId: 'ch1', agentId: 'a1' })
-  .recall('配置在 D:/codes/.tmp-x/config.json 怎么改')
-  .then(v => v ?? null, () => '__THROWN__')
-check('路径文本 recall 不炸', pathResult !== '__THROWN__')
-
-// ═══════════ 运行时集成:召回注入 + 结束沉淀 ═══════════
-console.log('\n--- AgentRuntime 记忆集成 ---')
-
-/** 落库一个 channel(messages.channel_id 外键依赖;照抄 test-agent-runtime.ts) */
-function seedChannel(database: DatabaseSync, id: string): void {
-  const now = new Date().toISOString()
-  database.prepare(
-    `INSERT INTO channels (id, name, description, lead_agent_id, enabled, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?)`,
-  ).run(id, id, '', null, 1, now, now)
-}
-
-seedChannel(db, 'ch-mem')
-
-const memBus: ChannelBus = {
-  emit: () => {}, onEvent: () => () => {}, notifyTask: () => {}, onTaskEvent: () => () => {},
-  notifyAgent: () => {}, onAgentStatus: () => () => {}, wakeScheduler: () => {},
-}
-// fake engine(签名对齐 agent-runtime.ts 的 TaskEngine 契约;完成态经 transition 驱动)
-const memTasks = new Map<string, WorkspaceTask>()
-const fakeEngine: TaskEngine = {
-  create: (input: { channelId: string, creatorId: string, assigneeId: string, title: string }) => {
-    const t: WorkspaceTask = { id: randomUUID(), channelId: input.channelId, assigneeId: input.assigneeId, creatorId: input.creatorId, title: input.title, state: 'SUBMITTED', progress: 0, retryCount: 0, artifacts: [], history: [], createdAt: new Date().toISOString(), updatedAt: new Date().toISOString() }
-    memTasks.set(t.id, t)
-    return t
-  },
-  dispatch: () => { throw new Error('unused') },
-  transition: (taskId: string, state: TaskState, _by: string) => {
-    const t = memTasks.get(taskId)
-    if (t) t.state = state
-    return t!
-  },
-  // 对齐真实 TaskEngine.applyEvent:非 append artifact 落 task.artifacts(终态 harvest 数据源)
-  applyEvent: (taskId: string, event: AgentEvent) => {
-    const t = memTasks.get(taskId)
-    if (t && event.kind === 'artifact') t.artifacts = [...t.artifacts, event.artifact]
-  },
-  list: () => [...memTasks.values()],
-  get: (id: string) => memTasks.get(id),
-  complete: () => { throw new Error('unused') },
-  reassign: () => { throw new Error('unused') },
-  updateTask: () => { throw new Error('unused') },
-  cancel: () => { throw new Error('unused') },
-  onChildCompleted: () => {},
-  redeliverAssign: () => { throw new Error('unused') },
-  queueViewOf: (channelId: string, agentId: string): AgentTaskQueueView => ({ agentId, channelId, queued: [], completed: [] }),
-}
-// workspace stub:EchoImpl 的 completeTask 经 transition 落 COMPLETED(终态判定依赖)
-const wsStub = (agentId: string): AgentWorkspace => ({
-  completeTask: async (taskId: string, artifacts) => {
-    const t = memTasks.get(taskId)
-    if (t) {
-      t.artifacts = [...t.artifacts, ...artifacts]
-      t.progress = 100
-      fakeEngine.transition(taskId, 'COMPLETED', agentId)
-    }
-    return t!
-  },
-}) as AgentWorkspace
-void wsStub
-
-class MemoryEchoImpl implements AgentInterface {
-  readonly captured: AgentRunRequest[] = []
-  async* run(request: AgentRunRequest, ctx: AgentRunContext): AsyncGenerator<AgentEvent, void, unknown> {
-    this.captured.push(request)
-    const taskId = request.taskId ?? (request.message.metadata?.['x-aw-task-id'] as string | undefined)
-    if (taskId && ctx.role === 'worker') {
-      yield { kind: 'status', status: { state: 'WORKING', timestamp: new Date().toISOString() } }
-      await (ctx.workspace as { completeTask: (id: string, arts: unknown[]) => Promise<unknown> }).completeTask(taskId, [])
-      yield { kind: 'artifact', artifact: { artifactId: randomUUID(), name: 'deliverable', parts: [{ text: `memory-seen:${request.memory ?? 'NONE'}` }] }, lastChunk: true, totalChunks: 1 }
-      yield { kind: 'done', final: { taskId } }
-    }
-  }
-}
-
-const mkRt = (id: string): { rt: AgentRuntime, echo: MemoryEchoImpl } => {
-  const info: AgentInfo = { id, channelId: 'ch-mem', name: id, harness: 'mock', role: 'worker', config: {} }
-  const echo = new MemoryEchoImpl()
-  const rt = new AgentRuntime(info, echo, {
-    mailbox: new Mailbox(createMessageRepo(db), 'ch-mem', id, () => {}),
-    taskEngine: fakeEngine,
-    bus: memBus,
-    workspace: wsStub(id),
-    memory: new AgentMemory(repo, { channelId: 'ch-mem', agentId: id }),
-  })
-  rt.start()
-  return { rt, echo }
-}
-const mkAssign = (task: WorkspaceTask): Part[] => [{ text: task.title }]
-const enqueueAssign = (rt: AgentRuntime, task: WorkspaceTask): void => {
-  rt.enqueue({ messageId: randomUUID(), contextId: 'ch-mem', role: 'ROLE_AGENT', taskId: task.id, parts: mkAssign(task), metadata: { 'x-aw-from-agent': 'lead', 'x-aw-task-kind': 'assign', 'x-aw-task-id': task.id } })
-}
-
-const { rt: rtA, echo: echoA } = mkRt('w-mem')
-const taskA = fakeEngine.create({ channelId: 'ch-mem', creatorId: 'lead', assigneeId: 'w-mem', title: '实现登录页面' })
-enqueueAssign(rtA, taskA)
-await new Promise<void>(r => setTimeout(r, 300))
-check('任务 A 首跑无记忆注入', echoA.captured.at(-1)?.memory === undefined)
-const aRow = repo.listByAgent('w-mem', 10).find(r => r.taskId === taskA.id)
-check('任务 A 完成后沉淀记忆(含 deliverable)', aRow !== undefined && aRow.content.includes('memory-seen:NONE'), aRow?.content.slice(0, 60))
-check('任务 A 记忆 importance=0.8(COMPLETED)', aRow?.importance === 0.8)
-
-const taskB = fakeEngine.create({ channelId: 'ch-mem', creatorId: 'lead', assigneeId: 'w-mem', title: '登录模块优化' })
-enqueueAssign(rtA, taskB)
-await new Promise<void>(r => setTimeout(r, 300))
-const secondReq = echoA.captured.at(-1)
-check('任务 B 召回注入 A 的记忆(经 title_fts 相关命中)', secondReq?.memory !== undefined && secondReq.memory.includes('实现登录页面'), secondReq?.memory?.slice(0, 80))
-check('记忆块带 prompt 标题头', (secondReq?.memory ?? '').startsWith('## 相关记忆'))
-
-const { rt: rtO, echo: echoO } = mkRt('w-other')
-const taskC = fakeEngine.create({ channelId: 'ch-mem', creatorId: 'lead', assigneeId: 'w-other', title: '登录鉴权怎么做' })
-enqueueAssign(rtO, taskC)
-await new Promise<void>(r => setTimeout(r, 300))
-check('跨 agent 记忆隔离(w-other 召回不到 w-mem)', echoO.captured.at(-1)?.memory === undefined)
-
-await rtA.stop()
-await rtO.stop()
-
-// ═══════════ 团队共享记忆域(manager 策展 + recall 通道隔离)═══════════
-console.log('\n--- Team 共享记忆域 ---')
-
-// 最小 manager 装配(照 test-dual-drive.ts;:memory: db;impl 仅占位)
-const stubImpl = (_agent: AgentInfo): AgentInterface => {
-  throw new Error('impl unused')
-}
-/** 捕获 AppError code(未抛返回空串) */
-function captureCode(fn: () => unknown): string {
-  try {
-    fn()
-  }
-  catch (e) {
-    return (e as AppError).code
-  }
-  return ''
-}
-const tmRepos = {
-  channels: createChannelRepo(db),
-  agents: createAgentRepo(db),
-  teams: createTeamRepo(db),
-  teamMembers: createTeamMemberRepo(db),
-  channelAgents: createChannelAgentRepo(db),
-  messages: createMessageRepo(db),
-  subscriptions: createSubscriptionRepo(db),
-  tasks: createTaskRepo(db),
-  memories: repo,
-}
-const teamManager = createAgentChannelManager({ repos: tmRepos, implFactory: stubImpl, db })
-const chTeam = tmRepos.channels.create({ name: 'ch-team' })
-const leadInst = tmRepos.channelAgents.create({ channelId: chTeam.id, templateId: null, name: 'lead', harness: 'mock', role: 'lead' })
-const workerInst = tmRepos.channelAgents.create({ channelId: chTeam.id, templateId: null, name: 'worker', harness: 'mock', role: 'worker' })
-
-const teamList = teamManager.addTeamMemory(chTeam.id, leadInst.id, { title: '部署规范', content: '全部使用pnpm并开启strict', dedupKey: 'deploy:pnpm' })
-check('lead 写团队记忆成功入列', teamList.length === 1 && teamList[0].agentId === TEAM_AGENT_ID && teamList[0].channelId === chTeam.id)
-const teamErrWrite = captureCode(() => teamManager.addTeamMemory(chTeam.id, workerInst.id, { title: 'x', content: 'y' }))
-check('worker 写团队记忆抛 SCOPE_VIOLATION', teamErrWrite === 'SCOPE_VIOLATION', `code=${teamErrWrite}`)
-
-teamManager.addTeamMemory(chTeam.id, leadInst.id, { title: '部署规范', content: '改用bun并保留strict', dedupKey: 'deploy:pnpm' })
-const refreshed = teamManager.listTeamMemories(chTeam.id)
-check('同 dedupKey 二次写幂等刷新(仍 1 条)', refreshed.length === 1 && refreshed[0].content.includes('bun') && !refreshed[0].content.includes('pnpm'))
-
-const workerBlock = await new AgentMemory(repo, { channelId: chTeam.id, agentId: workerInst.id }).recall('部署规范')
-check('worker recall 可见团队行', workerBlock !== null && workerBlock.includes('部署规范'))
-
-const teamErrDelWorker = captureCode(() => teamManager.deleteTeamMemory(chTeam.id, workerInst.id, refreshed[0].id))
-check('worker 删团队记忆抛 SCOPE_VIOLATION', teamErrDelWorker === 'SCOPE_VIOLATION', `code=${teamErrDelWorker}`)
-
-teamManager.deleteTeamMemory(chTeam.id, leadInst.id, refreshed[0].id)
-check('lead 删团队记忆成功', teamManager.listTeamMemories(chTeam.id).length === 0)
-const teamErrDelMiss = captureCode(() => teamManager.deleteTeamMemory(chTeam.id, leadInst.id, 'no-such-id'))
-check('删不存在团队记忆抛 NOT_FOUND', teamErrDelMiss === 'NOT_FOUND', `code=${teamErrDelMiss}`)
-
-// ---- recall 通道隔离:team 行(FTS 来源)按本 channel 过滤 ----
-repo.upsert({ channelId: 'ch-other', agentId: TEAM_AGENT_ID, kind: 'semantic', title: '他通道金丝雀', titleFts: seg('他通道金丝雀'), content: seg('跨通道独占水印金丝雀'), importance: 0.9, taskId: null, dedupKey: 'iso:other' })
-repo.upsert({ channelId: 'ch1', agentId: TEAM_AGENT_ID, kind: 'semantic', title: '本通道金丝雀', titleFts: seg('本通道金丝雀'), content: seg('本通道共享金丝雀约定'), importance: 0.9, taskId: null, dedupKey: 'iso:ch1' })
-const isoBlock = await new AgentMemory(repo, { channelId: 'ch1', agentId: 'a1' }).recall('金丝雀')
-check('recall 不泄漏他通道团队记忆', isoBlock === null || !isoBlock.includes('他通道金丝雀'), isoBlock?.slice(0, 80))
-check('recall 可见本通道团队记忆', isoBlock !== null && isoBlock.includes('本通道金丝雀'), isoBlock?.slice(0, 80))
-
-// ═══════════ Agent 私有记忆策展(本人或 lead 写/删)═══════════
-console.log('\n--- Agent 私有记忆策展 ---')
-
-const otherInst = tmRepos.channelAgents.create({ channelId: chTeam.id, templateId: null, name: 'other', harness: 'mock', role: 'worker' })
-
-teamManager.addAgentMemory(chTeam.id, workerInst.id, workerInst.id, { title: 'worker 私有笔记', content: '部署前必须跑全量测试', dedupKey: 'self:note' })
-const selfRow = repo.listByAgent(workerInst.id, 50).find(r => r.title === 'worker 私有笔记')
-check('本人写私有记忆成功入列', selfRow !== undefined && selfRow.agentId === workerInst.id && selfRow.channelId === chTeam.id && selfRow.kind === 'semantic' && selfRow.importance === 0.9)
-
-const selfBlock = await new AgentMemory(repo, { channelId: chTeam.id, agentId: workerInst.id }).recall('私有笔记')
-check('本人 recall 命中策展记忆', selfBlock !== null && selfBlock.includes('worker 私有笔记'), selfBlock?.slice(0, 80))
-
-const agentErrOther = captureCode(() => teamManager.addAgentMemory(chTeam.id, otherInst.id, workerInst.id, { title: 'x', content: 'y' }))
-check('非 lead 他人写抛 SCOPE_VIOLATION', agentErrOther === 'SCOPE_VIOLATION', `code=${agentErrOther}`)
-check('他人写被拒后未落库', !repo.listByAgent(workerInst.id, 50).some(r => r.title === 'x'))
-
-teamManager.addAgentMemory(chTeam.id, leadInst.id, workerInst.id, { title: 'lead 代写规范', content: '提交信息用中文', dedupKey: 'lead:note' })
-check('lead 代写 worker 记忆成功', repo.listByAgent(workerInst.id, 50).some(r => r.title === 'lead 代写规范' && r.agentId === workerInst.id))
-
-const agentErrDelOther = captureCode(() => teamManager.deleteAgentMemory(chTeam.id, otherInst.id, workerInst.id, selfRow!.id))
-check('非 lead 他人删抛 SCOPE_VIOLATION', agentErrDelOther === 'SCOPE_VIOLATION', `code=${agentErrDelOther}`)
-
-const agentErrDelMiss = captureCode(() => teamManager.deleteAgentMemory(chTeam.id, workerInst.id, workerInst.id, 'no-such-id'))
-check('删不存在记忆抛 NOT_FOUND', agentErrDelMiss === 'NOT_FOUND', `code=${agentErrDelMiss}`)
-
-teamManager.deleteAgentMemory(chTeam.id, workerInst.id, workerInst.id, selfRow!.id)
-check('本人删自己的记忆成功', !repo.listByAgent(workerInst.id, 50).some(r => r.id === selfRow!.id))
-
-const agentErrTargetMiss = captureCode(() => teamManager.addAgentMemory(chTeam.id, leadInst.id, 'no-such-agent', { title: 'x', content: 'y' }))
-check('目标实例不存在抛 NOT_FOUND', agentErrTargetMiss === 'NOT_FOUND', `code=${agentErrTargetMiss}`)
-
-// ═══════════ supervise 路径记忆注入(ctx.memory;快照驱动召回)═══════════
-console.log('\n--- supervise 记忆注入 ---')
-
-/** lead echo:捕获 supervise 收到的 ctx.memory */
-class MemoryEchoSuperviseImpl implements AgentInterface {
-  capturedMemory: string | undefined
-  async* run(): AsyncGenerator<AgentEvent, void, unknown> {}
-  async supervise(_snapshot: SupervisionSnapshot, ctx: AgentRunContext): Promise<SupervisionDecision[]> {
-    this.capturedMemory = ctx.memory
-    return []
-  }
-}
-
-/** lead runtime(supervise 由测试直调;withMemory=false 验证向后兼容) */
-const mkLeadRt = (id: string, withMemory: boolean): { rt: AgentRuntime, echo: MemoryEchoSuperviseImpl } => {
-  const echo = new MemoryEchoSuperviseImpl()
-  const rt = new AgentRuntime(
-    { id, channelId: 'ch-mem', name: id, harness: 'mock', role: 'lead', config: {} },
-    echo,
-    {
-      mailbox: new Mailbox(createMessageRepo(db), 'ch-mem', id, () => {}),
-      taskEngine: fakeEngine,
-      bus: memBus,
-      workspace: wsStub(id),
-      ...(withMemory ? { memory: new AgentMemory(repo, { channelId: 'ch-mem', agentId: id }) } : {}),
-    },
-  )
-  return { rt, echo }
-}
-
-// 预置 w-lead-sup 一条记忆(标题含"调度");快照含同标题 SUBMITTED 任务
-repo.upsert({ channelId: 'ch-mem', agentId: 'w-lead-sup', kind: 'episodic-task', title: '调度优化登录任务', titleFts: seg('调度优化登录任务'), content: seg('上次把登录类任务优先派给空闲worker'), importance: 0.8, taskId: 'sup-t1', dedupKey: 'task:sup-t1' })
-const supTask = fakeEngine.create({ channelId: 'ch-mem', creatorId: 'boss', assigneeId: 'w-mem', title: '调度优化登录任务' })
-const supSnapshot: SupervisionSnapshot = {
-  tick: 1,
-  now: Date.now(),
-  tasks: [fakeEngine.get(supTask.id)!],
-  members: [
-    { agentId: 'w-lead-sup', name: 'w-lead-sup', role: 'lead', state: 'idle' },
-    { agentId: 'w-mem', name: 'w-mem', role: 'worker', state: 'idle' },
-  ],
-  pendingChildren: {},
-}
-
-const supBefore = repo.listByAgent('w-lead-sup', 10).find(r => r.title === '调度优化登录任务')!
-const supLead = mkLeadRt('w-lead-sup', true)
-const supDecisions = await supLead.rt.supervise(supSnapshot)
-check('supervise 返回 echo 决策(空数组)', Array.isArray(supDecisions) && supDecisions.length === 0)
-check('supervise 注入记忆块(## 相关记忆 + 预置标题)', supLead.echo.capturedMemory !== undefined && supLead.echo.capturedMemory.includes('## 相关记忆') && supLead.echo.capturedMemory.includes('调度优化登录任务'), supLead.echo.capturedMemory?.slice(0, 80))
-const supAfter = repo.listByAgent('w-lead-sup', 10).find(r => r.title === '调度优化登录任务')!
-check('supervise 召回 touch:false 不增 access_count', supAfter.accessCount === supBefore.accessCount, `before=${supBefore.accessCount} after=${supAfter.accessCount}`)
-
-const plainLead = mkLeadRt('w-lead-plain', false)
-const plainDecisions = await plainLead.rt.supervise(supSnapshot)
-check('无 memory deps 的 runtime supervise 正常(不注入不抛错)', Array.isArray(plainDecisions) && plainLead.echo.capturedMemory === undefined)
-
-// ═══════════ 最终审查修复:env 守卫(I2)+ 策展向量化静默降级(M2)═══════════
-console.log('\n--- 最终审查修复(I2/M2)---')
-
-const restoreEnv = (name: string, value: string | undefined): void => {
-  if (value === undefined) Reflect.deleteProperty(process.env, name)
-  else process.env[name] = value
-}
-
-// I2:AW_MEMORY_BUDGET_TOKENS 非法/非正 → envNum 回退 800,recall 正常(不抛/不清空)
-const savedBudget = process.env.AW_MEMORY_BUDGET_TOKENS
-process.env.AW_MEMORY_BUDGET_TOKENS = 'garbage'
-const garbageBudget = await new AgentMemory(repo, { channelId: 'ch-mem', agentId: 'w-mem' }).recall('登录')
-check('AW_MEMORY_BUDGET_TOKENS 非法回退 800(recall 正常返回)', typeof garbageBudget === 'string' && garbageBudget.length > 0,
-  garbageBudget?.slice(0, 60))
-process.env.AW_MEMORY_BUDGET_TOKENS = '0'
-const zeroBudget = await new AgentMemory(repo, { channelId: 'ch-mem', agentId: 'w-mem' }).recall('登录')
-check('AW_MEMORY_BUDGET_TOKENS=0 拒绝并回退(recall 正常返回)', typeof zeroBudget === 'string' && zeroBudget.length > 0)
-restoreEnv('AW_MEMORY_BUDGET_TOKENS', savedBudget)
-
-// I2 + M2:MAINTENANCE_MS=0(非法定时器间隔)+ 不可达 env provider → 构造/策展/shutdown 全干净
-const savedMs = process.env.AW_MEMORY_MAINTENANCE_MS
-const savedUrl = process.env.AW_MEMORY_EMBED_BASE_URL
-const savedModel = process.env.AW_MEMORY_EMBED_MODEL
-process.env.AW_MEMORY_MAINTENANCE_MS = '0'
-process.env.AW_MEMORY_EMBED_BASE_URL = 'http://127.0.0.1:1' // 立即拒连,零等待
-process.env.AW_MEMORY_EMBED_MODEL = 'fix-wave'
-const fixManager = createAgentChannelManager({ repos: tmRepos, implFactory: stubImpl, db })
-const fixCh = tmRepos.channels.create({ name: 'ch-fix' })
-const fixLead = tmRepos.channelAgents.create({ channelId: fixCh.id, templateId: null, name: 'fixlead', harness: 'mock', role: 'lead' })
-let curatedCrash = ''
-try {
-  fixManager.addTeamMemory(fixCh.id, fixLead.id, { title: '修复波团队规范', content: '修复波内容统一水印', dedupKey: 'team:fix' })
-  fixManager.addAgentMemory(fixCh.id, fixLead.id, fixLead.id, { title: '修复波私有笔记', content: '修复波私有内容', dedupKey: 'self:fix' })
-}
-catch (e) {
-  curatedCrash = String(e)
-}
-check('dummy env 下策展写不崩(向量化 fire-and-forget 静默失败)',
-  curatedCrash === '' && repo.listByAgentChannel(fixCh.id, TEAM_AGENT_ID, 10).some(r => r.title === '修复波团队规范'),
-  curatedCrash)
-await new Promise<void>(r => setTimeout(r, 300)) // 等 fire-and-forget 向量化失败落定
-const shutdownStart = Date.now()
-await fixManager.shutdown()
-check('AW_MEMORY_MAINTENANCE_MS=0 构造 + shutdown 干净快速(<2s)', Date.now() - shutdownStart < 2000,
-  `${Date.now() - shutdownStart}ms`)
-restoreEnv('AW_MEMORY_MAINTENANCE_MS', savedMs)
-restoreEnv('AW_MEMORY_EMBED_BASE_URL', savedUrl)
-restoreEnv('AW_MEMORY_EMBED_MODEL', savedModel)
-console.log(`\n${failures === 0 ? 'ALL PASS' : `${failures} FAILURE(S)`}`)
-process.exit(failures === 0 ? 0 : 1)

package/scripts/test-route-reason.mjs

@@ -1,118 +0,0 @@
-/**
- * 路由决策留痕 + 能力画像数据基础(koda 后端设计借鉴)确定性测试:
- *  - lead 经 agents 端点创建(响应含实例 token)→ MCP tools/call 携带 Bearer
- *  - workshop.task.dispatch 带 route_reason → 落库 → 任务列表返回
- *  - task.status 事件载荷携带 routeReason/createdAt(前端"事件即实体" + 能力画像数据基础)
- * 运行:node scripts/test-route-reason.mjs
- */
-const BASE = process.env.AW_BASE ?? 'http://127.0.0.1:3101'
-const sleep = ms => new Promise(r => setTimeout(r, ms))
-
-let passed = 0, failures = 0
-const check = (name, ok, detail = '') => {
-  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
-  if (ok) passed += 1
-  else failures += 1
-}
-
-const api = async (method, path, { body, token } = {}) => {
-  const headers = { 'content-type': 'application/json' }
-  if (token) headers.authorization = `Bearer ${token}`
-  const res = await fetch(`${BASE}${path}`, { method, headers, body: body !== undefined ? JSON.stringify(body) : undefined })
-  return { status: res.status, ...(await res.json().catch(() => ({}))) }
-}
-
-const mcp = async (sid, id, method, params, agentToken) => {
-  const headers = { 'content-type': 'application/json', 'accept': 'application/json, text/event-stream' }
-  if (sid) headers['mcp-session-id'] = sid
-  if (agentToken) headers.authorization = `Bearer ${agentToken}`
-  const res = await fetch(`${BASE}/api/mcp/workshop`, {
-    method: 'POST',
-    headers,
-    body: JSON.stringify({ jsonrpc: '2.0', id, method, params }),
-  })
-  return { sid: res.headers.get('mcp-session-id'), text: await res.text() }
-}
-
-async function main() {
-  const REASON = 'specialty: mock worker; queue empty; deterministic test'
-
-  // ── 组队(mock;lead 经 agents 端点创建拿 token)──
-  const user = await api('POST', '/api/workshop/users/register', { body: { name: `route-${Date.now().toString(36)}` } })
-  const token = user.data?.token
-  const ch = await api('POST', '/api/workshop/channels', { body: { name: 'route-reason-check' }, token })
-  if (ch.code !== 0) throw new Error('channel 创建失败')
-  const channelId = ch.data.channelId
-  const lead = await api('POST', `/api/workshop/channels/${channelId}/agents`, {
-    body: { name: 'lead', harness: 'mock', role: 'lead' },
-    token,
-  })
-  const worker = await api('POST', `/api/workshop/channels/${channelId}/agents`, {
-    // 慢 worker:lead 会把父任务分解给 worker,子任务在测试窗口内保持 WORKING,
-    // 父任务因此停在非终态 —— MCP 手工 dispatch 才有合法前置状态。
-    body: { name: 'worker', harness: 'mock', role: 'worker', config: { delayMs: 60_000 } },
-    token,
-  })
-  const leadToken = lead.data?.token
-  const workerId = worker.data?.id
-  check('lead 实例 token 下发(MCP caller)', Boolean(leadToken) && Boolean(workerId))
-
-  // ── 父任务 + MCP dispatch 带 route_reason ──
-  // lead 用长 delay:父任务在 MCP 手工派发前必须保持非终态 —— 简单任务会被 mock lead
-  // 在首个监督回合直接收口,那时再 dispatch 只会拿到 TASK_TERMINAL。
-  const task = await api('POST', `/api/workshop/channels/${channelId}/tasks`, {
-    body: {
-      title: '[mock:complex] route-parent',
-      description: '父任务必须分解为子任务并派发给 worker 执行(本条同时是 route_reason 检查的前置)。',
-    },
-    token,
-  })
-  const parentId = task.data?.id
-  check('父任务提交', Boolean(parentId), parentId?.slice(0, 8))
-
-  const init = await mcp(null, 1, 'initialize', {
-    protocolVersion: '2025-03-26',
-    capabilities: {},
-    clientInfo: { name: 'route-e2e', version: '1.0.0' },
-  }, leadToken)
-  const sid = init.sid
-  check('MCP 会话建立(agent caller)', Boolean(sid))
-
-  const call = await mcp(sid, 2, 'tools/call', {
-    name: 'workshop.task.dispatch',
-    arguments: {
-      parentTaskId: parentId,
-      assigneeId: workerId,
-      title: 'routed-child',
-      description: 'child with auditable routing decision',
-      routeReason: REASON,
-    },
-  }, leadToken)
-  const okCall = !/"isError":\s*true/.test(call.text) && !call.text.includes('SCOPE_VIOLATION')
-  check('MCP dispatch(route_reason)执行', okCall, okCall ? '' : call.text.slice(0, 140))
-  if (sid) await fetch(`${BASE}/api/mcp/workshop?sessionId=${sid}`, { method: 'DELETE' }).catch(() => {})
-
-  // ── 断言:任务行带 routeReason + 画像数据基础 ──
-  await sleep(1200)
-  const tasks = (await api('GET', `/api/workshop/channels/${channelId}/tasks`, { token })).data ?? []
-  const child = tasks.find(t => t.title === 'routed-child')
-  check('任务列表返回 routeReason', child?.routeReason === REASON, child?.routeReason ?? '(missing)')
-  check('DTO 含 createdAt/updatedAt(能力画像数据基础)', Boolean(child?.createdAt) && Boolean(child?.updatedAt), '')
-
-  // ── 断言:task.status 事件载荷携带 routeReason/createdAt ──
-  const evs = (await api('GET', `/api/workshop/channels/${channelId}/events?limit=200`, { token })).data?.items ?? []
-  const evReason = evs.find(e => e.type === 'task.status' && (e.payload ?? {}).routeReason !== undefined)
-  const evCreated = evs.find(e => e.type === 'task.status' && (e.payload ?? {}).createdAt !== undefined)
-  check('task.status 事件携带 routeReason(事件即实体)', Boolean(evReason))
-  check('task.status 事件携带 createdAt', Boolean(evCreated))
-
-  // 清理
-  await api('DELETE', `/api/workshop/channels/${channelId}`, { token }).catch(() => {})
-  console.log(`\n★ 结果: ${passed} passed, ${failures} failed`)
-  process.exit(failures === 0 ? 0 : 1)
-}
-
-main().catch((err) => {
-  console.error('e2e 异常:', err.message)
-  process.exit(1)
-})