memory-journal-mcp 6.1.2 → 6.2.1

package/mcp-config-example.json

@@ -1,21 +0,0 @@
-{
-    "mcpServers": {
-        "memory-journal-mcp": {
-            "command": "docker",
-            "args": [
-                "run",
-                "--rm",
-                "-i",
-                "-v",
-                "./data:/app/data",
-                "writenotenow/memory-journal-mcp:latest"
-            ],
-            "env": {
-                "DB_PATH": "/path/to/data/memory_journal.db",
-                "MEMORY_JOURNAL_MCP_TOOL_FILTER": "tool_group_name_here",
-                "GITHUB_TOKEN": "your_github_token_here",
-                "DEFAULT_PROJECT_NUMBER": "1"
-            }
-        }
-    }
-}

package/playwright.config.ts

@@ -1,35 +0,0 @@
-import { defineConfig, devices } from '@playwright/test'
-
-export default defineConfig({
-    testDir: './tests/e2e',
-    outputDir: '.test-output/playwright',
-    fullyParallel: false,
-    forbidOnly: !!process.env.CI,
-    retries: process.env.CI ? 2 : 0,
-    workers: 1,
-    reporter: 'list',
-    use: {
-        baseURL: 'http://localhost:3100',
-        trace: 'on-first-retry',
-    },
-    projects: [
-        {
-            name: 'api',
-            use: { ...devices['Desktop Chrome'] },
-        },
-    ],
-    webServer: {
-        command:
-            'node dist/cli.js --transport http --port 3100 --db ./.test-output/e2e/test-e2e.db --backup-interval 1 --keep-backups 3 --vacuum-interval 2 --rebuild-index-interval 2',
-        env: {
-            ...process.env,
-            // Prevent 429s during E2E runs with many client connections
-            MCP_RATE_LIMIT_MAX: '10000',
-        },
-        url: 'http://localhost:3100/health',
-        reuseExistingServer: !process.env.CI,
-        timeout: 15000,
-        stdout: 'pipe',
-        stderr: 'pipe',
-    },
-})

package/releases/v2.1.0.md

@@ -1,220 +0,0 @@
-# Memory Journal MCP v2.1.0 - GitHub Actions & Complete Type Safety
-
-_Released: November 26, 2025_
-
-## 🎉 Major Release Highlights
-
-Memory Journal v2.1.0 brings comprehensive GitHub Actions integration and true Pyright strict compliance:
-
-1. **🔧 Complete GitHub Actions Integration** - CI/CD visibility with 5 new resources
-2. **🔗 GitHub Issues & Pull Requests** - Auto-detection and linking
-3. **✅ True Pyright Strict Compliance** - 700+ type issues fixed, zero exclusions
-4. **📊 Actions Visual Graph** - CI/CD narrative visualization with Mermaid diagrams
-
-**What this means for you:**
-
-- ✅ **CI status in context** - AI sees your build status in every conversation
-- ✅ **Workflow debugging** - Failure analysis with `actions-failure-digest` prompt
-- ✅ **Better IDE support** - Complete type coverage means better autocomplete
-- ✅ **Issue/PR auto-linking** - Entries automatically linked from branch names
-- ✅ **No breaking changes** - Simply upgrade and restart
-
----
-
-## 🔧 GitHub Actions Integration
-
-### CI Status in Context Bundle
-
-Memory Journal now automatically captures GitHub Actions workflow status:
-
-```json
-{
-  "ci_status": "passing",
-  "github_workflow_runs": [
-    {
-      "id": 12345678,
-      "name": "CI Tests",
-      "status": "completed",
-      "conclusion": "success"
-    }
-  ]
-}
-```
-
-**CI Status Values:**
-
-- `passing` - All recent workflow runs succeeded
-- `failing` - At least one recent workflow run failed
-- `pending` - Workflow runs are in progress or queued
-- `unknown` - No recent workflow runs found
-
-### Linking Entries to Workflow Runs
-
-```javascript
-create_entry({
-  content: 'Fixed flaky test - mocked external API calls',
-  entry_type: 'bug_fix',
-  tags: ['ci', 'testing'],
-  workflow_run_id: 12345678,
-  workflow_name: 'CI Tests',
-  workflow_status: 'completed',
-})
-```
-
-### 5 New GitHub Actions Resources
-
-1. **`memory://graph/actions`** - CI/CD narrative graph visualization
-   - Shows: Commits → Workflow Runs → Failures → Entries → Fixes → Deployments
-   - Query params: `?branch=X&workflow=Y&limit=15`
-
-2. **`memory://actions/recent`** - Recent workflow runs (JSON)
-   - Query params: `?branch=X&workflow=Y&commit=SHA&pr=N&limit=10`
-
-3. **`memory://actions/workflows/{name}/timeline`** - Workflow-specific timeline
-   - Blends: workflow runs, journal entries, PR events
-
-4. **`memory://actions/branches/{branch}/timeline`** - Branch CI timeline
-   - Blends: workflow runs, journal entries, PR lifecycle events
-
-5. **`memory://actions/commits/{sha}/timeline`** - Commit-specific timeline
-   - Blends: workflow runs for commit, related journal entries
-
-### Actions Failure Digest Prompt
-
-New prompt for comprehensive CI/CD failure analysis:
-
-```
-/actions-failure-digest days_back:7 limit:5
-```
-
-**Output includes:**
-
-- Failing jobs summary with failed steps
-- Linked journal entries
-- Recent code/PR changes
-- Previous similar failures (semantic search)
-- Possible root causes
-- Actionable next steps
-
----
-
-## 🔗 GitHub Issues & Pull Requests Integration
-
-### Auto-Detection
-
-Issue and PR numbers are automatically detected from branch names:
-
-- `issue-123`, `issue/123`, `fix/issue-456`
-- `#123` (shorthand)
-- `/123-` or `/123/` patterns
-
-### Manual Linking
-
-```javascript
-create_entry({
-  content: 'Fixed authentication bug',
-  entry_type: 'bug_fix',
-  issue_number: 123,
-  pr_number: 456,
-})
-```
-
-### 3 PR Workflow Prompts
-
-1. **`pr-summary`** - Journal activity summary for a PR
-2. **`code-review-prep`** - Comprehensive PR review preparation
-3. **`pr-retrospective`** - Completed PR analysis with learnings
-
-### 3 New Resources
-
-1. **`memory://issues/{issue_number}/entries`** - All entries linked to an issue
-2. **`memory://prs/{pr_number}/entries`** - All entries linked to a PR
-3. **`memory://prs/{pr_number}/timeline`** - Combined PR + journal timeline
-
----
-
-## ✅ True Pyright Strict Compliance
-
-### What Changed
-
-- **700+ type issues fixed** - Complete strict mode compliance
-- **All exclusions removed** from `pyrightconfig.json`:
-  - Removed `reportMissingTypeStubs` exclusion
-  - Removed `reportUnknownVariableType` exclusion
-  - Removed `reportUnknownMemberType` exclusion
-  - Removed `reportUnknownArgumentType` exclusion
-  - Removed `reportUnknownParameterType` exclusion
-  - Removed `reportUnknownLambdaType` exclusion
-- **All `Any` types replaced** with proper TypedDicts and explicit annotations
-
-### Benefits
-
-- **Type safety badge now accurate** - `Pyright-Strict` reflects true compliance
-- **Better IDE support** - Enhanced autocomplete and error detection
-- **Improved maintainability** - Complete type coverage catches bugs early
-
----
-
-## 📦 Updated Statistics
-
-| Metric           | v2.0.0          | v2.1.0               |
-| ---------------- | --------------- | -------------------- |
-| MCP Tools        | 16              | 16                   |
-| Workflow Prompts | 11              | 14 (+3 PR + Actions) |
-| MCP Resources    | 8               | 13 (+5 Actions)      |
-| Pyright Issues   | 700+ exclusions | 0                    |
-
----
-
-## 🔧 Database Changes
-
-New columns added (automatic migration):
-
-- `workflow_run_id` - GitHub Actions workflow run ID
-- `workflow_name` - Workflow name for quick reference
-- `workflow_status` - Workflow status (queued/in_progress/completed)
-
-New index:
-
-- `idx_memory_journal_workflow_run_id`
-
----
-
-## 📚 Documentation Updates
-
-- Updated all wiki pages with v2.1.0 references
-- Added comprehensive GitHub Actions documentation
-- Updated prompts guide with `actions-failure-digest`
-- Updated visualization guide with `memory://graph/actions`
-
----
-
-## ⬆️ Upgrade Instructions
-
-### PyPI
-
-```bash
-pip install --upgrade memory-journal-mcp
-```
-
-### Docker
-
-```bash
-docker pull writenotenow/memory-journal-mcp:latest
-```
-
-**No configuration changes required!** Database migrations run automatically on startup.
-
----
-
-## 🔗 Links
-
-- **Compare Changes**: https://github.com/neverinfamous/memory-journal-mcp/compare/v2.0.1...v2.1.0
-- **Full Changelog**: [CHANGELOG.md](../CHANGELOG.md)
-- **Wiki**: https://github.com/neverinfamous/memory-journal-mcp/wiki
-- **Docker Hub**: https://hub.docker.com/r/writenotenow/memory-journal-mcp
-- **PyPI**: https://pypi.org/project/memory-journal-mcp/
-
----
-
-**Built by developers, for developers.** 🚀

package/releases/v2.2.0.md

@@ -1,168 +0,0 @@
-# Memory Journal MCP v2.2.0 - Tool Filtering & Token Efficiency
-
-_Released: December 8, 2025_
-
-## 🎉 Release Highlights
-
-Memory Journal v2.2.0 introduces **Tool Filtering** for significant token efficiency gains:
-
-1. **🎛️ Tool Filtering** - Reduce token usage by up to 69%
-2. **🎨 Dark Mode Improvements** - Better contrast in Actions Visual Graph
-3. **📊 Token Efficiency** - Concrete savings for different configurations
-
-**What this means for you:**
-
-- ✅ **Save tokens** - Disable unused tools to reduce context window consumption
-- ✅ **Stay under limits** - Essential for Windsurf (100-tool limit) and constrained clients
-- ✅ **Faster responses** - Smaller context = faster AI processing
-- ✅ **Lower costs** - Fewer tokens = reduced API bills
-- ✅ **No breaking changes** - All 16 tools enabled by default
-
----
-
-## 🎛️ Tool Filtering
-
-### Overview
-
-Control which tools are exposed using `MEMORY_JOURNAL_MCP_TOOL_FILTER`:
-
-```bash
-# Production mode - disable test tools
-MEMORY_JOURNAL_MCP_TOOL_FILTER="-test"
-
-# Read-only mode - prevent modifications
-MEMORY_JOURNAL_MCP_TOOL_FILTER="-admin"
-
-# Lightweight mode - core only (~69% token savings)
-MEMORY_JOURNAL_MCP_TOOL_FILTER="-search,-analytics,-relationships,-export,-admin,-test"
-```
-
-### Token Savings
-
-| Configuration  | Filter         | Tools | Token Reduction |
-| -------------- | -------------- | ----- | --------------- |
-| Full (default) | _(none)_       | 16    | Baseline        |
-| Production     | `-test`        | 14    | ~12%            |
-| Read-only      | `-admin`       | 14    | ~15%            |
-| Focused        | `-test,-admin` | 12    | ~25%            |
-| Lightweight    | (core only)    | 5     | **~69%**        |
-
-### MCP Config Example
-
-```json
-{
-  "mcpServers": {
-    "memory-journal-mcp": {
-      "command": "memory-journal-mcp",
-      "env": {
-        "MEMORY_JOURNAL_MCP_TOOL_FILTER": "-test,-admin",
-        "GITHUB_TOKEN": "your_token"
-      }
-    }
-  }
-}
-```
-
-### Available Tool Groups
-
-| Group           | Tools | Description                                                                  |
-| --------------- | ----- | ---------------------------------------------------------------------------- |
-| `core`          | 5     | create_entry, search_entries, get_recent_entries, get_entry_by_id, list_tags |
-| `search`        | 2     | semantic_search, search_by_date_range                                        |
-| `analytics`     | 2     | get_statistics, get_cross_project_insights                                   |
-| `relationships` | 2     | link_entries, visualize_relationships                                        |
-| `export`        | 1     | export_entries                                                               |
-| `admin`         | 2     | update_entry, delete_entry                                                   |
-| `test`          | 2     | test_simple, create_entry_minimal                                            |
-
-**[Complete Tool Filtering Guide →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Tool-Filtering)**
-
----
-
-## 🎨 Dark Mode Improvements
-
-### Actions Visual Graph
-
-The `memory://graph/actions` resource now uses improved colors for dark mode:
-
-- **Medium-saturated fills** - Better visibility in both light and dark modes
-- **Black text** - Readable on colored backgrounds
-- **Darker strokes** - Clear node boundaries
-- **Compact output** - Class-based Mermaid styling reduces output size
-
-### Color Scheme
-
-| Element         | Color     | Purpose       |
-| --------------- | --------- | ------------- |
-| Commits         | `#4CAF50` | Medium green  |
-| Success runs    | `#66BB6A` | Lighter green |
-| Failed runs     | `#EF5350` | Medium red    |
-| Pending runs    | `#FFCA28` | Amber         |
-| Journal entries | `#42A5F5` | Medium blue   |
-| Deployments     | `#26A69A` | Teal          |
-| Pull requests   | `#AB47BC` | Medium purple |
-
----
-
-## 📦 Updated Statistics
-
-| Metric           | v2.1.0 | v2.2.0            |
-| ---------------- | ------ | ----------------- |
-| MCP Tools        | 16     | 16 (filterable)   |
-| Workflow Prompts | 14     | 14                |
-| MCP Resources    | 13     | 13                |
-| Token Efficiency | N/A    | Up to 69% savings |
-
----
-
-## 🔧 Technical Details
-
-### New Files
-
-- `src/tool_filtering.py` - Complete filtering logic with caching
-- `tests/test_tool_filtering.py` - 100% test coverage
-
-### Changed Files
-
-- `src/server.py` - Integration with filtering in `handle_list_tools()` and `handle_call_tool()`
-- `src/constants.py` - Actions graph color constants
-- `src/handlers/resources.py` - Dark mode color improvements, compact Mermaid output
-
-### Environment Variable
-
-- `MEMORY_JOURNAL_MCP_TOOL_FILTER` - Comma-separated filter rules
-- Processed left-to-right for precise control
-- Cached at startup for performance
-
----
-
-## ⬆️ Upgrade Instructions
-
-### PyPI
-
-```bash
-pip install --upgrade memory-journal-mcp
-```
-
-### Docker
-
-```bash
-docker pull writenotenow/memory-journal-mcp:latest
-```
-
-**No configuration changes required!** All 16 tools remain enabled by default.
-
----
-
-## 🔗 Links
-
-- **Compare Changes**: https://github.com/neverinfamous/memory-journal-mcp/compare/v2.1.0...v2.2.0
-- **Full Changelog**: [CHANGELOG.md](../CHANGELOG.md)
-- **Wiki**: https://github.com/neverinfamous/memory-journal-mcp/wiki
-- **Tool Filtering Guide**: https://github.com/neverinfamous/memory-journal-mcp/wiki/Tool-Filtering
-- **Docker Hub**: https://hub.docker.com/r/writenotenow/memory-journal-mcp
-- **PyPI**: https://pypi.org/project/memory-journal-mcp/
-
----
-
-**Built by developers, for developers.** 🚀

package/releases/v3.0.0.md

@@ -1,237 +0,0 @@
-# Memory Journal MCP v3.0.0 Release Notes
-
-**Release Date:** December 28, 2025
-
----
-
-## 🎉 Overview
-
-Memory Journal v3.0.0 is a **complete ground-up rewrite in TypeScript**, delivering a pure JavaScript stack with zero native dependencies. This release deprecates and archives the Python codebase in favor of a modern, portable, strictly-typed implementation.
-
----
-
-## 🚀 Highlights
-
-### Complete TypeScript Rewrite
-
-- **Strict Type Safety** - 100% TypeScript strict mode with zero lint errors
-- **Pure JS Stack** - No native compilation required:
-  - `sql.js` - SQLite in pure JavaScript
-  - `vectra` - Vector similarity search without native deps
-  - `@xenova/transformers` - ML embeddings in JavaScript
-- **Cross-Platform** - Works on Windows, macOS, Linux without binary dependencies
-- **Faster Startup** - Lazy ML model loading for instant cold starts
-- **MCP 2025-11-25 Compliance** - Full protocol spec compliance
-
-### Dynamic Structured Logging
-
-Enterprise-grade logging with RFC 5424 severity levels:
-
-- **Centralized Logger** - All output to stderr (stdout reserved for MCP protocol)
-- **Structured Format** - `[timestamp] [LEVEL] [MODULE] [CODE] message {context}`
-- **Module Prefixes** - Operation-specific codes like `DB_CONNECT`, `VECTOR_SEARCH`
-- **Debug Mode** - Enable with `DEBUG=true` environment variable
-
-### Tool Annotations (MCP 2025-11-25)
-
-All 27 tools now include behavioral hints:
-
-| Hint              | Purpose                         |
-| ----------------- | ------------------------------- |
-| `readOnlyHint`    | Indicates read-only operations  |
-| `destructiveHint` | Warns of data modification      |
-| `idempotentHint`  | Safe to retry                   |
-| `openWorldHint`   | External service calls (GitHub) |
-
----
-
-## ✨ New Features
-
-### Backup & Restore Tools
-
-Never lose your journal data again with the new `backup` tool group:
-
-| Tool             | Description                                               |
-| ---------------- | --------------------------------------------------------- |
-| `backup_journal` | Create timestamped database backups                       |
-| `list_backups`   | List all available backup files                           |
-| `restore_backup` | Restore from any backup (with auto-backup before restore) |
-
-```javascript
-// Create a named backup
-backup_journal({ name: 'before_migration' })
-// → { success: true, filename: "before_migration.db", sizeBytes: 524288 }
-
-// List available backups
-list_backups()
-// → { backups: [...], total: 3, backupsDirectory: "~/.memory-journal/backups" }
-
-// Restore with safety (auto-creates backup before restore)
-restore_backup({ filename: 'before_migration.db', confirm: true })
-// → { success: true, previousEntryCount: 50, newEntryCount: 42 }
-```
-
-### Server Health Resource
-
-New `memory://health` resource provides comprehensive diagnostics:
-
-```json
-{
-  "database": {
-    "path": "~/.memory-journal/memory_journal.db",
-    "sizeBytes": 524288,
-    "entryCount": 150,
-    "deletedEntryCount": 5,
-    "relationshipCount": 42,
-    "tagCount": 28
-  },
-  "backups": {
-    "directory": "~/.memory-journal/backups",
-    "count": 3,
-    "lastBackup": { "filename": "...", "createdAt": "...", "sizeBytes": 524288 }
-  },
-  "vectorIndex": {
-    "available": true,
-    "indexedEntries": 150,
-    "modelName": "all-MiniLM-L6-v2"
-  },
-  "toolFilter": {
-    "active": false,
-    "enabledCount": 27,
-    "totalCount": 27
-  },
-  "timestamp": "2025-12-28T05:47:00Z"
-}
-```
-
----
-
-## 📊 Capabilities Summary
-
-| Category               | Count | Details                                                                   |
-| ---------------------- | ----- | ------------------------------------------------------------------------- |
-| **MCP Tools**          | 27    | +3 backup tools from v2.x                                                 |
-| **Tool Groups**        | 8     | core, search, analytics, relationships, export, admin, github, **backup** |
-| **Workflow Prompts**   | 14    | Standups, retros, PR workflows, CI/CD analysis                            |
-| **Resources**          | 14    | +1 health resource from v2.x                                              |
-| **Relationship Types** | 5     | relates_to, blocks, follows_up, parent_of, references                     |
-
----
-
-## 🔧 Technical Improvements
-
-### Architecture
-
-- **Modular File Structure** - Clean separation of concerns
-- **Handler Pattern** - Dedicated handlers for tools, prompts, resources
-- **Type-Safe Database Layer** - Full TypeScript types for SQLite operations
-- **Centralized Constants** - Server instructions and configuration
-
-### CI/CD Modernization
-
-- **Native ARM64 Builds** - No more slow QEMU emulation
-- **NPM Publishing** - Replaces PyPI distribution
-- **CodeQL Analysis** - Static security analysis
-- **Docker Scout** - Container vulnerability scanning
-- **Dependabot Auto-Merge** - Automatic patch/minor updates
-
-### Security
-
-- **Input Validation** - Zod schemas for all tool parameters
-- **Path Traversal Protection** - Backup filename validation
-- **SQL Injection Prevention** - Parameterized queries throughout
-- **Content Size Limits** - Configurable per field
-
----
-
-## ⬆️ Migration from v2.x
-
-### Breaking Changes
-
-- **Python Deprecated** - The Python codebase is archived at `archive/python-v2`
-- **Installation Changed** - Now via npm instead of pip:
-
-  ```bash
-  # Old (Python)
-  pip install memory-journal-mcp
-
-  # New (TypeScript)
-  npm install -g memory-journal-mcp
-  ```
-
-### Database Compatibility
-
-✅ **Your existing database is fully compatible!**
-
-The TypeScript version uses the same SQLite schema and data format. No migration needed.
-
-### Configuration Changes
-
-Update your MCP client configuration:
-
-```json
-{
-  "mcpServers": {
-    "memory-journal-mcp": {
-      "command": "memory-journal-mcp"
-    }
-  }
-}
-```
-
-Or use npx (no installation):
-
-```json
-{
-  "mcpServers": {
-    "memory-journal-mcp": {
-      "command": "npx",
-      "args": ["-y", "memory-journal-mcp"]
-    }
-  }
-}
-```
-
----
-
-## 📦 Installation
-
-### npm (Recommended)
-
-```bash
-npm install -g memory-journal-mcp
-```
-
-### Docker
-
-```bash
-docker pull writenotenow/memory-journal-mcp:v3.0.0
-```
-
-### From Source
-
-```bash
-git clone https://github.com/neverinfamous/memory-journal-mcp.git
-cd memory-journal-mcp
-npm install
-npm run build
-```
-
----
-
-## 📚 Resources
-
-- **[GitHub Repository](https://github.com/neverinfamous/memory-journal-mcp)**
-- **[npm Package](https://www.npmjs.com/package/memory-journal-mcp)**
-- **[Docker Hub](https://hub.docker.com/r/writenotenow/memory-journal-mcp)**
-- **[Documentation Wiki](https://github.com/neverinfamous/memory-journal-mcp/wiki)**
-
----
-
-## 🙏 Acknowledgments
-
-Thank you to all users who provided feedback during the Python era. This TypeScript rewrite addresses the core requests for better portability, faster startup, and stricter type safety.
-
----
-
-**Full Changelog:** [v2.2.5...v3.0.0](https://github.com/neverinfamous/memory-journal-mcp/compare/v2.2.5...v3.0.0)