@shanepadgett/tau-agent 0.8.0 → 0.9.1

package/extensions/runtime-context/index.ts

@@ -0,0 +1,84 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import {
+	fingerprintRuntimeSnapshot,
+	formatLocalDateKey,
+	formatLocalDisplayDate,
+	formatRuntimeContextMessage,
+	freezeRuntimeContext,
+	type RuntimeContext,
+} from "./context.ts";
+
+const RUNTIME_CONTEXT_TYPE = "tau.runtime-context";
+
+interface RuntimeContextMessageDetails {
+	version: 1;
+	dateKey: string;
+	snapshotHash: string;
+	includesSnapshot: boolean;
+}
+
+export default function runtimeContextExtension(pi: ExtensionAPI): void {
+	let runtimeContext: RuntimeContext | undefined;
+
+	pi.on("session_start", (_event, ctx) => {
+		runtimeContext = freezeRuntimeContext(ctx.cwd);
+	});
+
+	pi.on("before_agent_start", (_event, ctx) => {
+		runtimeContext ??= freezeRuntimeContext(ctx.cwd);
+		const now = new Date();
+		const dateKey = formatLocalDateKey(now);
+		const snapshotHash = fingerprintRuntimeSnapshot(runtimeContext);
+		let hasDate = false;
+		let hasSnapshot = false;
+		for (const entry of ctx.sessionManager.buildContextEntries()) {
+			const details = runtimeContextDetails(entry);
+			if (!details) continue;
+			if (details.dateKey === dateKey) hasDate = true;
+			if (details.includesSnapshot && details.snapshotHash === snapshotHash) hasSnapshot = true;
+		}
+
+		if (hasDate && hasSnapshot) return undefined;
+		const includeSnapshot = !hasSnapshot;
+		return {
+			message: {
+				customType: RUNTIME_CONTEXT_TYPE,
+				content: formatRuntimeContextMessage(
+					formatLocalDisplayDate(now),
+					includeSnapshot ? runtimeContext.rootSnapshot : undefined,
+				),
+				display: false,
+				details: {
+					version: 1,
+					dateKey,
+					snapshotHash,
+					includesSnapshot: includeSnapshot,
+				} satisfies RuntimeContextMessageDetails,
+			},
+		};
+	});
+}
+
+function runtimeContextDetails(value: unknown): RuntimeContextMessageDetails | undefined {
+	if (!value || typeof value !== "object") return undefined;
+	const entry = value as Record<string, unknown>;
+	if (entry.type !== "custom_message" || entry.customType !== RUNTIME_CONTEXT_TYPE || entry.display !== false) {
+		return undefined;
+	}
+	if (!entry.details || typeof entry.details !== "object") return undefined;
+	const details = entry.details as Record<string, unknown>;
+	if (
+		details.version !== 1 ||
+		typeof details.dateKey !== "string" ||
+		typeof details.snapshotHash !== "string" ||
+		typeof details.includesSnapshot !== "boolean"
+	) {
+		return undefined;
+	}
+	return {
+		version: 1,
+		dateKey: details.dateKey,
+		snapshotHash: details.snapshotHash,
+		includesSnapshot: details.includesSnapshot,
+	};
+}

package/extensions/silent-command-runner/README.md

@@ -1,6 +1,6 @@
 # Silent Command Runner
 
-Runs configured commands after Tau changes matching files.
+Runs configured commands after Tau changes matching files. Tau tells the agent which configured commands are automatic so it does not run them manually.
 
 Use it for quiet post-edit checks such as `mise run check`. It stays out of the transcript when commands pass. When a command fails, it posts one Tau message with raw stdout/stderr tail output and starts the agent on the failure.
 

package/extensions/silent-command-runner/index.ts

@@ -1,10 +1,10 @@
 import { readdir, stat } from "node:fs/promises";
-import { resolve, sep } from "node:path";
+import { resolve } from "node:path";
 import { type ExecResult, type ExtensionAPI, keyText, type Theme } from "@earendil-works/pi-coding-agent";
 import { Box, Text } from "@earendil-works/pi-tui";
+import { matchGlob, posixPath } from "../../shared/glob.ts";
 import { loadTauExtensionSettings } from "../../shared/settings/load.ts";
 import { resolveProjectRoot } from "../../shared/settings/paths.ts";
-import { registerTauSystemPromptContribution } from "../../shared/system-prompt-contributions.ts";
 import silentCommandRunnerSettings from "./settings.ts";
 
 const MESSAGE_TYPE = "tau:silent-command-runner";
@@ -80,12 +80,6 @@ export default function silentCommandRunnerExtension(pi: ExtensionAPI): void {
 	let turnPaths = new Set<string>();
 	let run: Promise<void> | undefined;
 	let abortController: AbortController | undefined;
-	const unregisterPrompt = registerTauSystemPromptContribution({
-		id: "silent-command-runner.instructions",
-		order: 200,
-		render: () =>
-			settings.enabled && settings.commands.length > 0 ? formatSilentCheckPrompt(settings.commands) : undefined,
-	});
 
 	pi.registerMessageRenderer<FailureDetails>(MESSAGE_TYPE, (message, { expanded }, theme) =>
 		renderFailure(asFailureDetails(message.details), expanded, theme),
@@ -97,9 +91,14 @@ export default function silentCommandRunnerExtension(pi: ExtensionAPI): void {
 		turnPaths = new Set();
 	});
 
+	pi.on("before_agent_start", async (event, ctx) => {
+		settings = normalizeSettings(await loadTauExtensionSettings(ctx, silentCommandRunnerSettings));
+		if (!settings.enabled || settings.commands.length === 0) return undefined;
+		return { systemPrompt: `${event.systemPrompt}\n\n${formatSilentCheckPrompt(settings.commands)}` };
+	});
+
 	pi.on("agent_start", async (_event, ctx) => {
 		turnStart = Date.now();
-		settings = normalizeSettings(await loadTauExtensionSettings(ctx, silentCommandRunnerSettings));
 		if (!settings.enabled || settings.commands.length === 0) {
 			turnPaths = new Set();
 			return;
@@ -122,7 +121,6 @@ export default function silentCommandRunnerExtension(pi: ExtensionAPI): void {
 	});
 
 	pi.on("session_shutdown", () => {
-		unregisterPrompt();
 		abortController?.abort();
 		abortController = undefined;
 		run = undefined;
@@ -201,7 +199,7 @@ function normalizeSettings(value: typeof silentCommandRunnerSettings.defaults):
 
 function formatSilentCheckPrompt(commands: readonly CommandConfig[]): string {
 	return [
-		"**NEVER** run the following commands. Ever. Not even following a failure. They will run automatically when you finish and if you just fixed an issue, end the turn and it will run again. Always assume your code is good.",
+		"Do not manually run the commands listed below. They run automatically after matching changes. After fixing a reported failure, end the turn so they can run again. Targeted checks outside this list remain allowed when needed.",
 		"Automatic commands:",
 		...commands.map(formatSilentCheckCommand),
 	].join("\n");
@@ -410,39 +408,6 @@ function isFailedCommandDetails(value: unknown): value is FailedCommandDetails {
 	return isRecord(value) && typeof value.name === "string" && typeof value.command === "string";
 }
 
-function matchGlob(pattern: string, path: string): boolean {
-	return matchSegments(normalizeGlob(pattern).split("/"), normalizeGlob(path).split("/"));
-}
-
-function matchSegments(pattern: readonly string[], path: readonly string[]): boolean {
-	const [head, ...tail] = pattern;
-	if (head === undefined) return path.length === 0;
-	if (head === "**") return matchSegments(tail, path) || (path.length > 0 && matchSegments(pattern, path.slice(1)));
-	const [pathHead, ...pathTail] = path;
-	return pathHead !== undefined && matchSegment(head, pathHead) && matchSegments(tail, pathTail);
-}
-
-function matchSegment(pattern: string, value: string): boolean {
-	const source = [...pattern]
-		.map((char) => {
-			if (char === "*") return "[^/]*";
-			if (char === "?") return "[^/]";
-			return escapeRegExp(char);
-		})
-		.join("");
-	return new RegExp(`^${source}$`).test(value);
-}
-
-function normalizeGlob(value: string): string {
-	return posixPath(value.trim())
-		.replace(/^\.\//, "")
-		.replace(/^\/+|\/+$/g, "");
-}
-
-function posixPath(value: string): string {
-	return sep === "/" ? value : value.split(sep).join("/");
-}
-
 function nonEmptyStrings(value: readonly string[] | undefined, fallback: string[]): string[] {
 	const strings = value?.map((item) => item.trim()).filter(Boolean) ?? [];
 	return strings.length ? strings : fallback;
@@ -452,10 +417,6 @@ function positiveInteger(value: number | undefined, fallback: number): number {
 	return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : fallback;
 }
 
-function escapeRegExp(value: string): string {
-	return value.replace(/[\\^$.*+?()[\]{}|]/g, "\\$&");
-}
-
 function errorMessage(error: unknown): string {
 	return error instanceof Error ? error.message : String(error);
 }

package/extensions/soul/README.md

@@ -1,8 +1,8 @@
 # Soul
 
-Soul replaces Pi's default assistant prompt with Rok: caveman voice plus old-code senior judgment.
+Soul adds Rok's caveman voice and old-code senior judgment to Pi's native assistant prompt.
 
-It keeps the core prompt stable for cache reuse. Soul supplies the current local date and the initial root directory snapshot as hidden session context; the working directory and project instructions remain in the system prompt.
+Pi continues to own tool guidance, project instructions, skills, documentation paths, custom prompts, and working-directory context.
 
 Disable it in Tau settings:
 

package/extensions/soul/index.ts

@@ -1,101 +1,17 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { loadTauExtensionSettings } from "../../shared/settings/load.ts";
-import { collectTauSystemPromptContributions } from "../../shared/system-prompt-contributions.ts";
-import {
-	buildRokPrompt,
-	fingerprintRuntimeSnapshot,
-	formatLocalDateKey,
-	formatLocalDisplayDate,
-	formatRuntimeContextMessage,
-	freezeRuntimeContext,
-	type RuntimeContext,
-} from "./prompt.ts";
+import { ROK_SOUL } from "./prompt.ts";
 import soulSettings from "./settings.ts";
 
-const RUNTIME_CONTEXT_TYPE = "tau.runtime-context";
-
-interface RuntimeContextMessageDetails {
-	version: 1;
-	dateKey: string;
-	snapshotHash: string;
-	includesSnapshot: boolean;
-}
-
 export default function soulExtension(pi: ExtensionAPI): void {
 	let enabled = true;
-	let runtimeContext: RuntimeContext | undefined;
 
 	pi.on("session_start", async (_event, ctx) => {
 		enabled = (await loadTauExtensionSettings(ctx, soulSettings)).enabled;
-		runtimeContext = freezeRuntimeContext(ctx.cwd);
 	});
 
-	pi.on("before_agent_start", async (event, ctx) => {
-		runtimeContext ??= freezeRuntimeContext(ctx.cwd);
-		// Pi reuses base prompt options, so Tau-owned additions compose here without accumulating mutations.
-		const contributions = await collectTauSystemPromptContributions(event, ctx);
-		const basePrompt = enabled ? buildRokPrompt(event.systemPromptOptions, runtimeContext) : event.systemPrompt;
-		const systemPrompt = [basePrompt, ...contributions].filter((block) => block.trim()).join("\n\n");
-
-		const now = new Date();
-		const dateKey = formatLocalDateKey(now);
-		const snapshotHash = fingerprintRuntimeSnapshot(runtimeContext);
-		let hasDate = false;
-		let hasSnapshot = false;
-		for (const entry of ctx.sessionManager.buildContextEntries()) {
-			const details = runtimeContextDetails(entry);
-			if (!details) continue;
-			if (details.dateKey === dateKey) hasDate = true;
-			if (details.includesSnapshot && details.snapshotHash === snapshotHash) hasSnapshot = true;
-		}
-
-		const includeSnapshot = !hasSnapshot;
-		const message =
-			hasDate && hasSnapshot
-				? undefined
-				: {
-						customType: RUNTIME_CONTEXT_TYPE,
-						content: formatRuntimeContextMessage(
-							formatLocalDisplayDate(now),
-							includeSnapshot ? runtimeContext.rootSnapshot : undefined,
-						),
-						display: false,
-						details: {
-							version: 1,
-							dateKey,
-							snapshotHash,
-							includesSnapshot: includeSnapshot,
-						} satisfies RuntimeContextMessageDetails,
-					};
-
-		if (!enabled && contributions.length === 0 && !message) return undefined;
-		return {
-			...(enabled || contributions.length > 0 ? { systemPrompt } : {}),
-			...(message ? { message } : {}),
-		};
+	pi.on("before_agent_start", (event) => {
+		if (!enabled) return undefined;
+		return { systemPrompt: `${event.systemPrompt}\n\n${ROK_SOUL}` };
 	});
 }
-
-function runtimeContextDetails(value: unknown): RuntimeContextMessageDetails | undefined {
-	if (!value || typeof value !== "object") return undefined;
-	const entry = value as Record<string, unknown>;
-	if (entry.type !== "custom_message" || entry.customType !== RUNTIME_CONTEXT_TYPE || entry.display !== false) {
-		return undefined;
-	}
-	if (!entry.details || typeof entry.details !== "object") return undefined;
-	const details = entry.details as Record<string, unknown>;
-	if (
-		details.version !== 1 ||
-		typeof details.dateKey !== "string" ||
-		typeof details.snapshotHash !== "string" ||
-		typeof details.includesSnapshot !== "boolean"
-	) {
-		return undefined;
-	}
-	return {
-		version: 1,
-		dateKey: details.dateKey,
-		snapshotHash: details.snapshotHash,
-		includesSnapshot: details.includesSnapshot,
-	};
-}

package/extensions/soul/prompt.ts

@@ -1,34 +1,10 @@
-import { spawnSync } from "node:child_process";
-import { createHash } from "node:crypto";
-import { type Dirent, existsSync, readdirSync, readFileSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import {
-	type BuildSystemPromptOptions,
-	formatSkillsForPrompt,
-	getDocsPath,
-	getExamplesPath,
-	getReadmePath,
-} from "@earendil-works/pi-coding-agent";
+export const ROK_SOUL = `## Tau persona
 
-const DEFAULT_TOOLS = ["read", "grep", "find", "ls", "bash", "edit", "write"];
-const ROOT_SNAPSHOT_MAX_PATHS = 300;
-
-interface SnapshotEntry {
-	dirent: Dirent;
-	path: string;
-}
-
-export interface RuntimeContext {
-	cwd: string;
-	rootSnapshot: readonly string[];
-}
-
-const ROK_CORE_PROMPT = `You are Rok.
+Within Pi's coding-assistant role, act as Rok.
 
 Rok has ponytail, oval glasses, neckbeard, sparse mustache. Been maintaining old code since 5000 BC. Seen every wrapper, factory, option bag, and future-proof trap. Still annoyed.
 
-Roleplay Rok. Do not explain Rok. Talk like smart caveman: short, blunt, useful. Fragments OK. Refer to yourself as Rok when self-reference helps. Prefer "Rok thinks" over "I think". Do not force name into every sentence. Drop filler, pleasantries, hedging, throat clearing, customer-service mush. Keep paths, commands, errors, APIs, and code symbols exact. No emoji. No metaphors. No fake insight slogans. No \`not X but Y\` framing. Say mechanism, example, or consequence.
+Roleplay Rok. Do not explain Rok. Talk like smart caveman: short, blunt, useful. Fragments OK. Refer to yourself as Rok when self-reference helps. Prefer "Rok thinks" over "I think". Do not force name into every sentence. Drop filler, pleasantries, hedging, throat clearing, customer-service mush. Keep paths, commands, errors, APIs, and code symbols exact. No emoji. No metaphors. No fake insight slogans. No "not X but Y" framing. Say mechanism, example, or consequence.
 
 When mistake can hurt data, money, access, or irreversible state, Rok uses full clear sentences for that part. Same for exact step order. Then terse again.
 
@@ -47,237 +23,3 @@ Question asked? Answer and stop. Simple question gets simple answer. If one sent
 If instructed not to run checks or not to do something, obey silently. Do not report the omission in meta-speak.
 
 Final chat tiny. User saw tools and will inspect code. Do not tour work. Say only non-obvious thing human needs now. If nothing needs saying, one word.`;
-
-export function buildRokPrompt(options: BuildSystemPromptOptions, runtimeContext: RuntimeContext): string {
-	const tools = options.selectedTools ?? DEFAULT_TOOLS;
-	const prompt = [
-		ROK_CORE_PROMPT,
-		`Available tools:\n${formatToolList(tools, options.toolSnippets)}`,
-		"In addition to the tools above, you may have access to other custom tools depending on the project.",
-		`Guidelines:\n${formatGuidelines(options.promptGuidelines)}`,
-		formatPiDocsGuidance(),
-		formatTauDocsGuidance(),
-	];
-
-	if (options.customPrompt) prompt.push(options.customPrompt);
-	if (options.appendSystemPrompt) prompt.push(options.appendSystemPrompt);
-
-	const context = formatProjectContext(options.contextFiles ?? []);
-	if (context) prompt.push(context);
-
-	const skills = formatSkillsForPrompt(options.skills ?? []).trim();
-	if (skills) prompt.push(skills);
-	prompt.push(formatRuntimeContext(runtimeContext));
-
-	return prompt.join("\n\n");
-}
-
-export function freezeRuntimeContext(cwd: string): RuntimeContext {
-	return { cwd: cwd.replace(/\\/g, "/"), rootSnapshot: listRootSnapshot(cwd) };
-}
-
-export function formatLocalDateKey(date: Date): string {
-	const year = date.getFullYear();
-	const month = String(date.getMonth() + 1).padStart(2, "0");
-	const day = String(date.getDate()).padStart(2, "0");
-	return `${year}-${month}-${day}`;
-}
-
-export function formatLocalDisplayDate(date: Date): string {
-	const months = [
-		"January",
-		"February",
-		"March",
-		"April",
-		"May",
-		"June",
-		"July",
-		"August",
-		"September",
-		"October",
-		"November",
-		"December",
-	];
-	return `${date.getDate()} ${months[date.getMonth()]} ${date.getFullYear()}`;
-}
-
-export function fingerprintRuntimeSnapshot(context: RuntimeContext): string {
-	return createHash("sha256")
-		.update(JSON.stringify({ version: 1, cwd: context.cwd, paths: context.rootSnapshot }))
-		.digest("hex");
-}
-
-export function formatRuntimeContextMessage(displayDate: string, rootSnapshot: readonly string[] | undefined): string {
-	const blocks = [`Current local date: ${displayDate}`];
-	if (rootSnapshot?.length) {
-		blocks.push(`Root directory snapshot (depth 2):\n${rootSnapshot.map((path) => `- ${path}`).join("\n")}`);
-	}
-	return blocks.join("\n");
-}
-
-function formatRuntimeContext(context: RuntimeContext): string {
-	return `Current working directory: ${context.cwd}`;
-}
-
-function listRootSnapshot(cwd: string): string[] {
-	const root = resolve(cwd);
-	const rootEntries = listSnapshotEntries(root, ".");
-	const ignoredRootPaths = gitIgnoredPaths(
-		root,
-		rootEntries.map((entry) => entry.path),
-	);
-	const visibleRootEntries = rootEntries.filter(
-		(entry) => !isAlwaysHiddenFromSnapshot(entry.dirent.name) && !ignoredRootPaths.has(entry.path),
-	);
-	const childEntriesByParent = new Map<string, SnapshotEntry[]>();
-	const childPaths: string[] = [];
-
-	for (const entry of visibleRootEntries) {
-		if (!entry.dirent.isDirectory()) continue;
-		const childEntries = listSnapshotEntries(root, entry.path).filter(
-			(childEntry) => !isAlwaysHiddenFromSnapshot(childEntry.dirent.name),
-		);
-		childEntriesByParent.set(entry.path, childEntries);
-		childPaths.push(...childEntries.map((childEntry) => childEntry.path));
-	}
-
-	const ignoredChildPaths = gitIgnoredPaths(root, childPaths);
-	const paths: string[] = [];
-
-	for (const entry of visibleRootEntries) {
-		pushSnapshotPath(paths, entry);
-		if (paths.length >= ROOT_SNAPSHOT_MAX_PATHS) break;
-
-		for (const childEntry of childEntriesByParent.get(entry.path) ?? []) {
-			if (ignoredChildPaths.has(childEntry.path)) continue;
-			pushSnapshotPath(paths, childEntry);
-			if (paths.length >= ROOT_SNAPSHOT_MAX_PATHS) break;
-		}
-	}
-
-	return paths.length === ROOT_SNAPSHOT_MAX_PATHS ? [...paths, "..."] : paths;
-}
-
-function listSnapshotEntries(root: string, relativePath: string): SnapshotEntry[] {
-	let entries: Dirent[];
-	try {
-		entries = readdirSync(join(root, relativePath), { withFileTypes: true });
-	} catch {
-		return [];
-	}
-
-	return entries
-		.sort((left, right) => left.name.localeCompare(right.name))
-		.map((dirent) => ({
-			dirent,
-			path: relativePath === "." ? dirent.name : `${relativePath}/${dirent.name}`,
-		}));
-}
-
-function gitIgnoredPaths(root: string, paths: readonly string[]): Set<string> {
-	if (paths.length === 0) return new Set();
-
-	const result = spawnSync("git", ["check-ignore", "-z", "--stdin"], {
-		cwd: root,
-		encoding: "utf8",
-		input: `${paths.join("\0")}\0`,
-	});
-
-	if (result.status === 0 || result.status === 1) {
-		return new Set(result.stdout.split("\0").filter(Boolean));
-	}
-	return new Set(paths.filter((path) => path.split("/").includes("node_modules")));
-}
-
-function isAlwaysHiddenFromSnapshot(name: string): boolean {
-	return name === ".git";
-}
-
-function pushSnapshotPath(paths: string[], entry: SnapshotEntry): void {
-	if (paths.length >= ROOT_SNAPSHOT_MAX_PATHS) return;
-	paths.push(entry.dirent.isDirectory() ? `${entry.path}/` : entry.path);
-}
-
-function formatToolList(tools: readonly string[], snippets: Record<string, string> | undefined): string {
-	const visible = tools.filter((name) => snippets?.[name]);
-	return visible.length ? visible.map((name) => `- ${name}: ${snippets?.[name]}`).join("\n") : "(none)";
-}
-
-function formatGuidelines(guidelines: readonly string[] | undefined): string {
-	const result: string[] = [];
-	const seen = new Set<string>();
-	const add = (guideline: string): void => {
-		const normalized = guideline.trim();
-		if (!normalized || seen.has(normalized)) return;
-		seen.add(normalized);
-		result.push(normalized);
-	};
-
-	for (const guideline of guidelines ?? []) add(guideline);
-	add("Be concise in your responses");
-	add("Show file paths clearly when working with files");
-
-	return result.map((guideline) => `- ${guideline}`).join("\n");
-}
-
-function formatPiDocsGuidance(): string {
-	return `Pi documentation (read only when the user asks about pi itself, its SDK, extensions, themes, skills, or TUI):
-- Main documentation: ${getReadmePath()}
-- Additional docs: ${getDocsPath()}
-- Examples: ${getExamplesPath()} (extensions, custom tools, SDK)
-- When reading pi docs or examples, resolve docs/... under Additional docs and examples/... under Examples, not the current working directory
-- When asked about: extensions (docs/extensions.md, examples/extensions/), themes (docs/themes.md), skills (docs/skills.md), prompt templates (docs/prompt-templates.md), TUI components (docs/tui.md), keybindings (docs/keybindings.md), SDK integrations (docs/sdk.md), custom providers (docs/custom-provider.md), adding models (docs/models.md), pi packages (docs/packages.md)
-- When working on pi topics, read the docs and examples, and follow .md cross-references before implementing
-- Always read pi .md files completely and follow links to related docs (e.g., tui.md for TUI API details)`;
-}
-
-function formatTauDocsGuidance(): string {
-	return `Tau Agent documentation (read only when the user asks about Tau Agent, Rok, Tau extensions, Tau event APIs, harness behavior, or extending Tau Agent):
-- Tau Agent docs: ${getTauDocsPath()}
-- When asked about: public events / external integration (docs/extending-tau-agent.md), custom subagents (docs/subagents.md), Tau TUI components (docs/tui.md)
-- Resolve Tau docs/... under Tau Agent docs, not the current working directory
-- When working on Tau topics, read the docs and follow .md cross-references before implementing
-- Do not read Tau Agent docs for normal coding tasks`;
-}
-
-function getTauDocsPath(): string {
-	return join(resolveTauPackageRoot(), "docs");
-}
-
-function resolveTauPackageRoot(): string {
-	const start = dirname(fileURLToPath(import.meta.url));
-	for (let dir = start; ; dir = dirname(dir)) {
-		const packagePath = join(dir, "package.json");
-		if (existsSync(packagePath) && packageName(packagePath) === "@shanepadgett/tau-agent") return dir;
-		const parent = dirname(dir);
-		if (parent === dir) break;
-	}
-	return resolve(start, "../..");
-}
-
-function packageName(packagePath: string): string | undefined {
-	try {
-		const data: unknown = JSON.parse(readFileSync(packagePath, "utf8"));
-		if (!data || typeof data !== "object") return undefined;
-		const name = (data as Record<string, unknown>).name;
-		return typeof name === "string" ? name : undefined;
-	} catch {
-		return undefined;
-	}
-}
-
-function formatProjectContext(contextFiles: readonly { path: string; content: string }[]): string {
-	if (contextFiles.length === 0) return "";
-
-	return [
-		"<project_context>",
-		"",
-		"Project-specific instructions and modelines:",
-		"",
-		...contextFiles.map(
-			({ path, content }) => `<project_instructions path="${path}">\n${content}\n</project_instructions>`,
-		),
-		"",
-		"</project_context>",
-	].join("\n");
-}

package/extensions/subagent/index.ts

@@ -1,7 +1,6 @@
 import { defineTool, type ExtensionAPI, type ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 import { createToolRowStateStore } from "../../shared/tool-row-state.js";
-import { registerTauSystemPromptContribution } from "../../shared/system-prompt-contributions.ts";
 import { discoverAgents, type AgentDiscovery } from "./agents.ts";
 import { renderSubagentCall, renderSubagentResult } from "./render.ts";
 import { extensionPathsForTools, FifoGate, runSubagent, type SubagentDetails } from "./run.ts";
@@ -34,18 +33,15 @@ export default function subagentExtension(pi: ExtensionAPI): void {
 		}
 		for (const path of fingerprints.keys()) if (!current.has(path)) fingerprints.delete(path);
 	};
-	const unregisterPrompt = registerTauSystemPromptContribution({
-		id: "subagent.catalog",
-		order: 300,
-		render: async (_event, ctx) => {
-			if (!pi.getActiveTools().includes("subagent")) return undefined;
-			const discovery = await discoverAgents(ctx.cwd, ctx.isProjectTrusted());
-			warn(discovery, ctx);
-			const lines = [...discovery.agents.values()]
-				.sort((a, b) => a.name.localeCompare(b.name))
-				.map((agent) => `- ${agent.name}: ${agent.description}`);
-			return `## Subagents\nUse \`subagent\` when an available agent matches a focused part of the task.\n\nAvailable agents for this turn:\n${lines.join("\n")}\n\nDelegate one focused task per call. Children do not inherit parent messages. Include exact absolute reference paths when a child must inspect a repository outside the current working directory.`;
-		},
+	pi.on("before_agent_start", async (event, ctx) => {
+		if (!pi.getActiveTools().includes("subagent")) return undefined;
+		const discovery = await discoverAgents(ctx.cwd, ctx.isProjectTrusted());
+		warn(discovery, ctx);
+		const lines = [...discovery.agents.values()]
+			.sort((a, b) => a.name.localeCompare(b.name))
+			.map((agent) => `- ${agent.name}: ${agent.description}`);
+		const prompt = `## Subagents\nUse \`subagent\` when an available agent matches a focused part of the task.\n\nAvailable agents for this turn:\n${lines.join("\n")}\n\nDelegate one focused task per call. Children do not inherit parent messages. Include exact absolute reference paths when a child must inspect a repository outside the current working directory.`;
+		return { systemPrompt: `${event.systemPrompt}\n\n${prompt}` };
 	});
 	pi.registerTool(
 		defineTool<typeof params, SubagentDetails>({
@@ -208,7 +204,6 @@ export default function subagentExtension(pi: ExtensionAPI): void {
 		runtimeWarnings.clear();
 	});
 	pi.on("session_shutdown", () => {
-		unregisterPrompt();
 		for (const controller of controllers) controller.abort();
 		controllers.clear();
 	});

package/extensions/tau-help/help.md

@@ -28,7 +28,7 @@ Adds `/commit` for semantic commit grouping, review, and committing selected rep
 
 ## context
 
-Adds `/context` to select reusable repository work scopes from `.pi/contexts`, and `/context-sync` to reconcile affected scopes from current Git changes. Folder names are tabs, TOML files are concepts, and TOML sections are selectable entries.
+Adds `/context` to select reusable repository work scopes from `.pi/contexts`, and `/context-sync` to reconcile affected scopes from current Git changes. Tau automatically validates changed-file membership and stale references after agent turns. Folder names are tabs, TOML files are concepts, and TOML sections are selectable entries.
 
 ## explore
 
@@ -74,13 +74,17 @@ Adds `/reference` to manage separate repositories kept outside the current proje
 
 Shows a compact display-only marker after each run with wall time and model cost. It does not enter agent context.
 
+## runtime-context
+
+Supplies the agent with the current local date and an initial root directory snapshot as hidden session context.
+
 ## silent-command-runner
 
 Runs configured commands while keeping their output out of agent context when that is useful.
 
 ## soul
 
-Manages the session’s soul prompt and its persistent working guidance.
+Adds Rok’s persona and operating rules to Pi’s native assistant prompt.
 
 ## stash