@open-agreements/open-agreements 0.2.0

package/dist/core/recipe/source-drift.js

@@ -0,0 +1,113 @@
+import { readFileSync } from 'node:fs';
+import { createHash } from 'node:crypto';
+import AdmZip from 'adm-zip';
+import { parseReplacementKey } from './replacement-keys.js';
+const SHORT_PLACEHOLDER_MAX = 80;
+function extractDocumentParagraphs(docxPath) {
+    const zip = new AdmZip(docxPath);
+    const entry = zip.getEntry('word/document.xml');
+    if (!entry)
+        return [];
+    const xml = entry.getData().toString('utf-8');
+    const paragraphs = [];
+    const paraRegex = /<w:p[\s>][\s\S]*?<\/w:p>/g;
+    let paraMatch = null;
+    while ((paraMatch = paraRegex.exec(xml)) !== null) {
+        const paraXml = paraMatch[0];
+        const parts = [];
+        const tRegex = /<w:t[^>]*>([^<]*)<\/w:t>/g;
+        let tMatch = null;
+        while ((tMatch = tRegex.exec(paraXml)) !== null) {
+            parts.push(tMatch[1]);
+        }
+        const text = parts.join('').trim();
+        if (text.length > 0) {
+            paragraphs.push(text);
+        }
+    }
+    return paragraphs;
+}
+function extractBracketTokens(text) {
+    return [...text.matchAll(/\[([^\]]+)\]/g)].map((m) => m[1]);
+}
+export function computeSourceStructureSignature(docxPath) {
+    const paragraphs = extractDocumentParagraphs(docxPath);
+    const allBracketTokens = paragraphs.flatMap((paragraph) => extractBracketTokens(paragraph));
+    const uniqueShortPlaceholders = [...new Set(allBracketTokens
+            .filter((token) => token.length <= SHORT_PLACEHOLDER_MAX)
+            .map((token) => `[${token}]`))].sort();
+    const longClauseCount = allBracketTokens.filter((token) => token.length > SHORT_PLACEHOLDER_MAX).length;
+    const headingLikeCount = paragraphs.filter((p) => /^\[[A-Z][^\]]*$/.test(p)).length;
+    return {
+        paragraph_count: paragraphs.length,
+        heading_like_count: headingLikeCount,
+        short_placeholder_count: uniqueShortPlaceholders.length,
+        long_clause_count: longClauseCount,
+        unique_short_placeholders: uniqueShortPlaceholders,
+    };
+}
+function computeSha256Hex(path) {
+    return createHash('sha256').update(readFileSync(path)).digest('hex');
+}
+function uniqueSorted(values) {
+    return [...new Set(values)].sort();
+}
+export function checkRecipeSourceDrift(input) {
+    const { recipeId, sourcePath, metadata, replacements, normalizeConfig } = input;
+    const paragraphs = extractDocumentParagraphs(sourcePath);
+    const documentText = paragraphs.join('\n');
+    const actualSha = computeSha256Hex(sourcePath);
+    const hashMatch = metadata.source_sha256 ? metadata.source_sha256 === actualSha : true;
+    const replacementGroups = new Map();
+    for (const [key, value] of Object.entries(replacements)) {
+        const searchText = parseReplacementKey(key, value).searchText;
+        if (!replacementGroups.has(value)) {
+            replacementGroups.set(value, new Set());
+        }
+        replacementGroups.get(value).add(searchText);
+    }
+    const missingReplacementGroups = [];
+    for (const anchors of replacementGroups.values()) {
+        const anchorList = [...anchors].sort((a, b) => a.length - b.length || a.localeCompare(b));
+        const hasAnyAnchor = anchorList.some((anchor) => documentText.includes(anchor));
+        if (!hasAnyAnchor) {
+            missingReplacementGroups.push(anchorList[0]);
+        }
+    }
+    const missingNormalizeHeadingAnchors = uniqueSorted((normalizeConfig?.paragraph_rules ?? [])
+        .filter((rule) => !rule.ignore_heading)
+        .filter((rule) => {
+        const headingAnchors = [rule.section_heading, ...(rule.section_heading_any ?? [])];
+        return !headingAnchors.some((anchor) => documentText.includes(anchor));
+    })
+        .map((rule) => rule.id));
+    const missingNormalizeParagraphAnchors = uniqueSorted((normalizeConfig?.paragraph_rules ?? [])
+        .map((rule) => rule.paragraph_contains)
+        .filter((anchor) => !documentText.includes(anchor)));
+    const missingNormalizeParagraphEndAnchors = uniqueSorted((normalizeConfig?.paragraph_rules ?? [])
+        .map((rule) => rule.paragraph_end_contains)
+        .filter((anchor) => typeof anchor === 'string' && anchor.length > 0)
+        .filter((anchor) => !documentText.includes(anchor)));
+    const diff = {
+        missing_replacement_anchor_groups: uniqueSorted(missingReplacementGroups),
+        missing_normalize_heading_anchors: missingNormalizeHeadingAnchors,
+        missing_normalize_paragraph_anchors: missingNormalizeParagraphAnchors,
+        missing_normalize_paragraph_end_anchors: missingNormalizeParagraphEndAnchors,
+    };
+    const ok = hashMatch
+        && diff.missing_replacement_anchor_groups.length === 0
+        && diff.missing_normalize_heading_anchors.length === 0
+        && diff.missing_normalize_paragraph_anchors.length === 0
+        && diff.missing_normalize_paragraph_end_anchors.length === 0;
+    return {
+        recipe_id: recipeId,
+        source_path: sourcePath,
+        expected_sha256: metadata.source_sha256,
+        actual_sha256: actualSha,
+        hash_match: hashMatch,
+        structure: computeSourceStructureSignature(sourcePath),
+        diff,
+        ok,
+    };
+}
+//# sourceMappingURL=source-drift.js.map

package/dist/core/recipe/source-drift.js.map

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

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

@@ -0,0 +1,33 @@
+import type { RecipeMetadata } from '../metadata.js';
+import type { ComputedArtifact } from './computed.js';
+export interface RecipeRunOptions {
+    recipeId: string;
+    inputPath?: string;
+    outputPath: string;
+    values: Record<string, string | boolean>;
+    keepIntermediate?: boolean;
+    computedOutPath?: string;
+    normalizeBracketArtifacts?: boolean;
+}
+export interface RecipeRunResult {
+    outputPath: string;
+    metadata: RecipeMetadata;
+    fieldsUsed: string[];
+    stages: {
+        clean: string;
+        patch: string;
+        fill: string;
+    };
+    computedArtifact?: ComputedArtifact;
+    computedOutPath?: string;
+}
+export interface VerifyResult {
+    passed: boolean;
+    checks: VerifyCheck[];
+}
+export interface VerifyCheck {
+    name: string;
+    passed: boolean;
+    details?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/recipe/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACzC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/core/recipe/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/recipe/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,24 @@
+import type { VerifyResult } from './types.js';
+import type { CleanConfig } from '../metadata.js';
+/**
+ * Normalize text for value comparison:
+ * - Convert non-breaking spaces to regular spaces
+ * - Normalize smart quotes to straight quotes
+ * - Collapse runs of spaces/tabs to single space (preserve newlines)
+ * - Trim
+ */
+export declare function normalizeText(text: string): string;
+/**
+ * Verify a filled recipe output DOCX:
+ * - All context values appear in the document text
+ * - No unrendered {template_tags} remain
+ * - No leftover [bracketed placeholders] from the replacement map remain
+ * - Footnotes removed (if clean config specified)
+ * - Drafting note paragraphs removed (if clean config specified)
+ */
+export declare function verifyOutput(outputPath: string, values: Record<string, unknown>, replacements: Record<string, string>, cleanConfig?: CleanConfig): Promise<VerifyResult>;
+/**
+ * Extract all text from general OOXML text parts (document, headers, footers, endnotes).
+ */
+export declare function extractAllText(docxPath: string): string;
+//# sourceMappingURL=verifier.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verifier.d.ts","sourceRoot":"","sources":["../../../src/core/recipe/verifier.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAMlD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWlD;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,YAAY,CAAC,CA8FvB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8BvD"}

package/dist/core/recipe/verifier.js

@@ -0,0 +1,158 @@
+import AdmZip from 'adm-zip';
+import { DOMParser } from '@xmldom/xmldom';
+import { enumerateTextParts, getGeneralTextPartNames } from './ooxml-parts.js';
+import { extractSearchText } from './replacement-keys.js';
+const W_NS = 'http://schemas.openxmlformats.org/wordprocessingml/2006/main';
+/**
+ * Normalize text for value comparison:
+ * - Convert non-breaking spaces to regular spaces
+ * - Normalize smart quotes to straight quotes
+ * - Collapse runs of spaces/tabs to single space (preserve newlines)
+ * - Trim
+ */
+export function normalizeText(text) {
+    return text
+        // Non-breaking spaces
+        .replace(/[\u00A0\u2007\u202F]/g, ' ')
+        // Smart single quotes → straight
+        .replace(/[\u2018\u2019\u2039\u203A]/g, "'")
+        // Smart double quotes → straight
+        .replace(/[\u201C\u201D\u201A\u201E\u00AB\u00BB]/g, '"')
+        // Collapse horizontal whitespace (spaces/tabs) to single space, preserve newlines
+        .replace(/[^\S\n]+/g, ' ')
+        .trim();
+}
+/**
+ * Verify a filled recipe output DOCX:
+ * - All context values appear in the document text
+ * - No unrendered {template_tags} remain
+ * - No leftover [bracketed placeholders] from the replacement map remain
+ * - Footnotes removed (if clean config specified)
+ * - Drafting note paragraphs removed (if clean config specified)
+ */
+export async function verifyOutput(outputPath, values, replacements, cleanConfig) {
+    const checks = [];
+    const rawFullText = extractAllText(outputPath);
+    const normalizedFullText = normalizeText(rawFullText);
+    const xml = extractDocumentXml(outputPath);
+    // Check 1: All context values present (with normalization)
+    const missingValues = [];
+    for (const [key, value] of Object.entries(values)) {
+        if (typeof value !== 'string' || !value.trim())
+            continue; // only verify non-empty text values
+        const normalizedValue = normalizeText(value);
+        if (!normalizedFullText.includes(normalizedValue)) {
+            missingValues.push(`${key}="${value}"`);
+        }
+    }
+    checks.push({
+        name: 'Context values present',
+        passed: missingValues.length === 0,
+        details: missingValues.length > 0 ? `Missing: ${missingValues.join(', ')}` : undefined,
+    });
+    // Check 2: No unrendered {template_tags}
+    const unrenderedTags = rawFullText.match(/\{[a-z_][a-z0-9_]*\}/gi) ?? [];
+    checks.push({
+        name: 'No unrendered template tags',
+        passed: unrenderedTags.length === 0,
+        details: unrenderedTags.length > 0 ? `Found: ${unrenderedTags.join(', ')}` : undefined,
+    });
+    // Check 3: No leftover [bracketed placeholders] from replacement map
+    // Use extractSearchText() to handle qualified keys (context, nth) properly
+    const searchTexts = [...new Set(Object.keys(replacements).map(extractSearchText))];
+    const leftoverBrackets = searchTexts.filter((text) => rawFullText.includes(text));
+    checks.push({
+        name: 'No leftover source placeholders',
+        passed: leftoverBrackets.length === 0,
+        details: leftoverBrackets.length > 0 ? `Found: ${leftoverBrackets.join(', ')}` : undefined,
+    });
+    // Check 4: No footnote references (if removeFootnotes was set)
+    if (cleanConfig?.removeFootnotes) {
+        const footnoteRefs = (xml.match(/footnoteReference/g) ?? []).length;
+        checks.push({
+            name: 'Footnotes removed',
+            passed: footnoteRefs === 0,
+            details: footnoteRefs > 0 ? `${footnoteRefs} footnote reference(s) remain` : undefined,
+        });
+    }
+    // Check 5: No double dollar signs ($$ or $ $)
+    // This catches cases where the template already has a $ before a placeholder
+    // and the user also included a $ in their value (e.g. "$1,000,000")
+    const doubleDollarPattern = /\$[\s\u00A0\t]*\$/;
+    const doubleDollarLines = rawFullText.split('\n').filter((line) => doubleDollarPattern.test(line));
+    checks.push({
+        name: 'No double dollar signs',
+        passed: doubleDollarLines.length === 0,
+        details: doubleDollarLines.length > 0
+            ? `Found ${doubleDollarLines.length} occurrence(s): "${doubleDollarLines[0].trim().slice(0, 80)}"`
+            : undefined,
+    });
+    // Check 6: No drafting note paragraphs (if patterns were set)
+    if (cleanConfig?.removeParagraphPatterns && cleanConfig.removeParagraphPatterns.length > 0) {
+        const regexes = cleanConfig.removeParagraphPatterns.map((p) => new RegExp(p, 'i'));
+        const lines = rawFullText.split('\n');
+        const matchingLines = lines.filter((line) => regexes.some((r) => r.test(line.trim())));
+        checks.push({
+            name: 'Drafting notes removed',
+            passed: matchingLines.length === 0,
+            details: matchingLines.length > 0 ? `Found: ${matchingLines[0].trim().slice(0, 80)}...` : undefined,
+        });
+    }
+    // Check 7: No range-deleted sections (if ranges were set)
+    if (cleanConfig?.removeRanges && cleanConfig.removeRanges.length > 0) {
+        const rangeStartPatterns = cleanConfig.removeRanges.map((r) => new RegExp(r.start, 'i'));
+        const lines = rawFullText.split('\n');
+        const matchingLines = lines.filter((line) => rangeStartPatterns.some((r) => r.test(line.trim())));
+        checks.push({
+            name: 'Range-deleted sections removed',
+            passed: matchingLines.length === 0,
+            details: matchingLines.length > 0
+                ? `Found: ${matchingLines[0].trim().slice(0, 80)}...`
+                : undefined,
+        });
+    }
+    return {
+        passed: checks.every((c) => c.passed),
+        checks,
+    };
+}
+/**
+ * Extract all text from general OOXML text parts (document, headers, footers, endnotes).
+ */
+export function extractAllText(docxPath) {
+    const zip = new AdmZip(docxPath);
+    const parser = new DOMParser();
+    const parts = enumerateTextParts(zip);
+    const partNames = getGeneralTextPartNames(parts);
+    const allParagraphs = [];
+    for (const partName of partNames) {
+        const entry = zip.getEntry(partName);
+        if (!entry)
+            continue;
+        const xml = entry.getData().toString('utf-8');
+        const doc = parser.parseFromString(xml, 'text/xml');
+        const paras = doc.getElementsByTagNameNS(W_NS, 'p');
+        for (let i = 0; i < paras.length; i++) {
+            const tElements = paras[i].getElementsByTagNameNS(W_NS, 't');
+            const textParts = [];
+            for (let j = 0; j < tElements.length; j++) {
+                textParts.push(tElements[j].textContent ?? '');
+            }
+            if (textParts.length > 0) {
+                allParagraphs.push(textParts.join(''));
+            }
+        }
+    }
+    return allParagraphs.join('\n');
+}
+/**
+ * Extract raw XML from word/document.xml only (for footnote ref counting).
+ */
+function extractDocumentXml(docxPath) {
+    const zip = new AdmZip(docxPath);
+    const entry = zip.getEntry('word/document.xml');
+    if (!entry)
+        return '';
+    return entry.getData().toString('utf-8');
+}
+//# sourceMappingURL=verifier.js.map

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

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

package/dist/core/selector.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Declarative option selection for DOCX templates.
+ *
+ * Handles radio-button `( )` and checkbox `[ ]` option groups in table cells.
+ * A per-template `selections.json` config defines groups, and this module
+ * deletes unselected options + their sub-clauses from the DOCX XML before filling.
+ */
+import { z } from 'zod';
+export declare const SelectionsConfigSchema: z.ZodObject<{
+    groups: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<{
+            radio: "radio";
+            checkbox: "checkbox";
+        }>;
+        options: z.ZodArray<z.ZodObject<{
+            marker: z.ZodString;
+            trigger: z.ZodUnion<readonly [z.ZodLiteral<"default">, z.ZodObject<{
+                field: z.ZodString;
+                equals: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>;
+            }, z.core.$strip>, z.ZodObject<{
+                field: z.ZodString;
+            }, z.core.$strip>]>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SelectionsConfig = z.infer<typeof SelectionsConfigSchema>;
+export declare function loadSelectionsConfig(path: string): SelectionsConfig;
+/**
+ * Apply option selections to a DOCX buffer and return the modified buffer.
+ *
+ * For each group in the config:
+ * 1. Find option paragraphs by marker text + radio/checkbox prefix
+ * 2. Verify they share the same table cell
+ * 3. Classify paragraphs as header, option, or sub-clause
+ * 4. Evaluate triggers to determine selected options
+ * 5. Remove unselected options + sub-clauses
+ * 6. Mark selected options as checked
+ */
+export declare function applySelections(inputPath: string, outputPath: string, config: SelectionsConfig, data: Record<string, unknown>): Promise<void>;
+//# sourceMappingURL=selector.d.ts.map

package/dist/core/selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../src/core/selector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8BxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;iBAEjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAMtE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAGnE;AAgID;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAmCf"}