@carlesandres/house 0.4.13 → 0.5.0

package/CHANGELOG.md

@@ -2,10 +2,38 @@
 
 All notable changes to house land here. Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html) from v0.1.0 onward.
 
-The publish workflow (`.github/workflows/publish.yml`) runs on the `release: published` event, runs `npm publish` via Trusted Publisher, and lets GitHub auto-generate release notes from commit subjects; this file is the curated, narrative version.
+The publish workflow (`.github/workflows/publish.yml`) runs on the `release: published` event, builds per-platform binaries, publishes platform packages then the main package via Trusted Publisher, and lets GitHub auto-generate release notes from commit subjects; this file is the curated, narrative version.
 
 ## [Unreleased]
 
+## [0.5.0] — 2026-07-23
+
+### Added
+
+- Added a lightweight `src/standalone.ts` CLI entrypoint for fast `--help` / `--version` exits and future compiled-binary builds.
+- Added `bun run build:standalone` to compile and package per-platform standalone binaries.
+- Added `bun run build:npm-packages` to prepare per-platform binary npm packages.
+- Switched the published `house` bin to a small Node shim that loads the matching optional binary package.
+- Added `bun run build:cli` + `prepack` to publish a bundled `dist/` package.
+- Release publish now builds binaries on native runners (macOS arm64/x64, Linux arm64/x64), publishes the four platform npm packages, then the main package, and attaches `house-*.tar.gz` archives to the GitHub Release.
+- Added `bun run version:set X.Y.Z` and release-time validation to keep the main and platform package versions in sync.
+
+### Fixed
+
+- Publish credentials now use least privilege: build jobs are read-only, while only the final publish job can write release assets or request an npm OIDC token.
+- Manual publish dispatch now rejects refs other than `main` before building or publishing artifacts.
+- Published package `files` now lists only `dist/bin.js` and `dist/index.js`, so standalone/npm binary build outputs under `dist/` are not packed into the main tarball.
+- `build:cli` no longer wipes all of `dist/` (preserves `dist/release` and `dist/npm` during `prepack`).
+
+## [0.4.14] — 2026-06-15
+
+### 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.
+
 ## [0.4.13] — 2026-06-15
 
 ### Added
@@ -333,7 +361,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.4.13...HEAD
+[Unreleased]: https://github.com/carlesandres/house/compare/v0.5.0...HEAD
+[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
 [0.4.13]: https://github.com/carlesandres/house/compare/v0.4.12...v0.4.13
 [0.4.12]: https://github.com/carlesandres/house/compare/v0.4.11...v0.4.12
 [0.4.11]: https://github.com/carlesandres/house/compare/v0.4.10...v0.4.11

package/README.md

@@ -14,29 +14,29 @@ A terminal markdown reader and navigator — themable and configurable, with a k
 - **Open in browser**
 - **Open in `$EDITOR`**
 
-Requires [Bun](https://bun.sh) on `PATH`.
+Install with npm or Bun. Prebuilt binaries cover macOS and Linux (arm64/x64); no Bun required to *run* on those platforms.
 
 ## Runtime requirements
 
-- Bun: required to install and run `house` today.
-- npm can install the package, but npm evaluates Node engine metadata from transitive dependencies during install. Use `bun add -g` for the supported no-Node install path.
+- **Run:** a prebuilt binary for your platform (pulled in automatically on install). No Bun needed at runtime on supported platforms.
+- **Install:** Node/npm or Bun both work. Prefer `npm install -g` for the normal end-user path.
 
-Supported on macOS and Linux; Windows is unsupported and unvalidated (see [#129](https://github.com/carlesandres/house/issues/129)).
+Supported on macOS and Linux (arm64/x64, glibc Linux). Windows is unsupported and unvalidated (see [#129](https://github.com/carlesandres/house/issues/129)).
 
 ## Install
 
 ```bash
-bun add -g @carlesandres/house
-# npm also works when your local Node/npm combination accepts the dependency graph:
 npm install -g @carlesandres/house
+# or:
+bun add -g @carlesandres/house
 ```
 
 ## Upgrade
 
 ```bash
-bun add -g @carlesandres/house
-# npm also works when your local Node/npm combination accepts the dependency graph:
 npm i -g @carlesandres/house
+# or:
+bun add -g @carlesandres/house
 ```
 
 ## Usage
@@ -119,6 +119,8 @@ The file is optional — a missing file is fine. Invalid keys, unknown themes, o
 
 ## Keys
 
+The footer only shows essential app controls (`W`, `q`, `tab`, `s`, `ctrl+p`) to stay quiet. Use the command palette for the rest.
+
 ### Global
 
 | Key            | Action                                                      |

package/dist/bin.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process"
+import { realpathSync } from "node:fs"
+import { createRequire } from "node:module"
+import { fileURLToPath } from "node:url"
+
+const require = createRequire(import.meta.url)
+const pkg = require("../package.json")
+
+const supportedTargets = {
+	darwin: new Set(["arm64", "x64"]),
+	linux: new Set(["arm64", "x64"]),
+}
+
+const mainBinaryName = "house"
+const fastExitFlags = new Set(["--help", "-h", "--version", "-v", "--config-path"])
+
+export const detectLinuxLibc = () => {
+	if (process.platform !== "linux") return undefined
+	const report = process.report?.getReport?.()
+	const header = report?.header
+	return typeof header?.glibcVersionRuntime === "string" ? "glibc" : "musl"
+}
+
+export const binaryPackageNameFor = (
+	platform,
+	arch,
+	libc = platform === "linux" ? detectLinuxLibc() : undefined,
+) => {
+	if (platform in supportedTargets && supportedTargets[platform].has(arch)) {
+		if (platform === "linux" && libc !== "glibc") return undefined
+		return `${pkg.name}-${platform}-${arch}`
+	}
+	return undefined
+}
+
+export const resolveBinaryPath = (packageName, resolve = require.resolve) =>
+	resolve(`${packageName}/bin/${mainBinaryName}`)
+
+export const shouldCaptureOutput = (argv) => argv.some((arg) => fastExitFlags.has(arg))
+
+export const main = (
+	argv = process.argv.slice(2),
+	platform = process.platform,
+	arch = process.arch,
+	libc = detectLinuxLibc(),
+) => {
+	if (argv.includes("--version") || argv.includes("-v")) {
+		console.log(pkg.version)
+		process.exit(0)
+	}
+
+	const packageName = binaryPackageNameFor(platform, arch, libc)
+	if (packageName === undefined) {
+		console.error(
+			`house: no prebuilt binary package for ${platform}-${arch}${platform === "linux" ? `-${libc ?? "unknown-libc"}` : ""}`,
+		)
+		process.exit(1)
+	}
+
+	let binaryPath
+	try {
+		binaryPath = resolveBinaryPath(packageName)
+	} catch {
+		console.error(
+			`house: missing optional dependency ${packageName}; reinstall house to fetch the matching binary package`,
+		)
+		process.exit(1)
+	}
+
+	const captureOutput = shouldCaptureOutput(argv)
+	const result = spawnSync(binaryPath, argv, {
+		stdio: captureOutput ? ["inherit", "pipe", "pipe"] : "inherit",
+	})
+
+	if (captureOutput) {
+		if (result.stdout !== null) process.stdout.write(result.stdout)
+		if (result.stderr !== null) process.stderr.write(result.stderr)
+	}
+
+	if (result.error !== undefined) {
+		console.error(`house: failed to launch ${packageName}: ${result.error.message}`)
+		process.exit(1)
+	}
+
+	process.exit(result.status ?? 1)
+}
+
+const isMain =
+	process.argv[1] !== undefined && realpathSync(process.argv[1]) === fileURLToPath(import.meta.url)
+
+if (isMain) main()