@shgroup/dsh-serenity-hooks 1.76.0 → 1.77.1

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.76.0",
+  "version": "1.77.1",
   "main": "lib/index.js",
   "description": "宁静号 ACC harness（Native Cordis 插件）：给 DSH 装一个「AI 工作区」——14 个工具（container_fs/cognitive_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫）+ 认知轨迹日志与原地重建 + 网页登录入口/IM 桥/认知轨迹唤醒注册表。轨迹声明 = 轨迹目录下的 trajectory.json（约束面 + 旧标识 uid + CRO 机器绑定 cro.host；旧名 trajectory-constraint.json / skiff.json 仍在读取族里）；轨迹提示词 = 轨迹目录下的 PROMPT.md（一条轨迹「是谁、按什么章程工作」，所有轨迹通用，追加在容器层与质量层之后，不替换它们）。适配 DSH 0.1.7-rc.1 / 0.2.0-rc.1 / 0.2.1-rc.1（三档，deepseek-ai/deepseek-harness）。",
   "engines": {

package/lib/cleanup-C-92qnDs.js

@@ -0,0 +1,213 @@
+import { n as __exportAll } from "./rolldown-runtime-B4iAMlE-.js";
+import { join } from "node:path";
+import { existsSync, readdirSync, rmSync, statSync } from "node:fs";
+//#region src/trajectory/cleanup.ts
+/**
+* trajectory/cleanup.ts — DSH 平台旧会话自动清理（v1.29，S142 需求③）
+*
+* 背景（实证）：DSH 会话物理存储 = `$DSH_HOME/sessions/`（缺省 ~/.dsh/sessions；
+* base bundle cordis.patch.yml root: dshHomePath('sessions')）。磁盘布局：
+*   <root>/--<project-slug>--/<encoded-session-id>/session[.vN].jsonl(.zstd)
+* **世代（v1.31.13 补）**：宿主自 DSH 0.1.5 起按世代写文件，且迁移**保留源文件**
+* ⇒ 一个会话目录常见 v0 与 v3 两个文件并存。本模块用 `sessionLogArtifacts()` 统一枚举世代。
+* DSH **无删除会话 API**（PersistenceCoordinator 仅 create/append/load/inspect/borrow，
+* 无 delete/purge；workspace archiveSession 只加归档集不删文件）——物理删除只能直接
+* 删文件。删除后一致性（利好）：sessionPersistence.list() = readdir 扫描磁盘现存 →
+* 物理删后 list 不再返回；WorkspaceRegistry 下次启动重建 header index 自动消失。
+*
+* 方案（S142 用户拍板）：lastActive 基准 + 手动触发 + 不过滤不归档直接物理删；
+* 安全底线 = live 会话保护跳过（删正在运行的会话 = 灾难）。
+*
+* 本模块纯逻辑（零 ctx 依赖）：传入 sessionsRoot + liveIds，可单测。
+*/
+var cleanup_exports = /* @__PURE__ */ __exportAll({
+	collectEligibleSessions: () => collectEligibleSessions,
+	cutoffDaysAgo: () => cutoffDaysAgo,
+	findSessionLog: () => findSessionLog,
+	hasSessionLogById: () => hasSessionLogById,
+	performCleanup: () => performCleanup,
+	sessionLogArtifacts: () => sessionLogArtifacts,
+	sessionLogBytesById: () => sessionLogBytesById,
+	sessionsRootDir: () => sessionsRootDir
+});
+/** DSH 会话 root：env DSH_HOME → ~/.dsh（config-ops globalConfigPath 同款推导） */
+function sessionsRootDir() {
+	const dshHome = process.env.DSH_HOME ?? join(process.env.HOME ?? "", ".dsh");
+	return join(dshHome, "sessions");
+}
+/** 一天的毫秒数 */
+const DAY_MS = 864e5;
+/**
+* 扫描 sessions root，列出可清理候选：
+* - 递归 `<root>/<project>/<session-id>/session.jsonl(.zstd)`（任意深度下找 *session* 文件）
+* - 过滤 live（liveIds 集合）——安全底线
+* - 过滤 lastActive >= cutoffMs（最后活动未达阈值 → 保留）
+* root 不存在/为空 → 返回 []（非错误）。
+*/
+function collectEligibleSessions(root, cutoffMs, liveIds = /* @__PURE__ */ new Set()) {
+	if (!existsSync(root)) return [];
+	const out = [];
+	for (const project of readdirSync(root, { withFileTypes: true })) {
+		if (!project.isDirectory()) continue;
+		const projectPath = join(root, project.name);
+		for (const entry of readdirSync(projectPath, { withFileTypes: true })) {
+			if (!entry.isDirectory()) continue;
+			const dirPath = join(projectPath, entry.name);
+			const artifacts = sessionLogArtifacts(dirPath);
+			if (artifacts.length === 0) continue;
+			const log = findSessionLog(dirPath);
+			if (log === null) continue;
+			if (liveIds.has(entry.name)) continue;
+			let mtime = Number.NEGATIVE_INFINITY;
+			for (const artifact of artifacts) try {
+				mtime = Math.max(mtime, statSync(artifact.path).mtimeMs);
+			} catch {}
+			if (!Number.isFinite(mtime)) continue;
+			if (mtime >= cutoffMs) continue;
+			out.push({
+				id: entry.name,
+				project: project.name,
+				logPath: log,
+				lastActiveMs: mtime
+			});
+		}
+	}
+	return out;
+}
+/**
+* 会话日志文件名识别：`session.jsonl` / `session.jsonl.zstd`（= **v0 世代**）/
+* `session.v<N>.jsonl[.zstd]`（= 第 N 世代，DSH 0.1.5 起按世代写文件）。
+* 出处：`@deepseek-ai/dsh-session-persistence-jsonl` 的 `parseSessionFormatLogFilename` 同款形态。
+*/
+const SESSION_LOG_RE = /^session(?:\.v(\d+))?\.jsonl(\.zstd)?$/;
+/**
+* 列出会话目录下的**全部日志世代**，按代递增排序（同代内 `.jsonl` 在前、`.zstd` 在后 = 后者更代表"当前书写格式"）。
+*
+* 为什么需要（R↓，v1.31.13 修复）：宿主自 0.1.5 起改成**按世代写文件**，且迁移**保留源文件**
+* ⇒ 同一会话常见 `session.jsonl.zstd`（v0）与 `session.v3.jsonl.zstd`（v3）**并存**。
+* 旧实现只认前两个名字 → 新格式会话对本模块**完全不可见**（静默 no-op：清理永远不生效、磁盘只涨）。
+*/
+function sessionLogArtifacts(sessionDirPath) {
+	let names;
+	try {
+		names = readdirSync(sessionDirPath);
+	} catch {
+		return [];
+	}
+	const out = [];
+	for (const name of names) {
+		const m = SESSION_LOG_RE.exec(name);
+		if (m === null) continue;
+		out.push({
+			name,
+			generation: m[1] === void 0 ? 0 : Number(m[1]),
+			path: join(sessionDirPath, name)
+		});
+	}
+	return out.sort((a, b) => a.generation - b.generation || (a.name.endsWith(".zstd") ? 1 : 0) - (b.name.endsWith(".zstd") ? 1 : 0));
+}
+/**
+* 在会话目录下找 session 日志文件；无 → null。
+* 多世代并存时返回**最高世代**（= 宿主 `findLog` 选中的当前世代；旧行为对单文件目录完全一致）。
+*/
+function findSessionLog(sessionDirPath) {
+	const artifacts = sessionLogArtifacts(sessionDirPath);
+	const latest = artifacts[artifacts.length - 1];
+	return latest === void 0 ? null : latest.path;
+}
+/**
+* 执行清理（用户拍板：直接物理删，不过滤不归档；dryRun 预览不删）。
+* 删除 = rmSync 整个会话目录（recursive + force）。失败逐个记 errors 不中断。
+*/
+function performCleanup(root, cutoffMs, liveIds = /* @__PURE__ */ new Set(), opts = {}) {
+	const candidates = collectEligibleSessions(root, cutoffMs, liveIds);
+	if (opts.dryRun) return {
+		candidates,
+		result: null
+	};
+	const result = {
+		deleted: [],
+		errors: []
+	};
+	for (const c of candidates) {
+		const dir = dirOf(c.logPath);
+		try {
+			rmSync(dir, {
+				recursive: true,
+				force: true
+			});
+			result.deleted.push(c.id);
+		} catch (e) {
+			result.errors.push({
+				id: c.id,
+				reason: e.message
+			});
+		}
+	}
+	return {
+		candidates,
+		result
+	};
+}
+/** 从日志路径取会话目录（父目录） */
+function dirOf(logPath) {
+	return logPath.slice(0, logPath.lastIndexOf("/")) || logPath;
+}
+/**
+* 某一 dsh 会话（目录名 / 会话 id）的**当前世代日志体积**（字节）。
+*
+* 为什么要它（S142 §0y「旧会话累积 ⇒ dsh 内存崩溃」，所有者令）：
+*   · 宿主恢复/继续一条会话必须**重放全部事件**（`scanLog` → `materializeAppendBatch`）
+*     ⇒ **代价 ∝ 日志体积**；
+*   · 实测（`_tmp/measure-session-load.mjs`，照宿主 `scanZstdFrames` 复刻）：
+*     一条 **72.2 MB**（zstd）的日志 = 35 559 个 frame / 252.6 MB 文本 / 62 680 条事件，
+*     **光是读一遍峰值 RSS +1 175 MB**（探针什么都不保留）；
+*   · 而宿主的解析缓存 `COLD_LOG_MEMO_MAX_ENTRIES = 2` 是**按条数限、不按字节限**的
+*     （`dsh-session-persistence-jsonl/lib/index.js:2175`）⇒ 两条巨日志 = 上限内。
+* 🔴 **在本函数之前，ACC 侧没有任何地方知道"绑定的这条会话日志多大"——这个信号根本不存在。**
+* 这是"靠 agent 自觉 rebuild 不够"的机制层原因（keeper 的 K 量的是**模型上下文**，压缩后回落；
+* 而**日志文件只增不减** ⇒ rebuild 提醒永远不会因为"日志 72 MB"触发）。
+*
+* 只认会话目录（含任意世代日志）；返回**最高世代**的日志（= 宿主 `findLog` 选中的当前世代）。
+* 未命中 / 不可读 → null（非错误，调用方按"未知"处理）。
+* @param root - DSH 会话 root（{@link sessionsRootDir}）
+* @param sessionId - 会话目录名（`.bindings.json` 的键，含 `session-` 前缀）或裸 id
+* @returns 字节数 + 日志绝对路径；未命中 → null
+*/
+function sessionLogBytesById(root, sessionId) {
+	if (sessionId === "" || !existsSync(root)) return null;
+	const dirName = sessionId.startsWith("session-") ? sessionId : `session-${sessionId}`;
+	for (const project of readdirSync(root, { withFileTypes: true })) {
+		if (!project.isDirectory()) continue;
+		const log = findSessionLog(join(root, project.name, dirName));
+		if (log === null) continue;
+		try {
+			return {
+				bytes: statSync(log).size,
+				path: log
+			};
+		} catch {
+			return null;
+		}
+	}
+	return null;
+}
+/**
+* **(c) 绑定一致性兜底**的判据：某会话的日志**是否仍在磁盘上**。
+*
+* 🔴 **fail-closed**：sessions root 本身不存在时**一律返回 true（当作"在"）**——
+* 否则换 `DSH_HOME` / 换机器会让"全部绑定看起来都悬空"，进而误清整张绑定表。
+* 只有"root 在、而这个会话目录确实不在"才算悬空。
+* @param sessionRoot - DSH 会话 root（{@link sessionsRootDir}）
+* @param sessionId - 会话目录名（`.bindings.json` 的键）或裸 id
+*/
+function hasSessionLogById(sessionRoot, sessionId) {
+	if (!existsSync(sessionRoot)) return true;
+	return sessionLogBytesById(sessionRoot, sessionId) !== null;
+}
+/** 便捷：默认 N 天前为 cutoff（供 API/调用方） */
+function cutoffDaysAgo(days, nowMs = Date.now()) {
+	return nowMs - days * DAY_MS;
+}
+//#endregion
+export { hasSessionLogById as n, sessionsRootDir as r, cleanup_exports as t };