@gabrywu/knowledge-bank 0.1.2-alpha.276 → 0.1.4-6

package/README.md

@@ -1,21 +1,98 @@
 # Knowledge Bank
 
-An intelligent knowledge management system for Claude Code that automatically captures, stores, and retrieves development knowledge during your coding sessions.
+An intelligent knowledge management system for Claude Code that automatically captures and retrieves development insights during your coding sessions.
 
-## Overview
+## Why Knowledge Bank?
 
-Knowledge Bank is a lightweight Claude Code plugin that transforms your development workflow by:
+Every day, developers solve complex problems, discover useful patterns, and learn valuable lessons. Yet most of this knowledge is lost—buried in closed issues, forgotten conversations, or never documented at all. Knowledge Bank changes this by **automatically capturing development knowledge as you work**, building a searchable knowledge base that grows smarter with every coding session.
 
-- 🧠 **Automatically capturing** valuable development insights through Claude Code's hook system
-- 📚 **Storing knowledge** in a local SQLite database with powerful full-text search
-- 🔍 **Smart retrieval** of relevant context during development sessions
-- 🏗️ **Intelligent organization** using multi-dimensional classification
-- ⚡ **Zero-friction integration** with your existing Claude Code workflow
+## What is Knowledge Bank?
+
+Knowledge Bank is a Claude Code plugin that seamlessly integrates into your development workflow to:
+
+- **🧠 Automatically capture** valuable insights from your Claude Code sessions
+- **🔍 Intelligently retrieve** relevant knowledge when you need it
+- **📚 Build a searchable database** of project-specific and personal development wisdom
+- **⚡ Work transparently** without disrupting your flow
+
+Unlike traditional documentation tools that require manual effort, Knowledge Bank operates in the background—learning from your development sessions and surfacing relevant insights at the right moment.
+
+## Core Philosophy
+
+### Knowledge Should Be Effortless
+
+Traditional documentation fails because it requires extra work. Knowledge Bank integrates knowledge capture directly into your development workflow—no separate documentation process, no context switching, no maintenance burden.
+
+### AI-First Knowledge Design
+
+Knowledge Bank is built for the AI-assisted development era. It stores knowledge in formats optimized for AI consumption, allowing Claude Code to leverage accumulated insights when helping you solve problems. The knowledge grows more valuable with every session, creating a positive feedback loop.
+
+### Context is Everything
+
+Knowledge without context is just data. Knowledge Bank automatically associates every insight with:
+- The specific files and code it relates to
+- The project and repository context
+- The development phase (design, coding, debugging, etc.)
+- The problem being solved
+
+This rich context ensures knowledge is relevant and actionable when retrieved.
+
+## Key Advantages
+
+### 1. Zero Friction Integration
+- No manual knowledge entry required
+- Automatic capture through Claude Code's hook system
+- Works silently in the background
+- No new tools or workflows to learn
+
+### 2. Intelligent Knowledge Management
+- **Smart Detection**: Automatically identifies valuable insights worth preserving
+- **Duplicate Prevention**: Detects similar knowledge and merges intelligently
+- **Quality Control**: Validates knowledge relevance and actionability
+- **Context Isolation**: Runs knowledge operations without disrupting your main conversation
+
+### 3. Always Available
+- **Local Storage**: Your knowledge stays on your machine in SQLite
+- **Fast Search**: FTS5 full-text search for instant retrieval
+- **Web Dashboard**: Browse and explore your knowledge base visually
+- **Multi-Repository**: Manage knowledge across all your projects
+
+### 4. Grows With You
+- **Personal Knowledge**: Capture cross-project principles and practices
+- **Project Knowledge**: Build project-specific expertise and patterns
+- **Session Tracking**: Complete history of your Claude Code sessions
+- **Pattern Recognition**: Identify recurring solutions and approaches
+
+## How It Works
+
+Knowledge Bank operates through a simple three-phase cycle:
+
+### 📥 Capture Phase
+When you complete a development task, Knowledge Bank automatically:
+- Analyzes the conversation for valuable insights
+- Identifies code patterns, debugging solutions, and architectural decisions
+- Checks for duplicate knowledge using similarity scoring
+- Stores qualified knowledge with rich metadata
+
+### 🗄️ Storage Phase
+All knowledge is stored locally in:
+- **SQLite Database**: Fast, reliable, and private
+- **Structured Format**: Organized by type, scope, and project
+- **Full-Text Search**: Optimized for quick retrieval
+- **Version Controlled**: Linked to specific Git repositories and branches
+
+### 🔍 Retrieval Phase
+When you start working on a new task, Knowledge Bank:
+- Analyzes your question or problem description
+- Searches for relevant knowledge from past sessions
+- Injects contextual insights into your conversation
+- Surfaces the right knowledge at the right time
+
+All of this happens automatically through Claude Code's skill system, requiring no manual intervention.
 
 ## Installation
 
 ### Prerequisites
-
 - Node.js >= 18.0.0
 - Claude Code CLI installed and configured
 
@@ -23,83 +100,79 @@ Knowledge Bank is a lightweight Claude Code plugin that transforms your developm
 
 ```bash
 # Install Knowledge Bank globally
-npm install -g @gabrywu/knowledge-bank --registry https://registry.npmjs.org
-# For alpha/beta versions, use:
-npm install -g @gabrywu/knowledge-bank@alpha --registry https://registry.npmjs.org
+npm install -g @gabrywu/knowledge-bank
 
-# Install the Knowledge Bank plugin
+# Install the plugin into Claude Code
 knowledge-bank install
 
-# Uninstall plugin
-knowledge-bank uninstall
+# Verify installation
+knowledge-bank config
 ```
 
-### Verification
+That's it! Knowledge Bank is now active and will automatically capture knowledge from your Claude Code sessions.
+
+### Web Dashboard
+
+Explore your knowledge base through the built-in web interface:
 
 ```bash
-# Check installation status
-knowledge-bank knowledge-status
+# Start the web dashboard
+knowledge-bank web
 ```
 
-## Web Interface
+The dashboard provides:
+- Browse and search all captured knowledge
+- View session history and activity
+- Filter by project, type, and status
+- Explore knowledge relationships
 
-Knowledge Bank includes a built-in web interface for browsing and exploring your local knowledge database through a user-friendly dashboard.
+## Use Cases
 
-### Starting the Web Interface
+### Debugging Sessions
+**Before**: You spend hours debugging an issue, solve it, and forget the solution.
+**After**: Knowledge Bank captures the debugging process, root cause, and solution. Next time a similar issue appears, the solution is automatically retrieved.
 
-```bash
-# Start web server (production mode)
-knowledge-bank web
-```
+### Architecture Decisions
+**Before**: Important design decisions are scattered across PRs and chat logs.
+**After**: Architectural insights are captured with context and rationale, building a living architecture document.
 
-The web interface will be available at `http://localhost:3000` (or your specified port).
+### Code Patterns
+**Before**: You rediscover the same patterns repeatedly across projects.
+**After**: Successful patterns are captured once and suggested whenever relevant.
 
-### Features
+### Onboarding
+**Before**: New team members spend weeks learning project conventions.
+**After**: Accumulated project knowledge provides instant context and guidance.
 
-The web interface provides comprehensive access to your knowledge database:
+## Privacy & Security
 
-#### 🏠 **Dashboard Overview**
-- **System Statistics**: Quick overview of repositories, sessions, knowledge items, and hook events
-- **Repository Browser**: Navigate through your Git repositories and their associated knowledge
-- **Real-time Data**: Live view of your current knowledge database state
+- **Local-First**: All knowledge stays on your machine
+- **No Cloud Sync**: Your data never leaves your computer
+- **Git-Aware**: Respects your repository structure
+- **User-Controlled**: Full control over what gets captured and stored
 
-#### 📊 **Knowledge Management**
-- **Knowledge Items Viewer**: Browse, search, and filter all captured knowledge items
-  - Filter by type (architecture, code_pattern, tool_usage, config, pitfall, API_usage, exploration)
-  - Filter by status (draft, suggested, verified)
-  - Filter by scope (personal, project, organization)
-  - Full-text search across titles, summaries, and content
-- **Markdown Rendering**: Rich display of knowledge content with proper formatting
-- **Knowledge Details**: Expandable rows showing complete knowledge item information
+## What's Next?
 
-#### 📝 **Session Management**
-- **Session History**: View all Claude Code sessions organized by repository
-- **Session Details**: Browse session metadata including working directory, branch, and timestamps
-- **Session Filtering**: Search sessions by session ID, branch, or working directory
+Once installed, Knowledge Bank works automatically. As you use Claude Code:
 
-#### 🪝 **Hook Event Tracking**
-- **Event History**: Monitor all Claude Code hook events across sessions
-- **Event Filtering**: Filter by event name, session ID, or repository
-- **Event Timeline**: Chronological view of hook activations and system events
+1. Complete development tasks as usual
+2. Knowledge Bank captures valuable insights in the background
+3. When you encounter similar situations, relevant knowledge appears automatically
+4. Your knowledge base grows more valuable with every session
 
-#### 🗄️ **Database Browser**
-- **Table Explorer**: Direct access to all database tables (repository, session, knowledge_item, hook_event)
-- **Schema Viewer**: Inspect database structure and relationships
-- **Advanced Filtering**: Multiple filter options per table with pagination
-- **Sortable Columns**: Click headers to sort by any column (ascending/descending)
+The more you use Claude Code, the smarter your knowledge base becomes.
 
-#### 🔍 **Advanced Search & Navigation**
-- **Cross-table Relationships**: Navigate between related repositories, sessions, and knowledge items
-- **Repository-centric View**: See all sessions, knowledge, and events for each repository
-- **Responsive Design**: Works seamlessly on desktop and mobile devices
-- **Real-time Updates**: Reflects the latest database state on page refresh
+## Resources
 
-The web interface transforms your local knowledge database into an accessible, browsable resource that helps you leverage your accumulated development experience effectively.
+- **Documentation**: Full architecture details in `architecture.md`
+- **Configuration**: Run `knowledge-bank config` to view settings
+- **Web Interface**: Run `knowledge-bank web` to explore your knowledge
+- **Support**: Report issues at [GitHub Issues](https://github.com/anthropics/claude-code/issues)
 
 ## License
 
-This project is licensed under the ISC License - see the [LICENSE](LICENSE) file for details.
+MIT License - see the [LICENSE](LICENSE) file for details.
 
 ---
 
-Transform your development workflow with intelligent knowledge management. Get started with Knowledge Bank today!
+**Transform your development workflow with intelligent knowledge management. Your future self will thank you.**

package/dist/claude-marketplace/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
       "name": "core",
       "source": "./core",
       "description": "Core plugins for knowledge bank",
-      "version": "0.1.2-alpha.276",
+      "version": "0.1.4-6",
       "author": {
         "name": "garbywu",
         "email": "gabrywu@apache.org"
@@ -18,6 +18,6 @@
   ],
   "metadata": {
     "description": "A marketplace for knowledge bank plugins by gabrywu",
-    "version": "0.1.2-alpha.276"
+    "version": "0.1.4-6"
   }
 }

package/dist/claude-marketplace/core/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "core",
   "description": "Core plugins for knowledge bank",
-  "version": "0.1.2-alpha.276",
+  "version": "0.1.4-6",
   "author": {
     "name": "garbywu",
     "email": "gabrywu@apache.org"

package/dist/claude-marketplace/core/hooks/hooks.json

@@ -5,7 +5,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx knowledge-bank session-start"
+            "command": "npx knowledge-bank hook session-start"
           }
         ]
       }
@@ -15,7 +15,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx knowledge-bank session-end"
+            "command": "npx knowledge-bank hook session-end"
           }
         ]
       }
@@ -26,7 +26,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx knowledge-bank pre-tool-use"
+            "command": "npx knowledge-bank hook pre-tool-use"
           }
         ]
       }
@@ -37,7 +37,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx knowledge-bank post-tool-use"
+            "command": "npx knowledge-bank hook post-tool-use"
           }
         ]
       }
@@ -47,7 +47,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx knowledge-bank user-prompt-submit"
+            "command": "npx knowledge-bank hook user-prompt-submit"
           }
         ]
       }
@@ -58,7 +58,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx knowledge-bank permission-request"
+            "command": "npx knowledge-bank hook permission-request"
           }
         ]
       }
@@ -68,7 +68,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx knowledge-bank notification"
+            "command": "npx knowledge-bank hook notification"
           }
         ]
       }
@@ -78,7 +78,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx knowledge-bank stop"
+            "command": "npx knowledge-bank hook stop"
           }
         ]
       }
@@ -88,7 +88,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx knowledge-bank stop"
+            "command": "npx knowledge-bank hook stop"
           }
         ]
       }
@@ -98,7 +98,119 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx knowledge-bank pre-compact"
+            "command": "npx knowledge-bank hook pre-compact"
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx knowledge-bank hook subagent-start"
+          }
+        ]
+      }
+    ],
+    "PostToolUseFailure": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx knowledge-bank hook post-tool-use-failure"
+          }
+        ]
+      }
+    ],
+    "TeammateIdle": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx knowledge-bank hook teammate-idle"
+          }
+        ]
+      }
+    ],
+    "TaskCompleted": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx knowledge-bank hook task-completed"
+          }
+        ]
+      }
+    ],
+    "ConfigChange": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx knowledge-bank hook config-change"
+          }
+        ]
+      }
+    ],
+    "WorktreeCreate": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx knowledge-bank hook worktree-create"
+          }
+        ]
+      }
+    ],
+    "WorktreeRemove": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx knowledge-bank hook worktree-remove"
+          }
+        ]
+      }
+    ],
+    "PostCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx knowledge-bank hook post-compact"
+          }
+        ]
+      }
+    ],
+    "Elicitation": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx knowledge-bank hook elicitation"
+          }
+        ]
+      }
+    ],
+    "ElicitationResult": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx knowledge-bank hook elicitation-result"
+          }
+        ]
+      }
+    ],
+    "InstructionsLoaded": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx knowledge-bank hook instructions-loaded"
           }
         ]
       }