@open-agreements/open-agreements 0.2.0

package/dist/core/validation/license.d.ts

@@ -0,0 +1,15 @@
+export interface LicenseValidationResult {
+    templateId: string;
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Validate a template's license metadata.
+ *
+ * The allow_derivatives field means "the committed source DOCX must not be
+ * modified" when false.  It does NOT prevent the tool from rendering filled
+ * output — that decision is made by the fill command based on directory
+ * context (templates/ vs external/).
+ */
+export declare function validateLicense(templateDir: string, templateId: string): LicenseValidationResult;
+//# sourceMappingURL=license.d.ts.map

package/dist/core/validation/license.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.d.ts","sourceRoot":"","sources":["../../../src/core/validation/license.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,uBAAuB,CAyBhG"}

package/dist/core/validation/license.js

@@ -0,0 +1,30 @@
+import { loadMetadata } from '../metadata.js';
+/**
+ * Validate a template's license metadata.
+ *
+ * The allow_derivatives field means "the committed source DOCX must not be
+ * modified" when false.  It does NOT prevent the tool from rendering filled
+ * output — that decision is made by the fill command based on directory
+ * context (templates/ vs external/).
+ */
+export function validateLicense(templateDir, templateId) {
+    const errors = [];
+    let metadata;
+    try {
+        metadata = loadMetadata(templateDir);
+    }
+    catch (err) {
+        return {
+            templateId,
+            valid: false,
+            errors: [`Failed to load metadata: ${err.message}`],
+        };
+    }
+    // CC-BY-4.0 and CC-BY-ND-4.0 require attribution text
+    if ((metadata.license === 'CC-BY-4.0' || metadata.license === 'CC-BY-ND-4.0') &&
+        !metadata.attribution_text.trim()) {
+        errors.push(`${metadata.license} license requires attribution_text to be non-empty.`);
+    }
+    return { templateId, valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=license.js.map

package/dist/core/validation/license.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.js","sourceRoot":"","sources":["../../../src/core/validation/license.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAQ9C;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,UAAkB;IACrE,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,QAAQ,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,UAAU;YACV,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,CAAC,4BAA6B,GAAa,CAAC,OAAO,EAAE,CAAC;SAC/D,CAAC;IACJ,CAAC;IAED,sDAAsD;IACtD,IACE,CAAC,QAAQ,CAAC,OAAO,KAAK,WAAW,IAAI,QAAQ,CAAC,OAAO,KAAK,cAAc,CAAC;QACzE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,EAAE,EACjC,CAAC;QACD,MAAM,CAAC,IAAI,CACT,GAAG,QAAQ,CAAC,OAAO,qDAAqD,CACzE,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAC5D,CAAC"}

package/dist/core/validation/output.d.ts

@@ -0,0 +1,12 @@
+export interface OutputValidationResult {
+    valid: boolean;
+    errors: string[];
+    sourceHeadingCount: number;
+    outputHeadingCount: number;
+}
+/**
+ * Validate that a rendered DOCX preserves the heading structure of the source template.
+ * Extracts word/document.xml via AdmZip before scanning for heading styles.
+ */
+export declare function validateOutput(sourceDocxPath: string, outputDocxPath: string): OutputValidationResult;
+//# sourceMappingURL=output.d.ts.map

package/dist/core/validation/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../src/core/validation/output.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,GACrB,sBAAsB,CAiCxB"}

package/dist/core/validation/output.js

@@ -0,0 +1,47 @@
+import AdmZip from 'adm-zip';
+/**
+ * Validate that a rendered DOCX preserves the heading structure of the source template.
+ * Extracts word/document.xml via AdmZip before scanning for heading styles.
+ */
+export function validateOutput(sourceDocxPath, outputDocxPath) {
+    const errors = [];
+    let sourceXml;
+    let outputXml;
+    try {
+        sourceXml = extractDocumentXml(sourceDocxPath);
+        outputXml = extractDocumentXml(outputDocxPath);
+    }
+    catch (err) {
+        return {
+            valid: false,
+            errors: [`Failed to read files: ${err.message}`],
+            sourceHeadingCount: 0,
+            outputHeadingCount: 0,
+        };
+    }
+    const sourceHeadings = countHeadings(sourceXml);
+    const outputHeadings = countHeadings(outputXml);
+    if (sourceHeadings !== outputHeadings) {
+        errors.push(`Heading count mismatch: source has ${sourceHeadings} headings, output has ${outputHeadings}. ` +
+            'Template rendering may have dropped or duplicated content.');
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        sourceHeadingCount: sourceHeadings,
+        outputHeadingCount: outputHeadings,
+    };
+}
+function extractDocumentXml(docxPath) {
+    const zip = new AdmZip(docxPath);
+    const entry = zip.getEntry('word/document.xml');
+    if (!entry)
+        return '';
+    return entry.getData().toString('utf-8');
+}
+function countHeadings(xml) {
+    const headingPattern = /w:val="Heading\d"/g;
+    const matches = xml.match(headingPattern);
+    return matches ? matches.length : 0;
+}
+//# sourceMappingURL=output.js.map

package/dist/core/validation/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../src/core/validation/output.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,SAAS,CAAC;AAS7B;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,cAAsB,EACtB,cAAsB;IAEtB,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,SAAiB,CAAC;IACtB,IAAI,SAAiB,CAAC;IACtB,IAAI,CAAC;QACH,SAAS,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;QAC/C,SAAS,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,CAAC,yBAA0B,GAAa,CAAC,OAAO,EAAE,CAAC;YAC3D,kBAAkB,EAAE,CAAC;YACrB,kBAAkB,EAAE,CAAC;SACtB,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,cAAc,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAEhD,IAAI,cAAc,KAAK,cAAc,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,CACT,sCAAsC,cAAc,yBAAyB,cAAc,IAAI;YAC/F,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;QACN,kBAAkB,EAAE,cAAc;QAClC,kBAAkB,EAAE,cAAc;KACnC,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IAChD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,cAAc,GAAG,oBAAoB,CAAC;IAC5C,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC1C,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC"}

package/dist/core/validation/recipe.d.ts

@@ -0,0 +1,19 @@
+export interface RecipeValidationResult {
+    recipeId: string;
+    valid: boolean;
+    scaffold: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Validate a recipe directory:
+ * - No .docx files (copyrighted content must not be committed)
+ * - metadata.yaml validates against schema
+ * - For non-scaffold recipes: replacements.json present and valid
+ * - Replacement values must be valid {identifier} tags
+ * - In strict mode: scaffolds are errors, all files required
+ */
+export declare function validateRecipe(recipeDir: string, recipeId: string, options?: {
+    strict?: boolean;
+}): RecipeValidationResult;
+//# sourceMappingURL=recipe.d.ts.map

package/dist/core/validation/recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.d.ts","sourceRoot":"","sources":["../../../src/core/validation/recipe.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AASD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7B,sBAAsB,CAmJxB"}

package/dist/core/validation/recipe.js

@@ -0,0 +1,159 @@
+import { readdirSync, existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { validateRecipeMetadata, loadRecipeMetadata } from '../metadata.js';
+import { CleanConfigSchema } from '../metadata.js';
+import { NormalizeConfigSchema } from '../metadata.js';
+import { parseReplacementKey } from '../recipe/replacement-keys.js';
+import { ComputedProfileSchema } from '../recipe/computed.js';
+/** Pattern for valid template tags within replacement values */
+const TAG_RE = /\{[a-z_][a-z0-9_]*\}/g;
+/** Pattern for any curly-brace token (to detect control tags) */
+const ANY_BRACE_RE = /\{[^}]+\}/g;
+/** Only simple identifiers inside braces are allowed */
+const SAFE_TAG_RE = /^\{[a-z_][a-z0-9_]*\}$/;
+/**
+ * Validate a recipe directory:
+ * - No .docx files (copyrighted content must not be committed)
+ * - metadata.yaml validates against schema
+ * - For non-scaffold recipes: replacements.json present and valid
+ * - Replacement values must be valid {identifier} tags
+ * - In strict mode: scaffolds are errors, all files required
+ */
+export function validateRecipe(recipeDir, recipeId, options) {
+    const errors = [];
+    const warnings = [];
+    const strict = options?.strict ?? false;
+    // Check for .docx files (forbidden in recipe dirs)
+    const files = readdirSync(recipeDir);
+    const docxFiles = files.filter((f) => f.toLowerCase().endsWith('.docx'));
+    if (docxFiles.length > 0) {
+        errors.push(`Copyrighted .docx file(s) found: ${docxFiles.join(', ')}. Recipes must not contain source documents.`);
+    }
+    // Validate metadata
+    const metaResult = validateRecipeMetadata(recipeDir);
+    if (!metaResult.valid) {
+        errors.push(...metaResult.errors.map((e) => `metadata: ${e}`));
+        return { recipeId, valid: false, scaffold: false, errors, warnings };
+    }
+    // Scaffold detection: if only metadata.yaml exists, this is a scaffold
+    const metadata = loadRecipeMetadata(recipeDir);
+    const metadataFieldNames = new Set(metadata.fields.map((field) => field.name));
+    const computedPath = join(recipeDir, 'computed.json');
+    const hasReplacements = existsSync(join(recipeDir, 'replacements.json'));
+    const isScaffold = !hasReplacements;
+    // Validate computed.json if present
+    if (existsSync(computedPath)) {
+        try {
+            const raw = readFileSync(computedPath, 'utf-8');
+            ComputedProfileSchema.parse(JSON.parse(raw));
+        }
+        catch (err) {
+            if (err instanceof Error) {
+                errors.push(`computed.json: ${err.message}`);
+            }
+            else {
+                errors.push('computed.json: invalid format');
+            }
+        }
+    }
+    if (isScaffold) {
+        if (strict) {
+            errors.push('Scaffold recipe (metadata-only): not runnable. Use non-strict mode to allow scaffolds.');
+        }
+        else {
+            warnings.push('Scaffold recipe (metadata-only): not runnable');
+        }
+        return { recipeId, valid: errors.length === 0, scaffold: true, errors, warnings };
+    }
+    // Validate replacements.json
+    if (hasReplacements) {
+        try {
+            const raw = readFileSync(join(recipeDir, 'replacements.json'), 'utf-8');
+            const replacements = JSON.parse(raw);
+            if (typeof replacements !== 'object' || replacements === null) {
+                errors.push('replacements.json must be a JSON object');
+            }
+            else {
+                const unknownTargets = new Set();
+                for (const [key, value] of Object.entries(replacements)) {
+                    if (typeof value !== 'string') {
+                        errors.push(`replacements.json: value for "${key}" must be a string`);
+                        continue;
+                    }
+                    // Value must contain at least one {identifier} tag
+                    const tags = value.match(TAG_RE);
+                    if (!tags || tags.length === 0) {
+                        errors.push(`replacements.json: value for "${key}" must contain at least one {identifier} tag, got "${value}"`);
+                    }
+                    // All curly-brace tokens in value must be safe identifiers (no control tags)
+                    const allBraces = value.match(ANY_BRACE_RE);
+                    if (allBraces) {
+                        for (const token of allBraces) {
+                            if (!SAFE_TAG_RE.test(token)) {
+                                errors.push(`replacements.json: unsafe tag "${token}" in value for "${key}". Only {identifier} tags allowed.`);
+                                continue;
+                            }
+                            const fieldName = token.slice(1, -1);
+                            if (!metadataFieldNames.has(fieldName)) {
+                                unknownTargets.add(fieldName);
+                            }
+                        }
+                    }
+                    // Value must not contain the source key (infinite loop prevention)
+                    // For qualified keys, check against the searchText, not the full key.
+                    // Nth keys use single-shot replacement so they can't loop — skip the check.
+                    const parsed = parseReplacementKey(key, value);
+                    if (parsed.type === 'simple' && value.includes(parsed.searchText)) {
+                        errors.push(`replacements.json: value for "${key}" contains the key itself (would cause infinite loop)`);
+                    }
+                    else if (parsed.type === 'context' && value.includes(parsed.searchText)) {
+                        errors.push(`replacements.json: value for "${key}" contains the search text "${parsed.searchText}" (would cause infinite loop)`);
+                    }
+                    // nth keys: no infinite-loop check needed (single-shot replacement)
+                }
+                for (const fieldName of unknownTargets) {
+                    warnings.push(`Replacement target {${fieldName}} not found in metadata fields`);
+                }
+            }
+        }
+        catch (err) {
+            errors.push(`replacements.json: ${err.message}`);
+        }
+    }
+    else {
+        if (strict) {
+            errors.push('replacements.json not found (required for runnable recipes)');
+        }
+        else {
+            warnings.push('replacements.json not found (required for runnable recipes)');
+        }
+    }
+    // Validate clean.json if present
+    const cleanPath = join(recipeDir, 'clean.json');
+    if (existsSync(cleanPath)) {
+        try {
+            const raw = readFileSync(cleanPath, 'utf-8');
+            CleanConfigSchema.parse(JSON.parse(raw));
+        }
+        catch {
+            errors.push(`clean.json: invalid format`);
+        }
+    }
+    // Validate normalize.json if present
+    const normalizePath = join(recipeDir, 'normalize.json');
+    if (existsSync(normalizePath)) {
+        try {
+            const raw = readFileSync(normalizePath, 'utf-8');
+            NormalizeConfigSchema.parse(JSON.parse(raw));
+        }
+        catch {
+            errors.push('normalize.json: invalid format');
+        }
+    }
+    // Warn if source_sha256 is missing (fill will skip integrity verification)
+    if (!metadata.source_sha256) {
+        warnings.push('No source_sha256 in metadata — fill will skip integrity verification');
+    }
+    return { recipeId, valid: errors.length === 0, scaffold: false, errors, warnings };
+}
+//# sourceMappingURL=recipe.js.map

package/dist/core/validation/recipe.js.map

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

package/dist/core/validation/scan-metadata.d.ts

@@ -0,0 +1,21 @@
+export interface ScanMetadataCoverageInput {
+    scannedShortPlaceholders: string[];
+    metadataFields: string[];
+    replacements: Record<string, string>;
+    extraCoveredFields?: string[];
+    ignoredPlaceholders?: string[];
+}
+export interface ScanMetadataCoverageReport {
+    coveredShortPlaceholders: string[];
+    uncoveredShortPlaceholders: string[];
+    ignoredShortPlaceholders: string[];
+    placeholderToFields: Record<string, string[]>;
+    mappedFieldsNotInMetadata: string[];
+    metadataFieldsWithoutPlaceholderCoverage: string[];
+}
+/**
+ * Compare short placeholders discovered via scan against recipe/template metadata
+ * coverage inferred from replacements mapping.
+ */
+export declare function assessScanMetadataCoverage(input: ScanMetadataCoverageInput): ScanMetadataCoverageReport;
+//# sourceMappingURL=scan-metadata.d.ts.map

package/dist/core/validation/scan-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-metadata.d.ts","sourceRoot":"","sources":["../../../src/core/validation/scan-metadata.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,yBAAyB;IACxC,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,0BAA0B;IACzC,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,0BAA0B,EAAE,MAAM,EAAE,CAAC;IACrC,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,yBAAyB,EAAE,MAAM,EAAE,CAAC;IACpC,wCAAwC,EAAE,MAAM,EAAE,CAAC;CACpD;AAWD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,yBAAyB,GAC/B,0BAA0B,CAiE5B"}

package/dist/core/validation/scan-metadata.js

@@ -0,0 +1,70 @@
+import { parseReplacementKey } from '../recipe/replacement-keys.js';
+const FIELD_TAG_RE = /\{([a-z_][a-z0-9_]*)\}/g;
+function extractFieldTags(template) {
+    const out = new Set();
+    let match = null;
+    while ((match = FIELD_TAG_RE.exec(template)) !== null) {
+        out.add(match[1]);
+    }
+    return [...out];
+}
+/**
+ * Compare short placeholders discovered via scan against recipe/template metadata
+ * coverage inferred from replacements mapping.
+ */
+export function assessScanMetadataCoverage(input) {
+    const metadataFieldSet = new Set(input.metadataFields);
+    const ignored = new Set(input.ignoredPlaceholders ?? []);
+    const extraCovered = new Set(input.extraCoveredFields ?? []);
+    const placeholderFieldMap = new Map();
+    const mappedFieldsNotInMetadata = new Set();
+    for (const [key, value] of Object.entries(input.replacements)) {
+        const parsed = parseReplacementKey(key, value);
+        const searchText = parsed.searchText;
+        const tags = extractFieldTags(value);
+        if (!placeholderFieldMap.has(searchText)) {
+            placeholderFieldMap.set(searchText, new Set());
+        }
+        const fieldSet = placeholderFieldMap.get(searchText);
+        for (const tag of tags) {
+            fieldSet.add(tag);
+            if (!metadataFieldSet.has(tag)) {
+                mappedFieldsNotInMetadata.add(tag);
+            }
+        }
+    }
+    const coveredShort = new Set();
+    const uncoveredShort = new Set();
+    const ignoredShort = new Set();
+    const coveredFields = new Set(extraCovered);
+    for (const placeholder of input.scannedShortPlaceholders) {
+        if (ignored.has(placeholder)) {
+            ignoredShort.add(placeholder);
+            continue;
+        }
+        const mapped = placeholderFieldMap.get(placeholder);
+        if (!mapped || mapped.size === 0) {
+            uncoveredShort.add(placeholder);
+            continue;
+        }
+        coveredShort.add(placeholder);
+        for (const field of mapped) {
+            coveredFields.add(field);
+        }
+    }
+    const placeholderToFields = Object.fromEntries([...placeholderFieldMap.entries()]
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([placeholder, fields]) => [placeholder, [...fields].sort()]));
+    const metadataFieldsWithoutPlaceholderCoverage = [...metadataFieldSet]
+        .filter((field) => !coveredFields.has(field))
+        .sort();
+    return {
+        coveredShortPlaceholders: [...coveredShort].sort(),
+        uncoveredShortPlaceholders: [...uncoveredShort].sort(),
+        ignoredShortPlaceholders: [...ignoredShort].sort(),
+        placeholderToFields,
+        mappedFieldsNotInMetadata: [...mappedFieldsNotInMetadata].sort(),
+        metadataFieldsWithoutPlaceholderCoverage,
+    };
+}
+//# sourceMappingURL=scan-metadata.js.map

package/dist/core/validation/scan-metadata.js.map

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

package/dist/core/validation/template.d.ts

@@ -0,0 +1,11 @@
+export interface TemplateValidationResult {
+    templateId: string;
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Validate that a template's metadata fields match the placeholders in its DOCX file.
+ */
+export declare function validateTemplate(templateDir: string, templateId: string): TemplateValidationResult;
+//# sourceMappingURL=template.d.ts.map

package/dist/core/validation/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../src/core/validation/template.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA+BD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,wBAAwB,CAgLlG"}