@gmickel/gno 1.36.1 → 1.37.0

package/README.md

@@ -105,7 +105,7 @@ gno daemon --detach  # headless indexing + resident MCP gateway
 
 **Start here** · [Quick Start](#quick-start) · [Installation](#installation) · [Agent Integration](#agent-integration) · [Search Modes](#search-modes)
 
-**Surfaces** · [Web UI](#web-ui) · [REST API](#rest-api) · [SDK](#sdk) · [Daemon Mode](#daemon-mode) · [Publish to gno.sh](#publish-to-gnosh)
+**Surfaces** · [Web UI](#web-ui) · [Omarchy Plugin](#omarchy-plugin) · [REST API](#rest-api) · [SDK](#sdk) · [Daemon Mode](#daemon-mode) · [Publish to gno.sh](#publish-to-gnosh)
 
 **Under the hood** · [How It Works](#how-it-works) · [Features](#features) · [Local Models](#local-models) · [Fine-Tuned Models](#fine-tuned-models) · [Architecture](#architecture) · [Development](#development)
 
@@ -117,12 +117,25 @@ gno daemon --detach  # headless indexing + resident MCP gateway
 
 <!-- public-truth:current-version -->
 
-> Current release: **v1.35.0** — see [CHANGELOG.md](./CHANGELOG.md)
+> Current release: **v1.36.1**. See [CHANGELOG.md](./CHANGELOG.md).
 
 <!-- /public-truth -->
 
 > Full release history: [CHANGELOG.md](./CHANGELOG.md)
 
+- **Cheap peek snapshot**: `gno peek --json` and MCP `gno_peek` return a
+  model-free `peek@1.0` snapshot (document/collection counts, embedding backlog,
+  10 recent docs with `docid` and `absPath`, pid-file serve detection).
+  Uninitialized reports `initialized:false` with pinned nulls and exit 0. Any
+  subquery failure is an atomic `RUNTIME` envelope (exit 2). `serve.running` is
+  true only for `gno serve --detach`. JSON search hits pin
+  `results[].source.absPath`. Open a document in the Web UI with
+  `{serveUrl}/doc?uri=<encodeURIComponent(uri)>`.
+- **Prose-first snippets**: `gno search`, `gno vsearch`, and `gno query` skip
+  leading YAML frontmatter and prefer document prose. A frontmatter-dominated
+  FTS window falls back to stripped chunk prose. `--full` and `--line-numbers`
+  still emit raw source. `line` and `snippetRange.startLine` follow the trimmed
+  display range.
 - **Trustworthy local context compiler**: deterministic Context Capsules replace
   repeated agent `query → get → multi-get` orchestration with one bounded,
   citation-complete evidence handoff. The promoted benchmark retained 100%
@@ -544,7 +557,10 @@ Output formats: `--json`, `--files`, `--csv`, `--md`, `--xml`
 # Search one collection
 gno search "PostgreSQL connection pool" --collection work-docs
 
-# Export retrieval results for an agent
+# Cheap index snapshot for a status bar or desktop widget
+gno peek --json
+
+# Export retrieval results for an agent (`source.absPath` on file-backed hits)
 gno query "authentication flow" --json -n 10
 gno query "deployment rollback" --all --files --min-score 0.4
 
@@ -645,30 +661,31 @@ Connect GNO to Claude Desktop, Cursor, Raycast, and more:
 
 ![GNO MCP](./assets/screenshots/mcp.jpg)
 
-GNO exposes 25 tools by default via [Model Context Protocol](https://modelcontextprotocol.io),
+GNO exposes 33 tools by default via [Model Context Protocol](https://modelcontextprotocol.io),
 including the core retrieval tools below. Starting MCP with `--enable-write`
-adds 15 opt-in mutation tools, for 40 total.
-
-| Tool                 | Description                           |
-| :------------------- | :------------------------------------ |
-| `gno_search`         | BM25 keyword search                   |
-| `gno_vsearch`        | Vector semantic search                |
-| `gno_query`          | Hybrid search (recommended)           |
-| `gno_context`        | Budgeted exact evidence Capsule       |
-| `gno_context_verify` | Verify saved Capsule provenance       |
-| `gno_ask`            | Opt-in closed-Capsule verified answer |
-| `gno_get`            | Retrieve document by ID               |
-| `gno_multi_get`      | Batch document retrieval              |
-| `gno_links`          | Get outgoing links from document      |
-| `gno_backlinks`      | Get documents linking TO document     |
-| `gno_similar`        | Find semantically similar documents   |
-| `gno_graph`          | Get knowledge graph (nodes and edges) |
-| `gno_status`         | Index health check                    |
-| `gno_trace_list`     | List private local retrieval receipts |
-| `gno_trace_show`     | Inspect one bounded trace receipt     |
-| `gno_changes`        | Read retained metadata-only changes   |
-| `gno_diff`           | Read one structural document delta    |
-| `gno_impact`         | Trace bounded dependency impact       |
+adds 18 opt-in mutation tools, for 51 total.
+
+| Tool                 | Description                                     |
+| :------------------- | :---------------------------------------------- |
+| `gno_search`         | BM25 keyword search                             |
+| `gno_vsearch`        | Vector semantic search                          |
+| `gno_query`          | Hybrid search (recommended)                     |
+| `gno_context`        | Budgeted exact evidence Capsule                 |
+| `gno_context_verify` | Verify saved Capsule provenance                 |
+| `gno_ask`            | Opt-in closed-Capsule verified answer           |
+| `gno_get`            | Retrieve document by ID                         |
+| `gno_multi_get`      | Batch document retrieval                        |
+| `gno_links`          | Get outgoing links from document                |
+| `gno_backlinks`      | Get documents linking TO document               |
+| `gno_similar`        | Find semantically similar documents             |
+| `gno_graph`          | Get knowledge graph (nodes and edges)           |
+| `gno_peek`           | Cheap `peek@1.0` counts, backlog, recent, serve |
+| `gno_status`         | Index health check                              |
+| `gno_trace_list`     | List private local retrieval receipts           |
+| `gno_trace_show`     | Inspect one bounded trace receipt               |
+| `gno_changes`        | Read retained metadata-only changes             |
+| `gno_diff`           | Read one structural document delta              |
+| `gno_impact`         | Trace bounded dependency impact                 |
 
 **Design**: Default MCP mode is read-only: retrieval, opt-in verified synthesis,
 graph, status, and job inspection. Raw retrieval tools leave synthesis to your
@@ -792,6 +809,18 @@ gno.sh.
 
 ---
 
+## Omarchy Plugin
+
+On [Omarchy](https://omarchy.org/), [**GNO Recall**](https://github.com/gmickel/omarchy-gno-recall) puts the index in your bar: a quiet health widget, an anchored panel with counts and recent documents, and a keyboard-first overlay (Super+R) for search, deep search, collection browsing, and opening documents.
+
+```bash
+omarchy plugin add https://github.com/gmickel/omarchy-gno-recall --enable
+```
+
+Requires gno >= 1.36.0 on `PATH`.
+
+---
+
 ## Publish to gno.sh
 
 GNO is local-first, but sometimes you want a URL to send someone. [**gno.sh**](https://gno.sh/publish) is the hosted reader on top of GNO — a polished, reading-first page for a single note or a whole collection, without mounting your vault or syncing anything.

package/browser-extension/artifacts/gno-browser-clipper-v1.37.0.zip.sha256

@@ -0,0 +1 @@
+497d8e90a34b7472eac55da861c3049b7453a33d9fdbd0a27e49f2ce36ccde9b  gno-browser-clipper-v1.37.0.zip

package/browser-extension/dist/manifest.json

@@ -21,5 +21,5 @@
   "content_security_policy": {
     "extension_pages": "script-src 'self'; object-src 'none'; connect-src http://127.0.0.1:*"
   },
-  "version": "1.36.1"
+  "version": "1.37.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gmickel/gno",
-  "version": "1.36.1",
+  "version": "1.37.0",
   "description": "Local semantic search for your documents. Index Markdown, PDF, and Office files with hybrid BM25 + vector search.",
   "keywords": [
     "embeddings",
@@ -65,6 +65,7 @@
     "test": "bun test",
     "test:web": "bun test test/serve/public --timeout 30000",
     "test:e2e": "bun scripts/web-ui-smoke.ts",
+    "bench:webui-first-page": "bun scripts/webui-first-page-load.ts",
     "test:e2e:clipper": "bun test test/clipper/e2e.test.ts --timeout 240000",
     "test:e2e:pdf": "bun scripts/pdf-viewer-smoke.ts",
     "smoke:pdf-viewer": "bun scripts/pdf-viewer-smoke.ts",
@@ -144,8 +145,9 @@
     "website:sync-assets": "bun scripts/sync-assets.ts",
     "sync:agents": "scripts/sync-agents.sh",
     "build:css": "tailwindcss -i src/serve/public/globals.css -o src/serve/public/globals.built.css --minify",
+    "build:spa": "bun scripts/build-spa-production.ts",
     "serve": "bun src/index.ts serve",
-    "serve:dev": "NODE_ENV=development bun --hot src/index.ts serve",
+    "serve:dev": "bun --hot src/index.ts serve --dev",
     "version:patch": "npm version patch --no-git-tag-version",
     "version:minor": "npm version minor --no-git-tag-version",
     "version:major": "npm version major --no-git-tag-version",

package/spec/cli.md

@@ -3335,16 +3335,26 @@ API share the listener; use `gno daemon` for authenticated non-loopback MCP.
 **Synopsis:**
 
 ```bash
-gno serve [--port <num>] [gateway-options] [--detach] [--pid-file <path>] [--log-file <path>]
+gno serve [--port <num>] [--dev] [gateway-options] [--detach] [--pid-file <path>] [--log-file <path>]
 gno serve --status [--json]
 gno serve --stop
 ```
 
+Default `gno serve` (no `--dev`) is the production WebUI bundle, even when
+`NODE_ENV` is unset. Production serve loads the committed SPA snapshot
+(`assets/spa-production.json.gz`) so first listen does not wait on `Bun.build`.
+Refresh the snapshot with `bun scripts/build-spa-production.ts`. `--dev` is the
+operator switch for the development bundle and HMR (`serve:dev` / `bun --hot`
+remain the hot-reload path). `--dev` does not apply to `--status` or `--stop`
+(those paths do not boot the UI). A detached child inherits the same
+production default unless the parent was started with `--dev`.
+
 **Options:**
 
 | Option                 | Type    | Default                  | Description                                                      |
 | ---------------------- | ------- | ------------------------ | ---------------------------------------------------------------- |
 | `-p, --port`           | number  | 3000                     | Port to listen on                                                |
+| `--dev`                | boolean | false                    | Serve the development bundle with HMR (default is production)    |
 | `--detach`             | boolean | false                    | Self-spawn a detached child; parent prints `{pid,url}` and exits |
 | `--pid-file <path>`    | string  | `{data}/serve.pid`       | Override pid-file location (JSON metadata, absolute path)        |
 | `--log-file <path>`    | string  | `{data}/serve.log`       | Override log-file location (append mode)                         |
@@ -3423,6 +3433,7 @@ is blocked.
 ```bash
 gno serve
 gno serve --port 8080
+gno serve --dev
 
 # Backgrounding
 gno serve --detach

package/src/cli/program.ts

@@ -4164,12 +4164,29 @@ function wireServeCommand(program: Command): void {
       "internal detached-child marker"
     ).hideHelp()
   );
+  serveCmd.addOption(
+    new Option(
+      "--dev",
+      "serve the development bundle with HMR (default: production)"
+    )
+  );
 
   serveCmd.action(async (cmdOpts: Record<string, unknown>, cmd: Command) => {
     await handleServeAction(cmdOpts, cmd);
   });
 }
 
+/** CLI serve bundle mode. Default `gno serve` is production unless `--dev`. */
+export function resolveServeNodeEnv(
+  dev: boolean
+): "development" | "production" {
+  return dev ? "development" : "production";
+}
+
+function applyServeBundleEnv(dev: boolean): void {
+  process.env.NODE_ENV = resolveServeNodeEnv(dev);
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Serve lifecycle branching (detach / status / stop / detached-child / fg)
 // ─────────────────────────────────────────────────────────────────────────────
@@ -4238,6 +4255,9 @@ async function handleServeAction(
     return;
   }
 
+  const dev = cmdOpts.dev === true;
+  applyServeBundleEnv(dev);
+
   if (cmdOpts.detach) {
     const port = parsePositiveInt("port", cmdOpts.port);
     await runServeDetach({
@@ -4245,6 +4265,7 @@ async function handleServeAction(
       paths,
       spawnDetached,
       argv: resolveCliArgv(cmd),
+      nodeEnv: resolveServeNodeEnv(dev),
     });
     return;
   }
@@ -4423,6 +4444,7 @@ interface ServeDetachDeps {
    * can't taint each other's child argv.
    */
   argv: string[];
+  nodeEnv: "development" | "production";
 }
 
 async function runServeDetach(deps: ServeDetachDeps): Promise<void> {
@@ -4432,6 +4454,7 @@ async function runServeDetach(deps: ServeDetachDeps): Promise<void> {
   const result = await deps.spawnDetached({
     kind: "serve",
     argv: childArgv,
+    env: { NODE_ENV: deps.nodeEnv },
     pidFile: deps.paths.pidFile,
     logFile: deps.paths.logFile,
     port: deps.port,

package/src/serve/public/app.tsx

@@ -1,9 +1,14 @@
-import { useCallback, useEffect, useMemo, useState } from "react";
+import {
+  lazy,
+  Suspense,
+  useCallback,
+  useEffect,
+  useMemo,
+  useState,
+} from "react";
 import { createRoot } from "react-dom/client";
 
 import { HelpButton } from "./components/HelpButton";
-import { QuickSwitcher } from "./components/QuickSwitcher";
-import { ShortcutHelpModal } from "./components/ShortcutHelpModal";
 import { WorkspaceTabs } from "./components/WorkspaceTabs";
 import { CaptureModalProvider, useCaptureModal } from "./hooks/useCaptureModal";
 import { useKeyboardShortcuts } from "./hooks/useKeyboardShortcuts";
@@ -21,17 +26,28 @@ import {
   updateActiveTabBrowseState,
   type WorkspaceState,
 } from "./lib/workspace-tabs";
-import Ask from "./pages/Ask";
-import Browse from "./pages/Browse";
 import ClipperPairing from "./pages/ClipperPairing";
-import Collections from "./pages/Collections";
-import Connectors from "./pages/Connectors";
 import Dashboard from "./pages/Dashboard";
-import DocumentEditor from "./pages/DocumentEditor";
-import DocView from "./pages/DocView";
-import GraphView from "./pages/GraphView";
-import Search from "./pages/Search";
-import TraceHistory from "./pages/TraceHistory";
+
+const QuickSwitcher = lazy(() =>
+  import("./components/QuickSwitcher").then((module) => ({
+    default: module.QuickSwitcher,
+  }))
+);
+const ShortcutHelpModal = lazy(() =>
+  import("./components/ShortcutHelpModal").then((module) => ({
+    default: module.ShortcutHelpModal,
+  }))
+);
+const Search = lazy(() => import("./pages/Search"));
+const Browse = lazy(() => import("./pages/Browse"));
+const DocView = lazy(() => import("./pages/DocView"));
+const DocumentEditor = lazy(() => import("./pages/DocumentEditor"));
+const Collections = lazy(() => import("./pages/Collections"));
+const Connectors = lazy(() => import("./pages/Connectors"));
+const Ask = lazy(() => import("./pages/Ask"));
+const GraphView = lazy(() => import("./pages/GraphView"));
+const TraceHistory = lazy(() => import("./pages/TraceHistory"));
 
 type Route =
   | "/"
@@ -155,7 +171,9 @@ function AppContent({
           tabs={workspace.tabs}
         />
         <div className="flex-1">
-          <Page key={pageKey} location={location} navigate={navigate} />
+          <Suspense fallback={null}>
+            <Page key={pageKey} location={location} navigate={navigate} />
+          </Suspense>
         </div>
         <footer className="border-t border-border/30 bg-background/60 py-6 text-center text-sm backdrop-blur-sm">
           <div className="ornament mx-auto mb-4 max-w-[8rem] text-muted-foreground/20">
@@ -217,17 +235,19 @@ function AppContent({
         </footer>
       </div>
       <HelpButton onClick={() => setShortcutHelpOpen(true)} />
-      <QuickSwitcher
-        location={location}
-        navigate={(to) => navigate(to)}
-        onCreateNote={openCapture}
-        onOpenChange={setQuickSwitcherOpen}
-        open={quickSwitcherOpen}
-      />
-      <ShortcutHelpModal
-        onOpenChange={setShortcutHelpOpen}
-        open={shortcutHelpOpen}
-      />
+      <Suspense fallback={null}>
+        <QuickSwitcher
+          location={location}
+          navigate={(to) => navigate(to)}
+          onCreateNote={openCapture}
+          onOpenChange={setQuickSwitcherOpen}
+          open={quickSwitcherOpen}
+        />
+        <ShortcutHelpModal
+          onOpenChange={setShortcutHelpOpen}
+          open={shortcutHelpOpen}
+        />
+      </Suspense>
     </>
   );
 }

package/src/serve/public/components/ai-elements/code-block.tsx

@@ -33,14 +33,19 @@ const CodeBlockContext = createContext<CodeBlockContextType>({
   code: "",
 });
 
-const highlighterPromise = createHighlighter({
-  engine: createJavaScriptRegexEngine(),
-  langs: ["text"],
-  themes: ["one-light", "one-dark-pro"],
-});
+let highlighterPromise: ReturnType<typeof createHighlighter> | null = null;
+
+function getHighlighterRuntime(): ReturnType<typeof createHighlighter> {
+  highlighterPromise ??= createHighlighter({
+    engine: createJavaScriptRegexEngine(),
+    langs: ["text"],
+    themes: ["one-light", "one-dark-pro"],
+  });
+  return highlighterPromise;
+}
 
 async function getHighlighter(language: BundledLanguage | "text") {
-  const highlighter = await highlighterPromise;
+  const highlighter = await getHighlighterRuntime();
   if (!highlighter.getLoadedLanguages().includes(language)) {
     await highlighter.loadLanguage(language);
   }

package/src/serve/public/index.html

@@ -2,7 +2,6 @@
 <html lang="en">
   <head>
     <meta charset="UTF-8" />
-    <base href="/" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="referrer" content="no-referrer" />
     <title>GNO - Local Knowledge Index</title>

package/src/serve/public/lib/code-language.ts

@@ -1,4 +1,6 @@
-import { bundledLanguages, type BundledLanguage } from "shiki";
+import type { BundledLanguage } from "shiki";
+
+import { BUNDLED_LANGUAGE_IDS } from "./shiki-language-ids";
 
 export type CodeLanguage = BundledLanguage | "text";
 
@@ -41,7 +43,7 @@ export function resolveCodeLanguage(
     return "text";
   }
 
-  if (aliased in bundledLanguages) {
+  if (BUNDLED_LANGUAGE_IDS.has(aliased)) {
     return aliased as BundledLanguage;
   }