@memoarchitect/tools 0.4.4

package/packages/tools/lib/__tests__/csv-io.test.js

@@ -0,0 +1,317 @@
+import { describe, it, expect } from 'vitest';
+import { parseElementsCsv, parseRelationshipsCsv, exportElementsCsv, exportRelationshipsCsv, generateElementTemplate, generateRelationshipTemplate, } from '../serializer/csv-io.js';
+import { generateUsage, generateConnection, generateFile, wrapPackage } from '../serializer/sysml-generator.js';
+// ─── Test Config ────────────────────────────────────────────────────────────
+const testConfig = {
+    projectName: 'test',
+    projectType: 'device',
+    kinds: {
+        Hazard: {
+            label: 'Hazard',
+            layer: 'risk',
+            sysmlConstruct: 'requirement def',
+            defaultAttributes: { severity: 'Serious' },
+        },
+        SystemRequirement: {
+            label: 'System Requirement',
+            layer: 'requirements',
+            sysmlConstruct: 'requirement def',
+        },
+        Component: {
+            label: 'Component',
+            layer: 'logical',
+            sysmlConstruct: 'part def',
+        },
+        SystemFunction: {
+            label: 'System Function',
+            layer: 'functional',
+            sysmlConstruct: 'action def',
+        },
+    },
+    relationshipTypes: [
+        { name: 'mitigates', label: 'Mitigates', layer: 'risk', color: '#E74C3C' },
+        { name: 'traceTo', label: 'Trace To', layer: 'requirements', color: '#4A90D9' },
+        { name: 'allocateTo', label: 'Allocate To', layer: 'functional', color: '#E67E22' },
+    ],
+};
+// ─── Element CSV Parsing ────────────────────────────────────────────────────
+describe('parseElementsCsv', () => {
+    it('parses valid elements CSV', () => {
+        const csv = `id,name,kind,doc
+haz_001,Over-Infusion,Hazard,Excess medication delivery
+req_001,Flow Control,SystemRequirement,System shall control flow rate`;
+        const result = parseElementsCsv(csv, testConfig);
+        expect(result.errors).toHaveLength(0);
+        expect(result.items).toHaveLength(2);
+        expect(result.items[0]).toMatchObject({
+            id: 'haz_001',
+            name: 'Over-Infusion',
+            kind: 'Hazard',
+            construct: 'requirement',
+            layer: 'risk',
+            doc: 'Excess medication delivery',
+        });
+        // Default attributes from kind should be merged
+        expect(result.items[0].attributes).toHaveProperty('severity', 'Serious');
+        expect(result.items[1]).toMatchObject({
+            id: 'req_001',
+            kind: 'SystemRequirement',
+            construct: 'requirement',
+            layer: 'requirements',
+        });
+    });
+    it('handles dynamic attribute columns', () => {
+        const csv = `id,name,kind,severity,priority
+haz_001,Overflow,Hazard,Critical,High`;
+        const result = parseElementsCsv(csv, testConfig);
+        expect(result.errors).toHaveLength(0);
+        expect(result.items[0].attributes).toEqual({
+            severity: 'Critical', // overrides default
+            priority: 'High',
+        });
+    });
+    it('rejects unknown kinds', () => {
+        const csv = `id,name,kind
+bad_001,Bad Element,UnknownKind`;
+        const result = parseElementsCsv(csv, testConfig);
+        expect(result.errors).toHaveLength(1);
+        expect(result.errors[0]).toContain("unknown kind 'UnknownKind'");
+        expect(result.items).toHaveLength(0);
+    });
+    it('rejects invalid ids', () => {
+        const csv = `id,name,kind
+123invalid,Bad Id,Hazard`;
+        const result = parseElementsCsv(csv, testConfig);
+        expect(result.errors).toHaveLength(1);
+        expect(result.errors[0]).toContain("invalid id '123invalid'");
+    });
+    it('rejects duplicate ids', () => {
+        const csv = `id,name,kind
+haz_001,First,Hazard
+haz_001,Duplicate,Hazard`;
+        const result = parseElementsCsv(csv, testConfig);
+        expect(result.errors).toHaveLength(1);
+        expect(result.errors[0]).toContain("duplicate id 'haz_001'");
+    });
+    it('reports missing required columns', () => {
+        const csv = `name,kind
+Some Name,Hazard`;
+        const result = parseElementsCsv(csv, testConfig);
+        expect(result.errors).toHaveLength(1);
+        expect(result.errors[0]).toContain('Missing required columns: id');
+    });
+    it('handles construct override', () => {
+        const csv = `id,name,kind,construct
+comp_001,Motor,Component,part`;
+        const result = parseElementsCsv(csv, testConfig);
+        expect(result.items[0].construct).toBe('part');
+    });
+    it('handles quoted fields with commas', () => {
+        const csv = `id,name,kind,doc
+haz_001,"Over-Infusion, Serious",Hazard,"Excess medication, dangerous"`;
+        const result = parseElementsCsv(csv, testConfig);
+        expect(result.errors).toHaveLength(0);
+        expect(result.items[0].name).toBe('Over-Infusion, Serious');
+        expect(result.items[0].doc).toBe('Excess medication, dangerous');
+    });
+    it('handles empty CSV', () => {
+        const result = parseElementsCsv('', testConfig);
+        expect(result.errors).toHaveLength(1);
+        expect(result.errors[0]).toContain('empty');
+    });
+});
+// ─── Relationship CSV Parsing ───────────────────────────────────────────────
+describe('parseRelationshipsCsv', () => {
+    it('parses valid relationships CSV', () => {
+        const csv = `sourceId,targetId,type
+ctrl_001,haz_001,mitigates
+req_001,func_001,traceTo`;
+        const result = parseRelationshipsCsv(csv, testConfig);
+        expect(result.errors).toHaveLength(0);
+        expect(result.items).toHaveLength(2);
+        expect(result.items[0]).toMatchObject({
+            sourceId: 'ctrl_001',
+            targetId: 'haz_001',
+            type: 'mitigates',
+            sourceEnd: 'source',
+            targetEnd: 'target',
+        });
+    });
+    it('uses custom end names', () => {
+        const csv = `sourceId,targetId,type,sourceEnd,targetEnd
+ctrl_001,haz_001,mitigates,control,hazard`;
+        const result = parseRelationshipsCsv(csv, testConfig);
+        expect(result.items[0].sourceEnd).toBe('control');
+        expect(result.items[0].targetEnd).toBe('hazard');
+    });
+    it('rejects unknown relationship types', () => {
+        const csv = `sourceId,targetId,type
+a,b,unknownType`;
+        const result = parseRelationshipsCsv(csv, testConfig);
+        expect(result.errors).toHaveLength(1);
+        expect(result.errors[0]).toContain("unknown relationship type 'unknownType'");
+    });
+    it('validates element ids when provided', () => {
+        const knownIds = new Set(['haz_001']);
+        const csv = `sourceId,targetId,type
+ctrl_001,haz_001,mitigates`;
+        const result = parseRelationshipsCsv(csv, testConfig, knownIds);
+        expect(result.errors).toHaveLength(1);
+        expect(result.errors[0]).toContain("sourceId 'ctrl_001' not found");
+    });
+    it('warns on self-referencing relationships', () => {
+        const csv = `sourceId,targetId,type
+haz_001,haz_001,mitigates`;
+        const result = parseRelationshipsCsv(csv, testConfig);
+        expect(result.warnings).toHaveLength(1);
+        expect(result.warnings[0]).toContain('self-referencing');
+    });
+});
+// ─── Export ─────────────────────────────────────────────────────────────────
+describe('exportElementsCsv', () => {
+    it('exports elements with dynamic attribute columns', () => {
+        const model = createTestModel([
+            { id: 'haz_001', name: 'Overflow', kind: 'Hazard', construct: 'requirement', layer: 'risk', file: 'test.sysml', attributes: { severity: 'Critical' } },
+            { id: 'req_001', name: 'Flow', kind: 'SystemRequirement', construct: 'requirement', layer: 'requirements', file: 'test.sysml', attributes: { priority: 'High' } },
+        ]);
+        const csv = exportElementsCsv(model, testConfig);
+        const lines = csv.trim().split('\n');
+        expect(lines[0]).toContain('id,name,kind,construct,doc');
+        expect(lines[0]).toContain('priority');
+        expect(lines[0]).toContain('severity');
+        expect(lines).toHaveLength(3); // header + 2 rows
+    });
+});
+describe('exportRelationshipsCsv', () => {
+    it('exports relationships', () => {
+        const model = createTestModel([], [
+            { id: 'r1', sourceId: 'a', targetId: 'b', type: 'mitigates', sourceEnd: 'source', targetEnd: 'target', file: 'test.sysml' },
+        ]);
+        const csv = exportRelationshipsCsv(model);
+        const lines = csv.trim().split('\n');
+        expect(lines[0]).toBe('sourceId,targetId,type,sourceEnd,targetEnd');
+        expect(lines[1]).toBe('a,b,mitigates,source,target');
+    });
+});
+// ─── Templates ──────────────────────────────────────────────────────────────
+describe('generateElementTemplate', () => {
+    it('produces rows for each kind', () => {
+        const csv = generateElementTemplate(testConfig);
+        const lines = csv.trim().split('\n');
+        // header + 4 kinds
+        expect(lines).toHaveLength(5);
+        expect(lines[0]).toContain('id,name,kind,construct,doc');
+        expect(csv).toContain('Hazard');
+        expect(csv).toContain('SystemRequirement');
+    });
+});
+describe('generateRelationshipTemplate', () => {
+    it('produces rows for each relationship type', () => {
+        const csv = generateRelationshipTemplate(testConfig);
+        const lines = csv.trim().split('\n');
+        expect(lines).toHaveLength(4); // header + 3 types
+        expect(csv).toContain('mitigates');
+        expect(csv).toContain('traceTo');
+    });
+});
+// ─── SysML Generator ───────────────────────────────────────────────────────
+describe('wrapPackage (strict SysML v2 emit)', () => {
+    it('emits a single-segment name as one package block', () => {
+        const out = wrapPackage('imported_elements', ['    part p : T;']).join('\n');
+        expect(out).toBe('package imported_elements {\n    part p : T;\n}');
+    });
+    it('emits a qualified name as NESTED packages, never `package a::b {`', () => {
+        const out = wrapPackage('memo::imported::risk', ['    part p : T;']).join('\n');
+        expect(out).not.toMatch(/package\s+\w+::/);
+        expect(out).toContain('package memo {');
+        expect(out).toContain('    package imported {');
+        expect(out).toContain('        package risk {');
+        // inner line gets the extra nesting indentation (2 wrapper levels)
+        expect(out).toContain('            part p : T;');
+    });
+    it('generateFile never emits a qualified package declaration', () => {
+        const sysml = generateFile([{ id: 'h1', name: 'H', kind: 'Hazard', construct: 'requirement', layer: 'risk', doc: '', attributes: {} }], [], 'memo::imported::risk');
+        expect(sysml).not.toMatch(/package\s+\w+::/);
+        expect(sysml).toContain('package memo {');
+    });
+});
+describe('generateUsage', () => {
+    it('generates a SysML usage block', () => {
+        const sysml = generateUsage({
+            id: 'haz_001',
+            name: 'Over-Infusion',
+            kind: 'Hazard',
+            construct: 'requirement',
+            layer: 'risk',
+            doc: 'Excess medication delivery',
+            attributes: { severity: 'Serious' },
+        });
+        expect(sysml).toContain('requirement haz_001 : Hazard {');
+        expect(sysml).toContain('doc /* Excess medication delivery */');
+        expect(sysml).toContain('attribute redefines name = "Over-Infusion"');
+        expect(sysml).toContain('attribute redefines severity = "Serious"');
+        expect(sysml).toContain('}');
+    });
+});
+describe('generateConnection', () => {
+    it('generates a SysML connection', () => {
+        const sysml = generateConnection({
+            sourceId: 'ctrl_001',
+            targetId: 'haz_001',
+            type: 'mitigates',
+            sourceEnd: 'control',
+            targetEnd: 'hazard',
+        });
+        expect(sysml).toContain('connection : Mitigates');
+        expect(sysml).toContain('control ::> ctrl_001');
+        expect(sysml).toContain('hazard ::> haz_001');
+    });
+});
+describe('generateFile', () => {
+    it('generates a complete SysML file with package', () => {
+        const elements = [
+            { id: 'haz_001', name: 'Overflow', kind: 'Hazard', construct: 'requirement', layer: 'risk', doc: '', attributes: {} },
+        ];
+        const relationships = [
+            { sourceId: 'ctrl_001', targetId: 'haz_001', type: 'mitigates', sourceEnd: 'source', targetEnd: 'target' },
+        ];
+        const sysml = generateFile(elements, relationships, 'imported');
+        expect(sysml).toContain('package imported {');
+        expect(sysml).toContain('requirement haz_001 : Hazard {');
+        expect(sysml).toContain('connection : Mitigates');
+        expect(sysml).toContain('}');
+    });
+});
+// ─── Roundtrip ──────────────────────────────────────────────────────────────
+describe('CSV roundtrip', () => {
+    it('export → import produces equivalent elements', () => {
+        const original = createTestModel([
+            { id: 'haz_001', name: 'Overflow', kind: 'Hazard', construct: 'requirement', layer: 'risk', file: 'test.sysml', attributes: { severity: 'Critical' }, doc: 'Test doc' },
+            { id: 'comp_001', name: 'Motor', kind: 'Component', construct: 'part', layer: 'logical', file: 'test.sysml', attributes: {} },
+        ]);
+        const csv = exportElementsCsv(original, testConfig);
+        const parsed = parseElementsCsv(csv, testConfig);
+        expect(parsed.errors).toHaveLength(0);
+        expect(parsed.items).toHaveLength(2);
+        expect(parsed.items[0].id).toBe('haz_001');
+        expect(parsed.items[0].name).toBe('Overflow');
+        expect(parsed.items[0].kind).toBe('Hazard');
+        expect(parsed.items[0].doc).toBe('Test doc');
+        expect(parsed.items[0].attributes.severity).toBe('Critical');
+    });
+});
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function createTestModel(elements, relationships = []) {
+    const elemMap = new Map(elements.map((e) => [e.id, e]));
+    return {
+        elements: elemMap,
+        relationships,
+        errors: [],
+        elementsByKind: new Map(),
+        elementsByLayer: new Map(),
+        relationshipsByType: new Map(),
+        outgoing: new Map(),
+        incoming: new Map(),
+    };
+}
+//# sourceMappingURL=csv-io.test.js.map

package/packages/tools/lib/__tests__/csv-io.test.js.map

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

package/packages/tools/lib/__tests__/dhf-doc-store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dhf-doc-store.test.d.ts.map

package/packages/tools/lib/__tests__/dhf-doc-store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dhf-doc-store.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/dhf-doc-store.test.ts"],"names":[],"mappings":""}

package/packages/tools/lib/__tests__/dhf-doc-store.test.js

@@ -0,0 +1,94 @@
+// ─── DHF Document Store Tests ─────────────────────────────────────────────────
+//
+// File-backed persistence for DHF workbench documents (dhf/documents/*.md),
+// settings (.memo/dhf-settings.json), and repo template listing.
+// ─────────────────────────────────────────────────────────────────────────────
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, mkdirSync, writeFileSync, readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { loadDhfDocs, saveDhfDoc, deleteDhfDoc, loadDhfSettings, saveDhfSettings, listRepoTemplates, readRepoTemplate, } from '../server/dhf-doc-store.js';
+let root;
+beforeEach(() => { root = mkdtempSync(join(tmpdir(), 'memo-dhf-store-')); });
+afterEach(() => { rmSync(root, { recursive: true, force: true }); });
+const doc = (over = {}) => ({
+    id: 'DOC-UN-001',
+    title: 'User Needs',
+    group: 'Requirements',
+    templateId: '21cfr820/user-needs',
+    content: '---\nid: DOC-UN-001\ntitle: User Needs\n---\n\n# User Needs\n\nBody text.\n',
+    createdAt: 1700000000000,
+    authors: 'Jane Smith | Lead Engineer',
+    approvers: '',
+    ...over,
+});
+describe('DHF doc persistence', () => {
+    it('round-trips a document through save and load', () => {
+        saveDhfDoc(root, doc());
+        const loaded = loadDhfDocs(root);
+        expect(loaded).toHaveLength(1);
+        expect(loaded[0].id).toBe('DOC-UN-001');
+        expect(loaded[0].title).toBe('User Needs');
+        expect(loaded[0].group).toBe('Requirements');
+        expect(loaded[0].templateId).toBe('21cfr820/user-needs');
+        expect(loaded[0].createdAt).toBe(1700000000000);
+        expect(loaded[0].authors).toBe('Jane Smith | Lead Engineer');
+        expect(loaded[0].content).toContain('# User Needs');
+        expect(loaded[0].content).toContain('Body text.');
+    });
+    it('writes one markdown file per document under dhf/documents', () => {
+        saveDhfDoc(root, doc());
+        expect(existsSync(join(root, 'dhf', 'documents', 'DOC-UN-001.md'))).toBe(true);
+    });
+    it('preserves user-added frontmatter keys on save', () => {
+        saveDhfDoc(root, doc({
+            content: '---\nid: DOC-UN-001\nstatus: draft\ncustom_field: keep-me\n---\n\nBody\n',
+        }));
+        const raw = readFileSync(join(root, 'dhf', 'documents', 'DOC-UN-001.md'), 'utf8');
+        expect(raw).toContain('custom_field: keep-me');
+        expect(raw).toContain('status: draft');
+        expect(raw).toContain('group: Requirements');
+    });
+    it('deletes a document file', () => {
+        saveDhfDoc(root, doc());
+        expect(deleteDhfDoc(root, 'DOC-UN-001')).toBe(true);
+        expect(loadDhfDocs(root)).toHaveLength(0);
+        expect(deleteDhfDoc(root, 'DOC-UN-001')).toBe(false);
+    });
+    it('returns empty list when dhf/documents does not exist', () => {
+        expect(loadDhfDocs(root)).toEqual([]);
+    });
+});
+describe('DHF settings persistence', () => {
+    it('round-trips settings', () => {
+        expect(loadDhfSettings(root)).toBeNull();
+        saveDhfSettings(root, { company: 'Acme Medical', product: 'GPCA Pump' });
+        expect(loadDhfSettings(root)).toEqual({ company: 'Acme Medical', product: 'GPCA Pump' });
+    });
+});
+describe('repo template listing', () => {
+    it('lists markdown files with titles, skipping documents/exports and node_modules', () => {
+        mkdirSync(join(root, 'templates'), { recursive: true });
+        mkdirSync(join(root, 'dhf', 'documents'), { recursive: true });
+        mkdirSync(join(root, 'node_modules', 'pkg'), { recursive: true });
+        writeFileSync(join(root, 'templates', 'custom.md'), '---\ntitle: My Custom Template\n---\n\n# Ignored\n');
+        writeFileSync(join(root, 'templates', 'untitled.md'), 'no frontmatter\n\n# Heading Title\n');
+        writeFileSync(join(root, 'dhf', 'documents', 'DOC-X.md'), '# existing doc\n');
+        writeFileSync(join(root, 'node_modules', 'pkg', 'README.md'), '# dep readme\n');
+        const templates = listRepoTemplates(root);
+        const paths = templates.map(t => t.path);
+        expect(paths).toContain('templates/custom.md');
+        expect(paths).toContain('templates/untitled.md');
+        expect(paths).not.toContain('dhf/documents/DOC-X.md');
+        expect(paths.some(p => p.includes('node_modules'))).toBe(false);
+        expect(templates.find(t => t.path === 'templates/custom.md').title).toBe('My Custom Template');
+        expect(templates.find(t => t.path === 'templates/untitled.md').title).toBe('Heading Title');
+    });
+    it('reads a project-local template and rejects path escapes', () => {
+        writeFileSync(join(root, 'tpl.md'), '# T\n');
+        expect(readRepoTemplate(root, 'tpl.md')).toBe('# T\n');
+        expect(() => readRepoTemplate(root, '../outside.md')).toThrow();
+        expect(() => readRepoTemplate(root, 'missing.md')).toThrow();
+    });
+});
+//# sourceMappingURL=dhf-doc-store.test.js.map

package/packages/tools/lib/__tests__/dhf-doc-store.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dhf-doc-store.test.js","sourceRoot":"","sources":["../../src/__tests__/dhf-doc-store.test.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,EAAE;AACF,4EAA4E;AAC5E,iEAAiE;AACjE,gFAAgF;AAEhF,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClG,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EACH,WAAW,EAAE,UAAU,EAAE,YAAY,EACrC,eAAe,EAAE,eAAe,EAChC,iBAAiB,EAAE,gBAAgB,GACtC,MAAM,4BAA4B,CAAC;AAGpC,IAAI,IAAY,CAAC;AAEjB,UAAU,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7E,SAAS,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAErE,MAAM,GAAG,GAAG,CAAC,OAA2B,EAAE,EAAa,EAAE,CAAC,CAAC;IACvD,EAAE,EAAE,YAAY;IAChB,KAAK,EAAE,YAAY;IACnB,KAAK,EAAE,cAAc;IACrB,UAAU,EAAE,qBAAqB;IACjC,OAAO,EAAE,6EAA6E;IACtF,SAAS,EAAE,aAAa;IACxB,OAAO,EAAE,4BAA4B;IACrC,SAAS,EAAE,EAAE;IACb,GAAG,IAAI;CACV,CAAC,CAAC;AAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACpD,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QACxB,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACzD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACjE,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QACxB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACrD,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC;YACjB,OAAO,EAAE,0EAA0E;SACtF,CAAC,CAAC,CAAC;QACJ,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAC;QAClF,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QAC/C,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QAC/B,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QACxB,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QACzC,eAAe,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;QACzE,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,+EAA+E,EAAE,GAAG,EAAE;QACrF,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,oDAAoD,CAAC,CAAC;QAC1G,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,qCAAqC,CAAC,CAAC;QAC7F,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,kBAAkB,CAAC,CAAC;QAC9E,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,gBAAgB,CAAC,CAAC;QAEhF,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;QAC/C,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChE,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,qBAAqB,CAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAChG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,uBAAuB,CAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACjG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QAC/D,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;QAC7C,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvD,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAChE,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACjE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/packages/tools/lib/__tests__/dhf-template-resolver.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dhf-template-resolver.test.d.ts.map

package/packages/tools/lib/__tests__/dhf-template-resolver.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dhf-template-resolver.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/dhf-template-resolver.test.ts"],"names":[],"mappings":""}

package/packages/tools/lib/__tests__/dhf-template-resolver.test.js

@@ -0,0 +1,39 @@
+// ─── DHF Template Resolver Tests ─────────────────────────────────────────────
+//
+// Templates live in the ontology submodule (memo/src/compliance/dhf-templates);
+// the resolver must find them from the vendor tree and still honor an explicit
+// custom template directory first.
+// ─────────────────────────────────────────────────────────────────────────────
+import { describe, it, expect, beforeEach } from 'vitest';
+import { mkdtempSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { loadTemplate, resolveTemplatePath, listBuiltinTemplates, findVendorTemplatesDir, resetVendorTemplatesDirCache, } from '../dhf/template-resolver.js';
+beforeEach(() => resetVendorTemplatesDirCache());
+describe('vendor template resolution', () => {
+    it('finds the ontology dhf-templates directory', () => {
+        const dir = findVendorTemplatesDir();
+        expect(dir).toBeTruthy();
+        expect(dir).toContain('memo/src/compliance/dhf-templates');
+    });
+    it('loads a template by standard-prefixed id', () => {
+        const tpl = loadTemplate('iso-14971/rmp');
+        expect(tpl).toBeTruthy();
+        expect(tpl.frontmatter.title).toBe('Risk Management Plan');
+        expect(tpl.sourcePath).toContain('dhf-templates/iso-14971/rmp.md');
+    });
+    it('resolves shared snippets used by {{include}}', () => {
+        expect(resolveTemplatePath('shared/snippets/approval-block.md')).toBeTruthy();
+    });
+    it('lists the ontology template catalog', () => {
+        const all = listBuiltinTemplates();
+        expect(all.length).toBeGreaterThan(30);
+    });
+    it('prefers an explicit custom template directory', () => {
+        const custom = mkdtempSync(join(tmpdir(), 'memo-tpl-'));
+        writeFileSync(join(custom, 'rmp.md'), '---\ntitle: Custom RMP\n---\n\n# Custom\n');
+        const tpl = loadTemplate('rmp', custom);
+        expect(tpl.frontmatter.title).toBe('Custom RMP');
+    });
+});
+//# sourceMappingURL=dhf-template-resolver.test.js.map

package/packages/tools/lib/__tests__/dhf-template-resolver.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dhf-template-resolver.test.js","sourceRoot":"","sources":["../../src/__tests__/dhf-template-resolver.test.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,mCAAmC;AACnC,gFAAgF;AAEhF,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EACH,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EACvD,sBAAsB,EAAE,4BAA4B,GACvD,MAAM,6BAA6B,CAAC;AAErC,UAAU,CAAC,GAAG,EAAE,CAAC,4BAA4B,EAAE,CAAC,CAAC;AAEjD,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QAClD,MAAM,GAAG,GAAG,sBAAsB,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,mCAAmC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAChD,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC;QACzB,MAAM,CAAC,GAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC5D,MAAM,CAAC,GAAI,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,mBAAmB,CAAC,mCAAmC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC3C,MAAM,GAAG,GAAG,oBAAoB,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC;QACxD,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,2CAA2C,CAAC,CAAC;QACnF,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACxC,MAAM,CAAC,GAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/packages/tools/lib/__tests__/dhf.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dhf.test.d.ts.map

package/packages/tools/lib/__tests__/dhf.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dhf.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/dhf.test.ts"],"names":[],"mappings":""}