everything-dev 1.27.0 → 1.28.1

package/src/sdk.ts

@@ -1,14 +0,0 @@
-export {
-  createPlugin,
-  createPluginRuntime,
-  type LoadedPluginWithBinding,
-  type Plugin,
-  PluginRuntime,
-} from "every-plugin";
-export { Context, Effect, Layer, Scope } from "every-plugin/effect";
-export {
-  type AnyContractRouter,
-  type AnySchema,
-  oc,
-} from "every-plugin/orpc";
-export { z } from "zod";

package/src/service-descriptor.ts

@@ -1,281 +0,0 @@
-import { Context, Layer } from "effect";
-import type { RuntimeConfig, SourceMode } from "./types";
-
-export interface ServiceDescriptor {
-  key: string;
-  source: SourceMode;
-  url: string;
-  remoteUrl?: string;
-  entry: string;
-  name: string;
-  localPath?: string;
-  port?: number;
-  readinessPath: string;
-  defaultPort: number;
-  integrity?: string;
-  proxy?: string;
-  variables?: Record<string, string>;
-  secrets?: string[];
-  ssr?: boolean;
-  command?: string;
-  args?: string[];
-  readyPatterns?: RegExp[];
-  errorPatterns?: RegExp[];
-}
-
-export class ServiceDescriptorMap extends Context.Tag("ServiceDescriptorMap")<
-  ServiceDescriptorMap,
-  Map<string, ServiceDescriptor>
->() {}
-
-export class DevRuntimeConfig extends Context.Tag("DevRuntimeConfig")<
-  DevRuntimeConfig,
-  RuntimeConfig
->() {}
-
-const PLUGIN_READY_PATTERNS = [/ready in/i, /compiled.*successfully/i, /listening/i, /started/i];
-
-const PLUGIN_ERROR_PATTERNS = [/error/i, /failed/i];
-
-const SERVICE_CONFIGS: Record<
-  string,
-  Pick<
-    ServiceDescriptor,
-    "command" | "args" | "readyPatterns" | "errorPatterns" | "defaultPort" | "readinessPath"
-  >
-> = {
-  host: {
-    command: "bun",
-    args: ["run", "dev"],
-    readyPatterns: [/Host (dev|production) server running at/i, /Server running at/i],
-    errorPatterns: [/error:/i, /failed/i, /exception/i],
-    defaultPort: 3000,
-    readinessPath: "/health",
-  },
-  auth: {
-    command: "bun",
-    args: ["run", "dev"],
-    readyPatterns: PLUGIN_READY_PATTERNS,
-    errorPatterns: PLUGIN_ERROR_PATTERNS,
-    defaultPort: 3002,
-    readinessPath: "/remoteEntry.js",
-  },
-  ui: {
-    command: "bun",
-    args: ["run", "dev"],
-    readyPatterns: [/\bready\s+built in\b/i, /\bLocal:\b/i, /\bcompiled\b.*successfully/i],
-    errorPatterns: [/error/i, /failed to compile/i],
-    defaultPort: 3003,
-    readinessPath: "/remoteEntry.js",
-  },
-  "ui-ssr": {
-    command: "bun",
-    args: ["run", "dev:ssr"],
-    readyPatterns: [/\bready\s+built in\b/i, /\bcompiled\b.*successfully/i],
-    errorPatterns: [/error/i, /failed/i],
-    defaultPort: 3004,
-    readinessPath: "/",
-  },
-  api: {
-    command: "bun",
-    args: ["run", "dev"],
-    readyPatterns: PLUGIN_READY_PATTERNS,
-    errorPatterns: PLUGIN_ERROR_PATTERNS,
-    defaultPort: 3001,
-    readinessPath: "/remoteEntry.js",
-  },
-};
-
-export function buildServiceDescriptorMap(
-  runtimeConfig: RuntimeConfig,
-  options?: { ssr?: boolean; proxy?: boolean },
-): Map<string, ServiceDescriptor> {
-  const map = new Map<string, ServiceDescriptor>();
-  const ssr = options?.ssr ?? false;
-
-  const hostIsRemote = runtimeConfig.host.source === "remote";
-  const hostProbeUrl = hostIsRemote
-    ? (runtimeConfig.host.remoteUrl ?? runtimeConfig.host.url)
-    : runtimeConfig.host.url;
-  map.set("host", {
-    key: "host",
-    source: runtimeConfig.host.source,
-    url: hostProbeUrl,
-    remoteUrl: runtimeConfig.host.remoteUrl,
-    entry: hostIsRemote
-      ? hostProbeUrl
-        ? `${hostProbeUrl}/mf-manifest.json`
-        : "/mf-manifest.json"
-      : runtimeConfig.host.entry,
-    name: runtimeConfig.host.name,
-    localPath: runtimeConfig.host.localPath,
-    port: runtimeConfig.host.port,
-    integrity: runtimeConfig.host.integrity,
-    secrets: runtimeConfig.host.secrets,
-    ...SERVICE_CONFIGS.host,
-  });
-
-  map.set("ui", {
-    key: "ui",
-    source: runtimeConfig.ui.source,
-    url: runtimeConfig.ui.url,
-    remoteUrl: runtimeConfig.ui.source === "remote" ? runtimeConfig.ui.url : undefined,
-    entry: runtimeConfig.ui.entry,
-    name: runtimeConfig.ui.name,
-    localPath: runtimeConfig.ui.localPath,
-    port: runtimeConfig.ui.port,
-    integrity: runtimeConfig.ui.integrity,
-    ssr,
-    ...SERVICE_CONFIGS.ui,
-  });
-
-  if (ssr && runtimeConfig.ui.source === "local") {
-    map.set("ui-ssr", {
-      key: "ui-ssr",
-      source: runtimeConfig.ui.source,
-      url: runtimeConfig.ui.ssrUrl ?? "",
-      entry: "",
-      name: "ui-ssr",
-      localPath: runtimeConfig.ui.localPath,
-      port: runtimeConfig.ui.ssrUrl
-        ? Number.parseInt(new URL(runtimeConfig.ui.ssrUrl).port, 10)
-        : (runtimeConfig.ui.port ?? 3003) + 1,
-      ...SERVICE_CONFIGS["ui-ssr"],
-    });
-  }
-
-  map.set("api", {
-    key: "api",
-    source: runtimeConfig.api.source,
-    url: runtimeConfig.api.url,
-    remoteUrl: runtimeConfig.api.source === "remote" ? runtimeConfig.api.url : undefined,
-    entry: runtimeConfig.api.entry,
-    name: runtimeConfig.api.name,
-    localPath: runtimeConfig.api.localPath,
-    port: runtimeConfig.api.port,
-    integrity: runtimeConfig.api.integrity,
-    proxy: runtimeConfig.api.proxy,
-    variables: runtimeConfig.api.variables,
-    secrets: runtimeConfig.api.secrets,
-    ...SERVICE_CONFIGS.api,
-  });
-
-  if (runtimeConfig.auth) {
-    map.set("auth", {
-      key: "auth",
-      source: runtimeConfig.auth.source,
-      url: runtimeConfig.auth.url,
-      remoteUrl: runtimeConfig.auth.source === "remote" ? runtimeConfig.auth.url : undefined,
-      entry: runtimeConfig.auth.entry,
-      name: runtimeConfig.auth.name,
-      localPath: runtimeConfig.auth.localPath,
-      port: runtimeConfig.auth.port,
-      integrity: runtimeConfig.auth.integrity,
-      proxy: runtimeConfig.auth.proxy,
-      variables: runtimeConfig.auth.variables,
-      secrets: runtimeConfig.auth.secrets,
-      ...SERVICE_CONFIGS.auth,
-    });
-  }
-
-  if (runtimeConfig.plugins) {
-    let pluginBasePort = 3010;
-    for (const [pluginId, pluginConfig] of Object.entries(runtimeConfig.plugins)) {
-      const pluginKey = `plugin:${pluginId}`;
-      const resolvedPort = pluginConfig.port ?? pluginBasePort;
-      pluginBasePort = resolvedPort + 1;
-
-      map.set(pluginKey, {
-        key: pluginKey,
-        source: pluginConfig.source,
-        url: pluginConfig.url,
-        remoteUrl: pluginConfig.source === "remote" ? pluginConfig.url : undefined,
-        entry: pluginConfig.entry,
-        name: pluginConfig.name,
-        localPath: pluginConfig.localPath,
-        port: resolvedPort,
-        integrity: pluginConfig.integrity,
-        proxy: pluginConfig.proxy,
-        variables: pluginConfig.variables,
-        secrets: pluginConfig.secrets,
-        command: "bun",
-        args: ["run", "dev"],
-        readyPatterns: PLUGIN_READY_PATTERNS,
-        errorPatterns: PLUGIN_ERROR_PATTERNS,
-        defaultPort: resolvedPort,
-        readinessPath: "/remoteEntry.js",
-      });
-
-      if (pluginConfig.ui?.localPath && pluginConfig.ui.source === "local") {
-        const uiKey = `plugin-ui:${pluginId}`;
-        const uiPort = pluginConfig.ui.port ?? pluginBasePort;
-        pluginBasePort = uiPort + 1;
-
-        map.set(uiKey, {
-          key: uiKey,
-          source: pluginConfig.ui.source,
-          url: pluginConfig.ui.url,
-          entry: pluginConfig.ui.entry,
-          name: pluginConfig.ui.name,
-          localPath: pluginConfig.ui.localPath,
-          port: uiPort,
-          integrity: pluginConfig.ui.integrity,
-          command: "bun",
-          args: ["run", "dev"],
-          readyPatterns: PLUGIN_READY_PATTERNS,
-          errorPatterns: PLUGIN_ERROR_PATTERNS,
-          defaultPort: uiPort,
-          readinessPath: "/remoteEntry.js",
-        });
-      }
-    }
-  }
-
-  return map;
-}
-
-export interface AppOrchestrator {
-  packages: string[];
-  description: string;
-  env: Record<string, string>;
-  port?: number;
-  interactive?: boolean;
-  noLogs?: boolean;
-}
-
-export const ServiceDescriptorMapLive = (map: Map<string, ServiceDescriptor>) =>
-  Layer.succeed(ServiceDescriptorMap, map);
-
-export const DevRuntimeConfigLive = (config: RuntimeConfig) =>
-  Layer.succeed(DevRuntimeConfig, config);
-
-export function buildDescription(map: Map<string, ServiceDescriptor>): string {
-  const descriptors = [...map.values()].filter(
-    (d) => d.key !== "ui-ssr" && !d.key.startsWith("plugin:"),
-  );
-
-  const allLocal = descriptors.every((d) => d.source === "local");
-  const hasProxy = [...map.values()].some((d) => d.proxy && d.source === "local");
-  if (allLocal && !hasProxy) return "Full Local Development";
-
-  const parts: string[] = [];
-  for (const d of descriptors) {
-    if (d.source === "remote") {
-      const label =
-        d.key === "host"
-          ? "Remote Host"
-          : d.key === "ui"
-            ? "Remote UI"
-            : d.key === "api"
-              ? hasProxy
-                ? undefined
-                : "Remote API"
-              : d.key === "auth"
-                ? "Remote Auth"
-                : undefined;
-      if (label) parts.push(label);
-    }
-  }
-  if (hasProxy) parts.push("Proxy API → Production");
-  return parts.join(" + ") || "Remote Mode";
-}

package/src/shared.ts

@@ -1,249 +0,0 @@
-import { createHash } from "node:crypto";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { type BosEnv, type ResolvedConfigMeta, rebuildOrderedConfig } from "./merge";
-import type { BosConfig, SharedDepConfig } from "./types";
-import { BosConfigSchema } from "./types";
-
-interface PackageJson {
-  name?: string;
-  private?: boolean;
-  version?: string;
-  workspaces?: {
-    packages?: string[];
-    catalog?: Record<string, string>;
-  };
-  dependencies?: Record<string, string>;
-  devDependencies?: Record<string, string>;
-  scripts?: Record<string, string>;
-}
-
-export interface SharedUiResolvedDep {
-  name: string;
-  version: string;
-  requiredVersion: string;
-  shareScope: string;
-  singleton: boolean;
-  eager: boolean;
-  strictVersion: boolean;
-}
-
-export interface SharedUiResolved {
-  deps: Record<string, SharedUiResolvedDep>;
-  fingerprintSha256: string;
-}
-
-export interface SharedSyncResult {
-  mode: "catalog->bos" | "bos->catalog";
-  hostMode: "local" | "remote";
-  bosConfigChanged: boolean;
-  catalogChanged: boolean;
-  generatedChanged: boolean;
-  resolved: SharedUiResolved;
-}
-
-function sha256(input: string): string {
-  return createHash("sha256").update(input).digest("hex");
-}
-
-function extractSemverExact(input: unknown): string | null {
-  if (typeof input !== "string") return null;
-  const match = input.match(/\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?/);
-  return match ? match[0] : null;
-}
-
-function caretRange(version: string): string {
-  return `^${version}`;
-}
-
-function stableDepsObject(
-  deps: Record<string, SharedUiResolvedDep>,
-): Record<string, SharedUiResolvedDep> {
-  const keys = Object.keys(deps).sort((a, b) => a.localeCompare(b));
-  const out: Record<string, SharedUiResolvedDep> = {};
-  for (const k of keys) out[k] = deps[k]!;
-  return out;
-}
-
-function writeFileIfChanged(filePath: string, nextContent: string): boolean {
-  try {
-    const current = readFileSync(filePath, "utf-8");
-    if (current === nextContent) return false;
-  } catch {
-    // ignore
-  }
-
-  writeFileSync(filePath, nextContent);
-  return true;
-}
-
-function fingerprintResolved(deps: Record<string, SharedUiResolvedDep>): string {
-  const stable = stableDepsObject(deps);
-  return sha256(JSON.stringify(stable));
-}
-
-function getSharedUiDeps(bosConfig: BosConfig): Record<string, SharedDepConfig> {
-  const shared = bosConfig.shared ?? {};
-  const ui = shared.ui ?? {};
-  return ui;
-}
-
-export async function syncAndGenerateSharedUi(opts: {
-  configDir: string;
-  hostMode: "local" | "remote";
-  bosConfig?: BosConfig;
-  env?: BosEnv;
-  extendsChain?: string[];
-}): Promise<SharedSyncResult> {
-  const bosConfigPath = join(opts.configDir, "bos.config.json");
-  const resolvedConfigPath = join(opts.configDir, ".bos", "bos.resolved-config.json");
-  const packageJsonPath = join(opts.configDir, "package.json");
-  const generatedPath = join(opts.configDir, ".bos", "generated", "shared-ui.json");
-
-  let bosConfig: BosConfig;
-  if (opts.bosConfig) {
-    bosConfig = opts.bosConfig;
-  } else {
-    const raw = JSON.parse(readFileSync(bosConfigPath, "utf-8")) as Record<string, unknown>;
-    bosConfig = BosConfigSchema.parse(raw);
-  }
-  let pkgJson: PackageJson = {};
-  try {
-    pkgJson = JSON.parse(readFileSync(packageJsonPath, "utf-8")) as PackageJson;
-  } catch {
-    // package.json might not exist
-  }
-
-  const originalBos = JSON.stringify(bosConfig);
-  const originalPkg = JSON.stringify(pkgJson);
-
-  const catalog = pkgJson?.workspaces?.catalog ?? {};
-  const sharedUi = getSharedUiDeps(bosConfig);
-
-  const mode = opts.hostMode === "local" ? "catalog->bos" : "bos->catalog";
-
-  if (mode === "catalog->bos") {
-    for (const [name, cfg] of Object.entries(sharedUi)) {
-      const dep = cfg as SharedDepConfig;
-      const version =
-        catalog[name] ?? extractSemverExact(dep.version) ?? extractSemverExact(dep.requiredVersion);
-      if (!version) continue;
-      dep.version = version;
-      dep.requiredVersion = caretRange(version);
-      dep.shareScope = dep.shareScope ?? "default";
-    }
-  } else {
-    for (const [name, cfg] of Object.entries(sharedUi)) {
-      const dep = cfg as SharedDepConfig;
-      const version = extractSemverExact(dep.version) ?? extractSemverExact(dep.requiredVersion);
-      if (!version) continue;
-      dep.version = version;
-      dep.requiredVersion = caretRange(version);
-      dep.shareScope = dep.shareScope ?? "default";
-      if (catalog[name] !== version) {
-        catalog[name] = version;
-      }
-    }
-    if (!pkgJson.workspaces) pkgJson.workspaces = { packages: [], catalog: {} };
-    pkgJson.workspaces.catalog = catalog;
-  }
-
-  const nextBos = JSON.stringify(bosConfig);
-  const nextPkg = JSON.stringify(pkgJson);
-  const bosConfigChanged = nextBos !== originalBos;
-  const catalogChanged = nextPkg !== originalPkg;
-
-  if (bosConfigChanged) {
-    if (mode === "catalog->bos") {
-      const resolvedDir = dirname(resolvedConfigPath);
-      if (!existsSync(resolvedDir)) {
-        mkdirSync(resolvedDir, { recursive: true });
-      }
-      const ordered = rebuildOrderedConfig(bosConfig);
-      const meta: ResolvedConfigMeta = {
-        env: opts.env ?? "development",
-        resolvedAt: new Date().toISOString(),
-        extendsChain: opts.extendsChain ?? [],
-        source: "shared-sync",
-      };
-      const resolvedOutput = {
-        _resolved: meta,
-        ...ordered,
-      };
-      writeFileIfChanged(resolvedConfigPath, `${JSON.stringify(resolvedOutput, null, 2)}\n`);
-    } else {
-      writeFileIfChanged(bosConfigPath, `${JSON.stringify(bosConfig, null, 2)}\n`);
-    }
-  }
-  if (catalogChanged) {
-    writeFileIfChanged(packageJsonPath, `${JSON.stringify(pkgJson, null, 2)}\n`);
-  }
-
-  const resolvedDeps: Record<string, SharedUiResolvedDep> = {};
-  for (const [name, cfg] of Object.entries(getSharedUiDeps(bosConfig))) {
-    const version =
-      catalog[name] ?? extractSemverExact(cfg.version) ?? extractSemverExact(cfg.requiredVersion);
-    if (!version) continue;
-    resolvedDeps[name] = {
-      name,
-      version,
-      requiredVersion: caretRange(version),
-      shareScope: cfg.shareScope ?? "default",
-      singleton: cfg.singleton ?? false,
-      eager: cfg.eager ?? false,
-      strictVersion: cfg.strictVersion ?? false,
-    };
-  }
-
-  const stableResolvedDeps = stableDepsObject(resolvedDeps);
-  const resolved: SharedUiResolved = {
-    deps: stableResolvedDeps,
-    fingerprintSha256: fingerprintResolved(stableResolvedDeps),
-  };
-
-  const nextGenerated = {
-    schemaVersion: 1,
-    kind: "everything-dev/shared-ui",
-    generatedAt: new Date().toISOString(),
-    ui: {
-      deps: stableResolvedDeps,
-      fingerprintSha256: resolved.fingerprintSha256,
-    },
-    inputs: {
-      mode,
-      hostMode: opts.hostMode,
-    },
-  };
-
-  let prevFingerprint: string | null = null;
-  try {
-    const prev = JSON.parse(readFileSync(generatedPath, "utf-8"));
-    prevFingerprint = prev?.ui?.fingerprintSha256 ?? null;
-  } catch {
-    // ignore
-  }
-
-  mkdirSync(dirname(generatedPath), { recursive: true });
-  writeFileIfChanged(generatedPath, `${JSON.stringify(nextGenerated, null, 2)}\n`);
-
-  const generatedChanged = prevFingerprint !== nextGenerated.ui.fingerprintSha256;
-
-  return {
-    mode,
-    hostMode: opts.hostMode,
-    bosConfigChanged,
-    catalogChanged,
-    generatedChanged,
-    resolved,
-  };
-}
-
-export function loadGeneratedSharedUi(configDir: string): SharedUiResolved | null {
-  const generatedPath = join(configDir, ".bos", "generated", "shared-ui.json");
-  try {
-    const content = JSON.parse(readFileSync(generatedPath, "utf-8"));
-    return content?.ui ?? null;
-  } catch {
-    return null;
-  }
-}

package/src/sidebar.ts

@@ -1,140 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import type { RuntimeConfig, SidebarItem } from "./types";
-
-const ICON_IMPORTS: Record<string, string> = {
-  Home: "lucide-react",
-  Globe: "lucide-react",
-  FolderKanban: "lucide-react",
-  Building2: "lucide-react",
-  Settings: "lucide-react",
-  User: "lucide-react",
-  Users: "lucide-react",
-  Shield: "lucide-react",
-  LayoutDashboard: "lucide-react",
-  CreditCard: "lucide-react",
-  Bell: "lucide-react",
-  Key: "lucide-react",
-  FileText: "lucide-react",
-  Database: "lucide-react",
-  Activity: "lucide-react",
-  BarChart3: "lucide-react",
-  Zap: "lucide-react",
-  Terminal: "lucide-react",
-  Code: "lucide-react",
-  Package: "lucide-react",
-  Store: "lucide-react",
-  ShoppingBag: "lucide-react",
-  Wallet: "lucide-react",
-  Coins: "lucide-react",
-  Plug: "lucide-react",
-  Link: "lucide-react",
-  ExternalLink: "lucide-react",
-  Puzzle: "lucide-react",
-  Layers: "lucide-react",
-  Grid3X3: "lucide-react",
-  AppWindow: "lucide-react",
-};
-
-function resolveIconModule(iconName: string): string {
-  if (ICON_IMPORTS[iconName]) return ICON_IMPORTS[iconName];
-  return "lucide-react";
-}
-
-function collectIconImports(items: SidebarItem[]): Map<string, Set<string>> {
-  const moduleMap = new Map<string, Set<string>>();
-  for (const item of items) {
-    const module = resolveIconModule(item.icon);
-    if (!moduleMap.has(module)) moduleMap.set(module, new Set());
-    moduleMap.get(module)!.add(item.icon);
-  }
-  return moduleMap;
-}
-
-export function generatePluginSidebarContent(runtimeConfig: RuntimeConfig): string {
-  const coreItems: SidebarItem[] = [{ icon: "Home", label: "home", to: "/", roleRequired: "anon" }];
-
-  if (runtimeConfig.auth?.sidebar) {
-    for (const item of runtimeConfig.auth.sidebar) {
-      coreItems.push({
-        ...item,
-        to: item.to ?? "/auth",
-        roleRequired: item.roleRequired ?? "member",
-      });
-    }
-  }
-
-  const pluginItems: SidebarItem[] = [];
-  if (runtimeConfig.plugins) {
-    for (const [key, entry] of Object.entries(runtimeConfig.plugins)) {
-      const sidebar = entry.sidebar;
-      if (!sidebar) continue;
-      for (const item of sidebar) {
-        pluginItems.push({
-          ...item,
-          to: item.to ?? `/${key}`,
-          roleRequired: item.roleRequired ?? "member",
-        });
-      }
-    }
-  }
-
-  const allItems = [...coreItems, ...pluginItems];
-  const moduleMap = collectIconImports(allItems);
-
-  const importLines: string[] = [];
-  for (const [module, icons] of moduleMap) {
-    const iconList = [...icons].join(", ");
-    importLines.push(`import { ${iconList} } from "${module}";`);
-  }
-
-  const itemsCode = allItems
-    .map(
-      (item) =>
-        `  { icon: ${item.icon}, label: "${item.label}", to: "${item.to}" as const, roleRequired: "${item.roleRequired}" as const },`,
-    )
-    .join("\n");
-
-  return `// Auto-generated by bos sync/pluginAdd/pluginRemove. Do not edit.
-${importLines.join("\n")}
-
-export type SidebarRole = "anon" | "member" | "admin";
-
-export interface SidebarItem {
-  icon: React.ComponentType<{ className?: string }>;
-  label: string;
-  to: string;
-  roleRequired: SidebarRole;
-}
-
-export const pluginSidebarItems: SidebarItem[] = [
-${itemsCode}
-];
-`;
-}
-
-export function writePluginSidebarGen(configDir: string, runtimeConfig: RuntimeConfig): string {
-  const outputPath = join(configDir, "ui/src/lib/plugin-sidebar.gen.ts");
-
-  const content = generatePluginSidebarContent(runtimeConfig);
-
-  const outputDir = dirname(outputPath);
-  if (!existsSync(outputDir)) {
-    mkdirSync(outputDir, { recursive: true });
-  }
-
-  let existingContent: string | null = null;
-  try {
-    existingContent = existsSync(outputPath)
-      ? // eslint-disable-next-line no-restricted-syntax
-        readFileSync(outputPath, "utf-8")
-      : null;
-  } catch {
-    // file doesn't exist yet
-  }
-
-  if (existingContent === content) return outputPath;
-
-  writeFileSync(outputPath, content);
-  return outputPath;
-}