@trim21/personal-pi-extensions 0.1.501 → 0.1.502

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trim21/personal-pi-extensions",
-  "version": "0.1.501",
+  "version": "0.1.502",
   "type": "module",
   "description": "Custom pi coding-agent extensions: bwrap sandbox, workspace guard, opencode edit, and more",
   "keywords": [

package/src/claude-code/edit.md

@@ -4,7 +4,6 @@ Performs exact string replacements in files.
 
 Usage:
 
-- You must use your Read tool at least once in the conversation before editing. This tool will error if you attempt an edit without reading the file.
 - When editing text from Read tool output, ensure you preserve the exact indentation (tabs/spaces) as it appears AFTER the line number prefix. The line number prefix format is: line number + tab. Everything after that is the actual file content to match. Never include any part of the line number prefix in the old_string or new_string.
 - ALWAYS prefer editing existing files in the codebase. NEVER write new files unless explicitly required.
 - Only use emojis if the user explicitly requests it. Avoid adding emojis to files unless asked.

package/src/claude-code/files.ts

@@ -199,8 +199,9 @@ async function readStateKey(filePath: string): Promise<string> {
 }
 
 /**
- * 校验「已读且未变」。key 与 currentContent 由调用方提供：调用方每次工具调用
- * 只 realpath / readFile 一次，避免重复 IO。
+ * 校验「若曾读过则内容未变」。key 与 currentContent 由调用方提供：调用方每次
+ * 工具调用只 realpath / readFile 一次，避免重复 IO。从未读过时直接放行，
+ * 不强制先 Read；存在已读快照时校验文本可编辑且 digest 一致。
  */
 function requireCurrentRead(
   state: ClaudeCodeState,
@@ -209,9 +210,7 @@ function requireCurrentRead(
   currentContent: Uint8Array,
 ): void {
   const readSnapshot = state.reads.get(key);
-  if (!readSnapshot) {
-    throw new Error("File has not been read yet. Read it first before writing to it.");
-  }
+  if (!readSnapshot) return;
   if (!readSnapshot.textEditable) {
     throw new Error(`Cannot edit or overwrite a binary file with a text tool: ${filePath}`);
   }
@@ -356,7 +355,6 @@ export function registerFileTools(
     label: "Edit",
     description: [
       "Performs exact string replacements in files.",
-      "You must use Read on the file before editing it.",
       "old_string must match exactly and must be unique unless replace_all is true.",
       "This tool does not use regular expressions or fuzzy matching.",
     ].join("\n"),
@@ -572,7 +570,7 @@ export function registerFileTools(
     description: [
       "Writes a file to the local filesystem.",
       "This tool overwrites an existing file with the full content provided.",
-      "If the file exists, you must use Read first. Prefer Edit for partial changes.",
+      "Prefer Edit for partial changes.",
     ].join("\n"),
     promptSnippet: "Create or overwrite files",
     promptGuidelines: [WRITE_PROMPT],
@@ -695,8 +693,8 @@ export default function claudeCodeFileTools(pi: ExtensionAPI, options?: LspServi
   const state = createClaudeCodeState();
 
   // LSP 专属工具（lsp-rename / inspect 族）仅在 lsp.json 存在 enabled 服务器时
-  // 注册（session_start 校验后）；本工具集跟踪 read-before-write 状态，rename
-  // 落盘的文件要标记为已读并随 details 持久化（restoreFileReads 依赖 details.reads）。
+  // 注册（session_start 校验后）；本工具集维护 reads 记账，rename 落盘的文件
+  // 要标记为已读并随 details 持久化（restoreFileReads 依赖 details.reads）。
   const manager = createLspManager(
     pi,
     {

package/src/claude-code/write.md

@@ -5,7 +5,6 @@ Writes a file to the local filesystem.
 Usage:
 
 - This tool will overwrite the existing file if there is one at the provided path.
-- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.
 - Prefer the Edit tool for modifying existing files — it only sends the diff. Only use this tool to create new files or for complete rewrites.
 - NEVER create documentation files (*.md) or README files unless explicitly requested by the User.
 - Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.

package/src/lib/lsp/rename-tool.ts

@@ -5,9 +5,9 @@
  * 这里只负责工具注册与执行编排：按行内候选逐个探测 → canonicalizeEdit 分组
  * 消歧 → expandWorkspaceEdit 内存展开 → 审批 → 写盘 → 诊断。
  *
- * 两个工具集行为一致，唯一差异是 reads 记账：跟踪 read-before-write 状态的
- * 工具集通过 hooks.recordReads 把重命名文件标记为已读并随 details 持久化；
- * 不跟踪该状态的工具集不传 hook。
+ * 两个工具集行为一致，唯一差异是 reads 记账：跟踪已读快照的工具集通过
+ * hooks.recordReads 把重命名文件标记为已读并随 details 持久化；不跟踪
+ * 该状态的工具集不传 hook。
  */
 
 import { readFileSync } from "node:fs";