@principled/cairn 1.0.0-beta

package/dist/schema/combined-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combined-schema.d.ts","sourceRoot":"","sources":["../../src/schema/combined-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI1D,UAAU,YAAY;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAC9C,OAAO,GAAE,YAAiB,GACzB,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAaxC"}

package/dist/schema/combined-schema.js

@@ -0,0 +1,23 @@
+import { checkReservedFieldCollision, reservedFieldsSchema } from './reserved-fields.js';
+import { buildZodSchema } from './build-schema.js';
+/**
+ * Build a complete element Zod schema: reserved fields + dynamic fields (DEC-3.7).
+ *
+ * 1. Checks for reserved field collisions (DEC-3.2) — throws SchemaError
+ * 2. Builds dynamic schema from field_schemas
+ * 3. Merges reserved + dynamic into one flat Zod object schema
+ *
+ * The resulting schema validates a complete element in one pass.
+ */
+export function buildElementSchema(fieldSchemas, options = {}) {
+    // Step 1: Check for collisions
+    checkReservedFieldCollision(fieldSchemas);
+    // Step 2: Build dynamic schema
+    const dynamicSchema = buildZodSchema(fieldSchemas, options);
+    // Step 3: Merge reserved + dynamic (flat namespace)
+    // Use .extend() to add dynamic fields onto the reserved schema
+    const combined = reservedFieldsSchema.extend(dynamicSchema.shape);
+    // Allow extra fields (passthrough) so unknown fields don't cause errors
+    return combined.passthrough();
+}
+//# sourceMappingURL=combined-schema.js.map

package/dist/schema/combined-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"combined-schema.js","sourceRoot":"","sources":["../../src/schema/combined-schema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMnD;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,YAA8C,EAC9C,UAAwB,EAAE;IAE1B,+BAA+B;IAC/B,2BAA2B,CAAC,YAAY,CAAC,CAAC;IAE1C,+BAA+B;IAC/B,MAAM,aAAa,GAAG,cAAc,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAE5D,oDAAoD;IACpD,+DAA+D;IAC/D,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAElE,wEAAwE;IACxE,OAAO,QAAQ,CAAC,WAAW,EAA4C,CAAC;AAC1E,CAAC"}

package/dist/schema/datetime.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+/**
+ * Resolve timezone using fallback chain: config → system → UTC (DEC-3.4)
+ */
+export declare function resolveTimezone(configTimezone?: string): string;
+/**
+ * Create a Zod schema for datetime fields (DEC-3.4).
+ * Validates ISO 8601 strings and appends timezone if missing.
+ */
+export declare function createDatetimeSchema(defaultTimezone?: string): z.ZodType<string>;
+//# sourceMappingURL=datetime.d.ts.map

package/dist/schema/datetime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../../src/schema/datetime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,wBAAgB,eAAe,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAW/D;AA6CD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAqBhF"}

package/dist/schema/datetime.js

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+/**
+ * Resolve timezone using fallback chain: config → system → UTC (DEC-3.4)
+ */
+export function resolveTimezone(configTimezone) {
+    if (configTimezone)
+        return configTimezone;
+    try {
+        const systemTz = Intl.DateTimeFormat().resolvedOptions().timeZone;
+        if (systemTz)
+            return systemTz;
+    }
+    catch {
+        // Intl not available
+    }
+    return 'UTC';
+}
+/**
+ * Check if an ISO 8601 string includes timezone information.
+ */
+function hasTimezone(isoString) {
+    // Check for Z, +HH:MM, -HH:MM at the end
+    return /(?:Z|[+-]\d{2}:\d{2})\s*$/.test(isoString);
+}
+/**
+ * Append a timezone offset to an ISO 8601 string that lacks one.
+ * Uses the IANA timezone name to compute the offset for the given datetime.
+ */
+function appendTimezone(isoString, timezone) {
+    if (timezone === 'UTC') {
+        return isoString + 'Z';
+    }
+    try {
+        // Parse the date and format with the target timezone to get the offset
+        const date = new Date(isoString + 'Z'); // Parse as UTC first
+        const formatter = new Intl.DateTimeFormat('en-US', {
+            timeZone: timezone,
+            timeZoneName: 'shortOffset',
+        });
+        const parts = formatter.formatToParts(date);
+        const tzPart = parts.find(p => p.type === 'timeZoneName');
+        if (tzPart) {
+            // Convert "GMT-4" or "GMT+5:30" to "-04:00" or "+05:30"
+            const match = tzPart.value.match(/GMT([+-]?)(\d+)(?::(\d+))?/);
+            if (match) {
+                const sign = match[1] || '+';
+                const hours = match[2].padStart(2, '0');
+                const minutes = (match[3] || '0').padStart(2, '0');
+                return isoString + sign + hours + ':' + minutes;
+            }
+        }
+    }
+    catch {
+        // Fallback: just append Z
+    }
+    return isoString + 'Z';
+}
+/**
+ * Create a Zod schema for datetime fields (DEC-3.4).
+ * Validates ISO 8601 strings and appends timezone if missing.
+ */
+export function createDatetimeSchema(defaultTimezone) {
+    const timezone = resolveTimezone(defaultTimezone);
+    return z.string().transform((val, ctx) => {
+        // Validate it's a parseable date
+        const date = new Date(val.includes('T') ? val : val + 'T00:00:00');
+        if (isNaN(date.getTime())) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `Invalid datetime: "${val}" is not a valid ISO 8601 datetime`,
+            });
+            return val;
+        }
+        // Append timezone if missing
+        if (!hasTimezone(val)) {
+            return appendTimezone(val, timezone);
+        }
+        return val;
+    });
+}
+//# sourceMappingURL=datetime.js.map

package/dist/schema/datetime.js.map

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

package/dist/schema/defaults-loader.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import type { FieldSchemaEntry } from './field-schema.js';
+import type { CategoryDefinition, DefaultsFile } from './category-definition.js';
+/**
+ * Load and validate the built-in defaults.yaml (DEC-9.4).
+ * Uses the same YAML -> Zod pipeline as user files.
+ */
+export declare function loadDefaults(): DefaultsFile;
+/**
+ * Merge _all field_schemas with per-category field_schemas (DEC-2.8).
+ * Per-category fields win on collision.
+ */
+export declare function mergeAllFieldSchemas(allSchemas: Record<string, FieldSchemaEntry>, categorySchemas: Record<string, FieldSchemaEntry> | undefined): Record<string, FieldSchemaEntry>;
+/**
+ * Build a complete element Zod schema for a category (convenience function).
+ * Merges _all + per-category field_schemas, then builds the element schema.
+ */
+export declare function buildCategoryElementSchema(categoryDef: CategoryDefinition, allFieldSchemas: Record<string, FieldSchemaEntry>, options?: {
+    defaultTimezone?: string;
+}): z.ZodObject<Record<string, z.ZodType>>;
+//# sourceMappingURL=defaults-loader.d.ts.map

package/dist/schema/defaults-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults-loader.d.ts","sourceRoot":"","sources":["../../src/schema/defaults-loader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAKjF;;;GAGG;AACH,wBAAgB,YAAY,IAAI,YAAY,CAc3C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAC5C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,SAAS,GAC5D,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAMlC;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,kBAAkB,EAC/B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACjD,OAAO,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACrC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAYxC"}

package/dist/schema/defaults-loader.js

@@ -0,0 +1,55 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import * as yaml from 'js-yaml';
+import { defaultsFileSchema } from './category-definition.js';
+import { buildElementSchema } from './combined-schema.js';
+import { RESERVED_FIELD_NAMES } from './reserved-fields.js';
+/**
+ * Load and validate the built-in defaults.yaml (DEC-9.4).
+ * Uses the same YAML -> Zod pipeline as user files.
+ */
+export function loadDefaults() {
+    // Resolve path relative to this source file
+    let resolvedPath;
+    try {
+        const thisDir = path.dirname(fileURLToPath(import.meta.url));
+        resolvedPath = path.resolve(thisDir, '../data/defaults.yaml');
+    }
+    catch {
+        // Fallback for CJS contexts where import.meta.url may not be available
+        resolvedPath = path.resolve(__dirname, '../data/defaults.yaml');
+    }
+    const content = fs.readFileSync(resolvedPath, 'utf-8');
+    const parsed = yaml.load(content);
+    return defaultsFileSchema.parse(parsed);
+}
+/**
+ * Merge _all field_schemas with per-category field_schemas (DEC-2.8).
+ * Per-category fields win on collision.
+ */
+export function mergeAllFieldSchemas(allSchemas, categorySchemas) {
+    if (!categorySchemas) {
+        return { ...allSchemas };
+    }
+    // _all provides the base; per-category overrides on collision
+    return { ...allSchemas, ...categorySchemas };
+}
+/**
+ * Build a complete element Zod schema for a category (convenience function).
+ * Merges _all + per-category field_schemas, then builds the element schema.
+ */
+export function buildCategoryElementSchema(categoryDef, allFieldSchemas, options) {
+    const merged = mergeAllFieldSchemas(allFieldSchemas, categoryDef.field_schemas);
+    // Filter out reserved fields — they are already defined by reservedFieldsSchema.
+    // The _all block may declare them for documentation/dogfooding, but buildElementSchema
+    // enforces that field_schemas cannot collide with reserved fields (DEC-3.2).
+    const filtered = {};
+    for (const [key, value] of Object.entries(merged)) {
+        if (!RESERVED_FIELD_NAMES.has(key)) {
+            filtered[key] = value;
+        }
+    }
+    return buildElementSchema(filtered, options);
+}
+//# sourceMappingURL=defaults-loader.js.map

package/dist/schema/defaults-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults-loader.js","sourceRoot":"","sources":["../../src/schema/defaults-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAIhC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,4CAA4C;IAC5C,IAAI,YAAoB,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7D,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;QACvE,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,uBAAuB,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAA4C,EAC5C,eAA6D;IAE7D,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC;IAC3B,CAAC;IACD,8DAA8D;IAC9D,OAAO,EAAE,GAAG,UAAU,EAAE,GAAG,eAAe,EAAE,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,WAA+B,EAC/B,eAAiD,EACjD,OAAsC;IAEtC,MAAM,MAAM,GAAG,oBAAoB,CAAC,eAAe,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;IAChF,iFAAiF;IACjF,uFAAuF;IACvF,6EAA6E;IAC7E,MAAM,QAAQ,GAAqC,EAAE,CAAC;IACtD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC"}

package/dist/schema/field-schema.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import type { FieldType } from './types.js';
+/**
+ * A field schema entry from field_schemas definitions.
+ * Per DEC-3.3b, DEC-3.10, DEC-3.12, DEC-10.11.
+ */
+export interface FieldSchemaEntry {
+    type: FieldType;
+    required?: boolean;
+    display_name?: string;
+    /** For 'list' type — element schema (DEC-3.10) */
+    items?: FieldSchemaEntry;
+    /** For 'dict' type — value schema (DEC-3.10). For 'enum' type — allowed values (DEC-10.11). */
+    values?: FieldSchemaEntry | string[];
+    /** For 'model' type — nested field definitions (DEC-3.12) */
+    fields?: Record<string, FieldSchemaEntry>;
+}
+/**
+ * Recursive Zod schema that validates raw YAML field_schemas entries
+ * into FieldSchemaEntry objects.
+ */
+export declare const fieldSchemaEntrySchema: z.ZodType<FieldSchemaEntry>;
+//# sourceMappingURL=field-schema.d.ts.map

package/dist/schema/field-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-schema.d.ts","sourceRoot":"","sources":["../../src/schema/field-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,+FAA+F;IAC/F,MAAM,CAAC,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAAC;IACrC,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAY9D,CAAC"}

package/dist/schema/field-schema.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import { FIELD_TYPES } from './types.js';
+/**
+ * Recursive Zod schema that validates raw YAML field_schemas entries
+ * into FieldSchemaEntry objects.
+ */
+export const fieldSchemaEntrySchema = z.lazy(() => z.object({
+    type: z.enum(FIELD_TYPES),
+    required: z.boolean().optional(),
+    display_name: z.string().optional(),
+    items: fieldSchemaEntrySchema.optional(),
+    values: z.union([
+        z.array(z.string()), // enum values
+        fieldSchemaEntrySchema, // dict value schema
+    ]).optional(),
+    fields: z.record(z.string(), fieldSchemaEntrySchema).optional(),
+}));
+//# sourceMappingURL=field-schema.js.map

package/dist/schema/field-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-schema.js","sourceRoot":"","sources":["../../src/schema/field-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAkBzC;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAgC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAC7E,CAAC,CAAC,MAAM,CAAC;IACP,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,WAA+C,CAAoC;IAChG,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,KAAK,EAAE,sBAAsB,CAAC,QAAQ,EAAE;IACxC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC;QACd,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAQ,cAAc;QACzC,sBAAsB,EAAK,oBAAoB;KAChD,CAAC,CAAC,QAAQ,EAAE;IACb,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,sBAAsB,CAAC,CAAC,QAAQ,EAAE;CAChE,CAAC,CACH,CAAC"}

package/dist/schema/index.d.ts

@@ -0,0 +1,17 @@
+export type { FieldType } from './types.js';
+export type { FieldSchemaEntry } from './field-schema.js';
+export type { CategoryDefinition, AllFieldSchemas, DefaultsFile } from './category-definition.js';
+export type { ReservedFields } from './reserved-fields.js';
+export { FIELD_TYPES } from './types.js';
+export { RESERVED_FIELD_NAMES } from './reserved-fields.js';
+export { isFieldType } from './types.js';
+export { isReservedField, checkReservedFieldCollision } from './reserved-fields.js';
+export { resolveTimezone } from './datetime.js';
+export { buildZodSchema } from './build-schema.js';
+export { buildElementSchema } from './combined-schema.js';
+export { buildCategoryElementSchema, loadDefaults, mergeAllFieldSchemas } from './defaults-loader.js';
+export { createDatetimeSchema } from './datetime.js';
+export { reservedFieldsSchema } from './reserved-fields.js';
+export { fieldSchemaEntrySchema } from './field-schema.js';
+export { categoryDefinitionSchema, allFieldSchemasSchema, defaultsFileSchema } from './category-definition.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAClG,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACtG,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/schema/index.js

@@ -0,0 +1,17 @@
+// Constants
+export { FIELD_TYPES } from './types.js';
+export { RESERVED_FIELD_NAMES } from './reserved-fields.js';
+// Type guards and helpers
+export { isFieldType } from './types.js';
+export { isReservedField, checkReservedFieldCollision } from './reserved-fields.js';
+export { resolveTimezone } from './datetime.js';
+// Schema builders
+export { buildZodSchema } from './build-schema.js';
+export { buildElementSchema } from './combined-schema.js';
+export { buildCategoryElementSchema, loadDefaults, mergeAllFieldSchemas } from './defaults-loader.js';
+export { createDatetimeSchema } from './datetime.js';
+// Zod schemas (for direct use/extension)
+export { reservedFieldsSchema } from './reserved-fields.js';
+export { fieldSchemaEntrySchema } from './field-schema.js';
+export { categoryDefinitionSchema, allFieldSchemasSchema, defaultsFileSchema } from './category-definition.js';
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAMA,YAAY;AACZ,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,0BAA0B;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACtG,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,yCAAyC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/schema/reserved-fields.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import type { FieldSchemaEntry } from './field-schema.js';
+/**
+ * Reserved field names that cannot be redefined by field_schemas (DEC-3.2).
+ * These are structural fields owned by GVP core.
+ */
+export declare const RESERVED_FIELD_NAMES: ReadonlySet<string>;
+/** Check if a field name is reserved */
+export declare function isReservedField(name: string): boolean;
+/**
+ * Throw SchemaError if any field_schemas key collides with a reserved field (DEC-3.2).
+ * Called during catalog construction.
+ */
+export declare function checkReservedFieldCollision(fieldSchemas: Record<string, FieldSchemaEntry>): void;
+/**
+ * Zod schema for reserved/structural fields on every element (DEC-3.2, DEC-3.7).
+ * Provenance fields use z.unknown() as placeholders — refined in Phase 9.
+ */
+export declare const reservedFieldsSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    status: z.ZodDefault<z.ZodString>;
+    tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    maps_to: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    origin: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodUnknown>, z.ZodUnknown]>>;
+    updated_by: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodUnknown>, z.ZodUnknown]>>;
+    reviewed_by: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodUnknown>, z.ZodUnknown]>>;
+    priority: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** Type inferred from the reserved fields schema */
+export type ReservedFields = z.infer<typeof reservedFieldsSchema>;
+//# sourceMappingURL=reserved-fields.d.ts.map

package/dist/schema/reserved-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reserved-fields.d.ts","sourceRoot":"","sources":["../../src/schema/reserved-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAGnD,CAAC;AAEH,wCAAwC;AACxC,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC7C,IAAI,CASN;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAU/B,CAAC;AAEH,oDAAoD;AACpD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/schema/reserved-fields.js

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import { SchemaError } from '../errors.js';
+/**
+ * Reserved field names that cannot be redefined by field_schemas (DEC-3.2).
+ * These are structural fields owned by GVP core.
+ */
+export const RESERVED_FIELD_NAMES = new Set([
+    'id', 'name', 'status', 'tags', 'maps_to',
+    'origin', 'updated_by', 'reviewed_by', 'priority',
+]);
+/** Check if a field name is reserved */
+export function isReservedField(name) {
+    return RESERVED_FIELD_NAMES.has(name);
+}
+/**
+ * Throw SchemaError if any field_schemas key collides with a reserved field (DEC-3.2).
+ * Called during catalog construction.
+ */
+export function checkReservedFieldCollision(fieldSchemas) {
+    for (const key of Object.keys(fieldSchemas)) {
+        if (RESERVED_FIELD_NAMES.has(key)) {
+            throw new SchemaError(`Field '${key}' is reserved and cannot be redefined in field_schemas. ` +
+                `Reserved fields: ${[...RESERVED_FIELD_NAMES].join(', ')}`);
+        }
+    }
+}
+/**
+ * Zod schema for reserved/structural fields on every element (DEC-3.2, DEC-3.7).
+ * Provenance fields use z.unknown() as placeholders — refined in Phase 9.
+ */
+export const reservedFieldsSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    status: z.string().default('active'),
+    tags: z.array(z.string()).optional().default([]),
+    maps_to: z.array(z.string()).optional().default([]),
+    origin: z.union([z.array(z.unknown()), z.unknown()]).optional(),
+    updated_by: z.union([z.array(z.unknown()), z.unknown()]).optional(),
+    reviewed_by: z.union([z.array(z.unknown()), z.unknown()]).optional(),
+    priority: z.number().optional(),
+});
+//# sourceMappingURL=reserved-fields.js.map

package/dist/schema/reserved-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reserved-fields.js","sourceRoot":"","sources":["../../src/schema/reserved-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC;IAC/D,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS;IACzC,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU;CAClD,CAAC,CAAC;AAEH,wCAAwC;AACxC,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,YAA8C;IAE9C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5C,IAAI,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,WAAW,CACnB,UAAU,GAAG,0DAA0D;gBACvE,oBAAoB,CAAC,GAAG,oBAAoB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3D,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAChD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACnD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC/D,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnE,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC"}

package/dist/schema/types.d.ts

@@ -0,0 +1,7 @@
+/** Supported field types in GVP field_schemas (DEC-3.4, DEC-10.11) */
+export type FieldType = 'string' | 'number' | 'boolean' | 'list' | 'dict' | 'model' | 'datetime' | 'enum';
+/** All supported field types as a frozen array */
+export declare const FIELD_TYPES: readonly FieldType[];
+/** Type guard for FieldType */
+export declare function isFieldType(value: string): value is FieldType;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/schema/types.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAE1G,kDAAkD;AAClD,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAEjC,CAAC;AAEZ,+BAA+B;AAC/B,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS,CAE7D"}

package/dist/schema/types.js

@@ -0,0 +1,9 @@
+/** All supported field types as a frozen array */
+export const FIELD_TYPES = Object.freeze([
+    'string', 'number', 'boolean', 'list', 'dict', 'model', 'datetime', 'enum',
+]);
+/** Type guard for FieldType */
+export function isFieldType(value) {
+    return FIELD_TYPES.includes(value);
+}
+//# sourceMappingURL=types.js.map

package/dist/schema/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/schema/types.ts"],"names":[],"mappings":"AAGA,kDAAkD;AAClD,MAAM,CAAC,MAAM,WAAW,GAAyB,MAAM,CAAC,MAAM,CAAC;IAC7D,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM;CAClE,CAAC,CAAC;AAEZ,+BAA+B;AAC/B,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAQ,WAAiC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,7 @@
+export declare function setVerbosity(level: number): void;
+export declare function getVerbosity(): number;
+export declare function log(level: number, ...args: unknown[]): void;
+export declare function logv(...args: unknown[]): void;
+export declare function logvv(...args: unknown[]): void;
+export declare function logvvv(...args: unknown[]): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAI3D;AAED,wBAAgB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAqB;AACnE,wBAAgB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAqB;AACpE,wBAAgB,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAqB"}

package/dist/utils/logger.js

@@ -0,0 +1,16 @@
+let verbosity = 0;
+export function setVerbosity(level) {
+    verbosity = level;
+}
+export function getVerbosity() {
+    return verbosity;
+}
+export function log(level, ...args) {
+    if (verbosity >= level) {
+        console.error('[cairn]', ...args);
+    }
+}
+export function logv(...args) { log(1, ...args); }
+export function logvv(...args) { log(2, ...args); }
+export function logvvv(...args) { log(3, ...args); }
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,IAAI,SAAS,GAAG,CAAC,CAAC;AAElB,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,SAAS,GAAG,KAAK,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,GAAG,IAAe;IACnD,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAG,IAAe,IAAU,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AACnE,MAAM,UAAU,KAAK,CAAC,GAAG,IAAe,IAAU,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AACpE,MAAM,UAAU,MAAM,CAAC,GAAG,IAAe,IAAU,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/dist/utils/project-root.d.ts

@@ -0,0 +1,14 @@
+import type { Catalog } from '../catalog/catalog.js';
+/**
+ * Find the project root by walking up from the catalog's first document.
+ * Project root is determined by:
+ * 1. Parent of the .gvp directory (if found)
+ * 2. Directory containing .git (fallback)
+ * 3. null if neither found
+ */
+export declare function findProjectRoot(catalog: Catalog): string | null;
+/**
+ * Find the project root from a directory path (not catalog).
+ */
+export declare function findProjectRootFromDir(startDir: string): string | null;
+//# sourceMappingURL=project-root.d.ts.map

package/dist/utils/project-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-root.d.ts","sourceRoot":"","sources":["../../src/utils/project-root.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAkB/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAatE"}

package/dist/utils/project-root.js

@@ -0,0 +1,48 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Find the project root by walking up from the catalog's first document.
+ * Project root is determined by:
+ * 1. Parent of the .gvp directory (if found)
+ * 2. Directory containing .git (fallback)
+ * 3. null if neither found
+ */
+export function findProjectRoot(catalog) {
+    const docs = catalog.documents;
+    if (docs.length === 0)
+        return null;
+    let current = path.dirname(path.resolve(docs[0].filePath));
+    while (true) {
+        // Check for .gvp directory — parent is project root
+        if (fs.existsSync(path.join(current, '.gvp'))) {
+            return current;
+        }
+        // Fallback: .git directory
+        if (fs.existsSync(path.join(current, '.git'))) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+/**
+ * Find the project root from a directory path (not catalog).
+ */
+export function findProjectRootFromDir(startDir) {
+    let current = path.resolve(startDir);
+    while (true) {
+        if (fs.existsSync(path.join(current, '.gvp'))) {
+            return current;
+        }
+        if (fs.existsSync(path.join(current, '.git'))) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+//# sourceMappingURL=project-root.js.map

package/dist/utils/project-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-root.js","sourceRoot":"","sources":["../../src/utils/project-root.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC;IAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnC,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5D,OAAO,IAAI,EAAE,CAAC;QACZ,oDAAoD;QACpD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YAC9C,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,2BAA2B;QAC3B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YAC9C,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YAC9C,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YAC9C,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/validation/diagnostic.d.ts

@@ -0,0 +1,23 @@
+export type DiagnosticSeverity = 'error' | 'warning';
+export interface DiagnosticContext {
+    elementId?: string;
+    documentPath?: string;
+    categoryName?: string;
+    fieldName?: string;
+    details?: string;
+}
+/**
+ * A validation finding (DEC-5.4).
+ * Used for both errors and warnings from validation passes.
+ */
+export interface Diagnostic {
+    code: string;
+    name: string;
+    description: string;
+    severity: DiagnosticSeverity;
+    pass: string;
+    context: DiagnosticContext;
+}
+/** Create a diagnostic */
+export declare function createDiagnostic(code: string, name: string, description: string, severity: DiagnosticSeverity, pass: string, context?: DiagnosticContext): Diagnostic;
+//# sourceMappingURL=diagnostic.d.ts.map

package/dist/validation/diagnostic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.d.ts","sourceRoot":"","sources":["../../src/validation/diagnostic.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAC;AAErD,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED,0BAA0B;AAC1B,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,kBAAkB,EAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,iBAAsB,GAC9B,UAAU,CAEZ"}

package/dist/validation/diagnostic.js

@@ -0,0 +1,5 @@
+/** Create a diagnostic */
+export function createDiagnostic(code, name, description, severity, pass, context = {}) {
+    return { code, name, description, severity, pass, context };
+}
+//# sourceMappingURL=diagnostic.js.map

package/dist/validation/diagnostic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.js","sourceRoot":"","sources":["../../src/validation/diagnostic.ts"],"names":[],"mappings":"AAuBA,0BAA0B;AAC1B,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,IAAY,EACZ,WAAmB,EACnB,QAA4B,EAC5B,IAAY,EACZ,UAA6B,EAAE;IAE/B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC9D,CAAC"}

package/dist/validation/index.d.ts

@@ -0,0 +1,6 @@
+export type { Diagnostic, DiagnosticSeverity, DiagnosticContext } from './diagnostic.js';
+export { createDiagnostic } from './diagnostic.js';
+export type { ValidationPass } from './runner.js';
+export { runValidation, hasErrors } from './runner.js';
+export { builtinPasses, optionalPasses } from './passes/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,4 @@
+export { createDiagnostic } from './diagnostic.js';
+export { runValidation, hasErrors } from './runner.js';
+export { builtinPasses, optionalPasses } from './passes/index.js';
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/validation/passes/coverage-pass.d.ts

@@ -0,0 +1,10 @@
+import type { Catalog } from '../../catalog/catalog.js';
+import type { GVPConfig } from '../../config/schema.js';
+import type { Diagnostic } from '../diagnostic.js';
+/**
+ * Coverage pass — bidirectional ref coverage check (W012, W013).
+ * This is an optional pass, not part of the 5 canonical passes.
+ * Only runs when explicitly requested.
+ */
+export declare function coveragePass(catalog: Catalog, config: GVPConfig): Diagnostic[];
+//# sourceMappingURL=coverage-pass.d.ts.map

package/dist/validation/passes/coverage-pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage-pass.d.ts","sourceRoot":"","sources":["../../../src/validation/passes/coverage-pass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAkBnD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,GAAG,UAAU,EAAE,CAqE9E"}