@grove-dev/astro 0.1.5 → 0.2.2

package/templates/default/src/data/types.ts

@@ -1,248 +0,0 @@
-export type AppStatus = "active" | "quiet" | "stale" | "archived" | "unknown";
-export type AppLabel = "new" | "hot" | "mature" | "featured";
-
-// ── Curation: what kind of app is this? ──────────────────────────────
-/**
- * `projectType` answers "is this a real, production-grade codebase
- * or a demo?" — the most-asked filter for anyone scanning a list.
- */
-export type ProjectType =
-  | "real-app"        // Actually used by real people in production
-  | "production"      // Commercial product with open codebase
-  | "reference"       // Showcase of patterns/architecture, not a real product
-  | "demo"            // Demo / proof-of-concept
-  | "template";       // Starter template others fork
-
-export type Difficulty = "beginner" | "intermediate" | "advanced";
-export type CodebaseSize = "small" | "medium" | "large" | "huge";
-
-// ── Scoring: 6-dimension, 0-100 each ─────────────────────────────────
-/**
- * Six orthogonal scores that drive the "decision row" UI.
- * - activity:        how alive is the repo (commits, PRs, issues responded)
- * - maturity:        how established (age, stability, real usage)
- * - learning:        how good for learning (readable code, useful patterns)
- * - contribution:    how welcoming to new contributors
- * - docs:            how good the documentation is
- * - overall:         composite judgment
- *
- * Scores are curator-assigned integers. They are NOT computed from
- * any algorithm — see `curation.notes` for the reasoning chain.
- */
-export type AppScores = {
-  activity: number;
-  maturity: number;
-  learning: number;
-  contribution: number;
-  docs: number;
-  overall: number;
-};
-
-export type GithubRepositoryMetadata = {
-  full_name?: string;
-  html_url?: string;
-  homepage?: string | null;
-  description?: string | null;
-  fork?: boolean;
-  archived?: boolean;
-  disabled?: boolean;
-  private?: boolean;
-  visibility?: string;
-  default_branch?: string;
-  language?: string | null;
-  topics?: string[];
-  license?: {
-    key?: string | null;
-    name?: string | null;
-    spdx_id?: string | null;
-    url?: string | null;
-  } | null;
-  stargazers_count?: number;
-  watchers_count?: number;
-  forks_count?: number;
-  open_issues_count?: number;
-  subscribers_count?: number;
-  size?: number;
-  created_at?: string | null;
-  updated_at?: string | null;
-  pushed_at?: string | null;
-};
-
-export type AppHealth = {
-  status?: string;
-  tier?: string;
-  visibility?: string;
-  activityScore?: number;
-  maintenanceScore?: number;
-  metadataCompleteness?: number;
-  cleanupCandidate?: boolean;
-  staleReason?: string | null;
-};
-
-export type DistributionChannel = {
-  type:
-    | "app-store"
-    | "play-store"
-    | "fdroid"
-    | "github-releases"
-    | "apk"
-    | "testflight"
-    | "website"
-    | "snapcraft"
-    | "flathub"
-    | "microsoft-store"
-    | "other";
-  platform?: string;
-  label?: string;
-  url: string;
-  verified?: boolean;
-  notes?: string;
-};
-
-export type AppDistribution = {
-  channels?: DistributionChannel[];
-};
-
-// ── Curation provenance: was this human-reviewed? ────────────────────
-/**
- * Every curated field needs a chain of trust. `reviewed: true` means
- * a human looked at it and signed off. `reviewed: false` means it's
- * auto-generated (e.g. by AI from public repo metadata) and pending
- * curator review. The UI surfaces this distinction.
- */
-export type CurationInfo = {
-  reviewed: boolean;
-  /** Curator handle, e.g. "@username" or "SITECONFIG_NAME_PLACEHOLDER editors". */
-  by?: string;
-  /** ISO date the curation was authored or last reviewed. */
-  date?: string;
-  /** Free-text: where did the data come from? what's uncertain? */
-  notes?: string;
-};
-
-// ── The app record ──────────────────────────────────────────────────
-/**
- * One open-source app entry.
- *
- * Fields split into two layers:
- *
- * 1. **Required discovery data** — name, description, repo, stack,
- *    platforms, category. Without these, the app can't be listed.
- *
- * 2. **Optional curation data** — everything under the `// ── Curation`
- *    block. New apps start sparse. The 5 anchor apps are fully curated.
- *    The list/detail UI gracefully degrades when fields are missing.
- */
-export type OpenSourceApp = {
-  // ── Identity ──
-  slug: string;
-  name: string;
-  description: string;
-  repoUrl: string;
-  homepageUrl?: string;
-
-  // ── Basic taxonomy ──
-  /** Primary stack, e.g. "Flutter" */
-  stack: string;
-  /** Additional stacks used in the codebase. */
-  stacks?: string[];
-  platforms: string[];
-  distribution?: AppDistribution;
-  category: string;
-  tags?: string[];
-
-  // ── Public signals ──
-  /** Direct URL to a square logo. Falls back to GitHub owner avatar. */
-  logoUrl?: string;
-  stars?: number;
-  license?: string;
-  status?: AppStatus;
-  addedAt?: string;
-  lastCommitAt?: string;
-  labels?: AppLabel[];
-
-  // ── Curation: project shape ──
-  /** What kind of app is this? (real-app / production / reference / …) */
-  projectType?: ProjectType;
-  /** What state-management pattern does it use? "Riverpod", "BLoC", etc. */
-  stateManagement?: string;
-  /** What backend / data layer? "REST", "Firebase", "PostgreSQL", … */
-  backend?: string;
-  /** Architecture style. "Feature-based", "Clean", "MVC", "Layered", … */
-  architecture?: string;
-  /** How hard is it to read / contribute? */
-  difficulty?: Difficulty;
-  /** Approximate size, by curator judgment. */
-  codebaseSize?: CodebaseSize;
-
-  // ── Curation: text signals ──
-  /**
-   * 2-5 short phrases: "Studying offline-first architecture",
-   * "REST API integration patterns", etc. Hand-written.
-   */
-  bestFor?: string[];
-  /**
-   * Why is this app listed? Curator's one-liner per angle.
-   * E.g. ["Most starred Flutter app", "Real production deployment"].
-   */
-  whyListed?: string[];
-  /**
-   * Caveats / risks. Honest downsides, not marketing.
-   * E.g. ["Large codebase", "Sparse documentation", "Archived"].
-   */
-  caveats?: string[];
-
-  // ── Curation: contribution links ──
-  /**
-   * `true` if the repo has a "good first issue" label,
-   * or a direct URL to a filtered list of them.
-   */
-  goodFirstIssues?: boolean | string;
-  /** `true` if the repo has a CONTRIBUTING.md, or a direct URL. */
-  contributionGuide?: boolean | string;
-
-  // ── Curation: launch (Product-Hunt-style, optional) ──
-  /**
-   * For recently-launched apps, the username of the person who
-   * submitted the launch entry. Long-running apps leave this empty.
-   */
-  launchedBy?: string;
-  /**
-   * What the maintainer wants from this launch:
-   * "Feedback", "Contributors", "Users", "Stars", etc.
-   */
-  launchAsk?: string[];
-
-  /**
-   * Curated lenses — the curated "tabs" on the list page. These are
-   * hand-assigned per app by a curator; not derived from scores.
-   * Valid values: "good-to-learn" | "production-like" |
-   * "beginner-friendly" | "contribution-ready" | "launches".
-   * The label-based lenses (new / hot / mature) live in `labels`.
-   */
-  lenses?: string[];
-
-  // ── Curation: scores ──
-  scores?: AppScores;
-
-  // ── Curation: provenance ──
-  curation?: CurationInfo;
-
-  // ── Final schema raw blocks ────────────────────────────────────────
-  github?: {
-    repository?: GithubRepositoryMetadata;
-    languages?: Record<string, number>;
-    latestRelease?: Record<string, unknown> | null;
-    activity?: {
-      monthlyCommits?: Array<number | { month: string; commits: number }>;
-      totalCommitsKnown?: number;
-      contributorsKnown?: number;
-      openPullRequests?: number;
-    };
-    files?: Record<string, boolean>;
-    labels?: Array<Record<string, unknown>>;
-    sync?: Record<string, unknown>;
-  };
-  health?: AppHealth;
-  tier?: string;
-};

package/templates/default/src/lib/apps-search.ts

@@ -1,228 +0,0 @@
-/**
- * Filter / sort / pagination helpers for the apps list page.
- *
- * This file is a thin proxy over `@grove-dev/ui` and `@grove-dev/core`
- * — the actual business logic lives there. The proxy keeps the
- * `OpenSourceApp` shape (defined in `data/types.ts`) compatible
- * with the core `AppRecord` shape.
- */
-import type { OpenSourceApp } from "../data/types";
-
-export const PAGE_SIZE = 20;
-
-export const SORT_OPTIONS = [
-  { value: "recently-updated", label: "Recently updated" },
-  { value: "most-starred", label: "Most starred" },
-  { value: "recently-added", label: "Recently added" },
-  { value: "most-mature", label: "Most mature" },
-  { value: "alphabetical", label: "Alphabetical" },
-] as const;
-
-export type AppsSort = (typeof SORT_OPTIONS)[number]["value"];
-
-export type AppsFilters = {
-  q?: string;
-  stacks?: string[];
-  platforms?: string[];
-  categories?: string[];
-  labels?: string[];
-  licenses?: string[];
-  statuses?: string[];
-  lens?: string;
-  sort?: AppsSort;
-  page?: number;
-  density?: "comfortable" | "compact";
-};
-
-const KEYS = {
-  q: "q",
-  stacks: "stack",
-  platforms: "platform",
-  categories: "category",
-  labels: "label",
-  licenses: "license",
-  statuses: "status",
-  lens: "lens",
-  sort: "sort",
-  page: "page",
-  density: "density",
-} as const;
-
-const DEFAULT_SORT: AppsSort = "recently-updated";
-const DEFAULT_PAGE = 1;
-
-export function filtersFromSearchParams(sp: URLSearchParams): AppsFilters {
-  const rawSort = sp.get(KEYS.sort);
-  const sort: AppsSort | undefined =
-    rawSort && SORT_OPTIONS.some((o) => o.value === rawSort) ? (rawSort as AppsSort) : undefined;
-  const rawPage = Number(sp.get(KEYS.page));
-  const page = Number.isFinite(rawPage) && rawPage >= 1 ? Math.floor(rawPage) : undefined;
-  const rawDensity = sp.get(KEYS.density);
-  const density = rawDensity === "compact" || rawDensity === "comfortable" ? rawDensity : undefined;
-  return {
-    q: sp.get(KEYS.q) ?? undefined,
-    stacks: sp.getAll(KEYS.stacks).filter(Boolean),
-    platforms: sp.getAll(KEYS.platforms).filter(Boolean),
-    categories: sp.getAll(KEYS.categories).filter(Boolean),
-    labels: sp.getAll(KEYS.labels).filter(Boolean),
-    licenses: sp.getAll(KEYS.licenses).filter(Boolean),
-    statuses: sp.getAll(KEYS.statuses).flatMap((s) => s.split(",")).filter(Boolean),
-    lens: sp.get(KEYS.lens) ?? undefined,
-    sort,
-    page,
-    density,
-  };
-}
-
-export function searchParamsFromFilters(f: AppsFilters): URLSearchParams {
-  const sp = new URLSearchParams();
-  if (f.q) sp.set(KEYS.q, f.q);
-  for (const v of f.stacks ?? []) sp.append(KEYS.stacks, v);
-  for (const v of f.platforms ?? []) sp.append(KEYS.platforms, v);
-  for (const v of f.categories ?? []) sp.append(KEYS.categories, v);
-  for (const v of f.labels ?? []) sp.append(KEYS.labels, v);
-  for (const v of f.licenses ?? []) sp.append(KEYS.licenses, v);
-  if (f.statuses?.length) sp.set(KEYS.statuses, f.statuses.join(","));
-  if (f.lens) sp.set(KEYS.lens, f.lens);
-  if (f.sort && f.sort !== DEFAULT_SORT) sp.set(KEYS.sort, f.sort);
-  if (f.page && f.page !== DEFAULT_PAGE) sp.set(KEYS.page, String(f.page));
-  if (f.density && f.density !== "comfortable") sp.set(KEYS.density, f.density);
-  return sp;
-}
-
-export function hasAnyFilter(f: AppsFilters): boolean {
-  if (f.q && f.q.trim()) return true;
-  if (f.lens) return true;
-  return Boolean(
-    (f.stacks?.length ?? 0) +
-      (f.platforms?.length ?? 0) +
-      (f.categories?.length ?? 0) +
-      (f.labels?.length ?? 0) +
-      (f.licenses?.length ?? 0) +
-      (f.statuses?.length ?? 0),
-  );
-}
-
-export function applySort(apps: OpenSourceApp[], sort: AppsSort): OpenSourceApp[] {
-  const arr = apps.slice();
-  const ts = (s?: string | null): number => (s ? new Date(s).valueOf() : 0);
-  switch (sort) {
-    case "most-starred":
-      arr.sort((a, b) => (b.stars ?? 0) - (a.stars ?? 0));
-      break;
-    case "recently-updated":
-      arr.sort((a, b) => ts(b.lastCommitAt) - ts(a.lastCommitAt));
-      break;
-    case "recently-added":
-      arr.sort((a, b) => ts(b.addedAt) - ts(a.addedAt));
-      break;
-    case "most-mature":
-      arr.sort((a, b) => (b.stars ?? 0) - (a.stars ?? 0));
-      break;
-    case "alphabetical":
-      arr.sort((a, b) => a.name.localeCompare(b.name));
-      break;
-  }
-  return arr;
-}
-
-export function paginate<T>(items: T[], page: number, pageSize = PAGE_SIZE): T[] {
-  const start = (page - 1) * pageSize;
-  return items.slice(start, start + pageSize);
-}
-
-export function totalPages(itemCount: number, pageSize = PAGE_SIZE): number {
-  return Math.max(1, Math.ceil(itemCount / pageSize));
-}
-
-export function effectiveSort(f: AppsFilters): AppsSort {
-  return f.sort ?? DEFAULT_SORT;
-}
-export function effectivePage(f: AppsFilters): number {
-  return f.page ?? DEFAULT_PAGE;
-}
-export function effectiveDensity(f: AppsFilters): "comfortable" | "compact" {
-  return f.density ?? "comfortable";
-}
-
-export function filterApps(apps: OpenSourceApp[], f: AppsFilters): OpenSourceApp[] {
-  const q = f.q?.trim().toLowerCase();
-  const stacks = f.stacks?.length ? new Set(f.stacks) : null;
-  const platforms = f.platforms?.length ? new Set(f.platforms) : null;
-  const categories = f.categories?.length ? new Set(f.categories) : null;
-  const labels = f.labels?.length ? new Set(f.labels) : null;
-  const licenses = f.licenses?.length ? new Set(f.licenses) : null;
-  const statuses = f.statuses?.length ? new Set(f.statuses) : null;
-
-  return apps.filter((a) => {
-    if (q) {
-      const ownerMatch = /github\.com\/([^/]+)\//.exec(a.repoUrl)?.[1]?.toLowerCase() ?? "";
-      const haystack = [a.name, ownerMatch, a.description, a.category].join(" ").toLowerCase();
-      if (!haystack.includes(q)) return false;
-    }
-    if (stacks) {
-      const allStacks = [a.stack, ...(a.stacks ?? [])];
-      if (!allStacks.some((s) => stacks.has(s))) return false;
-    }
-    if (platforms) {
-      if (!a.platforms.some((p) => platforms.has(p))) return false;
-    }
-    if (categories) {
-      if (!categories.has(a.category)) return false;
-    }
-    if (labels) {
-      if (!a.labels?.some((l) => labels.has(l))) return false;
-    }
-    if (licenses) {
-      if (!a.license || !licenses.has(a.license)) return false;
-    }
-    if (statuses) {
-      if (!a.status || !statuses.has(a.status)) return false;
-    }
-    if (f.lens) {
-      if (!a.lenses?.includes(f.lens)) return false;
-    }
-    return true;
-  });
-}
-
-export function activeFilterChips(
-  f: AppsFilters,
-): { key: keyof AppsFilters; value: string; label: string }[] {
-  const out: { key: keyof AppsFilters; value: string; label: string }[] = [];
-  if (f.q && f.q.trim()) out.push({ key: "q", value: "", label: `“${f.q}”` });
-  for (const v of f.stacks ?? []) out.push({ key: "stacks", value: v, label: `stack: ${v}` });
-  for (const v of f.platforms ?? []) out.push({ key: "platforms", value: v, label: `platform: ${v}` });
-  for (const v of f.categories ?? []) out.push({ key: "categories", value: v, label: `category: ${v}` });
-  for (const v of f.labels ?? []) out.push({ key: "labels", value: v, label: v });
-  for (const v of f.licenses ?? []) out.push({ key: "licenses", value: v, label: `license: ${v}` });
-  if (f.lens) out.push({ key: "lens", value: f.lens, label: `lens: ${f.lens}` });
-  return out;
-}
-
-export function buildFacets(apps: OpenSourceApp[]) {
-  const counts = {
-    stack: new Map<string, number>(),
-    platform: new Map<string, number>(),
-    category: new Map<string, number>(),
-    label: new Map<string, number>(),
-    license: new Map<string, number>(),
-  };
-  for (const a of apps) {
-    const allStacks = new Set([a.stack, ...(a.stacks ?? [])]);
-    for (const s of allStacks) counts.stack.set(s, (counts.stack.get(s) ?? 0) + 1);
-    for (const p of a.platforms) counts.platform.set(p, (counts.platform.get(p) ?? 0) + 1);
-    counts.category.set(a.category, (counts.category.get(a.category) ?? 0) + 1);
-    for (const l of a.labels ?? []) counts.label.set(l, (counts.label.get(l) ?? 0) + 1);
-    if (a.license) counts.license.set(a.license, (counts.license.get(a.license) ?? 0) + 1);
-  }
-  const sortByCountThenName = (m: Map<string, number>) =>
-    [...m.entries()].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])).map(([value, count]) => ({ value, count }));
-  return {
-    stacks: sortByCountThenName(counts.stack),
-    platforms: sortByCountThenName(counts.platform),
-    categories: sortByCountThenName(counts.category),
-    labels: sortByCountThenName(counts.label),
-    licenses: sortByCountThenName(counts.license),
-  };
-}

package/templates/default/src/lib/format.ts

@@ -1,36 +0,0 @@
-/** Number/date formatting helpers used across the templates. */
-export function compact(n: number): string {
-  if (n >= 1000) {
-    const k = n / 1000;
-    return (k >= 10 ? Math.round(k).toString() : k.toFixed(1)) + "k";
-  }
-  return n.toString();
-}
-
-export function formatStars(n: number | null | undefined): string | null {
-  if (typeof n !== "number" || !Number.isFinite(n)) return null;
-  return compact(n);
-}
-
-export function formatRelative(iso: string | null | undefined): string {
-  if (!iso) return "—";
-  const d = new Date(iso);
-  if (Number.isNaN(d.valueOf())) return "—";
-  const days = Math.floor((Date.now() - d.valueOf()) / (1000 * 60 * 60 * 24));
-  if (days <= 0) return "today";
-  if (days === 1) return "1d ago";
-  if (days < 30) return `${days}d ago`;
-  const months = Math.floor(days / 30);
-  if (months === 1) return "1mo ago";
-  if (months < 12) return `${months}mo ago`;
-  const years = Math.floor(months / 12);
-  if (years === 1) return "1y ago";
-  return `${years}y ago`;
-}
-
-export function formatDate(iso: string | null | undefined): string {
-  if (!iso) return "—";
-  const d = new Date(iso);
-  if (Number.isNaN(d.valueOf())) return iso;
-  return d.toLocaleDateString("en-US", { year: "numeric", month: "short", day: "numeric" });
-}

package/templates/default/src/lib/lenses.ts

@@ -1,98 +0,0 @@
-/**
- * Curated lenses. The proxy lives here so the page can stay clean.
- * For a generic, headless version, see `@grove-dev/ui`.
- */
-
-export type LensId =
-  | "all"
-  | "new"
-  | "hot"
-  | "mature"
-  | "good-to-learn"
-  | "production-like"
-  | "beginner-friendly"
-  | "contribution-ready"
-  | "launches"
-  | "actively-developed"
-  | "needs-maintainer";
-
-export interface LensDef {
-  id: LensId;
-  label: string;
-  description?: string;
-  toParams: () => Record<string, string | string[]>;
-}
-
-export const LENSES: LensDef[] = [
-  { id: "all", label: "All apps", description: "Every app in the directory", toParams: () => ({}) },
-  { id: "new", label: "Newly added", description: "Recently added to the directory", toParams: () => ({ label: "new" }) },
-  { id: "hot", label: "Hot right now", description: "Apps gaining attention or recent activity", toParams: () => ({ label: "hot" }) },
-  { id: "mature", label: "Mature", description: "Established long-running projects", toParams: () => ({ label: "mature" }) },
-  { id: "production-like", label: "Production-grade", description: "Real apps, not toy projects", toParams: () => ({ lens: "production-like" }) },
-  { id: "good-to-learn", label: "Good to learn", description: "Readable codebases with useful patterns", toParams: () => ({ lens: "good-to-learn" }) },
-  { id: "beginner-friendly", label: "Beginner friendly", description: "Smaller, readable, easier to understand", toParams: () => ({ lens: "beginner-friendly" }) },
-  { id: "contribution-ready", label: "Contribution ready", description: "Clear issues, active maintainers, license, contribution docs", toParams: () => ({ lens: "contribution-ready" }) },
-  { id: "launches", label: "Launches", description: "Recently launched OSS apps seeking feedback", toParams: () => ({ lens: "launches" }) },
-  { id: "actively-developed", label: "Actively developed", description: "Recent commits, releases, issue activity", toParams: () => ({ status: "active" }) },
-  { id: "needs-maintainer", label: "Needs maintainer", description: "Useful apps that need help", toParams: () => ({ status: "stale,quiet" }) },
-];
-
-export const PRIMARY_LENSES: LensId[] = [
-  "all",
-  "new",
-  "hot",
-  "mature",
-  "production-like",
-  "good-to-learn",
-];
-
-export function lensById(id: string | null | undefined): LensDef | undefined {
-  if (!id) return undefined;
-  return LENSES.find((l) => l.id === id);
-}
-
-export function isLensActive(lensId: LensId, sp: URLSearchParams): boolean {
-  if (lensId === "all") {
-    return !lensFromSearchParams(sp) && !sp.get("label") && !sp.get("status");
-  }
-  const def = lensById(lensId);
-  if (!def) return false;
-  const target = def.toParams();
-  for (const [k, v] of Object.entries(target)) {
-    if (Array.isArray(v)) {
-      if (sp.getAll(k).length !== v.length) return false;
-      for (const item of v) if (!sp.getAll(k).includes(item)) return false;
-    } else {
-      if (sp.get(k) !== v) return false;
-    }
-  }
-  return true;
-}
-
-export function isPrimaryLens(id: string | null | undefined): boolean {
-  if (!id) return false;
-  return PRIMARY_LENSES.includes(id as LensId);
-}
-
-export function lensToQuery(id: LensId | null | undefined, current: URLSearchParams): string {
-  if (!id || id === "all") return "";
-  const def = lensById(id);
-  if (!def) return "";
-  const next = new URLSearchParams(current);
-  for (const [k, v] of Object.entries(def.toParams())) {
-    if (Array.isArray(v)) {
-      next.delete(k);
-      for (const item of v) next.append(k, item);
-    } else {
-      next.set(k, v);
-    }
-  }
-  return next.toString();
-}
-
-export function lensFromSearchParams(sp: URLSearchParams): LensId | null {
-  const v = sp.get("lens");
-  if (!v) return null;
-  if (LENSES.some((l) => l.id === v)) return v as LensId;
-  return null;
-}

package/templates/default/src/lib/repo.ts

@@ -1,12 +0,0 @@
-/** GitHub repo URL parsing helpers. */
-export function getOwnerAndRepoFromRepoUrl(repoUrl: string): { owner: string | null; repo: string | null } {
-  if (!repoUrl || !repoUrl.includes("github.com/")) return { owner: null, repo: null };
-  const m = repoUrl.match(/github\.com\/([^/]+)\/([^/?#]+)/);
-  if (!m) return { owner: null, repo: null };
-  return { owner: m[1], repo: m[2].replace(/\.git$/, "") };
-}
-
-export function getOwnerAvatarUrl(owner: string | null, size: number = 80): string | null {
-  if (!owner) return null;
-  return `https://avatars.githubusercontent.com/${owner}?v=4&s=${size}`;
-}

package/templates/default/src/lib/scores.ts

@@ -1,51 +0,0 @@
-/**
- * Score display helpers used across list and detail pages.
- * Generic version lives in `@grove-dev/ui` — this proxies the
- * `AppScores` shape defined in template `data/types.ts`.
- */
-import type { AppScores } from "../data/types";
-
-export function scoreTier(n: number): 0 | 1 | 2 | 3 | 4 {
-  if (n < 20) return 0;
-  if (n < 40) return 1;
-  if (n < 60) return 2;
-  if (n < 80) return 3;
-  return 4;
-}
-
-export function scoreTierLabel(n: number): string {
-  switch (scoreTier(n)) {
-    case 0: return "Very low";
-    case 1: return "Low";
-    case 2: return "Medium";
-    case 3: return "High";
-    case 4: return "Very high";
-  }
-}
-
-export function scoreLabel(n: number | undefined): string {
-  if (typeof n !== "number") return "—";
-  return Math.round(n).toString();
-}
-
-export const SCORE_DIMENSIONS: (keyof AppScores)[] = [
-  "activity", "maturity", "learning", "contribution", "docs", "overall",
-];
-
-export const SCORE_LABELS: Record<keyof AppScores, string> = {
-  activity: "Activity",
-  maturity: "Maturity",
-  learning: "Learning",
-  contribution: "Contribution",
-  docs: "Docs",
-  overall: "Overall",
-};
-
-export const SCORE_REASONING: Record<keyof AppScores, string> = {
-  activity: "Recent commits, open and merged PRs, issue response time, release cadence.",
-  maturity: "Repo age, stable structure, real-world production usage, contributor stability.",
-  learning: "Codebase readability, useful architecture patterns, comment quality, examples.",
-  contribution: "Open issues, recent merged PRs from new contributors, maintainer responsiveness, contribution guide.",
-  docs: "README quality, architecture docs, contributing guide, examples, code comments.",
-  overall: "Composite judgment — how likely this app is to satisfy a curious developer.",
-};