@possumtech/rummy 0.2.7 → 0.3.0

package/src/plugins/cp/README.md

@@ -5,9 +5,8 @@ Copies an entry from one path to another within the K/V store.
 ## Registration
 
 - **Tool**: `cp`
-- **Modes**: ask, act
-- **Category**: act
-- **Handler**: Reads source body, writes to destination. K/V destinations resolve immediately (`pass`); file destinations produce a `proposed` entry.
+- **Category**: `logging`
+- **Handler**: Reads source body, writes to destination. Scheme destinations resolve immediately (status 200); file destinations produce status 202 (proposed).
 
 ## Projection
 
@@ -15,4 +14,6 @@ Shows `cp {from} {to}`.
 
 ## Behavior
 
-Warns if the destination already exists and will be overwritten. Uses `KnownStore.scheme()` to determine whether the destination is a K/V path or a file path.
+Warns if the destination already exists and will be overwritten. Uses
+`KnownStore.scheme()` to determine whether the destination is a scheme
+path or a file path.

package/src/plugins/cp/cp.js

@@ -1,26 +1,28 @@
-import { readFileSync } from "node:fs";
 import KnownStore from "../../agent/KnownStore.js";
+import docs from "./cpDoc.js";
 
 export default class Cp {
 	#core;
 
 	constructor(core) {
 		this.#core = core;
-		core.registerScheme({
-			validStates: ["full", "proposed", "pass", "rejected", "error", "pattern"],
-		});
+		core.registerScheme();
 		core.on("handler", this.handler.bind(this));
 		core.on("full", this.full.bind(this));
 		core.on("summary", this.summary.bind(this));
-		const docs = readFileSync(new URL("./docs.md", import.meta.url), "utf8");
-		core.filter("instructions.toolDocs", async (content) =>
-			content ? `${content}\n\n${docs}` : docs,
-		);
+		core.filter("instructions.toolDocs", async (docsMap) => {
+			docsMap.cp = docs;
+			return docsMap;
+		});
 	}
 
 	async handler(entry, rummy) {
-		const { entries: store, sequence: turn, runId } = rummy;
+		const { entries: store, sequence: turn, runId, loopId } = rummy;
 		const { path, to } = entry.attributes;
+		const VALID = { stored: 1, summary: 1, index: 1, full: 1 };
+		const fidelity = VALID[entry.attributes.fidelity]
+			? entry.attributes.fidelity
+			: undefined;
 
 		const source = await store.getBody(runId, path);
 		if (source === null) return;
@@ -34,13 +36,15 @@ export default class Cp {
 
 		const body = `${path} ${to}`;
 		if (destScheme === null) {
-			await store.upsert(runId, turn, entry.resultPath, body, "proposed", {
+			await store.upsert(runId, turn, entry.resultPath, body, 202, {
 				attributes: { from: path, to, isMove: false, warning },
+				loopId,
 			});
 		} else {
-			await store.upsert(runId, turn, to, source, "full");
-			await store.upsert(runId, turn, entry.resultPath, body, "pass", {
+			await store.upsert(runId, turn, to, source, 200, { fidelity, loopId });
+			await store.upsert(runId, turn, entry.resultPath, body, 200, {
 				attributes: { from: path, to, isMove: false, warning },
+				loopId,
 			});
 		}
 	}

package/src/plugins/cp/cpDoc.js

@@ -0,0 +1,29 @@
+// Tool doc for <cp>. Each entry: [text, rationale].
+// Text goes to the model. Rationale stays in source.
+// Changing ANY line requires reading ALL rationales first.
+const LINES = [
+	// --- Syntax: path attr = source, body = destination
+	['## <cp path="[source]">[destination]</cp> - Copy a file or entry'],
+
+	// --- Examples: single copy, glob batch, cross-scheme
+	[
+		'Example: <cp path="src/config.js">src/config.backup.js</cp>',
+		"Simple file copy. Path = source, body = destination.",
+	],
+	[
+		'Example: <cp path="known://plan_*">known://archive_</cp>',
+		"Glob batch copy across known entries. Shows pattern operations on cp.",
+	],
+
+	// --- Constraints
+	[
+		"* Source path accepts globs: `src/*.js`, `known://draft_*`",
+		"Pattern support. Distributes glob teaching beyond get.",
+	],
+	[
+		"* Use `preview` to check matches before bulk copy",
+		"Safety pattern consistent with get and rm preview.",
+	],
+];
+
+export default LINES.map(([text]) => text).join("\n");

package/src/plugins/current/README.md

@@ -1,7 +1,7 @@
 # current
 
 Renders the `<current>` section of the user message — the active loop's
-model responses, tool results, and agent warnings.
+tool results and lifecycle signals.
 
 ## Registration
 
@@ -9,6 +9,6 @@ model responses, tool results, and agent warnings.
 
 ## Behavior
 
-Filters turn_context rows where `category` is `result` or `structural`
-and `source_turn >= loopStartTurn`. Renders each entry chronologically
-with status symbols. Empty on the first turn of a loop.
+Filters turn_context rows where `category === "logging"` and
+`source_turn >= loopStartTurn`. Renders each entry chronologically
+with turn number and status. Empty on the first turn of a loop.

package/src/plugins/current/current.js

@@ -8,33 +8,35 @@ export default class Current {
 
 	async assembleCurrent(content, ctx) {
 		const entries = ctx.rows.filter(
-			(r) =>
-				(r.category === "result" || r.category === "structural") &&
-				r.source_turn >= ctx.loopStartTurn,
+			(r) => r.category === "logging" && r.source_turn >= ctx.loopStartTurn,
 		);
 		if (entries.length === 0) return content;
 
 		const lines = await Promise.all(
-			entries.map((e) => renderToolTag(e, "full", this.#core)),
+			entries.map((e) => renderToolTag(e, this.#core)),
 		);
 		return `${content}<current>\n${lines.join("\n")}\n</current>\n`;
 	}
 }
 
-async function renderToolTag(entry, fidelity, core) {
+async function renderToolTag(entry, core) {
 	const attrs =
 		typeof entry.attributes === "string"
 			? JSON.parse(entry.attributes)
 			: entry.attributes;
 
-	const path = `${entry.scheme}://${attrs?.path || attrs?.file || attrs?.command || ""}`;
-	const status = entry.state ? ` status="${entry.state}"` : "";
+	const target = attrs?.path || attrs?.file || attrs?.command || "";
+	const turn = entry.source_turn ? ` turn="${entry.source_turn}"` : "";
+	const status = entry.status ? ` status="${entry.status}"` : "";
+	const summary =
+		typeof attrs?.summary === "string"
+			? ` summary="${attrs.summary.slice(0, 80)}"`
+			: "";
 
 	let body;
 	try {
 		body = await core.hooks.tools.view(entry.scheme, {
 			...entry,
-			fidelity,
 			attributes: attrs,
 		});
 	} catch {
@@ -42,7 +44,7 @@ async function renderToolTag(entry, fidelity, core) {
 	}
 
 	if (body) {
-		return `<tool path="${path}"${status}>${body}</tool>`;
+		return `<${entry.scheme} path="${target}"${turn}${status}${summary}>${body}</${entry.scheme}>`;
 	}
-	return `<tool path="${path}"${status}/>`;
+	return `<${entry.scheme} path="${target}"${turn}${status}${summary}/>`;
 }

package/src/plugins/engine/engine.sql

@@ -1,18 +1,13 @@
 -- PREP: get_promoted_entries
-SELECT ke.path, ke.scheme, ke.state, ke.turn, ke.tokens, ke.refs
+SELECT
+	ke.path, ke.scheme, ke.status, ke.fidelity, ke.turn
+	, ke.tokens, ke.refs
 FROM known_entries AS ke
 JOIN schemes AS s ON s.name = COALESCE(ke.scheme, 'file')
 WHERE
 	ke.run_id = :run_id
-	AND ke.state IN ('full', 'summary')
+	AND ke.fidelity IN ('full', 'summary')
 	AND s.model_visible = 1
 ORDER BY ke.turn, ke.refs, ke.tokens DESC;
 
--- PREP: get_promoted_token_total
-SELECT COALESCE(SUM(ke.tokens), 0) AS total
-FROM known_entries AS ke
-JOIN schemes AS s ON s.name = COALESCE(ke.scheme, 'file')
-WHERE
-	ke.run_id = :run_id
-	AND ke.state IN ('full', 'summary')
-	AND s.model_visible = 1;
+

package/src/plugins/engine/turn_context.sql

@@ -4,22 +4,27 @@ WHERE run_id = :run_id AND turn = :turn;
 
 -- PREP: get_model_context
 SELECT
-	ordinal, path, scheme, fidelity, state, body, tokens, attributes, category, turn
+	ordinal, path, scheme, fidelity, status, body
+	, tokens, attributes, category, turn
 FROM v_model_context
 WHERE run_id = :run_id
 ORDER BY ordinal;
 
 -- PREP: insert_turn_context
 INSERT INTO turn_context (
-	run_id, turn, ordinal, path, fidelity, state, body, tokens, attributes, category, source_turn
+	run_id, loop_id, turn, ordinal, path, fidelity, status
+	, body, tokens, attributes, category, source_turn
 )
 VALUES (
-	:run_id, :turn, :ordinal, :path, :fidelity, :state, :body, :tokens
+	:run_id, :loop_id, :turn, :ordinal, :path, :fidelity
+	, :status, :body, :tokens
 	, COALESCE(:attributes, '{}'), :category, :source_turn
 );
 
 -- PREP: get_turn_context
-SELECT ordinal, path, scheme, fidelity, state, body, tokens, attributes, category, source_turn
+SELECT
+	ordinal, path, scheme, fidelity, status, body
+	, tokens, attributes, category, source_turn
 FROM turn_context
 WHERE run_id = :run_id AND turn = :turn
 ORDER BY ordinal;
@@ -32,15 +37,10 @@ WHERE run_id = :run_id AND turn = :turn;
 -- PREP: get_turn_distribution
 SELECT
 	CASE category
-		WHEN 'file' THEN 'files'
-		WHEN 'file_symbols' THEN 'files'
-		WHEN 'file_index' THEN 'keys'
-		WHEN 'known' THEN 'known'
-		WHEN 'known_index' THEN 'keys'
-		WHEN 'unknown' THEN 'history'
-		WHEN 'result' THEN 'history'
-		WHEN 'prompt' THEN 'system'
-		WHEN 'system' THEN 'system'
+		WHEN 'data' THEN 'data'
+		WHEN 'logging' THEN 'logging'
+		WHEN 'unknown' THEN 'unknown'
+		WHEN 'prompt' THEN 'prompt'
 		ELSE 'system'
 	END AS bucket,
 	COALESCE(SUM(tokens), 0) AS tokens,

package/src/plugins/env/README.md

@@ -1,13 +1,12 @@
 # env
 
-Stores environment/context information as a pass-through entry.
+Runs an exploratory shell command and records the output.
 
 ## Registration
 
 - **Tool**: `env`
-- **Modes**: ask, act
-- **Category**: ask
-- **Handler**: Upserts the entry body as `pass` state with original attributes preserved.
+- **Category**: `logging`
+- **Handler**: Upserts the entry at status 202 (proposed) with original attributes preserved.
 
 ## Projection
 

package/src/plugins/env/env.js

@@ -1,4 +1,4 @@
-import { readFileSync } from "node:fs";
+import docs from "./envDoc.js";
 
 export default class Env {
 	#core;
@@ -9,16 +9,17 @@ export default class Env {
 		core.on("handler", this.handler.bind(this));
 		core.on("full", this.full.bind(this));
 		core.on("summary", this.summary.bind(this));
-		const docs = readFileSync(new URL("./docs.md", import.meta.url), "utf8");
-		core.filter("instructions.toolDocs", async (content) =>
-			content ? `${content}\n\n${docs}` : docs,
-		);
+		core.filter("instructions.toolDocs", async (docsMap) => {
+			docsMap.env = docs;
+			return docsMap;
+		});
 	}
 
 	async handler(entry, rummy) {
-		const { entries: store, sequence: turn, runId } = rummy;
-		await store.upsert(runId, turn, entry.resultPath, entry.body, "pass", {
+		const { entries: store, sequence: turn, runId, loopId } = rummy;
+		await store.upsert(runId, turn, entry.resultPath, entry.body, 202, {
 			attributes: entry.attributes,
+			loopId,
 		});
 	}
 

package/src/plugins/env/envDoc.js

@@ -0,0 +1,29 @@
+// Tool doc for <env>. Each entry: [text, rationale].
+// Text goes to the model. Rationale stays in source.
+// Changing ANY line requires reading ALL rationales first.
+const LINES = [
+	// --- Syntax
+	["## <env>[command]</env> - Run an exploratory shell command"],
+
+	// --- Examples: version check and git status — safe, read-only commands
+	[
+		"Example: <env>npm --version</env>",
+		"Version check. Safe, no side effects.",
+	],
+	[
+		"Example: <env>git log --oneline -5</env>",
+		"Git history. Shows env for read-only investigation.",
+	],
+
+	// --- Constraints: hard boundaries
+	[
+		'* YOU MUST NOT use <env/> to read or list files — use <get path="*" preview/> instead',
+		"Prevents cat/ls through shell. Forces file access through get for proper tracking.",
+	],
+	[
+		"* YOU MUST use <sh/> for commands with side effects",
+		"Separates exploration from action. env = observe, sh = mutate.",
+	],
+];
+
+export default LINES.map(([text]) => text).join("\n");

package/src/plugins/file/README.md

@@ -2,24 +2,21 @@
 
 Owns file-related projections and file constraint management.
 
-## Files
-
-- **file.js** — Plugin registration, projection hooks, and constraint CRUD (activate, ignore, drop).
-- **FileScanner.js** — Scans project directories for file entries.
-- **GitProvider.js** — Git integration for file discovery and status.
-- **ProjectContext.js** — Builds project-level context from scanned files.
-- **FsProvider.js** — Filesystem abstraction for file reading/writing.
-
 ## Registration
 
-- **Projections**: Registers `onProject` handlers for schemes: `file`, `known`, `skill`, `ask`, `act`, `progress`. All project the entry body directly.
+- **Schemes**: `file` (bare paths), `http`, `https` — all `category: "data"`
+- **Views**: `full` and `summary` for file scheme. Default identity views
+  for `http`/`https` (overridden by rummy.web when installed).
 - **No tool handler** — file operations are dispatched through `set`, `get`, `rm`, etc.
 
 ## File Constraints
 
-Static methods `activate`, `ignore`, and `drop` manage per-project file constraints in the database. Constraints control file visibility across all runs:
+Static methods `setConstraint` and `dropConstraint` manage per-project
+file constraints in the database. Constraints are project-level config
+(backbone), not tool dispatch. See SPEC.md §2.3.
 
-- `active` / `readonly` — always promoted into context.
+- `active` / `readonly` — promoted into context.
 - `ignore` — excluded from scans; demotes existing entries.
 
-Paths are normalized to project-relative when absolute.
+Entry promotion/demotion from constraints goes through the standard
+tool handler chain via `dispatchTool`.

package/src/plugins/file/file.js

@@ -1,48 +1,45 @@
 import { isAbsolute, relative } from "node:path";
 
+/**
+ * File plugin: projections and constraints for filesystem entries.
+ *
+ * Bare file paths (src/app.js) have scheme=NULL in the DB because
+ * schemeOf() only recognizes "://" patterns. The schemes table has
+ * a "file" entry so v_model_context can JOIN via COALESCE(scheme, 'file').
+ * This is the one exception to "every scheme has a plugin owner" —
+ * the file plugin owns the NULL scheme through the "file" registry entry.
+ */
 export default class File {
 	#core;
 
 	constructor(core) {
 		this.#core = core;
-		core.registerScheme({
-			fidelity: "turn",
-			validStates: ["full", "summary", "index", "stored"],
-			category: "file",
-		});
-		core.registerScheme({
-			name: "http",
-			fidelity: "turn",
-			validStates: ["full", "summary", "stored"],
-			category: "file",
-		});
-		core.registerScheme({
-			name: "https",
-			fidelity: "turn",
-			validStates: ["full", "summary", "stored"],
-			category: "file",
-		});
+		// "file" scheme covers bare paths (scheme IS NULL in DB)
+		core.registerScheme({ category: "data" });
+		core.registerScheme({ name: "http", category: "data" });
+		core.registerScheme({ name: "https", category: "data" });
 		core.on("full", this.full.bind(this));
-
-		// Register identity projections for schemes that just pass through body
-		for (const scheme of ["known", "skill", "ask", "act", "progress"]) {
-			core.hooks.tools.onView(scheme, (entry) => entry.body);
-		}
+		core.on("summary", this.summary.bind(this));
+		// Default identity views for http/https — rummy.web overrides these
+		core.hooks.tools.onView("http", (entry) => entry.body);
+		core.hooks.tools.onView("https", (entry) => entry.body);
 	}
 
 	full(entry) {
 		return entry.body;
 	}
 
-	static async activate(
-		db,
-		knownStore,
-		projectId,
-		pattern,
-		visibility = "active",
-	) {
+	summary() {
+		return "";
+	}
+
+	/**
+	 * Set a project-level file constraint. Backbone operation —
+	 * constraints are project config, not tool dispatch.
+	 */
+	static async setConstraint(db, projectId, pattern, visibility = "active") {
 		const path = await normalizePath(db, projectId, pattern);
-		if (!path) return { status: "ok" };
+		if (!path) return null;
 
 		await db.upsert_file_constraint.run({
 			project_id: projectId,
@@ -50,30 +47,22 @@ export default class File {
 			visibility,
 		});
 
-		if (visibility === "ignore") {
-			const runs = await db.get_all_runs.all({ project_id: projectId });
-			for (const run of runs) {
-				await knownStore.demoteByPattern(run.id, path, null);
-			}
-		}
-
-		return { status: "ok" };
-	}
-
-	static async ignore(db, knownStore, projectId, pattern) {
-		return File.activate(db, knownStore, projectId, pattern, "ignore");
+		return path;
 	}
 
-	static async drop(db, projectId, pattern) {
+	/**
+	 * Remove a project-level file constraint.
+	 */
+	static async dropConstraint(db, projectId, pattern) {
 		const path = await normalizePath(db, projectId, pattern);
-		if (!path) return { status: "ok" };
+		if (!path) return null;
 
 		await db.delete_file_constraint.run({
 			project_id: projectId,
 			pattern: path,
 		});
 
-		return { status: "ok" };
+		return path;
 	}
 }
 

package/src/plugins/get/README.md

@@ -5,8 +5,7 @@ Retrieves and promotes entries by path or glob pattern.
 ## Registration
 
 - **Tool**: `get`
-- **Modes**: ask, act
-- **Category**: ask
+- **Category**: `logging`
 - **Handler**: Fetches matching entries via `getEntriesByPattern`, promotes them with `promoteByPattern`, and records the result.
 
 ## Projection
@@ -17,3 +16,4 @@ Shows `get {path}` followed by the entry body.
 
 - Pattern queries (globs or body filters) produce a summary of matched paths.
 - Exact path queries report the path and token count, or "not found".
+- Budget check: rejects with 413 if incoming tokens exceed remaining context.

package/src/plugins/get/get.js

@@ -1,28 +1,42 @@
-import { readFileSync } from "node:fs";
+import KnownStore from "../../agent/KnownStore.js";
 import { storePatternResult } from "../helpers.js";
+import docs from "./getDoc.js";
 
 export default class Get {
 	#core;
 
 	constructor(core) {
 		this.#core = core;
-		core.registerScheme({ validStates: ["full", "read", "pattern"] });
+		core.registerScheme();
 		core.on("handler", this.handler.bind(this));
 		core.on("full", this.full.bind(this));
 		core.on("summary", this.summary.bind(this));
-		const docs = readFileSync(new URL("./docs.md", import.meta.url), "utf8");
-		core.filter("instructions.toolDocs", async (content) =>
-			content ? `${content}\n\n${docs}` : docs,
-		);
+		core.filter("instructions.toolDocs", async (docsMap) => {
+			docsMap.get = docs;
+			return docsMap;
+		});
 	}
 
 	async handler(entry, rummy) {
-		const { entries: store, sequence: turn, runId } = rummy;
+		const { entries: store, sequence: turn, runId, loopId } = rummy;
 		const target = entry.attributes.path;
+		if (!target) {
+			await store.upsert(runId, turn, entry.resultPath, "", 400, {
+				attributes: { error: "path is required" },
+				loopId,
+			});
+			return;
+		}
+		const normalized = KnownStore.normalizePath(target);
 		const bodyFilter = entry.attributes.body || null;
-		const isPattern = bodyFilter || target.includes("*");
-		const matches = await store.getEntriesByPattern(runId, target, bodyFilter);
-		await store.promoteByPattern(runId, target, bodyFilter, turn);
+		const isPattern = bodyFilter || normalized.includes("*");
+		const matches = await store.getEntriesByPattern(
+			runId,
+			normalized,
+			bodyFilter,
+		);
+
+		await store.promoteByPattern(runId, normalized, bodyFilter, turn);
 
 		if (isPattern) {
 			await storePatternResult(
@@ -33,13 +47,16 @@ export default class Get {
 				target,
 				bodyFilter,
 				matches,
+				{ loopId },
 			);
 		} else {
 			const total = matches.reduce((s, m) => s + m.tokens_full, 0);
 			const paths = matches.map((m) => m.path).join(", ");
 			const body =
 				matches.length > 0 ? `${paths} ${total} tokens` : `${target} not found`;
-			await store.upsert(runId, turn, entry.resultPath, body, "read");
+			await store.upsert(runId, turn, entry.resultPath, body, 200, {
+				loopId,
+			});
 		}
 	}
 

package/src/plugins/get/getDoc.js

@@ -0,0 +1,41 @@
+// Tool doc for <get>. Each entry: [text, rationale].
+// Text goes to the model. Rationale stays in source.
+// Changing ANY line requires reading ALL rationales first.
+const LINES = [
+	// --- Syntax: body-form is the primary invocation (simplest)
+	["## <get>[path/to/file]</get> - Load a file or entry into context"],
+
+	// --- Examples: 3 examples covering single file, known recall, and content search
+	[
+		"Example: <get>src/app.js</get>",
+		"Simplest form. Body = path. Teaches that get is the default read tool.",
+	],
+	[
+		'Example: <get path="known://*">auth</get>',
+		"Keyword recall: glob in path, search term in body. Cross-scheme hedberg pattern.",
+	],
+	[
+		'Example: <get path="src/**/*.js" preview>TODO</get>',
+		"Full pattern: recursive glob + preview + content filter. Shows all 3 features at once.",
+	],
+
+	// --- Constraints: RFC-style. Each prevents a specific failure mode.
+	[
+		"* Paths accept globs: `src/**/*.js`, `known://api_*`",
+		"Reinforces picomatch patterns work everywhere, not just in examples.",
+	],
+	[
+		"* `preview` shows matches without loading into context",
+		"Budget-awareness. Without this, models load everything and blow context.",
+	],
+	[
+		"* Body text filters results by content match",
+		"Generalizes examples 2-3. Body = filter, not just path.",
+	],
+	[
+		'* Use <set path="..." fidelity="index"/> to archive loaded content',
+		"Lifecycle: get→set. Load, read, archive. Prevents context hoarding.",
+	],
+];
+
+export default LINES.map(([text]) => text).join("\n");

package/src/plugins/hedberg/docs.md

@@ -1,9 +0,0 @@
-# Advanced Patterns
-* Paths accept globs: `src/**/*.js`, `known://api_*`
-* Body attributes filter by content: `<get path="src/*.js" body="TODO"/>`
-* Regex patterns use /slashes/: `<get path="/\.test\.js$/" preview/>`
-* Adding `preview` shows matches without making changes
-* Chain multiple replacements: `s/old/new/ s/foo/bar/`
-Example: <get path="src/**/*.js" body="TODO" preview/> (list js files containing TODO)
-Example: <store path="src/**/*.test.js"/> (store all test files)
-Example: <rm path="known://temp_*" preview/> (preview which temp entries would be deleted)

package/src/plugins/hedberg/hedberg.js

@@ -1,7 +1,6 @@
-import { readFileSync } from "node:fs";
 import { parseEditContent } from "./edits.js";
 import HeuristicMatcher, { generatePatch } from "./matcher.js";
-import { normalizeAttrs } from "./normalize.js";
+import { normalizeAttrs, parseJsonEdit } from "./normalize.js";
 import { hedmatch, hedsearch } from "./patterns.js";
 import { parseSed } from "./sed.js";
 
@@ -30,14 +29,13 @@ export default class Hedberg {
 			replace: Hedberg.replace,
 			parseSed,
 			parseEdits: parseEditContent,
+			parseJsonEdit,
 			normalizeAttrs,
 			generatePatch,
 		};
 
-		const docs = readFileSync(new URL("./docs.md", import.meta.url), "utf8");
-		core.filter("instructions.toolDocs", async (content) =>
-			content ? `${content}\n\n${docs}` : docs,
-		);
+		// Patterns documentation distributed to individual tool docs.
+		// Hedberg has no model-facing docs of its own.
 	}
 
 	/**

package/src/plugins/hedberg/matcher.js

@@ -120,7 +120,7 @@ export default class HeuristicMatcher {
 				patch: null,
 				warning: null,
 				error:
-					"Could not find the SEARCH block in the file. Ensure you are providing an exact match of the existing code, without truncating lines with '...'.",
+					"SEARCH blocks are matched literally, not as a pattern. Could not find the SEARCH block in the file.",
 			};
 		}