Add Canada (CSA / CIRO / OSFI / OPC) regulatory reference data#301
Open
pmerrison wants to merge 1 commit into
Open
Add Canada (CSA / CIRO / OSFI / OPC) regulatory reference data#301pmerrison wants to merge 1 commit into
pmerrison wants to merge 1 commit into
Conversation
Adds docs/_data/canada-regulations.yml — a new Canadian jurisdictional regulatory reference file consolidating the work of two open PRs: - finos#285 (Luca Borella) — broader scope, layout wiring, OSFI E-23 / B-13 / PIPEDA / CSA / CIRO / FCAC - finos#290 (mthom) — current sources (E-23 2027, CIRO Annual Compliance Report 2026, Proposed CIRO Rules Phases 4 and 5), explicit perimeter, schema mirroring eu-ai-act.yml Schema: title, url, issuer, optional description. Mirrors eu-ai-act.yml and ffiec-itbooklets.yml; the issuer field is analogous to FFIEC's booklet_abbrev and the optional description field preserves contextual research without requiring layout changes (current layouts render only the title). Granularity is split where the source has real numbered structure so follow-up risk and mitigation references can cite specifics without refactoring: OSFI E-23 (2027) 12 principles under sections A–D; OSFI B-13 three domains; NI 31-103 key sections (11.1, 11.5, 13.2, 13.2.1, 13.3, 13.4); CIRO IDPC rule groups (1500, 3100–3600, 3800, 3900); PIPEDA Schedule 1; CIRO Rule Consolidation Phases 4 and 5. Source verification corrections relative to the input PRs: - OSFI E-23 (2027) restructured to the actual document — 12 principles organised as 1.1–1.3, 2.1–2.3, 3.1–3.6 under sections A–D, not the 7-principle structure of the older E-23. - PIPEDA Schedule 1 URL updated to the verified anchor (#h-417659) and description corrected to 10 principles (the previous summary omitted Principle 4.5, "Limiting Use, Disclosure, and Retention"). - Bill C-27 (CPPA + AIDA) omitted: died on the order paper in the 44th Parliament (last activity 2024-09-26) and not reintroduced; a comment in the YAML notes the trigger for re-adding. Out of scope (deferred to follow-up PRs): - Adding canada-regulations_references entries to risk and mitigation files. This PR is the reference-data foundation only. Signed-off-by: Paul Merrison <paul@tetrate.io>
alvin-c-shih
approved these changes
May 27, 2026
|
Hi all - I'm pushing a revised/dependent PR that is dependent on PR #290 and adds the reference data/linkages. I'm wondering if it makes sense to wrap that into this PR or fast-follow, given the noted open items here? I'm fine with either approach, and will push the PR today. |
5 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Credit
This PR consolidates and restructures the work of two open PRs already on the project. The substantive research is theirs; this PR's contribution is to combine them into a single coherent reference dataset.
Create canada-regulations.yml): contributed the broader scope (OSFI E-23 and B-13, PIPEDA, CSA, CIRO, FCAC), the layout wiring intorisk.htmlandmitigation.html, and the practical filenamecanada-regulations.yml.Add Canada (CSA / CIRO) regulatory reference data file): contributed current sources (OSFI E-23 2027, CIRO Annual Compliance Report 2026, the Proposed CIRO Rules and Phases 4–5, IOSCO CR/01/2025), an explicit perimeter, and a clean schema mirroringeu-ai-act.yml/ffiec-itbooklets.yml.If maintainers prefer to land one of the original PRs instead, please feel free to close this one. It is offered as a possible reconciliation of the two and assumes both authors are happy for their work to be combined this way.
Summary
Adds
docs/_data/canada-regulations.yml— 48 entries covering Canadian AI and financial-sector regulatory references — and wires the new dataset into the existing reference-card includes on the risk and mitigation layouts.Coverage (issuer / count): OSFI 17 · CSA 14 · CIRO 11 · CSA/CIRO 2 · OPC 2 · IOSCO 1 · FCAC 1.
Out of scope (deferred to follow-up PRs): adding
canada-regulations_references:entries to individual_risks/*.mdand_mitigations/*.mdfiles. This PR is the reference-data foundation only.Schema
Mirrors
eu-ai-act.ymlandffiec-itbooklets.yml:The
issuerfield is analogous to FFIEC'sbooklet_abbrev. The optionaldescriptionfield preserves contextual research (effective dates, applicability, AI relevance) without requiring layout changes today — a future enhancement could surface it as muted secondary text under the title. Happy to drop or rename either field per maintainer preference.All titles are short single-line citations (longest is 94 characters), consistent with existing reference-card visual norms.
Granularity
Split where the source has real numbered structure so that follow-up risk/mitigation PRs can cite specifics without churn:
Synthetic topical splits (e.g., per-topic CSA SN 11-348 carve-outs) are kept at document level since they don't correspond to real document sections.
Source verification corrections
While reconciling the two PRs I verified entries against current source documents and made the following corrections:
#h-417659); description corrected from 9 to 10 principles (the previous summary omitted Principle 4.5, "Limiting Use, Disclosure, and Retention").NI 31-103 sections and CIRO IDPC rule numbers could not be independently verified (BCSC returned 404, OSC and CIRO blanket-403 to automated fetches). The cited section/rule list from #290 was used; it is consistent with the well-known IIROC-inherited IDPC structure.
Layout wiring
Adds the new dataset to the existing reference-card include block in both
_layouts/risk.htmland_layouts/mitigation.html. The include is a no-op for files that don't declarecanada-regulations_references:in their front matter (the existingreference-card.htmlpartial guards onreferences.size > 0), so this change has no visible effect until follow-up PRs add references on individual risks/mitigations.Notes on durability
Two entries point to material currently in flux that will need maintenance:
Test plan
jekyll buildruns cleanly fromdocs/(0.42s, no errors)titleandurl; longest title 94 chars