dsh-session-guard 3.0.0 → 3.1.0

package/src/pause-store.js

@@ -1,101 +1,101 @@
-/**
- * dsh-session-guard — 自研会话门暂停状态持久化（脱离 dsh-task-control）。
- *
- * 与 queueLock（src/store.js，队列锁）分离：这里是「真暂停」的持久化快照，
- * 仿 task-control 的状态模型，但独立子目录 /pause 避免与队列锁文件互相污染。
- *
- * 暂停/锁定状态仍**不写 session log**（harness 持久化 reader 只有已知事件集，
- * 自定义 `session-guard/*` 事件会导致重启后会话无法加载），走插件自有 JSON 文件：
- * `$DSH_HOME/.dsh/session-guard/pause/<sessionId>.json`（`DSH_SESSION_GUARD_PAUSE_DIR`
- * 可覆盖根目录）。原子写：tmp + rename。
- */
-import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs'
-import { dirname, join } from 'node:path'
-import { storeRoot } from './store.js'
-
-/** 会话 id → 安全文件名（与队列锁同规则）。 */
-export function encodeSessionId(id) {
-  return String(id).replace(/[^a-zA-Z0-9._-]/g, '_')
-}
-
-/** 自研暂停状态根目录（独立于队列锁）。 */
-export function pauseStateRoot() {
-  return (
-    process.env.DSH_SESSION_GUARD_PAUSE_DIR ||
-    join(storeRoot(), 'pause')
-  )
-}
-
-/** 每会话暂停状态文件路径。 */
-export function pauseFilePath(id) {
-  return join(pauseStateRoot(), `${encodeSessionId(id)}.json`)
-}
-
-/** 未暂停基线快照。 */
-export function idlePauseState(id) {
-  return {
-    sessionId: String(id),
-    paused: false,
-    resumeContent: null,
-    forced: false,
-    interruptedTool: null,
-    deferredTools: null,
-    updatedAt: null,
-  }
-}
-
-/**
- * 创建暂停状态存储（内存缓存 + 磁盘持久化，原子写）。
- * 独立于队列锁 store，字段形态仿 task-control（paused/forced/interruptedTool/deferredTools）。
- */
-export function createPauseStore() {
-  const cache = new Map()
-
-  function read(id) {
-    if (cache.has(id)) return cache.get(id)
-    try {
-      const f = pauseFilePath(id)
-      if (!existsSync(f)) return null
-      const v = JSON.parse(readFileSync(f, 'utf8'))
-      cache.set(id, v)
-      return v
-    } catch {
-      return null
-    }
-  }
-
-  return {
-    /** 读一会话暂停态；无记录返回 null（调用方 fallback idlePauseState）。 */
-    get(id) {
-      return read(id)
-    },
-    /** 原子写。 */
-    set(id, value) {
-      cache.set(id, value)
-      try {
-        const f = pauseFilePath(id)
-        mkdirSync(dirname(f), { recursive: true })
-        const tmp = `${f}.tmp`
-        writeFileSync(tmp, JSON.stringify(value, null, 2))
-        renameSync(tmp, f)
-      } catch (e) {
-        // 落盘失败仅影响重启恢复，内存态仍可用。
-        console.error(`[session-guard] pause store write failed: ${String(e && e.message || e)}`)
-      }
-    },
-    /** 清除（resume/cancel 后）。 */
-    clear(id) {
-      cache.delete(id)
-      try {
-        rmSync(pauseFilePath(id), { force: true })
-      } catch {
-        /* ignore */
-      }
-    },
-    /** 当前有效快照（无记录时 idle 基线）。 */
-    current(id) {
-      const v = read(id)
-      return v !== null && typeof v === 'object' ? v : idlePauseState(id)
-    },
-  }
-}
+/**
+ * dsh-session-guard — 自研会话门暂停状态持久化（脱离 dsh-task-control）。
+ *
+ * 与 queueLock（src/store.js，队列锁）分离：这里是「真暂停」的持久化快照，
+ * 仿 task-control 的状态模型，但独立子目录 /pause 避免与队列锁文件互相污染。
+ *
+ * 暂停/锁定状态仍**不写 session log**（harness 持久化 reader 只有已知事件集，
+ * 自定义 `session-guard/*` 事件会导致重启后会话无法加载），走插件自有 JSON 文件：
+ * `$DSH_HOME/.dsh/session-guard/pause/<sessionId>.json`（`DSH_SESSION_GUARD_PAUSE_DIR`
+ * 可覆盖根目录）。原子写：tmp + rename。
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { storeRoot } from './store.js'
+
+/** 会话 id → 安全文件名（与队列锁同规则）。 */
+export function encodeSessionId(id) {
+  return String(id).replace(/[^a-zA-Z0-9._-]/g, '_')
+}
+
+/** 自研暂停状态根目录（独立于队列锁）。 */
+export function pauseStateRoot() {
+  return (
+    process.env.DSH_SESSION_GUARD_PAUSE_DIR ||
+    join(storeRoot(), 'pause')
+  )
+}
+
+/** 每会话暂停状态文件路径。 */
+export function pauseFilePath(id) {
+  return join(pauseStateRoot(), `${encodeSessionId(id)}.json`)
+}
+
+/** 未暂停基线快照。 */
+export function idlePauseState(id) {
+  return {
+    sessionId: String(id),
+    paused: false,
+    resumeContent: null,
+    forced: false,
+    interruptedTool: null,
+    deferredTools: null,
+    updatedAt: null,
+  }
+}
+
+/**
+ * 创建暂停状态存储（内存缓存 + 磁盘持久化，原子写）。
+ * 独立于队列锁 store，字段形态仿 task-control（paused/forced/interruptedTool/deferredTools）。
+ */
+export function createPauseStore() {
+  const cache = new Map()
+
+  function read(id) {
+    if (cache.has(id)) return cache.get(id)
+    try {
+      const f = pauseFilePath(id)
+      if (!existsSync(f)) return null
+      const v = JSON.parse(readFileSync(f, 'utf8'))
+      cache.set(id, v)
+      return v
+    } catch {
+      return null
+    }
+  }
+
+  return {
+    /** 读一会话暂停态；无记录返回 null（调用方 fallback idlePauseState）。 */
+    get(id) {
+      return read(id)
+    },
+    /** 原子写。 */
+    set(id, value) {
+      cache.set(id, value)
+      try {
+        const f = pauseFilePath(id)
+        mkdirSync(dirname(f), { recursive: true })
+        const tmp = `${f}.tmp`
+        writeFileSync(tmp, JSON.stringify(value, null, 2))
+        renameSync(tmp, f)
+      } catch (e) {
+        // 落盘失败仅影响重启恢复，内存态仍可用。
+        console.error(`[session-guard] pause store write failed: ${String(e && e.message || e)}`)
+      }
+    },
+    /** 清除（resume/cancel 后）。 */
+    clear(id) {
+      cache.delete(id)
+      try {
+        rmSync(pauseFilePath(id), { force: true })
+      } catch {
+        /* ignore */
+      }
+    },
+    /** 当前有效快照（无记录时 idle 基线）。 */
+    current(id) {
+      const v = read(id)
+      return v !== null && typeof v === 'object' ? v : idlePauseState(id)
+    },
+  }
+}

package/src/scheduler.js

@@ -1,42 +1,42 @@
-/**
- * dsh-session-guard — 纯状态机（可单测，零依赖）。
- *
- * 状态：NORMAL ↔ PAUSED_PEAK。
- * 副作用（暂停/恢复具体会话）由 host 的 tick 执行，这里只做判定与迁移检测。
- */
-import { shouldPause } from './time.js'
-
-export const STATES = {
-  NORMAL: 'NORMAL',
-  PAUSED_PEAK: 'PAUSED_PEAK',
-}
-
-/**
- * 计算当前状态。
- * @param {object} settings 同 time.shouldPause 的 settings
- * @param {Date|number} now
- * @returns {{state:string, reason:string, at:number}}
- */
-export function computeState(settings, now) {
-  const date = now instanceof Date ? now : new Date(now)
-  const d = shouldPause(settings, date)
-  return {
-    state: d.pause ? STATES.PAUSED_PEAK : STATES.NORMAL,
-    reason: d.reason,
-    at: date.getTime(),
-  }
-}
-
-/**
- * 迁移检测：从 prev 到 next 是否发生了 入峰(enter) / 退峰(leave)。
- * @param {{state:string}|null} prev
- * @param {{state:string}} next
- * @returns {{enter:boolean, leave:boolean}}
- */
-export function transition(prev, next) {
-  const was = prev && prev.state
-  return {
-    enter: next.state === STATES.PAUSED_PEAK && was !== STATES.PAUSED_PEAK,
-    leave: was === STATES.PAUSED_PEAK && next.state !== STATES.PAUSED_PEAK,
-  }
-}
+/**
+ * dsh-session-guard — 纯状态机（可单测，零依赖）。
+ *
+ * 状态：NORMAL ↔ PAUSED_PEAK。
+ * 副作用（暂停/恢复具体会话）由 host 的 tick 执行，这里只做判定与迁移检测。
+ */
+import { shouldPause } from './time.js'
+
+export const STATES = {
+  NORMAL: 'NORMAL',
+  PAUSED_PEAK: 'PAUSED_PEAK',
+}
+
+/**
+ * 计算当前状态。
+ * @param {object} settings 同 time.shouldPause 的 settings
+ * @param {Date|number} now
+ * @returns {{state:string, reason:string, at:number}}
+ */
+export function computeState(settings, now) {
+  const date = now instanceof Date ? now : new Date(now)
+  const d = shouldPause(settings, date)
+  return {
+    state: d.pause ? STATES.PAUSED_PEAK : STATES.NORMAL,
+    reason: d.reason,
+    at: date.getTime(),
+  }
+}
+
+/**
+ * 迁移检测：从 prev 到 next 是否发生了 入峰(enter) / 退峰(leave)。
+ * @param {{state:string}|null} prev
+ * @param {{state:string}} next
+ * @returns {{enter:boolean, leave:boolean}}
+ */
+export function transition(prev, next) {
+  const was = prev && prev.state
+  return {
+    enter: next.state === STATES.PAUSED_PEAK && was !== STATES.PAUSED_PEAK,
+    leave: was === STATES.PAUSED_PEAK && next.state !== STATES.PAUSED_PEAK,
+  }
+}

package/src/settings.js

@@ -54,33 +54,34 @@ export const DEFAULT_SETTINGS = Object.freeze({
  * - 枚举用 z.union([z.const(...)])；默认值用字段级 .default()。
  */
 export const SettingsSchema = z.object({
-  enabled: z.boolean().default(DEFAULT_SETTINGS.enabled),
-  offPeakAutoResume: z.boolean().default(DEFAULT_SETTINGS.offPeakAutoResume),
-  weekendMode: z.boolean().default(DEFAULT_SETTINGS.weekendMode),
-  timezone: z.string().default(DEFAULT_SETTINGS.timezone),
+  enabled: z.boolean().default(DEFAULT_SETTINGS.enabled).volatile(),
+  offPeakAutoResume: z.boolean().default(DEFAULT_SETTINGS.offPeakAutoResume).volatile(),
+  weekendMode: z.boolean().default(DEFAULT_SETTINGS.weekendMode).volatile(),
+  timezone: z.string().default(DEFAULT_SETTINGS.timezone).volatile(),
   peakWindows: z
     .array(z.object({ start: z.string(), end: z.string() }))
-    .default(DEFAULT_SETTINGS.peakWindows),
-  pauseMode: z.union([z.const('safe'), z.const('force')]).default(DEFAULT_SETTINGS.pauseMode),
-  pauseReason: z.union([z.const('wait'), z.const('stop')]).default(DEFAULT_SETTINGS.pauseReason),
-  stepLevelPause: z.boolean().default(DEFAULT_SETTINGS.stepLevelPause),
-  stepGateTimeoutMs: z.number().min(0).default(DEFAULT_SETTINGS.stepGateTimeoutMs),
-  queueFallback: z.boolean().default(DEFAULT_SETTINGS.queueFallback),
-  retryEnabled: z.boolean().default(DEFAULT_SETTINGS.retryEnabled),
-  retryText: z.string().default(DEFAULT_SETTINGS.retryText),
-  retryGraceMs: z.number().min(0).default(DEFAULT_SETTINGS.retryGraceMs),
-  retryCooldownMs: z.number().min(0).default(DEFAULT_SETTINGS.retryCooldownMs),
-  retryBackoffFactor: z.number().min(1).default(DEFAULT_SETTINGS.retryBackoffFactor),
-  retryBackoffMaxMs: z.number().min(0).default(DEFAULT_SETTINGS.retryBackoffMaxMs),
-  retryMaxConsecutive: z.number().min(0).default(DEFAULT_SETTINGS.retryMaxConsecutive),
-  providerGuard: z.boolean().default(DEFAULT_SETTINGS.providerGuard),
-  officialProviders: z.array(z.string()).default(DEFAULT_SETTINGS.officialProviders),
-  officialBaseURLs: z.array(z.string()).default(DEFAULT_SETTINGS.officialBaseURLs),
-  deferredResume: z.boolean().default(DEFAULT_SETTINGS.deferredResume),
-  deferredResumeText: z.string().default(DEFAULT_SETTINGS.deferredResumeText),
-  deferredMode: z.union([z.const('hold'), z.const('error')]).default(DEFAULT_SETTINGS.deferredMode),
-  deferredMaxHoldMs: z.number().min(0).default(DEFAULT_SETTINGS.deferredMaxHoldMs),
-  guardSubagents: z.boolean().default(DEFAULT_SETTINGS.guardSubagents),
+    .default(DEFAULT_SETTINGS.peakWindows)
+    .volatile(),
+  pauseMode: z.union([z.const('safe'), z.const('force')]).default(DEFAULT_SETTINGS.pauseMode).volatile(),
+  pauseReason: z.union([z.const('wait'), z.const('stop')]).default(DEFAULT_SETTINGS.pauseReason).volatile(),
+  stepLevelPause: z.boolean().default(DEFAULT_SETTINGS.stepLevelPause).volatile(),
+  stepGateTimeoutMs: z.number().min(0).default(DEFAULT_SETTINGS.stepGateTimeoutMs).volatile(),
+  queueFallback: z.boolean().default(DEFAULT_SETTINGS.queueFallback).volatile(),
+  retryEnabled: z.boolean().default(DEFAULT_SETTINGS.retryEnabled).volatile(),
+  retryText: z.string().default(DEFAULT_SETTINGS.retryText).volatile(),
+  retryGraceMs: z.number().min(0).default(DEFAULT_SETTINGS.retryGraceMs).volatile(),
+  retryCooldownMs: z.number().min(0).default(DEFAULT_SETTINGS.retryCooldownMs).volatile(),
+  retryBackoffFactor: z.number().min(1).default(DEFAULT_SETTINGS.retryBackoffFactor).volatile(),
+  retryBackoffMaxMs: z.number().min(0).default(DEFAULT_SETTINGS.retryBackoffMaxMs).volatile(),
+  retryMaxConsecutive: z.number().min(0).default(DEFAULT_SETTINGS.retryMaxConsecutive).volatile(),
+  providerGuard: z.boolean().default(DEFAULT_SETTINGS.providerGuard).volatile(),
+  officialProviders: z.array(z.string()).default(DEFAULT_SETTINGS.officialProviders).volatile(),
+  officialBaseURLs: z.array(z.string()).default(DEFAULT_SETTINGS.officialBaseURLs).volatile(),
+  deferredResume: z.boolean().default(DEFAULT_SETTINGS.deferredResume).volatile(),
+  deferredResumeText: z.string().default(DEFAULT_SETTINGS.deferredResumeText).volatile(),
+  deferredMode: z.union([z.const('hold'), z.const('error')]).default(DEFAULT_SETTINGS.deferredMode).volatile(),
+  deferredMaxHoldMs: z.number().min(0).default(DEFAULT_SETTINGS.deferredMaxHoldMs).volatile(),
+  guardSubagents: z.boolean().default(DEFAULT_SETTINGS.guardSubagents).volatile(),
 })
 
 /**
@@ -88,31 +89,6 @@ export const SettingsSchema = z.object({
  * 插件不 value-import `@deepseek-ai/dsh-settings`，只通过这些形状在注入面调用。
  */
 
-/** @typedef {{ get(): unknown; watch(cb: () => void): () => void }} SettingsScopeLike */
-/** @typedef {{ register(ns: string, schema: unknown, options?: { base?: unknown }): SettingsScopeLike }} SettingsServiceLike */
-/** @typedef {{ inject(deps: readonly string[], fn: (s: { settings: SettingsServiceLike; effect(cb: () => (() => void) | void, label?: string): void }) => void): void }} SettingsAwareCtx */
+// 0.1.7：设置面改声明式 —— SettingsSchema 的 volatile 字段即自动表单，
+// 不再有任何 register 调用；运行时经 apply 的组合条目（live ref）读取。
 
-/**
- * 注册 设置 → 插件 → session-guard 子板块（简单开关）。
- * - 走 `settings` 注入面，`base` 层叠组合配置；对 runtime 调用方经 `ctx.settings.get(NS)` 读取。
- * - 任何失败（settings 服务缺失 / 注入异常）→ 返回 false，静默降级用默认配置。
- * @param {object} ctx - host context（应含 cordis `settings` 注入面）。
- * @returns {boolean} 注册成功 true；设置服务不可用时 false（fail-open）。
- */
-export function registerSettings(ctx) {
-  try {
-    // 本插件顶层 `inject` 已声明 `settings`（见 src/index.js 的
-    // `export const inject`），所以 apply 时 `ctx.settings` 已是完整
-    // SettingsProvider（带 .register），直接注册即可 —— 无需再 `ctx.inject`
-    // 二次动态注入（对已在 fiber 上解析的服务做二次注入，回调作为异步插件
-    // apply 排队，`registerSettings` 同步返回 true 会掩盖实际操作未生效）。
-    // 与 dsh-thinking-levels / dsh-context 的区别仅在于它们顶层未声明
-    // settings，才必须动态注入；这里已声明，直接用最可靠。
-    const svc = /** @type {{ register(ns: string, schema: unknown, options?: { base?: unknown }): unknown }} */ (ctx.settings)
-    // base 用副本：DEFAULT_SETTINGS 被 Object.freeze，直接当 base 可能被写。
-    svc.register(NS, SettingsSchema, { base: { ...DEFAULT_SETTINGS } })
-    return true
-  } catch {
-    return false
-  }
-}