@kirkchinese/dsh-citeciter 0.4.1 → 0.4.2

package/README.md

@@ -25,17 +25,17 @@ Investigate any line in a DSH response—without stopping the Agent or changing
 4. Continue asking questions there, or reopen an earlier Topic from CiteCiter's Topic rail.
 5. Change the Topic model, reasoning effort, title, archive state, or panel width without changing the source Session.
 
-## Install v0.4.1
+## Install v0.4.2
 
-CiteCiter 0.4.1 requires Node.js `^22.19.0 || >=24.0.0` and DSH `>=0.1.1-rc.1 <0.1.1-rc.3`.
+CiteCiter 0.4.2 requires Node.js `^22.19.0 || >=24.0.0` and DSH `>=0.1.1-rc.1 <0.1.1-rc.3`.
 
 For DSH Web:
 
 ```sh
-dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.4.1
+dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.4.2
 ```
 
-Restart DSH Web and refresh the page. Packaged Desktop adaptation is deferred; CiteCiter 0.4.1 does not provide a supported Desktop installation path.
+Restart DSH Web and refresh the page. Packaged Desktop adaptation is deferred; CiteCiter 0.4.2 does not provide a supported Desktop installation path.
 
 ## Context modes
 
@@ -47,7 +47,7 @@ Exact Fork is an advanced mode for a source turn that has already ended. `exact-
 
 | Host | CiteCiter version | Status |
 |---|---|---|
-| DSH Web `0.1.1-rc.2` | `0.4.1` | Linux package, CI, upgrade, and assembled keyless browser checks passed; real-provider acceptance was not run |
+| DSH Web `0.1.1-rc.2` | `0.4.2` | Linux package, regression tests, and real-browser selection checks passed; real-provider acceptance was not run |
 | [DSH Desktop 2.0.2](https://github.com/anywhere-labs/deepseek-harness-desktop) with bundled DSH `0.1.1-rc.2` | Future target | Adaptation and native acceptance are deferred; no packaged-Desktop compatibility claim |
 | [dataelement DSH Desktop](https://github.com/dataelement/dsh-desktop) development shell with DSH `0.1.1-rc.1` | `0.4.0` only | Historical conditional Linux source-shell evidence |
 | DSH Web `0.1.0-rc.7` | `0.3.2` | Previous stable line |
@@ -57,14 +57,14 @@ The demo uses a deterministic fixture to show the workflow; it is not real-provi
 
 ## Upgrade from an earlier version
 
-To install or upgrade v0.4.1 in Web:
+To install or upgrade v0.4.2 in Web:
 
 ```sh
-dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.4.1
+dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.4.2
 dsh plugin --profile web list --depth 0
 ```
 
-Packaged Desktop adaptation is deferred and is not part of the supported 0.4.1 upgrade path.
+Packaged Desktop adaptation is deferred and is not part of the supported 0.4.2 upgrade path.
 
 Upgrading from v0.3 does not migrate or rewrite existing Topics, settings, or source Sessions. Users remaining on DSH `0.1.0-rc.7` should keep CiteCiter 0.3.2.
 
@@ -77,7 +77,7 @@ Upgrading from v0.3 does not migrate or rewrite existing Topics, settings, or so
 - Read Frog translated selections are a best-effort compatibility path on DSH rc.1/rc.2 and activate only when its complete private marker set is present; ordinary DSH selection does not depend on Read Frog.
 - DSH does not yet expose a public additive right-dock contribution point. CiteCiter therefore uses a reversible private AppFrame grid adapter whenever the panel and conversation fit; it preserves the layout's details preference but temporarily hides that column while the investigation panel is open, and it must be retested for every supported DSH release.
 - Topics are Host-durable. When Desktop restarts on a different loopback port, CiteCiter falls back to the most recently updated Topic because browser local storage is origin-scoped; configure a fixed Desktop port to restore the exact last-viewed Topic.
-- CiteCiter 0.4.1 makes no packaged-Desktop compatibility claim; native Windows and macOS adaptation continues separately.
+- CiteCiter 0.4.2 makes no packaged-Desktop compatibility claim; native Windows and macOS adaptation continues separately.
 - There is currently no TUI interaction adapter.
 - DSH is prerelease software; later DSH API versions may require a CiteCiter update.
 

package/README.zh.md

@@ -25,17 +25,17 @@
 4. 在 Topic 中继续追问，或从 CiteCiter 的 Topic 栏恢复旧讨论。
 5. 独立调整模型、思考强度、标题、归档状态和面板宽度，不改变来源 Session。
 
-## 安装 v0.4.1
+## 安装 v0.4.2
 
-CiteCiter 0.4.1 需要 Node.js `^22.19.0 || >=24.0.0` 与 DSH `>=0.1.1-rc.1 <0.1.1-rc.3`。
+CiteCiter 0.4.2 需要 Node.js `^22.19.0 || >=24.0.0` 与 DSH `>=0.1.1-rc.1 <0.1.1-rc.3`。
 
 DSH Web 使用：
 
 ```sh
-dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.4.1
+dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.4.2
 ```
 
-安装后重启 DSH Web 并刷新页面。正式 Desktop 适配已经暂缓；CiteCiter 0.4.1 不提供受支持的 Desktop 安装路径。
+安装后重启 DSH Web 并刷新页面。正式 Desktop 适配已经暂缓；CiteCiter 0.4.2 不提供受支持的 Desktop 安装路径。
 
 ## 上下文模式
 
@@ -47,7 +47,7 @@ Exact Fork 是面向已结束来源轮次的高级模式。`exact-when-available
 
 | 宿主 | CiteCiter 版本 | 状态 |
 |---|---|---|
-| DSH Web `0.1.1-rc.2` | `0.4.1` | Linux 包、CI、升级与组装 keyless 浏览器检查通过；真实提供方验收未运行 |
+| DSH Web `0.1.1-rc.2` | `0.4.2` | Linux 包、回归测试与真实浏览器选区检查通过；真实提供方验收未运行 |
 | [DSH Desktop 2.0.2](https://github.com/anywhere-labs/deepseek-harness-desktop)（内置 DSH `0.1.1-rc.2`） | 后续目标 | 适配与原生验收暂缓；不声明正式 Desktop 安装包兼容性 |
 | [dataelement DSH Desktop](https://github.com/dataelement/dsh-desktop) 源码开发壳（内置 DSH `0.1.1-rc.1`） | 仅 `0.4.0` | 历史上的有条件 Linux 源码壳证据 |
 | DSH Web `0.1.0-rc.7` | `0.3.2` | 旧版稳定线 |
@@ -57,14 +57,14 @@ Exact Fork 是面向已结束来源轮次的高级模式。`exact-when-available
 
 ## 从旧版本升级
 
-在 Web 安装或升级 v0.4.1：
+在 Web 安装或升级 v0.4.2：
 
 ```sh
-dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.4.1
+dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.4.2
 dsh plugin --profile web list --depth 0
 ```
 
-正式 Desktop 适配已经暂缓，不属于 0.4.1 的受支持升级路径。
+正式 Desktop 适配已经暂缓，不属于 0.4.2 的受支持升级路径。
 
 从 v0.3 升级不会迁移或重写现有 Topic、设置或来源 Session。仍在 DSH `0.1.0-rc.7` 上运行的用户应继续使用 CiteCiter 0.3.2。
 
@@ -77,7 +77,7 @@ dsh plugin --profile web list --depth 0
 - Read Frog 翻译选区是 DSH rc.1/rc.2 上的 best-effort 兼容路径，仅在其完整私有标记同时存在时启用；普通 DSH 选区不依赖 Read Frog。
 - DSH 尚未提供公开的增量右侧 dock 布局扩展点。CiteCiter 因此在面板与主对话能够同时容纳时使用可逆的私有 AppFrame grid 适配器；它保留布局的 details 偏好，但在调查面板打开期间临时隐藏该列，并且每个受支持的 DSH 版本都必须重新验证。
 - Topic 由 Host 持久保存。Desktop 重启到不同 loopback 端口时，浏览器 localStorage 会因 origin 改变而失去精确指针，CiteCiter 将回退到最近更新的 Topic；需要精确恢复“上次查看”时应配置固定 Desktop 端口。
-- CiteCiter 0.4.1 不声明正式 Desktop 安装包兼容性；Windows 与 macOS 原生适配将另行继续。
+- CiteCiter 0.4.2 不声明正式 Desktop 安装包兼容性；Windows 与 macOS 原生适配将另行继续。
 - 当前没有 TUI 交互适配器。
 - DSH 仍处于预发布阶段，后续 API 版本可能要求同步更新 CiteCiter。
 

package/lib/client.js

@@ -5449,13 +5449,13 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			return null;
 		}
 		/**
-		* Determine whether a node is a Read Frog translated projection rather than source text.
+		* Determine whether a node is projected reasoning or translation rather than committed answer text.
 		*
 		* @param node - rendered node to classify.
-		* @returns whether Read Frog marks the node as translated content.
+		* @returns whether the node must stay out of committed answer text.
 		*/
-		function isReadFrogTranslatedContent(node) {
-			return node.nodeType === Node.ELEMENT_NODE && node.matches(READ_FROG_TRANSLATION_SELECTOR);
+		function isNonAnswerContent(node) {
+			return node.nodeType === Node.ELEMENT_NODE && node.matches(`${DSH_REASONING_SELECTOR}, ${READ_FROG_TRANSLATION_SELECTOR}`);
 		}
 		/**
 		* Resolve a selection wholly inside one Read Frog translation to its source paragraph.
@@ -6939,7 +6939,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			let targetStart;
 			let targetEnd;
 			const visit = (node) => {
-				if (isReadFrogTranslatedContent(node)) return;
+				if (isNonAnswerContent(node)) return;
 				if (node === target) targetStart = text.length;
 				if (node.nodeType === Node.TEXT_NODE) text += node.textContent ?? "";
 				else for (const child of node.childNodes) visit(child);
@@ -6956,7 +6956,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			let text = "";
 			let found = false;
 			const visit = (node) => {
-				if (found || isReadFrogTranslatedContent(node)) return;
+				if (found || isNonAnswerContent(node)) return;
 				if (node === boundary) {
 					if (node.nodeType === Node.TEXT_NODE) text += (node.textContent ?? "").slice(0, offset);
 					else for (let index = 0; index < offset; index++) {

package/lib/index.js

@@ -14369,7 +14369,8 @@ function compactMapped(units) {
 		});
 		else compact[compact.length - 1] = {
 			...previous,
-			endOffset: unit.endOffset
+			endOffset: unit.endOffset,
+			...previous.synthetic === true || unit.synthetic === true ? { synthetic: true } : {}
 		};
 	}
 	return compact;
@@ -14384,7 +14385,8 @@ function joinMapped(parts, separator) {
 			for (const text of separator) joined.push({
 				text,
 				startOffset: before,
-				endOffset: after
+				endOffset: after,
+				synthetic: true
 			});
 		}
 		joined.push(...part);
@@ -14442,6 +14444,47 @@ function candidatesFromProjection(markdown, projection, needle) {
 	}
 	return candidates;
 }
+function candidatesIgnoringSyntheticWhitespace(markdown, projection, needle) {
+	const rendered = visibleText(projection);
+	const visibleOffsets = [0];
+	for (const unit of projection) visibleOffsets.push(visibleOffsets.at(-1) + unit.text.length);
+	const candidates = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (let start = 0; start < projection.length; start++) {
+		const first = projection[start];
+		if (first.synthetic === true) continue;
+		let unitIndex = start;
+		let needleOffset = 0;
+		let lastIndex = -1;
+		while (needleOffset < needle.length && unitIndex < projection.length) {
+			const unit = projection[unitIndex];
+			if (unit.synthetic === true) {
+				while (projection[unitIndex]?.synthetic === true) unitIndex++;
+				needleOffset += /^\s+/u.exec(needle.slice(needleOffset))?.[0].length ?? 0;
+				continue;
+			}
+			if (!needle.startsWith(unit.text, needleOffset)) break;
+			needleOffset += unit.text.length;
+			lastIndex = unitIndex;
+			unitIndex++;
+		}
+		if (needleOffset !== needle.length || lastIndex < start) continue;
+		const last = projection[lastIndex];
+		const key = `${first.startOffset}:${last.endOffset}`;
+		if (seen.has(key)) continue;
+		seen.add(key);
+		const visibleStart = visibleOffsets[start];
+		const visibleEnd = visibleOffsets[lastIndex + 1];
+		candidates.push({
+			startOffset: first.startOffset,
+			endOffset: last.endOffset,
+			sourceText: markdown.slice(first.startOffset, last.endOffset),
+			displayPrefix: rendered.slice(Math.max(0, visibleStart - 240), visibleStart),
+			displaySuffix: rendered.slice(visibleEnd, visibleEnd + 240)
+		});
+	}
+	return candidates;
+}
 /**
 * Locate every GFM source range that renders as one browser-visible selection.
 *
@@ -14458,7 +14501,11 @@ function markdownSourceCandidates(markdown, displayText) {
 	if (needle === "") return [];
 	const exact = candidatesFromProjection(markdown, projection, needle);
 	if (exact.length > 0) return exact;
-	return candidatesFromProjection(markdown, compactMapped(projection), needle.replace(/\s+/gu, " "));
+	const compactProjection = compactMapped(projection);
+	const compactNeedle = needle.replace(/\s+/gu, " ");
+	const compact = candidatesFromProjection(markdown, compactProjection, compactNeedle);
+	if (compact.length > 0) return compact;
+	return candidatesIgnoringSyntheticWhitespace(markdown, compactProjection, compactNeedle);
 }
 //#endregion
 //#region lib/types/citation-mapping.js

package/lib/types/client/conversation-dom.d.ts

@@ -56,12 +56,12 @@ export declare function dshRangeTouchesExcludedContent(range: Range, flow: HTMLE
  */
 export declare function findDshAssistantAnchor(anchorKey: string): HTMLElement | null;
 /**
- * Determine whether a node is a Read Frog translated projection rather than source text.
+ * Determine whether a node is projected reasoning or translation rather than committed answer text.
  *
  * @param node - rendered node to classify.
- * @returns whether Read Frog marks the node as translated content.
+ * @returns whether the node must stay out of committed answer text.
  */
-export declare function isReadFrogTranslatedContent(node: Node): boolean;
+export declare function isNonAnswerContent(node: Node): boolean;
 /**
  * Resolve a selection wholly inside one Read Frog translation to its source paragraph.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kirkchinese/dsh-citeciter",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Verifiable, source-bound, read-only investigations for DeepSeek Harness responses",
   "keywords": [
     "deepseek-harness",
@@ -80,6 +80,20 @@
     "cordis.patch.yml",
     "README.zh.md"
   ],
+  "scripts": {
+    "build": "npm run build:lib && npm run build:bundle",
+    "prebuild:lib": "node scripts/clean-types.mjs",
+    "build:lib": "tsc -p tsconfig.json",
+    "prebuild:bundle": "node scripts/clean-bundle.mjs",
+    "build:bundle": "tsdown --env.DSH_BUILD_FACE client",
+    "postbuild:bundle": "node scripts/normalize-bundle.mjs",
+    "prepack": "npm run build",
+    "dev": "npm run build && node dev/watch.mjs",
+    "smoke:seed": "node dev/seed-smoke-session.mjs",
+    "smoke:hmr": "node dev/hmr-smoke.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build:lib && node --test tests/*.test.mjs"
+  },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-agent": ">=0.1.1-rc.1 <0.1.1-rc.3",
@@ -159,18 +173,5 @@
     "tsdown": "^0.22.2",
     "typescript": "^6.0.3",
     "zod": "^4.4.3"
-  },
-  "scripts": {
-    "build": "npm run build:lib && npm run build:bundle",
-    "prebuild:lib": "node scripts/clean-types.mjs",
-    "build:lib": "tsc -p tsconfig.json",
-    "prebuild:bundle": "node scripts/clean-bundle.mjs",
-    "build:bundle": "tsdown --env.DSH_BUILD_FACE client",
-    "postbuild:bundle": "node scripts/normalize-bundle.mjs",
-    "dev": "npm run build && node dev/watch.mjs",
-    "smoke:seed": "node dev/seed-smoke-session.mjs",
-    "smoke:hmr": "node dev/hmr-smoke.mjs",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "npm run build:lib && node --test tests/*.test.mjs"
   }
-}
+}