dsh-code-index 0.11.0 → 0.11.2

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to dsh-code-index are documented here.
 
+## 0.11.2 — DSH compatibility range
+
+- Allow DSH versions from `0.2.0-rc.2` onward, including prereleases, without claiming future versions have been verified.
+
+## 0.11.1 — DSH rc.3 compatibility
+
+- Add the verified exact `@deepseek-ai/dsh-tools@0.2.1-rc.3` host group; retain `0.2.0-rc.2` and `0.2.1-rc.2` support without exemptions or an open-ended range.
+- Verify all eight tools and Impact X-Ray in a real DSH rc.3 Web/Host environment. Keep server/client behavior, runtime dependencies and the development API baseline unchanged.
+- Make rc.3 the default installed-package smoke target and include `code_health` in native runtime dispatch coverage. See `RELEASE_EVIDENCE_v0.11.1.md` for methods and limits.
+
 ## 0.11.0 — Impact X-Ray
 
 - Present the existing `code_change_context` analysis in an interactive bilingual Desktop view with source-backed nodes and relationships; keep default text output and `code_context` Context Packs compatible.

package/README.md

@@ -5,36 +5,35 @@
 
 English | [中文](README.zh.md)
 
-**v0.11.0 — Impact X-Ray.** See the potential blast radius before AI edits code, then inspect each relationship against real source evidence. The 30-second recording shows the real `0.11.0-dev.0` MVP; the dev.1 first-screen change-center and uncertainty improvements are shown in separate [real Desktop screenshots](IMPACT_XRAY_RC.md#first-screen-and-visual-evidence). The release preserves existing `code_change_context` analysis and `code_context` packs.
+## Impact X-Ray
 
-**Supported Desktop versions**
+**See the blast radius before your AI edits the code.**
 
-The compatibility support introduced in [v0.10.1](https://github.com/lemonxiny55/dsh-code-index/releases/tag/v0.10.1) remains: only DSH/dsh-tools `0.2.0-rc.2` and `0.2.1-rc.2` host groups are supported. Keep each host's first-party packages on the same version.
+A local [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness) plugin that turns a code diff into an inspectable map of potentially affected callers, imports and test leads. Click a relationship to check its source file, line and evidence.
 
-## Impact X-Ray
+**For DSH users working with existing code:** inspect likely ripple effects before asking an AI agent to edit. Install the stable **v0.11.1** in a compatible DSH profile:
 
-**See the blast radius before your AI edits the code.**
+```sh
+dsh plugin --profile desktop add dsh-code-index@0.11.1
+```
 
-- **Before AI edits your code:** start from a real working-tree Git diff, a supplied diff, or an explicitly labeled file/symbol selection.
-- **See what may break:** inspect changed declarations, direct callers, indirect paths, module imports and candidate tests.
-- **Inspect the evidence:** select a node or arrow to see its reason, provenance, file, line and actual source snapshot. Expand the view for a graph and evidence side by side; open current files in Desktop's native preview.
-- **Know what remains uncertain:** dotted amber `name-only` candidates, import scope, unmapped ranges, missing source and truncation stay visible. A test lead does not prove coverage or failure.
+Restart Desktop after installation. v0.11.1 declares DSH `0.2.0-rc.2`, `0.2.1-rc.2` and `0.2.1-rc.3` host groups; for Desktop rc.3, the compatibility warning was reported gone, but full Electron Desktop feature and Agent acceptance is not claimed. [Install details](#install) · [v0.11.1 verification and limits](RELEASE_EVIDENCE_v0.11.1.md).
 
-This is an interactive presentation of the existing `code_change_context` analysis, with source from the existing reader. It does not introduce a new impact-analysis engine.
+**Watch the 30-second real Desktop demo:** a change to `normalize()` → inspect callers and a test lead → click a relationship to see the actual source location.
 
-![Impact X-Ray in actual DSH Desktop](assets/impact-xray-mvp.gif)
+![Impact X-Ray in actual DSH Desktop: changed normalize function, callers, tests and clickable source evidence](assets/impact-xray-mvp.gif)
 
-[Actual recording and reproduction notes](assets/impact-xray-mvp-demo.md) · [Release evidence and remaining limits](RELEASE_EVIDENCE_v0.11.0.md) · [Bilingual release notes](RELEASE_NOTES_v0.11.0.md)
+[Watch MP4](assets/impact-xray-mvp.mp4) · [Full-size GIF](assets/impact-xray-mvp.gif) · [Demo notes and reproduction](assets/impact-xray-mvp-demo.md) · [Install v0.11.1 from npm](https://www.npmjs.com/package/dsh-code-index/v/0.11.1) · [Project](https://github.com/lemonxiny55/dsh-code-index)
 
-The recording shows the real `dev.0` MVP; its first 10 seconds show the changed function, caller/test lanes and source-backed exact relationship. The `dev.1` first-screen improvements are documented separately with actual Desktop screenshots; the video has not been represented as a recording of those later header changes.
+The recording is an actual DSH Desktop interaction with the `0.11.0-dev.0` MVP in Desktop 0.2.1-rc.2. It shows existing analysis and source evidence; it is not a model-driven Agent latency or success claim. See [recording provenance](assets/impact-xray-mvp-demo.md).
 
-Install v0.11.0 into an existing supported Desktop profile with Desktop's bundled CLI:
+- Start from a Git diff or an explicitly selected file/symbol; inspect callers, import dependents, paths and candidate tests.
+- Click a relationship to inspect its provenance and available source snapshot at a file and line.
+- Treat candidates as leads: `name-only` matches can be uncertain, and a test lead does not prove coverage or failure.
 
-```sh
-dsh plugin --profile desktop add dsh-code-index@0.11.0
-```
+Impact X-Ray is an interactive view of the existing `code_change_context` analysis and source reader; it does not add an impact-analysis engine. Relationships are static evidence, not guaranteed runtime impact.
 
-Restart Desktop after installation. For local development, use Node 22/24 and pnpm 11. Desktop 0.2.1-rc.2 received full UI verification. Desktop 0.2.0-rc.2 passed installation and ToolRuntime checks; its full Impact X-Ray UI was not validated. The peer range remains unchanged. See the release evidence for actual methods, performance observations and limitations.
+**Verified:** full X-Ray UI in Desktop 0.2.1-rc.2; Web/Host rc.3 verified for all eight tools and X-Ray (no model-driven Agent run). Desktop 0.2.0-rc.2 passed installation and ToolRuntime checks, not full X-Ray UI. Keep each host's first-party packages on the same declared version. [v0.11.1 evidence and limits](RELEASE_EVIDENCE_v0.11.1.md).
 
 Ask the Agent to call `code_change_context` with:
 
@@ -88,16 +87,16 @@ This supports syntax and static code context, without full HarmonyOS SDK semanti
 
 ## Quick start
 
-Requires Node 22/24 and a matching DSH `0.2.0-rc.2` or `0.2.1-rc.2` host group. Install into an existing Desktop profile using its bundled `dsh` CLI:
+Requires Node 22/24. The v0.11.2 candidate allows DSH `>=0.2.0-rc.2`, including prereleases; matching first-party packages should be used. Later versions may attempt to load but have not all been verified. Install into an existing Desktop profile using its bundled `dsh` CLI:
 
 ```sh
-dsh plugin --profile desktop add dsh-code-index@0.11.0
+dsh plugin --profile desktop add dsh-code-index@0.11.1
 ```
 
 Restart Desktop after installation. For a matching Web profile:
 
 ```sh
-npx @deepseek-ai/dsh@0.2.1-rc.2 plugin --profile web add dsh-code-index@0.11.0
+npx @deepseek-ai/dsh@0.2.1-rc.2 plugin --profile web add dsh-code-index@0.11.1
 npx @deepseek-ai/dsh@0.2.1-rc.2 web
 ```
 
@@ -149,13 +148,13 @@ Plus an optional **auto-injected system prompt section** (`code-index:repo-map`,
 
 Requires `dsh` (any install path — npx, npm, or source) and Node ≥ 22.
 
-The compatibility range introduced in v0.10.1 remains `@deepseek-ai/dsh-tools: 0.2.0-rc.2 || 0.2.1-rc.2`. Use matching DSH/dsh-tools groups, rather than mixing first-party RC packages. The DSH plugin surface remains a preview API; other RCs and future releases are outside this compatibility declaration.
+The v0.11.2 candidate declares `@deepseek-ai/dsh-tools: >=0.2.0-rc.2`, with no upper bound. DSH includes prereleases when checking this range, so future DSH versions may attempt to load the plugin; this does not mean every version has been verified. Use matching DSH/dsh-tools groups. The plugin surface remains a preview API, and future releases may introduce incompatibilities.
 
-Desktop checks DSH peer requirements before activation. v0.10.0's exact `0.2.0-rc.2` pin is rejected by DSH `0.2.1-rc.2`; v0.10.1 enumerates the supported groups instead of requiring a version exemption or an unbounded range. Its development dependency stays on `0.2.0-rc.2` for backward API checks.
+Desktop checks DSH peer requirements before activation. v0.10.0's exact `0.2.0-rc.2` pin is rejected by DSH `0.2.1-rc.2`; v0.10.1 enumerated the then-supported groups; v0.11.2 removes that enumeration. Its development dependency stays on `0.2.0-rc.2` for backward API checks.
 
 ```sh
 # from npm (prebuilt)
-npx @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web add dsh-code-index@0.11.0
+npx @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web add dsh-code-index@0.11.1
 
 # or from a directory containing this checkout
 npx @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web add ./dsh-code-index
@@ -323,3 +322,4 @@ To make a report actionable, include the approximate repository size and languag
 
 MIT. Not affiliated with DeepSeek; built on the public `dsh` plugin surface.
 
+

package/README.zh.md

@@ -2,36 +2,37 @@
 
 [English](README.md) | 中文
 
-**v0.11.0 — Impact X-Ray。**在 AI 修改代码前查看潜在影响范围，并用真实源码证据核对每条关系。30 秒录屏来自真实运行的 `0.11.0-dev.0` MVP；dev.1 首屏对变更中心及不确定性的改进另有[真实 Desktop 截图](IMPACT_XRAY_RC.md#first-screen-and-visual-evidence)。本版本复用现有 `code_change_context` 分析，保留 `code_context` pack 行为。
+## Impact X-Ray
 
-**支持的 Desktop 版本**
+**See the blast radius before your AI edits the code.**
 
-[v0.10.1](https://github.com/lemonxiny55/dsh-code-index/releases/tag/v0.10.1) 引入的兼容范围保持不变：仅支持 DSH/dsh-tools `0.2.0-rc.2`、`0.2.1-rc.2` 两个精确宿主组，每组第一方包必须同版。
+**在 AI 修改代码前，看清潜在影响范围。**
 
-## Impact X-Ray
+这是 [DeepSeek Harness（DSH）](https://github.com/deepseek-ai/deepseek-harness) 的本地插件：把代码 diff 呈现为一张可检查的潜在影响图，列出可能受影响的调用者、导入和测试线索。点击关系即可核对源码文件、行号与证据。
 
-**See the blast radius before your AI edits the code.**
+**适合正在维护现有代码的 DSH 用户：** 在让 AI Agent 修改代码前，先查看可能的连带影响。使用正式稳定版 **v0.11.1**，安装到兼容的 DSH profile：
+
+```sh
+dsh plugin --profile desktop add dsh-code-index@0.11.1
+```
 
-- **在 AI 修改之前：**从真实工作区 Git diff、输入 diff，或明确标注的文件/符号选择开始。
-- **看清可能影响什么：**检查变更声明、直接调用者、间接路径、模块导入和测试候选。
-- **检查真实证据：**点击节点或箭头，查看纳入原因、关系来源、文件行号及实际源码快照。放大视图中图与证据并排展示，可打开 Desktop 原生文件预览。
-- **了解不确定性：**黄色点线的 `name-only` 候选、导入范围、未映射行、缺失源码和裁剪均明确呈现；测试线索不证明覆盖率或必然失败。
+安装后重启 Desktop。v0.11.1 声明支持 DSH `0.2.0-rc.2`、`0.2.1-rc.2` 和 `0.2.1-rc.3` 宿主版本组；Desktop rc.3 的兼容性提示据反馈已消失，但这不代表 Electron Desktop 全部功能或 Agent 验收通过。[安装说明](#安装) · [v0.11.1 验证与限制](RELEASE_EVIDENCE_v0.11.1.md)。
 
-这是既有 `code_change_context` 分析和源码读取能力的交互展示，不是新开发的影响分析算法。
+**观看 30 秒真实 Desktop 演示：**`normalize()` 被修改 → 查看调用者与测试线索 → 点击关系查看真实源码位置。
 
-![真实 DSH Desktop 中的 Impact X-Ray](assets/impact-xray-mvp.gif)
+![真实 DSH Desktop 中的 Impact X-Ray：变更的 normalize、调用者、测试与可点击的源码证据](assets/impact-xray-mvp.gif)
 
-[真实录制与复现说明](assets/impact-xray-mvp-demo.md) · [发布证据与已知限制](RELEASE_EVIDENCE_v0.11.0.md) · [中英文发布说明](RELEASE_NOTES_v0.11.0.md)
+[观看 MP4](assets/impact-xray-mvp.mp4) · [全尺寸 GIF](assets/impact-xray-mvp.gif) · [演示说明与复现](assets/impact-xray-mvp-demo.md) · [从 npm 安装 v0.11.1](https://www.npmjs.com/package/dsh-code-index/v/0.11.1) · [项目主页](https://github.com/lemonxiny55/dsh-code-index)
 
-视频展示真实 `dev.0` MVP；前 10 秒可看到变更函数、调用者/测试和有源码证据的 exact 关系。`dev.1` 首屏的变更中心改进另以实机截图记录，没有把视频描述成后续首屏版本的录制。
+录屏来自真实 DSH Desktop 0.2.1-rc.2 中的 `0.11.0-dev.0` MVP 操作，展示的是既有分析与源码证据；它不代表模型驱动 Agent 的耗时或成功率。详见[录制来源](assets/impact-xray-mvp-demo.md)。
 
-使用 Desktop 自带的 CLI 将 v0.11.0 安装到现有受支持的 Desktop profile：
+- 从 Git diff 或明确选定的文件/符号出发，查看调用者、导入依赖、影响路径和测试候选。
+- 点击关系，查看其来源，以及可用的文件行号和源码快照。
+- 把候选视为线索：`name-only` 匹配可能不确定；测试线索不证明覆盖率或测试失败。
 
-```sh
-dsh plugin --profile desktop add dsh-code-index@0.11.0
-```
+Impact X-Ray 是既有 `code_change_context` 分析及源码读取能力的交互展示，并未新增影响分析引擎。关系属于静态证据，不保证运行时必然受影响。
 
-安装后重启 Desktop。本版本的完整 UI 已在 DSH Desktop 0.2.1-rc.2 实机验证；0.2.0-rc.2 通过安装及 ToolRuntime 检查，但未完成完整 Impact X-Ray UI 验收。peer 范围未扩大。实际验证方法、性能观察和已知限制见发布证据。开发构建使用 Node 22/24 与 pnpm 11。
+**验证范围：** Desktop 0.2.1-rc.2 完成完整 X-Ray UI 验证；Web/Host rc.3 完成全部八个工具及 X-Ray 验证（未运行模型驱动 Agent）；Desktop 0.2.0-rc.2 通过安装和 ToolRuntime 检查，未验证完整 X-Ray UI。宿主中的第一方包须使用同一已声明版本。[v0.11.1 验证与限制](RELEASE_EVIDENCE_v0.11.1.md)。
 
 让 Agent 调用 `code_change_context`：
 
@@ -85,16 +86,16 @@ node scripts/impact-xray-demo.mjs D:/absolute/path/to/new-demo-repo
 
 ## 快速开始
 
-需要 Node 22/24 与匹配的 DSH `0.2.0-rc.2` 或 `0.2.1-rc.2` 宿主版本组。用 Desktop 自带的 `dsh` CLI 安装到现有 profile：
+需要 Node 22/24。v0.11.2 候选版本允许 DSH `>=0.2.0-rc.2`（包括预发布版本），第一方包应使用配套版本。后续版本可以尝试加载，但并不代表全部经过验证。用 Desktop 自带的 `dsh` CLI 安装到现有 profile：
 
 ```sh
-dsh plugin --profile desktop add dsh-code-index@0.11.0
+dsh plugin --profile desktop add dsh-code-index@0.11.1
 ```
 
 安装后重启 Desktop。匹配的 Web profile 可使用：
 
 ```sh
-npx @deepseek-ai/dsh@0.2.1-rc.2 plugin --profile web add dsh-code-index@0.11.0
+npx @deepseek-ai/dsh@0.2.1-rc.2 plugin --profile web add dsh-code-index@0.11.1
 npx @deepseek-ai/dsh@0.2.1-rc.2 web
 ```
 
@@ -146,13 +147,13 @@ npx @deepseek-ai/dsh@0.2.1-rc.2 web
 
 需要 `dsh`(任意安装方式——npx、npm 或源码)与 Node ≥ 22。
 
-v0.10.1 引入的兼容范围继续保持 `@deepseek-ai/dsh-tools: 0.2.0-rc.2 || 0.2.1-rc.2`。使用配套的 DSH/dsh-tools 版本组，不混装第一方 RC 包。DSH 插件接口仍属于预览 API；其他 RC 和未来版本不在此兼容声明范围内。
+v0.11.2 候选版本声明 `@deepseek-ai/dsh-tools: >=0.2.0-rc.2`，不设置上限。DSH 检查范围时包含预发布版本，因此未来版本可以尝试加载插件，但这不代表每个版本都经过验证。请使用配套的 DSH/dsh-tools 版本组；插件接口仍是预览 API，未来版本可能产生兼容问题。
 
-Desktop 在激活前检查 DSH peer 约束。v0.10.0 的精确 `0.2.0-rc.2` pin 会被 DSH `0.2.1-rc.2` 拒绝；v0.10.1 明确列举支持组，不依赖版本豁免或无上限范围。开发依赖保留 `0.2.0-rc.2`，继续检查旧版 API。
+Desktop 在激活前检查 DSH peer 约束。v0.10.0 的精确 `0.2.0-rc.2` pin 会被 DSH `0.2.1-rc.2` 拒绝；v0.10.1 列举了当时支持的版本组；v0.11.2 移除这一枚举。开发依赖保留 `0.2.0-rc.2`，继续检查旧版 API。
 
 ```sh
 # 从 npm(预编译)
-npx @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web add dsh-code-index@0.11.0
+npx @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web add dsh-code-index@0.11.1
 
 # 或从包含本仓库检查副本的目录
 npx @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web add ./dsh-code-index
@@ -312,3 +313,4 @@ node.exe scripts\fix-wsl-links.mjs C:\Users\you\.dsh\profiles\web   # dsh profil
 
 MIT。与 DeepSeek 无关;基于公开的 `dsh` 插件接口构建。
 
+

package/dist/index.d.ts

@@ -1,708 +1,22 @@
-import * as _deepseek_ai_dsh_tools from '@deepseek-ai/dsh-tools';
-import Schema from '@deepseek-ai/schemastery';
-
-/** Shared data model for dsh-code-index. */
-/** On-disk cache layout version. Bump when persisted graph/symbol shapes change. */
-declare const REPO_INDEX_SCHEMA_VERSION: 4;
-type SymbolKind = 'function' | 'method' | 'class' | 'interface' | 'type' | 'enum' | 'variable' | 'field' | 'import' | 'module';
-/** Stable, file-qualified symbol identity: `sym:v1:<file>#<scope>/<segment>`. */
-type SymbolId = string;
-/** Vocabulary for one scope segment in a qualified symbol id. */
-type ScopeKind = 'module' | 'namespace' | 'class' | 'interface' | 'trait' | 'impl' | 'function' | 'method' | 'owner';
-interface SymbolScopePart {
-    kind: ScopeKind;
-    name: string;
-    /** 1-based among sibling scope owners with the same kind and name. */
-    ordinal: number;
-}
-interface SymbolInfo {
-    /** ArkTS decorators as written; their source lines belong to the definition. */
-    decorators?: string[];
-    /** Stable qualified id; unique within a RepoIndex. */
-    id: SymbolId;
-    /** Symbol name (identifier / type id / member name). */
-    name: string;
-    kind: SymbolKind;
-    /** Repo-relative path of the containing file, always forward-slash. */
-    file: string;
-    /** 1-based start line. */
-    line: number;
-    /** 1-based end line (inclusive). */
-    endLine: number;
-    /** Normalized public/export status by language; Rust: unrestricted `pub` only. */
-    exported: boolean;
-    /** Short human-readable signature, e.g. `greet(name: string)` — empty when n/a. */
-    signature: string;
-    /** Owners only; excludes the symbol itself. Empty at module level. */
-    scope: SymbolScopePart[];
-    /** 1-based among symbols with the same scope, kind, and name. */
-    ordinal: number;
-}
-/** One name bound by an import statement, with its local alias. */
-interface ImportBinding {
-    /** Imported name: "foo" | "default" | "*" | null (namespace/package). */
-    imported: string | null;
-    /** Name visible in this file (alias when renamed). */
-    local: string;
-    kind: 'named' | 'default' | 'namespace' | 'package' | 'static' | 'glob';
-}
-/** Structured form of one import/include/use site. */
-interface ImportInfo {
-    specifier: string;
-    line: number;
-    kind: 'import' | 'reexport' | 'include' | 'use';
-    bindings: ImportBinding[];
-}
-/** One call site: callee name, line, and enclosing function ('' = module level). */
-interface CallInfo {
-    /** ArkUI syntax requires an explicit/local binding; no global name guessing. */
-    context?: 'arkui';
-    /** Callee name as written (identifier, member/property, or qualified tail). */
-    name: string;
-    /** 1-based line of the call expression. */
-    line: number;
-    /** Enclosing function/method name, or '' for a module-level call. */
-    from: string;
-    /** Structural owner from AST containment; null at module level. */
-    fromId: SymbolId | null;
-    /** Receiver/namespace text when available: `ns.foo()` -> "ns"; bare -> null. */
-    qualifier: string | null;
-}
-interface IndexedFile {
-    /** Syntax/read completeness, not a typecheck or HarmonyOS runtime verdict. */
-    diagnostic?: ParseDiagnostic;
-    /** Repo-relative path (forward-slash). */
-    path: string;
-    lang: string;
-    /** fs mtime of the source file at index time (milliseconds). */
-    mtimeMs: number;
-    symbols: SymbolInfo[];
-    /** Derived compatibility view of {@link importDetails} specifiers. */
-    imports?: string[];
-    /** Structured import/include/use sites with their name bindings. */
-    importDetails?: ImportInfo[];
-    /** Call sites found in this file (callee + line + enclosing function).
-     *  Optional because caches written before call-graph support lack it. */
-    calls?: CallInfo[];
-}
-interface ParseDiagnostic {
-    status: 'parsed' | 'partial' | 'failed';
-    errorCount: number;
-    missingCount: number;
-    issues: Array<{
-        kind: 'ERROR' | 'MISSING';
-        line: number;
-    }>;
-    reason?: 'source-unavailable' | 'parser-failed';
-}
-interface RepoIndex {
-    /** Persisted layout version; see {@link REPO_INDEX_SCHEMA_VERSION}. */
-    schemaVersion: typeof REPO_INDEX_SCHEMA_VERSION;
-    /** Absolute source root this index describes. */
-    root: string;
-    /** Unix ms when the index was generated. */
-    generatedAt: number;
-    files: IndexedFile[];
-    excludedDirs: string[];
-}
-declare function symbolCount(index: RepoIndex): number;
-/** Optional config consumed by the index build pipeline. */
-interface IndexOptions {
-    /** Extra directories to exclude, appended to the defaults. */
-    excludeDirs?: string[];
-    /** Minimum mtime delta (ms) that forces a re-extract in refresh mode. */
-    staleToleranceMs?: number;
-}
-
-/** Build a RepoIndex for a workspace: scan -> extract -> persist. */
-
-/**
- * Full build: scan + extract every supported file. Existing per-file
- * extraction is reused when `previous` holds an identical mtime for the
- * same rel path (incremental refresh), so touched files alone re-parse.
- */
-declare function buildIndex(root: string, options?: IndexOptions, previous?: RepoIndex | null, forcePaths?: ReadonlySet<string>): Promise<RepoIndex>;
-/** Convenience wrapper: evolve an on-disk cache if `root` exists. */
-declare function buildIndexWithCache(root: string, options?: IndexOptions, cacheDir?: string, forcePaths?: ReadonlySet<string>): Promise<RepoIndex>;
-/**
- * Locate the git repo root for a path by walking up to the nearest `.git`
- * directory. Bounded walk (max `maxLevels` levels); returns `null` when no
- * repo marker is found — callers must NOT index an untagged directory
- * (the fs root is the classic footgun: indexing `C:\` by accident).
- */
-declare function findRepoRoot(startDir: string, maxLevels?: number): Promise<string | null>;
-
-/**
- * tree-sitter symbol extraction.
- *
- * Parses a source text with a per-language grammar (web-tree-sitter WASM,
- * static grammars from tree-sitter-wasms) and returns flat SymbolInfo rows.
- *
- * web-tree-sitter 0.25 loads the existing tree-sitter-wasms grammars and the
- * pinned ArkTS ABI-14 asset. See grammars/README.md for provenance.
- */
-
-type LanguageId = 'arkts' | 'typescript' | 'javascript' | 'python' | 'go' | 'rust' | 'java' | 'cpp' | 'c';
-declare function languageForFile(filePath: string): LanguageId | null;
-interface ExtractedFile {
-    diagnostic: ParseDiagnostic;
-    symbols: SymbolInfo[];
-    /** Derived compatibility view of {@link importDetails} specifiers. */
-    imports: string[];
-    /** Structured import/include/use sites with name bindings. */
-    importDetails: ImportInfo[];
-    /** Call sites, ordered by line: callee name + enclosing function. */
-    calls: CallInfo[];
-}
-declare function extractAll(code: string, id: LanguageId, file?: string): Promise<ExtractedFile>;
-/** Symbols only — see extractAll for the combined parse. */
-declare function extractSymbols(code: string, id: LanguageId): Promise<SymbolInfo[]>;
-/** Compile a symbol query for a code sample (used by tests). */
-declare function parseFileToSymbols(filePath: string, repoRoot: string, code?: string): Promise<SymbolInfo[]>;
-
-/** Workspace file discovery with dir exclusions and mtime tracking. */
-
-declare const DEFAULT_EXCLUDED_DIRS: string[];
-/** Language-agnostic source extensions we index. */
-declare const SUPPORTED_EXTS: Set<string>;
-interface ScannedFile {
-    /** Absolute path on disk. */
-    abs: string;
-    /** Repo-relative path (forward-slash). */
-    rel: string;
-    mtimeMs: number;
-}
-/**
- * Recursively walk `root` and return indexed files, skipping excluded dir
- * components at any depth. Uses readdir with `withFileTypes` so we never
- * stat every entry; mtime comes from a targeted stat per candidate file.
- */
-declare function scanRepo(root: string, options?: IndexOptions): Promise<ScannedFile[]>;
-
-/** On-disk JSON cache for RepoIndex, keyed by repo root. */
-
-declare const CACHE_DIR_NAME = ".dsh-code-index";
-/** Default cache location: `<repoRoot>/.dsh-code-index/index.json`. */
-declare function defaultCachePath(root: string, cacheDir?: string): string;
-declare function loadIndex(cachePath: string): Promise<RepoIndex | null>;
-declare function saveIndex(cachePath: string, index: RepoIndex): Promise<void>;
-
-/** One summary and at most three file locations. No source or exception dump. */
-declare function indexIntegrityWarnings(index: RepoIndex): string[];
-
-/** Pure search / filter logic over a RepoIndex — unit-testable, no IO. */
-
-interface SymbolFilter {
-    query?: string;
-    file?: string;
-    kind?: SymbolKind;
-    exportedOnly?: boolean;
-}
-interface RankedHit extends SymbolInfo {
-    /** 0..1 relevance. 1 = exact name match; lower = fuzzier. */
-    score: number;
-}
-/** Filter symbols by file/kind/export, then score by name against query (if any). */
-declare function searchSymbols(index: RepoIndex, filter: SymbolFilter, limit?: number, refs?: Map<string, number>): RankedHit[];
-/** Neat one-line rendering of a hit for terminal/chat output. */
-declare function renderHit(hit: RankedHit): string;
-
-/**
- * Bounded, ranked repo map generation — the "aider-style" overview the model
- * can turn to before browsing files. Pure logic, no IO.
- */
-
-interface RepoMapOptions {
-    /** Max files to include (default 24). */
-    topFiles?: number;
-    /** Max symbols per file (default 18). */
-    symbolsPerFile?: number;
-    /** Hard cap on rendered characters (default 3200). */
-    maxChars?: number;
-}
-interface RepoMapEntry {
-    path: string;
-    score: number;
-    symbols: Array<{
-        name: string;
-        kind: SymbolKind;
-        line: number;
-        signature: string;
-    }>;
-}
-/** Density-aware file score: weighted symbols minus bloat; test paths damped. */
-declare function scoreFile(file: IndexedFile): number;
-/** Rank files, take the top slice, cap per-file symbols. */
-declare function rankRepoMap(index: RepoIndex, options?: RepoMapOptions): RepoMapEntry[];
-/** Render the ranked map as markdown, hard-truncated to maxChars. */
-declare function renderRepoMap(entries: RepoMapEntry[], options?: RepoMapOptions): string;
-
-/** Function-level call graph built from the cached index — pure, no IO. */
-
-/** name -> definitions; several when same-named symbols live in different files. */
-declare function buildSymbolTable(index: RepoIndex): Map<string, SymbolInfo[]>;
-/** One call site that invokes the queried symbol. */
-interface CallerHit {
-    file: string;
-    line: number;
-    from: string;
-}
-/** One distinct symbol the queried function calls, with its first call line. */
-interface CalleeHit {
-    name: string;
-    line: number;
-    /** In-repo definitions matched by the callee name. */
-    targets: SymbolInfo[];
-}
-interface SymbolRefs {
-    /** Definitions of the queried symbol (empty when only call sites exist). */
-    defs: SymbolInfo[];
-    callers: CallerHit[];
-    callees: CalleeHit[];
-}
-/** How many call sites reference each name — used to rank search hits. */
-declare function callerCounts(index: RepoIndex): Map<string, number>;
-/**
- * Resolve one symbol to its callers (call sites invoking it anywhere) and its
- * callees (calls made inside the definition, attributed by the extracted
- * enclosing-function name). Name-based, so it is a best-effort view: like-named
- * symbols are reported as candidates rather than guessed apart.
- */
-declare function symbolRefs(index: RepoIndex, symbol: string, limit?: number): SymbolRefs;
-/**
- * How sure the graph is about one resolved edge. Deliberately coarse: the
- * index has no type checker, so `exact` only ever means "one structurally
- * unambiguous target under this index's model".
- */
-type ResolutionLabel = 'exact' | 'import-scoped' | 'name-only';
-/** Which resolution tier produced an edge — the *why* behind its label. */
-type ResolutionProvenance = 'structural-owner' | 'local-unique' | 'explicit-import-binding' | 'namespace-import' | 'resolved-import-module' | 'global-name';
-
-/** Import-graph health checks: circular dependencies and orphan modules. */
-
-interface ModuleGraph {
-    nodes: string[];
-    edges: Map<string, Set<string>>;
-}
-/** Nodes are indexed files; an edge A -> B means A imports B (self-edges dropped). */
-declare function buildModuleGraph(index: RepoIndex): ModuleGraph;
-/** Tarjan strongly-connected components of size > 1 — i.e. import cycles. */
-declare function findCycles(index: RepoIndex): string[][];
-/**
- * Symbol-bearing files that neither import nor are imported by any other file,
- * excluding conventional entry points and tests (which are legitimately
- * unreferenced). A cheap, low-false-positive stand-in for dead-code detection.
- */
-declare function findOrphanModules(index: RepoIndex): string[];
-
-/**
- * Unified-diff parsing and a thin `git` adapter.
- *
- * `parseUnifiedDiff` is pure (no IO) so it is unit-testable in isolation; the
- * two readers shell out to `git` exclusively through `execFile` with an argv
- * array — a ref or path is never interpolated into a shell string.
- */
-/** One `@@` hunk header; a missing count means 1 (git omits `,1`). */
-interface DiffHunk {
-    oldStart: number;
-    oldLines: number;
-    newStart: number;
-    newLines: number;
-}
-/** One file's entry in a unified diff. */
-interface FileChange {
-    /** Repo-relative path on the base side, or null for an added file. */
-    oldPath: string | null;
-    /** Repo-relative path on the current side, or null for a deleted file. */
-    newPath: string | null;
-    status: 'added' | 'modified' | 'deleted' | 'renamed';
-    hunks: DiffHunk[];
-}
-/**
- * Parse `git diff` / `diff -u` output into per-file changes. Handles
- * `diff --git`, `new file mode`, `deleted file mode`, `rename from/to`,
- * `---`/`+++` (including `/dev/null`), and `@@` headers with omitted counts.
- */
-declare function parseUnifiedDiff(text: string): FileChange[];
-/**
- * Working-tree diff against `baseRef`, rename-aware and hunk-minimal.
- * Includes non-ignored untracked files and reliable exact-content renames.
- */
-declare function readWorkingTreeDiff(root: string, baseRef: string): Promise<string>;
-/** Read one repo-relative file at a ref; null when the path/ref is absent. */
-declare function readGitFileAtRef(root: string, ref: string, repoRelativePath: string): Promise<string | null>;
-
-/**
- * Change-aware context (design §3): map a git/working-tree diff (or an explicit
- * file/symbol selection) onto indexed symbols, then walk the provenance-labeled
- * reference graph to surface callers, import dependents, transitive impact,
- * entry-point paths, and likely affected tests.
- *
- * Every relation keeps the reference graph's honest label (`exact` /
- * `import-scoped` / `name-only`); a diff hunk intersecting a symbol's declared
- * line range is the only thing treated as `exact`.
- */
-
-type ChangeKind = 'added' | 'modified' | 'deleted' | 'renamed' | 'unclassified';
-interface ChangedSymbol {
-    symbol: SymbolInfo;
-    change: ChangeKind;
-    side: 'current' | 'base';
-    /** A hunk range intersecting the declaration is structural, not inferred. */
-    resolution: 'exact';
-    /** First intersecting changed line, used for large-declaration windows. */
-    focusLine?: number;
-}
-interface UnmappedChange {
-    file: string;
-    side: 'current' | 'base';
-    ranges: Array<{
-        startLine: number;
-        endLine: number;
-    }>;
-    reason: 'outside-symbol' | 'base-content-unavailable';
-}
-interface ImpactHop {
-    fromId: SymbolId | null;
-    toId: SymbolId;
-    callSite: {
-        file: string;
-        line: number;
-    };
-    resolution: ResolutionLabel;
-    reason: ResolutionProvenance;
-}
-interface ImpactRow {
-    symbol: SymbolInfo;
-    depth: number;
-    via: ImpactHop;
-    resolution: ResolutionLabel;
-}
-interface SymbolPath {
-    entry: SymbolInfo;
-    changed: SymbolInfo;
-    hops: ImpactHop[];
-    resolution: ResolutionLabel;
-}
-interface ImportDependent {
-    file: string;
-    changedFile: string;
-    specifier: string;
-    resolution: 'import-scoped';
-}
-interface AffectedTest {
-    file: string;
-    resolution: ResolutionLabel;
-    reason: 'changed-test' | 'imports-changed-file' | 'imports-impact-file' | 'references-symbol-name' | 'path-convention';
-    distance?: number;
-}
-interface ChangeContextResult {
-    root: string;
-    source: 'git' | 'diff' | 'files' | 'symbols';
-    baseRef?: string;
-    changed: ChangedSymbol[];
-    unmapped: UnmappedChange[];
-    directCallers: ImpactRow[];
-    importDependents: ImportDependent[];
-    paths: SymbolPath[];
-    impact: ImpactRow[];
-    tests: AffectedTest[];
-    warnings: string[];
-    truncated: {
-        callers: boolean;
-        dependents: boolean;
-        paths: boolean;
-        impact: boolean;
-        tests: boolean;
-    };
-}
-interface CodeChangeContextArgs {
-    outputFormat?: 'text' | 'xray';
-    repoRoot?: string;
-    diff?: string;
-    baseRef?: string;
-    files?: string[];
-    symbols?: SymbolId[];
-    maxDepth?: number;
-    maxImpact?: number;
-    maxPaths?: number;
-    maxTests?: number;
-}
-interface ChangeContextOptions {
-    maxDepth?: number;
-    maxImpact?: number;
-    maxPaths?: number;
-    maxTests?: number;
-}
-/** Normalized input: exactly one selection mode. */
-type ChangeContextInput = {
-    kind: 'git';
-    root: string;
-    baseRef: string;
-} | {
-    kind: 'diff';
-    root: string;
-    text: string;
-    baseRef?: string;
-} | {
-    kind: 'files';
-    files: string[];
-} | {
-    kind: 'symbols';
-    symbolIds: SymbolId[];
-};
-/** Validate flat tool args and normalize them into one input mode. */
-declare function changeContextInputFromArgs(args: Pick<CodeChangeContextArgs, 'diff' | 'baseRef' | 'files' | 'symbols'>, root: string): ChangeContextInput;
-declare function buildChangeContext(index: RepoIndex, input: ChangeContextInput, options?: ChangeContextOptions): Promise<ChangeContextResult>;
-/**
- * Render the result as fixed skeleton sections. Section headers and warnings
- * are always kept; rows are trimmed to the final character cap, which then
- * appends an explicit truncation line.
- */
-declare function renderChangeContext(result: ChangeContextResult, maxChars?: number): string;
-
-interface SourceExcerpt {
-    file: string;
-    startLine: number;
-    endLine: number;
-    side: 'current' | 'base';
-    ref?: string;
-    mode: 'complete' | 'window' | 'signature';
-    code?: string;
-    signature?: string;
-}
-
-interface ContextPackItem extends Partial<SourceExcerpt> {
-    kind: 'primary' | 'caller' | 'callee' | 'import' | 'test' | 'change' | 'file' | 'relationship';
-    name?: string;
-    reason: string;
-    resolution?: ResolutionLabel;
-    provenance?: string;
-    change?: string;
-    text?: string;
-}
-/** The only final presentation DTO. Items here have already passed selection. */
-interface ContextPack {
-    version: 1;
-    root: string;
-    task: string;
-    route: TaskContextResult['route']['kind'];
-    items: ContextPackItem[];
-    gaps: string[];
-    budget: {
-        budgetChars: number;
-        usedChars: number;
-        packChars: number;
-        truncated: boolean;
-    };
-}
-declare function renderContextPack(pack: ContextPack): string;
-
-/**
- * Task-aware structural context orchestration.
- *
- * This module deliberately contains no parser, search index, graph, or git
- * implementation of its own. It ranks the existing primitives into a compact
- * package that answers the question: which code matters for this task?
- */
-
-type ContextTaskKind = 'change' | 'symbol' | 'architecture' | 'test' | 'exploration' | 'ambiguous';
-interface ContextRoute {
-    kind: ContextTaskKind;
-    queries: string[];
-    mentionedFiles: string[];
-    exactSymbolNames: string[];
-    sources: string[];
-    includeChangeContext: boolean;
-    includeRelationships: boolean;
-}
-interface ContextOptions {
-    budgetChars?: number;
-    maxFiles?: number;
-    maxSymbols?: number;
-}
-interface ContextSymbol {
-    symbol: SymbolInfo;
-    score: number;
-    provenance: 'exact' | 'lexical';
-    reason: string;
-}
-interface ContextFile {
-    path: string;
-    score: number;
-    reason: string;
-}
-interface ContextRelationship {
-    text: string;
-    resolution: ResolutionLabel;
-    priority: number;
-    key: string;
-    provenance: string;
-}
-interface ContextConfidence {
-    exact: number;
-    'import-scoped': number;
-    'name-only': number;
-}
-interface TaskContextResult {
-    pack: ContextPack;
-    root: string;
-    task: string;
-    route: ContextRoute;
-    primarySymbols: ContextSymbol[];
-    relevantFiles: ContextFile[];
-    relationships: ContextRelationship[];
-    changeContext: ChangeContextResult | null;
-    tests: string[];
-    testEvidence: AffectedTest[];
-    confidence: ContextConfidence;
-    warnings: string[];
-    budget: {
-        usedChars: number;
-        budgetChars: number;
-        truncated: boolean;
-    };
-}
-/** Classify a task and decide which existing primitives should be composed. */
-declare function routeTask(task: string, index?: RepoIndex): ContextRoute;
-/** Build a deterministic, bounded context package from the current task. */
-declare function buildTaskContext(index: RepoIndex, task: string, options?: ContextOptions): Promise<TaskContextResult>;
-/** Text always renders the final selected pack. */
-declare function renderTaskContext(result: TaskContextResult): string;
-
-declare const tools: _deepseek_ai_dsh_tools.ToolDefinition[];
-
-/** Browser-safe presentation contract. Persisted v1 PoCs remain readable. */
-declare const XRAY_LIMITS: {
-    readonly nodes: 32;
-    readonly edges: 48;
-    readonly paths: 12;
-    readonly evidenceChars: 900;
-    readonly metadataBytes: 96000;
-};
-interface XrayEvidence {
-    file: string;
-    line: number;
-    startLine: number;
-    side: 'current' | 'base';
-    ref?: string;
-    type?: 'declaration' | 'call-site' | 'import-site' | 'test-lead' | 'unmapped-change';
-    code?: string;
-    gap?: string;
-}
-interface XrayNode {
-    id: string;
-    name: string;
-    kind: string;
-    file: string;
-    line: number;
-    changed: boolean;
-    category?: 'change' | 'caller' | 'impact' | 'module' | 'test';
-    depth?: number;
-    resolution?: ImpactHop['resolution'];
-    change?: string;
-    reason: string;
-    evidence: XrayEvidence;
-}
-interface XrayEdge {
-    id: string;
-    from: string;
-    to: string;
-    kind?: 'call' | 'import';
-    resolution: ImpactHop['resolution'];
-    reason: string;
-    evidence: XrayEvidence;
-}
-interface XrayPath {
-    id: string;
-    from: string;
-    to: string;
-    edgeIds: string[];
-    resolution: ImpactHop['resolution'];
-    omitted: boolean;
-}
-interface ImpactXray {
-    card: 'impact-xray';
-    version: 1 | 2;
-    root: string;
-    source: ChangeContextResult['source'];
-    nodes: XrayNode[];
-    edges: XrayEdge[];
-    tests: Array<ChangeContextResult['tests'][number] & {
-        nodeId?: string;
-    }>;
-    imports: Array<ChangeContextResult['importDependents'][number] & {
-        edgeId?: string;
-    }>;
-    paths?: XrayPath[];
-    unmapped?: Array<ChangeContextResult['unmapped'][number] & {
-        evidence: XrayEvidence;
-    }>;
-    bounds?: {
-        analysis: ChangeContextResult['truncated'];
-        projection: boolean;
-        text?: boolean;
-        totals: {
-            changed: number;
-            callers: number;
-            impact: number;
-            imports: number;
-            tests: number;
-            paths: number;
-            unmapped: number;
-        };
-    };
-    gaps: string[];
-    truncated: boolean;
-}
-
-/** Presentation of existing analysis. Never resolves new function-call edges. */
-declare function buildImpactXray(index: RepoIndex, result: ChangeContextResult): Promise<ImpactXray>;
-
-/** Plugin configuration: merged once at apply time, read wherever needed. */
-
-/** DSH 0.1.7+ renders fields marked volatile in its per-plugin config forms. */
-declare const Config: Schema<Schemastery.ObjectS<NoInfer<{
-    excludeDirs: Schema<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
-    mapTopFiles: Schema<number, number, "volatile-defined">;
-    mapMaxChars: Schema<number, number, "volatile-defined">;
-    mapTtlMs: Schema<number, number, "volatile-defined">;
-    autoInject: Schema<boolean, boolean, "volatile-defined">;
-    codeHealth: Schema<boolean, boolean, "volatile-defined">;
-    toolSurface: Schema<string, string, "volatile-defined">;
-    externalWatch: Schema<boolean, boolean, "volatile-defined">;
-    watchDebounceMs: Schema<number, number, "volatile-defined">;
-}>>, Schemastery.ObjectT<NoInfer<{
-    excludeDirs: Schema<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
-    mapTopFiles: Schema<number, number, "volatile-defined">;
-    mapMaxChars: Schema<number, number, "volatile-defined">;
-    mapTtlMs: Schema<number, number, "volatile-defined">;
-    autoInject: Schema<boolean, boolean, "volatile-defined">;
-    codeHealth: Schema<boolean, boolean, "volatile-defined">;
-    toolSurface: Schema<string, string, "volatile-defined">;
-    externalWatch: Schema<boolean, boolean, "volatile-defined">;
-    watchDebounceMs: Schema<number, number, "volatile-defined">;
-}>>, "plain">;
-interface PluginConfig {
-    /** Extra directories to exclude from indexing (appended to defaults). */
-    excludeDirs?: string[];
-    /** Max files in the ranked repo map (code_map / auto section). */
-    mapTopFiles?: number;
-    /** Hard char cap for rendered maps. */
-    mapMaxChars?: number;
-    /** Refresh interval for the auto-injected map (ms, min 1000). */
-    mapTtlMs?: number;
-    /** Set false to disable the auto-injected system section. */
-    autoInject?: boolean;
-    /** Register the code_health tool (circles / orphans). Off by default. */
-    codeHealth?: boolean;
-    /** Experimental tool surface; full preserves the complete v0.6 API. */
-    toolSurface?: 'full' | 'compact';
-    /** Observe source changes made by editors and external tools. */
-    externalWatch?: boolean;
-    /** Coalesce filesystem events before refreshing affected files. */
-    watchDebounceMs?: number;
-}
+export { buildIndex, buildIndexWithCache, findRepoRoot } from './buildIndex.js';
+export { extractAll, extractSymbols, languageForFile, parseFileToSymbols } from './extract.js';
+export { DEFAULT_EXCLUDED_DIRS, SUPPORTED_EXTS, scanRepo } from './scan.js';
+export { CACHE_DIR_NAME, defaultCachePath, loadIndex, saveIndex } from './store.js';
+export { IndexOptions, IndexedFile, ParseDiagnostic, RepoIndex, SymbolInfo, SymbolKind, symbolCount } from './types.js';
+export { indexIntegrityWarnings } from './integrity.js';
+export { renderHit, searchSymbols } from './search.js';
+export { rankRepoMap, renderRepoMap, scoreFile } from './repomap.js';
+export { buildSymbolTable, callerCounts, symbolRefs } from './refgraph.js';
+export { buildModuleGraph, findCycles, findOrphanModules } from './health.js';
+export { DiffHunk, FileChange, parseUnifiedDiff, readGitFileAtRef, readWorkingTreeDiff } from './git-diff.js';
+export { ContextFile, ContextOptions, ContextRelationship, ContextRoute, ContextSymbol, ContextTaskKind, TaskContextResult, buildTaskContext, renderTaskContext, routeTask } from './context.js';
+export { ContextPack, ContextPackItem, renderContextPack } from './context-pack.js';
+export { AffectedTest, ChangeContextInput, ChangeContextOptions, ChangeContextResult, ChangeKind, ChangedSymbol, CodeChangeContextArgs, ImpactHop, ImpactRow, ImportDependent, SymbolPath, UnmappedChange, buildChangeContext, changeContextInputFromArgs, renderChangeContext } from './change-context.js';
+export { tools } from './tools.js';
+export { XRAY_LIMITS, buildImpactXray } from './impact-xray.js';
+export { ImpactXray, XrayEdge, XrayEvidence, XrayNode, XrayPath } from './impact-xray-model.js';
+import { PluginConfig } from './config.js';
+export { Config } from './config.js';
 
 /**
  * dsh-code-index — DeepSeek Harness bundle entry.
@@ -738,4 +52,4 @@ declare const name = "dsh-code-index";
 declare const inject: readonly ["tools", "systemPrompt"];
 declare function apply(ctx: MinimalContext, pluginConfig?: PluginConfig): void;
 
-export { type AffectedTest, CACHE_DIR_NAME, type ChangeContextInput, type ChangeContextOptions, type ChangeContextResult, type ChangeKind, type ChangedSymbol, type CodeChangeContextArgs, Config, type ContextFile, type ContextOptions, type ContextPack, type ContextPackItem, type ContextRelationship, type ContextRoute, type ContextSymbol, type ContextTaskKind, DEFAULT_EXCLUDED_DIRS, type DiffHunk, type FileChange, type ImpactHop, type ImpactRow, type ImpactXray, type ImportDependent, type IndexOptions, type IndexedFile, type ParseDiagnostic, type RepoIndex, SUPPORTED_EXTS, type SymbolInfo, type SymbolKind, type SymbolPath, type TaskContextResult, type UnmappedChange, XRAY_LIMITS, type XrayEdge, type XrayEvidence, type XrayNode, type XrayPath, apply, buildChangeContext, buildImpactXray, buildIndex, buildIndexWithCache, buildModuleGraph, buildSymbolTable, buildTaskContext, callerCounts, changeContextInputFromArgs, defaultCachePath, extractAll, extractSymbols, findCycles, findOrphanModules, findRepoRoot, indexIntegrityWarnings, inject, languageForFile, loadIndex, name, parseFileToSymbols, parseUnifiedDiff, rankRepoMap, readGitFileAtRef, readWorkingTreeDiff, renderChangeContext, renderContextPack, renderHit, renderRepoMap, renderTaskContext, routeTask, saveIndex, scanRepo, scoreFile, searchSymbols, symbolCount, symbolRefs, tools };
+export { apply, inject, name };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-code-index",
-  "version": "0.11.0",
+  "version": "0.11.2",
   "description": "Impact X-Ray for DSH: inspect potential code-change impact, provenance and real source evidence before AI edits.",
   "type": "module",
   "main": "./dist/index.js",
@@ -51,7 +51,7 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-tools": "0.2.0-rc.2 || 0.2.1-rc.2"
+    "@deepseek-ai/dsh-tools": ">=0.2.0-rc.2"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {
@@ -64,6 +64,7 @@
     "@types/node": "^26.2.0",
     "@types/react": "^18.3.31",
     "react": "^18.3.1",
+    "semver": "^7.8.5",
     "tsup": "^8.5.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.8"

package/scripts/release-smoke.mjs

@@ -4,6 +4,7 @@ import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'nod
 import os from 'node:os'
 import { createRequire } from 'node:module'
 import path from 'node:path'
+import semver from 'semver'
 import { fileURLToPath, pathToFileURL } from 'node:url'
 
 const root = path.resolve(fileURLToPath(new URL('..', import.meta.url)))
@@ -66,10 +67,10 @@ function parseJsonArrayOutput(output, command) {
 
 // A release gate can reuse one immutable candidate across Node versions.
 const suppliedTarball = process.argv[2] ? path.resolve(process.argv[2]) : null
-// Exercise each supported host group against the same immutable candidate.
-const toolsVersion = process.argv[3] ?? '0.2.1-rc.2'
-const supportedToolsVersions = packageJson.peerDependencies['@deepseek-ai/dsh-tools'].split(' || ')
-assert.ok(supportedToolsVersions.includes(toolsVersion), 'smoke requires an explicitly supported DSH tools version')
+// Exercise a selected host version against the same immutable candidate.
+const toolsVersion = process.argv[3] ?? '0.2.1-rc.3'
+const toolsRange = packageJson.peerDependencies['@deepseek-ai/dsh-tools']
+assert.ok(semver.satisfies(toolsVersion, toolsRange, { includePrerelease: true }), 'smoke requires a DSH tools version matching the peer range')
 const packed = suppliedTarball ? null : parseJsonArrayOutput(run(npm, ['pack', '--ignore-scripts', '--json'], root), 'npm pack')
 if (packed) assert.equal(packed.length, 1, 'npm pack must produce exactly one artifact')
 const tarball = suppliedTarball ?? path.resolve(root, packed[0].filename)
@@ -97,7 +98,11 @@ for (const file of expectedFiles) assert.ok(listed.has(file), `tarball is missin
 const smokeDir = mkdtempSync(path.join(os.tmpdir(), 'dsh-code-index-release-'))
 try {
   run(npm, ['init', '--yes'], smokeDir)
-  run(npm, ['install', '--ignore-scripts', '--no-save', tarball, `@deepseek-ai/dsh-tools@${toolsVersion}`], smokeDir)
+  // npm's default peer checks exclude prereleases that DSH explicitly accepts.
+  // --force only prepares this disposable runtime fixture; it does not prove
+  // normal npm peer resolution. The range assertion above uses DSH's rules.
+  console.log('smoke fixture: npm --force bypasses peer resolution; validating DSH range and runtime only')
+  run(npm, ['install', '--ignore-scripts', '--no-save', '--force', tarball, `@deepseek-ai/dsh-tools@${toolsVersion}`], smokeDir)
 
   const installedPackage = JSON.parse(
     readFileSync(path.join(smokeDir, 'node_modules', packageJson.name, 'package.json'), 'utf8'),
@@ -108,7 +113,7 @@ try {
   assert.match(installedPackage.engines.node, />=22/)
   assert.equal(installedPackage.license, 'MIT')
   const installedTools = JSON.parse(readFileSync(path.join(smokeDir, 'node_modules', '@deepseek-ai', 'dsh-tools', 'package.json'), 'utf8'))
-  assert.equal(installedTools.version, toolsVersion, 'consumer must use the selected matching RC group')
+  assert.equal(installedTools.version, toolsVersion, 'consumer must use the selected DSH tools version')
 
   const plugin = await import(
     pathToFileURL(path.join(smokeDir, 'node_modules', packageJson.name, 'dist', 'index.js')).href,
@@ -294,6 +299,8 @@ try {
     assert.ok(rustSymbols.value.some(symbol => symbol.name === 'CrateOnly' && symbol.signature === 'CrateOnly' && !symbol.exported))
     assert.ok(rustSymbols.value.some(symbol => symbol.name === 'Restricted' && symbol.signature === 'Restricted' && !symbol.exported))
     const rustMap = await nativeInvoke('code_map', { repoRoot: rustRoot })
+    const health = await nativeInvoke('code_health', { repoRoot: rustRoot })
+    assert.match(health.value, /repo health/)
     for (const name of ['PublicOne', 'PublicEnum', 'PublicTrait']) {
       const search = await nativeInvoke('code_search', { query: name, repoRoot: rustRoot })
       assert.equal(search.value[0]?.name, name)
@@ -337,7 +344,7 @@ try {
     for (const dispose of nativeDisposers.reverse()) dispose()
     await nativeContext.fiber.dispose()
   }
-  console.log(`release smoke passed for ${packageJson.name}@${packageJson.version} with dsh-tools@${toolsVersion}`)
+  console.log(`release smoke passed (DSH range/runtime; npm peer resolution bypassed) for ${packageJson.name}@${packageJson.version} with dsh-tools@${toolsVersion}`)
 } finally {
   rmSync(smokeDir, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 })
   if (!suppliedTarball) rmSync(tarball, { force: true })