@carlesandres/house 0.4.12 → 0.4.14

package/src/Header.tsx

@@ -5,20 +5,113 @@
  * current filename on the left, version on the right. The row is
  * informational, not interactive — see issue #38 for the design discussion.
  *
- * Width degrades gracefully: the version drops first when the row gets
- * tight, then the filename, leaving the brand mark as the irreducible
- * identity element. Always rendered — the row is worth one cell on any
- * viewport so the user never loses the filename indicator (notably, when
- * the sidebar drawer overlays the reader on narrow viewports).
+ * Width degrades gracefully: the discovery root truncates/drops first, then
+ * the wordmark, then the version, then the filename truncates, leaving the
+ * brand mark as the irreducible identity element. Always rendered — the row is
+ * worth one cell on any viewport so the user never loses the filename/root
+ * indicator (notably, when the sidebar drawer overlays the reader on narrow
+ * viewports).
  */
 
 import pkg from "../package.json" with { type: "json" }
 import { BRAND, BRAND_NAME } from "./brand.ts"
 import { colors } from "./theme/colors.ts"
+import { middleTruncate } from "./ui/middleTruncate.ts"
 
 export const HEADER_HEIGHT = 1
 
 const FILE_SEPARATOR = " · "
+const HEADER_HORIZONTAL_PADDING = 2
+const HEADER_GROUP_GAP = 1
+const MIN_TRUNCATED_ROOT_WIDTH = 5
+
+export interface HeaderSegment {
+	readonly id: "brand" | "file" | "root"
+	readonly text: string
+	readonly tone: "brand" | "primary" | "muted"
+}
+
+export interface HeaderLayout {
+	readonly left: readonly HeaderSegment[]
+	readonly right: string | null
+}
+
+export interface HeaderLayoutInput {
+	readonly width: number
+	readonly currentFile?: string | null | undefined
+	readonly rootLabel?: string | null | undefined
+	readonly version: string
+}
+
+export const layoutHeaderSegments = ({
+	width,
+	currentFile,
+	rootLabel,
+	version,
+}: HeaderLayoutInput): HeaderLayout => {
+	const usableWidth = Math.max(0, width - HEADER_HORIZONTAL_PADDING)
+	const file = currentFile && currentFile.length > 0 ? currentFile : null
+	const root = rootLabel && rootLabel.length > 0 ? rootLabel : null
+	const right = `v${version}`
+	const brand: HeaderSegment = { id: "brand", text: `${BRAND} ${BRAND_NAME}`, tone: "brand" }
+	const iconBrand: HeaderSegment = { id: "brand", text: BRAND, tone: "brand" }
+	const fileSegment: HeaderSegment | null =
+		file === null ? null : { id: "file", text: file, tone: "primary" }
+	const rootSegment: HeaderSegment | null =
+		root === null ? null : { id: "root", text: root, tone: "muted" }
+	const segments = [brand, ...(fileSegment === null ? [] : [fileSegment])]
+
+	if (rootSegment !== null && fits([...segments, rootSegment], right, usableWidth)) {
+		return { left: [...segments, rootSegment], right }
+	}
+
+	const rootWidth =
+		rootSegment === null
+			? 0
+			: usableWidth -
+				joinedLength(segments) -
+				FILE_SEPARATOR.length -
+				HEADER_GROUP_GAP -
+				right.length
+	if (root !== null && root.length > rootWidth && rootWidth >= MIN_TRUNCATED_ROOT_WIDTH) {
+		return {
+			left: [...segments, { id: "root", text: middleTruncate(root, rootWidth), tone: "muted" }],
+			right,
+		}
+	}
+
+	if (fits(segments, right, usableWidth)) return { left: segments, right }
+
+	const iconSegments = [iconBrand, ...(fileSegment === null ? [] : [fileSegment])]
+	if (fits(iconSegments, right, usableWidth)) return { left: iconSegments, right }
+	if (fits(iconSegments, null, usableWidth)) return { left: iconSegments, right: null }
+	if (file !== null) {
+		const fileWidth = usableWidth - BRAND.length - FILE_SEPARATOR.length
+		if (fileWidth > 0) {
+			return {
+				left: [iconBrand, { id: "file", text: middleTruncate(file, fileWidth), tone: "primary" }],
+				right: null,
+			}
+		}
+	}
+
+	return { left: [iconBrand], right: null }
+}
+
+const joinedLength = (segments: readonly HeaderSegment[]): number =>
+	segments.reduce(
+		(total, segment, idx) => total + segment.text.length + (idx === 0 ? 0 : FILE_SEPARATOR.length),
+		0,
+	)
+
+const fits = (
+	segments: readonly HeaderSegment[],
+	right: string | null,
+	usableWidth: number,
+): boolean => {
+	const rightWidth = right === null ? 0 : HEADER_GROUP_GAP + right.length
+	return joinedLength(segments) + rightWidth <= usableWidth
+}
 
 export interface HeaderProps {
 	readonly width: number
@@ -26,27 +119,15 @@ export interface HeaderProps {
 	 *  it next to the brand mark — replaces the per-pane border title that
 	 *  used to carry this information. */
 	readonly currentFile?: string | null
+	/** Canonical discovery root / scan-scope label. */
+	readonly rootLabel?: string | null
 	/** Optional override for the version string (testing). Defaults to
 	 *  the running package's version. */
 	readonly version?: string
 }
 
-export const Header = ({ width, currentFile, version = pkg.version }: HeaderProps) => {
-	const brand = `${BRAND} ${BRAND_NAME}`
-	const right = `v${version}`
-	const file = currentFile && currentFile.length > 0 ? currentFile : null
-	const usableWidth = Math.max(0, width - 2) // 1-cell horizontal padding each side
-
-	// Priority: brand > filename > version. Brand is the irreducible identity
-	// anchor. Filename is per-selection useful info — keep it before the
-	// largely-static version string. `1` is the minimum gap between left and
-	// right groups so they never visually collide.
-	const leftWithFile = file !== null ? `${brand}${FILE_SEPARATOR}${file}` : brand
-	const showFileWithVersion = leftWithFile.length + 1 + right.length <= usableWidth
-	const showFileWithoutVersion = leftWithFile.length <= usableWidth
-	const showFile = file !== null && (showFileWithVersion || showFileWithoutVersion)
-	const left = showFile ? leftWithFile : brand
-	const showRight = left.length + 1 + right.length <= usableWidth
+export const Header = ({ width, currentFile, rootLabel, version = pkg.version }: HeaderProps) => {
+	const layout = layoutHeaderSegments({ width, currentFile, rootLabel, version })
 
 	return (
 		<box
@@ -62,10 +143,18 @@ export const Header = ({ width, currentFile, version = pkg.version }: HeaderProp
 			}}
 		>
 			<text wrapMode="none">
-				<span style={{ fg: colors.text }}>{brand}</span>
-				{showFile && <span style={{ fg: colors.textMuted }}>{`${FILE_SEPARATOR}${file}`}</span>}
+				{layout.left.map((segment, idx) => (
+					<span
+						key={`${segment.id}-${idx}`}
+						style={{ fg: segment.tone === "muted" ? colors.textMuted : colors.text }}
+					>
+						{`${idx === 0 ? "" : FILE_SEPARATOR}${segment.text}`}
+					</span>
+				))}
 			</text>
-			{showRight && <text content={right} wrapMode="none" style={{ fg: colors.text }} />}
+			{layout.right !== null && (
+				<text content={layout.right} wrapMode="none" style={{ fg: colors.text }} />
+			)}
 		</box>
 	)
 }

package/src/StatusIndicator.tsx

@@ -0,0 +1,55 @@
+import { colors } from "./theme/colors.ts"
+
+export type StatusIndicatorVariant = "info" | "warning" | "error" | "success"
+
+export interface StatusIndicatorProps {
+	readonly icon: string
+	readonly variant?: StatusIndicatorVariant
+	readonly active?: boolean
+	readonly onMouseUp?: () => void
+}
+
+export const statusIndicatorFg = (variant: StatusIndicatorVariant): string => {
+	switch (variant) {
+		case "info":
+			return colors.info
+		case "warning":
+			return colors.warning
+		case "error":
+			return colors.error
+		case "success":
+			return colors.success
+	}
+}
+
+export const StatusIndicator = ({
+	icon,
+	variant = "info",
+	active = true,
+	onMouseUp,
+}: StatusIndicatorProps) => {
+	const activeColor = statusIndicatorFg(variant)
+	const backgroundColor = active ? activeColor : colors.backgroundElement
+
+	return (
+		<box
+			{...(onMouseUp === undefined ? {} : { onMouseUp })}
+			style={{
+				width: 3,
+				height: 1,
+				flexDirection: "row",
+				backgroundColor,
+			}}
+		>
+			<text
+				content={` ${icon} `}
+				wrapMode="none"
+				style={{
+					fg: active ? colors.backgroundPanel : colors.textMuted,
+					bg: backgroundColor,
+					attributes: active ? 1 : 0,
+				}}
+			/>
+		</box>
+	)
+}

package/src/StatusPopover.tsx

@@ -1,5 +1,6 @@
 import { useTerminalDimensions } from "@opentui/react"
 import { useMemo, useState } from "react"
+import { StatusIndicator, statusIndicatorFg } from "./StatusIndicator.tsx"
 import { colors } from "./theme/colors.ts"
 
 export type StatusPopoverVariant = "info" | "warning" | "error" | "success"
@@ -29,19 +30,6 @@ export interface StatusPopoverPanelProps {
 
 const clamp = (n: number, min: number, max: number) => Math.max(min, Math.min(max, n))
 
-const variantFg = (variant: StatusPopoverVariant): string => {
-	switch (variant) {
-		case "info":
-			return colors.info
-		case "warning":
-			return colors.warning
-		case "error":
-			return colors.error
-		case "success":
-			return colors.success
-	}
-}
-
 const measureLine = (line: string): number => line.length
 
 const wrapLine = (line: string, width: number): string[] => {
@@ -96,22 +84,11 @@ export const StatusPopover = ({
 
 	const linesToRender = wrapped.slice(0, Math.max(0, popoverHeight - 2))
 	while (linesToRender.length < popoverHeight - 2) linesToRender.push("")
-	const triggerFg = variantFg(variant)
-	const borderColor = variantFg(variant)
+	const borderColor = statusIndicatorFg(variant)
 
 	return (
 		<>
-			<box
-				onMouseUp={() => setOpen(!isOpen)}
-				style={{
-					width: 3,
-					height: 1,
-					flexDirection: "row",
-					backgroundColor: colors.backgroundElement,
-				}}
-			>
-				<text content={` ${icon} `} wrapMode="none" style={{ fg: triggerFg, attributes: 1 }} />
-			</box>
+			<StatusIndicator icon={icon} variant={variant} active onMouseUp={() => setOpen(!isOpen)} />
 			{showPanel && isOpen && (
 				<box
 					position="absolute"
@@ -162,7 +139,7 @@ export const StatusPopoverPanel = ({
 	const linesToRender = wrapped.slice(0, Math.max(0, popoverHeight - 2))
 	while (linesToRender.length < popoverHeight - 2) linesToRender.push("")
 
-	const borderColor = variantFg(variant)
+	const borderColor = statusIndicatorFg(variant)
 
 	return (
 		<box

package/src/cli/argv.ts

@@ -12,6 +12,10 @@ export interface ParsedArgs {
 	readonly tone: string | null
 	/** Value of `--width <N>`, or null. Validated by the boot layer (must be a positive integer). */
 	readonly width: string | null
+	/** Startup reader wrap override. Null means config/env/default decides. */
+	readonly wrap: boolean | null
+	/** True when both `--wrap` and `--no-wrap` were passed. */
+	readonly wrapConflict: boolean
 	/** True when `--serve` was passed: serve the positional path as HTML, skip TUI. */
 	readonly serve: boolean
 	/** Value of `--port <N>`, or null. Validated by the boot layer. */
@@ -22,8 +26,6 @@ export interface ParsedArgs {
 	readonly version: boolean
 	/** True when `--config-path` was passed: print resolved config path and exit. */
 	readonly configPath: boolean
-	/** Value of `--sidebar <mode>` (`auto`, `on`, `off`), or null. Validated by the boot layer. */
-	readonly sidebar: string | null
 	/** True when `--no-update-check` was passed: suppress the npm-registry
 	 *  probe and the "update available" notice. Mirrors the
 	 *  `NO_UPDATE_NOTIFIER` env var so opt-out is reachable without env state. */
@@ -49,10 +51,11 @@ const createProgram = () =>
 		.option("--theme [id]")
 		.option("--tone [mode]")
 		.option("--width [N]")
+		.option("--wrap")
+		.option("--no-wrap")
 		.option("--serve")
 		.option("--port [N]")
 		.option("--config-path")
-		.option("--sidebar [mode]")
 		.option("--no-update-check")
 		.option("--ext [list]")
 		.option("--focus [mode]")
@@ -67,19 +70,20 @@ const VALUE_FLAGS: ReadonlySet<string> = new Set([
 	"--tone",
 	"--width",
 	"--port",
-	"--sidebar",
 	"--focus",
 	"--show",
 	"--root",
 	"--ext",
 ])
 
-const REMOVED_VALUE_FLAGS: ReadonlySet<string> = new Set(["--sort"])
+const REMOVED_VALUE_FLAGS: ReadonlySet<string> = new Set(["--sort", "--sidebar"])
 
 const BOOLEAN_FLAGS: ReadonlySet<string> = new Set([
 	"--serve",
 	"--config-path",
 	"--no-update-check",
+	"--wrap",
+	"--no-wrap",
 	"--help",
 	"-h",
 	"--version",
@@ -114,6 +118,8 @@ export const parseArgv = (argv: readonly string[]): ParsedArgs => {
 	const opts = program.opts<Record<string, unknown>>()
 	const pathArg = findPathArg(argv)
 	const stringOrNull = (value: unknown): string | null => (typeof value === "string" ? value : null)
+	const hasWrap = argv.includes("--wrap")
+	const hasNoWrap = argv.includes("--no-wrap")
 
 	return {
 		path: typeof pathArg === "string" ? pathArg : null,
@@ -121,12 +127,13 @@ export const parseArgv = (argv: readonly string[]): ParsedArgs => {
 		theme: stringOrNull(opts["theme"]),
 		tone: stringOrNull(opts["tone"]),
 		width: stringOrNull(opts["width"]),
+		wrap: hasWrap ? true : hasNoWrap ? false : null,
+		wrapConflict: hasWrap && hasNoWrap,
 		serve: opts["serve"] === true,
 		port: stringOrNull(opts["port"]),
 		help: opts["help"] === true,
 		version: opts["version"] === true,
 		configPath: opts["configPath"] === true,
-		sidebar: stringOrNull(opts["sidebar"]),
 		noUpdateCheck: opts["noUpdateCheck"] === true,
 		extensions: stringOrNull(opts["ext"]),
 		show: stringOrNull(opts["show"]),
@@ -145,12 +152,13 @@ export const usage = `usage:
 options:
   --theme <id>   color theme: ${themeList} (default: opencode)
   --tone <mode>  dark or light (default: dark)
-  --width <N>    cap rendered markdown width at N columns
+  --width <N>    reader wrap width used when wrapping is enabled (default: 80)
+  --wrap         start with reader wrapping enabled
+  --no-wrap      start with reader wrapping disabled
   --show <list>  reveal normally-skipped entries; comma-separated subset of:
                    hidden, gitignored. Use --show "" to clear.
   --root <dir>   discovery root to walk (overrides defaultRoot config/env)
-  --sidebar <m>  initial sidebar visibility: auto (default), on, or off
-  --focus <m>    startup focus: sidebar, reader, or filter (default: filter)
+  --focus <m>    startup focus: sidebar, reader, or filter (default: sidebar)
   --serve        serve the positional path as HTML in the browser (skips TUI)
   --port <N>     port for --serve (default: OS-assigned)
   -h, --help     show this help and exit
@@ -166,6 +174,6 @@ examples:
 
 configuration:
   file: $XDG_CONFIG_HOME/house/config.toml  (default ~/.config/house/config.toml)
-	  keys: theme, tone, extensions, show, focus, defaultRoot
-	  env:  HOUSE_THEME, HOUSE_TONE, HOUSE_EXTENSIONS, HOUSE_SHOW, HOUSE_FOCUS, HOUSE_DEFAULT_ROOT
+	  keys: theme, tone, width, wrap, extensions, show, focus, defaultRoot
+	  env:  HOUSE_THEME, HOUSE_TONE, HOUSE_WIDTH, HOUSE_WRAP, HOUSE_EXTENSIONS, HOUSE_SHOW, HOUSE_FOCUS, HOUSE_DEFAULT_ROOT
   precedence (high → low): flags → env → file → defaults`

package/src/commands/buildCommands.ts

@@ -55,6 +55,7 @@ const annotations: Record<string, Annotation> = {
 		keywords: ["hidden", "gitignore", "dotfiles", "all"],
 	},
 	"reader.back": { title: "Back to sidebar", category: "Navigation" },
+	"reader.wrap.toggle": { title: "Toggle reader wrap", category: "View" },
 	"reader.prevFile": { title: "Previous file", category: "Navigation" },
 	"reader.nextFile": { title: "Next file", category: "Navigation" },
 	"serve.current": { title: "Open in browser", category: "File" },

package/src/commands/paletteOnlyCommands.ts

@@ -13,4 +13,15 @@
 import type { BrowserCtx } from "../keymap/browser.ts"
 import type { AppCommand } from "./types.ts"
 
-export const paletteOnlyCommands = (_ctx: BrowserCtx): readonly AppCommand[] => []
+export const paletteOnlyCommands = (ctx: BrowserCtx): readonly AppCommand[] =>
+	ctx.hasSelected
+		? [
+				{
+					id: "file.copyContents",
+					title: "Copy file contents",
+					category: "File",
+					keywords: ["copy", "clipboard", "contents", "markdown"],
+					run: () => ctx.copyCurrentContents(),
+				},
+			]
+		: []

package/src/config/load.ts

@@ -20,6 +20,10 @@ export interface HouseConfig {
 	readonly theme: string
 	readonly tone: "dark" | "light"
 	readonly extensions: readonly string[]
+	/** Reader wrap width used when wrapping is enabled. */
+	readonly width: number
+	/** Whether the reader starts with fixed-width wrapping enabled. */
+	readonly wrap: boolean
 	/** Default discovery-root strategy when no explicit `--root` flag is passed. */
 	readonly defaultRoot: "cwd" | "git"
 	/** Categories of normally-skipped entries to opt into. See
@@ -40,6 +44,8 @@ export interface CliOverrides {
 	 *  other CLI override here). `--show ""` sets the empty set. */
 	readonly show: readonly ShowCategory[] | null
 	readonly focus: "sidebar" | "reader" | "filter" | null
+	readonly width: number | null
+	readonly wrap: boolean | null
 }
 
 const DEFAULT_THEME = "opencode"
@@ -47,7 +53,9 @@ const DEFAULT_TONE: "dark" | "light" = "dark"
 const DEFAULT_EXTENSIONS: readonly string[] = []
 const DEFAULT_ROOT: "cwd" | "git" = "cwd"
 const DEFAULT_SHOW = ""
-const DEFAULT_FOCUS: "sidebar" | "reader" | "filter" = "filter"
+const DEFAULT_FOCUS: "sidebar" | "reader" | "filter" = "sidebar"
+const DEFAULT_WIDTH = 80
+const DEFAULT_WRAP = false
 
 const themeIds = themeDefinitions.map((t) => t.id)
 
@@ -63,6 +71,8 @@ const KNOWN_FILE_KEYS: ReadonlySet<string> = new Set([
 	"extensions",
 	"show",
 	"focus",
+	"width",
+	"wrap",
 	"defaultRoot",
 ])
 
@@ -78,6 +88,8 @@ const schema = Config.all({
 	// so the error message can list valid categories at the field's path.
 	show: Config.schema(Schema.String, "show"),
 	focus: Config.schema(Schema.Literals(["sidebar", "reader", "filter"] as const), "focus"),
+	width: Config.schema(Schema.String, "width"),
+	wrap: Config.schema(Schema.String, "wrap"),
 })
 
 const defaultsProvider = (): ConfigProvider.ConfigProvider =>
@@ -88,8 +100,26 @@ const defaultsProvider = (): ConfigProvider.ConfigProvider =>
 		extensions: DEFAULT_EXTENSIONS.join(","),
 		show: DEFAULT_SHOW,
 		focus: DEFAULT_FOCUS,
+		width: String(DEFAULT_WIDTH),
+		wrap: String(DEFAULT_WRAP),
 	})
 
+const sourceError = (message: string, cause?: unknown): ConfigProvider.SourceError =>
+	new ConfigProvider.SourceError({ message, cause })
+
+const validateFileValue = (path: string, key: string, value: unknown): void => {
+	if (key === "width") {
+		if (!Number.isSafeInteger(value) || (value as number) <= 0) {
+			throw sourceError(`invalid value for width in ${path}: expected a positive integer`)
+		}
+	}
+	if (key === "wrap") {
+		if (typeof value !== "boolean") {
+			throw sourceError(`invalid value for wrap in ${path}: expected true or false`)
+		}
+	}
+}
+
 /**
  * Levenshtein edit distance, capped at `cap` for early exit.
  * Used only to suggest "did you mean X?" when a config key looks like a
@@ -154,15 +184,22 @@ const fileProvider = (
 		const parsed = yield* Effect.try({
 			try: () => Bun.TOML.parse(text) as Record<string, unknown>,
 			catch: (cause) =>
-				new ConfigProvider.SourceError({
-					message: `invalid TOML in ${path}: ${cause instanceof Error ? cause.message : String(cause)}`,
+				sourceError(
+					`invalid TOML in ${path}: ${cause instanceof Error ? cause.message : String(cause)}`,
 					cause,
-				}),
+				),
 		})
 		const known = [...KNOWN_FILE_KEYS]
 		const filtered: Record<string, unknown> = {}
 		for (const [k, v] of Object.entries(parsed)) {
 			if (KNOWN_FILE_KEYS.has(k)) {
+				yield* Effect.try({
+					try: () => validateFileValue(path, k, v),
+					catch: (cause) =>
+						cause instanceof ConfigProvider.SourceError
+							? cause
+							: sourceError(`invalid value for ${k} in ${path}`, cause),
+				})
 				filtered[k] = v
 			} else {
 				onWarning(formatUnknownKeyWarning(path, k, known))
@@ -206,12 +243,16 @@ const envProvider = (env: Record<string, string | undefined>): ConfigProvider.Co
 	const extensions = env["HOUSE_EXTENSIONS"]
 	const show = env["HOUSE_SHOW"]
 	const focus = env["HOUSE_FOCUS"]
+	const width = env["HOUSE_WIDTH"]
+	const wrap = env["HOUSE_WRAP"]
 	if (theme !== undefined) entries.push(["theme", theme])
 	if (tone !== undefined) entries.push(["tone", tone])
 	if (defaultRoot !== undefined) entries.push(["defaultRoot", defaultRoot])
 	if (extensions !== undefined) entries.push(["extensions", extensions])
 	if (show !== undefined) entries.push(["show", show])
 	if (focus !== undefined) entries.push(["focus", focus])
+	if (width !== undefined) entries.push(["width", width])
+	if (wrap !== undefined) entries.push(["wrap", wrap])
 	return ConfigProvider.fromUnknown(Object.fromEntries(entries))
 }
 
@@ -222,9 +263,28 @@ const cliProvider = (overrides: CliOverrides): ConfigProvider.ConfigProvider =>
 	if (overrides.extensions !== null) entries.push(["extensions", overrides.extensions.join(",")])
 	if (overrides.show !== null) entries.push(["show", overrides.show.join(",")])
 	if (overrides.focus !== null) entries.push(["focus", overrides.focus])
+	if (overrides.width !== null) entries.push(["width", String(overrides.width)])
+	if (overrides.wrap !== null) entries.push(["wrap", String(overrides.wrap)])
 	return ConfigProvider.fromUnknown(Object.fromEntries(entries))
 }
 
+const parsePositiveInteger = (key: string, raw: string): Effect.Effect<number, Error> => {
+	if (!/^\d+$/.test(raw)) {
+		return Effect.fail(new Error(`${key}: expected a positive integer, got ${JSON.stringify(raw)}`))
+	}
+	const value = Number.parseInt(raw, 10)
+	if (!Number.isSafeInteger(value) || value <= 0) {
+		return Effect.fail(new Error(`${key}: expected a positive integer, got ${JSON.stringify(raw)}`))
+	}
+	return Effect.succeed(value)
+}
+
+const parseBoolean = (key: string, raw: string): Effect.Effect<boolean, Error> => {
+	if (raw === "true") return Effect.succeed(true)
+	if (raw === "false") return Effect.succeed(false)
+	return Effect.fail(new Error(`${key}: expected true or false, got ${JSON.stringify(raw)}`))
+}
+
 export interface LoadOptions {
 	readonly cli?: CliOverrides
 	/** Override the TOML path (tests). Defaults to `$XDG_CONFIG_HOME/house/config.toml`. */
@@ -265,6 +325,8 @@ export const loadConfig = (
 		extensions: null,
 		show: null,
 		focus: null,
+		width: null,
+		wrap: null,
 	}
 	const onWarning = options.onWarning ?? ((msg) => process.stderr.write(`${msg}\n`))
 	const provider = cliProvider(cli).pipe(
@@ -273,41 +335,47 @@ export const loadConfig = (
 		ConfigProvider.orElse(defaultsProvider()),
 	)
 	return schema.parse(provider).pipe(
-		Effect.flatMap((raw) => {
-			const defaultRoot =
-				raw.defaultRoot === "cwd" || raw.defaultRoot === "git" ? raw.defaultRoot : DEFAULT_ROOT
-			if (raw.defaultRoot !== defaultRoot) {
-				onWarning(
-					`house: ignoring invalid value ${JSON.stringify(raw.defaultRoot)} for defaultRoot in config/env; using "${DEFAULT_ROOT}"`,
-				)
-			}
-			const parsed = parseShowList(raw.show)
-			if (!parsed.ok) {
-				// Effect's `Config.ConfigError` requires a `SchemaError` or
-				// `SourceError` cause that we don't have a clean constructor
-				// for here — surface as a plain Error and let the boot
-				// layer's existing `formatConfigError` (which already handles
-				// `instanceof Error`) render it.
-				return Effect.fail(
-					new Error(
-						`show: unknown category "${parsed.invalid.join('", "')}" (valid: ${SHOW_CATEGORIES.join(", ")})`,
-					),
-				)
-			}
-			return Effect.succeed({
-				theme: raw.theme,
-				tone: raw.tone,
-				defaultRoot,
-				extensions:
-					raw.extensions === ""
-						? []
-						: raw.extensions
-								.split(",")
-								.map((s) => s.trim())
-								.filter(Boolean),
-				show: parsed.value,
-				focus: raw.focus,
-			})
-		}),
+		Effect.flatMap((raw) =>
+			Effect.gen(function* () {
+				const defaultRoot =
+					raw.defaultRoot === "cwd" || raw.defaultRoot === "git" ? raw.defaultRoot : DEFAULT_ROOT
+				if (raw.defaultRoot !== defaultRoot) {
+					onWarning(
+						`house: ignoring invalid value ${JSON.stringify(raw.defaultRoot)} for defaultRoot in config/env; using "${DEFAULT_ROOT}"`,
+					)
+				}
+				const parsed = parseShowList(raw.show)
+				if (!parsed.ok) {
+					// Effect's `Config.ConfigError` requires a `SchemaError` or
+					// `SourceError` cause that we don't have a clean constructor
+					// for here — surface as a plain Error and let the boot
+					// layer's existing `formatConfigError` (which already handles
+					// `instanceof Error`) render it.
+					return yield* Effect.fail(
+						new Error(
+							`show: unknown category "${parsed.invalid.join('", "')}" (valid: ${SHOW_CATEGORIES.join(", ")})`,
+						),
+					)
+				}
+				const width = yield* parsePositiveInteger("width", raw.width)
+				const wrap = yield* parseBoolean("wrap", raw.wrap)
+				return {
+					theme: raw.theme,
+					tone: raw.tone,
+					defaultRoot,
+					width,
+					wrap,
+					extensions:
+						raw.extensions === ""
+							? []
+							: raw.extensions
+									.split(",")
+									.map((s) => s.trim())
+									.filter(Boolean),
+					show: parsed.value,
+					focus: raw.focus,
+				}
+			}),
+		),
 	)
 }

package/src/discovery/rootLabel.ts

@@ -0,0 +1,18 @@
+import { isAbsolute, relative } from "node:path"
+
+export interface DiscoveryRootLabelInput {
+	readonly discoveryRoot: string
+	readonly home: string
+}
+
+export const formatDiscoveryRootLabel = ({
+	discoveryRoot,
+	home,
+}: DiscoveryRootLabelInput): string => {
+	if (discoveryRoot === home) return "~"
+	const homeRelative = relative(home, discoveryRoot)
+	if (homeRelative.length > 0 && !homeRelative.startsWith("..") && !isAbsolute(homeRelative)) {
+		return `~/${homeRelative}`
+	}
+	return discoveryRoot
+}