memory-journal-mcp 4.4.2 → 5.0.0

package/src/types/entities.ts

@@ -0,0 +1,145 @@
+/**
+ * Memory Journal MCP Server - Database Entity Types
+ */
+
+/**
+ * Entry types for journal entries
+ */
+export type EntryType =
+    | 'personal_reflection'
+    | 'project_decision'
+    | 'technical_achievement'
+    | 'bug_fix'
+    | 'feature_implementation'
+    | 'code_review'
+    | 'meeting_notes'
+    | 'learning'
+    | 'research'
+    | 'planning'
+    | 'retrospective'
+    | 'standup'
+    | 'technical_note'
+    | 'development_note'
+    | 'enhancement'
+    | 'milestone'
+    | 'system_integration_test'
+    | 'test_entry'
+    | 'other'
+
+/**
+ * Significance types for important entries
+ */
+export type SignificanceType =
+    | 'milestone'
+    | 'breakthrough'
+    | 'technical_breakthrough'
+    | 'decision'
+    | 'lesson_learned'
+    | 'blocker_resolved'
+    | 'release'
+    | null
+
+/**
+ * Relationship types between entries
+ *
+ * Standard types:
+ * - evolves_from: Entry builds upon previous work
+ * - references: Entry mentions or links to another
+ * - implements: Entry implements a spec/design
+ * - clarifies: Entry explains or clarifies another
+ * - response_to: Entry responds to a question/issue
+ *
+ * Causal types (for decision tracing):
+ * - blocked_by: Entry was blocked by another (e.g., blocker → resolution)
+ * - resolved: Entry resolved/fixed an issue from another
+ * - caused: Entry caused or led to another outcome
+ */
+export type RelationshipType =
+    | 'evolves_from'
+    | 'references'
+    | 'implements'
+    | 'clarifies'
+    | 'response_to'
+    | 'blocked_by'
+    | 'resolved'
+    | 'caused'
+
+/**
+ * Journal entry entity
+ */
+export interface JournalEntry {
+    id: number
+    entryType: EntryType
+    content: string
+    timestamp: string
+    isPersonal: boolean
+    significanceType: SignificanceType
+    autoContext: string | null
+    deletedAt: string | null
+    tags: string[]
+    // GitHub integration fields
+    projectNumber?: number | null
+    projectOwner?: string | null
+    issueNumber?: number | null
+    issueUrl?: string | null
+    prNumber?: number | null
+    prUrl?: string | null
+    prStatus?: string | null
+    workflowRunId?: number | null
+    workflowName?: string | null
+    workflowStatus?: string | null
+}
+
+/**
+ * Tag entity
+ */
+export interface Tag {
+    id: number
+    name: string
+    usageCount: number
+}
+
+/**
+ * Relationship entity
+ */
+export interface Relationship {
+    id: number
+    fromEntryId: number
+    toEntryId: number
+    relationshipType: RelationshipType
+    description: string | null
+    createdAt: string
+}
+
+/**
+ * Embedding entity for vector search
+ */
+export interface Embedding {
+    entryId: number
+    embedding: Float32Array
+    modelName: string
+}
+
+/**
+ * Importance scoring breakdown showing weighted component contributions
+ */
+export interface ImportanceBreakdown {
+    /** Significance type contribution (weight: 0.30) */
+    significance: number
+    /** Relationship count contribution (weight: 0.35) */
+    relationships: number
+    /** Causal relationship contribution (weight: 0.20) */
+    causal: number
+    /** Recency decay contribution (weight: 0.15) */
+    recency: number
+}
+
+/**
+ * Importance calculation result with total score and component breakdown
+ */
+export interface ImportanceResult {
+    /** Total importance score (0.0-1.0) */
+    score: number
+    /** Weighted component contributions */
+    breakdown: ImportanceBreakdown
+}

package/src/types/filtering.ts

@@ -0,0 +1,54 @@
+/**
+ * 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
+
+/**
+ * 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

@@ -0,0 +1,180 @@
+/**
+ * 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
+}
+
+/**
+ * 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
+}