Skip to content
View in Notion

CPD Automations ​

Feature Overview ​

Scoring rules that convert PPP platform interactions (Logbook cases, WBAs, Reflections, Audits, MCR, MSF, PPP360) into CPD points for full-platform users. Matt explicitly split this out from CPD Home on 22–23 Apr: CPD Home is the user-facing dashboard; CPD Automations is the engine.

Source ​
Status — pending scope call ​

Matt needs the full list of platform interactions (user ↔ consultant ↔ non-consultant) before mapping them to AMC categories + points. That call is explicitly on the agenda (22 Apr Notion comment: "let's do a call on all interactions between users consultants and non consultants and I can review to see if they could trigger CPD activities/hours").

Until then, the live auto-scoring behaviour is the existing handler in cpdUserActivityHandler.ts:

TriggerConditionWho earnsAMC activityCategoryPoints (default / max/yr)
Logbook — consultant present for case (Supervision branch)Present-for-case involvement, verifiedConsultantSupervision of surgical traineesPerformance Review (Others) + Education⚠️ see note / max 15
Logbook — consultant present for case (Teaching branch)Present-for-case involvement, verifiedConsultantTeaching to trainees / undergraduatesPerformance Review (Others) + Education⚠️ see note / max 20

⚠️ What the two Logbook rows actually do today (read-only code check, 2026-10-03 — Task 8 refresh): "present for case" is the hard-coded PRESENT_FOR_CASE_INVOLVEMENT_OPTIONS = S-S/S-U/S-H (packages-shared/ppp/src/constants/logbook/involvement.ts); points are Math.round(operativeTime ÷ 60) per verified case when operative time is recorded (no minute banking; a case under 30 min earns 0 and the minutes are lost), otherwise a flat 1; and the 15 / 20 "max" values only steered which of the two activities is picked until #12742 — they are now enforced per CPD year. Matt's current rules differ on all three — see cpd.automations.consultant-supervising-qualifying-lois, cpd.automations.per-hour-minute-banking and cpd.automations.supervision-teaching-yearly-caps below (drift → #12725; caps built, #12742). Credit once per operation, the consultant's own log wins: when the consultant also logged the same operation themselves (the two logbook rows share a surgicalCaseId), signing off the trainee's case adds no further credit, whatever their own LoI earned (Rob, 4 Oct 2026, #12814). | Reflection shared | Verified by consultant | Reflection owner | Peer Review of Cases/Charts with Feedback | Reviewing Perf (Self) | 1 / no cap | | WBA — trainee submits | Verified by consultant | Trainee | Peer Review of Cases/Charts with Feedback | Reviewing Perf (Self) | 1 / no cap | | Audit event | Verified + feedback received | Audit owner | Peer Review of Cases/Charts with Feedback | Reviewing Perf (Self) | 1 / no cap |

Either/or NOT both (Matt's CPD Sheet, 5 May): for the consultant present-for-case logbook flow, points credit one of the two branches (Supervision OR Teaching) per case — never both. Branch chosen by the auto-bucket category resolver (deficit-driven, fewest hours, ties → first listed).

Points rule (all rows) — as built in the legacy verify path: if operativeTime (minutes) exists, points = round(minutes ÷ 60). Else default 1. AMC "1 hour = 1 point". Superseded for supervising/teaching credit by Matt 2026-06-24 / 2026-07-21 (#9200): per whole hour with every minute banked — see cpd.automations.per-hour-minute-banking.

Single source of truth: the Logbook supervision/teaching rows above are implemented per the multi-user / supervisory-credit acceptance criteria in cpd-activities.md (#7456 derived-credit record, #7457 computeSupervisoryCredit), capped at the 15h supervised-training requirement defined in cpd.md. This table is the engine-level overview only — it does not redefine those ACs.

Matt's 23 Apr refinement (parked for later): rounding loses fractional hours. Proposal: backend accrues residual minutes; converts to a point only when total reaches an hour. Agreed: refine later, not at MVP. Superseded 2026-06-24 → 2026-07-21: Matt made minute banking the rule on #9200 ("CPD is per hour; collected from operative minutes; to be counted upon hour complete; but stored on minutes and conversion when multiples of 60 (mins) reached"; restated 2026-07-21 "Hours - convert at the hour but are stored by the minute"). Built for the self-LoI path (cpd.multi-user.self-loi-credit.minute-banking in cpd-activities.md); not yet in the consultant sign-off path (#12725).

Now auto-scored (was a gap — wired in #5704) ​

MCR, standalone MSF, and PPP 360 Review now auto-score on verify/completion as cpd.manual.msf-structured-framework — see § Auto-scoring — multisource feedback for the ACs and code references. (Originally parked — Matt 22 Apr: "I believe yes [add auto-scoring]; let me map once I get a complete list of platform interactions.")

By design — NOT CPD (deliberate exclusions) ​

These platform interactions are intentionally not auto-scored as CPD — documented here so the boundary is explicit and nobody later wires them in by mistake (they belong to other telemetry pipelines):

  • Timesheet entries (feed fatigue/wellbeing telemetry, not CPD)
  • Wellness questionnaires (feed PPP Pulse, not CPD)

Open Questions (Matt) ​

#QuestionWhy it is openRef
Q6Does a registrar's TaT (Training another Trainee) logbook case still need the consultant to verify it before the teaching CPD credit lands?Your CPD Sheet (5 May) marks cpd.auto.reg-logbook-teaching "Verification: Yes". Your 21 Jul #9200 ratification ("TaT needs to be added back … YES"; "select lowest bucket to automatically attribute activities to Surgical logbook entry") doesn't mention verification. The #9200 build credits TaT as soon as the case is logged (status verified), with no consultant step.#9200, Matt's CPD Sheet
Q7When a consultant has already reached a yearly cap (Supervision 15h / Teaching 20h), should extra supervising minutes be dropped, moved to the other activity, or banked?You confirmed the caps (5 May sheet; 29 Jul call "16 … in the final column maximum per year"). You haven't said what happens to hours past them. #12742 needs the answer.#12742

Earlier questions Q1–Q5 are answered — see Closed Questions below.

Closed Questions (5) — click to expand
#QuestionResolution
Q1Full list of platform interactions (users / consultants / non-consultants) — the callResolved (Matt, 5 May): Full platform interactions list answered by Matt's CPD Sheet (Drive 1UYu1ts2RRjT3tb-QZdU8eW-cD2EQmxFHUFqAFabq_v8, "Working Sheet" tab). 12 in-app interactions defined for Registrar + Consultant flows across WBA / Logbook / Reflection / Feedback / Audit, plus 6 explicit "no CPD" rules. Currently auto-scored: 4. Remaining 8 are tracked in implementation issue #5679. See Full Interaction Catalogue below.
Q3Current maxes (20 for TaT/Supervision) — still correct per AMC, or follow Governing Document more closely?Resolved (Matt, 5 May): Supervision of surgical trainees max = 15 hrs/yr (1 per hour). Teaching to trainees / undergraduates max = 20 hrs/yr (1 per hour). Source: Matt's CPD Sheet. The current code in cpdUserActivityHandler.ts has these inverted (says "1 / 20 (15 fallback)" for Supervision) — bug to fix in implementation issue #5679.
Q4"No cap" rows — confirm AMC accepts unlimited points, or add caps?Resolved (Matt, 5 May): Confirmed by Matt's CPD Sheet — Reflection / WBA / Audit / Peer Review of cases = "No Max" (uncapped). Sheet uses "No Max" where AMC doesn't specify a cap. Where AMC does specify a cap (e.g. Council meetings = 30, eLearning = 20, ASERNIP-S = 10), those caps are now in scope for implementation. See Full Interaction Catalogue below.
Q2MCR (Multi-Consultant Report) and PPP 360 Review — AMC category + cap?Resolved (5 May, after CPD Sheet review): MCR, MSF, and PPP 360 are all PPP-specific names for the AMC concept "Multisource feedback using a structured framework". All three map to the same row in Matt's CPD Sheet — cpd.manual.msf-structured-framework: Performance Review – Self / Performance Review – Others, 1 per activity, No Max. Each instrument counts as a separate activity (running an MCR + an MSF in the same year = 2 entries, 2 points). Surfaced in product as 3 distinct activity types so doctors recognise their own tooling, but they share the same AMC rule.
Q5Residual-minute accrual proposal — adopt now or defer?Resolved (Matt, 23 Apr): Defer. "Refine later, not at MVP." Current rule stays: if operativeTime (minutes) exists, points = round(minutes ÷ 60); else default 1. Residual-minute accumulation is a post-MVP refinement only. ⚠️ SUPERSEDED 2026-06-24 / 2026-07-21 (Matt, #9200): minute banking is now the rule — see cpd.automations.per-hour-minute-banking.
Full Interaction Catalogue (Matt's CPD Sheet) ​

Source of truth: Matt's CPD Sheet — "Working Sheet" tab. Each row below is a contracted AC keyed by an AC ID.

In-app actions that score CPD (12 rows) ​

Rule: where Matt's "Notes" column says "Either/or NOT Both" (Logbook present-for-case), only one branch may fire per case — the auto-bucket category resolver (deficit-driven, fewest hours, ties→first) decides which.

AC IDUser TypeIn-app actionVerificationCPD ActivityPrimary CategoryAlternate CategoriesPointsMax/yr
cpd.auto.reg-wba-submitRegistrarWBA — upload + optional reflection + assessed by consultantYesPeer review of cases / charts with feedbackAuditPerformance Review – Self1 per entryNo Max
cpd.auto.cons-wba-assessConsultantWBA — assess registrar's WBANoSupervision of surgical trainees (Teaching once at cap)Review of Performance; Education—0.5 h per sign-off (#12712)15 h Supervision / 20 h Teaching per year
cpd.auto.reg-logbook-teachingRegistrarLogbook — upload item with Level of Involvement = T + verifiedYesTeaching to trainees / undergraduatesPerformance Review – OthersEducation1 per hour20
cpd.auto.cons-logbook-supervision ⚠️ driftConsultantLogbook — assess registrar's logbook + present for case (Supervision)NoSupervision of surgical traineesPerformance Review – OthersEducation1 per hour15
cpd.auto.cons-logbook-teaching ⚠️ driftConsultantLogbook — assess registrar's logbook + present for case (Teaching)NoTeaching to trainees / undergraduatesPerformance Review – OthersEducation1 per hour20
cpd.auto.cons-logbook-feedbackConsultantLogbook — assess registrar's logbook + give feedbackNoPeer review of cases / charts with feedbackAuditPerformance Review – Others1 per involvementNo Max
cpd.auto.reg-reflection-sharedRegistrarReflection — personal reflection + share to consultant + receive fbYesPeer review of cases / charts with feedbackAuditPerformance Review – Self1 per entryNo Max
cpd.auto.reg-feedback-givenRegistrarFeedback — give feedback to consultant / registrarYesStructured conversation with a peerPerformance Review – Others—1 per involvementNo Max
cpd.auto.cons-reflection-sharedConsultantReflection — personal reflection + share to consultant + receive fbYesPeer review of cases / charts with feedbackAuditPerformance Review – Self1 per entryNo Max
cpd.auto.cons-feedback-givenConsultantFeedback — give feedback to consultant / registrarYesStructured conversation with a peerPerformance Review – Others—1 per involvementNo Max
cpd.auto.reg-audit-verifiedRegistrarAudit — upload + verified by other user + receive feedbackYesPeer review of cases / charts with feedbackAuditPerformance Review – Self1 per entryNo Max
cpd.auto.cons-audit-verifiedConsultantAudit — upload + verified by other user + receive feedbackYesPeer review of cases / charts with feedbackAuditPerformance Review – Self1 per entryNo Max

In-app actions that DO NOT score CPD (6 rows) ​

AC IDUser TypeIn-app actionReason from sheet
cpd.auto.no-reg-wba-baseRegistrarWBA — upload + assessed (without reflection share path)Registrar does not get CPD for this (covered by row 1)
cpd.auto.no-reg-logbook-non-teachingRegistrarLogbook — upload + verified (involvement ≠ T)Registrar gets CPD only when level of involvement is T
cpd.auto.no-reg-reflection-privateRegistrarReflection — personal reflection only (no share)No CPD until shared + feedback received
cpd.auto.no-cons-reflection-privateConsultantReflection — personal reflection only (no share)No CPD until shared + feedback received
cpd.auto.no-reg-audit-bareRegistrarAudit — upload only (no verification, no feedback)No CPD until verified + feedback received
cpd.auto.no-cons-audit-bareConsultantAudit — upload only (no verification, no feedback)No CPD until verified + feedback received

Manual upload activities (50 rows) ​

Rule: each row creates an entry in the master CPD activity master list; user uploads evidence; activity is verified by an accreditor before points credit. Points and Max/yr exactly as per Matt's CPD Sheet.

AC IDActivityPrimary CategoryAlternate Category 1Alternate Category 2PointsMax/yr
cpd.manual.specialty-society-auditSpecialty Society AuditAudit——1 per activityNo Max
cpd.manual.specialty-group-auditSpecialty Group AuditAudit——1 per activityNo Max
cpd.manual.clinical-unit-auditClinical Unit AuditAudit——1 per activityNo Max
cpd.manual.locum-logbookLocum LogbookAudit——1 per activityNo Max
cpd.manual.malt-with-peer-reviewMALT with peer reviewAudit——1 per activityNo Max
cpd.manual.total-practice-auditTotal Practice AuditAudit——1 per activityNo Max
cpd.manual.selected-audit-surgical-practiceSelected audit from surgical practiceAudit——1 per activityNo Max
cpd.manual.org-review-surgical-servicesOrganisation review of surgical servicesAuditPerformance Review – Others—1 per activityNo Max
cpd.manual.patient-feedback-action-planPatient feedback including action planAuditPerformance Review – Self—1 per activityNo Max
cpd.manual.peer-review-of-reportsPeer review of reportsAuditPerformance Review – SelfPerformance Review – Others1 per activityNo Max
cpd.manual.peer-review-cases-chartsPeer review of cases / charts with feedbackAuditPerformance Review – SelfPerformance Review – Others1 per activityNo Max
cpd.manual.structured-conversation-peerStructured conversation with a peerPerformance Review – SelfPerformance Review – Others—1 per activityNo Max
cpd.manual.anzasm-surgical-case-formANZASM surgical case formAudit of Surgical Mortality——1 per activityNo Max
cpd.manual.anzasm-first-line-assessmentANZASM first line assessmentPerformance Review – Others——1 per activityNo Max
cpd.manual.anzasm-second-line-assessmentANZASM second line assessmentPerformance Review – Others——1 per activityNo Max
cpd.manual.committee-meetings-educationalCommittee meetings with educational content, such as guideline developmentPerformance Review – Others——1 per activityNo Max
cpd.manual.morbidity-mortality-meetingsMortality and Morbidity meetingsPerformance Review – SelfPerformance Review – Others—1 per activityNo Max
cpd.manual.mentoring-mentorParticipation in a structured mentoring program — mentorPerformance Review – Others——1 per activityNo Max
cpd.manual.mentoring-menteeParticipation in a structured mentoring program — menteePerformance Review – Self——1 per activityNo Max
cpd.manual.practice-visitorPractice visitorPerformance Review – Others——1 per activityNo Max
cpd.manual.recipient-practice-visitRecipient of a structured practice visit by a peerPerformance Review – Self——1 per activityNo Max
cpd.manual.cpd-coach-being-coachedCPD Coach (being coached)Performance Review – Others——1 per activityNo Max
cpd.manual.cpd-coach-as-coachCPD Coach (as coach)Performance Review – Self——1 per activityNo Max
cpd.manual.meetings-administratorsMeetings with administrators / managementPerformance Review – SelfPerformance Review – Others—1 per activityNo Max
cpd.manual.meetings-adverse-eventsMeetings reviewing adverse eventsPerformance Review – SelfPerformance Review – Others—1 per activityNo Max
cpd.manual.annual-individual-dept-reviewParticipation in an annual individual or department performance reviewPerformance Review – SelfPerformance Review – Others—1 per activityNo Max
cpd.manual.reviewer-trauma-verificationReviewer Trauma verificationPerformance Review – Others——1 per activityNo Max
cpd.manual.peer-discussions-critical-incidentsPeer discussions of critical incidents, safety and quality reviewsPerformance Review – SelfPerformance Review – Others—1 per activityNo Max
cpd.manual.referring-doctor-satisfactionReferring doctor's satisfaction surveyPerformance Review – Self——1 per activityNo Max
cpd.manual.examiner-racs-amc-uniExaminer RACS, AMC, universityPerformance Review – Others——1 per activityNo Max
cpd.manual.surgical-attachment-peerSurgical attachment with peerPerformance Review – SelfPerformance Review – Others—1 per activityNo Max
cpd.manual.patient-care-satisfactionPatient care satisfaction surveyPerformance Review – Self——1 per activityNo Max
cpd.manual.msf-structured-frameworkMultisource feedback using a structured frameworkPerformance Review – SelfPerformance Review – Others—1 per activityNo Max
cpd.manual.comprehensive-health-gpComprehensive health assessment with your GPPerformance Review – Self——1 per activityNo Max
cpd.manual.post-operative-questionnairePost-operative satisfaction questionnairePerformance Review – Self——1 per activityNo Max
cpd.manual.supervision-surgical-traineesSupervision of surgical traineesPerformance Review – OthersEducation—1 per hour15
cpd.manual.asernip-sParticipation in ASERNIP-S review, a clinical trial or organised clinical researchPerformance Review – SelfPerformance Review – OthersEducation1 per hour10
cpd.manual.referee-journal-articleActing as a referee for a journal articlePerformance Review – OthersEducation—5 per activity15
cpd.manual.publication-bookPublication of a surgical / medical bookPerformance Review – SelfPerformance Review – OthersEducation30 per activityNo Max
cpd.manual.publication-journal-chapterPublication in a refereed journal / chapter in surgical/medical bookPerformance Review – SelfPerformance Review – OthersEducation15 per activity30
cpd.manual.hospital-clinical-meetingHospital clinical meeting attendancePerformance Review – SelfPerformance Review – OthersEducation1 per hourNo Max
cpd.manual.presentation-scientific-meetingPresentation to surgical / medical peers at a scientific meetingPerformance Review – SelfPerformance Review – OthersEducation10 per activity20
cpd.manual.small-group-learningStructured and approved small group learning e.g. Journal ClubPerformance Review – SelfPerformance Review – OthersEducation1 per hour10
cpd.manual.volunteer-servicesParticipation in volunteer servicesPerformance Review – SelfPerformance Review – OthersEducation1 per hour20
cpd.manual.surgical-meetings-mm-mdtSurgical meetings including M&M, multidisciplinary etcPerformance Review – SelfPerformance Review – OthersEducation1 per hourNo Max
cpd.manual.attendance-scientific-meetingsAttendance at scientific meetingsEducation——1 per hourNo Max
cpd.manual.attendance-racs-coursesAttendance at RACS courses / workshopsEducation——1 per hourNo Max
cpd.manual.attendance-specialty-society-coursesAttendance at Specialty Society courses / workshopsEducation——1 per hourNo Max
cpd.manual.attendance-specialty-association-meetingAttendance at Specialty Association or Society scientific meetingEducation——1 per hourNo Max
cpd.manual.cultural-competence-safetyCultural Competence and Cultural SafetyEducation——1 per hourNo Max
cpd.manual.development-educational-materialDevelopment of educational materialEducation——1 per hour15
cpd.manual.elearningeLearningEducation——1 per hour20
cpd.manual.journal-readingJournal reading / researching clinical information / informal discussionsEducation——1 per hour20
cpd.manual.other-courses-nontechnicalOther courses / workshops that focus on non-technical competenciesEducation——1 per hourNo Max
cpd.manual.other-interactive-clinical-workshopsOther approved interactive surgical or clinical workshopsEducation——1 per hourNo Max
cpd.manual.overseas-meetings-recognisedOverseas meetings with CPD-recognised national bodyEducation——1 per hourNo Max
cpd.manual.tertiary-coursesParticipation in other courses at tertiary institutions or another recognised providerEducation——1 per hour20
cpd.manual.presentation-other-health-profPresentation to other health professionals' / community groupsEducation——1 per hourNo Max
cpd.manual.specialty-group-meetings-racsSpecialty group meetings including RACSEducation——1 per hourNo Max
cpd.manual.council-board-committee-meetingsCouncil / board committee meetingsEducation——1 per hour30
cpd.manual.teaching-on-courses-workshopsTeaching on courses / workshopsEducation——1 per hour30
cpd.manual.teaching-racs-coursesTeaching on RACS courses / workshopsEducation——1 per hour30
cpd.manual.teaching-specialty-society-coursesTeaching on specialty societies' courses / workshopsEducation——1 per hour20
cpd.manual.teaching-trainees-undergraduatesTeaching to trainees / undergraduatesPerformance Review – OthersEducation—1 per hour20

Note on row count. Sheet contains 51 manual-upload data rows; this catalogue lists 51 rows here (counting Hospital clinical meeting once even though the sheet has a duplicate "Time required" annotation in column M). Engineering will verify before migration.

Acceptance Criteria ​

Status: Q1 (the interactions list) was answered by Matt's CPD Sheet on 5 May; the full catalogue above is the contract. The built rules are listed here. The supervising/teaching rules were refreshed on 2026-10-03 against Matt's #9200 ratification (Task 8, #11192).

Auto-scoring — built rules ​

  • ✅ Logbook case where consultant is marked "present for case" and the involvement is verified → consultant earns 1 CPD point (Reviewing Performance of Others + Education; max 20/yr; Teaching fallback at 15) — retired 2026-10-03. This had the caps the wrong way round (Matt's CPD Sheet, 5 May: Supervision 15, Teaching 20 — Q3). It also described a flat point, which Matt's #9200 rules have since replaced. It is replaced by the three ACs below.
  • ✅ cpd.automations.consultant-supervising-qualifying-lois — when a consultant verifies a non-consultant's logbook case, the consultant earns supervising/teaching CPD credit only when their involvement is one of the Levels of Involvement Matt ratified as supervising: PPT (Performed in part by non consultant), S-S (Supervising, scrubbed) and S-U (Supervising, in theatre). S-H (Supervising, in hospital) and PCC (Performed with consultant colleague) earn nothing. The qualifying set comes from the same admin-editable earns_cpd_credit flag the self-LoI path reads (cpd.multi-user.self-loi-credit.qualifying-lois in cpd-activities.md). The credit goes to Supervision of Surgical Trainees or Teaching to Trainees / Undergraduates, using the "select lowest bucket" resolver. One operation credits the consultant once (#12814, Rob 4 Oct 2026): a signed-off case is not banked when the consultant logged their own entry for the same operation (same surgical-case parent). Their own log wins. † Built in #12725: the verify path now delegates to syncSignOffSupervisionCredit, which qualifies off earns_cpd_credit (S-H earns nothing, PPT does). Recomputing a consultant's year also removes their pre-#12725 sign-off rows, so each signed-off case is credited once. Double credit when the consultant also logs the same operation is not covered here. It is still open: Q-signoff-cpd-double-credit → #12814. ‡
  • ✅ cpd.automations.per-hour-minute-banking — supervising/teaching CPD from a logbook case is earned per whole hour of operative time. Every minute is stored, and a remainder under an hour is banked and carried to the next case in the same CPD year. For example, a 125-minute case earns 2 hours with 5 minutes banked. This applies to every supervising/teaching auto-credit path, including consultant sign-off. CONTRADICTS the retired 23 Apr "defer residual minutes" decision (Q5) and the round(minutes ÷ 60) rule below. † Built in the self-LoI path (selfSupervisionCreditService, cpd_supervision_minute_bank). Built in #12725 for the consultant sign-off path too: signed-off cases join the assessor's banking pool via syncSignOffSupervisionCredit. ‡
  • ✅ cpd.automations.supervision-teaching-yearly-caps — auto-scored Supervision of Surgical Trainees credit is capped at 15 hours per CPD year and Teaching to Trainees / Undergraduates at 20 hours per CPD year. No auto path can take a doctor past either cap in a year. † Enforced (#12742) by allocateCappedCpdCredit on both auto paths — the self-supervision credit and the legacy verified-TaT branch. It sums the doctor's points per activity in the case's CPD year only, clips a credit to the room left, sends the overflow to the other activity if it has room, and credits nothing once both are full. What should happen to hours past the cap (dropped today, or banked) is still Open Question Q7. ‡
  • ✅ Reflection shared and verified by a consultant → reflection owner earns 1 CPD point (Reviewing Performance of Self; no annual cap)
  • ✅ WBA submitted by trainee and verified by consultant → trainee earns 1 CPD point (Reviewing Performance of Self; no annual cap)
  • ✅ Audit event verified with feedback received → audit owner earns 1 CPD point (Reviewing Performance of Self; no annual cap)
  • ✅ If the source record is a logbook case with operativeTime (minutes), points = round(minutes ÷ 60) — implements AMC "1 hour = 1 point" rule. Superseded for supervising/teaching credit by cpd.automations.per-hour-minute-banking (Matt, 2026-06-24 / 2026-07-21). This is still the built rule for the other verify-path rows.
  • ✅ If operativeTime is absent, default = 1 point
  • ✅ Auto-scored points appear in the user's CPD activity log alongside manually entered activities
  • ✅ Auto-scored points count toward the annual 50h target and category totals on CPD Home dashboard

Auto-scoring — multisource feedback (MCR / MSF / PPP 360) ​

All three map to AMC's "Multisource feedback using a structured framework" — Performance Review – Self / Performance Review – Others, 1 per activity, No Max. Each instrument is logged separately (an MCR and a PPP 360 in the same year = 2 entries) but they share the same AMC rule. Wired up in #5704 (verified in code 27 May).

  • ✅ MCR completion → auto-scores cpd.manual.msf-structured-framework for the MCR subject on verify ‡
  • ✅ MSF standalone (QMF) → auto-scores cpd.manual.msf-structured-framework for the MSF subject on verify ‡
  • ✅ PPP 360 Review → auto-scores cpd.manual.msf-structured-framework for the PPP 360 subject on completion ‡

Scoring integrity ​

  • ✅ Timesheet entries do NOT generate CPD points (feeds fatigue telemetry only)
  • ✅ Wellness questionnaire submissions do NOT generate CPD points (feeds PPP Pulse only)
  • ✅ Points cap enforced per interaction type per year (max 20 for Supervision; no-cap rows confirmed by AMC — Q4) — retired 2026-10-03. It was marked built, but no auto path enforces a cap, and "20 for Supervision" was the wrong way round (Q3: Supervision 15). Replaced by cpd.automations.supervision-teaching-yearly-caps (⚠️ drift, #12742). The no-cap rows stay uncapped (Q4).
  • ⏳ Residual-minute accrual — defer decision to Q5 — superseded by cpd.automations.per-hour-minute-banking (Matt, 2026-06-24 / 2026-07-21).
Change Log ​
DateChangePR/IssueReason
2026-10-04cpd.automations.supervision-teaching-yearly-caps flips from drift to built. Auto-scored Supervision of Surgical Trainees credit is now capped at 15 h and Teaching to Trainees / Undergraduates at 20 h per CPD year, on both auto paths (the self-supervision credit and the legacy verified-TaT branch). The held hours are summed for the case's CPD year only, a credit is clipped to the room left, overflow goes to the other activity, and nothing is credited once both are full.#12840, #12742, #11192Matt's CPD Sheet (2026-05-05, Q3) and the 2026-07-29 Dev Session ("put caps in"). The code only used the 15 / 20 values to choose between the two activities and summed all years. What happens to hours past the cap is still Open Question Q7, so they are dropped rather than banked. @regression @issue-12742 scenarios run the allocator in-process.
2026-10-04A consultant who signs off a trainee's case for an operation they also logged themselves (same surgicalCaseId) is no longer credited twice: the own log wins and the sign-off adds no extra supervising CPD.#12814, #11192Rob decided on 4 Oct 2026 (comment on #12814): credit once; the consultant's own log wins. This closes Q-signoff-cpd-double-credit in logbook.md. Interpretation to confirm: any own log of the same operation suppresses the sign-off credit, even when that own entry's LoI earned nothing.
2026-10-04WBA sign-off credits the assessing consultant a fixed 0.5 h under Supervision (Teaching once Supervision is at its 15 h yearly cap) and credits the trainee's "WBA assessed by consultant". An activity's operative time now overrides the fixed credit only for logbook records.#12712, #11194Rob's decision on #12712 (2026-10-04). signOffWba had stopped triggering the CPD handler (PR #12570). SUPERVISION_MAX_PER_YEAR is exported so the handler and the self-supervision credit service share one cap.
2026-10-03Consultant sign-off supervising credit is built. cpd.automations.consultant-supervising-qualifying-lois and cpd.automations.per-hour-minute-banking flip from drift to built. Sign-off credit qualifies off the admin earns_cpd_credit flag (PPT/S-S/S-U; S-H earns nothing) and banks per operative hour through syncSignOffSupervisionCredit. Legacy pre-#12725 sign-off rows are removed on recompute. The no-double-credit criterion is split to #12814 (open).#12725Spec-drift gate on #12774. The change touches selfSupervisionCreditService, which belongs to this spec.
2026-10-03Task 8 spec refresh, resolving the Task 4 handoff on #12720. Retired the built-rules bullet that had the caps the wrong way round ("max 20/yr; Teaching fallback at 15"; Matt''s Q3 says Supervision 15 / Teaching 20) and the "Points cap enforced per year" bullet, which was marked built but no path enforces a cap. Added three ACs, all marked drift: cpd.automations.consultant-supervising-qualifying-lois (PPT/S-S/S-U count; S-H and PCC don''t; #12725), cpd.automations.per-hour-minute-banking (supersedes the 23 Apr Q5 "defer" decision; #12725) and cpd.automations.supervision-teaching-yearly-caps (#12742). Corrected the overview note, which said "1 per hour": the code awards round(operativeTime/60) per case, or a flat 1 with no operative time. Added Open Questions Q6 (does TaT credit still need consultant verification?) and Q7 (what happens to hours past a cap?). Status set to partial-drift; code-paths now include the resolver and the self-supervision credit service.#11192, #9200, #12725, #12742, #12720Async Task spec refresh (#11192). The newest dated Matt statement wins. Minute banking: 2026-04-23 "defer" is superseded by #9200 (2026-06-24, restated 2026-07-21). Qualifying LoIs: #9200 2026-07-21. Caps: Matt''s CPD Sheet 2026-05-05, reaffirmed on the 2026-07-29 Dev Session (~00:28:01). Spec-only, no BDD (the scenario requirement is on each fix issue).
2026-05-27Mark MCR, standalone MSF, and PPP 360 Review as auto-scored (cpd.manual.msf-structured-framework) — verified merged in code.#5704Rob noted #5704 is merged; confirmed in cpdUserActivityHandler.ts (MCR/MSF) and ppp360CpdHandler.ts (PPP 360). Flipped the ⏳ ACs to ✅, fixed the stale "gaps" framing, and clarified the "by design — NOT CPD" exclusions.
2026-05-05Fix inverted supervision/teaching AMC caps (15/20 → corrected); add seedCpdActivities.ts seeding 64 manual activities from Matt's CPD Sheet.#5679Bug in cpdUserActivityHandler had supervision capped at 20 hrs/yr and teaching at 15 hrs/yr — per Matt's CPD Sheet Q3, supervision is 15 and teaching is 20.
2026-04-23Spec created by splitting automation content out of cpd-home.mdthis PRMatt confirmed CPD Home and CPD Automations are two separate features on the 23 Apr call

Internal documentation — org members only