@hiveforge/hivemind-mcp 2.2.0 → 2.4.0

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"}

package/dist/templates/folder-mapper.js

@@ -0,0 +1,148 @@
+/**
+ * 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.
+ */
+/**
+ * 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 const DEFAULT_FOLDER_MAPPINGS = [
+    // Character mappings
+    { pattern: 'characters', entityType: 'character' },
+    { pattern: 'people', entityType: 'character' },
+    { pattern: 'npcs', entityType: 'character' },
+    { pattern: 'pcs', entityType: 'character' },
+    { pattern: 'cast', entityType: 'character' },
+    // Location mappings
+    { pattern: 'locations', entityType: 'location' },
+    { pattern: 'places', entityType: 'location' },
+    { pattern: 'geography', entityType: 'location' },
+    { pattern: 'world', entityType: 'location' },
+    { pattern: 'regions', entityType: 'location' },
+    { pattern: 'cities', entityType: 'location' },
+    { pattern: 'towns', entityType: 'location' },
+    // Event mappings
+    { pattern: 'events', entityType: 'event' },
+    { pattern: 'timeline', entityType: 'event' },
+    { pattern: 'history', entityType: 'event' },
+    { pattern: 'sessions', entityType: 'event' },
+    // Faction mappings
+    { pattern: 'factions', entityType: 'faction' },
+    { pattern: 'organizations', entityType: 'faction' },
+    { pattern: 'groups', entityType: 'faction' },
+    { pattern: 'guilds', entityType: 'faction' },
+    { pattern: 'houses', entityType: 'faction' },
+    // Lore mappings
+    { pattern: 'lore', entityType: 'lore' },
+    { pattern: 'mythology', entityType: 'lore' },
+    { pattern: 'magic', entityType: 'lore' },
+    { pattern: 'culture', entityType: 'lore' },
+    { pattern: 'religion', entityType: 'lore' },
+    // Asset mappings
+    { pattern: 'assets', entityType: 'asset' },
+    { pattern: 'images', entityType: 'asset' },
+    { pattern: 'media', entityType: 'asset' },
+    // Reference mappings
+    { pattern: 'references', entityType: 'reference' },
+    { pattern: 'sources', entityType: 'reference' },
+    { pattern: 'inspiration', entityType: 'reference' },
+    { pattern: 'notes', entityType: 'reference' },
+    { pattern: 'meta', entityType: 'reference' },
+];
+/**
+ * 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 class FolderMapper {
+    mappings;
+    /**
+     * Create a FolderMapper with optional custom mappings.
+     *
+     * @param customMappings - Additional or override mappings.
+     *                         Custom mappings take precedence over defaults.
+     */
+    constructor(customMappings = []) {
+        this.mappings = new Map();
+        // Add default mappings first
+        for (const mapping of DEFAULT_FOLDER_MAPPINGS) {
+            this.mappings.set(mapping.pattern.toLowerCase(), mapping.entityType);
+        }
+        // Override with custom mappings
+        for (const mapping of customMappings) {
+            this.mappings.set(mapping.pattern.toLowerCase(), mapping.entityType);
+        }
+    }
+    /**
+     * 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) {
+        // Split on both forward and back slashes
+        const parts = filePath.toLowerCase().split(/[/\\]/);
+        // Check each path part against mappings
+        for (const part of parts) {
+            // Exact match
+            const exactMatch = this.mappings.get(part);
+            if (exactMatch) {
+                return exactMatch;
+            }
+            // Prefix match (e.g., 'characters-main' matches 'characters')
+            for (const [pattern, entityType] of this.mappings) {
+                if (part.startsWith(pattern)) {
+                    return entityType;
+                }
+            }
+        }
+        return 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) {
+        const results = new Map();
+        for (const path of filePaths) {
+            results.set(path, this.inferType(path));
+        }
+        return results;
+    }
+    /**
+     * Get all registered mappings.
+     *
+     * @returns Array of folder mappings
+     */
+    getMappings() {
+        return Array.from(this.mappings.entries()).map(([pattern, entityType]) => ({
+            pattern,
+            entityType,
+        }));
+    }
+    /**
+     * Add a new mapping.
+     *
+     * @param pattern - Folder name pattern
+     * @param entityType - Entity type to assign
+     */
+    addMapping(pattern, entityType) {
+        this.mappings.set(pattern.toLowerCase(), entityType);
+    }
+}
+/**
+ * Singleton instance for convenience.
+ */
+export const folderMapper = new FolderMapper();
+//# sourceMappingURL=folder-mapper.js.map

package/dist/templates/folder-mapper.js.map

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

package/dist/templates/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Template system for pluggable entity type definitions.
+ *
+ * This module enables users to define custom entity types via config
+ * without writing code.
+ */
+export * from './types.js';
+export * from './schema-factory.js';
+export * from './validator.js';
+export * from './registry.js';
+export * from './loader.js';
+export * from './detector.js';
+export * from './folder-mapper.js';
+export * from './builtin/worldbuilding.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC"}

package/dist/templates/index.js

@@ -0,0 +1,15 @@
+/**
+ * Template system for pluggable entity type definitions.
+ *
+ * This module enables users to define custom entity types via config
+ * without writing code.
+ */
+export * from './types.js';
+export * from './schema-factory.js';
+export * from './validator.js';
+export * from './registry.js';
+export * from './loader.js';
+export * from './detector.js';
+export * from './folder-mapper.js';
+export * from './builtin/worldbuilding.js';
+//# sourceMappingURL=index.js.map

package/dist/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC"}

package/dist/templates/loader.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Template configuration loader.
+ *
+ * Provides functions to:
+ * 1. Load template configuration from config.json
+ * 2. Register built-in templates
+ * 3. Validate and register user-defined templates
+ * 4. Activate the selected template
+ * 5. Pre-generate schemas for performance
+ */
+import type { TemplateConfig } from './types.js';
+/**
+ * Find the config.json file.
+ *
+ * Searches in:
+ * 1. Provided path (if given)
+ * 2. Current working directory
+ * 3. Module directory (for development)
+ *
+ * @param configPath - Optional explicit path to config file
+ * @returns Path to config.json if found, null otherwise
+ */
+export declare function findConfigFile(configPath?: string): string | null;
+/**
+ * Load template configuration from config.json.
+ *
+ * Searches for config.json in multiple locations and extracts the template
+ * section. Returns defaults if config file not found or template section missing.
+ *
+ * @param configPath - Optional explicit path to config file
+ * @returns Template configuration object
+ * @throws {Error} If config file is found but contains invalid template config
+ */
+export declare function loadTemplateConfig(configPath?: string): TemplateConfig;
+/**
+ * Register all built-in templates.
+ *
+ * Includes:
+ * - worldbuilding: Characters, locations, events, factions, lore, assets
+ * - research: Papers, citations, concepts, notes
+ * - people-management: People, goals, teams, 1:1 meetings
+ *
+ * This function should be called before loading user templates to ensure
+ * built-in templates can be referenced by ID.
+ */
+export declare function registerBuiltinTemplates(): void;
+/**
+ * Register user-defined templates from config.
+ *
+ * Validates each template and registers it in the registry.
+ *
+ * @param config - Template configuration from config.json
+ * @throws {Error} If any user template fails validation or has duplicate ID
+ */
+export declare function registerUserTemplates(config: TemplateConfig): void;
+/**
+ * Activate the selected template.
+ *
+ * Sets the active template in the registry based on the activeTemplate field
+ * in the config.
+ *
+ * @param config - Template configuration from config.json
+ * @throws {Error} If the specified template is not registered
+ */
+export declare function activateTemplate(config: TemplateConfig): void;
+/**
+ * Pre-generate schemas for all entity types in the active template.
+ *
+ * Caches schemas in the schema factory for fast runtime access.
+ * This improves performance for note parsing and validation.
+ *
+ * @throws {Error} If no template is active
+ */
+export declare function pregenerateSchemas(): void;
+/**
+ * Full initialization sequence for template system.
+ *
+ * Performs complete setup:
+ * 1. Register built-in templates
+ * 2. Load config from file
+ * 3. Register user-defined templates
+ * 4. Activate selected template
+ * 5. Pre-generate schemas
+ *
+ * This is the main entry point for template system initialization.
+ * Call this at application startup before using any template features.
+ *
+ * @param configPath - Optional explicit path to config file
+ * @returns The loaded template configuration
+ * @throws {Error} If initialization fails at any step
+ *
+ * @example
+ * ```ts
+ * // At application startup
+ * const config = initializeTemplates();
+ * console.log(`Loaded template: ${config.activeTemplate}`);
+ * ```
+ */
+export declare function initializeTemplates(configPath?: string): TemplateConfig;
+/**
+ * Convenience function to get an entity schema by name.
+ *
+ * Retrieves the entity type config from the active template and returns
+ * the corresponding Zod schema.
+ *
+ * @param entityTypeName - Name of the entity type (e.g., "character", "location")
+ * @returns Zod schema for the entity type
+ * @throws {Error} If no template is active or entity type not found
+ *
+ * @example
+ * ```ts
+ * const characterSchema = getEntitySchema('character');
+ * const validated = characterSchema.parse(frontmatter);
+ * ```
+ */
+export declare function getEntitySchema(entityTypeName: string): import("zod").ZodObject<any, import("zod/v4/core").$strip>;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/templates/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAQjD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoBjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,CA8BtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAI/C;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CASlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAE7D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAQzC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,CAiBvE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,8DAWrD"}

package/dist/templates/loader.js

@@ -0,0 +1,208 @@
+/**
+ * Template configuration loader.
+ *
+ * Provides functions to:
+ * 1. Load template configuration from config.json
+ * 2. Register built-in templates
+ * 3. Validate and register user-defined templates
+ * 4. Activate the selected template
+ * 5. Pre-generate schemas for performance
+ */
+import { readFileSync, existsSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { validateTemplateConfig } from './validator.js';
+import { templateRegistry } from './registry.js';
+import { schemaFactory } from './schema-factory.js';
+import { worldbuildingTemplate } from './builtin/worldbuilding.js';
+import { researchTemplate } from './builtin/research.js';
+import { peopleManagementTemplate } from './builtin/people-management.js';
+/**
+ * Find the config.json file.
+ *
+ * Searches in:
+ * 1. Provided path (if given)
+ * 2. Current working directory
+ * 3. Module directory (for development)
+ *
+ * @param configPath - Optional explicit path to config file
+ * @returns Path to config.json if found, null otherwise
+ */
+export function findConfigFile(configPath) {
+    // If explicit path provided, use it
+    if (configPath) {
+        return existsSync(configPath) ? resolve(configPath) : null;
+    }
+    // Try current working directory
+    const cwdConfig = resolve(process.cwd(), 'config.json');
+    if (existsSync(cwdConfig)) {
+        return cwdConfig;
+    }
+    // Try module directory (for development/testing)
+    const moduleDir = dirname(fileURLToPath(import.meta.url));
+    const moduleConfig = resolve(moduleDir, '../../config.json');
+    if (existsSync(moduleConfig)) {
+        return moduleConfig;
+    }
+    return null;
+}
+/**
+ * Load template configuration from config.json.
+ *
+ * Searches for config.json in multiple locations and extracts the template
+ * section. Returns defaults if config file not found or template section missing.
+ *
+ * @param configPath - Optional explicit path to config file
+ * @returns Template configuration object
+ * @throws {Error} If config file is found but contains invalid template config
+ */
+export function loadTemplateConfig(configPath) {
+    const configFilePath = findConfigFile(configPath);
+    // If no config file found, return defaults
+    if (!configFilePath) {
+        return {
+            activeTemplate: 'worldbuilding',
+            templates: [],
+        };
+    }
+    // Read and parse config file
+    let configContent;
+    try {
+        const fileContent = readFileSync(configFilePath, 'utf-8');
+        configContent = JSON.parse(fileContent);
+    }
+    catch (err) {
+        throw new Error(`Failed to read or parse config file at ${configFilePath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // Extract template section (use defaults if missing)
+    const templateConfig = configContent.template || {
+        activeTemplate: 'worldbuilding',
+        templates: [],
+    };
+    // Validate the template config
+    return validateTemplateConfig(templateConfig);
+}
+/**
+ * Register all built-in templates.
+ *
+ * Includes:
+ * - worldbuilding: Characters, locations, events, factions, lore, assets
+ * - research: Papers, citations, concepts, notes
+ * - people-management: People, goals, teams, 1:1 meetings
+ *
+ * This function should be called before loading user templates to ensure
+ * built-in templates can be referenced by ID.
+ */
+export function registerBuiltinTemplates() {
+    templateRegistry.register(worldbuildingTemplate, 'builtin');
+    templateRegistry.register(researchTemplate, 'builtin');
+    templateRegistry.register(peopleManagementTemplate, 'builtin');
+}
+/**
+ * Register user-defined templates from config.
+ *
+ * Validates each template and registers it in the registry.
+ *
+ * @param config - Template configuration from config.json
+ * @throws {Error} If any user template fails validation or has duplicate ID
+ */
+export function registerUserTemplates(config) {
+    if (!config.templates || config.templates.length === 0) {
+        return;
+    }
+    for (const template of config.templates) {
+        // Template already validated by loadTemplateConfig
+        templateRegistry.register(template, 'config');
+    }
+}
+/**
+ * Activate the selected template.
+ *
+ * Sets the active template in the registry based on the activeTemplate field
+ * in the config.
+ *
+ * @param config - Template configuration from config.json
+ * @throws {Error} If the specified template is not registered
+ */
+export function activateTemplate(config) {
+    templateRegistry.activate(config.activeTemplate);
+}
+/**
+ * Pre-generate schemas for all entity types in the active template.
+ *
+ * Caches schemas in the schema factory for fast runtime access.
+ * This improves performance for note parsing and validation.
+ *
+ * @throws {Error} If no template is active
+ */
+export function pregenerateSchemas() {
+    const activeTemplate = templateRegistry.getActive();
+    if (!activeTemplate) {
+        throw new Error('Cannot pregenerate schemas: no active template');
+    }
+    // Generate schemas for all entity types
+    schemaFactory.generateSchemas(activeTemplate.entityTypes);
+}
+/**
+ * Full initialization sequence for template system.
+ *
+ * Performs complete setup:
+ * 1. Register built-in templates
+ * 2. Load config from file
+ * 3. Register user-defined templates
+ * 4. Activate selected template
+ * 5. Pre-generate schemas
+ *
+ * This is the main entry point for template system initialization.
+ * Call this at application startup before using any template features.
+ *
+ * @param configPath - Optional explicit path to config file
+ * @returns The loaded template configuration
+ * @throws {Error} If initialization fails at any step
+ *
+ * @example
+ * ```ts
+ * // At application startup
+ * const config = initializeTemplates();
+ * console.log(`Loaded template: ${config.activeTemplate}`);
+ * ```
+ */
+export function initializeTemplates(configPath) {
+    // 1. Register built-in templates
+    registerBuiltinTemplates();
+    // 2. Load config
+    const config = loadTemplateConfig(configPath);
+    // 3. Register user templates
+    registerUserTemplates(config);
+    // 4. Activate selected template
+    activateTemplate(config);
+    // 5. Pre-generate schemas
+    pregenerateSchemas();
+    return config;
+}
+/**
+ * Convenience function to get an entity schema by name.
+ *
+ * Retrieves the entity type config from the active template and returns
+ * the corresponding Zod schema.
+ *
+ * @param entityTypeName - Name of the entity type (e.g., "character", "location")
+ * @returns Zod schema for the entity type
+ * @throws {Error} If no template is active or entity type not found
+ *
+ * @example
+ * ```ts
+ * const characterSchema = getEntitySchema('character');
+ * const validated = characterSchema.parse(frontmatter);
+ * ```
+ */
+export function getEntitySchema(entityTypeName) {
+    const entityType = templateRegistry.getEntityType(entityTypeName);
+    if (!entityType) {
+        const activeTemplate = templateRegistry.getActive();
+        const availableTypes = activeTemplate?.entityTypes.map((t) => t.name).join(', ') || 'none';
+        throw new Error(`Entity type "${entityTypeName}" not found in active template. Available types: ${availableTypes}`);
+    }
+    return schemaFactory.getSchema(entityType);
+}
+//# sourceMappingURL=loader.js.map