pi-readseek 0.4.12 → 0.4.13

package/src/readseek-client.ts

@@ -8,23 +8,23 @@ import { DetailLevel } from "./readseek/enums.js";
 import type { FileMap, FileSymbol } from "./readseek/types.js";
 import { SymbolKind } from "./readseek/enums.js";
 
-export interface ReadseekHashline {
+export interface ReadSeekHashline {
 	line: number;
 	hash: string;
 	text: string;
 }
 
-export interface ReadseekReadOutput {
+interface ReadSeekReadOutput {
 	file: string;
 	language: string;
 	line_count: number;
 	file_hash: string;
 	start_line: number;
 	end_line: number;
-	hashlines: ReadseekHashline[];
+	hashlines: ReadSeekHashline[];
 }
 
-interface ReadseekSymbol {
+interface ReadSeekSymbol {
 	kind: string;
 	name: string;
 	qualified_name: string;
@@ -34,45 +34,45 @@ interface ReadseekSymbol {
 	end_hash: string;
 }
 
-interface ReadseekMapOutput {
+interface ReadSeekMapOutput {
 	file: string;
 	language: string;
 	line_count: number;
 	file_hash: string;
-	symbols: ReadseekSymbol[];
+	symbols: ReadSeekSymbol[];
 }
 
-export interface ReadseekSearchCapture {
+interface ReadSeekSearchCapture {
 	name: string;
 	start_line: number;
 	end_line: number;
 	start_hash: string;
 	end_hash: string;
-	hashlines: ReadseekHashline[];
+	hashlines: ReadSeekHashline[];
 }
 
-export interface ReadseekSearchMatch {
+interface ReadSeekSearchMatch {
 	pattern_index: number;
 	start_line: number;
 	end_line: number;
 	start_hash: string;
 	end_hash: string;
-	hashlines: ReadseekHashline[];
-	captures: ReadseekSearchCapture[];
+	hashlines: ReadSeekHashline[];
+	captures: ReadSeekSearchCapture[];
 }
 
-export interface ReadseekSearchFileOutput {
+export interface ReadSeekSearchFileOutput {
 	file: string;
 	language: string;
 	file_hash: string;
-	matches: ReadseekSearchMatch[];
+	matches: ReadSeekSearchMatch[];
 }
 
-interface ReadseekSearchOutput {
-	results: ReadseekSearchFileOutput[];
+interface ReadSeekSearchOutput {
+	results: ReadSeekSearchFileOutput[];
 }
 
-export interface ReadseekReference {
+export interface ReadSeekReference {
 	file: string;
 	line: number;
 	column: number;
@@ -81,11 +81,11 @@ export interface ReadseekReference {
 	enclosingSymbol?: string;
 }
 
-interface ReadseekRefsOutput {
-	references: ReadseekReference[];
+interface ReadSeekRefsOutput {
+	references: ReadSeekReference[];
 }
 
-export interface ReadseekRefsOptions {
+interface ReadSeekRefsOptions {
 	scope?: boolean;
 	line?: number;
 	column?: number;
@@ -96,19 +96,19 @@ export interface ReadseekRefsOptions {
 	signal?: AbortSignal;
 }
 
-export interface ReadseekDiagnostic {
+export interface ReadSeekDiagnostic {
 	kind: "error" | "missing";
 	start_line: number;
 	end_line: number;
 }
 
-export interface ReadseekCheckOutput {
+export interface ReadSeekCheckOutput {
 	errorCount: number;
 	missingCount: number;
-	diagnostics: ReadseekDiagnostic[];
+	diagnostics: ReadSeekDiagnostic[];
 }
 
-export interface ReadseekSearchOptions {
+interface ReadSeekSearchOptions {
 	language?: string;
 	cached?: boolean;
 	others?: boolean;
@@ -131,7 +131,7 @@ function parentQualifiedNameFor(qualifiedName: string): string {
 	return lastDot === -1 ? "" : qualifiedName.slice(0, lastDot);
 }
 
-function symbolsFromReadseek(symbols: ReadseekSymbol[]): FileSymbol[] {
+function symbolsFromReadSeek(symbols: ReadSeekSymbol[]): FileSymbol[] {
 	const symbolsByQualifiedName = new Map<string, FileSymbol[]>();
 	const entries: Array<{ parentQualifiedName: string; symbol: FileSymbol }> = [];
 
@@ -168,13 +168,13 @@ function symbolsFromReadseek(symbols: ReadseekSymbol[]): FileSymbol[] {
 
 const require = createRequire(import.meta.url);
 const READSEEK_REPO_PACKAGE_NAMES = new Set(["@jarkkojs/readseek", "readseek"]);
-let defaultReadseekDirInit: Promise<string | null> | undefined;
+let defaultReadSeekDirInit: Promise<string | null> | undefined;
 
 function readseekPackageDir(): string {
 	return path.dirname(require.resolve("@jarkkojs/readseek/package.json"));
 }
 
-export function readseekBinaryPath(): string {
+function readseekBinaryPath(): string {
 	if (process.env.READSEEK_BIN) return process.env.READSEEK_BIN;
 
 	const platformPackage = (() => {
@@ -194,7 +194,7 @@ export function readseekBinaryPath(): string {
 	return path.join(path.dirname(packageJson), "bin", process.platform === "win32" ? "readseek.exe" : "readseek");
 }
 
-export function isReadseekAvailable(): boolean {
+export function isReadSeekAvailable(): boolean {
 	try {
 		readseekBinaryPath();
 		return true;
@@ -203,7 +203,7 @@ export function isReadseekAvailable(): boolean {
 	}
 }
 
-export interface ReadseekFailure {
+interface ReadSeekFailure {
 	code: "readseek-not-installed" | "readseek-execution-error";
 	message: string;
 	hint?: string;
@@ -214,7 +214,7 @@ export interface ReadseekFailure {
  * taxonomy: a missing binary or package (`readseek-not-installed`, with an
  * install hint) versus any other execution error.
  */
-export function classifyReadseekFailure(err: unknown): ReadseekFailure {
+export function classifyReadSeekFailure(err: unknown): ReadSeekFailure {
 	const message = String((err as { message?: unknown } | null)?.message || err);
 	const missing =
 		(err as { code?: unknown } | null)?.code === "ENOENT" ||
@@ -233,7 +233,7 @@ function directoryExists(dirPath: string): boolean {
 	}
 }
 
-function isOwnReadseekRepository(cwd = process.cwd()): boolean {
+function isOwnReadSeekRepository(cwd = process.cwd()): boolean {
 	let dir = path.resolve(cwd);
 	while (true) {
 		const packageJsonPath = path.join(dir, "package.json");
@@ -252,12 +252,12 @@ function isOwnReadseekRepository(cwd = process.cwd()): boolean {
 	}
 }
 
-function defaultReadseekDir(): string | null {
+function defaultReadSeekDir(): string | null {
 	const home = homedir();
 	return home ? path.join(home, ".pi", "readseek") : null;
 }
 
-async function spawnReadseekRaw(args: string[], options: RunReadseekOptions = {}): Promise<string> {
+async function spawnReadSeekRaw(args: string[], options: RunReadSeekOptions = {}): Promise<string> {
 	return new Promise<string>((resolve, reject) => {
 		let settled = false;
 		const fail = (error: Error): void => {
@@ -318,38 +318,38 @@ async function spawnReadseekRaw(args: string[], options: RunReadseekOptions = {}
 	});
 }
 
-async function ensureDefaultReadseekDir(): Promise<string | null> {
-	const dir = defaultReadseekDir();
+async function ensureDefaultReadSeekDir(): Promise<string | null> {
+	const dir = defaultReadSeekDir();
 	if (!dir) return null;
 	if (directoryExists(dir)) return dir;
 
-	defaultReadseekDirInit ??= spawnReadseekRaw(["--readseek-dir", dir, "init"])
+	defaultReadSeekDirInit ??= spawnReadSeekRaw(["--readseek-dir", dir, "init"])
 		.then(() => (directoryExists(dir) ? dir : null))
 		.catch(() => null)
 		.finally(() => {
-			defaultReadseekDirInit = undefined;
+			defaultReadSeekDirInit = undefined;
 		});
-	return defaultReadseekDirInit;
+	return defaultReadSeekDirInit;
 }
 
 async function readseekInvocationArgs(args: string[]): Promise<string[]> {
-	if (isOwnReadseekRepository()) return args;
+	if (isOwnReadSeekRepository()) return args;
 
-	const readseekDir = await ensureDefaultReadseekDir();
+	const readseekDir = await ensureDefaultReadSeekDir();
 	return readseekDir ? ["--readseek-dir", readseekDir, ...args] : args;
 }
 
-interface RunReadseekOptions {
+interface RunReadSeekOptions {
 	signal?: AbortSignal;
 	stdin?: string;
 }
 
-async function runReadseekRaw(args: string[], options: RunReadseekOptions = {}): Promise<string> {
-	return spawnReadseekRaw(await readseekInvocationArgs(args), options);
+async function runReadSeekRaw(args: string[], options: RunReadSeekOptions = {}): Promise<string> {
+	return spawnReadSeekRaw(await readseekInvocationArgs(args), options);
 }
 
-async function runReadseek(args: string[], options: RunReadseekOptions = {}): Promise<unknown> {
-	const stdout = await runReadseekRaw(args, options);
+async function runReadSeek(args: string[], options: RunReadSeekOptions = {}): Promise<unknown> {
+	const stdout = await runReadSeekRaw(args, options);
 	return JSON.parse(stdout) as unknown;
 }
 
@@ -363,7 +363,7 @@ function requireString(value: unknown, field: string): string {
 	return value;
 }
 
-function parseReadOutput(value: unknown): ReadseekReadOutput {
+function parseReadOutput(value: unknown): ReadSeekReadOutput {
 	if (!value || typeof value !== "object") throw new Error("invalid readseek read output");
 	const output = value as Record<string, unknown>;
 	const hashlines = output.hashlines;
@@ -379,7 +379,7 @@ function parseReadOutput(value: unknown): ReadseekReadOutput {
 	};
 }
 
-function parseMapOutput(value: unknown): ReadseekMapOutput {
+function parseMapOutput(value: unknown): ReadSeekMapOutput {
 	if (!value || typeof value !== "object") throw new Error("invalid readseek map output");
 	const output = value as Record<string, unknown>;
 	const symbols = output.symbols;
@@ -405,7 +405,7 @@ function parseMapOutput(value: unknown): ReadseekMapOutput {
 	};
 }
 
-function parseHashline(value: unknown, field: string): ReadseekHashline {
+function parseHashline(value: unknown, field: string): ReadSeekHashline {
 	if (!value || typeof value !== "object") throw new Error(`invalid readseek ${field}`);
 	const item = value as Record<string, unknown>;
 	return {
@@ -415,12 +415,12 @@ function parseHashline(value: unknown, field: string): ReadseekHashline {
 	};
 }
 
-function parseSearchHashlines(value: unknown, field: string): ReadseekHashline[] {
+function parseSearchHashlines(value: unknown, field: string): ReadSeekHashline[] {
 	if (!Array.isArray(value)) throw new Error(`invalid readseek ${field}`);
 	return value.map((line) => parseHashline(line, field));
 }
 
-function parseSearchOutput(value: unknown): ReadseekSearchOutput {
+function parseSearchOutput(value: unknown): ReadSeekSearchOutput {
 	if (!value || typeof value !== "object") throw new Error("invalid readseek search output");
 	const output = value as Record<string, unknown>;
 	if (!Array.isArray(output.results)) throw new Error("invalid readseek search results");
@@ -463,14 +463,14 @@ function parseSearchOutput(value: unknown): ReadseekSearchOutput {
 	};
 }
 
-export async function readseekRead(filePath: string, startLine?: number, endLine?: number): Promise<ReadseekReadOutput> {
+export async function readseekRead(filePath: string, startLine?: number, endLine?: number): Promise<ReadSeekReadOutput> {
 	const args = ["read", filePath];
 	if (startLine !== undefined) args.push("--start", String(startLine));
 	if (endLine !== undefined) args.push("--end", String(endLine));
-	return parseReadOutput(await runReadseek(args));
+	return parseReadOutput(await runReadSeek(args));
 }
 
-function fileMapFromReadseekOutput(output: ReadseekMapOutput, filePath: string, totalBytes: number): FileMap | null {
+function fileMapFromReadSeekOutput(output: ReadSeekMapOutput, filePath: string, totalBytes: number): FileMap | null {
 	if (output.language === "unknown" && output.symbols.length === 0) return null;
 	return {
 		path: filePath,
@@ -478,8 +478,7 @@ function fileMapFromReadseekOutput(output: ReadseekMapOutput, filePath: string,
 		totalBytes,
 		language: normalizeLanguage(output.language),
 		detailLevel: DetailLevel.Full,
-		imports: [],
-		symbols: symbolsFromReadseek(output.symbols),
+		symbols: symbolsFromReadSeek(output.symbols),
 	};
 }
 
@@ -488,21 +487,21 @@ export async function readseekMap(
 	totalBytes: number,
 	options: { signal?: AbortSignal } = {},
 ): Promise<FileMap | null> {
-	const output = parseMapOutput(await runReadseek(["map", filePath], { signal: options.signal }));
-	return fileMapFromReadseekOutput(output, filePath, totalBytes);
+	const output = parseMapOutput(await runReadSeek(["map", filePath], { signal: options.signal }));
+	return fileMapFromReadSeekOutput(output, filePath, totalBytes);
 }
 
 export async function readseekSearch(
 	target: string,
 	pattern: string,
-	options: ReadseekSearchOptions = {},
-): Promise<ReadseekSearchFileOutput[]> {
+	options: ReadSeekSearchOptions = {},
+): Promise<ReadSeekSearchFileOutput[]> {
 	const args = ["search", target, pattern];
 	if (options.language) args.push("--language", options.language);
 	if (options.cached) args.push("--cached");
 	if (options.others) args.push("--others");
 	if (options.ignored) args.push("--ignored");
-	return parseSearchOutput(await runReadseek(args, { signal: options.signal })).results;
+	return parseSearchOutput(await runReadSeek(args, { signal: options.signal })).results;
 }
 
 export async function readseekMapContent(
@@ -511,9 +510,9 @@ export async function readseekMapContent(
 	options: { signal?: AbortSignal } = {},
 ): Promise<FileMap | null> {
 	const output = parseMapOutput(
-		await runReadseek(["map", "--stdin", filePath], { signal: options.signal, stdin: content }),
+		await runReadSeek(["map", "--stdin", filePath], { signal: options.signal, stdin: content }),
 	);
-	return fileMapFromReadseekOutput(output, filePath, Buffer.byteLength(content, "utf8"));
+	return fileMapFromReadSeekOutput(output, filePath, Buffer.byteLength(content, "utf8"));
 }
 
 function optionalString(value: unknown, field: string): string | undefined {
@@ -521,7 +520,7 @@ function optionalString(value: unknown, field: string): string | undefined {
 	return requireString(value, field);
 }
 
-function parseRefsOutput(value: unknown): ReadseekRefsOutput {
+function parseRefsOutput(value: unknown): ReadSeekRefsOutput {
 	if (!value || typeof value !== "object") throw new Error("invalid readseek refs output");
 	const output = value as Record<string, unknown>;
 	if (!Array.isArray(output.references)) throw new Error("invalid readseek references");
@@ -549,8 +548,8 @@ function parseRefsOutput(value: unknown): ReadseekRefsOutput {
 export async function readseekRefs(
 	target: string,
 	name: string,
-	options: ReadseekRefsOptions = {},
-): Promise<ReadseekReference[]> {
+	options: ReadSeekRefsOptions = {},
+): Promise<ReadSeekReference[]> {
 	const args = ["refs", target, name];
 	if (options.scope) args.push("--scope");
 	if (options.line !== undefined) args.push("--line", String(options.line));
@@ -559,15 +558,15 @@ export async function readseekRefs(
 	if (options.cached) args.push("--cached");
 	if (options.others) args.push("--others");
 	if (options.ignored) args.push("--ignored");
-	return parseRefsOutput(await runReadseek(args, { signal: options.signal })).references;
+	return parseRefsOutput(await runReadSeek(args, { signal: options.signal })).references;
 }
 
-function parseDiagnosticKind(value: unknown): ReadseekDiagnostic["kind"] {
+function parseDiagnosticKind(value: unknown): ReadSeekDiagnostic["kind"] {
 	if (value === "error" || value === "missing") return value;
 	throw new Error("invalid readseek diagnostic.kind");
 }
 
-function parseCheckOutput(value: unknown): ReadseekCheckOutput {
+function parseCheckOutput(value: unknown): ReadSeekCheckOutput {
 	if (!value || typeof value !== "object") throw new Error("invalid readseek check output");
 	const output = value as Record<string, unknown>;
 	if (!Array.isArray(output.diagnostics)) throw new Error("invalid readseek diagnostics");
@@ -590,8 +589,8 @@ export async function readseekCheck(
 	filePath: string,
 	content: string,
 	options: { signal?: AbortSignal } = {},
-): Promise<ReadseekCheckOutput> {
+): Promise<ReadSeekCheckOutput> {
 	return parseCheckOutput(
-		await runReadseek(["check", "--stdin", filePath], { signal: options.signal, stdin: content }),
+		await runReadSeek(["check", "--stdin", filePath], { signal: options.signal, stdin: content }),
 	);
 }

package/src/readseek-settings.ts

@@ -2,20 +2,20 @@ import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 
-export interface ReadseekJsonSettings {
+interface ReadSeekJsonSettings {
   grep?: { maxLines?: number; maxBytes?: number };
   edit?: { diffDisplay?: "collapsed" | "expanded" };
 }
 
-export interface ReadseekSettingsWarning {
+interface ReadSeekSettingsWarning {
   source: string;
   message: string;
   path?: string;
 }
 
-export interface ReadseekSettingsResult {
-  settings: ReadseekJsonSettings;
-  warnings: ReadseekSettingsWarning[];
+interface ReadSeekSettingsResult {
+  settings: ReadSeekJsonSettings;
+  warnings: ReadSeekSettingsWarning[];
 }
 
 
@@ -31,7 +31,7 @@ function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
-function invalid(source: string, path: string): ReadseekSettingsWarning {
+function invalid(source: string, path: string): ReadSeekSettingsWarning {
   return { source, path, message: `Invalid readseek setting at ${path}` };
 }
 
@@ -40,7 +40,7 @@ function readPositive(
   key: string,
   path: string,
   source: string,
-  warnings: ReadseekSettingsWarning[],
+  warnings: ReadSeekSettingsWarning[],
 ): number | undefined {
   if (!(key in raw)) return undefined;
   const val = raw[key];
@@ -50,13 +50,13 @@ function readPositive(
 }
 
 
-function validateSettings(raw: unknown, source: string): ReadseekSettingsResult {
-  const settings: ReadseekJsonSettings = {};
-  const warnings: ReadseekSettingsWarning[] = [];
+function validateSettings(raw: unknown, source: string): ReadSeekSettingsResult {
+  const settings: ReadSeekJsonSettings = {};
+  const warnings: ReadSeekSettingsWarning[] = [];
   if (!isRecord(raw)) return { settings, warnings };
 
   if (isRecord(raw.grep)) {
-    const grep: NonNullable<ReadseekJsonSettings["grep"]> = {};
+    const grep: NonNullable<ReadSeekJsonSettings["grep"]> = {};
     const maxLines = readPositive(raw.grep, "maxLines", "grep.maxLines", source, warnings);
     if (maxLines !== undefined) grep.maxLines = maxLines;
     const maxBytes = readPositive(raw.grep, "maxBytes", "grep.maxBytes", source, warnings);
@@ -66,7 +66,7 @@ function validateSettings(raw: unknown, source: string): ReadseekSettingsResult
 
 
   if (isRecord(raw.edit)) {
-    const edit: NonNullable<ReadseekJsonSettings["edit"]> = {};
+    const edit: NonNullable<ReadSeekJsonSettings["edit"]> = {};
     if ("diffDisplay" in raw.edit) {
       const value = raw.edit.diffDisplay;
       if (value === "collapsed" || value === "expanded") edit.diffDisplay = value;
@@ -78,7 +78,7 @@ function validateSettings(raw: unknown, source: string): ReadseekSettingsResult
   return { settings, warnings };
 }
 
-function readSettingsFile(path: string): ReadseekSettingsResult {
+function readSettingsFile(path: string): ReadSeekSettingsResult {
   if (!existsSync(path)) return { settings: {}, warnings: [] };
 
   try {
@@ -90,8 +90,8 @@ function readSettingsFile(path: string): ReadseekSettingsResult {
   }
 }
 
-function mergeSettings(base: ReadseekJsonSettings, override: ReadseekJsonSettings): ReadseekJsonSettings {
-  const merged: ReadseekJsonSettings = {};
+function mergeSettings(base: ReadSeekJsonSettings, override: ReadSeekJsonSettings): ReadSeekJsonSettings {
+  const merged: ReadSeekJsonSettings = {};
   const grep = { ...(base.grep ?? {}), ...(override.grep ?? {}) };
   if (Object.keys(grep).length > 0) merged.grep = grep;
   const edit = { ...(base.edit ?? {}), ...(override.edit ?? {}) };
@@ -99,7 +99,7 @@ function mergeSettings(base: ReadseekJsonSettings, override: ReadseekJsonSetting
   return merged;
 }
 
-export function resolveReadseekJsonSettings(): ReadseekSettingsResult {
+export function resolveReadSeekJsonSettings(): ReadSeekSettingsResult {
   const globalResult = readSettingsFile(defaultGlobalSettingsPath());
   const projectResult = readSettingsFile(defaultProjectSettingsPath());
   return {
@@ -114,7 +114,7 @@ export function resolveEditDiffDisplay(env: NodeJS.ProcessEnv = process.env): "c
     const normalized = raw.trim().toLowerCase();
     if (normalized === "expanded" || normalized === "collapsed") return normalized;
   }
-  const json = resolveReadseekJsonSettings().settings.edit?.diffDisplay;
+  const json = resolveReadSeekJsonSettings().settings.edit?.diffDisplay;
   if (json === "expanded" || json === "collapsed") return json;
   return "collapsed";
 }

package/src/readseek-value.ts

@@ -1,7 +1,7 @@
 import { computeLineHash, escapeControlCharsForDisplay } from "./hashline.js";
 import type { DiffData } from "./diff-data.js";
 
-export interface ReadseekLine {
+export interface ReadSeekLine {
   line: number;
   hash: string;
   anchor: string;
@@ -9,29 +9,29 @@ export interface ReadseekLine {
   display: string;
 }
 
-export interface ReadseekWarningSymbol {
+export interface ReadSeekWarningSymbol {
   name: string;
   kind: string;
   startLine: number;
   endLine: number;
   parentName?: string;
 }
-export interface ReadseekWarning {
+export interface ReadSeekWarning {
   code: string;
   message: string;
   tier?: "camelCase" | "substring";
-  symbol?: ReadseekWarningSymbol;
-  otherCandidates?: ReadseekWarningSymbol[];
+  symbol?: ReadSeekWarningSymbol;
+  otherCandidates?: ReadSeekWarningSymbol[];
 }
 
-export interface ReadseekError {
+export interface ReadSeekError {
   code: string;
   message: string;
   hint?: string;
   details?: unknown;
 }
 
-export interface ReadseekRange {
+export interface ReadSeekRange {
   startLine: number;
   endLine: number;
   totalLines?: number;
@@ -42,7 +42,7 @@ export interface SemanticSummary {
   difftasticAvailable: boolean;
   movedBlocks?: number;
 }
-export interface ReadseekEditResult {
+export interface ReadSeekEditResult {
   tool: "edit";
   ok: boolean;
   path: string;
@@ -56,11 +56,11 @@ export interface ReadseekEditResult {
 }
 
 /**
- * Build a {@link ReadseekLine} from an already-known hash. Use this when the
+ * Build a {@link ReadSeekLine} from an already-known hash. Use this when the
  * hash is supplied by readseek (search, refs) rather than computed from `raw`;
- * {@link buildReadseekLine} delegates here after hashing.
+ * {@link buildReadSeekLine} delegates here after hashing.
  */
-export function buildReadseekLineWithHash(line: number, hash: string, raw: string): ReadseekLine {
+export function buildReadSeekLineWithHash(line: number, hash: string, raw: string): ReadSeekLine {
   return {
     line,
     hash,
@@ -70,36 +70,36 @@ export function buildReadseekLineWithHash(line: number, hash: string, raw: strin
   };
 }
 
-export function buildReadseekLine(line: number, raw: string): ReadseekLine {
-  return buildReadseekLineWithHash(line, computeLineHash(raw), raw);
+export function buildReadSeekLine(line: number, raw: string): ReadSeekLine {
+  return buildReadSeekLineWithHash(line, computeLineHash(raw), raw);
 }
 
-export function buildReadseekLines(startLine: number, rawLines: string[]): ReadseekLine[] {
-  return rawLines.map((raw, index) => buildReadseekLine(startLine + index, raw));
+export function buildReadSeekLines(startLine: number, rawLines: string[]): ReadSeekLine[] {
+  return rawLines.map((raw, index) => buildReadSeekLine(startLine + index, raw));
 }
 
-function renderReadseekLine(line: ReadseekLine): string {
+function renderReadSeekLine(line: ReadSeekLine): string {
   return `${line.anchor}|${line.display}`;
 }
 
-export function renderReadseekLines(lines: ReadseekLine[]): string {
-  return lines.map(renderReadseekLine).join("\n");
+export function renderReadSeekLines(lines: ReadSeekLine[]): string {
+  return lines.map(renderReadSeekLine).join("\n");
 }
 
-export function buildReadseekWarning(
+export function buildReadSeekWarning(
   code: string,
   message: string,
-  metadata: Omit<ReadseekWarning, "code" | "message"> = {},
-): ReadseekWarning {
+  metadata: Omit<ReadSeekWarning, "code" | "message"> = {},
+): ReadSeekWarning {
   return { code, message, ...metadata };
 }
 
-export function buildReadseekError(
+export function buildReadSeekError(
   code: string,
   message: string,
   hint?: string,
   details?: unknown,
-): ReadseekError {
+): ReadSeekError {
   return {
     code,
     message,
@@ -117,7 +117,7 @@ export interface ToolErrorResult {
 /**
  * Build the standard failure envelope shared by every read-family tool: a text
  * content block plus a `readseekValue` carrying `ok: false` and a
- * {@link buildReadseekError} payload.
+ * {@link buildReadSeekError} payload.
  *
  * `path` is included only when provided, and `extra` is merged into
  * `readseekValue` so callers can attach tool-specific fields (e.g. write's
@@ -138,13 +138,13 @@ export function buildToolErrorResult(
         ...(opts.extra ?? {}),
         ok: false,
         ...(opts.path !== undefined ? { path: opts.path } : {}),
-        error: buildReadseekError(code, message, opts.hint, opts.details),
+        error: buildReadSeekError(code, message, opts.hint, opts.details),
       },
     },
   };
 }
 
-export function buildReadseekEditResult(input: {
+export function buildReadSeekEditResult(input: {
   ok?: boolean;
   path: string;
   summary: string;
@@ -154,7 +154,7 @@ export function buildReadseekEditResult(input: {
   warnings: string[];
   noopEdits: unknown[];
   semanticSummary?: SemanticSummary;
-}): ReadseekEditResult {
+}): ReadSeekEditResult {
   return {
     tool: "edit",
     ok: input.ok ?? true,

package/src/refs-output.ts

@@ -1,6 +1,6 @@
-import type { ReadseekLine } from "./readseek-value.js";
+import type { ReadSeekLine } from "./readseek-value.js";
 
-export interface RefsOutputLine extends ReadseekLine {
+export interface RefsOutputLine extends ReadSeekLine {
   enclosingSymbol?: string;
 }
 
@@ -10,12 +10,12 @@ export interface RefsOutputFile {
   lines: RefsOutputLine[];
 }
 
-export interface BuildRefsOutputInput {
+interface BuildRefsOutputInput {
   name: string;
   files: RefsOutputFile[];
 }
 
-export interface RefsOutputResult {
+interface RefsOutputResult {
   text: string;
   readseekValue: {
     tool: "refs";