agentworkshop 0.7.34 → 0.7.38

package/scripts/.mimosa/hook-state/sess_aeaecb58-8833-4b83-b93c-050467d21e03.mtxwtxme-61028-1f4519fbc4.baseline/0554197c3d2bac203a1f5c48a5d52495d1336db1bd7aa4f4c19875810363e684.source

@@ -0,0 +1,153 @@
+/**
+ * DCW 读写集成单元测试:驱动 read 原语(mock/modbus 形态判定)/工程量↔原始值对称映射/
+ * 节点读状态记账/运行时周期读调度/手动读取/Agent dcw_read 工具(鉴权+执行,AW_HOME 隔离)。
+ * 运行: AW_MODE=home AW_HOME=<tmp> npx tsx --tsconfig .nuxt/tsconfig.server.json scripts/test-dcw-read.ts
+ */
+import { mkdtempSync, rmSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+// 工具段需要文件型仓库:整体进程重定向到一次性配置根(避免触碰检出内 .AgentWorkShop)
+const awHome = mkdtempSync(join(tmpdir(), 'aw-dcw-read-'))
+process.env.AW_MODE = 'home'
+process.env.AW_HOME = awHome
+
+let failures = 0
+function check(name: string, ok: boolean, detail = ''): void {
+  console.log(`  ${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ` — ${detail}` : ''}`)
+  if (!ok) failures += 1
+}
+
+// ===== 1. 驱动 read 原语 =====
+console.log('\n--- 驱动 read 原语 ---')
+{
+  const { mockDcwDriver, supportsDcwRead } = await import('../server/services/workshop/dcw/drivers')
+  const domain = { min: 0, max: 300 }
+  const w = await mockDcwDriver.write({ eng: 165, tolerance: 0.1, domain, driverConfig: { key: 't1' } })
+  check('mock 写入成功', w.ok)
+  const r = await mockDcwDriver.read!({ domain, driverConfig: { key: 't1' } })
+  check('mock 读回写值(读写闭环)', r.ok && r.eng === 165 && r.raw === 165, `eng=${r.eng}`)
+  const miss = await mockDcwDriver.read!({ domain, driverConfig: { key: 'never-written' } })
+  check('mock 未写地址读取明确失败', !miss.ok && miss.eng == null)
+  check('读能力判定:mock/modbus-tcp/modbus-rtu/opcua 可读,mqtt/http 不可读',
+    supportsDcwRead('mock') && supportsDcwRead('modbus-tcp') && supportsDcwRead('modbus-rtu') && supportsDcwRead('opcua')
+    && !supportsDcwRead('mqtt') && !supportsDcwRead('http'))
+}
+
+// ===== 2. 工程量↔原始值映射对称 =====
+console.log('\n--- 工程量↔原始值映射 ---')
+{
+  const { engToRaw, rawToEng } = await import('../server/services/workshop/dcw/drivers')
+  const input = { eng: 50, tolerance: 0, domain: { min: 0, max: 100 }, driverConfig: { rawMin: 0, rawMax: 16383, engMin: 0, engMax: 100 } }
+  const raw = engToRaw(50, input)
+  check('线性映射:eng 50 → raw 8191.5', Math.abs(raw - 8191.5) < 1e-9, String(raw))
+  check('映射对称:rawToEng(engToRaw(x)) = x', Math.abs(rawToEng(raw, input) - 50) < 1e-9)
+  const pass = { eng: 7, tolerance: 0, domain: { min: 0, max: 100 }, driverConfig: {} }
+  check('无原始量程:直传(float32 语义)', engToRaw(7, pass) === 7 && rawToEng(7, pass) === 7)
+}
+
+// ===== 3. 节点读状态记账 =====
+console.log('\n--- 节点读状态 ---')
+{
+  const { DcwNode } = await import('../server/services/workshop/dcw/dcw-node')
+  const n = new DcwNode({ id: 'dw-t1', templateRef: 'dcw-temp-sp', readIntervalMs: 2000 })
+  const at = new Date().toISOString()
+  n.applyReadResult(168.456, 168.456, true, '读回', at)
+  check('成功读数回填(按 decimals 取整)', n.readValue === 168.5 && n.lastReadAt === at && n.lastReadError == null, `readValue=${n.readValue}`)
+  n.applyReadResult(null, null, false, '链路超时', new Date().toISOString())
+  check('失败读保留旧值并记原因', n.readValue === 168.5 && n.lastReadError === '链路超时')
+  n.applyReadResult(170, 170, true, '读回', new Date().toISOString())
+  check('恢复成功后清空错误', n.readValue === 170 && n.lastReadError == null)
+  const row = n.toRow()
+  const n2 = DcwNode.fromRow(row)
+  check('持久化 roundtrip(readIntervalMs/readValue/lastRead*)', n2.readIntervalMs === 2000 && n2.readValue === 170 && n2.lastReadError == null)
+  const v = n2.toView()
+  check('视图透出读字段', v.readValue === 170 && v.readIntervalMs === 2000 && 'lastReadError' in v)
+}
+
+// ===== 4. 运行时周期读调度 =====
+console.log('\n--- 运行时周期读调度 ---')
+{
+  const { DcwNode } = await import('../server/services/workshop/dcw/dcw-node')
+  const rtMod = await import('../server/services/workshop/dcw/dcw-runtime')
+  const { DcwNodeRuntime } = rtMod
+  type DcwRuntimeHost = import('../server/services/workshop/dcw/dcw-runtime').DcwRuntimeHost
+  type DcwNodeT = import('../server/services/workshop/dcw/dcw-node').DcwNode
+  const reads: number[] = []
+  const atNow = () => new Date().toISOString()
+  // 记账语义与控制器一致:读成功回填节点 readValue
+  const makeHost = (defaults: { holdIntervalMs: number, readIntervalMs: number }): DcwRuntimeHost => ({
+    running: () => true,
+    defaults: () => defaults,
+    executeWrite: async () => ({ ok: true, message: '', raw: null, readback: null }),
+    executeRead: async (node: DcwNodeT) => {
+      reads.push(Date.now())
+      node.applyReadResult(1, 1, true, '读回', atNow())
+      return { ok: true, value: 1, raw: 1, message: '', at: atNow() }
+    },
+  })
+  const n = new DcwNode({ id: 'dw-t2', templateRef: 'dcw-temp-sp', readIntervalMs: 1000 })
+  const rt = new DcwNodeRuntime(n, makeHost({ holdIntervalMs: 0, readIntervalMs: 5000 }))
+  const t0 = 1_000_000
+  rt.tick(t0)
+  rt.tick(t0 + 500)
+  rt.tick(t0 + 1100)
+  check('周期读按 readIntervalMs 节拍触发(两次窗内各一次)', reads.length === 2, `reads=${reads.length}`)
+  check('写心跳不触发(value=null)', reads.length === 2)
+  n.readValue = 165
+  const manual = await rt.readNow()
+  check('手动读取(readNow)执行并记账', manual.ok && n.readValue === 1 && n.lastReadError == null, `readValue=${n.readValue}`)
+  const schedAfterManual = reads.length
+  const off = new DcwNode({ id: 'dw-t3', templateRef: 'dcw-temp-sp', readIntervalMs: 0 })
+  const rtOff = new DcwNodeRuntime(off, makeHost({ holdIntervalMs: 0, readIntervalMs: 5000 }))
+  rtOff.tick(t0)
+  rtOff.tick(t0 + 2000)
+  check('readIntervalMs=0 关闭周期读', reads.length === schedAfterManual)
+  // 在飞互斥:挂起中的读阻塞 readNow → 409
+  let release: (() => void) | null = null
+  const slowHost: DcwRuntimeHost = {
+    running: () => true,
+    defaults: () => ({ holdIntervalMs: 0, readIntervalMs: 5000 }),
+    executeWrite: async () => ({ ok: true, message: '', raw: null, readback: null }),
+    executeRead: async () => {
+      await new Promise<void>((r) => {
+        release = r
+      })
+      return { ok: true, value: 1, raw: null, message: '', at: atNow() }
+    },
+  }
+  const rtSlow = new DcwNodeRuntime(new DcwNode({ id: 'dw-t4', templateRef: 'dcw-temp-sp', readIntervalMs: null }), slowHost)
+  const inFlight = rtSlow.readNow()
+  let conflicted = false
+  await rtSlow.readNow().catch((e: unknown) => {
+    conflicted = (e as { status?: number }).status === 409
+  })
+  release!()
+  const done = await inFlight
+  check('读在飞互斥(并发 readNow → 409)', conflicted && done.ok)
+}
+
+// ===== 5. Agent dcw_read 工具(鉴权 + 执行;隔离配置根) =====
+console.log('\n--- Agent dcw_read 工具 ---')
+{
+  const { toolDcwRead } = await import('../server/services/workshop/agents/industrial-tools')
+  const denied = await toolDcwRead('agent-x', { node_id: 'dw-none' })
+  check('未绑定 agent 读取被拒', denied.isError === true && /未绑定|无权/.test(denied.text))
+  const { getDcwController } = await import('../server/services/workshop/dcw/dcw-controller')
+  const { getAgentNodeBindingRepo } = await import('../server/services/workshop/agents/node-bindings.repo')
+  const node = getDcwController().create({ templateRef: 'dcw-temp-sp', driver: 'mock', driverConfig: { key: 'agent-t' }, readIntervalMs: 0, name: '读链路测试节点' })
+  const repo = getAgentNodeBindingRepo()
+  repo.bind('agent-a', node.id, 'dcw', 'auto')
+  const before = await toolDcwRead('agent-a', { node_id: node.id })
+  check('从未下发的节点:鉴权通过并如实报告读取失败(mock 无记录)', before.isError === true && /读取失败/.test(before.text) && !/无权|未绑定/.test(before.text), before.text.slice(0, 80))
+  await getDcwController().write(node.id, 172.5, null, { source: 'manual', actor: 'tester' })
+  const after = await toolDcwRead('agent-a', { node_id: node.id })
+  check('写入后读取:ACT 与 SET 一致', after.isError !== true && /172\.5/.test(after.text) && /一致/.test(after.text), after.text.replace(/\n/g, ' | ').slice(0, 140))
+  const other = await toolDcwRead('agent-b', { node_id: node.id })
+  check('其他 agent 越权读取被拒', other.isError === true)
+}
+
+// 收尾
+rmSync(awHome, { recursive: true, force: true })
+console.log(failures === 0 ? '\nDCW-READ ALL PASS' : `\nDCW-READ FAILED(${failures})`)
+process.exit(failures === 0 ? 0 : 1)

package/scripts/.mimosa/hook-state/sess_aeaecb58-8833-4b83-b93c-050467d21e03.mtxwtxme-61028-1f4519fbc4.baseline/05c203d12a954fffba942e1d626e3f5fec05b18a5aef2bac003b7884a4b77406.source

@@ -0,0 +1,431 @@
+/**
+ * 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)