dsh-spirit 0.3.0 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/CHANGELOG.md +150 -0
  2. package/dist/client.js +601 -25
  3. package/dist/config.js +25 -0
  4. package/dist/contract.d.ts +267 -5
  5. package/dist/contract.js +40 -4
  6. package/dist/db/migrate.d.ts +1 -1
  7. package/dist/db/migrate.js +28 -1
  8. package/dist/db/schema.d.ts +11 -1
  9. package/dist/db/schema.js +125 -1
  10. package/dist/distill/llm.d.ts +11 -0
  11. package/dist/distill/llm.js +8 -0
  12. package/dist/distill/prompts.d.ts +1 -1
  13. package/dist/distill/prompts.js +7 -2
  14. package/dist/distill/ruminate.d.ts +7 -1
  15. package/dist/distill/ruminate.js +8 -3
  16. package/dist/distill/runtime-route.d.ts +24 -0
  17. package/dist/distill/runtime-route.js +55 -0
  18. package/dist/experience/cues.d.ts +3 -0
  19. package/dist/experience/cues.js +5 -4
  20. package/dist/experience/events.d.ts +5 -0
  21. package/dist/experience/events.js +6 -1
  22. package/dist/hooks/ontology-observe.d.ts +33 -0
  23. package/dist/hooks/ontology-observe.js +110 -0
  24. package/dist/hooks/txn-observe.d.ts +25 -0
  25. package/dist/hooks/txn-observe.js +65 -0
  26. package/dist/index.js +121 -2
  27. package/dist/ontology/anchor.d.ts +31 -0
  28. package/dist/ontology/anchor.js +29 -0
  29. package/dist/ontology/backfill.d.ts +67 -0
  30. package/dist/ontology/backfill.js +255 -0
  31. package/dist/ontology/extractor.d.ts +94 -0
  32. package/dist/ontology/extractor.js +292 -0
  33. package/dist/ontology/prompts.d.ts +53 -0
  34. package/dist/ontology/prompts.js +159 -0
  35. package/dist/ontology/scrub.d.ts +23 -0
  36. package/dist/ontology/scrub.js +40 -0
  37. package/dist/ontology/watcher.d.ts +53 -0
  38. package/dist/ontology/watcher.js +173 -0
  39. package/dist/ontology/workspace.d.ts +17 -0
  40. package/dist/ontology/workspace.js +39 -0
  41. package/dist/rpc.d.ts +47 -0
  42. package/dist/rpc.js +236 -2
  43. package/dist/sea/scene.d.ts +13 -0
  44. package/dist/sea/scene.js +41 -8
  45. package/dist/slot/render.d.ts +22 -5
  46. package/dist/slot/render.js +39 -4
  47. package/dist/spirit.d.ts +13 -1
  48. package/dist/spirit.js +17 -1
  49. package/dist/store/ontology.d.ts +163 -0
  50. package/dist/store/ontology.js +490 -0
  51. package/dist/store/transaction.d.ts +151 -0
  52. package/dist/store/transaction.js +388 -0
  53. package/dist/transaction/collector.d.ts +78 -0
  54. package/dist/transaction/collector.js +229 -0
  55. package/dist/transaction/gate.d.ts +27 -0
  56. package/dist/transaction/gate.js +45 -0
  57. package/dist/transaction/prompts.d.ts +50 -0
  58. package/dist/transaction/prompts.js +149 -0
  59. package/dist/transaction/watcher.d.ts +73 -0
  60. package/dist/transaction/watcher.js +222 -0
  61. package/dist/types.d.ts +33 -0
  62. package/dist/types.js +29 -0
  63. package/dist/words.d.ts +26 -0
  64. package/dist/words.js +52 -0
  65. package/dsh.plugin.json +4 -4
  66. package/locale/de.json +6 -0
  67. package/locale/en.json +6 -0
  68. package/locale/es.json +6 -0
  69. package/locale/fr.json +6 -0
  70. package/locale/it.json +6 -0
  71. package/locale/ja.json +6 -0
  72. package/locale/ko.json +6 -0
  73. package/locale/ru.json +6 -0
  74. package/locale/zh.json +6 -0
  75. package/package.json +15 -12
package/CHANGELOG.md CHANGED
@@ -17,6 +17,156 @@
17
17
  把静默为空读成了功能正常。不升 `warn`(那会造一屏假故障),只把 0 显示出来;未探到 ⇒ 不显示
18
18
  (**未知不当 0**)。
19
19
 
20
+ ## 0.6.1
21
+
22
+ - **本体面可搜**(用户点单:本体类为什么不能搜索):「翻阅 · 本体」的实体/任务线子页新增搜索框(Enter 提交)——实体按名字/别名 LIKE、任务线按标题 LIKE;空词回全量,切子页自动清。反馈面是追加型真源,无搜索词表不提供。
23
+ - 宿主:`entity-graph`/`task-list` 接受 `q`(LIKE 字面量转义,%/_ 不当通配符;ASCII 大小写不敏感);顺手接上契约里声明了但一直没接线的 `kind` 过滤。
24
+ - 接 0.6.0:本体交付点入星海(青绿星,只读);接 0.5.9:头部刷新接通翻阅面。
25
+
26
+ ## 0.6.0
27
+
28
+ - **本体交付点入星海**(用户点单:本周/本体的内容不渲染到星海是个问题):`sea-graph` 现在把本体轨交付(`dlv-` 行,上限 500)作为 `kind:'delivery'` 点合入星图——同图异色(青绿)、同尺度老化、同会话时间邻近自动连线。翻阅面(本周/本体)有的记录,星图上也能看见。
29
+ - 纪律:交付点只读——★反馈仍只写情绪轨(详情卡对 delivery 点隐藏 ★);写侧 lane 词表不动,`onto` 只在读侧投影;步骤遥测行(tier3)不入图;backfill 行照画(排除只针对注入不针对展示)。
30
+ - 接 0.5.9:头部「刷新/⟲」接通翻阅面(按当前视图重取条目/本周/本体)。
31
+
32
+ ## 0.5.9
33
+
34
+ - **头部「刷新/⟲」接通翻阅面**(用户实报:重建期间这两个按钮对翻阅/本体面没用):此前它们只重拉星图(sea-graph)/重置图视图。现新增 refreshToken:「刷新」= 重拉星图 + 按当前视图重取(条目流/本周/本体三面);「⟲」= 重置图视图 + 同样重取。重建跑着时不离开翻阅面也能拉新。
35
+
36
+ ## 0.5.8
37
+
38
+ 空 workspaceId 的**修复链**(用户点单:fallback 是全局,但理论上得先修复到对应范围):
39
+
40
+ - 新增 `resolveWorkspaceId`(ontology/workspace.ts):候选值(在线 header / 回填 DRSC cwd)非空⇒直用;空⇒反查同会话既有记录(txn_entry→experience,取最近非空非全局的 workspace_id)修到对应范围;仍无从可考⇒落 `ws:global` 全局桶。
41
+ - 全局桶是**兜底不是首选**:数据照落不丢(写侧闸仍拒空串,纪律不变);翻阅面全局视图(空 workspaceId 查询)含它,注入读面按工作区过滤——归属范围不确定的历史不漏进无关工作区上下文;全局桶值自身不当反查证据二次传播。
42
+ - 接线两处:回填(sessions 无 cwd 时)+ 在线反馈捕获旁路(事件头缺工作区时)。
43
+
44
+ ## 0.5.7
45
+
46
+ 全记忆重建"扫完全程却零记录"的真因修复(真机实锤:水位 132 会话 done、本体表全空):
47
+
48
+ - **workspaceId 传空串被 store 闸整批拒收**:回填把每个会话的 workspaceId 写死 `''`,而 `TxnStore.insert` 拒空 workspaceId ⇒ 每条 delivery 都被静默拒,抽取器却仍报 done。现回填透传会话 `cwd`(与在线 `workspaceIdOfAgent` 取 session header.cwd 同源)。
49
+ - **零产出不再当成功**:非空批落库 0 条 ⇒ 如实 failed(区分"回包不可解析/截断"与"全数被拒"两类文案);旧版回包被 max_tokens 截断后解析 0 行也算"成功",毒水位就是这么来的。
50
+ - **输出预算随批扩**:固定 1600 token 管 8 行批必截断;改按单行 700 预算×批长,封顶 8000。
51
+ - **水位自愈**:每次重建开场把"done 却库里查无 dlv 行"的毒标记摘掉重进重建——已被旧版误标的 132 个会话不需手动清库即可补回。
52
+ - **主键冲突算已记录**:续跑重扫早先已落库的行不再被误判零产出。
53
+ - 面板无需操作:重启后再点一次「全记忆重建」即自动自愈重跑。
54
+
55
+ ## 0.5.6
56
+
57
+ 全记忆重建跑真机 130 会话 / 912 轮时在中途挂了(报 `This operation was aborted`)。三个真因一并修:
58
+
59
+ - **超时预算错乘**:本体抽取误用 `txn.collectorTimeoutMs`(30s)——一批要读十几轮正文、吐十几行 JSON,大模型上稳定撑爆。改取 `max(distill.timeoutMs, 180s)`(本体是冷路径,不影响每轮热路)。
60
+ - **abort 原文没法看**:超时自杀抛的是 DOMException(`This operation was aborted`),面板上等于没说。现换成可读的:`llm 超时被中止(180s,模型 xxx,已收 N 字)`。
61
+ - **一粒老鼠屎坏一锅**:原来一批/一个会话出错就整次重建中止。现在:
62
+ - 抽取器失败**自动对半拆批重试**(8→4→2→1),把坏轮隔离到最小批,好轮照常落库;配置类错误(无路由/忙)不拆。
63
+ - 回填单会话失败**不中断**,继续跑后面的;失败会话不标 done ⇒ 再点一次只补它们(已完成的不重做)。
64
+ - 每会话都刷水位(断点续跑),批从 16 轮缩到 8 轮(单次更快、更不容易撞超时)。
65
+ - 面板 done 阶段显示「部分会话未完成 N · 再点一次可续跑」,不再把部分失败伪装成完成。
66
+
67
+ ## 0.5.5
68
+
69
+ - **全记忆重建升成异步任务 + 进度条 + 批次进度管理**(照长觉 sleep-run/sleep-status 范式,对齐 prime-memory):不再一个哑的「正在重建…」。
70
+ - `ontology-backfill-run` 改为**立即受理**(返回 accepted),新增 `ontology-backfill-status` 轮询面(phase:scanning/extracting/done/failed + totalSessions/doneSessions/totalTurns/doneTurns)。
71
+ - 「做梦」页重建块:轮询 1.5s 一轮,画**进度条**(doneSessions/totalSessions)+ 会话/轮次计数;失败直接显真实原因。
72
+ - 后端 `BackfillRunner`:`start()` 异步受理 + `status()` 进度快照;同步占 running 防连点双跑。
73
+
74
+ ## 0.5.4
75
+
76
+ - **全记忆重建失败不再只说 degraded**:抽取器 `runInner` 的异常现在 `logger.warn` 落日志(此前只塞内存 status),`BackfillRunner` 把 `status.error` 原文上浮到 `SpiritBackfillRunResult.error`,面板直接显示真正原因(路由/超时/解析/忙)。
77
+ - **修掉误报 degraded 的真因之一**:`processBatch` 遇到直播抽取正在跑(`this.running`)时**等它结束**(≤ 60s)再上批,而不是立刻返回一个非 done 状态被判成 degraded。
78
+
79
+ ## 0.5.3
80
+
81
+ - **「全记忆重建」入口移到「做梦」页**(用户点名:它属记忆蒸馏,应与长觉同居):放在长觉块/上次长觉下方,与蒸馏同区;撤掉 0.5.2 放错的设置页入口。
82
+ - 「翻阅·本体」里的「回填历史」保留作上下文次级入口。
83
+
84
+ ## 0.5.2
85
+
86
+ - **全记忆重建真接线**(0.5.1 的「回填历史」其实没生效的根因):旧实现走异步 `enqueue`,而抽取器 `QUEUE_MAX≈24` + 5 分钟去重窗会把大批静默丢掉、又把会话误标 done ⇒ 点了也白点。现改为回填直接调 `extractor.processBatch`(绕过队列上限/去重窗/**同步 await** 真落库),逐会话按批结束才标 done;失败不标 done(可续跑,delivery id 主键幂等)。
87
+ - **设置页新增「全记忆重建」入口**(面板可见一键):扫全部历史会话重建本体层,回显已重建/扫会话/入队轮次。此前入口只在「翻阅·本体」深处,用户找不到。
88
+
89
+ ## 0.5.1
90
+
91
+ 本体层**真机可见化**(0.5.0 装了但看不出变化的修复):
92
+
93
+ - **本体层缺省开**:`ontology.enabled` 与 `ontology.backfillEnabled` 由 false 改 true(脱敏/来源分级/更正通道三条硬前置已就绪)。此前缺省关 ⇒ 采集/抽取零运行,面板与 0.4.0 毫无差别。
94
+ - **面板真开关**:新增 `live.ontologyEnabled`(volatile,缺省开),设置页有「本体层」勾选框——有效 = 静态总闸 ∧ 本键,不再是后台藏着的阻塞默认。
95
+ - **历史回填按钮**:「翻阅 · 本体」面新增「回填历史」,一键跑 `ontology-backfill-run(dryRun:false)` 把既往会话扫进本体层,回显扫了多少会话/入队多少轮。
96
+ - 面板「本体」面(任务线 / 实体 / 反馈 + 点开看做成)此前已在 0.5.0,但缺省关时是空的,现随总闸开启即长数据。
97
+
98
+ ## 0.5.0
99
+
100
+ 本体层记忆:把 0.4.0 的"事务遥测"升级为"语义本体"——采集对象从"哪个工具报错/哪个 basename"
101
+ 换成"从做了什么、聊了什么里抽出交付·实体·关系·任务线",并用**按来源分级信任**取代旧的
102
+ "绝不读正文"(用户原文/助手动作可读进脱敏层,工具返回外部正文仍禁入)。**缺省关**(`ontology.enabled=false`):关时零采集零落库零注入。
103
+
104
+ ### 新增
105
+
106
+ - **四级 salience 分层**:反馈(tier1) > 轮次总结(tier2) > 步骤(tier3) > 被掩埋思考(tier4)。注入丢尾按此逆序;
107
+ 步骤/思考默认不进注入。
108
+ - **评价一等记录 + 锚定**:用户"干的不错/不对"等不再只是埋在批里的意图 bit,而是落 `evaluation` 表并**锚定到具体
109
+ delivery**(显式 cue→同任务→时间邻近→仍不确定则落 unresolved 悬置池,绝不硬绑),使"上次夸的那回"可解析。
110
+ - **实体注册表 + 关系 + 任务线程**:`entity`(人/项目/模块/概念/资源,五 kind,importance/首末出现/别名)、
111
+ `delivery_entity`、`entity_edge`、`task`+`task_delivery`(status 生命周期 + next_step)。
112
+ - **OntologyExtractor**:异步批(寄生 collector/ruminate 节律,严禁每轮同步 LLM)读正文语义→产出
113
+ delivery/entities/relations/task;入库前过 secret/PII 脱敏 + INJECTION_PATTERNS。
114
+ - **注入三段位**:卡新增 `反馈:` / `线程:` 段 + 保留 `事务(做成):`,按 salience 逆序丢尾,指纹只吃稳定 gist。
115
+ - **查询面**:`evaluation-list` / `entity-graph` / `entity-lookup` / `task-list` / `task-detail`;
116
+ `ontology-backfill-run`(历史回填,缺省 dryRun,产物打 TRUST_BACKFILL 不进注入)。
117
+ - **历史回填**:经 DRSC API 扫既有会话(不直读其 db),确定性 id 幂等,backfillEnabled 门控 + secret 脱敏。
118
+
119
+ ### 变更
120
+
121
+ - **schema v7→v8**:txn_entry 升格 delivery(+superseded_by/salience_tier/turn 区间)+ 六张本体表。
122
+ - **旧的"绝不读正文"红线细化**:按来源分级(用户/助手可读进脱敏语义层,工具返回正文仍禁)。
123
+
124
+ ## 0.4.0
125
+
126
+ 语义工作记忆:在此前的"情绪日记"(只记结构信号、不读正文)之外,**并行新增一条事务轨**,
127
+ 让角色记住"做过什么具体事"——用户态度信号、会话级事务摘要、时间线(上周做了什么)、资源图谱
128
+ (这件事牵涉哪些文件/人/工具)。**双轨物理隔离**:情绪轨(`TurnWatcher → deriveMood → 注入`)
129
+ 一字不改,`deriveMood` / 注入指纹 / 防注入三条红线全部不动;事务条目走独立通道、独立表、
130
+ 独立注入段位。**缺省关**(`txn.enabled=false`):关时零采集、零落库、零注入、零副作用。
131
+
132
+ ### 新增
133
+
134
+ - **存储 schema v6 → v7**:新增两张工作记忆真源表 `txn_entry`(四级形态:`card_line`≤60 字进卡 /
135
+ `summary`~500 字存库衍生物 / `gist_key` / `semantic_json`)与 `txn_cues`(资源键,只存 basename)。
136
+ 加法迁移,`IF NOT EXISTS` 幂等;老库重开前向迁移,已有数据不回填(缺列即 null)。
137
+ - **事务采集链**:`TransactionWatcher`(与 TurnWatcher 并列 observe 同一事件流,只取 todo 标题 /
138
+ 工具 basename / 意图 bit,**绝不吃工具返回正文**)+ `TxnCollector`(turn/end 后异步攒批、
139
+ fire-and-forget 调 LLM 出摘要,复用长觉的退避三件套,**严禁每轮同步 LLM**)。
140
+ - **注入卡事务段**:卡新增 `事务:<card_line>` 段(紧跟状态段)。**只有 `card_line` 进卡与进指纹**,
141
+ `summary` 属 LLM 衍生物,与感受句同守 G15——禁入 `deriveMood`、禁入注入、禁入指纹(否则每轮
142
+ 唯一 ⇒ churn 100%)。关轨时该段整体省略,输出与旧四段形状逐字节相同。
143
+ - **长觉原料混喂**:`card_line` 作为标注上下文喂给归纳 prompt(帮模型理解"最近在推什么事"),
144
+ 但事务 id **不进 `batchIds`**——洞察/主题/因果边的证据永远只接地在体验条目上,防派生域被污染。
145
+ - **查询面两个只读 RPC op**:`timeline-query`(按时间范围/近 N 天查事务,支持 workspace 过滤)
146
+ 与 `resource-lookup`(按 cue basename 等值反查关联事务)。面板「翻阅」tab 新增**「本周」视图**
147
+ 调 `timeline-query{days:7}` 渲染事务清单。
148
+ - **长觉蒸馏模型可在面板选**:「做梦」tab 的长觉块新增常驻的**当前生效路由**(`provider/model` + 来源)
149
+ 与 provider/model 下拉选择(枚举走宿主 `ctx.llm.listProviders/listModels`)。优先级 `部署面 pin >
150
+ 运行时覆盖 > 宿主默认`:部署面 `distill.provider/model` 双配即锁路(选择器禁用);否则面板选的存
151
+ `meta` 作运行时覆盖、下次长觉即用(**热生效不重启**,不动 volatile 六腿配置面)。仍是显式选择,不破
152
+ “绝不隐式改选模型”。新 RPC:`distill-models`/`distill-model-list`/`distill-model-set`。
153
+ - **安全实闸**:`source_trust` 三档标记(`user_explicit|derived_summary|structure_signal`)、
154
+ `isSemanticAllowed` 采集边界闸(与 `isStructuredOnly` 并联,任一失败整包拒)、
155
+ `INJECTION_PATTERNS` 落库前黑名单("ignore previous"/"system:"/"<|"/"覆盖以上"…),
156
+ 以及 gates 静态闸确保 `txn_entry` 不出现在情绪派生输入链的任何文件中。
157
+
158
+ ### 修正
159
+
160
+ - **补两张表的关键索引**(perf 规模闸实测抓出):`txn_cues(txn_id)` —— 每个读方法逐行补 cue 的
161
+ `cuesFor` 此前是 N+1 全表扫(`timeline-query` 返 200 行 ⇒ 4.8s);`txn_entry(session_id, ts_ms)` ——
162
+ 注入热路径 `listRecent({sessionId})` 此前全表扫。补齐后 60k 行规模闸从 152s 降到 1.7s。
163
+
164
+ ### 变更
165
+
166
+ - **宿主支持范围改为有界区间**:`engines.dsh` 与 7 个 dsh peer 由逐线枚举改为 `>=0.2.0-rc.1 <0.3.0`(免
167
+ 以后每出一条新 rc 线都要改三处声明)。compat 闸不再拒宽 range,改校“整体落在 0.2.x”(含 0.2.0 起点、
168
+ 不溢出 0.1.x/0.3.0+);已在真宿主(0.2.1-rc.5)实装验证该区间正常装载、预发布线不被误拒。
169
+
20
170
  ## 0.3.0
21
171
 
22
172
  记忆星海:把体验库投影成一张能转的三维星图。**只读投影,不是可查询图谱**(不开写图面、