shipseal 0.1.1 → 0.4.2

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,
@@ -323,6 +325,24 @@ const COPY_LIMITS = {
 	milestoneLine: 48
 };
 
+//#endregion
+//#region src/copy/headline.ts
+/** Below this a line is a fragment or a label, not a description of a change. */
+const MIN_WORDS = 3;
+const MIN_CHARS = 12;
+/** Housekeeping prefixes. A chore is not what a release is about. */
+const CHORE = /^(chore|docs?|ci|build|test|refactor|style|revert|bump|deps?|dependencies)\b[:(]?/i;
+/** A line that is only a person's name: "Adam Chmara", "Jane Q. Smith". */
+const PERSON_NAME = /^[A-Z][\p{L}'’-]+(?:\s+[A-Z][.\p{L}'’-]*){1,2}$/u;
+/** Package-ish fragments: "/api", "@scope/pkg", "solid-query.0.0-rc.3", "v1.2.3". */
+const FRAGMENT = /^[@/]|^v?\d+\.\d+|^[\w@/.-]+$/;
+function isHeadlineWorthy(line) {
+	const text = line.trim();
+	if (text.length < MIN_CHARS || text.split(/\s+/).length < MIN_WORDS) return false;
+	if (CHORE.test(text) || PERSON_NAME.test(text) || FRAGMENT.test(text)) return false;
+	return !/https?:\/\//.test(text);
+}
+
 //#endregion
 //#region src/copy/deterministic.ts
 function deterministicCopy(facts, maxHighlights = 4, displayName) {
@@ -331,7 +351,7 @@ function deterministicCopy(facts, maxHighlights = 4, displayName) {
 	const features = (facts.release?.features ?? []).map((item) => item.value);
 	const fixes = (facts.release?.fixes ?? []).map((item) => item.value);
 	const breaking = (facts.release?.breaking ?? []).map((item) => item.value);
-	const headlineSource = [...breaking, ...features].map((line) => cleanLine(firstSentence(line))).find((line) => line.length <= HEADLINE_MAX_CHARS);
+	const headlineSource = [...breaking, ...features].map((line) => cleanLine(firstSentence(line))).find((line) => line.length <= HEADLINE_MAX_CHARS && isHeadlineWorthy(line));
 	const title = displayName ?? name;
 	const headline = facts.release?.headline?.value ?? headlineSource ?? (version === void 0 ? title : `${title} ${version}`);
 	const tagline = facts.release?.subheadline?.value ?? facts.project.tagline?.value;
@@ -1832,7 +1852,7 @@ const storyPage = {
 				box: { width: 220 }
 			},
 			title: {
-				maxLines: tall ? 3 : 2,
+				maxLines: tall ? 4 : 2,
 				maxFontSize: tall ? 64 : 48,
 				minFontSize: tall ? 36 : 30,
 				step: 2,
@@ -2522,6 +2542,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, "").replaceAll(/\(\s*[a-f0-9]{6,40}\s*\)/gi, "").replace(/^\[[^\]]{1,24}\]\s*/, "").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") {
@@ -2623,7 +2651,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, " ");
@@ -4552,6 +4580,254 @@ function isRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
+//#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());
+	}
+	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 = [
@@ -4797,131 +5073,12 @@ function dominantNonNeutralColor(png) {
 	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());
-	}
-	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.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(),
@@ -4929,20 +5086,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;
@@ -5032,7 +5193,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",
@@ -5048,7 +5209,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",
@@ -5057,122 +5218,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);
@@ -5183,18 +5230,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 = [];
@@ -5220,50 +5318,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;
 	}
 }