@principled/cairn 1.0.0-beta

package/dist/parsers/yaml-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/yaml-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;GAEG;AACH,qBAAa,aAAc,SAAQ,SAAS;IAC1C,QAAQ,CAAC,UAAU,WAAqB;IAExC,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAyBrG"}

package/dist/parsers/yaml-parser.js

@@ -0,0 +1,30 @@
+import { RefParser } from './base.js';
+/**
+ * Parser for YAML files. Identifier = top-level key.
+ */
+export class YamlRefParser extends RefParser {
+    extensions = ['.yaml', '.yml'];
+    extractIdentifiers(content, matching) {
+        const results = [];
+        const lines = content.split('\n');
+        // Find all top-level keys (no indentation)
+        const topKeys = [];
+        for (let i = 0; i < lines.length; i++) {
+            const m = lines[i].match(/^(\w[\w-]*)\s*:/);
+            if (m) {
+                topKeys.push({ name: m[1], lineIndex: i });
+            }
+        }
+        for (let k = 0; k < topKeys.length; k++) {
+            const key = topKeys[k];
+            if (matching && key.name !== matching)
+                continue;
+            // Block extends to next top-level key or end of file
+            const endLine = k + 1 < topKeys.length ? topKeys[k + 1].lineIndex : lines.length;
+            const block = lines.slice(key.lineIndex, endLine).join('\n');
+            results.push({ identifier: key.name, block });
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=yaml-parser.js.map

package/dist/parsers/yaml-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-parser.js","sourceRoot":"","sources":["../../src/parsers/yaml-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,SAAS;IACjC,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAExC,kBAAkB,CAAC,OAAe,EAAE,QAAiB;QACnD,MAAM,OAAO,GAAiD,EAAE,CAAC;QACjE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,2CAA2C;QAC3C,MAAM,OAAO,GAA+C,EAAE,CAAC;QAC/D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YAC7C,IAAI,CAAC,EAAE,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;YACxB,IAAI,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAAE,SAAS;YAEhD,qDAAqD;YACrD,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;YAClF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/provenance/index.d.ts

@@ -0,0 +1,5 @@
+export { originEntrySchema, updateEntrySchema, reviewEntrySchema } from './schemas.js';
+export type { OriginEntry, UpdateEntry, ReviewEntry } from './schemas.js';
+export { isStale, getUnreviewedUpdates } from './staleness.js';
+export { computeReviewHash, validateReviewHash } from './review-hash.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provenance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACvF,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/provenance/index.js

@@ -0,0 +1,4 @@
+export { originEntrySchema, updateEntrySchema, reviewEntrySchema } from './schemas.js';
+export { isStale, getUnreviewedUpdates } from './staleness.js';
+export { computeReviewHash, validateReviewHash } from './review-hash.js';
+//# sourceMappingURL=index.js.map

package/dist/provenance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/provenance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEvF,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/provenance/review-hash.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Compute a review hash from pending update IDs (DEC-4.5).
+ * The hash encodes which updates were shown during review.
+ * Used for --approve token validation.
+ */
+export declare function computeReviewHash(updateIds: string[]): string;
+/**
+ * Validate a review hash against pending update IDs.
+ */
+export declare function validateReviewHash(hash: string, updateIds: string[]): boolean;
+//# sourceMappingURL=review-hash.d.ts.map

package/dist/provenance/review-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-hash.d.ts","sourceRoot":"","sources":["../../src/provenance/review-hash.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAI7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAE7E"}

package/dist/provenance/review-hash.js

@@ -0,0 +1,18 @@
+import { createHash } from 'crypto';
+/**
+ * Compute a review hash from pending update IDs (DEC-4.5).
+ * The hash encodes which updates were shown during review.
+ * Used for --approve token validation.
+ */
+export function computeReviewHash(updateIds) {
+    const sorted = [...updateIds].sort();
+    const data = sorted.join(':');
+    return createHash('sha256').update(data).digest('hex').substring(0, 16);
+}
+/**
+ * Validate a review hash against pending update IDs.
+ */
+export function validateReviewHash(hash, updateIds) {
+    return computeReviewHash(updateIds) === hash;
+}
+//# sourceMappingURL=review-hash.js.map

package/dist/provenance/review-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-hash.js","sourceRoot":"","sources":["../../src/provenance/review-hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAmB;IACnD,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,SAAmB;IAClE,OAAO,iBAAiB,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;AAC/C,CAAC"}

package/dist/provenance/schemas.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+/** Origin entry schema (DEC-4.7: creation record) */
+export declare const originEntrySchema: z.ZodObject<{
+    id: z.ZodDefault<z.ZodString>;
+    date: z.ZodString;
+    by: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Update entry schema (DEC-4.7: change record) */
+export declare const updateEntrySchema: z.ZodObject<{
+    id: z.ZodDefault<z.ZodString>;
+    date: z.ZodString;
+    by: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodString;
+    }, z.core.$strip>>;
+    rationale: z.ZodString;
+    skip_review: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+/** Review entry schema (DEC-4.7: review record) */
+export declare const reviewEntrySchema: z.ZodObject<{
+    id: z.ZodDefault<z.ZodString>;
+    date: z.ZodString;
+    by: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodString;
+    }, z.core.$strip>>;
+    updates_reviewed: z.ZodArray<z.ZodString>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type OriginEntry = z.infer<typeof originEntrySchema>;
+export type UpdateEntry = z.infer<typeof updateEntrySchema>;
+export type ReviewEntry = z.infer<typeof reviewEntrySchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/provenance/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/provenance/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,qDAAqD;AACrD,eAAO,MAAM,iBAAiB;;;;;;;iBAI5B,CAAC;AAEH,mDAAmD;AACnD,eAAO,MAAM,iBAAiB;;;;;;;;;iBAM5B,CAAC;AAEH,mDAAmD;AACnD,eAAO,MAAM,iBAAiB;;;;;;;;;iBAM5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/provenance/schemas.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { randomUUID } from 'crypto';
+import { userIdentitySchema } from '../config/schema.js';
+/** Origin entry schema (DEC-4.7: creation record) */
+export const originEntrySchema = z.object({
+    id: z.string().default(() => randomUUID()),
+    date: z.string(), // ISO 8601 datetime
+    by: userIdentitySchema.optional(),
+});
+/** Update entry schema (DEC-4.7: change record) */
+export const updateEntrySchema = z.object({
+    id: z.string().default(() => randomUUID()),
+    date: z.string(),
+    by: userIdentitySchema.optional(),
+    rationale: z.string(),
+    skip_review: z.boolean().optional().default(false),
+});
+/** Review entry schema (DEC-4.7: review record) */
+export const reviewEntrySchema = z.object({
+    id: z.string().default(() => randomUUID()),
+    date: z.string(),
+    by: userIdentitySchema.optional(),
+    updates_reviewed: z.array(z.string()), // UUIDs of update entries
+    note: z.string().optional(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/provenance/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/provenance/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,qDAAqD;AACrD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,oBAAoB;IACtC,EAAE,EAAE,kBAAkB,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH,mDAAmD;AACnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,EAAE,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACnD,CAAC,CAAC;AAEH,mDAAmD;AACnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,EAAE,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IACjC,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,0BAA0B;IACjE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC"}

package/dist/provenance/staleness.d.ts

@@ -0,0 +1,12 @@
+import type { Element } from '../model/element.js';
+/**
+ * Check if an element is stale (DEC-4.7).
+ * An element is stale if it has any non-skip-review update whose ID
+ * does not appear in any review's updates_reviewed list.
+ */
+export declare function isStale(element: Element): boolean;
+/**
+ * Get the list of unreviewed update IDs for an element.
+ */
+export declare function getUnreviewedUpdates(element: Element): string[];
+//# sourceMappingURL=staleness.d.ts.map

package/dist/provenance/staleness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staleness.d.ts","sourceRoot":"","sources":["../../src/provenance/staleness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAuBjD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAgB/D"}

package/dist/provenance/staleness.js

@@ -0,0 +1,46 @@
+/**
+ * Check if an element is stale (DEC-4.7).
+ * An element is stale if it has any non-skip-review update whose ID
+ * does not appear in any review's updates_reviewed list.
+ */
+export function isStale(element) {
+    const updatedBy = (element.get('updated_by') ?? []);
+    const reviewedBy = (element.get('reviewed_by') ?? []);
+    // Get all reviewed update IDs across all reviews
+    const reviewedUpdateIds = new Set();
+    for (const review of reviewedBy) {
+        if (review.updates_reviewed) {
+            for (const id of review.updates_reviewed) {
+                reviewedUpdateIds.add(id);
+            }
+        }
+    }
+    // Check if any non-skip-review update is unreviewed
+    for (const update of updatedBy) {
+        if (update.skip_review)
+            continue;
+        if (!reviewedUpdateIds.has(update.id)) {
+            return true; // This update hasn't been reviewed
+        }
+    }
+    return false;
+}
+/**
+ * Get the list of unreviewed update IDs for an element.
+ */
+export function getUnreviewedUpdates(element) {
+    const updatedBy = (element.get('updated_by') ?? []);
+    const reviewedBy = (element.get('reviewed_by') ?? []);
+    const reviewedUpdateIds = new Set();
+    for (const review of reviewedBy) {
+        if (review.updates_reviewed) {
+            for (const id of review.updates_reviewed) {
+                reviewedUpdateIds.add(id);
+            }
+        }
+    }
+    return updatedBy
+        .filter(u => !u.skip_review && !reviewedUpdateIds.has(u.id))
+        .map(u => u.id);
+}
+//# sourceMappingURL=staleness.js.map

package/dist/provenance/staleness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staleness.js","sourceRoot":"","sources":["../../src/provenance/staleness.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,OAAgB;IACtC,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAkB,CAAC;IACrE,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAkB,CAAC;IAEvE,iDAAiD;IACjD,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5C,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC5B,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBACzC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,KAAK,MAAM,MAAM,IAAI,SAAS,EAAE,CAAC;QAC/B,IAAI,MAAM,CAAC,WAAW;YAAE,SAAS;QACjC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,CAAC,mCAAmC;QAClD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAkB,CAAC;IACrE,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAkB,CAAC;IAEvE,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5C,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC5B,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBACzC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS;SACb,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC3D,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACpB,CAAC"}

package/dist/refs/git-diff-tracer.d.ts

@@ -0,0 +1,35 @@
+import type { Element } from '../model/element.js';
+import type { Catalog } from '../catalog/catalog.js';
+export interface RefChange {
+    element: Element;
+    ref: {
+        file: string;
+        identifier: string;
+        role: string;
+    };
+    changeType: 'modified' | 'removed' | 'added';
+    /** Lines of the identifier block at commit A (null if added) */
+    blockBefore: string | null;
+    /** Lines of the identifier block at commit B (null if removed) */
+    blockAfter: string | null;
+}
+export interface DiffTraceResult {
+    commitA: string;
+    commitB: string;
+    changedFiles: string[];
+    refChanges: RefChange[];
+}
+/**
+ * Trace changes between two commits back to GVP decisions via refs.
+ *
+ * 1. Get changed files between commitA and commitB
+ * 2. Find all elements with refs pointing to changed files
+ * 3. For each matching ref, extract the identifier block at both commits
+ * 4. Compare — report if the identifier changed, was added, or was removed
+ */
+export declare function traceGitDiff(catalog: Catalog, commitA: string, commitB: string, cwd: string): DiffTraceResult;
+/**
+ * Format a DiffTraceResult for display.
+ */
+export declare function formatDiffTrace(result: DiffTraceResult, catalog: Catalog): string;
+//# sourceMappingURL=git-diff-tracer.d.ts.map

package/dist/refs/git-diff-tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-diff-tracer.d.ts","sourceRoot":"","sources":["../../src/refs/git-diff-tracer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAIrD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,UAAU,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;IAC7C,gEAAgE;IAChE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kEAAkE;IAClE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AA+BD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,eAAe,CA0DjB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAmCjF"}

package/dist/refs/git-diff-tracer.js

@@ -0,0 +1,143 @@
+import { execSync } from 'child_process';
+import * as path from 'path';
+import { createRefParserRegistry, findParser } from '../parsers/registry.js';
+/**
+ * Get the list of files changed between two commits.
+ */
+function getChangedFiles(commitA, commitB, cwd) {
+    try {
+        const output = execSync(`git diff --name-only ${commitA} ${commitB}`, { cwd, encoding: 'utf-8' });
+        return output.trim().split('\n').filter(f => f.length > 0);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get file content at a specific commit.
+ */
+function getFileAtCommit(filePath, commit, cwd) {
+    try {
+        return execSync(`git show ${commit}:${filePath}`, { cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+    }
+    catch {
+        return null; // File doesn't exist at this commit
+    }
+}
+/**
+ * Trace changes between two commits back to GVP decisions via refs.
+ *
+ * 1. Get changed files between commitA and commitB
+ * 2. Find all elements with refs pointing to changed files
+ * 3. For each matching ref, extract the identifier block at both commits
+ * 4. Compare — report if the identifier changed, was added, or was removed
+ */
+export function traceGitDiff(catalog, commitA, commitB, cwd) {
+    const parsers = createRefParserRegistry();
+    const changedFiles = getChangedFiles(commitA, commitB, cwd);
+    // Build a set of changed file paths for quick lookup
+    const changedSet = new Set(changedFiles);
+    // Find all elements with refs pointing to changed files
+    const refChanges = [];
+    for (const element of catalog.getAllElements()) {
+        const refs = element.get('refs');
+        if (!refs || !Array.isArray(refs))
+            continue;
+        for (const ref of refs) {
+            if (!changedSet.has(ref.file))
+                continue;
+            // This ref points to a changed file — check the identifier
+            const ext = path.extname(ref.file);
+            const parser = findParser(ext, parsers);
+            const contentBefore = getFileAtCommit(ref.file, commitA, cwd);
+            const contentAfter = getFileAtCommit(ref.file, commitB, cwd);
+            let blockBefore = null;
+            let blockAfter = null;
+            if (parser) {
+                if (contentBefore)
+                    blockBefore = parser.extractBlock(contentBefore, ref.identifier);
+                if (contentAfter)
+                    blockAfter = parser.extractBlock(contentAfter, ref.identifier);
+            }
+            else {
+                // No parser — use file-level comparison (DEC-10.15)
+                blockBefore = contentBefore;
+                blockAfter = contentAfter;
+            }
+            let changeType;
+            if (!blockBefore && blockAfter) {
+                changeType = 'added';
+            }
+            else if (blockBefore && !blockAfter) {
+                changeType = 'removed';
+            }
+            else if (blockBefore !== blockAfter) {
+                changeType = 'modified';
+            }
+            else {
+                continue; // No change to this identifier
+            }
+            refChanges.push({
+                element,
+                ref,
+                changeType,
+                blockBefore,
+                blockAfter,
+            });
+        }
+    }
+    return { commitA, commitB, changedFiles, refChanges };
+}
+/**
+ * Format a DiffTraceResult for display.
+ */
+export function formatDiffTrace(result, catalog) {
+    const lines = [];
+    lines.push(`Git diff: ${result.commitA.substring(0, 7)}..${result.commitB.substring(0, 7)}`);
+    lines.push(`Changed files: ${result.changedFiles.length}`);
+    lines.push('');
+    if (result.refChanges.length === 0) {
+        lines.push('No GVP-traced changes detected.');
+        return lines.join('\n');
+    }
+    lines.push(`Traced changes: ${result.refChanges.length}`);
+    lines.push('');
+    for (const change of result.refChanges) {
+        const icon = change.changeType === 'modified' ? '~' :
+            change.changeType === 'added' ? '+' :
+                '-';
+        lines.push(`[${icon}] ${change.ref.file}::${change.ref.identifier}`);
+        lines.push(`    Role: ${change.ref.role}`);
+        lines.push(`    Element: ${change.element.toString()} (${change.element.categoryName})`);
+        // Trace the element upward through maps_to
+        const ancestors = traceAncestors(change.element, catalog);
+        if (ancestors.length > 0) {
+            lines.push(`    Traces to:`);
+            for (const ancestor of ancestors) {
+                lines.push(`      → ${ancestor.toString()} (${ancestor.categoryName})`);
+            }
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Simple ancestor tracing — follow maps_to to find goals/values.
+ */
+function traceAncestors(element, catalog) {
+    const visited = new Set();
+    const ancestors = [];
+    function walk(el) {
+        for (const ref of el.maps_to) {
+            const target = catalog.getAllElements().find(e => e.toLibraryId() === ref || e.hashKey() === ref);
+            if (target && !visited.has(target.hashKey())) {
+                visited.add(target.hashKey());
+                ancestors.push(target);
+                walk(target);
+            }
+        }
+    }
+    walk(element);
+    return ancestors;
+}
+//# sourceMappingURL=git-diff-tracer.js.map

package/dist/refs/git-diff-tracer.js.map

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

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

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { FieldSchemaEntry } from './field-schema.js';
+interface BuildOptions {
+    defaultTimezone?: string;
+}
+/**
+ * Build a Zod object schema from a field_schemas definition (DEC-3.1).
+ * This is the TypeScript equivalent of Pydantic's create_model().
+ *
+ * Each field in fieldSchemas becomes a property on the resulting Zod object schema.
+ * Fields are optional unless `required: true`.
+ */
+export declare function buildZodSchema(fieldSchemas: Record<string, FieldSchemaEntry>, options?: BuildOptions): z.ZodObject<Record<string, z.ZodType>>;
+export {};
+//# sourceMappingURL=build-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-schema.d.ts","sourceRoot":"","sources":["../../src/schema/build-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;AA8ED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,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,CAYxC"}

package/dist/schema/build-schema.js

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+import { createDatetimeSchema } from './datetime.js';
+import { SchemaError } from '../errors.js';
+/**
+ * Convert a single FieldSchemaEntry into a Zod schema.
+ * Handles all 8 types recursively (DEC-3.1, DEC-3.4, DEC-3.10, DEC-3.12, DEC-10.11).
+ */
+function fieldEntryToZod(entry, options) {
+    let schema;
+    switch (entry.type) {
+        case 'string':
+            schema = z.string();
+            break;
+        case 'number':
+            schema = z.number();
+            break;
+        case 'boolean':
+            schema = z.boolean();
+            break;
+        case 'datetime':
+            schema = createDatetimeSchema(options.defaultTimezone);
+            break;
+        case 'enum': {
+            const values = entry.values;
+            if (!Array.isArray(values) || values.length === 0) {
+                throw new SchemaError(`Enum field requires a non-empty 'values' array of strings`);
+            }
+            schema = z.enum(values);
+            break;
+        }
+        case 'list': {
+            const itemSchema = entry.items
+                ? fieldEntryToZod(entry.items, options)
+                : z.unknown();
+            schema = z.array(itemSchema);
+            break;
+        }
+        case 'dict': {
+            const valueSchema = entry.values && !Array.isArray(entry.values)
+                ? fieldEntryToZod(entry.values, options)
+                : z.unknown();
+            schema = z.record(z.string(), valueSchema);
+            break;
+        }
+        case 'model': {
+            if (!entry.fields) {
+                throw new SchemaError(`Model field requires a 'fields' definition`);
+            }
+            const shape = {};
+            for (const [key, fieldEntry] of Object.entries(entry.fields)) {
+                let fieldSchema = fieldEntryToZod(fieldEntry, options);
+                if (!fieldEntry.required) {
+                    fieldSchema = fieldSchema.optional();
+                }
+                shape[key] = fieldSchema;
+            }
+            schema = z.object(shape);
+            break;
+        }
+        default:
+            throw new SchemaError(`Unknown field type: '${entry.type}'`);
+    }
+    return schema;
+}
+/**
+ * Build a Zod object schema from a field_schemas definition (DEC-3.1).
+ * This is the TypeScript equivalent of Pydantic's create_model().
+ *
+ * Each field in fieldSchemas becomes a property on the resulting Zod object schema.
+ * Fields are optional unless `required: true`.
+ */
+export function buildZodSchema(fieldSchemas, options = {}) {
+    const shape = {};
+    for (const [key, entry] of Object.entries(fieldSchemas)) {
+        let fieldSchema = fieldEntryToZod(entry, options);
+        if (!entry.required) {
+            fieldSchema = fieldSchema.optional();
+        }
+        shape[key] = fieldSchema;
+    }
+    return z.object(shape);
+}
+//# sourceMappingURL=build-schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-schema.js","sourceRoot":"","sources":["../../src/schema/build-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAM3C;;;GAGG;AACH,SAAS,eAAe,CAAC,KAAuB,EAAE,OAAqB;IACrE,IAAI,MAAiB,CAAC;IAEtB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,QAAQ;YACX,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM;QAER,KAAK,QAAQ;YACX,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM;QAER,KAAK,SAAS;YACZ,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM;QAER,KAAK,UAAU;YACb,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YACvD,MAAM;QAER,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClD,MAAM,IAAI,WAAW,CACnB,2DAA2D,CAC5D,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,MAA+B,CAAC,CAAC;YACjD,MAAM;QACR,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK;gBAC5B,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC;gBACvC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAChB,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC7B,MAAM;QACR,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;gBAC9D,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC;gBACxC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAChB,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC;YAC3C,MAAM;QACR,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBAClB,MAAM,IAAI,WAAW,CACnB,4CAA4C,CAC7C,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,GAA8B,EAAE,CAAC;YAC5C,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC7D,IAAI,WAAW,GAAG,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBACvD,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;oBACzB,WAAW,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC;gBACvC,CAAC;gBACD,KAAK,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;YAC3B,CAAC;YACD,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzB,MAAM;QACR,CAAC;QAED;YACE,MAAM,IAAI,WAAW,CAAC,wBAAwB,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,YAA8C,EAC9C,UAAwB,EAAE;IAE1B,MAAM,KAAK,GAA8B,EAAE,CAAC;IAE5C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACxD,IAAI,WAAW,GAAG,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,WAAW,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC;QACvC,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;IAC3B,CAAC;IAED,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC"}

package/dist/schema/category-definition.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import type { FieldSchemaEntry } from './field-schema.js';
+/**
+ * Category definition from defaults.yaml or user library (DOM-5).
+ */
+export interface CategoryDefinition {
+    yaml_key: string;
+    id_prefix: string;
+    primary_field?: string;
+    display_label?: string;
+    color?: string;
+    is_root?: boolean;
+    mapping_rules?: string[][];
+    field_schemas?: Record<string, FieldSchemaEntry>;
+    export_options?: Record<string, unknown>;
+}
+/** Zod schema for category definitions */
+export declare const categoryDefinitionSchema: z.ZodType<CategoryDefinition>;
+/**
+ * The _all block that applies field_schemas to all categories.
+ */
+export interface AllFieldSchemas {
+    field_schemas?: Record<string, FieldSchemaEntry>;
+}
+export declare const allFieldSchemasSchema: z.ZodObject<{
+    field_schemas: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<FieldSchemaEntry, unknown, z.core.$ZodTypeInternals<FieldSchemaEntry, unknown>>>>;
+}, z.core.$strip>;
+/**
+ * The full defaults.yaml file structure.
+ */
+export interface DefaultsFile {
+    _all?: AllFieldSchemas;
+    categories: Record<string, CategoryDefinition>;
+}
+export declare const defaultsFileSchema: z.ZodObject<{
+    _all: z.ZodOptional<z.ZodObject<{
+        field_schemas: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<FieldSchemaEntry, unknown, z.core.$ZodTypeInternals<FieldSchemaEntry, unknown>>>>;
+    }, z.core.$strip>>;
+    categories: z.ZodRecord<z.ZodString, z.ZodType<CategoryDefinition, unknown, z.core.$ZodTypeInternals<CategoryDefinition, unknown>>>;
+}, z.core.$strip>;
+//# sourceMappingURL=category-definition.d.ts.map

package/dist/schema/category-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-definition.d.ts","sourceRoot":"","sources":["../../src/schema/category-definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,0CAA0C;AAC1C,eAAO,MAAM,wBAAwB,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAUjE,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAClD;AAED,eAAO,MAAM,qBAAqB;;iBAEhC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAChD;AAED,eAAO,MAAM,kBAAkB;;;;;iBAG7B,CAAC"}

package/dist/schema/category-definition.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { fieldSchemaEntrySchema } from './field-schema.js';
+/** Zod schema for category definitions */
+export const categoryDefinitionSchema = z.object({
+    yaml_key: z.string(),
+    id_prefix: z.string(),
+    primary_field: z.string().optional(),
+    display_label: z.string().optional(),
+    color: z.string().optional(),
+    is_root: z.boolean().optional(),
+    mapping_rules: z.array(z.array(z.string())).optional(),
+    field_schemas: z.record(z.string(), fieldSchemaEntrySchema).optional(),
+    export_options: z.record(z.string(), z.unknown()).optional(),
+});
+export const allFieldSchemasSchema = z.object({
+    field_schemas: z.record(z.string(), fieldSchemaEntrySchema).optional(),
+});
+export const defaultsFileSchema = z.object({
+    _all: allFieldSchemasSchema.optional(),
+    categories: z.record(z.string(), categoryDefinitionSchema),
+});
+//# sourceMappingURL=category-definition.js.map

package/dist/schema/category-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-definition.js","sourceRoot":"","sources":["../../src/schema/category-definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAiB3D,0CAA0C;AAC1C,MAAM,CAAC,MAAM,wBAAwB,GAAkC,CAAC,CAAC,MAAM,CAAC;IAC9E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtD,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,sBAAsB,CAAC,CAAC,QAAQ,EAAE;IACtE,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC7D,CAAC,CAAC;AASH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,sBAAsB,CAAC,CAAC,QAAQ,EAAE;CACvE,CAAC,CAAC;AAUH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,qBAAqB,CAAC,QAAQ,EAAE;IACtC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC;CAC3D,CAAC,CAAC"}

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

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import type { FieldSchemaEntry } from './field-schema.js';
+interface BuildOptions {
+    defaultTimezone?: string;
+}
+/**
+ * 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 declare function buildElementSchema(fieldSchemas: Record<string, FieldSchemaEntry>, options?: BuildOptions): z.ZodObject<Record<string, z.ZodType>>;
+export {};
+//# sourceMappingURL=combined-schema.d.ts.map