memory-journal-mcp 6.1.2 → 6.2.1

package/src/handlers/resources/index.ts

@@ -1,143 +0,0 @@
-/**
- * Memory Journal MCP Server - Resource Handlers
- *
- * Barrel file composing resource definitions from sub-modules.
- * Exports all MCP resources with annotations following MCP 2025-11-25 spec.
- */
-
-import type { VectorSearchManager } from '../../vector/vector-search-manager.js'
-import type { ToolFilterConfig } from '../../filtering/tool-filter.js'
-import type { GitHubIntegration } from '../../github/github-integration/index.js'
-import type { Scheduler } from '../../server/scheduler.js'
-import type { IDatabaseAdapter } from '../../database/core/interfaces.js'
-import type { BriefingConfig } from './shared.js'
-
-// Re-export shared types
-export type { ResourceContext, ResourceResult, InternalResourceDef } from './shared.js'
-
-// Import sub-module definitions
-import { getCoreResourceDefinitions } from './core/index.js'
-import { getGraphResourceDefinitions } from './graph.js'
-import { getGitHubResourceDefinitions } from './github.js'
-import { getTemplateResourceDefinitions } from './templates.js'
-import { getTeamResourceDefinitions } from './team.js'
-import { getHelpResourceDefinitions } from './help.js'
-import type { InternalResourceDef, ResourceResult } from './shared.js'
-import { ResourceNotFoundError } from '../../types/errors.js'
-
-/**
- * Get all resource definitions for MCP list
- */
-export function getResources(): object[] {
-    const resources = getAllResourceDefinitions()
-    return resources.map((r) => ({
-        uri: r.uri,
-        name: r.name,
-        description: r.description,
-        mimeType: r.mimeType,
-        annotations: r.annotations,
-        icons: r.icons,
-    }))
-}
-
-/**
- * Check if a result is a ResourceResult with annotations
- */
-function isResourceResult(result: unknown): result is ResourceResult {
-    return (
-        result !== null &&
-        typeof result === 'object' &&
-        'data' in result &&
-        (result as Record<string, unknown>)['data'] !== undefined
-    )
-}
-
-/**
- * Extract base URI without query parameters for matching
- */
-function getBaseUri(uri: string): string {
-    // Handle memory:// URIs specially since URL parser treats the path as host
-    if (uri.startsWith('memory://')) {
-        const withoutScheme = uri.slice('memory://'.length)
-        const queryIndex = withoutScheme.indexOf('?')
-        const hashIndex = withoutScheme.indexOf('#')
-
-        // Find first delimiter (query or hash)
-        let endIndex = withoutScheme.length
-        if (queryIndex !== -1 && queryIndex < endIndex) endIndex = queryIndex
-        if (hashIndex !== -1 && hashIndex < endIndex) endIndex = hashIndex
-
-        return 'memory://' + withoutScheme.slice(0, endIndex)
-    }
-
-    // Fallback for other URI schemes
-    try {
-        const url = new URL(uri)
-        return `${url.protocol}//${url.host}${url.pathname}`
-    } catch {
-        // Invalid URL, return original
-        return uri
-    }
-}
-
-/**
- * Read a resource by URI - returns data and optional annotations
- */
-export async function readResource(
-    uri: string,
-    db: IDatabaseAdapter,
-    vectorManager?: VectorSearchManager,
-    filterConfig?: ToolFilterConfig | null,
-    github?: GitHubIntegration | null,
-    scheduler?: Scheduler | null,
-    teamDb?: IDatabaseAdapter,
-    briefingConfig?: BriefingConfig
-): Promise<{ data: unknown; annotations?: { lastModified?: string } }> {
-    const resources = getAllResourceDefinitions()
-    const context = { db, teamDb, vectorManager, filterConfig, github, scheduler, briefingConfig }
-
-    // Strip query parameters for matching, but pass full URI to handler
-    const baseUri = getBaseUri(uri)
-
-    // Check for exact match first (using base URI without query params)
-    const exactMatch = resources.find((r) => r.uri === baseUri)
-    if (exactMatch) {
-        // Pass full URI (with query params) to handler so it can parse them
-        const result = await Promise.resolve(exactMatch.handler(uri, context))
-        if (isResourceResult(result)) {
-            return { data: result.data, annotations: result.annotations }
-        }
-        return { data: result }
-    }
-
-    // Check for template matches (also use base URI)
-    for (const resource of resources) {
-        if (resource.uri.includes('{')) {
-            const pattern = resource.uri.replace(/\{[^}]+\}/g, '([^/]+)')
-            const regex = new RegExp(`^${pattern}$`)
-            if (regex.test(baseUri)) {
-                const result = await Promise.resolve(resource.handler(uri, context))
-                if (isResourceResult(result)) {
-                    return { data: result.data, annotations: result.annotations }
-                }
-                return { data: result }
-            }
-        }
-    }
-
-    throw new ResourceNotFoundError('Resource', uri)
-}
-
-/**
- * Get all resource definitions by composing sub-module definitions
- */
-function getAllResourceDefinitions(): InternalResourceDef[] {
-    return [
-        ...getCoreResourceDefinitions(),
-        ...getGraphResourceDefinitions(),
-        ...getGitHubResourceDefinitions(),
-        ...getTemplateResourceDefinitions(),
-        ...getTeamResourceDefinitions(),
-        ...getHelpResourceDefinitions(),
-    ]
-}

package/src/handlers/resources/shared.ts

@@ -1,219 +0,0 @@
-/**
- * Memory Journal MCP Server - Resource Shared Types & Helpers
- *
- * Shared types, helpers, and utilities used by all resource group modules.
- */
-
-import type { IDatabaseAdapter } from '../../database/core/interfaces.js'
-import type { VectorSearchManager } from '../../vector/vector-search-manager.js'
-import type { ToolFilterConfig } from '../../filtering/tool-filter.js'
-import type { McpIcon } from '../../types/index.js'
-import type { GitHubIntegration } from '../../github/github-integration/index.js'
-import type { Scheduler } from '../../server/scheduler.js'
-
-// ============================================================================
-// GitHub Resource Guard
-// ============================================================================
-
-/** Successful result from resolveGitHubRepo */
-export interface GitHubRepoResolved {
-    owner: string
-    repo: string
-    branch: string | null
-    lastModified: string
-    /** Narrowed non-null reference — safe to use without `!` after guard */
-    github: GitHubIntegration
-}
-
-/**
- * Resolve GitHub owner/repo or return a ResourceResult error.
- *
- * Encapsulates the three-step guard pattern used by all GitHub resource
- * handlers: check github integration → getRepoInfo → validate owner/repo.
- *
- * @returns Resolved repo info, or a ResourceResult error to return directly
- */
-export async function resolveGitHubRepo(
-    github: GitHubIntegration | null | undefined
-): Promise<GitHubRepoResolved | ResourceResult> {
-    const lastModified = new Date().toISOString()
-
-    if (!github) {
-        return {
-            data: {
-                error: 'GitHub integration not available',
-                hint: 'Set GITHUB_TOKEN and GITHUB_REPO_PATH environment variables.',
-            },
-            annotations: { lastModified },
-        }
-    }
-
-    const repoInfo = await github.getRepoInfo()
-    const owner = repoInfo.owner
-    const repo = repoInfo.repo
-
-    if (!owner || !repo) {
-        return {
-            data: {
-                error: 'Could not detect repository',
-                hint: 'Set GITHUB_REPO_PATH to your git repository.',
-                ...(repoInfo.branch ? { branch: repoInfo.branch } : {}),
-            },
-            annotations: { lastModified },
-        }
-    }
-
-    return { owner, repo, branch: repoInfo.branch ?? null, lastModified, github }
-}
-
-/**
- * Type guard: returns true if the result is a ResourceResult error.
- */
-export function isResourceError(
-    result: GitHubRepoResolved | ResourceResult
-): result is ResourceResult {
-    return 'data' in result
-}
-
-/**
- * Configuration for the memory://briefing resource.
- * All values have sensible defaults — users opt-in via env vars or CLI flags.
- */
-export interface BriefingConfig {
-    /** Number of recent journal entries to include (default: 3) */
-    entryCount: number
-    /** Include team DB entries in briefing preview (default: false) */
-    includeTeam: boolean
-    /** Number of open issues to list with titles; 0 = count only (default: 0) */
-    issueCount: number
-    /** Number of PRs to list with titles; 0 = count only (default: 0) */
-    prCount: number
-    /** Show PR status breakdown (open/merged/closed) instead of simple count (default: false) */
-    prStatusBreakdown: boolean
-    /** Path to the user's rules file (e.g., .gemini/GEMINI.md) for awareness in briefing */
-    rulesFilePath?: string
-    /** Path to the user's skills directory for awareness in briefing */
-    skillsDirPath?: string
-    /** Number of recent workflow runs to list; 0 = latest-only status (default: 0) */
-    workflowCount: number
-    /** Show workflow run status breakdown (passing/failing/pending) (default: false) */
-    workflowStatusBreakdown: boolean
-    /** Aggregate Copilot review state across recent PRs in briefing (default: false) */
-    copilotReviews: boolean
-    /** Workflow summary string for the memory://workflows resource (env: MEMORY_JOURNAL_WORKFLOW_SUMMARY) */
-    workflowSummary?: string
-    /** Default GitHub Project number for Kanban resources and issue tools (env: DEFAULT_PROJECT_NUMBER) */
-    defaultProjectNumber?: number
-}
-
-/** Default briefing configuration — preserves pre-existing behavior */
-export const DEFAULT_BRIEFING_CONFIG: BriefingConfig = {
-    entryCount: 3,
-    includeTeam: false,
-    issueCount: 0,
-    prCount: 0,
-    prStatusBreakdown: false,
-    workflowCount: 0,
-    workflowStatusBreakdown: false,
-    copilotReviews: false,
-}
-
-/**
- * Resource context for handlers that need extended access
- */
-export interface ResourceContext {
-    db: IDatabaseAdapter
-    teamDb?: IDatabaseAdapter
-    vectorManager?: VectorSearchManager
-    filterConfig?: ToolFilterConfig | null
-    github?: GitHubIntegration | null
-    scheduler?: Scheduler | null
-    briefingConfig?: BriefingConfig
-}
-
-/**
- * Resource handler result with optional annotations for MCP 2025-11-25
- */
-export interface ResourceResult {
-    data: unknown
-    annotations?: {
-        lastModified?: string // ISO 8601 timestamp
-    }
-}
-
-/**
- * Internal resource definition with db handler
- */
-export interface InternalResourceDef {
-    uri: string
-    name: string
-    title: string
-    description: string
-    mimeType: string
-    icons?: McpIcon[] // MCP 2025-11-25 icons
-    annotations?: {
-        audience?: ('user' | 'assistant')[]
-        priority?: number
-        lastModified?: string
-        autoRead?: boolean
-        sessionInit?: boolean
-    }
-    handler: (uri: string, context: ResourceContext) => unknown
-}
-
-/**
- * Execute a raw SQL query on the database
- */
-export function execQuery(
-    db: IDatabaseAdapter,
-    sql: string,
-    params: unknown[] = []
-): Record<string, unknown>[] {
-    const result = db.executeRawQuery(sql, params)
-    if (result.length === 0) return []
-
-    const columns = result[0]?.columns ?? []
-    return (result[0]?.values ?? []).map((values: unknown[]) => {
-        const obj: Record<string, unknown> = {}
-        columns.forEach((col: string, i: number) => {
-            obj[col] = values[i]
-        })
-        return obj
-    })
-}
-
-/**
- * Transform snake_case SQL row to camelCase entry object
- * Ensures consistency with SqliteAdapter.getRecentEntries() output
- */
-export function transformEntryRow(row: Record<string, unknown>): Record<string, unknown> {
-    return {
-        id: row['id'],
-        entryType: row['entry_type'],
-        content: row['content'],
-        timestamp: row['timestamp'],
-        isPersonal: row['is_personal'] === 1 || row['is_personal'] === true,
-        significanceType: row['significance_type'] ?? null,
-        autoContext: row['auto_context'] ?? null,
-        deletedAt: row['deleted_at'] ?? null,
-        projectNumber: row['project_number'] ?? null,
-        projectOwner: row['project_owner'] ?? null,
-        issueNumber: row['issue_number'] ?? null,
-        issueUrl: row['issue_url'] ?? null,
-        prNumber: row['pr_number'] ?? null,
-        prUrl: row['pr_url'] ?? null,
-        prStatus: row['pr_status'] ?? null,
-        workflowRunId: row['workflow_run_id'] ?? null,
-        workflowName: row['workflow_name'] ?? null,
-        workflowStatus: row['workflow_status'] ?? null,
-    }
-}
-
-/**
- * Calculate milestone completion percentage from open/closed issue counts.
- * Shared helper to avoid duplicated logic across resource handlers.
- */
-export function milestoneCompletionPct(openIssues: number, closedIssues: number): number {
-    const total = openIssues + closedIssues
-    return total > 0 ? Math.round((closedIssues / total) * 100) : 0
-}

package/src/handlers/resources/team.ts

@@ -1,134 +0,0 @@
-/**
- * Team Resource Definitions - 2 resources
- *
- * Resources: memory://team/recent, memory://team/statistics
- *
- * Requires TEAM_DB_PATH to be configured.
- */
-
-import { ICON_CLOCK, ICON_TEAM } from '../../constants/icons.js'
-import {
-    withPriority,
-    ASSISTANT_FOCUSED,
-    MEDIUM_PRIORITY,
-} from '../../utils/resource-annotations.js'
-import type { InternalResourceDef, ResourceContext, ResourceResult } from './shared.js'
-
-// ============================================================================
-// Helpers
-// ============================================================================
-
-/**
- * Enrich entries with author column from the team database
- */
-function enrichWithAuthor<T extends { id: number }>(
-    entries: T[],
-    context: ResourceContext
-): (T & { author: string | null })[] {
-    const teamDb = context.teamDb
-    if (!teamDb) return entries.map((e: T) => ({ ...e, author: null }))
-    return entries.map((e: T) => {
-        const authorResult = teamDb.executeRawQuery(
-            'SELECT author FROM memory_journal WHERE id = ?',
-            [e.id]
-        )
-        const author = (authorResult[0]?.values[0]?.[0] as string) ?? null
-        return { ...e, author }
-    })
-}
-
-// ============================================================================
-// Resource Definitions
-// ============================================================================
-
-/**
- * Get team resource definitions
- */
-export function getTeamResourceDefinitions(): InternalResourceDef[] {
-    return [
-        {
-            uri: 'memory://team/recent',
-            name: 'Recent Team Entries',
-            title: 'Recent Team-Shared Entries',
-            description:
-                'Recent entries from the team database. Requires TEAM_DB_PATH configuration.',
-            mimeType: 'application/json',
-            icons: [ICON_CLOCK],
-            annotations: withPriority(0.7, ASSISTANT_FOCUSED),
-            handler: (_uri: string, context: ResourceContext): ResourceResult => {
-                if (!context.teamDb) {
-                    return {
-                        data: {
-                            error: 'Team database not configured. Set TEAM_DB_PATH to enable.',
-                            entries: [],
-                            count: 0,
-                        },
-                    }
-                }
-
-                const entries = context.teamDb.getRecentEntries(10)
-                const lastModified = entries[0]?.timestamp ?? new Date().toISOString()
-                const enriched = enrichWithAuthor(entries, context)
-
-                return {
-                    data: {
-                        entries: enriched,
-                        count: enriched.length,
-                        source: 'team',
-                    },
-                    annotations: { lastModified },
-                }
-            },
-        },
-        {
-            uri: 'memory://team/statistics',
-            name: 'Team Statistics',
-            title: 'Team Database Statistics',
-            description: 'Entry counts, types, and contributor breakdown for the team database.',
-            mimeType: 'application/json',
-            icons: [ICON_TEAM],
-            annotations: { ...MEDIUM_PRIORITY, audience: ['assistant'] },
-            handler: (_uri: string, context: ResourceContext): ResourceResult => {
-                if (!context.teamDb) {
-                    return {
-                        data: {
-                            error: 'Team database not configured. Set TEAM_DB_PATH to enable.',
-                            configured: false,
-                        },
-                    }
-                }
-
-                const stats = context.teamDb.getStatistics('week')
-
-                // Author breakdown
-                let authors: { author: string; count: number }[] = []
-                try {
-                    const authorResult = context.teamDb.executeRawQuery(
-                        `SELECT COALESCE(author, 'unknown') as author, COUNT(*) as count
-                         FROM memory_journal
-                         WHERE deleted_at IS NULL
-                         GROUP BY COALESCE(author, 'unknown')
-                         ORDER BY count DESC`
-                    )
-                    if (authorResult[0]) {
-                        authors = authorResult[0].values.map((row: unknown[]) => ({
-                            author: row[0] as string,
-                            count: row[1] as number,
-                        }))
-                    }
-                } catch {
-                    // Author column may not exist yet
-                }
-
-                return {
-                    data: {
-                        configured: true,
-                        ...(stats as object),
-                        authors,
-                        source: 'team',
-                    },
-                }
-            },
-        },
-    ]
-}