@zhushanwen/pi-scheduler 0.4.0 → 0.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/pi-scheduler",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "type": "module",
   "main": "index.ts",
   "xyz-agent": {
@@ -45,7 +45,8 @@
     }
   },
   "dependencies": {
-    "@xyz-agent/session-delivery": "0.2.0"
+    "@xyz-agent/session-delivery": "0.3.0",
+    "@zhushanwen/pi-extension-logger": "0.3.0"
   },
   "scripts": {
     "test": "vitest run",

package/src/__tests__/U4-DISPATCH_INFLIGHT.test.ts

@@ -2,19 +2,21 @@
  * U4_DISPATCH_INFLIGHT：调用方 in-flight 守卫验收
  *
  * 两个子用例：
- * (1) 同一 taskId 的 dispatchTask 并发调用 → 第二次立即返回 false + console.warn
+ * (1) 同一 taskId 的 dispatchTask 并发调用 → 第二次立即返回 false + logger.warn
  * (2) 第一次 dispatchTask 完成后（finally 清除）→ 第二次正常执行
  *
  * 断言 delivery send 调用总次数为 1（拦截场景）或 2（串行场景）。
  */
 import { describe, expect, it, vi } from 'vitest'
 
+import { getLogger } from '@zhushanwen/pi-extension-logger'
+
 import { MockSchedulerBackend } from '../backend.js'
 import { SchedulerRuntime } from '../runtime.js'
 
 describe('U4_DISPATCH_INFLIGHT: 调用方 in-flight 守卫', () => {
   it('(1) 同一 taskId 并发 dispatch → 第二次被拦截（send 只调 1 次 + warn）', async () => {
-    const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
+    const warnSpy = vi.spyOn(getLogger('scheduler'), 'warn').mockImplementation(() => {})
 
     // 可控延迟的 sendMessage：让第一次 dispatch 挂起
     let resolveSend: (() => void) | undefined
@@ -80,7 +82,7 @@ describe('U4_DISPATCH_INFLIGHT: 调用方 in-flight 守卫', () => {
   })
 
   it('(3) 非 force + 有 delivery handle 时，in-flight 守卫同样拦截并发 dispatch', async () => {
-    const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
+    const warnSpy = vi.spyOn(getLogger('scheduler'), 'warn').mockImplementation(() => {})
     const backend = new MockSchedulerBackend()
     backend.deliveryHandle = {
       send: vi.fn(),

package/src/__tests__/importer.test.ts

@@ -4,6 +4,16 @@ import * as path from 'node:path'
 
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
 
+// Mock 共享 logger，让 logger.warn 可被 spy（源码已从 console.warn 改为 logger.warn）
+const { loggerMock } = vi.hoisted(() => ({
+  loggerMock: { debug: vi.fn(), warn: vi.fn(), error: vi.fn() },
+}))
+vi.mock('@zhushanwen/pi-extension-logger', () => ({
+  getLogger: () => loggerMock,
+  createLogger: () => loggerMock,
+  setPiHandle: vi.fn(),
+}))
+
 import { getLegacyStorePath, importLegacyStore } from '../importer.js'
 import type { ScheduledTask } from '../types.js'
 
@@ -52,9 +62,8 @@ describe('importLegacyStore', () => {
     vi.mocked(fs.existsSync).mockReturnValue(false)
     vi.mocked(fs.readFileSync).mockReturnValue('{}')
     vi.mocked(fs.unlinkSync).mockImplementation(() => {})
-    // 抑制 importer 的 console.log/warn 输出（断言用 spy）
-    vi.spyOn(console, 'log').mockImplementation(() => {})
-    vi.spyOn(console, 'warn').mockImplementation(() => {})
+    // 清理 logger mock（logger 默认 no-op，无需抑制输出）
+    loggerMock.warn.mockClear()
   })
 
   afterEach(() => {
@@ -101,9 +110,10 @@ describe('importLegacyStore', () => {
     expect(fs.unlinkSync).toHaveBeenCalledTimes(1)
     expect(fs.unlinkSync).toHaveBeenCalledWith(importedPath)
 
-    // 5) 进度日志（console.warn，项目 convention 禁 console.log）
-    expect(console.warn).toHaveBeenCalledWith(
-      expect.stringContaining(`imported 2 legacy tasks from ${importedPath}`),
+    // 5) 进度日志
+    expect(loggerMock.warn).toHaveBeenCalledWith(
+      expect.stringContaining('imported legacy tasks'),
+      expect.objectContaining({ count: 2 }),
     )
   })
 
@@ -177,8 +187,9 @@ describe('importLegacyStore', () => {
     const appendEntry = vi.fn()
 
     expect(() => importLegacyStore(cwd, { appendEntry }, sessionFile)).not.toThrow()
-    expect(console.warn).toHaveBeenCalledWith(
-      expect.stringContaining('[scheduler] import failed'),
+    expect(loggerMock.warn).toHaveBeenCalledWith(
+      expect.stringContaining('import failed'),
+      expect.objectContaining({ error: expect.stringContaining('not valid JSON') }),
     )
     expect(appendEntry).toHaveBeenCalledTimes(0) // parse 失败，无 append
   })
@@ -215,7 +226,10 @@ describe('importLegacyStore', () => {
     // append 已发生，但 unlink 未执行——数据可能仅内存，销毁源文件 = 永久丢失
     expect(appendEntry).toHaveBeenCalledTimes(1)
     expect(fs.unlinkSync).not.toHaveBeenCalled()
-    expect(console.warn).toHaveBeenCalledWith(expect.stringContaining('deferring'))
+    expect(loggerMock.warn).toHaveBeenCalledWith(
+      expect.stringContaining('deferring'),
+      expect.objectContaining({ count: 1 }),
+    )
 
     // 情形1：flush 已发生（sessionFile 出现，.imported 仍在）→ cleanup 删除 .imported
     vi.mocked(fs.existsSync).mockImplementation(p => p === sessionFile || p === importedPath)

package/src/__tests__/index-generation.test.ts

@@ -20,6 +20,16 @@
 import type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent'
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
 
+// Mock 共享 logger，让 logger.warn 可被 spy（源码已从 console.warn 改为 logger.warn）
+const { loggerMock } = vi.hoisted(() => ({
+  loggerMock: { debug: vi.fn(), warn: vi.fn(), error: vi.fn() },
+}))
+vi.mock('@zhushanwen/pi-extension-logger', () => ({
+  getLogger: () => loggerMock,
+  createLogger: () => loggerMock,
+  setPiHandle: vi.fn(),
+}))
+
 // 与 index-session-start.test.ts 同款（MF-3）：mock 掉 importer，装配路径仍被调用、FS 副作用为零。
 vi.mock('../importer.js', () => ({ importLegacyStore: vi.fn(() => vi.fn()) }))
 
@@ -127,7 +137,7 @@ describe('G1: index.ts 代际接线（S9）', () => {
   it('factory 重跑：第二次 factory 执行 + session_start 后，第一代 runtime isCtxStale 为 true 且 tick 前置自停', async () => {
     vi.useFakeTimers()
     vi.setSystemTime(new Date('2026-01-01T00:00:00Z'))
-    const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
+    loggerMock.warn.mockClear()
     try {
       // 第一代：独立 factory 执行 + session_start 装配（runtime1 真实 startScheduler）
       const first = createMockPi()
@@ -156,15 +166,14 @@ describe('G1: index.ts 代际接线（S9）', () => {
       // tick 前置自停：第一代 runtime 的泄漏 timer 在下个 tick 被代际前置检查拦截
       // （G1-b 的生产路径验证：warn "tick stopped" + timer 自停，后续 tick 不再发生）
       await vi.advanceTimersByTimeAsync(TICK_INTERVAL_MS)
-      const warnText = warnSpy.mock.calls.map(c => String(c[0])).join('\n')
+      const warnText = loggerMock.warn.mock.calls.map(c => String(c[0])).join('\n')
       expect(warnText).toContain('tick stopped')
       expect(warnText).not.toContain('tick error')
 
-      const warnCountAfterSelfStop = warnSpy.mock.calls.length
+      const warnCountAfterSelfStop = loggerMock.warn.mock.calls.length
       await vi.advanceTimersByTimeAsync(TICK_INTERVAL_MS * 2) // timer 已停，无新 warn
-      expect(warnSpy.mock.calls.length).toBe(warnCountAfterSelfStop)
+      expect(loggerMock.warn.mock.calls.length).toBe(warnCountAfterSelfStop)
     } finally {
-      warnSpy.mockRestore()
       vi.useRealTimers()
     }
   })

package/src/__tests__/replay.test.ts

@@ -1,5 +1,15 @@
 import { afterEach, describe, expect, it, vi } from 'vitest'
 
+// Mock 共享 logger，让 logger.warn 可被 spy（源码已从 console.warn 改为 logger.warn）
+const { loggerMock } = vi.hoisted(() => ({
+  loggerMock: { debug: vi.fn(), warn: vi.fn(), error: vi.fn() },
+}))
+vi.mock('@zhushanwen/pi-extension-logger', () => ({
+  getLogger: () => loggerMock,
+  createLogger: () => loggerMock,
+  setPiHandle: vi.fn(),
+}))
+
 import { replayFoldEntries, type SchedulerEntryLike } from '../replay.js'
 import type { SchedulerEntryOp, TaskSnapshot } from '../types.js'
 
@@ -141,8 +151,8 @@ describe('replayFoldEntries', () => {
   })
 
   // ── TC-W-GETENTRIES-FALLBACK：getEntries 异常兜底（gap4）──
-  it('TC-W-GETENTRIES-FALLBACK: 迭代器抛错时 console.warn + 返回空 Map，不崩溃', () => {
-    const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
+  it('TC-W-GETENTRIES-FALLBACK: 迭代器抛错时 logger.warn + 返回空 Map，不崩溃', () => {
+    loggerMock.warn.mockClear()
     // 构造迭代时抛错的 iterable（模拟 session JSONL 损坏）
     const throwingIterable: Iterable<SchedulerEntryLike> = {
       [Symbol.iterator]() {
@@ -158,11 +168,10 @@ describe('replayFoldEntries', () => {
 
     const result = replayFoldEntries(throwingIterable, '/s.json')
     expect(result.size).toBe(0)
-    expect(warnSpy).toHaveBeenCalled()
-    const msg = warnSpy.mock.calls[0]![0] as string
+    expect(loggerMock.warn).toHaveBeenCalled()
+    const msg = loggerMock.warn.mock.calls[0]![0] as string
     expect(msg).toContain('replayFoldEntries failed')
-    expect(msg).toContain('JSONL corrupted')
-    warnSpy.mockRestore()
+    expect(loggerMock.warn.mock.calls[0]![1]).toEqual(expect.objectContaining({ error: expect.stringContaining('JSONL corrupted') }))
   })
 
   // ── gap2 补强：advance 后 lastStatus/lastRunAt/runCount/history 全恢复 ──
@@ -258,7 +267,7 @@ describe('replayFoldEntries', () => {
   // ── MF-2：守卫按变体校验必填字段——损坏 entry 只跳过该条，不清空全部任务 ──
   it('MF-2: op 合法但缺必填字段的损坏 entry 被跳过，其余任务保留', () => {
     const session = '/s.json'
-    const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
+    loggerMock.warn.mockClear()
     const entries: SchedulerEntryLike[] = [
       { type: 'custom', customType: 'pi-scheduler:task', data: { op: 'upsert' } }, // 缺 taskId+task
       { type: 'custom', customType: 'pi-scheduler:task', data: { op: 'upsert', taskId: 'A' } }, // 缺 task
@@ -272,12 +281,11 @@ describe('replayFoldEntries', () => {
     const result = replayFoldEntries(entries, session)
     expect(result.size).toBe(1)
     expect(result.get('A')).toBeDefined()
-    warnSpy.mockRestore()
   })
 
   it('MF-2: upsert task 嵌套数据损坏（history 非数组）→ 逐条跳过该 entry，其余任务保留', () => {
     const session = '/s.json'
-    const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
+    loggerMock.warn.mockClear()
     const entries: SchedulerEntryLike[] = [
       {
         type: 'custom',
@@ -297,10 +305,9 @@ describe('replayFoldEntries', () => {
     expect(result.get('GOOD')).toBeDefined()
     expect(result.has('BAD')).toBe(false)
     // 逐条跳过 warn（非外层整体 catch 的 replayFoldEntries failed warn）
-    expect(warnSpy).toHaveBeenCalled()
-    const msg = warnSpy.mock.calls[0]![0] as string
+    expect(loggerMock.warn).toHaveBeenCalled()
+    const msg = loggerMock.warn.mock.calls[0]![0] as string
     expect(msg).toContain('skipping corrupted scheduler entry')
-    warnSpy.mockRestore()
   })
 
   afterEach(() => {

package/src/__tests__/runtime.test.ts

@@ -1,6 +1,16 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
 import type { DeliveryMessage } from '@xyz-agent/session-delivery'
 
+// Mock 共享 logger，让 logger.warn 可被 spy（源码已从 console.warn 改为 logger.warn）
+const { loggerMock } = vi.hoisted(() => ({
+  loggerMock: { debug: vi.fn(), warn: vi.fn(), error: vi.fn() },
+}))
+vi.mock('@zhushanwen/pi-extension-logger', () => ({
+  getLogger: () => loggerMock,
+  createLogger: () => loggerMock,
+  setPiHandle: vi.fn(),
+}))
+
 import { MockSchedulerBackend } from '../backend.js'
 import { SchedulerRuntime } from '../runtime.js'
 
@@ -237,7 +247,7 @@ describe('SchedulerRuntime', () => {
     })
 
     it('sendMessage 挂起期间下一 tick 同任务被跳过：不双注入、warn in-flight、完成后 runCount=1', async () => {
-      const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
+      loggerMock.warn.mockClear()
       let resolveSend: (() => void) | undefined
       const sendPromise = new Promise<void>(resolve => { resolveSend = resolve })
       backend.sendMessage = vi.fn(() => sendPromise)
@@ -254,7 +264,7 @@ describe('SchedulerRuntime', () => {
       // in-flight 守卫 → skip + warn（修复前：同一 prompt 双注入）
       await runtime.tickScheduler()
       expect(backend.sendMessage).toHaveBeenCalledTimes(1)
-      const warnText = warnSpy.mock.calls.map(c => String(c[0])).join('\n')
+      const warnText = loggerMock.warn.mock.calls.map(c => String(c[0])).join('\n')
       expect(warnText).toContain('already in flight')
 
       // 放行挂起的 sendMessage：tick1 正常收尾（状态推进恰好一次）
@@ -263,7 +273,6 @@ describe('SchedulerRuntime', () => {
       expect(backend.sendMessage).toHaveBeenCalledTimes(1)
       expect(task.runCount).toBe(1)
       expect(task.pending).toBe(false)
-      warnSpy.mockRestore()
     })
 
     it('挂起 dispatch 只挡同任务：其他任务在下一 tick 正常 dispatch 不受影响', async () => {
@@ -412,7 +421,7 @@ describe('SchedulerRuntime', () => {
 
     // ── TC-W-APPEND-FAIL：appendEntry 失败捕获（ER-APPEND-FAIL）──
     it('TC-W-APPEND-FAIL: appendEntry 失败不抛、保留内存态、不污染 lastError', async () => {
-      const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
+      loggerMock.warn.mockClear()
       backend.appendError = new Error('pi internal')
 
       // addTask 内 appendEntry 抛错 → 被捕获（console.warn），不 rethrow；内存态已更新（task 仍在）
@@ -421,7 +430,7 @@ describe('SchedulerRuntime', () => {
       expect(task.enabled).toBe(true)
       // appendEntrySafe 不污染业务态（append 失败是 transient，不设 lastError）
       expect(task.lastError).toBeUndefined()
-      expect(warnSpy).toHaveBeenCalled()
+      expect(loggerMock.warn).toHaveBeenCalled()
 
       // tickScheduler 同样不抛：dispatch 成功后 append advance 抛错被捕获，nextRunAt 已推进（内存态正确）
       task.nextRunAt = Date.now() - 1000
@@ -432,7 +441,6 @@ describe('SchedulerRuntime', () => {
       // nextRunAt 已推进到未来（内存态正确，append 失败只丢持久化）
       expect(updated.nextRunAt).toBe(Date.now() + 60000)
       expect(updated.lastError).toBeUndefined() // 不被 append 失败污染
-      warnSpy.mockRestore()
     })
 
     // ── TC-W-ON-AFTER-TICK：onAfterTick 回调（W2）──
@@ -750,7 +758,7 @@ describe('SchedulerRuntime', () => {
     })
 
     it('U1: stale 错误 → warn "tick stopped" + timer 自停，后续 tick 不再发生', async () => {
-      const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
+      loggerMock.warn.mockClear()
       const nowSpy = vi.spyOn(backend, 'now')
       runtime.onAfterTick(() => {
         throw new Error('This extension ctx is stale after session replacement or reload.')
@@ -759,7 +767,7 @@ describe('SchedulerRuntime', () => {
       runtime.startScheduler()
       await vi.advanceTimersByTimeAsync(TICK_INTERVAL_MS) // tick1：stale 抛 → catch 分诊 → 自停
 
-      const warnText = warnSpy.mock.calls.map(c => String(c[0])).join('\n')
+      const warnText = loggerMock.warn.mock.calls.map(c => String(c[0])).join('\n')
       expect(warnText).toContain('tick stopped')
       expect(warnText).not.toContain('tick error')
 
@@ -768,12 +776,11 @@ describe('SchedulerRuntime', () => {
 
       await vi.advanceTimersByTimeAsync(TICK_INTERVAL_MS * 2) // 60s：timer 已停，无新 tick
       expect(nowSpy.mock.calls.length).toBe(countAfterSelfStop) // now 计数不再增长
-      warnSpy.mockRestore()
       nowSpy.mockRestore()
     })
 
     it('U2: 非 stale 错误 → warn "tick error" 且调度继续（advance 两次 now 计数 +2）', async () => {
-      const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
+      loggerMock.warn.mockClear()
       const nowSpy = vi.spyOn(backend, 'now')
       runtime.onAfterTick(() => {
         throw new Error('boom')
@@ -782,7 +789,7 @@ describe('SchedulerRuntime', () => {
       runtime.startScheduler()
       await vi.advanceTimersByTimeAsync(TICK_INTERVAL_MS) // tick1：warn 但不停
 
-      const warnText = warnSpy.mock.calls.map(c => String(c[0])).join('\n')
+      const warnText = loggerMock.warn.mock.calls.map(c => String(c[0])).join('\n')
       expect(warnText).toContain('tick error')
       expect(warnText).not.toContain('tick stopped')
 
@@ -791,7 +798,6 @@ describe('SchedulerRuntime', () => {
 
       await vi.advanceTimersByTimeAsync(TICK_INTERVAL_MS * 2) // 2 个后续 tick 照常
       expect(nowSpy.mock.calls.length).toBe(countAfterFirstTick + 2)
-      warnSpy.mockRestore()
       nowSpy.mockRestore()
     })
 
@@ -830,7 +836,7 @@ describe('SchedulerRuntime', () => {
     })
 
     it('G1-a: in-flight tick 期间代际翻转 + 非文案错误 → warn "tick stopped" + 自停（不依赖 pi 错误文案）', async () => {
-      const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
+      loggerMock.warn.mockClear()
       const nowSpy = vi.spyOn(backend, 'now')
       // tick 内先翻世代（模拟 session 替换交错发生在 dispatch await 窗口），再抛与
       // pi 文案完全无关的错误——旧实现按文案分诊会误判为普通错误继续调度（若 pi 改文案）
@@ -842,7 +848,7 @@ describe('SchedulerRuntime', () => {
       genRuntime.startScheduler()
       await vi.advanceTimersByTimeAsync(TICK_INTERVAL_MS) // tick1：catch 分诊走 G1 代际 → 自停
 
-      const warnText = warnSpy.mock.calls.map(c => String(c[0])).join('\n')
+      const warnText = loggerMock.warn.mock.calls.map(c => String(c[0])).join('\n')
       expect(warnText).toContain('tick stopped')
       expect(warnText).not.toContain('tick error')
 
@@ -851,12 +857,11 @@ describe('SchedulerRuntime', () => {
 
       await vi.advanceTimersByTimeAsync(TICK_INTERVAL_MS * 2) // timer 已停，无新 tick
       expect(nowSpy.mock.calls.length).toBe(countAfterSelfStop)
-      warnSpy.mockRestore()
       nowSpy.mockRestore()
     })
 
     it('G1-b: 代际翻转后泄漏 timer 在下个 tick 前置检查自停——不进入 tick（backend.now 零调用）', async () => {
-      const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
+      loggerMock.warn.mockClear()
       const nowSpy = vi.spyOn(backend, 'now')
       genRuntime.startScheduler()
       // session 替换：代际翻转（F1 未能触达的泄漏 timer 场景；无任何错误发生）
@@ -864,7 +869,7 @@ describe('SchedulerRuntime', () => {
 
       await vi.advanceTimersByTimeAsync(TICK_INTERVAL_MS) // tick1：前置检查命中 → 自停
 
-      const warnText = warnSpy.mock.calls.map(c => String(c[0])).join('\n')
+      const warnText = loggerMock.warn.mock.calls.map(c => String(c[0])).join('\n')
       expect(warnText).toContain('tick stopped')
       expect(warnText).not.toContain('tick error')
       // 前置检查在 tickScheduler 之前拦截：tick 本体未执行（now 零调用，无 dispatch/append）
@@ -872,12 +877,11 @@ describe('SchedulerRuntime', () => {
 
       await vi.advanceTimersByTimeAsync(TICK_INTERVAL_MS * 2) // timer 已停，仍零调用
       expect(nowSpy).not.toHaveBeenCalled()
-      warnSpy.mockRestore()
       nowSpy.mockRestore()
     })
 
     it('G1-c: isCtxStale 注入但返回 false + 非 stale 错误 → warn "tick error" 且调度继续', async () => {
-      const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
+      loggerMock.warn.mockClear()
       const nowSpy = vi.spyOn(backend, 'now')
       // staleFlag 恒 false（beforeEach 初始化）：代际未翻转，注入存在不改变分诊结果
       genRuntime.onAfterTick(() => {
@@ -887,7 +891,7 @@ describe('SchedulerRuntime', () => {
       genRuntime.startScheduler()
       await vi.advanceTimersByTimeAsync(TICK_INTERVAL_MS) // tick1：非 stale → warn 继续调度
 
-      const warnText = warnSpy.mock.calls.map(c => String(c[0])).join('\n')
+      const warnText = loggerMock.warn.mock.calls.map(c => String(c[0])).join('\n')
       expect(warnText).toContain('tick error')
       expect(warnText).not.toContain('tick stopped')
 
@@ -896,12 +900,11 @@ describe('SchedulerRuntime', () => {
 
       await vi.advanceTimersByTimeAsync(TICK_INTERVAL_MS * 2) // 2 个后续 tick 照常
       expect(nowSpy.mock.calls.length).toBe(countAfterFirstTick + 2)
-      warnSpy.mockRestore()
       nowSpy.mockRestore()
     })
 
     it('G1-d: isCtxStale 返回 false 但错误文案含 stale 片段 → 文案兜底仍自停（覆盖 reload 盲区）', async () => {
-      const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
+      loggerMock.warn.mockClear()
       const nowSpy = vi.spyOn(backend, 'now')
       // reload 场景模拟：factory 重跑后旧闭包代际计数不再递增（staleFlag 恒 false），
       // 只有错误文案能识别 stale——兜底支必须独立于代际检测生效
@@ -912,7 +915,7 @@ describe('SchedulerRuntime', () => {
       genRuntime.startScheduler()
       await vi.advanceTimersByTimeAsync(TICK_INTERVAL_MS) // tick1：文案兜底 → 自停
 
-      const warnText = warnSpy.mock.calls.map(c => String(c[0])).join('\n')
+      const warnText = loggerMock.warn.mock.calls.map(c => String(c[0])).join('\n')
       expect(warnText).toContain('tick stopped')
       expect(warnText).not.toContain('tick error')
 
@@ -921,7 +924,6 @@ describe('SchedulerRuntime', () => {
 
       await vi.advanceTimersByTimeAsync(TICK_INTERVAL_MS * 2)
       expect(nowSpy.mock.calls.length).toBe(countAfterSelfStop)
-      warnSpy.mockRestore()
       nowSpy.mockRestore()
     })
   })

package/src/backend.ts

@@ -13,7 +13,7 @@ import type { ScheduledTask, SchedulerEntryOp } from './types.js'
  * - sendMessage: 到期 dispatch 的消息注入（生产实现委托 pi.sendMessage）
  * - appendEntry: 按 op 写 pi-scheduler:task custom entry（event sourcing）。
  *   生产实现委托 pi.appendEntry（同步落盘）。失败必须被调用方 try-catch（ER-APPEND-FAIL：
- *   runtime 捕获后 console.warn + 不 rethrow，内存态已更新，at-least-once 已知恶化窗口）
+ *   runtime 捕获后 logger.warn + 不 rethrow，内存态已更新，at-least-once 已知恶化窗口）
  * - getSessionFile: 当前 session JSONL 路径（addTask 构建 upsert op 的 ownerSessionFile 用；
  *   --no-session 模式返回 undefined，调用方 ?? '' 兜底）
  * - now: 时间源（测试可注入固定值）

package/src/importer.ts

@@ -4,9 +4,12 @@ import * as path from 'node:path'
 
 import { getAgentDir } from '@earendil-works/pi-coding-agent'
 import type { ExtensionAPI } from '@earendil-works/pi-coding-agent'
+import { getLogger } from '@zhushanwen/pi-extension-logger'
 
 import type { ScheduledTask, SchedulerEntryOp, SchedulerStore, TaskSnapshot } from './types.js'
 
+const logger = getLogger('scheduler')
+
 /**
  * 获取旧 store 文件路径：scheduler/<root>/<segments>/scheduler.json，双候选探测。
  *
@@ -143,9 +146,9 @@ function importFromFile(
   // 空 store（0 任务）无持久化依赖，直接删；resumed session（sessionFile 已存在）已即时落盘，删
   if (tasks.length === 0 || fs.existsSync(currentSessionFile)) {
     fs.unlinkSync(importedPath)
-    // 内部诊断日志（非用户可见消息）：用 console.warn 而非 console.log（项目 convention：
-    // extensions 禁 console.log/info 防泄漏到 TUI；诊断输出统一 console.warn）
-    console.warn(`[scheduler] imported ${tasks.length} legacy tasks from ${importedPath}`)
+    // 内部诊断日志（非用户可见消息）：经共享 logger.warn → appendEntry 持久化为 custom entry，
+    // 不污染 TUI（logging-conventions SSOT：诊断走 logger.warn，禁裸 console）。
+    logger.warn('imported legacy tasks', { count: tasks.length, path: importedPath })
     return undefined
   }
 
@@ -155,9 +158,10 @@ function importFromFile(
   // 出现 → 删；仍未 flush → 静默保留 .imported 供下次 session_start 的 handleImportedResidue
   // 崩溃恢复重导入。跨 session 重导入窗口 = session_start → 首个 turn_end（秒级）：turn_end 后
   // .imported 已删，后续 session 启动看不到残留 → 双导入窗口闭合（R-CONCURRENT-IMPORT 已更新）
-  console.warn(
-    `[scheduler] imported ${tasks.length} legacy tasks (session not flushed; deferring ${importedPath} removal)`,
-  )
+  logger.warn('imported legacy tasks (session not flushed; deferring removal)', {
+    count: tasks.length,
+    path: importedPath,
+  })
   return () => {
     // 幂等：已删（本进程或并发另一进程已处理）→ no-op。cleanup 在每次 turn_end 都会调用，重复调用安全
     if (!fs.existsSync(importedPath)) return
@@ -216,7 +220,7 @@ function handleImportedResidue(
  * 内存 fileEntries，紧接的 loadTasks replay 统一重放读到导入任务（pi _appendEntry 同步 push
  * fileEntries，design-review 已实测验证）。
  *
- * 整体降级（C1）：read/parse/appendEntry 任一异常 → console.warn + 不 rethrow，不让
+ * 整体降级（C1）：read/parse/appendEntry 任一异常 → logger.warn + 不 rethrow，不让
  * session_start 崩溃（与 replay gap4 / ER-APPEND-FAIL 同款降级语义）。append 中途失败时
  * .imported 保留（不 unlink）——下次 session 的 handleImportedResidue 会重导入全部任务，
  * 已成功 append 的子集可能跨 session 双触发；取舍：删除则失败任务永久丢失（更糟），
@@ -255,9 +259,7 @@ export function importLegacyStore(
     return importFromFile(importedPath, pi, currentSessionFile)
   } catch (err) {
     // C1 整体降级：read/parse/appendEntry 任一异常不崩 session_start
-    console.warn(
-      `[scheduler] import failed: ${err instanceof Error ? err.message : String(err)}`,
-    )
+    logger.warn('import failed', { error: err instanceof Error ? err.message : String(err) })
     return undefined
   }
 }

package/src/replay.ts

@@ -1,5 +1,9 @@
+import { getLogger } from '@zhushanwen/pi-extension-logger'
+
 import type { ScheduledTask, SchedulerEntryOp, TaskSnapshot } from './types.js'
 
+const logger = getLogger('scheduler')
+
 /**
  * CustomEntry 的最小可识别形状（duck-typed，不依赖 @earendil-works/pi-coding-agent 的
  * 具体 SessionEntry 类型）。与 pending-notifications/state.ts、goal/ports.ts 同款：
@@ -33,7 +37,7 @@ const HISTORY_LIMIT = 20
  *
  * append-only 时序保证 nextRunAt 不回退（D1）：advance entry 按写入顺序折叠，自然取到最后推进值。
  *
- * getEntries 解析/迭代异常 → console.warn + 返回空 Map（gap4）：降级为无任务而非崩溃 session_start。
+ * getEntries 解析/迭代异常 → logger.warn + 返回空 Map（gap4）：降级为无任务而非崩溃 session_start。
  */
 export function replayFoldEntries(
   entries: Iterable<SchedulerEntryLike>,
@@ -82,9 +86,7 @@ export function replayFoldEntries(
         // MF-2：守卫已按变体校验必填字段，但嵌套数据损坏（如 upsert task.history 非数组 →
         // snapshotToTask 的 .map 抛）仍可能抛——逐条 try/catch 只跳过该条，
         // 不让外层整体 catch 把全部任务清成空 Map（一条损坏 entry 不得清空全部任务）
-        console.warn(
-          `[scheduler] skipping corrupted scheduler entry: ${err instanceof Error ? err.message : String(err)}`,
-        )
+        logger.warn('skipping corrupted scheduler entry', { error: err instanceof Error ? err.message : String(err) })
         continue
       }
     }
@@ -101,9 +103,7 @@ export function replayFoldEntries(
     return tasks
   } catch (err) {
     // gap4：session JSONL 损坏 / 迭代器抛错时降级为无任务，不让 session_start 崩溃。
-    console.warn(
-      `[scheduler] replayFoldEntries failed: ${err instanceof Error ? err.message : String(err)}`,
-    )
+    logger.warn('replayFoldEntries failed', { error: err instanceof Error ? err.message : String(err) })
     return new Map()
   }
 }

package/src/runtime.ts

@@ -1,4 +1,5 @@
 import type { ExtensionContext } from '@earendil-works/pi-coding-agent'
+import { getLogger } from '@zhushanwen/pi-extension-logger'
 
 import type { DeliveryHandle, DeliveryMessage } from '@xyz-agent/session-delivery'
 
@@ -13,6 +14,8 @@ import type {
   TaskSnapshot,
 } from './types.js'
 
+const logger = getLogger('scheduler')
+
 const MAX_TASKS = 50
 // 入队防重标记 TTL（合批非首条任务无终态回调，过期后放行重投；10 min >> 合批窗口）
 const QUEUE_DEDUPE_TTL_MS = 10 * 60 * 1000
@@ -215,7 +218,7 @@ export class SchedulerRuntime {
         if (this.isCtxStale?.() || message.includes(STALE_CTX_MARKER)) {
           this.retireStaleTimer()
         } else {
-          console.warn(`[scheduler] tick error: ${message}`)
+          logger.warn('tick error', { error: message })
         }
       })
     }, TICK_INTERVAL_MS)
@@ -234,7 +237,7 @@ export class SchedulerRuntime {
    * session_start 重建的新一代 runtime 接管。
    */
   private retireStaleTimer(): void {
-    console.warn(`[scheduler] tick stopped: stale extension ctx (session replaced); timer self-retired`)
+    logger.warn('tick stopped: stale extension ctx (session replaced); timer self-retired')
     this.stopScheduler()
   }
 
@@ -303,7 +306,7 @@ export class SchedulerRuntime {
   async dispatchTask(task: ScheduledTask): Promise<boolean> {
     if (!task.enabled) return false
     if (this.dispatchesInFlight.has(task.id)) {
-      console.warn(`[scheduler] dispatch already in flight for task ${task.id}; skipping this tick`)
+      logger.warn('dispatch already in flight, skipping this tick', { taskId: task.id })
       return false
     }
     this.dispatchesInFlight.add(task.id)
@@ -478,7 +481,7 @@ export class SchedulerRuntime {
   // ── append-only 持久化辅助 ──
 
   /**
-   * 委托 backend.appendEntry。失败 → console.warn + 不 rethrow（ER-APPEND-FAIL）。
+   * 委托 backend.appendEntry。失败 → logger.warn + 不 rethrow（ER-APPEND-FAIL）。
    * 内存态已先行更新（at-least-once 已知恶化窗口：append 失败则该 op 丢失，resume 重放回退）。
    * 不再设 task.lastError='persist failed'（append 失败是 transient，不应污染业务态）。
    */
@@ -488,9 +491,7 @@ export class SchedulerRuntime {
     } catch (err) {
       // best-effort 降级（ER-APPEND-FAIL）：append-only 模型下 append 失败仅丢失该 op 的持久化，
       // 内存态已先行更新、不 rethrow，业务流程继续。at-least-once 已知恶化窗口（resume 重放回退）。
-      console.warn(
-        `[scheduler] appendEntry failed: ${err instanceof Error ? err.message : String(err)}`,
-      )
+      logger.warn('appendEntry failed', { error: err instanceof Error ? err.message : String(err) })
     }
   }