buddy-agent-harness 0.18.0 → 0.19.0

package/.claude-plugin/plugin.json

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

package/dist/cli.mjs

@@ -18006,6 +18006,7 @@ const harnessRegistry = [
 			detect: ".claude",
 			...skillsProjection("claude-code", "user"),
 			relocatedBy: "CLAUDE_CONFIG_DIR",
+			emptyRelocatesToStart: true,
 			instructionBridge: {
 				kind: "import",
 				path: ".claude/CLAUDE.md",
@@ -18407,6 +18408,14 @@ const globalInstructionTable = {
 			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);
@@ -27936,18 +27945,35 @@ 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 the harnesses do: an empty value is no value (E-CODEX-06, E-CC-19, E-COPILOT-05). */
-function locate(home, scope, env, path) {
+/**
+* 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 moved = variable === void 0 ? void 0 : env[variable];
+	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(resolve(moved), rest),
-		display: `$${variable}${rest}`
+		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). */
@@ -28007,10 +28033,11 @@ function finding(path, problem, cli) {
 }
 /**
 * Whether each harness the user has installed loads `~/.agents/AGENTS.md` through its own user-scope
-* file, read from wherever `env` moves it. Read-only: the repair is handed to the user, since
-* nothing here writes outside the repository.
+* 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 = {}) {
+function diagnoseGlobalInstructions(home, preferred, cli, env = {}, start = process.cwd()) {
 	const hasGlobal = exists$1(join(home, globalInstructions));
 	const rows = [];
 	const findings = [];
@@ -28018,10 +28045,11 @@ function diagnoseGlobalInstructions(home, preferred, cli, env = {}) {
 		const user = harness.user;
 		const bridge = user?.instructionBridge;
 		if (!user || !bridge) continue;
-		if (!preferred.includes(harness.name) && !isDirectory$1(locate(home, user, env, user.detect).absolute)) continue;
-		const file = locate(home, user, env, bridge.path);
+		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, env, path)).find(({ absolute }) => readsAsShadow(absolute));
+		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") {
@@ -28046,7 +28074,8 @@ function diagnoseGlobalInstructions(home, preferred, cli, env = {}) {
 			kind: inspection.kind,
 			status: inspection.status
 		});
-		if (hasGlobal && inspection.problem) findings.push(finding(file.display, inspection.problem, cli));
+		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,
@@ -28472,7 +28501,7 @@ function diagnoseBridges({ root, harnesses: preferred = [], cli, home, env }) {
 	const global = home === void 0 ? {
 		globalInstructions: [],
 		findings: []
-	} : diagnoseGlobalInstructions(home, preferred, cli, env);
+	} : diagnoseGlobalInstructions(home, preferred, cli, env, root);
 	findings.push(...global.findings);
 	return {
 		bridges,

package/dist/index.d.mts

@@ -106,6 +106,11 @@ type HarnessScope = {
    * 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. */
@@ -142,7 +147,8 @@ 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`.
+   * 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;
@@ -150,10 +156,11 @@ type GlobalInstructionReport = {
 };
 /**
  * Whether each harness the user has installed loads `~/.agents/AGENTS.md` through its own user-scope
- * file, read from wherever `env` moves it. Read-only: the repair is handed to the user, since
- * nothing here writes outside the repository.
+ * 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): {
+export declare function diagnoseGlobalInstructions(home: string, preferred: readonly HarnessName[], cli: string, env?: NodeJS.ProcessEnv, start?: string): {
   globalInstructions: GlobalInstructionReport[];
   findings: BridgeFinding[];
 };
@@ -231,7 +238,7 @@ type NonstandardProblem = "nonstandard-instructions" | "nonstandard-rule" | "non
 /** 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";
+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 | GlobalInstructionProblem | ConfigurationFault | McpProblem | NonstandardProblem;
 /** Alias kept for callers that name the whole set rather than one section. */

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-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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"}
+{"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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"}

package/dist/index.mjs

@@ -622,6 +622,7 @@ const harnessRegistry = [
 			detect: ".claude",
 			...skillsProjection("claude-code", "user"),
 			relocatedBy: "CLAUDE_CONFIG_DIR",
+			emptyRelocatesToStart: true,
 			instructionBridge: {
 				kind: "import",
 				path: ".claude/CLAUDE.md",
@@ -1031,6 +1032,14 @@ const globalInstructionTable = {
 			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"
 	}
 };
 const globalInstructionRepairs = repairsOf(globalInstructionTable);
@@ -3086,18 +3095,35 @@ 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 the harnesses do: an empty value is no value (E-CODEX-06, E-CC-19, E-COPILOT-05). */
-function locate(home, scope, env, path) {
+/**
+* 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 moved = variable === void 0 ? void 0 : env[variable];
+	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(resolve(moved), rest),
-		display: `$${variable}${rest}`
+		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). */
@@ -3157,10 +3183,11 @@ function finding(path, problem, cli) {
 }
 /**
 * Whether each harness the user has installed loads `~/.agents/AGENTS.md` through its own user-scope
-* file, read from wherever `env` moves it. Read-only: the repair is handed to the user, since
-* nothing here writes outside the repository.
+* 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 = {}) {
+function diagnoseGlobalInstructions(home, preferred, cli, env = {}, start = process.cwd()) {
 	const hasGlobal = exists$1(join(home, globalInstructions));
 	const rows = [];
 	const findings = [];
@@ -3168,10 +3195,11 @@ function diagnoseGlobalInstructions(home, preferred, cli, env = {}) {
 		const user = harness.user;
 		const bridge = user?.instructionBridge;
 		if (!user || !bridge) continue;
-		if (!preferred.includes(harness.name) && !isDirectory$1(locate(home, user, env, user.detect).absolute)) continue;
-		const file = locate(home, user, env, bridge.path);
+		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, env, path)).find(({ absolute }) => readsAsShadow(absolute));
+		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") {
@@ -3196,7 +3224,8 @@ function diagnoseGlobalInstructions(home, preferred, cli, env = {}) {
 			kind: inspection.kind,
 			status: inspection.status
 		});
-		if (hasGlobal && inspection.problem) findings.push(finding(file.display, inspection.problem, cli));
+		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,
@@ -3622,7 +3651,7 @@ function diagnoseBridges({ root, harnesses: preferred = [], cli, home, env }) {
 	const global = home === void 0 ? {
 		globalInstructions: [],
 		findings: []
-	} : diagnoseGlobalInstructions(home, preferred, cli, env);
+	} : diagnoseGlobalInstructions(home, preferred, cli, env, root);
 	findings.push(...global.findings);
 	return {
 		bridges,