@gmickel/gno 1.1.0 → 1.2.0

package/README.md

@@ -63,9 +63,9 @@ gno get "gno://work-docs/architecture/auth.md"
 gno multi-get "gno-code/**/*.ts" --max-bytes 30000 --md
 gno query "deployment process" --all --files --min-score 0.35
 
-# Run the workspace
-gno serve
-gno daemon
+# Run the workspace (pick one — don't run both against the same index concurrently)
+gno serve            # browser/desktop session with the Web UI
+gno daemon --detach  # headless continuous indexing (background; --status / --stop to manage)
 ```
 
 ---
@@ -92,7 +92,7 @@ gno daemon
 
 ## What's New
 
-> Latest release: [v1.0.0](./CHANGELOG.md#100---2026-04-16)  
+> Latest release: [v1.1.0](./CHANGELOG.md#110---2026-04-21)  
 > Full release history: [CHANGELOG.md](./CHANGELOG.md)
 
 - **Publish to [gno.sh](https://gno.sh/publish)**: new `gno publish export` CLI and Web UI action produce a self-contained artifact you upload to the hosted reader — public, secret, invite-only, or locally encrypted before upload
@@ -175,11 +175,13 @@ gno query "ECONNREFUSED 127.0.0.1:5432" --thorough
 ```bash
 gno init ~/notes --name notes    # Point at your docs
 gno index                        # Build search index
-gno daemon                       # Keep index fresh in background (foreground process)
+gno daemon --detach              # Keep index fresh in the background (macOS/Linux)
 gno query "auth best practices"  # Hybrid search
 gno ask "summarize the API" --answer  # AI answer with citations
 ```
 
+Manage the detached process with `gno daemon --status` and `gno daemon --stop`.
+
 ![GNO CLI](./assets/screenshots/cli.jpg)
 
 ---
@@ -213,11 +215,13 @@ desktop beta zip now published on GitHub Releases. See
 Keep an index fresh continuously without opening the Web UI:
 
 ```bash
-gno daemon
+gno daemon            # foreground (Ctrl+C to stop)
+gno daemon --detach   # background (macOS/Linux); use --status / --stop to manage
 ```
 
-`gno daemon` runs as a foreground watcher/sync/embed process. Use `nohup`,
-launchd, or systemd if you want it supervised long-term.
+`gno daemon` runs the watch/sync/embed loop headless. `--detach` self-spawns a
+detached child and exits 0; `gno daemon --status` and `gno daemon --stop` give
+you lifecycle control without `nohup`, `launchd`, or `systemd` units.
 
 See also: [docs/DAEMON.md](./docs/DAEMON.md)
 
@@ -264,14 +268,17 @@ Use `gno daemon` when you want continuous indexing without the browser or
 desktop shell open.
 
 ```bash
-gno daemon
+gno daemon                  # foreground (Ctrl+C to stop)
 gno daemon --no-sync-on-start
-nohup gno daemon > /tmp/gno-daemon.log 2>&1 &
+gno daemon --detach         # background (macOS/Linux); auto-writes pid + log files
+gno daemon --status         # check the detached process
+gno daemon --stop           # SIGTERM with 10s timeout, SIGKILL fallback
 ```
 
 It reuses the same watch/sync/embed runtime as `gno serve`, but stays
-headless. In v0.30 it is foreground-only and does not expose built-in
-`start/stop/status` management.
+headless. `--detach` / `--status` / `--stop` give you symmetric lifecycle
+controls so you don't need `nohup`, `launchd`, or `systemd` units. The same
+flag set is available on `gno serve`.
 
 [Daemon guide →](https://gno.sh/docs/DAEMON/)
 

package/assets/skill/cli-reference.md

@@ -494,6 +494,105 @@ gno serve [options]
 
 Features: Dashboard, search, browse collections, document viewer, AI Q&A with citations.
 
+#### Long-running process flags (shared with `gno daemon`)
+
+`gno serve` and `gno daemon` share an identical management contract.
+The full spec is reproduced in this section so installed copies of this
+skill stay self-contained. The canonical source in the gno repo is
+`docs/CLI.md#long-running-processes` (kept in sync with this section
+on every release).
+
+| Flag                | Purpose                                                                                      |
+| ------------------- | -------------------------------------------------------------------------------------------- |
+| `--detach`          | Self-spawn a detached child; parent prints `pid` (+ `url` for serve) and exits 0. Unix-only. |
+| `--status`          | Read pid-file, check liveness, print status. Pair with `--json` for machine output.          |
+| `--stop`            | SIGTERM the recorded pid, poll up to 10s, fall back to SIGKILL.                              |
+| `--pid-file <path>` | Override pid-file location (defaults to `{data}/serve.pid`).                                 |
+| `--log-file <path>` | Override log-file location (append-only; defaults to `{data}/serve.log`).                    |
+
+`--detach`, `--status`, and `--stop` are mutually exclusive (Commander conflict error).
+
+**`--json` is gated to `--status` only.** Passing `--json` with `--detach`,
+`--stop`, or the foreground path produces a `VALIDATION` error (exit 1).
+The literal stderr message is:
+
+```
+--json is only supported with `gno serve --status`
+```
+
+Do **not** try to parse a NOT_RUNNING envelope from stderr in this case —
+it isn't there. Match on the literal string above (or just on exit code 1
+plus the absence of structured output) and fall back to a status call.
+
+**Exit codes:**
+
+- `gno serve --status` → `0` when running, `3` (`NOT_RUNNING`) when not.
+  The stdout JSON payload is still emitted in JSON mode on exit 3 so
+  consumers always get a schema-shaped result; the NOT_RUNNING envelope
+  rides on stderr (JSON mode only).
+- `gno serve --stop` → `0` when stopped, `3` (`NOT_RUNNING`) when there
+  was nothing to stop. **Silent on `3`** — no stderr envelope. Branch on
+  `$?`, not stderr text. `1` when refusing to signal a foreign-version
+  live pid; `2` when SIGTERM + SIGKILL both timed out.
+
+Examples:
+
+```bash
+gno serve --detach                            # self-spawn, parent exits 0
+gno serve --status                            # terminal table
+gno serve --status --json                     # process-status schema
+gno serve --stop                              # graceful stop
+gno serve --detach --pid-file /tmp/gs.pid \
+                   --log-file /tmp/gs.log
+```
+
+> **Windows note**: `--detach` returns a clean `VALIDATION` error pointing
+> to WSL. `--status` / `--stop` / `--pid-file` / `--log-file` remain
+> parseable but have nothing to manage in the absence of a detached child.
+
+### gno daemon
+
+Headless long-running watcher process. Same watch + sync + embed loop as
+`gno serve`, no web UI, no port.
+
+```bash
+gno daemon [options]
+```
+
+| Option               | Description                                                 |
+| -------------------- | ----------------------------------------------------------- |
+| `--no-sync-on-start` | Skip the initial sync pass; only watch future file changes. |
+
+Plus the shared long-running-process flags listed in [`gno serve`](#gno-serve)
+above (`--detach` / `--status` / `--stop` / `--pid-file` / `--log-file`).
+Defaults: `{data}/daemon.pid`, `{data}/daemon.log` (`{data}` =
+`resolveDirs().data`, honours `GNO_DATA_DIR`).
+
+**`--json` gating** mirrors `gno serve` exactly. The literal stderr
+message on a misuse is:
+
+```
+--json is only supported with `gno daemon --status`
+```
+
+**Exit codes** are identical to `gno serve` (`0` / `1` / `2` / `3`
+`NOT_RUNNING`). `--stop` is silent on `3`.
+
+Examples:
+
+```bash
+gno daemon                                    # foreground
+gno daemon --no-sync-on-start                 # watcher-only
+gno daemon --detach                           # self-spawn
+gno daemon --detach --log-file /tmp/gd.log
+gno daemon --status
+gno daemon --status --json
+gno daemon --stop
+```
+
+Avoid running `gno daemon` and `gno serve` against the same index at the
+same time until cross-process coordination exists.
+
 ## Publish
 
 ### gno publish export
@@ -620,8 +719,9 @@ gno completion uninstall
 
 ## Exit Codes
 
-| Code | Description                   |
-| ---- | ----------------------------- |
-| 0    | Success                       |
-| 1    | Validation error (bad args)   |
-| 2    | Runtime error (IO, DB, model) |
+| Code | Description                                                          |
+| ---- | -------------------------------------------------------------------- |
+| 0    | Success                                                              |
+| 1    | Validation error (bad args)                                          |
+| 2    | Runtime error (IO, DB, model)                                        |
+| 3    | `NOT_RUNNING` — `--status` / `--stop` found no live matching process |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gmickel/gno",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Local semantic search for your documents. Index Markdown, PDF, and Office files with hybrid BM25 + vector search.",
   "keywords": [
     "embeddings",