@grove-dev/core 0.1.1

package/dist/github-client.js

@@ -0,0 +1,91 @@
+/**
+ * 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.
+ */
+const DEFAULT_HEADERS = {
+    Accept: "application/vnd.github+json",
+    "X-GitHub-Api-Version": "2022-11-28",
+    "User-Agent": "grove-bot",
+};
+export function rateLimitWaitMs(res, capMs = 5 * 60_000) {
+    const reset = res.headers.get("x-ratelimit-reset");
+    if (!reset)
+        return 0;
+    const resetMs = Number(reset) * 1000 - Date.now();
+    if (!Number.isFinite(resetMs) || resetMs <= 0)
+        return 0;
+    return Math.min(resetMs, capMs);
+}
+export function sleep(ms) {
+    if (ms <= 0)
+        return Promise.resolve();
+    return new Promise((r) => setTimeout(r, ms));
+}
+export async function ghFetch(path, options = {}) {
+    const { token, userAgent, attempts = 2, onRateLimited } = options;
+    const headers = {
+        ...DEFAULT_HEADERS,
+        ...(token ? { Authorization: `Bearer ${token}` } : {}),
+        ...(userAgent ? { "User-Agent": userAgent } : {}),
+    };
+    let lastErr;
+    for (let i = 0; i < attempts; i++) {
+        let res;
+        try {
+            res = await fetch(`https://api.github.com${path}`, { headers });
+        }
+        catch (err) {
+            lastErr = err;
+            if (i < attempts - 1) {
+                await sleep(500 * Math.pow(2, i));
+                continue;
+            }
+            throw err;
+        }
+        if (res.status === 429 ||
+            (res.status === 403 && res.headers.get("x-ratelimit-remaining") === "0")) {
+            const wait = onRateLimited ? onRateLimited() : rateLimitWaitMs(res);
+            if (wait > 0) {
+                console.warn(`[ghFetch] rate limited, waiting ${Math.round(wait / 1000)}s for ${path}`);
+                await sleep(wait);
+                continue;
+            }
+        }
+        if (res.status >= 500 && i < attempts - 1) {
+            lastErr = new Error(`GitHub ${res.status} ${res.statusText} for ${path}`);
+            await sleep(500 * Math.pow(2, i));
+            continue;
+        }
+        return res;
+    }
+    throw lastErr ?? new Error(`ghFetch: gave up after ${attempts} attempts for ${path}`);
+}
+/**
+ * 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 async function pLimit(concurrency, items, fn) {
+    const out = new Array(items.length);
+    let next = 0;
+    const worker = async () => {
+        while (true) {
+            const i = next++;
+            if (i >= items.length)
+                return;
+            out[i] = await fn(items[i], i);
+        }
+    };
+    const workers = Array.from({ length: Math.max(1, concurrency) }, () => worker());
+    await Promise.all(workers);
+    return out;
+}
+//# sourceMappingURL=github-client.js.map

package/dist/github-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-client.js","sourceRoot":"","sources":["../src/github-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,eAAe,GAA2B;IAC9C,MAAM,EAAE,6BAA6B;IACrC,sBAAsB,EAAE,YAAY;IACpC,YAAY,EAAE,WAAW;CAC1B,CAAC;AASF,MAAM,UAAU,eAAe,CAAC,GAAa,EAAE,KAAK,GAAG,CAAC,GAAG,MAAM;IAC/D,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IACrB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAClD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IACtC,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAY,EAAE,UAA0B,EAAE;IACtE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,GAAG,CAAC,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAClE,MAAM,OAAO,GAA2B;QACtC,GAAG,eAAe;QAClB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC;IACF,IAAI,OAA0B,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,KAAK,CAAC,yBAAyB,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,GAAG,GAAY,CAAC;YACvB,IAAI,CAAC,GAAG,QAAQ,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBAClC,SAAS;YACX,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,IACE,GAAG,CAAC,MAAM,KAAK,GAAG;YAClB,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,KAAK,GAAG,CAAC,EACxE,CAAC;YACD,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACpE,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,mCAAmC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;gBACxF,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;gBAClB,SAAS;YACX,CAAC;QACH,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,QAAQ,GAAG,CAAC,EAAE,CAAC;YAC1C,OAAO,GAAG,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,QAAQ,IAAI,EAAE,CAAC,CAAC;YAC1E,MAAM,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAClC,SAAS;QACX,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,OAAO,IAAI,IAAI,KAAK,CAAC,0BAA0B,QAAQ,iBAAiB,IAAI,EAAE,CAAC,CAAC;AACxF,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,WAAmB,EACnB,KAAU,EACV,EAA0C;IAE1C,MAAM,GAAG,GAAG,IAAI,KAAK,CAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,MAAM,GAAG,KAAK,IAAmB,EAAE;QACvC,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;YACjB,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO;YAC9B,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IACjF,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/github.d.ts

@@ -0,0 +1,8 @@
+import type { GithubMetadata } from "./schema.js";
+export interface GithubRepoRef {
+    owner: string;
+    repo: string;
+}
+export declare function parseGithubRepoUrl(url: string | undefined): GithubRepoRef | undefined;
+export declare function fetchGithubMetadata(ref: GithubRepoRef, token?: string | undefined): Promise<GithubMetadata | undefined>;
+//# sourceMappingURL=github.d.ts.map

package/dist/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAQrF;AAiCD,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,qBAA2B,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAsBnI"}

package/dist/github.js

@@ -0,0 +1,62 @@
+export function parseGithubRepoUrl(url) {
+    if (!url)
+        return undefined;
+    const match = url.match(/^https?:\/\/github\.com\/([^/\s]+)\/([^/#?\s]+)(?:[/?#].*)?$/i);
+    if (!match)
+        return undefined;
+    return {
+        owner: match[1],
+        repo: match[2].replace(/\.git$/, ""),
+    };
+}
+async function githubJson(path, token) {
+    const headers = {
+        Accept: "application/vnd.github+json",
+        "X-GitHub-Api-Version": "2022-11-28",
+        "User-Agent": "grove",
+    };
+    if (token)
+        headers.Authorization = `Bearer ${token}`;
+    const response = await fetch(`https://api.github.com${path}`, { headers });
+    if (response.status === 404)
+        return null;
+    if (response.status === 403 && response.headers.get("x-ratelimit-remaining") === "0") {
+        throw new Error("GitHub API rate limit reached. Set GITHUB_TOKEN and rerun analyze.");
+    }
+    if (!response.ok) {
+        throw new Error(`GitHub API ${response.status} ${response.statusText} for ${path}`);
+    }
+    return response.json();
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function asString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function asNumber(value) {
+    return typeof value === "number" ? value : undefined;
+}
+export async function fetchGithubMetadata(ref, token = process.env.GITHUB_TOKEN) {
+    const repo = asRecord(await githubJson(`/repos/${ref.owner}/${ref.repo}`, token));
+    if (Object.keys(repo).length === 0)
+        return undefined;
+    const latestRelease = asRecord(await githubJson(`/repos/${ref.owner}/${ref.repo}/releases/latest`, token));
+    const license = asRecord(repo.license);
+    return {
+        fullName: asString(repo.full_name),
+        stars: asNumber(repo.stargazers_count) ?? 0,
+        forks: asNumber(repo.forks_count) ?? 0,
+        openIssues: asNumber(repo.open_issues_count),
+        archived: Boolean(repo.archived),
+        disabled: Boolean(repo.disabled),
+        pushedAt: asString(repo.pushed_at) ?? null,
+        updatedAt: asString(repo.updated_at) ?? null,
+        latestReleaseAt: asString(latestRelease.published_at) ?? null,
+        license: asString(license.spdx_id) ?? asString(license.name) ?? null,
+        topics: Array.isArray(repo.topics) ? repo.topics.filter((topic) => typeof topic === "string") : [],
+        language: asString(repo.language) ?? null,
+        defaultBranch: asString(repo.default_branch),
+    };
+}
+//# sourceMappingURL=github.js.map

package/dist/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,kBAAkB,CAAC,GAAuB;IACxD,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACzF,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACf,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;KACrC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,KAAc;IACpD,MAAM,OAAO,GAA2B;QACtC,MAAM,EAAE,6BAA6B;QACrC,sBAAsB,EAAE,YAAY;QACpC,YAAY,EAAE,OAAO;KACtB,CAAC;IACF,IAAI,KAAK;QAAE,OAAO,CAAC,aAAa,GAAG,UAAU,KAAK,EAAE,CAAC;IAErD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,yBAAyB,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3E,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,KAAK,GAAG,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,cAAc,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,QAAQ,IAAI,EAAE,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAgC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7G,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAkB,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY;IAC5F,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,UAAU,CAAC,UAAU,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;IAClF,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAErD,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,UAAU,CAAC,UAAU,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,kBAAkB,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3G,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEvC,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;QAClC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;QAC3C,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QACtC,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC;QAC5C,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;QAChC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;QAChC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI;QAC1C,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI;QAC5C,eAAe,EAAE,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC,IAAI,IAAI;QAC7D,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI;QACpE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;QACnH,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI;QACzC,aAAa,EAAE,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC;KAC7C,CAAC;AACJ,CAAC"}

package/dist/health.d.ts

@@ -0,0 +1,3 @@
+import type { GithubMetadata, HealthEntry } from "./schema.js";
+export declare function classifyHealth(id: string, github?: GithubMetadata): HealthEntry;
+//# sourceMappingURL=health.d.ts.map

package/dist/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAA4B,MAAM,aAAa,CAAC;AASzF,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,WAAW,CA2F/E"}

package/dist/health.js

@@ -0,0 +1,103 @@
+function daysSince(value) {
+    if (!value)
+        return Infinity;
+    const date = new Date(value);
+    if (Number.isNaN(date.valueOf()))
+        return Infinity;
+    return (Date.now() - date.valueOf()) / 86_400_000;
+}
+export function classifyHealth(id, github) {
+    if (!github) {
+        return {
+            id,
+            health: {
+                status: "unknown",
+                maturity: "unknown",
+                tier: "experimental",
+                visibility: "keep",
+                cleanupCandidate: false,
+                staleReason: null,
+                confidence: "low",
+                reasons: ["No GitHub metadata available"],
+            },
+        };
+    }
+    const reasons = [];
+    const pushedDays = daysSince(github.pushedAt);
+    const releaseDays = daysSince(github.latestReleaseAt);
+    let status = "unknown";
+    if (github.archived) {
+        status = "archived";
+        reasons.push("Repository is archived on GitHub");
+    }
+    else if (pushedDays <= 183) {
+        status = "active";
+        reasons.push("Recent repository activity");
+    }
+    else if (pushedDays <= 548) {
+        status = "stale";
+        reasons.push("No recent commits in the last 6 months");
+    }
+    else if (pushedDays > 730) {
+        status = "inactive";
+        reasons.push("No commits in the last 24 months");
+    }
+    else {
+        status = "needs_review";
+        reasons.push("Repository activity is old enough to need review");
+    }
+    const hasRelease = releaseDays <= 365;
+    const hasLicense = Boolean(github.license && github.license !== "NOASSERTION");
+    const popular = github.stars >= 500;
+    const maintainedSignals = pushedDays <= 183 && (hasRelease || hasLicense);
+    let maturity = "unknown";
+    if (status === "archived" || status === "inactive") {
+        maturity = "unknown";
+    }
+    else if (popular && maintainedSignals) {
+        maturity = "mature";
+        if (status === "active")
+            status = "mature";
+        reasons.push("Strong adoption with maintenance signals");
+    }
+    else if (github.stars >= 50 || maintainedSignals) {
+        maturity = "useful";
+    }
+    else {
+        maturity = "experimental";
+    }
+    if (hasRelease)
+        reasons.push("Recent release found");
+    if (hasLicense)
+        reasons.push("Clear license found");
+    if (!hasLicense)
+        reasons.push("License is missing or unclear");
+    const tier = status === "archived" || status === "inactive"
+        ? "hidden"
+        : popular
+            ? "curated"
+            : github.stars >= 50
+                ? "listed"
+                : "experimental";
+    return {
+        id,
+        github,
+        health: {
+            status,
+            maturity,
+            tier,
+            visibility: tier === "hidden" ? "hide" : "keep",
+            cleanupCandidate: status === "stale" || status === "archived" || status === "inactive",
+            staleReason: status === "inactive"
+                ? "no_commits_24_months"
+                : status === "stale"
+                    ? "no_commits_365_days"
+                    : status === "archived"
+                        ? "github_archived"
+                        : null,
+            confidence: github.fullName ? "high" : "medium",
+            reasons,
+        },
+    };
+}
+//# sourceMappingURL=health.js.map

package/dist/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAEA,SAAS,SAAS,CAAC,KAAgC;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,QAAQ,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAU,EAAE,MAAuB;IAChE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,EAAE;YACF,MAAM,EAAE;gBACN,MAAM,EAAE,SAAS;gBACjB,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,cAAc;gBACpB,UAAU,EAAE,MAAM;gBAClB,gBAAgB,EAAE,KAAK;gBACvB,WAAW,EAAE,IAAI;gBACjB,UAAU,EAAE,KAAK;gBACjB,OAAO,EAAE,CAAC,8BAA8B,CAAC;aAC1C;SACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAEtD,IAAI,MAAM,GAAiB,SAAS,CAAC;IACrC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,GAAG,UAAU,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IACnD,CAAC;SAAM,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;QAC7B,MAAM,GAAG,QAAQ,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC7C,CAAC;SAAM,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;QAC7B,MAAM,GAAG,OAAO,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACzD,CAAC;SAAM,IAAI,UAAU,GAAG,GAAG,EAAE,CAAC;QAC5B,MAAM,GAAG,UAAU,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IACnD,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,cAAc,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,UAAU,GAAG,WAAW,IAAI,GAAG,CAAC;IACtC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,KAAK,aAAa,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,IAAI,GAAG,CAAC;IACpC,MAAM,iBAAiB,GAAG,UAAU,IAAI,GAAG,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,CAAC;IAE1E,IAAI,QAAQ,GAAsC,SAAS,CAAC;IAC5D,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QACnD,QAAQ,GAAG,SAAS,CAAC;IACvB,CAAC;SAAM,IAAI,OAAO,IAAI,iBAAiB,EAAE,CAAC;QACxC,QAAQ,GAAG,QAAQ,CAAC;QACpB,IAAI,MAAM,KAAK,QAAQ;YAAE,MAAM,GAAG,QAAQ,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IAC3D,CAAC;SAAM,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,IAAI,iBAAiB,EAAE,CAAC;QACnD,QAAQ,GAAG,QAAQ,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,cAAc,CAAC;IAC5B,CAAC;IAED,IAAI,UAAU;QAAE,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACrD,IAAI,UAAU;QAAE,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU;QAAE,OAAO,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAE/D,MAAM,IAAI,GACR,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,UAAU;QAC5C,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,OAAO;YACP,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;gBAClB,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,cAAc,CAAC;IAEzB,OAAO;QACL,EAAE;QACF,MAAM;QACN,MAAM,EAAE;YACN,MAAM;YACN,QAAQ;YACR,IAAI;YACJ,UAAU,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YAC/C,gBAAgB,EAAE,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,UAAU;YACtF,WAAW,EACT,MAAM,KAAK,UAAU;gBACnB,CAAC,CAAC,sBAAsB;gBACxB,CAAC,CAAC,MAAM,KAAK,OAAO;oBAClB,CAAC,CAAC,qBAAqB;oBACvB,CAAC,CAAC,MAAM,KAAK,UAAU;wBACrB,CAAC,CAAC,iBAAiB;wBACnB,CAAC,CAAC,IAAI;YACd,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;YAC/C,OAAO;SACR;KACF,CAAC;AACJ,CAAC"}

package/dist/importer.d.ts

@@ -0,0 +1,3 @@
+import { type ImportResult } from "./markdown.js";
+export declare function importAwesomeList(input: string): Promise<ImportResult>;
+//# sourceMappingURL=importer.d.ts.map

package/dist/importer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../src/importer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAQxE,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAc5E"}

package/dist/importer.js

@@ -0,0 +1,24 @@
+import { basename, resolve } from "node:path";
+import { readFile } from "node:fs/promises";
+import { parseAwesomeMarkdown } from "./markdown.js";
+function githubReadmeUrl(input) {
+    const match = input.match(/^https?:\/\/github\.com\/([^/\s]+)\/([^/#?\s]+)(?:\/)?$/i);
+    if (!match)
+        return undefined;
+    return `https://raw.githubusercontent.com/${match[1]}/${match[2]}/HEAD/README.md`;
+}
+export async function importAwesomeList(input) {
+    const remote = githubReadmeUrl(input) ?? (/^https?:\/\//.test(input) ? input : undefined);
+    if (remote) {
+        const response = await fetch(remote);
+        if (!response.ok) {
+            throw new Error(`Could not fetch ${remote}: ${response.status} ${response.statusText}`);
+        }
+        const text = await response.text();
+        return parseAwesomeMarkdown(text, { file: "sources/README.md", sourceUrl: input });
+    }
+    const path = resolve(input);
+    const text = await readFile(path, "utf8");
+    return parseAwesomeMarkdown(text, { file: basename(path) });
+}
+//# sourceMappingURL=importer.js.map

package/dist/importer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"importer.js","sourceRoot":"","sources":["../src/importer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAqB,MAAM,eAAe,CAAC;AAExE,SAAS,eAAe,CAAC,KAAa;IACpC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;IACtF,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,qCAAqC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC;AACpF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAa;IACnD,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC1F,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QAC1F,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,oBAAoB,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,oBAAoB,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC9D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export * from "./build-data.js";
+export * from "./config.js";
+export * from "./decisions.js";
+export * from "./enrich.js";
+export * from "./github-client.js";
+export * from "./github.js";
+export * from "./health.js";
+export * from "./importer.js";
+export * from "./io.js";
+export * from "./llms.js";
+export * from "./markdown.js";
+export * from "./parseReadme.js";
+export * from "./schema.js";
+export * from "./sitemap.js";
+export * from "./slug.js";
+export * from "./validate.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+export * from "./build-data.js";
+export * from "./config.js";
+export * from "./decisions.js";
+export * from "./enrich.js";
+export * from "./github-client.js";
+export * from "./github.js";
+export * from "./health.js";
+export * from "./importer.js";
+export * from "./io.js";
+export * from "./llms.js";
+export * from "./markdown.js";
+export * from "./parseReadme.js";
+export * from "./schema.js";
+export * from "./sitemap.js";
+export * from "./slug.js";
+export * from "./validate.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}

package/dist/io.d.ts

@@ -0,0 +1,4 @@
+export declare function readYamlFile<T>(path: string): Promise<T>;
+export declare function writeYamlFile(path: string, value: unknown): Promise<void>;
+export declare function writeTextFile(path: string, value: string): Promise<void>;
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAIA,wBAAsB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAG9D;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ/E;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9E"}

package/dist/io.js

@@ -0,0 +1,21 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { parse, stringify } from "yaml";
+export async function readYamlFile(path) {
+    const text = await readFile(path, "utf8");
+    return parse(text);
+}
+export async function writeYamlFile(path, value) {
+    await mkdir(dirname(path), { recursive: true });
+    const text = stringify(value, {
+        lineWidth: 100,
+        singleQuote: false,
+        defaultStringType: "PLAIN",
+    });
+    await writeFile(path, text, "utf8");
+}
+export async function writeTextFile(path, value) {
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, value, "utf8");
+}
+//# sourceMappingURL=io.js.map

package/dist/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,IAAY;IAChD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC,IAAI,CAAM,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,KAAc;IAC9D,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE;QAC5B,SAAS,EAAE,GAAG;QACd,WAAW,EAAE,KAAK;QAClB,iBAAiB,EAAE,OAAO;KAC3B,CAAC,CAAC;IACH,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,KAAa;IAC7D,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC"}

package/dist/llms.d.ts

@@ -0,0 +1,34 @@
+import { type CuratedConfig } from "./config.js";
+export interface LlmsAppInput {
+    slug: string;
+    name: string;
+    description?: string;
+    category?: string;
+    stack?: string;
+    stars?: number;
+    visibility?: string;
+    /** Detail page body — markdown. Used for llms-full.txt sections. */
+    detail?: string;
+    homepageUrl?: string;
+    repoUrl?: string;
+    license?: string;
+    lastCommitAt?: string | null;
+    addedAt?: string | null;
+}
+export interface LlmsInput {
+    siteUrl?: string;
+    generatedAt: string;
+    apps: LlmsAppInput[];
+}
+export interface LlmsResult {
+    txtPath: string;
+    fullPath: string;
+    indexed: number;
+}
+/** Build the llms.txt string — short pointer to llms-full.txt. */
+export declare function buildLlmsTxt(input: LlmsInput, config: CuratedConfig): string;
+/** Build the llms-full.txt string — index + per-app sections. */
+export declare function buildLlmsFullTxt(input: LlmsInput, config: CuratedConfig): string;
+/** Write public/llms.txt and public/llms-full.txt. */
+export declare function buildLlmsFiles(input: LlmsInput, cwd?: string, config?: CuratedConfig): Promise<LlmsResult>;
+//# sourceMappingURL=llms.d.ts.map

package/dist/llms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms.d.ts","sourceRoot":"","sources":["../src/llms.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAc,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,YAAY,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAyCD,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAgB5E;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAyBhF;AAED,sDAAsD;AACtD,wBAAsB,cAAc,CAClC,KAAK,EAAE,SAAS,EAChB,GAAG,SAAgB,EACnB,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,UAAU,CAAC,CAarB"}

package/dist/llms.js

@@ -0,0 +1,99 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { loadConfig } from "./config.js";
+function slug(value) {
+    return String(value).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function truncate(value, max) {
+    return value.replace(/\s+/g, " ").slice(0, max);
+}
+function buildIndexLine(app) {
+    const desc = truncate(app.description ?? "", 120);
+    const cat = app.category ?? "—";
+    const stack = app.stack ?? "—";
+    const stars = app.stars ?? 0;
+    return `- [${app.name}](#${slug(app.slug)}) — ${cat} · ${stack} · ${stars}★ — ${desc}`;
+}
+function buildDetailSection(app, siteUrl, indexSlug) {
+    const lines = [
+        `### ${app.name}`,
+        "",
+        app.description ? `${app.description}` : "",
+        "",
+        `- slug: ${app.slug}`,
+        `- category: ${app.category ?? "—"}`,
+        `- stack: ${app.stack ?? "—"}`,
+        `- stars: ${app.stars ?? 0}`,
+        app.license ? `- license: ${app.license}` : "",
+        app.repoUrl ? `- repo: ${app.repoUrl}` : "",
+        app.homepageUrl ? `- homepage: ${app.homepageUrl}` : "",
+        `- url: ${siteUrl}/${indexSlug}/${app.slug}`,
+        app.lastCommitAt ? `- lastCommit: ${app.lastCommitAt.slice(0, 10)}` : "",
+        app.addedAt ? `- added: ${app.addedAt.slice(0, 10)}` : "",
+    ].filter(Boolean);
+    if (app.detail) {
+        lines.push("", "#### Detail", "", app.detail);
+    }
+    return lines.join("\n");
+}
+/** Build the llms.txt string — short pointer to llms-full.txt. */
+export function buildLlmsTxt(input, config) {
+    const siteUrl = (input.siteUrl ?? config.siteUrl ?? "").replace(/\/$/, "");
+    const visible = input.apps.filter((a) => a.visibility !== "hide" && a.visibility !== "remove");
+    const indexSlug = config.itemLabel === "app" ? "apps" : "projects";
+    return `# ${config.name}
+
+${config.description ?? config.tagline}
+
+Directory: ${siteUrl}/${indexSlug}
+Projects indexed: ${visible.length}
+Categories: ${new Set(visible.map((a) => a.category).filter(Boolean)).size}
+
+## Usage
+
+Use /llms-full.txt for project-level details. Prefer project detail pages for citations.
+`;
+}
+/** Build the llms-full.txt string — index + per-app sections. */
+export function buildLlmsFullTxt(input, config) {
+    const siteUrl = (input.siteUrl ?? config.siteUrl ?? "").replace(/\/$/, "");
+    const indexSlug = config.itemLabel === "app" ? "apps" : "projects";
+    const visible = input.apps.filter((a) => a.visibility !== "hide" && a.visibility !== "remove");
+    const index = visible.map(buildIndexLine).join("\n");
+    const sections = visible
+        .map((app) => buildDetailSection(app, siteUrl, indexSlug))
+        .join("\n\n");
+    return [
+        `# ${config.name} — full directory`,
+        "",
+        `> Generated ${input.generatedAt} from ${input.apps.length} app records.`,
+        `> Source: ${siteUrl}/${indexSlug} · Regenerate with \`grove build-llms-full\`.`,
+        "",
+        "Each section below mirrors one app detail page.",
+        "",
+        "## Index",
+        "",
+        index,
+        "",
+        sections ? "## Projects" : "",
+        "",
+        sections,
+        "",
+    ].join("\n");
+}
+/** Write public/llms.txt and public/llms-full.txt. */
+export async function buildLlmsFiles(input, cwd = process.cwd(), config) {
+    const cfg = config ?? (await loadConfig(cwd));
+    const publicDir = resolve(cwd, "public");
+    await mkdir(publicDir, { recursive: true });
+    const txtPath = join(publicDir, "llms.txt");
+    const fullPath = join(publicDir, "llms-full.txt");
+    await writeFile(txtPath, buildLlmsTxt(input, cfg), "utf8");
+    await writeFile(fullPath, buildLlmsFullTxt(input, cfg), "utf8");
+    return {
+        txtPath,
+        fullPath,
+        indexed: input.apps.filter((a) => a.visibility !== "hide" && a.visibility !== "remove").length,
+    };
+}
+//# sourceMappingURL=llms.js.map

package/dist/llms.js.map

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

package/dist/markdown.d.ts

@@ -0,0 +1,18 @@
+import type { CuratedItem } from "./schema.js";
+export interface ImportResult {
+    items: CuratedItem[];
+    report: {
+        imported: number;
+        skipped: number;
+        categories: string[];
+        duplicateSlugs: number;
+        tocSkipped: number;
+        anchorLinksSkipped: number;
+    };
+}
+export declare function detectGithubRepo(url: string): string | undefined;
+export declare function parseAwesomeMarkdown(text: string, options?: {
+    file?: string;
+    sourceUrl?: string;
+}): ImportResult;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAsBD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMhE;AA4BD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,YAAY,CAiJpH"}