@feng0531/dsh-code-review 0.64.1 → 0.66.0

package/CHANGELOG.md

@@ -2,9 +2,17 @@
 
 本文件介绍对使用者有意义的变化。安装与参数见 [README](README.md)，本次发布正文见 [发布说明](RELEASE-NOTES.md)。历史提交和安装包保留在 [GitHub Releases](https://github.com/f-e-n-g-0531/dsh-code-review/releases)；本文不把开发日志当作功能介绍。
 
+## 0.66.0 — SVN 历史显式 mergeinfo 来源导航
+
+对已批准历史变更的 svn:mergeinfo 属性增加有界来源路径/区间导航，保留非继承标记，不展开 revision、不读取分支源码。预览和报告 history 保留旧/新导航；无效或超限元数据明确标记且不输出部分导航，不阻断原属性审查。不是有效继承 mergeinfo、源码归属或已审查提交证明；跨 URL 比较仍待实现。
+
+## 0.65.0 — SVN 历史文件/目录类型替换
+
+固定历史增删对分别记录 oldKind/newKind，读取各自节点正文和属性，支持已提交文件→目录和目录→文件。预览披露类型与说明，目录一侧后代独立覆盖且由深至浅传播未完成；目录空正文不作为空文件或旧上下文。未提交工作副本替换仍阻断，多记录与无效状态仍拒绝。482 项串行回归、宿主、隔离安装和四矩阵 CI 通过；原产物/npm/Release 128,792 字节逐字节一致，双哈希、清单与冻结发布说明通过。
+
 ## 0.64.1 — SVN 已提交历史替换双侧采集修复
 
-固定 revision summary 中同一路径的同类型 deleted/added 两记录合并为 replaced，分别从目标旧/新 revision 读取正文及属性，避免此前将合法历史替换当作重复路径拒绝。只接受一对同类型增删，重复新增/删除、多记录或类型变化继续拒绝；目录替换仍检查子项覆盖。未提交工作副本替换不因此开放。
+固定 revision summary 中同一路径的同类型 deleted/added 两记录合并为 replaced，分别从目标旧/新 revision 读取正文及属性，避免此前将合法历史替换当作重复路径拒绝。只接受一对同类型增删，重复新增/删除、多记录或类型变化继续拒绝；目录替换仍检查子项覆盖。未提交工作副本替换不因此开放。481 项串行回归、宿主、隔离安装及四矩阵 CI 通过；原产物/npm/Release 128,279 字节逐字节一致，双哈希、清单与冻结发布说明通过。
 
 ## 0.64.0 — SVN 历史旧侧独有上下文
 

package/CORE-ALIGNMENT-TASKS.md

@@ -32,7 +32,9 @@
 
 ## 当前验证结论
 
-- 最近完整回归：479 项通过。
+- 最近完整回归：482 项通过。
+- v0.65.0 已交付固定 SVN 历史文件/目录类型替换，各侧节点类型/正文/属性与来源独立绑定，预览披露且后代覆盖保护保留。482 项串行回归、宿主、隔离安装和四矩阵 CI 通过；原产物/npm/Release 128,792 字节逐字节一致，双哈希、清单与冻结发布说明通过。未提交替换、自动历史链/调用方和其他全面 SVN 缺口仍待实现。
+- v0.64.1 已修复已提交 SVN 历史替换的同路径增删记录，真实目标旧/新正文和属性逐侧读取。481 项串行回归、宿主、隔离安装和四矩阵 CI 通过；原产物/npm/Release 128,279 字节逐字节一致，双哈希、清单与冻结发布说明通过。未提交工作副本替换和类型变化等仍未支持，全面目标继续。
 - v0.64.0 已交付 SVN 历史 oldContextPaths，仅旧侧正文及来源身份，不合成目标，选中旧变更复用原身份，排除项拒绝回流。479 项串行回归、宿主、隔离安装和四矩阵 CI 通过；原产物/npm/Release 127,879 字节逐字节一致，双哈希、清单与冻结发布说明通过。自动历史链、调用方及全面 SVN 矩阵仍未闭环。
 - v0.63.0 已交付 SVN 历史显式双侧上下文与目标规则，以及模型 JSON/read 请求的安全诊断。477 项串行回归、宿主、隔离安装和四矩阵 CI 通过；原产物/npm/Release 127,355 字节逐字节一致，双哈希、清单与冻结发布说明通过。用户 loader 的实际协议失败尚未核验，不宣称已修复该样本；历史自动链/调用方、旧侧独有上下文及其他 SVN 缺口继续。
 - v0.62.0 已交付 SVN 原生固定 revision/区间初始审查：显式远端门禁、固定双侧正文/属性/来源身份、目录后代覆盖和确认执行链。472 项串行回归、宿主、隔离安装与四矩阵 CI 通过；原产物/npm/Release 125,486 字节逐字节一致，双哈希、清单与冻结发布说明通过。历史上下文/规则/调用方、跨 URL 分支和工作副本替换等仍待实现。

package/RELEASE-NOTES.md

@@ -1,14 +1,14 @@
-# v0.64.1 发布说明
+# v0.66.0 发布说明
 
-## SVN 已提交历史替换双侧采集修复
+## SVN 历史显式 mergeinfo 来源导航
 
-修复固定 revision 历史审查中，合法替换的同路径删除/新增记录被当作歧义拒绝的问题。
+从已批准固定历史变更中的 svn:mergeinfo 属性生成来源路径和 revision 区间导航，预览及报告 history 保存两侧结果。
 
-- 仅合并同类型节点的一对 deleted/added，为 replaced；其他重复和类型变化拒绝，不任意选择。
-- 从被替换目标的旧 revision 和新 revision 分别读取真实正文与属性，复制替换不使用复制来源 BASE 冒充旧侧。
-- 来源逐侧固定 URL/UUID/peg/operative revision，仍保持选择、预算与目录后代覆盖保护。
-- 独立 SVN 测试覆盖已提交普通与复制替换以及旧属性删除、新属性添加。
+- 保留非继承 `*` 标记，不枚举区间内每个 revision，不增加来源正文读取或网络请求。
+- 导航限 16KiB、100 来源路径、500 区间；无效/超限时明确标记，不静默裁剪或展示部分结果。
+- 已排除/阻断变更不进入导航，原属性正文仍按既有证据流程审查。
+- 来源路径不代表有效继承 mergeinfo、提交归属、审查覆盖，也不授权读取分支源码。
 
-本版仅针对已提交的固定历史版本；未提交工作副本替换、类型变化及其他全面 SVN 缺口仍按 [支持矩阵](SVN-SUPPORT-MATRIX.md) 推进，不以候选 diff 重建冒充支持。
+跨 URL 分支比較、自动历史链、调用方、工作副本替换等仍未完成，详见 [SVN 支持矩阵](SVN-SUPPORT-MATRIX.md)。本版本不把导航作为缺陷证据或完整合并审计。
 
 用法见 [README](README.md)。

package/SVN-SUPPORT-MATRIX.md

@@ -19,14 +19,14 @@
 | 根目录属性/mergeinfo | v0.58.1 已发布；独立复现后修复，指定三文件和默认预览均通过、0 模型发送、状态不变；456 项串行回归、宿主、隔离安装和四矩阵 CI 通过，原产物/npm/Release 116,254 字节逐字节一致及双哈希/清单/发布说明通过 | 第一批先发布此修复 |
 | 复制/移动、copyfrom 及目录结构变更 | v0.59.0 已发布同仓库复制新增文件及文件移动的新增/删除独立覆盖：新增目标旧侧为空，copyfrom 只作来源信息，预览披露并冻结身份；离线与凭据来源拒绝测试通过。459 项串行回归、宿主、隔离安装、四矩阵 CI 通过；原产物/npm/Release 117,098 字节逐字节一致，双哈希/清单/冻结发布说明通过。v0.61.0 已发布同仓库目录复制后代展开与继承来源身份，目标旧侧为空且预览披露。465 项串行回归、宿主、隔离安装、四矩阵 CI 与原包/npm/Release 120,159 字节、双哈希/清单/冻结发布说明通过。复制替换仍未支持 | 第二批：明确旧侧来源和后代覆盖 |
 | 普通新增/删除目录及后代 | v0.60.0 已发布：补齐默认 status 隐藏的删除后代，离线递归枚举与末尾清单复核；普通结构目录只在后代全选且可审查时开放，凭据/阻断子项导致目录覆盖不足。461 项串行回归、宿主、隔离安装与四矩阵 CI 通过；原产物/npm/Release 118,284 字节逐字节一致，双哈希/清单/冻结发布说明通过 | 第二批普通目录子批 |
-| 替换、删除再新增、文件/目录类型变化 | 普通与复制替换分别用 SVN_REPLACEMENT/SVN_COPIED_REPLACEMENT 诊断；离线探测确认前者 BASE 无 pristine，后者可能返回复制来源，禁止伪造旧侧。已新增未接入采集的 candidate-only 完整 diff 重建组件及真实离线测试：匹配完整工作侧，拒绝片段、错侧、截断与超限。diff 仍不能独立证明旧节点/编码/旧属性，因此未提交工作副本真实双侧替换仍未支持，不能把辅助组件算作支持完成。本地修复已提交固定历史版本的同路径 deleted/added 合并，真实目标旧/新正文与属性已测试；待 v0.64.1 发布核验，类型变化仍拒绝 | 第二批：区分 BASE 旧节点与目标节点 |
+| 替换、删除再新增、文件/目录类型变化 | 普通与复制替换分别用 SVN_REPLACEMENT/SVN_COPIED_REPLACEMENT 诊断；离线探测确认前者 BASE 无 pristine，后者可能返回复制来源，禁止伪造旧侧。已新增未接入采集的 candidate-only 完整 diff 重建组件及真实离线测试：匹配完整工作侧，拒绝片段、错侧、截断与超限。diff 仍不能独立证明旧节点/编码/旧属性，因此未提交工作副本真实双侧替换仍未支持，不能把辅助组件算作支持完成。v0.64.1 已发布已提交固定历史版本的同路径 deleted/added 合并，真实目标旧/新正文与属性通过测试；481 项串行回归、宿主、隔离安装、四矩阵 CI 与原包/npm/Release 128,279 字节、双哈希/清单/发布说明通过。v0.65.0 已发布已提交固定历史文件/目录类型替换：分侧 kind/正文/属性、预览披露和目录后代覆盖；482 项串行回归、宿主、隔离安装、四矩阵 CI 与原包/npm/Release 128,792 字节、双哈希/清单/发布说明通过。未提交替换仍拒绝 | 第二批：区分 BASE 旧节点与目标节点 |
 | 缺失、文本/属性/树冲突、阻塞 | v0.60.1 已发布稳定状态诊断：SVN_MISSING_NODE/OBSTRUCTED_NODE/INCOMPLETE_NODE/TEXT_CONFLICT/PROPERTY_CONFLICT/TREE_CONFLICT 等，预览与报告透传 blockCode。463 项串行回归、宿主、隔离安装、四矩阵 CI 与原包/npm/Release 119,462 字节、双哈希/清单/发布说明通过。诊断不算真实双侧支持，仍需后续实现 | 第三批：明确状态诊断；不能合成不存在的工作侧或声称审核通过 |
 | svn:keywords、svn:eol-style | keywords 当前阻断；换行保留原文但无规范化映射 | 第三批：双侧可验证映射，保留原字节和定位 |
 | svn:special/链接 | 当前阻断，不跟随链接取正文 | 第三批：如支持只审链接目标数据；不沿链接读取文件 |
 | switched、externals、稀疏/混合 revision | 多数拒绝；调用方/依赖链要求祖先 normal | 第四批：明确仓库边界与独立来源，禁止隐式跨仓读取 |
 | 固定 revision 单提交 | v0.62.0 已发布 svnRevision：r-1/r 固定对象、UUID/URL/peg/operative revision 逐侧绑定，正文不读工作树；远端显式 svnAllowNetwork。472 项串行回归、宿主、隔离安装、四矩阵 CI 及原包/npm/Release 125,486 字节、双哈希/清单/发布说明通过。历史上下文/规则/调用方尚未支持 | 第五批：新增明确 SVN 参数与冻结身份 |
 | 固定 revision 区间 | v0.62.0 已发布 svnBaseRevision/svnTargetRevision，固定树端点 summary+逐侧 cat/proplist，目录后代与属性纳入预算，不建临时工作树；同上述完整发布验证。分支间不同 URL 和历史上下文尚未支持 | 第五批：固定树端点与逐路径差异 |
-| 分支复制、分支间比较、合并来源 | mergeinfo 当前仅作为属性文本；不证明源码归属或被合并提交均已审查 | 第六批：URL/peg/operative revision 与 mergeinfo 导航披露 |
+| 分支复制、分支间比较、合并来源 | 本地新增批准历史 mergeinfo 属性的来源路径/区间导航，保留非继承标记、有界不展开 revision、不读取分支源码；invalid/limited 明确且不裁剪。待 v0.66.0 发布；有效继承 mergeinfo、跨 URL 比较、源码归属/合并提交覆盖仍未支持 | 第六批：URL/peg/operative revision 与 mergeinfo 导航披露 |
 | 当前三层依赖与限定目录调用方 | 已有安全 normal 节点的离线有界测试；根属性修改可能使祖先检查拒绝，需单独验证 | 第四批补祖先/混合状态组合 |
 | 历史两侧上下文与调用方 | v0.63.0 已发布显式 contextPaths 固定双侧来源及目标 rulePaths，UUID/URL/peg/operative revision/原字节与正文 hash 验证，禁止脏工作树与排除项回流。477 项串行回归、宿主、隔离安装、四矩阵 CI 与原包/npm/Release 127,355 字节、双哈希/清单/发布说明通过。v0.64.0 已发布 oldContextPaths 旧侧独有正文、SVN 来源专用校验、预览披露与选中删除身份复用；479 项串行回归、宿主、隔离安装、四矩阵 CI 与原包/npm/Release 127,879 字节、双哈希/清单/发布说明通过；自动三层历史链与历史调用方仍未实现 | 第六批：逐侧固定版本，不能回退至工作副本 |
 | 真正 r7314→r7315 样本 | 用户未提供隔离副本路径；本地类似复现不是该样本验收 | 获得路径后只读生成预览，不自动发送模型 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feng0531/dsh-code-review",
-  "version": "0.64.1",
+  "version": "0.66.0",
   "private": false,
   "license": "SEE LICENSE IN LICENSE",
   "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org/" },

package/src/service.mjs

@@ -49,7 +49,7 @@ export function createReviewService(llm, { capture = captureSnapshot, now = Date
         while (previews.size >= maxPreviews) previews.delete(previews.keys().next().value);
         const previewId = randomUUID();
         previews.set(previewId, { ...current, target, options, rounds, snapshotId: snapshot.id, expires: now() + ttlMs });
-        return { ...(options.businessRequirement!==undefined?{businessRequirement:{text:options.businessRequirement,hash:hash(options.businessRequirement),bytes:Buffer.byteLength(options.businessRequirement)}}:{}), previewId, plan, snapshotId: snapshot.id, repositoryRoot: snapshot.root, vcs: snapshot.vcs, ...(snapshot.history ? { history: snapshot.history } : {}), model: current.route, modelSendingEnabled: allowModelSending, files: snapshot.files.map(f => ({ path: f.path, eligibility: f.eligibility, reason: f.reason, ...(f.blockCode ? {blockCode:f.blockCode} : {}), ...(f.copySource ? {copySource:f.copySource,copyNotice:f.copyNotice} : {}) })), contextPaths: snapshot.context.map(c => c.path), ...(options.oldContextPaths !== undefined ? {oldContextPaths:options.oldContextPaths,oldContextSources:snapshot.context.filter(c=>c.oldOnly).map(c=>({path:c.path,side:'context-old',revision:c.oldRevision,...(c.oldSvnSource?{svnSource:c.oldSvnSource}:{blobOid:c.oldBlobOid}),hash:c.oldHash}))} : {}), ...(snapshot.callerDiscovery ? {callerDiscovery:snapshot.callerDiscovery} : {}), ...(snapshot.autoContext ? { autoContext: snapshot.autoContext } : {}), rules: (snapshot.rules ?? []).map(({ path, hash }) => ({ path, hash })), notice: (options.oldContextPaths !== undefined ? 'oldContextPaths仅为baseline旧侧正文，无目标侧替代；选中变更复用原old身份，旧侧不能证明新侧行为。' : '') + (snapshot.callerDiscovery ? 'callerScopePaths已授权预览读取限定目录内tracked候选正文，包括不匹配文件；非匹配正文不发送模型，匹配捕获上下文会发送。仅字面引用导航，不是函数调用或完整调用覆盖。' : '') + (enableRiskPlanning ? '执行按plan阈值决定风险假设规划，小变更可跳过独立规划但仍主审并复核；计划不是证据，所有阶段共享原预算。' : '') + '执行会向上述模型提供方发送可审查文件两侧内容、预览列出的显式/自动上下文、所选项目规则全文及预览业务需求文本。模型可在该快照范围内多轮只读检索，不读取范围外文件；候选生成后会进行证据与反证复核，两阶段各最多3轮检索，共享每文件120秒和总模型调用100次预算；复核不能证明缺陷成立。plan.reviewRounds为独立审查工作量，非模型reasoning effort；后续轮不带首轮风险计划，所有轮共享原超时与预算。plan仅预检初始输入，ready不代表已审查；minimumCalls不含后续检索/复核/动态业务综合；多文件可先进行业务分组，分组失败保留原组并记录限制，动态综合数执行前未知，实际预算可能不足。请先向用户展示范围，获得确认后执行。' };
+        return { ...(options.businessRequirement!==undefined?{businessRequirement:{text:options.businessRequirement,hash:hash(options.businessRequirement),bytes:Buffer.byteLength(options.businessRequirement)}}:{}), previewId, plan, snapshotId: snapshot.id, repositoryRoot: snapshot.root, vcs: snapshot.vcs, ...(snapshot.history ? { history: snapshot.history } : {}), model: current.route, modelSendingEnabled: allowModelSending, files: snapshot.files.map(f => ({ path: f.path, eligibility: f.eligibility, reason: f.reason, ...(f.rawStatus==='replaced'&&snapshot.history?.vcs==='svn'?{oldKind:f.oldKind,newKind:f.newKind,nodeNotice:f.nodeNotice}:{}), ...(f.blockCode ? {blockCode:f.blockCode} : {}), ...(f.copySource ? {copySource:f.copySource,copyNotice:f.copyNotice} : {}) })), contextPaths: snapshot.context.map(c => c.path), ...(options.oldContextPaths !== undefined ? {oldContextPaths:options.oldContextPaths,oldContextSources:snapshot.context.filter(c=>c.oldOnly).map(c=>({path:c.path,side:'context-old',revision:c.oldRevision,...(c.oldSvnSource?{svnSource:c.oldSvnSource}:{blobOid:c.oldBlobOid}),hash:c.oldHash}))} : {}), ...(snapshot.callerDiscovery ? {callerDiscovery:snapshot.callerDiscovery} : {}), ...(snapshot.autoContext ? { autoContext: snapshot.autoContext } : {}), rules: (snapshot.rules ?? []).map(({ path, hash }) => ({ path, hash })), notice: (options.oldContextPaths !== undefined ? 'oldContextPaths仅为baseline旧侧正文，无目标侧替代；选中变更复用原old身份，旧侧不能证明新侧行为。' : '') + (snapshot.callerDiscovery ? 'callerScopePaths已授权预览读取限定目录内tracked候选正文，包括不匹配文件；非匹配正文不发送模型，匹配捕获上下文会发送。仅字面引用导航，不是函数调用或完整调用覆盖。' : '') + (enableRiskPlanning ? '执行按plan阈值决定风险假设规划，小变更可跳过独立规划但仍主审并复核；计划不是证据，所有阶段共享原预算。' : '') + '执行会向上述模型提供方发送可审查文件两侧内容、预览列出的显式/自动上下文、所选项目规则全文及预览业务需求文本。模型可在该快照范围内多轮只读检索，不读取范围外文件；候选生成后会进行证据与反证复核，两阶段各最多3轮检索，共享每文件120秒和总模型调用100次预算；复核不能证明缺陷成立。plan.reviewRounds为独立审查工作量，非模型reasoning effort；后续轮不带首轮风险计划，所有轮共享原超时与预算。plan仅预检初始输入，ready不代表已审查；minimumCalls不含后续检索/复核/动态业务综合；多文件可先进行业务分组，分组失败保留原组并记录限制，动态综合数执行前未知，实际预算可能不足。请先向用户展示范围，获得确认后执行。' };
       } finally { busy = false; }
     },
     async execute(args, exec) {

package/src/svn-history.mjs

@@ -4,6 +4,7 @@ import {xml} from './svn.mjs';
 import {hash,decode,relativePath} from './content.mjs';
 import {isSecretPath,assertNonSecretPath} from './secret-path.mjs';
 import {captureProjectRules} from './project-rules.mjs';
+import {mergeinfoNavigation} from './svn-mergeinfo.mjs';
 
 const revision = value => {
   if (typeof value !== 'string' || !/^(0|[1-9][0-9]*)$/.test(value) || !Number.isSafeInteger(Number(value))) throw new Error('SVN revision must be a fixed nonnegative decimal string');
@@ -33,8 +34,9 @@ export function svnHistoryDestination(value, allowNetwork) {
 export function mergeSvnHistoryRecord(previous, item) {
   if(!['added','deleted','modified','none'].includes(item?.['@_item'])||!['file','dir'].includes(item?.['@_kind']))throw new Error('Ambiguous or unsupported SVN history summary');
   if(!previous)return item;
-  if(previous['@_kind']!==item['@_kind']||!['added','deleted'].includes(previous['@_item'])||!['added','deleted'].includes(item['@_item'])||previous['@_item']===item['@_item'])throw new Error('Ambiguous or unsupported SVN history summary');
-  return {...item,'@_item':'replaced'};
+  if(!['added','deleted'].includes(previous['@_item'])||!['added','deleted'].includes(item['@_item'])||previous['@_item']===item['@_item'])throw new Error('Ambiguous or unsupported SVN history summary');
+  const old=previous['@_item']==='deleted'?previous:item,target=previous['@_item']==='added'?previous:item;
+  return {...target,'@_item':'replaced',oldKind:old['@_kind'],newKind:target['@_kind']};
 }
 
 // Fixed URL objects only. No checkout, update, merge, working body or lazy HEAD read.
@@ -101,23 +103,24 @@ export async function captureSvnHistory(cwd,options={}) {
     const node=await identity(name,rev),props=await properties(name,rev);
     if(Object.hasOwn(props,'svn:special'))throw new Error('Historical SVN special node excluded');
     const content=node['@_kind']==='dir'?decode(Buffer.alloc(0)):decode(await run(['cat','--ignore-keywords','-r',rev,'--',at(name,rev)],true));
-    return {content,props,kind:node['@_kind'],source:{repositoryUuid:local.repository.uuid,url:at(name,rev).slice(0,-rev.length-1),pegRevision:rev,operativeRevision:rev,hash:content.hash,textHash:hash(content.text)}};
+    return {content,props,kind:node['@_kind'],source:{repositoryUuid:local.repository.uuid,url:at(name,rev).slice(0,-rev.length-1),pegRevision:rev,operativeRevision:rev,kind:node['@_kind'],hash:content.hash,textHash:hash(content.text)}};
   };
   const files=[];
   for(const [name,record]of [...records].sort(([a],[b])=>a<b?-1:a>b?1:0)){
     signal.throwIfAborted();
-    const status=record['@_item'],item={id:hash(name),path:name,kind:record['@_kind'],rawStatus:status,eligibility:'reviewable',properties:[],rightExists:status!=='deleted'};
+    const status=record['@_item'],item={id:hash(name),path:name,kind:record['@_kind'],oldKind:status==='added'?null:record.oldKind??record['@_kind'],newKind:status==='deleted'?null:record.newKind??record['@_kind'],rawStatus:status,eligibility:'reviewable',properties:[],rightExists:status!=='deleted'};
     files.push(item);
     if(isSecretPath(name)){item.eligibility='excluded';item.reason='Credential path excluded';continue;}
     if(selectedPaths&&!selectedPaths.includes(name)){item.eligibility='excluded';item.reason='Not explicitly selected';continue;}
     try{
-      const readSide=async(rev,exists)=>{
+      const readSide=async(rev,exists,kind)=>{
         if(!exists)return {content:decode(Buffer.alloc(0)),props:{}};
         const result=await readSource(name,rev);
-        if(result.kind!==item.kind)throw new Error('Historical node kind differs');
+        if(result.kind!==kind)throw new Error('Historical node kind differs');
         return result;
       };
-      const left=await readSide(range.base,status!=='added'),right=await readSide(range.target,status!=='deleted');
+      const left=await readSide(range.base,status!=='added',item.oldKind),right=await readSide(range.target,status!=='deleted',item.newKind);
+       if(status==='replaced')item.nodeNotice='Fixed historical replacement; each side has its own node kind. Directory content is not file text; descendant changes require separate coverage.';
       item.left=left.content;item.right=right.content;
       item.svnSources={...(left.source?{old:left.source}:{}),...(right.source?{new:right.source}:{})};
       for(const key of [...new Set([...Object.keys(left.props),...Object.keys(right.props)])].sort())if(left.props[key]!==right.props[key])item.properties.push({name:key,old:left.props[key]??null,new:right.props[key]??null});
@@ -126,9 +129,10 @@ export async function captureSvnHistory(cwd,options={}) {
     }catch(error){signal.throwIfAborted();if(error.code==='SVN_HISTORY_BUDGET')throw error;item.eligibility='blocked';item.reason=error.message;delete item.left;delete item.right;}
     if(Buffer.byteLength(JSON.stringify(files))>maxSnapshotBytes)throw new Error('SVN historical snapshot limit exceeded');
   }
-  for(const item of files.filter(f=>f.kind==='dir'&&['added','deleted','replaced'].includes(f.rawStatus)&&f.eligibility==='reviewable')){
+  for(const item of files.filter(f=>(f.oldKind==='dir'||f.newKind==='dir')&&['added','deleted','replaced'].includes(f.rawStatus)&&f.eligibility==='reviewable').sort((a,b)=>b.path.length-a.path.length)){
     if(files.some(child=>child.path.startsWith(item.path==='.'?'':item.path+'/')&&child!==item&&child.eligibility!=='reviewable')){item.eligibility='blocked';item.reason='Historical directory descendant coverage incomplete';delete item.left;delete item.right;}
   }
+  const mergeSources=files.filter(file=>file.eligibility==='reviewable').flatMap(file=>file.properties.filter(prop=>prop.name==='svn:mergeinfo').map(prop=>({path:file.path,old:mergeinfoNavigation(prop.old),new:mergeinfoNavigation(prop.new)})));
   const context=[];
   const targetContent=async(name)=>{
     const changed=files.find(file=>file.path===name);
@@ -141,7 +145,7 @@ export async function captureSvnHistory(cwd,options={}) {
   for(const name of [...contextPaths].sort()){
     const target=await targetContent(name),record=records.get(name),changed=files.find(file=>file.path===name);
     const item={path:name,...target.content,revision:range.target,svnSource:target.source};
-    if(changed){if(record['@_item']!=='added'){item.oldText=changed.left.text;item.oldRevision=range.base;item.oldSvnSource=changed.svnSources.old;}}
+    if(changed){if(changed.oldKind==='file'){item.oldText=changed.left.text;item.oldRevision=range.base;item.oldSvnSource=changed.svnSources.old;}}
     else{
       // No change record means both fixed sides are present and equal. Read and verify
       // rather than inferring baseline content from target or from the working tree.
@@ -153,7 +157,7 @@ export async function captureSvnHistory(cwd,options={}) {
   for(const name of [...oldContextPaths].sort()){
     const changed=files.find(file=>file.path===name);
     if(changed){
-      if(changed.eligibility!=='reviewable'||changed.kind!=='file'||!changed.svnSources?.old)throw new Error('Old SVN context conflicts with excluded blocked or absent baseline change');
+      if(changed.eligibility!=='reviewable'||changed.oldKind!=='file'||!changed.svnSources?.old)throw new Error('Old SVN context conflicts with excluded blocked or absent baseline change');
       // The original changed-file old identity already authorizes this side.
       continue;
     }
@@ -167,7 +171,7 @@ export async function captureSvnHistory(cwd,options={}) {
   const after=await run(['diff','--summarize','--xml','--notice-ancestry','-r',range.base+':'+range.target,'--',at('.',range.target)]);
   if(!isDeepSummary(summary,after))throw new Error('SVN historical summary changed during capture');
   await identity('.',range.base);await identity('.',range.target);
-  const snapshot={schemaVersion:1,vcs:'svn',root,repositoryUuid:local.repository.uuid,context,...(rules.length?{rules}:{}),history:{...range,vcs:'svn',url,repositoryUuid:local.repository.uuid,pegRevision:range.target,networkAccess,semantics:'fixed revision tree endpoints; no merge attribution or working text'},files};
+  const snapshot={schemaVersion:1,vcs:'svn',root,repositoryUuid:local.repository.uuid,context,...(rules.length?{rules}:{}),history:{...range,vcs:'svn',url,repositoryUuid:local.repository.uuid,pegRevision:range.target,networkAccess,...(mergeSources.length?{mergeSources}:{}),semantics:'fixed revision tree endpoints; no merge attribution or working text'},files};
   const serialized=JSON.stringify(snapshot);if(Buffer.byteLength(serialized)>maxSnapshotBytes)throw new Error('SVN historical snapshot limit exceeded');
   return {...snapshot,id:hash(serialized)};
 }

package/src/svn-mergeinfo.mjs

@@ -0,0 +1,28 @@
+import {hash} from './content.mjs';
+
+// Navigation over an already approved property. Never expands revisions or reads URLs.
+export function mergeinfoNavigation(text) {
+  if(text===null || text==='')return {status:'parsed',sources:[],hash:hash(text??'')};
+  if(typeof text!=='string')return {status:'invalid',reason:'Mergeinfo property is not text',sources:[]};
+  if(Buffer.byteLength(text)>16*1024)return {status:'limited',reason:'Mergeinfo navigation byte limit exceeded',sources:[],hash:hash(text)};
+  const lines=text.split(/\r?\n/);if(lines.at(-1)==='')lines.pop();
+  if(lines.length>100)return {status:'limited',reason:'Mergeinfo navigation source limit exceeded',sources:[],hash:hash(text)};
+  const sources=[],seen=new Set();let rangeCount=0;
+  for(const line of lines){
+    const delimiter=line.lastIndexOf(':');
+    const sourcePath=line.slice(0,delimiter),list=line.slice(delimiter+1);
+    if(delimiter<1||!sourcePath.startsWith('/')||/[\x00-\x1f\\]/.test(sourcePath)||sourcePath.length>1024||(sourcePath!=='/'&&sourcePath.slice(1).split('/').some(part=>!part||part==='.'||part==='..'))||seen.has(sourcePath))return {status:'invalid',reason:'Mergeinfo navigation path or duplicate source invalid',sources:[],hash:hash(text)};
+    seen.add(sourcePath);
+    const ranges=[];
+    for(const token of list.split(',')){
+      if(++rangeCount>500)return {status:'limited',reason:'Mergeinfo navigation range limit exceeded',sources:[],hash:hash(text)};
+      const match=/^([1-9][0-9]*)(?:-([1-9][0-9]*))?(\*)?$/.exec(token);
+      if(!match)return {status:'invalid',reason:'Mergeinfo navigation revision range invalid',sources:[],hash:hash(text)};
+      const start=Number(match[1]),end=Number(match[2]??match[1]);
+      if(!Number.isSafeInteger(start)||!Number.isSafeInteger(end)||start>end)return {status:'invalid',reason:'Mergeinfo navigation revision range invalid',sources:[],hash:hash(text)};
+      ranges.push({start:String(start),end:String(end),inheritable:!match[3]});
+    }
+    sources.push({sourcePath,ranges});
+  }
+  return {status:'parsed',sources,hash:hash(text),notice:'Explicit mergeinfo navigation only; not effective inherited mergeinfo, change attribution, permission to read a source or evidence that listed revisions were reviewed.'};
+}