@x1a0f3n9/dsh-file-reference 0.1.5-rc.5 → 0.1.7-rc.3

package/README.i18n.yaml

@@ -1,6 +1,55 @@
-# 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:
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/context/file-reference/README.md
-README.md: ce84a91e96988fb662ee665707d1ce2ad1651327
-README.zh.md: ffdce668dd1b4a5a39a076d6abc998ec6db2ce92
+/:
+  en: 21c486a1839068f4
+  zh: 0333ad7c4f984794
+/x1a0f3n9-dsh-file-reference:
+  en: ef08ad1a032bcfb9
+  zh: bd224e79fe749bc0
+/x1a0f3n9-dsh-file-reference/summary:
+  en: 3b541adf3b8e5536
+  zh: 2b280a5f97a63cb2
+/x1a0f3n9-dsh-file-reference/table-of-contents:
+  en: d152484eb41ac6b4
+  zh: 09388d293f9be9cb
+/x1a0f3n9-dsh-file-reference/use-this-package:
+  en: e37b5d4bf0020063
+  zh: 2eb37494ea43228f
+/x1a0f3n9-dsh-file-reference/use-this-package/mention-grammar:
+  en: efbe0e9233f402a4
+  zh: e3ec7c6ae2335a41
+/x1a0f3n9-dsh-file-reference/use-this-package/getting-candidates:
+  en: 4dc2d6289f532225
+  zh: af06ce75299f23e5
+/x1a0f3n9-dsh-file-reference/use-this-package/pairing-with-a-provider:
+  en: e2000d7e7cf3fb44
+  zh: d9a7386e26fda52d
+/x1a0f3n9-dsh-file-reference/understand-the-implementation:
+  en: 92049fb7a6c345c3
+  zh: 86efc4d17127f97f
+/x1a0f3n9-dsh-file-reference/understand-the-implementation/design-concept:
+  en: 191332951f81b136
+  zh: 8336659a9ffa20f1
+/x1a0f3n9-dsh-file-reference/understand-the-implementation/source-map:
+  en: c4abf9f6f86cf29f
+  zh: 60d15ef1acd20b93
+/x1a0f3n9-dsh-file-reference/understand-the-implementation/main-flow:
+  en: fd65f309c940de96
+  zh: c1517e592d646d6c
+/x1a0f3n9-dsh-file-reference/further-exploration:
+  en: 90447bd5ebd2c47f
+  zh: dae6d0005ab9779d
+/x1a0f3n9-dsh-file-reference/model-experience:
+  en: ab69d93c10a1572c
+  zh: b63720b1e6182805
+/x1a0f3n9-dsh-file-reference/model-experience/kv-cache-effect:
+  en: 0aba47b2a2828b78
+  zh: 83a1af441dac3074
+/x1a0f3n9-dsh-file-reference/known-limitations-and-deferred-work:
+  en: cc83a00bd7d4ccc9
+  zh: 130ba16bb567db5a
+/x1a0f3n9-dsh-file-reference/known-limitations-and-deferred-work/dev-note:
+  en: e67f633dc6fe7773
+  zh: 3bb0c20c93f16f98

package/README.md

@@ -29,7 +29,7 @@ Choose this package when a host-backed UI (web or terminal) should offer `@file`
 
 ### Mention grammar
 
-An `@path` token at the start of input or after whitespace triggers completion; an `@` inside another token, such as an email address, does not. `@"path with spaces"` opens a quoted mention, and a directory candidate keeps that quote open after its trailing slash so completion can descend another level. The formatter rejects paths with control characters or embedded quotes that the grammar cannot represent safely.
+An `@path` token at the start of input or after whitespace triggers completion; an `@` inside another token, such as an email address, does not. `@"path with spaces"` opens a quoted mention, and a directory candidate keeps that quote open after its trailing slash so completion can descend another level. Completed directory chips close the quote after the trailing slash. Relative mentions resolve from the workspace root; absolute mentions retain the host path. The formatter rejects paths with control characters or embedded quotes that the grammar cannot represent safely.
 
 ### Getting candidates
 

package/README.zh.md

@@ -29,7 +29,7 @@ kind: "package-reference"
 
 ### mention 语法
 
-输入开头或空白后的 `@path` token 会触发补全；其他 token 内部的 `@`（如电子邮件地址）不会。`@"path with spaces"` 打开带引号的 mention，目录候选在其尾斜杠后保持引号打开，使补全可以继续深入下一层。格式化器会拒绝含有语法无法安全表示的控制字符或内嵌引号的路径。
+输入开头或空白后的 `@path` token 会触发补全；其他 token 内部的 `@`（如电子邮件地址）不会。`@"path with spaces"` 打开带引号的 mention，目录候选在其尾斜杠后保持引号打开，使补全可以继续深入下一层。格式化器会拒绝含有语法无法安全表示的控制字符或内嵌引号的路径。 已完成的目录 chip 在末尾斜杠之后闭合引号。相对引用从工作区根目录解析，绝对引用保留主机路径。
 
 ### 获取候选
 

package/lib/index.js

@@ -51,7 +51,7 @@ function formatFileMention(candidate, preserveQuote) {
 * @module @x1a0f3n9/dsh-file-reference
 */
 /** Model guidance for path-only references selected by a user interface. */
-const FILE_REFERENCE_PROMPT = "Tokens prefixed with @ are workspace paths the user explicitly referenced, relative to the workspace root. A trailing slash marks a directory: list it when its contents matter. Anything else is a file: use the read tool when its contents are needed, and do not claim to have inspected it before reading. @\"...\" quotes a path containing spaces.";
+const FILE_REFERENCE_PROMPT = "Tokens prefixed with @ are paths the user explicitly referenced. Relative paths resolve from the workspace root; absolute paths identify files or directories on the host. A trailing slash marks a directory: list it when its contents matter. Anything else is a file: use the read tool when its contents are needed, and do not claim to have inspected it before reading. @\"...\" quotes a path containing spaces.";
 /** Host capability for cancellable file-reference discovery. */
 var FileReferenceService = class extends Service {
 	constructor(ctx) {

package/lib/types/index.d.ts

@@ -10,7 +10,7 @@ export { activeAtToken, formatFileMention } from './grammar.ts';
 export type { ActiveAtToken } from './grammar.ts';
 export type { FileReferenceCandidate } from './types.ts';
 /** Model guidance for path-only references selected by a user interface. */
-export declare const FILE_REFERENCE_PROMPT = "Tokens prefixed with @ are workspace paths the user explicitly referenced, relative to the workspace root. A trailing slash marks a directory: list it when its contents matter. Anything else is a file: use the read tool when its contents are needed, and do not claim to have inspected it before reading. @\"...\" quotes a path containing spaces.";
+export declare const FILE_REFERENCE_PROMPT = "Tokens prefixed with @ are paths the user explicitly referenced. Relative paths resolve from the workspace root; absolute paths identify files or directories on the host. A trailing slash marks a directory: list it when its contents matter. Anything else is a file: use the read tool when its contents are needed, and do not claim to have inspected it before reading. @\"...\" quotes a path containing spaces.";
 declare module '@deepseek-ai/cordis' {
     interface Context {
         fileReferences: FileReferenceService;

package/lib/types/index.js

@@ -6,7 +6,7 @@
 import { Service } from '@deepseek-ai/cordis';
 export { activeAtToken, formatFileMention } from "./grammar.js";
 /** Model guidance for path-only references selected by a user interface. */
-export const FILE_REFERENCE_PROMPT = 'Tokens prefixed with @ are workspace paths the user explicitly referenced, relative to the workspace root. A trailing slash marks a directory: list it when its contents matter. Anything else is a file: use the read tool when its contents are needed, and do not claim to have inspected it before reading. @"..." quotes a path containing spaces.';
+export const FILE_REFERENCE_PROMPT = 'Tokens prefixed with @ are paths the user explicitly referenced. Relative paths resolve from the workspace root; absolute paths identify files or directories on the host. A trailing slash marks a directory: list it when its contents matter. Anything else is a file: use the read tool when its contents are needed, and do not claim to have inspected it before reading. @"..." quotes a path containing spaces.';
 /** Host capability for cancellable file-reference discovery. */
 export class FileReferenceService extends Service {
     constructor(ctx) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@x1a0f3n9/dsh-file-reference",
   "description": "File-reference discovery contract and shared @file grammar",
-  "version": "0.1.5-rc.5",
+  "version": "0.1.7-rc.3",
   "publishConfig": {
     "access": "public"
   },
@@ -36,11 +36,11 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@x1a0f3n9/dsh-agent": "^0.1.5-rc.5",
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@x1a0f3n9/dsh-agent": "0.1.7-rc.3",
+    "@deepseek-ai/cordis": "~4.0.4"
   },
   "devDependencies": {
-    "@x1a0f3n9/dsh-agent": "^0.1.5-rc.5",
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@x1a0f3n9/dsh-agent": "0.1.7-rc.3",
+    "@deepseek-ai/cordis": "~4.0.4"
   }
 }