@ryanreh99/skills-sync 1.0.0

package/dist/lib/adapters/codex.js

@@ -0,0 +1,239 @@
+import fs from "fs-extra";
+import path from "node:path";
+import { CODEX_MCP_BLOCK_END, CODEX_MCP_BLOCK_START, logWarn, readJsonFile } from "../core.js";
+import { linkDirectoryProjection } from "./common.js";
+
+function tomlString(value) {
+  return JSON.stringify(String(value ?? ""));
+}
+
+function tomlArray(values) {
+  const items = (Array.isArray(values) ? values : []).map((value) => tomlString(value));
+  return `[${items.join(", ")}]`;
+}
+
+function tomlInlineTable(values) {
+  const entries = values && typeof values === "object" && !Array.isArray(values) ? values : {};
+  const keys = Object.keys(entries).sort((left, right) => left.localeCompare(right));
+  const pairs = keys.map((key) => `${tomlTableKey(key)} = ${tomlString(entries[key])}`);
+  return `{ ${pairs.join(", ")} }`;
+}
+
+function tomlTableKey(key) {
+  return JSON.stringify(String(key));
+}
+
+function isTomlTableHeader(value) {
+  return /^\[\[?.+\]\]?$/.test(value);
+}
+
+function isCodexMcpTableHeader(value) {
+  return /^\[mcp_servers\./.test(value);
+}
+
+export async function discoverBundledSkills(bundleSkillsPath, currentPath = "", entries = []) {
+  const absolutePath = currentPath
+    ? path.join(bundleSkillsPath, currentPath.split("/").join(path.sep))
+    : bundleSkillsPath;
+  const children = await fs.readdir(absolutePath, { withFileTypes: true });
+  let hasSkill = false;
+  for (const child of children) {
+    if (child.isFile() && child.name === "SKILL.md") {
+      hasSkill = true;
+      break;
+    }
+  }
+  if (hasSkill && currentPath.length > 0) {
+    entries.push(currentPath);
+  }
+
+  const dirs = children
+    .filter((child) => child.isDirectory())
+    .map((child) => child.name)
+    .sort((left, right) => left.localeCompare(right));
+  for (const directory of dirs) {
+    const next = currentPath.length > 0 ? `${currentPath}/${directory}` : directory;
+    await discoverBundledSkills(bundleSkillsPath, next, entries);
+  }
+  return entries;
+}
+
+export function renderCodexConfigToml(canonicalMcp, bundledSkills = []) {
+  const servers = canonicalMcp?.mcpServers ?? {};
+  const names = Object.keys(servers).sort((left, right) => left.localeCompare(right));
+  const lines = [
+    "# Generated by skills-sync. Managed file.",
+    "# Source: ~/.skills-sync/internal/common/mcp.json",
+    'model = "gpt-5-codex"',
+    'approval_policy = "on-request"',
+    'sandbox_mode = "workspace-write"',
+    ""
+  ];
+
+  const sortedSkills = [...bundledSkills].sort((left, right) => left.localeCompare(right));
+  for (const skill of sortedSkills) {
+    lines.push("[[skills.config]]");
+    lines.push(`path = ${tomlString(`~/.codex/skills/vendor_imports/${skill}`)}`);
+    lines.push("enabled = true");
+    lines.push("");
+  }
+
+  for (const name of names) {
+    const server = servers[name] ?? {};
+    lines.push(`[mcp_servers.${tomlTableKey(name)}]`);
+    if (typeof server.url === "string" && server.url.trim().length > 0) {
+      lines.push(`url = ${tomlString(server.url)}`);
+    } else {
+      lines.push('transport = "stdio"');
+      lines.push(`command = ${tomlString(server.command)}`);
+      lines.push(`args = ${tomlArray(server.args)}`);
+      if (server.env && typeof server.env === "object" && !Array.isArray(server.env) && Object.keys(server.env).length > 0) {
+        lines.push(`env = ${tomlInlineTable(server.env)}`);
+      }
+    }
+    lines.push("");
+  }
+
+  return `${lines.join("\n").trimEnd()}\n`;
+}
+
+export function renderCodexMcpTables(canonicalMcp) {
+  const servers = canonicalMcp?.mcpServers ?? {};
+  const names = Object.keys(servers).sort((left, right) => left.localeCompare(right));
+  const lines = [];
+
+  for (const name of names) {
+    const server = servers[name] ?? {};
+    lines.push(`[mcp_servers.${tomlTableKey(name)}]`);
+    if (typeof server.url === "string" && server.url.trim().length > 0) {
+      lines.push(`url = ${tomlString(server.url)}`);
+    } else {
+      lines.push('transport = "stdio"');
+      lines.push(`command = ${tomlString(server.command)}`);
+      lines.push(`args = ${tomlArray(server.args)}`);
+      if (server.env && typeof server.env === "object" && !Array.isArray(server.env) && Object.keys(server.env).length > 0) {
+        lines.push(`env = ${tomlInlineTable(server.env)}`);
+      }
+    }
+    lines.push("");
+  }
+
+  return `${lines.join("\n").trimEnd()}\n`;
+}
+
+export function extractCodexMcpTables(content) {
+  const normalized = String(content ?? "").replace(/\r\n/g, "\n");
+  const lines = normalized.split("\n");
+  const blocks = [];
+
+  let index = 0;
+  while (index < lines.length) {
+    const trimmed = lines[index].trim();
+    if (!isCodexMcpTableHeader(trimmed)) {
+      index += 1;
+      continue;
+    }
+
+    const block = [lines[index]];
+    index += 1;
+    while (index < lines.length) {
+      const candidate = lines[index].trim();
+      if (isTomlTableHeader(candidate)) {
+        break;
+      }
+      block.push(lines[index]);
+      index += 1;
+    }
+    blocks.push(block.join("\n").trimEnd());
+  }
+
+  if (blocks.length === 0) {
+    return "";
+  }
+  return `${blocks.join("\n\n").trimEnd()}\n`;
+}
+
+export function renderCodexConfigTomlFromLocal(localContent, canonicalMcp) {
+  const normalized = String(localContent ?? "").replace(/\r\n/g, "\n");
+  const lines = normalized.split("\n");
+  const preserved = [];
+
+  let index = 0;
+  while (index < lines.length) {
+    const trimmed = lines[index].trim();
+
+    if (trimmed === CODEX_MCP_BLOCK_START) {
+      index += 1;
+      while (index < lines.length && lines[index].trim() !== CODEX_MCP_BLOCK_END) {
+        index += 1;
+      }
+      if (index < lines.length) {
+        index += 1;
+      }
+      continue;
+    }
+
+    if (isCodexMcpTableHeader(trimmed)) {
+      index += 1;
+      while (index < lines.length) {
+        const candidate = lines[index].trim();
+        if (isTomlTableHeader(candidate)) {
+          break;
+        }
+        index += 1;
+      }
+      continue;
+    }
+
+    preserved.push(lines[index]);
+    index += 1;
+  }
+
+  const base = preserved.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd();
+  const mcpTables = renderCodexMcpTables(canonicalMcp).trimEnd();
+  return `${base.length > 0 ? `${base}\n\n` : ""}${mcpTables}\n`;
+}
+
+export async function projectCodexFromBundle(options) {
+  const {
+    runtimeInternalRoot,
+    bundleSkillsPath,
+    bundleMcpPath,
+    packRoot,
+    localConfigPath = null,
+    canOverride = false
+  } = options;
+  const runtimeRoot = path.join(runtimeInternalRoot, ".codex");
+  await fs.ensureDir(runtimeRoot);
+
+  const skillsMethod = await linkDirectoryProjection(bundleSkillsPath, path.join(runtimeRoot, "skills"));
+  await linkDirectoryProjection(bundleSkillsPath, path.join(runtimeRoot, "vendor_imports", "skills"));
+
+  const canonicalMcp = await readJsonFile(bundleMcpPath);
+  let codexToml = null;
+
+  if (!canOverride && localConfigPath && (await fs.pathExists(localConfigPath))) {
+    try {
+      const localContent = await fs.readFile(localConfigPath, "utf8");
+      codexToml = renderCodexConfigTomlFromLocal(localContent, canonicalMcp);
+    } catch (error) {
+      logWarn(`Failed to seed Codex runtime config from local settings: ${error.message}`);
+    }
+  }
+
+  if (!codexToml) {
+    const bundledSkills = await discoverBundledSkills(bundleSkillsPath);
+    codexToml = renderCodexConfigToml(canonicalMcp, bundledSkills);
+  }
+
+  const runtimeConfigPath = path.join(runtimeRoot, "config.toml");
+  await fs.writeFile(runtimeConfigPath, codexToml, "utf8");
+  const mcpMethod = "generated";
+
+  const overrideSource = path.join(packRoot, "tool-overrides", "codex");
+  if (await fs.pathExists(overrideSource)) {
+    await fs.copy(overrideSource, path.join(runtimeRoot, "tool-overrides"));
+  }
+
+  return { skillsMethod, mcpMethod };
+}

package/dist/lib/adapters/common.js

@@ -0,0 +1,114 @@
+import fs from "fs-extra";
+import path from "node:path";
+import { createDirectoryBinding, createFileBinding, detectOsName } from "../core.js";
+
+export async function linkDirectoryProjection(sourcePath, targetPath) {
+  await fs.ensureDir(path.dirname(targetPath));
+  if (await fs.pathExists(targetPath)) {
+    await fs.remove(targetPath);
+  }
+
+  try {
+    const osName = detectOsName();
+    return await createDirectoryBinding(sourcePath, targetPath, osName);
+  } catch {
+    await fs.copy(sourcePath, targetPath);
+    return "copy";
+  }
+}
+
+export async function linkFileProjection(sourcePath, targetPath) {
+  await fs.ensureDir(path.dirname(targetPath));
+  if (await fs.pathExists(targetPath)) {
+    await fs.remove(targetPath);
+  }
+
+  try {
+    const osName = detectOsName();
+    const binding = await createFileBinding(sourcePath, targetPath, osName);
+    return binding.method;
+  } catch {
+    await fs.copyFile(sourcePath, targetPath);
+    return "copy";
+  }
+}
+
+export async function discoverBundledSkills(bundleSkillsPath, currentPath = "", entries = []) {
+  const absolutePath = currentPath
+    ? path.join(bundleSkillsPath, currentPath.split("/").join(path.sep))
+    : bundleSkillsPath;
+  const children = await fs.readdir(absolutePath, { withFileTypes: true });
+
+  let hasSkill = false;
+  for (const child of children) {
+    if (child.isFile() && child.name === "SKILL.md") {
+      hasSkill = true;
+      break;
+    }
+  }
+  if (hasSkill && currentPath.length > 0) {
+    entries.push(currentPath);
+  }
+
+  const dirs = children
+    .filter((child) => child.isDirectory())
+    .map((child) => child.name)
+    .sort((left, right) => left.localeCompare(right));
+  for (const directory of dirs) {
+    const next = currentPath.length > 0 ? `${currentPath}/${directory}` : directory;
+    await discoverBundledSkills(bundleSkillsPath, next, entries);
+  }
+  return entries;
+}
+
+function nextVendorAliasName(relativeSkillPath, usedNames) {
+  const flattened = relativeSkillPath.split("/").join("__");
+  const base = `vendor__${flattened}`;
+  let candidate = base;
+  let suffix = 2;
+  while (usedNames.has(candidate)) {
+    candidate = `${base}__${suffix}`;
+    suffix += 1;
+  }
+  return candidate;
+}
+
+export async function projectTopLevelSkills(bundleSkillsPath, runtimeSkillsPath) {
+  await fs.copy(bundleSkillsPath, runtimeSkillsPath);
+  const discovered = await discoverBundledSkills(bundleSkillsPath);
+  const topLevelEntries = await fs.readdir(runtimeSkillsPath, { withFileTypes: true });
+  const usedNames = new Set(topLevelEntries.filter((entry) => entry.isDirectory()).map((entry) => entry.name));
+
+  for (const relativeSkillPath of discovered) {
+    if (!relativeSkillPath.includes("/")) {
+      continue;
+    }
+    const sourceSkillPath = path.join(bundleSkillsPath, relativeSkillPath.split("/").join(path.sep));
+    const aliasName = nextVendorAliasName(relativeSkillPath, usedNames);
+    await linkDirectoryProjection(sourceSkillPath, path.join(runtimeSkillsPath, aliasName));
+    usedNames.add(aliasName);
+  }
+}
+
+export async function projectCommonFromBundle({ runtimeInternalRoot, bundleSkillsPath, bundleMcpPath }) {
+  const commonRoot = path.join(runtimeInternalRoot, "common");
+  await fs.ensureDir(commonRoot);
+  const skillsMethod = await linkDirectoryProjection(bundleSkillsPath, path.join(commonRoot, "skills"));
+  const mcpMethod = await linkFileProjection(bundleMcpPath, path.join(commonRoot, "mcp.json"));
+  return { skillsMethod, mcpMethod };
+}
+
+export async function projectToolFromBundle({ tool, runtimeInternalRoot, bundleSkillsPath, bundleMcpPath, packRoot }) {
+  const toolDist = path.join(runtimeInternalRoot, tool);
+  await fs.ensureDir(toolDist);
+
+  const skillsMethod = await linkDirectoryProjection(bundleSkillsPath, path.join(toolDist, "skills"));
+  const mcpMethod = await linkFileProjection(bundleMcpPath, path.join(toolDist, "mcp.json"));
+
+  const overrideSource = path.join(packRoot, "tool-overrides", tool);
+  if (await fs.pathExists(overrideSource)) {
+    await fs.copy(overrideSource, path.join(toolDist, "tool-overrides"));
+  }
+
+  return { skillsMethod, mcpMethod };
+}

package/dist/lib/adapters/copilot.js

@@ -0,0 +1,53 @@
+import fs from "fs-extra";
+import path from "node:path";
+import { logWarn, readJsonFile } from "../core.js";
+import { projectTopLevelSkills } from "./common.js";
+
+export async function projectCopilotFromBundle(options) {
+  const {
+    runtimeInternalRoot,
+    bundleSkillsPath,
+    bundleMcpPath,
+    packRoot,
+    localConfigPath = null,
+    canOverride = false
+  } = options;
+  const runtimeRoot = path.join(runtimeInternalRoot, ".copilot");
+  await fs.ensureDir(runtimeRoot);
+
+  const runtimeSkillsPath = path.join(runtimeRoot, "skills");
+  await fs.remove(runtimeSkillsPath);
+  await projectTopLevelSkills(bundleSkillsPath, runtimeSkillsPath);
+  const skillsMethod = "copy+aliases";
+
+  const canonicalMcp = await readJsonFile(bundleMcpPath);
+  let projected = canonicalMcp;
+
+  if (!canOverride && localConfigPath && (await fs.pathExists(localConfigPath))) {
+    try {
+      const existing = await readJsonFile(localConfigPath);
+      if (!existing || typeof existing !== "object" || Array.isArray(existing)) {
+        throw new Error("expected JSON object root");
+      }
+      projected = {
+        ...existing,
+        mcpServers: canonicalMcp?.mcpServers ?? {}
+      };
+    } catch (error) {
+      logWarn(`Failed to seed Copilot runtime config from local settings: ${error.message}`);
+    }
+  }
+
+  const runtimeConfigPath = path.join(runtimeRoot, "mcp-config.json");
+  await fs.writeFile(runtimeConfigPath, `${JSON.stringify(projected, null, 2)}\n`, "utf8");
+
+  const overrideSource = path.join(packRoot, "tool-overrides", "copilot");
+  if (await fs.pathExists(overrideSource)) {
+    await fs.copy(overrideSource, path.join(runtimeRoot, "tool-overrides"));
+  }
+
+  return {
+    skillsMethod,
+    mcpMethod: "generated"
+  };
+}

package/dist/lib/adapters/cursor.js

@@ -0,0 +1,53 @@
+import fs from "fs-extra";
+import path from "node:path";
+import { logWarn, readJsonFile } from "../core.js";
+import { projectTopLevelSkills } from "./common.js";
+
+export async function projectCursorFromBundle(options) {
+  const {
+    runtimeInternalRoot,
+    bundleSkillsPath,
+    bundleMcpPath,
+    packRoot,
+    localConfigPath = null,
+    canOverride = false
+  } = options;
+  const runtimeRoot = path.join(runtimeInternalRoot, ".cursor");
+  await fs.ensureDir(runtimeRoot);
+
+  const runtimeSkillsPath = path.join(runtimeRoot, "skills");
+  await fs.remove(runtimeSkillsPath);
+  await projectTopLevelSkills(bundleSkillsPath, runtimeSkillsPath);
+  const skillsMethod = "copy+aliases";
+
+  const canonicalMcp = await readJsonFile(bundleMcpPath);
+  let projected = canonicalMcp;
+
+  if (!canOverride && localConfigPath && (await fs.pathExists(localConfigPath))) {
+    try {
+      const existing = await readJsonFile(localConfigPath);
+      if (!existing || typeof existing !== "object" || Array.isArray(existing)) {
+        throw new Error("expected JSON object root");
+      }
+      projected = {
+        ...existing,
+        mcpServers: canonicalMcp?.mcpServers ?? {}
+      };
+    } catch (error) {
+      logWarn(`Failed to seed Cursor runtime config from local settings: ${error.message}`);
+    }
+  }
+
+  const runtimeConfigPath = path.join(runtimeRoot, "mcp.json");
+  await fs.writeFile(runtimeConfigPath, `${JSON.stringify(projected, null, 2)}\n`, "utf8");
+
+  const overrideSource = path.join(packRoot, "tool-overrides", "cursor");
+  if (await fs.pathExists(overrideSource)) {
+    await fs.copy(overrideSource, path.join(runtimeRoot, "tool-overrides"));
+  }
+
+  return {
+    skillsMethod,
+    mcpMethod: "generated"
+  };
+}

package/dist/lib/adapters/gemini.js

@@ -0,0 +1,52 @@
+import fs from "fs-extra";
+import path from "node:path";
+import { logWarn, readJsonFile } from "../core.js";
+import { linkDirectoryProjection, projectTopLevelSkills } from "./common.js";
+
+export async function projectGeminiFromBundle(options) {
+  const {
+    runtimeInternalRoot,
+    bundleSkillsPath,
+    bundleMcpPath,
+    packRoot,
+    localConfigPath = null,
+    canOverride = false
+  } = options;
+  const runtimeRoot = path.join(runtimeInternalRoot, ".gemini");
+  await fs.ensureDir(runtimeRoot);
+
+  const runtimeSkillsPath = path.join(runtimeRoot, "skills");
+  await fs.remove(runtimeSkillsPath);
+  await projectTopLevelSkills(bundleSkillsPath, runtimeSkillsPath);
+  const skillsMethod = "copy+aliases";
+  await linkDirectoryProjection(bundleSkillsPath, path.join(runtimeRoot, "vendor_imports", "skills"));
+
+  const canonicalMcp = await readJsonFile(bundleMcpPath);
+  let projected = canonicalMcp;
+
+  if (!canOverride && localConfigPath && (await fs.pathExists(localConfigPath))) {
+    try {
+      const existing = await readJsonFile(localConfigPath);
+      if (!existing || typeof existing !== "object" || Array.isArray(existing)) {
+        throw new Error("expected JSON object root");
+      }
+      projected = {
+        ...existing,
+        mcpServers: canonicalMcp?.mcpServers ?? {}
+      };
+    } catch (error) {
+      logWarn(`Failed to seed Gemini runtime config from local settings: ${error.message}`);
+    }
+  }
+
+  const runtimeSettingsPath = path.join(runtimeRoot, "settings.json");
+  await fs.writeFile(runtimeSettingsPath, `${JSON.stringify(projected, null, 2)}\n`, "utf8");
+  const mcpMethod = "generated";
+
+  const overrideSource = path.join(packRoot, "tool-overrides", "gemini");
+  if (await fs.pathExists(overrideSource)) {
+    await fs.copy(overrideSource, path.join(runtimeRoot, "tool-overrides"));
+  }
+
+  return { skillsMethod, mcpMethod };
+}