@carlesandres/house 0.4.8 → 0.4.9

package/CHANGELOG.md

@@ -6,6 +6,20 @@ The publish workflow (`.github/workflows/publish.yml`) runs on the `release: pub
 
 ## [Unreleased]
 
+## [0.4.9] — 2026-06-09
+
+### Fixed
+
+- Sidebar rows now keep a tighter single-space filename/path gap, and footer hint width calculation better handles wide glyphs.
+
+### Changed
+
+- Removed the experimental `--sort` option. The sidebar now consistently lists files before directories, so current-directory files appear before nested subtrees in the base list. This makes less-nested files naturally rank higher even without a search term. When a filter query is active the existing `filterFiles` / `rankFile` scoring (filename bias + strengthened depth penalties) still applies on top.
+
+### Docs
+
+- Demo recording now lives in `recordings/record-demo.sh`, with docs and recorded assets updated to match the new capture flow.
+
 ## [0.4.8] — 2026-06-02
 
 ### Fixed
@@ -18,7 +32,7 @@ The publish workflow (`.github/workflows/publish.yml`) runs on the `release: pub
 ### Docs
 
 - Corrected usage docs and `--help` text: directory browsing is controlled by `--root` / `defaultRoot`; the positional path now seeds the initial browser filter query.
-- Refreshed unified-browser docs, roadmap state, and demo tapes after the single Browser model landed.
+- Refreshed unified-browser docs, pruned shipped roadmap items, and updated demo tapes after the single Browser model landed.
 - Added ADR 0001 documenting the decision to keep the current `marked`-based browser preview instead of adopting Streamdown for now.
 
 ### Changed
@@ -184,7 +198,7 @@ Beta release gates (DESIGN §10.2) closed.
 
 ### Docs
 
-- README embeds a VHS-generated demo gif; `tape/` holds the source scripts.
+- README embeds the recorded demo asset; `recordings/` holds the capture workflow.
 - `CONTRIBUTING.md` documents the `captureSpans()` / `MockTreeSitterClient` / `TestRecorder` testing patterns and the "before blaming `<markdown>`" stale-watcher debugging checklist.
 
 ## [0.3.0] — 2026-05-16
@@ -280,7 +294,8 @@ The v1 MVP, published as `@carlesandres/openmdr` on npm.
 
 Search, stdin, URL fetching, cross-file link following, `$EDITOR` hand-off, syntax highlighting, persistent config, OS-appearance auto-detect, single-binary distribution (issue [#2](https://github.com/carlesandres/openmdr/issues/2)), Homebrew tap. All tracked.
 
-[Unreleased]: https://github.com/carlesandres/house/compare/v0.4.8...HEAD
+[Unreleased]: https://github.com/carlesandres/house/compare/v0.4.9...HEAD
+[0.4.9]: https://github.com/carlesandres/house/compare/v0.4.8...v0.4.9
 [0.4.8]: https://github.com/carlesandres/house/compare/v0.4.7...v0.4.8
 [0.4.7]: https://github.com/carlesandres/house/compare/v0.4.6...v0.4.7
 [0.4.6]: https://github.com/carlesandres/house/compare/v0.4.5...v0.4.6

package/README.md

@@ -2,7 +2,7 @@
 
 A terminal markdown reader and navigator — themable and configurable, with a keyboard-driven modern UI. Browse a directory of `.md` files without leaving the terminal.
 
-![house demo](tape/house.gif)
+<video src="recordings/house-demo.mp4" controls muted loop playsinline></video>
 
 ## Features
 
@@ -60,23 +60,22 @@ house --serve README.md
 
 ### Options
 
-| Flag | Default | Description |
-|------|---------|-------------|
-| `--theme <name>` | `opencode` | Starting theme (see list below) |
-| `--tone dark\|light` | `dark` | Starting tone |
-| `--width <N>` | — | Cap rendered markdown width at N columns |
-| `--show <list>` | `""` | Reveal normally-skipped entries; comma-separated subset of `hidden`, `gitignored`. Use `--show ""` to clear. |
-| `--root <dir>` | current directory | Discovery root to walk; overrides `defaultRoot` config/env |
-| `--sort <mode>` | `dirs-first` | Sidebar order: `dirs-first` or `files-first` |
-| `--sidebar <mode>` | `auto` | Initial sidebar visibility: `auto`, `on`, or `off` |
-| `--focus <mode>` | `filter` | Startup focus: `sidebar`, `reader`, or `filter`. `filter` opens the sidebar filter prompt immediately. |
-| `--serve` | off | Serve the positional path as HTML in the browser (skips TUI) |
-| `--port <N>` | OS-assigned | Port for `--serve` |
-| `--no-mdx` | off | Exclude `.mdx` files from discovery |
-| `--no-update-check` | off | Suppress the "newer version available" check (also via `NO_UPDATE_NOTIFIER=1`) |
-| `--config-path` | — | Print the resolved config-file path and exit |
-| `-h`, `--help` | — | Show help and exit |
-| `-v`, `--version` | — | Print version and exit |
+| Flag                 | Default           | Description                                                                                                  |
+| -------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------ |
+| `--theme <name>`     | `opencode`        | Starting theme (see list below)                                                                              |
+| `--tone dark\|light` | `dark`            | Starting tone                                                                                                |
+| `--width <N>`        | —                 | Cap rendered markdown width at N columns                                                                     |
+| `--show <list>`      | `""`              | Reveal normally-skipped entries; comma-separated subset of `hidden`, `gitignored`. Use `--show ""` to clear. |
+| `--root <dir>`       | current directory | Discovery root to walk; overrides `defaultRoot` config/env                                                   |
+| `--sidebar <mode>`   | `auto`            | Initial sidebar visibility: `auto`, `on`, or `off`                                                           |
+| `--focus <mode>`     | `filter`          | Startup focus: `sidebar`, `reader`, or `filter`. `filter` opens the sidebar filter prompt immediately.       |
+| `--serve`            | off               | Serve the positional path as HTML in the browser (skips TUI)                                                 |
+| `--port <N>`         | OS-assigned       | Port for `--serve`                                                                                           |
+| `--no-mdx`           | off               | Exclude `.mdx` files from discovery                                                                          |
+| `--no-update-check`  | off               | Suppress the "newer version available" check (also via `NO_UPDATE_NOTIFIER=1`)                               |
+| `--config-path`      | —                 | Print the resolved config-file path and exit                                                                 |
+| `-h`, `--help`       | —                 | Show help and exit                                                                                           |
+| `-v`, `--version`    | —                 | Print version and exit                                                                                       |
 
 ## Configuration
 
@@ -117,41 +116,41 @@ The file is optional — a missing file is fine. Invalid keys, unknown themes, o
 
 ### Global
 
-| Key | Action |
-|-----|--------|
-| `q` / `ctrl+c` | Quit |
-| `tab` | Toggle focus (sidebar ↔ reader) |
-| `s` | Toggle sidebar visibility |
-| `ctrl+p` | Command palette |
-| `O` | Open current file in browser as HTML |
-| `E` | Open current file in `$EDITOR` (`$VISUAL` takes precedence) |
-| `t` | Next theme |
-| `T` | Previous theme |
-| `L` | Toggle dark / light tone |
+| Key            | Action                                                      |
+| -------------- | ----------------------------------------------------------- |
+| `q` / `ctrl+c` | Quit                                                        |
+| `tab`          | Toggle focus (sidebar ↔ reader)                             |
+| `s`            | Toggle sidebar visibility                                   |
+| `ctrl+p`       | Command palette                                             |
+| `O`            | Open current file in browser as HTML                        |
+| `E`            | Open current file in `$EDITOR` (`$VISUAL` takes precedence) |
+| `t`            | Next theme                                                  |
+| `T`            | Previous theme                                              |
+| `L`            | Toggle dark / light tone                                    |
 
 ### Sidebar
 
-| Key | Action |
-|-----|--------|
-| `j` / `↓` | Move selection down |
-| `k` / `↑` | Move selection up |
-| `J` | Jump down 8 |
-| `K` | Jump up 8 |
-| `space` / `pagedown` / `ctrl+d` | Page down |
-| `b` / `pageup` / `ctrl+u` | Page up |
-| `g` | First file |
-| `G` | Last file |
-| `/` | Filter files (fuzzy match on path) |
-| `A` | Toggle hidden + gitignored entries (session-only; round-trips with the configured `show`) |
-| `↵` / `→` / `l` | Open file (focus reader) |
+| Key                             | Action                                                                                    |
+| ------------------------------- | ----------------------------------------------------------------------------------------- |
+| `j` / `↓`                       | Move selection down                                                                       |
+| `k` / `↑`                       | Move selection up                                                                         |
+| `J`                             | Jump down 8                                                                               |
+| `K`                             | Jump up 8                                                                                 |
+| `space` / `pagedown` / `ctrl+d` | Page down                                                                                 |
+| `b` / `pageup` / `ctrl+u`       | Page up                                                                                   |
+| `g`                             | First file                                                                                |
+| `G`                             | Last file                                                                                 |
+| `/`                             | Filter files (fuzzy match on path)                                                        |
+| `A`                             | Toggle hidden + gitignored entries (session-only; round-trips with the configured `show`) |
+| `↵` / `→` / `l`                 | Open file (focus reader)                                                                  |
 
 ### Reader
 
-| Key | Action |
-|-----|--------|
+| Key               | Action          |
+| ----------------- | --------------- |
 | `esc` / `←` / `h` | Back to sidebar |
-| `[` | Previous file |
-| `]` | Next file |
+| `[`               | Previous file   |
+| `]`               | Next file       |
 
 ## Themes
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@carlesandres/house",
-		"version": "0.4.8",
+		"version": "0.4.9",
 	"description": "TUI-first markdown reader on opentui",
 	"type": "module",
 	"license": "MIT",
@@ -42,6 +42,7 @@
 	"scripts": {
 		"dev": "bun --watch src/index.tsx",
 		"start": "bun run src/index.tsx",
+		"record-demo": "bash recordings/record-demo.sh",
 		"typecheck": "tsc --noEmit",
 		"lint": "oxlint --tsconfig tsconfig.json src/",
 		"format": "oxfmt src/",

package/src/Footer.tsx

@@ -15,12 +15,11 @@
  * sidebar (see Browser.tsx). The pattern mirrors ghui's PR list, where the
  * filter is part of the list it filters.
  *
- * Width math assumes hint labels are ASCII plus a small set of single-cell
- * BMP glyphs (see `displayKey`). `fitHints` and notice clipping use string
- * length as a proxy for cell count; introducing a CJK or emoji label would
- * require a real cell-width counter (e.g. East Asian Width).
+ * Width math uses terminal-style string width instead of raw string length so
+ * ambiguous glyphs such as `↵` don't steal spacing from the label beside them.
  */
 
+import stringWidth from "string-width"
 import type React from "react"
 import type { KeyBinding } from "./keymap/keymap.ts"
 import { displayKey } from "./keymap/displayKey.ts"
@@ -59,7 +58,7 @@ interface Hint {
 	readonly label: string
 }
 
-const hintWidth = (h: Hint): number => h.key.length + 1 + h.label.length // key + " " + label
+const hintWidth = (h: Hint): number => stringWidth(h.key) + 1 + stringWidth(h.label) // key + " " + label
 
 const formatHint = <C,>(b: KeyBinding<C>): Hint | null => {
 	if (!b.hint) return null

package/src/cli/argv.ts

@@ -12,8 +12,6 @@ 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
-	/** Value of `--sort <mode>` (`dirs-first` or `files-first`), or null. Validated by the boot layer. */
-	readonly sort: string | null
 	/** 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. */
@@ -51,7 +49,6 @@ const createProgram = () =>
 		.option("--theme [id]")
 		.option("--tone [mode]")
 		.option("--width [N]")
-		.option("--sort [mode]")
 		.option("--serve")
 		.option("--port [N]")
 		.option("--config-path")
@@ -69,7 +66,6 @@ const VALUE_FLAGS: ReadonlySet<string> = new Set([
 	"--theme",
 	"--tone",
 	"--width",
-	"--sort",
 	"--port",
 	"--sidebar",
 	"--focus",
@@ -77,6 +73,8 @@ const VALUE_FLAGS: ReadonlySet<string> = new Set([
 	"--root",
 ])
 
+const REMOVED_VALUE_FLAGS: ReadonlySet<string> = new Set(["--sort"])
+
 const BOOLEAN_FLAGS: ReadonlySet<string> = new Set([
 	"--serve",
 	"--config-path",
@@ -91,7 +89,7 @@ const BOOLEAN_FLAGS: ReadonlySet<string> = new Set([
 const findPathArg = (argv: readonly string[]): string | null => {
 	for (let i = 0; i < argv.length; i++) {
 		const arg = argv[i]!
-		if (VALUE_FLAGS.has(arg)) {
+		if (VALUE_FLAGS.has(arg) || REMOVED_VALUE_FLAGS.has(arg)) {
 			const next = argv[i + 1]
 			if (next !== undefined && !next.startsWith("-")) i++
 			continue
@@ -123,7 +121,6 @@ export const parseArgv = (argv: readonly string[]): ParsedArgs => {
 		theme: stringOrNull(opts["theme"]),
 		tone: stringOrNull(opts["tone"]),
 		width: stringOrNull(opts["width"]),
-		sort: stringOrNull(opts["sort"]),
 		serve: opts["serve"] === true,
 		port: stringOrNull(opts["port"]),
 		help: opts["help"] === true,
@@ -152,7 +149,6 @@ options:
   --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)
-  --sort <mode>  sidebar order: dirs-first (default) or files-first
   --sidebar <m>  initial sidebar visibility: auto (default), on, or off
   --focus <m>    startup focus: sidebar, reader, or filter (default: filter)
   --serve        serve the positional path as HTML in the browser (skips TUI)

package/src/discovery/filter.ts

@@ -3,12 +3,26 @@
  *
  * Matching stays intentionally small and pure: case-insensitive subsequence on
  * the filename and full relative path. Ranking prefers what users usually mean
- * in a sidebar:
- *   - filename matches above folder-only matches
- *   - files in the current folder above equally good nested matches
- *   - shallower paths above deeper ones as a soft tie-break
+ * in a sidebar (no configuration, no user knobs):
+ *   - filename matches above folder-only matches (zf/fzf-inspired strong bias)
+ *   - shallower / current-folder paths win over deep nested ones
+ *   - incidental matches purely from deep directory names are heavily demoted
+ *     so "nested folders bubbling up" does not happen for typical queries
  *
  * Empty query preserves discovery/tree order.
+ *
+ * The low-level fuzzyScore uses a "best alignment" scan (try every possible
+ * start position for the first query char, complete greedily, take the highest
+ * scoring match). This avoids the "early spurious char traps" a pure left-to-right
+ * greedy can hit on paths (e.g. "src/r.../readme" for query "readme" must prefer
+ * the boundary "r" in the filename, not the "r" in "src"). This draws from fzf's
+ * v1 "find occurrence then look for better" idea and the general principle that
+ * boundary+consecutive bonuses should win when they exist later in the string.
+ * We deliberately do not depend on fuzzysort/fuse/fzf here: the ranking *policy*
+ * (heavy filename bias, exact/stem bonuses, depth soft penalty) is application
+ * specific to "what makes a sidebar nice" and must be owned so end users get the
+ * good experience with zero configuration or thought. See DESIGN.md §7.4 and the
+ * filter tests.
  */
 
 import type { FileEntry } from "./walk.ts"
@@ -17,19 +31,41 @@ export const fuzzyScore = (query: string, target: string): number | null => {
 	if (query.length === 0) return 0
 	const q = query.toLowerCase()
 	const t = target.toLowerCase()
-	let qi = 0
-	let score = 0
-	let lastMatch = -2
-	for (let i = 0; i < t.length && qi < q.length; i++) {
-		if (t[i] !== q[qi]) continue
-		const isWordStart = i === 0 || t[i - 1] === "/"
-		score += isWordStart ? 10 : 1
-		if (lastMatch === i - 1) score += 5
-		lastMatch = i
-		qi++
+	if (q.length > t.length) return null
+
+	let best: number | null = null
+
+	// Best-alignment: try every viable start for q[0], then complete the rest
+	// greedily from there. Take the alignment that accumulates the most bonus
+	// points (word-start after /, consecutives). This is what gives good OOB
+	// results on tree paths without the caller doing extra work.
+	for (let start = 0; start < t.length; start++) {
+		if (t[start] !== q[0]) continue
+
+		let qi = 1
+		let score = 0
+		let lastMatch = start
+
+		// score first char
+		const isWordStart0 = start === 0 || t[start - 1] === "/"
+		score += isWordStart0 ? 10 : 1
+
+		let i = start + 1
+		for (; i < t.length && qi < q.length; i++) {
+			if (t[i] !== q[qi]) continue
+			const isWordStart = i === 0 || t[i - 1] === "/"
+			score += isWordStart ? 10 : 1
+			if (lastMatch === i - 1) score += 5
+			lastMatch = i
+			qi++
+		}
+
+		if (qi === q.length) {
+			if (best === null || score > best) best = score
+		}
 	}
-	if (qi < q.length) return null
-	return score
+
+	return best
 }
 
 const splitPath = (relativePath: string): { fileName: string; depth: number } => {
@@ -55,15 +91,31 @@ const rankFile = (query: string, file: FileEntry): number | null => {
 	const stem = fileStem(fileName).toLowerCase()
 	const nameScore = fuzzyScore(query, fileName) ?? 0
 
-	let score = pathScore * 10
-	score += nameScore * 100
+	let score = pathScore * 4
+	score += nameScore * 150
 
+	// Filename (and stem) priority — the heart of good sidebar UX.
+	// Users almost always mean "the file whose name contains this", not
+	// "some directory component that happens to have these letters".
 	if (name === q || stem === q) score += 5_000
 	else if (name.startsWith(q) || stem.startsWith(q)) score += 2_000
 	else if (name.includes(q)) score += 1_000
 
-	if (depth === 0) score += 300
-	score -= depth * 10
+	// Strong depth bias so less-nested files appear near the top.
+	// We want shallow files to win over deep "nested folders" even when
+	// the deep file has a decent path match (common with short queries or
+	// dir names). The penalty is now large enough to matter vs. the
+	// match bonuses. Root gets a big kick. This is the main lever for
+	// "position in the tree structure" without any user config.
+	if (depth === 0) score += 800
+	score -= depth * 120
+
+	// Extra penalty when the match is weak or absent in the *basename*.
+	// This aggressively demotes results where the hit is only because the
+	// file lives under a matching deep directory ("nested folders bubbling up").
+	if (nameScore == null || nameScore < 8) {
+		score -= depth * 80
+	}
 
 	return score
 }
@@ -73,16 +125,24 @@ const rankFile = (query: string, file: FileEntry): number | null => {
  * unchanged (preserves the discovery sort order). Non-empty query keeps
  * matches only, sorted by score desc; ties fall back to the input order so
  * the discovery sort still leaks through.
+ *
+ * All the "make this feel right for users exploring a tree" logic lives here
+ * (and in rankFile) so callers (Browser) and end users never have to think
+ * about or configure ranking.
  */
 export const filterFiles = (files: readonly FileEntry[], query: string): readonly FileEntry[] => {
 	if (query.length === 0) return files
-	const scored: { file: FileEntry; score: number; index: number }[] = []
+	const scored: { file: FileEntry; score: number; depth: number; index: number }[] = []
 	for (let i = 0; i < files.length; i++) {
 		const file = files[i]!
 		const score = rankFile(query, file)
 		if (score === null) continue
-		scored.push({ file, score, index: i })
+		const depth = (file.relativePath.match(/\//g) || []).length
+		scored.push({ file, score, depth, index: i })
 	}
-	scored.sort((a, b) => b.score - a.score || a.index - b.index)
+	// Primary: match quality (fuzzy + name bonuses - depth penalties already in score)
+	// Secondary: shallower depth wins (less nested near top)
+	// Tertiary: stable original discovery order
+	scored.sort((a, b) => b.score - a.score || a.depth - b.depth || a.index - b.index)
 	return scored.map((s) => s.file)
 }

package/src/discovery/walk.ts

@@ -18,16 +18,12 @@ export interface DiscoveryWarning {
 	readonly cause: unknown
 }
 
-export type SortOrder = "dirs-first" | "files-first"
-
 export interface WalkOptions {
 	/** Categories of normally-skipped entries to opt into. Empty (the
 	 *  default) yields the conservative set: no dotfiles, no gitignored
 	 *  entries. Order is irrelevant — semantics are set membership. Hard
 	 *  skips (`node_modules`, `.git`, `.venv`) always apply. */
 	readonly show?: Iterable<ShowCategory>
-	/** Group order within each directory. Default `dirs-first`. */
-	readonly sort?: SortOrder
 	/** Include `.mdx` files alongside `.md`/`.markdown`. Default `true`. */
 	readonly mdx?: boolean
 	/** Non-fatal subtree read errors. Root-level failures still error the walk. */
@@ -73,14 +69,12 @@ const tryLoadGitignore = async (dir: string): Promise<Ignore | null> => {
 
 const sortEntries = <T extends { name: string; isDirectory: () => boolean }>(
 	entries: readonly T[],
-	order: SortOrder,
 ): T[] =>
 	[...entries].sort((a, b) => {
 		const aDir = a.isDirectory()
 		const bDir = b.isDirectory()
 		if (aDir !== bDir) {
-			if (order === "files-first") return aDir ? 1 : -1
-			return aDir ? -1 : 1
+			return aDir ? 1 : -1
 		}
 		return a.name.localeCompare(b.name)
 	})
@@ -88,7 +82,7 @@ const sortEntries = <T extends { name: string; isDirectory: () => boolean }>(
 /**
  * DFS generator. Yields each markdown FileEntry as it is discovered, before
  * descending further. Per-directory sort still happens before yielding so
- * arrival order within a directory matches the configured sort.
+ * arrival order is files-first and alphabetical within each group.
  *
  * Cancellation: `signal.aborted` is checked between syscalls. Node's
  * `readdir` doesn't accept an AbortSignal, so a single in-flight `readdir`
@@ -99,7 +93,7 @@ async function* walkDirGen(
 	dirPath: string,
 	rootPath: string,
 	parentLevels: readonly IgnoreLevel[],
-	opts: { showHidden: boolean; showGitignored: boolean; sort: SortOrder; mdx: boolean },
+	opts: { showHidden: boolean; showGitignored: boolean; mdx: boolean },
 	onWarning: ((warning: DiscoveryWarning) => void) | null,
 	signal: AbortSignal,
 ): AsyncGenerator<FileEntry, void, void> {
@@ -123,7 +117,7 @@ async function* walkDirGen(
 	}
 	if (signal.aborted) return
 
-	for (const entry of sortEntries(raw, opts.sort)) {
+	for (const entry of sortEntries(raw)) {
 		if (signal.aborted) return
 
 		// Never follow symlinks — cycle hazard, and a markdown reader doesn't
@@ -166,8 +160,7 @@ async function* walkDirGen(
  * - Hidden files/dirs (leading `.`) skipped unless `show` contains `"hidden"`.
  * - `.gitignore` honored, including nested `.gitignore` files.
  * - Symlinks not followed.
- * - Sort: alphabetical within each group; directories before files
- *   (`dirs-first`, default) or files before directories (`files-first`).
+ * - Sort: files before directories, alphabetical within each group.
  */
 export const walk = (
 	root: string,
@@ -178,7 +171,6 @@ export const walk = (
 	const opts = {
 		showHidden: show.has("hidden"),
 		showGitignored: show.has("gitignored"),
-		sort: options.sort ?? ("dirs-first" as SortOrder),
 		mdx: options.mdx ?? true,
 	}
 	const onWarning = options.onWarning ?? null

package/src/index.tsx

@@ -13,7 +13,7 @@ import { Browser, type StartupFocus } from "./Browser.tsx"
 import { parseArgv, usage } from "./cli/argv.ts"
 import { defaultConfigPath, formatConfigError, loadConfig } from "./config/load.ts"
 import { parseShowList, SHOW_CATEGORIES, type ShowCategory } from "./discovery/show.ts"
-import { walk, type FileEntry, type SortOrder } from "./discovery/walk.ts"
+import { walk, type FileEntry } from "./discovery/walk.ts"
 import { openInBrowser } from "./serve/openBrowser.ts"
 import { startServer } from "./serve/server.ts"
 import { setActiveTheme } from "./theme/colors.ts"
@@ -106,7 +106,6 @@ interface DiscoverShellProps {
 	 *  and the full vocabulary; the underlying categories remain
 	 *  independent everywhere else. */
 	readonly initialShow: readonly ShowCategory[]
-	readonly sort: SortOrder
 	readonly mdx: boolean
 	readonly maxWidth: number | null
 	readonly sidebarMode: SidebarMode
@@ -117,7 +116,6 @@ export const DiscoverShell = ({
 	target,
 	initialQuery,
 	initialShow,
-	sort,
 	mdx,
 	maxWidth,
 	sidebarMode,
@@ -147,7 +145,6 @@ export const DiscoverShell = ({
 		countRef.current = 0
 		const warnedProgram = walk(target, {
 			show,
-			sort,
 			mdx,
 			onWarning: ({ path }) => {
 				const relativePath = relative(resolve(target), path)
@@ -182,7 +179,7 @@ export const DiscoverShell = ({
 		return () => {
 			Effect.runFork(Fiber.interrupt(fiber))
 		}
-	}, [target, show, sort, mdx])
+	}, [target, show, mdx])
 
 	const discoveryStatus =
 		scanError ??
@@ -348,14 +345,6 @@ if (import.meta.main) {
 		process.on("SIGTERM", shutdown)
 		// Bun.serve keeps the event loop alive until stop().
 	} else {
-		let sort: SortOrder = "dirs-first"
-		if (args.sort !== null) {
-			if (args.sort !== "dirs-first" && args.sort !== "files-first") {
-				console.error(`house: --sort must be "dirs-first" or "files-first", got "${args.sort}"`)
-				process.exit(2)
-			}
-			sort = args.sort
-		}
 		let sidebarMode: SidebarMode = "auto"
 		if (args.sidebar !== null) {
 			if (args.sidebar !== "auto" && args.sidebar !== "on" && args.sidebar !== "off") {
@@ -379,7 +368,6 @@ if (import.meta.main) {
 			tone,
 			maxWidth,
 			show,
-			sort,
 			mdx,
 			sidebarMode,
 			startupFocus,
@@ -395,7 +383,6 @@ interface TuiBootOptions {
 	readonly tone: "dark" | "light"
 	readonly maxWidth: number | null
 	readonly show: readonly ShowCategory[]
-	readonly sort: SortOrder
 	readonly mdx: boolean
 	readonly sidebarMode: SidebarMode
 	readonly startupFocus: StartupFocus
@@ -411,7 +398,6 @@ async function runTui({
 	tone,
 	maxWidth,
 	show,
-	sort,
 	mdx,
 	sidebarMode,
 	startupFocus,
@@ -455,7 +441,6 @@ async function runTui({
 				target={discoveryRoot}
 				initialQuery={initialQuery}
 				initialShow={show}
-				sort={sort}
 				mdx={mdx}
 				maxWidth={maxWidth}
 				sidebarMode={sidebarMode}

package/src/layout/sidebarRow.ts

@@ -22,7 +22,7 @@
  * and the most universally meaningful one when context shrinks.
  */
 
-export const SIDEBAR_ROW_SEPARATOR = "  ·  "
+export const SIDEBAR_ROW_SEPARATOR = " "
 const ELISION_PREFIX = "…/"
 const MIN_PARENT_BUDGET = 3