pi-hashline-edit-pro 4.3.0 → 4.3.2

package/README.md

@@ -160,11 +160,13 @@ Auto-read keeps the same 50KB and 2000-line budget as `read`. Auto-read and Diff
 
 ### Auto-read all
 
-Auto-read all is off by default; enable it in `/hashline-config`. On the first turn of a session, the extension discovers every file in the working directory that is not git-ignored (`git ls-files`, falling back to `ripgrep`, then to a directory walk), reads each one, and attaches the resulting `anchor│content` rows to the conversation as one extension message before the model answers. Those anchors are served exactly like `read` output, so the model can `replace` and `insert` immediately without calling `read` first. The message is injected once per session; resumed, forked, and cloned sessions that already contain it skip the injection.
+Auto-read all is off by default and has three modes, selected in `/hashline-config`: `off` injects nothing, `on` discovers every file in the working directory that is not git-ignored (`git ls-files`, falling back to `ripgrep`, then to a directory walk), and `git` uses `git ls-files` only, injecting nothing when the working directory is not a git repository. On the first turn of a session, the extension discovers the files, reads each one, and attaches the resulting `anchor│content` rows to the conversation as one extension message before the model answers. Those anchors are served exactly like `read` output, so the model can `replace` and `insert` immediately without calling `read` first. The message is injected once per session; resumed, forked, and cloned sessions that already contain it skip the injection.
 
-Files are filtered before injection: symlinks, directories, image extensions, binary files (a NUL byte in the first 8KB), files over 200KB, and any file whose name is in the built-in skip list (currently `package-lock.json`, matched by file name anywhere in the tree) are skipped. The attachment stops at 500 files or at a byte budget derived from the model's context window (200KB floor, 2MB ceiling), and it never drops below one file. Skipped and not-attached files are named at the end of the message so the model can `read` them on demand. A file whose `read` output is truncated keeps its truncation hint, so the rest can be paged in with `read`.
+Files are filtered before injection: symlinks, directories, image extensions (including SVG), binary files (a NUL byte in the first 8KB), files over 200KB, any path with a vendored segment (vendor, node_modules, bower_components, third_party, thirdparty, jspm_packages, .venv, venv, site-packages, __pycache__, .tox, .gradle, .terraform, Pods, Carthage, DerivedData, coreui, coreui-icons, case-insensitive), and vendored or generated names and patterns (*.min.js, *.min.css, *.min.mjs, *-min.js, *-min.css, *.bundle.*, *.chunk.*, *.umd.js, *.map, *.lock, package-lock.json, yarn.lock, composer.lock, Gemfile.lock, Cargo.lock, poetry.lock, Pipfile.lock, go.sum, flake.lock, *.generated.*, *.gen.*, *_pb2.py, *.pb.go, *.g.dart, *.freezed.dart, *.designer.cs, *.g.cs, *.snap, .eslintcache, coreui-icons.*, coreui.css) are skipped. The attachment stops at 500 files or at a byte budget derived from the model context window (200KB floor, 2MB ceiling), and it never drops below one file. Skipped and not-attached files are named at the end of the message so the model can `read` them on demand. A file whose `read` output is truncated keeps its truncation hint, so the rest can be paged in with `read`.
 
-The setting lives in `/hashline-config` as Auto-read all and in `config.json` as `autoReadAll`.
+Each attached file carries a status line: `[complete, N lines; do NOT re-read]` means the section is fully attached and must be edited directly without calling `read`, while `[truncated, showing M of N lines; use read with offset=X to continue]` means only the first bytes are attached. A coverage line after the header reports complete versus truncated counts and the number of 48KB file-boundary chunks the payload splits into, so a host-side cut never tears a file in the middle.
+
+The setting lives in `/hashline-config` as Auto-read all and in `config.json` as `autoReadAll` (`"off"`, `"on"`, or `"git"`; older configs with `true` or `false` are read as `"on"` or `"off"`).
 
 ## Tool result details
 
@@ -181,7 +183,7 @@ All five tools return machine-readable metadata in `details` alongside the model
 
 | Command | Description |
 | --- | --- |
-| `/hashline-config` | Open the settings window: auto-read anchors, auto-read all files, diff context lines, `anchor_grep` tool, required `path`, strict input, and boundary dedup. Persists across sessions. |
+| `/hashline-config` | Open the settings window: auto-read anchors, auto-read all mode, diff context lines, `anchor_grep` tool, required `path`, strict input, and boundary dedup. Persists across sessions. |
 | `/clear-anchors` | Clear the session's anchor claims. Anchors are re-claimed on the next `read`. |
 
 Settings live in `~/.config/pi-hashline-edit-pro/config.json`, created when a setting is first changed in `/hashline-config`:
@@ -189,7 +191,7 @@ Settings live in `~/.config/pi-hashline-edit-pro/config.json`, created when a se
 ```json
 {
   "autoRead": true,
-  "autoReadAll": false,
+  "autoReadAll": "off",
   "anchorGrepEnabled": true,
   "requirePath": false,
   "strictInput": false,

package/index.ts

@@ -11,10 +11,11 @@ import type { RMetrics } from "./src/replace-response";
 import type { ReplaceDetails } from "./src/replace";
 import { extractWarnings } from "./src/replace-render";
 import { MAX_HASH_LINES } from "./src/hashline";
+import type { AutoReadAllMode } from "./src/config";
 import {
   readConfigWithStatus,
   toggleAutoRead,
-  toggleAutoReadAll,
+  cycleAutoReadAllMode,
   toggleAnchorGrep,
   toggleRequirePath,
   toggleStrictInput,
@@ -45,7 +46,7 @@ export default function (pi: ExtensionAPI): void {
   registerWriteHook(pi);
 
   let autoRead = true;
-  let autoReadAll = false;
+  let autoReadAll: AutoReadAllMode = "off";
   let autoReadAllInjected = false;
   let grepWasActive = false;
 
@@ -80,7 +81,7 @@ export default function (pi: ExtensionAPI): void {
     const { config, corrupted } = await readConfigWithStatus();
     if (corrupted && (ctx as { hasUI?: boolean }).hasUI) ctx.ui.notify("Hashline config was corrupt and was reset to defaults", "warning");
     autoRead = config.autoRead;
-    autoReadAll = config.autoReadAll === true;
+    autoReadAll = config.autoReadAll ?? "off";
     const sessionBranch = (ctx as { sessionManager?: { getBranch?: () => Array<{ type?: string; customType?: string }> } }).sessionManager?.getBranch?.() ?? [];
     autoReadAllInjected = sessionBranch.some((entry) => entry.type === "custom_message" && entry.customType === AUTO_READ_ALL_CUSTOM_TYPE);
     await refreshEditTools();
@@ -105,10 +106,10 @@ export default function (pi: ExtensionAPI): void {
   });
 
   pi.on("before_agent_start", async (_event, ctx) => withAnchorSession(ctx, async () => {
-    if (!autoReadAll || autoReadAllInjected) return;
+    if (autoReadAll === "off" || autoReadAllInjected) return;
     autoReadAllInjected = true;
     try {
-      const injection = await buildAutoReadAllInjection(ctx.cwd, autoReadAllBudget(ctx.model));
+      const injection = await buildAutoReadAllInjection(ctx.cwd, autoReadAllBudget(ctx.model), autoReadAll);
       if (!injection) return;
       if (ctx.hasUI) ctx.ui.notify(`Auto-read all: attached ${injection.files} file(s) with anchors`, "info");
       return { message: { customType: AUTO_READ_ALL_CUSTOM_TYPE, content: injection.text, display: false } };
@@ -132,7 +133,7 @@ export default function (pi: ExtensionAPI): void {
           done,
           onToggle: async (key, delta) => {
             if (key === "autoRead") autoRead = await toggleAutoRead();
-            else if (key === "autoReadAll") { autoReadAll = await toggleAutoReadAll(); autoReadAllInjected = false; }
+            else if (key === "autoReadAll") { autoReadAll = await cycleAutoReadAllMode(); autoReadAllInjected = false; }
             else if (key === "diffContextLines") await adjustDiffContextLines(delta ?? 1);
             else if (key === "anchorGrepEnabled") {
               const enabled = await toggleAnchorGrep();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-hashline-edit-pro",
-  "version": "4.3.0",
+  "version": "4.3.2",
   "type": "module",
   "description": "Hash-anchored read/replace/insert/grep tools for pi-coding-agent. Every line gets a unique 4-char tokenizer-friendly anchor that stays stable across edits; stale or ambiguous anchors are rejected, never fuzzy-matched. Undo persists across restarts.",
   "main": "index.ts",

package/prompts/grep.md

@@ -1 +1 @@
-Search text files with ripgrep. Hits and context lines come back as `lineNumber │ anchor│content` rows, editable with replace or insert without a new read; the `=== path ===` header and line numbers locate the match. Searches respect `.gitignore`, always skip `.git`, and skip binary and image files silently. A match over 500 bytes is shown as a `...` fragment around the hit, but its anchor still covers the whole line. When the output says truncated, refine `pattern` or raise `limit`.
+Search text files with ripgrep. Hits and context lines come back as `lineNumber │ anchor│content` rows, editable with replace or insert without a new read; the `=== path ===` header and line numbers locate the match. Searches respect `.gitignore`, always skip `.git`, and skip binary and image files silently. A match over 500 bytes is shown as a `...` fragment around the hit, but its anchor still covers the whole line. When the output says truncated, refine `pattern` or raise `limit` (default 100).

package/prompts/insert-guidelines.md

@@ -1,3 +1,2 @@
 - `insert`: the anchor must have been shown by `read`, a post-edit diff (`+anchor│`/` anchor│`), or any served `anchor│content` row. Empty file: `read` shows one `anchor│` row — insert `after` it.
-- `insert`: same-file calls in one message join the file's batch: earlier calls reply `In batch N`, the last call shows the combined diff.
 - `insert`: a batch may pair one `before` and one `after` on the same anchor line; the pair composes into a single insertion. Any other same-line pair is an overlap.

package/prompts/insert.md

@@ -1 +1 @@
-Insert lines after or before one existing line in a text file, addressed by a bare anchor from read output or a diff row. The anchor line is preserved: `lines` go after it with `direction: "after"` or before it with `direction: "before"`, one string per line, no anchor prefixes, no embedded newlines. Lines are added literally, even when they duplicate neighbors. Multiple `replace`/`insert` calls on the same file in one message form one batch per file with a single combined diff and a single undo.
+Insert lines after or before one existing line in a text file, addressed by a bare anchor from read output or a diff row. The anchor line is preserved: `lines` go after it with `direction: "after"` or before it with `direction: "before"`, one string per line, no anchor prefixes, no embedded newlines. Lines are added literally, even when they duplicate neighbors. Multiple `replace`/`insert` calls on the same file in one message form one batch per file: earlier calls reply `In batch N` and the last call shows the combined diff, with one undo for the whole batch.

package/prompts/replace-guidelines.md

@@ -1,5 +1,5 @@
 - `replace`: edit with `replace`/`insert`, not `sed -i` or heredocs — anchor edits are verified against what was shown and undoable.
 - `replace`: `replacement_lines` takes bare lines without `│`; `[""]` is one blank line; pasted `anchor│` prefixes are stripped automatically (single line: same anchor for `remove_from` and `remove_to`).
-- `replace`: post-edit diff `+anchor│`/` anchor│` rows are fresh anchors for the next edit — no new `read` needed. Same-file calls in one message form one batch with a single combined diff; check each batch diff before the next turn's edits on that file.
+- `replace`: post-edit diff `+anchor│`/` anchor│` rows are fresh anchors for the next edit — no new `read` needed; never anchor on `-anchor│` rows, those anchors were freed by the edit. Check each batch diff before the next turn's edits on that file.
 - `replace`: batched calls must target disjoint ranges and all be valid; an overlap or any failure aborts the whole batch with nothing applied.
 - `replace`: if `replacement_lines` re-include the boundary line adjacent to the range, it is deduplicated automatically, shown as `dedup│content` rows in the diff (not editable, never use `dedup` as an anchor).

package/prompts/undo-last-change-guidelines.md

@@ -1 +1 @@
-- `undo_last_change`: only the last `replace`/`insert` per file is undoable; a `write` clears it, so undo right after a bad diff (check the `-anchor│` lines you wanted to keep).
+- `undo_last_change`: only the last `replace`/`insert` per file is undoable; a `write` clears it, so undo right after a bad diff — review the diff's `-anchor│` rows first to confirm what you're restoring.

package/prompts/undo-last-change-snippet.md

@@ -1 +1 @@
-Undo last `replace`/`insert` on a file; restores deleted file, keeps record on `[E_UNDO_STALE]`
+Single-level undo: reverts a file's last `replace` or `insert`

package/src/auto-read-all.ts

@@ -9,6 +9,7 @@ import {
   AUTO_READ_ALL_MIN_BUDGET_BYTES,
   SNIFF_BYTES,
 } from "./constants";
+import type { AutoReadAllMode } from "./config";
 import { serveRows } from "./served";
 import { readNormFile } from "./file-reader";
 import { resolveRgPath } from "./grep";
@@ -21,9 +22,10 @@ const EXEC_MAX_BYTES = 64 * 1024 * 1024;
 const SCAN_CONCURRENCY = 32;
 const SCAN_LIMIT_MULTIPLIER = 4;
 const MAX_REPORTED_OMISSIONS = 50;
+export const AUTO_READ_ALL_CHUNK_BYTES = 48 * 1024;
 
 const HEADER =
-  "[hashline auto-read-all] The content of every non-ignored project file is attached below with live hashline anchors. Each anchor│content row is already owned and served for this session, so replace and insert can target those anchors directly without calling read first. Rows with a truncation hint are only partially shown; call read with the hinted offset to see the rest.";
+  "[hashline auto-read-all] The content of every non-ignored project file is attached below with live hashline anchors. Each anchor│content row is already owned and served for this session, so replace and insert can target those anchors directly without calling read first. Sections marked [complete] are fully attached; do NOT call read for them. Only sections marked [truncated] need read. Rows with a truncation hint are only partially shown; call read with the hinted offset to see the rest.";
 
 const IMAGE_EXTENSIONS = new Set([
   ".avif",
@@ -37,14 +39,71 @@ const IMAGE_EXTENSIONS = new Set([
   ".jxl",
   ".png",
   ".psd",
+  ".svg",
   ".tif",
   ".tiff",
   ".webp",
 ]);
 
-export const AUTO_READ_ALL_EXCLUDED_NAMES = ["package-lock.json"];
-
+export const AUTO_READ_ALL_EXCLUDED_SEGMENTS = [
+  "vendor",
+  "node_modules",
+  "bower_components",
+  "third_party",
+  "thirdparty",
+  "jspm_packages",
+  ".venv",
+  "venv",
+  "site-packages",
+  "__pycache__",
+  ".tox",
+  ".gradle",
+  ".terraform",
+  "pods",
+  "carthage",
+  "deriveddata",
+  "coreui",
+  "coreui-icons",
+];
+export const AUTO_READ_ALL_EXCLUDED_NAMES = [
+  "package-lock.json",
+  "yarn.lock",
+  "composer.lock",
+  "gemfile.lock",
+  "cargo.lock",
+  "poetry.lock",
+  "pipfile.lock",
+  "go.sum",
+  "flake.lock",
+  ".eslintcache",
+];
 const EXCLUDED_NAME_SET = new Set(AUTO_READ_ALL_EXCLUDED_NAMES);
+const EXCLUDED_SEGMENT_SET = new Set(AUTO_READ_ALL_EXCLUDED_SEGMENTS);
+function isExcludedBySegment(path: string): boolean {
+  for (const segment of path.split("/")) {
+    if (EXCLUDED_SEGMENT_SET.has(segment.toLowerCase())) return true;
+  }
+  return false;
+}
+function isExcludedByPattern(baseLower: string): boolean {
+  if (baseLower.endsWith(".min.js") || baseLower.endsWith(".min.css") || baseLower.endsWith(".min.mjs")) return true;
+  if (baseLower.endsWith("-min.js") || baseLower.endsWith("-min.css")) return true;
+  if (baseLower.includes(".bundle.") || baseLower.includes(".chunk.")) return true;
+  if (baseLower.endsWith(".umd.js")) return true;
+  if (baseLower.endsWith(".map")) return true;
+  if (baseLower.endsWith(".lock")) return true;
+  if (baseLower.includes(".generated.") || baseLower.includes(".gen.")) return true;
+  if (baseLower.endsWith("_pb2.py")) return true;
+  if (baseLower.endsWith(".pb.go")) return true;
+  if (baseLower.endsWith(".g.dart")) return true;
+  if (baseLower.endsWith(".freezed.dart")) return true;
+  if (baseLower.endsWith(".designer.cs")) return true;
+  if (baseLower.endsWith(".g.cs")) return true;
+  if (baseLower.endsWith(".snap")) return true;
+  if (baseLower.startsWith("coreui-icons.")) return true;
+  if (baseLower === "coreui.css") return true;
+  return false;
+}
 
 const WALK_IGNORED_DIRS = new Set([
   ".git",
@@ -78,11 +137,22 @@ export interface AutoReadAllDiscovery {
   skippedByName: number;
 }
 
+export interface AutoReadAllSection {
+  file: string;
+  text: string;
+  complete: boolean;
+  totalLines: number;
+  shownLines: number;
+  nextOffset?: number;
+}
 export interface AutoReadAllInjection {
   text: string;
   files: number;
   bytes: number;
   omitted: string[];
+  chunks: string[];
+  completeFiles: number;
+  truncatedFiles: number;
 }
 
 function runCommand(command: string, args: string[], cwd: string): Promise<{ stdout: string; code: number }> {
@@ -128,7 +198,7 @@ async function walkDir(dir: string, base: string, out: string[]): Promise<void>
     if (entry.isSymbolicLink()) continue;
     const full = join(dir, entry.name);
     if (entry.isDirectory()) {
-      if (WALK_IGNORED_DIRS.has(entry.name)) continue;
+      if (WALK_IGNORED_DIRS.has(entry.name) || EXCLUDED_SEGMENT_SET.has(entry.name.toLowerCase())) continue;
       await walkDir(full, base, out);
     } else if (entry.isFile()) {
       out.push(toPosix(relative(base, full)));
@@ -180,10 +250,13 @@ async function forEachLimit<T>(items: T[], limit: number, work: (item: T) => Pro
   await Promise.all(workers);
 }
 
-export async function discoverAutoReadAllFiles(cwd: string): Promise<AutoReadAllDiscovery> {
+export async function discoverAutoReadAllFiles(cwd: string, mode: AutoReadAllMode = "on"): Promise<AutoReadAllDiscovery> {
   let source: AutoReadAllSource = "git";
   let candidates = await listFromGit(cwd);
   if (candidates === undefined) {
+    if (mode === "git") {
+      return { files: [], source: "git", discovered: 0, skippedBinary: 0, skippedLarge: 0, skippedOther: 0, skippedByName: 0 };
+    }
     candidates = await listFromRg(cwd);
     source = "rg";
   }
@@ -198,7 +271,8 @@ export async function discoverAutoReadAllFiles(cwd: string): Promise<AutoReadAll
   const includable: string[] = [];
   let skippedByName = 0;
   for (const file of unique) {
-    if (EXCLUDED_NAME_SET.has(baseNameOf(file).toLowerCase())) skippedByName += 1;
+    const baseLower = baseNameOf(file).toLowerCase();
+    if (EXCLUDED_NAME_SET.has(baseLower) || isExcludedBySegment(file) || isExcludedByPattern(baseLower)) skippedByName += 1;
     else includable.push(file);
   }
   const scanWindow = includable.slice(0, AUTO_READ_ALL_MAX_FILES * SCAN_LIMIT_MULTIPLIER);
@@ -243,12 +317,34 @@ export async function discoverAutoReadAllFiles(cwd: string): Promise<AutoReadAll
   return { files, source, discovered: unique.length, skippedBinary, skippedLarge, skippedOther, skippedByName };
 }
 
-async function renderFile(file: string, cwd: string): Promise<string | undefined> {
+export function chunkAutoReadAllSections(sections: string[], maxBytes: number = AUTO_READ_ALL_CHUNK_BYTES): string[] {
+  const chunks: string[] = [];
+  let current: string[] = [];
+  let currentBytes = 0;
+  for (const section of sections) {
+    const sectionBytes = Buffer.byteLength(section, "utf-8") + 2;
+    if (current.length > 0 && currentBytes + sectionBytes > maxBytes) {
+      chunks.push(current.join("\n\n"));
+      current = [];
+      currentBytes = 0;
+    }
+    current.push(section);
+    currentBytes += sectionBytes;
+  }
+  if (current.length > 0) chunks.push(current.join("\n\n"));
+  return chunks;
+}
+async function renderFile(file: string, cwd: string): Promise<AutoReadAllSection | undefined> {
   try {
     const { normalized, fileHashes, absolutePath } = await readNormFile(file, cwd, { maxLines: MAX_HASH_LINES });
     const preview = await fmtReadPreview(normalized, {}, fileHashes, absolutePath, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES);
     serveRows(absolutePath, fileHashes, splitLines(normalized), preview.servedHashes);
-    return `=== ${file} ===\n${preview.text}`;
+    const totalLines = fileHashes.length;
+    const shownLines = preview.servedHashes.length;
+    const complete = preview.truncation === undefined && preview.nextOffset === undefined && shownLines >= totalLines;
+    const status = complete ? `[complete, ${totalLines} lines; do NOT re-read]` : `[truncated, showing ${shownLines} of ${totalLines} lines; use read with offset=${preview.nextOffset ?? shownLines + 1} to continue]`;
+    const nextOffset = preview.nextOffset;
+    return { file, text: `=== ${file} ===\n${status}\n${preview.text}`, complete, totalLines, shownLines, ...(nextOffset !== undefined ? { nextOffset } : {}) };
   } catch (error) {
     console.error(`Auto-read all: skipped ${file}:`, error);
     return undefined;
@@ -265,7 +361,7 @@ function buildFooter(attached: number, discovery: AutoReadAllDiscovery, omitted:
   if (discovery.skippedBinary > 0) notes.push(`${discovery.skippedBinary} binary or image file(s) skipped`);
   if (discovery.skippedLarge > 0) notes.push(`${discovery.skippedLarge} file(s) over ${formatSize(AUTO_READ_ALL_MAX_FILE_BYTES)} skipped`);
   if (discovery.skippedOther > 0) notes.push(`${discovery.skippedOther} unreadable path(s) skipped`);
-  if (discovery.skippedByName > 0) notes.push(`${discovery.skippedByName} file(s) skipped by name (${AUTO_READ_ALL_EXCLUDED_NAMES.join(", ")})`);
+  if (discovery.skippedByName > 0) notes.push(`${discovery.skippedByName} file(s) skipped by vendor/name/pattern rules`);
   const listed = omitted.slice(0, MAX_REPORTED_OMISSIONS).join(", ");
   const more = omitted.length > MAX_REPORTED_OMISSIONS ? `, ... (+${omitted.length - MAX_REPORTED_OMISSIONS} more)` : "";
   const omissionNote = omitted.length > 0 ? ` Not attached: ${listed}${more}. Use read for those.` : "";
@@ -273,29 +369,36 @@ function buildFooter(attached: number, discovery: AutoReadAllDiscovery, omitted:
   return `[hashline auto-read-all: ${attached} file(s) attached from ${discovery.source}; ${summary}${omissionNote}]`;
 }
 
-export async function buildAutoReadAllInjection(cwd: string, budgetBytes: number): Promise<AutoReadAllInjection | undefined> {
-  const discovery = await discoverAutoReadAllFiles(cwd);
+export async function buildAutoReadAllInjection(cwd: string, budgetBytes: number, mode: AutoReadAllMode = "on"): Promise<AutoReadAllInjection | undefined> {
+  const discovery = await discoverAutoReadAllFiles(cwd, mode);
   if (discovery.files.length === 0) return undefined;
-  const sections: string[] = [];
+  const sections: AutoReadAllSection[] = [];
   const omitted: string[] = [];
   let bytes = 0;
+  let completeFiles = 0;
+  let truncatedFiles = 0;
   for (const file of discovery.files) {
     const section = await renderFile(file, cwd);
     if (section === undefined) {
       omitted.push(file);
       continue;
     }
-    const sectionBytes = Buffer.byteLength(section, "utf-8") + 1;
+    const sectionBytes = Buffer.byteLength(section.text, "utf-8") + 1;
     if (sections.length > 0 && bytes + sectionBytes > budgetBytes) {
       omitted.push(file);
       continue;
     }
     sections.push(section);
     bytes += sectionBytes;
+    if (section.complete) completeFiles += 1;
+    else truncatedFiles += 1;
   }
   if (sections.length === 0) return undefined;
-  const text = `${HEADER}\n\n${sections.join("\n\n")}\n\n${buildFooter(sections.length, discovery, omitted)}`;
-  return { text, files: sections.length, bytes, omitted };
+  const sectionTexts = sections.map((section) => section.text);
+  const chunks = chunkAutoReadAllSections(sectionTexts);
+  const coverage = `[coverage: ${completeFiles} complete, ${truncatedFiles} truncated, ${chunks.length} chunk(s) x 48KB with file boundaries preserved; do NOT re-read complete files]`;
+  const text = `${HEADER}\n\n${coverage}\n\n${sectionTexts.join("\n\n")}\n\n${buildFooter(sections.length, discovery, omitted)}`;
+  return { text, files: sections.length, bytes, omitted, chunks, completeFiles, truncatedFiles };
 }
 
 export function autoReadAllBudget(model: { contextWindow?: number } | undefined): number {

package/src/config-ui.ts

@@ -18,7 +18,7 @@ export interface ConfigRow {
 export function configRows(config: Config): ConfigRow[] {
   return [
     { key: "autoRead", label: "Auto-read", hint: "Anchors after write + post-edit diffs", enabled: config.autoRead !== false },
-    { key: "autoReadAll", label: "Auto-read all", hint: "Attach every non-ignored file with anchors on the first turn", enabled: config.autoReadAll === true },
+    { key: "autoReadAll", label: "Auto-read all", hint: "Attach files on the first turn: off, on, git (git repos only)", enabled: (config.autoReadAll ?? "off") !== "off", mode: config.autoReadAll ?? "off", cycle: ["off", "on", "git"] },
     { key: "diffContextLines", label: "Diff context", hint: "Surrounding lines in post-edit diffs (needs Auto-read)", enabled: config.autoRead !== false, value: config.diffContextLines ?? 1, disabled: config.autoRead === false },
     { key: "anchorGrepEnabled", label: "Anchor grep", hint: "anchor_grep tool (builtin grep off while on)", enabled: config.anchorGrepEnabled === true },
     { key: "requirePath", label: "Require path", hint: "replace + insert need path (RPC visibility)", enabled: config.requirePath === true },

package/src/config.ts

@@ -4,6 +4,8 @@ import { configPath } from "./paths";
 import { errCode, isRec } from "./utils";
 import { writeAtomic } from "./fs-write";
 export type BoundaryDedupMode = "on" | "off" | "strict";
+export type AutoReadAllMode = "off" | "on" | "git";
+const AUTO_READ_ALL_MODES: AutoReadAllMode[] = ["off", "on", "git"];
 
 export const DEFAULT_DIFF_CONTEXT_LINES = 1;
 export const MIN_DIFF_CONTEXT_LINES = 0;
@@ -12,7 +14,7 @@ export const MAX_DIFF_CONTEXT_LINES = 10;
 export interface Config {
   autoRead: boolean;
   anchorGrepEnabled: boolean;
-  autoReadAll?: boolean;
+  autoReadAll?: AutoReadAllMode;
   requirePath?: boolean;
   strictInput?: boolean;
   boundaryDedupMode?: BoundaryDedupMode;
@@ -22,7 +24,7 @@ export interface Config {
 const DEFAULT_CONFIG: Config = {
   autoRead: true,
   anchorGrepEnabled: true,
-  autoReadAll: false,
+  autoReadAll: "off",
   requirePath: false,
   strictInput: false,
   boundaryDedupMode: "on",
@@ -38,6 +40,13 @@ function parseBoundaryDedupMode(mode: unknown, legacy: unknown): BoundaryDedupMo
   return DEFAULT_CONFIG.boundaryDedupMode ?? "on";
 }
 
+function parseAutoReadAllMode(value: unknown): AutoReadAllMode {
+  if (value === "off" || value === "on" || value === "git") return value;
+  if (value === true) return "on";
+  if (value === false) return "off";
+  return DEFAULT_CONFIG.autoReadAll ?? "off";
+}
+
 export function normalizeDiffContextLines(value: unknown): number {
   if (typeof value !== "number" || !Number.isFinite(value)) return DEFAULT_DIFF_CONTEXT_LINES;
   const floored = Math.floor(value);
@@ -62,7 +71,7 @@ function parseConfig(content: string): Config {
   return {
     autoRead: typeof autoRead === "boolean" ? autoRead : DEFAULT_CONFIG.autoRead,
     anchorGrepEnabled: typeof anchorGrepEnabled === "boolean" ? anchorGrepEnabled : DEFAULT_CONFIG.anchorGrepEnabled,
-    autoReadAll: typeof autoReadAll === "boolean" ? autoReadAll : DEFAULT_CONFIG.autoReadAll,
+    autoReadAll: parseAutoReadAllMode(autoReadAll),
     requirePath: typeof requirePath === "boolean" ? requirePath : DEFAULT_CONFIG.requirePath,
     strictInput: typeof strictInput === "boolean" ? strictInput : DEFAULT_CONFIG.strictInput,
     boundaryDedupMode: parseBoundaryDedupMode(boundaryDedupMode, legacyBoundaryDedup),
@@ -174,7 +183,7 @@ export async function writeConfig(config: Config): Promise<void> {
 }
 
 
-type ToggleKey = "autoRead" | "anchorGrepEnabled" | "autoReadAll" | "requirePath" | "strictInput";
+type ToggleKey = "autoRead" | "anchorGrepEnabled" | "requirePath" | "strictInput";
 
 async function toggleFlag(key: ToggleKey): Promise<boolean> {
   const config = await updateConfig((c) => { c[key] = !(c[key] === true); });
@@ -182,7 +191,15 @@ async function toggleFlag(key: ToggleKey): Promise<boolean> {
 }
 export const toggleAutoRead = (): Promise<boolean> => toggleFlag("autoRead");
 export const toggleAnchorGrep = (): Promise<boolean> => toggleFlag("anchorGrepEnabled");
-export const toggleAutoReadAll = (): Promise<boolean> => toggleFlag("autoReadAll");
+export async function cycleAutoReadAllMode(): Promise<AutoReadAllMode> {
+  let next: AutoReadAllMode = "off";
+  await updateConfig((c) => {
+    const current = c.autoReadAll ?? "off";
+    next = AUTO_READ_ALL_MODES[(AUTO_READ_ALL_MODES.indexOf(current) + 1) % AUTO_READ_ALL_MODES.length] ?? "off";
+    c.autoReadAll = next;
+  });
+  return next;
+}
 export const toggleRequirePath = (): Promise<boolean> => toggleFlag("requirePath");
 export const toggleStrictInput = (): Promise<boolean> => toggleFlag("strictInput");
 export async function cycleBoundaryDedupMode(): Promise<BoundaryDedupMode> {

package/src/edit-common.ts

@@ -45,6 +45,9 @@ export function withReplacePrompts(base: { description: string; snippet: string;
     descriptionParts.push("Also give `path` matching the file the anchors were served for; it is required and must match anchor ownership.");
     snippetParts.push("; include `path` (required)");
     guidelines.push("`replace`: include `path` matching the file the anchors were served for; it is required.");
+  } else {
+    descriptionParts.push("Path resolution is anchor-only; do not pass `path`.");
+    guidelines.push("`replace`: path resolution is anchor-only; don't pass `path`.");
   }
   if (flags.strictInput) {
     descriptionParts.push("Strict-input mode is on: auto-fixable slips are rejected instead of fixed with warnings.");
@@ -74,6 +77,9 @@ export function withInsertPrompts(base: { description: string; snippet: string;
     descriptionParts.push("Also give `path` matching the file the anchor was served for; it is required and must match anchor ownership.");
     snippetParts.push("; include `path` (required)");
     guidelines.push("`insert`: include `path` matching the file the anchor was served for; it is required.");
+  } else {
+    descriptionParts.push("Path resolution is anchor-only; do not pass `path`.");
+    guidelines.push("`insert`: path resolution is anchor-only; don't pass `path`.");
   }
   if (flags.strictInput) {
     descriptionParts.push("Strict-input mode is on: auto-fixable slips are rejected instead of fixed with warnings.");

package/src/payload-contract.ts

@@ -8,7 +8,7 @@ const replacementLinesSchema = Type.Array(
   }),
   {
     description:
-      "One string per line. Use [] to delete the range.",
+      "One string per line. Use [] to delete the range; [\"\"] is a single blank line.",
   },
 );