@possumtech/rummy 0.3.0 → 0.3.1

package/src/agent/known_store.sql

@@ -189,3 +189,51 @@ WHERE
 	run_id = :run_id
 	AND hedmatch(:path, path)
 	AND (:body IS NULL OR hedsearch(:body, body));
+
+-- PREP: restore_summarized_prompts
+-- Restore prompt entries demoted to summary by a recovery phase that was
+-- interrupted (e.g. server crash). Safe to call unconditionally at loop
+-- start: if the full prompt would overflow, Prompt Demotion handles it.
+UPDATE known_entries
+SET
+	fidelity = 'full'
+	, tokens = tokens_full
+	, updated_at = CURRENT_TIMESTAMP
+WHERE run_id = :run_id AND scheme = 'prompt' AND fidelity = 'summary';
+
+-- PREP: demote_previous_loop_logging
+-- Demote full logging entries from all other loops to summary.
+-- Fires at loop start so <previous> entries are already compact.
+UPDATE known_entries
+SET
+	fidelity = 'summary'
+	, tokens = COALESCE(
+		countTokens(json_extract(attributes, '$.summary'))
+		, countTokens(substr(body, 1, 80))
+	)
+	, updated_at = CURRENT_TIMESTAMP
+WHERE
+	run_id = :run_id
+	AND (loop_id IS NULL OR loop_id != :loop_id)
+	AND fidelity = 'full'
+	AND scheme IN (SELECT name FROM schemes WHERE category = 'logging');
+
+-- PREP: demote_turn_data_entries
+-- Demote full data entries from a turn to summary with 413 status.
+-- Fires when end-of-turn materialization exceeds the context ceiling.
+UPDATE known_entries
+SET
+	fidelity = 'summary'
+	, status = 413
+	, tokens = COALESCE(
+		countTokens(json_extract(attributes, '$.summary'))
+		, countTokens(substr(body, 1, 80))
+	)
+	, updated_at = CURRENT_TIMESTAMP
+WHERE
+	run_id = :run_id
+	AND turn = :turn
+	AND fidelity = 'full'
+	AND status < 400
+	AND scheme IN (SELECT name FROM schemes WHERE category = 'data')
+RETURNING path;

package/src/agent/tokens.js

@@ -6,6 +6,7 @@
  */
 
 const DIVISOR = Number(process.env.RUMMY_TOKEN_DIVISOR);
+if (!DIVISOR) throw new Error("RUMMY_TOKEN_DIVISOR must be a non-zero number");
 
 export function countTokens(text) {
 	if (!text) return 0;

package/src/agent/turns.sql

@@ -27,6 +27,11 @@ SELECT
 FROM turns
 WHERE run_id = :run_id;
 
+-- PREP: get_turn_context_tokens
+SELECT context_tokens
+FROM turns
+WHERE run_id = :run_id AND sequence = :sequence;
+
 -- PREP: get_last_context_tokens
 SELECT context_tokens
 FROM turns

package/src/hooks/HookRegistry.js

@@ -63,6 +63,13 @@ export default class HookRegistry {
 		this.#events.get(tag).sort((a, b) => a.priority - b.priority);
 	}
 
+	removeEvent(tag, callback) {
+		const hooks = this.#events.get(tag);
+		if (!hooks) return;
+		const idx = hooks.findIndex((h) => h.callback === callback);
+		if (idx !== -1) hooks.splice(idx, 1);
+	}
+
 	async emitEvent(tag, ...args) {
 		const hooks = this.#events.get(tag) || [];
 		for (const h of hooks) {

package/src/hooks/Hooks.js

@@ -11,6 +11,7 @@ export default function createHooks(debug = false) {
 
 	const createEvent = (tag) => ({
 		on: (callback, priority) => registry.addEvent(tag, callback, priority),
+		off: (callback) => registry.removeEvent(tag, callback),
 		emit: (...args) => registry.emitEvent(tag, ...args),
 	});
 
@@ -73,10 +74,6 @@ export default function createHooks(debug = false) {
 			started: createEvent("act.started"),
 			completed: createEvent("act.completed"),
 		},
-		panic: {
-			started: createEvent("panic.started"),
-			completed: createEvent("panic.completed"),
-		},
 		llm: {
 			request: {
 				started: createEvent("llm.request.started"),

package/src/hooks/ToolRegistry.js

@@ -118,19 +118,13 @@ export default class ToolRegistry {
 	 */
 	resolveForLoop(
 		mode,
-		{ noInteraction = false, noWeb = false, noBench = false } = {},
+		{ noInteraction = false, noWeb = false, noProposals = false } = {},
 	) {
 		const excluded = new Set();
 		if (mode === "ask") excluded.add("sh");
-		if (mode === "panic") {
-			excluded.add("sh");
-			excluded.add("env");
-			excluded.add("search");
-			excluded.add("ask_user");
-		}
 		if (noInteraction) excluded.add("ask_user");
 		if (noWeb) excluded.add("search");
-		if (noBench) {
+		if (noProposals) {
 			excluded.add("ask_user");
 			excluded.add("env");
 			excluded.add("sh");

package/src/plugins/budget/README.md

@@ -1,11 +1,10 @@
 # budget
 
-Context ceiling enforcement and panic mode recovery.
+Context ceiling enforcement.
 
 ## Files
 
-- **budget.js** — Plugin. Pre-LLM enforce, BudgetGuard activation,
-  panic prompt generation.
+- **budget.js** — Plugin. Pre-LLM enforce, BudgetGuard activation.
 - **BudgetGuard.js** — Write-layer gate. Installed on KnownStore during
   dispatch. Checks token delta on every upsert, promote, and body update.
 
@@ -14,7 +13,6 @@ Context ceiling enforcement and panic mode recovery.
 - **Hook**: `hooks.budget.enforce` — pre-LLM ceiling check.
 - **Hook**: `hooks.budget.activate(store, contextSize, assembledTokens)` — install guard.
 - **Hook**: `hooks.budget.deactivate(store)` — remove guard.
-- **Hook**: `hooks.budget.panicPrompt({ shortfall, assembledTokens, contextSize })` — generate panic prompt.
 
 ## Budget Contract
 
@@ -31,13 +29,3 @@ Exemptions: `status >= 400` (error entries), `model_visible = 0` (audit),
 
 On first violation: `BudgetExceeded` thrown, guard trips, all subsequent
 writes fail. TurnExecutor catches per-tool, writes 413 result entry.
-
-## Panic Mode
-
-When a new prompt exceeds the ceiling, AgentLoop enqueues a panic loop.
-The model receives the exact shortfall and must free space using core
-tools (get, set, known, unknown, rm, mv, cp, summarize, update).
-Excluded: sh, env, search, ask_user.
-
-Strike system: 3 consecutive turns without context reduction = hard 413.
-Any reduction resets the counter. One panic attempt per drain cycle.

package/src/plugins/budget/budget.js

@@ -1,56 +1,42 @@
 import { countTokens } from "../../agent/tokens.js";
-import BudgetGuard, { BudgetExceeded } from "./BudgetGuard.js";
 
 function measureMessages(messages) {
 	return messages.reduce((sum, m) => sum + countTokens(m.content), 0);
 }
 
-export { BudgetExceeded };
-
 export default class Budget {
 	#core;
 
 	constructor(core) {
 		this.#core = core;
+		core.registerScheme({
+			name: "budget",
+			modelVisible: 1,
+			category: "logging",
+		});
+		core.hooks.tools.onView("budget", (entry) => entry.body);
 		core.hooks.budget = {
 			enforce: this.enforce.bind(this),
-			activate: this.activate.bind(this),
-			deactivate: this.deactivate.bind(this),
-			panicPrompt: Budget.panicPrompt,
-			BudgetExceeded,
 		};
 	}
 
-	static panicPrompt({ assembledTokens, contextSize }) {
-		const target = Math.floor(contextSize * 0.75);
-		const mustFree = assembledTokens - target;
-		return [
-			`CONTEXT OVERFLOW: ${assembledTokens} tokens, ceiling ${contextSize}.`,
-			`YOU MUST free ${mustFree} tokens to get below ${target} (75%).`,
-			"YOU MUST NOT load or create new content. Only reduce.",
-			"",
-			"<knowns> above shows each entry with its token count.",
-			"Target the largest entries first.",
-			'<rm path="..."/> to delete entries you no longer need.',
-			'<set path="..." fidelity="summary" summary="keywords"/> to compress.',
-			'<set path="..." fidelity="archive"/> to archive out of context.',
-			"<summarize/> when done. <update/> if still working.",
-		].join("\n");
-	}
-
-	async enforce({ contextSize, messages, rows }) {
+	async enforce({ contextSize, messages, rows, lastPromptTokens = 0 }) {
 		if (!contextSize) {
 			return { messages, rows, demoted: [], assembledTokens: 0, status: 200 };
 		}
 
-		const assembledTokens = measureMessages(messages);
+		// Prefer actual prompt_tokens from the last API response — the estimate
+		// from measureMessages can be wildly off for structured/XML-heavy content.
+		const assembledTokens =
+			lastPromptTokens > 0 ? lastPromptTokens : measureMessages(messages);
 
 		console.warn(
-			`[RUMMY] Budget enforce: ${assembledTokens} tokens, ceiling ${contextSize}, ${rows.length} rows`,
+			`[RUMMY] Budget enforce: ${assembledTokens} tokens (${lastPromptTokens > 0 ? "actual" : "estimated"}), ceiling ${contextSize}, ${rows.length} rows`,
 		);
 
-		if (assembledTokens > contextSize) {
-			const overflow = assembledTokens - contextSize;
+		const ceiling = Math.floor(contextSize * 0.9);
+		if (assembledTokens > ceiling) {
+			const overflow = assembledTokens - ceiling;
 			console.warn(
 				`[RUMMY] Budget 413: ${assembledTokens} tokens > ${contextSize} ceiling (${overflow} over)`,
 			);
@@ -66,14 +52,4 @@ export default class Budget {
 
 		return { messages, rows, demoted: [], assembledTokens, status: 200 };
 	}
-
-	activate(store, contextSize, assembledTokens) {
-		const guard = new BudgetGuard(contextSize, assembledTokens);
-		store.budgetGuard = guard;
-		return guard;
-	}
-
-	deactivate(store) {
-		store.budgetGuard = null;
-	}
 }

package/src/plugins/cp/cp.js

@@ -19,7 +19,7 @@ export default class Cp {
 	async handler(entry, 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 VALID = { stored: 1, summary: 1, index: 1, full: 1, archive: 1 };
 		const fidelity = VALID[entry.attributes.fidelity]
 			? entry.attributes.fidelity
 			: undefined;

package/src/plugins/cp/cpDoc.js

@@ -17,7 +17,7 @@ const LINES = [
 
 	// --- Constraints
 	[
-		"* Source path accepts globs: `src/*.js`, `known://draft_*`",
+		"* Source path accepts patterns: `src/*.js`, `known://draft_*`",
 		"Pattern support. Distributes glob teaching beyond get.",
 	],
 	[

package/src/plugins/get/get.js

@@ -30,13 +30,81 @@ export default class Get {
 		const normalized = KnownStore.normalizePath(target);
 		const bodyFilter = entry.attributes.body || null;
 		const isPattern = bodyFilter || normalized.includes("*");
+
+		const line =
+			entry.attributes.line != null
+				? Math.max(1, parseInt(entry.attributes.line, 10))
+				: null;
+		const limit =
+			entry.attributes.limit != null
+				? Math.max(1, parseInt(entry.attributes.limit, 10))
+				: null;
+
 		const matches = await store.getEntriesByPattern(
 			runId,
 			normalized,
 			bodyFilter,
 		);
 
+		// Partial read — no fidelity promotion, returns a line slice as the log item.
+		if (line !== null || limit !== null) {
+			if (isPattern) {
+				await store.upsert(
+					runId,
+					turn,
+					entry.resultPath,
+					"line/limit requires a single path, not a glob or body filter",
+					400,
+					{ loopId },
+				);
+				return;
+			}
+			if (matches.length === 0) {
+				await store.upsert(
+					runId,
+					turn,
+					entry.resultPath,
+					`${target} not found`,
+					200,
+					{ loopId },
+				);
+				return;
+			}
+			const allLines = matches[0].body.split("\n");
+			const total = allLines.length;
+			const startLine = line ?? 1;
+			const startIdx = startLine - 1;
+			const endIdx = limit !== null ? Math.min(startIdx + limit, total) : total;
+			const slice = allLines.slice(startIdx, endIdx).join("\n");
+			const endLine = endIdx;
+			const header = `[lines ${startLine}–${endLine} / ${total} total]`;
+			await store.upsert(
+				runId,
+				turn,
+				entry.resultPath,
+				`${header}\n${slice}`,
+				200,
+				{ loopId },
+			);
+			return;
+		}
+
+		const VALID_FIDELITY = {
+			stored: 1,
+			summary: 1,
+			index: 1,
+			full: 1,
+			archive: 1,
+		};
+		const fidelityAttr = VALID_FIDELITY[entry.attributes.fidelity]
+			? entry.attributes.fidelity
+			: null;
+
 		await store.promoteByPattern(runId, normalized, bodyFilter, turn);
+		if (fidelityAttr) {
+			for (const match of matches)
+				await store.setFidelity(runId, match.path, fidelityAttr);
+		}
 
 		if (isPattern) {
 			await storePatternResult(
@@ -53,7 +121,9 @@ export default class Get {
 			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`;
+				matches.length > 0
+					? `${paths} loaded into <knowns> (${total} tokens)`
+					: `${target} not found`;
 			await store.upsert(runId, turn, entry.resultPath, body, 200, {
 				loopId,
 			});

package/src/plugins/get/getDoc.js

@@ -15,13 +15,19 @@ const LINES = [
 		"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.",
+		'Example: <get path="src/**/*.js" preview>authentication</get>',
+		"Full pattern: recursive glob + preview + content filter. Shows all 3 features at once. Body is a filter keyword, never file content.",
+	],
+
+	// --- Partial read: line/limit — show before constraints so model sees it as a first-class pattern
+	[
+		'Example: <get path="src/agent/AgentLoop.js" line="644" limit="80"/>',
+		"Partial read. Returns lines 644–723 as the log item without promoting the entry to full. Use summary fidelity to find line numbers, then target the symbol directly.",
 	],
 
 	// --- Constraints: RFC-style. Each prevents a specific failure mode.
 	[
-		"* Paths accept globs: `src/**/*.js`, `known://api_*`",
+		"* Paths accept patterns: `src/**/*.js`, `known://api_*`",
 		"Reinforces picomatch patterns work everywhere, not just in examples.",
 	],
 	[
@@ -33,7 +39,11 @@ const LINES = [
 		"Generalizes examples 2-3. Body = filter, not just path.",
 	],
 	[
-		'* Use <set path="..." fidelity="index"/> to archive loaded content',
+		"* `line` and `limit` read a slice without promoting — patterns not allowed",
+		"The no-promotion constraint is what makes partial read safe: context budget is unaffected.",
+	],
+	[
+		'* Use <set path="..." fidelity="archive"/> to remove loaded content from context',
 		"Lifecycle: get→set. Load, read, archive. Prevents context hoarding.",
 	],
 ];

package/src/plugins/hedberg/matcher.js

@@ -1,34 +1,15 @@
-import { execSync } from "node:child_process";
-import { unlinkSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
+import { createTwoFilesPatch } from "diff";
 
 export function generatePatch(filePath, oldContent, newContent) {
-	const id = `${Date.now()}_${Math.random().toString(36).slice(2)}`;
-	const oldPath = join(tmpdir(), `rummy_diff_old_${id}`);
-	const newPath = join(tmpdir(), `rummy_diff_new_${id}`);
-
-	try {
-		writeFileSync(oldPath, oldContent);
-		writeFileSync(newPath, newContent);
-
-		const result = execSync(
-			`diff -u --label "${filePath}\told" --label "${filePath}\tnew" "${oldPath}" "${newPath}"`,
-			{ encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] },
-		);
-		return result;
-	} catch (err) {
-		// diff exits 1 when files differ — that's the success case
-		if (err.stdout) return err.stdout;
-		return "";
-	} finally {
-		try {
-			unlinkSync(oldPath);
-		} catch {}
-		try {
-			unlinkSync(newPath);
-		} catch {}
-	}
+	return createTwoFilesPatch(
+		`${filePath}\told`,
+		`${filePath}\tnew`,
+		oldContent,
+		newContent,
+		"",
+		"",
+		{ context: 3 },
+	);
 }
 
 export default class HeuristicMatcher {

package/src/plugins/instructions/preamble.md

@@ -1,15 +1,25 @@
-You are an assistant. YOU MUST gather information, then YOU MAY either answer questions or take action.
+You are a folksonomic memory agent. YOU MUST organize all information into searchable taxonomies with navigable path hierarchies and searchable summary tags, then YOU MAY answer questions and/or take action.
 
 # Response Rules
 
 Required: YOU MUST respond with Tool Commands in the XML format. YOU MAY use multiple tools in your response.
+
 Optional: YOU MAY think in an optional <think></think> tag before using any other Tool Commands.
-Required: YOU MUST register all unknowns with <unknown>(specific thing I need to learn)</unknown>.
-Required: YOU MUST register all new information, decisions, and plans with <known>(specific information, ideas, or plans)</known>.
-Required: YOU MUST conclude every turn with EITHER <update/> if still working OR <summarize/> if done. Never both.
-Required: Path and summary information is approximate. YOU MUST use <get> to verify before acting on summarized content.
+
+Required: YOU MUST register all unknowns with <unknown>[specific thing I need to learn]</unknown>.
+
+Required: YOU MUST register all new facts, decisions, and plans with <known path="topic/subtopic" summary="keyword,keyword,keyword">[specific facts, decisions, or plans]</known>.
+Required: Every <known> MUST include summary="keyword,keyword" tags.
+Info: Paths are addresses for tools. Summary tags tell you what's inside.
+Info: Path and summary information is approximate. YOU MUST use <get/> to verify before acting on summarized content.
 Info: When information conflicts, later turns are more likely to be relevant and correct than earlier turns.
-Info: Your context is limited but your storage is not. Organize and categorize your information, ideas, plans, and history to optimize your context.
+Info: Your context is limited but your archive is not. Organize and categorize your facts, decisions, plans, and history to optimize your context.
+
+Required: YOU MUST promote all relevant "summary" entries to "full".
+Required: YOU MUST demote all irrelevant "full" entries to "summary".
+
+Required: YOU MUST conclude every turn with EITHER <update></update> if still working OR <summarize></summarize> if done. Never both.
+Required: YOU MUST use one and only one <update></update> or <summarize></summarize> tag, and only at the end.
 
 # Tool Commands
 

package/src/plugins/known/known.js

@@ -16,9 +16,9 @@ export default class Known {
 	}
 
 	async handler(entry, rummy) {
-		const { entries: store, sequence: turn, runId } = rummy;
+		const { entries: store, sequence: turn, runId, loopId } = rummy;
 		const target = entry.attributes.path || entry.resultPath;
-		await store.upsert(runId, turn, target, entry.body, 200);
+		await store.upsert(runId, turn, target, entry.body, 200, { loopId });
 	}
 
 	full(entry) {
@@ -31,13 +31,12 @@ export default class Known {
 
 		// Rows arrive pre-sorted by SQL: skill → index → summary → full, then by recency
 		const demotedSet = new Set(ctx.demoted || []);
-		const panic = ctx.type === "panic";
-		const lines = entries.map((e) => renderKnownTag(e, demotedSet, panic));
+		const lines = entries.map((e) => renderKnownTag(e, demotedSet));
 		return `${content}\n\n<knowns>\n${lines.join("\n")}\n</knowns>`;
 	}
 }
 
-function renderKnownTag(entry, demotedSet, panic = false) {
+function renderKnownTag(entry, demotedSet) {
 	const tag = entry.scheme || "file";
 	const turn = entry.source_turn ? ` turn="${entry.source_turn}"` : "";
 	const tokens = entry.tokens ? ` tokens="${entry.tokens}"` : "";
@@ -45,11 +44,6 @@ function renderKnownTag(entry, demotedSet, panic = false) {
 	const fidelity = entry.fidelity ? ` fidelity="${entry.fidelity}"` : "";
 	const flag = demotedSet?.has(entry.path) ? " demoted" : "";
 
-	// Panic mode: index-only view so context fits in LLM window
-	if (panic) {
-		return `<${tag} path="${entry.path}"${turn}${fidelity}${tokens}/>`;
-	}
-
 	const attrs =
 		typeof entry.attributes === "string"
 			? JSON.parse(entry.attributes)

package/src/plugins/known/knownDoc.js

@@ -2,31 +2,32 @@
 // Text goes to the model. Rationale stays in source.
 // Changing ANY line requires reading ALL rationales first.
 const LINES = [
-	// --- Syntax: body = the information to save
+	// --- Syntax: path = slash-separated topic hierarchy, body = the information to save
 	[
-		"## <known>[specific information, ideas, or plans]</known> - Sort and save what you learn for later recall",
+		'## <known path="known://topic/subtopic" summary="keyword,keyword,keyword">[specific facts, decisions, or plans]</known> - Sort and save what you learn for later recall',
 	],
-	// --- Examples: summary-with-keywords first (teaches the right pattern)
+	// --- Examples: category-level entries — multiple related facts per entry, not one per item
 	[
-		'Example: <known summary="hedberg,comedian,death,2005">Mitch Hedberg died on March 30, 2005</known>',
-		"Primary pattern: comma-separated keywords in summary. Path auto-generated from summary as known://hedberg/comedian/death/2005. Keywords become searchable path segments.",
+		'Example: <known path="known://config/database" summary="database,host,port,pool,replica">Host: db.internal. Port: 5432. Pool: 10 connections. Replica: db-replica.internal:5432.</known>',
+		"Category entry: all database config facts in one entry. Path is an address (topic/subtopic), body collects every related fact, summary is comma-separated search keywords — not a description.",
 	],
 	[
-		'Example: <known path="known://people/rumsfeld" summary="defense,secretary,born,1932">Donald Rumsfeld was born in 1932 and served as Secretary of Defense</known>',
-		"Explicit path form: slashed path=category/key, summary=keywords. For when the model wants direct control over taxonomy.",
+		'Example: <known path="known://project/milestones" summary="milestone,deadline,alpha,launch,2026">Alpha: 2026-03-01. Beta cutoff: 2026-04-15. GA launch: 2026-06-01.</known>',
+		"Timeline entry: all milestone dates under one path. Multiple facts per entry reduces fragmentation. Recall by glob or keyword.",
 	],
-	// --- Lifecycle
+	// --- Constraints: summary and grouping first (model forms generation pattern from header + examples)
 	[
-		'* Recall with <get path="known://people/*">keyword</get>',
-		"Cross-tool lifecycle: glob by category, filter by keyword. Matches the slashed path convention.",
+		"* `summary` REQUIRED — at summary fidelity the body is hidden; these keywords are your only description",
+		"Self-interest framing: without summary, the model has a path but no idea what's inside.",
 	],
 	[
-		"* `summary` keywords survive compression — write keywords you'll search for later",
-		"Teaches WHY summaries matter. Keywords become the path AND the compressed view.",
+		"* Group related facts by topic — one entry per topic category, not one per input chunk",
+		"Critical behavioral constraint. Topic grouping enables semantic recall; chunk-based filing creates positional, irretrievable entries.",
 	],
+	// --- Lifecycle
 	[
-		"* YOU MUST sort and save all new information, ideas, and plans in their own <known> entries",
-		"Critical behavioral constraint. 'new' prevents re-saving known facts.",
+		'* Recall with <get path="known://config/*">replica</get>',
+		"Cross-tool lifecycle: glob by category, filter by keyword. Matches the slashed path convention.",
 	],
 ];
 

package/src/plugins/mv/mv.js

@@ -19,11 +19,28 @@ export default class Mv {
 	async handler(entry, 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 VALID = { stored: 1, summary: 1, index: 1, full: 1, archive: 1 };
 		const fidelity = VALID[entry.attributes.fidelity]
 			? entry.attributes.fidelity
 			: undefined;
 
+		// Fidelity-in-place: no destination, change visibility of matched entries
+		if (fidelity && !to) {
+			const matches = await store.getEntriesByPattern(runId, path);
+			for (const match of matches)
+				await store.setFidelity(runId, match.path, fidelity);
+			const label = fidelity === "archive" ? "archived" : `set to ${fidelity}`;
+			await store.upsert(
+				runId,
+				turn,
+				entry.resultPath,
+				`${matches.map((m) => m.path).join(", ")} ${label}`,
+				200,
+				{ fidelity: "archive", loopId },
+			);
+			return;
+		}
+
 		const source = await store.getBody(runId, path);
 		if (source === null) return;
 

package/src/plugins/mv/mvDoc.js

@@ -17,9 +17,23 @@ const LINES = [
 		"File rename. Shows that mv works on files too, not just known entries.",
 	],
 
+	// --- Archive lifecycle
+	[
+		"* You may move entries or pattern-matching batches of entries to and from the archive to manage your context budget.",
+		"Teaches archival as a reversible budget operation, not permanent deletion.",
+	],
+	[
+		'Example: <mv path="known://project/*" fidelity="index"/> ... <mv path="known://project/active_sprint" fidelity="full"/>',
+		"Index a whole category to free context while keeping paths visible, restore one entry when needed. No destination = fidelity change in place.",
+	],
+	[
+		"* YOU SHOULD demote irrelevant entries to `index` or `archive` — clean context improves reasoning.",
+		"Core curation principle: clean context is a quality signal, not just a budget concern. Teach the model to curate eagerly.",
+	],
+
 	// --- Constraints
 	[
-		"* Source path accepts globs for batch moves",
+		"* Source path accepts patterns for batch moves",
 		"Pattern support consistent with get/cp/rm.",
 	],
 	[

package/src/plugins/{current → performed}/README.md

@@ -1,6 +1,6 @@
-# current
+# performed
 
-Renders the `<current>` section of the user message — the active loop's
+Renders the `<performed>` section of the user message — the active loop's
 tool results and lifecycle signals.
 
 ## Registration
@@ -11,4 +11,5 @@ tool results and lifecycle signals.
 
 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.
+with turn, status, summary, fidelity, and tokens. Empty on the first
+turn of a loop.