@inflexa-ai/harness 0.17.0 → 0.19.0

package/dist/workflows/target-assessment/assemblers/orchestrator.js

@@ -2,28 +2,46 @@
  * Phase-4 deterministic assemblers.
  *
  * Each assembler maps Phase-1 / Phase-2 / Phase-3 outputs onto the
- * corresponding dossier section schema. Coverage is honored end-to-end:
- * when an upstream came back `queried_no_data` or the derived row set is
- * empty, the section is marked `queried_no_data` / `not_loaded` rather
- * than fabricated. Aggregate rows preserve their contributing evidence
- * under `evidence: [...]` arrays.
+ * corresponding dossier section schema. Coverage is honored end-to-end: an
+ * upstream that came back empty or was never consulted yields
+ * `queried_no_data` / `not_loaded` rather than a fabricated section.
+ *
+ * Where a section applies a threshold of its own, the decision runs through
+ * `coverageFromFilteredRows` over both counts — what survived and what the
+ * threshold discarded — so a section our own filter emptied reports
+ * `filtered` rather than an `available` section holding nothing. Deciding
+ * coverage first and filtering the payload afterwards is the shape that loses
+ * that distinction.
+ *
+ * Aggregate rows preserve their contributing evidence under `evidence: [...]`
+ * arrays.
  */
+import { classifyClinicalEvidenceTrial, } from "../lib/clinical-evidence-attribution.js";
 import { inferTherapeuticArea, getBenchmarks, getDatasetAttribution } from "../../../tools/lib/clinical-benchmarks-client.js";
 import { inferModalityFromFamily } from "../../../tools/lib/protein-family-modality.js";
 import { resolveFamilySiblingUniprots, resolveOnTargetChemblIds } from "../lib/target-identity-filter.js";
 import { getDrugPrimaryTargetUniprots } from "../../../tools/lib/chembl-client.js";
 import { annotateOffTargetPanel } from "../lib/clinical-consequence-annotator.js";
-import { coverageFromRows } from "../coverage.js";
+import { coverageFromFilteredRows, coverageFromRows } from "../coverage.js";
+import { toOrganSystems } from "../lib/impc-organ-map.js";
 import { fetchRegulatoryActions } from "../lib/regulatory-actions.js";
 import { HIGH_EXPRESSION_TPM_THRESHOLD } from "../lib/expression-constants.js";
 export { HIGH_EXPRESSION_TPM_THRESHOLD };
 import { resolveModulatorMoleculeType } from "../lib/dedup-modulators.js";
 import { searchFailedTrialsForDrugNames } from "../../../tools/lib/clinical-trials-client.js";
-import { aggregateFaersAcrossModulators, aggregateTrialAes, aggregateOffTargetPanel, aggregateClassPrecedent, buildOrganRollup, assembleDrugInteractions, assembleLiabilitySummary, meetsTpmFloor, isSafetyRelevant, } from "./safety.js";
+import { aggregateFaersAcrossModulators, aggregateTrialAes, aggregateOffTargetPanel, aggregateClassPrecedent, buildOrganRollup, assembleDrugInteractions, assembleLiabilitySummary, claimSupportEvidence, meetsTpmFloor, isSafetyRelevant, resolveTissueOrganSystem, } from "./safety.js";
 import { assemblePreclinicalLiterature, assembleKoSupportingLiterature, tallyInternalReferences, assembleKeyPapers, assembleEvidenceTimeline, assembleTranslationalChain, assembleMolecularInteractions, assembleBiomarkerPotential, assembleResistanceEvidence, assembleCombinationEvidence, assembleEvidenceConflicts, assembleAdditionalEvidence, isSelfReference, isClinicalMeasurement, indicationCompositeScore, partitionTrialsByAttribution, classifyClinicalTrialConfidence, assembleDiscoveryTrials, dedupePpiPartners, } from "./literature.js";
 import { buildTrialOutcomeFilter, aggregateTrialOutcomes } from "./trials.js";
 import { buildFailureCategoryDiscriminated } from "./literature.js";
 const NOT_LOADED_PHASE5 = "Phase 5 synthesis not yet implemented";
+/** What emptied `clinical_development.trials` when nothing survived. */
+const ACTIVE_TRIALS_FILTER = "text match confidence below medium, attribution not eligible for toxicology aggregation, or attributed to a related family receptor";
+/** What emptied the two failed-trial sections when nothing survived. */
+const FAILED_TRIALS_FILTER = "attribution not eligible for toxicology aggregation, or attributed to a related family receptor";
+/** What emptied the two association sections when nothing survived. */
+const INDICATIONS_FILTER = "association restates the target itself, names a clinical measurement rather than a disease, or carries no scored evidence source";
+/** Sections the workflow body stamps between assembly and synthesis. */
+const NOT_LOADED_POST_ASSEMBLY = "assembled after Phase 4, from the segmented regulatory label signals";
 // Order matches evidence-priority rank: genetic > known_drug > animal_model > somatic > literature.
 function makeAssociationEvidence(a) {
     const out = [];
@@ -186,7 +204,7 @@ export function assembleTractability(resolved, ot, drugs) {
     ];
     const preferred = t.smallMolecule ? "small_molecule" : t.antibody ? "antibody" : t.otherModalities ? "other_clinical" : null;
     const modalitiesEnriched = enrichTractabilityModalitiesWithApprovals(modalities, drugs);
-    // Collect molecule types from approved/clinical drugs for the v4 field.
+    // Collect molecule types from approved/clinical drugs for the tractability field.
     const drugMoleculeTypes = [...new Set(drugs.map((d) => d.molecule_type).filter((m) => !!m))];
     return {
         coverage: "available",
@@ -241,7 +259,7 @@ export async function assembleDossier(pool, phase2, phase3, annotatorDeps) {
     const internalRefCounts = tallyInternalReferences([
         koSupportingLiterature,
         ...(organRollupRows ?? []).map((r) => r.evidence),
-        ...(offTargetRows ?? []).map((r) => r.evidence),
+        ...(offTargetRows ?? []).map((r) => claimSupportEvidence(r.support)),
     ]);
     const keyPapersRows = assembleKeyPapers(phase2, internalRefCounts);
     const evidenceTimeline = assembleEvidenceTimeline(phase2);
@@ -262,7 +280,6 @@ export async function assembleDossier(pool, phase2, phase3, annotatorDeps) {
     // receptor rather than the assessment target.
     const trialOutcomeFilter = await buildTrialOutcomeFilter(phase2, attrCtx, knownClassDrugNames, phase2.phase1.resolved.geneSymbol);
     const trialOutcomesRows = aggregateTrialOutcomes(fanout, trialOutcomeFilter);
-    const discoveryTrialData = await assembleDiscoveryTrials(phase2, phase2.phase1.resolved.geneSymbol, attrCtx, knownClassDrugNames);
     const resolved = phase2.phase1.resolved;
     const ot = phase2.phase1.collectors.opentargets;
     const ctgov = phase2.phase1.collectors.ctgov;
@@ -274,20 +291,99 @@ export async function assembleDossier(pool, phase2, phase3, annotatorDeps) {
     const pubmed = phase2.phase1.collectors.pubmedIndex;
     const pathways = phase2.phase1.collectors.pathways;
     const ppi = phase2.phase1.collectors.stringPpi;
+    // Every trial row carries its attribution from assembly onward: the
+    // evidence role decides whether a row supports the target or is context.
+    const knownClassDrugs = await Promise.all((drugInteractionRows ?? []).map(async (d) => {
+        const resolvedTargets = d.drug_id ? await getDrugPrimaryTargetUniprots(d.drug_id).catch(() => []) : [];
+        return {
+            name: d.drug_name,
+            moleculeChemblId: d.drug_id,
+            targetUniprots: resolvedTargets.length > 0 ? resolvedTargets : assessmentUniprot ? [assessmentUniprot] : [],
+        };
+    }));
+    const programsCollector = phase2.phase1.collectors.therapeuticPrograms;
+    const therapeuticPrograms = programsCollector?.coverage === "available"
+        ? programsCollector.data.programs.map((program) => ({
+            programId: program.programId,
+            name: program.name,
+            targetSymbol: program.targetSymbol,
+            targetUniprot: program.targetUniprot,
+            modality: program.modality,
+            nctIds: program.nctIds,
+        }))
+        : [];
+    const evidenceAttribution = {
+        assessmentSymbol: geneSymbol,
+        assessmentUniprot,
+        familyUniprots: familySiblingUniprots,
+        knownClassDrugs,
+        therapeuticPrograms,
+    };
+    const trialSourceByNct = new Map();
+    if (ctgov.coverage === "available") {
+        for (const t of [...ctgov.data.active, ...ctgov.data.failed])
+            trialSourceByNct.set(t.nctId, t);
+    }
+    const attachTrialAttribution = (row) => {
+        const source = trialSourceByNct.get(row.nct_id);
+        const classified = source
+            ? classifyClinicalEvidenceTrial(source, evidenceAttribution)
+            : {
+                attribution: {
+                    relationship: "unknown",
+                    evidence_role: "excluded",
+                    basis: [{ kind: "text_match", source: "ctgov" }],
+                    resolved_interventions: [],
+                    exclusion_reason: "no CT.gov record was available to attribute this trial to the assessed target",
+                },
+                eligible_for_toxicology_aggregation: false,
+            };
+        return {
+            ...row,
+            attribution: classified.attribution,
+            eligible_for_toxicology_aggregation: classified.eligible_for_toxicology_aggregation,
+        };
+    };
+    const discoveryTrials = await assembleDiscoveryTrials(phase2, phase2.phase1.resolved.geneSymbol, attrCtx, knownClassDrugNames, attachTrialAttribution);
     const indicationsRaw = ot.coverage === "available" ? ot.data.associations : [];
     const filteredIndications = indicationsRaw.filter((a) => !isSelfReference(resolved.canonicalId, a.diseaseId, resolved.geneSymbol, a.diseaseName) && !isClinicalMeasurement(a.diseaseName));
     const ta = inferTherapeuticArea(filteredIndications.map((a) => a.diseaseName));
     const benchmarks = getBenchmarks(ta);
     const datasetAttr = getDatasetAttribution();
-    const offTissueRows = expression.coverage === "available"
-        ? expression.data.tissues
-            .filter((t) => meetsTpmFloor(t.tissueLabel, t.value ?? 0) && isSafetyRelevant(t.tissueLabel, t.organSystem))
-            .map((t) => ({
-            tissue: t.tissueLabel,
-            organ: t.organSystem ?? "unspecified",
-            tpm: t.value ?? 0,
-        }))
+    const offTissueCandidates = expression.coverage === "available"
+        ? expression.data.tissues.filter((t) => meetsTpmFloor(t.tissueLabel, t.value ?? 0) && isSafetyRelevant(t.tissueLabel, t.organSystem))
         : [];
+    // A tissue whose anatomy does not resolve onto an organ system is dropped
+    // rather than filed under a neighbouring organ; the count is reported so
+    // the section does not overstate its own completeness.
+    const offTissueRows = offTissueCandidates.flatMap((t) => {
+        const organ = resolveTissueOrganSystem(t.tissueLabel, t.organSystem);
+        if (!organ)
+            return [];
+        const support = {
+            state: "unknown",
+            reason: `${t.tissueLabel} expression is a measured value from the expression atlas, not a citable per-tissue record`,
+        };
+        return [{ tissue: t.tissueLabel, organ, tpm: t.value ?? 0, support }];
+    });
+    const offTissueDroppedCount = offTissueCandidates.length - offTissueRows.length;
+    // Candidates that all failed to resolve leave the section empty for a
+    // reason of our own making, not because the atlas held nothing.
+    const offTissueSection = expression.coverage !== "available"
+        ? { coverage: "queried_no_data" }
+        : offTissueRows.length > 0
+            ? {
+                coverage: "available",
+                data: { rows: offTissueRows },
+                ...(offTissueDroppedCount > 0 ? { dropped_count: offTissueDroppedCount } : {}),
+            }
+            : offTissueDroppedCount > 0
+                ? {
+                    coverage: "filtered",
+                    filter: "tissue anatomy did not resolve onto an organ system",
+                    dropped_count: offTissueDroppedCount,
+                }
+                : { coverage: "queried_no_data" };
     const drugsForTractability = enrichedModulators.map((m) => ({
         drug_id: m.moleculeChemblId,
         drug_name: m.preferredName,
@@ -334,6 +430,9 @@ export async function assembleDossier(pool, phase2, phase3, annotatorDeps) {
     // cannot fire and all trials land in primary — off-target detection activates
     // only when ChEMBL IDs are available downstream.
     const activeTrialsPartitioned = ctgov.coverage === "available" ? await partitionTrialsByAttribution(ctgov.data.active, attrCtx) : null;
+    // Everything CT.gov offered before any threshold of ours ran — the baseline
+    // the trials section measures its own drops against.
+    const activeTrialCandidateCount = (activeTrialsPartitioned?.primary.length ?? 0) + (activeTrialsPartitioned?.related.length ?? 0);
     // Map ctgov active trials to clinical-trial row shape with text-based confidence,
     // then remove rows identified as off-target by the attribution filter.
     // Drug-in-class matches (calcitonin drugs for CALCR, GLP-1 drugs for GLP1R, etc.)
@@ -418,17 +517,37 @@ export async function assembleDossier(pool, phase2, phase3, annotatorDeps) {
         failure_category: t.failure_category,
         classifier: t.classifier,
     })) ?? [];
+    const attributedFailedRows = failedTrialRows.map(attachTrialAttribution);
+    const attributedFailedRelatedRows = failedRelatedRows.map(attachTrialAttribution);
+    // The same partition the clinical-development section reports, shared with the
+    // safety lens: a related-receptor failure is context for both, and it must be
+    // told apart from a target-attributed one in both.
+    const eligibleFailedRows = attributedFailedRows.filter((r) => r.eligible_for_toxicology_aggregation);
+    const excludedFailedRows = [...attributedFailedRows.filter((r) => !r.eligible_for_toxicology_aggregation), ...attributedFailedRelatedRows];
+    // `clinical_development.failed_trials` and `safety_profile.failed_trials_safety_lens`
+    // report the same partition under two headings, so the section is decided once.
+    // Two constructions of it would let the same condition report two coverages.
+    const failedTrialsSection = ctgov.coverage === "available"
+        ? coverageFromFilteredRows({
+            data: {
+                rows: eligibleFailedRows,
+                excluded_rows: excludedFailedRows,
+            },
+            retainedCount: eligibleFailedRows.length,
+            droppedCount: excludedFailedRows.length,
+            filter: FAILED_TRIALS_FILTER,
+            emptyReason: "ClinicalTrials.gov returned no terminated or withdrawn trials for the assessment target",
+        })
+        : { coverage: "queried_no_data", error: { message: "ClinicalTrials.gov unavailable" } };
     // Typed explicitly so literal string coverage values narrow correctly.
     // Phase-5 persist attaches the derived sub-tree after synthesis is stamped.
     const dossierBody = {
-        schema_version: "4",
         generated_at: new Date().toISOString(),
         entity: assembleEntity(resolved),
         liability_summary: liabilitySummary,
         tractability: tractabilitySection,
         indications: ot.coverage === "available"
-            ? {
-                coverage: "available",
+            ? coverageFromFilteredRows({
                 data: {
                     rows: indicationRows,
                     excluded_unsupported_count: unsupportedCandidates.length,
@@ -441,7 +560,13 @@ export async function assembleDossier(pool, phase2, phase3, annotatorDeps) {
                         }
                         : {}),
                 },
-            }
+                retainedCount: indicationRows.length,
+                // The head cap is a carrying limit rather than a judgement, so
+                // only the two content filters count against completeness.
+                droppedCount: indicationsRaw.length - filteredIndications.length + unsupportedCandidates.length,
+                filter: INDICATIONS_FILTER,
+                emptyReason: "Open Targets returned no disease associations for the target",
+            })
             : {
                 coverage: "queried_no_data",
                 error: {
@@ -455,55 +580,43 @@ export async function assembleDossier(pool, phase2, phase3, annotatorDeps) {
             trials: clinicalTrialRows === null
                 ? { coverage: "queried_no_data", error: { message: "ClinicalTrials.gov unavailable" } }
                 : (() => {
-                    const base = coverageFromRows(clinicalTrialRows, { reason: "no trials matched the assessment target with confidence ≥ medium" });
-                    if (base.coverage !== "available")
-                        return base;
-                    return {
-                        coverage: "available",
+                    const attributed = clinicalTrialRows.map(attachTrialAttribution);
+                    const relatedTargetTrials = (activeTrialsPartitioned?.related ?? []).map((t) => attachTrialAttribution({
+                        nct_id: t.nctId,
+                        title: t.title,
+                        phase: t.phase,
+                        status: t.status,
+                        conditions: t.conditions,
+                        start_date: t.startDate,
+                        completion_date: t.primaryCompletionDate,
+                        match_confidence: "off_target",
+                    }));
+                    const rows = attributed.filter((r) => r.eligible_for_toxicology_aggregation);
+                    return coverageFromFilteredRows({
                         data: {
-                            rows: base.data.rows,
+                            rows,
+                            excluded_rows: [...attributed.filter((r) => !r.eligible_for_toxicology_aggregation), ...relatedTargetTrials],
                             selection_criteria: {
                                 derived_from: "analytics.discovery_trials",
                                 min_confidence: "medium",
                                 excluded_off_target_count: activeTrialsPartitioned?.related.length ?? 0,
                             },
-                            ...(activeTrialsPartitioned && activeTrialsPartitioned.related.length > 0
-                                ? {
-                                    related_target_trials: activeTrialsPartitioned.related.map((t) => ({
-                                        nct_id: t.nctId,
-                                        title: t.title,
-                                        phase: t.phase,
-                                        status: t.status,
-                                        conditions: t.conditions,
-                                        start_date: t.startDate,
-                                        completion_date: t.primaryCompletionDate,
-                                        match_confidence: "off_target",
-                                    })),
-                                    related_receptor: activeTrialsPartitioned.related_receptor,
-                                }
-                                : {}),
                         },
-                    };
+                        retainedCount: rows.length,
+                        // Everything CT.gov returned for the target, against what survived:
+                        // the low-confidence cut, the attribution cut, and the related-receptor
+                        // partition are all filters of ours.
+                        droppedCount: activeTrialCandidateCount - rows.length,
+                        filter: ACTIVE_TRIALS_FILTER,
+                        emptyReason: "ClinicalTrials.gov returned no trials for the assessment target",
+                    });
                 })(),
             outcomes: trialOutcomesRows
-                ? { coverage: "available", data: { rows: trialOutcomesRows } }
+                ? { coverage: "available", data: { rows: trialOutcomesRows.map(attachTrialAttribution) } }
                 : phase3
                     ? { coverage: "queried_no_data", error: { message: "no per-trial outcomes available" } }
                     : { coverage: "not_loaded", reason: "Phase-3 fan-out not run" },
-            failed_trials: ctgov.coverage === "available"
-                ? {
-                    coverage: "available",
-                    data: {
-                        rows: failedTrialRows,
-                        ...(failedRelatedRows.length > 0
-                            ? {
-                                related_target_trials: failedRelatedRows,
-                                related_receptor: failedTrialsPartitioned?.related_receptor,
-                            }
-                            : {}),
-                    },
-                }
-                : { coverage: "queried_no_data" },
+            failed_trials: failedTrialsSection,
             benchmarks: {
                 therapeutic_area: benchmarks.therapeutic_area,
                 fallback_to_all_areas: benchmarks.source === "fallback",
@@ -541,33 +654,28 @@ export async function assembleDossier(pool, phase2, phase3, annotatorDeps) {
                 : phase3
                     ? { coverage: "queried_no_data", error: { message: "no off-target data" } }
                     : { coverage: "not_loaded", reason: "Phase-3 fan-out not run" },
-            failed_trials_safety_lens: ctgov.coverage === "available" && failedTrialRows.length > 0
-                ? {
-                    coverage: "available",
-                    data: {
-                        rows: failedTrialRows,
-                        ...(failedRelatedRows.length > 0
-                            ? {
-                                related_target_trials: failedRelatedRows,
-                                related_receptor: failedTrialsPartitioned?.related_receptor,
-                            }
-                            : {}),
-                    },
-                }
-                : ctgov.coverage === "available"
-                    ? { coverage: "queried_no_data", error: { message: "no failed trials" } }
-                    : { coverage: "queried_no_data", error: { message: "ClinicalTrials.gov unavailable" } },
+            // The safety lens carries the same two buckets as
+            // `clinical_development.failed_trials`. Merging them would put a
+            // related-receptor termination in the same list as a target-attributed
+            // one, and the reader has no other way to tell them apart.
+            failed_trials_safety_lens: failedTrialsSection,
             class_precedent: classP
                 ? { coverage: "available", data: classP }
                 : phase3
                     ? { coverage: "queried_no_data", error: { message: "no class precedent data" } }
                     : { coverage: "not_loaded", reason: "Phase-3 fan-out not run" },
-            target_organ_liabilities: [],
+            // Stamped by Phase 5 after the safety-flags-trail agent runs.
+            target_organ_liabilities: { coverage: "not_loaded", reason: NOT_LOADED_PHASE5 },
             regulatory_actions: regulatoryActionRows.length > 0
                 ? { coverage: "available", data: { rows: regulatoryActionRows } }
                 : { coverage: "queried_no_data" },
         },
-        off_tissue_risk: expression.coverage === "available" ? { coverage: "available", data: { rows: offTissueRows } } : { coverage: "queried_no_data" },
+        // The corroboration fold reads the FDA label signals segmented after
+        // Phase 4, and the claim investigation reads the fold, so both are
+        // stamped by the workflow body before synthesis runs.
+        safety_corroboration: { coverage: "not_loaded", reason: NOT_LOADED_POST_ASSEMBLY },
+        claim_investigation: { coverage: "not_loaded", reason: "the claim investigation runs after Phase 4, over the corroborated organ claims" },
+        off_tissue_risk: offTissueSection,
         off_target_panel: offTargetPanel
             ? { coverage: "available", data: offTargetPanel }
             : phase3
@@ -575,8 +683,7 @@ export async function assembleDossier(pool, phase2, phase3, annotatorDeps) {
                 : { coverage: "not_loaded", reason: "Phase-3 fan-out not run" },
         reference_biology: {
             therapeutic_area_associations: ot.coverage === "available"
-                ? {
-                    coverage: "available",
+                ? coverageFromFilteredRows({
                     data: {
                         rows: filteredIndications.slice(0, 200).map((a) => {
                             const evidence = makeAssociationEvidence(a);
@@ -603,7 +710,11 @@ export async function assembleDossier(pool, phase2, phase3, annotatorDeps) {
                             };
                         }),
                     },
-                }
+                    retainedCount: Math.min(filteredIndications.length, 200),
+                    droppedCount: indicationsRaw.length - filteredIndications.length,
+                    filter: INDICATIONS_FILTER,
+                    emptyReason: "Open Targets returned no disease associations for the target",
+                })
                 : { coverage: "queried_no_data" },
             molecular_interactions: (() => {
                 const rows = assembleMolecularInteractions(phase2, fanout);
@@ -695,7 +806,7 @@ export async function assembleDossier(pool, phase2, phase3, annotatorDeps) {
                             marker_symbol: impc.data.mouseMarkerSymbol,
                             viability: impc.data.viability,
                             sex_dimorphism: impc.data.sexDimorphic,
-                            organ_systems_with_phenotype: impc.data.organSystems,
+                            organ_systems_with_phenotype: toOrganSystems(impc.data.organSystems),
                             top_mp_terms: impc.data.mpTerms.slice(0, 25).map((m) => m.term),
                             total_phenotype_count: impc.data.phenotypeCount,
                             pre_weaning_lethal: impc.data.viability === "lethal_pre_weaning",
@@ -769,11 +880,10 @@ export async function assembleDossier(pool, phase2, phase3, annotatorDeps) {
                 const data = assembleAdditionalEvidence(phase2);
                 return data ? { coverage: "available", data } : { coverage: "queried_no_data" };
             })(),
-            discovery_trials: discoveryTrialData
-                ? { coverage: "available", data: discoveryTrialData }
-                : { coverage: "queried_no_data", error: { message: "no medium/low-confidence trials" } },
+            discovery_trials: discoveryTrials,
             // Stamped by Phase 5 after synthesis agents run; not available at assembly time.
             synthesis_diagnostics: { coverage: "not_loaded", reason: "Phase-5 synthesis not yet run" },
+            quality_gates: { coverage: "not_loaded", reason: "Phase-5 synthesis not yet run" },
         },
         // Stamped by Phase 5 after the dossier-recommendation agent runs.
         executive_recommendation: { coverage: "not_loaded", reason: "Phase-5 synthesis not yet run" },
@@ -785,7 +895,7 @@ export async function assembleDossier(pool, phase2, phase3, annotatorDeps) {
  *
  * When target-level FAERS has data (coverage: "available"), pass through
  * unchanged. When class_precedent has FAERS-derived reports in per_organ,
- * fold them into a class-scoped FaersSummaryV4 payload with
+ * fold them into a class-scoped FAERS summary payload with
  * coverage: "available" and inference_path tagged — rather than leaving
  * the section as queried_no_data, which creates an evidence conflict
  * that the conflict-detector flags. When neither has data, return