@zhushanwen/pi-session-reader 0.5.1 → 0.6.1

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@zhushanwen/pi-session-reader",
-  "version": "0.5.1",
+  "version": "0.6.1",
   "type": "module",
   "main": "index.ts",
-  "xyz-agent": {
+  "taiji": {
     "role": "universal"
   },
   "pi": {
@@ -15,10 +15,13 @@
   "keywords": [
     "pi-package"
   ],
+  "dependencies": {
+    "@zhushanwen/pi-ext-guards": "0.4.1"
+  },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.9",
     "vitest": "^4.1.8",
-    "@zhushanwen/subagent-core": "0.10.0"
+    "@zhushanwen/subagent-core": "0.10.5"
   },
   "files": [
     "index.ts",

package/src/__tests__/cross-package-subagent-core.test.ts

@@ -20,20 +20,21 @@ import {
 } from '@zhushanwen/subagent-core/execution/assembly/path-encoding.ts'
 
 /**
- * W4 跨包集成测试（subagent-sync-collect v2 impl-plan W4 验收条款①，设计 §5 W4：
- * 「subagent-core 真实 tmpdir 产出磁盘状态 → session-reader result action sa- id 反查，
- * 不 mock manifest 写入」）。
+ * W4 跨包集成测试（[collect 退役] 改造保留：原「E1 落标出口产出 manifest」驱动面
+ * 随 sync 批机制删除，现行真实投影出口 = store 重建通道 rebuildIndexes——manifest
+ * 是可丢缓存，boot 全量腿按磁盘子文件锚幂等补缺）。「subagent-core 真实 tmpdir
+ * 产出磁盘状态 → session-reader result action sa- id 反查，不 mock manifest 写入」
+ * 的跨包契约保持不变。
  *
- * 与 result.test.ts 的分工：result.test.ts 的 fixture **手工预写** manifest（U6 时期
- * W3 投影代码尚不存在）；本文件 manifest 内容必须来自 v2 W3 的投影代码路径——
- * subagent-core 侧真实驱动 E1 崩溃恢复（kill -9 同构链路：真实 RecordStore 落盘
- * register/轮终 entry → initSession 内 orphan 覆写真实跑 → recoverSyncCollectBatch
- * 落标出口 appendBatchFinalizedEntry fire-and-forget 真写 records/<sa-id>.json），
- * session-reader 侧零 mock 读同一 tmpdir 断言反查闭环。
+ * 与 result.test.ts 的分工：result.test.ts 的 fixture **手工预写** manifest；本文件
+ * manifest 内容必须来自投影代码路径——subagent-core 侧真实驱动（真实 RecordStore
+ * 落盘 register/轮终 entry → initSession 内 orphan 覆写真实跑 → rebuildIndexes
+ * derivedManifestRecord 投影真写 records/<sa-id>.json），session-reader 侧零 mock
+ * 读同一 tmpdir 断言反查闭环。
  *
  * 构造形态取自 subagent-core sync-collect-recovery.test.ts 的 kill -9 同构主用例
- * （W1 领地，形态同构是 v1 教训「种子绕过真实链路 = 假绿」的执行）：子 session 文件
- * 在其基础上补 message entries（result action 的正文提取源）。
+ * （形态同构是 v1 教训「种子绕过真实链路 = 假绿」的执行）：子 session 文件在其
+ * 基础上补 message entries（result action 的正文提取源）。
  *
  * mock 面最小：仅构造 SubagentService 所需的最小 pi 形状（appendEntry 真写主文件，
  * 其余 no-op stub）——零 vi.mock、notifier/store/config 全真实实现，agentDir 全部
@@ -48,9 +49,9 @@ const ENV_KEYS_TO_STRIP = [
   'PI_SUBAGENT_DEPTH',
   'PI_SUBAGENT_ROOT_CWD',
   'PI_SUBAGENT_FORK_DEPTH',
-  'XYZ_SUBAGENT_RELAY_SOCKET',
-  'XYZ_SUBAGENT_RELAY_NODE',
-  'XYZ_SUBAGENT_RELAY_SCRIPT',
+  'TAIJI_SUBAGENT_RELAY_SOCKET',
+  'TAIJI_SUBAGENT_RELAY_NODE',
+  'TAIJI_SUBAGENT_RELAY_SCRIPT',
 ] as const
 
 const ROOT_SESSION = 'root-cross-pkg'
@@ -102,8 +103,6 @@ function memberRecord(overrides: Partial<SubagentRecord> & { id: string }): Suba
     result: undefined,
     error: undefined,
     sessionFile: undefined,
-    chatMode: false,
-    collectMode: 'sync',
     ...overrides,
   }
 }
@@ -118,7 +117,7 @@ interface MemberSeed {
   model: string
 }
 
-describe('跨包集成：subagent-core E1 落标 manifest → session-reader result 反查（W4）', () => {
+describe('跨包集成：subagent-core 重建 manifest → session-reader result 反查（W4）', () => {
   let agentDir: string
   let mainFile: string
   let services: SubagentService[]
@@ -213,31 +212,22 @@ describe('跨包集成：subagent-core E1 落标 manifest → session-reader res
     return childFile
   }
 
-  /** 种「崩溃前主文件末条序列」：register（running+sync）→ 轮终（running+resumable+
-   *  result 全文 + sessionFile）——成功成员崩溃时的真实末条形态。 */
+  /** 种「崩溃前主文件末条序列」：register（running+sync）→ 轮终（idle + result
+   *  全文 + sessionFile）——[U4/D4] 翻边后成功成员崩溃时的真实末条形态（U5 前的
+   *  running+resumable 桥接形态已随字段退役消亡）。 */
   function seedRoundTerminalEntries(m: MemberSeed, childFile: string): void {
     const store = makeSeedStore()
     store.reportSubagentRecord(memberRecord({ id: m.id, sessionFile: childFile, model: m.model }))
     store.reportSubagentRecord(
-      memberRecord({ id: m.id, sessionFile: childFile, model: m.model, resumable: true, result: m.resultText }),
+      memberRecord({ id: m.id, sessionFile: childFile, model: m.model, status: 'idle', result: m.resultText }),
     )
   }
 
-  /** 手写短轮询（真实 timers，vitest 4.1.8 vi.waitFor 对 falsy callback 不轮询——
-   *  subagent-core 同款纪律）：manifest 为 fire-and-forget 异步写，需轮询等落盘。 */
-  async function until(cond: () => boolean, timeoutMs = 3000): Promise<void> {
-    const start = Date.now()
-    while (!cond()) {
-      if (Date.now() - start > timeoutMs) {
-        throw new Error(`cross-pkg: condition not met within ${timeoutMs}ms`)
-      }
-      await new Promise((resolve) => setTimeout(resolve, 10))
-    }
-  }
-
-  /** 全链路驱动：种子 → 恢复 service（orphan 覆写）→ E1（落标出口真写 manifest）。
-   *  返回子 session 文件路径表。 */
-  async function driveSyncBatchRecovery(members: MemberSeed[]): Promise<Map<string, string>> {
+  /** 全链路驱动：种子 → 恢复 service（orphan 覆写）→ rebuildIndexes（现行 boot
+   *  全量重建通道——derivedManifestRecord 投影真写 manifest）。返回子 session 文件
+   *  路径表。[collect 退役] 原 E1 落标出口（recoverSyncCollectBatch →
+   *  appendBatchFinalizedEntry）随 sync 批机制删除。 */
+  async function driveManifestRebuild(members: MemberSeed[]): Promise<Map<string, string>> {
     const childFiles = new Map<string, string>()
     for (const m of members) {
       const childFile = writeChildSessionFile(m)
@@ -245,12 +235,15 @@ describe('跨包集成：subagent-core E1 落标 manifest → session-reader res
       seedRoundTerminalEntries(m, childFile)
     }
     const service = makeRecoveryService()
-    service.recoverSyncCollectBatch()
-    // E1 落标出口 appendBatchFinalizedEntry 的 manifest 是 fire-and-forget best-effort
-    // 写——轮询等全部成员 manifest 真实落盘（W3 投影代码路径的产物）。
-    await until(() =>
-      members.every((m) => fs.existsSync(path.join(getSubagentRecordsDir(agentDir, agentDir), `${m.id}.json`))),
-    )
+    service.rebuildIndexes()
+    // derivedManifestRecord 投影为同步落盘——全成员 manifest 即刻可见（W3 投影
+    // 代码路径的产物，非手工预写）。
+    for (const m of members) {
+      expect(
+        fs.existsSync(path.join(getSubagentRecordsDir(agentDir, agentDir), `${m.id}.json`)),
+        `manifest of ${m.id}`,
+      ).toBe(true)
+    }
     return childFiles
   }
 
@@ -262,12 +255,12 @@ describe('跨包集成：subagent-core E1 落标 manifest → session-reader res
       assistantParts: ['part one', 'part two'],
       model: 'prov/round-m',
     }
-    const childFiles = await driveSyncBatchRecovery([m])
+    const childFiles = await driveManifestRebuild([m])
 
-    // manifest 内容断言（W3 appendBatchFinalizedEntry 投影路径的产物，非手工预写）：
-    // sessionFile 来自 W1 投影扩展。[U2/U3 两态桥接] E1 落标成员经恢复链覆写后处于
-    // idle（重建单规则）/running 形态、无旧终态遗留位 → legacy status 如实投影
-    // "running"（batchManifestRecord 单点派生，session-reader 视角的活跃成员）。
+    // manifest 内容断言（rebuildIndexes → derivedManifestRecord 投影路径的产物，
+    // 非手工预写）：sessionFile 来自 W1 投影扩展。[U2/U3 两态桥接] 恢复链覆写后成员
+    // 处于 idle（重建单规则）、无旧终态遗留位 → legacy status 如实投影 "running"
+    //（legacyManifestStatusFields 单点派生，session-reader 视角的活跃成员）。
     const manifest = JSON.parse(
       fs.readFileSync(path.join(getSubagentRecordsDir(agentDir, agentDir), 'sa-cross-1.json'), 'utf-8'),
     ) as Record<string, unknown>
@@ -280,7 +273,7 @@ describe('跨包集成：subagent-core E1 落标 manifest → session-reader res
     })
 
     // session-reader 侧：sa- id 反查（v1 此处报「无匹配 record」——manifest 惰性不落盘）
-    const r = await handleSessionRead({ action: 'result', session: 'sa-cross-1' }, agentDir)
+    const r = await handleSessionRead({ action: 'result', session: 'sa-cross-1' }, { agentDir })
     // 同源语义：跨 assistant message "\n\n" join、thinking 块排除——与 record.result 逐字节一致
     expect(r.content[0]?.text).toBe(resultText)
     const d = r.details as {
@@ -302,9 +295,9 @@ describe('跨包集成：subagent-core E1 落标 manifest → session-reader res
       { id: 'sa-cross-a', resultText: 'alpha final answer', assistantParts: ['alpha final answer'], model: 'prov/ma' },
       { id: 'sa-cross-b', resultText: 'beta final answer', assistantParts: ['beta final answer'], model: 'prov/mb' },
     ]
-    await driveSyncBatchRecovery(members)
+    await driveManifestRebuild(members)
 
-    const r = await handleSessionRead({ action: 'result', session: 'sa-cross-a,sa-cross-b' }, agentDir)
+    const r = await handleSessionRead({ action: 'result', session: 'sa-cross-a,sa-cross-b' }, { agentDir })
     const text = r.content[0]?.text ?? ''
     expect(text).toContain('[1/2] sa-cross-a')
     expect(text).toContain('[2/2] sa-cross-b')

package/src/__tests__/env.test.ts

@@ -1,9 +1,9 @@
 import { describe, it, expect } from 'vitest'
 import {
   detectEnvironment,
-  XYZ_AGENT_EXT_LOG_ENV,
+  TAIJI_AGENT_EXT_LOG_ENV,
   PI_CODING_AGENT_DIR_ENV,
-  XYZ_AGENT_DATA_DIR_ENV,
+  TAIJI_AGENT_DATA_DIR_ENV,
   type EnvironmentSignals,
 } from '../discovery/env.js'
 
@@ -22,54 +22,54 @@ function signals(overrides: Partial<EnvironmentSignals> = {}): EnvironmentSignal
 }
 
 describe('detectEnvironment 托管合取判定', () => {
-  it('双信号齐备 + B 后新布局 <dataDir>/agent → xyz-agent（packaged）', () => {
+  it('双信号齐备 + B 后新布局 <dataDir>/agent → taiji（packaged）', () => {
     const r = detectEnvironment(
       signals({
         env: {
-          [XYZ_AGENT_EXT_LOG_ENV]: '1',
-          [PI_CODING_AGENT_DIR_ENV]: '/Users/u/.xyz-agent/agent',
+          [TAIJI_AGENT_EXT_LOG_ENV]: '1',
+          [PI_CODING_AGENT_DIR_ENV]: '/Users/u/.taiji/agent',
         },
         bundleUrl:
           'file:///Applications/TaiJi.app/Contents/Resources/extensions/@zhushanwen/pi-session-reader/index.mjs',
       }),
     )
-    expect(r.kind).toBe('xyz-agent')
+    expect(r.kind).toBe('taiji')
     expect(r.distribution).toBe('packaged')
-    expect(r.dataDir).toBe('/Users/u/.xyz-agent')
+    expect(r.dataDir).toBe('/Users/u/.taiji')
   })
 
-  it('双信号齐备 + B 前旧布局 <dataDir>/pi/agent → xyz-agent（迁移窗口期双形态兼容）', () => {
+  it('双信号齐备 + B 前旧布局 <dataDir>/pi/agent → taiji（迁移窗口期双形态兼容）', () => {
     const r = detectEnvironment(
       signals({
         env: {
-          [XYZ_AGENT_EXT_LOG_ENV]: '1',
-          [PI_CODING_AGENT_DIR_ENV]: '/Users/u/.xyz-agent-dev/pi/agent',
+          [TAIJI_AGENT_EXT_LOG_ENV]: '1',
+          [PI_CODING_AGENT_DIR_ENV]: '/Users/u/.taiji-dev/pi/agent',
         },
-        bundleUrl: 'file:///Users/u/Code/xyz-agent/extensions/universal/session-reader/src/index.ts',
+        bundleUrl: 'file:///Users/u/Code/taiji/extensions/universal/session-reader/src/index.ts',
       }),
     )
-    expect(r.kind).toBe('xyz-agent')
+    expect(r.kind).toBe('taiji')
     expect(r.distribution).toBe('dev')
-    expect(r.dataDir).toBe('/Users/u/.xyz-agent-dev')
+    expect(r.dataDir).toBe('/Users/u/.taiji-dev')
   })
 
-  it('透传污染反例 1：仅 XYZ_AGENT_EXT_LOG=1（PI_CODING_AGENT_DIR 未设）→ standalone-pi，evidence 点名孤置信号', () => {
+  it('透传污染反例 1：仅 TAIJI_AGENT_EXT_LOG=1（PI_CODING_AGENT_DIR 未设）→ standalone-pi，evidence 点名孤置信号', () => {
     const r = detectEnvironment(
-      signals({ env: { [XYZ_AGENT_EXT_LOG_ENV]: '1' } }),
+      signals({ env: { [TAIJI_AGENT_EXT_LOG_ENV]: '1' } }),
     )
     expect(r.kind).toBe('standalone-pi')
     expect(r.dataDir).toBeUndefined()
     const joined = r.evidence.join('\n')
-    expect(joined).toContain(`${XYZ_AGENT_EXT_LOG_ENV}='1' → 命中`)
+    expect(joined).toContain(`${TAIJI_AGENT_EXT_LOG_ENV}='1' → 命中`)
     expect(joined).toContain('单独成立不合取')
-    expect(joined).toContain(XYZ_AGENT_EXT_LOG_ENV)
+    expect(joined).toContain(TAIJI_AGENT_EXT_LOG_ENV)
   })
 
-  it('透传污染反例 2：仅 XYZ_AGENT_EXT_LOG=1 且 PI_CODING_AGENT_DIR 为裸 pi 形态 → standalone-pi', () => {
+  it('透传污染反例 2：仅 TAIJI_AGENT_EXT_LOG=1 且 PI_CODING_AGENT_DIR 为裸 pi 形态 → standalone-pi', () => {
     const r = detectEnvironment(
       signals({
         env: {
-          [XYZ_AGENT_EXT_LOG_ENV]: '1',
+          [TAIJI_AGENT_EXT_LOG_ENV]: '1',
           [PI_CODING_AGENT_DIR_ENV]: '/home/u/.pi/agent',
         },
       }),
@@ -81,7 +81,7 @@ describe('detectEnvironment 托管合取判定', () => {
   it('透传污染反例 3：仅 PI_CODING_AGENT_DIR 形态匹配（EXT_LOG 未设）→ standalone-pi，evidence 点名孤置信号', () => {
     const r = detectEnvironment(
       signals({
-        env: { [PI_CODING_AGENT_DIR_ENV]: '/Users/u/.xyz-agent/agent' },
+        env: { [PI_CODING_AGENT_DIR_ENV]: '/Users/u/.taiji/agent' },
       }),
     )
     expect(r.kind).toBe('standalone-pi')
@@ -92,13 +92,13 @@ describe('detectEnvironment 托管合取判定', () => {
     expect(joined).toContain(PI_CODING_AGENT_DIR_ENV)
   })
 
-  it('XYZ_AGENT_EXT_LOG 非 1 值（如 0 / true）不构成命中', () => {
+  it('TAIJI_AGENT_EXT_LOG 非 1 值（如 0 / true）不构成命中', () => {
     for (const value of ['0', 'true', '']) {
       const r = detectEnvironment(
         signals({
           env: {
-            [XYZ_AGENT_EXT_LOG_ENV]: value,
-            [PI_CODING_AGENT_DIR_ENV]: '/Users/u/.xyz-agent/agent',
+            [TAIJI_AGENT_EXT_LOG_ENV]: value,
+            [PI_CODING_AGENT_DIR_ENV]: '/Users/u/.taiji/agent',
           },
         }),
       )
@@ -106,12 +106,12 @@ describe('detectEnvironment 托管合取判定', () => {
     }
   })
 
-  it('形态防误报：无点前缀 xyz-agent、嵌套浅段不匹配', () => {
-    for (const dir of ['/home/u/xyz-agent/agent', '/home/u/.xyz/agent', '/.pi/agent']) {
+  it('形态防误报：无点前缀 taiji、嵌套浅段不匹配', () => {
+    for (const dir of ['/home/u/taiji/agent', '/home/u/.foo/agent', '/.pi/agent']) {
       const r = detectEnvironment(
         signals({
           env: {
-            [XYZ_AGENT_EXT_LOG_ENV]: '1',
+            [TAIJI_AGENT_EXT_LOG_ENV]: '1',
             [PI_CODING_AGENT_DIR_ENV]: dir,
           },
         }),
@@ -144,8 +144,8 @@ describe('detectEnvironment distribution（bundle 路径三态）', () => {
 
   it('仓库路径（源码与 dev staged 资源根两种）→ dev，staged 根不被误判 packaged', () => {
     for (const url of [
-      'file:///Users/u/Code/xyz-agent/extensions/universal/session-reader/src/index.ts',
-      'file:///Users/u/Code/xyz-agent/apps/electron/resources/extensions/@zhushanwen/pi-session-reader/index.mjs',
+      'file:///Users/u/Code/taiji/extensions/universal/session-reader/src/index.ts',
+      'file:///Users/u/Code/taiji/apps/electron/resources/extensions/@zhushanwen/pi-session-reader/index.mjs',
     ]) {
       const r = detectEnvironment(signals({ bundleUrl: url }))
       expect(r.distribution, `${url} 应判 dev`).toBe('dev')
@@ -160,48 +160,48 @@ describe('detectEnvironment distribution（bundle 路径三态）', () => {
 })
 
 describe('detectEnvironment dataDir 推导', () => {
-  it('托管：XYZ_AGENT_DATA_DIR 优先于 PI_CODING_AGENT_DIR 剥层', () => {
+  it('托管：TAIJI_AGENT_DATA_DIR 优先于 PI_CODING_AGENT_DIR 剥层', () => {
     const r = detectEnvironment(
       signals({
         env: {
-          [XYZ_AGENT_EXT_LOG_ENV]: '1',
-          [PI_CODING_AGENT_DIR_ENV]: '/data/.xyz-agent/pi/agent',
-          [XYZ_AGENT_DATA_DIR_ENV]: '/data/.xyz-agent',
+          [TAIJI_AGENT_EXT_LOG_ENV]: '1',
+          [PI_CODING_AGENT_DIR_ENV]: '/data/.taiji/pi/agent',
+          [TAIJI_AGENT_DATA_DIR_ENV]: '/data/.taiji',
         },
       }),
     )
-    expect(r.kind).toBe('xyz-agent')
-    expect(r.dataDir).toBe('/data/.xyz-agent')
-    expect(r.evidence.join('\n')).toContain(`来源：${XYZ_AGENT_DATA_DIR_ENV}`)
+    expect(r.kind).toBe('taiji')
+    expect(r.dataDir).toBe('/data/.taiji')
+    expect(r.evidence.join('\n')).toContain(`来源：${TAIJI_AGENT_DATA_DIR_ENV}`)
   })
 
   it('托管：无 DATA_DIR 时按布局剥层——新布局剥一层、旧布局剥两层', () => {
     const newLayout = detectEnvironment(
       signals({
         env: {
-          [XYZ_AGENT_EXT_LOG_ENV]: '1',
-          [PI_CODING_AGENT_DIR_ENV]: '/data/.xyz-agent/agent',
+          [TAIJI_AGENT_EXT_LOG_ENV]: '1',
+          [PI_CODING_AGENT_DIR_ENV]: '/data/.taiji/agent',
         },
       }),
     )
-    expect(newLayout.dataDir).toBe('/data/.xyz-agent')
+    expect(newLayout.dataDir).toBe('/data/.taiji')
 
     const oldLayout = detectEnvironment(
       signals({
         env: {
-          [XYZ_AGENT_EXT_LOG_ENV]: '1',
-          [PI_CODING_AGENT_DIR_ENV]: '/data/.xyz-agent/pi/agent',
+          [TAIJI_AGENT_EXT_LOG_ENV]: '1',
+          [PI_CODING_AGENT_DIR_ENV]: '/data/.taiji/pi/agent',
         },
       }),
     )
-    expect(oldLayout.dataDir).toBe('/data/.xyz-agent')
+    expect(oldLayout.dataDir).toBe('/data/.taiji')
   })
 
-  it('standalone：即使 XYZ_AGENT_DATA_DIR 被设置也恒 undefined', () => {
+  it('standalone：即使 TAIJI_AGENT_DATA_DIR 被设置也恒 undefined', () => {
     const r = detectEnvironment(
       signals({
         env: {
-          [XYZ_AGENT_DATA_DIR_ENV]: '/data/.xyz-agent',
+          [TAIJI_AGENT_DATA_DIR_ENV]: '/data/.taiji',
         },
       }),
     )
@@ -215,15 +215,15 @@ describe('detectEnvironment evidence', () => {
     ['全信号缺失', signals({})],
     ['托管全信号', signals({
       env: {
-        [XYZ_AGENT_EXT_LOG_ENV]: '1',
-        [PI_CODING_AGENT_DIR_ENV]: '/data/.xyz-agent/agent',
-        [XYZ_AGENT_DATA_DIR_ENV]: '/data/.xyz-agent',
+        [TAIJI_AGENT_EXT_LOG_ENV]: '1',
+        [PI_CODING_AGENT_DIR_ENV]: '/data/.taiji/agent',
+        [TAIJI_AGENT_DATA_DIR_ENV]: '/data/.taiji',
       },
       bundleUrl:
         'file:///Applications/TaiJi.app/Contents/Resources/extensions/@zhushanwen/pi-session-reader/index.mjs',
     })],
-    ['EXT_LOG 孤置', signals({ env: { [XYZ_AGENT_EXT_LOG_ENV]: '1' } })],
-    ['agentDir 孤置', signals({ env: { [PI_CODING_AGENT_DIR_ENV]: '/data/.xyz-agent/agent' } })],
+    ['EXT_LOG 孤置', signals({ env: { [TAIJI_AGENT_EXT_LOG_ENV]: '1' } })],
+    ['agentDir 孤置', signals({ env: { [PI_CODING_AGENT_DIR_ENV]: '/data/.taiji/agent' } })],
     ['bundleUrl 缺失', signals({})],
   ]
 
@@ -238,20 +238,20 @@ describe('detectEnvironment evidence', () => {
     const r = detectEnvironment(
       signals({
         env: {
-          [XYZ_AGENT_EXT_LOG_ENV]: '0',
-          [PI_CODING_AGENT_DIR_ENV]: '/data/.xyz-agent/pi/agent',
+          [TAIJI_AGENT_EXT_LOG_ENV]: '0',
+          [PI_CODING_AGENT_DIR_ENV]: '/data/.taiji/pi/agent',
         },
-        agentDir: '/data/.xyz-agent/pi/agent',
+        agentDir: '/data/.taiji/pi/agent',
       }),
     )
     const joined = r.evidence.join('\n')
     // 未命中信号：原文 + 未命中注记
-    expect(joined).toContain(`${XYZ_AGENT_EXT_LOG_ENV}='0' → 未命中`)
+    expect(joined).toContain(`${TAIJI_AGENT_EXT_LOG_ENV}='0' → 未命中`)
     // 命中信号：原文 + 匹配注记
-    expect(joined).toContain(`${PI_CODING_AGENT_DIR_ENV}='/data/.xyz-agent/pi/agent'`)
+    expect(joined).toContain(`${PI_CODING_AGENT_DIR_ENV}='/data/.taiji/pi/agent'`)
     expect(joined).toContain('形态匹配')
     // 第三条输入：agentDir 透传记录
-    expect(joined).toContain(`agentDir='/data/.xyz-agent/pi/agent'`)
+    expect(joined).toContain(`agentDir='/data/.taiji/pi/agent'`)
     // 判定结论行
     expect(joined).toContain('standalone-pi')
   })

package/src/__tests__/family.test.ts

@@ -107,13 +107,6 @@ describe('buildFamilyIndex', () => {
     expect(index.childrenOf.get('aaa')?.[0].sessionId).toBe('bbb')
   })
 
-  it('parentSession 直接是 sessionId 也兼容（简化 fixture）', () => {
-    const headers = [header('aaa'), header('bbb', { parentSession: 'aaa' })]
-    const index = buildFamilyIndex(headers, [], new Map())
-
-    expect(index.childrenOf.get('aaa')?.[0].sessionId).toBe('bbb')
-  })
-
   it('parentSession 反查不到父 → 该 entry 不进 childrenOf（不报错）', () => {
     const headers = [header('bbb', { parentSession: '/missing.jsonl' })]
     const index = buildFamilyIndex(headers, [], new Map())

package/src/__tests__/find.test.ts

@@ -133,7 +133,7 @@ async function makeSubagentSession(
 describe('findSessions', () => {
   let agentDir: string
   let slugDir: string
-  /** subagent fixture 目录（模拟 subagents/<cwd编码>/sessions/ 结构，roots.listSubagentSessions 扫描路径） */
+  /** subagent fixture 目录（模拟 subagents/<cwd编码>/sessions/ 结构，resolveSessionRoots [subagent] 根扫描路径） */
   let saDir: string
 
   let recordsDir: string
@@ -578,7 +578,7 @@ describe('findSessions', () => {
 describe('u11 标题元数据（metadataProvider 注入，§6.6）', () => {
   let root: string
   let agentDir: string
-  /** 平铺 main 根（xyz-agent 形态：session 直在 sessions/ 下，[default] 根无子目录） */
+  /** 平铺 main 根（taiji 形态：session 直在 sessions/ 下，[default] 根无子目录） */
   let flatMain: string
   /** legacy 根（dirname(agentDir)/sessions） */
   let legacyDir: string
@@ -705,8 +705,8 @@ describe('u11 标题元数据（metadataProvider 注入，§6.6）', () => {
     await mkdir(legacyDir, { recursive: true })
     const provider = vi.fn(async (dir: string) =>
       dir === flatMain
-        ? [{ path: pathA, id: 'dup-id-0001', cwd: '/demo', name: '旧标题', modified: 1000 }]
-        : [{ path: pathA, id: 'dup-id-0001', cwd: '/demo', name: '新标题', modified: 2000 }],
+        ? [{ path: pathA, id: 'dup-id-0001', cwd: '/demo', name: '旧标题', modified: new Date(1000) }]
+        : [{ path: pathA, id: 'dup-id-0001', cwd: '/demo', name: '新标题', modified: new Date(2000) }],
     )
     const { matches } = await findSessions('新标题', agentDir, { metadataProvider: provider })
     expect(provider).toHaveBeenCalledTimes(2) // 两个平铺存在的根各一次
@@ -753,8 +753,8 @@ describe('u11 标题元数据（metadataProvider 注入，§6.6）', () => {
     const provider = vi.fn(async (dir: string) =>
       dir === flatMain
         ? [
-            { path: pNew1, id: 'recent-new-1', cwd: '/demo', name: '最新标题一', modified: (base + 300) * 1000 },
-            { path: pNew2, id: 'recent-new-2', cwd: '/demo', name: '最新标题二', modified: (base + 200) * 1000 },
+            { path: pNew1, id: 'recent-new-1', cwd: '/demo', name: '最新标题一', modified: new Date((base + 300) * 1000) },
+            { path: pNew2, id: 'recent-new-2', cwd: '/demo', name: '最新标题二', modified: new Date((base + 200) * 1000) },
           ]
         : [],
     )

package/src/__tests__/index.test.ts

@@ -169,7 +169,7 @@ describe('sessionReaderExtension - execute 信号包采集（U3：ctx 全形态
   })
 
   it('u11：execute 构造 metadataProvider 接 SessionManager.listAll——keyword 标题命中端到端', async () => {
-    // fixture：平铺 main 根（xyz-agent 形态），session 首消息不含 query，标题经 mock listAll 注入
+    // fixture：平铺 main 根（taiji 形态），session 首消息不含 query，标题经 mock listAll 注入
     const tmp = await mkdtemp(join(tmpdir(), 'index-u11-'))
     try {
       const agentDir = join(tmp, 'agent')

package/src/__tests__/real-data.ts

@@ -1,5 +1,6 @@
 import { existsSync } from 'node:fs'
 import { execSync } from 'node:child_process'
+import { homedir } from 'node:os'
 import { join } from 'node:path'
 
 /**
@@ -13,8 +14,8 @@ import { join } from 'node:path'
  * 本文件无 .test.ts 后缀，vitest include 只收集 `src/__tests__/` 下以 .test.ts 结尾的文件，不收集本文件。
  */
 
-/** 真实 pi agent 目录（本机），用于集成测试。 */
-export const REAL_AGENT_DIR = '/Users/zhushanwen/.pi/agent'
+/** 真实 pi agent 目录（pi 官方家目录布局，随宿主 homedir 推导），用于集成测试。 */
+export const REAL_AGENT_DIR = join(homedir(), '.pi', 'agent')
 
 /**
  * 全量扫描类真实数据用例的统一超时标定（90s）。
@@ -22,7 +23,7 @@ export const REAL_AGENT_DIR = '/Users/zhushanwen/.pi/agent'
  * 这类用例遍历本机 ~/.pi/agent 全量会话语料（实测 4600+ 文件），空载单用例已需 6-10s；
  * 38 包并行全量测试时 CPU/IO 争抢可降速 3-4 倍，30s 标定必假红。90s ≈ 空载 9 倍余量，
  * 仍能兜住真正的挂死。仅用于遍历全量语料的用例（findSessions / buildFamilyFromFs /
- * listMainSessions 等）；读已知单文件的用例不需要放宽。
+ * resolveSessionRoots 等）；读已知单文件的用例不需要放宽。
  */
 export const REAL_DATA_TIMEOUT_MS = 90_000
 
@@ -31,13 +32,25 @@ export const E6 = '019e6c96-0a0c-74b8-a73f-d1854d88e2a7'
 /** 真实 fork 家族根（fork 子代 019fe632，隔代 subagent 019fe635 挂在 019fe632 下）。 */
 export const FAM = '019fe620-8ae1-78a7-b76a-43a1ba4cc3c7'
 
-/** E6 的完整文件路径（parser/turns/render 直接 parseSessionFile 用）。 */
-export const REAL_SESSION = join(
-  REAL_AGENT_DIR,
-  'sessions',
-  '--Users-zhushanwen-Code-xyz-agent-workspace-feat-plugin-arch-3--',
-  `2026-05-28T03-17-12-844Z_${E6}.jsonl`,
-)
+/**
+ * E6 的完整文件路径（parser/turns/render 直接 parseSessionFile 用）。
+ * 按 sid 运行时定位而非硬编码宿主 workspace 目录名：真实文件挂在哪个 slug 目录随采集机器而异，
+ * 硬编码会绑死本机路径形态；定位不到时回落相对布局，由下方 HAS_REAL_SESSION 守卫 skip。
+ */
+export const REAL_SESSION = (() => {
+  const fallback = join(REAL_AGENT_DIR, 'sessions', `2026-05-28T03-17-12-844Z_${E6}.jsonl`)
+  if (!existsSync(REAL_AGENT_DIR)) return fallback
+  try {
+    return (
+      execSync(
+        `find ${REAL_AGENT_DIR}/sessions -name '*${E6}*' -name '*.jsonl' ! -name '*.finalized' 2>/dev/null | head -1`,
+        { encoding: 'utf8' },
+      ).trim() || fallback
+    )
+  } catch {
+    return fallback
+  }
+})()
 
 /** 同步探测真实 session 文件是否存在（不存在则 skip，避免在无该数据的机器上硬失败）。 */
 export function hasRealSession(sid: string): boolean {

package/src/__tests__/render.test.ts

@@ -90,6 +90,8 @@ describe('renderOutline', () => {
     // thinking 'secret'(6B) + toolResult 'output'(6B)
     expect(b.omittedBytes).toBe(12)
     expect(result.truncated).toBeUndefined()
+    // E7 行渲染统一：lines 随结果返回，与 turns 一一对应（预算度量 = 展示行同一份）
+    expect(result.lines).toEqual(['T000 · do something · bash×2,read×2 · → sure · [12B omitted]'])
   })
 
   it('2a. 降级：单行 toolSummary 过长超 perTurnBudget → 砍 toolSummary，保 userBrief 骨架', () => {
@@ -108,6 +110,25 @@ describe('renderOutline', () => {
       expect(b.toolSummary).toBe('') // 被砍（降级）
       expect(b.userBrief).toBe('u'.repeat(10)) // 骨架保留
     }
+    // E7：降级后的渲染行（骨架形态）与 briefs 字段同步——行内无 → 结论段、无工具聚合段
+    expect(result.lines).toHaveLength(3)
+    expect(result.lines).toEqual(['T000 · uuuuuuuuuu', 'T001 · uuuuuuuuuu', 'T002 · uuuuuuuuuu'])
+    expect(result.truncated).toBeUndefined()
+  })
+
+  it('2b. 降级（砍 assistantBrief 档）：行内 → 结论段消失、toolSummary 保留，与改前语义一致', () => {
+    // budget=20 → perTurnCharBudget=80；level 0 行 = T000 · u*10 · bash×2 · → a*80… ≈112 > 80
+    // → 砍 assistantBrief 后 ≈26 ≤ 80 停（S3：该档形态与改前 handler 侧渲染降级后 briefs 等价）
+    const t = turn(
+      0,
+      [uEntry('U', 'u'.repeat(10)), aEntry('A', 'a'.repeat(100), [{ name: 'bash' }, { name: 'bash' }])],
+      { userEntry: uEntry('U', 'u'.repeat(10)) },
+    )
+    const result = renderOutline([t], emptyTree(), { budget: 20 })
+
+    expect(result.turns[0].assistantBrief).toBe('') // 被砍
+    expect(result.turns[0].toolSummary).toBe('bash×2') // 保留
+    expect(result.lines).toEqual(['T000 · uuuuuuuuuu · bash×2'])
     expect(result.truncated).toBeUndefined()
   })
 
@@ -122,6 +143,8 @@ describe('renderOutline', () => {
 
     expect(result.truncated).toBe(3)
     expect(result.turns).toHaveLength(2)
+    // E7：lines 与 turns 同步截短（truncateToTotalBudget 双数组一致）
+    expect(result.lines).toHaveLength(2)
   })
 
   it('4. toolSummary 聚合：同名计数 ×N，不同名逗号分隔', () => {
@@ -168,6 +191,19 @@ describe('renderOutline', () => {
     expect(withoutBranches.turns[0].branch).toBeUndefined()
   })
 
+  it('7b. E7 旁支标记统一：渲染行 `[旁支 N entries]`（N = 该 forkPoint 下旁支子树 entry 数）', () => {
+    // branches: U → 3 entries 旁支子树（E7/D3：outline 与 export 两条路径共用此形态）
+    const tree: TreeView = { leafPath: ['U'], branches: new Map([['U', 3]]), orphans: [] }
+    const userEntry = uEntry('U', 'hi')
+    const turns = [turn(0, [userEntry], { userEntry })]
+
+    const result = renderOutline(turns, tree, { allBranches: true })
+    expect(result.lines).toEqual(['T000 · hi · [旁支 3 entries]'])
+    // branchSize 缺失（allBranches:false）不标旁支
+    const noBranch = renderOutline(turns, tree, { allBranches: false })
+    expect(noBranch.lines).toEqual(['T000 · hi'])
+  })
+
   it.skipIf(!HAS_REAL_SESSION)('8. 真实 019e6c96：outline tokenEstimate <= 1500 + assistantBrief/toolSummary 非空（v2 O1）', async () => {
     // v2 O1：加 assistantBrief + 修 toolSummary bug 后 outline 变长，阈值 600→1500（design §3.3 D4）
     const parsed = await parseSessionFile(REAL_SESSION)
@@ -310,7 +346,6 @@ describe('renderDetail', () => {
     expect(summary.summary).toMatch(/^read: f\.ts \(\d+KB\)$/)
     expect(summary.totalLines).toBe(4)
     expect(summary.headLines).toContain('line1')
-    expect(summary.fullEntry.message?.role).toBe('toolResult')
 
     // includeToolResult 全文：返回原 Entry
     const full = renderDetail([t], { includeToolResult: true })