dsh-knit 0.23.0 → 0.24.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/CHANGELOG.md +168 -0
- package/README.en.md +67 -37
- package/README.md +51 -28
- package/SECURITY.md +9 -3
- package/package.json +5 -3
- package/src/client/client.js +448 -141
- package/src/host/changes.js +208 -0
- package/src/host/git.js +377 -0
- package/src/host/index.js +228 -5
- package/test/client.test.mjs +633 -331
- package/test/git-changes.test.mjs +1238 -0
- package/test/host-http.test.mjs +4 -58
- package/test/http-harness.mjs +79 -0
package/src/host/index.js
CHANGED
|
@@ -41,11 +41,16 @@ import { sharedIndexStore, headHashOf, refsShapeOk } from './index-store.js'
|
|
|
41
41
|
import {
|
|
42
42
|
createSemanticEngine, sharedSemanticStore, normalizeProviderConfig,
|
|
43
43
|
} from './semantic.js'
|
|
44
|
+
// v0.25:Git 变更关联检索。**只读、有界、默认关闭** —— `git.js` 只跑一条
|
|
45
|
+
// `git status --porcelain=v1 -z`(argv 是数组,绝不走 shell;写动词一个都没有),
|
|
46
|
+
// `changes.js` 把变更文件当种子去**已有的**关系事实表里取边,不发明关系。
|
|
47
|
+
import { createGitReader, MAX_REPORTED_FILES } from './git.js'
|
|
48
|
+
import { splitSeeds, ghostCandidates, projectChangeRelated, MAX_CHANGE_RELATED } from './changes.js'
|
|
44
49
|
// v0.14:上下文装配。同样由这里注入依赖(`list` / `read`),保持纯函数可单测。
|
|
45
50
|
// ⚠️ 这里**只 import `buildContext`**:Context Pack 的文本渲染只在 `tool.js` 的
|
|
46
51
|
// `renderToolText()` 里发生(模型看到的是那段文本,不是结构化 JSON)。曾经多导出一个
|
|
47
52
|
// `renderContextText` 却没人调用 —— 那是个会与 `tool.js` 漂移的第二渲染器,已删。
|
|
48
|
-
import { buildContext } from './context.js'
|
|
53
|
+
import { buildContext, sourceTypeOf } from './context.js'
|
|
49
54
|
// v0.20:内容片段层(Deep Context Retrieval)。**纯函数、不读盘**,
|
|
50
55
|
// 目录遍历与缓存全在本文件 —— 它只回答「这篇正文里哪几段相关」。
|
|
51
56
|
import { passageMatchesFor, passageTfOf, PASSAGE_WINDOW } from './passage.js'
|
|
@@ -1578,6 +1583,13 @@ let controlRegistry = createControlRegistry(null)
|
|
|
1578
1583
|
*/
|
|
1579
1584
|
let semanticEngine = createSemanticEngine({ store: null })
|
|
1580
1585
|
|
|
1586
|
+
/**
|
|
1587
|
+
* v0.25 · 进程内的 Git 读取器。**只有 `changes=1` 那一轮才会真的去跑 git** ——
|
|
1588
|
+
* 默认关闭意味着默认这条路上一个进程都不 spawn(用户需求 §三.3 的「不悄悄改变基础检索行为」)。
|
|
1589
|
+
* 缓存(8 秒)与「不是仓库」的负缓存都在它内部,见 `git.js`。
|
|
1590
|
+
*/
|
|
1591
|
+
const gitReader = createGitReader()
|
|
1592
|
+
|
|
1581
1593
|
/**
|
|
1582
1594
|
* v0.23 Phase A:跑一轮**有界**语义候选。
|
|
1583
1595
|
*
|
|
@@ -1837,7 +1849,7 @@ export async function scan(root, limit, options = {}) {
|
|
|
1837
1849
|
ordered = pool.map((doc) => ({ ...doc, score: null }))
|
|
1838
1850
|
}
|
|
1839
1851
|
|
|
1840
|
-
|
|
1852
|
+
const out = {
|
|
1841
1853
|
ok: true,
|
|
1842
1854
|
root,
|
|
1843
1855
|
// v0.19 修订:`root` 是会话自己那条路径(可能含符号链接,用于显示);
|
|
@@ -1865,6 +1877,11 @@ export async function scan(root, limit, options = {}) {
|
|
|
1865
1877
|
// 全量列表(未按 limit 切片)。**内部输入**:v0.17 的 lifecycle 需要「被读过但
|
|
1866
1878
|
// 不一定落在当前页」的文档的当前 mtime。由 `publicScanPayload()` 剥掉。
|
|
1867
1879
|
allDocs: ordered,
|
|
1880
|
+
// v0.25:**文档 + 代码**那一份语料(与类型档无关)。Git 变更关联要在「文档 ↔ 代码」
|
|
1881
|
+
// 之间找证据(`documents` / `imports` / `tests` 三类都跨档),而面板的档位把语料切开了;
|
|
1882
|
+
// 所以这里多带一份**不分档**的候选集给它。它只是一组引用(记录本身已在 `allDocs` 里),
|
|
1883
|
+
// 由 `publicScanPayload()` 剥掉,不下发。
|
|
1884
|
+
contextCorpus: collected.docs.concat(collected.code),
|
|
1868
1885
|
// v0.19 扫描计数(需求 §50 要报的那几个数:见到的 / 准入的 / 被排除的 / 生成噪声)
|
|
1869
1886
|
// 加上 `corpusSize`(本档语料的实际大小,即 `allDocs.length`)。
|
|
1870
1887
|
// **内部输入**,由 `publicScanPayload()` 剥掉 —— HTTP 响应形状一个键都不加。
|
|
@@ -1874,6 +1891,59 @@ export async function scan(root, limit, options = {}) {
|
|
|
1874
1891
|
semantic,
|
|
1875
1892
|
},
|
|
1876
1893
|
}
|
|
1894
|
+
// v0.25:记一份给独立接口复用(见 `corpusForChanges`)。**只写不读**,扫描语义不变。
|
|
1895
|
+
scanMemoState = { root, at: Date.now(), payload: out }
|
|
1896
|
+
return out
|
|
1897
|
+
}
|
|
1898
|
+
|
|
1899
|
+
/**
|
|
1900
|
+
* **最近一次扫描**的备忘(v0.25)。
|
|
1901
|
+
*
|
|
1902
|
+
* 存在的唯一理由是:Git 变更关联现在走**独立接口** `/knit/api/changes`,而它需要与
|
|
1903
|
+
* `/api/recent` **同一份**工作区语料。如果它自己再 `scan()` 一次,一轮轮询就会
|
|
1904
|
+
* **走两遍目录树**——那正是「不得因为两个请求重复扫描整个工作区」要禁掉的事。
|
|
1905
|
+
*
|
|
1906
|
+
* ⚠️ 这份备忘**只被独立接口读**,`scan()` 自己从不读它 ⇒ 扫描的语义一个字节没变
|
|
1907
|
+
* (同一进程里连续两次 `scan()` 依旧各自真扫,增量索引那套测试的前提因此不被动摇)。
|
|
1908
|
+
* TTL 与 `git.js` 的 `GIT_CACHE_TTL_MS`(8 s)**同窗**:一个快照窗口 = 一次扫描 + 一次 git。
|
|
1909
|
+
*/
|
|
1910
|
+
const SCAN_MEMO_TTL_MS = 8000
|
|
1911
|
+
let scanMemoState = null
|
|
1912
|
+
|
|
1913
|
+
/** 仅供测试:读当前备忘(`null` = 没有可复用的扫描)。 */
|
|
1914
|
+
export function scanMemo() {
|
|
1915
|
+
if (!scanMemoState) return null
|
|
1916
|
+
if (Date.now() - scanMemoState.at > SCAN_MEMO_TTL_MS) return null
|
|
1917
|
+
return { root: scanMemoState.root, at: scanMemoState.at }
|
|
1918
|
+
}
|
|
1919
|
+
|
|
1920
|
+
/** 仅供测试:清掉备忘,好把「复用」与「真扫」两条路分开断言。 */
|
|
1921
|
+
export function resetScanMemo() {
|
|
1922
|
+
scanMemoState = null
|
|
1923
|
+
}
|
|
1924
|
+
|
|
1925
|
+
/**
|
|
1926
|
+
* 仅供测试:清掉 **git 状态缓存**。
|
|
1927
|
+
*
|
|
1928
|
+
* 与 `resetScanMemo()` 配对使用:只证明「缓存热的时候看不见变化」是不够的 ——
|
|
1929
|
+
* 还要证明「缓存冷了变化就出现」。两条合起来才说明那个「看不见」是缓存造成的,
|
|
1930
|
+
* 而不是接口本来就对文件增删无感。
|
|
1931
|
+
*/
|
|
1932
|
+
export function resetGitReaderCache() {
|
|
1933
|
+
gitReader.reset()
|
|
1934
|
+
}
|
|
1935
|
+
|
|
1936
|
+
/**
|
|
1937
|
+
* 独立接口要的那份语料:**优先复用最近一次扫描**,没有(或过期)才真扫一遍。
|
|
1938
|
+
*
|
|
1939
|
+
* @param {string} root - 工作区根
|
|
1940
|
+
* @param {object} fallback - 真扫时用的参数(与 `/api/recent` 同一组:同参数才能命中同一份语料)
|
|
1941
|
+
* @returns {Promise<object>} `scan()` 的完整载荷
|
|
1942
|
+
*/
|
|
1943
|
+
export async function corpusForChanges(root, fallback) {
|
|
1944
|
+
const memo = scanMemoState
|
|
1945
|
+
if (memo && memo.root === root && Date.now() - memo.at <= SCAN_MEMO_TTL_MS) return memo.payload
|
|
1946
|
+
return scan(root, fallback.limit, fallback.options)
|
|
1877
1947
|
}
|
|
1878
1948
|
|
|
1879
1949
|
/**
|
|
@@ -1889,10 +1959,11 @@ export async function scan(root, limit, options = {}) {
|
|
|
1889
1959
|
*/
|
|
1890
1960
|
export function publicScanPayload(payload) {
|
|
1891
1961
|
if (!payload || typeof payload !== 'object') return payload
|
|
1892
|
-
const { ranked, task, allDocs, stats, ...rest } = payload
|
|
1962
|
+
const { ranked, task, allDocs, contextCorpus, stats, ...rest } = payload
|
|
1893
1963
|
void ranked
|
|
1894
1964
|
void task
|
|
1895
1965
|
void allDocs
|
|
1966
|
+
void contextCorpus
|
|
1896
1967
|
void stats
|
|
1897
1968
|
return rest
|
|
1898
1969
|
}
|
|
@@ -1986,7 +2057,122 @@ export async function buildContextFor(root, options = {}) {
|
|
|
1986
2057
|
// 「固定上下文」区(`pack.pinned`,来源 `manual`)—— 三层的连续编号规则因此一个字不动。
|
|
1987
2058
|
// 条目只从这一包现成的行里取,零新 I/O;固定了一篇但这一批里没有它,**不硬凑**。
|
|
1988
2059
|
// 显式传入的 `control` 优先(测试用),否则问进程内的控制状态 —— 与 `scan()` 同一条口径。
|
|
1989
|
-
|
|
2060
|
+
const withPin = applyPinOverride(pack, options.control || controlRegistry.controlOf(root))
|
|
2061
|
+
// ⚠️ v0.25(第二轮修订):**变更关联不在这里**。它不再往 Context Pack 里挂任何东西 ——
|
|
2062
|
+
// 「三层 + 固定区」就是这个函数的全部产出,与 v0.24 逐字相同(有测试守着)。
|
|
2063
|
+
// 变更关联走**独立的 `/knit/api/changes` 接口**(`changesPayload()`),
|
|
2064
|
+
// 因为它是「另一个问题的答案」,不是这一份包的第四条目录。
|
|
2065
|
+
return withPin
|
|
2066
|
+
}
|
|
2067
|
+
|
|
2068
|
+
/**
|
|
2069
|
+
* v0.25 · **Git 变更关联**:独立接口 `/knit/api/changes` 的载荷构造函数。
|
|
2070
|
+
*
|
|
2071
|
+
* 它**不碰** Context Pack:不改三层、不改固定区、不改编号、不改排序 —— 那份包由
|
|
2072
|
+
* `buildContextFor()` 原样产出,两条路径唯一的交汇点是「同一个工作区扫描结果」与
|
|
2073
|
+
* 「同一张关系事实表」。
|
|
2074
|
+
*
|
|
2075
|
+
* **数据结构是专用的**(不是 Context Pack 条目,也不复用 `provenance` / `reason` 那套词汇):
|
|
2076
|
+
*
|
|
2077
|
+
* ```
|
|
2078
|
+
* { ok, root, hostRoot, mode: 'changes',
|
|
2079
|
+
* git: { available, reason, filesTotal, truncated, files: [{rel, kinds[], origRel?}] },
|
|
2080
|
+
* links: [ { target, // 关联目标(工作区相对路径)
|
|
2081
|
+
* kind, source, // 目标自身的分类(宿主给,客户端不看扩展名)
|
|
2082
|
+
* title, summary, mtimeMs,
|
|
2083
|
+
* evidence: [ { origin, // **变更起点**:牵出这条关联的那个被改过的文件
|
|
2084
|
+
* type, // 关系类型:references | imports | tests | documents
|
|
2085
|
+
* dir, // 方向(见下):相对**目标**而言
|
|
2086
|
+
* line } ], // **真实存在时**才给行号;`tests` 是文件名约定 ⇒ null
|
|
2087
|
+
* evidenceTotal, types } ],
|
|
2088
|
+
* linksTotal, unresolved: [rel], outOfScope: [rel] }
|
|
2089
|
+
* ```
|
|
2090
|
+
*
|
|
2091
|
+
* ⚠️ `dir` 是必需的第五个字段,不是冗余:没有它,「`src/foo.ts` 与 `docs/guide.md` 之间的
|
|
2092
|
+
* `documents` 边」读起来会分不清**谁提到谁**(`dir='in'` = 起点指向目标;`dir='out'` = 目标
|
|
2093
|
+
* 指向起点)。它与 v0.21 行级证据里的 `dir` 逐字同源,所以客户端**不需要第二条渲染路径**。
|
|
2094
|
+
*
|
|
2095
|
+
* @param {string} root - 工作区根
|
|
2096
|
+
* @param {{corpus: Array<object>, changeSet?: object, gitReader?: object}} input
|
|
2097
|
+
* `corpus` = `scan()` 给的**不分档**候选集(文档 + 代码);`changeSet` 只在测试里注入
|
|
2098
|
+
* @returns {Promise<object>} 这个接口的完整载荷(**任何情况下都不抛**)
|
|
2099
|
+
*/
|
|
2100
|
+
export async function changesPayload(root, input = {}) {
|
|
2101
|
+
const corpus = Array.isArray(input.corpus) ? input.corpus : []
|
|
2102
|
+
const reader = input.gitReader && typeof input.gitReader.read === 'function' ? input.gitReader : gitReader
|
|
2103
|
+
const changeSet = input.changeSet && typeof input.changeSet === 'object'
|
|
2104
|
+
? input.changeSet
|
|
2105
|
+
: await reader.read(root)
|
|
2106
|
+
const git = {
|
|
2107
|
+
available: changeSet.available === true,
|
|
2108
|
+
reason: changeSet.reason || null,
|
|
2109
|
+
// 面板要说的第一句话是「你改了几个文件」。给出的是**解析后**的条数(截断时另标 truncated)。
|
|
2110
|
+
filesTotal: Number(changeSet.filesTotal) || 0,
|
|
2111
|
+
truncated: changeSet.truncated === true,
|
|
2112
|
+
files: (Array.isArray(changeSet.files) ? changeSet.files : []).slice(0, MAX_REPORTED_FILES)
|
|
2113
|
+
.map((f) => ({ rel: f.rel, kinds: Array.isArray(f.kinds) ? f.kinds : [], ...(f.origRel ? { origRel: f.origRel } : {}) })),
|
|
2114
|
+
}
|
|
2115
|
+
// ⚠️ 载荷里**不带 `root` / `hostRoot`**:它们是绝对文件系统路径,而客户端只用工作区相对
|
|
2116
|
+
// 路径就能定位每一篇(`target` / `origin` 都是 rel)。面板要从别处拿根路径就去问
|
|
2117
|
+
// `/api/recent`(它本来就有)—— 关联接口不重复暴露一遍绝对路径。
|
|
2118
|
+
const shell = { ok: true, mode: 'changes', git, links: [], linksTotal: 0, unresolved: [], outOfScope: [] }
|
|
2119
|
+
if (!git.available) return shell
|
|
2120
|
+
|
|
2121
|
+
const corpusRels = new Set(corpus.map((d) => String(d.rel)))
|
|
2122
|
+
const docOf = new Map(corpus.map((d) => [String(d.rel), d]))
|
|
2123
|
+
const { seeds, gone, outside, seedRels } = splitSeeds(changeSet, corpusRels)
|
|
2124
|
+
// ⚠️ 种子要**带上 `gone`**:删掉的测试文件照样牵着它的被测文件(那正是要答的问题),
|
|
2125
|
+
// 只是它自己不能当结果(`corpusRels` 里没有它)。
|
|
2126
|
+
if (seedRels.length === 0) return { ...shell, outOfScope: outside }
|
|
2127
|
+
|
|
2128
|
+
// 变更文件**自己不当结果**(这一区回答的是「还该看什么」)。
|
|
2129
|
+
// ⚠️ 与上一版的差别:这里**不再**排除「已经在三层里的条目」—— 那需要先有一份包才知道,
|
|
2130
|
+
// 而独立接口不该为了一个减法去装配一份三层。两边都出现不是重复:一个是「这一轮该先看什么」,
|
|
2131
|
+
// 一个是「我改的东西牵着谁」。客户端按 rel 去重(它手上两份都有)。
|
|
2132
|
+
const exclude = new Set(seeds)
|
|
2133
|
+
|
|
2134
|
+
// 已删除 / 重命名前的路径当种子时要有「空壳」候选,否则别人指向它的边解析不出来。
|
|
2135
|
+
// ⚠️ 没有 gone 时**不拼**这个数组 —— 那样候选集与装配层那一份逐字相同,
|
|
2136
|
+
// `relations.js` 的缓存(按候选集签名)能直接命中,省掉一次 10 ms 级的重算。
|
|
2137
|
+
const candidates = gone.length > 0 ? [...corpus, ...ghostCandidates(gone)] : corpus
|
|
2138
|
+
const facts = buildRelationFacts(candidates, { root })
|
|
2139
|
+
const projected = projectChangeRelated({
|
|
2140
|
+
seeds: seedRels, incident: facts.incident, itemRels: corpusRels, exclude, limit: MAX_CHANGE_RELATED,
|
|
2141
|
+
})
|
|
2142
|
+
const links = projected.related.map((row) => {
|
|
2143
|
+
const doc = docOf.get(row.rel)
|
|
2144
|
+
if (!doc) return null
|
|
2145
|
+
// 每条证据一行:起点 / 类型 / 方向 / 行号(`line` 没有就是 `null`,不省略 —— 专用结构里
|
|
2146
|
+
// 「这里没有行号」本身是信息,而 `tests` 那一类就是没有)。
|
|
2147
|
+
const evidence = row.evidence.map((e) => ({
|
|
2148
|
+
origin: e.other,
|
|
2149
|
+
type: e.type,
|
|
2150
|
+
dir: e.dir,
|
|
2151
|
+
line: Number.isInteger(e.line) ? e.line : null,
|
|
2152
|
+
}))
|
|
2153
|
+
return {
|
|
2154
|
+
target: row.rel,
|
|
2155
|
+
kind: doc.kind || KIND_DOCUMENT,
|
|
2156
|
+
source: sourceTypeOf(row.rel),
|
|
2157
|
+
title: doc.title || row.rel,
|
|
2158
|
+
summary: doc.summary == null ? '' : String(doc.summary),
|
|
2159
|
+
mtimeMs: Number.isFinite(doc.mtimeMs) ? doc.mtimeMs : 0,
|
|
2160
|
+
evidence,
|
|
2161
|
+
evidenceTotal: row.evidenceTotal,
|
|
2162
|
+
types: row.types,
|
|
2163
|
+
}
|
|
2164
|
+
}).filter(Boolean)
|
|
2165
|
+
return {
|
|
2166
|
+
...shell,
|
|
2167
|
+
links,
|
|
2168
|
+
linksTotal: projected.relatedTotal,
|
|
2169
|
+
// ⚠️ 两个计数**不许重复算同一篇**(写完当场被测试抓到过一次):
|
|
2170
|
+
// · `unresolved` 只说「在语料里、但一条证据都没有」的那些(= 查过了,没有);
|
|
2171
|
+
// · 语料之外的(删除的、重命名前的、这一档不认的后缀)只进 `outOfScope`(= 根本没得查)。
|
|
2172
|
+
// 它们仍然**当种子**用(`seedRels` 带着它们),只是不该被说成「查了没查到」。
|
|
2173
|
+
unresolved: projected.unresolved.filter((rel) => corpusRels.has(rel)),
|
|
2174
|
+
outOfScope: outside,
|
|
2175
|
+
}
|
|
1990
2176
|
}
|
|
1991
2177
|
|
|
1992
2178
|
/**
|
|
@@ -2816,6 +3002,9 @@ export function apply(ctx) {
|
|
|
2816
3002
|
const body = publicScanPayload(payload)
|
|
2817
3003
|
// v0.14:相关模式下顺带给出任务上下文分层。
|
|
2818
3004
|
// ⚠️ 带上 `context` 是**可选**的(老客户端忽略它),而 `docs` 一字未动。
|
|
3005
|
+
// ⚠️ v0.25(第二轮修订):**这里不再有任何 Git 变更关联**。`/api/recent` 的响应
|
|
3006
|
+
// 与 v0.24 逐字相同(`changes` 那个键根本不存在)—— 变更关联走独立的
|
|
3007
|
+
// `/knit/api/changes`。这条纪律有测试守着:常规检索请求里不许出现变更字段。
|
|
2819
3008
|
body.context = await contextPayload(root, payload, sort, kind)
|
|
2820
3009
|
// v0.21:面板要显示「固定了什么 / 排除了什么」(含恢复按钮),而这两份
|
|
2821
3010
|
// 是**用户动作的原始记录**,不是 Context Pack 的投影 —— 固定项本身在
|
|
@@ -2872,6 +3061,40 @@ export function apply(ctx) {
|
|
|
2872
3061
|
return
|
|
2873
3062
|
}
|
|
2874
3063
|
|
|
3064
|
+
if (url.pathname === `${ROUTE_PREFIX}/api/changes`) {
|
|
3065
|
+
/* v0.25 · **Git 变更关联**:独立接口。
|
|
3066
|
+
⚠️ 与 `/api/recent` 分开不是洁癖,是契约纪律:
|
|
3067
|
+
· `/api/recent` 的响应形状**一个键都不加**(与 v0.24 逐字相同)——
|
|
3068
|
+
它同时喂着「只要列表」的调用方,不该因为少数人打开的功能变重;
|
|
3069
|
+
· 这个接口有**自己的数据结构**(起点 / 目标 / 类型 / 行号),不借 Context Pack
|
|
3070
|
+
条目的词汇(`provenance` / `reason` / `relations`)—— 那套词汇属于三层,
|
|
3071
|
+
硬套过来就得扩工具 schema 的枚举,而工具契约不动。
|
|
3072
|
+
成本:**一次 git + 一次扫描**,而且两者都与 `/api/recent` **共用**——
|
|
3073
|
+
`corpusForChanges()` 复用最近一次扫描(8 s 同窗),`gitReader` 自己缓存 + 并发去重。
|
|
3074
|
+
关掉时客户端根本不请求这条路由 ⇒ 一个 git 进程都不 spawn。 */
|
|
3075
|
+
const limit = Math.min(Math.max(Number(url.searchParams.get('limit')) || 40, 1), 100)
|
|
3076
|
+
const sort = url.searchParams.get('sort') === 'time' ? 'time' : 'relevance'
|
|
3077
|
+
// ⚠️ **没有 `kind` 参数**(v0.25 收尾时删掉)。理由是可核验的:变更关联固定用
|
|
3078
|
+
// 「文档 + 代码」那一份**不分档**语料(`collectDocs()` 的结果与档位无关,
|
|
3079
|
+
// 档位只影响 `docs` 那一栏的输出),所以 `kind` 在这里**没有任何语义** ——
|
|
3080
|
+
// 留一个「看着像能过滤、实际什么都不做」的参数比没有它更糟。
|
|
3081
|
+
if (sort !== 'relevance') {
|
|
3082
|
+
// 时间序没有 Context Pack,也就没有「该一起看什么」这回事。如实说,不给空壳。
|
|
3083
|
+
sendJson(res, 200, {
|
|
3084
|
+
ok: true, mode: 'changes', sort,
|
|
3085
|
+
git: { available: false, reason: 'not-relevance-order', filesTotal: 0, truncated: false, files: [] },
|
|
3086
|
+
links: [], linksTotal: 0, unresolved: [], outOfScope: [],
|
|
3087
|
+
})
|
|
3088
|
+
return
|
|
3089
|
+
}
|
|
3090
|
+
const payload = await corpusForChanges(root, {
|
|
3091
|
+
limit,
|
|
3092
|
+
options: { session: sessionOf(webCtx, sessionId), sessionId, sort, kind: 'context' },
|
|
3093
|
+
})
|
|
3094
|
+
sendJson(res, 200, await changesPayload(root, { corpus: payload.contextCorpus }))
|
|
3095
|
+
return
|
|
3096
|
+
}
|
|
3097
|
+
|
|
2875
3098
|
if (url.pathname === `${ROUTE_PREFIX}/api/context`) {
|
|
2876
3099
|
// v0.14:独立的上下文接口。与 `/api/recent` 分开是为了**不让只想拿列表的
|
|
2877
3100
|
// 调用方被迫付引用图的钱** —— 面板走 recent 里的 `context` 字段,
|
|
@@ -2954,7 +3177,7 @@ export function apply(ctx) {
|
|
|
2954
3177
|
|
|
2955
3178
|
webCtx.effect(() => {
|
|
2956
3179
|
const unregister = webCtx.webServer.register({ kind: 'prefix', path: ROUTE_PREFIX, handler })
|
|
2957
|
-
console.log(`[${name}] route ready: ${ROUTE_PREFIX}/api/recent, ${ROUTE_PREFIX}/api/doc, ${ROUTE_PREFIX}/api/raw, ${ROUTE_PREFIX}/api/links, ${ROUTE_PREFIX}/api/context, ${ROUTE_PREFIX}/api/control (POST)`)
|
|
3180
|
+
console.log(`[${name}] route ready: ${ROUTE_PREFIX}/api/recent, ${ROUTE_PREFIX}/api/doc, ${ROUTE_PREFIX}/api/raw, ${ROUTE_PREFIX}/api/links, ${ROUTE_PREFIX}/api/context, ${ROUTE_PREFIX}/api/changes, ${ROUTE_PREFIX}/api/control (POST)`)
|
|
2958
3181
|
return () => unregister()
|
|
2959
3182
|
}, 'dsh-knit: host route')
|
|
2960
3183
|
})
|