@morlay/session-branch
Provider 抽象与高层服务，用于处理基于 DeepSeek Harness 的事件溯源会话的回退、重试和分叉。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @morlay/session-branch@0.0.8Session Branch 以 @morlay/session-branch 发布，当前版本为 0.0.8。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
分支式会话编辑的契约层：定义数据层分支原语 SessionBranchProvider
（rewind / forkFrom / readBranchPrefix）、高层服务 SessionBranch
（ctx.sessionBranch）与共享的版本树投影 buildTimeline。
SessionHandle 的关系上游持久化模型是 SessionHandle（append-only：create / open / append /
flush / stat / list），没有显式回退原语；本包在其旁边定义分支面
provider，负责显式回退与闭合边界派生：
| 面 | 上游 SessionHandle | 本包 SessionBranchProvider |
|---|---|---|
| 覆盖 | 持久读写（append-only） | 显式回退 + 闭合边界派生（分支面） |
| 原语 | create / open / append / flush | readBranchPrefix / forkFrom / rewind |
| 实现方 | JSONL / RDB 等 | RDB 等（@morlay/session-rdb 同时实现两者，形成闭环） |
interface SessionBranchProvider {
readonly name: string;
readBranchPrefix(id, atSeq?, mode?, signal?): Promise<BranchBoundary>;
forkFrom(sourceId, options?, signal?): Promise<SessionId>;
rewind(id, toBoundary, signal?): Promise<SessionPersistenceSnapshot>;
}
readBranchPrefix：定位 atSeq 锚定的闭合 turn/end 边界并返回前缀；
mode: "after"（包含目标轮，fork 语义）/ "before"（排除目标轮，编辑 /
重掷 / 重试语义）。forkFrom：纯 append——新会话（parentSession / seedLength），seed =
边界前缀 + seedSuffix，不触碰源会话。rewind：唯一的显式回退原语，事务整体提交或回滚；支持 live 会话
（内存 log 截断 + 派生缓存复位 + handle cursor / 继承前缀对齐，详见
@morlay/session-rdb 的 docs/branch.md）。buildTimeline(snapshots, readOwnEvents, sessionId) 从会话快照（header
lineage）+ 每会话自有后缀（seq >= seedLength 的 session-branch/version
事件）投影完整版本树。
版本效果事件携带
ignorable: true：非 branch 读者凭信封安全跳过，事件 本身原样落库——live 会话从内存 log 读到效果，cold 会话经读路径恢复效果 详情（见 ADR 0003）。
