npm - placementt-core - Versions diffs - 1.400.1016 → 1.400.1018 - Mend

placementt-core 1.400.1016 → 1.400.1018

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/lib/benchmarkEvidenceRules.d.ts +83 -9
package/lib/benchmarkEvidenceRules.js +78 -9
package/lib/benchmarkEvidenceRules.js.map +1 -1
package/lib/benchmarkEvidenceRules.test.js +72 -6
package/lib/benchmarkEvidenceRules.test.js.map +1 -1
package/lib/productResolver.d.ts +5 -0
package/lib/productResolver.js +1 -0
package/lib/productResolver.js.map +1 -1
package/lib/typeDefinitions.d.ts +62 -0
package/package.json +1 -1
package/src/benchmarkEvidenceRules.test.ts +86 -7
package/src/benchmarkEvidenceRules.ts +134 -13
package/src/productResolver.ts +6 -0
package/src/typeDefinitions.ts +83 -0

package/lib/benchmarkEvidenceRules.d.ts CHANGED Viewed

@@ -1,4 +1,4 @@
-import { ExternalEvent, StudentActivity } from "./typeDefinitions";
+import { CareersRecordEntry, ExternalEvent, StudentActivity } from "./typeDefinitions";
 /**
  * ─── Single source of truth for Gatsby Benchmark *evidence* ───────────────────
  *
@@ -20,7 +20,25 @@ export type GatsbyBenchmarkNumber = (typeof GATSBY_BENCHMARK_NUMBERS)[number];
  * Where a benchmark's evidence comes from on CareerThread. Drives how the dashboard
  * renders each card and whether it can show a coverage percentage at all.
  */
-export type BenchmarkEvidenceSource = "provision" | "destinations" | "events" | "eventsAndActivities" | "eventsAndPlacements" | "untracked";
+export type BenchmarkEvidenceSource = "provision" | "destinations" | "events" | "eventsAndActivities" | "eventsAndPlacements" | "guidance";
+/**
+ * ─── Time model ───────────────────────────────────────────────────────────────
+ * The period a benchmark's coverage is measured over. This is NOT cosmetic: the
+ * benchmarks genuinely differ, and measuring them all annually (as this module
+ * originally did) understates coverage badly.
+ *
+ *   BM5 renews every year      → "Every year, from the age of 11, at least one
+ *                                 meaningful encounter with an employer."
+ *   BM2 runs per Key Stage     → "During each Key Stage, all pupils should access
+ *                                 and use information about careers…"
+ *   BM6/7/8 are cumulative     → "By the age of 16… and a further one by 18."
+ *
+ * The cumulative case is the one that bites. Measured annually, a Year 11 who did
+ * their work experience in Year 10 reads as uncovered, and every pupil in Years 7-9
+ * sits in the denominator of a duty that does not apply to them until 16 — which is
+ * why `biggestGap` currently keeps nominating Year 7 as a school's worst gap on BM6.
+ */
+export type BenchmarkTimeModel = "annual" | "keyStage" | "cumulativeByAge" | "provision";
 export type BenchmarkMeta = {
     number: GatsbyBenchmarkNumber;
     /** Short title (no "GB"/"score" wording). */
@@ -30,22 +48,61 @@ export type BenchmarkMeta = {
     source: BenchmarkEvidenceSource;
     /**
      * Whether this benchmark yields a per-student coverage number. False for BM1
-     * (provision-level, shown as an informational card) and BM8 (untracked, shown
-     * as an honest empty state). The dashboard must not render a coverage % for a
-     * benchmark where this is false.
+     * (provision-level, shown as an informational card). The dashboard must not
+     * render a coverage % for a benchmark where this is false.
      */
     countsTowardCoverage: boolean;
     /** True for 5-7: the PAL Compliance flag is meaningful (mirrors COMPASS_PAL_BENCHMARKS). */
     palRelevant: boolean;
+    /** How coverage is periodised. Drives both the denominator and the card's label. */
+    timeModel: BenchmarkTimeModel;
 };
 /**
- * Benchmarks that produce a coverage percentage on the matrix / cards. Deliberately
- * BM2-8 excluding the two that can't be a per-student coverage number: BM1
- * (provision) and BM8 (untracked). Derived from the Compass export's valid set so
- * the two files can't drift.
+ * Benchmarks that produce a coverage percentage on the matrix / cards. BM1 is the
+ * only exclusion: it is whole-programme provision and can never be a per-pupil
+ * number. Derived from the Compass export's valid set (2-8) so the two files can't
+ * drift.
+ *
+ * BM8 was previously excluded here because personal guidance was untracked. It is
+ * now recorded on the careers record, so it earns a coverage number like the rest —
+ * but a cumulative, age-banded one. See BENCHMARK_AGE_CHECKPOINTS.
  */
 export declare const BENCHMARK_COVERAGE_NUMBERS: GatsbyBenchmarkNumber[];
 export declare const BENCHMARK_META: Record<GatsbyBenchmarkNumber, BenchmarkMeta>;
+/**
+ * ─── Age checkpoints for cumulative benchmarks ────────────────────────────────
+ * BM6, BM7 and BM8 are all phrased as "by the age of 16… and by 18". Coverage for
+ * these is judged at the two points where the duty actually falls due, not spread
+ * across every year group: asking what proportion of Year 7 has had a personal
+ * guidance meeting measures nothing, because none of them are due one yet.
+ *
+ * The headline figure for each checkpoint is therefore the *due* cohort — the year
+ * group at which the duty has just become expected. Earlier year groups still get a
+ * progression figure (are we on track?), but they must not drag the headline down.
+ */
+export type BenchmarkAgeCheckpoint = {
+    /** The age the benchmark names. */
+    age: 16 | 18;
+    /** The year group at which the duty has fallen due in full. */
+    dueYearGroup: number;
+    /** Year groups the duty is accumulating across, up to and including the due one. */
+    accumulatingYearGroups: number[];
+    label: string;
+};
+export declare const BENCHMARK_AGE_CHECKPOINTS: BenchmarkAgeCheckpoint[];
+/** The checkpoint a year group is working towards, or undefined if off-scale. */
+export declare function ageCheckpointForYearGroup(yearGroup: number): BenchmarkAgeCheckpoint | undefined;
+/**
+ * The pupil's year group at some earlier date, back-derived from their current year
+ * group. Records written before `yearGroupAtEntry` existed (and every placement and
+ * event, which never carried one) have no snapshot, so cumulative coverage has to
+ * reconstruct it: each academic year that has elapsed since the record is one year
+ * group to subtract.
+ *
+ * Returns undefined when the result falls outside schooling, which is the honest
+ * answer for a record whose date predates the pupil joining.
+ */
+export declare function yearGroupAtDate(currentYearGroup: number, recordDate: string | undefined, now?: Date | string): number | undefined;
 /**
  * StudentActivity.activityType → the benchmark(s) that activity is evidence for.
  * Employer-facing encounters count towards BM5; first-hand workplace experiences
@@ -80,6 +137,23 @@ export declare function eventEvidenceBenchmarks(event: Pick<ExternalEvent, "gats
 export declare function eventProvidesBenchmark(event: Pick<ExternalEvent, "gatsbyBenchmarks">, benchmark: GatsbyBenchmarkNumber): boolean;
 /** The benchmarks a logged student activity is evidence for. */
 export declare function activityEvidenceBenchmarks(activity: Pick<StudentActivity, "activityType">): GatsbyBenchmarkNumber[];
+/**
+ * ─── Careers record entries as evidence ───────────────────────────────────────
+ * Every entry is BM3 evidence: the updated Benchmark 3 asks schools to record the
+ * individual advice given to each pupil and any decisions subsequently agreed, and
+ * makes no distinction between a formal guidance interview and an option-choice
+ * conversation for that purpose.
+ *
+ * BM8 is far narrower. It is satisfied only by a personal guidance meeting with a
+ * careers adviser trained to an appropriate level. A school that logs fifty tutor-time
+ * careers chats has kept excellent records and has NOT delivered personal guidance, so
+ * only `personalGuidance` entries with `adviserQualified` count here. Loosening this
+ * would manufacture compliance with a statutory expectation, which is the one thing
+ * this module exists to prevent.
+ */
+export declare function isPersonalGuidanceEntry(entry: Pick<CareersRecordEntry, "entryType" | "adviserQualified">): boolean;
+/** The benchmarks a careers record entry is evidence for. */
+export declare function careersRecordEvidenceBenchmarks(entry: Pick<CareersRecordEntry, "entryType" | "adviserQualified">): GatsbyBenchmarkNumber[];
 /**
  * A PAL-compliant provider encounter: the event carries the existing PAL flag AND
  * is tagged with a PAL-relevant benchmark (5-7). Same rule the export uses when

package/lib/benchmarkEvidenceRules.js CHANGED Viewed

@@ -1,9 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PAL_PHASES = exports.PAL_ENCOUNTERS_PER_PHASE = exports.ACTIVITY_TYPE_BENCHMARKS = exports.BENCHMARK_META = exports.BENCHMARK_COVERAGE_NUMBERS = exports.GATSBY_BENCHMARK_NUMBERS = void 0;
+exports.PAL_PHASES = exports.PAL_ENCOUNTERS_PER_PHASE = exports.ACTIVITY_TYPE_BENCHMARKS = exports.BENCHMARK_AGE_CHECKPOINTS = exports.BENCHMARK_META = exports.BENCHMARK_COVERAGE_NUMBERS = exports.GATSBY_BENCHMARK_NUMBERS = void 0;
+exports.ageCheckpointForYearGroup = ageCheckpointForYearGroup;
+exports.yearGroupAtDate = yearGroupAtDate;
 exports.eventEvidenceBenchmarks = eventEvidenceBenchmarks;
 exports.eventProvidesBenchmark = eventProvidesBenchmark;
 exports.activityEvidenceBenchmarks = activityEvidenceBenchmarks;
+exports.isPersonalGuidanceEntry = isPersonalGuidanceEntry;
+exports.careersRecordEvidenceBenchmarks = careersRecordEvidenceBenchmarks;
 exports.isPalCompliantProviderEncounter = isPalCompliantProviderEncounter;
 exports.palPhaseForYearGroup = palPhaseForYearGroup;
 exports.academicYearForDate = academicYearForDate;
@@ -28,12 +32,16 @@ const compassExport_1 = require("./compassExport");
  */
 exports.GATSBY_BENCHMARK_NUMBERS = [1, 2, 3, 4, 5, 6, 7, 8];
 /**
- * Benchmarks that produce a coverage percentage on the matrix / cards. Deliberately
- * BM2-8 excluding the two that can't be a per-student coverage number: BM1
- * (provision) and BM8 (untracked). Derived from the Compass export's valid set so
- * the two files can't drift.
+ * Benchmarks that produce a coverage percentage on the matrix / cards. BM1 is the
+ * only exclusion: it is whole-programme provision and can never be a per-pupil
+ * number. Derived from the Compass export's valid set (2-8) so the two files can't
+ * drift.
+ *
+ * BM8 was previously excluded here because personal guidance was untracked. It is
+ * now recorded on the careers record, so it earns a coverage number like the rest —
+ * but a cumulative, age-banded one. See BENCHMARK_AGE_CHECKPOINTS.
  */
-exports.BENCHMARK_COVERAGE_NUMBERS = compassExport_1.COMPASS_VALID_ACTIVITY_BENCHMARKS.filter((b) => b !== 8);
+exports.BENCHMARK_COVERAGE_NUMBERS = [...compassExport_1.COMPASS_VALID_ACTIVITY_BENCHMARKS];
 exports.BENCHMARK_META = {
     1: {
         number: 1,
@@ -42,6 +50,7 @@ exports.BENCHMARK_META = {
         source: "provision",
         countsTowardCoverage: false,
         palRelevant: false,
+        timeModel: "provision",
     },
     2: {
         number: 2,
@@ -50,6 +59,9 @@ exports.BENCHMARK_META = {
         source: "events",
         countsTowardCoverage: true,
         palRelevant: false,
+        // The benchmark's unit is the Key Stage, not the year. Still measured annually
+        // until the Key Stage denominator lands — see BENCHMARK_AGE_CHECKPOINTS.
+        timeModel: "annual",
     },
     3: {
         number: 3,
@@ -58,6 +70,7 @@ exports.BENCHMARK_META = {
         source: "destinations",
         countsTowardCoverage: true,
         palRelevant: false,
+        timeModel: "annual",
     },
     4: {
         number: 4,
@@ -66,6 +79,7 @@ exports.BENCHMARK_META = {
         source: "events",
         countsTowardCoverage: true,
         palRelevant: false,
+        timeModel: "annual",
     },
     5: {
         number: 5,
@@ -74,6 +88,9 @@ exports.BENCHMARK_META = {
         source: "eventsAndActivities",
         countsTowardCoverage: true,
         palRelevant: true,
+        // The one benchmark whose annual model matches its own wording: "every year,
+        // from the age of 11, at least one meaningful encounter with an employer".
+        timeModel: "annual",
     },
     6: {
         number: 6,
@@ -82,6 +99,7 @@ exports.BENCHMARK_META = {
         source: "eventsAndPlacements",
         countsTowardCoverage: true,
         palRelevant: true,
+        timeModel: "cumulativeByAge",
     },
     7: {
         number: 7,
@@ -90,16 +108,46 @@ exports.BENCHMARK_META = {
         source: "events",
         countsTowardCoverage: true,
         palRelevant: true,
+        timeModel: "cumulativeByAge",
     },
     8: {
         number: 8,
         name: "Personal guidance",
-        description: "Every pupil has personal guidance interviews with a careers adviser when they need them.",
-        source: "untracked",
-        countsTowardCoverage: false,
+        description: "Every pupil has a personal guidance meeting with a careers adviser by 16, and a further one by 18.",
+        source: "guidance",
+        countsTowardCoverage: true,
         palRelevant: false,
+        timeModel: "cumulativeByAge",
     },
 };
+exports.BENCHMARK_AGE_CHECKPOINTS = [
+    { age: 16, dueYearGroup: 11, accumulatingYearGroups: [7, 8, 9, 10, 11], label: "By age 16" },
+    { age: 18, dueYearGroup: 13, accumulatingYearGroups: [12, 13], label: "By age 18" },
+];
+/** The checkpoint a year group is working towards, or undefined if off-scale. */
+function ageCheckpointForYearGroup(yearGroup) {
+    return exports.BENCHMARK_AGE_CHECKPOINTS.find((c) => c.accumulatingYearGroups.includes(yearGroup));
+}
+/**
+ * The pupil's year group at some earlier date, back-derived from their current year
+ * group. Records written before `yearGroupAtEntry` existed (and every placement and
+ * event, which never carried one) have no snapshot, so cumulative coverage has to
+ * reconstruct it: each academic year that has elapsed since the record is one year
+ * group to subtract.
+ *
+ * Returns undefined when the result falls outside schooling, which is the honest
+ * answer for a record whose date predates the pupil joining.
+ */
+function yearGroupAtDate(currentYearGroup, recordDate, now = new Date()) {
+    if (!recordDate)
+        return undefined;
+    const recordYear = parseInt(academicYearForDate(recordDate).split("-")[0], 10);
+    const currentYear = parseInt(academicYearForDate(now).split("-")[0], 10);
+    if (isNaN(recordYear) || isNaN(currentYear))
+        return undefined;
+    const derived = currentYearGroup - (currentYear - recordYear);
+    return derived >= 1 && derived <= 15 ? derived : undefined;
+}
 /**
  * StudentActivity.activityType → the benchmark(s) that activity is evidence for.
  * Employer-facing encounters count towards BM5; first-hand workplace experiences
@@ -174,6 +222,27 @@ function eventProvidesBenchmark(event, benchmark) {
 function activityEvidenceBenchmarks(activity) {
     return exports.ACTIVITY_TYPE_BENCHMARKS[activity.activityType] || [];
 }
+/**
+ * ─── Careers record entries as evidence ───────────────────────────────────────
+ * Every entry is BM3 evidence: the updated Benchmark 3 asks schools to record the
+ * individual advice given to each pupil and any decisions subsequently agreed, and
+ * makes no distinction between a formal guidance interview and an option-choice
+ * conversation for that purpose.
+ *
+ * BM8 is far narrower. It is satisfied only by a personal guidance meeting with a
+ * careers adviser trained to an appropriate level. A school that logs fifty tutor-time
+ * careers chats has kept excellent records and has NOT delivered personal guidance, so
+ * only `personalGuidance` entries with `adviserQualified` count here. Loosening this
+ * would manufacture compliance with a statutory expectation, which is the one thing
+ * this module exists to prevent.
+ */
+function isPersonalGuidanceEntry(entry) {
+    return entry.entryType === "personalGuidance" && Boolean(entry.adviserQualified);
+}
+/** The benchmarks a careers record entry is evidence for. */
+function careersRecordEvidenceBenchmarks(entry) {
+    return isPersonalGuidanceEntry(entry) ? [3, 8] : [3];
+}
 /**
  * A PAL-compliant provider encounter: the event carries the existing PAL flag AND
  * is tagged with a PAL-relevant benchmark (5-7). Same rule the export uses when

package/lib/benchmarkEvidenceRules.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"benchmarkEvidenceRules.js","sourceRoot":"","sources":["../src/benchmarkEvidenceRules.ts"],"names":[],"mappings":";;;~~AA+LA~~,0DAGC;AAGD,wDAEC;AAGD,gEAEC;AAOD,0EAGC;AAwBD,oDAEC;AAWD,kDAMC;AAGD,sDAGC;AAGD,gDAIC;AAUD,oCAMC;~~AA7RD~~,mDAA0F;AAE1F;;;;;;;;;;;;;;GAcG;AAEU,QAAA,wBAAwB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,CAAC;~~AAiC1E;;;;;GAKG~~;AACU,QAAA,0BAA0B,GACnC,~~iDAAiC,~~CAAC,~~MAAM~~,~~CAAC~~,~~CAAC~~,CAAC~~,EAA8B,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC~~;~~AAE5E~~,QAAA,cAAc,GAAiD;IACxE,CAAC,EAAE;QACC,MAAM,EAAE,CAAC;QACT,IAAI,EAAE,4BAA4B;QAClC,WAAW,EAAE,kGAAkG;QAC/G,MAAM,EAAE,WAAW;QACnB,oBAAoB,EAAE,KAAK;QAC3B,WAAW,EAAE,KAAK;~~KACrB~~;IACD,CAAC,EAAE;QACC,MAAM,EAAE,CAAC;QACT,IAAI,EAAE,kDAAkD;QACxD,WAAW,EAAE,+FAA+F;QAC5G,MAAM,EAAE,QAAQ;QAChB,oBAAoB,EAAE,IAAI;QAC1B,WAAW,EAAE,KAAK;~~KACrB~~;IACD,CAAC,EAAE;QACC,MAAM,EAAE,CAAC;QACT,IAAI,EAAE,oCAAoC;QAC1C,WAAW,EAAE,+EAA+E;QAC5F,MAAM,EAAE,cAAc;QACtB,oBAAoB,EAAE,IAAI;QAC1B,WAAW,EAAE,KAAK;~~KACrB~~;IACD,CAAC,EAAE;QACC,MAAM,EAAE,CAAC;QACT,IAAI,EAAE,wCAAwC;QAC9C,WAAW,EAAE,2FAA2F;QACxG,MAAM,EAAE,QAAQ;QAChB,oBAAoB,EAAE,IAAI;QAC1B,WAAW,EAAE,KAAK;~~KACrB~~;IACD,CAAC,EAAE;QACC,MAAM,EAAE,CAAC;QACT,IAAI,EAAE,yCAAyC;QAC/C,WAAW,EAAE,mFAAmF;QAChG,MAAM,EAAE,qBAAqB;QAC7B,oBAAoB,EAAE,IAAI;QAC1B,WAAW,EAAE,IAAI;~~KACpB~~;IACD,CAAC,EAAE;QACC,MAAM,EAAE,CAAC;QACT,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE,4FAA4F;QACzG,MAAM,EAAE,qBAAqB;QAC7B,oBAAoB,EAAE,IAAI;QAC1B,WAAW,EAAE,IAAI;~~KACpB~~;IACD,CAAC,EAAE;QACC,MAAM,EAAE,CAAC;QACT,IAAI,EAAE,4CAA4C;QAClD,WAAW,EAAE,sGAAsG;QACnH,MAAM,EAAE,QAAQ;QAChB,oBAAoB,EAAE,IAAI;QAC1B,WAAW,EAAE,IAAI;~~KACpB~~;IACD,CAAC,EAAE;QACC,MAAM,EAAE,CAAC;QACT,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,~~0FAA0F~~;~~QACvG~~,MAAM,EAAE,~~WAAW~~;~~QACnB~~,oBAAoB,EAAE,~~KAAK~~;~~QAC3B~~,WAAW,EAAE,KAAK;~~KACrB~~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"}
1	+ {"version":3,"file":"benchmarkEvidenceRules.js","sourceRoot":"","sources":["../src/benchmarkEvidenceRules.ts"],"names":[],"mappings":"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"}

package/lib/benchmarkEvidenceRules.test.js CHANGED Viewed

@@ -4,16 +4,27 @@ const benchmarkEvidenceRules_1 = require("./benchmarkEvidenceRules");
 const compassExport_1 = require("./compassExport");
 describe("benchmarkEvidenceRules single-source consistency", () => {
     it("stays consistent with the Compass export's valid activity benchmarks (2-8)", () => {
-        // Coverage numbers are the export-valid set minus BM8 (untracked on CareerThread).
-        expect(benchmarkEvidenceRules_1.BENCHMARK_COVERAGE_NUMBERS).toEqual(compassExport_1.COMPASS_VALID_ACTIVITY_BENCHMARKS.filter((b) => b !== 8));
+        // Coverage numbers are exactly the export-valid set. BM8 joined it when personal
+        // guidance became recordable on the careers record; BM1 was never in it.
+        expect(benchmarkEvidenceRules_1.BENCHMARK_COVERAGE_NUMBERS).toEqual([...compassExport_1.COMPASS_VALID_ACTIVITY_BENCHMARKS]);
         expect(benchmarkEvidenceRules_1.BENCHMARK_COVERAGE_NUMBERS).not.toContain(1);
-        expect(benchmarkEvidenceRules_1.BENCHMARK_COVERAGE_NUMBERS).not.toContain(8);
+        expect(benchmarkEvidenceRules_1.BENCHMARK_COVERAGE_NUMBERS).toContain(8);
     });
-    it("marks BM1 as provision-level and BM8 as untracked — neither counts toward coverage", () => {
+    it("marks BM1 as the only provision-level benchmark, and BM8 as guidance-sourced", () => {
         expect(benchmarkEvidenceRules_1.BENCHMARK_META[1].countsTowardCoverage).toBe(false);
         expect(benchmarkEvidenceRules_1.BENCHMARK_META[1].source).toBe("provision");
-        expect(benchmarkEvidenceRules_1.BENCHMARK_META[8].countsTowardCoverage).toBe(false);
-        expect(benchmarkEvidenceRules_1.BENCHMARK_META[8].source).toBe("untracked");
+        expect(benchmarkEvidenceRules_1.BENCHMARK_META[8].countsTowardCoverage).toBe(true);
+        expect(benchmarkEvidenceRules_1.BENCHMARK_META[8].source).toBe("guidance");
+    });
+    it("periodises each benchmark the way its own wording does", () => {
+        // BM5 is the only benchmark that genuinely renews annually ("every year, from
+        // the age of 11"). BM6/7/8 are cumulative duties pinned to 16 and 18, and
+        // measuring them annually understates coverage — see BenchmarkTimeModel.
+        expect(benchmarkEvidenceRules_1.BENCHMARK_META[5].timeModel).toBe("annual");
+        expect(benchmarkEvidenceRules_1.BENCHMARK_META[6].timeModel).toBe("cumulativeByAge");
+        expect(benchmarkEvidenceRules_1.BENCHMARK_META[7].timeModel).toBe("cumulativeByAge");
+        expect(benchmarkEvidenceRules_1.BENCHMARK_META[8].timeModel).toBe("cumulativeByAge");
+        expect(benchmarkEvidenceRules_1.BENCHMARK_META[1].timeModel).toBe("provision");
     });
     it("flags PAL relevance for exactly benchmarks 5-7", () => {
         [1, 2, 3, 4, 5, 6, 7, 8].forEach((b) => {
@@ -74,4 +85,59 @@ describe("coverage bands are neutral (no pass/fail theatre)", () => {
         expect((0, benchmarkEvidenceRules_1.coverageBand)(1)).toBe("full");
     });
 });
+describe("careers record entries as benchmark evidence", () => {
+    it("counts a qualified adviser's personal guidance towards BM8", () => {
+        const entry = { entryType: "personalGuidance", adviserQualified: true };
+        expect((0, benchmarkEvidenceRules_1.isPersonalGuidanceEntry)(entry)).toBe(true);
+        expect((0, benchmarkEvidenceRules_1.careersRecordEvidenceBenchmarks)(entry)).toEqual([3, 8]);
+    });
+    it("does NOT count personal guidance from an unqualified adviser towards BM8", () => {
+        // The benchmark is satisfied by a meeting with a careers adviser trained to an
+        // appropriate level. Counting an untrained member of staff would fabricate
+        // compliance with a statutory expectation.
+        const entry = { entryType: "personalGuidance", adviserQualified: false };
+        expect((0, benchmarkEvidenceRules_1.isPersonalGuidanceEntry)(entry)).toBe(false);
+        expect((0, benchmarkEvidenceRules_1.careersRecordEvidenceBenchmarks)(entry)).toEqual([3]);
+    });
+    it("does NOT let other entry types inflate BM8, however many are logged", () => {
+        const others = [
+            "careersConversation", "optionsMeeting", "applicationSupport",
+            "sendReview", "parentMeeting", "groupGuidance", "other",
+        ];
+        others.forEach((entryType) => {
+            const entry = { entryType, adviserQualified: true };
+            expect((0, benchmarkEvidenceRules_1.isPersonalGuidanceEntry)(entry)).toBe(false);
+            expect((0, benchmarkEvidenceRules_1.careersRecordEvidenceBenchmarks)(entry)).toEqual([3]);
+        });
+    });
+    it("still treats every entry as BM3 record-keeping evidence", () => {
+        expect((0, benchmarkEvidenceRules_1.careersRecordEvidenceBenchmarks)({ entryType: "careersConversation", adviserQualified: false })).toContain(3);
+    });
+});
+describe("cumulative age-banded coverage", () => {
+    it("maps year groups onto the checkpoint they are working towards", () => {
+        expect((0, benchmarkEvidenceRules_1.ageCheckpointForYearGroup)(9)?.age).toBe(16);
+        expect((0, benchmarkEvidenceRules_1.ageCheckpointForYearGroup)(11)?.age).toBe(16);
+        expect((0, benchmarkEvidenceRules_1.ageCheckpointForYearGroup)(12)?.age).toBe(18);
+        expect((0, benchmarkEvidenceRules_1.ageCheckpointForYearGroup)(13)?.age).toBe(18);
+        expect((0, benchmarkEvidenceRules_1.ageCheckpointForYearGroup)(6)).toBeUndefined();
+    });
+    it("back-derives the year group a pupil was in when an older record was made", () => {
+        // A Year 11 pupil "now" (2025-26) did work experience in 2024-25, so they were
+        // in Year 10 at the time. Without this, BM6 reads them as uncovered.
+        expect((0, benchmarkEvidenceRules_1.yearGroupAtDate)(11, "2025-03-01", "2026-03-01")).toBe(10);
+        expect((0, benchmarkEvidenceRules_1.yearGroupAtDate)(11, "2025-11-01", "2026-03-01")).toBe(11);
+        expect((0, benchmarkEvidenceRules_1.yearGroupAtDate)(13, "2023-10-01", "2026-03-01")).toBe(11);
+    });
+    it("rolls over at the start of the academic year, not the calendar year", () => {
+        // August starts the new academic year, so a record dated 2025-09-01 and one
+        // dated 2026-01-01 sit in the same year group.
+        expect((0, benchmarkEvidenceRules_1.yearGroupAtDate)(11, "2025-09-01", "2026-01-01")).toBe(11);
+        expect((0, benchmarkEvidenceRules_1.yearGroupAtDate)(11, "2025-07-01", "2026-01-01")).toBe(10);
+    });
+    it("returns undefined rather than guessing when a date predates schooling", () => {
+        expect((0, benchmarkEvidenceRules_1.yearGroupAtDate)(11, undefined)).toBeUndefined();
+        expect((0, benchmarkEvidenceRules_1.yearGroupAtDate)(7, "2005-01-01", "2026-03-01")).toBeUndefined();
+    });
+});
 //# sourceMappingURL=benchmarkEvidenceRules.test.js.map

package/lib/benchmarkEvidenceRules.test.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"benchmarkEvidenceRules.test.js","sourceRoot":"","sources":["../src/benchmarkEvidenceRules.test.ts"],"names":[],"mappings":";;AAAA,~~qEAYkC~~;AAClC,mDAA0F;AAE1F,QAAQ,CAAC,kDAAkD,EAAE,GAAG,EAAE;IAC9D,EAAE,CAAC,4EAA4E,EAAE,GAAG,EAAE;QAClF,~~mFAAmF~~;~~QACnF~~,MAAM,CAAC,mDAA0B,CAAC,CAAC,OAAO,~~CACtC~~,iDAAiC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;~~QAC9D~~,MAAM,CAAC,~~mDAA0B~~,CAAC,CAAC,~~GAAG~~,CAAC,~~SAAS~~,CAAC,CAAC,CAAC,CAAC;~~QACpD~~,MAAM,CAAC,~~mDAA0B~~,CAAC,CAAC,~~GAAG~~,CAAC,~~SAAS~~,CAAC,CAAC,CAAC,CAAC;~~IACxD~~,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,~~oFAAoF~~,EAAE,GAAG,EAAE;~~QAC1F~~,MAAM,CAAC,uCAAc,CAAC,CAAC,CAAC,CAAC,~~oBAAoB~~,CAAC,CAAC,IAAI,CAAC,~~KAAK~~,CAAC,CAAC;~~QAC3D~~,MAAM,CAAC,uCAAc,CAAC,CAAC,CAAC,CAAC,~~MAAM~~,CAAC,CAAC,IAAI,CAAC,~~WAAW~~,CAAC,CAAC;~~QACnD~~,MAAM,CAAC,uCAAc,CAAC,CAAC,CAAC,CAAC,~~oBAAoB~~,CAAC,CAAC,IAAI,CAAC,~~KAAK~~,CAAC,CAAC;~~QAC3D~~,MAAM,CAAC,uCAAc,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;~~IACvD~~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"}
1	+ {"version":3,"file":"benchmarkEvidenceRules.test.js","sourceRoot":"","sources":["../src/benchmarkEvidenceRules.test.ts"],"names":[],"mappings":"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"}

package/lib/productResolver.d.ts CHANGED Viewed

@@ -16,6 +16,11 @@ import { InstituteData } from "./typeDefinitions";
 /** The product a surface can gate on. */
 export type ProductKey = "wex" | "network" | "parents" | "events" | "skills" | "activities" | "destinations" | "alumni";
 export type ResolvedProducts = Record<ProductKey, boolean> & {
+    /** How many parents are actually in the database, across `options.oIds`.
+     * `parents` is just this over zero; the number is surfaced so a caller that
+     * wants to show the count doesn't run the same aggregate a second time.
+     * Zero until the count lands, the same as the flag. */
+    parentCount: number;
     /** Package shape, so callers stop testing `package ===` themselves. */
     isTrust: boolean;
     isHub: boolean;

package/lib/productResolver.js CHANGED Viewed

@@ -68,6 +68,7 @@ function useProductResolver(institute, options) {
     const products = { wex, network, parents, events, skills, activities, destinations, alumni };
     return {
         ...products,
+        parentCount,
         isTrust,
         isHub,
         isHubSchool,

package/lib/productResolver.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"productResolver.js","sourceRoot":"","sources":["../src/productResolver.ts"],"names":[],"mappings":";;;;;;~~AAiEA~~,~~gDAyFC~~;~~AA1JD~~,iCAA0C;AAC1C,kDAAyC;AACzC,6EAAqD;~~AA2CrD~~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"}
1	+ {"version":3,"file":"productResolver.js","sourceRoot":"","sources":["../src/productResolver.ts"],"names":[],"mappings":"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"}

package/lib/typeDefinitions.d.ts CHANGED Viewed

@@ -3323,6 +3323,68 @@ export type StudentActivity = {
     reflectionCompletedByUid?: string;
     evidenceFileIds?: string[];
 };
+/**
+ * ─── Careers record ───────────────────────────────────────────────────────────
+ * A staff-authored record of a careers interaction with one pupil. Deliberately
+ * modelled as the pupil's *careers record* rather than a meetings log, because
+ * Gatsby Benchmark 3 asks schools to keep systematic records of "the individual
+ * advice given to each pupil, and any subsequent agreed decisions" — not only of
+ * formal guidance interviews.
+ *
+ * Only `personalGuidance` entries delivered by a qualified adviser are evidence
+ * for Benchmark 8. Every other type is BM3 record-keeping and must NOT move the
+ * BM8 number: a school that logs fifty option-choice chats has not delivered
+ * personal guidance, and showing otherwise would fabricate compliance.
+ */
+export type CareersRecordEntryType = "personalGuidance" | "careersConversation" | "optionsMeeting" | "applicationSupport" | "sendReview" | "parentMeeting" | "groupGuidance" | "other";
+/** A single agreed next step arising from a careers record entry. */
+export type CareersRecordAction = {
+    label: string;
+    owner?: "student" | "staff";
+    dueDate?: string;
+    done?: boolean;
+};
+export type CareersRecordEntry = {
+    id: string;
+    uid: string;
+    oId: string;
+    entryType: CareersRecordEntryType;
+    date: string;
+    /** Staff member who delivered it. Advisers are always platform users. */
+    adviserUid: string;
+    /**
+     * Whether the adviser was, at the time of this entry, trained to a level the
+     * school considers appropriate for personal guidance. Snapshotted rather than
+     * read live from the staff record so that later changes to a staff member's
+     * qualification cannot silently restate a previous year's BM8 coverage.
+     *
+     * Note the framework says "trained to an appropriate level", not Level 6 —
+     * Level 6 is the CDI's professional standard and what most hubs expect, but
+     * gating strictly on it would wrongly zero out schools whose adviser
+     * qualified by another route. The school asserts this; we record it.
+     */
+    adviserQualified: boolean;
+    /**
+     * The pupil's year group when the interaction happened. Snapshotted because
+     * BM8 is a cumulative "by age 16 / by age 18" duty and pupils roll up a year
+     * group every August — without this, a Year 9 meeting becomes unattributable
+     * once the pupil reaches Year 11.
+     */
+    yearGroupAtEntry?: number;
+    /** Academic year label, e.g. "2025-26". See academicYearForDate. */
+    academicYear: string;
+    mode: "inPerson" | "video" | "phone";
+    durationMins?: number;
+    /** Shared with the pupil. BM3 expects pupils to be able to access their record. */
+    summary: string;
+    /** Never shown to the pupil. Kept separate so the summary can be surfaced safely. */
+    staffNotes?: string;
+    /** "Any subsequent agreed decisions" — named in the benchmark, so evidence in its own right. */
+    actions?: CareersRecordAction[];
+    createdBy: string;
+    dateCreated: string;
+    dateUpdated?: string;
+};
 export type SuggestedFixRepo = "placementt-web" | "placementt-backend" | "placementt-core";
 export type SuggestedFix = {
     isCodeChange: boolean;

package/package.json CHANGED Viewed

@@ -2,7 +2,7 @@
   "private": false,
   "name": "placementt-core",
   "author": "Placementt",
-  "version": "1.400.1016",
+  "version": "1.400.1018",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "scripts": {

package/src/benchmarkEvidenceRules.test.ts CHANGED Viewed

@@ -2,31 +2,46 @@ import {
     academicYearDateRange,
     academicYearForDate,
     activityEvidenceBenchmarks,
+    ageCheckpointForYearGroup,
     BENCHMARK_COVERAGE_NUMBERS,
     BENCHMARK_META,
+    careersRecordEvidenceBenchmarks,
     coverageBand,
     dateInAcademicYear,
     eventEvidenceBenchmarks,
     eventProvidesBenchmark,
     isPalCompliantProviderEncounter,
+    isPersonalGuidanceEntry,
     palPhaseForYearGroup,
+    yearGroupAtDate,
 } from "./benchmarkEvidenceRules";
 import {COMPASS_PAL_BENCHMARKS, COMPASS_VALID_ACTIVITY_BENCHMARKS} from "./compassExport";
 describe("benchmarkEvidenceRules single-source consistency", () => {
     it("stays consistent with the Compass export's valid activity benchmarks (2-8)", () => {
-        // Coverage numbers are the export-valid set minus BM8 (untracked on CareerThread).
-        expect(BENCHMARK_COVERAGE_NUMBERS).toEqual(
-            COMPASS_VALID_ACTIVITY_BENCHMARKS.filter((b) => b !== 8));
+        // Coverage numbers are exactly the export-valid set. BM8 joined it when personal
+        // guidance became recordable on the careers record; BM1 was never in it.
+        expect(BENCHMARK_COVERAGE_NUMBERS).toEqual([...COMPASS_VALID_ACTIVITY_BENCHMARKS]);
         expect(BENCHMARK_COVERAGE_NUMBERS).not.toContain(1);
-        expect(BENCHMARK_COVERAGE_NUMBERS).not.toContain(8);
+        expect(BENCHMARK_COVERAGE_NUMBERS).toContain(8);
     });
-    it("marks BM1 as provision-level and BM8 as untracked — neither counts toward coverage", () => {
+    it("marks BM1 as the only provision-level benchmark, and BM8 as guidance-sourced", () => {
         expect(BENCHMARK_META[1].countsTowardCoverage).toBe(false);
         expect(BENCHMARK_META[1].source).toBe("provision");
-        expect(BENCHMARK_META[8].countsTowardCoverage).toBe(false);
-        expect(BENCHMARK_META[8].source).toBe("untracked");
+        expect(BENCHMARK_META[8].countsTowardCoverage).toBe(true);
+        expect(BENCHMARK_META[8].source).toBe("guidance");
+    });
+    it("periodises each benchmark the way its own wording does", () => {
+        // BM5 is the only benchmark that genuinely renews annually ("every year, from
+        // the age of 11"). BM6/7/8 are cumulative duties pinned to 16 and 18, and
+        // measuring them annually understates coverage — see BenchmarkTimeModel.
+        expect(BENCHMARK_META[5].timeModel).toBe("annual");
+        expect(BENCHMARK_META[6].timeModel).toBe("cumulativeByAge");
+        expect(BENCHMARK_META[7].timeModel).toBe("cumulativeByAge");
+        expect(BENCHMARK_META[8].timeModel).toBe("cumulativeByAge");
+        expect(BENCHMARK_META[1].timeModel).toBe("provision");
     });
     it("flags PAL relevance for exactly benchmarks 5-7", () => {
@@ -96,3 +111,67 @@ describe("coverage bands are neutral (no pass/fail theatre)", () => {
         expect(coverageBand(1)).toBe("full");
     });
 });
+describe("careers record entries as benchmark evidence", () => {
+    it("counts a qualified adviser's personal guidance towards BM8", () => {
+        const entry = {entryType: "personalGuidance", adviserQualified: true} as const;
+        expect(isPersonalGuidanceEntry(entry)).toBe(true);
+        expect(careersRecordEvidenceBenchmarks(entry)).toEqual([3, 8]);
+    });
+    it("does NOT count personal guidance from an unqualified adviser towards BM8", () => {
+        // The benchmark is satisfied by a meeting with a careers adviser trained to an
+        // appropriate level. Counting an untrained member of staff would fabricate
+        // compliance with a statutory expectation.
+        const entry = {entryType: "personalGuidance", adviserQualified: false} as const;
+        expect(isPersonalGuidanceEntry(entry)).toBe(false);
+        expect(careersRecordEvidenceBenchmarks(entry)).toEqual([3]);
+    });
+    it("does NOT let other entry types inflate BM8, however many are logged", () => {
+        const others = [
+            "careersConversation", "optionsMeeting", "applicationSupport",
+            "sendReview", "parentMeeting", "groupGuidance", "other",
+        ] as const;
+        others.forEach((entryType) => {
+            const entry = {entryType, adviserQualified: true} as const;
+            expect(isPersonalGuidanceEntry(entry)).toBe(false);
+            expect(careersRecordEvidenceBenchmarks(entry)).toEqual([3]);
+        });
+    });
+    it("still treats every entry as BM3 record-keeping evidence", () => {
+        expect(careersRecordEvidenceBenchmarks(
+            {entryType: "careersConversation", adviserQualified: false})).toContain(3);
+    });
+});
+describe("cumulative age-banded coverage", () => {
+    it("maps year groups onto the checkpoint they are working towards", () => {
+        expect(ageCheckpointForYearGroup(9)?.age).toBe(16);
+        expect(ageCheckpointForYearGroup(11)?.age).toBe(16);
+        expect(ageCheckpointForYearGroup(12)?.age).toBe(18);
+        expect(ageCheckpointForYearGroup(13)?.age).toBe(18);
+        expect(ageCheckpointForYearGroup(6)).toBeUndefined();
+    });
+    it("back-derives the year group a pupil was in when an older record was made", () => {
+        // A Year 11 pupil "now" (2025-26) did work experience in 2024-25, so they were
+        // in Year 10 at the time. Without this, BM6 reads them as uncovered.
+        expect(yearGroupAtDate(11, "2025-03-01", "2026-03-01")).toBe(10);
+        expect(yearGroupAtDate(11, "2025-11-01", "2026-03-01")).toBe(11);
+        expect(yearGroupAtDate(13, "2023-10-01", "2026-03-01")).toBe(11);
+    });
+    it("rolls over at the start of the academic year, not the calendar year", () => {
+        // August starts the new academic year, so a record dated 2025-09-01 and one
+        // dated 2026-01-01 sit in the same year group.
+        expect(yearGroupAtDate(11, "2025-09-01", "2026-01-01")).toBe(11);
+        expect(yearGroupAtDate(11, "2025-07-01", "2026-01-01")).toBe(10);
+    });
+    it("returns undefined rather than guessing when a date predates schooling", () => {
+        expect(yearGroupAtDate(11, undefined)).toBeUndefined();
+        expect(yearGroupAtDate(7, "2005-01-01", "2026-03-01")).toBeUndefined();
+    });
+});

package/src/benchmarkEvidenceRules.ts CHANGED Viewed

@@ -1,4 +1,4 @@
-import {ExternalEvent, StudentActivity} from "./typeDefinitions";
+import {CareersRecordEntry, ExternalEvent, StudentActivity} from "./typeDefinitions";
 import {COMPASS_PAL_BENCHMARKS, COMPASS_VALID_ACTIVITY_BENCHMARKS} from "./compassExport";
 /**
@@ -30,7 +30,30 @@ export type BenchmarkEvidenceSource =
     | "events" // tagged events only.
     | "eventsAndActivities" // tagged events + StudentActivity encounter records.
     | "eventsAndPlacements" // tagged events + work-experience placements.
-    | "untracked"; // BM8 — not yet captured on CareerThread. Honest empty state, never faked.
+    | "guidance"; // BM8 — personal guidance entries on the pupil's careers record.
+/**
+ * ─── Time model ───────────────────────────────────────────────────────────────
+ * The period a benchmark's coverage is measured over. This is NOT cosmetic: the
+ * benchmarks genuinely differ, and measuring them all annually (as this module
+ * originally did) understates coverage badly.
+ *
+ *   BM5 renews every year      → "Every year, from the age of 11, at least one
+ *                                 meaningful encounter with an employer."
+ *   BM2 runs per Key Stage     → "During each Key Stage, all pupils should access
+ *                                 and use information about careers…"
+ *   BM6/7/8 are cumulative     → "By the age of 16… and a further one by 18."
+ *
+ * The cumulative case is the one that bites. Measured annually, a Year 11 who did
+ * their work experience in Year 10 reads as uncovered, and every pupil in Years 7-9
+ * sits in the denominator of a duty that does not apply to them until 16 — which is
+ * why `biggestGap` currently keeps nominating Year 7 as a school's worst gap on BM6.
+ */
+export type BenchmarkTimeModel =
+    | "annual" // renews each academic year (BM5)
+    | "keyStage" // once per Key Stage (BM2)
+    | "cumulativeByAge" // ever, judged at the age-16 and age-18 checkpoints (BM6, BM7, BM8)
+    | "provision"; // no per-pupil period (BM1, BM4)
 export type BenchmarkMeta = {
     number: GatsbyBenchmarkNumber,
@@ -41,23 +64,28 @@ export type BenchmarkMeta = {
     source: BenchmarkEvidenceSource,
     /**
      * Whether this benchmark yields a per-student coverage number. False for BM1
-     * (provision-level, shown as an informational card) and BM8 (untracked, shown
-     * as an honest empty state). The dashboard must not render a coverage % for a
-     * benchmark where this is false.
+     * (provision-level, shown as an informational card). The dashboard must not
+     * render a coverage % for a benchmark where this is false.
      */
     countsTowardCoverage: boolean,
     /** True for 5-7: the PAL Compliance flag is meaningful (mirrors COMPASS_PAL_BENCHMARKS). */
     palRelevant: boolean,
+    /** How coverage is periodised. Drives both the denominator and the card's label. */
+    timeModel: BenchmarkTimeModel,
 };
 /**
- * Benchmarks that produce a coverage percentage on the matrix / cards. Deliberately
- * BM2-8 excluding the two that can't be a per-student coverage number: BM1
- * (provision) and BM8 (untracked). Derived from the Compass export's valid set so
- * the two files can't drift.
+ * Benchmarks that produce a coverage percentage on the matrix / cards. BM1 is the
+ * only exclusion: it is whole-programme provision and can never be a per-pupil
+ * number. Derived from the Compass export's valid set (2-8) so the two files can't
+ * drift.
+ *
+ * BM8 was previously excluded here because personal guidance was untracked. It is
+ * now recorded on the careers record, so it earns a coverage number like the rest —
+ * but a cumulative, age-banded one. See BENCHMARK_AGE_CHECKPOINTS.
  */
 export const BENCHMARK_COVERAGE_NUMBERS: GatsbyBenchmarkNumber[] =
-    COMPASS_VALID_ACTIVITY_BENCHMARKS.filter((b): b is GatsbyBenchmarkNumber => b !== 8);
+    [...COMPASS_VALID_ACTIVITY_BENCHMARKS] as GatsbyBenchmarkNumber[];
 export const BENCHMARK_META: Record<GatsbyBenchmarkNumber, BenchmarkMeta> = {
     1: {
@@ -67,6 +95,7 @@ export const BENCHMARK_META: Record<GatsbyBenchmarkNumber, BenchmarkMeta> = {
         source: "provision",
         countsTowardCoverage: false,
         palRelevant: false,
+        timeModel: "provision",
     },
     2: {
         number: 2,
@@ -75,6 +104,9 @@ export const BENCHMARK_META: Record<GatsbyBenchmarkNumber, BenchmarkMeta> = {
         source: "events",
         countsTowardCoverage: true,
         palRelevant: false,
+        // The benchmark's unit is the Key Stage, not the year. Still measured annually
+        // until the Key Stage denominator lands — see BENCHMARK_AGE_CHECKPOINTS.
+        timeModel: "annual",
     },
     3: {
         number: 3,
@@ -83,6 +115,7 @@ export const BENCHMARK_META: Record<GatsbyBenchmarkNumber, BenchmarkMeta> = {
         source: "destinations",
         countsTowardCoverage: true,
         palRelevant: false,
+        timeModel: "annual",
     },
     4: {
         number: 4,
@@ -91,6 +124,7 @@ export const BENCHMARK_META: Record<GatsbyBenchmarkNumber, BenchmarkMeta> = {
         source: "events",
         countsTowardCoverage: true,
         palRelevant: false,
+        timeModel: "annual",
     },
     5: {
         number: 5,
@@ -99,6 +133,9 @@ export const BENCHMARK_META: Record<GatsbyBenchmarkNumber, BenchmarkMeta> = {
         source: "eventsAndActivities",
         countsTowardCoverage: true,
         palRelevant: true,
+        // The one benchmark whose annual model matches its own wording: "every year,
+        // from the age of 11, at least one meaningful encounter with an employer".
+        timeModel: "annual",
     },
     6: {
         number: 6,
@@ -107,6 +144,7 @@ export const BENCHMARK_META: Record<GatsbyBenchmarkNumber, BenchmarkMeta> = {
         source: "eventsAndPlacements",
         countsTowardCoverage: true,
         palRelevant: true,
+        timeModel: "cumulativeByAge",
     },
     7: {
         number: 7,
@@ -115,17 +153,73 @@ export const BENCHMARK_META: Record<GatsbyBenchmarkNumber, BenchmarkMeta> = {
         source: "events",
         countsTowardCoverage: true,
         palRelevant: true,
+        timeModel: "cumulativeByAge",
     },
     8: {
         number: 8,
         name: "Personal guidance",
-        description: "Every pupil has personal guidance interviews with a careers adviser when they need them.",
-        source: "untracked",
-        countsTowardCoverage: false,
+        description: "Every pupil has a personal guidance meeting with a careers adviser by 16, and a further one by 18.",
+        source: "guidance",
+        countsTowardCoverage: true,
         palRelevant: false,
+        timeModel: "cumulativeByAge",
     },
 };
+/**
+ * ─── Age checkpoints for cumulative benchmarks ────────────────────────────────
+ * BM6, BM7 and BM8 are all phrased as "by the age of 16… and by 18". Coverage for
+ * these is judged at the two points where the duty actually falls due, not spread
+ * across every year group: asking what proportion of Year 7 has had a personal
+ * guidance meeting measures nothing, because none of them are due one yet.
+ *
+ * The headline figure for each checkpoint is therefore the *due* cohort — the year
+ * group at which the duty has just become expected. Earlier year groups still get a
+ * progression figure (are we on track?), but they must not drag the headline down.
+ */
+export type BenchmarkAgeCheckpoint = {
+    /** The age the benchmark names. */
+    age: 16|18,
+    /** The year group at which the duty has fallen due in full. */
+    dueYearGroup: number,
+    /** Year groups the duty is accumulating across, up to and including the due one. */
+    accumulatingYearGroups: number[],
+    label: string,
+};
+export const BENCHMARK_AGE_CHECKPOINTS: BenchmarkAgeCheckpoint[] = [
+    {age: 16, dueYearGroup: 11, accumulatingYearGroups: [7, 8, 9, 10, 11], label: "By age 16"},
+    {age: 18, dueYearGroup: 13, accumulatingYearGroups: [12, 13], label: "By age 18"},
+];
+/** The checkpoint a year group is working towards, or undefined if off-scale. */
+export function ageCheckpointForYearGroup(yearGroup: number): BenchmarkAgeCheckpoint|undefined {
+    return BENCHMARK_AGE_CHECKPOINTS.find((c) => c.accumulatingYearGroups.includes(yearGroup));
+}
+/**
+ * The pupil's year group at some earlier date, back-derived from their current year
+ * group. Records written before `yearGroupAtEntry` existed (and every placement and
+ * event, which never carried one) have no snapshot, so cumulative coverage has to
+ * reconstruct it: each academic year that has elapsed since the record is one year
+ * group to subtract.
+ *
+ * Returns undefined when the result falls outside schooling, which is the honest
+ * answer for a record whose date predates the pupil joining.
+ */
+export function yearGroupAtDate(
+    currentYearGroup: number,
+    recordDate: string|undefined,
+    now: Date|string = new Date(),
+): number|undefined {
+    if (!recordDate) return undefined;
+    const recordYear = parseInt(academicYearForDate(recordDate).split("-")[0], 10);
+    const currentYear = parseInt(academicYearForDate(now).split("-")[0], 10);
+    if (isNaN(recordYear) || isNaN(currentYear)) return undefined;
+    const derived = currentYearGroup - (currentYear - recordYear);
+    return derived >= 1 && derived <= 15 ? derived : undefined;
+}
 /**
  * StudentActivity.activityType → the benchmark(s) that activity is evidence for.
  * Employer-facing encounters count towards BM5; first-hand workplace experiences
@@ -204,6 +298,33 @@ export function activityEvidenceBenchmarks(activity: Pick<StudentActivity, "acti
     return ACTIVITY_TYPE_BENCHMARKS[activity.activityType] || [];
 }
+/**
+ * ─── Careers record entries as evidence ───────────────────────────────────────
+ * Every entry is BM3 evidence: the updated Benchmark 3 asks schools to record the
+ * individual advice given to each pupil and any decisions subsequently agreed, and
+ * makes no distinction between a formal guidance interview and an option-choice
+ * conversation for that purpose.
+ *
+ * BM8 is far narrower. It is satisfied only by a personal guidance meeting with a
+ * careers adviser trained to an appropriate level. A school that logs fifty tutor-time
+ * careers chats has kept excellent records and has NOT delivered personal guidance, so
+ * only `personalGuidance` entries with `adviserQualified` count here. Loosening this
+ * would manufacture compliance with a statutory expectation, which is the one thing
+ * this module exists to prevent.
+ */
+export function isPersonalGuidanceEntry(
+    entry: Pick<CareersRecordEntry, "entryType"|"adviserQualified">,
+): boolean {
+    return entry.entryType === "personalGuidance" && Boolean(entry.adviserQualified);
+}
+/** The benchmarks a careers record entry is evidence for. */
+export function careersRecordEvidenceBenchmarks(
+    entry: Pick<CareersRecordEntry, "entryType"|"adviserQualified">,
+): GatsbyBenchmarkNumber[] {
+    return isPersonalGuidanceEntry(entry) ? [3, 8] : [3];
+}
 /**
  * A PAL-compliant provider encounter: the event carries the existing PAL flag AND
  * is tagged with a PAL-relevant benchmark (5-7). Same rule the export uses when

package/src/productResolver.ts CHANGED Viewed

@@ -23,6 +23,11 @@ export type ProductKey =
     "wex"|"network"|"parents"|"events"|"skills"|"activities"|"destinations"|"alumni";
 export type ResolvedProducts = Record<ProductKey, boolean> & {
+    /** How many parents are actually in the database, across `options.oIds`.
+     * `parents` is just this over zero; the number is surfaced so a caller that
+     * wants to show the count doesn't run the same aggregate a second time.
+     * Zero until the count lands, the same as the flag. */
+    parentCount: number,
     /** Package shape, so callers stop testing `package ===` themselves. */
     isTrust: boolean,
     isHub: boolean,
@@ -145,6 +150,7 @@ export function useProductResolver(
     return {
         ...products,
+        parentCount,
         isTrust,
         isHub,
         isHubSchool,

package/src/typeDefinitions.ts CHANGED Viewed

@@ -3380,6 +3380,89 @@ export type StudentActivity = {
   evidenceFileIds?: string[];
 };
+/**
+ * ─── Careers record ───────────────────────────────────────────────────────────
+ * A staff-authored record of a careers interaction with one pupil. Deliberately
+ * modelled as the pupil's *careers record* rather than a meetings log, because
+ * Gatsby Benchmark 3 asks schools to keep systematic records of "the individual
+ * advice given to each pupil, and any subsequent agreed decisions" — not only of
+ * formal guidance interviews.
+ *
+ * Only `personalGuidance` entries delivered by a qualified adviser are evidence
+ * for Benchmark 8. Every other type is BM3 record-keeping and must NOT move the
+ * BM8 number: a school that logs fifty option-choice chats has not delivered
+ * personal guidance, and showing otherwise would fabricate compliance.
+ */
+export type CareersRecordEntryType =
+    | "personalGuidance"      // 1:1 with a careers adviser — the only BM8-valid type
+    | "careersConversation"   // tutor-time or drop-in conversation
+    | "optionsMeeting"        // GCSE/A-level option choices
+    | "applicationSupport"    // UCAS, apprenticeship or college applications
+    | "sendReview"            // careers input to an EHCP annual review (Y9+)
+    | "parentMeeting"         // careers conversation with a parent or carer
+    | "groupGuidance"         // small-group guidance session
+    | "other";
+/** A single agreed next step arising from a careers record entry. */
+export type CareersRecordAction = {
+    label: string,
+    owner?: "student"|"staff",
+    dueDate?: string,           // ISO date
+    done?: boolean,
+};
+export type CareersRecordEntry = {
+    id: string,
+    uid: string,                // pupil
+    oId: string,
+    entryType: CareersRecordEntryType,
+    date: string,               // ISO date the interaction happened
+    /** Staff member who delivered it. Advisers are always platform users. */
+    adviserUid: string,
+    /**
+     * Whether the adviser was, at the time of this entry, trained to a level the
+     * school considers appropriate for personal guidance. Snapshotted rather than
+     * read live from the staff record so that later changes to a staff member's
+     * qualification cannot silently restate a previous year's BM8 coverage.
+     *
+     * Note the framework says "trained to an appropriate level", not Level 6 —
+     * Level 6 is the CDI's professional standard and what most hubs expect, but
+     * gating strictly on it would wrongly zero out schools whose adviser
+     * qualified by another route. The school asserts this; we record it.
+     */
+    adviserQualified: boolean,
+    /**
+     * The pupil's year group when the interaction happened. Snapshotted because
+     * BM8 is a cumulative "by age 16 / by age 18" duty and pupils roll up a year
+     * group every August — without this, a Year 9 meeting becomes unattributable
+     * once the pupil reaches Year 11.
+     */
+    yearGroupAtEntry?: number,
+    /** Academic year label, e.g. "2025-26". See academicYearForDate. */
+    academicYear: string,
+    mode: "inPerson"|"video"|"phone",
+    durationMins?: number,
+    /** Shared with the pupil. BM3 expects pupils to be able to access their record. */
+    summary: string,
+    /** Never shown to the pupil. Kept separate so the summary can be surfaced safely. */
+    staffNotes?: string,
+    /** "Any subsequent agreed decisions" — named in the benchmark, so evidence in its own right. */
+    actions?: CareersRecordAction[],
+    createdBy: string,          // uid of the staff member who wrote the record
+    dateCreated: string,        // ISO timestamp
+    dateUpdated?: string,
+};
 export type SuggestedFixRepo = "placementt-web"|"placementt-backend"|"placementt-core";
 export type SuggestedFix = {