@shgroup/dsh-serenity-hooks 1.28.1 → 1.29.0

package/lib/session-cleanup-PahSNvjI.js

@@ -0,0 +1,113 @@
+import { existsSync, readdirSync, rmSync, statSync } from "node:fs";
+import { join } from "node:path";
+//#region src/session-cleanup.ts
+/**
+* session-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.jsonl(.zstd)
+* 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，可单测。
+*/
+/** 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 log = findSessionLog(join(projectPath, entry.name));
+			if (log === null) continue;
+			if (liveIds.has(entry.name)) continue;
+			let mtime;
+			try {
+				mtime = statSync(log).mtimeMs;
+			} catch {
+				continue;
+			}
+			if (mtime >= cutoffMs) continue;
+			out.push({
+				id: entry.name,
+				project: project.name,
+				logPath: log,
+				lastActiveMs: mtime
+			});
+		}
+	}
+	return out;
+}
+/** 在会话目录下找 session 日志文件（.jsonl / .jsonl.zstd）；无 → null */
+function findSessionLog(sessionDirPath) {
+	for (const name of ["session.jsonl", "session.jsonl.zstd"]) {
+		const p = join(sessionDirPath, name);
+		if (existsSync(p)) return p;
+	}
+	return null;
+}
+/**
+* 执行清理（用户拍板：直接物理删，不过滤不归档；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;
+}
+/** 便捷：默认 N 天前为 cutoff（供 API/调用方） */
+function cutoffDaysAgo(days, nowMs = Date.now()) {
+	return nowMs - days * DAY_MS;
+}
+//#endregion
+export { cutoffDaysAgo, performCleanup, sessionsRootDir };

package/lib/session-cleanup.d.ts

@@ -0,0 +1,60 @@
+/**
+ * session-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.jsonl(.zstd)
+ * 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，可单测。
+ */
+/** DSH 会话 root：env DSH_HOME → ~/.dsh（config-ops globalConfigPath 同款推导） */
+export declare function sessionsRootDir(): string;
+/** 一个候选会话（删除前预览信息） */
+export interface CandidateSession {
+    /** 会话 id（目录名） */
+    id: string;
+    /** 项目目录（父目录名，如 --home-yh-home-home-serenity--） */
+    project: string;
+    /** 会话日志文件绝对路径 */
+    logPath: string;
+    /** 最后活动（mtime 退化——日志只追加，mtime ≈ 最后写） */
+    lastActiveMs: number;
+}
+/**
+ * 扫描 sessions root，列出可清理候选：
+ * - 递归 `<root>/<project>/<session-id>/session.jsonl(.zstd)`（任意深度下找 *session* 文件）
+ * - 过滤 live（liveIds 集合）——安全底线
+ * - 过滤 lastActive >= cutoffMs（最后活动未达阈值 → 保留）
+ * root 不存在/为空 → 返回 []（非错误）。
+ */
+export declare function collectEligibleSessions(root: string, cutoffMs: number, liveIds?: ReadonlySet<string>): CandidateSession[];
+/** 在会话目录下找 session 日志文件（.jsonl / .jsonl.zstd）；无 → null */
+export declare function findSessionLog(sessionDirPath: string): string | null;
+/** 删除执行结果 */
+export interface CleanupResult {
+    deleted: string[];
+    /** 尝试删除但失败的会话目录（权限/竞态） */
+    errors: Array<{
+        id: string;
+        reason: string;
+    }>;
+}
+/**
+ * 执行清理（用户拍板：直接物理删，不过滤不归档；dryRun 预览不删）。
+ * 删除 = rmSync 整个会话目录（recursive + force）。失败逐个记 errors 不中断。
+ */
+export declare function performCleanup(root: string, cutoffMs: number, liveIds?: ReadonlySet<string>, opts?: {
+    dryRun?: boolean;
+}): {
+    candidates: CandidateSession[];
+    result: CleanupResult | null;
+};
+/** 便捷：默认 N 天前为 cutoff（供 API/调用方） */
+export declare function cutoffDaysAgo(days: number, nowMs?: number): number;

package/lib/trajectory-assistant.d.ts

@@ -0,0 +1,54 @@
+/**
+ * trajectory-assistant.ts — 关卡化注入的统一命名与风格门面（v0.3，S142）
+ *
+ * 概念（用户拍板 2026-09-05）：dsp 全部"过程中动态提示注入"统一命名为
+ * trajectory-assistant（轨迹助航员）。关卡设计思想塑造**结构与时机**
+ * （何时/何地注入），**不用于提示词用词**（D8 词法原则）——纯游戏黑话
+ * （BOSS/XP/level-up）禁止出现在提示词文本；CHECKPOINT/LIMIT/TUTORIAL 等
+ * 跨领域自然通用词允许。
+ *
+ * 本模块 = token 常量 + level-event 词汇表的**单一真相源**（避免前缀散落
+ * 各文件字符串字面量）+ 风格门面（plain 默认 / metaphor 星舰变体）。
+ * 仅当 style=metaphor 时前缀包装措辞变化；可行动正文不变 → 零行为漂移。
+ *
+ * 设计简写（L0 环境 / L1 教程 / L2 目标 / L3 检查点 / L4 极限 / L5 守卫 /
+ * L6 结算）仅在本模块注释与内部文档出现，永不浮现在提示词文本。
+ *
+ * 结算（settlement）挂点：D6 用户拍板——若 CCC 有标准 SESSION 复盘仪式，
+ * 结算视图归 trajectory-assistant。当前 close/archive 无复盘摘要 → 机制
+ * 延后，仅留 onSettlement 导出 seam（OP-1，无调用者）。
+ */
+/** 可见提示词前缀用词（跨领域自然词，D8：无游戏黑话） */
+export declare const EVENT_LABEL: {
+    /** 计分同步提醒（原 TRAJECTORY-STEWARD） */
+    readonly checkpoint: "CHECKPOINT";
+    /** 上下文极限重建提醒（原 TRAJECTORY；LIMIT 替代被否的 BOSS——自然词） */
+    readonly limit: "LIMIT";
+    /** 极限强制升级（原 TRAJECTORY-ESCALATED） */
+    readonly limitMandatory: "LIMIT · MANDATORY";
+    /** 重建锚点头部（原 TRAJECTORY-REBUILD） */
+    readonly rebuild: "REBUILD";
+    /** 敏感输出边界守卫（原 SERENITY OUTPUT GUARD） */
+    readonly guard: "BOUNDARY GUARD";
+};
+/** 家族标识（所有动态注入统一前缀） */
+export declare const ASSISTANT_PREFIX = "TRAJECTORY-ASSISTANT";
+/** 完整 token：`[TRAJECTORY-ASSISTANT · <LABEL>]` */
+export declare function eventToken(event: keyof typeof EVENT_LABEL): string;
+/** ACK 确认码前缀（recorded/skipped 语义不变，仅家族名更新） */
+export declare const ACK_PREFIX = "TRAJECTORY-ASSISTANT-recorded";
+export declare const ACK_SKIP_PREFIX = "TRAJECTORY-ASSISTANT-skipped";
+/** 风格档位：plain（默认，精确文本）/ metaphor（借星舰词——产品隐喻非游戏词） */
+export type TrajectoryStyle = 'plain' | 'metaphor';
+/**
+ * 按风格生成前缀 token。plain = eventToken()（原样）；metaphor 仅当有
+ * 星舰化变体时替换用词（当前等价保留——星舰词库隐喻域的既有措辞即
+ * "context limit/deck check" 类，不强制替换；扩展点留给未来实验）。
+ */
+export declare function styledToken(event: keyof typeof EVENT_LABEL, style?: TrajectoryStyle): string;
+/**
+ * 结算 seam（OP-1/D6）：未来标准 SESSION 复盘仪式接入点。当前无调用者，
+ * 仅导出契约：onSettlement(cb) 在"工作完成且被用户认可"时触发——该信号
+ * 尚无可靠自动检测（D2 用户拍板记录为未解问题），实现留待仪式落地。
+ */
+export declare function onSettlement(_cb: (sessionId: string) => void): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.28.1",
+  "version": "1.29.0",
   "description": "宁静号 ACC harness — Native Cordis 插件（DeepSeek Harness 运行时）。真实 DSH 工具注册（cc_fs/session/acc_msm 等 9 工具）+ 拦截缝机械约束（safe-mode/路径守卫/会话落盘）+ 系统提示词注入（ACC/CCE/Constraints/SKILL/Session 五块）。适配 DSH 公开版（deepseek-ai/deepseek-harness 0.1.0-rc）。",
   "license": "MIT",
   "repository": {