@grove-dev/core 0.1.5 → 0.2.5

package/dist/schema.js

@@ -1,6 +1,31 @@
 import { z } from "zod";
 import { parse, stringify } from "yaml";
 // ──────────────────────────────────────────────────────────────────────
+// Blueprints and kinds
+// ──────────────────────────────────────────────────────────────────────
+/**
+ * A blueprint defines the shape and behavior of a Grove site.
+ *
+ * V1 ships three fixed blueprints. They are not extensible — no custom
+ * blueprint API in V1.
+ */
+export const blueprintSchema = z.enum([
+    "project-directory",
+    "resource-hub",
+    "ecosystem-map",
+]);
+/**
+ * Each blueprint is bound to a single resource kind. Records are
+ * discriminated by `kind`, which must match the blueprint of the site
+ * that owns them.
+ */
+export const resourceKindSchema = z.enum(["project", "resource", "entity"]);
+export const blueprintKind = {
+    "project-directory": "project",
+    "resource-hub": "resource",
+    "ecosystem-map": "entity",
+};
+// ──────────────────────────────────────────────────────────────────────
 // Health & decision labels
 // ──────────────────────────────────────────────────────────────────────
 export const healthStatusSchema = z.enum([
@@ -30,7 +55,7 @@ export const healthTierSchema = z.enum([
     "hidden",
 ]);
 // ──────────────────────────────────────────────────────────────────────
-// Curation: project shape
+// Curation enums (shared)
 // ──────────────────────────────────────────────────────────────────────
 export const projectTypeSchema = z.enum([
     "real-app",
@@ -42,8 +67,32 @@ export const projectTypeSchema = z.enum([
     "template",
     "historical",
 ]);
-export const difficultySchema = z.enum(["beginner", "intermediate", "advanced"]);
-export const codebaseSizeSchema = z.enum(["small", "medium", "large", "huge"]);
+export const resourceTypeSchema = z.enum([
+    "guide",
+    "comparison",
+    "link",
+    "explainer",
+    "tool",
+    "video",
+    "article",
+    "course",
+    "book",
+    "podcast",
+    "other",
+]);
+export const entityTypeSchema = z.enum([
+    "company",
+    "organization",
+    "community",
+    "school",
+    "university",
+    "research-lab",
+    "agency",
+    "service",
+    "product",
+    "person",
+    "other",
+]);
 export const appLabelSchema = z.enum(["new", "hot", "mature", "featured"]);
 export const scoreSchema = z.object({
     activity: z.number().min(0).max(100).optional(),
@@ -54,34 +103,19 @@ export const scoreSchema = z.object({
     overall: z.number().min(0).max(100).optional(),
 });
 // ──────────────────────────────────────────────────────────────────────
-// Distribution channels
-// ──────────────────────────────────────────────────────────────────────
-export const distributionChannelTypeSchema = z.enum([
-    "app-store",
-    "play-store",
-    "fdroid",
-    "github-releases",
-    "apk",
-    "testflight",
-    "website",
-    "snapcraft",
-    "flathub",
-    "microsoft-store",
-    "package-registry",
-    "docs",
-    "demo",
-    "other",
-]);
-export const distributionChannelSchema = z.object({
-    type: distributionChannelTypeSchema,
-    platform: z.string().optional(),
-    label: z.string().optional(),
-    url: z.string().url(),
-    verified: z.boolean().optional(),
-    notes: z.string().optional(),
-});
+// Links
+// ──────────────────────────────────────────────────────────────────────
+export const linksSchema = z
+    .object({
+    github: z.string().url().optional(),
+    website: z.string().url().optional(),
+    docs: z.string().url().optional(),
+    source: z.string().url().optional(),
+})
+    .catchall(z.string().url())
+    .default({});
 // ──────────────────────────────────────────────────────────────────────
-// GitHub-shaped metadata
+// Health metadata
 // ──────────────────────────────────────────────────────────────────────
 export const githubLicenseSchema = z
     .object({
@@ -125,205 +159,6 @@ export const githubRepositorySchema = z
     pushed_at: z.string().nullable().optional(),
 })
     .passthrough();
-// ──────────────────────────────────────────────────────────────────────
-// Stack (registry-backed taxonomy)
-// ──────────────────────────────────────────────────────────────────────
-export const stackTechnologySchema = z
-    .object({
-    id: z.string().min(1),
-    role: z.string().optional(),
-})
-    .passthrough();
-export const stackSchema = z
-    .object({
-    primary: z.string().min(1),
-    families: z.array(z.string()).optional(),
-    technologies: z.array(stackTechnologySchema).optional(),
-})
-    .passthrough();
-export const stackRefSchema = z.object({
-    id: z.string().min(1),
-    name: z.string().min(1),
-    family: z.string().optional(),
-    languages: z.array(z.string()).optional(),
-    platforms: z.array(z.string()).optional(),
-    icon: z.string().optional(),
-    status: z.enum(["live", "expanding", "planned"]).optional(),
-    blurb: z.string().optional(),
-});
-export const platformRefSchema = z.object({
-    id: z.string().min(1),
-    name: z.string().min(1),
-    icon: z.string().optional(),
-});
-export const categoryRefSchema = z.object({
-    id: z.string().min(1),
-    name: z.string().min(1),
-    blurb: z.string().optional(),
-});
-export const distributionChannelRefSchema = z.object({
-    id: distributionChannelTypeSchema,
-    name: z.string().min(1),
-    platforms: z.array(z.string()).optional(),
-});
-// ──────────────────────────────────────────────────────────────────────
-// Item — generic open-source project record
-// ──────────────────────────────────────────────────────────────────────
-export const itemSchema = z.object({
-    id: z.string().min(1),
-    name: z.string().min(1),
-    description: z.string().default(""),
-    links: z
-        .object({
-        github: z.string().url().optional(),
-        website: z.string().url().optional(),
-        docs: z.string().url().optional(),
-        source: z.string().url().optional(),
-    })
-        .catchall(z.string().url())
-        .default({}),
-    source: z
-        .object({
-        type: z.enum(["markdown", "manual", "github-topic", "awesome-list", "submit"]).default("manual"),
-        file: z.string().optional(),
-        line: z.number().int().positive().optional(),
-        url: z.string().optional(),
-        provider: z.string().optional(),
-        owner: z.string().optional(),
-        repo: z.string().optional(),
-    })
-        .default({ type: "manual" }),
-    taxonomy: z
-        .object({
-        category: z.string().min(1).default("uncategorized"),
-        tags: z.array(z.string()).default([]),
-        language: z.string().optional(),
-        stack: z.string().optional(),
-        stacks: z.array(z.string()).default([]),
-        platforms: z.array(z.string()).default([]),
-    })
-        .default({
-        category: "uncategorized",
-        tags: [],
-        stacks: [],
-        platforms: [],
-    }),
-    labels: z.array(appLabelSchema).default([]),
-    lenses: z.array(z.string()).default([]),
-    distribution: z
-        .object({
-        channels: z.array(distributionChannelSchema).default([]),
-    })
-        .default({ channels: [] }),
-    curation: z
-        .object({
-        projectType: projectTypeSchema.optional(),
-        difficulty: difficultySchema.optional(),
-        codebaseSize: codebaseSizeSchema.optional(),
-        stateManagement: z.string().optional(),
-        backend: z.string().optional(),
-        architecture: z.string().optional(),
-        bestFor: z.array(z.string()).default([]),
-        whyListed: z.array(z.string()).default([]),
-        caveats: z.array(z.string()).default([]),
-        goodFirstIssues: z.union([z.boolean(), z.string().url()]).optional(),
-        contributionGuide: z.union([z.boolean(), z.string().url()]).optional(),
-        launchedBy: z.string().optional(),
-        launchAsk: z.array(z.string()).default([]),
-        reviewed: z.boolean().optional(),
-        reviewedBy: z.string().optional(),
-        reviewedAt: z.string().optional(),
-        notes: z.string().optional(),
-        scores: scoreSchema.default({}),
-    })
-        .default({
-        bestFor: [],
-        whyListed: [],
-        caveats: [],
-        launchAsk: [],
-        scores: {},
-    }),
-});
-export const itemsFileSchema = z.union([
-    z.array(itemSchema),
-    z.object({ items: z.array(itemSchema) }),
-]);
-// ──────────────────────────────────────────────────────────────────────
-// GitHub-shaped app record (schema v1)
-// ──────────────────────────────────────────────────────────────────────
-const isoLike = z.string().min(4).nullable().optional();
-const finalAppSchema = z
-    .object({
-    schemaVersion: z.number().optional(),
-    id: z.string().optional(),
-    slug: z.string().min(1),
-    source: z
-        .object({
-        provider: z.literal("github"),
-        owner: z.string().min(1),
-        repo: z.string().min(1),
-        url: z.string().url().optional(),
-    })
-        .passthrough(),
-    app: z
-        .object({
-        name: z.string().min(1),
-        description: z.string().min(1),
-        category: z.string().min(1),
-        projectType: z.string().optional(),
-        platforms: z.array(z.string()).min(1),
-        tags: z.array(z.string()).optional(),
-        distribution: z
-            .object({
-            channels: z
-                .array(z
-                .object({
-                type: z.string().min(1),
-                platform: z.string().optional(),
-                label: z.string().optional(),
-                url: z.string().url(),
-                verified: z.boolean().optional(),
-                notes: z.string().optional(),
-            })
-                .passthrough())
-                .optional(),
-        })
-            .passthrough()
-            .optional(),
-    })
-        .passthrough(),
-    stack: stackSchema,
-    github: z
-        .object({
-        repository: githubRepositorySchema.optional(),
-        languages: z.record(z.string(), z.number()).optional(),
-        latestRelease: z.record(z.string(), z.unknown()).nullable().optional(),
-        activity: z.record(z.string(), z.unknown()).optional(),
-        files: z.record(z.string(), z.boolean()).optional(),
-        labels: z.array(z.record(z.string(), z.unknown())).optional(),
-        sync: z.record(z.string(), z.unknown()).optional(),
-    })
-        .passthrough()
-        .optional(),
-    health: z.record(z.string(), z.unknown()).optional(),
-    curation: z.record(z.string(), z.unknown()).optional(),
-})
-    .passthrough();
-const legacyAppSchema = z
-    .object({
-    slug: z.string().min(1),
-    name: z.string().min(1),
-    repoUrl: z.string().url(),
-    description: z.string().min(1),
-    stack: z.union([z.string(), z.record(z.string(), z.unknown())]),
-    stacks: z.array(z.string()).optional(),
-    platforms: z.array(z.string()).default([]),
-    category: z.string().min(1),
-})
-    .passthrough();
-// ──────────────────────────────────────────────────────────────────────
-// Health metadata
-// ──────────────────────────────────────────────────────────────────────
 export const githubMetadataSchema = z.object({
     fullName: z.string().optional(),
     stars: z.number().int().nonnegative().default(0),
@@ -356,19 +191,20 @@ export const githubMetadataSchema = z.object({
     ]))
         .optional(),
 });
+export const healthBlockSchema = z.object({
+    status: healthStatusSchema.default("unknown"),
+    maturity: z.enum(["experimental", "useful", "mature", "unknown"]).default("unknown"),
+    tier: healthTierSchema.default("experimental"),
+    visibility: decisionVisibilitySchema.default("keep"),
+    cleanupCandidate: z.boolean().default(false),
+    staleReason: z.string().nullable().optional(),
+    confidence: z.enum(["low", "medium", "high"]).default("medium"),
+    reasons: z.array(z.string()).default([]),
+});
 export const healthEntrySchema = z.object({
     id: z.string().min(1),
     github: githubMetadataSchema.optional(),
-    health: z.object({
-        status: healthStatusSchema,
-        maturity: z.enum(["experimental", "useful", "mature", "unknown"]).default("unknown"),
-        tier: healthTierSchema.default("experimental"),
-        visibility: decisionVisibilitySchema.default("keep"),
-        cleanupCandidate: z.boolean().default(false),
-        staleReason: z.string().nullable().optional(),
-        confidence: z.enum(["low", "medium", "high"]).default("medium"),
-        reasons: z.array(z.string()).default([]),
-    }),
+    health: healthBlockSchema,
 });
 export const healthFileSchema = z.union([
     z.array(healthEntrySchema),
@@ -391,7 +227,7 @@ export const decisionsFileSchema = z.union([
     z.object({ decisions: z.array(decisionSchema) }),
 ]);
 // ──────────────────────────────────────────────────────────────────────
-// Overrides (manual corrections to imported items)
+// Overrides (manual corrections to imported records)
 // ──────────────────────────────────────────────────────────────────────
 export const overrideSchema = z.object({
     id: z.string().min(1),
@@ -402,36 +238,225 @@ export const overridesFileSchema = z.union([
     z.object({ overrides: z.array(overrideSchema) }),
 ]);
 // ──────────────────────────────────────────────────────────────────────
-// Curated config
+// Curation: shared block
+// ──────────────────────────────────────────────────────────────────────
+const curationBlockSchema = z
+    .object({
+    reviewed: z.boolean().default(false),
+    reviewedBy: z.string().optional(),
+    reviewedAt: z.string().optional(),
+    notes: z.string().optional(),
+    labels: z.array(appLabelSchema).default([]),
+    lenses: z.array(z.string()).default([]),
+})
+    .default({ reviewed: false, labels: [], lenses: [] });
+// ──────────────────────────────────────────────────────────────────────
+// Resource base (shared by all blueprints)
+// ──────────────────────────────────────────────────────────────────────
+const resourceBaseSchema = z.object({
+    slug: z.string().min(1),
+    description: z.string().default(""),
+    category: z.string().min(1).default("uncategorized"),
+    tags: z.array(z.string()).default([]),
+    links: linksSchema,
+    content: z.string().optional(), // path to markdown body under content/records/
+    source: z
+        .object({
+        type: z.enum(["manual", "github-topic", "awesome-list", "submit", "import"])
+            .default("manual"),
+        file: z.string().optional(),
+        url: z.string().optional(),
+        provider: z.string().optional(),
+        owner: z.string().optional(),
+        repo: z.string().optional(),
+    })
+        .default({ type: "manual" }),
+    curation: curationBlockSchema,
+    scores: scoreSchema.default({}),
+    /**
+     * Effective visibility after any decisions.yml override. For project
+     * records the canonical signal lives in `health.visibility`; for
+     * resource-hub / ecosystem-map records (which have no `health`
+     * block) the top-level `visibility` is the source of truth.
+     * Defaults to "keep" so existing YAML files without the field
+     * continue to validate.
+     */
+    visibility: decisionVisibilitySchema.default("keep"),
+});
+// ──────────────────────────────────────────────────────────────────────
+// Blueprint: project-directory — kind: project
 // ──────────────────────────────────────────────────────────────────────
-export const curatedConfigSchema = z.object({
+export const projectRecordSchema = resourceBaseSchema.extend({
+    kind: z.literal("project"),
     name: z.string().min(1),
-    tagline: z.string().default("A living, health-aware developer directory."),
-    description: z.string().optional(),
-    siteUrl: z.string().url().optional(),
+    projectType: projectTypeSchema.optional(),
+    stack: z.string().optional(),
+    stacks: z.array(z.string()).default([]),
+    platforms: z.array(z.string()).default([]),
+    difficulty: z.enum(["beginner", "intermediate", "advanced"]).optional(),
+    codebaseSize: z.enum(["small", "medium", "large", "huge"]).optional(),
+    // Canonical repo URL. Distinct from `links.github`, which is the
+    // human-facing link on the page; `repoUrl` is the single source
+    // for owner/repo extraction, avatar fallback, and "view repo" CTAs.
     repoUrl: z.string().url().optional(),
-    itemLabel: z.string().default("project"),
+    // Optional project logo/avatar URL. Falls back to the GitHub
+    // owner avatar (when `repoUrl` is a github.com URL) or to the
+    // first-2-letters initials placeholder.
+    logoUrl: z.string().url().optional(),
+    bestFor: z.array(z.string()).default([]),
+    whyListed: z.array(z.string()).default([]),
+    caveats: z.array(z.string()).default([]),
+    distribution: z
+        .object({
+        channels: z
+            .array(z
+            .object({
+            type: z.string().min(1),
+            platform: z.string().optional(),
+            label: z.string().optional(),
+            url: z.string().url(),
+            verified: z.boolean().optional(),
+            notes: z.string().optional(),
+        })
+            .passthrough())
+            .default([]),
+    })
+        .default({ channels: [] }),
+    github: z
+        .object({
+        repository: githubRepositorySchema.optional(),
+        languages: z.record(z.string(), z.number()).optional(),
+        latestRelease: z.record(z.string(), z.unknown()).nullable().optional(),
+        activity: z.record(z.string(), z.unknown()).optional(),
+        files: z.record(z.string(), z.boolean()).optional(),
+        labels: z.array(z.record(z.string(), z.unknown())).optional(),
+        sync: z.record(z.string(), z.unknown()).optional(),
+    })
+        .passthrough()
+        .optional(),
+    health: healthBlockSchema.optional(),
+});
+// ──────────────────────────────────────────────────────────────────────
+// Blueprint: resource-hub — kind: resource
+// ──────────────────────────────────────────────────────────────────────
+export const resourceRecordSchema = resourceBaseSchema.extend({
+    kind: z.literal("resource"),
+    title: z.string().min(1),
+    type: resourceTypeSchema,
+    topic: z.string().min(1),
+    related: z.array(z.string()).default([]), // slugs of related resources
+    publishedAt: z.string().optional(),
+    author: z.string().optional(),
+});
+// ──────────────────────────────────────────────────────────────────────
+// Blueprint: ecosystem-map — kind: entity
+// ──────────────────────────────────────────────────────────────────────
+export const entityRecordSchema = resourceBaseSchema.extend({
+    kind: z.literal("entity"),
+    name: z.string().min(1),
+    type: entityTypeSchema,
+    founded: z.string().optional(),
+    location: z.string().optional(),
+    members: z.number().int().nonnegative().optional(),
+    parent: z.string().optional(), // slug of parent entity
+});
+// ──────────────────────────────────────────────────────────────────────
+// Discriminated union: Resource
+// ──────────────────────────────────────────────────────────────────────
+export const resourceSchema = z.discriminatedUnion("kind", [
+    projectRecordSchema,
+    resourceRecordSchema,
+    entityRecordSchema,
+]);
+// ──────────────────────────────────────────────────────────────────────
+// Records file (V1: one resource per file)
+// ──────────────────────────────────────────────────────────────────────
+//
+// V1 is intentionally narrow: one YAML file = one resource. The
+// filename (minus `.yml`) is the canonical slug. This keeps PR
+// review clean, removes an entire class of "which slug wins" bugs,
+// and matches what every contributor actually wants to read.
+//
+// The previous "array or { records: [...] }" shape leaked into the
+// parser and forced every consumer to call `unwrapRecords`. The
+// `resourceSchema.parse(raw)` call below is now a direct mapping
+// parse; multi-record files are a V2 feature and will live behind
+// a separate `recordsBundleSchema`.
+export const recordsFileSchema = resourceSchema;
+// ──────────────────────────────────────────────────────────────────────
+// Grove config
+// ──────────────────────────────────────────────────────────────────────
+export const navItemSchema = z.object({
+    label: z.string().min(1),
+    href: z.string().min(1),
+});
+export const githubIntegrationSchema = z.union([
+    z.boolean(),
+    z.object({
+        metadata: z.boolean().default(false),
+        contributors: z.boolean().default(false),
+        health: z.boolean().default(false),
+    }),
+]);
+export const themeSchema = z.object({
+    primaryColor: z.string().default("#16a34a"),
+    radius: z.enum(["none", "soft", "round"]).default("soft"),
+    density: z.enum(["compact", "comfortable", "spacious"]).default("comfortable"),
+    containerWidth: z.string().default("72rem"),
+});
+export const componentOverrideSchema = z.object({
+    Header: z.string().optional(),
+    Footer: z.string().optional(),
+    Hero: z.string().optional(),
+    ItemCard: z.string().optional(),
+    DetailHeader: z.string().optional(),
+});
+export const groveConfigSchema = z.object({
+    blueprint: blueprintSchema.default("project-directory"),
+    site: z.object({
+        name: z.string().min(1),
+        tagline: z.string().default("A growing community knowledge site."),
+        description: z.string().optional(),
+        url: z.string().url().optional(),
+        repoUrl: z.string().url().optional(),
+    }),
+    nav: z.array(navItemSchema).default([]),
+    facets: z.array(z.string()).default(["category", "tags"]),
+    integrations: z
+        .object({
+        github: githubIntegrationSchema.default(false),
+    })
+        .default({ github: false }),
+    theme: themeSchema.default({
+        primaryColor: "#16a34a",
+        radius: "soft",
+        density: "comfortable",
+        containerWidth: "72rem",
+    }),
+    components: componentOverrideSchema.default({}),
     paths: z
         .object({
-        sourcesDir: z.string().default("sources"),
         dataDir: z.string().default("data"),
         contentDir: z.string().default("content"),
-        appsDir: z.string().default("data/apps"),
+        recordsDir: z.string().default("data/records"),
+        pagesDir: z.string().default("content/pages"),
+        bodiesDir: z.string().default("content/records"),
+        publicDir: z.string().default("public"),
         taxonomyDir: z.string().default("data/taxonomy"),
         generatedDir: z.string().default("data/generated"),
-        items: z.string().default("data/items.yml"),
         health: z.string().default("data/health.yml"),
         decisions: z.string().default("data/decisions.yml"),
         overrides: z.string().default("data/overrides.yml"),
     })
         .default({
-        sourcesDir: "sources",
         dataDir: "data",
         contentDir: "content",
-        appsDir: "data/apps",
+        recordsDir: "data/records",
+        pagesDir: "content/pages",
+        bodiesDir: "content/records",
+        publicDir: "public",
         taxonomyDir: "data/taxonomy",
         generatedDir: "data/generated",
-        items: "data/items.yml",
         health: "data/health.yml",
         decisions: "data/decisions.yml",
         overrides: "data/overrides.yml",
@@ -440,9 +465,6 @@ export const curatedConfigSchema = z.object({
 // ──────────────────────────────────────────────────────────────────────
 // Helpers
 // ──────────────────────────────────────────────────────────────────────
-export function unwrapItems(value) {
-    return Array.isArray(value) ? value : value.items;
-}
 export function unwrapHealth(value) {
     return Array.isArray(value) ? value : value.health;
 }
@@ -452,17 +474,139 @@ export function unwrapDecisions(value) {
 export function unwrapOverrides(value) {
     return Array.isArray(value) ? value : value.overrides;
 }
-function compactArray(values) {
-    return [...new Set((values ?? []).filter(Boolean))];
+/**
+ * Parse a single record YAML mapping into a typed Resource. The
+ * `kind` field on the YAML selects which blueprint schema to apply.
+ */
+export function parseRecordYaml(text, fileSlug) {
+    const raw = parse(text) ?? {};
+    if (typeof raw !== "object" || Array.isArray(raw)) {
+        throw new Error(`${fileSlug}: record file must contain a YAML mapping`);
+    }
+    return raw;
+}
+export function stringifyRecordYaml(record) {
+    return stringify(record, {
+        lineWidth: 100,
+        singleQuote: false,
+        defaultStringType: "PLAIN",
+    });
 }
-function formatDateOnly(value) {
-    if (!value)
-        return undefined;
-    const d = new Date(value);
-    if (Number.isNaN(d.valueOf()))
-        return String(value);
-    return d.toISOString().slice(0, 10);
+export function getOwnerRepoFromUrl(repoUrl) {
+    if (!repoUrl)
+        return null;
+    const m = String(repoUrl).match(/github\.com\/([^/]+)\/([^/?#]+)/);
+    if (!m)
+        return null;
+    return { owner: m[1], repo: m[2].replace(/\.git$/, "") };
 }
+export function isIndexProject(r) {
+    return r.kind === "project";
+}
+export function isIndexResource(r) {
+    return r.kind === "resource";
+}
+export function isIndexEntity(r) {
+    return r.kind === "entity";
+}
+/**
+ * Project a Resource to a stable, search-index-friendly summary
+ * object. Strips out blueprint-specific heavy fields and leaves
+ * only what the public list/detail UIs need.
+ *
+ * The return type is the discriminated `IndexRecord` union. The
+ * function body uses a single `kind` literal cast per branch
+ * because the `record.kind` is a `ResourceKind` (the union of
+ * all three) and TypeScript cannot narrow the literal from a
+ * runtime check alone. The casts are safe because each branch
+ * is gated on the literal string compare.
+ */
+export function toIndexRecord(record) {
+    const base = {
+        slug: record.slug,
+        kind: record.kind,
+        category: record.category,
+        tags: record.tags ?? [],
+        links: record.links,
+        description: record.description,
+        content: record.content,
+        curation: record.curation,
+    };
+    if (record.kind === "project") {
+        const r = record;
+        return {
+            ...base,
+            kind: "project",
+            name: r.name,
+            stack: r.stack,
+            stacks: r.stacks ?? [],
+            platforms: r.platforms ?? [],
+            projectType: r.projectType,
+            repoUrl: r.repoUrl,
+            logoUrl: r.logoUrl,
+            difficulty: r.difficulty,
+            codebaseSize: r.codebaseSize,
+            bestFor: r.bestFor,
+            whyListed: r.whyListed,
+            caveats: r.caveats,
+            // Health surfaced alongside the record so list/detail UIs can
+            // show staleness/curation tier without a second lookup.
+            health: r.health,
+            // Visibility comes from either the health block (auto-derived
+            // from signals) or the curation override (`decisions.yml`).
+            // The generate step folds the latter in before serialising,
+            // so this is a best-effort projection of the current state.
+            visibility: r.health?.visibility ?? "keep",
+            github: r.github?.repository
+                ? {
+                    fullName: r.github.repository.full_name,
+                    stars: r.github.repository.stargazers_count ?? 0,
+                    forks: r.github.repository.forks_count ?? 0,
+                    openIssues: r.github.repository.open_issues_count ?? 0,
+                    language: r.github.repository.language ?? null,
+                    pushedAt: r.github.repository.pushed_at ?? null,
+                    archived: Boolean(r.github.repository.archived),
+                    license: r.github.repository.license?.spdx_id ?? null,
+                    topics: r.github.repository.topics ?? [],
+                }
+                : undefined,
+        };
+    }
+    if (record.kind === "resource") {
+        const r = record;
+        return {
+            ...base,
+            kind: "resource",
+            title: r.title,
+            type: r.type,
+            topic: r.topic,
+            related: r.related,
+            publishedAt: r.publishedAt,
+            author: r.author,
+            // Non-project records store effective visibility at the top
+            // level (no `health` block); applyDecision has already merged
+            // any decisions.yml override into `r.visibility` by the time
+            // we get here.
+            visibility: r.visibility,
+        };
+    }
+    // entity
+    const e = record;
+    return {
+        ...base,
+        kind: "entity",
+        name: e.name,
+        type: e.type,
+        founded: e.founded,
+        location: e.location,
+        members: e.members,
+        parent: e.parent,
+        visibility: e.visibility,
+    };
+}
+// ──────────────────────────────────────────────────────────────────────
+// Health signal derivation
+// ──────────────────────────────────────────────────────────────────────
 function daysSince(value) {
     if (!value)
         return Infinity;
@@ -472,7 +616,7 @@ function daysSince(value) {
     return (Date.now() - d.valueOf()) / 86_400_000;
 }
 export function healthFromSignals(params) {
-    const { repo, monthlyCommits, legacyStatus } = params;
+    const { repo, monthlyCommits } = params;
     const stars = repo?.stargazers_count ?? 0;
     const lastCommitAt = repo?.pushed_at;
     const archived = Boolean(repo?.archived);
@@ -503,10 +647,13 @@ export function healthFromSignals(params) {
                 ? "listed"
                 : "experimental";
     return {
-        status: legacyStatus ?? status,
+        status,
         tier,
         visibility: tier === "hidden" ? "hide" : "keep",
-        cleanupCandidate: status === "stale" || status === "archived" || status === "inactive" || status === "unavailable",
+        cleanupCandidate: status === "stale" ||
+            status === "archived" ||
+            status === "inactive" ||
+            status === "unavailable",
         staleReason: status === "inactive"
             ? "no_commits_24_months"
             : status === "stale"
@@ -518,212 +665,4 @@ export function healthFromSignals(params) {
                         : null,
     };
 }
-export function parseAppYaml(text, fileSlug) {
-    const raw = parse(text) ?? {};
-    if (typeof raw !== "object" || Array.isArray(raw)) {
-        throw new Error(`${fileSlug}: app file must contain a YAML mapping`);
-    }
-    return raw;
-}
-export function stringifyAppYaml(app) {
-    return stringify(app, {
-        lineWidth: 100,
-        singleQuote: false,
-        defaultStringType: "PLAIN",
-    });
-}
-export function getOwnerRepoFromUrl(repoUrl) {
-    if (!repoUrl)
-        return null;
-    const m = String(repoUrl).match(/github\.com\/([^/]+)\/([^/?#]+)/);
-    if (!m)
-        return null;
-    return { owner: m[1], repo: m[2].replace(/\.git$/, "") };
-}
-export function normalizeAppRecord(raw, fileSlug) {
-    const hasFinalShape = typeof raw.app === "object" &&
-        raw.app !== null &&
-        typeof raw.source === "object" &&
-        raw.source !== null &&
-        raw.github !== undefined;
-    if (hasFinalShape) {
-        return normalizeFinal(raw, fileSlug);
-    }
-    return normalizeLegacy(raw, fileSlug);
-}
-function normalizeFinal(raw, fileSlug) {
-    const parsed = finalAppSchema.parse(raw);
-    const repo = parsed.github?.repository;
-    const repoUrl = parsed.source.url ?? repo?.html_url ?? `https://github.com/${parsed.source.owner}/${parsed.source.repo}`;
-    const activity = parsed.github?.activity ?? {};
-    const monthlyCommits = activity.monthlyCommits;
-    const health = {
-        ...healthFromSignals({ repo, monthlyCommits }),
-        ...parsed.health,
-    };
-    const technologies = compactArray((parsed.stack.technologies ?? []).map((t) => t.id));
-    const secondaryStacks = technologies.filter((id) => id !== parsed.stack.primary);
-    const curation = parsed.curation ?? {};
-    return {
-        ...parsed,
-        schemaVersion: 1,
-        slug: parsed.slug || fileSlug,
-        name: parsed.app.name,
-        description: parsed.app.description,
-        repoUrl,
-        homepageUrl: repo?.homepage || raw.homepageUrl || undefined,
-        stack: parsed.stack.primary,
-        stacks: secondaryStacks,
-        platforms: parsed.app.platforms,
-        distribution: parsed.app.distribution ?? { channels: [] },
-        category: parsed.app.category,
-        tags: compactArray([...(parsed.app.tags ?? []), ...(repo?.topics ?? [])]),
-        license: repo?.license?.spdx_id || undefined,
-        status: health.status,
-        stars: repo?.stargazers_count,
-        forks: repo?.forks_count,
-        openIssues: repo?.open_issues_count,
-        lastCommitAt: formatDateOnly(repo?.pushed_at) ?? null,
-        labels: curation.labels ?? [],
-        lenses: curation.lenses ?? [],
-        projectType: parsed.app.projectType,
-        difficulty: curation.difficulty,
-        codebaseSize: curation.codebaseSize,
-        bestFor: curation.bestFor ?? [],
-        whyListed: curation.whyListed ?? [],
-        caveats: curation.caveats ?? [],
-        scores: curation.scores ?? {},
-        curation: {
-            reviewed: Boolean(curation.reviewed),
-            reviewedBy: curation.reviewedBy,
-            reviewedAt: curation.reviewedAt,
-            notes: curation.notes,
-        },
-        github: parsed.github,
-        health,
-        tier: health.tier,
-    };
-}
-function normalizeLegacy(raw, fileSlug) {
-    const parsed = legacyAppSchema.parse({ ...raw, slug: raw.slug ?? fileSlug });
-    const ownerRepo = getOwnerRepoFromUrl(parsed.repoUrl);
-    const activity = parsed.activity ?? {};
-    const repo = {
-        full_name: ownerRepo ? `${ownerRepo.owner}/${ownerRepo.repo}` : undefined,
-        name: ownerRepo?.repo,
-        html_url: parsed.repoUrl,
-        homepage: parsed.homepageUrl,
-        description: parsed.description,
-        fork: false,
-        archived: parsed.status === "archived",
-        disabled: false,
-        private: false,
-        visibility: "public",
-        language: typeof parsed.stack === "string" ? parsed.stack : undefined,
-        license: parsed.license ? { spdx_id: parsed.license } : undefined,
-        stargazers_count: activity.stars ?? parsed.stars,
-        watchers_count: activity.watchers,
-        forks_count: activity.forks ?? parsed.forks,
-        open_issues_count: activity.openIssues,
-        subscribers_count: activity.contributors,
-        pushed_at: activity.lastCommitAt,
-        updated_at: activity.updatedAt,
-    };
-    const monthlyCommits = activity.monthlyCommits ?? [];
-    const primaryStack = typeof parsed.stack === "string" ? parsed.stack : parsed.stack.primary;
-    const health = healthFromSignals({ repo, monthlyCommits, legacyStatus: parsed.status });
-    return {
-        schemaVersion: 0,
-        slug: parsed.slug,
-        name: parsed.name,
-        description: parsed.description,
-        repoUrl: parsed.repoUrl,
-        visibility: health.visibility,
-        cleanupCandidate: health.cleanupCandidate,
-        staleReason: health.staleReason,
-        homepageUrl: parsed.homepageUrl,
-        stack: primaryStack,
-        stacks: compactArray([...(parsed.stacks ?? [])]),
-        platforms: parsed.platforms,
-        distribution: parsed.distribution ?? { channels: [] },
-        category: parsed.category,
-        tags: compactArray((parsed.tags ?? [])),
-        license: parsed.license,
-        status: health.status,
-        stars: repo.stargazers_count,
-        forks: repo.forks_count,
-        openIssues: repo.open_issues_count,
-        lastCommitAt: formatDateOnly(repo.pushed_at) ?? null,
-        labels: parsed.labels ?? [],
-        lenses: parsed.lenses ?? [],
-        projectType: parsed.projectType,
-        difficulty: parsed.difficulty,
-        codebaseSize: parsed.codebaseSize,
-        bestFor: parsed.bestFor ?? [],
-        whyListed: parsed.whyListed ?? [],
-        caveats: parsed.caveats ?? [],
-        scores: parsed.scores ?? {},
-        curation: {
-            reviewed: false,
-        },
-        github: {
-            repository: repo,
-            activity: {
-                monthlyCommits,
-                totalCommitsKnown: activity.totalCommitsKnown,
-                contributorsKnown: activity.contributors,
-                openPullRequests: activity.openPullRequests,
-            },
-            sync: {
-                syncedAt: activity.updatedAt,
-                source: "legacy-activity-block",
-            },
-        },
-        health: {
-            status: health.status,
-            tier: health.tier,
-            visibility: health.visibility,
-            cleanupCandidate: health.cleanupCandidate,
-            staleReason: health.staleReason,
-        },
-        tier: health.tier,
-    };
-}
-export function validateAppRecord(raw, fileSlug) {
-    try {
-        normalizeAppRecord(raw, fileSlug);
-        return [];
-    }
-    catch (err) {
-        if (err instanceof z.ZodError) {
-            return err.issues.map((issue) => `${fileSlug}: ${issue.path.join(".") || "(root)"} ${issue.message}`);
-        }
-        return [`${fileSlug}: ${err.message}`];
-    }
-}
-export function toIndexApp(app) {
-    return {
-        slug: app.slug,
-        name: app.name,
-        description: app.description,
-        repoUrl: app.repoUrl,
-        homepageUrl: app.homepageUrl,
-        category: app.category,
-        platforms: app.platforms ?? [],
-        distribution: app.distribution,
-        primaryStack: app.stack,
-        stack: app.stack,
-        stacks: app.stacks ?? [],
-        technologies: compactArray([app.stack, ...(app.stacks ?? [])]),
-        tier: app.health?.tier ?? app.tier,
-        status: app.health?.status ?? app.status,
-        visibility: app.health?.visibility ?? "keep",
-        stars: app.github?.repository?.stargazers_count ?? app.stars,
-        forks: app.github?.repository?.forks_count,
-        openIssues: app.github?.repository?.open_issues_count,
-        license: app.github?.repository?.license?.spdx_id ?? app.license,
-        lastCommitAt: formatDateOnly(app.github?.repository?.pushed_at ?? app.lastCommitAt),
-        tags: app.tags ?? [],
-    };
-}
 //# sourceMappingURL=schema.js.map