@carlesandres/house 0.5.2 → 0.7.0

package/CHANGELOG.md

@@ -6,6 +6,35 @@ The publish workflow (`.github/workflows/publish.yml`) runs on the `release: pub
 
 ## [Unreleased]
 
+## [0.7.0] — 2026-08-30
+
+### Added
+
+- `?` opens the command palette outside text inputs (same action as `ctrl+p`), so a single-key discovery path works without stealing `?` from the filter, palette query, or name prompts.
+- `R` (`shift+r`) renames the selected file's basename via the same prompt shell as New file, so nested files stay in place without leaving House.
+
+### Changed
+
+- Filter, command palette, and name prompts now use OpenTUI's single-line input, so left/right (and home/end) move the caret instead of only deleting from the end.
+
+
+## [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
@@ -14,13 +43,26 @@ The publish workflow (`.github/workflows/publish.yml`) runs on the `release: pub
 - 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.
-- Extracted the controlled file navigator into the private `@house/ui` workspace package while
-  keeping House's discovery, fuzzy ranking, keyboard routing, and product copy in the app.
+- 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).
@@ -391,7 +433,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.2...HEAD
+[Unreleased]: https://github.com/carlesandres/house/compare/v0.7.0...HEAD
+[0.7.0]: https://github.com/carlesandres/house/compare/v0.6.0...v0.7.0
+[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

package/README.md

@@ -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
 
@@ -128,10 +133,12 @@ The footer only shows essential app controls (`W`, `q`, `tab`, `s`, `ctrl+p`) to
 | `q` / `ctrl+c` | Quit                                                        |
 | `tab`          | Toggle focus (sidebar ↔ reader)                             |
 | `s`            | Toggle sidebar visibility                                   |
-| `ctrl+p`       | Command palette                                             |
+| `ctrl+p` / `?` | Command palette (`?` does not fire while typing in filter, palette, or name prompts) |
 | `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` |
+| `R`            | Rename the selected file's basename (same folder; does not move) |
 | `t`            | Next theme                                                  |
 | `T`            | Previous theme                                              |
 | `L`            | Toggle dark / light tone                                    |