dsh-macro-memory 0.0.0-stage → 0.3.0
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.
- package/LICENSE +21 -0
- package/README.md +457 -2
- package/cordis.patch.yml +6 -0
- package/lib/client.js +3623 -0
- package/lib/index.js +469 -0
- package/lib/macro/brand.js +82 -0
- package/lib/macro/bridge.js +158 -0
- package/lib/macro/chain.js +206 -0
- package/lib/macro/contract.js +471 -0
- package/lib/macro/cost.js +164 -0
- package/lib/macro/defs/admin.js +439 -0
- package/lib/macro/defs/dream.js +24 -0
- package/lib/macro/defs/link.js +257 -0
- package/lib/macro/defs/project.js +25 -0
- package/lib/macro/defs/read.js +145 -0
- package/lib/macro/defs/remember.js +213 -0
- package/lib/macro/defs/search.js +661 -0
- package/lib/macro/defs/update.js +161 -0
- package/lib/macro/dreamledger.js +1398 -0
- package/lib/macro/facade.js +135 -0
- package/lib/macro/fusion.js +182 -0
- package/lib/macro/linkflow.js +391 -0
- package/lib/macro/links.js +448 -0
- package/lib/macro/neighbor.js +209 -0
- package/lib/macro/panel.js +96 -0
- package/lib/macro/prompt.js +139 -0
- package/lib/macro/provenance.js +148 -0
- package/lib/macro/render.js +35 -0
- package/lib/macro/revisions.js +253 -0
- package/lib/macro/shared.js +113 -0
- package/lib/macro/store.js +103 -0
- package/lib/macro/tokencost.js +90 -0
- package/lib/macro/tools.js +67 -0
- package/package.json +54 -4
- package/vendor/VENDOR.json +23 -0
- package/vendor/dsh-memory-nebula/CONTRIBUTING.md +48 -0
- package/vendor/dsh-memory-nebula/LICENSE +21 -0
- package/vendor/dsh-memory-nebula/README.en.md +203 -0
- package/vendor/dsh-memory-nebula/README.md +253 -0
- package/vendor/dsh-memory-nebula/SECURITY.md +43 -0
- package/vendor/dsh-memory-nebula/SUPPORT.md +33 -0
- package/vendor/dsh-memory-nebula/cordis.patch.yml +4 -0
- package/vendor/dsh-memory-nebula/lib/client.js +105 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/index.js +279 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/ingest.js +230 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/meow.js +317 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/notes.js +305 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/sqlite.js +287 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/util.js +231 -0
- package/vendor/dsh-memory-nebula/lib/host/bridge.js +351 -0
- package/vendor/dsh-memory-nebula/lib/host/compress.js +97 -0
- package/vendor/dsh-memory-nebula/lib/host/demo.js +357 -0
- package/vendor/dsh-memory-nebula/lib/host/diagnostics.js +125 -0
- package/vendor/dsh-memory-nebula/lib/host/doctor.js +270 -0
- package/vendor/dsh-memory-nebula/lib/host/graph.js +1663 -0
- package/vendor/dsh-memory-nebula/lib/host/graphcache.js +282 -0
- package/vendor/dsh-memory-nebula/lib/host/http.js +993 -0
- package/vendor/dsh-memory-nebula/lib/host/injectcfg.js +95 -0
- package/vendor/dsh-memory-nebula/lib/host/ledger.js +175 -0
- package/vendor/dsh-memory-nebula/lib/host/live.js +204 -0
- package/vendor/dsh-memory-nebula/lib/host/nebula.js +2105 -0
- package/vendor/dsh-memory-nebula/lib/host/page.js +75 -0
- package/vendor/dsh-memory-nebula/lib/host/path.js +83 -0
- package/vendor/dsh-memory-nebula/lib/host/recall.js +451 -0
- package/vendor/dsh-memory-nebula/lib/host/share.js +633 -0
- package/vendor/dsh-memory-nebula/lib/host/sources.js +266 -0
- package/vendor/dsh-memory-nebula/lib/host/store.js +333 -0
- package/vendor/dsh-memory-nebula/lib/host/text.js +410 -0
- package/vendor/dsh-memory-nebula/lib/host/transcripts.js +396 -0
- package/vendor/dsh-memory-nebula/lib/index.js +759 -0
- package/vendor/dsh-memory-nebula/lib/standalone.mjs +315 -0
- package/vendor/dsh-memory-nebula/lib/web/api.js +426 -0
- package/vendor/dsh-memory-nebula/lib/web/app.js +4159 -0
- package/vendor/dsh-memory-nebula/lib/web/i18n.js +580 -0
- package/vendor/dsh-memory-nebula/lib/web/index.html +174 -0
- package/vendor/dsh-memory-nebula/lib/web/nav.js +132 -0
- package/vendor/dsh-memory-nebula/lib/web/render.js +1890 -0
- package/vendor/dsh-memory-nebula/lib/web/space3d.js +1883 -0
- package/vendor/dsh-memory-nebula/lib/web/style.css +1402 -0
- package/vendor/dsh-memory-nebula/locale/en.json +7 -0
- package/vendor/dsh-memory-nebula/locale/zh.json +7 -0
- package/vendor/dsh-memory-nebula/market/assets/icon-180.png +0 -0
- package/vendor/dsh-memory-nebula/market/assets/icon.svg +40 -0
- package/vendor/dsh-memory-nebula/market/index.json +101 -0
- package/vendor/dsh-memory-nebula/package.json +87 -0
- package/vendor/dsh-memory-nebula/sidecar.ps1 +119 -0
- package/vendor/meow-memory/LICENSE +21 -0
- package/vendor/meow-memory/README.en.md +192 -0
- package/vendor/meow-memory/README.md +174 -0
- package/vendor/meow-memory/README.pt-br.md +180 -0
- package/vendor/meow-memory/cordis.patch.yml +7 -0
- package/vendor/meow-memory/lib/client.js +3344 -0
- package/vendor/meow-memory/lib/client.js.map +7 -0
- package/vendor/meow-memory/lib/index.js +9567 -0
- package/vendor/meow-memory/lib/index.js.map +7 -0
- package/vendor/meow-memory/lib/prompts/README.md +65 -0
- package/vendor/meow-memory/lib/prompts/en/dream-atomic.md +36 -0
- package/vendor/meow-memory/lib/prompts/en/dream-header.md +9 -0
- package/vendor/meow-memory/lib/prompts/en/dream-project-summary.md +12 -0
- package/vendor/meow-memory/lib/prompts/en/dream-topic.md +27 -0
- package/vendor/meow-memory/lib/prompts/en/external-memory-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/en/first-create-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/en/labels.md +98 -0
- package/vendor/meow-memory/lib/prompts/en/reflect.md +31 -0
- package/vendor/meow-memory/lib/prompts/en/system-guide.md +121 -0
- package/vendor/meow-memory/lib/prompts/en/tools.md +83 -0
- package/vendor/meow-memory/lib/prompts/en/welcome-guide.md +12 -0
- package/vendor/meow-memory/lib/prompts/pt-br/dream-atomic.md +36 -0
- package/vendor/meow-memory/lib/prompts/pt-br/dream-header.md +9 -0
- package/vendor/meow-memory/lib/prompts/pt-br/dream-project-summary.md +12 -0
- package/vendor/meow-memory/lib/prompts/pt-br/dream-topic.md +27 -0
- package/vendor/meow-memory/lib/prompts/pt-br/external-memory-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/pt-br/first-create-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/pt-br/labels.md +98 -0
- package/vendor/meow-memory/lib/prompts/pt-br/reflect.md +31 -0
- package/vendor/meow-memory/lib/prompts/pt-br/system-guide.md +121 -0
- package/vendor/meow-memory/lib/prompts/pt-br/tools.md +83 -0
- package/vendor/meow-memory/lib/prompts/pt-br/welcome-guide.md +12 -0
- package/vendor/meow-memory/lib/prompts/zh/dream-atomic.md +36 -0
- package/vendor/meow-memory/lib/prompts/zh/dream-header.md +9 -0
- package/vendor/meow-memory/lib/prompts/zh/dream-project-summary.md +19 -0
- package/vendor/meow-memory/lib/prompts/zh/dream-topic.md +27 -0
- package/vendor/meow-memory/lib/prompts/zh/external-memory-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/zh/first-create-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/zh/labels.md +98 -0
- package/vendor/meow-memory/lib/prompts/zh/reflect.md +30 -0
- package/vendor/meow-memory/lib/prompts/zh/system-guide.md +119 -0
- package/vendor/meow-memory/lib/prompts/zh/tools.md +83 -0
- package/vendor/meow-memory/lib/prompts/zh/welcome-guide.md +12 -0
- package/vendor/meow-memory/package.json +64 -0
|
@@ -0,0 +1,158 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* macro-memory 融合层:把 meow-memory 与 nebula 两个子插件「接管」进来。
|
|
3
|
+
*
|
|
4
|
+
* 做法:不改 vendor 一行代码,只在 apply 外面包一个 facade ctx。
|
|
5
|
+
* - 子插件调 ctx.tools.register(...) → 被 bridge 收下,不直接进宿主
|
|
6
|
+
* - 子插件调 ctx.systemPrompt.section/context(...) → 被 bridge 收下,不直接注入
|
|
7
|
+
* - 其余 ctx 能力(logger / get / on / effect / webServer / connection / settings …)
|
|
8
|
+
* 原样透传给真正的 cordis ctx(函数会 bind,避免 cordis 内部拿到 Proxy 当 this)
|
|
9
|
+
*
|
|
10
|
+
* 于是「17 个工具、两段注入」全部落到 facade 层,由 lib/macro/tools.js 与
|
|
11
|
+
* lib/macro/prompt.js 重新组织成 macro 自己的 8 个 memory_* 工具 + 一段 L0 注入。
|
|
12
|
+
*
|
|
13
|
+
* 0.2.26 三件事各一个文件:
|
|
14
|
+
* - 本文件 bridge.js —— 收下工具与注入、转调子插件工具(有状态)
|
|
15
|
+
* - facade.js —— 把 ctx 换成 Proxy(换门,无状态)
|
|
16
|
+
* - render.js —— 把子插件返回值变成文本(纯函数)
|
|
17
|
+
*/
|
|
18
|
+
|
|
19
|
+
import { errText, renderToolText } from './render.js'
|
|
20
|
+
import { NOT_READY_MARK } from './contract.js'
|
|
21
|
+
|
|
22
|
+
// 兼容旧引用:errText 原来就导出在本文件里(index.js 一直这么 import)。
|
|
23
|
+
export { errText }
|
|
24
|
+
export { createFacade, wrapPlugin } from './facade.js'
|
|
25
|
+
|
|
26
|
+
const noop = () => {}
|
|
27
|
+
|
|
28
|
+
/** 统一工具等子插件装配时用的等待上限(毫秒)。 */
|
|
29
|
+
export const DEFAULT_TOOL_WAIT_MS = 30000
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* 返回「记忆原文」的工具:它们的文本里有用户存进去的字,**不许改口**(只追加旧名对照)。
|
|
33
|
+
* 其余工具(stats / guide / link / remember …)吐的是融合层自己的界面文案,按 BRAND_MAP 换名没问题。
|
|
34
|
+
*/
|
|
35
|
+
export const CONTENT_TOOLS = new Set([
|
|
36
|
+
'memory_search',
|
|
37
|
+
'memory_read',
|
|
38
|
+
'memory_remember',
|
|
39
|
+
'memory_update',
|
|
40
|
+
'memory_find_similar',
|
|
41
|
+
'nebula_recall',
|
|
42
|
+
'nebula_inspect',
|
|
43
|
+
'nebula_bridge',
|
|
44
|
+
'nebula_path',
|
|
45
|
+
])
|
|
46
|
+
|
|
47
|
+
export function createBridge(options = {}) {
|
|
48
|
+
const log = typeof options.log === 'function' ? options.log : noop
|
|
49
|
+
const warn = typeof options.warn === 'function' ? options.warn : noop
|
|
50
|
+
/** 子插件文本的「改口」函数(把旧工具名换成 macro 的说法);默认原样。 */
|
|
51
|
+
const brand = typeof options.brand === 'function' ? options.brand : (t) => t
|
|
52
|
+
/** 原文工具的「只加对照、不动正文」函数;默认原样。 */
|
|
53
|
+
const hints = typeof options.hints === 'function' ? options.hints : (t) => t
|
|
54
|
+
|
|
55
|
+
/** name -> { name, vendor, def, options } */
|
|
56
|
+
const tools = new Map()
|
|
57
|
+
/** 捕获到的注入声明(按到达顺序) */
|
|
58
|
+
const prompts = []
|
|
59
|
+
/** vendor -> 该 vendor 捕获到的工具名 */
|
|
60
|
+
const vendorTools = new Map()
|
|
61
|
+
|
|
62
|
+
function note(vendor) {
|
|
63
|
+
if (!vendorTools.has(vendor)) vendorTools.set(vendor, [])
|
|
64
|
+
return vendorTools.get(vendor)
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
const bridge = {
|
|
68
|
+
/** 子插件 register 的工具被收在这里,返回给它的是一次性 disposer。 */
|
|
69
|
+
captureTool(vendor, def, options = {}) {
|
|
70
|
+
if (!def || typeof def.name !== 'string') {
|
|
71
|
+
warn(`[macro-memory] ${vendor} 注册了没有 name 的工具,已忽略`)
|
|
72
|
+
return noop
|
|
73
|
+
}
|
|
74
|
+
tools.set(def.name, { name: def.name, vendor, def, options })
|
|
75
|
+
const list = note(vendor)
|
|
76
|
+
if (!list.includes(def.name)) list.push(def.name)
|
|
77
|
+
log(`[macro-memory] 收到 ${vendor} 的工具 ${def.name}`)
|
|
78
|
+
return () => {
|
|
79
|
+
const hit = tools.get(def.name)
|
|
80
|
+
if (hit && hit.vendor === vendor && hit.def === def) tools.delete(def.name)
|
|
81
|
+
}
|
|
82
|
+
},
|
|
83
|
+
|
|
84
|
+
/** 子插件的 systemPrompt.section / .context 被收在这里,一律不落宿主。 */
|
|
85
|
+
capturePrompt(vendor, kind, decl) {
|
|
86
|
+
prompts.push({ vendor, kind, decl })
|
|
87
|
+
log(`[macro-memory] 收到 ${vendor} 的注入 ${kind}:${String(decl?.name)}`)
|
|
88
|
+
return noop
|
|
89
|
+
},
|
|
90
|
+
|
|
91
|
+
has(name) {
|
|
92
|
+
return tools.has(name)
|
|
93
|
+
},
|
|
94
|
+
|
|
95
|
+
get(name) {
|
|
96
|
+
return tools.get(name)
|
|
97
|
+
},
|
|
98
|
+
|
|
99
|
+
names() {
|
|
100
|
+
return [...tools.keys()]
|
|
101
|
+
},
|
|
102
|
+
|
|
103
|
+
/** 取子插件的工具定义;还没装配好就轮询等一会儿(默认 30s)。 */
|
|
104
|
+
async awaitTool(name, timeoutMs = DEFAULT_TOOL_WAIT_MS) {
|
|
105
|
+
const hit = tools.get(name)
|
|
106
|
+
if (hit) return hit
|
|
107
|
+
const deadline = Date.now() + Math.max(0, timeoutMs)
|
|
108
|
+
while (Date.now() < deadline) {
|
|
109
|
+
await new Promise((r) => setTimeout(r, 100))
|
|
110
|
+
const again = tools.get(name)
|
|
111
|
+
if (again) return again
|
|
112
|
+
}
|
|
113
|
+
return undefined
|
|
114
|
+
},
|
|
115
|
+
|
|
116
|
+
/** 融合层自己调子插件工具:拿到定义、执行、用子插件自己的 render 出文本。 */
|
|
117
|
+
async call(name, args, exec, timeoutMs) {
|
|
118
|
+
const entry = await bridge.awaitTool(name, timeoutMs)
|
|
119
|
+
if (!entry) {
|
|
120
|
+
// 不给模型甩子插件的内部名字:它只认识 macro 的 8 个工具
|
|
121
|
+
warn(`[macro-memory] 子插件能力 ${name} 尚未就绪`)
|
|
122
|
+
throw new Error(`macro-memory:${NOT_READY_MARK}(对应子模块尚未装配完成,或被配置关闭),请稍后重试。`)
|
|
123
|
+
}
|
|
124
|
+
const value = await entry.def.execute(args, exec)
|
|
125
|
+
const rendered = renderToolText(entry.def, args, value)
|
|
126
|
+
// 原文工具:正文不动,只补旧名对照;其余工具:按 BRAND_MAP 改口。
|
|
127
|
+
const decorate = CONTENT_TOOLS.has(name) ? hints : brand
|
|
128
|
+
return { entry, def: entry.def, value, text: decorate(rendered) }
|
|
129
|
+
},
|
|
130
|
+
|
|
131
|
+
/**
|
|
132
|
+
* call 的「失败不致命」版本:拿来做增强(星图邻域/相似/连线)用。
|
|
133
|
+
* label 是给模型看的说法(例如「星图扩散」),缺省才用子插件工具名——
|
|
134
|
+
* 免得工具输出里出现「memory_search 未完成」这种自己说自己没做完的怪句子。
|
|
135
|
+
*/
|
|
136
|
+
async tryCall(name, args, exec, timeoutMs, label) {
|
|
137
|
+
try {
|
|
138
|
+
return await bridge.call(name, args, exec, timeoutMs)
|
|
139
|
+
} catch (err) {
|
|
140
|
+
const who = typeof label === 'string' && label.length > 0 ? label : name
|
|
141
|
+
return { entry: undefined, def: undefined, value: undefined, text: brand(`${who}未完成:${errText(err)}`) }
|
|
142
|
+
}
|
|
143
|
+
},
|
|
144
|
+
|
|
145
|
+
promptDeclarations() {
|
|
146
|
+
return prompts.slice()
|
|
147
|
+
},
|
|
148
|
+
|
|
149
|
+
snapshot() {
|
|
150
|
+
return {
|
|
151
|
+
tools: [...tools.values()].map((t) => ({ name: t.name, vendor: t.vendor })),
|
|
152
|
+
prompts: prompts.map((p) => ({ vendor: p.vendor, kind: p.kind, name: String(p.decl?.name) })),
|
|
153
|
+
}
|
|
154
|
+
},
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
return bridge
|
|
158
|
+
}
|
|
@@ -0,0 +1,206 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* [macro-fusion 0.2.138] 取代链可视:一条记忆现在处在链上的哪个位置。
|
|
3
|
+
*
|
|
4
|
+
* 为什么要有这个:0.2.117 起 supersedes 会把旧条目标 stale 并在正文末尾留一句话
|
|
5
|
+
* 「(已被取代:<新 id>「<开头>」,<日期>)」。话留下了,但**没有人在读它**——
|
|
6
|
+
* 你 memory_update 一条旧条目时,回执只说「已更新」,你看不出这条其实早就退位了;
|
|
7
|
+
* 你写新条目时也说不出「我这一条接的是谁的手」。于是库里有一条真实的谱系,
|
|
8
|
+
* 却只能靠人肉 grep 才看得见。可追溯性不是「写过」,是「读的时候能顺着走」。
|
|
9
|
+
*
|
|
10
|
+
* 三个约束(这也是这一版只做两行的原因):
|
|
11
|
+
* 1. **只在真有链时才说话**:绝大多数更新/读取没有谱系,多一行就是多花 token。
|
|
12
|
+
* 2. **不改任何数据**:链是读出来的,不是维护出来的——不新增列、不新增索引、
|
|
13
|
+
* 不回头补写旧条目(那会把已经很长的库再改一遍,收益抵不上风险)。
|
|
14
|
+
* 3. **拿不到就闭嘴**:没工作区 / 没库 / 读失败一律返回空串,绝不猜一段链出来,
|
|
15
|
+
* 也绝不为了一句提示去 `getDb` 建一个空库(先 existsSync 判存在)。
|
|
16
|
+
*
|
|
17
|
+
* [macro-fusion 0.2.139] 链是近似出来的,那就得把近似说清楚。8 位前缀有两个盲区:
|
|
18
|
+
* ① 接手它的那条可能已经不在库里(删了、搬走了)——只念一个 id 会让人以为还能改到它;
|
|
19
|
+
* ② 同秒写入的条目前缀会撞——念一个 id 会让人以为那是唯一一条。
|
|
20
|
+
* 现在的做法:前缀在库里命中几条就如实说几条(exact / absent / ambiguous),
|
|
21
|
+
* 「我接手的」那一侧也一样,前缀撞车时提醒下面几条可能不是记着我。
|
|
22
|
+
*
|
|
23
|
+
* 但撞车根本不是罕见情况:meow 的 id 前半段就是写入时刻(`0mwpxnnu-…`),**同一秒写的条目全撞**。
|
|
24
|
+
* 所以光有三态不够——取代句里还写着接手者的开头(`「…」`),那是天然的消歧键:
|
|
25
|
+
* 前缀命中多条时,拿开头再筛一遍(`headMatch`,两边都是截断过的,用 startsWith 互认)。
|
|
26
|
+
* 筛到唯一就还是 exact;筛完仍不唯一才算 ambiguous。`hits` 记的永远是「前缀命中几条」,
|
|
27
|
+
* 与 `state` 分开——「撞了几条」是事实,「能不能确定」是结论。
|
|
28
|
+
*/
|
|
29
|
+
import { existsSync } from 'node:fs'
|
|
30
|
+
import { join } from 'node:path'
|
|
31
|
+
import * as Meow from '../../vendor/meow-memory/lib/index.js'
|
|
32
|
+
import { LEVELS } from './shared.js'
|
|
33
|
+
|
|
34
|
+
/** 与 defs/remember.js 的 SUPERSEDE_MARK 必须是同一个串(那边写、这边读)。 */
|
|
35
|
+
export const SUPERSEDE_MARK = '(已被取代:'
|
|
36
|
+
/** meow 的 id 形如 `0mwowj2h2-<32 hex>`,取代句里只留前 8 位。 */
|
|
37
|
+
const SHORT = 8
|
|
38
|
+
/** 链上一行最多点几条:谱系再长,读者也只需要「有这件事」+ 几个把手。 */
|
|
39
|
+
const SHOW_MAX = 5
|
|
40
|
+
/** 抬头从哪里截:够认出是哪条,又不会把一整段正文塞进回执。 */
|
|
41
|
+
const HEAD_MAX = 28
|
|
42
|
+
|
|
43
|
+
function dbFile(workspace, dir) {
|
|
44
|
+
return join(workspace, dir, 'memory.db')
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/** id 的前 8 位——取代句、去重判断、跨条匹配全用这一个口径。 */
|
|
48
|
+
export function shortId(id) {
|
|
49
|
+
return String(id ?? '').slice(0, SHORT)
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* 一个前缀在库里命中几条。0 = 那条已经不在了,1 = 唯一,≥2 = 撞车。
|
|
54
|
+
* 抽成纯函数是为了能单测:真库里造两条同前缀的 id 很难,判据本身不该难测。
|
|
55
|
+
*/
|
|
56
|
+
export function prefixState(ids, prefix) {
|
|
57
|
+
const want = String(prefix ?? '').slice(0, SHORT)
|
|
58
|
+
if (want === '') return 0
|
|
59
|
+
let n = 0
|
|
60
|
+
for (const id of Array.isArray(ids) ? ids : []) if (shortId(id) === want) n++
|
|
61
|
+
return n
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
function headOf(text) {
|
|
65
|
+
const first = String(text ?? '')
|
|
66
|
+
.split('\n')
|
|
67
|
+
.map((line) => line.trim())
|
|
68
|
+
.find((line) => line.length > 0) ?? ''
|
|
69
|
+
return first.length > HEAD_MAX ? `${first.slice(0, HEAD_MAX)}…` : first
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/**
|
|
73
|
+
* 两段开头是不是同一段:两边都截断过(取代句里 24 字、这里 28 字,还带个省略号),
|
|
74
|
+
* 所以只认「谁以谁开头」,不认相等。
|
|
75
|
+
*/
|
|
76
|
+
export function headMatch(a, b) {
|
|
77
|
+
const x = String(a ?? '').replace(/…$/, '').trim()
|
|
78
|
+
const y = String(b ?? '').replace(/…$/, '').trim()
|
|
79
|
+
if (x === '' || y === '') return false
|
|
80
|
+
return x.startsWith(y) || y.startsWith(x)
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/**
|
|
84
|
+
* 从正文里读出「我已被谁接手」。
|
|
85
|
+
* 取代句的形态是 `(已被取代:<id8>「<开头>」,<日期>)`,开头和日期都可能缺——
|
|
86
|
+
* 缺的就不编:解析不出来就返回 null,让调用方当作「没有这段谱系」。
|
|
87
|
+
*/
|
|
88
|
+
export function supersededBy(content) {
|
|
89
|
+
const text = String(content ?? '')
|
|
90
|
+
const at = text.indexOf(SUPERSEDE_MARK)
|
|
91
|
+
if (at < 0) return null
|
|
92
|
+
const rest = text.slice(at + SUPERSEDE_MARK.length)
|
|
93
|
+
const idm = /^\s*([0-9a-z]{4,})/.exec(rest)
|
|
94
|
+
if (idm === null) return null
|
|
95
|
+
const headm = new RegExp(`^[0-9a-z]{4,}「([^」]*)」`).exec(rest)
|
|
96
|
+
const daym = /[,,]\s*(\d{4}-\d{1,2}-\d{1,2})\s*[))]/.exec(rest)
|
|
97
|
+
return { id8: idm[1], head: headm?.[1] ?? '', day: daym?.[1] ?? '' }
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
/**
|
|
101
|
+
* 一条记忆在链上的位置:`mine` = 谁接手了它,`killed` = 它接手过谁。
|
|
102
|
+
* missing 三态照老规矩分开(no-workspace / no-db / read-failed),但它只用于内部判断,
|
|
103
|
+
* 对外一律闭嘴——「读不到链」不等于「这条没有链」,可两者对读者都只能是「没有可说的」。
|
|
104
|
+
*/
|
|
105
|
+
export function successionOf({ workspace = '', dir = '.dsh-meow', id = '' } = {}) {
|
|
106
|
+
const out = { mine: null, killed: [], selfHits: 0, missing: '' }
|
|
107
|
+
const want = String(id ?? '').trim()
|
|
108
|
+
if (want === '') {
|
|
109
|
+
out.missing = 'bad-arg'
|
|
110
|
+
return out
|
|
111
|
+
}
|
|
112
|
+
if (typeof workspace !== 'string' || workspace.length === 0) {
|
|
113
|
+
out.missing = 'no-workspace'
|
|
114
|
+
return out
|
|
115
|
+
}
|
|
116
|
+
if (!existsSync(dbFile(workspace, dir))) {
|
|
117
|
+
out.missing = 'no-db'
|
|
118
|
+
return out
|
|
119
|
+
}
|
|
120
|
+
try {
|
|
121
|
+
// 自己那一条:短 id 当输入时 readRowsByIds 可能回好几条(同秒同前缀),只认前缀对得上的。
|
|
122
|
+
const read = Meow.readRowsByIds(workspace, dir, [want])
|
|
123
|
+
const mineRows = Array.isArray(read.rows) ? read.rows : []
|
|
124
|
+
const self = mineRows.find((r) => String(r.id ?? '').startsWith(want)) ?? mineRows[0] ?? null
|
|
125
|
+
// 全库只扫一遍:三个判断(接手者是否还在、自己前缀撞不撞、谁记着我)共用这张表。
|
|
126
|
+
const db = Meow.getDb(workspace, dir)
|
|
127
|
+
const all = []
|
|
128
|
+
for (const level of LEVELS) {
|
|
129
|
+
const list = db.list(level, {})
|
|
130
|
+
for (const r of Array.isArray(list) ? list : []) all.push({ level, row: r })
|
|
131
|
+
}
|
|
132
|
+
const ids = all.map((one) => one.row.id)
|
|
133
|
+
if (self !== null) {
|
|
134
|
+
const mark = supersededBy(self.content)
|
|
135
|
+
if (mark !== null) {
|
|
136
|
+
const samePrefix = all.filter((one) => shortId(one.row.id) === shortId(mark.id8))
|
|
137
|
+
// 撞车是常态(同一秒写),所以先按开头筛:取代句里的「…」就是为这一刻留的。
|
|
138
|
+
let sure = samePrefix
|
|
139
|
+
if (samePrefix.length > 1 && mark.head !== '')
|
|
140
|
+
sure = samePrefix.filter((one) => headMatch(headOf(one.row.content), mark.head))
|
|
141
|
+
out.mine = {
|
|
142
|
+
...mark,
|
|
143
|
+
hits: samePrefix.length,
|
|
144
|
+
state: sure.length === 1 ? 'exact' : sure.length === 0 ? 'absent' : 'ambiguous',
|
|
145
|
+
level: sure.length === 1 ? sure[0].level : '',
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
const shore = shortId(want)
|
|
150
|
+
const myHead = self === null ? '' : headOf(self.content)
|
|
151
|
+
out.selfHits = prefixState(ids, shore)
|
|
152
|
+
for (const one of all) {
|
|
153
|
+
if (String(one.row.id ?? '') === String(want)) continue // 自己不算「我接手的」(同前缀的兄弟条要靠开头分辨)
|
|
154
|
+
const mark2 = supersededBy(one.row.content)
|
|
155
|
+
if (mark2 === null || shortId(mark2.id8) !== shore) continue
|
|
156
|
+
// 记着我的那条,开头也得对得上:同秒撞前缀时,这是唯一能证明「它说的是我」的证据。
|
|
157
|
+
if (mark2.head !== '' && myHead !== '' && !headMatch(myHead, mark2.head)) continue
|
|
158
|
+
out.killed.push({ level: one.level, id: String(one.row.id ?? ''), status: String(one.row.status ?? ''), head: headOf(one.row.content) })
|
|
159
|
+
}
|
|
160
|
+
return out
|
|
161
|
+
} catch (e) {
|
|
162
|
+
out.missing = `read-failed: ${e instanceof Error ? e.message : String(e)}`
|
|
163
|
+
return out
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
/**
|
|
168
|
+
* 回执里那两行(可能只有一行、也可能一行都没有)。
|
|
169
|
+
* 语气分开是有意的:`mine` 是警告(你手上这条已经退位了),`killed` 是史证(旧的那些别再用)。
|
|
170
|
+
*/
|
|
171
|
+
export function successionNote({ workspace = '', dir = '.dsh-meow', id = '' } = {}) {
|
|
172
|
+
const chain = successionOf({ workspace, dir, id })
|
|
173
|
+
if (chain.missing.length > 0) return ''
|
|
174
|
+
const lines = []
|
|
175
|
+
if (chain.mine !== null && chain.mine.id8.length > 0) {
|
|
176
|
+
const who = `${chain.mine.id8}${chain.mine.head ? `「${chain.mine.head}」` : ''}`
|
|
177
|
+
const when = chain.mine.day ? `${chain.mine.day} 写下` : '不知道哪天写下'
|
|
178
|
+
if (chain.mine.state === 'absent') {
|
|
179
|
+
lines.push(
|
|
180
|
+
`⛓ 这条写着被 ${who} 接手(${when}),可那条现在不在库里——它被删了或搬走了,你想改也改不到;这次结论要准,就让这条带 supersedes 重写一次。`,
|
|
181
|
+
)
|
|
182
|
+
} else if (chain.mine.state === 'ambiguous') {
|
|
183
|
+
lines.push(
|
|
184
|
+
`⛓ 这条写着被 ${who} 接手,可这个前缀在库里有 ${chain.mine.hits} 条(id 前 8 位撞了),认不出是哪一条——按开头那句自己去核对,别照着前缀改错人。`,
|
|
185
|
+
)
|
|
186
|
+
} else {
|
|
187
|
+
lines.push(
|
|
188
|
+
`⛓ 这条已被人接手:${who}(${when})。你手上是退位的那条——检索时说话的是接手它的那条;这次结论才准,就去改那条,或者让这条带 supersedes 重写一次。`,
|
|
189
|
+
)
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
if (chain.killed.length > 0) {
|
|
193
|
+
const shown = chain.killed
|
|
194
|
+
.slice(0, SHOW_MAX)
|
|
195
|
+
.map((k) => `${k.level} ${shortId(k.id)}${k.status !== '' && k.status !== 'active' ? `(${k.status})` : ''}`)
|
|
196
|
+
const more = chain.killed.length > SHOW_MAX ? `,另有 ${chain.killed.length - SHOW_MAX} 条` : ''
|
|
197
|
+
const blur =
|
|
198
|
+
chain.selfHits > 1
|
|
199
|
+
? `(注意:库里还有 ${chain.selfHits - 1} 条 id 前 8 位也是 ${shortId(id)}——上面这几条按开头核对过,可它们只是「以你开头」的那些里认出来的)`
|
|
200
|
+
: ''
|
|
201
|
+
lines.push(
|
|
202
|
+
`⛓ 这条接手过 ${chain.killed.length} 条:${shown.join('、')}${more}——旧的那几条只作史证,别拿它们的结论用。${blur}`,
|
|
203
|
+
)
|
|
204
|
+
}
|
|
205
|
+
return lines.join('\n')
|
|
206
|
+
}
|