From 9aa114eb3cf96b1739c143f9bdbe3f7261d391d2 Mon Sep 17 00:00:00 2001
From: Jacob Zweifel <jacob@jacobzweifel.com>
Date: Thu, 27 Aug 2026 15:33:03 -0400
Subject: [PATCH 1/2] Tell the reader when a section stops short
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Posts and writing rendered a fixed head of their collections and simply
stopped: a reader with 342 posts saw five, with nothing on the page saying
so and nowhere to go for the rest. The career log is untouched — a résumé
that hides entries reads as concealment, not curation.

A trimmed list now closes with one line in the theme's system voice: how
much is here, and where the whole of it lives. The count is free — both
adapters already page the entire collection before slicing — so they now
report it alongside the trimmed list. The line only appears when there is
somewhere to send the reader: a count with no destination is a tease.
Posts always have one (the owner's Bluesky profile, by DID). Writing has
one when every listed document belongs to a single publication that
publishes an address; documents spread across publications, or legacy
records that name none, get no line. Resolving that publication costs a
read, so it is only attempted once a listing is known to be short.

The default post count moves 5 → 8, which an honest cue makes affordable;
per-section `limit` in the site record still overrides it.

7 new tests (224 in web).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 .../lib/components/theme/SiteSections.svelte  | 36 +++++++-
 .../lib/server/atmosphere/atmosphere.test.ts  | 81 ++++++++++++++++--
 apps/web/src/lib/server/atmosphere/bluesky.ts | 13 ++-
 apps/web/src/lib/server/atmosphere/index.ts   |  4 +-
 .../lib/server/atmosphere/standard-site.ts    | 46 ++++++++--
 apps/web/src/lib/server/render/render.test.ts | 83 ++++++++++++++++++-
 apps/web/src/lib/server/render/site.ts        | 45 +++++++---
 apps/web/src/lib/site-view.ts                 | 17 +++-
 apps/web/src/routes/admin/+page.server.ts     | 10 +--
 9 files changed, 296 insertions(+), 39 deletions(-)

diff --git a/apps/web/src/lib/components/theme/SiteSections.svelte b/apps/web/src/lib/components/theme/SiteSections.svelte
index c01a9fe..b3fd7aa 100644
--- a/apps/web/src/lib/components/theme/SiteSections.svelte
+++ b/apps/web/src/lib/components/theme/SiteSections.svelte
@@ -1,5 +1,5 @@
 <script lang="ts">
-	import type { PostEmbed, RenderedSection, SiteView } from '$lib/site-view';
+	import type { MoreLink, PostEmbed, RenderedSection, SiteView } from '$lib/site-view';
 	import { blobProxyPath } from '$lib/blob-proxy';
 	import { formatDate, yearSpan } from '$lib/date-format';
 	import { linkify } from '$lib/linkify';
@@ -99,6 +99,12 @@
 	{/if}
 {/snippet}
 
+{#snippet moreLine(shown: number, more: MoreLink)}
+	<a class="more-line" href={more.url} target="_blank" rel="noopener noreferrer"
+		>{shown} of {more.total} · the rest on {more.label} ↗</a
+	>
+{/snippet}
+
 {#snippet nameBlock(section: Extract<RenderedSection, { kind: 'hero' }>)}
 	<div class="name-row">
 		<h1>{section.title ?? site.name}</h1>
@@ -222,6 +228,9 @@
 							</li>
 						{/each}
 					</ul>
+					{#if section.more}
+						{@render moreLine(section.documents.length, section.more)}
+					{/if}
 				{:else if section.kind === 'career'}
 					{@const dated = careerHasDates(section)}
 					{#if site.sifaProfile?.summary}
@@ -328,6 +337,9 @@
 							</li>
 						{/each}
 					</ul>
+					{#if section.more}
+						{@render moreLine(section.posts.length, section.more)}
+					{/if}
 				{:else if section.kind === 'pages'}
 					<ul class="log">
 						{#each section.pages as page (page.rkey)}
@@ -894,6 +906,28 @@
 		color: var(--muted);
 	}
 
+	/* ——— trimmed lists ——— */
+
+	/* Closes a list that stops short: how much of it is here, and where the
+	   rest of it lives. */
+	.more-line {
+		display: block;
+		margin-top: 0.9rem;
+		padding: 0.75rem 0 0.25rem;
+		border-top: 1px dotted var(--rule);
+		font-family: var(--font-mono);
+		font-size: 0.72rem;
+		letter-spacing: 0.04em;
+		font-variant-numeric: tabular-nums;
+		color: var(--accent);
+		text-decoration: none;
+	}
+
+	.more-line:hover,
+	.more-line:focus-visible {
+		text-decoration: underline;
+	}
+
 	/* ——— posts ——— */
 
 	.notes {
diff --git a/apps/web/src/lib/server/atmosphere/atmosphere.test.ts b/apps/web/src/lib/server/atmosphere/atmosphere.test.ts
index c72dc46..ecf9970 100644
--- a/apps/web/src/lib/server/atmosphere/atmosphere.test.ts
+++ b/apps/web/src/lib/server/atmosphere/atmosphere.test.ts
@@ -111,11 +111,28 @@ describe('bluesky adapter', () => {
 				]
 			}
 		});
-		const posts = await fetchBlueskyPosts(ctx, { limit: 2 });
+		const { posts } = await fetchBlueskyPosts(ctx, { limit: 2 });
 		expect(posts.map((p) => p.text)).toEqual(['new', 'old']);
 		expect(posts[0].hasEmbed).toBe(true);
 	});
 
+	it('counts every post it could have shown, replies excluded', async () => {
+		const ctx = fakeCtx({
+			collections: {
+				'app.bsky.feed.post': [
+					...Array.from({ length: 12 }, (_, i) => ({
+						text: `post ${i}`,
+						createdAt: `2026-01-${String(i + 1).padStart(2, '0')}T00:00:00Z`
+					})),
+					{ text: 'a reply', createdAt: '2026-03-01T00:00:00Z', reply: { parent: {} } }
+				]
+			}
+		});
+		const { posts, total } = await fetchBlueskyPosts(ctx, { limit: 5 });
+		expect(posts).toHaveLength(5);
+		expect(total).toBe(12);
+	});
+
 	it('reads the profile and serves the avatar and banner from the PDS', async () => {
 		const ctx = fakeCtx({
 			records: {
@@ -140,7 +157,7 @@ describe('bluesky adapter', () => {
 		const ctx = fakeCtx({
 			collections: { 'app.bsky.feed.post': [{ text: 'hi', createdAt: '2026-01-01T00:00:00Z' }] }
 		});
-		const posts = await fetchBlueskyPosts(ctx);
+		const { posts } = await fetchBlueskyPosts(ctx);
 		expect(posts[0].url).toBe('https://bsky.app/profile/did:plc:test123/post/rkey0');
 	});
 });
@@ -275,7 +292,7 @@ function quotingCtx(options?: { pdsFails?: boolean }): AtmosphereContext {
 
 describe('quote hydration', () => {
 	it('fills in the quoted post from its own author’s PDS', async () => {
-		const [post] = await fetchBlueskyPosts(quotingCtx());
+		const [post] = (await fetchBlueskyPosts(quotingCtx())).posts;
 		expect(post.embeds[0]).toEqual({
 			kind: 'quote',
 			quoted: {
@@ -289,7 +306,7 @@ describe('quote hydration', () => {
 	});
 
 	it('keeps the link alone when the quoted post cannot be read', async () => {
-		const [post] = await fetchBlueskyPosts(quotingCtx({ pdsFails: true }));
+		const [post] = (await fetchBlueskyPosts(quotingCtx({ pdsFails: true }))).posts;
 		expect(post.embeds[0]).toEqual({
 			kind: 'quote',
 			quoted: {
@@ -315,7 +332,7 @@ describe('quote hydration', () => {
 				]
 			}
 		});
-		const [post] = await fetchBlueskyPosts(ctx);
+		const [post] = (await fetchBlueskyPosts(ctx)).posts;
 		// Nothing to show and nowhere to point: the Bluesky cue takes over.
 		expect(post.embeds).toEqual([]);
 		expect(post.hasEmbed).toBe(true);
@@ -415,7 +432,7 @@ describe('standard.site adapter', () => {
 				'pub.leaflet.document': [{ title: 'Legacy', publishedAt: '2026-03-01T00:00:00Z' }]
 			}
 		});
-		const docs = await fetchDocuments(ctx);
+		const { documents: docs } = await fetchDocuments(ctx);
 		expect(docs.map((d) => d.title)).toEqual(['Second', 'First']);
 		expect(docs.every((d) => !d.legacy)).toBe(true);
 	});
@@ -426,7 +443,7 @@ describe('standard.site adapter', () => {
 				'pub.leaflet.document': [{ title: 'Legacy', createdAt: '2026-03-01T00:00:00Z' }]
 			}
 		});
-		const docs = await fetchDocuments(ctx);
+		const { documents: docs } = await fetchDocuments(ctx);
 		expect(docs).toHaveLength(1);
 		expect(docs[0]).toMatchObject({ title: 'Legacy', legacy: true, publishedAt: '2026-03-01T00:00:00Z' });
 	});
@@ -442,7 +459,7 @@ describe('standard.site adapter', () => {
 				'site.standard.publication': [{ name: 'Blog', url: 'https://blog.example/' }]
 			}
 		});
-		const docs = await fetchDocuments(ctx);
+		const { documents: docs } = await fetchDocuments(ctx);
 		const byTitle = new Map(docs.map((d) => [d.title, d]));
 		expect(byTitle.get('Joined')?.url).toBe('https://blog.example/joined');
 		expect(byTitle.get('Joined')?.description).toBe('A short excerpt.');
@@ -450,6 +467,52 @@ describe('standard.site adapter', () => {
 		expect(byTitle.get('No publication')?.url).toBeUndefined();
 	});
 
+	it('names the one publication a trimmed listing came from', async () => {
+		const ctx = fakeCtx({
+			collections: {
+				'site.standard.document': Array.from({ length: 4 }, (_, i) => ({
+					title: `Doc ${i}`,
+					site: 'at://did:plc:test123/site.standard.publication/rkey0'
+				})),
+				'site.standard.publication': [{ name: 'Blog', url: 'https://blog.example/' }]
+			}
+		});
+		const listing = await fetchDocuments(ctx, { limit: 2 });
+		expect(listing.documents).toHaveLength(2);
+		expect(listing.total).toBe(4);
+		expect(listing.publication).toMatchObject({ name: 'Blog', url: 'https://blog.example/' });
+	});
+
+	it('names no publication when the listing spans two, or fits whole', async () => {
+		const collections = {
+			'site.standard.document': [
+				{ title: 'A', site: 'at://did:plc:test123/site.standard.publication/rkey0' },
+				{ title: 'B', site: 'at://did:plc:test123/site.standard.publication/rkey1' },
+				{ title: 'C', site: 'at://did:plc:test123/site.standard.publication/rkey0' }
+			],
+			'site.standard.publication': [
+				{ name: 'Blog', url: 'https://blog.example/' },
+				{ name: 'Zine', url: 'https://zine.example/' }
+			]
+		};
+		expect((await fetchDocuments(fakeCtx({ collections }), { limit: 2 })).publication).toBeUndefined();
+		const whole = await fetchDocuments(fakeCtx({ collections }), { limit: 10 });
+		expect(whole.total).toBe(3);
+		expect(whole.publication).toBeUndefined();
+	});
+
+	it('names no publication for legacy records, which carry none', async () => {
+		const ctx = fakeCtx({
+			collections: {
+				'pub.leaflet.document': [{ title: 'One' }, { title: 'Two' }],
+				'site.standard.publication': [{ name: 'Blog', url: 'https://blog.example/' }]
+			}
+		});
+		const listing = await fetchDocuments(ctx, { limit: 1 });
+		expect(listing.total).toBe(2);
+		expect(listing.publication).toBeUndefined();
+	});
+
 	it('filters by publication when asked', async () => {
 		const ctx = fakeCtx({
 			collections: {
@@ -459,7 +522,7 @@ describe('standard.site adapter', () => {
 				]
 			}
 		});
-		const docs = await fetchDocuments(ctx, { publicationUri: 'at://pub/2' });
+		const { documents: docs } = await fetchDocuments(ctx, { publicationUri: 'at://pub/2' });
 		expect(docs.map((d) => d.title)).toEqual(['B']);
 	});
 });
diff --git a/apps/web/src/lib/server/atmosphere/bluesky.ts b/apps/web/src/lib/server/atmosphere/bluesky.ts
index 232c938..66b6696 100644
--- a/apps/web/src/lib/server/atmosphere/bluesky.ts
+++ b/apps/web/src/lib/server/atmosphere/bluesky.ts
@@ -37,6 +37,12 @@ export interface BlueskyPost {
 	embeds: PostEmbed[];
 }
 
+export interface BlueskyFeed {
+	posts: BlueskyPost[];
+	/** Posts in the repo, the trimmed ones included. Replies are not counted. */
+	total: number;
+}
+
 interface FacetLink {
 	byteStart: number;
 	byteEnd: number;
@@ -233,12 +239,13 @@ export async function fetchBlueskyProfile(
 }
 
 /**
- * The owner's own recent posts, newest first. Replies are skipped.
+ * The owner's own recent posts, newest first, alongside how many there are in
+ * all. Replies are skipped, so they count towards neither.
  */
 export async function fetchBlueskyPosts(
 	ctx: AtmosphereContext,
 	options?: { limit?: number }
-): Promise<BlueskyPost[]> {
+): Promise<BlueskyFeed> {
 	const limit = options?.limit ?? 10;
 	const records = await listAllRecords(ctx, 'app.bsky.feed.post');
 	const posts: BlueskyPost[] = [];
@@ -273,5 +280,5 @@ export async function fetchBlueskyPosts(
 			(embed) => embed.kind !== 'quote' || embed.quoted.url || embed.quoted.text
 		);
 	}
-	return shown;
+	return { posts: shown, total: posts.length };
 }
diff --git a/apps/web/src/lib/server/atmosphere/index.ts b/apps/web/src/lib/server/atmosphere/index.ts
index 975c6ca..276e87a 100644
--- a/apps/web/src/lib/server/atmosphere/index.ts
+++ b/apps/web/src/lib/server/atmosphere/index.ts
@@ -1,9 +1,9 @@
 export { type AtmosphereContext, blobRefCid, blobUrl } from './xrpc';
 export { resolveDidDocument, pdsEndpoint } from './identity';
 export { fetchBlueskyProfile, fetchBlueskyPosts } from './bluesky';
-export type { BlueskyProfile, BlueskyPost } from './bluesky';
+export type { BlueskyFeed, BlueskyProfile, BlueskyPost } from './bluesky';
 export { fetchPublications, fetchDocuments } from './standard-site';
-export type { Publication, WritingDocument } from './standard-site';
+export type { DocumentListing, Publication, WritingDocument } from './standard-site';
 export {
 	fetchSifaProfile,
 	fetchSifaPositions,
diff --git a/apps/web/src/lib/server/atmosphere/standard-site.ts b/apps/web/src/lib/server/atmosphere/standard-site.ts
index 05eed0b..7d37f83 100644
--- a/apps/web/src/lib/server/atmosphere/standard-site.ts
+++ b/apps/web/src/lib/server/atmosphere/standard-site.ts
@@ -26,6 +26,14 @@ export interface Publication {
 	url?: string;
 }
 
+export interface DocumentListing {
+	documents: WritingDocument[];
+	/** Documents matching the query, the trimmed ones included. */
+	total: number;
+	/** Where the whole listing lives, when the documents share one address. */
+	publication?: Publication;
+}
+
 export async function fetchPublications(ctx: AtmosphereContext): Promise<Publication[]> {
 	const records = await listAllRecords(ctx, 'site.standard.publication');
 	return records.map((record) => ({
@@ -36,16 +44,20 @@ export async function fetchPublications(ctx: AtmosphereContext): Promise<Publica
 }
 
 /**
- * Documents newest-first. When the account has no site.standard.document
- * records at all, falls back to pub.leaflet.document legacy records; the two
+ * Documents newest-first, alongside how many match in all. When the account
+ * has no site.standard.document records at all, falls back to
+ * pub.leaflet.document legacy records; the two
  * are not merged — post-migration accounts keep legacy records in place, and
  * merging would duplicate them.
  */
 export async function fetchDocuments(
 	ctx: AtmosphereContext,
 	options?: { limit?: number; publicationUri?: string }
-): Promise<WritingDocument[]> {
+): Promise<DocumentListing> {
 	const limit = options?.limit ?? 20;
+	// Two things want the publication records; at most one read serves both.
+	let pending: Promise<Publication[]> | undefined;
+	const publications = () => (pending ??= fetchPublications(ctx));
 
 	let docs: WritingDocument[] = (await listAllRecords(ctx, 'site.standard.document')).flatMap((record) => {
 		const title = str(record.value, 'title');
@@ -80,8 +92,7 @@ export async function fetchDocuments(
 	}
 
 	if (docs.some((d) => !d.url && d.publicationUri && d.path)) {
-		const publications = await fetchPublications(ctx);
-		const urls = new Map(publications.map((p) => [p.uri, p.url]));
+		const urls = new Map((await publications()).map((p) => [p.uri, p.url]));
 		docs = docs.map((d) => {
 			if (d.url || !d.publicationUri || !d.path) return d;
 			const base = urls.get(d.publicationUri);
@@ -93,7 +104,30 @@ export async function fetchDocuments(
 		docs = docs.filter((d) => d.publicationUri === options.publicationUri);
 	}
 	docs.sort((a, b) => (b.publishedAt ?? '').localeCompare(a.publishedAt ?? ''));
-	return docs.slice(0, limit);
+	const shown = docs.slice(0, limit);
+	return {
+		documents: shown,
+		total: docs.length,
+		// Only a trimmed listing needs somewhere to send the reader.
+		publication: docs.length > shown.length ? await home(docs, publications) : undefined
+	};
+}
+
+/**
+ * The one publication every listed document belongs to, when there is exactly
+ * one and it publishes an address. Documents spread across publications — or
+ * legacy records, which name none — leave the listing with no single home.
+ */
+async function home(
+	docs: WritingDocument[],
+	publications: () => Promise<Publication[]>
+): Promise<Publication | undefined> {
+	const uris = new Set(docs.map((d) => d.publicationUri));
+	const [uri] = uris;
+	if (uris.size !== 1 || uri === undefined) return undefined;
+	// A failed read costs the cue, not the listing.
+	const found = (await publications().catch(() => [])).find((p) => p.uri === uri);
+	return found?.url ? found : undefined;
 }
 
 function joinUrl(base: string, path: string): string {
diff --git a/apps/web/src/lib/server/render/render.test.ts b/apps/web/src/lib/server/render/render.test.ts
index d02e839..980c803 100644
--- a/apps/web/src/lib/server/render/render.test.ts
+++ b/apps/web/src/lib/server/render/render.test.ts
@@ -1,9 +1,10 @@
 import { describe, expect, it } from 'vitest';
 import type { AtmosphereContext } from '../atmosphere/xrpc';
+import type { SourceId } from '../atmosphere/sources';
 import { markdownExcerpt, renderMarkdown } from './markdown';
 import { resolveSections } from './sections';
 import { resolveSite } from './resolve';
-import { loadPages } from './site';
+import { loadPages, loadSiteView } from './site';
 import { loadPageView } from './page';
 
 const DID = 'did:plc:test123';
@@ -25,6 +26,86 @@ function fakeCtx(pages: Record<string, unknown>[]): AtmosphereContext {
 	return { pds: 'https://pds.example', did: DID, fetch: fakeFetch };
 }
 
+/** Fake PDS serving whole collections; getRecord always misses. */
+function fakeCollectionsCtx(collections: Record<string, Record<string, unknown>[]>): AtmosphereContext {
+	const fakeFetch = (async (input: RequestInfo | URL) => {
+		const url = new URL(input instanceof Request ? input.url : String(input));
+		if (url.pathname === '/xrpc/com.atproto.repo.listRecords') {
+			const collection = url.searchParams.get('collection') ?? '';
+			return Response.json({
+				records: (collections[collection] ?? []).map((value, i) => ({
+					uri: `at://${DID}/${collection}/rkey${i}`,
+					cid: `cid${i}`,
+					value
+				}))
+			});
+		}
+		return new Response('{"error":"RecordNotFound"}', { status: 400 });
+	}) as typeof fetch;
+	return { pds: 'https://pds.example', did: DID, fetch: fakeFetch };
+}
+
+describe('trimmed sections', () => {
+	function posts(count: number): Record<string, unknown>[] {
+		return Array.from({ length: count }, (_, i) => ({
+			text: `post ${i}`,
+			createdAt: `2026-01-${String(i + 1).padStart(2, '0')}T00:00:00Z`
+		}));
+	}
+
+	async function sectionOf(kind: string, collections: Record<string, Record<string, unknown>[]>, sources: SourceId[]) {
+		const view = await loadSiteView(fakeCollectionsCtx(collections), 'jacob.example.com', sources);
+		return view.sections.find((section) => section.kind === kind);
+	}
+
+	it('points a trimmed posts section at the owner\'s Bluesky profile', async () => {
+		const section = await sectionOf('posts', { 'app.bsky.feed.post': posts(20) }, ['bluesky']);
+		expect(section).toMatchObject({ kind: 'posts' });
+		// The default limit, and an honest count of what was left out.
+		expect(section?.kind === 'posts' && section.posts).toHaveLength(8);
+		expect(section?.kind === 'posts' && section.more).toEqual({
+			total: 20,
+			url: `https://bsky.app/profile/${DID}`,
+			label: 'Bluesky'
+		});
+	});
+
+	it('leaves a whole posts section unmarked', async () => {
+		const section = await sectionOf('posts', { 'app.bsky.feed.post': posts(3) }, ['bluesky']);
+		expect(section?.kind === 'posts' && section.more).toBeUndefined();
+	});
+
+	it('names a trimmed writing section by its publication, or by its host', async () => {
+		const documents = Array.from({ length: 9 }, (_, i) => ({
+			title: `Doc ${i}`,
+			site: `at://${DID}/site.standard.publication/rkey0`
+		}));
+		const named = await sectionOf(
+			'writing',
+			{
+				'site.standard.document': documents,
+				'site.standard.publication': [{ name: 'The Logbook', url: 'https://blog.example/' }]
+			},
+			['writing']
+		);
+		expect(named?.kind === 'writing' && named.more).toEqual({
+			total: 9,
+			url: 'https://blog.example/',
+			label: 'The Logbook'
+		});
+
+		const unnamed = await sectionOf(
+			'writing',
+			{
+				'site.standard.document': documents,
+				'site.standard.publication': [{ url: 'https://www.blog.example/' }]
+			},
+			['writing']
+		);
+		expect(unnamed?.kind === 'writing' && unnamed.more?.label).toBe('blog.example');
+	});
+});
+
 describe('resolveSite', () => {
 	function identityFetch(didDocument: Record<string, unknown>): typeof fetch {
 		return (async (input: RequestInfo | URL) => {
diff --git a/apps/web/src/lib/server/render/site.ts b/apps/web/src/lib/server/render/site.ts
index 00d36de..d7214c9 100644
--- a/apps/web/src/lib/server/render/site.ts
+++ b/apps/web/src/lib/server/render/site.ts
@@ -7,6 +7,8 @@
 
 import {
 	type AtmosphereContext,
+	type BlueskyFeed,
+	type DocumentListing,
 	blobRefCid,
 	blobUrl,
 	fetchBlueskyPosts,
@@ -26,9 +28,18 @@ import type { PageLink, RenderedSection, SitePalette, SiteView } from '../../sit
 
 export type { PageLink, RenderedSection, SitePalette, SiteView };
 
-const DEFAULT_POST_LIMIT = 5;
+const DEFAULT_POST_LIMIT = 8;
 const DEFAULT_DOCUMENT_LIMIT = 5;
 
+/** The destination as a reader would name it: the site's own name, or its host. */
+function siteName(url: string): string {
+	try {
+		return new URL(url).hostname.replace(/^www\./, '');
+	} catch {
+		return url;
+	}
+}
+
 function iconUrlFor(
 	ctx: AtmosphereContext,
 	site: Record<string, unknown> | undefined,
@@ -83,23 +94,37 @@ async function renderSection(
 				showAvatar: spec.showAvatar !== false,
 				style: spec.style ?? 'band'
 			};
-		case 'posts':
+		case 'posts': {
+			const feed = await fetchBlueskyPosts(ctx, {
+				limit: spec.limit ?? DEFAULT_POST_LIMIT
+			}).catch((): BlueskyFeed => ({ posts: [], total: 0 }));
 			return {
 				kind: 'posts',
 				title: spec.title,
-				posts: await fetchBlueskyPosts(ctx, { limit: spec.limit ?? DEFAULT_POST_LIMIT }).catch(
-					() => []
-				)
+				posts: feed.posts,
+				// Posts always have a home to point at: the owner's Bluesky profile.
+				more:
+					feed.total > feed.posts.length
+						? { total: feed.total, url: `https://bsky.app/profile/${ctx.did}`, label: 'Bluesky' }
+						: undefined
 			};
-		case 'writing':
+		}
+		case 'writing': {
+			const listing = await fetchDocuments(ctx, {
+				limit: spec.limit ?? DEFAULT_DOCUMENT_LIMIT,
+				publicationUri: spec.publicationUri
+			}).catch((): DocumentListing => ({ documents: [], total: 0 }));
+			const home = listing.publication;
 			return {
 				kind: 'writing',
 				title: spec.title,
-				documents: await fetchDocuments(ctx, {
-					limit: spec.limit ?? DEFAULT_DOCUMENT_LIMIT,
-					publicationUri: spec.publicationUri
-				}).catch(() => [])
+				documents: listing.documents,
+				more:
+					home?.url && listing.total > listing.documents.length
+						? { total: listing.total, url: home.url, label: home.name ?? siteName(home.url) }
+						: undefined
 			};
+		}
 		case 'career': {
 			const wanted = spec.parts;
 			const want = (part: string) => !wanted || wanted.includes(part);
diff --git a/apps/web/src/lib/site-view.ts b/apps/web/src/lib/site-view.ts
index cc3fb16..041f21b 100644
--- a/apps/web/src/lib/site-view.ts
+++ b/apps/web/src/lib/site-view.ts
@@ -91,6 +91,19 @@ export interface PostView {
 	embeds: PostEmbed[];
 }
 
+/**
+ * Where the records a section trimmed can be read in full. Absent when the
+ * section shows everything, or when nothing canonical can be linked — a count
+ * with nowhere to go is a tease, not an affordance.
+ */
+export interface MoreLink {
+	/** Records available, the shown ones included. */
+	total: number;
+	url: string;
+	/** The destination as a reader would name it, like "Bluesky". */
+	label: string;
+}
+
 export interface DocumentView {
 	uri: string;
 	title: string;
@@ -130,8 +143,8 @@ export type RenderedSection =
 			/** Banner treatment; only meaningful when the profile carries a banner. */
 			style: 'band' | 'postcard';
 	  }
-	| { kind: 'posts'; title?: string; posts: PostView[] }
-	| { kind: 'writing'; title?: string; documents: DocumentView[] }
+	| { kind: 'posts'; title?: string; posts: PostView[]; more?: MoreLink }
+	| { kind: 'writing'; title?: string; documents: DocumentView[]; more?: MoreLink }
 	| {
 			kind: 'career';
 			title?: string;
diff --git a/apps/web/src/routes/admin/+page.server.ts b/apps/web/src/routes/admin/+page.server.ts
index 8db884e..d2e1b2b 100644
--- a/apps/web/src/routes/admin/+page.server.ts
+++ b/apps/web/src/routes/admin/+page.server.ts
@@ -39,12 +39,12 @@ export const load: PageServerLoad = async (event) => {
 	const sources = detectSources(repo.collections);
 
 	// One failing read must not take down the admin page.
-	const [site, profile, sifaProfile, posts, documents] = await Promise.all([
+	const [site, profile, sifaProfile, feed, writing] = await Promise.all([
 		readSite(admin.ctx).catch(() => undefined),
 		fetchBlueskyProfile(admin.ctx).catch(() => undefined),
 		fetchSifaProfile(admin.ctx).catch(() => undefined),
-		fetchBlueskyPosts(admin.ctx, { limit: 3 }).catch(() => []),
-		fetchDocuments(admin.ctx, { limit: 3 }).catch(() => [])
+		fetchBlueskyPosts(admin.ctx, { limit: 3 }).catch(() => ({ posts: [], total: 0 })),
+		fetchDocuments(admin.ctx, { limit: 3 }).catch(() => ({ documents: [], total: 0 }))
 	]);
 
 	return {
@@ -55,8 +55,8 @@ export const load: PageServerLoad = async (event) => {
 		site: siteFields(site ?? {}),
 		profile,
 		sifaProfile,
-		posts,
-		documents
+		posts: feed.posts,
+		documents: writing.documents
 	};
 };
 
-- 
2.51.2


From ef35ca14fbe2217111e16f4ff4763e7ef76496ef Mon Sep 17 00:00:00 2001
From: Jacob Zweifel <jacob@jacobzweifel.com>
Date: Thu, 27 Aug 2026 15:34:09 -0400
Subject: [PATCH 2/2] NEXT: the volume sub-item of the theme tail is resolved

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 docs/NEXT.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/NEXT.md b/docs/NEXT.md
index c91c5ed..47865b7 100644
--- a/docs/NEXT.md
+++ b/docs/NEXT.md
@@ -2,7 +2,7 @@
 
 The flight plan. Each item carries enough context to start cold; update this file whenever an item lands (move it to "Done") or a new one is queued. Decisions made while working an item still go through `decisions/` as usual.
 
-_Last updated: 2026-08-27 (**PD-11 recorded: the site-metrics offering** — free real-7d / paid-30d on Analytics Engine, design fully settled in `research/2026-08-26-analytics-offering.md`, queued as item 2 below. Also: **PRs #27, #28 and #31 are all merged and deployed.** mooring.page now serves the demo-first landing page (PD-10) — verified live: the apex carries the Open Graph card, `/s/jzweifel.dev` renders with the claim banner and `noindex`, and the domain lock, sign-off band and republished `signOff` lexicon from the earlier PRs are all in place. **PR #33 is merged and deployed too** — the postmark cut-off fix and the landing footer's attribution row (both below), smoke-tested live. **PR #35 is merged and deployed** — the admin and login pages wear the site letterhead (details below). **PR #37 is merged and deployed too** — it fixes the white frame #35 shipped with (the `body { margin: 0 }` reset lived only in SiteLayout's `:global` styles, so routes that never bundle SiteLayout kept the default body margin; `letterhead.css` now resets body margin and paints `html` with background + `color-scheme` via `:has(.letterhead)`, mirroring SiteLayout's own root treatment) — verified live: the served letterhead stylesheet on mooring.page/login carries the reset in both schemes. **PR #39 is merged and deployed too** — the theme's contrast guards for user color overrides (details below); verified live in both schemes. **PR #41 is merged and deployed too** — Bluesky post embeds render instead of the cue (details below); verified live. **Nothing is in flight; the queue below is current.** The queue below is otherwise current. Critique trends, two separate targets: the rendered **theme** ran 25 → 31 → 29 → 32, and the **landing page** has one run at 21/40 — snapshots in `.impeccable/critique/`)._
+_Last updated: 2026-08-27 (**PD-11 recorded: the site-metrics offering** — free real-7d / paid-30d on Analytics Engine, design fully settled in `research/2026-08-26-analytics-offering.md`, queued as item 2 below. Also: **PRs #27, #28 and #31 are all merged and deployed.** mooring.page now serves the demo-first landing page (PD-10) — verified live: the apex carries the Open Graph card, `/s/jzweifel.dev` renders with the claim banner and `noindex`, and the domain lock, sign-off band and republished `signOff` lexicon from the earlier PRs are all in place. **PR #33 is merged and deployed too** — the postmark cut-off fix and the landing footer's attribution row (both below), smoke-tested live. **PR #35 is merged and deployed** — the admin and login pages wear the site letterhead (details below). **PR #37 is merged and deployed too** — it fixes the white frame #35 shipped with (the `body { margin: 0 }` reset lived only in SiteLayout's `:global` styles, so routes that never bundle SiteLayout kept the default body margin; `letterhead.css` now resets body margin and paints `html` with background + `color-scheme` via `:has(.letterhead)`, mirroring SiteLayout's own root treatment) — verified live: the served letterhead stylesheet on mooring.page/login carries the reset in both schemes. **PR #39 is merged and deployed too** — the theme's contrast guards for user color overrides (details below); verified live in both schemes. **PR #41 is merged and deployed too** — Bluesky post embeds render instead of the cue (details below); verified live. **PR #43 is open and not yet merged** — trimmed posts/writing sections now close with a cue carrying the count and a link to where the rest lives, and the career log stays whole by decision (details below); this closes the *volume behavior* sub-item of the theme tail. **#43 is in flight; the rest of the queue below is current.** The queue below is otherwise current. Critique trends, two separate targets: the rendered **theme** ran 25 → 31 → 29 → 32, and the **landing page** has one run at 21/40 — snapshots in `.impeccable/critique/`)._
 
 ## Where things stand
 
@@ -16,7 +16,7 @@ Done so far: OAuth login (loopback dev client; hosted-client path ready pending
 
 - **Theme UX polish, remaining tail** (all mechanical findings from four critique rounds are fixed and deployed; the contrast guards landed 2026-08-27, see Done; what remains is design-decision territory — mock on a canvas before coding, per this push's working pattern):
   1. *Record-level career curation fields* (decided 2026-08-24, staged): hide/order/feature for positions, education, skills — e.g. de-emphasizing a high-school entry or dropping generic imported skills ("Software Development", "Windows 7"); becomes `careerSection` fields once the admin grows a section editor. Framing from the reviews: "honest by default, curatable by choice."
-  2. *Volume behavior*: every section is an uncapped list — decide caps/pagination ("latest N") before a user with 40 posts finds the missing answer. Posts/writing already honor per-section `limit` in the site record; the question is defaults and UI.
+  2. *Volume behavior* — **resolved 2026-08-27, PR #43 open** (see Done). Posts and writing now close a trimmed list with a cue that carries the count and links to where the whole of it lives; the career log stays whole by decision. Nothing left here unless a heavy poster's site argues for a real archive route.
   3. *Residual*: no RSS; postcard hero still unexercised by a real record (flip `heroSection.style` on a site record to demo); mono-metadata density (the detector's standing flat-type finding, 10.9–11.5px cluster — deliberate system, revisit only if it keeps bothering reviewers).
 - **Thin deletion-honoring cache** over the direct PDS reads (ADR 0010 §4) — deliberately reordered below hosting on 2026-08-07: rendering reads live per request, which is correct until there is traffic to cache. The demo-first landing page (PD-10) raises the pressure: the apex now invites uncached live reads for arbitrary handles, so abuse or traffic on the lookup form is the trigger. Revisit once sites are actually served; when it comes up, start from Jetstream v2's snapshot+tail replay (`research/2026-08-14-bluesky-protocol-services.md`) rather than a relay consumer.
 - **Landing-page critique follow-ups, design-decision tier** (queued 2026-08-25; snapshot `.impeccable/critique/2026-08-26T01-52-10Z__apps-web-src-routes-page-svelte.md`, scored 21/40 — the three P1s and the mechanical P2s are fixed; what remains needs product calls): gloss or drop "standard.site"/"sifa" jargon for the non-technical launch audience; a pricing signal ("free subdomain" reads as an unpriced paywall); accept a pasted DID in the lookup (currently lowercased and rejected as a typo); distinguish resolver outages from typos in the error copy; and the big swing — show a real rendered site on the landing page instead of describing one ("you've built a rendering engine and put a text ad in front of it").
@@ -36,6 +36,8 @@ The whole design is settled and recorded — `research/2026-08-26-analytics-offe
 
 ## Done
 
+- 2026-08-27 — **A section that stops short says so, and says where the rest is** (PR #43, **open**). Posts and writing rendered a fixed head of their collections and simply stopped: a reader with 342 posts saw five, with nothing on the page saying so and nowhere to go for the rest, while the career log rendered every record — three inconsistent volume behaviours on one page. Jacob's calls, all three the recommended option: **a stamped cue that links out** rather than an in-place disclosure or an archive route (quote hydration deliberately runs only over the *shown* posts — each quote costs a DID-document resolution plus a post read — so revealing forty more would either pay for forty more of those or render the hidden ones bare); **the career log stays whole** (a résumé's point is showing the log, its lines are compact, and a truncated work history reads as concealment rather than curation — so `positions`/`education` are untouched, and the existing `SKILL_CAP` disclosure stands); and **the default post count moves 5 → 8**, which an honest cue makes affordable. A trimmed list now closes with one line in the theme's system voice — mono, accent, above a dotted rule that replaces the list's own last border: `8 of 342 · the rest on Bluesky ↗`. **The count turned out to be free**: both adapters already page the entire collection (`listAllRecords`, 10 × 100) before slicing, so they now return it — `fetchBlueskyPosts` → `{ posts, total }`, `fetchDocuments` → `{ documents, total, publication? }` (replies count towards neither). **The line only renders when there is somewhere to send the reader** — a count with no destination is a tease, not an affordance. Posts always have one, the owner's Bluesky profile by DID, matching the two links `SiteLayout` already builds. Writing has one when every listed document belongs to a single publication that publishes an address; documents spread across publications, or `pub.leaflet.*` legacy records which name none, get no line, and the label is the publication's name falling back to its host. Resolving that publication costs a read, so it is only attempted once a listing is known to be short, the two things wanting publication records now share one read instead of two, and a failed read costs the cue rather than the listing. No lexicon change, no record migration, no new route. 7 new tests (224 in `web`); verified in a browser through a temporary preview route covering posts-trimmed, posts-whole, writing-with-a-named-publication and writing-falling-back-to-its-host in both schemes, deleted before commit — accent-on-paper measured 6.58:1 light / 5.46:1 dark, 36px tall, no horizontal overflow at 375px. Checked against live PDS data: `jzweifel.dev` has five non-reply posts, so it is trimmed by neither the old limit nor the new one and renders unchanged. **One gap:** no account in hand exercises the cue against live data — it is covered by the tests and the dev preview, not by a deployed site; look the first time a heavier poster's site is rendered.
+
 - 2026-08-27 — **Bluesky post embeds render instead of a cue** (PR #41, **merged and deployed 2026-08-27**). Posts carrying an embed showed "· view on Bluesky" next to the date; critique 4 read the inconsistency as a glitch. Three of the four embed kinds turn out to cost nothing: `app.bsky.embed.external` and `app.bsky.embed.images` carry everything in the post record, so extraction is a pure function (`postEmbeds` in `atmosphere/bluesky.ts`, defensively parsed like the facet code beside it) and `recordWithMedia` is just both. Only `app.bsky.embed.record` needs the network. Jacob's calls: **hydrate quotes tolerantly** and **give images the full text measure with a height cap**. Hydration resolves the quoted author's DID document (one fetch yields both the PDS and the handle via `handleFromDidDocument`) then reads the post, all under a 2.5s `AbortSignal.timeout`, in parallel and only for the posts actually shown; any failure leaves a bare "Quoted post ↗" link. A self-quote skips the DID resolution entirely and renders without a byline. A quote that can neither be read nor linked — a feed generator, a list — is dropped so the post falls back to the Bluesky cue, which is now shown only for embed kinds the theme doesn't render (video, today). Theme work is one `postEmbed` snippet in `SiteSections.svelte`: link cards clamp title and blurb to two lines over a sunk-paper panel with the host in mono; a single image uses the record's `aspectRatio` as `width`/`height` attributes so the browser reserves the space, then `max-height: 22rem` does the fitting; two or more become a square-celled contact sheet. Two things fell out of the work: `AtmosphereContext` gained an optional `signal` that `xrpcGet` honors, and **`postPermalink` was too permissive** — it built a `/post/` URL for any collection, which would have produced broken links for non-post quote targets, so it now matches `app.bsky.feed.post` only (one guard, all callers). The existing `/blob` widths cover both a 4.5rem card thumb and a full-measure image, so the anticipated new thumb size wasn't needed. 16 new tests (217 in `web`); the recordWithMedia test caught a real nesting bug — that embed wraps its quote one level deeper than a bare `record` embed. Verified in a browser against live PDS data (`jzweifel.dev`: two real link cards with PDS thumbs, and the `recordWithMedia` post rendering its card plus a hydrated self-quote, cue gone, no overflow at 375px) and against a temporary preview route covering all seven states in both schemes, deleted before commit. Smoke-tested against the deployed origin: `mooring.page/s/jzweifel.dev` serves two link cards with their titles and hosts, and the `recordWithMedia` post renders its card plus the hydrated self-quote — the quoted text is in the server-rendered HTML with no `<cite>` and the right permalink, so the cross-network quote read runs fine from the Worker. No `view on Bluesky` cue anywhere on the page, and the per-post `aria-label` is intact. The card thumbs serve from `/blob/…?w=256` as **7.9 KB webp** (272 KB unresized jpeg in dev), so the zone's image transform covers the new thumb size without a widening of the allowlist. **One gap:** no live record exercises `app.bsky.embed.images` or a cross-author quote yet — both are covered by tests and the dev preview route, not by a deployed site.
 
 - 2026-08-27 — **User color overrides can no longer render a site unreadable** (PR #39, **merged and deployed 2026-08-27**, Worker version `ea42ea99`). `theme.colors` set `--paper`/`--ink`/`--accent`/`--accent-ink` through the `style` attribute on `.site`, and inline custom properties outrank every stylesheet rule — so the theme's own `@media (prefers-color-scheme: dark)` block could never fire for an overridden token. A site that declared only a background got that background pinned in dark mode while `--ink` still flipped to `#e9e3d6`: near-white text on near-white paper, ~1.06:1, with a near-black `--paper-sunk` panel sitting in the middle of it. Reproduced in a browser before the fix. The record carries one `colors` object and no scheme variants, so the fix takes that at its word: **any color override declares a single palette and pins the site to one scheme**, chosen by the background's luminance (or, with only a foreground declared, its inverse — dark text means light paper). A new `apps/web/src/lib/server/render/palette.ts` builds the whole eight-token palette server-side from whatever subset was declared — the derived roles (`--muted`, `--rule`, `--paper-sunk`) are mixed from the *declared* paper and ink instead of stranding at the other scheme's values — and holds every text-bearing pairing (ink/muted/accent on paper, accent-ink on accent) to WCAG AA 4.5:1. **Failing colors are darkened or lightened toward black or white until they clear, rather than dropped** (Jacob's call): most plausible brand colors fail AA on the near-white paper — Bluesky blue is 3.26:1, a mid teal 2.89:1 — so dropping them would have made "I set my accent and nothing happened" the common case. Hue is preserved; the teal renders 24% darker and still unmistakably teal. The walk always terminates: whichever of black and white is further from the background reaches at least 4.58:1. `color-scheme` is pinned alongside the palette (via `html:has(.site.pinned)`, whose specificity beats the theme's own `html` rule regardless of load order) so scrollbars and form controls stop following the OS against a pinned page. Sites with no override emit no tokens at all and keep both schemes — verified unchanged in both directions. 15 new tests including nine hostile palettes (identical fg/bg, mid-grey, white-on-white); verified in a browser through a temporary preview route, deleted before commit. **Known ceiling:** an accent-only override now also pins the scheme, so a user who only wanted a brand color loses dark mode. The honest upgrade is a `colorsDark` sibling in the `page.mooring.site` lexicon rather than more CSS — the lexicon simply cannot express two schemes today. Its `colors` description was left alone to avoid a republish for prose; fold the pinning semantics in next time that record is republished. Smoke-tested against the deployed origin: `mooring.page/s/jzweifel.dev` renders correctly in both schemes (`--paper` `#101520`/`#f7f3ea` following the reader, empty inline style, no `pinned` class, `color-scheme: light dark`) with no console errors, and the served stylesheet carries the compiled `.site.svelte-8htptl:not(.pinned)` — note Svelte places the scope class *before* the `:not()`, so grep for `pinned` rather than the authored selector. **One gap:** no deployed site declares `theme.colors` yet, so the pinned path itself is covered by the tests and the dev preview, not by a live record — exercise it the first time a real site sets colors.
-- 
2.51.2