@zhushanwen/pi-system-prompt-trace 0.1.6 → 0.1.8

package/README.md

@@ -2,12 +2,12 @@
 
 Session Trace 单元 1（留痕 extension）。system prompt 在 pi 中每次运行时动态重建、默认不落盘——本包在
 system prompt 确立或变化时向 session JSONL 追加留痕 entry，让「resume/reload/换配置前后 prompt 到底是什么」
-可追溯（设计：`docs/page-design/session-trace/design.md` D2）。
+可追溯。
 
 ## 落盘格式
 
 ```ts
-appendEntry("xyz:system-prompt", {
+appendEntry("taiji:system-prompt", {
   version: number;                    // session 内单调递增，首条 1
   hash: string;                       // sha256(fullText) 十六进制
   reason: "initial" | "resume" | "change";
@@ -31,7 +31,7 @@ appendEntry("xyz:system-prompt", {
 |---|---|---|
 | startup / new | initial | 定案 |
 | resume | resume | 定案 |
-| fork / reload | resume | 定案（M0 探针 P2 实测：fork 档读源文件最后留痕，落盘 reason 维持 resume；执行记录见设计 §6.5） |
+| fork / reload | resume | 定案（fork 档读源文件最后留痕，落盘 reason 维持 resume） |
 
 存在 hash 基线（见下）且 prompt 未变时，首个 turn 不写（去重）；需写时（hash 已变）恒写 `resume`（无论 session_start reason）。
 
@@ -39,13 +39,12 @@ appendEntry("xyz:system-prompt", {
 
 1. **进程内 resume（stash）**：`session_before_switch.targetSessionFile` 直读目标 session 文件，取最后一条留痕
    entry 的 hash/version/fullText。switch 会 teardown 并重建 extension runtime，该基线经模块级 stash 跨 runtime 传递。
-2. **fork**：`session_start.previousSessionFile` 直读源 session 文件，取源文件最后一条留痕（D2 v5 定案——
-   常态 /fork 时点 fork 新文件未落盘，不可直读新文件；源文件缺失/未落盘/读取失败 → 视为无基线）。
+2. **fork**：`session_start.previousSessionFile` 直读源 session 文件，取源文件最后一条留痕（常态
+   /fork 时点 fork 新文件未落盘，不可直读新文件；源文件缺失/未落盘/读取失败 → 视为无基线）。
 3. **直读当前 session 文件**：`ctx.sessionManager.getSessionFile()` 直读 JSONL 最后一条留痕，覆盖 reload /
    重启直 spawn resume / new 兜底等没有 switch 事件的链路（文件不存在或无留痕 → 视为无基线）。
 
-原第三档「自持久化小文件 system-prompt-trace-baseline.json」已随 ext-simplify-02 删除——终态唯一持久化源 =
-session JSONL 自身；存量文件成为无读写方孤儿，可安全手动删除（含 `*.tmp_*` 残留）。
+唯一持久化源 = session JSONL 自身。
 
 三档都 miss（无任何基线）时兜底必写：首个 turn 无论 session_start reason 必写一条——
 startup/new → `initial`，resume/fork/reload → `resume`（宁可多写不可漏记）。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zhushanwen/pi-system-prompt-trace",
-  "version": "0.1.6",
-  "description": "System prompt trace extension: appends xyz:system-prompt entries to the session JSONL whenever the effective system prompt is established or changes",
+  "version": "0.1.8",
+  "description": "System prompt trace extension: appends taiji:system-prompt entries to the session JSONL whenever the effective system prompt is established or changes",
   "type": "module",
   "main": "index.ts",
   "keywords": [
@@ -17,7 +17,7 @@
     "src/**/*.ts",
     "README.md"
   ],
-  "xyz-agent": {
+  "taiji": {
     "role": "taiji"
   },
   "pi": {
@@ -33,7 +33,8 @@
     "vitest": "^4.1.8"
   },
   "dependencies": {
-    "@zhushanwen/pi-extension-logger": "0.6.0"
+    "@zhushanwen/pi-ext-guards": "0.4.1",
+    "@zhushanwen/pi-extension-logger": "0.6.1"
   },
   "scripts": {
     "typecheck": "npx tsc --noEmit",

package/src/baseline.ts

@@ -4,7 +4,7 @@
  *
  * readLastPromptFromSessionFile 是三档统一的读取入口：直读 session JSONL
  * （进程内 resume 的 targetSessionFile、fork 的 previousSessionFile、reload / 直启 resume
- * 的 getSessionFile() 目标文件），倒序找最后一条 xyz:system-prompt 留痕 entry。
+ * 的 getSessionFile() 目标文件），倒序找最后一条 taiji:system-prompt 留痕 entry。
  *
  * 所有函数不抛错：读失败返回 null——基线丢失的代价只是
  * 下次 resume 多写一条留痕（设计 D2 已接受），不允许影响 agent 主流程。
@@ -12,12 +12,14 @@
 
 import { readFileSync } from "node:fs";
 
-import { isRecord, isSystemPromptTraceEntryData, SYSTEM_PROMPT_CUSTOM_TYPE } from "./types.js";
+import { isRecord } from "@zhushanwen/pi-ext-guards";
+
+import { isSystemPromptTraceEntryData, SYSTEM_PROMPT_CUSTOM_TYPE } from "./types.js";
 import type { PromptBaseline } from "./types.js";
 
 /**
  * 解析单行 session JSONL 为留痕 entry data（运行时 guard；任何形状不符 / JSON 损坏返回 null）。
- * pi 落盘形状：{"type":"custom","customType":"xyz:system-prompt","data":{...},...}
+ * pi 落盘形状：{"type":"custom","customType":"taiji:system-prompt","data":{...},...}
  * （session-manager.ts:1122 appendCustomEntry）。
  */
 function parseTraceEntryData(line: string): { hash: string; version: number; fullText: string } | null {

package/src/types.ts

@@ -5,15 +5,16 @@
  * 数据形状见 SystemPromptTraceEntryData。
  */
 
+import { isRecord } from "@zhushanwen/pi-ext-guards";
 import type { SessionStartEvent } from "@earendil-works/pi-coding-agent";
 
-/** 留痕 entry 的 customType（xyz: 前缀 = xyz-agent 自定义命名空间）。 */
-export const SYSTEM_PROMPT_CUSTOM_TYPE = "xyz:system-prompt";
+/** 留痕 entry 的 customType（taiji: 前缀 = taiji 自定义命名空间）。 */
+export const SYSTEM_PROMPT_CUSTOM_TYPE = "taiji:system-prompt";
 
 /** 落盘 reason 枚举（initial/resume/change，对齐 DSH request/header 语义，设计 D2）。 */
 export type TraceReason = "initial" | "resume" | "change";
 
-/** appendEntry("xyz:system-prompt", data) 的 data 形状（设计 §5 单元 1）。 */
+/** appendEntry("taiji:system-prompt", data) 的 data 形状（设计 §5 单元 1）。 */
 export interface SystemPromptTraceEntryData {
 	/** session 内单调递增（首条 1；有基线时续接基线版本 +1）。 */
 	version: number;
@@ -46,11 +47,6 @@ export interface SwitchStash {
 	pending: PromptBaseline | null;
 }
 
-/** 运行时类型 guard（taste/no-unsafe-cast：断言必须有运行时 guard，这里干脆不用断言）。 */
-export function isRecord(value: unknown): value is Record<string, unknown> {
-	return typeof value === "object" && value !== null;
-}
-
 /** 留痕 entry data 的运行时 guard（读 JSONL / 测试断言复用）。 */
 export function isSystemPromptTraceEntryData(value: unknown): value is SystemPromptTraceEntryData {
 	if (!isRecord(value)) return false;