opcrew 0.1.5 → 0.1.7

package/dist/cli.js

@@ -5,7 +5,7 @@
 import process from "process";
 
 // src/cli/install.ts
-import { mkdir, writeFile, cp, rm } from "fs/promises";
+import { mkdir, writeFile, cp, rm, stat } from "fs/promises";
 import path2 from "path";
 // src/core/tools/translations.ts
 var CLAUDE_TOOLS = {
@@ -94,7 +94,7 @@ description: ${this.config.description}
 tools: [${translatedTools.join(", ")}]
 ---`;
     return `${frontmatter}
-${this.buildMarkdownBody()}`;
+${this.buildMarkdownBody("claude")}`;
   }
   compileToOpenCodeMarkdown() {
     const permissionByRole = {
@@ -114,7 +114,7 @@ permission:
   webfetch: ${permission.webfetch}
 ---`;
     return `${frontmatter}
-${this.buildMarkdownBody()}`;
+${this.buildMarkdownBody("opencode")}`;
   }
   compileToCodexMarkdown() {
     const translatedTools = translateTools(this.getAllowedTools(), "codex");
@@ -124,13 +124,23 @@ role: ${this.config.role}
 tools: [${translatedTools.join(", ")}]
 ---`;
     return `${frontmatter}
-${this.buildMarkdownBody()}`;
+${this.buildMarkdownBody("codex")}`;
   }
-  buildMarkdownBody() {
+  buildToolBoundary(platform) {
+    const translatedTools = translateTools(this.getAllowedTools(), platform);
+    if (translatedTools.length === 0) {
+      return "TOOL BOUNDARY: No tools are available for this agent on this platform.";
+    }
+    const toolList = translatedTools.join(", ");
+    return `TOOL BOUNDARY: You are ONLY permitted to use these tools: ${toolList}. Using any other tool is a violation.`;
+  }
+  buildMarkdownBody(platform) {
+    const toolBoundary = this.buildToolBoundary(platform);
     const instructionsList = this.config.instructions.map((instruction) => `- ${instruction}`).join(`
 `);
     return `
 # ${this.config.name}
+- ${toolBoundary}
 ${instructionsList}
 
 ## Shared Context
@@ -146,7 +156,6 @@ var Captain = new OpCrewAgent({
   role: "Orchestrator",
   mode: "primary",
   instructions: [
-    "TOOL BOUNDARY: You are ONLY permitted to use these tools: read, logbook, delegate, skill. Using any other tool is a violation.",
     "You are the orchestrator - you NEVER execute work directly. Your role is to coordinate, delegate, and verify.",
     "Workstream Fan-out: divide missions into independent Workstreams (e.g., Logic, Testing, Documentation) to enable parallel specialists.",
     "Assign roles in order: Navigator plans, Boatswain executes, Quartermaster reviews; resolve conflicts quickly.",
@@ -171,7 +180,6 @@ var Navigator = new OpCrewAgent({
   role: "Planner",
   mode: "subagent",
   instructions: [
-    "TOOL BOUNDARY: You are ONLY permitted to use these tools: read, websearch, logbook, todo, skill. Using any other tool is a violation.",
     "Chart the implementation path based on the Captain's intent and constraints.",
     "Decompose work into atomic, ordered tasks with clear inputs, outputs, and ownership.",
     "Workstream Decomposition: break the plan into atomic, parallel tracks. Define File Ownership (e.g., Boatswain-A owns src/, Boatswain-B owns tests/).",
@@ -200,7 +208,6 @@ var Boatswain = new OpCrewAgent({
   role: "Executor",
   mode: "subagent",
   instructions: [
-    "TOOL BOUNDARY: You are ONLY permitted to use these tools: read, edit, write, test, todo, glob, grep, skill. Using any other tool is a violation.",
     "Scope Guarding: ONLY touch files assigned to your Workstream ID. If you must edit a file owned by another agent, escalate to Captain for a plan revision.",
     "Follow existing patterns, naming, and formatting; avoid speculative changes.",
     "Context Anchoring: before editing, read the surrounding code to match indentation, casing, and comment styles. Maintain the project's local laws.",
@@ -223,7 +230,6 @@ var Quartermaster = new OpCrewAgent({
   role: "Reviewer",
   mode: "subagent",
   instructions: [
-    "TOOL BOUNDARY: You are ONLY permitted to use these tools: read, grep, execute, write, skill. Using any other tool is a violation.",
     "Inspect each diff for regression risks, scope drift, and missing context.",
     "Integration Audit: once all parallel Boatswains report Complete, verify the combined diff for logic conflicts or signature mismatches.",
     "Documentation Gate: REJECT approval if code changed but docs/project-map.md or docs/glossary.md were not updated to reflect the new state.",
@@ -246,7 +252,6 @@ var Scout = new OpCrewAgent({
   role: "Researcher",
   mode: "subagent",
   instructions: [
-    "TOOL BOUNDARY: You are ONLY permitted to use these tools: websearch, webfetch, read, skill. Using any other tool is a violation.",
     "You are the crew's eyes to the outside world - research and gather information when summoned by Captain or Navigator.",
     "Focus exclusively on external research: web searches, documentation lookup, API references, and best practices.",
     "Never modify project files - your job is to gather intelligence, not execute changes.",
@@ -333,10 +338,70 @@ var CLAUDE_SKILLS_DIR = path2.join(".claude", "skills");
 var OPENCODE_AGENTS_DIR = path2.join(".opencode", "agents");
 var OPENCODE_SKILLS_DIR = path2.join(".opencode", "skills");
 var CODEX_FILE = path2.join(".codex", "instructions.md");
+var OPCREW_DIR = ".opcrew";
+var KNOWLEDGE_DIR = path2.join("docs", "knowledge");
+var TEMPLATE_DIR = path2.join(import.meta.dir, "..", "templates");
 async function ensureDir(targetDir) {
   await mkdir(targetDir, { recursive: true });
 }
+async function fileExists(filePath) {
+  try {
+    await stat(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function bootstrapLogbook() {
+  const logbookPath = path2.join(OPCREW_DIR, "logbook.json");
+  const schemaPath = path2.join(OPCREW_DIR, "logbook.schema.json");
+  await ensureDir(OPCREW_DIR);
+  if (await fileExists(logbookPath)) {
+    console.log(`Skipped ${logbookPath} (already exists)`);
+  } else {
+    const templatePath = path2.join(TEMPLATE_DIR, "logbook.template.json");
+    await cp(templatePath, logbookPath);
+    console.log(`Created ${logbookPath}`);
+  }
+  if (await fileExists(schemaPath)) {
+    console.log(`Skipped ${schemaPath} (already exists)`);
+  } else {
+    const schemaTemplatePath = path2.join(TEMPLATE_DIR, "logbook.schema.json");
+    await cp(schemaTemplatePath, schemaPath);
+    console.log(`Created ${schemaPath}`);
+  }
+}
+async function bootstrapKnowledgeBase() {
+  const decisionsDir = path2.join(KNOWLEDGE_DIR, "decisions");
+  const readmePath = path2.join(KNOWLEDGE_DIR, "README.md");
+  const glossaryPath = path2.join(KNOWLEDGE_DIR, "glossary.md");
+  const projectMapPath = path2.join(KNOWLEDGE_DIR, "project-map.md");
+  await ensureDir(decisionsDir);
+  if (await fileExists(readmePath)) {
+    console.log(`Skipped ${readmePath} (already exists)`);
+  } else {
+    const templatePath = path2.join(TEMPLATE_DIR, "knowledge", "README.md");
+    await cp(templatePath, readmePath);
+    console.log(`Created ${readmePath}`);
+  }
+  if (await fileExists(glossaryPath)) {
+    console.log(`Skipped ${glossaryPath} (already exists)`);
+  } else {
+    const templatePath = path2.join(TEMPLATE_DIR, "knowledge", "glossary.md");
+    await cp(templatePath, glossaryPath);
+    console.log(`Created ${glossaryPath}`);
+  }
+  if (await fileExists(projectMapPath)) {
+    console.log(`Skipped ${projectMapPath} (already exists)`);
+  } else {
+    const templatePath = path2.join(TEMPLATE_DIR, "knowledge", "project-map.md");
+    await cp(templatePath, projectMapPath);
+    console.log(`Created ${projectMapPath}`);
+  }
+}
 async function installToTool(tool) {
+  await bootstrapLogbook();
+  await bootstrapKnowledgeBase();
   if (tool === "codex") {
     await installForCodex();
     return;

package/dist/opencode-plugin.js

@@ -100,7 +100,7 @@ description: ${this.config.description}
 tools: [${translatedTools.join(", ")}]
 ---`;
     return `${frontmatter}
-${this.buildMarkdownBody()}`;
+${this.buildMarkdownBody("claude")}`;
   }
   compileToOpenCodeMarkdown() {
     const permissionByRole = {
@@ -120,7 +120,7 @@ permission:
   webfetch: ${permission.webfetch}
 ---`;
     return `${frontmatter}
-${this.buildMarkdownBody()}`;
+${this.buildMarkdownBody("opencode")}`;
   }
   compileToCodexMarkdown() {
     const translatedTools = translateTools(this.getAllowedTools(), "codex");
@@ -130,13 +130,23 @@ role: ${this.config.role}
 tools: [${translatedTools.join(", ")}]
 ---`;
     return `${frontmatter}
-${this.buildMarkdownBody()}`;
+${this.buildMarkdownBody("codex")}`;
   }
-  buildMarkdownBody() {
+  buildToolBoundary(platform) {
+    const translatedTools = translateTools(this.getAllowedTools(), platform);
+    if (translatedTools.length === 0) {
+      return "TOOL BOUNDARY: No tools are available for this agent on this platform.";
+    }
+    const toolList = translatedTools.join(", ");
+    return `TOOL BOUNDARY: You are ONLY permitted to use these tools: ${toolList}. Using any other tool is a violation.`;
+  }
+  buildMarkdownBody(platform) {
+    const toolBoundary = this.buildToolBoundary(platform);
     const instructionsList = this.config.instructions.map((instruction) => `- ${instruction}`).join(`
 `);
     return `
 # ${this.config.name}
+- ${toolBoundary}
 ${instructionsList}
 
 ## Shared Context
@@ -152,7 +162,6 @@ var Captain = new OpCrewAgent({
   role: "Orchestrator",
   mode: "primary",
   instructions: [
-    "TOOL BOUNDARY: You are ONLY permitted to use these tools: read, logbook, delegate, skill. Using any other tool is a violation.",
     "You are the orchestrator - you NEVER execute work directly. Your role is to coordinate, delegate, and verify.",
     "Workstream Fan-out: divide missions into independent Workstreams (e.g., Logic, Testing, Documentation) to enable parallel specialists.",
     "Assign roles in order: Navigator plans, Boatswain executes, Quartermaster reviews; resolve conflicts quickly.",
@@ -177,7 +186,6 @@ var Navigator = new OpCrewAgent({
   role: "Planner",
   mode: "subagent",
   instructions: [
-    "TOOL BOUNDARY: You are ONLY permitted to use these tools: read, websearch, logbook, todo, skill. Using any other tool is a violation.",
     "Chart the implementation path based on the Captain's intent and constraints.",
     "Decompose work into atomic, ordered tasks with clear inputs, outputs, and ownership.",
     "Workstream Decomposition: break the plan into atomic, parallel tracks. Define File Ownership (e.g., Boatswain-A owns src/, Boatswain-B owns tests/).",
@@ -206,7 +214,6 @@ var Boatswain = new OpCrewAgent({
   role: "Executor",
   mode: "subagent",
   instructions: [
-    "TOOL BOUNDARY: You are ONLY permitted to use these tools: read, edit, write, test, todo, glob, grep, skill. Using any other tool is a violation.",
     "Scope Guarding: ONLY touch files assigned to your Workstream ID. If you must edit a file owned by another agent, escalate to Captain for a plan revision.",
     "Follow existing patterns, naming, and formatting; avoid speculative changes.",
     "Context Anchoring: before editing, read the surrounding code to match indentation, casing, and comment styles. Maintain the project's local laws.",
@@ -229,7 +236,6 @@ var Quartermaster = new OpCrewAgent({
   role: "Reviewer",
   mode: "subagent",
   instructions: [
-    "TOOL BOUNDARY: You are ONLY permitted to use these tools: read, grep, execute, write, skill. Using any other tool is a violation.",
     "Inspect each diff for regression risks, scope drift, and missing context.",
     "Integration Audit: once all parallel Boatswains report Complete, verify the combined diff for logic conflicts or signature mismatches.",
     "Documentation Gate: REJECT approval if code changed but docs/project-map.md or docs/glossary.md were not updated to reflect the new state.",
@@ -252,7 +258,6 @@ var Scout = new OpCrewAgent({
   role: "Researcher",
   mode: "subagent",
   instructions: [
-    "TOOL BOUNDARY: You are ONLY permitted to use these tools: websearch, webfetch, read, skill. Using any other tool is a violation.",
     "You are the crew's eyes to the outside world - research and gather information when summoned by Captain or Navigator.",
     "Focus exclusively on external research: web searches, documentation lookup, API references, and best practices.",
     "Never modify project files - your job is to gather intelligence, not execute changes.",
@@ -12720,26 +12725,109 @@ The logbook tracks:
   }
 });
 
+// src/skills.ts
+import { readdir, readFile } from "fs/promises";
+import path from "path";
+import { fileURLToPath } from "url";
+var __dirname2 = path.dirname(fileURLToPath(import.meta.url));
+async function loadSkills() {
+  const skillsDir = path.join(__dirname2, "skills");
+  try {
+    const entries = await readdir(skillsDir, { withFileTypes: true });
+    const skills = [];
+    for (const entry of entries) {
+      if (!entry.isDirectory())
+        continue;
+      const skillPath = path.join(skillsDir, entry.name);
+      const skillMdPath = path.join(skillPath, "SKILL.md");
+      try {
+        const content = await readFile(skillMdPath, "utf-8");
+        const { name, description } = parseSkillFrontmatter(content);
+        skills.push({
+          name: name || entry.name,
+          description: description || "",
+          sourcePath: skillPath
+        });
+      } catch {
+        console.warn(`Warning: No SKILL.md found in ${skillPath}`);
+      }
+    }
+    return skills;
+  } catch {
+    return [];
+  }
+}
+function parseSkillFrontmatter(content) {
+  const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!frontmatterMatch) {
+    return {};
+  }
+  const frontmatter = frontmatterMatch[1];
+  const result = {};
+  const nameMatch = frontmatter.match(/^name:\s*(.+)$/m);
+  if (nameMatch) {
+    result.name = nameMatch[1].trim();
+  }
+  const descMatch = frontmatter.match(/^description:\s*(.+)$/m);
+  if (descMatch) {
+    result.description = descMatch[1].trim();
+  }
+  return result;
+}
+async function getSkillContent(skillName) {
+  const skillMdPath = path.join(__dirname2, "skills", skillName, "SKILL.md");
+  return readFile(skillMdPath, "utf-8");
+}
+
+// src/tools/skill.ts
+var skillTool = tool({
+  description: `Load and manage agent skills dynamically.
+
+Actions:
+- list: List all available skills with names and descriptions
+- load: Load a specific skill's full content (SKILL.md)
+
+Skills provide specialized instructions and workflows for specific tasks.
+Use this tool when you recognize that a task matches one of the available skills.`,
+  args: {
+    action: tool.schema.enum(["list", "load"]).describe("Action to perform"),
+    name: tool.schema.string().optional().describe("Skill name (required for 'load' action)")
+  },
+  async execute(args) {
+    switch (args.action) {
+      case "list": {
+        const skills = await loadSkills();
+        if (skills.length === 0) {
+          return "No skills available.";
+        }
+        const formattedList = skills.map((skill) => `- **${skill.name}**: ${skill.description}`).join(`
+`);
+        return `Available skills:
+
+${formattedList}`;
+      }
+      case "load": {
+        if (!args.name) {
+          return "Error: name is required for 'load' action";
+        }
+        try {
+          const content = await getSkillContent(args.name);
+          return content;
+        } catch (error45) {
+          const message = error45 instanceof Error ? error45.message : String(error45);
+          return `Error: Failed to load skill '${args.name}': ${message}`;
+        }
+      }
+      default:
+        return `Error: Unknown action: ${args.action}`;
+    }
+  }
+});
+
 // src/opencode-plugin.ts
-var DEFAULT_CANONICAL_TOOLS = [
-  "read",
-  "write",
-  "edit",
-  "glob",
-  "grep",
-  "execute",
-  "websearch",
-  "webfetch",
-  "delegate",
-  "todo",
-  "test",
-  "logbook",
-  "skill"
-];
-var ALL_AVAILABLE_TOOLS = DEFAULT_CANONICAL_TOOLS;
 var permissionByRole = {
   Orchestrator: { edit: "deny", bash: "ask", webfetch: "deny" },
-  Planner: { edit: "deny", bash: "ask", webfetch: "allow" },
+  Planner: { edit: "deny", bash: "allow", webfetch: "allow" },
   Executor: { edit: "allow", bash: "allow", webfetch: "ask" },
   Reviewer: { edit: "deny", bash: "allow", webfetch: "deny" },
   Researcher: { edit: "deny", bash: "deny", webfetch: "allow" }
@@ -12747,102 +12835,57 @@ var permissionByRole = {
 function toAgentId(agent) {
   return agent.config.name.toLowerCase().replace(/\s+/g, "-");
 }
-function buildPrompt(agent, availableTools) {
+function buildPrompt(agent) {
   const instructionsList = agent.config.instructions.map((instruction) => `- ${instruction}`).join(`
 `);
-  const allowedTools = agent.getAllowedTools();
-  const forbiddenTools = agent.getForbiddenTools(availableTools);
-  const toolBoundariesSection = `## TOOL BOUNDARIES
-- **Allowed:** ${allowedTools.length > 0 ? allowedTools.join(", ") : "(none)"}
-- **Forbidden:** ${forbiddenTools.length > 0 ? forbiddenTools.join(", ") : "(none)"}`;
   return `# ${agent.config.name}
-
-${toolBoundariesSection}
-
 ${instructionsList}
 
 ## Shared Context
 Refer to \`.opcrew/logbook.json\` for the current voyage status.
 `;
 }
-function toOpenCodeAgentConfig(agent, availableTools) {
-  const allowedTools = agent.getAllowedTools();
-  const validTools = allowedTools.every((tool3) => availableTools.includes(tool3));
-  if (!validTools) {
-    const invalidTools = allowedTools.filter((tool3) => !availableTools.includes(tool3));
-    throw new Error(`Agent '${agent.config.name}' has invalid tools in allowlist: [${invalidTools.join(", ")}]. ` + `Valid tools: [${availableTools.join(", ")}]`);
-  }
+function toOpenCodeAgentConfig(agent) {
   return {
     description: agent.config.name,
     mode: agent.config.mode,
-    prompt: buildPrompt(agent, availableTools),
+    prompt: buildPrompt(agent),
     permission: permissionByRole[agent.config.role]
   };
 }
-function createOpCrewPlugin(options = {}) {
-  const {
-    tools: customTools = {},
-    skills,
-    availableTools = DEFAULT_CANONICAL_TOOLS,
-    includeDefaultTools = true,
-    crew: customCrew = crew
-  } = options;
-  const defaultTools = includeDefaultTools ? { edit_logbook: editLogbookTool } : {};
-  const mergedTools = {
-    ...defaultTools,
-    ...customTools
-  };
-  const _skills = skills;
-  return async ({ client }) => {
-    await client.app.log({
-      body: {
-        service: "opcrew",
-        level: "info",
-        message: "OpenCode plugin initialized"
-      }
-    });
-    return {
-      config: async (config2) => {
-        const agents = config2.agent ?? {};
-        agents["build"] = { ...agents["build"], disable: true };
-        for (const agent of customCrew) {
-          const agentId = toAgentId(agent);
-          const allowedTools = agent.getAllowedTools();
-          const forbiddenTools = agent.getForbiddenTools(availableTools);
-          await client.app.log({
-            body: {
-              service: "opcrew",
-              level: "info",
-              message: `Registering agent '${agent.config.name}' with tool boundaries`,
-              extra: {
-                agentId,
-                allowedTools,
-                forbiddenTools
-              }
-            }
-          });
-          agents[agentId] = toOpenCodeAgentConfig(agent, availableTools);
-        }
-        config2.agent = agents;
-        await client.app.log({
-          body: {
-            service: "opcrew",
-            level: "info",
-            message: "Crew agents registered",
-            extra: { agents: Object.keys(agents) }
-          }
-        });
-      },
-      tool: mergedTools
-    };
+var OpCrewPlugin = async ({ client }) => {
+  await client.app.log({
+    body: {
+      service: "opcrew",
+      level: "info",
+      message: "OpenCode plugin initialized"
+    }
+  });
+  return {
+    config: async (config2) => {
+      const agents = config2.agent ?? {};
+      agents["build"] = { ...agents["build"], disable: true };
+      for (const agent of crew) {
+        agents[toAgentId(agent)] = toOpenCodeAgentConfig(agent);
+      }
+      config2.agents = agents;
+      await client.app.log({
+        body: {
+          service: "opcrew",
+          level: "info",
+          message: "Crew agents registered",
+          extra: { agents: Object.keys(agents) }
+        }
+      });
+    },
+    tool: {
+      edit_logbook: editLogbookTool,
+      skill: skillTool
+    }
   };
-}
-var OpCrewPlugin = createOpCrewPlugin();
+};
 var opencode_plugin_default = OpCrewPlugin;
 export {
   opencode_plugin_default as default,
-  createOpCrewPlugin,
-  OpCrewPlugin,
-  DEFAULT_CANONICAL_TOOLS,
-  ALL_AVAILABLE_TOOLS
+  OpCrewPlugin
 };