@cratis/cast 0.1.0 → 0.2.0

package/site/profile/assertRenderable.ts

@@ -0,0 +1,151 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { isCalendarDate, isCalendarMonth, isInstant, isPartialDate } from '../../config/calendar';
+import { accentTokens } from '../lib/accent';
+import { alsoText, apply, formatMonth, initialProjection, normalizeDate, yearsBetween } from '../lib/career';
+import { foldCalendar, formatDay, formatMonthLong } from '../lib/contributions';
+import { parseInline, plainText } from '../lib/inline';
+import { safeJson } from '../lib/safeJson';
+import { clientCast } from './clientCast';
+import type { CastView } from './CastView';
+
+const webProtocols = new Set(['http:', 'https:']);
+
+function fail(what: string, value: unknown): never {
+    throw new Error(`${what}: cannot render ${JSON.stringify(value)?.slice(0, 120)}`);
+}
+
+function url(what: string, value: string, base?: string, protocols: ReadonlySet<string> = webProtocols): void {
+    let parsed: URL;
+    try {
+        parsed = new URL(value, base);
+    } catch {
+        fail(what, value);
+    }
+    if (!protocols.has(parsed.protocol)) fail(what, value);
+}
+
+function count(what: string, value: number | undefined): void {
+    if (value !== undefined && !(Number.isSafeInteger(value) && value >= 0)) fail(what, value);
+}
+
+/** A date the components format: an unreadable one shows as 'Invalid Date', or as a month name that does not exist. */
+function shown(what: string, formatted: string, value: string): void {
+    if (formatted.includes('Invalid Date') || formatted.startsWith(' ')) fail(what, value);
+}
+
+function inline(what: string, text: string | undefined): void {
+    if (text === undefined) return;
+    if (typeof text !== 'string') fail(what, text);
+    parseInline(text);
+    plainText(text);
+}
+
+function links(cast: CastView): void {
+    const { config, person, github, posts } = cast;
+    for (const [key, value] of Object.entries(person.links)) url(`person.links.${key}`, value);
+    if (person.email) url('person.email', `mailto:${person.email}`, undefined, new Set(['mailto:']));
+    url('site.url', config.site.url);
+    if (config.site.source) url('site.source', config.site.source);
+    // Base resolves the portrait against the site; the directory resolves relative links in text against the member's site.
+    if (cast.photoUrl) url('photo', cast.photoUrl, config.site.url, new Set(['https:']));
+    if (cast.host.linkOrigin) url('linkOrigin', cast.host.linkOrigin);
+    for (const [key, value] of Object.entries(cast.cratis?.links ?? {})) url(`cratis.links.${key}`, value);
+    for (const repo of cast.cratisRepos) if (repo.url) url(`cratis.repos.${repo.name}`, repo.url);
+    for (const project of cast.liveProjects) url(`projects.${project.name}`, project.url);
+    for (const talk of cast.talks) if (talk.url) url(`talks.${talk.title}`, talk.url);
+    for (const certification of cast.certifications) if (certification.url) url(`certifications.${certification.title}`, certification.url);
+    for (const item of cast.agentic?.items ?? []) if (item.url) url(`agentic.items.${item.name}`, item.url);
+    if (cast.eventModel) url('eventModel.repo', cast.eventModel.repo);
+    for (const event of cast.careerEvents) if (event.orgUrl) url(`career.${event.title}.orgUrl`, event.orgUrl);
+    for (const pullRequest of github.mergedPullRequests.latest) url(`github.pullRequest.${pullRequest.number}`, pullRequest.url);
+    for (const [name, release] of Object.entries(github.releases)) url(`github.releases.${name}`, release.url);
+    if (github.profile?.avatarUrl) url('github.avatarUrl', github.profile.avatarUrl);
+    for (const source of cast.writing.sources) url('writing.sources', source);
+    for (const post of posts) url(`writing.posts.${post.title}`, post.url);
+}
+
+function texts(cast: CastView): void {
+    const { person, cratis, agentic, eventModel } = cast;
+    for (const [what, text] of [['tagline', person.tagline], ['intro', person.intro], ['cratis.pitch', cratis?.pitch], ['cratis.role', cratis?.role], ['agentic.pitch', agentic?.pitch], ['eventModel.intro', eventModel?.intro]] as const) inline(what, text);
+    person.about.forEach((text, index) => inline(`about.${index}`, text));
+    cast.careerEvents.forEach((event, index) => inline(`career.${index}.summary`, event.summary));
+    cast.projects.forEach((project, index) => inline(`projects.${index}.pitch`, project.pitch));
+    cast.talks.forEach((talk, index) => inline(`talks.${index}.summary`, talk.summary));
+    cast.cratisRepos.forEach((repo, index) => inline(`cratis.repos.${index}.desc`, repo.desc));
+    agentic?.workflow.forEach((step, index) => inline(`agentic.workflow.${index}`, step.text));
+    agentic?.items.forEach((item, index) => inline(`agentic.items.${index}`, item.text));
+    eventModel?.cards.forEach((card, index) => inline(`eventModel.cards.${index}`, card.note));
+    eventModel?.steps.forEach((step, index) => inline(`eventModel.steps.${index}`, step.text));
+    cast.sections.forEach((section, index) => {
+        inline(`sections.${index}.title`, section.title);
+        inline(`sections.${index}.intro`, section.intro);
+    });
+}
+
+/** The career replay and the CV fold every event in order: each position must reduce to dates they can show. */
+function career(cast: CastView): void {
+    let state = initialProjection;
+    for (const event of cast.careerEvents) {
+        if (!isCalendarMonth(event.date)) fail(`career.${event.title}.date`, event.date);
+        if (event.endDate !== undefined && !isCalendarMonth(event.endDate)) fail(`career.${event.title}.endDate`, event.endDate);
+        state = apply(state, event);
+        alsoText(state);
+        if (!isCalendarMonth(normalizeDate(event.date))) fail(`career.${event.title}.date`, event.date);
+    }
+    for (const role of state.roles) [role.from, role.to].forEach(date => date !== undefined && shown(`career.roles.${role.org}`, formatMonth(date), date));
+    if (!Number.isFinite(yearsBetween(state.shippingSince, state.clock))) fail('career.years', state.clock);
+}
+
+function calendar(cast: CastView): void {
+    const { github } = cast;
+    for (const week of github.contributions.weeks) {
+        if (!isCalendarDate(week.start)) fail('github.contributions.weeks.start', week.start);
+        week.counts.forEach(value => count('github.contributions.weeks.counts', value));
+    }
+    const folded = foldCalendar(github.contributions.weeks);
+    for (const day of [folded.first, folded.last, folded.busiest.date].filter(Boolean)) shown('github.contributions', formatDay(day), day);
+    for (const { month } of folded.months) shown('github.contributions.months', formatMonthLong(month), month);
+}
+
+function dates(cast: CastView): void {
+    const { github } = cast;
+    for (const [what, value] of [['github.fetchedAt', github.fetchedAt], ['writing.fetchedAt', cast.blogFetchedAt]] as const) {
+        if (value !== undefined && !isInstant(value)) fail(what, value);
+    }
+    shown('snapshotDate', cast.snapshotDate(), String(github.fetchedAt));
+    for (const pullRequest of github.mergedPullRequests.latest) if (!isInstant(pullRequest.mergedAt)) fail('github.pullRequest.mergedAt', pullRequest.mergedAt);
+    for (const release of Object.values(github.releases)) if (!isInstant(release.publishedAt)) fail('github.releases.publishedAt', release.publishedAt);
+    for (const post of cast.posts) if (!isInstant(post.date)) fail('writing.posts.date', post.date);
+    for (const entry of [...cast.talks, ...cast.community]) if (!isPartialDate(entry.date)) fail('talks.date', entry.date);
+    for (const value of Object.values(cast.now)) if (typeof value === 'string' && /^\d{4}-\d{2}$/.test(value)) shown('now', formatMonth(value), value);
+}
+
+function counts(cast: CastView): void {
+    const { github } = cast;
+    count('github.contributions.total', github.contributions.total);
+    count('github.contributions.commits', github.contributions.commits);
+    count('github.mergedPullRequests.total', github.mergedPullRequests.total);
+    for (const value of Object.values(github.mergedPullRequests.byOrg)) count('github.mergedPullRequests.byOrg', value);
+    for (const standing of Object.values(github.repositories)) for (const value of Object.values(standing)) count('github.repositories', value);
+    for (const value of Object.values(github.stars)) count('github.stars', value);
+    count('mergedPrTotal', cast.mergedPrTotal);
+    for (const stat of cast.stats) if (!Number.isFinite(stat.value)) fail(`stats.${stat.label}`, stat.value);
+}
+
+/**
+ * Computes what the profile components compute from a view (URLs, the contribution calendar, the career
+ * projection, dates, inline markup and the browser data), without rendering. Throws on the first value they
+ * could not render, so a builder can refuse that data before a page fails the whole build.
+ */
+export function assertRenderable(cast: CastView): void {
+    links(cast);
+    texts(cast);
+    career(cast);
+    calendar(cast);
+    dates(cast);
+    counts(cast);
+    accentTokens(cast.config.theme.accent);
+    safeJson(clientCast(cast));
+}

package/site/profile/clientCast.ts

@@ -0,0 +1,117 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { CareerEvent } from '../../config/CastConfig';
+import type { PullRequest } from '../../github/GitHubSnapshot';
+import type { WritingTheme } from '../lib/blog';
+import { anchorFor } from '../lib/sections';
+import type { CastView, ProfileLink } from './CastView';
+
+/**
+ * What the browser scripts (live feed, replay, palette, terminal) read about the profile on the page. The
+ * layout embeds it as a JSON island, so the same scripts serve every profile the directory renders.
+ */
+export type ClientCast = {
+    /** Path of the profile's home page, ending with '/'. */
+    base: string;
+    verificationUrl: string;
+    /** rel for links from the member's data. */
+    rel: string;
+    login: string;
+    orgs: string[];
+    feedOrg: string;
+    person: { name: string; handle: string; title: string; location?: string; tagline: string; email?: string };
+    firstName: string;
+    now: Record<string, string | string[]>;
+    careerEvents: CareerEvent[];
+    skills: Record<string, string[]>;
+    talks: { date: string; title: string; host: string; url?: string }[];
+    profileLinks: ProfileLink[];
+    cratis?: { pitch?: string; links: Record<string, string>; repos: { name: string; role: string; url?: string; desc: string }[] };
+    eventModelName?: string;
+    /** DOM ids of the sections that render, in page order. */
+    sections: string[];
+    projects: { name: string; url: string; pitch: string; version?: string; category: string; features: string[]; stack: string[]; install?: string }[];
+    pullRequests: PullRequest[];
+    mergedPrTotal: number;
+    snapshotDate: string;
+    posts: { headline: string; url: string; part?: number; minutes?: number; themes: string[] }[];
+    themes: WritingTheme[];
+    blogHost: string;
+};
+
+/** The client data for one profile view. */
+export function clientCast(cast: CastView): ClientCast {
+    const { person } = cast;
+    return {
+        base: cast.host.base,
+        verificationUrl: cast.verificationUrl,
+        rel: cast.host.rel,
+        login: cast.config.github.login,
+        orgs: cast.config.github.orgs,
+        feedOrg: cast.feedOrg,
+        person: {
+            name: person.name,
+            handle: person.handle,
+            title: person.title,
+            tagline: person.tagline,
+            ...(person.location ? { location: person.location } : {}),
+            ...(person.email ? { email: person.email } : {}),
+        },
+        firstName: cast.firstName,
+        now: cast.now,
+        careerEvents: cast.careerEvents,
+        skills: cast.skills,
+        talks: cast.talks.map(talk => ({ date: talk.date, title: talk.title, host: talk.host, ...(talk.url ? { url: talk.url } : {}) })),
+        profileLinks: cast.profileLinks,
+        ...(cast.cratis ? {
+            cratis: {
+                ...(cast.cratis.pitch ? { pitch: cast.cratis.pitch } : {}),
+                links: cast.cratis.links,
+                repos: cast.cratisRepos.map(repo => ({ name: repo.name, role: repo.role, desc: repo.desc, ...(repo.url ? { url: repo.url } : {}) })),
+            },
+        } : {}),
+        ...(cast.eventModel ? { eventModelName: cast.eventModel.name } : {}),
+        sections: cast.sections.map(section => anchorFor[section.id]),
+        projects: cast.liveProjects.map(project => ({
+            name: project.name,
+            url: project.url,
+            pitch: project.pitch,
+            category: project.category,
+            features: project.features,
+            stack: project.stack,
+            ...(project.version ? { version: project.version } : {}),
+            ...(project.install ? { install: project.install } : {}),
+        })),
+        pullRequests: cast.github.mergedPullRequests.latest,
+        mergedPrTotal: cast.mergedPrTotal,
+        snapshotDate: cast.snapshotDate(),
+        posts: cast.posts.map(post => ({
+            headline: post.headline,
+            url: post.url,
+            themes: post.themes,
+            ...(post.part !== undefined ? { part: post.part } : {}),
+            ...(post.minutes !== undefined ? { minutes: post.minutes } : {}),
+        })),
+        themes: cast.themes,
+        blogHost: cast.blogHost,
+    };
+}
+
+let cachedText: string | undefined;
+let cachedValue: ClientCast | undefined;
+
+/** Reads the client data of the page currently shown. Read again on every use: the router swaps pages. */
+export function readClientCast(): ClientCast | undefined {
+    const text = document.querySelector('script[data-cast-client]')?.textContent ?? undefined;
+    if (!text) return undefined;
+    if (text !== cachedText) {
+        try {
+            cachedValue = JSON.parse(text) as ClientCast;
+            cachedText = text;
+        } catch {
+            return undefined;
+        }
+    }
+    return cachedValue;
+}

package/site/profile/index.ts

@@ -0,0 +1,8 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+export * from './assertRenderable';
+export * from './CastHost';
+export * from './CastView';
+export * from './clientCast';
+export { parseInline, plainText, type InlineToken } from '../lib/inline';

package/site/scripts/live.ts

@@ -5,23 +5,28 @@
 import { onPageLoad } from '../lib/lifecycle';
 import { relativeTime } from '../lib/reltime';
 import type { PullRequest } from '../lib/github';
-import { config } from '../data';
+import { readClientCast } from '../profile/clientCast';
 
 type SearchItem = { repository_url?: string; pull_request?: { merged_at?: string }; title?: unknown; number?: unknown; html_url?: string };
 type SearchResponse = { total_count?: unknown; incomplete_results?: boolean; items?: unknown };
 type PublicEvent = { type?: string; repo?: { name?: string }; created_at?: string; payload?: { action?: string; ref_type?: string; pull_request?: { merged?: boolean } } };
 
-const login = encodeURIComponent(config.github.login);
-const orgs = config.github.orgs;
-const orgPattern = new RegExp(`^https://api\\.github\\.com/repos/(${orgs.map(org => org.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')).join('|')})/([^/]+)$`, 'i');
+const orgPatternFor = (orgs: string[]) =>
+    new RegExp(`^https://api\\.github\\.com/repos/(${orgs.map(org => org.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')).join('|')})/([^/]+)$`, 'i');
 
 const TTL = 5 * 60_000;
 type Merged = { total: number; latest: PullRequest[] };
 type Activity = { type: string; repo: string; at: string };
-let merged: { at: number; data: Merged } | undefined;
+// Per login: the directory renders many profiles on one origin.
+const merged = new Map<string, { at: number; data: Merged }>();
 const pending = new Map<string, Promise<unknown>>();
 
-export const getLiveMerged = (): Merged | undefined => merged && Date.now() - merged.at < TTL ? merged.data : undefined;
+/** The live merged pull requests of the profile on the page, while fresh. */
+export const getLiveMerged = (): Merged | undefined => {
+    const login = readClientCast()?.login.toLowerCase();
+    const entry = login ? merged.get(login) : undefined;
+    return entry && Date.now() - entry.at < TTL ? entry.data : undefined;
+};
 
 async function cached<T>(key: string, path: string, parse: (data: unknown) => T): Promise<T> {
     try {
@@ -42,7 +47,7 @@ async function cached<T>(key: string, path: string, parse: (data: unknown) => T)
     try { return await request; } finally { pending.delete(key); }
 }
 
-function parseMerged(raw: unknown): Merged {
+function parseMerged(raw: unknown, orgPattern: RegExp): Merged {
     const data = raw as SearchResponse | null;
     const total = data?.total_count;
     if (typeof total !== 'number' || !Number.isSafeInteger(total) || total < 0 || data?.incomplete_results || !Array.isArray(data?.items)) throw new Error('Invalid search');
@@ -105,18 +110,23 @@ function renderMerged(data: Merged): void {
 }
 
 onPageLoad(() => {
-    if (!document.querySelector('[data-hero]')) return;
+    const cast = readClientCast();
+    if (!document.querySelector('[data-hero]') || !cast) return;
+    const login = encodeURIComponent(cast.login);
+    const key = cast.login.toLowerCase();
+    const orgs = cast.orgs;
+    const orgPattern = orgPatternFor(orgs);
     let active = true;
     let idle: number | undefined;
     let timer: ReturnType<typeof setTimeout> | undefined;
     const refresh = () => {
         if (!active || document.visibilityState !== 'visible') return;
-        void cached('merged', `/search/issues?q=author:${login}+${orgs.map(org => `org:${encodeURIComponent(org)}`).join('+')}+is:public+is:pr+is:merged&sort=updated&order=desc&per_page=12`, parseMerged)
+        void cached(`${key}:merged`, `/search/issues?q=author:${login}+${orgs.map(org => `org:${encodeURIComponent(org)}`).join('+')}+is:public+is:pr+is:merged&sort=updated&order=desc&per_page=12`, (raw) => parseMerged(raw, orgPattern))
             .then((data) => {
-                merged = { at: Date.now(), data };
+                merged.set(key, { at: Date.now(), data });
                 if (active && document.visibilityState === 'visible') renderMerged(data);
             }).catch(() => { /* Quietly keep the build-time snapshot. */ });
-        void cached('events', `/users/${login}/events/public?per_page=30`, parseEvents)
+        void cached(`${key}:events`, `/users/${login}/events/public?per_page=30`, parseEvents)
             .then((events) => {
                 if (!active || document.visibilityState !== 'visible' || !events.length) return;
                 const event = events[0]!;

package/site/scripts/palette.ts

@@ -2,12 +2,11 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 // ⌘K command palette: fuzzy filtering, full keyboard navigation, focus return.
-import { person, sections, profileLinks, cratis, eventModel } from '../data';
-import { anchorFor } from '../lib/sections';
+import { readClientCast } from '../profile/clientCast';
 import { copyText } from '../lib/clipboard';
 import { motionReduced, toggleMotion } from '../lib/motion';
 import { currentTheme, toggleTheme } from '../lib/theme';
-import { go, goSection, openExternal, startReplay } from '../lib/nav';
+import { go, goSection, openExternal, profilePath, startReplay } from '../lib/nav';
 
 type Kind = 'command' | 'event' | 'view';
 type Item = {
@@ -53,11 +52,24 @@ export function fuzzyScore(query: string, text: string): number {
     return score;
 }
 
+type Controller = { show: () => void; hide: () => void; isOpen: () => boolean };
+
+// One controller per dialog: the dialog persists across pages of one profile and is replaced for another.
+const controllers = new WeakMap<HTMLDialogElement, Controller>();
+const current = (): Controller | undefined => {
+    const dialog = document.querySelector<HTMLDialogElement>('[data-palette]');
+    return dialog ? controllers.get(dialog) : undefined;
+};
+let documentBound = false;
+
+/** Mounts the palette of the page shown, once per dialog element. Safe to call on every page load. */
 export function mountPalette(): void {
     const dialog = document.querySelector<HTMLDialogElement>('[data-palette]');
     const input = dialog?.querySelector<HTMLInputElement>('[data-palette-input]');
     const list = dialog?.querySelector<HTMLUListElement>('[data-palette-list]');
-    if (!dialog || !input || !list) return;
+    const cast = readClientCast();
+    if (!dialog || !input || !list || !cast || controllers.has(dialog)) return;
+    const { person, sections, profileLinks, cratis } = cast;
 
     let toast: HTMLElement | null = null;
     const notify = (msg: string) => {
@@ -75,7 +87,7 @@ export function mountPalette(): void {
     const allItems: Item[] = [
         { id: 'about', group: 'Navigate', label: 'Now & about', keywords: 'read model projection photo', kind: 'view', run: () => goSection('about') },
         { id: 'career', group: 'Navigate', label: 'Career event stream', keywords: 'experience jobs timeline', kind: 'event', run: () => goSection('career') },
-        { id: 'model', group: 'Navigate', label: 'How I think: event model', keywords: `${eventModel?.name ?? ''} event modeling board slice`, kind: 'command', run: () => goSection('model') },
+        { id: 'model', group: 'Navigate', label: 'How I think: event model', keywords: `${cast.eventModelName ?? ''} event modeling board slice`, kind: 'command', run: () => goSection('model') },
         { id: 'cratis', group: 'Navigate', label: 'Cratis', keywords: 'open source chronicle arc', kind: 'command', run: () => goSection('cratis') },
         { id: 'activity', group: 'Navigate', label: 'Contribution event store', keywords: 'github heatmap activity calendar', kind: 'event', run: () => goSection('activity') },
         { id: 'agentic', group: 'Navigate', label: 'Agentic engineering', keywords: 'ai agents harness pi review workflow', kind: 'view', run: () => goSection('agentic') },
@@ -95,12 +107,12 @@ export function mountPalette(): void {
             hint: () => '`',
             run: () => void document.dispatchEvent(new CustomEvent('terminal:open')),
         },
-        { id: 'cv', group: 'Actions', label: 'Open CV', keywords: 'resume curriculum vitae', kind: 'view', run: () => go('/cv') },
+        { id: 'cv', group: 'Actions', label: 'Open CV', keywords: 'resume curriculum vitae', kind: 'view', run: () => go(profilePath('cv')) },
         {
             id: 'print', group: 'Actions', label: 'Print CV / save as PDF', keywords: 'resume pdf download', kind: 'view',
             run: () => {
-                if (location.pathname.startsWith('/cv')) window.print();
-                else void go('/cv?print');
+                if (location.pathname.startsWith(profilePath('cv'))) window.print();
+                else void go(profilePath('cv?print'));
             },
         },
         ...(person.email ? [<Item>{
@@ -126,9 +138,9 @@ export function mountPalette(): void {
         ...Object.entries(cratis?.links ?? {}).map(([label, url]): Item => ({
             id: `cratis-${label}`, group: 'Links' as const, label, keywords: 'cratis website docs repositories', kind: 'event', run: () => open(url),
         })),
-        { id: 'cast', group: 'Links' as const, label: 'Cast verification', keywords: 'badge cratis cast tier verified', kind: 'view', run: () => open(`https://cast.cratis.io/${person.handle.toLowerCase()}`) },
+        { id: 'cast', group: 'Links' as const, label: 'Cast verification', keywords: 'badge cratis cast tier verified', kind: 'view', run: () => open(cast.verificationUrl) },
     ];
-    const items = allItems.filter((item) => item.group !== 'Navigate' || item.id === 'top' || sections.some((section) => anchorFor[section.id] === item.id));
+    const items = allItems.filter((item) => item.group !== 'Navigate' || item.id === 'top' || sections.includes(item.id));
 
     let results: Item[] = items;
     let active = 0;
@@ -283,14 +295,19 @@ export function mountPalette(): void {
     });
     dialog.querySelector('[data-palette-close]')?.addEventListener('click', hide);
 
+    controllers.set(dialog, { show, hide, isOpen: () => dialog.open });
+    if (documentBound) return;
+    documentBound = true;
     document.addEventListener('click', (e) => {
-        if ((e.target as Element).closest('[data-palette-open]')) show();
+        if ((e.target as Element).closest('[data-palette-open]')) current()?.show();
     });
     document.addEventListener('keydown', (e) => {
         if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === 'k') {
+            const palette = current();
+            if (!palette) return;
             e.preventDefault();
-            if (dialog.open) hide();
-            else show();
+            if (palette.isOpen()) palette.hide();
+            else palette.show();
         }
     });
 }

package/site/scripts/replay.ts

@@ -2,7 +2,7 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 // Career replay: renders the projection produced by folding career events up to a position.
-import { careerEvents } from '../data';
+import { readClientCast } from '../profile/clientCast';
 import { project, formatMonth, yearsBetween, alsoText, type CareerProjection } from '../lib/career';
 import { motionReduced } from '../lib/motion';
 
@@ -11,6 +11,7 @@ const pad = (n: number) => String(n).padStart(2, '0');
 
 export function mountReplay(root: HTMLElement): () => void {
     const cleanups: (() => void)[] = [];
+    const careerEvents = readClientCast()?.careerEvents ?? [];
     const total = careerEvents.length;
     const q = <T extends Element = HTMLElement>(sel: string) => root.querySelector<T>(sel);
     const qa = <T extends Element = HTMLElement>(sel: string) => [...root.querySelectorAll<T>(sel)];

package/site/scripts/terminal.ts

@@ -3,16 +3,12 @@
 
 // <handle>@stream:~$ — an interactive terminal over the same data the page renders.
 // Lazy-loaded by Terminal.astro on first open.
-import { person, now, careerEvents, skills, cratis, talks, profileLinks, firstName, feedOrg, sections } from '../data';
-import { anchorFor } from '../lib/sections';
-import { blogHost } from '../lib/blog';
-import { github, cratisRepos, liveProjects as projects, mergedPrTotal, snapshotDate } from '../lib/github';
+import { readClientCast, type ClientCast } from '../profile/clientCast';
 import { getLiveMerged } from './live';
 import { relativeTime } from '../lib/reltime';
-import { posts as blogPosts, themes as blogThemes } from '../lib/blog';
 import { copyText } from '../lib/clipboard';
 import { formatMonth } from '../lib/career';
-import { go, goSection, openExternal, startReplay } from '../lib/nav';
+import { go, goSection, openExternal, profilePath, startReplay } from '../lib/nav';
 import { currentTheme, setTheme } from '../lib/theme';
 
 type Part = string | Node;
@@ -38,13 +34,6 @@ const ALL_SECTIONS = [
     ['skills', 'toolbox'],
     ['contact', 'contact'],
 ] as const;
-const SECTIONS = ALL_SECTIONS.filter(([id]) => id === 'top' || sections.some((section) => anchorFor[section.id] === id));
-const LINKS: Record<string, string> = {
-    ...Object.fromEntries(profileLinks.map((link) => [link.key.toLowerCase(), link.url])),
-    ...(cratis ? { cratis: Object.values(cratis.links)[0] ?? 'https://cratis.io' } : {}),
-};
-const prompt = `${person.handle}@stream`;
-const brewable = projects.filter((p) => p.install?.startsWith('brew'));
 
 // --- tiny DOM helpers --------------------------------------------------------------
 const span = (cls: string, text: string): HTMLSpanElement => {
@@ -61,12 +50,13 @@ const c = {
     faint: (t: string) => span('text-fg-faint', t),
     fg: (t: string) => span('text-fg', t),
 };
+let linkRel = 'noopener';
 const link = (href: string, text = href.replace(/^https?:\/\/(www\.)?/, '')): HTMLAnchorElement => {
     const a = document.createElement('a');
-    a.href = href;
+    a.href = /^(https?:|mailto:)/i.test(href) ? href : '#';
     a.textContent = text;
     a.target = '_blank';
-    a.rel = 'noopener';
+    a.rel = linkRel;
     a.className = 'text-command-soft';
     return a;
 };
@@ -94,12 +84,15 @@ class Terminal {
     private returnFocus: HTMLElement | null = null;
     private greeted = false;
     private readonly commands: Record<string, Command>;
+    private readonly prompt: string;
 
     constructor(
+        private readonly cast: ClientCast,
         private readonly dialog: HTMLDialogElement,
         private readonly out: HTMLElement,
         private readonly input: HTMLInputElement,
     ) {
+        this.prompt = `${cast.person.handle}@stream`;
         try {
             this.history = JSON.parse(sessionStorage.getItem('cast:term-history') ?? '[]') as string[];
         } catch {
@@ -122,7 +115,7 @@ class Terminal {
         this.print(' ');
     }
     private echo(raw: string): void {
-        this.print(c.view(prompt), c.faint(':'), c.cmd('~'), c.faint('$ '), c.fg(raw));
+        this.print(c.view(this.prompt), c.faint(':'), c.cmd('~'), c.faint('$ '), c.fg(raw));
     }
     clear(): void {
         this.out.replaceChildren();
@@ -130,14 +123,16 @@ class Terminal {
 
     private greet(): void {
         this.greeted = true;
-        this.print(c.ev(prompt), c.faint(` · stream position ${careerEvents.length} · ${(getLiveMerged()?.total ?? mergedPrTotal).toLocaleString('en-US')} PRs merged in ${feedOrg}`));
-        this.print(c.faint(`GitHub snapshot taken ${snapshotDate()}. Everything here is real data.`));
+        const { careerEvents, mergedPrTotal, feedOrg, snapshotDate } = this.cast;
+        this.print(c.ev(this.prompt), c.faint(` · stream position ${careerEvents.length} · ${(getLiveMerged()?.total ?? mergedPrTotal).toLocaleString('en-US')} PRs merged in ${feedOrg}`));
+        this.print(c.faint(`GitHub snapshot taken ${snapshotDate}. Everything here is real data.`));
         this.print('Type ', c.fg('help'), ' to see what you can do, or tap a suggestion below.');
         this.blank();
     }
 
     // --- lifecycle ----------------------------------------------------------------
     open(): void {
+        linkRel = this.cast.rel;
         if (this.dialog.open) return;
         this.returnFocus = document.activeElement instanceof HTMLElement ? document.activeElement : null;
         if (!this.greeted) this.greet();
@@ -289,6 +284,13 @@ class Terminal {
 
     // --- commands -------------------------------------------------------------------
     private buildCommands(): Record<string, Command> {
+        const { person, now, careerEvents, skills, cratis, talks, profileLinks, firstName, feedOrg, projects, mergedPrTotal, snapshotDate, themes: blogThemes, posts: blogPosts, blogHost } = this.cast;
+        const SECTIONS = ALL_SECTIONS.filter(([id]) => id === 'top' || this.cast.sections.includes(id));
+        const LINKS: Record<string, string> = {
+            ...Object.fromEntries(profileLinks.map((profile) => [profile.key.toLowerCase(), profile.url])),
+            ...(cratis ? { cratis: Object.values(cratis.links)[0] ?? 'https://cratis.io' } : {}),
+        };
+        const brewable = projects.filter((p) => p.install?.startsWith('brew'));
         const findProject = (q = '') => projects.find((p) => p.name.toLowerCase() === q.toLowerCase());
         const projectNames = () => projects.map((p) => p.name);
 
@@ -346,7 +348,7 @@ class Terminal {
                 run: ([to]) => {
                     const id = (to ?? '').replace(/\/$/, '');
                     if (!id || id === '~' || id === '/') return this.navigateSection('top');
-                    if (id === 'cv') return this.navigate('/cv');
+                    if (id === 'cv') return this.navigate(profilePath('cv'));
                     if (!SECTIONS.some(([s]) => s === id)) return this.print(c.ev('cd: '), `no such section: ${id}`);
                     this.navigateSection(id);
                 },
@@ -400,9 +402,9 @@ class Terminal {
                 run: ([sub, flag, n]) => {
                     if (sub !== 'tail') return this.print(c.ev('stream: '), 'try ', c.fg('stream tail'));
                     const live = getLiveMerged();
-                    const prs = live?.latest ?? github.mergedPullRequests.latest;
+                    const prs = live?.latest ?? this.cast.pullRequests;
                     const count = flag === '-n' ? Math.max(1, Math.min(prs.length, Number(n) || prs.length)) : prs.length;
-                    this.print(c.faint(`tail ${feedOrg} · ${live ? 'live' : `snapshot taken ${snapshotDate()}`} · ${(live?.total ?? mergedPrTotal).toLocaleString('en-US')} merged in total`));
+                    this.print(c.faint(`tail ${feedOrg} · ${live ? 'live' : `snapshot taken ${snapshotDate}`} · ${(live?.total ?? mergedPrTotal).toLocaleString('en-US')} merged in total`));
                     prs.slice(0, count).forEach((pr, i) => {
                         this.print(
                             c.faint(pad(i === 0 ? 'HEAD' : `HEAD~${i}`, 8)),
@@ -424,7 +426,7 @@ class Terminal {
             },
             cv: {
                 desc: 'open the printable CV',
-                run: () => this.navigate('/cv'),
+                run: () => this.navigate(profilePath('cv')),
             },
             skills: {
                 desc: 'the toolbox, grouped',
@@ -509,7 +511,7 @@ class Terminal {
                     if (!cratis) return this.print(c.faint('Cratis makes event sourcing practical. '), link('https://cratis.io'));
                     if (cratis.pitch) this.print(c.fg(cratis.pitch.replace(/\*/g, '')));
                     this.print(c.faint(`${(getLiveMerged()?.total ?? mergedPrTotal).toLocaleString('en-US')} merged PRs · `), link(LINKS['cratis'] ?? 'https://cratis.io'));
-                    for (const r of cratisRepos) this.print(c.cmd(pad(r.name, 21)), c.faint(pad(r.role, 16)), r.url ? link(r.url, r.desc) : r.desc);
+                    for (const r of cratis.repos) this.print(c.cmd(pad(r.name, 21)), c.faint(pad(r.role, 16)), r.url ? link(r.url, r.desc) : r.desc);
                 },
             },
             clear: { desc: 'clear the screen (Ctrl+L)', run: () => this.clear() },
@@ -546,10 +548,11 @@ export function openTerminal(): void {
     const dialog = document.querySelector<HTMLDialogElement>('[data-terminal]');
     const out = dialog?.querySelector<HTMLElement>('[data-terminal-out]');
     const input = dialog?.querySelector<HTMLInputElement>('[data-terminal-input]');
-    if (!dialog || !out || !input) return;
+    const cast = readClientCast();
+    if (!dialog || !out || !input || !cast) return;
     let term = instances.get(dialog);
     if (!term) {
-        term = new Terminal(dialog, out, input);
+        term = new Terminal(cast, dialog, out, input);
         instances.set(dialog, term);
     }
     term.open();