buddy-agent-harness 0.14.0 → 0.16.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
 	"name": "buddy-agent-harness",
-	"version": "0.14.0",
+	"version": "0.16.0",
 	"description": "Initialize standards-based agent configuration across agent harnesses",
 	"author": {
 		"name": "repobuddy"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
 	"name": "buddy-agent-harness",
-	"version": "0.14.0",
+	"version": "0.16.0",
 	"description": "Initialize standards-based agent configuration across agent harnesses",
 	"author": {
 		"name": "repobuddy"

package/.cursor-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
 	"name": "buddy-agent-harness",
-	"version": "0.14.0",
+	"version": "0.16.0",
 	"description": "Initialize standards-based agent configuration across agent harnesses",
 	"author": {
 		"name": "repobuddy"

package/dist/cli.mjs

@@ -26942,6 +26942,11 @@ function stripMergeComments(body) {
 	const inFence = fenceTracker();
 	return body.split("\n").filter((line) => inFence(line) || !mergeCommentPattern.test(line)).join("\n");
 }
+/** Each heading with a single `#` outside a code fence, as written. */
+function titleHeadings(body) {
+	const inFence = fenceTracker();
+	return body.split("\n").filter((line) => !inFence(line) && headingPattern.exec(line)?.[1] === "#");
+}
 function sectionKey(title) {
 	return title.trim().replace(/\s+/g, " ").toLowerCase();
 }
@@ -27118,6 +27123,7 @@ function pluginLabel(layer) {
 function layerName(layer) {
 	return layer.tier === "plugin" ? `plugin ${pluginLabel(layer)}` : layer.tier;
 }
+/** The layers a name is resolved through, in the order `resolveReference` traces them. */
 function layersFor$2(ref, layers) {
 	const plugin = ref.plugin;
 	if (plugin === void 0) return [...layers];
@@ -27366,6 +27372,7 @@ function searchReferences(query, layers, options = {}) {
 }
 //#endregion
 //#region src/governance-overrides/governance-overrides.ts
+/** @deprecated Use `managedReferencesDir`. Removed in the next major version. */
 function managedGovernancesDir(platform, programData) {
 	if (platform === "darwin") return "/Library/Application Support/BuddyAgentHarness/governances";
 	if (platform === "win32") return join(programData || "C:\\ProgramData", "BuddyAgentHarness", "governances");
@@ -27374,6 +27381,8 @@ function managedGovernancesDir(platform, programData) {
 /**
 * Still read below the layer above, so a machine already using it keeps working; reported as
 * deprecated so an admin knows to move it.
+*
+* @deprecated Use `managedReferencesDir`. Removed in the next major version.
 */
 function deprecatedManagedGovernancesDir(platform, programData) {
 	if (platform === "darwin") return "/Library/Application Support/UniPlugin/governances";
@@ -27399,6 +27408,7 @@ function packageGovernancesDir(from = fileURLToPath(import.meta.url)) {
 		dir = parent;
 	}
 }
+/** @deprecated Use `referenceLayers`. Removed in the next major version. */
 function governanceLayers({ root, home, platform, programData }) {
 	return [
 		{
@@ -27426,6 +27436,8 @@ function governanceLayers({ root, home, platform, programData }) {
 /**
 * Filters by scope rather than slicing the list, so a layer added later can't quietly become an
 * override by position.
+*
+* @deprecated Use `referenceLayers`. Removed in the next major version.
 */
 function overrideLayers(layers) {
 	return layers.filter((layer) => layer.scope !== "package");
@@ -27434,6 +27446,8 @@ const namePattern = /^[a-z0-9]+(?:[-.][a-z0-9]+)*$/i;
 /**
 * Rejects rather than sanitizes — silently answering a different question is how untrusted input
 * reads a file outside the layer.
+*
+* @deprecated Use `parseReferenceName`. Removed in the next major version.
 */
 function parseGovernanceName(value) {
 	if (value.endsWith(".md")) throw new Error(`"${value}" names a file. Ask for the governance by name, without the .md extension.`);
@@ -27455,7 +27469,11 @@ function documentNames(dir) {
 		return [];
 	}
 }
-/** The first layer that holds the name wins; the rest are not read. */
+/**
+* The first layer that holds the name wins; the rest are not read.
+*
+* @deprecated Use `resolveReference`. Removed in the next major version.
+*/
 function resolveGovernance(name, layers) {
 	for (const { scope, dir } of layers) {
 		const path = join(dir, `${name}.md`);
@@ -27468,7 +27486,11 @@ function resolveGovernance(name, layers) {
 		};
 	}
 }
-/** Every name any layer holds, each reported at the layer that would win, sorted by name. */
+/**
+* Every name any layer holds, each reported at the layer that would win, sorted by name.
+*
+* @deprecated Use `listReferences`. Removed in the next major version.
+*/
 function listGovernances(layers) {
 	const found = /* @__PURE__ */ new Map();
 	for (const { scope, dir } of layers) for (const name of documentNames(dir)) if (!found.has(name)) found.set(name, {
@@ -28354,6 +28376,7 @@ const overridesOnlyOption = {
 	description: "Resolve only the project, user, and machine-wide layers. Never returns a governance this package ships, and exits non-zero when no layer has one.",
 	type: optionalType(booleanType())
 };
+/** @deprecated Use `referenceCommand`. Removed in the next major version. */
 const governanceCommand = command({
 	name: "governance",
 	description: "Deprecated: use `reference`. Read the governance documents the project, user, and machine-wide override layers hold. Read-only.",
@@ -28437,6 +28460,54 @@ const governanceCommand = command({
 	})]
 });
 //#endregion
+//#region src/references/create-reference.ts
+/** No `#` title: `merge-sections` matches by heading path, so a title would hold every section under it. */
+const defaultTemplate = `---
+description: What this reference covers, and when an agent should read it.
+tags: [topic]
+---
+
+## Overview
+
+Write the guidance here. Give each topic its own top-level \`##\` section.
+`;
+function readTemplate(path) {
+	if (path === void 0) return parseTemplate(defaultTemplate, "the default template");
+	let content;
+	try {
+		content = readFileSync(path, "utf8");
+	} catch (error) {
+		throw new Error(`cannot read the template ${path}: ${error.message}`);
+	}
+	return parseTemplate(content, `the template ${path}`);
+}
+function parseTemplate(content, label) {
+	let mapping = true;
+	const { metadata, body } = parseDocument(content, () => {
+		mapping = false;
+	});
+	if (!mapping) throw new Error(`${label} has frontmatter that is not a YAML mapping.`);
+	return {
+		content,
+		metadata,
+		body
+	};
+}
+/** Adds one line and changes nothing else, so the result still reads as the template it came from. */
+function withMergeSections(content) {
+	const match = frontmatterPattern.exec(content);
+	if (!match) return `---\nmerge: merge-sections\n---\n\n${content}`;
+	const open = match[0].indexOf("\n") + 1;
+	const newline = match[0][open - 2] === "\r" ? "\r\n" : "\n";
+	const end = open + match[1].length;
+	return `${content.slice(0, end)}${newline}merge: merge-sections${content.slice(end)}`;
+}
+function templateWarnings({ metadata, body }) {
+	const warnings = titleHeadings(body).map((heading) => `"${heading.trim()}" is a heading with one hash; merge-sections matches by heading path, so an override would replace or duplicate the whole document. Use top-level ## sections.`);
+	if (typeof metadata["description"] !== "string" || !metadata["description"].trim()) warnings.push("the reference has no `description` in its frontmatter; `list` and `search` show it blank.");
+	return warnings;
+}
+//#endregion
 //#region src/references/reference.command.ts
 const rootOption = {
 	description: "Directory the project tier is read from, and each folder above it up to the repository root. Defaults to the current directory.",
@@ -28455,6 +28526,12 @@ function fail(error, fallback) {
 	process.stderr.write(`error: ${error instanceof Error ? error.message : fallback}\n`);
 	return exitCodes.error;
 }
+function traceOf(resolved, home) {
+	return resolved.trace.map(({ description: _, ...step }) => ({
+		...step,
+		path: collapseHome(home, step.path)
+	}));
+}
 function showEntry(resolved, home, suggestions, trace) {
 	const entry = {
 		name: resolved.name,
@@ -28476,10 +28553,7 @@ function showEntry(resolved, home, suggestions, trace) {
 	if (resolved.status === "missing") entry.suggestions = suggestions;
 	if (resolved.status === "ambiguous") entry.plugins = resolved.plugins;
 	entry.warnings = resolved.warnings;
-	if (trace) entry.trace = resolved.trace.map(({ description: _, ...step }) => ({
-		...step,
-		path: collapseHome(home, step.path)
-	}));
+	if (trace) entry.trace = traceOf(resolved, home);
 	return entry;
 }
 function missReason(entry) {
@@ -28551,70 +28625,238 @@ const listFormatOption = {
 	type: optionalType(stringType()),
 	default: "toon"
 };
+const referenceListCommand = command({
+	name: "list",
+	description: "List every layer, and every reference at every layer that holds it, marked used or shadowed.",
+	options: {
+		root: rootOption,
+		format: listFormatOption
+	},
+	async run(args) {
+		try {
+			const format = parseFormat(args.format);
+			const home = homedir();
+			const layers = await layersFor(args, home);
+			const { rows, warnings } = listReferences(layers, { display: (path) => collapseHome(home, path) });
+			const report = {
+				layers: layers.map(({ tier, plugins, dir, status }) => ({
+					tier,
+					plugin: plugins[0] ?? "",
+					path: collapseHome(home, dir),
+					status
+				})),
+				references: rows.length ? rows.map((row) => ({
+					...row,
+					path: collapseHome(home, row.path)
+				})) : "0 references — no layer holds one"
+			};
+			if (warnings.length) report.warnings = warnings;
+			writeResult(report, format);
+			return exitCodes.success;
+		} catch (error) {
+			return fail(error, "Reference listing failed.");
+		}
+	}
+});
+const referenceSearchCommand = command({
+	name: "search",
+	description: "Find references by name, description, tags, headings, or body, best match first.",
+	arguments: [{
+		name: "query",
+		description: "What the reference is about.",
+		type: stringType()
+	}],
+	options: {
+		root: rootOption,
+		format: listFormatOption
+	},
+	async run(args) {
+		try {
+			const format = parseFormat(args.format);
+			const query = args.query.trim();
+			if (!query) throw new Error("Search needs a query.");
+			const home = homedir();
+			const matches = searchReferences(query, await layersFor(args, home), { display: (path) => collapseHome(home, path) });
+			writeResult({
+				query,
+				references: matches.length ? matches : `0 references match "${query}"`
+			}, format);
+			return exitCodes.success;
+		} catch (error) {
+			return fail(error, "Reference search failed.");
+		}
+	}
+});
+/** Managed is left out: writing there needs an admin, and most of it cannot be read locally. */
+const slotScopes = {
+	project: "everyone working in this repository",
+	user: "only you, in every repository",
+	plugin: "read-only; override it with the project or user file"
+};
+const callerScope = "read-only; the calling skill's own copy, read only when no layer holds the name";
+const mergeNote = "The default, first-wins, makes the override replace the whole document. Set `merge: merge-sections` in its frontmatter to keep the sections it does not redefine.";
+function slotStatus(outcome) {
+	if (outcome === "missing") return "empty";
+	return outcome.startsWith("shadowed") ? "shadowed" : outcome;
+}
+/** Where Load reads the caller's copy when no layer holds the name, in the order it tries them. */
+function callerCopy(caller, name) {
+	return [join(caller, "references", `${name}.md`), join(caller, "references", "governances", `${name}.md`)].find((path) => existsSync(path));
+}
+function callerStatus(resolved) {
+	if (resolved.status === "missing") return "used";
+	return resolved.status === "ambiguous" ? "not read — the name is ambiguous" : "shadowed";
+}
+const referenceWhereCommand = command({
+	name: "where",
+	description: "List the project and user files an override of a reference can be written to, highest precedence first, with the copy each overrides and who it applies to.",
+	arguments: [{
+		name: "name",
+		description: "Reference name, without the `.md` extension; `<plugin>/<name>` picks one plugin.",
+		type: stringType()
+	}],
+	options: {
+		root: rootOption,
+		caller: {
+			description: "Folder of the skill that loads the reference, so its own copy is reported as the reference skill's Load mode reads it.",
+			type: optionalType(stringType())
+		},
+		format: listFormatOption
+	},
+	async run(args) {
+		try {
+			const format = parseFormat(args.format);
+			const name = parseReferenceName(args.name);
+			const home = homedir();
+			const layers = await layersFor(args, home);
+			const root = resolve(args.root ?? process.cwd());
+			const display = (path) => collapseHome(home, path);
+			const resolved = resolveReference(name, layers, { display });
+			const traced = layersFor$2(name, layers);
+			const slots = [];
+			for (const [index, step] of resolved.trace.entries()) {
+				const layer = traced[index];
+				const scope = slotScopes[step.tier];
+				if (!scope || (layer.status || step.tier === "plugin") && !step.found) continue;
+				const path = step.found ? step.path : join(layer.dir, `${name.name}.md`);
+				slots.push({
+					layer: step.tier === "plugin" ? `plugin ${step.plugin}` : step.tier,
+					path: step.tier === "project" ? relative(root, path) : display(path),
+					status: slotStatus(step.outcome),
+					scope
+				});
+			}
+			const copy = args.caller === void 0 ? void 0 : callerCopy(resolve(args.caller), name.name);
+			if (copy) slots.push({
+				layer: "caller",
+				path: display(copy),
+				status: callerStatus(resolved),
+				scope: callerScope
+			});
+			const report = {
+				name: name.name,
+				root: display(root),
+				slots,
+				merge: mergeNote
+			};
+			if (resolved.status === "ambiguous") report.plugins = resolved.plugins;
+			if (resolved.warnings.length) report.warnings = resolved.warnings;
+			writeResult(report, format);
+			if (resolved.status !== "ambiguous") return exitCodes.success;
+			process.stderr.write(`error: ${missReason({
+				name: name.raw,
+				status: "ambiguous",
+				plugins: resolved.plugins,
+				warnings: []
+			})}\n`);
+			return exitCodes.error;
+		} catch (error) {
+			return fail(error, "Reference placement lookup failed.");
+		}
+	}
+});
+function parseScope(value) {
+	if (value !== "project" && value !== "user") throw new Error("--scope must be project or user.");
+	return value;
+}
 const referenceCommand = command({
 	name: "reference",
-	description: "Read on-demand reference documents by name, layered across the managed, project, user, and plugin tiers. Read-only.",
+	description: "Read on-demand reference documents by name, layered across the managed, project, user, and plugin tiers, and start a new one in the project or user tier.",
 	commands: [
 		referenceShowCommand,
+		referenceListCommand,
+		referenceSearchCommand,
+		referenceWhereCommand,
 		command({
-			name: "list",
-			description: "List every layer, and every reference at every layer that holds it, marked used or shadowed.",
-			options: {
-				root: rootOption,
-				format: listFormatOption
-			},
-			async run(args) {
-				try {
-					const format = parseFormat(args.format);
-					const home = homedir();
-					const layers = await layersFor(args, home);
-					const { rows, warnings } = listReferences(layers, { display: (path) => collapseHome(home, path) });
-					const report = {
-						layers: layers.map(({ tier, plugins, dir, status }) => ({
-							tier,
-							plugin: plugins[0] ?? "",
-							path: collapseHome(home, dir),
-							status
-						})),
-						references: rows.length ? rows.map((row) => ({
-							...row,
-							path: collapseHome(home, row.path)
-						})) : "0 references — no layer holds one"
-					};
-					if (warnings.length) report.warnings = warnings;
-					writeResult(report, format);
-					return exitCodes.success;
-				} catch (error) {
-					return fail(error, "Reference listing failed.");
-				}
-			}
-		}),
-		command({
-			name: "search",
-			description: "Find references by name, description, tags, headings, or body, best match first.",
+			name: "create",
+			description: "Start a new reference in the project or user tier from a template, marked merge-sections when it overrides a copy below. Never overwrites.",
 			arguments: [{
-				name: "query",
-				description: "What the reference is about.",
+				name: "name",
+				description: "Reference name, without the `.md` extension.",
 				type: stringType()
 			}],
 			options: {
 				root: rootOption,
-				format: listFormatOption
+				template: {
+					description: "File whose text is written as it is, frontmatter included. Defaults to a built-in template of top-level `##` sections with no `#` title.",
+					type: optionalType(stringType())
+				},
+				scope: {
+					description: "Tier to write: project (default), `.agents/references/` at the root, or user, `~/.agents/references/`.",
+					type: optionalType(stringType()),
+					default: "project"
+				},
+				"dry-run": {
+					description: "Print the target path and the exact content, and write nothing.",
+					type: optionalType(booleanType())
+				},
+				format: {
+					description: "Output format: text (default) writes the path, then the content or the trace; toon and json return an object.",
+					type: optionalType(stringType()),
+					default: "text"
+				}
 			},
 			async run(args) {
 				try {
 					const format = parseFormat(args.format);
-					const query = args.query.trim();
-					if (!query) throw new Error("Search needs a query.");
+					const name = parseReferenceName(args.name);
+					if (name.plugin !== void 0) throw new Error(`an override is written under the bare name, which every tier resolves; ask for "${name.name}".`);
+					const scope = parseScope(args.scope);
+					const template = readTemplate(args.template === void 0 ? void 0 : resolve(args.template));
 					const home = homedir();
-					const matches = searchReferences(query, await layersFor(args, home), { display: (path) => collapseHome(home, path) });
-					writeResult({
-						query,
-						references: matches.length ? matches : `0 references match "${query}"`
-					}, format);
+					const dir = scope === "project" ? projectReferencesDir(resolve(args.root ?? process.cwd())) : join(home, ".agents", "references");
+					const target = join(dir, `${name.name}.md`);
+					const display = (path) => collapseHome(home, path);
+					const layers = await layersFor(args, home);
+					const { trace } = resolveReference(name, layers, { display });
+					const at = layers.findIndex((layer) => layer.dir === dir);
+					if (trace[at]?.found) throw new Error(`${display(trace[at].path)} already holds "${name.name}"; change it with the reference skill's Update mode.`);
+					const shadow = trace.slice(0, at).find((step) => step.found && step.merge === "first-wins");
+					if (shadow) throw new Error(`the ${shadow.tier} copy ${display(shadow.path)} is first-wins, so nothing would read a new ${scope} file; change that copy instead.`);
+					const content = trace.slice(at + 1).some((step) => step.found) && template.metadata["merge"] === void 0 ? withMergeSections(template.content) : template.content;
+					const warnings = templateWarnings(template);
+					const report = {
+						name: name.name,
+						scope,
+						path: display(target),
+						dryRun: Boolean(args["dry-run"]),
+						content,
+						warnings
+					};
+					if (!report.dryRun) {
+						mkdirSync(dir, { recursive: true });
+						writeFileSync(target, content, { flag: "wx" });
+						report.trace = traceOf(resolveReference(name, layers, { display }), home);
+					}
+					if (format !== "text") writeResult(report, format);
+					else {
+						for (const warning of warnings) process.stderr.write(`warning: ${warning}\n`);
+						if (report.trace) process.stdout.write(`${report.path}\n\n${renderText({ trace: report.trace })}\n`);
+						else writeDocument(`${report.path}\n\n${content}`);
+					}
 					return exitCodes.success;
 				} catch (error) {
-					return fail(error, "Reference search failed.");
+					return fail(error, "Reference creation failed.");
 				}
 			}
 		})
@@ -31605,12 +31847,26 @@ const mcpCommand = command({
 //#endregion
 //#region src/cli.ts
 const version = typeof __PACKAGE_VERSION__ !== "undefined" ? __PACKAGE_VERSION__ : JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
+/** Exported for `scripts/generate-llms-txt.ts`, which lists the CLI from it; `app()` must stay built from it. */
+const rootCommand = {
+	name: "buddy-agent-harness",
+	description: "Initialize agent harness skill compatibility in consumer repositories.",
+	commands: [
+		initCommand,
+		doctorCommand,
+		mcpCommand,
+		depPluginsCommand,
+		referenceCommand,
+		governanceCommand
+	]
+};
 function app() {
-	return cli({
-		name: "buddy-agent-harness",
+	const [first, ...rest] = rootCommand.commands;
+	return rest.reduce((builder, command) => builder.command(command), cli({
+		name: rootCommand.name,
 		version,
-		description: "Initialize agent harness skill compatibility in consumer repositories."
-	}).command(initCommand).command(doctorCommand).command(mcpCommand).command(depPluginsCommand).command(referenceCommand).command(governanceCommand);
+		description: rootCommand.description
+	}).command(first));
 }
 /**
 * The application boundary: argv in, exit code out — returned rather than written, so a caller that
@@ -31626,4 +31882,4 @@ async function run(argv) {
 	}
 }
 //#endregion
-export { run };
+export { rootCommand, run };

package/dist/index.d.mts

@@ -487,22 +487,34 @@ export declare const goldenSetPath = ".agents/buddy-agent-harness/mcp.toml";
 /**
  * Order here is search order. `package` is the only member that isn't an override —
  * `--overrides-only` promises never to return it.
+ *
+ * @deprecated Use `ReferenceTier`. Removed in the next major version.
  */
 type GovernanceScope = "project" | "user" | "managed" | "managed-deprecated" | "package";
+/** @deprecated Use `ReferenceLayer`. Removed in the next major version. */
 type GovernanceLayer = {
   scope: GovernanceScope;
   dir: string;
 };
-/** A governance located but not read: what `list` reports. */
+/**
+ * A governance located but not read: what `list` reports.
+ *
+ * @deprecated Use `ReferenceRow`. Removed in the next major version.
+ */
 type GovernanceEntry = {
   name: string;
   scope: GovernanceScope;
   path: string;
 };
-/** A governance located and read: what `show` reports. */
+/**
+ * A governance located and read: what `show` reports.
+ *
+ * @deprecated Use `ResolvedReference`. Removed in the next major version.
+ */
 type GovernanceDocument = GovernanceEntry & {
   content: string;
 };
+/** @deprecated Use `ReferenceLayerOptions`. Removed in the next major version. */
 type LayerOptions = {
   root: string;
   home: string;
@@ -510,29 +522,46 @@ type LayerOptions = {
   /** `%ProgramData%`, read only on Windows. */
   programData?: string | undefined;
 };
+/** @deprecated Use `managedReferencesDir`. Removed in the next major version. */
 export declare function managedGovernancesDir(platform: NodeJS.Platform, programData?: string | undefined): string;
 /**
  * Still read below the layer above, so a machine already using it keeps working; reported as
  * deprecated so an admin knows to move it.
+ *
+ * @deprecated Use `managedReferencesDir`. Removed in the next major version.
  */
 export declare function deprecatedManagedGovernancesDir(platform: NodeJS.Platform, programData?: string | undefined): string;
+/** @deprecated Use `referenceLayers`. Removed in the next major version. */
 export declare function governanceLayers({ root, home, platform, programData }: LayerOptions): GovernanceLayer[];
 /**
  * Filters by scope rather than slicing the list, so a layer added later can't quietly become an
  * override by position.
+ *
+ * @deprecated Use `referenceLayers`. Removed in the next major version.
  */
 export declare function overrideLayers(layers: readonly GovernanceLayer[]): GovernanceLayer[];
 /**
  * Rejects rather than sanitizes — silently answering a different question is how untrusted input
  * reads a file outside the layer.
+ *
+ * @deprecated Use `parseReferenceName`. Removed in the next major version.
  */
 export declare function parseGovernanceName(value: string): string;
-/** The first layer that holds the name wins; the rest are not read. */
+/**
+ * The first layer that holds the name wins; the rest are not read.
+ *
+ * @deprecated Use `resolveReference`. Removed in the next major version.
+ */
 export declare function resolveGovernance(name: string, layers: readonly GovernanceLayer[]): GovernanceDocument | undefined;
-/** Every name any layer holds, each reported at the layer that would win, sorted by name. */
+/**
+ * Every name any layer holds, each reported at the layer that would win, sorted by name.
+ *
+ * @deprecated Use `listReferences`. Removed in the next major version.
+ */
 export declare function listGovernances(layers: readonly GovernanceLayer[]): GovernanceEntry[];
 //#endregion
 //#region src/governance-overrides/governance.command.d.ts
+/** @deprecated Use `ReferenceListReport`. Removed in the next major version. */
 type GovernanceListReport = {
   /**
    * `status` is always a string, not optional — an optional key would drop this array out of
@@ -550,12 +579,14 @@ type GovernanceListReport = {
     path: string;
   }[] | string;
 };
+/** @deprecated Use `ReferenceShowEntry`. Removed in the next major version. */
 type GovernanceShowReport = {
   name: string;
   scope: GovernanceScope;
   path: string;
   content: string;
 };
+/** @deprecated Use `referenceCommand`. Removed in the next major version. */
 export declare const governanceCommand: cli$1.Command;
 //#endregion
 //#region src/initialize-harnesses/init.command.d.ts

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/cli.ts","../src/harness-registry/instruction-bridge.ts","../src/diagnose-mcp/mcp-model.ts","../src/mcp-dialects/mcp-dialects.ts","../src/harness-registry/mcp-config.ts","../src/harness-registry/nonstandard-artifact.ts","../src/harness-registry/harness-registry.ts","../src/diagnose-bridges/diagnose-instructions.ts","../src/diagnose-bridges/locator.ts","../src/diagnose-bridges/doctor-guidance.ts","../src/diagnose-bridges/git-bridge-state.ts","../src/diagnose-bridges/diagnose-bridges.ts","../src/diagnose-configuration/diagnose-configuration.ts","../src/references/reference-layers.ts","../src/references/reference-document.ts","../src/references/resolve-reference.ts","../src/references/reference-catalog.ts","../src/diagnose-bridges/doctor.command.ts","../src/diagnose-mcp/diagnose-mcp.ts","../src/diagnose-mcp/mcp-baseline.ts","../src/diagnose-mcp/mcp-sources.ts","../src/governance-overrides/governance-overrides.ts","../src/governance-overrides/governance.command.ts","../src/initialize-harnesses/init.command.ts","../src/skill-projection/skill-projection.ts","../src/initialize-harnesses/initialize-harnesses.ts","../src/mcp-inventory/mcp-inventory.ts","../src/references/reference.command.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/cli.ts","../src/harness-registry/instruction-bridge.ts","../src/diagnose-mcp/mcp-model.ts","../src/mcp-dialects/mcp-dialects.ts","../src/harness-registry/mcp-config.ts","../src/harness-registry/nonstandard-artifact.ts","../src/harness-registry/harness-registry.ts","../src/diagnose-bridges/diagnose-instructions.ts","../src/diagnose-bridges/locator.ts","../src/diagnose-bridges/doctor-guidance.ts","../src/diagnose-bridges/git-bridge-state.ts","../src/diagnose-bridges/diagnose-bridges.ts","../src/diagnose-configuration/diagnose-configuration.ts","../src/references/reference-layers.ts","../src/references/reference-document.ts","../src/references/resolve-reference.ts","../src/references/reference-catalog.ts","../src/diagnose-bridges/doctor.command.ts","../src/diagnose-mcp/diagnose-mcp.ts","../src/diagnose-mcp/mcp-baseline.ts","../src/diagnose-mcp/mcp-sources.ts","../src/governance-overrides/governance-overrides.ts","../src/governance-overrides/governance.command.ts","../src/initialize-harnesses/init.command.ts","../src/skill-projection/skill-projection.ts","../src/initialize-harnesses/initialize-harnesses.ts","../src/mcp-inventory/mcp-inventory.ts","../src/references/reference.command.ts"],"mappings":"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"}