@open-agreements/open-agreements 0.2.0

package/dist/commands/list.js

@@ -0,0 +1,247 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { loadMetadata, loadRecipeMetadata, loadExternalMetadata } from '../core/metadata.js';
+import { listExternalEntries, listRecipeEntries, listTemplateEntries } from '../utils/paths.js';
+const pkgPath = fileURLToPath(new URL('../../package.json', import.meta.url));
+const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+function categoryFromId(id) {
+    if (id.includes('employment') || id.includes('employee-ip-inventions')) {
+        return 'employment';
+    }
+    return 'general';
+}
+/** Extract a human-friendly source name from a URL */
+function sourceName(url) {
+    try {
+        const parsed = new URL(url);
+        const host = parsed.hostname.replace(/^www\./, '');
+        const pathname = parsed.pathname;
+        if (host === 'github.com' && pathname.startsWith('/open-agreements/')) {
+            return 'OpenAgreements';
+        }
+        if (host === 'github.com' && pathname.startsWith('/papertrail/legal-docs')) {
+            return 'Papertrail';
+        }
+        if (host === 'github.com' && pathname.startsWith('/docusign/')) {
+            return 'DocuSign';
+        }
+        const map = {
+            'commonpaper.com': 'Common Paper',
+            'bonterms.com': 'Bonterms',
+            'ycombinator.com': 'Y Combinator',
+            'bookface-static.ycombinator.com': 'Y Combinator',
+            'nvca.org': 'NVCA',
+            'openagreements.ai': 'OpenAgreements',
+        };
+        return map[host] ?? host;
+    }
+    catch {
+        return null;
+    }
+}
+export function runList(opts = {}) {
+    if (opts.json || opts.jsonStrict) {
+        runListJson(opts);
+        return;
+    }
+    listAgreementsWithOptions(opts);
+}
+function mapFields(fields, requiredFields) {
+    const required = new Set(requiredFields);
+    return fields.map((f) => ({
+        name: f.name,
+        type: f.type,
+        required: required.has(f.name),
+        section: f.section ?? null,
+        description: f.description,
+        default: f.default ?? null,
+    }));
+}
+function runListJson(opts) {
+    const results = [];
+    const errors = [];
+    const templatesOnly = opts.templatesOnly === true;
+    // Templates
+    for (const entry of listTemplateEntries()) {
+        const id = entry.id;
+        const dir = entry.dir;
+        try {
+            const meta = loadMetadata(dir);
+            results.push({
+                name: id,
+                category: categoryFromId(id),
+                description: meta.description ?? meta.name,
+                license: meta.license,
+                source_url: meta.source_url,
+                source: sourceName(meta.source_url),
+                attribution_text: meta.attribution_text,
+                fields: mapFields(meta.fields, meta.required_fields),
+            });
+        }
+        catch (err) {
+            errors.push(`template ${id}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    if (!templatesOnly) {
+        // External templates
+        for (const entry of listExternalEntries()) {
+            const id = entry.id;
+            const dir = entry.dir;
+            try {
+                const meta = loadExternalMetadata(dir);
+                results.push({
+                    name: id,
+                    category: categoryFromId(id),
+                    description: meta.description ?? meta.name,
+                    license: meta.license,
+                    source_url: meta.source_url,
+                    source: sourceName(meta.source_url),
+                    attribution_text: meta.attribution_text,
+                    fields: mapFields(meta.fields, meta.required_fields),
+                });
+            }
+            catch (err) {
+                errors.push(`external ${id}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        // Recipes
+        for (const entry of listRecipeEntries()) {
+            const id = entry.id;
+            const dir = entry.dir;
+            try {
+                const meta = loadRecipeMetadata(dir);
+                results.push({
+                    name: id,
+                    category: categoryFromId(id),
+                    description: meta.description ?? meta.name,
+                    license_note: meta.license_note,
+                    source_url: meta.source_url,
+                    source: sourceName(meta.source_url),
+                    source_version: meta.source_version,
+                    optional: meta.optional,
+                    fields: mapFields(meta.fields, meta.required_fields),
+                });
+            }
+            catch (err) {
+                errors.push(`recipe ${id}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    results.sort((a, b) => a.name.localeCompare(b.name));
+    if (opts.jsonStrict && errors.length > 0) {
+        for (const msg of errors) {
+            console.error(`error: ${msg}`);
+        }
+        process.exit(1);
+    }
+    const envelope = {
+        schema_version: 1,
+        cli_version: pkg.version,
+        items: results,
+    };
+    console.log(JSON.stringify(envelope, null, 2));
+}
+function listAgreementsWithOptions(opts) {
+    const rows = [];
+    const templatesOnly = opts.templatesOnly === true;
+    for (const entry of listTemplateEntries()) {
+        const id = entry.id;
+        const dir = entry.dir;
+        try {
+            const meta = loadMetadata(dir);
+            const required = meta.required_fields.length;
+            rows.push({
+                id,
+                category: categoryFromId(id),
+                license: meta.license,
+                required,
+                total: meta.fields.length,
+                source: sourceName(meta.source_url) || '—',
+                sourceUrl: meta.source_url,
+            });
+        }
+        catch {
+            rows.push({
+                id,
+                category: categoryFromId(id),
+                license: 'ERROR',
+                required: 0,
+                total: 0,
+                source: '—',
+                sourceUrl: 'Could not load metadata',
+            });
+        }
+    }
+    if (!templatesOnly) {
+        for (const entry of listExternalEntries()) {
+            const id = entry.id;
+            const dir = entry.dir;
+            try {
+                const meta = loadExternalMetadata(dir);
+                const required = meta.required_fields.length;
+                rows.push({
+                    id,
+                    category: categoryFromId(id),
+                    license: meta.license,
+                    required,
+                    total: meta.fields.length,
+                    source: sourceName(meta.source_url) || '—',
+                    sourceUrl: meta.source_url,
+                });
+            }
+            catch {
+                rows.push({
+                    id,
+                    category: categoryFromId(id),
+                    license: 'ERROR',
+                    required: 0,
+                    total: 0,
+                    source: '—',
+                    sourceUrl: 'Could not load metadata',
+                });
+            }
+        }
+        for (const entry of listRecipeEntries()) {
+            const id = entry.id;
+            const dir = entry.dir;
+            try {
+                const meta = loadRecipeMetadata(dir);
+                const required = meta.required_fields.length;
+                const license = meta.optional ? 'recipe*' : 'recipe';
+                rows.push({
+                    id,
+                    category: categoryFromId(id),
+                    license,
+                    required,
+                    total: meta.fields.length,
+                    source: sourceName(meta.source_url) || '—',
+                    sourceUrl: meta.source_url,
+                });
+            }
+            catch {
+                rows.push({
+                    id,
+                    category: categoryFromId(id),
+                    license: 'ERROR',
+                    required: 0,
+                    total: 0,
+                    source: '—',
+                    sourceUrl: 'Could not load metadata',
+                });
+            }
+        }
+    }
+    if (rows.length === 0) {
+        console.log('No agreements found.');
+        return;
+    }
+    rows.sort((a, b) => a.id.localeCompare(b.id));
+    console.log(`\n${'Agreement'.padEnd(40)} ${'Category'.padEnd(12)} ${'License'.padEnd(14)} ${'Fields'.padEnd(8)} ${'Source'.padEnd(16)} URL`);
+    console.log('─'.repeat(120));
+    for (const row of rows) {
+        const fields = row.license === 'ERROR' ? '—' : `${row.required}/${row.total}`;
+        console.log(`${row.id.padEnd(40)} ${row.category.padEnd(12)} ${row.license.padEnd(14)} ${fields.padEnd(8)} ${row.source.padEnd(16)} ${row.sourceUrl}`);
+    }
+    console.log('');
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEhG,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC9E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAavD,SAAS,cAAc,CAAC,EAAU;IAChC,IAAI,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;QACvE,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,sDAAsD;AACtD,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAEjC,IAAI,IAAI,KAAK,YAAY,IAAI,QAAQ,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACtE,OAAO,gBAAgB,CAAC;QAC1B,CAAC;QACD,IAAI,IAAI,KAAK,YAAY,IAAI,QAAQ,CAAC,UAAU,CAAC,wBAAwB,CAAC,EAAE,CAAC;YAC3E,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,IAAI,IAAI,KAAK,YAAY,IAAI,QAAQ,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/D,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,MAAM,GAAG,GAA2B;YAClC,iBAAiB,EAAE,cAAc;YACjC,cAAc,EAAE,UAAU;YAC1B,iBAAiB,EAAE,cAAc;YACjC,iCAAiC,EAAE,cAAc;YACjD,UAAU,EAAE,MAAM;YAClB,mBAAmB,EAAE,gBAAgB;SACtC,CAAC;QACF,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAoB,EAAE;IAC5C,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,WAAW,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO;IACT,CAAC;IACD,yBAAyB,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,SAAS,CAChB,MAAiG,EACjG,cAAwB;IAExB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9B,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI;QAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI;KAC3B,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,WAAW,CAAC,IAAiB;IACpC,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC;IAElD,YAAY;IACZ,KAAK,MAAM,KAAK,IAAI,mBAAmB,EAAE,EAAE,CAAC;QAC1C,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,EAAE;gBACR,QAAQ,EAAE,cAAc,CAAC,EAAE,CAAC;gBAC5B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI;gBAC1C,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC;gBACnC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;gBACvC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC;aACrD,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAED,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,qBAAqB;QACrB,KAAK,MAAM,KAAK,IAAI,mBAAmB,EAAE,EAAE,CAAC;YAC1C,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;gBACvC,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,EAAE;oBACR,QAAQ,EAAE,cAAc,CAAC,EAAE,CAAC;oBAC5B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI;oBAC1C,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC;oBACnC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;oBACvC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC;iBACrD,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;QAED,UAAU;QACV,KAAK,MAAM,KAAK,IAAI,iBAAiB,EAAE,EAAE,CAAC;YACxC,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;gBACrC,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,EAAE;oBACR,QAAQ,EAAE,cAAc,CAAC,EAAE,CAAC;oBAC5B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI;oBAC1C,YAAY,EAAE,IAAI,CAAC,YAAY;oBAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC;oBACnC,cAAc,EAAE,IAAI,CAAC,cAAc;oBACnC,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC;iBACrD,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAErD,IAAI,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG;QACf,cAAc,EAAE,CAAC;QACjB,WAAW,EAAE,GAAG,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO;KACf,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,yBAAyB,CAAC,IAAiB;IAElD,MAAM,IAAI,GAAU,EAAE,CAAC;IACvB,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC;IAElD,KAAK,MAAM,KAAK,IAAI,mBAAmB,EAAE,EAAE,CAAC;QAC1C,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;YAC7C,IAAI,CAAC,IAAI,CAAC;gBACR,EAAE;gBACF,QAAQ,EAAE,cAAc,CAAC,EAAE,CAAC;gBAC5B,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,QAAQ;gBACR,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;gBACzB,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG;gBAC1C,SAAS,EAAE,IAAI,CAAC,UAAU;aAC3B,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,IAAI,CAAC;gBACR,EAAE;gBACF,QAAQ,EAAE,cAAc,CAAC,EAAE,CAAC;gBAC5B,OAAO,EAAE,OAAO;gBAChB,QAAQ,EAAE,CAAC;gBACX,KAAK,EAAE,CAAC;gBACR,MAAM,EAAE,GAAG;gBACX,SAAS,EAAE,yBAAyB;aACrC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,KAAK,MAAM,KAAK,IAAI,mBAAmB,EAAE,EAAE,CAAC;YAC1C,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;gBACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;gBAC7C,IAAI,CAAC,IAAI,CAAC;oBACR,EAAE;oBACF,QAAQ,EAAE,cAAc,CAAC,EAAE,CAAC;oBAC5B,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,QAAQ;oBACR,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;oBACzB,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG;oBAC1C,SAAS,EAAE,IAAI,CAAC,UAAU;iBAC3B,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,IAAI,CAAC;oBACR,EAAE;oBACF,QAAQ,EAAE,cAAc,CAAC,EAAE,CAAC;oBAC5B,OAAO,EAAE,OAAO;oBAChB,QAAQ,EAAE,CAAC;oBACX,KAAK,EAAE,CAAC;oBACR,MAAM,EAAE,GAAG;oBACX,SAAS,EAAE,yBAAyB;iBACrC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,iBAAiB,EAAE,EAAE,CAAC;YACxC,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;gBACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;gBAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;gBACrD,IAAI,CAAC,IAAI,CAAC;oBACR,EAAE;oBACF,QAAQ,EAAE,cAAc,CAAC,EAAE,CAAC;oBAC5B,OAAO;oBACP,QAAQ;oBACR,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;oBACzB,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG;oBAC1C,SAAS,EAAE,IAAI,CAAC,UAAU;iBAC3B,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,IAAI,CAAC;oBACR,EAAE;oBACF,QAAQ,EAAE,cAAc,CAAC,EAAE,CAAC;oBAC5B,OAAO,EAAE,OAAO;oBAChB,QAAQ,EAAE,CAAC;oBACX,KAAK,EAAE,CAAC;oBACR,MAAM,EAAE,GAAG;oBACX,SAAS,EAAE,yBAAyB;iBACrC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACpC,OAAO;IACT,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9C,OAAO,CAAC,GAAG,CACT,KAAK,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAChI,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAE7B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAC9E,OAAO,CAAC,GAAG,CACT,GAAG,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,SAAS,EAAE,CAC1I,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/commands/recipe.d.ts

@@ -0,0 +1,24 @@
+export interface RecipeRunArgs {
+    recipeId: string;
+    input?: string;
+    output?: string;
+    data?: string;
+    keepIntermediate?: boolean;
+    computedOut?: string;
+    normalizeBrackets?: boolean;
+}
+export declare function runRecipeCommand(args: RecipeRunArgs): Promise<void>;
+export interface RecipeCleanArgs {
+    input: string;
+    output: string;
+    recipe: string;
+    extractGuidance?: string;
+}
+export declare function runRecipeClean(args: RecipeCleanArgs): Promise<void>;
+export interface RecipePatchArgs {
+    input: string;
+    output: string;
+    recipe: string;
+}
+export declare function runRecipePatch(args: RecipePatchArgs): Promise<void>;
+//# sourceMappingURL=recipe.d.ts.map

package/dist/commands/recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.d.ts","sourceRoot":"","sources":["../../src/commands/recipe.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCzE;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BzE;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAYzE"}

package/dist/commands/recipe.js

@@ -0,0 +1,96 @@
+import { resolve } from 'node:path';
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { runRecipe, cleanDocument, patchDocument } from '../core/recipe/index.js';
+import { loadCleanConfig } from '../core/metadata.js';
+import { getRecipesDir, resolveRecipeDir } from '../utils/paths.js';
+export async function runRecipeCommand(args) {
+    const recipeDir = resolveRecipeDir(args.recipeId);
+    if (!existsSync(recipeDir)) {
+        const available = getAvailableRecipes();
+        console.error(`Recipe "${args.recipeId}" not found.`);
+        if (available.length > 0) {
+            console.error(`Available recipes: ${available.join(', ')}`);
+        }
+        process.exit(1);
+    }
+    let values = {};
+    if (args.data) {
+        values = JSON.parse(readFileSync(args.data, 'utf-8'));
+    }
+    const outputPath = resolve(args.output ?? `${args.recipeId}-filled.docx`);
+    try {
+        const result = await runRecipe({
+            recipeId: args.recipeId,
+            inputPath: args.input ? resolve(args.input) : undefined,
+            outputPath,
+            values,
+            keepIntermediate: args.keepIntermediate,
+            computedOutPath: args.computedOut ? resolve(args.computedOut) : undefined,
+            normalizeBracketArtifacts: args.normalizeBrackets,
+        });
+        console.log(`Filled ${result.metadata.name}`);
+        console.log(`Output: ${result.outputPath}`);
+        console.log(`Fields used: ${result.fieldsUsed.join(', ')}`);
+        if (result.computedOutPath && result.computedArtifact) {
+            console.log(`Computed artifact: ${result.computedOutPath}`);
+        }
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+export async function runRecipeClean(args) {
+    const recipeDir = resolveRecipeDir(args.recipe);
+    const config = loadCleanConfig(recipeDir);
+    const inputPath = resolve(args.input);
+    try {
+        if (args.extractGuidance) {
+            const sourceData = readFileSync(inputPath);
+            const sourceHash = createHash('sha256').update(sourceData).digest('hex');
+            const cleanPath = resolve(recipeDir, 'clean.json');
+            const configData = existsSync(cleanPath) ? readFileSync(cleanPath, 'utf-8') : '{}';
+            const configHash = createHash('sha256').update(configData).digest('hex');
+            const result = await cleanDocument(inputPath, resolve(args.output), config, {
+                extractGuidance: true,
+                sourceHash,
+                configHash,
+            });
+            if (result.guidance) {
+                writeFileSync(resolve(args.extractGuidance), JSON.stringify(result.guidance, null, 2) + '\n');
+                console.log(`Guidance: ${args.extractGuidance} (${result.guidance.entries.length} entries)`);
+            }
+        }
+        else {
+            await cleanDocument(inputPath, resolve(args.output), config);
+        }
+        console.log(`Cleaned: ${args.output}`);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+export async function runRecipePatch(args) {
+    const recipeDir = resolveRecipeDir(args.recipe);
+    const replacementsPath = resolve(recipeDir, 'replacements.json');
+    const replacements = JSON.parse(readFileSync(replacementsPath, 'utf-8'));
+    try {
+        await patchDocument(resolve(args.input), resolve(args.output), replacements);
+        console.log(`Patched: ${args.output}`);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+function getAvailableRecipes() {
+    const recipesDir = getRecipesDir();
+    if (!existsSync(recipesDir))
+        return [];
+    return readdirSync(recipesDir, { withFileTypes: true })
+        .filter((d) => d.isDirectory())
+        .map((d) => d.name);
+}
+//# sourceMappingURL=recipe.js.map

package/dist/commands/recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.js","sourceRoot":"","sources":["../../src/commands/recipe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAYpE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAmB;IACxD,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAElD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;QACxC,OAAO,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,QAAQ,cAAc,CAAC,CAAC;QACtD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CAAC,sBAAsB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,GAAqC,EAAE,CAAC;IAClD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,cAAc,CAAC,CAAC;IAE1E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;YACvD,UAAU;YACV,MAAM;YACN,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,eAAe,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;YACzE,yBAAyB,EAAE,IAAI,CAAC,iBAAiB;SAClD,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5D,IAAI,MAAM,CAAC,eAAe,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YACtD,OAAO,CAAC,GAAG,CAAC,sBAAsB,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAqB;IACxD,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEtC,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,MAAM,UAAU,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;YAC3C,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;YACnD,MAAM,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACnF,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAEzE,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE;gBAC1E,eAAe,EAAE,IAAI;gBACrB,UAAU;gBACV,UAAU;aACX,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;gBAC9F,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,eAAe,KAAK,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,WAAW,CAAC,CAAC;YAC/F,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAqB;IACxD,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,gBAAgB,GAAG,OAAO,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IACjE,MAAM,YAAY,GAA2B,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC;IAEjG,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,CAAC;QAC7E,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB;IAC1B,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,OAAO,WAAW,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACpD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/commands/scan.d.ts

@@ -0,0 +1,28 @@
+export interface ScanDocxResult {
+    partNames: string[];
+    bracketsByPart: Map<string, Set<string>>;
+    unique: string[];
+    shortPlaceholders: string[];
+    longClauses: string[];
+    footnoteCount: number;
+    underscoreBlankCount: number;
+}
+/**
+ * Collect bracket placeholder information from a DOCX file.
+ *
+ * This is the programmatic counterpart to the user-facing `scan` command and
+ * can be reused by tests and validation tools.
+ */
+export declare function scanDocxBrackets(inputPath: string): ScanDocxResult;
+/**
+ * Scan a DOCX file and report all bracketed placeholders.
+ * Classifies them as short (fill-in fields) vs long (alternative clauses).
+ * Optionally outputs a draft replacements.json.
+ *
+ * Scans all general OOXML text parts (document, headers, footers, endnotes).
+ */
+export declare function runScan(args: {
+    input: string;
+    outputReplacements?: string;
+}): void;
+//# sourceMappingURL=scan.d.ts.map

package/dist/commands/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../src/commands/scan.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CA6ClE;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAgElF"}

package/dist/commands/scan.js

@@ -0,0 +1,138 @@
+import { existsSync, writeFileSync } from 'node:fs';
+import AdmZip from 'adm-zip';
+import { enumerateTextParts, getGeneralTextPartNames } from '../core/recipe/ooxml-parts.js';
+/**
+ * Collect bracket placeholder information from a DOCX file.
+ *
+ * This is the programmatic counterpart to the user-facing `scan` command and
+ * can be reused by tests and validation tools.
+ */
+export function scanDocxBrackets(inputPath) {
+    const zip = new AdmZip(inputPath);
+    const parts = enumerateTextParts(zip);
+    const partNames = getGeneralTextPartNames(parts);
+    const bracketsByPart = new Map();
+    const allBrackets = [];
+    for (const partName of partNames) {
+        const text = extractPartText(zip, partName);
+        const brackets = [...text.matchAll(/\[([^\]]+)\]/g)].map((m) => m[1]);
+        if (brackets.length > 0) {
+            bracketsByPart.set(partName, new Set(brackets));
+            allBrackets.push(...brackets);
+        }
+    }
+    const unique = [...new Set(allBrackets)].sort();
+    const shortPlaceholders = [];
+    const longClauses = [];
+    for (const b of unique) {
+        if (b.length <= 80) {
+            shortPlaceholders.push(`[${b}]`);
+        }
+        else {
+            longClauses.push(`[${b.slice(0, 60)}...]`);
+        }
+    }
+    let underscoreBlankCount = 0;
+    for (const partName of partNames) {
+        const text = extractPartText(zip, partName);
+        const blanks = text.match(/_{3,}/g) ?? [];
+        underscoreBlankCount += blanks.length;
+    }
+    return {
+        partNames,
+        bracketsByPart,
+        unique,
+        shortPlaceholders,
+        longClauses,
+        footnoteCount: countFootnotes(zip),
+        underscoreBlankCount,
+    };
+}
+/**
+ * Scan a DOCX file and report all bracketed placeholders.
+ * Classifies them as short (fill-in fields) vs long (alternative clauses).
+ * Optionally outputs a draft replacements.json.
+ *
+ * Scans all general OOXML text parts (document, headers, footers, endnotes).
+ */
+export function runScan(args) {
+    if (!existsSync(args.input)) {
+        console.error(`File not found: ${args.input}`);
+        process.exit(1);
+    }
+    const scan = scanDocxBrackets(args.input);
+    const { partNames, bracketsByPart, shortPlaceholders, longClauses, footnoteCount, underscoreBlankCount, } = scan;
+    console.log(`\n=== Scan of ${args.input} ===`);
+    // Report parts scanned
+    const nonDocParts = partNames.filter((p) => p !== 'word/document.xml');
+    if (nonDocParts.length > 0) {
+        console.log(`Parts scanned: document.xml + ${nonDocParts.length} additional (${nonDocParts.join(', ')})`);
+    }
+    console.log(`\nShort placeholders (${shortPlaceholders.length}):`);
+    for (const p of shortPlaceholders) {
+        // Note which parts contain this placeholder (if outside document.xml)
+        const inner = p.slice(1, -1);
+        const locations = [];
+        for (const [partName, brackets] of bracketsByPart) {
+            if (partName !== 'word/document.xml' && brackets.has(inner)) {
+                locations.push(partName.replace('word/', ''));
+            }
+        }
+        const suffix = locations.length > 0 ? `  (also in: ${locations.join(', ')})` : '';
+        console.log(`  ${p}${suffix}`);
+    }
+    console.log(`\nLong clauses/alternatives (${longClauses.length}) — skipped by recipe:`);
+    for (const c of longClauses) {
+        console.log(`  ${c}`);
+    }
+    // Footnote count
+    console.log(`\nFootnotes: ${footnoteCount} explanatory footnote(s)`);
+    console.log(`Underscore blanks: ${underscoreBlankCount} occurrence(s)`);
+    // Output draft replacements.json
+    if (args.outputReplacements) {
+        const replacements = {};
+        for (const p of shortPlaceholders) {
+            const inner = p.slice(1, -1);
+            const tagName = inner
+                .toLowerCase()
+                .replace(/[^a-z0-9]+/g, '_')
+                .replace(/^_|_$/g, '');
+            replacements[p] = `{${tagName}}`;
+        }
+        writeFileSync(args.outputReplacements, JSON.stringify(replacements, null, 2) + '\n');
+        console.log(`\nDraft replacements written to: ${args.outputReplacements}`);
+    }
+    console.log('');
+}
+function extractPartText(zip, partName) {
+    const entry = zip.getEntry(partName);
+    if (!entry)
+        return '';
+    const xml = entry.getData().toString('utf-8');
+    const paragraphs = [];
+    const paraRegex = /<w:p[\s>][\s\S]*?<\/w:p>/g;
+    let paraMatch;
+    while ((paraMatch = paraRegex.exec(xml)) !== null) {
+        const paraXml = paraMatch[0];
+        const textParts = [];
+        const tRegex = /<w:t[^>]*>([^<]*)<\/w:t>/g;
+        let tMatch;
+        while ((tMatch = tRegex.exec(paraXml)) !== null) {
+            textParts.push(tMatch[1]);
+        }
+        if (textParts.length > 0) {
+            paragraphs.push(textParts.join(''));
+        }
+    }
+    return paragraphs.join('\n');
+}
+function countFootnotes(zip) {
+    const entry = zip.getEntry('word/footnotes.xml');
+    if (!entry)
+        return 0;
+    const xml = entry.getData().toString('utf-8');
+    const all = xml.match(/<w:footnote\s/g) ?? [];
+    const separators = xml.match(/w:type="(separator|continuationSeparator)"/g) ?? [];
+    return all.length - separators.length;
+}
+//# sourceMappingURL=scan.js.map

package/dist/commands/scan.js.map

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

package/dist/commands/validate.d.ts

@@ -0,0 +1,6 @@
+export interface ValidateArgs {
+    template?: string;
+    strict?: boolean;
+}
+export declare function runValidate(args: ValidateArgs): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAgCpD"}