@xrkseek/harness-cli 0.0.11 → 0.1.1

package/node_modules/@xrkseek/xrk-file-reference/dist/grammar.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Browser-safe `@file` token grammar shared by terminal and web clients.
+ *
+ * @module @xrkseek/xrk-file-reference/grammar
+ */
+import type { FileReferenceCandidate } from './types.js';
+/** Active `@` token ending at the editor cursor. */
+export interface ActiveAtToken {
+    /** Complete token replaced when the user accepts a completion. */
+    prefix: string;
+    /** Path query after `@` or `@"`. */
+    query: string;
+    /** Whether the user opened a quoted path. */
+    quoted: boolean;
+}
+/**
+ * Extract an `@path` or `@"path with spaces` token at the cursor. An `@`
+ * inside another token, such as an email address, is not a completion trigger.
+ * @param line - current editor line.
+ * @param cursorCol - cursor column within that line.
+ * @returns the active token, or `undefined` outside an `@` token.
+ */
+export declare function activeAtToken(line: string, cursorCol: number): ActiveAtToken | undefined;
+/**
+ * Format a selected path as prompt text. Whitespace uses the quoted
+ * `@"path"` grammar; a quoted directory keeps that quote open after its
+ * trailing slash so completion can descend another level.
+ * @param candidate - selected file or directory.
+ * @param preserveQuote - retain an explicitly opened quote even when unnecessary.
+ * @returns the insertion value, or `undefined` for a path the editor grammar cannot represent safely.
+ */
+export declare function formatFileMention(candidate: FileReferenceCandidate, preserveQuote: boolean): string | undefined;
+//# sourceMappingURL=grammar.d.ts.map

package/node_modules/@xrkseek/xrk-file-reference/dist/grammar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar.d.ts","sourceRoot":"","sources":["../src/grammar.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAExD,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAA;IACd,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CASxF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,sBAAsB,EACjC,aAAa,EAAE,OAAO,GACrB,MAAM,GAAG,SAAS,CAOpB"}

package/node_modules/@xrkseek/xrk-file-reference/dist/grammar.js

@@ -0,0 +1,43 @@
+/**
+ * Browser-safe `@file` token grammar shared by terminal and web clients.
+ *
+ * @module @xrkseek/xrk-file-reference/grammar
+ */
+/**
+ * Extract an `@path` or `@"path with spaces` token at the cursor. An `@`
+ * inside another token, such as an email address, is not a completion trigger.
+ * @param line - current editor line.
+ * @param cursorCol - cursor column within that line.
+ * @returns the active token, or `undefined` outside an `@` token.
+ */
+export function activeAtToken(line, cursorCol) {
+    const beforeCursor = line.slice(0, cursorCol);
+    const quoted = /(?:^|\s)(@"([^"]*))$/u.exec(beforeCursor);
+    if (quoted?.[1] !== undefined && quoted[2] !== undefined) {
+        return { prefix: quoted[1], query: quoted[2], quoted: true };
+    }
+    const plain = /(?:^|\s)(@([^\s]*))$/u.exec(beforeCursor);
+    if (plain?.[1] === undefined || plain[2] === undefined)
+        return undefined;
+    return { prefix: plain[1], query: plain[2], quoted: false };
+}
+/**
+ * Format a selected path as prompt text. Whitespace uses the quoted
+ * `@"path"` grammar; a quoted directory keeps that quote open after its
+ * trailing slash so completion can descend another level.
+ * @param candidate - selected file or directory.
+ * @param preserveQuote - retain an explicitly opened quote even when unnecessary.
+ * @returns the insertion value, or `undefined` for a path the editor grammar cannot represent safely.
+ */
+export function formatFileMention(candidate, preserveQuote) {
+    const path = candidate.kind === 'directory' ? `${candidate.path}/` : candidate.path;
+    if (/[\u0000-\u001f\u007f-\u009f"]/u.test(path))
+        return undefined;
+    const quoted = preserveQuote || /\s/u.test(path);
+    if (!quoted)
+        return `@${path}`;
+    if (candidate.kind === 'directory')
+        return `@"${path}`;
+    return `@"${path}"`;
+}
+//# sourceMappingURL=grammar.js.map

package/node_modules/@xrkseek/xrk-file-reference/dist/grammar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar.js","sourceRoot":"","sources":["../src/grammar.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,SAAiB;IAC3D,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;IAC7C,MAAM,MAAM,GAAG,uBAAuB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IACzD,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACzD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;IAC9D,CAAC;IACD,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IACxD,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACxE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;AAC7D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAiC,EACjC,aAAsB;IAEtB,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAA;IACnF,IAAI,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAA;IACjE,MAAM,MAAM,GAAG,aAAa,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,IAAI,EAAE,CAAA;IAC9B,IAAI,SAAS,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,KAAK,IAAI,EAAE,CAAA;IACtD,OAAO,KAAK,IAAI,GAAG,CAAA;AACrB,CAAC"}

package/node_modules/@xrkseek/xrk-file-reference/dist/types.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Public file-reference discovery records. This module contains types only so
+ * generated Remote clients can consume it without Host runtime code.
+ * @module @xrkseek/xrk-file-reference/types
+ */
+/** One path-only completion candidate inside the target session cwd. */
+export interface FileReferenceCandidate {
+    /** User-facing path accepted by normal prompts and filesystem tools. */
+    path: string;
+    /** Directories keep completion open; files finish the mention. */
+    kind: 'file' | 'directory';
+}
+//# sourceMappingURL=types.d.ts.map

package/node_modules/@xrkseek/xrk-file-reference/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wEAAwE;AACxE,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAA;IACZ,kEAAkE;IAClE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;CAC3B"}

package/node_modules/@xrkseek/xrk-file-reference/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Public file-reference discovery records. This module contains types only so
+ * generated Remote clients can consume it without Host runtime code.
+ * @module @xrkseek/xrk-file-reference/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/node_modules/@xrkseek/xrk-file-reference/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/node_modules/@xrkseek/xrk-file-reference/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@xrkseek/xrk-file-reference",
+  "description": "File-reference discovery contract and shared @file grammar",
+  "version": "0.1.1-rc.2",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xrkseek/XRK-harness.git",
+    "directory": "packages/context/file-reference"
+  },
+  "type": "module",
+  "exports": {
+    "./grammar": {
+      "types": "./dist/grammar.d.ts",
+      "import": "./dist/grammar.js",
+      "default": "./dist/grammar.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "default": "./dist/types.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README.zh.md"
+  ],
+  "license": "MIT",
+  "private": true
+}

package/node_modules/@xrkseek/xrk-file-reference-local/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# after editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write packages/context/file-reference-local/README.md
+README.md: 67b07eef4b59fdcc5e21104cac4628feb1c15f4e
+README.zh.md: beded13250daf041294e4e2656d0e1374407ff94

package/node_modules/@xrkseek/xrk-file-reference-local/README.md

@@ -0,0 +1,45 @@
+# `@xrkseek/xrk-file-reference-local`
+
+English | [中文](README.zh.md)
+
+Local-filesystem implementation of `ctx.fileReferences`. It maintains one bounded `WorkspaceFileSearch` per agent, rooted at that session's `cwd` and falling back to the host process cwd. The index ranks direct directory listings for queries containing `/`, otherwise fuzzy-ranks a bounded recursive index; it never follows directory symlinks.
+
+Tool-result events invalidate the addressed agent's reusable index so later completion observes likely workspace mutations. Agent disposal releases that index and its scoped prompt contribution; plugin disposal awaits every prompt fiber and releases all cached searches.
+
+## Configuration
+
+| Key | Default | Contract |
+|---|---:|---|
+| `maxResults` | `20` | Maximum ranked candidates returned for one query. |
+| `maxEntries` | `10000` | Maximum files and directories indexed per agent workspace. |
+| `excludedDirectories` | `[".git", "node_modules"]` | Directory basenames omitted from traversal and candidates. |
+
+Every numeric value must be a positive safe integer. Excluded names must be non-empty basenames without `/` or `\`.
+
+## Model Experience
+
+### File-reference guidance when `read` is available
+
+#### What the model sees
+
+When the addressed agent has an effective `read` tool, the provider contributes this stable system-prompt section:
+
+##### File-reference instruction
+
+```markdown
+Paths prefixed with @ are files explicitly referenced by the user. Use the read tool when their contents are needed; do not claim to have inspected a file before reading it.
+```
+
+#### Token effect
+
+Conditional and fixed: the one sentence is present while `read` is visible to the addressed agent; candidate lookup itself adds no tokens, and a selected path contributes only its ordinary user-message characters.
+
+#### KV Cache effect
+
+The stable sentence joins the system-prompt prefix. Mounting or removing this provider, or changing whether `read` is visible, changes that prefix; queries, candidates, and index invalidations do not.
+
+## Known Limitations and Deferred Work
+
+- **Host-local namespace** — the provider scans the Harness host filesystem, so remote or virtual `read` implementations require a provider whose namespace matches the tool.
+- **Bounded advisory index** — very large workspaces may omit paths after `maxEntries`, and excluded or unreadable directories do not appear.
+- **No ignore-file semantics** — `.gitignore` and other project ignore files do not influence discovery; only configured directory basenames are excluded.

package/node_modules/@xrkseek/xrk-file-reference-local/README.zh.md

@@ -0,0 +1,45 @@
+# `@xrkseek/xrk-file-reference-local`
+
+[English](README.md) | 中文
+
+`ctx.fileReferences` 的本地文件系统实现。它为每个 agent（智能体）维护一个有界的 `WorkspaceFileSearch`，以该会话的 `cwd` 为根目录；缺少该值时回退到宿主进程的 cwd。查询包含 `/` 时，索引会对直接列出的目录项排序；否则会对有界递归索引进行模糊排序。索引永远不会跟随目录符号链接。
+
+工具结果事件会使指定 agent 的可复用索引失效，使后续补全能够反映工作区中可能发生的变更。agent 的 dispose（资源释放）会释放该索引及其作用域内的提示词贡献；插件 dispose 会等待所有提示词 fiber，并释放全部缓存的搜索器。
+
+## 配置
+
+| 配置键 | 默认值 | 契约 |
+|---|---:|---|
+| `maxResults` | `20` | 单次查询返回的候选项最大数量。 |
+| `maxEntries` | `10000` | 每个 agent 工作区建立索引的文件和目录最大数量。 |
+| `excludedDirectories` | `[".git", "node_modules"]` | 遍历和候选项中排除的目录基名。 |
+
+所有数值都必须是正的安全整数。排除名称必须是非空基名，且不能包含 `/` 或 `\`。
+
+## 模型体验
+
+### `read` 可用时的文件引用指引
+
+#### 模型看到什么
+
+当指定 agent 有实际生效的 `read` 工具时，提供方会贡献以下稳定的系统提示词段：
+
+##### 文件引用指令
+
+```markdown
+Paths prefixed with @ are files explicitly referenced by the user. Use the read tool when their contents are needed; do not claim to have inspected a file before reading it.
+```
+
+#### Token 影响
+
+该影响有条件且固定：只要 `read` 对指定 agent 可见，这一句就会存在；候选查询本身不增加 token，所选路径只会贡献普通用户消息中的对应字符。
+
+#### KV 缓存影响
+
+该稳定句子会加入系统提示词前缀。挂载或移除此提供方，或者改变 `read` 是否可见，都会改变该前缀；查询、候选项和索引失效不会改变前缀。
+
+## 已知限制与暂缓事项
+
+- **宿主本地命名空间**：提供方扫描 Harness 宿主的文件系统，因此远程或虚拟 `read` 实现需要使用命名空间与该工具一致的提供方。
+- **有界的提示性索引**：超大型工作区可能省略 `maxEntries` 之后的路径；被排除或无法读取的目录不会出现。
+- **没有忽略文件语义**：`.gitignore` 和其他项目忽略文件不会影响发现；系统只排除已配置的目录基名。

package/node_modules/@xrkseek/xrk-file-reference-local/dist/search.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Host-workspace discovery for `@file` completion. The index contains paths
+ * only: selected values remain ordinary prompt text and file contents stay
+ * behind the model-facing `read` tool.
+ *
+ * @module @xrkseek/xrk-file-reference-local/search
+ */
+import type { FileReferenceCandidate } from '@xrkseek/xrk-file-reference/types';
+export { activeAtToken, formatFileMention } from '@xrkseek/xrk-file-reference/grammar';
+/** Default maximum file and directory candidates rendered for one query. */
+export declare const DEFAULT_FILE_SEARCH_MAX_RESULTS = 20;
+/** Default maximum entries retained in one workspace search index. */
+export declare const DEFAULT_FILE_SEARCH_MAX_ENTRIES = 10000;
+/** Directory basenames omitted from traversal unless the deployment overrides them. */
+export declare const DEFAULT_FILE_SEARCH_EXCLUDED_DIRECTORIES: readonly [".git", "node_modules"];
+/** Resolved limits and exclusions for one workspace index. */
+export interface FileSearchConfig {
+    /** Maximum ranked candidates returned for one query. */
+    maxResults: number;
+    /** Maximum indexed files and directories. */
+    maxEntries: number;
+    /** Directory basenames never traversed or offered. */
+    excludedDirectories: readonly string[];
+}
+/**
+ * Cancellable, reusable fuzzy index rooted at one agent working directory.
+ * Directory-scoped queries list live state; bare fuzzy queries share one
+ * bounded traversal until the `@` interaction ends or a tool result invalidates it.
+ */
+export declare class WorkspaceFileSearch {
+    private readonly root;
+    private readonly config;
+    private readonly excludedDirectories;
+    private generation;
+    private disposed;
+    constructor(root: string, config: FileSearchConfig);
+    /**
+     * Return ranked path candidates for the current token.
+     * @param rawQuery - path text following `@` or `@"`.
+     * @param signal - cancels this caller's wait without killing an index shared by a newer query.
+     * @returns at most `maxResults` deterministic candidates.
+     */
+    list(rawQuery: string, signal: AbortSignal): Promise<FileReferenceCandidate[]>;
+    /** Discard the current index so the next bare query observes a fresh tree. */
+    invalidate(): void;
+    /** Abort traversal and make later queries return no candidates. */
+    dispose(): void;
+    private ensureIndex;
+    private scanWorkspace;
+    private listDirectory;
+}
+//# sourceMappingURL=search.d.ts.map

package/node_modules/@xrkseek/xrk-file-reference-local/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAA;AAE/E,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAA;AAEtF,4EAA4E;AAC5E,eAAO,MAAM,+BAA+B,KAAK,CAAA;AACjD,sEAAsE;AACtE,eAAO,MAAM,+BAA+B,QAAS,CAAA;AACrD,uFAAuF;AACvF,eAAO,MAAM,wCAAwC,mCAAoC,CAAA;AAEzF,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAA;IAClB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAA;CACvC;AAcD;;;;GAIG;AACH,qBAAa,mBAAmB;IAM5B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;IACzD,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,QAAQ,CAAQ;gBAGL,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,gBAAgB;IAc3C;;;;;OAKG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAkBpF,8EAA8E;IAC9E,UAAU,IAAI,IAAI;IAKlB,mEAAmE;IACnE,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,WAAW;YAgBL,aAAa;YA2Bb,aAAa;CAqB5B"}

package/node_modules/@xrkseek/xrk-file-reference-local/dist/search.js

@@ -0,0 +1,258 @@
+/**
+ * Host-workspace discovery for `@file` completion. The index contains paths
+ * only: selected values remain ordinary prompt text and file contents stay
+ * behind the model-facing `read` tool.
+ *
+ * @module @xrkseek/xrk-file-reference-local/search
+ */
+import { lstat, readdir } from 'node:fs/promises';
+import { isAbsolute, join, relative, resolve, sep } from 'node:path';
+export { activeAtToken, formatFileMention } from '@xrkseek/xrk-file-reference/grammar';
+/** Default maximum file and directory candidates rendered for one query. */
+export const DEFAULT_FILE_SEARCH_MAX_RESULTS = 20;
+/** Default maximum entries retained in one workspace search index. */
+export const DEFAULT_FILE_SEARCH_MAX_ENTRIES = 10_000;
+/** Directory basenames omitted from traversal unless the deployment overrides them. */
+export const DEFAULT_FILE_SEARCH_EXCLUDED_DIRECTORIES = ['.git', 'node_modules'];
+/**
+ * Cancellable, reusable fuzzy index rooted at one agent working directory.
+ * Directory-scoped queries list live state; bare fuzzy queries share one
+ * bounded traversal until the `@` interaction ends or a tool result invalidates it.
+ */
+export class WorkspaceFileSearch {
+    root;
+    config;
+    excludedDirectories;
+    generation;
+    disposed = false;
+    constructor(root, config) {
+        this.root = root;
+        this.config = config;
+        if (!Number.isSafeInteger(config.maxResults) || config.maxResults <= 0) {
+            throw new Error('file search maxResults must be a positive safe integer');
+        }
+        if (!Number.isSafeInteger(config.maxEntries) || config.maxEntries <= 0) {
+            throw new Error('file search maxEntries must be a positive safe integer');
+        }
+        if (config.excludedDirectories.some(name => name.length === 0 || name.includes('/') || name.includes('\\'))) {
+            throw new Error('file search excludedDirectories entries must be non-empty directory basenames');
+        }
+        this.excludedDirectories = new Set(config.excludedDirectories);
+    }
+    /**
+     * Return ranked path candidates for the current token.
+     * @param rawQuery - path text following `@` or `@"`.
+     * @param signal - cancels this caller's wait without killing an index shared by a newer query.
+     * @returns at most `maxResults` deterministic candidates.
+     */
+    async list(rawQuery, signal) {
+        signal.throwIfAborted();
+        if (this.disposed)
+            return [];
+        const query = rawQuery.replaceAll('\\', '/');
+        const slash = query.lastIndexOf('/');
+        if (query === '' || slash >= 0) {
+            const directory = slash < 0 ? '' : query.slice(0, slash + 1);
+            const fragment = slash < 0 ? '' : query.slice(slash + 1);
+            return this.listDirectory(directory, fragment, signal);
+        }
+        const indexed = await waitForPromise(this.ensureIndex(), signal);
+        return rankCandidates(indexed.filter(candidate => visibleForGlobalQuery(candidate.path, query)), query, this.config.maxResults);
+    }
+    /** Discard the current index so the next bare query observes a fresh tree. */
+    invalidate() {
+        this.generation?.controller.abort(new Error('file search index invalidated'));
+        this.generation = undefined;
+    }
+    /** Abort traversal and make later queries return no candidates. */
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.invalidate();
+    }
+    ensureIndex() {
+        if (this.generation !== undefined)
+            return this.generation.promise;
+        const controller = new AbortController();
+        const generation = {
+            controller,
+            promise: Promise.resolve([]),
+        };
+        generation.promise = this.scanWorkspace(controller.signal).catch((error) => {
+            /* v8 ignore next -- every owned abort clears `generation` synchronously; this only protects an unexpected scan failure */
+            if (this.generation === generation)
+                this.generation = undefined;
+            throw error;
+        });
+        this.generation = generation;
+        return generation.promise;
+    }
+    async scanWorkspace(signal) {
+        const indexed = [];
+        const directories = [{ absolute: this.root, relative: '' }];
+        for (let cursor = 0; cursor < directories.length && indexed.length < this.config.maxEntries; cursor += 1) {
+            signal.throwIfAborted();
+            const directory = directories[cursor];
+            /* v8 ignore next 3 -- cursor is bounded by this exact queue's length. */
+            if (directory === undefined) {
+                throw new Error('file search selected a missing directory');
+            }
+            const entries = await readDirectory(directory.absolute, signal);
+            for (const entry of entries) {
+                signal.throwIfAborted();
+                const path = directory.relative === '' ? entry.name : `${directory.relative}/${entry.name}`;
+                if (entry.isDirectory()) {
+                    if (this.excludedDirectories.has(entry.name))
+                        continue;
+                    indexed.push({ path, kind: 'directory' });
+                    directories.push({ absolute: join(directory.absolute, entry.name), relative: path });
+                }
+                else if (entry.isFile()) {
+                    indexed.push({ path, kind: 'file' });
+                }
+                if (indexed.length >= this.config.maxEntries)
+                    break;
+            }
+        }
+        return indexed;
+    }
+    async listDirectory(displayDirectory, fragment, signal) {
+        if (displayDirectory.split('/').some(segment => this.excludedDirectories.has(segment)))
+            return [];
+        const absolute = await resolveDisplayDirectory(this.root, displayDirectory, signal);
+        if (absolute === undefined)
+            return [];
+        const entries = await readDirectory(absolute, signal);
+        const candidates = [];
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') && !fragment.startsWith('.'))
+                continue;
+            if (entry.isDirectory()) {
+                if (this.excludedDirectories.has(entry.name))
+                    continue;
+                candidates.push({ path: `${displayDirectory}${entry.name}`, kind: 'directory' });
+            }
+            else if (entry.isFile()) {
+                candidates.push({ path: `${displayDirectory}${entry.name}`, kind: 'file' });
+            }
+        }
+        return rankCandidates(candidates, fragment, this.config.maxResults);
+    }
+}
+async function resolveDisplayDirectory(root, displayDirectory, signal) {
+    const resolvedRoot = resolve(root);
+    const absolute = resolve(resolvedRoot, displayDirectory === '' ? '.' : displayDirectory);
+    const fromRoot = relative(resolvedRoot, absolute);
+    if (fromRoot === '..' || fromRoot.startsWith(`..${sep}`))
+        return undefined;
+    /* v8 ignore next -- only Windows can produce a cross-volume absolute relative path */
+    if (isAbsolute(fromRoot))
+        return undefined;
+    let current = resolvedRoot;
+    for (const segment of fromRoot.split(sep).filter(Boolean)) {
+        signal.throwIfAborted();
+        current = join(current, segment);
+        try {
+            const status = await lstat(current);
+            signal.throwIfAborted();
+            if (status.isSymbolicLink() || !status.isDirectory())
+                return undefined;
+        }
+        catch (_error) {
+            signal.throwIfAborted();
+            return undefined;
+        }
+    }
+    return absolute;
+}
+async function readDirectory(absolute, signal) {
+    signal.throwIfAborted();
+    try {
+        const entries = await readdir(absolute, { withFileTypes: true });
+        signal.throwIfAborted();
+        return entries.sort((left, right) => compareText(left.name, right.name));
+    }
+    catch (_error) {
+        signal.throwIfAborted();
+        // An unreadable/missing subtree contributes no candidates; other readable
+        // branches remain useful and autocomplete is advisory.
+        return [];
+    }
+}
+function visibleForGlobalQuery(path, query) {
+    if (query.startsWith('.') || query.includes('/.'))
+        return true;
+    return !path.split('/').some(segment => segment.startsWith('.'));
+}
+function rankCandidates(candidates, query, limit) {
+    const ranked = [];
+    for (const candidate of candidates) {
+        const score = scoreCandidate(candidate, query);
+        if (score !== undefined)
+            ranked.push({ candidate, score });
+    }
+    ranked.sort((left, right) => right.score - left.score
+        || kindRank(left.candidate.kind) - kindRank(right.candidate.kind)
+        || (query === '' ? 0 : left.candidate.path.length - right.candidate.path.length)
+        || compareText(left.candidate.path, right.candidate.path));
+    return ranked.slice(0, limit).map(entry => entry.candidate);
+}
+function scoreCandidate(candidate, query) {
+    if (query === '')
+        return 0;
+    const path = candidate.path.toLowerCase();
+    const name = path.slice(path.lastIndexOf('/') + 1);
+    const needle = query.toLowerCase();
+    const directoryBonus = candidate.kind === 'directory' ? 25 : 0;
+    if (name === needle)
+        return 1_000 + directoryBonus;
+    if (name.startsWith(needle))
+        return 900 + directoryBonus;
+    if (name.includes(needle))
+        return 700 + directoryBonus;
+    if (path.includes(needle))
+        return 500 + directoryBonus;
+    const subsequence = subsequenceScore(path, needle);
+    return subsequence === undefined ? undefined : 300 + subsequence + directoryBonus;
+}
+function subsequenceScore(target, query) {
+    let targetIndex = 0;
+    let gap = 0;
+    for (const character of query) {
+        const found = target.indexOf(character, targetIndex);
+        if (found < 0)
+            return undefined;
+        gap += found - targetIndex;
+        targetIndex = found + 1;
+    }
+    return Math.max(0, 100 - gap);
+}
+function kindRank(kind) {
+    return kind === 'directory' ? 0 : 1;
+}
+function compareText(left, right) {
+    /* v8 ignore next -- entries and candidates are unique; host enumeration
+     * order determines which comparison direction sort requests. */
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function waitForPromise(promise, signal) {
+    /* v8 ignore next -- `list()` checks this signal immediately before its synchronous call into this helper */
+    if (signal.aborted)
+        return Promise.reject(errorReason(signal.reason, 'file search aborted'));
+    return new Promise((resolvePromise, rejectPromise) => {
+        const onAbort = () => { rejectPromise(errorReason(signal.reason, 'file search aborted')); };
+        signal.addEventListener('abort', onAbort, { once: true });
+        promise.then((value) => {
+            signal.removeEventListener('abort', onAbort);
+            resolvePromise(value);
+        }, (error) => {
+            signal.removeEventListener('abort', onAbort);
+            rejectPromise(errorReason(error, 'file search index failed'));
+        });
+    });
+}
+function errorReason(reason, fallback) {
+    return reason instanceof Error ? reason : new Error(fallback, { cause: reason });
+}
+//# sourceMappingURL=search.js.map

package/node_modules/@xrkseek/xrk-file-reference-local/dist/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"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"}

package/node_modules/@xrkseek/xrk-file-reference-local/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@xrkseek/xrk-file-reference-local",
+  "description": "Local-filesystem ctx.fileReferences provider with bounded fuzzy indexes",
+  "version": "0.1.1-rc.2",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xrkseek/XRK-harness.git",
+    "directory": "packages/context/file-reference-local"
+  },
+  "type": "module",
+  "exports": {
+    "./search": {
+      "types": "./dist/search.d.ts",
+      "import": "./dist/search.js",
+      "default": "./dist/search.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README.zh.md"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@xrkseek/xrk-file-reference": "workspace:*"
+  },
+  "private": true
+}

package/node_modules/@xrkseek/xrk-session-reference/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# after editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write packages/context/session-reference/README.md
+README.md: 1ce5ab0a3b0cb5342c1087ddd644933a92b2a596
+README.zh.md: 2fc30fa01d0e428a2e7ef0be1680a1937f06660c