bros-harness 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.3 - 2026-06-03
+
+- Fixed OpenCode 1.15 plugin loading by exporting the V1 plugin module shape with `id` and `server`.
+
+## 0.1.2 - 2026-06-03
+
+- Added package plugin agent registration so raw OpenCode installs can load BROS agents from `plugin: ["bros-harness"]`.
+
 ## 0.1.1 - 2026-06-03
 
 - Fixed npm CLI bin packaging posture for `bros` by ensuring the packaged `bin/bros.mjs` entry is executable with a valid Node shebang.

package/README.md

@@ -116,6 +116,7 @@ The package plugin is intentionally narrow.
 On load, it verifies packaged asset directories and uses OpenCode’s in-memory `config(cfg)` hook to add only:
 
 - the package-relative BROS skills directory to `skills.paths`, when the existing field has the expected safe shape; and
+- packaged BROS agent entries to `agent`, without overwriting existing agent keys; and
 - packaged command prompt entries to `command`, without overwriting existing command keys.
 
 It does **not**:
@@ -125,11 +126,11 @@ It does **not**:
 - publish packages;
 - register providers;
 - add MCP servers;
-- change permissions;
+- change top-level permissions;
 - configure telemetry;
 - read, validate, or write secrets.
 
-Packaged agent files are included as reviewed assets, but they are not auto-registered by the default plugin hook because permission-bearing agent registration should remain an explicit, reviewed configuration decision.
+Packaged agent files are registered from reviewed assets so a package-only OpenCode install can expose BROS agents without copying local files.
 
 Three skipped raw skills remain excluded pending separate sanitized review. They are not imported by this package.
 

package/docs/integrations/opencode.md

@@ -24,9 +24,9 @@ This is the preferred path for users and agents. Local path examples are contrib
 
 ## Runtime behavior
 
-The package plugin resolves assets relative to its own package root. It validates key asset directories, then uses OpenCode's in-memory `config(cfg)` hook only to add the package-relative skills directory to `skills.paths` when safe and add packaged command prompt entries without overwriting existing commands.
+The package plugin resolves assets relative to its own package root. It validates key asset directories, then uses OpenCode's in-memory `config(cfg)` hook to add the package-relative skills directory to `skills.paths` when safe, register packaged agent entries without overwriting existing agents, and add packaged command prompt entries without overwriting existing commands.
 
-This runtime hook changes only the merged config object OpenCode passes to the plugin at startup. It is distinct from live user config file mutation: the plugin does not write `opencode.json`, `.opencode/`, global config files, or other filesystem config. The plugin does not register providers, MCP servers, permissions, telemetry, or secrets. Agent files are packaged as reviewed assets, but permission-bearing agent registration is intentionally not performed by the default plugin hook.
+This runtime hook changes only the merged config object OpenCode passes to the plugin at startup. It is distinct from live user config file mutation: the plugin does not write `opencode.json`, `.opencode/`, global OpenCode config files, or other filesystem config. The plugin does not register providers, MCP servers, top-level permissions, telemetry, or secrets.
 
 ## Safe agent workflow
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bros-harness",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Package-first OpenCode plugin for disciplined BROS agent harness assets.",
   "license": "MIT",
   "type": "module",

package/src/plugin.mjs

@@ -43,6 +43,80 @@ function parseCommandMarkdown(markdown) {
   };
 }
 
+function parseYamlScalar(value) {
+  const trimmed = value.trim();
+  if (trimmed === "") return "";
+  if (trimmed === "true") return true;
+  if (trimmed === "false") return false;
+  if ((trimmed.startsWith('"') && trimmed.endsWith('"')) || (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+    return trimmed.slice(1, -1);
+  }
+  return trimmed;
+}
+
+function parseSimpleYamlObject(yaml) {
+  const root = {};
+  const stack = [{ indent: -1, value: root }];
+
+  for (const rawLine of yaml.split("\n")) {
+    if (!rawLine.trim() || rawLine.trim().startsWith("#")) continue;
+
+    const indent = rawLine.match(/^ */)?.[0].length ?? 0;
+    const line = rawLine.trim();
+    const match = line.match(/^(.+?):(?:\s*(.*))?$/);
+    if (!match) continue;
+
+    const key = match[1].trim().replace(/^['"]|['"]$/g, "");
+    const rawValue = match[2] ?? "";
+
+    while (stack.length > 1 && indent <= stack[stack.length - 1].indent) {
+      stack.pop();
+    }
+
+    const parent = stack[stack.length - 1].value;
+    if (rawValue === "") {
+      parent[key] = {};
+      stack.push({ indent, value: parent[key] });
+    } else {
+      parent[key] = parseYamlScalar(rawValue);
+    }
+  }
+
+  return root;
+}
+
+function parseAgentMarkdown(markdown) {
+  const match = markdown.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+  if (!match) return null;
+
+  const frontmatter = parseSimpleYamlObject(match[1]);
+  const { name, ...agent } = frontmatter;
+  if (!name) return null;
+
+  return {
+    name,
+    agent: {
+      ...agent,
+      prompt: match[2].trim()
+    }
+  };
+}
+
+async function loadPackagedAgents() {
+  const files = (await readdir(brosHarness.agentsDir))
+    .filter((file) => file.endsWith(".md"))
+    .filter((file) => file !== "README.md")
+    .sort();
+
+  const agents = {};
+  for (const file of files) {
+    const markdown = await readFile(join(brosHarness.agentsDir, file), "utf8");
+    const parsed = parseAgentMarkdown(markdown);
+    if (parsed) agents[parsed.name] = parsed.agent;
+  }
+  return agents;
+}
+
 async function loadPackagedCommands() {
   const files = (await readdir(brosHarness.commandsDir))
     .filter((file) => file.endsWith(".md"))
@@ -85,14 +159,32 @@ function mergeCommands(cfg, commands) {
   }
 }
 
-export default async function brosHarnessPlugin(_input = {}, _options = {}) {
+function mergeAgents(cfg, agents) {
+  if (cfg.agent !== undefined && (cfg.agent === null || typeof cfg.agent !== "object" || Array.isArray(cfg.agent))) {
+    return;
+  }
+
+  cfg.agent ??= {};
+  for (const [name, agent] of Object.entries(agents)) {
+    cfg.agent[name] ??= agent;
+  }
+}
+
+export async function brosHarnessServer(_input = {}, _options = {}) {
   await verifyBrosHarnessAssets();
+  const agents = await loadPackagedAgents();
   const commands = await loadPackagedCommands();
 
   return {
     config(cfg) {
       mergeSkillsPath(cfg);
+      mergeAgents(cfg, agents);
       mergeCommands(cfg, commands);
     }
   };
 }
+
+export default {
+  id: "bros-harness",
+  server: brosHarnessServer
+};