mailwoman 8.0.0 → 8.2.0

package/api-engine.ts

@@ -34,6 +34,9 @@ import { recordTimed } from "@mailwoman/api-kit"
 import { decodeAsTuples, decodeAsXML } from "@mailwoman/core"
 import type { AddressTree } from "@mailwoman/core/decoder"
 import { $public } from "@mailwoman/core/env"
+import { deriveInputMode } from "@mailwoman/core/pipeline"
+import { classifyKindSync } from "@mailwoman/kind-classifier"
+import { computeQueryShape } from "@mailwoman/query-shape"
 import { createWOFResolver, type Resolver, type ResolveOpts } from "@mailwoman/resolver"
 
 import { readReleaseManifest } from "./data-release.ts"
@@ -47,10 +50,14 @@ import {
 import { INTERP_RADIUS_CALIBRATION, interpCalibrationForRegion } from "./interp-calibration.ts"
 import { createResolverBackend, mailwomanDataRoot, resolveCandidateDBPath, wofShardPaths } from "./resolver-backend.ts"
 
-/** Default per-state shard root + interp calibration — mirrors the express server's defaults (`GeocodeRouter.ts`). */
+/**
+ * Default per-state shard root + interp calibration — mirrors the express server's defaults (`GeocodeRouter.ts`).
+ */
 const DATA_ROOT = mailwomanDataRoot()
 
-/** The classifier/resolver/shard bundle `geocode`/`batch`/`resolveTree`/`reload` close over. */
+/**
+ * The classifier/resolver/shard bundle `geocode`/`batch`/`resolveTree`/`reload` close over.
+ */
 interface GeocodeDepsBundle {
 	classifier: GeocodeClassifier
 	resolver: Resolver
@@ -58,7 +65,9 @@ interface GeocodeDepsBundle {
 	defaultCountry?: string
 }
 
-/** Same WOF-path resolution as the express `GeocodeRouter`/`HealthRouter` (env override, else the conventional shards). */
+/**
+ * Same WOF-path resolution as the express `GeocodeRouter`/`HealthRouter` (env override, else the conventional shards).
+ */
 function wofPaths(): string[] {
 	const env = $public.MAILWOMAN_WOF_DB
 
@@ -115,6 +124,7 @@ function readModelCard(): Record<string, unknown> | null {
 	} catch {
 		/* package not resolvable from here — fall through */
 	}
+
 	candidates.push("neural-weights-en-us/model-card.json")
 
 	for (const p of candidates) {
@@ -172,18 +182,27 @@ function buildHealthData(): HealthData {
 	}
 }
 
-/** One geocode call over the shared deps. Ported from `GeocodeRouter`'s `oneGeocode`. */
-function oneGeocode(deps: GeocodeDepsBundle, address: string): Promise<GeocodeResult> {
+/**
+ * One geocode call over the shared deps. Ported from `GeocodeRouter`'s `oneGeocode`.
+ */
+function oneGeocode(
+	deps: GeocodeDepsBundle,
+	address: string,
+	inputMode?: "fragmented" | "formatted"
+): Promise<GeocodeResult> {
 	return geocodeAddress(address, {
 		classifier: deps.classifier,
 		resolver: deps.resolver,
 		shards: deps.shards.for,
 		defaultCountry: deps.defaultCountry,
 		interpCalibration: INTERP_RADIUS_CALIBRATION,
+		inputMode,
 	})
 }
 
-/** Pull the street node's resolution tier (if any) for the metric. Ported verbatim from `GeocodeRouter`. */
+/**
+ * Pull the street node's resolution tier (if any) for the metric. Ported verbatim from `GeocodeRouter`.
+ */
 function collectStreetTier(
 	node: AddressTree["roots"][number]
 ): Array<"address_point" | "interpolated" | "street" | "admin"> {
@@ -204,7 +223,9 @@ function collectStreetTier(
 	return out
 }
 
-/** {@link createServeEngine}'s return value. */
+/**
+ * {@link createServeEngine}'s return value.
+ */
 export interface ServeEngine {
 	engine: MailwomanAPIEngine
 	preflight: { ok: true } | { ok: false; message: string }
@@ -232,8 +253,16 @@ export async function createServeEngine(): Promise<ServeEngine> {
 		classifier = await neuralMod.NeuralAddressClassifier.loadFromWeights({ locale: "en-US" })
 
 		const parseClassifier = classifier
+
 		parse = async (address, opts) => {
-			const tree = await parseClassifier.parse(address, { postcodeRepair: true })
+			// Decision A: explicit wire register wins; unset → the kind classifier decides (same derivation
+			// as the runtime pipeline / geocode-core — /v1/parse is the "plain parse" endpoint class).
+			const shape = computeQueryShape(address)
+
+			const inputMode =
+				opts.inputMode ?? deriveInputMode(classifyKindSync({ raw: address, normalized: address }, shape).kind)
+
+			const tree = await parseClassifier.parse(address, { postcodeRepair: true, inputMode })
 
 			return {
 				input: address,
@@ -271,7 +300,7 @@ export async function createServeEngine(): Promise<ServeEngine> {
 	// This gate governs geocode/batch/resolveTree/reload ONLY — `parse` is already wired above and unaffected.
 	const candidateDb = resolveCandidateDBPath()
 
-	if (paths.length === 0 && !candidateDb) {
+	if (!paths.length && !candidateDb) {
 		console.error("createServeEngine: no WOF DBs found — set MAILWOMAN_WOF_DB or MAILWOMAN_CANDIDATE_DB")
 
 		return { engine: { parse, health }, preflight: { ok: false, message: buildPreflightMessage() } }
@@ -285,8 +314,8 @@ export async function createServeEngine(): Promise<ServeEngine> {
 	// Route records the whole-call metric already (`@mailwoman/api`'s `routes.ts`) — the engine records nothing extra
 	// here. Ported from `GeocodeRouter`'s `singleHandler`. The cast mirrors `@mailwoman/api/routes.ts`'s established
 	// "documented wire shape looser than the domain type" idiom — `GeocodeOutcome` is a deliberately loose passthrough.
-	const geocode: MailwomanAPIEngine["geocode"] = async (address) =>
-		(await oneGeocode(deps, address)) as unknown as GeocodeOutcome
+	const geocode: MailwomanAPIEngine["geocode"] = async (address, opts) =>
+		(await oneGeocode(deps, address, opts?.inputMode)) as unknown as GeocodeOutcome
 
 	// Sequential loop — results land in input order; a thrown row is isolated to its own
 	// `{ input, error }` slot. Rows are trimmed here (the route passes the raw validated array through).
@@ -297,7 +326,9 @@ export async function createServeEngine(): Promise<ServeEngine> {
 	// and `node:sqlite` reads are synchronous. The pool bought nothing but the appearance of tuning, so
 	// it's a plain loop now. To actually parallelize, cross a thread boundary — see
 	// `mailwoman/geocode-stream.ts`. Receipts: `docs/articles/plan/reference/performance.mdx`.
-	const batch: MailwomanAPIEngine["batch"] = async (addresses) => {
+	const batch: MailwomanAPIEngine["batch"] = async (addresses, opts) => {
+		// Decision A endpoint default: batch rows are the record register.
+		const inputMode = opts?.inputMode ?? "formatted"
 		const inputs = addresses.map((a) => a.trim())
 		const results: BatchRow[] = new Array<BatchRow>(inputs.length)
 
@@ -306,12 +337,12 @@ export async function createServeEngine(): Promise<ServeEngine> {
 			const t0 = performance.now()
 
 			try {
-				const result = await oneGeocode(deps, input)
+				const result = await oneGeocode(deps, input, inputMode)
 				recordTimed(performance.now() - t0, result.resolution_tier)
 				results[i] = result as unknown as GeocodeOutcome
-			} catch (err) {
+			} catch (error) {
 				recordTimed(performance.now() - t0, "error")
-				results[i] = { input, error: err instanceof Error ? err.message : String(err) }
+				results[i] = { input, error: error instanceof Error ? error.message : String(error) }
 			}
 		}
 
@@ -328,19 +359,25 @@ export async function createServeEngine(): Promise<ServeEngine> {
 		try {
 			const slug = regionSlugFromTree(tree)
 			const { addressPoints, interpolation } = deps.shards.for(slug)
+
 			const opts: ResolveOpts = {
 				...incomingOpts,
 				defaultCountry: incomingOpts.defaultCountry ?? deps.defaultCountry,
 				...(addressPoints ? { addressPoints } : {}),
+				// #374 calibration ladder: explicit incoming factor (instrument override, survives the spread) →
+				// the artifact's own header value (`interpolation.radiusCalibration`, read at shard open — the
+				// resolver consumes it directly, nothing passed here) → the in-code per-region table for shards
+				// predating the `interp_calibration` metadata table.
 				...(interpolation
 					? {
 							interpolation,
-							interpolationRadiusCalibration:
-								incomingOpts.interpolationRadiusCalibration ??
-								interpCalibrationForRegion(INTERP_RADIUS_CALIBRATION, slug),
+							...(incomingOpts.interpolationRadiusCalibration == null && interpolation.radiusCalibration == null
+								? { interpolationRadiusCalibration: interpCalibrationForRegion(INTERP_RADIUS_CALIBRATION, slug) }
+								: {}),
 						}
 					: {}),
 			}
+
 			const resolved = await deps.resolver.resolveTree(tree, opts)
 			// Best-effort tier metric: read the street node's stamped tier (matches the geocode path).
 			const street = resolved.roots.flatMap((r) => collectStreetTier(r)).find(Boolean)
@@ -349,9 +386,9 @@ export async function createServeEngine(): Promise<ServeEngine> {
 			const outcome: ResolveTreeOutcome = { tree: resolved }
 
 			return outcome
-		} catch (err) {
+		} catch (error) {
 			recordTimed(performance.now() - t0, "error")
-			throw err
+			throw error
 		}
 	}
 

package/cli-kit/index.ts

@@ -18,7 +18,7 @@ import type * as zod from "zod"
 /**
  * Type-helper to infer the positional arguments of a command.
  */
-export type PositionalArguments<T extends zod.ZodTypeAny> = {
+export interface PositionalArguments<T extends zod.ZodTypeAny> {
 	args: zod.infer<T>
 }
 
@@ -30,10 +30,10 @@ export type PositionalCommandComponent<T extends zod.ZodTypeAny> = React.FC<Posi
 /**
  * Type-helper to infer the options of a command.
  */
-export type CommandProps<
+export interface CommandProps<
 	OptionProps extends zod.ZodObject,
 	PositionalProps extends zod.ZodTypeAny | unknown = unknown,
-> = {
+> {
 	options: zod.infer<OptionProps>
 	args: PositionalProps extends zod.ZodTypeAny ? zod.infer<PositionalProps> : unknown[]
 }
@@ -46,7 +46,9 @@ export type CommandComponent<
 	PositionalProps extends zod.ZodTypeAny | unknown = unknown,
 > = React.FC<CommandProps<OptionProps, PositionalProps>>
 
-/** The lifecycle of a command's one-shot async task. */
+/**
+ * The lifecycle of a command's one-shot async task.
+ */
 export type CommandTaskState<T> =
 	| { status: "running" }
 	| { status: "done"; result: T }
@@ -79,6 +81,7 @@ export function useCommandTask<T>(task: () => Promise<T>, exitCode?: (result: T)
 
 	return state
 }
+
 /* oxlint-enable react-hooks/exhaustive-deps */
 
 /**
@@ -93,7 +96,9 @@ export function commandError(message: string): Error {
 	return error
 }
 
-/** One ✓/✗ line in a {@linkcode CheckList}. */
+/**
+ * One ✓/✗ line in a {@linkcode CheckList}.
+ */
 export interface Check {
 	ok: boolean
 	check: string
@@ -112,6 +117,7 @@ export function CheckList({ checks, verdict }: { checks: readonly Check[]; verdi
 			`${c.ok ? "✓" : "✗"} ${c.check}${c.detail ? `: ${c.detail}` : ""}`
 		)
 	)
+
 	const summary =
 		verdict === undefined
 			? null

package/cli-kit/weights-guard.tsx

@@ -29,10 +29,14 @@ import { resolveWeights, weightsCacheDir, weightsPackageName } from "@mailwoman/
 import { Box, Text, useInput, useStdin } from "ink"
 import React, { useEffect, useState } from "react"
 
-/** How the guard resolved, handed to the render prop. */
+/**
+ * How the guard resolved, handed to the render prop.
+ */
 export type WeightsOutcome = "neural" | "declined" | "unavailable"
 
-/** Probe whether weights resolve for a locale without loading the model. Cheap (fs checks only). */
+/**
+ * Probe whether weights resolve for a locale without loading the model. Cheap (fs checks only).
+ */
 export function probeWeights(locale?: string, cacheRoot?: string): { ok: boolean; detail?: string } {
 	try {
 		resolveWeights({ locale, ...(cacheRoot ? { cacheRoot } : {}) })
@@ -43,7 +47,9 @@ export function probeWeights(locale?: string, cacheRoot?: string): { ok: boolean
 	}
 }
 
-/** The npm invocation that populates the weights cache. Pure — unit-tested; `spec` defaults to `latest`. */
+/**
+ * The npm invocation that populates the weights cache. Pure — unit-tested; `spec` defaults to `latest`.
+ */
 export function buildWeightsInstallArgs(locale: string | undefined, cacheRoot: string, spec = "latest"): string[] {
 	return [
 		"install",
@@ -117,15 +123,25 @@ export function downloadWeights(
 }
 
 export interface WeightsGuardProps {
-	/** Locale whose weights package guards this command (defaults to en-US resolution rules). */
+	/**
+	 * Locale whose weights package guards this command (defaults to en-US resolution rules).
+	 */
 	locale?: string
-	/** `--download-weights`: skip the prompt, download immediately. */
+	/**
+	 * `--download-weights`: skip the prompt, download immediately.
+	 */
 	autoDownload?: boolean
-	/** `--degraded`: skip the prompt, hand the caller the declined outcome directly. */
+	/**
+	 * `--degraded`: skip the prompt, hand the caller the declined outcome directly.
+	 */
 	forceDegraded?: boolean
-	/** Test seam / non-default cache root. */
+	/**
+	 * Test seam / non-default cache root.
+	 */
 	cacheRoot?: string
-	/** Renders once the guard settles. */
+	/**
+	 * Renders once the guard settles.
+	 */
 	children: (outcome: WeightsOutcome) => React.ReactElement
 }
 

package/commands/autocomplete.tsx

@@ -27,6 +27,9 @@ export { ArgumentsSchema as args, AutocompleteConfigSchema as options }
 
 const ArgumentsSchema = zod.array(zod.string().describe("Prefix string to complete"))
 
+/**
+ * Config accepted by `mailwoman autocomplete`, validated before the server starts so a bad flag fails fast.
+ */
 export const AutocompleteConfigSchema = zod.object({
 	limit: zod.coerce
 		.number()
@@ -46,7 +49,9 @@ export const AutocompleteConfigSchema = zod.object({
 	json: zod.boolean().optional().default(false).describe("Emit results as a JSON array instead of formatted text"),
 })
 
-/** Resolve the FST binary path from explicit flag, env var, or the staged default. */
+/**
+ * Resolve the FST binary path from explicit flag, env var, or the staged default.
+ */
 export function resolveFSTPath(explicitPath?: string): string {
 	return explicitPath ?? $public.MAILWOMAN_FST_BIN ?? "/tmp/v440-stage/en-us/v4.4.0/fst-en-US.bin"
 }
@@ -82,8 +87,8 @@ export async function runAutocomplete(
 
 	try {
 		buf = readFileSync(fstPath)
-	} catch (err) {
-		const msg = err instanceof Error ? err.message : String(err)
+	} catch (error) {
+		const msg = error instanceof Error ? error.message : String(error)
 		throw commandError(`Failed to read FST binary at ${fstPath}: ${msg}`)
 	}
 
@@ -96,8 +101,8 @@ export async function runAutocomplete(
 
 	try {
 		matcher = deserializeFST(buf)
-	} catch (err) {
-		const msg = err instanceof Error ? err.message : String(err)
+	} catch (error) {
+		const msg = error instanceof Error ? error.message : String(error)
 		throw commandError(`Malformed FST binary at ${fstPath}: ${msg}`)
 	}
 
@@ -113,11 +118,11 @@ export async function runAutocomplete(
 }
 
 function formatSuggestions(entries: AutocompleteEntry[]): string {
-	if (entries.length === 0) return "(no completions)"
+	if (!entries.length) return "(no completions)"
 
 	return entries
 		.map((e, i) => {
-			const completion = e.completionTokens.length > 0 ? ` [+${e.completionTokens.join(" ")}]` : ""
+			const completion = e.completionTokens.length ? ` [+${e.completionTokens.join(" ")}]` : ""
 			const imp = e.importance.toFixed(4)
 
 			return `${String(i + 1).padStart(2)}. ${e.name}${completion}  (${e.placetype}, wof:${e.wofID}, imp:${imp})`

package/commands/corpus/align-shard.tsx

@@ -23,6 +23,7 @@ export { OptionsSchema as options }
 const Cmd: CommandComponent<typeof OptionsSchema> = ({ options }) => {
 	const state = useCommandTask(async () => {
 		const { alignCanonicalShard } = await import("@mailwoman/corpus/tools")
+
 		await alignCanonicalShard({
 			input: options.input,
 			output: options.output,

package/commands/corpus/audit.tsx

@@ -14,7 +14,7 @@ import zod from "zod"
 
 import { type CommandComponent, useCommandTask } from "../../cli-kit/index.ts"
 
-export const args = zod.tuple([
+const ArgsSchema = zod.tuple([
 	zod.string().describe(
 		argument({
 			name: "corpus-dir",
@@ -28,9 +28,9 @@ const OptionsSchema = zod.object({
 	sample: zod.number().default(100).describe("Max shards sampled per split when scanning without a MANIFEST"),
 })
 
-export { OptionsSchema as options }
+export { ArgsSchema as args, OptionsSchema as options }
 
-const CorpusAudit: CommandComponent<typeof OptionsSchema, typeof args> = ({ options, args }) => {
+const CorpusAudit: CommandComponent<typeof OptionsSchema, typeof ArgsSchema> = ({ options, args }) => {
 	const state = useCommandTask(async () => {
 		audit({ corpusDir: args[0], configPath: options.config, sampleShardCount: options.sample })
 	})

package/commands/corpus/build.tsx

@@ -40,6 +40,7 @@ const AdapterInputSchema = zod.union([
 		limit: zod.number().int().positive().optional(),
 	}),
 ])
+
 const InputsSchema = zod.record(zod.string(), AdapterInputSchema)
 
 const BuildConfigSchema = zod.object({
@@ -66,13 +67,14 @@ export { BuildConfigSchema as options }
 
 const CorpusBuild: CommandComponent<typeof BuildConfigSchema> = ({ options }) => {
 	const [stage, setStage] = useState<{ name: BuildStage; message: string }>()
+
 	const state = useCommandTask(async () => {
 		let inputsParsed: Record<string, zod.infer<typeof AdapterInputSchema>>
 
 		try {
 			inputsParsed = InputsSchema.parse(JSON.parse(options.inputs))
-		} catch (err) {
-			throw commandError(`invalid --inputs JSON: ${(err as Error).message}`)
+		} catch (error) {
+			throw commandError(`invalid --inputs JSON: ${(error as Error).message}`)
 		}
 
 		const adapterInputs: Record<string, AdapterOptions> = Object.fromEntries(
@@ -80,6 +82,7 @@ const CorpusBuild: CommandComponent<typeof BuildConfigSchema> = ({ options }) =>
 		)
 
 		const adapters = defaultAdapterRegistry.list()
+
 		const m = await buildCorpus({
 			outputDir: options.output,
 			corpusVersion: options.corpusVersion,

package/commands/corpus/download.tsx

@@ -33,7 +33,11 @@ const OptionsSchema = zod.object({
 
 export { OptionsSchema as options }
 
-type Step = { label: string; status: "pending" | "running" | "done" | "error"; detail?: string }
+interface Step {
+	label: string
+	status: "pending" | "running" | "done" | "error"
+	detail?: string
+}
 
 const CorpusDownload: CommandComponent<typeof OptionsSchema> = ({ options }) => {
 	const [steps, setSteps] = useState<Step[]>([
@@ -58,9 +62,9 @@ const CorpusDownload: CommandComponent<typeof OptionsSchema> = ({ options }) =>
 		try {
 			await $`rclone sync ${rcloneBase}/corpus/v0.3.0/ ${out}/corpus/versioned/v0.3.0/corpus-v0.3.0/ --progress --transfers 8 --checkers 16 ${dryFlag}`.quiet()
 			updateStep(0, { status: "done" })
-		} catch (_e: unknown) {
-			const e = _e as Record<string, unknown>
-			updateStep(0, { status: "error", detail: String(e.stderr ?? e.message ?? _e).slice(0, 100) })
+		} catch (error: unknown) {
+			const e = error as Record<string, unknown>
+			updateStep(0, { status: "error", detail: String(e.stderr ?? e.message ?? error).slice(0, 100) })
 
 			return
 		}
@@ -71,9 +75,9 @@ const CorpusDownload: CommandComponent<typeof OptionsSchema> = ({ options }) =>
 		try {
 			await $`rclone sync ${rcloneBase}/corpus/v0.4.0/ ${out}/corpus/versioned/v0.4.0/corpus-v0.4.0/ --progress --transfers 4 ${dryFlag}`.quiet()
 			updateStep(1, { status: "done" })
-		} catch (_e: unknown) {
-			const e = _e as Record<string, unknown>
-			updateStep(1, { status: "error", detail: String(e.stderr ?? e.message ?? _e).slice(0, 100) })
+		} catch (error: unknown) {
+			const e = error as Record<string, unknown>
+			updateStep(1, { status: "error", detail: String(e.stderr ?? e.message ?? error).slice(0, 100) })
 
 			return
 		}
@@ -84,9 +88,9 @@ const CorpusDownload: CommandComponent<typeof OptionsSchema> = ({ options }) =>
 		try {
 			await $`rclone sync ${rcloneBase}/models/tokenizer/ ${out}/models/tokenizer/ --progress ${dryFlag}`.quiet()
 			updateStep(2, { status: "done" })
-		} catch (_e: unknown) {
-			const e = _e as Record<string, unknown>
-			updateStep(2, { status: "error", detail: String(e.stderr ?? e.message ?? _e).slice(0, 100) })
+		} catch (error: unknown) {
+			const e = error as Record<string, unknown>
+			updateStep(2, { status: "error", detail: String(e.stderr ?? e.message ?? error).slice(0, 100) })
 
 			return
 		}
@@ -97,11 +101,9 @@ const CorpusDownload: CommandComponent<typeof OptionsSchema> = ({ options }) =>
 		try {
 			await $`rclone sync ${rcloneBase}/corpus-python/ ./corpus-python/ --progress ${dryFlag}`.quiet()
 			updateStep(3, { status: "done" })
-		} catch (_e: unknown) {
-			const e = _e as Record<string, unknown>
-			updateStep(3, { status: "error", detail: String(e.stderr ?? e.message ?? _e).slice(0, 100) })
-
-			return
+		} catch (error: unknown) {
+			const e = error as Record<string, unknown>
+			updateStep(3, { status: "error", detail: String(e.stderr ?? e.message ?? error).slice(0, 100) })
 		}
 	})
 

package/commands/corpus/fetch.tsx

@@ -27,7 +27,7 @@ import zod from "zod"
 
 import { type CommandComponent, useCommandTask } from "../../cli-kit/index.ts"
 
-export const args = zod.tuple([
+const ArgsSchema = zod.tuple([
 	zod
 		.enum([
 			"ban",
@@ -73,7 +73,7 @@ const OptionsSchema = zod.object({
 	dryRun: zod.boolean().default(false).describe("tiger-full: print planned downloads without fetching"),
 })
 
-export { OptionsSchema as options }
+export { ArgsSchema as args, OptionsSchema as options }
 
 type Options = zod.infer<typeof OptionsSchema>
 
@@ -125,7 +125,7 @@ function runSource(source: FetchSourceID, options: Options): Promise<FetchSummar
 	}
 }
 
-const CorpusFetch: CommandComponent<typeof OptionsSchema, typeof args> = ({ options, args }) => {
+const CorpusFetch: CommandComponent<typeof OptionsSchema, typeof ArgsSchema> = ({ options, args }) => {
 	const state = useCommandTask(
 		() => runSource(args[0], options),
 		(summary) => (summary.failed > 0 ? 1 : 0)
@@ -139,7 +139,7 @@ const CorpusFetch: CommandComponent<typeof OptionsSchema, typeof args> = ({ opti
 		return (
 			<Text color={failed > 0 ? "red" : "green"}>
 				{args[0]}: fetched {fetched}, skipped {skipped}, failed {failed}
-				{failedCodes.length > 0 ? ` (${failedCodes.join(" ")})` : ""}
+				{failedCodes.length ? ` (${failedCodes.join(" ")})` : ""}
 			</Text>
 		)
 	}

package/commands/corpus/list.tsx

@@ -20,7 +20,7 @@ import { Box, Text } from "ink"
 const CorpusList = () => {
 	const adapters = defaultAdapterRegistry.list()
 
-	if (adapters.length === 0) {
+	if (!adapters.length) {
 		return <Text dimColor>No adapters registered.</Text>
 	}
 

package/commands/corpus/overlay-manifest.tsx

@@ -27,6 +27,7 @@ export { OptionsSchema as options }
 const Cmd: CommandComponent<typeof OptionsSchema> = ({ options }) => {
 	const state = useCommandTask(async () => {
 		const { assembleOverlayManifest } = await import("@mailwoman/corpus/tools")
+
 		await assembleOverlayManifest({
 			base: options.base,
 			newDir: options.newDir,

package/commands/corpus/run.tsx

@@ -44,7 +44,7 @@ const RunConfigSchema = zod.object({
 		.int()
 		.positive()
 		.optional()
-		.default(1_000)
+		.default(1000)
 		.describe("Yield count between progress ticks (smaller = chattier, larger = quieter)"),
 })
 
@@ -56,6 +56,7 @@ const CorpusRun: CommandComponent<typeof RunConfigSchema, typeof ArgumentsSchema
 		written: 0,
 		bytes: 0,
 	})
+
 	const state = useCommandTask(async () => {
 		const adapterID = args[0]
 
@@ -67,7 +68,7 @@ const CorpusRun: CommandComponent<typeof RunConfigSchema, typeof ArgumentsSchema
 
 		if (!adapter) {
 			const ids = defaultAdapterRegistry.ids()
-			const hint = ids.length === 0 ? "(no adapters registered yet)" : `registered: ${ids.join(", ")}`
+			const hint = !ids.length ? "(no adapters registered yet)" : `registered: ${ids.join(", ")}`
 			throw commandError(`unknown adapter id ${JSON.stringify(adapterID)}; ${hint}`)
 		}
 

package/commands/corpus/shard/index.tsx

@@ -19,7 +19,9 @@ import zod from "zod"
 
 import { type CommandComponent, commandError, useCommandTask } from "../../../cli-kit/index.ts"
 
-/** Bare `mailwoman corpus shard` stays the recipe runner now that `shard/` hosts subcommands. */
+/**
+ * Bare `mailwoman corpus shard` stays the recipe runner now that `shard/` hosts subcommands.
+ */
 export const isDefault = true
 
 const ArgumentsSchema = zod
@@ -70,7 +72,7 @@ const num = (s: string | undefined): number | undefined => (s == null ? undefine
 
 const CorpusShard: CommandComponent<typeof OptionsSchema, typeof ArgumentsSchema> = ({ options, args }) => {
 	const state = useCommandTask(async () => {
-		if (options.list || args.length === 0) {
+		if (options.list || !args.length) {
 			return [
 				"recipes:",
 				...listShardRecipes().map((r) => `  ${r.name.padEnd(20)} [${r.mode}] ${r.description}`),
@@ -93,6 +95,7 @@ const CorpusShard: CommandComponent<typeof OptionsSchema, typeof ArgumentsSchema
 		if (recipe.mode === "generate" && !options.count) throw commandError(`recipe "${name}" needs --count <N>`)
 
 		const seed = options.seed != null ? Number(options.seed) : Date.now()
+
 		const opts: ShardRecipeOpts = {
 			output: options.output,
 			seed,
@@ -119,13 +122,19 @@ const CorpusShard: CommandComponent<typeof OptionsSchema, typeof ArgumentsSchema
 		}
 
 		console.error(`▸ shard recipe "${name}" [${recipe.mode}] seed=${seed} → ${options.output}`)
+
 		const stream = createWriteStream(options.output, { encoding: "utf8" })
+
 		const write = (line: string): void => {
 			stream.write(line)
 		}
+
 		const stats = await recipe.run(opts, write)
 		stream.end()
-		await new Promise<void>((res) => stream.on("finish", () => res()))
+
+		await new Promise<void>((res) => {
+			stream.on("finish", () => res())
+		})
 
 		return [
 			`recipe: ${name}`,

package/commands/corpus/stats.tsx

@@ -23,6 +23,7 @@ export { OptionsSchema as options }
 const Cmd: CommandComponent<typeof OptionsSchema> = ({ options }) => {
 	const state = useCommandTask(async () => {
 		const { buildCorpusStats } = await import("@mailwoman/corpus/tools")
+
 		await buildCorpusStats({
 			shardsArg: options.shards,
 			outputPath: options.output,