agent-knowledge 1.0.11 → 1.0.13

package/docs/DASHBOARD.md

@@ -1,133 +1,133 @@
-# Dashboard
-
-The dashboard runs at **http://localhost:3423** and auto-starts with the MCP server.
-
-## Tabs
-
-| Tab           | Purpose                                                         |
-| ------------- | --------------------------------------------------------------- |
-| **Knowledge** | Browse knowledge base entries by category                       |
-| **Search**    | TF-IDF ranked search across session transcripts                 |
-| **Sessions**  | Browse and read session conversation logs                       |
-| **Recall**    | Scoped search (errors, plans, configs, tools, files, decisions) |
-
-## Knowledge Tab
-
-Card grid of knowledge entries. Each card shows:
-
-- Category badge with color: projects (blue), people (purple), decisions (orange), workflows (green), notes (yellow)
-- Title and tag pills
-- Last updated date
-
-Category filter chips at the top: All, Projects, People, Decisions, Workflows, Notes.
-
-Click a card to open the side panel with rendered markdown content.
-
-## Search Tab
-
-Full-text search across all session transcripts.
-
-**Controls:**
-
-- Search input with debounce (300ms)
-- Role filter chips: All, User, Assistant
-- Mode toggle: Ranked (TF-IDF) vs Regex
-
-**Results show:**
-
-- Role badge (user/assistant)
-- Project name
-- Relative timestamp
-- Score bar with numeric value
-- Excerpt with highlighted matching terms
-
-Click a result to open the session in the side panel.
-
-## Sessions Tab
-
-Lists all Claude Code sessions with metadata:
-
-- Project name
-- Git branch
-- Message count
-- Date
-- Preview of first user message
-
-Project filter dropdown at the top.
-
-Click a session to open the side panel with the full conversation rendered as chat bubbles.
-
-## Recall Tab
-
-Scoped search that pre-filters results by category:
-
-| Scope       | What it finds                             |
-| ----------- | ----------------------------------------- |
-| `errors`    | Stack traces, exceptions, failed commands |
-| `plans`     | Architecture, TODOs, implementation steps |
-| `configs`   | Settings, env vars, configuration files   |
-| `tools`     | MCP tool calls, CLI commands              |
-| `files`     | File paths, modifications                 |
-| `decisions` | Trade-offs, rationale, choices            |
-
-Results use the same format as the Search tab.
-
-## Side Panel
-
-- Width: 560px, resizable by dragging the left edge
-- Close: X button or press Escape
-- Knowledge entries: rendered as markdown via marked + DOMPurify + highlight.js
-- Sessions: chat bubbles (user = right/accent, assistant = left/surface)
-
-## Theming
-
-- Toggle: sun/moon button in header
-- Persisted in `localStorage('agent-knowledge-theme')`
-- MD3 design tokens matching agent-comm and agent-tasks dashboards
-- CSS custom properties on `:root`, switched via `data-theme` attribute
-
-## Live Reload
-
-File watcher monitors `src/ui/` for `.html`, `.css`, `.js` changes. On change, broadcasts `{type: "reload"}` via WebSocket. Connected browsers auto-refresh.
-
-## Keyboard Shortcuts
-
-| Shortcut        | Action             |
-| --------------- | ------------------ |
-| `/` or `Ctrl+K` | Focus search input |
-| `Escape`        | Close side panel   |
-
-## REST API
-
-| Method | Endpoint                                | Description      |
-| ------ | --------------------------------------- | ---------------- |
-| GET    | `/api/knowledge`                        | List entries     |
-| GET    | `/api/knowledge/search?q=`              | Search knowledge |
-| GET    | `/api/knowledge/:path`                  | Read entry       |
-| GET    | `/api/sessions`                         | List sessions    |
-| GET    | `/api/sessions/search?q=&role=&ranked=` | Search sessions  |
-| GET    | `/api/sessions/recall?scope=&q=`        | Scoped recall    |
-| GET    | `/api/sessions/:id`                     | Read session     |
-| GET    | `/api/sessions/:id/summary`             | Session summary  |
-| GET    | `/health`                               | Health check     |
-
-## WebSocket
-
-Connects to `ws://localhost:3423` on page load.
-
-**State message** (on connect):
-
-```json
-{
-  "type": "state",
-  "knowledge": [...],
-  "sessions": [...],
-  "stats": { "knowledge_entries": 12, "session_count": 247 }
-}
-```
-
-**Reload message** (on file change):
-
-```json
-{ "type": "reload" }
-```
+# Dashboard
+
+The dashboard runs at **http://localhost:3423** and auto-starts with the MCP server.
+
+## Tabs
+
+| Tab           | Purpose                                                         |
+| ------------- | --------------------------------------------------------------- |
+| **Knowledge** | Browse knowledge base entries by category                       |
+| **Search**    | TF-IDF ranked search across session transcripts                 |
+| **Sessions**  | Browse and read session conversation logs                       |
+| **Recall**    | Scoped search (errors, plans, configs, tools, files, decisions) |
+
+## Knowledge Tab
+
+Card grid of knowledge entries. Each card shows:
+
+- Category badge with color: projects (blue), people (purple), decisions (orange), workflows (green), notes (yellow)
+- Title and tag pills
+- Last updated date
+
+Category filter chips at the top: All, Projects, People, Decisions, Workflows, Notes.
+
+Click a card to open the side panel with rendered markdown content.
+
+## Search Tab
+
+Full-text search across all session transcripts.
+
+**Controls:**
+
+- Search input with debounce (300ms)
+- Role filter chips: All, User, Assistant
+- Mode toggle: Ranked (TF-IDF) vs Regex
+
+**Results show:**
+
+- Role badge (user/assistant)
+- Project name
+- Relative timestamp
+- Score bar with numeric value
+- Excerpt with highlighted matching terms
+
+Click a result to open the session in the side panel.
+
+## Sessions Tab
+
+Lists all Claude Code sessions with metadata:
+
+- Project name
+- Git branch
+- Message count
+- Date
+- Preview of first user message
+
+Project filter dropdown at the top.
+
+Click a session to open the side panel with the full conversation rendered as chat bubbles.
+
+## Recall Tab
+
+Scoped search that pre-filters results by category:
+
+| Scope       | What it finds                             |
+| ----------- | ----------------------------------------- |
+| `errors`    | Stack traces, exceptions, failed commands |
+| `plans`     | Architecture, TODOs, implementation steps |
+| `configs`   | Settings, env vars, configuration files   |
+| `tools`     | MCP tool calls, CLI commands              |
+| `files`     | File paths, modifications                 |
+| `decisions` | Trade-offs, rationale, choices            |
+
+Results use the same format as the Search tab.
+
+## Side Panel
+
+- Width: 560px, resizable by dragging the left edge
+- Close: X button or press Escape
+- Knowledge entries: rendered as markdown via marked + DOMPurify + highlight.js
+- Sessions: chat bubbles (user = right/accent, assistant = left/surface)
+
+## Theming
+
+- Toggle: sun/moon button in header
+- Persisted in `localStorage('agent-knowledge-theme')`
+- MD3 design tokens matching agent-comm and agent-tasks dashboards
+- CSS custom properties on `:root`, switched via `data-theme` attribute
+
+## Live Reload
+
+File watcher monitors `src/ui/` for `.html`, `.css`, `.js` changes. On change, broadcasts `{type: "reload"}` via WebSocket. Connected browsers auto-refresh.
+
+## Keyboard Shortcuts
+
+| Shortcut        | Action             |
+| --------------- | ------------------ |
+| `/` or `Ctrl+K` | Focus search input |
+| `Escape`        | Close side panel   |
+
+## REST API
+
+| Method | Endpoint                                | Description      |
+| ------ | --------------------------------------- | ---------------- |
+| GET    | `/api/knowledge`                        | List entries     |
+| GET    | `/api/knowledge/search?q=`              | Search knowledge |
+| GET    | `/api/knowledge/:path`                  | Read entry       |
+| GET    | `/api/sessions`                         | List sessions    |
+| GET    | `/api/sessions/search?q=&role=&ranked=` | Search sessions  |
+| GET    | `/api/sessions/recall?scope=&q=`        | Scoped recall    |
+| GET    | `/api/sessions/:id`                     | Read session     |
+| GET    | `/api/sessions/:id/summary`             | Session summary  |
+| GET    | `/health`                               | Health check     |
+
+## WebSocket
+
+Connects to `ws://localhost:3423` on page load.
+
+**State message** (on connect):
+
+```json
+{
+  "type": "state",
+  "knowledge": [...],
+  "sessions": [...],
+  "stats": { "knowledge_entries": 12, "session_count": 247 }
+}
+```
+
+**Reload message** (on file change):
+
+```json
+{ "type": "reload" }
+```

package/docs/SETUP.md

@@ -203,17 +203,17 @@ OpenCode supports lifecycle hooks via JavaScript/TypeScript plugins. Create a pl
 
 ```typescript
 // .opencode/plugins/agent-knowledge.ts
-import type { Plugin } from "@opencode-ai/plugin"
+import type { Plugin } from '@opencode-ai/plugin';
 
 export const AgentKnowledgePlugin: Plugin = async ({ client }) => {
   return {
     event: async (event) => {
-      if (event.type === "session.created") {
+      if (event.type === 'session.created') {
         // Knowledge base instructions provided via AGENTS.md
       }
-    }
-  }
-}
+    },
+  };
+};
 ```
 
 Available events: `session.created`, `session.idle`, `tool.execute.before`, `tool.execute.after`, `message.updated`, `file.edited`.
@@ -224,10 +224,10 @@ Combine with `AGENTS.md` instructions (see below).
 
 Cursor and Windsurf don't support lifecycle hooks. Use the client's system prompt / instructions file:
 
-| Client   | Instructions file       |
-| -------- | ----------------------- |
-| Cursor   | `.cursorrules`          |
-| Windsurf | `.windsurfrules`        |
+| Client   | Instructions file |
+| -------- | ----------------- |
+| Cursor   | `.cursorrules`    |
+| Windsurf | `.windsurfrules`  |
 
 Add these instructions:
 
@@ -294,22 +294,22 @@ Architecture notes, deployment info, etc.
 
 ## Environment Variables
 
-| Variable               | Default           | Description                       |
-| ---------------------- | ----------------- | --------------------------------- |
-| `KNOWLEDGE_MEMORY_DIR` | `~/claude-memory` | Path to git-synced knowledge base |
-| `CLAUDE_MEMORY_DIR`    | `~/claude-memory` | Alias (backwards compat)          |
-| `CLAUDE_DIR`           | `~/.claude`       | Claude Code data directory        |
-| `KNOWLEDGE_PORT`       | `3423`            | Dashboard HTTP/WebSocket port     |
-| `KNOWLEDGE_EMBEDDING_PROVIDER` | `local`   | Embedding provider (local, openai, claude, gemini) |
-| `KNOWLEDGE_EMBEDDING_ALPHA` | `0.5`        | Blend weight for semantic vs TF-IDF search (0-1) |
-| `KNOWLEDGE_EMBEDDING_IDLE_TIMEOUT` | —     | Idle timeout for embedding worker (ms) |
-| `KNOWLEDGE_EMBEDDING_THREADS` | —          | Number of ONNX threads for local embeddings |
-| `KNOWLEDGE_EMBEDDING_MODEL` | —            | Model name for embedding provider |
-| `KNOWLEDGE_GIT_URL`   | —                   | Remote git URL for knowledge base sync |
-| `KNOWLEDGE_AUTO_DISTILL` | —               | Enable auto-distillation of sessions (true/false) |
-| `KNOWLEDGE_OPENAI_API_KEY` / `OPENAI_API_KEY` | — | API key for OpenAI embeddings |
-| `KNOWLEDGE_CLAUDE_API_KEY` / `ANTHROPIC_API_KEY` | — | API key for Claude/Voyage embeddings |
-| `KNOWLEDGE_GEMINI_API_KEY` / `GEMINI_API_KEY` | — | API key for Gemini embeddings |
+| Variable                                         | Default           | Description                                        |
+| ------------------------------------------------ | ----------------- | -------------------------------------------------- |
+| `KNOWLEDGE_MEMORY_DIR`                           | `~/claude-memory` | Path to git-synced knowledge base                  |
+| `CLAUDE_MEMORY_DIR`                              | `~/claude-memory` | Alias (backwards compat)                           |
+| `CLAUDE_DIR`                                     | `~/.claude`       | Claude Code data directory                         |
+| `KNOWLEDGE_PORT`                                 | `3423`            | Dashboard HTTP/WebSocket port                      |
+| `KNOWLEDGE_EMBEDDING_PROVIDER`                   | `local`           | Embedding provider (local, openai, claude, gemini) |
+| `KNOWLEDGE_EMBEDDING_ALPHA`                      | `0.5`             | Blend weight for semantic vs TF-IDF search (0-1)   |
+| `KNOWLEDGE_EMBEDDING_IDLE_TIMEOUT`               | —                 | Idle timeout for embedding worker (ms)             |
+| `KNOWLEDGE_EMBEDDING_THREADS`                    | —                 | Number of ONNX threads for local embeddings        |
+| `KNOWLEDGE_EMBEDDING_MODEL`                      | —                 | Model name for embedding provider                  |
+| `KNOWLEDGE_GIT_URL`                              | —                 | Remote git URL for knowledge base sync             |
+| `KNOWLEDGE_AUTO_DISTILL`                         | —                 | Enable auto-distillation of sessions (true/false)  |
+| `KNOWLEDGE_OPENAI_API_KEY` / `OPENAI_API_KEY`    | —                 | API key for OpenAI embeddings                      |
+| `KNOWLEDGE_CLAUDE_API_KEY` / `ANTHROPIC_API_KEY` | —                 | API key for Claude/Voyage embeddings               |
+| `KNOWLEDGE_GEMINI_API_KEY` / `GEMINI_API_KEY`    | —                 | API key for Gemini embeddings                      |
 
 Set in your shell profile or pass via MCP config:
 
@@ -398,10 +398,10 @@ ls ~/.claude/projects/  # Should contain project directories with .jsonl files
 
 ## Client Comparison
 
-| Feature                  | Claude Code | OpenCode | Cursor | Windsurf |
-| ------------------------ | ----------- | -------- | ------ | -------- |
-| MCP stdio transport      | Yes         | Yes      | Yes    | Yes      |
-| Lifecycle hooks          | Yes (JSON)  | Yes (plugins) | No | No       |
-| Session auto-distill     | Yes         | No       | No     | No       |
-| System prompt file       | CLAUDE.md   | AGENTS.md | .cursorrules | .windsurfrules |
-| REST API fallback        | Yes         | Yes      | Yes    | Yes      |
+| Feature              | Claude Code | OpenCode      | Cursor       | Windsurf       |
+| -------------------- | ----------- | ------------- | ------------ | -------------- |
+| MCP stdio transport  | Yes         | Yes           | Yes          | Yes            |
+| Lifecycle hooks      | Yes (JSON)  | Yes (plugins) | No           | No             |
+| Session auto-distill | Yes         | No            | No           | No             |
+| System prompt file   | CLAUDE.md   | AGENTS.md     | .cursorrules | .windsurfrules |
+| REST API fallback    | Yes         | Yes           | Yes          | Yes            |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-knowledge",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "description": "Cross-session memory and recall for AI agents — git-synced knowledge base, hybrid semantic+TF-IDF search, auto-distillation with secrets scrubbing",
   "type": "module",
   "main": "dist/index.js",

package/scripts/copy-ui.js

@@ -1,6 +1,6 @@
-import { cpSync } from 'fs';
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-
-const root = join(dirname(fileURLToPath(import.meta.url)), '..');
-cpSync(join(root, 'src', 'ui'), join(root, 'dist', 'ui'), { recursive: true });
+import { cpSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..');
+cpSync(join(root, 'src', 'ui'), join(root, 'dist', 'ui'), { recursive: true });