Function syncPluginSkills

scripts/sync-plugin-skills.ts:87–195

(opts: SyncOptions)

// ─── Main ────────────────────────────────────────────────────────────────────

export async function syncPluginSkills(opts: SyncOptions): Promise<SyncResult> {
  const skills = await findPackageSkills(opts.cwd);

  // Collision check.
  for (const s of skills) {
    if (RESERVED_LIFECYCLE_SLUGS.has(s.slug)) {
      return {
        exitCode: 2,
        message: `package skill slug "${s.slug}" collides with reserved lifecycle slug. Rename the package skill.`,
        changed: [],
        orphans: [],
      };
    }
  }

  const changed: string[] = [];
  const orphans: string[] = [];

  for (const s of skills) {
    const files = await listFilesRec(s.sourceDir);
    for (const relPath of files) {
      const srcPath = join(s.sourceDir, relPath);
      const dstPath = join(s.mirrorDir, relPath);
      const src = await readFile(srcPath);

      if (opts.mode === "check") {
        if (!existsSync(dstPath)) {
          changed.push(toPosix(join("skills", s.slug, relPath)));
          continue;
        }
        const dst = await readFile(dstPath);
        if (!src.equals(dst))
          changed.push(toPosix(join("skills", s.slug, relPath)));
      } else {
        await mkdir(dirname(dstPath), { recursive: true });
        await writeFile(dstPath, src);
      }
    }

    // Detect orphan files — files in mirror that are not in source.
    if (existsSync(s.mirrorDir)) {
      const mirrorFiles = await listFilesRec(s.mirrorDir);
      const sourceSet = new Set(files);
      for (const mf of mirrorFiles) {
        if (!sourceSet.has(mf))
          orphans.push(toPosix(join("skills", s.slug, mf)));
      }
    }
  }

  // Full-dir orphan scan — detect mirror skills directories whose source package
  // was removed entirely. The main loop cannot catch these because it only
  // iterates over currently discovered source skills.
  const mirrorRoot = join(opts.cwd, "skills");
  if (existsSync(mirrorRoot)) {
    const sourceSlugs = new Set(skills.map((s) => s.slug));
    const mirrorEntries = await readdir(mirrorRoot, { withFileTypes: true });
    for (const entry of mirrorEntries) {