memory-journal-mcp 3.0.0 → 3.1.2

package/.github/dependabot.yml

@@ -1,10 +1,11 @@
 # Dependabot configuration for Memory Journal MCP Server
-# Manages 72+ dependencies including ML libraries and NVIDIA CUDA packages
+# v3.0.0+ is a TypeScript/Node.js project (npm dependencies)
+# The Python codebase is deprecated and archived in archive/python-v2
 
 version: 2
 updates:
-  # Python dependencies (pip)
-  - package-ecosystem: "pip"
+  # NPM dependencies (TypeScript/Node.js - v3.0.0+)
+  - package-ecosystem: "npm"
     directory: "/"
     schedule:
       interval: "weekly"
@@ -16,61 +17,45 @@ updates:
       - "neverinfamous"
     labels:
       - "dependencies"
-      - "python"
-    # Group ML/AI related packages to reduce PR noise
+      - "npm"
     groups:
+      mcp-core:
+        patterns:
+          - "@modelcontextprotocol/*"
+          - "zod*"
+        update-types:
+          - "minor"
+          - "patch"
       ml-packages:
         patterns:
-          - "torch*"
-          - "nvidia-*"
-          - "transformers*"
-          - "sentence-transformers*"
-          - "huggingface-*"
-          - "scikit-learn*"
-          - "scipy*"
-          - "numpy*"
-          - "faiss-*"
-          - "pillow*"
-          - "tokenizers*"
-          - "safetensors*"
+          - "@xenova/*"
+          - "vectra*"
         update-types:
           - "minor"
           - "patch"
-      mcp-core:
+      database:
         patterns:
-          - "mcp*"
-          - "pydantic*"
-          - "httpx*"
-          - "starlette*"
-          - "uvicorn*"
+          - "sql.js*"
+          - "better-sqlite3*"
         update-types:
           - "minor"
           - "patch"
-      utilities:
+      build-tools:
         patterns:
-          - "tqdm*"
-          - "click*"
-          - "pyyaml*"
-          - "requests*"
-          - "urllib3*"
-          - "certifi*"
-          - "charset-normalizer*"
-          - "idna*"
-          - "filelock*"
-          - "packaging*"
-          - "attrs*"
+          - "typescript*"
+          - "tsup*"
+          - "@types/*"
         update-types:
+          - "minor"
+          - "patch"
+      linting:
+        patterns:
+          - "eslint*"
+          - "@eslint/*"
+          - "typescript-eslint*"
+        update-types:
+          - "minor"
           - "patch"
-    # Ignore specific packages that might cause compatibility issues
-    ignore:
-      # NVIDIA CUDA packages - only update for security fixes
-      - dependency-name: "nvidia-*"
-        update-types: ["version-update:semver-minor"]
-      # PyTorch - be conservative with updates
-      - dependency-name: "torch"
-        update-types: ["version-update:semver-major"]
-      - dependency-name: "triton"
-        update-types: ["version-update:semver-major"]
 
   # GitHub Actions
   - package-ecosystem: "github-actions"
@@ -94,7 +79,7 @@ updates:
           - "minor"
           - "patch"
 
-  # Docker dependencies (if using Docker Compose)
+  # Docker dependencies
   - package-ecosystem: "docker"
     directory: "/"
     schedule:

package/.github/workflows/codeql.yml

@@ -27,7 +27,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Initialize CodeQL
         uses: github/codeql-action/init@v4

package/.github/workflows/docker-publish.yml

@@ -23,10 +23,41 @@ permissions:
   attestations: write
 
 jobs:
+  # Gate check: For tag pushes, run lint/typecheck/build first
+  preflight-check:
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: '22.x'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run ESLint
+        run: npm run lint
+
+      - name: Run TypeScript check
+        run: npm run typecheck
+
+      - name: Build
+        run: npm run build
+
   # Build each platform on native architecture (avoids QEMU emulation issues)
   build-platform:
-    # Only run if lint-and-test succeeded OR if this is a tag push
-    if: ${{ github.event.workflow_run.conclusion == 'success' || github.event_name == 'push' }}
+    # For workflow_run: only run if lint-and-test succeeded
+    # For tag push: only run after preflight-check succeeds
+    needs: [preflight-check]
+    if: |
+      always() && 
+      (github.event.workflow_run.conclusion == 'success' || 
+       (github.event_name == 'push' && needs.preflight-check.result == 'success'))
     strategy:
       fail-fast: false
       matrix:
@@ -48,7 +79,7 @@ jobs:
     
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v5
+      uses: actions/checkout@v6
 
     - name: Set up Docker Buildx
       uses: docker/setup-buildx-action@v3
@@ -112,7 +143,7 @@ jobs:
 
     - name: Upload digest
       if: github.event_name != 'pull_request'
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v6
       with:
         name: digests-${{ matrix.platform == 'linux/amd64' && 'amd64' || 'arm64' }}
         path: /tmp/digests/*
@@ -130,7 +161,7 @@ jobs:
     
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v5
+      uses: actions/checkout@v6
 
     - name: Set up Docker Buildx
       uses: docker/setup-buildx-action@v3
@@ -198,10 +229,10 @@ jobs:
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v5
+      uses: actions/checkout@v6
 
     - name: Download digests
-      uses: actions/download-artifact@v4
+      uses: actions/download-artifact@v7
       with:
         path: /tmp/digests
         pattern: digests-*

package/.github/workflows/lint-and-test.yml

@@ -18,7 +18,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Setup Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v6
@@ -42,7 +42,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Setup Node.js
         uses: actions/setup-node@v6

package/.github/workflows/publish-npm.yml

@@ -22,7 +22,7 @@ jobs:
     
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Setup Node.js
         uses: actions/setup-node@v6

package/.github/workflows/secrets-scanning.yml

@@ -14,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
 

package/.github/workflows/security-update.yml

@@ -18,7 +18,7 @@ jobs:
     
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v5
+      uses: actions/checkout@v6
 
     - name: Set up Docker Buildx
       uses: docker/setup-buildx-action@v3

package/DOCKER_README.md

@@ -1,11 +1,11 @@
 # Memory Journal MCP Server
 
-Last Updated December 28, 2025 - v3.0.0
+Last Updated January 11, 2026 - v3.1.2
 
 [![GitHub](https://img.shields.io/badge/GitHub-neverinfamous/memory--journal--mcp-blue?logo=github)](https://github.com/neverinfamous/memory-journal-mcp)
 [![Docker Pulls](https://img.shields.io/docker/pulls/writenotenow/memory-journal-mcp)](https://hub.docker.com/r/writenotenow/memory-journal-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-![Version](https://img.shields.io/badge/version-v3.0.0-green)
+![Version](https://img.shields.io/badge/version-v3.1.2-green)
 ![Status](https://img.shields.io/badge/status-Production%2FStable-brightgreen)
 [![npm](https://img.shields.io/npm/v/memory-journal-mcp)](https://www.npmjs.com/package/memory-journal-mcp)
 [![Security](https://img.shields.io/badge/Security-Enhanced-green.svg)](https://github.com/neverinfamous/memory-journal-mcp/blob/main/SECURITY.md)
@@ -36,6 +36,24 @@ Last Updated December 28, 2025 - v3.0.0
 - 📊 **Generate reports** (standups, retrospectives, PR summaries, status)
 - 🗄️ **Backup & restore** your journal data with one command
 
+```mermaid
+flowchart LR
+    subgraph Problem["❌ Without Memory Journal"]
+        direction TB
+        A1["Session 1<br/>Context Lost"] --> A2["Session 2<br/>Start Over"]
+    end
+    
+    subgraph Solution["✅ With Memory Journal"]
+        direction TB
+        B1["Session 1"] --> MJ[("📚 Memory<br/>Journal")]
+        B2["Session 2"] --> MJ
+        MJ --> |"Recall"| B1
+        MJ --> |"Search"| B2
+    end
+    
+    Problem -.->|"Solve with"| Solution
+```
+
 ---
 
 ## ✨ v3.0.0 Highlights (December 28, 2025)
@@ -54,8 +72,9 @@ Last Updated December 28, 2025 - v3.0.0
 ### **📊 New: Server Health Resource**
 - `memory://health` - Database stats, backup info, vector index status, tool filter config
 
-### **27 MCP Tools • 14 Workflow Prompts • 14 Resources**
+### **29 MCP Tools • 14 Workflow Prompts • 16 Resources**
 - **8 tool groups** - `core`, `search`, `analytics`, `relationships`, `export`, `admin`, `github`, `backup`
+- **GitHub Kanban** - View and manage GitHub Project boards directly
 - **Knowledge graphs** - 5 relationship types, Mermaid diagram visualization
 - **Semantic search** - AI-powered conceptual search via `@xenova/transformers`
 
@@ -184,7 +203,7 @@ docker pull writenotenow/memory-journal-mcp@sha256:<manifest-digest>
 
 ## ⚡ Core Features
 
-### 🛠️ 27 MCP Tools (8 Groups)
+### 🛠️ 29 MCP Tools (8 Groups)
 | Group | Tools | Description |
 |-------|-------|-------------|
 | `core` | 6 | Entry CRUD, tags, test |
@@ -193,8 +212,8 @@ docker pull writenotenow/memory-journal-mcp@sha256:<manifest-digest>
 | `relationships` | 2 | Link entries, visualize graphs |
 | `export` | 1 | JSON/Markdown export |
 | `admin` | 4 | Update, delete, vector index management |
-| `github` | 5 | Issues, PRs, context integration |
-| `backup` | 3 | **NEW** Backup, list, restore |
+| `github` | 7 | Issues, PRs, context, **Kanban board** |
+| `backup` | 3 | Backup, list, restore |
 
 **[Complete tools documentation →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Tools)**
 
@@ -202,8 +221,8 @@ docker pull writenotenow/memory-journal-mcp@sha256:<manifest-digest>
 Standups • Retrospectives • Weekly digests • PR summaries • Code review prep • Goal tracking  
 **[Complete prompts guide →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Prompts)**
 
-### 📡 14 Resources
-Including new `memory://health` for server diagnostics  
+### 📡 16 Resources
+Including `memory://health` for diagnostics and `memory://kanban/{n}` for Kanban boards  
 **[Resources documentation →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Resources)**
 
 ---
@@ -226,9 +245,16 @@ backup_journal({ name: "pre_refactor" })
 // Search entries
 search_entries({ query: "performance" })
 
+// View Kanban board
+get_kanban_board({ project_number: 5 })
+
+// Move item on Kanban
+move_kanban_item({ project_number: 5, item_id: "PVTI_...", target_status: "Done" })
+
 // Access MCP resources
 memory://recent                  // Recent entries
 memory://health                  // Server diagnostics
+memory://kanban/5                // Kanban board view
 memory://projects/1/timeline     // Project timeline
 ```
 
@@ -300,7 +326,7 @@ docker run -i --rm \
 | **ARM64** (Apple Silicon) | Complete: all tools, semantic search, Git context |
 
 **TypeScript v3.0 Image Benefits:**
-- **Node.js 22 on Alpine Linux** - Minimal footprint (~150MB compressed)
+- **Node.js 24 on Alpine Linux** - Minimal footprint (~150MB compressed)
 - **Pure JS Stack** - No native compilation, identical features on all platforms
 - **sql.js** - SQLite in pure JavaScript
 - **vectra** - Vector similarity search without native dependencies
@@ -316,7 +342,7 @@ docker run -i --rm \
 - 📋 **SBOM Available** - Complete software bill of materials
 
 **Available Tags:**
-- `3.0.0` - Specific version (recommended for production)
+- `3.1.2` - Specific version (recommended for production)
 - `3.0` - Latest patch in 3.0.x series
 - `3` - Latest minor in 3.x series
 - `latest` - Always the newest version

package/Dockerfile

@@ -1,11 +1,11 @@
 # Memory Journal MCP Server - TypeScript Version
 # Multi-stage build for optimized production image
-FROM node:22-alpine AS builder
+FROM node:24-alpine AS builder
 
 WORKDIR /app
 
-# Install build dependencies
-RUN apk add --no-cache python3 make g++
+# Install build dependencies and upgrade packages for security
+RUN apk add --no-cache python3 make g++ && apk upgrade --no-cache
 
 # Copy package files first for better layer caching
 COPY package*.json ./
@@ -21,7 +21,7 @@ COPY src/ ./src/
 RUN npm run build
 
 # Production stage
-FROM node:22-alpine
+FROM node:24-alpine
 
 WORKDIR /app
 
@@ -59,6 +59,6 @@ CMD ["node", "dist/cli.js"]
 # Labels for Docker Hub
 LABEL maintainer="Adamic.tech"
 LABEL description="Memory Journal MCP Server - Project context management for AI-assisted development"
-LABEL version="3.0.0"
+LABEL version="3.1.2"
 LABEL org.opencontainers.image.source="https://github.com/neverinfamous/memory-journal-mcp"
 LABEL io.modelcontextprotocol.server.name="io.github.neverinfamous/memory-journal-mcp"

package/README.md

@@ -1,6 +1,6 @@
 # Memory Journal MCP Server
 
-Last Updated December 28, 2025 - v3.0.0
+Last Updated January 11, 2026 - v3.1.2
 
 <!-- mcp-name: io.github.neverinfamous/memory-journal-mcp -->
 
@@ -8,7 +8,7 @@ Last Updated December 28, 2025 - v3.0.0
 [![npm](https://img.shields.io/npm/v/memory-journal-mcp)](https://www.npmjs.com/package/memory-journal-mcp)
 [![Docker Pulls](https://img.shields.io/docker/pulls/writenotenow/memory-journal-mcp)](https://hub.docker.com/r/writenotenow/memory-journal-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-![Version](https://img.shields.io/badge/version-v3.0.0-green)
+![Version](https://img.shields.io/badge/version-v3.1.2-green)
 ![Status](https://img.shields.io/badge/status-Production%2FStable-brightgreen)
 [![MCP Registry](https://img.shields.io/badge/MCP_Registry-Published-green)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.neverinfamous/memory-journal-mcp)
 [![Security](https://img.shields.io/badge/Security-Enhanced-green.svg)](SECURITY.md)
@@ -24,6 +24,30 @@ Last Updated December 28, 2025 - v3.0.0
 - **[npm Package](https://www.npmjs.com/package/memory-journal-mcp)** - `npm install -g memory-journal-mcp`
 - **[Docker Hub](https://hub.docker.com/r/writenotenow/memory-journal-mcp)** - Alpine-based with full semantic search
 
+### 💡 How It Works
+
+```mermaid
+flowchart LR
+    subgraph Problem["❌ Without Memory Journal"]
+        direction TB
+        A1["Session 1<br/>Context Lost"] --> A2["Session 2<br/>Start Over"] --> A3["Session 3<br/>Repeat Work"]
+    end
+    
+    subgraph Solution["✅ With Memory Journal"]
+        direction TB
+        B1["Session 1"] --> MJ[("📚 Memory<br/>Journal")]
+        B2["Session 2"] --> MJ
+        B3["Session 3"] --> MJ
+        MJ --> |"Recall"| B1
+        MJ --> |"Search"| B2
+        MJ --> |"Context"| B3
+    end
+    
+    Problem -.->|"Solve with"| Solution
+```
+
+> **AI sessions become cumulative, not repetitive.** Every insight, decision, and breakthrough is captured and instantly retrievable.
+
 ---
 
 ## ✨ What's New in v3.0.0 (December 28, 2025)
@@ -97,10 +121,10 @@ Get comprehensive server diagnostics via `memory://health`:
 
 ### 📈 **Current Capabilities**
 
-- **27 MCP tools** - Complete development workflow + backup/restore
+- **29 MCP tools** - Complete development workflow + backup/restore + Kanban
 - **14 workflow prompts** - Standups, retrospectives, PR workflows, CI/CD failure analysis
-- **14 MCP resources** - Including new `memory://health` diagnostics
-- **GitHub Integration** - Projects, Issues, Pull Requests, Actions with auto-linking
+- **16 MCP resources** - Including Kanban board views and Mermaid diagrams
+- **GitHub Integration** - Projects, Issues, Pull Requests, Actions, **Kanban boards**
 - **8 tool groups** - `core`, `search`, `analytics`, `relationships`, `export`, `admin`, `github`, `backup`
 - **Knowledge graphs** - 5 relationship types, Mermaid visualization
 - **Semantic search** - AI-powered conceptual search via `@xenova/transformers`
@@ -230,7 +254,7 @@ The GitHub tools (`get_github_issues`, `get_github_prs`, etc.) can auto-detect t
 
 ## 📋 Core Capabilities
 
-### 🛠️ **27 MCP Tools** (8 Groups)
+### 🛠️ **29 MCP Tools** (8 Groups)
 
 | Group | Tools | Description |
 |-------|-------|-------------|
@@ -240,8 +264,8 @@ The GitHub tools (`get_github_issues`, `get_github_prs`, etc.) can auto-detect t
 | `relationships` | 2 | Link entries, visualize graphs |
 | `export` | 1 | JSON/Markdown export |
 | `admin` | 4 | Update, delete, rebuild/add to vector index |
-| `github` | 5 | Issues, PRs, context integration |
-| `backup` | 3 | **NEW** Backup, list, restore |
+| `github` | 7 | Issues, PRs, context, **Kanban board** |
+| `backup` | 3 | Backup, list, restore |
 
 **[Complete tools reference →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Tools)**
 
@@ -253,7 +277,7 @@ The GitHub tools (`get_github_issues`, `get_github_prs`, etc.) can auto-detect t
 - `weekly-digest` - Day-by-day weekly summaries
 - `analyze-period` - Deep period analysis with insights
 - `goal-tracker` - Milestone and achievement tracking
-- `get-context-bundle` - Project context with Git/GitHub
+- `get-context-bundle` - Project context with Git/GitHub/Kanban
 - `pr-summary` - Pull request journal activity summary
 - `code-review-prep` - Comprehensive PR review preparation
 - `pr-retrospective` - Completed PR analysis with learnings
@@ -261,13 +285,13 @@ The GitHub tools (`get_github_issues`, `get_github_prs`, etc.) can auto-detect t
 
 **[Complete prompts guide →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Prompts)**
 
-### 📡 **14 Resources**
+### 📡 **16 Resources**
 
 - `memory://recent` - 10 most recent entries
 - `memory://significant` - Significant milestones and breakthroughs
 - `memory://graph/recent` - Live Mermaid diagram of recent relationships
 - `memory://team/recent` - Recent team-shared entries
-- `memory://health` - **NEW** Server health & diagnostics
+- `memory://health` - Server health & diagnostics
 - `memory://projects/{number}/timeline` - Project activity timeline
 - `memory://issues/{issue_number}/entries` - Entries linked to issue
 - `memory://prs/{pr_number}/entries` - Entries linked to PR
@@ -276,6 +300,8 @@ The GitHub tools (`get_github_issues`, `get_github_prs`, etc.) can auto-detect t
 - `memory://actions/recent` - Recent workflow runs
 - `memory://tags` - All tags with usage counts
 - `memory://statistics` - Journal statistics
+- `memory://kanban/{project_number}` - **NEW** GitHub Project Kanban board
+- `memory://kanban/{project_number}/diagram` - **NEW** Kanban Mermaid visualization
 
 ---
 
@@ -366,6 +392,22 @@ restore_backup({ filename: "pre_refactor.db", confirm: true })
 // Returns: database stats, backup info, vector index status, tool filter config
 ```
 
+### View and Manage Kanban Board
+
+```javascript
+// View Kanban board with items grouped by Status
+get_kanban_board({ project_number: 5 })
+// → { columns: [{ status: "Todo", items: [...] }, { status: "In Progress", items: [...] }], ... }
+
+// Move an item to a different column
+move_kanban_item({
+  project_number: 5,
+  item_id: "PVTI_...",
+  target_status: "Done"
+})
+// → { success: true, message: 'Item moved to "Done"' }
+```
+
 ### Search and Analyze
 
 ```javascript
@@ -393,11 +435,43 @@ visualize_relationships({
 
 ## 🏗️ Architecture
 
+### Data Flow
+
+```mermaid
+flowchart TB
+    AI["🤖 AI Agent<br/>(Cursor, Windsurf, Claude)"]
+    
+    subgraph MCP["Memory Journal MCP Server"]
+        Tools["🛠️ 29 Tools"]
+        Resources["📡 16 Resources"]
+        Prompts["💬 14 Prompts"]
+    end
+    
+    subgraph Storage["Persistence Layer"]
+        SQLite[("💾 SQLite<br/>Entries, Tags, Relationships")]
+        Vector[("🔍 Vector Index<br/>Semantic Embeddings")]
+        Backups["📦 Backups"]
+    end
+    
+    subgraph External["External Integrations"]
+        GitHub["🐙 GitHub API<br/>Issues, PRs, Actions"]
+        Kanban["📋 Projects v2<br/>Kanban Boards"]
+    end
+    
+    AI <-->|"MCP Protocol"| MCP
+    Tools --> Storage
+    Tools --> External
+    Resources --> Storage
+    Resources --> External
+```
+
+### Stack
+
 ```
 ┌─────────────────────────────────────────────────────────────┐
 │ MCP Server Layer (TypeScript)                               │
 │  ┌─────────────────┐  ┌─────────────────┐  ┌─────────────┐  │
-│  │ Tools (27)      │  │ Resources (14)  │  │ Prompts (14)│  │
+│  │ Tools (29)      │  │ Resources (16)  │  │ Prompts (14)│  │
 │  │ with Annotations│  │ with Annotations│  │             │  │
 │  └─────────────────┘  └─────────────────┘  └─────────────┘  │
 ├─────────────────────────────────────────────────────────────┤

package/VERSION

@@ -1 +1 @@
-3.0.0
+3.1.2

package/dist/cli.js

@@ -8,7 +8,7 @@ const program = new Command();
 program
     .name('memory-journal-mcp')
     .description('Project context management for AI-assisted development')
-    .version('3.0.0-alpha.1')
+    .version('3.1.2')
     .option('--transport <type>', 'Transport type: stdio or http', 'stdio')
     .option('--port <number>', 'HTTP port (for http transport)', '3000')
     .option('--db <path>', 'Database path', './memory_journal.db')

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACF,IAAI,CAAC,oBAAoB,CAAC;KAC1B,WAAW,CAAC,wDAAwD,CAAC;KACrE,OAAO,CAAC,eAAe,CAAC;KACxB,MAAM,CAAC,oBAAoB,EAAE,+BAA+B,EAAE,OAAO,CAAC;KACtE,MAAM,CAAC,iBAAiB,EAAE,gCAAgC,EAAE,MAAM,CAAC;KACnE,MAAM,CAAC,aAAa,EAAE,eAAe,EAAE,qBAAqB,CAAC;KAC7D,MAAM,CAAC,wBAAwB,EAAE,qDAAqD,CAAC;KACvF,MAAM,CAAC,qBAAqB,EAAE,wCAAwC,EAAE,MAAM,CAAC;KAC/E,MAAM,CAAC,KAAK,EAAE,OAMd,EAAE,EAAE;IACD,gBAAgB;IAChB,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAkD,CAAC,CAAC;IAE5E,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE;QAC9C,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,EAAE,EAAE,OAAO,CAAC,EAAE;KACjB,CAAC,CAAC;IAEH,IAAI,CAAC;QACD,MAAM,YAAY,CAAC;YACf,SAAS,EAAE,OAAO,CAAC,SAA6B;YAChD,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAChC,MAAM,EAAE,OAAO,CAAC,EAAE;YAClB,UAAU,EAAE,OAAO,CAAC,UAAU;SACjC,CAAC,CAAC;IACP,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE;YACnC,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAChE,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC,CAAC,CAAC;AAEP,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACF,IAAI,CAAC,oBAAoB,CAAC;KAC1B,WAAW,CAAC,wDAAwD,CAAC;KACrE,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,oBAAoB,EAAE,+BAA+B,EAAE,OAAO,CAAC;KACtE,MAAM,CAAC,iBAAiB,EAAE,gCAAgC,EAAE,MAAM,CAAC;KACnE,MAAM,CAAC,aAAa,EAAE,eAAe,EAAE,qBAAqB,CAAC;KAC7D,MAAM,CAAC,wBAAwB,EAAE,qDAAqD,CAAC;KACvF,MAAM,CAAC,qBAAqB,EAAE,wCAAwC,EAAE,MAAM,CAAC;KAC/E,MAAM,CAAC,KAAK,EAAE,OAMd,EAAE,EAAE;IACD,gBAAgB;IAChB,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAkD,CAAC,CAAC;IAE5E,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE;QAC9C,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,EAAE,EAAE,OAAO,CAAC,EAAE;KACjB,CAAC,CAAC;IAEH,IAAI,CAAC;QACD,MAAM,YAAY,CAAC;YACf,SAAS,EAAE,OAAO,CAAC,SAA6B;YAChD,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAChC,MAAM,EAAE,OAAO,CAAC,EAAE;YAClB,UAAU,EAAE,OAAO,CAAC,UAAU;SACjC,CAAC,CAAC;IACP,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE;YACnC,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAChE,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC,CAAC,CAAC;AAEP,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/constants/ServerInstructions.d.ts

@@ -4,5 +4,28 @@
  * These instructions are automatically sent to MCP clients during initialization,
  * providing guidance for AI agents on tool usage.
  */
-export declare const SERVER_INSTRUCTIONS = "# memory-journal-mcp\n\nMemory Journal MCP Server - Persistent project context management for AI-assisted development.\n\n## GitHub Tools\n\nGitHub tools auto-detect repository from the configured GITHUB_REPO_PATH.\n- If owner/repo are detected, they appear in `detectedOwner`/`detectedRepo` in responses\n- If not detected (null), specify `owner` and `repo` parameters explicitly\n\n## Tool Groups\n\n| Group | Tools |\n|-------|-------|\n| journal | create_entry, create_entry_minimal, update_entry, delete_entry |\n| search | search_entries, semantic_search, search_by_date_range |\n| github | get_github_issues, get_github_prs, get_github_issue, get_github_pr, get_github_context |\n| admin | backup_journal, list_backups, restore_backup, rebuild_vector_index |\n";
+/**
+ * Resource definition for instruction generation
+ */
+export interface ResourceDefinition {
+    uri: string;
+    name: string;
+    description?: string;
+}
+/**
+ * Prompt definition for instruction generation
+ */
+export interface PromptDefinition {
+    name: string;
+    description?: string;
+}
+/**
+ * Generate dynamic instructions based on enabled tools, resources, and prompts
+ */
+export declare function generateInstructions(enabledTools: Set<string>, resources: ResourceDefinition[], prompts: PromptDefinition[]): string;
+/**
+ * Static instructions for backward compatibility
+ * @deprecated Use generateInstructions() instead for dynamic content
+ */
+export declare const SERVER_INSTRUCTIONS = "# memory-journal-mcp Usage Instructions\n\n## How to Access This Server\n\n### Calling Tools\nUse `CallMcpTool` with server name `user-memory-journal-mcp`:\n```\nCallMcpTool(server: \"user-memory-journal-mcp\", toolName: \"create_entry\", arguments: {...})\n```\n\n### Listing Resources\nUse `ListMcpResources` with server name:\n```\nListMcpResources(server: \"user-memory-journal-mcp\")\n```\nDo NOT try to browse filesystem paths for MCP tool/resource definitions - use the MCP protocol directly.\n\n### Fetching Resources\nUse `FetchMcpResource` with server name and `memory://` URI:\n```\nFetchMcpResource(server: \"user-memory-journal-mcp\", uri: \"memory://recent\")\nFetchMcpResource(server: \"user-memory-journal-mcp\", uri: \"memory://kanban/1\")\n```\n\n## Quick Health Check\nFetch `memory://health` to verify server status, database stats, and tool availability.\n\n## Tool Parameter Reference\n\n### Entry Operations\n| Tool | Required Parameters | Optional Parameters |\n|------|---------------------|---------------------|\n| `create_entry` | `content` (string) | `entry_type`, `tags` (array), `is_personal` (bool) |\n| `create_entry_minimal` | `content` (string) | none |\n| `get_entry_by_id` | `entry_id` (number) | none |\n| `get_recent_entries` | none | `limit` (default 10), `is_personal` (bool) |\n| `update_entry` | `entry_id` (number) | `content`, `tags`, `entry_type`, `is_personal` |\n| `delete_entry` | `entry_id` (number) | `permanent` (bool, default false) |\n| `list_tags` | none | none |\n\n### Search Tools\n| Tool | Required Parameters | Optional Parameters |\n|------|---------------------|---------------------|\n| `search_entries` | `query` (string) | `limit`, `entry_type`, `tags` |\n| `search_by_date_range` | `start_date`, `end_date` (YYYY-MM-DD) | `tags`, `entry_type` |\n| `semantic_search` | `query` (string) | `limit` (default 10) |\n| `get_vector_index_stats` | none | none |\n\n### Relationship Tools\n| Tool | Required Parameters | Notes |\n|------|---------------------|-------|\n| `link_entries` | `from_entry_id`, `to_entry_id` (numbers), `relationship_type` | Types: `evolves_from`, `references`, `implements`, `clarifies`, `response_to` |\n| `visualize_relationships` | `entry_id` (number) | Optional `depth` (default 2). Returns Mermaid diagram. |\n\n### GitHub Tools\n| Tool | Required Parameters | Notes |\n|------|---------------------|-------|\n| `get_github_context` | none | Returns repo info, open issues/PRs |\n| `get_github_issues` | none | Optional `state` (open/closed/all), `limit` |\n| `get_github_prs` | none | Optional `state`, `limit` |\n| `get_github_issue` | `issue_number` (number) | Fetches single issue details |\n| `get_github_pr` | `pr_number` (number) | Fetches single PR details |\n\nGitHub tools auto-detect owner/repo from GITHUB_REPO_PATH. If `detectedOwner`/`detectedRepo` are null in response, specify `owner` and `repo` parameters explicitly.\n\n### Kanban Tools (GitHub Projects v2)\n| Tool | Required Parameters | Notes |\n|------|---------------------|-------|\n| `get_kanban_board` | `project_number` (number) | Returns columns with items grouped by Status |\n| `move_kanban_item` | `project_number`, `item_id` (string), `target_status` (string) | `item_id` is the GraphQL node ID from board items |\n\n**Finding the right project**: User may have multiple projects. Use `get_kanban_board` with different project numbers (1, 2, 3...) to find the correct one by checking `projectTitle`.\n\n**Default Status columns** (typical GitHub Projects v2):\n- `Backlog` - Items not yet started\n- `Ready` - Ready to be picked up\n- `In progress` - Actively being worked on\n- `In review` - In review\n- `Done` - Completed\n\nNote: Status columns are dynamic per project. The `statusOptions` in the response shows available statuses for that specific project.\n\nKanban resources:\n- `memory://kanban/{project_number}` - JSON board data\n- `memory://kanban/{project_number}/diagram` - Mermaid visualization\n\n### Admin Tools\n| Tool | Required Parameters | Notes |\n|------|---------------------|-------|\n| `backup_journal` | none | Optional `backup_name` |\n| `list_backups` | none | Returns available backup files |\n| `restore_backup` | `backup_filename`, `confirm: true` | Creates auto-backup before restore |\n| `add_to_vector_index` | `entry_id` (single number) | Indexes one entry for semantic search |\n| `rebuild_vector_index` | none | Re-indexes all entries |\n\n### Export Tools\n| Tool | Required Parameters | Notes |\n|------|---------------------|-------|\n| `export_entries` | none | Optional `format` (json/markdown), `limit`, `tags` |\n\n## Entry Types\nValid values for `entry_type` parameter:\n- `personal_reflection` (default) - Personal thoughts and notes\n- `technical_note` - Technical documentation\n- `bug_fix` - Bug fixes and resolutions\n- `progress_update` - Project progress updates\n- `code_review` - Code review notes\n- `deployment` - Deployment records\n- `technical_achievement` - Milestones and breakthroughs\n\n## Key Resources\n| URI | Description |\n|-----|-------------|\n| `memory://health` | Server health, DB stats, tool filter status |\n| `memory://statistics` | Entry counts by type and period |\n| `memory://recent` | 10 most recent entries |\n| `memory://tags` | All tags with usage counts |\n| `memory://significant` | Entries marked as milestones/breakthroughs |\n| `memory://graph/recent` | Mermaid diagram of recent relationships |\n| `memory://kanban/{n}` | Kanban board for project number n |\n";
 //# sourceMappingURL=ServerInstructions.d.ts.map

package/dist/constants/ServerInstructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServerInstructions.d.ts","sourceRoot":"","sources":["../../src/constants/ServerInstructions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,owBAkB/B,CAAC"}
+{"version":3,"file":"ServerInstructions.d.ts","sourceRoot":"","sources":["../../src/constants/ServerInstructions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AA+HD;;GAEG;AACH,wBAAgB,oBAAoB,CAChC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,SAAS,EAAE,kBAAkB,EAAE,EAC/B,OAAO,EAAE,gBAAgB,EAAE,GAC5B,MAAM,CAqCR;AAkBD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,w5KAAoB,CAAC"}