@every-env/compound-plugin 0.1.0

package/tests/converter.test.ts

@@ -0,0 +1,171 @@
+import { describe, expect, test } from "bun:test"
+import path from "path"
+import { loadClaudePlugin } from "../src/parsers/claude"
+import { convertClaudeToOpenCode } from "../src/converters/claude-to-opencode"
+import { parseFrontmatter } from "../src/utils/frontmatter"
+
+const fixtureRoot = path.join(import.meta.dir, "fixtures", "sample-plugin")
+
+describe("convertClaudeToOpenCode", () => {
+  test("maps commands, permissions, and agents", async () => {
+    const plugin = await loadClaudePlugin(fixtureRoot)
+    const bundle = convertClaudeToOpenCode(plugin, {
+      agentMode: "subagent",
+      inferTemperature: false,
+      permissions: "from-commands",
+    })
+
+    expect(bundle.config.command?.["workflows:review"]).toBeDefined()
+    expect(bundle.config.command?.["plan_review"]).toBeDefined()
+
+    const permission = bundle.config.permission as Record<string, string | Record<string, string>>
+    expect(Object.keys(permission).sort()).toEqual([
+      "bash",
+      "edit",
+      "glob",
+      "grep",
+      "list",
+      "patch",
+      "question",
+      "read",
+      "skill",
+      "task",
+      "todoread",
+      "todowrite",
+      "webfetch",
+      "write",
+    ])
+    expect(permission.edit).toBe("allow")
+    expect(permission.write).toBe("allow")
+    const bashPermission = permission.bash as Record<string, string>
+    expect(bashPermission["ls *"]).toBe("allow")
+    expect(bashPermission["git *"]).toBe("allow")
+    expect(permission.webfetch).toBe("allow")
+
+    const readPermission = permission.read as Record<string, string>
+    expect(readPermission["*"]).toBe("deny")
+    expect(readPermission[".env"]).toBe("allow")
+
+    expect(permission.question).toBe("allow")
+    expect(permission.todowrite).toBe("allow")
+    expect(permission.todoread).toBe("allow")
+
+    const agentFile = bundle.agents.find((agent) => agent.name === "repo-research-analyst")
+    expect(agentFile).toBeDefined()
+    const parsed = parseFrontmatter(agentFile!.content)
+    expect(parsed.data.mode).toBe("subagent")
+  })
+
+  test("normalizes models and infers temperature", async () => {
+    const plugin = await loadClaudePlugin(fixtureRoot)
+    const bundle = convertClaudeToOpenCode(plugin, {
+      agentMode: "subagent",
+      inferTemperature: true,
+      permissions: "none",
+    })
+
+    const securityAgent = bundle.agents.find((agent) => agent.name === "security-sentinel")
+    expect(securityAgent).toBeDefined()
+    const parsed = parseFrontmatter(securityAgent!.content)
+    expect(parsed.data.model).toBe("anthropic/claude-sonnet-4-20250514")
+    expect(parsed.data.temperature).toBe(0.1)
+
+    const modelCommand = bundle.config.command?.["workflows:work"]
+    expect(modelCommand?.model).toBe("openai/gpt-4o")
+  })
+
+  test("converts hooks into plugin file", async () => {
+    const plugin = await loadClaudePlugin(fixtureRoot)
+    const bundle = convertClaudeToOpenCode(plugin, {
+      agentMode: "subagent",
+      inferTemperature: false,
+      permissions: "none",
+    })
+
+    const hookFile = bundle.plugins.find((file) => file.name === "converted-hooks.ts")
+    expect(hookFile).toBeDefined()
+    expect(hookFile!.content).toContain("\"tool.execute.before\"")
+    expect(hookFile!.content).toContain("\"tool.execute.after\"")
+    expect(hookFile!.content).toContain("\"session.created\"")
+    expect(hookFile!.content).toContain("\"session.deleted\"")
+    expect(hookFile!.content).toContain("\"session.idle\"")
+    expect(hookFile!.content).toContain("\"experimental.session.compacting\"")
+    expect(hookFile!.content).toContain("\"permission.requested\"")
+    expect(hookFile!.content).toContain("\"permission.replied\"")
+    expect(hookFile!.content).toContain("\"message.created\"")
+    expect(hookFile!.content).toContain("\"message.updated\"")
+    expect(hookFile!.content).toContain("echo before")
+    expect(hookFile!.content).toContain("echo before two")
+    expect(hookFile!.content).toContain("// timeout: 30s")
+    expect(hookFile!.content).toContain("// Prompt hook for Write|Edit")
+    expect(hookFile!.content).toContain("// Agent hook for Write|Edit: security-sentinel")
+  })
+
+  test("converts MCP servers", async () => {
+    const plugin = await loadClaudePlugin(fixtureRoot)
+    const bundle = convertClaudeToOpenCode(plugin, {
+      agentMode: "subagent",
+      inferTemperature: false,
+      permissions: "none",
+    })
+
+    const mcp = bundle.config.mcp ?? {}
+    expect(mcp["local-tooling"]).toEqual({
+      type: "local",
+      command: ["echo", "fixture"],
+      environment: undefined,
+      enabled: true,
+    })
+    expect(mcp.context7).toEqual({
+      type: "remote",
+      url: "https://mcp.context7.com/mcp",
+      headers: undefined,
+      enabled: true,
+    })
+  })
+
+  test("permission modes set expected keys", async () => {
+    const plugin = await loadClaudePlugin(fixtureRoot)
+    const noneBundle = convertClaudeToOpenCode(plugin, {
+      agentMode: "subagent",
+      inferTemperature: false,
+      permissions: "none",
+    })
+    expect(noneBundle.config.permission).toBeUndefined()
+
+    const broadBundle = convertClaudeToOpenCode(plugin, {
+      agentMode: "subagent",
+      inferTemperature: false,
+      permissions: "broad",
+    })
+    expect(broadBundle.config.permission).toEqual({
+      read: "allow",
+      write: "allow",
+      edit: "allow",
+      bash: "allow",
+      grep: "allow",
+      glob: "allow",
+      list: "allow",
+      webfetch: "allow",
+      skill: "allow",
+      patch: "allow",
+      task: "allow",
+      question: "allow",
+      todowrite: "allow",
+      todoread: "allow",
+    })
+  })
+
+  test("supports primary agent mode", async () => {
+    const plugin = await loadClaudePlugin(fixtureRoot)
+    const bundle = convertClaudeToOpenCode(plugin, {
+      agentMode: "primary",
+      inferTemperature: false,
+      permissions: "none",
+    })
+
+    const agentFile = bundle.agents.find((agent) => agent.name === "repo-research-analyst")
+    const parsed = parseFrontmatter(agentFile!.content)
+    expect(parsed.data.mode).toBe("primary")
+  })
+})

package/tests/fixtures/custom-paths/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "custom-paths",
+  "version": "1.0.0",
+  "agents": "./custom-agents",
+  "commands": ["./custom-commands"],
+  "skills": "./custom-skills",
+  "hooks": "./custom-hooks/hooks.json"
+}

package/tests/fixtures/custom-paths/agents/default-agent.md

@@ -0,0 +1,5 @@
+---
+name: default-agent
+---
+
+Default agent

package/tests/fixtures/custom-paths/commands/default-command.md

@@ -0,0 +1,5 @@
+---
+name: default-command
+---
+
+Default command

package/tests/fixtures/custom-paths/custom-agents/custom-agent.md

@@ -0,0 +1,5 @@
+---
+name: custom-agent
+---
+
+Custom agent

package/tests/fixtures/custom-paths/custom-commands/custom-command.md

@@ -0,0 +1,5 @@
+---
+name: custom-command
+---
+
+Custom command

package/tests/fixtures/custom-paths/custom-hooks/hooks.json

@@ -0,0 +1,7 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      { "matcher": "Write", "hooks": [{ "type": "command", "command": "echo custom" }] }
+    ]
+  }
+}

package/tests/fixtures/custom-paths/custom-skills/custom-skill/SKILL.md

@@ -0,0 +1,5 @@
+---
+name: custom-skill
+---
+
+Custom skill

package/tests/fixtures/custom-paths/hooks/hooks.json

@@ -0,0 +1,7 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      { "matcher": "Read", "hooks": [{ "type": "command", "command": "echo default" }] }
+    ]
+  }
+}

package/tests/fixtures/custom-paths/skills/default-skill/SKILL.md

@@ -0,0 +1,5 @@
+---
+name: default-skill
+---
+
+Default skill

package/tests/fixtures/invalid-command-path/.claude-plugin/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "invalid-command-path",
+  "version": "1.0.0",
+  "commands": ["../outside-commands"]
+}

package/tests/fixtures/invalid-hooks-path/.claude-plugin/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "invalid-hooks-path",
+  "version": "1.0.0",
+  "hooks": ["../outside-hooks.json"]
+}

package/tests/fixtures/invalid-mcp-path/.claude-plugin/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "invalid-mcp-path",
+  "version": "1.0.0",
+  "mcpServers": ["../outside-mcp.json"]
+}

package/tests/fixtures/mcp-file/.claude-plugin/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "mcp-file",
+  "version": "1.0.0",
+  "description": "MCP file fixture"
+}

package/tests/fixtures/mcp-file/.mcp.json

@@ -0,0 +1,6 @@
+{
+  "remote": {
+    "type": "sse",
+    "url": "https://example.com/stream"
+  }
+}

package/tests/fixtures/sample-plugin/.claude-plugin/plugin.json

@@ -0,0 +1,30 @@
+{
+  "name": "compound-engineering",
+  "version": "2.27.0",
+  "description": "Fixture aligned with the Compound Engineering plugin",
+  "author": {
+    "name": "Kieran Klaassen",
+    "email": "kieran@every.to",
+    "url": "https://github.com/kieranklaassen"
+  },
+  "homepage": "https://every.to/source-code/my-ai-had-already-fixed-the-code-before-i-saw-it",
+  "repository": "https://github.com/EveryInc/compound-engineering-plugin",
+  "license": "MIT",
+  "keywords": [
+    "compound-engineering",
+    "workflow-automation",
+    "code-review",
+    "agents"
+  ],
+  "mcpServers": {
+    "context7": {
+      "type": "http",
+      "url": "https://mcp.context7.com/mcp"
+    },
+    "local-tooling": {
+      "type": "stdio",
+      "command": "echo",
+      "args": ["fixture"]
+    }
+  }
+}

package/tests/fixtures/sample-plugin/agents/agent-one.md

@@ -0,0 +1,10 @@
+---
+name: repo-research-analyst
+description: Research repository structure and conventions
+capabilities:
+  - "Capability A"
+  - "Capability B"
+model: inherit
+---
+
+Repo research analyst body.

package/tests/fixtures/sample-plugin/agents/security-reviewer.md

@@ -0,0 +1,7 @@
+---
+name: security-sentinel
+description: Security audits and vulnerability assessments
+model: claude-sonnet-4-20250514
+---
+
+Security sentinel body.

package/tests/fixtures/sample-plugin/commands/command-one.md

@@ -0,0 +1,7 @@
+---
+name: workflows:review
+description: Run a multi-agent review workflow
+allowed-tools: Read, Write, Edit, Bash(ls:*), Bash(git:*), Grep, Glob, List, Patch, Task
+---
+
+Workflows review body.

package/tests/fixtures/sample-plugin/commands/model-command.md

@@ -0,0 +1,8 @@
+---
+name: workflows:work
+description: Execute planned tasks step by step
+model: gpt-4o
+allowed-tools: WebFetch
+---
+
+Workflows work body.

package/tests/fixtures/sample-plugin/commands/nested/command-two.md

@@ -0,0 +1,9 @@
+---
+name: plan_review
+description: Review a plan with multiple agents
+allowed-tools:
+  - Read
+  - Edit
+---
+
+Plan review body.

package/tests/fixtures/sample-plugin/commands/pattern-command.md

@@ -0,0 +1,7 @@
+---
+name: report-bug
+description: Report a bug with structured context
+allowed-tools: Read(.env), Bash(git:*)
+---
+
+Report bug body.

package/tests/fixtures/sample-plugin/commands/skill-command.md

@@ -0,0 +1,7 @@
+---
+name: create-agent-skill
+description: Create or edit a Claude Code skill
+allowed-tools: Skill(create-agent-skills)
+---
+
+Create agent skill body.

package/tests/fixtures/sample-plugin/commands/todo-command.md

@@ -0,0 +1,7 @@
+---
+name: workflows:plan
+description: Create a structured plan from requirements
+allowed-tools: Question, TodoWrite, TodoRead
+---
+
+Workflows plan body.

package/tests/fixtures/sample-plugin/hooks/hooks.json

@@ -0,0 +1,156 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo before",
+            "timeout": 30
+          },
+          {
+            "type": "command",
+            "command": "echo before two"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "After write"
+          },
+          {
+            "type": "agent",
+            "agent": "security-sentinel"
+          }
+        ]
+      }
+    ],
+    "PostToolUseFailure": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo failed"
+          }
+        ]
+      }
+    ],
+    "PermissionRequest": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo permission"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo prompt"
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo notify"
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo session start"
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo session end"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo stop"
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo compact"
+          }
+        ]
+      }
+    ],
+    "Setup": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo setup"
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo subagent start"
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo subagent stop"
+          }
+        ]
+      }
+    ]
+  }
+}

package/tests/fixtures/sample-plugin/skills/skill-one/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: skill-one
+description: Sample skill
+---
+
+Skill body.

package/tests/frontmatter.test.ts

@@ -0,0 +1,20 @@
+import { describe, expect, test } from "bun:test"
+import { formatFrontmatter, parseFrontmatter } from "../src/utils/frontmatter"
+
+describe("frontmatter", () => {
+  test("parseFrontmatter returns body when no frontmatter", () => {
+    const raw = "Hello\nWorld"
+    const result = parseFrontmatter(raw)
+    expect(result.data).toEqual({})
+    expect(result.body).toBe(raw)
+  })
+
+  test("formatFrontmatter round trips", () => {
+    const body = "Body text"
+    const formatted = formatFrontmatter({ name: "agent", description: "Test" }, body)
+    const parsed = parseFrontmatter(formatted)
+    expect(parsed.data.name).toBe("agent")
+    expect(parsed.data.description).toBe("Test")
+    expect(parsed.body.trim()).toBe(body)
+  })
+})

package/tests/opencode-writer.test.ts

@@ -0,0 +1,62 @@
+import { describe, expect, test } from "bun:test"
+import { promises as fs } from "fs"
+import path from "path"
+import os from "os"
+import { writeOpenCodeBundle } from "../src/targets/opencode"
+import type { OpenCodeBundle } from "../src/types/opencode"
+
+async function exists(filePath: string): Promise<boolean> {
+  try {
+    await fs.access(filePath)
+    return true
+  } catch {
+    return false
+  }
+}
+
+describe("writeOpenCodeBundle", () => {
+  test("writes config, agents, plugins, and skills", async () => {
+    const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), "opencode-test-"))
+    const bundle: OpenCodeBundle = {
+      config: { $schema: "https://opencode.ai/config.json" },
+      agents: [{ name: "agent-one", content: "Agent content" }],
+      plugins: [{ name: "hook.ts", content: "export {}" }],
+      skillDirs: [
+        {
+          name: "skill-one",
+          sourceDir: path.join(import.meta.dir, "fixtures", "sample-plugin", "skills", "skill-one"),
+        },
+      ],
+    }
+
+    await writeOpenCodeBundle(tempRoot, bundle)
+
+    expect(await exists(path.join(tempRoot, "opencode.json"))).toBe(true)
+    expect(await exists(path.join(tempRoot, ".opencode", "agents", "agent-one.md"))).toBe(true)
+    expect(await exists(path.join(tempRoot, ".opencode", "plugins", "hook.ts"))).toBe(true)
+    expect(await exists(path.join(tempRoot, ".opencode", "skills", "skill-one", "SKILL.md"))).toBe(true)
+  })
+
+  test("writes directly into a .opencode output root", async () => {
+    const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), "opencode-root-"))
+    const outputRoot = path.join(tempRoot, ".opencode")
+    const bundle: OpenCodeBundle = {
+      config: { $schema: "https://opencode.ai/config.json" },
+      agents: [{ name: "agent-one", content: "Agent content" }],
+      plugins: [],
+      skillDirs: [
+        {
+          name: "skill-one",
+          sourceDir: path.join(import.meta.dir, "fixtures", "sample-plugin", "skills", "skill-one"),
+        },
+      ],
+    }
+
+    await writeOpenCodeBundle(outputRoot, bundle)
+
+    expect(await exists(path.join(outputRoot, "opencode.json"))).toBe(true)
+    expect(await exists(path.join(outputRoot, "agents", "agent-one.md"))).toBe(true)
+    expect(await exists(path.join(outputRoot, "skills", "skill-one", "SKILL.md"))).toBe(true)
+    expect(await exists(path.join(outputRoot, ".opencode"))).toBe(false)
+  })
+})

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "types": ["bun-types"]
+  },
+  "include": ["src/**/*.ts"]
+}