@grove-dev/astro 0.2.19 → 0.3.1

package/templates/default/scripts/migrate-legacy-to-schema-v1.mjs

@@ -1,86 +0,0 @@
-#!/usr/bin/env node
-// SPDX-License-Identifier: MIT
-
-/**
- * migrate-legacy-to-schema-v1.mjs — best-effort mapper from the
- * legacy OpenSourceApp shape (openapps v0 schema) into the
- * Grove V1 record shape (kind: project + Resource union).
- *
- * Reads `data/legacy/*.yml` (if present), writes
- * `data/records/*.yml`. Field-by-field mapping is documented
- * inline.
- */
-import { readFile, writeFile, readdir, mkdir } from "node:fs/promises";
-import { parse, stringify } from "yaml";
-import { dirname, basename, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const ROOT = join(__dirname, "..");
-const LEGACY_DIR = join(ROOT, "data", "legacy");
-const RECORDS_DIR = join(ROOT, "data", "records");
-const DRY_RUN = process.env.DRY_RUN === "1";
-
-function map(legacy) {
-  // Best-effort: openapps → grove V1. Fields with no clear
-  // equivalent are left for a human to fill in.
-  return {
-    kind: "project",
-    slug: legacy.slug ?? basename(legacy.__file ?? "unknown", ".yml"),
-    name: legacy.name ?? legacy.title ?? "",
-    description: legacy.description ?? legacy.summary ?? "",
-    repoUrl: legacy.repoUrl ?? legacy.source?.url ?? "",
-    homepageUrl: legacy.homepageUrl ?? legacy.links?.website ?? "",
-    category: legacy.category ?? "tools",
-    stack: legacy.stack ?? legacy.stacks?.[0] ?? "",
-    stacks: Array.isArray(legacy.stacks) ? legacy.stacks.slice(1).filter(Boolean) : [],
-    platforms: legacy.platforms ?? [],
-    tags: legacy.tags ?? [],
-    stars: legacy.stars,
-    license: legacy.license,
-    status: legacy.status,
-    bestFor: legacy.bestFor ?? [],
-    whyListed: legacy.whyListed ?? [],
-    caveats: legacy.caveats ?? [],
-    curation: {
-      reviewed: Boolean(legacy.curation?.reviewed),
-      by: legacy.curation?.by,
-      date: legacy.curation?.date,
-      labels: legacy.labels ?? legacy.curation?.labels ?? [],
-    },
-  };
-}
-
-async function main() {
-  let files = [];
-  try {
-    files = (await readdir(LEGACY_DIR)).filter((f) => f.endsWith(".yml")).sort();
-  } catch {
-    console.error("No data/legacy directory. Drop legacy yml files in there and re-run.");
-    process.exit(1);
-  }
-
-  if (!DRY_RUN) await mkdir(RECORDS_DIR, { recursive: true });
-  let migrated = 0;
-  for (const file of files) {
-    const text = await readFile(join(LEGACY_DIR, file), "utf8");
-    const raw = parse(text) ?? {};
-    raw.__file = file;
-    const rec = map(raw);
-    const slug = rec.slug || basename(file, ".yml");
-    const dest = join(RECORDS_DIR, `${slug}.yml`);
-    if (DRY_RUN) {
-      console.log(`  ~ ${file} → ${slug}.yml (dry-run)`);
-    } else {
-      await writeFile(dest, stringify(rec), "utf8");
-      console.log(`  ✓ ${file} → ${slug}.yml`);
-    }
-    migrated++;
-  }
-  console.log(`Migrated ${migrated} legacy record${migrated === 1 ? "" : "s"}.`);
-}
-
-main().catch((err) => {
-  console.error("migrate-legacy-to-schema-v1 failed:", err);
-  process.exit(1);
-});

package/templates/default/scripts/parse-legacy-readme.mjs

@@ -1,59 +0,0 @@
-#!/usr/bin/env node
-// SPDX-License-Identifier: MIT
-
-/**
- * parse-legacy-readme.mjs — best-effort parser for legacy yml
- * records that ship a `readme` block (Markdown body + frontmatter)
- * instead of the V1 schema fields.
- *
- * Walks `data/records/*.yml`, splits `readme` into a `content`
- * file under `content/records/<slug>.md`, and produces a
- * `migration-report.md` summarizing which fields it filled in
- * (or could not).
- */
-import { readFile, writeFile, readdir, mkdir } from "node:fs/promises";
-import { dirname, basename, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const ROOT = join(__dirname, "..");
-const RECORDS_DIR = join(ROOT, "data", "records");
-const CONTENT_DIR = join(ROOT, "content", "records");
-const DRY_RUN = process.env.DRY_RUN === "1";
-
-async function main() {
-  let files = [];
-  try {
-    files = (await readdir(RECORDS_DIR)).filter((f) => f.endsWith(".yml")).sort();
-  } catch {
-    console.error("No data/records directory.");
-    process.exit(1);
-  }
-
-  const report = [];
-  for (const file of files) {
-    const path = join(RECORDS_DIR, file);
-    const text = await readFile(path, "utf8");
-    if (!/^readme:\s*\|/m.test(text)) {
-      report.push(`${file}: no legacy readme block`);
-      continue;
-    }
-    const slug = basename(file, ".yml");
-    const outPath = join(CONTENT_DIR, `${slug}.md`);
-    if (!DRY_RUN) {
-      await mkdir(dirname(outPath), { recursive: true });
-      const body = text
-        .split(/^readme:\s*\|\s*$/m)[1] ?? ""
-        .split(/^[a-z]+:/m)[0] ?? "";
-      await writeFile(outPath, body.trim(), "utf8");
-    }
-    report.push(`${file}: extracted readme → content/records/${slug}.md`);
-  }
-
-  console.log(report.join("\n"));
-}
-
-main().catch((err) => {
-  console.error("parse-legacy-readme failed:", err);
-  process.exit(1);
-});

package/templates/default/scripts/refresh-records-activity.mjs

@@ -1,24 +0,0 @@
-#!/usr/bin/env node
-// SPDX-License-Identifier: MIT
-
-/**
- * refresh-records-activity.mjs — daily activity refresh.
- *
- * Wrapper around `grove sync github` (the same command used by
- * the weekly metadata sync, but the action wires it to a daily
- * cron so the directory stays current with each app's recent
- * commit history and GitHub stars).
- */
-import { spawnSync } from "node:child_process";
-
-const result = spawnSync("grove", ["sync", "github"], {
-  stdio: "inherit",
-  env: process.env,
-});
-
-if (result.error) {
-  console.error("Failed to spawn `grove sync github`:", result.error.message);
-  process.exit(1);
-}
-
-process.exit(result.status ?? 0);

package/templates/default/scripts/repair-license-format.mjs

@@ -1,72 +0,0 @@
-#!/usr/bin/env node
-// SPDX-License-Identifier: MIT
-
-/**
- * repair-license-format.mjs — normalize the `license` field on
- * every record yml. Maps common GitHub-shaped license keys
- * ("agpl-3.0", "Apache-2.0", "mit") to their SPDX IDs.
- */
-import { readFile, writeFile, readdir } from "node:fs/promises";
-import { parse, stringify } from "node:yaml";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const ROOT = join(__dirname, "..");
-const RECORDS_DIR = join(ROOT, "data", "records");
-const DRY_RUN = process.env.DRY_RUN === "1";
-
-const LICENSE_MAP = {
-  "mit": "MIT",
-  "apache-2.0": "Apache-2.0",
-  "apache 2.0": "Apache-2.0",
-  "gpl-3.0": "GPL-3.0",
-  "gpl-2.0": "GPL-2.0",
-  "lgpl-2.1": "LGPL-2.1",
-  "lgpl-3.0": "LGPL-3.0",
-  "agpl-3.0": "AGPL-3.0",
-  "bsd-3-clause": "BSD-3-Clause",
-  "bsd-2-clause": "BSD-2-Clause",
-  "isc": "ISC",
-  "mpl-2.0": "MPL-2.0",
-  "unlicense": "Unlicense",
-  "wtfpl": "WTFPL",
-};
-
-function normalize(license) {
-  if (!license) return license;
-  const k = String(license).trim().toLowerCase();
-  return LICENSE_MAP[k] ?? license;
-}
-
-async function main() {
-  let files = [];
-  try {
-    files = (await readdir(RECORDS_DIR)).filter((f) => f.endsWith(".yml")).sort();
-  } catch {
-    console.error("No data/records directory. Run `grove init` first.");
-    process.exit(1);
-  }
-
-  let repaired = 0;
-  for (const file of files) {
-    const path = join(RECORDS_DIR, file);
-    const rec = parse(await readFile(path, "utf8")) ?? {};
-    const normalized = normalize(rec.license);
-    if (normalized === rec.license) continue;
-    rec.license = normalized;
-    if (DRY_RUN) {
-      console.log(`  ~ ${file} → ${normalized}`);
-    } else {
-      await writeFile(path, stringify(rec), "utf8");
-      console.log(`  ✓ ${file} → ${normalized}`);
-    }
-    repaired++;
-  }
-  console.log(`Repaired ${repaired} record${repaired === 1 ? "" : "s"}.`);
-}
-
-main().catch((err) => {
-  console.error("repair-license-format failed:", err);
-  process.exit(1);
-});

package/templates/default/scripts/report-cleanup-candidates.mjs

@@ -1,21 +0,0 @@
-#!/usr/bin/env node
-// SPDX-License-Identifier: MIT
-
-/**
- * report-cleanup-candidates.mjs — flag records that look like
- * they should be archived. Wrapper around `grove cleanup stale`,
- * which writes a markdown report under `data/generated/`.
- */
-import { spawnSync } from "node:child_process";
-
-const result = spawnSync("grove", ["cleanup", "stale"], {
-  stdio: "inherit",
-  env: process.env,
-});
-
-if (result.error) {
-  console.error("Failed to spawn `grove cleanup stale`:", result.error.message);
-  process.exit(1);
-}
-
-process.exit(result.status ?? 0);

package/templates/default/scripts/seed-from-github.mjs

@@ -1,62 +0,0 @@
-#!/usr/bin/env node
-// SPDX-License-Identifier: MIT
-
-/**
- * seed-from-github.mjs — interactive seeder for the first
- * record. Given a GitHub URL, fetch the metadata and write a
- * starter yml to `data/records/<slug>.yml`. Useful for the
- * "add my repo" onboarding path.
- */
-import { mkdir, writeFile } from "node:fs/promises";
-import { parse, stringify } from "yaml";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const ROOT = join(__dirname, "..");
-const RECORDS_DIR = join(ROOT, "data", "records");
-
-const url = process.argv[2];
-if (!url) {
-  console.error("Usage: node seed-from-github.mjs <github-url>");
-  process.exit(1);
-}
-
-const match = String(url).match(/github\.com\/([^/]+)\/([^/?#]+)/);
-if (!match) {
-  console.error("Not a GitHub URL:", url);
-  process.exit(1);
-}
-const owner = match[1];
-const repo = match[2].replace(/\.git$/, "");
-
-const res = await fetch(`https://api.github.com/repos/${owner}/${repo}`, {
-  headers: { Accept: "application/vnd.github+json", "User-Agent": "grove-seeder" },
-});
-if (!res.ok) {
-  console.error("GitHub returned", res.status);
-  process.exit(1);
-}
-const r = await res.json();
-const slug = repo.toLowerCase();
-const rec = {
-  kind: "project",
-  slug,
-  name: r.name,
-  description: r.description ?? "",
-  repoUrl: r.html_url,
-  homepageUrl: r.homepage ?? "",
-  category: "tools",
-  stack: r.language ?? "",
-  stacks: [],
-  platforms: [],
-  tags: r.topics ?? [],
-  stars: r.stargazers_count,
-  license: r.license?.spdx_id ?? "",
-  status: r.archived ? "archived" : "active",
-  curation: { reviewed: false, labels: [] },
-};
-
-await mkdir(RECORDS_DIR, { recursive: true });
-await writeFile(join(RECORDS_DIR, `${slug}.yml`), stringify(rec), "utf8");
-console.log(`Wrote ${slug}.yml`);

package/templates/default/scripts/sync-contributors.mjs

@@ -1,145 +0,0 @@
-#!/usr/bin/env node
-/**
- * sync-contributors — fetch contributors for every record's repoUrl
- * and write `data/generated/contributors.json` (consumed by the home
- * page and the /contributors page).
- *
- * Generic: walks every record in data/generated/records.index.json,
- * looks at record.github.fullName or links.github, and calls the
- * GitHub /repos/{owner}/{repo}/contributors endpoint. Aggregates by
- * owner (across all of an owner's projects in the directory).
- *
- * Anonymous contributors are excluded — the home grid renders <a>
- * avatars, and a name-less contributor is more confusing than
- * missing.
- *
- * Usage:  node scripts/sync-contributors.mjs
- * Env:    GH_TOKEN  — required for >60 req/h. Falls back to unauth.
- *
- * V1 intentionally small: no retries, no rate-limit backoff beyond
- * the basic 403-detection. The weekly schedule in
- * .github/workflows/sync-contributors.yml is loose enough that
- * re-running the workflow is a fine recovery path.
- */
-import { readFile, writeFile, mkdir } from "node:fs/promises";
-import { dirname, resolve } from "node:path";
-
-const HERE = new URL(".", import.meta.url).pathname;
-const ROOT = resolve(HERE, "..");
-const GENERATED = resolve(ROOT, "data", "generated");
-const INDEX_PATH = resolve(GENERATED, "records.index.json");
-const OUT_PATH = resolve(GENERATED, "contributors.json");
-
-const GH_TOKEN = process.env.GH_TOKEN || process.env.GITHUB_TOKEN || "";
-const HEADERS = {
-  Accept: "application/vnd.github+json",
-  "User-Agent": "grove-sync-contributors",
-  "X-GitHub-Api-Version": "2022-11-28",
-  ...(GH_TOKEN ? { Authorization: `Bearer ${GH_TOKEN}` } : {}),
-};
-
-function ownerRepoFromFullName(fullName) {
-  if (!fullName || !fullName.includes("/")) return null;
-  const [owner, repo] = fullName.split("/", 2);
-  return { owner, repo };
-}
-
-async function ghJson(url) {
-  const res = await fetch(url, { headers: HEADERS });
-  if (res.status === 204) return null;
-  if (res.status === 403) {
-    const remaining = res.headers.get("x-ratelimit-remaining");
-    if (remaining === "0") {
-      throw new Error(`rate-limited (403) on ${url}`);
-    }
-    return null;
-  }
-  if (res.status === 404) return null;
-  if (!res.ok) throw new Error(`HTTP ${res.status} on ${url}`);
-  return res.json();
-}
-
-async function fetchContributorsForRepo(owner, repo) {
-  // GitHub caps /contributors at 500; for our purposes (fanning into
-  // a home grid) we only need the first page. Anonymous entries
-  // (no `login`) are dropped at parse time.
-  const url = `https://api.github.com/repos/${owner}/${repo}/contributors?per_page=100&anon=false`;
-  const data = await ghJson(url);
-  if (!Array.isArray(data)) return [];
-  return data
-    .filter((c) => c && c.login)
-    .map((c) => ({
-      username: c.login,
-      avatarUrl: c.avatar_url,
-      profileUrl: c.html_url,
-      contributions: c.contributions ?? 0,
-    }));
-}
-
-async function main() {
-  let index;
-  try {
-    index = JSON.parse(await readFile(INDEX_PATH, "utf8"));
-  } catch (err) {
-    console.error(`Could not read ${INDEX_PATH}: ${err.message}`);
-    console.error("Run `pnpm run build:data` first.");
-    process.exit(1);
-  }
-
-  const records = Array.isArray(index.records) ? index.records : [];
-  // Group by owner — a single person with three projects in the
-  // directory shows up once with the summed contribution count.
-  const byOwner = new Map();
-  const seenRepos = new Set();
-
-  for (const r of records) {
-    const gh = r.github || {};
-    const ref = ownerRepoFromFullName(gh.fullName) || (() => {
-      const url = r.repoUrl || (r.links && r.links.github) || "";
-      const m = /github\.com\/([^/]+)\/([^/?#]+)/.exec(url);
-      return m ? { owner: m[1], repo: m[2].replace(/\.git$/, "") } : null;
-    })();
-    if (!ref) continue;
-    if (seenRepos.has(`${ref.owner}/${ref.repo}`)) continue;
-    seenRepos.add(`${ref.owner}/${ref.repo}`);
-
-    try {
-      const list = await fetchContributorsForRepo(ref.owner, ref.repo);
-      for (const c of list) {
-        const existing = byOwner.get(c.username);
-        if (existing) {
-          existing.contributions = (existing.contributions ?? 0) + c.contributions;
-        } else {
-          byOwner.set(c.username, c);
-        }
-      }
-      console.log(`  ${ref.owner}/${ref.repo}: ${list.length} contributors`);
-    } catch (err) {
-      console.warn(`  ${ref.owner}/${ref.repo}: ${err.message}`);
-    }
-  }
-
-  const contributors = [...byOwner.values()].sort(
-    (a, b) => (b.contributions ?? 0) - (a.contributions ?? 0),
-  );
-
-  await mkdir(dirname(OUT_PATH), { recursive: true });
-  await writeFile(
-    OUT_PATH,
-    JSON.stringify(
-      {
-        generatedAt: new Date().toISOString(),
-        contributors,
-      },
-      null,
-      2,
-    ),
-    "utf8",
-  );
-  console.log(`\nWrote ${contributors.length} contributors → ${OUT_PATH}`);
-}
-
-main().catch((err) => {
-  console.error(err.stack || err.message);
-  process.exit(1);
-});

package/templates/default/scripts/sync-github-metadata.mjs

@@ -1,28 +0,0 @@
-#!/usr/bin/env node
-// SPDX-License-Identifier: MIT
-
-/**
- * sync-github-metadata.mjs — full metadata sync from GitHub's
- * REST API. Wrapper around `@grove-dev/cli sync github`.
- *
- * Refreshes stargazers_count, forks_count, license, default branch,
- * pushed_at, language, topics, and the contributor list for every
- * record whose `repoUrl` is a GitHub repository.
- *
- * Writes back into the corresponding `data/records/<slug>.yml` (the
- * CLI is conservative — only fills in fields that are currently
- * empty).
- */
-import { spawnSync } from "node:child_process";
-
-const result = spawnSync("grove", ["sync", "github"], {
-  stdio: "inherit",
-  env: process.env,
-});
-
-if (result.error) {
-  console.error("Failed to spawn `grove sync github`:", result.error.message);
-  process.exit(1);
-}
-
-process.exit(result.status ?? 0);

package/templates/default/scripts/validate-records.mjs

@@ -1,27 +0,0 @@
-#!/usr/bin/env node
-// SPDX-License-Identifier: MIT
-
-/**
- * validate-records.mjs — Zod-schema validation for every record yml.
- *
- * Thin wrapper around `@grove-dev/cli`'s `validate` command so the
- * `pnpm run validate:data` script works without V0 command names.
- *
- * For schema authoring see `packages/core/src/schema.ts`. The CLI
- * handles every blueprint (project-directory, resource-hub,
- * ecosystem-map) and every record kind (project, resource, entity).
- */
-import { spawnSync } from "node:child_process";
-
-const result = spawnSync("grove", ["validate"], {
-  stdio: "inherit",
-  env: process.env,
-});
-
-if (result.error) {
-  console.error("Failed to spawn `grove validate`:", result.error.message);
-  console.error("Make sure `@grove-dev/cli` is installed and on PATH.");
-  process.exit(1);
-}
-
-process.exit(result.status ?? 0);