zone-ai-agent 0.4.0

package/dist/core/selfHealingLoop.js

@@ -0,0 +1,209 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSelfHealingLoop = runSelfHealingLoop;
+const node_path_1 = __importDefault(require("node:path"));
+const node_fs_1 = require("node:fs");
+function extractErrorContext(errorMessage) {
+    // TypeError: X is not a constructor
+    if (errorMessage.includes("is not a constructor")) {
+        const match = errorMessage.match(/(\w+)\.default is not a constructor/);
+        const className = match?.[1] ?? "Unknown";
+        return {
+            type: "EXPORT_ERROR",
+            description: `${className} is exported as an instance, not a class`,
+            hint: `Change "export default new ${className}()" to "export default ${className}"`,
+        };
+    }
+    // TypeError: X is not a function
+    if (errorMessage.includes("is not a function")) {
+        const match = errorMessage.match(/(\w+\.?\w+) is not a function/);
+        const fnName = match?.[1] ?? "unknown";
+        return {
+            type: "METHOD_ERROR",
+            description: `Method "${fnName}" does not exist`,
+            hint: `Check the method name in the page object — it may be named differently`,
+        };
+    }
+    // Cannot find module
+    if (errorMessage.includes("Cannot find module") ||
+        errorMessage.includes("Module not found")) {
+        const match = errorMessage.match(/['"]([^'"]+)['"]/);
+        const modulePath = match?.[1] ?? "unknown";
+        return {
+            type: "IMPORT_ERROR",
+            description: `Module not found: ${modulePath}`,
+            hint: `Check the import path — use relative paths like "../../support/pageObjects/LoginPage"`,
+        };
+    }
+    // Timed out
+    if (errorMessage.includes("Timed out") || errorMessage.includes("timeout")) {
+        return {
+            type: "TIMEOUT_ERROR",
+            description: "Page or element load timeout",
+            hint: `Use cy.visit("/") instead of absolute URLs when baseUrl is configured`,
+        };
+    }
+    // AssertionError
+    if (errorMessage.includes("AssertionError") ||
+        errorMessage.includes("expected") && errorMessage.includes("but got")) {
+        return {
+            type: "ASSERTION_ERROR",
+            description: "Test assertion failed",
+            hint: `Check the expected value — the actual value from the page may differ`,
+        };
+    }
+    return {
+        type: "UNKNOWN_ERROR",
+        description: errorMessage.slice(0, 200),
+        hint: "Review the error and fix the affected file",
+    };
+}
+function buildHealingPrompt(input) {
+    const relatedSection = input.relatedFiles.length > 0
+        ? input.relatedFiles
+            .map((f) => `FILE: ${f.path}\n\`\`\`\n${f.content}\n\`\`\``)
+            .join("\n\n")
+        : "(no related files)";
+    return `
+You are fixing a test automation error.
+
+ORIGINAL TASK
+${input.task}
+
+ERROR TYPE
+${input.errorContext.type}
+
+ERROR DESCRIPTION
+${input.errorContext.description}
+
+FIX HINT
+${input.errorContext.hint}
+
+FILE TO FIX
+${input.filePath}
+
+CURRENT FILE CONTENT
+\`\`\`
+${input.fileContent}
+\`\`\`
+
+RELATED FILES (for reference)
+${relatedSection}
+
+STRICT RULES
+1. Fix ONLY the specific error described above
+2. Do not change unrelated code
+3. For EXPORT_ERROR: change "export default new ClassName()" to "export default ClassName"
+4. For METHOD_ERROR: use ONLY method names that exist in the related files
+5. For IMPORT_ERROR: use correct relative import paths
+6. For TIMEOUT_ERROR: use cy.visit("/") not absolute URLs
+7. Return the COMPLETE fixed file content
+8. Return raw JSON only — no markdown
+
+OUTPUT FORMAT
+{
+  "filePath": "${input.filePath}",
+  "fullContent": "complete fixed file content",
+  "summary": "what was fixed",
+  "warnings": []
+}
+`.trim();
+}
+async function runSelfHealingLoop(input) {
+    const maxAttempts = input.maxAttempts ?? 3;
+    const attempts = [];
+    let currentError = input.errorMessage;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        console.log(`[zone:heal] Attempt ${attempt}/${maxAttempts} — analyzing error...`);
+        const errorContext = extractErrorContext(currentError);
+        console.log(`[zone:heal] Error type: ${errorContext.type}`);
+        console.log(`[zone:heal] Hint: ${errorContext.hint}`);
+        const filesChanged = [];
+        let anyFixed = false;
+        for (const affectedFile of input.affectedFiles) {
+            const absolutePath = node_path_1.default.resolve(input.repoPath, affectedFile.filePath);
+            // Read related files for context
+            const allFilesInDir = await getRelatedFiles(node_path_1.default.dirname(absolutePath), input.repoPath);
+            const prompt = buildHealingPrompt({
+                task: input.task,
+                errorContext,
+                filePath: affectedFile.filePath,
+                fileContent: affectedFile.fullContent,
+                relatedFiles: allFilesInDir,
+            });
+            try {
+                const { createOpenAIClient, getModelName } = await import("../llm/openaiClient.js");
+                const client = createOpenAIClient();
+                const model = getModelName();
+                const response = await client.responses.create({
+                    model,
+                    input: prompt,
+                });
+                const rawText = response.output_text || "";
+                const firstBrace = rawText.indexOf("{");
+                const lastBrace = rawText.lastIndexOf("}");
+                if (firstBrace < 0 || lastBrace < 0)
+                    continue;
+                const parsed = JSON.parse(rawText.slice(firstBrace, lastBrace + 1));
+                if (parsed.fullContent) {
+                    await node_fs_1.promises.mkdir(node_path_1.default.dirname(absolutePath), { recursive: true });
+                    await node_fs_1.promises.writeFile(absolutePath, parsed.fullContent, "utf8");
+                    filesChanged.push(affectedFile.filePath);
+                    anyFixed = true;
+                    console.log(`[zone:heal] Fixed: ${affectedFile.filePath} — ${parsed.summary}`);
+                }
+            }
+            catch (err) {
+                console.error(`[zone:heal] Failed to fix ${affectedFile.filePath}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        attempts.push({
+            attempt,
+            error: currentError,
+            fixed: anyFixed,
+            filesChanged,
+        });
+        if (anyFixed) {
+            return {
+                healed: true,
+                attempts,
+            };
+        }
+    }
+    return {
+        healed: false,
+        attempts,
+        finalError: currentError,
+    };
+}
+async function getRelatedFiles(dir, repoPath) {
+    try {
+        const entries = await node_fs_1.promises.readdir(dir, { withFileTypes: true });
+        const jsFiles = entries
+            .filter((e) => e.isFile() &&
+            (e.name.endsWith(".js") ||
+                e.name.endsWith(".ts") ||
+                e.name.endsWith(".java")))
+            .slice(0, 4);
+        const results = [];
+        for (const file of jsFiles) {
+            const absPath = node_path_1.default.join(dir, file.name);
+            const relPath = node_path_1.default.relative(repoPath, absPath).replace(/\\/g, "/");
+            try {
+                const content = await node_fs_1.promises.readFile(absPath, "utf8");
+                results.push({ path: relPath, content });
+            }
+            catch {
+                // skip unreadable files
+            }
+        }
+        return results;
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=selfHealingLoop.js.map

package/dist/core/selfHealingLoop.js.map

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

package/dist/core/taskIntentParser.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTaskIntent = parseTaskIntent;
+const UPDATE_WORDS = ["edit", "update", "modify", "change", "patch"];
+const DELETE_WORDS = ["delete", "remove"];
+const CREATE_WORDS = ["create", "add", "insert"];
+const READ_WORDS = ["get", "fetch", "show", "read", "list"];
+const COLLECTION_HINTS = ["all ", "list ", "many ", "multiple ", "bulk "];
+const NESTED_ITEM_WORDS = [
+    "item",
+    "entry",
+    "sub-item",
+    "sub item",
+    "nested",
+    "timeline item",
+    "timeline entry",
+    "comment item",
+    "line item",
+    "note",
+    "notes",
+    "attachment",
+    "attachments",
+    "comment",
+    "comments",
+    "stage",
+    "step"
+];
+const PARENT_RESOURCE_WORDS = [
+    "record",
+    "treatment",
+    "patient",
+    "appointment",
+    "lead",
+    "clinic",
+    "analysis"
+];
+const KNOWN_PARENT_RESOURCES = [
+    "treatment",
+    "patient",
+    "appointment",
+    "lead",
+    "clinic",
+    "analysis"
+];
+const KNOWN_NESTED_MAP = [
+    {
+        match: /\btimeline\b/i,
+        parent: "treatment",
+        nested: "timeline",
+        paramHints: ["treatmentId", "timelineId"],
+        routeHints: ["/treatments/:treatmentId/timeline/:timelineId"]
+    },
+    {
+        match: /\bnote(s)?\b/i,
+        parent: "patient",
+        nested: "notes",
+        paramHints: ["patientId", "noteId"],
+        routeHints: ["/patients/:patientId/notes/:noteId"]
+    },
+    {
+        match: /\battachment(s)?\b/i,
+        parent: "patient",
+        nested: "attachments",
+        paramHints: ["patientId", "attachmentId"],
+        routeHints: ["/patients/:patientId/attachments/:attachmentId"]
+    },
+    {
+        match: /\bcomment(s)?\b/i,
+        parent: "patient",
+        nested: "comments",
+        paramHints: ["patientId", "commentId"],
+        routeHints: ["/patients/:patientId/comments/:commentId"]
+    }
+];
+function normalizeTask(task) {
+    return task.trim().toLowerCase().replace(/\s+/g, " ");
+}
+function includesAny(text, words) {
+    return words.some((word) => text.includes(word));
+}
+function detectAction(task) {
+    if (includesAny(task, DELETE_WORDS))
+        return "delete";
+    if (includesAny(task, UPDATE_WORDS))
+        return "update";
+    if (includesAny(task, CREATE_WORDS))
+        return "create";
+    if (includesAny(task, READ_WORDS))
+        return "read";
+    return "unknown";
+}
+function detectParentResource(task) {
+    return KNOWN_PARENT_RESOURCES.find((resource) => task.includes(resource));
+}
+function detectScope(input) {
+    if (includesAny(input.normalizedTask, COLLECTION_HINTS)) {
+        return "collection";
+    }
+    if (input.mentionsNestedItem) {
+        return "single_item";
+    }
+    if (input.action === "read" && input.normalizedTask.includes("by id")) {
+        return "single_item";
+    }
+    if (input.action === "unknown") {
+        return "unknown";
+    }
+    return "parent_record";
+}
+function parseTaskIntent(rawTask) {
+    const normalizedTask = normalizeTask(rawTask);
+    const warnings = [];
+    const action = detectAction(normalizedTask);
+    const matchedNestedConfig = KNOWN_NESTED_MAP.find((item) => item.match.test(normalizedTask));
+    const mentionsNestedItem = !!matchedNestedConfig || includesAny(normalizedTask, NESTED_ITEM_WORDS);
+    const detectedParentResource = matchedNestedConfig?.parent ?? detectParentResource(normalizedTask);
+    const detectedNestedResource = matchedNestedConfig?.nested;
+    const resourceKind = mentionsNestedItem
+        ? "nested_resource"
+        : detectedParentResource
+            ? "parent_resource"
+            : includesAny(normalizedTask, PARENT_RESOURCE_WORDS)
+                ? "parent_resource"
+                : "unknown";
+    const scope = detectScope({
+        normalizedTask,
+        action,
+        mentionsNestedItem
+    });
+    const destructiveRisk = action === "delete" &&
+        (resourceKind === "nested_resource" || resourceKind === "parent_resource");
+    if (action === "unknown") {
+        warnings.push("Could not confidently determine CRUD action from task wording.");
+    }
+    if (!detectedParentResource && resourceKind !== "unknown") {
+        warnings.push("Resource kind was inferred, but parent resource could not be confidently identified.");
+    }
+    if (action === "delete") {
+        warnings.push("Delete action detected. Verify target scope carefully.");
+    }
+    if (resourceKind === "nested_resource") {
+        warnings.push("Nested resource detected. Parent resource should not be directly replaced.");
+    }
+    if (action === "update" && resourceKind === "nested_resource") {
+        warnings.push("Update should target the nested item only, not the whole parent record.");
+    }
+    if (scope === "collection" && action === "delete") {
+        warnings.push("Collection-level delete detected. Confirm that bulk deletion is intended.");
+    }
+    return {
+        rawTask,
+        normalizedTask,
+        action,
+        resourceKind,
+        scope,
+        parentResource: detectedParentResource,
+        nestedResource: detectedNestedResource,
+        mentionsNestedItem,
+        destructiveRisk,
+        routeHints: matchedNestedConfig?.routeHints ?? [],
+        paramHints: matchedNestedConfig?.paramHints ?? [],
+        warnings
+    };
+}
+//# sourceMappingURL=taskIntentParser.js.map

package/dist/core/taskIntentParser.js.map

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

package/dist/core/types/agentResult.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=agentResult.js.map

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

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

package/dist/core/types/risk.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=risk.js.map

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

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

package/dist/core/validatePatchAgainstSchema.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validatePatchAgainstSchema = validatePatchAgainstSchema;
+function extractTableNames(content) {
+    const matches = [...content.matchAll(/from\(["'`]([a-zA-Z0-9_]+)["'`]\)/g)];
+    return matches.map((match) => match[1]);
+}
+function extractEqColumns(content) {
+    const matches = [...content.matchAll(/\.eq\(["'`]([a-zA-Z0-9_]+)["'`]\s*,/g)];
+    return matches.map((match) => match[1]);
+}
+function extractSelectColumns(content) {
+    const matches = [...content.matchAll(/select\(["'`]([^"'`]+)["'`]\)/g)];
+    const rawColumns = matches.flatMap((match) => match[1]
+        .split(",")
+        .map((part) => part.trim())
+        .filter(Boolean));
+    return rawColumns
+        .map((col) => col.replace(/\s+/g, ""))
+        .filter((col) => col !== "*" && !col.includes("(") && !col.includes(")"));
+}
+function extractUpdateColumns(content) {
+    const matches = [...content.matchAll(/update\(\s*\{([\s\S]*?)\}\s*\)/g)];
+    const columns = [];
+    for (const match of matches) {
+        const objectBody = match[1];
+        const keyMatches = [...objectBody.matchAll(/([a-zA-Z0-9_]+)\s*:/g)];
+        for (const keyMatch of keyMatches) {
+            columns.push(keyMatch[1]);
+        }
+    }
+    return columns;
+}
+function buildSchemaIssue(input) {
+    return {
+        level: input.level,
+        code: input.code,
+        message: input.message,
+        filePath: input.filePath,
+        details: input.details,
+    };
+}
+function validatePatchAgainstSchema(patchItems, schema) {
+    const issues = [];
+    if (!schema) {
+        issues.push(buildSchemaIssue({
+            level: "warning",
+            code: "SCHEMA_SNAPSHOT_MISSING",
+            message: "No schema snapshot loaded. Schema-level patch validation skipped.",
+        }));
+        return issues;
+    }
+    const knownTables = new Set(schema.tables);
+    const columnsByTable = new Map();
+    for (const column of schema.columns) {
+        if (!columnsByTable.has(column.tableName)) {
+            columnsByTable.set(column.tableName, new Set());
+        }
+        columnsByTable.get(column.tableName)?.add(column.columnName);
+    }
+    for (const item of patchItems) {
+        const content = item.contentPreview ?? "";
+        const referencedTables = extractTableNames(content);
+        for (const tableName of referencedTables) {
+            if (!knownTables.has(tableName)) {
+                issues.push(buildSchemaIssue({
+                    level: "warning",
+                    code: "SCHEMA_PATH_NOT_FOUND",
+                    message: `Referenced table '${tableName}' not found in schema snapshot.`,
+                    filePath: item.path,
+                }));
+            }
+        }
+        if (referencedTables.length !== 1) {
+            continue;
+        }
+        const activeTable = referencedTables[0];
+        const knownColumns = columnsByTable.get(activeTable);
+        if (!knownColumns) {
+            continue;
+        }
+        const referencedColumns = [
+            ...extractEqColumns(content),
+            ...extractSelectColumns(content),
+            ...extractUpdateColumns(content),
+        ];
+        for (const columnName of referencedColumns) {
+            if (!knownColumns.has(columnName)) {
+                issues.push(buildSchemaIssue({
+                    level: "warning",
+                    code: "SCHEMA_FIELD_MISMATCH",
+                    message: `Referenced column '${activeTable}.${columnName}' not found in schema snapshot.`,
+                    filePath: item.path,
+                }));
+            }
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=validatePatchAgainstSchema.js.map

package/dist/core/validatePatchAgainstSchema.js.map

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

package/dist/core/validateSuggestedArchitecture.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateSuggestedArchitecture = validateSuggestedArchitecture;
+function validateSuggestedArchitecture(intent, suggestedFiles) {
+    const warnings = [];
+    const lowerFiles = suggestedFiles.map((f) => f.toLowerCase());
+    const hasRoute = lowerFiles.some((f) => f.includes("route"));
+    const hasController = lowerFiles.some((f) => f.includes("controller"));
+    const hasService = lowerFiles.some((f) => f.includes("service"));
+    const hasUi = lowerFiles.some((f) => f.includes("page") ||
+        f.includes("component") ||
+        f.includes("view"));
+    if (intent.action === "update" || intent.action === "delete") {
+        if (!hasRoute)
+            warnings.push("Mutation task suggested files are missing route layer.");
+        if (!hasController)
+            warnings.push("Mutation task suggested files are missing controller layer.");
+    }
+    if (intent.resourceKind === "nested_resource" && !hasService && !hasUi) {
+        warnings.push("Nested resource change may also require service/UI updates depending on stack.");
+    }
+    return { warnings };
+}
+//# sourceMappingURL=validateSuggestedArchitecture.js.map

package/dist/core/validateSuggestedArchitecture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateSuggestedArchitecture.js","sourceRoot":"","sources":["../../src/core/validateSuggestedArchitecture.ts"],"names":[],"mappings":";;AAMA,sEA2BC;AA3BD,SAAgB,6BAA6B,CAC3C,MAAkB,EAClB,cAAwB;IAExB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAE9D,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7D,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAC3B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAClB,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;QACvB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CACrB,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC7D,IAAI,CAAC,QAAQ;YAAE,QAAQ,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;QACvF,IAAI,CAAC,aAAa;YAAE,QAAQ,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;IACnG,CAAC;IAED,IAAI,MAAM,CAAC,YAAY,KAAK,iBAAiB,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;QACvE,QAAQ,CAAC,IAAI,CAAC,gFAAgF,CAAC,CAAC;IAClG,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC"}

package/dist/engine/buildDecisionExplanation.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDecisionExplanation = buildDecisionExplanation;
+const decisionReasonCodeMeta_js_1 = require("../core/decision/decisionReasonCodeMeta.js");
+// ---------------------------------------------------------------------------
+// Fallback constants — deterministic, documented, all string literals
+// ---------------------------------------------------------------------------
+/** Applied when the caller provides null, undefined, or an empty reasonCodes array. */
+const WHY_EMPTY_CODES = "No reason codes provided";
+/** Applied when every supplied code is unknown (not found in the metadata registry). */
+const WHY_NO_VALID_CODES = "No valid reason codes resolved";
+/** Fallback when a metadata entry exists but its severity field is missing or unrecognised. */
+const FALLBACK_SEVERITY = "info";
+/** Fallback when a metadata entry exists but its category field is missing or empty. */
+const FALLBACK_CATEGORY = "general";
+/** Fallback when a metadata entry exists but its summary field is missing or empty. */
+const FALLBACK_SUMMARY = "No summary available";
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Normalises raw metadata severity (the registry's "low" | "medium" | "high" scale)
+ * to the engine's three-level severity scale ("info" | "warning" | "critical").
+ *
+ * Missing or unrecognised severity → FALLBACK_SEVERITY ("info").
+ */
+function resolveReasonSeverity(raw) {
+    // Missing severity → default to "info" (documented fallback, no throw)
+    if (!raw)
+        return FALLBACK_SEVERITY;
+    switch (raw) {
+        case "high":
+            return "critical";
+        case "medium":
+            return "warning";
+        case "low":
+            return "info";
+        default:
+            // Unknown severity string → safe default, no throw
+            return FALLBACK_SEVERITY;
+    }
+}
+/**
+ * Builds the "why" summary string for a successful explanation (≥1 resolved reason).
+ * Lists the count and the code identifiers for full traceability.
+ */
+function buildWhyFromReasons(reasons) {
+    const count = reasons.length;
+    const codeList = reasons.map((r) => r.code).join(", ");
+    return `Decision backed by ${count} reason code(s): ${codeList}`;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Builds a deterministic, fully-populated DecisionExplanation from an array of
+ * reason codes.
+ *
+ * Edge-case guarantees — all silent (no throws, no console output):
+ *
+ *   • null / undefined reasonCodes  → treated as []
+ *   • empty reasonCodes             → { why: "No reason codes provided", reasons: [] }
+ *   • unknown code (not in registry)→ skipped silently; never throws
+ *   • all codes unknown             → { why: "No valid reason codes resolved", reasons: [] }
+ *   • missing severity in metadata  → defaults to "info"
+ *   • missing category in metadata  → defaults to "general"
+ *   • missing summary in metadata   → defaults to "No summary available"
+ *
+ * The output object is always complete: every field is a non-null, non-undefined
+ * string or array. The normal production path is completely unaffected by the
+ * fallback handling — it only activates on genuinely missing data.
+ *
+ * @param input   - Object containing the reasonCodes to resolve.
+ * @param options - Optional: metadata registry override for test injection.
+ * @returns A fully-populated DecisionExplanation.
+ */
+function buildDecisionExplanation(input, options = {}) {
+    // Normalise null / undefined → [] (silent, no throw)
+    const rawCodes = input.reasonCodes ?? [];
+    // Empty input → early return with documented fallback why
+    if (rawCodes.length === 0) {
+        return { why: WHY_EMPTY_CODES, reasons: [] };
+    }
+    // Resolve metadata source: injected override takes precedence over the default registry
+    const metaRegistry = options.metadata ??
+        decisionReasonCodeMeta_js_1.DECISION_REASON_CODE_META;
+    const reasons = [];
+    for (const code of rawCodes) {
+        // Unknown code — not present in registry → skip silently, do NOT throw
+        const meta = metaRegistry[code];
+        if (!meta)
+            continue;
+        const resolved = {
+            code,
+            // Missing severity → default to "info"
+            severity: resolveReasonSeverity(meta.severity),
+            // Missing category → default to "general"
+            category: typeof meta.category === "string" && meta.category.length > 0
+                ? meta.category
+                : FALLBACK_CATEGORY,
+            // Missing summary → default to "No summary available"
+            summary: typeof meta.summary === "string" && meta.summary.length > 0
+                ? meta.summary
+                : FALLBACK_SUMMARY,
+        };
+        reasons.push(resolved);
+    }
+    // Every supplied code was unknown → fallback why
+    if (reasons.length === 0) {
+        return { why: WHY_NO_VALID_CODES, reasons: [] };
+    }
+    return { why: buildWhyFromReasons(reasons), reasons };
+}
+//# sourceMappingURL=buildDecisionExplanation.js.map