@mzzsfy/dsh-session-manager 0.3.1

package/src/trash.mjs

@@ -0,0 +1,49 @@
+// 回收站:跨平台把文件或目录移入系统回收站,不做直接删除降级。
+// 执行器可注入以便测试;失败按原样抛出,由调用方按失败矩阵处理。
+
+import { execFile } from 'node:child_process'
+import { promisify } from 'node:util'
+
+const TRASH_TIMEOUT_MS = 60 * 1000
+const execFilep = promisify(execFile)
+
+/** 回收站目标的传递变量名;宿主半区与脚本共用,改一侧须同步 */
+export const TRASH_ENV_NAME = 'DSH_TRASH_PATH'
+
+// Windows 路径经环境变量传入:-Command 会把 argv 以空格重拼接为命令文本再解析,
+// 路径走 argv 会在空格处断裂且存在被解析为脚本语句的注入面;环境变量不经
+// PowerShell 文本解析,任意路径形态安全。按目标为目录或文件分派
+// DeleteDirectory / DeleteFile;UIOption 枚举为 API 必需重载参数,在 -NonInteractive
+// 宿主下无对话框,失败经 catch 置非零退出码直达失败矩阵(powershell.exe 对终止错误默认退出 0)。
+const WIN_SCRIPT =
+  '$ErrorActionPreference=\'Stop\'; Add-Type -AssemblyName Microsoft.VisualBasic; try { '
+  + '$p=$env:' + TRASH_ENV_NAME + '; '
+  + 'if ((Get-Item -LiteralPath $p).PSIsContainer) { '
+  + "[Microsoft.VisualBasic.FileIO.FileSystem]::DeleteDirectory($p, 'OnlyErrorDialogs', 'SendToRecycleBin') } "
+  + "else { [Microsoft.VisualBasic.FileIO.FileSystem]::DeleteFile($p, 'OnlyErrorDialogs', 'SendToRecycleBin') } "
+  + 'exit 0 } catch { $_ | Out-String | Write-Error; exit 1 }'
+
+/** 按平台产出回收站命令;win32 路径经 env 传递,其余平台走 argv 末位。 */
+export function trashCommandFor(platform, path) {
+  if (platform === 'win32') {
+    return { file: 'powershell.exe', args: ['-NoProfile', '-NonInteractive', '-Command', WIN_SCRIPT], env: { [TRASH_ENV_NAME]: path } }
+  }
+  if (platform === 'darwin') {
+    return {
+      file: 'osascript',
+      args: ['-e', 'on run argv', '-e', 'tell application "Finder" to delete POSIX file (item 1 of argv)', '-e', 'end run', path],
+    }
+  }
+  return { file: 'gio', args: ['trash', path] }
+}
+
+/**
+ * 把一个已存在的文件或目录移入系统回收站。
+ * @param options.run - 注入的执行器,默认 promisify(execFile)
+ */
+export async function trashPath(path, options = {}) {
+  const { platform = process.platform, run = execFilep, timeoutMs = TRASH_TIMEOUT_MS } = options
+  const command = trashCommandFor(platform, path)
+  const env = command.env ? { ...process.env, ...command.env } : undefined
+  await run(command.file, command.args, { timeout: timeoutMs, env })
+}

package/test/client-id.test.mjs

@@ -0,0 +1,16 @@
+// client.js 注册 id 守卫:loader 按 graph row id(完整包名)匹配注册,短名即加载失败。
+import { readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import test from 'node:test'
+import assert from 'node:assert/strict'
+
+const PKG_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+const { name } = JSON.parse(readFileSync(join(PKG_ROOT, 'package.json'), 'utf8'))
+
+test('client.js 注册 id 为完整包名', () => {
+  const source = readFileSync(join(PKG_ROOT, 'src', 'client.js'), 'utf8')
+  const match = source.match(/__ModuleLoader__\.load\(\{\s*id:\s*'([^']+)'/)
+  assert.ok(match, 'client.js 缺少 __ModuleLoader__.load 注册')
+  assert.equal(match[1], name)
+})

package/test/client-toast.test.mjs

@@ -0,0 +1,89 @@
+// Toast 接线源码级测试:加载真实 src/client.js,以捕获桩驱动 apply 的归档差分,
+// 锁定 external require specifier 与通知出口接线(specifier 拼错当场暴露)。
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { dirname, join } from 'node:path'
+import { mock } from 'node:test'
+
+const PKG_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+
+// 加载 client.js 并执行 apply(mock 最小服务面),返回捕获的 toast 调用与控制器
+function loadClient() {
+  const source = readFileSync(join(PKG_ROOT, 'src', 'client.js'), 'utf8')
+  const modules = []
+  const required = []
+  const shown = []
+  const windowStub = { __ModuleLoader__: { load: (module) => modules.push(module) }, addEventListener: () => {} }
+  const reactStub = { useState: (value) => [value, () => {}], useEffect: () => {}, useSyncExternalStore: () => [], createElement: () => null }
+  const requireStub = (name) => {
+    required.push(name)
+    // 通知出口:公共依赖 @mzzsfy/dsh-toast 的捕获桩
+    if (name === '@mzzsfy/dsh-toast/client') {
+      return { show: (text, opts) => { shown.push({ text, opts }); return shown.length } }
+    }
+    return reactStub
+  }
+  const factory = new Function('window', 'require', 'document', source + '\n;return null')
+  factory(
+    windowStub,
+    requireStub,
+    { createElement: () => ({ style: {}, remove() {} }), head: { appendChild: () => {} }, body: { appendChild: () => {} } },
+  )
+  assert.equal(modules.length, 1, 'client.js 模块未被捕获')
+  const mod = modules[0].factory(requireStub)
+
+  // 差分快照序列由测试手动推进
+  let listener = null
+  let snapshot = undefined
+  const workspaces = {
+    list: {
+      subscribe: (cb) => { listener = cb; return () => { listener = null } },
+      getSnapshot: () => snapshot,
+    },
+  }
+  const effects = []
+  const ctx = {
+    get: (name) => (name === 'workspaces' ? workspaces : {}),
+    effect: (fn, tag) => effects.push(tag),
+    slots: { inject: () => {}, register: () => {} },
+  }
+  mod.apply(ctx)
+  return {
+    shown,
+    required,
+    emit(next) { snapshot = next; if (listener !== null) listener() },
+    effects,
+  }
+}
+
+const READY = (ids) => ({ phase: 'ready', archivedSessionIds: ids })
+
+test('apply:external require specifier 锁定为 @mzzsfy/dsh-toast/client', () => {
+  const client = loadClient()
+  assert.ok(client.required.includes('@mzzsfy/dsh-toast/client'),
+    'client.js 未按约定 specifier require 公共通知依赖: ' + client.required.join(', '))
+})
+
+test('apply:归档差分经 toast 出口,连续 ready 才计新增', () => {
+  mock.timers.enable({ apis: ['setTimeout'] })
+  try {
+    const client = loadClient()
+    assert.deepEqual(client.shown, [], 'apply 本身不发通知')
+    client.emit(READY(['a', 'b']))
+    assert.deepEqual(client.shown, [], '首帧基线(存量归档)不通知')
+    client.emit(READY(['a', 'b', 'c', 'd']))
+    assert.deepEqual(client.shown.map((call) => call.text), ['有 2 个会话已归档'])
+    assert.deepEqual(client.shown.map((call) => call.opts), [undefined])
+    client.emit(READY(['a', 'b', 'c', 'd']))
+    assert.equal(client.shown.length, 1, '无新增不重复通知')
+  } finally {
+    mock.timers.reset()
+  }
+})
+
+test('apply:effect 挂样式与差分退订两个副作用', () => {
+  const client = loadClient()
+  assert.deepEqual(client.effects, ['session-manager styles', 'session-manager archived diff'])
+})

package/test/core.test.mjs

@@ -0,0 +1,307 @@
+// 纯逻辑层测试:归档评估状态机、删除资格与失败矩阵、面板投影、归档集合差分、空白产物判定。
+// BDD 场景对应 docs/design/dsh-session-manager.md。
+
+import test from 'node:test'
+import assert from 'node:assert/strict'
+
+import {
+  DAY_MS,
+  DEFAULT_AUTO_ARCHIVE_DAYS,
+  DELETE_MESSAGES,
+  aggregateDeleteOutcome,
+  aggregateInputs,
+  archiveToastStep,
+  artifactLooksBlank,
+  deleteEligibility,
+  diffArchived,
+  extractUserInputs,
+  isSessionRunning,
+  mergeDeletedEntry,
+  projectArchiveRows,
+  projectDeletedRows,
+  removeDeletedEntry,
+  selectArchiveCandidates,
+  updatedAtOf,
+} from '../src/core.mjs'
+
+const NOW = Date.parse('2026-01-10T00:00:00Z')
+const ACTIVE = NOW - 1 * DAY_MS
+const STALE = NOW - 8 * DAY_MS
+
+function record(overrides) {
+  return { id: 's1', archived: false, running: false, blank: false, updatedAt: STALE, ...overrides }
+}
+
+test('阈值天数默认值与常量自洽', () => {
+  assert.equal(DEFAULT_AUTO_ARCHIVE_DAYS, 7)
+  assert.equal(DAY_MS, 24 * 60 * 60 * 1000)
+})
+
+test('新会话触发自动归档:超期候选被选中', () => {
+  const picked = selectArchiveCandidates({ records: [record({})], nowMs: NOW, thresholdDays: 7 })
+  assert.deepEqual(picked, ['s1'])
+})
+
+test('未超期与恰好等于阈值的会话不归档', () => {
+  const records = [record({ updatedAt: ACTIVE }), record({ updatedAt: NOW - 7 * DAY_MS })]
+  assert.deepEqual(selectArchiveCandidates({ records, nowMs: NOW, thresholdDays: 7 }), [])
+})
+
+test('运行中会话豁免', () => {
+  const picked = selectArchiveCandidates({ records: [record({ running: true })], nowMs: NOW, thresholdDays: 7 })
+  assert.deepEqual(picked, [])
+})
+
+test('空白会话豁免', () => {
+  const picked = selectArchiveCandidates({ records: [record({ blank: true })], nowMs: NOW, thresholdDays: 7 })
+  assert.deepEqual(picked, [])
+})
+
+test('已归档会话不参与评估:幂等', () => {
+  const records = [record({ archived: true })]
+  const first = selectArchiveCandidates({ records, nowMs: NOW, thresholdDays: 7 })
+  assert.deepEqual(first, [])
+})
+
+test('阈值为零关闭功能', () => {
+  const picked = selectArchiveCandidates({ records: [record({})], nowMs: NOW, thresholdDays: 0 })
+  assert.deepEqual(picked, [])
+})
+
+test('阈值负值与非有限值防御性关闭', () => {
+  assert.deepEqual(selectArchiveCandidates({ records: [record({})], nowMs: NOW, thresholdDays: -1 }), [])
+  assert.deepEqual(selectArchiveCandidates({ records: [record({})], nowMs: NOW, thresholdDays: Number.NaN }), [])
+})
+
+test('updatedAt 取创建时间与最近活跃的较大者', () => {
+  assert.equal(updatedAtOf({ createdAt: 100 }, 50), 100)
+  assert.equal(updatedAtOf({ createdAt: 100 }, 500), 500)
+  assert.equal(updatedAtOf({ createdAt: 100 }, undefined), 100)
+})
+
+test('归档面板投影:交集过滤且按更新时间倒序', () => {
+  const rows = [
+    { id: 'b', title: 'B', updatedAt: 200 },
+    { id: 'a', title: 'A', updatedAt: 300 },
+    { id: 'c', title: 'C', updatedAt: 100 },
+    { id: 'd', title: 'D', updatedAt: 400 },
+  ]
+  const projected = projectArchiveRows({ rows, archivedIds: ['b', 'c', 'gone'] })
+  assert.deepEqual(projected, [
+    { id: 'b', title: 'B', updatedAt: 200 },
+    { id: 'c', title: 'C', updatedAt: 100 },
+  ])
+})
+
+test('归档面板投影:标题缺失回退会话 id(与 client 镜像同规)', () => {
+  const projected = projectArchiveRows({ rows: [{ id: 'a', title: '', updatedAt: 5 }], archivedIds: ['a'] })
+  assert.deepEqual(projected, [{ id: 'a', title: 'a', updatedAt: 5 }])
+})
+
+test('归档集合差分只报新增,首帧基线不提示', () => {
+  assert.deepEqual(diffArchived(undefined, ['x', 'y']), [])
+  assert.deepEqual(diffArchived(['x'], ['x', 'y', 'z']), ['y', 'z'])
+  assert.deepEqual(diffArchived(['x', 'y'], ['x']), [])
+})
+
+test('Toast 差分:pending 空态与基线首装不提示,ready 后新增才提示', () => {
+  let previous
+  let step = archiveToastStep(previous, { phase: 'pending', archivedSessionIds: [] })
+  previous = step.state
+  assert.deepEqual(step.added, [])
+  // 基线安装:存量 29 个不算新增(模型 pending 期发射,notify 时序不定,两种相位都守卫)
+  step = archiveToastStep(previous, { phase: 'pending', archivedSessionIds: ['a', 'b'] })
+  previous = step.state
+  assert.deepEqual(step.added, [])
+  step = archiveToastStep(previous, { phase: 'ready', archivedSessionIds: ['a', 'b'] })
+  previous = step.state
+  assert.deepEqual(step.added, [])
+  // ready 建立后:增量帧触发提示
+  step = archiveToastStep(previous, { phase: 'ready', archivedSessionIds: ['a', 'b', 'c'] })
+  assert.deepEqual(step.added, ['c'])
+})
+
+test('Toast 差分:订阅即 ready(无 pending 帧)时首帧守卫仍生效', () => {
+  let previous
+  const step = archiveToastStep(previous, { phase: 'ready', archivedSessionIds: ['a'] })
+  previous = step.state
+  assert.deepEqual(step.added, [])
+  assert.deepEqual(archiveToastStep(previous, { phase: 'ready', archivedSessionIds: ['a', 'b'] }).added, ['b'])
+})
+
+test('Toast 差分:ready→pending→ready 重连序列不误报存量', () => {
+  let previous
+  let step = archiveToastStep(previous, { phase: 'ready', archivedSessionIds: ['a'] })
+  previous = step.state
+  // 断连:pending 帧中断 ready 链
+  step = archiveToastStep(previous, { phase: 'pending', archivedSessionIds: ['a', 'b'] })
+  previous = step.state
+  assert.deepEqual(step.added, [])
+  // 重连基线首装:不提示存量(离期新增的提示语义见 core 注释)
+  step = archiveToastStep(previous, { phase: 'ready', archivedSessionIds: ['a', 'b'] })
+  previous = step.state
+  assert.deepEqual(step.added, [])
+  // 重连建立后:增量照常提示
+  assert.deepEqual(archiveToastStep(previous, { phase: 'ready', archivedSessionIds: ['a', 'b', 'c'] }).added, ['c'])
+})
+
+test('非归档会话拒绝删除', () => {
+  assert.equal(deleteEligibility({ archivedIds: ['a'], sessionId: 'a' }).ok, true)
+  const denied = deleteEligibility({ archivedIds: ['a'], sessionId: 'b' })
+  assert.equal(denied.ok, false)
+  assert.equal(denied.code, 'not-archived')
+})
+
+test('删除收尾聚合:失败矩阵折叠为三形态响应体', () => {
+  const R = DELETE_MESSAGES.runningDuringTrash
+  // 全成功无警告:无多余键(index.test deepEqual 锁定同形态)
+  assert.deepEqual(aggregateDeleteOutcome({}), { ok: true })
+  // 单一失败:主文案优先级 detach → 归档清理 → 台账
+  assert.deepEqual(aggregateDeleteOutcome({ detachFailed: true }), { ok: true, partial: true, message: DELETE_MESSAGES.partial })
+  assert.deepEqual(aggregateDeleteOutcome({ archiveCleanupFailed: true }), { ok: true, partial: true, message: DELETE_MESSAGES.archiveCleanup })
+  assert.deepEqual(aggregateDeleteOutcome({ ledgerFailed: true }), { ok: true, partial: true, message: DELETE_MESSAGES.ledgerFailed })
+  // 双失败:高优先级主文案 + 台账后缀
+  assert.deepEqual(
+    aggregateDeleteOutcome({ detachFailed: true, ledgerFailed: true }),
+    { ok: true, partial: true, message: DELETE_MESSAGES.partial + DELETE_MESSAGES.ledgerSuffix },
+  )
+  // 运行中翻转警告后缀并入一切形态
+  assert.deepEqual(
+    aggregateDeleteOutcome({ detachFailed: true, ledgerFailed: true, runningDuringTrash: true }),
+    { ok: true, partial: true, message: DELETE_MESSAGES.partial + DELETE_MESSAGES.ledgerSuffix + ';' + R },
+  )
+  // 全失败
+  assert.deepEqual(
+    aggregateDeleteOutcome({ detachFailed: true, archiveCleanupFailed: true, ledgerFailed: true, runningDuringTrash: true }),
+    { ok: true, partial: true, message: DELETE_MESSAGES.partial + DELETE_MESSAGES.ledgerSuffix + ';' + R },
+  )
+  // 全成功警告态:非 partial 形态(ok+message,无 partial 键)
+  assert.deepEqual(aggregateDeleteOutcome({ runningDuringTrash: true }), { ok: true, message: R })
+})
+
+test('运行中判定:agent status running 即运行中,注册表缺失视为非运行', () => {
+  const agents = new Map([['s1', { status: 'running' }], ['s2', { status: 'idle' }]])
+  assert.equal(isSessionRunning({ agents, sessionId: 's1' }), true)
+  assert.equal(isSessionRunning({ agents, sessionId: 's2' }), false)
+  assert.equal(isSessionRunning({ agents, sessionId: 'gone' }), false)
+  assert.equal(isSessionRunning({ agents: undefined, sessionId: 's1' }), false)
+})
+
+test('空白产物判定:JSONL 单行(仅 header)为空白', () => {
+  assert.equal(artifactLooksBlank('{"header":1}\n', false), true)
+  assert.equal(artifactLooksBlank('', false), true)
+  assert.equal(artifactLooksBlank('{"header":1}\n{"event":0}\n', false), false)
+  assert.equal(artifactLooksBlank('{"header":1}\n{"event":0', true), false)
+})
+
+test('空白产物判定:整块边界与 CRLF 行尾', () => {
+  // 恰满整块且换行不足两行:hasMore=true 判非空白(保守方向,防漏读)
+  assert.equal(artifactLooksBlank('{"header":1}\n', true), false)
+  // CRLF 行尾:\r 不计数,单行 CRLF header 仍为空白
+  assert.equal(artifactLooksBlank('{"header":1}\r\n', false), true)
+  assert.equal(artifactLooksBlank('{"header":1}\r\n{"event":0}\r\n', false), false)
+})
+
+test('已删除面板投影:标题回退会话 id,按删除时间倒序', () => {
+  const deleted = [
+    { sessionId: 'a', path: 'C:\\w\\a', deletedAt: 100 },
+    { sessionId: 'b', path: 'C:\\w\\b', deletedAt: 300 },
+    { sessionId: 'c', path: 'C:\\w\\c', deletedAt: 200 },
+  ]
+  const rows = projectDeletedRows(deleted, { a: { displayTitle: '会话 A' } })
+  assert.deepEqual(rows, [
+    { sessionId: 'b', path: 'C:\\w\\b', deletedAt: 300, title: 'b' },
+    { sessionId: 'c', path: 'C:\\w\\c', deletedAt: 200, title: 'c' },
+    { sessionId: 'a', path: 'C:\\w\\a', deletedAt: 100, title: '会话 A' },
+  ])
+})
+
+test('已删除面板投影:空台账投影为空', () => {
+  assert.deepEqual(projectDeletedRows([], {}), [])
+})
+
+test('台账合并:同 id 替换置顶,新 id 插入头部,入参不变', () => {
+  const existing = [{ sessionId: 'a', path: 'p1', deletedAt: 1 }]
+  assert.deepEqual(
+    mergeDeletedEntry(existing, { sessionId: 'a', path: 'p2', deletedAt: 2 }),
+    [{ sessionId: 'a', path: 'p2', deletedAt: 2 }],
+  )
+  assert.deepEqual(
+    mergeDeletedEntry(existing, { sessionId: 'b', path: 'p3', deletedAt: 3 }),
+    [{ sessionId: 'b', path: 'p3', deletedAt: 3 }, { sessionId: 'a', path: 'p1', deletedAt: 1 }],
+  )
+  assert.deepEqual(existing, [{ sessionId: 'a', path: 'p1', deletedAt: 1 }])
+})
+
+test('台账移除:命中删除并报变化,未命中幂等不报变化', () => {
+  const existing = [
+    { sessionId: 'a', path: 'p1', deletedAt: 1 },
+    { sessionId: 'b', path: 'p2', deletedAt: 2 },
+  ]
+  const hit = removeDeletedEntry(existing, 'a')
+  assert.deepEqual(hit.deleted, [{ sessionId: 'b', path: 'p2', deletedAt: 2 }])
+  assert.equal(hit.removed, true)
+  const miss = removeDeletedEntry(existing, 'z')
+  assert.deepEqual(miss.deleted, existing)
+  assert.equal(miss.removed, false)
+})
+
+// ── 历史输入:事件提取(G1-G3)──
+
+function userEvent(overrides, text, at) {
+  return {
+    type: 'user/message',
+    seq: 1,
+    time: at,
+    ...overrides,
+    data: {
+      id: 'm1',
+      role: 'user',
+      source: { kind: 'user' },
+      content: text === undefined ? [] : [{ type: 'text', text }],
+      ...overrides?.data,
+    },
+  }
+}
+
+test('历史输入提取:user/message 且 kind=user 产出文本与时间', () => {
+  const events = [userEvent(null, '修复归档面板', 500)]
+  assert.deepEqual(extractUserInputs(events), [{ text: '修复归档面板', at: 500 }])
+})
+
+test('历史输入提取:tool 结果与 plugin 注入不产出', () => {
+  const tool = userEvent({ data: { source: { kind: 'tool', callId: 'c1' }, content: [{ type: 'tool-result', toolCallId: 'c1', content: [] }] } }, undefined, 100)
+  const plugin = userEvent({ data: { source: { kind: 'plugin', plugin: 'x', form: 'instructions' }, content: [{ type: 'text', text: '注入' }] } }, undefined, 200)
+  assert.deepEqual(extractUserInputs([tool, plugin]), [])
+})
+
+test('历史输入提取:纯图与空文本跳过', () => {
+  const image = userEvent({ data: { content: [{ type: 'image', attachment: { id: 'a1' } }] } }, undefined, 100)
+  const blank = userEvent(null, '', 200)
+  const whitespace = userEvent(null, ' \n ', 300)
+  assert.deepEqual(extractUserInputs([image, blank, whitespace]), [])
+})
+
+test('历史输入提取:多 text block 按行拼接为单条', () => {
+  const events = [userEvent({ data: { content: [{ type: 'text', text: '第一段' }, { type: 'text', text: '第二段' }] } }, undefined, 300)]
+  assert.deepEqual(extractUserInputs(events), [{ text: '第一段\n第二段', at: 300 }])
+})
+
+// ── 历史输入:聚合(G4-G5)──
+
+test('历史输入聚合:同文本去重保留最新时间,按时间倒序', () => {
+  const merged = aggregateInputs([
+    { text: 'a', at: 1 },
+    { text: 'b', at: 5 },
+    { text: 'a', at: 9 },
+  ], { limit: 10, maxChars: 100 })
+  assert.deepEqual(merged, [{ text: 'a', at: 9 }, { text: 'b', at: 5 }])
+})
+
+test('历史输入聚合:limit 裁剪与单条截断', () => {
+  const merged = aggregateInputs([
+    { text: 'abcdef', at: 1 },
+    { text: 'xy', at: 2 },
+  ], { limit: 1, maxChars: 3 })
+  assert.deepEqual(merged, [{ text: 'xy', at: 2 }])
+})