Skip to content

Commit 67b7f36

Browse files
committed
fix(choro): 写路径空根守卫 + scp userinfo 段内剥离 + 索引退化告警
- /choro/run 解析到空根(本机未登记位置且回退目录身份核验不过)时回 409 repo-not-reachable-here,不再把宿主 cwd 交给 T0 写入模块与页 - normalizeGitUrl 只在主机段内剥 userinfo,路径里的 @ 不再整段丢失 - portable_key 唯一索引退化时补一行 warn,不再静默降级 - 回归 +2(空根 409 且不触 T0 / 旧装配缺方法退回 root_path),URL 形态表 +5 断言 - 全量 3457 tests / 3456 pass / 0 fail / 1 skip
1 parent 9737ceb commit 67b7f36

9 files changed

Lines changed: 126 additions & 13 deletions

File tree

‎dsh-mneme/CHANGELOG.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
## [Unreleased]
44

5-
- **仓库地志的身份与位置分家:`portable_key` + 每机位置表,双系统 / 双机共享同一个 memory.db 时地志第一次可以跨端复用(#581)**:mneme 把「库共享」做到了(`memoryDir` + WAL + busy_timeout),chorography 是唯一一处因为记了本机绝对路径而破坏这个前提的功能——Windows 端登记的行,macOS 端拼出来的路径不存在;再跑一次 T0 又多出第二行,从此不带 `repo` 参数的调用命中 repo-ambiguous;T1 的逐字符严格匹配更意味着**每端都必须先各自跑一次 T0**。修法按 issue 的最小方案落地,三个概念各就各位:**身份** = `choro_repos.portable_key`(新列,幂等迁移),取 `remote.origin.url` 归一化——协议头 / 尾斜杠 / 尾 `.git` / 大小写剥平,scp 形态(`git@host:path`)的冒号换 `/`,**userinfo 整体剥掉**(token 不进键:泄进库里是一回事,令牌轮换后同一仓库算出不同键是另一回事);无 remote 退化到**根提交哈希**(`git:<hash>`,跨副本恒定且与「碰巧同名的别的仓库」天然区分——issue 提的「退化为仓库名」不能用,目录名与 package name 重合率太高,第二次登记会吃掉别人的行,实现期在测试夹具上当场撞到)。**位置** = 新表 `choro_repo_paths(repo_key, host_id, root_path, last_seen_at)`,`host_id = os.hostname()`,T0/T1 登记时 upsert。**读侧**(`queries.js` 的 `localRootPath`)按当前 host 取本机路径、取不到回退身份行的 root_path——单机库两个值恒等、行为逐字节不变;本机没登记过时落进既有的 page-missing / unreadable 失败口径,不会拿别的机器的路径读出错误内容。**T1 的登记校验**从「root_path 逐字符相同」改成「本机路径命中**或**身份已登记」——同一仓库在另一台机器登记过,本机直接认领那一行富化,消灭「每端先各跑一次 T0」;认领同时落本机位置行。写路径(`/choro/run`、`/choro/t1` 后台任务、`/choro` 命令的过期判定)同样改吃本机根。**两个刻意的取舍**:① 同键登记收敛到同一行,但 root_path 的 UPDATE 前先查目标值是否被别的行占着(被占保留原值、位置走位置表)——升格期已跨端登记出的重复行**不合并**(页面与 claims 挂在 repo_id 上,机器间合并行等于改写归属),强行改会撞 `idx_choro_repos_root` 直接抛;② 升格存量行的键留 NULL,由它自己的机器重跑 T0/T1 时补上,不猜。已知边界:kb 导入的 choro_page source 是导入当时的绝对路径快照,跨端复用时会失配,另账处理。回归测试 +10(URL 归一化形态表含凭据剥离 / 无 remote 退化链与恒定性 / 旧库补列补表且重开幂等 / 位置表同键同机覆写 / 同键跨端登记收敛同一行且 created_at 不动 / 升格期 root 被占不强改 / 读侧三 host 各解析各的 / **T1 跨端认领端到端**:克隆检出直接富化身份行并登记本机位置),另把四个「同库登记两个相同夹具」的既有用例显式区分开(无 remote 键是根提交哈希,同秒提交的相同内容会同键收敛——这本身就是退化链设计的防误并性质)。变异自证 3 例(删 `upsertChoroRepoPath`/`choroRepoPathFor` 的 return 出口 → store 用例 3 红;读侧 `localRootPath` 去掉位置行解析 → queries 用例红;T1 去掉 byKey 认领 → 端到端用例红),恢复后全绿。**评审补丁(PR #679,六条 Major 全部成立)**:① **路径回退要核验身份**——两台主机的同一条绝对路径可能各自检出不同仓库,`upsertChoroRepo` / T1 的登记校验、读侧 `localRootPath` 都改成「身份优先,路径回退只接受无键存量行或键一致的行」;核验用 `portableKeyFor`(一次 git 读取,按「键+路径」记忆化),不符时读侧返回空串并按 `page-missing` / 不可读上报,绝不 `join("", rel)` 去读进程 CWD;`claimDrift` 的 `hasT1` 同样加了空根守卫。② **身份唯一**:`portable_key` 加部分唯一索引(`WHERE portable_key IS NOT NULL`),插入撞唯一键时回读同一身份行改走更新——并发登记不再产生重复行;索引建失败(存量重复键)退成非唯一索引,不让插件起不来。③ **URL 解析分清端口与 scp 分隔符**:带协议头时 authority 的冒号是端口(默认端口 ssh 22 / https 443 / git 9418 剥掉,其余保留),只有 scp 形态的冒号才是路径分隔符;④ **userinfo 只在 authority 段内剥**,仓库路径里的 `@`(`repo@stable`)不再把主机与路径一起切掉。⑤ `repoByCwd` 的最长前缀改为比较候选自身路径长度(原实现拿身份行里那条外地路径比长度,内层本机路径永远赢不了)。新增回归 5 条(端口 vs 路径段 / 路径里的 @ / 同路径另一身份拒绝且原行不变 / 回退目录身份不符报 page-missing / 前缀比较用候选长度),变异自证 6 例逐条变红。
5+
- **仓库地志的身份与位置分家:`portable_key` + 每机位置表,双系统 / 双机共享同一个 memory.db 时地志第一次可以跨端复用(#581)**:mneme 把「库共享」做到了(`memoryDir` + WAL + busy_timeout),chorography 是唯一一处因为记了本机绝对路径而破坏这个前提的功能——Windows 端登记的行,macOS 端拼出来的路径不存在;再跑一次 T0 又多出第二行,从此不带 `repo` 参数的调用命中 repo-ambiguous;T1 的逐字符严格匹配更意味着**每端都必须先各自跑一次 T0**。修法按 issue 的最小方案落地,三个概念各就各位:**身份** = `choro_repos.portable_key`(新列,幂等迁移),取 `remote.origin.url` 归一化——协议头 / 尾斜杠 / 尾 `.git` / 大小写剥平,scp 形态(`git@host:path`)的冒号换 `/`,**userinfo 整体剥掉**(token 不进键:泄进库里是一回事,令牌轮换后同一仓库算出不同键是另一回事);无 remote 退化到**根提交哈希**(`git:<hash>`,跨副本恒定且与「碰巧同名的别的仓库」天然区分——issue 提的「退化为仓库名」不能用,目录名与 package name 重合率太高,第二次登记会吃掉别人的行,实现期在测试夹具上当场撞到)。**位置** = 新表 `choro_repo_paths(repo_key, host_id, root_path, last_seen_at)`,`host_id = os.hostname()`,T0/T1 登记时 upsert。**读侧**(`queries.js` 的 `localRootPath`)按当前 host 取本机路径、取不到回退身份行的 root_path——单机库两个值恒等、行为逐字节不变;本机没登记过时落进既有的 page-missing / unreadable 失败口径,不会拿别的机器的路径读出错误内容。**T1 的登记校验**从「root_path 逐字符相同」改成「本机路径命中**或**身份已登记」——同一仓库在另一台机器登记过,本机直接认领那一行富化,消灭「每端先各跑一次 T0」;认领同时落本机位置行。写路径(`/choro/run`、`/choro/t1` 后台任务、`/choro` 命令的过期判定)同样改吃本机根。**两个刻意的取舍**:① 同键登记收敛到同一行,但 root_path 的 UPDATE 前先查目标值是否被别的行占着(被占保留原值、位置走位置表)——升格期已跨端登记出的重复行**不合并**(页面与 claims 挂在 repo_id 上,机器间合并行等于改写归属),强行改会撞 `idx_choro_repos_root` 直接抛;② 升格存量行的键留 NULL,由它自己的机器重跑 T0/T1 时补上,不猜。已知边界:kb 导入的 choro_page source 是导入当时的绝对路径快照,跨端复用时会失配,另账处理。回归测试 +10(URL 归一化形态表含凭据剥离 / 无 remote 退化链与恒定性 / 旧库补列补表且重开幂等 / 位置表同键同机覆写 / 同键跨端登记收敛同一行且 created_at 不动 / 升格期 root 被占不强改 / 读侧三 host 各解析各的 / **T1 跨端认领端到端**:克隆检出直接富化身份行并登记本机位置),另把四个「同库登记两个相同夹具」的既有用例显式区分开(无 remote 键是根提交哈希,同秒提交的相同内容会同键收敛——这本身就是退化链设计的防误并性质)。变异自证 3 例(删 `upsertChoroRepoPath`/`choroRepoPathFor` 的 return 出口 → store 用例 3 红;读侧 `localRootPath` 去掉位置行解析 → queries 用例红;T1 去掉 byKey 认领 → 端到端用例红),恢复后全绿。**评审补丁(PR #679,六条 Major 全部成立)**:① **路径回退要核验身份**——两台主机的同一条绝对路径可能各自检出不同仓库,`upsertChoroRepo` / T1 的登记校验、读侧 `localRootPath` 都改成「身份优先,路径回退只接受无键存量行或键一致的行」;核验用 `portableKeyFor`(一次 git 读取,按「键+路径」记忆化),不符时读侧返回空串并按 `page-missing` / 不可读上报,绝不 `join("", rel)` 去读进程 CWD;`claimDrift` 的 `hasT1` 同样加了空根守卫。② **身份唯一**:`portable_key` 加部分唯一索引(`WHERE portable_key IS NOT NULL`),插入撞唯一键时回读同一身份行改走更新——并发登记不再产生重复行;索引建失败(存量重复键)退成非唯一索引,不让插件起不来。③ **URL 解析分清端口与 scp 分隔符**:带协议头时 authority 的冒号是端口(默认端口 ssh 22 / https 443 / git 9418 剥掉,其余保留),只有 scp 形态的冒号才是路径分隔符;④ **userinfo 只在 authority 段内剥**,仓库路径里的 `@`(`repo@stable`)不再把主机与路径一起切掉。⑤ `repoByCwd` 的最长前缀改为比较候选自身路径长度(原实现拿身份行里那条外地路径比长度,内层本机路径永远赢不了)。新增回归 5 条(端口 vs 路径段 / 路径里的 @ / 同路径另一身份拒绝且原行不变 / 回退目录身份不符报 page-missing / 前缀比较用候选长度),变异自证 6 例逐条变红。**二轮评审补丁**:① **写路径补空根守卫**——`/choro/run` 原先直接吃 `localRootForRepo` 的返回值,该方法在本机未登记位置、且回退目录身份核验不过时返回空串,`resolve("")` 即宿主 cwd,T0 会把那里的模块与页写进这条 repo 行(「同一路径不同仓库」事故的另一半:读路径挡住了、写路径漏了);现在空根直接 409 `repo-not-reachable-here`,并对旧装配沿用 `typeof` 守卫退回 `root_path`。② **userinfo 只在主机段内剥**:scp 形态先在冒号处切开再找 `@`,`github.com:team/repo@stable` 不再退化成整段丢失的 `stable`。③ 唯一索引建失败退普通索引时补一行 warn,不再静默降级。新增回归 2 条(空根 409 且不触 T0 / 旧装配缺方法退回 `root_path`),URL 形态表补 5 条断言;变异自证 4 红(撤守卫 + 退回全串 `indexOf("@")`)。
66

77
## [0.14.0-beta.3] - 2026-11-12
88
- **品牌视觉换新:README 头图与插件列表图标**。三处 README(根、`dsh-mneme/`、`mcp/`)顶部改用 `images/mneme-banner-hero.webp`(1672×941,282 KiB)——原图 2.1 MiB 的 PNG 会让 `images/` 目录体积翻倍。根目录用相对路径,两个子目录用 raw 绝对地址:npm 详情页不解析相对图片路径,`../images/...` 在 npmjs.com 上必然裂图。

‎dsh-mneme/lib/api.js‎

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3460,7 +3460,20 @@ export function createApi(ctx, service, settings, commands, embedder, semantic =
34603460
}
34613461
// 本机可用的根(#581):身份行上的 root_path 可能是别的机器最近一次
34623462
// 登记的位置,直接拿去跑 T0 会 no-such-dir。
3463-
repoRoot = choro.localRootForRepo(repo);
3463+
// 旧装配没有 localRootForRepo(#581 之前):退回身份行的 root_path,
3464+
// 与 choro-command 的 typeof 守卫同形,不让装配差异变成 500。
3465+
const localRoot = typeof choro.localRootForRepo === "function"
3466+
? choro.localRootForRepo(repo)
3467+
: repo.root_path;
3468+
// 空串 = 本机不可达(queries.localRootForRepo 的契约:本机没登记位置、
3469+
// 回退目录又核验不过身份时返回空串)。**绝不能**把它交给 T0——
3470+
// realpathSync(resolve("")) 会落到宿主进程的 cwd,把那里的模块与页写进
3471+
// 这条 repo 行,正是本 PR 想挡的「同路径不同仓库」事故(PR #679 评审)。
3472+
if (!localRoot) {
3473+
sendJson(res, 409, { error: "repo-not-reachable-here", repo: repoRef ?? null });
3474+
return;
3475+
}
3476+
repoRoot = localRoot;
34643477
}
34653478

34663479
try {

‎dsh-mneme/lib/store.js‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1397,8 +1397,15 @@ export function createStore(path) {
13971397
// 时生效,退化的库上并发仍可能重复,这是启动可用性与约束强度之间的取舍。
13981398
try {
13991399
db.exec("CREATE UNIQUE INDEX IF NOT EXISTS idx_choro_repos_portable ON choro_repos(portable_key) WHERE portable_key IS NOT NULL;");
1400-
} catch {
1400+
} catch (err) {
1401+
// 静默降级会让「约束没建成」这件事永远没人知道(PR #679 评审):留一行 warn,
1402+
// 说明退到哪一档、后果是什么,然后照常启动。
14011403
db.exec("CREATE INDEX IF NOT EXISTS idx_choro_repos_portable ON choro_repos(portable_key);");
1404+
console.warn(
1405+
"[mneme] choro_repos.portable_key 唯一索引未能建立(存量重复键?),已退化为普通索引:" +
1406+
"跨端并发登记可能产生重复行,建议先合并重复的 portable_key。" +
1407+
` 原因:${String(err?.message ?? err)}`
1408+
);
14021409
}
14031410

14041411
// v0.8.0 A1(issue #17)scope 隔离存储层:四列全部可空、不带 DEFAULT——存量行

‎dsh-mneme/lib/wiki/portable.js‎

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -50,12 +50,21 @@ export function normalizeGitUrl(rawUrl) {
5050
return out || null;
5151
}
5252
// scp 形态:`[user@]host:path`;没有协议头,冒号是路径分隔符。
53+
// userinfo 只在**主机段内**剥(PR #679 评审):`github.com:team/repo@stable` 的
54+
// `@` 落在路径里,不是凭据。拿全串的 indexOf 去切会把主机与路径一起吞掉,
55+
// 键退化成 `stable`——两个毫不相干的仓库算出同一个身份,比缺键更糟。
5356
let s = raw.replace(/\/+$/, "").replace(/\.git$/i, "");
54-
const at = s.indexOf("@");
55-
if (at !== -1) s = s.slice(at + 1);
5657
const colon = s.indexOf(":");
57-
if (colon === -1) return s.toLowerCase() || null;
58-
const host = s.slice(0, colon);
58+
if (colon === -1) {
59+
// 无冒号(`host/path` 或 `user@host/path`):只有第一个 `/` 之前的 `@` 才是 userinfo。
60+
const slash = s.indexOf("/");
61+
const at = s.indexOf("@");
62+
if (at !== -1 && (slash === -1 || at < slash)) s = s.slice(at + 1);
63+
return s.toLowerCase() || null;
64+
}
65+
const hostSegment = s.slice(0, colon);
66+
const at = hostSegment.indexOf("@");
67+
const host = at === -1 ? hostSegment : hostSegment.slice(at + 1);
5968
const path = s.slice(colon + 1);
6069
const out = `${host}/${path}`.toLowerCase();
6170
return out || null;

‎dsh-mneme/src/api.js‎

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3460,7 +3460,20 @@ export function createApi(ctx, service, settings, commands, embedder, semantic =
34603460
}
34613461
// 本机可用的根(#581):身份行上的 root_path 可能是别的机器最近一次
34623462
// 登记的位置,直接拿去跑 T0 会 no-such-dir。
3463-
repoRoot = choro.localRootForRepo(repo);
3463+
// 旧装配没有 localRootForRepo(#581 之前):退回身份行的 root_path,
3464+
// 与 choro-command 的 typeof 守卫同形,不让装配差异变成 500。
3465+
const localRoot = typeof choro.localRootForRepo === "function"
3466+
? choro.localRootForRepo(repo)
3467+
: repo.root_path;
3468+
// 空串 = 本机不可达(queries.localRootForRepo 的契约:本机没登记位置、
3469+
// 回退目录又核验不过身份时返回空串)。**绝不能**把它交给 T0——
3470+
// realpathSync(resolve("")) 会落到宿主进程的 cwd,把那里的模块与页写进
3471+
// 这条 repo 行,正是本 PR 想挡的「同路径不同仓库」事故(PR #679 评审)。
3472+
if (!localRoot) {
3473+
sendJson(res, 409, { error: "repo-not-reachable-here", repo: repoRef ?? null });
3474+
return;
3475+
}
3476+
repoRoot = localRoot;
34643477
}
34653478

34663479
try {

‎dsh-mneme/src/store.js‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1397,8 +1397,15 @@ export function createStore(path) {
13971397
// 时生效,退化的库上并发仍可能重复,这是启动可用性与约束强度之间的取舍。
13981398
try {
13991399
db.exec("CREATE UNIQUE INDEX IF NOT EXISTS idx_choro_repos_portable ON choro_repos(portable_key) WHERE portable_key IS NOT NULL;");
1400-
} catch {
1400+
} catch (err) {
1401+
// 静默降级会让「约束没建成」这件事永远没人知道(PR #679 评审):留一行 warn,
1402+
// 说明退到哪一档、后果是什么,然后照常启动。
14011403
db.exec("CREATE INDEX IF NOT EXISTS idx_choro_repos_portable ON choro_repos(portable_key);");
1404+
console.warn(
1405+
"[mneme] choro_repos.portable_key 唯一索引未能建立(存量重复键?),已退化为普通索引:" +
1406+
"跨端并发登记可能产生重复行,建议先合并重复的 portable_key。" +
1407+
` 原因:${String(err?.message ?? err)}`
1408+
);
14021409
}
14031410

14041411
// v0.8.0 A1(issue #17)scope 隔离存储层:四列全部可空、不带 DEFAULT——存量行

‎dsh-mneme/src/wiki/portable.js‎

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -50,12 +50,21 @@ export function normalizeGitUrl(rawUrl) {
5050
return out || null;
5151
}
5252
// scp 形态:`[user@]host:path`;没有协议头,冒号是路径分隔符。
53+
// userinfo 只在**主机段内**剥(PR #679 评审):`github.com:team/repo@stable` 的
54+
// `@` 落在路径里,不是凭据。拿全串的 indexOf 去切会把主机与路径一起吞掉,
55+
// 键退化成 `stable`——两个毫不相干的仓库算出同一个身份,比缺键更糟。
5356
let s = raw.replace(/\/+$/, "").replace(/\.git$/i, "");
54-
const at = s.indexOf("@");
55-
if (at !== -1) s = s.slice(at + 1);
5657
const colon = s.indexOf(":");
57-
if (colon === -1) return s.toLowerCase() || null;
58-
const host = s.slice(0, colon);
58+
if (colon === -1) {
59+
// 无冒号(`host/path` 或 `user@host/path`):只有第一个 `/` 之前的 `@` 才是 userinfo。
60+
const slash = s.indexOf("/");
61+
const at = s.indexOf("@");
62+
if (at !== -1 && (slash === -1 || at < slash)) s = s.slice(at + 1);
63+
return s.toLowerCase() || null;
64+
}
65+
const hostSegment = s.slice(0, colon);
66+
const at = hostSegment.indexOf("@");
67+
const host = at === -1 ? hostSegment : hostSegment.slice(at + 1);
5968
const path = s.slice(colon + 1);
6069
const out = `${host}/${path}`.toLowerCase();
6170
return out || null;

0 commit comments

Comments
 (0)