buddy-agent-harness 0.2.0 → 0.3.1

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
 	"name": "buddy-agent-harness",
-	"version": "0.2.0",
-	"description": "Initialize standards-based agent configuration across coding-agent harnesses",
+	"version": "0.3.1",
+	"description": "Initialize standards-based agent configuration across agent harnesses",
 	"author": {
 		"name": "repobuddy"
 	},

package/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
 	"name": "buddy-agent-harness",
-	"version": "0.2.0",
-	"description": "Initialize standards-based agent configuration across coding-agent harnesses",
+	"version": "0.3.1",
+	"description": "Initialize standards-based agent configuration across agent harnesses",
 	"author": {
 		"name": "repobuddy"
 	},

package/.cursor-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
 	"name": "buddy-agent-harness",
-	"version": "0.2.0",
-	"description": "Initialize standards-based agent configuration across coding-agent harnesses",
+	"version": "0.3.1",
+	"description": "Initialize standards-based agent configuration across agent harnesses",
 	"author": {
 		"name": "repobuddy"
 	},

package/README.md

@@ -5,25 +5,29 @@
 [![npm](https://img.shields.io/npm/v/buddy-agent-harness)](https://www.npmjs.com/package/buddy-agent-harness)
 [![License](https://img.shields.io/npm/l/buddy-agent-harness)](LICENSE)
 
-An agent plugin and CLI for initializing or updating a consumer repository's standards-based agent configuration across coding-agent harnesses.
+An agent plugin and CLI for initializing or updating a consumer repository's standards-based agent configuration across agent harnesses.
 
 ## Install the plugin
 
-In Claude Code, add the marketplace and install the plugin and its `init` skill:
+In Claude Code, add the [cyberplace](https://github.com/cyberuni/cyberplace) marketplace and install the plugin and its `init` skill:
 
 ```text
-/plugin marketplace add repobuddy/buddy-agent-harness
-/plugin install buddy-agent-harness@repobuddy
+/plugin marketplace add cyberuni/cyberplace
+/plugin install buddy-agent-harness@cyberplace
 ```
 
 ## CLI
 
-Run the CLI without a global installation:
+`init` runs behind the `init` skill, which sorts the configuration you already wrote before the command links anything. Install the package alongside `repobuddy` to mount both commands on `buddy`, as `buddy agent-harness doctor` and `buddy agent-harness init`.
+
+The repository root's `AGENTS.md` and `.agents/` tree are canonical: `.agents/AGENTS.md` holds shared behavior, `.agents/skills/**/SKILL.md` holds capabilities, and separately named files hold tool settings. The active harness is enabled by default; explicit user preferences add others. The command preserves user-authored configuration and projects only supported mappings; it records nothing on disk.
+
+`init` takes `--root`, `--copy`, `--force`, and `--format`; `--help` lists them.
+
+`doctor` is the read-only counterpart, and the one command worth running without any of the above. It reports whether the bridges `init` created still resolve after a clone — the common failure being a Windows checkout with `core.symlinks=false`, where git writes a committed symlink out as a regular file and the harness silently loads no skills:
 
 ```sh
-npx -y buddy-agent-harness init
+npx -y buddy-agent-harness doctor
 ```
 
-The repository root's `AGENTS.md` and `.agents/` tree are canonical: `.agents/AGENTS.md` holds shared behavior, `.agents/skills/**/SKILL.md` holds capabilities, and separately named files hold tool settings. The active harness is enabled by default; explicit user preferences add others. The command preserves user-authored configuration and projects only supported mappings; it records nothing on disk.
-
-Use `buddy-agent-harness init --help` to see `--root`, `--copy`, `--force`, and `--format`.
+It never repairs anything and always exits `0`; each finding names the `init` command that fixes it.

package/dist/cli.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.mts","names":[],"sources":["../src/cli.ts"],"mappings":";iBAGsB,QAAQ"}
+{"version":3,"file":"cli.d.mts","names":[],"sources":["../src/cli.ts"],"mappings":";iBAIsB,QAAQ"}

package/dist/cli.mjs

@@ -1,4 +1,4 @@
-import { r as initCommand } from "./init.command-wxC4cgUc.mjs";
+import { a as doctorCommand, r as initCommand } from "./init.command-BN_w5DRZ.mjs";
 import { cli } from "clibuilder";
 //#region src/cli.ts
 async function main() {
@@ -8,7 +8,7 @@ async function main() {
 		description: "Initialize agent harness skill compatibility in consumer repositories."
 	});
 	try {
-		await app.command(initCommand).parse(process.argv);
+		await app.command(initCommand).command(doctorCommand).parse(process.argv);
 	} catch (error) {
 		process.stdout.write(`error: ${error instanceof Error ? error.message : "Invalid command."}\n`);
 		process.exitCode = 2;

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["import { cli } from 'clibuilder'\nimport { initCommand } from './initialize-harnesses/init.command.ts'\n\nexport async function main(): Promise<void> {\n\tconst app = cli({\n\t\tname: 'buddy-agent-harness',\n\t\tversion: '0.1.0',\n\t\tdescription: 'Initialize agent harness skill compatibility in consumer repositories.',\n\t})\n\ttry {\n\t\tawait app.command(initCommand).parse(process.argv)\n\t} catch (error) {\n\t\tprocess.stdout.write(`error: ${error instanceof Error ? error.message : 'Invalid command.'}\\n`)\n\t\tprocess.exitCode = 2\n\t}\n}\n"],"mappings":";;;AAGA,eAAsB,OAAsB;CAC3C,MAAM,MAAM,IAAI;EACf,MAAM;EACN,SAAS;EACT,aAAa;CACd,CAAC;CACD,IAAI;EACH,MAAM,IAAI,QAAQ,WAAW,CAAC,CAAC,MAAM,QAAQ,IAAI;CAClD,SAAS,OAAO;EACf,QAAQ,OAAO,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,mBAAmB,GAAG;EAC9F,QAAQ,WAAW;CACpB;AACD"}
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["import { cli } from 'clibuilder'\nimport { doctorCommand } from './diagnose-bridges/doctor.command.ts'\nimport { initCommand } from './initialize-harnesses/init.command.ts'\n\nexport async function main(): Promise<void> {\n\tconst app = cli({\n\t\tname: 'buddy-agent-harness',\n\t\tversion: '0.1.0',\n\t\tdescription: 'Initialize agent harness skill compatibility in consumer repositories.',\n\t})\n\ttry {\n\t\tawait app.command(initCommand).command(doctorCommand).parse(process.argv)\n\t} catch (error) {\n\t\tprocess.stdout.write(`error: ${error instanceof Error ? error.message : 'Invalid command.'}\\n`)\n\t\tprocess.exitCode = 2\n\t}\n}\n"],"mappings":";;;AAIA,eAAsB,OAAsB;CAC3C,MAAM,MAAM,IAAI;EACf,MAAM;EACN,SAAS;EACT,aAAa;CACd,CAAC;CACD,IAAI;EACH,MAAM,IAAI,QAAQ,WAAW,CAAC,CAAC,QAAQ,aAAa,CAAC,CAAC,MAAM,QAAQ,IAAI;CACzE,SAAS,OAAO;EACf,QAAQ,OAAO,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,mBAAmB,GAAG;EAC9F,QAAQ,WAAW;CACpB;AACD"}

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { cli } from "clibuilder";
+import { cli as cli$1 } from "clibuilder";
 //#region src/harness-registry/harness-registry.d.ts
 type HarnessName = "claude-code" | "cursor" | "codex" | "copilot-cli" | "gemini-cli" | "devin-desktop" | "windsurf";
 /**
@@ -24,9 +24,86 @@ type Harness = {
  */
 declare const harnessRegistry: readonly Harness[];
 //#endregion
+//#region src/diagnose-bridges/git-bridge-state.d.ts
+/** Which side of a diverged bridge moved since the last commit where the two agreed. */
+type DivergenceDirection = "bridge" | "canonical" | "both" | "unknown";
+//#endregion
+//#region src/diagnose-bridges/diagnose-bridges.d.ts
+type BridgeKind = "symlink" | "copy" | "file" | "none";
+type BridgeStatus = "ok" | "missing" | "degraded" | "stale" | "diverged";
+type BridgeReport = {
+  harness: HarnessName;
+  /** Repository-relative, as the harness registry declares it. */
+  path: string;
+  kind: BridgeKind;
+  status: BridgeStatus;
+};
+type BridgeFinding = {
+  path: string;
+  detail: string;
+  /** The command that repairs this finding, already carrying the bridge path. */
+  repair: string;
+};
+type DivergenceReport = {
+  path: string;
+  direction: DivergenceDirection;
+};
+type DiagnoseOptions = {
+  root: string;
+  harnesses?: HarnessName[];
+  /** How to name this tool in the repair commands. */
+  cli: string;
+};
+type DiagnoseResult = {
+  bridges: BridgeReport[];
+  divergence: DivergenceReport[];
+  findings: BridgeFinding[];
+};
+/**
+ * Reports whether every bridge `init` would create for this repository still resolves into
+ * `.agents/skills`. Read-only: nothing is created, moved, or repaired, so the caller decides what
+ * to run from the repair each finding carries.
+ */
+declare function diagnoseBridges({ root, harnesses: preferred, cli }: DiagnoseOptions): DiagnoseResult;
+//#endregion
+//#region src/diagnose-bridges/doctor.command.d.ts
+declare const doctorCommand: cli$1.Command;
+//#endregion
+//#region src/diagnose-bridges/doctor-guidance.d.ts
+/**
+ * The one place `doctor`'s guidance is written. The command reads `detail` and `repair` to fill its
+ * `findings` and `help` sections; `skills/doctor/SKILL.md` is generated from the same table by
+ * `scripts/generate-doctor-skill.ts`, so the shipped skill cannot drift from what the command says.
+ */
+/** Every way a bridge can fail, in the order `doctor` reports them. */
+type BridgeProblem = "no-canonical" | "missing" | "degraded" | "stale" | "diverged-bridge" | "diverged-canonical" | "diverged-both" | "diverged-unknown" | "unpinned-copy";
+type Repair = {
+  problem: BridgeProblem;
+  /** What `doctor` prints in the `findings` row for this problem. */
+  detail: string;
+  /**
+   * The command that fixes it, for `doctor`'s own output. `path` is the repository-relative bridge
+   * path; `cli` is how to invoke this tool.
+   */
+  repair(path: string, cli: string): string;
+  /**
+   * What the shipped skill tells an agent to do instead. A repair that rebuilds a bridge delegates
+   * to the `init` skill rather than calling the `init` command, because rebuilding can move
+   * user-authored skills and that judgment is the `init` skill's, not `doctor`'s.
+   */
+  skillRepair(path: string): string;
+};
+declare const doctorRepairs: readonly Repair[];
+declare const doctorSkill: {
+  readonly name: "doctor";
+  readonly description: "Use this skill when a repository loads no project skills, when skills are missing after a clone, or when checking whether the agent configuration bridges into .claude/skills and the other harness directories still resolve.";
+};
+/** The shipped `doctor` skill, rendered from the same table the command prints. */
+declare function renderDoctorSkill(): string;
+//#endregion
 //#region src/initialize-harnesses/init.command.d.ts
-declare const initCommand: cli.Command;
-declare const harnessCommand: cli.Command;
+declare const initCommand: cli$1.Command;
+declare const harnessCommand: cli$1.Command;
 declare function activate({ addCommand }: {
   addCommand(command: typeof harnessCommand): void;
 }): void;
@@ -53,5 +130,5 @@ type InitializeResult = {
 };
 declare function initializeHarnesses({ root, harnesses: preferred, copy, force }: InitializeOptions): InitializeResult;
 //#endregion
-export { type HarnessName, type InitializeOptions, type InitializeResult, activate, harnessCommand, harnessRegistry, initCommand, initializeHarnesses };
+export { type BridgeFinding, type BridgeKind, type BridgeProblem, type BridgeReport, type BridgeStatus, type DiagnoseOptions, type DiagnoseResult, type DivergenceDirection, type DivergenceReport, type HarnessName, type InitializeOptions, type InitializeResult, type Repair, activate, diagnoseBridges, doctorCommand, doctorRepairs, doctorSkill, harnessCommand, harnessRegistry, initCommand, initializeHarnesses, renderDoctorSkill };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/harness-registry/harness-registry.ts","../src/initialize-harnesses/init.command.ts","../src/initialize-harnesses/initialize-harnesses.ts"],"mappings":";;KAGY;;;;;KAaA;EACX,MAAM;EACN;EACA;;EAEA,aAAa;;;;;;;;;;;;cAaD,0BAA0B;;;cCxB1B,aAAa,IAAI;cAyDjB,gBAAgB,IAAI;iBAMjB,WAAW;EAAgB,WAAW,gBAAgB;;;;KCrE1D;EACX;EACA,YAAY;EACZ;EACA;;KAEW;EACX;EACA,WAAW;EACX,QAAQ;EACR,QAAQ;;EAER;IAAc,MAAM;IAAa,YAAY;;EAC7C;EACA;;iBAGe,sBACf,MACA,WAAW,WACX,MACA,SACE,oBAAoB"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/harness-registry/harness-registry.ts","../src/diagnose-bridges/git-bridge-state.ts","../src/diagnose-bridges/diagnose-bridges.ts","../src/diagnose-bridges/doctor.command.ts","../src/diagnose-bridges/doctor-guidance.ts","../src/initialize-harnesses/init.command.ts","../src/initialize-harnesses/initialize-harnesses.ts"],"mappings":";;KAGY;;;;;KAaA;EACX,MAAM;EACN;EACA;;EAEA,aAAa;;;;;;;;;;;;cAaD,0BAA0B;;;;KC7B3B;;;KCEA;KACA;KAEA;EACX,SAAS;;EAET;EACA,MAAM;EACN,QAAQ;;KAGG;EACX;EACA;;EAEA;;KAGW;EACX;EACA,WAAW;;KAGA;EACX;EACA,YAAY;;EAEZ;;KAGW;EACX,SAAS;EACT,YAAY;EACZ,UAAU;;;;;;;iBA8EK,kBAAkB,MAAM,WAAW,WAAgB,OAAO,kBAAkB;;;cC7E/E,eAAe,MAAI;;;;;;;;;KClCpB;KAWA;EACX,SAAS;;EAET;;;;;EAKA,OAAO,cAAc;;;;;;EAMrB,YAAY;;cASA,wBAAwB;cAmExB;WACZ;WACA;;;iBASe;;;cChHH,aAAa,MAAI;cA0DjB,gBAAgB,MAAI;iBAMjB,WAAW;EAAgB,WAAW,gBAAgB;;;;KCnE1D;EACX;EACA,YAAY;EACZ;EACA;;KAEW;EACX;EACA,WAAW;EACX,QAAQ;EACR,QAAQ;;EAER;IAAc,MAAM;IAAa,YAAY;;EAC7C;EACA;;iBAGe,sBACf,MACA,WAAW,WACX,MACA,SACE,oBAAoB"}

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { a as harnessRegistry, i as initializeHarnesses, n as harnessCommand, r as initCommand, t as activate } from "./init.command-wxC4cgUc.mjs";
-export { activate, harnessCommand, harnessRegistry, initCommand, initializeHarnesses };
+import { a as doctorCommand, c as doctorSkill, i as initializeHarnesses, l as renderDoctorSkill, n as harnessCommand, o as diagnoseBridges, r as initCommand, s as doctorRepairs, t as activate, u as harnessRegistry } from "./init.command-BN_w5DRZ.mjs";
+export { activate, diagnoseBridges, doctorCommand, doctorRepairs, doctorSkill, harnessCommand, harnessRegistry, initCommand, initializeHarnesses, renderDoctorSkill };