opcrew 0.1.6 → 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.",