Function handleVersionSync

scripts/sync-plugin-skills.ts:201–256

(opts: SyncOptions)

// Returns a drift description string (for check mode), or empty string if in sync.
// In write mode, mutates the files and always returns empty string.
async function handleVersionSync(opts: SyncOptions): Promise<string> {
  const srcPath = join(opts.cwd, VERSION_SOURCE_PACKAGE_JSON);
  if (!existsSync(srcPath)) return "";
  const srcVersion: string = JSON.parse(
    await readFile(srcPath, "utf8"),
  ).version;

  const pluginPath = join(opts.cwd, PLUGIN_JSON);
  const marketPath = join(opts.cwd, MARKETPLACE_JSON);

  if (existsSync(pluginPath)) {
    const plugin = JSON.parse(await readFile(pluginPath, "utf8"));
    if (plugin.version !== srcVersion) {
      if (opts.mode === "check") {
        return `plugin.json version is "${plugin.version}", expected "${srcVersion}" (from ${VERSION_SOURCE_PACKAGE_JSON})`;
      }
      plugin.version = srcVersion;
      await writeFile(pluginPath, JSON.stringify(plugin, null, 2) + "\n");
    }
  }

  if (existsSync(marketPath)) {
    const market = JSON.parse(await readFile(marketPath, "utf8"));
    const marketVersion = market.plugins?.[0]?.version;
    const metadataVersion = market.metadata?.version;
    // Both version fields in marketplace.json track the runtime package. They
    // are checked together so neither rots independently — metadata.version was
    // historically unmanaged and drifted behind plugins[0].version.
    if (marketVersion !== srcVersion) {
      if (opts.mode === "check") {
        return `marketplace.json plugins[0].version is "${marketVersion}", expected "${srcVersion}" (from ${VERSION_SOURCE_PACKAGE_JSON})`;
      }
    }
    if (metadataVersion !== undefined && metadataVersion !== srcVersion) {
      if (opts.mode === "check") {
        return `marketplace.json metadata.version is "${metadataVersion}", expected "${srcVersion}" (from ${VERSION_SOURCE_PACKAGE_JSON})`;
      }
    }
    if (opts.mode === "write") {
      let mutated = false;
      if (market.plugins?.[0] && marketVersion !== srcVersion) {
        market.plugins[0].version = srcVersion;
        mutated = true;
      }
      if (market.metadata && metadataVersion !== srcVersion) {
        market.metadata.version = srcVersion;
        mutated = true;
      }
      if (mutated) {
        await writeFile(marketPath, JSON.stringify(market, null, 2) + "\n");
      }
    }
  }

  return "";
}

// ─── CLI ─────────────────────────────────────────────────────────────────────