@agntn/harnesses 0.1.1 → 0.2.1

package/dist/_chunks/{agents-sync.mjs → prompt-sync.mjs}

@@ -1,11 +1,14 @@
+import { createRequire } from "node:module";
 import { addAbortListener } from "node:events";
-import { existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync, renameSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
+import { copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, readlinkSync, realpathSync, renameSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
 import { execFile, execFileSync, spawn } from "node:child_process";
 import { setTimeout as setTimeout$1 } from "node:timers/promises";
-import { basename, dirname, isAbsolute, join, posix, resolve, win32 } from "node:path";
+import { basename, dirname, extname, isAbsolute, join, posix, relative, resolve, win32 } from "node:path";
 import os, { homedir } from "node:os";
 import { stripVTControlCharacters } from "node:util";
 import { parse } from "smol-toml";
+import { randomUUID } from "node:crypto";
+import { parse as parse$1 } from "yaml";
 const PATH_MARKERS = /^~(?=\/|$)|\$\{HOME\}|\$\{PROJECT_ROOT\}|%([^%]+)%/g;
 function resolvePathTemplate(template, options = {}) {
 	const homeDir = options.homeDir ?? os.homedir();
@@ -20,6 +23,10 @@ function agntnConfigDir(options = {}) {
 	const base = process.env.XDG_CONFIG_HOME && process.env.XDG_CONFIG_HOME !== "" ? process.env.XDG_CONFIG_HOME : join(options.homeDir ?? os.homedir(), ".config");
 	return join(base, "agntn");
 }
+function agntnDataDir(options = {}) {
+	const base = process.env.XDG_DATA_HOME && process.env.XDG_DATA_HOME !== "" ? process.env.XDG_DATA_HOME : join(options.homeDir ?? os.homedir(), ".local", "share");
+	return join(base, "agntn");
+}
 const SUPPORTED_PLATFORMS = {
 	linux: true,
 	darwin: true,
@@ -196,6 +203,8 @@ function executeCommand(command, args, options) {
 	});
 }
 var Harness = class {
+	promptTemplates = [];
+	promptTemplateSyncTarget = null;
 	modelListing = null;
 	mcpConfigs = [];
 	agentsFile = null;
@@ -324,6 +333,8 @@ var Harness = class {
 			instructions: this.resolveCandidates(this.instructions, options),
 			skills: this.resolveCandidates(this.skills, options),
 			commands: this.resolveCandidates(this.commands, options),
+			promptTemplates: this.resolveCandidates(this.promptTemplates, options),
+			promptTemplateSyncTarget: this.promptTemplateSyncTarget === null ? null : this.resolveCandidates([this.promptTemplateSyncTarget], options)[0] ?? null,
 			hooks: this.resolveCandidates(this.hooks, options)
 		};
 	}
@@ -601,6 +612,13 @@ var Claude = class extends Harness {
 		level: "official",
 		note: "Legacy global slash commands."
 	}];
+	promptTemplates = this.commands;
+	promptTemplateSyncTarget = {
+		path: "~/.claude/commands/",
+		scope: "user",
+		level: "official",
+		format: "markdown"
+	};
 	hooks = [{
 		path: ".claude/hooks/",
 		scope: "project",
@@ -622,6 +640,7 @@ var Claude = class extends Harness {
 		noToolsArgs: [
 			"-p",
 			"{prompt}",
+			"--strict-mcp-config",
 			"--tools",
 			""
 		],
@@ -630,6 +649,7 @@ var Claude = class extends Harness {
 			"--output-format",
 			"json",
 			"{prompt}",
+			"--strict-mcp-config",
 			"--tools",
 			""
 		],
@@ -652,7 +672,7 @@ var Claude = class extends Harness {
 		readOnlyMinVersion: "2.1.175",
 		modelArgs: ["--model", "{model}"],
 		level: "official",
-		note: "Headless print mode; add --output-format json for structured output. Read-only runs keep the built-in Read, Glob and Grep tools and --strict-mcp-config drops every configured MCP server, so no write tool exists whatever permission mode the settings carry; verified on 2.1.175 and 2.1.268. --permission-mode plan does not qualify: its shell commands run through the auto mode classifier, which let a file write through."
+		note: "Headless print mode; add --output-format json for structured output. --tools only covers the built-in set, so every mode without the full agent adds --strict-mcp-config to drop configured MCP servers too; without it an advisor still sees every user and project MCP tool, checked on 2.1.280. Read-only runs keep the built-in Read, Glob and Grep tools, so no write tool exists whatever permission mode the settings carry; verified on 2.1.175 and 2.1.268. --permission-mode plan does not qualify: its shell commands run through the auto mode classifier, which let a file write through."
 	};
 	mcpConfigs = [{
 		path: "~/.claude.json",
@@ -807,7 +827,19 @@ var Codex = class extends Harness {
 			platforms: ["linux", "darwin"]
 		}
 	];
-	commands = [];
+	commands = [{
+		path: "~/.codex/prompts/",
+		scope: "user",
+		level: "official",
+		note: "Deprecated Markdown prompts invoked as /prompts:name. Top-level files only; use skills for shared prompts. Base directory follows CODEX_HOME."
+	}];
+	promptTemplates = this.commands;
+	promptTemplateSyncTarget = {
+		path: "~/.codex/prompts/",
+		scope: "user",
+		level: "official",
+		format: "markdown"
+	};
 	hooks = [];
 	invocation = {
 		args: [
@@ -963,6 +995,18 @@ var Freebuff = class extends Harness {
 	id = "freebuff";
 	name = "Freebuff";
 	binaries = ["freebuff"];
+	get version() {
+		const configDir = join(homedir(), ".config", "manicode");
+		const binaryName = process.platform === "win32" ? "freebuff.exe" : "freebuff";
+		if (!existsSync(join(configDir, binaryName))) return null;
+		try {
+			const metadata = JSON.parse(readFileSync(join(configDir, "freebuff-metadata.json"), "utf8"));
+			if (typeof metadata === "object" && metadata !== null && "version" in metadata && typeof metadata.version === "string" && metadata.version !== "") return metadata.version;
+		} catch {
+			return null;
+		}
+		return null;
+	}
 	capabilities = {
 		mcp: true,
 		vision: true,
@@ -1158,6 +1202,13 @@ var Gemini = class extends Harness {
 		level: "official",
 		note: "Global custom commands in TOML format."
 	}];
+	promptTemplates = this.commands;
+	promptTemplateSyncTarget = {
+		path: "~/.gemini/commands/",
+		scope: "user",
+		level: "official",
+		format: "gemini-toml"
+	};
 	hooks = [];
 	invocation = {
 		args: ["-p", "{prompt}"],
@@ -1417,10 +1468,43 @@ var Grok = class extends Harness {
 		projectMarkers: [".grok"]
 	};
 };
+function packageVersion(commandPath) {
+	try {
+		const require = createRequire(realpathSync(commandPath));
+		const metadata = JSON.parse(readFileSync(require.resolve("mastracode/package.json"), "utf8"));
+		if (typeof metadata === "object" && metadata !== null && "version" in metadata && typeof metadata.version === "string" && metadata.version !== "") return metadata.version;
+	} catch {
+		return null;
+	}
+	return null;
+}
 var MastraCode = class extends Harness {
 	id = "mastracode";
 	name = "Mastra Code";
 	binaries = ["mastracode"];
+	get version() {
+		const locator = process.platform === "win32" ? "where" : "which";
+		let output;
+		try {
+			output = execFileSync(locator, [this.binaries[0] ?? "mastracode"], {
+				encoding: "utf8",
+				stdio: [
+					"pipe",
+					"pipe",
+					"pipe"
+				],
+				timeout: 5e3
+			});
+		} catch {
+			return null;
+		}
+		const paths = output.split(/\r?\n/u).filter((path) => path !== "");
+		for (const path of paths) {
+			const version = packageVersion(path);
+			if (version !== null) return version;
+		}
+		return null;
+	}
 	capabilities = {
 		mcp: true,
 		vision: true,
@@ -1442,6 +1526,12 @@ var MastraCode = class extends Harness {
 			level: "official",
 			note: "Global MCP server configurations."
 		},
+		{
+			path: ".mcp.json",
+			scope: "project",
+			level: "official",
+			note: "Claude Code compatible project MCP servers, read below .mastracode/mcp.json."
+		},
 		{
 			path: ".mastracode/hooks.json",
 			scope: "project",
@@ -1533,16 +1623,51 @@ var MastraCode = class extends Harness {
 			note: "Claude Code compatible."
 		}
 	];
-	commands = [{
-		path: ".mastracode/commands/",
-		scope: "project",
-		level: "official"
-	}, {
+	commands = [
+		{
+			path: ".mastracode/commands/",
+			scope: "project",
+			level: "official",
+			note: "Markdown prompt commands; subdirectories become colon-separated command names."
+		},
+		{
+			path: "~/.mastracode/commands/",
+			scope: "user",
+			level: "official",
+			note: "Global Markdown prompt commands."
+		},
+		{
+			path: ".claude/commands/",
+			scope: "project",
+			level: "official",
+			note: "Claude compatibility."
+		},
+		{
+			path: "~/.claude/commands/",
+			scope: "user",
+			level: "official",
+			note: "Claude compatibility."
+		},
+		{
+			path: ".opencode/command/",
+			scope: "project",
+			level: "official",
+			note: "Mastra's OpenCode compatibility loader uses the singular command directory."
+		},
+		{
+			path: "~/.opencode/command/",
+			scope: "user",
+			level: "official",
+			note: "Mastra's OpenCode compatibility loader uses the singular command directory."
+		}
+	];
+	promptTemplates = this.commands;
+	promptTemplateSyncTarget = {
 		path: "~/.mastracode/commands/",
 		scope: "user",
 		level: "official",
-		note: "Global commands."
-	}];
+		format: "markdown"
+	};
 	hooks = [{
 		path: ".mastracode/hooks.json",
 		scope: "project",
@@ -1554,6 +1679,35 @@ var MastraCode = class extends Harness {
 		note: "Global hooks."
 	}];
 	invocation = null;
+	mcpConfigs = [
+		{
+			path: "~/.mastracode/mcp.json",
+			scope: "user",
+			level: "official",
+			format: "json",
+			key: ["mcpServers"],
+			dialect: "mastracode",
+			note: "An entry with command is stdio and one with url is HTTP, type is ignored. Loaded above mcpServers from the project's .claude/settings.local.json and below both project files, later names winning."
+		},
+		{
+			path: ".mastracode/mcp.json",
+			scope: "project",
+			level: "official",
+			format: "json",
+			key: ["mcpServers"],
+			dialect: "mastracode",
+			note: "Highest priority, overrides the other files entry by entry."
+		},
+		{
+			path: ".mcp.json",
+			scope: "project",
+			level: "official",
+			format: "json",
+			key: ["mcpServers"],
+			dialect: "mastracode",
+			note: "Claude Code's project file, read between the user file and .mastracode/mcp.json. Project writes go to .mastracode/mcp.json, this one is Claude's to edit."
+		}
+	];
 	detection = {
 		envVars: [],
 		projectMarkers: [".mastracode"]
@@ -1701,13 +1855,35 @@ var Omp = class extends Harness {
 	commands = [{
 		path: ".omp/commands/",
 		scope: "project",
-		level: "official"
+		level: "official",
+		note: "Markdown prompt commands and TypeScript commands; only Markdown files are templates."
 	}, {
 		path: "~/.omp/agent/commands/",
 		scope: "user",
 		level: "official",
-		note: "Global user-level prompt commands."
+		note: "Global Markdown prompt commands and TypeScript commands; only Markdown files are templates."
 	}];
+	promptTemplates = [
+		...this.commands,
+		{
+			path: ".omp/prompts/",
+			scope: "project",
+			level: "official",
+			note: "Markdown prompt templates invoked as /name; subdirectories are scanned."
+		},
+		{
+			path: "~/.omp/agent/prompts/",
+			scope: "user",
+			level: "official",
+			note: "Global Markdown prompt templates, separate from executable commands."
+		}
+	];
+	promptTemplateSyncTarget = {
+		path: "~/.omp/agent/prompts/",
+		scope: "user",
+		level: "official",
+		format: "markdown"
+	};
 	hooks = [];
 	invocation = {
 		args: ["-p", "{prompt}"],
@@ -1850,7 +2026,24 @@ var OpenCode = class extends Harness {
 			level: "official"
 		}
 	];
-	commands = [];
+	commands = [{
+		path: ".opencode/commands/",
+		scope: "project",
+		level: "official",
+		note: "Markdown prompt commands; also configurable through command entries in opencode.json."
+	}, {
+		path: "~/.config/opencode/commands/",
+		scope: "user",
+		level: "official",
+		note: "Global Markdown prompt commands."
+	}];
+	promptTemplates = this.commands;
+	promptTemplateSyncTarget = {
+		path: "~/.config/opencode/commands/",
+		scope: "user",
+		level: "official",
+		format: "markdown"
+	};
 	hooks = [];
 	invocation = {
 		args: ["run", "{prompt}"],
@@ -2012,6 +2205,13 @@ var Pi = class extends Harness {
 		level: "official",
 		note: "Global user-level prompt templates."
 	}];
+	promptTemplates = this.commands;
+	promptTemplateSyncTarget = {
+		path: "~/.pi/agent/prompts/",
+		scope: "user",
+		level: "official",
+		format: "markdown"
+	};
 	hooks = [];
 	invocation = {
 		args: ["-p", "{prompt}"],
@@ -2182,6 +2382,13 @@ var PrimeAgent = class extends Harness {
 		level: "official",
 		note: "Global user-level prompt templates."
 	}];
+	promptTemplates = this.commands;
+	promptTemplateSyncTarget = {
+		path: "~/.prime/agent/prompts/",
+		scope: "user",
+		level: "official",
+		format: "markdown"
+	};
 	hooks = [];
 	invocation = {
 		args: ["-p", "{prompt}"],
@@ -2411,8 +2618,21 @@ function normalizePrime(name, raw) {
 		env: primeEnv(raw.env)
 	});
 }
+function normalizeMastracode(name, raw) {
+	const url = stringField(raw, "url");
+	return compact({
+		name,
+		transport: url ? "http" : "stdio",
+		command: stringField(raw, "command"),
+		args: asStringArray(raw.args),
+		env: asStringRecord(raw.env),
+		url,
+		headers: asStringRecord(raw.headers)
+	});
+}
 function normalizeEntry(name, raw, dialect) {
 	if (dialect === "antigravity") return normalizeAntigravity(name, raw);
+	if (dialect === "mastracode") return normalizeMastracode(name, raw);
 	if (dialect === "opencode") return normalizeOpenCode(name, raw);
 	if (dialect === "prime") return normalizePrime(name, raw);
 	return normalizeStandard(name, raw);
@@ -2439,6 +2659,17 @@ function denormalizeOpenCode(server) {
 		enabled: server.enabled
 	});
 }
+function denormalizeMastracode(server) {
+	if (server.url) return compact({
+		url: server.url,
+		headers: server.headers
+	});
+	return compact({
+		command: server.command,
+		args: server.args?.length ? server.args : void 0,
+		env: server.env
+	});
+}
 function denormalizeStandard(server) {
 	return compact({
 		type: server.transport,
@@ -2484,8 +2715,18 @@ function resolveEnvReferences(server, dialect) {
 		env
 	};
 }
+function shapeForDialect(server, dialect) {
+	const shaped = resolveEnvReferences(server, dialect);
+	if (dialect !== "mastracode") return shaped;
+	return compact({
+		...shaped,
+		transport: shaped.url ? "http" : "stdio",
+		enabled: void 0
+	});
+}
 function denormalizeEntry(server, dialect) {
 	if (dialect === "antigravity") return denormalizeAntigravity(server);
+	if (dialect === "mastracode") return denormalizeMastracode(server);
 	if (dialect === "opencode") return denormalizeOpenCode(server);
 	if (dialect === "prime") return denormalizePrime(server);
 	return denormalizeStandard(server);
@@ -2543,9 +2784,6 @@ function writeAtomically(path, content) {
 	writeFileSync(temp, content);
 	renameSync(temp, path);
 }
-function escapeRegExp(value) {
-	return value.replaceAll(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
 function tomlValue(value) {
 	return JSON.stringify(value);
 }
@@ -2567,8 +2805,8 @@ function tomlSections(key, server) {
 	return `${lines.join("\n")}\n`;
 }
 function stripTomlServer(raw, key, name) {
-	const prefix = escapeRegExp(key.map(tomlKeyPart).join("."));
-	const namePart = `(?:${escapeRegExp(tomlKeyPart(name))}|${escapeRegExp(JSON.stringify(name))})`;
+	const prefix = RegExp.escape(key.map(tomlKeyPart).join("."));
+	const namePart = `(?:${RegExp.escape(tomlKeyPart(name))}|${RegExp.escape(JSON.stringify(name))})`;
 	const sectionRe = new RegExp(`^\\s*\\[${prefix}\\.${namePart}(\\.[^\\]]+)?\\]`);
 	const bareTableRe = new RegExp(`^\\s*\\[${prefix}\\]\\s*(#.*)?$`);
 	const anyHeaderRe = /^\s*\[/;
@@ -2624,7 +2862,7 @@ function removeTomlServer(path, key, name) {
 }
 function addMcpServer(harness, server, scope = "user", options = {}) {
 	const { entry, path } = writableConfig(harness, scope, options);
-	const resolved = resolveEnvReferences(server, entry.dialect);
+	const resolved = shapeForDialect(server, entry.dialect);
 	if (entry.format === "toml") return {
 		path,
 		replaced: addTomlServer(path, entry.key, resolved)
@@ -2844,7 +3082,7 @@ function syncIncludedHarness(harness, master, existing, masterNames, initialPath
 	let path = initialPath;
 	const { dialect } = writableConfig(harness, "user", options).entry;
 	for (const server of master.servers) try {
-		const resolved = resolveEnvReferences(server, dialect);
+		const resolved = shapeForDialect(server, dialect);
 		if (existing.get(server.name) === canonical(resolved)) {
 			results.push({
 				name: server.name,
@@ -2992,6 +3230,15 @@ function relink(path, source) {
 	symlinkSync(source, temp);
 	renameSync(temp, path);
 }
+function moveFile(from, to) {
+	try {
+		renameSync(from, to);
+	} catch (error) {
+		if (error.code !== "EXDEV") throw error;
+		copyFileSync(from, to);
+		unlinkSync(from);
+	}
+}
 const CHECK_ACTION = {
 	missing: "linked",
 	"correct-link": "unchanged",
@@ -3004,7 +3251,7 @@ function applyFileTarget(id, path, source, state, options) {
 		const backupDir = join(agntnConfigDir(options), "diverged");
 		mkdirSync(backupDir, { recursive: true });
 		const backup = join(backupDir, `${id}-${basename(path)}-${Date.now()}.md`);
-		renameSync(path, backup);
+		moveFile(path, backup);
 		relink(path, source);
 		return {
 			path,
@@ -3039,7 +3286,7 @@ function syncFileTarget(id, path, source, check, options) {
 	};
 	return applyFileTarget(id, path, source, state, options);
 }
-function syncTarget(harness, config, check, options) {
+function syncTarget$1(harness, config, check, options) {
 	if (config.excludes.includes(harness.id)) return {
 		id: harness.id,
 		action: "skipped",
@@ -3090,9 +3337,301 @@ function syncAgentsFiles(harnesses, check = false, options = {}) {
 	return {
 		source: config.source,
 		check,
-		targets: harnesses.map((harness) => syncTarget(harness, config, check, options))
+		targets: harnesses.map((harness) => syncTarget$1(harness, config, check, options))
+	};
+}
+const GENERATED_MARKER = "# Generated by @agntn/harnesses from ";
+const PORTABLE_PROMPT_NAME = /^[A-Za-z0-9][A-Za-z0-9_-]*$/u;
+const GEMINI_ACTION = {
+	missing: "generated",
+	"correct-link": "adopted",
+	"wrong-link": "adopted",
+	"owned-file": "replaced",
+	"unmanaged-file": "adopted",
+	unsupported: "skipped"
+};
+const GEMINI_BACKUP = {
+	missing: false,
+	"correct-link": true,
+	"wrong-link": true,
+	"owned-file": true,
+	"unmanaged-file": true,
+	unsupported: false
+};
+function readTemplates(sourceDir, check) {
+	let entries;
+	try {
+		entries = readdirSync(sourceDir, { withFileTypes: true });
+	} catch (error) {
+		if (error.code !== "ENOENT") throw error;
+		if (!check) mkdirSync(sourceDir, { recursive: true });
+		return [];
+	}
+	const templates = entries.filter((entry) => (entry.isFile() || entry.isSymbolicLink()) && extname(entry.name).toLowerCase() === ".md").map((entry) => {
+		const name = basename(entry.name, extname(entry.name));
+		if (!PORTABLE_PROMPT_NAME.test(name)) throw new TypeError(`Invalid prompt template filename: ${entry.name}`);
+		const path = join(sourceDir, entry.name);
+		return {
+			name,
+			path,
+			content: readFileSync(path, "utf8")
+		};
+	}).sort((left, right) => left.name.localeCompare(right.name));
+	const names = templates.map((template) => template.name.toLowerCase());
+	if (new Set(names).size !== names.length) throw new Error(`Duplicate prompt template names in ${sourceDir}`);
+	return templates;
+}
+function generatedSource(content) {
+	const firstLine = content.split("\n", 1)[0] ?? "";
+	if (!firstLine.startsWith(GENERATED_MARKER)) return null;
+	try {
+		const source = JSON.parse(firstLine.slice(37));
+		return typeof source === "string" ? source : null;
+	} catch {
+		return null;
+	}
+}
+function inspectDestination(path, source) {
+	let stats;
+	try {
+		stats = lstatSync(path);
+	} catch (error) {
+		if (error.code === "ENOENT") return { kind: "missing" };
+		throw error;
+	}
+	if (stats.isSymbolicLink()) {
+		if (source === void 0) return { kind: "unmanaged-file" };
+		const target = readlinkSync(path);
+		return (isAbsolute(target) ? target : resolve(dirname(path), target)) === source ? { kind: "correct-link" } : { kind: "wrong-link" };
+	}
+	if (!stats.isFile()) return { kind: "unsupported" };
+	const content = readFileSync(path, "utf8");
+	if (generatedSource(content) !== null) return {
+		kind: "owned-file",
+		content
+	};
+	return { kind: "unmanaged-file" };
+}
+function tempPath(path, kind) {
+	return join(dirname(path), `.${basename(path)}-${randomUUID()}.${kind}.tmp`);
+}
+function linkTemplate(path, source) {
+	mkdirSync(dirname(path), { recursive: true });
+	const temp = tempPath(path, "prompt-link");
+	symlinkSync(source, temp);
+	renameSync(temp, path);
+}
+function writeTemplate(path, content) {
+	mkdirSync(dirname(path), { recursive: true });
+	const temp = tempPath(path, "prompt-write");
+	writeFileSync(temp, content);
+	renameSync(temp, path);
+}
+function backupDestination(id, path, options) {
+	const backupDir = join(agntnDataDir(options), "diverged", "prompts", id);
+	mkdirSync(backupDir, { recursive: true });
+	const backup = join(backupDir, `${basename(path)}-${Date.now()}-${randomUUID()}`);
+	if (lstatSync(path).isSymbolicLink()) {
+		const target = readlinkSync(path);
+		symlinkSync(isAbsolute(target) ? target : resolve(dirname(path), target), backup);
+		unlinkSync(path);
+		return backup;
+	}
+	moveFile(path, backup);
+	return backup;
+}
+function checkDetail() {
+	return "check mode: not applied";
+}
+function syncMarkdownTemplate(id, targetDir, template, check, options) {
+	const path = join(targetDir, `${template.name}.md`);
+	const state = inspectDestination(path, template.path);
+	if (state.kind === "correct-link") return {
+		name: template.name,
+		source: template.path,
+		path,
+		action: "unchanged"
+	};
+	if (state.kind === "unsupported") return {
+		name: template.name,
+		source: template.path,
+		path,
+		action: "skipped",
+		detail: "destination exists and is not a file or symlink"
+	};
+	const action = state.kind === "missing" ? "linked" : state.kind === "wrong-link" ? "relinked" : "adopted";
+	if (check) return {
+		name: template.name,
+		source: template.path,
+		path,
+		action,
+		detail: checkDetail()
+	};
+	let detail;
+	if (state.kind === "wrong-link") unlinkSync(path);
+	if (state.kind === "owned-file" || state.kind === "unmanaged-file") detail = backupDestination(id, path, options);
+	linkTemplate(path, template.path);
+	return {
+		name: template.name,
+		source: template.path,
+		path,
+		action,
+		detail
+	};
+}
+function frontmatterDescription(raw, path) {
+	const frontmatter = parse$1(raw);
+	if (frontmatter === null) return void 0;
+	if (typeof frontmatter !== "object" || Array.isArray(frontmatter)) throw new TypeError(`Prompt template frontmatter is not an object: ${path}`);
+	const description = frontmatter.description;
+	if (description !== void 0 && typeof description !== "string") throw new TypeError(`Prompt template description is not a string: ${path}`);
+	return description;
+}
+function parseMarkdownTemplate(template) {
+	const match = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(template.content);
+	if (match === null) return { prompt: template.content.replaceAll("$ARGUMENTS", "{{args}}") };
+	const description = frontmatterDescription(match[1] ?? "", template.path);
+	return {
+		...description === void 0 ? {} : { description },
+		prompt: template.content.slice(match[0].length).replaceAll("$ARGUMENTS", "{{args}}")
+	};
+}
+function geminiContent(template) {
+	const parsed = parseMarkdownTemplate(template);
+	return [
+		`${GENERATED_MARKER}${JSON.stringify(template.path)}`,
+		...parsed.description === void 0 ? [] : [`description = ${JSON.stringify(parsed.description)}`],
+		`prompt = ${JSON.stringify(parsed.prompt)}`,
+		""
+	].join("\n");
+}
+function syncGeminiTemplate(id, targetDir, template, check, options) {
+	const path = join(targetDir, `${template.name}.toml`);
+	const content = template.gemini ?? geminiContent(template);
+	const state = inspectDestination(path);
+	if (state.kind === "owned-file" && state.content === content) return {
+		name: template.name,
+		source: template.path,
+		path,
+		action: "unchanged"
+	};
+	if (state.kind === "unsupported") return {
+		name: template.name,
+		source: template.path,
+		path,
+		action: "skipped",
+		detail: "destination exists and is not a file or symlink"
+	};
+	const action = GEMINI_ACTION[state.kind];
+	if (check) return {
+		name: template.name,
+		source: template.path,
+		path,
+		action,
+		detail: checkDetail()
+	};
+	let detail;
+	if (GEMINI_BACKUP[state.kind]) detail = backupDestination(id, path, options);
+	writeTemplate(path, content);
+	return {
+		name: template.name,
+		source: template.path,
+		path,
+		action,
+		detail
+	};
+}
+function isInsideDirectory(path, directory) {
+	const remainder = relative(directory, path);
+	return remainder !== "" && !remainder.startsWith("..") && !isAbsolute(remainder);
+}
+function staleMarkdownSource(path, sourceDir) {
+	if (inspectDestination(path).kind !== "unmanaged-file") return null;
+	let stats;
+	try {
+		stats = lstatSync(path);
+	} catch {
+		return null;
+	}
+	if (!stats.isSymbolicLink()) return null;
+	const target = readlinkSync(path);
+	const resolved = isAbsolute(target) ? target : resolve(dirname(path), target);
+	return isInsideDirectory(resolved, sourceDir) ? resolved : null;
+}
+function staleGeminiSource(path, sourceDir) {
+	let content;
+	try {
+		content = readFileSync(path, "utf8");
+	} catch {
+		return null;
+	}
+	const source = generatedSource(content);
+	if (source === null) return null;
+	return isInsideDirectory(source, sourceDir) ? source : null;
+}
+function pruneTarget(targetDir, format, sourceDir, activeSources, check) {
+	let entries;
+	try {
+		entries = readdirSync(targetDir, { withFileTypes: true });
+	} catch (error) {
+		if (error.code === "ENOENT") return [];
+		throw error;
+	}
+	const extension = format === "markdown" ? ".md" : ".toml";
+	const staleSource = format === "markdown" ? staleMarkdownSource : staleGeminiSource;
+	return entries.filter((entry) => entry.name.toLowerCase().endsWith(extension)).flatMap((entry) => {
+		const path = join(targetDir, entry.name);
+		const source = staleSource(path, sourceDir);
+		if (source === null || activeSources.has(source)) return [];
+		if (!check) unlinkSync(path);
+		return [{
+			name: basename(entry.name, extension),
+			source,
+			path,
+			action: "removed",
+			...check ? { detail: checkDetail() } : {}
+		}];
+	});
+}
+function syncTarget(harness, templates, sourceDir, check, options) {
+	const target = harness.promptTemplateSyncTarget;
+	if (target === null) return {
+		id: harness.id,
+		detail: "no stable user-scope prompt template destination",
+		templates: []
+	};
+	const resolved = harness.resolveCandidates([target], options)[0];
+	if (resolved === void 0) return {
+		id: harness.id,
+		detail: "prompt template destination is unavailable on this platform",
+		templates: []
+	};
+	const targetDir = resolved.path;
+	const syncTemplate = resolved.format === "markdown" ? syncMarkdownTemplate : syncGeminiTemplate;
+	const results = templates.map((template) => syncTemplate(harness.id, targetDir, template, check, options));
+	const activeSources = new Set(templates.map((template) => template.path));
+	results.push(...pruneTarget(targetDir, resolved.format, sourceDir, activeSources, check));
+	return {
+		id: harness.id,
+		path: targetDir,
+		format: resolved.format,
+		templates: results
+	};
+}
+function syncPromptTemplates(harnesses, check = false, options = {}) {
+	const source = join(agntnDataDir(options), "prompts");
+	const templates = readTemplates(source, check);
+	const prepared = harnesses.some((harness) => harness.promptTemplateSyncTarget?.format === "gemini-toml") ? templates.map((template) => ({
+		...template,
+		gemini: geminiContent(template)
+	})) : templates;
+	return {
+		source,
+		check,
+		templates: prepared.map((template) => template.name),
+		targets: harnesses.map((harness) => syncTarget(harness, prepared, source, check, options))
 	};
 }
-export { Harness, McpEnvError, addMcpServer, detectHarness, detectHarnessFromEnv, detectProjectHarnesses, getAllHarnesses, getHarness, isHarnessId, listHarnesses, listMcpServers, masterMcpPath, parseJsonc, readAgentsConfig, readMasterMcpServers, registerHarness, removeMcpServer, resolvePathTemplate, syncAgentsFiles, syncMcpServers };
+export { Harness, McpEnvError, addMcpServer, agntnConfigDir, agntnDataDir, detectHarness, detectHarnessFromEnv, detectProjectHarnesses, getAllHarnesses, getHarness, isHarnessId, listHarnesses, listMcpServers, masterMcpPath, parseJsonc, readAgentsConfig, readMasterMcpServers, registerHarness, removeMcpServer, resolvePathTemplate, syncAgentsFiles, syncMcpServers, syncPromptTemplates };
 
-//# sourceMappingURL=agents-sync.mjs.map
+//# sourceMappingURL=prompt-sync.mjs.map