memory-journal-mcp 6.1.2 → 6.2.1

package/src/codemode/worker-script.ts

@@ -1,239 +0,0 @@
-/**
- * memory-journal-mcp - Worker Script (Worker Thread Entry Point)
- *
- * Runs inside `node:worker_threads`. Receives serialized API bindings,
- * builds an async Proxy API object (`mj.*`), and executes user code
- * within a secondary `vm.createContext` boundary.
- */
-
-import { parentPort, workerData } from 'node:worker_threads'
-import * as vm from 'node:vm'
-import type { MessagePort } from 'node:worker_threads'
-import type { RpcRequest, RpcResponse, SandboxResult, ExecutionMetrics } from './types.js'
-import { transformAutoReturn } from './auto-return.js'
-
-// =============================================================================
-// Worker Data
-// =============================================================================
-
-interface WorkerInit {
-    code: string
-    methodList: Record<string, string[]>
-    timeoutMs: number
-    rpcPort: MessagePort
-}
-
-const { code, methodList, timeoutMs, rpcPort: workerRpcPort } = workerData as WorkerInit
-
-// =============================================================================
-// RPC Client (Worker Side)
-// =============================================================================
-
-let rpcPort: MessagePort | null = null
-let rpcIdCounter = 0
-const pendingRpcRequests = new Map<
-    number,
-    { resolve: (value: unknown) => void; reject: (reason: Error) => void }
->()
-
-/**
- * Send an RPC request to the main thread and await the response.
- */
-function rpcCall(group: string, method: string, args: unknown[]): Promise<unknown> {
-    return new Promise((resolve, reject) => {
-        if (!rpcPort) {
-            reject(new Error('RPC port not initialized'))
-            return
-        }
-
-        const id = ++rpcIdCounter
-        pendingRpcRequests.set(id, { resolve, reject })
-
-        const request: RpcRequest = { id, group, method, args }
-        rpcPort.postMessage(request)
-    })
-}
-
-// =============================================================================
-// API Proxy Builder
-// =============================================================================
-
-/**
- * Build the `mj` API proxy object from the method list.
- * Each group becomes a namespace with async methods that call
- * back to the main thread via RPC.
- */
-function buildApiProxy(methods: Record<string, string[]>): Record<string, unknown> {
-    const api: Record<string, unknown> = {}
-
-    for (const [group, methodNames] of Object.entries(methods)) {
-        // _topLevel methods go directly on the api object (mj.createEntry, etc.)
-        if (group === '_topLevel') {
-            for (const methodName of methodNames) {
-                api[methodName] = (...args: unknown[]) => rpcCall('_topLevel', methodName, args)
-            }
-            continue
-        }
-
-        const groupProxy: Record<string, (...args: unknown[]) => Promise<unknown>> = {}
-
-        for (const methodName of methodNames) {
-            groupProxy[methodName] = (...args: unknown[]) => rpcCall(group, methodName, args)
-        }
-
-        // Per-group help()
-        groupProxy['help'] = () =>
-            Promise.resolve({
-                group,
-                methods: methodNames,
-            })
-
-        // Wrap in a Proxy so that calling an undefined method (e.g. a mutation
-        // that was stripped in readonly mode) throws a rejected Promise instead of
-        // silently returning { success: false } — this halts control flow in the
-        // sandbox and surfaces a proper error to the caller.
-        const groupProxyWrapped = new Proxy(groupProxy, {
-            get(target, prop) {
-                // Symbols (Symbol.toPrimitive, Symbol.iterator, etc.) — pass through
-                if (typeof prop === 'symbol') return undefined
-                const key = prop
-                if (key in target) return target[key]
-                // `then` must return undefined so the Proxy is never treated as a
-                // thenable. Without this, `return mj.core` would trigger Promise
-                // resolution → `.then()` → immediate reject with a misleading error.
-                if (key === 'then') return undefined
-                // Unknown/stripped method — reject so the sandbox try/catch catches it
-                const available = methodNames.join(', ') || 'none'
-                const reason =
-                    methodNames.length === 0
-                        ? `Operation '${key}' is not available — this group has no methods (read-only mode?). Available: ${available}.`
-                        : `Operation '${key}' is not found in group. Available: ${available}.`
-                return (..._args: unknown[]) => Promise.reject(new Error(reason))
-            },
-        })
-
-        api[group] = groupProxyWrapped
-    }
-
-    // Top-level help()
-    api['help'] = () => {
-        const groups = Object.keys(methods).filter((g) => g !== '_topLevel')
-        let totalMethods = 0
-        for (const group of groups) {
-            totalMethods += methods[group]?.length ?? 0
-        }
-        return Promise.resolve({
-            groups,
-            totalMethods,
-            usage: 'Use mj.<group>.help() for group details. Example: mj.core.help()',
-        })
-    }
-
-    return api
-}
-
-// =============================================================================
-// Execution
-// =============================================================================
-
-async function executeCode(): Promise<SandboxResult> {
-    const startCpu = process.cpuUsage()
-    const startTime = performance.now()
-
-    try {
-        const mjApi = buildApiProxy(methodList)
-
-        // Build sandbox context with nulled dangerous globals
-        // Built-ins (JSON, Math, Promise, etc.) inherit from the worker's global scope
-        const sandbox: Record<string, unknown> = {
-            mj: mjApi,
-            console: {
-                log: (...args: unknown[]) => args,
-                warn: (...args: unknown[]) => args,
-                error: (...args: unknown[]) => args,
-                info: (...args: unknown[]) => args,
-                debug: (...args: unknown[]) => args,
-            },
-            // Nulled globals
-            setTimeout: undefined,
-            setInterval: undefined,
-            setImmediate: undefined,
-            process: undefined,
-            require: undefined,
-            __dirname: undefined,
-            __filename: undefined,
-            global: undefined,
-            globalThis: undefined,
-        }
-
-        const context = vm.createContext(sandbox, {
-            name: 'codemode-worker-sandbox',
-        })
-
-        const wrappedCode = `(async () => { ${transformAutoReturn(code)} })()`
-        const script = new vm.Script(wrappedCode, {
-            filename: 'codemode-execution.js',
-        })
-
-        const resultPromise = script.runInContext(context, {
-            timeout: timeoutMs,
-        }) as Promise<unknown>
-
-        const result = await resultPromise
-
-        const endTime = performance.now()
-        const endCpu = process.cpuUsage(startCpu)
-        const metrics: ExecutionMetrics = {
-            wallTimeMs: Math.round(endTime - startTime),
-            cpuTimeMs: Math.round((endCpu.user + endCpu.system) / 1000),
-            memoryUsedMb: 0, // Measured on host side via RSS delta
-        }
-
-        return { success: true, result, metrics }
-    } catch (err) {
-        const endTime = performance.now()
-        const endCpu = process.cpuUsage(startCpu)
-        const error = err instanceof Error ? err : new Error(String(err))
-        const metrics: ExecutionMetrics = {
-            wallTimeMs: Math.round(endTime - startTime),
-            cpuTimeMs: Math.round((endCpu.user + endCpu.system) / 1000),
-            memoryUsedMb: 0,
-        }
-
-        return {
-            success: false,
-            error: error.message,
-            stack: error.stack,
-            metrics,
-        }
-    }
-}
-
-// =============================================================================
-// Startup — Port from workerData, execute immediately
-// =============================================================================
-
-// Initialize RPC port from workerData (transferred via constructor)
-rpcPort = workerRpcPort
-rpcPort.ref() // Keep event loop alive while RPC is active
-
-// Listen for RPC responses from the main thread
-rpcPort.on('message', (response: RpcResponse) => {
-    const pending = pendingRpcRequests.get(response.id)
-    if (pending) {
-        pendingRpcRequests.delete(response.id)
-        if (response.error) {
-            pending.reject(new Error(response.error))
-        } else {
-            pending.resolve(response.result)
-        }
-    }
-})
-
-// Execute code and send result back to the host via parentPort
-void executeCode().then((result) => {
-    // Close the RPC port before sending result (allows worker to exit)
-    rpcPort?.unref()
-    rpcPort?.close()
-    parentPort?.postMessage(result)
-})

package/src/constants/icons.ts

@@ -1,183 +0,0 @@
-/**
- * Memory Journal MCP Server - Icon Constants
- *
- * Centralized icon definitions using data URIs for self-contained distribution.
- * Icons follow MCP 2025-11-25 specification.
- *
- * Using simple Lucide-style SVG icons encoded as data URIs.
- */
-
-import type { McpIcon } from '../types/index.js'
-
-// ============================================================================
-// Tool Group Icons
-// ============================================================================
-
-/** Journal/notebook icon for core operations */
-export const ICON_CORE: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Cpath d="M4 19.5A2.5 2.5 0 016.5 17H20"/%3E%3Cpath d="M6.5 2H20v20H6.5A2.5 2.5 0 014 19.5v-15A2.5 2.5 0 016.5 2z"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-/** Magnifying glass for search operations */
-export const ICON_SEARCH: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Ccircle cx="11" cy="11" r="8"/%3E%3Cline x1="21" y1="21" x2="16.65" y2="16.65"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-/** Chart/bar for analytics */
-export const ICON_ANALYTICS: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Cline x1="18" y1="20" x2="18" y2="10"/%3E%3Cline x1="12" y1="20" x2="12" y2="4"/%3E%3Cline x1="6" y1="20" x2="6" y2="14"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-/** Link for relationships */
-export const ICON_RELATIONSHIPS: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Cpath d="M10 13a5 5 0 007.54.54l3-3a5 5 0 00-7.07-7.07l-1.72 1.71"/%3E%3Cpath d="M14 11a5 5 0 00-7.54-.54l-3 3a5 5 0 007.07 7.07l1.71-1.71"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-/** Download/export icon */
-export const ICON_EXPORT: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Cpath d="M21 15v4a2 2 0 01-2 2H5a2 2 0 01-2-2v-4"/%3E%3Cpolyline points="7 10 12 15 17 10"/%3E%3Cline x1="12" y1="15" x2="12" y2="3"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-/** Settings/cog for admin */
-export const ICON_ADMIN: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Ccircle cx="12" cy="12" r="3"/%3E%3Cpath d="M19.4 15a1.65 1.65 0 00.33 1.82l.06.06a2 2 0 010 2.83 2 2 0 01-2.83 0l-.06-.06a1.65 1.65 0 00-1.82-.33 1.65 1.65 0 00-1 1.51V21a2 2 0 01-2 2 2 2 0 01-2-2v-.09A1.65 1.65 0 009 19.4a1.65 1.65 0 00-1.82.33l-.06.06a2 2 0 01-2.83 0 2 2 0 010-2.83l.06-.06a1.65 1.65 0 00.33-1.82 1.65 1.65 0 00-1.51-1H3a2 2 0 01-2-2 2 2 0 012-2h.09A1.65 1.65 0 004.6 9a1.65 1.65 0 00-.33-1.82l-.06-.06a2 2 0 010-2.83 2 2 0 012.83 0l.06.06a1.65 1.65 0 001.82.33H9a1.65 1.65 0 001-1.51V3a2 2 0 012-2 2 2 0 012 2v.09a1.65 1.65 0 001 1.51 1.65 1.65 0 001.82-.33l.06-.06a2 2 0 012.83 0 2 2 0 010 2.83l-.06.06a1.65 1.65 0 00-.33 1.82V9a1.65 1.65 0 001.51 1H21a2 2 0 012 2 2 2 0 01-2 2h-.09a1.65 1.65 0 00-1.51 1z"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-/** GitHub logo for github tools */
-export const ICON_GITHUB: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor"%3E%3Cpath d="M12 0C5.374 0 0 5.373 0 12c0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23A11.509 11.509 0 0112 5.803c1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576C20.566 21.797 24 17.3 24 12c0-6.627-5.373-12-12-12z"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-/** Archive/box for backup */
-export const ICON_BACKUP: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Cpolyline points="21 8 21 21 3 21 3 8"/%3E%3Crect x="1" y="3" width="22" height="5"/%3E%3Cline x1="10" y1="12" x2="14" y2="12"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-/** Users group for team collaboration */
-export const ICON_TEAM: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Cpath d="M17 21v-2a4 4 0 00-4-4H5a4 4 0 00-4 4v2"/%3E%3Ccircle cx="9" cy="7" r="4"/%3E%3Cpath d="M23 21v-2a4 4 0 00-3-3.87"/%3E%3Cpath d="M16 3.13a4 4 0 010 7.75"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-// ============================================================================
-// Resource Icons
-// ============================================================================
-
-/** Document for briefing/instructions */
-export const ICON_BRIEFING: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Cpath d="M14 2H6a2 2 0 00-2 2v16a2 2 0 002 2h12a2 2 0 002-2V8z"/%3E%3Cpolyline points="14 2 14 8 20 8"/%3E%3Cline x1="16" y1="13" x2="8" y2="13"/%3E%3Cline x1="16" y1="17" x2="8" y2="17"/%3E%3Cpolyline points="10 9 9 9 8 9"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-/** Network/share for graph resources */
-export const ICON_GRAPH: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Ccircle cx="18" cy="5" r="3"/%3E%3Ccircle cx="6" cy="12" r="3"/%3E%3Ccircle cx="18" cy="19" r="3"/%3E%3Cline x1="8.59" y1="13.51" x2="15.42" y2="17.49"/%3E%3Cline x1="15.41" y1="6.51" x2="8.59" y2="10.49"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-/** Clock for recent/timeline resources */
-export const ICON_CLOCK: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Ccircle cx="12" cy="12" r="10"/%3E%3Cpolyline points="12 6 12 12 16 14"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-/** Heartbeat for health status */
-export const ICON_HEALTH: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Cpath d="M22 12h-4l-3 9L9 3l-3 9H2"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-/** Kanban board columns */
-export const ICON_KANBAN: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Crect x="3" y="3" width="18" height="18" rx="2" ry="2"/%3E%3Cline x1="9" y1="3" x2="9" y2="21"/%3E%3Cline x1="15" y1="3" x2="15" y2="21"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-/** Star for significant items */
-export const ICON_STAR: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Cpolygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-/** Tag for tags resource */
-export const ICON_TAG: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Cpath d="M20.59 13.41l-7.17 7.17a2 2 0 01-2.83 0L2 12V2h10l8.59 8.59a2 2 0 010 2.82z"/%3E%3Cline x1="7" y1="7" x2="7.01" y2="7"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-/** Issue icon for GitHub issues */
-export const ICON_ISSUE: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Ccircle cx="12" cy="12" r="10"/%3E%3Cline x1="12" y1="8" x2="12" y2="12"/%3E%3Cline x1="12" y1="16" x2="12.01" y2="16"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-/** Git merge for PR resources */
-export const ICON_PR: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Ccircle cx="18" cy="18" r="3"/%3E%3Ccircle cx="6" cy="6" r="3"/%3E%3Cpath d="M6 21V9a9 9 0 009 9"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-/** Flag for milestone tracking */
-export const ICON_MILESTONE: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Cpath d="M4 15s1-1 4-1 5 2 8 2 4-1 4-1V3s-1 1-4 1-5-2-8-2-4 1-4 1z"/%3E%3Cline x1="4" y1="22" x2="4" y2="15"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-/** Message bubble for prompts */
-export const ICON_PROMPT: McpIcon = {
-    src: 'data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"%3E%3Cpath d="M21 15a2 2 0 01-2 2H7l-4 4V5a2 2 0 012-2h14a2 2 0 012 2z"/%3E%3C/svg%3E',
-    mimeType: 'image/svg+xml',
-    sizes: ['24x24'],
-}
-
-// ============================================================================
-// Tool Group Icon Mapping
-// ============================================================================
-
-/** Map tool group name to icon */
-export const TOOL_GROUP_ICONS: Record<string, McpIcon> = {
-    core: ICON_CORE,
-    search: ICON_SEARCH,
-    analytics: ICON_ANALYTICS,
-    relationships: ICON_RELATIONSHIPS,
-    export: ICON_EXPORT,
-    admin: ICON_ADMIN,
-    github: ICON_GITHUB,
-    backup: ICON_BACKUP,
-    team: ICON_TEAM,
-}
-
-/**
- * Get icons array for a tool based on its group
- */
-export function getToolIcon(group: string): McpIcon[] | undefined {
-    const icon = TOOL_GROUP_ICONS[group]
-    return icon ? [icon] : undefined
-}

package/src/constants/server-instructions.md

@@ -1,166 +0,0 @@
-<!-- SECTION:CORE -->
-
-# memory-journal-mcp
-
-## Session Start
-
-**REQUIRED**: Before processing any user request, read `memory://briefing` and **present the `userMessage` to the user as a formatted bullet list of key facts:**
-
-- Entry counts (journal + team)
-- GitHub: repo, branch, CI status, open issues/PRs
-- Milestone progress (if any)
-- Template resources count
-- Optional metadata present (rulesFile, skillsDir, workflowSummary, copilotReviews, Team DB)
-
-**Server name for resource calls**: Derive from tool prefixes — strip the tool name suffix to get the server name.
-
-- **AntiGravity**: Tools are `mcp_{name}_{tool}` → server name = `memory-journal-mcp`
-- **Cursor**: Tools are `user-{name}-{tool}` → server name = `user-memory-journal-mcp`
-- **Other clients**: Use configured name exactly. Use tool-prefix discovery if unsure.
-
-## Behaviors
-
-- **Create entries for**: implementations, decisions, bug fixes, milestones, user requests to "remember"
-- **Search before**: major decisions, referencing prior work, understanding project context
-- **Link entries**: implementation→spec, bugfix→issue, followup→prior work
-
-## Rule & Skill Suggestions
-
-When you notice the user consistently applies patterns, preferences, or workflows that could be codified:
-
-**Suggest adding a rule** when you observe:
-
-- Naming conventions, formatting preferences, or coding standards
-- Testing patterns or verification steps the user always follows
-- Project-specific commands, workflows, or deployment steps
-- Error handling patterns or logging conventions
-
-**Suggest adding a skill** when you build:
-
-- Reusable multi-step processes (e.g., deployment, release, audit workflows)
-- Project-specific templates or scaffolds
-- Complex integrations or tool chains the user may repeat
-
-**Suggest refining existing rules/skills** when you notice:
-
-- A rule conflict or ambiguity causing inconsistent behavior
-- An outdated pattern that no longer matches the codebase
-- Missing edge cases or exceptions to an existing rule
-- A skill that could be extended with new steps
-
-**How to act:**
-
-- The briefing shows **Rules** and **Skills** paths — use these to locate the files
-- **Always ask the user first** — never create or modify rules/skills silently
-- Frame suggestions as: "I noticed you always [pattern]. Would you like me to add/update a rule for this?"
-- For skills, explain the workflow it would automate and what triggers it
-
-<!-- SECTION:COPILOT -->
-
-## Copilot Review Patterns
-
-When the user has GitHub Copilot code review enabled:
-
-**Learn from reviews** — After a PR is merged or reviewed, use `get_copilot_reviews(pr_number)` to read Copilot's findings. If patterns emerge (e.g., repeated null check warnings, missing error handling), suggest adding a rule or updating existing rules. Create journal entries tagged `copilot-finding` and link to the PR via `pr_number`.
-
-**Pre-emptive checking** — Before creating or modifying code, search journal entries with tag `copilot-finding` for patterns relevant to the current work. Apply those patterns proactively to reduce review cycles.
-
-**How to act:**
-
-- The briefing shows **Rules** and **Skills** paths — use these to locate the files
-- **Always ask the user first** — never create or modify rules/skills silently
-- Frame suggestions as: "I noticed you always [pattern]. Would you like me to add/update a rule for this?"
-- For skills, explain the workflow it would automate and what triggers it
-
-<!-- SECTION:CODE_MODE -->
-
-## Code Mode (Token-Efficient Multi-Step Operations)
-
-For multi-step workflows (3+ operations), prefer `mj_execute_code` over individual tool calls.
-This executes JavaScript in a sandboxed environment with all tools available as `mj.*` API:
-
-| Group         | Namespace            | Example                                            |
-| ------------- | -------------------- | -------------------------------------------------- |
-| Core          | `mj.core.*`          | `mj.core.createEntry("Implemented feature X")`     |
-| Search        | `mj.search.*`        | `mj.search.searchEntries("performance")`           |
-| Analytics     | `mj.analytics.*`     | `mj.analytics.getStatistics()`                     |
-| Relationships | `mj.relationships.*` | `mj.relationships.linkEntries(1, 2, "implements")` |
-| Export        | `mj.export.*`        | `mj.export.exportEntries("json")`                  |
-| Admin         | `mj.admin.*`         | `mj.admin.rebuildVectorIndex()`                    |
-| GitHub        | `mj.github.*`        | `mj.github.getGithubIssues({ state: "open" })`     |
-| Backup        | `mj.backup.*`        | `mj.backup.backupJournal()`                        |
-| Team          | `mj.team.*`          | `mj.team.teamCreateEntry("Team update")`           |
-
-**Features**: Positional args (`createEntry("note")`), aliases (`mj.core.create`), `mj.help()` for discovery.
-**Readonly mode**: `readonly: true` restricts to read-only tools only. Calling a mutation method (e.g., `mj.core.create(...)`) in readonly mode throws an error that halts execution — the sandbox returns `{ success: false, error: "Operation '...' is not found in group" }`. If a group has no methods at all (fully stripped), the error says `"no methods (read-only mode?)"`.
-**Returns**: Last expression value. Errors return `{ success: false, error: "..." }`.
-
-**Important — all `mj.*` methods return Promises. Always `await` them:**
-
-```js
-// ✅ Correct
-const result = await mj.core.recent({ limit: 5 })
-return result.entries.map((e) => e.id)
-
-// ❌ Wrong — returns a Promise object, not the entries
-const result = mj.core.recent({ limit: 5 })
-
-// ✅ Discovery
-const help = await mj.help() // { groups, totalMethods, usage }
-const groupHelp = await mj.core.help() // { group, methods }
-```
-
-**`mj.core.recent()` return shape**: Returns `{ entries: JournalEntry[], count: number }` — not a plain array. Access `.entries` to iterate:
-
-```js
-const { entries, count } = await mj.core.recent({ limit: 10 })
-return entries.map((e) => ({ id: e.id, content: e.content.slice(0, 50) }))
-```
-
-<!-- SECTION:GITHUB -->
-
-## GitHub Integration
-
-- Include `issue_number`/`pr_number` in `create_entry` to auto-link
-- After closing issue/merging PR → create summary entry with learnings
-- CI failures → `actions-failure-digest` prompt or `memory://actions/recent`
-- Kanban: `get_kanban_board(project_number)` → `move_kanban_item` → document completion
-- Milestones: `get_github_milestones` → track project progress, `memory://github/milestones`
-- GitHub tools auto-detect owner/repo from git context; specify explicitly if null
-
-<!-- SECTION:HELP_POINTERS -->
-
-## Help Resources
-
-Read `memory://help` for tool group index and available help resources.
-Read `memory://help/{group}` for per-group tool reference (parameters, annotations, examples).
-Read `memory://help/gotchas` for critical field notes and usage patterns.
-Only help resources for your enabled tool groups are registered.
-
-<!-- SECTION:SERVER_ACCESS -->
-
-## How to Access This Server
-
-### Server Name Discovery
-
-The server name used for resource and tool calls depends on your MCP client:
-
-- **AntiGravity**: Prefixes tools with `mcp_` and uses underscores. If the server is named `memory-journal-mcp` in config, tools appear as `mcp_memory-journal-mcp_create_entry`. Use `memory-journal-mcp` as the server name for resource calls.
-- **Cursor**: Prepends `user-` to the configured name. If the server is named `memory-journal-mcp` in config, use `user-memory-journal-mcp` for `ListMcpResources` and `FetchMcpResource` calls.
-- **Other clients** (Claude Desktop, etc.): Likely use the configured name exactly. Only Cursor and AntiGravity have been verified — use the tool-prefix discovery method if unsure.
-
-To identify your server name: look at the tool name prefix. Strip the tool name suffix to get the server name. Examples: `mcp_memory-journal-mcp_create_entry` → `memory-journal-mcp`; `user-memory-journal-mcp-create_entry` → `user-memory-journal-mcp`.
-
-### Calling Tools
-
-Use the tool functions directly — they are already available in your context by their full prefixed name.
-
-### Reading Resources
-
-Use the resource-reading mechanism provided by your MCP client with the discovered server name and `memory://` URIs.
-
-Do NOT try to browse filesystem paths for MCP tool/resource definitions — use the MCP protocol directly.
-
-## Quick Health Check
-
-Fetch `memory://health` to verify server status, database stats, and tool availability.