@every-env/compound-plugin 0.12.0 → 2.34.2

package/src/sync/copilot.ts

@@ -1,11 +1,13 @@
-import fs from "fs/promises"
 import path from "path"
 import type { ClaudeHomeConfig } from "../parsers/claude-home"
 import type { ClaudeMcpServer } from "../types/claude"
-import { forceSymlink, isValidSkillName } from "../utils/symlink"
+import { syncCopilotCommands } from "./commands"
+import { mergeJsonConfigAtKey } from "./json-config"
+import { hasExplicitSseTransport } from "./mcp-transports"
+import { syncSkills } from "./skills"
 
 type CopilotMcpServer = {
-  type: string
+  type: "local" | "http" | "sse"
   command?: string
   args?: string[]
   url?: string
@@ -22,41 +24,17 @@ export async function syncToCopilot(
   config: ClaudeHomeConfig,
   outputRoot: string,
 ): Promise<void> {
-  const skillsDir = path.join(outputRoot, "skills")
-  await fs.mkdir(skillsDir, { recursive: true })
-
-  for (const skill of config.skills) {
-    if (!isValidSkillName(skill.name)) {
-      console.warn(`Skipping skill with invalid name: ${skill.name}`)
-      continue
-    }
-    const target = path.join(skillsDir, skill.name)
-    await forceSymlink(skill.sourceDir, target)
-  }
+  await syncSkills(config.skills, path.join(outputRoot, "skills"))
+  await syncCopilotCommands(config, outputRoot)
 
   if (Object.keys(config.mcpServers).length > 0) {
-    const mcpPath = path.join(outputRoot, "copilot-mcp-config.json")
-    const existing = await readJsonSafe(mcpPath)
+    const mcpPath = path.join(outputRoot, "mcp-config.json")
     const converted = convertMcpForCopilot(config.mcpServers)
-    const merged: CopilotMcpConfig = {
-      mcpServers: {
-        ...(existing.mcpServers ?? {}),
-        ...converted,
-      },
-    }
-    await fs.writeFile(mcpPath, JSON.stringify(merged, null, 2), { mode: 0o600 })
-  }
-}
-
-async function readJsonSafe(filePath: string): Promise<Partial<CopilotMcpConfig>> {
-  try {
-    const content = await fs.readFile(filePath, "utf-8")
-    return JSON.parse(content) as Partial<CopilotMcpConfig>
-  } catch (err) {
-    if ((err as NodeJS.ErrnoException).code === "ENOENT") {
-      return {}
-    }
-    throw err
+    await mergeJsonConfigAtKey({
+      configPath: mcpPath,
+      key: "mcpServers",
+      incoming: converted,
+    })
   }
 }
 
@@ -66,7 +44,7 @@ function convertMcpForCopilot(
   const result: Record<string, CopilotMcpServer> = {}
   for (const [name, server] of Object.entries(servers)) {
     const entry: CopilotMcpServer = {
-      type: server.command ? "local" : "sse",
+      type: server.command ? "local" : hasExplicitSseTransport(server) ? "sse" : "http",
       tools: ["*"],
     }
 

package/src/sync/droid.ts

@@ -1,21 +1,62 @@
-import fs from "fs/promises"
 import path from "path"
 import type { ClaudeHomeConfig } from "../parsers/claude-home"
-import { forceSymlink, isValidSkillName } from "../utils/symlink"
+import type { ClaudeMcpServer } from "../types/claude"
+import { syncDroidCommands } from "./commands"
+import { mergeJsonConfigAtKey } from "./json-config"
+import { syncSkills } from "./skills"
+
+type DroidMcpServer = {
+  type: "stdio" | "http"
+  command?: string
+  args?: string[]
+  env?: Record<string, string>
+  url?: string
+  headers?: Record<string, string>
+  disabled: boolean
+}
 
 export async function syncToDroid(
   config: ClaudeHomeConfig,
   outputRoot: string,
 ): Promise<void> {
-  const skillsDir = path.join(outputRoot, "skills")
-  await fs.mkdir(skillsDir, { recursive: true })
+  await syncSkills(config.skills, path.join(outputRoot, "skills"))
+  await syncDroidCommands(config, outputRoot)
+
+  if (Object.keys(config.mcpServers).length > 0) {
+    await mergeJsonConfigAtKey({
+      configPath: path.join(outputRoot, "mcp.json"),
+      key: "mcpServers",
+      incoming: convertMcpForDroid(config.mcpServers),
+    })
+  }
+}
 
-  for (const skill of config.skills) {
-    if (!isValidSkillName(skill.name)) {
-      console.warn(`Skipping skill with invalid name: ${skill.name}`)
+function convertMcpForDroid(
+  servers: Record<string, ClaudeMcpServer>,
+): Record<string, DroidMcpServer> {
+  const result: Record<string, DroidMcpServer> = {}
+
+  for (const [name, server] of Object.entries(servers)) {
+    if (server.command) {
+      result[name] = {
+        type: "stdio",
+        command: server.command,
+        args: server.args,
+        env: server.env,
+        disabled: false,
+      }
       continue
     }
-    const target = path.join(skillsDir, skill.name)
-    await forceSymlink(skill.sourceDir, target)
+
+    if (server.url) {
+      result[name] = {
+        type: "http",
+        url: server.url,
+        headers: server.headers,
+        disabled: false,
+      }
+    }
   }
+
+  return result
 }

package/src/sync/gemini.ts

@@ -2,7 +2,9 @@ import fs from "fs/promises"
 import path from "path"
 import type { ClaudeHomeConfig } from "../parsers/claude-home"
 import type { ClaudeMcpServer } from "../types/claude"
-import { forceSymlink, isValidSkillName } from "../utils/symlink"
+import { syncGeminiCommands } from "./commands"
+import { mergeJsonConfigAtKey } from "./json-config"
+import { syncSkills } from "./skills"
 
 type GeminiMcpServer = {
   command?: string
@@ -16,43 +18,100 @@ export async function syncToGemini(
   config: ClaudeHomeConfig,
   outputRoot: string,
 ): Promise<void> {
-  const skillsDir = path.join(outputRoot, "skills")
-  await fs.mkdir(skillsDir, { recursive: true })
-
-  for (const skill of config.skills) {
-    if (!isValidSkillName(skill.name)) {
-      console.warn(`Skipping skill with invalid name: ${skill.name}`)
-      continue
-    }
-    const target = path.join(skillsDir, skill.name)
-    await forceSymlink(skill.sourceDir, target)
-  }
+  await syncGeminiSkills(config.skills, outputRoot)
+  await syncGeminiCommands(config, outputRoot)
 
   if (Object.keys(config.mcpServers).length > 0) {
     const settingsPath = path.join(outputRoot, "settings.json")
-    const existing = await readJsonSafe(settingsPath)
     const converted = convertMcpForGemini(config.mcpServers)
-    const existingMcp =
-      existing.mcpServers && typeof existing.mcpServers === "object"
-        ? (existing.mcpServers as Record<string, unknown>)
-        : {}
-    const merged = {
-      ...existing,
-      mcpServers: { ...existingMcp, ...converted },
+    await mergeJsonConfigAtKey({
+      configPath: settingsPath,
+      key: "mcpServers",
+      incoming: converted,
+    })
+  }
+}
+
+async function syncGeminiSkills(
+  skills: ClaudeHomeConfig["skills"],
+  outputRoot: string,
+): Promise<void> {
+  const skillsDir = path.join(outputRoot, "skills")
+  const sharedSkillsDir = getGeminiSharedSkillsDir(outputRoot)
+
+  if (!sharedSkillsDir) {
+    await syncSkills(skills, skillsDir)
+    return
+  }
+
+  const canonicalSharedSkillsDir = await canonicalizePath(sharedSkillsDir)
+  const mirroredSkills: ClaudeHomeConfig["skills"] = []
+  const directSkills: ClaudeHomeConfig["skills"] = []
+
+  for (const skill of skills) {
+    if (await isWithinDir(skill.sourceDir, canonicalSharedSkillsDir)) {
+      mirroredSkills.push(skill)
+    } else {
+      directSkills.push(skill)
     }
-    await fs.writeFile(settingsPath, JSON.stringify(merged, null, 2), { mode: 0o600 })
   }
+
+  await removeGeminiMirrorConflicts(mirroredSkills, skillsDir, canonicalSharedSkillsDir)
+  await syncSkills(directSkills, skillsDir)
 }
 
-async function readJsonSafe(filePath: string): Promise<Record<string, unknown>> {
+function getGeminiSharedSkillsDir(outputRoot: string): string | null {
+  if (path.basename(outputRoot) !== ".gemini") return null
+  return path.join(path.dirname(outputRoot), ".agents", "skills")
+}
+
+async function canonicalizePath(targetPath: string): Promise<string> {
   try {
-    const content = await fs.readFile(filePath, "utf-8")
-    return JSON.parse(content) as Record<string, unknown>
-  } catch (err) {
-    if ((err as NodeJS.ErrnoException).code === "ENOENT") {
-      return {}
+    return await fs.realpath(targetPath)
+  } catch {
+    return path.resolve(targetPath)
+  }
+}
+
+async function isWithinDir(candidate: string, canonicalParentDir: string): Promise<boolean> {
+  const resolvedCandidate = await canonicalizePath(candidate)
+  return resolvedCandidate === canonicalParentDir
+    || resolvedCandidate.startsWith(`${canonicalParentDir}${path.sep}`)
+}
+
+async function removeGeminiMirrorConflicts(
+  skills: ClaudeHomeConfig["skills"],
+  skillsDir: string,
+  sharedSkillsDir: string,
+): Promise<void> {
+  for (const skill of skills) {
+    const duplicatePath = path.join(skillsDir, skill.name)
+
+    let stat
+    try {
+      stat = await fs.lstat(duplicatePath)
+    } catch (error) {
+      if ((error as NodeJS.ErrnoException).code === "ENOENT") {
+        continue
+      }
+      throw error
+    }
+
+    if (!stat.isSymbolicLink()) {
+      continue
+    }
+
+    let resolvedTarget: string
+    try {
+      resolvedTarget = await canonicalizePath(duplicatePath)
+    } catch {
+      continue
+    }
+
+    if (resolvedTarget === await canonicalizePath(skill.sourceDir)
+      || await isWithinDir(resolvedTarget, sharedSkillsDir)) {
+      await fs.unlink(duplicatePath)
     }
-    throw err
   }
 }
 

package/src/sync/json-config.ts

@@ -0,0 +1,47 @@
+import path from "path"
+import { pathExists, readJson, writeJsonSecure } from "../utils/files"
+
+type JsonObject = Record<string, unknown>
+
+function isJsonObject(value: unknown): value is JsonObject {
+  return typeof value === "object" && value !== null && !Array.isArray(value)
+}
+
+export async function mergeJsonConfigAtKey(options: {
+  configPath: string
+  key: string
+  incoming: Record<string, unknown>
+}): Promise<void> {
+  const { configPath, key, incoming } = options
+  const existing = await readJsonObjectSafe(configPath)
+  const existingEntries = isJsonObject(existing[key]) ? existing[key] : {}
+  const merged = {
+    ...existing,
+    [key]: {
+      ...existingEntries,
+      ...incoming,
+    },
+  }
+
+  await writeJsonSecure(configPath, merged)
+}
+
+async function readJsonObjectSafe(configPath: string): Promise<JsonObject> {
+  if (!(await pathExists(configPath))) {
+    return {}
+  }
+
+  try {
+    const parsed = await readJson<unknown>(configPath)
+    if (isJsonObject(parsed)) {
+      return parsed
+    }
+  } catch {
+    // Fall through to warning and replacement.
+  }
+
+  console.warn(
+    `Warning: existing ${path.basename(configPath)} could not be parsed and will be replaced.`,
+  )
+  return {}
+}

package/src/sync/kiro.ts

@@ -0,0 +1,49 @@
+import path from "path"
+import type { ClaudeHomeConfig } from "../parsers/claude-home"
+import type { ClaudeMcpServer } from "../types/claude"
+import type { KiroMcpServer } from "../types/kiro"
+import { syncKiroCommands } from "./commands"
+import { mergeJsonConfigAtKey } from "./json-config"
+import { syncSkills } from "./skills"
+
+export async function syncToKiro(
+  config: ClaudeHomeConfig,
+  outputRoot: string,
+): Promise<void> {
+  await syncSkills(config.skills, path.join(outputRoot, "skills"))
+  await syncKiroCommands(config, outputRoot)
+
+  if (Object.keys(config.mcpServers).length > 0) {
+    await mergeJsonConfigAtKey({
+      configPath: path.join(outputRoot, "settings", "mcp.json"),
+      key: "mcpServers",
+      incoming: convertMcpForKiro(config.mcpServers),
+    })
+  }
+}
+
+function convertMcpForKiro(
+  servers: Record<string, ClaudeMcpServer>,
+): Record<string, KiroMcpServer> {
+  const result: Record<string, KiroMcpServer> = {}
+
+  for (const [name, server] of Object.entries(servers)) {
+    if (server.command) {
+      result[name] = {
+        command: server.command,
+        args: server.args,
+        env: server.env,
+      }
+      continue
+    }
+
+    if (server.url) {
+      result[name] = {
+        url: server.url,
+        headers: server.headers,
+      }
+    }
+  }
+
+  return result
+}

package/src/sync/mcp-transports.ts

@@ -0,0 +1,19 @@
+import type { ClaudeMcpServer } from "../types/claude"
+
+function getTransportType(server: ClaudeMcpServer): string {
+  return server.type?.toLowerCase().trim() ?? ""
+}
+
+export function hasExplicitSseTransport(server: ClaudeMcpServer): boolean {
+  const type = getTransportType(server)
+  return type.includes("sse")
+}
+
+export function hasExplicitHttpTransport(server: ClaudeMcpServer): boolean {
+  const type = getTransportType(server)
+  return type.includes("http") || type.includes("streamable")
+}
+
+export function hasExplicitRemoteTransport(server: ClaudeMcpServer): boolean {
+  return hasExplicitSseTransport(server) || hasExplicitHttpTransport(server)
+}

package/src/sync/openclaw.ts

@@ -0,0 +1,18 @@
+import path from "path"
+import type { ClaudeHomeConfig } from "../parsers/claude-home"
+import { warnUnsupportedOpenClawCommands } from "./commands"
+import { syncSkills } from "./skills"
+
+export async function syncToOpenClaw(
+  config: ClaudeHomeConfig,
+  outputRoot: string,
+): Promise<void> {
+  await syncSkills(config.skills, path.join(outputRoot, "skills"))
+  warnUnsupportedOpenClawCommands(config)
+
+  if (Object.keys(config.mcpServers).length > 0) {
+    console.warn(
+      "Warning: OpenClaw MCP sync is skipped because the current official OpenClaw docs do not clearly document an MCP server config contract.",
+    )
+  }
+}

package/src/sync/opencode.ts

@@ -1,47 +1,27 @@
-import fs from "fs/promises"
 import path from "path"
 import type { ClaudeHomeConfig } from "../parsers/claude-home"
 import type { ClaudeMcpServer } from "../types/claude"
 import type { OpenCodeMcpServer } from "../types/opencode"
-import { forceSymlink, isValidSkillName } from "../utils/symlink"
+import { syncOpenCodeCommands } from "./commands"
+import { mergeJsonConfigAtKey } from "./json-config"
+import { syncSkills } from "./skills"
 
 export async function syncToOpenCode(
   config: ClaudeHomeConfig,
   outputRoot: string,
 ): Promise<void> {
-  // Ensure output directories exist
-  const skillsDir = path.join(outputRoot, "skills")
-  await fs.mkdir(skillsDir, { recursive: true })
-
-  // Symlink skills (with validation)
-  for (const skill of config.skills) {
-    if (!isValidSkillName(skill.name)) {
-      console.warn(`Skipping skill with invalid name: ${skill.name}`)
-      continue
-    }
-    const target = path.join(skillsDir, skill.name)
-    await forceSymlink(skill.sourceDir, target)
-  }
+  await syncSkills(config.skills, path.join(outputRoot, "skills"))
+  await syncOpenCodeCommands(config, outputRoot)
 
   // Merge MCP servers into opencode.json
   if (Object.keys(config.mcpServers).length > 0) {
     const configPath = path.join(outputRoot, "opencode.json")
-    const existing = await readJsonSafe(configPath)
     const mcpConfig = convertMcpForOpenCode(config.mcpServers)
-    existing.mcp = { ...(existing.mcp ?? {}), ...mcpConfig }
-    await fs.writeFile(configPath, JSON.stringify(existing, null, 2), { mode: 0o600 })
-  }
-}
-
-async function readJsonSafe(filePath: string): Promise<Record<string, unknown>> {
-  try {
-    const content = await fs.readFile(filePath, "utf-8")
-    return JSON.parse(content) as Record<string, unknown>
-  } catch (err) {
-    if ((err as NodeJS.ErrnoException).code === "ENOENT") {
-      return {}
-    }
-    throw err
+    await mergeJsonConfigAtKey({
+      configPath,
+      key: "mcp",
+      incoming: mcpConfig,
+    })
   }
 }
 

package/src/sync/pi.ts

@@ -1,8 +1,10 @@
-import fs from "fs/promises"
 import path from "path"
 import type { ClaudeHomeConfig } from "../parsers/claude-home"
 import type { ClaudeMcpServer } from "../types/claude"
-import { forceSymlink, isValidSkillName } from "../utils/symlink"
+import { ensureDir } from "../utils/files"
+import { syncPiCommands } from "./commands"
+import { mergeJsonConfigAtKey } from "./json-config"
+import { syncSkills } from "./skills"
 
 type McporterServer = {
   baseUrl?: string
@@ -20,45 +22,19 @@ export async function syncToPi(
   config: ClaudeHomeConfig,
   outputRoot: string,
 ): Promise<void> {
-  const skillsDir = path.join(outputRoot, "skills")
   const mcporterPath = path.join(outputRoot, "compound-engineering", "mcporter.json")
 
-  await fs.mkdir(skillsDir, { recursive: true })
-
-  for (const skill of config.skills) {
-    if (!isValidSkillName(skill.name)) {
-      console.warn(`Skipping skill with invalid name: ${skill.name}`)
-      continue
-    }
-    const target = path.join(skillsDir, skill.name)
-    await forceSymlink(skill.sourceDir, target)
-  }
+  await syncSkills(config.skills, path.join(outputRoot, "skills"))
+  await syncPiCommands(config, outputRoot)
 
   if (Object.keys(config.mcpServers).length > 0) {
-    await fs.mkdir(path.dirname(mcporterPath), { recursive: true })
-
-    const existing = await readJsonSafe(mcporterPath)
+    await ensureDir(path.dirname(mcporterPath))
     const converted = convertMcpToMcporter(config.mcpServers)
-    const merged: McporterConfig = {
-      mcpServers: {
-        ...(existing.mcpServers ?? {}),
-        ...converted.mcpServers,
-      },
-    }
-
-    await fs.writeFile(mcporterPath, JSON.stringify(merged, null, 2), { mode: 0o600 })
-  }
-}
-
-async function readJsonSafe(filePath: string): Promise<Partial<McporterConfig>> {
-  try {
-    const content = await fs.readFile(filePath, "utf-8")
-    return JSON.parse(content) as Partial<McporterConfig>
-  } catch (err) {
-    if ((err as NodeJS.ErrnoException).code === "ENOENT") {
-      return {}
-    }
-    throw err
+    await mergeJsonConfigAtKey({
+      configPath: mcporterPath,
+      key: "mcpServers",
+      incoming: converted.mcpServers,
+    })
   }
 }
 

package/src/sync/qwen.ts

@@ -0,0 +1,66 @@
+import path from "path"
+import type { ClaudeHomeConfig } from "../parsers/claude-home"
+import type { ClaudeMcpServer } from "../types/claude"
+import type { QwenMcpServer } from "../types/qwen"
+import { syncQwenCommands } from "./commands"
+import { mergeJsonConfigAtKey } from "./json-config"
+import { hasExplicitRemoteTransport, hasExplicitSseTransport } from "./mcp-transports"
+import { syncSkills } from "./skills"
+
+export async function syncToQwen(
+  config: ClaudeHomeConfig,
+  outputRoot: string,
+): Promise<void> {
+  await syncSkills(config.skills, path.join(outputRoot, "skills"))
+  await syncQwenCommands(config, outputRoot)
+
+  if (Object.keys(config.mcpServers).length > 0) {
+    await mergeJsonConfigAtKey({
+      configPath: path.join(outputRoot, "settings.json"),
+      key: "mcpServers",
+      incoming: convertMcpForQwen(config.mcpServers),
+    })
+  }
+}
+
+function convertMcpForQwen(
+  servers: Record<string, ClaudeMcpServer>,
+): Record<string, QwenMcpServer> {
+  const result: Record<string, QwenMcpServer> = {}
+
+  for (const [name, server] of Object.entries(servers)) {
+    if (server.command) {
+      result[name] = {
+        command: server.command,
+        args: server.args,
+        env: server.env,
+      }
+      continue
+    }
+
+    if (!server.url) {
+      continue
+    }
+
+    if (hasExplicitSseTransport(server)) {
+      result[name] = {
+        url: server.url,
+        headers: server.headers,
+      }
+      continue
+    }
+
+    if (!hasExplicitRemoteTransport(server)) {
+      console.warn(
+        `Warning: Qwen MCP server "${name}" has an ambiguous remote transport; defaulting to Streamable HTTP.`,
+      )
+    }
+
+    result[name] = {
+      httpUrl: server.url,
+      headers: server.headers,
+    }
+  }
+
+  return result
+}