@gmickel/gno 0.9.5 → 0.10.0

package/README.md

@@ -303,20 +303,21 @@ graph TD
 
 ## Features
 
-| 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          |
+| 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                             |
+| **Tag Filtering**   | Frontmatter tags with hierarchical paths, filter via `--tags-any`/`--tags-all` |
+| **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                                   |
 
 ---
 

package/assets/skill/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: gno
 description: Search local documents, files, notes, and knowledge bases. Index directories, search with BM25/vector/hybrid, get AI answers with citations. Use when user wants to search files, find documents, query notes, look up information in local folders, index a directory, set up document search, build a knowledge base, needs RAG/semantic search, or wants to start a local web UI for their docs.
-allowed-tools: Bash(gno:*), Read
+allowed-tools: Bash(gno:*) Read
 ---
 
 # GNO - Local Knowledge Engine
@@ -22,6 +22,8 @@ Fast local semantic search for your documents. Index once, search instantly. No
 - User needs to **set up MCP** for document access
 - User wants a **web UI** to browse/search documents
 - User asks to **get AI answers** from their documents
+- User wants to **tag, categorize, or label** documents
+- User needs to **filter search by tags** or categories
 
 ## Quick Start
 
@@ -59,6 +61,10 @@ gno search "api" -n 10
 # Filter by collection
 gno query "auth" --collection work
 
+# Filter by tags
+gno search "api" --tags-any project,work     # Has ANY of these tags
+gno query "auth" --tags-all security,prod    # Has ALL of these tags
+
 # Search modes (for query/ask)
 gno query "topic" --fast       # ~0.7s, skip expansion/rerank
 gno query "topic"              # ~2-3s, default with rerank
@@ -135,6 +141,31 @@ gno context add "/" "Corporate knowledge base"
 gno context add "work:" "Work documents and contracts"
 ```
 
+### Tags
+
+| Command                    | Description               |
+| -------------------------- | ------------------------- |
+| `gno tags`                 | List all tags with counts |
+| `gno tags add <doc> <tag>` | Add tag to document       |
+| `gno tags rm <doc> <tag>`  | Remove tag from document  |
+
+```bash
+# List tags
+gno tags
+gno tags --collection work
+gno tags --prefix project/      # Hierarchical tags
+
+# Add/remove tags
+gno tags add gno://work/readme.md project/api
+gno tags rm "#a1b2c3d4" draft
+
+# Filter searches by tags
+gno search "api" --tags-any project,work
+gno query "auth" --tags-all security,reviewed
+```
+
+Tag format: lowercase, alphanumeric, hyphens, dots. Hierarchical with `/` (e.g., `project/web`, `status/draft`).
+
 ### Web UI
 
 | Command             | Description              |

package/assets/skill/cli-reference.md

@@ -103,14 +103,16 @@ 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             |
+| `--tags-any`       | -       | Filter: has ANY tag (comma-sep)  |
+| `--tags-all`       | -       | Filter: has ALL tags (comma-sep) |
+| `--full`           | false   | Full content (not snippets)      |
+| `--line-numbers`   | false   | Include line numbers             |
+| `--lang`           | auto    | Language filter                  |
 
 Output formats: `--json`, `--files`, `--csv`, `--md`, `--xml`
 
@@ -222,6 +224,42 @@ gno context list [--json|--md]
 gno context rm <scope>
 ```
 
+## Tags
+
+### gno tags
+
+List tags with document counts.
+
+```bash
+gno tags [options]
+```
+
+| Option             | Description           |
+| ------------------ | --------------------- |
+| `-c, --collection` | Filter by collection  |
+| `--prefix`         | Filter by tag prefix  |
+| `--json`           | JSON output           |
+| `--md`             | Markdown table output |
+
+### gno tags add
+
+Add tag to document.
+
+```bash
+gno tags add <doc> <tag>
+```
+
+- `doc`: URI (`gno://...`) or docid (`#abc123`)
+- `tag`: Tag string (lowercase, alphanumeric, hyphens, dots, `/` for hierarchy)
+
+### gno tags rm
+
+Remove tag from document.
+
+```bash
+gno tags rm <doc> <tag>
+```
+
 ## Models
 
 ### gno models list

package/assets/skill/examples.md

@@ -191,6 +191,50 @@ gno models use quality
 gno models pull
 ```
 
+## Tagging
+
+### List and manage tags
+
+```bash
+# List all tags with counts
+gno tags
+
+# Filter by collection
+gno tags -c work
+
+# Filter by prefix (hierarchical)
+gno tags --prefix project/
+```
+
+### Add/remove tags
+
+```bash
+# Add tag to document
+gno tags add gno://work/readme.md project/api
+
+# Remove tag
+gno tags rm gno://work/readme.md draft
+
+# Tags in frontmatter are extracted automatically
+cat myfile.md
+# ---
+# tags: [project/web, status/review]
+# ---
+```
+
+### Filter search by tags
+
+```bash
+# Find docs with ANY of these tags (OR)
+gno search "api" --tags-any project,work
+
+# Find docs with ALL of these tags (AND)
+gno query "auth" --tags-all security,reviewed
+
+# Combine with other filters
+gno ask "deployment steps" -c work --tags-any devops --answer
+```
+
 ## Tips
 
 ### Search Modes

package/assets/skill/mcp-reference.md

@@ -45,10 +45,21 @@ BM25 keyword search.
   "collection": "optional-collection",
   "limit": 5,
   "minScore": 0.5,
-  "lang": "en"
+  "lang": "en",
+  "tagsAny": ["project", "work"],
+  "tagsAll": ["reviewed"]
 }
 ```
 
+| Parameter    | Description                         |
+| ------------ | ----------------------------------- |
+| `query`      | Search query (required)             |
+| `collection` | Filter by collection                |
+| `limit`      | Max results (default: 5)            |
+| `minScore`   | Minimum score 0-1                   |
+| `tagsAny`    | Filter: has ANY of these tags (OR)  |
+| `tagsAll`    | Filter: has ALL of these tags (AND) |
+
 ### gno.vsearch
 
 Vector semantic search. Same parameters as `gno.search`.
@@ -122,6 +133,40 @@ Get index status.
 {}
 ```
 
+### gno.list_tags
+
+List tags with document counts.
+
+```json
+{
+  "collection": "optional-collection",
+  "prefix": "project/"
+}
+```
+
+| Parameter    | Description                             |
+| ------------ | --------------------------------------- |
+| `collection` | Filter by collection                    |
+| `prefix`     | Filter by tag prefix (e.g., `project/`) |
+
+### gno.tag
+
+Add or remove tag from document.
+
+```json
+{
+  "ref": "gno://work/readme.md",
+  "tag": "project/api",
+  "action": "add"
+}
+```
+
+| Parameter | Description                        |
+| --------- | ---------------------------------- |
+| `ref`     | Document URI or docid (required)   |
+| `tag`     | Tag string (required)              |
+| `action`  | `add` or `remove` (default: `add`) |
+
 ## Resources
 
 Documents accessible as MCP resources:

package/package.json

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

package/src/cli/CLAUDE.md

@@ -19,6 +19,7 @@ src/cli/
     ├── search.ts
     ├── query.ts
     ├── ask.ts
+    ├── tags.ts        # Tag management (list, add, remove)
     └── ...
 ```
 
@@ -94,3 +95,26 @@ bun test test/cli/
 ```
 
 Use `--json` output for assertions in tests.
+
+## Tag Commands
+
+Tag management commands in `src/cli/commands/tags.ts`:
+
+```bash
+# List all tags (with doc counts)
+gno tags
+
+# Add tags to document
+gno tag add <path> tag1 tag2
+
+# Remove tags from document
+gno tag remove <path> tag1
+
+# Filter search/query by tags
+gno search "query" --tags=foo,bar
+```
+
+- Tags normalized via `src/core/tags.ts`: lowercase, trimmed, validated
+- Stored in `doc_tags` junction table with `source` column (frontmatter|user)
+- Frontmatter tags extracted during ingestion (`src/ingestion/frontmatter.ts`)
+- User-added tags can be removed; frontmatter tags are read-only