@hiveforge/hivemind-mcp 0.1.0

package/dist/types/index.js

@@ -0,0 +1,133 @@
+import { z } from 'zod';
+// ============================================================================
+// Vault Note Types
+// ============================================================================
+export const NoteStatusSchema = z.enum(['draft', 'pending', 'canon', 'non-canon', 'archived']);
+export const NoteTypeSchema = z.enum(['character', 'location', 'event', 'faction', 'system', 'asset', 'lore']);
+export const ImportanceSchema = z.enum(['major', 'minor', 'background']);
+// Base frontmatter schema
+export const BaseFrontmatterSchema = z.object({
+    id: z.string(),
+    type: NoteTypeSchema,
+    status: NoteStatusSchema.default('draft'),
+    title: z.string().optional(),
+    world: z.string().optional(),
+    importance: ImportanceSchema.optional(),
+    tags: z.array(z.string()).optional().default([]),
+    aliases: z.array(z.string()).optional().default([]),
+    created: z.string().optional(),
+    updated: z.string().optional(),
+    canon_authority: z.enum(['high', 'medium', 'low']).optional(),
+});
+// Character-specific frontmatter
+export const CharacterFrontmatterSchema = BaseFrontmatterSchema.extend({
+    type: z.literal('character'),
+    name: z.string(),
+    age: z.number().optional(),
+    gender: z.string().optional(),
+    race: z.string().optional(),
+    appearance: z.record(z.any()).optional(),
+    personality: z.record(z.any()).optional(),
+    relationships: z.array(z.record(z.any())).optional(),
+    assets: z.array(z.string()).optional(),
+});
+// Location-specific frontmatter
+export const LocationFrontmatterSchema = BaseFrontmatterSchema.extend({
+    type: z.literal('location'),
+    name: z.string(),
+    region: z.string().optional(),
+    category: z.string().optional(),
+    parent: z.string().optional(),
+    hierarchy_level: z.enum(['continent', 'region', 'settlement', 'building', 'room']).optional(),
+    children: z.array(z.string()).optional(),
+    climate: z.string().optional(),
+    terrain: z.array(z.string()).optional(),
+    inhabitants: z.array(z.string()).optional(),
+    connections: z.array(z.record(z.any())).optional(),
+    assets: z.array(z.string()).optional(),
+});
+// Event-specific frontmatter
+export const EventFrontmatterSchema = BaseFrontmatterSchema.extend({
+    type: z.literal('event'),
+    name: z.string(),
+    date: z.string().optional(),
+    date_start: z.string().optional(),
+    date_end: z.string().optional(),
+    date_display: z.string().optional(),
+    event_type: z.string().optional(),
+    participants: z.array(z.string()).optional(),
+    locations: z.array(z.string()).optional(),
+    factions: z.array(z.string()).optional(),
+    outcome: z.string().optional(),
+    consequences: z.array(z.string()).optional(),
+    timeline: z.string().optional(),
+    previous_event: z.string().optional(),
+    next_event: z.string().optional(),
+});
+// Faction-specific frontmatter
+export const FactionFrontmatterSchema = BaseFrontmatterSchema.extend({
+    type: z.literal('faction'),
+    name: z.string(),
+    faction_type: z.enum(['house', 'guild', 'organization', 'government', 'military', 'religion', 'other']).optional(),
+    leader: z.string().optional(),
+    members: z.array(z.string()).optional(),
+    headquarters: z.string().optional(),
+    founded: z.string().optional(),
+    goals: z.array(z.string()).optional(),
+    resources: z.array(z.string()).optional(),
+    allies: z.array(z.string()).optional(),
+    rivals: z.array(z.string()).optional(),
+});
+// Lore-specific frontmatter
+export const LoreFrontmatterSchema = BaseFrontmatterSchema.extend({
+    type: z.literal('lore'),
+    name: z.string(),
+    category: z.enum(['mythology', 'history', 'magic', 'technology', 'culture', 'religion', 'other']).optional(),
+    related_entities: z.array(z.string()).optional(),
+    source: z.enum(['in-world', 'meta', 'player-knowledge']).optional(),
+});
+// Asset-specific frontmatter
+export const AssetFrontmatterSchema = BaseFrontmatterSchema.extend({
+    type: z.literal('asset'),
+    asset_type: z.enum(['image', 'audio', 'video', 'document']).default('image'),
+    file_path: z.string(),
+    file_format: z.string().optional(),
+    depicts: z.array(z.string()).optional(),
+    generation_date: z.string().optional(),
+    generator: z.string().optional(),
+    workflow_id: z.string().optional(),
+    prompt: z.string().optional(),
+    negative_prompt: z.string().optional(),
+    model: z.string().optional(),
+    seed: z.number().optional(),
+    parameters: z.record(z.any()).optional(),
+    approved_by: z.string().optional(),
+    approval_date: z.string().optional(),
+});
+// ============================================================================
+// MCP Tool Types
+// ============================================================================
+export const QueryCharacterArgsSchema = z.object({
+    id: z.string().describe('Character ID or name to query'),
+    includeContent: z.boolean().optional().default(true).describe('Include content body in response'),
+    contentLimit: z.number().min(100).max(5000).optional().default(500).describe('Maximum characters of content to return'),
+});
+export const QueryLocationArgsSchema = z.object({
+    id: z.string().describe('Location ID or name to query'),
+    includeContent: z.boolean().optional().default(true).describe('Include content body in response'),
+    contentLimit: z.number().min(100).max(5000).optional().default(500).describe('Maximum characters of content to return'),
+});
+export const SearchVaultArgsSchema = z.object({
+    query: z.string().describe('Search query text'),
+    filters: z.object({
+        type: z.array(NoteTypeSchema).optional(),
+        status: z.array(NoteStatusSchema).optional(),
+        importance: z.array(ImportanceSchema).optional(),
+        tags: z.array(z.string()).optional(),
+        world: z.string().optional(),
+    }).optional(),
+    limit: z.number().min(1).max(100).default(10),
+    includeContent: z.boolean().optional().default(false).describe('Include content snippets in results'),
+    contentLimit: z.number().min(100).max(2000).optional().default(300).describe('Maximum characters of content per result'),
+});
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/vault/reader.d.ts

@@ -0,0 +1,56 @@
+import type { VaultConfig, VaultNote } from '../types/index.js';
+export interface VaultIndex {
+    notes: Map<string, VaultNote>;
+    notesByType: Map<string, Set<string>>;
+    notesByStatus: Map<string, Set<string>>;
+    totalNotes: number;
+    lastUpdated: Date;
+}
+export declare class VaultReader {
+    private config;
+    private index;
+    private parser;
+    constructor(config: VaultConfig);
+    /**
+     * Scan the vault directory and build an index of all markdown files
+     */
+    scanVault(): Promise<VaultIndex>;
+    /**
+     * Recursively find all markdown files in a directory
+     */
+    private findMarkdownFiles;
+    /**
+     * Check if a file/directory should be excluded
+     */
+    private shouldExclude;
+    /**
+     * Index a single markdown file with full parsing
+     */
+    private indexFile;
+    /**
+     * Get a note by ID
+     */
+    getNote(id: string): VaultNote | undefined;
+    /**
+     * Get all notes
+     */
+    getAllNotes(): VaultNote[];
+    /**
+     * Get notes by type
+     */
+    getNotesByType(type: string): VaultNote[];
+    /**
+     * Get notes by status
+     */
+    getNotesByStatus(status: string): VaultNote[];
+    /**
+     * Get vault statistics
+     */
+    getStats(): {
+        totalNotes: number;
+        byType: Record<string, number>;
+        byStatus: Record<string, number>;
+        lastUpdated: Date;
+    };
+}
+//# sourceMappingURL=reader.d.ts.map

package/dist/vault/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../src/vault/reader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGhE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACtC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,IAAI,CAAC;CACnB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,EAAE,WAAW;IAY/B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;IA+BtC;;OAEG;YACW,iBAAiB;IA6B/B;;OAEG;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;YACW,SAAS;IAmCvB;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI1C;;OAEG;IACH,WAAW,IAAI,SAAS,EAAE;IAI1B;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE;IASzC;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;IAS7C;;OAEG;IACH,QAAQ;;;;;;CAkBT"}

package/dist/vault/reader.js

@@ -0,0 +1,185 @@
+import { promises as fs } from 'fs';
+import { join, relative } from 'path';
+import { MarkdownParser } from '../parser/markdown.js';
+export class VaultReader {
+    config;
+    index;
+    parser;
+    constructor(config) {
+        this.config = config;
+        this.parser = new MarkdownParser();
+        this.index = {
+            notes: new Map(),
+            notesByType: new Map(),
+            notesByStatus: new Map(),
+            totalNotes: 0,
+            lastUpdated: new Date(),
+        };
+    }
+    /**
+     * Scan the vault directory and build an index of all markdown files
+     */
+    async scanVault() {
+        console.error(`Scanning vault at: ${this.config.path}`);
+        const startTime = Date.now();
+        const files = await this.findMarkdownFiles(this.config.path);
+        console.error(`Found ${files.length} markdown files`);
+        // Clear existing index
+        this.index.notes.clear();
+        this.index.notesByType.clear();
+        this.index.notesByStatus.clear();
+        // Process each file
+        for (const filePath of files) {
+            try {
+                await this.indexFile(filePath);
+            }
+            catch (error) {
+                console.error(`Error indexing ${filePath}:`, error);
+            }
+        }
+        this.index.totalNotes = this.index.notes.size;
+        this.index.lastUpdated = new Date();
+        const elapsed = Date.now() - startTime;
+        console.error(`Vault scan complete: ${this.index.totalNotes} notes indexed in ${elapsed}ms`);
+        return this.index;
+    }
+    /**
+     * Recursively find all markdown files in a directory
+     */
+    async findMarkdownFiles(dir) {
+        const results = [];
+        try {
+            const entries = await fs.readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = join(dir, entry.name);
+                // Skip excluded patterns
+                if (this.shouldExclude(entry.name)) {
+                    continue;
+                }
+                if (entry.isDirectory()) {
+                    // Recursively search subdirectories
+                    const subFiles = await this.findMarkdownFiles(fullPath);
+                    results.push(...subFiles);
+                }
+                else if (entry.isFile() && entry.name.endsWith('.md')) {
+                    results.push(fullPath);
+                }
+            }
+        }
+        catch (error) {
+            console.error(`Error reading directory ${dir}:`, error);
+        }
+        return results;
+    }
+    /**
+     * Check if a file/directory should be excluded
+     */
+    shouldExclude(name) {
+        const defaultExcludes = [
+            '.obsidian',
+            '.trash',
+            '.git',
+            'node_modules',
+            '_template.md',
+        ];
+        const excludePatterns = [
+            ...defaultExcludes,
+            ...(this.config.excludePatterns || []),
+        ];
+        return excludePatterns.some(pattern => {
+            if (pattern.includes('*')) {
+                // Simple glob matching
+                const regex = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$');
+                return regex.test(name);
+            }
+            return name === pattern || name.startsWith(pattern);
+        });
+    }
+    /**
+     * Index a single markdown file with full parsing
+     */
+    async indexFile(filePath) {
+        try {
+            // Parse the file with MarkdownParser
+            const note = await this.parser.parseFile(filePath);
+            // Update file stats
+            const stats = await fs.stat(filePath);
+            note.stats = {
+                size: stats.size,
+                created: stats.birthtime,
+                modified: stats.mtime,
+            };
+            // Update relative path
+            note.filePath = relative(this.config.path, filePath);
+            // Add to index
+            this.index.notes.set(note.id, note);
+            // Index by type
+            if (!this.index.notesByType.has(note.frontmatter.type)) {
+                this.index.notesByType.set(note.frontmatter.type, new Set());
+            }
+            this.index.notesByType.get(note.frontmatter.type).add(note.id);
+            // Index by status
+            if (!this.index.notesByStatus.has(note.frontmatter.status)) {
+                this.index.notesByStatus.set(note.frontmatter.status, new Set());
+            }
+            this.index.notesByStatus.get(note.frontmatter.status).add(note.id);
+        }
+        catch (error) {
+            console.error(`Failed to parse ${filePath}:`, error);
+        }
+    }
+    /**
+     * Get a note by ID
+     */
+    getNote(id) {
+        return this.index.notes.get(id);
+    }
+    /**
+     * Get all notes
+     */
+    getAllNotes() {
+        return Array.from(this.index.notes.values());
+    }
+    /**
+     * Get notes by type
+     */
+    getNotesByType(type) {
+        const ids = this.index.notesByType.get(type);
+        if (!ids)
+            return [];
+        return Array.from(ids)
+            .map(id => this.index.notes.get(id))
+            .filter((note) => note !== undefined);
+    }
+    /**
+     * Get notes by status
+     */
+    getNotesByStatus(status) {
+        const ids = this.index.notesByStatus.get(status);
+        if (!ids)
+            return [];
+        return Array.from(ids)
+            .map(id => this.index.notes.get(id))
+            .filter((note) => note !== undefined);
+    }
+    /**
+     * Get vault statistics
+     */
+    getStats() {
+        const typeStats = {};
+        for (const [type, ids] of this.index.notesByType.entries()) {
+            typeStats[type] = ids.size;
+        }
+        const statusStats = {};
+        for (const [status, ids] of this.index.notesByStatus.entries()) {
+            statusStats[status] = ids.size;
+        }
+        return {
+            totalNotes: this.index.totalNotes,
+            byType: typeStats,
+            byStatus: statusStats,
+            lastUpdated: this.index.lastUpdated,
+        };
+    }
+}
+//# sourceMappingURL=reader.js.map

package/dist/vault/reader.js.map

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

package/dist/vault/watcher.d.ts

@@ -0,0 +1,33 @@
+import type { VaultConfig } from '../types/index.js';
+export type FileChangeEvent = 'add' | 'change' | 'unlink';
+export interface FileChangeHandler {
+    (event: FileChangeEvent, filePath: string): void | Promise<void>;
+}
+export declare class VaultWatcher {
+    private config;
+    private watcher;
+    private handlers;
+    private debounceTimers;
+    constructor(config: VaultConfig);
+    /**
+     * Start watching the vault for changes
+     */
+    start(): void;
+    /**
+     * Stop watching
+     */
+    stop(): Promise<void>;
+    /**
+     * Register a handler for file changes
+     */
+    onChange(handler: FileChangeHandler): void;
+    /**
+     * Handle file change with debouncing
+     */
+    private handleChange;
+    /**
+     * Notify all registered handlers
+     */
+    private notifyHandlers;
+}
+//# sourceMappingURL=watcher.d.ts.map

package/dist/vault/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/vault/watcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,cAAc,CAA0C;gBAEpD,MAAM,EAAE,WAAW;IAI/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAmCb;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAI1C;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;OAEG;YACW,cAAc;CAW7B"}

package/dist/vault/watcher.js

@@ -0,0 +1,92 @@
+import chokidar from 'chokidar';
+export class VaultWatcher {
+    config;
+    watcher = null;
+    handlers = [];
+    debounceTimers = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Start watching the vault for changes
+     */
+    start() {
+        if (!this.config.watchForChanges) {
+            console.error('File watching disabled in config');
+            return;
+        }
+        console.error(`Starting file watcher on: ${this.config.path}`);
+        this.watcher = chokidar.watch('**/*.md', {
+            cwd: this.config.path,
+            ignored: [
+                '**/node_modules/**',
+                '**/.obsidian/**',
+                '**/.trash/**',
+                '**/.git/**',
+                '**/_template.md',
+                ...(this.config.excludePatterns || []),
+            ],
+            ignoreInitial: true, // Don't trigger on initial scan
+            persistent: true,
+            awaitWriteFinish: {
+                stabilityThreshold: 100,
+                pollInterval: 50,
+            },
+        });
+        // Set up event handlers with debouncing
+        this.watcher
+            .on('add', (path) => this.handleChange('add', path))
+            .on('change', (path) => this.handleChange('change', path))
+            .on('unlink', (path) => this.handleChange('unlink', path))
+            .on('error', (error) => console.error('Watcher error:', error))
+            .on('ready', () => console.error('File watcher ready'));
+    }
+    /**
+     * Stop watching
+     */
+    async stop() {
+        if (this.watcher) {
+            await this.watcher.close();
+            this.watcher = null;
+            console.error('File watcher stopped');
+        }
+    }
+    /**
+     * Register a handler for file changes
+     */
+    onChange(handler) {
+        this.handlers.push(handler);
+    }
+    /**
+     * Handle file change with debouncing
+     */
+    handleChange(event, filePath) {
+        const debounceMs = this.config.debounceMs || 100;
+        // Clear existing timer for this file
+        const existingTimer = this.debounceTimers.get(filePath);
+        if (existingTimer) {
+            clearTimeout(existingTimer);
+        }
+        // Set new timer
+        const timer = setTimeout(() => {
+            this.debounceTimers.delete(filePath);
+            this.notifyHandlers(event, filePath);
+        }, debounceMs);
+        this.debounceTimers.set(filePath, timer);
+    }
+    /**
+     * Notify all registered handlers
+     */
+    async notifyHandlers(event, filePath) {
+        console.error(`File ${event}: ${filePath}`);
+        for (const handler of this.handlers) {
+            try {
+                await handler(event, filePath);
+            }
+            catch (error) {
+                console.error(`Error in change handler for ${filePath}:`, error);
+            }
+        }
+    }
+}
+//# sourceMappingURL=watcher.js.map

package/dist/vault/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../src/vault/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,QAA4B,MAAM,UAAU,CAAC;AASpD,MAAM,OAAO,YAAY;IACf,MAAM,CAAc;IACpB,OAAO,GAAqB,IAAI,CAAC;IACjC,QAAQ,GAAwB,EAAE,CAAC;IACnC,cAAc,GAAgC,IAAI,GAAG,EAAE,CAAC;IAEhE,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YACjC,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,6BAA6B,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAE/D,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE;YACvC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YACrB,OAAO,EAAE;gBACP,oBAAoB;gBACpB,iBAAiB;gBACjB,cAAc;gBACd,YAAY;gBACZ,iBAAiB;gBACjB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC;aACvC;YACD,aAAa,EAAE,IAAI,EAAE,gCAAgC;YACrD,UAAU,EAAE,IAAI;YAChB,gBAAgB,EAAE;gBAChB,kBAAkB,EAAE,GAAG;gBACvB,YAAY,EAAE,EAAE;aACjB;SACF,CAAC,CAAC;QAEH,wCAAwC;QACxC,IAAI,CAAC,OAAO;aACT,EAAE,CAAC,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;aAC3D,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;aACjE,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;aACjE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;aACvE,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,OAA0B;QACjC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,KAAsB,EAAE,QAAgB;QAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,GAAG,CAAC;QAEjD,qCAAqC;QACrC,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,aAAa,EAAE,CAAC;YAClB,YAAY,CAAC,aAAa,CAAC,CAAC;QAC9B,CAAC;QAED,gBAAgB;QAChB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACrC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC,EAAE,UAAU,CAAC,CAAC;QAEf,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAAC,KAAsB,EAAE,QAAgB;QACnE,OAAO,CAAC,KAAK,CAAC,QAAQ,KAAK,KAAK,QAAQ,EAAE,CAAC,CAAC;QAE5C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YACjC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@hiveforge/hivemind-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Obsidian worldbuilding vaults - provides AI tools with consistent canonical context",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "hivemind": "dist/cli.js"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "lint": "eslint src --ext .ts",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hiveforge-io/hivemind.git"
+  },
+  "bugs": {
+    "url": "https://github.com/hiveforge-io/hivemind/issues"
+  },
+  "homepage": "https://github.com/hiveforge-io/hivemind#readme",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "obsidian",
+    "worldbuilding",
+    "ai",
+    "context",
+    "knowledge-graph",
+    "claude",
+    "rag",
+    "hybrid-search",
+    "creative-writing",
+    "fiction",
+    "storytelling"
+  ],
+  "author": "Preston",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "chokidar": "^4.0.3",
+    "express": "^4.21.2",
+    "gray-matter": "^4.0.3",
+    "remark": "^15.0.1",
+    "remark-wiki-link": "^2.0.1",
+    "better-sqlite3": "^11.7.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "@types/express": "^5.0.0",
+    "@types/better-sqlite3": "^7.6.12",
+    "@typescript-eslint/eslint-plugin": "^8.20.0",
+    "@typescript-eslint/parser": "^8.20.0",
+    "eslint": "^9.18.0",
+    "jest": "^29.7.0",
+    "@types/jest": "^29.5.14",
+    "typescript": "^5.7.2",
+    "rimraf": "^6.0.1"
+  }
+}