@memoarchitect/tools 0.4.4

package/packages/tools/lib/import/column-mapper.d.ts

@@ -0,0 +1,35 @@
+import type { MEMOConfig } from '../model/config.js';
+import type { ImportRecipe, ColumnMapping } from './recipes.js';
+export type { ColumnMapping };
+/**
+ * Infer column mappings for a set of spreadsheet headers.
+ *
+ * Strategy:
+ * 1. If a `recipe` is provided, match each header against recipe.columnMappings
+ *    using case-insensitive exact match.
+ * 2. Fall back to a built-in heuristic for common column name patterns.
+ * 3. Unrecognised columns pass through as dynamic attributes (camelCase normalised).
+ *
+ * Returns one ColumnMapping per *input* header. `targetAttribute` is `null`
+ * (represented as empty string) for columns that should be skipped.
+ */
+export declare function inferColumnMappings(headers: string[], recipe?: ImportRecipe): ColumnMapping[];
+export interface MappedCsvResult {
+    /** Standard elements CSV text ready for parseElementsCsv() */
+    csv: string;
+    /** Headers that had no mapping and were skipped */
+    skippedColumns: string[];
+    /** Warnings about missing required mappings or value transforms */
+    warnings: string[];
+}
+/**
+ * Apply a set of column mappings to raw spreadsheet rows and produce a
+ * standard MEMO elements CSV string.
+ *
+ * @param rawRows    Rows from the source spreadsheet (header → cell value)
+ * @param mappings   Mappings returned by inferColumnMappings()
+ * @param config     Resolved MEMO config (used to auto-set kind if not mapped)
+ * @param defaultKind  Kind to use when no kind column is present
+ */
+export declare function applyColumnMappings(rawRows: Record<string, string>[], mappings: ColumnMapping[], config: MEMOConfig, defaultKind?: string): MappedCsvResult;
+//# sourceMappingURL=column-mapper.d.ts.map

package/packages/tools/lib/import/column-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-mapper.d.ts","sourceRoot":"","sources":["../../src/import/column-mapper.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEhE,YAAY,EAAE,aAAa,EAAE,CAAC;AAI9B;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,CAAC,EAAE,YAAY,GACtB,aAAa,EAAE,CAsBjB;AAqBD,MAAM,WAAW,eAAe;IAC5B,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EACjC,QAAQ,EAAE,aAAa,EAAE,EACzB,MAAM,EAAE,UAAU,EAClB,WAAW,CAAC,EAAE,MAAM,GACrB,eAAe,CAwEjB"}

package/packages/tools/lib/import/column-mapper.js

@@ -0,0 +1,171 @@
+// ─── Column-Mapping Assistant ─────────────────────────────────────────────────
+//
+// Infers column mappings from spreadsheet headers and applies them to produce
+// a standard MEMO elements CSV ready for parseElementsCsv().
+// ─────────────────────────────────────────────────────────────────────────────
+// ─── Inference ───────────────────────────────────────────────────────────────
+/**
+ * Infer column mappings for a set of spreadsheet headers.
+ *
+ * Strategy:
+ * 1. If a `recipe` is provided, match each header against recipe.columnMappings
+ *    using case-insensitive exact match.
+ * 2. Fall back to a built-in heuristic for common column name patterns.
+ * 3. Unrecognised columns pass through as dynamic attributes (camelCase normalised).
+ *
+ * Returns one ColumnMapping per *input* header. `targetAttribute` is `null`
+ * (represented as empty string) for columns that should be skipped.
+ */
+export function inferColumnMappings(headers, recipe) {
+    return headers.map((header) => {
+        const normalised = header.trim().toLowerCase();
+        // ── Recipe match ──────────────────────────────────────────────────────
+        if (recipe) {
+            const hit = recipe.columnMappings.find((m) => m.sourceColumn.toLowerCase() === normalised);
+            if (hit)
+                return { ...hit, sourceColumn: header };
+        }
+        // ── Heuristic fallback ────────────────────────────────────────────────
+        const heuristic = HEURISTIC_MAPPINGS.find((m) => m.sourceColumn.toLowerCase() === normalised);
+        if (heuristic)
+            return { ...heuristic, sourceColumn: header };
+        // ── Passthrough — normalise to camelCase attribute ────────────────────
+        const attr = toCamelCase(header);
+        return { sourceColumn: header, targetAttribute: attr };
+    });
+}
+/** Common column name → MEMO attribute heuristics (supplement to recipe matching) */
+const HEURISTIC_MAPPINGS = [
+    { sourceColumn: 'id', targetAttribute: 'id', transform: 'sanitize-id' },
+    { sourceColumn: 'identifier', targetAttribute: 'id', transform: 'sanitize-id' },
+    { sourceColumn: 'uid', targetAttribute: 'id', transform: 'sanitize-id' },
+    { sourceColumn: 'name', targetAttribute: 'name' },
+    { sourceColumn: 'title', targetAttribute: 'name' },
+    { sourceColumn: 'label', targetAttribute: 'name' },
+    { sourceColumn: 'description', targetAttribute: 'doc' },
+    { sourceColumn: 'text', targetAttribute: 'doc' },
+    { sourceColumn: 'notes', targetAttribute: 'doc' },
+    { sourceColumn: 'kind', targetAttribute: 'kind' },
+    { sourceColumn: 'type', targetAttribute: 'kind' },
+    { sourceColumn: 'category', targetAttribute: 'kind' },
+    { sourceColumn: 'construct', targetAttribute: 'construct' },
+];
+/**
+ * Apply a set of column mappings to raw spreadsheet rows and produce a
+ * standard MEMO elements CSV string.
+ *
+ * @param rawRows    Rows from the source spreadsheet (header → cell value)
+ * @param mappings   Mappings returned by inferColumnMappings()
+ * @param config     Resolved MEMO config (used to auto-set kind if not mapped)
+ * @param defaultKind  Kind to use when no kind column is present
+ */
+export function applyColumnMappings(rawRows, mappings, config, defaultKind) {
+    const warnings = [];
+    const skippedColumns = [];
+    // Collect unique target attributes to form the output header row
+    const targetAttrs = new Set();
+    const activeMap = [];
+    for (const m of mappings) {
+        if (!m.targetAttribute) {
+            skippedColumns.push(m.sourceColumn);
+            continue;
+        }
+        // Skip duplicate target (first mapping wins)
+        if (targetAttrs.has(m.targetAttribute))
+            continue;
+        targetAttrs.add(m.targetAttribute);
+        activeMap.push(m);
+    }
+    // Ensure required fixed columns are present
+    const hasId = targetAttrs.has('id');
+    const hasName = targetAttrs.has('name');
+    const hasKind = targetAttrs.has('kind');
+    if (!hasId)
+        warnings.push("No column mapped to 'id' — id will be auto-generated from row number");
+    if (!hasName)
+        warnings.push("No column mapped to 'name'");
+    if (!hasKind && !defaultKind)
+        warnings.push("No column mapped to 'kind' and no defaultKind set");
+    // Build output column order: fixed cols first, then dynamic attrs
+    const FIXED = ['id', 'name', 'kind', 'construct', 'doc'];
+    const dynamicTargets = Array.from(targetAttrs).filter((t) => !FIXED.includes(t));
+    const outputHeaders = [
+        ...FIXED.filter((f) => targetAttrs.has(f)),
+        ...dynamicTargets,
+    ];
+    // Ensure 'id', 'name', 'kind' are always present
+    for (const req of ['id', 'name', 'kind']) {
+        if (!outputHeaders.includes(req))
+            outputHeaders.unshift(req);
+    }
+    const lines = [outputHeaders.map(escapeCsv).join(',')];
+    rawRows.forEach((row, rowIdx) => {
+        const out = {};
+        // Apply mappings
+        for (const m of activeMap) {
+            const raw = row[m.sourceColumn] ?? '';
+            out[m.targetAttribute] = applyTransform(raw, m.transform);
+        }
+        // Auto-generate id if missing
+        if (!out['id'] || out['id'].trim() === '') {
+            out['id'] = `row_${rowIdx + 1}`;
+        }
+        // Apply defaultKind if kind not mapped or empty
+        if ((!out['kind'] || out['kind'].trim() === '') && defaultKind) {
+            out['kind'] = defaultKind;
+        }
+        // Validate kind against config kinds (warn but keep)
+        const kind = out['kind'];
+        if (kind && config.kinds && !config.kinds[kind]) {
+            warnings.push(`Row ${rowIdx + 2}: unknown kind '${kind}' (not in config)`);
+        }
+        const rowValues = outputHeaders.map((h) => escapeCsv(out[h] ?? ''));
+        lines.push(rowValues.join(','));
+    });
+    return { csv: lines.join('\n') + '\n', skippedColumns, warnings };
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function applyTransform(value, transform) {
+    if (!transform)
+        return value;
+    switch (transform) {
+        case 'sanitize-id': return sanitizeId(value);
+        case 'upper': return value.toUpperCase();
+        case 'lower': return value.toLowerCase();
+        default: return value;
+    }
+}
+/**
+ * Sanitize a raw cell value into a valid SysML identifier.
+ * - Strips leading/trailing whitespace
+ * - Replaces spaces and hyphens with underscores
+ * - Removes remaining non-identifier characters
+ * - Prepends 'e_' if the result starts with a digit
+ * - Lowercases the result
+ */
+function sanitizeId(raw) {
+    let s = raw.trim()
+        .replace(/[\s\-]+/g, '_')
+        .replace(/[^a-zA-Z0-9_]/g, '')
+        .toLowerCase();
+    if (/^\d/.test(s))
+        s = 'e_' + s;
+    return s;
+}
+/** Convert a string to camelCase for use as an attribute name */
+function toCamelCase(s) {
+    return s
+        .trim()
+        .replace(/[^a-zA-Z0-9 _-]/g, '')
+        .split(/[\s_-]+/)
+        .map((word, i) => i === 0 ? word.toLowerCase() : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join('');
+}
+/** Minimal CSV field escaping */
+function escapeCsv(value) {
+    if (value.includes(',') || value.includes('"') || value.includes('\n')) {
+        return `"${value.replace(/"/g, '""')}"`;
+    }
+    return value;
+}
+//# sourceMappingURL=column-mapper.js.map

package/packages/tools/lib/import/column-mapper.js.map

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

package/packages/tools/lib/import/import-diff.d.ts

@@ -0,0 +1,49 @@
+import type { MemoModel, MemoElement } from '../model/semantic.js';
+import type { CsvElement } from '../serializer/csv-io.js';
+/** One field that changed between the existing element and the incoming CSV row */
+export interface FieldChange {
+    field: string;
+    currentValue: string;
+    incomingValue: string;
+}
+/** An element that already exists in the model but has incoming changes */
+export interface ModifiedElement {
+    current: MemoElement;
+    incoming: CsvElement;
+    changes: FieldChange[];
+}
+/**
+ * Structured diff between the current model and an incoming CSV batch.
+ *
+ * - `added`     — elements in the CSV that don't exist in the model yet
+ * - `modified`  — elements that exist in both but have field differences
+ * - `unchanged` — element IDs present in both with no differences
+ * - `removed`   — element IDs in the model that are NOT in the incoming CSV
+ *                 (only populated if `detectRemovals` was true — callers opt in
+ *                 because removal detection requires knowing the CSV represents
+ *                 the full population, not a partial update)
+ */
+export interface ImportDiff {
+    added: CsvElement[];
+    modified: ModifiedElement[];
+    unchanged: string[];
+    removed: string[];
+    /** Total count of incoming rows */
+    incomingCount: number;
+    /** Total count of current model elements */
+    currentCount: number;
+}
+/**
+ * Compute the diff between the current model and an incoming batch of elements.
+ *
+ * @param model           Current MEMO model (from the builder)
+ * @param incoming        Parsed elements from the incoming CSV
+ * @param detectRemovals  If true, elements in the model that are missing from
+ *                        the incoming batch are listed in `removed`. Only set
+ *                        this to true when the CSV represents a full replacement
+ *                        of the population, not a partial update.
+ */
+export declare function computeImportDiff(model: MemoModel, incoming: CsvElement[], detectRemovals?: boolean): ImportDiff;
+/** Summarise an ImportDiff to a one-line string */
+export declare function formatDiffSummary(diff: ImportDiff): string;
+//# sourceMappingURL=import-diff.d.ts.map

package/packages/tools/lib/import/import-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-diff.d.ts","sourceRoot":"","sources":["../../src/import/import-diff.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAI1D,mFAAmF;AACnF,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,UAAU,CAAC;IACrB,OAAO,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;CACxB;AAID;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,UAAU,EAAE,EACtB,cAAc,UAAQ,GACvB,UAAU,CAuCZ;AAyCD,mDAAmD;AACnD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAO1D"}

package/packages/tools/lib/import/import-diff.js

@@ -0,0 +1,102 @@
+// ─── Re-import Diff ───────────────────────────────────────────────────────────
+//
+// Computes a structured diff between the current model state and a batch of
+// incoming CSV elements, enabling "update without replacement" workflows.
+// Users can see what changed, what is new, and what was removed before
+// committing to the import.
+// ─────────────────────────────────────────────────────────────────────────────
+// ─── computeImportDiff ───────────────────────────────────────────────────────
+/**
+ * Compute the diff between the current model and an incoming batch of elements.
+ *
+ * @param model           Current MEMO model (from the builder)
+ * @param incoming        Parsed elements from the incoming CSV
+ * @param detectRemovals  If true, elements in the model that are missing from
+ *                        the incoming batch are listed in `removed`. Only set
+ *                        this to true when the CSV represents a full replacement
+ *                        of the population, not a partial update.
+ */
+export function computeImportDiff(model, incoming, detectRemovals = false) {
+    const added = [];
+    const modified = [];
+    const unchanged = [];
+    const removed = [];
+    const incomingById = new Map(incoming.map((el) => [el.id, el]));
+    for (const inEl of incoming) {
+        const existing = model.elements.get(inEl.id);
+        if (!existing) {
+            added.push(inEl);
+            continue;
+        }
+        const changes = diffElement(existing, inEl);
+        if (changes.length > 0) {
+            modified.push({ current: existing, incoming: inEl, changes });
+        }
+        else {
+            unchanged.push(inEl.id);
+        }
+    }
+    if (detectRemovals) {
+        for (const [id] of model.elements) {
+            if (!incomingById.has(id)) {
+                removed.push(id);
+            }
+        }
+    }
+    return {
+        added,
+        modified,
+        unchanged,
+        removed,
+        incomingCount: incoming.length,
+        currentCount: model.elements.size,
+    };
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+const PROVENANCE_PREFIX = '_import_';
+/** Compare a model element against an incoming CSV element, returning changed fields */
+function diffElement(current, incoming) {
+    const changes = [];
+    // Fixed fields
+    if (current.name !== incoming.name) {
+        changes.push({ field: 'name', currentValue: current.name, incomingValue: incoming.name });
+    }
+    if (current.kind !== incoming.kind) {
+        changes.push({ field: 'kind', currentValue: current.kind, incomingValue: incoming.kind });
+    }
+    if ((current.doc ?? '') !== (incoming.doc ?? '')) {
+        changes.push({ field: 'doc', currentValue: current.doc ?? '', incomingValue: incoming.doc ?? '' });
+    }
+    // Dynamic attributes (skip provenance fields — they always differ)
+    const allAttrKeys = new Set([
+        ...Object.keys(current.attributes),
+        ...Object.keys(incoming.attributes),
+    ]);
+    for (const key of allAttrKeys) {
+        if (key === 'name')
+            continue;
+        if (key.startsWith(PROVENANCE_PREFIX))
+            continue;
+        const cv = current.attributes[key] ?? '';
+        const iv = incoming.attributes[key] ?? '';
+        if (cv !== iv) {
+            changes.push({ field: key, currentValue: cv, incomingValue: iv });
+        }
+    }
+    return changes;
+}
+// ─── Formatting helpers (used by CLI display) ────────────────────────────────
+/** Summarise an ImportDiff to a one-line string */
+export function formatDiffSummary(diff) {
+    const parts = [];
+    if (diff.added.length > 0)
+        parts.push(`+${diff.added.length} added`);
+    if (diff.modified.length > 0)
+        parts.push(`~${diff.modified.length} modified`);
+    if (diff.unchanged.length > 0)
+        parts.push(`=${diff.unchanged.length} unchanged`);
+    if (diff.removed.length > 0)
+        parts.push(`-${diff.removed.length} removed`);
+    return parts.length > 0 ? parts.join(', ') : 'no changes';
+}
+//# sourceMappingURL=import-diff.js.map

package/packages/tools/lib/import/import-diff.js.map

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

package/packages/tools/lib/import/recipes.d.ts

@@ -0,0 +1,43 @@
+/** A single column mapping: source spreadsheet column → MEMO attribute */
+export interface ColumnMapping {
+    /** Column header in the source artifact (case-insensitive match) */
+    sourceColumn: string;
+    /**
+     * Target attribute name in the MEMO element CSV format.
+     * Special values: 'id', 'name', 'kind', 'doc' map to the fixed columns.
+     * Any other value becomes a dynamic attribute column.
+     */
+    targetAttribute: string;
+    /**
+     * Optional transform applied to the raw cell value before writing.
+     * - 'sanitize-id': strip non-identifier chars, lowercase, prepend letter if starts with digit
+     * - 'upper': UPPERCASE
+     * - 'lower': lowercase
+     */
+    transform?: 'sanitize-id' | 'upper' | 'lower';
+    /** Whether this mapping is required (import errors if column missing) */
+    required?: boolean;
+}
+/** A named, documented import recipe for a common artifact type */
+export interface ImportRecipe {
+    id: string;
+    name: string;
+    description: string;
+    /** Kind to assign when no kind column is present in the source */
+    defaultKind?: string;
+    /** Column mappings in priority order (first match wins for inference) */
+    columnMappings: ColumnMapping[];
+}
+/** Requirements matrix: ID, title, description, priority, category columns */
+export declare const RECIPE_REQUIREMENTS_MATRIX: ImportRecipe;
+/** Hazard log: hazard ID, description, severity, probability, risk level */
+export declare const RECIPE_HAZARD_LOG: ImportRecipe;
+/** FMEA worksheet: component, failure mode, effect, severity, occurrence, detection, RPN */
+export declare const RECIPE_FMEA_WORKSHEET: ImportRecipe;
+/** Verification table: requirement ID reference, test method, result, pass/fail */
+export declare const RECIPE_VERIFICATION_TABLE: ImportRecipe;
+/** All built-in recipes in display order */
+export declare const BUILTIN_RECIPES: ImportRecipe[];
+/** Look up a built-in recipe by id */
+export declare function findRecipe(id: string): ImportRecipe | undefined;
+//# sourceMappingURL=recipes.d.ts.map

package/packages/tools/lib/import/recipes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../../src/import/recipes.ts"],"names":[],"mappings":"AAQA,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC1B,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,aAAa,GAAG,OAAO,GAAG,OAAO,CAAC;IAC9C,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,mEAAmE;AACnE,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,cAAc,EAAE,aAAa,EAAE,CAAC;CACnC;AAID,8EAA8E;AAC9E,eAAO,MAAM,0BAA0B,EAAE,YA2BxC,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,EAAE,YAyB/B,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,qBAAqB,EAAE,YA6BnC,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,yBAAyB,EAAE,YA0BvC,CAAC;AAEF,4CAA4C;AAC5C,eAAO,MAAM,eAAe,EAAE,YAAY,EAKzC,CAAC;AAEF,sCAAsC;AACtC,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE/D"}

package/packages/tools/lib/import/recipes.js

@@ -0,0 +1,133 @@
+// ─── Named Import Recipes ─────────────────────────────────────────────────────
+//
+// Predefined column-mapping configurations for common medical device artifact
+// types. Users pick a recipe instead of configuring column mappings from scratch.
+// ─────────────────────────────────────────────────────────────────────────────
+// ─── Built-in Recipes ────────────────────────────────────────────────────────
+/** Requirements matrix: ID, title, description, priority, category columns */
+export const RECIPE_REQUIREMENTS_MATRIX = {
+    id: 'requirements-matrix',
+    name: 'Requirements Matrix',
+    description: 'Standard requirements spreadsheet with ID, title, description, priority columns. Typical export from DOORS, Jama, or a simple Excel requirements log.',
+    defaultKind: 'Requirement',
+    columnMappings: [
+        { sourceColumn: 'req id', targetAttribute: 'id', transform: 'sanitize-id', required: true },
+        { sourceColumn: 'requirement id', targetAttribute: 'id', transform: 'sanitize-id', required: true },
+        { sourceColumn: 'id', targetAttribute: 'id', transform: 'sanitize-id', required: true },
+        { sourceColumn: 'req #', targetAttribute: 'id', transform: 'sanitize-id' },
+        { sourceColumn: 'number', targetAttribute: 'id', transform: 'sanitize-id' },
+        { sourceColumn: 'title', targetAttribute: 'name', required: true },
+        { sourceColumn: 'requirement title', targetAttribute: 'name', required: true },
+        { sourceColumn: 'name', targetAttribute: 'name', required: true },
+        { sourceColumn: 'summary', targetAttribute: 'name' },
+        { sourceColumn: 'description', targetAttribute: 'doc' },
+        { sourceColumn: 'text', targetAttribute: 'doc' },
+        { sourceColumn: 'statement', targetAttribute: 'doc' },
+        { sourceColumn: 'requirement text', targetAttribute: 'doc' },
+        { sourceColumn: 'kind', targetAttribute: 'kind' },
+        { sourceColumn: 'type', targetAttribute: 'kind' },
+        { sourceColumn: 'category', targetAttribute: 'category' },
+        { sourceColumn: 'priority', targetAttribute: 'priority' },
+        { sourceColumn: 'rationale', targetAttribute: 'rationale' },
+        { sourceColumn: 'verification method', targetAttribute: 'verificationMethod' },
+        { sourceColumn: 'status', targetAttribute: 'status' },
+    ],
+};
+/** Hazard log: hazard ID, description, severity, probability, risk level */
+export const RECIPE_HAZARD_LOG = {
+    id: 'hazard-log',
+    name: 'Hazard Log',
+    description: 'ISO 14971 hazard analysis spreadsheet with hazard ID, description, severity, probability and risk level columns.',
+    defaultKind: 'Hazard',
+    columnMappings: [
+        { sourceColumn: 'hazard id', targetAttribute: 'id', transform: 'sanitize-id', required: true },
+        { sourceColumn: 'haz id', targetAttribute: 'id', transform: 'sanitize-id' },
+        { sourceColumn: 'id', targetAttribute: 'id', transform: 'sanitize-id', required: true },
+        { sourceColumn: 'hazard', targetAttribute: 'name', required: true },
+        { sourceColumn: 'hazard description', targetAttribute: 'name', required: true },
+        { sourceColumn: 'name', targetAttribute: 'name', required: true },
+        { sourceColumn: 'description', targetAttribute: 'doc' },
+        { sourceColumn: 'hazardous situation', targetAttribute: 'doc' },
+        { sourceColumn: 'kind', targetAttribute: 'kind' },
+        { sourceColumn: 'severity', targetAttribute: 'severity' },
+        { sourceColumn: 'probability', targetAttribute: 'probability' },
+        { sourceColumn: 'risk level', targetAttribute: 'riskLevel' },
+        { sourceColumn: 'risk', targetAttribute: 'riskLevel' },
+        { sourceColumn: 'harm', targetAttribute: 'harm' },
+        { sourceColumn: 'foreseeable misuse', targetAttribute: 'foreseeableMisuse' },
+        { sourceColumn: 'mitigation', targetAttribute: 'mitigation' },
+        { sourceColumn: 'residual risk', targetAttribute: 'residualRisk' },
+        { sourceColumn: 'status', targetAttribute: 'status' },
+    ],
+};
+/** FMEA worksheet: component, failure mode, effect, severity, occurrence, detection, RPN */
+export const RECIPE_FMEA_WORKSHEET = {
+    id: 'fmea-worksheet',
+    name: 'FMEA Worksheet',
+    description: 'Failure Mode and Effects Analysis spreadsheet. Maps component failure modes to MEMO Failure kind with FMEA attributes (severity, occurrence, detection, RPN).',
+    defaultKind: 'Failure',
+    columnMappings: [
+        { sourceColumn: 'id', targetAttribute: 'id', transform: 'sanitize-id', required: true },
+        { sourceColumn: 'fmea id', targetAttribute: 'id', transform: 'sanitize-id' },
+        { sourceColumn: 'failure mode', targetAttribute: 'name', required: true },
+        { sourceColumn: 'failure mode description', targetAttribute: 'name' },
+        { sourceColumn: 'name', targetAttribute: 'name', required: true },
+        { sourceColumn: 'description', targetAttribute: 'doc' },
+        { sourceColumn: 'effect', targetAttribute: 'doc' },
+        { sourceColumn: 'effect of failure', targetAttribute: 'effect' },
+        { sourceColumn: 'kind', targetAttribute: 'kind' },
+        { sourceColumn: 'component', targetAttribute: 'component' },
+        { sourceColumn: 'function', targetAttribute: 'function' },
+        { sourceColumn: 'severity', targetAttribute: 'severity' },
+        { sourceColumn: 's', targetAttribute: 'severity' },
+        { sourceColumn: 'occurrence', targetAttribute: 'occurrence' },
+        { sourceColumn: 'o', targetAttribute: 'occurrence' },
+        { sourceColumn: 'detection', targetAttribute: 'detection' },
+        { sourceColumn: 'd', targetAttribute: 'detection' },
+        { sourceColumn: 'rpn', targetAttribute: 'rpn' },
+        { sourceColumn: 'risk priority number', targetAttribute: 'rpn' },
+        { sourceColumn: 'cause', targetAttribute: 'cause' },
+        { sourceColumn: 'controls', targetAttribute: 'controls' },
+        { sourceColumn: 'action', targetAttribute: 'action' },
+    ],
+};
+/** Verification table: requirement ID reference, test method, result, pass/fail */
+export const RECIPE_VERIFICATION_TABLE = {
+    id: 'verification-table',
+    name: 'Verification Table',
+    description: 'Verification and validation traceability matrix mapping requirements to test methods and results.',
+    defaultKind: 'VerificationTest',
+    columnMappings: [
+        { sourceColumn: 'test id', targetAttribute: 'id', transform: 'sanitize-id', required: true },
+        { sourceColumn: 'verification id', targetAttribute: 'id', transform: 'sanitize-id' },
+        { sourceColumn: 'id', targetAttribute: 'id', transform: 'sanitize-id', required: true },
+        { sourceColumn: 'test name', targetAttribute: 'name', required: true },
+        { sourceColumn: 'name', targetAttribute: 'name', required: true },
+        { sourceColumn: 'title', targetAttribute: 'name' },
+        { sourceColumn: 'description', targetAttribute: 'doc' },
+        { sourceColumn: 'objective', targetAttribute: 'doc' },
+        { sourceColumn: 'kind', targetAttribute: 'kind' },
+        { sourceColumn: 'requirement id', targetAttribute: 'requirementId' },
+        { sourceColumn: 'req id', targetAttribute: 'requirementId' },
+        { sourceColumn: 'method', targetAttribute: 'method' },
+        { sourceColumn: 'test method', targetAttribute: 'method' },
+        { sourceColumn: 'verification method', targetAttribute: 'method' },
+        { sourceColumn: 'result', targetAttribute: 'result' },
+        { sourceColumn: 'pass/fail', targetAttribute: 'result' },
+        { sourceColumn: 'status', targetAttribute: 'status' },
+        { sourceColumn: 'evidence', targetAttribute: 'evidence' },
+        { sourceColumn: 'notes', targetAttribute: 'notes' },
+    ],
+};
+/** All built-in recipes in display order */
+export const BUILTIN_RECIPES = [
+    RECIPE_REQUIREMENTS_MATRIX,
+    RECIPE_HAZARD_LOG,
+    RECIPE_FMEA_WORKSHEET,
+    RECIPE_VERIFICATION_TABLE,
+];
+/** Look up a built-in recipe by id */
+export function findRecipe(id) {
+    return BUILTIN_RECIPES.find((r) => r.id === id);
+}
+//# sourceMappingURL=recipes.js.map

package/packages/tools/lib/import/recipes.js.map

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