@hiveforge/hivemind-mcp 2.1.1 → 2.3.0

package/dist/templates/builtin/worldbuilding.js

@@ -0,0 +1,464 @@
+/**
+ * Built-in worldbuilding template.
+ *
+ * Defines entity types for worldbuilding projects:
+ * - character: NPCs, player characters, historical figures
+ * - location: Places, regions, buildings, rooms
+ * - event: Historical events, current events, plot points
+ * - faction: Organizations, governments, guilds, houses
+ * - lore: Mythology, magic systems, cultural knowledge
+ * - asset: Visual and media assets (images, audio, video)
+ */
+/**
+ * Worldbuilding template definition.
+ *
+ * Matches the existing hardcoded schemas in src/types/index.ts to ensure
+ * backwards compatibility with existing vaults.
+ */
+export const worldbuildingTemplate = {
+    id: 'worldbuilding',
+    name: 'Worldbuilding',
+    version: '1.0.0',
+    description: 'Template for fictional world creation with characters, locations, events, factions, lore, and assets',
+    entityTypes: [
+        // Character entity type
+        {
+            name: 'character',
+            displayName: 'Character',
+            pluralName: 'Characters',
+            description: 'NPCs, player characters, and historical figures',
+            icon: 'user',
+            fields: [
+                {
+                    name: 'name',
+                    type: 'string',
+                    required: true,
+                    description: 'Character name',
+                },
+                {
+                    name: 'age',
+                    type: 'number',
+                    description: 'Character age in years',
+                },
+                {
+                    name: 'gender',
+                    type: 'string',
+                    description: 'Character gender',
+                },
+                {
+                    name: 'race',
+                    type: 'string',
+                    description: 'Character species or race',
+                },
+                {
+                    name: 'appearance',
+                    type: 'record',
+                    description: 'Physical appearance details',
+                },
+                {
+                    name: 'personality',
+                    type: 'record',
+                    description: 'Personality traits and characteristics',
+                },
+                {
+                    name: 'relationships',
+                    type: 'array',
+                    arrayItemType: 'record',
+                    description: 'Relationships with other characters',
+                },
+                {
+                    name: 'assets',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Asset IDs depicting this character',
+                },
+            ],
+        },
+        // Location entity type
+        {
+            name: 'location',
+            displayName: 'Location',
+            pluralName: 'Locations',
+            description: 'Places, regions, buildings, and rooms',
+            icon: 'map-pin',
+            fields: [
+                {
+                    name: 'name',
+                    type: 'string',
+                    required: true,
+                    description: 'Location name',
+                },
+                {
+                    name: 'region',
+                    type: 'string',
+                    description: 'Geographic region',
+                },
+                {
+                    name: 'category',
+                    type: 'string',
+                    description: 'Location category or type',
+                },
+                {
+                    name: 'parent',
+                    type: 'string',
+                    description: 'Parent location in hierarchy',
+                },
+                {
+                    name: 'hierarchy_level',
+                    type: 'enum',
+                    enumValues: ['continent', 'region', 'settlement', 'building', 'room'],
+                    description: 'Level in location hierarchy',
+                },
+                {
+                    name: 'children',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Child locations in hierarchy',
+                },
+                {
+                    name: 'climate',
+                    type: 'string',
+                    description: 'Climate type',
+                },
+                {
+                    name: 'terrain',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Terrain types present',
+                },
+                {
+                    name: 'inhabitants',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Character IDs of inhabitants',
+                },
+                {
+                    name: 'connections',
+                    type: 'array',
+                    arrayItemType: 'record',
+                    description: 'Connections to other locations',
+                },
+                {
+                    name: 'assets',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Asset IDs depicting this location',
+                },
+            ],
+        },
+        // Event entity type
+        {
+            name: 'event',
+            displayName: 'Event',
+            pluralName: 'Events',
+            description: 'Historical events, current events, and plot points',
+            icon: 'calendar',
+            fields: [
+                {
+                    name: 'name',
+                    type: 'string',
+                    required: true,
+                    description: 'Event name',
+                },
+                {
+                    name: 'date',
+                    type: 'string',
+                    description: 'Event date',
+                },
+                {
+                    name: 'date_start',
+                    type: 'string',
+                    description: 'Event start date (for multi-day events)',
+                },
+                {
+                    name: 'date_end',
+                    type: 'string',
+                    description: 'Event end date (for multi-day events)',
+                },
+                {
+                    name: 'date_display',
+                    type: 'string',
+                    description: 'Human-readable date display',
+                },
+                {
+                    name: 'event_type',
+                    type: 'string',
+                    description: 'Type of event',
+                },
+                {
+                    name: 'participants',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Character IDs of participants',
+                },
+                {
+                    name: 'locations',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Location IDs where event occurred',
+                },
+                {
+                    name: 'factions',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Faction IDs involved in event',
+                },
+                {
+                    name: 'outcome',
+                    type: 'string',
+                    description: 'Event outcome or result',
+                },
+                {
+                    name: 'consequences',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Consequences of the event',
+                },
+                {
+                    name: 'timeline',
+                    type: 'string',
+                    description: 'Timeline this event belongs to',
+                },
+                {
+                    name: 'previous_event',
+                    type: 'string',
+                    description: 'Previous event in sequence',
+                },
+                {
+                    name: 'next_event',
+                    type: 'string',
+                    description: 'Next event in sequence',
+                },
+            ],
+        },
+        // Faction entity type
+        {
+            name: 'faction',
+            displayName: 'Faction',
+            pluralName: 'Factions',
+            description: 'Organizations, governments, guilds, and houses',
+            icon: 'users',
+            fields: [
+                {
+                    name: 'name',
+                    type: 'string',
+                    required: true,
+                    description: 'Faction name',
+                },
+                {
+                    name: 'faction_type',
+                    type: 'enum',
+                    enumValues: ['house', 'guild', 'organization', 'government', 'military', 'religion', 'other'],
+                    description: 'Type of faction',
+                },
+                {
+                    name: 'leader',
+                    type: 'string',
+                    description: 'Character ID of faction leader',
+                },
+                {
+                    name: 'members',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Character IDs of faction members',
+                },
+                {
+                    name: 'headquarters',
+                    type: 'string',
+                    description: 'Location ID of faction headquarters',
+                },
+                {
+                    name: 'founded',
+                    type: 'string',
+                    description: 'When the faction was founded',
+                },
+                {
+                    name: 'goals',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Faction goals and objectives',
+                },
+                {
+                    name: 'resources',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Resources controlled by faction',
+                },
+                {
+                    name: 'allies',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Faction IDs of allies',
+                },
+                {
+                    name: 'rivals',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Faction IDs of rivals',
+                },
+            ],
+        },
+        // Lore entity type
+        {
+            name: 'lore',
+            displayName: 'Lore',
+            pluralName: 'Lore',
+            description: 'Mythology, magic systems, and cultural knowledge',
+            icon: 'book',
+            fields: [
+                {
+                    name: 'name',
+                    type: 'string',
+                    required: true,
+                    description: 'Lore entry name',
+                },
+                {
+                    name: 'category',
+                    type: 'enum',
+                    enumValues: ['mythology', 'history', 'magic', 'technology', 'culture', 'religion', 'other'],
+                    description: 'Lore category',
+                },
+                {
+                    name: 'related_entities',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'IDs of related entities',
+                },
+                {
+                    name: 'source',
+                    type: 'enum',
+                    enumValues: ['in-world', 'meta', 'player-knowledge'],
+                    description: 'Knowledge source type',
+                },
+            ],
+        },
+        // Asset entity type
+        {
+            name: 'asset',
+            displayName: 'Asset',
+            pluralName: 'Assets',
+            description: 'Visual and media assets (images, audio, video)',
+            icon: 'image',
+            fields: [
+                {
+                    name: 'asset_type',
+                    type: 'enum',
+                    enumValues: ['image', 'audio', 'video', 'document'],
+                    default: 'image',
+                    description: 'Type of asset',
+                },
+                {
+                    name: 'file_path',
+                    type: 'string',
+                    required: true,
+                    description: 'Path to asset file in vault',
+                },
+                {
+                    name: 'file_format',
+                    type: 'string',
+                    description: 'File format (e.g., png, jpg, mp3)',
+                },
+                {
+                    name: 'depicts',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Entity IDs depicted in this asset',
+                },
+                {
+                    name: 'generation_date',
+                    type: 'string',
+                    description: 'When asset was generated',
+                },
+                {
+                    name: 'generator',
+                    type: 'string',
+                    description: 'Tool or system that generated the asset',
+                },
+                {
+                    name: 'workflow_id',
+                    type: 'string',
+                    description: 'ComfyUI workflow ID used to generate',
+                },
+                {
+                    name: 'prompt',
+                    type: 'string',
+                    description: 'Generation prompt used',
+                },
+                {
+                    name: 'negative_prompt',
+                    type: 'string',
+                    description: 'Negative prompt for generation',
+                },
+                {
+                    name: 'model',
+                    type: 'string',
+                    description: 'AI model used for generation',
+                },
+                {
+                    name: 'seed',
+                    type: 'number',
+                    description: 'Random seed for reproducible generation',
+                },
+                {
+                    name: 'parameters',
+                    type: 'record',
+                    description: 'Generation parameters (seed, steps, cfg, etc.)',
+                },
+                {
+                    name: 'approved_by',
+                    type: 'string',
+                    description: 'Who approved this asset',
+                },
+                {
+                    name: 'approval_date',
+                    type: 'string',
+                    description: 'When this asset was approved',
+                },
+            ],
+        },
+        // Reference entity type
+        {
+            name: 'reference',
+            displayName: 'Reference',
+            pluralName: 'References',
+            description: 'Out-of-world reference material (sources, inspiration, rules, notes)',
+            icon: 'bookmark',
+            fields: [
+                {
+                    name: 'name',
+                    type: 'string',
+                    required: true,
+                    description: 'Reference name or title',
+                },
+                {
+                    name: 'category',
+                    type: 'enum',
+                    enumValues: ['source', 'inspiration', 'rules', 'notes', 'other'],
+                    description: 'Type of reference material',
+                },
+                {
+                    name: 'source_url',
+                    type: 'string',
+                    description: 'URL to external source material',
+                },
+                {
+                    name: 'related_entities',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'IDs of entities related to this reference',
+                },
+                {
+                    name: 'author',
+                    type: 'string',
+                    description: 'Author or creator of the reference material',
+                },
+                {
+                    name: 'date_accessed',
+                    type: 'string',
+                    description: 'When this reference was accessed or added',
+                },
+            ],
+        },
+    ],
+};
+//# sourceMappingURL=worldbuilding.js.map

package/dist/templates/builtin/worldbuilding.js.map

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

package/dist/templates/detector.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Template auto-detection from vault folder structure.
+ *
+ * This module enables backwards compatibility by automatically identifying
+ * templates based on vault organization patterns.
+ */
+/**
+ * Result of template detection with confidence level.
+ */
+export interface DetectionResult {
+    /** Detected template identifier */
+    templateId: string;
+    /** Confidence level based on pattern matches */
+    confidence: 'high' | 'medium' | 'low';
+    /** Folder names that matched detection patterns */
+    matchedPatterns: string[];
+    /** User-friendly notification message */
+    message: string;
+}
+/**
+ * Detects template type from vault folder structure.
+ *
+ * Provides automatic template identification for backwards compatibility
+ * with existing vaults.
+ */
+export declare class TemplateDetector {
+    /**
+     * Worldbuilding folder patterns (case-insensitive).
+     *
+     * Vaults with 2+ matching folders are detected as worldbuilding templates.
+     */
+    private static readonly WORLDBUILDING_PATTERNS;
+    /**
+     * Detect template from vault folder structure.
+     *
+     * Scans top-level folders and matches against known template patterns.
+     * Returns null if no template can be confidently detected.
+     *
+     * @param vaultPath - Absolute path to vault directory
+     * @returns Detection result with confidence level, or null if no match
+     */
+    detectTemplate(vaultPath: string): Promise<DetectionResult | null>;
+    /**
+     * List top-level folders in vault, excluding hidden directories.
+     *
+     * @param vaultPath - Absolute path to vault directory
+     * @returns Array of folder names
+     */
+    private listTopLevelFolders;
+}
+//# sourceMappingURL=detector.d.ts.map

package/dist/templates/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../src/templates/detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IAEnB,gDAAgD;IAChD,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAEtC,mDAAmD;IACnD,eAAe,EAAE,MAAM,EAAE,CAAC;IAE1B,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAY5C;IAEF;;;;;;;;OAQG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAyBxE;;;;;OAKG;YACW,mBAAmB;CAOlC"}

package/dist/templates/detector.js

@@ -0,0 +1,71 @@
+/**
+ * Template auto-detection from vault folder structure.
+ *
+ * This module enables backwards compatibility by automatically identifying
+ * templates based on vault organization patterns.
+ */
+import { promises as fs } from 'fs';
+/**
+ * Detects template type from vault folder structure.
+ *
+ * Provides automatic template identification for backwards compatibility
+ * with existing vaults.
+ */
+export class TemplateDetector {
+    /**
+     * Worldbuilding folder patterns (case-insensitive).
+     *
+     * Vaults with 2+ matching folders are detected as worldbuilding templates.
+     */
+    static WORLDBUILDING_PATTERNS = [
+        'characters',
+        'character',
+        'locations',
+        'location',
+        'events',
+        'event',
+        'factions',
+        'faction',
+        'lore',
+        'assets',
+        'asset',
+    ];
+    /**
+     * Detect template from vault folder structure.
+     *
+     * Scans top-level folders and matches against known template patterns.
+     * Returns null if no template can be confidently detected.
+     *
+     * @param vaultPath - Absolute path to vault directory
+     * @returns Detection result with confidence level, or null if no match
+     */
+    async detectTemplate(vaultPath) {
+        const folders = await this.listTopLevelFolders(vaultPath);
+        // Check for worldbuilding patterns
+        const matched = folders.filter((f) => TemplateDetector.WORLDBUILDING_PATTERNS.some((p) => f.toLowerCase().includes(p.toLowerCase())));
+        if (matched.length >= 2) {
+            const confidence = matched.length >= 4 ? 'high' : matched.length >= 3 ? 'medium' : 'low';
+            return {
+                templateId: 'worldbuilding',
+                confidence,
+                matchedPatterns: matched,
+                message: `Detected worldbuilding vault (${confidence} confidence). Matched folders: ${matched.join(', ')}`,
+            };
+        }
+        return null;
+    }
+    /**
+     * List top-level folders in vault, excluding hidden directories.
+     *
+     * @param vaultPath - Absolute path to vault directory
+     * @returns Array of folder names
+     */
+    async listTopLevelFolders(vaultPath) {
+        const entries = await fs.readdir(vaultPath, { withFileTypes: true });
+        return entries
+            .filter((e) => e.isDirectory())
+            .filter((e) => !e.name.startsWith('.'))
+            .map((e) => e.name);
+    }
+}
+//# sourceMappingURL=detector.js.map

package/dist/templates/detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../src/templates/detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AAmBpC;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IAC3B;;;;OAIG;IACK,MAAM,CAAU,sBAAsB,GAAG;QAC/C,YAAY;QACZ,WAAW;QACX,WAAW;QACX,UAAU;QACV,QAAQ;QACR,OAAO;QACP,UAAU;QACV,SAAS;QACT,MAAM;QACN,QAAQ;QACR,OAAO;KACR,CAAC;IAEF;;;;;;;;OAQG;IACH,KAAK,CAAC,cAAc,CAAC,SAAiB;QACpC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAE1D,mCAAmC;QACnC,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACnC,gBAAgB,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACjD,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAC1C,CACF,CAAC;QAEF,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,UAAU,GACd,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;YAExE,OAAO;gBACL,UAAU,EAAE,eAAe;gBAC3B,UAAU;gBACV,eAAe,EAAE,OAAO;gBACxB,OAAO,EAAE,iCAAiC,UAAU,kCAAkC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAC3G,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,mBAAmB,CAAC,SAAiB;QACjD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;aAC9B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;aACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC"}

package/dist/templates/folder-mapper.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Folder-to-type mapping utility.
+ *
+ * Infers entity types from file paths based on folder names.
+ * Used by the CLI 'fix' command and Obsidian plugin to auto-suggest
+ * entity types for files without frontmatter.
+ */
+import type { FolderMapping } from './types.js';
+/**
+ * Default folder-to-type mappings for common worldbuilding folder structures.
+ *
+ * Supports multiple naming conventions (e.g., 'characters', 'people', 'npcs')
+ * mapping to the same entity type.
+ */
+export declare const DEFAULT_FOLDER_MAPPINGS: FolderMapping[];
+/**
+ * FolderMapper infers entity types from file paths.
+ *
+ * Checks each path segment against folder mappings to determine
+ * the most likely entity type for a file.
+ */
+export declare class FolderMapper {
+    private mappings;
+    /**
+     * Create a FolderMapper with optional custom mappings.
+     *
+     * @param customMappings - Additional or override mappings.
+     *                         Custom mappings take precedence over defaults.
+     */
+    constructor(customMappings?: FolderMapping[]);
+    /**
+     * Infer entity type from a file path.
+     *
+     * Checks each folder in the path against mappings.
+     * Returns the first match found, or null if no match.
+     *
+     * @param filePath - Relative or absolute file path
+     * @returns Inferred entity type name, or null if no match
+     */
+    inferType(filePath: string): string | null;
+    /**
+     * Infer types for multiple file paths.
+     *
+     * @param filePaths - Array of file paths
+     * @returns Map of file path to inferred type (or null)
+     */
+    inferTypes(filePaths: string[]): Map<string, string | null>;
+    /**
+     * Get all registered mappings.
+     *
+     * @returns Array of folder mappings
+     */
+    getMappings(): FolderMapping[];
+    /**
+     * Add a new mapping.
+     *
+     * @param pattern - Folder name pattern
+     * @param entityType - Entity type to assign
+     */
+    addMapping(pattern: string, entityType: string): void;
+}
+/**
+ * Singleton instance for convenience.
+ */
+export declare const folderMapper: FolderMapper;
+//# sourceMappingURL=folder-mapper.d.ts.map

package/dist/templates/folder-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-mapper.d.ts","sourceRoot":"","sources":["../../src/templates/folder-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,aAAa,EAgDlD,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAsB;IAEtC;;;;;OAKG;gBACS,cAAc,GAAE,aAAa,EAAO;IAchD;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAuB1C;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAQ3D;;;;OAIG;IACH,WAAW,IAAI,aAAa,EAAE;IAO9B;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;CAGtD;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,cAAqB,CAAC"}