@hiveforge/hivemind-mcp 2.4.0 → 2.5.0

package/dist/templates/community/ux-research.js

@@ -0,0 +1,347 @@
+/**
+ * UX Research Template
+ *
+ * For synthesizing user research: interviews, insights, hypotheses, and personas.
+ * Helps AI understand the evidence behind product decisions and user needs.
+ *
+ * Entity types:
+ * - interview: Individual research sessions with participants
+ * - insight: Key learnings derived from research
+ * - hypothesis: Testable assumptions about user behavior
+ * - persona: Archetypal user representations
+ * - experiment: Tests to validate or invalidate hypotheses
+ *
+ * Key relationships:
+ * - supports/contradicts: Evidence relationships
+ * - derived_from: Traceability to source research
+ * - validates/invalidates: Experiment outcomes
+ */
+export const uxResearchTemplate = {
+    id: 'ux-research',
+    name: 'UX Research',
+    version: '1.0.0',
+    description: 'Synthesize user research: interviews, insights, hypotheses, and personas. Gives AI grounded context about user needs and product decisions.',
+    // Discovery metadata
+    category: 'research',
+    tags: ['ux', 'user-research', 'interviews', 'personas', 'insights', 'product-management'],
+    author: {
+        name: 'HiveForge',
+        url: 'https://github.com/hiveforge-sh',
+    },
+    repository: 'https://github.com/hiveforge-sh/hivemind',
+    sampleVault: 'samples/ux-research',
+    license: 'MIT',
+    entityTypes: [
+        {
+            name: 'interview',
+            displayName: 'Interview',
+            pluralName: 'Interviews',
+            description: 'A research session with a participant',
+            fields: [
+                {
+                    name: 'participant',
+                    type: 'string',
+                    required: true,
+                    description: 'Anonymized participant identifier (e.g., P01, "Enterprise User 3")',
+                },
+                {
+                    name: 'date',
+                    type: 'date',
+                    required: true,
+                    description: 'Date the interview was conducted',
+                },
+                {
+                    name: 'duration',
+                    type: 'number',
+                    description: 'Duration in minutes',
+                },
+                {
+                    name: 'method',
+                    type: 'enum',
+                    enumValues: ['in-person', 'video', 'phone', 'survey', 'contextual-inquiry', 'usability-test'],
+                    description: 'Research method used',
+                },
+                {
+                    name: 'segment',
+                    type: 'string',
+                    description: 'User segment (e.g., "Power Users", "New Customers")',
+                },
+                {
+                    name: 'researcher',
+                    type: 'string',
+                    description: 'Who conducted the interview',
+                },
+                {
+                    name: 'recordingUrl',
+                    type: 'string',
+                    description: 'Link to recording (if available)',
+                },
+                {
+                    name: 'keyQuotes',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Notable verbatim quotes from participant',
+                },
+            ],
+        },
+        {
+            name: 'insight',
+            displayName: 'Insight',
+            pluralName: 'Insights',
+            description: 'A key learning derived from research',
+            fields: [
+                {
+                    name: 'confidence',
+                    type: 'enum',
+                    enumValues: ['low', 'medium', 'high'],
+                    description: 'Confidence level based on evidence strength',
+                },
+                {
+                    name: 'theme',
+                    type: 'string',
+                    description: 'Research theme or category',
+                },
+                {
+                    name: 'impact',
+                    type: 'enum',
+                    enumValues: ['low', 'medium', 'high', 'critical'],
+                    description: 'Potential business/product impact',
+                },
+                {
+                    name: 'evidenceCount',
+                    type: 'number',
+                    description: 'Number of supporting data points',
+                },
+                {
+                    name: 'quotes',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Supporting quotes from research',
+                },
+                {
+                    name: 'actionable',
+                    type: 'boolean',
+                    description: 'Whether this insight has clear next steps',
+                },
+            ],
+        },
+        {
+            name: 'hypothesis',
+            displayName: 'Hypothesis',
+            pluralName: 'Hypotheses',
+            description: 'A testable assumption about user behavior or needs',
+            fields: [
+                {
+                    name: 'hypothesisStatus',
+                    type: 'enum',
+                    enumValues: ['untested', 'testing', 'validated', 'invalidated', 'partially-validated'],
+                    required: true,
+                    description: 'Current validation status',
+                },
+                {
+                    name: 'statement',
+                    type: 'string',
+                    description: 'Formal hypothesis statement (We believe that... We will know we are right when...)',
+                },
+                {
+                    name: 'metric',
+                    type: 'string',
+                    description: 'Key metric to measure',
+                },
+                {
+                    name: 'target',
+                    type: 'string',
+                    description: 'Success threshold for the metric',
+                },
+                {
+                    name: 'priority',
+                    type: 'enum',
+                    enumValues: ['low', 'medium', 'high', 'critical'],
+                    description: 'Priority for testing',
+                },
+                {
+                    name: 'riskIfWrong',
+                    type: 'string',
+                    description: 'What happens if this hypothesis is wrong',
+                },
+            ],
+        },
+        {
+            name: 'persona',
+            displayName: 'Persona',
+            pluralName: 'Personas',
+            description: 'An archetypal user representation based on research',
+            fields: [
+                {
+                    name: 'segment',
+                    type: 'string',
+                    required: true,
+                    description: 'Market or user segment this persona represents',
+                },
+                {
+                    name: 'role',
+                    type: 'string',
+                    description: 'Job title or role',
+                },
+                {
+                    name: 'goals',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Primary goals and motivations',
+                },
+                {
+                    name: 'frustrations',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Pain points and frustrations',
+                },
+                {
+                    name: 'behaviors',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Typical behaviors and patterns',
+                },
+                {
+                    name: 'tools',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Tools and technologies they use',
+                },
+                {
+                    name: 'quote',
+                    type: 'string',
+                    description: 'Representative quote that captures their mindset',
+                },
+                {
+                    name: 'interviewCount',
+                    type: 'number',
+                    description: 'Number of interviews this persona is based on',
+                },
+            ],
+        },
+        {
+            name: 'experiment',
+            displayName: 'Experiment',
+            pluralName: 'Experiments',
+            description: 'A test designed to validate or invalidate a hypothesis',
+            fields: [
+                {
+                    name: 'experimentStatus',
+                    type: 'enum',
+                    enumValues: ['planned', 'running', 'completed', 'cancelled'],
+                    required: true,
+                    description: 'Current status of the experiment',
+                },
+                {
+                    name: 'experimentType',
+                    type: 'enum',
+                    enumValues: ['a-b-test', 'usability-test', 'prototype-test', 'survey', 'analytics', 'fake-door', 'wizard-of-oz'],
+                    description: 'Type of experiment',
+                },
+                {
+                    name: 'startDate',
+                    type: 'date',
+                    description: 'When the experiment started',
+                },
+                {
+                    name: 'endDate',
+                    type: 'date',
+                    description: 'When the experiment ended',
+                },
+                {
+                    name: 'sampleSize',
+                    type: 'number',
+                    description: 'Number of participants or data points',
+                },
+                {
+                    name: 'result',
+                    type: 'enum',
+                    enumValues: ['positive', 'negative', 'inconclusive', 'pending'],
+                    description: 'Outcome of the experiment',
+                },
+                {
+                    name: 'learnings',
+                    type: 'array',
+                    arrayItemType: 'string',
+                    description: 'Key learnings from the experiment',
+                },
+            ],
+        },
+    ],
+    relationshipTypes: [
+        {
+            id: 'supports',
+            displayName: 'Supports',
+            description: 'Evidence that supports a hypothesis or insight',
+            sourceTypes: ['interview', 'insight', 'experiment'],
+            targetTypes: ['hypothesis', 'insight'],
+            bidirectional: false,
+        },
+        {
+            id: 'contradicts',
+            displayName: 'Contradicts',
+            description: 'Evidence that contradicts a hypothesis or insight',
+            sourceTypes: ['interview', 'insight', 'experiment'],
+            targetTypes: ['hypothesis', 'insight'],
+            bidirectional: false,
+        },
+        {
+            id: 'derived_from',
+            displayName: 'Derived From',
+            description: 'Insight or persona derived from interviews',
+            sourceTypes: ['insight', 'persona'],
+            targetTypes: ['interview'],
+            bidirectional: false,
+        },
+        {
+            id: 'validates',
+            displayName: 'Validates',
+            description: 'Experiment validates a hypothesis',
+            sourceTypes: ['experiment'],
+            targetTypes: ['hypothesis'],
+            bidirectional: false,
+        },
+        {
+            id: 'invalidates',
+            displayName: 'Invalidates',
+            description: 'Experiment invalidates a hypothesis',
+            sourceTypes: ['experiment'],
+            targetTypes: ['hypothesis'],
+            bidirectional: false,
+        },
+        {
+            id: 'represents',
+            displayName: 'Represents',
+            description: 'Persona represents a user segment from interviews',
+            sourceTypes: ['persona'],
+            targetTypes: ['interview'],
+            bidirectional: false,
+        },
+        {
+            id: 'tests',
+            displayName: 'Tests',
+            description: 'Experiment tests a hypothesis',
+            sourceTypes: ['experiment'],
+            targetTypes: ['hypothesis'],
+            bidirectional: false,
+        },
+        {
+            id: 'informed_by',
+            displayName: 'Informed By',
+            description: 'Hypothesis informed by an insight',
+            sourceTypes: ['hypothesis'],
+            targetTypes: ['insight'],
+            bidirectional: false,
+        },
+        {
+            id: 'related',
+            displayName: 'Related To',
+            description: 'General relationship between any entities',
+            sourceTypes: 'any',
+            targetTypes: 'any',
+            bidirectional: true,
+            reverseId: 'related',
+        },
+    ],
+};
+//# sourceMappingURL=ux-research.js.map

package/dist/templates/community/ux-research.js.map

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

package/dist/templates/loader.d.ts

@@ -8,7 +8,7 @@
  * 4. Activate the selected template
  * 5. Pre-generate schemas for performance
  */
-import type { TemplateConfig } from './types.js';
+import type { TemplateConfig, TemplateDefinition } from './types.js';
 /**
  * Find the config.json file.
  *
@@ -22,10 +22,11 @@ import type { TemplateConfig } from './types.js';
  */
 export declare function findConfigFile(configPath?: string): string | null;
 /**
- * Load template configuration from config.json.
+ * Load template configuration from config.json and/or standalone template.json.
  *
  * Searches for config.json in multiple locations and extracts the template
- * section. Returns defaults if config file not found or template section missing.
+ * section. Also checks for standalone template.json in the same directory,
+ * which takes precedence over inline template definitions.
  *
  * @param configPath - Optional explicit path to config file
  * @returns Template configuration object
@@ -44,6 +45,17 @@ export declare function loadTemplateConfig(configPath?: string): TemplateConfig;
  * built-in templates can be referenced by ID.
  */
 export declare function registerBuiltinTemplates(): void;
+/**
+ * Register all community-contributed templates.
+ *
+ * Community templates are registered as 'config' source (not 'builtin')
+ * to distinguish them from core templates while still making them available
+ * for activation.
+ *
+ * This function should be called after built-in templates and before user
+ * templates so that user templates can override community templates if needed.
+ */
+export declare function registerCommunityTemplates(): void;
 /**
  * Register user-defined templates from config.
  *
@@ -77,10 +89,11 @@ export declare function pregenerateSchemas(): void;
  *
  * 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
+ * 2. Register community templates
+ * 3. Load config from file
+ * 4. Register user-defined templates
+ * 5. Activate selected template
+ * 6. Pre-generate schemas
  *
  * This is the main entry point for template system initialization.
  * Call this at application startup before using any template features.
@@ -97,6 +110,48 @@ export declare function pregenerateSchemas(): void;
  * ```
  */
 export declare function initializeTemplates(configPath?: string): TemplateConfig;
+/**
+ * Load a standalone template file from disk.
+ *
+ * Reads a JSON file containing a template definition and validates it
+ * against the TemplateDefinitionSchema.
+ *
+ * @param filePath - Path to the template JSON file
+ * @returns Validated template definition
+ * @throws {Error} If file cannot be read or parsed
+ * @throws {TemplateValidationError} If template fails validation
+ *
+ * @example
+ * ```ts
+ * const template = loadTemplateFile('./template.json');
+ * console.log(`Loaded template: ${template.name}`);
+ * ```
+ */
+export declare function loadTemplateFile(filePath: string): TemplateDefinition;
+/**
+ * Validate a template file without loading it into the registry.
+ *
+ * Useful for CLI tools and pre-flight validation. Returns the validated
+ * template if successful, throws TemplateValidationError with details if not.
+ *
+ * @param filePath - Path to the template JSON file
+ * @returns Validated template definition
+ * @throws {Error} If file cannot be read or parsed
+ * @throws {TemplateValidationError} If template fails validation
+ *
+ * @example
+ * ```ts
+ * try {
+ *   const template = validateTemplateFile('./template.json');
+ *   console.log(`Template "${template.name}" is valid!`);
+ * } catch (err) {
+ *   if (err instanceof TemplateValidationError) {
+ *     console.error(err.toUserMessage());
+ *   }
+ * }
+ * ```
+ */
+export declare function validateTemplateFile(filePath: string): TemplateDefinition;
 /**
  * Convenience function to get an entity schema by name.
  *

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

@@ -1 +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"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/templates/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AASrE;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoBjE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,CAuEtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAI/C;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAOjD;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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,CAoBvE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CA2BrE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAEzE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,8DAWrD"}

package/dist/templates/loader.js

@@ -11,12 +11,13 @@
 import { readFileSync, existsSync } from 'fs';
 import { resolve, dirname } from 'path';
 import { fileURLToPath } from 'url';
-import { validateTemplateConfig } from './validator.js';
+import { validateTemplateConfig, TemplateDefinitionSchema, TemplateValidationError } 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';
+import { communityTemplates } from './community/index.js';
 /**
  * Find the config.json file.
  *
@@ -47,10 +48,11 @@ export function findConfigFile(configPath) {
     return null;
 }
 /**
- * Load template configuration from config.json.
+ * Load template configuration from config.json and/or standalone template.json.
  *
  * Searches for config.json in multiple locations and extracts the template
- * section. Returns defaults if config file not found or template section missing.
+ * section. Also checks for standalone template.json in the same directory,
+ * which takes precedence over inline template definitions.
  *
  * @param configPath - Optional explicit path to config file
  * @returns Template configuration object
@@ -79,6 +81,39 @@ export function loadTemplateConfig(configPath) {
         activeTemplate: 'worldbuilding',
         templates: [],
     };
+    // Check for standalone template.json alongside config.json
+    const configDir = dirname(configFilePath);
+    const standaloneTemplatePath = resolve(configDir, 'template.json');
+    if (existsSync(standaloneTemplatePath)) {
+        try {
+            const standaloneTemplate = loadTemplateFile(standaloneTemplatePath);
+            // Ensure templates array exists
+            if (!templateConfig.templates) {
+                templateConfig.templates = [];
+            }
+            // Check if template with same ID already exists in config
+            const existingIndex = templateConfig.templates.findIndex((t) => t.id === standaloneTemplate.id);
+            if (existingIndex >= 0) {
+                // Standalone template takes precedence - replace existing
+                templateConfig.templates[existingIndex] = standaloneTemplate;
+            }
+            else {
+                // Add standalone template to the list
+                templateConfig.templates.push(standaloneTemplate);
+            }
+            // If no activeTemplate specified, use the standalone template
+            if (!templateConfig.activeTemplate || templateConfig.activeTemplate === 'worldbuilding') {
+                templateConfig.activeTemplate = standaloneTemplate.id;
+            }
+        }
+        catch (err) {
+            // If it's a validation error, rethrow with context
+            if (err instanceof TemplateValidationError) {
+                throw err;
+            }
+            throw new Error(`Failed to load standalone template.json: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
     // Validate the template config
     return validateTemplateConfig(templateConfig);
 }
@@ -98,6 +133,24 @@ export function registerBuiltinTemplates() {
     templateRegistry.register(researchTemplate, 'builtin');
     templateRegistry.register(peopleManagementTemplate, 'builtin');
 }
+/**
+ * Register all community-contributed templates.
+ *
+ * Community templates are registered as 'config' source (not 'builtin')
+ * to distinguish them from core templates while still making them available
+ * for activation.
+ *
+ * This function should be called after built-in templates and before user
+ * templates so that user templates can override community templates if needed.
+ */
+export function registerCommunityTemplates() {
+    for (const template of communityTemplates) {
+        // Skip if template with same ID is already registered
+        if (!templateRegistry.has(template.id)) {
+            templateRegistry.register(template, 'config');
+        }
+    }
+}
 /**
  * Register user-defined templates from config.
  *
@@ -148,10 +201,11 @@ export function pregenerateSchemas() {
  *
  * 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
+ * 2. Register community templates
+ * 3. Load config from file
+ * 4. Register user-defined templates
+ * 5. Activate selected template
+ * 6. Pre-generate schemas
  *
  * This is the main entry point for template system initialization.
  * Call this at application startup before using any template features.
@@ -170,16 +224,83 @@ export function pregenerateSchemas() {
 export function initializeTemplates(configPath) {
     // 1. Register built-in templates
     registerBuiltinTemplates();
-    // 2. Load config
+    // 2. Register community templates
+    registerCommunityTemplates();
+    // 3. Load config
     const config = loadTemplateConfig(configPath);
-    // 3. Register user templates
+    // 4. Register user templates
     registerUserTemplates(config);
-    // 4. Activate selected template
+    // 5. Activate selected template
     activateTemplate(config);
-    // 5. Pre-generate schemas
+    // 6. Pre-generate schemas
     pregenerateSchemas();
     return config;
 }
+/**
+ * Load a standalone template file from disk.
+ *
+ * Reads a JSON file containing a template definition and validates it
+ * against the TemplateDefinitionSchema.
+ *
+ * @param filePath - Path to the template JSON file
+ * @returns Validated template definition
+ * @throws {Error} If file cannot be read or parsed
+ * @throws {TemplateValidationError} If template fails validation
+ *
+ * @example
+ * ```ts
+ * const template = loadTemplateFile('./template.json');
+ * console.log(`Loaded template: ${template.name}`);
+ * ```
+ */
+export function loadTemplateFile(filePath) {
+    const resolvedPath = resolve(filePath);
+    let fileContent;
+    try {
+        fileContent = readFileSync(resolvedPath, 'utf-8');
+    }
+    catch (err) {
+        throw new Error(`Failed to read template file at ${resolvedPath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    let templateData;
+    try {
+        templateData = JSON.parse(fileContent);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse template file as JSON: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const result = TemplateDefinitionSchema.safeParse(templateData);
+    if (!result.success) {
+        throw new TemplateValidationError('Invalid template definition', result.error.issues);
+    }
+    return result.data;
+}
+/**
+ * Validate a template file without loading it into the registry.
+ *
+ * Useful for CLI tools and pre-flight validation. Returns the validated
+ * template if successful, throws TemplateValidationError with details if not.
+ *
+ * @param filePath - Path to the template JSON file
+ * @returns Validated template definition
+ * @throws {Error} If file cannot be read or parsed
+ * @throws {TemplateValidationError} If template fails validation
+ *
+ * @example
+ * ```ts
+ * try {
+ *   const template = validateTemplateFile('./template.json');
+ *   console.log(`Template "${template.name}" is valid!`);
+ * } catch (err) {
+ *   if (err instanceof TemplateValidationError) {
+ *     console.error(err.toUserMessage());
+ *   }
+ * }
+ * ```
+ */
+export function validateTemplateFile(filePath) {
+    return loadTemplateFile(filePath);
+}
 /**
  * Convenience function to get an entity schema by name.
  *