@hamedb89/localghost 0.1.15 → 0.3.0

package/docs/github.md

@@ -115,12 +115,12 @@ https://hamedb89.github.io/localghost/
 `.github/workflows/ci.yml` runs on pull requests and pushes to `main`. It uses `npm ci`, then runs:
 
 ```sh
-npm run release:check
+./bin/ghost check
 ```
 
-That command typechecks, builds the package, builds the static site, and runs `npm pack --dry-run`.
+That command typechecks, builds the package, builds the static site, and runs `npm pack --dry-run`. From a checkout, the same verification is available as `./bin/ghost check`.
 
-`.github/workflows/publish-npm.yml` publishes to npm when a `v*` tag is pushed, or from manual workflow dispatch. The workflow checks that tag names match `package.json` versions, reruns `npm run release:check`, and then uses:
+`.github/workflows/publish-npm.yml` publishes to npm when a `v*` tag is pushed, or from manual workflow dispatch. The workflow checks that tag names match `package.json` versions, reruns `./bin/ghost check`, and then uses:
 
 ```sh
 npm run publish:public
@@ -153,12 +153,12 @@ For a normal patch release:
 
 ```sh
 git status --short
-npm run release:check
+./bin/ghost check
 npm version patch
 git push origin main --tags
 ```
 
-Pushing the `v*` tag starts the npm publish workflow automatically. The workflow reruns `npm run release:check` before publishing. Create the GitHub release afterwards if you want release notes on GitHub.
+Pushing the `v*` tag starts the npm publish workflow automatically. The workflow reruns `./bin/ghost check` before publishing. Create the GitHub release afterwards if you want release notes on GitHub.
 
 If publishing from a local terminal instead of GitHub Actions, omit provenance and provide the npm two-factor code:
 

package/docs/localghost.1.md

@@ -9,8 +9,9 @@ localghost - friendly local hostnames for app repos
 ```sh
 localghost [--cwd path] [--dry-run]
 localghost init [--write-scripts] [--config file] [--host host] [--port port]
-localghost doctor
+localghost doctor [--cwd path] [--config file] [--config-pattern regex] [--json]
 localghost setup [--project name] [--config file] [--config-pattern regex] [--https|--ssl]
+localghost repair [--project name] [--config file] [--config-pattern regex] [--https|--ssl] [--trust] [--reallocate-port] [--prune-registry]
 localghost trust [--project name] [--config file] [--config-pattern regex] [--https|--ssl]
 localghost reset [--project name]
 localghost teardown [--project name] [--remove-caddyfile]
@@ -71,13 +72,13 @@ Options:
 
 ### doctor
 
-Checks machine prerequisites.
+Checks machine prerequisites, the configured project port, and Localghost registry state. Use `--json` for agent-readable output. The command reports occupied ports, stale leases, and duplicate allocations without changing state.
 
 ```sh
 localghost doctor
 ```
 
-Currently checks Caddy and prints `brew install caddy` when missing.
+It checks Caddy and prints `brew install caddy` when missing.
 
 ### setup
 
@@ -97,11 +98,12 @@ localghost trust
 
 ### repair
 
-Reconciles the managed hosts block, regenerates and validates the Caddyfile, and refreshes project setup state. Use `--https --trust` to also re-run Caddy's local certificate trust step.
+Reconciles the managed hosts block, regenerates and validates the Caddyfile, and refreshes project setup state. Use `--https --trust` to also re-run Caddy's local certificate trust step. `--reallocate-port` selects and remembers a stable available replacement for an occupied port without editing `.localghost`. `--prune-registry` removes expired or dead leases.
 
 ```sh
 localghost repair
 localghost repair --https --trust
+localghost repair --reallocate-port --prune-registry
 ```
 
 ### teardown

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hamedb89/localghost",
-  "version": "0.1.15",
+  "version": "0.3.0",
   "description": "Friendly local hostnames for app repos with .localghost, Caddy, /etc/hosts, and Vite.",
   "type": "module",
   "bin": {