agent-knowledge 1.0.0 → 1.0.4

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

@@ -1,178 +1,178 @@
-# Setup Guide
-
-## Prerequisites
-
-- **Node.js 20+** (ES modules and TypeScript features)
-- **Git** (for knowledge base sync)
-
-```bash
-node --version   # v20.0.0 or later
-git --version
-```
-
-## Installation
-
-```bash
-git clone https://github.com/keshrath/agent-knowledge.git
-cd agent-knowledge
-npm install
-npm run build
-```
-
-For development with auto-rebuild:
-
-```bash
-npm run dev
-```
-
-## Configuration in Claude Code
-
-### Register the MCP server
-
-```bash
-claude mcp add agent-knowledge -s user \
-  -e KNOWLEDGE_MEMORY_DIR="$HOME/claude-memory" \
-  -- node /path/to/agent-knowledge/dist/index.js
-```
-
-### Permissions
-
-Add to `~/.claude/settings.json`:
-
-```json
-{
-  "permissions": {
-    "allow": ["mcp__agent-knowledge__*"]
-  }
-}
-```
-
-### Verify
-
-```bash
-claude mcp list
-# Should show: agent-knowledge ... Connected
-```
-
-## 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     |
-
-Set in your shell profile or pass via MCP config:
-
-```bash
-export KNOWLEDGE_MEMORY_DIR="$HOME/claude-memory"
-```
-
-On Windows (PowerShell):
-
-```powershell
-$env:KNOWLEDGE_MEMORY_DIR = "$env:USERPROFILE\claude-memory"
-```
-
-## Knowledge Base Setup
-
-The knowledge base is a git repository with categorized markdown files.
-
-### Clone existing or create new
-
-```bash
-# Clone existing
-git clone https://your-git-host/claude-memory.git ~/claude-memory
-
-# Or create new
-mkdir -p ~/claude-memory && cd ~/claude-memory && git init
-mkdir projects people decisions workflows notes
-git add . && git commit -m "Initialize knowledge base"
-git remote add origin <your-remote-url>
-git push -u origin main
-```
-
-### Directory structure
-
-```
-~/claude-memory/
-  projects/       # Project context, architecture, tech stacks
-  people/         # Team members, contacts, preferences
-  decisions/      # Architecture decisions, trade-offs, rationale
-  workflows/      # Processes, deployment steps, runbooks
-  notes/          # General notes, research, references
-```
-
-### Entry format
-
-```markdown
----
-title: My Project
-tags: [typescript, react, postgres]
-updated: 2026-03-25
----
-
-# My Project
-
-Architecture notes, deployment info, etc.
-```
-
-## Dashboard
-
-Auto-starts with the MCP server at **http://localhost:3423**.
-
-4 tabs: Knowledge, Search, Sessions, Recall. Supports light/dark theme.
-
-Live reload: edit files in `src/ui/` and the browser refreshes automatically.
-
-## Multi-Machine Sync
-
-| Operation                             | Git Action                     | When           |
-| ------------------------------------- | ------------------------------ | -------------- |
-| `knowledge_read`, `knowledge_list`    | `git pull --rebase`            | Before reading |
-| `knowledge_write`, `knowledge_delete` | `git add -A && commit && push` | After writing  |
-| `knowledge_sync`                      | `git pull` then `git push`     | Manual trigger |
-
-Ensure git credentials are configured (SSH key or credential helper):
-
-```bash
-cd ~/claude-memory && git pull && git push  # Should work without prompts
-```
-
-## Troubleshooting
-
-### Port already in use
-
-```bash
-# Find the process
-netstat -ano | findstr :3423   # Windows
-lsof -i :3423                  # Linux/macOS
-
-# Use a different port
-export KNOWLEDGE_PORT=3424
-```
-
-### Git authentication failures
-
-Verify credentials work manually:
-
-```bash
-cd ~/claude-memory && git push
-```
-
-Set up SSH keys or a credential helper if prompted.
-
-### MCP server not connecting
-
-1. Check path points to `dist/index.js` (not `src/index.ts`)
-2. Verify Node.js 20+ is on your PATH
-3. Try running manually: `node /path/to/agent-knowledge/dist/index.js`
-
-### No session results
-
-Verify session transcripts exist:
-
-```bash
-ls ~/.claude/projects/  # Should contain project directories with .jsonl files
-```
+# Setup Guide
+
+## Prerequisites
+
+- **Node.js 20+** (ES modules and TypeScript features)
+- **Git** (for knowledge base sync)
+
+```bash
+node --version   # v20.0.0 or later
+git --version
+```
+
+## Installation
+
+```bash
+git clone https://github.com/keshrath/agent-knowledge.git
+cd agent-knowledge
+npm install
+npm run build
+```
+
+For development with auto-rebuild:
+
+```bash
+npm run dev
+```
+
+## Configuration in Claude Code
+
+### Register the MCP server
+
+```bash
+claude mcp add agent-knowledge -s user \
+  -e KNOWLEDGE_MEMORY_DIR="$HOME/claude-memory" \
+  -- node /path/to/agent-knowledge/dist/index.js
+```
+
+### Permissions
+
+Add to `~/.claude/settings.json`:
+
+```json
+{
+  "permissions": {
+    "allow": ["mcp__agent-knowledge__*"]
+  }
+}
+```
+
+### Verify
+
+```bash
+claude mcp list
+# Should show: agent-knowledge ... Connected
+```
+
+## 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     |
+
+Set in your shell profile or pass via MCP config:
+
+```bash
+export KNOWLEDGE_MEMORY_DIR="$HOME/claude-memory"
+```
+
+On Windows (PowerShell):
+
+```powershell
+$env:KNOWLEDGE_MEMORY_DIR = "$env:USERPROFILE\claude-memory"
+```
+
+## Knowledge Base Setup
+
+The knowledge base is a git repository with categorized markdown files.
+
+### Clone existing or create new
+
+```bash
+# Clone existing
+git clone https://your-git-host/claude-memory.git ~/claude-memory
+
+# Or create new
+mkdir -p ~/claude-memory && cd ~/claude-memory && git init
+mkdir projects people decisions workflows notes
+git add . && git commit -m "Initialize knowledge base"
+git remote add origin <your-remote-url>
+git push -u origin main
+```
+
+### Directory structure
+
+```
+~/claude-memory/
+  projects/       # Project context, architecture, tech stacks
+  people/         # Team members, contacts, preferences
+  decisions/      # Architecture decisions, trade-offs, rationale
+  workflows/      # Processes, deployment steps, runbooks
+  notes/          # General notes, research, references
+```
+
+### Entry format
+
+```markdown
+---
+title: My Project
+tags: [typescript, react, postgres]
+updated: 2026-03-25
+---
+
+# My Project
+
+Architecture notes, deployment info, etc.
+```
+
+## Dashboard
+
+Auto-starts with the MCP server at **http://localhost:3423**.
+
+4 tabs: Knowledge, Search, Sessions, Recall. Supports light/dark theme.
+
+Live reload: edit files in `src/ui/` and the browser refreshes automatically.
+
+## Multi-Machine Sync
+
+| Operation                             | Git Action                     | When           |
+| ------------------------------------- | ------------------------------ | -------------- |
+| `knowledge_read`, `knowledge_list`    | `git pull --rebase`            | Before reading |
+| `knowledge_write`, `knowledge_delete` | `git add -A && commit && push` | After writing  |
+| `knowledge_sync`                      | `git pull` then `git push`     | Manual trigger |
+
+Ensure git credentials are configured (SSH key or credential helper):
+
+```bash
+cd ~/claude-memory && git pull && git push  # Should work without prompts
+```
+
+## Troubleshooting
+
+### Port already in use
+
+```bash
+# Find the process
+netstat -ano | findstr :3423   # Windows
+lsof -i :3423                  # Linux/macOS
+
+# Use a different port
+export KNOWLEDGE_PORT=3424
+```
+
+### Git authentication failures
+
+Verify credentials work manually:
+
+```bash
+cd ~/claude-memory && git push
+```
+
+Set up SSH keys or a credential helper if prompted.
+
+### MCP server not connecting
+
+1. Check path points to `dist/index.js` (not `src/index.ts`)
+2. Verify Node.js 20+ is on your PATH
+3. Try running manually: `node /path/to/agent-knowledge/dist/index.js`
+
+### No session results
+
+Verify session transcripts exist:
+
+```bash
+ls ~/.claude/projects/  # Should contain project directories with .jsonl files
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-knowledge",
-  "version": "1.0.0",
+  "version": "1.0.4",
   "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 });