opcrew 0.1.2 → 0.1.4

package/README.md

@@ -102,7 +102,7 @@ Publish the package and add it to your OpenCode config:
 
 ```json
 {
-  "plugin": ["opcrew@0.1.2"]
+  "plugin": ["opcrew"]
 }
 ```
 

package/dist/cli.js

@@ -7,7 +7,62 @@ import process from "process";
 // src/cli/install.ts
 import { mkdir, writeFile } from "fs/promises";
 import path from "path";
-
+// src/core/tools/translations.ts
+var CLAUDE_TOOLS = {
+  read: "Read",
+  write: "Write",
+  edit: "Edit",
+  glob: "Glob",
+  grep: "Grep",
+  execute: "Bash",
+  websearch: "WebSearch",
+  webfetch: "WebFetch",
+  delegate: "Agent",
+  todo: "TodoWrite",
+  test: "Bash",
+  logbook: "Edit",
+  skill: "Skill"
+};
+var OPENCODE_TOOLS = {
+  read: "read",
+  write: "write",
+  edit: "edit",
+  glob: "glob",
+  grep: "grep",
+  execute: "bash",
+  websearch: "web_search",
+  webfetch: "webfetch",
+  delegate: "task",
+  todo: "todowrite",
+  test: "run_tests",
+  logbook: "edit_logbook",
+  skill: "skill"
+};
+var CODEX_TOOLS = {
+  read: "read",
+  write: "write",
+  edit: "edit",
+  glob: "glob",
+  grep: "grep",
+  execute: "execute",
+  websearch: "web_search",
+  webfetch: "web_fetch",
+  delegate: "task",
+  todo: "todo",
+  test: "test",
+  logbook: "logbook",
+  skill: "skill"
+};
+function translateTools(canonicalTools, platform) {
+  const maps = {
+    claude: CLAUDE_TOOLS,
+    opencode: OPENCODE_TOOLS,
+    codex: CODEX_TOOLS
+  };
+  const translationMap = maps[platform];
+  const translated = canonicalTools.map((tool) => translationMap[tool]);
+  return [...new Set(translated)];
+}
 // src/core/Agent.ts
 class OpCrewAgent {
   config;
@@ -15,10 +70,12 @@ class OpCrewAgent {
     this.config = config;
   }
   compileToMarkdown() {
+    const translatedTools = translateTools(this.config.tools, "claude");
+    const lowerName = this.config.name.toLowerCase();
     const frontmatter = `---
-name: ${this.config.name}
-role: ${this.config.role}
-tools: [${this.config.tools.join(", ")}]
+name: ${lowerName}
+description: ${this.config.description}
+tools: [${translatedTools.join(", ")}]
 ---`;
     return `${frontmatter}
 ${this.buildMarkdownBody()}`;
@@ -39,6 +96,16 @@ permission:
   edit: ${permission.edit}
   bash: ${permission.bash}
   webfetch: ${permission.webfetch}
+---`;
+    return `${frontmatter}
+${this.buildMarkdownBody()}`;
+  }
+  compileToCodexMarkdown() {
+    const translatedTools = translateTools(this.config.tools, "codex");
+    const frontmatter = `---
+name: ${this.config.name}
+role: ${this.config.role}
+tools: [${translatedTools.join(", ")}]
 ---`;
     return `${frontmatter}
 ${this.buildMarkdownBody()}`;
@@ -59,6 +126,7 @@ Refer to \`.opcrew/logbook.json\` for the current voyage status.
 // src/crew/Captain.ts
 var Captain = new OpCrewAgent({
   name: "Captain",
+  description: "Orchestrator agent that coordinates work delegation and verification. Use for complex multi-step tasks requiring coordination between specialists.",
   role: "Orchestrator",
   mode: "primary",
   instructions: [
@@ -76,12 +144,13 @@ var Captain = new OpCrewAgent({
     "Knowledge discipline: require crew to read/update docs/knowledge (project map, glossary, relevant ADRs) for any decision or scope change.",
     "Ensure every material decision is captured as an ADR in docs/knowledge/decisions."
   ],
-  tools: ["read_fs", "edit_logbook", "task"]
+  tools: ["read", "logbook", "delegate"]
 });
 
 // src/crew/Navigator.ts
 var Navigator = new OpCrewAgent({
   name: "Navigator",
+  description: "Planning specialist that decomposes work into atomic tasks with clear inputs, outputs, and ownership. Use when you need to chart an implementation path or create a structured plan.",
   role: "Planner",
   mode: "subagent",
   instructions: [
@@ -97,12 +166,13 @@ var Navigator = new OpCrewAgent({
     "Define verification steps explicitly (diagnostics/tests/build) and include success evidence in the plan.",
     "Consult docs/knowledge before planning; update project-map/glossary/ADRs when scope or definitions change."
   ],
-  tools: ["read_fs", "web_search", "edit_logbook", "todowrite"]
+  tools: ["read", "websearch", "logbook", "todo"]
 });
 
 // src/crew/Boatswain.ts
 var Boatswain = new OpCrewAgent({
   name: "Boatswain",
+  description: "Execution specialist that implements approved plans with precise edits. Use when you need to make code changes, run tests, or execute implementation steps.",
   role: "Executor",
   mode: "subagent",
   instructions: [
@@ -113,14 +183,16 @@ var Boatswain = new OpCrewAgent({
     "Log completion status, assumptions, and blockers immediately for the Captain.",
     "Do not re-run delegated exploration; wait for Navigator findings before implementing dependent changes.",
     "Use verification gates: lsp diagnostics on touched files plus relevant tests/builds before completion.",
-    "Update docs/knowledge when execution changes assumptions, definitions, or operational steps."
+    "Update docs/knowledge when execution changes assumptions, definitions, or operational steps.",
+    "Update todo task status immediately upon completion of each task."
   ],
-  tools: ["read_fs", "edit_code", "run_tests"]
+  tools: ["read", "edit", "test", "todo"]
 });
 
 // src/crew/Quartermaster.ts
 var Quartermaster = new OpCrewAgent({
   name: "Quartermaster",
+  description: "Quality assurance specialist that reviews diffs, verifies tests pass, and ensures conventions are followed. Use proactively after code changes to verify quality.",
   role: "Reviewer",
   mode: "subagent",
   instructions: [
@@ -133,12 +205,13 @@ var Quartermaster = new OpCrewAgent({
     "Verify delegation protocol compliance when specialists were involved (task/outcome/tools/must-do/must-not/context).",
     "Reject approval if docs/knowledge changes are missing for material decisions or scope shifts."
   ],
-  tools: ["read", "grep", "bash", "write"]
+  tools: ["read", "grep", "execute", "write"]
 });
 
 // src/crew/Scout.ts
 var Scout = new OpCrewAgent({
   name: "Scout",
+  description: "Research specialist for external information gathering - web searches, documentation lookup, API references, and best practices. Use when you need information from outside the project.",
   role: "Researcher",
   mode: "subagent",
   instructions: [
@@ -153,7 +226,7 @@ var Scout = new OpCrewAgent({
     "If research reveals the task is more complex than expected, escalate to Navigator for replanning.",
     "Cache useful references in docs/knowledge for future crew reference."
   ],
-  tools: ["web_search", "web_fetch", "read_fs"]
+  tools: ["websearch", "webfetch", "read"]
 });
 
 // src/crew/index.ts
@@ -166,7 +239,7 @@ var crew = [
 ];
 
 // src/cli/install.ts
-var CLAUDE_DIR = path.join(".claudecode", "agents");
+var CLAUDE_DIR = path.join(".claude", "agents");
 var OPENCODE_DIR = path.join(".opencode", "agents");
 var CODEX_FILE = path.join(".codex", "instructions.md");
 async function ensureDir(targetDir) {
@@ -190,7 +263,7 @@ async function installToTool(tool) {
 async function installForCodex() {
   const codexDir = path.dirname(CODEX_FILE);
   await ensureDir(codexDir);
-  const compiled = crew.map((agent) => agent.compileToMarkdown()).join(`
+  const compiled = crew.map((agent) => agent.compileToCodexMarkdown()).join(`
 
 ---
 

package/dist/opencode-plugin.js

@@ -1,15 +1,74 @@
 // @bun
 var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
-
+// src/core/tools/translations.ts
+var CLAUDE_TOOLS = {
+  read: "Read",
+  write: "Write",
+  edit: "Edit",
+  glob: "Glob",
+  grep: "Grep",
+  execute: "Bash",
+  websearch: "WebSearch",
+  webfetch: "WebFetch",
+  delegate: "Agent",
+  todo: "TodoWrite",
+  test: "Bash",
+  logbook: "Edit",
+  skill: "Skill"
+};
+var OPENCODE_TOOLS = {
+  read: "read",
+  write: "write",
+  edit: "edit",
+  glob: "glob",
+  grep: "grep",
+  execute: "bash",
+  websearch: "web_search",
+  webfetch: "webfetch",
+  delegate: "task",
+  todo: "todowrite",
+  test: "run_tests",
+  logbook: "edit_logbook",
+  skill: "skill"
+};
+var CODEX_TOOLS = {
+  read: "read",
+  write: "write",
+  edit: "edit",
+  glob: "glob",
+  grep: "grep",
+  execute: "execute",
+  websearch: "web_search",
+  webfetch: "web_fetch",
+  delegate: "task",
+  todo: "todo",
+  test: "test",
+  logbook: "logbook",
+  skill: "skill"
+};
+function translateTools(canonicalTools, platform) {
+  const maps = {
+    claude: CLAUDE_TOOLS,
+    opencode: OPENCODE_TOOLS,
+    codex: CODEX_TOOLS
+  };
+  const translationMap = maps[platform];
+  const translated = canonicalTools.map((tool) => translationMap[tool]);
+  return [...new Set(translated)];
+}
 // src/core/Agent.ts
 class OpCrewAgent {
   config;
@@ -17,10 +76,12 @@ class OpCrewAgent {
     this.config = config;
   }
   compileToMarkdown() {
+    const translatedTools = translateTools(this.config.tools, "claude");
+    const lowerName = this.config.name.toLowerCase();
     const frontmatter = `---
-name: ${this.config.name}
-role: ${this.config.role}
-tools: [${this.config.tools.join(", ")}]
+name: ${lowerName}
+description: ${this.config.description}
+tools: [${translatedTools.join(", ")}]
 ---`;
     return `${frontmatter}
 ${this.buildMarkdownBody()}`;
@@ -41,6 +102,16 @@ permission:
   edit: ${permission.edit}
   bash: ${permission.bash}
   webfetch: ${permission.webfetch}
+---`;
+    return `${frontmatter}
+${this.buildMarkdownBody()}`;
+  }
+  compileToCodexMarkdown() {
+    const translatedTools = translateTools(this.config.tools, "codex");
+    const frontmatter = `---
+name: ${this.config.name}
+role: ${this.config.role}
+tools: [${translatedTools.join(", ")}]
 ---`;
     return `${frontmatter}
 ${this.buildMarkdownBody()}`;
@@ -61,6 +132,7 @@ Refer to \`.opcrew/logbook.json\` for the current voyage status.
 // src/crew/Captain.ts
 var Captain = new OpCrewAgent({
   name: "Captain",
+  description: "Orchestrator agent that coordinates work delegation and verification. Use for complex multi-step tasks requiring coordination between specialists.",
   role: "Orchestrator",
   mode: "primary",
   instructions: [
@@ -78,12 +150,13 @@ var Captain = new OpCrewAgent({
     "Knowledge discipline: require crew to read/update docs/knowledge (project map, glossary, relevant ADRs) for any decision or scope change.",
     "Ensure every material decision is captured as an ADR in docs/knowledge/decisions."
   ],
-  tools: ["read_fs", "edit_logbook", "task"]
+  tools: ["read", "logbook", "delegate"]
 });
 
 // src/crew/Navigator.ts
 var Navigator = new OpCrewAgent({
   name: "Navigator",
+  description: "Planning specialist that decomposes work into atomic tasks with clear inputs, outputs, and ownership. Use when you need to chart an implementation path or create a structured plan.",
   role: "Planner",
   mode: "subagent",
   instructions: [
@@ -99,12 +172,13 @@ var Navigator = new OpCrewAgent({
     "Define verification steps explicitly (diagnostics/tests/build) and include success evidence in the plan.",
     "Consult docs/knowledge before planning; update project-map/glossary/ADRs when scope or definitions change."
   ],
-  tools: ["read_fs", "web_search", "edit_logbook", "todowrite"]
+  tools: ["read", "websearch", "logbook", "todo"]
 });
 
 // src/crew/Boatswain.ts
 var Boatswain = new OpCrewAgent({
   name: "Boatswain",
+  description: "Execution specialist that implements approved plans with precise edits. Use when you need to make code changes, run tests, or execute implementation steps.",
   role: "Executor",
   mode: "subagent",
   instructions: [
@@ -115,14 +189,16 @@ var Boatswain = new OpCrewAgent({
     "Log completion status, assumptions, and blockers immediately for the Captain.",
     "Do not re-run delegated exploration; wait for Navigator findings before implementing dependent changes.",
     "Use verification gates: lsp diagnostics on touched files plus relevant tests/builds before completion.",
-    "Update docs/knowledge when execution changes assumptions, definitions, or operational steps."
+    "Update docs/knowledge when execution changes assumptions, definitions, or operational steps.",
+    "Update todo task status immediately upon completion of each task."
   ],
-  tools: ["read_fs", "edit_code", "run_tests"]
+  tools: ["read", "edit", "test", "todo"]
 });
 
 // src/crew/Quartermaster.ts
 var Quartermaster = new OpCrewAgent({
   name: "Quartermaster",
+  description: "Quality assurance specialist that reviews diffs, verifies tests pass, and ensures conventions are followed. Use proactively after code changes to verify quality.",
   role: "Reviewer",
   mode: "subagent",
   instructions: [
@@ -135,12 +211,13 @@ var Quartermaster = new OpCrewAgent({
     "Verify delegation protocol compliance when specialists were involved (task/outcome/tools/must-do/must-not/context).",
     "Reject approval if docs/knowledge changes are missing for material decisions or scope shifts."
   ],
-  tools: ["read", "grep", "bash", "write"]
+  tools: ["read", "grep", "execute", "write"]
 });
 
 // src/crew/Scout.ts
 var Scout = new OpCrewAgent({
   name: "Scout",
+  description: "Research specialist for external information gathering - web searches, documentation lookup, API references, and best practices. Use when you need information from outside the project.",
   role: "Researcher",
   mode: "subagent",
   instructions: [
@@ -155,7 +232,7 @@ var Scout = new OpCrewAgent({
     "If research reveals the task is more complex than expected, escalate to Navigator for replanning.",
     "Cache useful references in docs/knowledge for future crew reference."
   ],
-  tools: ["web_search", "web_fetch", "read_fs"]
+  tools: ["websearch", "webfetch", "read"]
 });
 
 // src/crew/index.ts
@@ -10251,10 +10328,10 @@ function _property(property, schema, params) {
     ...normalizeParams(params)
   });
 }
-function _mime(types, params) {
+function _mime(types2, params) {
   return new $ZodCheckMimeType({
     check: "mime_type",
-    mime: types,
+    mime: types2,
     ...normalizeParams(params)
   });
 }
@@ -12164,7 +12241,7 @@ var ZodFile = /* @__PURE__ */ $constructor("ZodFile", (inst, def) => {
   ZodType.init(inst, def);
   inst.min = (size, params) => inst.check(_minSize(size, params));
   inst.max = (size, params) => inst.check(_maxSize(size, params));
-  inst.mime = (types, params) => inst.check(_mime(Array.isArray(types) ? types : [types], params));
+  inst.mime = (types2, params) => inst.check(_mime(Array.isArray(types2) ? types2 : [types2], params));
 });
 function file(params) {
   return _file(ZodFile, params);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opcrew",
   "description": "OpenCrew agents and OpenCode plugin",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "main": "./dist/opencode-plugin.js",
   "module": "./dist/opencode-plugin.js",
   "type": "module",

package/dist/core/Agent.d.ts

@@ -1,14 +0,0 @@
-export interface AgentConfig {
-    name: string;
-    role: 'Orchestrator' | 'Planner' | 'Executor' | 'Reviewer' | 'Researcher';
-    mode: 'primary' | 'subagent';
-    instructions: string[];
-    tools: string[];
-}
-export declare class OpCrewAgent {
-    readonly config: AgentConfig;
-    constructor(config: AgentConfig);
-    compileToMarkdown(): string;
-    compileToOpenCodeMarkdown(): string;
-    private buildMarkdownBody;
-}

package/dist/crew/Boatswain.d.ts

@@ -1,2 +0,0 @@
-import { OpCrewAgent } from "../core/Agent";
-export declare const Boatswain: OpCrewAgent;

package/dist/crew/Captain.d.ts

@@ -1,2 +0,0 @@
-import { OpCrewAgent } from "../core/Agent";
-export declare const Captain: OpCrewAgent;

package/dist/crew/Navigator.d.ts

@@ -1,2 +0,0 @@
-import { OpCrewAgent } from "../core/Agent";
-export declare const Navigator: OpCrewAgent;

package/dist/crew/Quartermaster.d.ts

@@ -1,2 +0,0 @@
-import { OpCrewAgent } from "../core/Agent";
-export declare const Quartermaster: OpCrewAgent;

package/dist/crew/Scout.d.ts

@@ -1,2 +0,0 @@
-import { OpCrewAgent } from "../core/Agent";
-export declare const Scout: OpCrewAgent;

package/dist/crew/index.d.ts

@@ -1,7 +0,0 @@
-import { Captain } from "./Captain";
-import { Navigator } from "./Navigator";
-import { Boatswain } from "./Boatswain";
-import { Quartermaster } from "./Quartermaster";
-import { Scout } from "./Scout";
-export declare const crew: readonly [import("../core/Agent").OpCrewAgent, import("../core/Agent").OpCrewAgent, import("../core/Agent").OpCrewAgent, import("../core/Agent").OpCrewAgent, import("../core/Agent").OpCrewAgent];
-export { Captain, Navigator, Boatswain, Quartermaster, Scout };

package/dist/opencode-plugin.d.ts

@@ -1,3 +0,0 @@
-import type { Plugin } from "@opencode-ai/plugin";
-export declare const OpCrewPlugin: Plugin;
-export default OpCrewPlugin;

package/dist/tools/edit-logbook.d.ts

@@ -1,32 +0,0 @@
-export declare const editLogbookTool: {
-    description: string;
-    args: {
-        action: import("zod").ZodEnum<{
-            add: "add";
-            update: "update";
-            remove: "remove";
-            set_voyage: "set_voyage";
-        }>;
-        section: import("zod").ZodOptional<import("zod").ZodEnum<{
-            missions: "missions";
-            decisions: "decisions";
-            blockers: "blockers";
-            notes: "notes";
-        }>>;
-        id: import("zod").ZodOptional<import("zod").ZodString>;
-        data: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
-        voyage_status: import("zod").ZodOptional<import("zod").ZodEnum<{
-            idle: "idle";
-            active: "active";
-            blocked: "blocked";
-            completed: "completed";
-        }>>;
-    };
-    execute(args: {
-        action: "add" | "update" | "remove" | "set_voyage";
-        section?: "missions" | "decisions" | "blockers" | "notes" | undefined;
-        id?: string | undefined;
-        data?: Record<string, unknown> | undefined;
-        voyage_status?: "idle" | "active" | "blocked" | "completed" | undefined;
-    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
-};