getfilepress 0.1.8 → 0.1.10

package/packages/import/src/ollama.ts

@@ -66,6 +66,77 @@ export function ollamaSetupHint(host: string): string {
 	].join(' ');
 }
 
+/** Wall-clock budget for `/api/chat`. 12B first-load often exceeds 3 minutes. */
+export const DEFAULT_OLLAMA_CHAT_TIMEOUT_MS = 600_000;
+
+export function ollamaChatTimeoutMs(env: NodeJS.ProcessEnv = process.env): number {
+	const raw = env.FILEPRESS_OLLAMA_TIMEOUT_MS?.trim();
+	if (!raw) return DEFAULT_OLLAMA_CHAT_TIMEOUT_MS;
+	const n = Number(raw);
+	if (!Number.isFinite(n) || n < 10_000) return DEFAULT_OLLAMA_CHAT_TIMEOUT_MS;
+	return Math.min(n, 3_600_000);
+}
+
+export function ollamaTimeoutMessage(opts: { host: string; model: string; timeoutMs: number }): string {
+	const secs = Math.round(opts.timeoutMs / 1000);
+	return (
+		`Ollama did not finish within ${secs}s (${opts.model} at ${opts.host}). ` +
+		`The model may still be loading — check \`ollama ps\`, then retry (a warm model is much faster). ` +
+		`Or raise FILEPRESS_OLLAMA_TIMEOUT_MS (milliseconds; default ${DEFAULT_OLLAMA_CHAT_TIMEOUT_MS}).`
+	);
+}
+
+export function isAbortLike(err: unknown): boolean {
+	if (!err || typeof err !== 'object') return false;
+	const name = 'name' in err ? String(err.name) : '';
+	const msg = 'message' in err ? String(err.message) : '';
+	return (
+		name === 'TimeoutError' ||
+		name === 'AbortError' ||
+		/aborted due to timeout/i.test(msg) ||
+		/The operation was aborted/i.test(msg)
+	);
+}
+
+/** Append one NDJSON line from Ollama `stream: true` `/api/chat`. */
+export function appendOllamaChatDelta(line: string, acc: { content: string }): void {
+	const trimmed = line.trim();
+	if (!trimmed) return;
+	const ev = JSON.parse(trimmed) as { message?: { content?: string }; error?: string };
+	if (ev.error) throw new Error(ev.error);
+	if (ev.message?.content) acc.content += ev.message.content;
+}
+
+async function readOllamaChatStream(
+	res: Response,
+	logLabel: string,
+	started: number
+): Promise<string> {
+	if (!res.body) throw new Error('Ollama chat returned an empty body');
+	const reader = res.body.getReader();
+	const decoder = new TextDecoder();
+	let buf = '';
+	const acc = { content: '' };
+	let lastLog = 0;
+	for (;;) {
+		const { done, value } = await reader.read();
+		if (done) break;
+		buf += decoder.decode(value, { stream: true });
+		const lines = buf.split(/\r?\n/);
+		buf = lines.pop() ?? '';
+		for (const line of lines) appendOllamaChatDelta(line, acc);
+		const elapsed = Date.now() - started;
+		if (elapsed - lastLog >= 15_000) {
+			lastLog = elapsed;
+			console.log(
+				`${logLabel}: still generating… ${Math.round(elapsed / 1000)}s, ${acc.content.length} chars`
+			);
+		}
+	}
+	if (buf.trim()) appendOllamaChatDelta(buf, acc);
+	return acc.content;
+}
+
 export async function generateDesignBrief(opts: {
 	host: string;
 	model: string;
@@ -73,8 +144,15 @@ export async function generateDesignBrief(opts: {
 	inspireSummaries: string[];
 	inspireSignals: InspirationSignals[];
 	seed: DesignBrief;
+	/** When true, unparseable model JSON fails instead of silently using the seed. */
+	strictParse?: boolean;
+	logLabel?: string;
 }): Promise<DesignBrief> {
 	const host = opts.host.replace(/\/+$/, '');
+	const timeoutMs = ollamaChatTimeoutMs();
+	const started = Date.now();
+	const logLabel = opts.logLabel ?? `filepress: Ollama ${opts.model} @ ${host}`;
+	console.log(`${logLabel}: starting chat (up to ${Math.round(timeoutMs / 1000)}s)`);
 	const prompt = `You are a design director restyling a personal Markdown blog (filepress Essay chrome).
 The seed brief below was extracted from inspiration site CSS/fonts. Refine it — keep the punch.
 Return ONLY JSON (no fences) with this shape:
@@ -126,33 +204,41 @@ Inspiration text snippets:
 ${opts.inspireSummaries.map((s, i) => `(${i + 1}) ${s}`).join('\n') || '(none)'}
 `;
 
-	const res = await fetch(`${host}/api/chat`, {
-		method: 'POST',
-		headers: { 'content-type': 'application/json' },
-		body: JSON.stringify({
-			model: opts.model,
-			stream: false,
-			format: 'json',
-			options: { temperature: 0.35 },
-			messages: [
-				{
-					role: 'system',
-					content:
-						'You output only valid JSON. Preserve dark inspiration palettes; do not flatten them into cream editorial.'
-				},
-				{ role: 'user', content: prompt }
-			]
-		}),
-		signal: AbortSignal.timeout(180_000)
-	});
-
-	if (!res.ok) {
-		const body = await res.text().catch(() => '');
-		throw new Error(`Ollama chat failed (${res.status}): ${body.slice(0, 400)}`);
-	}
+	let content = '';
+	try {
+		const res = await fetch(`${host}/api/chat`, {
+			method: 'POST',
+			headers: { 'content-type': 'application/json' },
+			body: JSON.stringify({
+				model: opts.model,
+				stream: true,
+				format: 'json',
+				options: { temperature: 0.35 },
+				messages: [
+					{
+						role: 'system',
+						content:
+							'You output only valid JSON. Preserve dark inspiration palettes; do not flatten them into cream editorial.'
+					},
+					{ role: 'user', content: prompt }
+				]
+			}),
+			signal: AbortSignal.timeout(timeoutMs)
+		});
+
+		if (!res.ok) {
+			const body = await res.text().catch(() => '');
+			throw new Error(`Ollama chat failed (${res.status}): ${body.slice(0, 400)}`);
+		}
 
-	const data = (await res.json()) as { message?: { content?: string } };
-	const content = data.message?.content ?? '';
+		content = await readOllamaChatStream(res, logLabel, started);
+		console.log(`${logLabel}: done in ${Math.round((Date.now() - started) / 1000)}s (${content.length} chars)`);
+	} catch (e) {
+		if (isAbortLike(e)) {
+			throw new Error(ollamaTimeoutMessage({ host, model: opts.model, timeoutMs }));
+		}
+		throw e;
+	}
 	try {
 		const refined = parseBriefJson(content);
 		// Never let the model drop fonts/googleHref from a rich seed
@@ -168,7 +254,13 @@ ${opts.inspireSummaries.map((s, i) => `(${i + 1}) ${s}`).join('\n') || '(none)'}
 			elevatedCards: refined.elevatedCards ?? opts.seed.elevatedCards
 		};
 	} catch (e) {
-		console.warn(`import: brief parse failed (${e}); using seed brief`);
+		const detail = e instanceof Error ? e.message : String(e);
+		if (opts.strictParse) {
+			throw new Error(
+				`Ollama returned a brief we could not parse (${detail}). First 200 chars: ${content.slice(0, 200)}`
+			);
+		}
+		console.warn(`import: brief parse failed (${detail}); using seed brief`);
 		return opts.seed;
 	}
 }

package/packages/import/src/redirects.ts

@@ -0,0 +1,17 @@
+import {
+	redirectsFromSourceUrls,
+	writingPostRedirects,
+	type RedirectRule
+} from '../../core/src/lib/redirects.ts';
+import type { SiteIR } from './ir.ts';
+
+/** Old source paths → FilePress URLs, plus `/writing` when home becomes a page. */
+export function importRedirectRules(
+	ir: Pick<SiteIR, 'posts' | 'pages' | 'homeMarkdown'>
+): RedirectRule[] {
+	const pairs = [
+		...ir.posts.map((p) => ({ sourceUrl: p.sourceUrl, destPath: `/posts/${p.slug}` })),
+		...ir.pages.map((p) => ({ sourceUrl: p.sourceUrl, destPath: `/${p.slug}` }))
+	];
+	return [...(ir.homeMarkdown ? writingPostRedirects() : []), ...redirectsFromSourceUrls(pairs)];
+}

package/packages/import/src/write-site.ts

@@ -9,9 +9,11 @@ import {
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { spawnSync } from 'node:child_process';
+import { serializeRedirects } from '../../core/src/lib/redirects.ts';
 import type { DesignBrief, ImportOptions, SiteIR } from './ir.ts';
 import { fetchBuffer } from './fetch.ts';
 import { fetchChosenImages } from './images.ts';
+import { importRedirectRules } from './redirects.ts';
 import { themeCssFromBrief } from './theme.ts';
 
 function writeAttribution(metaDir: string, ir: SiteIR) {
@@ -178,8 +180,8 @@ Generated: ${new Date().toISOString()}
 
 ## URL remaps
 
-Posts move to \`/posts/<slug>\` (filepress default). If you need old paths (e.g. \`/writing/…\`), add Cloudflare Pages redirects.
-
+Posts live at \`/posts/<slug>\`. Old paths are written to \`static/_redirects\` (Cloudflare Pages / Netlify).
+${ir.homeMarkdown ? '\nLong home bio became `pages/home.md`; the post index is `/posts`.\n' : ''}
 ${ir.posts.map((p) => `- \`${p.sourceUrl}\` → \`/posts/${p.slug}\``).join('\n')}
 
 ${ir.pages.map((p) => `- \`${p.sourceUrl}\` → \`/${p.slug}\``).join('\n')}
@@ -295,6 +297,24 @@ ${body}
 		writeFileSync(join(out, 'pages', `${page.slug}.md`), md);
 	}
 
+	if (ir.homeMarkdown && !ir.pages.some((p) => p.slug === 'home')) {
+		writeFileSync(
+			join(out, 'pages', 'home.md'),
+			`---
+title: ${yamlQuote(ir.identity.title)}
+order: 0
+---
+
+${ir.homeMarkdown}
+`
+		);
+	}
+
+	const redirectRules = importRedirectRules(ir);
+	if (redirectRules.length) {
+		writeFileSync(join(staticDir, '_redirects'), serializeRedirects(redirectRules));
+	}
+
 	const topicsLit = ir.topics
 		.map((t) => `\t\t{ label: ${yamlQuote(t.label)}, tag: ${yamlQuote(t.tag)} }`)
 		.join(',\n');
@@ -302,6 +322,8 @@ ${body}
 		.map((n) => `\t\t{ label: ${yamlQuote(n.label)}, href: ${yamlQuote(n.href)} }`)
 		.join(',\n');
 	const ledeLine = ir.lede ? `\n\tlede: ${yamlQuote(ir.lede)},` : '';
+	const useHomePage = Boolean(ir.homeMarkdown) || ir.pages.some((p) => p.slug === 'home');
+	const homePageLine = useHomePage ? `\n\thomePage: 'home',` : '';
 	const logo = activeBrief?.images?.logo;
 	const logoLine = logo ? `\n\tlogo: ${yamlQuote(logo)},` : '';
 
@@ -313,7 +335,7 @@ export default defineFilepressConfig({
 	title: ${yamlQuote(title)},
 	description: ${yamlQuote(ir.identity.description)},
 	url: ${yamlQuote(url)},
-	author: ${yamlQuote(author)},${ledeLine}${logoLine}
+	author: ${yamlQuote(author)},${ledeLine}${homePageLine}${logoLine}
 	nav: [
 ${navLit}
 	],

package/scripts/copy-path-mounts.mjs

@@ -1,7 +1,8 @@
 /**
  * Post-`vite build` steps for a FilePress site:
  *   1. Write default `build/_headers` unless the site already provided one
- *   2. Copy `paths` mounts (from `.filepress/path-mounts.json`)
+ *   2. Merge engine `_redirects` (from `.filepress/redirects.txt`) into `build/_redirects`
+ *   3. Copy `paths` mounts (from `.filepress/path-mounts.json`)
  *
  * Usage: node scripts/copy-path-mounts.mjs <siteRoot>
  */
@@ -30,6 +31,34 @@ if (existsSync(headersDest)) {
 	console.log('filepress: wrote default _headers');
 }
 
+const redirectsPlan = join(siteRoot, '.filepress', 'redirects.txt');
+const redirectsDest = join(buildDir, '_redirects');
+if (existsSync(redirectsPlan)) {
+	const planned = readFileSync(redirectsPlan, 'utf8').trim();
+	if (planned) {
+		const existing = existsSync(redirectsDest) ? readFileSync(redirectsDest, 'utf8') : '';
+		const have = new Set(
+			existing
+				.split(/\r?\n/)
+				.map((line) => line.replace(/#.*$/, '').trim())
+				.filter(Boolean)
+				.map((line) => line.split(/\s+/).slice(0, 2).join('\0'))
+		);
+		const add = planned
+			.split(/\r?\n/)
+			.map((line) => line.trim())
+			.filter(Boolean)
+			.filter((line) => !have.has(line.split(/\s+/).slice(0, 2).join('\0')));
+		if (add.length) {
+			const prefix = existing.trimEnd();
+			writeFileSync(redirectsDest, prefix ? `${prefix}\n${add.join('\n')}\n` : `${add.join('\n')}\n`);
+			console.log(`filepress: wrote ${add.length} _redirects rule(s)`);
+		} else {
+			console.log('filepress: kept site _redirects');
+		}
+	}
+}
+
 if (!existsSync(cachePath)) {
 	process.exit(0);
 }

package/scripts/create-site.mjs

@@ -216,6 +216,7 @@ Any static host: publish the \`build/\` folder. Details: https://getfilepress.co
 	console.log(`Next:`);
 	console.log(`  cd ${relToEngine} && pnpm install   # if not already`);
 	console.log(`  cd ${target} && pnpm install && pnpm dev`);
+	console.log(`  filepress new "My Post"`);
 } else {
 	writeFileSync(
 		join(target, 'tsconfig.json'),

package/scripts/filepress.mjs

@@ -145,6 +145,13 @@ function runImport(argv) {
 	runNodeBin('tsx', 'tsx', [importCli, ...argv], { cwd: packageRoot });
 }
 
+/** `filepress new "Title"` → dated post skeleton next to filepress.config.ts. */
+function runNew(argv) {
+	const cli = join(scriptDir, 'new-post.ts');
+	if (!existsSync(cli)) fail(`new-post CLI missing at ${cli}`);
+	runNodeBin('tsx', 'tsx', [cli, ...argv], { cwd: process.cwd() });
+}
+
 function listSites() {
 	if (!existsSync(sitesDir)) return [];
 	return readdirSync(sitesDir).filter((name) => {
@@ -173,6 +180,8 @@ const argv = process.argv.slice(2);
 await ensureEmbeddedLinks();
 if (argv[0] === 'import') {
 	runImport(argv.slice(1));
+} else if (argv[0] === 'new') {
+	runNew(argv.slice(1));
 } else {
 	runSiteCommand(argv);
 }
@@ -190,6 +199,7 @@ function runSiteCommand(argv) {
 				`  filepress preview [--port 27777]  # serves <site>/build (default 27777)\n` +
 				`  filepress dev --port <n> [--host]   # vite dev; optional fixed port / LAN\n` +
 				`  filepress import --source <url> [--inspire <url>] …\n` +
+				`  filepress new "Post title" [--draft] [--site name | --root path]\n` +
 				`monorepo sites: ${listSites().join(', ') || '(none)'}`
 		);
 	}
@@ -238,20 +248,20 @@ function runSiteCommand(argv) {
 			);
 		}
 		const port = args.port || process.env.FILEPRESS_PORT || '27777';
-		console.log(`filepress: preview http://localhost:${port} → ${buildDir}`);
-		runNodeBin(
-			'sirv-cli',
-			'sirv',
-			[
-				buildDir,
-				'--dev',
-				'--port',
-				String(port),
-				'--host',
-				args.host && args.host !== 'true' ? args.host : args.host === 'true' ? '0.0.0.0' : '127.0.0.1'
-			],
-			{ cwd: appDir, env }
-		);
+		const host =
+			args.host && args.host !== 'true' ? args.host : args.host === 'true' ? '0.0.0.0' : '127.0.0.1';
+		const previewScript = join(scriptDir, 'preview.mjs');
+		if (!existsSync(previewScript)) fail(`preview script missing at ${previewScript}`);
+		const child = spawn(process.execPath, [previewScript, buildDir, String(port), host], {
+			cwd: packageRoot,
+			env,
+			stdio: 'inherit',
+			shell: false
+		});
+		child.on('exit', (code, signal) => {
+			if (signal) process.kill(process.pid, signal);
+			process.exit(code ?? 1);
+		});
 		return;
 	}
 

package/scripts/new-post.ts

@@ -0,0 +1,125 @@
+/**
+ * Stamp a dated Markdown post into a site's posts/ folder.
+ *
+ *   filepress new "Post title"
+ *   filepress new "Post title" --site demo
+ *   filepress new "Post title" --draft
+ */
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { slugify } from '../packages/core/src/lib/content/parse.ts';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const packageRoot = resolve(here, '..');
+
+export type NewPostArgs = {
+	title: string;
+	site: string | null;
+	root: string | null;
+	draft: boolean;
+	help: boolean;
+};
+
+export function parseNewArgs(argv: string[]): NewPostArgs {
+	const args: NewPostArgs = { title: '', site: null, root: null, draft: false, help: false };
+	const titleParts: string[] = [];
+	for (let i = 0; i < argv.length; i++) {
+		const a = argv[i];
+		if (a === '--help' || a === '-h') args.help = true;
+		else if (a === '--draft') args.draft = true;
+		else if (a === '--site') args.site = argv[++i] ?? '';
+		else if (a?.startsWith('--site=')) args.site = a.slice('--site='.length);
+		else if (a === '--root') args.root = argv[++i] ?? '';
+		else if (a?.startsWith('--root=')) args.root = a.slice('--root='.length);
+		else if (a.startsWith('-')) throw new Error(`unknown flag: ${a}`);
+		else titleParts.push(a);
+	}
+	args.title = titleParts.join(' ').trim().replace(/^["']|["']$/g, '');
+	return args;
+}
+
+export function resolveNewSiteRoot(args: Pick<NewPostArgs, 'site' | 'root'>, cwd = process.cwd()): string {
+	if (args.root) return resolve(cwd, args.root);
+	if (args.site) return join(packageRoot, 'sites', args.site);
+	return resolve(cwd);
+}
+
+export function isoDate(now = new Date()): string {
+	return now.toISOString().slice(0, 10);
+}
+
+export function newPostFilename(title: string, date: string): { slug: string; filename: string } {
+	const slug = slugify(title);
+	if (!slug) throw new Error('title did not produce a slug');
+	return { slug, filename: `${date}-${slug}.md` };
+}
+
+export function renderNewPost(title: string, date: string, draft: boolean): string {
+	const draftLine = draft ? 'draft: true\n' : '';
+	return `---
+title: ${JSON.stringify(title)}
+date: ${date}
+${draftLine}description: ""
+tags: []
+---
+
+`;
+}
+
+export function writeNewPost(
+	siteRoot: string,
+	title: string,
+	opts: { draft?: boolean; now?: Date } = {}
+): { path: string; filename: string } {
+	const date = isoDate(opts.now);
+	const { filename } = newPostFilename(title, date);
+	const postsDir = join(siteRoot, 'posts');
+	mkdirSync(postsDir, { recursive: true });
+	const dest = join(postsDir, filename);
+	if (existsSync(dest)) throw new Error(`already exists: posts/${filename}`);
+	writeFileSync(dest, renderNewPost(title, date, Boolean(opts.draft)));
+	return { path: dest, filename };
+}
+
+function usage(): string {
+	return `Usage: filepress new "Post title" [--draft] [--site name | --root path]
+
+Writes posts/YYYY-MM-DD-slug.md next to filepress.config.ts.
+Does not commit or deploy.`;
+}
+
+export function main(argv = process.argv.slice(2)): number {
+	let args: NewPostArgs;
+	try {
+		args = parseNewArgs(argv);
+	} catch (err) {
+		console.error(`filepress new: ${err instanceof Error ? err.message : err}`);
+		return 1;
+	}
+	if (args.help) {
+		console.log(usage());
+		return 0;
+	}
+	if (!args.title) {
+		console.error(usage());
+		return 1;
+	}
+	const siteRoot = resolveNewSiteRoot(args);
+	if (!existsSync(join(siteRoot, 'filepress.config.ts'))) {
+		console.error(`filepress new: no filepress.config.ts in ${siteRoot}`);
+		return 1;
+	}
+	try {
+		const written = writeNewPost(siteRoot, args.title, { draft: args.draft });
+		console.log(`Wrote posts/${written.filename}`);
+		return 0;
+	} catch (err) {
+		console.error(`filepress new: ${err instanceof Error ? err.message : err}`);
+		return 1;
+	}
+}
+
+if (process.argv[1] && resolve(process.argv[1]) === resolve(fileURLToPath(import.meta.url))) {
+	process.exitCode = main();
+}

package/scripts/preview.mjs

@@ -0,0 +1,95 @@
+/**
+ * Serve a FilePress `build/` folder the way a static host does:
+ * pretty URLs (`/about` → `about.html`) and `404.html` for unknown paths.
+ *
+ * Usage: node scripts/preview.mjs <buildDir> [port] [host]
+ */
+import { createServer } from 'node:http';
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { extname, join, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const MIME = {
+	'.html': 'text/html; charset=utf-8',
+	'.css': 'text/css; charset=utf-8',
+	'.js': 'text/javascript; charset=utf-8',
+	'.mjs': 'text/javascript; charset=utf-8',
+	'.json': 'application/json',
+	'.svg': 'image/svg+xml',
+	'.xml': 'application/xml',
+	'.txt': 'text/plain; charset=utf-8',
+	'.woff2': 'font/woff2',
+	'.woff': 'font/woff',
+	'.png': 'image/png',
+	'.jpg': 'image/jpeg',
+	'.jpeg': 'image/jpeg',
+	'.webp': 'image/webp',
+	'.gif': 'image/gif',
+	'.ico': 'image/x-icon',
+	'.map': 'application/json'
+};
+
+const isMain =
+	Boolean(process.argv[1]) && resolve(process.argv[1]) === resolve(fileURLToPath(import.meta.url));
+
+function underRoot(root, abs) {
+	return abs === root || abs.startsWith(root + sep);
+}
+
+/** Map a request path to a file under `root`, or null. */
+export function resolveBuildFile(root, urlPath) {
+	const pathname = decodeURIComponent((urlPath.split('?')[0] || '/'));
+	const rel = pathname.replace(/^\/+/, '');
+	const abs = resolve(root, rel);
+	if (!underRoot(root, abs)) return null;
+	try {
+		const st = statSync(abs);
+		if (st.isFile()) return abs;
+		if (st.isDirectory()) {
+			const index = join(abs, 'index.html');
+			if (existsSync(index)) return index;
+		}
+	} catch {
+		/* pretty URL or sibling .html next to an empty adapter dir */
+	}
+	if (!extname(abs) && existsSync(`${abs}.html`)) return `${abs}.html`;
+	return null;
+}
+
+function send(res, file, status = 200) {
+	const type = MIME[extname(file).toLowerCase()] || 'application/octet-stream';
+	res.writeHead(status, { 'content-type': type, 'cache-control': 'no-store' });
+	res.end(readFileSync(file));
+}
+
+export function startPreview(root, port = 27777, host = '127.0.0.1') {
+	const site = resolve(root);
+	if (!existsSync(join(site, 'index.html'))) {
+		throw new Error(`filepress preview: no index.html in ${site}`);
+	}
+	const fallback = join(site, '404.html');
+	return createServer((req, res) => {
+		const file = resolveBuildFile(site, req.url || '/');
+		if (file && existsSync(file)) {
+			send(res, file);
+			return;
+		}
+		if (existsSync(fallback)) {
+			send(res, fallback, 404);
+			return;
+		}
+		res.writeHead(404, { 'content-type': 'text/plain; charset=utf-8' });
+		res.end('Not found');
+	}).listen(port, host, () => {
+		console.log(`filepress: preview http://${host}:${port} → ${site}`);
+	});
+}
+
+if (isMain) {
+	try {
+		startPreview(process.argv[2] ?? '', Number(process.argv[3] ?? 27777), process.argv[4] ?? '127.0.0.1');
+	} catch (err) {
+		console.error(err instanceof Error ? err.message : err);
+		process.exit(1);
+	}
+}

package/packages/app/README.md

@@ -1,19 +0,0 @@
-# @filepress/app
-
-The only SvelteKit application in the filepress monorepo. All routes, layouts, and
-Kit wiring live here. Content sites under [`../../sites`](../../sites) provide:
-
-- `filepress.config.ts` — identity
-- `posts/` — Markdown
-- `static/` — favicon, images (optional)
-
-## Run against a site
-
-From the repo root (do not run vite directly without `FILEPRESS_SITE_ROOT`):
-
-```bash
-pnpm filepress dev --site demo
-pnpm filepress build --site demo
-```
-
-Build output is written to `sites/<name>/build/`.

package/packages/core/README.md

@@ -1,29 +0,0 @@
-# @filepress/core
-
-The reusable filepress engine. Sites under [`../../sites`](../../sites) depend on
-it (via `workspace:*` in this monorepo) and provide their own SvelteKit routes,
-content, and `filepress.config.ts`.
-
-## Entry points
-
-- `@filepress/core` — client-safe: `PostCard`, `PostIndex`, `Newsletter`,
-  `SiteHeader`, `SiteFooter`, `defineFilepressConfig`, `absoluteUrl`,
-  `formatDate`, and shared types.
-- `@filepress/core/server` — server-only (filesystem access): `createContent`,
-  `renderMarkdown`, `buildRssXml` / `buildSitemapXml` / `buildRobotsTxt`, and the
-  content-parsing primitives. Import only from `+page.server.ts`, `+server.ts`,
-  or `*.server.ts` modules.
-- `@filepress/core/theme` — self-hosted fonts + the Essay theme CSS. Import once
-  from a site's root layout.
-
-## Why routes live in the site
-
-SvelteKit's router is per-project, so each site owns its `src/routes/`. Those
-route files stay thin: they call `createContent(...)` + core builders and render
-core components. `scripts/create-site.mjs` scaffolds them.
-
-## Testing
-
-`pnpm --filter @filepress/core test` runs the unit tests over the pure parsing
-and figure-transform logic. Type-checking of the whole library happens through
-each site's `svelte-check`.