memory-journal-mcp 6.1.2 → 6.2.1

package/src/types/errors.ts

@@ -1,200 +0,0 @@
-/**
- * memory-journal-mcp — Base Error Classes
- *
- * Enriched error hierarchy with category, suggestion, recoverable,
- * and toResponse() for structured error handling.
- */
-
-import { ErrorCategory, type ErrorResponse } from './error-types.js'
-import { matchSuggestion, GENERIC_CODES } from '../utils/errors/suggestions.js'
-
-// =============================================================================
-// Base Error Options
-// =============================================================================
-
-interface ErrorOptions {
-    /** Actionable suggestion for resolving the error */
-    suggestion?: string
-
-    /** Whether the operation can be retried */
-    recoverable?: boolean
-
-    /** Additional structured context */
-    details?: Record<string, unknown>
-
-    /** Original cause error */
-    cause?: Error
-}
-
-// =============================================================================
-// Base Error Class
-// =============================================================================
-
-/**
- * Base error class for all memory-journal-mcp errors.
- * Provides structured error responses with category, suggestion,
- * and recoverable fields for agent-friendly error handling.
- *
- * Auto-refinement: when constructed with a generic code (e.g., QUERY_FAILED)
- * and the message matches a known pattern from ERROR_SUGGESTIONS, the code
- * is refined to a more specific value (e.g., TABLE_NOT_FOUND).
- */
-export class MemoryJournalMcpError extends Error {
-    /** Module-prefixed error code */
-    readonly code: string
-
-    /** Error category for programmatic handling */
-    readonly category: ErrorCategory
-
-    /** Actionable suggestion for resolving the error */
-    readonly suggestion?: string
-
-    /** Whether the operation can be retried */
-    readonly recoverable: boolean
-
-    /** Additional structured context */
-    readonly details?: Record<string, unknown>
-
-    constructor(message: string, code: string, category: ErrorCategory, options?: ErrorOptions) {
-        super(message, options?.cause ? { cause: options.cause } : undefined)
-        this.name = 'MemoryJournalMcpError'
-        this.category = category
-        this.recoverable = options?.recoverable ?? false
-        this.details = options?.details
-
-        // Auto-refinement: refine generic codes to specific ones via pattern matching
-        const matched = matchSuggestion(message)
-        if (GENERIC_CODES.has(code) && matched?.code) {
-            this.code = matched.code
-        } else {
-            this.code = code
-        }
-
-        // Apply suggestion: explicit > matched > none
-        this.suggestion = options?.suggestion ?? matched?.suggestion
-    }
-
-    /**
-     * Convert to a structured ErrorResponse for tool responses.
-     */
-    toResponse(): ErrorResponse {
-        return {
-            success: false,
-            error: this.message,
-            code: this.code,
-            category: this.category,
-            suggestion: this.suggestion,
-            recoverable: this.recoverable,
-            ...(this.details ? { details: this.details } : {}),
-        }
-    }
-}
-
-// =============================================================================
-// Database Errors
-// =============================================================================
-
-/**
- * Database connection or initialization error
- */
-export class ConnectionError extends MemoryJournalMcpError {
-    constructor(message: string, details?: Record<string, unknown>) {
-        super(message, 'CONNECTION_FAILED', ErrorCategory.CONNECTION, {
-            suggestion: 'Check database path and file permissions',
-            recoverable: true,
-            details,
-        })
-        this.name = 'ConnectionError'
-    }
-}
-
-/**
- * Query execution error
- */
-export class QueryError extends MemoryJournalMcpError {
-    constructor(message: string, details?: Record<string, unknown>) {
-        super(message, 'QUERY_FAILED', ErrorCategory.QUERY, {
-            suggestion: 'Check query parameters and database state',
-            recoverable: false,
-            details,
-        })
-        this.name = 'QueryError'
-    }
-}
-
-// =============================================================================
-// Validation Errors
-// =============================================================================
-
-/**
- * Input validation error (bad parameters, schema violations)
- */
-export class ValidationError extends MemoryJournalMcpError {
-    constructor(message: string, details?: Record<string, unknown>) {
-        super(message, 'VALIDATION_FAILED', ErrorCategory.VALIDATION, {
-            suggestion: 'Check input parameters against the tool schema',
-            recoverable: false,
-            details,
-        })
-        this.name = 'ValidationError'
-    }
-}
-
-// =============================================================================
-// Resource Errors
-// =============================================================================
-
-/**
- * Resource not found error
- */
-export class ResourceNotFoundError extends MemoryJournalMcpError {
-    constructor(resourceType: string, identifier: string) {
-        super(
-            `${resourceType} not found: ${identifier}`,
-            'RESOURCE_NOT_FOUND',
-            ErrorCategory.RESOURCE,
-            {
-                suggestion: `Verify the ${resourceType.toLowerCase()} identifier and try again`,
-                recoverable: false,
-                details: { resourceType, identifier },
-            }
-        )
-        this.name = 'ResourceNotFoundError'
-    }
-}
-
-// =============================================================================
-// Configuration Errors
-// =============================================================================
-
-/**
- * Server or service configuration error
- */
-export class ConfigurationError extends MemoryJournalMcpError {
-    constructor(message: string, details?: Record<string, unknown>) {
-        super(message, 'CONFIGURATION_ERROR', ErrorCategory.CONFIGURATION, {
-            suggestion: 'Check server configuration and environment variables',
-            recoverable: false,
-            details,
-        })
-        this.name = 'ConfigurationError'
-    }
-}
-
-// =============================================================================
-// Permission Errors
-// =============================================================================
-
-/**
- * File or database permission error
- */
-export class PermissionError extends MemoryJournalMcpError {
-    constructor(message: string, details?: Record<string, unknown>) {
-        super(message, 'PERMISSION_DENIED', ErrorCategory.PERMISSION, {
-            suggestion: 'Check file permissions and database access rights',
-            recoverable: false,
-            details,
-        })
-        this.name = 'PermissionError'
-    }
-}

package/src/types/filtering.ts

@@ -1,55 +0,0 @@
-/**
- * Memory Journal MCP Server - Tool Filtering Types
- */
-
-/**
- * Tool group identifiers for Memory Journal
- */
-export type ToolGroup =
-    | 'core' // Entry CRUD: create, get_by_id, get_recent, create_minimal, test_simple
-    | 'search' // Search: search_entries, search_by_date_range, semantic_search
-    | 'analytics' // Analytics: get_statistics, get_cross_project_insights
-    | 'relationships' // Relationships: link_entries, visualize_relationships
-    | 'export' // Export: export_entries
-    | 'admin' // Admin: update_entry, delete_entry
-    | 'github' // Reserved for future GitHub-specific tools
-    | 'backup' // Backup: backup_journal, list_backups, restore_backup
-    | 'team' // Team: team_create_entry, team_get_recent, team_search
-    | 'codemode' // Code Mode: mj_execute_code (sandboxed JS execution)
-
-/**
- * Meta-group identifiers for common multi-group selections
- */
-export type MetaGroup =
-    | 'starter' // core + search (~8 tools)
-    | 'essential' // core only (~5 tools)
-    | 'full' // all groups (~16 tools)
-    | 'readonly' // everything except admin
-
-/**
- * Tool filter rule
- */
-export interface ToolFilterRule {
-    /** Rule type: include or exclude */
-    type: 'include' | 'exclude'
-
-    /** Target: group name or tool name */
-    target: string
-
-    /** Whether target is a group (true) or individual tool (false) */
-    isGroup: boolean
-}
-
-/**
- * Parsed tool filter configuration
- */
-export interface ToolFilterConfig {
-    /** Original filter string */
-    raw: string
-
-    /** Parsed rules in order */
-    rules: ToolFilterRule[]
-
-    /** Set of enabled tool names after applying rules */
-    enabledTools: Set<string>
-}

package/src/types/github.ts

@@ -1,216 +0,0 @@
-/**
- * Memory Journal MCP Server - GitHub Integration Types
- */
-
-// ============================================================================
-// GitHub API Types
-// ============================================================================
-
-/**
- * GitHub project information
- */
-export interface GitHubProject {
-    number: number
-    title: string
-    url: string
-    state: 'OPEN' | 'CLOSED'
-}
-
-/**
- * GitHub issue information
- */
-export interface GitHubIssue {
-    number: number
-    title: string
-    url: string
-    state: 'OPEN' | 'CLOSED'
-    milestone?: { number: number; title: string } | null
-}
-
-/**
- * GitHub pull request information
- */
-export interface GitHubPullRequest {
-    number: number
-    title: string
-    url: string
-    state: 'OPEN' | 'CLOSED' | 'MERGED'
-}
-
-/**
- * GitHub milestone information
- */
-export interface GitHubMilestone {
-    number: number
-    title: string
-    description: string | null
-    state: 'open' | 'closed'
-    url: string
-    dueOn: string | null
-    openIssues: number
-    closedIssues: number
-    createdAt: string
-    updatedAt: string
-    creator: string | null
-}
-
-/**
- * GitHub workflow run information
- */
-export interface GitHubWorkflowRun {
-    id: number
-    name: string
-    status: 'queued' | 'in_progress' | 'completed'
-    conclusion: 'success' | 'failure' | 'cancelled' | 'skipped' | null
-    url: string
-    headBranch: string
-    headSha: string
-    createdAt: string
-    updatedAt: string
-}
-
-/**
- * GitHub PR review
- */
-export interface GitHubReview {
-    id: number
-    author: string
-    state: 'APPROVED' | 'CHANGES_REQUESTED' | 'COMMENTED' | 'DISMISSED' | 'PENDING'
-    body: string | null
-    submittedAt: string
-    isCopilot: boolean
-}
-
-/**
- * GitHub PR review comment (file-level)
- */
-export interface GitHubReviewComment {
-    id: number
-    author: string
-    body: string
-    path: string
-    line: number | null
-    side: 'LEFT' | 'RIGHT'
-    createdAt: string
-    isCopilot: boolean
-}
-
-/**
- * Copilot review summary for a PR
- */
-export interface CopilotReviewSummary {
-    prNumber: number
-    state: 'approved' | 'changes_requested' | 'commented' | 'none'
-    commentCount: number
-    comments: GitHubReviewComment[]
-}
-
-/**
- * Auto-captured project context
- */
-export interface ProjectContext {
-    repoName: string | null
-    branch: string | null
-    commit: string | null
-    remoteUrl: string | null
-    projects: GitHubProject[]
-    issues: GitHubIssue[]
-    pullRequests: GitHubPullRequest[]
-    workflowRuns: GitHubWorkflowRun[]
-    milestones: GitHubMilestone[]
-}
-
-// ============================================================================
-// Repository Insights/Traffic Types
-// ============================================================================
-
-/**
- * Repository statistics (stars, forks, watchers)
- */
-export interface RepoStats {
-    stars: number
-    forks: number
-    watchers: number
-    openIssues: number
-    size: number // KB
-    defaultBranch: string
-}
-
-/**
- * Aggregated traffic data (14-day rolling)
- */
-export interface TrafficData {
-    clones: { total: number; unique: number; dailyAvg: number }
-    views: { total: number; unique: number; dailyAvg: number }
-    period: string // e.g. "14 days"
-}
-
-/**
- * Traffic referrer source
- */
-export interface TrafficReferrer {
-    referrer: string
-    count: number
-    uniques: number
-}
-
-/**
- * Popular repository path
- */
-export interface PopularPath {
-    path: string
-    title: string
-    count: number
-    uniques: number
-}
-
-// ============================================================================
-// GitHub Projects v2 Kanban Types
-// ============================================================================
-
-/**
- * Status option for single-select field in Projects v2
- */
-export interface ProjectV2StatusOption {
-    id: string
-    name: string
-    color?: string
-}
-
-/**
- * Project item in a Kanban board
- */
-export interface ProjectV2Item {
-    id: string
-    title: string
-    url: string
-    type: 'ISSUE' | 'PULL_REQUEST' | 'DRAFT_ISSUE'
-    status: string | null
-    number?: number
-    labels?: string[]
-    assignees?: string[]
-    createdAt: string
-    updatedAt: string
-}
-
-/**
- * Kanban column (grouped by Status)
- */
-export interface KanbanColumn {
-    status: string
-    statusOptionId: string
-    items: ProjectV2Item[]
-}
-
-/**
- * Full Kanban board response
- */
-export interface KanbanBoard {
-    projectId: string
-    projectNumber: number
-    projectTitle: string
-    statusFieldId: string
-    statusOptions: ProjectV2StatusOption[]
-    columns: KanbanColumn[]
-    totalItems: number
-}