@zhushanwen/pi-rename-session 0.9.0 → 0.9.1

package/README.md

@@ -53,7 +53,7 @@ pi install npm:@zhushanwen/pi-rename-session
 2. **config 的 `enabled` 字段**（默认 false）：flag 不存在时生效，是原生 pi CLI 用户的开关。
 3. **默认值**（false）：以上两层均未设置时。
 
-> [HISTORICAL] 原最高优先级的 `PI_RENAME_*` 环境变量覆盖层已删（全仓 0 生产 setter，4 键中 3 键从未被用过）——预置该前缀的环境变量不再有任何效果。rename-session 相关精简项裁决见本仓 `docs/design/rename-session-three-modes.md` 附录 A。
+> [HISTORICAL] 原最高优先级的 `PI_RENAME_*` 环境变量覆盖层已删（全仓 0 生产 setter，4 键中 3 键从未被用过）——预置该前缀的环境变量不再有任何效果。rename-session 相关精简项裁决见原设计文档 rename-session-three-modes.md 附录 A（已删除，git 可追溯）。
 
 ## 命令
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/pi-rename-session",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "type": "module",
   "main": "index.ts",
   "xyz-agent": {
@@ -33,8 +33,9 @@
     "pi-package"
   ],
   "dependencies": {
+    "@zhushanwen/pi-ext-guards": "0.4.0",
     "@zhushanwen/pi-extension-logger": "0.6.0",
-    "@zhushanwen/pi-llm-shared": "0.7.0"
+    "@zhushanwen/pi-llm-shared": "0.8.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.9",

package/skills/rename-session-ext-config/SKILL.md

@@ -102,7 +102,7 @@ interface RenameSessionConfig {
 }
 ```
 
-> [HISTORICAL] 原最高优先级的 `PI_RENAME_*` 环境变量覆盖层已删（全仓 0 生产 setter）——预置该前缀的环境变量不再有任何效果。rename-session 相关精简项裁决见本仓 `docs/design/rename-session-three-modes.md` 附录 A。
+> [HISTORICAL] 原最高优先级的 `PI_RENAME_*` 环境变量覆盖层已删（全仓 0 生产 setter）——预置该前缀的环境变量不再有任何效果。rename-session 相关精简项裁决见原设计文档 rename-session-three-modes.md 附录 A（已删除，git 可追溯）。
 
 ## 配置生效时机
 

package/src/llm.ts

@@ -2,10 +2,11 @@ import path from "node:path";
 
 import type { AssistantMessage, Message, Usage } from "@earendil-works/pi-ai";
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { isRecord } from "@zhushanwen/pi-ext-guards";
 import { getLogger } from "@zhushanwen/pi-extension-logger";
-import { callLLM, resolveModel } from "@zhushanwen/pi-llm-shared";
+import { callLLM, joinTextBlocks, resolveModel } from "@zhushanwen/pi-llm-shared";
 
-import { type RenameSessionConfig, cleanTitle } from "./pure.js";
+import { type RenameSessionConfig, cleanTitle, truncateCodePoints } from "./pure.js";
 
 const logger = getLogger("rename-session");
 
@@ -36,7 +37,7 @@ export const RENAME_INSTRUCTION =
  * sessionDir 路径含 subagents 段 → 是 subagent 子进程 session，跳过 rename。
  *
  * 跨包路径耦合（constraints.json C-ext-21）：`subagents` 目录布局由 xyz-agent 的
- * `packages/subagent-core/src/execution/path-encoding.ts`（getSubagentSessionDir /
+ * `packages/subagent-core/src/execution/assembly/path-encoding.ts`（getSubagentSessionDir /
  * encodeCwd）定义并写入。本包 role=universal，不 import subagent-core
  * （import 会把 universal 包绑死在 xyz-agent 体系上），只按路径形态守卫——
  * path-encoding.ts 侧有对向注释互指。改 subagent 目录布局必须双侧同步改。
@@ -53,23 +54,10 @@ interface EntryLike {
 }
 
 // ──────────────────────── 标题输入构造（两段信号：首条 user prompt / 触发 turn 最终回复） ────────────────────────
-
-/** unknown → Record 的运行时守卫：extractUserPromptText 逐字段消费 session entries 的宽松数据，字段存在性与类型由守卫核实（不使用 as any）。 */
-function isRecord(value: unknown): value is Record<string, unknown> {
-	return typeof value === "object" && value !== null;
-}
-
-/** 拼接 content 内 type==="text" blocks 的文本（join(" ")，跳过非 text block 与非 string text）。 */
-function joinTextBlocks(content: unknown): string {
-	if (!Array.isArray(content)) return "";
-	const texts: string[] = [];
-	for (const block of content) {
-		if (isRecord(block) && block.type === "text" && typeof block.text === "string") {
-			texts.push(block.text);
-		}
-	}
-	return texts.join(" ");
-}
+//
+// isRecord / joinTextBlocks 均为共享导出（ext-simplify-17 D3/D7）：isRecord 用 ext-guards
+// 排数组严版（数组 message 输入下三消费点 continue/return "" 殊途同归，等价论证见设计
+// 文档 §3.1 D3）；joinTextBlocks 用 llm-shared unknown 安全内核（不 trim，trim 是调用方策略）。
 
 /**
  * 取 session entries 中首条 user message 的 prompt 文本（标题输入信号之一）。
@@ -116,13 +104,11 @@ const MAX_TITLE_INPUT_CODE_POINTS = 4000;
 
 /**
  * 按 Unicode 码点截断标题输入段（两段信号各 4000 码点，中文场景约 4k token/段，成本可控）。
- * Array.from 按码点切分，星面字符（emoji 等，占 2 个 UTF-16 码元）不会被劈成半个代理对；
- * 超长才追加 '…' 后缀，≤ 上限（含恰好等于）原样返回。
+ * 截断内核见 pure.ts truncateCodePoints（ext-simplify-17 D13 收口）；超长才追加 '…' 后缀，
+ * ≤ 上限（含恰好等于）原样返回。
  */
 export function truncateForTitle(text: string): string {
-	const chars = Array.from(text);
-	if (chars.length <= MAX_TITLE_INPUT_CODE_POINTS) return text;
-	return chars.slice(0, MAX_TITLE_INPUT_CODE_POINTS).join("") + "…";
+	return truncateCodePoints(text, MAX_TITLE_INPUT_CODE_POINTS, "…");
 }
 
 /**
@@ -195,16 +181,17 @@ const PREVIEW_TAIL_CODE_POINTS = 100;
 
 /**
  * debug 日志的文本预览（≤300 码点直接全文；超长输出 head 200 码点 + 字面 … + tail 100 码点
- * （head/tail 双段支撑 E2E 对长 prompt 首尾片段的断言）。按码点截断（与 truncateForTitle 同单位，
- * Array.from 切分，代理对/emoji 不被劈开）；e2e/harness.mjs 的 rebuildPreview 是同构实现，两处必须同步改。
+ * （head/tail 双段支撑 E2E 对长 prompt 首尾片段的断言）。截断内核见 pure.ts truncateCodePoints
+ * （ext-simplify-17 D13 收口，双段形态经 head/keepTail 参数表达——300/200/100 是 15 号 §6.4
+ * D4 裁决的三个独立契约数字）；e2e/harness.mjs 的 rebuildPreview 是同构实现，两处必须同步改。
  */
 function previewText(text: string): string {
-	const chars = Array.from(text);
-	if (chars.length <= PREVIEW_MAX_CODE_POINTS) return text;
-	return (
-		chars.slice(0, PREVIEW_HEAD_CODE_POINTS).join("") +
-		"…" +
-		chars.slice(-PREVIEW_TAIL_CODE_POINTS).join("")
+	return truncateCodePoints(
+		text,
+		PREVIEW_MAX_CODE_POINTS,
+		"…",
+		PREVIEW_HEAD_CODE_POINTS,
+		PREVIEW_TAIL_CODE_POINTS,
 	);
 }
 

package/src/pure.ts

@@ -4,8 +4,11 @@ import { dirname, join } from "node:path";
 import { getAgentDir } from "@earendil-works/pi-coding-agent";
 import type { ModelThinkingLevel } from "@earendil-works/pi-ai";
 
+import { isEnoentError } from "@zhushanwen/pi-ext-guards";
 import {
+	isThinkingLevel,
 	loadConfig,
+	normalizeModelSelector,
 	saveConfig,
 	type ModelSelector,
 } from "@zhushanwen/pi-llm-shared";
@@ -44,17 +47,6 @@ export interface RenameSessionConfig {
 	thinkingLevel: ModelThinkingLevel;
 }
 
-/** 合法 thinking 级别清单（与 pi-ai ModelThinkingLevel 一致；normalize 校验用）。Set 免 as 断言。 */
-const THINKING_LEVELS: ReadonlySet<string> = new Set([
-	"off",
-	"minimal",
-	"low",
-	"medium",
-	"high",
-	"xhigh",
-	"max",
-]);
-
 // ──────────────────────── 枚举校验 ────────────────────────
 
 /** 合法触发模式清单（与 RenameMode 一致；normalize 校验用）。Set 免 as 断言。 */
@@ -68,14 +60,6 @@ function isRenameMode(raw: unknown): raw is RenameMode {
 	return typeof raw === "string" && RENAME_MODES.has(raw);
 }
 
-/**
- * 类型谓词：unknown 是否为合法 thinking 级别（normalizeRenameConfig 校验用，单点断言）。
- * Set.has 运行时兜底 + 类型收窄，调用方无需再断言。
- */
-function isThinkingLevel(raw: unknown): raw is ModelThinkingLevel {
-	return typeof raw === "string" && THINKING_LEVELS.has(raw);
-}
-
 /** 默认配置：关闭、空 ref（跟随会话主模型，见 llm.ts 的空 ref fallback）、first-stop 触发、标题上限 50、不启用 thinking。 */
 export const DEFAULT_RENAME_CONFIG: RenameSessionConfig = {
 	enabled: false,
@@ -128,8 +112,7 @@ export function setAutoRenameSwitch(enabled: boolean): void {
 			rmSync(flagPath);
 		} catch (e: unknown) {
 			// flag 不存在视为已关（吞 ENOENT）；其他错误（如权限）如实抛出，不静默
-			const code = (e as NodeJS.ErrnoException).code;
-			if (code !== "ENOENT") throw e;
+			if (!isEnoentError(e)) throw e;
 		}
 	}
 }
@@ -158,6 +141,7 @@ export function normalizeRenameConfig(raw: unknown): RenameSessionConfig {
 			? obj.maxTitleLength
 			: DEFAULT_RENAME_CONFIG.maxTitleLength;
 
+	// normalizeModelSelector：llm-shared 导出（ext-simplify-17 D6 收口）
 	const model = normalizeModelSelector(obj.model) ?? DEFAULT_RENAME_CONFIG.model;
 
 	const thinkingLevel = isThinkingLevel(obj.thinkingLevel)
@@ -167,16 +151,6 @@ export function normalizeRenameConfig(raw: unknown): RenameSessionConfig {
 	return { enabled, model, mode, maxTitleLength, thinkingLevel };
 }
 
-/** 校验 ModelSelector：只支持 ref 精确指定，其余形式非法返回 null。 */
-function normalizeModelSelector(raw: unknown): ModelSelector | null {
-	if (typeof raw !== "object" || raw === null || Array.isArray(raw)) return null;
-	const obj = raw as Record<string, unknown>;
-	if (obj.type === "ref" && typeof obj.ref === "string") {
-		return { type: "ref", ref: obj.ref };
-	}
-	return null;
-}
-
 /**
  * 加载配置（mtime+size 缓存；文件缺失/损坏返回默认，不抛错）。
  *
@@ -258,6 +232,36 @@ export function countSuccessfulAssistantReplies(entries: ReadonlyArray<EntryLike
 
 // ──────────────────────── 标题清洗 ────────────────────────
 
+/**
+ * 按 Unicode 码点截断（ext-simplify-17 D13：收口包内三处同构 `Array.from` 骨架——
+ * cleanTitle / truncateForTitle / previewText，三处差异全部参数化）。
+ *
+ * Array.from 按码点切分，星面字符（emoji 等，占 2 个 UTF-16 码元）不会被劈成半个代理对。
+ * 码点数 ≤ max（含恰好等于）原样返回；超长返回「前 head 码点 + tail + 原文最后 keepTail 码点」。
+ *
+ * @param max 判定阈值：码点数 ≤ max 原样返回（与 head 独立——previewText 的 300/200/100 是
+ *   15 号 §6.4 D4 裁决的三个独立契约数字，不得由 head+keepTail 推导）
+ * @param tail 超长时追加在 head 段后的字面中缀（如 "…"；单段形态传 ""）
+ * @param head 超长时保留的头部码点数（默认 = max，单段形态下阈值即截断长度）
+ * @param keepTail 超长时保留的原文尾部码点数（默认 0 = 单段形态；双段形态的调用方
+ *   自负 head/keepTail 不重叠——本包内 previewText 的 300/200/100 在超长区间恒不重叠）
+ */
+export function truncateCodePoints(
+	text: string,
+	max: number,
+	tail: string,
+	head = max,
+	keepTail = 0,
+): string {
+	const chars = Array.from(text);
+	if (chars.length <= max) return text;
+	return (
+		chars.slice(0, head).join("") +
+		tail +
+		(keepTail > 0 ? chars.slice(-keepTail).join("") : "")
+	);
+}
+
 /**
  * rename 专属后处理：去首尾成对引号（单/双/中文）+ markdown 强调标记（* ** ` _）+ 尾部标点，按 Unicode 码点截断。
  *
@@ -281,8 +285,6 @@ export function cleanTitle(content: string, maxLength: number): string {
 		.trim();
 	if (!cleaned) return "";
 
-	// 按 Unicode 码点截断（避免截断多字节字符）
-	const chars = Array.from(cleaned);
-	if (chars.length <= maxLength) return cleaned;
-	return chars.slice(0, maxLength).join("");
+	// 按 Unicode 码点截断（避免截断多字节字符；无尾部后缀的单段形态）
+	return truncateCodePoints(cleaned, maxLength, "");
 }