@cratis/cast 0.1.0 → 0.2.1

package/site/scripts/terminal.ts

@@ -3,16 +3,13 @@
 
 // <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 { plainText } from '../lib/inline';
+import { go, goSection, openExternal, profilePath, startReplay } from '../lib/nav';
 import { currentTheme, setTheme } from '../lib/theme';
 
 type Part = string | Node;
@@ -38,13 +35,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 +51,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 +85,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 +116,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 +124,23 @@ 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, feedOrg, snapshotDate } = this.cast;
+        this.print(c.ev(this.prompt), c.faint(` · stream position ${careerEvents.length} · ${this.mergedTotal()} 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();
     }
 
+    /** The merged pull request total: live once the browser has it, else the snapshot, marked when self-reported. */
+    private mergedTotal(): string {
+        const live = getLiveMerged();
+        const total = (live?.total ?? this.cast.mergedPrTotal).toLocaleString('en-US');
+        return !live && this.cast.mergedPrSelfReported ? `${total} (self-reported)` : total;
+    }
+
     // --- 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 +292,13 @@ class Terminal {
 
     // --- commands -------------------------------------------------------------------
     private buildCommands(): Record<string, Command> {
+        const { person, now, careerEvents, skills, cratis, talks, profileLinks, firstName, feedOrg, projects, 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);
 
@@ -309,7 +319,7 @@ class Terminal {
                 run: () => {
                     this.print(c.fg(person.name), c.faint(` (${person.handle})`));
                     this.print(person.title, ...(person.location ? [c.faint(' · '), person.location] : []));
-                    this.print(c.ev(person.tagline.replace(/\*/g, '')));
+                    this.print(c.ev(plainText(person.tagline)));
                 },
             },
             now: {
@@ -318,7 +328,7 @@ class Terminal {
                     this.print(c.faint('Projection: '), c.view(`${firstName}.Now`), c.faint(` · projected from ${careerEvents.length} events`));
                     const rows: [string, string][] = Object.entries(now).map(([key, value]) => [
                         key,
-                        Array.isArray(value) ? value.join(', ') : /^\d{4}-\d{2}$/.test(value) ? formatMonth(value) : value.replace(/\*/g, ''),
+                        Array.isArray(value) ? value.join(', ') : /^\d{4}-\d{2}$/.test(value) ? formatMonth(value) : plainText(value),
                     ]);
                     for (const [k, v] of rows) this.print(c.faint(pad(k, 12)), c.fg(v));
                 },
@@ -346,7 +356,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 +410,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}`} · ${this.mergedTotal()} merged in total`));
                     prs.slice(0, count).forEach((pr, i) => {
                         this.print(
                             c.faint(pad(i === 0 ? 'HEAD' : `HEAD~${i}`, 8)),
@@ -424,7 +434,7 @@ class Terminal {
             },
             cv: {
                 desc: 'open the printable CV',
-                run: () => this.navigate('/cv'),
+                run: () => this.navigate(profilePath('cv')),
             },
             skills: {
                 desc: 'the toolbox, grouped',
@@ -507,9 +517,9 @@ class Terminal {
                 desc: 'what Cratis is',
                 run: () => {
                     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);
+                    if (cratis.pitch) this.print(c.fg(plainText(cratis.pitch)));
+                    this.print(c.faint(`${this.mergedTotal()} merged PRs · `), link(LINKS['cratis'] ?? 'https://cratis.io'));
+                    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 +556,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();

package/writing/fetchWriting.ts

@@ -5,6 +5,7 @@ import type { z } from 'zod';
 import type { writingSourceSchema } from '../config/castSchema';
 import { mergePosts, parseFeed, parseStarlightAuthorPage } from './parse';
 import type { Post, WritingSnapshot } from './WritingSnapshot';
+import { postSchema, writingLimits } from './writingSnapshotSchema';
 
 type WritingSource = z.output<typeof writingSourceSchema>;
 const maximumPages = 10;
@@ -49,6 +50,20 @@ export async function fetchWriting(sources: readonly WritingSource[], warn: (mes
             warn(`writing source ${'rss' in source ? source.rss : source.starlightBlogAuthor}: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
-    if (posts.length === 0) return undefined;
-    return { fetchedAt: new Date().toISOString(), sources: origins, posts: mergePosts(posts) };
+    const kept = withinLimits(posts);
+    if (kept.length === 0) return undefined;
+    return { fetchedAt: new Date().toISOString(), sources: origins.slice(0, writingLimits.sources), posts: kept };
+}
+
+/** Newest posts first, trimmed to the limits a reader of cast.json enforces; posts that would still fail them are left out. */
+export function withinLimits(posts: readonly Post[]): Post[] {
+    return mergePosts(posts)
+        .map(post => ({
+            ...post,
+            title: post.title.slice(0, writingLimits.title),
+            description: post.description.slice(0, writingLimits.description),
+            tags: post.tags.map(tag => tag.slice(0, writingLimits.tag)).slice(0, writingLimits.tags),
+        }))
+        .filter(post => postSchema.safeParse(post).success)
+        .slice(0, writingLimits.posts);
 }

package/writing/writingSnapshotSchema.ts

@@ -0,0 +1,27 @@
+// 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 { isInstant } from '../config/calendar';
+
+const instant = z.string().max(64).refine(isInstant, 'Use an ISO 8601 date and time on a real day');
+
+/** The most a writing capture holds; the build that writes one keeps to the same limits. */
+export const writingLimits = { sources: 20, posts: 300, title: 300, description: 2000, tags: 30, tag: 100 } as const;
+
+/** One captured post. */
+export const postSchema = z.object({
+    title: z.string().min(1).max(writingLimits.title),
+    url: z.url({ protocol: /^https?$/ }),
+    date: z.string().max(64).regex(/^\d{4}-\d{2}-\d{2}/, 'Start with YYYY-MM-DD').refine(isInstant, 'Use an ISO 8601 date on a real day'),
+    minutes: z.number().min(0).max(10_000).optional(),
+    description: z.string().max(writingLimits.description).default(''),
+    tags: z.array(z.string().max(writingLimits.tag)).max(writingLimits.tags).default([]),
+});
+
+/** Writing captured from feeds, as it appears in cast.json. */
+export const writingSnapshotSchema = z.object({
+    fetchedAt: instant.optional(),
+    sources: z.array(z.url({ protocol: /^https?$/ })).max(writingLimits.sources).default([]),
+    posts: z.array(postSchema).max(writingLimits.posts).default([]),
+});