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

package/README.md

@@ -1,72 +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?
 
-## Design Philosophy
+Knowledge Bank is a Claude Code plugin that seamlessly integrates into your development workflow to:
 
-Knowledge Bank is built on a fundamental principle: **knowledge should be deeply integrated into the entire software development lifecycle**, not treated as a separate documentation burden.
+- **🧠 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
 
-### 🔄 **Lifecycle-Integrated Knowledge Management**
+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.
 
-**Throughout Every Development Phase:**
-- **Design Phase**: Capture architectural decisions and design patterns
-- **Development Phase**: Record code patterns, implementation insights, and technical decisions
-- **Code Review Phase**: Document review findings, best practices, and improvement patterns
-- **Testing Phase**: Store testing strategies, edge cases, and quality insights
-- **Deployment Phase**: Record deployment patterns, configuration knowledge, and operational insights
-- **Maintenance Phase**: Capture troubleshooting knowledge, performance optimizations, and evolution patterns
+## Core Philosophy
 
-### 🔗 **Code-Bound Knowledge Strategy**
+### Knowledge Should Be Effortless
 
-**Knowledge-Code Coupling**: By binding knowledge collection and retrieval directly to your code workflow, we ensure:
+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.
 
-- **High Knowledge Density**: Every captured insight is contextually relevant and immediately actionable
-- **Automatic Freshness**: Knowledge stays current as it's updated alongside code changes
-- **Zero Maintenance Overhead**: No separate documentation process to maintain
-- **Contextual Relevance**: Knowledge appears exactly when and where you need it
+### AI-First Knowledge Design
 
-### 🤖 **LLM-Native 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.
 
-**Implicit Information for AI Consumption**: Knowledge Bank recognizes that modern development increasingly involves AI assistance. Our knowledge format is optimized for:
+### Context is Everything
 
-**LLM-Optimized Storage**:
-- Structured data formats that AI models can efficiently process
-- Rich metadata and classification for intelligent retrieval
-- Contextual relationships that help AI understand relevance
-- Pattern recognition data that enables proactive suggestions
+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
 
-**Human-Extractable Insights**:
-- While knowledge is stored for AI consumption, humans can extract valuable insights through:
-  - **Web Dashboard**: Browse and search through accumulated knowledge
-  - **Pattern Recognition**: Identify recurring themes and solutions across projects
-  - **Knowledge Synthesis**: Derive high-level principles from detailed implementation knowledge
-  - **Learning Acceleration**: Understand team knowledge and best practices through accumulated insights
+This rich context ensures knowledge is relevant and actionable when retrieved.
 
-### 🎯 **Value-Driven Knowledge Capture**
+## Key Advantages
 
-**Maximizing Knowledge ROI**: By focusing on usage frequency and value density:
+### 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
 
-- **Contextual Triggering**: Knowledge is captured and surfaced based on actual development context
-- **Relevance Scoring**: Only valuable, applicable knowledge reaches the developer
-- **Automatic Organization**: AI-driven classification ensures knowledge remains findable and useful
-- **Continuous Refinement**: Knowledge quality improves through usage patterns and feedback loops
+### 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
 
-This philosophy transforms knowledge from a documentation burden into an intelligent development accelerator that grows more valuable with every coding session.
+### 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
 
@@ -74,116 +100,79 @@ This philosophy transforms knowledge from a documentation burden into an intelli
 
 ```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.
 
-```bash
-# Check installation status
-knowledge-bank knowledge-status
-```
-
-## Web Interface
+### Web Dashboard
 
-Knowledge Bank includes a built-in web interface for browsing and exploring your local knowledge database through a user-friendly dashboard.
-
-### Starting the Web Interface
+Explore your knowledge base through the built-in web interface:
 
 ```bash
-# Start web server (production mode)
+# Start the web dashboard
 knowledge-bank web
 ```
 
-The web interface will be available at `http://localhost:3000` (or your specified port).
-
-### Features
-
-The web interface provides comprehensive access to your knowledge database:
-
-#### 🏠 **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
-
-#### 📊 **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
-
-#### 📝 **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
+The dashboard provides:
+- Browse and search all captured knowledge
+- View session history and activity
+- Filter by project, type, and status
+- Explore knowledge relationships
 
-#### 🪝 **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
+## Use Cases
 
-#### 🗄️ **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)
+### 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.
 
-#### 🔍 **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
+### 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 transforms your local knowledge database into an accessible, browsable resource that helps you leverage your accumulated development experience effectively.
+### Code Patterns
+**Before**: You rediscover the same patterns repeatedly across projects.
+**After**: Successful patterns are captured once and suggested whenever relevant.
 
-## How it Works
+### Onboarding
+**Before**: New team members spend weeks learning project conventions.
+**After**: Accumulated project knowledge provides instant context and guidance.
 
-Knowledge Bank integrates seamlessly with Claude Code to automatically capture, organize, and retrieve development knowledge through a simple three-step process:
+## Privacy & Security
 
-### 📥 **Knowledge Capture**
-- **Automatic Collection**: Uses Claude Code's hook system to capture development insights during your coding sessions
-- **Smart Classification**: Organizes knowledge by type (code patterns, architecture, configurations, pitfalls, etc.)
-- **Context Awareness**: Associates knowledge with specific projects, files, and development activities
+- **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 Storage**
-- **Local Database**: Stores all knowledge in a local SQLite database for privacy and speed
-- **Rich Organization**: Categorizes knowledge by scope, source, and development lifecycle stage
-- **Full-Text Search**: Enables fast searching across all stored knowledge items
+## What's Next?
 
-### 🔍 **Knowledge Retrieval**
-- **Intelligent Search**: Finds relevant knowledge based on your current development context
-- **Multiple Interfaces**: Access through Claude Code (via MCP), web dashboard, or command line
-- **Context Injection**: Automatically surfaces relevant insights when you need them
+Once installed, Knowledge Bank works automatically. As you use Claude Code:
 
-### 🔧 **Integration Points**
+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
 
-**Claude Code Integration**
-- Hooks into Claude Code's session lifecycle for automatic knowledge capture
-- Provides MCP server for real-time knowledge search and retrieval
-- Works transparently without disrupting your development workflow
+The more you use Claude Code, the smarter your knowledge base becomes.
 
-**Web Dashboard**
-- Browse and explore your knowledge database through a user-friendly interface
-- Advanced search and filtering capabilities
-- Session history and hook event tracking
+## Resources
 
-The system transforms your development sessions into a continuously growing, searchable knowledge base that enhances productivity and preserves valuable insights for future reference.
+- **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.312",
+      "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.312"
+    "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.312",
+  "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,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx knowledge-bank pre-compact"
+            "command": "npx knowledge-bank hook pre-compact"
           }
         ]
       }
@@ -108,7 +108,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx knowledge-bank subagent-start"
+            "command": "npx knowledge-bank hook subagent-start"
           }
         ]
       }
@@ -119,7 +119,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx knowledge-bank post-tool-use-failure"
+            "command": "npx knowledge-bank hook post-tool-use-failure"
           }
         ]
       }
@@ -129,7 +129,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx knowledge-bank teammate-idle"
+            "command": "npx knowledge-bank hook teammate-idle"
           }
         ]
       }
@@ -139,7 +139,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx knowledge-bank task-completed"
+            "command": "npx knowledge-bank hook task-completed"
           }
         ]
       }
@@ -150,7 +150,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx knowledge-bank config-change"
+            "command": "npx knowledge-bank hook config-change"
           }
         ]
       }
@@ -160,7 +160,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx knowledge-bank worktree-create"
+            "command": "npx knowledge-bank hook worktree-create"
           }
         ]
       }
@@ -170,7 +170,47 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx knowledge-bank worktree-remove"
+            "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"
           }
         ]
       }