@grove-dev/core 0.1.1

package/README.md

@@ -0,0 +1,89 @@
+# `@grove-dev/core`
+
+> Generic, framework-free engine for Grove.
+
+Headless TypeScript. Owns the resource schema, config loader, importers, validators, taxonomy types, optional GitHub signal sync, sitemap generation, llms.txt generation, and the data build pipeline. Zero framework dependencies — no Astro, no React, no Svelte.
+
+```bash
+pnpm add @grove-dev/core
+```
+
+## What it does
+
+- **Resource schema** — Zod-validated generic `Resource` model (name, description, type, url, repository, topics, tags, status, maintainers, organizations, metadata).
+- **Config** — `defineGroveConfig()` and `loadConfig()` for `curated.config.ts` projects.
+- **Importers** — parse Markdown awesome lists into structured records.
+- **Validators** — schema + reference checks (duplicate ids, missing descriptions, broken categories, unknown decisions).
+- **Taxonomy** — typed registry for stacks, platforms, categories, distribution channels.
+- **Build pipeline** — `buildData()` produces `data/generated/apps.{full,index}.json` and a typed `src/data/config.ts`.
+- **Sitemap & llms.txt** — `buildSitemap()` and `buildLlmsFiles()` for SEO and LLM-friendly output.
+- **Optional GitHub signal sync** — `fetchGithubMetadata()`, `classifyHealth()`, `enrichFromGithubHtml()` for spaces that want maintenance signals.
+- **Rate-limit aware** — `ghFetch()` and `pLimit()` for safe concurrent HTTP.
+
+## Public surface
+
+```ts
+import {
+  // Config
+  defineConfig,
+  loadConfig,
+
+  // Schemas
+  curatedConfigSchema,
+  resourceSchema,
+  healthEntrySchema,
+  decisionSchema,
+  itemsFileSchema,
+
+  // Build pipeline
+  buildData,
+  buildSiteConfigTs,
+
+  // Sitemap / llms
+  buildSitemap,
+  buildSitemapXml,
+  buildLlmsFiles,
+  buildLlmsTxt,
+  buildLlmsFullTxt,
+
+  // Decision / review
+  buildReviewReport,
+  pickReviewCandidates,
+
+  // Importers / parsers
+  importAwesomeList,
+  parseAppYaml,
+  normalizeAppRecord,
+  toIndexApp,
+  parseGithubRepoUrl,
+
+  // GitHub
+  fetchGithubMetadata,
+  classifyHealth,
+  healthFromSignals,
+  enrichFromGithubHtml,
+  ghFetch,
+  pLimit,
+
+  // IO
+  readYamlFile,
+  writeYamlFile,
+  writeTextFile,
+  stringifyAppYaml,
+
+  // Validate
+  validateProject,
+  validateAppRecord,
+} from "@grove-dev/core";
+```
+
+## Development
+
+```bash
+pnpm --filter @grove-dev/core build
+pnpm --filter @grove-dev/core check
+```
+
+## License
+
+MIT

package/dist/build-data.d.ts

@@ -0,0 +1,55 @@
+import { type CuratedConfig } from "./schema.js";
+/**
+ * The full payload written to data/generated/apps.full.json.
+ * Carries every normalized record, regardless of visibility.
+ */
+export interface AppsFullPayload {
+    schemaVersion: number;
+    generatedAt: string;
+    totalApps: number;
+    visibleApps: number;
+    apps: Array<Record<string, unknown>>;
+}
+/**
+ * The slim payload written to data/generated/apps.index.json.
+ * Carries only what list and search pages need.
+ */
+export interface AppsIndexPayload {
+    schemaVersion: number;
+    generatedAt: string;
+    totalApps: number;
+    apps: Array<Record<string, unknown>>;
+}
+/**
+ * The TS file written to src/data/config.ts. Sites import this for
+ * a typed view of curated.config.ts. Auto-generated; do not edit.
+ */
+export interface SiteConfigTsInput {
+    name: string;
+    tagline: string;
+    description: string;
+    siteUrl: string;
+    repoUrl: string;
+    itemLabel: string;
+}
+export declare function buildSiteConfigTs(input: SiteConfigTsInput): string;
+/**
+ * Read every apps/*.yml in the project, normalize, and build:
+ *  - data/generated/apps.full.json   (full records, all visibility)
+ *  - data/generated/apps.index.json  (slim, visible-only)
+ *  - data/generated/apps.json        (compatibility alias of apps.full.json)
+ *  - src/data/config.ts              (typed view of curated.config.ts)
+ *
+ * Returns a small summary; throws on schema errors.
+ */
+export interface BuildDataResult {
+    totalApps: number;
+    visibleApps: number;
+    fullPath: string;
+    indexPath: string;
+    aliasPath: string;
+    configTsPath: string;
+    errors: string[];
+}
+export declare function buildData(cwd?: string, config?: CuratedConfig): Promise<BuildDataResult>;
+//# sourceMappingURL=build-data.d.ts.map

package/dist/build-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-data.d.ts","sourceRoot":"","sources":["../src/build-data.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,aAAa,EAInB,MAAM,aAAa,CAAC;AAGrB;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAwBlE;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAsB,SAAS,CAC7B,GAAG,SAAgB,EACnB,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,eAAe,CAAC,CAyF1B"}

package/dist/build-data.js

@@ -0,0 +1,115 @@
+import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+import { normalizeAppRecord, parseAppYaml, toIndexApp, } from "./schema.js";
+import { loadConfig } from "./config.js";
+export function buildSiteConfigTs(input) {
+    return `/**
+ * AUTO-GENERATED by grove build-data — do not edit by hand.
+ * Re-run \`grove build-data\` after changing curated.config.ts.
+ */
+
+export type SiteConfig = {
+  name: string;
+  tagline: string;
+  description: string;
+  siteUrl: string;
+  repoUrl: string;
+  itemLabel: string;
+};
+
+export const siteConfig: SiteConfig = {
+  name: ${JSON.stringify(input.name)},
+  tagline: ${JSON.stringify(input.tagline)},
+  description: ${JSON.stringify(input.description)},
+  siteUrl: ${JSON.stringify(input.siteUrl)},
+  repoUrl: ${JSON.stringify(input.repoUrl)},
+  itemLabel: ${JSON.stringify(input.itemLabel)},
+};
+`;
+}
+export async function buildData(cwd = process.cwd(), config) {
+    const cfg = config ?? (await loadConfig(cwd));
+    const appsDir = resolve(cwd, cfg.paths.appsDir);
+    const outDir = resolve(cwd, cfg.paths.generatedDir);
+    await mkdir(outDir, { recursive: true });
+    let entries = [];
+    try {
+        entries = await readdir(appsDir);
+    }
+    catch {
+        entries = [];
+    }
+    const files = entries.filter((f) => f.endsWith(".yml")).sort();
+    const apps = [];
+    const errors = [];
+    for (const file of files) {
+        const fileSlug = basename(file, ".yml");
+        try {
+            const text = await readFile(join(appsDir, file), "utf8");
+            const raw = parseAppYaml(text, fileSlug);
+            const app = normalizeAppRecord(raw, fileSlug);
+            if (app.slug !== fileSlug) {
+                app.slug = fileSlug;
+            }
+            apps.push(app);
+        }
+        catch (err) {
+            errors.push(`${file}: ${err.message}`);
+        }
+    }
+    if (errors.length > 0) {
+        const e = new Error(`build-data failed: ${errors.length} schema error(s)`);
+        e.details = errors;
+        throw e;
+    }
+    apps.sort((a, b) => {
+        const sa = a.stars ?? 0;
+        const sb = b.stars ?? 0;
+        if (sb !== sa)
+            return sb - sa;
+        return (a.name ?? "").localeCompare(b.name ?? "");
+    });
+    const indexApps = apps
+        .map((app) => toIndexApp(app))
+        .filter((a) => a.visibility !== "hide");
+    const generatedAt = new Date().toISOString();
+    const fullPayload = {
+        schemaVersion: 1,
+        generatedAt,
+        totalApps: apps.length,
+        visibleApps: indexApps.length,
+        apps: apps,
+    };
+    const indexPayload = {
+        schemaVersion: 1,
+        generatedAt,
+        totalApps: indexApps.length,
+        apps: indexApps,
+    };
+    const fullPath = join(outDir, "apps.full.json");
+    const indexPath = join(outDir, "apps.index.json");
+    const aliasPath = join(outDir, "apps.json");
+    await writeFile(fullPath, JSON.stringify(fullPayload, null, 2), "utf8");
+    await writeFile(indexPath, JSON.stringify(indexPayload, null, 2), "utf8");
+    await writeFile(aliasPath, JSON.stringify(fullPayload, null, 2), "utf8");
+    const configTsPath = resolve(cwd, "src/data/config.ts");
+    const configTs = buildSiteConfigTs({
+        name: cfg.name,
+        tagline: cfg.tagline,
+        description: cfg.description ?? cfg.tagline,
+        siteUrl: cfg.siteUrl ?? "https://example.com",
+        repoUrl: cfg.repoUrl ?? "",
+        itemLabel: cfg.itemLabel,
+    });
+    await writeFile(configTsPath, configTs, "utf8");
+    return {
+        totalApps: apps.length,
+        visibleApps: indexApps.length,
+        fullPath,
+        indexPath,
+        aliasPath,
+        configTsPath,
+        errors,
+    };
+}
+//# sourceMappingURL=build-data.js.map

package/dist/build-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-data.js","sourceRoot":"","sources":["../src/build-data.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,5 @@
+import { type CuratedConfig } from "./schema.js";
+export type { CuratedConfig };
+export declare function loadConfig(cwd?: string, configPath?: string): Promise<CuratedConfig>;
+export declare function defineConfig(config: CuratedConfig): CuratedConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtE,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,wBAAsB,UAAU,CAAC,GAAG,SAAgB,EAAE,UAAU,SAAsB,GAAG,OAAO,CAAC,aAAa,CAAC,CAM9G;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAEjE"}

package/dist/config.js

@@ -0,0 +1,14 @@
+import { resolve } from "node:path";
+import { createJiti } from "jiti";
+import { curatedConfigSchema } from "./schema.js";
+export async function loadConfig(cwd = process.cwd(), configPath = "curated.config.ts") {
+    const resolved = resolve(cwd, configPath);
+    const jiti = createJiti(import.meta.url);
+    const mod = await jiti.import(resolved, { default: true });
+    const raw = mod.default ?? mod.config ?? mod;
+    return curatedConfigSchema.parse(raw);
+}
+export function defineConfig(config) {
+    return curatedConfigSchema.parse(config);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAsB,MAAM,aAAa,CAAC;AAItE,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,GAAG,mBAAmB;IACpF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAA4B,CAAC;IACtF,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC;IAC7C,OAAO,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,OAAO,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC"}

package/dist/decisions.d.ts

@@ -0,0 +1,28 @@
+import { type AppRecord } from "./schema.js";
+import { type CuratedConfig } from "./config.js";
+export interface ReviewCandidate {
+    slug: string;
+    name: string;
+    repoUrl: string;
+    status: string;
+    tier: string;
+    staleReason: string | null;
+    lastCommitAt: string | null;
+    stars: number;
+}
+export interface ReviewReport {
+    generatedAt: string;
+    totalCandidates: number;
+    candidates: ReviewCandidate[];
+}
+/** Compute the set of review candidates from normalized app records. */
+export declare function pickReviewCandidates(apps: AppRecord[]): AppRecord[];
+/**
+ * Read every apps/*.yml, normalize, then write data/generated/review-report.json
+ * with cleanup candidates (unknown / needs_review / cleanupCandidate).
+ */
+export declare function buildReviewReport(cwd?: string, config?: CuratedConfig): Promise<{
+    report: ReviewReport;
+    path: string;
+}>;
+//# sourceMappingURL=decisions.d.ts.map

package/dist/decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../src/decisions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAoC,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,KAAK,aAAa,EAAc,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B;AAeD,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAOnE;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,SAAgB,EACnB,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA6BjD"}

package/dist/decisions.js

@@ -0,0 +1,57 @@
+import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+import { normalizeAppRecord, parseAppYaml } from "./schema.js";
+import { loadConfig } from "./config.js";
+function toCandidate(app) {
+    return {
+        slug: app.slug,
+        name: app.name,
+        repoUrl: app.repoUrl,
+        status: app.status,
+        tier: app.tier,
+        staleReason: app.staleReason,
+        lastCommitAt: app.lastCommitAt ?? null,
+        stars: app.stars ?? 0,
+    };
+}
+/** Compute the set of review candidates from normalized app records. */
+export function pickReviewCandidates(apps) {
+    return apps.filter((app) => app.cleanupCandidate ||
+        app.status === "unknown" ||
+        app.status === "needs_review");
+}
+/**
+ * Read every apps/*.yml, normalize, then write data/generated/review-report.json
+ * with cleanup candidates (unknown / needs_review / cleanupCandidate).
+ */
+export async function buildReviewReport(cwd = process.cwd(), config) {
+    const cfg = config ?? (await loadConfig(cwd));
+    const appsDir = resolve(cwd, cfg.paths.appsDir);
+    const outDir = resolve(cwd, cfg.paths.generatedDir);
+    await mkdir(outDir, { recursive: true });
+    let entries = [];
+    try {
+        entries = await readdir(appsDir);
+    }
+    catch {
+        entries = [];
+    }
+    const files = entries.filter((f) => f.endsWith(".yml")).sort();
+    const apps = [];
+    for (const file of files) {
+        const fileSlug = basename(file, ".yml");
+        const text = await readFile(join(appsDir, file), "utf8");
+        const raw = parseAppYaml(text, fileSlug);
+        apps.push(normalizeAppRecord(raw, fileSlug));
+    }
+    const candidates = pickReviewCandidates(apps).map(toCandidate);
+    const report = {
+        generatedAt: new Date().toISOString(),
+        totalCandidates: candidates.length,
+        candidates,
+    };
+    const path = join(outDir, "review-report.json");
+    await writeFile(path, JSON.stringify(report, null, 2), "utf8");
+    return { report, path };
+}
+//# sourceMappingURL=decisions.js.map

package/dist/decisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.js","sourceRoot":"","sources":["../src/decisions.ts"],"names":[],"mappings":"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"}

package/dist/enrich.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Enrich GitHub repository metadata from public HTML + shields.io.
+ *
+ * Used as a token-free fallback when GitHub REST quota is exhausted.
+ * Scrapes the public github.com HTML page for license, language,
+ * topics, and homepage. Falls back to shields.io for license when
+ * the page render doesn't include the standard "X license" link text.
+ *
+ * The returned shape is compatible with the GitHub REST `repository`
+ * block used in `data/apps/<slug>.yml`, so a subsequent token-backed
+ * sync can fill in the rest of the fields.
+ */
+export interface EnrichedFields {
+    license: string | null;
+    language: string | null;
+    topics: string[];
+    homepage: string | null;
+}
+export interface EnrichResult {
+    fields: EnrichedFields;
+    notFound?: boolean;
+    rateLimited?: boolean;
+    error?: string;
+}
+export declare function enrichFromGithubHtml(repoUrl: string): Promise<EnrichResult>;
+//# sourceMappingURL=enrich.d.ts.map

package/dist/enrich.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich.d.ts","sourceRoot":"","sources":["../src/enrich.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AA+ED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAqCjF"}

package/dist/enrich.js

@@ -0,0 +1,121 @@
+/**
+ * Enrich GitHub repository metadata from public HTML + shields.io.
+ *
+ * Used as a token-free fallback when GitHub REST quota is exhausted.
+ * Scrapes the public github.com HTML page for license, language,
+ * topics, and homepage. Falls back to shields.io for license when
+ * the page render doesn't include the standard "X license" link text.
+ *
+ * The returned shape is compatible with the GitHub REST `repository`
+ * block used in `data/apps/<slug>.yml`, so a subsequent token-backed
+ * sync can fill in the rest of the fields.
+ */
+import { getOwnerRepoFromUrl } from "./schema.js";
+const HEADERS = {
+    Accept: "text/html,application/xhtml+xml",
+    "User-Agent": "grove-enricher",
+};
+async function fetchHtml(owner, repo) {
+    try {
+        const res = await fetch(`https://github.com/${owner}/${repo}`, { headers: HEADERS });
+        if (res.status === 404)
+            return { notFound: true };
+        if (res.status === 429)
+            return { rateLimited: true };
+        if (!res.ok)
+            return { error: `${res.status} ${res.statusText}` };
+        return { html: await res.text() };
+    }
+    catch (err) {
+        return { error: err.message };
+    }
+}
+function extractLicense(html) {
+    const m = html.match(/>([A-Z][A-Z0-9.+-]*-\d(?:\.\d)?)\s+license/i) ||
+        html.match(/>(MIT|Apache-2\.0|BSD-2-Clause|BSD-3-Clause|GPL-2\.0|GPL-3\.0|AGPL-3\.0|MPL-2\.0|ISC|Unlicense|0BSD)\s+license/i);
+    return m && m[1] ? m[1] : null;
+}
+async function fetchLicenseViaShields(owner, repo) {
+    try {
+        const res = await fetch(`https://img.shields.io/github/license/${owner}/${repo}`, {
+            headers: HEADERS,
+        });
+        if (!res.ok)
+            return null;
+        const svg = await res.text();
+        const m = svg.match(/<title>([^<]+)<\/title>/);
+        if (!m || !m[1])
+            return null;
+        const id = m[1].trim().replace(/^license:\s*/i, "").trim();
+        if (!id ||
+            id === "not specified" ||
+            id === "not identifiable by github" ||
+            id === "unknown" ||
+            id.toLowerCase().includes("business source")) {
+            return null;
+        }
+        return id;
+    }
+    catch {
+        return null;
+    }
+}
+function extractLanguage(html) {
+    const m = html.match(/class="color-fg-default text-bold mr-1">([^<]+)<\/span>/);
+    return m && m[1] ? m[1].trim() : null;
+}
+function extractTopics(html) {
+    const matches = html.matchAll(/<a href="\/topics\/[^"]+"[^>]*>([^<]+)<\/a>/g);
+    const out = [];
+    for (const m of matches) {
+        if (m[1]) {
+            const t = m[1].trim();
+            if (t)
+                out.push(t);
+        }
+    }
+    return [...new Set(out)];
+}
+function extractHomepage(html) {
+    const m = html.match(/<a [^>]*href="(https?:\/\/[^"]+)"[^>]*rel="nofollow"[^>]*>\s*Homepage\s*<\/a>/);
+    return m && m[1] ? m[1] : null;
+}
+export async function enrichFromGithubHtml(repoUrl) {
+    const ref = getOwnerRepoFromUrl(repoUrl);
+    if (!ref) {
+        return {
+            fields: { license: null, language: null, topics: [], homepage: null },
+            error: "invalid_repo_url",
+        };
+    }
+    const res = await fetchHtml(ref.owner, ref.repo);
+    if ("notFound" in res) {
+        return {
+            fields: { license: null, language: null, topics: [], homepage: null },
+            notFound: true,
+        };
+    }
+    if ("rateLimited" in res) {
+        return {
+            fields: { license: null, language: null, topics: [], homepage: null },
+            rateLimited: true,
+        };
+    }
+    if ("error" in res) {
+        return {
+            fields: { license: null, language: null, topics: [], homepage: null },
+            error: res.error,
+        };
+    }
+    const htmlLicense = extractLicense(res.html);
+    const license = htmlLicense ?? (await fetchLicenseViaShields(ref.owner, ref.repo));
+    return {
+        fields: {
+            license,
+            language: extractLanguage(res.html),
+            topics: extractTopics(res.html),
+            homepage: extractHomepage(res.html),
+        },
+    };
+}
+//# sourceMappingURL=enrich.js.map

package/dist/enrich.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich.js","sourceRoot":"","sources":["../src/enrich.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AASlD,MAAM,OAAO,GAA2B;IACtC,MAAM,EAAE,iCAAiC;IACzC,YAAY,EAAE,gBAAgB;CAC/B,CAAC;AAEF,KAAK,UAAU,SAAS,CAAC,KAAa,EAAE,IAAY;IAGlD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,sBAAsB,KAAK,IAAI,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACrF,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAClD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QACrD,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC;QACjE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;IACpC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,CAAC,GACL,IAAI,CAAC,KAAK,CAAC,6CAA6C,CAAC;QACzD,IAAI,CAAC,KAAK,CACR,iHAAiH,CAClH,CAAC;IACJ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,KAAK,UAAU,sBAAsB,CAAC,KAAa,EAAE,IAAY;IAC/D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,yCAAyC,KAAK,IAAI,IAAI,EAAE,EAAE;YAChF,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC/C,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7B,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3D,IACE,CAAC,EAAE;YACH,EAAE,KAAK,eAAe;YACtB,EAAE,KAAK,4BAA4B;YACnC,EAAE,KAAK,SAAS;YAChB,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAC5C,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACxC,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,8CAA8C,CAAC,CAAC;IAC9E,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACT,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAClB,+EAA+E,CAChF,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAe;IACxD,MAAM,GAAG,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO;YACL,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;YACrE,KAAK,EAAE,kBAAkB;SAC1B,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;QACtB,OAAO;YACL,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;YACrE,QAAQ,EAAE,IAAI;SACf,CAAC;IACJ,CAAC;IACD,IAAI,aAAa,IAAI,GAAG,EAAE,CAAC;QACzB,OAAO;YACL,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;YACrE,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;QACnB,OAAO;YACL,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;YACrE,KAAK,EAAE,GAAG,CAAC,KAAK;SACjB,CAAC;IACJ,CAAC;IACD,MAAM,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,WAAW,IAAI,CAAC,MAAM,sBAAsB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACnF,OAAO;QACL,MAAM,EAAE;YACN,OAAO;YACP,QAAQ,EAAE,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;YACnC,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC;YAC/B,QAAQ,EAAE,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;SACpC;KACF,CAAC;AACJ,CAAC"}

package/dist/github-client.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared GitHub API helpers used by the grove CLI.
+ *
+ *   - ghFetch:      fetch + JSON parse + 2-attempt exponential backoff
+ *   - rateLimitWaitMs: read X-RateLimit-Reset header and return ms to wait
+ *   - sleep:        small helper
+ *   - pLimit:       tiny concurrency cap (no external deps)
+ *
+ * These exist so a single transient 5xx doesn't fail an entire daily
+ * refresh, and so we can run the per-app loop with bounded concurrency
+ * instead of one round-trip at a time.
+ */
+export interface GhFetchOptions {
+    token?: string;
+    userAgent?: string;
+    attempts?: number;
+    onRateLimited?: () => number;
+}
+export declare function rateLimitWaitMs(res: Response, capMs?: number): number;
+export declare function sleep(ms: number): Promise<void>;
+export declare function ghFetch(path: string, options?: GhFetchOptions): Promise<Response>;
+/**
+ * Tiny p-limit implementation: a promise-pool that caps how many
+ * `fn(item)` calls run at once. Await the returned promise to get the
+ * full results array in input order.
+ */
+export declare function pLimit<T, U>(concurrency: number, items: T[], fn: (item: T, index: number) => Promise<U>): Promise<U[]>;
+//# sourceMappingURL=github-client.d.ts.map

package/dist/github-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-client.d.ts","sourceRoot":"","sources":["../src/github-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,MAAM,CAAC;CAC9B;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,SAAa,GAAG,MAAM,CAMzE;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/C;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuC3F;AAED;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAAE,CAAC,EAC/B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,CAAC,EAAE,EACV,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,CAAC,EAAE,CAAC,CAad"}