placementt-core 1.400.939 → 1.400.941

package/lib/benchmarkEvidenceRules.d.ts

@@ -0,0 +1,113 @@
+import { ExternalEvent, StudentActivity } from "./typeDefinitions";
+/**
+ * ─── Single source of truth for Gatsby Benchmark *evidence* ───────────────────
+ *
+ * This module lives beside compassExport on purpose. The Benchmarks dashboard and
+ * the Compass+ export must never disagree about which benchmarks an event counts
+ * for, so both derive from the SAME mapping. compassExport owns what can be
+ * *exported* (COMPASS_VALID_ACTIVITY_BENCHMARKS = 2-8, COMPASS_PAL_BENCHMARKS =
+ * 5-7); this module owns what counts as *evidence coverage* on the dashboard, and
+ * it imports those constants rather than re-declaring them.
+ *
+ * Framing rule the whole feature obeys: CareerThread is not a Compass replacement
+ * and never shows an official benchmark "score". Schools still self-report in
+ * Compass. This module classifies *evidence* so the dashboard can show what exists
+ * and where the gaps are; it computes coverage, not compliance.
+ */
+export declare const GATSBY_BENCHMARK_NUMBERS: readonly [1, 2, 3, 4, 5, 6, 7, 8];
+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 BenchmarkMeta = {
+    number: GatsbyBenchmarkNumber;
+    /** Short title (no "GB"/"score" wording). */
+    name: string;
+    /** One-line, plain-English description for the overview card. */
+    description: string;
+    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.
+     */
+    countsTowardCoverage: boolean;
+    /** True for 5-7: the PAL Compliance flag is meaningful (mirrors COMPASS_PAL_BENCHMARKS). */
+    palRelevant: boolean;
+};
+/**
+ * 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.
+ */
+export declare const BENCHMARK_COVERAGE_NUMBERS: GatsbyBenchmarkNumber[];
+export declare const BENCHMARK_META: Record<GatsbyBenchmarkNumber, BenchmarkMeta>;
+/**
+ * StudentActivity.activityType → the benchmark(s) that activity is evidence for.
+ * Employer-facing encounters count towards BM5; first-hand workplace experiences
+ * count towards BM6. "workshop"/"onlineProgramme" are treated as employer
+ * encounters (BM5). "other" is intentionally unmapped: we don't guess a benchmark
+ * from an untyped activity (that would fabricate coverage).
+ */
+export declare const ACTIVITY_TYPE_BENCHMARKS: Record<StudentActivity["activityType"], GatsbyBenchmarkNumber[]>;
+/**
+ * The benchmarks an event provides evidence for: its tagged Gatsby benchmarks,
+ * limited to the ones the dashboard tracks per-benchmark (2-8). GB1 is excluded
+ * here exactly as it is excluded from the export — a GB1-only event is a
+ * programme-level statement, not per-pupil evidence.
+ */
+export declare function eventEvidenceBenchmarks(event: Pick<ExternalEvent, "gatsbyBenchmarks">): GatsbyBenchmarkNumber[];
+/** Whether an event is tagged as evidence for a specific benchmark. */
+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[];
+/**
+ * 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
+ * deciding whether to stamp the PAL Compliance column.
+ */
+export declare function isPalCompliantProviderEncounter(event: Pick<ExternalEvent, "palCompliant" | "gatsbyBenchmarks">): boolean;
+/**
+ * ─── PAL phases (s.42B Education Act 1997) ─────────────────────────────────────
+ * Provider Access Legislation expects two provider encounters in each of three
+ * phases. The dashboard's PAL panel counts PAL-compliant encounters per phase
+ * against this target.
+ */
+export declare const PAL_ENCOUNTERS_PER_PHASE = 2;
+export type PalPhase = {
+    /** 1 | 2 | 3 */
+    phase: 1 | 2 | 3;
+    label: string;
+    yearGroups: number[];
+};
+export declare const PAL_PHASES: PalPhase[];
+/** Which PAL phase a year group falls into, or undefined (e.g. Year 7). */
+export declare function palPhaseForYearGroup(yearGroup: number): PalPhase | undefined;
+/**
+ * ─── Academic year ────────────────────────────────────────────────────────────
+ * Statutory reporting runs on the academic year (England: 1 Sep - 31 Aug). Coverage
+ * on the dashboard is always "this academic year", so evidence classification and
+ * the UI must agree on where a date falls. Mirrors the aspiration academic-year rule
+ * used in Destinations (rollover at August).
+ */
+/** Academic year label for a date, e.g. "2025-26". Aug (month 8+) rolls to the new year. */
+export declare function academicYearForDate(date?: Date | string): string;
+/** Inclusive [start, end) ISO date bounds (yyyy-mm-dd) for an academic-year label. */
+export declare function academicYearDateRange(academicYear?: string): {
+    start: string;
+    end: string;
+};
+/** True if an ISO date string falls within the given academic year. */
+export declare function dateInAcademicYear(dateStr: string | undefined, academicYear?: string): boolean;
+/**
+ * ─── Coverage indicator ────────────────────────────────────────────────────────
+ * Buckets a coverage fraction (0-1) into a neutral→primary scale — deliberately NOT
+ * red/green, to avoid compliance theatre. `undefined` when a benchmark carries no
+ * coverage number (BM1/BM8) so callers render an informational/empty state instead.
+ */
+export type CoverageBand = "none" | "low" | "partial" | "strong" | "full";
+export declare function coverageBand(fraction: number): CoverageBand;

package/lib/benchmarkEvidenceRules.js

@@ -0,0 +1,201 @@
+"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.eventEvidenceBenchmarks = eventEvidenceBenchmarks;
+exports.eventProvidesBenchmark = eventProvidesBenchmark;
+exports.activityEvidenceBenchmarks = activityEvidenceBenchmarks;
+exports.isPalCompliantProviderEncounter = isPalCompliantProviderEncounter;
+exports.palPhaseForYearGroup = palPhaseForYearGroup;
+exports.academicYearForDate = academicYearForDate;
+exports.academicYearDateRange = academicYearDateRange;
+exports.dateInAcademicYear = dateInAcademicYear;
+exports.coverageBand = coverageBand;
+const compassExport_1 = require("./compassExport");
+/**
+ * ─── Single source of truth for Gatsby Benchmark *evidence* ───────────────────
+ *
+ * This module lives beside compassExport on purpose. The Benchmarks dashboard and
+ * the Compass+ export must never disagree about which benchmarks an event counts
+ * for, so both derive from the SAME mapping. compassExport owns what can be
+ * *exported* (COMPASS_VALID_ACTIVITY_BENCHMARKS = 2-8, COMPASS_PAL_BENCHMARKS =
+ * 5-7); this module owns what counts as *evidence coverage* on the dashboard, and
+ * it imports those constants rather than re-declaring them.
+ *
+ * Framing rule the whole feature obeys: CareerThread is not a Compass replacement
+ * and never shows an official benchmark "score". Schools still self-report in
+ * Compass. This module classifies *evidence* so the dashboard can show what exists
+ * and where the gaps are; it computes coverage, not compliance.
+ */
+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.
+ */
+exports.BENCHMARK_COVERAGE_NUMBERS = compassExport_1.COMPASS_VALID_ACTIVITY_BENCHMARKS.filter((b) => b !== 8);
+exports.BENCHMARK_META = {
+    1: {
+        number: 1,
+        name: "A stable careers programme",
+        description: "A written, resourced careers programme that pupils, parents, staff and employers all understand.",
+        source: "provision",
+        countsTowardCoverage: false,
+        palRelevant: false,
+    },
+    2: {
+        number: 2,
+        name: "Learning from career & labour market information",
+        description: "Every pupil, and their parents, can access good-quality career and labour-market information.",
+        source: "events",
+        countsTowardCoverage: true,
+        palRelevant: false,
+    },
+    3: {
+        number: 3,
+        name: "Addressing the needs of each pupil",
+        description: "Careers support is tailored to each pupil, and records are kept and acted on.",
+        source: "destinations",
+        countsTowardCoverage: true,
+        palRelevant: false,
+    },
+    4: {
+        number: 4,
+        name: "Linking curriculum learning to careers",
+        description: "Subject teaching shows pupils how what they learn is relevant to a wide range of careers.",
+        source: "events",
+        countsTowardCoverage: true,
+        palRelevant: false,
+    },
+    5: {
+        number: 5,
+        name: "Encounters with employers and employees",
+        description: "Every pupil has multiple meaningful encounters with employers and working people.",
+        source: "eventsAndActivities",
+        countsTowardCoverage: true,
+        palRelevant: true,
+    },
+    6: {
+        number: 6,
+        name: "Experiences of workplaces",
+        description: "Every pupil has first-hand experience of a workplace to help their exploration of careers.",
+        source: "eventsAndPlacements",
+        countsTowardCoverage: true,
+        palRelevant: true,
+    },
+    7: {
+        number: 7,
+        name: "Encounters with further & higher education",
+        description: "Every pupil understands the full range of learning routes — academic, technical and apprenticeships.",
+        source: "events",
+        countsTowardCoverage: true,
+        palRelevant: true,
+    },
+    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,
+        palRelevant: false,
+    },
+};
+/**
+ * StudentActivity.activityType → the benchmark(s) that activity is evidence for.
+ * Employer-facing encounters count towards BM5; first-hand workplace experiences
+ * count towards BM6. "workshop"/"onlineProgramme" are treated as employer
+ * encounters (BM5). "other" is intentionally unmapped: we don't guess a benchmark
+ * from an untyped activity (that would fabricate coverage).
+ */
+exports.ACTIVITY_TYPE_BENCHMARKS = {
+    employerTalk: [5],
+    workshop: [5],
+    onlineProgramme: [5],
+    workShadowing: [6],
+    partTimeWork: [6],
+    volunteering: [6],
+    other: [],
+};
+/**
+ * The benchmarks an event provides evidence for: its tagged Gatsby benchmarks,
+ * limited to the ones the dashboard tracks per-benchmark (2-8). GB1 is excluded
+ * here exactly as it is excluded from the export — a GB1-only event is a
+ * programme-level statement, not per-pupil evidence.
+ */
+function eventEvidenceBenchmarks(event) {
+    return (event.gatsbyBenchmarks || [])
+        .filter((b) => compassExport_1.COMPASS_VALID_ACTIVITY_BENCHMARKS.includes(b));
+}
+/** Whether an event is tagged as evidence for a specific benchmark. */
+function eventProvidesBenchmark(event, benchmark) {
+    return eventEvidenceBenchmarks(event).includes(benchmark);
+}
+/** The benchmarks a logged student activity is evidence for. */
+function activityEvidenceBenchmarks(activity) {
+    return exports.ACTIVITY_TYPE_BENCHMARKS[activity.activityType] || [];
+}
+/**
+ * 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
+ * deciding whether to stamp the PAL Compliance column.
+ */
+function isPalCompliantProviderEncounter(event) {
+    if (!event.palCompliant)
+        return false;
+    return eventEvidenceBenchmarks(event).some((b) => compassExport_1.COMPASS_PAL_BENCHMARKS.includes(b));
+}
+/**
+ * ─── PAL phases (s.42B Education Act 1997) ─────────────────────────────────────
+ * Provider Access Legislation expects two provider encounters in each of three
+ * phases. The dashboard's PAL panel counts PAL-compliant encounters per phase
+ * against this target.
+ */
+exports.PAL_ENCOUNTERS_PER_PHASE = 2;
+exports.PAL_PHASES = [
+    { phase: 1, label: "Years 8-9", yearGroups: [8, 9] },
+    { phase: 2, label: "Years 10-11", yearGroups: [10, 11] },
+    { phase: 3, label: "Years 12-13", yearGroups: [12, 13] },
+];
+/** Which PAL phase a year group falls into, or undefined (e.g. Year 7). */
+function palPhaseForYearGroup(yearGroup) {
+    return exports.PAL_PHASES.find((p) => p.yearGroups.includes(yearGroup));
+}
+/**
+ * ─── Academic year ────────────────────────────────────────────────────────────
+ * Statutory reporting runs on the academic year (England: 1 Sep - 31 Aug). Coverage
+ * on the dashboard is always "this academic year", so evidence classification and
+ * the UI must agree on where a date falls. Mirrors the aspiration academic-year rule
+ * used in Destinations (rollover at August).
+ */
+/** Academic year label for a date, e.g. "2025-26". Aug (month 8+) rolls to the new year. */
+function academicYearForDate(date = new Date()) {
+    const d = typeof date === "string" ? new Date(date) : date;
+    const y = d.getFullYear();
+    const m = d.getMonth() + 1;
+    const startYear = m >= 8 ? y : y - 1;
+    return `${startYear}-${String((startYear + 1) % 100).padStart(2, "0")}`;
+}
+/** Inclusive [start, end) ISO date bounds (yyyy-mm-dd) for an academic-year label. */
+function academicYearDateRange(academicYear = academicYearForDate()) {
+    const startYear = parseInt(academicYear.split("-")[0], 10);
+    return { start: `${startYear}-08-01`, end: `${startYear + 1}-08-01` };
+}
+/** True if an ISO date string falls within the given academic year. */
+function dateInAcademicYear(dateStr, academicYear = academicYearForDate()) {
+    if (!dateStr)
+        return false;
+    const { start, end } = academicYearDateRange(academicYear);
+    return dateStr >= start && dateStr < end;
+}
+function coverageBand(fraction) {
+    if (fraction <= 0)
+        return "none";
+    if (fraction < 0.34)
+        return "low";
+    if (fraction < 0.67)
+        return "partial";
+    if (fraction < 1)
+        return "strong";
+    return "full";
+}
+//# sourceMappingURL=benchmarkEvidenceRules.js.map

package/lib/benchmarkEvidenceRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmarkEvidenceRules.js","sourceRoot":"","sources":["../src/benchmarkEvidenceRules.ts"],"names":[],"mappings":"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"}

package/lib/benchmarkEvidenceRules.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/benchmarkEvidenceRules.test.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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));
+        expect(benchmarkEvidenceRules_1.BENCHMARK_COVERAGE_NUMBERS).not.toContain(1);
+        expect(benchmarkEvidenceRules_1.BENCHMARK_COVERAGE_NUMBERS).not.toContain(8);
+    });
+    it("marks BM1 as provision-level and BM8 as untracked — neither counts toward coverage", () => {
+        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");
+    });
+    it("flags PAL relevance for exactly benchmarks 5-7", () => {
+        [1, 2, 3, 4, 5, 6, 7, 8].forEach((b) => {
+            expect(benchmarkEvidenceRules_1.BENCHMARK_META[b].palRelevant)
+                .toBe(compassExport_1.COMPASS_PAL_BENCHMARKS.includes(b));
+        });
+    });
+});
+describe("event evidence classification", () => {
+    it("keeps tagged 2-8 benchmarks and drops GB1", () => {
+        expect((0, benchmarkEvidenceRules_1.eventEvidenceBenchmarks)({ gatsbyBenchmarks: [1, 5, 7] })).toEqual([5, 7]);
+        expect((0, benchmarkEvidenceRules_1.eventProvidesBenchmark)({ gatsbyBenchmarks: [1] }, 1)).toBe(false);
+        expect((0, benchmarkEvidenceRules_1.eventProvidesBenchmark)({ gatsbyBenchmarks: [5] }, 5)).toBe(true);
+    });
+    it("counts a PAL encounter only when flagged AND tagged 5-7", () => {
+        expect((0, benchmarkEvidenceRules_1.isPalCompliantProviderEncounter)({ palCompliant: true, gatsbyBenchmarks: [7] })).toBe(true);
+        expect((0, benchmarkEvidenceRules_1.isPalCompliantProviderEncounter)({ palCompliant: true, gatsbyBenchmarks: [4] })).toBe(false);
+        expect((0, benchmarkEvidenceRules_1.isPalCompliantProviderEncounter)({ palCompliant: false, gatsbyBenchmarks: [7] })).toBe(false);
+    });
+});
+describe("student activity classification", () => {
+    it("maps employer encounters to BM5 and workplace experiences to BM6", () => {
+        expect((0, benchmarkEvidenceRules_1.activityEvidenceBenchmarks)({ activityType: "employerTalk" })).toEqual([5]);
+        expect((0, benchmarkEvidenceRules_1.activityEvidenceBenchmarks)({ activityType: "workShadowing" })).toEqual([6]);
+        expect((0, benchmarkEvidenceRules_1.activityEvidenceBenchmarks)({ activityType: "partTimeWork" })).toEqual([6]);
+    });
+    it("never fabricates a benchmark from an untyped 'other' activity", () => {
+        expect((0, benchmarkEvidenceRules_1.activityEvidenceBenchmarks)({ activityType: "other" })).toEqual([]);
+    });
+});
+describe("PAL phases", () => {
+    it("assigns year groups to the three statutory phases and leaves Year 7 unphased", () => {
+        expect((0, benchmarkEvidenceRules_1.palPhaseForYearGroup)(9)?.phase).toBe(1);
+        expect((0, benchmarkEvidenceRules_1.palPhaseForYearGroup)(11)?.phase).toBe(2);
+        expect((0, benchmarkEvidenceRules_1.palPhaseForYearGroup)(13)?.phase).toBe(3);
+        expect((0, benchmarkEvidenceRules_1.palPhaseForYearGroup)(7)).toBeUndefined();
+    });
+});
+describe("academic year", () => {
+    it("rolls over at August", () => {
+        expect((0, benchmarkEvidenceRules_1.academicYearForDate)("2025-09-15")).toBe("2025-26");
+        expect((0, benchmarkEvidenceRules_1.academicYearForDate)("2026-07-02")).toBe("2025-26");
+        expect((0, benchmarkEvidenceRules_1.academicYearForDate)("2026-08-01")).toBe("2026-27");
+    });
+    it("produces an inclusive-start, exclusive-end range and tests membership", () => {
+        expect((0, benchmarkEvidenceRules_1.academicYearDateRange)("2025-26")).toEqual({ start: "2025-08-01", end: "2026-08-01" });
+        expect((0, benchmarkEvidenceRules_1.dateInAcademicYear)("2025-12-01", "2025-26")).toBe(true);
+        expect((0, benchmarkEvidenceRules_1.dateInAcademicYear)("2026-08-01", "2025-26")).toBe(false);
+        expect((0, benchmarkEvidenceRules_1.dateInAcademicYear)(undefined, "2025-26")).toBe(false);
+    });
+});
+describe("coverage bands are neutral (no pass/fail theatre)", () => {
+    it("buckets fractions onto a none→full scale", () => {
+        expect((0, benchmarkEvidenceRules_1.coverageBand)(0)).toBe("none");
+        expect((0, benchmarkEvidenceRules_1.coverageBand)(0.2)).toBe("low");
+        expect((0, benchmarkEvidenceRules_1.coverageBand)(0.5)).toBe("partial");
+        expect((0, benchmarkEvidenceRules_1.coverageBand)(0.9)).toBe("strong");
+        expect((0, benchmarkEvidenceRules_1.coverageBand)(1)).toBe("full");
+    });
+});
+//# sourceMappingURL=benchmarkEvidenceRules.test.js.map

package/lib/benchmarkEvidenceRules.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmarkEvidenceRules.test.js","sourceRoot":"","sources":["../src/benchmarkEvidenceRules.test.ts"],"names":[],"mappings":"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"}

package/lib/compassExport.d.ts

@@ -0,0 +1,64 @@
+import { ExternalEvent } from "./typeDefinitions";
+/**
+ * Benchmarks Compass+ accepts on an individual Activity row. GB1 ("a stable careers programme")
+ * describes whole-provision leadership, not a single encounter. CEC's Activities Upload template
+ * only offers Benchmarks 2-8 in its Benchmark dropdown, so GB1-only events have nothing to export.
+ */
+export declare const COMPASS_VALID_ACTIVITY_BENCHMARKS: number[];
+/**
+ * Benchmarks where the PAL Compliance column is meaningful. Provider Access Legislation covers
+ * encounters with technical education/apprenticeship providers, which sit under GB5-7. Compass+
+ * only reflects this field on activities tagged with one of these three.
+ */
+export declare const COMPASS_PAL_BENCHMARKS: number[];
+/**
+ * Whether CareerThread is currently a CEC-recognised Compass+ "Partner Platform" (the status
+ * Unifrog, Xello/Cascaid, Morrisby etc. have). Compass+'s "Partner Platform" upload format tries
+ * to auto-detect the source from the file, and an unrecognised source can hit a "Missing Activity
+ * Source Data" error with no listed option to resolve it. So while this is false, exports use
+ * Compass+'s plain 8-column template instead, the one every Compass+ user already downloads and
+ * fills in by hand inside their own account. That format has no source-detection step at all,
+ * because it isn't claiming to come from anywhere, so it can't hit that error. The trade-off:
+ * that template has no PAL Compliance / Parent Attendance columns, so those two fields are
+ * dropped from the file (not from our own data) until this flips to true, at which point the
+ * export automatically switches to the full 10-column partner format.
+ */
+export declare const COMPASS_PARTNER_PLATFORM_RECOGNISED = false;
+export declare const COMPASS_ACTIVITY_CSV_HEADERS: string[];
+export type CompassActivityRow = {
+    benchmark: number;
+    category: string;
+    activityName: string;
+    startDateTime: string;
+    endDateTime: string;
+    learnerUpns: string;
+    schoolLead: string;
+    notes: string;
+    palCompliance: "Yes" | "";
+    parentAttendance: "Yes" | "";
+};
+export type CompassExportIssue = {
+    eventId: string;
+    eventName: string;
+    level: "blocking" | "warning";
+    message: string;
+};
+/**
+ * Checks whether an event is safe to include in a Compass+ export. "blocking" issues mean the
+ * event is left out of the file entirely (it would fail Compass+'s own validation and, worse,
+ * could silently upload with the wrong benchmark/category). "warning" issues still get exported,
+ * but should be shown to staff before they send the file on to a school.
+ */
+export declare function validateCompassExportEvent(event: Partial<ExternalEvent> & {
+    id?: string;
+}, learnerCount: number, learnersWithUpnCount: number): CompassExportIssue[];
+/**
+ * Expands a single event into one Compass+ Activities-Upload row per valid benchmark. Compass+'s
+ * template is one benchmark + one category per row, so an event tagged with multiple benchmarks
+ * (e.g. an employer talk logged as both GB5 and GB7) becomes multiple rows sharing the same
+ * activity name, dates and learner list. Rows for benchmarks without a mandatory category are
+ * skipped: callers should run validateCompassExportEvent first and surface that as a blocking
+ * issue rather than silently dropping the row here.
+ */
+export declare function buildCompassActivityRows(event: Partial<ExternalEvent>, learnerUpns: string[]): CompassActivityRow[];
+export declare function compassActivityRowToCsvArray(row: CompassActivityRow): string[];

package/lib/compassExport.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMPASS_ACTIVITY_CSV_HEADERS = exports.COMPASS_PARTNER_PLATFORM_RECOGNISED = exports.COMPASS_PAL_BENCHMARKS = exports.COMPASS_VALID_ACTIVITY_BENCHMARKS = void 0;
+exports.validateCompassExportEvent = validateCompassExportEvent;
+exports.buildCompassActivityRows = buildCompassActivityRows;
+exports.compassActivityRowToCsvArray = compassActivityRowToCsvArray;
+/**
+ * Benchmarks Compass+ accepts on an individual Activity row. GB1 ("a stable careers programme")
+ * describes whole-provision leadership, not a single encounter. CEC's Activities Upload template
+ * only offers Benchmarks 2-8 in its Benchmark dropdown, so GB1-only events have nothing to export.
+ */
+exports.COMPASS_VALID_ACTIVITY_BENCHMARKS = [2, 3, 4, 5, 6, 7, 8];
+/**
+ * Benchmarks where the PAL Compliance column is meaningful. Provider Access Legislation covers
+ * encounters with technical education/apprenticeship providers, which sit under GB5-7. Compass+
+ * only reflects this field on activities tagged with one of these three.
+ */
+exports.COMPASS_PAL_BENCHMARKS = [5, 6, 7];
+/**
+ * Whether CareerThread is currently a CEC-recognised Compass+ "Partner Platform" (the status
+ * Unifrog, Xello/Cascaid, Morrisby etc. have). Compass+'s "Partner Platform" upload format tries
+ * to auto-detect the source from the file, and an unrecognised source can hit a "Missing Activity
+ * Source Data" error with no listed option to resolve it. So while this is false, exports use
+ * Compass+'s plain 8-column template instead, the one every Compass+ user already downloads and
+ * fills in by hand inside their own account. That format has no source-detection step at all,
+ * because it isn't claiming to come from anywhere, so it can't hit that error. The trade-off:
+ * that template has no PAL Compliance / Parent Attendance columns, so those two fields are
+ * dropped from the file (not from our own data) until this flips to true, at which point the
+ * export automatically switches to the full 10-column partner format.
+ */
+exports.COMPASS_PARTNER_PLATFORM_RECOGNISED = false;
+const COMPASS_ACTIVITY_CSV_HEADERS_NATIVE = [
+    "Benchmark", "Main category", "Activity name", "Start Date and Time",
+    "End Date and Time", "Learners involved", "School Lead", "Notes",
+];
+const COMPASS_ACTIVITY_CSV_HEADERS_PARTNER = [
+    ...COMPASS_ACTIVITY_CSV_HEADERS_NATIVE,
+    "PAL Compliance", "Parent Attendance",
+];
+exports.COMPASS_ACTIVITY_CSV_HEADERS = exports.COMPASS_PARTNER_PLATFORM_RECOGNISED ?
+    COMPASS_ACTIVITY_CSV_HEADERS_PARTNER : COMPASS_ACTIVITY_CSV_HEADERS_NATIVE;
+const formatDbDateTime = (dateStr, timeStr) => {
+    if (!dateStr)
+        return "";
+    const [y, m, d] = dateStr.split("-");
+    if (!y || !m || !d)
+        return "";
+    return `${d}/${m}/${y} ${timeStr || "09:00"}`;
+};
+/**
+ * Checks whether an event is safe to include in a Compass+ export. "blocking" issues mean the
+ * event is left out of the file entirely (it would fail Compass+'s own validation and, worse,
+ * could silently upload with the wrong benchmark/category). "warning" issues still get exported,
+ * but should be shown to staff before they send the file on to a school.
+ */
+function validateCompassExportEvent(event, learnerCount, learnersWithUpnCount) {
+    const issues = [];
+    const eventId = event.id || "";
+    const eventName = event.name || "Untitled event";
+    const push = (level, message) => issues.push({ eventId, eventName, level, message });
+    const validBenchmarks = (event.gatsbyBenchmarks || [])
+        .filter((b) => exports.COMPASS_VALID_ACTIVITY_BENCHMARKS.includes(b));
+    if (!validBenchmarks.length) {
+        push("blocking", "No Gatsby Benchmark (2-8) selected. Benchmark 1 alone can't be uploaded as an individual Compass+ activity.");
+    }
+    validBenchmarks.forEach((b) => {
+        if (!event.gatsbyCategories?.[b]) {
+            push("blocking", `Benchmark ${b} is selected but has no Compass+ category. Category is mandatory, Compass+ will reject this row.`);
+        }
+    });
+    if (!event.name)
+        push("blocking", "Event has no name.");
+    if (!event.startDate)
+        push("blocking", "Event has no start date.");
+    if (learnerCount > 0 && learnersWithUpnCount === 0) {
+        push("warning", "None of the attending learners have a UPN on file. Compass+ won't be able to match this activity to individual learner profiles.");
+    }
+    else if (learnersWithUpnCount < learnerCount) {
+        push("warning", `${learnerCount - learnersWithUpnCount} of ${learnerCount} attending learners are missing a UPN and will be left off this row.`);
+    }
+    // Not pushed as a per-event issue: whether we're on the native or partner template is a
+    // whole-export fact, identical for every row, not something specific to this event. Surface
+    // it once at the export-surface level instead (see COMPASS_PARTNER_PLATFORM_RECOGNISED).
+    return issues;
+}
+/**
+ * Expands a single event into one Compass+ Activities-Upload row per valid benchmark. Compass+'s
+ * template is one benchmark + one category per row, so an event tagged with multiple benchmarks
+ * (e.g. an employer talk logged as both GB5 and GB7) becomes multiple rows sharing the same
+ * activity name, dates and learner list. Rows for benchmarks without a mandatory category are
+ * skipped: callers should run validateCompassExportEvent first and surface that as a blocking
+ * issue rather than silently dropping the row here.
+ */
+function buildCompassActivityRows(event, learnerUpns) {
+    const validBenchmarks = (event.gatsbyBenchmarks || [])
+        .filter((b) => exports.COMPASS_VALID_ACTIVITY_BENCHMARKS.includes(b) && event.gatsbyCategories?.[b]);
+    return validBenchmarks.map((b) => ({
+        benchmark: b,
+        category: event.gatsbyCategories?.[b] || "",
+        activityName: event.name || "",
+        startDateTime: formatDbDateTime(event.startDate, event.startTime),
+        endDateTime: formatDbDateTime(event.endDate || event.startDate, event.endTime || event.startTime),
+        learnerUpns: learnerUpns.join(";"),
+        schoolLead: event.designatedStaffText || "",
+        notes: event.description || "",
+        palCompliance: (event.palCompliant && exports.COMPASS_PAL_BENCHMARKS.includes(b)) ? "Yes" : "",
+        parentAttendance: event.parentAttendance ? "Yes" : "",
+    }));
+}
+function compassActivityRowToCsvArray(row) {
+    const base = [
+        String(row.benchmark),
+        row.category,
+        row.activityName,
+        row.startDateTime,
+        row.endDateTime,
+        row.learnerUpns,
+        row.schoolLead,
+        row.notes,
+    ];
+    // Matches COMPASS_ACTIVITY_CSV_HEADERS: only add these two columns once we're on the
+    // partner-recognised (10-column) template.
+    if (!exports.COMPASS_PARTNER_PLATFORM_RECOGNISED)
+        return base;
+    return [...base, row.palCompliance, row.parentAttendance];
+}
+//# sourceMappingURL=compassExport.js.map

package/lib/compassExport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compassExport.js","sourceRoot":"","sources":["../src/compassExport.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -9,6 +9,9 @@ export * from "./firebase/firebaseQuery";
 export * from "./typeDefinitions";
 export * from "./emailSections";
 export * from "./exportTransformers";
+export * from "./compassExport";
+export * from "./benchmarkEvidenceRules";
+export * from "./portfolioAggregate";
 export * from "./tutorialTips";
 export * from "./constants";
 export * from "./hooks";

package/lib/index.js

@@ -29,6 +29,9 @@ __exportStar(require("./firebase/firebaseQuery"), exports);
 __exportStar(require("./typeDefinitions"), exports);
 __exportStar(require("./emailSections"), exports);
 __exportStar(require("./exportTransformers"), exports);
+__exportStar(require("./compassExport"), exports);
+__exportStar(require("./benchmarkEvidenceRules"), exports);
+__exportStar(require("./portfolioAggregate"), exports);
 __exportStar(require("./tutorialTips"), exports);
 __exportStar(require("./constants"), exports);
 __exportStar(require("./hooks"), exports);

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AACA,sDAAoC;AACpC,gEAA8C;AAC9C,0DAAwC;AACxC,2DAAyC;AACzC,kDAAgC;AAChC,uDAAqC;AACrC,4DAA0C;AAC1C,2DAAyC;AAEzC,oDAAkC;AAClC,kDAAgC;AAChC,uDAAqC;AACrC,iDAA+B;AAC/B,8CAA4B;AAC5B,0CAAwB;AACxB,yCAAuB;AACvB,4DAA0C;AAC1C,kDAAgC;AAChC,iDAA+B;AAC/B,2CAAyB;AACzB,4DAA0C;AAC1C,oEAAiD;AACjD,yEAAuD;AACvD,kEAAgD;AAChD,kEAAgD;AAChD,oEAAkD;AAClD,yGAAuF;AACvF,0GAAwF;AACxF,+FAA6E;AAC7E,4DAA0C;AAC1C,oEAAkD;AAClD,gEAA8C;AAC9C,2EAAyD;AACzD,6CAA2B;AAC3B,+CAA6B;AAC7B,6DAAuE;AAA9D,2IAAA,OAAO,OAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AACA,sDAAoC;AACpC,gEAA8C;AAC9C,0DAAwC;AACxC,2DAAyC;AACzC,kDAAgC;AAChC,uDAAqC;AACrC,4DAA0C;AAC1C,2DAAyC;AAEzC,oDAAkC;AAClC,kDAAgC;AAChC,uDAAqC;AACrC,kDAAgC;AAChC,2DAAyC;AACzC,uDAAqC;AACrC,iDAA+B;AAC/B,8CAA4B;AAC5B,0CAAwB;AACxB,yCAAuB;AACvB,4DAA0C;AAC1C,kDAAgC;AAChC,iDAA+B;AAC/B,2CAAyB;AACzB,4DAA0C;AAC1C,oEAAiD;AACjD,yEAAuD;AACvD,kEAAgD;AAChD,kEAAgD;AAChD,oEAAkD;AAClD,yGAAuF;AACvF,0GAAwF;AACxF,+FAA6E;AAC7E,4DAA0C;AAC1C,oEAAkD;AAClD,gEAA8C;AAC9C,2EAAyD;AACzD,6CAA2B;AAC3B,+CAA6B;AAC7B,6DAAuE;AAA9D,2IAAA,OAAO,OAAuB"}