# v3.1.0 - GitHub Projects v2 Kanban Support

**Release Date:** January 11, 2026

## Highlights

This release adds GitHub Projects v2 Kanban board integration, comprehensive AI agent instructions, and infrastructure updates including a Docker Node.js upgrade and dependency updates.

---

## Added

### GitHub Projects v2 Kanban Support

View and manage GitHub Project boards directly from AI agents:

- **New Tool: `get_kanban_board`** — Fetch project items grouped by Status columns (Backlog, Ready, In progress, In review, Done)
- **New Tool: `move_kanban_item`** — Move items between status columns using GraphQL mutations
- **New Resource: `memory://kanban/{project_number}`** — JSON board data with items grouped by status
- **New Resource: `memory://kanban/{project_number}/diagram`** — Mermaid visualization of Kanban board
- **Multi-level project discovery** — Searches user → repository → organization level projects automatically
- **Dynamic status columns** — Supports any Status field configuration per project

### Server Instructions

Usage instructions are now automatically provided to AI agents via the MCP protocol's `instructions` capability during server initialization.

- Explicit MCP access patterns (`CallMcpTool`, `ListMcpResources`, `FetchMcpResource`)
- Tool parameter reference tables for all 29 tools
- Default GitHub Projects v2 status column documentation
- Guidance for finding correct project by `projectTitle`

See [`src/constants/ServerInstructions.ts`](https://github.com/neverinfamous/memory-journal-mcp/blob/main/src/constants/ServerInstructions.ts)

---

## Fixed

### Dependabot Configuration

Migrated from deprecated `pip` ecosystem to `npm` ecosystem:

- **Root Cause**: The v3.0.0 TypeScript rewrite removed all Python dependency files, but Dependabot was still configured for `pip`
- **Symptom**: Dependabot security scans failed with `dependency_file_not_found: / not found`
- **Resolution**: Replaced `pip` ecosystem with `npm` ecosystem and updated dependency groups to match TypeScript/Node.js packages (MCP SDK, Zod, sql.js, vectra, build tools, linting)

---

## Changed

### Docker Base Image

Upgraded from `node:22-alpine` to `node:24-alpine` (Active LTS):

- Node.js 24 is the current Active LTS release (support through April 2028)
- Node.js 25 was skipped as it's a non-LTS "Current" release (EOL June 2026)

### Dependency Updates

| Package                     | Previous | New    | Type  |
| --------------------------- | -------- | ------ | ----- |
| `@modelcontextprotocol/sdk` | 1.25.1   | 1.25.2 | patch |
| `@octokit/rest`             | 21.1.1   | 22.0.1 | major |
| `globals`                   | 16.5.0   | 17.0.0 | major |
| `typescript-eslint`         | 8.50.1   | 8.52.0 | minor |
| `vectra`                    | 0.9.0    | 0.11.1 | minor |
| `zod`                       | 4.2.1    | 4.3.5  | minor |

**Note:** Updated `vectra` `queryItems` call to new API signature with BM25 hybrid search support.

---

## Capabilities Summary

| Category        | Count | Notes                                                                 |
| --------------- | ----- | --------------------------------------------------------------------- |
| **Tools**       | 29    | +2 Kanban tools (`get_kanban_board`, `move_kanban_item`)              |
| **Tool Groups** | 8     | core, search, analytics, relationships, export, admin, github, backup |
| **Prompts**     | 14    | Unchanged from v3.0.0                                                 |
| **Resources**   | 16    | +2 Kanban resources                                                   |

---

## Installation

**npm:**

```bash
npm install -g memory-journal-mcp@3.1.0
```

**Docker:**

```bash
docker pull writenotenow/memory-journal-mcp:3.1.0
```

---

## Links

- [Full Changelog](https://github.com/neverinfamous/memory-journal-mcp/wiki/CHANGELOG)
- [GitHub Repository](https://github.com/neverinfamous/memory-journal-mcp)
- [Documentation Wiki](https://github.com/neverinfamous/memory-journal-mcp/wiki)
