buddy-agent-harness 0.1.0 → 0.3.0

package/.claude-plugin/plugin.json

@@ -1,10 +1,11 @@
 {
 	"name": "buddy-agent-harness",
-	"version": "0.1.0",
+	"version": "0.3.0",
 	"description": "Initialize standards-based agent configuration across coding-agent harnesses",
 	"author": {
 		"name": "repobuddy"
 	},
+	"homepage": "https://github.com/repobuddy/buddy-agent-harness",
 	"repository": "https://github.com/repobuddy/buddy-agent-harness",
 	"license": "MIT",
 	"keywords": ["agent", "skills", "harness", "claude-code", "codex"],

package/.codex-plugin/plugin.json

@@ -1,10 +1,11 @@
 {
 	"name": "buddy-agent-harness",
-	"version": "0.1.0",
+	"version": "0.3.0",
 	"description": "Initialize standards-based agent configuration across coding-agent harnesses",
 	"author": {
 		"name": "repobuddy"
 	},
+	"homepage": "https://github.com/repobuddy/buddy-agent-harness",
 	"repository": "https://github.com/repobuddy/buddy-agent-harness",
 	"license": "MIT",
 	"keywords": ["agent", "skills", "harness", "claude-code", "codex"],

package/.cursor-plugin/plugin.json

@@ -1,10 +1,11 @@
 {
 	"name": "buddy-agent-harness",
-	"version": "0.1.0",
+	"version": "0.3.0",
 	"description": "Initialize standards-based agent configuration across coding-agent harnesses",
 	"author": {
 		"name": "repobuddy"
 	},
+	"homepage": "https://github.com/repobuddy/buddy-agent-harness",
 	"repository": "https://github.com/repobuddy/buddy-agent-harness",
 	"license": "MIT",
 	"keywords": ["agent", "skills", "harness", "claude-code", "codex"],

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright © 2022 Homa Wong (unional) (homawong@gmail.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -9,29 +9,25 @@ An agent plugin and CLI for initializing or updating a consumer repository's sta
 
 ## Install the plugin
 
-Install the portable plugin and its `init` skill with `npx skills`:
+In Claude Code, add the [cyberplace](https://github.com/cyberuni/cyberplace) marketplace and install the plugin and its `init` skill:
 
-```sh
-npx skills add repobuddy/buddy-agent-harness --plugin
+```text
+/plugin marketplace add cyberuni/cyberplace
+/plugin install buddy-agent-harness@cyberplace
 ```
 
-In Claude Code, add the marketplace and install the plugin:
+## CLI
 
-```text
-/plugin marketplace add repobuddy/buddy-agent-harness
-/plugin install buddy-agent-harness@repobuddy
-```
+`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`.
 
-Other agent clients can install the same repository through their plugin marketplace or use the `npx skills` command above.
+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.
 
-## CLI
+`init` takes `--root`, `--copy`, `--force`, and `--format`; `--help` lists them.
 
-After the npm package is published, run the CLI without a global installation:
+`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 };