memory-journal-mcp 7.4.0 → 7.6.0

package/dist/index.d.ts

@@ -1,3 +1,148 @@
+/** Audit log configuration */
+interface AuditConfig {
+    /** Master switch — false means no interceptor is created */
+    enabled: boolean;
+    /** Absolute path to the JSONL output file, or "stderr" for container mode */
+    logPath: string;
+    /** When true, tool arguments are omitted from entries */
+    redact: boolean;
+    /** When true, read-scoped tools are also logged (default: false) */
+    auditReads: boolean;
+    /** Maximum log file size in bytes before rotation (default: 10MB). 0 = no rotation. */
+    maxSizeBytes: number;
+}
+
+/**
+ * Memory Journal MCP Server - Tool Filtering
+ *
+ * Configurable tool filtering system with groups and meta-groups.
+ * Matches mysql-mcp filtering syntax and patterns.
+ */
+
+/**
+ * Tool group definitions mapping group names to tool names
+ *
+ * All 70 tools are categorized here for filtering support.
+ */
+declare const TOOL_GROUPS: Record<ToolGroup, string[]>;
+/**
+ * Meta-group definitions mapping shortcuts to groups
+ */
+declare const META_GROUPS: Record<MetaGroup, ToolGroup[]>;
+/**
+ * Get all tool names across all groups
+ */
+declare function getAllToolNames(): string[];
+/**
+ * Get the group for a specific tool
+ */
+declare function getToolGroup(toolName: string): ToolGroup | undefined;
+/**
+ * Parse a tool filter string into configuration
+ *
+ * Syntax:
+ * - `starter` - Use starter preset (whitelist mode)
+ * - `core,search` - Enable specific groups (whitelist mode)
+ * - `full,-admin` - All tools except admin group
+ * - `starter,-delete_entry` - Starter without specific tool
+ * - `+semantic_search` - Add specific tool to current set
+ */
+declare function parseToolFilter(filterString: string): ToolFilterConfig;
+/**
+ * Check if a tool is enabled based on filter string
+ */
+declare function isToolEnabled(toolName: string, filterConfig: ToolFilterConfig): boolean;
+/**
+ * Filter tools array based on filter configuration
+ */
+declare function filterTools<T extends {
+    name: string;
+}>(tools: T[], filterConfig: ToolFilterConfig): T[];
+/**
+ * Get tool filter from environment variable
+ */
+declare function getToolFilterFromEnv(): ToolFilterConfig | null;
+/**
+ * Calculate token savings from filtering
+ */
+declare function calculateTokenSavings(totalTools: number, enabledTools: number, avgTokensPerTool?: number): {
+    reduction: number;
+    savedTokens: number;
+};
+/**
+ * Get human-readable filter summary
+ */
+declare function getFilterSummary(filterConfig: ToolFilterConfig): string;
+
+/**
+ * Memory Journal MCP Server - Scheduler
+ *
+ * Lightweight in-process scheduler for periodic maintenance jobs.
+ * Only meaningful for HTTP/SSE transport (long-lived server processes).
+ * Uses setInterval for simplicity — no external dependencies.
+ */
+
+/** Scheduler configuration options */
+interface SchedulerOptions {
+    /** Automated backup interval in minutes (0 = disabled) */
+    backupIntervalMinutes: number;
+    /** Max backups to retain during automated cleanup */
+    keepBackups: number;
+    /** Database optimize interval in minutes (0 = disabled) */
+    vacuumIntervalMinutes: number;
+    /** Vector index rebuild interval in minutes (0 = disabled) */
+    rebuildIndexIntervalMinutes: number;
+    /** Analytics digest interval in minutes (0 = disabled; recommended: 1440 for daily) */
+    digestIntervalMinutes: number;
+}
+
+/**
+ * Memory Journal MCP Server - Resource Shared Types & Helpers
+ *
+ * Shared types, helpers, and utilities used by all resource group modules.
+ */
+
+/**
+ * Configuration for the memory://briefing resource.
+ * All values have sensible defaults — users opt-in via env vars or CLI flags.
+ */
+interface BriefingConfig {
+    /** Number of recent journal entries to include (default: 3) */
+    entryCount: number;
+    /** Number of recent session summaries to display (default: 1) */
+    summaryCount?: 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;
+    /** Number of milestones to list in briefing; 0 = hide (default: 3) */
+    milestoneCount?: number;
+    /** 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;
+    /** Project registry mapping dynamic repo IDs to local paths and kanban boards */
+    projectRegistry?: Record<string, ProjectRegistryEntry>;
+    /** Hush Protocol flag vocabulary passed from CLI/env */
+    flagVocabulary?: string[];
+    /** Allowlisted directory roots for strict filesystem jailing of agent read access */
+    allowedIoRoots?: string[];
+}
+
 /**
  * Memory Journal MCP Server - Tool Filtering Types
  */
@@ -38,7 +183,7 @@ interface ToolFilterConfig {
 /**
  * Entry types for journal entries
  */
-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';
+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' | 'flag' | 'system_integration_test' | 'test_entry' | 'other';
 /**
  * Significance types for important entries
  */
@@ -82,6 +227,7 @@ interface JournalEntry {
     workflowRunId?: number | null;
     workflowName?: string | null;
     workflowStatus?: string | null;
+    importanceScore?: number;
 }
 /**
  * Tag entity
@@ -210,6 +356,7 @@ interface ProjectContext {
     pullRequests: GitHubPullRequest[];
     workflowRuns: GitHubWorkflowRun[];
     milestones: GitHubMilestone[];
+    degraded?: string[];
 }
 
 /**
@@ -263,6 +410,12 @@ interface ToolDefinition {
     outputSchema?: unknown;
     /** Behavioral hints for AI clients */
     annotations: ToolAnnotations;
+    /** Security capabilities required to execute this tool */
+    capabilities?: {
+        requiresTeamScope?: boolean;
+        requiresAdminScope?: boolean;
+        mutatesState?: boolean;
+    };
     /** Tool handler function */
     handler: (params: unknown) => unknown;
 }
@@ -270,6 +423,7 @@ interface ProjectRegistryEntry {
     path: string;
     project_number?: number;
 }
+
 /**
  * Resource definition for MCP
  */
@@ -286,6 +440,11 @@ interface ResourceDefinition {
     mimeType: string;
     /** Resource metadata annotations */
     annotations?: ResourceAnnotations;
+    /** Security capabilities required to read this resource */
+    capabilities?: {
+        requiresTeamScope?: boolean;
+        requiresAdminScope?: boolean;
+    };
     /** Resource handler - NOTE: db is passed at runtime, not in the definition */
     handler: (uri: string) => Promise<unknown>;
 }
@@ -330,6 +489,8 @@ interface ServerConfig {
     modelName: string;
     /** Briefing depth for AI client instructions */
     instructionLevel?: 'essential' | 'standard' | 'full';
+    /** Hush Protocol flag vocabulary (defaults: blocker, needs_review, help_requested, fyi) */
+    flagVocabulary?: string[];
 }
 /**
  * Default configuration values
@@ -364,12 +525,9 @@ interface CreateEntryInput {
     workflowRunId?: number;
     workflowName?: string;
     workflowStatus?: 'queued' | 'in_progress' | 'completed';
+    author?: string;
 }
 
-interface QueryResult {
-    columns: string[];
-    values: unknown[][];
-}
 /**
  * The public facade representing the capabilities of any memory-journal DB adapter
  */
@@ -382,6 +540,10 @@ interface IDatabaseAdapter {
     getEntryById(id: number): JournalEntry | null;
     getEntryByIdIncludeDeleted(id: number): JournalEntry | null;
     getEntriesByIds(ids: number[]): Map<number, JournalEntry>;
+    getEntriesByIdsWithImportance(ids: number[]): Map<number, {
+        entry: JournalEntry;
+        importance: ImportanceResult;
+    }>;
     calculateImportance(entryId: number): ImportanceResult;
     getRecentEntries(limit?: number, isPersonal?: boolean, sortBy?: 'timestamp' | 'importance'): JournalEntry[];
     getEntriesPage(offset: number, limit: number): JournalEntry[];
@@ -391,6 +553,18 @@ interface IDatabaseAdapter {
         entryType?: EntryType;
         tags?: string[];
         isPersonal?: boolean;
+        significanceType?: string;
+        autoContext?: string | null;
+        projectNumber?: number;
+        projectOwner?: string;
+        issueNumber?: number;
+        issueUrl?: string;
+        prNumber?: number;
+        prUrl?: string;
+        prStatus?: string;
+        workflowRunId?: number;
+        workflowName?: string;
+        workflowStatus?: string;
     }): JournalEntry | null;
     deleteEntry(id: number, permanent?: boolean): boolean;
     searchEntries(query: string, options?: {
@@ -419,7 +593,13 @@ interface IDatabaseAdapter {
         sortBy?: 'timestamp' | 'importance';
     }): JournalEntry[];
     getStatistics(groupBy?: 'day' | 'week' | 'month' | 'year', startDate?: string, endDate?: string, projectBreakdown?: boolean): Record<string, unknown>;
+    getAuthorStatistics(): {
+        author: string;
+        count: number;
+    }[];
+    getAuthorsForEntries(entryIds: number[]): Map<number, string | null>;
     getTagsForEntry(entryId: number): string[];
+    getTagsForEntries(entryIds: number[]): Map<number, string[]>;
     listTags(): Tag[];
     mergeTags(sourceTag: string, targetTag: string): {
         entriesUpdated: number;
@@ -427,6 +607,7 @@ interface IDatabaseAdapter {
     };
     linkEntries(fromEntryId: number, toEntryId: number, relationshipType: RelationshipType, description?: string): Relationship;
     getRelationships(entryId: number): Relationship[];
+    getRelationshipsForEntries(entryIds: number[]): Map<number, Relationship[]>;
     getBackupsDir(): string;
     exportToFile(backupName?: string): Promise<{
         filename: string;
@@ -443,7 +624,7 @@ interface IDatabaseAdapter {
         deleted: string[];
         kept: number;
     };
-    restoreFromFile(filename: string): Promise<{
+    restoreFromFile(filename: string, runtime?: unknown): Promise<{
         restoredFrom: string;
         previousEntryCount: number;
         newEntryCount: number;
@@ -467,9 +648,6 @@ interface IDatabaseAdapter {
             } | null;
         };
     };
-    getRawDb(): unknown;
-    pragma(command: string): void;
-    executeRawQuery(sql: string, params?: unknown[]): QueryResult[];
     saveAnalyticsSnapshot(type: string, data: Record<string, unknown>): number;
     getLatestAnalyticsSnapshot(type: string): {
         id: number;
@@ -481,157 +659,85 @@ interface IDatabaseAdapter {
         createdAt: string;
         data: Record<string, unknown>;
     }[];
-}
-
-/**
- * Memory Journal MCP Server - Scheduler
- *
- * Lightweight in-process scheduler for periodic maintenance jobs.
- * Only meaningful for HTTP/SSE transport (long-lived server processes).
- * Uses setInterval for simplicity — no external dependencies.
- */
-
-/** Scheduler configuration options */
-interface SchedulerOptions {
-    /** Automated backup interval in minutes (0 = disabled) */
-    backupIntervalMinutes: number;
-    /** Max backups to retain during automated cleanup */
-    keepBackups: number;
-    /** Database optimize interval in minutes (0 = disabled) */
-    vacuumIntervalMinutes: number;
-    /** Vector index rebuild interval in minutes (0 = disabled) */
-    rebuildIndexIntervalMinutes: number;
-    /** Analytics digest interval in minutes (0 = disabled; recommended: 1440 for daily) */
-    digestIntervalMinutes: number;
-}
-
-/**
- * memory-journal-mcp - Sandbox Factory
- *
- * Mode selection factory for choosing between VM and Worker sandboxes.
- * Allows runtime configuration of the sandbox mode.
- */
-
-/** Available sandbox modes */
-type SandboxMode = 'vm' | 'worker';
-
-/**
- * Memory Journal MCP Server - Tool Filtering
- *
- * Configurable tool filtering system with groups and meta-groups.
- * Matches mysql-mcp filtering syntax and patterns.
- */
-
-/**
- * Tool group definitions mapping group names to tool names
- *
- * All 68 tools are categorized here for filtering support.
- */
-declare const TOOL_GROUPS: Record<ToolGroup, string[]>;
-/**
- * Meta-group definitions mapping shortcuts to groups
- */
-declare const META_GROUPS: Record<MetaGroup, ToolGroup[]>;
-/**
- * Get all tool names across all groups
- */
-declare function getAllToolNames(): string[];
-/**
- * Get the group for a specific tool
- */
-declare function getToolGroup(toolName: string): ToolGroup | undefined;
-/**
- * Parse a tool filter string into configuration
- *
- * Syntax:
- * - `starter` - Use starter preset (whitelist mode)
- * - `core,search` - Enable specific groups (whitelist mode)
- * - `full,-admin` - All tools except admin group
- * - `starter,-delete_entry` - Starter without specific tool
- * - `+semantic_search` - Add specific tool to current set
- */
-declare function parseToolFilter(filterString: string): ToolFilterConfig;
-/**
- * Check if a tool is enabled based on filter string
- */
-declare function isToolEnabled(toolName: string, filterConfig: ToolFilterConfig): boolean;
-/**
- * Filter tools array based on filter configuration
- */
-declare function filterTools<T extends {
-    name: string;
-}>(tools: T[], filterConfig: ToolFilterConfig): T[];
-/**
- * Get tool filter from environment variable
- */
-declare function getToolFilterFromEnv(): ToolFilterConfig | null;
-/**
- * Calculate token savings from filtering
- */
-declare function calculateTokenSavings(totalTools: number, enabledTools: number, avgTokensPerTool?: number): {
-    reduction: number;
-    savedTokens: number;
-};
-/**
- * Get human-readable filter summary
- */
-declare function getFilterSummary(filterConfig: ToolFilterConfig): string;
-
-/**
- * Memory Journal MCP Server - Resource Shared Types & Helpers
- *
- * Shared types, helpers, and utilities used by all resource group modules.
- */
-
-/**
- * Configuration for the memory://briefing resource.
- * All values have sensible defaults — users opt-in via env vars or CLI flags.
- */
-interface BriefingConfig {
-    /** Number of recent journal entries to include (default: 3) */
-    entryCount: number;
-    /** Number of recent session summaries to display (default: 1) */
-    summaryCount?: 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;
-    /** Number of milestones to list in briefing; 0 = hide (default: 3) */
-    milestoneCount?: number;
-    /** 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;
-    /** Project registry mapping dynamic repo IDs to local paths and kanban boards */
-    projectRegistry?: Record<string, ProjectRegistryEntry>;
-}
-
-/** Audit log configuration */
-interface AuditConfig {
-    /** Master switch — false means no interceptor is created */
-    enabled: boolean;
-    /** Absolute path to the JSONL output file, or "stderr" for container mode */
-    logPath: string;
-    /** When true, tool arguments are omitted from entries */
-    redact: boolean;
-    /** When true, read-scoped tools are also logged (default: false) */
-    auditReads: boolean;
-    /** Maximum log file size in bytes before rotation (default: 10MB). 0 = no rotation. */
-    maxSizeBytes: number;
+    computeDigest(): Record<string, unknown>;
+    pragma(command: string): void;
+    getCrossProjectInsights(options: {
+        startDate?: string;
+        endDate?: string;
+        minEntries: number;
+        inactiveThresholdDays: number;
+    }): {
+        projects: Record<string, unknown>[];
+        inactiveProjects: {
+            project_number: number;
+            last_entry_date: string;
+        }[];
+    };
+    visualizeRelationships(options: {
+        entryId?: number;
+        tags?: string[];
+        relationshipType?: string;
+        depth: number;
+        limit: number;
+    }): {
+        nodes: {
+            id: string | number;
+            label: string;
+            group: string;
+            metadata?: Record<string, unknown>;
+        }[];
+        edges: {
+            from: string | number;
+            to: string | number;
+            label: string;
+            type: string;
+        }[];
+    };
+    getTeamCollaborationMatrix(options: {
+        period: string;
+        limit: number;
+    }): {
+        totalAuthors: number;
+        totalEntries: number;
+        authorActivity: {
+            author: string;
+            period: string;
+            entryCount: number;
+        }[];
+        crossAuthorLinks: {
+            fromAuthor: string;
+            toAuthor: string;
+            linkCount: number;
+        }[];
+        impactFactor: {
+            author: string;
+            inboundLinks: number;
+        }[];
+    };
+    getWorkflowActionEntries(limit: number): JournalEntry[];
+    getSignificantEntries(limit: number, projectNumber?: number): JournalEntry[];
+    getRecentGraphRelationships(limit: number): {
+        from_entry_id: number;
+        to_entry_id: number;
+        relationship_type: string;
+        from_content: string;
+        to_content: string;
+    }[];
+    upsertVector(entryId: number, embedding: Float32Array): void;
+    upsertVectors(vectors: {
+        entryId: number;
+        embedding: Float32Array;
+    }[]): void;
+    searchVectors(embedding: Float32Array, limit: number): {
+        entry_id: number;
+        distance: number;
+    }[];
+    getVector(entryId: number): Float32Array | null;
+    deleteVector(entryId: number): void;
+    clearVectors(): void;
+    getVectorCount(): number;
+    cleanupStaleVectors(): void;
+    executeInTransaction<T>(cb: () => T): T;
 }
 
 /**
@@ -654,16 +760,21 @@ interface ServerOptions {
     authToken?: string;
     enableHSTS?: boolean;
     scheduler?: SchedulerOptions;
-    sandboxMode?: SandboxMode;
     oauthEnabled?: boolean;
     oauthIssuer?: string;
     oauthAudience?: string;
     oauthJwksUri?: string;
     oauthClockTolerance?: number;
+    allowPlaintextLoopbackOAuth?: boolean;
+    trustProxy?: boolean;
+    publicOrigin?: string;
     briefingConfig?: BriefingConfig;
     projectRegistry?: Record<string, ProjectRegistryEntry>;
     instructionLevel?: 'essential' | 'standard' | 'full';
     auditConfig?: AuditConfig;
+    flagVocabulary?: string[];
+    allowedIoRoots?: string[];
+    codemodeInternalFullAccess?: boolean;
 }
 /**
  * Create and start the MCP server

package/dist/index.js

@@ -1,7 +1,5 @@
-export { VERSION, createServer } from './chunk-5ZA77VUW.js';
-export { META_GROUPS, TOOL_GROUPS, calculateTokenSavings, filterTools, getAllToolNames, getFilterSummary, getToolFilterFromEnv, getToolGroup, isToolEnabled, parseToolFilter } from './chunk-P5V2VY6N.js';
-import './chunk-OKOVZ5QE.js';
-export { logger } from './chunk-WXDEVIFL.js';
+export { VERSION, createServer } from './chunk-NSEHC6MZ.js';
+export { META_GROUPS, TOOL_GROUPS, calculateTokenSavings, filterTools, getAllToolNames, getFilterSummary, getToolFilterFromEnv, getToolGroup, isToolEnabled, logger, parseToolFilter } from './chunk-SV3CKPMF.js';
 
 // src/types/index.ts
 var DEFAULT_CONFIG = {

package/dist/tools-QF7CPU2H.js

@@ -0,0 +1 @@
+export { callTool, getTools } from './chunk-SV3CKPMF.js';