@gmickel/gno 0.7.0 → 0.8.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Gordon Mickel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -99,12 +99,12 @@ gno skill install --target all       # Both Claude + Codex
 
 ## Search Modes
 
-| Command | Mode | Best For |
-|:--------|:-----|:---------|
-| `gno search` | Document-level BM25 | Exact phrases, code identifiers |
-| `gno vsearch` | Contextual Vector | Natural language, concepts |
-| `gno query` | Hybrid | Best accuracy (BM25 + vector + reranking) |
-| `gno ask --answer` | RAG | Direct answers with citations |
+| Command            | Mode                | Best For                                  |
+| :----------------- | :------------------ | :---------------------------------------- |
+| `gno search`       | Document-level BM25 | Exact phrases, code identifiers           |
+| `gno vsearch`      | Contextual Vector   | Natural language, concepts                |
+| `gno query`        | Hybrid              | Best accuracy (BM25 + vector + reranking) |
+| `gno ask --answer` | RAG                 | Direct answers with citations             |
 
 **BM25** indexes full documents (not chunks) with Snowball stemming—"running" matches "run".
 **Vector** embeds chunks with document titles for context awareness.
@@ -122,22 +122,53 @@ Output formats: `--json`, `--files`, `--csv`, `--md`, `--xml`
 
 ## Web UI
 
-Visual dashboard for search, browsing, and AI answers—right in your browser.
+Visual dashboard for search, browsing, editing, and AI answers—right in your browser.
 
 ```bash
 gno serve                    # Start on port 3000
 gno serve --port 8080        # Custom port
 ```
 
-![GNO Web UI](./assets/screenshots/webui-home.jpg)
+![GNO Web UI](./assets/screenshots/webui-home.png)
 
 Open `http://localhost:3000` to:
 
 - **Search** — BM25, vector, or hybrid modes with visual results
 - **Browse** — Paginated document list, filter by collection
+- **Edit** — Create, edit, and delete documents with live preview
 - **Ask** — AI-powered Q&A with citations
+- **Manage Collections** — Add, remove, and re-index collections
 - **Switch presets** — Change models live without restart
 
+### Document Editing
+
+![GNO Document Editor](./assets/screenshots/webui-editor.png)
+
+Full-featured markdown editor with:
+
+| Feature                 | Description                          |
+| :---------------------- | :----------------------------------- |
+| **Split View**          | Side-by-side editor and live preview |
+| **Auto-save**           | 2-second debounced saves             |
+| **Syntax Highlighting** | CodeMirror 6 with markdown support   |
+| **Keyboard Shortcuts**  | ⌘S save, ⌘B bold, ⌘I italic, ⌘K link |
+| **Quick Capture**       | ⌘N creates new note from anywhere    |
+
+### Collections Management
+
+![GNO Collections](./assets/screenshots/webui-collections.png)
+
+- Add collections with folder path input
+- View document count, chunk count, embedding status
+- Re-index individual collections
+- Remove collections (documents preserved)
+
+### AI Answers
+
+![GNO AI Answers](./assets/screenshots/webui-ask-answer.png)
+
+Ask questions in natural language—GNO searches your documents and synthesizes answers with inline citations linking to sources.
+
 Everything runs locally. No cloud, no accounts, no data leaving your machine.
 
 > **Detailed docs**: [Web UI Guide](https://gno.sh/docs/WEB-UI/)
@@ -163,17 +194,24 @@ curl -X POST http://localhost:3000/api/ask \
 curl http://localhost:3000/api/status
 ```
 
-| Endpoint | Method | Description |
-|:---------|:-------|:------------|
-| `/api/query` | POST | Hybrid search (recommended) |
-| `/api/search` | POST | BM25 keyword search |
-| `/api/ask` | POST | AI-powered Q&A |
-| `/api/docs` | GET | List documents |
-| `/api/doc` | GET | Get document content |
-| `/api/status` | GET | Index statistics |
-| `/api/presets` | GET/POST | Model preset management |
-| `/api/models/pull` | POST | Download models |
-| `/api/models/status` | GET | Download progress |
+| Endpoint                   | Method | Description                 |
+| :------------------------- | :----- | :-------------------------- |
+| `/api/query`               | POST   | Hybrid search (recommended) |
+| `/api/search`              | POST   | BM25 keyword search         |
+| `/api/ask`                 | POST   | AI-powered Q&A              |
+| `/api/docs`                | GET    | List documents              |
+| `/api/docs`                | POST   | Create document             |
+| `/api/docs/:id`            | PUT    | Update document content     |
+| `/api/docs/:id/deactivate` | POST   | Remove from index           |
+| `/api/doc`                 | GET    | Get document content        |
+| `/api/collections`         | POST   | Add collection              |
+| `/api/collections/:name`   | DELETE | Remove collection           |
+| `/api/sync`                | POST   | Trigger re-index            |
+| `/api/status`              | GET    | Index statistics            |
+| `/api/presets`             | GET    | List model presets          |
+| `/api/presets`             | POST   | Switch preset               |
+| `/api/models/pull`         | POST   | Download models             |
+| `/api/models/status`       | GET    | Download progress           |
 
 No authentication. No rate limits. Build custom tools, automate workflows, integrate with any language.
 
@@ -189,14 +227,14 @@ No authentication. No rate limits. Build custom tools, automate workflows, integ
 
 GNO exposes 6 tools via [Model Context Protocol](https://modelcontextprotocol.io):
 
-| Tool | Description |
-|:-----|:------------|
-| `gno_search` | BM25 keyword search |
-| `gno_vsearch` | Vector semantic search |
-| `gno_query` | Hybrid search (recommended) |
-| `gno_get` | Retrieve document by ID |
-| `gno_multi_get` | Batch document retrieval |
-| `gno_status` | Index health check |
+| Tool            | Description                 |
+| :-------------- | :-------------------------- |
+| `gno_search`    | BM25 keyword search         |
+| `gno_vsearch`   | Vector semantic search      |
+| `gno_query`     | Hybrid search (recommended) |
+| `gno_get`       | Retrieve document by ID     |
+| `gno_multi_get` | Batch document retrieval    |
+| `gno_status`    | Index health check          |
 
 **Design**: MCP tools are retrieval-only. Your AI assistant (Claude, GPT-4) synthesizes answers from retrieved context—best retrieval (GNO) + best reasoning (your LLM).
 
@@ -210,7 +248,7 @@ gno skill install --scope user
 
 ![GNO Skill in Claude Code](./assets/screenshots/claudecodeskill.jpg)
 
-Then ask your agent: *"Search my notes for the auth discussion"*
+Then ask your agent: _"Search my notes for the auth discussion"_
 
 > **Detailed docs**: [MCP Integration](https://gno.sh/docs/MCP/) · [Use Cases](https://gno.sh/docs/USE-CASES/)
 
@@ -253,18 +291,20 @@ graph TD
 
 ## Features
 
-| Feature | Description |
-|:--------|:------------|
-| **Hybrid Search** | BM25 + vector + RRF fusion + cross-encoder reranking |
-| **Web UI** | Visual dashboard for search, browse, and AI Q&A |
-| **REST API** | HTTP API for custom tools and integrations |
-| **Multi-Format** | Markdown, PDF, DOCX, XLSX, PPTX, plain text |
-| **Local LLM** | AI answers via llama.cpp—no API keys |
-| **Privacy First** | 100% offline, zero telemetry, your data stays yours |
-| **MCP Server** | Works with Claude Desktop, Cursor, Zed, + 8 more |
-| **Collections** | Organize sources with patterns, excludes, contexts |
-| **Multilingual** | 30+ languages, auto-detection, cross-lingual search |
-| **Incremental** | SHA-256 tracking—only changed files re-indexed |
+| Feature             | Description                                           |
+| :------------------ | :---------------------------------------------------- |
+| **Hybrid Search**   | BM25 + vector + RRF fusion + cross-encoder reranking  |
+| **Document Editor** | Create, edit, delete docs with live markdown preview  |
+| **Web UI**          | Visual dashboard for search, browse, edit, and AI Q&A |
+| **REST API**        | HTTP API for custom tools and integrations            |
+| **Multi-Format**    | Markdown, PDF, DOCX, XLSX, PPTX, plain text           |
+| **Local LLM**       | AI answers via llama.cpp—no API keys                  |
+| **Privacy First**   | 100% offline, zero telemetry, your data stays yours   |
+| **MCP Server**      | Works with Claude Desktop, Cursor, Zed, + 8 more      |
+| **Collections**     | Organize sources with patterns, excludes, contexts    |
+| **Multilingual**    | 30+ languages, auto-detection, cross-lingual search   |
+| **Incremental**     | SHA-256 tracking—only changed files re-indexed        |
+| **Keyboard First**  | ⌘N capture, ⌘K search, ⌘/ shortcuts, ⌘S save          |
 
 ---
 
@@ -272,19 +312,19 @@ graph TD
 
 Models auto-download on first use to `~/.cache/gno/models/`.
 
-| Model | Purpose | Size |
-|:------|:--------|:-----|
-| bge-m3 | Embeddings (1024-dim, multilingual) | ~500MB |
-| Qwen3-Reranker-0.6B | Cross-encoder reranking (32K context) | ~700MB |
-| Qwen/SmolLM | Query expansion + AI answers | ~600MB-1.2GB |
+| Model               | Purpose                               | Size         |
+| :------------------ | :------------------------------------ | :----------- |
+| bge-m3              | Embeddings (1024-dim, multilingual)   | ~500MB       |
+| Qwen3-Reranker-0.6B | Cross-encoder reranking (32K context) | ~700MB       |
+| Qwen/SmolLM         | Query expansion + AI answers          | ~600MB-1.2GB |
 
 ### Model Presets
 
-| Preset | Disk | Best For |
-|:-------|:-----|:---------|
-| `slim` | ~1GB | Fast, lower quality |
-| `balanced` | ~2GB | Good balance (default) |
-| `quality` | ~2.5GB | Best answers |
+| Preset     | Disk   | Best For               |
+| :--------- | :----- | :--------------------- |
+| `slim`     | ~1GB   | Fast, lower quality    |
+| `balanced` | ~2GB   | Good balance (default) |
+| `quality`  | ~2.5GB | Best answers           |
 
 ```bash
 gno models use balanced

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,22 @@
+# Third-Party Notices
+
+This project includes the following third-party components:
+
+## fts5-snowball
+
+- **Source**: vendored under `vendor/fts5-snowball/`
+- **License**: BSD-3-Clause
+- **Copyright**: (c) 2016 Abilio Marques
+- **Project URL**: https://github.com/abiliojr/fts5-snowball
+
+See `vendor/fts5-snowball/LICENSE` for the full license text.
+
+## Snowball Stemmer Library
+
+Bundled within fts5-snowball.
+
+- **License**: BSD-3-Clause
+- **Copyright**: (c) 2001-2025 Dr Martin Porter and Richard Boulton
+- **Project URL**: https://github.com/snowballstem/snowball
+
+See `vendor/fts5-snowball/LICENSE` for the full license text.

package/assets/skill/SKILL.md

@@ -41,21 +41,21 @@ gno search "your query"
 
 ### Indexing
 
-| Command | Description |
-|---------|-------------|
-| `gno init` | Initialize GNO in current directory |
-| `gno collection add <path> --name <name>` | Add folder to index |
-| `gno index` | Full index (ingest + embed) |
-| `gno update` | Sync files without embedding |
+| Command                                   | Description                         |
+| ----------------------------------------- | ----------------------------------- |
+| `gno init`                                | Initialize GNO in current directory |
+| `gno collection add <path> --name <name>` | Add folder to index                 |
+| `gno index`                               | Full index (ingest + embed)         |
+| `gno update`                              | Sync files without embedding        |
 
 ### Searching
 
-| Command | Description |
-|---------|-------------|
-| `gno search <query>` | BM25 keyword search |
-| `gno vsearch <query>` | Vector semantic search |
-| `gno query <query>` | Hybrid search (BM25 + vector + rerank) |
-| `gno ask <question>` | AI-powered Q&A with citations |
+| Command               | Description                            |
+| --------------------- | -------------------------------------- |
+| `gno search <query>`  | BM25 keyword search                    |
+| `gno vsearch <query>` | Vector semantic search                 |
+| `gno query <query>`   | Hybrid search (BM25 + vector + rerank) |
+| `gno ask <question>`  | AI-powered Q&A with citations          |
 
 ### Common Options
 

package/assets/skill/cli-reference.md

@@ -6,14 +6,14 @@ Complete command reference for GNO.
 
 All commands accept:
 
-| Flag | Description |
-|------|-------------|
-| `--index <name>` | Use alternate index (default: "default") |
-| `--config <path>` | Override config file path |
-| `--no-color` | Disable colored output |
-| `--verbose` | Enable verbose logging |
-| `--yes` | Non-interactive mode |
-| `--json` | JSON output (where supported) |
+| Flag              | Description                              |
+| ----------------- | ---------------------------------------- |
+| `--index <name>`  | Use alternate index (default: "default") |
+| `--config <path>` | Override config file path                |
+| `--no-color`      | Disable colored output                   |
+| `--verbose`       | Enable verbose logging                   |
+| `--yes`           | Non-interactive mode                     |
+| `--json`          | JSON output (where supported)            |
 
 ## Initialization
 
@@ -23,14 +23,14 @@ All commands accept:
 gno init [<path>] [options]
 ```
 
-| Option | Description |
-|--------|-------------|
-| `--name <name>` | Collection name |
-| `--pattern <glob>` | File pattern (default: `**/*`) |
-| `--include <exts>` | Extension allowlist (e.g., `.md,.pdf`) |
-| `--exclude <paths>` | Exclude patterns (default: `.git,node_modules`) |
-| `--tokenizer <type>` | FTS tokenizer: unicode61, porter, trigram |
-| `--language <code>` | BCP-47 language hint |
+| Option               | Description                                     |
+| -------------------- | ----------------------------------------------- |
+| `--name <name>`      | Collection name                                 |
+| `--pattern <glob>`   | File pattern (default: `**/*`)                  |
+| `--include <exts>`   | Extension allowlist (e.g., `.md,.pdf`)          |
+| `--exclude <paths>`  | Exclude patterns (default: `.git,node_modules`) |
+| `--tokenizer <type>` | FTS tokenizer: unicode61, porter, trigram       |
+| `--language <code>`  | BCP-47 language hint                            |
 
 ## Collections
 
@@ -78,12 +78,12 @@ Full index (update + embed).
 gno index [options]
 ```
 
-| Option | Description |
-|--------|-------------|
+| Option                | Description                |
+| --------------------- | -------------------------- |
 | `--collection <name>` | Scope to single collection |
-| `--no-embed` | Skip embedding |
-| `--models-pull` | Download models if missing |
-| `--git-pull` | Git pull before indexing |
+| `--no-embed`          | Skip embedding             |
+| `--models-pull`       | Download models if missing |
+| `--git-pull`          | Git pull before indexing   |
 
 ### gno embed
 
@@ -103,14 +103,14 @@ BM25 keyword search.
 gno search <query> [options]
 ```
 
-| Option | Default | Description |
-|--------|---------|-------------|
-| `-n` | 5 | Max results |
-| `--min-score` | 0 | Minimum score (0-1) |
-| `-c, --collection` | all | Filter to collection |
-| `--full` | false | Full content (not snippets) |
-| `--line-numbers` | false | Include line numbers |
-| `--lang` | auto | Language filter |
+| Option             | Default | Description                 |
+| ------------------ | ------- | --------------------------- |
+| `-n`               | 5       | Max results                 |
+| `--min-score`      | 0       | Minimum score (0-1)         |
+| `-c, --collection` | all     | Filter to collection        |
+| `--full`           | false   | Full content (not snippets) |
+| `--line-numbers`   | false   | Include line numbers        |
+| `--lang`           | auto    | Language filter             |
 
 Output formats: `--json`, `--files`, `--csv`, `--md`, `--xml`
 
@@ -132,19 +132,19 @@ gno query <query> [options]
 
 **Search modes** (pick one):
 
-| Flag | Time | Description |
-|------|------|-------------|
-| `--fast` | ~0.7s | Skip expansion and reranking |
-| (default) | ~2-3s | Skip expansion, with reranking |
-| `--thorough` | ~5-8s | Full pipeline with expansion |
+| Flag         | Time  | Description                    |
+| ------------ | ----- | ------------------------------ |
+| `--fast`     | ~0.7s | Skip expansion and reranking   |
+| (default)    | ~2-3s | Skip expansion, with reranking |
+| `--thorough` | ~5-8s | Full pipeline with expansion   |
 
 Additional options:
 
-| Option | Description |
-|--------|-------------|
-| `--no-expand` | Disable query expansion |
-| `--no-rerank` | Disable reranking |
-| `--explain` | Print retrieval details to stderr |
+| Option        | Description                       |
+| ------------- | --------------------------------- |
+| `--no-expand` | Disable query expansion           |
+| `--no-rerank` | Disable reranking                 |
+| `--explain`   | Print retrieval details to stderr |
 
 ### gno ask
 
@@ -154,14 +154,14 @@ AI-powered Q&A with citations.
 gno ask <question> [options]
 ```
 
-| Option | Description |
-|--------|-------------|
-| `--fast` | Skip expansion and reranking (fastest) |
-| `--thorough` | Enable query expansion (better recall) |
-| `--answer` | Generate grounded answer |
-| `--no-answer` | Retrieval only |
-| `--max-answer-tokens <n>` | Cap answer length |
-| `--show-sources` | Show all sources |
+| Option                    | Description                            |
+| ------------------------- | -------------------------------------- |
+| `--fast`                  | Skip expansion and reranking (fastest) |
+| `--thorough`              | Enable query expansion (better recall) |
+| `--answer`                | Generate grounded answer               |
+| `--no-answer`             | Retrieval only                         |
+| `--max-answer-tokens <n>` | Cap answer length                      |
+| `--show-sources`          | Show all sources                       |
 
 ## Document Retrieval
 
@@ -174,6 +174,7 @@ gno get <ref> [--from <line>] [-l <lines>] [--line-numbers] [--source]
 ```
 
 Ref formats:
+
 - `gno://collection/path` — Full URI
 - `collection/path` — Relative path
 - `#docid` — Document ID
@@ -204,6 +205,7 @@ gno context add <scope> "<text>"
 ```
 
 Scope formats:
+
 - `/` — Global
 - `collection:` — Collection prefix
 - `gno://collection/path` — Path prefix
@@ -292,12 +294,12 @@ Install GNO as MCP server in client configurations.
 gno mcp install [options]
 ```
 
-| Option | Default | Description |
-|--------|---------|-------------|
+| Option         | Default        | Description                                      |
+| -------------- | -------------- | ------------------------------------------------ |
 | `-t, --target` | claude-desktop | Target: `claude-desktop`, `claude-code`, `codex` |
-| `-s, --scope` | user | Scope: `user`, `project` |
-| `-f, --force` | false | Overwrite existing config |
-| `--dry-run` | false | Preview changes |
+| `-s, --scope`  | user           | Scope: `user`, `project`                         |
+| `-f, --force`  | false          | Overwrite existing config                        |
+| `--dry-run`    | false          | Preview changes                                  |
 
 Examples:
 
@@ -330,8 +332,8 @@ gno mcp status [--json]
 
 ## 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) |

package/assets/skill/examples.md

@@ -195,15 +195,16 @@ gno models pull
 
 ### Search Modes
 
-| Command | Time | Use When |
-|---------|------|----------|
-| `gno search` | instant | Exact keyword matching |
-| `gno vsearch` | ~0.5s | Finding similar concepts |
-| `gno query --fast` | ~0.7s | Quick lookups |
-| `gno query` | ~2-3s | Default, balanced |
-| `gno query --thorough` | ~5-8s | Best recall, complex queries |
+| Command                | Time    | Use When                     |
+| ---------------------- | ------- | ---------------------------- |
+| `gno search`           | instant | Exact keyword matching       |
+| `gno vsearch`          | ~0.5s   | Finding similar concepts     |
+| `gno query --fast`     | ~0.7s   | Quick lookups                |
+| `gno query`            | ~2-3s   | Default, balanced            |
+| `gno query --thorough` | ~5-8s   | Best recall, complex queries |
 
 **Agent retry strategy**: Use default mode first. If no results:
+
 1. Rephrase the query (free, often helps)
 2. Try `--thorough` for better recall
 

package/assets/skill/mcp-reference.md

@@ -20,6 +20,7 @@ Add to `claude_desktop_config.json`:
 ```
 
 Config location:
+
 - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
 - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 - Linux: `~/.config/Claude/claude_desktop_config.json`
@@ -66,15 +67,16 @@ Hybrid search (best quality).
 
 **Search modes** (via parameters):
 
-| Mode | Parameters | Time |
-|------|------------|------|
-| Fast | `fast: true` | ~0.7s |
-| Default | (none) | ~2-3s |
+| Mode     | Parameters       | Time  |
+| -------- | ---------------- | ----- |
+| Fast     | `fast: true`     | ~0.7s |
+| Default  | (none)           | ~2-3s |
 | Thorough | `thorough: true` | ~5-8s |
 
 Default skips expansion, with reranking. Use `thorough: true` for best recall.
 
 **Agent retry strategy**: Use default mode first. If no relevant results:
+
 1. Rephrase the query (free, often effective)
 2. Then try `thorough: true` for better recall
 
@@ -129,6 +131,7 @@ gno://{collection}/{path}
 ```
 
 Examples:
+
 - `gno://work/contracts/nda.docx`
 - `gno://notes/2025/01/meeting.md`
 
@@ -166,6 +169,7 @@ Errors return:
 ## Graceful Degradation
 
 `gno.query` degrades gracefully:
+
 - No vectors → BM25 only
 - No expansion model → skips expansion
 - No rerank model → skips reranking