Add new-post scaffolding script

[mahata]

Summary

• Add a TypeScript script to scaffold new blog posts with frontmatter pre-filled
• Add 17 unit tests covering the script's utility functions

Usage

npm run new-post -- "My Post Title"
npm run new-post -- "My Draft Post" --draft

Creates a file like src/content/blog/2026-04-07-my-post-title.md with:

---
title: My Post Title
date: 2026-04-07
---

The script errors if no title is given or if the file already exists.

Changes

File	Change
scripts/new-post.ts	New — scaffolding script (slugify, date format, frontmatter generation, file creation)
scripts/new-post.test.ts	New — 17 unit tests for all exported utility functions
package.json	Add tsx dev dependency; add new-post script
README.md	Document the npm run new-post command

[Copilot]

Pull request overview

Adds a new TypeScript CLI script to scaffold blog posts in src/content/blog/ with pre-filled frontmatter, along with unit tests and npm wiring/documentation.

Changes:

• Add scripts/new-post.ts to generate dated, slugified filenames and frontmatter (optionally draft: true)
• Add scripts/new-post.test.ts (Vitest) covering the exported helper functions
• Add tsx and an npm new-post script; document usage in the README

Show a summary per file

File	Description
scripts/new-post.ts	New CLI scaffolding script (slug/date/frontmatter + file creation)
scripts/new-post.test.ts	New Vitest unit tests for exported helpers
package.json	Adds tsx and npm run new-post entry
README.md	Documents the new scaffolding command
package-lock.json	Lockfile updates for tsx and transitive deps

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comments suppressed due to low confidence (1)

scripts/new-post.ts:59

• buildFrontmatter(title, new Date(), draft) should use the same captured Date instance as the filename to ensure the date: field matches the file prefix in edge cases (e.g., around midnight).

  const content = buildFrontmatter(title, new Date(), draft);
  fs.writeFileSync(filepath, content, 'utf-8');

• Files reviewed: 4/5 changed files
• Comments generated: 5

[Copilot]

import.meta.dirname is not a standard Node ESM feature and appears unused elsewhere in the repo; running this script in Node/tsx will likely throw at startup. Derive the directory from import.meta.url instead (e.g., via fileURLToPath + path.dirname).

Suggested change

	const BLOG_DIR = path.join(import.meta.dirname, '..', 'src', 'content', 'blog');
	import { fileURLToPath } from 'node:url';
	const currentFilePath = fileURLToPath(import.meta.url);
	const currentDir = path.dirname(currentFilePath);
	const BLOG_DIR = path.join(currentDir, '..', 'src', 'content', 'blog');

[Copilot]

The executable guard import.meta.url.endsWith(process.argv[1]) is brittle (notably on Windows where process.argv[1] is typically a C:\... path while import.meta.url is a file:///C:/... URL). Compare normalized file paths instead (e.g., fileURLToPath(import.meta.url) vs path.resolve(process.argv[1])).

[Copilot]

If slugify(title) returns an empty string (e.g., a title containing only characters outside [a-z0-9], such as emoji or non-Latin text), buildFilename will produce a name like YYYY-MM-DD-.md. Consider validating that the slug is non-empty and exiting with a clear error (or using a different slugging approach that supports Unicode).

[Copilot]

new Date() is used to compute the filename; for consistency, capture a single now value once in main() and reuse it for both filename and frontmatter generation (avoids mismatches if the script runs across midnight).

This issue also appears on line 58 of the same file.

[Copilot]

The existsSync pre-check is not atomic with the subsequent write, so the file could still be overwritten if it appears between the check and the write. Prefer an atomic create (e.g., open/write with 'wx') and handle the EEXIST error.

Suggested change

	if (fs.existsSync(filepath)) {
	console.error(`Error: File already exists: ${filepath}`);
	process.exit(1);
	}
	const content = buildFrontmatter(title, new Date(), draft);
	fs.writeFileSync(filepath, content, 'utf-8');
	const content = buildFrontmatter(title, new Date(), draft);
	try {
	fs.writeFileSync(filepath, content, { encoding: 'utf-8', flag: 'wx' });
	} catch (error: unknown) {
	if (
	typeof error === 'object' &&
	error !== null &&
	'code' in error &&
	error.code === 'EEXIST'
	) {
	console.error(`Error: File already exists: ${filepath}`);
	process.exit(1);
	}
	throw error;
	}