@hiveforge/hivemind-mcp 2.2.0 → 2.4.0

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/templates/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,OAAO,GACP,MAAM,GACN,QAAQ,CAAC;AAEb;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IAEb,6BAA6B;IAC7B,IAAI,EAAE,SAAS,CAAC;IAEhB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,SAAS,CAAC;IAE1B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IAEb,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IAEpB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,8CAA8C;IAC9C,MAAM,EAAE,WAAW,EAAE,CAAC;IAEtB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IAEX,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IAEb,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAEhB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6CAA6C;IAC7C,WAAW,EAAE,gBAAgB,EAAE,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAEjC,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,wDAAwD;IACxD,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAE7B,sDAAsD;IACtD,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC9C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/templates/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,OAAO,GACP,MAAM,GACN,QAAQ,CAAC;AAEb;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IAEb,6BAA6B;IAC7B,IAAI,EAAE,SAAS,CAAC;IAEhB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,SAAS,CAAC;IAE1B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,yEAAyE;IACzE,EAAE,EAAE,MAAM,CAAC;IAEX,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IAEpB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,kDAAkD;IAClD,WAAW,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAE9B,kDAAkD;IAClD,WAAW,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAE9B,kDAAkD;IAClD,aAAa,EAAE,OAAO,CAAC;IAEvB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,uDAAuD;IACvD,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IAEb,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IAEpB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,8CAA8C;IAC9C,MAAM,EAAE,WAAW,EAAE,CAAC;IAEtB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IAEX,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IAEb,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAEhB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6CAA6C;IAC7C,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAEhC,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,sBAAsB,EAAE,CAAC;CAC9C;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAEjC,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,wDAAwD;IACxD,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAE7B,sDAAsD;IACtD,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAE7C,0DAA0D;IAC1D,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CAC1D;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAEhB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/templates/validator.d.ts

@@ -0,0 +1,310 @@
+/**
+ * Template configuration validation using Zod.
+ *
+ * Provides schema validation for template configs to fail fast at startup
+ * before schema generation, ensuring user configs are valid.
+ */
+import { z } from 'zod';
+import type { TemplateConfig } from './types.js';
+/**
+ * Zod schema for field configuration validation.
+ *
+ * Validates:
+ * - Field names are camelCase alphanumeric
+ * - Type is one of the supported FieldType values
+ * - Enum fields have enumValues defined
+ * - Array fields have valid arrayItemType
+ */
+export declare const FieldConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        enum: "enum";
+        array: "array";
+        date: "date";
+        record: "record";
+    }>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodUnknown>;
+    enumValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    arrayItemType: z.ZodOptional<z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        enum: "enum";
+        array: "array";
+        date: "date";
+        record: "record";
+    }>>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Zod schema for entity type configuration validation.
+ *
+ * Validates:
+ * - Entity type names are lowercase alphanumeric
+ * - Display names and plural names are provided
+ * - Fields array is valid
+ */
+export declare const EntityTypeConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    pluralName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    fields: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            enum: "enum";
+            array: "array";
+            date: "date";
+            record: "record";
+        }>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        default: z.ZodOptional<z.ZodUnknown>;
+        enumValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        arrayItemType: z.ZodOptional<z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            enum: "enum";
+            array: "array";
+            date: "date";
+            record: "record";
+        }>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    icon: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Zod schema for relationship type configuration validation.
+ *
+ * Validates:
+ * - Relationship IDs are snake_case
+ * - Source/target types are valid
+ * - Bidirectional relationships specify reverseId
+ */
+export declare const RelationshipTypeConfigSchema: z.ZodObject<{
+    id: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    sourceTypes: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"any">]>;
+    targetTypes: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"any">]>;
+    bidirectional: z.ZodDefault<z.ZodBoolean>;
+    reverseId: z.ZodOptional<z.ZodString>;
+    properties: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            enum: "enum";
+            array: "array";
+            date: "date";
+            record: "record";
+        }>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        default: z.ZodOptional<z.ZodUnknown>;
+        enumValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        arrayItemType: z.ZodOptional<z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            enum: "enum";
+            array: "array";
+            date: "date";
+            record: "record";
+        }>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * Zod schema for template definition validation.
+ *
+ * Validates:
+ * - Template ID is lowercase alphanumeric with hyphens
+ * - Version follows semantic versioning (X.Y.Z)
+ * - Entity types array is valid and non-empty
+ */
+export declare const TemplateDefinitionSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    entityTypes: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        pluralName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        fields: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                enum: "enum";
+                array: "array";
+                date: "date";
+                record: "record";
+            }>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            arrayItemType: z.ZodOptional<z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                enum: "enum";
+                array: "array";
+                date: "date";
+                record: "record";
+            }>>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        icon: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    relationshipTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        sourceTypes: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"any">]>;
+        targetTypes: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"any">]>;
+        bidirectional: z.ZodDefault<z.ZodBoolean>;
+        reverseId: z.ZodOptional<z.ZodString>;
+        properties: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                enum: "enum";
+                array: "array";
+                date: "date";
+                record: "record";
+            }>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            arrayItemType: z.ZodOptional<z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                enum: "enum";
+                array: "array";
+                date: "date";
+                record: "record";
+            }>>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * Zod schema for full template configuration validation.
+ *
+ * Validates:
+ * - Templates array (if provided) contains valid templates
+ * - activeTemplate is specified
+ */
+export declare const TemplateConfigSchema: z.ZodObject<{
+    templates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        version: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        entityTypes: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            displayName: z.ZodString;
+            pluralName: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            fields: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                type: z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                    enum: "enum";
+                    array: "array";
+                    date: "date";
+                    record: "record";
+                }>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                default: z.ZodOptional<z.ZodUnknown>;
+                enumValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                arrayItemType: z.ZodOptional<z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                    enum: "enum";
+                    array: "array";
+                    date: "date";
+                    record: "record";
+                }>>;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            icon: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        relationshipTypes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            displayName: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            sourceTypes: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"any">]>;
+            targetTypes: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"any">]>;
+            bidirectional: z.ZodDefault<z.ZodBoolean>;
+            reverseId: z.ZodOptional<z.ZodString>;
+            properties: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                type: z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                    enum: "enum";
+                    array: "array";
+                    date: "date";
+                    record: "record";
+                }>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                default: z.ZodOptional<z.ZodUnknown>;
+                enumValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                arrayItemType: z.ZodOptional<z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                    enum: "enum";
+                    array: "array";
+                    date: "date";
+                    record: "record";
+                }>>;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    activeTemplate: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Custom error class for template validation failures.
+ *
+ * Provides structured error information and user-friendly messages.
+ */
+export declare class TemplateValidationError extends Error {
+    readonly issues: z.ZodIssue[];
+    constructor(message: string, issues: z.ZodIssue[]);
+    /**
+     * Converts Zod validation issues to a user-friendly error message.
+     *
+     * @returns Formatted error message with all validation issues
+     */
+    toUserMessage(): string;
+}
+/**
+ * Validates template configuration against schema.
+ *
+ * @param config - Template configuration to validate
+ * @returns Validated and typed configuration
+ * @throws {TemplateValidationError} If validation fails with details of all issues
+ */
+export declare function validateTemplateConfig(config: unknown): TemplateConfig;
+//# sourceMappingURL=validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/templates/validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAKV,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;iBAgCM,CAAC;AAErC;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAaK,CAAC;AAEzC;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BM,CAAC;AAEhD;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBK,CAAC;AAE3C;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGK,CAAC;AAEvC;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;aAG9B,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;gBADpC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAMtC;;;;OAIG;IACH,aAAa,IAAI,MAAM;CAUxB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,CAQtE"}

package/dist/templates/validator.js

@@ -0,0 +1,169 @@
+/**
+ * Template configuration validation using Zod.
+ *
+ * Provides schema validation for template configs to fail fast at startup
+ * before schema generation, ensuring user configs are valid.
+ */
+import { z } from 'zod';
+/**
+ * Zod schema for field configuration validation.
+ *
+ * Validates:
+ * - Field names are camelCase alphanumeric
+ * - Type is one of the supported FieldType values
+ * - Enum fields have enumValues defined
+ * - Array fields have valid arrayItemType
+ */
+export const FieldConfigSchema = z
+    .object({
+    name: z
+        .string()
+        .min(1, 'Field name cannot be empty')
+        .regex(/^[a-z][a-zA-Z0-9_]*$/, 'Field name must be camelCase or snake_case alphanumeric (e.g., "age", "statusCode", "event_type")'),
+    type: z.enum(['string', 'number', 'boolean', 'enum', 'array', 'date', 'record'], {
+        message: 'Field type must be one of: string, number, boolean, enum, array, date, record',
+    }),
+    required: z.boolean().optional(),
+    default: z.unknown().optional(),
+    enumValues: z.array(z.string()).optional(),
+    arrayItemType: z
+        .enum(['string', 'number', 'boolean', 'enum', 'array', 'date', 'record'])
+        .optional(),
+    description: z.string().optional(),
+})
+    .refine((field) => {
+    // Enum fields must have enumValues
+    if (field.type === 'enum' && (!field.enumValues || field.enumValues.length === 0)) {
+        return false;
+    }
+    return true;
+}, {
+    message: 'Enum fields must define enumValues with at least one value',
+    path: ['enumValues'],
+});
+/**
+ * Zod schema for entity type configuration validation.
+ *
+ * Validates:
+ * - Entity type names are lowercase alphanumeric
+ * - Display names and plural names are provided
+ * - Fields array is valid
+ */
+export const EntityTypeConfigSchema = z.object({
+    name: z
+        .string()
+        .min(1, 'Entity type name cannot be empty')
+        .regex(/^[a-z][a-z0-9_]*$/, 'Entity type name must be lowercase alphanumeric with underscores (e.g., "character", "one_on_one")'),
+    displayName: z.string().min(1, 'Display name cannot be empty'),
+    pluralName: z.string().min(1, 'Plural name cannot be empty'),
+    description: z.string().optional(),
+    fields: z.array(FieldConfigSchema),
+    icon: z.string().optional(),
+});
+/**
+ * Zod schema for relationship type configuration validation.
+ *
+ * Validates:
+ * - Relationship IDs are snake_case
+ * - Source/target types are valid
+ * - Bidirectional relationships specify reverseId
+ */
+export const RelationshipTypeConfigSchema = z
+    .object({
+    id: z
+        .string()
+        .min(1, 'Relationship ID cannot be empty')
+        .regex(/^[a-z][a-z0-9_]*$/, 'Relationship ID must be snake_case (e.g., "knows", "allied_with")'),
+    displayName: z.string().min(1, 'Display name cannot be empty'),
+    description: z.string().optional(),
+    sourceTypes: z.union([
+        z.array(z.string()).min(1, 'sourceTypes must have at least one type'),
+        z.literal('any'),
+    ]),
+    targetTypes: z.union([
+        z.array(z.string()).min(1, 'targetTypes must have at least one type'),
+        z.literal('any'),
+    ]),
+    bidirectional: z.boolean().default(false),
+    reverseId: z.string().optional(),
+    properties: z.array(FieldConfigSchema).optional(),
+})
+    .refine((rel) => !rel.bidirectional || rel.reverseId, {
+    message: 'Bidirectional relationships must specify reverseId',
+    path: ['reverseId'],
+});
+/**
+ * Zod schema for template definition validation.
+ *
+ * Validates:
+ * - Template ID is lowercase alphanumeric with hyphens
+ * - Version follows semantic versioning (X.Y.Z)
+ * - Entity types array is valid and non-empty
+ */
+export const TemplateDefinitionSchema = z.object({
+    id: z
+        .string()
+        .min(1, 'Template ID cannot be empty')
+        .regex(/^[a-z][a-z0-9-]*$/, 'Template ID must be lowercase alphanumeric with hyphens (e.g., "worldbuilding", "game-design")'),
+    name: z.string().min(1, 'Template name cannot be empty'),
+    version: z
+        .string()
+        .regex(/^\d+\.\d+\.\d+$/, 'Version must follow semantic versioning (e.g., "1.0.0")'),
+    description: z.string().optional(),
+    entityTypes: z
+        .array(EntityTypeConfigSchema)
+        .min(1, 'Template must define at least one entity type'),
+    relationshipTypes: z.array(RelationshipTypeConfigSchema).optional(),
+});
+/**
+ * Zod schema for full template configuration validation.
+ *
+ * Validates:
+ * - Templates array (if provided) contains valid templates
+ * - activeTemplate is specified
+ */
+export const TemplateConfigSchema = z.object({
+    templates: z.array(TemplateDefinitionSchema).optional(),
+    activeTemplate: z.string().min(1, 'activeTemplate must be specified'),
+});
+/**
+ * Custom error class for template validation failures.
+ *
+ * Provides structured error information and user-friendly messages.
+ */
+export class TemplateValidationError extends Error {
+    issues;
+    constructor(message, issues) {
+        super(message);
+        this.issues = issues;
+        this.name = 'TemplateValidationError';
+    }
+    /**
+     * Converts Zod validation issues to a user-friendly error message.
+     *
+     * @returns Formatted error message with all validation issues
+     */
+    toUserMessage() {
+        const lines = ['Template configuration validation failed:', ''];
+        for (const issue of this.issues) {
+            const path = issue.path.length > 0 ? issue.path.join('.') : 'root';
+            lines.push(`  • ${path}: ${issue.message}`);
+        }
+        return lines.join('\n');
+    }
+}
+/**
+ * Validates template configuration against schema.
+ *
+ * @param config - Template configuration to validate
+ * @returns Validated and typed configuration
+ * @throws {TemplateValidationError} If validation fails with details of all issues
+ */
+export function validateTemplateConfig(config) {
+    const result = TemplateConfigSchema.safeParse(config);
+    if (!result.success) {
+        throw new TemplateValidationError('Invalid template configuration', result.error.issues);
+    }
+    return result.data;
+}
+//# sourceMappingURL=validator.js.map

package/dist/templates/validator.js.map

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

package/dist/types/index.d.ts

@@ -7,14 +7,24 @@ export declare const NoteStatusSchema: z.ZodEnum<{
     archived: "archived";
 }>;
 export type NoteStatus = z.infer<typeof NoteStatusSchema>;
+/** Base entity types that are always supported */
+export declare const BASE_NOTE_TYPES: readonly ["character", "location", "event", "faction", "system", "asset", "lore"];
+/**
+ * Factory function for dynamic NoteType support.
+ * Allows custom types (e.g., 'reference') beyond the hardcoded base types.
+ *
+ * @param additionalTypes - Custom entity type names to include
+ * @returns Zod schema that validates against base + additional types
+ */
+export declare function createNoteTypeSchema(additionalTypes?: string[]): z.ZodType<string>;
 export declare const NoteTypeSchema: z.ZodEnum<{
     character: "character";
     location: "location";
     event: "event";
     faction: "faction";
-    system: "system";
-    asset: "asset";
     lore: "lore";
+    asset: "asset";
+    system: "system";
 }>;
 export type NoteType = z.infer<typeof NoteTypeSchema>;
 export declare const ImportanceSchema: z.ZodEnum<{
@@ -23,17 +33,43 @@ export declare const ImportanceSchema: z.ZodEnum<{
     background: "background";
 }>;
 export type Importance = z.infer<typeof ImportanceSchema>;
+/**
+ * Factory function for dynamic BaseFrontmatter schema.
+ * Uses a custom NoteType schema for template-aware validation.
+ *
+ * @param noteTypeSchema - Custom NoteType schema (from createNoteTypeSchema)
+ * @returns Base frontmatter schema with the custom type validation
+ */
+export declare function createBaseFrontmatterSchema(noteTypeSchema: z.ZodType<string>): z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
+    status: z.ZodDefault<z.ZodEnum<{
+        draft: "draft";
+        pending: "pending";
+        canon: "canon";
+        "non-canon": "non-canon";
+        archived: "archived";
+    }>>;
+    title: z.ZodOptional<z.ZodString>;
+    world: z.ZodOptional<z.ZodString>;
+    importance: z.ZodOptional<z.ZodEnum<{
+        major: "major";
+        minor: "minor";
+        background: "background";
+    }>>;
+    tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    aliases: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    created: z.ZodOptional<z.ZodString>;
+    updated: z.ZodOptional<z.ZodString>;
+    canon_authority: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>>;
+}, z.core.$strip>;
 export declare const BaseFrontmatterSchema: z.ZodObject<{
     id: z.ZodString;
-    type: z.ZodEnum<{
-        character: "character";
-        location: "location";
-        event: "event";
-        faction: "faction";
-        system: "system";
-        asset: "asset";
-        lore: "lore";
-    }>;
+    type: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
     status: z.ZodDefault<z.ZodEnum<{
         draft: "draft";
         pending: "pending";
@@ -210,12 +246,12 @@ export declare const FactionFrontmatterSchema: z.ZodObject<{
     type: z.ZodLiteral<"faction">;
     name: z.ZodString;
     faction_type: z.ZodOptional<z.ZodEnum<{
+        religion: "religion";
         house: "house";
         guild: "guild";
         organization: "organization";
         government: "government";
         military: "military";
-        religion: "religion";
         other: "other";
     }>>;
     leader: z.ZodOptional<z.ZodString>;
@@ -256,18 +292,18 @@ export declare const LoreFrontmatterSchema: z.ZodObject<{
     type: z.ZodLiteral<"lore">;
     name: z.ZodString;
     category: z.ZodOptional<z.ZodEnum<{
-        religion: "religion";
-        other: "other";
-        mythology: "mythology";
         history: "history";
+        mythology: "mythology";
         magic: "magic";
-        technology: "technology";
         culture: "culture";
+        religion: "religion";
+        other: "other";
+        technology: "technology";
     }>>;
     related_entities: z.ZodOptional<z.ZodArray<z.ZodString>>;
     source: z.ZodOptional<z.ZodEnum<{
-        "in-world": "in-world";
         meta: "meta";
+        "in-world": "in-world";
         "player-knowledge": "player-knowledge";
     }>>;
 }, z.core.$strip>;
@@ -416,9 +452,9 @@ export declare const SearchVaultArgsSchema: z.ZodObject<{
             location: "location";
             event: "event";
             faction: "faction";
-            system: "system";
-            asset: "asset";
             lore: "lore";
+            asset: "asset";
+            system: "system";
         }>>>;
         status: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             draft: "draft";
@@ -557,8 +593,8 @@ export declare const GetCanonStatusArgsSchema: z.ZodObject<{
         location: "location";
         event: "event";
         faction: "faction";
-        asset: "asset";
         lore: "lore";
+        asset: "asset";
     }>>;
 }, z.core.$strip>;
 export type GetCanonStatusArgs = z.infer<typeof GetCanonStatusArgsSchema>;
@@ -574,8 +610,8 @@ export declare const ValidateConsistencyArgsSchema: z.ZodObject<{
         location: "location";
         event: "event";
         faction: "faction";
-        asset: "asset";
         lore: "lore";
+        asset: "asset";
     }>>;
 }, z.core.$strip>;
 export type ValidateConsistencyArgs = z.infer<typeof ValidateConsistencyArgsSchema>;