@precisa-saude/fhir 0.31.6 → 0.33.0

package/dist/cli.js

@@ -1,8 +1,5 @@
 #!/usr/bin/env node
 
-// src/cli/index.ts
-import { parseArgs as parseArgs3 } from "util";
-
 // src/cli-utils.ts
 async function readStdin() {
   if (process.stdin.isTTY) return "";
@@ -52,6 +49,23 @@ function exitWithError(message, code = 1) {
   process.exit(code);
 }
 
+// src/cli/argv.ts
+function dividirArgv(argv) {
+  let command;
+  let help = false;
+  let json = false;
+  let version = false;
+  const resto = [];
+  for (const token of argv) {
+    if (token === "--json") json = true;
+    else if (token === "--help" || token === "-h") help = true;
+    else if (token === "--version" || token === "-v") version = true;
+    else if (command === void 0 && !token.startsWith("-")) command = token;
+    else resto.push(token);
+  }
+  return { command, help, json, resto, version };
+}
+
 // src/biomarkers.ts
 var BIOMARKER_DEFINITIONS = [
   // ============================================================================
@@ -110,6 +124,10 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "coracao",
     code: "LDL_Medium",
+    // 96735-6 é "in Serum" só, enquanto as vizinhas LDL_Small (43727-7),
+    // LDL_ParticleNumber (54434-6) e HDL_Large (43729-3) são Ser/Plas. É o
+    // único código para a subfração média, e o perfil por RMN roda em soro.
+    // Material registrado de propósito.
     loinc: "96735-6",
     names: {
       en: ["LDL Medium", "Medium LDL Particles"],
@@ -1077,14 +1095,16 @@ var BIOMARKER_DEFINITIONS = [
   },
   {
     // LOINC 99620-7 = "Omega 3 fatty acids (w3) [Moles/volume] in RBC.lysate".
-    // Alinha à matriz das entradas irmãs Omega3_EPA (75097-6) e Omega3_DHA
-    // (75095-0), ambas em hemácias. Anteriormente 35178-3 (mesmo analito em
-    // Ser/Plas), incompatível com o uso clínico do Índice Ômega-3 (Harris &
-    // von Schacky 2004), que é definido em membranas de hemácias.
-    // Ressalva: LOINC declara moles/volume; o biomarcador armazena %.
-    // Não há LOINC vigente para "Omega 3 total em % em RBC" — o `Omega3_Index`
-    // (88998-0) cobre apenas EPA+DHA. Mantemos `unit: '%'` por consistência
-    // com EPA/DHA (75095-0/75097-6 são [Entitic substance], também não-%).
+    // Anteriormente 35178-3 (mesmo analito em Ser/Plas), incompatível com o
+    // uso clínico do Índice Ômega-3 (Harris & von Schacky 2004), que é
+    // definido em membranas de hemácias.
+    //
+    // Compromisso declarado, e não erro: o LOINC 2.82 não tem código de fração
+    // ("ômega-3 total / ácidos graxos totais") para o total, só para os ácidos
+    // individuais e para EPA+DPA+DHA (90911-9). O componente confere; a
+    // propriedade é moles/volume enquanto o laudo imprime %. O teste de eixos
+    // (`loinc-axes.test.ts`) lista esta entrada como exceção com este motivo.
+    // Mesmo compromisso em `Omega6_Total` (99621-5).
     category: "nutrientes",
     code: "Omega3_Total",
     loinc: "99620-7",
@@ -1098,7 +1118,18 @@ var BIOMARKER_DEFINITIONS = [
     category: "nutrientes",
     code: "Omega3_DHA",
     codeAliases: ["DHA"],
-    loinc: "75095-0",
+    // Ácidos graxos individuais: fração do total (% dos ácidos graxos C14-C22),
+    // que é o que o perfil de ácidos graxos e o Índice Ômega-3 imprimem. Os
+    // códigos vêm do painel 90918-4 ("Fatty acid omega-3 and omega-6 panel -
+    // Blood"), o mesmo de onde já saem as razões AA/EPA (90909-3) e ω6/ω3
+    // (90910-1). Até out/2026 apontavam para os códigos [Entitic substance]
+    // em hemácias (75095-0, 75097-6, 75110-7, 75117-2), que são quantidade por
+    // célula, e para 48371-9, que é moles/volume em soro: componente certo,
+    // propriedade errada nos cinco, desde mar/2026. Ficam como alias porque o
+    // analito é o mesmo. Material: o painel em soro/plasma (88884-2, C14-C24)
+    // existe, e é a troca a fazer se um laboratório imprimir o perfil em soro.
+    loinc: "90914-3",
+    loincAliases: ["75095-0"],
     names: {
       en: ["Omega-3 DHA", "DHA", "Docosahexaenoic Acid"],
       pt: ["\xD4mega-3: DHA", "DHA", "\xC1cido Docosahexaenoico"]
@@ -1109,7 +1140,9 @@ var BIOMARKER_DEFINITIONS = [
     category: "nutrientes",
     code: "Omega3_DPA",
     codeAliases: ["DPA"],
-    loinc: "48371-9",
+    // Fração em sangue, painel 90918-4. Ver `Omega3_DHA`.
+    loinc: "90913-5",
+    loincAliases: ["48371-9"],
     names: {
       en: ["Omega-3 DPA", "DPA", "Docosapentaenoic Acid"],
       pt: ["\xD4mega-3: DPA", "DPA", "\xC1cido Docosapentaenoico"]
@@ -1120,7 +1153,9 @@ var BIOMARKER_DEFINITIONS = [
     category: "nutrientes",
     code: "Omega3_EPA",
     codeAliases: ["EPA"],
-    loinc: "75097-6",
+    // Fração em sangue, painel 90918-4. Ver `Omega3_DHA`.
+    loinc: "90912-7",
+    loincAliases: ["75097-6"],
     names: {
       en: ["Omega-3 EPA", "EPA", "Eicosapentaenoic Acid"],
       pt: ["\xD4mega-3: EPA", "EPA", "\xC1cido Eicosapentaenoico"]
@@ -1130,7 +1165,12 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "nutrientes",
     code: "EPADPADHA",
-    loinc: "90908-5",
+    // 90911-9 é a fração EPA+DPA+DHA / ácidos graxos C14-C22 em sangue, o
+    // valor em %. Até out/2026 apontava para 90908-5, que é a *interpretação*
+    // desse mesmo valor (ordinal: risco alto, moderado, baixo), e não o
+    // número. Sem alias: código ordinal carregando valor numérico é o erro
+    // que se quer parar de aceitar.
+    loinc: "90911-9",
     names: {
       en: ["Omega-3 EPA+DPA+DHA", "EPA+DPA+DHA"],
       pt: ["\xD4mega-3: EPA+DPA+DHA"]
@@ -1151,7 +1191,12 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "nutrientes",
     code: "Omega6_Total",
-    loinc: "35177-5",
+    // 99621-5 é "Omega 6 fatty acids (w6) [Moles/volume] in RBC.lysate", o
+    // par exato do 99620-7 de `Omega3_Total`, com o mesmo compromisso de
+    // propriedade documentado lá. Até out/2026 apontava para 35177-5, que é
+    // ácidos graxos poli-insaturados totais em soro: ômega-3 e ômega-6
+    // somados, outro componente. Sem alias.
+    loinc: "99621-5",
     names: {
       en: ["Omega-6 Total", "Total Omega-6"],
       pt: ["\xD4mega-6 Total"]
@@ -1162,7 +1207,9 @@ var BIOMARKER_DEFINITIONS = [
     category: "nutrientes",
     code: "Omega6_AA",
     codeAliases: ["Arachidonic_Acid"],
-    loinc: "75110-7",
+    // Fração em sangue, painel 90918-4. Ver `Omega3_DHA`.
+    loinc: "90916-8",
+    loincAliases: ["75110-7"],
     names: {
       en: ["Omega-6 Arachidonic Acid", "Arachidonic Acid", "AA"],
       pt: ["\xD4mega-6: \xC1cido Araquid\xF4nico", "\xC1cido Araquid\xF4nico", "AA"]
@@ -1173,7 +1220,9 @@ var BIOMARKER_DEFINITIONS = [
     category: "nutrientes",
     code: "Omega6_LA",
     codeAliases: ["Linoleic_Acid"],
-    loinc: "75117-2",
+    // Fração em sangue, painel 90918-4. Ver `Omega3_DHA`.
+    loinc: "90917-6",
+    loincAliases: ["75117-2"],
     names: {
       en: ["Omega-6 Linoleic Acid", "Linoleic Acid", "LA"],
       pt: ["\xD4mega-6: \xC1cido Linoleico", "\xC1cido Linoleico", "LA"]
@@ -1254,7 +1303,11 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "nutrientes",
     code: "Zinc",
-    loinc: "8245-3",
+    // 5763-8 é "Zinc [Mass/volume] in Serum or Plasma", o zinco sérico da
+    // rotina brasileira (o nome em inglês já dizia "Serum Zinc"). Até out/2026
+    // apontava para 8245-3, o mesmo analito em sangue total, que tem faixa de
+    // referência própria. Sem alias: sangue total é outro material.
+    loinc: "5763-8",
     names: {
       en: ["Zinc", "Serum Zinc"],
       pt: ["Zinco"]
@@ -1355,6 +1408,9 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "figado",
     code: "Globulin",
+    // 2336-6 é "Globulin [Mass/volume] in Serum", soro só: o LOINC 2.82 não
+    // tem a versão Ser/Plas da globulina total (as frações alfa, beta e gama
+    // têm). Material registrado de propósito.
     loinc: "2336-6",
     names: {
       en: ["Globulin", "Serum Globulin"],
@@ -1634,6 +1690,13 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "rins",
     code: "BUN_Creatinine_Ratio",
+    // 3097-3 é "Urea nitrogen/Creatinine [Mass Ratio]", a razão BUN/creatinina,
+    // e a faixa de referência (10-20, Tietz) é a dessa convenção. O laudo
+    // brasileiro imprime "Relação Ureia/Creatinina", cuja faixa é outra (cerca
+    // de 21-43) e cujo código é 56997-0 ("Urea/Creatinine [Mass Ratio] in
+    // Serum or Plasma"). Trocar só o código deixaria a faixa errada do outro
+    // lado; a separação em duas grandezas, como em `Glucose_Fasting`, é
+    // decisão à parte, registrada em `reference-ranges.ts`.
     loinc: "3097-3",
     names: {
       en: ["BUN/Creatinine Ratio", "Urea/Creatinine Ratio"],
@@ -1801,7 +1864,12 @@ var BIOMARKER_DEFINITIONS = [
     category: "urina",
     code: "Bacteria_Urine",
     codeAliases: ["UrineBacteria"],
-    loinc: "630-4",
+    // 5769-5 é "Bacteria [#/area] in Urine sediment by Microscopy high power
+    // field", a contagem do sedimento que a unidade /HPF declara. Até out/2026
+    // apontava para 630-4, "Bacteria identified in Urine by Culture": outro
+    // exame, nominal, que identifica a espécie em cultura. Sem alias:
+    // urocultura não é sedimento.
+    loinc: "5769-5",
     names: {
       en: ["Urine Bacteria", "Bacteria Urine", "Bacteria, Urine", "Bacteria"],
       pt: ["Bact\xE9rias na Urina", "Bact\xE9rias"]
@@ -1920,7 +1988,14 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "urina",
     code: "RBC_Urine",
-    loinc: "5808-1",
+    // 13945-1 é "Erythrocytes [#/area] in Urine sediment by Microscopy high
+    // power field", o /HPF que o laudo imprime e que `Leukocytes_Urine` já usa
+    // em 5821-4. Até out/2026 apontava para 5808-1, o mesmo exame em #/volume
+    // (por mL): analito e material certos, propriedade errada. Fica como alias
+    // porque o analito é o mesmo, e laudo de analisador automático que conte
+    // por mL continua resolvendo em RBC_Urine.
+    loinc: "13945-1",
+    loincAliases: ["5808-1"],
     names: {
       en: ["Urine RBC", "Red Blood Cells in Urine", "RBC Urine", "RBC, Urine"],
       pt: ["Hem\xE1cias na Urina"]
@@ -2015,6 +2090,10 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "autoimunidade",
     code: "Gliadin_Deamidated_IgA",
+    // 63453-5 e 63459-2 (IgG) afirmam método, "by Immunoassay", e material,
+    // "Serum". É o que os kits de DGP usam. A propriedade é unidades
+    // arbitrárias por volume, e o laudo imprime U/mL; até out/2026 a unidade
+    // declarada era "U", sem o volume.
     loinc: "63453-5",
     names: {
       en: [
@@ -2028,7 +2107,7 @@ var BIOMARKER_DEFINITIONS = [
       ],
       pt: ["Anticorpos Anti-Gliadina Deamidada IgA", "DGP IgA"]
     },
-    unit: "U"
+    unit: "U/mL"
   },
   {
     category: "autoimunidade",
@@ -2046,7 +2125,7 @@ var BIOMARKER_DEFINITIONS = [
       ],
       pt: ["Anticorpos Anti-Gliadina Deamidada IgG", "DGP IgG"]
     },
-    unit: "U"
+    unit: "U/mL"
   },
   {
     category: "autoimunidade",
@@ -2437,6 +2516,10 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "composicao-corporal",
     code: "TotalBodyWater",
+    // 101683-1 é "Body water mass", em kg; o aparelho de bioimpedância imprime
+    // litros. É o único código de água corporal total no LOINC 2.82 (o outro,
+    // 101684-9, é o percentual), e para água 1 L pesa 1 kg, então o número não
+    // muda. O teste de eixos lista a entrada como exceção com este motivo.
     loinc: "101683-1",
     names: {
       en: ["Total Body Water", "Body Water", "TBW", "Total Water"],
@@ -2502,6 +2585,10 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "composicao-corporal",
     code: "PhaseAngle",
+    // 107160-4 é "Phase angle Xc/R [Ratio] Bioelectrical impedance analysis",
+    // único código de ângulo de fase. O aparelho imprime graus (arctan Xc/R)
+    // e o LOINC declara razão com unidade-exemplo %. Fica em graus, que é o
+    // que o laudo traz, e o teste de eixos lista a entrada como exceção.
     loinc: "107160-4",
     names: {
       en: ["Phase Angle", "Whole Body Phase Angle", "PhA", "AnglePhase"],
@@ -2592,9 +2679,9 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "composicao-corporal",
     code: "WaistCircumference",
-    // 8280-0 é a medida em si. 56086-2, que parecia o óbvio pela busca, é
-    // "Adult Waist Circumference Protocol", um protocolo PhenX e não um
-    // resultado.
+    // 8280-0 é a medida em si, e afirma sítio e método: "at umbilicus by Tape
+    // measure". 56086-2, que parecia o óbvio pela busca, é "Adult Waist
+    // Circumference Protocol", um protocolo PhenX e não um resultado.
     loinc: "8280-0",
     names: {
       en: ["Waist Circumference", "Abdominal Circumference", "Waist"],
@@ -3004,6 +3091,10 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "coracao",
     code: "TroponinI",
+    // 49563-0 afirma método: limite de detecção ≤ 0,01 ng/mL, o ensaio de alta
+    // sensibilidade. Um resultado de troponina I convencional pede o código
+    // sem método, 10839-9. Assimétrico com `TroponinT`, que fica no 6598-7 sem
+    // método de propósito: a hs-cTnT em ng/L é a convenção dos laudos.
     loinc: "49563-0",
     names: {
       en: ["Troponin I", "cTnI", "Cardiac Troponin I", "hs-TnI", "High-Sensitivity Troponin I"],
@@ -3014,6 +3105,9 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "coracao",
     code: "TroponinT",
+    // 6598-7 não afirma método. A unidade ng/L é a convenção do ensaio de alta
+    // sensibilidade (hs-cTnT), e o ensaio convencional em ng/mL converte por
+    // fator exato (ver `units.ts`). Ver `TroponinI` para a assimetria.
     loinc: "6598-7",
     names: {
       en: ["Troponin T", "cTnT", "Cardiac Troponin T", "hs-TnT", "High-Sensitivity Troponin T"],
@@ -3050,6 +3144,11 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "figado",
     code: "LDH",
+    // 14804-9 afirma método: reação lactato → piruvato (L→P). O código sem
+    // método, 2532-0, está DISCOURAGED, então um método tem que ser escolhido,
+    // e L→P é o do procedimento de referência IFCC que os laboratórios
+    // brasileiros usam, ainda que o laudo raramente imprima a direção. Se um
+    // laudo declarar P→L, o código é outro (14805-6).
     loinc: "14804-9",
     // 2532-0 é o código genérico anterior, que o LOINC marca como DISCOURAGED.
     // Fica como alias para que laudo antigo e dado já armazenado continuem
@@ -3180,7 +3279,13 @@ var BIOMARKER_DEFINITIONS = [
   {
     category: "pancreas",
     code: "BetaHydroxybutyrate",
-    loinc: "53060-0",
+    // 6873-4 é "Beta hydroxybutyrate [Moles/volume] in Serum or Plasma", o
+    // que o laudo dosa em mmol/L. Até out/2026 apontava para 53060-0, que é
+    // butirilcarnitina (C4) em líquido amniótico: analito e material errados
+    // desde abr/2026, e nenhum check pegou porque o código existe e está
+    // ACTIVE. Sem alias para o código antigo: ele nunca significou BHB, e
+    // aceitá-lo na importação faria um laudo de carnitina virar cetona.
+    loinc: "6873-4",
     names: {
       en: ["Beta-Hydroxybutyrate", "\u03B2-Hydroxybutyrate", "BHB", "Ketone Bodies"],
       pt: ["Beta-Hidroxibutirato", "\u03B2-Hidroxibutirato", "BHB", "Corpos Cet\xF4nicos"]
@@ -3311,97 +3416,99 @@ var BIOMARKER_CODE_SYSTEM = "http://fhir-brasil.dev/biomarker-codes";
 var UNIT_TO_UCUM = {
   // Dimensionless / special measurements
   "[pH]": "[pH]",
+  "{index}": "{index}",
   "{ratio}": "{ratio}",
+  "{score}": "{score}",
   "{specific gravity}": "{specific gravity}",
+  "/HPF": "/[HPF]",
+  "/LPF": "/[LPF]",
   "/\xB5L": "/uL",
   // Percentage
   "%": "%",
   // Count units
   "10\xB3/\xB5L": "10*3/uL",
   "10\u2076/\xB5L": "10*6/uL",
+  Angstrom: "Ao",
+  AU: "{score}",
+  cm: "cm",
+  "cm\xB3": "cm3",
+  deg: "deg",
   // Volume
   fL: "fL",
   g: "g",
+  "g/cm\xB2": "g/cm2",
   // Mass concentration
   "g/dL": "g/dL",
+  "g/L": "g/L",
+  "IU/L": "[IU]/L",
+  "IU/mL": "[IU]/mL",
+  "K/uL": "10*3/uL",
+  "kcal/d": "kcal/d",
+  kg: "kg",
+  "kg/m2": "kg/m2",
+  "kg/m\xB2": "kg/m2",
+  "kU/L": "k[IU]/L",
   L: "L",
+  "M/uL": "10*6/uL",
+  "mcg/dL": "ug/dL",
+  "mcg/L": "ug/L",
+  "mcg/mL": "ug/mL",
   // Molar concentration
   "mEq/L": "meq/L",
   mg: "mg",
   "mg/dL": "mg/dL",
+  "mg/g": "mg/g",
+  "mg/L": "mg/L",
+  "mIU/L": "m[IU]/L",
+  "mIU/mL": "m[IU]/mL",
   mL: "mL",
+  "mL/min/1.73m\xB2": "mL/min/{1.73_m2}",
+  mm: "mm",
+  "mm/h": "mm/h",
+  "mm/hr": "mm/h",
   "mmol/L": "mmol/L",
+  "mUI/L": "m[IU]/L",
   "mUI/mL": "m[IU]/mL",
   ng: "ng",
   "ng/dL": "ng/dL",
+  "ng/L": "ng/L",
   "ng/mL": "ng/mL",
   "nmol/L": "nmol/L",
   // Mass
   pg: "pg",
   "pg/mL": "pg/mL",
   pH: "[pH]",
+  "pmol/L": "pmol/L",
+  raz\u00E3o: "{ratio}",
+  score: "{score}",
+  segundos: "s",
   // Enzyme activity
+  U: "U",
   "U/L": "U/L",
   // Special units
   "U/mL": "U/mL",
+  "ug/dL": "ug/dL",
+  "ug/L": "ug/L",
   "UI/L": "[IU]/L",
   "UI/mL": "[IU]/mL",
+  "uIU/mL": "u[IU]/mL",
+  "umol/L": "umol/L",
   \u00B5g: "ug",
   "\xB5g/dL": "ug/dL",
+  "\xB5g/L": "ug/L",
   "\xB5mol/L": "umol/L",
-  "\xB5UI/mL": "u[IU]/mL"
+  "\xB5UI/mL": "u[IU]/mL",
+  \u00EDndice: "{index}"
 };
-var BIOMARKER_DEFAULT_UNIT = {
-  // Proteins
-  Albumin: "g/dL",
-  AlkalinePhosphatase: "U/L",
-  // Liver
-  ALT: "U/L",
-  AST: "U/L",
-  Calcium: "mg/dL",
-  Chloride: "mEq/L",
-  // Lipids
-  Cholesterol: "mg/dL",
-  // Kidney
-  Creatinine: "mg/dL",
-  eAG: "mg/dL",
-  Ferritin: "ng/mL",
-  FolicAcid: "ng/mL",
-  GGT: "U/L",
-  // Glucose/Diabetes
-  Glucose: "mg/dL",
-  HbA1c: "%",
-  Hct: "%",
-  HDL: "mg/dL",
-  // Hematology
-  Hgb: "g/dL",
-  Insulin: "\xB5UI/mL",
-  // Iron studies
-  Iron: "\xB5g/dL",
-  LDL: "mg/dL",
-  Magnesium: "mg/dL",
-  NonHDL_Cholesterol: "mg/dL",
-  // Urinalysis - dimensionless
+var DIMENSIONLESS_DEFAULTS = {
   pH_Urine: "[pH]",
-  Potassium: "mEq/L",
-  RDW: "%",
-  // Electrolytes
-  Sodium: "mEq/L",
-  SpecificGravity_Urine: "{specific gravity}",
-  T3Free: "pg/mL",
-  T4Free: "ng/dL",
-  TIBC: "\xB5g/dL",
-  TotalProtein: "g/dL",
-  TransferrinSaturation: "%",
-  Triglycerides: "mg/dL",
-  // Thyroid
-  TSH: "\xB5UI/mL",
-  Urea: "mg/dL",
-  UricAcid: "mg/dL",
-  // Vitamins
-  VitaminB12: "pg/mL",
-  VitaminD: "ng/mL",
-  VLDL: "mg/dL"
+  SpecificGravity_Urine: "{specific gravity}"
+};
+var BIOMARKER_DEFAULT_UNIT = {
+  ...Object.fromEntries(
+    BIOMARKER_DEFINITIONS.filter((b) => b.unit).map((b) => [b.code, b.unit])
+  ),
+  ...DIMENSIONLESS_DEFAULTS
 };
 function unitToUCUM(unit) {
   return UNIT_TO_UCUM[unit] || unit;
@@ -3409,6 +3516,128 @@ function unitToUCUM(unit) {
 function getDefaultUnit(biomarkerCode) {
   return BIOMARKER_DEFAULT_UNIT[biomarkerCode] || "";
 }
+var UCUM_ATOMS = /* @__PURE__ */ new Set([
+  "m",
+  "g",
+  "s",
+  "L",
+  "l",
+  "mol",
+  "eq",
+  "U",
+  "cal",
+  "h",
+  "d",
+  "min",
+  "wk",
+  "mo",
+  "a",
+  "Ao",
+  "deg",
+  "K",
+  "A",
+  "N",
+  "Pa",
+  "J",
+  "W",
+  "Hz",
+  "V",
+  "C",
+  "osm",
+  "t",
+  "u",
+  "bar",
+  "atm",
+  "rad",
+  "sr",
+  "cd",
+  "Bq",
+  "Gy",
+  "Sv",
+  "lm",
+  "lx",
+  "Cel",
+  "B",
+  "Np"
+]);
+var UCUM_PREFIXES = /* @__PURE__ */ new Set([
+  "Y",
+  "Z",
+  "E",
+  "P",
+  "T",
+  "G",
+  "M",
+  "k",
+  "h",
+  "da",
+  "d",
+  "c",
+  "m",
+  "u",
+  "n",
+  "p",
+  "f",
+  "a",
+  "z",
+  "y"
+]);
+function isUcumAtom(token) {
+  if (token === "%" || /^10\*-?\d+$/.test(token) || /^\d+$/.test(token)) return true;
+  const bracket = /^([A-Za-z]{0,2})\[[^[\]{}\s]+\]$/.exec(token);
+  if (bracket) return bracket[1] === "" || UCUM_PREFIXES.has(bracket[1]);
+  if (UCUM_ATOMS.has(token)) return true;
+  for (const prefix of UCUM_PREFIXES) {
+    if (token.startsWith(prefix) && UCUM_ATOMS.has(token.slice(prefix.length))) return true;
+  }
+  return false;
+}
+function isUcumComponent(token) {
+  const m = /^(.*?)(\{[^{}]*\})?$/.exec(token);
+  if (!m) return false;
+  const [, body, annotation] = m;
+  if (!body) return annotation !== void 0;
+  const exp = /^(.+?)([+-]?\d+)?$/.exec(body);
+  if (!exp) return false;
+  const [, atom, exponent] = exp;
+  if (isUcumAtom(body)) return true;
+  if (exponent === void 0) return false;
+  return isUcumAtom(atom);
+}
+function isUcumCode(code) {
+  if (!code || /[^\x21-\x7E ]/.test(code)) return false;
+  const terms = [];
+  let current = "";
+  let braces = 0;
+  let inBracket = false;
+  for (const ch of code) {
+    if (ch === "{") braces++;
+    else if (ch === "}") {
+      if (braces === 0) return false;
+      braces--;
+    } else if (ch === "[") inBracket = true;
+    else if (ch === "]") inBracket = false;
+    if ((ch === "." || ch === "/") && braces === 0 && !inBracket) {
+      terms.push(current, ch);
+      current = "";
+      continue;
+    }
+    current += ch;
+  }
+  if (braces !== 0 || inBracket) return false;
+  terms.push(current);
+  if (terms[0] === "" && terms[1] === "/") terms[0] = "1";
+  let expectOperand = true;
+  for (const t of terms) {
+    if (expectOperand) {
+      if (!isUcumComponent(t)) return false;
+    } else if (t !== "." && t !== "/") {
+      return false;
+    }
+    expectOperand = !expectOperand;
+  }
+  return !expectOperand;
+}
 var CBC_DIFF_ALIASES = {
   "/ul": "/uL",
   "/\xB5l": "/uL",
@@ -3710,7 +3939,7 @@ var BIOMARKER_UNITS = {
       "miu/ml": "mIU/mL",
       "ui/l": "mIU/mL"
     },
-    canonicalUcum: "mIU/mL",
+    canonicalUcum: "m[iU]/mL",
     canonicalUnit: "mIU/mL",
     siUcum: "[iU]/L",
     siUnit: "IU/L"
@@ -3845,7 +4074,7 @@ var BIOMARKER_UNITS = {
       "miu/ml": "mIU/mL",
       "ui/l": "mIU/mL"
     },
-    canonicalUcum: "mIU/mL",
+    canonicalUcum: "m[iU]/mL",
     canonicalUnit: "mIU/mL",
     siUcum: "[iU]/L",
     siUnit: "IU/L"
@@ -4112,7 +4341,7 @@ var BIOMARKER_UNITS = {
     },
     canonicalUcum: "u[iU]/mL",
     canonicalUnit: "uIU/mL",
-    siUcum: "mIU/L",
+    siUcum: "m[iU]/L",
     siUnit: "mIU/L"
   },
   Urea: {
@@ -4167,6 +4396,21 @@ var BIOMARKER_UNITS = {
 function getCanonicalUnit(code) {
   return BIOMARKER_UNITS[code]?.canonicalUnit ?? null;
 }
+function normalizeUnit(unit, config) {
+  return config.aliases[unit.toLowerCase()] ?? config.aliases[unit] ?? unit;
+}
+function resolveUcum(unit, biomarkerCode) {
+  if (!unit) return void 0;
+  const config = biomarkerCode ? BIOMARKER_UNITS[biomarkerCode] : void 0;
+  if (config) {
+    const normalized = normalizeUnit(unit, config);
+    if (normalized === config.canonicalUnit) return config.canonicalUcum;
+    if (normalized === config.siUnit) return config.siUcum;
+  }
+  const mapped = UNIT_TO_UCUM[unit];
+  if (mapped) return mapped;
+  return isUcumCode(unit) ? unit : void 0;
+}
 
 // src/converter.ts
 function interpretationCode(flag) {
@@ -4199,13 +4443,7 @@ var SEX_CODING = {
   },
   male: { code: "male", display: "Male", system: "http://hl7.org/fhir/administrative-gender" }
 };
-var buildReferenceRanges = (observation, sourceUnit, ucumUnit) => {
-  const quantity = (value) => ({
-    code: ucumUnit,
-    system: "http://unitsofmeasure.org",
-    unit: sourceUnit,
-    value
-  });
+var buildReferenceRanges = (observation, quantity) => {
   const toRanges = (low, high, sex) => {
     if (low === void 0 && high === void 0) return [];
     return [
@@ -4224,7 +4462,12 @@ var buildReferenceRanges = (observation, sourceUnit, ucumUnit) => {
 function labObservationToFHIR(observation, patientId, laboratoryName) {
   const loincCode = codeToLoinc(observation.biomarkerCode);
   const sourceUnit = observation.unit || getDefaultUnit(observation.biomarkerCode) || observation.unit;
-  const ucumUnit = unitToUCUM(sourceUnit);
+  const ucumUnit = resolveUcum(sourceUnit, observation.biomarkerCode);
+  const quantity = (value) => ({
+    ...ucumUnit ? { code: ucumUnit, system: "http://unitsofmeasure.org" } : {},
+    ...sourceUnit ? { unit: sourceUnit } : {},
+    value
+  });
   const isQualitative = observation.isQualitative || typeof observation.value === "string";
   const fhirObs = {
     category: [
@@ -4283,13 +4526,8 @@ function labObservationToFHIR(observation, patientId, laboratoryName) {
   if (isQualitative) {
     fhirObs.valueString = String(observation.value);
   } else {
-    fhirObs.valueQuantity = {
-      code: ucumUnit,
-      system: "http://unitsofmeasure.org",
-      unit: sourceUnit,
-      value: observation.value
-    };
-    const referenceRange = buildReferenceRanges(observation, sourceUnit, ucumUnit);
+    fhirObs.valueQuantity = quantity(observation.value);
+    const referenceRange = buildReferenceRanges(observation, quantity);
     if (referenceRange.length > 0) fhirObs.referenceRange = referenceRange;
   }
   return fhirObs;
@@ -6765,6 +7003,403 @@ async function range(args, json) {
   );
 }
 
+// src/cli/commands/source.ts
+import { parseArgs as parseArgs3 } from "util";
+
+// src/sources.ts
+var SOURCE_REGISTRY = {
+  // ---------------------------------------------------------------------------
+  // Fontes internacionais — Cardiovascular
+  // ---------------------------------------------------------------------------
+  "agatston-1990": {
+    abnt: "AGATSTON, A. S. et al. Quantification of coronary artery calcium using ultrafast computed tomography. Journal of the American College of Cardiology, v. 15, n. 4, p. 827-832, 1990.",
+    doi: "10.1016/0735-1097(90)90282-T",
+    key: "agatston-1990",
+    url: "https://pubmed.ncbi.nlm.nih.gov/2407762/"
+  },
+  "browning-ashwell-2010": {
+    abnt: "BROWNING, L. M.; HSIEH, S. D.; ASHWELL, M. A systematic review of waist-to-height ratio as a screening tool for the prediction of cardiovascular disease and diabetes: 0,5 could be a suitable global boundary value. Nutrition Research Reviews, v. 23, n. 2, p. 247-269, 2010.",
+    doi: "10.1017/S0954422410000144",
+    key: "browning-ashwell-2010",
+    url: "https://pubmed.ncbi.nlm.nih.gov/20819243/"
+  },
+  "castelli-ratio-1992": {
+    abnt: "CASTELLI, W. P. et al. Lipids and risk of coronary heart disease: the Framingham Study. Annals of Epidemiology, v. 2, n. 1-2, p. 23-28, 1992.",
+    doi: "10.1016/1047-2797(92)90033-M",
+    key: "castelli-ratio-1992",
+    url: "https://pubmed.ncbi.nlm.nih.gov/1342260/"
+  },
+  "caulfield-ionmobility-2008": {
+    abnt: "CAULFIELD, M. P. et al. Direct determination of lipoprotein particle sizes and concentrations by ion mobility analysis. Clinical Chemistry, v. 54, n. 8, p. 1307-1316, 2008.",
+    doi: "10.1373/clinchem.2007.100586",
+    key: "caulfield-ionmobility-2008",
+    url: "https://pubmed.ncbi.nlm.nih.gov/18515257/"
+  },
+  "contois-apoa1-1996": {
+    abnt: "CONTOIS, J. H. et al. Reference intervals for plasma apolipoprotein A-1 determined with a standardized commercial immunoturbidimetric assay: results from the Framingham Offspring Study. Clinical Chemistry, v. 42, n. 4, p. 507-514, 1996.",
+    doi: "10.1093/clinchem/42.4.507",
+    key: "contois-apoa1-1996",
+    url: "https://pubmed.ncbi.nlm.nih.gov/8605666/"
+  },
+  "ewgsop2-2019": {
+    abnt: "CRUZ-JENTOFT, A. J. et al. Sarcopenia: revised European consensus on definition and diagnosis. Age and Ageing, v. 48, n. 1, p. 16-31, 2019.",
+    doi: "10.1093/ageing/afy169",
+    key: "ewgsop2-2019",
+    url: "https://pubmed.ncbi.nlm.nih.gov/30312372/"
+  },
+  "ferreira-vitd-2017": {
+    abnt: "FERREIRA, C. E. S. et al. Posicionamento oficial da Sociedade Brasileira de Patologia Cl\xEDnica/Medicina Laboratorial e da Sociedade Brasileira de Endocrinologia e Metabologia sobre intervalos de refer\xEAncia da vitamina D [25(OH)D]. Archives of Endocrinology and Metabolism, v. 61, n. 6, p. 527-542, 2017.",
+    doi: "10.1590/2359-3997000000310",
+    key: "ferreira-vitd-2017",
+    url: "https://pubmed.ncbi.nlm.nih.gov/29412389/"
+  },
+  "friedewald-1972": {
+    abnt: "FRIEDEWALD, W. T.; LEVY, R. I.; FREDRICKSON, D. S. Estimation of the concentration of low-density lipoprotein cholesterol in plasma, without use of the preparative ultracentrifuge. Clinical Chemistry, v. 18, n. 6, p. 499-502, 1972.",
+    doi: "10.1093/clinchem/18.6.499",
+    key: "friedewald-1972",
+    url: "https://pubmed.ncbi.nlm.nih.gov/4337382/"
+  },
+  "gallagher-bodyfat-2000": {
+    abnt: "GALLAGHER, D. et al. Healthy percentage body fat ranges: an approach for developing guidelines based on body mass index. American Journal of Clinical Nutrition, v. 72, n. 3, p. 694-701, 2000.",
+    key: "gallagher-bodyfat-2000",
+    url: "https://pubmed.ncbi.nlm.nih.gov/10966886/"
+  },
+  "ge-corescan": {
+    abnt: "GE HEALTHCARE. enCORE Software CoreScan: Visceral Adipose Tissue (VAT) assessment. Madison: GE Medical Systems Lunar, [s. d.]. (Documenta\xE7\xE3o do fabricante do DEXA Lunar Prodigy; classifica\xE7\xE3o Healthy 0\u201352 in\xB3, Increased Risk 52,15\u2013112,10 in\xB3, At Risk 112,10+ in\xB3, equivalente a 0\u2013852 cm\xB3, 854\u20131.837 cm\xB3, 1.837+ cm\xB3.)",
+    key: "ge-corescan",
+    url: "https://www.gehealthcare.com/products/bone-and-metabolic-health/encore"
+  },
+  "geloneze-brams-2009": {
+    abnt: "GELONEZE, B. et al. HOMA1-IR and HOMA2-IR indexes in identifying insulin resistance and metabolic syndrome \u2014 Brazilian Metabolic Syndrome Study (BRAMS). Arquivos Brasileiros de Endocrinologia & Metabologia, v. 53, n. 2, p. 281-287, 2009.",
+    doi: "10.1590/S0004-27302009000200020",
+    key: "geloneze-brams-2009",
+    url: "https://pubmed.ncbi.nlm.nih.gov/19466221/"
+  },
+  "george-ck-2016": {
+    abnt: "GEORGE, M. D.; MCGILL, N. K.; BAKER, J. F. Creatine kinase in the U.S. population: impact of demographics, comorbidities, and body composition on the normal range. Medicine, v. 95, n. 33, e4344, 2016.",
+    doi: "10.1097/MD.0000000000004344",
+    key: "george-ck-2016",
+    url: "https://pubmed.ncbi.nlm.nih.gov/27537560/"
+  },
+  "giannitsis-hstnt-2010": {
+    abnt: "GIANNITSIS, E. et al. Analytical validation of a high-sensitivity cardiac troponin T assay. Clinical Chemistry, v. 56, n. 2, p. 254-261, 2010.",
+    doi: "10.1373/clinchem.2009.132654",
+    key: "giannitsis-hstnt-2010",
+    url: "https://pubmed.ncbi.nlm.nih.gov/19959623/"
+  },
+  "glis-2024": {
+    abnt: "KIRK, B. et al. The conceptual definition of sarcopenia: Delphi consensus from the Global Leadership Initiative in Sarcopenia (GLIS). Age and Ageing, v. 53, n. 3, afae052, 2024.",
+    doi: "10.1093/ageing/afae052",
+    key: "glis-2024",
+    url: "https://pubmed.ncbi.nlm.nih.gov/38520141/"
+  },
+  // ---------------------------------------------------------------------------
+  // Fontes internacionais — Ácidos graxos ômega
+  // ---------------------------------------------------------------------------
+  "harris-omega3-2004": {
+    abnt: "HARRIS, W. S.; VON SCHACKY, C. The Omega-3 Index: a new risk factor for death from coronary heart disease? Preventive Medicine, v. 39, n. 1, p. 212-220, 2004.",
+    doi: "10.1016/j.ypmed.2004.02.030",
+    key: "harris-omega3-2004",
+    url: "https://pubmed.ncbi.nlm.nih.gov/15208005/"
+  },
+  // ---------------------------------------------------------------------------
+  // Referência laboratorial geral
+  // ---------------------------------------------------------------------------
+  "kalaria-ck-ri-2026": {
+    abnt: "KALARIA, T. et al. Age, sex and ethnicity changes in creatine kinase and sex- and ethnicity-specific reference intervals of creatine kinase. Clinical Medicine, v. 26, n. 4, p. 100596, 2026.",
+    doi: "10.1016/j.clinme.2026.100596",
+    key: "kalaria-ck-ri-2026",
+    url: "https://pubmed.ncbi.nlm.nih.gov/42142664/"
+  },
+  // ---------------------------------------------------------------------------
+  // Fontes internacionais — Nefrologia
+  // ---------------------------------------------------------------------------
+  "kdigo-ckd-2024": {
+    abnt: "KIDNEY DISEASE: IMPROVING GLOBAL OUTCOMES (KDIGO) CKD Work Group. KDIGO 2024 Clinical Practice Guideline for the Evaluation and Management of Chronic Kidney Disease. Kidney International, v. 105, n. 4S, p. S117-S314, 2024.",
+    doi: "10.1016/j.kint.2023.10.018",
+    key: "kdigo-ckd-2024",
+    url: "https://pubmed.ncbi.nlm.nih.gov/38490803/"
+  },
+  "keller-tni-2013": {
+    abnt: "KELLER, T. et al. Defining a reference population to determine the 99th percentile of a contemporary sensitive cardiac troponin I assay. International Journal of Cardiology, v. 167, n. 4, p. 1423-1429, 2013.",
+    doi: "10.1016/j.ijcard.2012.04.063",
+    key: "keller-tni-2013",
+    url: "https://pubmed.ncbi.nlm.nih.gov/22560907/"
+  },
+  "kelly-dxa-2009": {
+    abnt: "KELLY, T. L. et al. Dual energy X-ray absorptiometry body composition reference values from NHANES. PLoS One, v. 4, n. 9, e7038, 2009.",
+    doi: "10.1371/journal.pone.0007038",
+    key: "kelly-dxa-2009",
+    url: "https://pubmed.ncbi.nlm.nih.gov/19753111/"
+  },
+  "khetarpal-apociii-2016": {
+    abnt: "KHETARPAL, S. A. et al. Why is apolipoprotein CIII emerging as a novel therapeutic target to reduce the burden of cardiovascular disease? Current Atherosclerosis Reports, v. 18, n. 10, p. 59, 2016.",
+    key: "khetarpal-apociii-2016",
+    url: "https://pmc.ncbi.nlm.nih.gov/articles/PMC5018018/"
+  },
+  "klee-bhb-2020": {
+    abnt: "KLEE, P. et al. Test validation, method comparison and reference range for the measurement of \u03B2-hydroxybutyrate in peripheral blood samples. Practical Laboratory Medicine, v. 18, e00146, 2020.",
+    doi: "10.1016/j.plabm.2019.e00146",
+    key: "klee-bhb-2020",
+    url: "https://pmc.ncbi.nlm.nih.gov/articles/PMC6999181/"
+  },
+  "maisel-bnp-2002": {
+    abnt: "MAISEL, A. S. et al. Rapid measurement of B-type natriuretic peptide in the emergency diagnosis of heart failure. New England Journal of Medicine, v. 347, n. 3, p. 161-167, 2002.",
+    doi: "10.1056/NEJMoa020233",
+    key: "maisel-bnp-2002",
+    url: "https://pubmed.ncbi.nlm.nih.gov/12124404/"
+  },
+  "meuwese-mpo-2007": {
+    abnt: "MEUWESE, M. C. et al. Serum myeloperoxidase levels are associated with the future risk of coronary artery disease in apparently healthy individuals: the EPIC-Norfolk Prospective Population Study. Journal of the American College of Cardiology, v. 50, n. 2, p. 159-165, 2007.",
+    doi: "10.1016/j.jacc.2007.03.033",
+    key: "meuwese-mpo-2007",
+    url: "https://pubmed.ncbi.nlm.nih.gov/17616301/"
+  },
+  // ---------------------------------------------------------------------------
+  // Fontes internacionais — Marcadores metabólicos e inflamatórios
+  // ---------------------------------------------------------------------------
+  "nemeth-adma-2017": {
+    abnt: "NEMETH, B. et al. The issue of plasma asymmetric dimethylarginine reference range: a systematic review and meta-analysis. PLoS One, v. 12, n. 5, e0177493, 2017.",
+    doi: "10.1371/journal.pone.0177493",
+    key: "nemeth-adma-2017",
+    url: "https://pubmed.ncbi.nlm.nih.gov/28494019/"
+  },
+  // ---------------------------------------------------------------------------
+  // Fontes brasileiras — Metais pesados (NR-7)
+  // ---------------------------------------------------------------------------
+  "nr7-pcmso-2020": {
+    abnt: "BRASIL. Minist\xE9rio do Trabalho e Emprego. NR-7 \u2014 PCMSO, Quadro 1: Indicadores biol\xF3gicos. Portaria n. 6.734, de 9 de mar\xE7o de 2020. Di\xE1rio Oficial da Uni\xE3o, Bras\xEDlia, 13 mar. 2020.",
+    key: "nr7-pcmso-2020",
+    url: "https://www.gov.br/trabalho-e-emprego/pt-br/assuntos/inspecao-do-trabalho/seguranca-e-saude-no-trabalho/sst-portarias/2022/portaria-no-567-de-10-de-marco-de-2022-alteracoes-na-nr-7.pdf"
+  },
+  "ofenheimer-vat-2020": {
+    abnt: "OFENHEIMER, A. et al. Reference values of body composition parameters and visceral adipose tissue (VAT) by DXA in adults aged 18-81 years: results from the LEAD cohort. European Journal of Clinical Nutrition, v. 74, p. 1181-1191, 2020.",
+    doi: "10.1038/s41430-020-0596-5",
+    key: "ofenheimer-vat-2020",
+    url: "https://pubmed.ncbi.nlm.nih.gov/32123345/"
+  },
+  "pns-bioquimica-2019": {
+    abnt: "SZWARCWALD, C. L. et al. Valores de refer\xEAncia para exames laboratoriais de colesterol, hemoglobina glicosilada e creatinina da popula\xE7\xE3o adulta brasileira. Revista Brasileira de Epidemiologia, v. 22, supl. 2, e190002.supl.2, 2019.",
+    doi: "10.1590/1980-549720190002.supl.2",
+    key: "pns-bioquimica-2019",
+    url: "https://pubmed.ncbi.nlm.nih.gov/31596373/"
+  },
+  // ---------------------------------------------------------------------------
+  // Pesquisa Nacional de Saúde (PNS) — Intervalos de referência brasileiros
+  // ---------------------------------------------------------------------------
+  "pns-hemograma-2019": {
+    abnt: "ROSENFELD, L. G. et al. Valores de refer\xEAncia para exames laboratoriais de hemograma da popula\xE7\xE3o adulta brasileira: Pesquisa Nacional de Sa\xFAde. Revista Brasileira de Epidemiologia, v. 22, supl. 2, e190003.supl.2, 2019.",
+    doi: "10.1590/1980-549720190003.supl.2",
+    key: "pns-hemograma-2019",
+    url: "https://pubmed.ncbi.nlm.nih.gov/31596374/"
+  },
+  "pns-renal-2019": {
+    abnt: "MALTA, D. C. et al. Evaluation of renal function in the Brazilian adult population, according to laboratory criteria from the National Health Survey. Revista Brasileira de Epidemiologia, v. 22, supl. 2, e190010.supl.2, 2019.",
+    doi: "10.1590/1980-549720190010.supl.2",
+    key: "pns-renal-2019",
+    url: "https://pubmed.ncbi.nlm.nih.gov/31596381/"
+  },
+  "rumberger-cac-1999": {
+    abnt: "RUMBERGER, J. A. et al. Electron beam computed tomographic coronary calcium scanning: a review and guidelines for use in asymptomatic persons. Mayo Clinic Proceedings, v. 74, n. 3, p. 243-252, 1999.",
+    doi: "10.4065/74.3.243",
+    key: "rumberger-cac-1999",
+    url: "https://pubmed.ncbi.nlm.nih.gov/10089993/"
+  },
+  "sbc-ic-2018": {
+    abnt: "ROHDE, L. E. P. et al. Diretriz Brasileira de Insufici\xEAncia Card\xEDaca Cr\xF4nica e Aguda. Arquivos Brasileiros de Cardiologia, S\xE3o Paulo, v. 111, n. 3, p. 436-539, set. 2018.",
+    doi: "10.5935/abc.20180190",
+    key: "sbc-ic-2018",
+    url: "https://pubmed.ncbi.nlm.nih.gov/30379264/"
+  },
+  // ---------------------------------------------------------------------------
+  // Sociedade Brasileira de Cardiologia
+  // ---------------------------------------------------------------------------
+  "sbc-lipids-2017": {
+    abnt: "FALUDI, A. A. et al. Atualiza\xE7\xE3o da Diretriz Brasileira de Dislipidemias e Preven\xE7\xE3o da Aterosclerose \u2013 2017. Arquivos Brasileiros de Cardiologia, S\xE3o Paulo, v. 109, n. 2, supl. 1, p. 1-76, ago. 2017.",
+    doi: "10.5935/abc.20170121",
+    key: "sbc-lipids-2017",
+    url: "https://www.scielo.br/j/abc/a/whBsCyzTDzGYJcsBY7YVkWn/?lang=pt"
+  },
+  "sbc-lipids-2025": {
+    abnt: "RACHED, F. H. et al. Diretriz Brasileira de Dislipidemias e Preven\xE7\xE3o da Aterosclerose \u2013 2025. Arquivos Brasileiros de Cardiologia, S\xE3o Paulo, v. 122, n. 9, e20250640, out. 2025.",
+    doi: "10.36660/abc.20250640",
+    key: "sbc-lipids-2025",
+    url: "https://pmc.ncbi.nlm.nih.gov/articles/PMC12674852/"
+  },
+  // ---------------------------------------------------------------------------
+  // Sociedade Brasileira de Diabetes
+  // ---------------------------------------------------------------------------
+  "sbd-diabetes-2024": {
+    // Chave mantida como 'sbd-diabetes-2024' para compatibilidade com
+    // consumidores publicados; a diretriz correspondente é o documento vivo
+    // de diretriz.diabetes.org.br, cuja edição citada quando este registro foi
+    // atualizado é "Edição 2025". Semelhante ao caso de sbpc-ml-2021 abaixo.
+    abnt: "SOCIEDADE BRASILEIRA DE DIABETES (SBD). Diretriz da Sociedade Brasileira de Diabetes \u2014 Edi\xE7\xE3o 2025. S\xE3o Paulo: SBD, 2025.",
+    doi: "10.29327/5660187",
+    isbn: "978-65-272-1932-3",
+    key: "sbd-diabetes-2024",
+    url: "https://diretriz.diabetes.org.br"
+  },
+  // ---------------------------------------------------------------------------
+  // Sociedade Brasileira de Endocrinologia e Metabologia
+  // ---------------------------------------------------------------------------
+  "sbem-thyroid-2013": {
+    abnt: "SGARBI, J. A. et al. Consenso brasileiro para a abordagem cl\xEDnica e tratamento do hipotireoidismo subcl\xEDnico em adultos. Arquivos Brasileiros de Endocrinologia & Metabologia, v. 57, n. 3, p. 166-183, 2013.",
+    doi: "10.1590/S0004-27302013000300003",
+    key: "sbem-thyroid-2013",
+    url: "https://pubmed.ncbi.nlm.nih.gov/23681263/"
+  },
+  "sbem-vitamind-2014": {
+    abnt: "MAEDA, S. S. et al. Recomenda\xE7\xF5es da Sociedade Brasileira de Endocrinologia e Metabologia (SBEM) para o diagn\xF3stico e tratamento da hipovitaminose D. Arquivos Brasileiros de Endocrinologia & Metabologia, v. 58, n. 5, p. 411-433, 2014.",
+    doi: "10.1590/0004-2730000003388",
+    key: "sbem-vitamind-2014",
+    url: "https://pubmed.ncbi.nlm.nih.gov/25166032/"
+  },
+  // ---------------------------------------------------------------------------
+  // Sociedade Brasileira de Patologia Clínica / Medicina Laboratorial
+  // ---------------------------------------------------------------------------
+  "sbpc-ml-2021": {
+    // Chave mantida como 'sbpc-ml-2021' para compatibilidade com consumidores;
+    // a edição autoritativa é de 2020 (verificada na Biblioteca Digital SBPC/ML
+    // em 2026-04-18). Ano na citação ABNT reflete a edição real.
+    abnt: "SOCIEDADE BRASILEIRA DE PATOLOGIA CL\xCDNICA/MEDICINA LABORATORIAL (SBPC/ML). Recomenda\xE7\xF5es da Sociedade Brasileira de Patologia Cl\xEDnica/Medicina Laboratorial (SBPC/ML): Boas Pr\xE1ticas em Laborat\xF3rio Cl\xEDnico. S\xE3o Paulo: SBPC/ML, 2020.",
+    key: "sbpc-ml-2021",
+    url: "https://bibliotecasbpc.org.br/index.php?P=4&C=0.2.443"
+  },
+  "schumann-ifcc-ldh-2002": {
+    abnt: "SCHUMANN, G.; KLAUKE, R. New IFCC reference procedures for the determination of catalytic activity concentrations of five enzymes in serum: preliminary upper reference limits obtained in hospitalized subjects. Clinica Chimica Acta, v. 327, n. 1-2, p. 69-79, 2003.",
+    doi: "10.1016/S0009-8981(02)00341-8",
+    key: "schumann-ifcc-ldh-2002",
+    url: "https://pubmed.ncbi.nlm.nih.gov/12482620/"
+  },
+  "schwedhelm-sdma-2011": {
+    abnt: "SCHWEDHELM, E. et al. Plasma symmetric dimethylarginine reference limits from the Framingham Offspring Cohort. Clinical Chemistry and Laboratory Medicine, v. 49, n. 11, p. 1907-1910, 2011.",
+    doi: "10.1515/CCLM.2011.679",
+    key: "schwedhelm-sdma-2011",
+    url: "https://pubmed.ncbi.nlm.nih.gov/21864208/"
+  },
+  "selhub-homocysteine-1999": {
+    abnt: "SELHUB, J. et al. Serum total homocysteine concentrations in the third National Health and Nutrition Examination Survey (1991-1994): population reference ranges and contribution of vitamin status to high serum concentrations. Annals of Internal Medicine, v. 131, n. 5, p. 331-339, 1999.",
+    doi: "10.7326/0003-4819-131-5-199909070-00003",
+    key: "selhub-homocysteine-1999",
+    url: "https://pubmed.ncbi.nlm.nih.gov/10475885/"
+  },
+  "simopoulos-omega-ratio-2002": {
+    abnt: "SIMOPOULOS, A. P. The importance of the ratio of omega-6/omega-3 essential fatty acids. Biomedicine & Pharmacotherapy, v. 56, n. 8, p. 365-379, 2002.",
+    doi: "10.1016/S0753-3322(02)00253-6",
+    key: "simopoulos-omega-ratio-2002",
+    url: "https://pubmed.ncbi.nlm.nih.gov/12442909/"
+  },
+  // ---------------------------------------------------------------------------
+  // Fontes internacionais — Marcadores tumorais
+  // ---------------------------------------------------------------------------
+  "sturgeon-nacb-2008": {
+    abnt: "STURGEON, C. M. et al. National Academy of Clinical Biochemistry Laboratory Medicine Practice Guidelines for use of tumor markers in testicular, prostate, colorectal, breast, and ovarian cancers. Clinical Chemistry, v. 54, n. 12, p. e11-e79, 2008.",
+    doi: "10.1373/clinchem.2008.105601",
+    key: "sturgeon-nacb-2008",
+    url: "https://pubmed.ncbi.nlm.nih.gov/19042984/"
+  },
+  "tietz-7ed-2015": {
+    abnt: "BURTIS, C. A.; BRUNS, D. E. Tietz Fundamentals of Clinical Chemistry and Molecular Diagnostics. 7. ed. St. Louis: Elsevier Saunders, 2015.",
+    isbn: "978-1-4557-4165-6",
+    key: "tietz-7ed-2015"
+  },
+  "torrissen-omega3-dbs-2025": {
+    abnt: "TORRISSEN, M. et al. Global variations in omega-3 fatty acid status and omega-6:omega-3 ratios: insights from > 500,000 whole-blood dried blood spot samples. Lipids in Health and Disease, v. 24, n. 1, p. 260, 2025.",
+    doi: "10.1186/s12944-025-02676-6",
+    key: "torrissen-omega3-dbs-2025",
+    url: "https://pubmed.ncbi.nlm.nih.gov/40783537/"
+  },
+  // ---------------------------------------------------------------------------
+  // Fontes internacionais — Coagulação
+  // ---------------------------------------------------------------------------
+  "wells-ddimer-2003": {
+    abnt: "WELLS, P. S. et al. Evaluation of D-dimer in the diagnosis of suspected deep-vein thrombosis. New England Journal of Medicine, v. 349, p. 1227-1235, 2003.",
+    doi: "10.1056/NEJMoa023153",
+    key: "wells-ddimer-2003",
+    url: "https://pubmed.ncbi.nlm.nih.gov/14507948/"
+  },
+  // ---------------------------------------------------------------------------
+  // Fontes internacionais — OMS
+  // ---------------------------------------------------------------------------
+  "who-iron-2020": {
+    abnt: "WORLD HEALTH ORGANIZATION. WHO guideline on use of ferritin concentrations to assess iron status in individuals and populations. Geneva: WHO, 2020.",
+    isbn: "978-92-4-000012-4",
+    key: "who-iron-2020",
+    url: "https://www.who.int/publications/i/item/9789240000124"
+  },
+  "who-obesity-2000": {
+    abnt: "WORLD HEALTH ORGANIZATION. Obesity: preventing and managing the global epidemic. WHO Technical Report Series, n. 894. Geneva: WHO, 2000.",
+    isbn: "92-4-120894-5",
+    key: "who-obesity-2000"
+  },
+  "who-osteoporosis-1994": {
+    abnt: "WHO STUDY GROUP. Assessment of fracture risk and its application to screening for postmenopausal osteoporosis. WHO Technical Report Series, n. 843. Geneva: WHO, 1994.",
+    key: "who-osteoporosis-1994",
+    url: "https://pubmed.ncbi.nlm.nih.gov/7941614/"
+  }
+};
+function extractSourceKey(source2) {
+  return source2.split(":")[0] ?? source2;
+}
+
+// src/cli/commands/source.ts
+function render(ref) {
+  const linhas = [`Fonte: ${ref.key}`, "", ref.abnt];
+  if (ref.doi) linhas.push("", `DOI:  ${ref.doi}`);
+  if (ref.isbn) linhas.push(`ISBN: ${ref.isbn}`);
+  if (ref.url) linhas.push(`URL:  ${ref.url}`);
+  return linhas.join("\n");
+}
+async function source(args, json) {
+  const { positionals, values } = parseArgs3({
+    allowPositionals: true,
+    args,
+    options: { biomarker: { short: "b", type: "string" } },
+    strict: false
+  });
+  if (values.biomarker) {
+    const code = values.biomarker;
+    if (!getDefinitionByCode(code)) exitWithError(`Biomarcador n\xE3o encontrado: ${code}`);
+    const def = biomarkerRangeDefinitions[code];
+    if (!def?.source) exitWithError(`Sem faixa de refer\xEAncia com fonte para: ${code}`);
+    const chave2 = extractSourceKey(def.source);
+    const ref2 = SOURCE_REGISTRY[chave2];
+    if (!ref2) exitWithError(`Fonte n\xE3o encontrada no registro: ${chave2}`);
+    if (json) outputJson(ref2);
+    else outputText(render(ref2));
+    return;
+  }
+  const chave = positionals[0];
+  if (!chave) {
+    const todas = Object.values(SOURCE_REGISTRY).sort((a, b) => a.key.localeCompare(b.key));
+    if (json) {
+      outputJson(todas);
+      return;
+    }
+    outputText(
+      [
+        `Fontes no registro: ${todas.length}`,
+        "",
+        ...todas.map((r) => `  ${r.key.padEnd(28)} ${r.abnt.slice(0, 60)}\u2026`),
+        "",
+        "Detalhe de uma: fhir-bio source <chave>",
+        "A partir do exame:  fhir-bio source --biomarker TSH"
+      ].join("\n")
+    );
+    return;
+  }
+  const limpa = extractSourceKey(chave);
+  const ref = SOURCE_REGISTRY[limpa];
+  if (!ref) {
+    const alvo = limpa === chave ? chave : `${chave} (procurado como ${limpa})`;
+    exitWithError(`Fonte n\xE3o encontrada: ${alvo}
+Veja a lista com: fhir-bio source`);
+  }
+  if (json) outputJson(ref);
+  else outputText(render(ref));
+}
+
 // src/cli/commands/units.ts
 async function units(args, json) {
   const code = args[0];
@@ -6824,6 +7459,7 @@ Comandos:
   list                    Listar todos os biomarcadores
   categories              Listar biomarcadores agrupados por categoria
   range <c\xF3digo>          Faixa de refer\xEAncia para um biomarcador
+  source [chave]          Cita\xE7\xE3o de uma fonte, ou a lista toda
   units <c\xF3digo>          Informa\xE7\xF5es de unidade de um biomarcador
   convert <arquivo>       Converter dados lab (JSON) para FHIR Bundle
   validate <arquivo>      Validar recurso FHIR (Bundle, Observation ou DiagnosticReport)
@@ -6844,26 +7480,18 @@ var COMMANDS = {
   lookup,
   "lookup-loinc": lookupLoinc,
   range,
+  source,
   units,
   validate
 };
 async function main() {
-  const { positionals, values } = parseArgs3({
-    allowPositionals: true,
-    options: {
-      help: { default: false, short: "h", type: "boolean" },
-      json: { default: false, type: "boolean" },
-      version: { default: false, short: "v", type: "boolean" }
-    },
-    strict: false
-  });
-  if (values.version) {
-    process.stdout.write(`${"0.31.6"}
+  const { command, help, json, resto, version } = dividirArgv(process.argv.slice(2));
+  if (version) {
+    process.stdout.write(`${"0.33.0"}
 `);
     return;
   }
-  const [command, ...rest] = positionals;
-  if (values.help || !command) {
+  if (help || !command) {
     process.stdout.write(HELP);
     return;
   }
@@ -6872,6 +7500,6 @@ async function main() {
     exitWithError(`Comando desconhecido: ${command}
 Use --help para ver os comandos dispon\xEDveis.`);
   }
-  await handler(rest, Boolean(values.json));
+  await handler(resto, json);
 }
 main().catch((err) => exitWithError(err.message));