@memoarchitect/tools 0.4.4

package/packages/tools/lib/serializer/csv-io.js

@@ -0,0 +1,394 @@
+// ─── CSV Import/Export for MEMO Elements & Relationships ─────────────────────
+//
+// Standard CSV formats for bulk import/export of model data.
+// The element CSV schema is ontology-aware: kind determines the construct
+// and layer automatically, and dynamic columns map to SysML attributes.
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Attach provenance to a batch of CsvElements.
+ * `sourceRow` is auto-assigned (1-based index into the `elements` array).
+ * Call this after `parseElementsCsv()` when you want full traceability.
+ *
+ * @example
+ * const result = parseElementsCsv(csv, config);
+ * const withProvenance = attachProvenance(result.items, {
+ *   sourceFile: 'requirements-v3.xlsx',
+ *   importTimestamp: new Date().toISOString(),
+ *   importSessionId: crypto.randomUUID(),
+ * });
+ */
+export function attachProvenance(elements, meta) {
+    return elements.map((el, idx) => ({
+        ...el,
+        provenance: { ...meta, sourceRow: idx + 1 },
+    }));
+}
+// ─── Fixed column names ─────────────────────────────────────────────────────
+const ELEMENT_FIXED_COLS = ['id', 'name', 'kind', 'construct', 'doc'];
+const RELATIONSHIP_FIXED_COLS = ['sourceId', 'targetId', 'type', 'sourceEnd', 'targetEnd'];
+// ─── CSV Parsing Helpers ────────────────────────────────────────────────────
+/** Parse a CSV line respecting quoted fields (handles commas and newlines inside quotes) */
+function parseCsvLine(line) {
+    const fields = [];
+    let current = '';
+    let inQuotes = false;
+    for (let i = 0; i < line.length; i++) {
+        const ch = line[i];
+        if (inQuotes) {
+            if (ch === '"') {
+                if (i + 1 < line.length && line[i + 1] === '"') {
+                    current += '"';
+                    i++; // skip escaped quote
+                }
+                else {
+                    inQuotes = false;
+                }
+            }
+            else {
+                current += ch;
+            }
+        }
+        else {
+            if (ch === '"') {
+                inQuotes = true;
+            }
+            else if (ch === ',') {
+                fields.push(current.trim());
+                current = '';
+            }
+            else {
+                current += ch;
+            }
+        }
+    }
+    fields.push(current.trim());
+    return fields;
+}
+/** Escape a CSV field value (quote if it contains comma, quote, or newline) */
+function escapeCsvField(value) {
+    if (value.includes(',') || value.includes('"') || value.includes('\n')) {
+        return `"${value.replace(/"/g, '""')}"`;
+    }
+    return value;
+}
+/** Parse full CSV text into header + rows */
+function parseCsvText(csvText) {
+    const lines = csvText.split(/\r?\n/).filter((l) => l.trim() !== '');
+    if (lines.length === 0)
+        return { headers: [], rows: [] };
+    const headers = parseCsvLine(lines[0]);
+    const rows = lines.slice(1).map(parseCsvLine);
+    return { headers, rows };
+}
+// ─── Element CSV ────────────────────────────────────────────────────────────
+/**
+ * Parse an elements CSV file.
+ *
+ * **Standard CSV format for elements:**
+ * ```
+ * id,name,kind,construct,doc,[attr1],[attr2],...
+ * ```
+ *
+ * - `id` — unique element identifier (required, valid SysML identifier)
+ * - `name` — display name (required)
+ * - `kind` — ontology type from config.kinds (required, e.g. "Hazard", "Requirement")
+ * - `construct` — SysML construct override (optional, auto-derived from kind if omitted)
+ * - `doc` — documentation comment (optional)
+ * - Additional columns become `attribute redefines <colName> = "<value>"` in SysML
+ *
+ * The `kind` value is validated against the resolved config. If `construct` is omitted,
+ * it is derived from the kind's `sysmlConstruct` definition. The `layer` is always
+ * derived from the kind definition and cannot be set manually.
+ */
+export function parseElementsCsv(csvText, config) {
+    const { headers, rows } = parseCsvText(csvText);
+    const items = [];
+    const errors = [];
+    const warnings = [];
+    if (headers.length === 0) {
+        errors.push('CSV is empty — no header row found');
+        return { items, errors, warnings };
+    }
+    // Validate required columns
+    const missing = ['id', 'name', 'kind'].filter((c) => !headers.includes(c));
+    if (missing.length > 0) {
+        errors.push(`Missing required columns: ${missing.join(', ')}`);
+        return { items, errors, warnings };
+    }
+    // Identify dynamic attribute columns (anything not in fixed set)
+    const fixedSet = new Set(ELEMENT_FIXED_COLS);
+    const attrCols = headers.filter((h) => !fixedSet.has(h));
+    const seenIds = new Set();
+    for (let rowIdx = 0; rowIdx < rows.length; rowIdx++) {
+        const row = rows[rowIdx];
+        const lineNum = rowIdx + 2; // 1-indexed, +1 for header
+        // Build a field map
+        const fields = {};
+        for (let i = 0; i < headers.length; i++) {
+            fields[headers[i]] = row[i] ?? '';
+        }
+        const id = fields['id'];
+        const name = fields['name'];
+        const kind = fields['kind'];
+        const constructOverride = fields['construct'] || '';
+        const doc = fields['doc'] || '';
+        // Validate id
+        if (!id) {
+            errors.push(`Row ${lineNum}: missing required field 'id'`);
+            continue;
+        }
+        if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(id)) {
+            errors.push(`Row ${lineNum}: invalid id '${id}' — must be a valid SysML identifier (letters, digits, underscore, starting with letter or underscore)`);
+            continue;
+        }
+        if (seenIds.has(id)) {
+            errors.push(`Row ${lineNum}: duplicate id '${id}'`);
+            continue;
+        }
+        seenIds.add(id);
+        // Validate name
+        if (!name) {
+            errors.push(`Row ${lineNum}: missing required field 'name'`);
+            continue;
+        }
+        // Validate kind against config
+        if (!kind) {
+            errors.push(`Row ${lineNum}: missing required field 'kind'`);
+            continue;
+        }
+        const kinds = config.kinds ?? {};
+        const kindDef = kinds[kind];
+        if (!kindDef) {
+            const validKinds = Object.keys(kinds).sort();
+            errors.push(`Row ${lineNum}: unknown kind '${kind}'. Valid kinds: ${validKinds.join(', ')}`);
+            continue;
+        }
+        // Derive construct from kind (or use override)
+        let construct = constructOverride;
+        if (!construct) {
+            // Map sysmlConstruct (e.g. "part def") to usage construct (e.g. "part")
+            construct = sysmlConstructToUsage(kindDef.sysmlConstruct);
+        }
+        // Derive layer from kind
+        const layer = kindDef.layer || '';
+        if (!layer) {
+            warnings.push(`Row ${lineNum}: kind '${kind}' has no layer defined in config`);
+        }
+        // Collect dynamic attributes
+        const attributes = {};
+        for (const col of attrCols) {
+            const val = fields[col];
+            if (val) {
+                attributes[col] = val;
+            }
+        }
+        // Merge default attributes from kind definition (CSV values take precedence)
+        if (kindDef.defaultAttributes) {
+            for (const [key, val] of Object.entries(kindDef.defaultAttributes)) {
+                if (!(key in attributes)) {
+                    attributes[key] = val;
+                }
+            }
+        }
+        items.push({ id, name, kind, construct, layer, doc, attributes });
+    }
+    return { items, errors, warnings };
+}
+/**
+ * Export model elements to CSV.
+ *
+ * Produces a CSV with fixed columns (id, name, kind, construct, doc) plus
+ * dynamic attribute columns gathered from all elements in the model.
+ */
+export function exportElementsCsv(model, _config) {
+    const elements = Array.from(model.elements.values());
+    if (elements.length === 0)
+        return '';
+    // Collect all unique attribute keys across all elements
+    const attrKeysSet = new Set();
+    for (const el of elements) {
+        for (const key of Object.keys(el.attributes)) {
+            if (key !== 'name')
+                attrKeysSet.add(key); // 'name' is a fixed column
+        }
+    }
+    const attrKeys = Array.from(attrKeysSet).sort();
+    // Build header
+    const headers = [...ELEMENT_FIXED_COLS, ...attrKeys];
+    const lines = [headers.map(escapeCsvField).join(',')];
+    // Build rows
+    for (const el of elements) {
+        const row = [
+            el.id,
+            el.name,
+            el.kind,
+            el.construct,
+            el.doc || '',
+            ...attrKeys.map((k) => el.attributes[k] || ''),
+        ];
+        lines.push(row.map(escapeCsvField).join(','));
+    }
+    return lines.join('\n') + '\n';
+}
+// ─── Relationship CSV ───────────────────────────────────────────────────────
+/**
+ * Parse a relationships CSV file.
+ *
+ * **Standard CSV format for relationships:**
+ * ```
+ * sourceId,targetId,type,sourceEnd,targetEnd
+ * ```
+ *
+ * - `sourceId` — source element id (required, must exist in model or import batch)
+ * - `targetId` — target element id (required, must exist in model or import batch)
+ * - `type` — relationship type from config (required, e.g. "mitigates", "traceTo")
+ * - `sourceEnd` — connection end name (optional, default: "source")
+ * - `targetEnd` — connection end name (optional, default: "target")
+ */
+export function parseRelationshipsCsv(csvText, config, knownElementIds) {
+    const { headers, rows } = parseCsvText(csvText);
+    const items = [];
+    const errors = [];
+    const warnings = [];
+    if (headers.length === 0) {
+        errors.push('CSV is empty — no header row found');
+        return { items, errors, warnings };
+    }
+    // Validate required columns
+    const missing = ['sourceId', 'targetId', 'type'].filter((c) => !headers.includes(c));
+    if (missing.length > 0) {
+        errors.push(`Missing required columns: ${missing.join(', ')}`);
+        return { items, errors, warnings };
+    }
+    // Build valid relationship type set
+    const validRelTypes = new Set((config.relationshipTypes ?? []).map((r) => r.name));
+    for (let rowIdx = 0; rowIdx < rows.length; rowIdx++) {
+        const row = rows[rowIdx];
+        const lineNum = rowIdx + 2;
+        const fields = {};
+        for (let i = 0; i < headers.length; i++) {
+            fields[headers[i]] = row[i] ?? '';
+        }
+        const sourceId = fields['sourceId'];
+        const targetId = fields['targetId'];
+        const type = fields['type'];
+        const sourceEnd = fields['sourceEnd'] || 'source';
+        const targetEnd = fields['targetEnd'] || 'target';
+        if (!sourceId) {
+            errors.push(`Row ${lineNum}: missing required field 'sourceId'`);
+            continue;
+        }
+        if (!targetId) {
+            errors.push(`Row ${lineNum}: missing required field 'targetId'`);
+            continue;
+        }
+        if (!type) {
+            errors.push(`Row ${lineNum}: missing required field 'type'`);
+            continue;
+        }
+        // Validate relationship type
+        if (!validRelTypes.has(type)) {
+            const valid = Array.from(validRelTypes).sort();
+            errors.push(`Row ${lineNum}: unknown relationship type '${type}'. Valid types: ${valid.join(', ')}`);
+            continue;
+        }
+        // Validate element ids if known
+        if (knownElementIds) {
+            if (!knownElementIds.has(sourceId)) {
+                errors.push(`Row ${lineNum}: sourceId '${sourceId}' not found in model`);
+                continue;
+            }
+            if (!knownElementIds.has(targetId)) {
+                errors.push(`Row ${lineNum}: targetId '${targetId}' not found in model`);
+                continue;
+            }
+        }
+        if (sourceId === targetId) {
+            warnings.push(`Row ${lineNum}: self-referencing relationship (sourceId === targetId === '${sourceId}')`);
+        }
+        items.push({ sourceId, targetId, type, sourceEnd, targetEnd });
+    }
+    return { items, errors, warnings };
+}
+/**
+ * Export model relationships to CSV.
+ */
+export function exportRelationshipsCsv(model) {
+    if (model.relationships.length === 0)
+        return '';
+    const headers = [...RELATIONSHIP_FIXED_COLS];
+    const lines = [headers.map(escapeCsvField).join(',')];
+    for (const rel of model.relationships) {
+        const row = [rel.sourceId, rel.targetId, rel.type, rel.sourceEnd, rel.targetEnd];
+        lines.push(row.map(escapeCsvField).join(','));
+    }
+    return lines.join('\n') + '\n';
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+/** Map SysML construct definition to usage keyword */
+function sysmlConstructToUsage(sysmlConstruct) {
+    const map = {
+        'part def': 'part',
+        'item def': 'item',
+        'requirement def': 'requirement',
+        'action def': 'action',
+        'port def': 'port',
+        'interface def': 'interface',
+        'connection def': 'connection',
+        'attribute def': 'attribute',
+        'enum def': 'enum',
+    };
+    return map[sysmlConstruct] || 'part';
+}
+/**
+ * Generate a template CSV for elements based on the config's ontology kinds.
+ * Includes all valid kinds as example rows with their default attributes.
+ */
+export function generateElementTemplate(config) {
+    // Gather all default attribute keys across all kinds
+    const attrKeysSet = new Set();
+    for (const kindDef of Object.values(config.kinds ?? {})) {
+        if (kindDef.defaultAttributes) {
+            for (const key of Object.keys(kindDef.defaultAttributes)) {
+                attrKeysSet.add(key);
+            }
+        }
+    }
+    const attrKeys = Array.from(attrKeysSet).sort();
+    const headers = [...ELEMENT_FIXED_COLS, ...attrKeys];
+    const lines = [headers.map(escapeCsvField).join(',')];
+    // Add one example row per kind
+    for (const [kindKey, kindDef] of Object.entries(config.kinds ?? {})) {
+        const construct = sysmlConstructToUsage(kindDef.sysmlConstruct);
+        const row = [
+            `example_${kindKey.toLowerCase()}`, // id
+            `Example ${kindDef.label}`, // name
+            kindKey, // kind
+            construct, // construct
+            `A sample ${kindDef.label} element`, // doc
+            ...attrKeys.map((k) => kindDef.defaultAttributes?.[k] || ''),
+        ];
+        lines.push(row.map(escapeCsvField).join(','));
+    }
+    return lines.join('\n') + '\n';
+}
+/**
+ * Generate a template CSV for relationships based on config relationship types.
+ */
+export function generateRelationshipTemplate(config) {
+    const headers = [...RELATIONSHIP_FIXED_COLS];
+    const lines = [headers.map(escapeCsvField).join(',')];
+    // Add one example row per relationship type
+    for (const relType of (config.relationshipTypes ?? [])) {
+        const row = [
+            'source_element_id', // sourceId
+            'target_element_id', // targetId
+            relType.name, // type
+            'source', // sourceEnd
+            'target', // targetEnd
+        ];
+        lines.push(row.map(escapeCsvField).join(','));
+    }
+    return lines.join('\n') + '\n';
+}
+//# sourceMappingURL=csv-io.js.map

package/packages/tools/lib/serializer/csv-io.js.map

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

package/packages/tools/lib/serializer/sysml-generator.d.ts

@@ -0,0 +1,32 @@
+import type { CsvElement, CsvRelationship } from './csv-io.js';
+export declare function generateUsage(element: CsvElement): string;
+/**
+ * Generate a SysML connection usage for a relationship.
+ *
+ * Example output:
+ * ```sysml
+ * connection : Mitigates connect control ::> risk_control_001 to hazard ::> hazard_001;
+ * ```
+ */
+export declare function generateConnection(rel: CsvRelationship): string;
+/**
+ * Generate a complete .sysml file from elements and relationships.
+ *
+ * @param elements - Parsed elements from CSV
+ * @param relationships - Parsed relationships from CSV
+ * @param packageName - SysML package name (e.g. "imported_elements")
+ */
+/**
+ * Wrap already-indented inner package-body lines in `package` declarations.
+ *
+ * Standard SysML v2 requires single-identifier names in a package DECLARATION, so a
+ * qualified name (`a::b::c`) is emitted as NESTED packages, never `package a::b::c {`.
+ * The inner lines are assumed to already carry one indentation level (as the existing
+ * generators produce them); deeper nesting adds the extra levels. For a single-segment
+ * name this is byte-identical to the previous `package name { … }` output.
+ */
+export declare function wrapPackage(qualifiedName: string, innerLines: string[], opts?: {
+    isLibrary?: boolean;
+}): string[];
+export declare function generateFile(elements: CsvElement[], relationships: CsvRelationship[], packageName: string): string;
+//# sourceMappingURL=sysml-generator.d.ts.map

package/packages/tools/lib/serializer/sysml-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sysml-generator.d.ts","sourceRoot":"","sources":["../../src/serializer/sysml-generator.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAI/D,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAkCzD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAG/D;AAED;;;;;;GAMG;AACH;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,EAAE,CAajH;AAED,wBAAgB,YAAY,CACxB,QAAQ,EAAE,UAAU,EAAE,EACtB,aAAa,EAAE,eAAe,EAAE,EAChC,WAAW,EAAE,MAAM,GACpB,MAAM,CAgCR"}

package/packages/tools/lib/serializer/sysml-generator.js

@@ -0,0 +1,120 @@
+// ─── SysML v2 Text Generator ─────────────────────────────────────────────────
+//
+// Generates valid SysML v2 text from imported elements and relationships.
+// Used by CSV import to produce .sysml files that the parser can roundtrip.
+// ─────────────────────────────────────────────────────────────────────────────
+// Generate a SysML usage block for a single element.
+// Example: requirement hazard_001 : Hazard { doc /​* text *​/ attribute redefines name = "..."; }
+export function generateUsage(element) {
+    const lines = [];
+    const indent = '    ';
+    // Usage header: <construct> <id> : <kind> {
+    lines.push(`${element.construct} ${element.id} : ${element.kind} {`);
+    // Doc comment
+    if (element.doc) {
+        lines.push(`${indent}doc /* ${element.doc} */`);
+    }
+    // Name attribute (always emit if different from id)
+    if (element.name && element.name !== element.id) {
+        lines.push(`${indent}attribute redefines name = "${escapeString(element.name)}";`);
+    }
+    // Dynamic attributes
+    for (const [key, value] of Object.entries(element.attributes)) {
+        if (key === 'name')
+            continue; // already handled above
+        lines.push(`${indent}attribute redefines ${key} = "${escapeString(value)}";`);
+    }
+    // Provenance attributes (written as _import_* so they don't conflict with model attrs)
+    if (element.provenance) {
+        const p = element.provenance;
+        lines.push(`${indent}attribute redefines _import_source = "${escapeString(p.sourceFile)}";`);
+        lines.push(`${indent}attribute redefines _import_row = "${p.sourceRow}";`);
+        lines.push(`${indent}attribute redefines _import_timestamp = "${escapeString(p.importTimestamp)}";`);
+        lines.push(`${indent}attribute redefines _import_session = "${escapeString(p.importSessionId)}";`);
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+/**
+ * Generate a SysML connection usage for a relationship.
+ *
+ * Example output:
+ * ```sysml
+ * connection : Mitigates connect control ::> risk_control_001 to hazard ::> hazard_001;
+ * ```
+ */
+export function generateConnection(rel) {
+    const typeName = capitalizeFirst(rel.type);
+    return `connection : ${typeName} connect ${rel.sourceEnd} ::> ${rel.sourceId} to ${rel.targetEnd} ::> ${rel.targetId};`;
+}
+/**
+ * Generate a complete .sysml file from elements and relationships.
+ *
+ * @param elements - Parsed elements from CSV
+ * @param relationships - Parsed relationships from CSV
+ * @param packageName - SysML package name (e.g. "imported_elements")
+ */
+/**
+ * Wrap already-indented inner package-body lines in `package` declarations.
+ *
+ * Standard SysML v2 requires single-identifier names in a package DECLARATION, so a
+ * qualified name (`a::b::c`) is emitted as NESTED packages, never `package a::b::c {`.
+ * The inner lines are assumed to already carry one indentation level (as the existing
+ * generators produce them); deeper nesting adds the extra levels. For a single-segment
+ * name this is byte-identical to the previous `package name { … }` output.
+ */
+export function wrapPackage(qualifiedName, innerLines, opts) {
+    const segs = qualifiedName.split('::').filter(Boolean);
+    if (segs.length === 0)
+        return innerLines;
+    const out = [];
+    segs.forEach((seg, i) => {
+        const pad = '    '.repeat(i);
+        const lib = opts?.isLibrary && i === segs.length - 1 ? 'library ' : '';
+        out.push(`${pad}${lib}package ${seg} {`);
+    });
+    const extra = '    '.repeat(segs.length - 1); // innerLines already carry one level
+    for (const l of innerLines)
+        out.push(l.length ? `${extra}${l}` : l);
+    for (let i = segs.length - 1; i >= 0; i--)
+        out.push(`${'    '.repeat(i)}}`);
+    return out;
+}
+export function generateFile(elements, relationships, packageName) {
+    const body = [];
+    body.push('');
+    // Group elements by kind for readability
+    const byKind = new Map();
+    for (const el of elements) {
+        if (!byKind.has(el.kind))
+            byKind.set(el.kind, []);
+        byKind.get(el.kind).push(el);
+    }
+    for (const [kind, kindElements] of byKind) {
+        body.push(`    // ── ${kind} ──`);
+        for (const el of kindElements) {
+            const usageLines = generateUsage(el).split('\n');
+            for (const ul of usageLines) {
+                body.push(`    ${ul}`);
+            }
+            body.push('');
+        }
+    }
+    // Relationships
+    if (relationships.length > 0) {
+        body.push('    // ── Relationships ──');
+        for (const rel of relationships) {
+            body.push(`    ${generateConnection(rel)}`);
+        }
+        body.push('');
+    }
+    return wrapPackage(packageName, body).join('\n') + '\n';
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function escapeString(s) {
+    return s.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+function capitalizeFirst(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=sysml-generator.js.map

package/packages/tools/lib/serializer/sysml-generator.js.map

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

package/packages/tools/lib/server/config-resolver.d.ts

@@ -0,0 +1,14 @@
+import type { MEMOConfig } from '@memoarchitect/tools';
+export interface ConfigChainEntry {
+    configPath: string;
+    config: MEMOConfig;
+}
+/**
+ * Load and fully resolve a config file, following the extends chain.
+ */
+export declare function loadAndResolveConfig(configPath: string): MEMOConfig;
+/**
+ * Load the raw config chain in inheritance order: base parent first, leaf last.
+ */
+export declare function loadConfigChain(configPath: string): ConfigChainEntry[];
+//# sourceMappingURL=config-resolver.d.ts.map

package/packages/tools/lib/server/config-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-resolver.d.ts","sourceRoot":"","sources":["../../src/server/config-resolver.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGvD,MAAM,WAAW,gBAAgB;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAOnE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAEtE"}

package/packages/tools/lib/server/config-resolver.js

@@ -0,0 +1,54 @@
+// ─── Config Resolver ──────────────────────────────────────────────────────────
+//
+// Resolves the `extends` chain for MEMO configs.
+// Handles: "@memoarchitect/medical-modeling-profile" → find config in node_modules or workspace packages
+// Supports both new format (memo.package.yaml) and legacy (memo.config.yaml).
+// ─────────────────────────────────────────────────────────────────────────────
+import { resolve, dirname } from 'node:path';
+import { loadConfig, resolveConfig, resolvePackageConfig } from '@memoarchitect/tools';
+/**
+ * Load and fully resolve a config file, following the extends chain.
+ */
+export function loadAndResolveConfig(configPath) {
+    const config = loadConfig(configPath);
+    const projectDir = dirname(configPath);
+    return resolveConfig(config, (packageName) => {
+        return resolveParentConfig(packageName, projectDir);
+    });
+}
+/**
+ * Load the raw config chain in inheritance order: base parent first, leaf last.
+ */
+export function loadConfigChain(configPath) {
+    return loadConfigChainInternal(resolve(configPath), new Set());
+}
+/**
+ * Try to find and load a parent config by package name.
+ * Searches: node_modules, workspace packages, known paths.
+ */
+function resolveParentConfig(packageName, fromDir) {
+    const configPath = resolveParentConfigPath(packageName, fromDir);
+    return configPath ? loadConfig(configPath) : undefined;
+}
+function loadConfigChainInternal(configPath, seen) {
+    if (seen.has(configPath))
+        return [];
+    seen.add(configPath);
+    const config = loadConfig(configPath);
+    const chain = [];
+    if (config.extends) {
+        const extendsArr = Array.isArray(config.extends) ? config.extends : [config.extends];
+        for (const parentName of extendsArr) {
+            const parentPath = resolveParentConfigPath(parentName, dirname(configPath));
+            if (parentPath) {
+                chain.push(...loadConfigChainInternal(parentPath, seen));
+            }
+        }
+    }
+    chain.push({ configPath, config });
+    return chain;
+}
+function resolveParentConfigPath(packageName, fromDir) {
+    return resolvePackageConfig(packageName, fromDir);
+}
+//# sourceMappingURL=config-resolver.js.map