memory-journal-mcp 4.4.2 → 5.0.0

package/src/handlers/prompts/index.ts

@@ -1,17 +1,19 @@
 /**
  * Memory Journal MCP Server - Prompt Handlers
  *
+ * Barrel file composing prompt definitions from sub-modules.
  * Exports all MCP prompts for workflow guidance.
  */
 
 import type { SqliteAdapter } from '../../database/SqliteAdapter.js'
 import type { McpIcon } from '../../types/index.js'
-import { ICON_PROMPT } from '../../constants/icons.js'
+import { getWorkflowPromptDefinitions } from './workflow.js'
+import { getGitHubPromptDefinitions } from './github.js'
 
 /**
  * Message format for MCP prompts
  */
-interface PromptMessage {
+export interface PromptMessage {
     role: string
     content: {
         type: string
@@ -22,7 +24,7 @@ interface PromptMessage {
 /**
  * Internal prompt definition with db handler
  */
-interface InternalPromptDef {
+export interface InternalPromptDef {
     name: string
     description: string
     arguments?: {
@@ -30,14 +32,14 @@ interface InternalPromptDef {
         description: string
         required?: boolean
     }[]
-    icons?: McpIcon[] // MCP 2025-11-25 icons
+    icons?: McpIcon[]
     handler: (args: Record<string, string>, db: SqliteAdapter) => { messages: PromptMessage[] }
 }
 
 /**
  * Execute a raw SQL query on the database
  */
-function execQuery(
+export function execQuery(
     db: SqliteAdapter,
     sql: string,
     params: unknown[] = []
@@ -65,7 +67,7 @@ export function getPrompts(): object[] {
         name: p.name,
         description: p.description,
         arguments: p.arguments,
-        icons: p.icons, // MCP 2025-11-25 icons
+        icons: p.icons,
     }))
 }
 
@@ -88,499 +90,8 @@ export function getPrompt(
 }
 
 /**
- * Get all prompt definitions
+ * Get all prompt definitions by composing sub-module definitions
  */
 function getAllPromptDefinitions(): InternalPromptDef[] {
-    return [
-        {
-            name: 'find-related',
-            description: 'Discover connected entries via semantic similarity',
-            icons: [ICON_PROMPT],
-            arguments: [
-                {
-                    name: 'query',
-                    description: 'Search query for finding related entries',
-                    required: true,
-                },
-            ],
-            handler: (args: Record<string, string>, db: SqliteAdapter) => {
-                const query = args['query'] ?? ''
-                const entries = db.searchEntries(query, { limit: 5 })
-
-                return {
-                    messages: [
-                        {
-                            role: 'user',
-                            content: {
-                                type: 'text',
-                                text: `Find entries related to: "${query}"\n\nRecent matching entries:\n${entries.map((e) => `- [${String(e.id)}] ${e.content.slice(0, 100)}...`).join('\n')}`,
-                            },
-                        },
-                    ],
-                }
-            },
-        },
-        {
-            name: 'prepare-standup',
-            description: 'Daily standup summaries',
-            icons: [ICON_PROMPT],
-            arguments: [],
-            handler: (_args: Record<string, string>, db: SqliteAdapter) => {
-                const today = new Date().toISOString().split('T')[0] ?? ''
-                const yesterday = new Date(Date.now() - 86400000).toISOString().split('T')[0] ?? ''
-
-                const entries = db.searchByDateRange(yesterday, today)
-
-                return {
-                    messages: [
-                        {
-                            role: 'user',
-                            content: {
-                                type: 'text',
-                                text: `Prepare a standup summary based on these recent entries:\n\n${entries.map((e) => `[${e.timestamp}] ${e.entryType}: ${e.content}`).join('\n\n')}\n\nFormat as:\n- Yesterday: <summary>\n- Today: <planned work>\n- Blockers: <any blockers>`,
-                            },
-                        },
-                    ],
-                }
-            },
-        },
-        {
-            name: 'prepare-retro',
-            description: 'Sprint retrospectives',
-            icons: [ICON_PROMPT],
-            arguments: [
-                {
-                    name: 'days',
-                    description: 'Number of days to include (default: 14)',
-                    required: false,
-                },
-            ],
-            handler: (args: Record<string, string>, db: SqliteAdapter) => {
-                const days = parseInt(args['days'] ?? '14', 10)
-                const endDate = new Date().toISOString().split('T')[0] ?? ''
-                const startDate =
-                    new Date(Date.now() - days * 86400000).toISOString().split('T')[0] ?? ''
-
-                const entries = db.searchByDateRange(startDate, endDate)
-
-                return {
-                    messages: [
-                        {
-                            role: 'user',
-                            content: {
-                                type: 'text',
-                                text: `Prepare a retrospective for the last ${String(days)} days based on these entries:\n\n${entries
-                                    .slice(0, 20)
-                                    .map(
-                                        (e) =>
-                                            `[${e.timestamp}] ${e.entryType}: ${e.content.slice(0, 200)}`
-                                    )
-                                    .join(
-                                        '\n\n'
-                                    )}\n\nFormat as:\n- What went well\n- What could improve\n- Action items`,
-                            },
-                        },
-                    ],
-                }
-            },
-        },
-        {
-            name: 'weekly-digest',
-            description: 'Day-by-day weekly summaries',
-            icons: [ICON_PROMPT],
-            arguments: [],
-            handler: (_args: Record<string, string>, db: SqliteAdapter) => {
-                const endDate = new Date().toISOString().split('T')[0] ?? ''
-                const startDate =
-                    new Date(Date.now() - 7 * 86400000).toISOString().split('T')[0] ?? ''
-
-                const entries = db.searchByDateRange(startDate, endDate)
-
-                return {
-                    messages: [
-                        {
-                            role: 'user',
-                            content: {
-                                type: 'text',
-                                text: `Create a weekly digest from these entries:\n\n${entries.map((e) => `[${e.timestamp}] ${e.entryType}: ${e.content.slice(0, 150)}`).join('\n\n')}\n\nFormat as day-by-day summary with highlights.`,
-                            },
-                        },
-                    ],
-                }
-            },
-        },
-        {
-            name: 'analyze-period',
-            description: 'Deep period analysis with insights',
-            icons: [ICON_PROMPT],
-            arguments: [
-                { name: 'start_date', description: 'Start date (YYYY-MM-DD)', required: true },
-                { name: 'end_date', description: 'End date (YYYY-MM-DD)', required: true },
-            ],
-            handler: (args: Record<string, string>, db: SqliteAdapter) => {
-                const startDate = args['start_date'] ?? ''
-                const endDate = args['end_date'] ?? ''
-
-                const entries = db.searchByDateRange(startDate, endDate)
-                const stats = db.getStatistics('day')
-
-                return {
-                    messages: [
-                        {
-                            role: 'user',
-                            content: {
-                                type: 'text',
-                                text: `Analyze the period ${startDate} to ${endDate}:\n\nStatistics: ${JSON.stringify(stats, null, 2)}\n\nEntries (${String(entries.length)} total):\n${entries
-                                    .slice(0, 15)
-                                    .map(
-                                        (e) =>
-                                            `[${e.timestamp}] ${e.entryType}: ${e.content.slice(0, 100)}`
-                                    )
-                                    .join(
-                                        '\n'
-                                    )}\n\nProvide insights on patterns, productivity, and recommendations.`,
-                            },
-                        },
-                    ],
-                }
-            },
-        },
-        {
-            name: 'goal-tracker',
-            description: 'Milestone and achievement tracking',
-            icons: [ICON_PROMPT],
-            arguments: [],
-            handler: (_args: Record<string, string>, db: SqliteAdapter) => {
-                const entries = execQuery(
-                    db,
-                    `
-                    SELECT * FROM memory_journal
-                    WHERE significance_type IS NOT NULL
-                    AND deleted_at IS NULL
-                    ORDER BY timestamp DESC
-                    LIMIT 20
-                `
-                )
-
-                return {
-                    messages: [
-                        {
-                            role: 'user',
-                            content: {
-                                type: 'text',
-                                text: `Track goals and milestones based on significant entries:\n\n${JSON.stringify(entries, null, 2)}\n\nSummarize progress toward goals and highlight achievements.`,
-                            },
-                        },
-                    ],
-                }
-            },
-        },
-        {
-            name: 'get-context-bundle',
-            description: 'Project context with recent entries, statistics, and GitHub status hints',
-            icons: [ICON_PROMPT],
-            arguments: [],
-            handler: (_args: Record<string, string>, db: SqliteAdapter) => {
-                const recent = db.getRecentEntries(5)
-                const stats = db.getStatistics('week')
-
-                // Compact entry summaries (ID + type + preview) instead of full content
-                const entrySummaries = recent.map((e) => ({
-                    id: e.id,
-                    type: e.entryType,
-                    timestamp: e.timestamp,
-                    preview: e.content.slice(0, 60) + (e.content.length > 60 ? '...' : ''),
-                }))
-
-                return {
-                    messages: [
-                        {
-                            role: 'user',
-                            content: {
-                                type: 'text',
-                                text: `Project context bundle:
-
-**Recent Entries (${String(recent.length)}):**
-${entrySummaries.map((e) => `- #${String(e.id)} (${e.type}) ${e.preview}`).join('\n')}
-
-**Statistics:** ${JSON.stringify(stats)}
-
-**For full GitHub status:** Fetch \`memory://github/status\`
-**For full entry details:** Use \`get_entry_by_id\` with entry ID`,
-                            },
-                        },
-                    ],
-                }
-            },
-        },
-        {
-            name: 'get-recent-entries',
-            description: 'Formatted recent entries',
-            icons: [ICON_PROMPT],
-            arguments: [
-                { name: 'limit', description: 'Number of entries (default: 10)', required: false },
-            ],
-            handler: (args: Record<string, string>, db: SqliteAdapter) => {
-                const limit = parseInt(args['limit'] ?? '10', 10)
-                const entries = db.getRecentEntries(limit)
-
-                return {
-                    messages: [
-                        {
-                            role: 'user',
-                            content: {
-                                type: 'text',
-                                text: `Recent ${String(limit)} entries:\n\n${entries.map((e) => `## ${e.timestamp} (${e.entryType})\n\n${e.content}\n\nTags: ${e.tags.join(', ') || 'none'}`).join('\n\n---\n\n')}`,
-                            },
-                        },
-                    ],
-                }
-            },
-        },
-        {
-            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.`,
-                            },
-                        },
-                    ],
-                }
-            },
-        },
-        {
-            name: 'confirm-briefing',
-            description:
-                'Acknowledge session context received from memory://briefing to inform the user',
-            icons: [ICON_PROMPT],
-            arguments: [],
-            handler: (_args: Record<string, string>, db: SqliteAdapter) => {
-                // Get the same data that memory://briefing would provide
-                const recent = db.getRecentEntries(3)
-                const stats = db.getStatistics('week')
-                const totalEntries = stats.totalEntries ?? 0
-
-                // Build entry summary
-                const entrySummary =
-                    recent.length > 0
-                        ? recent
-                              .map(
-                                  (e) =>
-                                      `  - #${String(e.id)} (${e.entryType}) ${e.content.slice(0, 40)}...`
-                              )
-                              .join('\n')
-                        : '  - No entries yet'
-
-                return {
-                    messages: [
-                        {
-                            role: 'user',
-                            content: {
-                                type: 'text',
-                                text: `Generate a briefing acknowledgment for the user with this context:
-
-**Session Context Received:**
-- **Journal**: ${String(totalEntries)} total entries
-- **Latest Entries**:
-${entrySummary}
-
-**My Behaviors:**
-- Create entries for: implementations, decisions, bug fixes, milestones
-- Search before: major decisions, referencing prior work
-- Link entries: implementation→spec, bugfix→issue
-
-**For More Context:**
-- Full entries: \`memory://recent\` or \`get_entry_by_id(ID)\`
-- GitHub status: \`memory://github/status\`
-- Repo insights: \`memory://github/insights\` (stars, traffic, clones)
-- Full health: \`memory://health\`
-
-Please confirm this context to the user in a concise, friendly format. Use a table if helpful.`,
-                            },
-                        },
-                    ],
-                }
-            },
-        },
-    ]
+    return [...getWorkflowPromptDefinitions(), ...getGitHubPromptDefinitions()]
 }