memory-journal-mcp 6.1.2 → 6.2.1

package/src/handlers/prompts/workflow.ts

@@ -1,361 +0,0 @@
-/**
- * Memory Journal MCP Server - Workflow Prompt Definitions
- *
- * Prompts: find-related, prepare-standup, prepare-retro, weekly-digest,
- * analyze-period, goal-tracker, get-context-bundle, get-recent-entries, confirm-briefing,
- * session-summary
- */
-
-import type { IDatabaseAdapter } from '../../database/core/interfaces.js'
-import { RAW_ENTRY_COLUMNS as ENTRY_COLUMNS } from '../../database/core/entry-columns.js'
-import { ICON_PROMPT } from '../../constants/icons.js'
-import { execQuery, type InternalPromptDef } from './index.js'
-
-/** Milliseconds in one day */
-const MS_PER_DAY = 86_400_000
-
-/**
- * Get workflow prompt definitions
- */
-export function getWorkflowPromptDefinitions(): 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: IDatabaseAdapter) => {
-                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: IDatabaseAdapter) => {
-                const today = new Date().toISOString().split('T')[0] ?? ''
-                const yesterday =
-                    new Date(Date.now() - MS_PER_DAY).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: IDatabaseAdapter) => {
-                const days = parseInt(args['days'] ?? '14', 10)
-                const endDate = new Date().toISOString().split('T')[0] ?? ''
-                const startDate =
-                    new Date(Date.now() - days * MS_PER_DAY).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: IDatabaseAdapter) => {
-                const endDate = new Date().toISOString().split('T')[0] ?? ''
-                const startDate =
-                    new Date(Date.now() - 7 * MS_PER_DAY).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: IDatabaseAdapter) => {
-                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: IDatabaseAdapter) => {
-                const entries = execQuery(
-                    db,
-                    `
-                    SELECT ${ENTRY_COLUMNS} 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: IDatabaseAdapter) => {
-                const recent = db.getRecentEntries(5)
-                const stats = db.getStatistics('week')
-
-                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: IDatabaseAdapter) => {
-                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: 'confirm-briefing',
-            description:
-                'Acknowledge session context received from memory://briefing to inform the user',
-            icons: [ICON_PROMPT],
-            arguments: [],
-            handler: (_args: Record<string, string>, db: IDatabaseAdapter) => {
-                const recent = db.getRecentEntries(3)
-                const stats = db.getStatistics('week')
-                const totalEntries = (stats as { totalEntries?: number }).totalEntries ?? 0
-
-                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.`,
-                            },
-                        },
-                    ],
-                }
-            },
-        },
-        {
-            name: 'session-summary',
-            description:
-                'Create a session summary entry capturing what was accomplished, pending items, and context for the next session',
-            icons: [ICON_PROMPT],
-            arguments: [],
-            handler: (_args: Record<string, string>, db: IDatabaseAdapter) => {
-                const recent = db.getRecentEntries(5)
-
-                const entrySummary =
-                    recent.length > 0
-                        ? recent
-                              .map(
-                                  (e) =>
-                                      `- #${String(e.id)} (${e.entryType}) ${e.content.slice(0, 80)}${e.content.length > 80 ? '...' : ''}`
-                              )
-                              .join('\n')
-                        : '- No entries yet'
-
-                return {
-                    messages: [
-                        {
-                            role: 'user',
-                            content: {
-                                type: 'text',
-                                text: `Create a session summary journal entry based on this context:
-
-**Recent Entries:**
-${entrySummary}
-
-**Instructions:**
-1. Summarize what was accomplished in this session (key changes, decisions, files modified)
-2. Note what's unfinished or blocked (pending items, open questions)
-3. Include context for the next session (relevant entry IDs, branch names, PR numbers)
-4. Use \`entry_type: "retrospective"\` and tag with \`session-summary\``,
-                            },
-                        },
-                    ],
-                }
-            },
-        },
-    ]
-}

package/src/handlers/resources/core/briefing/context-section.ts

@@ -1,182 +0,0 @@
-/**
- * Briefing — Context Section Builders
- *
- * Builds the journal, team, rules-file, and skills-directory
- * context sections for the briefing resource.
- */
-
-import * as fs from 'node:fs'
-import * as path from 'node:path'
-import type { BriefingConfig, ResourceContext } from '../../shared.js'
-import { logger } from '../../../../utils/logger.js'
-
-// ============================================================================
-// Journal Context
-// ============================================================================
-
-/** Content preview length for briefing entry summaries */
-const PREVIEW_LENGTH = 80
-
-export interface JournalContext {
-    totalEntries: number
-    latestEntries: { id: number; timestamp: string; type: string; preview: string }[]
-    lastModified: string
-}
-
-export function buildJournalContext(
-    context: ResourceContext,
-    config: BriefingConfig
-): JournalContext {
-    const recentEntries = context.db.getRecentEntries(config.entryCount)
-    const latestEntries = recentEntries.map((e) => {
-        const content = e.content ?? ''
-        return {
-            id: e.id,
-            timestamp: e.timestamp,
-            type: e.entryType,
-            preview:
-                content.slice(0, PREVIEW_LENGTH) + (content.length > PREVIEW_LENGTH ? '...' : ''),
-        }
-    })
-
-    const totalEntries = context.db.getActiveEntryCount()
-    const lastModified = recentEntries[0]?.timestamp ?? new Date().toISOString()
-
-    return { totalEntries, latestEntries, lastModified }
-}
-
-// ============================================================================
-// Team Context
-// ============================================================================
-
-/** Team DB preview length */
-const TEAM_PREVIEW_LENGTH = 60
-
-export interface TeamContext {
-    teamInfo: { totalEntries: number; latestPreview: string | null }
-    teamLatestEntries?: { id: number; timestamp: string; type: string; preview: string }[]
-}
-
-export function buildTeamContext(
-    context: ResourceContext,
-    config: BriefingConfig
-): TeamContext | undefined {
-    if (!context.teamDb) return undefined
-
-    try {
-        const teamTotalEntries = context.teamDb.getActiveEntryCount()
-        const teamRecent = context.teamDb.getRecentEntries(1)
-        const teamLatestEntry = teamRecent[0] as Record<string, unknown> | undefined
-        const teamContent = teamLatestEntry
-            ? ((teamLatestEntry['content'] as string | undefined) ?? '')
-            : ''
-        const teamLatest = teamLatestEntry
-            ? `#${String(teamLatestEntry['id'])}: ${teamContent.slice(0, TEAM_PREVIEW_LENGTH)}${teamContent.length > TEAM_PREVIEW_LENGTH ? '...' : ''}`
-            : null
-        const teamInfo = {
-            totalEntries: teamTotalEntries,
-            latestPreview: teamLatest,
-        }
-
-        let teamLatestEntries:
-            | { id: number; timestamp: string; type: string; preview: string }[]
-            | undefined = undefined
-
-        if (config.includeTeam) {
-            const teamEntries = context.teamDb.getRecentEntries(config.entryCount)
-            teamLatestEntries = teamEntries.map((e) => {
-                const content = e.content ?? ''
-                return {
-                    id: e.id,
-                    timestamp: e.timestamp,
-                    type: e.entryType,
-                    preview:
-                        content.slice(0, TEAM_PREVIEW_LENGTH) +
-                        (content.length > TEAM_PREVIEW_LENGTH ? '...' : ''),
-                }
-            })
-        }
-
-        return { teamInfo, teamLatestEntries }
-    } catch (error) {
-        logger.debug('Failed to build team context', {
-            module: 'BRIEFING',
-            operation: 'team-context',
-            error: error instanceof Error ? error.message : String(error),
-        })
-        return undefined
-    }
-}
-
-// ============================================================================
-// Rules & Skills Awareness
-// ============================================================================
-
-export interface RulesFile {
-    path: string
-    name: string
-    sizeKB: number
-    lastModified: string
-}
-
-export interface SkillsDir {
-    path: string
-    count: number
-    names: string[]
-}
-
-/** Milliseconds per hour / per day for age formatting */
-const MS_PER_HOUR = 3_600_000
-const MS_PER_DAY = 86_400_000
-
-export function buildRulesFileInfo(rulesFilePath: string | undefined): RulesFile | undefined {
-    if (!rulesFilePath) return undefined
-
-    try {
-        const stat = fs.statSync(rulesFilePath)
-        const ageMs = Date.now() - stat.mtimeMs
-        const ageHours = Math.floor(ageMs / MS_PER_HOUR)
-        const ageDays = Math.floor(ageMs / MS_PER_DAY)
-        const agoStr =
-            ageDays > 0
-                ? `${String(ageDays)}d ago`
-                : ageHours > 0
-                  ? `${String(ageHours)}h ago`
-                  : 'just now'
-
-        return {
-            path: rulesFilePath,
-            name: path.basename(rulesFilePath),
-            sizeKB: Math.round(stat.size / 1024),
-            lastModified: agoStr,
-        }
-    } catch (error) {
-        logger.debug('Failed to read rules file', {
-            module: 'BRIEFING',
-            operation: 'rules-file',
-            error: error instanceof Error ? error.message : String(error),
-        })
-        return undefined
-    }
-}
-
-export function buildSkillsDirInfo(skillsDirPath: string | undefined): SkillsDir | undefined {
-    if (!skillsDirPath) return undefined
-
-    try {
-        const entries = fs.readdirSync(skillsDirPath, { withFileTypes: true })
-        const skillDirs = entries.filter((e) => e.isDirectory())
-        return {
-            path: skillsDirPath,
-            count: skillDirs.length,
-            names: skillDirs.map((d) => d.name),
-        }
-    } catch (error) {
-        logger.debug('Failed to read skills directory', {
-            module: 'BRIEFING',
-            operation: 'skills-dir',
-            error: error instanceof Error ? error.message : String(error),
-        })
-        return undefined
-    }
-}