shipseal 0.1.0 → 0.4.0

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { existsSync, readFileSync } from "node:fs";
-import { basename, dirname, extname, isAbsolute, join, relative, resolve } from "node:path";
+import { dirname, extname, isAbsolute, join, resolve } from "node:path";
 import { cac } from "cac";
 import { appendFile, mkdir, readFile, readdir, rename, writeFile } from "node:fs/promises";
 import { z } from "zod";
@@ -241,6 +241,8 @@ const DEFAULT_CONFIG = {
 	},
 	milestones: {
 		stars: [
+			10,
+			50,
 			100,
 			250,
 			500,
@@ -409,8 +411,22 @@ function firstSentence(text) {
 * sentences, and the fitting pass comfortably handles more.
 */
 const HEADLINE_MAX_CHARS = 72;
+/**
+* Emoji ranges, removed from anything that reaches a card.
+*
+* No font we register carries these glyphs, so `\u{1F310} Human-friendly ...` (got's real
+* GitHub description) rendered a tofu box on shipseal.dev. Takumi ships an emoji helper, but it
+* rewrites each emoji into an <img> pointing at jsDelivr, and `generate()` does no network.
+*
+* The ranges deliberately start at U+2600, which keeps the textual symbols people put in real
+* product names: (c) U+00A9, (r) U+00AE and (tm) U+2122 all sit below it.
+*/
+const EMOJI = /[\u{1F000}-\u{1FAFF}]|[\u{2600}-\u{27BF}]|[\u{FE00}-\u{FE0F}]|\u200D/gu;
+function stripEmoji(text) {
+	return text.replaceAll(EMOJI, "").replace(/\s+/g, " ").trim();
+}
 function cleanLine(text) {
-	const stripped = text.replace(/\s*\u2014\s*/g, ": ").replace(/\s+\u2013\s+/g, ", ").replaceAll("–", "-").replaceAll("!", ".").replace(/\s+/g, " ").trim();
+	const stripped = stripEmoji(text).replace(/\s*\u2014\s*/g, ": ").replace(/\s+\u2013\s+/g, ", ").replaceAll("–", "-").replaceAll("!", ".").replace(/\s+/g, " ").trim();
 	const noTrail = stripped.endsWith(".") ? stripped.slice(0, -1) : stripped;
 	const first = noTrail.at(0);
 	if (first === void 0) return noTrail;
@@ -1818,9 +1834,9 @@ const storyPage = {
 				box: { width: 220 }
 			},
 			title: {
-				maxLines: tall ? 3 : 2,
+				maxLines: tall ? 4 : 2,
 				maxFontSize: tall ? 64 : 48,
-				minFontSize: 28,
+				minFontSize: tall ? 36 : 30,
 				step: 2,
 				box: {
 					width: width - 32,
@@ -1877,7 +1893,7 @@ const storyPage = {
 	render(raw, ctx) {
 		const props = propsSchema.parse(raw);
 		const colors = themeColors(ctx.brand, ctx.theme);
-		const { tall, titleHeight, bodyHeight, width } = geometry(ctx.format);
+		const { tall, bodyHeight, width } = geometry(ctx.format);
 		const editorial = ctx.brand.style === "editorial";
 		const terminal = ctx.brand.style === "terminal";
 		const code = isCommand(props.page);
@@ -1911,6 +1927,7 @@ const storyPage = {
 						justifyContent: "space-between",
 						alignItems: "center",
 						height: HEADER_HEIGHT,
+						flexShrink: 0,
 						borderBottom: terminal ? `1px solid ${colors.muted}` : NO_BORDER,
 						paddingBottom: terminal ? 12 : 0
 					},
@@ -1943,83 +1960,91 @@ const storyPage = {
 						children: ctx.fitted.version?.text ?? props.version
 					})]
 				}),
-				/* @__PURE__ */ jsx("div", {
+				/* @__PURE__ */ jsxs("div", {
 					style: {
 						display: "flex",
-						alignItems: "center",
-						height: titleHeight,
-						flexShrink: 0,
-						paddingLeft: editorial ? 24 : 0,
-						borderLeft: editorial ? `8px solid ${colors.primary}` : NO_BORDER
+						flexDirection: "column",
+						flexGrow: 1,
+						justifyContent: "center",
+						gap: 24,
+						minHeight: 0
 					},
-					children: /* @__PURE__ */ jsx("div", {
+					children: [/* @__PURE__ */ jsx("div", {
 						style: {
-							fontFamily: props.heading,
-							fontWeight: props.weight,
-							fontSize: title?.fontSize ?? 48,
-							lineHeight: 1.2,
-							maxWidth: width - (editorial ? 32 : 0)
+							display: "flex",
+							alignItems: "center",
+							flexShrink: 0,
+							paddingLeft: editorial ? 24 : 0,
+							borderLeft: editorial ? `8px solid ${colors.primary}` : NO_BORDER
 						},
-						children: title?.text ?? props.page.title.value
-					})
-				}),
-				comparison ? /* @__PURE__ */ jsx("div", {
-					style: {
-						display: "flex",
-						flexDirection: tall ? "column" : "row",
-						gap: 16,
-						height: bodyHeight
-					},
-					children: ["before", "after"].map((label) => /* @__PURE__ */ jsxs("div", {
+						children: /* @__PURE__ */ jsx("div", {
+							style: {
+								fontFamily: props.heading,
+								fontWeight: props.weight,
+								fontSize: title?.fontSize ?? 48,
+								lineHeight: 1.2,
+								maxWidth: width - (editorial ? 32 : 0)
+							},
+							children: title?.text ?? props.page.title.value
+						})
+					}), comparison ? /* @__PURE__ */ jsx("div", {
 						style: {
 							display: "flex",
-							flexDirection: "column",
-							gap: 8,
-							width: paneWidth,
-							height: paneHeight
+							flexDirection: tall ? "column" : "row",
+							gap: 16,
+							height: bodyHeight
 						},
-						children: [/* @__PURE__ */ jsx("div", {
+						children: ["before", "after"].map((label) => /* @__PURE__ */ jsxs("div", {
 							style: {
-								fontFamily: props.body,
-								fontSize: 20,
-								color: colors.muted
+								display: "flex",
+								flexDirection: "column",
+								gap: 8,
+								width: paneWidth,
+								height: paneHeight
 							},
-							children: label === "before" ? "Before" : "After"
-						}), /* @__PURE__ */ jsx("img", {
-							src: `story-${label}`,
-							width: paneWidth,
-							height: paneHeight - HEADER_HEIGHT,
-							style: { objectFit: "contain" }
-						})]
-					}, label))
-				}) : hasBody ? /* @__PURE__ */ jsx("div", {
-					style: {
-						display: "flex",
-						flexDirection: "column",
-						justifyContent: "flex-start",
-						height: bodyHeight,
-						padding: BODY_PAD,
-						backgroundColor: terminal || code ? colors.card : "transparent",
-						borderRadius: terminal ? 0 : ctx.brand.radius,
-						borderLeft: terminal ? `3px solid ${colors.primary}` : NO_BORDER
-					},
-					children: /* @__PURE__ */ jsx("div", {
+							children: [/* @__PURE__ */ jsx("div", {
+								style: {
+									fontFamily: props.body,
+									fontSize: 20,
+									color: colors.muted
+								},
+								children: label === "before" ? "Before" : "After"
+							}), /* @__PURE__ */ jsx("img", {
+								src: `story-${label}`,
+								width: paneWidth,
+								height: paneHeight - HEADER_HEIGHT,
+								style: { objectFit: "contain" }
+							})]
+						}, label))
+					}) : hasBody ? /* @__PURE__ */ jsx("div", {
 						style: {
-							fontFamily: code ? props.mono : props.body,
-							fontWeight: 400,
-							fontSize: bodyFontSize,
-							lineHeight: code ? CODE_LINE_HEIGHT : 1.2,
-							whiteSpace: code ? "pre" : "normal",
-							color: colors.foreground
+							display: "flex",
+							flexDirection: "column",
+							justifyContent: "flex-start",
+							maxHeight: bodyHeight,
+							padding: terminal || code ? BODY_PAD : 0,
+							backgroundColor: terminal || code ? colors.card : "transparent",
+							borderRadius: terminal ? 0 : ctx.brand.radius,
+							borderLeft: terminal ? `3px solid ${colors.primary}` : NO_BORDER
 						},
-						children: bodyText
-					})
-				}) : void 0,
+						children: /* @__PURE__ */ jsx("div", {
+							style: {
+								fontFamily: code ? props.mono : props.body,
+								fontWeight: 400,
+								fontSize: bodyFontSize,
+								lineHeight: code ? CODE_LINE_HEIGHT : 1.2,
+								whiteSpace: code ? "pre" : "normal",
+								color: colors.foreground
+							},
+							children: bodyText
+						})
+					}) : void 0]
+				}),
 				/* @__PURE__ */ jsxs("div", {
 					style: {
 						display: "flex",
 						justifyContent: "space-between",
-						marginTop: "auto",
+						flexShrink: 0,
 						fontFamily: props.mono,
 						fontWeight: 400,
 						fontSize: 16,
@@ -2408,7 +2433,7 @@ async function collectReadme(cwd) {
 		ref: "README.md H1",
 		fetchedAt
 	});
-	if (tagline !== void 0) project.tagline = fact(tagline, {
+	if (tagline !== void 0) project.tagline = fact(stripEmoji(tagline), {
 		source: "readme",
 		ref: "README.md first paragraph",
 		fetchedAt
@@ -2499,6 +2524,14 @@ function stripBadges(text) {
 	return text.replace(/\[!\[[^\]]*]\([^)]+\)]\([^)]+\)/g, "").replace(/!\[[^\]]*]\([^)]+\)/g, "").replace(/<img[^>]*>/gi, "").replace(/<[^>]+>/g, "").replace(/\s+/g, " ").trim();
 }
 
+//#endregion
+//#region src/sources/release-line.ts
+/** Markdown escapes a maintainer never meant to see rendered: \[ruff\] becomes [ruff]. */
+const MARKDOWN_ESCAPE = /\\([[\]()*_`~#+\-.!])/g;
+function cleanReleaseLine(item) {
+	return item.replace(/^\s*[-*]\s*/, "").replace(/\[`[a-f0-9]{7,40}`]\([^)]+\)/gi, "").replace(/^[a-f0-9]{7,40}:\s*/i, "").replace(/\(#\d+\)/g, "").replace(/\[#\d+]\([^)]+\)/g, "").replace(/#\d+\b/g, "").replace(/Thanks\s+\[@[\w-]+]\([^)]+\)!?\s*-?\s*/gi, "").replace(/\[@[\w-]+]\([^)]+\)/g, "").replace(/\(@[\w-]+\)/g, "").replace(/\s+by\s+@[\w-]+/gi, "").replace(/@[\w-]+/g, "").replace(/^Thanks\s*!?\s*-?\s*/i, "").replaceAll(/!\[[^\]]*\]\([^)]*\)/g, "").replaceAll(/\[([^\]]+)\]\([^)]*\)/g, "$1").replaceAll(/<[^>]*>/g, "").replaceAll(MARKDOWN_ESCAPE, "$1").replaceAll(/[*`]/g, "").replace(/^\s*[-*]\s*/, "").replace(/\s*\(\s*\)/g, "").replace(/\s+([,.;:])/g, "$1").replace(/\s+/g, " ").trim().replace(/[\s,;:-]+$/, "").replace(/\.$/, "");
+}
+
 //#endregion
 //#region src/sources/changelog.ts
 async function collectChangelog(cwd, version, changelogPath = "CHANGELOG.md") {
@@ -2600,7 +2633,7 @@ function findVersionSection(markdown, version) {
 	}
 }
 function cleanChangelogItem(item) {
-	return item.replace(/^\s*[-*]\s*/, "").replace(/\[`[a-f0-9]{7,40}`]\([^)]+\)/gi, "").replace(/^[a-f0-9]{7,40}:\s*/i, "").replace(/\(#\d+\)/g, "").replace(/\[#\d+]\([^)]+\)/g, "").replace(/Thanks\s+\[@[\w-]+]\([^)]+\)!?\s*-?\s*/gi, "").replace(/\[@[\w-]+]\([^)]+\)/g, "").replace(/\(@[\w-]+\)/g, "").replace(/\s+by\s+@[\w-]+/gi, "").replace(/@[\w-]+/g, "").replace(/^Thanks\s*!?\s*-?\s*/i, "").replace(/^\s*[-*]\s*/, "").replaceAll(/`([^`]+)`/g, "$1").replaceAll("`", "").replace(/\s+/g, " ").trim().replace(/\.$/, "");
+	return cleanReleaseLine(item);
 }
 function headingIncludesVersion(heading, version) {
 	const unwrapped = heading.replace(/[[\]]/g, " ");
@@ -2887,7 +2920,7 @@ async function collectGithub(options) {
 	};
 	if (repo.description !== void 0 && repo.description !== null && repo.description.length > 0) out.project = {
 		...out.project,
-		tagline: fact(repo.description, {
+		tagline: fact(stripEmoji(repo.description), {
 			source: "github-api",
 			ref: `GET /repos/${slug.owner}/${slug.repo} description`,
 			fetchedAt
@@ -3083,7 +3116,7 @@ async function collectPackageJson(cwd, packagePath = "package.json") {
 		ref: rawName === void 0 ? `${packagePath} directory name` : `${packagePath}#name`,
 		fetchedAt
 	}) };
-	if (pkg.data.description !== void 0 && pkg.data.description.length > 0) project.tagline = fact(pkg.data.description, {
+	if (pkg.data.description !== void 0 && pkg.data.description.length > 0) project.tagline = fact(stripEmoji(pkg.data.description), {
 		source: "package-json",
 		ref: `${packagePath}#description`,
 		fetchedAt
@@ -4530,152 +4563,400 @@ function isRecord(value) {
 }
 
 //#endregion
-//#region src/brand/logo.ts
-const DIRECTORIES = [
-	"",
-	"assets",
-	"assets/brand",
-	"public",
-	"public/brand",
-	".github",
-	"docs",
-	"static",
-	"branding"
-];
-const ICON_NAMES = ["icon.svg", "icon.png"];
-const NAMES = [
-	"logo.svg",
-	"logo.png",
-	"logo-light.svg",
-	"logo-light.png"
-];
-const FALLBACKS = [...ICON_NAMES, "favicon.svg"];
-function findLogo(cwd) {
-	for (const dir of DIRECTORIES) for (const name of NAMES) {
-		const relative = dir === "" ? name : join(dir, name);
-		if (existsSync(join(cwd, relative))) return relative;
+//#region src/brand/tailwind.ts
+const COLOR_PROP = /--color-([a-zA-Z0-9-]+)\s*:\s*([^;]+);/g;
+const CUSTOM_PROP = /--([a-zA-Z0-9-]+)\s*:\s*([^;]+);/g;
+const SKIP_PREFIXES = /* @__PURE__ */ new Set([
+	"chart",
+	"sidebar",
+	"ring",
+	"border",
+	"input",
+	"destructive"
+]);
+function extractTailwindV4Colors(css) {
+	const blocks = themeBlocks(css);
+	const custom = collectCustomProperties(css);
+	const fromTheme = {};
+	for (const block of blocks) {
+		COLOR_PROP.lastIndex = 0;
+		let match;
+		while ((match = COLOR_PROP.exec(block)) !== null) {
+			const name = match[1];
+			const raw = match[2];
+			if (name === void 0 || raw === void 0 || shouldSkip(name)) continue;
+			fromTheme[name] = raw.trim();
+		}
 	}
-	for (const dir of DIRECTORIES) for (const name of FALLBACKS) {
-		const relative = dir === "" ? name : join(dir, name);
-		if (existsSync(join(cwd, relative))) return relative;
+	const resolved = {};
+	for (const [name, raw] of Object.entries(fromTheme)) {
+		const hex = resolveToHex(raw, custom, 0);
+		if (hex !== void 0) resolved[name] = hex;
 	}
+	return mapBrandColors(resolved);
 }
-function findLogoPair(cwd) {
-	const light = findLogo(cwd);
-	if (light === void 0) return;
-	const darkNames = ["logo-dark.svg", "logo-dark.png"];
-	for (const dir of DIRECTORIES) for (const name of darkNames) {
-		const relative = dir === "" ? name : join(dir, name);
-		if (existsSync(join(cwd, relative))) return {
-			light,
-			dark: relative
-		};
+function extractTailwindV3Colors(source) {
+	const found = {};
+	const re = /\b(primary|brand|accent|background|foreground|muted|secondary)\b\s*:\s*["'`]([^"'`]+)["'`]/g;
+	let match;
+	while ((match = re.exec(source)) !== null) {
+		const name = match[1];
+		const raw = match[2];
+		if (name === void 0 || raw === void 0) continue;
+		const hex = parseCssColor(raw);
+		if (hex !== void 0) found[name] = hex;
 	}
-	return { light };
+	return mapBrandColors(found);
 }
-
-//#endregion
-//#region src/brand/png.ts
-const SIGNATURE = Buffer.from([
-	137,
-	80,
-	78,
-	71,
-	13,
-	10,
-	26,
-	10
-]);
-/** Channels per pixel for each PNG color type. Index is the color type. */
-const CHANNELS = {
-	0: 1,
-	2: 3,
-	3: 1,
-	4: 2,
-	6: 4
-};
-function decodePng(buffer) {
-	if (buffer.length < 8 || !buffer.subarray(0, 8).equals(SIGNATURE)) return;
-	let width = 0;
-	let height = 0;
-	let bitDepth = 0;
-	let colorType = 0;
-	let interlace = 0;
-	let palette;
-	let paletteAlpha;
-	const idat = [];
-	let offset = 8;
-	while (offset + 8 <= buffer.length) {
-		const length = buffer.readUInt32BE(offset);
-		const type = buffer.toString("ascii", offset + 4, offset + 8);
-		const start = offset + 8;
-		const end = start + length;
-		if (end > buffer.length) return;
-		if (type === "IHDR") {
-			width = buffer.readUInt32BE(start);
-			height = buffer.readUInt32BE(start + 4);
-			bitDepth = buffer[start + 8] ?? 0;
-			colorType = buffer[start + 9] ?? 0;
-			interlace = buffer[start + 12] ?? 0;
-		} else if (type === "PLTE") palette = buffer.subarray(start, end);
-		else if (type === "tRNS") paletteAlpha = buffer.subarray(start, end);
-		else if (type === "IDAT") idat.push(buffer.subarray(start, end));
-		else if (type === "IEND") break;
-		offset = end + 4;
-	}
-	const channels = CHANNELS[colorType];
-	if (width === 0 || height === 0 || channels === void 0 || interlace !== 0 || bitDepth !== 8 && bitDepth !== 16 || idat.length === 0 || colorType === 3 && palette === void 0) return;
-	if (width * height > 64e6) return;
-	let raw;
-	try {
-		raw = inflateSync(Buffer.concat(idat));
-	} catch {
-		return;
+function themeBlocks(css) {
+	const blocks = [];
+	const re = /@theme(?:\s+inline)?\s*\{/g;
+	let match;
+	while ((match = re.exec(css)) !== null) {
+		const open = css.indexOf("{", match.index);
+		if (open === -1) break;
+		const close = matchingBrace(css, open);
+		if (close === -1) break;
+		blocks.push(css.slice(open + 1, close));
 	}
-	const bytesPerSample = bitDepth / 8;
-	const bpp = channels * bytesPerSample;
-	const stride = width * bpp;
-	if (raw.length < height * (stride + 1)) return;
-	const unfiltered = unfilter(raw, height, stride, bpp);
-	if (unfiltered === void 0) return;
-	return {
-		width,
-		height,
-		pixels: toRgba(unfiltered, width, height, colorType, bytesPerSample, palette, paletteAlpha)
-	};
+	return blocks;
 }
-/** Reverse the per-scanline filters defined in the PNG spec. */
-function unfilter(raw, height, stride, bpp) {
-	const out = Buffer.alloc(height * stride);
-	let pos = 0;
-	for (let y = 0; y < height; y++) {
-		const filter = raw[pos];
-		pos += 1;
-		if (filter === void 0 || filter > 4) return;
-		const rowStart = y * stride;
-		const prevStart = rowStart - stride;
-		for (let x = 0; x < stride; x++) {
-			const value = raw[pos + x] ?? 0;
-			const a = x >= bpp ? out[rowStart + x - bpp] ?? 0 : 0;
-			const b = y > 0 ? out[prevStart + x] ?? 0 : 0;
-			const c = x >= bpp && y > 0 ? out[prevStart + x - bpp] ?? 0 : 0;
-			let restored;
-			switch (filter) {
-				case 1:
-					restored = value + a;
-					break;
-				case 2:
-					restored = value + b;
-					break;
-				case 3:
-					restored = value + Math.floor((a + b) / 2);
-					break;
-				case 4:
-					restored = value + paeth(a, b, c);
-					break;
-				default: restored = value;
-			}
-			out[rowStart + x] = restored & 255;
+function matchingBrace(source, openIndex) {
+	let depth = 0;
+	for (let i = openIndex; i < source.length; i += 1) {
+		const ch = source[i];
+		if (ch === "{") depth += 1;
+		else if (ch === "}") {
+			depth -= 1;
+			if (depth === 0) return i;
+		}
+	}
+	return -1;
+}
+function collectCustomProperties(css) {
+	const props = /* @__PURE__ */ new Map();
+	CUSTOM_PROP.lastIndex = 0;
+	let match;
+	while ((match = CUSTOM_PROP.exec(css)) !== null) {
+		const name = match[1];
+		const value = match[2];
+		if (name !== void 0 && value !== void 0) props.set(`--${name}`, value.trim());
+	}
+	return props;
+}
+function resolveToHex(raw, custom, depth) {
+	if (depth > 3) return;
+	const direct = parseCssColor(raw);
+	if (direct !== void 0) return direct;
+	const varMatch = /^var\(\s*(--[a-zA-Z0-9-]+)\s*(?:,[^)]+)?\)$/.exec(raw);
+	if (varMatch === null) return;
+	const ref = varMatch[1];
+	if (ref === void 0) return;
+	const next = custom.get(ref);
+	if (next === void 0) return;
+	return resolveToHex(next, custom, depth + 1);
+}
+function shouldSkip(name) {
+	const root = name.split("-")[0];
+	return root !== void 0 && SKIP_PREFIXES.has(root);
+}
+function mapBrandColors(found) {
+	const out = {};
+	const background = found.background ?? found.bg;
+	if (background !== void 0) out.background = background;
+	const foreground = found.foreground ?? found.fg;
+	if (foreground !== void 0) out.foreground = foreground;
+	const muted = found["muted-foreground"] ?? found.muted;
+	if (muted !== void 0) out.muted = muted;
+	const primary = found.primary ?? found.brand;
+	if (primary !== void 0) out.primary = primary;
+	const accent = found.accent ?? found.secondary;
+	if (accent !== void 0) out.accent = accent;
+	return out;
+}
+
+//#endregion
+//#region src/brand/detect-colors.ts
+/** Path helpers, kept local so this module never imports `node:path`. */
+function basename$1(path) {
+	return path.split("/").pop() ?? path;
+}
+function relative(from, path) {
+	const prefix = from.endsWith("/") ? from : `${from}/`;
+	return path.startsWith(prefix) ? path.slice(prefix.length) : path;
+}
+async function detectColorsFrom(files, cwd, logoPath, sources, notes, logoColor = () => Promise.resolve(void 0)) {
+	const merged = {};
+	const paths = await files.list();
+	const cssFiles = paths.filter((file) => file.endsWith(".css"));
+	const cssContents = await Promise.all(cssFiles.map(async (file) => ({
+		file,
+		css: await files.read(file)
+	})));
+	for (const { file, css } of cssContents) {
+		if (css === void 0) continue;
+		const fromTheme = extractTailwindV4Colors(css);
+		const fromRoot = extractCssRootColors(css);
+		const rel = relative(cwd, file);
+		applyColors(merged, fromTheme, sources, `Tailwind v4 @theme in ${rel}`);
+		applyColors(merged, fromRoot, sources, `:root variables in ${rel}`);
+	}
+	const configFiles = paths.filter((file) => basename$1(file).startsWith("tailwind.config."));
+	const configContents = await Promise.all(configFiles.map(async (file) => ({
+		file,
+		source: await files.read(file)
+	})));
+	for (const { file, source } of configContents) {
+		if (source === void 0) continue;
+		applyColors(merged, extractTailwindV3Colors(source), sources, `Tailwind config ${relative(cwd, file)}`);
+	}
+	const tokenFile = paths.find((file) => file.endsWith(".tokens.json"));
+	if (tokenFile !== void 0) {
+		const raw = await files.read(tokenFile);
+		if (raw !== void 0) try {
+			const parsed = JSON.parse(raw);
+			applyColors(merged, extractDtcgColors(parsed), sources, relative(cwd, tokenFile));
+		} catch (error) {
+			if (error instanceof SyntaxError) notes.push(`Could not parse design tokens file ${relative(cwd, tokenFile)}.`);
+			else throw error;
+		}
+	}
+	if (merged.primary === void 0 && logoPath !== void 0) {
+		const fromPng = logoPath.endsWith(".png") ? await logoColor(files, logoPath) : void 0;
+		if (fromPng !== void 0) {
+			merged.primary = fromPng;
+			sources.push({
+				field: "colors.primary",
+				source: `dominant color in ${logoPath}`
+			});
+		}
+		const svg = logoPath.endsWith(".svg") ? await files.read(logoPath) : void 0;
+		if (svg !== void 0) {
+			const fromLogo = firstNonNeutralSvgColor(svg);
+			if (fromLogo !== void 0) {
+				merged.primary = fromLogo;
+				sources.push({
+					field: "colors.primary",
+					source: `SVG fill in ${logoPath}`
+				});
+			}
+		}
+	}
+	const fellBack = [
+		"background",
+		"foreground",
+		"muted",
+		"primary",
+		"accent"
+	].filter((field) => merged[field] === void 0);
+	if (fellBack.length > 0) notes.push(`Using built-in defaults for ${fellBack.map((f) => `colors.${f}`).join(", ")}. Nothing in this project set them. Edit .shipseal/brand.json to use your own.`);
+	return {
+		background: merged.background ?? DEFAULT_BRAND_COLORS.background,
+		foreground: merged.foreground ?? DEFAULT_BRAND_COLORS.foreground,
+		muted: merged.muted ?? DEFAULT_BRAND_COLORS.muted,
+		primary: merged.primary ?? DEFAULT_BRAND_COLORS.primary,
+		accent: merged.accent ?? DEFAULT_BRAND_COLORS.accent
+	};
+}
+function applyColors(target, incoming, sources, source) {
+	for (const key of [
+		"background",
+		"foreground",
+		"muted",
+		"primary",
+		"accent"
+	]) {
+		const value = incoming[key];
+		if (value !== void 0 && target[key] === void 0) {
+			target[key] = value;
+			sources.push({
+				field: `colors.${key}`,
+				source
+			});
+		}
+	}
+}
+function applyReadableMuted(colors, sources, notes) {
+	if (colors.muted === void 0 || readableOnBackground(colors.background, colors.muted)) return;
+	colors.muted = DEFAULT_BRAND_COLORS.muted;
+	notes.push(`Muted text color failed WCAG AA large-text contrast (3:1) against background, so it was set to ${DEFAULT_BRAND_COLORS.muted}.`);
+	upsertSource(sources, "colors.muted", "contrast adjustment");
+}
+function applyReadableAccent(colors, sources, notes) {
+	if (colors.accent === void 0 || readableOnBackground(colors.background, colors.accent)) return;
+	colors.accent = colors.primary ?? DEFAULT_BRAND_COLORS.primary;
+	notes.push("Accent failed contrast against background, so it uses the primary color.");
+	upsertSource(sources, "colors.accent", "contrast adjustment");
+}
+function upsertSource(sources, field, source) {
+	const existing = sources.find((entry) => entry.field === field);
+	if (existing !== void 0) {
+		existing.source = source;
+		return;
+	}
+	sources.push({
+		field,
+		source
+	});
+}
+function firstNonNeutralSvgColor(svg) {
+	const re = /(?:fill|stroke)="([^"]+)"/g;
+	let match;
+	while ((match = re.exec(svg)) !== null) {
+		const raw = match[1];
+		if (raw === void 0 || raw === "none" || raw === "currentColor") continue;
+		const hex = parseCssColor(raw);
+		if (hex !== void 0 && !isNeutralHex(hex)) return hex;
+	}
+}
+
+//#endregion
+//#region src/brand/logo.ts
+const DIRECTORIES = [
+	"",
+	"assets",
+	"assets/brand",
+	"public",
+	"public/brand",
+	".github",
+	"docs",
+	"static",
+	"branding"
+];
+const ICON_NAMES = ["icon.svg", "icon.png"];
+const NAMES = [
+	"logo.svg",
+	"logo.png",
+	"logo-light.svg",
+	"logo-light.png"
+];
+const FALLBACKS = [...ICON_NAMES, "favicon.svg"];
+function findLogo(cwd) {
+	for (const dir of DIRECTORIES) for (const name of NAMES) {
+		const relative = dir === "" ? name : join(dir, name);
+		if (existsSync(join(cwd, relative))) return relative;
+	}
+	for (const dir of DIRECTORIES) for (const name of FALLBACKS) {
+		const relative = dir === "" ? name : join(dir, name);
+		if (existsSync(join(cwd, relative))) return relative;
+	}
+}
+function findLogoPair(cwd) {
+	const light = findLogo(cwd);
+	if (light === void 0) return;
+	const darkNames = ["logo-dark.svg", "logo-dark.png"];
+	for (const dir of DIRECTORIES) for (const name of darkNames) {
+		const relative = dir === "" ? name : join(dir, name);
+		if (existsSync(join(cwd, relative))) return {
+			light,
+			dark: relative
+		};
+	}
+	return { light };
+}
+
+//#endregion
+//#region src/brand/png.ts
+const SIGNATURE = Buffer.from([
+	137,
+	80,
+	78,
+	71,
+	13,
+	10,
+	26,
+	10
+]);
+/** Channels per pixel for each PNG color type. Index is the color type. */
+const CHANNELS = {
+	0: 1,
+	2: 3,
+	3: 1,
+	4: 2,
+	6: 4
+};
+function decodePng(buffer) {
+	if (buffer.length < 8 || !buffer.subarray(0, 8).equals(SIGNATURE)) return;
+	let width = 0;
+	let height = 0;
+	let bitDepth = 0;
+	let colorType = 0;
+	let interlace = 0;
+	let palette;
+	let paletteAlpha;
+	const idat = [];
+	let offset = 8;
+	while (offset + 8 <= buffer.length) {
+		const length = buffer.readUInt32BE(offset);
+		const type = buffer.toString("ascii", offset + 4, offset + 8);
+		const start = offset + 8;
+		const end = start + length;
+		if (end > buffer.length) return;
+		if (type === "IHDR") {
+			width = buffer.readUInt32BE(start);
+			height = buffer.readUInt32BE(start + 4);
+			bitDepth = buffer[start + 8] ?? 0;
+			colorType = buffer[start + 9] ?? 0;
+			interlace = buffer[start + 12] ?? 0;
+		} else if (type === "PLTE") palette = buffer.subarray(start, end);
+		else if (type === "tRNS") paletteAlpha = buffer.subarray(start, end);
+		else if (type === "IDAT") idat.push(buffer.subarray(start, end));
+		else if (type === "IEND") break;
+		offset = end + 4;
+	}
+	const channels = CHANNELS[colorType];
+	if (width === 0 || height === 0 || channels === void 0 || interlace !== 0 || bitDepth !== 8 && bitDepth !== 16 || idat.length === 0 || colorType === 3 && palette === void 0) return;
+	if (width * height > 64e6) return;
+	let raw;
+	try {
+		raw = inflateSync(Buffer.concat(idat));
+	} catch {
+		return;
+	}
+	const bytesPerSample = bitDepth / 8;
+	const bpp = channels * bytesPerSample;
+	const stride = width * bpp;
+	if (raw.length < height * (stride + 1)) return;
+	const unfiltered = unfilter(raw, height, stride, bpp);
+	if (unfiltered === void 0) return;
+	return {
+		width,
+		height,
+		pixels: toRgba(unfiltered, width, height, colorType, bytesPerSample, palette, paletteAlpha)
+	};
+}
+/** Reverse the per-scanline filters defined in the PNG spec. */
+function unfilter(raw, height, stride, bpp) {
+	const out = Buffer.alloc(height * stride);
+	let pos = 0;
+	for (let y = 0; y < height; y++) {
+		const filter = raw[pos];
+		pos += 1;
+		if (filter === void 0 || filter > 4) return;
+		const rowStart = y * stride;
+		const prevStart = rowStart - stride;
+		for (let x = 0; x < stride; x++) {
+			const value = raw[pos + x] ?? 0;
+			const a = x >= bpp ? out[rowStart + x - bpp] ?? 0 : 0;
+			const b = y > 0 ? out[prevStart + x] ?? 0 : 0;
+			const c = x >= bpp && y > 0 ? out[prevStart + x - bpp] ?? 0 : 0;
+			let restored;
+			switch (filter) {
+				case 1:
+					restored = value + a;
+					break;
+				case 2:
+					restored = value + b;
+					break;
+				case 3:
+					restored = value + Math.floor((a + b) / 2);
+					break;
+				case 4:
+					restored = value + paeth(a, b, c);
+					break;
+				default: restored = value;
+			}
+			out[rowStart + x] = restored & 255;
 		}
 		pos += stride;
 	}
@@ -4764,141 +5045,22 @@ function dominantNonNeutralColor(png) {
 			bucket.count += 1;
 			bucket.r += r;
 			bucket.g += g;
-			bucket.b += b;
-		}
-	}
-	let best;
-	for (const bucket of buckets.values()) if (best === void 0 || bucket.count > best.count) best = bucket;
-	if (best === void 0) return;
-	const channel = (total) => Math.round(total / best.count).toString(16).padStart(2, "0");
-	return `#${channel(best.r)}${channel(best.g)}${channel(best.b)}`;
-}
-
-//#endregion
-//#region src/brand/tailwind.ts
-const COLOR_PROP = /--color-([a-zA-Z0-9-]+)\s*:\s*([^;]+);/g;
-const CUSTOM_PROP = /--([a-zA-Z0-9-]+)\s*:\s*([^;]+);/g;
-const SKIP_PREFIXES = /* @__PURE__ */ new Set([
-	"chart",
-	"sidebar",
-	"ring",
-	"border",
-	"input",
-	"destructive"
-]);
-function extractTailwindV4Colors(css) {
-	const blocks = themeBlocks(css);
-	const custom = collectCustomProperties(css);
-	const fromTheme = {};
-	for (const block of blocks) {
-		COLOR_PROP.lastIndex = 0;
-		let match;
-		while ((match = COLOR_PROP.exec(block)) !== null) {
-			const name = match[1];
-			const raw = match[2];
-			if (name === void 0 || raw === void 0 || shouldSkip(name)) continue;
-			fromTheme[name] = raw.trim();
-		}
-	}
-	const resolved = {};
-	for (const [name, raw] of Object.entries(fromTheme)) {
-		const hex = resolveToHex(raw, custom, 0);
-		if (hex !== void 0) resolved[name] = hex;
-	}
-	return mapBrandColors(resolved);
-}
-function extractTailwindV3Colors(source) {
-	const found = {};
-	const re = /\b(primary|brand|accent|background|foreground|muted|secondary)\b\s*:\s*["'`]([^"'`]+)["'`]/g;
-	let match;
-	while ((match = re.exec(source)) !== null) {
-		const name = match[1];
-		const raw = match[2];
-		if (name === void 0 || raw === void 0) continue;
-		const hex = parseCssColor(raw);
-		if (hex !== void 0) found[name] = hex;
-	}
-	return mapBrandColors(found);
-}
-function themeBlocks(css) {
-	const blocks = [];
-	const re = /@theme(?:\s+inline)?\s*\{/g;
-	let match;
-	while ((match = re.exec(css)) !== null) {
-		const open = css.indexOf("{", match.index);
-		if (open === -1) break;
-		const close = matchingBrace(css, open);
-		if (close === -1) break;
-		blocks.push(css.slice(open + 1, close));
-	}
-	return blocks;
-}
-function matchingBrace(source, openIndex) {
-	let depth = 0;
-	for (let i = openIndex; i < source.length; i += 1) {
-		const ch = source[i];
-		if (ch === "{") depth += 1;
-		else if (ch === "}") {
-			depth -= 1;
-			if (depth === 0) return i;
-		}
-	}
-	return -1;
-}
-function collectCustomProperties(css) {
-	const props = /* @__PURE__ */ new Map();
-	CUSTOM_PROP.lastIndex = 0;
-	let match;
-	while ((match = CUSTOM_PROP.exec(css)) !== null) {
-		const name = match[1];
-		const value = match[2];
-		if (name !== void 0 && value !== void 0) props.set(`--${name}`, value.trim());
+			bucket.b += b;
+		}
 	}
-	return props;
-}
-function resolveToHex(raw, custom, depth) {
-	if (depth > 3) return;
-	const direct = parseCssColor(raw);
-	if (direct !== void 0) return direct;
-	const varMatch = /^var\(\s*(--[a-zA-Z0-9-]+)\s*(?:,[^)]+)?\)$/.exec(raw);
-	if (varMatch === null) return;
-	const ref = varMatch[1];
-	if (ref === void 0) return;
-	const next = custom.get(ref);
-	if (next === void 0) return;
-	return resolveToHex(next, custom, depth + 1);
-}
-function shouldSkip(name) {
-	const root = name.split("-")[0];
-	return root !== void 0 && SKIP_PREFIXES.has(root);
-}
-function mapBrandColors(found) {
-	const out = {};
-	const background = found.background ?? found.bg;
-	if (background !== void 0) out.background = background;
-	const foreground = found.foreground ?? found.fg;
-	if (foreground !== void 0) out.foreground = foreground;
-	const muted = found["muted-foreground"] ?? found.muted;
-	if (muted !== void 0) out.muted = muted;
-	const primary = found.primary ?? found.brand;
-	if (primary !== void 0) out.primary = primary;
-	const accent = found.accent ?? found.secondary;
-	if (accent !== void 0) out.accent = accent;
-	return out;
+	let best;
+	for (const bucket of buckets.values()) if (best === void 0 || bucket.count > best.count) best = bucket;
+	if (best === void 0) return;
+	const channel = (total) => Math.round(total / best.count).toString(16).padStart(2, "0");
+	return `#${channel(best.r)}${channel(best.g)}${channel(best.b)}`;
 }
 
 //#endregion
 //#region src/brand/detect.ts
-const execFileAsync = promisify(execFile);
-const SKIP_DIRS = /* @__PURE__ */ new Set([
-	"node_modules",
-	".git",
-	"dist",
-	"coverage",
-	".shipseal",
-	".next",
-	"build"
-]);
+/** Path helpers, kept local so this module stays free of `node:path` and reaches the browser. */
+function basename(path) {
+	return path.split("/").pop() ?? path;
+}
 const packageSchema = z.object({
 	private: z.boolean().optional(),
 	name: z.string().optional(),
@@ -4906,20 +5068,24 @@ const packageSchema = z.object({
 	homepage: z.string().optional(),
 	repository: z.union([z.string(), z.object({ url: z.string().optional() })]).optional()
 });
-async function detectBrand(cwd) {
+/**
+* Detection over any source. `root` is only used to make reported paths readable, so the
+* GitHub implementation can pass the repository slug.
+*/
+async function detectBrandFrom(files, cwd = ".") {
 	const sources = [];
 	const notes = [];
-	const pkg = await readPackage(cwd);
-	const readme = await readMaybe(join(cwd, "README.md"));
+	const pkg = await readPackage(files);
+	const readme = await files.read("README.md");
 	const name = detectName(pkg, readme, cwd, sources);
 	const tagline = detectTagline(pkg, readme, sources);
-	const url = await detectUrl(pkg, cwd, sources);
+	const url = await detectUrl(files, pkg, cwd, sources);
 	const logo = findLogoPair(cwd);
 	if (logo !== void 0) sources.push({
 		field: "logo",
 		source: logo.light
 	});
-	const colors = await detectColors(cwd, logo?.light, sources, notes);
+	const colors = await detectColorsFrom(files, cwd, logo?.light, sources, notes, dominantLogoColor);
 	const contrast = ensureForegroundContrast(colors.background, colors.foreground);
 	if (contrast.adjusted) {
 		colors.foreground = contrast.foreground;
@@ -5009,7 +5175,7 @@ function detectTagline(pkg, readme, sources) {
 		}
 	}
 }
-async function detectUrl(pkg, cwd, sources) {
+async function detectUrl(files, pkg, cwd, sources) {
 	if (pkg?.homepage !== void 0 && pkg.homepage.length > 0) {
 		sources.push({
 			field: "url",
@@ -5025,7 +5191,7 @@ async function detectUrl(pkg, cwd, sources) {
 		});
 		return repo;
 	}
-	const remote = await gitRemote(cwd);
+	const remote = await files.gitRemote?.();
 	if (remote !== void 0) {
 		sources.push({
 			field: "url",
@@ -5034,122 +5200,8 @@ async function detectUrl(pkg, cwd, sources) {
 		return remote;
 	}
 }
-async function detectColors(cwd, logoPath, sources, notes) {
-	const merged = {};
-	const files = await listFiles(cwd, 4);
-	const cssFiles = files.filter((file) => file.endsWith(".css"));
-	const cssContents = await Promise.all(cssFiles.map(async (file) => ({
-		file,
-		css: await readMaybe(file)
-	})));
-	for (const { file, css } of cssContents) {
-		if (css === void 0) continue;
-		const fromTheme = extractTailwindV4Colors(css);
-		const fromRoot = extractCssRootColors(css);
-		const rel = relative(cwd, file);
-		applyColors(merged, fromTheme, sources, `Tailwind v4 @theme in ${rel}`);
-		applyColors(merged, fromRoot, sources, `:root variables in ${rel}`);
-	}
-	const configFiles = files.filter((file) => basename(file).startsWith("tailwind.config."));
-	const configContents = await Promise.all(configFiles.map(async (file) => ({
-		file,
-		source: await readMaybe(file)
-	})));
-	for (const { file, source } of configContents) {
-		if (source === void 0) continue;
-		applyColors(merged, extractTailwindV3Colors(source), sources, `Tailwind config ${relative(cwd, file)}`);
-	}
-	const tokenFile = files.find((file) => file.endsWith(".tokens.json"));
-	if (tokenFile !== void 0) {
-		const raw = await readMaybe(tokenFile);
-		if (raw !== void 0) try {
-			const parsed = JSON.parse(raw);
-			applyColors(merged, extractDtcgColors(parsed), sources, relative(cwd, tokenFile));
-		} catch (error) {
-			if (error instanceof SyntaxError) notes.push(`Could not parse design tokens file ${relative(cwd, tokenFile)}.`);
-			else throw error;
-		}
-	}
-	if (merged.primary === void 0 && logoPath !== void 0) {
-		const fromPng = logoPath.endsWith(".png") ? await dominantLogoColor(join(cwd, logoPath)) : void 0;
-		if (fromPng !== void 0) {
-			merged.primary = fromPng;
-			sources.push({
-				field: "colors.primary",
-				source: `dominant color in ${logoPath}`
-			});
-		}
-		const svg = logoPath.endsWith(".svg") ? await readMaybe(join(cwd, logoPath)) : void 0;
-		if (svg !== void 0) {
-			const fromLogo = firstNonNeutralSvgColor(svg);
-			if (fromLogo !== void 0) {
-				merged.primary = fromLogo;
-				sources.push({
-					field: "colors.primary",
-					source: `SVG fill in ${logoPath}`
-				});
-			}
-		}
-	}
-	const fellBack = [
-		"background",
-		"foreground",
-		"muted",
-		"primary",
-		"accent"
-	].filter((field) => merged[field] === void 0);
-	if (fellBack.length > 0) notes.push(`Using built-in defaults for ${fellBack.map((f) => `colors.${f}`).join(", ")}. Nothing in this project set them. Edit .shipseal/brand.json to use your own.`);
-	return {
-		background: merged.background ?? DEFAULT_BRAND_COLORS.background,
-		foreground: merged.foreground ?? DEFAULT_BRAND_COLORS.foreground,
-		muted: merged.muted ?? DEFAULT_BRAND_COLORS.muted,
-		primary: merged.primary ?? DEFAULT_BRAND_COLORS.primary,
-		accent: merged.accent ?? DEFAULT_BRAND_COLORS.accent
-	};
-}
-function applyReadableMuted(colors, sources, notes) {
-	if (colors.muted === void 0 || readableOnBackground(colors.background, colors.muted)) return;
-	colors.muted = DEFAULT_BRAND_COLORS.muted;
-	notes.push(`Muted text color failed WCAG AA large-text contrast (3:1) against background, so it was set to ${DEFAULT_BRAND_COLORS.muted}.`);
-	upsertSource(sources, "colors.muted", "contrast adjustment");
-}
-function applyReadableAccent(colors, sources, notes) {
-	if (colors.accent === void 0 || readableOnBackground(colors.background, colors.accent)) return;
-	colors.accent = colors.primary ?? DEFAULT_BRAND_COLORS.primary;
-	notes.push("Accent failed contrast against background, so it uses the primary color.");
-	upsertSource(sources, "colors.accent", "contrast adjustment");
-}
-function applyColors(target, incoming, sources, source) {
-	for (const key of [
-		"background",
-		"foreground",
-		"muted",
-		"primary",
-		"accent"
-	]) {
-		const value = incoming[key];
-		if (value !== void 0 && target[key] === void 0) {
-			target[key] = value;
-			sources.push({
-				field: `colors.${key}`,
-				source
-			});
-		}
-	}
-}
-function upsertSource(sources, field, source) {
-	const existing = sources.find((entry) => entry.field === field);
-	if (existing !== void 0) {
-		existing.source = source;
-		return;
-	}
-	sources.push({
-		field,
-		source
-	});
-}
-async function readPackage(cwd) {
-	const raw = await readMaybe(join(cwd, "package.json"));
+async function readPackage(files) {
+	const raw = await files.read("package.json");
 	if (raw === void 0) return;
 	try {
 		const parsed = JSON.parse(raw);
@@ -5160,18 +5212,69 @@ async function readPackage(cwd) {
 		throw error;
 	}
 }
-async function gitRemote(cwd) {
-	try {
-		const { stdout } = await execFileAsync("git", [
-			"remote",
-			"get-url",
-			"origin"
-		], { cwd });
-		return normalizeGitUrl(stdout.trim());
-	} catch (error) {
-		if (error instanceof Error) return;
-		throw error;
-	}
+function stripScope(name) {
+	const parts = name.split("/");
+	return parts[parts.length - 1] ?? name;
+}
+function repositoryUrl(repository) {
+	if (typeof repository === "string") return normalizeGitUrl(repository);
+	if (repository?.url !== void 0) return normalizeGitUrl(repository.url);
+}
+function normalizeGitUrl(url) {
+	const ssh = /^git@([^:]+):(.+)$/.exec(url);
+	if (ssh !== null && ssh[1] !== void 0 && ssh[2] !== void 0) return `https://${ssh[1]}/${ssh[2].replace(/\.git$/, "")}`;
+	return url.replace(/^git\+/, "").replace(/\.git$/, "");
+}
+/**
+* Dominant non-neutral color of a PNG logo, or undefined when the file cannot be read or
+* carries no color. Detection reports the color as not found rather than falling back to a
+* built-in default that would be presented to the user as "your brand".
+*/
+async function dominantLogoColor(files, path) {
+	const buffer = await files.readBinary(path);
+	if (buffer === void 0) return;
+	const png = decodePng(Buffer.from(buffer));
+	if (png === void 0) return;
+	return dominantNonNeutralColor(png);
+}
+
+//#endregion
+//#region src/brand/detect-node.ts
+const execFileAsync = promisify(execFile);
+const SKIP_DIRS = /* @__PURE__ */ new Set([
+	"node_modules",
+	".git",
+	"dist",
+	"build",
+	"coverage",
+	".next",
+	".astro",
+	"out",
+	"vendor"
+]);
+async function detectBrand(cwd) {
+	return detectBrandFrom(diskFiles(cwd), cwd);
+}
+/** The disk implementation of the port, used by the CLI. Paths stay absolute here. */
+function diskFiles(cwd, maxDepth = 4) {
+	return {
+		list: () => listFiles(cwd, maxDepth),
+		read: async (path) => {
+			try {
+				return await readFile(isAbsolute(path) ? path : join(cwd, path), "utf8");
+			} catch {
+				return;
+			}
+		},
+		gitRemote: () => gitRemote(cwd),
+		readBinary: async (path) => {
+			try {
+				return await readFile(isAbsolute(path) ? path : join(cwd, path));
+			} catch {
+				return;
+			}
+		}
+	};
 }
 async function listFiles(root, maxDepth) {
 	const out = [];
@@ -5197,50 +5300,17 @@ async function listFiles(root, maxDepth) {
 	await walk(root, maxDepth);
 	return out;
 }
-async function readMaybe(path) {
-	try {
-		return await readFile(path, "utf8");
-	} catch {
-		return;
-	}
-}
-function stripScope(name) {
-	const parts = name.split("/");
-	return parts[parts.length - 1] ?? name;
-}
-function repositoryUrl(repository) {
-	if (typeof repository === "string") return normalizeGitUrl(repository);
-	if (repository?.url !== void 0) return normalizeGitUrl(repository.url);
-}
-function normalizeGitUrl(url) {
-	const ssh = /^git@([^:]+):(.+)$/.exec(url);
-	if (ssh !== null && ssh[1] !== void 0 && ssh[2] !== void 0) return `https://${ssh[1]}/${ssh[2].replace(/\.git$/, "")}`;
-	return url.replace(/^git\+/, "").replace(/\.git$/, "");
-}
-/**
-* Dominant non-neutral color of a PNG logo, or undefined when the file cannot be read or
-* carries no color. Detection reports the color as not found rather than falling back to a
-* built-in default that would be presented to the user as "your brand".
-*/
-async function dominantLogoColor(path) {
-	let buffer;
+async function gitRemote(cwd) {
 	try {
-		buffer = await readFile(path);
-	} catch {
-		return;
-	}
-	const png = decodePng(buffer);
-	if (png === void 0) return;
-	return dominantNonNeutralColor(png);
-}
-function firstNonNeutralSvgColor(svg) {
-	const re = /(?:fill|stroke)="([^"]+)"/g;
-	let match;
-	while ((match = re.exec(svg)) !== null) {
-		const raw = match[1];
-		if (raw === void 0 || raw === "none" || raw === "currentColor") continue;
-		const hex = parseCssColor(raw);
-		if (hex !== void 0 && !isNeutralHex(hex)) return hex;
+		const { stdout } = await execFileAsync("git", [
+			"remote",
+			"get-url",
+			"origin"
+		], { cwd });
+		return normalizeGitUrl(stdout.trim());
+	} catch (error) {
+		if (error instanceof Error) return;
+		throw error;
 	}
 }
 
@@ -5596,10 +5666,10 @@ function overlayReleaseConfig(config, flags) {
 //#region src/core/story.ts
 const DEFAULT_CHANGE_PAGES = 4;
 const STORY_FORMATS$1 = "portrait, square, og, github-social, x, linkedin, or producthunt";
-function storyFacts(facts, config, name, generatedAt) {
+function storyFacts(facts, config, brand, generatedAt) {
 	const release = facts.release;
 	if (release === void 0) throw new ShipsealError("story.no-release", "No release facts are available for a story.", "Choose a published release or pass --tag to a local repository.");
-	const copy = deterministicCopy(facts, config.release?.maxHighlights, name);
+	const copy = deterministicCopy(facts, config.release?.maxHighlights, brand.name);
 	const configured = (value, ref) => fact(value, {
 		source: "user-config",
 		ref,
@@ -5614,7 +5684,11 @@ function storyFacts(facts, config, name, generatedAt) {
 	const pages = [{
 		kind: "cover",
 		title: fact(copy.headline, headlineSource.provenance),
-		body: release.subheadline ?? facts.project.tagline ?? fact("Release notes", release.tag.provenance)
+		body: release.subheadline ?? facts.project.tagline ?? (brand.tagline === void 0 ? fact("Release notes", release.tag.provenance) : fact(brand.tagline, {
+			source: "user-config",
+			ref: "brand.json#tagline",
+			fetchedAt: generatedAt
+		}))
 	}];
 	for (const item of changes.slice(0, config.release?.maxHighlights ?? DEFAULT_CHANGE_PAGES)) {
 		const collapsed = item.value.replaceAll(/\s+/g, " ").trim();
@@ -5657,7 +5731,7 @@ function storyFacts(facts, config, name, generatedAt) {
 	};
 }
 async function generateStory(input) {
-	const facts = storyFacts(input.facts, input.config, input.brand.name, input.generatedAt);
+	const facts = storyFacts(input.facts, input.config, input.brand, input.generatedAt);
 	const pages = facts.story ?? [];
 	const result = {
 		files: [],