@possumtech/rummy 0.2.8 → 0.3.1

package/src/plugins/rm/README.md

@@ -5,9 +5,8 @@ Removes entries by path or glob pattern.
 ## Registration
 
 - **Tool**: `rm`
-- **Modes**: ask, act
-- **Category**: act
-- **Handler**: Matches entries by pattern. K/V entries are removed immediately (`pass`); file entries produce `proposed` state for client approval.
+- **Category**: `logging`
+- **Handler**: Matches entries by pattern. Scheme entries are removed immediately (status 200); file entries produce status 202 (proposed) for client approval.
 
 ## Projection
 
@@ -15,4 +14,5 @@ Shows `rm {path}`.
 
 ## Behavior
 
-Supports glob patterns and body filters via `getEntriesByPattern`. Each matched entry is processed independently.
+Supports glob patterns and body filters via `getEntriesByPattern`. Each
+matched entry is processed independently.

package/src/plugins/rm/rm.js

@@ -1,5 +1,5 @@
-import { readFileSync } from "node:fs";
 import KnownStore from "../../agent/KnownStore.js";
+import docs from "./rmDoc.js";
 
 export default class Rm {
 	#core;
@@ -10,10 +10,10 @@ export default class Rm {
 		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.rm = docs;
+			return docsMap;
+		});
 	}
 
 	async handler(entry, rummy) {
@@ -41,25 +41,37 @@ export default class Rm {
 			return;
 		}
 
-		for (const match of matches) {
-			const resultPath = `rm://${match.path}`;
-			if (match.scheme === null) {
-				await store.upsert(runId, turn, resultPath, match.path, 202, {
-					attributes: { path: match.path },
-					loopId,
-				});
-			} else {
-				await store.remove(runId, match.path);
-				await store.upsert(runId, turn, resultPath, match.path, 200, {
-					attributes: { path: match.path },
-					loopId,
-				});
-			}
+		const fileMatches = matches.filter((m) => m.scheme === null);
+		const schemeMatches = matches.filter((m) => m.scheme !== null);
+
+		// Scheme entries: remove all, write one aggregate result entry
+		for (const match of schemeMatches) await store.remove(runId, match.path);
+		if (schemeMatches.length > 0) {
+			const paths = schemeMatches.map((m) => m.path).join("\n");
+			await store.upsert(runId, turn, entry.resultPath, paths, 200, {
+				attributes: { path: target },
+				loopId,
+			});
+		}
+
+		// File entries: individual 202 proposals (require user resolution)
+		if (fileMatches.length > 0 && schemeMatches.length > 0)
+			await store.remove(runId, entry.resultPath);
+		for (const match of fileMatches) {
+			const resultPath =
+				schemeMatches.length === 0 && fileMatches.length === 1
+					? entry.resultPath
+					: await store.dedup(runId, "rm", match.path, turn);
+			await store.upsert(runId, turn, resultPath, match.path, 202, {
+				attributes: { path: match.path },
+				loopId,
+			});
 		}
 	}
 
 	full(entry) {
-		return `# rm ${entry.attributes.path || entry.path}`;
+		const header = `# rm ${entry.attributes.path || entry.path}`;
+		return entry.body ? `${header}\n${entry.body}` : header;
 	}
 
 	summary(entry) {

package/src/plugins/rm/rmDoc.js

@@ -0,0 +1,30 @@
+// Tool doc for <rm>. 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, self-closing
+	['## <rm path="[path]"/> - Remove a file or entry'],
+
+	// --- Examples: file, known (with slug path), preview safety
+	['Example: <rm path="src/config.js"/>', "File removal. Simplest form."],
+	[
+		'Example: <rm path="known://config/deprecated_service"/>',
+		"Shows topic-hierarchy path convention. Paths are category/key, not sentence slugs.",
+	],
+	[
+		'Example: <rm path="known://temp_*" preview/>',
+		"Preview before deleting. Glob pattern. Safety pattern for bulk operations.",
+	],
+
+	// --- Constraints
+	[
+		'* Permanent. Prefer <set fidelity="archive"/> to preserve for later retrieval',
+		"Nudges toward archive over rm. Archive keeps the key; rm deletes permanently.",
+	],
+	[
+		"* Paths accept patterns — use `preview` to check matches first",
+		"Reinforces preview safety pattern. Prevents accidental bulk deletion.",
+	],
+];
+
+export default LINES.map(([text]) => text).join("\n");

package/src/plugins/rpc/README.md

@@ -1,45 +1,32 @@
 # rpc
 
-Registers all core RPC methods and dispatches client operations through the tool handler chain.
+Registers core RPC methods and provides automatic tool dispatch for
+all registered tools.
 
 ## Registration
 
-- **No tool handler** — this plugin registers RPC methods on `hooks.rpc.registry`, not tool handlers.
+- **No tool handler** — registers RPC methods on `hooks.rpc.registry`.
+- **Tool fallback** — any registered tool is automatically callable via
+  RPC without explicit registration. Third-party plugins get RPC for free.
 
 ## RPC Methods
 
 ### Protocol
-- `ping` — liveness check.
-- `discover` — returns method/notification catalog.
-- `init` — initialize project (sets projectId, projectRoot, configPath).
+- `ping`, `discover`, `init`
 
 ### Models
-- `getModels`, `addModel`, `removeModel` — CRUD for model aliases.
+- `getModels`, `addModel`, `removeModel`
 
-### Entry Operations
-- `read` — promote entry to full state, or create persistent file constraint.
-- `store` — demote entry to stored state, or manage file constraints (ignore/clear).
-- `write` — create/update entry. K/V paths write directly; file paths dispatch through `set` handler.
-- `delete` — remove entry via `rm` handler dispatch.
+### Entry Operations (all dispatch through tool handler chain)
+- `get` — promote entry; with `persist` flag, also sets file constraint.
+- `store` — demote entry or manage file constraints (not a model tool).
+- All other registered tools — auto-dispatched via tool fallback.
 - `getEntries` — query entries by glob pattern.
 
 ### Runs
-- `startRun` — pre-create a run with model/config.
-- `ask` — non-mutating model query.
-- `act` — mutating model directive.
-- `run/resolve` — resolve a proposed entry (accept/reject).
-- `run/abort` — abort an in-flight run.
-- `run/rename` — rename a run alias.
-- `run/inject` — inject a message into an idle or active run.
-- `run/config` — update run parameters (temperature, persona, context_limit, model).
-- `getRuns`, `getRun` — query run list and full run detail.
+- `startRun`, `ask`, `act`
+- `run/resolve`, `run/abort`, `run/rename`, `run/inject`, `run/config`
+- `getRuns`, `getRun`
 
 ### Notifications
-- `run/state` — turn state update with history, unknowns, proposed, telemetry.
-- `run/progress` — turn status (thinking/processing).
-- `ui/render` — streaming output.
-- `ui/notify` — toast notification.
-
-## Behavior
-
-Client operations (read, write, delete, store) build a `RummyContext` for the target run and dispatch through the same handler chain as model operations via `dispatchTool`.
+- `run/state`, `run/progress`, `ui/render`, `ui/notify`

package/src/plugins/rpc/rpc.js

@@ -1,4 +1,3 @@
-import KnownStore from "../../agent/KnownStore.js";
 import msg from "../../agent/messages.js";
 import RummyContext from "../../hooks/RummyContext.js";
 import File from "../file/file.js";
@@ -90,15 +89,15 @@ export default class Rpc {
 
 		// --- Entry operations (same dispatch as model) ---
 
+		// Override: get has persist flag for file constraint management
 		r.register("get", {
 			handler: async (params, ctx) => {
 				if (!params.path) throw new Error("path is required");
 
 				if (params.persist) {
 					const visibility = params.readonly ? "readonly" : "active";
-					return File.activate(
+					await File.setConstraint(
 						ctx.db,
-						ctx.projectAgent.entries,
 						ctx.projectId,
 						params.path,
 						visibility,
@@ -115,101 +114,50 @@ export default class Rpc {
 			description: "Promote entry to full state.",
 			params: {
 				path: "string — file path or glob pattern",
-				run: "string? — run alias (required without persist)",
-				persist: "boolean? — create file constraint",
+				run: "string — run alias",
+				persist: "boolean? — also create file constraint",
 				readonly: "boolean? — with persist, set readonly instead of active",
 			},
 			requiresInit: true,
 		});
 
+		// store is not a tool — it manages file constraints
 		r.register("store", {
 			handler: async (params, ctx) => {
 				if (!params.path) throw new Error("path is required");
 
 				if (params.clear) {
-					return File.drop(ctx.db, ctx.projectId, params.path);
+					await File.dropConstraint(ctx.db, ctx.projectId, params.path);
+					return { status: "ok" };
 				}
 				if (params.persist) {
-					if (params.ignore) {
-						return File.ignore(
-							ctx.db,
-							ctx.projectAgent.entries,
-							ctx.projectId,
-							params.path,
-						);
-					}
-					return File.drop(ctx.db, ctx.projectId, params.path);
+					const visibility = params.ignore ? "ignore" : "active";
+					await File.setConstraint(
+						ctx.db,
+						ctx.projectId,
+						params.path,
+						visibility,
+					);
 				}
 
 				if (!params.run) throw new Error("run is required");
-				const { rummy } = await buildRunContext(hooks, ctx, params.run);
-				await dispatchTool(hooks, rummy, "store", params.path, "", {
-					path: params.path,
-				});
+				const runRow = await ctx.db.get_run_by_alias.get({ alias: params.run });
+				if (!runRow) throw new Error(`Run not found: ${params.run}`);
+				const store = ctx.projectAgent.entries;
+				await store.demoteByPattern(runRow.id, params.path, null);
 				return { status: "ok" };
 			},
 			description: "Demote entry to stored state.",
 			params: {
 				path: "string — file path or glob pattern",
 				run: "string? — run alias (required without persist)",
-				persist: "boolean? — create file constraint",
+				persist: "boolean? — also create file constraint",
 				ignore: "boolean? — with persist, exclude from scan",
 				clear: "boolean? — remove existing constraint",
 			},
 			requiresInit: true,
 		});
 
-		r.register("set", {
-			handler: async (params, ctx) => {
-				if (!params.path) throw new Error("path is required");
-				if (!params.run) throw new Error("run is required");
-				const { rummy } = await buildRunContext(hooks, ctx, params.run);
-
-				const scheme = KnownStore.scheme(params.path);
-				if (scheme) {
-					await rummy.set({
-						path: params.path,
-						body: params.body,
-						status: params.status || 200,
-						attributes: params.attributes,
-					});
-				} else {
-					await dispatchTool(hooks, rummy, "set", params.path, params.body, {
-						path: params.path,
-						...params.attributes,
-					});
-				}
-				return { status: "ok" };
-			},
-			description: "Create or update an entry.",
-			params: {
-				run: "string — run alias",
-				path: "string — entry path",
-				body: "string? — entry content",
-				status: "number? — HTTP status code (default: 200)",
-				attributes: "object? — JSON attributes",
-			},
-			requiresInit: true,
-		});
-
-		r.register("rm", {
-			handler: async (params, ctx) => {
-				if (!params.path) throw new Error("path is required");
-				if (!params.run) throw new Error("run is required");
-				const { rummy } = await buildRunContext(hooks, ctx, params.run);
-				await dispatchTool(hooks, rummy, "rm", params.path, "", {
-					path: params.path,
-				});
-				return { status: "ok" };
-			},
-			description: "Remove an entry.",
-			params: {
-				run: "string — run alias",
-				path: "string — entry path",
-			},
-			requiresInit: true,
-		});
-
 		r.register("getEntries", {
 			handler: async (params, ctx) => {
 				let run;
@@ -283,7 +231,9 @@ export default class Rpc {
 						temperature: params.temperature ?? null,
 						persona: params.persona ?? null,
 						contextLimit: params.contextLimit,
-						noContext: params.noContext,
+						noRepo: params.noRepo,
+						noInteraction: params.noInteraction,
+						noWeb: params.noWeb,
 						fork: params.fork,
 					},
 				);
@@ -297,7 +247,9 @@ export default class Rpc {
 				temperature: "number?",
 				persona: "string?",
 				contextLimit: "number?",
-				noContext: "boolean?",
+				noRepo: "boolean?",
+				noInteraction: "boolean? — disable ask_user tool",
+				noWeb: "boolean? — disable search and URL fetch",
 				fork: "boolean?",
 			},
 			requiresInit: true,
@@ -315,7 +267,9 @@ export default class Rpc {
 						temperature: params.temperature ?? null,
 						persona: params.persona ?? null,
 						contextLimit: params.contextLimit,
-						noContext: params.noContext,
+						noRepo: params.noRepo,
+						noInteraction: params.noInteraction,
+						noWeb: params.noWeb,
 						fork: params.fork,
 					},
 				);
@@ -329,7 +283,9 @@ export default class Rpc {
 				temperature: "number?",
 				persona: "string?",
 				contextLimit: "number?",
-				noContext: "boolean?",
+				noRepo: "boolean?",
+				noInteraction: "boolean? — disable ask_user tool",
+				noWeb: "boolean? — disable search and URL fetch",
 				fork: "boolean?",
 			},
 			requiresInit: true,
@@ -524,6 +480,10 @@ export default class Rpc {
 		r.registerNotification("run/progress", "Turn status.");
 		r.registerNotification("ui/render", "Streaming output.");
 		r.registerNotification("ui/notify", "Toast notification.");
+
+		// Auto-dispatch: any registered tool is callable via RPC.
+		// Checked at request time — no timing dependency on plugin load order.
+		r.setToolFallback(hooks, buildRunContext, dispatchTool);
 	}
 }
 
@@ -544,7 +504,7 @@ async function buildRunContext(hooks, ctx, runAlias) {
 				sequence: runRow.next_turn,
 				runId: runRow.id,
 				turnId: null,
-				noContext: false,
+				noRepo: false,
 				contextSize: null,
 				systemPrompt: "",
 				loopPrompt: "",
@@ -555,7 +515,12 @@ async function buildRunContext(hooks, ctx, runAlias) {
 
 async function dispatchTool(hooks, rummy, scheme, path, body, attributes) {
 	const store = rummy.entries;
-	const resultPath = await store.dedup(rummy.runId, scheme, path);
+	const resultPath = await store.dedup(
+		rummy.runId,
+		scheme,
+		path,
+		rummy.sequence,
+	);
 
 	await store.upsert(rummy.runId, rummy.sequence, resultPath, body, 200, {
 		attributes: attributes,

package/src/plugins/set/README.md

@@ -1,32 +1,33 @@
 # set
 
-Writes or edits entry content. Handles new files, full overwrites, SEARCH/REPLACE edits, and pattern updates.
+Writes or edits entry content. Handles new files, full overwrites,
+SEARCH/REPLACE edits, and pattern updates.
 
 ## Files
 
 - **set.js** — Plugin registration and edit dispatch logic.
-- **HeuristicMatcher.js** — Fuzzy SEARCH/REPLACE matching. Handles whitespace/indentation differences and escaped characters when literal match fails.
+- **HeuristicMatcher.js** — Fuzzy SEARCH/REPLACE matching.
 - **HeuristicMatcher.test.js** — Tests for HeuristicMatcher.
 
 ## Registration
 
 - **Tool**: `set`
-- **Modes**: ask, act
-- **Category**: act
-- **Handler**: Routes to different paths based on attributes:
+- **Category**: `logging`
+- **Handler**: Routes based on attributes:
   - `blocks` or `search` — SEARCH/REPLACE edit via `processEdit`.
   - `preview` — pattern preview (dry run).
-  - K/V path — direct upsert at `full` state.
-  - File path — produces `proposed` entry with udiff patch.
+  - Scheme path — direct upsert at status 200.
+  - File path — produces status 202 (proposed) with unified diff patch.
   - Glob/filter — bulk update via `updateBodyByPattern`.
 
 ## Projection
 
-Shows `set {file}` with token delta (`before→after tokens`). Includes the merge conflict block when a SEARCH/REPLACE was performed.
+Shows `set {file}` with token delta (`before→after tokens`). Includes
+the merge conflict block when a SEARCH/REPLACE was performed.
 
 ## Behavior
 
-- **Literal match first**: SEARCH text is matched literally against the entry body.
-- **Heuristic fallback**: On literal failure, `HeuristicMatcher.matchAndPatch` attempts fuzzy matching with warnings.
-- **Patch generation**: `generatePatch` produces unified diff format for client display.
-- File writes are always `proposed`; K/V writes resolve immediately.
+- **Literal match first**: SEARCH text is matched literally.
+- **Heuristic fallback**: On literal failure, fuzzy matching with warnings.
+- **Patch generation**: `generatePatch` produces unified diff for client display.
+- File writes are always status 202 (proposed); scheme writes resolve immediately.

package/src/plugins/set/set.js

@@ -1,7 +1,10 @@
-import { readFileSync } from "node:fs";
 import KnownStore from "../../agent/KnownStore.js";
+import { countTokens } from "../../agent/tokens.js";
 import Hedberg, { generatePatch } from "../hedberg/hedberg.js";
 import { storePatternResult } from "../helpers.js";
+import docs from "./setDoc.js";
+
+const VALID_FIDELITY = { archive: 1, summary: 1, index: 1, full: 1 };
 
 // biome-ignore lint/suspicious/noShadowRestrictedNames: tool name is "set"
 export default class Set {
@@ -14,16 +17,86 @@ export default class Set {
 		core.on("full", this.full.bind(this));
 		core.on("summary", this.summary.bind(this));
 		core.on("turn.proposing", this.#materializeRevisions.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.set = docs;
+			return docsMap;
+		});
 	}
 
 	async handler(entry, rummy) {
 		const { entries: store, sequence: turn, runId, loopId } = rummy;
 		const attrs = entry.attributes;
 
+		// Fidelity control: <set path="..." fidelity="archive"/>
+		const fidelityAttr = VALID_FIDELITY[attrs.fidelity] ? attrs.fidelity : null;
+		if (fidelityAttr && attrs.path) {
+			const target = attrs.path;
+			const rawSummary =
+				typeof attrs.summary === "string" ? attrs.summary : null;
+			const summaryText = rawSummary ? rawSummary.slice(0, 80) : null;
+			const matches = await store.getEntriesByPattern(
+				runId,
+				target,
+				attrs.body,
+			);
+			if (entry.body) {
+				// Write content directly at specified fidelity
+				const entryAttrs = summaryText ? { summary: summaryText } : null;
+				for (const match of matches) {
+					await store.upsert(runId, turn, match.path, entry.body, 200, {
+						fidelity: fidelityAttr,
+						attributes: entryAttrs,
+						loopId,
+					});
+				}
+				if (matches.length === 0) {
+					await store.upsert(runId, turn, target, entry.body, 200, {
+						fidelity: fidelityAttr,
+						attributes: entryAttrs,
+						loopId,
+					});
+				}
+			} else {
+				// No body — change fidelity, attach summary if provided
+				for (const match of matches) {
+					await store.setFidelity(runId, match.path, fidelityAttr);
+					if (summaryText) {
+						await store.setAttributes(runId, match.path, {
+							summary: summaryText,
+						});
+					}
+				}
+			}
+			if (matches.length === 0) {
+				await store.upsert(
+					runId,
+					turn,
+					entry.resultPath,
+					`${target} not found`,
+					404,
+					{
+						fidelity: "archive",
+						loopId,
+					},
+				);
+				return;
+			}
+			const label =
+				fidelityAttr === "archive" ? "archived" : `set to ${fidelityAttr}`;
+			await store.upsert(
+				runId,
+				turn,
+				entry.resultPath,
+				`${matches.map((m) => m.path).join(", ")} ${label}`,
+				200,
+				{
+					fidelity: "archive",
+					loopId,
+				},
+			);
+			return;
+		}
+
 		if (attrs.blocks || attrs.search != null) {
 			await this.#processEdit(rummy, entry, attrs);
 			return;
@@ -143,7 +216,7 @@ export default class Set {
 					? `<<<<<<< SEARCH\n${searchText}\n=======\n${replaceText}\n>>>>>>> REPLACE`
 					: null;
 			const beforeTokens = match.tokens_full || 0;
-			const afterTokens = patch ? (patch.length / 4) | 0 : beforeTokens;
+			const afterTokens = patch ? countTokens(patch) : beforeTokens;
 
 			await store.upsert(runId, turn, resultPath, match.body, status, {
 				attributes: {
@@ -210,7 +283,7 @@ export default class Set {
 					: null;
 			const merge = mergeBlocks.length > 0 ? mergeBlocks.join("\n") : null;
 			const beforeTokens = fileEntry[0].tokens_full || 0;
-			const afterTokens = current ? (current.length / 4) | 0 : beforeTokens;
+			const afterTokens = current ? countTokens(current) : beforeTokens;
 
 			await store.upsert(runId, turn, entry.path, original, state, {
 				attributes: {
@@ -232,10 +305,7 @@ export default class Set {
 			return { search: attrs.search, replace: attrs.replace ?? "" };
 		}
 		if (attrs.blocks?.length > 0) {
-			return {
-				search: attrs.blocks[0].search,
-				replace: attrs.blocks[0].replace,
-			};
+			return { blocks: attrs.blocks };
 		}
 		return null;
 	}
@@ -257,11 +327,32 @@ export default class Set {
 			};
 		}
 		if (body && attrs.blocks?.length > 0) {
-			const block = attrs.blocks[0];
-			return Hedberg.replace(body, block.search, block.replace, {
-				sed: block.sed,
-				flags: block.flags,
-			});
+			if (attrs.blocks.length === 1) {
+				const block = attrs.blocks[0];
+				return Hedberg.replace(body, block.search, block.replace, {
+					sed: block.sed,
+					flags: block.flags,
+				});
+			}
+			// Multi-block: apply sequentially, no per-hunk merge notation
+			let current = body;
+			let lastWarning = null;
+			for (const block of attrs.blocks) {
+				const result = Hedberg.replace(current, block.search, block.replace, {
+					sed: block.sed,
+					flags: block.flags,
+				});
+				if (result.error) return result;
+				if (result.warning) lastWarning = result.warning;
+				if (result.patch) current = result.patch;
+			}
+			return {
+				patch: current !== body ? current : null,
+				searchText: null,
+				replaceText: null,
+				warning: lastWarning,
+				error: null,
+			};
 		}
 		return {
 			patch: null,

package/src/plugins/set/setDoc.js

@@ -0,0 +1,49 @@
+// Tool doc for <set>. 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 + body = edit content
+	['## <set path="[path/to/file]">[edit]</set> - Edit a file or entry'],
+
+	// --- Examples: sed, SEARCH/REPLACE, fidelity control
+	[
+		'Example: <set path="src/config.js">s/port = 3000/port = 8080/g</set>',
+		"Sed syntax: most common edit pattern. Shows s/old/new/ with g flag.",
+	],
+	[
+		`Example: <set path="src/app.js"><<<<<<< SEARCH
+// TODO: add error handling
+=======
+// error handler configured
+>>>>>>> REPLACE</set>`,
+		"SEARCH/REPLACE block: literal match and replace. Use when sed escaping is complex.",
+	],
+	[
+		'Example: <set path="known://project/milestones" fidelity="summary" summary="milestone,deadline,2026"/> ... <set path="prompt://3" fidelity="index"/>',
+		"Fidelity control: compress a known entry to keywords, demote a previous prompt to index-only. Both free context while keeping paths visible.",
+	],
+
+	// --- Constraints
+	[
+		'* `fidelity="..."`: `archive`, `summary`, `index`, `full`',
+		"Fidelity control. Archive removes from context but preserves for retrieval.",
+	],
+	[
+		'* `fidelity="summary"` HIDES the body — does NOT require reading or compressing content. Write any short keyword label you already know.',
+		"M-10 fix: model was reading files before compressing to summary, believing it needed semantic content. It does not. The body is preserved on disk; only context visibility changes.",
+	],
+	[
+		'* `summary="..."` (<= 80 chars) persists across fidelity changes',
+		"Model-authored descriptions survive demotion. No janitorial pass needed.",
+	],
+	[
+		"* YOU MUST NOT use <sh/> or <env/> to read, create, or edit files",
+		"Forces file operations through set/get. Prevents untracked mutations.",
+	],
+	[
+		"* Editing: s/old/new/ sed patterns and literal SEARCH/REPLACE blocks",
+		"Both syntaxes supported. Hedberg normalizes either form.",
+	],
+];
+
+export default LINES.map(([text]) => text).join("\n");