memory-journal-mcp 6.1.2 → 6.2.1

package/src/codemode/api-constants.ts

@@ -1,263 +0,0 @@
-/**
- * memory-journal-mcp - Code Mode API Constants
- *
- * Static constant maps for the sandbox API:
- * - METHOD_ALIASES: shorthand names within each group
- * - GROUP_EXAMPLES: help() output per group
- * - POSITIONAL_PARAM_MAP: positional → named arg mapping
- * - GROUP_PREFIX_MAP: tool name prefix stripping rules
- * - KEEP_PREFIX_GROUPS: groups that retain their prefix in method names
- */
-
-// =============================================================================
-// Method Aliases
-// =============================================================================
-
-/**
- * Aliases for common naming shortcuts within each group.
- * Maps alias name → canonical method name.
- */
-export const METHOD_ALIASES: Record<string, Record<string, string>> = {
-    core: {
-        create: 'createEntry',
-        get: 'getEntryById',
-        recent: 'getRecentEntries',
-        getRecent: 'getRecentEntries',
-        quick: 'createEntryMinimal',
-        tags: 'listTags',
-    },
-    search: {
-        find: 'searchEntries',
-        byDate: 'searchByDateRange',
-        similar: 'semanticSearch',
-        stats: 'getVectorStats',
-    },
-    analytics: {
-        stats: 'getStatistics',
-        insights: 'getCrossProjectInsights',
-    },
-    relationships: {
-        link: 'linkEntries',
-        graph: 'visualizeRelationships',
-    },
-    export: {
-        dump: 'exportEntries',
-    },
-    admin: {
-        edit: 'updateEntry',
-        remove: 'deleteEntry',
-        rebuild: 'rebuildVectorIndex',
-        addVector: 'addToVectorIndex',
-        mergeTags: 'mergeTags',
-    },
-    github: {
-        issues: 'getGithubIssues',
-        issue: 'getGithubIssue',
-        prs: 'getGithubPrs',
-        pr: 'getGithubPr',
-        context: 'getGithubContext',
-        kanban: 'getKanbanBoard',
-        moveKanban: 'moveKanbanItem',
-        milestones: 'getGithubMilestones',
-        milestone: 'getGithubMilestone',
-        createMilestone: 'createGithubMilestone',
-        updateMilestone: 'updateGithubMilestone',
-        deleteMilestone: 'deleteGithubMilestone',
-        repoInsights: 'getRepoInsights',
-        createIssue: 'createGithubIssueWithEntry',
-        closeIssue: 'closeGithubIssueWithEntry',
-    },
-    backup: {
-        save: 'backupJournal',
-        list: 'listBackups',
-        restore: 'restoreBackup',
-        cleanup: 'cleanupBackups',
-    },
-    team: {
-        create: 'teamCreateEntry',
-        recent: 'teamGetRecent',
-        find: 'teamSearch',
-        get: 'teamGetEntryById',
-        tags: 'teamListTags',
-        byDate: 'teamSearchByDateRange',
-        update: 'teamUpdateEntry',
-        remove: 'teamDeleteEntry',
-        mergeTags: 'teamMergeTags',
-        stats: 'teamGetStatistics',
-        link: 'teamLinkEntries',
-        graph: 'teamVisualizeRelationships',
-        export: 'teamExportEntries',
-        backup: 'teamBackup',
-        listBackups: 'teamListBackups',
-        semanticSearch: 'teamSemanticSearch',
-        vectorStats: 'teamGetVectorIndexStats',
-        rebuildIndex: 'teamRebuildVectorIndex',
-        addToIndex: 'teamAddToVectorIndex',
-        insights: 'teamGetCrossProjectInsights',
-    },
-}
-
-// =============================================================================
-// Group Examples (for help())
-// =============================================================================
-
-/**
- * Usage examples for each group's help() output
- */
-export const GROUP_EXAMPLES: Record<string, string[]> = {
-    core: [
-        'mj.core.createEntry({ content: "Implemented Code Mode" })',
-        'mj.core.getEntryById({ entry_id: 1 })',
-        'mj.core.getRecentEntries({ limit: 10 })',
-        'mj.core.createEntryMinimal({ content: "Quick note" })',
-        'mj.core.listTags()',
-    ],
-    search: [
-        'mj.search.searchEntries({ query: "performance" })',
-        'mj.search.searchByDateRange({ start_date: "2026-03-01", end_date: "2026-03-11" })',
-        'mj.search.semanticSearch({ query: "authentication patterns" })',
-    ],
-    analytics: ['mj.analytics.getStatistics()', 'mj.analytics.getCrossProjectInsights()'],
-    relationships: [
-        'mj.relationships.linkEntries({ from_entry_id: 1, to_entry_id: 2, relationship_type: "implements" })',
-        'mj.relationships.visualizeRelationships({ entry_id: 1 })',
-    ],
-    export: [
-        'mj.export.exportEntries({ format: "json" })',
-        'mj.export.exportEntries({ format: "markdown", limit: 50 })',
-    ],
-    admin: [
-        'mj.admin.updateEntry({ entry_id: 1, content: "Updated content" })',
-        'mj.admin.deleteEntry({ entry_id: 1 })',
-        'mj.admin.mergeTags({ source_tag: "old", target_tag: "new" })',
-        'mj.admin.rebuildVectorIndex()',
-        'mj.admin.addToVectorIndex({ entry_id: 1 })',
-    ],
-    github: [
-        'mj.github.getGithubIssues({ state: "open" })',
-        'mj.github.getGithubPrs({ state: "open" })',
-        'mj.github.getKanbanBoard({ project_number: 1 })',
-        'mj.github.getGithubMilestones()',
-        'mj.github.getRepoInsights()',
-    ],
-    backup: [
-        'mj.backup.backupJournal()',
-        'mj.backup.listBackups()',
-        'mj.backup.restoreBackup({ filename: "backup-2026-03-11.db" })',
-    ],
-    team: [
-        'mj.team.teamCreateEntry({ content: "Team update" })',
-        'mj.team.teamGetRecent({ limit: 5 })',
-        'mj.team.teamSearch({ query: "release" })',
-        'mj.team.teamGetEntryById({ entry_id: 1 })',
-        'mj.team.teamListTags()',
-        'mj.team.teamUpdateEntry({ entry_id: 1, content: "Updated" })',
-        'mj.team.teamGetStatistics()',
-        'mj.team.teamExportEntries({ format: "json" })',
-        'mj.team.teamBackup()',
-        'mj.team.teamSemanticSearch({ query: "deployment" })',
-        'mj.team.teamGetCrossProjectInsights()',
-    ],
-}
-
-// =============================================================================
-// Positional Parameter Mapping
-// =============================================================================
-
-/**
- * Maps method names to their parameter names for positional argument support.
- * Single string = first positional arg maps to this key.
- * Array = multiple positional args map to these keys in order.
- *
- * Enables:
- * - `mj.core.createEntry("My note")` → `{ content: "My note" }`
- * - `mj.search.searchEntries("performance")` → `{ query: "performance" }`
- */
-export const POSITIONAL_PARAM_MAP: Record<string, string | string[]> = {
-    // Core
-    createEntry: 'content',
-    getEntryById: 'entry_id',
-    getRecentEntries: 'limit',
-    createEntryMinimal: 'content',
-    testSimple: 'message',
-
-    // Search
-    searchEntries: 'query',
-    searchByDateRange: ['start_date', 'end_date'],
-    semanticSearch: 'query',
-
-    // Analytics (no positional — uses empty params)
-
-    // Relationships
-    linkEntries: ['from_entry_id', 'to_entry_id', 'relationship_type'],
-    visualizeRelationships: 'entry_id',
-
-    // Export
-    exportEntries: 'format',
-
-    // Admin
-    updateEntry: 'entry_id',
-    deleteEntry: 'entry_id',
-    addToVectorIndex: 'entry_id',
-    mergeTags: ['source_tag', 'target_tag'],
-
-    // GitHub
-    getGithubIssue: 'issue_number',
-    getGithubPr: 'pr_number',
-    getKanbanBoard: 'project_number',
-    moveKanbanItem: ['item_id', 'status'],
-    getGithubMilestone: 'milestone_number',
-    createGithubMilestone: 'title',
-    updateGithubMilestone: 'milestone_number',
-    deleteGithubMilestone: 'milestone_number',
-    createGithubIssueWithEntry: 'title',
-    closeGithubIssueWithEntry: 'issue_number',
-
-    // Backup
-    restoreBackup: 'filename',
-    cleanupBackups: 'keep_count',
-
-    // Team
-    teamCreateEntry: 'content',
-    teamGetRecent: 'limit',
-    teamSearch: 'query',
-    teamGetEntryById: 'entry_id',
-    teamSearchByDateRange: ['start_date', 'end_date'],
-    teamUpdateEntry: 'entry_id',
-    teamDeleteEntry: 'entry_id',
-    teamMergeTags: ['source_tag', 'target_tag'],
-    teamLinkEntries: ['from_entry_id', 'to_entry_id', 'relationship_type'],
-    teamVisualizeRelationships: 'entry_id',
-    teamExportEntries: 'format',
-    teamSemanticSearch: 'query',
-    teamAddToVectorIndex: 'entry_id',
-}
-
-// =============================================================================
-// Tool Name → Method Name Conversion
-// =============================================================================
-
-/**
- * Map group name to the prefix used in tool names.
- * When a tool is in a group, its name typically starts with a group-related prefix.
- * For memory-journal-mcp, tool names are flat (no server prefix like "sqlite_").
- */
-export const GROUP_PREFIX_MAP: Record<string, string> = {
-    core: '',
-    search: '',
-    analytics: '',
-    relationships: '',
-    export: '',
-    admin: '',
-    github: '',
-    backup: '',
-    team: '',
-    codemode: 'mj_',
-}
-
-/**
- * Groups where the prefix should be kept in the method name.
- * For memory-journal-mcp, github and team tools have meaningful prefixes
- * (e.g., `get_github_issues`, `team_create_entry`).
- */
-export const KEEP_PREFIX_GROUPS = new Set(['github', 'team'])

package/src/codemode/api.ts

@@ -1,302 +0,0 @@
-/**
- * memory-journal-mcp - Code Mode API
- *
- * Generates the `mj.*` API object that is injected into the sandbox.
- * Each tool group becomes a namespace (e.g., `mj.core.createEntry()`).
- *
- * Architecture:
- * - Reads tool definitions from the handler barrel
- * - Groups tools by their `group` property
- * - Converts tool names to camelCase method names
- * - Creates proxy methods that normalize positional args and call handlers
- * - Exposes `help()` at top level and per-group for discoverability
- */
-
-import type { ToolDefinition } from '../types/index.js'
-import type { ToolGroup } from '../types/filtering.js'
-import {
-    METHOD_ALIASES,
-    GROUP_EXAMPLES,
-    POSITIONAL_PARAM_MAP,
-    GROUP_PREFIX_MAP,
-    KEEP_PREFIX_GROUPS,
-} from './api-constants.js'
-
-/**
- * Convert tool name to camelCase method name.
- *
- * Examples:
- *   create_entry (core)         → createEntry
- *   search_entries (search)     → searchEntries
- *   get_github_issues (github)  → getGithubIssues
- *   team_create_entry (team)    → teamCreateEntry
- *   backup_journal (backup)     → backupJournal
- */
-export function toolNameToMethodName(toolName: string, groupName: string): string {
-    let name = toolName
-
-    // For groups not in KEEP_PREFIX_GROUPS, strip the group prefix
-    if (!KEEP_PREFIX_GROUPS.has(groupName)) {
-        const groupPrefix = GROUP_PREFIX_MAP[groupName] ?? ''
-        if (groupPrefix && name.startsWith(groupPrefix)) {
-            name = name.substring(groupPrefix.length)
-        }
-    }
-
-    // Convert snake_case to camelCase
-    return name.replace(/_([a-z])/g, (_, letter: string) => letter.toUpperCase())
-}
-
-// =============================================================================
-// Parameter Normalization
-// =============================================================================
-
-/**
- * Normalize parameters to support positional arguments.
- * Handles both single positional args and multiple positional args.
- */
-function normalizeParams(methodName: string, args: unknown[]): unknown {
-    if (args.length === 0) return undefined
-
-    if (args.length === 1) {
-        const arg = args[0]
-
-        // Object arg — pass through
-        if (typeof arg === 'object' && arg !== null && !Array.isArray(arg)) {
-            return arg
-        }
-
-        // Primitive arg (string, number, boolean) — use positional mapping
-        if (typeof arg === 'string' || typeof arg === 'number' || typeof arg === 'boolean') {
-            const paramMapping = POSITIONAL_PARAM_MAP[methodName]
-            if (typeof paramMapping === 'string') {
-                return { [paramMapping]: arg }
-            }
-            if (Array.isArray(paramMapping) && paramMapping[0] !== undefined) {
-                return { [paramMapping[0]]: arg }
-            }
-            // Fallback: try common names (only for strings)
-            if (typeof arg === 'string') {
-                return { content: arg, query: arg }
-            }
-            return arg
-        }
-
-        return arg
-    }
-
-    // Multi-arg: use positional parameter mapping
-    const paramMapping = POSITIONAL_PARAM_MAP[methodName]
-    if (paramMapping === undefined) {
-        return args[0]
-    }
-
-    if (typeof paramMapping === 'string') {
-        const result: Record<string, unknown> = { [paramMapping]: args[0] }
-        if (args.length > 1) {
-            const lastArg = args[args.length - 1]
-            if (typeof lastArg === 'object' && lastArg !== null && !Array.isArray(lastArg)) {
-                Object.assign(result, lastArg)
-            }
-        }
-        return result
-    }
-
-    // Array mapping — map positional args to named params
-    const result: Record<string, unknown> = {}
-
-    for (let i = 0; i < paramMapping.length && i < args.length; i++) {
-        const key = paramMapping[i]
-        if (key !== undefined) {
-            result[key] = args[i]
-        }
-    }
-
-    // Merge trailing options object
-    if (args.length > paramMapping.length) {
-        const lastArg = args[args.length - 1]
-        if (typeof lastArg === 'object' && lastArg !== null && !Array.isArray(lastArg)) {
-            Object.assign(result, lastArg)
-        }
-    }
-
-    return result
-}
-
-// =============================================================================
-// Group API Factory
-// =============================================================================
-
-/** Type alias for group API record */
-type GroupApiRecord = Record<string, (...args: unknown[]) => Promise<unknown>>
-
-/**
- * Create a group API from tool definitions.
- * Each tool becomes a method on the group object.
- */
-function createGroupApi(groupName: string, tools: ToolDefinition[]): GroupApiRecord {
-    const api: GroupApiRecord = {}
-
-    for (const tool of tools) {
-        const methodName = toolNameToMethodName(tool.name, groupName)
-
-        api[methodName] = (...args: unknown[]): Promise<unknown> => {
-            const normalizedParams = normalizeParams(methodName, args) ?? {}
-            return Promise.resolve(tool.handler(normalizedParams))
-        }
-    }
-
-    // Add method aliases
-    const aliases = METHOD_ALIASES[groupName]
-    if (aliases) {
-        for (const [aliasName, canonicalName] of Object.entries(aliases)) {
-            if (api[canonicalName] !== undefined) {
-                api[aliasName] = api[canonicalName]
-            }
-        }
-    }
-
-    // Add help() for discoverability
-    api['help'] = (): Promise<{
-        group: string
-        methods: string[]
-        examples: string[]
-    }> => {
-        const methods = Object.keys(api)
-            .filter((k) => k !== 'help')
-            .sort()
-
-        return Promise.resolve({
-            group: groupName,
-            methods,
-            examples: GROUP_EXAMPLES[groupName] ?? [],
-        })
-    }
-
-    return api
-}
-
-// =============================================================================
-// JournalApi Class
-// =============================================================================
-
-/**
- * Main API class exposing all Memory Journal tool groups.
- * This is the object injected as `mj` in the sandbox.
- */
-export class JournalApi {
-    readonly core: GroupApiRecord
-    readonly search: GroupApiRecord
-    readonly analytics: GroupApiRecord
-    readonly relationships: GroupApiRecord
-    readonly export: GroupApiRecord
-    readonly admin: GroupApiRecord
-    readonly github: GroupApiRecord
-    readonly backup: GroupApiRecord
-    readonly team: GroupApiRecord
-
-    private readonly toolsByGroup: Map<string, ToolDefinition[]>
-
-    constructor(tools: ToolDefinition[]) {
-        // Group tools by their group property
-        this.toolsByGroup = new Map()
-        for (const tool of tools) {
-            // Skip codemode tools (no recursion)
-            if (tool.group === 'codemode') continue
-
-            const existing = this.toolsByGroup.get(tool.group) ?? []
-            existing.push(tool)
-            this.toolsByGroup.set(tool.group, existing)
-        }
-
-        // Create group-specific APIs for all 9 groups
-        this.core = createGroupApi('core', this.toolsByGroup.get('core') ?? [])
-        this.search = createGroupApi('search', this.toolsByGroup.get('search') ?? [])
-        this.analytics = createGroupApi('analytics', this.toolsByGroup.get('analytics') ?? [])
-        this.relationships = createGroupApi(
-            'relationships',
-            this.toolsByGroup.get('relationships') ?? []
-        )
-        this.export = createGroupApi('export', this.toolsByGroup.get('export') ?? [])
-        this.admin = createGroupApi('admin', this.toolsByGroup.get('admin') ?? [])
-        this.github = createGroupApi('github', this.toolsByGroup.get('github') ?? [])
-        this.backup = createGroupApi('backup', this.toolsByGroup.get('backup') ?? [])
-        this.team = createGroupApi('team', this.toolsByGroup.get('team') ?? [])
-    }
-
-    /**
-     * Get all available groups
-     */
-    getGroups(): string[] {
-        return [...this.toolsByGroup.keys()].sort()
-    }
-
-    /**
-     * Get method names for a group
-     */
-    getGroupMethods(group: ToolGroup): string[] {
-        const groupApi = this[group as keyof JournalApi] as GroupApiRecord | undefined
-        if (!groupApi || typeof groupApi !== 'object') return []
-        return Object.keys(groupApi)
-            .filter((k) => k !== 'help')
-            .sort()
-    }
-
-    /**
-     * Create the sandbox bindings object.
-     * This is the object injected as `mj` in the sandbox.
-     * Includes group namespaces + top-level aliases for common operations.
-     */
-    createSandboxBindings(): Record<string, unknown> {
-        const bindings: Record<string, unknown> = {
-            // Group namespaces
-            core: this.core,
-            search: this.search,
-            analytics: this.analytics,
-            relationships: this.relationships,
-            export: this.export,
-            admin: this.admin,
-            github: this.github,
-            backup: this.backup,
-            team: this.team,
-
-            // Top-level convenience aliases
-            createEntry: this.core['createEntry'],
-            getRecentEntries: this.core['getRecentEntries'],
-            searchEntries: this.search['searchEntries'],
-            getStatistics: this.analytics['getStatistics'],
-
-            // Top-level help
-            help: (): Promise<{
-                groups: string[]
-                totalMethods: number
-                usage: string
-            }> => {
-                const groups = this.getGroups()
-                let totalMethods = 0
-                for (const group of groups) {
-                    totalMethods += this.getGroupMethods(group as ToolGroup).length
-                }
-                return Promise.resolve({
-                    groups,
-                    totalMethods,
-                    usage: 'Use mj.<group>.help() for group details. Example: mj.core.help()',
-                })
-            },
-        }
-
-        return bindings
-    }
-}
-
-// =============================================================================
-// Factory Function
-// =============================================================================
-
-/**
- * Create a JournalApi instance from tool definitions.
- * Convenience factory for use in tool handler setup.
- */
-export function createJournalApi(tools: ToolDefinition[]): JournalApi {
-    return new JournalApi(tools)
-}

package/src/codemode/auto-return.ts

@@ -1,65 +0,0 @@
-/**
- * memory-journal-mcp — Code Mode Auto-Return Transform
- *
- * Transforms user code so the last expression statement is implicitly
- * returned from the async IIFE wrapper.  Mimics Node REPL / Chrome
- * DevTools semantics where bare expressions surface their value.
- *
- * The transform is intentionally heuristic (string-based, not AST)
- * because the code runs in a sandboxed `vm.Script` that already
- * handles syntax errors.  Edge-case misfires are safe — they either
- * produce a benign `return` of the last expression or leave the code
- * unchanged (returning `undefined`, the previous behavior).
- */
-
-// Statements that must NOT be prefixed with `return`
-const NON_RETURNABLE =
-    /^\s*(return|throw|const |let |var |if\b|else\b|for\b|while\b|do\b|switch\b|try\b|catch\b|finally\b|class |function |\/\/|\/\*|\{|\})/
-
-/**
- * Transform user code so the last expression statement gets an
- * implicit `return`, enabling the IIFE wrapper to propagate the value.
- *
- * Examples:
- *   `mj.help()`                       → `return mj.help()`
- *   `const r = await foo(); r`        → `const r = await foo(); return r`
- *   `return 42`                       → `return 42`          (no change)
- *   `for (const x of xs) { ... }`    → unchanged             (control flow)
- */
-export function transformAutoReturn(code: string): string {
-    const trimmed = code.trimEnd()
-    if (!trimmed) return code
-
-    // Find the boundary of the last statement.
-    // Walk backwards from the end to find the last semicolon or newline
-    // that is NOT inside braces/brackets/parens.
-    let depth = 0
-    let splitIndex = -1
-
-    for (let i = trimmed.length - 1; i >= 0; i--) {
-        const ch = trimmed.charAt(i)
-        // Track nesting (walking backwards, so openers increase depth)
-        if (ch === '}' || ch === ']' || ch === ')') depth++
-        else if (ch === '{' || ch === '[' || ch === '(') depth--
-
-        if (depth === 0 && (ch === ';' || ch === '\n')) {
-            splitIndex = i
-            break
-        }
-    }
-
-    // Extract the last statement
-    const lastStmt = (splitIndex >= 0 ? trimmed.slice(splitIndex + 1) : trimmed).trim()
-
-    if (!lastStmt) return code
-    if (NON_RETURNABLE.test(lastStmt)) return code
-
-    // Insert `return` before the last statement
-    if (splitIndex >= 0) {
-        const before = trimmed.slice(0, splitIndex + 1)
-        return `${before}\nreturn ${lastStmt}`
-    }
-
-    // Single statement — just prepend return
-    return `return ${trimmed}`
-}

package/src/codemode/index.ts

@@ -1,47 +0,0 @@
-/**
- * memory-journal-mcp - Code Mode Module
- *
- * Exports for the sandboxed code execution environment.
- */
-
-// Types
-export type {
-    SandboxOptions,
-    PoolOptions,
-    SandboxResult,
-    ExecutionMetrics,
-    SecurityConfig,
-    ValidationResult,
-    ExecutionRecord,
-    ExecuteCodeOptions,
-    ExecuteCodeResult,
-    GroupApi,
-} from './types.js'
-
-export { DEFAULT_SANDBOX_OPTIONS, DEFAULT_POOL_OPTIONS, DEFAULT_SECURITY_CONFIG } from './types.js'
-
-// Sandbox (VM-based)
-export { CodeModeSandbox, SandboxPool } from './sandbox.js'
-
-// Worker Sandbox (worker_threads-based)
-export { WorkerSandbox, WorkerSandboxPool } from './worker-sandbox.js'
-
-// Sandbox Factory (mode selection)
-export {
-    setDefaultSandboxMode,
-    getDefaultSandboxMode,
-    getAvailableSandboxModes,
-    createSandbox,
-    createSandboxPool,
-    getSandboxModeInfo,
-    type SandboxMode,
-    type ISandbox,
-    type ISandboxPool,
-    type SandboxModeInfo,
-} from './sandbox-factory.js'
-
-// Security
-export { CodeModeSecurityManager } from './security.js'
-
-// API
-export { JournalApi, createJournalApi } from './api.js'