memory-journal-mcp 3.0.0

package/dist/cli.js

@@ -0,0 +1,42 @@
+/**
+ * Memory Journal MCP Server - CLI Entry Point
+ */
+import { Command } from 'commander';
+import { createServer } from './server/McpServer.js';
+import { logger } from './utils/logger.js';
+const program = new Command();
+program
+    .name('memory-journal-mcp')
+    .description('Project context management for AI-assisted development')
+    .version('3.0.0-alpha.1')
+    .option('--transport <type>', 'Transport type: stdio or http', 'stdio')
+    .option('--port <number>', 'HTTP port (for http transport)', '3000')
+    .option('--db <path>', 'Database path', './memory_journal.db')
+    .option('--tool-filter <filter>', 'Tool filter string (e.g., "starter", "core,search")')
+    .option('--log-level <level>', 'Log level: debug, info, warning, error', 'info')
+    .action(async (options) => {
+    // Set log level
+    logger.setLevel(options.logLevel);
+    logger.info('Starting Memory Journal MCP Server', {
+        module: 'CLI',
+        transport: options.transport,
+        db: options.db,
+    });
+    try {
+        await createServer({
+            transport: options.transport,
+            port: parseInt(options.port, 10),
+            dbPath: options.db,
+            toolFilter: options.toolFilter,
+        });
+    }
+    catch (error) {
+        logger.error('Failed to start server', {
+            module: 'CLI',
+            error: error instanceof Error ? error.message : String(error),
+        });
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACF,IAAI,CAAC,oBAAoB,CAAC;KAC1B,WAAW,CAAC,wDAAwD,CAAC;KACrE,OAAO,CAAC,eAAe,CAAC;KACxB,MAAM,CAAC,oBAAoB,EAAE,+BAA+B,EAAE,OAAO,CAAC;KACtE,MAAM,CAAC,iBAAiB,EAAE,gCAAgC,EAAE,MAAM,CAAC;KACnE,MAAM,CAAC,aAAa,EAAE,eAAe,EAAE,qBAAqB,CAAC;KAC7D,MAAM,CAAC,wBAAwB,EAAE,qDAAqD,CAAC;KACvF,MAAM,CAAC,qBAAqB,EAAE,wCAAwC,EAAE,MAAM,CAAC;KAC/E,MAAM,CAAC,KAAK,EAAE,OAMd,EAAE,EAAE;IACD,gBAAgB;IAChB,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAkD,CAAC,CAAC;IAE5E,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE;QAC9C,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,EAAE,EAAE,OAAO,CAAC,EAAE;KACjB,CAAC,CAAC;IAEH,IAAI,CAAC;QACD,MAAM,YAAY,CAAC;YACf,SAAS,EAAE,OAAO,CAAC,SAA6B;YAChD,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAChC,MAAM,EAAE,OAAO,CAAC,EAAE;YAClB,UAAU,EAAE,OAAO,CAAC,UAAU;SACjC,CAAC,CAAC;IACP,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE;YACnC,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAChE,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC,CAAC,CAAC;AAEP,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/constants/ServerInstructions.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Server instructions for Memory Journal MCP.
+ *
+ * These instructions are automatically sent to MCP clients during initialization,
+ * providing guidance for AI agents on tool usage.
+ */
+export declare const SERVER_INSTRUCTIONS = "# memory-journal-mcp\n\nMemory Journal MCP Server - Persistent project context management for AI-assisted development.\n\n## GitHub Tools\n\nGitHub tools auto-detect repository from the configured GITHUB_REPO_PATH.\n- If owner/repo are detected, they appear in `detectedOwner`/`detectedRepo` in responses\n- If not detected (null), specify `owner` and `repo` parameters explicitly\n\n## Tool Groups\n\n| Group | Tools |\n|-------|-------|\n| journal | create_entry, create_entry_minimal, update_entry, delete_entry |\n| search | search_entries, semantic_search, search_by_date_range |\n| github | get_github_issues, get_github_prs, get_github_issue, get_github_pr, get_github_context |\n| admin | backup_journal, list_backups, restore_backup, rebuild_vector_index |\n";
+//# sourceMappingURL=ServerInstructions.d.ts.map

package/dist/constants/ServerInstructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerInstructions.d.ts","sourceRoot":"","sources":["../../src/constants/ServerInstructions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,owBAkB/B,CAAC"}

package/dist/constants/ServerInstructions.js

@@ -0,0 +1,26 @@
+/**
+ * Server instructions for Memory Journal MCP.
+ *
+ * These instructions are automatically sent to MCP clients during initialization,
+ * providing guidance for AI agents on tool usage.
+ */
+export const SERVER_INSTRUCTIONS = `# memory-journal-mcp
+
+Memory Journal MCP Server - Persistent project context management for AI-assisted development.
+
+## GitHub Tools
+
+GitHub tools auto-detect repository from the configured GITHUB_REPO_PATH.
+- If owner/repo are detected, they appear in \`detectedOwner\`/\`detectedRepo\` in responses
+- If not detected (null), specify \`owner\` and \`repo\` parameters explicitly
+
+## Tool Groups
+
+| Group | Tools |
+|-------|-------|
+| journal | create_entry, create_entry_minimal, update_entry, delete_entry |
+| search | search_entries, semantic_search, search_by_date_range |
+| github | get_github_issues, get_github_prs, get_github_issue, get_github_pr, get_github_context |
+| admin | backup_journal, list_backups, restore_backup, rebuild_vector_index |
+`;
+//# sourceMappingURL=ServerInstructions.js.map

package/dist/constants/ServerInstructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerInstructions.js","sourceRoot":"","sources":["../../src/constants/ServerInstructions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;CAkBlC,CAAC"}

package/dist/database/SqliteAdapter.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Memory Journal MCP Server - SQLite Database Adapter
+ *
+ * Manages SQLite database with FTS5 full-text search using sql.js.
+ * Note: sql.js is pure JavaScript, no native compilation required.
+ */
+import { type Database } from 'sql.js';
+import type { JournalEntry, Tag, Relationship, EntryType, SignificanceType, RelationshipType } from '../types/index.js';
+/**
+ * Input for creating a new entry
+ */
+export interface CreateEntryInput {
+    content: string;
+    entryType?: EntryType;
+    tags?: string[];
+    isPersonal?: boolean;
+    significanceType?: SignificanceType;
+    autoContext?: string;
+    projectNumber?: number;
+    projectOwner?: string;
+    issueNumber?: number;
+    issueUrl?: string;
+    prNumber?: number;
+    prUrl?: string;
+    prStatus?: 'draft' | 'open' | 'merged' | 'closed';
+    workflowRunId?: number;
+    workflowName?: string;
+    workflowStatus?: 'queued' | 'in_progress' | 'completed';
+}
+/**
+ * SQLite Database Adapter for Memory Journal using sql.js
+ */
+export declare class SqliteAdapter {
+    private db;
+    private readonly dbPath;
+    private initialized;
+    constructor(dbPath: string);
+    /**
+     * Initialize the database (must be called before using)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Save database to disk
+     */
+    private save;
+    /**
+     * Close database connection
+     */
+    close(): void;
+    /**
+     * Ensure database is initialized
+     */
+    private ensureDb;
+    /**
+     * Create a new journal entry
+     */
+    createEntry(input: CreateEntryInput): JournalEntry;
+    /**
+     * Get entry by ID
+     */
+    getEntryById(id: number): JournalEntry | null;
+    /**
+     * Get recent entries
+     */
+    getRecentEntries(limit?: number, isPersonal?: boolean): JournalEntry[];
+    /**
+     * Update an entry
+     */
+    updateEntry(id: number, updates: {
+        content?: string;
+        entryType?: EntryType;
+        tags?: string[];
+        isPersonal?: boolean;
+    }): JournalEntry | null;
+    /**
+     * Soft delete an entry
+     */
+    deleteEntry(id: number, permanent?: boolean): boolean;
+    /**
+     * Full-text search entries (using LIKE for sql.js - FTS5 not supported)
+     */
+    searchEntries(query: string, options?: {
+        limit?: number;
+        isPersonal?: boolean;
+        projectNumber?: number;
+        issueNumber?: number;
+        prNumber?: number;
+    }): JournalEntry[];
+    /**
+     * Search by date range
+     */
+    searchByDateRange(startDate: string, endDate: string, options?: {
+        entryType?: EntryType;
+        tags?: string[];
+        isPersonal?: boolean;
+        projectNumber?: number;
+    }): JournalEntry[];
+    /**
+     * Get or create tags and link to entry
+     */
+    private linkTagsToEntry;
+    /**
+     * Get tags for an entry
+     */
+    getTagsForEntry(entryId: number): string[];
+    /**
+     * List all tags
+     */
+    listTags(): Tag[];
+    /**
+     * Link two entries
+     */
+    linkEntries(fromEntryId: number, toEntryId: number, relationshipType: RelationshipType, description?: string): Relationship;
+    /**
+     * Get relationships for an entry
+     */
+    getRelationships(entryId: number): Relationship[];
+    /**
+     * Get entry statistics
+     */
+    getStatistics(groupBy?: 'day' | 'week' | 'month'): {
+        totalEntries: number;
+        entriesByType: Record<string, number>;
+        entriesByPeriod: {
+            period: string;
+            count: number;
+        }[];
+    };
+    /**
+     * Get the backups directory path (relative to database location)
+     */
+    getBackupsDir(): string;
+    /**
+     * Export database to a backup file
+     * @param backupName Optional custom name (default: timestamp-based)
+     * @returns Backup file info
+     */
+    exportToFile(backupName?: string): {
+        filename: string;
+        path: string;
+        sizeBytes: number;
+    };
+    /**
+     * List all available backup files
+     * @returns Array of backup file information
+     */
+    listBackups(): {
+        filename: string;
+        path: string;
+        sizeBytes: number;
+        createdAt: string;
+    }[];
+    /**
+     * Restore database from a backup file
+     * @param filename Backup filename to restore from
+     * @returns Statistics about the restore operation
+     */
+    restoreFromFile(filename: string): Promise<{
+        restoredFrom: string;
+        previousEntryCount: number;
+        newEntryCount: number;
+    }>;
+    /**
+     * Get database health status for diagnostics
+     */
+    getHealthStatus(): {
+        database: {
+            path: string;
+            sizeBytes: number;
+            entryCount: number;
+            deletedEntryCount: number;
+            relationshipCount: number;
+            tagCount: number;
+        };
+        backups: {
+            directory: string;
+            count: number;
+            lastBackup: {
+                filename: string;
+                createdAt: string;
+                sizeBytes: number;
+            } | null;
+        };
+    };
+    /**
+     * Convert columns and values to object
+     */
+    private rowToObject;
+    /**
+     * Convert database row to JournalEntry
+     */
+    private rowToEntry;
+    /**
+     * Get raw database for advanced operations
+     */
+    getRawDb(): Database;
+}
+//# sourceMappingURL=SqliteAdapter.d.ts.map

package/dist/database/SqliteAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteAdapter.d.ts","sourceRoot":"","sources":["../../src/database/SqliteAdapter.ts"],"names":[],"mappings":"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"}