memory-journal-mcp 4.4.2 → 5.0.0

package/src/database/schema.ts

@@ -0,0 +1,125 @@
+/**
+ * Memory Journal MCP Server - Database Schema
+ *
+ * SQL DDL for initialization and input types for the database adapter.
+ */
+
+import type { EntryType, SignificanceType } from '../types/index.js'
+
+/**
+ * SQL schema for database initialization.
+ * Creates all tables and indexes if they don't already exist.
+ */
+export const SCHEMA_SQL = `
+-- Main journal entries table
+CREATE TABLE IF NOT EXISTS memory_journal (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    entry_type TEXT NOT NULL,
+    content TEXT NOT NULL,
+    timestamp TEXT DEFAULT CURRENT_TIMESTAMP,
+    is_personal INTEGER DEFAULT 1,
+    significance_type TEXT,
+    auto_context TEXT,
+    deleted_at TEXT,
+    -- GitHub integration fields
+    project_number INTEGER,
+    project_owner TEXT,
+    issue_number INTEGER,
+    issue_url TEXT,
+    pr_number INTEGER,
+    pr_url TEXT,
+    pr_status TEXT,
+    workflow_run_id INTEGER,
+    workflow_name TEXT,
+    workflow_status TEXT
+);
+
+-- Tags table
+CREATE TABLE IF NOT EXISTS tags (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT UNIQUE NOT NULL,
+    usage_count INTEGER DEFAULT 0
+);
+
+-- Junction table for entry-tag relationships
+CREATE TABLE IF NOT EXISTS entry_tags (
+    entry_id INTEGER NOT NULL,
+    tag_id INTEGER NOT NULL,
+    PRIMARY KEY (entry_id, tag_id),
+    FOREIGN KEY (entry_id) REFERENCES memory_journal(id) ON DELETE CASCADE,
+    FOREIGN KEY (tag_id) REFERENCES tags(id) ON DELETE CASCADE
+);
+
+-- Relationships between entries
+CREATE TABLE IF NOT EXISTS relationships (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    from_entry_id INTEGER NOT NULL,
+    to_entry_id INTEGER NOT NULL,
+    relationship_type TEXT NOT NULL,
+    description TEXT,
+    created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (from_entry_id) REFERENCES memory_journal(id) ON DELETE CASCADE,
+    FOREIGN KEY (to_entry_id) REFERENCES memory_journal(id) ON DELETE CASCADE
+);
+
+-- Embeddings for vector search (stored as JSON for sql.js compatibility)
+CREATE TABLE IF NOT EXISTS embeddings (
+    entry_id INTEGER PRIMARY KEY,
+    embedding TEXT NOT NULL,
+    model_name TEXT NOT NULL,
+    FOREIGN KEY (entry_id) REFERENCES memory_journal(id) ON DELETE CASCADE
+);
+
+-- Indexes for performance
+CREATE INDEX IF NOT EXISTS idx_memory_journal_timestamp ON memory_journal(timestamp);
+CREATE INDEX IF NOT EXISTS idx_memory_journal_type ON memory_journal(entry_type);
+CREATE INDEX IF NOT EXISTS idx_memory_journal_personal ON memory_journal(is_personal);
+CREATE INDEX IF NOT EXISTS idx_memory_journal_deleted ON memory_journal(deleted_at);
+CREATE INDEX IF NOT EXISTS idx_memory_journal_project ON memory_journal(project_number);
+CREATE INDEX IF NOT EXISTS idx_memory_journal_issue ON memory_journal(issue_number);
+CREATE INDEX IF NOT EXISTS idx_memory_journal_pr ON memory_journal(pr_number);
+CREATE INDEX IF NOT EXISTS idx_tags_name ON tags(name);
+CREATE INDEX IF NOT EXISTS idx_entry_tags_entry ON entry_tags(entry_id);
+CREATE INDEX IF NOT EXISTS idx_entry_tags_tag ON entry_tags(tag_id);
+CREATE INDEX IF NOT EXISTS idx_relationships_from ON relationships(from_entry_id);
+CREATE INDEX IF NOT EXISTS idx_relationships_to ON relationships(to_entry_id);
+`
+
+/**
+ * Input for creating a new entry
+ */
+export interface CreateEntryInput {
+    content: string
+    entryType?: EntryType
+    tags?: string[]
+    isPersonal?: boolean
+    significanceType?: SignificanceType
+    autoContext?: string
+    projectNumber?: number
+    projectOwner?: string
+    issueNumber?: number
+    issueUrl?: string
+    prNumber?: number
+    prUrl?: string
+    prStatus?: 'draft' | 'open' | 'merged' | 'closed'
+    workflowRunId?: number
+    workflowName?: string
+    workflowStatus?: 'queued' | 'in_progress' | 'completed'
+}
+
+/**
+ * SQL migration to add the author column for team databases.
+ * Applied after SCHEMA_SQL when initializing a team database.
+ */
+export const TEAM_SCHEMA_SQL = `
+-- Author column for team entries (identifies who shared the entry)
+ALTER TABLE memory_journal ADD COLUMN author TEXT;
+`
+
+/**
+ * Input for creating a team entry (extends standard entry with author)
+ */
+export interface CreateTeamEntryInput extends CreateEntryInput {
+    /** Author name (auto-detected from git config or TEAM_AUTHOR env) */
+    author?: string
+}

package/src/filtering/ToolFilter.ts

@@ -13,7 +13,7 @@ export type { ToolFilterConfig } from '../types/index.js'
 /**
  * Tool group definitions mapping group names to tool names
  *
- * All 39 tools are categorized here for filtering support.
+ * All 42 tools are categorized here for filtering support.
  */
 export const TOOL_GROUPS: Record<ToolGroup, string[]> = {
     core: [
@@ -53,6 +53,7 @@ export const TOOL_GROUPS: Record<ToolGroup, string[]> = {
         'get_repo_insights',
     ],
     backup: ['backup_journal', 'list_backups', 'restore_backup', 'cleanup_backups'],
+    team: ['team_create_entry', 'team_get_recent', 'team_search'],
 }
 
 /**
@@ -61,7 +62,17 @@ export const TOOL_GROUPS: Record<ToolGroup, string[]> = {
 export const META_GROUPS: Record<MetaGroup, ToolGroup[]> = {
     starter: ['core', 'search'],
     essential: ['core'],
-    full: ['core', 'search', 'analytics', 'relationships', 'export', 'admin', 'github', 'backup'],
+    full: [
+        'core',
+        'search',
+        'analytics',
+        'relationships',
+        'export',
+        'admin',
+        'github',
+        'backup',
+        'team',
+    ],
     readonly: ['core', 'search', 'analytics', 'relationships', 'export'],
 }
 

package/src/github/GitHubIntegration.ts

@@ -1124,12 +1124,10 @@ export class GitHubIntegration {
         if (cached) return cached
 
         try {
-            // GitHub REST API uses 'open' | 'closed' | 'all' for milestone state
-            const apiState = state === 'all' ? undefined : state
             const response = await this.octokit.issues.listMilestones({
                 owner,
                 repo,
-                state: apiState,
+                state,
                 per_page: limit,
                 sort: 'due_on',
                 direction: 'asc',

package/src/handlers/prompts/github.ts

@@ -0,0 +1,209 @@
+/**
+ * Memory Journal MCP Server - GitHub Prompt Definitions
+ *
+ * Prompts: project-status-summary, pr-summary, code-review-prep,
+ * pr-retrospective, actions-failure-digest, project-milestone-tracker
+ */
+
+import type { SqliteAdapter } from '../../database/SqliteAdapter.js'
+import { ICON_PROMPT } from '../../constants/icons.js'
+import { execQuery, type InternalPromptDef } from './index.js'
+
+/**
+ * Get GitHub prompt definitions
+ */
+export function getGitHubPromptDefinitions(): InternalPromptDef[] {
+    return [
+        {
+            name: 'project-status-summary',
+            description: 'GitHub Project status reports',
+            icons: [ICON_PROMPT],
+            arguments: [
+                { name: 'project_number', description: 'GitHub Project number', required: true },
+            ],
+            handler: (args: Record<string, string>, db: SqliteAdapter) => {
+                const projectNumber = parseInt(args['project_number'] ?? '0', 10)
+                const entries = execQuery(
+                    db,
+                    `
+                    SELECT * FROM memory_journal
+                    WHERE project_number = ?
+                    AND deleted_at IS NULL
+                    ORDER BY timestamp DESC
+                    LIMIT 20
+                `,
+                    [projectNumber]
+                )
+
+                return {
+                    messages: [
+                        {
+                            role: 'user',
+                            content: {
+                                type: 'text',
+                                text: `Generate a status summary for Project #${String(projectNumber)}:\n\nEntries: ${JSON.stringify(entries, null, 2)}\n\nProvide: overview, recent activity, blockers, next steps.`,
+                            },
+                        },
+                    ],
+                }
+            },
+        },
+        {
+            name: 'pr-summary',
+            description: 'Pull request journal activity summary',
+            icons: [ICON_PROMPT],
+            arguments: [{ name: 'pr_number', description: 'Pull request number', required: true }],
+            handler: (args: Record<string, string>, db: SqliteAdapter) => {
+                const prNumber = parseInt(args['pr_number'] ?? '0', 10)
+                const entries = execQuery(
+                    db,
+                    `
+                    SELECT * FROM memory_journal
+                    WHERE pr_number = ?
+                    AND deleted_at IS NULL
+                    ORDER BY timestamp ASC
+                `,
+                    [prNumber]
+                )
+
+                return {
+                    messages: [
+                        {
+                            role: 'user',
+                            content: {
+                                type: 'text',
+                                text: `Summarize PR #${String(prNumber)} activity:\n\nJournal entries: ${JSON.stringify(entries, null, 2)}\n\nProvide: summary of changes, decisions made, testing done.`,
+                            },
+                        },
+                    ],
+                }
+            },
+        },
+        {
+            name: 'code-review-prep',
+            description: 'Comprehensive PR review preparation',
+            icons: [ICON_PROMPT],
+            arguments: [{ name: 'pr_number', description: 'Pull request number', required: true }],
+            handler: (args: Record<string, string>, db: SqliteAdapter) => {
+                const prNumber = parseInt(args['pr_number'] ?? '0', 10)
+                const entries = execQuery(
+                    db,
+                    `
+                    SELECT * FROM memory_journal
+                    WHERE pr_number = ?
+                    AND deleted_at IS NULL
+                    ORDER BY timestamp ASC
+                `,
+                    [prNumber]
+                )
+
+                return {
+                    messages: [
+                        {
+                            role: 'user',
+                            content: {
+                                type: 'text',
+                                text: `Prepare for code review of PR #${String(prNumber)}:\n\nContext entries: ${JSON.stringify(entries, null, 2)}\n\nProvide: review checklist, areas of concern, testing recommendations.`,
+                            },
+                        },
+                    ],
+                }
+            },
+        },
+        {
+            name: 'pr-retrospective',
+            description: 'Completed PR analysis with learnings',
+            icons: [ICON_PROMPT],
+            arguments: [{ name: 'pr_number', description: 'Pull request number', required: true }],
+            handler: (args: Record<string, string>, db: SqliteAdapter) => {
+                const prNumber = parseInt(args['pr_number'] ?? '0', 10)
+                const entries = execQuery(
+                    db,
+                    `
+                    SELECT * FROM memory_journal
+                    WHERE pr_number = ?
+                    AND deleted_at IS NULL
+                    ORDER BY timestamp ASC
+                `,
+                    [prNumber]
+                )
+
+                return {
+                    messages: [
+                        {
+                            role: 'user',
+                            content: {
+                                type: 'text',
+                                text: `Retrospective for PR #${String(prNumber)}:\n\nJournal entries: ${JSON.stringify(entries, null, 2)}\n\nProvide: what went well, challenges, lessons learned.`,
+                            },
+                        },
+                    ],
+                }
+            },
+        },
+        {
+            name: 'actions-failure-digest',
+            description: 'CI/CD failure analysis with root cause identification',
+            icons: [ICON_PROMPT],
+            arguments: [],
+            handler: (_args: Record<string, string>, db: SqliteAdapter) => {
+                const entries = execQuery(
+                    db,
+                    `
+                    SELECT * FROM memory_journal
+                    WHERE workflow_run_id IS NOT NULL
+                    AND deleted_at IS NULL
+                    ORDER BY timestamp DESC
+                    LIMIT 20
+                `
+                )
+
+                return {
+                    messages: [
+                        {
+                            role: 'user',
+                            content: {
+                                type: 'text',
+                                text: `Analyze CI/CD failures from these workflow entries:\n\n${JSON.stringify(entries, null, 2)}\n\nProvide: failure patterns, root causes, remediation steps.`,
+                            },
+                        },
+                    ],
+                }
+            },
+        },
+        {
+            name: 'project-milestone-tracker',
+            description: 'Milestone progress tracking',
+            icons: [ICON_PROMPT],
+            arguments: [
+                { name: 'project_number', description: 'GitHub Project number', required: true },
+            ],
+            handler: (args: Record<string, string>, db: SqliteAdapter) => {
+                const projectNumber = parseInt(args['project_number'] ?? '0', 10)
+                const entries = execQuery(
+                    db,
+                    `
+                    SELECT * FROM memory_journal
+                    WHERE project_number = ?
+                    AND significance_type IS NOT NULL
+                    AND deleted_at IS NULL
+                    ORDER BY timestamp DESC
+                `,
+                    [projectNumber]
+                )
+
+                return {
+                    messages: [
+                        {
+                            role: 'user',
+                            content: {
+                                type: 'text',
+                                text: `Track milestones for Project #${String(projectNumber)}:\n\nMilestone entries: ${JSON.stringify(entries, null, 2)}\n\nProvide: progress summary, upcoming milestones, timeline.`,
+                            },
+                        },
+                    ],
+                }
+            },
+        },
+    ]
+}