@cratis/cast 0.0.1 → 0.2.0

package/config/CastConfig.ts

@@ -0,0 +1,17 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { z } from 'zod';
+import type { castSchema } from './castSchema';
+
+/** cast.yaml as written, before defaults are applied. */
+export type CastInput = z.input<typeof castSchema>;
+
+/** cast.yaml after validation and defaults. Career events always carry a `seq`; `github.login` always equals `person.handle`. */
+export type CastConfig = Omit<z.output<typeof castSchema>, 'career'> & {
+    career: { events: CareerEvent[] };
+    github: z.output<typeof castSchema>['github'] & { login: string };
+};
+
+/** One fact in the career stream. */
+export type CareerEvent = Omit<z.output<typeof castSchema>['career']['events'][number], 'seq'> & { seq: number };

package/config/CastConfigError.ts

@@ -0,0 +1,10 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/** Thrown when cast.yaml does not validate. The message lists every problem with its path. */
+export class CastConfigError extends Error {
+    constructor(readonly problems: string[], source = 'cast.yaml') {
+        super(`${source} is not valid:\n${problems.map(problem => `  - ${problem}`).join('\n')}`);
+        this.name = 'CastConfigError';
+    }
+}

package/config/LiveStat.ts

@@ -0,0 +1,17 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/** Build-time sources a stat can take its value from instead of the value written in cast.yaml. */
+export enum LiveStat {
+    /** GitHub contributions in the last year, floored to hundreds. */
+    ContributionsLastYear = 'contributionsLastYear',
+
+    /** Merged public pull requests in the configured organizations, floored to hundreds. */
+    MergedPullRequests = 'mergedPullRequests',
+
+    /** Number of tracked repositories where the person is the top human committer. */
+    RankOneRepositories = 'rankOneRepositories',
+
+    /** Number of entries in `cratis.clientLanguages`. */
+    ClientLanguages = 'clientLanguages',
+}

package/config/ResolvedSection.ts

@@ -0,0 +1,13 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { SectionId } from './SectionId';
+
+/** A section that will render, with its two-digit index and any copy overrides. */
+export type ResolvedSection = {
+    id: SectionId;
+    index: string;
+    title?: string;
+    label?: string;
+    intro?: string;
+};

package/config/SectionId.ts

@@ -0,0 +1,21 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/** Every section a Cast home page can render, in their default order. */
+export enum SectionId {
+    Hero = 'hero',
+    Now = 'now',
+    Stats = 'stats',
+    Career = 'career',
+    Model = 'model',
+    Cratis = 'cratis',
+    Activity = 'activity',
+    Agentic = 'agentic',
+    Projects = 'projects',
+    Writing = 'writing',
+    Talks = 'talks',
+    Skills = 'skills',
+    Contact = 'contact',
+}
+
+export const defaultSectionOrder: SectionId[] = Object.values(SectionId);

package/config/ThemeMode.ts

@@ -0,0 +1,9 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/** The theme a first-time visitor sees. Visitors can always switch, and their choice is remembered. */
+export enum ThemeMode {
+    Dark = 'dark',
+    Light = 'light',
+    System = 'system',
+}

package/config/calendar.ts

@@ -0,0 +1,34 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+const dayPattern = /^(\d{4})-(\d{2})-(\d{2})/;
+
+/** True when `year`, `month` and `day` name a real day: '2026-02-30' and '2026-99-99' do not. */
+function isRealDay(year: number, month: number, day: number): boolean {
+    if (year < 1000 || month < 1 || month > 12 || day < 1) return false;
+    const date = new Date(Date.UTC(year, month - 1, day));
+    return date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day;
+}
+
+/** True for a real calendar day written as 'YYYY-MM-DD'. */
+export function isCalendarDate(value: string): boolean {
+    const match = dayPattern.exec(value);
+    return match !== null && match[0].length === value.length && isRealDay(Number(match[1]), Number(match[2]), Number(match[3]));
+}
+
+/** True for 'YYYY' or 'YYYY-MM' with a real month. */
+export function isCalendarMonth(value: string): boolean {
+    const match = /^(\d{4})(?:-(\d{2}))?$/.exec(value);
+    return match !== null && isRealDay(Number(match[1]), Number(match[2] ?? 1), 1);
+}
+
+/** True for 'YYYY-MM-DD', 'YYYY-MM' or 'YYYY', each a real day or month. */
+export function isPartialDate(value: string): boolean {
+    return value.length === 10 ? isCalendarDate(value) : isCalendarMonth(value);
+}
+
+/** True for an ISO 8601 date or date and time that starts with a real calendar day and that `Date` can read. */
+export function isInstant(value: string): boolean {
+    const match = dayPattern.exec(value);
+    return match !== null && isRealDay(Number(match[1]), Number(match[2]), Number(match[3])) && Number.isFinite(Date.parse(value));
+}

package/config/castSchema.ts

@@ -0,0 +1,263 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { z } from 'zod';
+import { isCalendarMonth, isPartialDate } from './calendar';
+import { LiveStat } from './LiveStat';
+import { SectionId } from './SectionId';
+import { ThemeMode } from './ThemeMode';
+
+/** 'YYYY-MM' or 'YYYY'. */
+const month = z.string().regex(/^\d{4}(-\d{2})?$/, 'Use YYYY-MM or YYYY').refine(isCalendarMonth, 'Use a real month: YYYY-MM or YYYY');
+
+/** 'YYYY-MM-DD', 'YYYY-MM' or 'YYYY'. */
+const date = z.string().regex(/^\d{4}(-\d{2}(-\d{2})?)?$/, 'Use YYYY-MM-DD, YYYY-MM or YYYY').refine(isPartialDate, 'Use a real date: YYYY-MM-DD, YYYY-MM or YYYY');
+
+const url = z.url({ protocol: /^https?$/ });
+const hex = z.string().regex(/^#[0-9a-fA-F]{6}$/, 'Use a six-digit hex color such as #8b5cf6');
+
+/** Inline text may use *emphasis*, `code` and [links](https://example.com). */
+const text = z.string().min(1);
+
+export const personSchema = z.object({
+    name: z.string().min(1).describe('Display name, for example "Ada Lovelace".'),
+    fullName: z.string().optional().describe('Full legal name when it differs from the display name.'),
+    handle: z.string().regex(/^[A-Za-z0-9](?:[A-Za-z0-9]|-(?=[A-Za-z0-9])){0,38}$/, 'Must be your GitHub login').describe('Your GitHub login: your one Cast identity. Tier, badge, /cast.json and the verification page all use it.'),
+    title: z.string().min(1).describe('Role line under your name.'),
+    titleShort: z.string().optional().describe('Shorter role line for small screens.'),
+    location: z.string().optional(),
+    country: z.string().length(2).optional().describe('ISO 3166 two-letter country code, used in structured data.'),
+    email: z.email().optional(),
+    photo: z.string().optional().describe('Portrait: a path relative to cast.yaml (for example ./avatar.jpeg) or an https URL.'),
+    links: z.record(z.string(), url).default({}).describe('Profile links by name: github, linkedin, mastodon, bluesky, website or anything else.'),
+    tagline: text.describe('The hero headline. Wrap the words to accent in *asterisks*.'),
+    intro: text.describe('One paragraph under the headline.'),
+    about: z.array(text).default([]),
+    interests: z.array(z.string()).default([]),
+    languages: z.array(z.string()).default([]),
+});
+
+export const careerEventSchema = z.object({
+    seq: z.number().int().positive().optional().describe('Stream position. Assigned in file order when omitted.'),
+    date: month,
+    endDate: month.optional().describe('End of an engagement that does not set a role.'),
+    type: z.string().regex(/^[A-Z][A-Za-z]+$/, 'Event types are past-tense PascalCase, for example EmploymentStarted').describe('Past-tense event name.'),
+    title: z.string().min(1),
+    org: z.string().optional(),
+    orgUrl: url.optional(),
+    location: z.string().optional(),
+    summary: text,
+    skills: z.array(z.string()).optional(),
+    role: z.string().optional().describe('Sets the current role in the projection.'),
+    endsRole: z.string().optional().describe('Organization whose open role this event ends.'),
+});
+
+export const statSchema = z.object({
+    value: z.number(),
+    prefix: z.string().default(''),
+    suffix: z.string().default(''),
+    label: z.string().min(1),
+    live: z.enum(LiveStat).optional().describe('Replace the value with a build-time number.'),
+    plain: z.boolean().default(false).describe('Show the value without counting up or thousands separators.'),
+});
+
+export const cratisRepositorySchema = z.object({
+    name: z.string().min(1).describe('Repository name in the Cratis organization.'),
+    url: url.optional().describe('Omit for repositories that are not public; they are then never fetched.'),
+    kind: z.string().min(1),
+    group: z.enum(['pipeline', 'tooling', 'client']).default('tooling'),
+    step: z.string().optional(),
+    note: z.string().optional(),
+    role: z.string().optional().describe('Fallback role text; replaced by the live rank when GitHub data is available.'),
+    rank: z.number().int().min(0).default(0),
+    founded: z.boolean().default(false),
+    commits: z.number().int().min(0).default(0),
+    prs: z.number().int().min(0).default(0),
+    desc: text,
+});
+
+export const cratisSchema = z.object({
+    title: z.string().default('What I lead at Cratis.'),
+    label: z.string().default('Cratis'),
+    pitch: text.optional(),
+    role: text.describe('What you do at Cratis, in your own words.'),
+    links: z.record(z.string(), url).default({ 'cratis.io': 'https://cratis.io', 'github.com/Cratis': 'https://github.com/Cratis' }),
+    pipeline: z.array(z.string()).default([]).describe('Repository names shown as the model-to-running-app pipeline, left to right.'),
+    clientLanguages: z.array(z.string()).default([]),
+    repos: z.array(cratisRepositorySchema).default([]),
+    highlights: z.array(z.string()).default([]),
+});
+
+export const projectSchema = z.object({
+    name: z.string().min(1),
+    url: url,
+    pitch: text,
+    features: z.array(z.string()).default([]),
+    stack: z.array(z.string()).default([]),
+    install: z.string().optional().describe('Install command with a copy button.'),
+    version: z.string().optional().describe('Fallback version; replaced by the latest GitHub release when tracked.'),
+    category: z.string().default('project'),
+    featured: z.boolean().default(false).describe('Show the card at double width.'),
+});
+
+export const projectCategorySchema = z.object({
+    id: z.string().min(1),
+    label: z.string().min(1),
+    filter: z.string().optional().describe('Filter chip label; defaults to label.'),
+});
+
+export const talkSchema = z.object({
+    title: z.string().min(1),
+    lang: z.string().default('en').describe('BCP 47 language of the talk, for example "en" or "no".'),
+    host: z.string().min(1),
+    with: z.string().optional(),
+    date: date,
+    url: url.optional(),
+    summary: text,
+});
+
+export const communitySchema = z.object({
+    title: z.string().min(1),
+    detail: z.string().default(''),
+    date: date,
+});
+
+export const writingSourceSchema = z.union([
+    z.object({
+        rss: url.describe('RSS or Atom feed URL.'),
+        author: z.string().optional().describe('Only include entries by this author name.'),
+    }),
+    z.object({
+        starlightBlogAuthor: url.describe('Author page of a Starlight Blog site, for example https://blog.cratis.io/authors/your-name/.'),
+    }),
+]);
+
+export const writingThemeSchema = z.object({
+    id: z.string().regex(/^[a-z0-9-]+$/),
+    label: z.string().min(1),
+    tags: z.array(z.string()).min(1),
+});
+
+export const writingSchema = z.object({
+    sources: z.array(writingSourceSchema).default([]),
+    themes: z.array(writingThemeSchema).default([]).describe('Filter chips, each a set of post tags.'),
+    agenticTheme: z.string().optional().describe('Theme id whose posts the agentic section lists.'),
+});
+
+export const agenticStepSchema = z.object({
+    step: z.string().min(1),
+    event: z.string().regex(/^[A-Z][A-Za-z]+$/),
+    who: z.string().min(1),
+    text: text,
+    loop: z.string().optional().describe('A loop-back note shown on the step, for example "blocker → Implement".'),
+});
+
+export const agenticItemSchema = z.object({
+    name: z.string().min(1),
+    url: url.optional(),
+    kind: z.string().min(1),
+    text: text,
+    list: z.array(z.string()).optional(),
+    listLabel: z.string().optional(),
+});
+
+export const agenticSchema = z.object({
+    title: z.string().default('I build the harness.'),
+    pitch: text,
+    label: z.string().default('Agentic engineering'),
+    workflowLabel: z.string().default('every change in my setup'),
+    workflow: z.array(agenticStepSchema).default([]),
+    items: z.array(agenticItemSchema).default([]),
+});
+
+export const modelCardSchema = z.object({
+    id: z.string().min(1),
+    kind: z.enum(['ui', 'command', 'event', 'view']),
+    name: z.string().min(1),
+    lane: z.string().min(1),
+    col: z.number().int().min(0),
+    source: z.string().min(1),
+    note: text,
+});
+
+export const eventModelSchema = z.object({
+    title: z.string().default('Start with the *event model.*'),
+    label: z.string().default('How I think'),
+    intro: text.optional().describe('Paragraph under the title. Defaults to a short explanation of the board.'),
+    summary: z.string().optional().describe('Line under the board before a card is selected.'),
+    name: z.string().min(1),
+    repo: url,
+    sourceRoot: z.string().default(''),
+    branch: z.string().default('main'),
+    columns: z.number().int().positive(),
+    lanes: z.array(z.object({ id: z.string().min(1), label: z.string().min(1) })).min(1),
+    cards: z.array(modelCardSchema).min(1),
+    edges: z.array(z.tuple([z.string(), z.string()])).default([]),
+    steps: z.array(z.object({ title: z.string().min(1), text: text, cards: z.array(z.string()) })).default([]),
+});
+
+export const educationSchema = z.object({
+    degree: z.string().min(1),
+    school: z.string().min(1),
+    from: z.string().min(1),
+    to: z.string().optional(),
+});
+
+export const certificationSchema = z.object({
+    title: z.string().min(1),
+    issuer: z.string().min(1),
+    year: z.string().min(1),
+    url: url.optional(),
+});
+
+export const githubSchema = z.object({
+    login: z.string().optional().describe('Must equal person.handle (case-insensitive) when given; your GitHub login is your one identity.'),
+    orgs: z.array(z.string()).default(['Cratis']).describe('Organizations whose merged public pull requests are counted. The first one feeds the live pull request feed.'),
+    releases: z.array(z.string().regex(/^[\w.-]+\/[\w.-]+$/)).default([]).describe('owner/name repositories whose latest release versions your projects.'),
+    stars: z.array(z.string().regex(/^[\w.-]+\/[\w.-]+$/)).default([]).describe('owner/name repositories whose star count is shown.'),
+});
+
+export const themeSchema = z.object({
+    accent: hex.default('#8b5cf6').describe('Your accent color. Defaults to Cratis violet.'),
+    mode: z.enum(ThemeMode).default(ThemeMode.Dark),
+});
+
+export const sectionEntrySchema = z.union([
+    z.enum(SectionId),
+    z.object({
+        id: z.enum(SectionId),
+        title: z.string().optional(),
+        label: z.string().optional(),
+        intro: text.optional(),
+    }),
+]);
+
+export const siteSchema = z.object({
+    url: url.describe('Public URL of the site, for example https://ada.dev.'),
+    description: z.string().optional().describe('Meta description; defaults to the tagline and intro.'),
+    source: url.optional().describe('Source repository, linked in the footer.'),
+    language: z.string().default('en'),
+});
+
+export const castSchema = z.object({
+    $schema: z.string().optional(),
+    site: siteSchema,
+    person: personSchema,
+    now: z.record(z.string(), z.union([z.string(), z.array(z.string())])).default({}).describe('The "now" read model: ordered key/value rows. YYYY-MM values are shown as months.'),
+    stats: z.array(statSchema).default([]),
+    career: z.object({ events: z.array(careerEventSchema).default([]) }).default({ events: [] }),
+    cratis: cratisSchema.optional(),
+    projects: z.array(projectSchema).default([]),
+    projectCategories: z.array(projectCategorySchema).default([]),
+    talks: z.array(talkSchema).default([]),
+    community: z.array(communitySchema).default([]),
+    writing: writingSchema.default({ sources: [], themes: [] }),
+    agentic: agenticSchema.optional(),
+    eventModel: eventModelSchema.optional(),
+    skills: z.record(z.string(), z.array(z.string())).default({}),
+    education: z.array(educationSchema).default([]),
+    certifications: z.array(certificationSchema).default([]),
+    github: githubSchema.default({ orgs: ['Cratis'], releases: [], stars: [] }),
+    theme: themeSchema.default({ accent: '#8b5cf6', mode: ThemeMode.Dark }),
+    sections: z.array(sectionEntrySchema).optional().describe('Section order. Listed sections render in this order; omitted ones are hidden. Omit the key to show every section that has data.'),
+}).strict();

package/config/index.ts

@@ -0,0 +1,12 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+export * from './castSchema';
+export * from './CastConfig';
+export * from './CastConfigError';
+export * from './LiveStat';
+export * from './parseCast';
+export * from './ResolvedSection';
+export * from './resolveSections';
+export * from './SectionId';
+export * from './ThemeMode';

package/config/parseCast.ts

@@ -0,0 +1,58 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { parse as parseYaml } from 'yaml';
+import { castSchema } from './castSchema';
+import { CastConfigError } from './CastConfigError';
+import type { CastConfig } from './CastConfig';
+
+/**
+ * Validates an already-parsed cast.yaml document and applies defaults.
+ * Career events without `seq` get their position in the file; the stream is then ordered by `seq`.
+ */
+export function parseCastObject(document: unknown, source = 'cast.yaml'): CastConfig {
+    if (document && typeof document === 'object' && 'tier' in document) {
+        throw new CastConfigError(['tier: a site cannot declare its own tier. Core and Partner come from the reviewed Cast registry; Contributor is computed from merged pull requests.'], source);
+    }
+
+    const result = castSchema.safeParse(document ?? {});
+    if (!result.success) {
+        const problems = result.error.issues.map(issue => `${issue.path.join('.') || '(root)'}: ${issue.message}`);
+        throw new CastConfigError(problems, source);
+    }
+
+    const config = result.data;
+
+    // One identity: the GitHub login. person.handle is that login; github.login may repeat it, never differ.
+    if (config.github.login !== undefined && config.github.login.toLowerCase() !== config.person.handle.toLowerCase()) {
+        throw new CastConfigError([`github.login: '${config.github.login}' differs from person.handle '${config.person.handle}'. Both are your GitHub login, which is your Cast identity; use the same value or leave github.login out.`], source);
+    }
+    const events = config.career.events
+        .map((event, index) => ({ ...event, seq: event.seq ?? index + 1 }))
+        .sort((left, right) => left.seq - right.seq);
+
+    const sequences = new Set<number>();
+    for (const event of events) {
+        if (sequences.has(event.seq)) {
+            throw new CastConfigError([`career.events: seq ${event.seq} is used more than once`], source);
+        }
+        sequences.add(event.seq);
+    }
+
+    return {
+        ...config,
+        career: { events },
+        github: { ...config.github, login: config.github.login ?? config.person.handle },
+    };
+}
+
+/** Parses cast.yaml text. */
+export function parseCast(yamlText: string, source = 'cast.yaml'): CastConfig {
+    let document: unknown;
+    try {
+        document = parseYaml(yamlText);
+    } catch (error) {
+        throw new CastConfigError([`YAML: ${error instanceof Error ? error.message : String(error)}`], source);
+    }
+    return parseCastObject(document, source);
+}

package/config/resolveSections.ts

@@ -0,0 +1,48 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { CastConfig } from './CastConfig';
+import type { ResolvedSection } from './ResolvedSection';
+import { defaultSectionOrder, SectionId } from './SectionId';
+
+const hasData: Record<SectionId, (config: CastConfig) => boolean> = {
+    [SectionId.Hero]: () => true,
+    [SectionId.Now]: config => Object.keys(config.now).length > 0 || config.person.about.length > 0,
+    [SectionId.Stats]: config => config.stats.length > 0,
+    [SectionId.Career]: config => config.career.events.length > 0,
+    [SectionId.Model]: config => config.eventModel !== undefined,
+    [SectionId.Cratis]: config => config.cratis !== undefined,
+    [SectionId.Activity]: () => true,
+    [SectionId.Agentic]: config => config.agentic !== undefined,
+    [SectionId.Projects]: config => config.projects.length > 0,
+    [SectionId.Writing]: config => config.writing.sources.length > 0,
+    [SectionId.Talks]: config => config.talks.length > 0 || config.community.length > 0,
+    [SectionId.Skills]: config => Object.keys(config.skills).length > 0,
+    [SectionId.Contact]: config => config.person.email !== undefined || Object.keys(config.person.links).length > 0,
+};
+
+/**
+ * The sections the home page renders, in order, numbered from 01. The hero is never numbered.
+ * Sections listed in cast.yaml render even when they have no data yet (they show their empty state),
+ * except the ones that cannot render without data.
+ */
+export function resolveSections(config: CastConfig): ResolvedSection[] {
+    const requiresData = new Set([SectionId.Model, SectionId.Cratis, SectionId.Agentic]);
+    const entries = config.sections === undefined
+        ? defaultSectionOrder.filter(id => hasData[id](config)).map(id => ({ id }))
+        : config.sections
+            .map(entry => (typeof entry === 'string' ? { id: entry } : entry))
+            .filter(entry => !requiresData.has(entry.id) || hasData[entry.id](config));
+
+    const seen = new Set<SectionId>();
+    let counter = 0;
+    const sections: ResolvedSection[] = [];
+    for (const entry of entries) {
+        if (seen.has(entry.id)) continue;
+        seen.add(entry.id);
+        const numbered = entry.id !== SectionId.Hero && entry.id !== SectionId.Stats;
+        if (numbered) counter++;
+        sections.push({ ...entry, index: numbered ? String(counter).padStart(2, '0') : '' });
+    }
+    return sections;
+}

package/github/GitHubSnapshot.ts

@@ -0,0 +1,66 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/** A merged pull request in the live feed. */
+export type PullRequest = {
+    title: string;
+    /** owner/name */
+    repository: string;
+    number: number;
+    url: string;
+    mergedAt: string;
+};
+
+/** One week of the contribution calendar, starting on `start` (a Sunday). */
+export type ContributionWeek = { start: string; counts: number[] };
+
+/** A person's standing in one repository, among human committers only. */
+export type RepositoryStanding = { commits: number; rank: number; prs: number };
+
+/** A release of a tracked repository. */
+export type Release = { tag: string; publishedAt: string; url: string };
+
+/** Public GitHub profile fields. */
+export type GitHubProfile = {
+    login: string;
+    name?: string;
+    bio?: string;
+    location?: string;
+    blog?: string;
+    avatarUrl?: string;
+    followers?: number;
+    publicRepositories?: number;
+};
+
+/** Everything Cast captures from GitHub at build time. Only public data. */
+export type GitHubSnapshot = {
+    fetchedAt?: string;
+    login: string;
+    orgs: string[];
+    profile?: GitHubProfile;
+    contributions: { total: number; commits?: number; weeks: ContributionWeek[] };
+    mergedPullRequests: {
+        /** Across every configured organization. */
+        total: number;
+        /** Per organization, including Cratis even when it is not configured (it decides Contributor). */
+        byOrg: Record<string, number>;
+        latest: PullRequest[];
+    };
+    /** By owner/name. */
+    repositories: Record<string, RepositoryStanding>;
+    /** By owner/name. */
+    releases: Record<string, Release>;
+    /** By owner/name. */
+    stars: Record<string, number>;
+};
+
+/** A snapshot with nothing in it, for first builds without a token. */
+export const emptySnapshot = (login: string, orgs: string[]): GitHubSnapshot => ({
+    login,
+    orgs,
+    contributions: { total: 0, weeks: [] },
+    mergedPullRequests: { total: 0, byOrg: {}, latest: [] },
+    repositories: {},
+    releases: {},
+    stars: {},
+});