@grove-dev/astro 0.2.20 → 0.3.1

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

@@ -1,99 +0,0 @@
-#!/usr/bin/env node
-// SPDX-License-Identifier: MIT
-
-/**
- * enrich-github-metadata.mjs — HTML fallback for records that
- * haven't been touched by the API sync. Walks the public GitHub
- * HTML page for each repo and pulls topics, language, license,
- * homepage into the yml file.
- *
- * Lightweight (no auth required), but slower and less reliable
- * than `sync-github-metadata.mjs` (the API version). Use this as
- * a fallback when the API rate-limit is exhausted.
- */
-import { readFile, writeFile, readdir } 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 DRY_RUN = process.env.DRY_RUN === "1";
-
-const HEADERS = {
-  Accept: "text/html,application/xhtml+xml",
-  "User-Agent": "grove-enricher",
-};
-
-function ownerRepo(repoUrl) {
-  if (!repoUrl) return null;
-  const m = String(repoUrl).match(/github\.com\/([^/]+)\/([^/?#]+)/);
-  if (!m) return null;
-  return { owner: m[1], repo: m[2].replace(/\.git$/, "") };
-}
-
-async function fetchHtml(owner, repo) {
-  try {
-    const res = await fetch(`https://github.com/${owner}/${repo}`, { headers: HEADERS });
-    if (!res.ok) return null;
-    return await res.text();
-  } catch {
-    return null;
-  }
-}
-
-function extractMeta(html) {
-  if (!html) return {};
-  const out = {};
-  const topicMatches = html.matchAll(/data-octo-click="topic_click"[^>]*>([^<]+)</g);
-  if (topicMatches) {
-    const topics = [...topicMatches].map((m) => m[1].trim()).filter(Boolean);
-    if (topics.length) out.topics = topics;
-  }
-  const lang = html.match(/<span class="color-fg-default text-bold mr-1"[^>]*>([^<]+)</);
-  if (lang) out.language = lang[1].trim();
-  const license = html.match(/This repository is under the ([^<.]+) License/i);
-  if (license) out.license = license[1].trim();
-  return out;
-}
-
-async function main() {
-  let files = [];
-  try {
-    files = (await readdir(RECORDS_DIR)).filter((f) => f.endsWith(".yml")).sort();
-  } catch (err) {
-    console.error("No data/records directory. Run `grove init` first.");
-    process.exit(1);
-  }
-
-  let enriched = 0;
-  for (const file of files) {
-    const path = join(RECORDS_DIR, file);
-    const text = await readFile(path, "utf8");
-    const rec = parse(text) ?? {};
-    const { owner, repo } = ownerRepo(rec.repoUrl ?? rec.links?.github) ?? {};
-    if (!owner) continue;
-    const html = await fetchHtml(owner, repo);
-    const meta = extractMeta(html);
-    const before = JSON.stringify(rec);
-    if (meta.topics && !rec.topics) rec.topics = meta.topics;
-    if (meta.language && !rec.language) rec.language = meta.language;
-    if (meta.license && !rec.license) rec.license = meta.license;
-    const after = JSON.stringify(rec);
-    if (before === after) continue;
-    if (DRY_RUN) {
-      console.log(`  ~ ${file} (dry-run)`);
-    } else {
-      await writeFile(path, stringify(rec), "utf8");
-      console.log(`  ✓ ${file}`);
-    }
-    enriched++;
-  }
-  console.log(`Enriched ${enriched} record${enriched === 1 ? "" : "s"}.`);
-}
-
-main().catch((err) => {
-  console.error("enrich-github-metadata failed:", err);
-  process.exit(1);
-});

package/templates/default/scripts/fetch-icons.mjs

@@ -1,137 +0,0 @@
-#!/usr/bin/env node
-// SPDX-License-Identifier: MIT
-
-/**
- * fetch-icons.mjs — download brand icons from the public
- * `xandemon/developer-icons` repository (CC0 licensed) and save them
- * to `public/icons/` so Astro can serve them as static assets.
- *
- * Run automatically before dev/build via the npm scripts.
- *
- * Icon map below mirrors the openapps catalogue. Add or remove
- * entries as the blueprint's taxonomy evolves.
- */
-import { mkdir, writeFile, access } from "node:fs/promises";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const ROOT = resolve(__dirname, "..");
-const OUT_BASE = join(ROOT, "public", "icons");
-
-const SOURCE = "https://raw.githubusercontent.com/xandemon/developer-icons/main/icons";
-
-// Stack icons (xandemon/developer-icons naming).
-// Names suffixed with `(custom)` are hand-drawn SVGs committed
-// to the repo because the upstream xandemon/developer-icons
-// collection doesn't include them. The script preserves them on
-// subsequent runs (it never overwrites an existing file unless
-// the URL fetch succeeds).
-const STACK_ICONS = [
-  "android",
-  "apple-dark",
-  "apple-light",
-  "bun",         // custom
-  "capacitor",
-  "clojure",     // custom
-  "clojurescript", // custom
-  "dart",
-  "deno",        // custom
-  "django",      // custom
-  "docker",      // custom
-  "firebase",
-  "flutter",
-  "go",          // custom
-  "graphql",
-  "ionic",
-  "java",
-  "javascript",
-  "kotlin",
-  "llm",         // custom
-  "mongodb",
-  "node.js",     // xandemon uses "nodejs"; we ship "node.js" for the home page link
-  "nodejs",      // (alias — both should resolve to the same file)
-  "python",
-  "react",
-  "react-native",
-  "rust",
-  "solidity",
-  "sveltekit",   // custom
-  "swift",
-  "tensorflow",
-  "typescript",
-  "vue",         // custom
-];
-
-// Platform icons (custom paths under /icons/platforms/).
-const PLATFORM_ICONS = [
-  "android",
-  "apple-dark",
-  "apple-light",
-  "chrome",
-  "chromeos",
-  "desktop",
-  "embedded",
-  "ios",
-  "linux",
-  "macos",
-  "ubuntu",
-  "web",
-  "windows",
-];
-
-async function exists(p) {
-  try { await access(p); return true; } catch { return false; }
-}
-
-async function fetchAndSave(url, dest) {
-  const res = await fetch(url);
-  if (!res.ok) throw new Error(`Failed to fetch ${url}: ${res.status}`);
-  const buf = Buffer.from(await res.arrayBuffer());
-  await mkdir(dirname(dest), { recursive: true });
-  await writeFile(dest, buf);
-}
-
-async function main() {
-  // Stack icons
-  const stackDir = join(OUT_BASE, "stacks");
-  if (!(await exists(stackDir))) await mkdir(stackDir, { recursive: true });
-  for (const name of STACK_ICONS) {
-    const url = `${SOURCE}/${name}/${name}-original.svg`;
-    const dest = join(stackDir, `${name}.svg`);
-    try {
-      await fetchAndSave(url, dest);
-      console.log(`  ✓ stack/${name}`);
-    } catch (err) {
-      console.warn(`  ✗ stack/${name}: ${err.message}`);
-    }
-  }
-
-  // Platform icons (apple-dark / apple-light already downloaded as
-  // stack icons; we re-use them under platforms/).
-  const platDir = join(OUT_BASE, "platforms");
-  if (!(await exists(platDir))) await mkdir(platDir, { recursive: true });
-  for (const name of PLATFORM_ICONS) {
-    const src = join(stackDir, `${name}.svg`);
-    const dest = join(platDir, `${name}.svg`);
-    if (await exists(src)) {
-      const buf = await (await import("node:fs/promises")).readFile(src);
-      await writeFile(dest, buf);
-      console.log(`  ✓ platform/${name} (from stack cache)`);
-    } else {
-      // Try a direct fetch as a fallback.
-      const url = `${SOURCE}/${name}/${name}-original.svg`;
-      try {
-        await fetchAndSave(url, dest);
-        console.log(`  ✓ platform/${name}`);
-      } catch (err) {
-        console.warn(`  ✗ platform/${name}: ${err.message}`);
-      }
-    }
-  }
-}
-
-main().catch((err) => {
-  console.error("fetch-icons failed:", err);
-  process.exit(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`);