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/test/host-http.test.mjs
CHANGED
|
@@ -14,8 +14,8 @@ import { join } from 'node:path'
|
|
|
14
14
|
import { fileURLToPath } from 'node:url'
|
|
15
15
|
import { stat } from 'node:fs/promises'
|
|
16
16
|
|
|
17
|
-
import { apply } from '../src/host/index.js'
|
|
18
17
|
import { makeWorkspace } from './fixture.mjs'
|
|
18
|
+
import { startKnitServer as startKnitHarness } from './http-harness.mjs'
|
|
19
19
|
|
|
20
20
|
/**
|
|
21
21
|
* 测试自带样本工作区(临时目录),里面有 docs/screenshot.png 当媒体样本。
|
|
@@ -32,63 +32,9 @@ const PROJECT_ROOT = makeWorkspace([
|
|
|
32
32
|
['amb.md', '# amb\n\n见 `SKILL.md`(同名两处,不该产生边)\n'],
|
|
33
33
|
])
|
|
34
34
|
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
* ⚠️ `inject` 必须**照抄 cordis 的真实语义**:只有它真的能提供所请求的依赖时才回调。
|
|
39
|
-
* v0.7 给 `apply` 加了第二个 `ctx.inject(['tools'], …)`,如果这里对所有 deps 都无脑回调,
|
|
40
|
-
* 那个回调会拿到一个没有 `tools` 的假 ctx —— 那是**替身的谎**,不是代码的 bug
|
|
41
|
-
* (AGENTS.md §6.1 的教训)。真实的 cordis 在回调前保证依赖可用。
|
|
42
|
-
*
|
|
43
|
-
* @param {object} [session] - 假会话(默认只有一个 header.cwd,没有任何事件)
|
|
44
|
-
* @returns {Promise<{base:string, close:Function}>} 地址根与关闭函数
|
|
45
|
-
*/
|
|
46
|
-
async function startKnitServer(session, sessionId = 's') {
|
|
47
|
-
let handler = null
|
|
48
|
-
const listeners = new Map()
|
|
49
|
-
// ⚠️ v0.16:订阅回调按 `session.id` 认会话,所以假会话必须有 id,
|
|
50
|
-
// 且必须与请求里的 `sessionId` 一致 —— 这正是真机的形状。
|
|
51
|
-
const fakeSession = {
|
|
52
|
-
...(session || {}),
|
|
53
|
-
id: sessionId,
|
|
54
|
-
header: { cwd: PROJECT_ROOT, id: sessionId, ...((session && session.header) || {}) },
|
|
55
|
-
}
|
|
56
|
-
const provided = {
|
|
57
|
-
webServer: {
|
|
58
|
-
register({ handler: h }) { handler = h; return () => {} },
|
|
59
|
-
},
|
|
60
|
-
sessions: { get: () => fakeSession },
|
|
61
|
-
effect(fn) { fn() },
|
|
62
|
-
}
|
|
63
|
-
apply({
|
|
64
|
-
on(name, fn) {
|
|
65
|
-
if (!listeners.has(name)) listeners.set(name, [])
|
|
66
|
-
listeners.get(name).push(fn)
|
|
67
|
-
return () => {}
|
|
68
|
-
},
|
|
69
|
-
inject(deps, cb) {
|
|
70
|
-
// 只提供 webServer / sessions;tools 不存在 → 那条回调不该被调用
|
|
71
|
-
if (!deps.every((dep) => dep in provided)) return
|
|
72
|
-
cb(provided)
|
|
73
|
-
},
|
|
74
|
-
})
|
|
75
|
-
assert.ok(handler, 'apply 应注册路由 handler')
|
|
76
|
-
assert.equal((listeners.get('session/event') || []).length, 1, 'apply 应恰好订阅一次 session/event')
|
|
77
|
-
/**
|
|
78
|
-
* 模拟宿主 append 之后派发的会话事件(v0.16:Knit 唯一的读证据来源)。
|
|
79
|
-
* @param {object|null} event - 会话事件
|
|
80
|
-
* @returns {void}
|
|
81
|
-
*/
|
|
82
|
-
const emit = (event) => {
|
|
83
|
-
for (const fn of listeners.get('session/event') || []) fn(fakeSession, event)
|
|
84
|
-
}
|
|
85
|
-
|
|
86
|
-
const server = http.createServer((req, res) => handler(req, res))
|
|
87
|
-
await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve))
|
|
88
|
-
const base = `http://127.0.0.1:${server.address().port}/knit`
|
|
89
|
-
const close = () => new Promise((resolve) => server.close(resolve))
|
|
90
|
-
return { base, close, emit }
|
|
91
|
-
}
|
|
35
|
+
// v0.25:服务器替身抽到 `test/http-harness.mjs`(`/api/changes` 那条独立接口也要用它)。
|
|
36
|
+
// 这里保留一层**只绑样本工作区**的包装,所以下面所有调用点一行都不用改。
|
|
37
|
+
const startKnitServer = (session, sessionId) => startKnitHarness({ root: PROJECT_ROOT, session, sessionId })
|
|
92
38
|
|
|
93
39
|
test('HTTP 端到端:媒体列表、/raw 整文件、Range 206、安全拒绝', async () => {
|
|
94
40
|
const { base, close } = await startKnitServer()
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 测试用:在**真实回环端口**上跑 `apply()` 注册的 Knit 路由。
|
|
3
|
+
*
|
|
4
|
+
* 抽出来的理由:v0.25 的 `/api/changes` 是**独立接口**,它必须在真实端口上验
|
|
5
|
+
* (路由存在、query 解析、响应形状),而 `host-http.test.mjs` 已经有一份可信的假 ctx。
|
|
6
|
+
* 与其复制一份(两份假件一定会漂移),不如共用。
|
|
7
|
+
*/
|
|
8
|
+
import assert from 'node:assert/strict'
|
|
9
|
+
import http from 'node:http'
|
|
10
|
+
|
|
11
|
+
import { apply } from '../src/host/index.js'
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* 起一个挂着 Knit 路由的**真实回环 server**(伪造 cordis 的 webServer / sessions / effect)。
|
|
15
|
+
*
|
|
16
|
+
* v0.25:从 `host-http.test.mjs` 抽到这里 —— 「/api/changes 是独立接口」这件事必须
|
|
17
|
+
* 在**真实端口**上验(路由、query 参数、序列化形状),而两个测试文件共用同一份替身,
|
|
18
|
+
* 免得两份假 ctx 各自漂移。(`test/` 里的**替身**不挂 `scripts.test`,只有测试文件才挂。)
|
|
19
|
+
*
|
|
20
|
+
* ⚠️ `inject` 必须**照抄 cordis 的真实语义**:只有它真的能提供所请求的依赖时才回调。
|
|
21
|
+
* v0.7 给 `apply` 加了第二个 `ctx.inject(['tools'], …)`,如果这里对所有 deps 都无脑回调,
|
|
22
|
+
* 那个回调会拿到一个没有 `tools` 的假 ctx —— 那是**替身的谎**,不是代码的 bug
|
|
23
|
+
* (AGENTS.md §6.1 的教训)。真实的 cordis 在回调前保证依赖可用。
|
|
24
|
+
*
|
|
25
|
+
* @param {{root: string, session?: object, sessionId?: string}} options
|
|
26
|
+
* `root` = **工作区根**(决定这个假会话看到哪个目录;每个用例自己造)
|
|
27
|
+
* @returns {Promise<{base:string, close:Function, emit:Function}>} 地址根、关闭函数、事件投递
|
|
28
|
+
*/
|
|
29
|
+
export async function startKnitServer(options = {}) {
|
|
30
|
+
const { root } = options
|
|
31
|
+
const session = options.session
|
|
32
|
+
const sessionId = options.sessionId || 's'
|
|
33
|
+
if (!root) throw new Error('startKnitServer 需要 root')
|
|
34
|
+
let handler = null
|
|
35
|
+
const listeners = new Map()
|
|
36
|
+
// ⚠️ v0.16:订阅回调按 `session.id` 认会话,所以假会话必须有 id,
|
|
37
|
+
// 且必须与请求里的 `sessionId` 一致 —— 这正是真机的形状。
|
|
38
|
+
const fakeSession = {
|
|
39
|
+
...(session || {}),
|
|
40
|
+
id: sessionId,
|
|
41
|
+
header: { cwd: root, id: sessionId, ...((session && session.header) || {}) },
|
|
42
|
+
}
|
|
43
|
+
const provided = {
|
|
44
|
+
webServer: {
|
|
45
|
+
register({ handler: h }) { handler = h; return () => {} },
|
|
46
|
+
},
|
|
47
|
+
sessions: { get: () => fakeSession },
|
|
48
|
+
effect(fn) { fn() },
|
|
49
|
+
}
|
|
50
|
+
apply({
|
|
51
|
+
on(name, fn) {
|
|
52
|
+
if (!listeners.has(name)) listeners.set(name, [])
|
|
53
|
+
listeners.get(name).push(fn)
|
|
54
|
+
return () => {}
|
|
55
|
+
},
|
|
56
|
+
inject(deps, cb) {
|
|
57
|
+
// 只提供 webServer / sessions;tools 不存在 → 那条回调不该被调用
|
|
58
|
+
if (!deps.every((dep) => dep in provided)) return
|
|
59
|
+
cb(provided)
|
|
60
|
+
},
|
|
61
|
+
})
|
|
62
|
+
assert.ok(handler, 'apply 应注册路由 handler')
|
|
63
|
+
assert.equal((listeners.get('session/event') || []).length, 1, 'apply 应恰好订阅一次 session/event')
|
|
64
|
+
/**
|
|
65
|
+
* 模拟宿主 append 之后派发的会话事件(v0.16:Knit 唯一的读证据来源)。
|
|
66
|
+
* @param {object|null} event - 会话事件
|
|
67
|
+
* @returns {void}
|
|
68
|
+
*/
|
|
69
|
+
const emit = (event) => {
|
|
70
|
+
for (const fn of listeners.get('session/event') || []) fn(fakeSession, event)
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
const server = http.createServer((req, res) => handler(req, res))
|
|
74
|
+
await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve))
|
|
75
|
+
const base = `http://127.0.0.1:${server.address().port}/knit`
|
|
76
|
+
const close = () => new Promise((resolve) => server.close(resolve))
|
|
77
|
+
return { base, close, emit }
|
|
78
|
+
}
|
|
79
|
+
|