dsh-manage-session 0.2.3 → 0.4.8

package/src/index.ts

@@ -26,20 +26,40 @@ import { purgeHistory } from './host/history/purge.ts'
 import { buildProjectionOwnerIndex, createAttributor, defaultProfileNodeModules } from './host/health/attribution.ts'
 import { HealthCache } from './host/health/cache.ts'
 import { buildSessionReport, type SessionHealthReport } from './host/health/gates.ts'
+import { decodeSessionLogFile } from './host/health/decode.ts'
 import { assessRepair, prescribe, quarantineProjectionCache } from './host/health/repair.ts'
-import { countCorpus, findSessionLog, scanSessions } from './host/health/scan.ts'
+import { countCorpus, findSession, scanSessions } from './host/health/scan.ts'
+import { gateSourceKind, migrateSessionSourceKind, readSourceKindFacts } from './host/health/source-kind.ts'
 
 export { DEFAULT_CONFIG, STEWARD_API_PREFIX, STEWARD_SETTINGS_NAMESPACE } from './config.ts'
 export type { StewardConfig } from './config.ts'
 export { readArchiveSet, pruneArchiveFile, editWorkspaceDocument } from './host/history/archive-source.ts'
 export { listHistory, pruneHistory } from './host/history/archive.ts'
-export { purgeHistory, locateSessionUsage, indexSessionDirs, isSafeChild, dirSize, sessionsRootFor, projCacheRootFor } from './host/history/purge.ts'
-export { buildSessionReport, gateColdRead, gateLogIntegrity, gateLosslessJson, gateProjectionCache, readProjectionCache, readTailFacts } from './host/health/gates.ts'
+export { purgeHistory, locateSessionUsage, indexSessionDirs, isSafeChild, dirSize, sessionsRootFor, projCacheRootFor, isSourceMigrateBackupName, backupFilesIn } from './host/history/purge.ts'
+export { buildSessionReport, gateColdRead, gateGeneration, gateLogIntegrity, gateLosslessJson, gateProjectionCache, readProjectionCache, readTailFacts } from './host/health/gates.ts'
+export { gateSourceKind, migrateSessionSourceKind, migrateLegacySource, readSourceKindFacts, SOURCE_MIGRATE_BACKUP_SUFFIX, V4_HOST_MIN } from './host/health/source-kind.ts'
 export { firstLosslessViolation, isLossless } from './host/health/lossless.ts'
 export { decodeSessionLogBytes, decodeSessionLogFile, scanZstdFrames } from './host/health/decode.ts'
+export {
+  classifyGenerationFilename,
+  generationLogFilename,
+  isMigrationStagingFilename,
+  latestArtifactMtime,
+  parseGenerationLogFilename,
+  readSessionGenerations,
+  sessionPriority,
+} from './host/health/generation.ts'
+export type {
+  GenerationArtifact,
+  LogArtifact,
+  LogCompression,
+  SessionGenerations,
+  SessionPriority,
+} from './host/health/generation.ts'
 export { buildProjectionOwnerIndex, createAttributor } from './host/health/attribution.ts'
 export { prescribe, quarantineProjectionCache } from './host/health/repair.ts'
-export { countCorpus, discoverSessions, findSessionLog, scanSessions } from './host/health/scan.ts'
+export { countCorpus, discoverSessions, findSession, findSessionLog, scanSessions } from './host/health/scan.ts'
+export type { DiscoveredSession } from './host/health/scan.ts'
 export { HealthCache } from './host/health/cache.ts'
 export type { HealthCacheEntry } from './host/health/cache.ts'
 export { assessRepair } from './host/health/repair.ts'
@@ -62,51 +82,26 @@ interface StewardWebRuntime {
   trustedHosts: readonly string[]
 }
 
-/** settings 服务面（结构化镜像）。 */
-interface SettingsScopeLike {
-  get(): unknown
-  watch(callback: () => void): () => void
+/** Live reference the 0.1.7 loader hands `apply` for `.volatile()` config fields. */
+interface VolatileRef<T> {
+  get(): T
 }
-interface SettingsServiceLike {
-  register(ns: string, schema: unknown, options?: { base?: unknown }): SettingsScopeLike
-}
-interface SettingsAwareCtx {
-  inject(deps: readonly string[], fn: (sctx: {
-    settings: SettingsServiceLike
-    effect(cleanup: () => (() => void) | void, label?: string): void
-  }) => void): void
+
+/** Resolve one possibly-volatile field: a live ref on 0.1.7+, a plain value otherwise. */
+function readVolatileValue<T>(value: T | VolatileRef<T> | undefined): T | undefined {
+  if (value !== null && typeof value === 'object' && typeof (value as VolatileRef<T>).get === 'function') {
+    return (value as VolatileRef<T>).get()
+  }
+  return value as T | undefined
 }
 
-/** 运行时配置 schema（与 src/config.ts 的形状保持一致）。 */
-const Config = z.object({
-  enabled: z.boolean().default(true),
-  historyFiles: z.boolean().default(true),
-  healthCheck: z.boolean().default(true),
+/** 运行时配置 schema（与 src/config.ts 的形状保持一致）。0.1.7：volatile 字段即设置表单。 */
+export const Config = z.object({
+  enabled: z.boolean().default(true).volatile(),
+  historyFiles: z.boolean().default(true).volatile(),
+  healthCheck: z.boolean().default(true).volatile(),
 })
 
-/**
- * 官方 `installSettingsSection` 的内联等价：通过 settings 服务注册命名空间、
- * 以组合入口作为 `base` 层、并保持运行时来源实时（与 toggle / thinking-levels 同范式）。
- */
-function installSettingsSection<T>(
-  ctx: Context,
-  ns: string,
-  schema: unknown,
-  entry: T,
-  hooks: { setSource: (source: () => T) => void; onChange: () => void },
-): void {
-  ;(ctx as unknown as SettingsAwareCtx).inject(['settings'], (sctx) => {
-    const scope = sctx.settings.register(ns, schema, { base: entry })
-    hooks.setSource(() => scope.get() as T)
-    hooks.onChange()
-    sctx.effect(() => () => {
-      hooks.setSource(() => entry)
-      hooks.onChange()
-    })
-    scope.watch(() => hooks.onChange())
-  })
-}
-
 /** 单次请求体的上限（防御无界读取）。 */
 const MAX_BODY_BYTES = 16 << 20
 
@@ -228,6 +223,7 @@ export const HEALTH_METHODS = [
   'session-health-scan',
   'session-health-session',
   'session-health-repair',
+  'session-health-source-migrate',
 ] as const
 
 /** 依据开关判定某方法是否启用。 */
@@ -335,14 +331,17 @@ export async function handleMethod(
   const request = (payload ?? {}) as { sessionId?: unknown }
   const sessionId = asSessionId(request.sessionId)
   if (sessionId === undefined) return { ok: false, error: '缺少合法的 sessionId' }
-  const logPath = findSessionLog(sessionId, runtime.dshHome)
-  if (logPath === undefined) return { ok: false, error: `未找到会话日志：${sessionId}` }
+  // 按代次定位：会话存在但尚未发布当前代时 logPath 为 undefined，此时仍要出报告
+  // （generation / log-integrity 两门如实报出），不能笼统回「未找到会话日志」。
+  const session = findSession(sessionId, runtime.dshHome)
+  if (session === undefined) return { ok: false, error: `未找到会话日志：${sessionId}` }
 
   const projectionState = runtime.projectionStateFor(sessionId)
   const reportFor = (): SessionHealthReport => buildSessionReport({
     sessionId,
     dshHome: runtime.dshHome,
-    logPath,
+    ...(session.logPath === undefined ? {} : { logPath: session.logPath }),
+    generations: session.generations,
     ...(projectionState === undefined ? {} : { projectionState }),
     attribute: runtime.attribute,
   })
@@ -355,6 +354,32 @@ export async function handleMethod(
     return { ok: true, report, prescriptions: prescribe(report, runtime.dshHome) }
   }
 
+  // session-health-source-migrate：把 v4 日志里的旧署名行（kind:'plugin' + plugin 字段）
+  // 转换为 producer-owned kind。这是「禁止改写会话日志」红线的唯一显式例外：
+  // 只动 source 署名字段、先整文件备份、v3 及更早版本线拒绝执行（见 source-kind.ts 的版本依赖表）。
+  if (method === 'session-health-source-migrate') {
+    if (session.logPath === undefined) {
+      return { ok: false, error: '会话尚未发布当前代日志，无从转换（先用会话代次工具发布）' }
+    }
+    const log = decodeSessionLogFile(session.logPath)
+    const outcome = migrateSessionSourceKind(sessionId, session.logPath, log, runtime.dshHome)
+    // 转换后重出报告：source-kind 门应转 ok；失败时报告原样（便于面板对照）。
+    const after = buildSessionReport({
+      sessionId,
+      dshHome: runtime.dshHome,
+      logPath: session.logPath,
+      generations: session.generations,
+      ...(projectionState === undefined ? {} : { projectionState }),
+      attribute: runtime.attribute,
+    })
+    runtime.cache?.patch(after)
+    runtime.log(
+      `source-kind migrate ${sessionId}: ok=${outcome.ok} changed=${outcome.changedRows ?? 0}` +
+        (outcome.error === undefined ? '' : ` error=${outcome.error}`),
+    )
+    return { ok: outcome.ok, outcome, after, report: after, error: outcome.error }
+  }
+
   // session-health-repair：出院前的可逆处置 + before/after 对照 + 结果定性
   const before = reportFor()
   if (before.level === 'ok') {
@@ -371,7 +396,7 @@ export async function handleMethod(
       verdict: clean.verdict,
       explanation: clean.explanation,
       residual: clean.residual,
-      prescriptions: ['# 四门全绿：无需处置'],
+      prescriptions: ['# 全部检查通过：无需处置'],
     }
   }
   const repair = quarantineProjectionCache(sessionId, runtime.dshHome)
@@ -398,14 +423,17 @@ export async function handleMethod(
 }
 
 /**
- * 插件主体：注册设置命名空间、装配运行时、挂载 fenced 路由。
- * @param ctx - host 插件上下文（webServer / webRuntime / 可选 settings、sessionQuery、sessions、sessionProjections）。
+ * 插件主体：装配运行时、挂载 fenced 路由。
+ * @param ctx - host 插件上下文（webServer / webRuntime / 可选 sessionQuery、sessions、sessionProjections）。
+ * @param config - 组合条目（0.1.7：`.volatile()` 字段为 live ref）。
  */
-export function apply(ctx: Context): void {
-  let current: () => Required<StewardConfig> = () => DEFAULT_CONFIG
-  installSettingsSection(ctx, STEWARD_SETTINGS_NAMESPACE, Config, DEFAULT_CONFIG, {
-    setSource: (source) => { current = () => ({ ...DEFAULT_CONFIG, ...(source() as Partial<StewardConfig>) }) },
-    onChange: () => {},
+export function apply(ctx: Context, config: Partial<StewardConfig> = {}): void {
+  // 0.1.7：volatile 字段每次读取解引出最新快照（开关即时生效），不再有任何
+  // settings 注册调用。
+  const current = (): Required<StewardConfig> => ({
+    enabled: readVolatileValue(config.enabled) ?? DEFAULT_CONFIG.enabled,
+    historyFiles: readVolatileValue(config.historyFiles) ?? DEFAULT_CONFIG.historyFiles,
+    healthCheck: readVolatileValue(config.healthCheck) ?? DEFAULT_CONFIG.healthCheck,
   })
 
   const log = (message: string): void => {