{
 "name": "Who Gets In? Evidence Strength Codebook v1",
 "version": "1.0",
 "created": "2026-09-16",
 "governing_rules": [
  "Code only what the evidence_passage says. The observation is context; if the passage does not support a stronger code, use the weaker one.",
  "Never turn 'strong/excellent/outstanding academic record' into a hard minimum.",
  "Never turn 'preferred', 'ideally', 'ideal', 'typically', 'usually' into a hard minimum.",
  "Never treat 'all disciplines' as 'all universities'.",
  "Never treat an open application as equal probability of selection.",
  "A code describes the published statement for that programme and market only, never the employer globally."
 ],
 "families": {
  "ACADEMIC_GRADE": "grade",
  "SCHOOL_GRADES": "grade",
  "UNIVERSITY_ACCESS": "access"
 },
 "schemes": {
  "grade": {
   "HARD_MINIMUM": "Passage states a specific grade standard (e.g. 2:1, First, GPA figure, AAB, UCAS points, percentage) as required, needed, minimum, expected or 'on track for'. 'Usually' or 'normally' downgrades to TYPICAL_DESCRIPTIVE unless the passage also says must/required/minimum.",
   "PREFERRED": "Specific grade figure described as preferred, ideal, 'ideally'.",
   "TYPICAL_DESCRIPTIVE": "Specific grade figure described as usual, normal, typical, or as what past participants had.",
   "HOLISTIC_STATEMENT": "General academic language without a figure (strong/outstanding/impressive record), or a statement that grades are weighed alongside other factors, mitigating circumstances or contextual review, or that candidates below a standard may still be considered.",
   "EXPLICIT_NO_MINIMUM": "Passage explicitly says there is no minimum / no grade requirement / a threshold was removed.",
   "SCOPE_OR_PROCESS_NOTE": "Academic process or scope statement that is not itself a standard (requirements vary by programme, transcript timing, how to calculate points, include grades on CV)."
  },
  "access": {
   "A_BROAD_ACCESS_STATEMENT": "Explicit statement welcoming or considering candidates from all/any universities, schools or colleges, or saying universities are not an entry requirement.",
   "B_SCHOOL_AGNOSTIC_PROCESS": "Explicit statement that the application process is the same for all regardless of campus contact, or that applications from non-visited schools are treated equally.",
   "C_SELECTED_CAMPUS_PLUS_OPEN_ROUTE": "Formal recruiting at selected schools or OCI combined with an explicit direct or informal route for others, or hiring 'from top schools and also a wide range'.",
   "D_ACCESS_OR_CONTEXTUAL_PROGRAMME": "Access, social-mobility or diversity programme, recruitment partner, or contextual recruitment system (e.g. Rare).",
   "E_CAMPUS_FOOTPRINT": "Descriptive statement of campus reach or university representation (number of universities represented, check whether we visit your campus, UK universities locally).",
   "F_NO_RESTRICTION_IN_CRITERIA": "Eligibility or selection criteria for a route that set out requirements but contain no university wording at all. Weakest access evidence; never reported as broad access.",
   "G_RESTRICTIVE_OR_PRESTIGE_QUALIFIER": "Criteria that limit or qualify by institution: top-tier, leading, prestigious, reputable, renowned university, or eligibility limited to named institutions."
  }
 },
 "status": "GOVERNED_INPUT",
 "purpose": "Classify how strongly each published grade or university-access statement binds, per signal, so derived surfaces never turn preferred, typical or holistic language into a requirement, or campus footprint into broad access. Implements sections 16, 17, 56 and 57 of the WGI Governing Research Protocol v1. The register is never edited; codes live in dated append-only coding files.",
 "adjudication_rules": {
  "R1": "A grade figure qualified in the same passage by mitigating circumstances, context or case-by-case review is coded HOLISTIC_STATEMENT (the conservative code). The figure is still visible in the register.",
  "R2": "A grade figure published as the standard in a criteria or requirements list is coded HARD_MINIMUM even without the word required, unless preferred, ideally, usually, normally or typically attaches to that figure.",
  "R3": "A code must be supported by the evidence passage alone. Where the observation says more than the passage, code the passage and flag the row for evidence-chain review."
 },
 "reporting_rules": [
  "An employer may appear under several codes; codes are never collapsed into one employer-level rule.",
  "Only A_BROAD_ACCESS_STATEMENT and B_SCHOOL_AGNOSTIC_PROCESS may be reported as explicit broad-access evidence.",
  "E and F are never reported as broad access. G is a published institution qualifier, not evidence of a target-school effect or of selection outcomes.",
  "Uncoded, not-yet-evidenced and inaccessible cells are research states, never real-world absence."
 ],
 "files": {
  "staging": "assets/evidence-strength-coding-staging-*.csv (status PROPOSED, never counted)",
  "canonical": "assets/evidence-strength-coding-supplement-*.csv (status APPROVED with approved_by and approved_on)"
 },
 "coding_method": "Two blind independent coders per signal from the evidence passage; disagreements adjudicated under R1-R3 with a written note; audit flags retained on the row."
}