Ed-Fi Certification Suite v2.1

What's Changed

AdminApp Integration Support

• [CERT-222] Export Bruno SIS artifacts (#112)

  • Introduced an automated CI/CD workflow to build, validate, package, and publish the SIS artifact as a release asset on pushes to main and on tags
  • Added documentation covering artifact contents, checksum verification, and step-by-step integration guides for both Admin App and Bruno CLI
  • Upgraded all GitHub Actions to their latest versions and migrated workflows from Node.js 20 to Node.js 24

• [CERT-222] Update Bruno CLI dependencies (#114)

  • Bumped Bruno CLI packages to their latest versions to ensure compatibility and security

• [CERT-241] Added v5 support and improved steps naming conventions (#121)

  • Added Data Standard v5 support with separate environment configurations and an independent CI pipeline
  • Standardized scenario naming across DescriptorMappings, ClassPeriods, Courses, and Locations (e.g., 01 - 1st Course is valid)
  • Fixed race conditions when v4 and v5 pipelines run simultaneously
  • Replaced hardcoded secrets with GitHub Secrets

• [CERT-232] docs: Roadmap for Certification 2.1 - DS5 (#123)

  • Added a comprehensive project roadmap with sprint plan, Gantt and burndown charts (Mermaid), ticket dependency maps, and a risk register with mitigation strategies

Data Standard 5 Support

• [CERT-257] Data Standard V5 workflow enabled (#127)

  • Re-enabled the Data Standard v5 CI/CD workflow

• [CERT-259] Added Seeding data scripts (#134)

  • Replaced bru.setEnvVar with bru.setVar across all scripts for consistent variable scoping
  • Added full CRUD coverage (Create, Read, Update, Delete) to all seeding data request scripts

• [CERT-239] Updated StudentAcademicRecords to version 5 (#126)

  • Migrated cumulativeGradePointAverage to the new gradePointAverages array structure, including gradePointAverageTypeDescriptor, gradePointAverageValue, isCumulative, and maxGradePointAverageValue
  • Updated all test assertions and scenario documentation to match the v5 data model

• [CERT-237] DisciplineAction updated to version 5 (#129)

  • Removed deprecated studentDisciplineIncidentAssociations validation
  • Added REQUIRED validation for studentDisciplineIncidentBehaviorAssociations with reference object assertions (incidentIdentifier, schoolId, studentUniqueId)

• [CERT-237] ReceivedEducationServicesDuringExpulsion removed from version 5 (#130)

  • Removed receivedEducationServicesDuringExpulsion from DisciplineAction test assertions and documentation, as this field was removed in v5

• [CERT-243] Added Contact scenarios to version 5 (#132)

  • Added four new certification scenarios for the Contact resource: first/second contact validation, electronicMailAddress update, and streetNumberName update
  • Introduced logSpecContact logging map and entity configuration for Contacts

• [CERT-244] Added StudentContactAssociation scenarios to version 5 (#133)

  • Added four certification scenarios for StudentContactAssociations covering creation and updates to primaryContactStatus and emergencyContactStatus
  • Added entity configuration with contactUniqueId + studentUniqueId as primary keys, a logSpecStudentContactAssociation logging spec, and full CRUD sample data scripts

• [CERT-250] Updated StaffSectionAssociation scenarios to version 5 (#135)

  • Corrected the update scenario to track endDate instead of beginDate, aligning variable names and assertions throughout
  • Added beginDate to the logSpecStaffSectionAssociation logging spec for more comprehensive logging

• [CERT-252] Updated StudentSchoolAssociation to version 5 (#137)

  • Replaced hardcoded test values with descriptive placeholders (e.g., [ENTER FIRST SCHOOL YEAR])
  • Refined assertions: removed graduationPlanReference where not applicable, added calendarReference.calendarCode and fullTimeEquivalency checks
  • Added tracking for exitWithdrawDate and exitWithdrawTypeDescriptor

• [CERT-246] StaffAssociation and GradingPeriods updated to version 5 (#138)

  • GradingPeriods: replaced periodSequence query parameter with gradingPeriodName + gradingPeriodDescriptor with dynamic URL encoding
  • Added a complete CRUD test suite for ClassPeriods sample data
  • Removed deprecated assertions for optional Staff fields (middleName, generationCodeSuffix)
  • Updated sample data to v5 for: ClassPeriods, CourseOfferings, Courses, GradingPeriods, Locations, Sections, Sessions, Staffs, StaffSectionAssociations

• [CERT-256] StudentProgram scenarios updated to version 5 (#139)

  • Added field-level assertions across all Student Program Association resources: StudentProgramAssociations, SpecialEducation, Title I, Migrant, Neglected/Delinquent, Homeless, Language Instruction, and School Food Service
  • Enhanced validation for nested service arrays (e.g., languageInstructionProgramServices, migrantEducationProgramServices)

• [CERT-245] StudentEdOrgResponsibilityAssoc scenario updated to version 5 (#140)

  • Added three certification scenarios for StudentEdOrgResponsibilityAssociation (SEORA) covering creation and update flows, with logging spec and entity configuration
  • Added ResponsibilityDescriptors sample data file and auxiliary CRUD scripts for StaffEdOrgAssociations

Bug Fixes

• Bump axios from 1.13.6 to 1.15.0 (#116)

  • Applied two critical security patches from axios; also adds runtime support for Deno and Bun

• [AC-258] fix: Several scenario issues fixed from Version 4 and Version 5 (#131)

  • Fixed multiple scenario validation issues across v4 and v5 discovered during regression testing

• [CERT-250] fix: StaffSectionAssociation 4th scenario fixed in version 5 (#136)

  • Corrected the 4th StaffSectionAssociation scenario name - replaced beginDate reference with endDate

Full Changelog: v2.0.0...v2.1.0

Ed-Fi Certification Suite v2.0

Features

---

• SIS Certification v4 using Bruno Client
• Local Testing for GitHub Actions
• Automated Scenario Runner
• Git Friendly code structure
• Scenario Generation using Gen AI (Early Preview)

Documentation

---

SIS Certification User Manual
Local Actions Testing Guide
Scenario Runner Guide
Developer Guide

Migration and upgrade notes.

---

Note: Out latest V2 release utilizes the Bruno API client and is not backwards compatible with v1, which uses Postman collections.

v1.0.0 Certification for Data Standard 4

Postman "scripts" for Ed-Fi Certification testing on Data Standard version 4.