pi-readseek 0.3.2 → 0.3.4

package/README.md

@@ -2,8 +2,8 @@
 
 `pi-readseek` is a pi extension for readseek-backed file reading, hash-anchored
 editing, anchored grep, structural maps, symbol lookup, and structural search.
-It exists to resolve conflicts between overlapping pi file-operation tools by
-exposing one consistent readseek-centered surface.
+It resolves conflicts between overlapping pi file-operation tools by exposing
+one consistent readseek-centered surface.
 
 ## Installation
 
@@ -11,25 +11,37 @@ exposing one consistent readseek-centered surface.
 pi install npm:pi-readseek
 ```
 
+The structural search and map features require the `@jarkkojs/readseek` native
+binary. The extension auto-installs the correct platform package, or you can
+install it manually:
+
+```bash
+# Auto-installed by the extension on supported platforms.
+# Manual install (if needed):
+npm install --save-dev @jarkkojs/readseek
+```
+
 ## Tools
 
-- `read` — reads text files with `LINE:HASH` anchors for later `edit` calls;
-  images are returned as attachments. Large or symbol-scoped reads can include
-  structural maps powered by `@jarkkojs/readseek`.
-- `edit` — changes existing text files using fresh anchors from `read`, `grep`,
-  `search`, or `write`. Use anchored variants such as `set_line`; `new_text`
-  must be plain replacement text and never include `LINE:HASH|` prefixes.
-  Set `new_text` to `""` to delete a line. Fuzzy replacement is literal
-  relocation, not approximate or semantic matching.
-- `grep` — searches text and returns edit-ready `LINE:HASH` anchors without a
+- **read** — reads text files with `LINE:HASH` anchors for later `edit` calls;
+  images are returned as attachments. Supports `symbol`, `map`, and `bundle`
+  options powered by `@jarkkojs/readseek`.
+- **edit** — changes existing text files using fresh anchors from `read`,
+  `grep`, `search`, or `write`. Variants: `set_line`, `replace_lines`,
+  `insert_after`, `replace_symbol`, `replace`. Set `new_text` to `""` to
+  delete a line.
+- **grep** — searches text and returns edit-ready `LINE:HASH` anchors without a
   follow-up `read`.
-- `search` — searches code by structural pattern and returns anchored
-  matches; use it when syntax matters more than raw text.
-- `write` — creates or overwrites whole files and returns anchors for immediate
-  follow-up edits. Create a new file with `write` when there is no existing file
-  to edit.
-- `ls` — lists one directory.
-- `find` — recursively discovers files and directories.
+- **search** — searches code by structural pattern (AST) and returns anchored
+  matches. Use when syntax matters more than raw text.
+- **write** — creates or overwrites whole files and returns anchors for
+  immediate follow-up edits.
+
+## Related
+
+- [readseek.vim](https://github.com/jarkkojs/readseek.vim) — Vim 9 plugin
+  frontend for the readseek CLI. Provides go-to-definition, references,
+  rename, hover, and structural search from within Vim.
 
 ## Licensing
 

package/index.ts

@@ -4,141 +4,21 @@ import { registerEditTool } from "./src/edit.js";
 import { registerGrepTool } from "./src/grep.js";
 import { registerSgTool, isSgAvailable } from "./src/sg.js";
 import { registerWriteTool } from "./src/write.js";
-import { registerLsTool } from "./src/ls.js";
-import { registerFindTool } from "./src/find.js";
-import { registerReadseekCommand } from "./src/readseek-command.js";
-import { applyContextHygieneStaleContext } from "./src/context-application.js";
-import {
-  createContextHygieneTracker,
-  normalizePathForContextHygiene,
-  type ContextHygieneEvent,
-  type ContextHygieneMetadata,
-  type ContextHygieneReport,
-  type ContextHygieneResource,
-  type ContextHygieneTracker,
-} from "./src/context-hygiene.js";
-import {
-  consumeDoomLoopWarning,
-  createDoomLoopState,
-  formatDoomLoopMessage,
-  recordToolCall,
-} from "./src/doom-loop.js";
-
-function isContextHygieneResource(value: unknown): value is ContextHygieneResource {
-  if (!value || typeof value !== "object") return false;
-  const resource = value as { kind?: unknown; key?: unknown };
-  return (resource.kind === "file" || resource.kind === "symbol") && typeof resource.key === "string";
-}
-
-function isContextHygieneMetadata(value: unknown): value is ContextHygieneMetadata {
-  if (!value || typeof value !== "object") return false;
-  const metadata = value as Partial<ContextHygieneMetadata>;
-  return (
-    metadata.schemaVersion === 1 &&
-    typeof metadata.tool === "string" &&
-    (metadata.classification === "read-context" ||
-      metadata.classification === "search-context" ||
-      metadata.classification === "mutation") &&
-    Array.isArray(metadata.resources) &&
-    metadata.resources.every(isContextHygieneResource)
-  );
-}
-
-function contextHygieneFromDetails(details: unknown): ContextHygieneMetadata | undefined {
-  if (!details || typeof details !== "object") return undefined;
-  const metadata = (details as { contextHygiene?: unknown }).contextHygiene;
-  return isContextHygieneMetadata(metadata) ? metadata : undefined;
-}
-
-function recordContextHygiene(
-  tracker: ContextHygieneTracker,
-  metadata: ContextHygieneMetadata,
-  toolCallId: unknown,
-): ContextHygieneEvent {
-  return tracker.record(metadata, {
-    resultId: typeof toolCallId === "string" ? toolCallId : undefined,
-  });
-}
-
 export default function piReadseekExtension(pi: ExtensionAPI): void {
-  const readTurns = new Map<string, number>();
-  const doomLoopState = createDoomLoopState();
-  const contextHygieneTracker = createContextHygieneTracker();
-  const readTurnKey = (absolutePath: string) => normalizePathForContextHygiene(absolutePath);
-  const noteRead = (absolutePath: string) => {
-    const report = contextHygieneTracker.generateReport();
-    const eventId = report.eventCount + 1;
-    readTurns.set(readTurnKey(absolutePath), eventId);
-  };
-  const wasReadInSession = (absolutePath: string) => readTurns.has(readTurnKey(absolutePath));
-
-  registerReadTool(pi, { onSuccessfulRead: noteRead });
-  registerEditTool(pi, { wasReadInSession });
-  const sgAvailable = isSgAvailable();
-  const searchGuideline = sgAvailable
-    ? "Use grep summary for counts; use search for structural code patterns."
-    : "Use grep summary for counts; install @jarkkojs/readseek to enable search.";
-
-  registerGrepTool(pi, { searchGuideline, onFileAnchored: noteRead });
-  registerSgTool(pi, { onFileAnchored: noteRead });
-  registerWriteTool(pi, { onFileAnchored: noteRead });
-  registerLsTool(pi);
-  registerFindTool(pi);
-  registerReadseekCommand(pi);
-
-  pi.on("tool_call", (event: any) => {
-    recordToolCall(
-      doomLoopState,
-      event.toolName,
-      event.toolCallId,
-      (event.input ?? {}) as Record<string, unknown>,
-    );
-  });
-
-  const expireStaleReadTurns = (report: ContextHygieneReport) => {
-    if (readTurns.size === 0) return;
-    for (const candidate of report.staleCandidates) {
-      if (!candidate.resourceKey.startsWith("file:")) continue;
-      const resourcePath = readTurnKey(candidate.resourceKey.slice("file:".length));
-      const recordedEventId = readTurns.get(resourcePath);
-      if (recordedEventId === undefined) continue;
-      if (recordedEventId < candidate.mutationEventId) {
-        readTurns.delete(resourcePath);
-      }
-    }
-  };
-
-  pi.on("context", (event: any): any => {
-    if (!Array.isArray(event.messages)) return undefined;
-    const report = contextHygieneTracker.generateReport();
-    const messages = applyContextHygieneStaleContext(event.messages, report);
-    expireStaleReadTurns(report);
-    return { messages };
-  });
-
-  pi.on("tool_result", (event: any) => {
-    const contextHygiene = contextHygieneFromDetails(event.details);
-    if (contextHygiene) recordContextHygiene(contextHygieneTracker, contextHygiene, event.toolCallId);
-
-    const doomLoop = consumeDoomLoopWarning(doomLoopState, event.toolCallId);
-    if (!doomLoop || !Array.isArray(event.content)) return undefined;
-
-    const content = [...event.content];
-    const prefix = `${formatDoomLoopMessage(doomLoop)}\n\n---\n`;
-    const textIndex = content.findIndex((item) => {
-      const maybeText = item as { type?: unknown; text?: unknown };
-      return maybeText.type === "text" && typeof maybeText.text === "string";
-    });
-    if (textIndex >= 0) {
-      const item = content[textIndex] as { type: "text"; text: string };
-      content[textIndex] = { ...item, text: `${prefix}${item.text}` };
-    } else {
-      content.unshift({ type: "text" as const, text: prefix });
-    }
-    return {
-      content,
-      details: event.details,
-      isError: event.isError,
-    };
-  });
+	const readPaths = new Set<string>();
+	const noteRead = (absolutePath: string) => {
+		readPaths.add(absolutePath);
+	};
+	const wasReadInSession = (absolutePath: string) => readPaths.has(absolutePath);
+
+	registerReadTool(pi, { onSuccessfulRead: noteRead });
+	registerEditTool(pi, { wasReadInSession });
+	const sgAvailable = isSgAvailable();
+	const searchGuideline = sgAvailable
+		? "Use grep summary for counts; use search for structural code patterns."
+		: "Use grep summary for counts; install @jarkkojs/readseek to enable search.";
+
+	registerGrepTool(pi, { searchGuideline, onFileAnchored: noteRead });
+	registerSgTool(pi, { onFileAnchored: noteRead });
+	registerWriteTool(pi, { onFileAnchored: noteRead });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-readseek",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Pi extension for readseek-backed hash-anchored read/edit/grep, structural code maps, structural search, and file exploration",
   "type": "module",
   "exports": {
@@ -15,7 +15,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/coctostan/pi-readseek.git"
+    "url": "git+https://github.com/jarkkojs/pi-readseek.git"
   },
   "author": "Maxwell Newman",
   "license": "MIT",
@@ -67,7 +67,7 @@
     "test": "tests"
   },
   "bugs": {
-    "url": "https://github.com/coctostan/pi-readseek/issues"
+    "url": "https://github.com/jarkkojs/pi-readseek/issues"
   },
-  "homepage": "https://github.com/coctostan/pi-readseek#readme"
+  "homepage": "https://github.com/jarkkojs/pi-readseek#readme"
 }

package/src/confusable-hyphens.ts

@@ -0,0 +1,6 @@
+/**
+ * Unicode hyphen-like characters normalized to ASCII "-" during text
+ * comparison so edits with typographic hyphens match their originals.
+ */
+export const CONFUSABLE_HYPHENS_RE =
+	/[\u2010\u2011\u2012\u2013\u2014\u2015\u2212\uFE63\uFF0D]/g;

package/src/edit-classify.ts

@@ -146,8 +146,6 @@ export function parseDifftJson(json: any): DifftClassifyResult | null {
   }
 
   return { classification: "semantic", movedBlocks };
-
-  return { classification: "semantic", movedBlocks };
 }
 
 export async function runDifftastic(

package/src/edit-diff.ts

@@ -1,7 +1,7 @@
 import * as Diff from "diff";
 import { computeLineHash } from "./hashline.js";
+import { CONFUSABLE_HYPHENS_RE } from "./confusable-hyphens.js";
 
-// ─── Line ending normalization ──────────────────────────────────────────
 
 export function detectLineEnding(content: string): "\r\n" | "\n" {
 	const crlfIdx = content.indexOf("\r\n");
@@ -31,15 +31,13 @@ export function hasBareCarriageReturn(content: string): boolean {
 	return content.replace(/\r\n/g, "").includes("\r");
 }
 
-// ─── Fuzzy text matching ────────────────────────────────────────────────
 
 const SINGLE_QUOTES_RE = /[\u2018\u2019\u201A\u201B]/g;
 const DOUBLE_QUOTES_RE = /[\u201C\u201D\u201E\u201F]/g;
-const HYPHENS_RE = /[\u2010\u2011\u2012\u2013\u2014\u2015\u2212]/g;
 const UNICODE_SPACES_RE = /[\u00A0\u2002-\u200A\u202F\u205F\u3000]/g;
 
 function normalizeFuzzyChar(ch: string): string {
-	return ch.replace(SINGLE_QUOTES_RE, "'").replace(DOUBLE_QUOTES_RE, '"').replace(HYPHENS_RE, "-").replace(UNICODE_SPACES_RE, " ");
+	return ch.replace(SINGLE_QUOTES_RE, "'").replace(DOUBLE_QUOTES_RE, '"').replace(CONFUSABLE_HYPHENS_RE, "-").replace(UNICODE_SPACES_RE, " ");
 }
 
 function normalizeForFuzzyMatch(text: string): string {
@@ -49,7 +47,7 @@ function normalizeForFuzzyMatch(text: string): string {
 		.join("\n")
 		.replace(SINGLE_QUOTES_RE, "'")
 		.replace(DOUBLE_QUOTES_RE, '"')
-		.replace(HYPHENS_RE, "-")
+		.replace(CONFUSABLE_HYPHENS_RE, "-")
 		.replace(UNICODE_SPACES_RE, " ");
 }
 
@@ -199,7 +197,6 @@ export function replaceText(
 	};
 }
 
-// ─── Diff generation ────────────────────────────────────────────────────
 
 export function generateDiffString(
 	oldContent: string,

package/src/edit-output.ts

@@ -1,6 +1,6 @@
 import { countEditTypes, parseDiffStats } from "./edit-render-helpers.js";
 import { buildReadseekEditResult, type SemanticSummary } from "./readseek-value.js";
-import { buildContextHygieneMetadata, buildFileResource, type ContextHygieneMetadata } from "./context-hygiene.js";
+
 import type { DiffData } from "./diff-data.js";
 export interface BuildEditOutputInput {
   path: string;
@@ -18,7 +18,6 @@ export interface EditOutputResult {
   text: string;
   patch: string;
   readseekValue: ReturnType<typeof buildReadseekEditResult>;
-  contextHygiene: ContextHygieneMetadata;
 }
 function getVisibleDiffStats(diff: string): { added: number; removed: number } {
   const stats = parseDiffStats(diff);
@@ -98,10 +97,5 @@ export function buildEditOutput(input: BuildEditOutputInput): EditOutputResult {
       noopEdits: input.noopEdits,
       ...(input.semanticSummary ? { semanticSummary: input.semanticSummary } : {}),
     }),
-    contextHygiene: buildContextHygieneMetadata({
-      tool: "edit",
-      classification: "mutation",
-      resources: [buildFileResource(input.path)],
-    }),
   };
 }

package/src/edit.ts

@@ -21,7 +21,7 @@ import { buildEditPreviewKey, buildPendingEditPreviewData, resolvePendingDiffPre
 import { buildDiffData, type DiffBlockRange } from "./diff-data.js";
 import { clampLineToWidth, clampLinesToWidth, isRendererExpanded, linkToolPath, summaryLine } from "./tui-render-utils.js";
 import { DiffPreviewComponent } from "./tui-diff-component.js";
-import { buildContextHygieneMetadata, buildFileResource, type ContextHygieneMetadata } from "./context-hygiene.js";
+
 import { resolveEditDiffDisplay } from "./readseek-settings.js";
 
 const EDIT_PENDING_PREVIEW_STATE_KEY = "hashline-edit-pending-preview";
@@ -45,7 +45,6 @@ export function isBinaryBuffer(buf: Buffer): boolean {
 	return buf.includes(0);
 }
 
-// ─── Schema ─────────────────────────────────────────────────────────────
 
 const hashlineEditItemSchema = Type.Union([
 	Type.Object({ set_line: Type.Object({ anchor: Type.String(), new_text: Type.String() }) }, { additionalProperties: true }),
@@ -100,11 +99,10 @@ function buildEditError(
 	message: string,
 	hint?: string,
 	errorDetails?: Record<string, unknown>,
-	contextHygiene?: ContextHygieneMetadata,
 ): {
 	content: [{ type: "text"; text: string }];
 	isError: true;
-	details: EditToolDetails & { readseekValue: any; contextHygiene?: ContextHygieneMetadata };
+	details: EditToolDetails & { readseekValue: any };
 } {
 	return {
 		content: [{ type: "text", text: message }],
@@ -119,8 +117,7 @@ function buildEditError(
 				path,
 				error: buildReadseekError(code, message, hint, errorDetails),
 			},
-			...(contextHygiene ? { contextHygiene } : {}),
-		} as EditToolDetails & { readseekValue: any; contextHygiene?: ContextHygieneMetadata },
+		} as EditToolDetails & { readseekValue: any },
 	};
 }
 
@@ -129,7 +126,6 @@ export interface EditToolOptions {
 	syntaxValidate?: SyntaxValidateOptions["syntaxValidate"];
 }
 
-// ─── Registration ───────────────────────────────────────────────────────
 
 export function registerEditTool(pi: ExtensionAPI, options: EditToolOptions = {}) {
 	const toolConfig = {
@@ -491,11 +487,6 @@ export function registerEditTool(pi: ExtensionAPI, options: EditToolOptions = {}
 			}
 
 			if (input.postEditVerify === true) {
-				const postWriteMutationContextHygiene = buildContextHygieneMetadata({
-					tool: "edit",
-					classification: "mutation",
-					resources: [buildFileResource(absolutePath)],
-				});
 				let verifiedContent: string;
 				try {
 					const verified = await fsReadFile(absolutePath, "utf-8");
@@ -506,7 +497,6 @@ export function registerEditTool(pi: ExtensionAPI, options: EditToolOptions = {}
 							fsCode: err?.code,
 							fsMessage: err?.message,
 						},
-						postWriteMutationContextHygiene,
 					);
 				}
 				if (verifiedContent !== writeContent) {
@@ -515,7 +505,6 @@ export function registerEditTool(pi: ExtensionAPI, options: EditToolOptions = {}
 							expectedLength: writeContent.length,
 							actualLength: verifiedContent.length,
 						},
-						postWriteMutationContextHygiene,
 					);
 				}
 			}
@@ -580,7 +569,6 @@ export function registerEditTool(pi: ExtensionAPI, options: EditToolOptions = {}
 					diffData,
 					firstChangedLine: anchorResult.firstChangedLine ?? diffResult.firstChangedLine,
 					readseekValue: builtOutput.readseekValue,
-					contextHygiene: builtOutput.contextHygiene,
 				} as EditToolDetails & {
 					diffData: typeof diffData;
 					readseekValue: {
@@ -594,7 +582,6 @@ export function registerEditTool(pi: ExtensionAPI, options: EditToolOptions = {}
 						warnings: string[];
 						noopEdits: unknown[];
 					};
-					contextHygiene: ContextHygieneMetadata;
 				},
 			};
 				});

package/src/grep-output.ts

@@ -4,14 +4,6 @@ import {
   truncateHead,
 } from "@earendil-works/pi-coding-agent";
 import { resolveGrepOutputBudget } from "./grep-budget.js";
-import {
-  buildContextHygieneMetadata,
-  buildFileResource,
-  buildSymbolResource,
-  type ContextHygieneMetadata,
-  type ContextHygieneRehydrateDescriptor,
-  type ContextHygieneResource,
-} from "./context-hygiene.js";
 
 export interface GrepOutputRecord extends ReadseekLine {
   path: string;
@@ -64,7 +56,6 @@ export interface BuildGrepOutputInput {
   scopeMode?: "symbol";
   scopeWarnings?: GrepScopeWarning[];
   passthroughLines?: string[];
-  rehydrate?: ContextHygieneRehydrateDescriptor | null;
 }
 
 export interface GrepOutputResult {
@@ -87,7 +78,6 @@ export interface GrepOutputResult {
       warnings: GrepScopeWarning[];
     };
   };
-  contextHygiene: ContextHygieneMetadata;
 }
 
 function renderEntry(displayPath: string, entry: GrepOutputEntry): string {
@@ -174,24 +164,8 @@ export function buildGrepOutput(input: BuildGrepOutputInput): GrepOutputResult {
     readseekValue.scopes = buildScopeMetadata(input.groups, input.scopeWarnings ?? []);
   }
 
-  const contextHygieneResources: ContextHygieneResource[] = [];
-  for (const record of input.records) {
-    contextHygieneResources.push(buildFileResource(record.path));
-  }
-  for (const group of input.groups) {
-    if (!group.scope) continue;
-    contextHygieneResources.push(buildFileResource(group.absolutePath));
-    contextHygieneResources.push(buildSymbolResource(group.absolutePath, group.scope.symbol.name, group.scope.symbol.kind));
-  }
-  const contextHygiene = buildContextHygieneMetadata({
-    tool: "grep",
-    classification: "search-context",
-    resources: contextHygieneResources,
-    rehydrate: input.rehydrate ?? undefined,
-  });
   return {
     text,
     readseekValue,
-    contextHygiene,
   };
 }

package/src/grep.ts

@@ -9,7 +9,7 @@ import { looksLikeBinary } from "./binary-detect.js";
 import { ensureHashInit, formatHashlineDisplay, escapeControlCharsForDisplay } from "./hashline.js";
 import { buildReadseekError, buildReadseekLine } from "./readseek-value.js";
 import { buildGrepOutput } from "./grep-output.js";
-import { buildGrepRehydrateDescriptor } from "./context-hygiene.js";
+
 import { getOrGenerateMap } from "./map-cache.js";
 import { scopeGrepGroupsToSymbols } from "./grep-symbol-scope.js";
 import { resolveToCwd } from "./path-utils.js";
@@ -672,17 +672,6 @@ if (p.scope === "symbol" && !summary) {
 				scopeMode: p.scope === "symbol" && !summary ? "symbol" : undefined,
 				scopeWarnings,
 				passthroughLines,
-				rehydrate: buildGrepRehydrateDescriptor({
-					pattern: p.pattern,
-					path: p.path,
-					glob: p.glob,
-					literal: p.literal,
-					ignoreCase: p.ignoreCase,
-					context: p.context,
-					summary: p.summary,
-					scope: p.scope,
-					scopeContext: p.scopeContext,
-				}),
 			});
 
 			if (!summary && readseekRecords.length > 0) {
@@ -705,7 +694,6 @@ if (p.scope === "symbol" && !summary) {
 				details: {
 					...compactDetails,
 					readseekValue: builtOutput.readseekValue,
-					contextHygiene: builtOutput.contextHygiene,
 				},
 			};
 		},

package/src/hashline.ts

@@ -8,8 +8,8 @@
 import xxhashWasm from "xxhash-wasm";
 import { throwIfAborted } from "./runtime.js";
 import type { ReadseekLine } from "./readseek-value.js";
+import { CONFUSABLE_HYPHENS_RE } from "./confusable-hyphens.js";
 
-// ─── Types ──────────────────────────────────────────────────────────────
 
 export type HashlineEditItem =
 	| { set_line: { anchor: string; new_text: string } }
@@ -52,7 +52,6 @@ interface NoopEdit {
 	currentContent: string;
 }
 
-// ─── Hash computation ───────────────────────────────────────────────────
 
 const HASH_LEN = 3;
 const RADIX = 16;
@@ -62,7 +61,6 @@ const DICT = Array.from({ length: HASH_MOD }, (_, i) => i.toString(RADIX).padSta
 const HASHLINE_PREFIX_RE = /^\d+:[0-9a-zA-Z]{1,16}\|/;
 const DIFF_PLUS_RE = /^\+(?!\+)/;
 const HASH_ONLY_PREFIX_RE = /^[0-9a-f]{3}\|/;
-const CONFUSABLE_HYPHENS_RE = /[\u2010\u2011\u2012\u2013\u2014\u2212\uFE63\uFF0D]/g;
 const HASH_RELOCATION_WINDOW_BASE = 20;
 const HASH_RELOCATION_WINDOW_CAP = 100;
 
@@ -128,7 +126,6 @@ export function hashLines(content: string): string {
 		.join("\n");
 }
 
-// ─── Parsing ────────────────────────────────────────────────────────────
 
 export function parseLineRef(ref: string): { line: number; hash: string; content?: string } {
 	const contentMatch = ref.match(/^[^|]*\|(.*)$/);
@@ -142,7 +139,6 @@ export function parseLineRef(ref: string): { line: number; hash: string; content
 	return { line, hash: match[2], content: contentAfterPipe };
 }
 
-// ─── Mismatch formatting ────────────────────────────────────────────────
 
 function tokenSimilarity(a: string, b: string): number {
 	const tokA = new Set(a.trim().split(/\s+/));
@@ -241,7 +237,6 @@ function formatMismatchError(
 	return { message: out.join("\n"), updatedAnchors };
 }
 
-// ─── DST preprocessing helpers ──────────────────────────────────────────
 
 function splitDst(dst: string): string[] {
 	if (dst === "") return [];
@@ -280,7 +275,6 @@ function stripNewLinePrefixes(lines: string[]): string[] {
 	);
 }
 
-// ─── Whitespace / format helpers ────────────────────────────────────────
 
 function stripAllWhitespace(s: string): string {
 	return s.replace(/\s+/g, "");
@@ -362,7 +356,6 @@ function restoreOldWrappedLines(oldLines: string[], newLines: string[]): string[
 	return out;
 }
 
-// ─── Echo stripping ─────────────────────────────────────────────────────
 
 function stripInsertAnchorEcho(anchorLine: string, dst: string[]): string[] {
 	if (dst.length > 1 && wsEq(dst[0], anchorLine)) return dst.slice(1);
@@ -378,7 +371,6 @@ function stripRangeBoundaryEcho(fileLines: string[], start: number, end: number,
 	return out;
 }
 
-// ─── Edit parser ────────────────────────────────────────────────────────
 
 function parseHashlineEditItem(edit: HashlineEditItem): ParsedEdit {
 	if ("set_line" in edit) {
@@ -404,7 +396,6 @@ function parseHashlineEditItem(edit: HashlineEditItem): ParsedEdit {
 	throw new Error("replace edits are applied separately");
 }
 
-// ─── Main edit engine ───────────────────────────────────────────────────
 
 export function applyHashlineEdits(
 	content: string,

package/src/read-output.ts

@@ -5,14 +5,7 @@ import {
   truncateHead,
 } from "@earendil-works/pi-coding-agent";
 import { buildReadseekLines, renderReadseekLines, type ReadseekLine, type ReadseekWarning } from "./readseek-value.js";
-import {
-  buildContextHygieneMetadata,
-  buildFileResource,
-  buildSymbolResource,
-  type ContextHygieneMetadata,
-  type ContextHygieneRehydrateDescriptor,
-  type ContextHygieneResource,
-} from "./context-hygiene.js";
+
 
 export interface ReadSymbolMetadata {
   query: string;
@@ -65,7 +58,6 @@ export interface ReadOutputInput {
   symbol?: ReadSymbolMetadata | null;
   map?: ReadMapMetadata;
   bundle?: ReadBundleMetadata | null;
-  rehydrate?: ContextHygieneRehydrateDescriptor | null;
 }
 
 export interface ReadOutputResult {
@@ -101,7 +93,6 @@ export interface ReadOutputResult {
       warnings: ReadseekWarning[];
     };
   };
-  contextHygiene: ContextHygieneMetadata;
 }
 
 export function buildReadOutput(input: ReadOutputInput): ReadOutputResult {
@@ -187,26 +178,9 @@ export function buildReadOutput(input: ReadOutputInput): ReadOutputResult {
     };
   }
 
-  const contextHygieneResources: ContextHygieneResource[] = [buildFileResource(input.path)];
-  if (input.symbol) {
-    contextHygieneResources.push(buildSymbolResource(input.path, input.symbol.name, input.symbol.kind));
-  }
-  if (input.bundle?.applied) {
-    for (const support of input.bundle.localSupport) {
-      contextHygieneResources.push(buildSymbolResource(input.path, support.symbol.name, support.symbol.kind));
-    }
-  }
-  const contextHygiene = buildContextHygieneMetadata({
-    tool: "read",
-    classification: "read-context",
-    resources: contextHygieneResources,
-    rehydrate: input.rehydrate ?? undefined,
-  });
-
   return {
     text,
     lines,
     readseekValue,
-    contextHygiene,
   };
 }