buddy-agent-harness 0.17.0 → 0.19.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
 	"name": "buddy-agent-harness",
-	"version": "0.17.0",
+	"version": "0.19.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.17.0",
+	"version": "0.19.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.17.0",
+	"version": "0.19.0",
 	"description": "Initialize standards-based agent configuration across agent harnesses",
 	"author": {
 		"name": "repobuddy"

package/dist/cli.mjs

@@ -17958,6 +17958,12 @@ function skillsProjection(harness, scope, directories = skillsDirectories(harnes
 	return listed.includes(".agents/skills") ? {} : { skillsDirectory: first };
 }
 /**
+* The user-scope counterpart of the root `AGENTS.md`, relative to the home directory. No harness
+* reads it natively; each loads it only through a user-scope `instructionBridge` (E-CC-18, E-CODEX-05,
+* E-GEM-03, E-COPILOT-04, E-CUR-08).
+*/
+const globalInstructions = ".agents/AGENTS.md";
+/**
 * Skills directories come from `@cyberuni/agent-harness`, except for the harnesses it does not know
 * (`devin-desktop`, `windsurf`); see `.research/agentic-configuration-standards/` for the rest.
 */
@@ -17998,7 +18004,14 @@ const harnessRegistry = [
 		},
 		user: {
 			detect: ".claude",
-			...skillsProjection("claude-code", "user")
+			...skillsProjection("claude-code", "user"),
+			relocatedBy: "CLAUDE_CONFIG_DIR",
+			emptyRelocatesToStart: true,
+			instructionBridge: {
+				kind: "import",
+				path: ".claude/CLAUDE.md",
+				line: `@~/${globalInstructions}`
+			}
 		}
 	},
 	{
@@ -18060,7 +18073,13 @@ const harnessRegistry = [
 		},
 		user: {
 			detect: ".codex",
-			...skillsProjection("codex", "user")
+			...skillsProjection("codex", "user"),
+			instructionBridge: {
+				kind: "symlink",
+				path: ".codex/AGENTS.md"
+			},
+			shadowedBy: [".codex/AGENTS.override.md"],
+			relocatedBy: "CODEX_HOME"
 		}
 	},
 	{
@@ -18088,7 +18107,12 @@ const harnessRegistry = [
 		},
 		user: {
 			detect: ".copilot",
-			...skillsProjection("copilot-cli", "user")
+			...skillsProjection("copilot-cli", "user"),
+			relocatedBy: "COPILOT_HOME",
+			instructionBridge: {
+				kind: "symlink",
+				path: ".copilot/copilot-instructions.md"
+			}
 		}
 	},
 	{
@@ -18120,7 +18144,11 @@ const harnessRegistry = [
 		},
 		user: {
 			detect: ".gemini",
-			...skillsProjection("gemini-cli", "user")
+			...skillsProjection("gemini-cli", "user"),
+			instructionBridge: {
+				kind: "symlink",
+				path: ".gemini/GEMINI.md"
+			}
 		}
 	},
 	{
@@ -18328,6 +18356,69 @@ const instructionTable = {
 	}
 };
 repairsOf(instructionTable);
+const globalFile = `~/${globalInstructions}`;
+/**
+* The step that bridges one harness's user-scope file, in the words it is handed over in; `file` is
+* where it was found, which a variable such as `$CODEX_HOME` may have moved.
+*/
+function globalBridgeStep(bridge, file = `~/${bridge.path}`) {
+	return bridge.kind === "import" ? `add the line \`${bridge.line}\` to ${file}` : `run \`ln -s ${globalFile} ${file}\``;
+}
+/** Every spelling of a user-scope path a report can carry: from `~`, and from the variable that moves it. */
+function userSpellings(scope, path) {
+	const under = `${scope.detect}/`;
+	return scope.relocatedBy !== void 0 && path.startsWith(under) ? [`~/${path}`, `$${scope.relocatedBy}/${path.slice(under.length)}`] : [`~/${path}`];
+}
+/** The bridge for a reported path; undefined for a path no harness registers, such as a table's `<path>`. */
+function userBridgeAt(file) {
+	for (const { user } of harnessRegistry) {
+		const bridge = user?.instructionBridge;
+		if (user && bridge && userSpellings(user, bridge.path).includes(file)) return bridge;
+	}
+}
+/** The step for one reported file, or a pointer to where it is written when the path is not one. */
+function stepAt(file, keepContent) {
+	const bridge = userBridgeAt(file);
+	if (bridge === void 0) return `add the bridge the harness page names for ${file}`;
+	return `${keepContent && bridge.kind !== "import" ? `move what ${file} says into ${globalFile} and remove it, then ` : ""}${globalBridgeStep(bridge, file)}`;
+}
+/** Outside the repository, so never written: a repair is a step handed to the user. */
+const handOver = "hand the user this step, since nothing here writes outside the repository:";
+const globalInstructionTable = {
+	"global-instructions-missing": {
+		detail: `no user-scope instruction file at this path — the harness loads none of ${globalFile}`,
+		repair: ({ file }) => ({
+			command: "",
+			instruction: `${handOver} ${stepAt(file, false)}`
+		}),
+		skillRepair: () => "hand the user the step the harness page names for that file; write nothing yourself"
+	},
+	"global-instructions-unbridged": {
+		detail: `the file holds its own content and does not load ${globalFile} — text placed there reaches no session of this harness`,
+		repair: ({ file }) => ({
+			command: "",
+			instruction: `${handOver} ${stepAt(file, true)}`
+		}),
+		skillRepair: () => "hand the user the step the harness page names for that file, keeping what the file says; write nothing yourself"
+	},
+	"global-instructions-overridden": {
+		detail: `the harness reads this file in place of its own user-scope file, so whatever that file loads goes unread, and this one does not load ${globalFile}`,
+		repair: ({ file }) => ({
+			command: "",
+			instruction: `${handOver} move what ${file} says into ${globalFile} and remove it`
+		}),
+		skillRepair: () => "hand the user the move of what that file says into the global file, and its removal; write nothing yourself"
+	},
+	"global-instructions-emptied": {
+		detail: "the variable is set but empty, which this harness reads as the directory it starts in rather than as unset — its user-scope file is whichever one sits there, not the one in its own folder",
+		repair: ({ file }) => ({
+			command: "",
+			instruction: `${handOver} unset ${file.slice(1)} where your shell sets it, or set it to the folder you meant`
+		}),
+		skillRepair: () => "hand the user the step of unsetting that variable; write nothing yourself"
+	}
+};
+repairsOf(globalInstructionTable);
 const configurationTable = {
 	"deprecated-harness": {
 		detail: "a projection under a harness name that has been superseded — the replacement reads .agents/skills natively and needs no projection at all",
@@ -18504,6 +18595,7 @@ repairsOf(nonstandardTable);
 const doctorTable = {
 	...bridgeTable,
 	...instructionTable,
+	...globalInstructionTable,
 	...configurationTable,
 	...mcpTable,
 	...nonstandardTable
@@ -27649,7 +27741,7 @@ function projectChain(root) {
 		dir = parent;
 	}
 }
-function isDirectory$1(path) {
+function isDirectory$2(path) {
 	try {
 		return statSync(path).isDirectory();
 	} catch {
@@ -27685,7 +27777,7 @@ function dependencyLayers(root, skip) {
 		const dir = packageDir(pkg, manifestPath);
 		if (!dir || skip.has(canonical(dir))) continue;
 		const references = join(dir, "references");
-		if (!isDirectory$1(references)) continue;
+		if (!isDirectory$2(references)) continue;
 		const manifest = readJson(join(dir, "plugin.json"));
 		const manifestName = isRecord$1(manifest) && typeof manifest["name"] === "string" ? manifest["name"] : void 0;
 		const plugins = manifestName && manifestName !== pkg ? [pkg, manifestName] : [pkg];
@@ -27735,7 +27827,7 @@ async function referenceLayers({ root, home, platform, programData, packageRoot
 			plugins: self,
 			status: LEGACY_STATUS
 		},
-		...enabled.filter(({ dir, skipped }) => skipped || isDirectory$1(dir) && canonical(dirname(dir)) !== ownRoot),
+		...enabled.filter(({ dir, skipped }) => skipped || isDirectory$2(dir) && canonical(dirname(dir)) !== ownRoot),
 		...dependencyLayers(root, /* @__PURE__ */ new Set([ownRoot]))
 	];
 	const seen = /* @__PURE__ */ new Set();
@@ -27832,6 +27924,165 @@ function projectSkills({ root, canonicalSkills, harnesses, copy, force }) {
 	};
 }
 //#endregion
+//#region src/diagnose-bridges/diagnose-global-instructions.ts
+function isDirectory$1(path) {
+	try {
+		return lstatSync(path).isDirectory();
+	} catch {
+		return false;
+	}
+}
+function exists$1(path) {
+	try {
+		lstatSync(path);
+		return true;
+	} catch {
+		return false;
+	}
+}
+/** The import a user wrote may spell the home directory either way; both load the same file. */
+function importsGlobal(body, bridge, home) {
+	const spellings = bridge.kind === "import" ? [bridge.line, `@${join(home, globalInstructions)}`] : [];
+	return body.split("\n").some((line) => spellings.includes(line.trim()));
+}
+/**
+* Follows `relocatedBy` the way each harness does. An empty value is no value to Codex and Copilot CLI
+* (E-CODEX-06, E-COPILOT-06), and the directory Claude Code starts in to Claude Code (E-CC-20).
+*/
+function base(scope, env, start) {
+	const variable = scope.relocatedBy;
+	const value = variable === void 0 ? void 0 : env[variable];
+	if (variable === void 0 || value === void 0) return {};
+	if (value !== "") return { moved: {
+		root: resolve(value),
+		display: `$${variable}`
+	} };
+	return scope.emptyRelocatesToStart ? {
+		moved: {
+			root: start,
+			display: "."
+		},
+		emptied: variable
+	} : {};
+}
+function locate(home, scope, { moved }, path) {
+	if (!moved || path !== scope.detect && !path.startsWith(`${scope.detect}/`)) return {
+		absolute: join(home, path),
+		display: `~/${path}`
+	};
+	const rest = path.slice(scope.detect.length);
+	return {
+		absolute: join(moved.root, rest),
+		display: `${moved.display}${rest}`
+	};
+}
+/** A shadow is read only where it is a file holding more than whitespace (E-CODEX-06). */
+function readsAsShadow(path) {
+	try {
+		return statSync(path).isFile() && readFileSync(path, "utf8").trim() !== "";
+	} catch {
+		return false;
+	}
+}
+function inspect$1(home, target, bridge) {
+	let stats;
+	try {
+		stats = lstatSync(target);
+	} catch {
+		return {
+			kind: "none",
+			status: "missing",
+			problem: "global-instructions-missing"
+		};
+	}
+	if (stats.isSymbolicLink()) return resolve(dirname(target), readlinkSync(target)) === join(home, ".agents/AGENTS.md") ? {
+		kind: "symlink",
+		status: "ok"
+	} : {
+		kind: "symlink",
+		status: "unbridged",
+		problem: "global-instructions-unbridged"
+	};
+	let body;
+	try {
+		body = readFileSync(target, "utf8");
+	} catch {
+		return {
+			kind: "file",
+			status: "unbridged",
+			problem: "global-instructions-unbridged"
+		};
+	}
+	return importsGlobal(body, bridge, home) ? {
+		kind: "import",
+		status: "ok"
+	} : {
+		kind: "file",
+		status: "unbridged",
+		problem: "global-instructions-unbridged"
+	};
+}
+function finding(path, problem, cli) {
+	const { detail, repair } = repairFor(problem);
+	return {
+		path,
+		problem,
+		detail,
+		repair: repair({ file: path }, cli)
+	};
+}
+/**
+* Whether each harness the user has installed loads `~/.agents/AGENTS.md` through its own user-scope
+* file, read from wherever `env` moves it — `start`, for a harness that reads an empty variable as
+* the directory it starts in. Read-only: the repair is handed to the user, since nothing here
+* writes outside the repository.
+*/
+function diagnoseGlobalInstructions(home, preferred, cli, env = {}, start = process.cwd()) {
+	const hasGlobal = exists$1(join(home, globalInstructions));
+	const rows = [];
+	const findings = [];
+	for (const harness of harnessRegistry) {
+		const user = harness.user;
+		const bridge = user?.instructionBridge;
+		if (!user || !bridge) continue;
+		const moved = base(user, env, start);
+		if (!preferred.includes(harness.name) && !isDirectory$1(locate(home, user, moved, user.detect).absolute)) continue;
+		const file = locate(home, user, moved, bridge.path);
+		const inspection = inspect$1(home, file.absolute, bridge);
+		const shadow = (user.shadowedBy ?? []).map((path) => locate(home, user, moved, path)).find(({ absolute }) => readsAsShadow(absolute));
+		if (shadow !== void 0) {
+			const read = inspect$1(home, shadow.absolute, bridge);
+			if (read.status === "ok") {
+				rows.push({
+					harness: harness.name,
+					path: shadow.display,
+					kind: read.kind,
+					status: "ok"
+				});
+				continue;
+			}
+			rows.push({
+				harness: harness.name,
+				path: file.display,
+				kind: inspection.kind,
+				status: "overridden"
+			});
+			if (hasGlobal) findings.push(finding(shadow.display, "global-instructions-overridden", cli));
+		} else rows.push({
+			harness: harness.name,
+			path: file.display,
+			kind: inspection.kind,
+			status: inspection.status
+		});
+		if (hasGlobal && moved.emptied) findings.push(finding(`$${moved.emptied}`, "global-instructions-emptied", cli));
+		else if (hasGlobal && inspection.problem) findings.push(finding(file.display, inspection.problem, cli));
+	}
+	return {
+		globalInstructions: rows,
+		findings
+	};
+}
+//#endregion
 //#region src/diagnose-bridges/agents-files.ts
 /** Directories that never hold instructions this repository is responsible for bridging. */
 const pruned = /* @__PURE__ */ new Set(["node_modules"]);
@@ -27946,7 +28197,7 @@ function diagnoseInstructions(root, harnesses, cli) {
 	const bridged = harnesses.map((harness) => ({
 		name: harness.name,
 		bridge: harness.project.instructionBridge
-	})).filter((harness) => Boolean(harness.bridge));
+	})).filter((harness) => harness.bridge?.kind === "settings-entry");
 	const instructions = [];
 	const findings = [];
 	const directories = agentsFileDirectories(root);
@@ -28202,7 +28453,7 @@ function inspect(target, path, canonical, git) {
 * Read-only: nothing is created, moved, or repaired — the caller decides what to run from the
 * repair each finding carries.
 */
-function diagnoseBridges({ root, harnesses: preferred = [], cli }) {
+function diagnoseBridges({ root, harnesses: preferred = [], cli, home, env }) {
 	const canonical = join(root, ".agents", "skills");
 	const git = new GitBridgeState(root);
 	const selected = selectHarnesses(root, preferred);
@@ -28247,9 +28498,15 @@ function diagnoseBridges({ root, harnesses: preferred = [], cli }) {
 	}
 	const instructions = diagnoseInstructions(root, selected, cli);
 	findings.push(...instructions.findings);
+	const global = home === void 0 ? {
+		globalInstructions: [],
+		findings: []
+	} : diagnoseGlobalInstructions(home, preferred, cli, env, root);
+	findings.push(...global.findings);
 	return {
 		bridges,
 		instructions: instructions.instructions,
+		globalInstructions: global.globalInstructions,
 		divergence,
 		findings
 	};
@@ -28270,6 +28527,7 @@ function buildDoctorReport(bin, result, configuration = [], held = []) {
 			bin,
 			bridges: result.bridges,
 			instructions: result.instructions,
+			globalInstructions: result.globalInstructions,
 			references,
 			findings: `0 problems found — ${bridges} and the configuration around them is current`
 		};
@@ -28278,6 +28536,7 @@ function buildDoctorReport(bin, result, configuration = [], held = []) {
 		bin,
 		bridges: result.bridges,
 		instructions: result.instructions,
+		globalInstructions: result.globalInstructions,
 		references,
 		...result.divergence.length ? { divergence: result.divergence } : {},
 		findings: findings.map(({ path, problem, detail }) => ({
@@ -28290,7 +28549,7 @@ function buildDoctorReport(bin, result, configuration = [], held = []) {
 }
 const doctorCommand = command({
 	name: "doctor",
-	description: "Report whether this repository's harness bridges still resolve — skills into .agents/skills, instructions into AGENTS.md. Read-only.",
+	description: "Report whether this repository's harness bridges still resolve — skills into .agents/skills, instructions into AGENTS.md — and whether each harness's user-scope file loads ~/.agents/AGENTS.md. Read-only.",
 	options: {
 		root: {
 			description: "Repository or package directory. Defaults to the current directory.",
@@ -28315,7 +28574,9 @@ const doctorCommand = command({
 			const result = diagnoseBridges({
 				root,
 				...harnesses.length ? { harnesses } : {},
-				cli: commandInvocation
+				cli: commandInvocation,
+				home,
+				env: process.env
 			});
 			const git = new GitBridgeState(root);
 			const configuration = [

package/dist/index.d.mts

@@ -10,15 +10,28 @@ export declare function run(argv: string[]): Promise<number>;
 //#region src/harness-registry/instruction-bridge.d.ts
 /**
  * What a harness needs to read `AGENTS.md`; a union because the shape is per harness — Gemini CLI's
- * is a settings entry, and the next harness to need one may need a different shape.
+ * project bridge is a settings entry, Claude Code's user bridge an import line, and a harness with
+ * neither can only be given a symlink.
  */
 type InstructionBridge = {
   /** An `AGENTS.md` entry in an array inside a JSON settings file. */
   kind: "settings-entry";
-  /** Repository-relative path of the settings file. */
+  /** Path of the settings file, relative to the scope's root. */
   path: string;
   /** Dotted path to the array within it, as the harness documents it. */
   key: string;
+} | {
+  /** A line in the harness's own instruction file that pulls the canonical file in. */
+  kind: "import";
+  /** Path of the instruction file, relative to the scope's root. */
+  path: string;
+  /** The line itself, exactly as the harness documents the syntax. */
+  line: string;
+} | {
+  /** The harness's own instruction file, replaced by a symlink to the canonical file. */
+  kind: "symlink";
+  /** Path of the instruction file, relative to the scope's root. */
+  path: string;
 };
 //#endregion
 //#region src/diagnose-mcp/mcp-model.d.ts
@@ -88,6 +101,16 @@ type HarnessScope = {
   instructionBridge?: InstructionBridge;
   /** Files whose presence beside `AGENTS.md` stop the harness reading it. */
   shadowedBy?: readonly string[];
+  /**
+   * An environment variable that, set and non-empty, replaces the `detect` directory: every path
+   * under it is read from the variable's value instead.
+   */
+  relocatedBy?: string;
+  /**
+   * `relocatedBy` set to an empty string is read as the directory the harness starts in, rather
+   * than as unset.
+   */
+  emptyRelocatesToStart?: true;
   /** Where this harness keeps its own MCP servers; `doctor` compares against it and never writes. */
   mcpConfig?: McpConfig;
   /** What this harness reads that no other can, reported so it can be converted to canonical form. */
@@ -111,6 +134,37 @@ type Harness = {
  */
 export declare const harnessRegistry: readonly Harness[];
 //#endregion
+//#region src/diagnose-bridges/diagnose-global-instructions.d.ts
+/** What is at a harness's user-scope instruction file. */
+type GlobalInstructionKind = "import" | "symlink" | "file" | "none";
+/**
+ * `missing`: no file, so the harness loads no user instructions at all; `unbridged`: a file that
+ * loads its own content and not the global one; `overridden`: a file the harness reads in its place,
+ * such as Codex's `AGENTS.override.md`, that does not load the global one either.
+ */
+type GlobalInstructionStatus = "ok" | "missing" | "unbridged" | "overridden";
+type GlobalInstructionReport = {
+  harness: HarnessName;
+  /**
+   * The harness's user-scope instruction file, written from `~` so the report is publishable, or
+   * from the variable that moved it, such as `$CODEX_HOME`, or from `.` where an empty variable moved
+   * it to the directory the harness starts in.
+   */
+  path: string;
+  kind: GlobalInstructionKind;
+  status: GlobalInstructionStatus;
+};
+/**
+ * Whether each harness the user has installed loads `~/.agents/AGENTS.md` through its own user-scope
+ * file, read from wherever `env` moves it — `start`, for a harness that reads an empty variable as
+ * the directory it starts in. Read-only: the repair is handed to the user, since nothing here
+ * writes outside the repository.
+ */
+export declare function diagnoseGlobalInstructions(home: string, preferred: readonly HarnessName[], cli: string, env?: NodeJS.ProcessEnv, start?: string): {
+  globalInstructions: GlobalInstructionReport[];
+  findings: BridgeFinding[];
+};
+//#endregion
 //#region src/diagnose-bridges/diagnose-instructions.d.ts
 /** What is on disk where an instruction bridge belongs, or where a shadowing file may sit. */
 type InstructionKind = "import" | "symlink" | "settings-entry" | "file" | "none";
@@ -183,8 +237,10 @@ type McpProblem = "mcp-golden-unreadable" | "mcp-target-unreadable" | "mcp-unpro
 type NonstandardProblem = "nonstandard-instructions" | "nonstandard-rule" | "nonstandard-command" | "nonstandard-skill" | "nonstandard-subagent";
 /** Every way a harness can end up reading none of `AGENTS.md`. */
 type InstructionProblem = "no-instructions" | "instructions-missing" | "instructions-unbridged" | "instructions-unreadable" | "instructions-shadowing" | "instructions-superseded";
+/** Every way a harness's user-scope instruction file fails to load `~/.agents/AGENTS.md`. */
+type GlobalInstructionProblem = "global-instructions-missing" | "global-instructions-unbridged" | "global-instructions-overridden" | "global-instructions-emptied";
 /** Everything `doctor` can report against, across every section. */
-type DoctorProblem = BridgeProblem | InstructionProblem | ConfigurationFault | McpProblem | NonstandardProblem;
+type DoctorProblem = BridgeProblem | InstructionProblem | GlobalInstructionProblem | ConfigurationFault | McpProblem | NonstandardProblem;
 /** Alias kept for callers that name the whole set rather than one section. */
 type ConfigurationProblem = DoctorProblem;
 type RepairAction = {
@@ -210,6 +266,7 @@ type Repair = {
 };
 export declare const bridgeRepairs: readonly Repair[];
 export declare const instructionRepairs: readonly Repair[];
+export declare const globalInstructionRepairs: readonly Repair[];
 export declare const doctorRepairs: readonly Repair[];
 export declare const doctorSkill: {
   readonly name: "doctor-buddy-agent-harness";
@@ -289,6 +346,16 @@ type DiagnoseOptions = {
   harnesses?: HarnessName[];
   /** How to name this tool in the repair commands. */
   cli: string;
+  /**
+   * The home directory whose user-scope instruction files are checked for loading
+   * `~/.agents/AGENTS.md`; omitted, none are.
+   */
+  home?: string;
+  /**
+   * The environment the harnesses run in, for the variables that move their user-scope files —
+   * `CODEX_HOME`, `COPILOT_HOME`, `CLAUDE_CONFIG_DIR`; omitted, none is followed.
+   */
+  env?: NodeJS.ProcessEnv;
 };
 type DiagnoseResult = {
   bridges: BridgeReport[];
@@ -297,6 +364,8 @@ type DiagnoseResult = {
    * is never a command.
    */
   instructions: InstructionReport[];
+  /** One row per installed harness whose user-scope file can load `~/.agents/AGENTS.md`. */
+  globalInstructions: GlobalInstructionReport[];
   divergence: DivergenceReport[];
   findings: BridgeFinding[];
 };
@@ -304,7 +373,7 @@ type DiagnoseResult = {
  * Read-only: nothing is created, moved, or repaired — the caller decides what to run from the
  * repair each finding carries.
  */
-export declare function diagnoseBridges({ root, harnesses: preferred, cli }: DiagnoseOptions): DiagnoseResult;
+export declare function diagnoseBridges({ root, harnesses: preferred, cli, home, env }: DiagnoseOptions): DiagnoseResult;
 //#endregion
 //#region src/diagnose-configuration/diagnose-configuration.d.ts
 /**
@@ -438,6 +507,7 @@ type DoctorReport = {
   bin: string;
   bridges: DiagnoseResult["bridges"];
   instructions: DiagnoseResult["instructions"];
+  globalInstructions: DiagnoseResult["globalInstructions"];
   /**
    * References the managed, project, and user tiers hold, with the status `reference list` gives;
    * reported rather than diagnosed, since a reference is a choice, not a fault.
@@ -715,5 +785,5 @@ type ReferenceSearchReport = {
 };
 export declare const referenceCommand: cli$1.Command;
 //#endregion
-export type { BridgeFinding, BridgeKind, BridgeProblem, BridgeReport, BridgeStatus, ConfigurationFault, ConfigurationProblem, DiagnoseMcpOptions, DiagnoseOptions, DiagnoseResult, DivergenceDirection, DivergenceReport, DoctorProblem, DoctorReference, DoctorReport, GovernanceDocument, GovernanceEntry, GovernanceLayer, GovernanceListReport, GovernanceScope, GovernanceShowReport, Harness, HarnessName, HarnessScope, HarnessScopeName, InitializeOptions, InitializeResult, InstructionBridge, InstructionKind, InstructionProblem, InstructionReport, InstructionStatus, LayerOptions, ListMcpServersOptions, MatchKind, McpConfig, McpDirection, McpField, McpProblem, McpServer, McpServerEntry, McpTransport, MergeMode, ReferenceLayer, ReferenceLayerOptions, ReferenceListReport, ReferenceListing, ReferenceName, ReferenceRow, ReferenceSearchReport, ReferenceShowEntry, ReferenceStatus, ReferenceTier, Repair, ResolveOptions, ResolvedReference, SearchMatch, TraceEntry, UsedLayer };
+export type { BridgeFinding, BridgeKind, BridgeProblem, BridgeReport, BridgeStatus, ConfigurationFault, ConfigurationProblem, DiagnoseMcpOptions, DiagnoseOptions, DiagnoseResult, DivergenceDirection, DivergenceReport, DoctorProblem, DoctorReference, DoctorReport, GlobalInstructionKind, GlobalInstructionProblem, GlobalInstructionReport, GlobalInstructionStatus, GovernanceDocument, GovernanceEntry, GovernanceLayer, GovernanceListReport, GovernanceScope, GovernanceShowReport, Harness, HarnessName, HarnessScope, HarnessScopeName, InitializeOptions, InitializeResult, InstructionBridge, InstructionKind, InstructionProblem, InstructionReport, InstructionStatus, LayerOptions, ListMcpServersOptions, MatchKind, McpConfig, McpDirection, McpField, McpProblem, McpServer, McpServerEntry, McpTransport, MergeMode, ReferenceLayer, ReferenceLayerOptions, ReferenceListReport, ReferenceListing, ReferenceName, ReferenceRow, ReferenceSearchReport, ReferenceShowEntry, ReferenceStatus, ReferenceTier, Repair, ResolveOptions, ResolvedReference, SearchMatch, TraceEntry, UsedLayer };
 //# sourceMappingURL=index.d.mts.map

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-global-instructions.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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"}