@zhushanwen/pi-session-reader 0.10.4 → 0.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/pi-session-reader",
-  "version": "0.10.4",
+  "version": "0.12.0",
   "type": "module",
   "main": "index.ts",
   "taiji": {
@@ -16,15 +16,16 @@
     "pi-package"
   ],
   "dependencies": {
-    "@zhushanwen/pi-extension-logger": "0.6.2",
+    "@zhushanwen/extension-protocol": "0.22.0",
     "@zhushanwen/pi-ext-guards": "0.5.0",
+    "@zhushanwen/pi-extension-logger": "0.6.2",
     "@zhushanwen/session-core": "0.12.0",
     "@zhushanwen/zcode-session-source": "0.2.7"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.9",
     "vitest": "^4.1.8",
-    "@zhushanwen/subagent-core": "1.5.2"
+    "@zhushanwen/subagent-core": "1.6.0"
   },
   "files": [
     "index.ts",
@@ -32,16 +33,16 @@
     "vitest.config.ts"
   ],
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "^1.0.0",
     "@earendil-works/pi-ai": "^1.0.0",
+    "@earendil-works/pi-coding-agent": "^1.0.0",
     "@earendil-works/pi-tui": "^1.0.0",
     "typebox": "1.3.27"
   },
   "peerDependenciesMeta": {
-    "@earendil-works/pi-coding-agent": {
+    "@earendil-works/pi-ai": {
       "optional": true
     },
-    "@earendil-works/pi-ai": {
+    "@earendil-works/pi-coding-agent": {
       "optional": true
     },
     "@earendil-works/pi-tui": {

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

@@ -21,16 +21,16 @@ import {
 } from '@zhushanwen/subagent-core/execution/assembly/path-encoding.ts'
 
 /**
- * W4 跨包集成测试（[collect 退役] 改造保留：原「E1 落标出口产出 manifest」驱动面
- * 随 sync 批机制删除，现行真实投影出口 = store 重建通道 rebuildIndexes——manifest
- * 是可丢缓存，boot 全量腿按磁盘子文件锚幂等补缺）。「subagent-core 真实 tmpdir
+ * 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；本文件
- * manifest 内容必须来自投影代码路径——subagent-core 侧真实驱动（真实 RecordStore
+ * manifest 内容必须来自派生视图代码路径——subagent-core 侧真实驱动（真实 RecordStore
  * 落盘 register/轮终 entry → initSession 内 orphan 覆写真实跑 → rebuildIndexes
- * derivedManifestRecord 投影真写 records/<sa-id>.json），session-reader 侧零 mock
+ * derivedManifestRecord 派生视图真写 records/<sa-id>.json），session-reader 侧零 mock
  * 读同一 tmpdir 断言反查闭环。
  *
  * 构造形态取自 subagent-core sync-collect-recovery.test.ts 的 kill -9 同构主用例
@@ -42,17 +42,14 @@ import {
  * mkdtemp(tmpdir) 自建自删（红线：零真实数据目录触碰）。
  */
 
-/** 剥身份/relay env（subagent-core 测试纪律同款）：身份 env 会让 service 误判自己是
- *  子进程跳过恢复扫描，relay env 改道 pi-invocation 的 relay 分支。 */
+/** 剥身份 env（subagent-core 测试纪律同款）：身份 env 会让 service 误判自己是
+ *  子进程跳过恢复扫描。 */
 const ENV_KEYS_TO_STRIP = [
   'PI_SUBAGENT_ROOT_SESSION_ID',
   'PI_SUBAGENT_SELF_RECORD_ID',
   'PI_SUBAGENT_DEPTH',
   'PI_SUBAGENT_ROOT_CWD',
   'PI_SUBAGENT_FORK_DEPTH',
-  'TAIJI_SUBAGENT_RELAY_SOCKET',
-  'TAIJI_SUBAGENT_RELAY_NODE',
-  'TAIJI_SUBAGENT_RELAY_SCRIPT',
 ] as const
 
 const ROOT_SESSION = 'root-cross-pkg'
@@ -119,30 +116,42 @@ interface MemberSeed {
 }
 
 describe('跨包集成：subagent-core 重建 manifest → session-reader result 反查（W4）', () => {
+  let dataDir: string
   let agentDir: string
   let mainFile: string
   let services: SubagentService[]
 
   beforeEach(() => {
     for (const k of ENV_KEYS_TO_STRIP) delete process.env[k]
-    agentDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cross-pkg-subagent-core-'))
-    fs.mkdirSync(getSubagentSessionDir(agentDir, agentDir), { recursive: true })
+    // 生产拓扑复刻（[session-store-layout-inversion 域 9]）：agentDir = <dataDir>/agent
+    //（session-reader 的 agentDir 语义），subagent-core 写侧经新公式落存储树
+    // <dataDir>/ext-sessions/<rootSid>/subagents/——listRecordManifests 双根扫描的新根
+    //（dirname(agentDir)/ext-sessions）与写侧落点相遇
+    dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cross-pkg-subagent-core-'))
+    agentDir = path.join(dataDir, 'agent')
+    fs.mkdirSync(agentDir, { recursive: true })
+    fs.mkdirSync(getSubagentSessionDir(ROOT_SESSION, dataDir), { recursive: true })
+    // 恢复 service 的内部 store 经 getSubagentRecordsDir(resolveStoreRootSessionId())
+    //（env dataDir 兜底）解析——钉 env 把写删目标收进本 mkdtemp 树（自建自删红线，
+    // subagent-core 同族测试先例 subagent-service-model-switch.test.ts）
+    process.env['TAIJI_AGENT_DATA_DIR'] = dataDir
     mainFile = path.join(agentDir, 'main-session.jsonl')
     services = []
   })
 
   afterEach(() => {
     for (const s of services) s.dispose()
-    fs.rmSync(agentDir, { recursive: true, force: true, maxRetries: 5, retryDelay: 20 })
+    delete process.env['TAIJI_AGENT_DATA_DIR']
+    fs.rmSync(dataDir, { recursive: true, force: true, maxRetries: 5, retryDelay: 20 })
   })
 
   /** 真实 RecordStore（写文件 pi：种子经真实 register 通路 + v2 条目构造器
    *  （toRegisteredEntryData，[v1 兼容层删除] v1 快照写点 toSubagentRecordEntry 已删）
-   *  落主文件）。 */
+   *  落主文件）。[u-subagent dir 晚绑定] store/manifest 构造 = 目录取值函数。 */
   function makeSeedStore(): RecordStore {
     return new RecordStore(
-      getSubagentSessionDir(agentDir, agentDir),
-      new ManifestStore(getSubagentRecordsDir(agentDir, agentDir)),
+      () => getSubagentSessionDir(ROOT_SESSION, dataDir),
+      new ManifestStore(() => getSubagentRecordsDir(ROOT_SESSION, dataDir)),
       makeWritingPi(mainFile),
     )
   }
@@ -172,7 +181,7 @@ describe('跨包集成：subagent-core 重建 manifest → session-reader result
    *  形态同 subagent-core W1 用例）——**不写**三 sidecar，保证恢复走
    *  finalizeOrphanRecord 真实路径。 */
   function writeChildSessionFile(m: MemberSeed): string {
-    const childFile = path.join(getSubagentSessionDir(agentDir, agentDir), `${m.id}.jsonl`)
+    const childFile = path.join(getSubagentSessionDir(ROOT_SESSION, dataDir), `${m.id}.jsonl`)
     const ts = new Date(1000).toISOString()
     const lines: string[] = [
       JSON.stringify({ type: 'session', version: 3, id: `sess-${m.id}`, timestamp: ts, cwd: agentDir }),
@@ -202,7 +211,7 @@ describe('跨包集成：subagent-core 重建 manifest → session-reader result
         data: { id: m.id, agent: '/agents/worker.md', mode: 'background', task: 'cross-package task', startedAt: 1000, rootSessionId: ROOT_SESSION, depth: 0 },
       }),
       JSON.stringify({
-        // 登记 §3.3：主/子文件条目面 = v2 注册条（身份域；运行态事实源在 record 事件文件）。
+        // 登记 §3.3：主/子文件条目范围 = v2 注册条（身份域；运行态事实源在 record 事件文件）。
         type: 'custom', id: `cid-${m.id}-2`, parentId: `cid-${m.id}-1`, timestamp: ts,
         customType: 'subagent-record',
         data: {
@@ -247,7 +256,7 @@ describe('跨包集成：subagent-core 重建 manifest → session-reader result
   }
 
   /** 全链路驱动：种子 → 恢复 service（orphan 覆写）→ rebuildIndexes（现行 boot
-   *  全量重建通道——derivedManifestRecord 投影真写 manifest）。返回子 session 文件
+   *  全量重建通道——derivedManifestRecord 派生视图真写 manifest）。返回子 session 文件
    *  路径表。[collect 退役] 原 E1 落标出口（recoverSyncCollectBatch →
    *  appendBatchFinalizedEntry）随 sync 批机制删除。 */
   async function driveManifestRebuild(members: MemberSeed[]): Promise<Map<string, string>> {
@@ -259,11 +268,11 @@ describe('跨包集成：subagent-core 重建 manifest → session-reader result
     }
     const service = makeRecoveryService()
     service.rebuildIndexes()
-    // derivedManifestRecord 投影为同步落盘——全成员 manifest 即刻可见（W3 投影
+    // derivedManifestRecord 派生视图为同步落盘——全成员 manifest 即刻可见（W3 派生视图
     // 代码路径的产物，非手工预写）。
     for (const m of members) {
       expect(
-        fs.existsSync(path.join(getSubagentRecordsDir(agentDir, agentDir), `${m.id}.json`)),
+        fs.existsSync(path.join(getSubagentRecordsDir(ROOT_SESSION, dataDir), `${m.id}.json`)),
         `manifest of ${m.id}`,
       ).toBe(true)
     }
@@ -280,12 +289,12 @@ describe('跨包集成：subagent-core 重建 manifest → session-reader result
     }
     const childFiles = await driveManifestRebuild([m])
 
-    // manifest 内容断言（rebuildIndexes → derivedManifestRecord 投影路径的产物，
-    // 非手工预写）：sessionFile 来自 W1 投影扩展。[U2/U3 两态桥接] 恢复链覆写后成员
-    // 处于 idle（重建单规则）、无旧终态遗留位 → legacy status 如实投影 "running"
+    // 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'),
+      fs.readFileSync(path.join(getSubagentRecordsDir(ROOT_SESSION, dataDir), 'sa-cross-1.json'), 'utf-8'),
     ) as Record<string, unknown>
     expect(manifest).toMatchObject({
       id: 'sa-cross-1',

package/src/__tests__/entry-anchor.test.ts

@@ -370,13 +370,13 @@ describe('候选文件列表：顺序回退 + 命中即止（越界语义由调
   })
 })
 
-describe('协议字面量漂移守卫（跨包契约）', () => {
+describe('协议字面量漂移检查（跨包契约）', () => {
   it('entry-anchor 本地 customType 字面量 === subagent-core 写侧单源', () => {
-    // 源码本地持有磁盘协议字符串（生产依赖面不引 subagent-core），此处锚定两侧同值
+    // 源码本地持有磁盘协议字符串（生产依赖范围不引 subagent-core），此处锚定两侧同值
     expect(SUBAGENT_RECORD_CUSTOM_TYPE).toBe('subagent-record')
   })
 
-  it('entry-anchor 本地 v2 认识版本 === subagent-core 写侧单源（写侧再升版本本守卫先红）', () => {
+  it('entry-anchor 本地 v2 认识版本 === subagent-core 写侧单源（写侧再升版本本检查先红）', () => {
     expect(SUBAGENT_RECORD_ENTRY_VERSION).toBe(2)
   })
 })