buddy-agent-harness 0.20.0 → 0.22.0

package/dist/index.mjs

@@ -1,614 +1,33 @@
-import { declaredDependencies, deprecatedManagedGovernancesDir as deprecatedManagedGovernancesDir$1, listReferences, listReferences as listReferences$1, managedGovernancesDir as managedGovernancesDir$1, managedReferencesDir, packageDir, parseReferenceName, projectReferenceLayers, projectReferencesDir, referenceLayers as referenceLayers$1, referenceNames, resolveReference, searchReferences, skillsDirectories } from "@cyberuni/agent-harness";
+import { declaredDependencies, listReferences, listReferences as listReferences$1, packageDir, parseReferenceName, projectReferencesDir, referenceLayers as referenceLayers$1, referenceNames, resolveReference, searchReferences, skillsDirectories } from "cyber-agentkit";
 import { cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, readlinkSync, realpathSync, rmSync, statSync, symlinkSync, writeFileSync } from "node:fs";
-import { cli, command, exitCodes, z } from "clibuilder";
+import { cli, command, t } from "clibuilder";
+import { CliError, document, exitCodes, isCliError, printAnswer, result } from "clibuilder/axi";
 import { homedir, platform } from "node:os";
 import { basename, dirname, join, posix, relative, resolve, sep } from "node:path";
 import { parse, stringify } from "smol-toml";
-import { createReferenceCommand } from "@cyberuni/agent-harness/commands";
+import { createReferenceCommand } from "cyber-agentkit/commands";
 import { fileURLToPath } from "node:url";
 import { execFileSync } from "node:child_process";
 import { parseTOML } from "toml-eslint-parser";
 import { findNodeAtLocation, parseTree } from "jsonc-parser";
-//#region ../../node_modules/.pnpm/@toon-format+toon@4.1.1/node_modules/@toon-format/toon/dist/index.mjs
-const NULL_LITERAL = "null";
-const DELIMITERS = {
-	comma: ",",
-	tab: "	",
-	pipe: "|"
-};
-const DEFAULT_DELIMITER = DELIMITERS.comma;
-/**
-* Escapes special characters in a string for encoding.
-*
-* @remarks
-* Control characters outside `\n`, `\r`, `\t`, `\\`, and `"` are emitted as `\uXXXX`.
-*/
-function escapeString(value) {
-	return value.replace(/\\/g, `\\\\`).replace(/"/g, `\\"`).replace(/\n/g, `\\n`).replace(/\r/g, `\\r`).replace(/\t/g, `\\t`).replace(/[\u0000-\u001F]/g, (c) => `\\u${c.charCodeAt(0).toString(16).padStart(4, "0")}`);
-}
-function isBooleanOrNullLiteral(token) {
-	return token === "true" || token === "false" || token === "null";
-}
-/**
-* Assigns an own data property without invoking inherited accessors.
-*
-* @remarks
-* Plain assignment of `__proto__` would hit the `Object.prototype` setter and
-* corrupt the prototype chain; `defineProperty` avoids that but is markedly
-* slower, so every other key takes plain assignment.
-*/
-function setOwnProperty(target, key, value) {
-	if (key === "__proto__") {
-		Object.defineProperty(target, key, {
-			value,
-			enumerable: true,
-			writable: true,
-			configurable: true
-		});
-		return;
-	}
-	target[key] = value;
-}
-const COMMENT_LINE_PATTERN = new RegExp(`(?:^?|\\n) *#`);
-/**
-* Pre-formatted string that the encoder emits verbatim at a primitive value
-* position, bypassing quoting, escaping, and number/keyword detection.
-*
-* Returned from a replacer for an object or array value, it is ignored and
-* the container is encoded normally.
-*/
-var RawString = class {
-	constructor(value) {
-		if (COMMENT_LINE_PATTERN.test(value)) throw new TypeError(`Raw string must not contain a line starting with "#": ${JSON.stringify(value)}`);
-		this.value = value;
-	}
-};
-function isRawString(value) {
-	return value instanceof RawString;
-}
-const SURROGATE_PATTERN = /[\uD800-\uDFFF]/;
-function normalizeValue(value) {
-	if (value === null) return null;
-	if (isRawString(value)) return value;
-	if (typeof value === "object" && value !== null && "toJSON" in value && typeof value.toJSON === "function") {
-		const next = value.toJSON();
-		if (next !== value) return normalizeValue(next);
-	}
-	if (typeof value === "string") {
-		assertNoLoneSurrogate(value, "string value");
-		return value;
-	}
-	if (typeof value === "boolean") return value;
-	if (typeof value === "number") {
-		if (Object.is(value, -0)) return 0;
-		if (!Number.isFinite(value)) return null;
-		return value;
-	}
-	if (typeof value === "bigint") {
-		if (value >= Number.MIN_SAFE_INTEGER && value <= Number.MAX_SAFE_INTEGER) return Number(value);
-		return value.toString();
-	}
-	if (value instanceof Date) return value.toISOString();
-	if (Array.isArray(value)) return value.map(normalizeValue);
-	if (value instanceof Set) return Array.from(value).map(normalizeValue);
-	if (value instanceof Map) return Object.fromEntries(Array.from(value, ([k, v]) => [String(k), normalizeValue(v)]));
-	if (isPlainObject(value)) {
-		const encodedValues = {};
-		for (const key in value) if (Object.hasOwn(value, key)) {
-			assertNoLoneSurrogate(key, "object key");
-			setOwnProperty(encodedValues, key, normalizeValue(value[key]));
-		}
-		return encodedValues;
-	}
-	return null;
-}
-function assertNoLoneSurrogate(value, context) {
-	if (!SURROGATE_PATTERN.test(value)) return;
-	for (let index = 0; index < value.length; index++) {
-		const code = value.charCodeAt(index);
-		if (code < 55296 || code > 57343) continue;
-		const isHighSurrogate = code <= 56319;
-		const next = value.charCodeAt(index + 1);
-		if (isHighSurrogate && next >= 56320 && next <= 57343) {
-			index++;
-			continue;
-		}
-		throw new TypeError(`Cannot encode ${context} containing an unpaired surrogate U+${code.toString(16).toUpperCase()} at index ${index}`);
-	}
-}
-function isJsonPrimitive(value) {
-	return value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean";
-}
-function isEncodablePrimitive(value) {
-	return isJsonPrimitive(value) || isRawString(value);
-}
-function isJsonArray(value) {
-	return Array.isArray(value);
-}
-function isJsonObject(value) {
-	return value !== null && typeof value === "object" && !Array.isArray(value) && !isRawString(value);
-}
-function isEmptyObject(value) {
-	return Object.keys(value).length === 0;
-}
-function isPlainObject(value) {
-	if (value === null || typeof value !== "object") return false;
-	const prototype = Object.getPrototypeOf(value);
-	return prototype === null || prototype === Object.prototype;
-}
-function isArrayOfPrimitives(value) {
-	return value.length === 0 || value.every((item) => isEncodablePrimitive(item));
-}
-function isArrayOfArrays(value) {
-	return value.length === 0 || value.every((item) => isJsonArray(item));
-}
-function isArrayOfObjects(value) {
-	return value.length === 0 || value.every((item) => isJsonObject(item));
-}
-const NUMERIC_LIKE_PATTERN = /^[+-]?\d+(?:\.\d+)?(?:e[+-]?\d+)?$/i;
-/** Narrows an arbitrary delimiter option, shared by the library and the CLI so both report it alike. */
-function assertValidDelimiter(delimiter) {
-	if (!Object.values(DELIMITERS).includes(delimiter)) throw new TypeError(`Invalid delimiter ${JSON.stringify(delimiter)}. Valid delimiters are: comma (,), tab (\\t), pipe (|)`);
-}
-/**
-* Checks if a key can be used without quotes.
-*
-* @remarks
-* Valid unquoted keys must start with a letter or underscore,
-* followed by letters, digits, underscores, or dots.
-*/
-function isValidUnquotedKey(key) {
-	return /^[A-Z_][\w.]*$/i.test(key);
-}
-/**
-* Determines if a string value can be safely encoded without quotes.
-*
-* @remarks
-* A string needs quoting if it:
-* - Is empty
-* - Has leading or trailing whitespace
-* - Could be confused with a literal (boolean, null, number)
-* - Contains structural characters (colons, brackets, braces)
-* - Contains quotes or backslashes (need escaping)
-* - Contains control characters (newlines, tabs, etc.)
-* - Contains the active delimiter
-* - Starts with a list marker (hyphen)
-* - Starts with a comment marker (#)
-*/
-function isSafeUnquoted(value, delimiter = DEFAULT_DELIMITER) {
-	if (!value) return false;
-	if (/^[ \t]|[ \t]$/.test(value)) return false;
-	if (isBooleanOrNullLiteral(value) || isNumericLike(value)) return false;
-	if (value.includes(":")) return false;
-	if (value.includes("\"") || value.includes("\\")) return false;
-	if (/[[\]{}]/.test(value)) return false;
-	if (/[\u0000-\u001F]/.test(value)) return false;
-	if (value.includes(delimiter)) return false;
-	if (value.startsWith("-")) return false;
-	if (value.startsWith("#")) return false;
-	return true;
-}
-function isNumericLike(value) {
-	return NUMERIC_LIKE_PATTERN.test(value);
-}
-function encodePrimitive(value, delimiter) {
-	if (isRawString(value)) return value.value;
-	if (value === null) return NULL_LITERAL;
-	if (typeof value === "boolean") return String(value);
-	if (typeof value === "number") return String(value);
-	return encodeStringLiteral(value, delimiter);
-}
-function encodeStringLiteral(value, delimiter = DEFAULT_DELIMITER) {
-	if (isSafeUnquoted(value, delimiter)) return value;
-	return `"${escapeString(value)}"`;
-}
-function encodeKey(key) {
-	if (isValidUnquotedKey(key)) return key;
-	return `"${escapeString(key)}"`;
-}
-function encodeAndJoinPrimitives(values, delimiter = DEFAULT_DELIMITER) {
-	return values.map((v) => encodePrimitive(v, delimiter)).join(delimiter);
-}
-function formatHeader(length, options) {
-	const key = options?.key;
-	const fields = options?.fields;
-	const delimiter = options?.delimiter ?? ",";
-	let header = "";
-	if (key != null) header += encodeKey(key);
-	header += `[${length}${options?.keyed ? ":" : ""}${delimiter !== DEFAULT_DELIMITER ? delimiter : ""}]`;
-	if (fields) header += `{${formatFieldSegment(fields, delimiter)}}`;
-	header += ":";
-	return header;
-}
-function formatFieldSegment(fields, delimiter) {
-	return fields.map((field) => encodeKey(field.name) + (field.children ? `{${formatFieldSegment(field.children, delimiter)}}` : "")).join(delimiter);
-}
-/** Classifies rows into a tabular field list, or undefined when they are not uniformly tabular. */
-function extractTabularFields(rows) {
-	if (rows.length === 0) return;
-	const firstKeys = Object.keys(rows[0]);
-	if (firstKeys.length === 0) return;
-	for (const row of rows) {
-		if (Object.keys(row).length !== firstKeys.length) return;
-		for (const key of firstKeys) if (!Object.hasOwn(row, key)) return;
-	}
-	const fieldNodes = [];
-	for (const key of firstKeys) {
-		const fieldNode = classifyColumn(key, rows.map((row) => row[key]));
-		if (!fieldNode) return;
-		fieldNodes.push(fieldNode);
-	}
-	return fieldNodes;
-}
-/** Classifies an object's values as a keyed tabular field list (>=2 uniform non-empty object entries), or undefined. */
-function extractKeyedTabularFields(value) {
-	const entryValues = Object.values(value);
-	if (entryValues.length < 2) return;
-	if (!entryValues.every((entryValue) => isJsonObject(entryValue) && !isEmptyObject(entryValue))) return;
-	return extractTabularFields(entryValues);
-}
-/** Reads one row's leaf cells in the field order `extractTabularFields` produced. */
-function collectRowLeaves(row, fields) {
-	const leaves = [];
-	collectLeafValues(row, fields, leaves);
-	return leaves;
-}
-function classifyColumn(name, values) {
-	if (values.every((value) => isEncodablePrimitive(value))) return { name };
-	if (!values.every((value) => isJsonObject(value) && !isEmptyObject(value))) return;
-	const children = extractTabularFields(values);
-	if (!children) return;
-	return {
-		name,
-		children
-	};
-}
-function collectLeafValues(row, fields, leaves) {
-	for (const field of fields) {
-		const value = row[field.name];
-		if (field.children) collectLeafValues(value, field.children, leaves);
-		else leaves.push(value);
-	}
-}
-function* encodeJsonValue(value, options, depth) {
-	if (isEncodablePrimitive(value)) {
-		const encodedPrimitive = encodePrimitive(value, options.delimiter);
-		if (encodedPrimitive !== "") yield encodedPrimitive;
-		return;
-	}
-	if (isJsonArray(value)) yield* encodeArrayLines(void 0, value, depth, options);
-	else if (isJsonObject(value)) {
-		const keyedFields = extractKeyedTabularFields(value);
-		if (keyedFields) {
-			yield* encodeKeyedObjectLines(void 0, value, keyedFields, depth, options);
-			return;
-		}
-		yield* encodeObjectLines(value, depth, options);
-	}
-}
-function* encodeObjectLines(value, depth, options) {
-	for (const [key, val] of Object.entries(value)) yield* encodeKeyValuePairLines(key, val, depth, options);
-}
-function* encodeKeyValuePairLines(key, value, depth, options) {
-	const encodedKey = encodeKey(key);
-	if (isEncodablePrimitive(value)) yield indentedLine(depth, `${encodedKey}: ${encodePrimitive(value, options.delimiter)}`, options.indentSize);
-	else if (isJsonArray(value)) yield* encodeArrayLines(key, value, depth, options);
-	else if (isJsonObject(value)) {
-		const keyedFields = extractKeyedTabularFields(value);
-		if (keyedFields) {
-			yield* encodeKeyedObjectLines(key, value, keyedFields, depth, options);
-			return;
-		}
-		yield indentedLine(depth, `${encodedKey}:`, options.indentSize);
-		if (!isEmptyObject(value)) yield* encodeObjectLines(value, depth + 1, options);
-	}
-}
-function* encodeKeyedObjectLines(key, value, fields, depth, options) {
-	const entries = Object.entries(value);
-	yield indentedLine(depth, formatHeader(entries.length, {
-		key,
-		fields,
-		delimiter: options.delimiter,
-		keyed: true
-	}), options.indentSize);
-	yield* encodeKeyedEntryRowsLines(entries, fields, depth + 1, options);
-}
-function* encodeKeyedEntryRowsLines(entries, fields, depth, options) {
-	for (const [entryKey, entryValue] of entries) {
-		const leaves = collectRowLeaves(entryValue, fields);
-		yield indentedLine(depth, `${encodeKey(entryKey)}: ${encodeAndJoinPrimitives(leaves, options.delimiter)}`, options.indentSize);
-	}
-}
-function* encodeArrayLines(key, value, depth, options) {
-	if (value.length === 0) {
-		yield indentedLine(depth, key != null ? `${encodeKey(key)}: []` : "[]", options.indentSize);
-		return;
-	}
-	if (isArrayOfPrimitives(value)) {
-		yield indentedLine(depth, encodeInlineArrayLine(value, options.delimiter, key), options.indentSize);
-		return;
-	}
-	if (isArrayOfArrays(value)) {
-		if (value.every((arr) => isArrayOfPrimitives(arr))) {
-			yield* encodeArrayOfArraysAsListItemsLines(key, value, depth, options);
-			return;
-		}
-	}
-	if (isArrayOfObjects(value)) {
-		const fields = extractTabularFields(value);
-		if (fields) yield* encodeArrayOfObjectsAsTabularLines(key, value, fields, depth, options);
-		else yield* encodeMixedArrayAsListItemsLines(key, value, depth, options);
-		return;
-	}
-	yield* encodeMixedArrayAsListItemsLines(key, value, depth, options);
-}
-function* encodeArrayOfArraysAsListItemsLines(prefix, values, depth, options) {
-	yield indentedLine(depth, formatHeader(values.length, {
-		key: prefix,
-		delimiter: options.delimiter
-	}), options.indentSize);
-	for (const arr of values) if (isArrayOfPrimitives(arr)) {
-		const arrayLine = encodeInlineArrayLine(arr, options.delimiter);
-		yield indentedListItem(depth + 1, arrayLine, options.indentSize);
-	}
-}
-function encodeInlineArrayLine(values, delimiter, prefix) {
-	const header = formatHeader(values.length, {
-		key: prefix,
-		delimiter
-	});
-	const joinedValue = encodeAndJoinPrimitives(values, delimiter);
-	if (values.length === 0) return header;
-	return `${header} ${joinedValue}`;
-}
-function* encodeArrayOfObjectsAsTabularLines(prefix, rows, fields, depth, options) {
-	yield indentedLine(depth, formatHeader(rows.length, {
-		key: prefix,
-		fields,
-		delimiter: options.delimiter
-	}), options.indentSize);
-	yield* writeTabularRowsLines(rows, fields, depth + 1, options);
-}
-function* writeTabularRowsLines(rows, fields, depth, options) {
-	for (const row of rows) yield indentedLine(depth, encodeAndJoinPrimitives(collectRowLeaves(row, fields), options.delimiter), options.indentSize);
-}
-function* encodeMixedArrayAsListItemsLines(prefix, items, depth, options) {
-	yield indentedLine(depth, formatHeader(items.length, {
-		key: prefix,
-		delimiter: options.delimiter
-	}), options.indentSize);
-	for (const item of items) yield* encodeListItemValueLines(item, depth + 1, options);
-}
-function* encodeObjectAsListItemLines(obj, depth, options) {
-	if (isEmptyObject(obj)) {
-		yield indentedLine(depth, "-", options.indentSize);
-		return;
-	}
-	const entries = Object.entries(obj);
-	const [firstKey, firstValue] = entries[0];
-	const restEntries = entries.slice(1);
-	if (isJsonArray(firstValue) && isArrayOfObjects(firstValue)) {
-		const fields = extractTabularFields(firstValue);
-		if (fields) {
-			yield indentedListItem(depth, formatHeader(firstValue.length, {
-				key: firstKey,
-				fields,
-				delimiter: options.delimiter
-			}), options.indentSize);
-			yield* writeTabularRowsLines(firstValue, fields, depth + 2, options);
-			if (restEntries.length > 0) yield* encodeObjectLines(Object.fromEntries(restEntries), depth + 1, options);
-			return;
-		}
-	}
-	if (isJsonObject(firstValue)) {
-		const keyedFields = extractKeyedTabularFields(firstValue);
-		if (keyedFields) {
-			const keyedEntries = Object.entries(firstValue);
-			yield indentedListItem(depth, formatHeader(keyedEntries.length, {
-				key: firstKey,
-				fields: keyedFields,
-				delimiter: options.delimiter,
-				keyed: true
-			}), options.indentSize);
-			yield* encodeKeyedEntryRowsLines(keyedEntries, keyedFields, depth + 2, options);
-			if (restEntries.length > 0) yield* encodeObjectLines(Object.fromEntries(restEntries), depth + 1, options);
-			return;
-		}
-	}
-	const encodedKey = encodeKey(firstKey);
-	if (isEncodablePrimitive(firstValue)) yield indentedListItem(depth, `${encodedKey}: ${encodePrimitive(firstValue, options.delimiter)}`, options.indentSize);
-	else if (isJsonArray(firstValue)) if (firstValue.length === 0) yield indentedListItem(depth, `${encodedKey}: []`, options.indentSize);
-	else if (isArrayOfPrimitives(firstValue)) yield indentedListItem(depth, `${encodedKey}${encodeInlineArrayLine(firstValue, options.delimiter)}`, options.indentSize);
-	else {
-		yield indentedListItem(depth, `${encodedKey}${formatHeader(firstValue.length, { delimiter: options.delimiter })}`, options.indentSize);
-		for (const item of firstValue) yield* encodeListItemValueLines(item, depth + 2, options);
-	}
-	else if (isJsonObject(firstValue)) {
-		yield indentedListItem(depth, `${encodedKey}:`, options.indentSize);
-		if (!isEmptyObject(firstValue)) yield* encodeObjectLines(firstValue, depth + 2, options);
-	}
-	if (restEntries.length > 0) yield* encodeObjectLines(Object.fromEntries(restEntries), depth + 1, options);
-}
-function* encodeListItemValueLines(value, depth, options) {
-	if (isEncodablePrimitive(value)) yield indentedListItem(depth, encodePrimitive(value, options.delimiter), options.indentSize);
-	else if (isJsonArray(value)) if (isArrayOfPrimitives(value)) yield indentedListItem(depth, encodeInlineArrayLine(value, options.delimiter), options.indentSize);
-	else {
-		yield indentedListItem(depth, formatHeader(value.length, { delimiter: options.delimiter }), options.indentSize);
-		for (const item of value) yield* encodeListItemValueLines(item, depth + 1, options);
-	}
-	else if (isJsonObject(value)) yield* encodeObjectAsListItemLines(value, depth, options);
-}
-function indentedLine(depth, content, indentSize) {
-	return " ".repeat(indentSize * depth) + content;
-}
-function indentedListItem(depth, content, indentSize) {
-	return indentedLine(depth, "- " + content, indentSize);
-}
-/**
-* Applies a replacer function to a `JsonValue` and all its descendants.
-*
-* The replacer is called for the root (key='', path=[]), every object property
-* (key = property name), and every array element (key = string index).
-*/
-function applyReplacer(root, replacer) {
-	const replacedRoot = replacer("", root, []);
-	if (replacedRoot === void 0) return transformChildren(root, replacer, []);
-	return transformReplaced(root, replacedRoot, replacer, []);
-}
-/**
-* Resolves a replacer's (non-`undefined`) return value at a single position.
-*
-* A `RawString` only stands in for a primitive: returned for an object or
-* array value, it is ignored and the original container is traversed normally.
-*/
-function transformReplaced(original, replaced, replacer, path) {
-	if (isRawString(replaced) && !isEncodablePrimitive(original)) return transformChildren(original, replacer, path);
-	return transformChildren(normalizeValue(replaced), replacer, path);
-}
-function transformChildren(value, replacer, path) {
-	if (isJsonObject(value)) return transformObject(value, replacer, path);
-	if (isJsonArray(value)) return transformArray(value, replacer, path);
-	return value;
-}
-function transformObject(obj, replacer, path) {
-	const result = {};
-	for (const [key, value] of Object.entries(obj)) {
-		const childPath = [...path, key];
-		const replacedValue = replacer(key, value, childPath);
-		if (replacedValue === void 0) continue;
-		setOwnProperty(result, key, transformReplaced(value, replacedValue, replacer, childPath));
-	}
-	return result;
-}
-function transformArray(arr, replacer, path) {
-	const result = [];
-	for (let i = 0; i < arr.length; i++) {
-		const value = arr[i];
-		const childPath = [...path, i];
-		const replacedValue = replacer(String(i), value, childPath);
-		if (replacedValue === void 0) continue;
-		result.push(transformReplaced(value, replacedValue, replacer, childPath));
-	}
-	return result;
-}
-/**
-* Encodes a JavaScript value into TOON format string.
-*
-* @param input Any JavaScript value (objects, arrays, primitives)
-* @param options Optional encoding configuration
-* @returns TOON formatted string
-*
-* @example
-* ```ts
-* encode({ name: 'Ada', age: 30 })
-* // name: Ada
-* // age: 30
-*
-* encode({ users: [{ id: 1 }, { id: 2 }] })
-* // users[2]{id}:
-* //   1
-* //   2
-*
-* encode({ tags: [] })
-* // tags: []
-*
-* encode(data, { indentSize: 4 })
-* ```
-*/
-function encode(input, options) {
-	return Array.from(encodeLines(input, options)).join("\n");
-}
+//#region src/command-output/command-output.ts
 /**
-* Encodes a JavaScript value into TOON format as a sequence of lines.
-*
-* This function yields TOON lines one at a time without building the full string,
-* making it suitable for streaming large outputs to files, HTTP responses, or process stdout.
-*
-* @param input Any JavaScript value (objects, arrays, primitives)
-* @param options Optional encoding configuration
-* @returns Iterable of TOON lines (without trailing newlines)
-*
-* @example
-* ```ts
-* // Stream to stdout
-* for (const line of encodeLines({ name: 'Ada', age: 30 })) {
-*   console.log(line)
-* }
-*
-* // Collect to array
-* const lines = Array.from(encodeLines(data))
-*
-* // Equivalent to encode()
-* const toonString = Array.from(encodeLines(data, options)).join('\n')
-* ```
+* Reports a failure on stderr, not stdout — stdout carries what an agent parses — and fails the cli
+* with the exit code. A `CliError` the cli already reports is rethrown untouched.
 */
-function encodeLines(input, options) {
-	const normalizedValue = normalizeValue(input);
-	const resolvedOptions = resolveOptions(options);
-	return encodeJsonValue(resolvedOptions.replacer ? applyReplacer(normalizedValue, resolvedOptions.replacer) : normalizedValue, resolvedOptions, 0);
-}
-function resolveOptions(options) {
-	const delimiter = options?.delimiter ?? DEFAULT_DELIMITER;
-	assertValidDelimiter(delimiter);
-	return {
-		indentSize: options?.indentSize ?? options?.indent ?? 2,
-		delimiter,
-		replacer: options?.replacer
-	};
-}
-//#endregion
-//#region src/is-record/is-record.ts
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-//#endregion
-//#region src/command-output/command-output.ts
-const formats = [
-	"toon",
-	"json",
-	"text"
-];
-/** Rejects anything but the supported formats so an unknown value never falls back silently. */
-function parseFormat(value) {
-	if (!formats.includes(value)) throw new Error("--format must be toon, json, or text.");
-	return value;
-}
-/** The single stdout boundary: internal logic stays on plain objects, encoding happens here. */
-function writeResult(value, format) {
-	process.stdout.write(`${encodeResult(value, format)}\n`);
+function fail(error, fallback) {
+	if (isCliError(error)) throw error;
+	process.stderr.write(`error: ${error instanceof Error ? error.message : fallback}\n`);
+	throw CliError.reported(exitCodes.error);
 }
 /**
-* Writes a document exactly as read, bypassing the encoders — a Markdown body run through TOON or
-* the text renderer comes back as one escaped line. A command writes one or the other, never both.
+* An answer that comes with a failing exit code. The cli prints only an answer a command returns, and
+* a thrown error replaces the return, so the answer is printed first.
 */
-function writeDocument(content) {
-	process.stdout.write(content.endsWith("\n") ? content : `${content}\n`);
-}
-function encodeResult(value, format) {
-	if (format === "json") return JSON.stringify(value);
-	return format === "text" ? renderText(value) : encode(value);
-}
-function cell(value) {
-	return value === void 0 ? "" : String(value);
-}
-function table(rows) {
-	const columns = [...new Set(rows.flatMap((row) => Object.keys(row)))];
-	const widths = columns.map((column) => Math.max(column.length, ...rows.map((row) => cell(row[column]).length)));
-	const line = (values) => `  ${values.map((value, index) => value.padEnd(widths[index])).join("  ")}`.trimEnd();
-	return [line(columns), ...rows.map((row) => line(columns.map((column) => cell(row[column]))))];
-}
-/** Renders for a person, not an agent — TOON stays the default since that's what an agent parses. */
-function renderText(value) {
-	const blocks = Object.entries(value).map(([key, item]) => {
-		if (!Array.isArray(item)) return [`${key}: ${isRecord(item) ? JSON.stringify(item) : String(item)}`];
-		if (!item.length) return [`${key}: (none)`];
-		const body = item.every(isRecord) ? table(item) : item.map((entry) => `  - ${String(entry)}`);
-		return [`${key}:`, ...body];
-	});
-	return blocks.flatMap((block, index) => {
-		const previous = blocks[index - 1];
-		return previous && (previous.length > 1 || block.length > 1) ? ["", ...block] : block;
-	}).join("\n");
+function answerThenFail(answer, format) {
+	const text = printAnswer(answer, format);
+	if (text !== void 0) process.stdout.write(text);
+	throw CliError.reported(exitCodes.error);
 }
 /**
 * AXI §10: collapses the home directory to `~` so a path in a report is portable to another
@@ -990,21 +409,15 @@ const depPluginsCommand = command({
 	options: {
 		root: {
 			description: "Repository directory. Defaults to the current directory.",
-			type: z.optional(z.string())
+			type: t.string().optional()
 		},
 		check: {
 			description: "Report whether the catalog is current without writing it. For CI and postinstall.",
-			type: z.optional(z.boolean())
-		},
-		format: {
-			description: "Output format: toon (default), json, or text for a human-readable report.",
-			type: z.optional(z.string()),
-			default: "toon"
+			type: t.boolean().optional()
 		}
 	},
 	run(args) {
 		try {
-			const format = parseFormat(args.format);
 			const root = args.root ?? process.cwd();
 			const derived = deriveCatalog(root);
 			const outcome = args.check ? catalogStatus(root, derived.catalog) === "unchanged" ? "current" : "would-change" : writeCatalog(root, derived.catalog);
@@ -1036,7 +449,7 @@ const depPluginsCommand = command({
 				});
 			}
 			if (derived.plugins.length) notes.push(COPILOT_LIMITATION);
-			writeResult({
+			const report = {
 				catalog: CATALOG_PATH,
 				marketplace: derived.catalog.name,
 				outcome,
@@ -1048,11 +461,11 @@ const depPluginsCommand = command({
 				harness: harness.length ? harness : "no supported harness detected on this machine",
 				actions: actions.length ? actions : "0 actions — every detected harness matches the catalog",
 				...notes.length ? { notes } : {}
-			}, format);
-			return outcome === "would-change" ? exitCodes.error : exitCodes.success;
+			};
+			const answer = result(report);
+			return outcome === "would-change" ? answerThenFail(answer, this.format) : answer;
 		} catch (error) {
-			process.stderr.write(`error: ${error instanceof Error ? error.message : "Catalog generation failed."}\n`);
-			return exitCodes.error;
+			return fail(error, "Catalog generation failed.");
 		}
 	}
 });
@@ -1078,7 +491,7 @@ function filesUnder(directory) {
 function skillsProjection(harness, scope, directories = skillsDirectories(harness)?.[scope]) {
 	const listed = directories ?? [];
 	const [first] = listed;
-	if (first === void 0) throw new Error(`@cyberuni/agent-harness records no ${scope} skills directories for ${harness}.`);
+	if (first === void 0) throw new Error(`cyber-agentkit records no ${scope} skills directories for ${harness}.`);
 	return listed.includes(".agents/skills") ? {} : { skillsDirectory: first };
 }
 /**
@@ -1088,7 +501,7 @@ function skillsProjection(harness, scope, directories = skillsDirectories(harnes
 */
 const globalInstructions = ".agents/AGENTS.md";
 /**
-* Skills directories come from `@cyberuni/agent-harness`, except for the harnesses it does not know
+* Skills directories come from `cyber-agentkit`, except for the harnesses it does not know
 * (`devin-desktop`, `windsurf`); see `.research/agentic-configuration-standards/` for the rest.
 */
 const harnessRegistry = [
@@ -1346,7 +759,7 @@ function repairsOf(table) {
 	}));
 }
 const commandInvocation = "buddy-agent-harness";
-const skillInvocation = (version) => `npx -y ${commandInvocation}@^${version}`;
+const skillInvocation = (version) => `npx -y ${commandInvocation}@${version}`;
 /** Named for the subcommand it runs, so a stack trace or process list shows which one it was. */
 const launcherFor = (subcommand) => `scripts/${subcommand}.mjs`;
 /**
@@ -1356,6 +769,14 @@ const launcherFor = (subcommand) => `scripts/${subcommand}.mjs`;
 const launcherInvocation = (subcommand) => `node ${launcherFor(subcommand)}`;
 const repairSkillInvocation = "/buddy-agent-harness:repair";
 const initSkillInvocation = `/buddy-agent-harness:init-buddy-agent-harness`;
+/**
+* A skill reference as the CLI prints it and the generated skill carries it: pnpm links a skill as
+* `pnpm-<package>-<skill>`, where the plugin form resolves to nothing. This is the form
+* `universal-plugin plugin build` writes, so a build over generated text changes nothing.
+*/
+const pnpmSkillRef = (invocation) => `\`${invocation}\` (pnpm install: \`pnpm-${commandInvocation}-${invocation.slice(invocation.indexOf(":") + 1)}\`)`;
+const initSkillRef = pnpmSkillRef(initSkillInvocation);
+const repairSkillRef = pnpmSkillRef(repairSkillInvocation);
 /** Where the user authors the golden MCP server set, named in every MCP repair that points at it. */
 const goldenSet = ".agents/buddy-agent-harness/mcp.toml";
 const bridgeTable = {
@@ -1365,7 +786,7 @@ const bridgeTable = {
 			command: `${cli} init`,
 			instruction: `run \`${cli} init\` to create .agents/skills and the bridges into it`
 		}),
-		skillRepair: () => `run \`${initSkillInvocation}\`, which creates \`.agents/skills\` and the bridges`
+		skillRepair: () => `run ${initSkillRef}, which creates \`.agents/skills\` and the bridges`
 	},
 	missing: {
 		detail: "no bridge at this path — the harness sees zero project skills",
@@ -1373,7 +794,7 @@ const bridgeTable = {
 			command: `${cli} init`,
 			instruction: `run \`${cli} init\` to create the bridge at ${file}`
 		}),
-		skillRepair: () => `run \`${initSkillInvocation}\``
+		skillRepair: () => `run ${initSkillRef}`
 	},
 	degraded: {
 		detail: "expected a directory but found a regular file — checkout without core.symlinks",
@@ -1442,49 +863,49 @@ const instructionTable = {
 		detail: "no AGENTS.md at the repository root, so the instructions this repository has reach one harness at most",
 		repair: () => ({
 			command: "",
-			instruction: `hand this to \`${initSkillInvocation}\`, which consolidates what the repository has into AGENTS.md, or derives it`
+			instruction: `hand this to ${initSkillRef}, which consolidates what the repository has into AGENTS.md, or derives it`
 		}),
-		skillRepair: () => `run \`${initSkillInvocation}\`, which consolidates or derives AGENTS.md`
+		skillRepair: () => `run ${initSkillRef}, which consolidates or derives AGENTS.md`
 	},
 	"instructions-missing": {
 		detail: "no instruction bridge at this path — the harness reads none of AGENTS.md",
 		repair: ({ file }) => ({
 			command: "",
-			instruction: `hand ${file} to \`${initSkillInvocation}\`, which writes the bridge into it`
+			instruction: `hand ${file} to ${initSkillRef}, which writes the bridge into it`
 		}),
-		skillRepair: () => `run \`${initSkillInvocation}\``
+		skillRepair: () => `run ${initSkillRef}`
 	},
 	"instructions-unbridged": {
 		detail: "the file is present but names AGENTS.md nowhere — the harness reads none of it",
 		repair: ({ file }) => ({
 			command: "",
-			instruction: `hand ${file} to \`${initSkillInvocation}\`, which adds the bridge without discarding what the file already says`
+			instruction: `hand ${file} to ${initSkillRef}, which adds the bridge without discarding what the file already says`
 		}),
-		skillRepair: () => `run \`${initSkillInvocation}\`, which adds the bridge without discarding what the file already says`
+		skillRepair: () => `run ${initSkillRef}, which adds the bridge without discarding what the file already says`
 	},
 	"instructions-shadowing": {
 		detail: "this file suppresses the AGENTS.md beside it — the harness reads this instead, and none of AGENTS.md",
 		repair: ({ file }) => ({
 			command: "",
-			instruction: `hand ${file} to \`${initSkillInvocation}\`, which consolidates what it says into AGENTS.md, or adds an @AGENTS.md import above it where the file has to stay`
+			instruction: `hand ${file} to ${initSkillRef}, which consolidates what it says into AGENTS.md, or adds an @AGENTS.md import above it where the file has to stay`
 		}),
-		skillRepair: () => `run \`${initSkillInvocation}\`, which consolidates the file into AGENTS.md or imports AGENTS.md from it`
+		skillRepair: () => `run ${initSkillRef}, which consolidates the file into AGENTS.md or imports AGENTS.md from it`
 	},
 	"instructions-superseded": {
 		detail: "a bridge from before the harness read AGENTS.md itself — it still works, and nothing needs it",
 		repair: ({ file }) => ({
 			command: "",
-			instruction: `remove ${file}, or keep it for sessions that cannot read AGENTS.md directly — \`${initSkillInvocation}\` offers the choice`
+			instruction: `remove ${file}, or keep it for sessions that cannot read AGENTS.md directly — ${initSkillRef} offers the choice`
 		}),
-		skillRepair: () => `run \`${initSkillInvocation}\`, which offers to remove it`
+		skillRepair: () => `run ${initSkillRef}, which offers to remove it`
 	},
 	"instructions-unreadable": {
 		detail: "the settings file does not parse, so the harness reads none of it",
 		repair: ({ file }) => ({
 			command: "",
-			instruction: `fix the JSON in ${file} by hand, then hand it to \`${initSkillInvocation}\``
+			instruction: `fix the JSON in ${file} by hand, then hand it to ${initSkillRef}`
 		}),
-		skillRepair: () => `fix the JSON by hand, then run \`${initSkillInvocation}\``
+		skillRepair: () => `fix the JSON by hand, then run ${initSkillRef}`
 	}
 };
 const instructionRepairs = repairsOf(instructionTable);
@@ -1556,33 +977,33 @@ const configurationTable = {
 		detail: "a projection under a harness name that has been superseded — the replacement reads .agents/skills natively and needs no projection at all",
 		repair: ({ file }) => ({
 			command: "",
-			instruction: `remove ${file} and enable the harness that replaced it — \`${repairSkillInvocation}\` offers the correction`
+			instruction: `remove ${file} and enable the harness that replaced it — ${repairSkillRef} offers the correction`
 		}),
-		skillRepair: () => `run \`${repairSkillInvocation}\``
+		skillRepair: () => `run ${repairSkillRef}`
 	},
 	"ignored-bridge": {
 		detail: "a .gitignore rule matches this bridge — an untracked bridge swallows a real edit silently",
 		repair: ({ file }) => ({
 			command: "",
-			instruction: `narrow or remove the .gitignore rule matching ${file} — \`${repairSkillInvocation}\` offers the correction`
+			instruction: `narrow or remove the .gitignore rule matching ${file} — ${repairSkillRef} offers the correction`
 		}),
-		skillRepair: () => `run \`${repairSkillInvocation}\``
+		skillRepair: () => `run ${repairSkillRef}`
 	},
 	"unread-local-override": {
 		detail: "no harness reads this filename, so everything in it is invisible to every agent",
 		repair: ({ file }) => ({
 			command: "",
-			instruction: `move ${file} to CLAUDE.local.md, or consolidate it into AGENTS.md — \`${repairSkillInvocation}\` offers the correction`
+			instruction: `move ${file} to CLAUDE.local.md, or consolidate it into AGENTS.md — ${repairSkillRef} offers the correction`
 		}),
-		skillRepair: () => `run \`${repairSkillInvocation}\``
+		skillRepair: () => `run ${repairSkillRef}`
 	},
 	"unloadable-skill": {
 		detail: "frontmatter that does not parse, or no description — either one makes a harness skip the skill outright",
 		repair: ({ file }) => ({
 			command: "",
-			instruction: `quote the description in ${file}, or add one — \`${repairSkillInvocation}\` offers the correction`
+			instruction: `quote the description in ${file}, or add one — ${repairSkillRef} offers the correction`
 		}),
-		skillRepair: () => `run \`${repairSkillInvocation}\``
+		skillRepair: () => `run ${repairSkillRef}`
 	}
 };
 repairsOf(configurationTable);
@@ -1611,33 +1032,33 @@ const mcpTable = {
 		detail: "the golden set declares this server and the harness config does not carry it",
 		repair: ({ file, server }) => ({
 			command: "",
-			instruction: `add the server ${server} to ${file}, or drop it from the golden set — \`${repairSkillInvocation}\` offers the correction`
+			instruction: `add the server ${server} to ${file}, or drop it from the golden set — ${repairSkillRef} offers the correction`
 		}),
-		skillRepair: (at) => `hand ${locatorText(at)} to \`${repairSkillInvocation}\`, which projects it from its golden entry with \`mcp project\` — or drop it from the golden set`
+		skillRepair: (at) => `hand ${locatorText(at)} to ${repairSkillRef}, which projects it from its golden entry with \`mcp project\` — or drop it from the golden set`
 	},
 	"mcp-undeclared": {
 		detail: "the harness config carries this server and the golden set does not declare it",
 		repair: ({ file, server }) => ({
 			command: "",
-			instruction: `add the server ${server} to ${goldenSet}, or drop it from ${file} — \`${repairSkillInvocation}\` offers the import`
+			instruction: `add the server ${server} to ${goldenSet}, or drop it from ${file} — ${repairSkillRef} offers the import`
 		}),
-		skillRepair: (at) => `hand ${locatorText(at)} to \`${repairSkillInvocation}\`, which imports it field by field with \`mcp reconcile\`, refusing any literal credential — or drop it from ${at.file}`
+		skillRepair: (at) => `hand ${locatorText(at)} to ${repairSkillRef}, which imports it field by field with \`mcp reconcile\`, refusing any literal credential — or drop it from ${at.file}`
 	},
 	"mcp-diverged-target": {
 		detail: "only the harness config changed since the two last agreed — the edit was made through the copy",
 		repair: (at) => ({
 			command: "",
-			instruction: `reconcile the value at ${locatorText(at)} back into ${goldenSet} — \`${repairSkillInvocation}\` offers the import`
+			instruction: `reconcile the value at ${locatorText(at)} back into ${goldenSet} — ${repairSkillRef} offers the import`
 		}),
-		skillRepair: (at) => `hand ${locatorText(at)} to \`${repairSkillInvocation}\`, which imports the field into ${goldenSet} with \`mcp reconcile\` once approved`
+		skillRepair: (at) => `hand ${locatorText(at)} to ${repairSkillRef}, which imports the field into ${goldenSet} with \`mcp reconcile\` once approved`
 	},
 	"mcp-diverged-golden": {
 		detail: "only the golden set changed since the two last agreed — the harness copy is stale",
 		repair: (at) => ({
 			command: "",
-			instruction: `update ${locatorText(at)} from the golden entry — \`${repairSkillInvocation}\` offers the correction`
+			instruction: `update ${locatorText(at)} from the golden entry — ${repairSkillRef} offers the correction`
 		}),
-		skillRepair: (at) => `hand ${locatorText(at)} to \`${repairSkillInvocation}\`, which updates it from the golden entry with \`mcp project\``
+		skillRepair: (at) => `hand ${locatorText(at)} to ${repairSkillRef}, which updates it from the golden entry with \`mcp project\``
 	},
 	"mcp-diverged-both": {
 		detail: "both sides changed since they last agreed — merging either way would discard the other",
@@ -1682,33 +1103,33 @@ const nonstandardTable = {
 		detail: "instruction content only one harness reads — AGENTS.md carries the same prose to all of them",
 		repair: ({ file }) => ({
 			command: "",
-			instruction: `consolidate ${file} into AGENTS.md — \`${initSkillInvocation}\` offers the consolidation, and keeps the content reachable where this harness needs it`
+			instruction: `consolidate ${file} into AGENTS.md — ${initSkillRef} offers the consolidation, and keeps the content reachable where this harness needs it`
 		}),
-		skillRepair: ({ file }) => `hand ${file} to \`${initSkillInvocation}\`, which consolidates it into AGENTS.md`
+		skillRepair: ({ file }) => `hand ${file} to ${initSkillRef}, which consolidates it into AGENTS.md`
 	},
 	"nonstandard-rule": {
 		detail: "a path-scoped rule only one harness reads — a skill reaches every harness where the scoping is incidental",
 		repair: ({ file }) => ({
 			command: "",
-			instruction: `convert ${file} into a skill under .agents/skills where its guidance is not tied to the paths it names — \`${initSkillInvocation}\` offers the conversion; keep it where the path scoping is the point`
+			instruction: `convert ${file} into a skill under .agents/skills where its guidance is not tied to the paths it names — ${initSkillRef} offers the conversion; keep it where the path scoping is the point`
 		}),
-		skillRepair: ({ file }) => `hand ${file} to \`${initSkillInvocation}\` to convert into a skill, unless the path scoping is load-bearing`
+		skillRepair: ({ file }) => `hand ${file} to ${initSkillRef} to convert into a skill, unless the path scoping is load-bearing`
 	},
 	"nonstandard-command": {
 		detail: "a harness command file — a skill is the portable form, and this harness reads skills too",
 		repair: ({ file }) => ({
 			command: "",
-			instruction: `move ${file} to .agents/skills/<name>/SKILL.md — \`${initSkillInvocation}\` offers the move`
+			instruction: `move ${file} to .agents/skills/<name>/SKILL.md — ${initSkillRef} offers the move`
 		}),
-		skillRepair: ({ file }) => `hand ${file} to \`${initSkillInvocation}\`, which moves it to .agents/skills`
+		skillRepair: ({ file }) => `hand ${file} to ${initSkillRef}, which moves it to .agents/skills`
 	},
 	"nonstandard-skill": {
 		detail: "a skill under a harness directory rather than the canonical one, where only that harness finds it",
 		repair: ({ file }) => ({
 			command: "",
-			instruction: `move ${file} to .agents/skills and project it back where the harness needs one — \`${initSkillInvocation}\` offers the move`
+			instruction: `move ${file} to .agents/skills and project it back where the harness needs one — ${initSkillRef} offers the move`
 		}),
-		skillRepair: ({ file }) => `hand ${file} to \`${initSkillInvocation}\`, which moves it to .agents/skills`
+		skillRepair: ({ file }) => `hand ${file} to ${initSkillRef}, which moves it to .agents/skills`
 	},
 	"nonstandard-subagent": {
 		detail: "a subagent definition with no cross-harness form — nothing outside this harness can read it, and no canonical form exists yet",
@@ -1789,9 +1210,9 @@ The command is read-only. It never repairs anything, so it is safe to run at any
 
 \`command\` is empty whenever no single invocation does the job, and that emptiness is the signal: act on \`instruction\` and do not assemble a command out of it. A runnable invocation quoted *inside* an \`instruction\` is not the repair either — \`diverged-both\` names \`git diff --no-index\` because the diff shows you what differs, not because running it reconciles anything. Apply the repair, then re-run \`doctor\`.
 
-Nothing in \`help\` is wrapped. An earlier version prefixed every repair with \`Run\`, which read as an instruction to paste prose into a shell.
+Nothing in \`help\` is wrapped.
 
-Do not run an \`init\` command yourself. Rebuilding a skills bridge can move skills a user wrote, and rewriting an instruction file touches prose a person authored — both are the \`init-buddy-agent-harness\` skill's judgment, so hand the repair to \`${initSkillInvocation}\` instead. Every such repair carries an empty \`command\`: a skill invocation has no shell equivalent at all.
+Do not run an \`init\` command yourself. Rebuilding a skills bridge can move skills a user wrote, and rewriting an instruction file touches prose a person authored — both are the \`init-buddy-agent-harness\` skill's judgment, so hand the repair to ${initSkillRef} instead. Every such repair carries an empty \`command\`: a skill invocation has no shell equivalent at all.
 
 When every bridge resolves, \`findings\` says so outright rather than being empty.
 
@@ -1867,6 +1288,11 @@ function diagnoseConfiguration({ root, git, cli }) {
 	return findings;
 }
 //#endregion
+//#region src/is-record/is-record.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
 //#region src/diagnose-mcp/mcp-model.ts
 /** Every field of the model, in the order a finding reports them. */
 const mcpFields = [
@@ -2628,18 +2054,31 @@ function diagnoseNonstandard({ root, cli }) {
 }
 //#endregion
 //#region src/governance-overrides/governance-overrides.ts
-/** @deprecated Use `managedReferencesDir`. Removed in the next major version. */
+function machineWideDir(platform, programData, names) {
+	if (platform === "darwin") return join("/Library/Application Support", names.macos, "governances");
+	if (platform === "win32") return join(programData || "C:\\ProgramData", names.windows, "governances");
+	return join("/etc", names.posix, "governances");
+}
+/** @deprecated Use the `reference` command's layers. Removed in the next major version. */
 function managedGovernancesDir(platform, programData) {
-	return managedGovernancesDir$1(platform, programData);
+	return machineWideDir(platform, programData, {
+		posix: "buddy-agent-harness",
+		macos: "BuddyAgentHarness",
+		windows: "BuddyAgentHarness"
+	});
 }
 /**
 * 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.
+* @deprecated Use the `reference` command's layers. Removed in the next major version.
 */
 function deprecatedManagedGovernancesDir(platform, programData) {
-	return deprecatedManagedGovernancesDir$1(platform, programData);
+	return machineWideDir(platform, programData, {
+		posix: "universal-plugin",
+		macos: "UniPlugin",
+		windows: "UniPlugin"
+	});
 }
 function projectGovernancesDir(root) {
 	return join(root, ".agents", "governances");
@@ -2755,7 +2194,7 @@ function listGovernances(layers) {
 //#endregion
 //#region src/references/references.ts
 const PACKAGE_PLUGIN = "buddy-agent-harness";
-/** `@cyberuni/agent-harness`'s reference layers, with this package as the plugin whose own references come first. */
+/** `cyber-agentkit`'s reference layers, with this package as the plugin whose own references come first. */
 function referenceLayers({ packageRoot = dirname(packageGovernancesDir()), ...options }) {
 	return referenceLayers$1({
 		...options,
@@ -3489,25 +2928,19 @@ const doctorCommand = command({
 	options: {
 		root: {
 			description: "Repository or package directory. Defaults to the current directory.",
-			type: z.optional(z.string())
+			type: t.string().optional()
 		},
 		harness: {
 			description: "Comma-separated harnesses to check in addition to Claude Code and Cursor, e.g. codex,gemini-cli.",
-			type: z.optional(z.string())
-		},
-		format: {
-			description: "Output format: toon (default), json, or text for a human-readable report.",
-			type: z.optional(z.string()),
-			default: "toon"
+			type: t.string().optional()
 		}
 	},
 	async run(args) {
 		try {
-			const format = parseFormat(args.format);
 			const harnesses = parseHarnesses(args.harness);
 			const root = args.root ?? process.cwd();
 			const home = homedir();
-			const result = diagnoseBridges({
+			const diagnosis = diagnoseBridges({
 				root,
 				...harnesses.length ? { harnesses } : {},
 				cli: commandInvocation,
@@ -3531,24 +2964,21 @@ const doctorCommand = command({
 					cli: commandInvocation
 				})
 			];
-			const { rows } = listReferences$1(await referenceLayers({
+			const { layers: rows } = listReferences$1(await referenceLayers({
 				root,
 				home,
 				platform: process.platform,
-				programData: process.env["ProgramData"],
 				env: process.env
 			}));
-			const held = rows.filter(({ tier }) => tier !== "plugin").map(({ name, tier, path, status }) => ({
+			const held = rows.filter(({ tier }) => tier !== "plugin").map(({ name, tier, path, outcome }) => ({
 				name,
 				tier,
 				path: collapseHome(home, path),
-				status
+				status: outcome
 			}));
-			writeResult(buildDoctorReport(displayBinPath(home, process.argv[1]), result, configuration, held), format);
-			return exitCodes.success;
+			return result(buildDoctorReport(displayBinPath(home, process.argv[1]), diagnosis, configuration, held));
 		} catch (error) {
-			process.stderr.write(`error: ${error instanceof Error ? error.message : "Harness diagnosis failed."}\n`);
-			return exitCodes.error;
+			return fail(error, "Harness diagnosis failed.");
 		}
 	}
 });
@@ -3567,32 +2997,26 @@ const GOVERNANCE_DEPRECATED = "warning: \"governance\" is deprecated and will be
 const DEPRECATED_MANAGED = "deprecated — move these documents to the managed layer above";
 const rootOption = {
 	description: "Repository or package directory. Defaults to the current directory.",
-	type: z.optional(z.string())
+	type: t.string().optional()
 };
 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: z.optional(z.boolean())
+	type: t.boolean().optional()
 };
 const governanceListCommand = command({
 	name: "list",
 	description: "List every governance the override layers hold, each at the layer that would win.",
 	options: {
 		root: rootOption,
-		"overrides-only": overridesOnlyOption,
-		format: {
-			description: "Output format: toon (default), json, or text for a human-readable report.",
-			type: z.optional(z.string()),
-			default: "toon"
-		}
+		"overrides-only": overridesOnlyOption
 	},
 	run(args) {
 		process.stderr.write(GOVERNANCE_DEPRECATED);
 		try {
-			const format = parseFormat(args.format);
 			const home = homedir();
 			const layers = layersFor(args);
 			const entries = listGovernances(layers);
-			writeResult({
+			const report = {
 				layers: layers.map(({ scope, dir }) => ({
 					scope,
 					path: collapseHome(home, dir),
@@ -3603,11 +3027,10 @@ const governanceListCommand = command({
 					scope,
 					path: collapseHome(home, path)
 				})) : "0 governances — no layer holds one"
-			}, format);
-			return exitCodes.success;
+			};
+			return result(report);
 		} catch (error) {
-			process.stderr.write(`error: ${error instanceof Error ? error.message : "Governance listing failed."}\n`);
-			return exitCodes.error;
+			return fail(error, "Governance listing failed.");
 		}
 	}
 });
@@ -3617,38 +3040,31 @@ const governanceShowCommand = command({
 	arguments: [{
 		name: "name",
 		description: "The governance name, without the `.md` extension.",
-		type: z.string()
+		type: t.string()
 	}],
 	options: {
 		root: rootOption,
-		"overrides-only": overridesOnlyOption,
-		format: {
-			description: "Output format: text (default) writes the document itself; toon and json wrap it with the layer it came from.",
-			type: z.optional(z.string()),
-			default: "text"
-		}
+		"overrides-only": overridesOnlyOption
 	},
 	run(args) {
+		const format = this.format;
 		process.stderr.write(GOVERNANCE_DEPRECATED);
 		try {
-			const format = parseFormat(args.format);
 			const name = parseGovernanceName(args.name);
 			const found = resolveGovernance(name, layersFor(args));
 			if (!found) {
 				process.stderr.write(args["overrides-only"] ? `error: no override for governance "${name}" in the project, user, or machine-wide layer.\n` : `error: no governance named "${name}" in any layer.\n`);
-				return exitCodes.error;
+				throw CliError.reported(exitCodes.error);
 			}
-			if (format === "text") writeDocument(found.content);
-			else writeResult({
+			const report = {
 				name: found.name,
 				scope: found.scope,
 				path: collapseHome(homedir(), found.path),
 				content: found.content
-			}, format);
-			return exitCodes.success;
+			};
+			return format === "text" ? document(report.content) : result(report);
 		} catch (error) {
-			process.stderr.write(`error: ${error instanceof Error ? error.message : "Governance lookup failed."}\n`);
-			return exitCodes.error;
+			return fail(error, "Governance lookup failed.");
 		}
 	}
 });
@@ -3664,7 +3080,10 @@ function initializeHarnesses({ root, harnesses: preferred = [], copy = false, fo
 	const canonicalSkills = join(root, ".agents", "skills");
 	const skills = countSkills(canonicalSkills);
 	mkdirSync(projectReferencesDir(root), { recursive: true });
-	const references = referenceNames(projectReferenceLayers(root)).length;
+	const references = referenceNames([{
+		tier: "project",
+		dir: projectReferencesDir(root)
+	}]).length;
 	const harnesses = selectHarnesses(root, preferred);
 	const { linked, skipped } = projectSkills({
 		root,
@@ -3696,40 +3115,32 @@ const initCommand = command({
 	options: {
 		root: {
 			description: "Repository or package directory. Defaults to the current directory.",
-			type: z.optional(z.string())
+			type: t.string().optional()
 		},
 		harness: {
 			description: "Comma-separated harnesses to enable in addition to Claude Code and Cursor, e.g. codex,gemini-cli.",
-			type: z.optional(z.string())
+			type: t.string().optional()
 		},
 		copy: {
 			description: "Copy skills instead of linking them.",
-			type: z.optional(z.boolean())
+			type: t.boolean().optional()
 		},
 		force: {
 			description: "Replace conflicting target skill directories. Names the targets to replace, comma-separated (e.g. .claude/skills); given alone it replaces every conflicting target.",
-			type: z.optional(z.string())
-		},
-		format: {
-			description: "Output format: toon (default), json, or text for a human-readable report.",
-			type: z.optional(z.string()),
-			default: "toon"
+			type: t.string().optional()
 		}
 	},
 	run(args) {
 		try {
-			const format = parseFormat(args.format);
 			const harnesses = parseHarnesses(args.harness);
-			writeResult(initializeHarnesses({
+			return result(initializeHarnesses({
 				root: args.root ?? process.cwd(),
 				...harnesses.length ? { harnesses } : {},
 				...args.copy === void 0 ? {} : { copy: args.copy },
 				...args.force === void 0 ? {} : { force: parseForce(args.force) }
-			}), format);
-			return exitCodes.success;
+			}));
 		} catch (error) {
-			process.stderr.write(`error: ${error instanceof Error ? error.message : "Harness initialization failed."}\n`);
-			return exitCodes.error;
+			return fail(error, "Harness initialization failed.");
 		}
 	}
 });
@@ -4170,21 +3581,15 @@ const mcpReconcileCommand = command({
 	options: {
 		root: {
 			description: "Repository or package directory. Defaults to the current directory.",
-			type: z.optional(z.string())
+			type: t.string().optional()
 		},
 		accept: {
 			description: "Approve one field by the path a dry run lists for it; repeat for each field. There is no approve-all.",
-			type: z.optional(z.array(z.string()))
-		},
-		format: {
-			description: "Output format: toon (default), json, or text for a human-readable report.",
-			type: z.optional(z.string()),
-			default: "toon"
+			type: t.array(t.string()).optional()
 		}
 	},
 	run(args) {
 		try {
-			const format = parseFormat(args.format);
 			const root = args.root ?? process.cwd();
 			const accept = args.accept ?? [];
 			const plan = reconcileMcp({
@@ -4195,31 +3600,27 @@ const mcpReconcileCommand = command({
 			if (plan.kind === "unreadable") {
 				const at = plan.position ? ` at line ${plan.position.line}, column ${plan.position.column}` : "";
 				process.stderr.write(`error: ${goldenSetPath} does not parse${at}.\n`);
-				return exitCodes.error;
+				throw CliError.reported(exitCodes.error);
 			}
 			if (plan.kind === "rejected") {
 				process.stderr.write(`error: nothing written.\n${plan.reasons.map((reason) => `- ${reason}\n`).join("")}`);
-				return exitCodes.error;
-			}
-			if (plan.kind === "absent") {
-				writeResult({
-					golden: `0 servers — no golden set at ${goldenSetPath}`,
-					mode: "nothing to reconcile into",
-					fields: "0 fields",
-					record: "not written"
-				}, format);
-				return exitCodes.success;
+				throw CliError.reported(exitCodes.error);
 			}
-			writeResult({
+			if (plan.kind === "absent") return result({
+				golden: `0 servers — no golden set at ${goldenSetPath}`,
+				mode: "nothing to reconcile into",
+				fields: "0 fields",
+				record: "not written"
+			});
+			const report = {
 				golden: goldenSetPath,
 				mode: plan.written ? "written — only the fields named by --accept" : "dry run — nothing written; re-run with --accept <path> for each approved field",
 				fields: plan.rows.length ? plan.rows : "0 fields — no harness holds a change the golden set lacks",
 				record: plan.written ? projectionRecordPath : "not written — dry run"
-			}, format);
-			return exitCodes.success;
+			};
+			return result(report);
 		} catch (error) {
-			process.stderr.write(`error: ${error instanceof Error ? error.message : "MCP reconcile failed."}\n`);
-			return exitCodes.error;
+			return fail(error, "MCP reconcile failed.");
 		}
 	}
 });
@@ -4468,21 +3869,15 @@ const mcpProjectCommand = command({
 	options: {
 		root: {
 			description: "Repository or package directory. Defaults to the current directory.",
-			type: z.optional(z.string())
+			type: t.string().optional()
 		},
 		write: {
 			description: "Apply the plan and record what was projected. Without it nothing on disk changes.",
-			type: z.optional(z.boolean())
-		},
-		format: {
-			description: "Output format: toon (default), json, or text for a human-readable report.",
-			type: z.optional(z.string()),
-			default: "toon"
+			type: t.boolean().optional()
 		}
 	},
 	run(args) {
 		try {
-			const format = parseFormat(args.format);
 			const root = args.root ?? process.cwd();
 			const write = args.write === true;
 			const plan = projectMcp({
@@ -4493,28 +3888,24 @@ const mcpProjectCommand = command({
 			if (plan.kind === "unreadable") {
 				const at = plan.position ? ` at line ${plan.position.line}, column ${plan.position.column}` : "";
 				process.stderr.write(`error: ${goldenSetPath} does not parse${at}.\n`);
-				return exitCodes.error;
+				throw CliError.reported(exitCodes.error);
 			}
-			if (plan.kind === "absent") {
-				writeResult({
-					golden: `0 servers — no golden set at ${goldenSetPath}`,
-					mode: "nothing to project",
-					actions: "0 changes",
-					record: "not written"
-				}, format);
-				return exitCodes.success;
-			}
-			writeResult({
+			if (plan.kind === "absent") return result({
+				golden: `0 servers — no golden set at ${goldenSetPath}`,
+				mode: "nothing to project",
+				actions: "0 changes",
+				record: "not written"
+			});
+			const report = {
 				golden: goldenSetPath,
 				mode: write ? "written" : "dry run — nothing written; re-run with --write to apply",
 				actions: plan.rows.length ? plan.rows : "0 changes — every enabled harness already carries the golden set",
 				...plan.entries.length ? { entries: plan.entries } : {},
 				record: write ? projectionRecordPath : "not written — dry run"
-			}, format);
-			return exitCodes.success;
+			};
+			return result(report);
 		} catch (error) {
-			process.stderr.write(`error: ${error instanceof Error ? error.message : "MCP projection failed."}\n`);
-			return exitCodes.error;
+			return fail(error, "MCP projection failed.");
 		}
 	}
 });
@@ -4539,21 +3930,41 @@ const rootCommand = {
 		governanceCommand
 	]
 };
-function app() {
+function app(format) {
 	const [first, ...rest] = rootCommand.commands;
 	return rest.reduce((builder, command) => builder.command(command), cli({
 		name: rootCommand.name,
 		version,
-		description: rootCommand.description
+		description: rootCommand.description,
+		format
 	}).command(first));
 }
+const textByDefault = {
+	reference: [
+		"show",
+		"create",
+		"delete"
+	],
+	governance: ["show"]
+};
+/**
+* `reference show|create|delete` and `governance show` answer in `text` unless `--format` says
+* otherwise; every other command answers in `toon`. clibuilder has one global `--format` default,
+* so it is chosen from the command the argv names.
+*/
+function defaultFormat(argv) {
+	const args = argv.slice(2);
+	if (args.some((arg) => arg === "--format" || arg.startsWith("--format="))) return "toon";
+	const [group, subcommand] = args;
+	return group !== void 0 && subcommand !== void 0 && textByDefault[group]?.includes(subcommand) ? "text" : "toon";
+}
 /**
 * The application boundary: argv in, exit code out — returned rather than written, so a caller that
 * is not the process (a skill launcher, a test) can act on it.
 */
 async function run(argv) {
 	try {
-		const code = await app().parse(argv);
+		const code = await app(defaultFormat(argv)).parse(argv);
 		return typeof code === "number" ? code : exitCodes.success;
 	} catch (error) {
 		process.stderr.write(`error: ${error instanceof Error ? error.message : "Invalid command."}\n`);
@@ -4837,6 +4248,6 @@ function listMcpServers(options) {
 	return entries;
 }
 //#endregion
-export { activate, bridgeRepairs, buildDoctorReport, deprecatedManagedGovernancesDir, diagnoseBridges, diagnoseGlobalInstructions, diagnoseInstructions, diagnoseMcp, doctorCommand, doctorRepairs, doctorSkill, globalInstructionRepairs, goldenSetPath, governanceCommand, governanceLayers, harnessCommand, harnessRegistry, initCommand, initializeHarnesses, instructionRepairs, listGovernances, listMcpServers, listReferences, managedGovernancesDir, managedReferencesDir, overrideLayers, parseGovernanceName, parseReferenceName, referenceCommand, referenceLayers, renderDoctorSkill, resolveGovernance, resolveReference, run, searchReferences };
+export { activate, bridgeRepairs, buildDoctorReport, deprecatedManagedGovernancesDir, diagnoseBridges, diagnoseGlobalInstructions, diagnoseInstructions, diagnoseMcp, doctorCommand, doctorRepairs, doctorSkill, globalInstructionRepairs, goldenSetPath, governanceCommand, governanceLayers, harnessCommand, harnessRegistry, initCommand, initializeHarnesses, instructionRepairs, listGovernances, listMcpServers, listReferences, managedGovernancesDir, overrideLayers, parseGovernanceName, parseReferenceName, referenceCommand, referenceLayers, renderDoctorSkill, resolveGovernance, resolveReference, run, searchReferences };
 
 //# sourceMappingURL=index.mjs.map