@peopl-health/nexus 5.44.0-dev.5124 → 5.44.0-dev.5142

package/lib/clinical/services/ctcaeTermService.js

@@ -0,0 +1,44 @@
+const { getCtcaeCatalog } = require('../stores/CtcaeCatalog');
+
+const FREE_TERM = 'other';
+
+// listed, not inferred: a prefix rule would pull chest_wall_pain into pain
+const KNOWN_ALIASES = {
+  rash: 'skin_rash',
+  palmar_plantar_erythrodysesthesia_syndrome: 'palmar_plantar_erythrodysesthesia',
+};
+
+function normalise(term) {
+  return String(term || '').trim().toLowerCase().replace(/[^a-z0-9]/g, '');
+}
+
+function curatedAliasFor(ctcaeTerm) {
+  const term = String(ctcaeTerm || '').trim().toLowerCase();
+  if (!term || term === FREE_TERM) return null;
+  let keys;
+  try {
+    const catalog = getCtcaeCatalog();
+    if (catalog.lookupEntry(term)?.found) return null;
+    keys = [...catalog.getCuratedSymptomsByTerm().keys()];
+  } catch {
+    return null;
+  }
+  const alias = KNOWN_ALIASES[term];
+  if (alias && keys.includes(alias)) return alias;
+  const wanted = normalise(term);
+  return keys.find((key) => normalise(key) === wanted) || null;
+}
+
+function ctcaeTermError(ctcaeTerm) {
+  const alias = curatedAliasFor(ctcaeTerm);
+  if (!alias) return null;
+  return {
+    error: `'${ctcaeTerm}' is the catalog term '${alias}' written differently. Use '${alias}' so this case joins the existing one and carries its grade scale.`,
+    useInstead: alias,
+  };
+}
+
+module.exports = {
+  curatedAliasFor,
+  ctcaeTermError,
+};

package/lib/clinical/tools/openConditionTool.js

@@ -5,6 +5,7 @@ const { ceilingGapError } = require('../helpers/ceilingGapHelper');
 const { mentionProvenanceError } = require('../helpers/evidenceAnchorHelper');
 const { gradeSourceError } = require('../services/gradeSourceService');
 const { gradeAnchorError, hasCuratedLadder } = require('../services/gradeAnchorService');
+const { ctcaeTermError } = require('../services/ctcaeTermService');
 const { armOpenCeilingNet } = require('../services/contingencyDispatchService');
 const { readSymptomCases, storeSymptomCase } = require('../../fhir');
 const { ManagedSymptom, OPEN_STATUSES, FUNCTIONAL_ANCHORS } = require('../../shared/dtos/ManagedSymptom');
@@ -71,6 +72,11 @@ async function handler(args = {}, context = {}) {
     if (missing.length) {
       return JSON.stringify({ success: false, error: `missing required field(s): ${missing.join(', ')}`, data: {} });
     }
+    const termGap = ctcaeTermError(ctcaeTerm);
+    if (termGap) {
+      return JSON.stringify({ success: false, error: termGap.error, data: { use_instead: termGap.useInstead } });
+    }
+
     const patientId = runtime.patientCode;
     const casesForTerm = await readSymptomCases({ patientId, ctcaeTerm });
     const openCase = casesForTerm.find((symptomCase) => OPEN_STATUSES.includes(symptomCase.condition.clinicalStatus));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peopl-health/nexus",
-  "version": "5.44.0-dev.5124",
+  "version": "5.44.0-dev.5142",
   "description": "Core messaging and assistant library for WhatsApp communication platforms",
   "keywords": [
     "whatsapp",