memory-journal-mcp 4.3.0 → 4.4.0

package/DOCKER_README.md

@@ -1,6 +1,6 @@
 # Memory Journal MCP Server
 
-Last Updated January 18, 2026
+**Last Updated February 27, 2026**
 
 [![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)
@@ -10,8 +10,10 @@ Last Updated January 18, 2026
 [![Security](https://img.shields.io/badge/Security-Enhanced-green.svg)](https://github.com/neverinfamous/memory-journal-mcp/blob/main/SECURITY.md)
 [![GitHub Stars](https://img.shields.io/github/stars/neverinfamous/memory-journal-mcp?style=social)](https://github.com/neverinfamous/memory-journal-mcp)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Strict-blue.svg)](https://github.com/neverinfamous/memory-journal-mcp)
+![Coverage](https://img.shields.io/badge/Coverage-80.7%25-brightgreen.svg)
+![Tests](https://img.shields.io/badge/Tests-479_passed-brightgreen.svg)
 
-🎯 **AI Context + Project Intelligence:** Bridge disconnected AI sessions with persistent project memory, while integrating your complete GitHub workflow — Issues, PRs, Actions, Kanban boards, and knowledge graphs — into every conversation.
+🎯 **AI Context + Project Intelligence:** Bridge disconnected AI sessions with persistent project memory, while integrating your complete GitHub workflow — Issues, PRs, Actions, Kanban boards, Milestones, Repository Insights, and Knowledge Graphs into every conversation.
 
 **[GitHub](https://github.com/neverinfamous/memory-journal-mcp)** • **[Wiki](https://github.com/neverinfamous/memory-journal-mcp/wiki)** • **[Changelog](https://github.com/neverinfamous/memory-journal-mcp/wiki/CHANGELOG)** • **[Release Article](https://adamic.tech/articles/memory-journal-mcp-server)**
 
@@ -20,10 +22,11 @@ Last Updated January 18, 2026
 ### Key Benefits
 
 - 🧠 **Dynamic Context Management** - AI agents automatically query your project history and create entries at the right moments
-- 📝 **Auto-capture Git/GitHub context** (commits, branches, issues, PRs, projects)
+- 📝 **Auto-capture Git/GitHub context** (commits, branches, issues, milestones, PRs, projects)
 - 🔗 **Build knowledge graphs** linking specs → implementations → tests → PRs
 - 🔍 **Triple search** (full-text, semantic, date range)
 - 📊 **Generate reports** (standups, retrospectives, PR summaries, status)
+- 📈 **Track repository insights** — stars, forks, clones, views, top referrers, and popular paths (14-day rolling)
 - 🗄️ **Backup & restore** your journal data with one command
 
 ### Deployment Options
@@ -78,10 +81,10 @@ Last Updated January 18, 2026
 
 ### 📈 **Current Capabilities**
 
-- **33 MCP tools** - Complete development workflow + backup/restore + Kanban + issue management
+- **39 MCP tools** - Complete development workflow + backup/restore + Kanban + Milestones + Insights + issue management
 - **15 workflow prompts** - Standups, retrospectives, PR workflows, CI/CD failure analysis, session acknowledgment
-- **18 MCP resources** - 12 static + 6 template (require parameters)
-- **GitHub Integration** - Projects, Issues, Pull Requests, Actions, **Kanban boards**
+- **21 MCP resources** - 14 static + 7 template (require parameters)
+- **GitHub Integration** - Projects, Issues, Pull Requests, Actions, **Kanban boards**, **Milestones**
 - **8 tool groups** - `core`, `search`, `analytics`, `relationships`, `export`, `admin`, `github`, `backup`
 - **Knowledge graphs** - 8 relationship types, Mermaid visualization
 - **Semantic search** - AI-powered conceptual search via `@xenova/transformers`
@@ -165,6 +168,7 @@ To enable GitHub tools (`get_github_issues`, `get_github_prs`, etc.), add enviro
 | `GITHUB_REPO_PATH`       | Path to git repo inside container (mount your repo)                    |
 | `DEFAULT_PROJECT_NUMBER` | Default GitHub Project number for auto-assignment when creating issues |
 | `AUTO_REBUILD_INDEX`     | Set to `true` to rebuild vector index on server startup                |
+| `MCP_HOST`               | Server bind host (`0.0.0.0` for containers, default: `localhost`)      |
 
 **Without `GITHUB_REPO_PATH`**: Explicitly provide `owner` and `repo` when calling GitHub tools.
 
@@ -186,6 +190,8 @@ When GitHub tools cannot auto-detect repository information:
 
 **Google AntiGravity IDE:**
 
+- **AntiGravity Users:** Server instructions are automatically sent to MCP clients during initialization. However, AntiGravity does not currently support MCP server instructions. For optimal usage in AntiGravity, manually provide the contents of [`src/constants/ServerInstructions.ts`](src/constants/ServerInstructions.ts) to the agent in your prompt or user rules.
+
 - **Session start**: Add to your user rules: "At session start, read `memory://briefing` from memory-journal-mcp."
 
 - **Full guidance**: If behaviors missing, read `memory://instructions` for complete Dynamic Context Management patterns.
@@ -202,7 +208,7 @@ For remote access, web-based clients, or HTTP-compatible MCP hosts:
 docker run --rm -p 3000:3000 \
   -v ./data:/app/data \
   writenotenow/memory-journal-mcp:latest \
-  --transport http --port 3000
+  --transport http --port 3000 --server-host 0.0.0.0
 ```
 
 **Stateless Mode (serverless):**
@@ -211,7 +217,7 @@ docker run --rm -p 3000:3000 \
 docker run --rm -p 3000:3000 \
   -v ./data:/app/data \
   writenotenow/memory-journal-mcp:latest \
-  --transport http --port 3000 --stateless
+  --transport http --port 3000 --server-host 0.0.0.0 --stateless
 ```
 
 **Endpoints:**
@@ -300,18 +306,18 @@ docker pull writenotenow/memory-journal-mcp@sha256:<manifest-digest>
 
 ## ⚡ Core Features
 
-### 🛠️ 33 MCP Tools (8 Groups)
+### 🛠️ 39 MCP Tools (8 Groups)
 
-| Group           | Tools | Description                                         |
-| --------------- | ----- | --------------------------------------------------- |
-| `core`          | 6     | Entry CRUD, tags, test                              |
-| `search`        | 4     | Text search, date range, semantic, vector stats     |
-| `analytics`     | 2     | Statistics, cross-project insights                  |
-| `relationships` | 2     | Link entries, visualize graphs                      |
-| `export`        | 1     | JSON/Markdown export                                |
-| `admin`         | 5     | Update, delete, vector index management, merge tags |
-| `github`        | 9     | Issues, PRs, context, Kanban, **issue lifecycle**   |
-| `backup`        | 4     | Backup, list, restore, cleanup                      |
+| Group           | Tools | Description                                                                     |
+| --------------- | ----- | ------------------------------------------------------------------------------- |
+| `core`          | 6     | Entry CRUD, tags, test                                                          |
+| `search`        | 4     | Text search, date range, semantic, vector stats                                 |
+| `analytics`     | 2     | Statistics, cross-project insights                                              |
+| `relationships` | 2     | Link entries, visualize graphs                                                  |
+| `export`        | 1     | JSON/Markdown export                                                            |
+| `admin`         | 5     | Update, delete, rebuild/add to vector index, merge tags                         |
+| `github`        | 15    | Issues, PRs, context, Kanban, **Milestones**, **Insights**, **issue lifecycle** |
+| `backup`        | 4     | Backup, list, restore, cleanup                                                  |
 
 **[Complete tools documentation →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Tools)**
 
@@ -320,9 +326,9 @@ 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)**
 
-### 📡 18 Resources (12 Static + 6 Template)
+### 📡 21 Resources (14 Static + 7 Template)
 
-Including `memory://briefing` for session initialization, `memory://instructions` for behavioral guidance, `memory://health` for diagnostics, and `memory://kanban/{n}` for Kanban boards. Template resources require parameters and are accessed directly by URI.
+Including `memory://briefing` for session initialization, `memory://instructions` for behavioral guidance, `memory://health` for diagnostics, `memory://kanban/{n}` for Kanban boards, `memory://github/milestones` for milestone tracking, and `memory://github/insights` for repository traffic analytics. Template resources require parameters and are accessed directly by URI.
 **[Resources documentation →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Resources)**
 
 ---
@@ -345,34 +351,38 @@ Including `memory://briefing` for session initialization, `memory://instructions
 ```bash
 # GitHub integration (optional - enables Projects/Issues/PRs)
 -e GITHUB_TOKEN=your_token
--e GITHUB_ORG_TOKEN=your_org_token  # For org projects
--e DEFAULT_ORG=your-org-name
 
 # Tool filtering (optional - control which tools are exposed)
 -e MEMORY_JOURNAL_MCP_TOOL_FILTER="-github"
 
+# Server bind host (required for containers, default: localhost)
+-e MCP_HOST=0.0.0.0
+
 # Database location
 -e DB_PATH=/app/data/custom.db
 ```
 
-**Token Scopes:** `repo`, `project`, `read:org` (org projects only)
+**Token Scopes:** `repo`, `project`, `read:org` (org-level project discovery only)
 **[Full configuration guide →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Installation#configuration)**
 
 ### GitHub Management Capabilities
 
 Memory Journal provides a **hybrid approach** to GitHub management:
 
-| Capability Source  | Purpose                                                                        |
-| ------------------ | ------------------------------------------------------------------------------ |
-| **MCP Server**     | Specialized features: Kanban visualization, journal linking, project timelines |
-| **Agent (gh CLI)** | Full GitHub mutations: create/close issues, create/merge PRs, manage releases  |
+| Capability Source  | Purpose                                                                                    |
+| ------------------ | ------------------------------------------------------------------------------------------ |
+| **MCP Server**     | Specialized features: Kanban visualization, Milestones, journal linking, project timelines |
+| **Agent (gh CLI)** | Full GitHub mutations: create/close issues, create/merge PRs, manage releases              |
 
-**MCP Server Tools (Read + Kanban + Issue Lifecycle):**
+**MCP Server Tools (Read + Kanban + Milestones + Issue Lifecycle):**
 
 - `get_github_issues` / `get_github_issue` - Query issues
 - `get_github_prs` / `get_github_pr` - Query pull requests
 - `get_github_context` - Full repository context
 - `get_kanban_board` / `move_kanban_item` - **Kanban management**
+- `get_github_milestones` / `get_github_milestone` - **Milestone tracking with completion %**
+- `create_github_milestone` / `update_github_milestone` / `delete_github_milestone` - **Milestone CRUD**
+- `get_repo_insights` - **Repository traffic & analytics** (stars, clones, views, referrers, popular paths)
 - `create_github_issue_with_entry` / `close_github_issue_with_entry` - **Issue lifecycle with journal linking**
 
 **Agent Operations (via gh CLI):**
@@ -387,7 +397,7 @@ gh pr create --fill
 gh pr merge 123
 ```
 
-> **Why this design?** The MCP server focuses on value-added features that integrate journal entries with GitHub (Kanban views, timeline resources, context linking). Standard GitHub mutations are handled by `gh` CLI, which agents can invoke directly.
+> **Why this design?** The MCP server focuses on value-added features that integrate journal entries with GitHub (Kanban views, Milestones, timeline resources, context linking). Standard GitHub mutations are handled by `gh` CLI, which agents can invoke directly.
 
 **[Complete GitHub integration guide →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Git-Integration)**
 
@@ -438,6 +448,14 @@ docker run -i --rm \
 - **Instant Startup** - Lazy loading of ML models
 - **Production/Stable** - Comprehensive error handling and automatic migrations
 
+**Performance Benchmarks:**
+
+Memory Journal is designed for extremely low overhead during AI task execution.
+
+- **Database Reads**: Operations execute in fractions of a millisecond. `calculateImportance` is ~55x faster than retrieving 50 recent entries.
+- **Vector Search Engine**: Semantic searches via `vectra` perform significantly faster than parallel entry indexing (>190x faster locally).
+- **Core MCP Routines**: Complex operations exhibit negligible latency when executed through standard MCP tools. Calling tools natively adds ~1.4x overhead compared to direct function execution.
+
 **Automated Deployment:**
 
 - ⚡ **Always Fresh** - Images built within minutes of commits
@@ -448,9 +466,9 @@ docker run -i --rm \
 
 **Available Tags:**
 
-- `4.0.0` - Specific version (recommended for production)
-- `3.0` - Latest patch in 3.0.x series
-- `3` - Latest minor in 3.x series
+- `4.4.0` - Specific version (recommended for production)
+- `4.4` - Latest patch in 4.4.x series
+- `4` - Latest minor in 4.x series
 - `latest` - Always the newest version
 - `sha256-<digest>` - SHA-pinned for maximum security
 

package/Dockerfile

@@ -23,13 +23,13 @@ RUN cd /usr/local/lib/node_modules/npm && \
     mv package node_modules/diff && \
     rm diff-8.0.3.tgz
 
-# Fix CVE-2026-23745: Manually update npm's bundled tar@7.5.2 to 7.5.3
+# Fix CVE-2026-23950, CVE-2026-24842, CVE-2026-26960: Manually update npm's bundled tar to 7.5.8
 RUN cd /usr/local/lib/node_modules/npm && \
-    npm pack tar@7.5.3 && \
+    npm pack tar@7.5.8 && \
     rm -rf node_modules/tar && \
-    tar -xzf tar-7.5.3.tgz && \
+    tar -xzf tar-7.5.8.tgz && \
     mv package node_modules/tar && \
-    rm tar-7.5.3.tgz
+    rm tar-7.5.8.tgz
 
 # Copy package files first for better layer caching
 COPY package*.json .npmrc ./
@@ -56,8 +56,9 @@ WORKDIR /app
 
 # Install runtime dependencies with security fixes
 # Use Alpine edge for curl with CVE fixes
+# Explicit libexpat upgrade for CVE-2026-24515 (CRITICAL) and CVE-2026-25210 (MEDIUM)
 RUN apk add --no-cache git ca-certificates && \
-    apk add --no-cache --repository=https://dl-cdn.alpinelinux.org/alpine/edge/main curl && \
+    apk add --no-cache --repository=https://dl-cdn.alpinelinux.org/alpine/edge/main curl libexpat && \
     apk upgrade --no-cache && \
     npm install -g npm@latest --force && npm cache clean --force
 
@@ -69,13 +70,13 @@ RUN cd /usr/local/lib/node_modules/npm && \
     mv package node_modules/diff && \
     rm diff-8.0.3.tgz
 
-# Fix CVE-2026-23745: Manually update npm's bundled tar@7.5.2 to 7.5.3
+# Fix CVE-2026-23950, CVE-2026-24842, CVE-2026-26960: Manually update npm's bundled tar to 7.5.8
 RUN cd /usr/local/lib/node_modules/npm && \
-    npm pack tar@7.5.3 && \
+    npm pack tar@7.5.8 && \
     rm -rf node_modules/tar && \
-    tar -xzf tar-7.5.3.tgz && \
+    tar -xzf tar-7.5.8.tgz && \
     mv package node_modules/tar && \
-    rm tar-7.5.3.tgz
+    rm tar-7.5.8.tgz
 
 # Copy built artifacts and production dependencies
 COPY --from=builder /app/dist ./dist
@@ -98,9 +99,10 @@ ENV DB_PATH=/app/data/memory_journal.db
 # Switch to non-root user
 USER appuser
 
-# Health check
+# Health check - validates Node.js is responsive
+# For HTTP mode, override with: HEALTHCHECK CMD curl -f http://localhost:3000/mcp || exit 1
 HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
-    CMD node -e "console.log('Server healthy')" || exit 1
+    CMD node -e "process.exit(0)" || exit 1
 
 # Run the MCP server
 CMD ["node", "dist/cli.js"]
@@ -108,6 +110,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="4.0.0"
+LABEL version="4.4.0"
 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 January 18, 2026
+**Last Updated February 27, 2026**
 
 <!-- mcp-name: io.github.neverinfamous/memory-journal-mcp -->
 
@@ -12,8 +12,10 @@ Last Updated January 18, 2026
 [![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)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Strict-blue.svg)](https://github.com/neverinfamous/memory-journal-mcp)
+![Coverage](https://img.shields.io/badge/Coverage-80.7%25-brightgreen.svg)
+![Tests](https://img.shields.io/badge/Tests-479_passed-brightgreen.svg)
 
-🎯 **AI Context + Project Intelligence:** Bridge disconnected AI sessions with persistent project memory, while integrating your complete GitHub workflow — Issues, PRs, Actions, Kanban boards, and knowledge graphs — into every conversation.
+🎯 **AI Context + Project Intelligence:** Bridge disconnected AI sessions with persistent project memory, while integrating your complete GitHub workflow — Issues, PRs, Actions, Kanban boards, Milestones, Repository Insights, and Knowledge Graphs — into every conversation.
 
 **[GitHub](https://github.com/neverinfamous/memory-journal-mcp)** • **[Wiki](https://github.com/neverinfamous/memory-journal-mcp/wiki)** • **[Changelog](https://github.com/neverinfamous/memory-journal-mcp/wiki/CHANGELOG)** • **[Release Article](https://adamic.tech/articles/memory-journal-mcp-server)**
 
@@ -27,10 +29,11 @@ Last Updated January 18, 2026
 ### Key Benefits
 
 - 🧠 **Dynamic Context Management** - AI agents automatically query your project history and create entries at the right moments
-- 📝 **Auto-capture Git/GitHub context** (commits, branches, issues, PRs, projects)
+- 📝 **Auto-capture Git/GitHub context** (commits, branches, issues, milestones, PRs, projects)
 - 🔗 **Build knowledge graphs** linking specs → implementations → tests → PRs
 - 🔍 **Triple search** (full-text, semantic, date range)
 - 📊 **Generate reports** (standups, retrospectives, PR summaries, status)
+- 📈 **Track repository insights** — stars, forks, clones, views, top referrers, and popular paths (14-day rolling)
 - 🗄️ **Backup & restore** your journal data with one command
 
 ```mermaid
@@ -73,10 +76,10 @@ flowchart TB
 
 ### 📈 **Current Capabilities**
 
-- **33 MCP tools** - Complete development workflow + backup/restore + Kanban + issue management
+- **39 MCP tools** - Complete development workflow + backup/restore + Kanban + Milestones + Insights + issue management
 - **15 workflow prompts** - Standups, retrospectives, PR workflows, CI/CD failure analysis, session acknowledgment
-- **18 MCP resources** - 12 static + 6 template (require parameters)
-- **GitHub Integration** - Projects, Issues, Pull Requests, Actions, **Kanban boards**
+- **21 MCP resources** - 14 static + 7 template (require parameters)
+- **GitHub Integration** - Projects, Issues, Pull Requests, Actions, **Kanban boards**, **Milestones**
 - **8 tool groups** - `core`, `search`, `analytics`, `relationships`, `export`, `admin`, `github`, `backup`
 - **Knowledge graphs** - 8 relationship types, Mermaid visualization
 - **Semantic search** - AI-powered conceptual search via `@xenova/transformers`
@@ -182,6 +185,12 @@ For remote access or web-based clients, run the server in HTTP mode:
 memory-journal-mcp --transport http --port 3000
 ```
 
+To bind to all interfaces (required for containers):
+
+```bash
+memory-journal-mcp --transport http --port 3000 --server-host 0.0.0.0
+```
+
 **Endpoints:**
 
 - `POST /mcp` — JSON-RPC requests (initialize, tools/call, etc.)
@@ -247,6 +256,7 @@ The GitHub tools (`get_github_issues`, `get_github_prs`, etc.) can auto-detect t
 | `GITHUB_REPO_PATH`       | Path to the git repository for auto-detecting owner/repo               |
 | `DEFAULT_PROJECT_NUMBER` | Default GitHub Project number for auto-assignment when creating issues |
 | `AUTO_REBUILD_INDEX`     | Set to `true` to rebuild vector index on server startup                |
+| `MCP_HOST`               | Server bind host (`0.0.0.0` for containers, default: `localhost`)      |
 
 **Without `GITHUB_REPO_PATH`**: You'll need to explicitly provide `owner` and `repo` parameters when calling GitHub tools.
 
@@ -276,6 +286,8 @@ When GitHub tools cannot auto-detect repository information:
 
 **Google AntiGravity IDE:**
 
+- **AntiGravity Users:** Server instructions are automatically sent to MCP clients during initialization. However, AntiGravity does not currently support MCP server instructions. For optimal usage in AntiGravity, manually provide the contents of [`src/constants/ServerInstructions.ts`](src/constants/ServerInstructions.ts) to the agent in your prompt or user rules.
+
 - **Session start**: Add to your user rules: "At session start, read `memory://briefing` from memory-journal-mcp."
 
 - **Full guidance**: If behaviors missing, read `memory://instructions` for complete Dynamic Context Management patterns.
@@ -286,18 +298,18 @@ When GitHub tools cannot auto-detect repository information:
 
 ## 📋 Core Capabilities
 
-### 🛠️ **33 MCP Tools** (8 Groups)
+### 🛠️ **39 MCP Tools** (8 Groups)
 
-| Group           | Tools | Description                                             |
-| --------------- | ----- | ------------------------------------------------------- |
-| `core`          | 6     | Entry CRUD, tags, test                                  |
-| `search`        | 4     | Text search, date range, semantic, vector stats         |
-| `analytics`     | 2     | Statistics, cross-project insights                      |
-| `relationships` | 2     | Link entries, visualize graphs                          |
-| `export`        | 1     | JSON/Markdown export                                    |
-| `admin`         | 5     | Update, delete, rebuild/add to vector index, merge tags |
-| `github`        | 9     | Issues, PRs, context, Kanban, **issue lifecycle**       |
-| `backup`        | 4     | Backup, list, restore, cleanup                          |
+| Group           | Tools | Description                                                                     |
+| --------------- | ----- | ------------------------------------------------------------------------------- |
+| `core`          | 6     | Entry CRUD, tags, test                                                          |
+| `search`        | 4     | Text search, date range, semantic, vector stats                                 |
+| `analytics`     | 2     | Statistics, cross-project insights                                              |
+| `relationships` | 2     | Link entries, visualize graphs                                                  |
+| `export`        | 1     | JSON/Markdown export                                                            |
+| `admin`         | 5     | Update, delete, rebuild/add to vector index, merge tags                         |
+| `github`        | 15    | Issues, PRs, context, Kanban, **Milestones**, **Insights**, **issue lifecycle** |
+| `backup`        | 4     | Backup, list, restore, cleanup                                                  |
 
 **[Complete tools reference →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Tools)**
 
@@ -310,20 +322,23 @@ When GitHub tools cannot auto-detect repository information:
 - `analyze-period` - Deep period analysis with insights
 - `goal-tracker` - Milestone and achievement tracking
 - `get-context-bundle` - Project context with Git/GitHub/Kanban
+- `get-recent-entries` - Formatted recent entries
+- `project-status-summary` - GitHub Project status reports
 - `pr-summary` - Pull request journal activity summary
 - `code-review-prep` - Comprehensive PR review preparation
 - `pr-retrospective` - Completed PR analysis with learnings
 - `actions-failure-digest` - CI/CD failure analysis
-- `confirm-briefing` - **NEW** Acknowledge session context to user
+- `project-milestone-tracker` - Milestone progress tracking
+- `confirm-briefing` - Acknowledge session context to user
 
 **[Complete prompts guide →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Prompts)**
 
-### 📡 **18 Resources** (12 Static + 6 Template)
+### 📡 **21 Resources** (14 Static + 7 Template)
 
 **Static Resources** (appear in resource lists):
 
 - `memory://briefing` - **Session initialization**: compact context for AI agents (~300 tokens)
-- `memory://instructions` - **Behavioral guidance**: complete server instructions (supports `?level=essential|standard|full`)
+- `memory://instructions` - **Behavioral guidance**: complete server instructions for AI agents
 - `memory://recent` - 10 most recent entries
 - `memory://significant` - Significant milestones and breakthroughs
 - `memory://graph/recent` - Live Mermaid diagram of recent relationships
@@ -334,6 +349,8 @@ When GitHub tools cannot auto-detect repository information:
 - `memory://tags` - All tags with usage counts
 - `memory://statistics` - Journal statistics
 - `memory://github/status` - GitHub repository status overview
+- `memory://github/insights` - Repository stars, forks, and 14-day traffic summary
+- `memory://github/milestones` - Open milestones with completion percentages
 
 **Template Resources** (require parameters, fetch directly by URI):
 
@@ -343,6 +360,7 @@ When GitHub tools cannot auto-detect repository information:
 - `memory://prs/{pr_number}/timeline` - Combined PR + journal timeline
 - `memory://kanban/{project_number}` - GitHub Project Kanban board
 - `memory://kanban/{project_number}/diagram` - Kanban Mermaid visualization
+- `memory://milestones/{number}` - Milestone detail with completion progress
 
 ---
 
@@ -352,27 +370,28 @@ When GitHub tools cannot auto-detect repository information:
 
 ```bash
 export GITHUB_TOKEN="your_token"              # For Projects/Issues/PRs
-export GITHUB_ORG_TOKEN="your_org_token"      # Optional: org projects
-export DEFAULT_ORG="your-org-name"            # Optional: default org
 ```
 
-**Scopes:** `repo`, `project`, `read:org` (org only)
+**Scopes:** `repo`, `project`, `read:org` (org-level project discovery only)
 
 ### GitHub Management Capabilities
 
 Memory Journal provides a **hybrid approach** to GitHub management:
 
-| Capability Source  | Purpose                                                                        |
-| ------------------ | ------------------------------------------------------------------------------ |
-| **MCP Server**     | Specialized features: Kanban visualization, journal linking, project timelines |
-| **Agent (gh CLI)** | Full GitHub mutations: create/close issues, create/merge PRs, manage releases  |
+| Capability Source  | Purpose                                                                                    |
+| ------------------ | ------------------------------------------------------------------------------------------ |
+| **MCP Server**     | Specialized features: Kanban visualization, Milestones, journal linking, project timelines |
+| **Agent (gh CLI)** | Full GitHub mutations: create/close issues, create/merge PRs, manage releases              |
 
-**MCP Server Tools (Read + Kanban + Issue Lifecycle):**
+**MCP Server Tools (Read + Kanban + Milestones + Issue Lifecycle):**
 
 - `get_github_issues` / `get_github_issue` - Query issues
 - `get_github_prs` / `get_github_pr` - Query pull requests
 - `get_github_context` - Full repository context
 - `get_kanban_board` / `move_kanban_item` - **Kanban management**
+- `get_github_milestones` / `get_github_milestone` - **Milestone tracking with completion %**
+- `create_github_milestone` / `update_github_milestone` / `delete_github_milestone` - **Milestone CRUD**
+- `get_repo_insights` - **Repository traffic & analytics** (stars, clones, views, referrers, popular paths)
 - `create_github_issue_with_entry` / `close_github_issue_with_entry` - **Issue lifecycle with journal linking**
 
 **Agent Operations (via gh CLI):**
@@ -432,8 +451,8 @@ export MEMORY_JOURNAL_MCP_TOOL_FILTER="-analytics,-github"
 | -------------- | ------------- | ----- |
 | Starter        | `starter`     | ~10   |
 | Essential      | `essential`   | ~6    |
-| Full (default) | `full`        | 33    |
-| Read-only      | `readonly`    | ~20   |
+| Full (default) | `full`        | 39    |
+| Read-only      | `readonly`    | ~15   |
 
 **[Complete tool filtering guide →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Tool-Filtering)**
 
@@ -448,8 +467,8 @@ flowchart TB
     AI["🤖 AI Agent<br/>(Cursor, Windsurf, Claude)"]
 
     subgraph MCP["Memory Journal MCP Server"]
-        Tools["🛠️ 33 Tools"]
-        Resources["📡 18 Resources"]
+        Tools["🛠️ 39 Tools"]
+        Resources["📡 21 Resources"]
         Prompts["💬 15 Prompts"]
     end
 
@@ -477,7 +496,7 @@ flowchart TB
 ┌─────────────────────────────────────────────────────────────┐
 │ MCP Server Layer (TypeScript)                               │
 │  ┌─────────────────┐  ┌─────────────────┐  ┌─────────────┐  │
-│  │ Tools (33)      │  │ Resources (18)  │  │ Prompts (15)│  │
+│  │ Tools (39)      │  │ Resources (21)  │  │ Prompts (15)│  │
 │  │ with Annotations│  │ with Annotations│  │             │  │
 │  └─────────────────┘  └─────────────────┘  └─────────────┘  │
 ├─────────────────────────────────────────────────────────────┤
@@ -506,12 +525,28 @@ flowchart TB
 - **@xenova/transformers** - ML embeddings in JavaScript
 - **Lazy loading** - ML models load on first use, not startup
 
+### Performance Benchmarks
+
+Memory Journal is designed for extremely low overhead during AI task execution. We include a `vitest bench` suite to maintain these baseline guarantees:
+
+- **Database Reads**: Operations execute in fractions of a millisecond. `calculateImportance` is ~55x faster than retrieving 50 recent entries.
+- **Vector Search Engine**: Semantic searches via `vectra` perform significantly faster than parallel entry indexing (>190x faster locally).
+- **Core MCP Routines**: Complex operations exhibit negligible latency when executed through standard MCP tools. Calling tools natively adds ~1.4x overhead compared to direct function execution.
+
+To run the benchmarking suite locally:
+
+```bash
+npm run bench
+```
+
 ### Security
 
 - **Local-first** - All data stored locally, no external API calls (except optional GitHub)
 - **Input validation** - Zod schemas, content size limits, SQL injection prevention
 - **Path traversal protection** - Backup filenames validated
 - **MCP 2025-11-25 annotations** - Behavioral hints (`readOnlyHint`, `destructiveHint`, etc.)
+- **HTTP transport hardening** - Configurable CORS, 1MB body limit, security headers, 30-min session timeout
+- **Token scrubbing** - GitHub tokens and credentials automatically redacted from error logs
 
 ### Data & Privacy