@fhiron/sdk 0.1.0

package/src/_linter/i18n.js

@@ -0,0 +1,403 @@
+// Fhiron MCP — diccionario es/en para mensajes "marco" del connector.
+//
+// Filosofía: el español es el orgullo, el inglés es la cortesía. Default = es.
+//
+// Lo que SE traduce:
+//   - Mensajes "marco" del connector (resúmenes, errores de red, banner stderr,
+//     descripciones de tools y prompts, summaries de validación).
+//
+// Lo que NO se traduce automáticamente:
+//   - El campo `message` de cada LintIssue (lo emite el linter, siempre en es;
+//     hay un atajo `message_en` en el catálogo si es indispensable, pero por
+//     diseño el `message` se mantiene en español porque la regla CL Core ES
+//     chilena. Si lang=en, el connector envuelve el español con una nota
+//     "[ES] ..." para no inventar traducciones aproximadas).
+
+"use strict";
+
+const DICT = {
+  // ── Banner de arranque ────────────────────────────────────────────────────
+  "banner.ready": {
+    es: (v) => `[fhiron-mcp] v${v.version} listo · endpoint=${v.endpoint} · key=${v.keyState} · tools=${v.toolCount} · linter=@fhiron/linter@${v.linterVersion} · lang=${v.lang}`,
+    en: (v) => `[fhiron-mcp] v${v.version} ready · endpoint=${v.endpoint} · key=${v.keyState} · tools=${v.toolCount} · linter=@fhiron/linter@${v.linterVersion} · lang=${v.lang}`,
+  },
+  "banner.key.present": { es: "presente",                                                                                          en: "present" },
+  "banner.key.absent":  { es: "AUSENTE — pasa --key o define FHIRON_API_KEY",                                                       en: "MISSING — pass --key or set FHIRON_API_KEY" },
+
+  // ── serverInfo description ────────────────────────────────────────────────
+  "server.description": {
+    es: "Fhiron Bridge — validación FHIR contra CL Core v1.9.4 con errores en español, ejemplos válidos y catálogos terminológicos chilenos (DEIS, TFC, CIE-10).",
+    en: "Fhiron Bridge — FHIR validation against CL Core v1.9.4 with educational issue feedback, valid resource examples, and Chilean terminology catalogs (DEIS, TFC, ICD-10). Server messages are localized; rule explanations remain in Spanish (CL Core is a Chilean implementation guide).",
+  },
+
+  // ── Tool descriptions ─────────────────────────────────────────────────────
+  // Convención AI-friendly v0.5.0: cada description empieza con [TAG] + verbo
+  // + lista explícita de resourceTypes/casos cubiertos. Los modelos pequeños
+  // (Gemini Flash, Haiku, Llama-8B) hacen ranking por las primeras 80 chars
+  // y no exploran exhaustivamente las 7+ tools — la primera línea decide.
+  "tool.validate.desc": {
+    es: "[VALIDATE] Valida un recurso FHIR completo (Patient, Practitioner, Encounter, Observation, Condition, AllergyIntolerance, Procedure, Coverage, Organization, Immunization, DiagnosticReport, MedicationRequest, Medication, Bundle) contra CL Core v1.9.4. Corre el linter local primero (gratis) y luego HAPI server-side para slicing y terminología profunda (1 crédito por call). Cada issue incluye code, severity, path FHIRPath, message en español, why pedagógico, profileUrl, suggestion, example y quickFix cuando aplica. ESTA es la tool principal de validación — úsala siempre que tengas un recurso FHIR completo en JSON.",
+    en: "[VALIDATE] Validate a complete FHIR resource (Patient, Practitioner, Encounter, Observation, Condition, AllergyIntolerance, Procedure, Coverage, Organization, Immunization, DiagnosticReport, MedicationRequest, Medication, Bundle) against CL Core v1.9.4. Runs the local linter first (free) then HAPI server-side for deep slicing and terminology (1 credit per call). Each issue includes code, severity, FHIRPath, Spanish message, pedagogical why, profileUrl, suggestion, example and quickFix when applicable. THIS is the primary validation tool — use it whenever you have a complete FHIR resource as JSON.",
+  },
+  "tool.lint.desc": {
+    es: "[LINT] Linter local offline (gratis, no descuenta cuota) para recursos FHIR completos. Cubre Patient, Practitioner, Observation, Medication, MedicationRequest, Encounter, Condition, AllergyIntolerance, Procedure, Coverage, Organization, Immunization, DiagnosticReport, Bundle. Devuelve los códigos cl-* con quickFix mecánico aplicable. Llámala antes de fhiron_validate para auto-corregir lo obvio sin gastar cuota — y usa fhiron_validate solo cuando el lint pasa limpio.",
+    en: "[LINT] Offline local linter (free, no quota) for complete FHIR resources. Covers Patient, Practitioner, Observation, Medication, MedicationRequest, Encounter, Condition, AllergyIntolerance, Procedure, Coverage, Organization, Immunization, DiagnosticReport, Bundle. Returns cl-* codes with mechanical quickFix. Call it before fhiron_validate to auto-fix obvious issues without spending quota — then call fhiron_validate when lint is clean.",
+  },
+  "tool.validate_bundle.desc": {
+    es: "[VALIDATE] Valida un Bundle FHIR (transaction/batch/collection/document) ENTRY POR ENTRY contra HAPI, no como bundle entero. Devuelve una matriz pass/fail con conteo de errores por entry, agrupado por resourceType. Útil cuando un EHR exporta 50-500 recursos y necesitas saber cuáles fallan CL Core. Descuenta 1 crédito por cada entry validada en el servidor (las que pasan el linter local con errores se cortocircuitan sin gastar cuota).",
+    en: "[VALIDATE] Validate a FHIR Bundle (transaction/batch/collection/document) ENTRY BY ENTRY against HAPI, not as a single bundle. Returns a pass/fail matrix with error counts per entry, grouped by resourceType. Useful when an EHR exports 50-500 resources and you need to know which ones fail CL Core. Spends 1 credit per server-validated entry (entries with local errors short-circuit without using quota).",
+  },
+  "tool.validate_file.desc": {
+    es: "[VALIDATE] Lee un archivo .json del filesystem local del usuario y valida su contenido con la misma lógica que fhiron_validate (linter local + HAPI server). Acepta path absoluto o relativo. CRÍTICO usar esta tool cuando el usuario menciona un archivo (.json, .fhir.json) en vez de pegar el JSON inline — evita pedirle al usuario que pegue todo el contenido. Solo lee, nunca modifica el archivo.",
+    en: "[VALIDATE] Read a .json file from the user's local filesystem and validate its content with the same logic as fhiron_validate (local linter + HAPI server). Accepts absolute or relative path. CRITICAL: use this tool when the user mentions a file (.json, .fhir.json) instead of pasting JSON inline — avoids asking them to paste the whole content. Read-only, never modifies the file.",
+  },
+  "tool.compare_profiles.desc": {
+    es: "[VALIDATE] Valida el MISMO recurso contra dos perfiles en paralelo (FHIR R4 base vs CL Core) y devuelve el diff de errores. Útil para entender qué exige CL Core sobre FHIR R4 — los errores que aparecen solo en CL Core son las restricciones chilenas. Pedagógico para integradores que vienen de FHIR internacional. Soporta Patient, Practitioner, Encounter, Observation, Condition, MedicationRequest. Descuenta 2 créditos (una llamada por perfil).",
+    en: "[VALIDATE] Validate the SAME resource against two profiles in parallel (FHIR R4 base vs CL Core) and return the error diff. Useful to understand what CL Core requires beyond FHIR R4 — errors that appear only in CL Core are the Chilean constraints. Pedagogical for integrators coming from international FHIR. Supports Patient, Practitioner, Encounter, Observation, Condition, MedicationRequest. Spends 2 credits (one call per profile).",
+  },
+  "tool.score_endpoint.desc": {
+    es: "[SCAN] Escanea un FHIR endpoint público remoto (no requiere API key del endpoint, solo URL) y devuelve un FHIR Score: versión FHIR detectada, recursos soportados, perfiles declarados, terminologías referenciadas, score 0-100 con grade A-F y recomendaciones por dimensión. Útil cuando el usuario pregunta '¿qué tan FHIR es este servidor?' o '¿cumple CL Core?'. Lectura solamente, no consume cuota porque no llama al servidor de Fhiron.",
+    en: "[SCAN] Scan a remote public FHIR endpoint (no endpoint API key needed, just URL) and return a FHIR Score: detected FHIR version, supported resources, declared profiles, referenced terminologies, 0-100 score with A-F grade and per-dimension recommendations. Useful when the user asks 'how FHIR-compliant is this server?' or 'does it meet CL Core?'. Read-only, no quota consumed (does not call Fhiron's server).",
+  },
+  "tool.lint_run.desc": {
+    es: "[VALIDATE] Valida ÚNICAMENTE un string de RUN chileno aislado (no un recurso FHIR completo). Verifica formato y dígito verificador módulo 11. Para recursos FHIR completos usa fhiron_validate. Esta tool solo aplica cuando tienes un string como '12.345.678-5' suelto y necesitas saber si es válido como RUN, sin más contexto.",
+    en: "[VALIDATE] Validate ONLY an isolated Chilean RUN string (not a complete FHIR resource). Checks format and modulus 11 check digit. For complete FHIR resources use fhiron_validate. This tool only applies when you have a standalone string like '12.345.678-5' and want to know if it's a valid RUN, without further context.",
+  },
+  "tool.apply_fix.desc": {
+    es: "[FIX] Aplica un quickFix mecánico sobre un recurso FHIR usando RFC 6901 jsonPointer. Los quickFix vienen del arreglo `issues[]` de fhiron_validate o fhiron_lint. Devuelve el recurso parchado como JSON. Idempotente: aplicar el mismo fix dos veces produce el mismo resultado. Llama esta tool inmediatamente después de validar si el issue tiene `quickFix` — la IA puede auto-corregir sin pedirle al usuario.",
+    en: "[FIX] Apply a mechanical quickFix to a FHIR resource using RFC 6901 jsonPointer. QuickFixes come from the `issues[]` array of fhiron_validate or fhiron_lint. Returns the patched resource as JSON. Idempotent: applying the same fix twice yields the same result. Call this tool immediately after validating if the issue has `quickFix` — the AI can auto-correct without asking the user.",
+  },
+  "tool.get_example.desc": {
+    es: "[SCAFFOLD] Devuelve un recurso FHIR válido CL Core v1.9.4 listo para editar (Patient, Practitioner, Observation, Medication, MedicationRequest, Encounter, Condition, AllergyIntolerance, Procedure, Coverage, Organization, Immunization, DiagnosticReport, Bundle). Útil cuando la IA necesita scaffolding sin alucinar codes, systems o el formato del RUN. Llamá esta tool antes de armar un recurso desde cero.",
+    en: "[SCAFFOLD] Return a valid CL Core v1.9.4 FHIR resource ready to edit (Patient, Practitioner, Observation, Medication, MedicationRequest, Encounter, Condition, AllergyIntolerance, Procedure, Coverage, Organization, Immunization, DiagnosticReport, Bundle). Useful when the AI needs scaffolding without hallucinating codes, systems or RUN format. Call this tool before building a resource from scratch.",
+  },
+  "tool.search_terminology.desc": {
+    es: "[TERMINOLOGY] Busca códigos en catálogos terminológicos chilenos: comunas DEIS (system 'deis-comuna'), establecimientos DEIS ('deis-establecimiento'), ATC/TFC medicamentos ('tfc'), CIE-10 diagnósticos ('cie10'), CSTipoIdentificador ('identificadores'). Llama esta tool ANTES de inventar un código — la IA debe consultar, no adivinar.",
+    en: "[TERMINOLOGY] Search Chilean terminology catalogs: DEIS communes (system 'deis-comuna'), DEIS facilities ('deis-establecimiento'), ATC/TFC medications ('tfc'), ICD-10 diagnoses ('cie10'), CSTipoIdentificador ('identificadores'). Call this tool BEFORE inventing a code — the AI should look up, not guess.",
+  },
+  "tool.explain_code.desc": {
+    es: "[EXPLAIN] Devuelve la explicación pedagógica completa de un código de error (cl-run-01, cl-patient-04, hapi-error, mcp-quota-01, etc.): qué falla, por qué, qué perfil CL Core lo indica, link de docs, fix sugerido y ejemplo correcto. Llamá esta tool cuando el usuario pregunta '¿qué significa este error?' o '¿por qué falla?'.",
+    en: "[EXPLAIN] Return the full educational explanation of an error code (cl-run-01, cl-patient-04, hapi-error, mcp-quota-01, etc.): what fails, why, which CL Core profile flags it, docs link, suggested fix and valid example. Call this tool when the user asks 'what does this error mean?' or 'why is it failing?'.",
+  },
+
+  // ── Validación summaries ──────────────────────────────────────────────────
+  "validate.summary.ok": {
+    es: (v) => `✅ Conforme CL Core v1.9.4 · ${v.resourceType ?? "recurso"}`,
+    en: (v) => `✅ Compliant with CL Core v1.9.4 · ${v.resourceType ?? "resource"}`,
+  },
+  "validate.summary.fail": {
+    es: (v) => `❌ ${v.serverErrors} error(es) HAPI · ${v.localIssues} issue(s) local(es)`,
+    en: (v) => `❌ ${v.serverErrors} HAPI error(s) · ${v.localIssues} local issue(s)`,
+  },
+  "validate.local.errors_summary": {
+    es: (v) => `❌ ${v.errors} error(es) local(es) — quickFix disponible sin consumir cuota.`,
+    en: (v) => `❌ ${v.errors} local error(s) — quickFix available without consuming quota.`,
+  },
+  "validate.local.note_short_circuit": {
+    es: "Se detectaron errores locales antes de llamar al validador HAPI — no se consumió cuota. Aplica los quickFix y reinvoca.",
+    en: "Local errors detected before calling the HAPI validator — no quota consumed. Apply the quickFixes and re-invoke.",
+  },
+  "lint.summary.errors": {
+    es: (v) => `⚠️ ${v.errors} error(es) locales · ${v.warnings} advertencia(s)`,
+    en: (v) => `⚠️ ${v.errors} local error(s) · ${v.warnings} warning(s)`,
+  },
+  "lint.summary.warnings_only": {
+    es: (v) => `✅ Sin errores locales · ${v.warnings} advertencia(s)`,
+    en: (v) => `✅ No local errors · ${v.warnings} warning(s)`,
+  },
+  "lint.summary.clean": {
+    es: "✅ Sin issues locales — listo para $validate en servidor.",
+    en: "✅ No local issues — ready for server-side $validate.",
+  },
+
+  // ── RUN ───────────────────────────────────────────────────────────────────
+  "run.ok": {
+    es: (v) => `✅ RUN válido (${v.normalized}) · CL Core v1.9.4`,
+    en: (v) => `✅ Valid RUN (${v.normalized}) · CL Core v1.9.4`,
+  },
+  "run.ok.with_warning": {
+    es: (v) => `✅ RUN válido (${v.normalized}) · CL Core v1.9.4\n⚠️ ${v.warning}`,
+    en: (v) => `✅ Valid RUN (${v.normalized}) · CL Core v1.9.4\n⚠️ ${v.warning}`,
+  },
+  "run.warn.dots": {
+    es: "El RUN incluía puntos. CL Core (CorePacienteCl) los proscribe — formato esperado: 12345678-5. Se aceptó tras normalizar (cl-run-01).",
+    en: "The RUN contained dots. CL Core (CorePacienteCl) forbids them — expected format: 12345678-5. Accepted after normalization (cl-run-01).",
+  },
+  "run.empty": { es: "El RUN está vacío.", en: "The RUN is empty." },
+
+  // ── Errores de red / auth / quota ─────────────────────────────────────────
+  "err.api_key.missing": {
+    es: "Falta la API key. Pasa --key TU_API_KEY o define FHIRON_API_KEY. Obtén una gratis en https://fhiron.cl/registro.",
+    en: "Missing API key. Pass --key YOUR_API_KEY or set FHIRON_API_KEY. Get one for free at https://fhiron.cl/registro.",
+  },
+  "err.api_key.absent_short": { es: "API key ausente.", en: "API key missing." },
+  "err.resource_type.missing": {
+    es: "El recurso FHIR debe incluir el campo `resourceType` (por ejemplo 'Patient').",
+    en: "The FHIR resource must include a `resourceType` field (e.g. 'Patient').",
+  },
+  "err.resource_type.short": { es: "Falta resourceType.", en: "Missing resourceType." },
+  "err.timeout": {
+    es: "Fhiron Bridge tardó más de 10s en responder. Reintenta en un momento.",
+    en: "Fhiron Bridge took longer than 10s to respond. Please retry in a moment.",
+  },
+  "err.network": {
+    es: (v) => `No se pudo conectar a Fhiron Bridge (${v.endpoint}). Revisa tu conexión o el estado del servicio en status.fhiron.cl.`,
+    en: (v) => `Could not connect to Fhiron Bridge (${v.endpoint}). Check your connection or service status at status.fhiron.cl.`,
+  },
+  "err.auth": {
+    es: (v) => `API key rechazada (HTTP ${v.status}). Verifica el valor en https://fhiron.cl/dashboard/connect-ai.`,
+    en: (v) => `API key rejected (HTTP ${v.status}). Check the value at https://fhiron.cl/dashboard/connect-ai.`,
+  },
+  "err.quota.fallback": { es: "Se agotó la cuota mensual de validaciones.", en: "Monthly validation quota exhausted." },
+  "err.quota": {
+    es: (v) => `${v.detail} Mejora el plan en https://fhiron.cl/precios.`,
+    en: (v) => `${v.detail} Upgrade your plan at https://fhiron.cl/precios.`,
+  },
+  "err.server_500": {
+    es: "Fhiron Bridge tuvo un error interno. Intenta de nuevo en unos segundos.",
+    en: "Fhiron Bridge had an internal error. Please retry in a few seconds.",
+  },
+  "err.server_5xx": {
+    es: (v) => `Servicio temporalmente no disponible (HTTP ${v.status}). Reintenta en 1-2 minutos o revisa status.fhiron.cl.`,
+    en: (v) => `Service temporarily unavailable (HTTP ${v.status}). Retry in 1-2 minutes or check status.fhiron.cl.`,
+  },
+  "err.server_other": {
+    es: (v) => `Fhiron Bridge respondió ${v.status}: ${v.detail}`,
+    en: (v) => `Fhiron Bridge responded ${v.status}: ${v.detail}`,
+  },
+  "err.unknown_tool": {
+    es: (v) => `Herramienta desconocida: ${v.name}. Disponibles: ${v.list}.`,
+    en: (v) => `Unknown tool: ${v.name}. Available: ${v.list}.`,
+  },
+  "err.unknown_method": {
+    es: (v) => `Método no soportado: ${v.method}`,
+    en: (v) => `Unsupported method: ${v.method}`,
+  },
+  "err.quickfix.missing_pointer": {
+    es: "El argumento `fix.jsonPointer` es obligatorio.",
+    en: "The `fix.jsonPointer` argument is required.",
+  },
+  "ok.quickfix.applied": {
+    es: (v) => `✅ QuickFix aplicado en ${v.pointer}`,
+    en: (v) => `✅ QuickFix applied at ${v.pointer}`,
+  },
+
+  // ── v0.5.0 — summaries de tools nuevas ───────────────────────────────────
+  "validate_bundle.summary": {
+    es: (v) => `📦 Bundle validado entry-por-entry: ${v.passed}/${v.total} pasaron · ${v.failed} con errores · ${v.creditsUsed} crédito(s) consumido(s)`,
+    en: (v) => `📦 Bundle validated entry-by-entry: ${v.passed}/${v.total} passed · ${v.failed} with errors · ${v.creditsUsed} credit(s) used`,
+  },
+  "validate_bundle.empty": {
+    es: "El Bundle no tiene entries (o `entry` no es un array).",
+    en: "The Bundle has no entries (or `entry` is not an array).",
+  },
+  "validate_bundle.not_bundle": {
+    es: "Esta tool requiere un Bundle. Usa fhiron_validate para recursos individuales.",
+    en: "This tool requires a Bundle. Use fhiron_validate for individual resources.",
+  },
+  "validate_file.read_error": {
+    es: (v) => `No se pudo leer el archivo '${v.path}': ${v.reason}. Verifica que la ruta exista y tengas permisos de lectura.`,
+    en: (v) => `Could not read file '${v.path}': ${v.reason}. Check that the path exists and you have read permissions.`,
+  },
+  "validate_file.parse_error": {
+    es: (v) => `El archivo '${v.path}' no es JSON válido: ${v.reason}.`,
+    en: (v) => `File '${v.path}' is not valid JSON: ${v.reason}.`,
+  },
+  "validate_file.too_big": {
+    es: (v) => `El archivo '${v.path}' supera el límite de 5 MB (${v.size} bytes). Si es un Bundle grande, particionalo.`,
+    en: (v) => `File '${v.path}' exceeds the 5 MB limit (${v.size} bytes). If it's a large Bundle, partition it.`,
+  },
+  "validate_file.summary": {
+    es: (v) => `📄 ${v.path} — ${v.resourceType} ${v.valid ? "válido" : "inválido"} (${v.errorCount} error/es local/es${v.serverErrorCount != null ? `, ${v.serverErrorCount} server` : ""})`,
+    en: (v) => `📄 ${v.path} — ${v.resourceType} ${v.valid ? "valid" : "invalid"} (${v.errorCount} local error(s)${v.serverErrorCount != null ? `, ${v.serverErrorCount} server` : ""})`,
+  },
+  "compare_profiles.summary": {
+    es: (v) => `⚖️ R4 base: ${v.r4Errors} error(es) · CL Core: ${v.clErrors} error(es) · diff CL-only: ${v.clOnly} restricción(es) chilena(s)`,
+    en: (v) => `⚖️ R4 base: ${v.r4Errors} error(s) · CL Core: ${v.clErrors} error(s) · CL-only diff: ${v.clOnly} Chilean constraint(s)`,
+  },
+  "compare_profiles.unsupported": {
+    es: (v) => `Esta tool no soporta el perfil de '${v.resourceType}'. Soportados: Patient, Practitioner, Encounter, Observation, Condition, MedicationRequest.`,
+    en: (v) => `This tool does not support the profile for '${v.resourceType}'. Supported: Patient, Practitioner, Encounter, Observation, Condition, MedicationRequest.`,
+  },
+  "score_endpoint.summary": {
+    es: (v) => `🎯 ${v.url} — Score ${v.score}/100 (${v.grade}) · FHIR ${v.fhirVersion ?? "?"} · ${v.resources} recurso(s) · ${v.profiles} perfil(es) declarado(s)`,
+    en: (v) => `🎯 ${v.url} — Score ${v.score}/100 (${v.grade}) · FHIR ${v.fhirVersion ?? "?"} · ${v.resources} resource(s) · ${v.profiles} declared profile(s)`,
+  },
+  "score_endpoint.unreachable": {
+    es: (v) => `No se pudo conectar a ${v.url}/metadata: ${v.reason}.`,
+    en: (v) => `Could not connect to ${v.url}/metadata: ${v.reason}.`,
+  },
+  "score_endpoint.invalid_metadata": {
+    es: (v) => `El endpoint ${v.url} respondió pero no es un CapabilityStatement FHIR válido.`,
+    en: (v) => `Endpoint ${v.url} responded but did not return a valid FHIR CapabilityStatement.`,
+  },
+
+  // ── Logging notifications (M8) ────────────────────────────────────────────
+  "log.lint.start":  { es: (v) => `Linter local sobre ${v.resourceType}…`,                en: (v) => `Local linter on ${v.resourceType}…` },
+  "log.lint.done":   { es: (v) => `Linter local: ${v.errors} error(es), ${v.warnings} advertencia(s).`, en: (v) => `Local linter: ${v.errors} error(s), ${v.warnings} warning(s).` },
+  "log.bridge.call": { es: (v) => `Llamando a HAPI Bridge (${v.endpoint})…`,              en: (v) => `Calling HAPI Bridge (${v.endpoint})…` },
+  "log.bridge.done": { es: (v) => `Bridge respondió en ${v.ms}ms (status ${v.status}).`,  en: (v) => `Bridge responded in ${v.ms}ms (status ${v.status}).` },
+
+  // ── RUN — errores de validación (módulo 11) ───────────────────────────────
+  "run.err.no_dash": {
+    es: "El RUN debe incluir un guión separando el cuerpo del dígito verificador. Formato esperado: 12345678-5.",
+    en: "The RUN must include a dash (guión) separating the body from the check digit. Expected format: 12345678-5.",
+  },
+  "run.err.body_digits": {
+    es: "El cuerpo del RUN (antes del guion) debe contener solo dígitos.",
+    en: "The RUN body (before the dash) must contain digits only.",
+  },
+  "run.err.body_too_long": {
+    es: (v) => `El cuerpo del RUN tiene ${v.length} dígitos y excede el máximo de 8.`,
+    en: (v) => `The RUN body has ${v.length} digits, which exceeds the maximum of 8.`,
+  },
+  "run.err.format": {
+    es: "Formato de RUN inválido. Esperado: 1 a 8 dígitos, guion y dígito verificador (0-9 o K).",
+    en: "Invalid RUN format. Expected: 1 to 8 digits, a dash, and a check digit (0-9 or K).",
+  },
+  "run.err.dv": {
+    es: (v) => `Dígito verificador incorrecto: esperado '${v.expected}', recibido '${v.received}' (cálculo módulo 11).`,
+    en: (v) => `Incorrect check digit: expected '${v.expected}', got '${v.received}' (modulus 11 calculation).`,
+  },
+
+  // ── Parseo de entrada ─────────────────────────────────────────────────────
+  "parse.err.too_large": {
+    es: (v) => `El recurso supera el límite de ${v.limit} bytes para validación inline. Si es un Bundle grande, particiónalo o usa fhiron_validate_file.`,
+    en: (v) => `The resource exceeds the ${v.limit} byte limit for inline validation. If it's a large Bundle, partition it or use fhiron_validate_file.`,
+  },
+  "parse.err.json_invalid": {
+    es: (v) => `El JSON no es válido: ${v.detail}.`,
+    en: (v) => `The JSON is not valid: ${v.detail}.`,
+  },
+  "parse.err.invalid_input": {
+    es: "La entrada no es un objeto JSON ni un string JSON parseable.",
+    en: "The input is neither a JSON object nor a parseable JSON string.",
+  },
+
+  // ── FHIR Score — dimensiones y recomendaciones ────────────────────────────
+  "score.dim.fhir_ok": {
+    es: "FHIR R4 (4.0.1) detectado — la versión que usa CL Core.",
+    en: "FHIR R4 (4.0.1) detected — the version CL Core uses.",
+  },
+  "score.dim.no_supported_profile": {
+    es: "El endpoint no declara perfiles soportados en su CapabilityStatement.",
+    en: "The endpoint does not declare supported profiles in its CapabilityStatement.",
+  },
+  "score.dim.terms_detected": {
+    es: (v) => `Terminologías referenciadas: ${v.systems}.`,
+    en: (v) => `Referenced terminologies: ${v.systems}.`,
+  },
+  "score.dim.no_terms": {
+    es: "No se detectaron sistemas de terminología en el CapabilityStatement.",
+    en: "No terminology systems detected in the CapabilityStatement.",
+  },
+  "score.rec.migrate_r4": {
+    es: "Migra a FHIR R4 (4.0.1) — es la versión sobre la que se define CL Core.",
+    en: "Migrate to FHIR R4 (4.0.1) — it's the version CL Core is built on.",
+  },
+  "score.rec.missing_core": {
+    es: (v) => `Agrega soporte para recursos core ausentes: ${v.missing}.`,
+    en: (v) => `Add support for missing core resources: ${v.missing}.`,
+  },
+  "score.rec.declare_supported_profile": {
+    es: "Declara los perfiles que soportas en CapabilityStatement.rest.resource.supportedProfile.",
+    en: "Declare the profiles you support in CapabilityStatement.rest.resource.supportedProfile.",
+  },
+  "score.rec.support_interactions": {
+    es: "Amplía las interacciones REST soportadas (read, search, create) en los recursos clave.",
+    en: "Expand the supported REST interactions (read, search, create) on key resources.",
+  },
+  "score.rec.reference_terminology": {
+    es: "Referencia terminologías estándar (LOINC, SNOMED CT, CIE-10) en tus perfiles.",
+    en: "Reference standard terminologies (LOINC, SNOMED CT, ICD-10) in your profiles.",
+  },
+
+  // ── validate_file — errores de acceso a filesystem ────────────────────────
+  "validate_file.err.path_required": {
+    es: "se requiere un path de archivo",
+    en: "a file path is required",
+  },
+  "validate_file.err.outside_root": {
+    es: (v) => `El path '${v.path}' está fuera del root permitido (${v.root}). Por seguridad solo se leen archivos dentro de esa raíz.`,
+    en: (v) => `Path '${v.path}' is outside the allowed root (${v.root}). For security, only files within that root are read.`,
+  },
+  "validate_file.err.bad_extension": {
+    es: (v) => `Extensión no soportada: '${v.path}' debe terminar en .json o .fhir.json.`,
+    en: (v) => `Unsupported extension: '${v.path}' must end in .json or .fhir.json.`,
+  },
+  "validate_file.err.not_found": {
+    es: "el archivo no existe",
+    en: "the file does not exist",
+  },
+  "validate_file.err.symlink": {
+    es: (v) => `'${v.path}' es un enlace simbólico; por seguridad no se siguen symlinks.`,
+    en: (v) => `'${v.path}' is a symbolic link; for security, symlinks are not followed.`,
+  },
+  "validate_file.err.not_file": {
+    es: "la ruta no apunta a un archivo regular",
+    en: "the path does not point to a regular file",
+  },
+  "validate_file.err.parse_failed": {
+    es: "el contenido no es JSON válido",
+    en: "the content is not valid JSON",
+  },
+
+  // ── score_endpoint — guardas de seguridad ─────────────────────────────────
+  "score_endpoint.blocked": {
+    es: (v) => `La URL ${v.url} apunta a una dirección privada, loopback o de metadata de nube y fue bloqueada por seguridad (protección anti-SSRF). Usa un endpoint FHIR público.`,
+    en: (v) => `URL ${v.url} points to a private, loopback or cloud-metadata address and was blocked for security (anti-SSRF protection). Use a public FHIR endpoint.`,
+  },
+  "score_endpoint.too_large": {
+    es: (v) => `La respuesta de ${v.url} supera el límite de ${v.limit} bytes. El CapabilityStatement es inusualmente grande; revisa el endpoint.`,
+    en: (v) => `The response from ${v.url} exceeds the ${v.limit} byte limit. The CapabilityStatement is unusually large; check the endpoint.`,
+  },
+
+  // ── Otros fallbacks ───────────────────────────────────────────────────────
+  "err.not_initialized": {
+    es: (v) => `El método '${v.method}' requiere completar el handshake initialize + notifications/initialized primero (MCP spec).`,
+    en: (v) => `Method '${v.method}' requires completing the initialize handshake + notifications/initialized first (MCP spec).`,
+  },
+  "bridge.fallback.server_error": {
+    es: "Fhiron Bridge respondió con un error inesperado. Intenta de nuevo en unos segundos.",
+    en: "Fhiron Bridge responded with an unexpected error. Please retry in a few seconds.",
+  },
+  "explain.fallback.no_context": {
+    es: "No hay explicación adicional disponible para este código.",
+    en: "No additional explanation is available for this code.",
+  },
+};
+
+const SUPPORTED = new Set(["es", "en"]);
+
+function normalizeLang(lang) {
+  if (!lang) return "es";
+  const l = String(lang).toLowerCase().split(/[-_]/)[0];
+  return SUPPORTED.has(l) ? l : "es";
+}
+
+/**
+ * t(key, lang, vars?) — devuelve el string localizado.
+ * Si la entrada del diccionario es función, la invoca con `vars`.
+ * Si no encuentra la key, devuelve la key (modo defensivo) — esto facilita
+ * detectar entradas faltantes durante desarrollo.
+ *
+ * @param {string} key
+ * @param {string} lang
+ * @param {object} [vars]
+ * @returns {string}
+ */
+function t(key, lang, vars) {
+  const entry = DICT[key];
+  const l = normalizeLang(lang);
+  if (!entry) return key;
+  const v = entry[l] || entry.es;
+  if (typeof v === "function") return v(vars || {});
+  return v;
+}
+
+module.exports = {
+  t,
+  normalizeLang,
+  SUPPORTED_LANGS: Array.from(SUPPORTED),
+  DICT,
+};

package/src/_linter/resources.js

@@ -0,0 +1,173 @@
+// Fhiron linter — lista oficial de resourceTypes de FHIR R4.
+//
+// Se expone como Set para que `lintResource` pueda emitir un warning barato
+// cuando el usuario envía un resourceType inventado (ej. "FooBarInventedResource").
+// La idea es ahorrarle la llamada al servidor: HAPI lo rechazaría igual, pero
+// costaría una cuota.
+
+"use strict";
+
+// Lista tomada del índice de recursos de FHIR R4 (http://hl7.org/fhir/R4/resourcelist.html).
+// Mantener ordenado alfabéticamente para facilitar revisiones manuales.
+const FHIR_R4_RESOURCE_TYPES = Object.freeze([
+  "Account",
+  "ActivityDefinition",
+  "AdverseEvent",
+  "AllergyIntolerance",
+  "Appointment",
+  "AppointmentResponse",
+  "AuditEvent",
+  "Basic",
+  "Binary",
+  "BiologicallyDerivedProduct",
+  "BodyStructure",
+  "Bundle",
+  "CapabilityStatement",
+  "CarePlan",
+  "CareTeam",
+  "CatalogEntry",
+  "ChargeItem",
+  "ChargeItemDefinition",
+  "Claim",
+  "ClaimResponse",
+  "ClinicalImpression",
+  "CodeSystem",
+  "Communication",
+  "CommunicationRequest",
+  "CompartmentDefinition",
+  "Composition",
+  "ConceptMap",
+  "Condition",
+  "Consent",
+  "Contract",
+  "Coverage",
+  "CoverageEligibilityRequest",
+  "CoverageEligibilityResponse",
+  "DetectedIssue",
+  "Device",
+  "DeviceDefinition",
+  "DeviceMetric",
+  "DeviceRequest",
+  "DeviceUseStatement",
+  "DiagnosticReport",
+  "DocumentManifest",
+  "DocumentReference",
+  "DomainResource",
+  "EffectEvidenceSynthesis",
+  "Encounter",
+  "Endpoint",
+  "EnrollmentRequest",
+  "EnrollmentResponse",
+  "EpisodeOfCare",
+  "EventDefinition",
+  "Evidence",
+  "EvidenceVariable",
+  "ExampleScenario",
+  "ExplanationOfBenefit",
+  "FamilyMemberHistory",
+  "Flag",
+  "Goal",
+  "GraphDefinition",
+  "Group",
+  "GuidanceResponse",
+  "HealthcareService",
+  "ImagingStudy",
+  "Immunization",
+  "ImmunizationEvaluation",
+  "ImmunizationRecommendation",
+  "ImplementationGuide",
+  "InsurancePlan",
+  "Invoice",
+  "Library",
+  "Linkage",
+  "List",
+  "Location",
+  "Measure",
+  "MeasureReport",
+  "Media",
+  "Medication",
+  "MedicationAdministration",
+  "MedicationDispense",
+  "MedicationKnowledge",
+  "MedicationRequest",
+  "MedicationStatement",
+  "MedicinalProduct",
+  "MedicinalProductAuthorization",
+  "MedicinalProductContraindication",
+  "MedicinalProductIndication",
+  "MedicinalProductIngredient",
+  "MedicinalProductInteraction",
+  "MedicinalProductManufactured",
+  "MedicinalProductPackaged",
+  "MedicinalProductPharmaceutical",
+  "MedicinalProductUndesirableEffect",
+  "MessageDefinition",
+  "MessageHeader",
+  "MolecularSequence",
+  "NamingSystem",
+  "NutritionOrder",
+  "Observation",
+  "ObservationDefinition",
+  "OperationDefinition",
+  "OperationOutcome",
+  "Organization",
+  "OrganizationAffiliation",
+  "Parameters",
+  "Patient",
+  "PaymentNotice",
+  "PaymentReconciliation",
+  "Person",
+  "PlanDefinition",
+  "Practitioner",
+  "PractitionerRole",
+  "Procedure",
+  "Provenance",
+  "Questionnaire",
+  "QuestionnaireResponse",
+  "RelatedPerson",
+  "RequestGroup",
+  "ResearchDefinition",
+  "ResearchElementDefinition",
+  "ResearchStudy",
+  "ResearchSubject",
+  "Resource",
+  "RiskAssessment",
+  "RiskEvidenceSynthesis",
+  "Schedule",
+  "SearchParameter",
+  "ServiceRequest",
+  "Slot",
+  "Specimen",
+  "SpecimenDefinition",
+  "StructureDefinition",
+  "StructureMap",
+  "Subscription",
+  "Substance",
+  "SubstanceNucleicAcid",
+  "SubstancePolymer",
+  "SubstanceProtein",
+  "SubstanceReferenceInformation",
+  "SubstanceSourceMaterial",
+  "SubstanceSpecification",
+  "SupplyDelivery",
+  "SupplyRequest",
+  "Task",
+  "TerminologyCapabilities",
+  "TestReport",
+  "TestScript",
+  "ValueSet",
+  "VerificationResult",
+  "VisionPrescription",
+]);
+
+const FHIR_R4_RESOURCE_SET = new Set(FHIR_R4_RESOURCE_TYPES);
+
+function isKnownResourceType(name) {
+  return typeof name === "string" && FHIR_R4_RESOURCE_SET.has(name);
+}
+
+module.exports = {
+  FHIR_R4_RESOURCE_TYPES,
+  FHIR_R4_RESOURCE_SET,
+  isKnownResourceType,
+};