@carlesandres/house 0.5.1 → 0.6.0

package/CHANGELOG.md

@@ -6,13 +6,65 @@ The publish workflow (`.github/workflows/publish.yml`) runs on the `release: pub
 
 ## [Unreleased]
 
+## [0.6.0] — 2026-08-24
+
+### Added
+
+- Internal `@house/options` package: a typed catalog for options whose initial values come from CLI, env, and config, and that can be changed during a session. House's scalar config (`theme`, `tone`, `focus`, `defaultRoot`, `width`, `wrap`) now resolves through it.
+- File Navigator browse order is now configurable (`tree` or `recently-modified`) via `--order`, `HOUSE_ORDER`, and the `order` config key. The default is `recently-modified`, so the most recently updated files appear first.
+
+### Changed
+
+- `N` now prompts for a file name, creates an empty `.md` at the discovery root, selects it in the File Navigator, and opens it in `$EDITOR` / `$VISUAL`. It no longer launches a nameless editor session in the discovery root.
+- Invalid `defaultRoot` values fail at load instead of warning and falling back to `"cwd"`.
+- Theme and tone cycling now go through the options session and persist via the same catalog policy as other file-backed options.
+- Large-tree File Navigator startup no longer waits for a topology-only warmup: the watcher
+  subscribes before the first authoritative scan, missing ignore files are not probed, and the first
+  visible batch can paint while the rest of the tree is still scanning.
+
+
+## [0.5.2] — 2026-08-01
+
+### Changed
+
+- Converted the repository to a Turborepo monorepo with house under `apps/house`.
+- CI, npm packaging, standalone builds, and release publishing now run through workspace tasks.
+- Added local GitHub release/API verification with `vercel-labs/emulate`.
+- Extracted the House-specific sidebar pane from Browser without changing behavior.
+- House now uses the filesystem-aware File Navigator from `@house/ui/file-navigator` and the generic
+  `@house/ui/sidebar` presentation boundary.
+- File discovery now stays synchronized with live filesystem changes, with strict extension, hidden,
+  ignore, and hard-skip policy applied to scanner membership.
+- File navigation uses the package's fuzzy default behavior, including debounced query projection and
+  stable selection through streaming and reordering.
+- Selected-file updates, explicit refreshes, and stale reads are coordinated through reader invalidation
+  epochs.
+- Release builds now run filesystem mutation coverage inside the exact House artifact, with static
+  Parcel hosts for the four supported targets and installed npm execution without Bun on `PATH`.
+- Large-tree File Navigator startup now avoids redundant entry lookups and metadata work, uses a
+  topology-only readiness pass, and preserves scanner order while streaming built-in tree projections.
+
+### Fixed
+
+- Streamed matches that rank ahead of the current row no longer change the selected file.
+- Pressing Return before the filter debounce elapses now opens the post-flush matching file.
+- A stable File Navigator ref now switches to the committed root instead of retaining its first root.
+- Reader loads now reject stale path/epoch completions across selection, root, watcher, editor, and
+  teardown changes; coalesced selected-file events trigger one fresh read.
+- Standalone/npm binaries again render markdown with syntax highlighting. The compile step
+  now embeds OpenTUI's tree-sitter parser worker and sets `OTUI_TREE_SITTER_WORKER_PATH`
+  (same approach as OpenCode; see opentui#807).
+- Release version bumps no longer retarget unpublished platform optionalDependencies in the
+  monorepo lockfile, so CI can install before those packages are on npm. The published main
+  package still pins platform packages to the release version.
+
+
 ## [0.5.1] — 2026-07-25
 
 ### Fixed
 
 - Platform npm packages now preserve an executable `bin/house` after passing through GitHub Actions artifacts.
 
-
 ## [0.5.0] — 2026-07-23
 
 ### Added
@@ -37,6 +89,7 @@ The publish workflow (`.github/workflows/publish.yml`) runs on the `release: pub
 ### Added
 
 - Browser header now shows the active discovery root, and empty states reuse the same canonical root label for consistent launch context.
+
 ### Changed
 
 - Footer hints are now limited to essential app controls, leaving other actions discoverable through the command palette.
@@ -368,7 +421,9 @@ 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.5.1...HEAD
+[Unreleased]: https://github.com/carlesandres/house/compare/v0.6.0...HEAD
+[0.6.0]: https://github.com/carlesandres/house/compare/v0.5.2...v0.6.0
+[0.5.2]: https://github.com/carlesandres/house/compare/v0.5.1...v0.5.2
 [0.5.1]: https://github.com/carlesandres/house/compare/v0.5.0...v0.5.1
 [0.5.0]: https://github.com/carlesandres/house/compare/v0.4.14...v0.5.0
 [0.4.14]: https://github.com/carlesandres/house/compare/v0.4.13...v0.4.14

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.
 
-<video src="recordings/house-demo.mp4" controls muted loop playsinline></video>
+<video src="apps/house/recordings/house-demo.mp4" controls muted loop playsinline></video>
 
 ## Features
 
@@ -55,6 +55,7 @@ Examples:
 house                  # browse the configured discovery root
 house README.md        # browse with README.md preloaded as the sidebar filter
 house --root docs      # browse docs/ as the discovery root
+house --order tree     # files-before-directories instead of recency
 house --serve README.md
 ```
 
@@ -70,6 +71,7 @@ house --serve README.md
 | `--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                                                   |
 | `--focus <mode>`     | `sidebar`         | Startup focus: `sidebar`, `reader`, or `filter`. `filter` opens the sidebar filter prompt immediately.       |
+| `--order <mode>`     | `recently-modified` | File Navigator browse order when the filter is empty: `tree` or `recently-modified`.                      |
 | `--serve`            | off               | Serve the positional path as HTML in the browser (skips TUI)                                                 |
 | `--port <N>`         | OS-assigned       | Port for `--serve`                                                                                           |
 | `--ext <list>`       | none              | Include extra file extensions (comma-separated)                                                               |
@@ -98,24 +100,27 @@ wrap = false
 show  = ["hidden", "gitignored"]
 focus = "sidebar"
 defaultRoot = "cwd" # or "git"
+order = "recently-modified" # or "tree"
 ```
 
-Supported keys: `theme`, `tone`, `extensions`, `width`, `wrap`, `show`, `focus`, `defaultRoot`.
+Supported keys: `theme`, `tone`, `extensions`, `width`, `wrap`, `show`, `focus`, `defaultRoot`, `order`.
 
 `show` is a list of normally-skipped categories to opt into. Known categories: `hidden` (dot-prefixed entries), `gitignored` (entries matched by a `.gitignore`). Default is the empty list. Hard skips (`node_modules`, `.git`, `.venv`) always apply.
 
 Precedence, highest to lowest:
 
-1. CLI flags (`--theme`, `--tone`, `--ext`, `--width`, `--wrap`, `--no-wrap`, `--show`, `--focus`, `--root`)
-2. Env vars (`HOUSE_THEME`, `HOUSE_TONE`, `HOUSE_EXTENSIONS`, `HOUSE_WIDTH`, `HOUSE_WRAP`, `HOUSE_SHOW`, `HOUSE_FOCUS`, `HOUSE_DEFAULT_ROOT`)
+1. CLI flags (`--theme`, `--tone`, `--ext`, `--width`, `--wrap`, `--no-wrap`, `--show`, `--focus`, `--order`, `--root`)
+2. Env vars (`HOUSE_THEME`, `HOUSE_TONE`, `HOUSE_EXTENSIONS`, `HOUSE_WIDTH`, `HOUSE_WRAP`, `HOUSE_SHOW`, `HOUSE_FOCUS`, `HOUSE_DEFAULT_ROOT`, `HOUSE_ORDER`)
 3. Config file
-4. Built-in defaults (`opencode` / `dark` / `extensions = []` / `width = 80` / `wrap = false` / `show = []` / `focus = "sidebar"` / `defaultRoot = "cwd"`)
+4. Built-in defaults (`opencode` / `dark` / `extensions = []` / `width = 80` / `wrap = false` / `show = []` / `focus = "sidebar"` / `defaultRoot = "cwd"` / `order = "recently-modified"`)
 
 `HOUSE_SHOW` takes a comma-separated list (`HOUSE_SHOW=hidden,gitignored`). For `show` specifically, each source completely replaces the next — categories don't merge across layers. Press `shift+a` in the TUI to round-trip between the configured set and the full vocabulary without editing config.
 
 `width` is the fixed reader width used when wrapping is enabled. `wrap` controls startup mode; press `w` in the TUI to toggle reader wrapping for the current session without editing config.
 
-The file is optional — a missing file is fine. Invalid keys, unknown themes, or malformed TOML fail loudly with a one-line error. Per-project config (`.house/config.toml`) and additional keys are deferred.
+`order` is the File Navigator browse order when no filter query is active. `recently-modified` (default) lists the most recently updated files first, using filesystem modification time, then tree order for ties. `tree` lists files before directories, alphabetically within each group, so current-directory files appear before nested subtrees. An active filter still ranks by relevance first.
+
+The file is optional — a missing file is fine. Invalid keys, unknown themes, invalid `defaultRoot`, or malformed TOML fail loudly with a one-line error. Per-project config (`.house/config.toml`) and additional keys are deferred.
 
 ## Keys
 
@@ -132,6 +137,7 @@ The footer only shows essential app controls (`W`, `q`, `tab`, `s`, `ctrl+p`) to
 | `w`            | Toggle reader wrap                                          |
 | `O`            | Open current file in browser as HTML                        |
 | `E`            | Open current file in `$EDITOR` (`$VISUAL` takes precedence) |
+| `N`            | Prompt for a name, create an empty markdown file at the discovery root, then open it in `$EDITOR` |
 | `t`            | Next theme                                                  |
 | `T`            | Previous theme                                              |
 | `L`            | Toggle dark / light tone                                    |