@grove-dev/core 0.1.5 → 0.2.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Turtuvshin Byambaa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/build-data.d.ts

@@ -1,55 +1,43 @@
-import { type CuratedConfig } from "./schema.js";
+import { type GroveConfig } from "./schema.js";
 /**
- * The full payload written to data/generated/apps.full.json.
+ * The full payload written to data/generated/records.full.json.
  * Carries every normalized record, regardless of visibility.
  */
-export interface AppsFullPayload {
+export interface RecordsFullPayload {
     schemaVersion: number;
+    blueprint: string;
     generatedAt: string;
-    totalApps: number;
-    visibleApps: number;
-    apps: Array<Record<string, unknown>>;
+    totalRecords: number;
+    visibleRecords: number;
+    records: Array<Record<string, unknown>>;
 }
 /**
- * The slim payload written to data/generated/apps.index.json.
+ * The slim payload written to data/generated/records.index.json.
  * Carries only what list and search pages need.
  */
-export interface AppsIndexPayload {
+export interface RecordsIndexPayload {
     schemaVersion: number;
+    blueprint: string;
     generatedAt: string;
-    totalApps: number;
-    apps: Array<Record<string, unknown>>;
+    totalRecords: number;
+    records: 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)
+ * `generate` reads every records/*.yml in the project, normalizes them
+ * via the blueprint schema, and writes:
+ *  - data/generated/records.full.json   (full records, all visibility)
+ *  - data/generated/records.index.json  (slim, visible-only)
+ *  - data/generated/records.json        (alias of records.full.json)
  *
- * Returns a small summary; throws on schema errors.
+ * Returns file paths and counters; throws on schema errors.
  */
-export interface BuildDataResult {
-    totalApps: number;
-    visibleApps: number;
+export interface GenerateResult {
+    totalRecords: number;
+    visibleRecords: number;
     fullPath: string;
     indexPath: string;
     aliasPath: string;
-    configTsPath: string;
     errors: string[];
 }
-export declare function buildData(cwd?: string, config?: CuratedConfig): Promise<BuildDataResult>;
+export declare function generate(cwd?: string, config?: GroveConfig): Promise<GenerateResult>;
 //# sourceMappingURL=build-data.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"build-data.d.ts","sourceRoot":"","sources":["../src/build-data.ts"],"names":[],"mappings":"AAGA,OAAO,EAML,KAAK,WAAW,EAEjB,MAAM,aAAa,CAAC;AA2DrB;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACzC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAsB,QAAQ,CAC5B,GAAG,SAAgB,EACnB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CAoGzB"}

package/dist/build-data.js

@@ -1,115 +1,152 @@
 import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
 import { basename, join, resolve } from "node:path";
-import { normalizeAppRecord, parseAppYaml, toIndexApp, } from "./schema.js";
+import { parse as parseYaml } from "yaml";
+import { blueprintKind, recordsFileSchema, toIndexRecord, unwrapDecisions, decisionsFileSchema, } 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.
+/**
+ * Apply a minimal decisions.yml override to a normalized record. The
+ * human curation layer is the single source of truth for visibility:
+ *   - For project records: decision.visibility (when present) wins
+ *     over record.health.visibility. The health block's other fields
+ *     (status, tier, etc.) are untouched.
+ *   - For resource-hub and ecosystem-map records: decision.visibility
+ *     is written to the record's top-level `visibility` field (these
+ *     blueprints have no `health` block).
+ *
+ * The full override pipeline (with reasons surfaced in the index
+ * payload) is a V2 feature; V1 keeps the merge intentional and small.
  */
-
-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)},
-};
-`;
+function applyDecision(record, visibilityById) {
+    const override = visibilityById.get(record.slug);
+    if (!override)
+        return record;
+    if (record.kind === "project") {
+        const existing = record.health;
+        const fallback = {
+            status: "unknown",
+            maturity: "unknown",
+            tier: "listed",
+            visibility: "keep",
+            cleanupCandidate: false,
+            staleReason: null,
+            confidence: "medium",
+            reasons: [],
+        };
+        const merged = { ...(existing ?? fallback), visibility: override };
+        return { ...record, health: merged };
+    }
+    // Resource-hub / ecosystem-map: no `health` block; the top-level
+    // `visibility` field on the base schema is the source of truth.
+    return { ...record, visibility: override };
 }
-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 = [];
+async function loadDecisionVisibility(decisionsPath, cwd) {
     try {
-        entries = await readdir(appsDir);
+        const raw = await readFile(resolve(cwd, decisionsPath), "utf8");
+        const parsed = decisionsFileSchema.parse(parseYaml(raw) ?? {});
+        const decisions = unwrapDecisions(parsed);
+        const out = new Map();
+        for (const d of decisions)
+            out.set(d.id, d.decision.visibility);
+        return out;
     }
     catch {
-        entries = [];
+        // missing or invalid decisions.yml → no overrides
+        return new Map();
     }
+}
+export async function generate(cwd = process.cwd(), config) {
+    const cfg = config ?? (await loadConfig(cwd));
+    const recordsDir = resolve(cwd, cfg.paths.recordsDir);
+    const outDir = resolve(cwd, cfg.paths.generatedDir);
+    await mkdir(outDir, { recursive: true });
+    // Re-emit the site config as JSON alongside the records so the
+    // Astro (or any framework) template can pick up the user's
+    // branding, theme, and nav without parsing `grove.config.ts`
+    // at render time. The CLI runs `generate` ahead of `build`,
+    // so this stays in sync with the consumer's config edits.
+    const siteConfigPayload = {
+        blueprint: cfg.blueprint,
+        name: cfg.site.name,
+        tagline: cfg.site.tagline,
+        description: cfg.site.description ?? cfg.site.tagline,
+        siteUrl: cfg.site.url ?? "https://example.com",
+        repoUrl: cfg.site.repoUrl ?? "",
+        nav: cfg.nav,
+        theme: cfg.theme,
+        integrations: cfg.integrations,
+    };
+    await writeFile(join(outDir, "site-config.json"), JSON.stringify(siteConfigPayload, null, 2), "utf8");
+    const expectedKind = blueprintKind[cfg.blueprint];
+    const entries = await readdir(recordsDir).catch(() => []);
     const files = entries.filter((f) => f.endsWith(".yml")).sort();
-    const apps = [];
+    // Load human curation decisions once; missing file → empty map.
+    const visibilityById = await loadDecisionVisibility(cfg.paths.decisions, cwd);
+    const out = [];
     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);
+            const text = await readFile(join(recordsDir, file), "utf8");
+            const raw = (parseYaml(text) ?? {});
+            if (!raw.kind)
+                raw.kind = expectedKind;
+            const normalized = recordsFileSchema.parse(raw);
+            normalized.slug = fileSlug;
+            // Apply decisions.yml visibility override on top of the record.
+            // The index payload then derives visibility from record.health,
+            // which is now the merged result.
+            out.push(applyDecision(normalized, visibilityById));
         }
         catch (err) {
             errors.push(`${file}: ${err.message}`);
         }
     }
     if (errors.length > 0) {
-        const e = new Error(`build-data failed: ${errors.length} schema error(s)`);
+        const e = new Error(`generate 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 ?? "");
+    out.sort((a, b) => nameOf(a).localeCompare(nameOf(b)));
+    const indexRecords = out
+        .map((record) => toIndexRecord(record))
+        .filter((r) => {
+        const vis = r.visibility;
+        return vis !== "hide" && vis !== "remove";
     });
-    const indexApps = apps
-        .map((app) => toIndexApp(app))
-        .filter((a) => a.visibility !== "hide");
     const generatedAt = new Date().toISOString();
     const fullPayload = {
         schemaVersion: 1,
+        blueprint: cfg.blueprint,
         generatedAt,
-        totalApps: apps.length,
-        visibleApps: indexApps.length,
-        apps: apps,
+        totalRecords: out.length,
+        visibleRecords: indexRecords.length,
+        records: out,
     };
     const indexPayload = {
         schemaVersion: 1,
+        blueprint: cfg.blueprint,
         generatedAt,
-        totalApps: indexApps.length,
-        apps: indexApps,
+        totalRecords: indexRecords.length,
+        records: indexRecords,
     };
-    const fullPath = join(outDir, "apps.full.json");
-    const indexPath = join(outDir, "apps.index.json");
-    const aliasPath = join(outDir, "apps.json");
+    const fullPath = join(outDir, "records.full.json");
+    const indexPath = join(outDir, "records.index.json");
+    const aliasPath = join(outDir, "records.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,
+        totalRecords: out.length,
+        visibleRecords: indexRecords.length,
         fullPath,
         indexPath,
         aliasPath,
-        configTsPath,
         errors,
     };
 }
+function nameOf(record) {
+    if (record.kind === "resource")
+        return record.title;
+    return record.name;
+}
 //# sourceMappingURL=build-data.js.map

package/dist/build-data.js.map

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

package/dist/config.d.ts

@@ -1,5 +1,16 @@
-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;
+import { type GroveConfig } from "./schema.js";
+export type { GroveConfig };
+/**
+ * Load the Grove project config. The config file is the single source
+ * of truth for blueprint, site metadata, paths, integrations, theme,
+ * and component overrides.
+ *
+ * Default name: `grove.config.ts`. Override with the second arg.
+ */
+export declare function loadConfig(cwd?: string, configPath?: string): Promise<GroveConfig>;
+/**
+ * Define and validate a Grove config. Used at the bottom of a
+ * `grove.config.ts` file so editors get good type hints.
+ */
+export declare function defineConfig(config: GroveConfig): GroveConfig;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAElE,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,GAAG,SAAgB,EACnB,UAAU,SAAoB,GAC7B,OAAO,CAAC,WAAW,CAAC,CAMtB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAE7D"}

package/dist/config.js

@@ -1,14 +1,25 @@
 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") {
+import { groveConfigSchema } from "./schema.js";
+/**
+ * Load the Grove project config. The config file is the single source
+ * of truth for blueprint, site metadata, paths, integrations, theme,
+ * and component overrides.
+ *
+ * Default name: `grove.config.ts`. Override with the second arg.
+ */
+export async function loadConfig(cwd = process.cwd(), configPath = "grove.config.ts") {
     const resolved = resolve(cwd, configPath);
     const jiti = createJiti(import.meta.url);
-    const mod = await jiti.import(resolved, { default: true });
+    const mod = (await jiti.import(resolved, { default: true }));
     const raw = mod.default ?? mod.config ?? mod;
-    return curatedConfigSchema.parse(raw);
+    return groveConfigSchema.parse(raw);
 }
+/**
+ * Define and validate a Grove config. Used at the bottom of a
+ * `grove.config.ts` file so editors get good type hints.
+ */
 export function defineConfig(config) {
-    return curatedConfigSchema.parse(config);
+    return groveConfigSchema.parse(config);
 }
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +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"}
+{"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,iBAAiB,EAAoB,MAAM,aAAa,CAAC;AAIlE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,EACnB,UAAU,GAAG,iBAAiB;IAE9B,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,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAA4B,CAAC;IACxF,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC;IAC7C,OAAO,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,OAAO,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC"}

package/dist/decisions.d.ts

@@ -1,28 +1,31 @@
-import { type AppRecord } from "./schema.js";
-import { type CuratedConfig } from "./config.js";
-export interface ReviewCandidate {
+import { type GroveConfig, type Resource } from "./schema.js";
+export interface CleanupCandidate {
     slug: string;
     name: string;
-    repoUrl: string;
+    url: string;
     status: string;
     tier: string;
     staleReason: string | null;
     lastCommitAt: string | null;
     stars: number;
 }
-export interface ReviewReport {
+export interface CleanupReport {
     generatedAt: string;
+    blueprint: string;
     totalCandidates: number;
-    candidates: ReviewCandidate[];
+    candidates: CleanupCandidate[];
 }
-/** Compute the set of review candidates from normalized app records. */
-export declare function pickReviewCandidates(apps: AppRecord[]): AppRecord[];
+/** Filter records down to the ones that need a human curation pass. */
+export declare function pickCleanupCandidates(records: Resource[]): Resource[];
 /**
- * Read every apps/*.yml, normalize, then write data/generated/review-report.json
- * with cleanup candidates (unknown / needs_review / cleanupCandidate).
+ * Read every record YAML under `config.paths.recordsDir`, normalize,
+ * then write `data/generated/cleanup-report.json` with the list of
+ * records that need human attention (stale / unknown / cleanup).
+ *
+ * V1 name for what was previously `review`.
  */
-export declare function buildReviewReport(cwd?: string, config?: CuratedConfig): Promise<{
-    report: ReviewReport;
+export declare function cleanupStale(cwd?: string, config?: GroveConfig): Promise<{
+    report: CleanupReport;
     path: string;
 }>;
 //# sourceMappingURL=decisions.d.ts.map

package/dist/decisions.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../src/decisions.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,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,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAsBD,uEAAuE;AACvE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAOrE;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,GAAG,SAAgB,EACnB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAmClD"}

package/dist/decisions.js

@@ -1,56 +1,76 @@
 import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
 import { basename, join, resolve } from "node:path";
-import { normalizeAppRecord, parseAppYaml } from "./schema.js";
+import { parse as parseYaml } from "yaml";
+import { blueprintKind, recordsFileSchema, } from "./schema.js";
 import { loadConfig } from "./config.js";
-function toCandidate(app) {
+function toCandidate(record) {
+    const name = record.kind === "resource" ? record.title : record.name;
+    const url = record.links?.github ?? record.links?.website ?? record.links?.source ?? "";
+    const health = record
+        .health;
+    const gh = record
+        .github?.repository;
     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,
+        slug: record.slug,
+        name,
+        url,
+        status: health?.status ?? "unknown",
+        tier: health?.tier ?? "experimental",
+        staleReason: health?.staleReason ?? null,
+        lastCommitAt: gh?.pushed_at ?? null,
+        stars: gh?.stargazers_count ?? 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");
+/** Filter records down to the ones that need a human curation pass. */
+export function pickCleanupCandidates(records) {
+    return records.filter((r) => {
+        const health = r.health;
+        if (health?.cleanupCandidate)
+            return true;
+        if (health?.status === "unknown" || health?.status === "needs_review")
+            return true;
+        return false;
+    });
 }
 /**
- * Read every apps/*.yml, normalize, then write data/generated/review-report.json
- * with cleanup candidates (unknown / needs_review / cleanupCandidate).
+ * Read every record YAML under `config.paths.recordsDir`, normalize,
+ * then write `data/generated/cleanup-report.json` with the list of
+ * records that need human attention (stale / unknown / cleanup).
+ *
+ * V1 name for what was previously `review`.
  */
-export async function buildReviewReport(cwd = process.cwd(), config) {
+export async function cleanupStale(cwd = process.cwd(), config) {
     const cfg = config ?? (await loadConfig(cwd));
-    const appsDir = resolve(cwd, cfg.paths.appsDir);
+    const recordsDir = resolve(cwd, cfg.paths.recordsDir);
     const outDir = resolve(cwd, cfg.paths.generatedDir);
     await mkdir(outDir, { recursive: true });
-    let entries = [];
-    try {
-        entries = await readdir(appsDir);
-    }
-    catch {
-        entries = [];
-    }
+    const expectedKind = blueprintKind[cfg.blueprint];
+    const entries = await readdir(recordsDir).catch(() => []);
     const files = entries.filter((f) => f.endsWith(".yml")).sort();
-    const apps = [];
+    const records = [];
     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 text = await readFile(join(recordsDir, file), "utf8");
+        const raw = (parseYaml(text) ?? {});
+        if (!raw.kind)
+            raw.kind = expectedKind;
+        try {
+            const normalized = recordsFileSchema.parse(raw);
+            normalized.slug = fileSlug;
+            records.push(normalized);
+        }
+        catch {
+            // skip — validation surfaces the error
+        }
     }
-    const candidates = pickReviewCandidates(apps).map(toCandidate);
+    const candidates = pickCleanupCandidates(records).map(toCandidate);
     const report = {
         generatedAt: new Date().toISOString(),
+        blueprint: cfg.blueprint,
         totalCandidates: candidates.length,
         candidates,
     };
-    const path = join(outDir, "review-report.json");
+    const path = join(outDir, "cleanup-report.json");
     await writeFile(path, JSON.stringify(report, null, 2), "utf8");
     return { report, path };
 }

package/dist/decisions.js.map

@@ -1 +1 @@
-{"version":3,"file":"decisions.js","sourceRoot":"","sources":["../src/decisions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAkB,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAsB,UAAU,EAAE,MAAM,aAAa,CAAC;AAmB7D,SAAS,WAAW,CAAC,GAAc;IACjC,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI;QACtC,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;KACtB,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,oBAAoB,CAAC,IAAiB;IACpD,OAAO,IAAI,CAAC,MAAM,CAChB,CAAC,GAAG,EAAE,EAAE,CACN,GAAG,CAAC,gBAAgB;QACpB,GAAG,CAAC,MAAM,KAAK,SAAS;QACxB,GAAG,CAAC,MAAM,KAAK,cAAc,CAChC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,EACnB,MAAsB;IAEtB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACpD,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzC,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,EAAE,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/D,MAAM,IAAI,GAAgB,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QACzD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,UAAU,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAiB;QAC3B,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,eAAe,EAAE,UAAU,CAAC,MAAM;QAClC,UAAU;KACX,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/D,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"decisions.js","sourceRoot":"","sources":["../src/decisions.ts"],"names":[],"mappings":"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"}

package/dist/enrich.d.ts

@@ -7,8 +7,8 @@
  * 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.
+ * block used in `data/records/<slug>.yml` for `kind: project` records,
+ * so a subsequent token-backed sync can fill in the rest of the fields.
  */
 export interface EnrichedFields {
     license: string | null;