placementt-core 1.400.1120 → 1.400.1121

package/lib/callables/he.d.ts

@@ -1,18 +1,4 @@
 import { z } from "zod";
-/**
- * Contracts for the `he` backend module
- * (`Placementt-Backend/functions/src/heImport.ts`).
- *
- * Admin-only controls for the weekly mirror of the HESA Discover Uni dataset
- * into `heCourses` / `heProviders`. The status document (`heMeta/status`) is
- * the source of truth the admin card reads live, so the responses only echo
- * enough to confirm the call landed - an import can outlive the client's
- * callable deadline and the card still resolves.
- */
-/** Every enrichment source, in the order the admin card lists them. The
- * orchestrator runs "areas" first (the city sources key on its output) and
- * "finalise" last. */
-export declare const HE_ENRICHMENT_SOURCES: readonly ["areas", "hesaSsr", "hesaFinance", "hesaStudents", "wideningParticipation", "openAlex", "rent", "crime", "localJobs", "weather", "amenities", "population", "finalise"];
 export declare const heCallables: {
     /** Run a full import now. `storagePath` names a zip already uploaded to
      * Cloud Storage (`heImports/<file>.zip`) to use instead of the URL in
@@ -93,33 +79,6 @@ export declare const heCallables: {
             };
         }>;
     };
-    /**
-     * Run the university enrichment: one status entry per source in
-     * `heMeta/enrichmentStatus`, one Cloud Task per source, then a finalise
-     * task that computes provider / area percentiles and reapplies course
-     * percentiles. `sources` limits the run to those sources (a retry of the
-     * ones that failed); omitted, every source runs. Returns as soon as the
-     * tasks are queued; the admin card follows the status document.
-     */
-    "he-runEnrichment": {
-        request: z.ZodObject<{
-            sources: z.ZodOptional<z.ZodArray<z.ZodEnum<["areas", "hesaSsr", "hesaFinance", "hesaStudents", "wideningParticipation", "openAlex", "rent", "crime", "localJobs", "weather", "amenities", "population", "finalise"]>, "many">>;
-        }, "strip", z.ZodTypeAny, {
-            sources?: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[] | undefined;
-        }, {
-            sources?: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[] | undefined;
-        }>;
-        response: z.ZodObject<{
-            runId: z.ZodString;
-            queued: z.ZodArray<z.ZodEnum<["areas", "hesaSsr", "hesaFinance", "hesaStudents", "wideningParticipation", "openAlex", "rent", "crime", "localJobs", "weather", "amenities", "population", "finalise"]>, "many">;
-        }, "strip", z.ZodTypeAny, {
-            runId: string;
-            queued: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[];
-        }, {
-            runId: string;
-            queued: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[];
-        }>;
-    };
     /** Clear a stuck "running" state. The mirror and its manifest are left
      * alone. */
     "he-resetRun": {

package/lib/callables/he.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.heCallables = exports.HE_ENRICHMENT_SOURCES = void 0;
+exports.heCallables = void 0;
 const zod_1 = require("zod");
 /**
  * Contracts for the `he` backend module
@@ -12,11 +12,6 @@ const zod_1 = require("zod");
  * enough to confirm the call landed - an import can outlive the client's
  * callable deadline and the card still resolves.
  */
-/** Every enrichment source, in the order the admin card lists them. The
- * orchestrator runs "areas" first (the city sources key on its output) and
- * "finalise" last. */
-exports.HE_ENRICHMENT_SOURCES = ["areas", "hesaSsr", "hesaFinance", "hesaStudents", "wideningParticipation",
-    "openAlex", "rent", "crime", "localJobs", "weather", "amenities", "population", "finalise"];
 const importCounts = zod_1.z.object({
     coursesAssembled: zod_1.z.number(),
     coursesWritten: zod_1.z.number(),
@@ -44,23 +39,6 @@ exports.heCallables = {
             counts: importCounts,
         }),
     },
-    /**
-     * Run the university enrichment: one status entry per source in
-     * `heMeta/enrichmentStatus`, one Cloud Task per source, then a finalise
-     * task that computes provider / area percentiles and reapplies course
-     * percentiles. `sources` limits the run to those sources (a retry of the
-     * ones that failed); omitted, every source runs. Returns as soon as the
-     * tasks are queued; the admin card follows the status document.
-     */
-    "he-runEnrichment": {
-        request: zod_1.z.object({
-            sources: zod_1.z.array(zod_1.z.enum(exports.HE_ENRICHMENT_SOURCES)).optional(),
-        }),
-        response: zod_1.z.object({
-            runId: zod_1.z.string(),
-            queued: zod_1.z.array(zod_1.z.enum(exports.HE_ENRICHMENT_SOURCES)),
-        }),
-    },
     /** Clear a stuck "running" state. The mirror and its manifest are left
      * alone. */
     "he-resetRun": {

package/lib/callables/he.js.map

@@ -1 +1 @@
-{"version":3,"file":"he.js","sourceRoot":"","sources":["../../src/callables/he.ts"],"names":[],"mappings":";;;AAAA,6BAAsB;AAGtB;;;;;;;;;GASG;AAEH;;sBAEsB;AACT,QAAA,qBAAqB,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,uBAAuB;IAC5G,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,CAAU,CAAC;AAEzG,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1B,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE;IAC5B,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE;IAC1B,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE;IAC5B,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE;IAC1B,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE;IAC5B,kBAAkB,EAAE,OAAC,CAAC,MAAM,EAAE;CACjC,CAAC,CAAC;AAEU,QAAA,WAAW,GAAG;IACvB;;;4BAGwB;IACxB,cAAc,EAAE;QACZ,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;YACd,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACrC,CAAC;QACF,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;YACjB,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE;YAC1B,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;gBACb,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;gBAChC,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;aAClB,CAAC;YACF,MAAM,EAAE,YAAY;SACvB,CAAC;KACL;IACD;;;;;;;OAOG;IACH,kBAAkB,EAAE;QAChB,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;YACd,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,6BAAqB,CAAC,CAAC,CAAC,QAAQ,EAAE;SAC7D,CAAC;QACF,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;YACjB,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,6BAAqB,CAAC,CAAC;SACjD,CAAC;KACL;IACD;gBACY;IACZ,aAAa,EAAE;QACX,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACrB,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,EAAE,EAAE,OAAC,CAAC,OAAO,CAAC,IAAI,CAAC;SACtB,CAAC;KACL;CACoB,CAAC"}
+{"version":3,"file":"he.js","sourceRoot":"","sources":["../../src/callables/he.ts"],"names":[],"mappings":";;;AAAA,6BAAsB;AAGtB;;;;;;;;;GASG;AAEH,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1B,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE;IAC5B,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE;IAC1B,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE;IAC5B,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE;IAC1B,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE;IAC5B,kBAAkB,EAAE,OAAC,CAAC,MAAM,EAAE;CACjC,CAAC,CAAC;AAEU,QAAA,WAAW,GAAG;IACvB;;;4BAGwB;IACxB,cAAc,EAAE;QACZ,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;YACd,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACrC,CAAC;QACF,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;YACjB,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE;YAC1B,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;gBACb,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;gBAChC,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;aAClB,CAAC;YACF,MAAM,EAAE,YAAY;SACvB,CAAC;KACL;IACD;gBACY;IACZ,aAAa,EAAE;QACX,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACrB,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,EAAE,EAAE,OAAC,CAAC,OAAO,CAAC,IAAI,CAAC;SACtB,CAAC;KACL;CACoB,CAAC"}

package/lib/callables/registry.d.ts

@@ -618,25 +618,6 @@ export declare const allCallables: {
             };
         }>;
     };
-    "he-runEnrichment": {
-        request: z.ZodObject<{
-            sources: z.ZodOptional<z.ZodArray<z.ZodEnum<["areas", "hesaSsr", "hesaFinance", "hesaStudents", "wideningParticipation", "openAlex", "rent", "crime", "localJobs", "weather", "amenities", "population", "finalise"]>, "many">>;
-        }, "strip", z.ZodTypeAny, {
-            sources?: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[] | undefined;
-        }, {
-            sources?: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[] | undefined;
-        }>;
-        response: z.ZodObject<{
-            runId: z.ZodString;
-            queued: z.ZodArray<z.ZodEnum<["areas", "hesaSsr", "hesaFinance", "hesaStudents", "wideningParticipation", "openAlex", "rent", "crime", "localJobs", "weather", "amenities", "population", "finalise"]>, "many">;
-        }, "strip", z.ZodTypeAny, {
-            runId: string;
-            queued: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[];
-        }, {
-            runId: string;
-            queued: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[];
-        }>;
-    };
     "he-resetRun": {
         request: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
         response: z.ZodObject<{
@@ -2373,25 +2354,6 @@ export declare const callableGroups: {
                 };
             }>;
         };
-        "he-runEnrichment": {
-            request: z.ZodObject<{
-                sources: z.ZodOptional<z.ZodArray<z.ZodEnum<["areas", "hesaSsr", "hesaFinance", "hesaStudents", "wideningParticipation", "openAlex", "rent", "crime", "localJobs", "weather", "amenities", "population", "finalise"]>, "many">>;
-            }, "strip", z.ZodTypeAny, {
-                sources?: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[] | undefined;
-            }, {
-                sources?: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[] | undefined;
-            }>;
-            response: z.ZodObject<{
-                runId: z.ZodString;
-                queued: z.ZodArray<z.ZodEnum<["areas", "hesaSsr", "hesaFinance", "hesaStudents", "wideningParticipation", "openAlex", "rent", "crime", "localJobs", "weather", "amenities", "population", "finalise"]>, "many">;
-            }, "strip", z.ZodTypeAny, {
-                runId: string;
-                queued: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[];
-            }, {
-                runId: string;
-                queued: ("areas" | "hesaSsr" | "hesaFinance" | "hesaStudents" | "wideningParticipation" | "openAlex" | "rent" | "crime" | "localJobs" | "weather" | "amenities" | "population" | "finalise")[];
-            }>;
-        };
         "he-resetRun": {
             request: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
             response: z.ZodObject<{

package/lib/heRanking.d.ts

@@ -1,15 +1,33 @@
-import { HeArea, HeCourse, HePriority, HeProvider } from "./typeDefinitions";
-/** Metrics with fewer respondents than this get no percentile. */
+/**
+ * University priorities: the NSS questions that matter most to a student,
+ * course percentiles within a subject, ranking and comparison helpers.
+ *
+ * A student picks up to five NSS questions (HE_PRIORITIES, reworded for a 17
+ * year old with the original wording kept for tooltips). Every course carries
+ * `pct`: the percentile of each NSS question's agreement within its CAH
+ * subject, written by the Discover Uni import. A course's score is the mean
+ * percentile of the picks it has data for; a pick with no data (suppressed,
+ * or too few respondents) is left out of the mean and counted, never treated
+ * as zero, so missing data cannot drag a course down.
+ *
+ * Everything here is pure: the backend uses `coursePercentiles` when it
+ * writes `pct`, and the web ranks Algolia hits with `rankCourses`.
+ *
+ * Data is © HESA, licensed under CC BY 4.0: every surface showing it carries
+ * HE_ATTRIBUTION.
+ */
+import { HeCourse, HePriority, HePriorityGroup } from "./typeDefinitions";
+/** NSS questions with fewer respondents than this get no percentile. */
 export declare const HE_MIN_RESPONSES = 20;
-/** A CAH group needs at least this many courses carrying a metric before
- * courses are ranked within it; smaller groups fall back to the parent. */
+/** A CAH group needs at least this many courses with an answer before courses
+ * are ranked within it; smaller groups fall back to the parent. */
 export declare const HE_MIN_COHORT = 10;
 /** How many priorities a student can pick. */
 export declare const HE_MAX_PRIORITIES = 5;
 /** How many courses a comparison holds. */
 export declare const HE_MAX_COMPARE = 3;
-/** OpenStreetMap counts are taken within this radius of an area's centre. */
-export declare const HE_AMENITY_RADIUS_KM = 2;
+/** Attribution for every surface showing Discover Uni data. */
+export declare const HE_ATTRIBUTION: string;
 /** CAH level-1 subjects, for the subject picker and the `subjectGroups`
  * facet. */
 export declare const CAH_SUBJECTS: {
@@ -36,6 +54,14 @@ export declare function subjectsForCategories(categories: string[]): string[];
  * @return {string[]} sorted, de-duplicated codes.
  */
 export declare function subjectGroupsFor(subjects: string[]): string[];
+/**
+ * The CAH level-1, level-2 and level-3 codes of a subject, most specific
+ * first. A malformed code yields just itself.
+ *
+ * @param {string} cah a CAH code at any level, e.g. "CAH10-01-02".
+ * @return {string[]} e.g. ["CAH10-01-02", "CAH10-01", "CAH10"].
+ */
+export declare function cahAncestors(cah: string): string[];
 /** Original NSS question text, for tooltips. Mirrors the importer's list. */
 export declare const NSS_QUESTION_TEXT: {
     [code: string]: string;
@@ -48,12 +74,8 @@ export declare const NSS_QUESTION_TEXT: {
  */
 export declare const nssMetricId: (code: string) => string;
 /** Groups in picker order. */
-export declare const HE_PRIORITY_GROUPS: HePriority["group"][];
-/**
- * Every priority a student can pick. Research has no rankable entry yet: REF
- * 2021 results need UKRI's written permission for commercial use, and
- * OpenAlex research profiles are shown, never ranked.
- */
+export declare const HE_PRIORITY_GROUPS: HePriorityGroup[];
+/** Every NSS question a student can pick, in question order. */
 export declare const HE_PRIORITIES: HePriority[];
 /** Priorities by id. */
 export declare const HE_PRIORITY_BY_ID: {
@@ -62,53 +84,27 @@ export declare const HE_PRIORITY_BY_ID: {
 /**
  * Keep only known priority ids, de-duplicated, capped at HE_MAX_PRIORITIES,
  * in the order given. Used before saving and before ranking, so a stale id
- * (a priority since retired) is dropped rather than breaking the page.
+ * is dropped rather than breaking the page.
  *
  * @param {string[]|undefined} ids what the student picked.
  * @return {string[]} the valid picks.
  */
 export declare function cleanPriorities(ids: string[] | undefined): string[];
-/** One metric value and the respondents behind it (null when unknown). */
+/** One question's agreement and the respondents behind it (null when unknown). */
 export type HeMetricValue = {
     value: number;
     n: number | null;
 };
 /**
- * The raw value of every course-level metric on a course, with its
- * respondent count. Metrics with no value are absent.
+ * Each NSS question's agreement on a course, keyed by metric id, with the
+ * respondent count. Questions with no value are absent.
  *
- * @param {object} course the course fields the metrics read.
+ * @param {object} course the course's NSS fields.
  * @return {object} metric id -> value and respondents.
  */
-export declare function courseMetricValues(course: Partial<HeCourse>): {
+export declare function nssMetricValues(course: Pick<Partial<HeCourse>, "nss" | "nssResponses" | "nssPopulation" | "nssResponseRate">): {
     [metricId: string]: HeMetricValue;
 };
-/**
- * The TEF award as a number (Gold 3 ... Requires improvement 0).
- *
- * @param {string|undefined} outcome the award text.
- * @return {number|null} the score, or null when there is no award.
- */
-export declare function tefScore(outcome: string | undefined): number | null;
-/**
- * The raw value of every university-level metric on a provider.
- *
- * @param {object} provider the provider with its enrichment.
- * @return {object} metric id -> raw value (absent when unknown).
- */
-export declare function providerMetricValues(provider: Partial<HeProvider>): {
-    [metricId: string]: number;
-};
-/**
- * The raw value of every city-level metric on an area. Local jobs are one
- * metric per BRES sector, `jobs_<sector>`.
- *
- * @param {object} area the area.
- * @return {object} metric id -> raw value (absent when unknown).
- */
-export declare function areaMetricValues(area: Partial<HeArea>): {
-    [metricId: string]: number;
-};
 /**
  * Mid-rank percentile of `v` within `sorted`: the share of values below it
  * plus half the share equal to it, 0-100, rounded. Ties share a percentile.
@@ -118,17 +114,6 @@ export declare function areaMetricValues(area: Partial<HeArea>): {
  * @return {number} the percentile.
  */
 export declare function percentileOf(sorted: number[], v: number): number;
-/**
- * Percentiles of a flat set of values (providers or areas), ascending.
- *
- * @param {object} values id -> raw value; null / undefined are skipped.
- * @return {object} id -> percentile, only for ids with a value.
- */
-export declare function percentileMap(values: {
-    [id: string]: number | null | undefined;
-}): {
-    [id: string]: number;
-};
 /** The input `coursePercentiles` ranks. */
 export type HeCourseMetricRow = {
     courseId: string;
@@ -138,20 +123,19 @@ export type HeCourseMetricRow = {
     };
 };
 /**
- * Percentile of every course-level metric within the course's CAH subject.
+ * Percentile of every NSS question within the course's CAH subject.
  *
- * Each course is ranked on its first (primary) CAH subject. For each metric
+ * Each course is ranked on its first (primary) CAH subject. For each question
  * the cohort is the most specific of that subject's level-3, level-2 and
- * level-1 groups holding at least `minCohort` courses with the metric,
- * falling back to every course with it. Values from fewer than
- * `minResponses` respondents are left out entirely: they neither get a
- * percentile nor count in anyone's cohort. A null respondent count (a metric
- * with no population, like the cost-centre figures) is not filtered.
+ * level-1 groups holding at least `minCohort` courses with an answer, falling
+ * back to every course with one. Answers from fewer than `minResponses`
+ * respondents are left out entirely: they neither get a percentile nor count
+ * in anyone's cohort. An unknown respondent count is not filtered.
  *
  * @param {HeCourseMetricRow[]} rows every course's metrics.
  * @param {object} options thresholds, defaulting to the constants above.
- * @return {Map} courseId -> {pct, cohort}; courses with no rankable metric
- * get empty objects.
+ * @return {Map} courseId -> {pct, cohort}; courses with nothing rankable get
+ * empty objects.
  */
 export declare function coursePercentiles(rows: HeCourseMetricRow[], options?: {
     minResponses?: number;
@@ -164,28 +148,6 @@ export declare function coursePercentiles(rows: HeCourseMetricRow[], options?: {
         [metricId: string]: string;
     };
 }>;
-/** Prefix on the course `pct` keys that come from the provider / area, so a
- * course-level and a university-level metric can never collide. */
-export declare const HE_UNI_PCT_PREFIX = "u_";
-export declare const HE_CITY_PCT_PREFIX = "c_";
-/**
- * A course's full `pct`: its own course-level percentiles plus its
- * provider's and area's, prefixed.
- *
- * @param {object} own course-level percentiles.
- * @param {object|undefined} provider the provider's percentiles.
- * @param {object|undefined} area the area's percentiles.
- * @return {object} the merged map, keys sorted so the content hash is stable.
- */
-export declare function mergeCoursePct(own: {
-    [id: string]: number;
-}, provider?: {
-    [id: string]: number;
-}, area?: {
-    [id: string]: number;
-}): {
-    [id: string]: number;
-};
 /** What `rankCourses` needs from a course (an Algolia hit is enough). */
 export type HeRankable = {
     courseId: string;
@@ -193,104 +155,36 @@ export type HeRankable = {
     pct?: {
         [metricId: string]: number;
     };
-    _geoloc?: {
-        lat: number;
-        lng: number;
-    }[];
-    locations?: {
-        lat: number;
-        lng: number;
-    }[];
-};
-/** Context the student-specific priorities need. */
-export type HeRankContext = {
-    /** BRES sector ids from the student's career interests, for "jobs". */
-    sectors?: string[];
-    /** The student's home, for "distance". */
-    home?: {
-        lat: number;
-        lng: number;
-    };
 };
 /** One pick's contribution to a course's score. */
 export type HeRankPart = {
     priorityId: string;
-    /** 0-100, higher is better for the student, or null without data. */
-    goodness: number | null;
+    /** The course's percentile in subject for this question, or null without data. */
+    percentile: number | null;
 };
 /** A ranked course. */
 export type HeRanked<T extends HeRankable> = {
     course: T;
-    /** Mean goodness of the picks with data, or null when none had any. */
+    /** Mean percentile of the picks with data, or null when none had any. */
     score: number | null;
     /** How many picks had data, out of how many were made. */
     picksWithData: number;
     picksTotal: number;
     parts: HeRankPart[];
-    /** Straight-line km to the nearest location, when a home was given. */
-    distanceKm?: number;
 };
-/**
- * Great-circle distance in km.
- *
- * @param {object} a a point.
- * @param {object} b a point.
- * @return {number} the distance.
- */
-export declare function haversineKm(a: {
-    lat: number;
-    lng: number;
-}, b: {
-    lat: number;
-    lng: number;
-}): number;
-/**
- * The course's nearest teaching location to `home`, in km.
- *
- * @param {HeRankable} course the course.
- * @param {object} home the student's home.
- * @return {number|undefined} the distance, or undefined without locations.
- */
-export declare function courseDistanceKm(course: HeRankable, home: {
-    lat: number;
-    lng: number;
-}): number | undefined;
-/**
- * The raw (ascending) percentile a priority reads from a course's `pct`, or
- * null without data. "jobs" is the mean over the student's sectors that have
- * data; "distance" is handled by `rankCourses`.
- *
- * @param {HePriority} priority the priority.
- * @param {object|undefined} pct the course's `pct`.
- * @param {HeRankContext} ctx the student context.
- * @return {number|null} the percentile.
- */
-export declare function priorityPercentile(priority: HePriority, pct: {
-    [id: string]: number;
-} | undefined, ctx?: HeRankContext): number | null;
-/**
- * The percentile turned the student's way: 100 is best for them.
- *
- * @param {HePriority} priority the priority.
- * @param {number|null} percentile the raw ascending percentile.
- * @return {number|null} the goodness.
- */
-export declare const goodnessOf: (priority: HePriority, percentile: number | null) => number | null;
 /**
  * Rank courses on the student's picks.
  *
- * Score = mean goodness over the picks the course has data for; picks
+ * Score = mean percentile over the picks the course has data for; picks
  * without data are counted in `picksWithData` and otherwise ignored. Courses
  * with no data for any pick sort last. Ties go to more picks with data, then
- * title. "Close to home" is ranked within the list itself, since it depends
- * on the student.
+ * title.
  *
  * @param {HeRankable[]} courses the candidates.
  * @param {string[]} priorityIds the student's picks.
- * @param {HeRankContext} ctx sectors and home.
  * @return {HeRanked[]} the courses, best first.
  */
-export declare function rankCourses<T extends HeRankable>(courses: T[], priorityIds: string[], ctx?: HeRankContext): HeRanked<T>[];
+export declare function rankCourses<T extends HeRankable>(courses: T[], priorityIds: string[]): HeRanked<T>[];
 /**
  * The "why" chips for a ranked course: its strongest picks, phrased for a
  * student ("Top 10% for feedback on time"). Only picks in the top quarter
@@ -302,36 +196,51 @@ export declare function rankCourses<T extends HeRankable>(courses: T[], priority
  */
 export declare function whyChips(parts: HeRankPart[], max?: number): string[];
 /**
- * The raw value behind a priority for display on the compare page.
+ * A question's agreement on a course, for display.
  *
- * @param {HePriority} priority the priority.
- * @param {object} data the course, its provider and area, and the student
- * context.
- * @return {number|null} the value in the priority's format, or null.
+ * @param {HePriority} priority the question.
+ * @param {object} course the course's NSS answers.
+ * @return {number|null} % agreeing, or null without data.
  */
-export declare function priorityRawValue(priority: HePriority, data: {
-    course?: Partial<HeCourse>;
-    provider?: Partial<HeProvider>;
-    area?: Partial<HeArea>;
-    ctx?: HeRankContext;
-    distanceKm?: number;
-}): number | null;
+export declare function priorityValue(priority: HePriority, course: Pick<Partial<HeCourse>, "nss">): number | null;
 /**
- * Format a metric value for display, "No data" when null.
+ * Format an agreement for display, "No data" when null.
  *
- * @param {HePriority} priority the priority whose format applies.
- * @param {number|null} value the raw value.
- * @return {string} the formatted value.
+ * @param {number|null} value % agreeing.
+ * @return {string} e.g. "82%".
  */
-export declare function formatHeValue(priority: HePriority, value: number | null): string;
-/** Attribution line per source, shown wherever its figures appear. */
-export declare const HE_ATTRIBUTIONS: {
-    [source in HePriority["source"]]?: string;
-};
+export declare const formatAgree: (value: number | null) => string;
 /**
- * The attribution lines for a set of priorities, de-duplicated, HESA first.
+ * Great-circle distance in km, for the ranked list's distance filter.
  *
- * @param {HePriority[]} priorities what the surface shows.
- * @return {string[]} attribution lines.
+ * @param {object} a a point.
+ * @param {object} b a point.
+ * @return {number} the distance.
  */
-export declare function attributionsFor(priorities: HePriority[]): string[];
+export declare function haversineKm(a: {
+    lat: number;
+    lng: number;
+}, b: {
+    lat: number;
+    lng: number;
+}): number;
+/**
+ * The course's nearest teaching location to `home`, in km.
+ *
+ * @param {object} course its locations (Algolia `_geoloc` or `locations`).
+ * @param {object} home the point to measure from.
+ * @return {number|undefined} the distance, or undefined without locations.
+ */
+export declare function courseDistanceKm(course: {
+    _geoloc?: {
+        lat: number;
+        lng: number;
+    }[];
+    locations?: {
+        lat: number;
+        lng: number;
+    }[];
+}, home: {
+    lat: number;
+    lng: number;
+}): number | undefined;