memory-journal-mcp 8.0.1 → 9.1.0

package/package.json

@@ -1,107 +1,131 @@
 {
-    "name": "memory-journal-mcp",
-    "version": "8.0.1",
-    "description": "Project context management for AI-assisted development - Persistent knowledge graphs and intelligent context recall across fragmented AI threads",
-    "type": "module",
-    "main": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "bin": {
-        "memory-journal-mcp": "dist/cli.js"
-    },
-    "files": [
-        "dist/",
-        "skills/",
-        "LICENSE",
-        "README.md"
-    ],
-    "scripts": {
-        "build": "tsup",
-        "dev": "tsc --watch",
-        "lint": "eslint src/ tests/",
-        "lint:fix": "eslint src/ tests/ --fix",
-        "typecheck": "tsc --noEmit",
-        "check": "tsx scripts/run-checks.ts",
-        "test": "vitest run",
-        "test:watch": "vitest",
-        "test:coverage": "vitest run --coverage && npx tsx scripts/update-badges.ts",
-        "bench": "vitest bench --run",
-        "pretest:e2e": "node -e \"fs.rmSync('.test-output/e2e', { recursive: true, force: true })\"",
-        "test:e2e": "playwright test",
-        "test:scheduler": "node test-server/scripts/test-scheduler.mjs",
-        "generate:instructions": "node scripts/generate-server-instructions.ts",
-        "backfill:metadata": "tsx scripts/backfill-metadata.ts",
-        "prepublishOnly": "npm run check && npm run test && npm run build"
-    },
-    "keywords": [
-        "mcp",
-        "context-management",
-        "project-management",
-        "ai-assistant",
-        "knowledge-graph",
-        "developer-tools",
-        "git",
-        "github-projects",
-        "model-context-protocol",
-        "persistent-memory",
-        "thread-continuity",
-        "semantic-search",
-        "sqlite",
-        "typescript"
-    ],
-    "author": "Adamic.tech",
-    "license": "MIT",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/neverinfamous/memory-journal-mcp.git"
-    },
-    "bugs": {
-        "url": "https://github.com/neverinfamous/memory-journal-mcp/issues"
-    },
-    "homepage": "https://github.com/neverinfamous/memory-journal-mcp#readme",
-    "engines": {
-        "node": ">=24.0.0"
-    },
-    "dependencies": {
-        "@huggingface/transformers": "^4.0.1",
-        "@modelcontextprotocol/sdk": "^1.27.1",
-        "@octokit/graphql": "^9.0.3",
-        "@octokit/rest": "^22.0.1",
-        "better-sqlite3": "^12.8.0",
-        "commander": "^15.0.0",
-        "express": "^5.2.1",
-        "jose": "^6.2.1",
-        "simple-git": "^3.35.2",
-        "sqlite-vec": "^0.1.7-alpha.2",
-        "zod": "^4.3.6"
-    },
-    "devDependencies": {
-        "@eslint/js": "^10.0.1",
-        "@playwright/test": "^1.59.1",
-        "@types/better-sqlite3": "^7.6.13",
-        "@types/express": "^5.0.6",
-        "@types/node": "^25.6.0",
-        "@vitest/coverage-v8": "^4.1.3",
-        "esbuild": "^0.28.0",
-        "eslint": "^10.2.0",
-        "globals": "^17.4.0",
-        "tsup": "^8.5.1",
-        "tsx": "4.22.4",
-        "typescript": "^6.0.2",
-        "typescript-eslint": "^8.58.1",
-        "vitest": "^4.1.3"
-    },
-    "overrides": {
-        "axios": "^1.13.6",
-        "brace-expansion": "^2.0.2",
-        "diff": "9.0.0",
-        "glob": "^11.1.0",
-        "onnxruntime-web": "npm:empty-npm-package@1.0.0",
-        "sharp": "npm:empty-npm-package@1.0.0",
-        "zod": "$zod",
-        "minimatch": "10.2.5",
-        "tar": "7.5.13",
-        "tmp": "^0.2.5",
-        "vite": "^8.0.5",
-        "ip-address": "10.2.0"
-    }
-}
+  "name": "memory-journal-mcp",
+  "version": "9.1.0",
+  "description": "Persistent knowledge graphs and intelligent context recall across fragmented AI threads.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "memory-journal-mcp": "./dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "skills/",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "context-management",
+    "project-management",
+    "ai-assistant",
+    "knowledge-graph",
+    "developer-tools",
+    "git",
+    "github-projects",
+    "model-context-protocol",
+    "persistent-memory",
+    "thread-continuity",
+    "semantic-search",
+    "sqlite",
+    "typescript"
+  ],
+  "author": "Adamic.tech",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/neverinfamous/memory-journal-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/neverinfamous/memory-journal-mcp/issues"
+  },
+  "homepage": "https://github.com/neverinfamous/memory-journal-mcp#readme",
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.8.1",
+    "@huggingface/transformers": "^4.3.2",
+    "@modelcontextprotocol/express": "^2.0.2",
+    "@modelcontextprotocol/node": "^2.1.2",
+    "@modelcontextprotocol/server": "^2.4.0",
+    "@octokit/graphql": "^9.0.5",
+    "@octokit/rest": "^22.0.1",
+    "better-sqlite3": "npm:better-sqlite3-multiple-ciphers@^13.0.3",
+    "commander": "^15.0.0",
+    "express": "^5.3.0",
+    "jose": "^6.2.14",
+    "simple-git": "^4.0.2",
+    "sqlite-vec": "^0.1.9",
+    "ts-pattern": "^5.9.2",
+    "yaml": "^2.9.1",
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@modelcontextprotocol/client": "^2.4.0",
+    "@playwright/test": "^1.64.1",
+    "@types/better-sqlite3": "^9.6.0",
+    "@types/express": "^5.0.6",
+    "@types/node": "^26.6.6",
+    "@vitest/coverage-v8": "^5.0.5",
+    "dotenv": "^18.0.9",
+    "esbuild": "0.28.2",
+    "eslint": "^10.14.0",
+    "globals": "^17.14.0",
+    "picocolors": "^1.1.1",
+    "tsup": "^9.0.0",
+    "tsx": "4.23.15",
+    "typescript": "~6.0.3",
+    "typescript-eslint": "^8.72.1",
+    "vitest": "^5.0.5"
+  },
+  "overrides": {
+    "adm-zip": "^0.6.0",
+    "@hono/node-server": "^2.0.5",
+    "axios": "^1.13.6",
+    "diff": "9.0.0",
+    "glob": "^11.1.0",
+    "onnxruntime-web": "npm:empty-npm-package@1.0.0",
+    "sharp": "^0.35.0",
+    "zod": "^4.6.7",
+    "tmp": "^0.2.5",
+    "vite": "8.1.6",
+    "ip-address": "10.3.1",
+    "minimatch": ">=11.0.1",
+    "esbuild": "0.28.2"
+  },
+  "scripts": {
+    "build": "pnpm run build:js && pnpm run build:types",
+    "build:js": "tsup",
+    "build:types": "tsc --project tsconfig.build.json --emitDeclarationOnly",
+    "cli": "tsx src/cli/index.ts",
+    "dev": "tsc --watch",
+    "lint": "tsx scripts/run-checks.ts lint",
+    "lint:fix": "eslint src/ tests/ --fix && tsx scripts/run-checks.ts lint",
+    "typecheck": "tsx scripts/run-checks.ts typecheck",
+    "generate:code-map": "tsx scripts/update-code-map.ts",
+    "generate:instructions": "tsx scripts/generate-instructions.ts",
+    "check:unassigned": "tsx scripts/check-unassigned-entries.ts",
+    "check": "tsx scripts/run-checks.ts && pnpm run test && pnpm run test:e2e",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage && tsx scripts/update-badges.ts",
+    "test:vendor": "vitest run src/vendor/",
+    "sync:vendor": "bun scripts/sync-vendor.ts",
+    "check:vendor-deps": "bun scripts/sync-vendor.ts --check",
+    "bench": "vitest bench --run",
+    "infra:up": "docker compose -f test-server/infrastructure/docker-compose.yml up -d",
+    "infra:down": "docker compose -f test-server/infrastructure/docker-compose.yml down",
+    "infra:reset": "docker compose -f test-server/infrastructure/docker-compose.yml down -v && docker compose -f test-server/infrastructure/docker-compose.yml up -d",
+    "infra:logs": "docker compose -f test-server/infrastructure/docker-compose.yml logs -f",
+    "infra:status": "node test-server/infrastructure/scripts/check-status.mjs",
+    "pretest:e2e": "node -e \"fs.rmSync('.test-output/e2e', { recursive: true, force: true, maxRetries: 5, retryDelay: 200 })\"",
+    "test:e2e": "playwright test && tsx scripts/update-badges.ts",
+    "test:wsl": "wsl bash -c \"pnpm run test\"",
+    "test:e2e:wsl": "wsl bash -c \"pnpm run test:e2e\"",
+    "test:scheduler": "node test-server/scripts/test-scheduler.mjs",
+    "test:prompts": "node test-server/scripts/test-prompts.mjs",
+    "encrypt-db": "tsx scripts/encrypt-db.ts"
+  }
+}

package/skills/memory-journal-mcp/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: memory-journal-mcp
+version: 1.1.0
+tags:
+  - "agent-skill"
+description: Core guidelines and instruction pointers for the Memory Journal MCP. Use when interacting with the memory journal (creating, reading, searching entries), orchestrating commits, or writing session summaries.
+---
+# Memory Journal MCP Guidelines
+
+This skill acts as a static anchor to reinforce core usage patterns, commit workflows, and anti-hallucination guardrails for the Memory Journal MCP.
+
+## 1. Accessing Detailed Server Instructions
+The Memory Journal MCP provides comprehensive, dynamic instructions via its `memory://help` resources:
+- Use `read_resource` on `memory://help` for the tool group index and `memory://help/gotchas` for critical gotchas and core usage patterns.
+- Use `read_resource` on `memory://help/{group}` for specific tool groups (`core`, `search`, `analytics`, `relationships`, `io`, `admin`, `github`, `git`, `backup`, `team`, `codemode`, `templates`, `gotchas`).
+
+## 2. Core Agent Directives
+- **Session Briefing:** Read the workspace briefing via `memory://briefing/{+repo}` (or fallback to `memory://briefing`) at session start. DO NOT autonomously execute tasks listed in the briefing.
+- **Context Integrity & Metadata:** Always include mandatory context fields when creating entries:
+  - `workspace_id`: Repository name (e.g. `adamic`, `memory-journal-mcp`). Required string (auto-resolves from `project_number` / `PROJECT_REGISTRY` if omitted).
+  - `session_id`: Current AI conversation ID.
+  - `project_number`: Numeric project ID (strictly required by MCP `create_entry`/`team_create_entry` and CLI `entry create -p <number>` [`--project <number>`] if not auto-resolvable from `workspace_id`, content/tag keyword matching, CWD in `PROJECT_REGISTRY` / `projectRegistry`, or `DEFAULT_PROJECT_NUMBER` / `--default-project`).
+  - `impact_score` / `trust_score`: Blast radius and confidence heuristics (0.0 to 1.0).
+  - `validation_status`: `'passed'`, `'none'`, or `'failed'`.
+- **Context Recovery:** If you lose workspace context mid-task (e.g., needing a `project_number`), NEVER re-query `memory://briefing`. Query `memory://agent-context/{+repo}` (or `memory://agent-id/{+repo}`; bare `memory://agent-context` and `memory://agent-id` fall back to server CWD).
+
+## 3. Commit Integration & Entry Creation
+- **Commit Journaling:** When recording commit history in the journal, create an entry (via `mj_execute_code`, `create_entry`, or `memory-journal-mcp entry create`) tagged `commit-narrative` containing `auto_context` with `commits: ["<sha>"]` and heuristic metadata (`impact_score`, `trust_score`, `validation_status`).
+- **Commit Narrative Guardrails:** Any entry tagged `"commit-narrative"` MUST include `auto_context` containing a non-empty `commits` array (e.g., `{ "commits": ["<sha>"] }`).
+
+## 4. Session Summary Guardrails
+- **Required Structure:** Entries tagged `"session-summary"` (which use `entry_type: "retrospective"`) MUST contain **EXACTLY** these 4 top-level section headers:
+  - `## Accomplished`
+  - `## Unfinished / Blocked`
+  - `## Context for Next Session`
+  - `## Commits`
+- **Strict Validation:** DO NOT invent extra top-level section headers or duplicate headers. If `auto_context` is provided, it must contain a non-empty `commits` array.
+
+## 5. Tool Execution & Lifecycle Rules
+- **Token Efficiency:** Prioritize MCP Code Mode (`mj_execute_code`) or native MCP tools for token-efficient entry logging, searches, and aggregations.
+- **Runtime Configuration:** Use `update_configuration` to hot-reload tool filters (`tool_filter`) and briefing settings at runtime—the server automatically emits `notifications/tools/list_changed` without requiring a restart.