@gmickel/gno 0.13.0 → 0.13.2

package/README.md

@@ -7,7 +7,11 @@
 [![Website](./assets/badges/website.svg)](https://gno.sh)
 [![Twitter](./assets/badges/twitter.svg)](https://twitter.com/gmickel)
 
-GNO is a local knowledge engine for privacy-conscious developers and AI agents. Index your notes, code, PDFs, and Office docs. Get hybrid search (BM25 + vector + reranking) and AI-powered answers, all running 100% on your machine.
+> **ClawdHub**: GNO skills bundled for Clawdbot — [clawdhub.com/gmickel/gno](https://clawdhub.com/gmickel/gno)
+
+![GNO](./assets/og-image.png)
+
+GNO is a local knowledge engine that turns your documents into a searchable, connected knowledge graph. Index notes, code, PDFs, and Office docs. Get hybrid search, AI answers with citations, and wiki-style note linking—all 100% offline.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gmickel/gno",
-  "version": "0.13.0",
+  "version": "0.13.2",
   "description": "Local semantic search for your documents. Index Markdown, PDF, and Office files with hybrid BM25 + vector search.",
   "keywords": [
     "embeddings",
@@ -57,6 +57,8 @@
     "website:dev": "cd website && make serve",
     "website:build": "cd website && make build",
     "website:demos": "cd website/demos && ./build-demos.sh",
+    "website:og": "bun scripts/og-screenshots.ts",
+    "website:sync-assets": "bun scripts/sync-assets.ts",
     "sync:agents": "scripts/sync-agents.sh",
     "build:css": "bunx @tailwindcss/cli -i src/serve/public/globals.css -o src/serve/public/globals.built.css --minify",
     "serve": "bun src/index.ts serve",
@@ -130,6 +132,7 @@
     "oxlint": "^1.36.0",
     "oxlint-tsgolint": "^0.10.1",
     "pdf-lib": "^1.17.1",
+    "playwright": "^1.52.0",
     "pptxgenjs": "^4.0.1",
     "ultracite": "7.0.4",
     "vitest": "^4.0.16"

package/src/cli/AGENTS.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

package/src/cli/commands/links.ts

@@ -708,7 +708,7 @@ export async function similar(
 
 /** Escape markdown table cell content */
 function escapeTableCell(text: string): string {
-  return text.replace(/\|/g, "\\|").replace(/\n/g, " ");
+  return text.replace(/\\/g, "\\\\").replace(/\|/g, "\\|").replace(/\n/g, " ");
 }
 
 /**

package/src/cli/context.ts

@@ -50,6 +50,12 @@ export function parseGlobalOptions(
   const offlineFlag = Boolean(raw.offline);
   const offlineEnabled = offlineEnv || offlineFlag;
 
+  const noPagerEnv =
+    (env.NO_PAGER !== undefined && env.NO_PAGER !== "") ||
+    (env.GNO_NO_PAGER !== undefined && env.GNO_NO_PAGER !== "") ||
+    env.NODE_ENV === "test" ||
+    env.BUN_TEST !== undefined;
+
   return {
     index: (raw.index as string) ?? "default",
     config: raw.config as string | undefined,
@@ -60,7 +66,7 @@ export function parseGlobalOptions(
     json: Boolean(raw.json),
     offline: offlineEnabled,
     // Commander: --no-pager => opts().pager === false
-    noPager: raw.pager === false,
+    noPager: raw.pager === false || noPagerEnv,
   };
 }
 

package/src/mcp/AGENTS.md

@@ -84,3 +84,24 @@ MCP tests in `test/mcp/`:
 ```bash
 bun test test/mcp/
 ```
+
+## Tag Tools
+
+Tag management via MCP:
+
+- `gno.list_tags` - List all tags with doc counts, optional collection filter
+- `gno.tag` - Add/remove tags from documents
+
+```typescript
+// gno.list_tags
+{ collection?: string }  // optional filter
+// Returns: { tags: [{ name, count }] }
+
+// gno.tag
+{ action: "add" | "remove", path: string, tags: string[] }
+// Returns: { success, tags: [...current tags] }
+```
+
+- Tags in search/query tools: `--tags` param filters by tag (AND logic)
+- Validation via `src/core/tags.ts`: normalizeTag(), validateTag()
+- Storage: `doc_tags` junction table with `source` column (frontmatter|user)

package/src/serve/AGENTS.md

@@ -79,12 +79,14 @@ Answer generation uses shared module to stay in sync with CLI:
 | `/api/presets`       | POST   | Switch preset (hot-reload) |
 | `/api/models/status` | GET    | Download progress          |
 | `/api/models/pull`   | POST   | Start model download       |
+| `/api/tags`          | GET    | List tags (with counts)    |
 
 ## Frontend
 
 - **Framework**: React (via Bun HTML imports)
 - **Styling**: Tailwind CSS + ShadCN components
 - **AI Elements**: Conversation, Message, Sources, CodeBlock, Loader
+- **Tag Components**: TagInput, TagFacets (filter sidebar)
 - **Routing**: Simple hash-free SPA routing in App.tsx
 
 ## Development
@@ -178,3 +180,22 @@ bun --hot ./index.ts
 ```
 
 For more information, read the Bun API docs in `node_modules/bun-types/docs/**.md`.
+
+## Tag System
+
+REST endpoints support tag filtering:
+
+- `GET /api/tags` - List all tags with doc counts
+- `POST /api/search`, `/api/query`, `/api/ask` - Accept `tags` array param
+
+WebUI state:
+
+- TagFacets component shows available tags with counts
+- TagInput for adding/removing tags on documents
+- Selected tags filter search results (AND logic)
+
+Implementation:
+
+- Tags stored in `doc_tags` junction table with `source` (frontmatter|user)
+- Validation via `src/core/tags.ts`
+- Frontmatter parsing in `src/ingestion/frontmatter.ts`