memory-journal-mcp 7.2.0 → 7.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +69 -64
- package/dist/{chunk-GR4T3SRW.js → chunk-5ZA77VUW.js} +688 -121
- package/dist/{chunk-ORV7ZZOE.js → chunk-P5V2VY6N.js} +365 -74
- package/dist/{chunk-IWKLHSPU.js → chunk-WXDEVIFL.js} +6 -6
- package/dist/cli.js +9 -4
- package/dist/github-integration-YODGZH3K.js +1 -0
- package/dist/index.d.ts +17 -2
- package/dist/index.js +3 -3
- package/dist/{tools-CXR2FEB2.js → tools-WZUENKJ6.js} +2 -2
- package/package.json +4 -4
- package/skills/README.md +5 -1
- package/skills/docker/SKILL.md +262 -0
- package/skills/github-actions/SKILL.md +315 -0
- package/skills/package.json +5 -1
- package/skills/python/SKILL.md +257 -0
- package/skills/tailwind-css/SKILL.md +268 -0
- package/dist/github-integration-2TFMXHIJ.js +0 -1
package/README.md
CHANGED
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
[](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.neverinfamous/memory-journal-mcp)
|
|
11
11
|
[](SECURITY.md)
|
|
12
12
|
[](https://github.com/neverinfamous/memory-journal-mcp)
|
|
13
|
-
|
|
14
14
|
|
|
15
15
|
|
|
16
16
|
[](https://github.com/neverinfamous/memory-journal-mcp/actions/workflows/gatekeeper.yml)
|
|
@@ -24,57 +24,56 @@
|
|
|
24
24
|
- **[npm Package](https://www.npmjs.com/package/memory-journal-mcp)** - `npm install -g memory-journal-mcp`
|
|
25
25
|
- **[Docker Hub](https://hub.docker.com/r/writenotenow/memory-journal-mcp)** - Alpine-based with full semantic search
|
|
26
26
|
|
|
27
|
-
##
|
|
28
|
-
|
|
29
|
-
### What Sets Us Apart
|
|
30
|
-
|
|
31
|
-
**67 MCP Tools** · **17 Workflow Prompts** · **34 Resources** · **10 Tool Groups** · **Code Mode** · **GitHub Commander** (Issue Triage, PR Review, Milestone Sprints, Security/Quality/Perf Audits) · **GitHub Integration** (Issues, PRs, Actions, Kanban, Milestones, Insights) · **Team Collaboration** (Shared DB, Vector Search, Cross-Project Insights)
|
|
32
|
-
|
|
33
|
-
| Feature | Description |
|
|
34
|
-
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
35
|
-
| **Session Intelligence** | Agents auto-query project history, create entries at checkpoints, and hand off context between sessions via `/session-summary` and `team-session-summary` |
|
|
36
|
-
| **GitHub Integration** | 18 tools for Issues, PRs, Actions, Kanban, Milestones (%), Copilot Reviews, and 14-day Insights |
|
|
37
|
-
| **Dynamic Project Routing** | Seamlessly switch contexts and access CI/Issue tracking across multiple repositories using a single server instance via `PROJECT_REGISTRY` |
|
|
38
|
-
| **Knowledge Graphs** | 8 relationship types linking specs → implementations → tests → PRs with Mermaid visualization |
|
|
39
|
-
| **Hybrid Search** | Reciprocal Rank Fusion combining FTS5 keywords, semantic vector similarity, auto-heuristics, and date-range filters |
|
|
40
|
-
| **Code Mode** | Execute multi-step operations in a secure sandbox — up to 90% token savings via `mj.*` API |
|
|
41
|
-
| **Configurable Briefing** | 14 env vars / CLI flags control `memory://briefing` content — entries, team, GitHub detail, skills awareness |
|
|
42
|
-
| **Reports & Analytics** | Standups, retrospectives, PR summaries, digests, period analyses, and milestone tracking |
|
|
43
|
-
| **Team Collaboration** | 22 tools with full parity — CRUD, vector search, relationship graphs, cross-project insights, author attribution |
|
|
44
|
-
| **Data Interoperability** | Bidirectional Markdown roundtripping, unified IO namespace, and schema-safe JSON exports with hard bounds-checked path traversal defenses |
|
|
45
|
-
| **Backup & Restore** | One-command backup/restore with automated scheduling, retention policies, and safety-net auto-backups |
|
|
46
|
-
| **Security & Transport** | OAuth 2.1 (RFC 9728/8414, JWT/JWKS, scopes), Streamable HTTP + SSE, rate limiting, CORS, SQL injection prevention, non-root Docker |
|
|
47
|
-
| **Structured Error Handling** | Every tool returns `{success, error, code, category, suggestion, recoverable}` — agents get classification, remediation hints, and recoverability signals |
|
|
48
|
-
| **Agent Collaboration** | IDE agents and Copilot share context; review findings become searchable knowledge; agents suggest reusable rules and skills ([setup](docs/copilot-setup.md)) |
|
|
49
|
-
| **Native Agent Skills** | Bundled foundational coding paradigms (`autonomous-dev`, `bun`, `gitlab`, `golang`, `mysql`, `playwright-standard`, `postgres`, `react-best-practices`, `rust`, `shadcn-ui`, `skill-builder`, `sqlite`, `typescript`, `vitest-standard`) establishing permanent AI behavior and architecture rules |
|
|
50
|
-
| **GitHub Commander** | Pipeline skills for issue triage, PR reviews, sprint milestones, and security/quality/performance audits with journal trails ([docs](skills/github-commander/SKILL.md)) |
|
|
51
|
-
|
|
52
|
-
---
|
|
53
|
-
|
|
54
|
-
## 🎯 Why Memory Journal?
|
|
27
|
+
## 🧠 Stop Experiencing AI Amnesia
|
|
55
28
|
|
|
56
29
|
When managing large projects with AI assistance, you face a critical challenge:
|
|
57
30
|
|
|
58
|
-
- **Thread Amnesia** - Each new AI conversation starts from zero, unaware of previous work
|
|
59
|
-
- **Lost Context** - Decisions, implementations, and learnings scattered across disconnected threads
|
|
60
|
-
- **Repeated Work** - AI suggests solutions you've already tried or abandoned
|
|
61
|
-
- **Context Overload** - Manually copying project history into every new conversation
|
|
31
|
+
- **Thread Amnesia** - Each new AI conversation starts from zero, unaware of previous work.
|
|
32
|
+
- **Lost Context** - Decisions, implementations, and learnings scattered across disconnected threads.
|
|
33
|
+
- **Repeated Work** - AI suggests solutions you've already tried or abandoned.
|
|
34
|
+
- **Context Overload** - Manually copying project history into every new conversation.
|
|
62
35
|
|
|
63
36
|
Memory Journal solves this by acting as your project's **long-term memory**, bridging the gap between fragmented AI sessions.
|
|
64
37
|
|
|
65
38
|
---
|
|
66
39
|
|
|
67
|
-
**
|
|
40
|
+
**Experience true context-aware development:**
|
|
68
41
|
|
|
69
|
-
- "
|
|
70
|
-
- "
|
|
71
|
-
- "
|
|
72
|
-
- "
|
|
42
|
+
- _"Why did we choose SQLite over Postgres for this service last month?"_ (Semantic search)
|
|
43
|
+
- _"Run the `/issue-triage` workflow on the top priority ticket in the Kanban board."_ (GitHub operations)
|
|
44
|
+
- _"Who has been touching the auth module recently, and what's our team collaboration density?"_ (Team analytics)
|
|
45
|
+
- _"Close issue #42 and log an entry explaining our architectural fix for the parsing bug."_ (Context lifecycles)
|
|
46
|
+
- _"Draw a visual graph showing how my last 10 architectural decisions relate to each other."_ (Knowledge graph)
|
|
73
47
|
|
|
74
48
|
**[See complete examples & prompts →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Examples)**
|
|
75
49
|
|
|
76
50
|
---
|
|
77
51
|
|
|
52
|
+
## 🎯 What Sets Us Apart
|
|
53
|
+
|
|
54
|
+
**68 MCP Tools** · **17 Workflow Prompts** · **34 Resources** · **10 Tool Groups** · **Code Mode** · **GitHub Commander** (Issue Triage, PR Review, Milestone Sprints, Security/Quality/Perf Audits) · **GitHub Integration** (Issues, PRs, Actions, Kanban, Milestones, Insights) · **Team Collaboration** (Shared DB, Vector Search, Cross-Project Insights)
|
|
55
|
+
|
|
56
|
+
| Feature | Description |
|
|
57
|
+
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
58
|
+
| **Session Intelligence** | Agents auto-query project history, create entries at checkpoints, and hand off context between sessions via `/session-summary` and `team-session-summary` |
|
|
59
|
+
| **GitHub Integration** | 18 tools for Issues, PRs, Actions, Kanban, Milestones (%), Copilot Reviews, and 14-day Insights |
|
|
60
|
+
| **Dynamic Project Routing** | Seamlessly switch contexts and access CI/Issue tracking across multiple repositories using a single server instance via `PROJECT_REGISTRY` |
|
|
61
|
+
| **Knowledge Graphs** | 8 relationship types linking specs → implementations → tests → PRs with Mermaid visualization |
|
|
62
|
+
| **Hybrid Search** | Reciprocal Rank Fusion combining FTS5 keywords, semantic vector similarity, auto-heuristics, and date-range filters |
|
|
63
|
+
| **Code Mode** | Execute multi-step operations in a secure sandbox — up to 90% token savings via `mj.*` API |
|
|
64
|
+
| **Configurable Briefing** | 14 env vars / CLI flags control `memory://briefing` content — entries, team, GitHub detail, skills awareness |
|
|
65
|
+
| **Reports & Analytics** | Standups, retrospectives, PR summaries, digests, period analyses, and milestone tracking |
|
|
66
|
+
| **Team Collaboration** | 23 tools with full parity — CRUD, vector search, relationship graphs, cross-project insights, author attribution |
|
|
67
|
+
| **Data Interoperability** | Bidirectional Markdown roundtripping, unified IO namespace, and schema-safe JSON exports with hard bounds-checked path traversal defenses |
|
|
68
|
+
| **Backup & Restore** | One-command backup/restore with automated scheduling, retention policies, and safety-net auto-backups |
|
|
69
|
+
| **Security & Transport** | OAuth 2.1 (RFC 9728/8414, JWT/JWKS, scopes), Streamable HTTP + SSE, rate limiting, CORS, SQL injection prevention, non-root Docker |
|
|
70
|
+
| **Structured Error Handling** | Every tool returns `{success, error, code, category, suggestion, recoverable}` — agents get classification, remediation hints, and recoverability signals |
|
|
71
|
+
| **Agent Collaboration** | IDE agents and Copilot share context; review findings become searchable knowledge; agents suggest reusable rules and skills ([setup](docs/copilot-setup.md)) |
|
|
72
|
+
| **Native Agent Skills** | Bundled foundational coding paradigms (`autonomous-dev`, `python`, `docker`, `tailwind-css`, `golang`, `playwright-standard`, etc.) establishing permanent AI behavior and architecture rules |
|
|
73
|
+
| **GitHub Commander** | Pipeline skills for issue triage, PR reviews, sprint milestones, and security/quality/performance audits with journal trails ([docs](skills/github-commander/SKILL.md)) |
|
|
74
|
+
|
|
75
|
+
---
|
|
76
|
+
|
|
78
77
|
```mermaid
|
|
79
78
|
flowchart TB
|
|
80
79
|
subgraph Session["🤖 AI Session Start"]
|
|
@@ -117,9 +116,12 @@ flowchart TB
|
|
|
117
116
|
|
|
118
117
|
---
|
|
119
118
|
|
|
120
|
-
|
|
119
|
+
<details>
|
|
120
|
+
<summary><strong>🤖 Click to view the recommended AI Agent Instructions/Rule</strong></summary>
|
|
121
121
|
|
|
122
|
-
|
|
122
|
+
_Suggested Rule (Add to AGENTS.md, GEMINI.md, system prompts, etc.)_
|
|
123
|
+
|
|
124
|
+
**🛑 MANDATORY SESSION START ROUTINE**
|
|
123
125
|
|
|
124
126
|
Execute BEFORE fulfilling any user request in a new session:
|
|
125
127
|
|
|
@@ -132,9 +134,11 @@ Execute BEFORE fulfilling any user request in a new session:
|
|
|
132
134
|
- **REQUIRED GROUPS**:
|
|
133
135
|
- **GitHub**: Combine Repo, Branch, CI, PRs, and Insights.
|
|
134
136
|
- **GitHub Issues**: List every issue, one per line.
|
|
135
|
-
- Also include Entry Counts (Journal/Team), Latest Entries/Summaries, Milestones, and Workspaces.
|
|
137
|
+
- Also include Entry Counts (Journal/Team), Latest Entries/Summaries, Proactive Analytics/Team Density, Milestones, and Workspaces.
|
|
136
138
|
4. **STOP & WAIT**: After rendering the table, execute the user's prompt but do NOT autonomously resume past tasks or start work on new issues mentioned in the session summary. The briefing is strictly for context.
|
|
137
139
|
|
|
140
|
+
</details>
|
|
141
|
+
|
|
138
142
|
---
|
|
139
143
|
|
|
140
144
|
### Tool Filtering
|
|
@@ -146,12 +150,12 @@ Control which tools are exposed via `MEMORY_JOURNAL_MCP_TOOL_FILTER` (or CLI: `-
|
|
|
146
150
|
|
|
147
151
|
| Filter | Tools | Use Case |
|
|
148
152
|
| -------------------- | ----- | ------------------------ |
|
|
149
|
-
| `full` |
|
|
153
|
+
| `full` | 68 | All tools (default) |
|
|
150
154
|
| `starter` | ~11 | Core + search + codemode |
|
|
151
155
|
| `essential` | ~7 | Minimal footprint |
|
|
152
|
-
| `readonly` |
|
|
153
|
-
| `-github` |
|
|
154
|
-
| `-github,-analytics` |
|
|
156
|
+
| `readonly` | 18 | Disable all mutations |
|
|
157
|
+
| `-github` | 50 | Exclude a group |
|
|
158
|
+
| `-github,-analytics` | 48 | Exclude multiple groups |
|
|
155
159
|
|
|
156
160
|
**Filter Syntax:** `shortcut` or `group` or `tool_name` (whitelist mode) · `-group` (disable group) · `-tool` (disable tool) · `+tool` (re-enable after group disable)
|
|
157
161
|
|
|
@@ -165,20 +169,20 @@ Control which tools are exposed via `MEMORY_JOURNAL_MCP_TOOL_FILTER` (or CLI: `-
|
|
|
165
169
|
|
|
166
170
|
## 📋 Core Capabilities
|
|
167
171
|
|
|
168
|
-
### 🛠️ **
|
|
169
|
-
|
|
170
|
-
| Group | Tools | Description
|
|
171
|
-
| --------------- | ----- |
|
|
172
|
-
| `codemode` | 1 | Code Mode (sandboxed code execution) 🌟 **Recommended**
|
|
173
|
-
| `core` | 6 | Entry CRUD, tags, test
|
|
174
|
-
| `search` | 4 | Text search, date range, semantic, vector stats
|
|
175
|
-
| `analytics` | 2 | Statistics, cross-project insights
|
|
176
|
-
| `relationships` | 2 | Link entries, visualize graphs
|
|
177
|
-
| `io` | 3 | JSON/Markdown export and File-level Markdown Data Integration Interoperability (Import/Export)
|
|
178
|
-
| `admin` | 5 | Update, delete, rebuild/add to vector index, merge tags
|
|
179
|
-
| `github` | 18 | Issues, PRs, context, Kanban, **Milestones**, **Insights**, **issue lifecycle**, **Copilot Reviews**
|
|
180
|
-
| `backup` | 4 | Backup, list, restore, cleanup
|
|
181
|
-
| `team` |
|
|
172
|
+
### 🛠️ **68 MCP Tools** (10 Groups)
|
|
173
|
+
|
|
174
|
+
| Group | Tools | Description |
|
|
175
|
+
| --------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
176
|
+
| `codemode` | 1 | Code Mode (sandboxed code execution) 🌟 **Recommended** |
|
|
177
|
+
| `core` | 6 | Entry CRUD, tags, test |
|
|
178
|
+
| `search` | 4 | Text search, date range, semantic, vector stats |
|
|
179
|
+
| `analytics` | 2 | Statistics, cross-project insights |
|
|
180
|
+
| `relationships` | 2 | Link entries, visualize graphs |
|
|
181
|
+
| `io` | 3 | JSON/Markdown export and File-level Markdown Data Integration Interoperability (Import/Export) |
|
|
182
|
+
| `admin` | 5 | Update, delete, rebuild/add to vector index, merge tags |
|
|
183
|
+
| `github` | 18 | Issues, PRs, context, Kanban, **Milestones**, **Insights**, **issue lifecycle**, **Copilot Reviews** |
|
|
184
|
+
| `backup` | 4 | Backup, list, restore, cleanup |
|
|
185
|
+
| `team` | 23 | CRUD, search, stats, relationships, IO (Markdown import/export), backup, vector search, cross-project insights, matrix (requires `TEAM_DB_PATH`) |
|
|
182
186
|
|
|
183
187
|
**[Complete tools reference →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Tools)**
|
|
184
188
|
|
|
@@ -201,6 +205,7 @@ Control which tools are exposed via `MEMORY_JOURNAL_MCP_TOOL_FILTER` (or CLI: `-
|
|
|
201
205
|
- `confirm-briefing` - Acknowledge session context to user
|
|
202
206
|
- `session-summary` - Create a session summary entry with accomplishments, pending items, and next-session context
|
|
203
207
|
- `team-session-summary` - Create a retrospective team session summary entry securely isolated to the team database
|
|
208
|
+
- `load-project-kanban` - Dynamic project board injection
|
|
204
209
|
|
|
205
210
|
**[Complete prompts guide →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Prompts)**
|
|
206
211
|
|
|
@@ -246,13 +251,13 @@ Control which tools are exposed via `MEMORY_JOURNAL_MCP_TOOL_FILTER` (or CLI: `-
|
|
|
246
251
|
- `memory://help/{group}` - Per-group tool reference with parameters and annotations
|
|
247
252
|
- `memory://briefing/{repo}` - Context targeted to a specific repository
|
|
248
253
|
|
|
249
|
-
|
|
254
|
+
_Note: The `memory://github/status`, `memory://github/insights`, `memory://github/milestones`, and `memory://milestones/{number}` resources also accept an optional `/{repo}` path suffix for cross-repo targeting._
|
|
250
255
|
|
|
251
256
|
---
|
|
252
257
|
|
|
253
|
-
## Code Mode: Maximum Efficiency
|
|
258
|
+
## ⚡ Code Mode: Maximum Efficiency (90% Token Savings)
|
|
254
259
|
|
|
255
|
-
Code Mode (`mj_execute_code`) dramatically reduces token usage
|
|
260
|
+
Code Mode (`mj_execute_code`) is a revolutionary approach that **dramatically reduces token usage by up to 90%** and is included by default in all presets. Instead of spending thousands of tokens on sequential tool calls, AI agents use a single sandboxed execution to reason faster.
|
|
256
261
|
|
|
257
262
|
Code executes in a **sandboxed VM context** with multiple layers of security. All `mj.*` API calls execute against the journal within the sandbox, providing:
|
|
258
263
|
|
|
@@ -385,10 +390,10 @@ For remote access or web-based clients, run the server in HTTP mode:
|
|
|
385
390
|
memory-journal-mcp --transport http --port 3000
|
|
386
391
|
```
|
|
387
392
|
|
|
388
|
-
To bind to all interfaces (required for containers):
|
|
393
|
+
To bind to all interfaces (required for containers) and enable the automated proactive analytics scheduler (e.g. daily digest):
|
|
389
394
|
|
|
390
395
|
```bash
|
|
391
|
-
memory-journal-mcp --transport http --port 3000 --server-host 0.0.0.0
|
|
396
|
+
memory-journal-mcp --transport http --port 3000 --server-host 0.0.0.0 --digest-interval 1440
|
|
392
397
|
```
|
|
393
398
|
|
|
394
399
|
**Endpoints:**
|